From 307ab54a22c191d93a7cb490532002edc7a79226 Mon Sep 17 00:00:00 2001 From: Misty Stanley-Jones Date: Wed, 28 Sep 2016 14:17:14 -0700 Subject: [PATCH] Initial import of https://github.com/docker/cs-docker --- .dockerignore | 2 + .gitignore | 39 + .mailmap | 171 + AUTHORS | 1033 + CHANGELOG.md | 1996 + CONTRIBUTING.md | 438 + Dockerfile | 223 + Dockerfile.centos | 36 + Dockerfile.gccgo | 72 + Dockerfile.simple | 35 + LICENSE | 191 + LICENSE-EVAL.txt | 64 + MAINTAINERS | 599 + Makefile | 84 + NOTICE | 19 + README.md | 300 + ROADMAP.md | 183 + VERSION | 1 + api/README.md | 5 + api/client/attach.go | 84 + api/client/build.go | 674 + api/client/cli.go | 169 + api/client/client.go | 5 + api/client/commit.go | 84 + api/client/cp.go | 325 + api/client/create.go | 185 + api/client/diff.go | 56 + api/client/events.go | 63 + api/client/exec.go | 134 + api/client/export.go | 46 + api/client/hijack.go | 254 + api/client/history.go | 78 + api/client/images.go | 130 + api/client/import.go | 79 + api/client/info.go | 114 + api/client/inspect.go | 203 + api/client/kill.go | 33 + api/client/load.go | 42 + api/client/login.go | 153 + api/client/logout.go | 39 + api/client/logs.go | 74 + api/client/network.go | 381 + api/client/pause.go | 32 + api/client/port.go | 72 + api/client/ps.go | 116 + api/client/ps/custom.go | 160 + api/client/ps/custom_test.go | 126 + api/client/ps/formatter.go | 140 + api/client/ps/formatter_test.go | 208 + api/client/pull.go | 53 + api/client/push.go | 53 + api/client/rename.go | 32 + api/client/restart.go | 39 + api/client/rm.go | 55 + api/client/rmi.go | 61 + api/client/run.go | 257 + api/client/save.go | 52 + api/client/search.go | 88 + api/client/start.go | 171 + api/client/stats.go | 240 + api/client/stats_unit_test.go | 46 + api/client/stop.go | 41 + api/client/tag.go | 42 + api/client/top.go | 49 + api/client/trust.go | 479 + api/client/trust_test.go | 55 + api/client/unpause.go | 32 + api/client/utils.go | 384 + api/client/version.go | 96 + api/client/volume.go | 234 + api/client/wait.go | 35 + api/common.go | 127 + api/common_test.go | 282 + api/fixtures/keyfile | 7 + api/server/httputils/form.go | 76 + api/server/httputils/form_test.go | 105 + api/server/httputils/httputils.go | 180 + api/server/middleware.go | 118 + api/server/middleware_test.go | 57 + api/server/profiler.go | 38 + api/server/router/local/auth.go | 27 + api/server/router/local/container.go | 515 + api/server/router/local/copy.go | 116 + api/server/router/local/exec.go | 135 + api/server/router/local/image.go | 524 + api/server/router/local/info.go | 142 + api/server/router/local/inspect.go | 37 + api/server/router/local/local.go | 162 + api/server/router/local/volume.go | 66 + api/server/router/network/network.go | 57 + api/server/router/network/network_routes.go | 266 + api/server/router/router.go | 18 + api/server/server.go | 211 + api/server/server_test.go | 34 + api/server/server_unix.go | 123 + api/server/server_windows.go | 43 + api/types/stats.go | 105 + api/types/types.go | 393 + api/types/versions/README.md | 14 + api/types/versions/v1p19/types.go | 35 + api/types/versions/v1p20/types.go | 40 + builder/builder.go | 150 + builder/dockerfile/bflag.go | 176 + builder/dockerfile/bflag_test.go | 187 + builder/dockerfile/builder.go | 292 + builder/dockerfile/command/command.go | 42 + builder/dockerfile/dispatchers.go | 647 + builder/dockerfile/evaluator.go | 193 + builder/dockerfile/internals.go | 663 + builder/dockerfile/internals_unix.go | 40 + builder/dockerfile/internals_windows.go | 8 + builder/dockerfile/parser/dumper/main.go | 32 + builder/dockerfile/parser/json_test.go | 55 + builder/dockerfile/parser/line_parsers.go | 331 + builder/dockerfile/parser/parser.go | 145 + builder/dockerfile/parser/parser_test.go | 112 + .../env_no_value/Dockerfile | 3 + .../shykes-nested-json/Dockerfile | 1 + .../testfiles/ADD-COPY-with-JSON/Dockerfile | 11 + .../testfiles/ADD-COPY-with-JSON/result | 10 + .../testfiles/brimstone-consuldock/Dockerfile | 25 + .../testfiles/brimstone-consuldock/result | 5 + .../brimstone-docker-consul/Dockerfile | 52 + .../testfiles/brimstone-docker-consul/result | 9 + .../testfiles/continueIndent/Dockerfile | 36 + .../parser/testfiles/continueIndent/result | 10 + .../testfiles/cpuguy83-nagios/Dockerfile | 54 + .../parser/testfiles/cpuguy83-nagios/result | 40 + .../parser/testfiles/docker/Dockerfile | 104 + .../dockerfile/parser/testfiles/docker/result | 24 + .../parser/testfiles/env/Dockerfile | 23 + .../dockerfile/parser/testfiles/env/result | 16 + .../parser/testfiles/escapes/Dockerfile | 14 + .../parser/testfiles/escapes/result | 6 + .../parser/testfiles/flags/Dockerfile | 10 + .../dockerfile/parser/testfiles/flags/result | 10 + .../parser/testfiles/influxdb/Dockerfile | 15 + .../parser/testfiles/influxdb/result | 11 + .../Dockerfile | 1 + .../result | 1 + .../Dockerfile | 1 + .../result | 1 + .../Dockerfile | 1 + .../jeztah-invalid-json-single-quotes/result | 1 + .../Dockerfile | 1 + .../result | 1 + .../Dockerfile | 1 + .../result | 1 + .../parser/testfiles/json/Dockerfile | 8 + .../dockerfile/parser/testfiles/json/result | 8 + .../kartar-entrypoint-oddities/Dockerfile | 7 + .../kartar-entrypoint-oddities/result | 7 + .../lk4d4-the-edge-case-generator/Dockerfile | 48 + .../lk4d4-the-edge-case-generator/result | 29 + .../parser/testfiles/mail/Dockerfile | 16 + .../dockerfile/parser/testfiles/mail/result | 14 + .../testfiles/multiple-volumes/Dockerfile | 3 + .../parser/testfiles/multiple-volumes/result | 2 + .../parser/testfiles/mumble/Dockerfile | 7 + .../dockerfile/parser/testfiles/mumble/result | 4 + .../parser/testfiles/nginx/Dockerfile | 14 + .../dockerfile/parser/testfiles/nginx/result | 11 + .../parser/testfiles/tf2/Dockerfile | 23 + .../dockerfile/parser/testfiles/tf2/result | 20 + .../parser/testfiles/weechat/Dockerfile | 9 + .../parser/testfiles/weechat/result | 6 + .../parser/testfiles/znc/Dockerfile | 7 + .../dockerfile/parser/testfiles/znc/result | 5 + builder/dockerfile/parser/utils.go | 176 + builder/dockerfile/shell_parser.go | 243 + builder/dockerfile/shell_parser_test.go | 93 + builder/dockerfile/support.go | 16 + builder/dockerfile/words | 58 + builder/dockerignore.go | 47 + builder/git.go | 28 + builder/remote.go | 115 + builder/remote_test.go | 149 + builder/shell_parser.go | 209 + builder/shell_parser_test.go | 51 + builder/tarsum.go | 158 + builder/words | 43 + cli/cli.go | 200 + cli/client.go | 12 + cli/common.go | 79 + cliconfig/config.go | 274 + cliconfig/config_test.go | 458 + contrib/README | 4 + contrib/REVIEWERS | 1 + contrib/apparmor/docker-engine | 241 + contrib/builder/deb/README.md | 5 + contrib/builder/deb/build.sh | 10 + contrib/builder/deb/debian-jessie/Dockerfile | 14 + contrib/builder/deb/debian-stretch/Dockerfile | 14 + contrib/builder/deb/debian-wheezy/Dockerfile | 14 + contrib/builder/deb/generate.sh | 100 + contrib/builder/deb/ubuntu-precise/Dockerfile | 14 + contrib/builder/deb/ubuntu-trusty/Dockerfile | 14 + contrib/builder/deb/ubuntu-vivid/Dockerfile | 14 + contrib/builder/deb/ubuntu-wily/Dockerfile | 14 + contrib/builder/rpm/README.md | 5 + contrib/builder/rpm/build.sh | 10 + contrib/builder/rpm/centos-7/Dockerfile | 16 + contrib/builder/rpm/fedora-21/Dockerfile | 15 + contrib/builder/rpm/fedora-22/Dockerfile | 15 + contrib/builder/rpm/fedora-23/Dockerfile | 15 + contrib/builder/rpm/generate.sh | 100 + contrib/builder/rpm/opensuse-13.2/Dockerfile | 15 + contrib/builder/rpm/oraclelinux-6/Dockerfile | 15 + contrib/builder/rpm/oraclelinux-7/Dockerfile | 15 + contrib/check-config.sh | 245 + contrib/completion/REVIEWERS | 2 + contrib/completion/bash/docker | 1881 + contrib/completion/fish/docker.fish | 404 + contrib/completion/zsh/REVIEWERS | 2 + contrib/completion/zsh/_docker | 942 + contrib/desktop-integration/README.md | 11 + .../desktop-integration/chromium/Dockerfile | 36 + .../desktop-integration/gparted/Dockerfile | 31 + contrib/docker-device-tool/device_tool.go | 174 + contrib/docker-engine-selinux/LICENSE | 502 + contrib/docker-engine-selinux/Makefile | 16 + contrib/docker-engine-selinux/docker.fc | 24 + contrib/docker-engine-selinux/docker.if | 467 + contrib/docker-engine-selinux/docker.te | 418 + .../docker-engine-selinux/docker_selinux.8.gz | Bin 0 -> 2847 bytes contrib/dockerize-disk.sh | 118 + contrib/download-frozen-image.sh | 108 + contrib/host-integration/Dockerfile.dev | 25 + contrib/host-integration/Dockerfile.min | 4 + contrib/host-integration/manager.go | 130 + contrib/host-integration/manager.sh | 53 + contrib/host-integration/manager/systemd | 20 + contrib/host-integration/manager/upstart | 15 + contrib/httpserver/Dockerfile | 4 + contrib/httpserver/server.go | 12 + contrib/init/openrc/docker.confd | 13 + contrib/init/openrc/docker.initd | 19 + contrib/init/systemd/REVIEWERS | 3 + contrib/init/systemd/docker.service | 16 + contrib/init/systemd/docker.socket | 12 + contrib/init/sysvinit-debian/docker | 149 + contrib/init/sysvinit-debian/docker.default | 13 + contrib/init/sysvinit-redhat/docker | 153 + contrib/init/sysvinit-redhat/docker.sysconfig | 7 + contrib/init/upstart/REVIEWERS | 2 + contrib/init/upstart/docker.conf | 60 + contrib/mkimage-alpine.sh | 82 + contrib/mkimage-arch-pacman.conf | 92 + contrib/mkimage-arch.sh | 93 + contrib/mkimage-busybox.sh | 43 + contrib/mkimage-crux.sh | 75 + contrib/mkimage-debootstrap.sh | 297 + contrib/mkimage-rinse.sh | 123 + contrib/mkimage-yum.sh | 108 + contrib/mkimage.sh | 117 + contrib/mkimage/.febootstrap-minimize | 28 + contrib/mkimage/busybox-static | 34 + contrib/mkimage/debootstrap | 240 + contrib/mkimage/mageia-urpmi | 61 + contrib/mkimage/rinse | 25 + contrib/mkseccomp.pl | 77 + contrib/mkseccomp.sample | 444 + contrib/nuke-graph-directory.sh | 65 + contrib/project-stats.sh | 22 + contrib/report-issue.sh | 105 + contrib/reprepro/suites.sh | 12 + contrib/syntax/kate/Dockerfile.xml | 70 + contrib/syntax/nano/Dockerfile.nanorc | 26 + contrib/syntax/nano/README.md | 32 + .../Preferences/Dockerfile.tmPreferences | 24 + .../Syntaxes/Dockerfile.tmLanguage | 143 + .../textmate/Docker.tmbundle/info.plist | 16 + contrib/syntax/textmate/README.md | 17 + contrib/syntax/textmate/REVIEWERS | 1 + contrib/syntax/vim/LICENSE | 22 + contrib/syntax/vim/README.md | 26 + contrib/syntax/vim/doc/dockerfile.txt | 18 + contrib/syntax/vim/ftdetect/dockerfile.vim | 1 + contrib/syntax/vim/syntax/dockerfile.vim | 31 + contrib/udev/80-docker.rules | 3 + contrib/vagrant-docker/README.md | 50 + daemon/README.md | 9 + daemon/archive.go | 324 + daemon/archive_unix.go | 19 + daemon/archive_windows.go | 10 + daemon/attach.go | 64 + daemon/changes.go | 13 + daemon/commit.go | 51 + daemon/config.go | 77 + daemon/config_experimental.go | 119 + daemon/config_stub.go | 8 + daemon/config_unix.go | 83 + daemon/config_windows.go | 41 + daemon/container.go | 1162 + daemon/container_unit_test.go | 136 + daemon/container_unix.go | 1549 + daemon/container_windows.go | 203 + daemon/create.go | 158 + daemon/create_unix.go | 67 + daemon/create_windows.go | 11 + daemon/daemon.go | 1289 + daemon/daemon_aufs.go | 21 + daemon/daemon_btrfs.go | 8 + daemon/daemon_devicemapper.go | 8 + daemon/daemon_experimental.go | 110 + daemon/daemon_linux.go | 60 + daemon/daemon_linux_test.go | 74 + daemon/daemon_no_aufs.go | 11 + daemon/daemon_overlay.go | 8 + daemon/daemon_stub.go | 28 + daemon/daemon_test.go | 576 + daemon/daemon_unix.go | 643 + daemon/daemon_unix_test.go | 87 + daemon/daemon_unsupported.go | 5 + daemon/daemon_windows.go | 156 + daemon/daemon_zfs.go | 8 + daemon/daemonbuilder/builder.go | 239 + daemon/daemonbuilder/builder_unix.go | 40 + daemon/daemonbuilder/builder_windows.go | 8 + daemon/debugtrap_unix.go | 21 + daemon/debugtrap_unsupported.go | 7 + daemon/debugtrap_windows.go | 30 + daemon/delete.go | 170 + daemon/delete_test.go | 39 + daemon/discovery.go | 48 + daemon/events/events.go | 65 + daemon/events/events_test.go | 135 + daemon/events/filter.go | 64 + daemon/exec.go | 331 + daemon/exec_freebsd.go | 9 + daemon/exec_linux.go | 18 + daemon/exec_windows.go | 9 + daemon/execdriver/driver.go | 233 + daemon/execdriver/driver_unix.go | 177 + daemon/execdriver/driver_windows.go | 20 + .../execdrivers/execdrivers_freebsd.go | 19 + .../execdrivers/execdrivers_linux.go | 29 + .../execdrivers/execdrivers_windows.go | 20 + daemon/execdriver/lxc/driver.go | 906 + daemon/execdriver/lxc/info.go | 53 + daemon/execdriver/lxc/info_test.go | 38 + daemon/execdriver/lxc/init.go | 145 + daemon/execdriver/lxc/lxc_init_linux.go | 22 + daemon/execdriver/lxc/lxc_init_unsupported.go | 7 + daemon/execdriver/lxc/lxc_template.go | 247 + .../execdriver/lxc/lxc_template_unit_test.go | 343 + daemon/execdriver/native/apparmor.go | 142 + daemon/execdriver/native/create.go | 310 + daemon/execdriver/native/driver.go | 543 + .../execdriver/native/driver_unsupported.go | 14 + .../native/driver_unsupported_nocgo.go | 14 + daemon/execdriver/native/exec.go | 87 + daemon/execdriver/native/info.go | 16 + daemon/execdriver/native/init.go | 45 + .../native/template/default_template.go | 98 + daemon/execdriver/pipes.go | 24 + daemon/execdriver/termconsole.go | 55 + daemon/execdriver/utils.go | 123 + daemon/execdriver/windows/checkoptions.go | 36 + daemon/execdriver/windows/clean.go | 8 + daemon/execdriver/windows/exec.go | 88 + daemon/execdriver/windows/getpids.go | 11 + daemon/execdriver/windows/info.go | 24 + daemon/execdriver/windows/namedpipes.go | 54 + daemon/execdriver/windows/pauseunpause.go | 19 + daemon/execdriver/windows/run.go | 321 + daemon/execdriver/windows/stats.go | 14 + daemon/execdriver/windows/stdconsole.go | 24 + daemon/execdriver/windows/terminatekill.go | 47 + daemon/execdriver/windows/ttyconsole.go | 32 + daemon/execdriver/windows/unsupported.go | 14 + daemon/execdriver/windows/windows.go | 95 + daemon/export.go | 28 + daemon/graphdriver/aufs/aufs.go | 560 + daemon/graphdriver/aufs/aufs_test.go | 734 + daemon/graphdriver/aufs/dirs.go | 48 + daemon/graphdriver/aufs/migrate.go | 203 + daemon/graphdriver/aufs/mount.go | 21 + daemon/graphdriver/aufs/mount_linux.go | 7 + daemon/graphdriver/aufs/mount_unsupported.go | 12 + daemon/graphdriver/btrfs/btrfs.go | 300 + daemon/graphdriver/btrfs/btrfs_test.go | 31 + daemon/graphdriver/btrfs/dummy_unsupported.go | 3 + daemon/graphdriver/btrfs/version.go | 26 + daemon/graphdriver/btrfs/version_none.go | 14 + daemon/graphdriver/btrfs/version_test.go | 13 + daemon/graphdriver/devmapper/README.md | 97 + daemon/graphdriver/devmapper/deviceset.go | 2434 + daemon/graphdriver/devmapper/devmapper_doc.go | 106 + .../graphdriver/devmapper/devmapper_test.go | 110 + daemon/graphdriver/devmapper/driver.go | 218 + daemon/graphdriver/devmapper/mount.go | 89 + daemon/graphdriver/driver.go | 222 + daemon/graphdriver/driver_freebsd.go | 8 + daemon/graphdriver/driver_linux.go | 85 + daemon/graphdriver/driver_unsupported.go | 15 + daemon/graphdriver/driver_windows.go | 16 + daemon/graphdriver/fsdiff.go | 158 + daemon/graphdriver/graphtest/graphtest.go | 297 + daemon/graphdriver/imagerestorer.go | 31 + daemon/graphdriver/overlay/copy.go | 169 + daemon/graphdriver/overlay/overlay.go | 486 + daemon/graphdriver/overlay/overlay_test.go | 30 + .../overlay/overlay_unsupported.go | 3 + daemon/graphdriver/plugin.go | 33 + daemon/graphdriver/plugin_unsupported.go | 7 + daemon/graphdriver/proxy.go | 210 + daemon/graphdriver/vfs/driver.go | 132 + daemon/graphdriver/vfs/driver_unsupported.go | 3 + daemon/graphdriver/vfs/vfs_test.go | 37 + daemon/graphdriver/windows/windows.go | 598 + daemon/graphdriver/zfs/MAINTAINERS | 2 + daemon/graphdriver/zfs/zfs.go | 333 + daemon/graphdriver/zfs/zfs_freebsd.go | 38 + daemon/graphdriver/zfs/zfs_linux.go | 27 + daemon/graphdriver/zfs/zfs_test.go | 30 + daemon/graphdriver/zfs/zfs_unsupported.go | 11 + daemon/history.go | 32 + daemon/image_delete.go | 346 + daemon/info.go | 124 + daemon/inspect.go | 206 + daemon/inspect_unix.go | 71 + daemon/inspect_windows.go | 17 + daemon/kill.go | 27 + daemon/links/links.go | 141 + daemon/links/links_test.go | 213 + daemon/list.go | 421 + daemon/logdrivers_linux.go | 12 + daemon/logdrivers_windows.go | 8 + daemon/logger/awslogs/cloudwatchlogs.go | 326 + daemon/logger/awslogs/cloudwatchlogs_test.go | 572 + .../logger/awslogs/cwlogsiface_mock_test.go | 56 + daemon/logger/context.go | 112 + daemon/logger/copier.go | 71 + daemon/logger/copier_test.go | 96 + daemon/logger/factory.go | 89 + daemon/logger/fluentd/fluentd.go | 134 + daemon/logger/gelf/gelf.go | 175 + daemon/logger/gelf/gelf_unsupported.go | 3 + daemon/logger/journald/journald.go | 86 + .../logger/journald/journald_unsupported.go | 3 + daemon/logger/journald/read.go | 299 + daemon/logger/journald/read_unsupported.go | 7 + daemon/logger/jsonfilelog/jsonfilelog.go | 409 + daemon/logger/jsonfilelog/jsonfilelog_test.go | 201 + daemon/logger/logger.go | 87 + daemon/logger/loggerutils/log_tag.go | 46 + daemon/logger/loggerutils/log_tag_test.go | 58 + daemon/logger/syslog/syslog.go | 179 + daemon/logger/syslog/syslog_unsupported.go | 3 + daemon/logs.go | 99 + daemon/monitor.go | 347 + daemon/network.go | 127 + daemon/network/settings.go | 51 + daemon/pause.go | 19 + daemon/rename.go | 83 + daemon/resize.go | 24 + daemon/restart.go | 22 + daemon/start.go | 52 + daemon/state.go | 287 + daemon/state_test.go | 111 + daemon/stats.go | 129 + daemon/stats_collector_unix.go | 213 + daemon/stats_collector_windows.go | 31 + daemon/stats_freebsd.go | 14 + daemon/stats_linux.go | 80 + daemon/stats_windows.go | 14 + daemon/stop.go | 25 + daemon/top_unix.go | 81 + daemon/top_windows.go | 11 + daemon/unpause.go | 19 + daemon/utils_freebsd.go | 9 + daemon/utils_linux.go | 48 + daemon/utils_nounix.go | 13 + daemon/utils_test.go | 28 + daemon/volumes.go | 109 + daemon/volumes_linux_unit_test.go | 58 + daemon/volumes_unit_test.go | 35 + daemon/volumes_unix.go | 425 + daemon/volumes_windows.go | 36 + daemon/wait.go | 17 + docker/README.md | 3 + docker/client.go | 28 + docker/common.go | 101 + docker/daemon.go | 336 + docker/daemon_freebsd.go | 7 + docker/daemon_linux.go | 14 + docker/daemon_none.go | 16 + docker/daemon_unix.go | 50 + docker/daemon_windows.go | 33 + docker/docker.go | 84 + docker/docker_windows.go | 5 + docker/flags.go | 30 + docker/flags_test.go | 13 + dockerinit/dockerinit.go | 12 + docs-cs/Dockerfile | 8 + docs-cs/Makefile | 38 + docs-cs/index.md | 19 + docs-cs/install.md | 201 + docs-cs/release-notes/index.md | 17 + docs-cs/release-notes/prior-release-notes.md | 337 + docs-cs/release-notes/release-notes.md | 100 + docs-cs/upgrade.md | 272 + docs/.gitignore | 2 + docs/Dockerfile | 16 + docs/Makefile | 55 + docs/README.md | 295 + docs/article-img/architecture.svg | 2597 + docs/articles/ambassador_pattern_linking.md | 160 + docs/articles/b2d_volume_images/add_cd.png | Bin 0 -> 27607 bytes .../b2d_volume_images/add_new_controller.png | Bin 0 -> 36100 bytes .../articles/b2d_volume_images/add_volume.png | Bin 0 -> 30506 bytes .../articles/b2d_volume_images/boot_order.png | Bin 0 -> 28432 bytes docs/articles/b2d_volume_images/gparted.png | Bin 0 -> 77989 bytes docs/articles/b2d_volume_images/gparted2.png | Bin 0 -> 71561 bytes docs/articles/b2d_volume_images/verify.png | Bin 0 -> 9581 bytes docs/articles/b2d_volume_resize.md | 165 + docs/articles/baseimages.md | 70 + docs/articles/certificates.md | 17 + docs/articles/cfengine_process_management.md | 149 + docs/articles/chef.md | 80 + docs/articles/configuring.md | 243 + docs/articles/dockerfile_best-practices.md | 495 + docs/articles/dsc.md | 173 + docs/articles/host_integration.md | 87 + docs/articles/https.md | 211 + docs/articles/https/Dockerfile | 10 + docs/articles/https/Makefile | 24 + docs/articles/https/README.md | 26 + docs/articles/https/make_certs.sh | 23 + docs/articles/https/parsedocs.sh | 10 + docs/articles/puppet.md | 99 + docs/articles/registry_mirror.md | 18 + docs/articles/runmetrics.md | 463 + docs/articles/security.md | 284 + docs/articles/systemd.md | 158 + docs/articles/using_supervisord.md | 118 + docs/examples/apt-cacher-ng.Dockerfile | 15 + docs/examples/apt-cacher-ng.md | 113 + docs/examples/couchdb_data_volumes.md | 49 + docs/examples/index.md | 23 + docs/examples/mongodb.md | 177 + docs/examples/mongodb/Dockerfile | 22 + docs/examples/nodejs_web_app.md | 196 + docs/examples/postgresql_service.Dockerfile | 49 + docs/examples/postgresql_service.md | 153 + docs/examples/running_redis_service.md | 89 + docs/examples/running_riak_service.Dockerfile | 31 + docs/examples/running_riak_service.md | 108 + docs/examples/running_ssh_service.Dockerfile | 20 + docs/examples/running_ssh_service.md | 84 + docs/examples/supervisord.conf | 12 + docs/extend/index.md | 21 + docs/extend/plugin_api.md | 135 + docs/extend/plugins.md | 88 + docs/extend/plugins_network.md | 57 + docs/extend/plugins_volume.md | 160 + docs/installation/SUSE.md | 116 + docs/installation/amazon.md | 21 + docs/installation/archlinux.md | 105 + docs/installation/azure.md | 33 + docs/installation/binaries.md | 214 + docs/installation/centos.md | 187 + docs/installation/cruxlinux.md | 92 + docs/installation/debian.md | 168 + docs/installation/fedora.md | 211 + docs/installation/frugalware.md | 74 + docs/installation/gentoolinux.md | 121 + docs/installation/google.md | 47 + docs/installation/images/bad_host.png | Bin 0 -> 27367 bytes docs/installation/images/cool_view.png | Bin 0 -> 24385 bytes docs/installation/images/good_host.png | Bin 0 -> 30853 bytes docs/installation/images/kitematic.png | Bin 0 -> 14191 bytes .../installation/images/linux_docker_host.svg | 1195 + .../installation/images/mac-page-finished.png | Bin 0 -> 158534 bytes docs/installation/images/mac-page-two.png | Bin 0 -> 140504 bytes .../images/mac-password-prompt.png | Bin 0 -> 30903 bytes docs/installation/images/mac-success.png | Bin 0 -> 28755 bytes docs/installation/images/mac-welcome-page.png | Bin 0 -> 155430 bytes docs/installation/images/mac_docker_host.svg | 1243 + docs/installation/images/my-docker-vm.png | Bin 0 -> 136985 bytes docs/installation/images/newsite_view.png | Bin 0 -> 21403 bytes docs/installation/images/virtualization.png | Bin 0 -> 59249 bytes docs/installation/images/win-page-6.png | Bin 0 -> 88115 bytes docs/installation/images/win-welcome.png | Bin 0 -> 94143 bytes docs/installation/images/win_docker_host.svg | 1259 + docs/installation/images/win_ver.png | Bin 0 -> 50312 bytes .../images/windows-boot2docker-cmd.png | Bin 0 -> 37436 bytes .../images/windows-boot2docker-powershell.png | Bin 0 -> 37945 bytes .../images/windows-boot2docker-start.png | Bin 0 -> 75786 bytes docs/installation/images/windows-finish.png | Bin 0 -> 119402 bytes docs/installation/index.md | 48 + docs/installation/joyent.md | 23 + docs/installation/mac.md | 430 + docs/installation/oracle.md | 202 + docs/installation/rackspace.md | 87 + docs/installation/rhel.md | 179 + docs/installation/softlayer.md | 36 + docs/installation/ubuntulinux.md | 421 + docs/installation/windows.md | 367 + docs/introduction/understanding-docker.md | 293 + docs/misc/deprecated.md | 118 + docs/misc/faq.md | 272 + docs/misc/index.md | 120 + docs/misc/release-notes.md | 161 + docs/misc/search.md | 16 + docs/reference/api/README.md | 9 + .../_static/io_oauth_authorization_page.png | Bin 0 -> 39458 bytes docs/reference/api/docker-io_api.md | 15 + docs/reference/api/docker_io_accounts_api.md | 276 + docs/reference/api/docker_remote_api.md | 215 + docs/reference/api/docker_remote_api_v1.0.md | 993 + docs/reference/api/docker_remote_api_v1.1.md | 1005 + docs/reference/api/docker_remote_api_v1.10.md | 1354 + docs/reference/api/docker_remote_api_v1.11.md | 1385 + docs/reference/api/docker_remote_api_v1.12.md | 1450 + docs/reference/api/docker_remote_api_v1.13.md | 1440 + docs/reference/api/docker_remote_api_v1.14.md | 1448 + docs/reference/api/docker_remote_api_v1.15.md | 1742 + docs/reference/api/docker_remote_api_v1.16.md | 1812 + docs/reference/api/docker_remote_api_v1.17.md | 1986 + docs/reference/api/docker_remote_api_v1.18.md | 2105 + docs/reference/api/docker_remote_api_v1.19.md | 2169 + docs/reference/api/docker_remote_api_v1.2.md | 1024 + docs/reference/api/docker_remote_api_v1.20.md | 2311 + docs/reference/api/docker_remote_api_v1.21.md | 2871 + docs/reference/api/docker_remote_api_v1.3.md | 1110 + docs/reference/api/docker_remote_api_v1.4.md | 1153 + docs/reference/api/docker_remote_api_v1.5.md | 1159 + docs/reference/api/docker_remote_api_v1.6.md | 1261 + docs/reference/api/docker_remote_api_v1.7.md | 1249 + docs/reference/api/docker_remote_api_v1.8.md | 1325 + docs/reference/api/docker_remote_api_v1.9.md | 1358 + docs/reference/api/hub_registry_spec.md | 17 + docs/reference/api/images/event_state.gliffy | 1 + docs/reference/api/images/event_state.png | Bin 0 -> 78354 bytes docs/reference/api/registry_api.md | 598 + .../api/registry_api_client_libraries.md | 49 + .../api/remote_api_client_libraries.md | 212 + docs/reference/builder.md | 1245 + docs/reference/commandline/attach.md | 90 + docs/reference/commandline/build.md | 294 + docs/reference/commandline/cli.md | 170 + docs/reference/commandline/commit.md | 82 + docs/reference/commandline/cp.md | 90 + docs/reference/commandline/create.md | 121 + docs/reference/commandline/daemon.md | 604 + docs/reference/commandline/diff.md | 40 + docs/reference/commandline/docker_images.gif | Bin 0 -> 35785 bytes docs/reference/commandline/events.md | 136 + docs/reference/commandline/exec.md | 55 + docs/reference/commandline/export.md | 35 + docs/reference/commandline/history.md | 40 + docs/reference/commandline/images.md | 179 + docs/reference/commandline/import.md | 69 + docs/reference/commandline/index.md | 85 + docs/reference/commandline/info.md | 58 + docs/reference/commandline/inspect.md | 75 + docs/reference/commandline/kill.md | 26 + docs/reference/commandline/load.md | 36 + docs/reference/commandline/login.md | 27 + docs/reference/commandline/logout.md | 22 + docs/reference/commandline/logs.md | 43 + docs/reference/commandline/network_connect.md | 55 + docs/reference/commandline/network_create.md | 130 + .../commandline/network_disconnect.md | 33 + docs/reference/commandline/network_inspect.md | 64 + docs/reference/commandline/network_ls.md | 51 + docs/reference/commandline/network_rm.md | 32 + docs/reference/commandline/pause.md | 27 + docs/reference/commandline/port.md | 34 + docs/reference/commandline/ps.md | 199 + docs/reference/commandline/pull.md | 51 + docs/reference/commandline/push.md | 21 + docs/reference/commandline/rename.md | 19 + docs/reference/commandline/restart.md | 18 + docs/reference/commandline/rm.md | 47 + docs/reference/commandline/rmi.md | 74 + docs/reference/commandline/run.md | 542 + docs/reference/commandline/save.md | 37 + docs/reference/commandline/search.md | 28 + docs/reference/commandline/start.md | 19 + docs/reference/commandline/stats.md | 33 + docs/reference/commandline/stop.md | 22 + docs/reference/commandline/tag.md | 21 + docs/reference/commandline/top.md | 17 + docs/reference/commandline/unpause.md | 24 + docs/reference/commandline/version.md | 55 + docs/reference/commandline/volume_create.md | 50 + docs/reference/commandline/volume_inspect.md | 40 + docs/reference/commandline/volume_ls.md | 34 + docs/reference/commandline/volume_rm.md | 22 + docs/reference/commandline/wait.md | 17 + docs/reference/glossary.md | 221 + docs/reference/logging/awslogs.md | 90 + docs/reference/logging/fluentd.md | 111 + docs/reference/logging/index.md | 20 + docs/reference/logging/journald.md | 85 + docs/reference/logging/log_tags.md | 50 + docs/reference/logging/overview.md | 174 + docs/reference/run.md | 1317 + docs/security/apparmor.md | 41 + docs/security/trust/content_trust.md | 302 + docs/security/trust/images/tag_signing.png | Bin 0 -> 74416 bytes docs/security/trust/images/trust_.gliffy | 1 + .../trust/images/trust_components.gliffy | 1 + .../trust/images/trust_components.png | Bin 0 -> 124071 bytes .../trust/images/trust_signing.gliffy | 1 + docs/security/trust/images/trust_signing.png | Bin 0 -> 71621 bytes docs/security/trust/images/trust_view.gliffy | 1 + docs/security/trust/images/trust_view.png | Bin 0 -> 59533 bytes docs/security/trust/index.md | 21 + docs/security/trust/trust_automation.md | 79 + docs/security/trust/trust_key_mng.md | 73 + docs/security/trust/trust_sandbox.md | 331 + .../images/windows-boot2docker-cmd.png | Bin 0 -> 37436 bytes .../images/windows-boot2docker-powershell.png | Bin 0 -> 37945 bytes docs/static_files/README.md | 11 + docs/static_files/contributors.png | Bin 0 -> 23100 bytes docs/static_files/docker-logo-compressed.png | Bin 0 -> 4972 bytes docs/static_files/docker_pull_chart.png | Bin 0 -> 7188 bytes docs/static_files/docker_push_chart.png | Bin 0 -> 8700 bytes docs/static_files/dockerlogo-v.png | Bin 0 -> 9670 bytes docs/touch-up.sh | 20 + docs/userguide/basics.md | 199 + docs/userguide/dockerimages.md | 553 + docs/userguide/dockerizing.md | 211 + docs/userguide/dockerrepos.md | 186 + docs/userguide/dockervolumes.md | 286 + docs/userguide/image_management.md | 53 + docs/userguide/index.md | 127 + docs/userguide/labels-custom-metadata.md | 220 + .../networking/default_network/binding.md | 103 + .../default_network/build-bridges.md | 77 + .../default_network/configure-dns.md | 132 + .../default_network/container-basics.md | 110 + .../container-communication.md | 123 + .../default_network/custom-docker0.md | 61 + .../networking/default_network/dockerlinks.md | 355 + .../images/ipv6_basic_host_config.gliffy | 1 + .../images/ipv6_basic_host_config.svg | 1 + .../images/ipv6_ndp_proxying.gliffy | 1 + .../images/ipv6_ndp_proxying.svg | 1 + .../images/ipv6_routed_network_example.gliffy | 1 + .../images/ipv6_routed_network_example.svg | 1 + .../images/ipv6_slash64_subnet_config.gliffy | 1 + .../images/ipv6_slash64_subnet_config.svg | 1 + .../ipv6_switched_network_example.gliffy | 1 + .../images/ipv6_switched_network_example.svg | 1 + .../networking/default_network/index.md | 25 + .../networking/default_network/ipv6.md | 259 + .../networking/default_network/options.md | 141 + .../networking/default_network/saveme.md | 28 + .../networking/default_network/tools.md | 83 + docs/userguide/networking/dockernetworks.md | 490 + .../networking/get-started-overlay.md | 353 + .../networking/images/bridge_network.gliffy | 1 + .../networking/images/bridge_network.png | Bin 0 -> 15878 bytes .../networking/images/bridge_network.svg | 1 + .../networking/images/engine_on_net.gliffy | 1 + .../networking/images/engine_on_net.png | Bin 0 -> 14032 bytes .../networking/images/engine_on_net.svg | 1 + .../networking/images/key_value.gliffy | 1 + .../userguide/networking/images/key_value.png | Bin 0 -> 12898 bytes .../userguide/networking/images/key_value.svg | 1 + .../networking/images/network_access.gliffy | 1 + .../networking/images/network_access.png | Bin 0 -> 30649 bytes .../networking/images/network_access.svg | 1 + .../images/overlay-network-final.gliffy | 1 + .../images/overlay-network-final.png | Bin 0 -> 28072 bytes .../images/overlay-network-final.svg | 1 + .../networking/images/overlay_network.gliffy | 1 + .../networking/images/overlay_network.png | Bin 0 -> 23276 bytes .../networking/images/overlay_network.svg | 1 + .../networking/images/working.gliffy | 1 + docs/userguide/networking/images/working.png | Bin 0 -> 18319 bytes docs/userguide/networking/images/working.svg | 1 + docs/userguide/networking/index.md | 21 + .../networking/work-with-networks.md | 463 + docs/userguide/networkingcontainers.md | 240 + docs/userguide/search.png | Bin 0 -> 17923 bytes docs/userguide/storagedriver/aufs-driver.md | 197 + docs/userguide/storagedriver/btrfs-driver.md | 280 + .../storagedriver/device-mapper-driver.md | 310 + .../storagedriver/images/aufs_delete.jpg | Bin 0 -> 39059 bytes .../storagedriver/images/aufs_layers.jpg | Bin 0 -> 79447 bytes .../storagedriver/images/aufs_metadata.jpg | Bin 0 -> 26599 bytes .../storagedriver/images/base_device.jpg | Bin 0 -> 46684 bytes .../storagedriver/images/btfs_constructs.jpg | Bin 0 -> 47668 bytes .../images/btfs_container_layer.jpg | Bin 0 -> 52495 bytes .../storagedriver/images/btfs_layers.png | Bin 0 -> 69487 bytes .../storagedriver/images/btfs_pool.jpg | Bin 0 -> 43267 bytes .../storagedriver/images/btfs_snapshots.jpg | Bin 0 -> 19902 bytes .../storagedriver/images/btfs_subvolume.jpg | Bin 0 -> 30522 bytes .../storagedriver/images/container-layers.jpg | Bin 0 -> 46046 bytes .../storagedriver/images/dm_container.jpg | Bin 0 -> 51563 bytes .../storagedriver/images/image-layers.jpg | Bin 0 -> 26599 bytes .../images/overlay_constructs.jpg | Bin 0 -> 49536 bytes .../images/overlay_constructs2.jpg | Bin 0 -> 84972 bytes .../storagedriver/images/saving-space.jpg | Bin 0 -> 44021 bytes .../storagedriver/images/shared-uuid.jpg | Bin 0 -> 60731 bytes .../storagedriver/images/shared-volume.jpg | Bin 0 -> 48857 bytes .../storagedriver/images/sharing-layers.jpg | Bin 0 -> 56036 bytes .../storagedriver/images/two_dm_container.jpg | Bin 0 -> 65447 bytes .../storagedriver/images/zfs_clones.jpg | Bin 0 -> 23027 bytes .../storagedriver/images/zfs_zpool.jpg | Bin 0 -> 30560 bytes .../storagedriver/images/zpool_blocks.jpg | Bin 0 -> 42455 bytes .../storagedriver/imagesandcontainers.md | 255 + docs/userguide/storagedriver/index.md | 38 + .../storagedriver/overlayfs-driver.md | 190 + docs/userguide/storagedriver/selectadriver.md | 119 + docs/userguide/storagedriver/zfs-driver.md | 218 + docs/userguide/usingdocker.md | 306 + docs/userguide/webapp1.png | Bin 0 -> 13345 bytes errors/README.md | 58 + errors/builder.go | 93 + errors/daemon.go | 883 + errors/error.go | 6 + errors/image.go | 20 + errors/server.go | 36 + experimental/README.md | 81 + experimental/plugins_graphdriver.md | 321 + experimental/userns.md | 120 + graph/export.go | 180 + graph/fixtures/validate_manifest/bad_manifest | 38 + .../validate_manifest/extra_data_manifest | 46 + .../fixtures/validate_manifest/good_manifest | 38 + .../validate_manifest/no_signature_manifest | 22 + graph/graph.go | 953 + graph/graph_test.go | 308 + graph/history.go | 120 + graph/import.go | 79 + graph/list.go | 185 + graph/load.go | 132 + graph/load_unsupported.go | 14 + graph/mutex.go | 45 + graph/pools_test.go | 44 + graph/pull.go | 148 + graph/pull_v1.go | 350 + graph/pull_v2.go | 698 + graph/pull_v2_test.go | 194 + graph/push.go | 150 + graph/push_v1.go | 354 + graph/push_v2.go | 391 + graph/registry.go | 114 + graph/service.go | 89 + graph/tags.go | 498 + graph/tags/tags.go | 33 + graph/tags/tags_unit_test.go | 23 + graph/tags_unit_test.go | 205 + hack/.vendor-helpers.sh | 140 + hack/dind | 118 + hack/generate-authors.sh | 15 + hack/install.sh | 435 + hack/make.sh | 321 + hack/make/.build-deb/compat | 1 + hack/make/.build-deb/control | 26 + .../.build-deb/docker-engine.bash-completion | 1 + .../.build-deb/docker-engine.docker.default | 1 + .../make/.build-deb/docker-engine.docker.init | 1 + .../.build-deb/docker-engine.docker.upstart | 1 + hack/make/.build-deb/docker-engine.install | 11 + hack/make/.build-deb/docker-engine.manpages | 1 + hack/make/.build-deb/docker-engine.postinst | 20 + hack/make/.build-deb/docker-engine.udev | 1 + hack/make/.build-deb/docs | 2 + hack/make/.build-deb/rules | 36 + .../.build-rpm/docker-engine-selinux.spec | 102 + hack/make/.build-rpm/docker-engine.spec | 221 + hack/make/.dockerinit | 33 + hack/make/.dockerinit-gccgo | 31 + hack/make/.ensure-emptyfs | 23 + hack/make/.ensure-frozen-images | 38 + hack/make/.ensure-httpserver | 15 + hack/make/.go-autogen | 54 + hack/make/.go-compile-test-dir | 39 + hack/make/.integration-daemon-setup | 5 + hack/make/.integration-daemon-start | 80 + hack/make/.integration-daemon-stop | 21 + .../.resources-windows/docker.exe.manifest | 18 + hack/make/.resources-windows/docker.ico | Bin 0 -> 370070 bytes hack/make/.resources-windows/docker.png | Bin 0 -> 658195 bytes hack/make/.validate | 33 + hack/make/README.md | 17 + hack/make/binary | 36 + hack/make/build-deb | 71 + hack/make/build-rpm | 93 + hack/make/cover | 20 + hack/make/cross | 34 + hack/make/dind-dynbinary | 23 + hack/make/dynbinary | 20 + hack/make/dyngccgo | 21 + hack/make/gccgo | 27 + hack/make/release-deb | 151 + hack/make/release-rpm | 75 + hack/make/rpm | 202 + hack/make/sign-repos | 55 + hack/make/test-docker-py | 18 + hack/make/test-install-script | 29 + hack/make/test-integration-cli | 18 + hack/make/test-unit | 86 + hack/make/tgz | 33 + hack/make/ubuntu | 197 + hack/make/validate-dco | 54 + hack/make/validate-gofmt | 30 + hack/make/validate-lint | 30 + hack/make/validate-pkg | 32 + hack/make/validate-test | 35 + hack/make/validate-toml | 30 + hack/make/validate-vet | 31 + hack/release.sh | 418 + hack/vendor.sh | 71 + image/fixtures/post1.9/expected_computed_id | 1 + image/fixtures/post1.9/expected_config | 1 + image/fixtures/post1.9/layer_id | 1 + image/fixtures/post1.9/parent_id | 1 + image/fixtures/post1.9/v1compatibility | 1 + image/fixtures/pre1.9/expected_computed_id | 1 + image/fixtures/pre1.9/expected_config | 1 + image/fixtures/pre1.9/layer_id | 1 + image/fixtures/pre1.9/parent_id | 1 + image/fixtures/pre1.9/v1compatibility | 1 + image/image.go | 149 + image/image_test.go | 55 + image/spec/v1.md | 573 + integration-cli/check_test.go | 108 + integration-cli/docker_api_attach_test.go | 226 + integration-cli/docker_api_build_test.go | 285 + integration-cli/docker_api_containers_test.go | 1592 + integration-cli/docker_api_create_test.go | 38 + integration-cli/docker_api_events_test.go | 29 + .../docker_api_exec_resize_test.go | 105 + integration-cli/docker_api_exec_test.go | 91 + integration-cli/docker_api_images_test.go | 137 + integration-cli/docker_api_info_test.go | 37 + integration-cli/docker_api_inspect_test.go | 184 + .../docker_api_inspect_unix_test.go | 38 + integration-cli/docker_api_logs_test.go | 91 + integration-cli/docker_api_network_test.go | 304 + integration-cli/docker_api_resize_test.go | 48 + integration-cli/docker_api_stats_test.go | 148 + integration-cli/docker_api_test.go | 73 + integration-cli/docker_api_version_test.go | 25 + integration-cli/docker_api_volumes_test.go | 89 + integration-cli/docker_cli_attach_test.go | 177 + .../docker_cli_attach_unix_test.go | 270 + integration-cli/docker_cli_build_test.go | 6350 + integration-cli/docker_cli_build_unix_test.go | 72 + integration-cli/docker_cli_by_digest_test.go | 564 + integration-cli/docker_cli_commit_test.go | 219 + integration-cli/docker_cli_config_test.go | 150 + .../docker_cli_cp_from_container_test.go | 626 + integration-cli/docker_cli_cp_test.go | 820 + .../docker_cli_cp_to_container_test.go | 767 + integration-cli/docker_cli_cp_utils.go | 316 + integration-cli/docker_cli_create_test.go | 472 + integration-cli/docker_cli_daemon_test.go | 1852 + integration-cli/docker_cli_diff_test.go | 92 + integration-cli/docker_cli_events_test.go | 748 + .../docker_cli_events_unix_test.go | 153 + integration-cli/docker_cli_exec_test.go | 627 + integration-cli/docker_cli_exec_unix_test.go | 74 + .../docker_cli_experimental_test.go | 84 + .../docker_cli_export_import_test.go | 58 + ...cker_cli_external_graphdriver_unix_test.go | 358 + integration-cli/docker_cli_help_test.go | 365 + integration-cli/docker_cli_history_test.go | 137 + integration-cli/docker_cli_images_test.go | 247 + integration-cli/docker_cli_import_test.go | 128 + integration-cli/docker_cli_info_test.go | 104 + .../docker_cli_inspect_experimental_test.go | 45 + integration-cli/docker_cli_inspect_test.go | 399 + integration-cli/docker_cli_kill_test.go | 106 + integration-cli/docker_cli_links_test.go | 250 + integration-cli/docker_cli_links_unix_test.go | 27 + integration-cli/docker_cli_login_test.go | 21 + integration-cli/docker_cli_logs_test.go | 383 + integration-cli/docker_cli_nat_test.go | 111 + integration-cli/docker_cli_netmode_test.go | 165 + .../docker_cli_network_unix_test.go | 790 + integration-cli/docker_cli_pause_test.go | 92 + integration-cli/docker_cli_port_test.go | 297 + integration-cli/docker_cli_proxy_test.go | 53 + integration-cli/docker_cli_ps_test.go | 751 + integration-cli/docker_cli_pull_local_test.go | 161 + integration-cli/docker_cli_pull_test.go | 607 + .../docker_cli_pull_trusted_test.go | 265 + integration-cli/docker_cli_push_test.go | 449 + integration-cli/docker_cli_rename_test.go | 96 + integration-cli/docker_cli_restart_test.go | 150 + integration-cli/docker_cli_rm_test.go | 95 + integration-cli/docker_cli_rmi_test.go | 399 + integration-cli/docker_cli_run_test.go | 3706 + integration-cli/docker_cli_run_unix_test.go | 457 + integration-cli/docker_cli_save_load_test.go | 395 + .../docker_cli_save_load_unix_test.go | 66 + integration-cli/docker_cli_search_test.go | 55 + integration-cli/docker_cli_start_test.go | 230 + ...ocker_cli_start_volume_driver_unix_test.go | 364 + integration-cli/docker_cli_stats_test.go | 50 + integration-cli/docker_cli_tag_test.go | 173 + integration-cli/docker_cli_top_test.go | 43 + integration-cli/docker_cli_v2_only.go | 148 + integration-cli/docker_cli_version_test.go | 63 + integration-cli/docker_cli_volume_test.go | 161 + integration-cli/docker_cli_wait_test.go | 95 + integration-cli/docker_hub_pull_suite_test.go | 90 + integration-cli/docker_test_vars.go | 115 + integration-cli/docker_utils.go | 1614 + integration-cli/fixtures/https/ca.pem | 23 + .../fixtures/https/client-cert.pem | 73 + integration-cli/fixtures/https/client-key.pem | 16 + .../fixtures/https/client-rogue-cert.pem | 73 + .../fixtures/https/client-rogue-key.pem | 16 + .../fixtures/https/server-cert.pem | 76 + integration-cli/fixtures/https/server-key.pem | 16 + .../fixtures/https/server-rogue-cert.pem | 76 + .../fixtures/https/server-rogue-key.pem | 16 + .../fixtures/notary/localhost.cert | 19 + integration-cli/fixtures/notary/localhost.key | 27 + integration-cli/registry.go | 120 + integration-cli/registry_mock.go | 56 + integration-cli/requirements.go | 171 + integration-cli/requirements_unix.go | 82 + integration-cli/test_vars_exec.go | 8 + integration-cli/test_vars_noexec.go | 8 + integration-cli/test_vars_unix.go | 10 + integration-cli/test_vars_windows.go | 11 + integration-cli/trust_server.go | 177 + integration-cli/utils.go | 78 + man/Dockerfile | 7 + man/Dockerfile.5.md | 469 + man/README.md | 33 + man/docker-attach.1.md | 70 + man/docker-build.1.md | 270 + man/docker-commit.1.md | 70 + man/docker-cp.1.md | 151 + man/docker-create.1.md | 287 + man/docker-daemon.8.md | 466 + man/docker-diff.1.md | 49 + man/docker-events.1.md | 86 + man/docker-exec.1.md | 60 + man/docker-export.1.md | 46 + man/docker-history.1.md | 52 + man/docker-images.1.md | 100 + man/docker-import.1.md | 72 + man/docker-info.1.md | 50 + man/docker-inspect.1.md | 308 + man/docker-kill.1.md | 28 + man/docker-load.1.md | 46 + man/docker-login.1.md | 51 + man/docker-logout.1.md | 32 + man/docker-logs.1.md | 56 + man/docker-network-connect.1.md | 55 + man/docker-network-create.1.md | 149 + man/docker-network-disconnect.1.md | 32 + man/docker-network-inspect.1.md | 58 + man/docker-network-ls.1.md | 51 + man/docker-network-rm.1.md | 29 + man/docker-pause.1.md | 30 + man/docker-port.1.md | 47 + man/docker-ps.1.md | 133 + man/docker-pull.1.md | 91 + man/docker-push.1.md | 52 + man/docker-rename.1.md | 15 + man/docker-restart.1.md | 26 + man/docker-rm.1.md | 56 + man/docker-rmi.1.md | 42 + man/docker-run.1.md | 734 + man/docker-save.1.md | 45 + man/docker-search.1.md | 65 + man/docker-start.1.md | 34 + man/docker-stats.1.md | 31 + man/docker-stop.1.md | 30 + man/docker-tag.1.md | 65 + man/docker-top.1.md | 34 + man/docker-unpause.1.md | 27 + man/docker-version.1.md | 62 + man/docker-volume-create.1.md | 55 + man/docker-volume-inspect.1.md | 29 + man/docker-volume-ls.1.md | 30 + man/docker-volume-rm.1.md | 26 + man/docker-wait.1.md | 30 + man/docker.1.md | 245 + man/md2man-all.sh | 22 + opts/envfile.go | 67 + opts/envfile_test.go | 142 + opts/hosts_unix.go | 8 + opts/hosts_windows.go | 6 + opts/ip.go | 42 + opts/ip_test.go | 54 + opts/opts.go | 381 + opts/opts_test.go | 479 + opts/ulimit.go | 52 + opts/ulimit_test.go | 42 + pkg/README.md | 11 + pkg/ansiescape/split.go | 89 + pkg/ansiescape/split_test.go | 53 + pkg/archive/README.md | 1 + pkg/archive/archive.go | 1016 + pkg/archive/archive_test.go | 1204 + pkg/archive/archive_unix.go | 113 + pkg/archive/archive_unix_test.go | 60 + pkg/archive/archive_windows.go | 70 + pkg/archive/archive_windows_test.go | 87 + pkg/archive/changes.go | 397 + pkg/archive/changes_linux.go | 285 + pkg/archive/changes_other.go | 97 + pkg/archive/changes_posix_test.go | 127 + pkg/archive/changes_test.go | 495 + pkg/archive/changes_unix.go | 27 + pkg/archive/changes_windows.go | 20 + pkg/archive/copy.go | 407 + pkg/archive/copy_test.go | 625 + pkg/archive/copy_unix.go | 11 + pkg/archive/copy_windows.go | 9 + pkg/archive/diff.go | 279 + pkg/archive/diff_test.go | 370 + pkg/archive/example_changes.go | 97 + pkg/archive/testdata/broken.tar | Bin 0 -> 13824 bytes pkg/archive/time_linux.go | 16 + pkg/archive/time_unsupported.go | 16 + pkg/archive/utils_test.go | 166 + pkg/archive/whiteouts.go | 23 + pkg/archive/wrap.go | 59 + pkg/archive/wrap_test.go | 98 + pkg/broadcaster/buffered.go | 167 + pkg/broadcaster/unbuffered.go | 49 + pkg/broadcaster/unbuffered_test.go | 162 + pkg/chrootarchive/archive.go | 92 + pkg/chrootarchive/archive_test.go | 381 + pkg/chrootarchive/archive_unix.go | 91 + pkg/chrootarchive/archive_windows.go | 22 + pkg/chrootarchive/diff.go | 19 + pkg/chrootarchive/diff_unix.go | 118 + pkg/chrootarchive/diff_windows.go | 44 + pkg/chrootarchive/init_unix.go | 28 + pkg/chrootarchive/init_windows.go | 4 + pkg/devicemapper/attach_loopback.go | 129 + pkg/devicemapper/devmapper.go | 862 + pkg/devicemapper/devmapper_log.go | 35 + pkg/devicemapper/devmapper_wrapper.go | 293 + .../devmapper_wrapper_deferred_remove.go | 34 + .../devmapper_wrapper_no_deferred_remove.go | 15 + pkg/devicemapper/ioctl.go | 72 + pkg/devicemapper/log.go | 11 + pkg/directory/directory.go | 26 + pkg/directory/directory_test.go | 182 + pkg/directory/directory_unix.go | 39 + pkg/directory/directory_windows.go | 35 + pkg/discovery/README.md | 41 + pkg/discovery/backends.go | 111 + pkg/discovery/discovery.go | 35 + pkg/discovery/discovery_test.go | 131 + pkg/discovery/entry.go | 97 + pkg/discovery/file/file.go | 109 + pkg/discovery/file/file_test.go | 114 + pkg/discovery/generator.go | 35 + pkg/discovery/generator_test.go | 53 + pkg/discovery/kv/kv.go | 174 + pkg/discovery/kv/kv_test.go | 324 + pkg/discovery/nodes/nodes.go | 54 + pkg/discovery/nodes/nodes_test.go | 51 + pkg/fileutils/fileutils.go | 184 + pkg/fileutils/fileutils_test.go | 402 + pkg/fileutils/fileutils_unix.go | 22 + pkg/fileutils/fileutils_windows.go | 7 + pkg/graphdb/conn_sqlite3.go | 15 + pkg/graphdb/conn_sqlite3_unix.go | 7 + pkg/graphdb/conn_sqlite3_windows.go | 7 + pkg/graphdb/conn_unsupported.go | 8 + pkg/graphdb/graphdb.go | 551 + pkg/graphdb/graphdb_test.go | 657 + pkg/graphdb/sort.go | 27 + pkg/graphdb/sort_test.go | 29 + pkg/graphdb/utils.go | 32 + pkg/homedir/homedir.go | 39 + pkg/homedir/homedir_test.go | 24 + pkg/httputils/httputils.go | 56 + pkg/httputils/httputils_test.go | 115 + pkg/httputils/mimetype.go | 30 + pkg/httputils/mimetype_test.go | 13 + pkg/httputils/resumablerequestreader.go | 95 + pkg/httputils/resumablerequestreader_test.go | 307 + pkg/idtools/idtools.go | 188 + pkg/idtools/usergroupadd_linux.go | 175 + pkg/idtools/usergroupadd_unsupported.go | 26 + pkg/integration/checker/checker.go | 59 + pkg/integration/checker/checker_test.go | 57 + pkg/integration/dockerCmd_utils.go | 71 + pkg/integration/dockerCmd_utils_test.go | 405 + pkg/integration/utils.go | 348 + pkg/integration/utils_test.go | 492 + pkg/ioutils/bytespipe.go | 89 + pkg/ioutils/bytespipe_test.go | 141 + pkg/ioutils/fmt.go | 22 + pkg/ioutils/fmt_test.go | 17 + pkg/ioutils/multireader.go | 226 + pkg/ioutils/multireader_test.go | 149 + pkg/ioutils/readers.go | 252 + pkg/ioutils/readers_test.go | 224 + pkg/ioutils/scheduler.go | 6 + pkg/ioutils/scheduler_gccgo.go | 13 + pkg/ioutils/temp_unix.go | 10 + pkg/ioutils/temp_windows.go | 18 + pkg/ioutils/writeflusher.go | 92 + pkg/ioutils/writers.go | 66 + pkg/ioutils/writers_test.go | 65 + pkg/jsonlog/jsonlog.go | 40 + pkg/jsonlog/jsonlog_marshalling.go | 184 + pkg/jsonlog/jsonlog_marshalling_test.go | 34 + pkg/jsonlog/jsonlogbytes.go | 124 + pkg/jsonlog/jsonlogbytes_test.go | 39 + pkg/jsonmessage/jsonmessage.go | 196 + pkg/jsonmessage/jsonmessage_test.go | 231 + pkg/listenbuffer/README.md | 27 + pkg/listenbuffer/buffer.go | 76 + pkg/listenbuffer/listen_buffer_test.go | 41 + pkg/longpath/longpath.go | 26 + pkg/longpath/longpath_test.go | 22 + pkg/mflag/LICENSE | 27 + pkg/mflag/README.md | 40 + pkg/mflag/example/example.go | 36 + pkg/mflag/flag.go | 1245 + pkg/mflag/flag_test.go | 516 + pkg/mount/flags.go | 69 + pkg/mount/flags_freebsd.go | 48 + pkg/mount/flags_linux.go | 85 + pkg/mount/flags_unsupported.go | 30 + pkg/mount/mount.go | 74 + pkg/mount/mount_test.go | 137 + pkg/mount/mounter_freebsd.go | 59 + pkg/mount/mounter_linux.go | 21 + pkg/mount/mounter_unsupported.go | 11 + pkg/mount/mountinfo.go | 40 + pkg/mount/mountinfo_freebsd.go | 41 + pkg/mount/mountinfo_linux.go | 95 + pkg/mount/mountinfo_linux_test.go | 477 + pkg/mount/mountinfo_unsupported.go | 12 + pkg/mount/sharedsubtree_linux.go | 70 + pkg/mount/sharedsubtree_linux_test.go | 331 + .../cmd/names-generator/main.go | 11 + pkg/namesgenerator/names-generator.go | 492 + pkg/namesgenerator/names-generator_test.go | 45 + pkg/nat/nat.go | 227 + pkg/nat/nat_test.go | 525 + pkg/nat/sort.go | 98 + pkg/nat/sort_test.go | 85 + pkg/parsers/filters/parse.go | 134 + pkg/parsers/filters/parse_test.go | 218 + pkg/parsers/kernel/kernel.go | 100 + pkg/parsers/kernel/kernel_test.go | 92 + pkg/parsers/kernel/kernel_windows.go | 67 + pkg/parsers/kernel/uname_linux.go | 19 + pkg/parsers/kernel/uname_unsupported.go | 18 + .../operatingsystem_freebsd.go | 18 + .../operatingsystem/operatingsystem_linux.go | 44 + .../operatingsystem/operatingsystem_test.go | 124 + .../operatingsystem_windows.go | 49 + pkg/parsers/parsers.go | 258 + pkg/parsers/parsers_test.go | 282 + pkg/pidfile/pidfile.go | 48 + pkg/pidfile/pidfile_test.go | 32 + pkg/plugins/client.go | 154 + pkg/plugins/client_test.go | 123 + pkg/plugins/discovery.go | 106 + pkg/plugins/discovery_test.go | 169 + pkg/plugins/pluginrpc-gen/README.md | 68 + pkg/plugins/pluginrpc-gen/fixtures/foo.go | 41 + pkg/plugins/pluginrpc-gen/main.go | 91 + pkg/plugins/pluginrpc-gen/parser.go | 163 + pkg/plugins/pluginrpc-gen/parser_test.go | 168 + pkg/plugins/pluginrpc-gen/template.go | 97 + pkg/plugins/plugins.go | 182 + pkg/pools/pools.go | 119 + pkg/pools/pools_test.go | 162 + pkg/progressreader/progressreader.go | 68 + pkg/progressreader/progressreader_test.go | 94 + pkg/promise/promise.go | 11 + pkg/proxy/network_proxy_test.go | 216 + pkg/proxy/proxy.go | 37 + pkg/proxy/stub_proxy.go | 31 + pkg/proxy/tcp_proxy.go | 99 + pkg/proxy/udp_proxy.go | 169 + pkg/pubsub/publisher.go | 84 + pkg/pubsub/publisher_test.go | 142 + pkg/random/random.go | 71 + pkg/random/random_test.go | 22 + pkg/reexec/README.md | 5 + pkg/reexec/command_freebsd.go | 23 + pkg/reexec/command_linux.go | 28 + pkg/reexec/command_unsupported.go | 12 + pkg/reexec/command_windows.go | 23 + pkg/reexec/reexec.go | 47 + pkg/signal/README.md | 1 + pkg/signal/signal.go | 44 + pkg/signal/signal_darwin.go | 41 + pkg/signal/signal_freebsd.go | 43 + pkg/signal/signal_linux.go | 44 + pkg/signal/signal_unix.go | 19 + pkg/signal/signal_unsupported.go | 10 + pkg/signal/signal_windows.go | 27 + pkg/signal/trap.go | 74 + pkg/sockets/README.md | 0 pkg/sockets/tcp_socket.go | 48 + pkg/sockets/unix_socket.go | 83 + pkg/stdcopy/stdcopy.go | 175 + pkg/stdcopy/stdcopy_test.go | 261 + pkg/streamformatter/streamformatter.go | 123 + pkg/streamformatter/streamformatter_test.go | 93 + pkg/stringid/README.md | 1 + pkg/stringid/stringid.go | 67 + pkg/stringid/stringid_test.go | 56 + pkg/stringutils/README.md | 1 + pkg/stringutils/stringutils.go | 87 + pkg/stringutils/stringutils_test.go | 105 + pkg/stringutils/strslice.go | 71 + pkg/stringutils/strslice_test.go | 135 + pkg/symlink/LICENSE.APACHE | 191 + pkg/symlink/LICENSE.BSD | 27 + pkg/symlink/README.md | 6 + pkg/symlink/fs.go | 143 + pkg/symlink/fs_test.go | 402 + pkg/symlink/fs_unix.go | 11 + pkg/symlink/fs_windows.go | 156 + pkg/sysinfo/README.md | 1 + pkg/sysinfo/sysinfo.go | 105 + pkg/sysinfo/sysinfo_freebsd.go | 7 + pkg/sysinfo/sysinfo_linux.go | 165 + pkg/sysinfo/sysinfo_linux_test.go | 58 + pkg/sysinfo/sysinfo_test.go | 26 + pkg/sysinfo/sysinfo_windows.go | 7 + pkg/system/chtimes.go | 31 + pkg/system/chtimes_test.go | 120 + pkg/system/chtimes_unix_test.go | 121 + pkg/system/chtimes_windows_test.go | 114 + pkg/system/errors.go | 10 + pkg/system/events_windows.go | 83 + pkg/system/filesys.go | 19 + pkg/system/filesys_windows.go | 82 + pkg/system/lstat.go | 19 + pkg/system/lstat_unix_test.go | 30 + pkg/system/lstat_windows.go | 25 + pkg/system/meminfo.go | 17 + pkg/system/meminfo_linux.go | 66 + pkg/system/meminfo_unix_test.go | 40 + pkg/system/meminfo_unsupported.go | 8 + pkg/system/meminfo_windows.go | 44 + pkg/system/mknod.go | 22 + pkg/system/mknod_windows.go | 13 + pkg/system/stat.go | 53 + pkg/system/stat_freebsd.go | 27 + pkg/system/stat_linux.go | 33 + pkg/system/stat_unix_test.go | 39 + pkg/system/stat_unsupported.go | 17 + pkg/system/stat_windows.go | 43 + pkg/system/umask.go | 13 + pkg/system/umask_windows.go | 9 + pkg/system/utimes_darwin.go | 8 + pkg/system/utimes_freebsd.go | 22 + pkg/system/utimes_linux.go | 26 + pkg/system/utimes_unix_test.go | 68 + pkg/system/utimes_unsupported.go | 10 + pkg/system/xattrs_linux.go | 63 + pkg/system/xattrs_unsupported.go | 13 + pkg/tailfile/tailfile.go | 66 + pkg/tailfile/tailfile_test.go | 148 + pkg/tarsum/builder_context.go | 21 + pkg/tarsum/builder_context_test.go | 63 + pkg/tarsum/fileinfosums.go | 126 + pkg/tarsum/fileinfosums_test.go | 62 + pkg/tarsum/tarsum.go | 294 + pkg/tarsum/tarsum_spec.md | 230 + pkg/tarsum/tarsum_test.go | 648 + .../json | 1 + .../layer.tar | Bin 0 -> 9216 bytes .../json | 1 + .../layer.tar | Bin 0 -> 1536 bytes pkg/tarsum/testdata/collision/collision-0.tar | Bin 0 -> 10240 bytes pkg/tarsum/testdata/collision/collision-1.tar | Bin 0 -> 10240 bytes pkg/tarsum/testdata/collision/collision-2.tar | Bin 0 -> 10240 bytes pkg/tarsum/testdata/collision/collision-3.tar | Bin 0 -> 10240 bytes pkg/tarsum/testdata/xattr/json | 1 + pkg/tarsum/testdata/xattr/layer.tar | Bin 0 -> 2560 bytes pkg/tarsum/versioning.go | 150 + pkg/tarsum/versioning_test.go | 98 + pkg/tarsum/writercloser.go | 22 + pkg/term/tc_linux_cgo.go | 51 + pkg/term/tc_other.go | 19 + pkg/term/term.go | 132 + pkg/term/term_windows.go | 205 + pkg/term/termios_darwin.go | 69 + pkg/term/termios_freebsd.go | 69 + pkg/term/termios_linux.go | 47 + pkg/term/windows/ansi_reader.go | 256 + pkg/term/windows/ansi_writer.go | 76 + pkg/term/windows/console.go | 61 + pkg/term/windows/windows.go | 5 + pkg/term/windows/windows_test.go | 3 + pkg/timeoutconn/timeoutconn.go | 28 + pkg/timeoutconn/timeoutconn_test.go | 33 + pkg/timeutils/json.go | 27 + pkg/timeutils/json_test.go | 47 + pkg/timeutils/utils.go | 36 + pkg/timeutils/utils_test.go | 44 + pkg/tlsconfig/config.go | 132 + pkg/truncindex/truncindex.go | 128 + pkg/truncindex/truncindex_test.go | 429 + pkg/ulimit/ulimit.go | 111 + pkg/ulimit/ulimit_test.go | 55 + pkg/units/duration.go | 33 + pkg/units/duration_test.go | 46 + pkg/units/size.go | 95 + pkg/units/size_test.go | 108 + pkg/urlutil/urlutil.go | 50 + pkg/urlutil/urlutil_test.go | 55 + pkg/useragent/README.md | 1 + pkg/useragent/useragent.go | 55 + pkg/useragent/useragent_test.go | 31 + pkg/version/version.go | 63 + pkg/version/version_test.go | 27 + project/BRANCHES-AND-TAGS.md | 35 + project/CONTRIBUTORS.md | 1 + project/GOVERNANCE.md | 17 + project/IRC-ADMINISTRATION.md | 37 + project/ISSUE-TRIAGE.md | 92 + project/PACKAGERS.md | 331 + project/PRINCIPLES.md | 19 + project/README.md | 24 + project/RELEASE-CHECKLIST.md | 415 + project/RELEASE-PROCESS.md | 78 + project/REVIEWING.md | 193 + project/TOOLS.md | 74 + project/make/validate-toml | 30 + registry/auth.go | 255 + registry/auth_test.go | 173 + registry/authchallenge.go | 150 + registry/config.go | 416 + registry/config_test.go | 49 + registry/config_unix.go | 22 + registry/config_windows.go | 30 + registry/endpoint.go | 293 + registry/endpoint_test.go | 93 + registry/reference.go | 68 + registry/registry.go | 249 + registry/registry_mock_test.go | 476 + registry/registry_test.go | 953 + registry/service.go | 162 + registry/service_v1.go | 54 + registry/service_v2.go | 83 + registry/session.go | 761 + registry/token.go | 81 + registry/types.go | 140 + runconfig/compare.go | 63 + runconfig/compare_test.go | 125 + runconfig/config.go | 63 + runconfig/config_test.go | 45 + runconfig/config_unix.go | 53 + runconfig/config_windows.go | 13 + runconfig/exec.go | 62 + runconfig/exec_test.go | 129 + runconfig/fixtures/container_config_1_14.json | 30 + runconfig/fixtures/container_config_1_17.json | 50 + runconfig/fixtures/container_config_1_19.json | 58 + .../fixtures/container_hostconfig_1_14.json | 18 + .../fixtures/container_hostconfig_1_19.json | 30 + runconfig/fixtures/valid.env | 1 + runconfig/fixtures/valid.label | 1 + runconfig/hostconfig.go | 284 + runconfig/hostconfig_test.go | 268 + runconfig/hostconfig_unix.go | 91 + runconfig/hostconfig_windows.go | 34 + runconfig/merge.go | 80 + runconfig/merge_test.go | 83 + runconfig/parse.go | 524 + runconfig/parse_test.go | 492 + runconfig/parse_unix.go | 60 + runconfig/parse_windows.go | 22 + utils/experimental.go | 9 + utils/git.go | 100 + utils/git_test.go | 186 + utils/names.go | 9 + utils/stubs.go | 9 + utils/timeout.go | 21 + utils/utils.go | 306 + utils/utils_test.go | 103 + utils/utils_unix.go | 11 + utils/utils_windows.go | 17 + .../src/github.com/Azure/go-ansiterm/LICENSE | 21 + .../github.com/Azure/go-ansiterm/README.md | 9 + .../github.com/Azure/go-ansiterm/constants.go | 188 + .../github.com/Azure/go-ansiterm/context.go | 7 + .../Azure/go-ansiterm/csi_entry_state.go | 49 + .../Azure/go-ansiterm/csi_param_state.go | 38 + .../go-ansiterm/escape_intermediate_state.go | 36 + .../Azure/go-ansiterm/escape_state.go | 47 + .../Azure/go-ansiterm/event_handler.go | 90 + .../Azure/go-ansiterm/ground_state.go | 24 + .../Azure/go-ansiterm/osc_string_state.go | 31 + .../github.com/Azure/go-ansiterm/parser.go | 137 + .../go-ansiterm/parser_action_helpers.go | 103 + .../Azure/go-ansiterm/parser_actions.go | 122 + .../Azure/go-ansiterm/parser_test_helpers.go | 114 + .../go-ansiterm/parser_test_utilities.go | 66 + .../github.com/Azure/go-ansiterm/states.go | 71 + .../Azure/go-ansiterm/test_event_handler.go | 173 + .../github.com/Azure/go-ansiterm/utilities.go | 21 + .../Azure/go-ansiterm/winterm/ansi.go | 182 + .../Azure/go-ansiterm/winterm/api.go | 329 + .../go-ansiterm/winterm/attr_translation.go | 102 + .../go-ansiterm/winterm/cursor_helpers.go | 101 + .../go-ansiterm/winterm/erase_helpers.go | 86 + .../go-ansiterm/winterm/scroll_helper.go | 118 + .../Azure/go-ansiterm/winterm/utilities.go | 9 + .../go-ansiterm/winterm/win_event_handler.go | 725 + .../src/github.com/BurntSushi/toml/.gitignore | 5 + .../github.com/BurntSushi/toml/.travis.yml | 12 + .../src/github.com/BurntSushi/toml/COMPATIBLE | 3 + vendor/src/github.com/BurntSushi/toml/COPYING | 14 + .../src/github.com/BurntSushi/toml/Makefile | 19 + .../src/github.com/BurntSushi/toml/README.md | 220 + .../toml/cmd/toml-test-decoder/COPYING | 14 + .../toml/cmd/toml-test-encoder/COPYING | 14 + .../BurntSushi/toml/cmd/tomlv/COPYING | 14 + .../src/github.com/BurntSushi/toml/decode.go | 492 + .../github.com/BurntSushi/toml/decode_meta.go | 122 + vendor/src/github.com/BurntSushi/toml/doc.go | 27 + .../src/github.com/BurntSushi/toml/encode.go | 496 + .../BurntSushi/toml/encoding_types.go | 19 + .../BurntSushi/toml/encoding_types_1.1.go | 18 + vendor/src/github.com/BurntSushi/toml/lex.go | 874 + .../src/github.com/BurntSushi/toml/parse.go | 498 + .../github.com/BurntSushi/toml/session.vim | 1 + .../github.com/BurntSushi/toml/type_check.go | 91 + .../github.com/BurntSushi/toml/type_fields.go | 241 + .../src/github.com/Graylog2/go-gelf/LICENSE | 21 + .../Graylog2/go-gelf/gelf/reader.go | 142 + .../Graylog2/go-gelf/gelf/writer.go | 373 + .../src/github.com/Sirupsen/logrus/.gitignore | 1 + .../github.com/Sirupsen/logrus/.travis.yml | 8 + .../github.com/Sirupsen/logrus/CHANGELOG.md | 21 + vendor/src/github.com/Sirupsen/logrus/LICENSE | 21 + .../src/github.com/Sirupsen/logrus/README.md | 350 + .../src/github.com/Sirupsen/logrus/entry.go | 254 + .../github.com/Sirupsen/logrus/exported.go | 188 + .../github.com/Sirupsen/logrus/formatter.go | 48 + .../src/github.com/Sirupsen/logrus/hooks.go | 34 + .../Sirupsen/logrus/json_formatter.go | 41 + .../src/github.com/Sirupsen/logrus/logger.go | 206 + .../src/github.com/Sirupsen/logrus/logrus.go | 94 + .../Sirupsen/logrus/terminal_darwin.go | 12 + .../Sirupsen/logrus/terminal_freebsd.go | 20 + .../Sirupsen/logrus/terminal_linux.go | 12 + .../Sirupsen/logrus/terminal_notwindows.go | 21 + .../Sirupsen/logrus/terminal_openbsd.go | 7 + .../Sirupsen/logrus/terminal_windows.go | 27 + .../Sirupsen/logrus/text_formatter.go | 151 + .../src/github.com/Sirupsen/logrus/writer.go | 31 + vendor/src/github.com/agl/ed25519/LICENSE | 27 + vendor/src/github.com/agl/ed25519/ed25519.go | 125 + .../agl/ed25519/edwards25519/const.go | 1411 + .../agl/ed25519/edwards25519/edwards25519.go | 2127 + .../github.com/armon/go-metrics/.gitignore | 22 + .../src/github.com/armon/go-metrics/LICENSE | 20 + .../src/github.com/armon/go-metrics/README.md | 68 + .../github.com/armon/go-metrics/const_unix.go | 12 + .../armon/go-metrics/const_windows.go | 13 + .../src/github.com/armon/go-metrics/inmem.go | 239 + .../armon/go-metrics/inmem_signal.go | 100 + .../github.com/armon/go-metrics/metrics.go | 115 + .../src/github.com/armon/go-metrics/sink.go | 52 + .../src/github.com/armon/go-metrics/start.go | 95 + .../src/github.com/armon/go-metrics/statsd.go | 154 + .../github.com/armon/go-metrics/statsite.go | 142 + .../src/github.com/aws/aws-sdk-go/LICENSE.txt | 202 + .../aws/aws-sdk-go/aws/awserr/error.go | 105 + .../aws/aws-sdk-go/aws/awserr/types.go | 135 + .../aws/aws-sdk-go/aws/awsutil/copy.go | 103 + .../aws/aws-sdk-go/aws/awsutil/path_value.go | 187 + .../aws/aws-sdk-go/aws/awsutil/prettify.go | 103 + .../github.com/aws/aws-sdk-go/aws/config.go | 254 + .../github.com/aws/aws-sdk-go/aws/convutil.go | 357 + .../aws/credentials/chain_provider.go | 85 + .../aws-sdk-go/aws/credentials/credentials.go | 220 + .../aws/credentials/ec2_role_provider.go | 162 + .../aws/credentials/env_provider.go | 73 + .../aws-sdk-go/aws/credentials/example.ini | 8 + .../shared_credentials_provider.go | 135 + .../aws/credentials/static_provider.go | 44 + .../aws/aws-sdk-go/aws/handler_functions.go | 157 + .../github.com/aws/aws-sdk-go/aws/handlers.go | 85 + .../github.com/aws/aws-sdk-go/aws/logger.go | 89 + .../aws/aws-sdk-go/aws/param_validator.go | 89 + .../github.com/aws/aws-sdk-go/aws/request.go | 312 + .../github.com/aws/aws-sdk-go/aws/service.go | 194 + .../github.com/aws/aws-sdk-go/aws/types.go | 55 + .../github.com/aws/aws-sdk-go/aws/version.go | 8 + .../internal/endpoints/endpoints.go | 31 + .../internal/endpoints/endpoints.json | 77 + .../internal/endpoints/endpoints_map.go | 89 + .../internal/protocol/json/jsonutil/build.go | 199 + .../protocol/json/jsonutil/unmarshal.go | 214 + .../internal/protocol/jsonrpc/jsonrpc.go | 98 + .../internal/protocol/rest/build.go | 212 + .../internal/protocol/rest/payload.go | 45 + .../internal/protocol/rest/unmarshal.go | 174 + .../aws/aws-sdk-go/internal/signer/v4/v4.go | 364 + .../aws-sdk-go/service/cloudwatchlogs/api.go | 2293 + .../service/cloudwatchlogs/service.go | 90 + vendor/src/github.com/boltdb/bolt/.gitignore | 3 + vendor/src/github.com/boltdb/bolt/LICENSE | 20 + vendor/src/github.com/boltdb/bolt/Makefile | 54 + vendor/src/github.com/boltdb/bolt/README.md | 455 + vendor/src/github.com/boltdb/bolt/bolt_386.go | 4 + .../src/github.com/boltdb/bolt/bolt_amd64.go | 4 + vendor/src/github.com/boltdb/bolt/bolt_arm.go | 4 + .../src/github.com/boltdb/bolt/bolt_linux.go | 12 + .../github.com/boltdb/bolt/bolt_openbsd.go | 29 + .../src/github.com/boltdb/bolt/bolt_unix.go | 69 + .../github.com/boltdb/bolt/bolt_windows.go | 74 + .../github.com/boltdb/bolt/boltsync_unix.go | 10 + vendor/src/github.com/boltdb/bolt/bucket.go | 728 + vendor/src/github.com/boltdb/bolt/cursor.go | 376 + vendor/src/github.com/boltdb/bolt/db.go | 689 + vendor/src/github.com/boltdb/bolt/doc.go | 44 + vendor/src/github.com/boltdb/bolt/errors.go | 66 + vendor/src/github.com/boltdb/bolt/freelist.go | 234 + vendor/src/github.com/boltdb/bolt/node.go | 616 + vendor/src/github.com/boltdb/bolt/page.go | 135 + vendor/src/github.com/boltdb/bolt/tx.go | 580 + vendor/src/github.com/coreos/etcd/LICENSE | 202 + .../github.com/coreos/etcd/client/README.md | 94 + .../coreos/etcd/client/auth_role.go | 235 + .../coreos/etcd/client/auth_user.go | 297 + .../coreos/etcd/client/cancelreq.go | 20 + .../coreos/etcd/client/cancelreq_go14.go | 17 + .../github.com/coreos/etcd/client/client.go | 514 + .../coreos/etcd/client/cluster_error.go | 33 + .../src/github.com/coreos/etcd/client/curl.go | 70 + .../github.com/coreos/etcd/client/discover.go | 21 + .../src/github.com/coreos/etcd/client/doc.go | 71 + .../coreos/etcd/client/keys.generated.go | 891 + .../src/github.com/coreos/etcd/client/keys.go | 644 + .../github.com/coreos/etcd/client/members.go | 272 + .../src/github.com/coreos/etcd/client/srv.go | 65 + .../coreos/etcd/pkg/pathutil/path.go | 29 + .../github.com/coreos/etcd/pkg/types/id.go | 41 + .../github.com/coreos/etcd/pkg/types/set.go | 178 + .../github.com/coreos/etcd/pkg/types/slice.go | 22 + .../github.com/coreos/etcd/pkg/types/urls.go | 74 + .../coreos/etcd/pkg/types/urlsmap.go | 75 + .../src/github.com/coreos/go-systemd/LICENSE | 191 + .../coreos/go-systemd/activation/files.go | 52 + .../coreos/go-systemd/activation/listeners.go | 37 + .../go-systemd/activation/packetconns.go | 37 + .../coreos/go-systemd/daemon/sdnotify.go | 31 + .../github.com/coreos/go-systemd/dbus/dbus.go | 163 + .../coreos/go-systemd/dbus/methods.go | 410 + .../coreos/go-systemd/dbus/properties.go | 218 + .../github.com/coreos/go-systemd/dbus/set.go | 47 + .../coreos/go-systemd/dbus/subscription.go | 250 + .../go-systemd/dbus/subscription_set.go | 57 + .../coreos/go-systemd/journal/send.go | 166 + .../github.com/coreos/go-systemd/util/util.go | 33 + .../github.com/deckarep/golang-set/.gitignore | 22 + .../deckarep/golang-set/.travis.yml | 9 + .../github.com/deckarep/golang-set/LICENSE | 22 + .../github.com/deckarep/golang-set/README.md | 94 + .../src/github.com/deckarep/golang-set/set.go | 168 + .../deckarep/golang-set/threadsafe.go | 204 + .../deckarep/golang-set/threadunsafe.go | 246 + .../github.com/docker/distribution/.drone.yml | 38 + .../github.com/docker/distribution/.gitignore | 37 + .../github.com/docker/distribution/.mailmap | 6 + .../github.com/docker/distribution/AUTHORS | 61 + .../docker/distribution/CONTRIBUTING.md | 139 + .../github.com/docker/distribution/Dockerfile | 19 + .../github.com/docker/distribution/LICENSE | 202 + .../docker/distribution/MAINTAINERS | 4 + .../github.com/docker/distribution/Makefile | 74 + .../github.com/docker/distribution/README.md | 121 + .../github.com/docker/distribution/ROADMAP.md | 273 + .../github.com/docker/distribution/blobs.go | 202 + .../github.com/docker/distribution/circle.yml | 122 + .../docker/distribution/context/context.go | 85 + .../docker/distribution/context/doc.go | 76 + .../docker/distribution/context/http.go | 336 + .../docker/distribution/context/logger.go | 101 + .../docker/distribution/context/trace.go | 104 + .../docker/distribution/context/util.go | 32 + .../docker/distribution/digest/digest.go | 168 + .../docker/distribution/digest/digester.go | 95 + .../docker/distribution/digest/doc.go | 52 + .../docker/distribution/digest/set.go | 195 + .../docker/distribution/digest/tarsum.go | 70 + .../docker/distribution/digest/verifiers.go | 122 + .../src/github.com/docker/distribution/doc.go | 7 + .../github.com/docker/distribution/errors.go | 82 + .../docker/distribution/manifest/manifest.go | 124 + .../docker/distribution/manifest/sign.go | 66 + .../docker/distribution/manifest/verify.go | 32 + .../docker/distribution/registry.go | 120 + .../registry/api/errcode/errors.go | 259 + .../registry/api/errcode/handler.go | 44 + .../registry/api/errcode/register.go | 86 + .../registry/api/v2/descriptors.go | 1487 + .../distribution/registry/api/v2/doc.go | 9 + .../distribution/registry/api/v2/errors.go | 154 + .../distribution/registry/api/v2/names.go | 96 + .../distribution/registry/api/v2/routes.go | 49 + .../distribution/registry/api/v2/urls.go | 234 + .../registry/client/auth/api_version.go | 58 + .../registry/client/auth/authchallenge.go | 219 + .../registry/client/auth/session.go | 256 + .../registry/client/blob_writer.go | 172 + .../distribution/registry/client/errors.go | 69 + .../registry/client/repository.go | 547 + .../registry/client/transport/http_reader.go | 173 + .../registry/client/transport/transport.go | 147 + .../registry/storage/cache/cache.go | 35 + .../cache/cachedblobdescriptorstore.go | 101 + .../registry/storage/cache/memory/memory.go | 170 + .../registry/storage/cache/suite.go | 178 + .../docker/distribution/uuid/uuid.go | 126 + .../libcontainer/cgroups/fs/freezer_test.go | 45 + .../docker/libcontainer/nsinit/README.md | 67 + .../docker/libcontainer/rootfs_linux_test.go | 37 + .../src/github.com/docker/libkv/.travis.yml | 34 + .../src/github.com/docker/libkv/LICENSE.code | 191 + .../src/github.com/docker/libkv/LICENSE.docs | 425 + vendor/src/github.com/docker/libkv/README.md | 106 + vendor/src/github.com/docker/libkv/libkv.go | 40 + .../docker/libkv/store/boltdb/boltdb.go | 471 + .../docker/libkv/store/consul/consul.go | 489 + .../docker/libkv/store/etcd/etcd.go | 593 + .../github.com/docker/libkv/store/helpers.go | 47 + .../github.com/docker/libkv/store/store.go | 128 + .../docker/libkv/store/zookeeper/zookeeper.go | 417 + .../github.com/docker/libnetwork/.gitignore | 36 + .../src/github.com/docker/libnetwork/LICENSE | 202 + .../github.com/docker/libnetwork/MAINTAINERS | 5 + .../src/github.com/docker/libnetwork/Makefile | 97 + .../github.com/docker/libnetwork/README.md | 83 + .../github.com/docker/libnetwork/ROADMAP.md | 20 + .../docker/libnetwork/bitseq/sequence.go | 620 + .../docker/libnetwork/bitseq/store.go | 136 + .../github.com/docker/libnetwork/circle.yml | 12 + .../docker/libnetwork/config/config.go | 227 + .../docker/libnetwork/config/libnetwork.toml | 12 + .../docker/libnetwork/controller.go | 698 + .../docker/libnetwork/datastore/cache.go | 153 + .../docker/libnetwork/datastore/datastore.go | 572 + .../docker/libnetwork/datastore/mock_store.go | 129 + .../docker/libnetwork/default_gateway.go | 141 + .../libnetwork/default_gateway_freebsd.go | 7 + .../libnetwork/default_gateway_linux.go | 29 + .../libnetwork/default_gateway_windows.go | 7 + .../docker/libnetwork/driverapi/driverapi.go | 129 + .../docker/libnetwork/driverapi/errors.go | 56 + .../docker/libnetwork/driverapi/ipamdata.go | 103 + .../github.com/docker/libnetwork/drivers.go | 78 + .../libnetwork/drivers/bridge/bridge.go | 1346 + .../libnetwork/drivers/bridge/bridge_store.go | 211 + .../libnetwork/drivers/bridge/errors.go | 341 + .../libnetwork/drivers/bridge/interface.go | 63 + .../libnetwork/drivers/bridge/labels.go | 18 + .../docker/libnetwork/drivers/bridge/link.go | 85 + .../bridge/netlink_deprecated_linux.go | 131 + .../netlink_deprecated_linux_armppc64.go | 7 + .../bridge/netlink_deprecated_linux_notarm.go | 7 + .../bridge/netlink_deprecated_unsupported.go | 18 + .../libnetwork/drivers/bridge/port_mapping.go | 128 + .../libnetwork/drivers/bridge/resolvconf.go | 67 + .../docker/libnetwork/drivers/bridge/setup.go | 26 + .../bridge/setup_bridgenetfiltering.go | 162 + .../libnetwork/drivers/bridge/setup_device.go | 66 + .../drivers/bridge/setup_firewalld.go | 20 + .../drivers/bridge/setup_ip_forwarding.go | 29 + .../drivers/bridge/setup_ip_tables.go | 253 + .../libnetwork/drivers/bridge/setup_ipv4.go | 62 + .../libnetwork/drivers/bridge/setup_ipv6.go | 119 + .../libnetwork/drivers/bridge/setup_verify.go | 46 + .../docker/libnetwork/drivers/host/host.go | 77 + .../docker/libnetwork/drivers/null/null.go | 77 + .../libnetwork/drivers/overlay/filter.go | 131 + .../libnetwork/drivers/overlay/joinleave.go | 138 + .../libnetwork/drivers/overlay/ov_endpoint.go | 104 + .../libnetwork/drivers/overlay/ov_network.go | 633 + .../libnetwork/drivers/overlay/ov_serf.go | 234 + .../libnetwork/drivers/overlay/ov_utils.go | 105 + .../libnetwork/drivers/overlay/overlay.go | 209 + .../libnetwork/drivers/overlay/peerdb.go | 329 + .../libnetwork/drivers/remote/api/api.go | 163 + .../libnetwork/drivers/remote/driver.go | 324 + .../libnetwork/drivers/windows/windows.go | 64 + .../docker/libnetwork/drivers_freebsd.go | 13 + .../docker/libnetwork/drivers_linux.go | 19 + .../docker/libnetwork/drivers_windows.go | 9 + .../github.com/docker/libnetwork/endpoint.go | 860 + .../docker/libnetwork/endpoint_cnt.go | 162 + .../docker/libnetwork/endpoint_info.go | 342 + .../src/github.com/docker/libnetwork/error.go | 175 + .../docker/libnetwork/etchosts/etchosts.go | 169 + .../libnetwork/hostdiscovery/hostdiscovery.go | 121 + .../hostdiscovery/hostdiscovery_api.go | 22 + .../libnetwork/hostdiscovery/libnetwork.toml | 6 + .../github.com/docker/libnetwork/idm/idm.go | 60 + .../docker/libnetwork/ipam/allocator.go | 502 + .../docker/libnetwork/ipam/store.go | 131 + .../docker/libnetwork/ipam/structures.go | 359 + .../docker/libnetwork/ipam/utils.go | 81 + .../docker/libnetwork/ipamapi/contract.go | 72 + .../libnetwork/ipams/builtin/builtin.go | 35 + .../docker/libnetwork/ipams/remote/api/api.go | 77 + .../docker/libnetwork/ipams/remote/remote.go | 109 + .../docker/libnetwork/ipamutils/utils.go | 42 + .../libnetwork/ipamutils/utils_linux.go | 74 + .../libnetwork/ipamutils/utils_windows.go | 22 + .../docker/libnetwork/iptables/firewalld.go | 164 + .../docker/libnetwork/iptables/iptables.go | 337 + .../docker/libnetwork/netlabel/labels.go | 106 + .../docker/libnetwork/netutils/utils.go | 172 + .../github.com/docker/libnetwork/network.go | 1147 + .../docker/libnetwork/ns/init_linux.go | 43 + .../docker/libnetwork/options/options.go | 88 + .../libnetwork/osl/interface_freebsd.go | 4 + .../docker/libnetwork/osl/interface_linux.go | 385 + .../libnetwork/osl/interface_windows.go | 4 + .../docker/libnetwork/osl/namespace_linux.go | 323 + .../libnetwork/osl/namespace_unsupported.go | 12 + .../libnetwork/osl/namespace_windows.go | 39 + .../docker/libnetwork/osl/neigh_freebsd.go | 4 + .../docker/libnetwork/osl/neigh_linux.go | 138 + .../docker/libnetwork/osl/neigh_windows.go | 4 + .../docker/libnetwork/osl/options_linux.go | 61 + .../docker/libnetwork/osl/route_linux.go | 197 + .../docker/libnetwork/osl/sandbox.go | 153 + .../docker/libnetwork/osl/sandbox_freebsd.go | 35 + .../libnetwork/osl/sandbox_unsupported.go | 22 + .../libnetwork/portallocator/portallocator.go | 270 + .../docker/libnetwork/portmapper/mapper.go | 228 + .../libnetwork/portmapper/mock_proxy.go | 18 + .../docker/libnetwork/portmapper/proxy.go | 209 + .../docker/libnetwork/resolvconf/README.md | 1 + .../libnetwork/resolvconf/dns/resolvconf.go | 17 + .../libnetwork/resolvconf/resolvconf.go | 237 + .../github.com/docker/libnetwork/sandbox.go | 1019 + .../docker/libnetwork/sandbox_externalkey.go | 185 + .../docker/libnetwork/sandbox_store.go | 233 + .../src/github.com/docker/libnetwork/store.go | 413 + .../docker/libnetwork/types/types.go | 609 + .../github.com/docker/libnetwork/wrapmake.sh | 11 + .../docker/libtrust/CONTRIBUTING.md | 13 + vendor/src/github.com/docker/libtrust/LICENSE | 191 + .../github.com/docker/libtrust/MAINTAINERS | 3 + .../src/github.com/docker/libtrust/README.md | 18 + .../docker/libtrust/certificates.go | 175 + vendor/src/github.com/docker/libtrust/doc.go | 9 + .../src/github.com/docker/libtrust/ec_key.go | 428 + .../src/github.com/docker/libtrust/filter.go | 50 + vendor/src/github.com/docker/libtrust/hash.go | 56 + .../github.com/docker/libtrust/jsonsign.go | 657 + vendor/src/github.com/docker/libtrust/key.go | 253 + .../github.com/docker/libtrust/key_files.go | 255 + .../github.com/docker/libtrust/key_manager.go | 175 + .../src/github.com/docker/libtrust/rsa_key.go | 427 + vendor/src/github.com/docker/libtrust/util.go | 363 + vendor/src/github.com/docker/notary/LICENSE | 201 + .../docker/notary/client/changelist/change.go | 79 + .../notary/client/changelist/changelist.go | 59 + .../client/changelist/file_changelist.go | 176 + .../notary/client/changelist/interface.go | 70 + .../github.com/docker/notary/client/client.go | 659 + .../docker/notary/client/helpers.go | 150 + .../notary/cryptoservice/crypto_service.go | 199 + .../cryptoservice/unlocked_crypto_service.go | 83 + .../notary/keystoremanager/import_export.go | 402 + .../notary/keystoremanager/keystoremanager.go | 426 + .../docker/notary/notarymysql/LICENSE | 21 + .../notary/pkg/passphrase/passphrase.go | 181 + .../docker/notary/trustmanager/filestore.go | 293 + .../notary/trustmanager/keyfilestore.go | 235 + .../docker/notary/trustmanager/keystore.go | 52 + .../notary/trustmanager/x509filestore.go | 270 + .../notary/trustmanager/x509memstore.go | 203 + .../docker/notary/trustmanager/x509store.go | 144 + .../docker/notary/trustmanager/x509utils.go | 497 + .../src/github.com/endophage/gotuf/.gitignore | 3 + .../github.com/endophage/gotuf/.travis.yml | 30 + .../github.com/endophage/gotuf/CONTRIBUTORS | 3 + vendor/src/github.com/endophage/gotuf/LICENSE | 30 + .../github.com/endophage/gotuf/MAINTAINERS | 1 + .../src/github.com/endophage/gotuf/Makefile | 34 + .../src/github.com/endophage/gotuf/README.md | 36 + .../endophage/gotuf/client/client.go | 553 + .../endophage/gotuf/client/errors.go | 130 + .../github.com/endophage/gotuf/data/keys.go | 96 + .../github.com/endophage/gotuf/data/roles.go | 150 + .../github.com/endophage/gotuf/data/root.go | 89 + .../endophage/gotuf/data/snapshot.go | 97 + .../endophage/gotuf/data/targets.go | 116 + .../endophage/gotuf/data/timestamp.go | 75 + .../github.com/endophage/gotuf/data/types.go | 194 + .../endophage/gotuf/errors/errors.go | 85 + .../src/github.com/endophage/gotuf/keys/db.go | 60 + .../endophage/gotuf/signed/ed25519.go | 75 + .../endophage/gotuf/signed/errors.go | 43 + .../endophage/gotuf/signed/interface.go | 44 + .../github.com/endophage/gotuf/signed/sign.go | 43 + .../endophage/gotuf/signed/verifiers.go | 280 + .../endophage/gotuf/signed/verify.go | 172 + .../endophage/gotuf/store/dbstore.go | 252 + .../endophage/gotuf/store/errors.go | 7 + .../endophage/gotuf/store/filestore.go | 67 + .../endophage/gotuf/store/httpstore.go | 243 + .../endophage/gotuf/store/interfaces.go | 35 + .../endophage/gotuf/store/memorystore.go | 97 + vendor/src/github.com/endophage/gotuf/tuf.go | 580 + .../github.com/endophage/gotuf/utils/util.go | 82 + .../github.com/endophage/gotuf/utils/utils.go | 93 + .../fluent/fluent-logger-golang/LICENSE | 13 + .../fluent-logger-golang/fluent/fluent.go | 246 + .../fluent-logger-golang/fluent/proto.go | 24 + .../fluent-logger-golang/fluent/proto_gen.go | 372 + .../fluent-logger-golang/fluent/version.go | 3 + .../src/github.com/go-check/check/.gitignore | 4 + vendor/src/github.com/go-check/check/LICENSE | 25 + .../src/github.com/go-check/check/README.md | 20 + vendor/src/github.com/go-check/check/TODO | 2 + .../github.com/go-check/check/benchmark.go | 163 + vendor/src/github.com/go-check/check/check.go | 945 + .../src/github.com/go-check/check/checkers.go | 458 + .../src/github.com/go-check/check/helpers.go | 231 + .../src/github.com/go-check/check/printer.go | 168 + vendor/src/github.com/go-check/check/run.go | 175 + .../github.com/godbus/dbus/CONTRIBUTING.md | 50 + vendor/src/github.com/godbus/dbus/LICENSE | 25 + vendor/src/github.com/godbus/dbus/MAINTAINERS | 2 + .../github.com/godbus/dbus/README.markdown | 38 + vendor/src/github.com/godbus/dbus/auth.go | 253 + .../github.com/godbus/dbus/auth_external.go | 26 + .../src/github.com/godbus/dbus/auth_sha1.go | 102 + vendor/src/github.com/godbus/dbus/call.go | 147 + vendor/src/github.com/godbus/dbus/conn.go | 609 + .../src/github.com/godbus/dbus/conn_darwin.go | 21 + .../src/github.com/godbus/dbus/conn_other.go | 27 + vendor/src/github.com/godbus/dbus/dbus.go | 258 + vendor/src/github.com/godbus/dbus/decoder.go | 228 + vendor/src/github.com/godbus/dbus/doc.go | 63 + vendor/src/github.com/godbus/dbus/encoder.go | 179 + vendor/src/github.com/godbus/dbus/export.go | 302 + vendor/src/github.com/godbus/dbus/homedir.go | 28 + .../github.com/godbus/dbus/homedir_dynamic.go | 15 + .../github.com/godbus/dbus/homedir_static.go | 45 + vendor/src/github.com/godbus/dbus/message.go | 346 + vendor/src/github.com/godbus/dbus/sig.go | 257 + .../godbus/dbus/transport_darwin.go | 6 + .../godbus/dbus/transport_generic.go | 35 + .../github.com/godbus/dbus/transport_unix.go | 196 + .../dbus/transport_unixcred_dragonfly.go | 95 + .../godbus/dbus/transport_unixcred_linux.go | 25 + vendor/src/github.com/godbus/dbus/variant.go | 139 + .../github.com/godbus/dbus/variant_lexer.go | 284 + .../github.com/godbus/dbus/variant_parser.go | 817 + vendor/src/github.com/golang/protobuf/LICENSE | 31 + .../github.com/golang/protobuf/proto/Makefile | 43 + .../github.com/golang/protobuf/proto/clone.go | 197 + .../golang/protobuf/proto/decode.go | 821 + .../golang/protobuf/proto/encode.go | 1288 + .../github.com/golang/protobuf/proto/equal.go | 256 + .../golang/protobuf/proto/extensions.go | 362 + .../github.com/golang/protobuf/proto/lib.go | 790 + .../golang/protobuf/proto/message_set.go | 287 + .../golang/protobuf/proto/pointer_reflect.go | 479 + .../golang/protobuf/proto/pointer_unsafe.go | 266 + .../golang/protobuf/proto/properties.go | 742 + .../github.com/golang/protobuf/proto/text.go | 789 + .../golang/protobuf/proto/text_parser.go | 757 + .../github.com/gorilla/context/.travis.yml | 7 + vendor/src/github.com/gorilla/context/LICENSE | 27 + .../src/github.com/gorilla/context/README.md | 7 + .../src/github.com/gorilla/context/context.go | 143 + vendor/src/github.com/gorilla/context/doc.go | 82 + vendor/src/github.com/gorilla/mux/.travis.yml | 7 + vendor/src/github.com/gorilla/mux/LICENSE | 27 + vendor/src/github.com/gorilla/mux/README.md | 7 + vendor/src/github.com/gorilla/mux/doc.go | 199 + vendor/src/github.com/gorilla/mux/mux.go | 353 + vendor/src/github.com/gorilla/mux/regexp.go | 276 + vendor/src/github.com/gorilla/mux/route.go | 524 + .../src/github.com/hashicorp/consul/LICENSE | 354 + .../github.com/hashicorp/consul/api/README.md | 39 + .../github.com/hashicorp/consul/api/acl.go | 140 + .../github.com/hashicorp/consul/api/agent.go | 334 + .../github.com/hashicorp/consul/api/api.go | 442 + .../hashicorp/consul/api/catalog.go | 182 + .../github.com/hashicorp/consul/api/event.go | 104 + .../github.com/hashicorp/consul/api/health.go | 136 + .../src/github.com/hashicorp/consul/api/kv.go | 236 + .../github.com/hashicorp/consul/api/lock.go | 326 + .../github.com/hashicorp/consul/api/raw.go | 24 + .../hashicorp/consul/api/semaphore.go | 477 + .../hashicorp/consul/api/session.go | 201 + .../github.com/hashicorp/consul/api/status.go | 43 + .../hashicorp/consul/website/LICENSE.md | 10 + .../github.com/hashicorp/go-msgpack/LICENSE | 25 + .../hashicorp/go-msgpack/codec/0doc.go | 143 + .../hashicorp/go-msgpack/codec/README.md | 174 + .../hashicorp/go-msgpack/codec/binc.go | 786 + .../hashicorp/go-msgpack/codec/decode.go | 1048 + .../hashicorp/go-msgpack/codec/encode.go | 1001 + .../hashicorp/go-msgpack/codec/helper.go | 589 + .../go-msgpack/codec/helper_internal.go | 127 + .../hashicorp/go-msgpack/codec/msgpack.go | 816 + .../go-msgpack/codec/msgpack_test.py | 110 + .../hashicorp/go-msgpack/codec/rpc.go | 152 + .../hashicorp/go-msgpack/codec/simple.go | 461 + .../hashicorp/go-msgpack/codec/time.go | 193 + .../hashicorp/memberlist/.gitignore | 25 + .../github.com/hashicorp/memberlist/LICENSE | 354 + .../github.com/hashicorp/memberlist/Makefile | 14 + .../github.com/hashicorp/memberlist/README.md | 137 + .../hashicorp/memberlist/broadcast.go | 100 + .../github.com/hashicorp/memberlist/config.go | 209 + .../hashicorp/memberlist/conflict_delegate.go | 10 + .../hashicorp/memberlist/delegate.go | 36 + .../hashicorp/memberlist/event_delegate.go | 61 + .../hashicorp/memberlist/keyring.go | 144 + .../hashicorp/memberlist/memberlist.go | 525 + .../hashicorp/memberlist/merge_delegate.go | 13 + .../github.com/hashicorp/memberlist/net.go | 852 + .../github.com/hashicorp/memberlist/queue.go | 167 + .../hashicorp/memberlist/security.go | 198 + .../github.com/hashicorp/memberlist/state.go | 916 + .../github.com/hashicorp/memberlist/todo.md | 6 + .../github.com/hashicorp/memberlist/util.go | 325 + vendor/src/github.com/hashicorp/serf/LICENSE | 354 + .../hashicorp/serf/serf/broadcast.go | 27 + .../hashicorp/serf/serf/coalesce.go | 80 + .../hashicorp/serf/serf/coalesce_member.go | 68 + .../hashicorp/serf/serf/coalesce_user.go | 52 + .../github.com/hashicorp/serf/serf/config.go | 234 + .../hashicorp/serf/serf/conflict_delegate.go | 13 + .../hashicorp/serf/serf/delegate.go | 247 + .../github.com/hashicorp/serf/serf/event.go | 168 + .../hashicorp/serf/serf/event_delegate.go | 21 + .../hashicorp/serf/serf/internal_query.go | 312 + .../hashicorp/serf/serf/keymanager.go | 166 + .../github.com/hashicorp/serf/serf/lamport.go | 45 + .../hashicorp/serf/serf/merge_delegate.go | 35 + .../hashicorp/serf/serf/messages.go | 147 + .../github.com/hashicorp/serf/serf/query.go | 210 + .../github.com/hashicorp/serf/serf/serf.go | 1598 + .../hashicorp/serf/serf/snapshot.go | 500 + .../hashicorp/serf/website/LICENSE.md | 10 + vendor/src/github.com/jfrazelle/go/.gitignore | 39 + vendor/src/github.com/jfrazelle/go/Makefile | 23 + vendor/src/github.com/jfrazelle/go/README.md | 16 + .../jfrazelle/go/canonical/json/bench_test.go | 189 + .../jfrazelle/go/canonical/json/decode.go | 1085 + .../go/canonical/json/decode_test.go | 1373 + .../jfrazelle/go/canonical/json/encode.go | 1234 + .../go/canonical/json/encode_test.go | 605 + .../go/canonical/json/example_test.go | 161 + .../jfrazelle/go/canonical/json/fold.go | 143 + .../jfrazelle/go/canonical/json/fold_test.go | 116 + .../jfrazelle/go/canonical/json/indent.go | 137 + .../jfrazelle/go/canonical/json/scanner.go | 623 + .../go/canonical/json/scanner_test.go | 315 + .../jfrazelle/go/canonical/json/stream.go | 207 + .../go/canonical/json/stream_test.go | 206 + .../go/canonical/json/tagkey_test.go | 115 + .../jfrazelle/go/canonical/json/tags.go | 44 + .../jfrazelle/go/canonical/json/tags_test.go | 28 + .../go/canonical/json/testdata/code.json.gz | Bin 0 -> 120432 bytes vendor/src/github.com/jfrazelle/go/circle.yml | 8 + ...anonical-and-MarshalCanonical-Handle.patch | 509 + ...2-add-test-for-canonical-float-error.patch | 30 + ...-floats-as-integers-in-canonical-mod.patch | 55 + vendor/src/github.com/kr/pty/.gitignore | 4 + vendor/src/github.com/kr/pty/License | 23 + vendor/src/github.com/kr/pty/README.md | 36 + vendor/src/github.com/kr/pty/doc.go | 16 + vendor/src/github.com/kr/pty/ioctl.go | 11 + vendor/src/github.com/kr/pty/ioctl_bsd.go | 39 + vendor/src/github.com/kr/pty/mktypes.bash | 19 + vendor/src/github.com/kr/pty/pty_darwin.go | 60 + vendor/src/github.com/kr/pty/pty_freebsd.go | 73 + vendor/src/github.com/kr/pty/pty_linux.go | 46 + .../src/github.com/kr/pty/pty_unsupported.go | 11 + vendor/src/github.com/kr/pty/run.go | 28 + vendor/src/github.com/kr/pty/types.go | 10 + vendor/src/github.com/kr/pty/types_freebsd.go | 15 + vendor/src/github.com/kr/pty/util.go | 35 + vendor/src/github.com/kr/pty/ztypes_386.go | 9 + vendor/src/github.com/kr/pty/ztypes_amd64.go | 9 + vendor/src/github.com/kr/pty/ztypes_arm.go | 9 + vendor/src/github.com/kr/pty/ztypes_arm64.go | 11 + .../github.com/kr/pty/ztypes_freebsd_386.go | 13 + .../github.com/kr/pty/ztypes_freebsd_amd64.go | 14 + .../github.com/kr/pty/ztypes_freebsd_arm.go | 13 + vendor/src/github.com/kr/pty/ztypes_ppc64.go | 11 + .../src/github.com/kr/pty/ztypes_ppc64le.go | 11 + vendor/src/github.com/kr/pty/ztypes_s390x.go | 11 + .../github.com/mattn/go-sqlite3/.gitignore | 3 + .../github.com/mattn/go-sqlite3/.travis.yml | 9 + .../src/github.com/mattn/go-sqlite3/LICENSE | 21 + .../src/github.com/mattn/go-sqlite3/README.md | 70 + .../src/github.com/mattn/go-sqlite3/backup.go | 70 + .../mattn/go-sqlite3/code/sqlite3-binding.c | 147782 +++++++++++++++ .../mattn/go-sqlite3/code/sqlite3-binding.h | 7478 + .../mattn/go-sqlite3/code/sqlite3ext.h | 487 + vendor/src/github.com/mattn/go-sqlite3/doc.go | 95 + .../src/github.com/mattn/go-sqlite3/error.go | 128 + .../mattn/go-sqlite3/sqlite3-binding.c | 4 + .../mattn/go-sqlite3/sqlite3-binding.h | 5 + .../github.com/mattn/go-sqlite3/sqlite3.go | 660 + .../mattn/go-sqlite3/sqlite3_icu.go | 13 + .../mattn/go-sqlite3/sqlite3_libsqlite3.go | 13 + .../go-sqlite3/sqlite3_load_extension.go | 39 + .../go-sqlite3/sqlite3_omit_load_extension.go | 19 + .../mattn/go-sqlite3/sqlite3_other.go | 13 + .../mattn/go-sqlite3/sqlite3_windows.go | 14 + .../src/github.com/microsoft/hcsshim/LICENSE | 22 + .../microsoft/hcsshim/activatelayer.go | 61 + .../github.com/microsoft/hcsshim/copylayer.go | 89 + .../microsoft/hcsshim/createcomputesystem.go | 59 + .../microsoft/hcsshim/createlayer.go | 69 + .../microsoft/hcsshim/createprocess.go | 157 + .../microsoft/hcsshim/createsandboxlayer.go | 88 + .../microsoft/hcsshim/deactivatelayer.go | 58 + .../microsoft/hcsshim/destroylayer.go | 59 + .../microsoft/hcsshim/exportlayer.go | 88 + .../microsoft/hcsshim/getlayermountpath.go | 91 + .../microsoft/hcsshim/getsharedbaseimages.go | 56 + .../src/github.com/microsoft/hcsshim/guid.go | 19 + .../github.com/microsoft/hcsshim/hcsshim.go | 93 + .../microsoft/hcsshim/importlayer.go | 87 + .../microsoft/hcsshim/layerexists.go | 62 + .../microsoft/hcsshim/layerutils.go | 111 + .../microsoft/hcsshim/nametoguid.go | 49 + .../microsoft/hcsshim/preparelayer.go | 78 + .../microsoft/hcsshim/resizeconsole.go | 48 + .../hcsshim/shutdowncomputesystem.go | 50 + .../microsoft/hcsshim/startcomputesystem.go | 48 + .../hcsshim/terminatecomputesystem.go | 49 + .../microsoft/hcsshim/terminateprocess.go | 49 + .../microsoft/hcsshim/unpreparelayer.go | 59 + .../microsoft/hcsshim/waitprocess.go | 56 + .../github.com/mistifyio/go-zfs/.gitignore | 1 + .../mistifyio/go-zfs/CONTRIBUTING.md | 60 + .../src/github.com/mistifyio/go-zfs/LICENSE | 201 + .../src/github.com/mistifyio/go-zfs/README.md | 54 + .../src/github.com/mistifyio/go-zfs/error.go | 18 + .../src/github.com/mistifyio/go-zfs/utils.go | 320 + vendor/src/github.com/mistifyio/go-zfs/zfs.go | 382 + .../src/github.com/mistifyio/go-zfs/zpool.go | 105 + .../github.com/opencontainers/runc/LICENSE | 191 + .../runc/libcontainer/README.md | 152 + .../opencontainers/runc/libcontainer/SPEC.md | 334 + .../runc/libcontainer/apparmor/apparmor.go | 38 + .../apparmor/apparmor_disabled.go | 11 + .../runc/libcontainer/capabilities_linux.go | 69 + .../runc/libcontainer/cgroups/cgroups.go | 61 + .../cgroups/cgroups_unsupported.go | 3 + .../runc/libcontainer/cgroups/fs/apply_raw.go | 333 + .../runc/libcontainer/cgroups/fs/blkio.go | 238 + .../runc/libcontainer/cgroups/fs/cpu.go | 95 + .../runc/libcontainer/cgroups/fs/cpuacct.go | 117 + .../runc/libcontainer/cgroups/fs/cpuset.go | 135 + .../runc/libcontainer/cgroups/fs/devices.go | 61 + .../runc/libcontainer/cgroups/fs/freezer.go | 62 + .../libcontainer/cgroups/fs/fs_unsupported.go | 3 + .../runc/libcontainer/cgroups/fs/hugetlb.go | 72 + .../runc/libcontainer/cgroups/fs/memory.go | 172 + .../runc/libcontainer/cgroups/fs/name.go | 25 + .../runc/libcontainer/cgroups/fs/net_cls.go | 40 + .../runc/libcontainer/cgroups/fs/net_prio.go | 40 + .../libcontainer/cgroups/fs/perf_event.go | 31 + .../runc/libcontainer/cgroups/fs/utils.go | 74 + .../runc/libcontainer/cgroups/stats.go | 92 + .../cgroups/systemd/apply_nosystemd.go | 51 + .../cgroups/systemd/apply_systemd.go | 616 + .../runc/libcontainer/cgroups/utils.go | 347 + .../runc/libcontainer/compat_1.5_linux.go | 10 + .../runc/libcontainer/configs/blkio_device.go | 61 + .../runc/libcontainer/configs/cgroup.go | 101 + .../runc/libcontainer/configs/config.go | 248 + .../runc/libcontainer/configs/config_unix.go | 51 + .../runc/libcontainer/configs/device.go | 54 + .../libcontainer/configs/device_defaults.go | 139 + .../libcontainer/configs/hugepage_limit.go | 9 + .../configs/interface_priority_map.go | 14 + .../runc/libcontainer/configs/mount.go | 30 + .../runc/libcontainer/configs/namespaces.go | 5 + .../configs/namespaces_syscall.go | 31 + .../configs/namespaces_syscall_unsupported.go | 15 + .../libcontainer/configs/namespaces_unix.go | 89 + .../configs/namespaces_windows.go | 6 + .../runc/libcontainer/configs/network.go | 72 + .../libcontainer/configs/validate/config.go | 93 + .../runc/libcontainer/console.go | 15 + .../runc/libcontainer/console_freebsd.go | 13 + .../runc/libcontainer/console_linux.go | 145 + .../runc/libcontainer/console_windows.go | 30 + .../runc/libcontainer/container.go | 170 + .../runc/libcontainer/container_linux.go | 920 + .../libcontainer/container_nouserns_linux.go | 13 + .../libcontainer/container_userns_linux.go | 26 + .../runc/libcontainer/criu_opts.go | 34 + .../runc/libcontainer/criurpc/Makefile | 2 + .../runc/libcontainer/criurpc/criurpc.pb.go | 689 + .../runc/libcontainer/criurpc/criurpc.proto | 142 + .../runc/libcontainer/devices/devices_unix.go | 102 + .../libcontainer/devices/devices_windows.go | 16 + .../runc/libcontainer/devices/number.go | 24 + .../opencontainers/runc/libcontainer/error.go | 62 + .../runc/libcontainer/factory.go | 45 + .../runc/libcontainer/factory_linux.go | 269 + .../runc/libcontainer/generic_error.go | 74 + .../runc/libcontainer/init_linux.go | 334 + .../runc/libcontainer/label/label.go | 76 + .../runc/libcontainer/label/label_selinux.go | 192 + .../runc/libcontainer/network_linux.go | 259 + .../runc/libcontainer/notify_linux.go | 63 + .../runc/libcontainer/nsenter/README.md | 25 + .../runc/libcontainer/nsenter/nsenter.go | 12 + .../libcontainer/nsenter/nsenter_gccgo.go | 25 + .../nsenter/nsenter_unsupported.go | 5 + .../runc/libcontainer/nsenter/nsexec.c | 206 + .../runc/libcontainer/process.go | 89 + .../runc/libcontainer/process_linux.go | 314 + .../runc/libcontainer/restored_process.go | 122 + .../runc/libcontainer/rootfs_linux.go | 665 + .../runc/libcontainer/seccomp/config.go | 53 + .../libcontainer/seccomp/seccomp_linux.go | 177 + .../seccomp/seccomp_unsupported.go | 19 + .../runc/libcontainer/selinux/selinux.go | 469 + .../runc/libcontainer/setgroups_linux.go | 11 + .../runc/libcontainer/setns_init_linux.go | 44 + .../runc/libcontainer/stacktrace/capture.go | 27 + .../runc/libcontainer/stacktrace/frame.go | 38 + .../libcontainer/stacktrace/stacktrace.go | 5 + .../runc/libcontainer/standard_init_linux.go | 113 + .../opencontainers/runc/libcontainer/stats.go | 15 + .../runc/libcontainer/stats_freebsd.go | 5 + .../runc/libcontainer/stats_linux.go | 8 + .../runc/libcontainer/stats_windows.go | 5 + .../runc/libcontainer/system/linux.go | 77 + .../runc/libcontainer/system/proc.go | 27 + .../runc/libcontainer/system/setns_linux.go | 40 + .../libcontainer/system/syscall_linux_386.go | 25 + .../libcontainer/system/syscall_linux_64.go | 25 + .../libcontainer/system/syscall_linux_arm.go | 25 + .../runc/libcontainer/system/sysconfig.go | 12 + .../libcontainer/system/sysconfig_notcgo.go | 15 + .../runc/libcontainer/system/xattrs_linux.go | 99 + .../runc/libcontainer/user/MAINTAINERS | 2 + .../runc/libcontainer/user/lookup.go | 108 + .../runc/libcontainer/user/lookup_unix.go | 30 + .../libcontainer/user/lookup_unsupported.go | 21 + .../runc/libcontainer/user/user.go | 418 + .../runc/libcontainer/utils/utils.go | 45 + .../runc/libcontainer/utils/utils_unix.go | 33 + vendor/src/github.com/philhofer/fwd/README.md | 311 + vendor/src/github.com/philhofer/fwd/reader.go | 358 + vendor/src/github.com/philhofer/fwd/writer.go | 224 + .../philhofer/fwd/writer_appengine.go | 5 + .../github.com/philhofer/fwd/writer_unsafe.go | 18 + .../github.com/samuel/go-zookeeper/LICENSE | 25 + .../github.com/samuel/go-zookeeper/zk/conn.go | 844 + .../samuel/go-zookeeper/zk/constants.go | 242 + .../github.com/samuel/go-zookeeper/zk/flw.go | 288 + .../github.com/samuel/go-zookeeper/zk/lock.go | 131 + .../samuel/go-zookeeper/zk/server_help.go | 119 + .../samuel/go-zookeeper/zk/server_java.go | 136 + .../samuel/go-zookeeper/zk/structs.go | 633 + .../samuel/go-zookeeper/zk/tracer.go | 148 + .../github.com/samuel/go-zookeeper/zk/util.go | 54 + .../github.com/syndtr/gocapability/LICENSE | 24 + .../gocapability/capability/capability.go | 72 + .../capability/capability_linux.go | 608 + .../capability/capability_noop.go | 19 + .../syndtr/gocapability/capability/enum.go | 264 + .../gocapability/capability/enum_gen.go | 129 + .../gocapability/capability/syscall_linux.go | 143 + .../src/github.com/tchap/go-patricia/LICENSE | 20 + .../tchap/go-patricia/patricia/children.go | 244 + .../tchap/go-patricia/patricia/patricia.go | 467 + vendor/src/github.com/tinylib/msgp/LICENSE | 8 + .../github.com/tinylib/msgp/msgp/circular.go | 38 + .../src/github.com/tinylib/msgp/msgp/defs.go | 142 + .../src/github.com/tinylib/msgp/msgp/edit.go | 241 + .../github.com/tinylib/msgp/msgp/elsize.go | 99 + .../github.com/tinylib/msgp/msgp/errors.go | 142 + .../github.com/tinylib/msgp/msgp/extension.go | 548 + .../github.com/tinylib/msgp/msgp/integers.go | 174 + .../src/github.com/tinylib/msgp/msgp/json.go | 542 + .../tinylib/msgp/msgp/json_bytes.go | 363 + .../github.com/tinylib/msgp/msgp/number.go | 140 + .../tinylib/msgp/msgp/number_appengine.go | 101 + .../tinylib/msgp/msgp/number_unsafe.go | 159 + .../src/github.com/tinylib/msgp/msgp/read.go | 1118 + .../tinylib/msgp/msgp/read_bytes.go | 1073 + .../src/github.com/tinylib/msgp/msgp/size.go | 38 + .../src/github.com/tinylib/msgp/msgp/write.go | 768 + .../tinylib/msgp/msgp/write_bytes.go | 369 + vendor/src/github.com/ugorji/go/LICENSE | 22 + vendor/src/github.com/ugorji/go/codec/0doc.go | 150 + .../src/github.com/ugorji/go/codec/README.md | 148 + vendor/src/github.com/ugorji/go/codec/binc.go | 901 + vendor/src/github.com/ugorji/go/codec/cbor.go | 566 + .../src/github.com/ugorji/go/codec/decode.go | 1552 + .../src/github.com/ugorji/go/codec/encode.go | 1232 + .../ugorji/go/codec/fast-path.generated.go | 28307 +++ .../ugorji/go/codec/fast-path.go.tmpl | 442 + .../ugorji/go/codec/gen-dec-array.go.tmpl | 80 + .../ugorji/go/codec/gen-dec-map.go.tmpl | 46 + .../ugorji/go/codec/gen-helper.generated.go | 102 + .../ugorji/go/codec/gen-helper.go.tmpl | 250 + .../ugorji/go/codec/gen.generated.go | 139 + vendor/src/github.com/ugorji/go/codec/gen.go | 1728 + .../src/github.com/ugorji/go/codec/helper.go | 846 + .../ugorji/go/codec/helper_internal.go | 151 + .../ugorji/go/codec/helper_not_unsafe.go | 20 + .../ugorji/go/codec/helper_unsafe.go | 39 + vendor/src/github.com/ugorji/go/codec/json.go | 924 + .../src/github.com/ugorji/go/codec/msgpack.go | 843 + vendor/src/github.com/ugorji/go/codec/noop.go | 164 + .../github.com/ugorji/go/codec/prebuild.go | 3 + .../github.com/ugorji/go/codec/prebuild.sh | 193 + vendor/src/github.com/ugorji/go/codec/rpc.go | 180 + .../src/github.com/ugorji/go/codec/simple.go | 505 + .../ugorji/go/codec/test-cbor-goldens.json | 639 + vendor/src/github.com/ugorji/go/codec/test.py | 119 + vendor/src/github.com/ugorji/go/codec/time.go | 193 + vendor/src/github.com/vaughan0/go-ini/LICENSE | 14 + .../src/github.com/vaughan0/go-ini/README.md | 70 + vendor/src/github.com/vaughan0/go-ini/ini.go | 123 + .../src/github.com/vaughan0/go-ini/test.ini | 2 + .../src/github.com/vbatts/tar-split/LICENSE | 19 + .../vbatts/tar-split/archive/tar/common.go | 329 + .../vbatts/tar-split/archive/tar/reader.go | 943 + .../vbatts/tar-split/archive/tar/stat_atim.go | 20 + .../tar-split/archive/tar/stat_atimespec.go | 20 + .../vbatts/tar-split/archive/tar/stat_unix.go | 32 + .../vbatts/tar-split/archive/tar/writer.go | 396 + .../vbatts/tar-split/tar/asm/README.md | 44 + .../vbatts/tar-split/tar/asm/assemble.go | 67 + .../vbatts/tar-split/tar/asm/disassemble.go | 141 + .../vbatts/tar-split/tar/asm/doc.go | 9 + .../vbatts/tar-split/tar/storage/doc.go | 12 + .../vbatts/tar-split/tar/storage/entry.go | 78 + .../vbatts/tar-split/tar/storage/getter.go | 104 + .../vbatts/tar-split/tar/storage/packer.go | 145 + .../vishvananda/netlink/.travis.yml | 3 + .../github.com/vishvananda/netlink/LICENSE | 192 + .../github.com/vishvananda/netlink/Makefile | 29 + .../github.com/vishvananda/netlink/README.md | 89 + .../github.com/vishvananda/netlink/addr.go | 43 + .../vishvananda/netlink/addr_linux.go | 128 + .../github.com/vishvananda/netlink/link.go | 201 + .../vishvananda/netlink/link_linux.go | 739 + .../github.com/vishvananda/netlink/neigh.go | 22 + .../vishvananda/netlink/neigh_linux.go | 189 + .../github.com/vishvananda/netlink/netlink.go | 39 + .../netlink/netlink_unspecified.go | 143 + .../vishvananda/netlink/nl/addr_linux.go | 47 + .../vishvananda/netlink/nl/link_linux.go | 104 + .../vishvananda/netlink/nl/nl_linux.go | 418 + .../vishvananda/netlink/nl/route_linux.go | 42 + .../vishvananda/netlink/nl/xfrm_linux.go | 258 + .../netlink/nl/xfrm_policy_linux.go | 119 + .../netlink/nl/xfrm_state_linux.go | 221 + .../vishvananda/netlink/protinfo.go | 53 + .../vishvananda/netlink/protinfo_linux.go | 60 + .../github.com/vishvananda/netlink/route.go | 35 + .../vishvananda/netlink/route_linux.go | 224 + .../github.com/vishvananda/netlink/xfrm.go | 64 + .../vishvananda/netlink/xfrm_policy.go | 59 + .../vishvananda/netlink/xfrm_policy_linux.go | 127 + .../vishvananda/netlink/xfrm_state.go | 53 + .../vishvananda/netlink/xfrm_state_linux.go | 181 + .../src/github.com/vishvananda/netns/LICENSE | 192 + .../github.com/vishvananda/netns/README.md | 49 + .../src/github.com/vishvananda/netns/netns.go | 67 + .../vishvananda/netns/netns_linux.go | 205 + .../vishvananda/netns/netns_linux_386.go | 7 + .../vishvananda/netns/netns_linux_amd64.go | 7 + .../vishvananda/netns/netns_linux_arm.go | 7 + .../vishvananda/netns/netns_linux_arm64.go | 7 + .../vishvananda/netns/netns_linux_ppc64le.go | 7 + .../vishvananda/netns/netns_linux_s390x.go | 7 + .../vishvananda/netns/netns_unspecified.go | 35 + vendor/src/golang.org/x/net/LICENSE | 27 + .../src/golang.org/x/net/context/context.go | 447 + .../src/golang.org/x/net/websocket/client.go | 113 + vendor/src/golang.org/x/net/websocket/hybi.go | 564 + .../src/golang.org/x/net/websocket/server.go | 114 + .../golang.org/x/net/websocket/websocket.go | 412 + vendor/src/gopkg.in/fsnotify.v1/.gitignore | 6 + vendor/src/gopkg.in/fsnotify.v1/.travis.yml | 15 + vendor/src/gopkg.in/fsnotify.v1/AUTHORS | 34 + vendor/src/gopkg.in/fsnotify.v1/CHANGELOG.md | 263 + .../src/gopkg.in/fsnotify.v1/CONTRIBUTING.md | 77 + vendor/src/gopkg.in/fsnotify.v1/LICENSE | 28 + .../gopkg.in/fsnotify.v1/NotUsed.xcworkspace | 0 vendor/src/gopkg.in/fsnotify.v1/README.md | 59 + vendor/src/gopkg.in/fsnotify.v1/circle.yml | 26 + vendor/src/gopkg.in/fsnotify.v1/fsnotify.go | 62 + vendor/src/gopkg.in/fsnotify.v1/inotify.go | 306 + .../gopkg.in/fsnotify.v1/inotify_poller.go | 186 + vendor/src/gopkg.in/fsnotify.v1/kqueue.go | 463 + .../src/gopkg.in/fsnotify.v1/open_mode_bsd.go | 11 + .../gopkg.in/fsnotify.v1/open_mode_darwin.go | 12 + vendor/src/gopkg.in/fsnotify.v1/windows.go | 561 + volume/drivers/adapter.go | 65 + volume/drivers/extpoint.go | 108 + volume/drivers/extpoint_test.go | 23 + volume/drivers/proxy.go | 151 + volume/drivers/proxy_test.go | 96 + volume/local/local.go | 232 + volume/local/local_test.go | 126 + volume/local/local_unix.go | 29 + volume/local/local_windows.go | 18 + volume/store/store.go | 189 + volume/store/store_test.go | 152 + volume/testutils/testutils.go | 68 + volume/volume.go | 61 + 2429 files changed, 574338 insertions(+) create mode 100644 .dockerignore create mode 100644 .gitignore create mode 100644 .mailmap create mode 100644 AUTHORS create mode 100644 CHANGELOG.md create mode 100644 CONTRIBUTING.md create mode 100644 Dockerfile create mode 100644 Dockerfile.centos create mode 100644 Dockerfile.gccgo create mode 100644 Dockerfile.simple create mode 100644 LICENSE create mode 100644 LICENSE-EVAL.txt create mode 100644 MAINTAINERS create mode 100644 Makefile create mode 100644 NOTICE create mode 100644 README.md create mode 100644 ROADMAP.md create mode 100644 VERSION create mode 100644 api/README.md create mode 100644 api/client/attach.go create mode 100644 api/client/build.go create mode 100644 api/client/cli.go create mode 100644 api/client/client.go create mode 100644 api/client/commit.go create mode 100644 api/client/cp.go create mode 100644 api/client/create.go create mode 100644 api/client/diff.go create mode 100644 api/client/events.go create mode 100644 api/client/exec.go create mode 100644 api/client/export.go create mode 100644 api/client/hijack.go create mode 100644 api/client/history.go create mode 100644 api/client/images.go create mode 100644 api/client/import.go create mode 100644 api/client/info.go create mode 100644 api/client/inspect.go create mode 100644 api/client/kill.go create mode 100644 api/client/load.go create mode 100644 api/client/login.go create mode 100644 api/client/logout.go create mode 100644 api/client/logs.go create mode 100644 api/client/network.go create mode 100644 api/client/pause.go create mode 100644 api/client/port.go create mode 100644 api/client/ps.go create mode 100644 api/client/ps/custom.go create mode 100644 api/client/ps/custom_test.go create mode 100644 api/client/ps/formatter.go create mode 100644 api/client/ps/formatter_test.go create mode 100644 api/client/pull.go create mode 100644 api/client/push.go create mode 100644 api/client/rename.go create mode 100644 api/client/restart.go create mode 100644 api/client/rm.go create mode 100644 api/client/rmi.go create mode 100644 api/client/run.go create mode 100644 api/client/save.go create mode 100644 api/client/search.go create mode 100644 api/client/start.go create mode 100644 api/client/stats.go create mode 100644 api/client/stats_unit_test.go create mode 100644 api/client/stop.go create mode 100644 api/client/tag.go create mode 100644 api/client/top.go create mode 100644 api/client/trust.go create mode 100644 api/client/trust_test.go create mode 100644 api/client/unpause.go create mode 100644 api/client/utils.go create mode 100644 api/client/version.go create mode 100644 api/client/volume.go create mode 100644 api/client/wait.go create mode 100644 api/common.go create mode 100644 api/common_test.go create mode 100644 api/fixtures/keyfile create mode 100644 api/server/httputils/form.go create mode 100644 api/server/httputils/form_test.go create mode 100644 api/server/httputils/httputils.go create mode 100644 api/server/middleware.go create mode 100644 api/server/middleware_test.go create mode 100644 api/server/profiler.go create mode 100644 api/server/router/local/auth.go create mode 100644 api/server/router/local/container.go create mode 100644 api/server/router/local/copy.go create mode 100644 api/server/router/local/exec.go create mode 100644 api/server/router/local/image.go create mode 100644 api/server/router/local/info.go create mode 100644 api/server/router/local/inspect.go create mode 100644 api/server/router/local/local.go create mode 100644 api/server/router/local/volume.go create mode 100644 api/server/router/network/network.go create mode 100644 api/server/router/network/network_routes.go create mode 100644 api/server/router/router.go create mode 100644 api/server/server.go create mode 100644 api/server/server_test.go create mode 100644 api/server/server_unix.go create mode 100644 api/server/server_windows.go create mode 100644 api/types/stats.go create mode 100644 api/types/types.go create mode 100644 api/types/versions/README.md create mode 100644 api/types/versions/v1p19/types.go create mode 100644 api/types/versions/v1p20/types.go create mode 100644 builder/builder.go create mode 100644 builder/dockerfile/bflag.go create mode 100644 builder/dockerfile/bflag_test.go create mode 100644 builder/dockerfile/builder.go create mode 100644 builder/dockerfile/command/command.go create mode 100644 builder/dockerfile/dispatchers.go create mode 100644 builder/dockerfile/evaluator.go create mode 100644 builder/dockerfile/internals.go create mode 100644 builder/dockerfile/internals_unix.go create mode 100644 builder/dockerfile/internals_windows.go create mode 100644 builder/dockerfile/parser/dumper/main.go create mode 100644 builder/dockerfile/parser/json_test.go create mode 100644 builder/dockerfile/parser/line_parsers.go create mode 100644 builder/dockerfile/parser/parser.go create mode 100644 builder/dockerfile/parser/parser_test.go create mode 100644 builder/dockerfile/parser/testfiles-negative/env_no_value/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles-negative/shykes-nested-json/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/result create mode 100644 builder/dockerfile/parser/testfiles/brimstone-consuldock/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/brimstone-consuldock/result create mode 100644 builder/dockerfile/parser/testfiles/brimstone-docker-consul/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/brimstone-docker-consul/result create mode 100644 builder/dockerfile/parser/testfiles/continueIndent/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/continueIndent/result create mode 100644 builder/dockerfile/parser/testfiles/cpuguy83-nagios/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/cpuguy83-nagios/result create mode 100644 builder/dockerfile/parser/testfiles/docker/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/docker/result create mode 100644 builder/dockerfile/parser/testfiles/env/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/env/result create mode 100644 builder/dockerfile/parser/testfiles/escapes/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/escapes/result create mode 100644 builder/dockerfile/parser/testfiles/flags/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/flags/result create mode 100644 builder/dockerfile/parser/testfiles/influxdb/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/influxdb/result create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/result create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/result create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/result create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/result create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/result create mode 100644 builder/dockerfile/parser/testfiles/json/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/json/result create mode 100644 builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/result create mode 100644 builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/result create mode 100644 builder/dockerfile/parser/testfiles/mail/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/mail/result create mode 100644 builder/dockerfile/parser/testfiles/multiple-volumes/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/multiple-volumes/result create mode 100644 builder/dockerfile/parser/testfiles/mumble/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/mumble/result create mode 100644 builder/dockerfile/parser/testfiles/nginx/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/nginx/result create mode 100644 builder/dockerfile/parser/testfiles/tf2/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/tf2/result create mode 100644 builder/dockerfile/parser/testfiles/weechat/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/weechat/result create mode 100644 builder/dockerfile/parser/testfiles/znc/Dockerfile create mode 100644 builder/dockerfile/parser/testfiles/znc/result create mode 100644 builder/dockerfile/parser/utils.go create mode 100644 builder/dockerfile/shell_parser.go create mode 100644 builder/dockerfile/shell_parser_test.go create mode 100644 builder/dockerfile/support.go create mode 100644 builder/dockerfile/words create mode 100644 builder/dockerignore.go create mode 100644 builder/git.go create mode 100644 builder/remote.go create mode 100644 builder/remote_test.go create mode 100644 builder/shell_parser.go create mode 100644 builder/shell_parser_test.go create mode 100644 builder/tarsum.go create mode 100644 builder/words create mode 100644 cli/cli.go create mode 100644 cli/client.go create mode 100644 cli/common.go create mode 100644 cliconfig/config.go create mode 100644 cliconfig/config_test.go create mode 100644 contrib/README create mode 100644 contrib/REVIEWERS create mode 100644 contrib/apparmor/docker-engine create mode 100644 contrib/builder/deb/README.md create mode 100755 contrib/builder/deb/build.sh create mode 100644 contrib/builder/deb/debian-jessie/Dockerfile create mode 100644 contrib/builder/deb/debian-stretch/Dockerfile create mode 100644 contrib/builder/deb/debian-wheezy/Dockerfile create mode 100755 contrib/builder/deb/generate.sh create mode 100644 contrib/builder/deb/ubuntu-precise/Dockerfile create mode 100644 contrib/builder/deb/ubuntu-trusty/Dockerfile create mode 100644 contrib/builder/deb/ubuntu-vivid/Dockerfile create mode 100644 contrib/builder/deb/ubuntu-wily/Dockerfile create mode 100644 contrib/builder/rpm/README.md create mode 100755 contrib/builder/rpm/build.sh create mode 100644 contrib/builder/rpm/centos-7/Dockerfile create mode 100644 contrib/builder/rpm/fedora-21/Dockerfile create mode 100644 contrib/builder/rpm/fedora-22/Dockerfile create mode 100644 contrib/builder/rpm/fedora-23/Dockerfile create mode 100755 contrib/builder/rpm/generate.sh create mode 100644 contrib/builder/rpm/opensuse-13.2/Dockerfile create mode 100644 contrib/builder/rpm/oraclelinux-6/Dockerfile create mode 100644 contrib/builder/rpm/oraclelinux-7/Dockerfile create mode 100755 contrib/check-config.sh create mode 100644 contrib/completion/REVIEWERS create mode 100644 contrib/completion/bash/docker create mode 100644 contrib/completion/fish/docker.fish create mode 100644 contrib/completion/zsh/REVIEWERS create mode 100644 contrib/completion/zsh/_docker create mode 100644 contrib/desktop-integration/README.md create mode 100644 contrib/desktop-integration/chromium/Dockerfile create mode 100644 contrib/desktop-integration/gparted/Dockerfile create mode 100644 contrib/docker-device-tool/device_tool.go create mode 100644 contrib/docker-engine-selinux/LICENSE create mode 100644 contrib/docker-engine-selinux/Makefile create mode 100644 contrib/docker-engine-selinux/docker.fc create mode 100644 contrib/docker-engine-selinux/docker.if create mode 100644 contrib/docker-engine-selinux/docker.te create mode 100644 contrib/docker-engine-selinux/docker_selinux.8.gz create mode 100755 contrib/dockerize-disk.sh create mode 100755 contrib/download-frozen-image.sh create mode 100644 contrib/host-integration/Dockerfile.dev create mode 100644 contrib/host-integration/Dockerfile.min create mode 100644 contrib/host-integration/manager.go create mode 100755 contrib/host-integration/manager.sh create mode 100755 contrib/host-integration/manager/systemd create mode 100755 contrib/host-integration/manager/upstart create mode 100644 contrib/httpserver/Dockerfile create mode 100644 contrib/httpserver/server.go create mode 100644 contrib/init/openrc/docker.confd create mode 100644 contrib/init/openrc/docker.initd create mode 100644 contrib/init/systemd/REVIEWERS create mode 100644 contrib/init/systemd/docker.service create mode 100644 contrib/init/systemd/docker.socket create mode 100755 contrib/init/sysvinit-debian/docker create mode 100644 contrib/init/sysvinit-debian/docker.default create mode 100755 contrib/init/sysvinit-redhat/docker create mode 100644 contrib/init/sysvinit-redhat/docker.sysconfig create mode 100644 contrib/init/upstart/REVIEWERS create mode 100644 contrib/init/upstart/docker.conf create mode 100755 contrib/mkimage-alpine.sh create mode 100644 contrib/mkimage-arch-pacman.conf create mode 100755 contrib/mkimage-arch.sh create mode 100755 contrib/mkimage-busybox.sh create mode 100755 contrib/mkimage-crux.sh create mode 100755 contrib/mkimage-debootstrap.sh create mode 100755 contrib/mkimage-rinse.sh create mode 100755 contrib/mkimage-yum.sh create mode 100755 contrib/mkimage.sh create mode 100755 contrib/mkimage/.febootstrap-minimize create mode 100755 contrib/mkimage/busybox-static create mode 100755 contrib/mkimage/debootstrap create mode 100755 contrib/mkimage/mageia-urpmi create mode 100755 contrib/mkimage/rinse create mode 100755 contrib/mkseccomp.pl create mode 100644 contrib/mkseccomp.sample create mode 100755 contrib/nuke-graph-directory.sh create mode 100755 contrib/project-stats.sh create mode 100644 contrib/report-issue.sh create mode 100755 contrib/reprepro/suites.sh create mode 100644 contrib/syntax/kate/Dockerfile.xml create mode 100644 contrib/syntax/nano/Dockerfile.nanorc create mode 100644 contrib/syntax/nano/README.md create mode 100644 contrib/syntax/textmate/Docker.tmbundle/Preferences/Dockerfile.tmPreferences create mode 100644 contrib/syntax/textmate/Docker.tmbundle/Syntaxes/Dockerfile.tmLanguage create mode 100644 contrib/syntax/textmate/Docker.tmbundle/info.plist create mode 100644 contrib/syntax/textmate/README.md create mode 100644 contrib/syntax/textmate/REVIEWERS create mode 100644 contrib/syntax/vim/LICENSE create mode 100644 contrib/syntax/vim/README.md create mode 100644 contrib/syntax/vim/doc/dockerfile.txt create mode 100644 contrib/syntax/vim/ftdetect/dockerfile.vim create mode 100644 contrib/syntax/vim/syntax/dockerfile.vim create mode 100644 contrib/udev/80-docker.rules create mode 100644 contrib/vagrant-docker/README.md create mode 100644 daemon/README.md create mode 100644 daemon/archive.go create mode 100644 daemon/archive_unix.go create mode 100644 daemon/archive_windows.go create mode 100644 daemon/attach.go create mode 100644 daemon/changes.go create mode 100644 daemon/commit.go create mode 100644 daemon/config.go create mode 100644 daemon/config_experimental.go create mode 100644 daemon/config_stub.go create mode 100644 daemon/config_unix.go create mode 100644 daemon/config_windows.go create mode 100644 daemon/container.go create mode 100644 daemon/container_unit_test.go create mode 100644 daemon/container_unix.go create mode 100644 daemon/container_windows.go create mode 100644 daemon/create.go create mode 100644 daemon/create_unix.go create mode 100644 daemon/create_windows.go create mode 100644 daemon/daemon.go create mode 100644 daemon/daemon_aufs.go create mode 100644 daemon/daemon_btrfs.go create mode 100644 daemon/daemon_devicemapper.go create mode 100644 daemon/daemon_experimental.go create mode 100644 daemon/daemon_linux.go create mode 100644 daemon/daemon_linux_test.go create mode 100644 daemon/daemon_no_aufs.go create mode 100644 daemon/daemon_overlay.go create mode 100644 daemon/daemon_stub.go create mode 100644 daemon/daemon_test.go create mode 100644 daemon/daemon_unix.go create mode 100644 daemon/daemon_unix_test.go create mode 100644 daemon/daemon_unsupported.go create mode 100644 daemon/daemon_windows.go create mode 100644 daemon/daemon_zfs.go create mode 100644 daemon/daemonbuilder/builder.go create mode 100644 daemon/daemonbuilder/builder_unix.go create mode 100644 daemon/daemonbuilder/builder_windows.go create mode 100644 daemon/debugtrap_unix.go create mode 100644 daemon/debugtrap_unsupported.go create mode 100644 daemon/debugtrap_windows.go create mode 100644 daemon/delete.go create mode 100644 daemon/delete_test.go create mode 100644 daemon/discovery.go create mode 100644 daemon/events/events.go create mode 100644 daemon/events/events_test.go create mode 100644 daemon/events/filter.go create mode 100644 daemon/exec.go create mode 100644 daemon/exec_freebsd.go create mode 100644 daemon/exec_linux.go create mode 100644 daemon/exec_windows.go create mode 100644 daemon/execdriver/driver.go create mode 100644 daemon/execdriver/driver_unix.go create mode 100644 daemon/execdriver/driver_windows.go create mode 100644 daemon/execdriver/execdrivers/execdrivers_freebsd.go create mode 100644 daemon/execdriver/execdrivers/execdrivers_linux.go create mode 100644 daemon/execdriver/execdrivers/execdrivers_windows.go create mode 100644 daemon/execdriver/lxc/driver.go create mode 100644 daemon/execdriver/lxc/info.go create mode 100644 daemon/execdriver/lxc/info_test.go create mode 100644 daemon/execdriver/lxc/init.go create mode 100644 daemon/execdriver/lxc/lxc_init_linux.go create mode 100644 daemon/execdriver/lxc/lxc_init_unsupported.go create mode 100644 daemon/execdriver/lxc/lxc_template.go create mode 100644 daemon/execdriver/lxc/lxc_template_unit_test.go create mode 100644 daemon/execdriver/native/apparmor.go create mode 100644 daemon/execdriver/native/create.go create mode 100644 daemon/execdriver/native/driver.go create mode 100644 daemon/execdriver/native/driver_unsupported.go create mode 100644 daemon/execdriver/native/driver_unsupported_nocgo.go create mode 100644 daemon/execdriver/native/exec.go create mode 100644 daemon/execdriver/native/info.go create mode 100644 daemon/execdriver/native/init.go create mode 100644 daemon/execdriver/native/template/default_template.go create mode 100644 daemon/execdriver/pipes.go create mode 100644 daemon/execdriver/termconsole.go create mode 100644 daemon/execdriver/utils.go create mode 100644 daemon/execdriver/windows/checkoptions.go create mode 100644 daemon/execdriver/windows/clean.go create mode 100644 daemon/execdriver/windows/exec.go create mode 100644 daemon/execdriver/windows/getpids.go create mode 100644 daemon/execdriver/windows/info.go create mode 100644 daemon/execdriver/windows/namedpipes.go create mode 100644 daemon/execdriver/windows/pauseunpause.go create mode 100644 daemon/execdriver/windows/run.go create mode 100644 daemon/execdriver/windows/stats.go create mode 100644 daemon/execdriver/windows/stdconsole.go create mode 100644 daemon/execdriver/windows/terminatekill.go create mode 100644 daemon/execdriver/windows/ttyconsole.go create mode 100644 daemon/execdriver/windows/unsupported.go create mode 100644 daemon/execdriver/windows/windows.go create mode 100644 daemon/export.go create mode 100644 daemon/graphdriver/aufs/aufs.go create mode 100644 daemon/graphdriver/aufs/aufs_test.go create mode 100644 daemon/graphdriver/aufs/dirs.go create mode 100644 daemon/graphdriver/aufs/migrate.go create mode 100644 daemon/graphdriver/aufs/mount.go create mode 100644 daemon/graphdriver/aufs/mount_linux.go create mode 100644 daemon/graphdriver/aufs/mount_unsupported.go create mode 100644 daemon/graphdriver/btrfs/btrfs.go create mode 100644 daemon/graphdriver/btrfs/btrfs_test.go create mode 100644 daemon/graphdriver/btrfs/dummy_unsupported.go create mode 100644 daemon/graphdriver/btrfs/version.go create mode 100644 daemon/graphdriver/btrfs/version_none.go create mode 100644 daemon/graphdriver/btrfs/version_test.go create mode 100644 daemon/graphdriver/devmapper/README.md create mode 100644 daemon/graphdriver/devmapper/deviceset.go create mode 100644 daemon/graphdriver/devmapper/devmapper_doc.go create mode 100644 daemon/graphdriver/devmapper/devmapper_test.go create mode 100644 daemon/graphdriver/devmapper/driver.go create mode 100644 daemon/graphdriver/devmapper/mount.go create mode 100644 daemon/graphdriver/driver.go create mode 100644 daemon/graphdriver/driver_freebsd.go create mode 100644 daemon/graphdriver/driver_linux.go create mode 100644 daemon/graphdriver/driver_unsupported.go create mode 100644 daemon/graphdriver/driver_windows.go create mode 100644 daemon/graphdriver/fsdiff.go create mode 100644 daemon/graphdriver/graphtest/graphtest.go create mode 100644 daemon/graphdriver/imagerestorer.go create mode 100644 daemon/graphdriver/overlay/copy.go create mode 100644 daemon/graphdriver/overlay/overlay.go create mode 100644 daemon/graphdriver/overlay/overlay_test.go create mode 100644 daemon/graphdriver/overlay/overlay_unsupported.go create mode 100644 daemon/graphdriver/plugin.go create mode 100644 daemon/graphdriver/plugin_unsupported.go create mode 100644 daemon/graphdriver/proxy.go create mode 100644 daemon/graphdriver/vfs/driver.go create mode 100644 daemon/graphdriver/vfs/driver_unsupported.go create mode 100644 daemon/graphdriver/vfs/vfs_test.go create mode 100644 daemon/graphdriver/windows/windows.go create mode 100644 daemon/graphdriver/zfs/MAINTAINERS create mode 100644 daemon/graphdriver/zfs/zfs.go create mode 100644 daemon/graphdriver/zfs/zfs_freebsd.go create mode 100644 daemon/graphdriver/zfs/zfs_linux.go create mode 100644 daemon/graphdriver/zfs/zfs_test.go create mode 100644 daemon/graphdriver/zfs/zfs_unsupported.go create mode 100644 daemon/history.go create mode 100644 daemon/image_delete.go create mode 100644 daemon/info.go create mode 100644 daemon/inspect.go create mode 100644 daemon/inspect_unix.go create mode 100644 daemon/inspect_windows.go create mode 100644 daemon/kill.go create mode 100644 daemon/links/links.go create mode 100644 daemon/links/links_test.go create mode 100644 daemon/list.go create mode 100644 daemon/logdrivers_linux.go create mode 100644 daemon/logdrivers_windows.go create mode 100644 daemon/logger/awslogs/cloudwatchlogs.go create mode 100644 daemon/logger/awslogs/cloudwatchlogs_test.go create mode 100644 daemon/logger/awslogs/cwlogsiface_mock_test.go create mode 100644 daemon/logger/context.go create mode 100644 daemon/logger/copier.go create mode 100644 daemon/logger/copier_test.go create mode 100644 daemon/logger/factory.go create mode 100644 daemon/logger/fluentd/fluentd.go create mode 100644 daemon/logger/gelf/gelf.go create mode 100644 daemon/logger/gelf/gelf_unsupported.go create mode 100644 daemon/logger/journald/journald.go create mode 100644 daemon/logger/journald/journald_unsupported.go create mode 100644 daemon/logger/journald/read.go create mode 100644 daemon/logger/journald/read_unsupported.go create mode 100644 daemon/logger/jsonfilelog/jsonfilelog.go create mode 100644 daemon/logger/jsonfilelog/jsonfilelog_test.go create mode 100644 daemon/logger/logger.go create mode 100644 daemon/logger/loggerutils/log_tag.go create mode 100644 daemon/logger/loggerutils/log_tag_test.go create mode 100644 daemon/logger/syslog/syslog.go create mode 100644 daemon/logger/syslog/syslog_unsupported.go create mode 100644 daemon/logs.go create mode 100644 daemon/monitor.go create mode 100644 daemon/network.go create mode 100644 daemon/network/settings.go create mode 100644 daemon/pause.go create mode 100644 daemon/rename.go create mode 100644 daemon/resize.go create mode 100644 daemon/restart.go create mode 100644 daemon/start.go create mode 100644 daemon/state.go create mode 100644 daemon/state_test.go create mode 100644 daemon/stats.go create mode 100644 daemon/stats_collector_unix.go create mode 100644 daemon/stats_collector_windows.go create mode 100644 daemon/stats_freebsd.go create mode 100644 daemon/stats_linux.go create mode 100644 daemon/stats_windows.go create mode 100644 daemon/stop.go create mode 100644 daemon/top_unix.go create mode 100644 daemon/top_windows.go create mode 100644 daemon/unpause.go create mode 100644 daemon/utils_freebsd.go create mode 100644 daemon/utils_linux.go create mode 100644 daemon/utils_nounix.go create mode 100644 daemon/utils_test.go create mode 100644 daemon/volumes.go create mode 100644 daemon/volumes_linux_unit_test.go create mode 100644 daemon/volumes_unit_test.go create mode 100644 daemon/volumes_unix.go create mode 100644 daemon/volumes_windows.go create mode 100644 daemon/wait.go create mode 100644 docker/README.md create mode 100644 docker/client.go create mode 100644 docker/common.go create mode 100644 docker/daemon.go create mode 100644 docker/daemon_freebsd.go create mode 100644 docker/daemon_linux.go create mode 100644 docker/daemon_none.go create mode 100644 docker/daemon_unix.go create mode 100644 docker/daemon_windows.go create mode 100644 docker/docker.go create mode 100644 docker/docker_windows.go create mode 100644 docker/flags.go create mode 100644 docker/flags_test.go create mode 100644 dockerinit/dockerinit.go create mode 100644 docs-cs/Dockerfile create mode 100644 docs-cs/Makefile create mode 100644 docs-cs/index.md create mode 100644 docs-cs/install.md create mode 100644 docs-cs/release-notes/index.md create mode 100644 docs-cs/release-notes/prior-release-notes.md create mode 100644 docs-cs/release-notes/release-notes.md create mode 100644 docs-cs/upgrade.md create mode 100644 docs/.gitignore create mode 100644 docs/Dockerfile create mode 100644 docs/Makefile create mode 100644 docs/README.md create mode 100644 docs/article-img/architecture.svg create mode 100644 docs/articles/ambassador_pattern_linking.md create mode 100644 docs/articles/b2d_volume_images/add_cd.png create mode 100644 docs/articles/b2d_volume_images/add_new_controller.png create mode 100644 docs/articles/b2d_volume_images/add_volume.png create mode 100644 docs/articles/b2d_volume_images/boot_order.png create mode 100644 docs/articles/b2d_volume_images/gparted.png create mode 100644 docs/articles/b2d_volume_images/gparted2.png create mode 100644 docs/articles/b2d_volume_images/verify.png create mode 100644 docs/articles/b2d_volume_resize.md create mode 100644 docs/articles/baseimages.md create mode 100644 docs/articles/certificates.md create mode 100644 docs/articles/cfengine_process_management.md create mode 100644 docs/articles/chef.md create mode 100644 docs/articles/configuring.md create mode 100644 docs/articles/dockerfile_best-practices.md create mode 100644 docs/articles/dsc.md create mode 100644 docs/articles/host_integration.md create mode 100644 docs/articles/https.md create mode 100644 docs/articles/https/Dockerfile create mode 100644 docs/articles/https/Makefile create mode 100644 docs/articles/https/README.md create mode 100755 docs/articles/https/make_certs.sh create mode 100755 docs/articles/https/parsedocs.sh create mode 100644 docs/articles/puppet.md create mode 100644 docs/articles/registry_mirror.md create mode 100644 docs/articles/runmetrics.md create mode 100644 docs/articles/security.md create mode 100644 docs/articles/systemd.md create mode 100644 docs/articles/using_supervisord.md create mode 100644 docs/examples/apt-cacher-ng.Dockerfile create mode 100644 docs/examples/apt-cacher-ng.md create mode 100644 docs/examples/couchdb_data_volumes.md create mode 100644 docs/examples/index.md create mode 100644 docs/examples/mongodb.md create mode 100644 docs/examples/mongodb/Dockerfile create mode 100644 docs/examples/nodejs_web_app.md create mode 100644 docs/examples/postgresql_service.Dockerfile create mode 100644 docs/examples/postgresql_service.md create mode 100644 docs/examples/running_redis_service.md create mode 100644 docs/examples/running_riak_service.Dockerfile create mode 100644 docs/examples/running_riak_service.md create mode 100644 docs/examples/running_ssh_service.Dockerfile create mode 100644 docs/examples/running_ssh_service.md create mode 100644 docs/examples/supervisord.conf create mode 100644 docs/extend/index.md create mode 100644 docs/extend/plugin_api.md create mode 100644 docs/extend/plugins.md create mode 100644 docs/extend/plugins_network.md create mode 100644 docs/extend/plugins_volume.md create mode 100644 docs/installation/SUSE.md create mode 100644 docs/installation/amazon.md create mode 100644 docs/installation/archlinux.md create mode 100644 docs/installation/azure.md create mode 100644 docs/installation/binaries.md create mode 100644 docs/installation/centos.md create mode 100644 docs/installation/cruxlinux.md create mode 100644 docs/installation/debian.md create mode 100644 docs/installation/fedora.md create mode 100644 docs/installation/frugalware.md create mode 100644 docs/installation/gentoolinux.md create mode 100644 docs/installation/google.md create mode 100644 docs/installation/images/bad_host.png create mode 100644 docs/installation/images/cool_view.png create mode 100644 docs/installation/images/good_host.png create mode 100644 docs/installation/images/kitematic.png create mode 100644 docs/installation/images/linux_docker_host.svg create mode 100644 docs/installation/images/mac-page-finished.png create mode 100644 docs/installation/images/mac-page-two.png create mode 100644 docs/installation/images/mac-password-prompt.png create mode 100644 docs/installation/images/mac-success.png create mode 100644 docs/installation/images/mac-welcome-page.png create mode 100644 docs/installation/images/mac_docker_host.svg create mode 100644 docs/installation/images/my-docker-vm.png create mode 100644 docs/installation/images/newsite_view.png create mode 100644 docs/installation/images/virtualization.png create mode 100644 docs/installation/images/win-page-6.png create mode 100644 docs/installation/images/win-welcome.png create mode 100644 docs/installation/images/win_docker_host.svg create mode 100644 docs/installation/images/win_ver.png create mode 100644 docs/installation/images/windows-boot2docker-cmd.png create mode 100644 docs/installation/images/windows-boot2docker-powershell.png create mode 100644 docs/installation/images/windows-boot2docker-start.png create mode 100644 docs/installation/images/windows-finish.png create mode 100644 docs/installation/index.md create mode 100644 docs/installation/joyent.md create mode 100644 docs/installation/mac.md create mode 100644 docs/installation/oracle.md create mode 100644 docs/installation/rackspace.md create mode 100644 docs/installation/rhel.md create mode 100644 docs/installation/softlayer.md create mode 100644 docs/installation/ubuntulinux.md create mode 100644 docs/installation/windows.md create mode 100644 docs/introduction/understanding-docker.md create mode 100644 docs/misc/deprecated.md create mode 100644 docs/misc/faq.md create mode 100644 docs/misc/index.md create mode 100644 docs/misc/release-notes.md create mode 100644 docs/misc/search.md create mode 100644 docs/reference/api/README.md create mode 100644 docs/reference/api/_static/io_oauth_authorization_page.png create mode 100644 docs/reference/api/docker-io_api.md create mode 100644 docs/reference/api/docker_io_accounts_api.md create mode 100644 docs/reference/api/docker_remote_api.md create mode 100644 docs/reference/api/docker_remote_api_v1.0.md create mode 100644 docs/reference/api/docker_remote_api_v1.1.md create mode 100644 docs/reference/api/docker_remote_api_v1.10.md create mode 100644 docs/reference/api/docker_remote_api_v1.11.md create mode 100644 docs/reference/api/docker_remote_api_v1.12.md create mode 100644 docs/reference/api/docker_remote_api_v1.13.md create mode 100644 docs/reference/api/docker_remote_api_v1.14.md create mode 100644 docs/reference/api/docker_remote_api_v1.15.md create mode 100644 docs/reference/api/docker_remote_api_v1.16.md create mode 100644 docs/reference/api/docker_remote_api_v1.17.md create mode 100644 docs/reference/api/docker_remote_api_v1.18.md create mode 100644 docs/reference/api/docker_remote_api_v1.19.md create mode 100644 docs/reference/api/docker_remote_api_v1.2.md create mode 100644 docs/reference/api/docker_remote_api_v1.20.md create mode 100644 docs/reference/api/docker_remote_api_v1.21.md create mode 100644 docs/reference/api/docker_remote_api_v1.3.md create mode 100644 docs/reference/api/docker_remote_api_v1.4.md create mode 100644 docs/reference/api/docker_remote_api_v1.5.md create mode 100644 docs/reference/api/docker_remote_api_v1.6.md create mode 100644 docs/reference/api/docker_remote_api_v1.7.md create mode 100644 docs/reference/api/docker_remote_api_v1.8.md create mode 100644 docs/reference/api/docker_remote_api_v1.9.md create mode 100644 docs/reference/api/hub_registry_spec.md create mode 100644 docs/reference/api/images/event_state.gliffy create mode 100644 docs/reference/api/images/event_state.png create mode 100644 docs/reference/api/registry_api.md create mode 100644 docs/reference/api/registry_api_client_libraries.md create mode 100644 docs/reference/api/remote_api_client_libraries.md create mode 100644 docs/reference/builder.md create mode 100644 docs/reference/commandline/attach.md create mode 100644 docs/reference/commandline/build.md create mode 100644 docs/reference/commandline/cli.md create mode 100644 docs/reference/commandline/commit.md create mode 100644 docs/reference/commandline/cp.md create mode 100644 docs/reference/commandline/create.md create mode 100644 docs/reference/commandline/daemon.md create mode 100644 docs/reference/commandline/diff.md create mode 100644 docs/reference/commandline/docker_images.gif create mode 100644 docs/reference/commandline/events.md create mode 100644 docs/reference/commandline/exec.md create mode 100644 docs/reference/commandline/export.md create mode 100644 docs/reference/commandline/history.md create mode 100644 docs/reference/commandline/images.md create mode 100644 docs/reference/commandline/import.md create mode 100644 docs/reference/commandline/index.md create mode 100644 docs/reference/commandline/info.md create mode 100644 docs/reference/commandline/inspect.md create mode 100644 docs/reference/commandline/kill.md create mode 100644 docs/reference/commandline/load.md create mode 100644 docs/reference/commandline/login.md create mode 100644 docs/reference/commandline/logout.md create mode 100644 docs/reference/commandline/logs.md create mode 100644 docs/reference/commandline/network_connect.md create mode 100644 docs/reference/commandline/network_create.md create mode 100644 docs/reference/commandline/network_disconnect.md create mode 100644 docs/reference/commandline/network_inspect.md create mode 100644 docs/reference/commandline/network_ls.md create mode 100644 docs/reference/commandline/network_rm.md create mode 100644 docs/reference/commandline/pause.md create mode 100644 docs/reference/commandline/port.md create mode 100644 docs/reference/commandline/ps.md create mode 100644 docs/reference/commandline/pull.md create mode 100644 docs/reference/commandline/push.md create mode 100644 docs/reference/commandline/rename.md create mode 100644 docs/reference/commandline/restart.md create mode 100644 docs/reference/commandline/rm.md create mode 100644 docs/reference/commandline/rmi.md create mode 100644 docs/reference/commandline/run.md create mode 100644 docs/reference/commandline/save.md create mode 100644 docs/reference/commandline/search.md create mode 100644 docs/reference/commandline/start.md create mode 100644 docs/reference/commandline/stats.md create mode 100644 docs/reference/commandline/stop.md create mode 100644 docs/reference/commandline/tag.md create mode 100644 docs/reference/commandline/top.md create mode 100644 docs/reference/commandline/unpause.md create mode 100644 docs/reference/commandline/version.md create mode 100644 docs/reference/commandline/volume_create.md create mode 100644 docs/reference/commandline/volume_inspect.md create mode 100644 docs/reference/commandline/volume_ls.md create mode 100644 docs/reference/commandline/volume_rm.md create mode 100644 docs/reference/commandline/wait.md create mode 100644 docs/reference/glossary.md create mode 100644 docs/reference/logging/awslogs.md create mode 100644 docs/reference/logging/fluentd.md create mode 100644 docs/reference/logging/index.md create mode 100644 docs/reference/logging/journald.md create mode 100644 docs/reference/logging/log_tags.md create mode 100644 docs/reference/logging/overview.md create mode 100644 docs/reference/run.md create mode 100644 docs/security/apparmor.md create mode 100644 docs/security/trust/content_trust.md create mode 100644 docs/security/trust/images/tag_signing.png create mode 100644 docs/security/trust/images/trust_.gliffy create mode 100644 docs/security/trust/images/trust_components.gliffy create mode 100644 docs/security/trust/images/trust_components.png create mode 100644 docs/security/trust/images/trust_signing.gliffy create mode 100644 docs/security/trust/images/trust_signing.png create mode 100644 docs/security/trust/images/trust_view.gliffy create mode 100644 docs/security/trust/images/trust_view.png create mode 100644 docs/security/trust/index.md create mode 100644 docs/security/trust/trust_automation.md create mode 100644 docs/security/trust/trust_key_mng.md create mode 100644 docs/security/trust/trust_sandbox.md create mode 100644 docs/sources/installation/images/windows-boot2docker-cmd.png create mode 100644 docs/sources/installation/images/windows-boot2docker-powershell.png create mode 100644 docs/static_files/README.md create mode 100644 docs/static_files/contributors.png create mode 100644 docs/static_files/docker-logo-compressed.png create mode 100644 docs/static_files/docker_pull_chart.png create mode 100644 docs/static_files/docker_push_chart.png create mode 100644 docs/static_files/dockerlogo-v.png create mode 100755 docs/touch-up.sh create mode 100644 docs/userguide/basics.md create mode 100644 docs/userguide/dockerimages.md create mode 100644 docs/userguide/dockerizing.md create mode 100644 docs/userguide/dockerrepos.md create mode 100644 docs/userguide/dockervolumes.md create mode 100644 docs/userguide/image_management.md create mode 100644 docs/userguide/index.md create mode 100644 docs/userguide/labels-custom-metadata.md create mode 100644 docs/userguide/networking/default_network/binding.md create mode 100644 docs/userguide/networking/default_network/build-bridges.md create mode 100644 docs/userguide/networking/default_network/configure-dns.md create mode 100644 docs/userguide/networking/default_network/container-basics.md create mode 100644 docs/userguide/networking/default_network/container-communication.md create mode 100644 docs/userguide/networking/default_network/custom-docker0.md create mode 100644 docs/userguide/networking/default_network/dockerlinks.md create mode 100644 docs/userguide/networking/default_network/images/ipv6_basic_host_config.gliffy create mode 100644 docs/userguide/networking/default_network/images/ipv6_basic_host_config.svg create mode 100644 docs/userguide/networking/default_network/images/ipv6_ndp_proxying.gliffy create mode 100644 docs/userguide/networking/default_network/images/ipv6_ndp_proxying.svg create mode 100644 docs/userguide/networking/default_network/images/ipv6_routed_network_example.gliffy create mode 100644 docs/userguide/networking/default_network/images/ipv6_routed_network_example.svg create mode 100644 docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.gliffy create mode 100644 docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.svg create mode 100644 docs/userguide/networking/default_network/images/ipv6_switched_network_example.gliffy create mode 100644 docs/userguide/networking/default_network/images/ipv6_switched_network_example.svg create mode 100644 docs/userguide/networking/default_network/index.md create mode 100644 docs/userguide/networking/default_network/ipv6.md create mode 100644 docs/userguide/networking/default_network/options.md create mode 100644 docs/userguide/networking/default_network/saveme.md create mode 100644 docs/userguide/networking/default_network/tools.md create mode 100644 docs/userguide/networking/dockernetworks.md create mode 100644 docs/userguide/networking/get-started-overlay.md create mode 100644 docs/userguide/networking/images/bridge_network.gliffy create mode 100644 docs/userguide/networking/images/bridge_network.png create mode 100644 docs/userguide/networking/images/bridge_network.svg create mode 100644 docs/userguide/networking/images/engine_on_net.gliffy create mode 100644 docs/userguide/networking/images/engine_on_net.png create mode 100644 docs/userguide/networking/images/engine_on_net.svg create mode 100644 docs/userguide/networking/images/key_value.gliffy create mode 100644 docs/userguide/networking/images/key_value.png create mode 100644 docs/userguide/networking/images/key_value.svg create mode 100644 docs/userguide/networking/images/network_access.gliffy create mode 100644 docs/userguide/networking/images/network_access.png create mode 100644 docs/userguide/networking/images/network_access.svg create mode 100644 docs/userguide/networking/images/overlay-network-final.gliffy create mode 100644 docs/userguide/networking/images/overlay-network-final.png create mode 100644 docs/userguide/networking/images/overlay-network-final.svg create mode 100644 docs/userguide/networking/images/overlay_network.gliffy create mode 100644 docs/userguide/networking/images/overlay_network.png create mode 100644 docs/userguide/networking/images/overlay_network.svg create mode 100644 docs/userguide/networking/images/working.gliffy create mode 100644 docs/userguide/networking/images/working.png create mode 100644 docs/userguide/networking/images/working.svg create mode 100644 docs/userguide/networking/index.md create mode 100644 docs/userguide/networking/work-with-networks.md create mode 100644 docs/userguide/networkingcontainers.md create mode 100644 docs/userguide/search.png create mode 100644 docs/userguide/storagedriver/aufs-driver.md create mode 100644 docs/userguide/storagedriver/btrfs-driver.md create mode 100644 docs/userguide/storagedriver/device-mapper-driver.md create mode 100644 docs/userguide/storagedriver/images/aufs_delete.jpg create mode 100644 docs/userguide/storagedriver/images/aufs_layers.jpg create mode 100644 docs/userguide/storagedriver/images/aufs_metadata.jpg create mode 100644 docs/userguide/storagedriver/images/base_device.jpg create mode 100644 docs/userguide/storagedriver/images/btfs_constructs.jpg create mode 100644 docs/userguide/storagedriver/images/btfs_container_layer.jpg create mode 100644 docs/userguide/storagedriver/images/btfs_layers.png create mode 100644 docs/userguide/storagedriver/images/btfs_pool.jpg create mode 100644 docs/userguide/storagedriver/images/btfs_snapshots.jpg create mode 100644 docs/userguide/storagedriver/images/btfs_subvolume.jpg create mode 100644 docs/userguide/storagedriver/images/container-layers.jpg create mode 100644 docs/userguide/storagedriver/images/dm_container.jpg create mode 100644 docs/userguide/storagedriver/images/image-layers.jpg create mode 100644 docs/userguide/storagedriver/images/overlay_constructs.jpg create mode 100644 docs/userguide/storagedriver/images/overlay_constructs2.jpg create mode 100644 docs/userguide/storagedriver/images/saving-space.jpg create mode 100644 docs/userguide/storagedriver/images/shared-uuid.jpg create mode 100644 docs/userguide/storagedriver/images/shared-volume.jpg create mode 100644 docs/userguide/storagedriver/images/sharing-layers.jpg create mode 100644 docs/userguide/storagedriver/images/two_dm_container.jpg create mode 100644 docs/userguide/storagedriver/images/zfs_clones.jpg create mode 100644 docs/userguide/storagedriver/images/zfs_zpool.jpg create mode 100644 docs/userguide/storagedriver/images/zpool_blocks.jpg create mode 100644 docs/userguide/storagedriver/imagesandcontainers.md create mode 100644 docs/userguide/storagedriver/index.md create mode 100644 docs/userguide/storagedriver/overlayfs-driver.md create mode 100644 docs/userguide/storagedriver/selectadriver.md create mode 100644 docs/userguide/storagedriver/zfs-driver.md create mode 100644 docs/userguide/usingdocker.md create mode 100644 docs/userguide/webapp1.png create mode 100644 errors/README.md create mode 100644 errors/builder.go create mode 100644 errors/daemon.go create mode 100644 errors/error.go create mode 100644 errors/image.go create mode 100644 errors/server.go create mode 100644 experimental/README.md create mode 100644 experimental/plugins_graphdriver.md create mode 100644 experimental/userns.md create mode 100644 graph/export.go create mode 100644 graph/fixtures/validate_manifest/bad_manifest create mode 100644 graph/fixtures/validate_manifest/extra_data_manifest create mode 100644 graph/fixtures/validate_manifest/good_manifest create mode 100644 graph/fixtures/validate_manifest/no_signature_manifest create mode 100644 graph/graph.go create mode 100644 graph/graph_test.go create mode 100644 graph/history.go create mode 100644 graph/import.go create mode 100644 graph/list.go create mode 100644 graph/load.go create mode 100644 graph/load_unsupported.go create mode 100644 graph/mutex.go create mode 100644 graph/pools_test.go create mode 100644 graph/pull.go create mode 100644 graph/pull_v1.go create mode 100644 graph/pull_v2.go create mode 100644 graph/pull_v2_test.go create mode 100644 graph/push.go create mode 100644 graph/push_v1.go create mode 100644 graph/push_v2.go create mode 100644 graph/registry.go create mode 100644 graph/service.go create mode 100644 graph/tags.go create mode 100644 graph/tags/tags.go create mode 100644 graph/tags/tags_unit_test.go create mode 100644 graph/tags_unit_test.go create mode 100755 hack/.vendor-helpers.sh create mode 100755 hack/dind create mode 100755 hack/generate-authors.sh create mode 100755 hack/install.sh create mode 100755 hack/make.sh create mode 100644 hack/make/.build-deb/compat create mode 100644 hack/make/.build-deb/control create mode 100644 hack/make/.build-deb/docker-engine.bash-completion create mode 120000 hack/make/.build-deb/docker-engine.docker.default create mode 120000 hack/make/.build-deb/docker-engine.docker.init create mode 120000 hack/make/.build-deb/docker-engine.docker.upstart create mode 100644 hack/make/.build-deb/docker-engine.install create mode 100644 hack/make/.build-deb/docker-engine.manpages create mode 100644 hack/make/.build-deb/docker-engine.postinst create mode 120000 hack/make/.build-deb/docker-engine.udev create mode 100644 hack/make/.build-deb/docs create mode 100755 hack/make/.build-deb/rules create mode 100644 hack/make/.build-rpm/docker-engine-selinux.spec create mode 100644 hack/make/.build-rpm/docker-engine.spec create mode 100644 hack/make/.dockerinit create mode 100644 hack/make/.dockerinit-gccgo create mode 100644 hack/make/.ensure-emptyfs create mode 100644 hack/make/.ensure-frozen-images create mode 100644 hack/make/.ensure-httpserver create mode 100644 hack/make/.go-autogen create mode 100755 hack/make/.go-compile-test-dir create mode 100644 hack/make/.integration-daemon-setup create mode 100644 hack/make/.integration-daemon-start create mode 100644 hack/make/.integration-daemon-stop create mode 100644 hack/make/.resources-windows/docker.exe.manifest create mode 100644 hack/make/.resources-windows/docker.ico create mode 100644 hack/make/.resources-windows/docker.png create mode 100644 hack/make/.validate create mode 100644 hack/make/README.md create mode 100644 hack/make/binary create mode 100644 hack/make/build-deb create mode 100644 hack/make/build-rpm create mode 100644 hack/make/cover create mode 100644 hack/make/cross create mode 100644 hack/make/dind-dynbinary create mode 100644 hack/make/dynbinary create mode 100644 hack/make/dyngccgo create mode 100644 hack/make/gccgo create mode 100755 hack/make/release-deb create mode 100755 hack/make/release-rpm create mode 100644 hack/make/rpm create mode 100755 hack/make/sign-repos create mode 100644 hack/make/test-docker-py create mode 100755 hack/make/test-install-script create mode 100644 hack/make/test-integration-cli create mode 100644 hack/make/test-unit create mode 100644 hack/make/tgz create mode 100644 hack/make/ubuntu create mode 100644 hack/make/validate-dco create mode 100644 hack/make/validate-gofmt create mode 100644 hack/make/validate-lint create mode 100644 hack/make/validate-pkg create mode 100644 hack/make/validate-test create mode 100644 hack/make/validate-toml create mode 100644 hack/make/validate-vet create mode 100755 hack/release.sh create mode 100755 hack/vendor.sh create mode 100644 image/fixtures/post1.9/expected_computed_id create mode 100644 image/fixtures/post1.9/expected_config create mode 100644 image/fixtures/post1.9/layer_id create mode 100644 image/fixtures/post1.9/parent_id create mode 100644 image/fixtures/post1.9/v1compatibility create mode 100644 image/fixtures/pre1.9/expected_computed_id create mode 100644 image/fixtures/pre1.9/expected_config create mode 100644 image/fixtures/pre1.9/layer_id create mode 100644 image/fixtures/pre1.9/parent_id create mode 100644 image/fixtures/pre1.9/v1compatibility create mode 100644 image/image.go create mode 100644 image/image_test.go create mode 100644 image/spec/v1.md create mode 100644 integration-cli/check_test.go create mode 100644 integration-cli/docker_api_attach_test.go create mode 100644 integration-cli/docker_api_build_test.go create mode 100644 integration-cli/docker_api_containers_test.go create mode 100644 integration-cli/docker_api_create_test.go create mode 100644 integration-cli/docker_api_events_test.go create mode 100644 integration-cli/docker_api_exec_resize_test.go create mode 100644 integration-cli/docker_api_exec_test.go create mode 100644 integration-cli/docker_api_images_test.go create mode 100644 integration-cli/docker_api_info_test.go create mode 100644 integration-cli/docker_api_inspect_test.go create mode 100644 integration-cli/docker_api_inspect_unix_test.go create mode 100644 integration-cli/docker_api_logs_test.go create mode 100644 integration-cli/docker_api_network_test.go create mode 100644 integration-cli/docker_api_resize_test.go create mode 100644 integration-cli/docker_api_stats_test.go create mode 100644 integration-cli/docker_api_test.go create mode 100644 integration-cli/docker_api_version_test.go create mode 100644 integration-cli/docker_api_volumes_test.go create mode 100644 integration-cli/docker_cli_attach_test.go create mode 100644 integration-cli/docker_cli_attach_unix_test.go create mode 100644 integration-cli/docker_cli_build_test.go create mode 100644 integration-cli/docker_cli_build_unix_test.go create mode 100644 integration-cli/docker_cli_by_digest_test.go create mode 100644 integration-cli/docker_cli_commit_test.go create mode 100644 integration-cli/docker_cli_config_test.go create mode 100644 integration-cli/docker_cli_cp_from_container_test.go create mode 100644 integration-cli/docker_cli_cp_test.go create mode 100644 integration-cli/docker_cli_cp_to_container_test.go create mode 100644 integration-cli/docker_cli_cp_utils.go create mode 100644 integration-cli/docker_cli_create_test.go create mode 100644 integration-cli/docker_cli_daemon_test.go create mode 100644 integration-cli/docker_cli_diff_test.go create mode 100644 integration-cli/docker_cli_events_test.go create mode 100644 integration-cli/docker_cli_events_unix_test.go create mode 100644 integration-cli/docker_cli_exec_test.go create mode 100644 integration-cli/docker_cli_exec_unix_test.go create mode 100644 integration-cli/docker_cli_experimental_test.go create mode 100644 integration-cli/docker_cli_export_import_test.go create mode 100644 integration-cli/docker_cli_external_graphdriver_unix_test.go create mode 100644 integration-cli/docker_cli_help_test.go create mode 100644 integration-cli/docker_cli_history_test.go create mode 100644 integration-cli/docker_cli_images_test.go create mode 100644 integration-cli/docker_cli_import_test.go create mode 100644 integration-cli/docker_cli_info_test.go create mode 100644 integration-cli/docker_cli_inspect_experimental_test.go create mode 100644 integration-cli/docker_cli_inspect_test.go create mode 100644 integration-cli/docker_cli_kill_test.go create mode 100644 integration-cli/docker_cli_links_test.go create mode 100644 integration-cli/docker_cli_links_unix_test.go create mode 100644 integration-cli/docker_cli_login_test.go create mode 100644 integration-cli/docker_cli_logs_test.go create mode 100644 integration-cli/docker_cli_nat_test.go create mode 100644 integration-cli/docker_cli_netmode_test.go create mode 100644 integration-cli/docker_cli_network_unix_test.go create mode 100644 integration-cli/docker_cli_pause_test.go create mode 100644 integration-cli/docker_cli_port_test.go create mode 100644 integration-cli/docker_cli_proxy_test.go create mode 100644 integration-cli/docker_cli_ps_test.go create mode 100644 integration-cli/docker_cli_pull_local_test.go create mode 100644 integration-cli/docker_cli_pull_test.go create mode 100644 integration-cli/docker_cli_pull_trusted_test.go create mode 100644 integration-cli/docker_cli_push_test.go create mode 100644 integration-cli/docker_cli_rename_test.go create mode 100644 integration-cli/docker_cli_restart_test.go create mode 100644 integration-cli/docker_cli_rm_test.go create mode 100644 integration-cli/docker_cli_rmi_test.go create mode 100644 integration-cli/docker_cli_run_test.go create mode 100644 integration-cli/docker_cli_run_unix_test.go create mode 100644 integration-cli/docker_cli_save_load_test.go create mode 100644 integration-cli/docker_cli_save_load_unix_test.go create mode 100644 integration-cli/docker_cli_search_test.go create mode 100644 integration-cli/docker_cli_start_test.go create mode 100644 integration-cli/docker_cli_start_volume_driver_unix_test.go create mode 100644 integration-cli/docker_cli_stats_test.go create mode 100644 integration-cli/docker_cli_tag_test.go create mode 100644 integration-cli/docker_cli_top_test.go create mode 100644 integration-cli/docker_cli_v2_only.go create mode 100644 integration-cli/docker_cli_version_test.go create mode 100644 integration-cli/docker_cli_volume_test.go create mode 100644 integration-cli/docker_cli_wait_test.go create mode 100644 integration-cli/docker_hub_pull_suite_test.go create mode 100644 integration-cli/docker_test_vars.go create mode 100644 integration-cli/docker_utils.go create mode 100644 integration-cli/fixtures/https/ca.pem create mode 100644 integration-cli/fixtures/https/client-cert.pem create mode 100644 integration-cli/fixtures/https/client-key.pem create mode 100644 integration-cli/fixtures/https/client-rogue-cert.pem create mode 100644 integration-cli/fixtures/https/client-rogue-key.pem create mode 100644 integration-cli/fixtures/https/server-cert.pem create mode 100644 integration-cli/fixtures/https/server-key.pem create mode 100644 integration-cli/fixtures/https/server-rogue-cert.pem create mode 100644 integration-cli/fixtures/https/server-rogue-key.pem create mode 100644 integration-cli/fixtures/notary/localhost.cert create mode 100644 integration-cli/fixtures/notary/localhost.key create mode 100644 integration-cli/registry.go create mode 100644 integration-cli/registry_mock.go create mode 100644 integration-cli/requirements.go create mode 100644 integration-cli/requirements_unix.go create mode 100644 integration-cli/test_vars_exec.go create mode 100644 integration-cli/test_vars_noexec.go create mode 100644 integration-cli/test_vars_unix.go create mode 100644 integration-cli/test_vars_windows.go create mode 100644 integration-cli/trust_server.go create mode 100644 integration-cli/utils.go create mode 100644 man/Dockerfile create mode 100644 man/Dockerfile.5.md create mode 100644 man/README.md create mode 100644 man/docker-attach.1.md create mode 100644 man/docker-build.1.md create mode 100644 man/docker-commit.1.md create mode 100644 man/docker-cp.1.md create mode 100644 man/docker-create.1.md create mode 100644 man/docker-daemon.8.md create mode 100644 man/docker-diff.1.md create mode 100644 man/docker-events.1.md create mode 100644 man/docker-exec.1.md create mode 100644 man/docker-export.1.md create mode 100644 man/docker-history.1.md create mode 100644 man/docker-images.1.md create mode 100644 man/docker-import.1.md create mode 100644 man/docker-info.1.md create mode 100644 man/docker-inspect.1.md create mode 100644 man/docker-kill.1.md create mode 100644 man/docker-load.1.md create mode 100644 man/docker-login.1.md create mode 100644 man/docker-logout.1.md create mode 100644 man/docker-logs.1.md create mode 100644 man/docker-network-connect.1.md create mode 100644 man/docker-network-create.1.md create mode 100644 man/docker-network-disconnect.1.md create mode 100644 man/docker-network-inspect.1.md create mode 100644 man/docker-network-ls.1.md create mode 100644 man/docker-network-rm.1.md create mode 100644 man/docker-pause.1.md create mode 100644 man/docker-port.1.md create mode 100644 man/docker-ps.1.md create mode 100644 man/docker-pull.1.md create mode 100644 man/docker-push.1.md create mode 100644 man/docker-rename.1.md create mode 100644 man/docker-restart.1.md create mode 100644 man/docker-rm.1.md create mode 100644 man/docker-rmi.1.md create mode 100644 man/docker-run.1.md create mode 100644 man/docker-save.1.md create mode 100644 man/docker-search.1.md create mode 100644 man/docker-start.1.md create mode 100644 man/docker-stats.1.md create mode 100644 man/docker-stop.1.md create mode 100644 man/docker-tag.1.md create mode 100644 man/docker-top.1.md create mode 100644 man/docker-unpause.1.md create mode 100644 man/docker-version.1.md create mode 100644 man/docker-volume-create.1.md create mode 100644 man/docker-volume-inspect.1.md create mode 100644 man/docker-volume-ls.1.md create mode 100644 man/docker-volume-rm.1.md create mode 100644 man/docker-wait.1.md create mode 100644 man/docker.1.md create mode 100755 man/md2man-all.sh create mode 100644 opts/envfile.go create mode 100644 opts/envfile_test.go create mode 100644 opts/hosts_unix.go create mode 100644 opts/hosts_windows.go create mode 100644 opts/ip.go create mode 100644 opts/ip_test.go create mode 100644 opts/opts.go create mode 100644 opts/opts_test.go create mode 100644 opts/ulimit.go create mode 100644 opts/ulimit_test.go create mode 100644 pkg/README.md create mode 100644 pkg/ansiescape/split.go create mode 100644 pkg/ansiescape/split_test.go create mode 100644 pkg/archive/README.md create mode 100644 pkg/archive/archive.go create mode 100644 pkg/archive/archive_test.go create mode 100644 pkg/archive/archive_unix.go create mode 100644 pkg/archive/archive_unix_test.go create mode 100644 pkg/archive/archive_windows.go create mode 100644 pkg/archive/archive_windows_test.go create mode 100644 pkg/archive/changes.go create mode 100644 pkg/archive/changes_linux.go create mode 100644 pkg/archive/changes_other.go create mode 100644 pkg/archive/changes_posix_test.go create mode 100644 pkg/archive/changes_test.go create mode 100644 pkg/archive/changes_unix.go create mode 100644 pkg/archive/changes_windows.go create mode 100644 pkg/archive/copy.go create mode 100644 pkg/archive/copy_test.go create mode 100644 pkg/archive/copy_unix.go create mode 100644 pkg/archive/copy_windows.go create mode 100644 pkg/archive/diff.go create mode 100644 pkg/archive/diff_test.go create mode 100644 pkg/archive/example_changes.go create mode 100644 pkg/archive/testdata/broken.tar create mode 100644 pkg/archive/time_linux.go create mode 100644 pkg/archive/time_unsupported.go create mode 100644 pkg/archive/utils_test.go create mode 100644 pkg/archive/whiteouts.go create mode 100644 pkg/archive/wrap.go create mode 100644 pkg/archive/wrap_test.go create mode 100644 pkg/broadcaster/buffered.go create mode 100644 pkg/broadcaster/unbuffered.go create mode 100644 pkg/broadcaster/unbuffered_test.go create mode 100644 pkg/chrootarchive/archive.go create mode 100644 pkg/chrootarchive/archive_test.go create mode 100644 pkg/chrootarchive/archive_unix.go create mode 100644 pkg/chrootarchive/archive_windows.go create mode 100644 pkg/chrootarchive/diff.go create mode 100644 pkg/chrootarchive/diff_unix.go create mode 100644 pkg/chrootarchive/diff_windows.go create mode 100644 pkg/chrootarchive/init_unix.go create mode 100644 pkg/chrootarchive/init_windows.go create mode 100644 pkg/devicemapper/attach_loopback.go create mode 100644 pkg/devicemapper/devmapper.go create mode 100644 pkg/devicemapper/devmapper_log.go create mode 100644 pkg/devicemapper/devmapper_wrapper.go create mode 100644 pkg/devicemapper/devmapper_wrapper_deferred_remove.go create mode 100644 pkg/devicemapper/devmapper_wrapper_no_deferred_remove.go create mode 100644 pkg/devicemapper/ioctl.go create mode 100644 pkg/devicemapper/log.go create mode 100644 pkg/directory/directory.go create mode 100644 pkg/directory/directory_test.go create mode 100644 pkg/directory/directory_unix.go create mode 100644 pkg/directory/directory_windows.go create mode 100644 pkg/discovery/README.md create mode 100644 pkg/discovery/backends.go create mode 100644 pkg/discovery/discovery.go create mode 100644 pkg/discovery/discovery_test.go create mode 100644 pkg/discovery/entry.go create mode 100644 pkg/discovery/file/file.go create mode 100644 pkg/discovery/file/file_test.go create mode 100644 pkg/discovery/generator.go create mode 100644 pkg/discovery/generator_test.go create mode 100644 pkg/discovery/kv/kv.go create mode 100644 pkg/discovery/kv/kv_test.go create mode 100644 pkg/discovery/nodes/nodes.go create mode 100644 pkg/discovery/nodes/nodes_test.go create mode 100644 pkg/fileutils/fileutils.go create mode 100644 pkg/fileutils/fileutils_test.go create mode 100644 pkg/fileutils/fileutils_unix.go create mode 100644 pkg/fileutils/fileutils_windows.go create mode 100644 pkg/graphdb/conn_sqlite3.go create mode 100644 pkg/graphdb/conn_sqlite3_unix.go create mode 100644 pkg/graphdb/conn_sqlite3_windows.go create mode 100644 pkg/graphdb/conn_unsupported.go create mode 100644 pkg/graphdb/graphdb.go create mode 100644 pkg/graphdb/graphdb_test.go create mode 100644 pkg/graphdb/sort.go create mode 100644 pkg/graphdb/sort_test.go create mode 100644 pkg/graphdb/utils.go create mode 100644 pkg/homedir/homedir.go create mode 100644 pkg/homedir/homedir_test.go create mode 100644 pkg/httputils/httputils.go create mode 100644 pkg/httputils/httputils_test.go create mode 100644 pkg/httputils/mimetype.go create mode 100644 pkg/httputils/mimetype_test.go create mode 100644 pkg/httputils/resumablerequestreader.go create mode 100644 pkg/httputils/resumablerequestreader_test.go create mode 100644 pkg/idtools/idtools.go create mode 100644 pkg/idtools/usergroupadd_linux.go create mode 100644 pkg/idtools/usergroupadd_unsupported.go create mode 100644 pkg/integration/checker/checker.go create mode 100644 pkg/integration/checker/checker_test.go create mode 100644 pkg/integration/dockerCmd_utils.go create mode 100644 pkg/integration/dockerCmd_utils_test.go create mode 100644 pkg/integration/utils.go create mode 100644 pkg/integration/utils_test.go create mode 100644 pkg/ioutils/bytespipe.go create mode 100644 pkg/ioutils/bytespipe_test.go create mode 100644 pkg/ioutils/fmt.go create mode 100644 pkg/ioutils/fmt_test.go create mode 100644 pkg/ioutils/multireader.go create mode 100644 pkg/ioutils/multireader_test.go create mode 100644 pkg/ioutils/readers.go create mode 100644 pkg/ioutils/readers_test.go create mode 100644 pkg/ioutils/scheduler.go create mode 100644 pkg/ioutils/scheduler_gccgo.go create mode 100644 pkg/ioutils/temp_unix.go create mode 100644 pkg/ioutils/temp_windows.go create mode 100644 pkg/ioutils/writeflusher.go create mode 100644 pkg/ioutils/writers.go create mode 100644 pkg/ioutils/writers_test.go create mode 100644 pkg/jsonlog/jsonlog.go create mode 100644 pkg/jsonlog/jsonlog_marshalling.go create mode 100644 pkg/jsonlog/jsonlog_marshalling_test.go create mode 100644 pkg/jsonlog/jsonlogbytes.go create mode 100644 pkg/jsonlog/jsonlogbytes_test.go create mode 100644 pkg/jsonmessage/jsonmessage.go create mode 100644 pkg/jsonmessage/jsonmessage_test.go create mode 100644 pkg/listenbuffer/README.md create mode 100644 pkg/listenbuffer/buffer.go create mode 100644 pkg/listenbuffer/listen_buffer_test.go create mode 100644 pkg/longpath/longpath.go create mode 100644 pkg/longpath/longpath_test.go create mode 100644 pkg/mflag/LICENSE create mode 100644 pkg/mflag/README.md create mode 100644 pkg/mflag/example/example.go create mode 100644 pkg/mflag/flag.go create mode 100644 pkg/mflag/flag_test.go create mode 100644 pkg/mount/flags.go create mode 100644 pkg/mount/flags_freebsd.go create mode 100644 pkg/mount/flags_linux.go create mode 100644 pkg/mount/flags_unsupported.go create mode 100644 pkg/mount/mount.go create mode 100644 pkg/mount/mount_test.go create mode 100644 pkg/mount/mounter_freebsd.go create mode 100644 pkg/mount/mounter_linux.go create mode 100644 pkg/mount/mounter_unsupported.go create mode 100644 pkg/mount/mountinfo.go create mode 100644 pkg/mount/mountinfo_freebsd.go create mode 100644 pkg/mount/mountinfo_linux.go create mode 100644 pkg/mount/mountinfo_linux_test.go create mode 100644 pkg/mount/mountinfo_unsupported.go create mode 100644 pkg/mount/sharedsubtree_linux.go create mode 100644 pkg/mount/sharedsubtree_linux_test.go create mode 100644 pkg/namesgenerator/cmd/names-generator/main.go create mode 100644 pkg/namesgenerator/names-generator.go create mode 100644 pkg/namesgenerator/names-generator_test.go create mode 100644 pkg/nat/nat.go create mode 100644 pkg/nat/nat_test.go create mode 100644 pkg/nat/sort.go create mode 100644 pkg/nat/sort_test.go create mode 100644 pkg/parsers/filters/parse.go create mode 100644 pkg/parsers/filters/parse_test.go create mode 100644 pkg/parsers/kernel/kernel.go create mode 100644 pkg/parsers/kernel/kernel_test.go create mode 100644 pkg/parsers/kernel/kernel_windows.go create mode 100644 pkg/parsers/kernel/uname_linux.go create mode 100644 pkg/parsers/kernel/uname_unsupported.go create mode 100644 pkg/parsers/operatingsystem/operatingsystem_freebsd.go create mode 100644 pkg/parsers/operatingsystem/operatingsystem_linux.go create mode 100644 pkg/parsers/operatingsystem/operatingsystem_test.go create mode 100644 pkg/parsers/operatingsystem/operatingsystem_windows.go create mode 100644 pkg/parsers/parsers.go create mode 100644 pkg/parsers/parsers_test.go create mode 100644 pkg/pidfile/pidfile.go create mode 100644 pkg/pidfile/pidfile_test.go create mode 100644 pkg/plugins/client.go create mode 100644 pkg/plugins/client_test.go create mode 100644 pkg/plugins/discovery.go create mode 100644 pkg/plugins/discovery_test.go create mode 100644 pkg/plugins/pluginrpc-gen/README.md create mode 100644 pkg/plugins/pluginrpc-gen/fixtures/foo.go create mode 100644 pkg/plugins/pluginrpc-gen/main.go create mode 100644 pkg/plugins/pluginrpc-gen/parser.go create mode 100644 pkg/plugins/pluginrpc-gen/parser_test.go create mode 100644 pkg/plugins/pluginrpc-gen/template.go create mode 100644 pkg/plugins/plugins.go create mode 100644 pkg/pools/pools.go create mode 100644 pkg/pools/pools_test.go create mode 100644 pkg/progressreader/progressreader.go create mode 100644 pkg/progressreader/progressreader_test.go create mode 100644 pkg/promise/promise.go create mode 100644 pkg/proxy/network_proxy_test.go create mode 100644 pkg/proxy/proxy.go create mode 100644 pkg/proxy/stub_proxy.go create mode 100644 pkg/proxy/tcp_proxy.go create mode 100644 pkg/proxy/udp_proxy.go create mode 100644 pkg/pubsub/publisher.go create mode 100644 pkg/pubsub/publisher_test.go create mode 100644 pkg/random/random.go create mode 100644 pkg/random/random_test.go create mode 100644 pkg/reexec/README.md create mode 100644 pkg/reexec/command_freebsd.go create mode 100644 pkg/reexec/command_linux.go create mode 100644 pkg/reexec/command_unsupported.go create mode 100644 pkg/reexec/command_windows.go create mode 100644 pkg/reexec/reexec.go create mode 100644 pkg/signal/README.md create mode 100644 pkg/signal/signal.go create mode 100644 pkg/signal/signal_darwin.go create mode 100644 pkg/signal/signal_freebsd.go create mode 100644 pkg/signal/signal_linux.go create mode 100644 pkg/signal/signal_unix.go create mode 100644 pkg/signal/signal_unsupported.go create mode 100644 pkg/signal/signal_windows.go create mode 100644 pkg/signal/trap.go create mode 100644 pkg/sockets/README.md create mode 100644 pkg/sockets/tcp_socket.go create mode 100644 pkg/sockets/unix_socket.go create mode 100644 pkg/stdcopy/stdcopy.go create mode 100644 pkg/stdcopy/stdcopy_test.go create mode 100644 pkg/streamformatter/streamformatter.go create mode 100644 pkg/streamformatter/streamformatter_test.go create mode 100644 pkg/stringid/README.md create mode 100644 pkg/stringid/stringid.go create mode 100644 pkg/stringid/stringid_test.go create mode 100644 pkg/stringutils/README.md create mode 100644 pkg/stringutils/stringutils.go create mode 100644 pkg/stringutils/stringutils_test.go create mode 100644 pkg/stringutils/strslice.go create mode 100644 pkg/stringutils/strslice_test.go create mode 100644 pkg/symlink/LICENSE.APACHE create mode 100644 pkg/symlink/LICENSE.BSD create mode 100644 pkg/symlink/README.md create mode 100644 pkg/symlink/fs.go create mode 100644 pkg/symlink/fs_test.go create mode 100644 pkg/symlink/fs_unix.go create mode 100644 pkg/symlink/fs_windows.go create mode 100644 pkg/sysinfo/README.md create mode 100644 pkg/sysinfo/sysinfo.go create mode 100644 pkg/sysinfo/sysinfo_freebsd.go create mode 100644 pkg/sysinfo/sysinfo_linux.go create mode 100644 pkg/sysinfo/sysinfo_linux_test.go create mode 100644 pkg/sysinfo/sysinfo_test.go create mode 100644 pkg/sysinfo/sysinfo_windows.go create mode 100644 pkg/system/chtimes.go create mode 100644 pkg/system/chtimes_test.go create mode 100644 pkg/system/chtimes_unix_test.go create mode 100644 pkg/system/chtimes_windows_test.go create mode 100644 pkg/system/errors.go create mode 100644 pkg/system/events_windows.go create mode 100644 pkg/system/filesys.go create mode 100644 pkg/system/filesys_windows.go create mode 100644 pkg/system/lstat.go create mode 100644 pkg/system/lstat_unix_test.go create mode 100644 pkg/system/lstat_windows.go create mode 100644 pkg/system/meminfo.go create mode 100644 pkg/system/meminfo_linux.go create mode 100644 pkg/system/meminfo_unix_test.go create mode 100644 pkg/system/meminfo_unsupported.go create mode 100644 pkg/system/meminfo_windows.go create mode 100644 pkg/system/mknod.go create mode 100644 pkg/system/mknod_windows.go create mode 100644 pkg/system/stat.go create mode 100644 pkg/system/stat_freebsd.go create mode 100644 pkg/system/stat_linux.go create mode 100644 pkg/system/stat_unix_test.go create mode 100644 pkg/system/stat_unsupported.go create mode 100644 pkg/system/stat_windows.go create mode 100644 pkg/system/umask.go create mode 100644 pkg/system/umask_windows.go create mode 100644 pkg/system/utimes_darwin.go create mode 100644 pkg/system/utimes_freebsd.go create mode 100644 pkg/system/utimes_linux.go create mode 100644 pkg/system/utimes_unix_test.go create mode 100644 pkg/system/utimes_unsupported.go create mode 100644 pkg/system/xattrs_linux.go create mode 100644 pkg/system/xattrs_unsupported.go create mode 100644 pkg/tailfile/tailfile.go create mode 100644 pkg/tailfile/tailfile_test.go create mode 100644 pkg/tarsum/builder_context.go create mode 100644 pkg/tarsum/builder_context_test.go create mode 100644 pkg/tarsum/fileinfosums.go create mode 100644 pkg/tarsum/fileinfosums_test.go create mode 100644 pkg/tarsum/tarsum.go create mode 100644 pkg/tarsum/tarsum_spec.md create mode 100644 pkg/tarsum/tarsum_test.go create mode 100644 pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json create mode 100644 pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar create mode 100644 pkg/tarsum/testdata/511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158/json create mode 100644 pkg/tarsum/testdata/511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158/layer.tar create mode 100644 pkg/tarsum/testdata/collision/collision-0.tar create mode 100644 pkg/tarsum/testdata/collision/collision-1.tar create mode 100644 pkg/tarsum/testdata/collision/collision-2.tar create mode 100644 pkg/tarsum/testdata/collision/collision-3.tar create mode 100644 pkg/tarsum/testdata/xattr/json create mode 100644 pkg/tarsum/testdata/xattr/layer.tar create mode 100644 pkg/tarsum/versioning.go create mode 100644 pkg/tarsum/versioning_test.go create mode 100644 pkg/tarsum/writercloser.go create mode 100644 pkg/term/tc_linux_cgo.go create mode 100644 pkg/term/tc_other.go create mode 100644 pkg/term/term.go create mode 100644 pkg/term/term_windows.go create mode 100644 pkg/term/termios_darwin.go create mode 100644 pkg/term/termios_freebsd.go create mode 100644 pkg/term/termios_linux.go create mode 100644 pkg/term/windows/ansi_reader.go create mode 100644 pkg/term/windows/ansi_writer.go create mode 100644 pkg/term/windows/console.go create mode 100644 pkg/term/windows/windows.go create mode 100644 pkg/term/windows/windows_test.go create mode 100644 pkg/timeoutconn/timeoutconn.go create mode 100644 pkg/timeoutconn/timeoutconn_test.go create mode 100644 pkg/timeutils/json.go create mode 100644 pkg/timeutils/json_test.go create mode 100644 pkg/timeutils/utils.go create mode 100644 pkg/timeutils/utils_test.go create mode 100644 pkg/tlsconfig/config.go create mode 100644 pkg/truncindex/truncindex.go create mode 100644 pkg/truncindex/truncindex_test.go create mode 100644 pkg/ulimit/ulimit.go create mode 100644 pkg/ulimit/ulimit_test.go create mode 100644 pkg/units/duration.go create mode 100644 pkg/units/duration_test.go create mode 100644 pkg/units/size.go create mode 100644 pkg/units/size_test.go create mode 100644 pkg/urlutil/urlutil.go create mode 100644 pkg/urlutil/urlutil_test.go create mode 100644 pkg/useragent/README.md create mode 100644 pkg/useragent/useragent.go create mode 100644 pkg/useragent/useragent_test.go create mode 100644 pkg/version/version.go create mode 100644 pkg/version/version_test.go create mode 100644 project/BRANCHES-AND-TAGS.md create mode 120000 project/CONTRIBUTORS.md create mode 100644 project/GOVERNANCE.md create mode 100644 project/IRC-ADMINISTRATION.md create mode 100644 project/ISSUE-TRIAGE.md create mode 100644 project/PACKAGERS.md create mode 100644 project/PRINCIPLES.md create mode 100644 project/README.md create mode 100644 project/RELEASE-CHECKLIST.md create mode 100644 project/RELEASE-PROCESS.md create mode 100644 project/REVIEWING.md create mode 100644 project/TOOLS.md create mode 100644 project/make/validate-toml create mode 100644 registry/auth.go create mode 100644 registry/auth_test.go create mode 100644 registry/authchallenge.go create mode 100644 registry/config.go create mode 100644 registry/config_test.go create mode 100644 registry/config_unix.go create mode 100644 registry/config_windows.go create mode 100644 registry/endpoint.go create mode 100644 registry/endpoint_test.go create mode 100644 registry/reference.go create mode 100644 registry/registry.go create mode 100644 registry/registry_mock_test.go create mode 100644 registry/registry_test.go create mode 100644 registry/service.go create mode 100644 registry/service_v1.go create mode 100644 registry/service_v2.go create mode 100644 registry/session.go create mode 100644 registry/token.go create mode 100644 registry/types.go create mode 100644 runconfig/compare.go create mode 100644 runconfig/compare_test.go create mode 100644 runconfig/config.go create mode 100644 runconfig/config_test.go create mode 100644 runconfig/config_unix.go create mode 100644 runconfig/config_windows.go create mode 100644 runconfig/exec.go create mode 100644 runconfig/exec_test.go create mode 100644 runconfig/fixtures/container_config_1_14.json create mode 100644 runconfig/fixtures/container_config_1_17.json create mode 100644 runconfig/fixtures/container_config_1_19.json create mode 100644 runconfig/fixtures/container_hostconfig_1_14.json create mode 100644 runconfig/fixtures/container_hostconfig_1_19.json create mode 100644 runconfig/fixtures/valid.env create mode 100644 runconfig/fixtures/valid.label create mode 100644 runconfig/hostconfig.go create mode 100644 runconfig/hostconfig_test.go create mode 100644 runconfig/hostconfig_unix.go create mode 100644 runconfig/hostconfig_windows.go create mode 100644 runconfig/merge.go create mode 100644 runconfig/merge_test.go create mode 100644 runconfig/parse.go create mode 100644 runconfig/parse_test.go create mode 100644 runconfig/parse_unix.go create mode 100644 runconfig/parse_windows.go create mode 100644 utils/experimental.go create mode 100644 utils/git.go create mode 100644 utils/git_test.go create mode 100644 utils/names.go create mode 100644 utils/stubs.go create mode 100644 utils/timeout.go create mode 100644 utils/utils.go create mode 100644 utils/utils_test.go create mode 100644 utils/utils_unix.go create mode 100644 utils/utils_windows.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/LICENSE create mode 100644 vendor/src/github.com/Azure/go-ansiterm/README.md create mode 100644 vendor/src/github.com/Azure/go-ansiterm/constants.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/context.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/csi_entry_state.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/csi_param_state.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/escape_intermediate_state.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/escape_state.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/event_handler.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/ground_state.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/osc_string_state.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/parser.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/parser_action_helpers.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/parser_actions.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/parser_test_helpers.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/parser_test_utilities.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/states.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/test_event_handler.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/utilities.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/ansi.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/api.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/attr_translation.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/cursor_helpers.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/erase_helpers.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/scroll_helper.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/utilities.go create mode 100644 vendor/src/github.com/Azure/go-ansiterm/winterm/win_event_handler.go create mode 100644 vendor/src/github.com/BurntSushi/toml/.gitignore create mode 100644 vendor/src/github.com/BurntSushi/toml/.travis.yml create mode 100644 vendor/src/github.com/BurntSushi/toml/COMPATIBLE create mode 100644 vendor/src/github.com/BurntSushi/toml/COPYING create mode 100644 vendor/src/github.com/BurntSushi/toml/Makefile create mode 100644 vendor/src/github.com/BurntSushi/toml/README.md create mode 100644 vendor/src/github.com/BurntSushi/toml/cmd/toml-test-decoder/COPYING create mode 100644 vendor/src/github.com/BurntSushi/toml/cmd/toml-test-encoder/COPYING create mode 100644 vendor/src/github.com/BurntSushi/toml/cmd/tomlv/COPYING create mode 100644 vendor/src/github.com/BurntSushi/toml/decode.go create mode 100644 vendor/src/github.com/BurntSushi/toml/decode_meta.go create mode 100644 vendor/src/github.com/BurntSushi/toml/doc.go create mode 100644 vendor/src/github.com/BurntSushi/toml/encode.go create mode 100644 vendor/src/github.com/BurntSushi/toml/encoding_types.go create mode 100644 vendor/src/github.com/BurntSushi/toml/encoding_types_1.1.go create mode 100644 vendor/src/github.com/BurntSushi/toml/lex.go create mode 100644 vendor/src/github.com/BurntSushi/toml/parse.go create mode 100644 vendor/src/github.com/BurntSushi/toml/session.vim create mode 100644 vendor/src/github.com/BurntSushi/toml/type_check.go create mode 100644 vendor/src/github.com/BurntSushi/toml/type_fields.go create mode 100644 vendor/src/github.com/Graylog2/go-gelf/LICENSE create mode 100644 vendor/src/github.com/Graylog2/go-gelf/gelf/reader.go create mode 100644 vendor/src/github.com/Graylog2/go-gelf/gelf/writer.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/.gitignore create mode 100644 vendor/src/github.com/Sirupsen/logrus/.travis.yml create mode 100644 vendor/src/github.com/Sirupsen/logrus/CHANGELOG.md create mode 100644 vendor/src/github.com/Sirupsen/logrus/LICENSE create mode 100644 vendor/src/github.com/Sirupsen/logrus/README.md create mode 100644 vendor/src/github.com/Sirupsen/logrus/entry.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/exported.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/formatter.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/hooks.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/json_formatter.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/logger.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/logrus.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/terminal_darwin.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/terminal_freebsd.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/terminal_linux.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/terminal_notwindows.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/terminal_openbsd.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/terminal_windows.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/text_formatter.go create mode 100644 vendor/src/github.com/Sirupsen/logrus/writer.go create mode 100644 vendor/src/github.com/agl/ed25519/LICENSE create mode 100644 vendor/src/github.com/agl/ed25519/ed25519.go create mode 100644 vendor/src/github.com/agl/ed25519/edwards25519/const.go create mode 100644 vendor/src/github.com/agl/ed25519/edwards25519/edwards25519.go create mode 100755 vendor/src/github.com/armon/go-metrics/.gitignore create mode 100644 vendor/src/github.com/armon/go-metrics/LICENSE create mode 100644 vendor/src/github.com/armon/go-metrics/README.md create mode 100644 vendor/src/github.com/armon/go-metrics/const_unix.go create mode 100644 vendor/src/github.com/armon/go-metrics/const_windows.go create mode 100644 vendor/src/github.com/armon/go-metrics/inmem.go create mode 100644 vendor/src/github.com/armon/go-metrics/inmem_signal.go create mode 100755 vendor/src/github.com/armon/go-metrics/metrics.go create mode 100755 vendor/src/github.com/armon/go-metrics/sink.go create mode 100755 vendor/src/github.com/armon/go-metrics/start.go create mode 100644 vendor/src/github.com/armon/go-metrics/statsd.go create mode 100755 vendor/src/github.com/armon/go-metrics/statsite.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/LICENSE.txt create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/awserr/error.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/awserr/types.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/copy.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/path_value.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/prettify.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/config.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/convutil.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/credentials.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/ec2_role_provider.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/example.ini create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/shared_credentials_provider.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/credentials/static_provider.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/handler_functions.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/handlers.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/logger.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/param_validator.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/request.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/service.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/types.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/aws/version.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.json create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints_map.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/build.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/unmarshal.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/protocol/jsonrpc/jsonrpc.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/build.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/payload.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/unmarshal.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/internal/signer/v4/v4.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go create mode 100644 vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go create mode 100644 vendor/src/github.com/boltdb/bolt/.gitignore create mode 100644 vendor/src/github.com/boltdb/bolt/LICENSE create mode 100644 vendor/src/github.com/boltdb/bolt/Makefile create mode 100644 vendor/src/github.com/boltdb/bolt/README.md create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_386.go create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_amd64.go create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_arm.go create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_linux.go create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_openbsd.go create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_unix.go create mode 100644 vendor/src/github.com/boltdb/bolt/bolt_windows.go create mode 100644 vendor/src/github.com/boltdb/bolt/boltsync_unix.go create mode 100644 vendor/src/github.com/boltdb/bolt/bucket.go create mode 100644 vendor/src/github.com/boltdb/bolt/cursor.go create mode 100644 vendor/src/github.com/boltdb/bolt/db.go create mode 100644 vendor/src/github.com/boltdb/bolt/doc.go create mode 100644 vendor/src/github.com/boltdb/bolt/errors.go create mode 100644 vendor/src/github.com/boltdb/bolt/freelist.go create mode 100644 vendor/src/github.com/boltdb/bolt/node.go create mode 100644 vendor/src/github.com/boltdb/bolt/page.go create mode 100644 vendor/src/github.com/boltdb/bolt/tx.go create mode 100644 vendor/src/github.com/coreos/etcd/LICENSE create mode 100644 vendor/src/github.com/coreos/etcd/client/README.md create mode 100644 vendor/src/github.com/coreos/etcd/client/auth_role.go create mode 100644 vendor/src/github.com/coreos/etcd/client/auth_user.go create mode 100644 vendor/src/github.com/coreos/etcd/client/cancelreq.go create mode 100644 vendor/src/github.com/coreos/etcd/client/cancelreq_go14.go create mode 100644 vendor/src/github.com/coreos/etcd/client/client.go create mode 100644 vendor/src/github.com/coreos/etcd/client/cluster_error.go create mode 100644 vendor/src/github.com/coreos/etcd/client/curl.go create mode 100644 vendor/src/github.com/coreos/etcd/client/discover.go create mode 100644 vendor/src/github.com/coreos/etcd/client/doc.go create mode 100644 vendor/src/github.com/coreos/etcd/client/keys.generated.go create mode 100644 vendor/src/github.com/coreos/etcd/client/keys.go create mode 100644 vendor/src/github.com/coreos/etcd/client/members.go create mode 100644 vendor/src/github.com/coreos/etcd/client/srv.go create mode 100644 vendor/src/github.com/coreos/etcd/pkg/pathutil/path.go create mode 100644 vendor/src/github.com/coreos/etcd/pkg/types/id.go create mode 100644 vendor/src/github.com/coreos/etcd/pkg/types/set.go create mode 100644 vendor/src/github.com/coreos/etcd/pkg/types/slice.go create mode 100644 vendor/src/github.com/coreos/etcd/pkg/types/urls.go create mode 100644 vendor/src/github.com/coreos/etcd/pkg/types/urlsmap.go create mode 100644 vendor/src/github.com/coreos/go-systemd/LICENSE create mode 100644 vendor/src/github.com/coreos/go-systemd/activation/files.go create mode 100644 vendor/src/github.com/coreos/go-systemd/activation/listeners.go create mode 100644 vendor/src/github.com/coreos/go-systemd/activation/packetconns.go create mode 100644 vendor/src/github.com/coreos/go-systemd/daemon/sdnotify.go create mode 100644 vendor/src/github.com/coreos/go-systemd/dbus/dbus.go create mode 100644 vendor/src/github.com/coreos/go-systemd/dbus/methods.go create mode 100644 vendor/src/github.com/coreos/go-systemd/dbus/properties.go create mode 100644 vendor/src/github.com/coreos/go-systemd/dbus/set.go create mode 100644 vendor/src/github.com/coreos/go-systemd/dbus/subscription.go create mode 100644 vendor/src/github.com/coreos/go-systemd/dbus/subscription_set.go create mode 100644 vendor/src/github.com/coreos/go-systemd/journal/send.go create mode 100644 vendor/src/github.com/coreos/go-systemd/util/util.go create mode 100644 vendor/src/github.com/deckarep/golang-set/.gitignore create mode 100644 vendor/src/github.com/deckarep/golang-set/.travis.yml create mode 100644 vendor/src/github.com/deckarep/golang-set/LICENSE create mode 100644 vendor/src/github.com/deckarep/golang-set/README.md create mode 100644 vendor/src/github.com/deckarep/golang-set/set.go create mode 100644 vendor/src/github.com/deckarep/golang-set/threadsafe.go create mode 100644 vendor/src/github.com/deckarep/golang-set/threadunsafe.go create mode 100644 vendor/src/github.com/docker/distribution/.drone.yml create mode 100644 vendor/src/github.com/docker/distribution/.gitignore create mode 100644 vendor/src/github.com/docker/distribution/.mailmap create mode 100644 vendor/src/github.com/docker/distribution/AUTHORS create mode 100644 vendor/src/github.com/docker/distribution/CONTRIBUTING.md create mode 100644 vendor/src/github.com/docker/distribution/Dockerfile create mode 100644 vendor/src/github.com/docker/distribution/LICENSE create mode 100644 vendor/src/github.com/docker/distribution/MAINTAINERS create mode 100644 vendor/src/github.com/docker/distribution/Makefile create mode 100644 vendor/src/github.com/docker/distribution/README.md create mode 100644 vendor/src/github.com/docker/distribution/ROADMAP.md create mode 100644 vendor/src/github.com/docker/distribution/blobs.go create mode 100644 vendor/src/github.com/docker/distribution/circle.yml create mode 100644 vendor/src/github.com/docker/distribution/context/context.go create mode 100644 vendor/src/github.com/docker/distribution/context/doc.go create mode 100644 vendor/src/github.com/docker/distribution/context/http.go create mode 100644 vendor/src/github.com/docker/distribution/context/logger.go create mode 100644 vendor/src/github.com/docker/distribution/context/trace.go create mode 100644 vendor/src/github.com/docker/distribution/context/util.go create mode 100644 vendor/src/github.com/docker/distribution/digest/digest.go create mode 100644 vendor/src/github.com/docker/distribution/digest/digester.go create mode 100644 vendor/src/github.com/docker/distribution/digest/doc.go create mode 100644 vendor/src/github.com/docker/distribution/digest/set.go create mode 100644 vendor/src/github.com/docker/distribution/digest/tarsum.go create mode 100644 vendor/src/github.com/docker/distribution/digest/verifiers.go create mode 100644 vendor/src/github.com/docker/distribution/doc.go create mode 100644 vendor/src/github.com/docker/distribution/errors.go create mode 100644 vendor/src/github.com/docker/distribution/manifest/manifest.go create mode 100644 vendor/src/github.com/docker/distribution/manifest/sign.go create mode 100644 vendor/src/github.com/docker/distribution/manifest/verify.go create mode 100644 vendor/src/github.com/docker/distribution/registry.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/errcode/errors.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/errcode/handler.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/errcode/register.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/v2/descriptors.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/v2/doc.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/v2/errors.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/v2/names.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/v2/routes.go create mode 100644 vendor/src/github.com/docker/distribution/registry/api/v2/urls.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/auth/api_version.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/auth/authchallenge.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/auth/session.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/blob_writer.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/errors.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/repository.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/transport/http_reader.go create mode 100644 vendor/src/github.com/docker/distribution/registry/client/transport/transport.go create mode 100644 vendor/src/github.com/docker/distribution/registry/storage/cache/cache.go create mode 100644 vendor/src/github.com/docker/distribution/registry/storage/cache/cachedblobdescriptorstore.go create mode 100644 vendor/src/github.com/docker/distribution/registry/storage/cache/memory/memory.go create mode 100644 vendor/src/github.com/docker/distribution/registry/storage/cache/suite.go create mode 100644 vendor/src/github.com/docker/distribution/uuid/uuid.go create mode 100644 vendor/src/github.com/docker/libcontainer/cgroups/fs/freezer_test.go create mode 100644 vendor/src/github.com/docker/libcontainer/nsinit/README.md create mode 100644 vendor/src/github.com/docker/libcontainer/rootfs_linux_test.go create mode 100644 vendor/src/github.com/docker/libkv/.travis.yml create mode 100644 vendor/src/github.com/docker/libkv/LICENSE.code create mode 100644 vendor/src/github.com/docker/libkv/LICENSE.docs create mode 100644 vendor/src/github.com/docker/libkv/README.md create mode 100644 vendor/src/github.com/docker/libkv/libkv.go create mode 100644 vendor/src/github.com/docker/libkv/store/boltdb/boltdb.go create mode 100644 vendor/src/github.com/docker/libkv/store/consul/consul.go create mode 100644 vendor/src/github.com/docker/libkv/store/etcd/etcd.go create mode 100644 vendor/src/github.com/docker/libkv/store/helpers.go create mode 100644 vendor/src/github.com/docker/libkv/store/store.go create mode 100644 vendor/src/github.com/docker/libkv/store/zookeeper/zookeeper.go create mode 100644 vendor/src/github.com/docker/libnetwork/.gitignore create mode 100644 vendor/src/github.com/docker/libnetwork/LICENSE create mode 100644 vendor/src/github.com/docker/libnetwork/MAINTAINERS create mode 100644 vendor/src/github.com/docker/libnetwork/Makefile create mode 100644 vendor/src/github.com/docker/libnetwork/README.md create mode 100644 vendor/src/github.com/docker/libnetwork/ROADMAP.md create mode 100644 vendor/src/github.com/docker/libnetwork/bitseq/sequence.go create mode 100644 vendor/src/github.com/docker/libnetwork/bitseq/store.go create mode 100644 vendor/src/github.com/docker/libnetwork/circle.yml create mode 100644 vendor/src/github.com/docker/libnetwork/config/config.go create mode 100644 vendor/src/github.com/docker/libnetwork/config/libnetwork.toml create mode 100644 vendor/src/github.com/docker/libnetwork/controller.go create mode 100644 vendor/src/github.com/docker/libnetwork/datastore/cache.go create mode 100644 vendor/src/github.com/docker/libnetwork/datastore/datastore.go create mode 100644 vendor/src/github.com/docker/libnetwork/datastore/mock_store.go create mode 100644 vendor/src/github.com/docker/libnetwork/default_gateway.go create mode 100644 vendor/src/github.com/docker/libnetwork/default_gateway_freebsd.go create mode 100644 vendor/src/github.com/docker/libnetwork/default_gateway_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/default_gateway_windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/driverapi/driverapi.go create mode 100644 vendor/src/github.com/docker/libnetwork/driverapi/errors.go create mode 100644 vendor/src/github.com/docker/libnetwork/driverapi/ipamdata.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge_store.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/errors.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/interface.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/labels.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/link.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_armppc64.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_notarm.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_unsupported.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/port_mapping.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/resolvconf.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_bridgenetfiltering.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_device.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_firewalld.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_forwarding.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_tables.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv4.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv6.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_verify.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/host/host.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/null/null.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/filter.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/joinleave.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_endpoint.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_network.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_serf.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_utils.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/overlay.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/overlay/peerdb.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/remote/api/api.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/remote/driver.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers/windows/windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers_freebsd.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/drivers_windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/endpoint.go create mode 100644 vendor/src/github.com/docker/libnetwork/endpoint_cnt.go create mode 100644 vendor/src/github.com/docker/libnetwork/endpoint_info.go create mode 100644 vendor/src/github.com/docker/libnetwork/error.go create mode 100644 vendor/src/github.com/docker/libnetwork/etchosts/etchosts.go create mode 100644 vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery.go create mode 100644 vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery_api.go create mode 100644 vendor/src/github.com/docker/libnetwork/hostdiscovery/libnetwork.toml create mode 100644 vendor/src/github.com/docker/libnetwork/idm/idm.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipam/allocator.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipam/store.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipam/structures.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipam/utils.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipamapi/contract.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipams/builtin/builtin.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipams/remote/api/api.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipams/remote/remote.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipamutils/utils.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipamutils/utils_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/ipamutils/utils_windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/iptables/firewalld.go create mode 100644 vendor/src/github.com/docker/libnetwork/iptables/iptables.go create mode 100644 vendor/src/github.com/docker/libnetwork/netlabel/labels.go create mode 100644 vendor/src/github.com/docker/libnetwork/netutils/utils.go create mode 100644 vendor/src/github.com/docker/libnetwork/network.go create mode 100644 vendor/src/github.com/docker/libnetwork/ns/init_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/options/options.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/interface_freebsd.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/interface_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/interface_windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/namespace_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/namespace_unsupported.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/namespace_windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/neigh_freebsd.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/neigh_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/neigh_windows.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/options_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/route_linux.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/sandbox.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/sandbox_freebsd.go create mode 100644 vendor/src/github.com/docker/libnetwork/osl/sandbox_unsupported.go create mode 100644 vendor/src/github.com/docker/libnetwork/portallocator/portallocator.go create mode 100644 vendor/src/github.com/docker/libnetwork/portmapper/mapper.go create mode 100644 vendor/src/github.com/docker/libnetwork/portmapper/mock_proxy.go create mode 100644 vendor/src/github.com/docker/libnetwork/portmapper/proxy.go create mode 100644 vendor/src/github.com/docker/libnetwork/resolvconf/README.md create mode 100644 vendor/src/github.com/docker/libnetwork/resolvconf/dns/resolvconf.go create mode 100644 vendor/src/github.com/docker/libnetwork/resolvconf/resolvconf.go create mode 100644 vendor/src/github.com/docker/libnetwork/sandbox.go create mode 100644 vendor/src/github.com/docker/libnetwork/sandbox_externalkey.go create mode 100644 vendor/src/github.com/docker/libnetwork/sandbox_store.go create mode 100644 vendor/src/github.com/docker/libnetwork/store.go create mode 100644 vendor/src/github.com/docker/libnetwork/types/types.go create mode 100755 vendor/src/github.com/docker/libnetwork/wrapmake.sh create mode 100644 vendor/src/github.com/docker/libtrust/CONTRIBUTING.md create mode 100644 vendor/src/github.com/docker/libtrust/LICENSE create mode 100644 vendor/src/github.com/docker/libtrust/MAINTAINERS create mode 100644 vendor/src/github.com/docker/libtrust/README.md create mode 100644 vendor/src/github.com/docker/libtrust/certificates.go create mode 100644 vendor/src/github.com/docker/libtrust/doc.go create mode 100644 vendor/src/github.com/docker/libtrust/ec_key.go create mode 100644 vendor/src/github.com/docker/libtrust/filter.go create mode 100644 vendor/src/github.com/docker/libtrust/hash.go create mode 100644 vendor/src/github.com/docker/libtrust/jsonsign.go create mode 100644 vendor/src/github.com/docker/libtrust/key.go create mode 100644 vendor/src/github.com/docker/libtrust/key_files.go create mode 100644 vendor/src/github.com/docker/libtrust/key_manager.go create mode 100644 vendor/src/github.com/docker/libtrust/rsa_key.go create mode 100644 vendor/src/github.com/docker/libtrust/util.go create mode 100644 vendor/src/github.com/docker/notary/LICENSE create mode 100644 vendor/src/github.com/docker/notary/client/changelist/change.go create mode 100644 vendor/src/github.com/docker/notary/client/changelist/changelist.go create mode 100644 vendor/src/github.com/docker/notary/client/changelist/file_changelist.go create mode 100644 vendor/src/github.com/docker/notary/client/changelist/interface.go create mode 100644 vendor/src/github.com/docker/notary/client/client.go create mode 100644 vendor/src/github.com/docker/notary/client/helpers.go create mode 100644 vendor/src/github.com/docker/notary/cryptoservice/crypto_service.go create mode 100644 vendor/src/github.com/docker/notary/cryptoservice/unlocked_crypto_service.go create mode 100644 vendor/src/github.com/docker/notary/keystoremanager/import_export.go create mode 100644 vendor/src/github.com/docker/notary/keystoremanager/keystoremanager.go create mode 100644 vendor/src/github.com/docker/notary/notarymysql/LICENSE create mode 100644 vendor/src/github.com/docker/notary/pkg/passphrase/passphrase.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/filestore.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/keyfilestore.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/keystore.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/x509filestore.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/x509memstore.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/x509store.go create mode 100644 vendor/src/github.com/docker/notary/trustmanager/x509utils.go create mode 100644 vendor/src/github.com/endophage/gotuf/.gitignore create mode 100644 vendor/src/github.com/endophage/gotuf/.travis.yml create mode 100644 vendor/src/github.com/endophage/gotuf/CONTRIBUTORS create mode 100644 vendor/src/github.com/endophage/gotuf/LICENSE create mode 100644 vendor/src/github.com/endophage/gotuf/MAINTAINERS create mode 100644 vendor/src/github.com/endophage/gotuf/Makefile create mode 100644 vendor/src/github.com/endophage/gotuf/README.md create mode 100644 vendor/src/github.com/endophage/gotuf/client/client.go create mode 100644 vendor/src/github.com/endophage/gotuf/client/errors.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/keys.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/roles.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/root.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/snapshot.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/targets.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/timestamp.go create mode 100644 vendor/src/github.com/endophage/gotuf/data/types.go create mode 100644 vendor/src/github.com/endophage/gotuf/errors/errors.go create mode 100644 vendor/src/github.com/endophage/gotuf/keys/db.go create mode 100644 vendor/src/github.com/endophage/gotuf/signed/ed25519.go create mode 100644 vendor/src/github.com/endophage/gotuf/signed/errors.go create mode 100644 vendor/src/github.com/endophage/gotuf/signed/interface.go create mode 100644 vendor/src/github.com/endophage/gotuf/signed/sign.go create mode 100644 vendor/src/github.com/endophage/gotuf/signed/verifiers.go create mode 100644 vendor/src/github.com/endophage/gotuf/signed/verify.go create mode 100644 vendor/src/github.com/endophage/gotuf/store/dbstore.go create mode 100644 vendor/src/github.com/endophage/gotuf/store/errors.go create mode 100644 vendor/src/github.com/endophage/gotuf/store/filestore.go create mode 100644 vendor/src/github.com/endophage/gotuf/store/httpstore.go create mode 100644 vendor/src/github.com/endophage/gotuf/store/interfaces.go create mode 100644 vendor/src/github.com/endophage/gotuf/store/memorystore.go create mode 100644 vendor/src/github.com/endophage/gotuf/tuf.go create mode 100644 vendor/src/github.com/endophage/gotuf/utils/util.go create mode 100644 vendor/src/github.com/endophage/gotuf/utils/utils.go create mode 100644 vendor/src/github.com/fluent/fluent-logger-golang/LICENSE create mode 100644 vendor/src/github.com/fluent/fluent-logger-golang/fluent/fluent.go create mode 100644 vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto.go create mode 100644 vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto_gen.go create mode 100644 vendor/src/github.com/fluent/fluent-logger-golang/fluent/version.go create mode 100644 vendor/src/github.com/go-check/check/.gitignore create mode 100644 vendor/src/github.com/go-check/check/LICENSE create mode 100644 vendor/src/github.com/go-check/check/README.md create mode 100644 vendor/src/github.com/go-check/check/TODO create mode 100644 vendor/src/github.com/go-check/check/benchmark.go create mode 100644 vendor/src/github.com/go-check/check/check.go create mode 100644 vendor/src/github.com/go-check/check/checkers.go create mode 100644 vendor/src/github.com/go-check/check/helpers.go create mode 100644 vendor/src/github.com/go-check/check/printer.go create mode 100644 vendor/src/github.com/go-check/check/run.go create mode 100644 vendor/src/github.com/godbus/dbus/CONTRIBUTING.md create mode 100644 vendor/src/github.com/godbus/dbus/LICENSE create mode 100644 vendor/src/github.com/godbus/dbus/MAINTAINERS create mode 100644 vendor/src/github.com/godbus/dbus/README.markdown create mode 100644 vendor/src/github.com/godbus/dbus/auth.go create mode 100644 vendor/src/github.com/godbus/dbus/auth_external.go create mode 100644 vendor/src/github.com/godbus/dbus/auth_sha1.go create mode 100644 vendor/src/github.com/godbus/dbus/call.go create mode 100644 vendor/src/github.com/godbus/dbus/conn.go create mode 100644 vendor/src/github.com/godbus/dbus/conn_darwin.go create mode 100644 vendor/src/github.com/godbus/dbus/conn_other.go create mode 100644 vendor/src/github.com/godbus/dbus/dbus.go create mode 100644 vendor/src/github.com/godbus/dbus/decoder.go create mode 100644 vendor/src/github.com/godbus/dbus/doc.go create mode 100644 vendor/src/github.com/godbus/dbus/encoder.go create mode 100644 vendor/src/github.com/godbus/dbus/export.go create mode 100644 vendor/src/github.com/godbus/dbus/homedir.go create mode 100644 vendor/src/github.com/godbus/dbus/homedir_dynamic.go create mode 100644 vendor/src/github.com/godbus/dbus/homedir_static.go create mode 100644 vendor/src/github.com/godbus/dbus/message.go create mode 100644 vendor/src/github.com/godbus/dbus/sig.go create mode 100644 vendor/src/github.com/godbus/dbus/transport_darwin.go create mode 100644 vendor/src/github.com/godbus/dbus/transport_generic.go create mode 100644 vendor/src/github.com/godbus/dbus/transport_unix.go create mode 100644 vendor/src/github.com/godbus/dbus/transport_unixcred_dragonfly.go create mode 100644 vendor/src/github.com/godbus/dbus/transport_unixcred_linux.go create mode 100644 vendor/src/github.com/godbus/dbus/variant.go create mode 100644 vendor/src/github.com/godbus/dbus/variant_lexer.go create mode 100644 vendor/src/github.com/godbus/dbus/variant_parser.go create mode 100644 vendor/src/github.com/golang/protobuf/LICENSE create mode 100644 vendor/src/github.com/golang/protobuf/proto/Makefile create mode 100644 vendor/src/github.com/golang/protobuf/proto/clone.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/decode.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/encode.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/equal.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/extensions.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/lib.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/message_set.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/pointer_reflect.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/pointer_unsafe.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/properties.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/text.go create mode 100644 vendor/src/github.com/golang/protobuf/proto/text_parser.go create mode 100644 vendor/src/github.com/gorilla/context/.travis.yml create mode 100644 vendor/src/github.com/gorilla/context/LICENSE create mode 100644 vendor/src/github.com/gorilla/context/README.md create mode 100644 vendor/src/github.com/gorilla/context/context.go create mode 100644 vendor/src/github.com/gorilla/context/doc.go create mode 100644 vendor/src/github.com/gorilla/mux/.travis.yml create mode 100644 vendor/src/github.com/gorilla/mux/LICENSE create mode 100644 vendor/src/github.com/gorilla/mux/README.md create mode 100644 vendor/src/github.com/gorilla/mux/doc.go create mode 100644 vendor/src/github.com/gorilla/mux/mux.go create mode 100644 vendor/src/github.com/gorilla/mux/regexp.go create mode 100644 vendor/src/github.com/gorilla/mux/route.go create mode 100644 vendor/src/github.com/hashicorp/consul/LICENSE create mode 100644 vendor/src/github.com/hashicorp/consul/api/README.md create mode 100644 vendor/src/github.com/hashicorp/consul/api/acl.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/agent.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/api.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/catalog.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/event.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/health.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/kv.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/lock.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/raw.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/semaphore.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/session.go create mode 100644 vendor/src/github.com/hashicorp/consul/api/status.go create mode 100644 vendor/src/github.com/hashicorp/consul/website/LICENSE.md create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/LICENSE create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/0doc.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/README.md create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/binc.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/decode.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/encode.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/helper.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/helper_internal.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack.go create mode 100755 vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack_test.py create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/rpc.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/simple.go create mode 100644 vendor/src/github.com/hashicorp/go-msgpack/codec/time.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/.gitignore create mode 100644 vendor/src/github.com/hashicorp/memberlist/LICENSE create mode 100644 vendor/src/github.com/hashicorp/memberlist/Makefile create mode 100644 vendor/src/github.com/hashicorp/memberlist/README.md create mode 100644 vendor/src/github.com/hashicorp/memberlist/broadcast.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/config.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/conflict_delegate.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/delegate.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/event_delegate.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/keyring.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/memberlist.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/merge_delegate.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/net.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/queue.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/security.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/state.go create mode 100644 vendor/src/github.com/hashicorp/memberlist/todo.md create mode 100644 vendor/src/github.com/hashicorp/memberlist/util.go create mode 100644 vendor/src/github.com/hashicorp/serf/LICENSE create mode 100644 vendor/src/github.com/hashicorp/serf/serf/broadcast.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/coalesce.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/coalesce_member.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/coalesce_user.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/config.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/conflict_delegate.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/delegate.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/event.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/event_delegate.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/internal_query.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/keymanager.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/lamport.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/merge_delegate.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/messages.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/query.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/serf.go create mode 100644 vendor/src/github.com/hashicorp/serf/serf/snapshot.go create mode 100644 vendor/src/github.com/hashicorp/serf/website/LICENSE.md create mode 100644 vendor/src/github.com/jfrazelle/go/.gitignore create mode 100644 vendor/src/github.com/jfrazelle/go/Makefile create mode 100644 vendor/src/github.com/jfrazelle/go/README.md create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/bench_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/decode.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/decode_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/encode.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/encode_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/example_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/fold.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/fold_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/indent.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/scanner.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/scanner_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/stream.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/stream_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/tagkey_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/tags.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/tags_test.go create mode 100644 vendor/src/github.com/jfrazelle/go/canonical/json/testdata/code.json.gz create mode 100644 vendor/src/github.com/jfrazelle/go/circle.yml create mode 100644 vendor/src/github.com/jfrazelle/go/patches/0001-Expose-Encoder.Canonical-and-MarshalCanonical-Handle.patch create mode 100644 vendor/src/github.com/jfrazelle/go/patches/0002-add-test-for-canonical-float-error.patch create mode 100644 vendor/src/github.com/jfrazelle/go/patches/0003-Encode-non-fatal-floats-as-integers-in-canonical-mod.patch create mode 100644 vendor/src/github.com/kr/pty/.gitignore create mode 100644 vendor/src/github.com/kr/pty/License create mode 100644 vendor/src/github.com/kr/pty/README.md create mode 100644 vendor/src/github.com/kr/pty/doc.go create mode 100644 vendor/src/github.com/kr/pty/ioctl.go create mode 100644 vendor/src/github.com/kr/pty/ioctl_bsd.go create mode 100755 vendor/src/github.com/kr/pty/mktypes.bash create mode 100644 vendor/src/github.com/kr/pty/pty_darwin.go create mode 100644 vendor/src/github.com/kr/pty/pty_freebsd.go create mode 100644 vendor/src/github.com/kr/pty/pty_linux.go create mode 100644 vendor/src/github.com/kr/pty/pty_unsupported.go create mode 100644 vendor/src/github.com/kr/pty/run.go create mode 100644 vendor/src/github.com/kr/pty/types.go create mode 100644 vendor/src/github.com/kr/pty/types_freebsd.go create mode 100644 vendor/src/github.com/kr/pty/util.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_386.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_amd64.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_arm.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_arm64.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_freebsd_386.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_freebsd_amd64.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_freebsd_arm.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_ppc64.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_ppc64le.go create mode 100644 vendor/src/github.com/kr/pty/ztypes_s390x.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/.gitignore create mode 100644 vendor/src/github.com/mattn/go-sqlite3/.travis.yml create mode 100644 vendor/src/github.com/mattn/go-sqlite3/LICENSE create mode 100644 vendor/src/github.com/mattn/go-sqlite3/README.md create mode 100644 vendor/src/github.com/mattn/go-sqlite3/backup.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/code/sqlite3-binding.c create mode 100644 vendor/src/github.com/mattn/go-sqlite3/code/sqlite3-binding.h create mode 100644 vendor/src/github.com/mattn/go-sqlite3/code/sqlite3ext.h create mode 100644 vendor/src/github.com/mattn/go-sqlite3/doc.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/error.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3-binding.c create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3-binding.h create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3_icu.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3_libsqlite3.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3_load_extension.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3_omit_load_extension.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3_other.go create mode 100644 vendor/src/github.com/mattn/go-sqlite3/sqlite3_windows.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/LICENSE create mode 100644 vendor/src/github.com/microsoft/hcsshim/activatelayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/copylayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/createcomputesystem.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/createlayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/createprocess.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/createsandboxlayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/deactivatelayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/destroylayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/exportlayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/getlayermountpath.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/getsharedbaseimages.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/guid.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/hcsshim.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/importlayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/layerexists.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/layerutils.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/nametoguid.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/preparelayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/resizeconsole.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/shutdowncomputesystem.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/startcomputesystem.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/terminatecomputesystem.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/terminateprocess.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/unpreparelayer.go create mode 100644 vendor/src/github.com/microsoft/hcsshim/waitprocess.go create mode 100644 vendor/src/github.com/mistifyio/go-zfs/.gitignore create mode 100644 vendor/src/github.com/mistifyio/go-zfs/CONTRIBUTING.md create mode 100644 vendor/src/github.com/mistifyio/go-zfs/LICENSE create mode 100644 vendor/src/github.com/mistifyio/go-zfs/README.md create mode 100644 vendor/src/github.com/mistifyio/go-zfs/error.go create mode 100644 vendor/src/github.com/mistifyio/go-zfs/utils.go create mode 100644 vendor/src/github.com/mistifyio/go-zfs/zfs.go create mode 100644 vendor/src/github.com/mistifyio/go-zfs/zpool.go create mode 100644 vendor/src/github.com/opencontainers/runc/LICENSE create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/README.md create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/SPEC.md create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/apparmor/apparmor.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/apparmor/apparmor_disabled.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/capabilities_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/cgroups.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/cgroups_unsupported.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/apply_raw.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/blkio.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/cpu.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/cpuacct.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/cpuset.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/devices.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/freezer.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/fs_unsupported.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/hugetlb.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/memory.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/name.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/net_cls.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/net_prio.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/perf_event.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/fs/utils.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/stats.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/systemd/apply_nosystemd.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/systemd/apply_systemd.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/cgroups/utils.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/compat_1.5_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/blkio_device.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/cgroup.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/config.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/config_unix.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/device.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/device_defaults.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/hugepage_limit.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/interface_priority_map.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/mount.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/namespaces.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/namespaces_syscall.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/namespaces_syscall_unsupported.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/namespaces_unix.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/namespaces_windows.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/network.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/configs/validate/config.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/console.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/console_freebsd.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/console_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/console_windows.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/container.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/container_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/container_nouserns_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/container_userns_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/criu_opts.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/criurpc/Makefile create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/criurpc/criurpc.pb.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/criurpc/criurpc.proto create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/devices/devices_unix.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/devices/devices_windows.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/devices/number.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/error.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/factory.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/factory_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/generic_error.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/init_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/label/label.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/label/label_selinux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/network_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/notify_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/nsenter/README.md create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/nsenter/nsenter.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/nsenter/nsenter_gccgo.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/nsenter/nsenter_unsupported.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/nsenter/nsexec.c create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/process.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/process_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/restored_process.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/rootfs_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/seccomp/config.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/seccomp/seccomp_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/seccomp/seccomp_unsupported.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/selinux/selinux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/setgroups_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/setns_init_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stacktrace/capture.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stacktrace/frame.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stacktrace/stacktrace.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/standard_init_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stats.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stats_freebsd.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stats_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/stats_windows.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/proc.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/setns_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/syscall_linux_386.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/syscall_linux_64.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/syscall_linux_arm.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/sysconfig.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/sysconfig_notcgo.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/system/xattrs_linux.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/user/MAINTAINERS create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/user/lookup.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/user/lookup_unix.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/user/lookup_unsupported.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/user/user.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/utils/utils.go create mode 100644 vendor/src/github.com/opencontainers/runc/libcontainer/utils/utils_unix.go create mode 100644 vendor/src/github.com/philhofer/fwd/README.md create mode 100644 vendor/src/github.com/philhofer/fwd/reader.go create mode 100644 vendor/src/github.com/philhofer/fwd/writer.go create mode 100644 vendor/src/github.com/philhofer/fwd/writer_appengine.go create mode 100644 vendor/src/github.com/philhofer/fwd/writer_unsafe.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/LICENSE create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/conn.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/constants.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/flw.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/lock.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/server_help.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/server_java.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/structs.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/tracer.go create mode 100644 vendor/src/github.com/samuel/go-zookeeper/zk/util.go create mode 100644 vendor/src/github.com/syndtr/gocapability/LICENSE create mode 100644 vendor/src/github.com/syndtr/gocapability/capability/capability.go create mode 100644 vendor/src/github.com/syndtr/gocapability/capability/capability_linux.go create mode 100644 vendor/src/github.com/syndtr/gocapability/capability/capability_noop.go create mode 100644 vendor/src/github.com/syndtr/gocapability/capability/enum.go create mode 100644 vendor/src/github.com/syndtr/gocapability/capability/enum_gen.go create mode 100644 vendor/src/github.com/syndtr/gocapability/capability/syscall_linux.go create mode 100644 vendor/src/github.com/tchap/go-patricia/LICENSE create mode 100644 vendor/src/github.com/tchap/go-patricia/patricia/children.go create mode 100644 vendor/src/github.com/tchap/go-patricia/patricia/patricia.go create mode 100644 vendor/src/github.com/tinylib/msgp/LICENSE create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/circular.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/defs.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/edit.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/elsize.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/errors.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/extension.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/integers.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/json.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/json_bytes.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/number.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/number_appengine.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/number_unsafe.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/read.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/read_bytes.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/size.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/write.go create mode 100644 vendor/src/github.com/tinylib/msgp/msgp/write_bytes.go create mode 100644 vendor/src/github.com/ugorji/go/LICENSE create mode 100644 vendor/src/github.com/ugorji/go/codec/0doc.go create mode 100644 vendor/src/github.com/ugorji/go/codec/README.md create mode 100644 vendor/src/github.com/ugorji/go/codec/binc.go create mode 100644 vendor/src/github.com/ugorji/go/codec/cbor.go create mode 100644 vendor/src/github.com/ugorji/go/codec/decode.go create mode 100644 vendor/src/github.com/ugorji/go/codec/encode.go create mode 100644 vendor/src/github.com/ugorji/go/codec/fast-path.generated.go create mode 100644 vendor/src/github.com/ugorji/go/codec/fast-path.go.tmpl create mode 100644 vendor/src/github.com/ugorji/go/codec/gen-dec-array.go.tmpl create mode 100644 vendor/src/github.com/ugorji/go/codec/gen-dec-map.go.tmpl create mode 100644 vendor/src/github.com/ugorji/go/codec/gen-helper.generated.go create mode 100644 vendor/src/github.com/ugorji/go/codec/gen-helper.go.tmpl create mode 100644 vendor/src/github.com/ugorji/go/codec/gen.generated.go create mode 100644 vendor/src/github.com/ugorji/go/codec/gen.go create mode 100644 vendor/src/github.com/ugorji/go/codec/helper.go create mode 100644 vendor/src/github.com/ugorji/go/codec/helper_internal.go create mode 100644 vendor/src/github.com/ugorji/go/codec/helper_not_unsafe.go create mode 100644 vendor/src/github.com/ugorji/go/codec/helper_unsafe.go create mode 100644 vendor/src/github.com/ugorji/go/codec/json.go create mode 100644 vendor/src/github.com/ugorji/go/codec/msgpack.go create mode 100644 vendor/src/github.com/ugorji/go/codec/noop.go create mode 100644 vendor/src/github.com/ugorji/go/codec/prebuild.go create mode 100755 vendor/src/github.com/ugorji/go/codec/prebuild.sh create mode 100644 vendor/src/github.com/ugorji/go/codec/rpc.go create mode 100644 vendor/src/github.com/ugorji/go/codec/simple.go create mode 100644 vendor/src/github.com/ugorji/go/codec/test-cbor-goldens.json create mode 100755 vendor/src/github.com/ugorji/go/codec/test.py create mode 100644 vendor/src/github.com/ugorji/go/codec/time.go create mode 100644 vendor/src/github.com/vaughan0/go-ini/LICENSE create mode 100644 vendor/src/github.com/vaughan0/go-ini/README.md create mode 100644 vendor/src/github.com/vaughan0/go-ini/ini.go create mode 100644 vendor/src/github.com/vaughan0/go-ini/test.ini create mode 100644 vendor/src/github.com/vbatts/tar-split/LICENSE create mode 100644 vendor/src/github.com/vbatts/tar-split/archive/tar/common.go create mode 100644 vendor/src/github.com/vbatts/tar-split/archive/tar/reader.go create mode 100644 vendor/src/github.com/vbatts/tar-split/archive/tar/stat_atim.go create mode 100644 vendor/src/github.com/vbatts/tar-split/archive/tar/stat_atimespec.go create mode 100644 vendor/src/github.com/vbatts/tar-split/archive/tar/stat_unix.go create mode 100644 vendor/src/github.com/vbatts/tar-split/archive/tar/writer.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/asm/README.md create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/asm/assemble.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/asm/disassemble.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/asm/doc.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/storage/doc.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/storage/entry.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/storage/getter.go create mode 100644 vendor/src/github.com/vbatts/tar-split/tar/storage/packer.go create mode 100644 vendor/src/github.com/vishvananda/netlink/.travis.yml create mode 100644 vendor/src/github.com/vishvananda/netlink/LICENSE create mode 100644 vendor/src/github.com/vishvananda/netlink/Makefile create mode 100644 vendor/src/github.com/vishvananda/netlink/README.md create mode 100644 vendor/src/github.com/vishvananda/netlink/addr.go create mode 100644 vendor/src/github.com/vishvananda/netlink/addr_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/link.go create mode 100644 vendor/src/github.com/vishvananda/netlink/link_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/neigh.go create mode 100644 vendor/src/github.com/vishvananda/netlink/neigh_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/netlink.go create mode 100644 vendor/src/github.com/vishvananda/netlink/netlink_unspecified.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/addr_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/link_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/nl_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/route_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/xfrm_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/xfrm_policy_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/nl/xfrm_state_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/protinfo.go create mode 100644 vendor/src/github.com/vishvananda/netlink/protinfo_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/route.go create mode 100644 vendor/src/github.com/vishvananda/netlink/route_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/xfrm.go create mode 100644 vendor/src/github.com/vishvananda/netlink/xfrm_policy.go create mode 100644 vendor/src/github.com/vishvananda/netlink/xfrm_policy_linux.go create mode 100644 vendor/src/github.com/vishvananda/netlink/xfrm_state.go create mode 100644 vendor/src/github.com/vishvananda/netlink/xfrm_state_linux.go create mode 100644 vendor/src/github.com/vishvananda/netns/LICENSE create mode 100644 vendor/src/github.com/vishvananda/netns/README.md create mode 100644 vendor/src/github.com/vishvananda/netns/netns.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux_386.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux_amd64.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux_arm.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux_arm64.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux_ppc64le.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_linux_s390x.go create mode 100644 vendor/src/github.com/vishvananda/netns/netns_unspecified.go create mode 100644 vendor/src/golang.org/x/net/LICENSE create mode 100644 vendor/src/golang.org/x/net/context/context.go create mode 100644 vendor/src/golang.org/x/net/websocket/client.go create mode 100644 vendor/src/golang.org/x/net/websocket/hybi.go create mode 100644 vendor/src/golang.org/x/net/websocket/server.go create mode 100644 vendor/src/golang.org/x/net/websocket/websocket.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/.gitignore create mode 100644 vendor/src/gopkg.in/fsnotify.v1/.travis.yml create mode 100644 vendor/src/gopkg.in/fsnotify.v1/AUTHORS create mode 100644 vendor/src/gopkg.in/fsnotify.v1/CHANGELOG.md create mode 100644 vendor/src/gopkg.in/fsnotify.v1/CONTRIBUTING.md create mode 100644 vendor/src/gopkg.in/fsnotify.v1/LICENSE create mode 100644 vendor/src/gopkg.in/fsnotify.v1/NotUsed.xcworkspace create mode 100644 vendor/src/gopkg.in/fsnotify.v1/README.md create mode 100644 vendor/src/gopkg.in/fsnotify.v1/circle.yml create mode 100644 vendor/src/gopkg.in/fsnotify.v1/fsnotify.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/inotify.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/inotify_poller.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/kqueue.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/open_mode_bsd.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/open_mode_darwin.go create mode 100644 vendor/src/gopkg.in/fsnotify.v1/windows.go create mode 100644 volume/drivers/adapter.go create mode 100644 volume/drivers/extpoint.go create mode 100644 volume/drivers/extpoint_test.go create mode 100644 volume/drivers/proxy.go create mode 100644 volume/drivers/proxy_test.go create mode 100644 volume/local/local.go create mode 100644 volume/local/local_test.go create mode 100644 volume/local/local_unix.go create mode 100644 volume/local/local_windows.go create mode 100644 volume/store/store.go create mode 100644 volume/store/store_test.go create mode 100644 volume/testutils/testutils.go create mode 100644 volume/volume.go diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000000..37abdef44f --- /dev/null +++ b/.dockerignore @@ -0,0 +1,2 @@ +bundles +.gopath diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000000..78d4f168ab --- /dev/null +++ b/.gitignore @@ -0,0 +1,39 @@ +# Docker project generated files to ignore +# if you want to ignore files created by your editor/tools, +# please consider a global .gitignore https://help.github.com/articles/ignoring-files +*.exe +*.exe~ +*.orig +*.rej +*.test +.*.swp +.DS_Store +.bashrc +.dotcloud +.flymake* +.git/ +.gopath/ +.hg/ +.vagrant* +Vagrantfile +a.out +autogen/ +bin +build_src +bundles/ +docker/docker +docs/AWS_S3_BUCKET +docs/GITCOMMIT +docs/GIT_BRANCH +docs/VERSION +docs/_build +docs/_static +docs/_templates +docs/changed-files +# generated by man/md2man-all.sh +man/man1 +man/man5 +man/man8 +pyenv +vendor/pkg/ +.docker diff --git a/.mailmap b/.mailmap new file mode 100644 index 0000000000..8348b4a810 --- /dev/null +++ b/.mailmap @@ -0,0 +1,171 @@ +# Generate AUTHORS: hack/generate-authors.sh + +# Tip for finding duplicates (besides scanning the output of AUTHORS for name +# duplicates that aren't also email duplicates): scan the output of: +# git log --format='%aE - %aN' | sort -uf +# +# For explanation on this file format: man git-shortlog + +Patrick Stapleton +Shishir Mahajan +Erwin van der Koogh +Ahmed Kamal +Tejesh Mehta +Cristian Staretu +Cristian Staretu +Cristian Staretu +Marcus Linke +Aleksandrs Fadins +Christopher Latham +Hu Keping +Wayne Chang +Chen Chao +Daehyeok Mun + + + + + + +Guillaume J. Charmes + + + + + +Thatcher Peskens +Thatcher Peskens +Thatcher Peskens dhrp +Jérôme Petazzoni jpetazzo +Jérôme Petazzoni +Joffrey F +Joffrey F +Joffrey F +Tim Terhorst +Andy Smith + + + + + + + + + +Walter Stanish + +Roberto Hashioka +Konstantin Pelykh +David Sissitka +Nolan Darilek + +Benoit Chesneau +Jordan Arentsen +Daniel Garcia +Miguel Angel Fernández +Bhiraj Butala +Faiz Khan +Victor Lyuboslavsky +Jean-Baptiste Barth +Matthew Mueller + +Shih-Yuan Lee +Daniel Mizyrycki root +Jean-Baptiste Dalido + + + + + + + + + + + + + + +Sven Dowideit +Sven Dowideit +Sven Dowideit +Sven Dowideit <¨SvenDowideit@home.org.au¨> +Sven Dowideit +Sven Dowideit + +Alexandr Morozov + +O.S. Tezer + +Roberto G. Hashioka + + + + + +Sridhar Ratnakumar +Sridhar Ratnakumar +Liang-Chi Hsieh +Aleksa Sarai +Will Weaver +Timothy Hobbs +Nathan LeClaire +Nathan LeClaire + + + + +Matthew Heon + + + +Francisco Carriedo + + + + + +Brian Goff + + + +Hollie Teal + + + +Jessica Frazelle Jessie Frazelle + + + + + +Thomas LEVEIL Thomas LÉVEIL + + +Antonio Murdaca +Antonio Murdaca +Antonio Murdaca +Darren Shepherd +Deshi Xiao +Deshi Xiao +Doug Davis +Jacob Atzen +Jeff Nickoloff + +John Howard (VM) John Howard +Madhu Venugopal +Mary Anthony +Mary Anthony moxiegirl +Mary Anthony +mattyw +resouer +AJ Bowen soulshake +AJ Bowen soulshake +Tibor Vass +Tibor Vass +Vincent Bernat +Yestin Sun +bin liu +John Howard (VM) jhowardmsft +Ankush Agarwal +Tangi COLIN tangicolin diff --git a/AUTHORS b/AUTHORS new file mode 100644 index 0000000000..cfc67e32fe --- /dev/null +++ b/AUTHORS @@ -0,0 +1,1033 @@ +# This file lists all individuals having contributed content to the repository. +# For how it is generated, see `hack/generate-authors.sh`. + +Aanand Prasad +Aaron Davidson +Aaron Feng +Aaron Huslage +Aaron Welch +Abel Muiño +Abhinav Ajgaonkar +Abhishek Chanda +Abin Shahab +Adam Miller +Adam Singer +Aditya +Adria Casas +Adrian Mouat +Adrien Folie +Ahmed Kamal +Ahmet Alp Balkan +Aidan Hobson Sayers +AJ Bowen +Al Tobey +alambike +Alan Thompson +Albert Callarisa +Albert Zhang +Aleksa Sarai +Aleksandrs Fadins +Alena Prokharchyk +Alessandro Boch +Alessio Biancalana +Alex Gaynor +Alex Warhawk +Alexander Boyd +Alexander Larsson +Alexander Morozov +Alexander Shopov +Alexandr Morozov +Alexey Guskov +Alexey Kotlyarov +Alexey Shamrin +Alexis THOMAS +Allen Madsen +almoehi +Alvin Richards +amangoel +Amit Bakshi +Amy Lindburg +Anand Patil +AnandkumarPatel +Anchal Agrawal +Anders Janmyr +Andre Dublin <81dublin@gmail.com> +Andrea Luzzardi +Andrea Turli +Andreas Köhler +Andreas Savvides +Andreas Tiefenthaler +Andrew C. Bodine +Andrew Clay Shafer +Andrew Duckworth +Andrew France +Andrew Kuklewicz +Andrew Macgregor +Andrew Martin +Andrew Munsell +Andrew Weiss +Andrew Williams +Andrews Medina +Andrey Petrov +Andrey Stolbovsky +André Martins +Andy Chambers +andy diller +Andy Goldstein +Andy Kipp +Andy Rothfusz +Andy Smith +Andy Wilson +Anes Hasicic +Ankush Agarwal +Anthony Baire +Anthony Bishopric +Anton Löfgren +Anton Nikitin +Anton Tiurin +Antonio Murdaca +Antony Messerli +apocas +ArikaChen +Arnaud Porterie +Arthur Barr +Arthur Gautier +Asbjørn Enge +averagehuman +Avi Das +Avi Miller +Barnaby Gray +Barry Allard +Bartłomiej Piotrowski +bdevloed +Ben Firshman +Ben Sargent +Ben Severson +Ben Toews +Ben Wiklund +Benjamin Atkin +Benoit Chesneau +Bernerd Schaefer +Bert Goethals +Bharath Thiruveedula +Bhiraj Butala +bin liu +Blake Geno +bobby abbott +boucher +Bouke Haarsma +Boyd Hemphill +Bradley Cicenas +Bradley Wright +Brandon Liu +Brandon Philips +Brandon Rhodes +Brendan Dixon +Brent Salisbury +Brett Kochendorfer +Brian (bex) Exelbierd +Brian DeHamer +Brian Dorsey +Brian Flad +Brian Goff +Brian McCallister +Brian Olsen +Brian Shumate +Brice Jaglin +Briehan Lombaard +Bruno Bigras +Bruno Binet +Bruno Gazzera +Bruno Renié +Bryan Bess +Bryan Boreham +Bryan Matsuo +Bryan Murphy +buddhamagnet +Burke Libbey +Byung Kang +Caleb Spare +Calen Pennington +Cameron Boehmer +Carl X. Su +Cary +Casey Bisson +Charles Hooper +Charles Lindsay +Charles Merriam +Charlie Lewis +Chen Chao +Chen Hanxiao +cheney90 +Chewey +Chia-liang Kao +chli +Chris Alfonso +Chris Armstrong +Chris Khoo +Chris Snow +Chris St. Pierre +Chris Stivers +Chris Wahl +chrismckinnel +Christian Berendt +Christian Simon +Christian Stefanescu +ChristoperBiscardi +Christophe Troestler +Christopher Currie +Christopher Latham +Christopher Rigor +Christy Perez +Chun Chen +Ciro S. Costa +Clayton Coleman +Coenraad Loubser +Colin Dunklau +Colin Rice +Colin Walters +Colm Hally +Cory Forsyth +cressie176 +Cristian Staretu +Cruceru Calin-Cristian +Cyril F +Daan van Berkel +Daehyeok Mun +Dafydd Crosby +dalanlan +Damjan Georgievski +Dan Anolik +Dan Buch +Dan Cotora +Dan Griffin +Dan Hirsch +Dan Keder +Dan McPherson +Dan Stine +Dan Walsh +Dan Williams +Daniel Antlinger +Daniel Exner +Daniel Farrell +Daniel Garcia +Daniel Gasienica +Daniel Menet +Daniel Mizyrycki +Daniel Nephin +Daniel Norberg +Daniel Nordberg +Daniel Robinson +Daniel S +Daniel Von Fange +Daniel YC Lin +Daniel Zhang +Daniel, Dao Quang Minh +Danny Berger +Danny Yates +Darren Coxall +Darren Shepherd +Dave Henderson +David Anderson +David Calavera +David Corking +David Davis +David Gageot +David Gebler +David Mackey +David Mat +David Mcanulty +David Pelaez +David R. Jenni +David Röthlisberger +David Sissitka +David Xia +David Young +Davide Ceretti +Dawn Chen +decadent +Deng Guangxing +Deni Bertovic +Derek +Derek +Derek McGowan +Deric Crago +Deshi Xiao +Dinesh Subhraveti +DiuDiugirl +Djibril Koné +dkumor +Dmitry Demeshchuk +Dmitry Gusev +Dmitry V. Krivenok +Dolph Mathews +Dominik Finkbeiner +Dominik Honnef +Don Kirkby +Don Kjer +Don Spaulding +Doug Davis +Doug MacEachern +doug tangren +Dr Nic Williams +dragon788 +Dražen Lučanin +Dustin Sallings +Ed Costello +Edmund Wagner +Eiichi Tsukata +Eike Herzbach +Eivind Uggedal +Elias Probst +Elijah Zupancic +eluck +Emil Hernvall +Emily Maier +Emily Rose +Emir Ozer +Enguerran +Eohyung Lee +Eric Hanchrow +Eric Lee +Eric Myhre +Eric Paris +Eric Rafaloff +Eric Windisch +Eric-Olivier Lamey +Erik Dubbelboer +Erik Hollensbe +Erik Inge Bolsø +Erik Kristensen +Erno Hopearuoho +Erwin van der Koogh +Euan +Eugene Yakubovich +eugenkrizo +Evan Carmi +Evan Hazlett +Evan Krall +Evan Phoenix +Evan Wies +Evgeny Vereshchagin +Eystein Måløy Stenberg +ezbercih +Fabiano Rosas +Fabio Falci +Fabio Rehm +Fabrizio Regini +Faiz Khan +falmp +Fareed Dudhia +Felix Rabe +Felix Schindler +Ferenc Szabo +Fernando +Filipe Brandenburger +Flavio Castelli +FLGMwt +Florian Weingarten +Francisco Carriedo +Francisco Souza +Frank Herrmann +Frank Macreery +Frank Rosquin +Fred Lifton +Frederick F. Kautz IV +Frederik Loeffert +Freek Kalter +Félix Baylac-Jacqué +Gabe Rosenhouse +Gabor Nagy +Gabriel Monroy +Galen Sampson +Gareth Rushgrove +Gaurav +gautam, prasanna +GennadySpb +Geoffrey Bachelet +George MacRorie +George Xie +Gereon Frey +German DZ +Gert van Valkenhoef +Gianluca Borello +Giuseppe Mazzotta +Gleb Fotengauer-Malinovskiy +Gleb M Borisov +Glyn Normington +Goffert van Gool +golubbe +Gosuke Miyashita +Graydon Hoare +Greg Fausak +Greg Thornton +grossws +grunny +Guilherme Salgado +Guillaume Dufour +Guillaume J. Charmes +guoxiuyan +Gurjeet Singh +Guruprasad +Günter Zöchbauer +Hans Rødtang +Harald Albers +Harley Laue +Harry Zhang +He Simei +Hector Castro +Henning Sprang +Hobofan +Hollie Teal +Hong Xu +Hu Keping +Hu Tao +Huayi Zhang +Hugo Duncan +Hunter Blanks +Huu Nguyen +hyeongkyu.lee +hyp3rdino +Ian Babrou +Ian Bishop +Ian Bull +Ian Calvert +Ian Main +Ian Truslove +Iavael +Igor Dolzhikov +ILYA Khlopotov +imre Fitos +inglesp +Isaac Dupree +Isabel Jimenez +Isao Jonas +Ivan Fraixedes +J Bruni +J. Nunn +Jack Danger Canty +Jacob Atzen +Jacob Edelman +Jake Champlin +Jake Moshenko +jakedt +James Allen +James Carr +James DeFelice +James Harrison Fisher +James Kyle +James Lal +James Mills +James Turnbull +Jamie Hannaford +Jamshid Afshar +Jan Keromnes +Jan Koprowski +Jan Pazdziora +Jan Toebes +Jan-Jaap Driessen +Jana Radhakrishnan +Jared Biel +Jaroslaw Zabiello +jaseg +Jason Divock +Jason Giedymin +Jason Hall +Jason Livesay +Jason McVetta +Jason Plum +Jason Shepherd +Jason Smith +Jason Sommer +Jason Stangroome +Jay +Jean-Baptiste Barth +Jean-Baptiste Dalido +Jean-Paul Calderone +Jean-Tiare Le Bigot +Jeff Anderson +Jeff Lindsay +Jeff Nickoloff +Jeff Welch +Jeffrey Bolle +Jeffrey Morgan +Jeffrey van Gogh +Jeremy Grosser +Jesse Dearing +Jesse Dubay +Jessica Frazelle +Jezeniel Zapanta +jianbosun +Jilles Oldenbeuving +Jim Alateras +Jim Perrin +Jimmy Cuadra +Jimmy Puckett +jimmyxian +Jinsoo Park +Jiri Popelka +Jiří Župka +jjy +jmzwcn +Joe Beda +Joe Ferguson +Joe Gordon +Joe Shaw +Joe Van Dyk +Joel Friedly +Joel Handwell +Joey Gibson +Joffrey F +Johan Euphrosine +Johan Rydberg +Johannes 'fish' Ziemke +John Costa +John Feminella +John Gardiner Myers +John Gossman +John Howard (VM) +John OBrien III +John Tims +John Warwick +John Willis +Jon Wedaman +Jonas Pfenniger +Jonathan A. Sternberg +Jonathan Boulle +Jonathan Camp +Jonathan Dowland +Jonathan McCrohan +Jonathan Mueller +Jonathan Pares +Jonathan Rudenberg +Joost Cassee +Jordan Arentsen +Jordan Sissel +Joseph Anthony Pasquale Holsten +Joseph Hager +Joseph Kern +Josh +Josh Hawn +Josh Poimboeuf +Josiah Kiehl +José Tomás Albornoz +JP +Julian Taylor +Julien Barbier +Julien Bordellier +Julien Dubois +Jun-Ru Chang +Justin Force +Justin Plock +Justin Simonelis +Jyrki Puttonen +Jérôme Petazzoni +Jörg Thalheim +Kamil Domanski +Karan Lyons +kargakis +Karl Grzeszczak +Katie McLaughlin +Kato Kazuyoshi +Katrina Owen +Kawsar Saiyeed +Keli Hu +Ken Cochrane +Ken ICHIKAWA +Kent Johnson +Kevin "qwazerty" Houdebert +Kevin Clark +Kevin J. Lynagh +Kevin Menard +Kevin Wallace +Kevin Yap +Keyvan Fatehi +kies +Kim BKC Carlbacker +Kimbro Staken +Kiran Gangadharan +Kirill SIbirev +knappe +Kohei Tsuruta +Konrad Kleine +Konstantin Pelykh +Krasimir Georgiev +krrg +Kyle Conroy +kyu +Lachlan Coote +Lajos Papp +Lakshan Perera +lalyos +Lance Chen +Lance Kinley +Lars Kellogg-Stedman +Lars R. Damerow +Laurie Voss +leeplay +Lei Jitang +Len Weincier +Leszek Kowalski +Levi Gross +Lewis Marshall +Lewis Peckover +Liana Lo +Liang-Chi Hsieh +limsy +Liu Hua +Lloyd Dewolf +Lokesh Mandvekar +Lorenz Leutgeb +Lorenzo Fontana +Louis Opter +Luis Martínez de Bartolomé Izquierdo +lukaspustina +lukemarsden +Lénaïc Huard +Ma Shimiao +Mabin +Madhu Venugopal +Mahesh Tiyyagura +malnick +Malte Janduda +Manfred Touron +Manfred Zabarauskas +Manuel Meurer +Manuel Woelker +Marc Abramowitz +Marc Kuo +Marc Tamsky +Marco Hennings +Marcus Farkas +Marcus Linke +Marcus Ramberg +Marek Goldmann +Marian Marinov +Marianna +Marius Voila +Mark Allen +Mark McGranaghan +Mark West +Marko Mikulicic +Marko Tibold +Markus Fix +Martijn Dwars +Martijn van Oosterhout +Martin Honermeyer +Martin Redmond +Mary Anthony +Masahito Zembutsu +Mason Malone +Mateusz Sulima +Mathias Monnerville +Mathieu Le Marec - Pasquet +Matt Apperson +Matt Bachmann +Matt Bentley +Matt Haggard +Matt McCormick +Matthew Heon +Matthew Mayer +Matthew Mueller +Matthew Riley +Matthias Klumpp +Matthias Kühnle +mattymo +mattyw +mauriyouth +Max Shytikov +Maxim Kulkin +Maxim Treskin +Maxime Petazzoni +Meaglith Ma +meejah +Megan Kostick +Mehul Kar +Mengdi Gao +Mert Yazıcıoğlu +Michael A. Smith +Michael Brown +Michael Chiang +Michael Crosby +Michael Gorsuch +Michael Hudson-Doyle +Michael Neale +Michael Prokop +Michael Scharf +Michael Stapelberg +Michael Steinert +Michael Thies +Michael West +Michal Fojtik +Michal Jemala +Michal Minar +Michaël Pailloncy +Michiel@unhosted +Miguel Angel Fernández +Mihai Borobocea +Mike Chelen +Mike Dillon +Mike Gaffney +Mike Leone +Mike MacCana +Mike Naberezny +Mike Snitzer +Mikhail Sobolev +Mingzhen Feng +Mitch Capper +Mohit Soni +Morgante Pell +Morten Siebuhr +Moysés Borges +Mrunal Patel +mschurenko +Mustafa Akın +Médi-Rémi Hashim +Nan Monnand Deng +Naoki Orii +Natalie Parker +Nate Eagleson +Nate Jones +Nathan Hsieh +Nathan Kleyn +Nathan LeClaire +Neal McBurnett +Nelson Chen +Nghia Tran +Niall O'Higgins +Nicholas E. Rabenau +Nick Irvine +Nick Parker +Nick Payne +Nick Stenning +Nick Stinemates +Nicolas De loof +Nicolas Dudebout +Nicolas Goy +Nicolas Kaiser +NikolaMandic +nikolas +noducks +Nolan Darilek +nponeccop +Nuutti Kotivuori +nzwsch +O.S. Tezer +OddBloke +odk- +Oguz Bilgic +Oh Jinkyun +Ole Reifschneider +Olivier Gambier +pandrew +panticz +Pascal Borreli +Pascal Hartig +Patrick Devine +Patrick Hemmer +Patrick Stapleton +pattichen +Paul +paul +Paul Annesley +Paul Bellamy +Paul Bowsher +Paul Hammond +Paul Jimenez +Paul Lietar +Paul Morie +Paul Nasrat +Paul Weaver +Pavel Lobashov +Pavel Tikhomirov +Pavlos Ratis +Peggy Li +Peter Bourgon +Peter Braden +Peter Choi +Peter Dave Hello +Peter Ericson +Peter Esbensen +Peter Salvatore +Peter Volpe +Peter Waller +Phil +Phil Estes +Phil Spitler +Philipp Weissensteiner +Phillip Alexander +Piergiuliano Bossi +Pierre +Pierre Wacrenier +Pierre-Alain RIVIERE +Piotr Bogdan +pixelistik +Porjo +Pradeep Chhetri +Prasanna Gautam +Przemek Hejman +pysqz +Qiang Huang +Quentin Brossard +r0n22 +Rafal Jeczalik +Rafe Colton +Raghuram Devarakonda +Rajat Pandit +Rajdeep Dua +Ralph Bean +Ramkumar Ramachandra +Ramon van Alteren +Recursive Madman +Remi Rampin +Renato Riccieri Santos Zannon +resouer +rgstephens +Rhys Hiltner +Rich Seymour +Richard +Richard Burnison +Richard Harvey +Richard Metzler +Richo Healey +Rick Bradley +Rick van de Loo +Rick Wieman +Rik Nijessen +Robert Bachmann +Robert Bittle +Robert Obryk +Roberto G. Hashioka +Robin Speekenbrink +robpc +Rodrigo Vaz +Roel Van Nyen +Roger Peppe +Rohit Jnagal +Roland Huß +Roland Moriz +Ron Smits +root +Rovanion Luckey +Rudolph Gottesheim +Ryan Anderson +Ryan Aslett +Ryan Detzel +Ryan Fowler +Ryan O'Donnell +Ryan Seto +Ryan Thomas +Rémy Greinhofer +s. rannou +s00318865 +Sabin Basyal +Sachin Joshi +Sam Abed +Sam Alba +Sam Bailey +Sam J Sharpe +Sam Reis +Sam Rijs +Sami Wagiaalla +Samuel Andaya +Samuel PHAN +Sankar சங்கர் +Sanket Saurav +sapphiredev +Satnam Singh +satoru +Satoshi Amemiya +Scott Bessler +Scott Collier +Scott Johnston +Scott Stamp +Scott Walls +sdreyesg +Sean Cronin +Sean P. Kane +Sebastiaan van Steenis +Sebastiaan van Stijn +Senthil Kumar Selvaraj +SeongJae Park +Seongyeol Lim +Sergey Alekseev +Sergey Evstifeev +Shane Canon +shaunol +Shawn Landden +Shawn Siefkas +Shih-Yuan Lee +Shijiang Wei +Shishir Mahajan +shuai-z +sidharthamani +Silas Sewell +Simei He +Simon Eskildsen +Simon Leinen +Simon Taranto +Sindhu S +Sjoerd Langkemper +Solomon Hykes +Song Gao +Soulou +Sridatta Thatipamala +Sridhar Ratnakumar +Srini Brahmaroutu +Srini Brahmaroutu +Steeve Morin +Stefan Praszalowicz +Stephen Crosby +Stephen J Day +Steve Francia +Steve Koch +Steven Burgess +Steven Merrill +Steven Richards +Steven Taylor +Sven Dowideit +Swapnil Daingade +Sylvain Baubeau +Sylvain Bellemare +Sébastien +Sébastien Luttringer +Sébastien Stormacq +tang0th +Tangi COLIN +Tatsuki Sugiura +Tatsushi Inagaki +Ted M. Young +Tehmasp Chaudhri +Tejesh Mehta +Thatcher Peskens +theadactyl +Thell 'Bo' Fowler +Thermionix +Thijs Terlouw +Thomas Bikeev +Thomas Frössman +Thomas Hansen +Thomas LEVEIL +Thomas Orozco +Thomas Schroeter +Thomas Sjögren +Thomas Texier +Tianon Gravi +Tibor Vass +Tiffany Low +Tim Bosse +Tim Hockin +Tim Ruffles +Tim Smith +Tim Terhorst +Timothy Hobbs +tjwebb123 +tobe +Tobias Bieniek +Tobias Gesellchen +Tobias Schmidt +Tobias Schwab +Todd Lunter +Todd Whiteman +Tom Fotherby +Tom Hulihan +Tom Maaswinkel +Tomas Tomecek +Tomasz Lipinski +Tomasz Nurkiewicz +Tommaso Visconti +Tomáš Hrčka +Tonis Tiigi +Tonny Xu +Tony Daws +Tony Miller +Torstein Husebø +tpng +Travis Cline +Travis Thieman +Trent Ogren +Tristan Carel +Tyler Brock +Tzu-Jung Lee +Ulysse Carion +unknown +vagrant +Vaidas Jablonskis +vgeta +Victor Coisne +Victor Lyuboslavsky +Victor Marmol +Victor Vieux +Viktor Vojnovski +Vincent Batts +Vincent Bernat +Vincent Bernat +Vincent Demeester +Vincent Giersch +Vincent Mayers +Vincent Woo +Vinod Kulkarni +Vishal Doshi +Vishnu Kannan +Vitor Monteiro +Vivek Agarwal +Vivek Dasgupta +Vivek Goyal +Vladimir Bulyga +Vladimir Kirillov +Vladimir Rutsky +VladimirAus +Vojtech Vitek (V-Teq) +waitingkuo +Walter Leibbrandt +Walter Stanish +Ward Vandewege +WarheadsSE +Wayne Chang +Wei-Ting Kuo +Wes Morgan +Will Dietz +Will Rouesnel +Will Weaver +willhf +William Delanoue +William Henry +William Riancho +William Thurston +WiseTrem +wlan0 +Wolfgang Powisch +wonderflow +xamyzhao +XiaoBing Jiang +Xinzi Zhou +Xiuming Chen +xuzhaokui +y00277921 +Yahya +YAMADA Tsuyoshi +Yan Feng +Yang Bai +Yasunori Mahata +Yestin Sun +Yihang Ho +Yohei Ueda +Yongzhi Pan +Yuan Sun +Yurii Rashkovskii +Zac Dover +Zach Borboa +Zain Memon +Zaiste! +Zane DeGraffenried +Zefan Li +Zen Lin(Zhinan Lin) +Zhang Wei +Zhang Wentao +Zilin Du +zimbatm +Zoltan Tombol +zqh +Álex González +Álvaro Lázaro +尹吉峰 diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000000..adfce8fd63 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,1996 @@ +# Changelog + +Items starting with `DEPRECATE` are important deprecation notices. For more +information on the list of deprecated flags and APIs please have a look at +https://docs.docker.com/misc/deprecated/ where target removal dates can also +be found. + +## 1.9.1 + +## Runtime + +- Do not prevent daemon from booting if images could not be restored (#17695) +- Force IPC mount to unmount on daemon shutdown/init (#17539) +- Turn IPC unmount errors into warnings (#17554) +- Fix `docker stats` performance regression (#17638) +- Clarify cryptic error message upon `docker logs` if `--log-driver=none` (#17767) +- Fix seldom panics (#17639, #17634, #17703) +- Fix opq whiteouts problems for files with dot prefix (#17819) +- devicemapper: try defaulting to xfs instead of ext4 for performance reasons (#17903, #17918) +- devicemapper: fix displayed fs in docker info (#17974) +- selinux: only relabel if user requested so with the `z` option (#17450, #17834) +- Do not make network calls when normalizing names (#18014) + +## Client + +- Fix `docker login` on windows (#17738) +- Fix bug with `docker inspect` output when not connected to daemon (#17715) +- Fix `docker inspect -f {{.HostConfig.Dns}} somecontainer` (#17680) + +## Builder + +- Fix regression with symlink behavior in ADD/COPY (#17710) + +## Networking + +- Allow passing a network ID as an argument for `--net` (#17558) +- Fix connect to host and prevent disconnect from host for `host` network (#17476) +- Fix `--fixed-cidr` issue when gateway ip falls in ip-range and ip-range is + not the first block in the network (#17853) +- Restore deterministic `IPv6` generation from `MAC` address on default `bridge` network (#17890) +- Allow port-mapping only for endpoints created on docker run (#17858) +- Fixed an endpoint delete issue with a possible stale sbox (#18102) + +## Distribution + +- Correct parent chain in v2 push when v1Compatibility files on the disk are inconsistent (#18047) + +## 1.9.0 (2015-11-03) + +## Runtime + ++ `docker stats` now returns block IO metrics (#15005) ++ `docker stats` now details network stats per interface (#15786) ++ Add `ancestor=` filter to `docker ps --filter` flag to filter +containers based on their ancestor images (#14570) ++ Add `label=` filter to `docker ps --filter` to filter containers +based on label (#16530) ++ Add `--kernel-memory` flag to `docker run` (#14006) ++ Add `--message` flag to `docker import` allowing to specify an optional +message (#15711) ++ Add `--privileged` flag to `docker exec` (#14113) ++ Add `--stop-signal` flag to `docker run` allowing to replace the container +process stopping signal (#15307) ++ Add a new `unless-stopped` restart policy (#15348) ++ Inspecting an image now returns tags (#13185) ++ Add container size information to `docker inspect` (#15796) ++ Add `RepoTags` and `RepoDigests` field to `/images/{name:.*}/json` (#17275) +- Remove the deprecated `/container/ps` endpoint from the API (#15972) +- Send and document correct HTTP codes for `/exec//start` (#16250) +- Share shm and mqueue between containers sharing IPC namespace (#15862) +- Event stream now shows OOM status when `--oom-kill-disable` is set (#16235) +- Ensure special network files (/etc/hosts etc.) are read-only if bind-mounted +with `ro` option (#14965) +- Improve `rmi` performance (#16890) +- Do not update /etc/hosts for the default bridge network, except for links (#17325) +- Fix conflict with duplicate container names (#17389) +- Fix an issue with incorrect template execution in `docker inspect` (#17284) +- DEPRECATE `-c` short flag variant for `--cpu-shares` in docker run (#16271) + +## Client + ++ Allow `docker import` to import from local files (#11907) + +## Builder + ++ Add a `STOPSIGNAL` Dockerfile instruction allowing to set a different +stop-signal for the container process (#15307) ++ Add an `ARG` Dockerfile instruction and a `--build-arg` flag to `docker build` +that allows to add build-time environment variables (#15182) +- Improve cache miss performance (#16890) + +## Storage + +- devicemapper: Implement deferred deletion capability (#16381) + +## Networking + ++ `docker network` exits experimental and is part of standard release (#16645) ++ New network top-level concept, with associated subcommands and API (#16645) + WARNING: the API is different from the experimental API ++ Support for multiple isolated/micro-segmented networks (#16645) ++ Built-in multihost networking using VXLAN based overlay driver (#14071) ++ Support for third-party network plugins (#13424) ++ Ability to dynamically connect containers to multiple networks (#16645) ++ Support for user-defined IP address management via pluggable IPAM drivers (#16910) ++ Add daemon flags `--cluster-store` and `--cluster-advertise` for built-in nodes discovery (#16229) ++ Add `--cluster-store-opt` for setting up TLS settings (#16644) ++ Add `--dns-opt` to the daemon (#16031) +- DEPRECATE following container `NetworkSettings` fields in API v1.21: `EndpointID`, `Gateway`, + `GlobalIPv6Address`, `GlobalIPv6PrefixLen`, `IPAddress`, `IPPrefixLen`, `IPv6Gateway` and `MacAddress`. + Those are now specific to the `bridge` network. Use `NetworkSettings.Networks` to inspect + the networking settings of a container per network. + +## Volumes + ++ New top-level `volume` subcommand and API (#14242) +- Move API volume driver settings to host-specific config (#15798) +- Print an error message if volume name is not unique (#16009) +- Ensure volumes created from Dockerfiles always use the local volume driver +(#15507) +- DEPRECATE auto-creating missing host paths for bind mounts (#16349) + +## Logging + ++ Add `awslogs` logging driver for Amazon CloudWatch (#15495) ++ Add generic `tag` log option to allow customizing container/image +information passed to driver (e.g. show container names) (#15384) +- Implement the `docker logs` endpoint for the journald driver (#13707) +- DEPRECATE driver-specific log tags (e.g. `syslog-tag`, etc.) (#15384) + +## Distribution + ++ `docker search` now works with partial names (#16509) +- Push optimization: avoid buffering to file (#15493) +- The daemon will display progress for images that were already being pulled +by another client (#15489) +- Only permissions required for the current action being performed are requested (#) ++ Renaming trust keys (and respective environment variables) from `offline` to +`root` and `tagging` to `repository` (#16894) +- DEPRECATE trust key environment variables +`DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE` and +`DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE` (#16894) + +## Security + ++ Add SELinux profiles to the rpm package (#15832) +- Fix various issues with AppArmor profiles provided in the deb package +(#14609) +- Add AppArmor policy that prevents writing to /proc (#15571) + +## 1.8.3 (2015-10-12) + +### Distribution + +- Fix layer IDs lead to local graph poisoning (CVE-2014-8178) +- Fix manifest validation and parsing logic errors allow pull-by-digest validation bypass (CVE-2014-8179) ++ Add `--disable-legacy-registry` to prevent a daemon from using a v1 registry + +## 1.8.2 (2015-09-10) + +### Distribution + +- Fixes rare edge case of handling GNU LongLink and LongName entries. +- Fix ^C on docker pull. +- Fix docker pull issues on client disconnection. +- Fix issue that caused the daemon to panic when loggers weren't configured properly. +- Fix goroutine leak pulling images from registry V2. + +### Runtime + +- Fix a bug mounting cgroups for docker daemons running inside docker containers. +- Initialize log configuration properly. + +### Client: + +- Handle `-q` flag in `docker ps` properly when there is a default format. + +### Networking + +- Fix several corner cases with netlink. + +### Contrib + +- Fix several issues with bash completion. + +## 1.8.1 (2015-08-12) + +### Distribution + +* Fix a bug where pushing multiple tags would result in invalid images + +## 1.8.0 (2015-08-11) + +### Distribution + ++ Trusted pull, push and build, disabled by default +* Make tar layers deterministic between registries +* Don't allow deleting the image of running containers +* Check if a tag name to load is a valid digest +* Allow one character repository names +* Add a more accurate error description for invalid tag name +* Make build cache ignore mtime + +### Cli + ++ Add support for DOCKER_CONFIG/--config to specify config file dir ++ Add --type flag for docker inspect command ++ Add formatting options to `docker ps` with `--format` ++ Replace `docker -d` with new subcommand `docker daemon` +* Zsh completion updates and improvements +* Add some missing events to bash completion +* Support daemon urls with base paths in `docker -H` +* Validate status= filter to docker ps +* Display when a container is in --net=host in docker ps +* Extend docker inspect to export image metadata related to graph driver +* Restore --default-gateway{,-v6} daemon options +* Add missing unpublished ports in docker ps +* Allow duration strings in `docker events` as --since/--until +* Expose more mounts information in `docker inspect` + +### Runtime + ++ Add new Fluentd logging driver ++ Allow `docker import` to load from local files ++ Add logging driver for GELF via UDP ++ Allow to copy files from host to containers with `docker cp` ++ Promote volume drivers from experimental to master ++ Add rollover options to json-file log driver, and --log-driver-opts flag ++ Add memory swappiness tuning options +* Remove cgroup read-only flag when privileged +* Make /proc, /sys, & /dev readonly for readonly containers +* Add cgroup bind mount by default +* Overlay: Export metadata for container and image in `docker inspect` +* Devicemapper: external device activation +* Devicemapper: Compare uuid of base device on startup +* Remove RC4 from the list of registry cipher suites +* Add syslog-facility option +* LXC execdriver compatibility with recent LXC versions +* Mark LXC execriver as deprecated (to be removed with the migration to runc) + +### Plugins + +* Separate plugin sockets and specs locations +* Allow TLS connections to plugins + +### Bug fixes + +- Add missing 'Names' field to /containers/json API output +- Make `docker rmi` of dangling images safe while pulling +- Devicemapper: Change default basesize to 100G +- Go Scheduler issue with sync.Mutex and gcc +- Fix issue where Search API endpoint would panic due to empty AuthConfig +- Set image canonical names correctly +- Check dockerinit only if lxc driver is used +- Fix ulimit usage of nproc +- Always attach STDIN if -i,--interactive is specified +- Show error messages when saving container state fails +- Fixed incorrect assumption on --bridge=none treated as disable network +- Check for invalid port specifications in host configuration +- Fix endpoint leave failure for --net=host mode +- Fix goroutine leak in the stats API if the container is not running +- Check for apparmor file before reading it +- Fix DOCKER_TLS_VERIFY being ignored +- Set umask to the default on startup +- Correct the message of pause and unpause a non-running container +- Adjust disallowed CpuShares in container creation +- ZFS: correctly apply selinux context +- Display empty string instead of when IP opt is nil +- `docker kill` returns error when container is not running +- Fix COPY/ADD quoted/json form +- Fix goroutine leak on logs -f with no output +- Remove panic in nat package on invalid hostport +- Fix container linking in Fedora 22 +- Fix error caused using default gateways outside of the allocated range +- Format times in inspect command with a template as RFC3339Nano +- Make registry client to accept 2xx and 3xx http status responses as successful +- Fix race issue that caused the daemon to crash with certain layer downloads failed in a specific order. +- Fix error when the docker ps format was not valid. +- Remove redundant ip forward check. +- Fix issue trying to push images to repository mirrors. +- Fix error cleaning up network entrypoints when there is an initialization issue. + +## 1.7.1 (2015-07-14) + +#### Runtime + +- Fix default user spawning exec process with `docker exec` +- Make `--bridge=none` not to configure the network bridge +- Publish networking stats properly +- Fix implicit devicemapper selection with static binaries +- Fix socket connections that hung intermittently +- Fix bridge interface creation on CentOS/RHEL 6.6 +- Fix local dns lookups added to resolv.conf +- Fix copy command mounting volumes +- Fix read/write privileges in volumes mounted with --volumes-from + +#### Remote API + +- Fix unmarshalling of Command and Entrypoint +- Set limit for minimum client version supported +- Validate port specification +- Return proper errors when attach/reattach fail + +#### Distribution + +- Fix pulling private images +- Fix fallback between registry V2 and V1 + +## 1.7.0 (2015-06-16) + +#### Runtime ++ Experimental feature: support for out-of-process volume plugins +* The userland proxy can be disabled in favor of hairpin NAT using the daemon’s `--userland-proxy=false` flag +* The `exec` command supports the `-u|--user` flag to specify the new process owner ++ Default gateway for containers can be specified daemon-wide using the `--default-gateway` and `--default-gateway-v6` flags ++ The CPU CFS (Completely Fair Scheduler) quota can be set in `docker run` using `--cpu-quota` ++ Container block IO can be controlled in `docker run` using`--blkio-weight` ++ ZFS support ++ The `docker logs` command supports a `--since` argument ++ UTS namespace can be shared with the host with `docker run --uts=host` + +#### Quality +* Networking stack was entirely rewritten as part of the libnetwork effort +* Engine internals refactoring +* Volumes code was entirely rewritten to support the plugins effort ++ Sending SIGUSR1 to a daemon will dump all goroutines stacks without exiting + +#### Build ++ Support ${variable:-value} and ${variable:+value} syntax for environment variables ++ Support resource management flags `--cgroup-parent`, `--cpu-period`, `--cpu-quota`, `--cpuset-cpus`, `--cpuset-mems` ++ git context changes with branches and directories +* The .dockerignore file support exclusion rules + +#### Distribution ++ Client support for v2 mirroring support for the official registry + +#### Bugfixes +* Firewalld is now supported and will automatically be used when available +* mounting --device recursively + +## 1.6.2 (2015-05-13) + +#### Runtime +- Revert change prohibiting mounting into /sys + +## 1.6.1 (2015-05-07) + +#### Security +- Fix read/write /proc paths (CVE-2015-3630) +- Prohibit VOLUME /proc and VOLUME / (CVE-2015-3631) +- Fix opening of file-descriptor 1 (CVE-2015-3627) +- Fix symlink traversal on container respawn allowing local privilege escalation (CVE-2015-3629) +- Prohibit mount of /sys + +#### Runtime +- Update AppArmor policy to not allow mounts + +## 1.6.0 (2015-04-07) + +#### Builder ++ Building images from an image ID ++ Build containers with resource constraints, ie `docker build --cpu-shares=100 --memory=1024m...` ++ `commit --change` to apply specified Dockerfile instructions while committing the image ++ `import --change` to apply specified Dockerfile instructions while importing the image ++ Builds no longer continue in the background when canceled with CTRL-C + +#### Client ++ Windows Support + +#### Runtime ++ Container and image Labels ++ `--cgroup-parent` for specifying a parent cgroup to place container cgroup within ++ Logging drivers, `json-file`, `syslog`, or `none` ++ Pulling images by ID ++ `--ulimit` to set the ulimit on a container ++ `--default-ulimit` option on the daemon which applies to all created containers (and overwritten by `--ulimit` on run) + +## 1.5.0 (2015-02-10) + +#### Builder ++ Dockerfile to use for a given `docker build` can be specified with the `-f` flag +* Dockerfile and .dockerignore files can be themselves excluded as part of the .dockerignore file, thus preventing modifications to these files invalidating ADD or COPY instructions cache +* ADD and COPY instructions accept relative paths +* Dockerfile `FROM scratch` instruction is now interpreted as a no-base specifier +* Improve performance when exposing a large number of ports + +#### Hack ++ Allow client-side only integration tests for Windows +* Include docker-py integration tests against Docker daemon as part of our test suites + +#### Packaging ++ Support for the new version of the registry HTTP API +* Speed up `docker push` for images with a majority of already existing layers +- Fixed contacting a private registry through a proxy + +#### Remote API ++ A new endpoint will stream live container resource metrics and can be accessed with the `docker stats` command ++ Containers can be renamed using the new `rename` endpoint and the associated `docker rename` command +* Container `inspect` endpoint show the ID of `exec` commands running in this container +* Container `inspect` endpoint show the number of times Docker auto-restarted the container +* New types of event can be streamed by the `events` endpoint: ‘OOM’ (container died with out of memory), ‘exec_create’, and ‘exec_start' +- Fixed returned string fields which hold numeric characters incorrectly omitting surrounding double quotes + +#### Runtime ++ Docker daemon has full IPv6 support ++ The `docker run` command can take the `--pid=host` flag to use the host PID namespace, which makes it possible for example to debug host processes using containerized debugging tools ++ The `docker run` command can take the `--read-only` flag to make the container’s root filesystem mounted as readonly, which can be used in combination with volumes to force a container’s processes to only write to locations that will be persisted ++ Container total memory usage can be limited for `docker run` using the `—memory-swap` flag +* Major stability improvements for devicemapper storage driver +* Better integration with host system: containers will reflect changes to the host's `/etc/resolv.conf` file when restarted +* Better integration with host system: per-container iptable rules are moved to the DOCKER chain +- Fixed container exiting on out of memory to return an invalid exit code + +#### Other +* The HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables are properly taken into account by the client when connecting to the Docker daemon + +## 1.4.1 (2014-12-15) + +#### Runtime +- Fix issue with volumes-from and bind mounts not being honored after create + +## 1.4.0 (2014-12-11) + +#### Notable Features since 1.3.0 ++ Set key=value labels to the daemon (displayed in `docker info`), applied with + new `-label` daemon flag ++ Add support for `ENV` in Dockerfile of the form: + `ENV name=value name2=value2...` ++ New Overlayfs Storage Driver ++ `docker info` now returns an `ID` and `Name` field ++ Filter events by event name, container, or image ++ `docker cp` now supports copying from container volumes +- Fixed `docker tag`, so it honors `--force` when overriding a tag for existing + image. + +## 1.3.3 (2014-12-11) + +#### Security +- Fix path traversal vulnerability in processing of absolute symbolic links (CVE-2014-9356) +- Fix decompression of xz image archives, preventing privilege escalation (CVE-2014-9357) +- Validate image IDs (CVE-2014-9358) + +#### Runtime +- Fix an issue when image archives are being read slowly + +#### Client +- Fix a regression related to stdin redirection +- Fix a regression with `docker cp` when destination is the current directory + +## 1.3.2 (2014-11-20) + +#### Security +- Fix tar breakout vulnerability +* Extractions are now sandboxed chroot +- Security options are no longer committed to images + +#### Runtime +- Fix deadlock in `docker ps -f exited=1` +- Fix a bug when `--volumes-from` references a container that failed to start + +#### Registry ++ `--insecure-registry` now accepts CIDR notation such as 10.1.0.0/16 +* Private registries whose IPs fall in the 127.0.0.0/8 range do no need the `--insecure-registry` flag +- Skip the experimental registry v2 API when mirroring is enabled + +## 1.3.1 (2014-10-28) + +#### Security +* Prevent fallback to SSL protocols < TLS 1.0 for client, daemon and registry ++ Secure HTTPS connection to registries with certificate verification and without HTTP fallback unless `--insecure-registry` is specified + +#### Runtime +- Fix issue where volumes would not be shared + +#### Client +- Fix issue with `--iptables=false` not automatically setting `--ip-masq=false` +- Fix docker run output to non-TTY stdout + +#### Builder +- Fix escaping `$` for environment variables +- Fix issue with lowercase `onbuild` Dockerfile instruction +- Restrict environment variable expansion to `ENV`, `ADD`, `COPY`, `WORKDIR`, `EXPOSE`, `VOLUME` and `USER` + +## 1.3.0 (2014-10-14) + +#### Notable features since 1.2.0 ++ Docker `exec` allows you to run additional processes inside existing containers ++ Docker `create` gives you the ability to create a container via the CLI without executing a process ++ `--security-opts` options to allow user to customize container labels and apparmor profiles ++ Docker `ps` filters +- Wildcard support to COPY/ADD ++ Move production URLs to get.docker.com from get.docker.io ++ Allocate IP address on the bridge inside a valid CIDR ++ Use drone.io for PR and CI testing ++ Ability to setup an official registry mirror ++ Ability to save multiple images with docker `save` + +## 1.2.0 (2014-08-20) + +#### Runtime ++ Make /etc/hosts /etc/resolv.conf and /etc/hostname editable at runtime ++ Auto-restart containers using policies ++ Use /var/lib/docker/tmp for large temporary files ++ `--cap-add` and `--cap-drop` to tweak what linux capability you want ++ `--device` to use devices in containers + +#### Client ++ `docker search` on private registries ++ Add `exited` filter to `docker ps --filter` +* `docker rm -f` now kills instead of stop ++ Support for IPv6 addresses in `--dns` flag + +#### Proxy ++ Proxy instances in separate processes +* Small bug fix on UDP proxy + +## 1.1.2 (2014-07-23) + +#### Runtime ++ Fix port allocation for existing containers ++ Fix containers restart on daemon restart + +#### Packaging ++ Fix /etc/init.d/docker issue on Debian + +## 1.1.1 (2014-07-09) + +#### Builder +* Fix issue with ADD + +## 1.1.0 (2014-07-03) + +#### Notable features since 1.0.1 ++ Add `.dockerignore` support ++ Pause containers during `docker commit` ++ Add `--tail` to `docker logs` + +#### Builder ++ Allow a tar file as context for `docker build` +* Fix issue with white-spaces and multi-lines in `Dockerfiles` + +#### Runtime +* Overall performance improvements +* Allow `/` as source of `docker run -v` +* Fix port allocation +* Fix bug in `docker save` +* Add links information to `docker inspect` + +#### Client +* Improve command line parsing for `docker commit` + +#### Remote API +* Improve status code for the `start` and `stop` endpoints + +## 1.0.1 (2014-06-19) + +#### Notable features since 1.0.0 +* Enhance security for the LXC driver + +#### Builder +* Fix `ONBUILD` instruction passed to grandchildren + +#### Runtime +* Fix events subscription +* Fix /etc/hostname file with host networking +* Allow `-h` and `--net=none` +* Fix issue with hotplug devices in `--privileged` + +#### Client +* Fix artifacts with events +* Fix a panic with empty flags +* Fix `docker cp` on Mac OS X + +#### Miscellaneous +* Fix compilation on Mac OS X +* Fix several races + +## 1.0.0 (2014-06-09) + +#### Notable features since 0.12.0 +* Production support + +## 0.12.0 (2014-06-05) + +#### Notable features since 0.11.0 +* 40+ various improvements to stability, performance and usability +* New `COPY` Dockerfile instruction to allow copying a local file from the context into the container without ever extracting if the file is a tar file +* Inherit file permissions from the host on `ADD` +* New `pause` and `unpause` commands to allow pausing and unpausing of containers using cgroup freezer +* The `images` command has a `-f`/`--filter` option to filter the list of images +* Add `--force-rm` to clean up after a failed build +* Standardize JSON keys in Remote API to CamelCase +* Pull from a docker run now assumes `latest` tag if not specified +* Enhance security on Linux capabilities and device nodes + +## 0.11.1 (2014-05-07) + +#### Registry +- Fix push and pull to private registry + +## 0.11.0 (2014-05-07) + +#### Notable features since 0.10.0 + +* SELinux support for mount and process labels +* Linked containers can be accessed by hostname +* Use the net `--net` flag to allow advanced network configuration such as host networking so that containers can use the host's network interfaces +* Add a ping endpoint to the Remote API to do healthchecks of your docker daemon +* Logs can now be returned with an optional timestamp +* Docker now works with registries that support SHA-512 +* Multiple registry endpoints are supported to allow registry mirrors + +## 0.10.0 (2014-04-08) + +#### Builder +- Fix printing multiple messages on a single line. Fixes broken output during builds. +- Follow symlinks inside container's root for ADD build instructions. +- Fix EXPOSE caching. + +#### Documentation +- Add the new options of `docker ps` to the documentation. +- Add the options of `docker restart` to the documentation. +- Update daemon docs and help messages for --iptables and --ip-forward. +- Updated apt-cacher-ng docs example. +- Remove duplicate description of --mtu from docs. +- Add missing -t and -v for `docker images` to the docs. +- Add fixes to the cli docs. +- Update libcontainer docs. +- Update images in docs to remove references to AUFS and LXC. +- Update the nodejs_web_app in the docs to use the new epel RPM address. +- Fix external link on security of containers. +- Update remote API docs. +- Add image size to history docs. +- Be explicit about binding to all interfaces in redis example. +- Document DisableNetwork flag in the 1.10 remote api. +- Document that `--lxc-conf` is lxc only. +- Add chef usage documentation. +- Add example for an image with multiple for `docker load`. +- Explain what `docker run -a` does in the docs. + +#### Contrib +- Add variable for DOCKER_LOGFILE to sysvinit and use append instead of overwrite in opening the logfile. +- Fix init script cgroup mounting workarounds to be more similar to cgroupfs-mount and thus work properly. +- Remove inotifywait hack from the upstart host-integration example because it's not necessary any more. +- Add check-config script to contrib. +- Fix fish shell completion. + +#### Hack +* Clean up "go test" output from "make test" to be much more readable/scannable. +* Exclude more "definitely not unit tested Go source code" directories from hack/make/test. ++ Generate md5 and sha256 hashes when building, and upload them via hack/release.sh. +- Include contributed completions in Ubuntu PPA. ++ Add cli integration tests. +* Add tweaks to the hack scripts to make them simpler. + +#### Remote API ++ Add TLS auth support for API. +* Move git clone from daemon to client. +- Fix content-type detection in docker cp. +* Split API into 2 go packages. + +#### Runtime +* Support hairpin NAT without going through Docker server. +- devicemapper: succeed immediately when removing non-existing devices. +- devicemapper: improve handling of devicemapper devices (add per device lock, increase sleep time and unlock while sleeping). +- devicemapper: increase timeout in waitClose to 10 seconds. +- devicemapper: ensure we shut down thin pool cleanly. +- devicemapper: pass info, rather than hash to activateDeviceIfNeeded, deactivateDevice, setInitialized, deleteDevice. +- devicemapper: avoid AB-BA deadlock. +- devicemapper: make shutdown better/faster. +- improve alpha sorting in mflag. +- Remove manual http cookie management because the cookiejar is being used. +- Use BSD raw mode on Darwin. Fixes nano, tmux and others. +- Add FreeBSD support for the client. +- Merge auth package into registry. +- Add deprecation warning for -t on `docker pull`. +- Remove goroutine leak on error. +- Update parseLxcInfo to comply with new lxc1.0 format. +- Fix attach exit on darwin. +- Improve deprecation message. +- Retry to retrieve the layer metadata up to 5 times for `docker pull`. +- Only unshare the mount namespace for execin. +- Merge existing config when committing. +- Disable daemon startup timeout. +- Fix issue #4681: add loopback interface when networking is disabled. +- Add failing test case for issue #4681. +- Send SIGTERM to child, instead of SIGKILL. +- Show the driver and the kernel version in `docker info` even when not in debug mode. +- Always symlink /dev/ptmx for libcontainer. This fixes console related problems. +- Fix issue caused by the absence of /etc/apparmor.d. +- Don't leave empty cidFile behind when failing to create the container. +- Mount cgroups automatically if they're not mounted already. +- Use mock for search tests. +- Update to double-dash everywhere. +- Move .dockerenv parsing to lxc driver. +- Move all bind-mounts in the container inside the namespace. +- Don't use separate bind mount for container. +- Always symlink /dev/ptmx for libcontainer. +- Don't kill by pid for other drivers. +- Add initial logging to libcontainer. +* Sort by port in `docker ps`. +- Move networking drivers into runtime top level package. ++ Add --no-prune to `docker rmi`. ++ Add time since exit in `docker ps`. +- graphdriver: add build tags. +- Prevent allocation of previously allocated ports & prevent improve port allocation. +* Add support for --since/--before in `docker ps`. +- Clean up container stop. ++ Add support for configurable dns search domains. +- Add support for relative WORKDIR instructions. +- Add --output flag for docker save. +- Remove duplication of DNS entries in config merging. +- Add cpuset.cpus to cgroups and native driver options. +- Remove docker-ci. +- Promote btrfs. btrfs is no longer considered experimental. +- Add --input flag to `docker load`. +- Return error when existing bridge doesn't match IP address. +- Strip comments before parsing line continuations to avoid interpreting instructions as comments. +- Fix TestOnlyLoopbackExistsWhenUsingDisableNetworkOption to ignore "DOWN" interfaces. +- Add systemd implementation of cgroups and make containers show up as systemd units. +- Fix commit and import when no repository is specified. +- Remount /var/lib/docker as --private to fix scaling issue. +- Use the environment's proxy when pinging the remote registry. +- Reduce error level from harmless errors. +* Allow --volumes-from to be individual files. +- Fix expanding buffer in StdCopy. +- Set error regardless of attach or stdin. This fixes #3364. +- Add support for --env-file to load environment variables from files. +- Symlink /etc/mtab and /proc/mounts. +- Allow pushing a single tag. +- Shut down containers cleanly at shutdown and wait forever for the containers to shut down. This makes container shutdown on daemon shutdown work properly via SIGTERM. +- Don't throw error when starting an already running container. +- Fix dynamic port allocation limit. +- remove setupDev from libcontainer. +- Add API version to `docker version`. +- Return correct exit code when receiving signal and make SIGQUIT quit without cleanup. +- Fix --volumes-from mount failure. +- Allow non-privileged containers to create device nodes. +- Skip login tests because of external dependency on a hosted service. +- Deprecate `docker images --tree` and `docker images --viz`. +- Deprecate `docker insert`. +- Include base abstraction for apparmor. This fixes some apparmor related problems on Ubuntu 14.04. +- Add specific error message when hitting 401 over HTTP on push. +- Fix absolute volume check. +- Remove volumes-from from the config. +- Move DNS options to hostconfig. +- Update the apparmor profile for libcontainer. +- Add deprecation notice for `docker commit -run`. + +## 0.9.1 (2014-03-24) + +#### Builder +- Fix printing multiple messages on a single line. Fixes broken output during builds. + +#### Documentation +- Fix external link on security of containers. + +#### Contrib +- Fix init script cgroup mounting workarounds to be more similar to cgroupfs-mount and thus work properly. +- Add variable for DOCKER_LOGFILE to sysvinit and use append instead of overwrite in opening the logfile. + +#### Hack +- Generate md5 and sha256 hashes when building, and upload them via hack/release.sh. + +#### Remote API +- Fix content-type detection in `docker cp`. + +#### Runtime +- Use BSD raw mode on Darwin. Fixes nano, tmux and others. +- Only unshare the mount namespace for execin. +- Retry to retrieve the layer metadata up to 5 times for `docker pull`. +- Merge existing config when committing. +- Fix panic in monitor. +- Disable daemon startup timeout. +- Fix issue #4681: add loopback interface when networking is disabled. +- Add failing test case for issue #4681. +- Send SIGTERM to child, instead of SIGKILL. +- Show the driver and the kernel version in `docker info` even when not in debug mode. +- Always symlink /dev/ptmx for libcontainer. This fixes console related problems. +- Fix issue caused by the absence of /etc/apparmor.d. +- Don't leave empty cidFile behind when failing to create the container. +- Improve deprecation message. +- Fix attach exit on darwin. +- devicemapper: improve handling of devicemapper devices (add per device lock, increase sleep time, unlock while sleeping). +- devicemapper: succeed immediately when removing non-existing devices. +- devicemapper: increase timeout in waitClose to 10 seconds. +- Remove goroutine leak on error. +- Update parseLxcInfo to comply with new lxc1.0 format. + +## 0.9.0 (2014-03-10) + +#### Builder +- Avoid extra mount/unmount during build. This fixes mount/unmount related errors during build. +- Add error to docker build --rm. This adds missing error handling. +- Forbid chained onbuild, `onbuild from` and `onbuild maintainer` triggers. +- Make `--rm` the default for `docker build`. + +#### Documentation +- Download the docker client binary for Mac over https. +- Update the titles of the install instructions & descriptions. +* Add instructions for upgrading boot2docker. +* Add port forwarding example in OS X install docs. +- Attempt to disentangle repository and registry. +- Update docs to explain more about `docker ps`. +- Update sshd example to use a Dockerfile. +- Rework some examples, including the Python examples. +- Update docs to include instructions for a container's lifecycle. +- Update docs documentation to discuss the docs branch. +- Don't skip cert check for an example & use HTTPS. +- Bring back the memory and swap accounting section which was lost when the kernel page was removed. +- Explain DNS warnings and how to fix them on systems running and using a local nameserver. + +#### Contrib +- Add Tanglu support for mkimage-debootstrap. +- Add SteamOS support for mkimage-debootstrap. + +#### Hack +- Get package coverage when running integration tests. +- Remove the Vagrantfile. This is being replaced with boot2docker. +- Fix tests on systems where aufs isn't available. +- Update packaging instructions and remove the dependency on lxc. + +#### Remote API +* Move code specific to the API to the api package. +- Fix header content type for the API. Makes all endpoints use proper content type. +- Fix registry auth & remove ping calls from CmdPush and CmdPull. +- Add newlines to the JSON stream functions. + +#### Runtime +* Do not ping the registry from the CLI. All requests to registries flow through the daemon. +- Check for nil information return in the lxc driver. This fixes panics with older lxc versions. +- Devicemapper: cleanups and fix for unmount. Fixes two problems which were causing unmount to fail intermittently. +- Devicemapper: remove directory when removing device. Directories don't get left behind when removing the device. +* Devicemapper: enable skip_block_zeroing. Improves performance by not zeroing blocks. +- Devicemapper: fix shutdown warnings. Fixes shutdown warnings concerning pool device removal. +- Ensure docker cp stream is closed properly. Fixes problems with files not being copied by `docker cp`. +- Stop making `tcp://` default to `127.0.0.1:4243` and remove the default port for tcp. +- Fix `--run` in `docker commit`. This makes `docker commit --run` work again. +- Fix custom bridge related options. This makes custom bridges work again. ++ Mount-bind the PTY as container console. This allows tmux/screen to run. ++ Add the pure Go libcontainer library to make it possible to run containers using only features of the Linux kernel. ++ Add native exec driver which uses libcontainer and make it the default exec driver. +- Add support for handling extended attributes in archives. +* Set the container MTU to be the same as the host MTU. ++ Add simple sha256 checksums for layers to speed up `docker push`. +* Improve kernel version parsing. +* Allow flag grouping (`docker run -it`). +- Remove chroot exec driver. +- Fix divide by zero to fix panic. +- Rewrite `docker rmi`. +- Fix docker info with lxc 1.0.0. +- Fix fedora tty with apparmor. +* Don't always append env vars, replace defaults with vars from config. +* Fix a goroutine leak. +* Switch to Go 1.2.1. +- Fix unique constraint error checks. +* Handle symlinks for Docker's data directory and for TMPDIR. +- Add deprecation warnings for flags (-flag is deprecated in favor of --flag) +- Add apparmor profile for the native execution driver. +* Move system specific code from archive to pkg/system. +- Fix duplicate signal for `docker run -i -t` (issue #3336). +- Return correct process pid for lxc. +- Add a -G option to specify the group which unix sockets belong to. ++ Add `-f` flag to `docker rm` to force removal of running containers. ++ Kill ghost containers and restart all ghost containers when the docker daemon restarts. ++ Add `DOCKER_RAMDISK` environment variable to make Docker work when the root is on a ramdisk. + +## 0.8.1 (2014-02-18) + +#### Builder + +- Avoid extra mount/unmount during build. This removes an unneeded mount/unmount operation which was causing problems with devicemapper +- Fix regression with ADD of tar files. This stops Docker from decompressing tarballs added via ADD from the local file system +- Add error to `docker build --rm`. This adds a missing error check to ensure failures to remove containers are detected and reported + +#### Documentation + +* Update issue filing instructions +* Warn against the use of symlinks for Docker's storage folder +* Replace the Firefox example with an IceWeasel example +* Rewrite the PostgresSQL example using a Dockerfile and add more details to it +* Improve the OS X documentation + +#### Remote API + +- Fix broken images API for version less than 1.7 +- Use the right encoding for all API endpoints which return JSON +- Move remote api client to api/ +- Queue calls to the API using generic socket wait + +#### Runtime + +- Fix the use of custom settings for bridges and custom bridges +- Refactor the devicemapper code to avoid many mount/unmount race conditions and failures +- Remove two panics which could make Docker crash in some situations +- Don't ping registry from the CLI client +- Enable skip_block_zeroing for devicemapper. This stops devicemapper from always zeroing entire blocks +- Fix --run in `docker commit`. This makes docker commit store `--run` in the image configuration +- Remove directory when removing devicemapper device. This cleans up leftover mount directories +- Drop NET_ADMIN capability for non-privileged containers. Unprivileged containers can't change their network configuration +- Ensure `docker cp` stream is closed properly +- Avoid extra mount/unmount during container registration. This removes an unneeded mount/unmount operation which was causing problems with devicemapper +- Stop allowing tcp:// as a default tcp bin address which binds to 127.0.0.1:4243 and remove the default port ++ Mount-bind the PTY as container console. This allows tmux and screen to run in a container +- Clean up archive closing. This fixes and improves archive handling +- Fix engine tests on systems where temp directories are symlinked +- Add test methods for save and load +- Avoid temporarily unmounting the container when restarting it. This fixes a race for devicemapper during restart +- Support submodules when building from a GitHub repository +- Quote volume path to allow spaces +- Fix remote tar ADD behavior. This fixes a regression which was causing Docker to extract tarballs + +## 0.8.0 (2014-02-04) + +#### Notable features since 0.7.0 + +* Images and containers can be removed much faster +* Building an image from source with docker build is now much faster +* The Docker daemon starts and stops much faster +* The memory footprint of many common operations has been reduced, by streaming files instead of buffering them in memory, fixing memory leaks, and fixing various suboptimal memory allocations +* Several race conditions were fixed, making Docker more stable under very high concurrency load. This makes Docker more stable and less likely to crash and reduces the memory footprint of many common operations +* All packaging operations are now built on the Go language’s standard tar implementation, which is bundled with Docker itself. This makes packaging more portable across host distributions, and solves several issues caused by quirks and incompatibilities between different distributions of tar +* Docker can now create, remove and modify larger numbers of containers and images graciously thanks to more aggressive releasing of system resources. For example the storage driver API now allows Docker to do reference counting on mounts created by the drivers +With the ongoing changes to the networking and execution subsystems of docker testing these areas have been a focus of the refactoring. By moving these subsystems into separate packages we can test, analyze, and monitor coverage and quality of these packages +* Many components have been separated into smaller sub-packages, each with a dedicated test suite. As a result the code is better-tested, more readable and easier to change + +* The ADD instruction now supports caching, which avoids unnecessarily re-uploading the same source content again and again when it hasn’t changed +* The new ONBUILD instruction adds to your image a “trigger” instruction to be executed at a later time, when the image is used as the base for another build +* Docker now ships with an experimental storage driver which uses the BTRFS filesystem for copy-on-write +* Docker is officially supported on Mac OS X +* The Docker daemon supports systemd socket activation + +## 0.7.6 (2014-01-14) + +#### Builder + +* Do not follow symlink outside of build context + +#### Runtime + +- Remount bind mounts when ro is specified +* Use https for fetching docker version + +#### Other + +* Inline the test.docker.io fingerprint +* Add ca-certificates to packaging documentation + +## 0.7.5 (2014-01-09) + +#### Builder + +* Disable compression for build. More space usage but a much faster upload +- Fix ADD caching for certain paths +- Do not compress archive from git build + +#### Documentation + +- Fix error in GROUP add example +* Make sure the GPG fingerprint is inline in the documentation +* Give more specific advice on setting up signing of commits for DCO + +#### Runtime + +- Fix misspelled container names +- Do not add hostname when networking is disabled +* Return most recent image from the cache by date +- Return all errors from docker wait +* Add Content-Type Header "application/json" to GET /version and /info responses + +#### Other + +* Update DCO to version 1.1 ++ Update Makefile to use "docker:GIT_BRANCH" as the generated image name +* Update Travis to check for new 1.1 DCO version + +## 0.7.4 (2014-01-07) + +#### Builder + +- Fix ADD caching issue with . prefixed path +- Fix docker build on devicemapper by reverting sparse file tar option +- Fix issue with file caching and prevent wrong cache hit +* Use same error handling while unmarshalling CMD and ENTRYPOINT + +#### Documentation + +* Simplify and streamline Amazon Quickstart +* Install instructions use unprefixed Fedora image +* Update instructions for mtu flag for Docker on GCE ++ Add Ubuntu Saucy to installation +- Fix for wrong version warning on master instead of latest + +#### Runtime + +- Only get the image's rootfs when we need to calculate the image size +- Correctly handle unmapping UDP ports +* Make CopyFileWithTar use a pipe instead of a buffer to save memory on docker build +- Fix login message to say pull instead of push +- Fix "docker load" help by removing "SOURCE" prompt and mentioning STDIN +* Make blank -H option default to the same as no -H was sent +* Extract cgroups utilities to own submodule + +#### Other + ++ Add Travis CI configuration to validate DCO and gofmt requirements ++ Add Developer Certificate of Origin Text +* Upgrade VBox Guest Additions +* Check standalone header when pinging a registry server + +## 0.7.3 (2014-01-02) + +#### Builder + ++ Update ADD to use the image cache, based on a hash of the added content +* Add error message for empty Dockerfile + +#### Documentation + +- Fix outdated link to the "Introduction" on www.docker.io ++ Update the docs to get wider when the screen does +- Add information about needing to install LXC when using raw binaries +* Update Fedora documentation to disentangle the docker and docker.io conflict +* Add a note about using the new `-mtu` flag in several GCE zones ++ Add FrugalWare installation instructions ++ Add a more complete example of `docker run` +- Fix API documentation for creating and starting Privileged containers +- Add missing "name" parameter documentation on "/containers/create" +* Add a mention of `lxc-checkconfig` as a way to check for some of the necessary kernel configuration +- Update the 1.8 API documentation with some additions that were added to the docs for 1.7 + +#### Hack + +- Add missing libdevmapper dependency to the packagers documentation +* Update minimum Go requirement to a hard line at Go 1.2+ +* Many minor improvements to the Vagrantfile ++ Add ability to customize dockerinit search locations when compiling (to be used very sparingly only by packagers of platforms who require a nonstandard location) ++ Add coverprofile generation reporting +- Add `-a` to our Go build flags, removing the need for recompiling the stdlib manually +* Update Dockerfile to be more canonical and have less spurious warnings during build +- Fix some miscellaneous `docker pull` progress bar display issues +* Migrate more miscellaneous packages under the "pkg" folder +* Update TextMate highlighting to automatically be enabled for files named "Dockerfile" +* Reorganize syntax highlighting files under a common "contrib/syntax" directory +* Update install.sh script (https://get.docker.io/) to not fail if busybox fails to download or run at the end of the Ubuntu/Debian installation +* Add support for container names in bash completion + +#### Packaging + ++ Add an official Docker client binary for Darwin (Mac OS X) +* Remove empty "Vendor" string and added "License" on deb package ++ Add a stubbed version of "/etc/default/docker" in the deb package + +#### Runtime + +* Update layer application to extract tars in place, avoiding file churn while handling whiteouts +- Fix permissiveness of mtime comparisons in tar handling (since GNU tar and Go tar do not yet support sub-second mtime precision) +* Reimplement `docker top` in pure Go to work more consistently, and even inside Docker-in-Docker (thus removing the shell injection vulnerability present in some versions of `lxc-ps`) ++ Update `-H unix://` to work similarly to `-H tcp://` by inserting the default values for missing portions +- Fix more edge cases regarding dockerinit and deleted or replaced docker or dockerinit files +* Update container name validation to include '.' +- Fix use of a symlink or non-absolute path as the argument to `-g` to work as expected +* Update to handle external mounts outside of LXC, fixing many small mounting quirks and making future execution backends and other features simpler +* Update to use proper box-drawing characters everywhere in `docker images -tree` +* Move MTU setting from LXC configuration to directly use netlink +* Add `-S` option to external tar invocation for more efficient spare file handling ++ Add arch/os info to User-Agent string, especially for registry requests ++ Add `-mtu` option to Docker daemon for configuring MTU +- Fix `docker build` to exit with a non-zero exit code on error ++ Add `DOCKER_HOST` environment variable to configure the client `-H` flag without specifying it manually for every invocation + +## 0.7.2 (2013-12-16) + +#### Runtime + ++ Validate container names on creation with standard regex +* Increase maximum image depth to 127 from 42 +* Continue to move api endpoints to the job api ++ Add -bip flag to allow specification of dynamic bridge IP via CIDR +- Allow bridge creation when ipv6 is not enabled on certain systems +* Set hostname and IP address from within dockerinit +* Drop capabilities from within dockerinit +- Fix volumes on host when symlink is present the image +- Prevent deletion of image if ANY container is depending on it even if the container is not running +* Update docker push to use new progress display +* Use os.Lstat to allow mounting unix sockets when inspecting volumes +- Adjust handling of inactive user login +- Add missing defines in devicemapper for older kernels +- Allow untag operations with no container validation +- Add auth config to docker build + +#### Documentation + +* Add more information about Docker logging ++ Add RHEL documentation +* Add a direct example for changing the CMD that is run in a container +* Update Arch installation documentation ++ Add section on Trusted Builds ++ Add Network documentation page + +#### Other + ++ Add new cover bundle for providing code coverage reporting +* Separate integration tests in bundles +* Make Tianon the hack maintainer +* Update mkimage-debootstrap with more tweaks for keeping images small +* Use https to get the install script +* Remove vendored dotcloud/tar now that Go 1.2 has been released + +## 0.7.1 (2013-12-05) + +#### Documentation + ++ Add @SvenDowideit as documentation maintainer ++ Add links example ++ Add documentation regarding ambassador pattern ++ Add Google Cloud Platform docs ++ Add dockerfile best practices +* Update doc for RHEL +* Update doc for registry +* Update Postgres examples +* Update doc for Ubuntu install +* Improve remote api doc + +#### Runtime + ++ Add hostconfig to docker inspect ++ Implement `docker log -f` to stream logs ++ Add env variable to disable kernel version warning ++ Add -format to `docker inspect` ++ Support bind-mount for files +- Fix bridge creation on RHEL +- Fix image size calculation +- Make sure iptables are called even if the bridge already exists +- Fix issue with stderr only attach +- Remove init layer when destroying a container +- Fix same port binding on different interfaces +- `docker build` now returns the correct exit code +- Fix `docker port` to display correct port +- `docker build` now check that the dockerfile exists client side +- `docker attach` now returns the correct exit code +- Remove the name entry when the container does not exist + +#### Registry + +* Improve progress bars, add ETA for downloads +* Simultaneous pulls now waits for the first to finish instead of failing +- Tag only the top-layer image when pushing to registry +- Fix issue with offline image transfer +- Fix issue preventing using ':' in password for registry + +#### Other + ++ Add pprof handler for debug ++ Create a Makefile +* Use stdlib tar that now includes fix +* Improve make.sh test script +* Handle SIGQUIT on the daemon +* Disable verbose during tests +* Upgrade to go1.2 for official build +* Improve unit tests +* The test suite now runs all tests even if one fails +* Refactor C in Go (Devmapper) +- Fix OS X compilation + +## 0.7.0 (2013-11-25) + +#### Notable features since 0.6.0 + +* Storage drivers: choose from aufs, device-mapper, or vfs. +* Standard Linux support: docker now runs on unmodified Linux kernels and all major distributions. +* Links: compose complex software stacks by connecting containers to each other. +* Container naming: organize your containers by giving them memorable names. +* Advanced port redirects: specify port redirects per interface, or keep sensitive ports private. +* Offline transfer: push and pull images to the filesystem without losing information. +* Quality: numerous bugfixes and small usability improvements. Significant increase in test coverage. + +## 0.6.7 (2013-11-21) + +#### Runtime + +* Improve stability, fixes some race conditions +* Skip the volumes mounted when deleting the volumes of container. +* Fix layer size computation: handle hard links correctly +* Use the work Path for docker cp CONTAINER:PATH +* Fix tmp dir never cleanup +* Speedup docker ps +* More informative error message on name collisions +* Fix nameserver regex +* Always return long id's +* Fix container restart race condition +* Keep published ports on docker stop;docker start +* Fix container networking on Fedora +* Correctly express "any address" to iptables +* Fix network setup when reconnecting to ghost container +* Prevent deletion if image is used by a running container +* Lock around read operations in graph + +#### RemoteAPI + +* Return full ID on docker rmi + +#### Client + ++ Add -tree option to images ++ Offline image transfer +* Exit with status 2 on usage error and display usage on stderr +* Do not forward SIGCHLD to container +* Use string timestamp for docker events -since + +#### Other + +* Update to go 1.2rc5 ++ Add /etc/default/docker support to upstart + +## 0.6.6 (2013-11-06) + +#### Runtime + +* Ensure container name on register +* Fix regression in /etc/hosts ++ Add lock around write operations in graph +* Check if port is valid +* Fix restart runtime error with ghost container networking ++ Add some more colors and animals to increase the pool of generated names +* Fix issues in docker inspect ++ Escape apparmor confinement ++ Set environment variables using a file. +* Prevent docker insert to erase something ++ Prevent DNS server conflicts in CreateBridgeIface ++ Validate bind mounts on the server side ++ Use parent image config in docker build +* Fix regression in /etc/hosts + +#### Client + ++ Add -P flag to publish all exposed ports ++ Add -notrunc and -q flags to docker history +* Fix docker commit, tag and import usage ++ Add stars, trusted builds and library flags in docker search +* Fix docker logs with tty + +#### RemoteAPI + +* Make /events API send headers immediately +* Do not split last column docker top ++ Add size to history + +#### Other + ++ Contrib: Desktop integration. Firefox usecase. ++ Dockerfile: bump to go1.2rc3 + +## 0.6.5 (2013-10-29) + +#### Runtime + ++ Containers can now be named ++ Containers can now be linked together for service discovery ++ 'run -a', 'start -a' and 'attach' can forward signals to the container for better integration with process supervisors ++ Automatically start crashed containers after a reboot ++ Expose IP, port, and proto as separate environment vars for container links +* Allow ports to be published to specific ips +* Prohibit inter-container communication by default +- Ignore ErrClosedPipe for stdin in Container.Attach +- Remove unused field kernelVersion +* Fix issue when mounting subdirectories of /mnt in container +- Fix untag during removal of images +* Check return value of syscall.Chdir when changing working directory inside dockerinit + +#### Client + +- Only pass stdin to hijack when needed to avoid closed pipe errors +* Use less reflection in command-line method invocation +- Monitor the tty size after starting the container, not prior +- Remove useless os.Exit() calls after log.Fatal + +#### Hack + ++ Add initial init scripts library and a safer Ubuntu packaging script that works for Debian +* Add -p option to invoke debootstrap with http_proxy +- Update install.sh with $sh_c to get sudo/su for modprobe +* Update all the mkimage scripts to use --numeric-owner as a tar argument +* Update hack/release.sh process to automatically invoke hack/make.sh and bail on build and test issues + +#### Other + +* Documentation: Fix the flags for nc in example +* Testing: Remove warnings and prevent mount issues +- Testing: Change logic for tty resize to avoid warning in tests +- Builder: Fix race condition in docker build with verbose output +- Registry: Fix content-type for PushImageJSONIndex method +* Contrib: Improve helper tools to generate debian and Arch linux server images + +## 0.6.4 (2013-10-16) + +#### Runtime + +- Add cleanup of container when Start() fails +* Add better comments to utils/stdcopy.go +* Add utils.Errorf for error logging ++ Add -rm to docker run for removing a container on exit +- Remove error messages which are not actually errors +- Fix `docker rm` with volumes +- Fix some error cases where a HTTP body might not be closed +- Fix panic with wrong dockercfg file +- Fix the attach behavior with -i +* Record termination time in state. +- Use empty string so TempDir uses the OS's temp dir automatically +- Make sure to close the network allocators ++ Autorestart containers by default +* Bump vendor kr/pty to commit 3b1f6487b `(syscall.O_NOCTTY)` +* lxc: Allow set_file_cap capability in container +- Move run -rm to the cli only +* Split stdout stderr +* Always create a new session for the container + +#### Testing + +- Add aggregated docker-ci email report +- Add cleanup to remove leftover containers +* Add nightly release to docker-ci +* Add more tests around auth.ResolveAuthConfig +- Remove a few errors in tests +- Catch errClosing error when TCP and UDP proxies are terminated +* Only run certain tests with TESTFLAGS='-run TestName' make.sh +* Prevent docker-ci to test closing PRs +* Replace panic by log.Fatal in tests +- Increase TestRunDetach timeout + +#### Documentation + +* Add initial draft of the Docker infrastructure doc +* Add devenvironment link to CONTRIBUTING.md +* Add `apt-get install curl` to Ubuntu docs +* Add explanation for export restrictions +* Add .dockercfg doc +* Remove Gentoo install notes about #1422 workaround +* Fix help text for -v option +* Fix Ping endpoint documentation +- Fix parameter names in docs for ADD command +- Fix ironic typo in changelog +* Various command fixes in postgres example +* Document how to edit and release docs +- Minor updates to `postgresql_service.rst` +* Clarify LGTM process to contributors +- Corrected error in the package name +* Document what `vagrant up` is actually doing ++ improve doc search results +* Cleanup whitespace in API 1.5 docs +* use angle brackets in MAINTAINER example email +* Update archlinux.rst ++ Changes to a new style for the docs. Includes version switcher. +* Formatting, add information about multiline json +* Improve registry and index REST API documentation +- Replace deprecated upgrading reference to docker-latest.tgz, which hasn't been updated since 0.5.3 +* Update Gentoo installation documentation now that we're in the portage tree proper +* Cleanup and reorganize docs and tooling for contributors and maintainers +- Minor spelling correction of protocoll -> protocol + +#### Contrib + +* Add vim syntax highlighting for Dockerfiles from @honza +* Add mkimage-arch.sh +* Reorganize contributed completion scripts to add zsh completion + +#### Hack + +* Add vagrant user to the docker group +* Add proper bash completion for "docker push" +* Add xz utils as a runtime dep +* Add cleanup/refactor portion of #2010 for hack and Dockerfile updates ++ Add contrib/mkimage-centos.sh back (from #1621), and associated documentation link +* Add several of the small make.sh fixes from #1920, and make the output more consistent and contributor-friendly ++ Add @tianon to hack/MAINTAINERS +* Improve network performance for VirtualBox +* Revamp install.sh to be usable by more people, and to use official install methods whenever possible (apt repo, portage tree, etc.) +- Fix contrib/mkimage-debian.sh apt caching prevention ++ Add Dockerfile.tmLanguage to contrib +* Configured FPM to make /etc/init/docker.conf a config file +* Enable SSH Agent forwarding in Vagrant VM +* Several small tweaks/fixes for contrib/mkimage-debian.sh + +#### Other + +- Builder: Abort build if mergeConfig returns an error and fix duplicate error message +- Packaging: Remove deprecated packaging directory +- Registry: Use correct auth config when logging in. +- Registry: Fix the error message so it is the same as the regex + +## 0.6.3 (2013-09-23) + +#### Packaging + +* Add 'docker' group on install for ubuntu package +* Update tar vendor dependency +* Download apt key over HTTPS + +#### Runtime + +- Only copy and change permissions on non-bindmount volumes +* Allow multiple volumes-from +- Fix HTTP imports from STDIN + +#### Documentation + +* Update section on extracting the docker binary after build +* Update development environment docs for new build process +* Remove 'base' image from documentation + +#### Other + +- Client: Fix detach issue +- Registry: Update regular expression to match index + +## 0.6.2 (2013-09-17) + +#### Runtime + ++ Add domainname support ++ Implement image filtering with path.Match +* Remove unnecessary warnings +* Remove os/user dependency +* Only mount the hostname file when the config exists +* Handle signals within the `docker login` command +- UID and GID are now also applied to volumes +- `docker start` set error code upon error +- `docker run` set the same error code as the process started + +#### Builder + ++ Add -rm option in order to remove intermediate containers +* Allow multiline for the RUN instruction + +#### Registry + +* Implement login with private registry +- Fix push issues + +#### Other + ++ Hack: Vendor all dependencies +* Remote API: Bump to v1.5 +* Packaging: Break down hack/make.sh into small scripts, one per 'bundle': test, binary, ubuntu etc. +* Documentation: General improvements + +## 0.6.1 (2013-08-23) + +#### Registry + +* Pass "meta" headers in API calls to the registry + +#### Packaging + +- Use correct upstart script with new build tool +- Use libffi-dev, don`t build it from sources +- Remove duplicate mercurial install command + +## 0.6.0 (2013-08-22) + +#### Runtime + ++ Add lxc-conf flag to allow custom lxc options ++ Add an option to set the working directory +* Add Image name to LogEvent tests ++ Add -privileged flag and relevant tests, docs, and examples +* Add websocket support to /container//attach/ws +* Add warning when net.ipv4.ip_forwarding = 0 +* Add hostname to environment +* Add last stable version in `docker version` +- Fix race conditions in parallel pull +- Fix Graph ByParent() to generate list of child images per parent image. +- Fix typo: fmt.Sprint -> fmt.Sprintf +- Fix small \n error un docker build +* Fix to "Inject dockerinit at /.dockerinit" +* Fix #910. print user name to docker info output +* Use Go 1.1.2 for dockerbuilder +* Use ranged for loop on channels +- Use utils.ParseRepositoryTag instead of strings.Split(name, ":") in server.ImageDelete +- Improve CMD, ENTRYPOINT, and attach docs. +- Improve connect message with socket error +- Load authConfig only when needed and fix useless WARNING +- Show tag used when image is missing +* Apply volumes-from before creating volumes +- Make docker run handle SIGINT/SIGTERM +- Prevent crash when .dockercfg not readable +- Install script should be fetched over https, not http. +* API, issue 1471: Use groups for socket permissions +- Correctly detect IPv4 forwarding +* Mount /dev/shm as a tmpfs +- Switch from http to https for get.docker.io +* Let userland proxy handle container-bound traffic +* Update the Docker CLI to specify a value for the "Host" header. +- Change network range to avoid conflict with EC2 DNS +- Reduce connect and read timeout when pinging the registry +* Parallel pull +- Handle ip route showing mask-less IP addresses +* Allow ENTRYPOINT without CMD +- Always consider localhost as a domain name when parsing the FQN repos name +* Refactor checksum + +#### Documentation + +* Add MongoDB image example +* Add instructions for creating and using the docker group +* Add sudo to examples and installation to documentation +* Add ufw doc +* Add a reference to ps -a +* Add information about Docker`s high level tools over LXC. +* Fix typo in docs for docker run -dns +* Fix a typo in the ubuntu installation guide +* Fix to docs regarding adding docker groups +* Update default -H docs +* Update readme with dependencies for building +* Update amazon.rst to explain that Vagrant is not necessary for running Docker on ec2 +* PostgreSQL service example in documentation +* Suggest installing linux-headers by default. +* Change the twitter handle +* Clarify Amazon EC2 installation +* 'Base' image is deprecated and should no longer be referenced in the docs. +* Move note about officially supported kernel +- Solved the logo being squished in Safari + +#### Builder + ++ Add USER instruction do Dockerfile ++ Add workdir support for the Buildfile +* Add no cache for docker build +- Fix docker build and docker events output +- Only count known instructions as build steps +- Make sure ENV instruction within build perform a commit each time +- Forbid certain paths within docker build ADD +- Repository name (and optionally a tag) in build usage +- Make sure ADD will create everything in 0755 + +#### Remote API + +* Sort Images by most recent creation date. +* Reworking opaque requests in registry module +* Add image name in /events +* Use mime pkg to parse Content-Type +* 650 http utils and user agent field + +#### Hack + ++ Bash Completion: Limit commands to containers of a relevant state +* Add docker dependencies coverage testing into docker-ci + +#### Packaging + ++ Docker-brew 0.5.2 support and memory footprint reduction +* Add new docker dependencies into docker-ci +- Revert "docker.upstart: avoid spawning a `sh` process" ++ Docker-brew and Docker standard library ++ Release docker with docker +* Fix the upstart script generated by get.docker.io +* Enabled the docs to generate manpages. +* Revert Bind daemon to 0.0.0.0 in Vagrant. + +#### Register + +* Improve auth push +* Registry unit tests + mock registry + +#### Tests + +* Improve TestKillDifferentUser to prevent timeout on buildbot +- Fix typo in TestBindMounts (runContainer called without image) +* Improve TestGetContainersTop so it does not rely on sleep +* Relax the lo interface test to allow iface index != 1 +* Add registry functional test to docker-ci +* Add some tests in server and utils + +#### Other + +* Contrib: bash completion script +* Client: Add docker cp command and copy api endpoint to copy container files/folders to the host +* Don`t read from stdout when only attached to stdin + +## 0.5.3 (2013-08-13) + +#### Runtime + +* Use docker group for socket permissions +- Spawn shell within upstart script +- Handle ip route showing mask-less IP addresses +- Add hostname to environment + +#### Builder + +- Make sure ENV instruction within build perform a commit each time + +## 0.5.2 (2013-08-08) + +* Builder: Forbid certain paths within docker build ADD +- Runtime: Change network range to avoid conflict with EC2 DNS +* API: Change daemon to listen on unix socket by default + +## 0.5.1 (2013-07-30) + +#### Runtime + ++ Add `ps` args to `docker top` ++ Add support for container ID files (pidfile like) ++ Add container=lxc in default env ++ Support networkless containers with `docker run -n` and `docker -d -b=none` +* Stdout/stderr logs are now stored in the same file as JSON +* Allocate a /16 IP range by default, with fallback to /24. Try 12 ranges instead of 3. +* Change .dockercfg format to json and support multiple auth remote +- Do not override volumes from config +- Fix issue with EXPOSE override + +#### API + ++ Docker client now sets useragent (RFC 2616) ++ Add /events endpoint + +#### Builder + ++ ADD command now understands URLs ++ CmdAdd and CmdEnv now respect Dockerfile-set ENV variables +- Create directories with 755 instead of 700 within ADD instruction + +#### Hack + +* Simplify unit tests with helpers +* Improve docker.upstart event +* Add coverage testing into docker-ci + +## 0.5.0 (2013-07-17) + +#### Runtime + ++ List all processes running inside a container with 'docker top' ++ Host directories can be mounted as volumes with 'docker run -v' ++ Containers can expose public UDP ports (eg, '-p 123/udp') ++ Optionally specify an exact public port (eg. '-p 80:4500') +* 'docker login' supports additional options +- Dont save a container`s hostname when committing an image. + +#### Registry + ++ New image naming scheme inspired by Go packaging convention allows arbitrary combinations of registries +- Fix issues when uploading images to a private registry + +#### Builder + ++ ENTRYPOINT instruction sets a default binary entry point to a container ++ VOLUME instruction marks a part of the container as persistent data +* 'docker build' displays the full output of a build by default + +## 0.4.8 (2013-07-01) + ++ Builder: New build operation ENTRYPOINT adds an executable entry point to the container. - Runtime: Fix a bug which caused 'docker run -d' to no longer print the container ID. +- Tests: Fix issues in the test suite + +## 0.4.7 (2013-06-28) + +#### Remote API + +* The progress bar updates faster when downloading and uploading large files +- Fix a bug in the optional unix socket transport + +#### Runtime + +* Improve detection of kernel version ++ Host directories can be mounted as volumes with 'docker run -b' +- fix an issue when only attaching to stdin +* Use 'tar --numeric-owner' to avoid uid mismatch across multiple hosts + +#### Hack + +* Improve test suite and dev environment +* Remove dependency on unit tests on 'os/user' + +#### Other + +* Registry: easier push/pull to a custom registry ++ Documentation: add terminology section + +## 0.4.6 (2013-06-22) + +- Runtime: fix a bug which caused creation of empty images (and volumes) to crash. + +## 0.4.5 (2013-06-21) + ++ Builder: 'docker build git://URL' fetches and builds a remote git repository +* Runtime: 'docker ps -s' optionally prints container size +* Tests: improved and simplified +- Runtime: fix a regression introduced in 0.4.3 which caused the logs command to fail. +- Builder: fix a regression when using ADD with single regular file. + +## 0.4.4 (2013-06-19) + +- Builder: fix a regression introduced in 0.4.3 which caused builds to fail on new clients. + +## 0.4.3 (2013-06-19) + +#### Builder + ++ ADD of a local file will detect tar archives and unpack them +* ADD improvements: use tar for copy + automatically unpack local archives +* ADD uses tar/untar for copies instead of calling 'cp -ar' +* Fix the behavior of ADD to be (mostly) reverse-compatible, predictable and well-documented. +- Fix a bug which caused builds to fail if ADD was the first command +* Nicer output for 'docker build' + +#### Runtime + +* Remove bsdtar dependency +* Add unix socket and multiple -H support +* Prevent rm of running containers +* Use go1.1 cookiejar +- Fix issue detaching from running TTY container +- Forbid parallel push/pull for a single image/repo. Fixes #311 +- Fix race condition within Run command when attaching. + +#### Client + +* HumanReadable ProgressBar sizes in pull +* Fix docker version`s git commit output + +#### API + +* Send all tags on History API call +* Add tag lookup to history command. Fixes #882 + +#### Documentation + +- Fix missing command in irc bouncer example + +## 0.4.2 (2013-06-17) + +- Packaging: Bumped version to work around an Ubuntu bug + +## 0.4.1 (2013-06-17) + +#### Remote Api + ++ Add flag to enable cross domain requests ++ Add images and containers sizes in docker ps and docker images + +#### Runtime + ++ Configure dns configuration host-wide with 'docker -d -dns' ++ Detect faulty DNS configuration and replace it with a public default ++ Allow docker run : ++ You can now specify public port (ex: -p 80:4500) +* Improve image removal to garbage-collect unreferenced parents + +#### Client + +* Allow multiple params in inspect +* Print the container id before the hijack in `docker run` + +#### Registry + +* Add regexp check on repo`s name +* Move auth to the client +- Remove login check on pull + +#### Other + +* Vagrantfile: Add the rest api port to vagrantfile`s port_forward +* Upgrade to Go 1.1 +- Builder: don`t ignore last line in Dockerfile when it doesn`t end with \n + +## 0.4.0 (2013-06-03) + +#### Builder + ++ Introducing Builder ++ 'docker build' builds a container, layer by layer, from a source repository containing a Dockerfile + +#### Remote API + ++ Introducing Remote API ++ control Docker programmatically using a simple HTTP/json API + +#### Runtime + +* Various reliability and usability improvements + +## 0.3.4 (2013-05-30) + +#### Builder + ++ 'docker build' builds a container, layer by layer, from a source repository containing a Dockerfile ++ 'docker build -t FOO' applies the tag FOO to the newly built container. + +#### Runtime + ++ Interactive TTYs correctly handle window resize +* Fix how configuration is merged between layers + +#### Remote API + ++ Split stdout and stderr on 'docker run' ++ Optionally listen on a different IP and port (use at your own risk) + +#### Documentation + +* Improve install instructions. + +## 0.3.3 (2013-05-23) + +- Registry: Fix push regression +- Various bugfixes + +## 0.3.2 (2013-05-09) + +#### Registry + +* Improve the checksum process +* Use the size to have a good progress bar while pushing +* Use the actual archive if it exists in order to speed up the push +- Fix error 400 on push + +#### Runtime + +* Store the actual archive on commit + +## 0.3.1 (2013-05-08) + +#### Builder + ++ Implement the autorun capability within docker builder ++ Add caching to docker builder ++ Add support for docker builder with native API as top level command ++ Implement ENV within docker builder +- Check the command existence prior create and add Unit tests for the case +* use any whitespaces instead of tabs + +#### Runtime + ++ Add go version to debug infos +* Kernel version - don`t show the dash if flavor is empty + +#### Registry + ++ Add docker search top level command in order to search a repository +- Fix pull for official images with specific tag +- Fix issue when login in with a different user and trying to push +* Improve checksum - async calculation + +#### Images + ++ Output graph of images to dot (graphviz) +- Fix ByParent function + +#### Documentation + ++ New introduction and high-level overview ++ Add the documentation for docker builder +- CSS fix for docker documentation to make REST API docs look better. +- Fix CouchDB example page header mistake +- Fix README formatting +* Update www.docker.io website. + +#### Other + ++ Website: new high-level overview +- Makefile: Swap "go get" for "go get -d", especially to compile on go1.1rc +* Packaging: packaging ubuntu; issue #510: Use goland-stable PPA package to build docker + +## 0.3.0 (2013-05-06) + +#### Runtime + +- Fix the command existence check +- strings.Split may return an empty string on no match +- Fix an index out of range crash if cgroup memory is not + +#### Documentation + +* Various improvements ++ New example: sharing data between 2 couchdb databases + +#### Other + +* Vagrant: Use only one deb line in /etc/apt ++ Registry: Implement the new registry + +## 0.2.2 (2013-05-03) + ++ Support for data volumes ('docker run -v=PATH') ++ Share data volumes between containers ('docker run -volumes-from') ++ Improve documentation +* Upgrade to Go 1.0.3 +* Various upgrades to the dev environment for contributors + +## 0.2.1 (2013-05-01) + ++ 'docker commit -run' bundles a layer with default runtime options: command, ports etc. +* Improve install process on Vagrant ++ New Dockerfile operation: "maintainer" ++ New Dockerfile operation: "expose" ++ New Dockerfile operation: "cmd" ++ Contrib script to build a Debian base layer ++ 'docker -d -r': restart crashed containers at daemon startup +* Runtime: improve test coverage + +## 0.2.0 (2013-04-23) + +- Runtime: ghost containers can be killed and waited for +* Documentation: update install instructions +- Packaging: fix Vagrantfile +- Development: automate releasing binaries and ubuntu packages ++ Add a changelog +- Various bugfixes + +## 0.1.8 (2013-04-22) + +- Dynamically detect cgroup capabilities +- Issue stability warning on kernels <3.8 +- 'docker push' buffers on disk instead of memory +- Fix 'docker diff' for removed files +- Fix 'docker stop' for ghost containers +- Fix handling of pidfile +- Various bugfixes and stability improvements + +## 0.1.7 (2013-04-18) + +- Container ports are available on localhost +- 'docker ps' shows allocated TCP ports +- Contributors can run 'make hack' to start a continuous integration VM +- Streamline ubuntu packaging & uploading +- Various bugfixes and stability improvements + +## 0.1.6 (2013-04-17) + +- Record the author an image with 'docker commit -author' + +## 0.1.5 (2013-04-17) + +- Disable standalone mode +- Use a custom DNS resolver with 'docker -d -dns' +- Detect ghost containers +- Improve diagnosis of missing system capabilities +- Allow disabling memory limits at compile time +- Add debian packaging +- Documentation: installing on Arch Linux +- Documentation: running Redis on docker +- Fix lxc 0.9 compatibility +- Automatically load aufs module +- Various bugfixes and stability improvements + +## 0.1.4 (2013-04-09) + +- Full support for TTY emulation +- Detach from a TTY session with the escape sequence `C-p C-q` +- Various bugfixes and stability improvements +- Minor UI improvements +- Automatically create our own bridge interface 'docker0' + +## 0.1.3 (2013-04-04) + +- Choose TCP frontend port with '-p :PORT' +- Layer format is versioned +- Major reliability improvements to the process manager +- Various bugfixes and stability improvements + +## 0.1.2 (2013-04-03) + +- Set container hostname with 'docker run -h' +- Selective attach at run with 'docker run -a [stdin[,stdout[,stderr]]]' +- Various bugfixes and stability improvements +- UI polish +- Progress bar on push/pull +- Use XZ compression by default +- Make IP allocator lazy + +## 0.1.1 (2013-03-31) + +- Display shorthand IDs for convenience +- Stabilize process management +- Layers can include a commit message +- Simplified 'docker attach' +- Fix support for re-attaching +- Various bugfixes and stability improvements +- Auto-download at run +- Auto-login on push +- Beefed up documentation + +## 0.1.0 (2013-03-23) + +Initial public release + +- Implement registry in order to push/pull images +- TCP port allocation +- Fix termcaps on Linux +- Add documentation +- Add Vagrant support with Vagrantfile +- Add unit tests +- Add repository/tags to ease image management +- Improve the layer implementation diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..ae6e5dcdec --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,438 @@ +# Contributing to Docker + +Want to hack on Docker? Awesome! We have a contributor's guide that explains +[setting up a Docker development environment and the contribution +process](https://docs.docker.com/project/who-written-for/). + +![Contributors guide](docs/static_files/contributors.png) + +This page contains information about reporting issues as well as some tips and +guidelines useful to experienced open source contributors. Finally, make sure +you read our [community guidelines](#docker-community-guidelines) before you +start participating. + +## Topics + +* [Reporting Security Issues](#reporting-security-issues) +* [Design and Cleanup Proposals](#design-and-cleanup-proposals) +* [Reporting Issues](#reporting-other-issues) +* [Quick Contribution Tips and Guidelines](#quick-contribution-tips-and-guidelines) +* [Community Guidelines](#docker-community-guidelines) + +## Reporting security issues + +The Docker maintainers take security seriously. If you discover a security +issue, please bring it to their attention right away! + +Please **DO NOT** file a public issue, instead send your report privately to +[security@docker.com](mailto:security@docker.com). + +Security reports are greatly appreciated and we will publicly thank you for it. +We also like to send gifts—if you're into Docker schwag, make sure to let +us know. We currently do not offer a paid security bounty program, but are not +ruling it out in the future. + + +## Reporting other issues + +A great way to contribute to the project is to send a detailed report when you +encounter an issue. We always appreciate a well-written, thorough bug report, +and will thank you for it! + +Check that [our issue database](https://github.com/docker/docker/issues) +doesn't already include that problem or suggestion before submitting an issue. +If you find a match, add a quick "+1" or "I have this problem too." Doing this +helps prioritize the most common problems and requests. **DO NOT DO THAT** to +subscribe to the issue unless you have something meaningful to add to the +conversation. The best way to subscribe the issue is by clicking Subscribe +button in top right of the page. + +When reporting issues, please include your host OS (Ubuntu 12.04, Fedora 19, +etc). Please include: + +* The output of `uname -a`. +* The output of `docker version`. +* The output of `docker info`. + +Please also include the steps required to reproduce the problem if possible and +applicable. This information will help us review and fix your issue faster. + +**Issue Report Template**: + +``` +Description of problem: + + +`docker version`: + + +`docker info`: + + +`uname -a`: + + +Environment details (AWS, VirtualBox, physical, etc.): + + +How reproducible: + + +Steps to Reproduce: +1. +2. +3. + + +Actual Results: + + +Expected Results: + + +Additional info: + + + +``` + + +##Quick contribution tips and guidelines + +This section gives the experienced contributor some tips and guidelines. + +###Pull requests are always welcome + +Not sure if that typo is worth a pull request? Found a bug and know how to fix +it? Do it! We will appreciate it. Any significant improvement should be +documented as [a GitHub issue](https://github.com/docker/docker/issues) before +anybody starts working on it. + +We are always thrilled to receive pull requests. We do our best to process them +quickly. If your pull request is not accepted on the first try, +don't get discouraged! Our contributor's guide explains [the review process we +use for simple changes](https://docs.docker.com/project/make-a-contribution/). + +### Design and cleanup proposals + +You can propose new designs for existing Docker features. You can also design +entirely new features. We really appreciate contributors who want to refactor or +otherwise cleanup our project. For information on making these types of +contributions, see [the advanced contribution +section](https://docs.docker.com/project/advanced-contributing/) in the +contributors guide. + +We try hard to keep Docker lean and focused. Docker can't do everything for +everybody. This means that we might decide against incorporating a new feature. +However, there might be a way to implement that feature *on top of* Docker. + +### Talking to other Docker users and contributors + + + + + + + + + + + + + + + + + + + + +
Internet Relay Chat (IRC) +

+ IRC a direct line to our most knowledgeable Docker users; we have + both the #docker and #docker-dev group on + irc.freenode.net. + IRC is a rich chat protocol but it can overwhelm new users. You can search + our chat archives. +

+ Read our IRC quickstart guide for an easy way to get started. +
Google Groups + There are two groups. + Docker-user + is for people using Docker containers. + The docker-dev + group is for contributors and other people contributing to the Docker + project. +
Twitter + You can follow Docker's Twitter feed + to get updates on our products. You can also tweet us questions or just + share blogs or stories. +
Stack Overflow + Stack Overflow has over 7000K Docker questions listed. We regularly + monitor Docker questions + and so do many other knowledgeable Docker users. +
+ + +### Conventions + +Fork the repository and make changes on your fork in a feature branch: + +- If it's a bug fix branch, name it XXXX-something where XXXX is the number of + the issue. +- If it's a feature branch, create an enhancement issue to announce + your intentions, and name it XXXX-something where XXXX is the number of the + issue. + +Submit unit tests for your changes. Go has a great test framework built in; use +it! Take a look at existing tests for inspiration. [Run the full test +suite](https://docs.docker.com/project/test-and-docs/) on your branch before +submitting a pull request. + +Update the documentation when creating or modifying features. Test your +documentation changes for clarity, concision, and correctness, as well as a +clean documentation build. See our contributors guide for [our style +guide](https://docs.docker.com/project/doc-style) and instructions on [building +the documentation](https://docs.docker.com/project/test-and-docs/#build-and-test-the-documentation). + +Write clean code. Universally formatted code promotes ease of writing, reading, +and maintenance. Always run `gofmt -s -w file.go` on each changed file before +committing your changes. Most editors have plug-ins that do this automatically. + +Pull request descriptions should be as clear as possible and include a reference +to all the issues that they address. + +Commit messages must start with a capitalized and short summary (max. 50 chars) +written in the imperative, followed by an optional, more detailed explanatory +text which is separated from the summary by an empty line. + +Code review comments may be added to your pull request. Discuss, then make the +suggested modifications and push additional commits to your feature branch. Post +a comment after pushing. New commits show up in the pull request automatically, +but the reviewers are notified only when you comment. + +Pull requests must be cleanly rebased on top of master without multiple branches +mixed into the PR. + +**Git tip**: If your PR no longer merges cleanly, use `rebase master` in your +feature branch to update your pull request rather than `merge master`. + +Before you make a pull request, squash your commits into logical units of work +using `git rebase -i` and `git push -f`. A logical unit of work is a consistent +set of patches that should be reviewed together: for example, upgrading the +version of a vendored dependency and taking advantage of its now available new +feature constitute two separate units of work. Implementing a new function and +calling it in another file constitute a single logical unit of work. The very +high majority of submissions should have a single commit, so if in doubt: squash +down to one. + +After every commit, [make sure the test suite passes] +(https://docs.docker.com/project/test-and-docs/). Include documentation +changes in the same pull request so that a revert would remove all traces of +the feature or fix. + +Include an issue reference like `Closes #XXXX` or `Fixes #XXXX` in commits that +close an issue. Including references automatically closes the issue on a merge. + +Please do not add yourself to the `AUTHORS` file, as it is regenerated regularly +from the Git history. + +Please see the [Coding Style](#coding-style) for further guidelines. + +### Merge approval + +Docker maintainers use LGTM (Looks Good To Me) in comments on the code review to +indicate acceptance. + +A change requires LGTMs from an absolute majority of the maintainers of each +component affected. For example, if a change affects `docs/` and `registry/`, it +needs an absolute majority from the maintainers of `docs/` AND, separately, an +absolute majority of the maintainers of `registry/`. + +For more details, see the [MAINTAINERS](MAINTAINERS) page. + +### Sign your work + +The sign-off is a simple line at the end of the explanation for the patch. Your +signature certifies that you wrote the patch or otherwise have the right to pass +it on as an open-source patch. The rules are pretty simple: if you can certify +the below (from [developercertificate.org](http://developercertificate.org/)): + +``` +Developer Certificate of Origin +Version 1.1 + +Copyright (C) 2004, 2006 The Linux Foundation and its contributors. +660 York Street, Suite 102, +San Francisco, CA 94110 USA + +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + +Developer's Certificate of Origin 1.1 + +By making a contribution to this project, I certify that: + +(a) The contribution was created in whole or in part by me and I + have the right to submit it under the open source license + indicated in the file; or + +(b) The contribution is based upon previous work that, to the best + of my knowledge, is covered under an appropriate open source + license and I have the right under that license to submit that + work with modifications, whether created in whole or in part + by me, under the same open source license (unless I am + permitted to submit under a different license), as indicated + in the file; or + +(c) The contribution was provided directly to me by some other + person who certified (a), (b) or (c) and I have not modified + it. + +(d) I understand and agree that this project and the contribution + are public and that a record of the contribution (including all + personal information I submit with it, including my sign-off) is + maintained indefinitely and may be redistributed consistent with + this project or the open source license(s) involved. +``` + +Then you just add a line to every git commit message: + + Signed-off-by: Joe Smith + +Use your real name (sorry, no pseudonyms or anonymous contributions.) + +If you set your `user.name` and `user.email` git configs, you can sign your +commit automatically with `git commit -s`. + +Note that the old-style `Docker-DCO-1.1-Signed-off-by: ...` format is still +accepted, so there is no need to update outstanding pull requests to the new +format right away, but please do adjust your processes for future contributions. + +### How can I become a maintainer? + +* Step 1: Learn the component inside out +* Step 2: Make yourself useful by contributing code, bug fixes, support etc. +* Step 3: Volunteer on the IRC channel (#docker at Freenode) +* Step 4: Propose yourself at a scheduled docker meeting in #docker-dev + +Don't forget: being a maintainer is a time investment. Make sure you +will have time to make yourself available. You don't have to be a +maintainer to make a difference on the project! + +### IRC meetings + +There are two monthly meetings taking place on #docker-dev IRC to accommodate all +timezones. Anybody can propose a topic for discussion prior to the meeting. + +If you feel the conversation is going off-topic, feel free to point it out. + +For the exact dates and times, have a look at [the irc-minutes +repo](https://github.com/docker/irc-minutes). The minutes also contain all the +notes from previous meetings. + +## Docker community guidelines + +We want to keep the Docker community awesome, growing and collaborative. We need +your help to keep it that way. To help with this we've come up with some general +guidelines for the community as a whole: + +* Be nice: Be courteous, respectful and polite to fellow community members: + no regional, racial, gender, or other abuse will be tolerated. We like + nice people way better than mean ones! + +* Encourage diversity and participation: Make everyone in our community feel + welcome, regardless of their background and the extent of their + contributions, and do everything possible to encourage participation in + our community. + +* Keep it legal: Basically, don't get us in trouble. Share only content that + you own, do not share private or sensitive information, and don't break + the law. + +* Stay on topic: Make sure that you are posting to the correct channel and + avoid off-topic discussions. Remember when you update an issue or respond + to an email you are potentially sending to a large number of people. Please + consider this before you update. Also remember that nobody likes spam. + +### Guideline violations — 3 strikes method + +The point of this section is not to find opportunities to punish people, but we +do need a fair way to deal with people who are making our community suck. + +1. First occurrence: We'll give you a friendly, but public reminder that the + behavior is inappropriate according to our guidelines. + +2. Second occurrence: We will send you a private message with a warning that + any additional violations will result in removal from the community. + +3. Third occurrence: Depending on the violation, we may need to delete or ban + your account. + +**Notes:** + +* Obvious spammers are banned on first occurrence. If we don't do this, we'll + have spam all over the place. + +* Violations are forgiven after 6 months of good behavior, and we won't hold a + grudge. + +* People who commit minor infractions will get some education, rather than + hammering them in the 3 strikes process. + +* The rules apply equally to everyone in the community, no matter how much + you've contributed. + +* Extreme violations of a threatening, abusive, destructive or illegal nature + will be addressed immediately and are not subject to 3 strikes or forgiveness. + +* Contact abuse@docker.com to report abuse or appeal violations. In the case of + appeals, we know that mistakes happen, and we'll work with you to come up with a + fair solution if there has been a misunderstanding. + +## Coding Style + +Unless explicitly stated, we follow all coding guidelines from the Go +community. While some of these standards may seem arbitrary, they somehow seem +to result in a solid, consistent codebase. + +It is possible that the code base does not currently comply with these +guidelines. We are not looking for a massive PR that fixes this, since that +goes against the spirit of the guidelines. All new contributions should make a +best effort to clean up and make the code base better than they left it. +Obviously, apply your best judgement. Remember, the goal here is to make the +code base easier for humans to navigate and understand. Always keep that in +mind when nudging others to comply. + +The rules: + +1. All code should be formatted with `gofmt -s`. +2. All code should pass the default levels of + [`golint`](https://github.com/golang/lint). +3. All code should follow the guidelines covered in [Effective + Go](http://golang.org/doc/effective_go.html) and [Go Code Review + Comments](https://github.com/golang/go/wiki/CodeReviewComments). +4. Comment the code. Tell us the why, the history and the context. +5. Document _all_ declarations and methods, even private ones. Declare + expectations, caveats and anything else that may be important. If a type + gets exported, having the comments already there will ensure it's ready. +6. Variable name length should be proportional to it's context and no longer. + `noCommaALongVariableNameLikeThisIsNotMoreClearWhenASimpleCommentWouldDo`. + In practice, short methods will have short variable names and globals will + have longer names. +7. No underscores in package names. If you need a compound name, step back, + and re-examine why you need a compound name. If you still think you need a + compound name, lose the underscore. +8. No utils or helpers packages. If a function is not general enough to + warrant it's own package, it has not been written generally enough to be a + part of a util package. Just leave it unexported and well-documented. +9. All tests should run with `go test` and outside tooling should not be + required. No, we don't need another unit testing framework. Assertion + packages are acceptable if they provide _real_ incremental value. +10. Even though we call these "rules" above, they are actually just + guidelines. Since you've read all the rules, you now know that. + +If you are having trouble getting into the mood of idiomatic Go, we recommend +reading through [Effective Go](http://golang.org/doc/effective_go.html). The +[Go Blog](http://blog.golang.org/) is also a great resource. Drinking the +kool-aid is a lot easier than going thirsty. diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000000..3bde877b82 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,223 @@ +# This file describes the standard way to build Docker, using docker +# +# Usage: +# +# # Assemble the full dev environment. This is slow the first time. +# docker build -t docker . +# +# # Mount your source in an interactive container for quick testing: +# docker run -v `pwd`:/go/src/github.com/docker/docker --privileged -i -t docker bash +# +# # Run the test suite: +# docker run --privileged docker hack/make.sh test +# +# # Publish a release: +# docker run --privileged \ +# -e AWS_S3_BUCKET=baz \ +# -e AWS_ACCESS_KEY=foo \ +# -e AWS_SECRET_KEY=bar \ +# -e GPG_PASSPHRASE=gloubiboulga \ +# docker hack/release.sh +# +# Note: AppArmor used to mess with privileged mode, but this is no longer +# the case. Therefore, you don't have to disable it anymore. +# + +FROM ubuntu:14.04 +MAINTAINER Tianon Gravi (@tianon) + +RUN apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys E871F18B51E0147C77796AC81196BA81F6B0FC61 +RUN echo deb http://ppa.launchpad.net/zfs-native/stable/ubuntu trusty main > /etc/apt/sources.list.d/zfs.list + +# Packaged dependencies +RUN apt-get update && apt-get install -y \ + apparmor \ + aufs-tools \ + automake \ + bash-completion \ + btrfs-tools \ + build-essential \ + createrepo \ + curl \ + dpkg-sig \ + gcc-mingw-w64 \ + git \ + iptables \ + libapparmor-dev \ + libcap-dev \ + libsqlite3-dev \ + libsystemd-journal-dev \ + mercurial \ + parallel \ + pkg-config \ + python-mock \ + python-pip \ + python-websocket \ + reprepro \ + rpm \ + ruby1.9.1 \ + ruby1.9.1-dev \ + s3cmd=1.1.0* \ + ubuntu-zfs \ + xfsprogs \ + libzfs-dev \ + --no-install-recommends + +# Get lvm2 source for compiling statically +RUN git clone -b v2_02_103 https://git.fedorahosted.org/git/lvm2.git /usr/local/lvm2 +# see https://git.fedorahosted.org/cgit/lvm2.git/refs/tags for release tags + +# Compile and install lvm2 +RUN cd /usr/local/lvm2 \ + && ./configure --enable-static_link \ + && make device-mapper \ + && make install_device-mapper +# see https://git.fedorahosted.org/cgit/lvm2.git/tree/INSTALL + +# Install lxc +ENV LXC_VERSION 1.1.2 +RUN mkdir -p /usr/src/lxc \ + && curl -sSL https://linuxcontainers.org/downloads/lxc/lxc-${LXC_VERSION}.tar.gz | tar -v -C /usr/src/lxc/ -xz --strip-components=1 +RUN cd /usr/src/lxc \ + && ./configure \ + && make \ + && make install \ + && ldconfig + +# Install Go +ENV GO_VERSION 1.4.3 +RUN curl -sSL https://golang.org/dl/go${GO_VERSION}.src.tar.gz | tar -v -C /usr/local -xz \ + && mkdir -p /go/bin +ENV PATH /go/bin:/usr/local/go/bin:$PATH +ENV GOPATH /go:/go/src/github.com/docker/docker/vendor +RUN cd /usr/local/go/src && ./make.bash --no-clean 2>&1 + +# Compile Go for cross compilation +ENV DOCKER_CROSSPLATFORMS \ + linux/386 linux/arm \ + darwin/amd64 darwin/386 \ + freebsd/amd64 freebsd/386 freebsd/arm \ + windows/amd64 windows/386 + +# (set an explicit GOARM of 5 for maximum compatibility) +ENV GOARM 5 +RUN cd /usr/local/go/src \ + && set -x \ + && for platform in $DOCKER_CROSSPLATFORMS; do \ + GOOS=${platform%/*} \ + GOARCH=${platform##*/} \ + ./make.bash --no-clean 2>&1; \ + done + +# This has been commented out and kept as reference because we don't support compiling with older Go anymore. +# ENV GOFMT_VERSION 1.3.3 +# RUN curl -sSL https://storage.googleapis.com/golang/go${GOFMT_VERSION}.$(go env GOOS)-$(go env GOARCH).tar.gz | tar -C /go/bin -xz --strip-components=2 go/bin/gofmt + +# Update this sha when we upgrade to go 1.5.0 +ENV GO_TOOLS_COMMIT 069d2f3bcb68257b627205f0486d6cc69a231ff9 +# Grab Go's cover tool for dead-simple code coverage testing +# Grab Go's vet tool for examining go code to find suspicious constructs +# and help prevent errors that the compiler might not catch +RUN git clone https://github.com/golang/tools.git /go/src/golang.org/x/tools \ + && (cd /go/src/golang.org/x/tools && git checkout -q $GO_TOOLS_COMMIT) \ + && go install -v golang.org/x/tools/cmd/cover \ + && go install -v golang.org/x/tools/cmd/vet +# Grab Go's lint tool +ENV GO_LINT_COMMIT f42f5c1c440621302702cb0741e9d2ca547ae80f +RUN git clone https://github.com/golang/lint.git /go/src/github.com/golang/lint \ + && (cd /go/src/github.com/golang/lint && git checkout -q $GO_LINT_COMMIT) \ + && go install -v github.com/golang/lint/golint + +# TODO replace FPM with some very minimal debhelper stuff +RUN gem install --no-rdoc --no-ri fpm --version 1.3.2 + +# Install registry +ENV REGISTRY_COMMIT ec87e9b6971d831f0eff752ddb54fb64693e51cd +RUN set -x \ + && export GOPATH="$(mktemp -d)" \ + && git clone https://github.com/docker/distribution.git "$GOPATH/src/github.com/docker/distribution" \ + && (cd "$GOPATH/src/github.com/docker/distribution" && git checkout -q "$REGISTRY_COMMIT") \ + && GOPATH="$GOPATH/src/github.com/docker/distribution/Godeps/_workspace:$GOPATH" \ + go build -o /usr/local/bin/registry-v2 github.com/docker/distribution/cmd/registry \ + && rm -rf "$GOPATH" + +# Install notary server +ENV NOTARY_COMMIT 8e8122eb5528f621afcd4e2854c47302f17392f7 +RUN set -x \ + && export GOPATH="$(mktemp -d)" \ + && git clone https://github.com/docker/notary.git "$GOPATH/src/github.com/docker/notary" \ + && (cd "$GOPATH/src/github.com/docker/notary" && git checkout -q "$NOTARY_COMMIT") \ + && GOPATH="$GOPATH/src/github.com/docker/notary/Godeps/_workspace:$GOPATH" \ + go build -o /usr/local/bin/notary-server github.com/docker/notary/cmd/notary-server \ + && rm -rf "$GOPATH" + +# Get the "docker-py" source so we can run their integration tests +ENV DOCKER_PY_COMMIT 47ab89ec2bd3bddf1221b856ffbaff333edeabb4 +RUN git clone https://github.com/docker/docker-py.git /docker-py \ + && cd /docker-py \ + && git checkout -q $DOCKER_PY_COMMIT \ + && pip install -r test-requirements.txt + +# Setup s3cmd config +RUN { \ + echo '[default]'; \ + echo 'access_key=$AWS_ACCESS_KEY'; \ + echo 'secret_key=$AWS_SECRET_KEY'; \ + } > ~/.s3cfg + +# Set user.email so crosbymichael's in-container merge commits go smoothly +RUN git config --global user.email 'docker-dummy@example.com' + +# Add an unprivileged user to be used for tests which need it +RUN groupadd -r docker +RUN useradd --create-home --gid docker unprivilegeduser + +VOLUME /var/lib/docker +WORKDIR /go/src/github.com/docker/docker +ENV DOCKER_BUILDTAGS apparmor selinux + +# Let us use a .bashrc file +RUN ln -sfv $PWD/.bashrc ~/.bashrc + +# Register Docker's bash completion. +RUN ln -sv $PWD/contrib/completion/bash/docker /etc/bash_completion.d/docker + +# Get useful and necessary Hub images so we can "docker load" locally instead of pulling +COPY contrib/download-frozen-image.sh /go/src/github.com/docker/docker/contrib/ +RUN ./contrib/download-frozen-image.sh /docker-frozen-images \ + busybox:latest@8c2e06607696bd4afb3d03b687e361cc43cf8ec1a4a725bc96e39f05ba97dd55 \ + hello-world:frozen@91c95931e552b11604fea91c2f537284149ec32fff0f700a4769cfd31d7696ae \ + jess/unshare@5c9f6ea50341a2a8eb6677527f2bdedbf331ae894a41714fda770fb130f3314d +# see also "hack/make/.ensure-frozen-images" (which needs to be updated any time this list is) + +# Download man page generator +RUN set -x \ + && export GOPATH="$(mktemp -d)" \ + && git clone -b v1.0.3 https://github.com/cpuguy83/go-md2man.git "$GOPATH/src/github.com/cpuguy83/go-md2man" \ + && git clone -b v1.2 https://github.com/russross/blackfriday.git "$GOPATH/src/github.com/russross/blackfriday" \ + && go get -v -d github.com/cpuguy83/go-md2man \ + && go build -v -o /usr/local/bin/go-md2man github.com/cpuguy83/go-md2man \ + && rm -rf "$GOPATH" + +# Download toml validator +ENV TOMLV_COMMIT 9baf8a8a9f2ed20a8e54160840c492f937eeaf9a +RUN set -x \ + && export GOPATH="$(mktemp -d)" \ + && git clone https://github.com/BurntSushi/toml.git "$GOPATH/src/github.com/BurntSushi/toml" \ + && (cd "$GOPATH/src/github.com/BurntSushi/toml" && git checkout -q "$TOMLV_COMMIT") \ + && go build -v -o /usr/local/bin/tomlv github.com/BurntSushi/toml/cmd/tomlv \ + && rm -rf "$GOPATH" + +# Build/install the tool for embedding resources in Windows binaries +ENV RSRC_COMMIT e48dbf1b7fc464a9e85fcec450dddf80816b76e0 +RUN set -x \ + && git clone https://github.com/akavel/rsrc.git /go/src/github.com/akavel/rsrc \ + && cd /go/src/github.com/akavel/rsrc \ + && git checkout -q $RSRC_COMMIT \ + && go install -v + +# Wrap all commands in the "docker-in-docker" script to allow nested containers +ENTRYPOINT ["hack/dind"] + +# Upload docker source +COPY . /go/src/github.com/docker/docker diff --git a/Dockerfile.centos b/Dockerfile.centos new file mode 100644 index 0000000000..0d11f2f2f7 --- /dev/null +++ b/Dockerfile.centos @@ -0,0 +1,36 @@ +# This file creates a CentOS docker container which can be used to create the Docker +# RPMs, however it shouldn't be called directly. +# + +FROM centos:7.0.1406 +MAINTAINER Patrick Devine (@pdev110) + +RUN rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 + +# Packaged dependencies +RUN yum groupinstall -y "Development Tools" + +RUN yum install -y \ + btrfs-progs-devel \ + device-mapper-devel \ + glibc-static \ + libselinux-devel \ + sqlite-devel + +VOLUME /go + +ENV LXC_VERSION 1.0.7 +ENV GO_VERSION 1.4.2 +ENV PATH /go/bin:/usr/local/go/bin:$PATH +ENV GOPATH /go:/go/src/github.com/docker/docker/vendor +ENV GOFMT_VERSION 1.3.3 + +# Add an unprivileged user to be used for tests which need it +RUN groupadd -r docker +RUN useradd --create-home --gid docker unprivilegeduser + +WORKDIR /go/src/github.com/docker/docker +ENV DOCKER_BUILDTAGS selinux btrfs_noversion + +# Wrap all commands in the "docker-in-docker" script to allow nested containers +#ENTRYPOINT ["hack/dind"] diff --git a/Dockerfile.gccgo b/Dockerfile.gccgo new file mode 100644 index 0000000000..e230ef9ebd --- /dev/null +++ b/Dockerfile.gccgo @@ -0,0 +1,72 @@ +# This file describes the standard way to build Docker, using docker +# +# Usage: +# +# # Assemble the full dev environment. This is slow the first time. +# docker build -t docker -f Dockerfile.gccgo . +# + +FROM gcc:5.2 + +# Packaged dependencies +RUN apt-get update && apt-get install -y \ + apparmor \ + aufs-tools \ + btrfs-tools \ + build-essential \ + curl \ + git \ + iptables \ + net-tools \ + libapparmor-dev \ + libcap-dev \ + libsqlite3-dev \ + mercurial \ + parallel \ + python-mock \ + python-pip \ + python-websocket \ + --no-install-recommends + +# Get lvm2 source for compiling statically +RUN git clone -b v2_02_103 https://git.fedorahosted.org/git/lvm2.git /usr/local/lvm2 +# see https://git.fedorahosted.org/cgit/lvm2.git/refs/tags for release tags + +# Compile and install lvm2 +RUN cd /usr/local/lvm2 \ + && ./configure --enable-static_link \ + && make device-mapper \ + && make install_device-mapper +# see https://git.fedorahosted.org/cgit/lvm2.git/tree/INSTALL + +# Install lxc +ENV LXC_VERSION 1.1.2 +RUN mkdir -p /usr/src/lxc \ + && curl -sSL https://linuxcontainers.org/downloads/lxc/lxc-${LXC_VERSION}.tar.gz | tar -v -C /usr/src/lxc/ -xz --strip-components=1 +RUN cd /usr/src/lxc \ + && ./configure \ + && make \ + && make install \ + && ldconfig + +ENV GOPATH /go:/go/src/github.com/docker/docker/vendor + +# Get the "docker-py" source so we can run their integration tests +ENV DOCKER_PY_COMMIT 139850f3f3b17357bab5ba3edfb745fb14043764 +RUN git clone https://github.com/docker/docker-py.git /docker-py \ + && cd /docker-py \ + && git checkout -q $DOCKER_PY_COMMIT + +# Add an unprivileged user to be used for tests which need it +RUN groupadd -r docker +RUN useradd --create-home --gid docker unprivilegeduser + +VOLUME /var/lib/docker +WORKDIR /go/src/github.com/docker/docker +ENV DOCKER_BUILDTAGS apparmor selinux + +# Wrap all commands in the "docker-in-docker" script to allow nested containers +ENTRYPOINT ["hack/dind"] + +# Upload docker source +COPY . /go/src/github.com/docker/docker diff --git a/Dockerfile.simple b/Dockerfile.simple new file mode 100644 index 0000000000..8ba82bce49 --- /dev/null +++ b/Dockerfile.simple @@ -0,0 +1,35 @@ +# docker build -t docker:simple -f Dockerfile.simple . +# docker run --rm docker:simple hack/make.sh dynbinary +# docker run --rm --privileged docker:simple hack/dind hack/make.sh test-unit +# docker run --rm --privileged -v /var/lib/docker docker:simple hack/dind hack/make.sh dynbinary test-integration-cli + +# This represents the bare minimum required to build and test Docker. + +FROM debian:jessie + +# compile and runtime deps +# https://github.com/docker/docker/blob/master/project/PACKAGERS.md#build-dependencies +# https://github.com/docker/docker/blob/master/project/PACKAGERS.md#runtime-dependencies +RUN apt-get update && apt-get install -y --no-install-recommends \ + btrfs-tools \ + curl \ + gcc \ + git \ + golang \ + libdevmapper-dev \ + libsqlite3-dev \ + \ + ca-certificates \ + e2fsprogs \ + iptables \ + procps \ + xfsprogs \ + xz-utils \ + \ + aufs-tools \ + lxc \ + && rm -rf /var/lib/apt/lists/* + +ENV AUTO_GOPATH 1 +WORKDIR /usr/src/docker +COPY . /usr/src/docker diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000000..c7a3f0cfd4 --- /dev/null +++ b/LICENSE @@ -0,0 +1,191 @@ + + Apache License + Version 2.0, January 2004 + https://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + Copyright 2013-2015 Docker, Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + https://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/LICENSE-EVAL.txt b/LICENSE-EVAL.txt new file mode 100644 index 0000000000..8ee59213a2 --- /dev/null +++ b/LICENSE-EVAL.txt @@ -0,0 +1,64 @@ +Docker Software Evaluation Agreement + +Updated 2015-Aug-31 + +THIS DOCKER SOFTWARE EVALUATION AGREEMENT("AGREEMENT") IS BY AND BETWEEN DOCKER TECHNOLOGIES INC., LOCATED AT 475 BRANNAN STREET, SUITE 330, SAN FRANCISCO, CA 94107("DOCKER") AND THE INDIVIDUAL OR LEGAL ENTITY WHO HAS EXECUTED AN ORDER FORM(OR OTHER ORDERING OR PURCHASING DOCUMENT) REFERENCING THIS AGREEMENT OR IS USING THE APPLICABLE SOFTWARE MADE AVAILABLE BY DOCKER("CUSTOMER") AND GOVERNS ALL USE BY CUSTOMER OF THE DOCKER SOFTWARE REFERENCED IN SUCH ORDER FORM. BY EXECUTING AN ORDER FORM, CUSTOMER EXPRESSLY ACCEPTS AND AGREES TO THE TERMS OF THIS AGREEMENT.IF YOU ARE AN INDIVIDUAL AGREEING TO THE TERMS OF THIS AGREEMENT ON BEHALF OF AN ENTITY, SUCH AS YOUR EMPLOYER, YOU REPRESENT THAT YOU HAVE THE LEGAL AUTHORITY TO BIND THAT ENTITY AND "CUSTOMER" SHALL REFER HEREIN TO SUCH ENTITY.IF YOU DO NOT HAVE SUCH AUTHORITY, OR IF YOU DO NOT AGREE WITH THE TERMS OF THIS AGREEMENT, YOU MUST NOT EXECUTE THE ORDER FORM AND MAY NOT USE THE LICENSED SOFTWARE(EACH AS DEFINED BELOW). This Agreement does not provide a commercial license after the Trial Period.Use after the Trial Period is subject to the parties entering into and executing a separate written agreement. +1. Definitions. +The following capitalized terms shall have the meanings set forth below: +1.1 "Feedback" +"Feedback" means any comments or other feedback Customer may provide to Docker concerning the functionality and performance of the Licensed Software, including identification of potential errors and improvements. +1.2 "Instance" +"Instance" means a single instance of Licensed Software, as applicable, installed on a physical or virtual computer or server. +1.3 Key +"Key" means the license key or similar control mechanism to help ensure compliance with the use and time limitations with respect to the Licensed Software. +1.4 Licensed Software +"Licensed Software" means the Docker software identified on an Order Form (other than Open Source Software) and licensed to Customer pursuant to the terms of this Agreement, e.g., the "Docker trusted registry" software or other licensed software from Docker that is identified on the Order Form (excluding any Open Source Software included therein). +1.5 Open Source Software +"Open Source Software" means Docker or third party software identified at https://www.docker.com/legal, that is distributed or otherwise made available as "free software", "open source software" or under a similar licensing or distribution model. +1.6 Order Form +"Order Form" means an ordering document referencing this Agreement between Customer and Docker. +1.7 Trial Period +"Trial Period" means 30 days. +2. License. +2.1 Licensed Software. +Licensed Software. Subject to Customer's compliance with the terms and conditions of this Agreement, Docker hereby grants Customer a limited, non-exclusive, non-transferable, non-sub-licensable license during the Trial Period to install, copy and use the Licensed Software solely for Customer's internal evaluation purposes, in connection with the deployment of no more than one Instance. +2.2 Open Source Software. +If applicable, Open Source Software is distributed or made available under the terms of the open source license agreements referenced in the applicable distribution or the applicable help, notices, about or source files. Copyrights and other proprietary rights to the Open Source Software are held by the copyright holders identified in the applicable distribution or the applicable help, notices, about or source files. +2.3 License Keys. +Customer shall not destroy, disable or circumvent, or attempt to destroy, disable or circumvent in any way the Key and/or the use and time limitations set by the Key or the Licensed Software. Customer acknowledges and agrees that any attempt to exceed the use of the Licensed Software beyond the limits configured into the Key will automatically and immediately terminate the licenses granted under this Agreement. +3. Payment. +Subject to Customer's compliance with the terms and conditions of this Agreement, and solely during the Trial Period, the Licensed Software shall be provided to Customer free of charge. +4. Restricted Activities. +Customer shall not, and shall not encourage any third party to: (a) modify, adapt, alter, translate, or create derivative works of the Licensed Software; (b) reverse-engineer, decompile, disassemble, or attempt to derive the source code for the Licensed Software, in whole or in part, except to the extent that such activities are permitted under applicable law; (c) distribute, license, sublicense, lease, rent, loan, or otherwise transfer the Licensed Software to any third party; (d) remove, alter, or obscure in any way the proprietary rights notices (including copyright, patent, and trademark notices and symbols) of Docker or its suppliers contained on or within any copies of the Licensed Software; (e) use the Licensed Software for the purpose of creating a product or service competitive with the Licensed Software; (f) use the Licensed Software with any unsupported software or hardware (as described in the applicable documentation provided by Docker); (g) use the Licensed Software for any time-sharing, outsourcing, service bureau, hosting, application service provider or like purposes; (h) disclose the results of any benchmark tests on the Licensed Software without Docker's prior written consent; or (i) use the Licensed Software other than as described in the documentation provided therewith, or for any unlawful purpose. +5. Ownership of Licensed Software. +Docker and its licensors own and retain all right, title, and interest, including all intellectual property rights, in and to the Licensed Software, including any improvements, modifications, and enhancements to it. Except for the rights expressly granted in this Agreement, Customer shall acquire no other rights, express or implied, in or to the Licensed Software, and all rights not expressly provided to Customer hereunder are reserved by Docker and its licensors. All the copies of the Licensed Software provided or made available hereunder are licensed, not sold. +6. Term. +Unless otherwise terminated in accordance with this section, this Agreement will remain in effect until the expiration of the Trial Period. Either party may immediately terminate this Agreement and any Order Form incorporating the terms of this Agreement if the other party materially breaches this Agreement. Either party may terminate this agreement without cause upon 10 days' prior written notice. Unless otherwise agreed by the parties, upon the expiration or termination of the Trial Period all licenses granted herein will automatically terminate and Customer will discontinue all use of the applicable Licensed Software and will return to Docker any materials (including any copies of Licensed Software) provided by Docker to Customer. Sections 1, 2.2, 4, 5, and 7 through 14 shall survive any termination or expiration of this Agreement or any Order Form. +7.Feedback. +Customer may submit to Docker bug reports, comments, feedback or ideas about the Licensed Software, including without limitation about how to improve the Licensed Software. By submitting any Feedback, Customer hereby assigns to Docker all right, title, and interest in and to the Feedback, if any. +8. Confidentiality. +8.1 Definition. +"Confidential Information" means any information disclosed by one party ("Discloser") to the other ("Recipient"), directly or indirectly, in writing, orally or by inspection of tangible objects, which is designated as "Confidential," "Proprietary" or some similar designation, or learned by Recipient under circumstances in which such information would reasonably be understood to be confidential. Confidential Information may include information disclosed in confidence to Discloser by third parties. For the purposes of this Agreement, the Licensed Software, and the results of any performance, functional or other evaluation of the Licensed Software, shall be deemed Confidential Information of Docker. +8.2 Exceptions. +The confidentiality obligations in this Section 8 shall not apply with respect to any of the Discloser's Confidential information which Recipient can demonstrate: (a) was in the public domain at the time it was disclosed to Recipient or has become in the public domain through no act or omission of Recipient; (b) was known to Recipient, without restriction, at the time of disclosure as shown by the files of Recipient in existence at the time of disclosure; (c) was disclosed by Recipient with the prior written approval of Discloser; (d) was independently developed by Recipient without any use of Discloser's Confidential Information by employees or other agents of (or contractors hired by) Recipient who had no access to or did not rely on Discloser's Confidential Information; or (e) became known to Recipient, without restriction, from a source other than Discloser without breach of this Agreement by Recipient and otherwise not in violation of Discloser's rights. +8.3 Restrictions on Use and Disclosure. +Recipient agrees not to use Discloser's Confidential Information or disclose, distribute or disseminate Discloser's Confidential Information except in furtherance of the performance of its obligations or enforcement of its rights hereunder or as otherwise expressly agreed by Discloser in writing. Recipient agrees to restrict access to such Confidential Information to those employees or consultants of Recipient who need to know such Confidential Information for performing as contemplated hereunder and have agreed in writing to be bound by a confidentiality obligation no less protective than that contained in this Agreement. Recipient shall exercise the same degree of care to prevent unauthorized use or disclosure of Discloser's Confidential Information to others as it takes to preserve and safeguard its own information of like importance, but in no event less than reasonable care. +8.4 Compelled Disclosure. +If Recipient is compelled by a court or other competent authority or applicable law to disclose Confidential Information of Discloser, it shall give Discloser prompt written notice and shall provide Discloser with reasonable cooperation at Discloser's expense so that Discloser may take steps to oppose such disclosure or obtain a restraining order. Recipient shall not be in breach of its obligations in this Section 9 if it makes any legally compelled disclosure provided that Recipient meets the foregoing notice and cooperation requirements. +8.5 Injunctive Relief. +Recipient acknowledges that breach of the confidentiality obligations would cause irreparable harm to Discloser, the extent of which may be difficult to ascertain. Accordingly, Recipient agrees that Discloser is entitled to immediate injunctive relief in the event of breach of an obligation of confidentiality by Recipient, and that Discloser shall not be required to post a bond or show irreparable harm in order to obtain such injunctive relief. +8.6 Return of Confidential Information. +As between the parties, Confidential Information shall remain the property of the Discloser. At any time, upon Discloser's reasonable request, Recipient shall promptly (and in any event within 30 days) return to Discloser or destroy, at the election of the Discloser, any Confidential Information of the Discloser. In addition, within 30 days after termination of this Agreement, Recipient shall (i) promptly return all tangible materials containing such Confidential Information to Discloser, (ii) remove all Confidential Information (and any copies thereof) from any computer systems of the Recipient, its contractors and its distributors, and confirm in writing that all materials containing Confidential Information have been destroyed or returned to Discloser, as applicable, by Recipient. Recipient shall cause its affiliates, agents, contractors, and employees to strictly comply with the foregoing. +9. No Warranties. +CUSTOMER EXPRESSLY UNDERSTANDS AND AGREES THAT ALL USE OF THE LICENSED SOFTWARE IS AT CUSTOMER'S SOLE RISK AND THAT THE LICENSED SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE." DOCKER, ITS SUBSIDIARIES AND AFFILIATES, AND ITS LICENSORS MAKE NO EXPRESS WARRANTIES AND DISCLAIM ALL IMPLIED WARRANTIES REGARDING THE LICENSED SOFTWARE, INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT, TOGETHER WITH ANY AND ALL WARRANTIES ARISING FROM COURSE OF DEALING OR USAGE IN TRADE. NO ADVICE OR INFORMATION, WHETHER ORAL OR WRITTEN, OBTAINED FROM DOCKER OR ELSEWHERE SHALL CREATE ANY WARRANTY NOT EXPRESSLY STATED IN THIS AGREEMENT. WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, DOCKER, ITS SUBSIDIARIES AND AFFILIATES, AND ITS LICENSORS DO NOT REPRESENT OR WARRANT TO YOU THAT: (A) CUSTOMER'S USE OF THE LICENSED SOFTWARE WILL MEET CUSTOMER'S REQUIREMENTS, OR (B) CUSTOMER'S USE OF THE LICENSED SOFTWARE WILL BE UNINTERRUPTED, TIMELY, SECURE OR FREE FROM ERROR. NOTWITHSTANDING THE FOREGOING, NOTHING HEREIN SHALL EXCLUDE OR LIMIT DOCKER'S WARRANTY OR LIABILITY FOR LOSSES WHICH MAY NOT BE LAWFULLY EXCLUDED OR LIMITED BY APPLICABLE LAW. CUSTOMER UNDERSTANDS AND ACKNOWLEDGES THAT THE LICENSED SOFTWARE IS NOT DESIGNED, INTENDED OR WARRANTED FOR USE IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE CONTROLS, INCLUDING WITHOUT LIMITATION, OPERATION OF NUCLEAR FACILITIES, AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, AND LIFE SUPPORT OR WEAPONS SYSTEMS. +10. Indemnification by Customer. +Customer agrees to hold harmless and indemnify Docker and its subsidiaries, affiliates, officers, agents, employees, advertisers, licensors, suppliers or partners from and against any third party claim arising from or in any way related to Customer's breach of this Agreement, use of the Licensed Software, or violation of applicable laws, rules or regulations in connection with the Licensed Software, including any liability or expense arising from all claims, losses, damages (actual and consequential), suits, judgments, litigation costs and attorneys' fees, of every kind and nature. In such a case, Docker will provide Customer with written notice of such claim, suit or action. +11. Limitation of Liability. +11.1 Exclusion of Damages +Exclusion of Damages. CUSTOMER EXPRESSLY UNDERSTANDS AND AGREES THAT DOCKER, ITS SUBSIDIARIES AND AFFILIATES, AND ITS LICENSORS SHALL NOT BE LIABLE TO CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL CONSEQUENTIAL OR EXEMPLARY DAMAGES INCURRED BY CUSTOMER, HOWEVER CAUSED AND UNDER ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, ANY LOSS OF PROFIT (WHETHER INCURRED DIRECTLY OR INDIRECTLY), ANY LOSS OF GOODWILL OR BUSINESS REPUTATION, ANY LOSS OF DATA SUFFERED, COST OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR OTHER INTANGIBLE LOSS. THE FOREGOING LIMITATIONS ON DOCKER'S LIABILITY SHALL APPLY WHETHER OR NOT DOCKER HAS BEEN ADVISED OF OR SHOULD HAVE BEEN AWARE OF THE POSSIBILITY OF ANY SUCH LOSSES ARISING. NOTWITHSTANDING THE FOREGOING, NOTHING HEREIN SHALL EXCLUDE OR LIMIT DOCKER'S LIABILITY FOR LOSSES WHICH MAY NOT BE LAWFULLY EXCLUDED OR LIMITED BY APPLICABLE LAW. +11.2 Liability Cap +THE TOTAL LIABILITY OF DOCKER ARISING OUT OF OR RELATED TO THIS AGREEMENT WILL NOT EXCEED USD $100. +12. Export Restrictions. +Customer understands that the Licensed Software may contain encryption technology and other software programs that may require an export license from the U.S. State Department and that export or re-export of the Licensed Software to certain entities (such as a foreign government and its subdivisions) and certain countries is prohibited. Customer acknowledges that it will comply with all applicable export and import control laws and regulations of the United States and the foreign jurisdiction in which the Licensed Software is used and, in particular, Customer will not export or re-export the Licensed Software without all required United States and foreign government licenses. Customer will defend, indemnify, and hold harmless Docker and its suppliers and licensors from and against any violation of such laws or regulations by Customer or any of its agents, officers, directors or employees. +13. Miscellaneous. +The Licensed Software and any other software covered under this Agreement are "commercial items" as that term is defined at 48 C.F.R. 2.101; consisting of "commercial computer software" and "commercial computer software documentation" as such terms are used in 48 C.F.R. 12.212. Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4, all U.S. Government end users acquire the Licensed Software and any other software and documentation covered under this Agreement with only those rights set forth herein. This Agreement will be governed by the laws of the State of California without reference to conflict of law principles. Each party agrees to submit to the exclusive jurisdiction of the courts located within the county of San Francisco, California to resolve any legal matter arising from this Agreement. Neither party may assign any of its rights or obligations under this Agreement, whether by operation of law or otherwise, without the prior written consent of the other party (not to be unreasonably withheld). Notwithstanding the foregoing, Docker may assign the entirety of its rights and obligations under this Agreement, without consent of the Customer, to its affiliate or in connection with a merger, acquisition, corporate reorganization, or sale of all or substantially all of its assets. The application of the UN Convention of International Sale of Goods to this Agreement is disclaimed in its entirety. Together with any Order Forms, this is the entire agreement between the parties relating to the subject matter hereof. This Agreement (including applicable Order Forms) shall control over any additional or different terms of any correspondence, order, confirmation, invoice or similar document, even if accepted in writing by both parties, and waivers and amendments of any provision of this Agreement shall be effective only if made by non-preprinted agreements indicating specifically what sections of this Agreement are affected, signed by both parties and clearly understood by both parties to be an amendment or waiver. The failure of either party to enforce its rights under this Agreement at any time for any period shall not be construed as a waiver of such rights. If any provision of this Agreement is held invalid or unenforceable, the remainder of this Agreement will continue in full force and effect and the invalid or unenforceable provision shall be reformed to the extent necessary to make it valid and enforceable. diff --git a/MAINTAINERS b/MAINTAINERS new file mode 100644 index 0000000000..502cad3ad1 --- /dev/null +++ b/MAINTAINERS @@ -0,0 +1,599 @@ +# Docker maintainers file +# +# This file describes who runs the Docker project and how. +# This is a living document - if you see something out of date or missing, +# speak up! +# +# It is structured to be consumable by both humans and programs. +# To extract its contents programmatically, use any TOML-compliant +# parser. + +[Rules] + + [Rules.maintainers] + + title = "What is a maintainer?" + + text = """ +There are different types of maintainers, with different responsibilities, but +all maintainers have 3 things in common: + +1) They share responsibility in the project's success. +2) They have made a long-term, recurring time investment to improve the project. +3) They spend that time doing whatever needs to be done, not necessarily what +is the most interesting or fun. + +Maintainers are often under-appreciated, because their work is harder to appreciate. +It's easy to appreciate a really cool and technically advanced feature. It's harder +to appreciate the absence of bugs, the slow but steady improvement in stability, +or the reliability of a release process. But those things distinguish a good +project from a great one. +""" + + [Rules.bdfl] + + title = "The Benevolent dictator for life (BDFL)" + + text = """ +Docker follows the timeless, highly efficient and totally unfair system +known as [Benevolent dictator for +life](https://en.wikipedia.org/wiki/Benevolent_Dictator_for_Life), with +yours truly, Solomon Hykes, in the role of BDFL. This means that all +decisions are made, by default, by Solomon. Since making every decision +myself would be highly un-scalable, in practice decisions are spread +across multiple maintainers. + +Ideally, the BDFL role is like the Queen of England: awesome crown, but not +an actual operational role day-to-day. The real job of a BDFL is to NEVER GO AWAY. +Every other rule can change, perhaps drastically so, but the BDFL will always +be there, preserving the philosophy and principles of the project, and keeping +ultimate authority over its fate. This gives us great flexibility in experimenting +with various governance models, knowing that we can always press the "reset" button +without fear of fragmentation or deadlock. See the US congress for a counter-example. + +BDFL daily routine: + +* Is the project governance stuck in a deadlock or irreversibly fragmented? + * If yes: refactor the project governance +* Are there issues or conflicts escalated by core? + * If yes: resolve them +* Go back to polishing that crown. +""" + + [Rules.decisions] + + title = "How are decisions made?" + + text = """ +Short answer: EVERYTHING IS A PULL REQUEST. + +Docker is an open-source project with an open design philosophy. This +means that the repository is the source of truth for EVERY aspect of the +project, including its philosophy, design, road map, and APIs. *If it's +part of the project, it's in the repo. If it's in the repo, it's part of +the project.* + +As a result, all decisions can be expressed as changes to the +repository. An implementation change is a change to the source code. An +API change is a change to the API specification. A philosophy change is +a change to the philosophy manifesto, and so on. + +All decisions affecting Docker, big and small, follow the same 3 steps: + +* Step 1: Open a pull request. Anyone can do this. + +* Step 2: Discuss the pull request. Anyone can do this. + +* Step 3: Merge or refuse the pull request. Who does this depends on the nature +of the pull request and which areas of the project it affects. See *review flow* +for details. + +Because Docker is such a large and active project, it's important for everyone to know +who is responsible for deciding what. That is determined by a precise set of rules. + +* For every *decision* in the project, the rules should designate, in a deterministic way, +who should *decide*. + +* For every *problem* in the project, the rules should designate, in a deterministic way, +who should be responsible for *fixing* it. + +* For every *question* in the project, the rules should designate, in a deterministic way, +who should be expected to have the *answer*. +""" + + [Rules.review] + + title = "Review flow" + + text = """ +Pull requests should be processed according to the following flow: + +* For each subsystem affected by the change, the maintainers of the subsystem must approve or refuse it. +It is the responsibility of the subsystem maintainers to process patches affecting them in a timely +manner. + +* If the change affects areas of the code which are not part of a subsystem, +or if subsystem maintainers are unable to reach a timely decision, it must be approved by +the core maintainers. + +* If the change affects the UI or public APIs, or if it represents a major change in architecture, +the architects must approve or refuse it. + +* If the change affects the operations of the project, it must be approved or rejected by +the relevant operators. + +* If the change affects the governance, philosophy, goals or principles of the project, +it must be approved by BDFL. +""" + + [Rules.DCO] + + title = "Helping contributors with the DCO" + + text = """ +The [DCO or `Sign your work`]( +https://github.com/docker/docker/blob/master/CONTRIBUTING.md#sign-your-work) +requirement is not intended as a roadblock or speed bump. + +Some Docker contributors are not as familiar with `git`, or have used a web based +editor, and thus asking them to `git commit --amend -s` is not the best way forward. + +In this case, maintainers can update the commits based on clause (c) of the DCO. The +most trivial way for a contributor to allow the maintainer to do this, is to add +a DCO signature in a Pull Requests's comment, or a maintainer can simply note that +the change is sufficiently trivial that it does not substantially change the existing +contribution - i.e., a spelling change. + +When you add someone's DCO, please also add your own to keep a log. +""" + + [Rules.holiday] + + title = "I'm a maintainer, and I'm going on holiday" + + text = """ +Please let your co-maintainers and other contributors know by raising a pull +request that comments out your `MAINTAINERS` file entry using a `#`. +""" + + [Rules."no direct push"] + + title = "I'm a maintainer. Should I make pull requests too?" + + text = """ +Yes. Nobody should ever push to master directly. All changes should be +made through a pull request. +""" + + [Rules.meta] + + title = "How is this process changed?" + + text = "Just like everything else: by making a pull request :)" + +# Current project organization +[Org] + + bdfl = "shykes" + + # The chief architect is responsible for the overall integrity of the technical architecture + # across all subsystems, and the consistency of APIs and UI. + # + # Changes to UI, public APIs and overall architecture (for example a plugin system) must + # be approved by the chief architect. + "Chief Architect" = "shykes" + + [Org.Operators] + + # The operators make sure the trains run on time. They are responsible for overall operations + # of the project. This includes facilitating communication between all the participants; helping + # newcomers get involved and become successful contributors and maintainers; tracking the schedule + # of releases; managing the relationship with downstream distributions and upstream dependencies; + # define measures of success for the project and measure progress; Devise and implement tools and + # processes which make contributors and maintainers happier and more efficient. + + + [Org.Operators.security] + + people = [ + "erw", + "diogomonica", + "nathanmccauley" + ] + + [Org.Operators."monthly meetings"] + + people = [ + "sven", + "tianon" + ] + + [Org.Operators.infrastructure] + + people = [ + "jfrazelle", + "crosbymichael" + ] + + [Org.Operators.community] + people = [ + "theadactyl" + ] + + # The chief maintainer is responsible for all aspects of quality for the project including + # code reviews, usability, stability, security, performance, etc. + # The most important function of the chief maintainer is to lead by example. On the first + # day of a new maintainer, the best advice should be "follow the C.M.'s example and you'll + # be fine". + "Chief Maintainer" = "crosbymichael" + + # The community manager is responsible for serving the project community, including users, + # contributors and partners. This involves: + # - facilitating communication between maintainers, contributors and users + # - organizing contributor and maintainer events + # - helping new contributors get involved + # - anything the project community needs to be successful + # + # The community manager is a point of contact for any contributor who has questions, concerns + # or feedback about project operations. + "Community Manager" = "theadactyl" + + [Org."Core maintainers"] + + # The Core maintainers are the ghostbusters of the project: when there's a problem others + # can't solve, they show up and fix it with bizarre devices and weaponry. + # They have final say on technical implementation and coding style. + # They are ultimately responsible for quality in all its forms: usability polish, + # bugfixes, performance, stability, etc. When ownership can cleanly be passed to + # a subsystem, they are responsible for doing so and holding the + # subsystem maintainers accountable. If ownership is unclear, they are the de facto owners. + + # For each release (including minor releases), a "release captain" is assigned from the + # pool of core maintainers. Rotation is encouraged across all maintainers, to ensure + # the release process is clear and up-to-date. + # + # It is common for core maintainers to "branch out" to join or start a subsystem. + + people = [ + "calavera", + "crosbymichael", + "erikh", + "estesp", + "icecrime", + "jfrazelle", + "lk4d4", + "runcom", + "tibor", + "unclejack", + "vbatts", + "vdemeester", + "vieux", + "vishh" + ] + + [Org.Subsystems] + + # As the project grows, it gets separated into well-defined subsystems. Each subsystem + # has a dedicated group of maintainers, which are dedicated to that subsytem and responsible + # for its quality. + # This "cellular division" is the primary mechanism for scaling maintenance of the project as it grows. + # + # The maintainers of each subsytem are responsible for: + # + # 1. Exposing a clear road map for improving their subsystem. + # 2. Deliver prompt feedback and decisions on pull requests affecting their subsystem. + # 3. Be available to anyone with questions, bug reports, criticism etc. + # on their component. This includes IRC, GitHub requests and the mailing + # list. + # 4. Make sure their subsystem respects the philosophy, design and + # road map of the project. + # + # #### How to review patches to your subsystem + # + # Accepting pull requests: + # + # - If the pull request appears to be ready to merge, give it a `LGTM`, which + # stands for "Looks Good To Me". + # - If the pull request has some small problems that need to be changed, make + # a comment adressing the issues. + # - If the changes needed to a PR are small, you can add a "LGTM once the + # following comments are addressed..." this will reduce needless back and + # forth. + # - If the PR only needs a few changes before being merged, any MAINTAINER can + # make a replacement PR that incorporates the existing commits and fixes the + # problems before a fast track merge. + # + # Closing pull requests: + # + # - If a PR appears to be abandoned, after having attempted to contact the + # original contributor, then a replacement PR may be made. Once the + # replacement PR is made, any contributor may close the original one. + # - If you are not sure if the pull request implements a good feature or you + # do not understand the purpose of the PR, ask the contributor to provide + # more documentation. If the contributor is not able to adequately explain + # the purpose of the PR, the PR may be closed by any MAINTAINER. + # - If a MAINTAINER feels that the pull request is sufficiently architecturally + # flawed, or if the pull request needs significantly more design discussion + # before being considered, the MAINTAINER should close the pull request with + # a short explanation of what discussion still needs to be had. It is + # important not to leave such pull requests open, as this will waste both the + # MAINTAINER's time and the contributor's time. It is not good to string a + # contributor on for weeks or months, having them make many changes to a PR + # that will eventually be rejected. + + [Org.Subsystems.Documentation] + + people = [ + "james", + "moxiegirl", + "thaJeztah", + "jamtur01", + "sven" + ] + + [Org.Subsystems.libcontainer] + + people = [ + "crosbymichael", + "jnagal", + "lk4d4", + "mpatel", + "vmarmol" + ] + + [Org.Subsystems.registry] + + people = [ + "dmcg", + "dmp42", + "jlhawn", + "samalba", + "sday", + "vbatts" + ] + + [Org.Subsystems."build tools"] + + people = [ + "shykes", + "tianon" + ] + + [Org.Subsystem."remote api"] + + people = [ + "vieux" + ] + + [Org.Subsystem.swarm] + + people = [ + "aluzzardi", + "vieux" + ] + + [Org.Subsystem.machine] + + people = [ + "bfirsh", + "ehazlett" + ] + + [Org.Subsystem.compose] + + people = [ + "aanand" + ] + + [Org.Subsystem.builder] + + people = [ + "duglin", + "erikh", + "tibor" + ] + + [Org.Curators] + + # The curators help ensure that incoming issues and pull requests are properly triaged and + # that our various contribution and reviewing processes are respected. With their knowledge of + # the repository activity, they can also guide contributors to relevant material or + # discussions. + # + # They are neither code nor docs reviewers, so they are never expected to merge. They can + # however: + # - close an issue or pull request when it's an exact duplicate + # - close an issue or pull request when it's inappropriate or off-topic + + people = [ + "thajeztah" + ] + + +[people] + +# A reference list of all people associated with the project. +# All other sections should refer to people by their canonical key +# in the people section. + + # ADD YOURSELF HERE IN ALPHABETICAL ORDER + + [people.aanand] + Name = "Aanand Prasad" + Email = "aanand@docker.com" + GitHub = "aanand" + + [people.aluzzardi] + Name = "Andrea Luzzardi" + Email = "aluzzardi@docker.com" + GitHub = "aluzzardi" + + [people.bfirsh] + Name = "Ben Firshman" + Email = "ben@firshman.co.uk" + GitHub = "bfirsh" + + [people.calavera] + Name = "David Calavera" + Email = "david.calavera@gmail.com" + GitHub = "calavera" + + [people.cpuguy83] + Name = "Brian Goff" + Email = "cpuguy83@gmail.com" + Github = "cpuguy83" + + [people.crosbymichael] + Name = "Michael Crosby" + Email = "crosbymichael@gmail.com" + GitHub = "crosbymichael" + + [people.diogomonica] + Name = "Diogo Monica" + Email = "diogo@docker.com" + GitHub = "diogomonica" + + [people.duglin] + Name = "Doug Davis" + Email = "dug@us.ibm.com" + GitHub = "duglin" + + [people.dmcg] + Name = "Derek McGowan" + Email = "derek@docker.com" + Github = "dmcgowan" + + [people.dmp42] + Name = "Olivier Gambier" + Email = "olivier@docker.com" + Github = "dmp42" + + [people.ehazlett] + Name = "Evan Hazlett" + Email = "ejhazlett@gmail.com" + GitHub = "ehazlett" + + [people.erikh] + Name = "Erik Hollensbe" + Email = "erik@docker.com" + GitHub = "erikh" + + [people.erw] + Name = "Eric Windisch" + Email = "eric@windisch.us" + GitHub = "ewindisch" + + [people.estesp] + Name = "Phil Estes" + Email = "estesp@linux.vnet.ibm.com" + GitHub = "estesp" + + [people.icecrime] + Name = "Arnaud Porterie" + Email = "arnaud@docker.com" + GitHub = "icecrime" + + [people.jfrazelle] + Name = "Jessie Frazelle" + Email = "j@docker.com" + GitHub = "jfrazelle" + + [people.jlhawn] + Name = "Josh Hawn" + Email = "josh.hawn@docker.com" + Github = "jlhawn" + + [people.jnagal] + Name = "Rohit Jnagal" + Email = "jnagal@google.com" + GitHub = "rjnagal" + + [people.lk4d4] + Name = "Alexander Morozov" + Email = "lk4d4@docker.com" + GitHub = "lk4d4" + + [people.moxiegirl] + Name = "Mary Anthony" + Email = "mary.anthony@docker.com" + GitHub = "moxiegirl" + + [people.mpatel] + Name = "Mrunal Patel" + Email = "mpatel@redhat.com" + GitHub = "mrunalp" + + [people.nathanmccauley] + Name = "Nathan McCauley" + Email = "nathan.mccauley@docker.com" + GitHub = "nathanmccauley" + + [people.runcom] + Name = "Antonio Murdaca" + Email = "me@runcom.ninja" + GitHub = "runcom" + + [people.sday] + Name = "Stephen Day" + Email = "stephen.day@docker.com" + Github = "stevvooe" + + [people.shykes] + Name = "Solomon Hykes" + Email = "solomon@docker.com" + GitHub = "shykes" + + [people.sven] + Name = "Sven Dowideit" + Email = "SvenDowideit@home.org.au" + GitHub = "SvenDowideit" + + [people.thajeztah] + Name = "Sebastiaan van Stijn" + Email = "github@gone.nl" + GitHub = "thaJeztah" + + [people.theadactyl] + Name = "Thea Lamkin" + Email = "thea@docker.com" + GitHub = "theadactyl" + + [people.tianon] + Name = "Tianon Gravi" + Email = "admwiggin@gmail.com" + GitHub = "tianon" + + [people.tibor] + Name = "Tibor Vass" + Email = "tibor@docker.com" + GitHub = "tiborvass" + + [people.unclejack] + Name = "Cristian Staretu" + Email = "cristian.staretu@gmail.com" + GitHub = "unclejack" + + [people.vbatts] + Name = "Vincent Batts" + Email = "vbatts@redhat.com" + GitHub = "vbatts" + + [people.vdemeester] + Name = "Vincent Demeester" + Email = "vincent@sbr.pm" + GitHub = "vdemeester" + + [people.vieux] + Name = "Victor Vieux" + Email = "vieux@docker.com" + GitHub = "vieux" + + [people.vishh] + Name = "Vishnu Kannan" + Email = "vishnuk@google.com" + GitHub = "vishh" + + [people.vmarmol] + Name = "Victor Marmol" + Email = "vmarmol@google.com" + GitHub = "vmarmol" diff --git a/Makefile b/Makefile new file mode 100644 index 0000000000..f298552085 --- /dev/null +++ b/Makefile @@ -0,0 +1,84 @@ +.PHONY: all binary build cross default docs docs-build docs-shell docs-cs shell test test-unit test-integration-cli test-docker-py validate + +# env vars passed through directly to Docker's build scripts +# to allow things like `make DOCKER_CLIENTONLY=1 binary` easily +# `docs/sources/contributing/devenvironment.md ` and `project/PACKAGERS.md` have some limited documentation of some of these +DOCKER_ENVS := \ + -e BUILDFLAGS \ + -e DOCKER_CLIENTONLY \ + -e DOCKER_DEBUG \ + -e DOCKER_EXECDRIVER \ + -e DOCKER_EXPERIMENTAL \ + -e DOCKER_REMAP_ROOT \ + -e DOCKER_GRAPHDRIVER \ + -e DOCKER_STORAGE_OPTS \ + -e DOCKER_USERLANDPROXY \ + -e TESTDIRS \ + -e TESTFLAGS \ + -e TIMEOUT +# note: we _cannot_ add "-e DOCKER_BUILDTAGS" here because even if it's unset in the shell, that would shadow the "ENV DOCKER_BUILDTAGS" set in our Dockerfile, which is very important for our official builds + +# to allow `make BIND_DIR=. shell` or `make BIND_DIR= test` +# (default to no bind mount if DOCKER_HOST is set) +# note: BINDDIR is supported for backwards-compatibility here +BIND_DIR := $(if $(BINDDIR),$(BINDDIR),$(if $(DOCKER_HOST),,bundles)) +DOCKER_MOUNT := $(if $(BIND_DIR),-v "$(CURDIR)/$(BIND_DIR):/go/src/github.com/docker/docker/$(BIND_DIR)") + + +GIT_BRANCH := $(shell git rev-parse --abbrev-ref HEAD 2>/dev/null) +DOCKER_IMAGE := docker-dev$(if $(GIT_BRANCH),:$(GIT_BRANCH)) +DOCKER_DOCS_IMAGE := docker-docs$(if $(GIT_BRANCH),:$(GIT_BRANCH)) + +DOCKER_RUN_DOCKER := docker run --rm -it --privileged $(DOCKER_ENVS) $(DOCKER_MOUNT) "$(DOCKER_IMAGE)" + +DOCKER_RUN_DOCS := docker run --rm -it $(DOCS_MOUNT) -e AWS_S3_BUCKET -e NOCACHE + +# for some docs workarounds (see below in "docs-build" target) +GITCOMMIT := $(shell git rev-parse --short HEAD 2>/dev/null) + +default: binary + +all: build + $(DOCKER_RUN_DOCKER) hack/make.sh + +binary: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary + +cross: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary cross + +deb: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary build-deb + +rpm: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary build-rpm + +test: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary cross test-unit test-integration-cli test-docker-py + +test-unit: build + $(DOCKER_RUN_DOCKER) hack/make.sh test-unit + +test-integration-cli: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary test-integration-cli + +test-docker-py: build + $(DOCKER_RUN_DOCKER) hack/make.sh binary test-docker-py + +validate: build + $(DOCKER_RUN_DOCKER) hack/make.sh validate-dco validate-gofmt validate-pkg validate-lint validate-test validate-toml validate-vet + +shell: build + $(DOCKER_RUN_DOCKER) bash + +build: bundles + docker build -t "$(DOCKER_IMAGE)" . + +bundles: + mkdir bundles + +docs: + $(MAKE) -C docs docs + +docs-cs: + $(MAKE) -C docs-cs docs diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000000..6e6f469ab9 --- /dev/null +++ b/NOTICE @@ -0,0 +1,19 @@ +Docker +Copyright 2012-2015 Docker, Inc. + +This product includes software developed at Docker, Inc. (https://www.docker.com). + +This product contains software (https://github.com/kr/pty) developed +by Keith Rarick, licensed under the MIT License. + +The following is courtesy of our legal counsel: + + +Use and transfer of Docker may be subject to certain restrictions by the +United States and other governments. +It is your responsibility to ensure that your use and/or transfer does not +violate applicable laws. + +For more information, please see https://www.bis.doc.gov + +See also https://www.apache.org/dev/crypto.html and/or seek legal counsel. diff --git a/README.md b/README.md new file mode 100644 index 0000000000..a4d65c320a --- /dev/null +++ b/README.md @@ -0,0 +1,300 @@ +Docker: the container engine [![Release](https://img.shields.io/github/release/docker/docker.svg)](https://github.com/docker/docker/releases/latest) +============================ + +Docker is an open source project to pack, ship and run any application +as a lightweight container. + +Docker containers are both *hardware-agnostic* and *platform-agnostic*. +This means they can run anywhere, from your laptop to the largest +cloud compute instance and everything in between - and they don't require +you to use a particular language, framework or packaging system. That +makes them great building blocks for deploying and scaling web apps, +databases, and backend services without depending on a particular stack +or provider. + +Docker began as an open-source implementation of the deployment engine which +powers [dotCloud](https://www.dotcloud.com), a popular Platform-as-a-Service. +It benefits directly from the experience accumulated over several years +of large-scale operation and support of hundreds of thousands of +applications and databases. + +![Docker L](docs/static_files/docker-logo-compressed.png "Docker") + +## Security Disclosure + +Security is very important to us. If you have any issue regarding security, +please disclose the information responsibly by sending an email to +security@docker.com and not by creating a github issue. + +## Better than VMs + +A common method for distributing applications and sandboxing their +execution is to use virtual machines, or VMs. Typical VM formats are +VMware's vmdk, Oracle VirtualBox's vdi, and Amazon EC2's ami. In theory +these formats should allow every developer to automatically package +their application into a "machine" for easy distribution and deployment. +In practice, that almost never happens, for a few reasons: + + * *Size*: VMs are very large which makes them impractical to store + and transfer. + * *Performance*: running VMs consumes significant CPU and memory, + which makes them impractical in many scenarios, for example local + development of multi-tier applications, and large-scale deployment + of cpu and memory-intensive applications on large numbers of + machines. + * *Portability*: competing VM environments don't play well with each + other. Although conversion tools do exist, they are limited and + add even more overhead. + * *Hardware-centric*: VMs were designed with machine operators in + mind, not software developers. As a result, they offer very + limited tooling for what developers need most: building, testing + and running their software. For example, VMs offer no facilities + for application versioning, monitoring, configuration, logging or + service discovery. + +By contrast, Docker relies on a different sandboxing method known as +*containerization*. Unlike traditional virtualization, containerization +takes place at the kernel level. Most modern operating system kernels +now support the primitives necessary for containerization, including +Linux with [openvz](https://openvz.org), +[vserver](http://linux-vserver.org) and more recently +[lxc](https://linuxcontainers.org/), Solaris with +[zones](https://docs.oracle.com/cd/E26502_01/html/E29024/preface-1.html#scrolltoc), +and FreeBSD with +[Jails](https://www.freebsd.org/doc/handbook/jails.html). + +Docker builds on top of these low-level primitives to offer developers a +portable format and runtime environment that solves all four problems. +Docker containers are small (and their transfer can be optimized with +layers), they have basically zero memory and cpu overhead, they are +completely portable, and are designed from the ground up with an +application-centric design. + +Perhaps best of all, because Docker operates at the OS level, it can still be +run inside a VM! + +## Plays well with others + +Docker does not require you to buy into a particular programming +language, framework, packaging system, or configuration language. + +Is your application a Unix process? Does it use files, tcp connections, +environment variables, standard Unix streams and command-line arguments +as inputs and outputs? Then Docker can run it. + +Can your application's build be expressed as a sequence of such +commands? Then Docker can build it. + +## Escape dependency hell + +A common problem for developers is the difficulty of managing all +their application's dependencies in a simple and automated way. + +This is usually difficult for several reasons: + + * *Cross-platform dependencies*. Modern applications often depend on + a combination of system libraries and binaries, language-specific + packages, framework-specific modules, internal components + developed for another project, etc. These dependencies live in + different "worlds" and require different tools - these tools + typically don't work well with each other, requiring awkward + custom integrations. + + * *Conflicting dependencies*. Different applications may depend on + different versions of the same dependency. Packaging tools handle + these situations with various degrees of ease - but they all + handle them in different and incompatible ways, which again forces + the developer to do extra work. + + * *Custom dependencies*. A developer may need to prepare a custom + version of their application's dependency. Some packaging systems + can handle custom versions of a dependency, others can't - and all + of them handle it differently. + + +Docker solves the problem of dependency hell by giving the developer a simple +way to express *all* their application's dependencies in one place, while +streamlining the process of assembling them. If this makes you think of +[XKCD 927](https://xkcd.com/927/), don't worry. Docker doesn't +*replace* your favorite packaging systems. It simply orchestrates +their use in a simple and repeatable way. How does it do that? With +layers. + +Docker defines a build as running a sequence of Unix commands, one +after the other, in the same container. Build commands modify the +contents of the container (usually by installing new files on the +filesystem), the next command modifies it some more, etc. Since each +build command inherits the result of the previous commands, the +*order* in which the commands are executed expresses *dependencies*. + +Here's a typical Docker build process: + +```bash +FROM ubuntu:12.04 +RUN apt-get update && apt-get install -y python python-pip curl +RUN curl -sSL https://github.com/shykes/helloflask/archive/master.tar.gz | tar -xzv +RUN cd helloflask-master && pip install -r requirements.txt +``` + +Note that Docker doesn't care *how* dependencies are built - as long +as they can be built by running a Unix command in a container. + + +Getting started +=============== + +Docker can be installed on your local machine as well as servers - both +bare metal and virtualized. It is available as a binary on most modern +Linux systems, or as a VM on Windows, Mac and other systems. + +We also offer an [interactive tutorial](https://www.docker.com/tryit/) +for quickly learning the basics of using Docker. + +For up-to-date install instructions, see the [Docs](https://docs.docker.com). + +Usage examples +============== + +Docker can be used to run short-lived commands, long-running daemons +(app servers, databases, etc.), interactive shell sessions, etc. + +You can find a [list of real-world +examples](https://docs.docker.com/examples/) in the +documentation. + +Under the hood +-------------- + +Under the hood, Docker is built on the following components: + +* The + [cgroups](https://www.kernel.org/doc/Documentation/cgroups/cgroups.txt) + and + [namespaces](http://man7.org/linux/man-pages/man7/namespaces.7.html) + capabilities of the Linux kernel +* The [Go](https://golang.org) programming language +* The [Docker Image Specification](https://github.com/docker/docker/blob/master/image/spec/v1.md) +* The [Libcontainer Specification](https://github.com/opencontainers/runc/blob/master/libcontainer/SPEC.md) + +Contributing to Docker [![GoDoc](https://godoc.org/github.com/docker/docker?status.svg)](https://godoc.org/github.com/docker/docker) +====================== + +| **Master** (Linux) | **Experimental** (linux) | **Windows** | **FreeBSD** | +|------------------|----------------------|---------|---------| +| [![Jenkins Build Status](https://jenkins.dockerproject.org/view/Docker/job/Docker%20Master/badge/icon)](https://jenkins.dockerproject.org/view/Docker/job/Docker%20Master/) | [![Jenkins Build Status](https://jenkins.dockerproject.org/view/Docker/job/Docker%20Master%20%28experimental%29/badge/icon)](https://jenkins.dockerproject.org/view/Docker/job/Docker%20Master%20%28experimental%29/) | [![Build Status](http://jenkins.dockerproject.org/job/Docker%20Master%20(windows)/badge/icon)](http://jenkins.dockerproject.org/job/Docker%20Master%20(windows)/) | [![Build Status](http://jenkins.dockerproject.org/job/Docker%20Master%20(freebsd)/badge/icon)](http://jenkins.dockerproject.org/job/Docker%20Master%20(freebsd)/) | + +Want to hack on Docker? Awesome! We have [instructions to help you get +started contributing code or documentation](https://docs.docker.com/project/who-written-for/). + +These instructions are probably not perfect, please let us know if anything +feels wrong or incomplete. Better yet, submit a PR and improve them yourself. + +Getting the development builds +============================== + +Want to run Docker from a master build? You can download +master builds at [master.dockerproject.org](https://master.dockerproject.org). +They are updated with each commit merged into the master branch. + +Don't know how to use that super cool new feature in the master build? Check +out the master docs at +[docs.master.dockerproject.org](http://docs.master.dockerproject.org). + +How the project is run +====================== + +Docker is a very, very active project. If you want to learn more about how it is run, +or want to get more involved, the best place to start is [the project directory](https://github.com/docker/docker/tree/master/project). + +We are always open to suggestions on process improvements, and are always looking for more maintainers. + +### Talking to other Docker users and contributors + + + + + + + + + + + + + + + + + + + + +
Internet Relay Chat (IRC) +

+ IRC a direct line to our most knowledgeable Docker users; we have + both the #docker and #docker-dev group on + irc.freenode.net. + IRC is a rich chat protocol but it can overwhelm new users. You can search + our chat archives. +

+ Read our IRC quickstart guide for an easy way to get started. +
Google Groups + There are two groups. + Docker-user + is for people using Docker containers. + The docker-dev + group is for contributors and other people contributing to the Docker + project. +
Twitter + You can follow Docker's Twitter feed + to get updates on our products. You can also tweet us questions or just + share blogs or stories. +
Stack Overflow + Stack Overflow has over 7000 Docker questions listed. We regularly + monitor Docker questions + and so do many other knowledgeable Docker users. +
+ +### Legal + +*Brought to you courtesy of our legal counsel. For more context, +please see the [NOTICE](https://github.com/docker/docker/blob/master/NOTICE) document in this repo.* + +Use and transfer of Docker may be subject to certain restrictions by the +United States and other governments. + +It is your responsibility to ensure that your use and/or transfer does not +violate applicable laws. + +For more information, please see https://www.bis.doc.gov + + +Licensing +========= +Docker is licensed under the Apache License, Version 2.0. See +[LICENSE](https://github.com/docker/docker/blob/master/LICENSE) for the full +license text. + +Other Docker Related Projects +============================= +There are a number of projects under development that are based on Docker's +core technology. These projects expand the tooling built around the +Docker platform to broaden its application and utility. + +* [Docker Registry](https://github.com/docker/distribution): Registry +server for Docker (hosting/delivery of repositories and images) +* [Docker Machine](https://github.com/docker/machine): Machine management +for a container-centric world +* [Docker Swarm](https://github.com/docker/swarm): A Docker-native clustering +system +* [Docker Compose](https://github.com/docker/compose) (formerly Fig): +Define and run multi-container apps +* [Kitematic](https://github.com/kitematic/kitematic): The easiest way to use +Docker on Mac and Windows + +If you know of another project underway that should be listed here, please help +us keep this list up-to-date by submitting a PR. + +Awesome-Docker +============== +You can find more projects, tools and articles related to Docker on the [awesome-docker list](https://github.com/veggiemonk/awesome-docker). Add your project there. diff --git a/ROADMAP.md b/ROADMAP.md new file mode 100644 index 0000000000..4ec0bf0a05 --- /dev/null +++ b/ROADMAP.md @@ -0,0 +1,183 @@ +Docker Engine Roadmap +===================== + +### How should I use this document? + +This document provides description of items that the project decided to prioritize. This should +serve as a reference point for Docker contributors to understand where the project is going, and +help determine if a contribution could be conflicting with some longer terms plans. + +The fact that a feature isn't listed here doesn't mean that a patch for it will automatically be +refused (except for those mentioned as "frozen features" below)! We are always happy to receive +patches for new cool features we haven't thought about, or didn't judge priority. Please however +understand that such patches might take longer for us to review. + +### How can I help? + +Short term objectives are listed in the [wiki](https://github.com/docker/docker/wiki) and described +in [Issues](https://github.com/docker/docker/issues?q=is%3Aopen+is%3Aissue+label%3Aroadmap). Our +goal is to split down the workload in such way that anybody can jump in and help. Please comment on +issues if you want to take it to avoid duplicating effort! Similarly, if a maintainer is already +assigned on an issue you'd like to participate in, pinging him on IRC or GitHub to offer your help is +the best way to go. + +### How can I add something to the roadmap? + +The roadmap process is new to the Docker Engine: we are only beginning to structure and document the +project objectives. Our immediate goal is to be more transparent, and work with our community to +focus our efforts on fewer prioritized topics. + +We hope to offer in the near future a process allowing anyone to propose a topic to the roadmap, but +we are not quite there yet. For the time being, the BDFL remains the keeper of the roadmap, and we +won't be accepting pull requests adding or removing items from this file. + +# 1. Features and refactoring + +## 1.1 Security + +Security is a top objective for the Docker Engine. The most notable items we intend to provide in +the near future are: + +- Trusted distribution of images: the effort is driven by the [distribution](https://github.com/docker/distribution) +group but will have significant impact on the Engine +- [User namespaces](https://github.com/docker/docker/pull/12648) +- [Seccomp support](https://github.com/docker/libcontainer/pull/613) + +## 1.2 Plumbing project + +We define a plumbing tool as a standalone piece of software usable and meaningful on its own. In +the current state of the Docker Engine, most subsystems provide independent functionalities (such +the builder, pushing and pulling images, running applications in a containerized environment, etc) +but all are coupled in a single binary. We want to offer the users to flexibility to use only the +pieces they need, and we will also gain in maintainability by splitting the project among multiple +repositories. + +As it currently stands, the rough design outlines is to have: +- Low level plumbing tools, each dealing with one responsibility (e.g., [runC](https://runc.io)) +- Docker subsystems services, each exposing an elementary concept over an API, and relying on one or +multiple lower level plumbing tools for their implementation (e.g., network management) +- Docker Engine to expose higher level actions (e.g., create a container with volume `V` and network +`N`), while still providing pass-through access to the individual subsystems. + +The architectural details are still being worked on, but one thing we know for sure is that we need +to technically decouple the pieces. + +### 1.2.1 Runtime + +A Runtime tool already exists today in the form of [runC](https://github.com/opencontainers/runc). +We intend to modify the Engine to directly call out to a binary implementing the Open Containers +Specification such as runC rather than relying on libcontainer to set the container runtime up. + +This plan will deprecate the existing [`execdriver`](https://github.com/docker/docker/tree/master/daemon/execdriver) +as different runtime backends will be implemented as separated binaries instead of being compiled +into the Engine. + +### 1.2.2 Builder + +The Builder (i.e., the ability to build an image from a Dockerfile) is already nicely decoupled, +but would benefit from being entirely separated from the Engine, and rely on the standard Engine +API for its operations. + +### 1.2.3 Distribution + +Distribution already has a [dedicated repository](https://github.com/docker/distribution) which +holds the implementation for Registry v2 and client libraries. We could imagine going further by +having the Engine call out to a binary providing image distribution related functionalities. + +There are two short term goals related to image distribution. The first is stabilize and simplify +the push/pull code. Following that is the conversion to the more secure Registry V2 protocol. + +### 1.2.4 Networking + +Most of networking related code was already decoupled today in [libnetwork](https://github.com/docker/libnetwork). +As with other ingredients, we might want to take it a step further and make it a meaningful utility +that the Engine would call out to instead of a library. + +## 1.3 Plugins + +An initiative around plugins started with Docker 1.7.0, with the goal of allowing for out of +process extensibility of some Docker functionalities, starting with volumes and networking. The +approach is to provide specific extension points rather than generic hooking facilities. We also +deliberately keep the extensions API the simplest possible, expanding as we discover valid use +cases that cannot be implemented. + +At the time of writing: + +- Plugin support is merged as an experimental feature: real world use cases and user feedback will +help us refine the UX to make the feature more user friendly. +- There are no immediate plans to expand on the number of pluggable subsystems. +- Golang 1.5 might add language support for [plugins](https://docs.google.com/document/d/1nr-TQHw_er6GOQRsF6T43GGhFDelrAP0NqSS_00RgZQ) +which we consider supporting as an alternative to JSON/HTTP. + +## 1.4 Volume management + +Volumes are not a first class citizen in the Engine today: we would like better volume management, +similar to the way network are managed in the new [CNM](https://github.com/docker/docker/issues/9983). + +## 1.5 Better API implementation + +The current Engine API is insufficiently typed, versioned, and ultimately hard to maintain. We +also suffer from the lack of a common implementation with [Swarm](https://github.com/docker/swarm). + +## 1.6 Checkpoint/restore + +Support for checkpoint/restore was [merged](https://github.com/docker/libcontainer/pull/479) in +[libcontainer](https://github.com/docker/libcontainer) and made available through [runC](https://runc.io): +we intend to take advantage of it in the Engine. + +# 2 Frozen features + +## 2.1 Docker exec + +We won't accept patches expanding the surface of `docker exec`, which we intend to keep as a +*debugging* feature, as well as being strongly dependent on the Runtime ingredient effort. + +## 2.2 Dockerfile syntax + +The Dockerfile syntax as we know it is simple, and has proven successful in supporting all our +[official images](https://github.com/docker-library/official-images). Although this is *not* a +definitive move, we temporarily won't accept more patches to the Dockerfile syntax for several +reasons: + +- Long term impact of syntax changes is a sensitive matter that require an amount of attention +the volume of Engine codebase and activity today doesn't allow us to provide. +- Allowing the Builder to be implemented as a separate utility consuming the Engine's API will +open the door for many possibilities, such as offering alternate syntaxes or DSL for existing +languages without cluttering the Engine's codebase. +- A standalone Builder will also offer the opportunity for a better dedicated group of maintainers +to own the Dockerfile syntax and decide collectively on the direction to give it. +- Our experience with official images tend to show that no new instruction or syntax expansion is +*strictly* necessary for the majority of use cases, and although we are aware many things are still +lacking for many, we cannot make it a priority yet for the above reasons. + +Again, this is not about saying that the Dockerfile syntax is done, it's about making choices about +what we want to do first! + +## 2.3 Remote Registry Operations + +A large amount of work is ongoing in the area of image distribution and +provenance. This includes moving to the V2 Registry API and heavily +refactoring the code that powers these features. The desired result is more +secure, reliable and easier to use image distribution. + +Part of the problem with this part of the code base is the lack of a stable +and flexible interface. If new features are added that access the registry +without solidifying these interfaces, achieving feature parity will continue +to be elusive. While we get a handle on this situation, we are imposing a +moratorium on new code that accesses the Registry API in commands that don't +already make remote calls. + +Currently, only the following commands cause interaction with a remote +registry: + +- push +- pull +- run +- build +- search +- login + +In the interest of stabilizing the registry access model during this ongoing +work, we are not accepting additions to other commands that will cause remote +interaction with the Registry API. This moratorium will lift when the goals of +the distribution project have been met. diff --git a/VERSION b/VERSION new file mode 100644 index 0000000000..fee7875d28 --- /dev/null +++ b/VERSION @@ -0,0 +1 @@ +1.9.1-cs3 diff --git a/api/README.md b/api/README.md new file mode 100644 index 0000000000..453f61a1a1 --- /dev/null +++ b/api/README.md @@ -0,0 +1,5 @@ +This directory contains code pertaining to the Docker API: + + - Used by the docker client when communicating with the docker daemon + + - Used by third party tools wishing to interface with the docker daemon diff --git a/api/client/attach.go b/api/client/attach.go new file mode 100644 index 0000000000..8d0569b07d --- /dev/null +++ b/api/client/attach.go @@ -0,0 +1,84 @@ +package client + +import ( + "encoding/json" + "fmt" + "io" + "net/url" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/signal" +) + +// CmdAttach attaches to a running container. +// +// Usage: docker attach [OPTIONS] CONTAINER +func (cli *DockerCli) CmdAttach(args ...string) error { + cmd := Cli.Subcmd("attach", []string{"CONTAINER"}, Cli.DockerCommands["attach"].Description, true) + noStdin := cmd.Bool([]string{"#nostdin", "-no-stdin"}, false, "Do not attach STDIN") + proxy := cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxy all received signals to the process") + + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + serverResp, err := cli.call("GET", "/containers/"+cmd.Arg(0)+"/json", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + var c types.ContainerJSON + if err := json.NewDecoder(serverResp.body).Decode(&c); err != nil { + return err + } + + if !c.State.Running { + return fmt.Errorf("You cannot attach to a stopped container, start it first") + } + + if err := cli.CheckTtyInput(!*noStdin, c.Config.Tty); err != nil { + return err + } + + if c.Config.Tty && cli.isTerminalOut { + if err := cli.monitorTtySize(cmd.Arg(0), false); err != nil { + logrus.Debugf("Error monitoring TTY size: %s", err) + } + } + + var in io.ReadCloser + + v := url.Values{} + v.Set("stream", "1") + if !*noStdin && c.Config.OpenStdin { + v.Set("stdin", "1") + in = cli.in + } + + v.Set("stdout", "1") + v.Set("stderr", "1") + + if *proxy && !c.Config.Tty { + sigc := cli.forwardAllSignals(cmd.Arg(0)) + defer signal.StopCatch(sigc) + } + + if err := cli.hijack("POST", "/containers/"+cmd.Arg(0)+"/attach?"+v.Encode(), c.Config.Tty, in, cli.out, cli.err, nil, nil); err != nil { + return err + } + + _, status, err := getExitCode(cli, cmd.Arg(0)) + if err != nil { + return err + } + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + + return nil +} diff --git a/api/client/build.go b/api/client/build.go new file mode 100644 index 0000000000..2257868414 --- /dev/null +++ b/api/client/build.go @@ -0,0 +1,674 @@ +package client + +import ( + "archive/tar" + "bufio" + "encoding/base64" + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/url" + "os" + "os/exec" + "path/filepath" + "regexp" + "runtime" + "strconv" + "strings" + + "github.com/docker/docker/api" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/opts" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/jsonmessage" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/ulimit" + "github.com/docker/docker/pkg/units" + "github.com/docker/docker/pkg/urlutil" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" +) + +const ( + tarHeaderSize = 512 +) + +// CmdBuild builds a new image from the source code at a given path. +// +// If '-' is provided instead of a path or URL, Docker will build an image from either a Dockerfile or tar archive read from STDIN. +// +// Usage: docker build [OPTIONS] PATH | URL | - +func (cli *DockerCli) CmdBuild(args ...string) error { + cmd := Cli.Subcmd("build", []string{"PATH | URL | -"}, Cli.DockerCommands["build"].Description, true) + tag := cmd.String([]string{"t", "-tag"}, "", "Repository name (and optionally a tag) for the image") + suppressOutput := cmd.Bool([]string{"q", "-quiet"}, false, "Suppress the verbose output generated by the containers") + noCache := cmd.Bool([]string{"#no-cache", "-no-cache"}, false, "Do not use cache when building the image") + rm := cmd.Bool([]string{"#rm", "-rm"}, true, "Remove intermediate containers after a successful build") + forceRm := cmd.Bool([]string{"-force-rm"}, false, "Always remove intermediate containers") + pull := cmd.Bool([]string{"-pull"}, false, "Always attempt to pull a newer version of the image") + dockerfileName := cmd.String([]string{"f", "-file"}, "", "Name of the Dockerfile (Default is 'PATH/Dockerfile')") + flMemoryString := cmd.String([]string{"m", "-memory"}, "", "Memory limit") + flMemorySwap := cmd.String([]string{"-memory-swap"}, "", "Total memory (memory + swap), '-1' to disable swap") + flCPUShares := cmd.Int64([]string{"#c", "-cpu-shares"}, 0, "CPU shares (relative weight)") + flCPUPeriod := cmd.Int64([]string{"-cpu-period"}, 0, "Limit the CPU CFS (Completely Fair Scheduler) period") + flCPUQuota := cmd.Int64([]string{"-cpu-quota"}, 0, "Limit the CPU CFS (Completely Fair Scheduler) quota") + flCPUSetCpus := cmd.String([]string{"-cpuset-cpus"}, "", "CPUs in which to allow execution (0-3, 0,1)") + flCPUSetMems := cmd.String([]string{"-cpuset-mems"}, "", "MEMs in which to allow execution (0-3, 0,1)") + flCgroupParent := cmd.String([]string{"-cgroup-parent"}, "", "Optional parent cgroup for the container") + flBuildArg := opts.NewListOpts(opts.ValidateEnv) + cmd.Var(&flBuildArg, []string{"-build-arg"}, "Set build-time variables") + + ulimits := make(map[string]*ulimit.Ulimit) + flUlimits := opts.NewUlimitOpt(&ulimits) + cmd.Var(flUlimits, []string{"-ulimit"}, "Ulimit options") + + cmd.Require(flag.Exact, 1) + + // For trusted pull on "FROM " instruction. + addTrustedFlags(cmd, true) + + cmd.ParseFlags(args, true) + + var ( + context io.ReadCloser + isRemote bool + err error + ) + + _, err = exec.LookPath("git") + hasGit := err == nil + + specifiedContext := cmd.Arg(0) + + var ( + contextDir string + tempDir string + relDockerfile string + ) + + switch { + case specifiedContext == "-": + tempDir, relDockerfile, err = getContextFromReader(cli.in, *dockerfileName) + case urlutil.IsGitURL(specifiedContext) && hasGit: + tempDir, relDockerfile, err = getContextFromGitURL(specifiedContext, *dockerfileName) + case urlutil.IsURL(specifiedContext): + tempDir, relDockerfile, err = getContextFromURL(cli.out, specifiedContext, *dockerfileName) + default: + contextDir, relDockerfile, err = getContextFromLocalDir(specifiedContext, *dockerfileName) + } + + if err != nil { + return fmt.Errorf("unable to prepare context: %s", err) + } + + if tempDir != "" { + defer os.RemoveAll(tempDir) + contextDir = tempDir + } + + // Resolve the FROM lines in the Dockerfile to trusted digest references + // using Notary. On a successful build, we must tag the resolved digests + // to the original name specified in the Dockerfile. + newDockerfile, resolvedTags, err := rewriteDockerfileFrom(filepath.Join(contextDir, relDockerfile), cli.trustedReference) + if err != nil { + return fmt.Errorf("unable to process Dockerfile: %v", err) + } + defer newDockerfile.Close() + + // And canonicalize dockerfile name to a platform-independent one + relDockerfile, err = archive.CanonicalTarNameForPath(relDockerfile) + if err != nil { + return fmt.Errorf("cannot canonicalize dockerfile path %s: %v", relDockerfile, err) + } + + f, err := os.Open(filepath.Join(contextDir, ".dockerignore")) + if err != nil && !os.IsNotExist(err) { + return err + } + + var excludes []string + if err == nil { + excludes, err = utils.ReadDockerIgnore(f) + if err != nil { + return err + } + } + + if err := utils.ValidateContextDirectory(contextDir, excludes); err != nil { + return fmt.Errorf("Error checking context: '%s'.", err) + } + + // If .dockerignore mentions .dockerignore or the Dockerfile + // then make sure we send both files over to the daemon + // because Dockerfile is, obviously, needed no matter what, and + // .dockerignore is needed to know if either one needs to be + // removed. The deamon will remove them for us, if needed, after it + // parses the Dockerfile. Ignore errors here, as they will have been + // caught by ValidateContextDirectory above. + var includes = []string{"."} + keepThem1, _ := fileutils.Matches(".dockerignore", excludes) + keepThem2, _ := fileutils.Matches(relDockerfile, excludes) + if keepThem1 || keepThem2 { + includes = append(includes, ".dockerignore", relDockerfile) + } + + context, err = archive.TarWithOptions(contextDir, &archive.TarOptions{ + Compression: archive.Uncompressed, + ExcludePatterns: excludes, + IncludeFiles: includes, + }) + if err != nil { + return err + } + + // Wrap the tar archive to replace the Dockerfile entry with the rewritten + // Dockerfile which uses trusted pulls. + context = replaceDockerfileTarWrapper(context, newDockerfile, relDockerfile) + + // Setup an upload progress bar + // FIXME: ProgressReader shouldn't be this annoying to use + sf := streamformatter.NewStreamFormatter() + var body io.Reader = progressreader.New(progressreader.Config{ + In: context, + Out: cli.out, + Formatter: sf, + NewLines: true, + ID: "", + Action: "Sending build context to Docker daemon", + }) + + var memory int64 + if *flMemoryString != "" { + parsedMemory, err := units.RAMInBytes(*flMemoryString) + if err != nil { + return err + } + memory = parsedMemory + } + + var memorySwap int64 + if *flMemorySwap != "" { + if *flMemorySwap == "-1" { + memorySwap = -1 + } else { + parsedMemorySwap, err := units.RAMInBytes(*flMemorySwap) + if err != nil { + return err + } + memorySwap = parsedMemorySwap + } + } + // Send the build context + v := &url.Values{} + + //Check if the given image name can be resolved + if *tag != "" { + repository, tag := parsers.ParseRepositoryTag(*tag) + if err := registry.ValidateRepositoryName(repository); err != nil { + return err + } + if len(tag) > 0 { + if err := tags.ValidateTagName(tag); err != nil { + return err + } + } + } + + v.Set("t", *tag) + + if *suppressOutput { + v.Set("q", "1") + } + if isRemote { + v.Set("remote", cmd.Arg(0)) + } + if *noCache { + v.Set("nocache", "1") + } + if *rm { + v.Set("rm", "1") + } else { + v.Set("rm", "0") + } + + if *forceRm { + v.Set("forcerm", "1") + } + + if *pull { + v.Set("pull", "1") + } + + v.Set("cpusetcpus", *flCPUSetCpus) + v.Set("cpusetmems", *flCPUSetMems) + v.Set("cpushares", strconv.FormatInt(*flCPUShares, 10)) + v.Set("cpuquota", strconv.FormatInt(*flCPUQuota, 10)) + v.Set("cpuperiod", strconv.FormatInt(*flCPUPeriod, 10)) + v.Set("memory", strconv.FormatInt(memory, 10)) + v.Set("memswap", strconv.FormatInt(memorySwap, 10)) + v.Set("cgroupparent", *flCgroupParent) + + v.Set("dockerfile", relDockerfile) + + ulimitsVar := flUlimits.GetList() + ulimitsJSON, err := json.Marshal(ulimitsVar) + if err != nil { + return err + } + v.Set("ulimits", string(ulimitsJSON)) + + // collect all the build-time environment variables for the container + buildArgs := runconfig.ConvertKVStringsToMap(flBuildArg.GetAll()) + buildArgsJSON, err := json.Marshal(buildArgs) + if err != nil { + return err + } + v.Set("buildargs", string(buildArgsJSON)) + + headers := http.Header(make(map[string][]string)) + buf, err := json.Marshal(cli.configFile.AuthConfigs) + if err != nil { + return err + } + headers.Add("X-Registry-Config", base64.URLEncoding.EncodeToString(buf)) + headers.Set("Content-Type", "application/tar") + + sopts := &streamOpts{ + rawTerminal: true, + in: body, + out: cli.out, + headers: headers, + } + + serverResp, err := cli.stream("POST", fmt.Sprintf("/build?%s", v.Encode()), sopts) + + // Windows: show error message about modified file permissions. + if runtime.GOOS == "windows" { + h, err := httputils.ParseServerHeader(serverResp.header.Get("Server")) + if err == nil { + if h.OS != "windows" { + fmt.Fprintln(cli.err, `SECURITY WARNING: You are building a Docker image from Windows against a non-Windows Docker host. All files and directories added to build context will have '-rwxr-xr-x' permissions. It is recommended to double check and reset permissions for sensitive files and directories.`) + } + } + } + + if jerr, ok := err.(*jsonmessage.JSONError); ok { + // If no error code is set, default to 1 + if jerr.Code == 0 { + jerr.Code = 1 + } + return Cli.StatusError{Status: jerr.Message, StatusCode: jerr.Code} + } + + if err != nil { + return err + } + + // Since the build was successful, now we must tag any of the resolved + // images from the above Dockerfile rewrite. + for _, resolved := range resolvedTags { + if err := cli.tagTrusted(resolved.repoInfo, resolved.digestRef, resolved.tagRef); err != nil { + return err + } + } + + return nil +} + +// isUNC returns true if the path is UNC (one starting \\). It always returns +// false on Linux. +func isUNC(path string) bool { + return runtime.GOOS == "windows" && strings.HasPrefix(path, `\\`) +} + +// getDockerfileRelPath uses the given context directory for a `docker build` +// and returns the absolute path to the context directory, the relative path of +// the dockerfile in that context directory, and a non-nil error on success. +func getDockerfileRelPath(givenContextDir, givenDockerfile string) (absContextDir, relDockerfile string, err error) { + if absContextDir, err = filepath.Abs(givenContextDir); err != nil { + return "", "", fmt.Errorf("unable to get absolute context directory: %v", err) + } + + // The context dir might be a symbolic link, so follow it to the actual + // target directory. + // + // FIXME. We use isUNC (always false on non-Windows platforms) to workaround + // an issue in golang. On Windows, EvalSymLinks does not work on UNC file + // paths (those starting with \\). This hack means that when using links + // on UNC paths, they will not be followed. + if !isUNC(absContextDir) { + absContextDir, err = filepath.EvalSymlinks(absContextDir) + if err != nil { + return "", "", fmt.Errorf("unable to evaluate symlinks in context path: %v", err) + } + } + + stat, err := os.Lstat(absContextDir) + if err != nil { + return "", "", fmt.Errorf("unable to stat context directory %q: %v", absContextDir, err) + } + + if !stat.IsDir() { + return "", "", fmt.Errorf("context must be a directory: %s", absContextDir) + } + + absDockerfile := givenDockerfile + if absDockerfile == "" { + // No -f/--file was specified so use the default relative to the + // context directory. + absDockerfile = filepath.Join(absContextDir, api.DefaultDockerfileName) + + // Just to be nice ;-) look for 'dockerfile' too but only + // use it if we found it, otherwise ignore this check + if _, err = os.Lstat(absDockerfile); os.IsNotExist(err) { + altPath := filepath.Join(absContextDir, strings.ToLower(api.DefaultDockerfileName)) + if _, err = os.Lstat(altPath); err == nil { + absDockerfile = altPath + } + } + } + + // If not already an absolute path, the Dockerfile path should be joined to + // the base directory. + if !filepath.IsAbs(absDockerfile) { + absDockerfile = filepath.Join(absContextDir, absDockerfile) + } + + // Evaluate symlinks in the path to the Dockerfile too. + // + // FIXME. We use isUNC (always false on non-Windows platforms) to workaround + // an issue in golang. On Windows, EvalSymLinks does not work on UNC file + // paths (those starting with \\). This hack means that when using links + // on UNC paths, they will not be followed. + if !isUNC(absDockerfile) { + absDockerfile, err = filepath.EvalSymlinks(absDockerfile) + if err != nil { + return "", "", fmt.Errorf("unable to evaluate symlinks in Dockerfile path: %v", err) + } + } + + if _, err := os.Lstat(absDockerfile); err != nil { + if os.IsNotExist(err) { + return "", "", fmt.Errorf("Cannot locate Dockerfile: %q", absDockerfile) + } + return "", "", fmt.Errorf("unable to stat Dockerfile: %v", err) + } + + if relDockerfile, err = filepath.Rel(absContextDir, absDockerfile); err != nil { + return "", "", fmt.Errorf("unable to get relative Dockerfile path: %v", err) + } + + if strings.HasPrefix(relDockerfile, ".."+string(filepath.Separator)) { + return "", "", fmt.Errorf("The Dockerfile (%s) must be within the build context (%s)", givenDockerfile, givenContextDir) + } + + return absContextDir, relDockerfile, nil +} + +// writeToFile copies from the given reader and writes it to a file with the +// given filename. +func writeToFile(r io.Reader, filename string) error { + file, err := os.OpenFile(filename, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, os.FileMode(0600)) + if err != nil { + return fmt.Errorf("unable to create file: %v", err) + } + defer file.Close() + + if _, err := io.Copy(file, r); err != nil { + return fmt.Errorf("unable to write file: %v", err) + } + + return nil +} + +// getContextFromReader will read the contents of the given reader as either a +// Dockerfile or tar archive to be extracted to a temporary directory used as +// the context directory. Returns the absolute path to the temporary context +// directory, the relative path of the dockerfile in that context directory, +// and a non-nil error on success. +func getContextFromReader(r io.Reader, dockerfileName string) (absContextDir, relDockerfile string, err error) { + buf := bufio.NewReader(r) + + magic, err := buf.Peek(tarHeaderSize) + if err != nil && err != io.EOF { + return "", "", fmt.Errorf("failed to peek context header from STDIN: %v", err) + } + + if absContextDir, err = ioutil.TempDir("", "docker-build-context-"); err != nil { + return "", "", fmt.Errorf("unbale to create temporary context directory: %v", err) + } + + defer func(d string) { + if err != nil { + os.RemoveAll(d) + } + }(absContextDir) + + if !archive.IsArchive(magic) { // Input should be read as a Dockerfile. + // -f option has no meaning when we're reading it from stdin, + // so just use our default Dockerfile name + relDockerfile = api.DefaultDockerfileName + + return absContextDir, relDockerfile, writeToFile(buf, filepath.Join(absContextDir, relDockerfile)) + } + + if err := archive.Untar(buf, absContextDir, nil); err != nil { + return "", "", fmt.Errorf("unable to extract stdin to temporary context directory: %v", err) + } + + return getDockerfileRelPath(absContextDir, dockerfileName) +} + +// getContextFromGitURL uses a Git URL as context for a `docker build`. The +// git repo is cloned into a temporary directory used as the context directory. +// Returns the absolute path to the temporary context directory, the relative +// path of the dockerfile in that context directory, and a non-nil error on +// success. +func getContextFromGitURL(gitURL, dockerfileName string) (absContextDir, relDockerfile string, err error) { + if absContextDir, err = utils.GitClone(gitURL); err != nil { + return "", "", fmt.Errorf("unable to 'git clone' to temporary context directory: %v", err) + } + + return getDockerfileRelPath(absContextDir, dockerfileName) +} + +// getContextFromURL uses a remote URL as context for a `docker build`. The +// remote resource is downloaded as either a Dockerfile or a context tar +// archive and stored in a temporary directory used as the context directory. +// Returns the absolute path to the temporary context directory, the relative +// path of the dockerfile in that context directory, and a non-nil error on +// success. +func getContextFromURL(out io.Writer, remoteURL, dockerfileName string) (absContextDir, relDockerfile string, err error) { + response, err := httputils.Download(remoteURL) + if err != nil { + return "", "", fmt.Errorf("unable to download remote context %s: %v", remoteURL, err) + } + defer response.Body.Close() + + // Pass the response body through a progress reader. + progReader := &progressreader.Config{ + In: response.Body, + Out: out, + Formatter: streamformatter.NewStreamFormatter(), + Size: response.ContentLength, + NewLines: true, + ID: "", + Action: fmt.Sprintf("Downloading build context from remote url: %s", remoteURL), + } + + return getContextFromReader(progReader, dockerfileName) +} + +// getContextFromLocalDir uses the given local directory as context for a +// `docker build`. Returns the absolute path to the local context directory, +// the relative path of the dockerfile in that context directory, and a non-nil +// error on success. +func getContextFromLocalDir(localDir, dockerfileName string) (absContextDir, relDockerfile string, err error) { + // When using a local context directory, when the Dockerfile is specified + // with the `-f/--file` option then it is considered relative to the + // current directory and not the context directory. + if dockerfileName != "" { + if dockerfileName, err = filepath.Abs(dockerfileName); err != nil { + return "", "", fmt.Errorf("unable to get absolute path to Dockerfile: %v", err) + } + } + + return getDockerfileRelPath(localDir, dockerfileName) +} + +var dockerfileFromLinePattern = regexp.MustCompile(`(?i)^[\s]*FROM[ \f\r\t\v]+(?P[^ \f\r\t\v\n#]+)`) + +type trustedDockerfile struct { + *os.File + size int64 +} + +func (td *trustedDockerfile) Close() error { + td.File.Close() + return os.Remove(td.File.Name()) +} + +// resolvedTag records the repository, tag, and resolved digest reference +// from a Dockerfile rewrite. +type resolvedTag struct { + repoInfo *registry.RepositoryInfo + digestRef, tagRef registry.Reference +} + +// rewriteDockerfileFrom rewrites the given Dockerfile by resolving images in +// "FROM " instructions to a digest reference. `translator` is a +// function that takes a repository name and tag reference and returns a +// trusted digest reference. +func rewriteDockerfileFrom(dockerfileName string, translator func(string, registry.Reference) (registry.Reference, error)) (newDockerfile *trustedDockerfile, resolvedTags []*resolvedTag, err error) { + dockerfile, err := os.Open(dockerfileName) + if err != nil { + return nil, nil, fmt.Errorf("unable to open Dockerfile: %v", err) + } + defer dockerfile.Close() + + scanner := bufio.NewScanner(dockerfile) + + // Make a tempfile to store the rewritten Dockerfile. + tempFile, err := ioutil.TempFile("", "trusted-dockerfile-") + if err != nil { + return nil, nil, fmt.Errorf("unable to make temporary trusted Dockerfile: %v", err) + } + + trustedFile := &trustedDockerfile{ + File: tempFile, + } + + defer func() { + if err != nil { + // Close the tempfile if there was an error during Notary lookups. + // Otherwise the caller should close it. + trustedFile.Close() + } + }() + + // Scan the lines of the Dockerfile, looking for a "FROM" line. + for scanner.Scan() { + line := scanner.Text() + + matches := dockerfileFromLinePattern.FindStringSubmatch(line) + if matches != nil && matches[1] != "scratch" { + // Replace the line with a resolved "FROM repo@digest" + repo, tag := parsers.ParseRepositoryTag(matches[1]) + if tag == "" { + tag = tags.DefaultTag + } + + repoInfo, err := registry.ParseRepositoryInfo(repo) + if err != nil { + return nil, nil, fmt.Errorf("unable to parse repository info: %v", err) + } + + ref := registry.ParseReference(tag) + + if !ref.HasDigest() && isTrusted() { + trustedRef, err := translator(repo, ref) + if err != nil { + return nil, nil, err + } + + line = dockerfileFromLinePattern.ReplaceAllLiteralString(line, fmt.Sprintf("FROM %s", trustedRef.ImageName(repo))) + resolvedTags = append(resolvedTags, &resolvedTag{ + repoInfo: repoInfo, + digestRef: trustedRef, + tagRef: ref, + }) + } + } + + n, err := fmt.Fprintln(tempFile, line) + if err != nil { + return nil, nil, err + } + + trustedFile.size += int64(n) + } + + tempFile.Seek(0, os.SEEK_SET) + + return trustedFile, resolvedTags, scanner.Err() +} + +// replaceDockerfileTarWrapper wraps the given input tar archive stream and +// replaces the entry with the given Dockerfile name with the contents of the +// new Dockerfile. Returns a new tar archive stream with the replaced +// Dockerfile. +func replaceDockerfileTarWrapper(inputTarStream io.ReadCloser, newDockerfile *trustedDockerfile, dockerfileName string) io.ReadCloser { + pipeReader, pipeWriter := io.Pipe() + + go func() { + tarReader := tar.NewReader(inputTarStream) + tarWriter := tar.NewWriter(pipeWriter) + + defer inputTarStream.Close() + + for { + hdr, err := tarReader.Next() + if err == io.EOF { + // Signals end of archive. + tarWriter.Close() + pipeWriter.Close() + return + } + if err != nil { + pipeWriter.CloseWithError(err) + return + } + + var content io.Reader = tarReader + + if hdr.Name == dockerfileName { + // This entry is the Dockerfile. Since the tar archive was + // generated from a directory on the local filesystem, the + // Dockerfile will only appear once in the archive. + hdr.Size = newDockerfile.size + content = newDockerfile + } + + if err := tarWriter.WriteHeader(hdr); err != nil { + pipeWriter.CloseWithError(err) + return + } + + if _, err := io.Copy(tarWriter, content); err != nil { + pipeWriter.CloseWithError(err) + return + } + } + }() + + return pipeReader +} diff --git a/api/client/cli.go b/api/client/cli.go new file mode 100644 index 0000000000..834c47a4d3 --- /dev/null +++ b/api/client/cli.go @@ -0,0 +1,169 @@ +package client + +import ( + "crypto/tls" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "os" + "strings" + + "github.com/docker/docker/cli" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/opts" + "github.com/docker/docker/pkg/sockets" + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/pkg/tlsconfig" +) + +// DockerCli represents the docker command line client. +// Instances of the client can be returned from NewDockerCli. +type DockerCli struct { + // initializing closure + init func() error + + // proto holds the client protocol i.e. unix. + proto string + // addr holds the client address. + addr string + // basePath holds the path to prepend to the requests + basePath string + + // configFile has the client configuration file + configFile *cliconfig.ConfigFile + // in holds the input stream and closer (io.ReadCloser) for the client. + in io.ReadCloser + // out holds the output stream (io.Writer) for the client. + out io.Writer + // err holds the error stream (io.Writer) for the client. + err io.Writer + // keyFile holds the key file as a string. + keyFile string + // tlsConfig holds the TLS configuration for the client, and will + // set the scheme to https in NewDockerCli if present. + tlsConfig *tls.Config + // scheme holds the scheme of the client i.e. https. + scheme string + // inFd holds the file descriptor of the client's STDIN (if valid). + inFd uintptr + // outFd holds file descriptor of the client's STDOUT (if valid). + outFd uintptr + // isTerminalIn indicates whether the client's STDIN is a TTY + isTerminalIn bool + // isTerminalOut indicates whether the client's STDOUT is a TTY + isTerminalOut bool + // transport holds the client transport instance. + transport *http.Transport +} + +// Initialize calls the init function that will setup the configuration for the client +// such as the TLS, tcp and other parameters used to run the client. +func (cli *DockerCli) Initialize() error { + if cli.init == nil { + return nil + } + return cli.init() +} + +// CheckTtyInput checks if we are trying to attach to a container tty +// from a non-tty client input stream, and if so, returns an error. +func (cli *DockerCli) CheckTtyInput(attachStdin, ttyMode bool) error { + // In order to attach to a container tty, input stream for the client must + // be a tty itself: redirecting or piping the client standard input is + // incompatible with `docker run -t`, `docker exec -t` or `docker attach`. + if ttyMode && attachStdin && !cli.isTerminalIn { + return errors.New("cannot enable tty mode on non tty input") + } + return nil +} + +// PsFormat returns the format string specified in the configuration. +// String contains columns and format specification, for example {{ID}\t{{Name}}. +func (cli *DockerCli) PsFormat() string { + return cli.configFile.PsFormat +} + +// NewDockerCli returns a DockerCli instance with IO output and error streams set by in, out and err. +// The key file, protocol (i.e. unix) and address are passed in as strings, along with the tls.Config. If the tls.Config +// is set the client scheme will be set to https. +// The client will be given a 32-second timeout (see https://github.com/docker/docker/pull/8035). +func NewDockerCli(in io.ReadCloser, out, err io.Writer, clientFlags *cli.ClientFlags) *DockerCli { + cli := &DockerCli{ + in: in, + out: out, + err: err, + keyFile: clientFlags.Common.TrustKey, + } + + cli.init = func() error { + + clientFlags.PostParse() + + hosts := clientFlags.Common.Hosts + + switch len(hosts) { + case 0: + hosts = []string{os.Getenv("DOCKER_HOST")} + case 1: + // only accept one host to talk to + default: + return errors.New("Please specify only one -H") + } + + defaultHost := opts.DefaultTCPHost + if clientFlags.Common.TLSOptions != nil { + defaultHost = opts.DefaultTLSHost + } + + var e error + if hosts[0], e = opts.ParseHost(defaultHost, hosts[0]); e != nil { + return e + } + + protoAddrParts := strings.SplitN(hosts[0], "://", 2) + cli.proto, cli.addr = protoAddrParts[0], protoAddrParts[1] + + if cli.proto == "tcp" { + // error is checked in pkg/parsers already + parsed, _ := url.Parse("tcp://" + cli.addr) + cli.addr = parsed.Host + cli.basePath = parsed.Path + } + + if clientFlags.Common.TLSOptions != nil { + cli.scheme = "https" + var e error + cli.tlsConfig, e = tlsconfig.Client(*clientFlags.Common.TLSOptions) + if e != nil { + return e + } + } else { + cli.scheme = "http" + } + + if cli.in != nil { + cli.inFd, cli.isTerminalIn = term.GetFdInfo(cli.in) + } + if cli.out != nil { + cli.outFd, cli.isTerminalOut = term.GetFdInfo(cli.out) + } + + // The transport is created here for reuse during the client session. + cli.transport = &http.Transport{ + TLSClientConfig: cli.tlsConfig, + } + sockets.ConfigureTCPTransport(cli.transport, cli.proto, cli.addr) + + configFile, e := cliconfig.Load(cliconfig.ConfigDir()) + if e != nil { + fmt.Fprintf(cli.err, "WARNING: Error loading config file:%v\n", e) + } + cli.configFile = configFile + + return nil + } + + return cli +} diff --git a/api/client/client.go b/api/client/client.go new file mode 100644 index 0000000000..4cfce5f684 --- /dev/null +++ b/api/client/client.go @@ -0,0 +1,5 @@ +// Package client provides a command-line interface for Docker. +// +// Run "docker help SUBCOMMAND" or "docker SUBCOMMAND --help" to see more information on any Docker subcommand, including the full list of options supported for the subcommand. +// See https://docs.docker.com/installation/ for instructions on installing Docker. +package client diff --git a/api/client/commit.go b/api/client/commit.go new file mode 100644 index 0000000000..6a837881e8 --- /dev/null +++ b/api/client/commit.go @@ -0,0 +1,84 @@ +package client + +import ( + "encoding/json" + "fmt" + "net/url" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" +) + +// CmdCommit creates a new image from a container's changes. +// +// Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] +func (cli *DockerCli) CmdCommit(args ...string) error { + cmd := Cli.Subcmd("commit", []string{"CONTAINER [REPOSITORY[:TAG]]"}, Cli.DockerCommands["commit"].Description, true) + flPause := cmd.Bool([]string{"p", "-pause"}, true, "Pause container during commit") + flComment := cmd.String([]string{"m", "-message"}, "", "Commit message") + flAuthor := cmd.String([]string{"a", "#author", "-author"}, "", "Author (e.g., \"John Hannibal Smith \")") + flChanges := opts.NewListOpts(nil) + cmd.Var(&flChanges, []string{"c", "-change"}, "Apply Dockerfile instruction to the created image") + // FIXME: --run is deprecated, it will be replaced with inline Dockerfile commands. + flConfig := cmd.String([]string{"#run", "#-run"}, "", "This option is deprecated and will be removed in a future version in favor of inline Dockerfile-compatible commands") + cmd.Require(flag.Max, 2) + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var ( + name = cmd.Arg(0) + repository, tag = parsers.ParseRepositoryTag(cmd.Arg(1)) + ) + + //Check if the given image name can be resolved + if repository != "" { + if err := registry.ValidateRepositoryName(repository); err != nil { + return err + } + } + + v := url.Values{} + v.Set("container", name) + v.Set("repo", repository) + v.Set("tag", tag) + v.Set("comment", *flComment) + v.Set("author", *flAuthor) + for _, change := range flChanges.GetAll() { + v.Add("changes", change) + } + + if *flPause != true { + v.Set("pause", "0") + } + + var ( + config *runconfig.Config + response types.ContainerCommitResponse + ) + + if *flConfig != "" { + config = &runconfig.Config{} + if err := json.Unmarshal([]byte(*flConfig), config); err != nil { + return err + } + } + serverResp, err := cli.call("POST", "/commit?"+v.Encode(), config, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + if err := json.NewDecoder(serverResp.body).Decode(&response); err != nil { + return err + } + + fmt.Fprintln(cli.out, response.ID) + return nil +} diff --git a/api/client/cp.go b/api/client/cp.go new file mode 100644 index 0000000000..c055fced51 --- /dev/null +++ b/api/client/cp.go @@ -0,0 +1,325 @@ +package client + +import ( + "encoding/base64" + "encoding/json" + "fmt" + "io" + "net/http" + "net/url" + "os" + "path/filepath" + "strings" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/pkg/archive" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/system" +) + +type copyDirection int + +const ( + fromContainer copyDirection = (1 << iota) + toContainer + acrossContainers = fromContainer | toContainer +) + +// CmdCp copies files/folders to or from a path in a container. +// +// When copying from a container, if LOCALPATH is '-' the data is written as a +// tar archive file to STDOUT. +// +// When copying to a container, if LOCALPATH is '-' the data is read as a tar +// archive file from STDIN, and the destination CONTAINER:PATH, must specify +// a directory. +// +// Usage: +// docker cp CONTAINER:PATH LOCALPATH|- +// docker cp LOCALPATH|- CONTAINER:PATH +func (cli *DockerCli) CmdCp(args ...string) error { + cmd := Cli.Subcmd( + "cp", + []string{"CONTAINER:PATH LOCALPATH|-", "LOCALPATH|- CONTAINER:PATH"}, + strings.Join([]string{ + Cli.DockerCommands["cp"].Description, + "\nUse '-' as the source to read a tar archive from stdin\n", + "and extract it to a directory destination in a container.\n", + "Use '-' as the destination to stream a tar archive of a\n", + "container source to stdout.", + }, ""), + true, + ) + + cmd.Require(flag.Exact, 2) + cmd.ParseFlags(args, true) + + if cmd.Arg(0) == "" { + return fmt.Errorf("source can not be empty") + } + if cmd.Arg(1) == "" { + return fmt.Errorf("destination can not be empty") + } + + srcContainer, srcPath := splitCpArg(cmd.Arg(0)) + dstContainer, dstPath := splitCpArg(cmd.Arg(1)) + + var direction copyDirection + if srcContainer != "" { + direction |= fromContainer + } + if dstContainer != "" { + direction |= toContainer + } + + switch direction { + case fromContainer: + return cli.copyFromContainer(srcContainer, srcPath, dstPath) + case toContainer: + return cli.copyToContainer(srcPath, dstContainer, dstPath) + case acrossContainers: + // Copying between containers isn't supported. + return fmt.Errorf("copying between containers is not supported") + default: + // User didn't specify any container. + return fmt.Errorf("must specify at least one container source") + } +} + +// We use `:` as a delimiter between CONTAINER and PATH, but `:` could also be +// in a valid LOCALPATH, like `file:name.txt`. We can resolve this ambiguity by +// requiring a LOCALPATH with a `:` to be made explicit with a relative or +// absolute path: +// `/path/to/file:name.txt` or `./file:name.txt` +// +// This is apparently how `scp` handles this as well: +// http://www.cyberciti.biz/faq/rsync-scp-file-name-with-colon-punctuation-in-it/ +// +// We can't simply check for a filepath separator because container names may +// have a separator, e.g., "host0/cname1" if container is in a Docker cluster, +// so we have to check for a `/` or `.` prefix. Also, in the case of a Windows +// client, a `:` could be part of an absolute Windows path, in which case it +// is immediately proceeded by a backslash. +func splitCpArg(arg string) (container, path string) { + if system.IsAbs(arg) { + // Explicit local absolute path, e.g., `C:\foo` or `/foo`. + return "", arg + } + + parts := strings.SplitN(arg, ":", 2) + + if len(parts) == 1 || strings.HasPrefix(parts[0], ".") { + // Either there's no `:` in the arg + // OR it's an explicit local relative path like `./file:name.txt`. + return "", arg + } + + return parts[0], parts[1] +} + +func (cli *DockerCli) statContainerPath(containerName, path string) (types.ContainerPathStat, error) { + var stat types.ContainerPathStat + + query := make(url.Values, 1) + query.Set("path", filepath.ToSlash(path)) // Normalize the paths used in the API. + + urlStr := fmt.Sprintf("/containers/%s/archive?%s", containerName, query.Encode()) + + response, err := cli.call("HEAD", urlStr, nil, nil) + if err != nil { + return stat, err + } + defer response.body.Close() + + if response.statusCode != http.StatusOK { + return stat, fmt.Errorf("unexpected status code from daemon: %d", response.statusCode) + } + + return getContainerPathStatFromHeader(response.header) +} + +func getContainerPathStatFromHeader(header http.Header) (types.ContainerPathStat, error) { + var stat types.ContainerPathStat + + encodedStat := header.Get("X-Docker-Container-Path-Stat") + statDecoder := base64.NewDecoder(base64.StdEncoding, strings.NewReader(encodedStat)) + + err := json.NewDecoder(statDecoder).Decode(&stat) + if err != nil { + err = fmt.Errorf("unable to decode container path stat header: %s", err) + } + + return stat, err +} + +func resolveLocalPath(localPath string) (absPath string, err error) { + if absPath, err = filepath.Abs(localPath); err != nil { + return + } + + return archive.PreserveTrailingDotOrSeparator(absPath, localPath), nil +} + +func (cli *DockerCli) copyFromContainer(srcContainer, srcPath, dstPath string) (err error) { + if dstPath != "-" { + // Get an absolute destination path. + dstPath, err = resolveLocalPath(dstPath) + if err != nil { + return err + } + } + + query := make(url.Values, 1) + query.Set("path", filepath.ToSlash(srcPath)) // Normalize the paths used in the API. + + urlStr := fmt.Sprintf("/containers/%s/archive?%s", srcContainer, query.Encode()) + + response, err := cli.call("GET", urlStr, nil, nil) + if err != nil { + return err + } + defer response.body.Close() + + if response.statusCode != http.StatusOK { + return fmt.Errorf("unexpected status code from daemon: %d", response.statusCode) + } + + if dstPath == "-" { + // Send the response to STDOUT. + _, err = io.Copy(os.Stdout, response.body) + + return err + } + + // In order to get the copy behavior right, we need to know information + // about both the source and the destination. The response headers include + // stat info about the source that we can use in deciding exactly how to + // copy it locally. Along with the stat info about the local destination, + // we have everything we need to handle the multiple possibilities there + // can be when copying a file/dir from one location to another file/dir. + stat, err := getContainerPathStatFromHeader(response.header) + if err != nil { + return fmt.Errorf("unable to get resource stat from response: %s", err) + } + + // Prepare source copy info. + srcInfo := archive.CopyInfo{ + Path: srcPath, + Exists: true, + IsDir: stat.Mode.IsDir(), + } + + // See comments in the implementation of `archive.CopyTo` for exactly what + // goes into deciding how and whether the source archive needs to be + // altered for the correct copy behavior. + return archive.CopyTo(response.body, srcInfo, dstPath) +} + +func (cli *DockerCli) copyToContainer(srcPath, dstContainer, dstPath string) (err error) { + if srcPath != "-" { + // Get an absolute source path. + srcPath, err = resolveLocalPath(srcPath) + if err != nil { + return err + } + } + + // In order to get the copy behavior right, we need to know information + // about both the source and destination. The API is a simple tar + // archive/extract API but we can use the stat info header about the + // destination to be more informed about exactly what the destination is. + + // Prepare destination copy info by stat-ing the container path. + dstInfo := archive.CopyInfo{Path: dstPath} + dstStat, err := cli.statContainerPath(dstContainer, dstPath) + + // If the destination is a symbolic link, we should evaluate it. + if err == nil && dstStat.Mode&os.ModeSymlink != 0 { + linkTarget := dstStat.LinkTarget + if !system.IsAbs(linkTarget) { + // Join with the parent directory. + dstParent, _ := archive.SplitPathDirEntry(dstPath) + linkTarget = filepath.Join(dstParent, linkTarget) + } + + dstInfo.Path = linkTarget + dstStat, err = cli.statContainerPath(dstContainer, linkTarget) + } + + // Ignore any error and assume that the parent directory of the destination + // path exists, in which case the copy may still succeed. If there is any + // type of conflict (e.g., non-directory overwriting an existing directory + // or vice versia) the extraction will fail. If the destination simply did + // not exist, but the parent directory does, the extraction will still + // succeed. + if err == nil { + dstInfo.Exists, dstInfo.IsDir = true, dstStat.Mode.IsDir() + } + + var ( + content io.Reader + resolvedDstPath string + ) + + if srcPath == "-" { + // Use STDIN. + content = os.Stdin + resolvedDstPath = dstInfo.Path + if !dstInfo.IsDir { + return fmt.Errorf("destination %q must be a directory", fmt.Sprintf("%s:%s", dstContainer, dstPath)) + } + } else { + // Prepare source copy info. + srcInfo, err := archive.CopyInfoSourcePath(srcPath) + if err != nil { + return err + } + + srcArchive, err := archive.TarResource(srcInfo) + if err != nil { + return err + } + defer srcArchive.Close() + + // With the stat info about the local source as well as the + // destination, we have enough information to know whether we need to + // alter the archive that we upload so that when the server extracts + // it to the specified directory in the container we get the disired + // copy behavior. + + // See comments in the implementation of `archive.PrepareArchiveCopy` + // for exactly what goes into deciding how and whether the source + // archive needs to be altered for the correct copy behavior when it is + // extracted. This function also infers from the source and destination + // info which directory to extract to, which may be the parent of the + // destination that the user specified. + dstDir, preparedArchive, err := archive.PrepareArchiveCopy(srcArchive, srcInfo, dstInfo) + if err != nil { + return err + } + defer preparedArchive.Close() + + resolvedDstPath = dstDir + content = preparedArchive + } + + query := make(url.Values, 2) + query.Set("path", filepath.ToSlash(resolvedDstPath)) // Normalize the paths used in the API. + // Do not allow for an existing directory to be overwritten by a non-directory and vice versa. + query.Set("noOverwriteDirNonDir", "true") + + urlStr := fmt.Sprintf("/containers/%s/archive?%s", dstContainer, query.Encode()) + + response, err := cli.stream("PUT", urlStr, &streamOpts{in: content}) + if err != nil { + return err + } + defer response.body.Close() + + if response.statusCode != http.StatusOK { + return fmt.Errorf("unexpected status code from daemon: %d", response.statusCode) + } + + return nil +} diff --git a/api/client/create.go b/api/client/create.go new file mode 100644 index 0000000000..9ef0edab6c --- /dev/null +++ b/api/client/create.go @@ -0,0 +1,185 @@ +package client + +import ( + "encoding/base64" + "encoding/json" + "fmt" + "io" + "net/url" + "os" + "strings" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" +) + +func (cli *DockerCli) pullImage(image string) error { + return cli.pullImageCustomOut(image, cli.out) +} + +func (cli *DockerCli) pullImageCustomOut(image string, out io.Writer) error { + v := url.Values{} + repos, tag := parsers.ParseRepositoryTag(image) + // pull only the image tagged 'latest' if no tag was specified + if tag == "" { + tag = tags.DefaultTag + } + v.Set("fromImage", repos) + v.Set("tag", tag) + + // Resolve the Repository name from fqn to RepositoryInfo + repoInfo, err := registry.ParseRepositoryInfo(repos) + if err != nil { + return err + } + + // Resolve the Auth config relevant for this server + authConfig := registry.ResolveAuthConfig(cli.configFile, repoInfo.Index) + buf, err := json.Marshal(authConfig) + if err != nil { + return err + } + + registryAuthHeader := []string{ + base64.URLEncoding.EncodeToString(buf), + } + sopts := &streamOpts{ + rawTerminal: true, + out: out, + headers: map[string][]string{"X-Registry-Auth": registryAuthHeader}, + } + if _, err := cli.stream("POST", "/images/create?"+v.Encode(), sopts); err != nil { + return err + } + return nil +} + +type cidFile struct { + path string + file *os.File + written bool +} + +func newCIDFile(path string) (*cidFile, error) { + if _, err := os.Stat(path); err == nil { + return nil, fmt.Errorf("Container ID file found, make sure the other container isn't running or delete %s", path) + } + + f, err := os.Create(path) + if err != nil { + return nil, fmt.Errorf("Failed to create the container ID file: %s", err) + } + + return &cidFile{path: path, file: f}, nil +} + +func (cli *DockerCli) createContainer(config *runconfig.Config, hostConfig *runconfig.HostConfig, cidfile, name string) (*types.ContainerCreateResponse, error) { + containerValues := url.Values{} + if name != "" { + containerValues.Set("name", name) + } + + mergedConfig := runconfig.MergeConfigs(config, hostConfig) + + var containerIDFile *cidFile + if cidfile != "" { + var err error + if containerIDFile, err = newCIDFile(cidfile); err != nil { + return nil, err + } + defer containerIDFile.Close() + } + + repo, tag := parsers.ParseRepositoryTag(config.Image) + if tag == "" { + tag = tags.DefaultTag + } + + ref := registry.ParseReference(tag) + var trustedRef registry.Reference + + if isTrusted() && !ref.HasDigest() { + var err error + trustedRef, err = cli.trustedReference(repo, ref) + if err != nil { + return nil, err + } + config.Image = trustedRef.ImageName(repo) + } + + //create the container + serverResp, err := cli.call("POST", "/containers/create?"+containerValues.Encode(), mergedConfig, nil) + //if image not found try to pull it + if serverResp.statusCode == 404 && strings.Contains(err.Error(), config.Image) { + fmt.Fprintf(cli.err, "Unable to find image '%s' locally\n", ref.ImageName(repo)) + + // we don't want to write to stdout anything apart from container.ID + if err = cli.pullImageCustomOut(config.Image, cli.err); err != nil { + return nil, err + } + if trustedRef != nil && !ref.HasDigest() { + repoInfo, err := registry.ParseRepositoryInfo(repo) + if err != nil { + return nil, err + } + if err := cli.tagTrusted(repoInfo, trustedRef, ref); err != nil { + return nil, err + } + } + // Retry + if serverResp, err = cli.call("POST", "/containers/create?"+containerValues.Encode(), mergedConfig, nil); err != nil { + return nil, err + } + } else if err != nil { + return nil, err + } + + defer serverResp.body.Close() + + var response types.ContainerCreateResponse + if err := json.NewDecoder(serverResp.body).Decode(&response); err != nil { + return nil, err + } + for _, warning := range response.Warnings { + fmt.Fprintf(cli.err, "WARNING: %s\n", warning) + } + if containerIDFile != nil { + if err = containerIDFile.Write(response.ID); err != nil { + return nil, err + } + } + return &response, nil +} + +// CmdCreate creates a new container from a given image. +// +// Usage: docker create [OPTIONS] IMAGE [COMMAND] [ARG...] +func (cli *DockerCli) CmdCreate(args ...string) error { + cmd := Cli.Subcmd("create", []string{"IMAGE [COMMAND] [ARG...]"}, Cli.DockerCommands["create"].Description, true) + addTrustedFlags(cmd, true) + + // These are flags not stored in Config/HostConfig + var ( + flName = cmd.String([]string{"-name"}, "", "Assign a name to the container") + ) + + config, hostConfig, cmd, err := runconfig.Parse(cmd, args) + if err != nil { + cmd.ReportError(err.Error(), true) + os.Exit(1) + } + if config.Image == "" { + cmd.Usage() + return nil + } + response, err := cli.createContainer(config, hostConfig, hostConfig.ContainerIDFile, *flName) + if err != nil { + return err + } + fmt.Fprintf(cli.out, "%s\n", response.ID) + return nil +} diff --git a/api/client/diff.go b/api/client/diff.go new file mode 100644 index 0000000000..24350a04a0 --- /dev/null +++ b/api/client/diff.go @@ -0,0 +1,56 @@ +package client + +import ( + "encoding/json" + "fmt" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/pkg/archive" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdDiff shows changes on a container's filesystem. +// +// Each changed file is printed on a separate line, prefixed with a single +// character that indicates the status of the file: C (modified), A (added), +// or D (deleted). +// +// Usage: docker diff CONTAINER +func (cli *DockerCli) CmdDiff(args ...string) error { + cmd := Cli.Subcmd("diff", []string{"CONTAINER"}, Cli.DockerCommands["diff"].Description, true) + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + if cmd.Arg(0) == "" { + return fmt.Errorf("Container name cannot be empty") + } + + serverResp, err := cli.call("GET", "/containers/"+cmd.Arg(0)+"/changes", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + changes := []types.ContainerChange{} + if err := json.NewDecoder(serverResp.body).Decode(&changes); err != nil { + return err + } + + for _, change := range changes { + var kind string + switch change.Kind { + case archive.ChangeModify: + kind = "C" + case archive.ChangeAdd: + kind = "A" + case archive.ChangeDelete: + kind = "D" + } + fmt.Fprintf(cli.out, "%s %s\n", kind, change.Path) + } + + return nil +} diff --git a/api/client/events.go b/api/client/events.go new file mode 100644 index 0000000000..435b13e6d9 --- /dev/null +++ b/api/client/events.go @@ -0,0 +1,63 @@ +package client + +import ( + "net/url" + "time" + + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/docker/docker/pkg/timeutils" +) + +// CmdEvents prints a live stream of real time events from the server. +// +// Usage: docker events [OPTIONS] +func (cli *DockerCli) CmdEvents(args ...string) error { + cmd := Cli.Subcmd("events", nil, Cli.DockerCommands["events"].Description, true) + since := cmd.String([]string{"#since", "-since"}, "", "Show all events created since timestamp") + until := cmd.String([]string{"-until"}, "", "Stream events until this timestamp") + flFilter := opts.NewListOpts(nil) + cmd.Var(&flFilter, []string{"f", "-filter"}, "Filter output based on conditions provided") + cmd.Require(flag.Exact, 0) + + cmd.ParseFlags(args, true) + + var ( + v = url.Values{} + eventFilterArgs = filters.Args{} + ) + + // Consolidate all filter flags, and sanity check them early. + // They'll get process in the daemon/server. + for _, f := range flFilter.GetAll() { + var err error + eventFilterArgs, err = filters.ParseFlag(f, eventFilterArgs) + if err != nil { + return err + } + } + ref := time.Now() + if *since != "" { + v.Set("since", timeutils.GetTimestamp(*since, ref)) + } + if *until != "" { + v.Set("until", timeutils.GetTimestamp(*until, ref)) + } + if len(eventFilterArgs) > 0 { + filterJSON, err := filters.ToParam(eventFilterArgs) + if err != nil { + return err + } + v.Set("filters", filterJSON) + } + sopts := &streamOpts{ + rawTerminal: true, + out: cli.out, + } + if _, err := cli.stream("GET", "/events?"+v.Encode(), sopts); err != nil { + return err + } + return nil +} diff --git a/api/client/exec.go b/api/client/exec.go new file mode 100644 index 0000000000..42cdf2fed3 --- /dev/null +++ b/api/client/exec.go @@ -0,0 +1,134 @@ +package client + +import ( + "encoding/json" + "fmt" + "io" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/pkg/promise" + "github.com/docker/docker/runconfig" +) + +// CmdExec runs a command in a running container. +// +// Usage: docker exec [OPTIONS] CONTAINER COMMAND [ARG...] +func (cli *DockerCli) CmdExec(args ...string) error { + cmd := Cli.Subcmd("exec", []string{"CONTAINER COMMAND [ARG...]"}, Cli.DockerCommands["exec"].Description, true) + + execConfig, err := runconfig.ParseExec(cmd, args) + // just in case the ParseExec does not exit + if execConfig.Container == "" || err != nil { + return Cli.StatusError{StatusCode: 1} + } + + serverResp, err := cli.call("POST", "/containers/"+execConfig.Container+"/exec", execConfig, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + var response types.ContainerExecCreateResponse + if err := json.NewDecoder(serverResp.body).Decode(&response); err != nil { + return err + } + + execID := response.ID + + if execID == "" { + fmt.Fprintf(cli.out, "exec ID empty") + return nil + } + + //Temp struct for execStart so that we don't need to transfer all the execConfig + execStartCheck := &types.ExecStartCheck{ + Detach: execConfig.Detach, + Tty: execConfig.Tty, + } + + if !execConfig.Detach { + if err := cli.CheckTtyInput(execConfig.AttachStdin, execConfig.Tty); err != nil { + return err + } + } else { + if _, _, err := readBody(cli.call("POST", "/exec/"+execID+"/start", execStartCheck, nil)); err != nil { + return err + } + // For now don't print this - wait for when we support exec wait() + // fmt.Fprintf(cli.out, "%s\n", execID) + return nil + } + + // Interactive exec requested. + var ( + out, stderr io.Writer + in io.ReadCloser + hijacked = make(chan io.Closer) + errCh chan error + ) + + // Block the return until the chan gets closed + defer func() { + logrus.Debugf("End of CmdExec(), Waiting for hijack to finish.") + if _, ok := <-hijacked; ok { + fmt.Fprintln(cli.err, "Hijack did not finish (chan still open)") + } + }() + + if execConfig.AttachStdin { + in = cli.in + } + if execConfig.AttachStdout { + out = cli.out + } + if execConfig.AttachStderr { + if execConfig.Tty { + stderr = cli.out + } else { + stderr = cli.err + } + } + errCh = promise.Go(func() error { + return cli.hijack("POST", "/exec/"+execID+"/start", execConfig.Tty, in, out, stderr, hijacked, execConfig) + }) + + // Acknowledge the hijack before starting + select { + case closer := <-hijacked: + // Make sure that hijack gets closed when returning. (result + // in closing hijack chan and freeing server's goroutines. + if closer != nil { + defer closer.Close() + } + case err := <-errCh: + if err != nil { + logrus.Debugf("Error hijack: %s", err) + return err + } + } + + if execConfig.Tty && cli.isTerminalIn { + if err := cli.monitorTtySize(execID, true); err != nil { + fmt.Fprintf(cli.err, "Error monitoring TTY size: %s\n", err) + } + } + + if err := <-errCh; err != nil { + logrus.Debugf("Error hijack: %s", err) + return err + } + + var status int + if _, status, err = getExecExitCode(cli, execID); err != nil { + return err + } + + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + + return nil +} diff --git a/api/client/export.go b/api/client/export.go new file mode 100644 index 0000000000..2763b7b045 --- /dev/null +++ b/api/client/export.go @@ -0,0 +1,46 @@ +package client + +import ( + "errors" + "os" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdExport exports a filesystem as a tar archive. +// +// The tar archive is streamed to STDOUT by default or written to a file. +// +// Usage: docker export [OPTIONS] CONTAINER +func (cli *DockerCli) CmdExport(args ...string) error { + cmd := Cli.Subcmd("export", []string{"CONTAINER"}, Cli.DockerCommands["export"].Description, true) + outfile := cmd.String([]string{"o", "-output"}, "", "Write to a file, instead of STDOUT") + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + var ( + output = cli.out + err error + ) + if *outfile != "" { + output, err = os.Create(*outfile) + if err != nil { + return err + } + } else if cli.isTerminalOut { + return errors.New("Cowardly refusing to save to a terminal. Use the -o flag or redirect.") + } + + image := cmd.Arg(0) + sopts := &streamOpts{ + rawTerminal: true, + out: output, + } + if _, err := cli.stream("GET", "/containers/"+image+"/export", sopts); err != nil { + return err + } + + return nil +} diff --git a/api/client/hijack.go b/api/client/hijack.go new file mode 100644 index 0000000000..ae09ad0f3c --- /dev/null +++ b/api/client/hijack.go @@ -0,0 +1,254 @@ +package client + +import ( + "crypto/tls" + "errors" + "fmt" + "io" + "net" + "net/http" + "net/http/httputil" + "os" + "runtime" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/pkg/stdcopy" + "github.com/docker/docker/pkg/term" +) + +type tlsClientCon struct { + *tls.Conn + rawConn net.Conn +} + +func (c *tlsClientCon) CloseWrite() error { + // Go standard tls.Conn doesn't provide the CloseWrite() method so we do it + // on its underlying connection. + if cwc, ok := c.rawConn.(interface { + CloseWrite() error + }); ok { + return cwc.CloseWrite() + } + return nil +} + +func tlsDial(network, addr string, config *tls.Config) (net.Conn, error) { + return tlsDialWithDialer(new(net.Dialer), network, addr, config) +} + +// We need to copy Go's implementation of tls.Dial (pkg/cryptor/tls/tls.go) in +// order to return our custom tlsClientCon struct which holds both the tls.Conn +// object _and_ its underlying raw connection. The rationale for this is that +// we need to be able to close the write end of the connection when attaching, +// which tls.Conn does not provide. +func tlsDialWithDialer(dialer *net.Dialer, network, addr string, config *tls.Config) (net.Conn, error) { + // We want the Timeout and Deadline values from dialer to cover the + // whole process: TCP connection and TLS handshake. This means that we + // also need to start our own timers now. + timeout := dialer.Timeout + + if !dialer.Deadline.IsZero() { + deadlineTimeout := dialer.Deadline.Sub(time.Now()) + if timeout == 0 || deadlineTimeout < timeout { + timeout = deadlineTimeout + } + } + + var errChannel chan error + + if timeout != 0 { + errChannel = make(chan error, 2) + time.AfterFunc(timeout, func() { + errChannel <- errors.New("") + }) + } + + rawConn, err := dialer.Dial(network, addr) + if err != nil { + return nil, err + } + // When we set up a TCP connection for hijack, there could be long periods + // of inactivity (a long running command with no output) that in certain + // network setups may cause ECONNTIMEOUT, leaving the client in an unknown + // state. Setting TCP KeepAlive on the socket connection will prohibit + // ECONNTIMEOUT unless the socket connection truly is broken + if tcpConn, ok := rawConn.(*net.TCPConn); ok { + tcpConn.SetKeepAlive(true) + tcpConn.SetKeepAlivePeriod(30 * time.Second) + } + + colonPos := strings.LastIndex(addr, ":") + if colonPos == -1 { + colonPos = len(addr) + } + hostname := addr[:colonPos] + + // If no ServerName is set, infer the ServerName + // from the hostname we're connecting to. + if config.ServerName == "" { + // Make a copy to avoid polluting argument or default. + c := *config + c.ServerName = hostname + config = &c + } + + conn := tls.Client(rawConn, config) + + if timeout == 0 { + err = conn.Handshake() + } else { + go func() { + errChannel <- conn.Handshake() + }() + + err = <-errChannel + } + + if err != nil { + rawConn.Close() + return nil, err + } + + // This is Docker difference with standard's crypto/tls package: returned a + // wrapper which holds both the TLS and raw connections. + return &tlsClientCon{conn, rawConn}, nil +} + +func (cli *DockerCli) dial() (net.Conn, error) { + if cli.tlsConfig != nil && cli.proto != "unix" { + // Notice this isn't Go standard's tls.Dial function + return tlsDial(cli.proto, cli.addr, cli.tlsConfig) + } + return net.Dial(cli.proto, cli.addr) +} + +func (cli *DockerCli) hijack(method, path string, setRawTerminal bool, in io.ReadCloser, stdout, stderr io.Writer, started chan io.Closer, data interface{}) error { + defer func() { + if started != nil { + close(started) + } + }() + + params, err := cli.encodeData(data) + if err != nil { + return err + } + req, err := http.NewRequest(method, fmt.Sprintf("%s/v%s%s", cli.basePath, api.Version, path), params) + if err != nil { + return err + } + + // Add CLI Config's HTTP Headers BEFORE we set the Docker headers + // then the user can't change OUR headers + for k, v := range cli.configFile.HTTPHeaders { + req.Header.Set(k, v) + } + + req.Header.Set("User-Agent", "Docker-Client/"+dockerversion.VERSION+" ("+runtime.GOOS+")") + req.Header.Set("Content-Type", "text/plain") + req.Header.Set("Connection", "Upgrade") + req.Header.Set("Upgrade", "tcp") + req.Host = cli.addr + + dial, err := cli.dial() + if err != nil { + if strings.Contains(err.Error(), "connection refused") { + return fmt.Errorf("Cannot connect to the Docker daemon. Is 'docker daemon' running on this host?") + } + return err + } + + // When we set up a TCP connection for hijack, there could be long periods + // of inactivity (a long running command with no output) that in certain + // network setups may cause ECONNTIMEOUT, leaving the client in an unknown + // state. Setting TCP KeepAlive on the socket connection will prohibit + // ECONNTIMEOUT unless the socket connection truly is broken + if tcpConn, ok := dial.(*net.TCPConn); ok { + tcpConn.SetKeepAlive(true) + tcpConn.SetKeepAlivePeriod(30 * time.Second) + } + + clientconn := httputil.NewClientConn(dial, nil) + defer clientconn.Close() + + // Server hijacks the connection, error 'connection closed' expected + clientconn.Do(req) + + rwc, br := clientconn.Hijack() + defer rwc.Close() + + if started != nil { + started <- rwc + } + + var oldState *term.State + + if in != nil && setRawTerminal && cli.isTerminalIn && os.Getenv("NORAW") == "" { + oldState, err = term.SetRawTerminal(cli.inFd) + if err != nil { + return err + } + defer term.RestoreTerminal(cli.inFd, oldState) + } + + receiveStdout := make(chan error, 1) + if stdout != nil || stderr != nil { + go func() { + defer func() { + if in != nil { + if setRawTerminal && cli.isTerminalIn { + term.RestoreTerminal(cli.inFd, oldState) + } + in.Close() + } + }() + + // When TTY is ON, use regular copy + if setRawTerminal && stdout != nil { + _, err = io.Copy(stdout, br) + } else { + _, err = stdcopy.StdCopy(stdout, stderr, br) + } + logrus.Debugf("[hijack] End of stdout") + receiveStdout <- err + }() + } + + stdinDone := make(chan struct{}) + go func() { + if in != nil { + io.Copy(rwc, in) + logrus.Debugf("[hijack] End of stdin") + } + + if conn, ok := rwc.(interface { + CloseWrite() error + }); ok { + if err := conn.CloseWrite(); err != nil { + logrus.Debugf("Couldn't send EOF: %s", err) + } + } + close(stdinDone) + }() + + select { + case err := <-receiveStdout: + if err != nil { + logrus.Debugf("Error receiveStdout: %s", err) + return err + } + case <-stdinDone: + if stdout != nil || stderr != nil { + if err := <-receiveStdout; err != nil { + logrus.Debugf("Error receiveStdout: %s", err) + return err + } + } + } + + return nil +} diff --git a/api/client/history.go b/api/client/history.go new file mode 100644 index 0000000000..cf0e4e08e7 --- /dev/null +++ b/api/client/history.go @@ -0,0 +1,78 @@ +package client + +import ( + "encoding/json" + "fmt" + "strings" + "text/tabwriter" + "time" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/units" +) + +// CmdHistory shows the history of an image. +// +// Usage: docker history [OPTIONS] IMAGE +func (cli *DockerCli) CmdHistory(args ...string) error { + cmd := Cli.Subcmd("history", []string{"IMAGE"}, Cli.DockerCommands["history"].Description, true) + human := cmd.Bool([]string{"H", "-human"}, true, "Print sizes and dates in human readable format") + quiet := cmd.Bool([]string{"q", "-quiet"}, false, "Only show numeric IDs") + noTrunc := cmd.Bool([]string{"#notrunc", "-no-trunc"}, false, "Don't truncate output") + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + serverResp, err := cli.call("GET", "/images/"+cmd.Arg(0)+"/history", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + history := []types.ImageHistory{} + if err := json.NewDecoder(serverResp.body).Decode(&history); err != nil { + return err + } + + w := tabwriter.NewWriter(cli.out, 20, 1, 3, ' ', 0) + if !*quiet { + fmt.Fprintln(w, "IMAGE\tCREATED\tCREATED BY\tSIZE\tCOMMENT") + } + + for _, entry := range history { + if *noTrunc { + fmt.Fprintf(w, entry.ID) + } else { + fmt.Fprintf(w, stringid.TruncateID(entry.ID)) + } + if !*quiet { + if *human { + fmt.Fprintf(w, "\t%s ago\t", units.HumanDuration(time.Now().UTC().Sub(time.Unix(entry.Created, 0)))) + } else { + fmt.Fprintf(w, "\t%s\t", time.Unix(entry.Created, 0).Format(time.RFC3339)) + } + + if *noTrunc { + fmt.Fprintf(w, "%s\t", strings.Replace(entry.CreatedBy, "\t", " ", -1)) + } else { + fmt.Fprintf(w, "%s\t", stringutils.Truncate(strings.Replace(entry.CreatedBy, "\t", " ", -1), 45)) + } + + if *human { + fmt.Fprintf(w, "%s\t", units.HumanSize(float64(entry.Size))) + } else { + fmt.Fprintf(w, "%d\t", entry.Size) + } + + fmt.Fprintf(w, "%s", entry.Comment) + } + fmt.Fprintf(w, "\n") + } + w.Flush() + return nil +} diff --git a/api/client/images.go b/api/client/images.go new file mode 100644 index 0000000000..ed001de745 --- /dev/null +++ b/api/client/images.go @@ -0,0 +1,130 @@ +package client + +import ( + "encoding/json" + "fmt" + "net/url" + "text/tabwriter" + "time" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/units" + "github.com/docker/docker/utils" +) + +// CmdImages lists the images in a specified repository, or all top-level images if no repository is specified. +// +// Usage: docker images [OPTIONS] [REPOSITORY] +func (cli *DockerCli) CmdImages(args ...string) error { + cmd := Cli.Subcmd("images", []string{"[REPOSITORY[:TAG]]"}, Cli.DockerCommands["images"].Description, true) + quiet := cmd.Bool([]string{"q", "-quiet"}, false, "Only show numeric IDs") + all := cmd.Bool([]string{"a", "-all"}, false, "Show all images (default hides intermediate images)") + noTrunc := cmd.Bool([]string{"#notrunc", "-no-trunc"}, false, "Don't truncate output") + showDigests := cmd.Bool([]string{"-digests"}, false, "Show digests") + + flFilter := opts.NewListOpts(nil) + cmd.Var(&flFilter, []string{"f", "-filter"}, "Filter output based on conditions provided") + cmd.Require(flag.Max, 1) + + cmd.ParseFlags(args, true) + + // Consolidate all filter flags, and sanity check them early. + // They'll get process in the daemon/server. + imageFilterArgs := filters.Args{} + for _, f := range flFilter.GetAll() { + var err error + imageFilterArgs, err = filters.ParseFlag(f, imageFilterArgs) + if err != nil { + return err + } + } + + matchName := cmd.Arg(0) + v := url.Values{} + if len(imageFilterArgs) > 0 { + filterJSON, err := filters.ToParam(imageFilterArgs) + if err != nil { + return err + } + v.Set("filters", filterJSON) + } + + if cmd.NArg() == 1 { + // FIXME rename this parameter, to not be confused with the filters flag + v.Set("filter", matchName) + } + if *all { + v.Set("all", "1") + } + + serverResp, err := cli.call("GET", "/images/json?"+v.Encode(), nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + images := []types.Image{} + if err := json.NewDecoder(serverResp.body).Decode(&images); err != nil { + return err + } + + w := tabwriter.NewWriter(cli.out, 20, 1, 3, ' ', 0) + if !*quiet { + if *showDigests { + fmt.Fprintln(w, "REPOSITORY\tTAG\tDIGEST\tIMAGE ID\tCREATED\tVIRTUAL SIZE") + } else { + fmt.Fprintln(w, "REPOSITORY\tTAG\tIMAGE ID\tCREATED\tVIRTUAL SIZE") + } + } + + for _, image := range images { + ID := image.ID + if !*noTrunc { + ID = stringid.TruncateID(ID) + } + + repoTags := image.RepoTags + repoDigests := image.RepoDigests + + if len(repoTags) == 1 && repoTags[0] == ":" && len(repoDigests) == 1 && repoDigests[0] == "@" { + // dangling image - clear out either repoTags or repoDigsts so we only show it once below + repoDigests = []string{} + } + + // combine the tags and digests lists + tagsAndDigests := append(repoTags, repoDigests...) + for _, repoAndRef := range tagsAndDigests { + repo, ref := parsers.ParseRepositoryTag(repoAndRef) + // default tag and digest to none - if there's a value, it'll be set below + tag := "" + digest := "" + if utils.DigestReference(ref) { + digest = ref + } else { + tag = ref + } + + if !*quiet { + if *showDigests { + fmt.Fprintf(w, "%s\t%s\t%s\t%s\t%s ago\t%s\n", repo, tag, digest, ID, units.HumanDuration(time.Now().UTC().Sub(time.Unix(int64(image.Created), 0))), units.HumanSize(float64(image.VirtualSize))) + } else { + fmt.Fprintf(w, "%s\t%s\t%s\t%s ago\t%s\n", repo, tag, ID, units.HumanDuration(time.Now().UTC().Sub(time.Unix(int64(image.Created), 0))), units.HumanSize(float64(image.VirtualSize))) + } + } else { + fmt.Fprintln(w, ID) + } + } + } + + if !*quiet { + w.Flush() + } + return nil +} diff --git a/api/client/import.go b/api/client/import.go new file mode 100644 index 0000000000..c64e88d3c1 --- /dev/null +++ b/api/client/import.go @@ -0,0 +1,79 @@ +package client + +import ( + "fmt" + "io" + "net/url" + "os" + + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/urlutil" + "github.com/docker/docker/registry" +) + +// CmdImport creates an empty filesystem image, imports the contents of the tarball into the image, and optionally tags the image. +// +// The URL argument is the address of a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) file or a path to local file relative to docker client. If the URL is '-', then the tar file is read from STDIN. +// +// Usage: docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]] +func (cli *DockerCli) CmdImport(args ...string) error { + cmd := Cli.Subcmd("import", []string{"file|URL|- [REPOSITORY[:TAG]]"}, Cli.DockerCommands["import"].Description, true) + flChanges := opts.NewListOpts(nil) + cmd.Var(&flChanges, []string{"c", "-change"}, "Apply Dockerfile instruction to the created image") + message := cmd.String([]string{"m", "-message"}, "", "Set commit message for imported image") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var ( + v = url.Values{} + src = cmd.Arg(0) + repository = cmd.Arg(1) + ) + + v.Set("fromSrc", src) + v.Set("repo", repository) + v.Set("message", *message) + for _, change := range flChanges.GetAll() { + v.Add("changes", change) + } + if cmd.NArg() == 3 { + fmt.Fprintf(cli.err, "[DEPRECATED] The format 'file|URL|- [REPOSITORY [TAG]]' has been deprecated. Please use file|URL|- [REPOSITORY[:TAG]]\n") + v.Set("tag", cmd.Arg(2)) + } + + if repository != "" { + //Check if the given image name can be resolved + repo, _ := parsers.ParseRepositoryTag(repository) + if err := registry.ValidateRepositoryName(repo); err != nil { + return err + } + } + + var in io.Reader + + if src == "-" { + in = cli.in + } else if !urlutil.IsURL(src) { + v.Set("fromSrc", "-") + file, err := os.Open(src) + if err != nil { + return err + } + defer file.Close() + in = file + + } + + sopts := &streamOpts{ + rawTerminal: true, + in: in, + out: cli.out, + } + + _, err := cli.stream("POST", "/images/create?"+v.Encode(), sopts) + return err +} diff --git a/api/client/info.go b/api/client/info.go new file mode 100644 index 0000000000..ebed2452e2 --- /dev/null +++ b/api/client/info.go @@ -0,0 +1,114 @@ +package client + +import ( + "encoding/json" + "fmt" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/ioutils" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/units" +) + +// CmdInfo displays system-wide information. +// +// Usage: docker info +func (cli *DockerCli) CmdInfo(args ...string) error { + cmd := Cli.Subcmd("info", nil, Cli.DockerCommands["info"].Description, true) + cmd.Require(flag.Exact, 0) + + cmd.ParseFlags(args, true) + + serverResp, err := cli.call("GET", "/info", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + info := &types.Info{} + if err := json.NewDecoder(serverResp.body).Decode(info); err != nil { + return fmt.Errorf("Error reading remote info: %v", err) + } + + fmt.Fprintf(cli.out, "Containers: %d\n", info.Containers) + fmt.Fprintf(cli.out, "Images: %d\n", info.Images) + ioutils.FprintfIfNotEmpty(cli.out, "Server Version: %s\n", info.ServerVersion) + ioutils.FprintfIfNotEmpty(cli.out, "Storage Driver: %s\n", info.Driver) + if info.DriverStatus != nil { + for _, pair := range info.DriverStatus { + fmt.Fprintf(cli.out, " %s: %s\n", pair[0], pair[1]) + } + } + ioutils.FprintfIfNotEmpty(cli.out, "Execution Driver: %s\n", info.ExecutionDriver) + ioutils.FprintfIfNotEmpty(cli.out, "Logging Driver: %s\n", info.LoggingDriver) + ioutils.FprintfIfNotEmpty(cli.out, "Kernel Version: %s\n", info.KernelVersion) + ioutils.FprintfIfNotEmpty(cli.out, "Operating System: %s\n", info.OperatingSystem) + fmt.Fprintf(cli.out, "CPUs: %d\n", info.NCPU) + fmt.Fprintf(cli.out, "Total Memory: %s\n", units.BytesSize(float64(info.MemTotal))) + ioutils.FprintfIfNotEmpty(cli.out, "Name: %s\n", info.Name) + ioutils.FprintfIfNotEmpty(cli.out, "ID: %s\n", info.ID) + + if info.Debug { + fmt.Fprintf(cli.out, "Debug mode (server): %v\n", info.Debug) + fmt.Fprintf(cli.out, " File Descriptors: %d\n", info.NFd) + fmt.Fprintf(cli.out, " Goroutines: %d\n", info.NGoroutines) + fmt.Fprintf(cli.out, " System Time: %s\n", info.SystemTime) + fmt.Fprintf(cli.out, " EventsListeners: %d\n", info.NEventsListener) + fmt.Fprintf(cli.out, " Init SHA1: %s\n", info.InitSha1) + fmt.Fprintf(cli.out, " Init Path: %s\n", info.InitPath) + fmt.Fprintf(cli.out, " Docker Root Dir: %s\n", info.DockerRootDir) + } + + ioutils.FprintfIfNotEmpty(cli.out, "Http Proxy: %s\n", info.HTTPProxy) + ioutils.FprintfIfNotEmpty(cli.out, "Https Proxy: %s\n", info.HTTPSProxy) + ioutils.FprintfIfNotEmpty(cli.out, "No Proxy: %s\n", info.NoProxy) + + if info.IndexServerAddress != "" { + u := cli.configFile.AuthConfigs[info.IndexServerAddress].Username + if len(u) > 0 { + fmt.Fprintf(cli.out, "Username: %v\n", u) + fmt.Fprintf(cli.out, "Registry: %v\n", info.IndexServerAddress) + } + } + + // Only output these warnings if the server does not support these features + if h, err := httputils.ParseServerHeader(serverResp.header.Get("Server")); err == nil { + if h.OS != "windows" { + if !info.MemoryLimit { + fmt.Fprintf(cli.err, "WARNING: No memory limit support\n") + } + if !info.SwapLimit { + fmt.Fprintf(cli.err, "WARNING: No swap limit support\n") + } + if !info.IPv4Forwarding { + fmt.Fprintf(cli.err, "WARNING: IPv4 forwarding is disabled\n") + } + if !info.BridgeNfIptables { + fmt.Fprintf(cli.err, "WARNING: bridge-nf-call-iptables is disabled\n") + } + if !info.BridgeNfIP6tables { + fmt.Fprintf(cli.err, "WARNING: bridge-nf-call-ip6tables is disabled\n") + } + } + } + + if info.Labels != nil { + fmt.Fprintln(cli.out, "Labels:") + for _, attribute := range info.Labels { + fmt.Fprintf(cli.out, " %s\n", attribute) + } + } + + ioutils.FprintfIfTrue(cli.out, "Experimental: %v\n", info.ExperimentalBuild) + if info.ClusterStore != "" { + fmt.Fprintf(cli.out, "Cluster store: %s\n", info.ClusterStore) + } + + if info.ClusterAdvertise != "" { + fmt.Fprintf(cli.out, "Cluster advertise: %s\n", info.ClusterAdvertise) + } + return nil +} diff --git a/api/client/inspect.go b/api/client/inspect.go new file mode 100644 index 0000000000..37a3bd4056 --- /dev/null +++ b/api/client/inspect.go @@ -0,0 +1,203 @@ +package client + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "net/url" + "strings" + "text/template" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +var funcMap = template.FuncMap{ + "json": func(v interface{}) string { + a, _ := json.Marshal(v) + return string(a) + }, +} + +// CmdInspect displays low-level information on one or more containers or images. +// +// Usage: docker inspect [OPTIONS] CONTAINER|IMAGE [CONTAINER|IMAGE...] +func (cli *DockerCli) CmdInspect(args ...string) error { + cmd := Cli.Subcmd("inspect", []string{"CONTAINER|IMAGE [CONTAINER|IMAGE...]"}, Cli.DockerCommands["inspect"].Description, true) + tmplStr := cmd.String([]string{"f", "#format", "-format"}, "", "Format the output using the given go template") + inspectType := cmd.String([]string{"-type"}, "", "Return JSON for specified type, (e.g image or container)") + size := cmd.Bool([]string{"s", "-size"}, false, "Display total file sizes if the type is container") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var tmpl *template.Template + var err error + var obj []byte + + if *tmplStr != "" { + if tmpl, err = template.New("").Funcs(funcMap).Parse(*tmplStr); err != nil { + return Cli.StatusError{StatusCode: 64, + Status: "Template parsing error: " + err.Error()} + } + } + + if *inspectType != "" && *inspectType != "container" && *inspectType != "image" { + return fmt.Errorf("%q is not a valid value for --type", *inspectType) + } + + indented := new(bytes.Buffer) + indented.WriteString("[\n") + status := 0 + isImage := false + + v := url.Values{} + if *size { + v.Set("size", "1") + } + + for _, name := range cmd.Args() { + if *inspectType == "" || *inspectType == "container" { + obj, _, err = readBody(cli.call("GET", "/containers/"+name+"/json?"+v.Encode(), nil, nil)) + if err != nil { + if err == errConnectionFailed { + return err + } + if *inspectType == "container" { + if strings.Contains(err.Error(), "No such") { + fmt.Fprintf(cli.err, "Error: No such container: %s\n", name) + } else { + fmt.Fprintf(cli.err, "%s", err) + } + status = 1 + continue + } + } + } + + if obj == nil && (*inspectType == "" || *inspectType == "image") { + obj, _, err = readBody(cli.call("GET", "/images/"+name+"/json", nil, nil)) + isImage = true + if err != nil { + if err == errConnectionFailed { + return err + } + if strings.Contains(err.Error(), "No such") { + if *inspectType == "" { + fmt.Fprintf(cli.err, "Error: No such image or container: %s\n", name) + } else { + fmt.Fprintf(cli.err, "Error: No such image: %s\n", name) + } + } else { + fmt.Fprintf(cli.err, "%s", err) + } + status = 1 + continue + } + } + + if tmpl == nil { + if err := json.Indent(indented, obj, "", " "); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + status = 1 + continue + } + } else { + rdr := bytes.NewReader(obj) + dec := json.NewDecoder(rdr) + buf := bytes.NewBufferString("") + + if isImage { + inspPtr := types.ImageInspect{} + if err := dec.Decode(&inspPtr); err != nil { + fmt.Fprintf(cli.err, "Unable to read inspect data: %v\n", err) + status = 1 + break + } + if err := tmpl.Execute(buf, inspPtr); err != nil { + rdr.Seek(0, 0) + var ok bool + + if buf, ok = cli.decodeRawInspect(tmpl, dec); !ok { + fmt.Fprintf(cli.err, "Template parsing error: %v\n", err) + status = 1 + break + } + } + } else { + inspPtr := types.ContainerJSON{} + if err := dec.Decode(&inspPtr); err != nil { + fmt.Fprintf(cli.err, "Unable to read inspect data: %v\n", err) + status = 1 + break + } + if err := tmpl.Execute(buf, inspPtr); err != nil { + rdr.Seek(0, 0) + var ok bool + + if buf, ok = cli.decodeRawInspect(tmpl, dec); !ok { + fmt.Fprintf(cli.err, "Template parsing error: %v\n", err) + status = 1 + break + } + } + } + + cli.out.Write(buf.Bytes()) + cli.out.Write([]byte{'\n'}) + } + indented.WriteString(",") + } + + if indented.Len() > 1 { + // Remove trailing ',' + indented.Truncate(indented.Len() - 1) + } + indented.WriteString("]\n") + + if tmpl == nil { + // Note that we will always write "[]" when "-f" isn't specified, + // to make sure the output would always be array, see + // https://github.com/docker/docker/pull/9500#issuecomment-65846734 + if _, err := io.Copy(cli.out, indented); err != nil { + return err + } + } + + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + return nil +} + +// decodeRawInspect executes the inspect template with a raw interface. +// This allows docker cli to parse inspect structs injected with Swarm fields. +// Unfortunately, go 1.4 doesn't fail executing invalid templates when the input is an interface. +// It doesn't allow to modify this behavior either, sending messages to the output. +// We assume that the template is invalid when there is a , if the template was valid +// we'd get or "" values. In that case we fail with the original error raised executing the +// template with the typed input. +// +// TODO: Go 1.5 allows to customize the error behavior, we can probably get rid of this as soon as +// we build Docker with that version: +// https://golang.org/pkg/text/template/#Template.Option +func (cli *DockerCli) decodeRawInspect(tmpl *template.Template, dec *json.Decoder) (*bytes.Buffer, bool) { + var raw interface{} + buf := bytes.NewBufferString("") + + if rawErr := dec.Decode(&raw); rawErr != nil { + fmt.Fprintf(cli.err, "Unable to read inspect data: %v\n", rawErr) + return buf, false + } + + if rawErr := tmpl.Execute(buf, raw); rawErr != nil { + return buf, false + } + + if strings.Contains(buf.String(), "") { + return buf, false + } + return buf, true +} diff --git a/api/client/kill.go b/api/client/kill.go new file mode 100644 index 0000000000..c4c355c74b --- /dev/null +++ b/api/client/kill.go @@ -0,0 +1,33 @@ +package client + +import ( + "fmt" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdKill kills one or more running container using SIGKILL or a specified signal. +// +// Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdKill(args ...string) error { + cmd := Cli.Subcmd("kill", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["kill"].Description, true) + signal := cmd.String([]string{"s", "-signal"}, "KILL", "Signal to send to the container") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var errNames []string + for _, name := range cmd.Args() { + if _, _, err := readBody(cli.call("POST", fmt.Sprintf("/containers/%s/kill?signal=%s", name, *signal), nil, nil)); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to kill containers: %v", errNames) + } + return nil +} diff --git a/api/client/load.go b/api/client/load.go new file mode 100644 index 0000000000..378170e17e --- /dev/null +++ b/api/client/load.go @@ -0,0 +1,42 @@ +package client + +import ( + "io" + "os" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdLoad loads an image from a tar archive. +// +// The tar archive is read from STDIN by default, or from a tar archive file. +// +// Usage: docker load [OPTIONS] +func (cli *DockerCli) CmdLoad(args ...string) error { + cmd := Cli.Subcmd("load", nil, Cli.DockerCommands["load"].Description, true) + infile := cmd.String([]string{"i", "-input"}, "", "Read from a tar archive file, instead of STDIN") + cmd.Require(flag.Exact, 0) + + cmd.ParseFlags(args, true) + + var ( + input io.Reader = cli.in + err error + ) + if *infile != "" { + input, err = os.Open(*infile) + if err != nil { + return err + } + } + sopts := &streamOpts{ + rawTerminal: true, + in: input, + out: cli.out, + } + if _, err := cli.stream("POST", "/images/load", sopts); err != nil { + return err + } + return nil +} diff --git a/api/client/login.go b/api/client/login.go new file mode 100644 index 0000000000..e941a14efe --- /dev/null +++ b/api/client/login.go @@ -0,0 +1,153 @@ +package client + +import ( + "bufio" + "encoding/json" + "fmt" + "io" + "os" + "runtime" + "strings" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/cliconfig" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/registry" +) + +// CmdLogin logs in or registers a user to a Docker registry service. +// +// If no server is specified, the user will be logged into or registered to the registry's index server. +// +// Usage: docker login SERVER +func (cli *DockerCli) CmdLogin(args ...string) error { + cmd := Cli.Subcmd("login", []string{"[SERVER]"}, Cli.DockerCommands["login"].Description+".\nIf no server is specified \""+registry.IndexServer+"\" is the default.", true) + cmd.Require(flag.Max, 1) + + var username, password, email string + + cmd.StringVar(&username, []string{"u", "-username"}, "", "Username") + cmd.StringVar(&password, []string{"p", "-password"}, "", "Password") + cmd.StringVar(&email, []string{"e", "-email"}, "", "Email") + + cmd.ParseFlags(args, true) + + // On Windows, force the use of the regular OS stdin stream. Fixes #14336/#14210 + if runtime.GOOS == "windows" { + cli.in = os.Stdin + } + + serverAddress := registry.IndexServer + if len(cmd.Args()) > 0 { + serverAddress = cmd.Arg(0) + } + + promptDefault := func(prompt string, configDefault string) { + if configDefault == "" { + fmt.Fprintf(cli.out, "%s: ", prompt) + } else { + fmt.Fprintf(cli.out, "%s (%s): ", prompt, configDefault) + } + } + + readInput := func(in io.Reader, out io.Writer) string { + reader := bufio.NewReader(in) + line, _, err := reader.ReadLine() + if err != nil { + fmt.Fprintln(out, err.Error()) + os.Exit(1) + } + return string(line) + } + + authconfig, ok := cli.configFile.AuthConfigs[serverAddress] + if !ok { + authconfig = cliconfig.AuthConfig{} + } + + if username == "" { + promptDefault("Username", authconfig.Username) + username = readInput(cli.in, cli.out) + username = strings.TrimSpace(username) + if username == "" { + username = authconfig.Username + } + } + // Assume that a different username means they may not want to use + // the password or email from the config file, so prompt them + if username != authconfig.Username { + if password == "" { + oldState, err := term.SaveState(cli.inFd) + if err != nil { + return err + } + fmt.Fprintf(cli.out, "Password: ") + term.DisableEcho(cli.inFd, oldState) + + password = readInput(cli.in, cli.out) + fmt.Fprint(cli.out, "\n") + + term.RestoreTerminal(cli.inFd, oldState) + if password == "" { + return fmt.Errorf("Error : Password Required") + } + } + + if email == "" { + promptDefault("Email", authconfig.Email) + email = readInput(cli.in, cli.out) + if email == "" { + email = authconfig.Email + } + } + } else { + // However, if they don't override the username use the + // password or email from the cmd line if specified. IOW, allow + // then to change/override them. And if not specified, just + // use what's in the config file + if password == "" { + password = authconfig.Password + } + if email == "" { + email = authconfig.Email + } + } + authconfig.Username = username + authconfig.Password = password + authconfig.Email = email + authconfig.ServerAddress = serverAddress + cli.configFile.AuthConfigs[serverAddress] = authconfig + + serverResp, err := cli.call("POST", "/auth", cli.configFile.AuthConfigs[serverAddress], nil) + if serverResp.statusCode == 401 { + delete(cli.configFile.AuthConfigs, serverAddress) + if err2 := cli.configFile.Save(); err2 != nil { + fmt.Fprintf(cli.out, "WARNING: could not save config file: %v\n", err2) + } + return err + } + if err != nil { + return err + } + + defer serverResp.body.Close() + + var response types.AuthResponse + if err := json.NewDecoder(serverResp.body).Decode(&response); err != nil { + // Upon error, remove entry + delete(cli.configFile.AuthConfigs, serverAddress) + return err + } + + if err := cli.configFile.Save(); err != nil { + return fmt.Errorf("Error saving config file: %v", err) + } + fmt.Fprintf(cli.out, "WARNING: login credentials saved in %s\n", cli.configFile.Filename()) + + if response.Status != "" { + fmt.Fprintf(cli.out, "%s\n", response.Status) + } + return nil +} diff --git a/api/client/logout.go b/api/client/logout.go new file mode 100644 index 0000000000..3753cbbe74 --- /dev/null +++ b/api/client/logout.go @@ -0,0 +1,39 @@ +package client + +import ( + "fmt" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/registry" +) + +// CmdLogout logs a user out from a Docker registry. +// +// If no server is specified, the user will be logged out from the registry's index server. +// +// Usage: docker logout [SERVER] +func (cli *DockerCli) CmdLogout(args ...string) error { + cmd := Cli.Subcmd("logout", []string{"[SERVER]"}, Cli.DockerCommands["logout"].Description+".\nIf no server is specified \""+registry.IndexServer+"\" is the default.", true) + cmd.Require(flag.Max, 1) + + cmd.ParseFlags(args, true) + + serverAddress := registry.IndexServer + if len(cmd.Args()) > 0 { + serverAddress = cmd.Arg(0) + } + + if _, ok := cli.configFile.AuthConfigs[serverAddress]; !ok { + fmt.Fprintf(cli.out, "Not logged in to %s\n", serverAddress) + return nil + } + + fmt.Fprintf(cli.out, "Remove login credentials for %s\n", serverAddress) + delete(cli.configFile.AuthConfigs, serverAddress) + if err := cli.configFile.Save(); err != nil { + return fmt.Errorf("Failed to save docker config: %v", err) + } + + return nil +} diff --git a/api/client/logs.go b/api/client/logs.go new file mode 100644 index 0000000000..6de7b1332d --- /dev/null +++ b/api/client/logs.go @@ -0,0 +1,74 @@ +package client + +import ( + "encoding/json" + "fmt" + "net/url" + "time" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/timeutils" +) + +var validDrivers = map[string]bool{ + "json-file": true, + "journald": true, +} + +// CmdLogs fetches the logs of a given container. +// +// docker logs [OPTIONS] CONTAINER +func (cli *DockerCli) CmdLogs(args ...string) error { + cmd := Cli.Subcmd("logs", []string{"CONTAINER"}, Cli.DockerCommands["logs"].Description, true) + follow := cmd.Bool([]string{"f", "-follow"}, false, "Follow log output") + since := cmd.String([]string{"-since"}, "", "Show logs since timestamp") + times := cmd.Bool([]string{"t", "-timestamps"}, false, "Show timestamps") + tail := cmd.String([]string{"-tail"}, "all", "Number of lines to show from the end of the logs") + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + name := cmd.Arg(0) + + serverResp, err := cli.call("GET", "/containers/"+name+"/json", nil, nil) + if err != nil { + return err + } + + var c types.ContainerJSON + if err := json.NewDecoder(serverResp.body).Decode(&c); err != nil { + return err + } + + if !validDrivers[c.HostConfig.LogConfig.Type] { + return fmt.Errorf("\"logs\" command is supported only for \"json-file\" and \"journald\" logging drivers (got: %s)", c.HostConfig.LogConfig.Type) + } + + v := url.Values{} + v.Set("stdout", "1") + v.Set("stderr", "1") + + if *since != "" { + v.Set("since", timeutils.GetTimestamp(*since, time.Now())) + } + + if *times { + v.Set("timestamps", "1") + } + + if *follow { + v.Set("follow", "1") + } + v.Set("tail", *tail) + + sopts := &streamOpts{ + rawTerminal: c.Config.Tty, + out: cli.out, + err: cli.err, + } + + _, err = cli.stream("GET", "/containers/"+name+"/logs?"+v.Encode(), sopts) + return err +} diff --git a/api/client/network.go b/api/client/network.go new file mode 100644 index 0000000000..8cd72a884e --- /dev/null +++ b/api/client/network.go @@ -0,0 +1,381 @@ +package client + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "net" + "strings" + "text/tabwriter" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/daemon/network" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/stringid" +) + +// CmdNetwork is the parent subcommand for all network commands +// +// Usage: docker network [OPTIONS] +func (cli *DockerCli) CmdNetwork(args ...string) error { + cmd := Cli.Subcmd("network", []string{"COMMAND [OPTIONS]"}, networkUsage(), false) + cmd.Require(flag.Min, 1) + err := cmd.ParseFlags(args, true) + cmd.Usage() + return err +} + +// CmdNetworkCreate creates a new network with a given name +// +// Usage: docker network create [OPTIONS] +func (cli *DockerCli) CmdNetworkCreate(args ...string) error { + cmd := Cli.Subcmd("network create", []string{"NETWORK-NAME"}, "Creates a new network with a name specified by the user", false) + flDriver := cmd.String([]string{"d", "-driver"}, "bridge", "Driver to manage the Network") + flOpts := opts.NewMapOpts(nil, nil) + + flIpamDriver := cmd.String([]string{"-ipam-driver"}, "default", "IP Address Management Driver") + flIpamSubnet := opts.NewListOpts(nil) + flIpamIPRange := opts.NewListOpts(nil) + flIpamGateway := opts.NewListOpts(nil) + flIpamAux := opts.NewMapOpts(nil, nil) + + cmd.Var(&flIpamSubnet, []string{"-subnet"}, "subnet in CIDR format that represents a network segment") + cmd.Var(&flIpamIPRange, []string{"-ip-range"}, "allocate container ip from a sub-range") + cmd.Var(&flIpamGateway, []string{"-gateway"}, "ipv4 or ipv6 Gateway for the master subnet") + cmd.Var(flIpamAux, []string{"-aux-address"}, "auxiliary ipv4 or ipv6 addresses used by Network driver") + cmd.Var(flOpts, []string{"o", "-opt"}, "set driver specific options") + + cmd.Require(flag.Exact, 1) + err := cmd.ParseFlags(args, true) + if err != nil { + return err + } + + // Set the default driver to "" if the user didn't set the value. + // That way we can know whether it was user input or not. + driver := *flDriver + if !cmd.IsSet("-driver") && !cmd.IsSet("d") { + driver = "" + } + + ipamCfg, err := consolidateIpam(flIpamSubnet.GetAll(), flIpamIPRange.GetAll(), flIpamGateway.GetAll(), flIpamAux.GetAll()) + if err != nil { + return err + } + + // Construct network create request body + nc := types.NetworkCreate{ + Name: cmd.Arg(0), + Driver: driver, + IPAM: network.IPAM{Driver: *flIpamDriver, Config: ipamCfg}, + Options: flOpts.GetAll(), + CheckDuplicate: true, + } + obj, _, err := readBody(cli.call("POST", "/networks/create", nc, nil)) + if err != nil { + return err + } + var resp types.NetworkCreateResponse + err = json.Unmarshal(obj, &resp) + if err != nil { + return err + } + fmt.Fprintf(cli.out, "%s\n", resp.ID) + return nil +} + +// CmdNetworkRm deletes a network +// +// Usage: docker network rm +func (cli *DockerCli) CmdNetworkRm(args ...string) error { + cmd := Cli.Subcmd("network rm", []string{"NETWORK"}, "Deletes a network", false) + cmd.Require(flag.Exact, 1) + err := cmd.ParseFlags(args, true) + if err != nil { + return err + } + _, _, err = readBody(cli.call("DELETE", "/networks/"+cmd.Arg(0), nil, nil)) + if err != nil { + return err + } + return nil +} + +// CmdNetworkConnect connects a container to a network +// +// Usage: docker network connect +func (cli *DockerCli) CmdNetworkConnect(args ...string) error { + cmd := Cli.Subcmd("network connect", []string{"NETWORK CONTAINER"}, "Connects a container to a network", false) + cmd.Require(flag.Exact, 2) + err := cmd.ParseFlags(args, true) + if err != nil { + return err + } + + nc := types.NetworkConnect{Container: cmd.Arg(1)} + _, _, err = readBody(cli.call("POST", "/networks/"+cmd.Arg(0)+"/connect", nc, nil)) + return err +} + +// CmdNetworkDisconnect disconnects a container from a network +// +// Usage: docker network disconnect +func (cli *DockerCli) CmdNetworkDisconnect(args ...string) error { + cmd := Cli.Subcmd("network disconnect", []string{"NETWORK CONTAINER"}, "Disconnects container from a network", false) + cmd.Require(flag.Exact, 2) + err := cmd.ParseFlags(args, true) + if err != nil { + return err + } + + nc := types.NetworkConnect{Container: cmd.Arg(1)} + _, _, err = readBody(cli.call("POST", "/networks/"+cmd.Arg(0)+"/disconnect", nc, nil)) + return err +} + +// CmdNetworkLs lists all the netorks managed by docker daemon +// +// Usage: docker network ls [OPTIONS] +func (cli *DockerCli) CmdNetworkLs(args ...string) error { + cmd := Cli.Subcmd("network ls", nil, "Lists networks", true) + quiet := cmd.Bool([]string{"q", "-quiet"}, false, "Only display numeric IDs") + noTrunc := cmd.Bool([]string{"-no-trunc"}, false, "Do not truncate the output") + + cmd.Require(flag.Exact, 0) + err := cmd.ParseFlags(args, true) + + if err != nil { + return err + } + obj, _, err := readBody(cli.call("GET", "/networks", nil, nil)) + if err != nil { + return err + } + + var networkResources []types.NetworkResource + err = json.Unmarshal(obj, &networkResources) + if err != nil { + return err + } + + wr := tabwriter.NewWriter(cli.out, 20, 1, 3, ' ', 0) + + // unless quiet (-q) is specified, print field titles + if !*quiet { + fmt.Fprintln(wr, "NETWORK ID\tNAME\tDRIVER") + } + + for _, networkResource := range networkResources { + ID := networkResource.ID + netName := networkResource.Name + if !*noTrunc { + ID = stringid.TruncateID(ID) + } + if *quiet { + fmt.Fprintln(wr, ID) + continue + } + driver := networkResource.Driver + fmt.Fprintf(wr, "%s\t%s\t%s\t", + ID, + netName, + driver) + fmt.Fprint(wr, "\n") + } + wr.Flush() + return nil +} + +// CmdNetworkInspect inspects the network object for more details +// +// Usage: docker network inspect [OPTIONS] [NETWORK...] +func (cli *DockerCli) CmdNetworkInspect(args ...string) error { + cmd := Cli.Subcmd("network inspect", []string{"NETWORK [NETWORK...]"}, "Displays detailed information on a network", false) + cmd.Require(flag.Min, 1) + err := cmd.ParseFlags(args, true) + if err != nil { + return err + } + + status := 0 + var networks []*types.NetworkResource + for _, name := range cmd.Args() { + obj, _, err := readBody(cli.call("GET", "/networks/"+name, nil, nil)) + if err != nil { + if strings.Contains(err.Error(), "not found") { + fmt.Fprintf(cli.err, "Error: No such network: %s\n", name) + } else { + fmt.Fprintf(cli.err, "%s", err) + } + status = 1 + continue + } + networkResource := types.NetworkResource{} + if err := json.NewDecoder(bytes.NewReader(obj)).Decode(&networkResource); err != nil { + return err + } + + networks = append(networks, &networkResource) + } + + b, err := json.MarshalIndent(networks, "", " ") + if err != nil { + return err + } + + if _, err := io.Copy(cli.out, bytes.NewReader(b)); err != nil { + return err + } + io.WriteString(cli.out, "\n") + + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + return nil +} + +// Consolidates the ipam configuration as a group from differnt related configurations +// user can configure network with multiple non-overlapping subnets and hence it is +// possible to corelate the various related parameters and consolidate them. +// consoidateIpam consolidates subnets, ip-ranges, gateways and auxilary addresses into +// structured ipam data. +func consolidateIpam(subnets, ranges, gateways []string, auxaddrs map[string]string) ([]network.IPAMConfig, error) { + if len(subnets) < len(ranges) || len(subnets) < len(gateways) { + return nil, fmt.Errorf("every ip-range or gateway must have a corresponding subnet") + } + iData := map[string]*network.IPAMConfig{} + + // Populate non-overlapping subnets into consolidation map + for _, s := range subnets { + for k := range iData { + ok1, err := subnetMatches(s, k) + if err != nil { + return nil, err + } + ok2, err := subnetMatches(k, s) + if err != nil { + return nil, err + } + if ok1 || ok2 { + return nil, fmt.Errorf("multiple overlapping subnet configuration is not supported") + } + } + iData[s] = &network.IPAMConfig{Subnet: s, AuxAddress: map[string]string{}} + } + + // Validate and add valid ip ranges + for _, r := range ranges { + match := false + for _, s := range subnets { + ok, err := subnetMatches(s, r) + if err != nil { + return nil, err + } + if !ok { + continue + } + if iData[s].IPRange != "" { + return nil, fmt.Errorf("cannot configure multiple ranges (%s, %s) on the same subnet (%s)", r, iData[s].IPRange, s) + } + d := iData[s] + d.IPRange = r + match = true + } + if !match { + return nil, fmt.Errorf("no matching subnet for range %s", r) + } + } + + // Validate and add valid gateways + for _, g := range gateways { + match := false + for _, s := range subnets { + ok, err := subnetMatches(s, g) + if err != nil { + return nil, err + } + if !ok { + continue + } + if iData[s].Gateway != "" { + return nil, fmt.Errorf("cannot configure multiple gateways (%s, %s) for the same subnet (%s)", g, iData[s].Gateway, s) + } + d := iData[s] + d.Gateway = g + match = true + } + if !match { + return nil, fmt.Errorf("no matching subnet for gateway %s", g) + } + } + + // Validate and add aux-addresses + for key, aa := range auxaddrs { + match := false + for _, s := range subnets { + ok, err := subnetMatches(s, aa) + if err != nil { + return nil, err + } + if !ok { + continue + } + iData[s].AuxAddress[key] = aa + match = true + } + if !match { + return nil, fmt.Errorf("no matching subnet for aux-address %s", aa) + } + } + + idl := []network.IPAMConfig{} + for _, v := range iData { + idl = append(idl, *v) + } + return idl, nil +} + +func subnetMatches(subnet, data string) (bool, error) { + var ( + ip net.IP + ) + + _, s, err := net.ParseCIDR(subnet) + if err != nil { + return false, fmt.Errorf("Invalid subnet %s : %v", s, err) + } + + if strings.Contains(data, "/") { + ip, _, err = net.ParseCIDR(data) + if err != nil { + return false, fmt.Errorf("Invalid cidr %s : %v", data, err) + } + } else { + ip = net.ParseIP(data) + } + + return s.Contains(ip), nil +} + +func networkUsage() string { + networkCommands := map[string]string{ + "create": "Create a network", + "connect": "Connect container to a network", + "disconnect": "Disconnect container from a network", + "inspect": "Display detailed network information", + "ls": "List all networks", + "rm": "Remove a network", + } + + help := "Commands:\n" + + for cmd, description := range networkCommands { + help += fmt.Sprintf(" %-25.25s%s\n", cmd, description) + } + + help += fmt.Sprintf("\nRun 'docker network COMMAND --help' for more information on a command.") + return help +} diff --git a/api/client/pause.go b/api/client/pause.go new file mode 100644 index 0000000000..e144a0bd55 --- /dev/null +++ b/api/client/pause.go @@ -0,0 +1,32 @@ +package client + +import ( + "fmt" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdPause pauses all processes within one or more containers. +// +// Usage: docker pause CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdPause(args ...string) error { + cmd := Cli.Subcmd("pause", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["pause"].Description, true) + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var errNames []string + for _, name := range cmd.Args() { + if _, _, err := readBody(cli.call("POST", fmt.Sprintf("/containers/%s/pause", name), nil, nil)); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to pause containers: %v", errNames) + } + return nil +} diff --git a/api/client/port.go b/api/client/port.go new file mode 100644 index 0000000000..a981bc5e63 --- /dev/null +++ b/api/client/port.go @@ -0,0 +1,72 @@ +package client + +import ( + "encoding/json" + "fmt" + "strings" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/nat" +) + +// CmdPort lists port mappings for a container. +// If a private port is specified, it also shows the public-facing port that is NATed to the private port. +// +// Usage: docker port CONTAINER [PRIVATE_PORT[/PROTO]] +func (cli *DockerCli) CmdPort(args ...string) error { + cmd := Cli.Subcmd("port", []string{"CONTAINER [PRIVATE_PORT[/PROTO]]"}, Cli.DockerCommands["port"].Description, true) + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + serverResp, err := cli.call("GET", "/containers/"+cmd.Arg(0)+"/json", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + var c struct { + NetworkSettings struct { + Ports nat.PortMap + } + } + + if err := json.NewDecoder(serverResp.body).Decode(&c); err != nil { + return err + } + + if cmd.NArg() == 2 { + var ( + port = cmd.Arg(1) + proto = "tcp" + parts = strings.SplitN(port, "/", 2) + ) + + if len(parts) == 2 && len(parts[1]) != 0 { + port = parts[0] + proto = parts[1] + } + natPort := port + "/" + proto + newP, err := nat.NewPort(proto, port) + if err != nil { + return err + } + if frontends, exists := c.NetworkSettings.Ports[newP]; exists && frontends != nil { + for _, frontend := range frontends { + fmt.Fprintf(cli.out, "%s:%s\n", frontend.HostIP, frontend.HostPort) + } + return nil + } + return fmt.Errorf("Error: No public port '%s' published for %s", natPort, cmd.Arg(0)) + } + + for from, frontends := range c.NetworkSettings.Ports { + for _, frontend := range frontends { + fmt.Fprintf(cli.out, "%s -> %s:%s\n", from, frontend.HostIP, frontend.HostPort) + } + } + + return nil +} diff --git a/api/client/ps.go b/api/client/ps.go new file mode 100644 index 0000000000..50d76fbcb4 --- /dev/null +++ b/api/client/ps.go @@ -0,0 +1,116 @@ +package client + +import ( + "encoding/json" + "net/url" + "strconv" + + "github.com/docker/docker/api/client/ps" + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers/filters" +) + +// CmdPs outputs a list of Docker containers. +// +// Usage: docker ps [OPTIONS] +func (cli *DockerCli) CmdPs(args ...string) error { + var ( + err error + + psFilterArgs = filters.Args{} + v = url.Values{} + + cmd = Cli.Subcmd("ps", nil, Cli.DockerCommands["ps"].Description, true) + quiet = cmd.Bool([]string{"q", "-quiet"}, false, "Only display numeric IDs") + size = cmd.Bool([]string{"s", "-size"}, false, "Display total file sizes") + all = cmd.Bool([]string{"a", "-all"}, false, "Show all containers (default shows just running)") + noTrunc = cmd.Bool([]string{"#notrunc", "-no-trunc"}, false, "Don't truncate output") + nLatest = cmd.Bool([]string{"l", "-latest"}, false, "Show the latest created container, include non-running") + since = cmd.String([]string{"#sinceId", "#-since-id", "-since"}, "", "Show created since Id or Name, include non-running") + before = cmd.String([]string{"#beforeId", "#-before-id", "-before"}, "", "Show only container created before Id or Name") + last = cmd.Int([]string{"n"}, -1, "Show n last created containers, include non-running") + format = cmd.String([]string{"-format"}, "", "Pretty-print containers using a Go template") + flFilter = opts.NewListOpts(nil) + ) + cmd.Require(flag.Exact, 0) + + cmd.Var(&flFilter, []string{"f", "-filter"}, "Filter output based on conditions provided") + + cmd.ParseFlags(args, true) + if *last == -1 && *nLatest { + *last = 1 + } + + if *all { + v.Set("all", "1") + } + + if *last != -1 { + v.Set("limit", strconv.Itoa(*last)) + } + + if *since != "" { + v.Set("since", *since) + } + + if *before != "" { + v.Set("before", *before) + } + + if *size { + v.Set("size", "1") + } + + // Consolidate all filter flags, and sanity check them. + // They'll get processed in the daemon/server. + for _, f := range flFilter.GetAll() { + if psFilterArgs, err = filters.ParseFlag(f, psFilterArgs); err != nil { + return err + } + } + + if len(psFilterArgs) > 0 { + filterJSON, err := filters.ToParam(psFilterArgs) + if err != nil { + return err + } + + v.Set("filters", filterJSON) + } + + serverResp, err := cli.call("GET", "/containers/json?"+v.Encode(), nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + containers := []types.Container{} + if err := json.NewDecoder(serverResp.body).Decode(&containers); err != nil { + return err + } + + f := *format + if len(f) == 0 { + if len(cli.PsFormat()) > 0 && !*quiet { + f = cli.PsFormat() + } else { + f = "table" + } + } + + psCtx := ps.Context{ + Output: cli.out, + Format: f, + Quiet: *quiet, + Size: *size, + Trunc: !*noTrunc, + } + + ps.Format(psCtx, containers) + + return nil +} diff --git a/api/client/ps/custom.go b/api/client/ps/custom.go new file mode 100644 index 0000000000..1739fd12a6 --- /dev/null +++ b/api/client/ps/custom.go @@ -0,0 +1,160 @@ +package ps + +import ( + "fmt" + "strconv" + "strings" + "time" + + "github.com/docker/docker/api" + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/units" +) + +const ( + tableKey = "table" + + idHeader = "CONTAINER ID" + imageHeader = "IMAGE" + namesHeader = "NAMES" + commandHeader = "COMMAND" + createdAtHeader = "CREATED AT" + runningForHeader = "CREATED" + statusHeader = "STATUS" + portsHeader = "PORTS" + sizeHeader = "SIZE" + labelsHeader = "LABELS" +) + +type containerContext struct { + trunc bool + header []string + c types.Container +} + +func (c *containerContext) ID() string { + c.addHeader(idHeader) + if c.trunc { + return stringid.TruncateID(c.c.ID) + } + return c.c.ID +} + +func (c *containerContext) Names() string { + c.addHeader(namesHeader) + names := stripNamePrefix(c.c.Names) + if c.trunc { + for _, name := range names { + if len(strings.Split(name, "/")) == 1 { + names = []string{name} + break + } + } + } + return strings.Join(names, ",") +} + +func (c *containerContext) Image() string { + c.addHeader(imageHeader) + if c.c.Image == "" { + return "" + } + if c.trunc { + if stringid.TruncateID(c.c.ImageID) == stringid.TruncateID(c.c.Image) { + return stringutils.Truncate(c.c.Image, 12) + } + } + return c.c.Image +} + +func (c *containerContext) Command() string { + c.addHeader(commandHeader) + command := c.c.Command + if c.trunc { + command = stringutils.Truncate(command, 20) + } + return strconv.Quote(command) +} + +func (c *containerContext) CreatedAt() string { + c.addHeader(createdAtHeader) + return time.Unix(int64(c.c.Created), 0).String() +} + +func (c *containerContext) RunningFor() string { + c.addHeader(runningForHeader) + createdAt := time.Unix(int64(c.c.Created), 0) + return units.HumanDuration(time.Now().UTC().Sub(createdAt)) +} + +func (c *containerContext) Ports() string { + c.addHeader(portsHeader) + return api.DisplayablePorts(c.c.Ports) +} + +func (c *containerContext) Status() string { + c.addHeader(statusHeader) + return c.c.Status +} + +func (c *containerContext) Size() string { + c.addHeader(sizeHeader) + srw := units.HumanSize(float64(c.c.SizeRw)) + sv := units.HumanSize(float64(c.c.SizeRootFs)) + + sf := srw + if c.c.SizeRootFs > 0 { + sf = fmt.Sprintf("%s (virtual %s)", srw, sv) + } + return sf +} + +func (c *containerContext) Labels() string { + c.addHeader(labelsHeader) + if c.c.Labels == nil { + return "" + } + + var joinLabels []string + for k, v := range c.c.Labels { + joinLabels = append(joinLabels, fmt.Sprintf("%s=%s", k, v)) + } + return strings.Join(joinLabels, ",") +} + +func (c *containerContext) Label(name string) string { + n := strings.Split(name, ".") + r := strings.NewReplacer("-", " ", "_", " ") + h := r.Replace(n[len(n)-1]) + + c.addHeader(h) + + if c.c.Labels == nil { + return "" + } + return c.c.Labels[name] +} + +func (c *containerContext) fullHeader() string { + if c.header == nil { + return "" + } + return strings.Join(c.header, "\t") +} + +func (c *containerContext) addHeader(header string) { + if c.header == nil { + c.header = []string{} + } + c.header = append(c.header, strings.ToUpper(header)) +} + +func stripNamePrefix(ss []string) []string { + for i, s := range ss { + ss[i] = s[1:] + } + + return ss +} diff --git a/api/client/ps/custom_test.go b/api/client/ps/custom_test.go new file mode 100644 index 0000000000..c0b2eb2e1c --- /dev/null +++ b/api/client/ps/custom_test.go @@ -0,0 +1,126 @@ +package ps + +import ( + "reflect" + "strings" + "testing" + "time" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/stringid" +) + +func TestContainerPsContext(t *testing.T) { + containerID := stringid.GenerateRandomID() + unix := time.Now().Unix() + + var ctx containerContext + cases := []struct { + container types.Container + trunc bool + expValue string + expHeader string + call func() string + }{ + {types.Container{ID: containerID}, true, stringid.TruncateID(containerID), idHeader, ctx.ID}, + {types.Container{ID: containerID}, false, containerID, idHeader, ctx.ID}, + {types.Container{Names: []string{"/foobar_baz"}}, true, "foobar_baz", namesHeader, ctx.Names}, + {types.Container{Image: "ubuntu"}, true, "ubuntu", imageHeader, ctx.Image}, + {types.Container{Image: "verylongimagename"}, true, "verylongimagename", imageHeader, ctx.Image}, + {types.Container{Image: "verylongimagename"}, false, "verylongimagename", imageHeader, ctx.Image}, + {types.Container{ + Image: "a5a665ff33eced1e0803148700880edab4", + ImageID: "a5a665ff33eced1e0803148700880edab4269067ed77e27737a708d0d293fbf5", + }, + true, + "a5a665ff33ec", + imageHeader, + ctx.Image, + }, + {types.Container{ + Image: "a5a665ff33eced1e0803148700880edab4", + ImageID: "a5a665ff33eced1e0803148700880edab4269067ed77e27737a708d0d293fbf5", + }, + false, + "a5a665ff33eced1e0803148700880edab4", + imageHeader, + ctx.Image, + }, + {types.Container{Image: ""}, true, "", imageHeader, ctx.Image}, + {types.Container{Command: "sh -c 'ls -la'"}, true, `"sh -c 'ls -la'"`, commandHeader, ctx.Command}, + {types.Container{Created: unix}, true, time.Unix(unix, 0).String(), createdAtHeader, ctx.CreatedAt}, + {types.Container{Ports: []types.Port{{PrivatePort: 8080, PublicPort: 8080, Type: "tcp"}}}, true, "8080/tcp", portsHeader, ctx.Ports}, + {types.Container{Status: "RUNNING"}, true, "RUNNING", statusHeader, ctx.Status}, + {types.Container{SizeRw: 10}, true, "10 B", sizeHeader, ctx.Size}, + {types.Container{SizeRw: 10, SizeRootFs: 20}, true, "10 B (virtual 20 B)", sizeHeader, ctx.Size}, + {types.Container{}, true, "", labelsHeader, ctx.Labels}, + {types.Container{Labels: map[string]string{"cpu": "6", "storage": "ssd"}}, true, "cpu=6,storage=ssd", labelsHeader, ctx.Labels}, + {types.Container{Created: unix}, true, "Less than a second", runningForHeader, ctx.RunningFor}, + } + + for _, c := range cases { + ctx = containerContext{c: c.container, trunc: c.trunc} + v := c.call() + if strings.Contains(v, ",") { + // comma-separated values means probably a map input, which won't + // be guaranteed to have the same order as our expected value + // We'll create maps and use reflect.DeepEquals to check instead: + entriesMap := make(map[string]string) + expMap := make(map[string]string) + entries := strings.Split(v, ",") + expectedEntries := strings.Split(c.expValue, ",") + for _, entry := range entries { + keyval := strings.Split(entry, "=") + entriesMap[keyval[0]] = keyval[1] + } + for _, expected := range expectedEntries { + keyval := strings.Split(expected, "=") + expMap[keyval[0]] = keyval[1] + } + if !reflect.DeepEqual(expMap, entriesMap) { + t.Fatalf("Expected entries: %v, got: %v", c.expValue, v) + } + } else if v != c.expValue { + t.Fatalf("Expected %s, was %s\n", c.expValue, v) + } + + h := ctx.fullHeader() + if h != c.expHeader { + t.Fatalf("Expected %s, was %s\n", c.expHeader, h) + } + } + + c1 := types.Container{Labels: map[string]string{"com.docker.swarm.swarm-id": "33", "com.docker.swarm.node_name": "ubuntu"}} + ctx = containerContext{c: c1, trunc: true} + + sid := ctx.Label("com.docker.swarm.swarm-id") + node := ctx.Label("com.docker.swarm.node_name") + if sid != "33" { + t.Fatalf("Expected 33, was %s\n", sid) + } + + if node != "ubuntu" { + t.Fatalf("Expected ubuntu, was %s\n", node) + } + + h := ctx.fullHeader() + if h != "SWARM ID\tNODE NAME" { + t.Fatalf("Expected %s, was %s\n", "SWARM ID\tNODE NAME", h) + + } + + c2 := types.Container{} + ctx = containerContext{c: c2, trunc: true} + + label := ctx.Label("anything.really") + if label != "" { + t.Fatalf("Expected an empty string, was %s", label) + } + + ctx = containerContext{c: c2, trunc: true} + fullHeader := ctx.fullHeader() + if fullHeader != "" { + t.Fatalf("Expected fullHeader to be empty, was %s", fullHeader) + } + +} diff --git a/api/client/ps/formatter.go b/api/client/ps/formatter.go new file mode 100644 index 0000000000..2a45bfcf56 --- /dev/null +++ b/api/client/ps/formatter.go @@ -0,0 +1,140 @@ +package ps + +import ( + "bytes" + "fmt" + "io" + "strings" + "text/tabwriter" + "text/template" + + "github.com/docker/docker/api/types" +) + +const ( + tableFormatKey = "table" + rawFormatKey = "raw" + + defaultTableFormat = "table {{.ID}}\t{{.Image}}\t{{.Command}}\t{{.RunningFor}} ago\t{{.Status}}\t{{.Ports}}\t{{.Names}}" + defaultQuietFormat = "{{.ID}}" +) + +// Context contains information required by the formatter to print the output as desired. +type Context struct { + // Output is the output stream to which the formatted string is written. + Output io.Writer + // Format is used to choose raw, table or custom format for the output. + Format string + // Size when set to true will display the size of the output. + Size bool + // Quiet when set to true will simply print minimal information. + Quiet bool + // Trunc when set to true will truncate the output of certain fields such as Container ID. + Trunc bool +} + +// Format helps to format the output using the parameters set in the Context. +// Currently Format allow to display in raw, table or custom format the output. +func Format(ctx Context, containers []types.Container) { + switch ctx.Format { + case tableFormatKey: + tableFormat(ctx, containers) + case rawFormatKey: + rawFormat(ctx, containers) + default: + customFormat(ctx, containers) + } +} + +func rawFormat(ctx Context, containers []types.Container) { + if ctx.Quiet { + ctx.Format = `container_id: {{.ID}}` + } else { + ctx.Format = `container_id: {{.ID}} +image: {{.Image}} +command: {{.Command}} +created_at: {{.CreatedAt}} +status: {{.Status}} +names: {{.Names}} +labels: {{.Labels}} +ports: {{.Ports}} +` + if ctx.Size { + ctx.Format += `size: {{.Size}} +` + } + } + + customFormat(ctx, containers) +} + +func tableFormat(ctx Context, containers []types.Container) { + ctx.Format = defaultTableFormat + if ctx.Quiet { + ctx.Format = defaultQuietFormat + } + + customFormat(ctx, containers) +} + +func customFormat(ctx Context, containers []types.Container) { + var ( + table bool + header string + format = ctx.Format + buffer = bytes.NewBufferString("") + ) + + if strings.HasPrefix(ctx.Format, tableKey) { + table = true + format = format[len(tableKey):] + } + + format = strings.Trim(format, " ") + r := strings.NewReplacer(`\t`, "\t", `\n`, "\n") + format = r.Replace(format) + + if table && ctx.Size { + format += "\t{{.Size}}" + } + + tmpl, err := template.New("").Parse(format) + if err != nil { + buffer.WriteString(fmt.Sprintf("Template parsing error: %v\n", err)) + buffer.WriteTo(ctx.Output) + return + } + + for _, container := range containers { + containerCtx := &containerContext{ + trunc: ctx.Trunc, + c: container, + } + if err := tmpl.Execute(buffer, containerCtx); err != nil { + buffer = bytes.NewBufferString(fmt.Sprintf("Template parsing error: %v\n", err)) + buffer.WriteTo(ctx.Output) + return + } + if table && len(header) == 0 { + header = containerCtx.fullHeader() + } + buffer.WriteString("\n") + } + + if table { + if len(header) == 0 { + // if we still don't have a header, we didn't have any containers so we need to fake it to get the right headers from the template + containerCtx := &containerContext{} + tmpl.Execute(bytes.NewBufferString(""), containerCtx) + header = containerCtx.fullHeader() + } + + t := tabwriter.NewWriter(ctx.Output, 20, 1, 3, ' ', 0) + t.Write([]byte(header)) + t.Write([]byte("\n")) + buffer.WriteTo(t) + t.Flush() + } else { + buffer.WriteTo(ctx.Output) + } +} diff --git a/api/client/ps/formatter_test.go b/api/client/ps/formatter_test.go new file mode 100644 index 0000000000..6e7304c367 --- /dev/null +++ b/api/client/ps/formatter_test.go @@ -0,0 +1,208 @@ +package ps + +import ( + "bytes" + "testing" + + "github.com/docker/docker/api/types" +) + +func TestFormat(t *testing.T) { + contexts := []struct { + context Context + expected string + }{ + // Errors + { + Context{ + Format: "{{InvalidFunction}}", + }, + `Template parsing error: template: :1: function "InvalidFunction" not defined +`, + }, + { + Context{ + Format: "{{nil}}", + }, + `Template parsing error: template: :1:2: executing "" at : nil is not a command +`, + }, + // Table Format + { + Context{ + Format: "table", + }, + `CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES +containerID1 ubuntu "" 45 years ago foobar_baz +containerID2 ubuntu "" 45 years ago foobar_bar +`, + }, + { + Context{ + Format: "table {{.Image}}", + }, + "IMAGE\nubuntu\nubuntu\n", + }, + { + Context{ + Format: "table {{.Image}}", + Size: true, + }, + "IMAGE SIZE\nubuntu 0 B\nubuntu 0 B\n", + }, + { + Context{ + Format: "table {{.Image}}", + Quiet: true, + }, + "IMAGE\nubuntu\nubuntu\n", + }, + { + Context{ + Format: "table", + Quiet: true, + }, + "containerID1\ncontainerID2\n", + }, + // Raw Format + { + Context{ + Format: "raw", + }, + `container_id: containerID1 +image: ubuntu +command: "" +created_at: 1970-01-01 00:00:00 +0000 UTC +status: +names: foobar_baz +labels: +ports: + +container_id: containerID2 +image: ubuntu +command: "" +created_at: 1970-01-01 00:00:00 +0000 UTC +status: +names: foobar_bar +labels: +ports: + +`, + }, + { + Context{ + Format: "raw", + Size: true, + }, + `container_id: containerID1 +image: ubuntu +command: "" +created_at: 1970-01-01 00:00:00 +0000 UTC +status: +names: foobar_baz +labels: +ports: +size: 0 B + +container_id: containerID2 +image: ubuntu +command: "" +created_at: 1970-01-01 00:00:00 +0000 UTC +status: +names: foobar_bar +labels: +ports: +size: 0 B + +`, + }, + { + Context{ + Format: "raw", + Quiet: true, + }, + "container_id: containerID1\ncontainer_id: containerID2\n", + }, + // Custom Format + { + Context{ + Format: "{{.Image}}", + }, + "ubuntu\nubuntu\n", + }, + { + Context{ + Format: "{{.Image}}", + Size: true, + }, + "ubuntu\nubuntu\n", + }, + } + + for _, context := range contexts { + containers := []types.Container{ + {ID: "containerID1", Names: []string{"/foobar_baz"}, Image: "ubuntu"}, + {ID: "containerID2", Names: []string{"/foobar_bar"}, Image: "ubuntu"}, + } + out := bytes.NewBufferString("") + context.context.Output = out + Format(context.context, containers) + actual := out.String() + if actual != context.expected { + t.Fatalf("Expected \n%s, got \n%s", context.expected, actual) + } + // Clean buffer + out.Reset() + } +} + +func TestCustomFormatNoContainers(t *testing.T) { + out := bytes.NewBufferString("") + containers := []types.Container{} + + contexts := []struct { + context Context + expected string + }{ + { + Context{ + Format: "{{.Image}}", + Output: out, + }, + "", + }, + { + Context{ + Format: "table {{.Image}}", + Output: out, + }, + "IMAGE\n", + }, + { + Context{ + Format: "{{.Image}}", + Output: out, + Size: true, + }, + "", + }, + { + Context{ + Format: "table {{.Image}}", + Output: out, + Size: true, + }, + "IMAGE SIZE\n", + }, + } + + for _, context := range contexts { + customFormat(context.context, containers) + actual := out.String() + if actual != context.expected { + t.Fatalf("Expected \n%s, got \n%s", context.expected, actual) + } + // Clean buffer + out.Reset() + } +} diff --git a/api/client/pull.go b/api/client/pull.go new file mode 100644 index 0000000000..dcb2ecb0c7 --- /dev/null +++ b/api/client/pull.go @@ -0,0 +1,53 @@ +package client + +import ( + "fmt" + "net/url" + + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/graph/tags" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/registry" +) + +// CmdPull pulls an image or a repository from the registry. +// +// Usage: docker pull [OPTIONS] IMAGENAME[:TAG|@DIGEST] +func (cli *DockerCli) CmdPull(args ...string) error { + cmd := Cli.Subcmd("pull", []string{"NAME[:TAG|@DIGEST]"}, Cli.DockerCommands["pull"].Description, true) + allTags := cmd.Bool([]string{"a", "-all-tags"}, false, "Download all tagged images in the repository") + addTrustedFlags(cmd, true) + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + remote := cmd.Arg(0) + + taglessRemote, tag := parsers.ParseRepositoryTag(remote) + if tag == "" && !*allTags { + tag = tags.DefaultTag + fmt.Fprintf(cli.out, "Using default tag: %s\n", tag) + } else if tag != "" && *allTags { + return fmt.Errorf("tag can't be used with --all-tags/-a") + } + + ref := registry.ParseReference(tag) + + // Resolve the Repository name from fqn to RepositoryInfo + repoInfo, err := registry.ParseRepositoryInfo(taglessRemote) + if err != nil { + return err + } + + if isTrusted() && !ref.HasDigest() { + // Check if tag is digest + authConfig := registry.ResolveAuthConfig(cli.configFile, repoInfo.Index) + return cli.trustedPull(repoInfo, ref, authConfig) + } + + v := url.Values{} + v.Set("fromImage", ref.ImageName(taglessRemote)) + + _, _, err = cli.clientRequestAttemptLogin("POST", "/images/create?"+v.Encode(), nil, cli.out, repoInfo.Index, "pull") + return err +} diff --git a/api/client/push.go b/api/client/push.go new file mode 100644 index 0000000000..0c8823f051 --- /dev/null +++ b/api/client/push.go @@ -0,0 +1,53 @@ +package client + +import ( + "fmt" + "net/url" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/registry" +) + +// CmdPush pushes an image or repository to the registry. +// +// Usage: docker push NAME[:TAG] +func (cli *DockerCli) CmdPush(args ...string) error { + cmd := Cli.Subcmd("push", []string{"NAME[:TAG]"}, Cli.DockerCommands["push"].Description, true) + addTrustedFlags(cmd, false) + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + remote, tag := parsers.ParseRepositoryTag(cmd.Arg(0)) + + // Resolve the Repository name from fqn to RepositoryInfo + repoInfo, err := registry.ParseRepositoryInfo(remote) + if err != nil { + return err + } + // Resolve the Auth config relevant for this server + authConfig := registry.ResolveAuthConfig(cli.configFile, repoInfo.Index) + // If we're not using a custom registry, we know the restrictions + // applied to repository names and can warn the user in advance. + // Custom repositories can have different rules, and we must also + // allow pushing by image ID. + if repoInfo.Official { + username := authConfig.Username + if username == "" { + username = "" + } + return fmt.Errorf("You cannot push a \"root\" repository. Please rename your repository to / (ex: %s/%s)", username, repoInfo.LocalName) + } + + if isTrusted() { + return cli.trustedPush(repoInfo, tag, authConfig) + } + + v := url.Values{} + v.Set("tag", tag) + + _, _, err = cli.clientRequestAttemptLogin("POST", "/images/"+remote+"/push?"+v.Encode(), nil, cli.out, repoInfo.Index, "push") + return err +} diff --git a/api/client/rename.go b/api/client/rename.go new file mode 100644 index 0000000000..124ee1fc4c --- /dev/null +++ b/api/client/rename.go @@ -0,0 +1,32 @@ +package client + +import ( + "fmt" + "strings" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdRename renames a container. +// +// Usage: docker rename OLD_NAME NEW_NAME +func (cli *DockerCli) CmdRename(args ...string) error { + cmd := Cli.Subcmd("rename", []string{"OLD_NAME NEW_NAME"}, Cli.DockerCommands["rename"].Description, true) + cmd.Require(flag.Exact, 2) + + cmd.ParseFlags(args, true) + + oldName := strings.TrimSpace(cmd.Arg(0)) + newName := strings.TrimSpace(cmd.Arg(1)) + + if oldName == "" || newName == "" { + return fmt.Errorf("Error: Neither old nor new names may be empty") + } + + if _, _, err := readBody(cli.call("POST", fmt.Sprintf("/containers/%s/rename?name=%s", oldName, newName), nil, nil)); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + return fmt.Errorf("Error: failed to rename container named %s", oldName) + } + return nil +} diff --git a/api/client/restart.go b/api/client/restart.go new file mode 100644 index 0000000000..92c612926e --- /dev/null +++ b/api/client/restart.go @@ -0,0 +1,39 @@ +package client + +import ( + "fmt" + "net/url" + "strconv" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdRestart restarts one or more containers. +// +// Usage: docker restart [OPTIONS] CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdRestart(args ...string) error { + cmd := Cli.Subcmd("restart", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["restart"].Description, true) + nSeconds := cmd.Int([]string{"t", "-time"}, 10, "Seconds to wait for stop before killing the container") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + v := url.Values{} + v.Set("t", strconv.Itoa(*nSeconds)) + + var errNames []string + for _, name := range cmd.Args() { + _, _, err := readBody(cli.call("POST", "/containers/"+name+"/restart?"+v.Encode(), nil, nil)) + if err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to restart containers: %v", errNames) + } + return nil +} diff --git a/api/client/rm.go b/api/client/rm.go new file mode 100644 index 0000000000..9f49a2fd46 --- /dev/null +++ b/api/client/rm.go @@ -0,0 +1,55 @@ +package client + +import ( + "fmt" + "net/url" + "strings" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdRm removes one or more containers. +// +// Usage: docker rm [OPTIONS] CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdRm(args ...string) error { + cmd := Cli.Subcmd("rm", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["rm"].Description, true) + v := cmd.Bool([]string{"v", "-volumes"}, false, "Remove the volumes associated with the container") + link := cmd.Bool([]string{"l", "#link", "-link"}, false, "Remove the specified link") + force := cmd.Bool([]string{"f", "-force"}, false, "Force the removal of a running container (uses SIGKILL)") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + val := url.Values{} + if *v { + val.Set("v", "1") + } + if *link { + val.Set("link", "1") + } + + if *force { + val.Set("force", "1") + } + + var errNames []string + for _, name := range cmd.Args() { + if name == "" { + return fmt.Errorf("Container name cannot be empty") + } + name = strings.Trim(name, "/") + + _, _, err := readBody(cli.call("DELETE", "/containers/"+name+"?"+val.Encode(), nil, nil)) + if err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to remove containers: %v", errNames) + } + return nil +} diff --git a/api/client/rmi.go b/api/client/rmi.go new file mode 100644 index 0000000000..b4e3700684 --- /dev/null +++ b/api/client/rmi.go @@ -0,0 +1,61 @@ +package client + +import ( + "encoding/json" + "fmt" + "net/url" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdRmi removes all images with the specified name(s). +// +// Usage: docker rmi [OPTIONS] IMAGE [IMAGE...] +func (cli *DockerCli) CmdRmi(args ...string) error { + cmd := Cli.Subcmd("rmi", []string{"IMAGE [IMAGE...]"}, Cli.DockerCommands["rmi"].Description, true) + force := cmd.Bool([]string{"f", "-force"}, false, "Force removal of the image") + noprune := cmd.Bool([]string{"-no-prune"}, false, "Do not delete untagged parents") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + v := url.Values{} + if *force { + v.Set("force", "1") + } + if *noprune { + v.Set("noprune", "1") + } + + var errNames []string + for _, name := range cmd.Args() { + serverResp, err := cli.call("DELETE", "/images/"+name+"?"+v.Encode(), nil, nil) + if err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + defer serverResp.body.Close() + + dels := []types.ImageDelete{} + if err := json.NewDecoder(serverResp.body).Decode(&dels); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + continue + } + + for _, del := range dels { + if del.Deleted != "" { + fmt.Fprintf(cli.out, "Deleted: %s\n", del.Deleted) + } else { + fmt.Fprintf(cli.out, "Untagged: %s\n", del.Untagged) + } + } + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to remove images: %v", errNames) + } + return nil +} diff --git a/api/client/run.go b/api/client/run.go new file mode 100644 index 0000000000..260d187cbb --- /dev/null +++ b/api/client/run.go @@ -0,0 +1,257 @@ +package client + +import ( + "fmt" + "io" + "net/url" + "os" + "runtime" + + "github.com/Sirupsen/logrus" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + "github.com/docker/docker/pkg/promise" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/runconfig" + "github.com/docker/libnetwork/resolvconf/dns" +) + +func (cid *cidFile) Close() error { + cid.file.Close() + + if !cid.written { + if err := os.Remove(cid.path); err != nil { + return fmt.Errorf("failed to remove the CID file '%s': %s \n", cid.path, err) + } + } + + return nil +} + +func (cid *cidFile) Write(id string) error { + if _, err := cid.file.Write([]byte(id)); err != nil { + return fmt.Errorf("Failed to write the container ID to the file: %s", err) + } + cid.written = true + return nil +} + +// CmdRun runs a command in a new container. +// +// Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...] +func (cli *DockerCli) CmdRun(args ...string) error { + cmd := Cli.Subcmd("run", []string{"IMAGE [COMMAND] [ARG...]"}, Cli.DockerCommands["run"].Description, true) + addTrustedFlags(cmd, true) + + // These are flags not stored in Config/HostConfig + var ( + flAutoRemove = cmd.Bool([]string{"-rm"}, false, "Automatically remove the container when it exits") + flDetach = cmd.Bool([]string{"d", "-detach"}, false, "Run container in background and print container ID") + flSigProxy = cmd.Bool([]string{"-sig-proxy"}, true, "Proxy received signals to the process") + flName = cmd.String([]string{"-name"}, "", "Assign a name to the container") + flAttach *opts.ListOpts + + ErrConflictAttachDetach = fmt.Errorf("Conflicting options: -a and -d") + ErrConflictRestartPolicyAndAutoRemove = fmt.Errorf("Conflicting options: --restart and --rm") + ErrConflictDetachAutoRemove = fmt.Errorf("Conflicting options: --rm and -d") + ) + + config, hostConfig, cmd, err := runconfig.Parse(cmd, args) + // just in case the Parse does not exit + if err != nil { + cmd.ReportError(err.Error(), true) + os.Exit(1) + } + + if len(hostConfig.DNS) > 0 { + // check the DNS settings passed via --dns against + // localhost regexp to warn if they are trying to + // set a DNS to a localhost address + for _, dnsIP := range hostConfig.DNS { + if dns.IsLocalhost(dnsIP) { + fmt.Fprintf(cli.err, "WARNING: Localhost DNS setting (--dns=%s) may fail in containers.\n", dnsIP) + break + } + } + } + if config.Image == "" { + cmd.Usage() + return nil + } + + if !*flDetach { + if err := cli.CheckTtyInput(config.AttachStdin, config.Tty); err != nil { + return err + } + } else { + if fl := cmd.Lookup("-attach"); fl != nil { + flAttach = fl.Value.(*opts.ListOpts) + if flAttach.Len() != 0 { + return ErrConflictAttachDetach + } + } + if *flAutoRemove { + return ErrConflictDetachAutoRemove + } + + config.AttachStdin = false + config.AttachStdout = false + config.AttachStderr = false + config.StdinOnce = false + } + + // Disable flSigProxy when in TTY mode + sigProxy := *flSigProxy + if config.Tty { + sigProxy = false + } + + // Telling the Windows daemon the initial size of the tty during start makes + // a far better user experience rather than relying on subsequent resizes + // to cause things to catch up. + if runtime.GOOS == "windows" { + hostConfig.ConsoleSize[0], hostConfig.ConsoleSize[1] = cli.getTtySize() + } + + createResponse, err := cli.createContainer(config, hostConfig, hostConfig.ContainerIDFile, *flName) + if err != nil { + return err + } + if sigProxy { + sigc := cli.forwardAllSignals(createResponse.ID) + defer signal.StopCatch(sigc) + } + var ( + waitDisplayID chan struct{} + errCh chan error + ) + if !config.AttachStdout && !config.AttachStderr { + // Make this asynchronous to allow the client to write to stdin before having to read the ID + waitDisplayID = make(chan struct{}) + go func() { + defer close(waitDisplayID) + fmt.Fprintf(cli.out, "%s\n", createResponse.ID) + }() + } + if *flAutoRemove && (hostConfig.RestartPolicy.IsAlways() || hostConfig.RestartPolicy.IsOnFailure()) { + return ErrConflictRestartPolicyAndAutoRemove + } + // We need to instantiate the chan because the select needs it. It can + // be closed but can't be uninitialized. + hijacked := make(chan io.Closer) + // Block the return until the chan gets closed + defer func() { + logrus.Debugf("End of CmdRun(), Waiting for hijack to finish.") + if _, ok := <-hijacked; ok { + fmt.Fprintln(cli.err, "Hijack did not finish (chan still open)") + } + }() + if config.AttachStdin || config.AttachStdout || config.AttachStderr { + var ( + out, stderr io.Writer + in io.ReadCloser + v = url.Values{} + ) + v.Set("stream", "1") + if config.AttachStdin { + v.Set("stdin", "1") + in = cli.in + } + if config.AttachStdout { + v.Set("stdout", "1") + out = cli.out + } + if config.AttachStderr { + v.Set("stderr", "1") + if config.Tty { + stderr = cli.out + } else { + stderr = cli.err + } + } + errCh = promise.Go(func() error { + return cli.hijack("POST", "/containers/"+createResponse.ID+"/attach?"+v.Encode(), config.Tty, in, out, stderr, hijacked, nil) + }) + } else { + close(hijacked) + } + // Acknowledge the hijack before starting + select { + case closer := <-hijacked: + // Make sure that the hijack gets closed when returning (results + // in closing the hijack chan and freeing server's goroutines) + if closer != nil { + defer closer.Close() + } + case err := <-errCh: + if err != nil { + logrus.Debugf("Error hijack: %s", err) + return err + } + } + + defer func() { + if *flAutoRemove { + if _, _, err = readBody(cli.call("DELETE", "/containers/"+createResponse.ID+"?v=1", nil, nil)); err != nil { + fmt.Fprintf(cli.err, "Error deleting container: %s\n", err) + } + } + }() + + //start the container + if _, _, err = readBody(cli.call("POST", "/containers/"+createResponse.ID+"/start", nil, nil)); err != nil { + return err + } + + if (config.AttachStdin || config.AttachStdout || config.AttachStderr) && config.Tty && cli.isTerminalOut { + if err := cli.monitorTtySize(createResponse.ID, false); err != nil { + fmt.Fprintf(cli.err, "Error monitoring TTY size: %s\n", err) + } + } + + if errCh != nil { + if err := <-errCh; err != nil { + logrus.Debugf("Error hijack: %s", err) + return err + } + } + + // Detached mode: wait for the id to be displayed and return. + if !config.AttachStdout && !config.AttachStderr { + // Detached mode + <-waitDisplayID + return nil + } + + var status int + + // Attached mode + if *flAutoRemove { + // Autoremove: wait for the container to finish, retrieve + // the exit code and remove the container + if _, _, err := readBody(cli.call("POST", "/containers/"+createResponse.ID+"/wait", nil, nil)); err != nil { + return err + } + if _, status, err = getExitCode(cli, createResponse.ID); err != nil { + return err + } + } else { + // No Autoremove: Simply retrieve the exit code + if !config.Tty { + // In non-TTY mode, we can't detach, so we must wait for container exit + if status, err = waitForExit(cli, createResponse.ID); err != nil { + return err + } + } else { + // In TTY mode, there is a race: if the process dies too slowly, the state could + // be updated after the getExitCode call and result in the wrong exit code being reported + if _, status, err = getExitCode(cli, createResponse.ID); err != nil { + return err + } + } + } + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + return nil +} diff --git a/api/client/save.go b/api/client/save.go new file mode 100644 index 0000000000..f14f9a450c --- /dev/null +++ b/api/client/save.go @@ -0,0 +1,52 @@ +package client + +import ( + "errors" + "net/url" + "os" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdSave saves one or more images to a tar archive. +// +// The tar archive is written to STDOUT by default, or written to a file. +// +// Usage: docker save [OPTIONS] IMAGE [IMAGE...] +func (cli *DockerCli) CmdSave(args ...string) error { + cmd := Cli.Subcmd("save", []string{"IMAGE [IMAGE...]"}, Cli.DockerCommands["save"].Description+" (streamed to STDOUT by default)", true) + outfile := cmd.String([]string{"o", "-output"}, "", "Write to a file, instead of STDOUT") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var ( + output = cli.out + err error + ) + + if *outfile == "" && cli.isTerminalOut { + return errors.New("Cowardly refusing to save to a terminal. Use the -o flag or redirect.") + } + if *outfile != "" { + if output, err = os.Create(*outfile); err != nil { + return err + } + } + + sopts := &streamOpts{ + rawTerminal: true, + out: output, + } + + v := url.Values{} + for _, arg := range cmd.Args() { + v.Add("names", arg) + } + if _, err := cli.stream("GET", "/images/get?"+v.Encode(), sopts); err != nil { + return err + } + + return nil +} diff --git a/api/client/search.go b/api/client/search.go new file mode 100644 index 0000000000..bf120cddc7 --- /dev/null +++ b/api/client/search.go @@ -0,0 +1,88 @@ +package client + +import ( + "encoding/json" + "fmt" + "net/url" + "sort" + "strings" + "text/tabwriter" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/registry" +) + +// ByStars sorts search results in ascending order by number of stars. +type ByStars []registry.SearchResult + +func (r ByStars) Len() int { return len(r) } +func (r ByStars) Swap(i, j int) { r[i], r[j] = r[j], r[i] } +func (r ByStars) Less(i, j int) bool { return r[i].StarCount < r[j].StarCount } + +// CmdSearch searches the Docker Hub for images. +// +// Usage: docker search [OPTIONS] TERM +func (cli *DockerCli) CmdSearch(args ...string) error { + cmd := Cli.Subcmd("search", []string{"TERM"}, Cli.DockerCommands["search"].Description, true) + noTrunc := cmd.Bool([]string{"#notrunc", "-no-trunc"}, false, "Don't truncate output") + trusted := cmd.Bool([]string{"#t", "#trusted", "#-trusted"}, false, "Only show trusted builds") + automated := cmd.Bool([]string{"-automated"}, false, "Only show automated builds") + stars := cmd.Uint([]string{"s", "#stars", "-stars"}, 0, "Only displays with at least x stars") + cmd.Require(flag.Exact, 1) + + cmd.ParseFlags(args, true) + + name := cmd.Arg(0) + v := url.Values{} + v.Set("term", name) + + // Resolve the Repository name from fqn to hostname + name + taglessRemote, _ := parsers.ParseRepositoryTag(name) + + indexInfo, err := registry.ParseIndexInfo(taglessRemote) + if err != nil { + return err + } + + rdr, _, err := cli.clientRequestAttemptLogin("GET", "/images/search?"+v.Encode(), nil, nil, indexInfo, "search") + if err != nil { + return err + } + + defer rdr.Close() + + results := ByStars{} + if err := json.NewDecoder(rdr).Decode(&results); err != nil { + return err + } + + sort.Sort(sort.Reverse(results)) + + w := tabwriter.NewWriter(cli.out, 10, 1, 3, ' ', 0) + fmt.Fprintf(w, "NAME\tDESCRIPTION\tSTARS\tOFFICIAL\tAUTOMATED\n") + for _, res := range results { + if (*automated && !res.IsAutomated) || (int(*stars) > res.StarCount) || (*trusted && !res.IsTrusted) { + continue + } + desc := strings.Replace(res.Description, "\n", " ", -1) + desc = strings.Replace(desc, "\r", " ", -1) + if !*noTrunc && len(desc) > 45 { + desc = stringutils.Truncate(desc, 42) + "..." + } + fmt.Fprintf(w, "%s\t%s\t%d\t", res.Name, desc, res.StarCount) + if res.IsOfficial { + fmt.Fprint(w, "[OK]") + + } + fmt.Fprint(w, "\t") + if res.IsAutomated || res.IsTrusted { + fmt.Fprint(w, "[OK]") + } + fmt.Fprint(w, "\n") + } + w.Flush() + return nil +} diff --git a/api/client/start.go b/api/client/start.go new file mode 100644 index 0000000000..bff9c30ec8 --- /dev/null +++ b/api/client/start.go @@ -0,0 +1,171 @@ +package client + +import ( + "encoding/json" + "fmt" + "io" + "net/url" + "os" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/promise" + "github.com/docker/docker/pkg/signal" +) + +func (cli *DockerCli) forwardAllSignals(cid string) chan os.Signal { + sigc := make(chan os.Signal, 128) + signal.CatchAll(sigc) + go func() { + for s := range sigc { + if s == signal.SIGCHLD { + continue + } + var sig string + for sigStr, sigN := range signal.SignalMap { + if sigN == s { + sig = sigStr + break + } + } + if sig == "" { + fmt.Fprintf(cli.err, "Unsupported signal: %v. Discarding.\n", s) + continue + } + if _, _, err := readBody(cli.call("POST", fmt.Sprintf("/containers/%s/kill?signal=%s", cid, sig), nil, nil)); err != nil { + logrus.Debugf("Error sending signal: %s", err) + } + } + }() + return sigc +} + +// CmdStart starts one or more containers. +// +// Usage: docker start [OPTIONS] CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdStart(args ...string) error { + cmd := Cli.Subcmd("start", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["start"].Description, true) + attach := cmd.Bool([]string{"a", "-attach"}, false, "Attach STDOUT/STDERR and forward signals") + openStdin := cmd.Bool([]string{"i", "-interactive"}, false, "Attach container's STDIN") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var ( + cErr chan error + tty bool + ) + + if *attach || *openStdin { + if cmd.NArg() > 1 { + return fmt.Errorf("You cannot start and attach multiple containers at once.") + } + + serverResp, err := cli.call("GET", "/containers/"+cmd.Arg(0)+"/json", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + var c types.ContainerJSON + if err := json.NewDecoder(serverResp.body).Decode(&c); err != nil { + return err + } + + tty = c.Config.Tty + + if !tty { + sigc := cli.forwardAllSignals(cmd.Arg(0)) + defer signal.StopCatch(sigc) + } + + var in io.ReadCloser + + v := url.Values{} + v.Set("stream", "1") + + if *openStdin && c.Config.OpenStdin { + v.Set("stdin", "1") + in = cli.in + } + + v.Set("stdout", "1") + v.Set("stderr", "1") + + hijacked := make(chan io.Closer) + // Block the return until the chan gets closed + defer func() { + logrus.Debugf("CmdStart() returned, defer waiting for hijack to finish.") + if _, ok := <-hijacked; ok { + fmt.Fprintln(cli.err, "Hijack did not finish (chan still open)") + } + cli.in.Close() + }() + cErr = promise.Go(func() error { + return cli.hijack("POST", "/containers/"+cmd.Arg(0)+"/attach?"+v.Encode(), tty, in, cli.out, cli.err, hijacked, nil) + }) + + // Acknowledge the hijack before starting + select { + case closer := <-hijacked: + // Make sure that the hijack gets closed when returning (results + // in closing the hijack chan and freeing server's goroutines) + if closer != nil { + defer closer.Close() + } + case err := <-cErr: + if err != nil { + return err + } + } + } + + var encounteredError error + var errNames []string + for _, name := range cmd.Args() { + _, _, err := readBody(cli.call("POST", "/containers/"+name+"/start", nil, nil)) + if err != nil { + if !*attach && !*openStdin { + // attach and openStdin is false means it could be starting multiple containers + // when a container start failed, show the error message and start next + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + encounteredError = err + } + } else { + if !*attach && !*openStdin { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + } + + if len(errNames) > 0 { + encounteredError = fmt.Errorf("Error: failed to start containers: %v", errNames) + } + if encounteredError != nil { + return encounteredError + } + + if *openStdin || *attach { + if tty && cli.isTerminalOut { + if err := cli.monitorTtySize(cmd.Arg(0), false); err != nil { + fmt.Fprintf(cli.err, "Error monitoring TTY size: %s\n", err) + } + } + if attchErr := <-cErr; attchErr != nil { + return attchErr + } + _, status, err := getExitCode(cli, cmd.Arg(0)) + if err != nil { + return err + } + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + } + return nil +} diff --git a/api/client/stats.go b/api/client/stats.go new file mode 100644 index 0000000000..360d132d3b --- /dev/null +++ b/api/client/stats.go @@ -0,0 +1,240 @@ +package client + +import ( + "encoding/json" + "fmt" + "io" + "net/url" + "sort" + "strings" + "sync" + "text/tabwriter" + "time" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/units" +) + +type containerStats struct { + Name string + CPUPercentage float64 + Memory float64 + MemoryLimit float64 + MemoryPercentage float64 + NetworkRx float64 + NetworkTx float64 + BlockRead float64 + BlockWrite float64 + mu sync.RWMutex + err error +} + +func (s *containerStats) Collect(cli *DockerCli, streamStats bool) { + v := url.Values{} + if streamStats { + v.Set("stream", "1") + } else { + v.Set("stream", "0") + } + serverResp, err := cli.call("GET", "/containers/"+s.Name+"/stats?"+v.Encode(), nil, nil) + if err != nil { + s.mu.Lock() + s.err = err + s.mu.Unlock() + return + } + + defer serverResp.body.Close() + + var ( + previousCPU uint64 + previousSystem uint64 + dec = json.NewDecoder(serverResp.body) + u = make(chan error, 1) + ) + go func() { + for { + var v *types.StatsJSON + if err := dec.Decode(&v); err != nil { + u <- err + return + } + + var memPercent = 0.0 + var cpuPercent = 0.0 + + // MemoryStats.Limit will never be 0 unless the container is not running and we havn't + // got any data from cgroup + if v.MemoryStats.Limit != 0 { + memPercent = float64(v.MemoryStats.Usage) / float64(v.MemoryStats.Limit) * 100.0 + } + + previousCPU = v.PreCPUStats.CPUUsage.TotalUsage + previousSystem = v.PreCPUStats.SystemUsage + cpuPercent = calculateCPUPercent(previousCPU, previousSystem, v) + blkRead, blkWrite := calculateBlockIO(v.BlkioStats) + s.mu.Lock() + s.CPUPercentage = cpuPercent + s.Memory = float64(v.MemoryStats.Usage) + s.MemoryLimit = float64(v.MemoryStats.Limit) + s.MemoryPercentage = memPercent + s.NetworkRx, s.NetworkTx = calculateNetwork(v.Networks) + s.BlockRead = float64(blkRead) + s.BlockWrite = float64(blkWrite) + s.mu.Unlock() + u <- nil + if !streamStats { + return + } + } + }() + for { + select { + case <-time.After(2 * time.Second): + // zero out the values if we have not received an update within + // the specified duration. + s.mu.Lock() + s.CPUPercentage = 0 + s.Memory = 0 + s.MemoryPercentage = 0 + s.MemoryLimit = 0 + s.NetworkRx = 0 + s.NetworkTx = 0 + s.BlockRead = 0 + s.BlockWrite = 0 + s.mu.Unlock() + case err := <-u: + if err != nil { + s.mu.Lock() + s.err = err + s.mu.Unlock() + return + } + } + if !streamStats { + return + } + } +} + +func (s *containerStats) Display(w io.Writer) error { + s.mu.RLock() + defer s.mu.RUnlock() + if s.err != nil { + return s.err + } + fmt.Fprintf(w, "%s\t%.2f%%\t%s / %s\t%.2f%%\t%s / %s\t%s / %s\n", + s.Name, + s.CPUPercentage, + units.HumanSize(s.Memory), units.HumanSize(s.MemoryLimit), + s.MemoryPercentage, + units.HumanSize(s.NetworkRx), units.HumanSize(s.NetworkTx), + units.HumanSize(s.BlockRead), units.HumanSize(s.BlockWrite)) + return nil +} + +// CmdStats displays a live stream of resource usage statistics for one or more containers. +// +// This shows real-time information on CPU usage, memory usage, and network I/O. +// +// Usage: docker stats CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdStats(args ...string) error { + cmd := Cli.Subcmd("stats", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["stats"].Description, true) + noStream := cmd.Bool([]string{"-no-stream"}, false, "Disable streaming stats and only pull the first result") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + names := cmd.Args() + sort.Strings(names) + var ( + cStats []*containerStats + w = tabwriter.NewWriter(cli.out, 20, 1, 3, ' ', 0) + ) + printHeader := func() { + if !*noStream { + fmt.Fprint(cli.out, "\033[2J") + fmt.Fprint(cli.out, "\033[H") + } + io.WriteString(w, "CONTAINER\tCPU %\tMEM USAGE / LIMIT\tMEM %\tNET I/O\tBLOCK I/O\n") + } + for _, n := range names { + s := &containerStats{Name: n} + cStats = append(cStats, s) + go s.Collect(cli, !*noStream) + } + // do a quick pause so that any failed connections for containers that do not exist are able to be + // evicted before we display the initial or default values. + time.Sleep(1500 * time.Millisecond) + var errs []string + for _, c := range cStats { + c.mu.Lock() + if c.err != nil { + errs = append(errs, fmt.Sprintf("%s: %v", c.Name, c.err)) + } + c.mu.Unlock() + } + if len(errs) > 0 { + return fmt.Errorf("%s", strings.Join(errs, ", ")) + } + for range time.Tick(500 * time.Millisecond) { + printHeader() + toRemove := []int{} + for i, s := range cStats { + if err := s.Display(w); err != nil && !*noStream { + toRemove = append(toRemove, i) + } + } + for j := len(toRemove) - 1; j >= 0; j-- { + i := toRemove[j] + cStats = append(cStats[:i], cStats[i+1:]...) + } + if len(cStats) == 0 { + return nil + } + w.Flush() + if *noStream { + break + } + } + return nil +} + +func calculateCPUPercent(previousCPU, previousSystem uint64, v *types.StatsJSON) float64 { + var ( + cpuPercent = 0.0 + // calculate the change for the cpu usage of the container in between readings + cpuDelta = float64(v.CPUStats.CPUUsage.TotalUsage - previousCPU) + // calculate the change for the entire system between readings + systemDelta = float64(v.CPUStats.SystemUsage - previousSystem) + ) + + if systemDelta > 0.0 && cpuDelta > 0.0 { + cpuPercent = (cpuDelta / systemDelta) * float64(len(v.CPUStats.CPUUsage.PercpuUsage)) * 100.0 + } + return cpuPercent +} + +func calculateBlockIO(blkio types.BlkioStats) (blkRead uint64, blkWrite uint64) { + for _, bioEntry := range blkio.IoServiceBytesRecursive { + switch strings.ToLower(bioEntry.Op) { + case "read": + blkRead = blkRead + bioEntry.Value + case "write": + blkWrite = blkWrite + bioEntry.Value + } + } + return +} + +func calculateNetwork(network map[string]types.NetworkStats) (float64, float64) { + var rx, tx float64 + + for _, v := range network { + rx += float64(v.RxBytes) + tx += float64(v.TxBytes) + } + return rx, tx +} diff --git a/api/client/stats_unit_test.go b/api/client/stats_unit_test.go new file mode 100644 index 0000000000..301e0a6782 --- /dev/null +++ b/api/client/stats_unit_test.go @@ -0,0 +1,46 @@ +package client + +import ( + "bytes" + "sync" + "testing" + + "github.com/docker/docker/api/types" +) + +func TestDisplay(t *testing.T) { + c := &containerStats{ + Name: "app", + CPUPercentage: 30.0, + Memory: 100 * 1024 * 1024.0, + MemoryLimit: 2048 * 1024 * 1024.0, + MemoryPercentage: 100.0 / 2048.0 * 100.0, + NetworkRx: 100 * 1024 * 1024, + NetworkTx: 800 * 1024 * 1024, + BlockRead: 100 * 1024 * 1024, + BlockWrite: 800 * 1024 * 1024, + mu: sync.RWMutex{}, + } + var b bytes.Buffer + if err := c.Display(&b); err != nil { + t.Fatalf("c.Display() gave error: %s", err) + } + got := b.String() + want := "app\t30.00%\t104.9 MB / 2.147 GB\t4.88%\t104.9 MB / 838.9 MB\t104.9 MB / 838.9 MB\n" + if got != want { + t.Fatalf("c.Display() = %q, want %q", got, want) + } +} + +func TestCalculBlockIO(t *testing.T) { + blkio := types.BlkioStats{ + IoServiceBytesRecursive: []types.BlkioStatEntry{{8, 0, "read", 1234}, {8, 1, "read", 4567}, {8, 0, "write", 123}, {8, 1, "write", 456}}, + } + blkRead, blkWrite := calculateBlockIO(blkio) + if blkRead != 5801 { + t.Fatalf("blkRead = %d, want 5801", blkRead) + } + if blkWrite != 579 { + t.Fatalf("blkWrite = %d, want 579", blkWrite) + } +} diff --git a/api/client/stop.go b/api/client/stop.go new file mode 100644 index 0000000000..91f5e65b0e --- /dev/null +++ b/api/client/stop.go @@ -0,0 +1,41 @@ +package client + +import ( + "fmt" + "net/url" + "strconv" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdStop stops one or more containers. +// +// A running container is stopped by first sending SIGTERM and then SIGKILL if the container fails to stop within a grace period (the default is 10 seconds). +// +// Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdStop(args ...string) error { + cmd := Cli.Subcmd("stop", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["stop"].Description+".\nSending SIGTERM and then SIGKILL after a grace period", true) + nSeconds := cmd.Int([]string{"t", "-time"}, 10, "Seconds to wait for stop before killing it") + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + v := url.Values{} + v.Set("t", strconv.Itoa(*nSeconds)) + + var errNames []string + for _, name := range cmd.Args() { + _, _, err := readBody(cli.call("POST", "/containers/"+name+"/stop?"+v.Encode(), nil, nil)) + if err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to stop containers: %v", errNames) + } + return nil +} diff --git a/api/client/tag.go b/api/client/tag.go new file mode 100644 index 0000000000..b2fd059269 --- /dev/null +++ b/api/client/tag.go @@ -0,0 +1,42 @@ +package client + +import ( + "net/url" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/registry" +) + +// CmdTag tags an image into a repository. +// +// Usage: docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG] +func (cli *DockerCli) CmdTag(args ...string) error { + cmd := Cli.Subcmd("tag", []string{"IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG]"}, Cli.DockerCommands["tag"].Description, true) + force := cmd.Bool([]string{"f", "#force", "-force"}, false, "Force") + cmd.Require(flag.Exact, 2) + + cmd.ParseFlags(args, true) + + var ( + repository, tag = parsers.ParseRepositoryTag(cmd.Arg(1)) + v = url.Values{} + ) + + //Check if the given image name can be resolved + if err := registry.ValidateRepositoryName(repository); err != nil { + return err + } + v.Set("repo", repository) + v.Set("tag", tag) + + if *force { + v.Set("force", "1") + } + + if _, _, err := readBody(cli.call("POST", "/images/"+cmd.Arg(0)+"/tag?"+v.Encode(), nil, nil)); err != nil { + return err + } + return nil +} diff --git a/api/client/top.go b/api/client/top.go new file mode 100644 index 0000000000..8327820aae --- /dev/null +++ b/api/client/top.go @@ -0,0 +1,49 @@ +package client + +import ( + "encoding/json" + "fmt" + "net/url" + "strings" + "text/tabwriter" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdTop displays the running processes of a container. +// +// Usage: docker top CONTAINER +func (cli *DockerCli) CmdTop(args ...string) error { + cmd := Cli.Subcmd("top", []string{"CONTAINER [ps OPTIONS]"}, Cli.DockerCommands["top"].Description, true) + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + val := url.Values{} + if cmd.NArg() > 1 { + val.Set("ps_args", strings.Join(cmd.Args()[1:], " ")) + } + + serverResp, err := cli.call("GET", "/containers/"+cmd.Arg(0)+"/top?"+val.Encode(), nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + procList := types.ContainerProcessList{} + if err := json.NewDecoder(serverResp.body).Decode(&procList); err != nil { + return err + } + + w := tabwriter.NewWriter(cli.out, 20, 1, 3, ' ', 0) + fmt.Fprintln(w, strings.Join(procList.Titles, "\t")) + + for _, proc := range procList.Processes { + fmt.Fprintln(w, strings.Join(proc, "\t")) + } + w.Flush() + return nil +} diff --git a/api/client/trust.go b/api/client/trust.go new file mode 100644 index 0000000000..5936ac9360 --- /dev/null +++ b/api/client/trust.go @@ -0,0 +1,479 @@ +package client + +import ( + "bufio" + "encoding/hex" + "encoding/json" + "errors" + "fmt" + "io" + "net" + "net/http" + "net/url" + "os" + "path/filepath" + "regexp" + "sort" + "strconv" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/registry/client/auth" + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/pkg/ansiescape" + "github.com/docker/docker/pkg/ioutils" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/tlsconfig" + "github.com/docker/docker/registry" + "github.com/docker/notary/client" + "github.com/docker/notary/pkg/passphrase" + "github.com/docker/notary/trustmanager" + "github.com/endophage/gotuf/data" +) + +var untrusted bool + +func addTrustedFlags(fs *flag.FlagSet, verify bool) { + var trusted bool + if e := os.Getenv("DOCKER_CONTENT_TRUST"); e != "" { + if t, err := strconv.ParseBool(e); t || err != nil { + // treat any other value as true + trusted = true + } + } + message := "Skip image signing" + if verify { + message = "Skip image verification" + } + fs.BoolVar(&untrusted, []string{"-disable-content-trust"}, !trusted, message) +} + +func isTrusted() bool { + return !untrusted +} + +var targetRegexp = regexp.MustCompile(`([\S]+): digest: ([\S]+) size: ([\d]+)`) + +type target struct { + reference registry.Reference + digest digest.Digest + size int64 +} + +func (cli *DockerCli) trustDirectory() string { + return filepath.Join(cliconfig.ConfigDir(), "trust") +} + +// certificateDirectory returns the directory containing +// TLS certificates for the given server. An error is +// returned if there was an error parsing the server string. +func (cli *DockerCli) certificateDirectory(server string) (string, error) { + u, err := url.Parse(server) + if err != nil { + return "", err + } + + return filepath.Join(cliconfig.ConfigDir(), "tls", u.Host), nil +} + +func trustServer(index *registry.IndexInfo) (string, error) { + if s := os.Getenv("DOCKER_CONTENT_TRUST_SERVER"); s != "" { + urlObj, err := url.Parse(s) + if err != nil || urlObj.Scheme != "https" { + return "", fmt.Errorf("valid https URL required for trust server, got %s", s) + } + + return s, nil + } + if index.Official { + return registry.NotaryServer, nil + } + return "https://" + index.Name, nil +} + +type simpleCredentialStore struct { + auth cliconfig.AuthConfig +} + +func (scs simpleCredentialStore) Basic(u *url.URL) (string, string) { + return scs.auth.Username, scs.auth.Password +} + +func (cli *DockerCli) getNotaryRepository(repoInfo *registry.RepositoryInfo, authConfig cliconfig.AuthConfig) (*client.NotaryRepository, error) { + server, err := trustServer(repoInfo.Index) + if err != nil { + return nil, err + } + + var cfg = tlsconfig.ClientDefault + cfg.InsecureSkipVerify = !repoInfo.Index.Secure + + // Get certificate base directory + certDir, err := cli.certificateDirectory(server) + if err != nil { + return nil, err + } + logrus.Debugf("reading certificate directory: %s", certDir) + + if err := registry.ReadCertsDirectory(&cfg, certDir); err != nil { + return nil, err + } + + base := &http.Transport{ + Proxy: http.ProxyFromEnvironment, + Dial: (&net.Dialer{ + Timeout: 30 * time.Second, + KeepAlive: 30 * time.Second, + DualStack: true, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, + TLSClientConfig: &cfg, + DisableKeepAlives: true, + } + + // Skip configuration headers since request is not going to Docker daemon + modifiers := registry.DockerHeaders(http.Header{}) + authTransport := transport.NewTransport(base, modifiers...) + pingClient := &http.Client{ + Transport: authTransport, + Timeout: 5 * time.Second, + } + endpointStr := server + "/v2/" + req, err := http.NewRequest("GET", endpointStr, nil) + if err != nil { + return nil, err + } + + challengeManager := auth.NewSimpleChallengeManager() + + resp, err := pingClient.Do(req) + if err != nil { + // Ignore error on ping to operate in offline mode + logrus.Debugf("Error pinging notary server %q: %s", endpointStr, err) + } else { + defer resp.Body.Close() + + // Add response to the challenge manager to parse out + // authentication header and register authentication method + if err := challengeManager.AddResponse(resp); err != nil { + return nil, err + } + } + + creds := simpleCredentialStore{auth: authConfig} + tokenHandler := auth.NewTokenHandler(authTransport, creds, repoInfo.CanonicalName, "push", "pull") + basicHandler := auth.NewBasicHandler(creds) + modifiers = append(modifiers, transport.RequestModifier(auth.NewAuthorizer(challengeManager, tokenHandler, basicHandler))) + tr := transport.NewTransport(base, modifiers...) + + return client.NewNotaryRepository(cli.trustDirectory(), repoInfo.CanonicalName, server, tr, cli.getPassphraseRetriever()) +} + +func convertTarget(t client.Target) (target, error) { + h, ok := t.Hashes["sha256"] + if !ok { + return target{}, errors.New("no valid hash, expecting sha256") + } + return target{ + reference: registry.ParseReference(t.Name), + digest: digest.NewDigestFromHex("sha256", hex.EncodeToString(h)), + size: t.Length, + }, nil +} + +func (cli *DockerCli) getPassphraseRetriever() passphrase.Retriever { + aliasMap := map[string]string{ + "root": "root", + "snapshot": "repository", + "targets": "repository", + } + baseRetriever := passphrase.PromptRetrieverWithInOut(cli.in, cli.out, aliasMap) + env := map[string]string{ + "root": os.Getenv("DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE"), + "snapshot": os.Getenv("DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE"), + "targets": os.Getenv("DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE"), + } + + // Backwards compatibility with old env names. We should remove this in 1.10 + if env["root"] == "" { + if passphrase := os.Getenv("DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE"); passphrase != "" { + env["root"] = passphrase + fmt.Fprintf(cli.err, "[DEPRECATED] The environment variable DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE has been deprecated and will be removed in v1.10. Please use DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE\n") + } + } + if env["snapshot"] == "" || env["targets"] == "" { + if passphrase := os.Getenv("DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE"); passphrase != "" { + env["snapshot"] = passphrase + env["targets"] = passphrase + fmt.Fprintf(cli.err, "[DEPRECATED] The environment variable DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE has been deprecated and will be removed in v1.10. Please use DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE\n") + } + } + + return func(keyName string, alias string, createNew bool, numAttempts int) (string, bool, error) { + if v := env[alias]; v != "" { + return v, numAttempts > 1, nil + } + return baseRetriever(keyName, alias, createNew, numAttempts) + } +} + +func (cli *DockerCli) trustedReference(repo string, ref registry.Reference) (registry.Reference, error) { + repoInfo, err := registry.ParseRepositoryInfo(repo) + if err != nil { + return nil, err + } + + // Resolve the Auth config relevant for this server + authConfig := registry.ResolveAuthConfig(cli.configFile, repoInfo.Index) + + notaryRepo, err := cli.getNotaryRepository(repoInfo, authConfig) + if err != nil { + fmt.Fprintf(cli.out, "Error establishing connection to trust repository: %s\n", err) + return nil, err + } + + t, err := notaryRepo.GetTargetByName(ref.String()) + if err != nil { + return nil, err + } + r, err := convertTarget(*t) + if err != nil { + return nil, err + + } + + return registry.DigestReference(r.digest), nil +} + +func (cli *DockerCli) tagTrusted(repoInfo *registry.RepositoryInfo, trustedRef, ref registry.Reference) error { + fullName := trustedRef.ImageName(repoInfo.LocalName) + fmt.Fprintf(cli.out, "Tagging %s as %s\n", fullName, ref.ImageName(repoInfo.LocalName)) + tv := url.Values{} + tv.Set("repo", repoInfo.LocalName) + tv.Set("tag", ref.String()) + tv.Set("force", "1") + + if _, _, err := readBody(cli.call("POST", "/images/"+fullName+"/tag?"+tv.Encode(), nil, nil)); err != nil { + return err + } + + return nil +} + +func notaryError(err error) error { + switch err.(type) { + case *json.SyntaxError: + logrus.Debugf("Notary syntax error: %s", err) + return errors.New("no trust data available for remote repository") + case client.ErrExpired: + return fmt.Errorf("remote repository out-of-date: %v", err) + case trustmanager.ErrKeyNotFound: + return fmt.Errorf("signing keys not found: %v", err) + case *net.OpError: + return fmt.Errorf("error contacting notary server: %v", err) + } + + return err +} + +func (cli *DockerCli) trustedPull(repoInfo *registry.RepositoryInfo, ref registry.Reference, authConfig cliconfig.AuthConfig) error { + var ( + v = url.Values{} + refs = []target{} + ) + + notaryRepo, err := cli.getNotaryRepository(repoInfo, authConfig) + if err != nil { + fmt.Fprintf(cli.out, "Error establishing connection to trust repository: %s\n", err) + return err + } + + if ref.String() == "" { + // List all targets + targets, err := notaryRepo.ListTargets() + if err != nil { + return notaryError(err) + } + for _, tgt := range targets { + t, err := convertTarget(*tgt) + if err != nil { + fmt.Fprintf(cli.out, "Skipping target for %q\n", repoInfo.LocalName) + continue + } + refs = append(refs, t) + } + } else { + t, err := notaryRepo.GetTargetByName(ref.String()) + if err != nil { + return notaryError(err) + } + r, err := convertTarget(*t) + if err != nil { + return err + + } + refs = append(refs, r) + } + + v.Set("fromImage", repoInfo.LocalName) + for i, r := range refs { + displayTag := r.reference.String() + if displayTag != "" { + displayTag = ":" + displayTag + } + fmt.Fprintf(cli.out, "Pull (%d of %d): %s%s@%s\n", i+1, len(refs), repoInfo.LocalName, displayTag, r.digest) + v.Set("tag", r.digest.String()) + + _, _, err = cli.clientRequestAttemptLogin("POST", "/images/create?"+v.Encode(), nil, cli.out, repoInfo.Index, "pull") + if err != nil { + return err + } + + // If reference is not trusted, tag by trusted reference + if !r.reference.HasDigest() { + if err := cli.tagTrusted(repoInfo, registry.DigestReference(r.digest), r.reference); err != nil { + return err + + } + } + } + return nil +} + +func selectKey(keys map[string]string) string { + if len(keys) == 0 { + return "" + } + + keyIDs := []string{} + for k := range keys { + keyIDs = append(keyIDs, k) + } + + // TODO(dmcgowan): let user choose if multiple keys, now pick consistently + sort.Strings(keyIDs) + + return keyIDs[0] +} + +func targetStream(in io.Writer) (io.WriteCloser, <-chan []target) { + r, w := io.Pipe() + out := io.MultiWriter(in, w) + targetChan := make(chan []target) + + go func() { + targets := []target{} + scanner := bufio.NewScanner(r) + scanner.Split(ansiescape.ScanANSILines) + for scanner.Scan() { + line := scanner.Bytes() + if matches := targetRegexp.FindSubmatch(line); len(matches) == 4 { + dgst, err := digest.ParseDigest(string(matches[2])) + if err != nil { + // Line does match what is expected, continue looking for valid lines + logrus.Debugf("Bad digest value %q in matched line, ignoring\n", string(matches[2])) + continue + } + s, err := strconv.ParseInt(string(matches[3]), 10, 64) + if err != nil { + // Line does match what is expected, continue looking for valid lines + logrus.Debugf("Bad size value %q in matched line, ignoring\n", string(matches[3])) + continue + } + + targets = append(targets, target{ + reference: registry.ParseReference(string(matches[1])), + digest: dgst, + size: s, + }) + } + } + targetChan <- targets + }() + + return ioutils.NewWriteCloserWrapper(out, w.Close), targetChan +} + +func (cli *DockerCli) trustedPush(repoInfo *registry.RepositoryInfo, tag string, authConfig cliconfig.AuthConfig) error { + streamOut, targetChan := targetStream(cli.out) + + v := url.Values{} + v.Set("tag", tag) + + _, _, err := cli.clientRequestAttemptLogin("POST", "/images/"+repoInfo.LocalName+"/push?"+v.Encode(), nil, streamOut, repoInfo.Index, "push") + // Close stream channel to finish target parsing + if err := streamOut.Close(); err != nil { + return err + } + // Check error from request + if err != nil { + return err + } + + // Get target results + targets := <-targetChan + + if tag == "" { + fmt.Fprintf(cli.out, "No tag specified, skipping trust metadata push\n") + return nil + } + if len(targets) == 0 { + fmt.Fprintf(cli.out, "No targets found, skipping trust metadata push\n") + return nil + } + + fmt.Fprintf(cli.out, "Signing and pushing trust metadata\n") + + repo, err := cli.getNotaryRepository(repoInfo, authConfig) + if err != nil { + fmt.Fprintf(cli.out, "Error establishing connection to notary repository: %s\n", err) + return err + } + + for _, target := range targets { + h, err := hex.DecodeString(target.digest.Hex()) + if err != nil { + return err + } + t := &client.Target{ + Name: target.reference.String(), + Hashes: data.Hashes{ + string(target.digest.Algorithm()): h, + }, + Length: int64(target.size), + } + if err := repo.AddTarget(t); err != nil { + return err + } + } + + err = repo.Publish() + if _, ok := err.(*client.ErrRepoNotInitialized); !ok { + return notaryError(err) + } + + ks := repo.KeyStoreManager + keys := ks.RootKeyStore().ListKeys() + + rootKey := selectKey(keys) + if rootKey == "" { + rootKey, err = ks.GenRootKey("ecdsa") + if err != nil { + return err + } + } + + cryptoService, err := ks.GetRootCryptoService(rootKey) + if err != nil { + return err + } + + if err := repo.Initialize(cryptoService); err != nil { + return notaryError(err) + } + fmt.Fprintf(cli.out, "Finished initializing %q\n", repoInfo.CanonicalName) + + return notaryError(repo.Publish()) +} diff --git a/api/client/trust_test.go b/api/client/trust_test.go new file mode 100644 index 0000000000..af198de21c --- /dev/null +++ b/api/client/trust_test.go @@ -0,0 +1,55 @@ +package client + +import ( + "os" + "testing" + + "github.com/docker/docker/registry" +) + +func unsetENV() { + os.Unsetenv("DOCKER_CONTENT_TRUST") + os.Unsetenv("DOCKER_CONTENT_TRUST_SERVER") +} + +func TestENVTrustServer(t *testing.T) { + defer unsetENV() + indexInfo := ®istry.IndexInfo{Name: "testserver"} + if err := os.Setenv("DOCKER_CONTENT_TRUST_SERVER", "https://notary-test.com:5000"); err != nil { + t.Fatal("Failed to set ENV variable") + } + output, err := trustServer(indexInfo) + expectedStr := "https://notary-test.com:5000" + if err != nil || output != expectedStr { + t.Fatalf("Expected server to be %s, got %s", expectedStr, output) + } +} + +func TestHTTPENVTrustServer(t *testing.T) { + defer unsetENV() + indexInfo := ®istry.IndexInfo{Name: "testserver"} + if err := os.Setenv("DOCKER_CONTENT_TRUST_SERVER", "http://notary-test.com:5000"); err != nil { + t.Fatal("Failed to set ENV variable") + } + _, err := trustServer(indexInfo) + if err == nil { + t.Fatal("Expected error with invalid scheme") + } +} + +func TestOfficialTrustServer(t *testing.T) { + indexInfo := ®istry.IndexInfo{Name: "testserver", Official: true} + output, err := trustServer(indexInfo) + if err != nil || output != registry.NotaryServer { + t.Fatalf("Expected server to be %s, got %s", registry.NotaryServer, output) + } +} + +func TestNonOfficialTrustServer(t *testing.T) { + indexInfo := ®istry.IndexInfo{Name: "testserver", Official: false} + output, err := trustServer(indexInfo) + expectedStr := "https://" + indexInfo.Name + if err != nil || output != expectedStr { + t.Fatalf("Expected server to be %s, got %s", expectedStr, output) + } +} diff --git a/api/client/unpause.go b/api/client/unpause.go new file mode 100644 index 0000000000..21e25857cf --- /dev/null +++ b/api/client/unpause.go @@ -0,0 +1,32 @@ +package client + +import ( + "fmt" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdUnpause unpauses all processes within a container, for one or more containers. +// +// Usage: docker unpause CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdUnpause(args ...string) error { + cmd := Cli.Subcmd("unpause", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["unpause"].Description, true) + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var errNames []string + for _, name := range cmd.Args() { + if _, _, err := readBody(cli.call("POST", fmt.Sprintf("/containers/%s/unpause", name), nil, nil)); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%s\n", name) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to unpause containers: %v", errNames) + } + return nil +} diff --git a/api/client/utils.go b/api/client/utils.go new file mode 100644 index 0000000000..9eeb0eb045 --- /dev/null +++ b/api/client/utils.go @@ -0,0 +1,384 @@ +package client + +import ( + "bytes" + "encoding/base64" + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/url" + "os" + gosignal "os/signal" + "runtime" + "strconv" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/api/types" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/pkg/jsonmessage" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/stdcopy" + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" +) + +var ( + errConnectionFailed = errors.New("Cannot connect to the Docker daemon. Is the docker daemon running on this host?") +) + +type serverResponse struct { + body io.ReadCloser + header http.Header + statusCode int +} + +// HTTPClient creates a new HTTP client with the cli's client transport instance. +func (cli *DockerCli) HTTPClient() *http.Client { + return &http.Client{Transport: cli.transport} +} + +func (cli *DockerCli) encodeData(data interface{}) (*bytes.Buffer, error) { + params := bytes.NewBuffer(nil) + if data != nil { + if err := json.NewEncoder(params).Encode(data); err != nil { + return nil, err + } + } + return params, nil +} + +func (cli *DockerCli) clientRequest(method, path string, in io.Reader, headers map[string][]string) (*serverResponse, error) { + + serverResp := &serverResponse{ + body: nil, + statusCode: -1, + } + + expectedPayload := (method == "POST" || method == "PUT") + if expectedPayload && in == nil { + in = bytes.NewReader([]byte{}) + } + req, err := http.NewRequest(method, fmt.Sprintf("%s/v%s%s", cli.basePath, api.Version, path), in) + if err != nil { + return serverResp, err + } + + // Add CLI Config's HTTP Headers BEFORE we set the Docker headers + // then the user can't change OUR headers + for k, v := range cli.configFile.HTTPHeaders { + req.Header.Set(k, v) + } + + req.Header.Set("User-Agent", "Docker-Client/"+dockerversion.VERSION+" ("+runtime.GOOS+")") + req.URL.Host = cli.addr + req.URL.Scheme = cli.scheme + + if headers != nil { + for k, v := range headers { + req.Header[k] = v + } + } + + if expectedPayload && req.Header.Get("Content-Type") == "" { + req.Header.Set("Content-Type", "text/plain") + } + + resp, err := cli.HTTPClient().Do(req) + if resp != nil { + serverResp.statusCode = resp.StatusCode + } + + if err != nil { + if utils.IsTimeout(err) || strings.Contains(err.Error(), "connection refused") || strings.Contains(err.Error(), "dial unix") { + return serverResp, errConnectionFailed + } + + if cli.tlsConfig == nil && strings.Contains(err.Error(), "malformed HTTP response") { + return serverResp, fmt.Errorf("%v.\n* Are you trying to connect to a TLS-enabled daemon without TLS?", err) + } + if cli.tlsConfig != nil && strings.Contains(err.Error(), "remote error: bad certificate") { + return serverResp, fmt.Errorf("The server probably has client authentication (--tlsverify) enabled. Please check your TLS client certification settings: %v", err) + } + + return serverResp, fmt.Errorf("An error occurred trying to connect: %v", err) + } + + if serverResp.statusCode < 200 || serverResp.statusCode >= 400 { + body, err := ioutil.ReadAll(resp.Body) + if err != nil { + return serverResp, err + } + if len(body) == 0 { + return serverResp, fmt.Errorf("Error: request returned %s for API route and version %s, check if the server supports the requested API version", http.StatusText(serverResp.statusCode), req.URL) + } + return serverResp, fmt.Errorf("Error response from daemon: %s", bytes.TrimSpace(body)) + } + + serverResp.body = resp.Body + serverResp.header = resp.Header + return serverResp, nil +} + +// cmdAttempt builds the corresponding registry Auth Header from the given +// authConfig. It returns the servers body, status, error response +func (cli *DockerCli) cmdAttempt(authConfig cliconfig.AuthConfig, method, path string, in io.Reader, out io.Writer) (io.ReadCloser, int, error) { + buf, err := json.Marshal(authConfig) + if err != nil { + return nil, -1, err + } + registryAuthHeader := []string{ + base64.URLEncoding.EncodeToString(buf), + } + + // begin the request + serverResp, err := cli.clientRequest(method, path, in, map[string][]string{ + "X-Registry-Auth": registryAuthHeader, + }) + if err == nil && out != nil { + // If we are streaming output, complete the stream since + // errors may not appear until later. + err = cli.streamBody(serverResp.body, serverResp.header.Get("Content-Type"), true, out, nil) + } + if err != nil { + // Since errors in a stream appear after status 200 has been written, + // we may need to change the status code. + if strings.Contains(err.Error(), "Authentication is required") || + strings.Contains(err.Error(), "Status 401") || + strings.Contains(err.Error(), "401 Unauthorized") || + strings.Contains(err.Error(), "status code 401") { + serverResp.statusCode = http.StatusUnauthorized + } + } + return serverResp.body, serverResp.statusCode, err +} + +func (cli *DockerCli) clientRequestAttemptLogin(method, path string, in io.Reader, out io.Writer, index *registry.IndexInfo, cmdName string) (io.ReadCloser, int, error) { + + // Resolve the Auth config relevant for this server + authConfig := registry.ResolveAuthConfig(cli.configFile, index) + body, statusCode, err := cli.cmdAttempt(authConfig, method, path, in, out) + if statusCode == http.StatusUnauthorized { + fmt.Fprintf(cli.out, "\nPlease login prior to %s:\n", cmdName) + if err = cli.CmdLogin(index.GetAuthConfigKey()); err != nil { + return nil, -1, err + } + authConfig = registry.ResolveAuthConfig(cli.configFile, index) + return cli.cmdAttempt(authConfig, method, path, in, out) + } + return body, statusCode, err +} + +func (cli *DockerCli) callWrapper(method, path string, data interface{}, headers map[string][]string) (io.ReadCloser, http.Header, int, error) { + sr, err := cli.call(method, path, data, headers) + return sr.body, sr.header, sr.statusCode, err +} + +func (cli *DockerCli) call(method, path string, data interface{}, headers map[string][]string) (*serverResponse, error) { + params, err := cli.encodeData(data) + if err != nil { + sr := &serverResponse{ + body: nil, + header: nil, + statusCode: -1, + } + return sr, nil + } + + if data != nil { + if headers == nil { + headers = make(map[string][]string) + } + headers["Content-Type"] = []string{"application/json"} + } + + serverResp, err := cli.clientRequest(method, path, params, headers) + return serverResp, err +} + +type streamOpts struct { + rawTerminal bool + in io.Reader + out io.Writer + err io.Writer + headers map[string][]string +} + +func (cli *DockerCli) stream(method, path string, opts *streamOpts) (*serverResponse, error) { + serverResp, err := cli.clientRequest(method, path, opts.in, opts.headers) + if err != nil { + return serverResp, err + } + return serverResp, cli.streamBody(serverResp.body, serverResp.header.Get("Content-Type"), opts.rawTerminal, opts.out, opts.err) +} + +func (cli *DockerCli) streamBody(body io.ReadCloser, contentType string, rawTerminal bool, stdout, stderr io.Writer) error { + defer body.Close() + + if api.MatchesContentType(contentType, "application/json") { + return jsonmessage.DisplayJSONMessagesStream(body, stdout, cli.outFd, cli.isTerminalOut) + } + if stdout != nil || stderr != nil { + // When TTY is ON, use regular copy + var err error + if rawTerminal { + _, err = io.Copy(stdout, body) + } else { + _, err = stdcopy.StdCopy(stdout, stderr, body) + } + logrus.Debugf("[stream] End of stdout") + return err + } + return nil +} + +func (cli *DockerCli) resizeTty(id string, isExec bool) { + height, width := cli.getTtySize() + if height == 0 && width == 0 { + return + } + v := url.Values{} + v.Set("h", strconv.Itoa(height)) + v.Set("w", strconv.Itoa(width)) + + path := "" + if !isExec { + path = "/containers/" + id + "/resize?" + } else { + path = "/exec/" + id + "/resize?" + } + + if _, _, err := readBody(cli.call("POST", path+v.Encode(), nil, nil)); err != nil { + logrus.Debugf("Error resize: %s", err) + } +} + +func waitForExit(cli *DockerCli, containerID string) (int, error) { + serverResp, err := cli.call("POST", "/containers/"+containerID+"/wait", nil, nil) + if err != nil { + return -1, err + } + + defer serverResp.body.Close() + + var res types.ContainerWaitResponse + if err := json.NewDecoder(serverResp.body).Decode(&res); err != nil { + return -1, err + } + + return res.StatusCode, nil +} + +// getExitCode perform an inspect on the container. It returns +// the running state and the exit code. +func getExitCode(cli *DockerCli, containerID string) (bool, int, error) { + serverResp, err := cli.call("GET", "/containers/"+containerID+"/json", nil, nil) + if err != nil { + // If we can't connect, then the daemon probably died. + if err != errConnectionFailed { + return false, -1, err + } + return false, -1, nil + } + + defer serverResp.body.Close() + + var c types.ContainerJSON + if err := json.NewDecoder(serverResp.body).Decode(&c); err != nil { + return false, -1, err + } + + return c.State.Running, c.State.ExitCode, nil +} + +// getExecExitCode perform an inspect on the exec command. It returns +// the running state and the exit code. +func getExecExitCode(cli *DockerCli, execID string) (bool, int, error) { + serverResp, err := cli.call("GET", "/exec/"+execID+"/json", nil, nil) + if err != nil { + // If we can't connect, then the daemon probably died. + if err != errConnectionFailed { + return false, -1, err + } + return false, -1, nil + } + + defer serverResp.body.Close() + + //TODO: Should we reconsider having a type in api/types? + //this is a response to exex/id/json not container + var c struct { + Running bool + ExitCode int + } + + if err := json.NewDecoder(serverResp.body).Decode(&c); err != nil { + return false, -1, err + } + + return c.Running, c.ExitCode, nil +} + +func (cli *DockerCli) monitorTtySize(id string, isExec bool) error { + cli.resizeTty(id, isExec) + + if runtime.GOOS == "windows" { + go func() { + prevH, prevW := cli.getTtySize() + for { + time.Sleep(time.Millisecond * 250) + h, w := cli.getTtySize() + + if prevW != w || prevH != h { + cli.resizeTty(id, isExec) + } + prevH = h + prevW = w + } + }() + } else { + sigchan := make(chan os.Signal, 1) + gosignal.Notify(sigchan, signal.SIGWINCH) + go func() { + for range sigchan { + cli.resizeTty(id, isExec) + } + }() + } + return nil +} + +func (cli *DockerCli) getTtySize() (int, int) { + if !cli.isTerminalOut { + return 0, 0 + } + ws, err := term.GetWinsize(cli.outFd) + if err != nil { + logrus.Debugf("Error getting size: %s", err) + if ws == nil { + return 0, 0 + } + } + return int(ws.Height), int(ws.Width) +} + +func readBody(serverResp *serverResponse, err error) ([]byte, int, error) { + if serverResp.body != nil { + defer serverResp.body.Close() + } + if err != nil { + return nil, serverResp.statusCode, err + } + body, err := ioutil.ReadAll(serverResp.body) + if err != nil { + return nil, -1, err + } + return body, serverResp.statusCode, nil +} diff --git a/api/client/version.go b/api/client/version.go new file mode 100644 index 0000000000..43cde71ec4 --- /dev/null +++ b/api/client/version.go @@ -0,0 +1,96 @@ +package client + +import ( + "encoding/json" + "runtime" + "text/template" + + "github.com/docker/docker/api" + "github.com/docker/docker/api/types" + "github.com/docker/docker/autogen/dockerversion" + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/utils" +) + +var versionTemplate = `Client: + Version: {{.Client.Version}} + API version: {{.Client.APIVersion}} + Go version: {{.Client.GoVersion}} + Git commit: {{.Client.GitCommit}} + Built: {{.Client.BuildTime}} + OS/Arch: {{.Client.Os}}/{{.Client.Arch}}{{if .Client.Experimental}} + Experimental: {{.Client.Experimental}}{{end}}{{if .ServerOK}} + +Server: + Version: {{.Server.Version}} + API version: {{.Server.APIVersion}} + Go version: {{.Server.GoVersion}} + Git commit: {{.Server.GitCommit}} + Built: {{.Server.BuildTime}} + OS/Arch: {{.Server.Os}}/{{.Server.Arch}}{{if .Server.Experimental}} + Experimental: {{.Server.Experimental}}{{end}}{{end}}` + +type versionData struct { + Client types.Version + ServerOK bool + Server types.Version +} + +// CmdVersion shows Docker version information. +// +// Available version information is shown for: client Docker version, client API version, client Go version, client Git commit, client OS/Arch, server Docker version, server API version, server Go version, server Git commit, and server OS/Arch. +// +// Usage: docker version +func (cli *DockerCli) CmdVersion(args ...string) (err error) { + cmd := Cli.Subcmd("version", nil, Cli.DockerCommands["version"].Description, true) + tmplStr := cmd.String([]string{"f", "#format", "-format"}, "", "Format the output using the given go template") + cmd.Require(flag.Exact, 0) + + cmd.ParseFlags(args, true) + if *tmplStr == "" { + *tmplStr = versionTemplate + } + + var tmpl *template.Template + if tmpl, err = template.New("").Funcs(funcMap).Parse(*tmplStr); err != nil { + return Cli.StatusError{StatusCode: 64, + Status: "Template parsing error: " + err.Error()} + } + + vd := versionData{ + Client: types.Version{ + Version: dockerversion.VERSION, + APIVersion: api.Version, + GoVersion: runtime.Version(), + GitCommit: dockerversion.GITCOMMIT, + BuildTime: dockerversion.BUILDTIME, + Os: runtime.GOOS, + Arch: runtime.GOARCH, + Experimental: utils.ExperimentalBuild(), + }, + } + + defer func() { + if err2 := tmpl.Execute(cli.out, vd); err2 != nil && err == nil { + err = err2 + } + cli.out.Write([]byte{'\n'}) + }() + + serverResp, err := cli.call("GET", "/version", nil, nil) + if err != nil { + return err + } + + defer serverResp.body.Close() + + if err = json.NewDecoder(serverResp.body).Decode(&vd.Server); err != nil { + return Cli.StatusError{StatusCode: 1, + Status: "Error reading remote version: " + err.Error()} + } + + vd.ServerOK = true + + return +} diff --git a/api/client/volume.go b/api/client/volume.go new file mode 100644 index 0000000000..1dc0ea2d04 --- /dev/null +++ b/api/client/volume.go @@ -0,0 +1,234 @@ +package client + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "net/url" + "text/tabwriter" + "text/template" + + "github.com/docker/docker/api/types" + Cli "github.com/docker/docker/cli" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/parsers/filters" +) + +// CmdVolume is the parent subcommand for all volume commands +// +// Usage: docker volume +func (cli *DockerCli) CmdVolume(args ...string) error { + description := Cli.DockerCommands["volume"].Description + "\n\nCommands:\n" + commands := [][]string{ + {"create", "Create a volume"}, + {"inspect", "Return low-level information on a volume"}, + {"ls", "List volumes"}, + {"rm", "Remove a volume"}, + } + + for _, cmd := range commands { + description += fmt.Sprintf(" %-25.25s%s\n", cmd[0], cmd[1]) + } + + description += "\nRun 'docker volume COMMAND --help' for more information on a command" + cmd := Cli.Subcmd("volume", []string{"[COMMAND]"}, description, false) + + cmd.Require(flag.Exact, 0) + err := cmd.ParseFlags(args, true) + cmd.Usage() + return err +} + +// CmdVolumeLs outputs a list of Docker volumes. +// +// Usage: docker volume ls [OPTIONS] +func (cli *DockerCli) CmdVolumeLs(args ...string) error { + cmd := Cli.Subcmd("volume ls", nil, "List volumes", true) + + quiet := cmd.Bool([]string{"q", "-quiet"}, false, "Only display volume names") + flFilter := opts.NewListOpts(nil) + cmd.Var(&flFilter, []string{"f", "-filter"}, "Provide filter values (i.e. 'dangling=true')") + + cmd.Require(flag.Exact, 0) + cmd.ParseFlags(args, true) + + volFilterArgs := filters.Args{} + for _, f := range flFilter.GetAll() { + var err error + volFilterArgs, err = filters.ParseFlag(f, volFilterArgs) + if err != nil { + return err + } + } + + v := url.Values{} + if len(volFilterArgs) > 0 { + filterJSON, err := filters.ToParam(volFilterArgs) + if err != nil { + return err + } + v.Set("filters", filterJSON) + } + + resp, err := cli.call("GET", "/volumes?"+v.Encode(), nil, nil) + if err != nil { + return err + } + + var volumes types.VolumesListResponse + if err := json.NewDecoder(resp.body).Decode(&volumes); err != nil { + return err + } + + w := tabwriter.NewWriter(cli.out, 20, 1, 3, ' ', 0) + if !*quiet { + fmt.Fprintf(w, "DRIVER \tVOLUME NAME") + fmt.Fprintf(w, "\n") + } + + for _, vol := range volumes.Volumes { + if *quiet { + fmt.Fprintln(w, vol.Name) + continue + } + fmt.Fprintf(w, "%s\t%s\n", vol.Driver, vol.Name) + } + w.Flush() + return nil +} + +// CmdVolumeInspect displays low-level information on one or more volumes. +// +// Usage: docker volume inspect [OPTIONS] VOLUME [VOLUME...] +func (cli *DockerCli) CmdVolumeInspect(args ...string) error { + cmd := Cli.Subcmd("volume inspect", []string{"VOLUME [VOLUME...]"}, "Return low-level information on a volume", true) + tmplStr := cmd.String([]string{"f", "-format"}, "", "Format the output using the given go template") + + cmd.Require(flag.Min, 1) + cmd.ParseFlags(args, true) + + if err := cmd.Parse(args); err != nil { + return nil + } + + var tmpl *template.Template + if *tmplStr != "" { + var err error + tmpl, err = template.New("").Funcs(funcMap).Parse(*tmplStr) + if err != nil { + return err + } + } + + var status = 0 + var volumes []*types.Volume + for _, name := range cmd.Args() { + resp, err := cli.call("GET", "/volumes/"+name, nil, nil) + if err != nil { + return err + } + + var volume types.Volume + if err := json.NewDecoder(resp.body).Decode(&volume); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + status = 1 + continue + } + + if tmpl == nil { + volumes = append(volumes, &volume) + continue + } + + if err := tmpl.Execute(cli.out, &volume); err != nil { + if err := tmpl.Execute(cli.out, &volume); err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + status = 1 + continue + } + } + io.WriteString(cli.out, "\n") + } + + if tmpl != nil { + return nil + } + + b, err := json.MarshalIndent(volumes, "", " ") + if err != nil { + return err + } + _, err = io.Copy(cli.out, bytes.NewReader(b)) + if err != nil { + return err + } + io.WriteString(cli.out, "\n") + + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + return nil +} + +// CmdVolumeCreate creates a new container from a given image. +// +// Usage: docker volume create [OPTIONS] +func (cli *DockerCli) CmdVolumeCreate(args ...string) error { + cmd := Cli.Subcmd("volume create", nil, "Create a volume", true) + flDriver := cmd.String([]string{"d", "-driver"}, "local", "Specify volume driver name") + flName := cmd.String([]string{"-name"}, "", "Specify volume name") + + flDriverOpts := opts.NewMapOpts(nil, nil) + cmd.Var(flDriverOpts, []string{"o", "-opt"}, "Set driver specific options") + + cmd.Require(flag.Exact, 0) + cmd.ParseFlags(args, true) + + volReq := &types.VolumeCreateRequest{ + Driver: *flDriver, + DriverOpts: flDriverOpts.GetAll(), + } + + if *flName != "" { + volReq.Name = *flName + } + + resp, err := cli.call("POST", "/volumes/create", volReq, nil) + if err != nil { + return err + } + + var vol types.Volume + if err := json.NewDecoder(resp.body).Decode(&vol); err != nil { + return err + } + fmt.Fprintf(cli.out, "%s\n", vol.Name) + return nil +} + +// CmdVolumeRm removes one or more containers. +// +// Usage: docker volume rm VOLUME [VOLUME...] +func (cli *DockerCli) CmdVolumeRm(args ...string) error { + cmd := Cli.Subcmd("volume rm", []string{"VOLUME [VOLUME...]"}, "Remove a volume", true) + cmd.Require(flag.Min, 1) + cmd.ParseFlags(args, true) + + var status = 0 + for _, name := range cmd.Args() { + _, err := cli.call("DELETE", "/volumes/"+name, nil, nil) + if err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + status = 1 + continue + } + fmt.Fprintf(cli.out, "%s\n", name) + } + + if status != 0 { + return Cli.StatusError{StatusCode: status} + } + return nil +} diff --git a/api/client/wait.go b/api/client/wait.go new file mode 100644 index 0000000000..3b03f7069e --- /dev/null +++ b/api/client/wait.go @@ -0,0 +1,35 @@ +package client + +import ( + "fmt" + + Cli "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +// CmdWait blocks until a container stops, then prints its exit code. +// +// If more than one container is specified, this will wait synchronously on each container. +// +// Usage: docker wait CONTAINER [CONTAINER...] +func (cli *DockerCli) CmdWait(args ...string) error { + cmd := Cli.Subcmd("wait", []string{"CONTAINER [CONTAINER...]"}, Cli.DockerCommands["wait"].Description, true) + cmd.Require(flag.Min, 1) + + cmd.ParseFlags(args, true) + + var errNames []string + for _, name := range cmd.Args() { + status, err := waitForExit(cli, name) + if err != nil { + fmt.Fprintf(cli.err, "%s\n", err) + errNames = append(errNames, name) + } else { + fmt.Fprintf(cli.out, "%d\n", status) + } + } + if len(errNames) > 0 { + return fmt.Errorf("Error: failed to wait containers: %v", errNames) + } + return nil +} diff --git a/api/common.go b/api/common.go new file mode 100644 index 0000000000..7ce0006db9 --- /dev/null +++ b/api/common.go @@ -0,0 +1,127 @@ +package api + +import ( + "fmt" + "mime" + "path/filepath" + "sort" + "strconv" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/version" + "github.com/docker/libtrust" +) + +// Common constants for daemon and client. +const ( + // Version of Current REST API + Version version.Version = "1.21" + + // MinVersion represents Minimun REST API version supported + MinVersion version.Version = "1.12" + + // DefaultDockerfileName is the Default filename with Docker commands, read by docker build + DefaultDockerfileName string = "Dockerfile" +) + +// byPrivatePort is temporary type used to sort types.Port by PrivatePort +type byPrivatePort []types.Port + +func (r byPrivatePort) Len() int { return len(r) } +func (r byPrivatePort) Swap(i, j int) { r[i], r[j] = r[j], r[i] } +func (r byPrivatePort) Less(i, j int) bool { return r[i].PrivatePort < r[j].PrivatePort } + +// DisplayablePorts returns formatted string representing open ports of container +// e.g. "0.0.0.0:80->9090/tcp, 9988/tcp" +// it's used by command 'docker ps' +func DisplayablePorts(ports []types.Port) string { + type portGroup struct { + first int + last int + } + groupMap := make(map[string]*portGroup) + var result []string + var hostMappings []string + sort.Sort(byPrivatePort(ports)) + for _, port := range ports { + current := port.PrivatePort + portKey := port.Type + if port.IP != "" { + if port.PublicPort != current { + hostMappings = append(hostMappings, fmt.Sprintf("%s:%d->%d/%s", port.IP, port.PublicPort, port.PrivatePort, port.Type)) + continue + } + portKey = fmt.Sprintf("%s/%s", port.IP, port.Type) + } + group := groupMap[portKey] + + if group == nil { + groupMap[portKey] = &portGroup{first: current, last: current} + continue + } + if current == (group.last + 1) { + group.last = current + continue + } + + result = append(result, formGroup(portKey, group.first, group.last)) + groupMap[portKey] = &portGroup{first: current, last: current} + } + for portKey, g := range groupMap { + result = append(result, formGroup(portKey, g.first, g.last)) + } + result = append(result, hostMappings...) + return strings.Join(result, ", ") +} + +func formGroup(key string, start, last int) string { + parts := strings.Split(key, "/") + groupType := parts[0] + var ip string + if len(parts) > 1 { + ip = parts[0] + groupType = parts[1] + } + group := strconv.Itoa(start) + if start != last { + group = fmt.Sprintf("%s-%d", group, last) + } + if ip != "" { + group = fmt.Sprintf("%s:%s->%s", ip, group, group) + } + return fmt.Sprintf("%s/%s", group, groupType) +} + +// MatchesContentType validates the content type against the expected one +func MatchesContentType(contentType, expectedType string) bool { + mimetype, _, err := mime.ParseMediaType(contentType) + if err != nil { + logrus.Errorf("Error parsing media type: %s error: %v", contentType, err) + } + return err == nil && mimetype == expectedType +} + +// LoadOrCreateTrustKey attempts to load the libtrust key at the given path, +// otherwise generates a new one +func LoadOrCreateTrustKey(trustKeyPath string) (libtrust.PrivateKey, error) { + err := system.MkdirAll(filepath.Dir(trustKeyPath), 0700) + if err != nil { + return nil, err + } + trustKey, err := libtrust.LoadKeyFile(trustKeyPath) + if err == libtrust.ErrKeyFileDoesNotExist { + trustKey, err = libtrust.GenerateECP256PrivateKey() + if err != nil { + return nil, fmt.Errorf("Error generating key: %s", err) + } + if err := libtrust.SaveKey(trustKeyPath, trustKey); err != nil { + return nil, fmt.Errorf("Error saving key file: %s", err) + } + } else if err != nil { + return nil, fmt.Errorf("Error loading key file %s: %s", trustKeyPath, err) + } + return trustKey, nil +} diff --git a/api/common_test.go b/api/common_test.go new file mode 100644 index 0000000000..39ea93bd64 --- /dev/null +++ b/api/common_test.go @@ -0,0 +1,282 @@ +package api + +import ( + "io/ioutil" + "path/filepath" + "testing" + + "github.com/docker/docker/api/types" + "os" +) + +type ports struct { + ports []types.Port + expected string +} + +// DisplayablePorts +func TestDisplayablePorts(t *testing.T) { + cases := []ports{ + { + []types.Port{ + { + PrivatePort: 9988, + Type: "tcp", + }, + }, + "9988/tcp"}, + { + []types.Port{ + { + PrivatePort: 9988, + Type: "udp", + }, + }, + "9988/udp", + }, + { + []types.Port{ + { + IP: "0.0.0.0", + PrivatePort: 9988, + Type: "tcp", + }, + }, + "0.0.0.0:0->9988/tcp", + }, + { + []types.Port{ + { + PrivatePort: 9988, + PublicPort: 8899, + Type: "tcp", + }, + }, + "9988/tcp", + }, + { + []types.Port{ + { + IP: "4.3.2.1", + PrivatePort: 9988, + PublicPort: 8899, + Type: "tcp", + }, + }, + "4.3.2.1:8899->9988/tcp", + }, + { + []types.Port{ + { + IP: "4.3.2.1", + PrivatePort: 9988, + PublicPort: 9988, + Type: "tcp", + }, + }, + "4.3.2.1:9988->9988/tcp", + }, + { + []types.Port{ + { + PrivatePort: 9988, + Type: "udp", + }, { + PrivatePort: 9988, + Type: "udp", + }, + }, + "9988/udp, 9988/udp", + }, + { + []types.Port{ + { + IP: "1.2.3.4", + PublicPort: 9998, + PrivatePort: 9998, + Type: "udp", + }, { + IP: "1.2.3.4", + PublicPort: 9999, + PrivatePort: 9999, + Type: "udp", + }, + }, + "1.2.3.4:9998-9999->9998-9999/udp", + }, + { + []types.Port{ + { + IP: "1.2.3.4", + PublicPort: 8887, + PrivatePort: 9998, + Type: "udp", + }, { + IP: "1.2.3.4", + PublicPort: 8888, + PrivatePort: 9999, + Type: "udp", + }, + }, + "1.2.3.4:8887->9998/udp, 1.2.3.4:8888->9999/udp", + }, + { + []types.Port{ + { + PrivatePort: 9998, + Type: "udp", + }, { + PrivatePort: 9999, + Type: "udp", + }, + }, + "9998-9999/udp", + }, + { + []types.Port{ + { + IP: "1.2.3.4", + PrivatePort: 6677, + PublicPort: 7766, + Type: "tcp", + }, { + PrivatePort: 9988, + PublicPort: 8899, + Type: "udp", + }, + }, + "9988/udp, 1.2.3.4:7766->6677/tcp", + }, + { + []types.Port{ + { + IP: "1.2.3.4", + PrivatePort: 9988, + PublicPort: 8899, + Type: "udp", + }, { + IP: "1.2.3.4", + PrivatePort: 9988, + PublicPort: 8899, + Type: "tcp", + }, { + IP: "4.3.2.1", + PrivatePort: 2233, + PublicPort: 3322, + Type: "tcp", + }, + }, + "4.3.2.1:3322->2233/tcp, 1.2.3.4:8899->9988/udp, 1.2.3.4:8899->9988/tcp", + }, + { + []types.Port{ + { + PrivatePort: 9988, + PublicPort: 8899, + Type: "udp", + }, { + IP: "1.2.3.4", + PrivatePort: 6677, + PublicPort: 7766, + Type: "tcp", + }, { + IP: "4.3.2.1", + PrivatePort: 2233, + PublicPort: 3322, + Type: "tcp", + }, + }, + "9988/udp, 4.3.2.1:3322->2233/tcp, 1.2.3.4:7766->6677/tcp", + }, + } + + for _, port := range cases { + actual := DisplayablePorts(port.ports) + if port.expected != actual { + t.Fatalf("Expected %s, got %s.", port.expected, actual) + } + } +} + +// MatchesContentType +func TestJsonContentType(t *testing.T) { + if !MatchesContentType("application/json", "application/json") { + t.Fail() + } + + if !MatchesContentType("application/json; charset=utf-8", "application/json") { + t.Fail() + } + + if MatchesContentType("dockerapplication/json", "application/json") { + t.Fail() + } +} + +// LoadOrCreateTrustKey +func TestLoadOrCreateTrustKeyInvalidKeyFile(t *testing.T) { + tmpKeyFolderPath, err := ioutil.TempDir("", "api-trustkey-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpKeyFolderPath) + + tmpKeyFile, err := ioutil.TempFile(tmpKeyFolderPath, "keyfile") + if err != nil { + t.Fatal(err) + } + + if _, err := LoadOrCreateTrustKey(tmpKeyFile.Name()); err == nil { + t.Fatalf("expected an error, got nothing.") + } + +} + +func TestLoadOrCreateTrustKeyCreateKey(t *testing.T) { + tmpKeyFolderPath, err := ioutil.TempDir("", "api-trustkey-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpKeyFolderPath) + + // Without the need to create the folder hierarchy + tmpKeyFile := filepath.Join(tmpKeyFolderPath, "keyfile") + + if key, err := LoadOrCreateTrustKey(tmpKeyFile); err != nil || key == nil { + t.Fatalf("expected a new key file, got : %v and %v", err, key) + } + + if _, err := os.Stat(tmpKeyFile); err != nil { + t.Fatalf("Expected to find a file %s, got %v", tmpKeyFile, err) + } + + // With the need to create the folder hierarchy as tmpKeyFie is in a path + // where some folder do not exists. + tmpKeyFile = filepath.Join(tmpKeyFolderPath, "folder/hierarchy/keyfile") + + if key, err := LoadOrCreateTrustKey(tmpKeyFile); err != nil || key == nil { + t.Fatalf("expected a new key file, got : %v and %v", err, key) + } + + if _, err := os.Stat(tmpKeyFile); err != nil { + t.Fatalf("Expected to find a file %s, got %v", tmpKeyFile, err) + } + + // With no path at all + defer os.Remove("keyfile") + if key, err := LoadOrCreateTrustKey("keyfile"); err != nil || key == nil { + t.Fatalf("expected a new key file, got : %v and %v", err, key) + } + + if _, err := os.Stat("keyfile"); err != nil { + t.Fatalf("Expected to find a file keyfile, got %v", err) + } +} + +func TestLoadOrCreateTrustKeyLoadValidKey(t *testing.T) { + tmpKeyFile := filepath.Join("fixtures", "keyfile") + + if key, err := LoadOrCreateTrustKey(tmpKeyFile); err != nil || key == nil { + t.Fatalf("expected a key file, got : %v and %v", err, key) + } +} diff --git a/api/fixtures/keyfile b/api/fixtures/keyfile new file mode 100644 index 0000000000..322f254404 --- /dev/null +++ b/api/fixtures/keyfile @@ -0,0 +1,7 @@ +-----BEGIN EC PRIVATE KEY----- +keyID: AWX2:I27X:WQFX:IOMK:CNAK:O7PW:VYNB:ZLKC:CVAE:YJP2:SI4A:XXAY + +MHcCAQEEILHTRWdcpKWsnORxSFyBnndJ4ROU41hMtr/GCiLVvwBQoAoGCCqGSM49 +AwEHoUQDQgAElpVFbQ2V2UQKajqdE3fVxJ+/pE/YuEFOxWbOxF2be19BY209/iky +NzeFFK7SLpQ4CBJ7zDVXOHsMzrkY/GquGA== +-----END EC PRIVATE KEY----- diff --git a/api/server/httputils/form.go b/api/server/httputils/form.go new file mode 100644 index 0000000000..5180b99f16 --- /dev/null +++ b/api/server/httputils/form.go @@ -0,0 +1,76 @@ +package httputils + +import ( + "fmt" + "net/http" + "path/filepath" + "strconv" + "strings" +) + +// BoolValue transforms a form value in different formats into a boolean type. +func BoolValue(r *http.Request, k string) bool { + s := strings.ToLower(strings.TrimSpace(r.FormValue(k))) + return !(s == "" || s == "0" || s == "no" || s == "false" || s == "none") +} + +// BoolValueOrDefault returns the default bool passed if the query param is +// missing, otherwise it's just a proxy to boolValue above +func BoolValueOrDefault(r *http.Request, k string, d bool) bool { + if _, ok := r.Form[k]; !ok { + return d + } + return BoolValue(r, k) +} + +// Int64ValueOrZero parses a form value into an int64 type. +// It returns 0 if the parsing fails. +func Int64ValueOrZero(r *http.Request, k string) int64 { + val, err := Int64ValueOrDefault(r, k, 0) + if err != nil { + return 0 + } + return val +} + +// Int64ValueOrDefault parses a form value into an int64 type. If there is an +// error, returns the error. If there is no value returns the default value. +func Int64ValueOrDefault(r *http.Request, field string, def int64) (int64, error) { + if r.Form.Get(field) != "" { + value, err := strconv.ParseInt(r.Form.Get(field), 10, 64) + if err != nil { + return value, err + } + return value, nil + } + return def, nil +} + +// ArchiveOptions stores archive information for different operations. +type ArchiveOptions struct { + Name string + Path string +} + +// ArchiveFormValues parses form values and turns them into ArchiveOptions. +// It fails if the archive name and path are not in the request. +func ArchiveFormValues(r *http.Request, vars map[string]string) (ArchiveOptions, error) { + if vars == nil { + return ArchiveOptions{}, fmt.Errorf("Missing parameter") + } + if err := ParseForm(r); err != nil { + return ArchiveOptions{}, err + } + + name := vars["name"] + path := filepath.FromSlash(r.Form.Get("path")) + + switch { + case name == "": + return ArchiveOptions{}, fmt.Errorf("bad parameter: 'name' cannot be empty") + case path == "": + return ArchiveOptions{}, fmt.Errorf("bad parameter: 'path' cannot be empty") + } + + return ArchiveOptions{name, path}, nil +} diff --git a/api/server/httputils/form_test.go b/api/server/httputils/form_test.go new file mode 100644 index 0000000000..c56f7c15e3 --- /dev/null +++ b/api/server/httputils/form_test.go @@ -0,0 +1,105 @@ +package httputils + +import ( + "net/http" + "net/url" + "testing" +) + +func TestBoolValue(t *testing.T) { + cases := map[string]bool{ + "": false, + "0": false, + "no": false, + "false": false, + "none": false, + "1": true, + "yes": true, + "true": true, + "one": true, + "100": true, + } + + for c, e := range cases { + v := url.Values{} + v.Set("test", c) + r, _ := http.NewRequest("POST", "", nil) + r.Form = v + + a := BoolValue(r, "test") + if a != e { + t.Fatalf("Value: %s, expected: %v, actual: %v", c, e, a) + } + } +} + +func TestBoolValueOrDefault(t *testing.T) { + r, _ := http.NewRequest("GET", "", nil) + if !BoolValueOrDefault(r, "queryparam", true) { + t.Fatal("Expected to get true default value, got false") + } + + v := url.Values{} + v.Set("param", "") + r, _ = http.NewRequest("GET", "", nil) + r.Form = v + if BoolValueOrDefault(r, "param", true) { + t.Fatal("Expected not to get true") + } +} + +func TestInt64ValueOrZero(t *testing.T) { + cases := map[string]int64{ + "": 0, + "asdf": 0, + "0": 0, + "1": 1, + } + + for c, e := range cases { + v := url.Values{} + v.Set("test", c) + r, _ := http.NewRequest("POST", "", nil) + r.Form = v + + a := Int64ValueOrZero(r, "test") + if a != e { + t.Fatalf("Value: %s, expected: %v, actual: %v", c, e, a) + } + } +} + +func TestInt64ValueOrDefault(t *testing.T) { + cases := map[string]int64{ + "": -1, + "-1": -1, + "42": 42, + } + + for c, e := range cases { + v := url.Values{} + v.Set("test", c) + r, _ := http.NewRequest("POST", "", nil) + r.Form = v + + a, err := Int64ValueOrDefault(r, "test", -1) + if a != e { + t.Fatalf("Value: %s, expected: %v, actual: %v", c, e, a) + } + if err != nil { + t.Fatalf("Error should be nil, but received: %s", err) + } + } +} + +func TestInt64ValueOrDefaultWithError(t *testing.T) { + v := url.Values{} + v.Set("test", "invalid") + r, _ := http.NewRequest("POST", "", nil) + r.Form = v + + _, err := Int64ValueOrDefault(r, "test", -1) + if err == nil { + t.Fatalf("Expected an error.") + } +} diff --git a/api/server/httputils/httputils.go b/api/server/httputils/httputils.go new file mode 100644 index 0000000000..2997dc0356 --- /dev/null +++ b/api/server/httputils/httputils.go @@ -0,0 +1,180 @@ +package httputils + +import ( + "encoding/json" + "fmt" + "io" + "net/http" + "strings" + + "golang.org/x/net/context" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/registry/api/errcode" + "github.com/docker/docker/api" + "github.com/docker/docker/pkg/version" + "github.com/docker/docker/utils" +) + +// APIVersionKey is the client's requested API version. +const APIVersionKey = "api-version" + +// APIFunc is an adapter to allow the use of ordinary functions as Docker API endpoints. +// Any function that has the appropriate signature can be register as a API endpoint (e.g. getVersion). +type APIFunc func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error + +// HijackConnection interrupts the http response writer to get the +// underlying connection and operate with it. +func HijackConnection(w http.ResponseWriter) (io.ReadCloser, io.Writer, error) { + conn, _, err := w.(http.Hijacker).Hijack() + if err != nil { + return nil, nil, err + } + // Flush the options to make sure the client sets the raw mode + conn.Write([]byte{}) + return conn, conn, nil +} + +// CloseStreams ensures that a list for http streams are properly closed. +func CloseStreams(streams ...interface{}) { + for _, stream := range streams { + if tcpc, ok := stream.(interface { + CloseWrite() error + }); ok { + tcpc.CloseWrite() + } else if closer, ok := stream.(io.Closer); ok { + closer.Close() + } + } +} + +// CheckForJSON makes sure that the request's Content-Type is application/json. +func CheckForJSON(r *http.Request) error { + ct := r.Header.Get("Content-Type") + + // No Content-Type header is ok as long as there's no Body + if ct == "" { + if r.Body == nil || r.ContentLength == 0 { + return nil + } + } + + // Otherwise it better be json + if api.MatchesContentType(ct, "application/json") { + return nil + } + return fmt.Errorf("Content-Type specified (%s) must be 'application/json'", ct) +} + +// ParseForm ensures the request form is parsed even with invalid content types. +// If we don't do this, POST method without Content-type (even with empty body) will fail. +func ParseForm(r *http.Request) error { + if r == nil { + return nil + } + if err := r.ParseForm(); err != nil && !strings.HasPrefix(err.Error(), "mime:") { + return err + } + return nil +} + +// ParseMultipartForm ensure the request form is parsed, even with invalid content types. +func ParseMultipartForm(r *http.Request) error { + if err := r.ParseMultipartForm(4096); err != nil && !strings.HasPrefix(err.Error(), "mime:") { + return err + } + return nil +} + +// WriteError decodes a specific docker error and sends it in the response. +func WriteError(w http.ResponseWriter, err error) { + if err == nil || w == nil { + logrus.WithFields(logrus.Fields{"error": err, "writer": w}).Error("unexpected HTTP error handling") + return + } + + statusCode := http.StatusInternalServerError + errMsg := err.Error() + + // Based on the type of error we get we need to process things + // slightly differently to extract the error message. + // In the 'errcode.*' cases there are two different type of + // error that could be returned. errocode.ErrorCode is the base + // type of error object - it is just an 'int' that can then be + // used as the look-up key to find the message. errorcode.Error + // extends errorcode.Error by adding error-instance specific + // data, like 'details' or variable strings to be inserted into + // the message. + // + // Ideally, we should just be able to call err.Error() for all + // cases but the errcode package doesn't support that yet. + // + // Additionally, in both errcode cases, there might be an http + // status code associated with it, and if so use it. + switch err.(type) { + case errcode.ErrorCode: + daError, _ := err.(errcode.ErrorCode) + statusCode = daError.Descriptor().HTTPStatusCode + errMsg = daError.Message() + + case errcode.Error: + // For reference, if you're looking for a particular error + // then you can do something like : + // import ( derr "github.com/docker/docker/errors" ) + // if daError.ErrorCode() == derr.ErrorCodeNoSuchContainer { ... } + + daError, _ := err.(errcode.Error) + statusCode = daError.ErrorCode().Descriptor().HTTPStatusCode + errMsg = daError.Message + + default: + // This part of will be removed once we've + // converted everything over to use the errcode package + + // FIXME: this is brittle and should not be necessary. + // If we need to differentiate between different possible error types, + // we should create appropriate error types with clearly defined meaning + errStr := strings.ToLower(err.Error()) + for keyword, status := range map[string]int{ + "not found": http.StatusNotFound, + "no such": http.StatusNotFound, + "bad parameter": http.StatusBadRequest, + "conflict": http.StatusConflict, + "impossible": http.StatusNotAcceptable, + "wrong login/password": http.StatusUnauthorized, + "hasn't been activated": http.StatusForbidden, + } { + if strings.Contains(errStr, keyword) { + statusCode = status + break + } + } + } + + if statusCode == 0 { + statusCode = http.StatusInternalServerError + } + + logrus.WithFields(logrus.Fields{"statusCode": statusCode, "err": utils.GetErrorMessage(err)}).Error("HTTP Error") + http.Error(w, errMsg, statusCode) +} + +// WriteJSON writes the value v to the http response stream as json with standard json encoding. +func WriteJSON(w http.ResponseWriter, code int, v interface{}) error { + w.Header().Set("Content-Type", "application/json") + w.WriteHeader(code) + return json.NewEncoder(w).Encode(v) +} + +// VersionFromContext returns an API version from the context using APIVersionKey. +// It panics if the context value does not have version.Version type. +func VersionFromContext(ctx context.Context) (ver version.Version) { + if ctx == nil { + return + } + val := ctx.Value(APIVersionKey) + if val == nil { + return + } + return val.(version.Version) +} diff --git a/api/server/middleware.go b/api/server/middleware.go new file mode 100644 index 0000000000..47e52ee5b2 --- /dev/null +++ b/api/server/middleware.go @@ -0,0 +1,118 @@ +package server + +import ( + "net/http" + "runtime" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/version" + "golang.org/x/net/context" +) + +// middleware is an adapter to allow the use of ordinary functions as Docker API filters. +// Any function that has the appropriate signature can be register as a middleware. +type middleware func(handler httputils.APIFunc) httputils.APIFunc + +// loggingMiddleware logs each request when logging is enabled. +func (s *Server) loggingMiddleware(handler httputils.APIFunc) httputils.APIFunc { + return func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if s.cfg.Logging { + logrus.Infof("%s %s", r.Method, r.RequestURI) + } + return handler(ctx, w, r, vars) + } +} + +// userAgentMiddleware checks the User-Agent header looking for a valid docker client spec. +func (s *Server) userAgentMiddleware(handler httputils.APIFunc) httputils.APIFunc { + return func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if strings.Contains(r.Header.Get("User-Agent"), "Docker-Client/") { + dockerVersion := version.Version(s.cfg.Version) + + userAgent := strings.Split(r.Header.Get("User-Agent"), "/") + + // v1.20 onwards includes the GOOS of the client after the version + // such as Docker/1.7.0 (linux) + if len(userAgent) == 2 && strings.Contains(userAgent[1], " ") { + userAgent[1] = strings.Split(userAgent[1], " ")[0] + } + + if len(userAgent) == 2 && !dockerVersion.Equal(version.Version(userAgent[1])) { + logrus.Debugf("Warning: client and server don't have the same version (client: %s, server: %s)", userAgent[1], dockerVersion) + } + } + return handler(ctx, w, r, vars) + } +} + +// corsMiddleware sets the CORS header expectations in the server. +func (s *Server) corsMiddleware(handler httputils.APIFunc) httputils.APIFunc { + return func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + // If "api-cors-header" is not given, but "api-enable-cors" is true, we set cors to "*" + // otherwise, all head values will be passed to HTTP handler + corsHeaders := s.cfg.CorsHeaders + if corsHeaders == "" && s.cfg.EnableCors { + corsHeaders = "*" + } + + if corsHeaders != "" { + writeCorsHeaders(w, r, corsHeaders) + } + return handler(ctx, w, r, vars) + } +} + +// versionMiddleware checks the api version requirements before passing the request to the server handler. +func versionMiddleware(handler httputils.APIFunc) httputils.APIFunc { + return func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + apiVersion := version.Version(vars["version"]) + if apiVersion == "" { + apiVersion = api.Version + } + + if apiVersion.GreaterThan(api.Version) { + return errors.ErrorCodeNewerClientVersion.WithArgs(apiVersion, api.Version) + } + if apiVersion.LessThan(api.MinVersion) { + return errors.ErrorCodeOldClientVersion.WithArgs(apiVersion, api.Version) + } + + w.Header().Set("Server", "Docker/"+dockerversion.VERSION+" ("+runtime.GOOS+")") + ctx = context.WithValue(ctx, httputils.APIVersionKey, apiVersion) + return handler(ctx, w, r, vars) + } +} + +// handleWithGlobalMiddlwares wraps the handler function for a request with +// the server's global middlewares. The order of the middlewares is backwards, +// meaning that the first in the list will be evaludated last. +// +// Example: handleWithGlobalMiddlewares(s.getContainersName) +// +// s.loggingMiddleware( +// s.userAgentMiddleware( +// s.corsMiddleware( +// versionMiddleware(s.getContainersName) +// ) +// ) +// ) +// ) +func (s *Server) handleWithGlobalMiddlewares(handler httputils.APIFunc) httputils.APIFunc { + middlewares := []middleware{ + versionMiddleware, + s.corsMiddleware, + s.userAgentMiddleware, + s.loggingMiddleware, + } + + h := handler + for _, m := range middlewares { + h = m(h) + } + return h +} diff --git a/api/server/middleware_test.go b/api/server/middleware_test.go new file mode 100644 index 0000000000..4f48b20990 --- /dev/null +++ b/api/server/middleware_test.go @@ -0,0 +1,57 @@ +package server + +import ( + "net/http" + "net/http/httptest" + "testing" + + "github.com/docker/distribution/registry/api/errcode" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/errors" + "golang.org/x/net/context" +) + +func TestVersionMiddleware(t *testing.T) { + handler := func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if httputils.VersionFromContext(ctx) == "" { + t.Fatalf("Expected version, got empty string") + } + return nil + } + + h := versionMiddleware(handler) + + req, _ := http.NewRequest("GET", "/containers/json", nil) + resp := httptest.NewRecorder() + ctx := context.Background() + if err := h(ctx, resp, req, map[string]string{}); err != nil { + t.Fatal(err) + } +} + +func TestVersionMiddlewareWithErrors(t *testing.T) { + handler := func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if httputils.VersionFromContext(ctx) == "" { + t.Fatalf("Expected version, got empty string") + } + return nil + } + + h := versionMiddleware(handler) + + req, _ := http.NewRequest("GET", "/containers/json", nil) + resp := httptest.NewRecorder() + ctx := context.Background() + + vars := map[string]string{"version": "0.1"} + err := h(ctx, resp, req, vars) + if derr, ok := err.(errcode.Error); !ok || derr.ErrorCode() != errors.ErrorCodeOldClientVersion { + t.Fatalf("Expected ErrorCodeOldClientVersion, got %v", err) + } + + vars["version"] = "100000" + err = h(ctx, resp, req, vars) + if derr, ok := err.(errcode.Error); !ok || derr.ErrorCode() != errors.ErrorCodeNewerClientVersion { + t.Fatalf("Expected ErrorCodeNewerClientVersion, got %v", err) + } +} diff --git a/api/server/profiler.go b/api/server/profiler.go new file mode 100644 index 0000000000..766462bd6a --- /dev/null +++ b/api/server/profiler.go @@ -0,0 +1,38 @@ +package server + +import ( + "expvar" + "fmt" + "net/http" + "net/http/pprof" + + "github.com/gorilla/mux" +) + +func profilerSetup(mainRouter *mux.Router, path string) { + var r = mainRouter.PathPrefix(path).Subrouter() + r.HandleFunc("/vars", expVars) + r.HandleFunc("/pprof/", pprof.Index) + r.HandleFunc("/pprof/cmdline", pprof.Cmdline) + r.HandleFunc("/pprof/profile", pprof.Profile) + r.HandleFunc("/pprof/symbol", pprof.Symbol) + r.HandleFunc("/pprof/block", pprof.Handler("block").ServeHTTP) + r.HandleFunc("/pprof/heap", pprof.Handler("heap").ServeHTTP) + r.HandleFunc("/pprof/goroutine", pprof.Handler("goroutine").ServeHTTP) + r.HandleFunc("/pprof/threadcreate", pprof.Handler("threadcreate").ServeHTTP) +} + +// Replicated from expvar.go as not public. +func expVars(w http.ResponseWriter, r *http.Request) { + first := true + w.Header().Set("Content-Type", "application/json; charset=utf-8") + fmt.Fprintf(w, "{\n") + expvar.Do(func(kv expvar.KeyValue) { + if !first { + fmt.Fprintf(w, ",\n") + } + first = false + fmt.Fprintf(w, "%q: %s", kv.Key, kv.Value) + }) + fmt.Fprintf(w, "\n}\n") +} diff --git a/api/server/router/local/auth.go b/api/server/router/local/auth.go new file mode 100644 index 0000000000..872124c9f6 --- /dev/null +++ b/api/server/router/local/auth.go @@ -0,0 +1,27 @@ +package local + +import ( + "encoding/json" + "net/http" + + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "github.com/docker/docker/cliconfig" + "golang.org/x/net/context" +) + +func (s *router) postAuth(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + var config *cliconfig.AuthConfig + err := json.NewDecoder(r.Body).Decode(&config) + r.Body.Close() + if err != nil { + return err + } + status, err := s.daemon.AuthenticateToRegistry(config) + if err != nil { + return err + } + return httputils.WriteJSON(w, http.StatusOK, &types.AuthResponse{ + Status: status, + }) +} diff --git a/api/server/router/local/container.go b/api/server/router/local/container.go new file mode 100644 index 0000000000..b7b3e31650 --- /dev/null +++ b/api/server/router/local/container.go @@ -0,0 +1,515 @@ +package local + +import ( + "fmt" + "io" + "net/http" + "strconv" + "strings" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/registry/api/errcode" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "github.com/docker/docker/daemon" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" + "golang.org/x/net/context" + "golang.org/x/net/websocket" +) + +func (s *router) getContainersJSON(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + config := &daemon.ContainersConfig{ + All: httputils.BoolValue(r, "all"), + Size: httputils.BoolValue(r, "size"), + Since: r.Form.Get("since"), + Before: r.Form.Get("before"), + Filters: r.Form.Get("filters"), + } + + if tmpLimit := r.Form.Get("limit"); tmpLimit != "" { + limit, err := strconv.Atoi(tmpLimit) + if err != nil { + return err + } + config.Limit = limit + } + + containers, err := s.daemon.Containers(config) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, containers) +} + +func (s *router) getContainersStats(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + stream := httputils.BoolValueOrDefault(r, "stream", true) + var out io.Writer + if !stream { + w.Header().Set("Content-Type", "application/json") + out = w + } else { + wf := ioutils.NewWriteFlusher(w) + out = wf + defer wf.Close() + } + + var closeNotifier <-chan bool + if notifier, ok := w.(http.CloseNotifier); ok { + closeNotifier = notifier.CloseNotify() + } + + config := &daemon.ContainerStatsConfig{ + Stream: stream, + OutStream: out, + Stop: closeNotifier, + Version: httputils.VersionFromContext(ctx), + } + + return s.daemon.ContainerStats(vars["name"], config) +} + +func (s *router) getContainersLogs(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + // Args are validated before the stream starts because when it starts we're + // sending HTTP 200 by writing an empty chunk of data to tell the client that + // daemon is going to stream. By sending this initial HTTP 200 we can't report + // any error after the stream starts (i.e. container not found, wrong parameters) + // with the appropriate status code. + stdout, stderr := httputils.BoolValue(r, "stdout"), httputils.BoolValue(r, "stderr") + if !(stdout || stderr) { + return fmt.Errorf("Bad parameters: you must choose at least one stream") + } + + var since time.Time + if r.Form.Get("since") != "" { + s, err := strconv.ParseInt(r.Form.Get("since"), 10, 64) + if err != nil { + return err + } + since = time.Unix(s, 0) + } + + var closeNotifier <-chan bool + if notifier, ok := w.(http.CloseNotifier); ok { + closeNotifier = notifier.CloseNotify() + } + + containerName := vars["name"] + + if !s.daemon.Exists(containerName) { + return derr.ErrorCodeNoSuchContainer.WithArgs(containerName) + } + + // write an empty chunk of data (this is to ensure that the + // HTTP Response is sent immediately, even if the container has + // not yet produced any data) + w.WriteHeader(http.StatusOK) + if flusher, ok := w.(http.Flusher); ok { + flusher.Flush() + } + + output := ioutils.NewWriteFlusher(w) + defer output.Close() + + logsConfig := &daemon.ContainerLogsConfig{ + Follow: httputils.BoolValue(r, "follow"), + Timestamps: httputils.BoolValue(r, "timestamps"), + Since: since, + Tail: r.Form.Get("tail"), + UseStdout: stdout, + UseStderr: stderr, + OutStream: output, + Stop: closeNotifier, + } + + if err := s.daemon.ContainerLogs(containerName, logsConfig); err != nil { + // The client may be expecting all of the data we're sending to + // be multiplexed, so send it through OutStream, which will + // have been set up to handle that if needed. + fmt.Fprintf(logsConfig.OutStream, "Error running logs job: %s\n", utils.GetErrorMessage(err)) + } + + return nil +} + +func (s *router) getContainersExport(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + return s.daemon.ContainerExport(vars["name"], w) +} + +func (s *router) postContainersStart(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + // If contentLength is -1, we can assumed chunked encoding + // or more technically that the length is unknown + // https://golang.org/src/pkg/net/http/request.go#L139 + // net/http otherwise seems to swallow any headers related to chunked encoding + // including r.TransferEncoding + // allow a nil body for backwards compatibility + var hostConfig *runconfig.HostConfig + if r.Body != nil && (r.ContentLength > 0 || r.ContentLength == -1) { + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + c, err := runconfig.DecodeHostConfig(r.Body) + if err != nil { + return err + } + + hostConfig = c + } + + if err := s.daemon.ContainerStart(vars["name"], hostConfig); err != nil { + return err + } + w.WriteHeader(http.StatusNoContent) + return nil +} + +func (s *router) postContainersStop(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + seconds, _ := strconv.Atoi(r.Form.Get("t")) + + if err := s.daemon.ContainerStop(vars["name"], seconds); err != nil { + return err + } + w.WriteHeader(http.StatusNoContent) + + return nil +} + +func (s *router) postContainersKill(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + if err := httputils.ParseForm(r); err != nil { + return err + } + + var sig syscall.Signal + name := vars["name"] + + // If we have a signal, look at it. Otherwise, do nothing + if sigStr := r.Form.Get("signal"); sigStr != "" { + var err error + if sig, err = signal.ParseSignal(sigStr); err != nil { + return err + } + } + + if err := s.daemon.ContainerKill(name, uint64(sig)); err != nil { + theErr, isDerr := err.(errcode.ErrorCoder) + isStopped := isDerr && theErr.ErrorCode() == derr.ErrorCodeNotRunning + + // Return error that's not caused because the container is stopped. + // Return error if the container is not running and the api is >= 1.20 + // to keep backwards compatibility. + version := httputils.VersionFromContext(ctx) + if version.GreaterThanOrEqualTo("1.20") || !isStopped { + return fmt.Errorf("Cannot kill container %s: %v", name, err) + } + } + + w.WriteHeader(http.StatusNoContent) + return nil +} + +func (s *router) postContainersRestart(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + timeout, _ := strconv.Atoi(r.Form.Get("t")) + + if err := s.daemon.ContainerRestart(vars["name"], timeout); err != nil { + return err + } + + w.WriteHeader(http.StatusNoContent) + + return nil +} + +func (s *router) postContainersPause(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := s.daemon.ContainerPause(vars["name"]); err != nil { + return err + } + + w.WriteHeader(http.StatusNoContent) + + return nil +} + +func (s *router) postContainersUnpause(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := s.daemon.ContainerUnpause(vars["name"]); err != nil { + return err + } + + w.WriteHeader(http.StatusNoContent) + + return nil +} + +func (s *router) postContainersWait(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + status, err := s.daemon.ContainerWait(vars["name"], -1*time.Second) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, &types.ContainerWaitResponse{ + StatusCode: status, + }) +} + +func (s *router) getContainersChanges(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + changes, err := s.daemon.ContainerChanges(vars["name"]) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, changes) +} + +func (s *router) getContainersTop(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + if err := httputils.ParseForm(r); err != nil { + return err + } + + procList, err := s.daemon.ContainerTop(vars["name"], r.Form.Get("ps_args")) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, procList) +} + +func (s *router) postContainerRename(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + name := vars["name"] + newName := r.Form.Get("name") + if err := s.daemon.ContainerRename(name, newName); err != nil { + return err + } + w.WriteHeader(http.StatusNoContent) + return nil +} + +func (s *router) postContainersCreate(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + name := r.Form.Get("name") + + config, hostConfig, err := runconfig.DecodeContainerConfig(r.Body) + if err != nil { + return err + } + version := httputils.VersionFromContext(ctx) + adjustCPUShares := version.LessThan("1.19") + + ccr, err := s.daemon.ContainerCreate(name, config, hostConfig, adjustCPUShares) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusCreated, ccr) +} + +func (s *router) deleteContainers(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + name := vars["name"] + config := &daemon.ContainerRmConfig{ + ForceRemove: httputils.BoolValue(r, "force"), + RemoveVolume: httputils.BoolValue(r, "v"), + RemoveLink: httputils.BoolValue(r, "link"), + } + + if err := s.daemon.ContainerRm(name, config); err != nil { + // Force a 404 for the empty string + if strings.Contains(strings.ToLower(err.Error()), "prefix can't be empty") { + return fmt.Errorf("no such id: \"\"") + } + return err + } + + w.WriteHeader(http.StatusNoContent) + + return nil +} + +func (s *router) postContainersResize(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + height, err := strconv.Atoi(r.Form.Get("h")) + if err != nil { + return err + } + width, err := strconv.Atoi(r.Form.Get("w")) + if err != nil { + return err + } + + return s.daemon.ContainerResize(vars["name"], height, width) +} + +func (s *router) postContainersAttach(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + containerName := vars["name"] + + if !s.daemon.Exists(containerName) { + return derr.ErrorCodeNoSuchContainer.WithArgs(containerName) + } + + inStream, outStream, err := httputils.HijackConnection(w) + if err != nil { + return err + } + defer httputils.CloseStreams(inStream, outStream) + + if _, ok := r.Header["Upgrade"]; ok { + fmt.Fprintf(outStream, "HTTP/1.1 101 UPGRADED\r\nContent-Type: application/vnd.docker.raw-stream\r\nConnection: Upgrade\r\nUpgrade: tcp\r\n\r\n") + } else { + fmt.Fprintf(outStream, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n") + } + + attachWithLogsConfig := &daemon.ContainerAttachWithLogsConfig{ + InStream: inStream, + OutStream: outStream, + UseStdin: httputils.BoolValue(r, "stdin"), + UseStdout: httputils.BoolValue(r, "stdout"), + UseStderr: httputils.BoolValue(r, "stderr"), + Logs: httputils.BoolValue(r, "logs"), + Stream: httputils.BoolValue(r, "stream"), + } + + if err := s.daemon.ContainerAttachWithLogs(containerName, attachWithLogsConfig); err != nil { + fmt.Fprintf(outStream, "Error attaching: %s\n", err) + } + + return nil +} + +func (s *router) wsContainersAttach(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + containerName := vars["name"] + + if !s.daemon.Exists(containerName) { + return derr.ErrorCodeNoSuchContainer.WithArgs(containerName) + } + + h := websocket.Handler(func(ws *websocket.Conn) { + defer ws.Close() + + wsAttachWithLogsConfig := &daemon.ContainerWsAttachWithLogsConfig{ + InStream: ws, + OutStream: ws, + ErrStream: ws, + Logs: httputils.BoolValue(r, "logs"), + Stream: httputils.BoolValue(r, "stream"), + } + + if err := s.daemon.ContainerWsAttachWithLogs(containerName, wsAttachWithLogsConfig); err != nil { + logrus.Errorf("Error attaching websocket: %s", err) + } + }) + ws := websocket.Server{Handler: h, Handshake: nil} + ws.ServeHTTP(w, r) + + return nil +} diff --git a/api/server/router/local/copy.go b/api/server/router/local/copy.go new file mode 100644 index 0000000000..72ceb0a44e --- /dev/null +++ b/api/server/router/local/copy.go @@ -0,0 +1,116 @@ +package local + +import ( + "encoding/base64" + "encoding/json" + "fmt" + "io" + "net/http" + "os" + "strings" + + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "golang.org/x/net/context" +) + +// postContainersCopy is deprecated in favor of getContainersArchive. +func (s *router) postContainersCopy(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + cfg := types.CopyConfig{} + if err := json.NewDecoder(r.Body).Decode(&cfg); err != nil { + return err + } + + if cfg.Resource == "" { + return fmt.Errorf("Path cannot be empty") + } + + data, err := s.daemon.ContainerCopy(vars["name"], cfg.Resource) + if err != nil { + if strings.Contains(strings.ToLower(err.Error()), "no such id") { + w.WriteHeader(http.StatusNotFound) + return nil + } + if os.IsNotExist(err) { + return fmt.Errorf("Could not find the file %s in container %s", cfg.Resource, vars["name"]) + } + return err + } + defer data.Close() + + w.Header().Set("Content-Type", "application/x-tar") + if _, err := io.Copy(w, data); err != nil { + return err + } + + return nil +} + +// // Encode the stat to JSON, base64 encode, and place in a header. +func setContainerPathStatHeader(stat *types.ContainerPathStat, header http.Header) error { + statJSON, err := json.Marshal(stat) + if err != nil { + return err + } + + header.Set( + "X-Docker-Container-Path-Stat", + base64.StdEncoding.EncodeToString(statJSON), + ) + + return nil +} + +func (s *router) headContainersArchive(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + v, err := httputils.ArchiveFormValues(r, vars) + if err != nil { + return err + } + + stat, err := s.daemon.ContainerStatPath(v.Name, v.Path) + if err != nil { + return err + } + + return setContainerPathStatHeader(stat, w.Header()) +} + +func (s *router) getContainersArchive(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + v, err := httputils.ArchiveFormValues(r, vars) + if err != nil { + return err + } + + tarArchive, stat, err := s.daemon.ContainerArchivePath(v.Name, v.Path) + if err != nil { + return err + } + defer tarArchive.Close() + + if err := setContainerPathStatHeader(stat, w.Header()); err != nil { + return err + } + + w.Header().Set("Content-Type", "application/x-tar") + _, err = io.Copy(w, tarArchive) + + return err +} + +func (s *router) putContainersArchive(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + v, err := httputils.ArchiveFormValues(r, vars) + if err != nil { + return err + } + + noOverwriteDirNonDir := httputils.BoolValue(r, "noOverwriteDirNonDir") + return s.daemon.ContainerExtractToDir(v.Name, v.Path, noOverwriteDirNonDir, r.Body) +} diff --git a/api/server/router/local/exec.go b/api/server/router/local/exec.go new file mode 100644 index 0000000000..aaafcd3e29 --- /dev/null +++ b/api/server/router/local/exec.go @@ -0,0 +1,135 @@ +package local + +import ( + "encoding/json" + "fmt" + "io" + "net/http" + "strconv" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/stdcopy" + "github.com/docker/docker/runconfig" + "golang.org/x/net/context" +) + +func (s *router) getExecByID(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter 'id'") + } + + eConfig, err := s.daemon.ContainerExecInspect(vars["id"]) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, eConfig) +} + +func (s *router) postContainerExecCreate(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if err := httputils.CheckForJSON(r); err != nil { + return err + } + name := vars["name"] + + execConfig := &runconfig.ExecConfig{} + if err := json.NewDecoder(r.Body).Decode(execConfig); err != nil { + return err + } + execConfig.Container = name + + if len(execConfig.Cmd) == 0 { + return fmt.Errorf("No exec command specified") + } + + // Register an instance of Exec in container. + id, err := s.daemon.ContainerExecCreate(execConfig) + if err != nil { + logrus.Errorf("Error setting up exec command in container %s: %s", name, err) + return err + } + + return httputils.WriteJSON(w, http.StatusCreated, &types.ContainerExecCreateResponse{ + ID: id, + }) +} + +// TODO(vishh): Refactor the code to avoid having to specify stream config as part of both create and start. +func (s *router) postContainerExecStart(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + var ( + execName = vars["name"] + stdin, inStream io.ReadCloser + stdout, stderr, outStream io.Writer + ) + + execStartCheck := &types.ExecStartCheck{} + if err := json.NewDecoder(r.Body).Decode(execStartCheck); err != nil { + return err + } + + if exists, err := s.daemon.ExecExists(execName); !exists { + return err + } + + if !execStartCheck.Detach { + var err error + // Setting up the streaming http interface. + inStream, outStream, err = httputils.HijackConnection(w) + if err != nil { + return err + } + defer httputils.CloseStreams(inStream, outStream) + + if _, ok := r.Header["Upgrade"]; ok { + fmt.Fprintf(outStream, "HTTP/1.1 101 UPGRADED\r\nContent-Type: application/vnd.docker.raw-stream\r\nConnection: Upgrade\r\nUpgrade: tcp\r\n\r\n") + } else { + fmt.Fprintf(outStream, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n") + } + + stdin = inStream + stdout = outStream + if !execStartCheck.Tty { + stderr = stdcopy.NewStdWriter(outStream, stdcopy.Stderr) + stdout = stdcopy.NewStdWriter(outStream, stdcopy.Stdout) + } + } else { + outStream = w + } + + // Now run the user process in container. + if err := s.daemon.ContainerExecStart(execName, stdin, stdout, stderr); err != nil { + if execStartCheck.Detach { + return err + } + logrus.Errorf("Error running exec in container: %v\n", err) + } + return nil +} + +func (s *router) postContainerExecResize(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + height, err := strconv.Atoi(r.Form.Get("h")) + if err != nil { + return err + } + width, err := strconv.Atoi(r.Form.Get("w")) + if err != nil { + return err + } + + return s.daemon.ContainerExecResize(vars["name"], height, width) +} diff --git a/api/server/router/local/image.go b/api/server/router/local/image.go new file mode 100644 index 0000000000..2558d42316 --- /dev/null +++ b/api/server/router/local/image.go @@ -0,0 +1,524 @@ +package local + +import ( + "encoding/base64" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "github.com/docker/docker/builder" + "github.com/docker/docker/builder/dockerfile" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/daemon/daemonbuilder" + "github.com/docker/docker/graph" + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/ulimit" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" + "golang.org/x/net/context" +) + +func (s *router) postCommit(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + cname := r.Form.Get("container") + + pause := httputils.BoolValue(r, "pause") + version := httputils.VersionFromContext(ctx) + if r.FormValue("pause") == "" && version.GreaterThanOrEqualTo("1.13") { + pause = true + } + + c, _, err := runconfig.DecodeContainerConfig(r.Body) + if err != nil && err != io.EOF { //Do not fail if body is empty. + return err + } + + commitCfg := &dockerfile.CommitConfig{ + Pause: pause, + Repo: r.Form.Get("repo"), + Tag: r.Form.Get("tag"), + Author: r.Form.Get("author"), + Comment: r.Form.Get("comment"), + Changes: r.Form["changes"], + Config: c, + } + + container, err := s.daemon.Get(cname) + if err != nil { + return err + } + + imgID, err := dockerfile.Commit(container, s.daemon, commitCfg) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusCreated, &types.ContainerCommitResponse{ + ID: string(imgID), + }) +} + +// Creates an image from Pull or from Import +func (s *router) postImagesCreate(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + var ( + image = r.Form.Get("fromImage") + repo = r.Form.Get("repo") + tag = r.Form.Get("tag") + message = r.Form.Get("message") + ) + authEncoded := r.Header.Get("X-Registry-Auth") + authConfig := &cliconfig.AuthConfig{} + if authEncoded != "" { + authJSON := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authEncoded)) + if err := json.NewDecoder(authJSON).Decode(authConfig); err != nil { + // for a pull it is not an error if no auth was given + // to increase compatibility with the existing api it is defaulting to be empty + authConfig = &cliconfig.AuthConfig{} + } + } + + var ( + err error + output = ioutils.NewWriteFlusher(w) + ) + defer output.Close() + + w.Header().Set("Content-Type", "application/json") + + if image != "" { //pull + if tag == "" { + image, tag = parsers.ParseRepositoryTag(image) + } + metaHeaders := map[string][]string{} + for k, v := range r.Header { + if strings.HasPrefix(k, "X-Meta-") { + metaHeaders[k] = v + } + } + + imagePullConfig := &graph.ImagePullConfig{ + MetaHeaders: metaHeaders, + AuthConfig: authConfig, + OutStream: output, + } + + err = s.daemon.PullImage(image, tag, imagePullConfig) + } else { //import + if tag == "" { + repo, tag = parsers.ParseRepositoryTag(repo) + } + + src := r.Form.Get("fromSrc") + + // 'err' MUST NOT be defined within this block, we need any error + // generated from the download to be available to the output + // stream processing below + var newConfig *runconfig.Config + newConfig, err = dockerfile.BuildFromConfig(&runconfig.Config{}, r.Form["changes"]) + if err != nil { + return err + } + + err = s.daemon.ImportImage(src, repo, tag, message, r.Body, output, newConfig) + } + if err != nil { + if !output.Flushed() { + return err + } + sf := streamformatter.NewJSONStreamFormatter() + output.Write(sf.FormatError(err)) + } + + return nil +} + +func (s *router) postImagesPush(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + metaHeaders := map[string][]string{} + for k, v := range r.Header { + if strings.HasPrefix(k, "X-Meta-") { + metaHeaders[k] = v + } + } + if err := httputils.ParseForm(r); err != nil { + return err + } + authConfig := &cliconfig.AuthConfig{} + + authEncoded := r.Header.Get("X-Registry-Auth") + if authEncoded != "" { + // the new format is to handle the authConfig as a header + authJSON := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authEncoded)) + if err := json.NewDecoder(authJSON).Decode(authConfig); err != nil { + // to increase compatibility to existing api it is defaulting to be empty + authConfig = &cliconfig.AuthConfig{} + } + } else { + // the old format is supported for compatibility if there was no authConfig header + if err := json.NewDecoder(r.Body).Decode(authConfig); err != nil { + return fmt.Errorf("Bad parameters and missing X-Registry-Auth: %v", err) + } + } + + name := vars["name"] + output := ioutils.NewWriteFlusher(w) + defer output.Close() + imagePushConfig := &graph.ImagePushConfig{ + MetaHeaders: metaHeaders, + AuthConfig: authConfig, + Tag: r.Form.Get("tag"), + OutStream: output, + } + + w.Header().Set("Content-Type", "application/json") + + if err := s.daemon.PushImage(name, imagePushConfig); err != nil { + if !output.Flushed() { + return err + } + sf := streamformatter.NewJSONStreamFormatter() + output.Write(sf.FormatError(err)) + } + return nil +} + +func (s *router) getImagesGet(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + if err := httputils.ParseForm(r); err != nil { + return err + } + + w.Header().Set("Content-Type", "application/x-tar") + + output := ioutils.NewWriteFlusher(w) + defer output.Close() + var names []string + if name, ok := vars["name"]; ok { + names = []string{name} + } else { + names = r.Form["names"] + } + + if err := s.daemon.ExportImage(names, output); err != nil { + if !output.Flushed() { + return err + } + sf := streamformatter.NewJSONStreamFormatter() + output.Write(sf.FormatError(err)) + } + return nil +} + +func (s *router) postImagesLoad(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + return s.daemon.LoadImage(r.Body, w) +} + +func (s *router) deleteImages(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + name := vars["name"] + + if name == "" { + return fmt.Errorf("image name cannot be blank") + } + + force := httputils.BoolValue(r, "force") + prune := !httputils.BoolValue(r, "noprune") + + list, err := s.daemon.ImageDelete(name, force, prune) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, list) +} + +func (s *router) getImagesByName(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + imageInspect, err := s.daemon.LookupImage(vars["name"]) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, imageInspect) +} + +func (s *router) postBuild(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + var ( + authConfigs = map[string]cliconfig.AuthConfig{} + authConfigsEncoded = r.Header.Get("X-Registry-Config") + buildConfig = &dockerfile.Config{} + ) + + if authConfigsEncoded != "" { + authConfigsJSON := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authConfigsEncoded)) + if err := json.NewDecoder(authConfigsJSON).Decode(&authConfigs); err != nil { + // for a pull it is not an error if no auth was given + // to increase compatibility with the existing api it is defaulting + // to be empty. + } + } + + w.Header().Set("Content-Type", "application/json") + + version := httputils.VersionFromContext(ctx) + output := ioutils.NewWriteFlusher(w) + defer output.Close() + sf := streamformatter.NewJSONStreamFormatter() + errf := func(err error) error { + // Do not write the error in the http output if it's still empty. + // This prevents from writing a 200(OK) when there is an interal error. + if !output.Flushed() { + return err + } + _, err = w.Write(sf.FormatError(errors.New(utils.GetErrorMessage(err)))) + if err != nil { + logrus.Warnf("could not write error response: %v", err) + } + return nil + } + + if httputils.BoolValue(r, "forcerm") && version.GreaterThanOrEqualTo("1.12") { + buildConfig.Remove = true + } else if r.FormValue("rm") == "" && version.GreaterThanOrEqualTo("1.12") { + buildConfig.Remove = true + } else { + buildConfig.Remove = httputils.BoolValue(r, "rm") + } + if httputils.BoolValue(r, "pull") && version.GreaterThanOrEqualTo("1.16") { + buildConfig.Pull = true + } + + repoName, tag := parsers.ParseRepositoryTag(r.FormValue("t")) + if repoName != "" { + if err := registry.ValidateRepositoryName(repoName); err != nil { + return errf(err) + } + if len(tag) > 0 { + if err := tags.ValidateTagName(tag); err != nil { + return errf(err) + } + } + } + + buildConfig.DockerfileName = r.FormValue("dockerfile") + buildConfig.Verbose = !httputils.BoolValue(r, "q") + buildConfig.UseCache = !httputils.BoolValue(r, "nocache") + buildConfig.ForceRemove = httputils.BoolValue(r, "forcerm") + buildConfig.MemorySwap = httputils.Int64ValueOrZero(r, "memswap") + buildConfig.Memory = httputils.Int64ValueOrZero(r, "memory") + buildConfig.CPUShares = httputils.Int64ValueOrZero(r, "cpushares") + buildConfig.CPUPeriod = httputils.Int64ValueOrZero(r, "cpuperiod") + buildConfig.CPUQuota = httputils.Int64ValueOrZero(r, "cpuquota") + buildConfig.CPUSetCpus = r.FormValue("cpusetcpus") + buildConfig.CPUSetMems = r.FormValue("cpusetmems") + buildConfig.CgroupParent = r.FormValue("cgroupparent") + + var buildUlimits = []*ulimit.Ulimit{} + ulimitsJSON := r.FormValue("ulimits") + if ulimitsJSON != "" { + if err := json.NewDecoder(strings.NewReader(ulimitsJSON)).Decode(&buildUlimits); err != nil { + return errf(err) + } + buildConfig.Ulimits = buildUlimits + } + + var buildArgs = map[string]string{} + buildArgsJSON := r.FormValue("buildargs") + if buildArgsJSON != "" { + if err := json.NewDecoder(strings.NewReader(buildArgsJSON)).Decode(&buildArgs); err != nil { + return errf(err) + } + buildConfig.BuildArgs = buildArgs + } + + remoteURL := r.FormValue("remote") + + // Currently, only used if context is from a remote url. + // The field `In` is set by DetectContextFromRemoteURL. + // Look at code in DetectContextFromRemoteURL for more information. + pReader := &progressreader.Config{ + // TODO: make progressreader streamformatter-agnostic + Out: output, + Formatter: sf, + Size: r.ContentLength, + NewLines: true, + ID: "Downloading context", + Action: remoteURL, + } + + var ( + context builder.ModifiableContext + dockerfileName string + err error + ) + context, dockerfileName, err = daemonbuilder.DetectContextFromRemoteURL(r.Body, remoteURL, pReader) + if err != nil { + return errf(err) + } + defer func() { + if err := context.Close(); err != nil { + logrus.Debugf("[BUILDER] failed to remove temporary context: %v", err) + } + }() + + uidMaps, gidMaps := s.daemon.GetUIDGIDMaps() + defaultArchiver := &archive.Archiver{ + Untar: chrootarchive.Untar, + UIDMaps: uidMaps, + GIDMaps: gidMaps, + } + docker := daemonbuilder.Docker{s.daemon, output, authConfigs, defaultArchiver} + + b, err := dockerfile.NewBuilder(buildConfig, docker, builder.DockerIgnoreContext{context}, nil) + if err != nil { + return errf(err) + } + b.Stdout = &streamformatter.StdoutFormatter{Writer: output, StreamFormatter: sf} + b.Stderr = &streamformatter.StderrFormatter{Writer: output, StreamFormatter: sf} + + if closeNotifier, ok := w.(http.CloseNotifier); ok { + finished := make(chan struct{}) + defer close(finished) + go func() { + select { + case <-finished: + case <-closeNotifier.CloseNotify(): + logrus.Infof("Client disconnected, cancelling job: build") + b.Cancel() + } + }() + } + + if len(dockerfileName) > 0 { + b.DockerfileName = dockerfileName + } + + imgID, err := b.Build() + if err != nil { + return errf(err) + } + + if repoName != "" { + if err := s.daemon.TagImage(repoName, tag, string(imgID), true); err != nil { + return errf(err) + } + } + + return nil +} + +func (s *router) getImagesJSON(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + // FIXME: The filter parameter could just be a match filter + images, err := s.daemon.ListImages(r.Form.Get("filters"), r.Form.Get("filter"), httputils.BoolValue(r, "all")) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, images) +} + +func (s *router) getImagesHistory(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + name := vars["name"] + history, err := s.daemon.ImageHistory(name) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, history) +} + +func (s *router) postImagesTag(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + repo := r.Form.Get("repo") + tag := r.Form.Get("tag") + name := vars["name"] + force := httputils.BoolValue(r, "force") + if err := s.daemon.TagImage(repo, tag, name, force); err != nil { + return err + } + s.daemon.EventsService.Log("tag", utils.ImageReference(repo, tag), "") + w.WriteHeader(http.StatusCreated) + return nil +} + +func (s *router) getImagesSearch(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + var ( + config *cliconfig.AuthConfig + authEncoded = r.Header.Get("X-Registry-Auth") + headers = map[string][]string{} + ) + + if authEncoded != "" { + authJSON := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authEncoded)) + if err := json.NewDecoder(authJSON).Decode(&config); err != nil { + // for a search it is not an error if no auth was given + // to increase compatibility with the existing api it is defaulting to be empty + config = &cliconfig.AuthConfig{} + } + } + for k, v := range r.Header { + if strings.HasPrefix(k, "X-Meta-") { + headers[k] = v + } + } + query, err := s.daemon.SearchRegistryForImages(r.Form.Get("term"), config, headers) + if err != nil { + return err + } + return httputils.WriteJSON(w, http.StatusOK, query.Results) +} diff --git a/api/server/router/local/info.go b/api/server/router/local/info.go new file mode 100644 index 0000000000..d80c2d439d --- /dev/null +++ b/api/server/router/local/info.go @@ -0,0 +1,142 @@ +package local + +import ( + "encoding/json" + "net/http" + "runtime" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/jsonmessage" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/docker/docker/pkg/parsers/kernel" + "github.com/docker/docker/utils" + "golang.org/x/net/context" +) + +func (s *router) getVersion(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + v := &types.Version{ + Version: dockerversion.VERSION, + APIVersion: api.Version, + GitCommit: dockerversion.GITCOMMIT, + GoVersion: runtime.Version(), + Os: runtime.GOOS, + Arch: runtime.GOARCH, + BuildTime: dockerversion.BUILDTIME, + } + + version := httputils.VersionFromContext(ctx) + + if version.GreaterThanOrEqualTo("1.19") { + v.Experimental = utils.ExperimentalBuild() + } + + if kernelVersion, err := kernel.GetKernelVersion(); err == nil { + v.KernelVersion = kernelVersion.String() + } + + return httputils.WriteJSON(w, http.StatusOK, v) +} + +func (s *router) getInfo(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + info, err := s.daemon.SystemInfo() + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, info) +} + +func (s *router) getEvents(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + since, err := httputils.Int64ValueOrDefault(r, "since", -1) + if err != nil { + return err + } + until, err := httputils.Int64ValueOrDefault(r, "until", -1) + if err != nil { + return err + } + + timer := time.NewTimer(0) + timer.Stop() + if until > 0 { + dur := time.Unix(until, 0).Sub(time.Now()) + timer = time.NewTimer(dur) + } + + ef, err := filters.FromParam(r.Form.Get("filters")) + if err != nil { + return err + } + + w.Header().Set("Content-Type", "application/json") + + // This is to ensure that the HTTP status code is sent immediately, + // so that it will not block the receiver. + w.WriteHeader(http.StatusOK) + if flusher, ok := w.(http.Flusher); ok { + flusher.Flush() + } + + output := ioutils.NewWriteFlusher(w) + defer output.Close() + + enc := json.NewEncoder(output) + d := s.daemon + es := d.EventsService + current, l := es.Subscribe() + defer es.Evict(l) + + eventFilter := d.GetEventFilter(ef) + handleEvent := func(ev *jsonmessage.JSONMessage) error { + if eventFilter.Include(ev) { + if err := enc.Encode(ev); err != nil { + return err + } + } + return nil + } + + if since == -1 { + current = nil + } + for _, ev := range current { + if ev.Time < since { + continue + } + if err := handleEvent(ev); err != nil { + return err + } + } + + var closeNotify <-chan bool + if closeNotifier, ok := w.(http.CloseNotifier); ok { + closeNotify = closeNotifier.CloseNotify() + } + + for { + select { + case ev := <-l: + jev, ok := ev.(*jsonmessage.JSONMessage) + if !ok { + continue + } + if err := handleEvent(jev); err != nil { + return err + } + case <-timer.C: + return nil + case <-closeNotify: + logrus.Debug("Client disconnected, stop sending events") + return nil + } + } +} diff --git a/api/server/router/local/inspect.go b/api/server/router/local/inspect.go new file mode 100644 index 0000000000..b9bf697083 --- /dev/null +++ b/api/server/router/local/inspect.go @@ -0,0 +1,37 @@ +package local + +import ( + "fmt" + "net/http" + + "github.com/docker/docker/api/server/httputils" + "golang.org/x/net/context" +) + +// getContainersByName inspects containers configuration and serializes it as json. +func (s *router) getContainersByName(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + displaySize := httputils.BoolValue(r, "size") + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + var json interface{} + var err error + + version := httputils.VersionFromContext(ctx) + + switch { + case version.LessThan("1.20"): + json, err = s.daemon.ContainerInspectPre120(vars["name"]) + case version.Equal("1.20"): + json, err = s.daemon.ContainerInspect120(vars["name"]) + default: + json, err = s.daemon.ContainerInspect(vars["name"], displaySize) + } + + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusOK, json) +} diff --git a/api/server/router/local/local.go b/api/server/router/local/local.go new file mode 100644 index 0000000000..c73e852a22 --- /dev/null +++ b/api/server/router/local/local.go @@ -0,0 +1,162 @@ +package local + +import ( + "net/http" + + "golang.org/x/net/context" + + "github.com/docker/docker/api/server/httputils" + dkrouter "github.com/docker/docker/api/server/router" + "github.com/docker/docker/daemon" +) + +// router is a docker router that talks with the local docker daemon. +type router struct { + daemon *daemon.Daemon + routes []dkrouter.Route +} + +// localRoute defines an individual API route to connect with the docker daemon. +// It implements router.Route. +type localRoute struct { + method string + path string + handler httputils.APIFunc +} + +// Handler returns the APIFunc to let the server wrap it in middlewares +func (l localRoute) Handler() httputils.APIFunc { + return l.handler +} + +// Method returns the http method that the route responds to. +func (l localRoute) Method() string { + return l.method +} + +// Path returns the subpath where the route responds to. +func (l localRoute) Path() string { + return l.path +} + +// NewRoute initialies a new local route for the reouter +func NewRoute(method, path string, handler httputils.APIFunc) dkrouter.Route { + return localRoute{method, path, handler} +} + +// NewGetRoute initializes a new route with the http method GET. +func NewGetRoute(path string, handler httputils.APIFunc) dkrouter.Route { + return NewRoute("GET", path, handler) +} + +// NewPostRoute initializes a new route with the http method POST. +func NewPostRoute(path string, handler httputils.APIFunc) dkrouter.Route { + return NewRoute("POST", path, handler) +} + +// NewPutRoute initializes a new route with the http method PUT. +func NewPutRoute(path string, handler httputils.APIFunc) dkrouter.Route { + return NewRoute("PUT", path, handler) +} + +// NewDeleteRoute initializes a new route with the http method DELETE. +func NewDeleteRoute(path string, handler httputils.APIFunc) dkrouter.Route { + return NewRoute("DELETE", path, handler) +} + +// NewOptionsRoute initializes a new route with the http method OPTIONS +func NewOptionsRoute(path string, handler httputils.APIFunc) dkrouter.Route { + return NewRoute("OPTIONS", path, handler) +} + +// NewHeadRoute initializes a new route with the http method HEAD. +func NewHeadRoute(path string, handler httputils.APIFunc) dkrouter.Route { + return NewRoute("HEAD", path, handler) +} + +// NewRouter initializes a local router with a new daemon. +func NewRouter(daemon *daemon.Daemon) dkrouter.Router { + r := &router{ + daemon: daemon, + } + r.initRoutes() + return r +} + +// Routes returns the list of routes registered in the router. +func (r *router) Routes() []dkrouter.Route { + return r.routes +} + +// initRoutes initializes the routes in this router +func (r *router) initRoutes() { + r.routes = []dkrouter.Route{ + // HEAD + NewHeadRoute("/containers/{name:.*}/archive", r.headContainersArchive), + // OPTIONS + NewOptionsRoute("/", optionsHandler), + // GET + NewGetRoute("/_ping", pingHandler), + NewGetRoute("/events", r.getEvents), + NewGetRoute("/info", r.getInfo), + NewGetRoute("/version", r.getVersion), + NewGetRoute("/images/json", r.getImagesJSON), + NewGetRoute("/images/search", r.getImagesSearch), + NewGetRoute("/images/get", r.getImagesGet), + NewGetRoute("/images/{name:.*}/get", r.getImagesGet), + NewGetRoute("/images/{name:.*}/history", r.getImagesHistory), + NewGetRoute("/images/{name:.*}/json", r.getImagesByName), + NewGetRoute("/containers/json", r.getContainersJSON), + NewGetRoute("/containers/{name:.*}/export", r.getContainersExport), + NewGetRoute("/containers/{name:.*}/changes", r.getContainersChanges), + NewGetRoute("/containers/{name:.*}/json", r.getContainersByName), + NewGetRoute("/containers/{name:.*}/top", r.getContainersTop), + NewGetRoute("/containers/{name:.*}/logs", r.getContainersLogs), + NewGetRoute("/containers/{name:.*}/stats", r.getContainersStats), + NewGetRoute("/containers/{name:.*}/attach/ws", r.wsContainersAttach), + NewGetRoute("/exec/{id:.*}/json", r.getExecByID), + NewGetRoute("/containers/{name:.*}/archive", r.getContainersArchive), + NewGetRoute("/volumes", r.getVolumesList), + NewGetRoute("/volumes/{name:.*}", r.getVolumeByName), + // POST + NewPostRoute("/auth", r.postAuth), + NewPostRoute("/commit", r.postCommit), + NewPostRoute("/build", r.postBuild), + NewPostRoute("/images/create", r.postImagesCreate), + NewPostRoute("/images/load", r.postImagesLoad), + NewPostRoute("/images/{name:.*}/push", r.postImagesPush), + NewPostRoute("/images/{name:.*}/tag", r.postImagesTag), + NewPostRoute("/containers/create", r.postContainersCreate), + NewPostRoute("/containers/{name:.*}/kill", r.postContainersKill), + NewPostRoute("/containers/{name:.*}/pause", r.postContainersPause), + NewPostRoute("/containers/{name:.*}/unpause", r.postContainersUnpause), + NewPostRoute("/containers/{name:.*}/restart", r.postContainersRestart), + NewPostRoute("/containers/{name:.*}/start", r.postContainersStart), + NewPostRoute("/containers/{name:.*}/stop", r.postContainersStop), + NewPostRoute("/containers/{name:.*}/wait", r.postContainersWait), + NewPostRoute("/containers/{name:.*}/resize", r.postContainersResize), + NewPostRoute("/containers/{name:.*}/attach", r.postContainersAttach), + NewPostRoute("/containers/{name:.*}/copy", r.postContainersCopy), + NewPostRoute("/containers/{name:.*}/exec", r.postContainerExecCreate), + NewPostRoute("/exec/{name:.*}/start", r.postContainerExecStart), + NewPostRoute("/exec/{name:.*}/resize", r.postContainerExecResize), + NewPostRoute("/containers/{name:.*}/rename", r.postContainerRename), + NewPostRoute("/volumes/create", r.postVolumesCreate), + // PUT + NewPutRoute("/containers/{name:.*}/archive", r.putContainersArchive), + // DELETE + NewDeleteRoute("/containers/{name:.*}", r.deleteContainers), + NewDeleteRoute("/images/{name:.*}", r.deleteImages), + NewDeleteRoute("/volumes/{name:.*}", r.deleteVolumes), + } +} + +func optionsHandler(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + w.WriteHeader(http.StatusOK) + return nil +} + +func pingHandler(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + _, err := w.Write([]byte{'O', 'K'}) + return err +} diff --git a/api/server/router/local/volume.go b/api/server/router/local/volume.go new file mode 100644 index 0000000000..614bec7448 --- /dev/null +++ b/api/server/router/local/volume.go @@ -0,0 +1,66 @@ +package local + +import ( + "encoding/json" + "net/http" + + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "golang.org/x/net/context" +) + +func (s *router) getVolumesList(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + volumes, err := s.daemon.Volumes(r.Form.Get("filters")) + if err != nil { + return err + } + return httputils.WriteJSON(w, http.StatusOK, &types.VolumesListResponse{Volumes: volumes}) +} + +func (s *router) getVolumeByName(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + v, err := s.daemon.VolumeInspect(vars["name"]) + if err != nil { + return err + } + return httputils.WriteJSON(w, http.StatusOK, v) +} + +func (s *router) postVolumesCreate(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + var req types.VolumeCreateRequest + if err := json.NewDecoder(r.Body).Decode(&req); err != nil { + return err + } + + volume, err := s.daemon.VolumeCreate(req.Name, req.Driver, req.DriverOpts) + if err != nil { + return err + } + return httputils.WriteJSON(w, http.StatusCreated, volume) +} + +func (s *router) deleteVolumes(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + if err := s.daemon.VolumeRm(vars["name"]); err != nil { + return err + } + w.WriteHeader(http.StatusNoContent) + return nil +} diff --git a/api/server/router/network/network.go b/api/server/router/network/network.go new file mode 100644 index 0000000000..b301820f77 --- /dev/null +++ b/api/server/router/network/network.go @@ -0,0 +1,57 @@ +package network + +import ( + "net/http" + + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/server/router" + "github.com/docker/docker/api/server/router/local" + "github.com/docker/docker/daemon" + "github.com/docker/docker/errors" + "golang.org/x/net/context" +) + +// networkRouter is a router to talk with the network controller +type networkRouter struct { + daemon *daemon.Daemon + routes []router.Route +} + +// NewRouter initializes a new network router +func NewRouter(d *daemon.Daemon) router.Router { + r := &networkRouter{ + daemon: d, + } + r.initRoutes() + return r +} + +// Routes returns the available routes to the network controller +func (r *networkRouter) Routes() []router.Route { + return r.routes +} + +func (r *networkRouter) initRoutes() { + r.routes = []router.Route{ + // GET + local.NewGetRoute("/networks", r.controllerEnabledMiddleware(r.getNetworksList)), + local.NewGetRoute("/networks/{id:.*}", r.controllerEnabledMiddleware(r.getNetwork)), + // POST + local.NewPostRoute("/networks/create", r.controllerEnabledMiddleware(r.postNetworkCreate)), + local.NewPostRoute("/networks/{id:.*}/connect", r.controllerEnabledMiddleware(r.postNetworkConnect)), + local.NewPostRoute("/networks/{id:.*}/disconnect", r.controllerEnabledMiddleware(r.postNetworkDisconnect)), + // DELETE + local.NewDeleteRoute("/networks/{id:.*}", r.controllerEnabledMiddleware(r.deleteNetwork)), + } +} + +func (r *networkRouter) controllerEnabledMiddleware(handler httputils.APIFunc) httputils.APIFunc { + if r.daemon.NetworkControllerEnabled() { + return handler + } + return networkControllerDisabled +} + +func networkControllerDisabled(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + return errors.ErrorNetworkControllerNotEnabled.WithArgs() +} diff --git a/api/server/router/network/network_routes.go b/api/server/router/network/network_routes.go new file mode 100644 index 0000000000..cac259c5ce --- /dev/null +++ b/api/server/router/network/network_routes.go @@ -0,0 +1,266 @@ +package network + +import ( + "encoding/json" + "fmt" + "net/http" + + "golang.org/x/net/context" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/types" + "github.com/docker/docker/daemon" + "github.com/docker/docker/daemon/network" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/docker/docker/runconfig" + "github.com/docker/libnetwork" +) + +func (n *networkRouter) getNetworksList(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + filter := r.Form.Get("filters") + netFilters, err := filters.FromParam(filter) + if err != nil { + return err + } + + list := []*types.NetworkResource{} + var nameFilter, idFilter bool + var names, ids []string + if names, nameFilter = netFilters["name"]; nameFilter { + for _, name := range names { + if nw, err := n.daemon.GetNetwork(name, daemon.NetworkByName); err == nil { + list = append(list, buildNetworkResource(nw)) + } else { + logrus.Errorf("failed to get network for filter=%s : %v", name, err) + } + } + } + + if ids, idFilter = netFilters["id"]; idFilter { + for _, id := range ids { + for _, nw := range n.daemon.GetNetworksByID(id) { + list = append(list, buildNetworkResource(nw)) + } + } + } + + if !nameFilter && !idFilter { + nwList := n.daemon.GetNetworksByID("") + for _, nw := range nwList { + list = append(list, buildNetworkResource(nw)) + } + } + return httputils.WriteJSON(w, http.StatusOK, list) +} + +func (n *networkRouter) getNetwork(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + nw, err := n.daemon.FindNetwork(vars["id"]) + if err != nil { + return err + } + return httputils.WriteJSON(w, http.StatusOK, buildNetworkResource(nw)) +} + +func (n *networkRouter) postNetworkCreate(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + var create types.NetworkCreate + var warning string + + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + if err := json.NewDecoder(r.Body).Decode(&create); err != nil { + return err + } + + if runconfig.IsPreDefinedNetwork(create.Name) { + return httputils.WriteJSON(w, http.StatusForbidden, + fmt.Sprintf("%s is a pre-defined network and cannot be created", create.Name)) + } + + nw, err := n.daemon.GetNetwork(create.Name, daemon.NetworkByName) + if _, ok := err.(libnetwork.ErrNoSuchNetwork); err != nil && !ok { + return err + } + if nw != nil { + if create.CheckDuplicate { + return libnetwork.NetworkNameError(create.Name) + } + warning = fmt.Sprintf("Network with name %s (id : %s) already exists", nw.Name(), nw.ID()) + } + + nw, err = n.daemon.CreateNetwork(create.Name, create.Driver, create.IPAM, create.Options) + if err != nil { + return err + } + + return httputils.WriteJSON(w, http.StatusCreated, &types.NetworkCreateResponse{ + ID: nw.ID(), + Warning: warning, + }) +} + +func (n *networkRouter) postNetworkConnect(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + var connect types.NetworkConnect + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + if err := json.NewDecoder(r.Body).Decode(&connect); err != nil { + return err + } + + nw, err := n.daemon.FindNetwork(vars["id"]) + if err != nil { + return err + } + + container, err := n.daemon.Get(connect.Container) + if err != nil { + return fmt.Errorf("invalid container %s : %v", container, err) + } + return container.ConnectToNetwork(nw.Name()) +} + +func (n *networkRouter) postNetworkDisconnect(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + var disconnect types.NetworkDisconnect + if err := httputils.ParseForm(r); err != nil { + return err + } + + if err := httputils.CheckForJSON(r); err != nil { + return err + } + + if err := json.NewDecoder(r.Body).Decode(&disconnect); err != nil { + return err + } + + nw, err := n.daemon.FindNetwork(vars["id"]) + if err != nil { + return err + } + + container, err := n.daemon.Get(disconnect.Container) + if err != nil { + return fmt.Errorf("invalid container %s : %v", container, err) + } + return container.DisconnectFromNetwork(nw) +} + +func (n *networkRouter) deleteNetwork(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := httputils.ParseForm(r); err != nil { + return err + } + + nw, err := n.daemon.FindNetwork(vars["id"]) + if err != nil { + return err + } + + if runconfig.IsPreDefinedNetwork(nw.Name()) { + return httputils.WriteJSON(w, http.StatusForbidden, + fmt.Sprintf("%s is a pre-defined network and cannot be removed", nw.Name())) + } + + return nw.Delete() +} + +func buildNetworkResource(nw libnetwork.Network) *types.NetworkResource { + r := &types.NetworkResource{} + if nw == nil { + return r + } + + r.Name = nw.Name() + r.ID = nw.ID() + r.Scope = nw.Info().Scope() + r.Driver = nw.Type() + r.Options = nw.Info().DriverOptions() + r.Containers = make(map[string]types.EndpointResource) + buildIpamResources(r, nw) + + epl := nw.Endpoints() + for _, e := range epl { + ei := e.Info() + if ei == nil { + continue + } + sb := ei.Sandbox() + if sb == nil { + continue + } + + r.Containers[sb.ContainerID()] = buildEndpointResource(e) + } + return r +} + +func buildIpamResources(r *types.NetworkResource, nw libnetwork.Network) { + id, ipv4conf, ipv6conf := nw.Info().IpamConfig() + + r.IPAM.Driver = id + + r.IPAM.Config = []network.IPAMConfig{} + for _, ip4 := range ipv4conf { + iData := network.IPAMConfig{} + iData.Subnet = ip4.PreferredPool + iData.IPRange = ip4.SubPool + iData.Gateway = ip4.Gateway + iData.AuxAddress = ip4.AuxAddresses + r.IPAM.Config = append(r.IPAM.Config, iData) + } + + for _, ip6 := range ipv6conf { + iData := network.IPAMConfig{} + iData.Subnet = ip6.PreferredPool + iData.IPRange = ip6.SubPool + iData.Gateway = ip6.Gateway + iData.AuxAddress = ip6.AuxAddresses + r.IPAM.Config = append(r.IPAM.Config, iData) + } +} + +func buildEndpointResource(e libnetwork.Endpoint) types.EndpointResource { + er := types.EndpointResource{} + if e == nil { + return er + } + + er.EndpointID = e.ID() + ei := e.Info() + if ei == nil { + return er + } + + if iface := ei.Iface(); iface != nil { + if mac := iface.MacAddress(); mac != nil { + er.MacAddress = mac.String() + } + if ip := iface.Address(); ip != nil && len(ip.IP) > 0 { + er.IPv4Address = ip.String() + } + + if ipv6 := iface.AddressIPv6(); ipv6 != nil && len(ipv6.IP) > 0 { + er.IPv6Address = ipv6.String() + } + } + return er +} diff --git a/api/server/router/router.go b/api/server/router/router.go new file mode 100644 index 0000000000..f3efa82fa6 --- /dev/null +++ b/api/server/router/router.go @@ -0,0 +1,18 @@ +package router + +import "github.com/docker/docker/api/server/httputils" + +// Router defines an interface to specify a group of routes to add the the docker server. +type Router interface { + Routes() []Route +} + +// Route defines an individual API route in the docker server. +type Route interface { + // Handler returns the raw function to create the http handler. + Handler() httputils.APIFunc + // Method returns the http method that the route responds to. + Method() string + // Path returns the subpath where the route responds to. + Path() string +} diff --git a/api/server/server.go b/api/server/server.go new file mode 100644 index 0000000000..28fbd6eea0 --- /dev/null +++ b/api/server/server.go @@ -0,0 +1,211 @@ +package server + +import ( + "crypto/tls" + "net" + "net/http" + "os" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/server/httputils" + "github.com/docker/docker/api/server/router" + "github.com/docker/docker/api/server/router/local" + "github.com/docker/docker/api/server/router/network" + "github.com/docker/docker/daemon" + "github.com/docker/docker/pkg/sockets" + "github.com/docker/docker/utils" + "github.com/gorilla/mux" + "golang.org/x/net/context" +) + +// versionMatcher defines a variable matcher to be parsed by the router +// when a request is about to be served. +const versionMatcher = "/v{version:[0-9.]+}" + +// Config provides the configuration for the API server +type Config struct { + Logging bool + EnableCors bool + CorsHeaders string + Version string + SocketGroup string + TLSConfig *tls.Config + Addrs []Addr +} + +// Server contains instance details for the server +type Server struct { + cfg *Config + start chan struct{} + servers []*HTTPServer + routers []router.Router +} + +// Addr contains string representation of address and its protocol (tcp, unix...). +type Addr struct { + Proto string + Addr string +} + +// New returns a new instance of the server based on the specified configuration. +// It allocates resources which will be needed for ServeAPI(ports, unix-sockets). +func New(cfg *Config) (*Server, error) { + s := &Server{ + cfg: cfg, + start: make(chan struct{}), + } + for _, addr := range cfg.Addrs { + srv, err := s.newServer(addr.Proto, addr.Addr) + if err != nil { + return nil, err + } + logrus.Debugf("Server created for HTTP on %s (%s)", addr.Proto, addr.Addr) + s.servers = append(s.servers, srv...) + } + return s, nil +} + +// Close closes servers and thus stop receiving requests +func (s *Server) Close() { + for _, srv := range s.servers { + if err := srv.Close(); err != nil { + logrus.Error(err) + } + } +} + +// ServeAPI loops through all initialized servers and spawns goroutine +// with Serve() method for each. +func (s *Server) ServeAPI() error { + var chErrors = make(chan error, len(s.servers)) + for _, srv := range s.servers { + go func(srv *HTTPServer) { + var err error + logrus.Infof("API listen on %s", srv.l.Addr()) + if err = srv.Serve(); err != nil && strings.Contains(err.Error(), "use of closed network connection") { + err = nil + } + chErrors <- err + }(srv) + } + + for i := 0; i < len(s.servers); i++ { + err := <-chErrors + if err != nil { + return err + } + } + + return nil +} + +// HTTPServer contains an instance of http server and the listener. +// srv *http.Server, contains configuration to create a http server and a mux router with all api end points. +// l net.Listener, is a TCP or Socket listener that dispatches incoming request to the router. +type HTTPServer struct { + srv *http.Server + l net.Listener +} + +// Serve starts listening for inbound requests. +func (s *HTTPServer) Serve() error { + return s.srv.Serve(s.l) +} + +// Close closes the HTTPServer from listening for the inbound requests. +func (s *HTTPServer) Close() error { + return s.l.Close() +} + +func writeCorsHeaders(w http.ResponseWriter, r *http.Request, corsHeaders string) { + logrus.Debugf("CORS header is enabled and set to: %s", corsHeaders) + w.Header().Add("Access-Control-Allow-Origin", corsHeaders) + w.Header().Add("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept, X-Registry-Auth") + w.Header().Add("Access-Control-Allow-Methods", "HEAD, GET, POST, DELETE, PUT, OPTIONS") +} + +func (s *Server) initTCPSocket(addr string) (l net.Listener, err error) { + if s.cfg.TLSConfig == nil || s.cfg.TLSConfig.ClientAuth != tls.RequireAndVerifyClientCert { + logrus.Warn("/!\\ DON'T BIND ON ANY IP ADDRESS WITHOUT setting -tlsverify IF YOU DON'T KNOW WHAT YOU'RE DOING /!\\") + } + if l, err = sockets.NewTCPSocket(addr, s.cfg.TLSConfig, s.start); err != nil { + return nil, err + } + if err := allocateDaemonPort(addr); err != nil { + return nil, err + } + return +} + +func (s *Server) makeHTTPHandler(handler httputils.APIFunc) http.HandlerFunc { + return func(w http.ResponseWriter, r *http.Request) { + // log the handler call + logrus.Debugf("Calling %s %s", r.Method, r.URL.Path) + + // Define the context that we'll pass around to share info + // like the docker-request-id. + // + // The 'context' will be used for global data that should + // apply to all requests. Data that is specific to the + // immediate function being called should still be passed + // as 'args' on the function call. + ctx := context.Background() + handlerFunc := s.handleWithGlobalMiddlewares(handler) + + if err := handlerFunc(ctx, w, r, mux.Vars(r)); err != nil { + logrus.Errorf("Handler for %s %s returned error: %s", r.Method, r.URL.Path, utils.GetErrorMessage(err)) + httputils.WriteError(w, err) + } + } +} + +// InitRouters initializes a list of routers for the server. +// Sets those routers as Handler for each server. +func (s *Server) InitRouters(d *daemon.Daemon) { + s.addRouter(local.NewRouter(d)) + s.addRouter(network.NewRouter(d)) + + for _, srv := range s.servers { + srv.srv.Handler = s.CreateMux() + } +} + +// addRouter adds a new router to the server. +func (s *Server) addRouter(r router.Router) { + s.routers = append(s.routers, r) +} + +// CreateMux initializes the main router the server uses. +// we keep enableCors just for legacy usage, need to be removed in the future +func (s *Server) CreateMux() *mux.Router { + m := mux.NewRouter() + if os.Getenv("DEBUG") != "" { + profilerSetup(m, "/debug/") + } + + logrus.Debugf("Registering routers") + for _, apiRouter := range s.routers { + for _, r := range apiRouter.Routes() { + f := s.makeHTTPHandler(r.Handler()) + + logrus.Debugf("Registering %s, %s", r.Method(), r.Path()) + m.Path(versionMatcher + r.Path()).Methods(r.Method()).Handler(f) + m.Path(r.Path()).Methods(r.Method()).Handler(f) + } + } + + return m +} + +// AcceptConnections allows clients to connect to the API server. +// Referenced Daemon is notified about this server, and waits for the +// daemon acknowledgement before the incoming connections are accepted. +func (s *Server) AcceptConnections() { + // close the lock so the listeners start accepting connections + select { + case <-s.start: + default: + close(s.start) + } +} diff --git a/api/server/server_test.go b/api/server/server_test.go new file mode 100644 index 0000000000..f3256c3160 --- /dev/null +++ b/api/server/server_test.go @@ -0,0 +1,34 @@ +package server + +import ( + "net/http" + "net/http/httptest" + "testing" + + "github.com/docker/docker/api/server/httputils" + + "golang.org/x/net/context" +) + +func TestMiddlewares(t *testing.T) { + cfg := &Config{} + srv := &Server{ + cfg: cfg, + } + + req, _ := http.NewRequest("GET", "/containers/json", nil) + resp := httptest.NewRecorder() + ctx := context.Background() + + localHandler := func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if httputils.VersionFromContext(ctx) == "" { + t.Fatalf("Expected version, got empty string") + } + return nil + } + + handlerFunc := srv.handleWithGlobalMiddlewares(localHandler) + if err := handlerFunc(ctx, resp, req, map[string]string{}); err != nil { + t.Fatal(err) + } +} diff --git a/api/server/server_unix.go b/api/server/server_unix.go new file mode 100644 index 0000000000..c3d4def870 --- /dev/null +++ b/api/server/server_unix.go @@ -0,0 +1,123 @@ +// +build freebsd linux + +package server + +import ( + "fmt" + "net" + "net/http" + "strconv" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/sockets" + "github.com/docker/libnetwork/portallocator" + + systemdActivation "github.com/coreos/go-systemd/activation" +) + +// newServer sets up the required HTTPServers and does protocol specific checking. +// newServer does not set any muxers, you should set it later to Handler field +func (s *Server) newServer(proto, addr string) ([]*HTTPServer, error) { + var ( + err error + ls []net.Listener + ) + switch proto { + case "fd": + ls, err = listenFD(addr) + if err != nil { + return nil, err + } + case "tcp": + l, err := s.initTCPSocket(addr) + if err != nil { + return nil, err + } + ls = append(ls, l) + case "unix": + l, err := sockets.NewUnixSocket(addr, s.cfg.SocketGroup, s.start) + if err != nil { + return nil, err + } + ls = append(ls, l) + default: + return nil, fmt.Errorf("Invalid protocol format: %q", proto) + } + var res []*HTTPServer + for _, l := range ls { + res = append(res, &HTTPServer{ + &http.Server{ + Addr: addr, + }, + l, + }) + } + return res, nil +} + +func allocateDaemonPort(addr string) error { + host, port, err := net.SplitHostPort(addr) + if err != nil { + return err + } + + intPort, err := strconv.Atoi(port) + if err != nil { + return err + } + + var hostIPs []net.IP + if parsedIP := net.ParseIP(host); parsedIP != nil { + hostIPs = append(hostIPs, parsedIP) + } else if hostIPs, err = net.LookupIP(host); err != nil { + return fmt.Errorf("failed to lookup %s address in host specification", host) + } + + pa := portallocator.Get() + for _, hostIP := range hostIPs { + if _, err := pa.RequestPort(hostIP, "tcp", intPort); err != nil { + return fmt.Errorf("failed to allocate daemon listening port %d (err: %v)", intPort, err) + } + } + return nil +} + +// listenFD returns the specified socket activated files as a slice of +// net.Listeners or all of the activated files if "*" is given. +func listenFD(addr string) ([]net.Listener, error) { + // socket activation + listeners, err := systemdActivation.Listeners(false) + if err != nil { + return nil, err + } + + if len(listeners) == 0 { + return nil, fmt.Errorf("No sockets found") + } + + // default to all fds just like unix:// and tcp:// + if addr == "" || addr == "*" { + return listeners, nil + } + + fdNum, err := strconv.Atoi(addr) + if err != nil { + return nil, fmt.Errorf("failed to parse systemd address, should be number: %v", err) + } + fdOffset := fdNum - 3 + if len(listeners) < int(fdOffset)+1 { + return nil, fmt.Errorf("Too few socket activated files passed in") + } + if listeners[fdOffset] == nil { + return nil, fmt.Errorf("failed to listen on systemd activated file at fd %d", fdOffset+3) + } + for i, ls := range listeners { + if i == fdOffset || ls == nil { + continue + } + if err := ls.Close(); err != nil { + logrus.Errorf("Failed to close systemd activated file at fd %d: %v", fdOffset+3, err) + } + } + return []net.Listener{listeners[fdOffset]}, nil +} diff --git a/api/server/server_windows.go b/api/server/server_windows.go new file mode 100644 index 0000000000..826dd2e008 --- /dev/null +++ b/api/server/server_windows.go @@ -0,0 +1,43 @@ +// +build windows + +package server + +import ( + "errors" + "net" + "net/http" +) + +// NewServer sets up the required Server and does protocol specific checking. +func (s *Server) newServer(proto, addr string) ([]*HTTPServer, error) { + var ( + ls []net.Listener + ) + switch proto { + case "tcp": + l, err := s.initTCPSocket(addr) + if err != nil { + return nil, err + } + ls = append(ls, l) + + default: + return nil, errors.New("Invalid protocol format. Windows only supports tcp.") + } + + var res []*HTTPServer + for _, l := range ls { + res = append(res, &HTTPServer{ + &http.Server{ + Addr: addr, + }, + l, + }) + } + return res, nil + +} + +func allocateDaemonPort(addr string) error { + return nil +} diff --git a/api/types/stats.go b/api/types/stats.go new file mode 100644 index 0000000000..ecc144f609 --- /dev/null +++ b/api/types/stats.go @@ -0,0 +1,105 @@ +// Package types is used for API stability in the types and response to the +// consumers of the API stats endpoint. +package types + +import "time" + +// ThrottlingData stores CPU throttling stats of one running container +type ThrottlingData struct { + // Number of periods with throttling active + Periods uint64 `json:"periods"` + // Number of periods when the container hit its throttling limit. + ThrottledPeriods uint64 `json:"throttled_periods"` + // Aggregate time the container was throttled for in nanoseconds. + ThrottledTime uint64 `json:"throttled_time"` +} + +// CPUUsage stores All CPU stats aggregated since container inception. +type CPUUsage struct { + // Total CPU time consumed. + // Units: nanoseconds. + TotalUsage uint64 `json:"total_usage"` + // Total CPU time consumed per core. + // Units: nanoseconds. + PercpuUsage []uint64 `json:"percpu_usage"` + // Time spent by tasks of the cgroup in kernel mode. + // Units: nanoseconds. + UsageInKernelmode uint64 `json:"usage_in_kernelmode"` + // Time spent by tasks of the cgroup in user mode. + // Units: nanoseconds. + UsageInUsermode uint64 `json:"usage_in_usermode"` +} + +// CPUStats aggregates and wraps all CPU related info of container +type CPUStats struct { + CPUUsage CPUUsage `json:"cpu_usage"` + SystemUsage uint64 `json:"system_cpu_usage"` + ThrottlingData ThrottlingData `json:"throttling_data,omitempty"` +} + +// MemoryStats aggregates All memory stats since container inception +type MemoryStats struct { + // current res_counter usage for memory + Usage uint64 `json:"usage"` + // maximum usage ever recorded. + MaxUsage uint64 `json:"max_usage"` + // TODO(vishh): Export these as stronger types. + // all the stats exported via memory.stat. + Stats map[string]uint64 `json:"stats"` + // number of times memory usage hits limits. + Failcnt uint64 `json:"failcnt"` + Limit uint64 `json:"limit"` +} + +// BlkioStatEntry is one small entity to store a piece of Blkio stats +// TODO Windows: This can be factored out +type BlkioStatEntry struct { + Major uint64 `json:"major"` + Minor uint64 `json:"minor"` + Op string `json:"op"` + Value uint64 `json:"value"` +} + +// BlkioStats stores All IO service stats for data read and write +// TODO Windows: This can be factored out +type BlkioStats struct { + // number of bytes tranferred to and from the block device + IoServiceBytesRecursive []BlkioStatEntry `json:"io_service_bytes_recursive"` + IoServicedRecursive []BlkioStatEntry `json:"io_serviced_recursive"` + IoQueuedRecursive []BlkioStatEntry `json:"io_queue_recursive"` + IoServiceTimeRecursive []BlkioStatEntry `json:"io_service_time_recursive"` + IoWaitTimeRecursive []BlkioStatEntry `json:"io_wait_time_recursive"` + IoMergedRecursive []BlkioStatEntry `json:"io_merged_recursive"` + IoTimeRecursive []BlkioStatEntry `json:"io_time_recursive"` + SectorsRecursive []BlkioStatEntry `json:"sectors_recursive"` +} + +// NetworkStats aggregates All network stats of one container +// TODO Windows: This will require refactoring +type NetworkStats struct { + RxBytes uint64 `json:"rx_bytes"` + RxPackets uint64 `json:"rx_packets"` + RxErrors uint64 `json:"rx_errors"` + RxDropped uint64 `json:"rx_dropped"` + TxBytes uint64 `json:"tx_bytes"` + TxPackets uint64 `json:"tx_packets"` + TxErrors uint64 `json:"tx_errors"` + TxDropped uint64 `json:"tx_dropped"` +} + +// Stats is Ultimate struct aggregating all types of stats of one container +type Stats struct { + Read time.Time `json:"read"` + PreCPUStats CPUStats `json:"precpu_stats,omitempty"` + CPUStats CPUStats `json:"cpu_stats,omitempty"` + MemoryStats MemoryStats `json:"memory_stats,omitempty"` + BlkioStats BlkioStats `json:"blkio_stats,omitempty"` +} + +// StatsJSON is newly used Networks +type StatsJSON struct { + Stats + + // Networks request version >=1.21 + Networks map[string]NetworkStats `json:"networks,omitempty"` +} diff --git a/api/types/types.go b/api/types/types.go new file mode 100644 index 0000000000..ae2057df0c --- /dev/null +++ b/api/types/types.go @@ -0,0 +1,393 @@ +package types + +import ( + "os" + "time" + + "github.com/docker/docker/daemon/network" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/version" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" +) + +// ContainerCreateResponse contains the information returned to a client on the +// creation of a new container. +type ContainerCreateResponse struct { + // ID is the ID of the created container. + ID string `json:"Id"` + + // Warnings are any warnings encountered during the creation of the container. + Warnings []string `json:"Warnings"` +} + +// ContainerExecCreateResponse contains response of Remote API: +// POST "/containers/{name:.*}/exec" +type ContainerExecCreateResponse struct { + // ID is the exec ID. + ID string `json:"Id"` +} + +// AuthResponse contains response of Remote API: +// POST "/auth" +type AuthResponse struct { + // Status is the authentication status + Status string `json:"Status"` +} + +// ContainerWaitResponse contains response of Remote API: +// POST "/containers/"+containerID+"/wait" +type ContainerWaitResponse struct { + // StatusCode is the status code of the wait job + StatusCode int `json:"StatusCode"` +} + +// ContainerCommitResponse contains response of Remote API: +// POST "/commit?container="+containerID +type ContainerCommitResponse struct { + ID string `json:"Id"` +} + +// ContainerChange contains response of Remote API: +// GET "/containers/{name:.*}/changes" +type ContainerChange struct { + Kind int + Path string +} + +// ImageHistory contains response of Remote API: +// GET "/images/{name:.*}/history" +type ImageHistory struct { + ID string `json:"Id"` + Created int64 + CreatedBy string + Tags []string + Size int64 + Comment string +} + +// ImageDelete contains response of Remote API: +// DELETE "/images/{name:.*}" +type ImageDelete struct { + Untagged string `json:",omitempty"` + Deleted string `json:",omitempty"` +} + +// Image contains response of Remote API: +// GET "/images/json" +type Image struct { + ID string `json:"Id"` + ParentID string `json:"ParentId"` + RepoTags []string + RepoDigests []string + Created int64 + Size int64 + VirtualSize int64 + Labels map[string]string +} + +// GraphDriverData returns Image's graph driver config info +// when calling inspect command +type GraphDriverData struct { + Name string + Data map[string]string +} + +// ImageInspect contains response of Remote API: +// GET "/images/{name:.*}/json" +type ImageInspect struct { + ID string `json:"Id"` + RepoTags []string + RepoDigests []string + Parent string + Comment string + Created string + Container string + ContainerConfig *runconfig.Config + DockerVersion string + Author string + Config *runconfig.Config + Architecture string + Os string + Size int64 + VirtualSize int64 + GraphDriver GraphDriverData +} + +// Port stores open ports info of container +// e.g. {"PrivatePort": 8080, "PublicPort": 80, "Type": "tcp"} +type Port struct { + IP string `json:",omitempty"` + PrivatePort int + PublicPort int `json:",omitempty"` + Type string +} + +// Container contains response of Remote API: +// GET "/containers/json" +type Container struct { + ID string `json:"Id"` + Names []string + Image string + ImageID string + Command string + Created int64 + Ports []Port + SizeRw int64 `json:",omitempty"` + SizeRootFs int64 `json:",omitempty"` + Labels map[string]string + Status string + HostConfig struct { + NetworkMode string `json:",omitempty"` + } +} + +// CopyConfig contains request body of Remote API: +// POST "/containers/"+containerID+"/copy" +type CopyConfig struct { + Resource string +} + +// ContainerPathStat is used to encode the header from +// GET "/containers/{name:.*}/archive" +// "Name" is the file or directory name. +type ContainerPathStat struct { + Name string `json:"name"` + Size int64 `json:"size"` + Mode os.FileMode `json:"mode"` + Mtime time.Time `json:"mtime"` + LinkTarget string `json:"linkTarget"` +} + +// ContainerProcessList contains response of Remote API: +// GET "/containers/{name:.*}/top" +type ContainerProcessList struct { + Processes [][]string + Titles []string +} + +// Version contains response of Remote API: +// GET "/version" +type Version struct { + Version string + APIVersion version.Version `json:"ApiVersion"` + GitCommit string + GoVersion string + Os string + Arch string + KernelVersion string `json:",omitempty"` + Experimental bool `json:",omitempty"` + BuildTime string `json:",omitempty"` +} + +// Info contains response of Remote API: +// GET "/info" +type Info struct { + ID string + Containers int + Images int + Driver string + DriverStatus [][2]string + MemoryLimit bool + SwapLimit bool + CPUCfsPeriod bool `json:"CpuCfsPeriod"` + CPUCfsQuota bool `json:"CpuCfsQuota"` + IPv4Forwarding bool + BridgeNfIptables bool + BridgeNfIP6tables bool `json:"BridgeNfIp6tables"` + Debug bool + NFd int + OomKillDisable bool + NGoroutines int + SystemTime string + ExecutionDriver string + LoggingDriver string + NEventsListener int + KernelVersion string + OperatingSystem string + IndexServerAddress string + RegistryConfig *registry.ServiceConfig + InitSha1 string + InitPath string + NCPU int + MemTotal int64 + DockerRootDir string + HTTPProxy string `json:"HttpProxy"` + HTTPSProxy string `json:"HttpsProxy"` + NoProxy string + Name string + Labels []string + ExperimentalBuild bool + ServerVersion string + ClusterStore string + ClusterAdvertise string +} + +// ExecStartCheck is a temp struct used by execStart +// Config fields is part of ExecConfig in runconfig package +type ExecStartCheck struct { + // ExecStart will first check if it's detached + Detach bool + // Check if there's a tty + Tty bool +} + +// ContainerState stores container's running state +// it's part of ContainerJSONBase and will return by "inspect" command +type ContainerState struct { + Status string + Running bool + Paused bool + Restarting bool + OOMKilled bool + Dead bool + Pid int + ExitCode int + Error string + StartedAt string + FinishedAt string +} + +// ContainerJSONBase contains response of Remote API: +// GET "/containers/{name:.*}/json" +type ContainerJSONBase struct { + ID string `json:"Id"` + Created string + Path string + Args []string + State *ContainerState + Image string + ResolvConfPath string + HostnamePath string + HostsPath string + LogPath string + Name string + RestartCount int + Driver string + ExecDriver string + MountLabel string + ProcessLabel string + AppArmorProfile string + ExecIDs []string + HostConfig *runconfig.HostConfig + GraphDriver GraphDriverData + SizeRw *int64 `json:",omitempty"` + SizeRootFs *int64 `json:",omitempty"` +} + +// ContainerJSON is newly used struct along with MountPoint +type ContainerJSON struct { + *ContainerJSONBase + Mounts []MountPoint + Config *runconfig.Config + NetworkSettings *NetworkSettings +} + +// NetworkSettings exposes the network settings in the api +type NetworkSettings struct { + NetworkSettingsBase + DefaultNetworkSettings + Networks map[string]*network.EndpointSettings +} + +// NetworkSettingsBase holds basic information about networks +type NetworkSettingsBase struct { + Bridge string + SandboxID string + HairpinMode bool + LinkLocalIPv6Address string + LinkLocalIPv6PrefixLen int + Ports nat.PortMap + SandboxKey string + SecondaryIPAddresses []network.Address + SecondaryIPv6Addresses []network.Address +} + +// DefaultNetworkSettings holds network information +// during the 2 release deprecation period. +// It will be removed in Docker 1.11. +type DefaultNetworkSettings struct { + EndpointID string + Gateway string + GlobalIPv6Address string + GlobalIPv6PrefixLen int + IPAddress string + IPPrefixLen int + IPv6Gateway string + MacAddress string +} + +// MountPoint represents a mount point configuration inside the container. +type MountPoint struct { + Name string `json:",omitempty"` + Source string + Destination string + Driver string `json:",omitempty"` + Mode string + RW bool +} + +// Volume represents the configuration of a volume for the remote API +type Volume struct { + Name string // Name is the name of the volume + Driver string // Driver is the Driver name used to create the volume + Mountpoint string // Mountpoint is the location on disk of the volume +} + +// VolumesListResponse contains the response for the remote API: +// GET "/volumes" +type VolumesListResponse struct { + Volumes []*Volume // Volumes is the list of volumes being returned +} + +// VolumeCreateRequest contains the response for the remote API: +// POST "/volumes/create" +type VolumeCreateRequest struct { + Name string // Name is the requested name of the volume + Driver string // Driver is the name of the driver that should be used to create the volume + DriverOpts map[string]string // DriverOpts holds the driver specific options to use for when creating the volume. +} + +// NetworkResource is the body of the "get network" http response message +type NetworkResource struct { + Name string + ID string `json:"Id"` + Scope string + Driver string + IPAM network.IPAM + Containers map[string]EndpointResource + Options map[string]string +} + +//EndpointResource contains network resources allocated and usd for a container in a network +type EndpointResource struct { + EndpointID string + MacAddress string + IPv4Address string + IPv6Address string +} + +// NetworkCreate is the expected body of the "create network" http request message +type NetworkCreate struct { + Name string + CheckDuplicate bool + Driver string + IPAM network.IPAM + Options map[string]string +} + +// NetworkCreateResponse is the response message sent by the server for network create call +type NetworkCreateResponse struct { + ID string `json:"Id"` + Warning string +} + +// NetworkConnect represents the data to be used to connect a container to the network +type NetworkConnect struct { + Container string +} + +// NetworkDisconnect represents the data to be used to disconnect a container from the network +type NetworkDisconnect struct { + Container string +} diff --git a/api/types/versions/README.md b/api/types/versions/README.md new file mode 100644 index 0000000000..76c516e6a3 --- /dev/null +++ b/api/types/versions/README.md @@ -0,0 +1,14 @@ +## Legacy API type versions + +This package includes types for legacy API versions. The stable version of the API types live in `api/types/*.go`. + +Consider moving a type here when you need to keep backwards compatibility in the API. This legacy types are organized by the latest API version they appear in. For instance, types in the `v1p19` package are valid for API versions below or equal `1.19`. Types in the `v1p20` package are valid for the API version `1.20`, since the versions below that will use the legacy types in `v1p19`. + +### Package name conventions + +The package name convention is to use `v` as a prefix for the version number and `p`(patch) as a separator. We use this nomenclature due to a few restrictions in the Go package name convention: + +1. We cannot use `.` because it's interpreted by the language, think of `v1.20.CallFunction`. +2. We cannot use `_` because golint complains abount it. The code is actually valid, but it looks probably more weird: `v1_20.CallFunction`. + +For instance, if you want to modify a type that was available in the version `1.21` of the API but it will have different fields in the version `1.22`, you want to create a new package under `api/types/versions/v1p21`. diff --git a/api/types/versions/v1p19/types.go b/api/types/versions/v1p19/types.go new file mode 100644 index 0000000000..a66aa9d5e5 --- /dev/null +++ b/api/types/versions/v1p19/types.go @@ -0,0 +1,35 @@ +// Package v1p19 provides specific API types for the API version 1, patch 19. +package v1p19 + +import ( + "github.com/docker/docker/api/types" + "github.com/docker/docker/api/types/versions/v1p20" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/runconfig" +) + +// ContainerJSON is a backcompatibility struct for APIs prior to 1.20. +// Note this is not used by the Windows daemon. +type ContainerJSON struct { + *types.ContainerJSONBase + Volumes map[string]string + VolumesRW map[string]bool + Config *ContainerConfig + NetworkSettings *v1p20.NetworkSettings +} + +// ContainerConfig is a backcompatibility struct for APIs prior to 1.20. +type ContainerConfig struct { + *runconfig.Config + + MacAddress string + NetworkDisabled bool + ExposedPorts map[nat.Port]struct{} + + // backward compatibility, they now live in HostConfig + VolumeDriver string + Memory int64 + MemorySwap int64 + CPUShares int64 `json:"CpuShares"` + CPUSet string `json:"Cpuset"` +} diff --git a/api/types/versions/v1p20/types.go b/api/types/versions/v1p20/types.go new file mode 100644 index 0000000000..0facbb66ca --- /dev/null +++ b/api/types/versions/v1p20/types.go @@ -0,0 +1,40 @@ +// Package v1p20 provides specific API types for the API version 1, patch 20. +package v1p20 + +import ( + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/runconfig" +) + +// ContainerJSON is a backcompatibility struct for the API 1.20 +type ContainerJSON struct { + *types.ContainerJSONBase + Mounts []types.MountPoint + Config *ContainerConfig + NetworkSettings *NetworkSettings +} + +// ContainerConfig is a backcompatibility struct used in ContainerJSON for the API 1.20 +type ContainerConfig struct { + *runconfig.Config + + MacAddress string + NetworkDisabled bool + ExposedPorts map[nat.Port]struct{} + + // backward compatibility, they now live in HostConfig + VolumeDriver string +} + +// StatsJSON is a backcompatibility struct used in Stats for API prior to 1.21 +type StatsJSON struct { + types.Stats + Network types.NetworkStats `json:"network,omitempty"` +} + +// NetworkSettings is a backward compatible struct for APIs prior to 1.21 +type NetworkSettings struct { + types.NetworkSettingsBase + types.DefaultNetworkSettings +} diff --git a/builder/builder.go b/builder/builder.go new file mode 100644 index 0000000000..b1a4401d98 --- /dev/null +++ b/builder/builder.go @@ -0,0 +1,150 @@ +// Package builder defines interfaces for any Docker builder to implement. +// +// Historically, only server-side Dockerfile interpreters existed. +// This package allows for other implementations of Docker builders. +package builder + +import ( + "io" + "os" + + // TODO: remove dependency on daemon + "github.com/docker/docker/daemon" + "github.com/docker/docker/image" + "github.com/docker/docker/runconfig" +) + +// Builder abstracts a Docker builder whose only purpose is to build a Docker image referenced by an imageID. +type Builder interface { + // Build builds a Docker image referenced by an imageID string. + // + // Note: Tagging an image should not be done by a Builder, it should instead be done + // by the caller. + // + // TODO: make this return a reference instead of string + Build() (imageID string) +} + +// Context represents a file system tree. +type Context interface { + // Close allows to signal that the filesystem tree won't be used anymore. + // For Context implementations using a temporary directory, it is recommended to + // delete the temporary directory in Close(). + Close() error + // Stat returns an entry corresponding to path if any. + // It is recommended to return an error if path was not found. + // If path is a symlink it also returns the path to the target file. + Stat(path string) (string, FileInfo, error) + // Open opens path from the context and returns a readable stream of it. + Open(path string) (io.ReadCloser, error) + // Walk walks the tree of the context with the function passed to it. + Walk(root string, walkFn WalkFunc) error +} + +// WalkFunc is the type of the function called for each file or directory visited by Context.Walk(). +type WalkFunc func(path string, fi FileInfo, err error) error + +// ModifiableContext represents a modifiable Context. +// TODO: remove this interface once we can get rid of Remove() +type ModifiableContext interface { + Context + // Remove deletes the entry specified by `path`. + // It is usual for directory entries to delete all its subentries. + Remove(path string) error +} + +// FileInfo extends os.FileInfo to allow retrieving an absolute path to the file. +// TODO: remove this interface once pkg/archive exposes a walk function that Context can use. +type FileInfo interface { + os.FileInfo + Path() string +} + +// PathFileInfo is a convenience struct that implements the FileInfo interface. +type PathFileInfo struct { + os.FileInfo + // FilePath holds the absolute path to the file. + FilePath string + // Name holds the basename for the file. + FileName string +} + +// Path returns the absolute path to the file. +func (fi PathFileInfo) Path() string { + return fi.FilePath +} + +// Name returns the basename of the file. +func (fi PathFileInfo) Name() string { + if fi.FileName != "" { + return fi.FileName + } + return fi.FileInfo.Name() +} + +// Hashed defines an extra method intended for implementations of os.FileInfo. +type Hashed interface { + // Hash returns the hash of a file. + Hash() string + SetHash(string) +} + +// HashedFileInfo is a convenient struct that augments FileInfo with a field. +type HashedFileInfo struct { + FileInfo + // FileHash represents the hash of a file. + FileHash string +} + +// Hash returns the hash of a file. +func (fi HashedFileInfo) Hash() string { + return fi.FileHash +} + +// SetHash sets the hash of a file. +func (fi *HashedFileInfo) SetHash(h string) { + fi.FileHash = h +} + +// Docker abstracts calls to a Docker Daemon. +type Docker interface { + // TODO: use digest reference instead of name + + // LookupImage looks up a Docker image referenced by `name`. + LookupImage(name string) (*image.Image, error) + // Pull tells Docker to pull image referenced by `name`. + Pull(name string) (*image.Image, error) + + // TODO: move daemon.Container to its own package + + // Container looks up a Docker container referenced by `id`. + Container(id string) (*daemon.Container, error) + // Create creates a new Docker container and returns potential warnings + // TODO: put warnings in the error + Create(*runconfig.Config, *runconfig.HostConfig) (*daemon.Container, []string, error) + // Remove removes a container specified by `id`. + Remove(id string, cfg *daemon.ContainerRmConfig) error + // Commit creates a new Docker image from an existing Docker container. + Commit(*daemon.Container, *daemon.ContainerCommitConfig) (*image.Image, error) + // Copy copies/extracts a source FileInfo to a destination path inside a container + // specified by a container object. + // TODO: make an Extract method instead of passing `decompress` + // TODO: do not pass a FileInfo, instead refactor the archive package to export a Walk function that can be used + // with Context.Walk + Copy(c *daemon.Container, destPath string, src FileInfo, decompress bool) error + + // Retain retains an image avoiding it to be removed or overwritten until a corresponding Release() call. + // TODO: remove + Retain(sessionID, imgID string) + // Release releases a list of images that were retained for the time of a build. + // TODO: remove + Release(sessionID string, activeImages []string) +} + +// ImageCache abstracts an image cache store. +// (parent image, child runconfig) -> child image +type ImageCache interface { + // GetCachedImage returns a reference to a cached image whose parent equals `parent` + // and runconfig equals `cfg`. A cache miss is expected to return an empty ID and a nil error. + GetCachedImage(parentID string, cfg *runconfig.Config) (imageID string, err error) +} diff --git a/builder/dockerfile/bflag.go b/builder/dockerfile/bflag.go new file mode 100644 index 0000000000..24f73111ba --- /dev/null +++ b/builder/dockerfile/bflag.go @@ -0,0 +1,176 @@ +package dockerfile + +import ( + "fmt" + "strings" +) + +// FlagType is the type of the build flag +type FlagType int + +const ( + boolType FlagType = iota + stringType +) + +// BFlags contains all flags information for the builder +type BFlags struct { + Args []string // actual flags/args from cmd line + flags map[string]*Flag + used map[string]*Flag + Err error +} + +// Flag contains all information for a flag +type Flag struct { + bf *BFlags + name string + flagType FlagType + Value string +} + +// NewBFlags return the new BFlags struct +func NewBFlags() *BFlags { + return &BFlags{ + flags: make(map[string]*Flag), + used: make(map[string]*Flag), + } +} + +// AddBool adds a bool flag to BFlags +// Note, any error will be generated when Parse() is called (see Parse). +func (bf *BFlags) AddBool(name string, def bool) *Flag { + flag := bf.addFlag(name, boolType) + if flag == nil { + return nil + } + if def { + flag.Value = "true" + } else { + flag.Value = "false" + } + return flag +} + +// AddString adds a string flag to BFlags +// Note, any error will be generated when Parse() is called (see Parse). +func (bf *BFlags) AddString(name string, def string) *Flag { + flag := bf.addFlag(name, stringType) + if flag == nil { + return nil + } + flag.Value = def + return flag +} + +// addFlag is a generic func used by the other AddXXX() func +// to add a new flag to the BFlags struct. +// Note, any error will be generated when Parse() is called (see Parse). +func (bf *BFlags) addFlag(name string, flagType FlagType) *Flag { + if _, ok := bf.flags[name]; ok { + bf.Err = fmt.Errorf("Duplicate flag defined: %s", name) + return nil + } + + newFlag := &Flag{ + bf: bf, + name: name, + flagType: flagType, + } + bf.flags[name] = newFlag + + return newFlag +} + +// IsUsed checks if the flag is used +func (fl *Flag) IsUsed() bool { + if _, ok := fl.bf.used[fl.name]; ok { + return true + } + return false +} + +// IsTrue checks if a bool flag is true +func (fl *Flag) IsTrue() bool { + if fl.flagType != boolType { + // Should never get here + panic(fmt.Errorf("Trying to use IsTrue on a non-boolean: %s", fl.name)) + } + return fl.Value == "true" +} + +// Parse parses and checks if the BFlags is valid. +// Any error noticed during the AddXXX() funcs will be generated/returned +// here. We do this because an error during AddXXX() is more like a +// compile time error so it doesn't matter too much when we stop our +// processing as long as we do stop it, so this allows the code +// around AddXXX() to be just: +// defFlag := AddString("desription", "") +// w/o needing to add an if-statement around each one. +func (bf *BFlags) Parse() error { + // If there was an error while defining the possible flags + // go ahead and bubble it back up here since we didn't do it + // earlier in the processing + if bf.Err != nil { + return fmt.Errorf("Error setting up flags: %s", bf.Err) + } + + for _, arg := range bf.Args { + if !strings.HasPrefix(arg, "--") { + return fmt.Errorf("Arg should start with -- : %s", arg) + } + + if arg == "--" { + return nil + } + + arg = arg[2:] + value := "" + + index := strings.Index(arg, "=") + if index >= 0 { + value = arg[index+1:] + arg = arg[:index] + } + + flag, ok := bf.flags[arg] + if !ok { + return fmt.Errorf("Unknown flag: %s", arg) + } + + if _, ok = bf.used[arg]; ok { + return fmt.Errorf("Duplicate flag specified: %s", arg) + } + + bf.used[arg] = flag + + switch flag.flagType { + case boolType: + // value == "" is only ok if no "=" was specified + if index >= 0 && value == "" { + return fmt.Errorf("Missing a value on flag: %s", arg) + } + + lower := strings.ToLower(value) + if lower == "" { + flag.Value = "true" + } else if lower == "true" || lower == "false" { + flag.Value = lower + } else { + return fmt.Errorf("Expecting boolean value for flag %s, not: %s", arg, value) + } + + case stringType: + if index < 0 { + return fmt.Errorf("Missing a value on flag: %s", arg) + } + flag.Value = value + + default: + panic(fmt.Errorf("No idea what kind of flag we have! Should never get here!")) + } + + } + + return nil +} diff --git a/builder/dockerfile/bflag_test.go b/builder/dockerfile/bflag_test.go new file mode 100644 index 0000000000..65cfceadd0 --- /dev/null +++ b/builder/dockerfile/bflag_test.go @@ -0,0 +1,187 @@ +package dockerfile + +import ( + "testing" +) + +func TestBuilderFlags(t *testing.T) { + var expected string + var err error + + // --- + + bf := NewBFlags() + bf.Args = []string{} + if err := bf.Parse(); err != nil { + t.Fatalf("Test1 of %q was supposed to work: %s", bf.Args, err) + } + + // --- + + bf = NewBFlags() + bf.Args = []string{"--"} + if err := bf.Parse(); err != nil { + t.Fatalf("Test2 of %q was supposed to work: %s", bf.Args, err) + } + + // --- + + bf = NewBFlags() + flStr1 := bf.AddString("str1", "") + flBool1 := bf.AddBool("bool1", false) + bf.Args = []string{} + if err = bf.Parse(); err != nil { + t.Fatalf("Test3 of %q was supposed to work: %s", bf.Args, err) + } + + if flStr1.IsUsed() == true { + t.Fatalf("Test3 - str1 was not used!") + } + if flBool1.IsUsed() == true { + t.Fatalf("Test3 - bool1 was not used!") + } + + // --- + + bf = NewBFlags() + flStr1 = bf.AddString("str1", "HI") + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test4 of %q was supposed to work: %s", bf.Args, err) + } + + if flStr1.Value != "HI" { + t.Fatalf("Str1 was supposed to default to: HI") + } + if flBool1.IsTrue() { + t.Fatalf("Bool1 was supposed to default to: false") + } + if flStr1.IsUsed() == true { + t.Fatalf("Str1 was not used!") + } + if flBool1.IsUsed() == true { + t.Fatalf("Bool1 was not used!") + } + + // --- + + bf = NewBFlags() + flStr1 = bf.AddString("str1", "HI") + bf.Args = []string{"--str1"} + + if err = bf.Parse(); err == nil { + t.Fatalf("Test %q was supposed to fail", bf.Args) + } + + // --- + + bf = NewBFlags() + flStr1 = bf.AddString("str1", "HI") + bf.Args = []string{"--str1="} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test %q was supposed to work: %s", bf.Args, err) + } + + expected = "" + if flStr1.Value != expected { + t.Fatalf("Str1 (%q) should be: %q", flStr1.Value, expected) + } + + // --- + + bf = NewBFlags() + flStr1 = bf.AddString("str1", "HI") + bf.Args = []string{"--str1=BYE"} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test %q was supposed to work: %s", bf.Args, err) + } + + expected = "BYE" + if flStr1.Value != expected { + t.Fatalf("Str1 (%q) should be: %q", flStr1.Value, expected) + } + + // --- + + bf = NewBFlags() + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{"--bool1"} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test %q was supposed to work: %s", bf.Args, err) + } + + if !flBool1.IsTrue() { + t.Fatalf("Test-b1 Bool1 was supposed to be true") + } + + // --- + + bf = NewBFlags() + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{"--bool1=true"} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test %q was supposed to work: %s", bf.Args, err) + } + + if !flBool1.IsTrue() { + t.Fatalf("Test-b2 Bool1 was supposed to be true") + } + + // --- + + bf = NewBFlags() + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{"--bool1=false"} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test %q was supposed to work: %s", bf.Args, err) + } + + if flBool1.IsTrue() { + t.Fatalf("Test-b3 Bool1 was supposed to be false") + } + + // --- + + bf = NewBFlags() + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{"--bool1=false1"} + + if err = bf.Parse(); err == nil { + t.Fatalf("Test %q was supposed to fail", bf.Args) + } + + // --- + + bf = NewBFlags() + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{"--bool2"} + + if err = bf.Parse(); err == nil { + t.Fatalf("Test %q was supposed to fail", bf.Args) + } + + // --- + + bf = NewBFlags() + flStr1 = bf.AddString("str1", "HI") + flBool1 = bf.AddBool("bool1", false) + bf.Args = []string{"--bool1", "--str1=BYE"} + + if err = bf.Parse(); err != nil { + t.Fatalf("Test %q was supposed to work: %s", bf.Args, err) + } + + if flStr1.Value != "BYE" { + t.Fatalf("Teset %s, str1 should be BYE", bf.Args) + } + if !flBool1.IsTrue() { + t.Fatalf("Teset %s, bool1 should be true", bf.Args) + } +} diff --git a/builder/dockerfile/builder.go b/builder/dockerfile/builder.go new file mode 100644 index 0000000000..8b8c6e8735 --- /dev/null +++ b/builder/dockerfile/builder.go @@ -0,0 +1,292 @@ +package dockerfile + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "os" + "runtime" + "strings" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/builder" + "github.com/docker/docker/builder/dockerfile/parser" + "github.com/docker/docker/daemon" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/ulimit" + "github.com/docker/docker/runconfig" +) + +var validCommitCommands = map[string]bool{ + "cmd": true, + "entrypoint": true, + "env": true, + "expose": true, + "label": true, + "onbuild": true, + "user": true, + "volume": true, + "workdir": true, +} + +// BuiltinAllowedBuildArgs is list of built-in allowed build args +var BuiltinAllowedBuildArgs = map[string]bool{ + "HTTP_PROXY": true, + "http_proxy": true, + "HTTPS_PROXY": true, + "https_proxy": true, + "FTP_PROXY": true, + "ftp_proxy": true, + "NO_PROXY": true, + "no_proxy": true, +} + +// Config constitutes the configuration for a Dockerfile builder. +type Config struct { + // only used if Dockerfile has to be extracted from Context + DockerfileName string + + Verbose bool + UseCache bool + Remove bool + ForceRemove bool + Pull bool + BuildArgs map[string]string // build-time args received in build context for expansion/substitution and commands in 'run'. + + // resource constraints + // TODO: factor out to be reused with Run ? + + Memory int64 + MemorySwap int64 + CPUShares int64 + CPUPeriod int64 + CPUQuota int64 + CPUSetCpus string + CPUSetMems string + CgroupParent string + Ulimits []*ulimit.Ulimit +} + +// Builder is a Dockerfile builder +// It implements the builder.Builder interface. +type Builder struct { + *Config + + Stdout io.Writer + Stderr io.Writer + + docker builder.Docker + context builder.Context + + dockerfile *parser.Node + runConfig *runconfig.Config // runconfig for cmd, run, entrypoint etc. + flags *BFlags + tmpContainers map[string]struct{} + image string // imageID + noBaseImage bool + maintainer string + cmdSet bool + disableCommit bool + cacheBusted bool + cancelled chan struct{} + cancelOnce sync.Once + allowedBuildArgs map[string]bool // list of build-time args that are allowed for expansion/substitution and passing to commands in 'run'. + + // TODO: remove once docker.Commit can receive a tag + id string + activeImages []string +} + +// NewBuilder creates a new Dockerfile builder from an optional dockerfile and a Config. +// If dockerfile is nil, the Dockerfile specified by Config.DockerfileName, +// will be read from the Context passed to Build(). +func NewBuilder(config *Config, docker builder.Docker, context builder.Context, dockerfile io.ReadCloser) (b *Builder, err error) { + if config == nil { + config = new(Config) + } + if config.BuildArgs == nil { + config.BuildArgs = make(map[string]string) + } + b = &Builder{ + Config: config, + Stdout: os.Stdout, + Stderr: os.Stderr, + docker: docker, + context: context, + runConfig: new(runconfig.Config), + tmpContainers: map[string]struct{}{}, + cancelled: make(chan struct{}), + id: stringid.GenerateNonCryptoID(), + allowedBuildArgs: make(map[string]bool), + } + if dockerfile != nil { + b.dockerfile, err = parser.Parse(dockerfile) + if err != nil { + return nil, err + } + } + + return b, nil +} + +// Build runs the Dockerfile builder from a context and a docker object that allows to make calls +// to Docker. +// +// This will (barring errors): +// +// * read the dockerfile from context +// * parse the dockerfile if not already parsed +// * walk the AST and execute it by dispatching to handlers. If Remove +// or ForceRemove is set, additional cleanup around containers happens after +// processing. +// * Print a happy message and return the image ID. +// * NOT tag the image, that is responsibility of the caller. +// +func (b *Builder) Build() (string, error) { + // TODO: remove once b.docker.Commit can take a tag parameter. + defer func() { + b.docker.Release(b.id, b.activeImages) + }() + + // If Dockerfile was not parsed yet, extract it from the Context + if b.dockerfile == nil { + if err := b.readDockerfile(); err != nil { + return "", err + } + } + + var shortImgID string + for i, n := range b.dockerfile.Children { + select { + case <-b.cancelled: + logrus.Debug("Builder: build cancelled!") + fmt.Fprintf(b.Stdout, "Build cancelled") + return "", fmt.Errorf("Build cancelled") + default: + // Not cancelled yet, keep going... + } + if err := b.dispatch(i, n); err != nil { + if b.ForceRemove { + b.clearTmp() + } + return "", err + } + shortImgID = stringid.TruncateID(b.image) + fmt.Fprintf(b.Stdout, " ---> %s\n", shortImgID) + if b.Remove { + b.clearTmp() + } + } + + // check if there are any leftover build-args that were passed but not + // consumed during build. Return an error, if there are any. + leftoverArgs := []string{} + for arg := range b.BuildArgs { + if !b.isBuildArgAllowed(arg) { + leftoverArgs = append(leftoverArgs, arg) + } + } + if len(leftoverArgs) > 0 { + return "", fmt.Errorf("One or more build-args %v were not consumed, failing build.", leftoverArgs) + } + + if b.image == "" { + return "", fmt.Errorf("No image was generated. Is your Dockerfile empty?") + } + + fmt.Fprintf(b.Stdout, "Successfully built %s\n", shortImgID) + return b.image, nil +} + +// Cancel cancels an ongoing Dockerfile build. +func (b *Builder) Cancel() { + b.cancelOnce.Do(func() { + close(b.cancelled) + }) +} + +// CommitConfig contains build configs for commit operation +type CommitConfig struct { + Pause bool + Repo string + Tag string + Author string + Comment string + Changes []string + Config *runconfig.Config +} + +// BuildFromConfig will do build directly from parameter 'changes', which comes +// from Dockerfile entries, it will: +// - call parse.Parse() to get AST root from Dockerfile entries +// - do build by calling builder.dispatch() to call all entries' handling routines +// TODO: remove? +func BuildFromConfig(config *runconfig.Config, changes []string) (*runconfig.Config, error) { + ast, err := parser.Parse(bytes.NewBufferString(strings.Join(changes, "\n"))) + if err != nil { + return nil, err + } + + // ensure that the commands are valid + for _, n := range ast.Children { + if !validCommitCommands[n.Value] { + return nil, fmt.Errorf("%s is not a valid change command", n.Value) + } + } + + b, err := NewBuilder(nil, nil, nil, nil) + if err != nil { + return nil, err + } + b.runConfig = config + b.Stdout = ioutil.Discard + b.Stderr = ioutil.Discard + b.disableCommit = true + + for i, n := range ast.Children { + if err := b.dispatch(i, n); err != nil { + return nil, err + } + } + + return b.runConfig, nil +} + +// Commit will create a new image from a container's changes +// TODO: remove daemon, make Commit a method on *Builder ? +func Commit(container *daemon.Container, d *daemon.Daemon, c *CommitConfig) (string, error) { + // It is not possible to commit a running container on Windows + if runtime.GOOS == "windows" && container.IsRunning() { + return "", fmt.Errorf("Windows does not support commit of a running container") + } + + if c.Config == nil { + c.Config = &runconfig.Config{} + } + + newConfig, err := BuildFromConfig(c.Config, c.Changes) + if err != nil { + return "", err + } + + if err := runconfig.Merge(newConfig, container.Config); err != nil { + return "", err + } + + commitCfg := &daemon.ContainerCommitConfig{ + Pause: c.Pause, + Repo: c.Repo, + Tag: c.Tag, + Author: c.Author, + Comment: c.Comment, + Config: newConfig, + } + + img, err := d.Commit(container, commitCfg) + if err != nil { + return "", err + } + return img.ID, nil +} diff --git a/builder/dockerfile/command/command.go b/builder/dockerfile/command/command.go new file mode 100644 index 0000000000..9e1b799dcf --- /dev/null +++ b/builder/dockerfile/command/command.go @@ -0,0 +1,42 @@ +// Package command contains the set of Dockerfile commands. +package command + +// Define constants for the command strings +const ( + Env = "env" + Label = "label" + Maintainer = "maintainer" + Add = "add" + Copy = "copy" + From = "from" + Onbuild = "onbuild" + Workdir = "workdir" + Run = "run" + Cmd = "cmd" + Entrypoint = "entrypoint" + Expose = "expose" + Volume = "volume" + User = "user" + StopSignal = "stopsignal" + Arg = "arg" +) + +// Commands is list of all Dockerfile commands +var Commands = map[string]struct{}{ + Env: {}, + Label: {}, + Maintainer: {}, + Add: {}, + Copy: {}, + From: {}, + Onbuild: {}, + Workdir: {}, + Run: {}, + Cmd: {}, + Entrypoint: {}, + Expose: {}, + Volume: {}, + User: {}, + StopSignal: {}, + Arg: {}, +} diff --git a/builder/dockerfile/dispatchers.go b/builder/dockerfile/dispatchers.go new file mode 100644 index 0000000000..750d19a7a7 --- /dev/null +++ b/builder/dockerfile/dispatchers.go @@ -0,0 +1,647 @@ +package dockerfile + +// This file contains the dispatchers for each command. Note that +// `nullDispatch` is not actually a command, but support for commands we parse +// but do nothing with. +// +// See evaluator.go for a higher level discussion of the whole evaluator +// package. + +import ( + "fmt" + "io/ioutil" + "os" + "path/filepath" + "regexp" + "runtime" + "sort" + "strings" + + "github.com/Sirupsen/logrus" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/image" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/runconfig" +) + +const ( + // NoBaseImageSpecifier is the symbol used by the FROM + // command to specify that no base image is to be used. + NoBaseImageSpecifier string = "scratch" +) + +// dispatch with no layer / parsing. This is effectively not a command. +func nullDispatch(b *Builder, args []string, attributes map[string]bool, original string) error { + return nil +} + +// ENV foo bar +// +// Sets the environment variable foo to bar, also makes interpolation +// in the dockerfile available from the next statement on via ${foo}. +// +func env(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) == 0 { + return derr.ErrorCodeAtLeastOneArg.WithArgs("ENV") + } + + if len(args)%2 != 0 { + // should never get here, but just in case + return derr.ErrorCodeTooManyArgs.WithArgs("ENV") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + // TODO/FIXME/NOT USED + // Just here to show how to use the builder flags stuff within the + // context of a builder command. Will remove once we actually add + // a builder command to something! + /* + flBool1 := b.flags.AddBool("bool1", false) + flStr1 := b.flags.AddString("str1", "HI") + + if err := b.flags.Parse(); err != nil { + return err + } + + fmt.Printf("Bool1:%v\n", flBool1) + fmt.Printf("Str1:%v\n", flStr1) + */ + + commitStr := "ENV" + + for j := 0; j < len(args); j++ { + // name ==> args[j] + // value ==> args[j+1] + newVar := args[j] + "=" + args[j+1] + "" + commitStr += " " + newVar + + gotOne := false + for i, envVar := range b.runConfig.Env { + envParts := strings.SplitN(envVar, "=", 2) + if envParts[0] == args[j] { + b.runConfig.Env[i] = newVar + gotOne = true + break + } + } + if !gotOne { + b.runConfig.Env = append(b.runConfig.Env, newVar) + } + j++ + } + + return b.commit("", b.runConfig.Cmd, commitStr) +} + +// MAINTAINER some text +// +// Sets the maintainer metadata. +func maintainer(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) != 1 { + return derr.ErrorCodeExactlyOneArg.WithArgs("MAINTAINER") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + b.maintainer = args[0] + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("MAINTAINER %s", b.maintainer)) +} + +// LABEL some json data describing the image +// +// Sets the Label variable foo to bar, +// +func label(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) == 0 { + return derr.ErrorCodeAtLeastOneArg.WithArgs("LABEL") + } + if len(args)%2 != 0 { + // should never get here, but just in case + return derr.ErrorCodeTooManyArgs.WithArgs("LABEL") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + commitStr := "LABEL" + + if b.runConfig.Labels == nil { + b.runConfig.Labels = map[string]string{} + } + + for j := 0; j < len(args); j++ { + // name ==> args[j] + // value ==> args[j+1] + newVar := args[j] + "=" + args[j+1] + "" + commitStr += " " + newVar + + b.runConfig.Labels[args[j]] = args[j+1] + j++ + } + return b.commit("", b.runConfig.Cmd, commitStr) +} + +// ADD foo /path +// +// Add the file 'foo' to '/path'. Tarball and Remote URL (git, http) handling +// exist here. If you do not wish to have this automatic handling, use COPY. +// +func add(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) < 2 { + return derr.ErrorCodeAtLeastTwoArgs.WithArgs("ADD") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + return b.runContextCommand(args, true, true, "ADD") +} + +// COPY foo /path +// +// Same as 'ADD' but without the tar and remote url handling. +// +func dispatchCopy(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) < 2 { + return derr.ErrorCodeAtLeastTwoArgs.WithArgs("COPY") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + return b.runContextCommand(args, false, false, "COPY") +} + +// FROM imagename +// +// This sets the image the dockerfile will build on top of. +// +func from(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) != 1 { + return derr.ErrorCodeExactlyOneArg.WithArgs("FROM") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + name := args[0] + + // Windows cannot support a container with no base image. + if name == NoBaseImageSpecifier { + if runtime.GOOS == "windows" { + return fmt.Errorf("Windows does not support FROM scratch") + } + b.image = "" + b.noBaseImage = true + return nil + } + + var ( + image *image.Image + err error + ) + // TODO: don't use `name`, instead resolve it to a digest + if !b.Pull { + image, err = b.docker.LookupImage(name) + // TODO: shouldn't we error out if error is different from "not found" ? + } + if image == nil { + image, err = b.docker.Pull(name) + if err != nil { + return err + } + } + return b.processImageFrom(image) +} + +// ONBUILD RUN echo yo +// +// ONBUILD triggers run when the image is used in a FROM statement. +// +// ONBUILD handling has a lot of special-case functionality, the heading in +// evaluator.go and comments around dispatch() in the same file explain the +// special cases. search for 'OnBuild' in internals.go for additional special +// cases. +// +func onbuild(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) == 0 { + return derr.ErrorCodeAtLeastOneArg.WithArgs("ONBUILD") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + triggerInstruction := strings.ToUpper(strings.TrimSpace(args[0])) + switch triggerInstruction { + case "ONBUILD": + return derr.ErrorCodeChainOnBuild + case "MAINTAINER", "FROM": + return derr.ErrorCodeBadOnBuildCmd.WithArgs(triggerInstruction) + } + + original = regexp.MustCompile(`(?i)^\s*ONBUILD\s*`).ReplaceAllString(original, "") + + b.runConfig.OnBuild = append(b.runConfig.OnBuild, original) + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("ONBUILD %s", original)) +} + +// WORKDIR /tmp +// +// Set the working directory for future RUN/CMD/etc statements. +// +func workdir(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) != 1 { + return derr.ErrorCodeExactlyOneArg.WithArgs("WORKDIR") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + // This is from the Dockerfile and will not necessarily be in platform + // specific semantics, hence ensure it is converted. + workdir := filepath.FromSlash(args[0]) + + if !system.IsAbs(workdir) { + current := filepath.FromSlash(b.runConfig.WorkingDir) + workdir = filepath.Join(string(os.PathSeparator), current, workdir) + } + + b.runConfig.WorkingDir = workdir + + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("WORKDIR %v", workdir)) +} + +// RUN some command yo +// +// run a command and commit the image. Args are automatically prepended with +// 'sh -c' under linux or 'cmd /S /C' under Windows, in the event there is +// only one argument. The difference in processing: +// +// RUN echo hi # sh -c echo hi (Linux) +// RUN echo hi # cmd /S /C echo hi (Windows) +// RUN [ "echo", "hi" ] # echo hi +// +func run(b *Builder, args []string, attributes map[string]bool, original string) error { + if b.image == "" && !b.noBaseImage { + return derr.ErrorCodeMissingFrom + } + + if err := b.flags.Parse(); err != nil { + return err + } + + args = handleJSONArgs(args, attributes) + + if !attributes["json"] { + if runtime.GOOS != "windows" { + args = append([]string{"/bin/sh", "-c"}, args...) + } else { + args = append([]string{"cmd", "/S", "/C"}, args...) + } + } + + runCmd := flag.NewFlagSet("run", flag.ContinueOnError) + runCmd.SetOutput(ioutil.Discard) + runCmd.Usage = nil + + config, _, _, err := runconfig.Parse(runCmd, append([]string{b.image}, args...)) + if err != nil { + return err + } + + // stash the cmd + cmd := b.runConfig.Cmd + runconfig.Merge(b.runConfig, config) + // stash the config environment + env := b.runConfig.Env + + defer func(cmd *stringutils.StrSlice) { b.runConfig.Cmd = cmd }(cmd) + defer func(env []string) { b.runConfig.Env = env }(env) + + // derive the net build-time environment for this run. We let config + // environment override the build time environment. + // This means that we take the b.buildArgs list of env vars and remove + // any of those variables that are defined as part of the container. In other + // words, anything in b.Config.Env. What's left is the list of build-time env + // vars that we need to add to each RUN command - note the list could be empty. + // + // We don't persist the build time environment with container's config + // environment, but just sort and prepend it to the command string at time + // of commit. + // This helps with tracing back the image's actual environment at the time + // of RUN, without leaking it to the final image. It also aids cache + // lookup for same image built with same build time environment. + cmdBuildEnv := []string{} + configEnv := runconfig.ConvertKVStringsToMap(b.runConfig.Env) + for key, val := range b.BuildArgs { + if !b.isBuildArgAllowed(key) { + // skip build-args that are not in allowed list, meaning they have + // not been defined by an "ARG" Dockerfile command yet. + // This is an error condition but only if there is no "ARG" in the entire + // Dockerfile, so we'll generate any necessary errors after we parsed + // the entire file (see 'leftoverArgs' processing in evaluator.go ) + continue + } + if _, ok := configEnv[key]; !ok { + cmdBuildEnv = append(cmdBuildEnv, fmt.Sprintf("%s=%s", key, val)) + } + } + + // derive the command to use for probeCache() and to commit in this container. + // Note that we only do this if there are any build-time env vars. Also, we + // use the special argument "|#" at the start of the args array. This will + // avoid conflicts with any RUN command since commands can not + // start with | (vertical bar). The "#" (number of build envs) is there to + // help ensure proper cache matches. We don't want a RUN command + // that starts with "foo=abc" to be considered part of a build-time env var. + saveCmd := config.Cmd + if len(cmdBuildEnv) > 0 { + sort.Strings(cmdBuildEnv) + tmpEnv := append([]string{fmt.Sprintf("|%d", len(cmdBuildEnv))}, cmdBuildEnv...) + saveCmd = stringutils.NewStrSlice(append(tmpEnv, saveCmd.Slice()...)...) + } + + b.runConfig.Cmd = saveCmd + hit, err := b.probeCache() + if err != nil { + return err + } + if hit { + return nil + } + + // set Cmd manually, this is special case only for Dockerfiles + b.runConfig.Cmd = config.Cmd + // set build-time environment for 'run'. + b.runConfig.Env = append(b.runConfig.Env, cmdBuildEnv...) + + logrus.Debugf("[BUILDER] Command to be executed: %v", b.runConfig.Cmd) + + c, err := b.create() + if err != nil { + return err + } + + // Ensure that we keep the container mounted until the commit + // to avoid unmounting and then mounting directly again + c.Mount() + defer c.Unmount() + + err = b.run(c) + if err != nil { + return err + } + + // revert to original config environment and set the command string to + // have the build-time env vars in it (if any) so that future cache look-ups + // properly match it. + b.runConfig.Env = env + b.runConfig.Cmd = saveCmd + if err := b.commit(c.ID, cmd, "run"); err != nil { + return err + } + + return nil +} + +// CMD foo +// +// Set the default command to run in the container (which may be empty). +// Argument handling is the same as RUN. +// +func cmd(b *Builder, args []string, attributes map[string]bool, original string) error { + if err := b.flags.Parse(); err != nil { + return err + } + + cmdSlice := handleJSONArgs(args, attributes) + + if !attributes["json"] { + if runtime.GOOS != "windows" { + cmdSlice = append([]string{"/bin/sh", "-c"}, cmdSlice...) + } else { + cmdSlice = append([]string{"cmd", "/S", "/C"}, cmdSlice...) + } + } + + b.runConfig.Cmd = stringutils.NewStrSlice(cmdSlice...) + + if err := b.commit("", b.runConfig.Cmd, fmt.Sprintf("CMD %q", cmdSlice)); err != nil { + return err + } + + if len(args) != 0 { + b.cmdSet = true + } + + return nil +} + +// ENTRYPOINT /usr/sbin/nginx +// +// Set the entrypoint (which defaults to sh -c on linux, or cmd /S /C on Windows) to +// /usr/sbin/nginx. Will accept the CMD as the arguments to /usr/sbin/nginx. +// +// Handles command processing similar to CMD and RUN, only b.runConfig.Entrypoint +// is initialized at NewBuilder time instead of through argument parsing. +// +func entrypoint(b *Builder, args []string, attributes map[string]bool, original string) error { + if err := b.flags.Parse(); err != nil { + return err + } + + parsed := handleJSONArgs(args, attributes) + + switch { + case attributes["json"]: + // ENTRYPOINT ["echo", "hi"] + b.runConfig.Entrypoint = stringutils.NewStrSlice(parsed...) + case len(parsed) == 0: + // ENTRYPOINT [] + b.runConfig.Entrypoint = nil + default: + // ENTRYPOINT echo hi + if runtime.GOOS != "windows" { + b.runConfig.Entrypoint = stringutils.NewStrSlice("/bin/sh", "-c", parsed[0]) + } else { + b.runConfig.Entrypoint = stringutils.NewStrSlice("cmd", "/S /C", parsed[0]) + } + } + + // when setting the entrypoint if a CMD was not explicitly set then + // set the command to nil + if !b.cmdSet { + b.runConfig.Cmd = nil + } + + if err := b.commit("", b.runConfig.Cmd, fmt.Sprintf("ENTRYPOINT %q", b.runConfig.Entrypoint)); err != nil { + return err + } + + return nil +} + +// EXPOSE 6667/tcp 7000/tcp +// +// Expose ports for links and port mappings. This all ends up in +// b.runConfig.ExposedPorts for runconfig. +// +func expose(b *Builder, args []string, attributes map[string]bool, original string) error { + portsTab := args + + if len(args) == 0 { + return derr.ErrorCodeAtLeastOneArg.WithArgs("EXPOSE") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + if b.runConfig.ExposedPorts == nil { + b.runConfig.ExposedPorts = make(nat.PortSet) + } + + ports, _, err := nat.ParsePortSpecs(portsTab) + if err != nil { + return err + } + + // instead of using ports directly, we build a list of ports and sort it so + // the order is consistent. This prevents cache burst where map ordering + // changes between builds + portList := make([]string, len(ports)) + var i int + for port := range ports { + if _, exists := b.runConfig.ExposedPorts[port]; !exists { + b.runConfig.ExposedPorts[port] = struct{}{} + } + portList[i] = string(port) + i++ + } + sort.Strings(portList) + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("EXPOSE %s", strings.Join(portList, " "))) +} + +// USER foo +// +// Set the user to 'foo' for future commands and when running the +// ENTRYPOINT/CMD at container run time. +// +func user(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) != 1 { + return derr.ErrorCodeExactlyOneArg.WithArgs("USER") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + b.runConfig.User = args[0] + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("USER %v", args)) +} + +// VOLUME /foo +// +// Expose the volume /foo for use. Will also accept the JSON array form. +// +func volume(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) == 0 { + return derr.ErrorCodeAtLeastOneArg.WithArgs("VOLUME") + } + + if err := b.flags.Parse(); err != nil { + return err + } + + if b.runConfig.Volumes == nil { + b.runConfig.Volumes = map[string]struct{}{} + } + for _, v := range args { + v = strings.TrimSpace(v) + if v == "" { + return derr.ErrorCodeVolumeEmpty + } + b.runConfig.Volumes[v] = struct{}{} + } + if err := b.commit("", b.runConfig.Cmd, fmt.Sprintf("VOLUME %v", args)); err != nil { + return err + } + return nil +} + +// STOPSIGNAL signal +// +// Set the signal that will be used to kill the container. +func stopSignal(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) != 1 { + return fmt.Errorf("STOPSIGNAL requires exactly one argument") + } + + sig := args[0] + _, err := signal.ParseSignal(sig) + if err != nil { + return err + } + + b.runConfig.StopSignal = sig + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("STOPSIGNAL %v", args)) +} + +// ARG name[=value] +// +// Adds the variable foo to the trusted list of variables that can be passed +// to builder using the --build-arg flag for expansion/subsitution or passing to 'run'. +// Dockerfile author may optionally set a default value of this variable. +func arg(b *Builder, args []string, attributes map[string]bool, original string) error { + if len(args) != 1 { + return fmt.Errorf("ARG requires exactly one argument definition") + } + + var ( + name string + value string + hasDefault bool + ) + + arg := args[0] + // 'arg' can just be a name or name-value pair. Note that this is different + // from 'env' that handles the split of name and value at the parser level. + // The reason for doing it differently for 'arg' is that we support just + // defining an arg and not assign it a value (while 'env' always expects a + // name-value pair). If possible, it will be good to harmonize the two. + if strings.Contains(arg, "=") { + parts := strings.SplitN(arg, "=", 2) + name = parts[0] + value = parts[1] + hasDefault = true + } else { + name = arg + hasDefault = false + } + // add the arg to allowed list of build-time args from this step on. + b.allowedBuildArgs[name] = true + + // If there is a default value associated with this arg then add it to the + // b.buildArgs if one is not already passed to the builder. The args passed + // to builder override the defaut value of 'arg'. + if _, ok := b.BuildArgs[name]; !ok && hasDefault { + b.BuildArgs[name] = value + } + + return b.commit("", b.runConfig.Cmd, fmt.Sprintf("ARG %s", arg)) +} diff --git a/builder/dockerfile/evaluator.go b/builder/dockerfile/evaluator.go new file mode 100644 index 0000000000..0629ee9bbc --- /dev/null +++ b/builder/dockerfile/evaluator.go @@ -0,0 +1,193 @@ +// Package dockerfile is the evaluation step in the Dockerfile parse/evaluate pipeline. +// +// It incorporates a dispatch table based on the parser.Node values (see the +// parser package for more information) that are yielded from the parser itself. +// Calling NewBuilder with the BuildOpts struct can be used to customize the +// experience for execution purposes only. Parsing is controlled in the parser +// package, and this division of resposibility should be respected. +// +// Please see the jump table targets for the actual invocations, most of which +// will call out to the functions in internals.go to deal with their tasks. +// +// ONBUILD is a special case, which is covered in the onbuild() func in +// dispatchers.go. +// +// The evaluator uses the concept of "steps", which are usually each processable +// line in the Dockerfile. Each step is numbered and certain actions are taken +// before and after each step, such as creating an image ID and removing temporary +// containers and images. Note that ONBUILD creates a kinda-sorta "sub run" which +// includes its own set of steps (usually only one of them). +package dockerfile + +import ( + "fmt" + "runtime" + "strings" + + "github.com/docker/docker/builder/dockerfile/command" + "github.com/docker/docker/builder/dockerfile/parser" +) + +// Environment variable interpolation will happen on these statements only. +var replaceEnvAllowed = map[string]struct{}{ + command.Env: {}, + command.Label: {}, + command.Add: {}, + command.Copy: {}, + command.Workdir: {}, + command.Expose: {}, + command.Volume: {}, + command.User: {}, + command.StopSignal: {}, + command.Arg: {}, +} + +var evaluateTable map[string]func(*Builder, []string, map[string]bool, string) error + +func init() { + evaluateTable = map[string]func(*Builder, []string, map[string]bool, string) error{ + command.Env: env, + command.Label: label, + command.Maintainer: maintainer, + command.Add: add, + command.Copy: dispatchCopy, // copy() is a go builtin + command.From: from, + command.Onbuild: onbuild, + command.Workdir: workdir, + command.Run: run, + command.Cmd: cmd, + command.Entrypoint: entrypoint, + command.Expose: expose, + command.Volume: volume, + command.User: user, + command.StopSignal: stopSignal, + command.Arg: arg, + } +} + +// This method is the entrypoint to all statement handling routines. +// +// Almost all nodes will have this structure: +// Child[Node, Node, Node] where Child is from parser.Node.Children and each +// node comes from parser.Node.Next. This forms a "line" with a statement and +// arguments and we process them in this normalized form by hitting +// evaluateTable with the leaf nodes of the command and the Builder object. +// +// ONBUILD is a special case; in this case the parser will emit: +// Child[Node, Child[Node, Node...]] where the first node is the literal +// "onbuild" and the child entrypoint is the command of the ONBUILD statement, +// such as `RUN` in ONBUILD RUN foo. There is special case logic in here to +// deal with that, at least until it becomes more of a general concern with new +// features. +func (b *Builder) dispatch(stepN int, ast *parser.Node) error { + cmd := ast.Value + upperCasedCmd := strings.ToUpper(cmd) + + // To ensure the user is given a decent error message if the platform + // on which the daemon is running does not support a builder command. + if err := platformSupports(strings.ToLower(cmd)); err != nil { + return err + } + + attrs := ast.Attributes + original := ast.Original + flags := ast.Flags + strs := []string{} + msg := fmt.Sprintf("Step %d : %s", stepN+1, upperCasedCmd) + + if len(ast.Flags) > 0 { + msg += " " + strings.Join(ast.Flags, " ") + } + + if cmd == "onbuild" { + if ast.Next == nil { + return fmt.Errorf("ONBUILD requires at least one argument") + } + ast = ast.Next.Children[0] + strs = append(strs, ast.Value) + msg += " " + ast.Value + + if len(ast.Flags) > 0 { + msg += " " + strings.Join(ast.Flags, " ") + } + + } + + // count the number of nodes that we are going to traverse first + // so we can pre-create the argument and message array. This speeds up the + // allocation of those list a lot when they have a lot of arguments + cursor := ast + var n int + for cursor.Next != nil { + cursor = cursor.Next + n++ + } + l := len(strs) + strList := make([]string, n+l) + copy(strList, strs) + msgList := make([]string, n) + + var i int + // Append the build-time args to config-environment. + // This allows builder config to override the variables, making the behavior similar to + // a shell script i.e. `ENV foo bar` overrides value of `foo` passed in build + // context. But `ENV foo $foo` will use the value from build context if one + // isn't already been defined by a previous ENV primitive. + // Note, we get this behavior because we know that ProcessWord() will + // stop on the first occurrence of a variable name and not notice + // a subsequent one. So, putting the buildArgs list after the Config.Env + // list, in 'envs', is safe. + envs := b.runConfig.Env + for key, val := range b.BuildArgs { + if !b.isBuildArgAllowed(key) { + // skip build-args that are not in allowed list, meaning they have + // not been defined by an "ARG" Dockerfile command yet. + // This is an error condition but only if there is no "ARG" in the entire + // Dockerfile, so we'll generate any necessary errors after we parsed + // the entire file (see 'leftoverArgs' processing in evaluator.go ) + continue + } + envs = append(envs, fmt.Sprintf("%s=%s", key, val)) + } + for ast.Next != nil { + ast = ast.Next + var str string + str = ast.Value + if _, ok := replaceEnvAllowed[cmd]; ok { + var err error + str, err = ProcessWord(ast.Value, envs) + if err != nil { + return err + } + } + strList[i+l] = str + msgList[i] = ast.Value + i++ + } + + msg += " " + strings.Join(msgList, " ") + fmt.Fprintln(b.Stdout, msg) + + // XXX yes, we skip any cmds that are not valid; the parser should have + // picked these out already. + if f, ok := evaluateTable[cmd]; ok { + b.flags = NewBFlags() + b.flags.Args = flags + return f(b, strList, attrs, original) + } + + return fmt.Errorf("Unknown instruction: %s", upperCasedCmd) +} + +// platformSupports is a short-term function to give users a quality error +// message if a Dockerfile uses a command not supported on the platform. +func platformSupports(command string) error { + if runtime.GOOS != "windows" { + return nil + } + switch command { + case "expose", "volume", "user", "stopsignal", "arg": + return fmt.Errorf("The daemon on this platform does not support the command '%s'", command) + } + return nil +} diff --git a/builder/dockerfile/internals.go b/builder/dockerfile/internals.go new file mode 100644 index 0000000000..92278503ac --- /dev/null +++ b/builder/dockerfile/internals.go @@ -0,0 +1,663 @@ +package dockerfile + +// internals for handling commands. Covers many areas and a lot of +// non-contiguous functionality. Please read the comments. + +import ( + "crypto/sha256" + "encoding/hex" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/url" + "os" + "path/filepath" + "runtime" + "sort" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/builder" + "github.com/docker/docker/builder/dockerfile/parser" + "github.com/docker/docker/daemon" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/jsonmessage" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/tarsum" + "github.com/docker/docker/pkg/urlutil" + "github.com/docker/docker/runconfig" +) + +func (b *Builder) commit(id string, autoCmd *stringutils.StrSlice, comment string) error { + if b.disableCommit { + return nil + } + if b.image == "" && !b.noBaseImage { + return fmt.Errorf("Please provide a source image with `from` prior to commit") + } + b.runConfig.Image = b.image + if id == "" { + cmd := b.runConfig.Cmd + if runtime.GOOS != "windows" { + b.runConfig.Cmd = stringutils.NewStrSlice("/bin/sh", "-c", "#(nop) "+comment) + } else { + b.runConfig.Cmd = stringutils.NewStrSlice("cmd", "/S /C", "REM (nop) "+comment) + } + defer func(cmd *stringutils.StrSlice) { b.runConfig.Cmd = cmd }(cmd) + + if hit, err := b.probeCache(); err != nil { + return err + } else if hit { + return nil + } + + container, err := b.create() + if err != nil { + return err + } + id = container.ID + + if err := container.Mount(); err != nil { + return err + } + defer container.Unmount() + } + + container, err := b.docker.Container(id) + if err != nil { + return err + } + + // Note: Actually copy the struct + autoConfig := *b.runConfig + autoConfig.Cmd = autoCmd + + commitCfg := &daemon.ContainerCommitConfig{ + Author: b.maintainer, + Pause: true, + Config: &autoConfig, + } + + // Commit the container + image, err := b.docker.Commit(container, commitCfg) + if err != nil { + return err + } + b.docker.Retain(b.id, image.ID) + b.activeImages = append(b.activeImages, image.ID) + b.image = image.ID + return nil +} + +type copyInfo struct { + builder.FileInfo + decompress bool +} + +func (b *Builder) runContextCommand(args []string, allowRemote bool, allowLocalDecompression bool, cmdName string) error { + if b.context == nil { + return fmt.Errorf("No context given. Impossible to use %s", cmdName) + } + + if len(args) < 2 { + return fmt.Errorf("Invalid %s format - at least two arguments required", cmdName) + } + + // Work in daemon-specific filepath semantics + dest := filepath.FromSlash(args[len(args)-1]) // last one is always the dest + + b.runConfig.Image = b.image + + var infos []copyInfo + + // Loop through each src file and calculate the info we need to + // do the copy (e.g. hash value if cached). Don't actually do + // the copy until we've looked at all src files + var err error + for _, orig := range args[0 : len(args)-1] { + var fi builder.FileInfo + decompress := allowLocalDecompression + if urlutil.IsURL(orig) { + if !allowRemote { + return fmt.Errorf("Source can't be a URL for %s", cmdName) + } + fi, err = b.download(orig) + if err != nil { + return err + } + defer os.RemoveAll(filepath.Dir(fi.Path())) + decompress = false + infos = append(infos, copyInfo{fi, decompress}) + continue + } + // not a URL + subInfos, err := b.calcCopyInfo(cmdName, orig, allowLocalDecompression, true) + if err != nil { + return err + } + + infos = append(infos, subInfos...) + } + + if len(infos) == 0 { + return fmt.Errorf("No source files were specified") + } + if len(infos) > 1 && !strings.HasSuffix(dest, string(os.PathSeparator)) { + return fmt.Errorf("When using %s with more than one source file, the destination must be a directory and end with a /", cmdName) + } + + // For backwards compat, if there's just one info then use it as the + // cache look-up string, otherwise hash 'em all into one + var srcHash string + var origPaths string + + if len(infos) == 1 { + fi := infos[0].FileInfo + origPaths = fi.Name() + if hfi, ok := fi.(builder.Hashed); ok { + srcHash = hfi.Hash() + } + } else { + var hashs []string + var origs []string + for _, info := range infos { + fi := info.FileInfo + origs = append(origs, fi.Name()) + if hfi, ok := fi.(builder.Hashed); ok { + hashs = append(hashs, hfi.Hash()) + } + } + hasher := sha256.New() + hasher.Write([]byte(strings.Join(hashs, ","))) + srcHash = "multi:" + hex.EncodeToString(hasher.Sum(nil)) + origPaths = strings.Join(origs, " ") + } + + cmd := b.runConfig.Cmd + if runtime.GOOS != "windows" { + b.runConfig.Cmd = stringutils.NewStrSlice("/bin/sh", "-c", fmt.Sprintf("#(nop) %s %s in %s", cmdName, srcHash, dest)) + } else { + b.runConfig.Cmd = stringutils.NewStrSlice("cmd", "/S /C", fmt.Sprintf("REM (nop) %s %s in %s", cmdName, srcHash, dest)) + } + defer func(cmd *stringutils.StrSlice) { b.runConfig.Cmd = cmd }(cmd) + + if hit, err := b.probeCache(); err != nil { + return err + } else if hit { + return nil + } + + container, _, err := b.docker.Create(b.runConfig, nil) + if err != nil { + return err + } + defer container.Unmount() + b.tmpContainers[container.ID] = struct{}{} + + comment := fmt.Sprintf("%s %s in %s", cmdName, origPaths, dest) + + // Twiddle the destination when its a relative path - meaning, make it + // relative to the WORKINGDIR + if !system.IsAbs(dest) { + hasSlash := strings.HasSuffix(dest, string(os.PathSeparator)) + dest = filepath.Join(string(os.PathSeparator), filepath.FromSlash(b.runConfig.WorkingDir), dest) + + // Make sure we preserve any trailing slash + if hasSlash { + dest += string(os.PathSeparator) + } + } + + for _, info := range infos { + if err := b.docker.Copy(container, dest, info.FileInfo, info.decompress); err != nil { + return err + } + } + + if err := b.commit(container.ID, cmd, comment); err != nil { + return err + } + return nil +} + +func (b *Builder) download(srcURL string) (fi builder.FileInfo, err error) { + // get filename from URL + u, err := url.Parse(srcURL) + if err != nil { + return + } + path := filepath.FromSlash(u.Path) // Ensure in platform semantics + if strings.HasSuffix(path, string(os.PathSeparator)) { + path = path[:len(path)-1] + } + parts := strings.Split(path, string(os.PathSeparator)) + filename := parts[len(parts)-1] + if filename == "" { + err = fmt.Errorf("cannot determine filename from url: %s", u) + return + } + + // Initiate the download + resp, err := httputils.Download(srcURL) + if err != nil { + return + } + + // Prepare file in a tmp dir + tmpDir, err := ioutils.TempDir("", "docker-remote") + if err != nil { + return + } + defer func() { + if err != nil { + os.RemoveAll(tmpDir) + } + }() + tmpFileName := filepath.Join(tmpDir, filename) + tmpFile, err := os.OpenFile(tmpFileName, os.O_RDWR|os.O_CREATE|os.O_EXCL, 0600) + if err != nil { + return + } + + // Download and dump result to tmp file + if _, err = io.Copy(tmpFile, progressreader.New(progressreader.Config{ + In: resp.Body, + // TODO: make progressreader streamformatter agnostic + Out: b.Stdout.(*streamformatter.StdoutFormatter).Writer, + Formatter: b.Stdout.(*streamformatter.StdoutFormatter).StreamFormatter, + Size: resp.ContentLength, + NewLines: true, + ID: "", + Action: "Downloading", + })); err != nil { + tmpFile.Close() + return + } + fmt.Fprintln(b.Stdout) + // ignoring error because the file was already opened successfully + tmpFileSt, err := tmpFile.Stat() + if err != nil { + return + } + tmpFile.Close() + + // Set the mtime to the Last-Modified header value if present + // Otherwise just remove atime and mtime + mTime := time.Time{} + + lastMod := resp.Header.Get("Last-Modified") + if lastMod != "" { + // If we can't parse it then just let it default to 'zero' + // otherwise use the parsed time value + if parsedMTime, err := http.ParseTime(lastMod); err == nil { + mTime = parsedMTime + } + } + + if err = system.Chtimes(tmpFileName, time.Time{}, mTime); err != nil { + return + } + + // Calc the checksum, even if we're using the cache + r, err := archive.Tar(tmpFileName, archive.Uncompressed) + if err != nil { + return + } + tarSum, err := tarsum.NewTarSum(r, true, tarsum.Version1) + if err != nil { + return + } + if _, err = io.Copy(ioutil.Discard, tarSum); err != nil { + return + } + hash := tarSum.Sum(nil) + r.Close() + return &builder.HashedFileInfo{FileInfo: builder.PathFileInfo{FileInfo: tmpFileSt, FilePath: tmpFileName}, FileHash: hash}, nil +} + +func (b *Builder) calcCopyInfo(cmdName, origPath string, allowLocalDecompression, allowWildcards bool) ([]copyInfo, error) { + + // Work in daemon-specific OS filepath semantics + origPath = filepath.FromSlash(origPath) + + if origPath != "" && origPath[0] == os.PathSeparator && len(origPath) > 1 { + origPath = origPath[1:] + } + origPath = strings.TrimPrefix(origPath, "."+string(os.PathSeparator)) + + // Deal with wildcards + if allowWildcards && containsWildcards(origPath) { + var copyInfos []copyInfo + if err := b.context.Walk("", func(path string, info builder.FileInfo, err error) error { + if err != nil { + return err + } + if info.Name() == "" { + // Why are we doing this check? + return nil + } + if match, _ := filepath.Match(origPath, path); !match { + return nil + } + + // Note we set allowWildcards to false in case the name has + // a * in it + subInfos, err := b.calcCopyInfo(cmdName, path, allowLocalDecompression, false) + if err != nil { + return err + } + copyInfos = append(copyInfos, subInfos...) + return nil + }); err != nil { + return nil, err + } + return copyInfos, nil + } + + // Must be a dir or a file + + statPath, fi, err := b.context.Stat(origPath) + if err != nil { + return nil, err + } + + copyInfos := []copyInfo{{FileInfo: fi, decompress: allowLocalDecompression}} + + hfi, handleHash := fi.(builder.Hashed) + if !handleHash { + return copyInfos, nil + } + + // Deal with the single file case + if !fi.IsDir() { + hfi.SetHash("file:" + hfi.Hash()) + return copyInfos, nil + } + // Must be a dir + var subfiles []string + err = b.context.Walk(statPath, func(path string, info builder.FileInfo, err error) error { + if err != nil { + return err + } + // we already checked handleHash above + subfiles = append(subfiles, info.(builder.Hashed).Hash()) + return nil + }) + if err != nil { + return nil, err + } + + sort.Strings(subfiles) + hasher := sha256.New() + hasher.Write([]byte(strings.Join(subfiles, ","))) + hfi.SetHash("dir:" + hex.EncodeToString(hasher.Sum(nil))) + + return copyInfos, nil +} + +func containsWildcards(name string) bool { + for i := 0; i < len(name); i++ { + ch := name[i] + if ch == '\\' { + i++ + } else if ch == '*' || ch == '?' || ch == '[' { + return true + } + } + return false +} + +func (b *Builder) processImageFrom(img *image.Image) error { + b.image = img.ID + + if img.Config != nil { + b.runConfig = img.Config + } + + // The default path will be blank on Windows (set by HCS) + if len(b.runConfig.Env) == 0 && daemon.DefaultPathEnv != "" { + b.runConfig.Env = append(b.runConfig.Env, "PATH="+daemon.DefaultPathEnv) + } + + // Process ONBUILD triggers if they exist + if nTriggers := len(b.runConfig.OnBuild); nTriggers != 0 { + word := "trigger" + if nTriggers > 1 { + word = "triggers" + } + fmt.Fprintf(b.Stderr, "# Executing %d build %s...\n", nTriggers, word) + } + + // Copy the ONBUILD triggers, and remove them from the config, since the config will be committed. + onBuildTriggers := b.runConfig.OnBuild + b.runConfig.OnBuild = []string{} + + // parse the ONBUILD triggers by invoking the parser + for _, step := range onBuildTriggers { + ast, err := parser.Parse(strings.NewReader(step)) + if err != nil { + return err + } + + for i, n := range ast.Children { + switch strings.ToUpper(n.Value) { + case "ONBUILD": + return fmt.Errorf("Chaining ONBUILD via `ONBUILD ONBUILD` isn't allowed") + case "MAINTAINER", "FROM": + return fmt.Errorf("%s isn't allowed as an ONBUILD trigger", n.Value) + } + + if err := b.dispatch(i, n); err != nil { + return err + } + } + } + + return nil +} + +// probeCache checks if `b.docker` implements builder.ImageCache and image-caching +// is enabled (`b.UseCache`). +// If so attempts to look up the current `b.image` and `b.runConfig` pair with `b.docker`. +// If an image is found, probeCache returns `(true, nil)`. +// If no image is found, it returns `(false, nil)`. +// If there is any error, it returns `(false, err)`. +func (b *Builder) probeCache() (bool, error) { + c, ok := b.docker.(builder.ImageCache) + if !ok || !b.UseCache || b.cacheBusted { + return false, nil + } + cache, err := c.GetCachedImage(b.image, b.runConfig) + if err != nil { + return false, err + } + if len(cache) == 0 { + logrus.Debugf("[BUILDER] Cache miss: %s", b.runConfig.Cmd) + b.cacheBusted = true + return false, nil + } + + fmt.Fprintf(b.Stdout, " ---> Using cache\n") + logrus.Debugf("[BUILDER] Use cached version: %s", b.runConfig.Cmd) + b.image = string(cache) + + // TODO: remove once Commit can take a tag parameter. + b.docker.Retain(b.id, b.image) + b.activeImages = append(b.activeImages, b.image) + + return true, nil +} + +func (b *Builder) create() (*daemon.Container, error) { + if b.image == "" && !b.noBaseImage { + return nil, fmt.Errorf("Please provide a source image with `from` prior to run") + } + b.runConfig.Image = b.image + + // TODO: why not embed a hostconfig in builder? + hostConfig := &runconfig.HostConfig{ + CPUShares: b.CPUShares, + CPUPeriod: b.CPUPeriod, + CPUQuota: b.CPUQuota, + CpusetCpus: b.CPUSetCpus, + CpusetMems: b.CPUSetMems, + CgroupParent: b.CgroupParent, + Memory: b.Memory, + MemorySwap: b.MemorySwap, + Ulimits: b.Ulimits, + } + + config := *b.runConfig + + // Create the container + c, warnings, err := b.docker.Create(b.runConfig, hostConfig) + if err != nil { + return nil, err + } + defer c.Unmount() + for _, warning := range warnings { + fmt.Fprintf(b.Stdout, " ---> [Warning] %s\n", warning) + } + + b.tmpContainers[c.ID] = struct{}{} + fmt.Fprintf(b.Stdout, " ---> Running in %s\n", stringid.TruncateID(c.ID)) + + if config.Cmd.Len() > 0 { + // override the entry point that may have been picked up from the base image + s := config.Cmd.Slice() + c.Path = s[0] + c.Args = s[1:] + } + + return c, nil +} + +func (b *Builder) run(c *daemon.Container) error { + var errCh chan error + if b.Verbose { + errCh = c.Attach(nil, b.Stdout, b.Stderr) + } + + //start the container + if err := c.Start(); err != nil { + return err + } + + finished := make(chan struct{}) + defer close(finished) + go func() { + select { + case <-b.cancelled: + logrus.Debugln("Build cancelled, killing container:", c.ID) + c.Kill() + case <-finished: + } + }() + + if b.Verbose { + // Block on reading output from container, stop on err or chan closed + if err := <-errCh; err != nil { + return err + } + } + + // Wait for it to finish + if ret, _ := c.WaitStop(-1 * time.Second); ret != 0 { + // TODO: change error type, because jsonmessage.JSONError assumes HTTP + return &jsonmessage.JSONError{ + Message: fmt.Sprintf("The command '%s' returned a non-zero code: %d", b.runConfig.Cmd.ToString(), ret), + Code: ret, + } + } + + return nil +} + +func (b *Builder) clearTmp() { + for c := range b.tmpContainers { + rmConfig := &daemon.ContainerRmConfig{ + ForceRemove: true, + RemoveVolume: true, + } + if err := b.docker.Remove(c, rmConfig); err != nil { + fmt.Fprintf(b.Stdout, "Error removing intermediate container %s: %v\n", stringid.TruncateID(c), err) + return + } + delete(b.tmpContainers, c) + fmt.Fprintf(b.Stdout, "Removing intermediate container %s\n", stringid.TruncateID(c)) + } +} + +// readDockerfile reads a Dockerfile from the current context. +func (b *Builder) readDockerfile() error { + // If no -f was specified then look for 'Dockerfile'. If we can't find + // that then look for 'dockerfile'. If neither are found then default + // back to 'Dockerfile' and use that in the error message. + if b.DockerfileName == "" { + b.DockerfileName = api.DefaultDockerfileName + if _, _, err := b.context.Stat(b.DockerfileName); os.IsNotExist(err) { + lowercase := strings.ToLower(b.DockerfileName) + if _, _, err := b.context.Stat(lowercase); err == nil { + b.DockerfileName = lowercase + } + } + } + + f, err := b.context.Open(b.DockerfileName) + if err != nil { + if os.IsNotExist(err) { + return fmt.Errorf("Cannot locate specified Dockerfile: %s", b.DockerfileName) + } + return err + } + if f, ok := f.(*os.File); ok { + // ignoring error because Open already succeeded + fi, err := f.Stat() + if err != nil { + return fmt.Errorf("Unexpected error reading Dockerfile: %v", err) + } + if fi.Size() == 0 { + return fmt.Errorf("The Dockerfile (%s) cannot be empty", b.DockerfileName) + } + } + b.dockerfile, err = parser.Parse(f) + f.Close() + if err != nil { + return err + } + + // After the Dockerfile has been parsed, we need to check the .dockerignore + // file for either "Dockerfile" or ".dockerignore", and if either are + // present then erase them from the build context. These files should never + // have been sent from the client but we did send them to make sure that + // we had the Dockerfile to actually parse, and then we also need the + // .dockerignore file to know whether either file should be removed. + // Note that this assumes the Dockerfile has been read into memory and + // is now safe to be removed. + if dockerIgnore, ok := b.context.(builder.DockerIgnoreContext); ok { + dockerIgnore.Process([]string{b.DockerfileName}) + } + return nil +} + +// determine if build arg is part of built-in args or user +// defined args in Dockerfile at any point in time. +func (b *Builder) isBuildArgAllowed(arg string) bool { + if _, ok := BuiltinAllowedBuildArgs[arg]; ok { + return true + } + if _, ok := b.allowedBuildArgs[arg]; ok { + return true + } + return false +} diff --git a/builder/dockerfile/internals_unix.go b/builder/dockerfile/internals_unix.go new file mode 100644 index 0000000000..2b2eee5114 --- /dev/null +++ b/builder/dockerfile/internals_unix.go @@ -0,0 +1,40 @@ +// +build !windows + +package dockerfile + +import ( + "os" + "path/filepath" +) + +func fixPermissions(source, destination string, uid, gid int, destExisted bool) error { + // If the destination didn't already exist, or the destination isn't a + // directory, then we should Lchown the destination. Otherwise, we shouldn't + // Lchown the destination. + destStat, err := os.Stat(destination) + if err != nil { + // This should *never* be reached, because the destination must've already + // been created while untar-ing the context. + return err + } + doChownDestination := !destExisted || !destStat.IsDir() + + // We Walk on the source rather than on the destination because we don't + // want to change permissions on things we haven't created or modified. + return filepath.Walk(source, func(fullpath string, info os.FileInfo, err error) error { + // Do not alter the walk root iff. it existed before, as it doesn't fall under + // the domain of "things we should chown". + if !doChownDestination && (source == fullpath) { + return nil + } + + // Path is prefixed by source: substitute with destination instead. + cleaned, err := filepath.Rel(source, fullpath) + if err != nil { + return err + } + + fullpath = filepath.Join(destination, cleaned) + return os.Lchown(fullpath, uid, gid) + }) +} diff --git a/builder/dockerfile/internals_windows.go b/builder/dockerfile/internals_windows.go new file mode 100644 index 0000000000..78664246df --- /dev/null +++ b/builder/dockerfile/internals_windows.go @@ -0,0 +1,8 @@ +// +build windows + +package dockerfile + +func fixPermissions(source, destination string, uid, gid int, destExisted bool) error { + // chown is not supported on Windows + return nil +} diff --git a/builder/dockerfile/parser/dumper/main.go b/builder/dockerfile/parser/dumper/main.go new file mode 100644 index 0000000000..33202b7038 --- /dev/null +++ b/builder/dockerfile/parser/dumper/main.go @@ -0,0 +1,32 @@ +package main + +import ( + "fmt" + "os" + + "github.com/docker/docker/builder/parser" +) + +func main() { + var f *os.File + var err error + + if len(os.Args) < 2 { + fmt.Println("please supply filename(s)") + os.Exit(1) + } + + for _, fn := range os.Args[1:] { + f, err = os.Open(fn) + if err != nil { + panic(err) + } + + ast, err := parser.Parse(f) + if err != nil { + panic(err) + } else { + fmt.Println(ast.Dump()) + } + } +} diff --git a/builder/dockerfile/parser/json_test.go b/builder/dockerfile/parser/json_test.go new file mode 100644 index 0000000000..a256f845d3 --- /dev/null +++ b/builder/dockerfile/parser/json_test.go @@ -0,0 +1,55 @@ +package parser + +import ( + "testing" +) + +var invalidJSONArraysOfStrings = []string{ + `["a",42,"b"]`, + `["a",123.456,"b"]`, + `["a",{},"b"]`, + `["a",{"c": "d"},"b"]`, + `["a",["c"],"b"]`, + `["a",true,"b"]`, + `["a",false,"b"]`, + `["a",null,"b"]`, +} + +var validJSONArraysOfStrings = map[string][]string{ + `[]`: {}, + `[""]`: {""}, + `["a"]`: {"a"}, + `["a","b"]`: {"a", "b"}, + `[ "a", "b" ]`: {"a", "b"}, + `[ "a", "b" ]`: {"a", "b"}, + ` [ "a", "b" ] `: {"a", "b"}, + `["abc 123", "♥", "☃", "\" \\ \/ \b \f \n \r \t \u0000"]`: {"abc 123", "♥", "☃", "\" \\ / \b \f \n \r \t \u0000"}, +} + +func TestJSONArraysOfStrings(t *testing.T) { + for json, expected := range validJSONArraysOfStrings { + if node, _, err := parseJSON(json); err != nil { + t.Fatalf("%q should be a valid JSON array of strings, but wasn't! (err: %q)", json, err) + } else { + i := 0 + for node != nil { + if i >= len(expected) { + t.Fatalf("expected result is shorter than parsed result (%d vs %d+) in %q", len(expected), i+1, json) + } + if node.Value != expected[i] { + t.Fatalf("expected %q (not %q) in %q at pos %d", expected[i], node.Value, json, i) + } + node = node.Next + i++ + } + if i != len(expected) { + t.Fatalf("expected result is longer than parsed result (%d vs %d) in %q", len(expected), i+1, json) + } + } + } + for _, json := range invalidJSONArraysOfStrings { + if _, _, err := parseJSON(json); err != errDockerfileNotStringArray { + t.Fatalf("%q should be an invalid JSON array of strings, but wasn't!", json) + } + } +} diff --git a/builder/dockerfile/parser/line_parsers.go b/builder/dockerfile/parser/line_parsers.go new file mode 100644 index 0000000000..b8792708d5 --- /dev/null +++ b/builder/dockerfile/parser/line_parsers.go @@ -0,0 +1,331 @@ +package parser + +// line parsers are dispatch calls that parse a single unit of text into a +// Node object which contains the whole statement. Dockerfiles have varied +// (but not usually unique, see ONBUILD for a unique example) parsing rules +// per-command, and these unify the processing in a way that makes it +// manageable. + +import ( + "encoding/json" + "errors" + "fmt" + "strings" + "unicode" +) + +var ( + errDockerfileNotStringArray = errors.New("When using JSON array syntax, arrays must be comprised of strings only.") +) + +// ignore the current argument. This will still leave a command parsed, but +// will not incorporate the arguments into the ast. +func parseIgnore(rest string) (*Node, map[string]bool, error) { + return &Node{}, nil, nil +} + +// used for onbuild. Could potentially be used for anything that represents a +// statement with sub-statements. +// +// ONBUILD RUN foo bar -> (onbuild (run foo bar)) +// +func parseSubCommand(rest string) (*Node, map[string]bool, error) { + if rest == "" { + return nil, nil, nil + } + + _, child, err := parseLine(rest) + if err != nil { + return nil, nil, err + } + + return &Node{Children: []*Node{child}}, nil, nil +} + +// helper to parse words (i.e space delimited or quoted strings) in a statement. +// The quotes are preserved as part of this function and they are stripped later +// as part of processWords(). +func parseWords(rest string) []string { + const ( + inSpaces = iota // looking for start of a word + inWord + inQuote + ) + + words := []string{} + phase := inSpaces + word := "" + quote := '\000' + blankOK := false + var ch rune + + for pos := 0; pos <= len(rest); pos++ { + if pos != len(rest) { + ch = rune(rest[pos]) + } + + if phase == inSpaces { // Looking for start of word + if pos == len(rest) { // end of input + break + } + if unicode.IsSpace(ch) { // skip spaces + continue + } + phase = inWord // found it, fall thru + } + if (phase == inWord || phase == inQuote) && (pos == len(rest)) { + if blankOK || len(word) > 0 { + words = append(words, word) + } + break + } + if phase == inWord { + if unicode.IsSpace(ch) { + phase = inSpaces + if blankOK || len(word) > 0 { + words = append(words, word) + } + word = "" + blankOK = false + continue + } + if ch == '\'' || ch == '"' { + quote = ch + blankOK = true + phase = inQuote + } + if ch == '\\' { + if pos+1 == len(rest) { + continue // just skip \ at end + } + // If we're not quoted and we see a \, then always just + // add \ plus the char to the word, even if the char + // is a quote. + word += string(ch) + pos++ + ch = rune(rest[pos]) + } + word += string(ch) + continue + } + if phase == inQuote { + if ch == quote { + phase = inWord + } + // \ is special except for ' quotes - can't escape anything for ' + if ch == '\\' && quote != '\'' { + if pos+1 == len(rest) { + phase = inWord + continue // just skip \ at end + } + pos++ + nextCh := rune(rest[pos]) + word += string(ch) + ch = nextCh + } + word += string(ch) + } + } + + return words +} + +// parse environment like statements. Note that this does *not* handle +// variable interpolation, which will be handled in the evaluator. +func parseNameVal(rest string, key string) (*Node, map[string]bool, error) { + // This is kind of tricky because we need to support the old + // variant: KEY name value + // as well as the new one: KEY name=value ... + // The trigger to know which one is being used will be whether we hit + // a space or = first. space ==> old, "=" ==> new + + words := parseWords(rest) + if len(words) == 0 { + return nil, nil, nil + } + + var rootnode *Node + + // Old format (KEY name value) + if !strings.Contains(words[0], "=") { + node := &Node{} + rootnode = node + strs := tokenWhitespace.Split(rest, 2) + + if len(strs) < 2 { + return nil, nil, fmt.Errorf(key + " must have two arguments") + } + + node.Value = strs[0] + node.Next = &Node{} + node.Next.Value = strs[1] + } else { + var prevNode *Node + for i, word := range words { + if !strings.Contains(word, "=") { + return nil, nil, fmt.Errorf("Syntax error - can't find = in %q. Must be of the form: name=value", word) + } + parts := strings.SplitN(word, "=", 2) + + name := &Node{} + value := &Node{} + + name.Next = value + name.Value = parts[0] + value.Value = parts[1] + + if i == 0 { + rootnode = name + } else { + prevNode.Next = name + } + prevNode = value + } + } + + return rootnode, nil, nil +} + +func parseEnv(rest string) (*Node, map[string]bool, error) { + return parseNameVal(rest, "ENV") +} + +func parseLabel(rest string) (*Node, map[string]bool, error) { + return parseNameVal(rest, "LABEL") +} + +// parses a statement containing one or more keyword definition(s) and/or +// value assignments, like `name1 name2= name3="" name4=value`. +// Note that this is a stricter format than the old format of assignment, +// allowed by parseNameVal(), in a way that this only allows assignment of the +// form `keyword=[]` like `name2=`, `name3=""`, and `name4=value` above. +// In addition, a keyword definition alone is of the form `keyword` like `name1` +// above. And the assignments `name2=` and `name3=""` are equivalent and +// assign an empty value to the respective keywords. +func parseNameOrNameVal(rest string) (*Node, map[string]bool, error) { + words := parseWords(rest) + if len(words) == 0 { + return nil, nil, nil + } + + var ( + rootnode *Node + prevNode *Node + ) + for i, word := range words { + node := &Node{} + node.Value = word + if i == 0 { + rootnode = node + } else { + prevNode.Next = node + } + prevNode = node + } + + return rootnode, nil, nil +} + +// parses a whitespace-delimited set of arguments. The result is effectively a +// linked list of string arguments. +func parseStringsWhitespaceDelimited(rest string) (*Node, map[string]bool, error) { + if rest == "" { + return nil, nil, nil + } + + node := &Node{} + rootnode := node + prevnode := node + for _, str := range tokenWhitespace.Split(rest, -1) { // use regexp + prevnode = node + node.Value = str + node.Next = &Node{} + node = node.Next + } + + // XXX to get around regexp.Split *always* providing an empty string at the + // end due to how our loop is constructed, nil out the last node in the + // chain. + prevnode.Next = nil + + return rootnode, nil, nil +} + +// parsestring just wraps the string in quotes and returns a working node. +func parseString(rest string) (*Node, map[string]bool, error) { + if rest == "" { + return nil, nil, nil + } + n := &Node{} + n.Value = rest + return n, nil, nil +} + +// parseJSON converts JSON arrays to an AST. +func parseJSON(rest string) (*Node, map[string]bool, error) { + rest = strings.TrimLeftFunc(rest, unicode.IsSpace) + if !strings.HasPrefix(rest, "[") { + return nil, nil, fmt.Errorf(`Error parsing "%s" as a JSON array`, rest) + } + + var myJSON []interface{} + if err := json.NewDecoder(strings.NewReader(rest)).Decode(&myJSON); err != nil { + return nil, nil, err + } + + var top, prev *Node + for _, str := range myJSON { + s, ok := str.(string) + if !ok { + return nil, nil, errDockerfileNotStringArray + } + + node := &Node{Value: s} + if prev == nil { + top = node + } else { + prev.Next = node + } + prev = node + } + + return top, map[string]bool{"json": true}, nil +} + +// parseMaybeJSON determines if the argument appears to be a JSON array. If +// so, passes to parseJSON; if not, quotes the result and returns a single +// node. +func parseMaybeJSON(rest string) (*Node, map[string]bool, error) { + if rest == "" { + return nil, nil, nil + } + + node, attrs, err := parseJSON(rest) + + if err == nil { + return node, attrs, nil + } + if err == errDockerfileNotStringArray { + return nil, nil, err + } + + node = &Node{} + node.Value = rest + return node, nil, nil +} + +// parseMaybeJSONToList determines if the argument appears to be a JSON array. If +// so, passes to parseJSON; if not, attempts to parse it as a whitespace +// delimited string. +func parseMaybeJSONToList(rest string) (*Node, map[string]bool, error) { + node, attrs, err := parseJSON(rest) + + if err == nil { + return node, attrs, nil + } + if err == errDockerfileNotStringArray { + return nil, nil, err + } + + return parseStringsWhitespaceDelimited(rest) +} diff --git a/builder/dockerfile/parser/parser.go b/builder/dockerfile/parser/parser.go new file mode 100644 index 0000000000..2c1cacc939 --- /dev/null +++ b/builder/dockerfile/parser/parser.go @@ -0,0 +1,145 @@ +// Package parser implements a parser and parse tree dumper for Dockerfiles. +package parser + +import ( + "bufio" + "io" + "regexp" + "strings" + "unicode" + + "github.com/docker/docker/builder/dockerfile/command" +) + +// Node is a structure used to represent a parse tree. +// +// In the node there are three fields, Value, Next, and Children. Value is the +// current token's string value. Next is always the next non-child token, and +// children contains all the children. Here's an example: +// +// (value next (child child-next child-next-next) next-next) +// +// This data structure is frankly pretty lousy for handling complex languages, +// but lucky for us the Dockerfile isn't very complicated. This structure +// works a little more effectively than a "proper" parse tree for our needs. +// +type Node struct { + Value string // actual content + Next *Node // the next item in the current sexp + Children []*Node // the children of this sexp + Attributes map[string]bool // special attributes for this node + Original string // original line used before parsing + Flags []string // only top Node should have this set +} + +var ( + dispatch map[string]func(string) (*Node, map[string]bool, error) + tokenWhitespace = regexp.MustCompile(`[\t\v\f\r ]+`) + tokenLineContinuation = regexp.MustCompile(`\\[ \t]*$`) + tokenComment = regexp.MustCompile(`^#.*$`) +) + +func init() { + // Dispatch Table. see line_parsers.go for the parse functions. + // The command is parsed and mapped to the line parser. The line parser + // receives the arguments but not the command, and returns an AST after + // reformulating the arguments according to the rules in the parser + // functions. Errors are propagated up by Parse() and the resulting AST can + // be incorporated directly into the existing AST as a next. + dispatch = map[string]func(string) (*Node, map[string]bool, error){ + command.User: parseString, + command.Onbuild: parseSubCommand, + command.Workdir: parseString, + command.Env: parseEnv, + command.Label: parseLabel, + command.Maintainer: parseString, + command.From: parseString, + command.Add: parseMaybeJSONToList, + command.Copy: parseMaybeJSONToList, + command.Run: parseMaybeJSON, + command.Cmd: parseMaybeJSON, + command.Entrypoint: parseMaybeJSON, + command.Expose: parseStringsWhitespaceDelimited, + command.Volume: parseMaybeJSONToList, + command.StopSignal: parseString, + command.Arg: parseNameOrNameVal, + } +} + +// parse a line and return the remainder. +func parseLine(line string) (string, *Node, error) { + if line = stripComments(line); line == "" { + return "", nil, nil + } + + if tokenLineContinuation.MatchString(line) { + line = tokenLineContinuation.ReplaceAllString(line, "") + return line, nil, nil + } + + cmd, flags, args, err := splitCommand(line) + if err != nil { + return "", nil, err + } + + node := &Node{} + node.Value = cmd + + sexp, attrs, err := fullDispatch(cmd, args) + if err != nil { + return "", nil, err + } + + node.Next = sexp + node.Attributes = attrs + node.Original = line + node.Flags = flags + + return "", node, nil +} + +// Parse is the main parse routine. +// It handles an io.ReadWriteCloser and returns the root of the AST. +func Parse(rwc io.Reader) (*Node, error) { + root := &Node{} + scanner := bufio.NewScanner(rwc) + + for scanner.Scan() { + scannedLine := strings.TrimLeftFunc(scanner.Text(), unicode.IsSpace) + line, child, err := parseLine(scannedLine) + if err != nil { + return nil, err + } + + if line != "" && child == nil { + for scanner.Scan() { + newline := scanner.Text() + + if stripComments(strings.TrimSpace(newline)) == "" { + continue + } + + line, child, err = parseLine(line + newline) + if err != nil { + return nil, err + } + + if child != nil { + break + } + } + if child == nil && line != "" { + line, child, err = parseLine(line) + if err != nil { + return nil, err + } + } + } + + if child != nil { + root.Children = append(root.Children, child) + } + } + + return root, nil +} diff --git a/builder/dockerfile/parser/parser_test.go b/builder/dockerfile/parser/parser_test.go new file mode 100644 index 0000000000..9734676469 --- /dev/null +++ b/builder/dockerfile/parser/parser_test.go @@ -0,0 +1,112 @@ +package parser + +import ( + "fmt" + "io/ioutil" + "os" + "path/filepath" + "testing" +) + +const testDir = "testfiles" +const negativeTestDir = "testfiles-negative" + +func getDirs(t *testing.T, dir string) []string { + f, err := os.Open(dir) + if err != nil { + t.Fatal(err) + } + + defer f.Close() + + dirs, err := f.Readdirnames(0) + if err != nil { + t.Fatal(err) + } + + return dirs +} + +func TestTestNegative(t *testing.T) { + for _, dir := range getDirs(t, negativeTestDir) { + dockerfile := filepath.Join(negativeTestDir, dir, "Dockerfile") + + df, err := os.Open(dockerfile) + if err != nil { + t.Fatalf("Dockerfile missing for %s: %v", dir, err) + } + + _, err = Parse(df) + if err == nil { + t.Fatalf("No error parsing broken dockerfile for %s", dir) + } + + df.Close() + } +} + +func TestTestData(t *testing.T) { + for _, dir := range getDirs(t, testDir) { + dockerfile := filepath.Join(testDir, dir, "Dockerfile") + resultfile := filepath.Join(testDir, dir, "result") + + df, err := os.Open(dockerfile) + if err != nil { + t.Fatalf("Dockerfile missing for %s: %v", dir, err) + } + defer df.Close() + + ast, err := Parse(df) + if err != nil { + t.Fatalf("Error parsing %s's dockerfile: %v", dir, err) + } + + content, err := ioutil.ReadFile(resultfile) + if err != nil { + t.Fatalf("Error reading %s's result file: %v", dir, err) + } + + if ast.Dump()+"\n" != string(content) { + fmt.Fprintln(os.Stderr, "Result:\n"+ast.Dump()) + fmt.Fprintln(os.Stderr, "Expected:\n"+string(content)) + t.Fatalf("%s: AST dump of dockerfile does not match result", dir) + } + } +} + +func TestParseWords(t *testing.T) { + tests := []map[string][]string{ + { + "input": {"foo"}, + "expect": {"foo"}, + }, + { + "input": {"foo bar"}, + "expect": {"foo", "bar"}, + }, + { + "input": {"foo=bar"}, + "expect": {"foo=bar"}, + }, + { + "input": {"foo bar 'abc xyz'"}, + "expect": {"foo", "bar", "'abc xyz'"}, + }, + { + "input": {`foo bar "abc xyz"`}, + "expect": {"foo", "bar", `"abc xyz"`}, + }, + } + + for _, test := range tests { + words := parseWords(test["input"][0]) + if len(words) != len(test["expect"]) { + t.Fatalf("length check failed. input: %v, expect: %v, output: %v", test["input"][0], test["expect"], words) + } + for i, word := range words { + if word != test["expect"][i] { + t.Fatalf("word check failed for word: %q. input: %v, expect: %v, output: %v", word, test["input"][0], test["expect"], words) + } + } + } +} diff --git a/builder/dockerfile/parser/testfiles-negative/env_no_value/Dockerfile b/builder/dockerfile/parser/testfiles-negative/env_no_value/Dockerfile new file mode 100644 index 0000000000..1d65578794 --- /dev/null +++ b/builder/dockerfile/parser/testfiles-negative/env_no_value/Dockerfile @@ -0,0 +1,3 @@ +FROM busybox + +ENV PATH diff --git a/builder/dockerfile/parser/testfiles-negative/shykes-nested-json/Dockerfile b/builder/dockerfile/parser/testfiles-negative/shykes-nested-json/Dockerfile new file mode 100644 index 0000000000..d1be4596c7 --- /dev/null +++ b/builder/dockerfile/parser/testfiles-negative/shykes-nested-json/Dockerfile @@ -0,0 +1 @@ +CMD [ "echo", [ "nested json" ] ] diff --git a/builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/Dockerfile b/builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/Dockerfile new file mode 100644 index 0000000000..00b444cba5 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/Dockerfile @@ -0,0 +1,11 @@ +FROM ubuntu:14.04 +MAINTAINER Seongyeol Lim + +COPY . /go/src/github.com/docker/docker +ADD . / +ADD null / +COPY nullfile /tmp +ADD [ "vimrc", "/tmp" ] +COPY [ "bashrc", "/tmp" ] +COPY [ "test file", "/tmp" ] +ADD [ "test file", "/tmp/test file" ] diff --git a/builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/result b/builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/result new file mode 100644 index 0000000000..85aee64018 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/ADD-COPY-with-JSON/result @@ -0,0 +1,10 @@ +(from "ubuntu:14.04") +(maintainer "Seongyeol Lim ") +(copy "." "/go/src/github.com/docker/docker") +(add "." "/") +(add "null" "/") +(copy "nullfile" "/tmp") +(add "vimrc" "/tmp") +(copy "bashrc" "/tmp") +(copy "test file" "/tmp") +(add "test file" "/tmp/test file") diff --git a/builder/dockerfile/parser/testfiles/brimstone-consuldock/Dockerfile b/builder/dockerfile/parser/testfiles/brimstone-consuldock/Dockerfile new file mode 100644 index 0000000000..5c75a2e0ca --- /dev/null +++ b/builder/dockerfile/parser/testfiles/brimstone-consuldock/Dockerfile @@ -0,0 +1,25 @@ +FROM brimstone/ubuntu:14.04 + +MAINTAINER brimstone@the.narro.ws + +# TORUN -v /var/run/docker.sock:/var/run/docker.sock + +ENV GOPATH /go + +# Set our command +ENTRYPOINT ["/usr/local/bin/consuldock"] + +# Install the packages we need, clean up after them and us +RUN apt-get update \ + && dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.clean \ + && apt-get install -y --no-install-recommends git golang ca-certificates \ + && apt-get clean \ + && rm -rf /var/lib/apt/lists \ + + && go get -v github.com/brimstone/consuldock \ + && mv $GOPATH/bin/consuldock /usr/local/bin/consuldock \ + + && dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.dirty \ + && apt-get remove --purge -y $(diff /tmp/dpkg.clean /tmp/dpkg.dirty | awk '/^>/ {print $2}') \ + && rm /tmp/dpkg.* \ + && rm -rf $GOPATH diff --git a/builder/dockerfile/parser/testfiles/brimstone-consuldock/result b/builder/dockerfile/parser/testfiles/brimstone-consuldock/result new file mode 100644 index 0000000000..227f748cda --- /dev/null +++ b/builder/dockerfile/parser/testfiles/brimstone-consuldock/result @@ -0,0 +1,5 @@ +(from "brimstone/ubuntu:14.04") +(maintainer "brimstone@the.narro.ws") +(env "GOPATH" "/go") +(entrypoint "/usr/local/bin/consuldock") +(run "apt-get update \t&& dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.clean && apt-get install -y --no-install-recommends git golang ca-certificates && apt-get clean && rm -rf /var/lib/apt/lists \t&& go get -v github.com/brimstone/consuldock && mv $GOPATH/bin/consuldock /usr/local/bin/consuldock \t&& dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.dirty \t&& apt-get remove --purge -y $(diff /tmp/dpkg.clean /tmp/dpkg.dirty | awk '/^>/ {print $2}') \t&& rm /tmp/dpkg.* \t&& rm -rf $GOPATH") diff --git a/builder/dockerfile/parser/testfiles/brimstone-docker-consul/Dockerfile b/builder/dockerfile/parser/testfiles/brimstone-docker-consul/Dockerfile new file mode 100644 index 0000000000..25ae352166 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/brimstone-docker-consul/Dockerfile @@ -0,0 +1,52 @@ +FROM brimstone/ubuntu:14.04 + +CMD [] + +ENTRYPOINT ["/usr/bin/consul", "agent", "-server", "-data-dir=/consul", "-client=0.0.0.0", "-ui-dir=/webui"] + +EXPOSE 8500 8600 8400 8301 8302 + +RUN apt-get update \ + && apt-get install -y unzip wget \ + && apt-get clean \ + && rm -rf /var/lib/apt/lists + +RUN cd /tmp \ + && wget https://dl.bintray.com/mitchellh/consul/0.3.1_web_ui.zip \ + -O web_ui.zip \ + && unzip web_ui.zip \ + && mv dist /webui \ + && rm web_ui.zip + +RUN apt-get update \ + && dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.clean \ + && apt-get install -y --no-install-recommends unzip wget \ + && apt-get clean \ + && rm -rf /var/lib/apt/lists \ + + && cd /tmp \ + && wget https://dl.bintray.com/mitchellh/consul/0.3.1_web_ui.zip \ + -O web_ui.zip \ + && unzip web_ui.zip \ + && mv dist /webui \ + && rm web_ui.zip \ + + && dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.dirty \ + && apt-get remove --purge -y $(diff /tmp/dpkg.clean /tmp/dpkg.dirty | awk '/^>/ {print $2}') \ + && rm /tmp/dpkg.* + +ENV GOPATH /go + +RUN apt-get update \ + && dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.clean \ + && apt-get install -y --no-install-recommends git golang ca-certificates build-essential \ + && apt-get clean \ + && rm -rf /var/lib/apt/lists \ + + && go get -v github.com/hashicorp/consul \ + && mv $GOPATH/bin/consul /usr/bin/consul \ + + && dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.dirty \ + && apt-get remove --purge -y $(diff /tmp/dpkg.clean /tmp/dpkg.dirty | awk '/^>/ {print $2}') \ + && rm /tmp/dpkg.* \ + && rm -rf $GOPATH diff --git a/builder/dockerfile/parser/testfiles/brimstone-docker-consul/result b/builder/dockerfile/parser/testfiles/brimstone-docker-consul/result new file mode 100644 index 0000000000..16492e516a --- /dev/null +++ b/builder/dockerfile/parser/testfiles/brimstone-docker-consul/result @@ -0,0 +1,9 @@ +(from "brimstone/ubuntu:14.04") +(cmd) +(entrypoint "/usr/bin/consul" "agent" "-server" "-data-dir=/consul" "-client=0.0.0.0" "-ui-dir=/webui") +(expose "8500" "8600" "8400" "8301" "8302") +(run "apt-get update && apt-get install -y unzip wget \t&& apt-get clean \t&& rm -rf /var/lib/apt/lists") +(run "cd /tmp && wget https://dl.bintray.com/mitchellh/consul/0.3.1_web_ui.zip -O web_ui.zip && unzip web_ui.zip && mv dist /webui && rm web_ui.zip") +(run "apt-get update \t&& dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.clean && apt-get install -y --no-install-recommends unzip wget && apt-get clean && rm -rf /var/lib/apt/lists && cd /tmp && wget https://dl.bintray.com/mitchellh/consul/0.3.1_web_ui.zip -O web_ui.zip && unzip web_ui.zip && mv dist /webui && rm web_ui.zip \t&& dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.dirty \t&& apt-get remove --purge -y $(diff /tmp/dpkg.clean /tmp/dpkg.dirty | awk '/^>/ {print $2}') \t&& rm /tmp/dpkg.*") +(env "GOPATH" "/go") +(run "apt-get update \t&& dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.clean && apt-get install -y --no-install-recommends git golang ca-certificates build-essential && apt-get clean && rm -rf /var/lib/apt/lists \t&& go get -v github.com/hashicorp/consul \t&& mv $GOPATH/bin/consul /usr/bin/consul \t&& dpkg -l | awk '/^ii/ {print $2}' > /tmp/dpkg.dirty \t&& apt-get remove --purge -y $(diff /tmp/dpkg.clean /tmp/dpkg.dirty | awk '/^>/ {print $2}') \t&& rm /tmp/dpkg.* \t&& rm -rf $GOPATH") diff --git a/builder/dockerfile/parser/testfiles/continueIndent/Dockerfile b/builder/dockerfile/parser/testfiles/continueIndent/Dockerfile new file mode 100644 index 0000000000..42b324e77b --- /dev/null +++ b/builder/dockerfile/parser/testfiles/continueIndent/Dockerfile @@ -0,0 +1,36 @@ +FROM ubuntu:14.04 + +RUN echo hello\ + world\ + goodnight \ + moon\ + light\ +ning +RUN echo hello \ + world +RUN echo hello \ +world +RUN echo hello \ +goodbye\ +frog +RUN echo hello \ +world +RUN echo hi \ + \ + world \ +\ + good\ +\ +night +RUN echo goodbye\ +frog +RUN echo good\ +bye\ +frog + +RUN echo hello \ +# this is a comment + +# this is a comment with a blank line surrounding it + +this is some more useful stuff diff --git a/builder/dockerfile/parser/testfiles/continueIndent/result b/builder/dockerfile/parser/testfiles/continueIndent/result new file mode 100644 index 0000000000..268ae073c8 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/continueIndent/result @@ -0,0 +1,10 @@ +(from "ubuntu:14.04") +(run "echo hello world goodnight moon lightning") +(run "echo hello world") +(run "echo hello world") +(run "echo hello goodbyefrog") +(run "echo hello world") +(run "echo hi world goodnight") +(run "echo goodbyefrog") +(run "echo goodbyefrog") +(run "echo hello this is some more useful stuff") diff --git a/builder/dockerfile/parser/testfiles/cpuguy83-nagios/Dockerfile b/builder/dockerfile/parser/testfiles/cpuguy83-nagios/Dockerfile new file mode 100644 index 0000000000..8ccb71a578 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/cpuguy83-nagios/Dockerfile @@ -0,0 +1,54 @@ +FROM cpuguy83/ubuntu +ENV NAGIOS_HOME /opt/nagios +ENV NAGIOS_USER nagios +ENV NAGIOS_GROUP nagios +ENV NAGIOS_CMDUSER nagios +ENV NAGIOS_CMDGROUP nagios +ENV NAGIOSADMIN_USER nagiosadmin +ENV NAGIOSADMIN_PASS nagios +ENV APACHE_RUN_USER nagios +ENV APACHE_RUN_GROUP nagios +ENV NAGIOS_TIMEZONE UTC + +RUN sed -i 's/universe/universe multiverse/' /etc/apt/sources.list +RUN apt-get update && apt-get install -y iputils-ping netcat build-essential snmp snmpd snmp-mibs-downloader php5-cli apache2 libapache2-mod-php5 runit bc postfix bsd-mailx +RUN ( egrep -i "^${NAGIOS_GROUP}" /etc/group || groupadd $NAGIOS_GROUP ) && ( egrep -i "^${NAGIOS_CMDGROUP}" /etc/group || groupadd $NAGIOS_CMDGROUP ) +RUN ( id -u $NAGIOS_USER || useradd --system $NAGIOS_USER -g $NAGIOS_GROUP -d $NAGIOS_HOME ) && ( id -u $NAGIOS_CMDUSER || useradd --system -d $NAGIOS_HOME -g $NAGIOS_CMDGROUP $NAGIOS_CMDUSER ) + +ADD http://downloads.sourceforge.net/project/nagios/nagios-3.x/nagios-3.5.1/nagios-3.5.1.tar.gz?r=http%3A%2F%2Fwww.nagios.org%2Fdownload%2Fcore%2Fthanks%2F%3Ft%3D1398863696&ts=1398863718&use_mirror=superb-dca3 /tmp/nagios.tar.gz +RUN cd /tmp && tar -zxvf nagios.tar.gz && cd nagios && ./configure --prefix=${NAGIOS_HOME} --exec-prefix=${NAGIOS_HOME} --enable-event-broker --with-nagios-command-user=${NAGIOS_CMDUSER} --with-command-group=${NAGIOS_CMDGROUP} --with-nagios-user=${NAGIOS_USER} --with-nagios-group=${NAGIOS_GROUP} && make all && make install && make install-config && make install-commandmode && cp sample-config/httpd.conf /etc/apache2/conf.d/nagios.conf +ADD http://www.nagios-plugins.org/download/nagios-plugins-1.5.tar.gz /tmp/ +RUN cd /tmp && tar -zxvf nagios-plugins-1.5.tar.gz && cd nagios-plugins-1.5 && ./configure --prefix=${NAGIOS_HOME} && make && make install + +RUN sed -i.bak 's/.*\=www\-data//g' /etc/apache2/envvars +RUN export DOC_ROOT="DocumentRoot $(echo $NAGIOS_HOME/share)"; sed -i "s,DocumentRoot.*,$DOC_ROOT," /etc/apache2/sites-enabled/000-default + +RUN ln -s ${NAGIOS_HOME}/bin/nagios /usr/local/bin/nagios && mkdir -p /usr/share/snmp/mibs && chmod 0755 /usr/share/snmp/mibs && touch /usr/share/snmp/mibs/.foo + +RUN echo "use_timezone=$NAGIOS_TIMEZONE" >> ${NAGIOS_HOME}/etc/nagios.cfg && echo "SetEnv TZ \"${NAGIOS_TIMEZONE}\"" >> /etc/apache2/conf.d/nagios.conf + +RUN mkdir -p ${NAGIOS_HOME}/etc/conf.d && mkdir -p ${NAGIOS_HOME}/etc/monitor && ln -s /usr/share/snmp/mibs ${NAGIOS_HOME}/libexec/mibs +RUN echo "cfg_dir=${NAGIOS_HOME}/etc/conf.d" >> ${NAGIOS_HOME}/etc/nagios.cfg +RUN echo "cfg_dir=${NAGIOS_HOME}/etc/monitor" >> ${NAGIOS_HOME}/etc/nagios.cfg +RUN download-mibs && echo "mibs +ALL" > /etc/snmp/snmp.conf + +RUN sed -i 's,/bin/mail,/usr/bin/mail,' /opt/nagios/etc/objects/commands.cfg && \ + sed -i 's,/usr/usr,/usr,' /opt/nagios/etc/objects/commands.cfg +RUN cp /etc/services /var/spool/postfix/etc/ + +RUN mkdir -p /etc/sv/nagios && mkdir -p /etc/sv/apache && rm -rf /etc/sv/getty-5 && mkdir -p /etc/sv/postfix +ADD nagios.init /etc/sv/nagios/run +ADD apache.init /etc/sv/apache/run +ADD postfix.init /etc/sv/postfix/run +ADD postfix.stop /etc/sv/postfix/finish + +ADD start.sh /usr/local/bin/start_nagios + +ENV APACHE_LOCK_DIR /var/run +ENV APACHE_LOG_DIR /var/log/apache2 + +EXPOSE 80 + +VOLUME ["/opt/nagios/var", "/opt/nagios/etc", "/opt/nagios/libexec", "/var/log/apache2", "/usr/share/snmp/mibs"] + +CMD ["/usr/local/bin/start_nagios"] diff --git a/builder/dockerfile/parser/testfiles/cpuguy83-nagios/result b/builder/dockerfile/parser/testfiles/cpuguy83-nagios/result new file mode 100644 index 0000000000..25dd3ddfe5 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/cpuguy83-nagios/result @@ -0,0 +1,40 @@ +(from "cpuguy83/ubuntu") +(env "NAGIOS_HOME" "/opt/nagios") +(env "NAGIOS_USER" "nagios") +(env "NAGIOS_GROUP" "nagios") +(env "NAGIOS_CMDUSER" "nagios") +(env "NAGIOS_CMDGROUP" "nagios") +(env "NAGIOSADMIN_USER" "nagiosadmin") +(env "NAGIOSADMIN_PASS" "nagios") +(env "APACHE_RUN_USER" "nagios") +(env "APACHE_RUN_GROUP" "nagios") +(env "NAGIOS_TIMEZONE" "UTC") +(run "sed -i 's/universe/universe multiverse/' /etc/apt/sources.list") +(run "apt-get update && apt-get install -y iputils-ping netcat build-essential snmp snmpd snmp-mibs-downloader php5-cli apache2 libapache2-mod-php5 runit bc postfix bsd-mailx") +(run "( egrep -i \"^${NAGIOS_GROUP}\" /etc/group || groupadd $NAGIOS_GROUP ) && ( egrep -i \"^${NAGIOS_CMDGROUP}\" /etc/group || groupadd $NAGIOS_CMDGROUP )") +(run "( id -u $NAGIOS_USER || useradd --system $NAGIOS_USER -g $NAGIOS_GROUP -d $NAGIOS_HOME ) && ( id -u $NAGIOS_CMDUSER || useradd --system -d $NAGIOS_HOME -g $NAGIOS_CMDGROUP $NAGIOS_CMDUSER )") +(add "http://downloads.sourceforge.net/project/nagios/nagios-3.x/nagios-3.5.1/nagios-3.5.1.tar.gz?r=http%3A%2F%2Fwww.nagios.org%2Fdownload%2Fcore%2Fthanks%2F%3Ft%3D1398863696&ts=1398863718&use_mirror=superb-dca3" "/tmp/nagios.tar.gz") +(run "cd /tmp && tar -zxvf nagios.tar.gz && cd nagios && ./configure --prefix=${NAGIOS_HOME} --exec-prefix=${NAGIOS_HOME} --enable-event-broker --with-nagios-command-user=${NAGIOS_CMDUSER} --with-command-group=${NAGIOS_CMDGROUP} --with-nagios-user=${NAGIOS_USER} --with-nagios-group=${NAGIOS_GROUP} && make all && make install && make install-config && make install-commandmode && cp sample-config/httpd.conf /etc/apache2/conf.d/nagios.conf") +(add "http://www.nagios-plugins.org/download/nagios-plugins-1.5.tar.gz" "/tmp/") +(run "cd /tmp && tar -zxvf nagios-plugins-1.5.tar.gz && cd nagios-plugins-1.5 && ./configure --prefix=${NAGIOS_HOME} && make && make install") +(run "sed -i.bak 's/.*\\=www\\-data//g' /etc/apache2/envvars") +(run "export DOC_ROOT=\"DocumentRoot $(echo $NAGIOS_HOME/share)\"; sed -i \"s,DocumentRoot.*,$DOC_ROOT,\" /etc/apache2/sites-enabled/000-default") +(run "ln -s ${NAGIOS_HOME}/bin/nagios /usr/local/bin/nagios && mkdir -p /usr/share/snmp/mibs && chmod 0755 /usr/share/snmp/mibs && touch /usr/share/snmp/mibs/.foo") +(run "echo \"use_timezone=$NAGIOS_TIMEZONE\" >> ${NAGIOS_HOME}/etc/nagios.cfg && echo \"SetEnv TZ \\\"${NAGIOS_TIMEZONE}\\\"\" >> /etc/apache2/conf.d/nagios.conf") +(run "mkdir -p ${NAGIOS_HOME}/etc/conf.d && mkdir -p ${NAGIOS_HOME}/etc/monitor && ln -s /usr/share/snmp/mibs ${NAGIOS_HOME}/libexec/mibs") +(run "echo \"cfg_dir=${NAGIOS_HOME}/etc/conf.d\" >> ${NAGIOS_HOME}/etc/nagios.cfg") +(run "echo \"cfg_dir=${NAGIOS_HOME}/etc/monitor\" >> ${NAGIOS_HOME}/etc/nagios.cfg") +(run "download-mibs && echo \"mibs +ALL\" > /etc/snmp/snmp.conf") +(run "sed -i 's,/bin/mail,/usr/bin/mail,' /opt/nagios/etc/objects/commands.cfg && sed -i 's,/usr/usr,/usr,' /opt/nagios/etc/objects/commands.cfg") +(run "cp /etc/services /var/spool/postfix/etc/") +(run "mkdir -p /etc/sv/nagios && mkdir -p /etc/sv/apache && rm -rf /etc/sv/getty-5 && mkdir -p /etc/sv/postfix") +(add "nagios.init" "/etc/sv/nagios/run") +(add "apache.init" "/etc/sv/apache/run") +(add "postfix.init" "/etc/sv/postfix/run") +(add "postfix.stop" "/etc/sv/postfix/finish") +(add "start.sh" "/usr/local/bin/start_nagios") +(env "APACHE_LOCK_DIR" "/var/run") +(env "APACHE_LOG_DIR" "/var/log/apache2") +(expose "80") +(volume "/opt/nagios/var" "/opt/nagios/etc" "/opt/nagios/libexec" "/var/log/apache2" "/usr/share/snmp/mibs") +(cmd "/usr/local/bin/start_nagios") diff --git a/builder/dockerfile/parser/testfiles/docker/Dockerfile b/builder/dockerfile/parser/testfiles/docker/Dockerfile new file mode 100644 index 0000000000..4a35625415 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/docker/Dockerfile @@ -0,0 +1,104 @@ +# This file describes the standard way to build Docker, using docker +# +# Usage: +# +# # Assemble the full dev environment. This is slow the first time. +# docker build -t docker . +# +# # Mount your source in an interactive container for quick testing: +# docker run -v `pwd`:/go/src/github.com/docker/docker --privileged -i -t docker bash +# +# # Run the test suite: +# docker run --privileged docker hack/make.sh test +# +# # Publish a release: +# docker run --privileged \ +# -e AWS_S3_BUCKET=baz \ +# -e AWS_ACCESS_KEY=foo \ +# -e AWS_SECRET_KEY=bar \ +# -e GPG_PASSPHRASE=gloubiboulga \ +# docker hack/release.sh +# +# Note: AppArmor used to mess with privileged mode, but this is no longer +# the case. Therefore, you don't have to disable it anymore. +# + +FROM ubuntu:14.04 +MAINTAINER Tianon Gravi (@tianon) + +# Packaged dependencies +RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -yq \ + apt-utils \ + aufs-tools \ + automake \ + btrfs-tools \ + build-essential \ + curl \ + dpkg-sig \ + git \ + iptables \ + libapparmor-dev \ + libcap-dev \ + libsqlite3-dev \ + lxc=1.0* \ + mercurial \ + pandoc \ + parallel \ + reprepro \ + ruby1.9.1 \ + ruby1.9.1-dev \ + s3cmd=1.1.0* \ + --no-install-recommends + +# Get lvm2 source for compiling statically +RUN git clone --no-checkout https://git.fedorahosted.org/git/lvm2.git /usr/local/lvm2 && cd /usr/local/lvm2 && git checkout -q v2_02_103 +# see https://git.fedorahosted.org/cgit/lvm2.git/refs/tags for release tags +# note: we don't use "git clone -b" above because it then spews big nasty warnings about 'detached HEAD' state that we can't silence as easily as we can silence them using "git checkout" directly + +# Compile and install lvm2 +RUN cd /usr/local/lvm2 && ./configure --enable-static_link && make device-mapper && make install_device-mapper +# see https://git.fedorahosted.org/cgit/lvm2.git/tree/INSTALL + +# Install Go +RUN curl -sSL https://golang.org/dl/go1.3.src.tar.gz | tar -v -C /usr/local -xz +ENV PATH /usr/local/go/bin:$PATH +ENV GOPATH /go:/go/src/github.com/docker/docker/vendor +RUN cd /usr/local/go/src && ./make.bash --no-clean 2>&1 + +# Compile Go for cross compilation +ENV DOCKER_CROSSPLATFORMS \ + linux/386 linux/arm \ + darwin/amd64 darwin/386 \ + freebsd/amd64 freebsd/386 freebsd/arm +# (set an explicit GOARM of 5 for maximum compatibility) +ENV GOARM 5 +RUN cd /usr/local/go/src && bash -xc 'for platform in $DOCKER_CROSSPLATFORMS; do GOOS=${platform%/*} GOARCH=${platform##*/} ./make.bash --no-clean 2>&1; done' + +# Grab Go's cover tool for dead-simple code coverage testing +RUN go get golang.org/x/tools/cmd/cover + +# TODO replace FPM with some very minimal debhelper stuff +RUN gem install --no-rdoc --no-ri fpm --version 1.0.2 + +# Get the "busybox" image source so we can build locally instead of pulling +RUN git clone -b buildroot-2014.02 https://github.com/jpetazzo/docker-busybox.git /docker-busybox + +# Setup s3cmd config +RUN /bin/echo -e '[default]\naccess_key=$AWS_ACCESS_KEY\nsecret_key=$AWS_SECRET_KEY' > /.s3cfg + +# Set user.email so crosbymichael's in-container merge commits go smoothly +RUN git config --global user.email 'docker-dummy@example.com' + +# Add an unprivileged user to be used for tests which need it +RUN groupadd -r docker +RUN useradd --create-home --gid docker unprivilegeduser + +VOLUME /var/lib/docker +WORKDIR /go/src/github.com/docker/docker +ENV DOCKER_BUILDTAGS apparmor selinux + +# Wrap all commands in the "docker-in-docker" script to allow nested containers +ENTRYPOINT ["hack/dind"] + +# Upload docker source +COPY . /go/src/github.com/docker/docker diff --git a/builder/dockerfile/parser/testfiles/docker/result b/builder/dockerfile/parser/testfiles/docker/result new file mode 100644 index 0000000000..773b640a9d --- /dev/null +++ b/builder/dockerfile/parser/testfiles/docker/result @@ -0,0 +1,24 @@ +(from "ubuntu:14.04") +(maintainer "Tianon Gravi (@tianon)") +(run "apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -yq \tapt-utils \taufs-tools \tautomake \tbtrfs-tools \tbuild-essential \tcurl \tdpkg-sig \tgit \tiptables \tlibapparmor-dev \tlibcap-dev \tlibsqlite3-dev \tlxc=1.0* \tmercurial \tpandoc \tparallel \treprepro \truby1.9.1 \truby1.9.1-dev \ts3cmd=1.1.0* \t--no-install-recommends") +(run "git clone --no-checkout https://git.fedorahosted.org/git/lvm2.git /usr/local/lvm2 && cd /usr/local/lvm2 && git checkout -q v2_02_103") +(run "cd /usr/local/lvm2 && ./configure --enable-static_link && make device-mapper && make install_device-mapper") +(run "curl -sSL https://golang.org/dl/go1.3.src.tar.gz | tar -v -C /usr/local -xz") +(env "PATH" "/usr/local/go/bin:$PATH") +(env "GOPATH" "/go:/go/src/github.com/docker/docker/vendor") +(run "cd /usr/local/go/src && ./make.bash --no-clean 2>&1") +(env "DOCKER_CROSSPLATFORMS" "linux/386 linux/arm \tdarwin/amd64 darwin/386 \tfreebsd/amd64 freebsd/386 freebsd/arm") +(env "GOARM" "5") +(run "cd /usr/local/go/src && bash -xc 'for platform in $DOCKER_CROSSPLATFORMS; do GOOS=${platform%/*} GOARCH=${platform##*/} ./make.bash --no-clean 2>&1; done'") +(run "go get golang.org/x/tools/cmd/cover") +(run "gem install --no-rdoc --no-ri fpm --version 1.0.2") +(run "git clone -b buildroot-2014.02 https://github.com/jpetazzo/docker-busybox.git /docker-busybox") +(run "/bin/echo -e '[default]\\naccess_key=$AWS_ACCESS_KEY\\nsecret_key=$AWS_SECRET_KEY' > /.s3cfg") +(run "git config --global user.email 'docker-dummy@example.com'") +(run "groupadd -r docker") +(run "useradd --create-home --gid docker unprivilegeduser") +(volume "/var/lib/docker") +(workdir "/go/src/github.com/docker/docker") +(env "DOCKER_BUILDTAGS" "apparmor selinux") +(entrypoint "hack/dind") +(copy "." "/go/src/github.com/docker/docker") diff --git a/builder/dockerfile/parser/testfiles/env/Dockerfile b/builder/dockerfile/parser/testfiles/env/Dockerfile new file mode 100644 index 0000000000..08fa18acec --- /dev/null +++ b/builder/dockerfile/parser/testfiles/env/Dockerfile @@ -0,0 +1,23 @@ +FROM ubuntu +ENV name value +ENV name=value +ENV name=value name2=value2 +ENV name="value value1" +ENV name=value\ value2 +ENV name="value'quote space'value2" +ENV name='value"double quote"value2' +ENV name=value\ value2 name2=value2\ value3 +ENV name="a\"b" +ENV name="a\'b" +ENV name='a\'b' +ENV name='a\'b'' +ENV name='a\"b' +ENV name="''" +# don't put anything after the next line - it must be the last line of the +# Dockerfile and it must end with \ +ENV name=value \ + name1=value1 \ + name2="value2a \ + value2b" \ + name3="value3a\n\"value3b\"" \ + name4="value4a\\nvalue4b" \ diff --git a/builder/dockerfile/parser/testfiles/env/result b/builder/dockerfile/parser/testfiles/env/result new file mode 100644 index 0000000000..ba0a6dd7cb --- /dev/null +++ b/builder/dockerfile/parser/testfiles/env/result @@ -0,0 +1,16 @@ +(from "ubuntu") +(env "name" "value") +(env "name" "value") +(env "name" "value" "name2" "value2") +(env "name" "\"value value1\"") +(env "name" "value\\ value2") +(env "name" "\"value'quote space'value2\"") +(env "name" "'value\"double quote\"value2'") +(env "name" "value\\ value2" "name2" "value2\\ value3") +(env "name" "\"a\\\"b\"") +(env "name" "\"a\\'b\"") +(env "name" "'a\\'b'") +(env "name" "'a\\'b''") +(env "name" "'a\\\"b'") +(env "name" "\"''\"") +(env "name" "value" "name1" "value1" "name2" "\"value2a value2b\"" "name3" "\"value3a\\n\\\"value3b\\\"\"" "name4" "\"value4a\\\\nvalue4b\"") diff --git a/builder/dockerfile/parser/testfiles/escapes/Dockerfile b/builder/dockerfile/parser/testfiles/escapes/Dockerfile new file mode 100644 index 0000000000..1ffb17ef08 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/escapes/Dockerfile @@ -0,0 +1,14 @@ +FROM ubuntu:14.04 +MAINTAINER Erik \\Hollensbe \" + +RUN apt-get \update && \ + apt-get \"install znc -y +ADD \conf\\" /.znc + +RUN foo \ + +bar \ + +baz + +CMD [ "\/usr\\\"/bin/znc", "-f", "-r" ] diff --git a/builder/dockerfile/parser/testfiles/escapes/result b/builder/dockerfile/parser/testfiles/escapes/result new file mode 100644 index 0000000000..13e409cb1a --- /dev/null +++ b/builder/dockerfile/parser/testfiles/escapes/result @@ -0,0 +1,6 @@ +(from "ubuntu:14.04") +(maintainer "Erik \\\\Hollensbe \\\"") +(run "apt-get \\update && apt-get \\\"install znc -y") +(add "\\conf\\\\\"" "/.znc") +(run "foo bar baz") +(cmd "/usr\\\"/bin/znc" "-f" "-r") diff --git a/builder/dockerfile/parser/testfiles/flags/Dockerfile b/builder/dockerfile/parser/testfiles/flags/Dockerfile new file mode 100644 index 0000000000..2418e0f069 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/flags/Dockerfile @@ -0,0 +1,10 @@ +FROM scratch +COPY foo /tmp/ +COPY --user=me foo /tmp/ +COPY --doit=true foo /tmp/ +COPY --user=me --doit=true foo /tmp/ +COPY --doit=true -- foo /tmp/ +COPY -- foo /tmp/ +CMD --doit [ "a", "b" ] +CMD --doit=true -- [ "a", "b" ] +CMD --doit -- [ ] diff --git a/builder/dockerfile/parser/testfiles/flags/result b/builder/dockerfile/parser/testfiles/flags/result new file mode 100644 index 0000000000..4578f4cba4 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/flags/result @@ -0,0 +1,10 @@ +(from "scratch") +(copy "foo" "/tmp/") +(copy ["--user=me"] "foo" "/tmp/") +(copy ["--doit=true"] "foo" "/tmp/") +(copy ["--user=me" "--doit=true"] "foo" "/tmp/") +(copy ["--doit=true"] "foo" "/tmp/") +(copy "foo" "/tmp/") +(cmd ["--doit"] "a" "b") +(cmd ["--doit=true"] "a" "b") +(cmd ["--doit"]) diff --git a/builder/dockerfile/parser/testfiles/influxdb/Dockerfile b/builder/dockerfile/parser/testfiles/influxdb/Dockerfile new file mode 100644 index 0000000000..587fb9b54b --- /dev/null +++ b/builder/dockerfile/parser/testfiles/influxdb/Dockerfile @@ -0,0 +1,15 @@ +FROM ubuntu:14.04 + +RUN apt-get update && apt-get install wget -y +RUN wget http://s3.amazonaws.com/influxdb/influxdb_latest_amd64.deb +RUN dpkg -i influxdb_latest_amd64.deb +RUN rm -r /opt/influxdb/shared + +VOLUME /opt/influxdb/shared + +CMD /usr/bin/influxdb --pidfile /var/run/influxdb.pid -config /opt/influxdb/shared/config.toml + +EXPOSE 8083 +EXPOSE 8086 +EXPOSE 8090 +EXPOSE 8099 diff --git a/builder/dockerfile/parser/testfiles/influxdb/result b/builder/dockerfile/parser/testfiles/influxdb/result new file mode 100644 index 0000000000..0998e87e63 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/influxdb/result @@ -0,0 +1,11 @@ +(from "ubuntu:14.04") +(run "apt-get update && apt-get install wget -y") +(run "wget http://s3.amazonaws.com/influxdb/influxdb_latest_amd64.deb") +(run "dpkg -i influxdb_latest_amd64.deb") +(run "rm -r /opt/influxdb/shared") +(volume "/opt/influxdb/shared") +(cmd "/usr/bin/influxdb --pidfile /var/run/influxdb.pid -config /opt/influxdb/shared/config.toml") +(expose "8083") +(expose "8086") +(expose "8090") +(expose "8099") diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/Dockerfile b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/Dockerfile new file mode 100644 index 0000000000..39fe27d99c --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/Dockerfile @@ -0,0 +1 @@ +CMD "[\"echo\", \"Phew, I just managed to escaped those double quotes\"]" diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/result b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/result new file mode 100644 index 0000000000..afc220c2a7 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string-double/result @@ -0,0 +1 @@ +(cmd "\"[\\\"echo\\\", \\\"Phew, I just managed to escaped those double quotes\\\"]\"") diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/Dockerfile b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/Dockerfile new file mode 100644 index 0000000000..eaae081a06 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/Dockerfile @@ -0,0 +1 @@ +CMD '["echo", "Well, JSON in a string is JSON too?"]' diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/result b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/result new file mode 100644 index 0000000000..484804e2b2 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-json-inside-string/result @@ -0,0 +1 @@ +(cmd "'[\"echo\", \"Well, JSON in a string is JSON too?\"]'") diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/Dockerfile b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/Dockerfile new file mode 100644 index 0000000000..c3ac63c07a --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/Dockerfile @@ -0,0 +1 @@ +CMD ['echo','single quotes are invalid JSON'] diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/result b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/result new file mode 100644 index 0000000000..6147891207 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-single-quotes/result @@ -0,0 +1 @@ +(cmd "['echo','single quotes are invalid JSON']") diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/Dockerfile b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/Dockerfile new file mode 100644 index 0000000000..5fd4afa522 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/Dockerfile @@ -0,0 +1 @@ +CMD ["echo", "Please, close the brackets when you're done" diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/result b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/result new file mode 100644 index 0000000000..1ffbb8ff85 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-bracket/result @@ -0,0 +1 @@ +(cmd "[\"echo\", \"Please, close the brackets when you're done\"") diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/Dockerfile b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/Dockerfile new file mode 100644 index 0000000000..30cc4bb48f --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/Dockerfile @@ -0,0 +1 @@ +CMD ["echo", "look ma, no quote!] diff --git a/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/result b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/result new file mode 100644 index 0000000000..32048147b5 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/jeztah-invalid-json-unterminated-string/result @@ -0,0 +1 @@ +(cmd "[\"echo\", \"look ma, no quote!]") diff --git a/builder/dockerfile/parser/testfiles/json/Dockerfile b/builder/dockerfile/parser/testfiles/json/Dockerfile new file mode 100644 index 0000000000..a586917110 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/json/Dockerfile @@ -0,0 +1,8 @@ +CMD [] +CMD [""] +CMD ["a"] +CMD ["a","b"] +CMD [ "a", "b" ] +CMD [ "a", "b" ] +CMD [ "a", "b" ] +CMD ["abc 123", "♥", "☃", "\" \\ \/ \b \f \n \r \t \u0000"] diff --git a/builder/dockerfile/parser/testfiles/json/result b/builder/dockerfile/parser/testfiles/json/result new file mode 100644 index 0000000000..c6553e6e1a --- /dev/null +++ b/builder/dockerfile/parser/testfiles/json/result @@ -0,0 +1,8 @@ +(cmd) +(cmd "") +(cmd "a") +(cmd "a" "b") +(cmd "a" "b") +(cmd "a" "b") +(cmd "a" "b") +(cmd "abc 123" "♥" "☃" "\" \\ / \b \f \n \r \t \x00") diff --git a/builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/Dockerfile b/builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/Dockerfile new file mode 100644 index 0000000000..35f9c24aa6 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/Dockerfile @@ -0,0 +1,7 @@ +FROM ubuntu:14.04 +MAINTAINER James Turnbull "james@example.com" +ENV REFRESHED_AT 2014-06-01 +RUN apt-get update +RUN apt-get -y install redis-server redis-tools +EXPOSE 6379 +ENTRYPOINT [ "/usr/bin/redis-server" ] diff --git a/builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/result b/builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/result new file mode 100644 index 0000000000..b5ac6fe445 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/kartar-entrypoint-oddities/result @@ -0,0 +1,7 @@ +(from "ubuntu:14.04") +(maintainer "James Turnbull \"james@example.com\"") +(env "REFRESHED_AT" "2014-06-01") +(run "apt-get update") +(run "apt-get -y install redis-server redis-tools") +(expose "6379") +(entrypoint "/usr/bin/redis-server") diff --git a/builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/Dockerfile b/builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/Dockerfile new file mode 100644 index 0000000000..188395fe83 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/Dockerfile @@ -0,0 +1,48 @@ +FROM busybox:buildroot-2014.02 + +MAINTAINER docker + +ONBUILD RUN ["echo", "test"] +ONBUILD RUN echo test +ONBUILD COPY . / + + +# RUN Commands \ +# linebreak in comment \ +RUN ["ls", "-la"] +RUN ["echo", "'1234'"] +RUN echo "1234" +RUN echo 1234 +RUN echo '1234' && \ + echo "456" && \ + echo 789 +RUN sh -c 'echo root:testpass \ + > /tmp/passwd' +RUN mkdir -p /test /test2 /test3/test + +# ENV \ +ENV SCUBA 1 DUBA 3 +ENV SCUBA "1 DUBA 3" + +# CMD \ +CMD ["echo", "test"] +CMD echo test +CMD echo "test" +CMD echo 'test' +CMD echo 'test' | wc - + +#EXPOSE\ +EXPOSE 3000 +EXPOSE 9000 5000 6000 + +USER docker +USER docker:root + +VOLUME ["/test"] +VOLUME ["/test", "/test2"] +VOLUME /test3 + +WORKDIR /test + +ADD . / +COPY . copy diff --git a/builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/result b/builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/result new file mode 100644 index 0000000000..6f7d57a396 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/lk4d4-the-edge-case-generator/result @@ -0,0 +1,29 @@ +(from "busybox:buildroot-2014.02") +(maintainer "docker ") +(onbuild (run "echo" "test")) +(onbuild (run "echo test")) +(onbuild (copy "." "/")) +(run "ls" "-la") +(run "echo" "'1234'") +(run "echo \"1234\"") +(run "echo 1234") +(run "echo '1234' && echo \"456\" && echo 789") +(run "sh -c 'echo root:testpass > /tmp/passwd'") +(run "mkdir -p /test /test2 /test3/test") +(env "SCUBA" "1 DUBA 3") +(env "SCUBA" "\"1 DUBA 3\"") +(cmd "echo" "test") +(cmd "echo test") +(cmd "echo \"test\"") +(cmd "echo 'test'") +(cmd "echo 'test' | wc -") +(expose "3000") +(expose "9000" "5000" "6000") +(user "docker") +(user "docker:root") +(volume "/test") +(volume "/test" "/test2") +(volume "/test3") +(workdir "/test") +(add "." "/") +(copy "." "copy") diff --git a/builder/dockerfile/parser/testfiles/mail/Dockerfile b/builder/dockerfile/parser/testfiles/mail/Dockerfile new file mode 100644 index 0000000000..f64c1168c1 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/mail/Dockerfile @@ -0,0 +1,16 @@ +FROM ubuntu:14.04 + +RUN apt-get update -qy && apt-get install mutt offlineimap vim-nox abook elinks curl tmux cron zsh -y +ADD .muttrc / +ADD .offlineimaprc / +ADD .tmux.conf / +ADD mutt /.mutt +ADD vim /.vim +ADD vimrc /.vimrc +ADD crontab /etc/crontab +RUN chmod 644 /etc/crontab +RUN mkdir /Mail +RUN mkdir /.offlineimap +RUN echo "export TERM=screen-256color" >/.zshenv + +CMD setsid cron; tmux -2 diff --git a/builder/dockerfile/parser/testfiles/mail/result b/builder/dockerfile/parser/testfiles/mail/result new file mode 100644 index 0000000000..a0efcf04b6 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/mail/result @@ -0,0 +1,14 @@ +(from "ubuntu:14.04") +(run "apt-get update -qy && apt-get install mutt offlineimap vim-nox abook elinks curl tmux cron zsh -y") +(add ".muttrc" "/") +(add ".offlineimaprc" "/") +(add ".tmux.conf" "/") +(add "mutt" "/.mutt") +(add "vim" "/.vim") +(add "vimrc" "/.vimrc") +(add "crontab" "/etc/crontab") +(run "chmod 644 /etc/crontab") +(run "mkdir /Mail") +(run "mkdir /.offlineimap") +(run "echo \"export TERM=screen-256color\" >/.zshenv") +(cmd "setsid cron; tmux -2") diff --git a/builder/dockerfile/parser/testfiles/multiple-volumes/Dockerfile b/builder/dockerfile/parser/testfiles/multiple-volumes/Dockerfile new file mode 100644 index 0000000000..57bb5976a3 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/multiple-volumes/Dockerfile @@ -0,0 +1,3 @@ +FROM foo + +VOLUME /opt/nagios/var /opt/nagios/etc /opt/nagios/libexec /var/log/apache2 /usr/share/snmp/mibs diff --git a/builder/dockerfile/parser/testfiles/multiple-volumes/result b/builder/dockerfile/parser/testfiles/multiple-volumes/result new file mode 100644 index 0000000000..18dbdeeaa0 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/multiple-volumes/result @@ -0,0 +1,2 @@ +(from "foo") +(volume "/opt/nagios/var" "/opt/nagios/etc" "/opt/nagios/libexec" "/var/log/apache2" "/usr/share/snmp/mibs") diff --git a/builder/dockerfile/parser/testfiles/mumble/Dockerfile b/builder/dockerfile/parser/testfiles/mumble/Dockerfile new file mode 100644 index 0000000000..5b9ec06a6c --- /dev/null +++ b/builder/dockerfile/parser/testfiles/mumble/Dockerfile @@ -0,0 +1,7 @@ +FROM ubuntu:14.04 + +RUN apt-get update && apt-get install libcap2-bin mumble-server -y + +ADD ./mumble-server.ini /etc/mumble-server.ini + +CMD /usr/sbin/murmurd diff --git a/builder/dockerfile/parser/testfiles/mumble/result b/builder/dockerfile/parser/testfiles/mumble/result new file mode 100644 index 0000000000..a0036a943e --- /dev/null +++ b/builder/dockerfile/parser/testfiles/mumble/result @@ -0,0 +1,4 @@ +(from "ubuntu:14.04") +(run "apt-get update && apt-get install libcap2-bin mumble-server -y") +(add "./mumble-server.ini" "/etc/mumble-server.ini") +(cmd "/usr/sbin/murmurd") diff --git a/builder/dockerfile/parser/testfiles/nginx/Dockerfile b/builder/dockerfile/parser/testfiles/nginx/Dockerfile new file mode 100644 index 0000000000..bf8368e1ca --- /dev/null +++ b/builder/dockerfile/parser/testfiles/nginx/Dockerfile @@ -0,0 +1,14 @@ +FROM ubuntu:14.04 +MAINTAINER Erik Hollensbe + +RUN apt-get update && apt-get install nginx-full -y +RUN rm -rf /etc/nginx +ADD etc /etc/nginx +RUN chown -R root:root /etc/nginx +RUN /usr/sbin/nginx -qt +RUN mkdir /www + +CMD ["/usr/sbin/nginx"] + +VOLUME /www +EXPOSE 80 diff --git a/builder/dockerfile/parser/testfiles/nginx/result b/builder/dockerfile/parser/testfiles/nginx/result new file mode 100644 index 0000000000..56ddb6f258 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/nginx/result @@ -0,0 +1,11 @@ +(from "ubuntu:14.04") +(maintainer "Erik Hollensbe ") +(run "apt-get update && apt-get install nginx-full -y") +(run "rm -rf /etc/nginx") +(add "etc" "/etc/nginx") +(run "chown -R root:root /etc/nginx") +(run "/usr/sbin/nginx -qt") +(run "mkdir /www") +(cmd "/usr/sbin/nginx") +(volume "/www") +(expose "80") diff --git a/builder/dockerfile/parser/testfiles/tf2/Dockerfile b/builder/dockerfile/parser/testfiles/tf2/Dockerfile new file mode 100644 index 0000000000..72b79bdd7d --- /dev/null +++ b/builder/dockerfile/parser/testfiles/tf2/Dockerfile @@ -0,0 +1,23 @@ +FROM ubuntu:12.04 + +EXPOSE 27015 +EXPOSE 27005 +EXPOSE 26901 +EXPOSE 27020 + +RUN apt-get update && apt-get install libc6-dev-i386 curl unzip -y +RUN mkdir -p /steam +RUN curl http://media.steampowered.com/client/steamcmd_linux.tar.gz | tar vxz -C /steam +ADD ./script /steam/script +RUN /steam/steamcmd.sh +runscript /steam/script +RUN curl http://mirror.pointysoftware.net/alliedmodders/mmsource-1.10.0-linux.tar.gz | tar vxz -C /steam/tf2/tf +RUN curl http://mirror.pointysoftware.net/alliedmodders/sourcemod-1.5.3-linux.tar.gz | tar vxz -C /steam/tf2/tf +ADD ./server.cfg /steam/tf2/tf/cfg/server.cfg +ADD ./ctf_2fort.cfg /steam/tf2/tf/cfg/ctf_2fort.cfg +ADD ./sourcemod.cfg /steam/tf2/tf/cfg/sourcemod/sourcemod.cfg +RUN rm -r /steam/tf2/tf/addons/sourcemod/configs +ADD ./configs /steam/tf2/tf/addons/sourcemod/configs +RUN mkdir -p /steam/tf2/tf/addons/sourcemod/translations/en +RUN cp /steam/tf2/tf/addons/sourcemod/translations/*.txt /steam/tf2/tf/addons/sourcemod/translations/en + +CMD cd /steam/tf2 && ./srcds_run -port 27015 +ip 0.0.0.0 +map ctf_2fort -autoupdate -steam_dir /steam -steamcmd_script /steam/script +tf_bot_quota 12 +tf_bot_quota_mode fill diff --git a/builder/dockerfile/parser/testfiles/tf2/result b/builder/dockerfile/parser/testfiles/tf2/result new file mode 100644 index 0000000000..d4f94cd8be --- /dev/null +++ b/builder/dockerfile/parser/testfiles/tf2/result @@ -0,0 +1,20 @@ +(from "ubuntu:12.04") +(expose "27015") +(expose "27005") +(expose "26901") +(expose "27020") +(run "apt-get update && apt-get install libc6-dev-i386 curl unzip -y") +(run "mkdir -p /steam") +(run "curl http://media.steampowered.com/client/steamcmd_linux.tar.gz | tar vxz -C /steam") +(add "./script" "/steam/script") +(run "/steam/steamcmd.sh +runscript /steam/script") +(run "curl http://mirror.pointysoftware.net/alliedmodders/mmsource-1.10.0-linux.tar.gz | tar vxz -C /steam/tf2/tf") +(run "curl http://mirror.pointysoftware.net/alliedmodders/sourcemod-1.5.3-linux.tar.gz | tar vxz -C /steam/tf2/tf") +(add "./server.cfg" "/steam/tf2/tf/cfg/server.cfg") +(add "./ctf_2fort.cfg" "/steam/tf2/tf/cfg/ctf_2fort.cfg") +(add "./sourcemod.cfg" "/steam/tf2/tf/cfg/sourcemod/sourcemod.cfg") +(run "rm -r /steam/tf2/tf/addons/sourcemod/configs") +(add "./configs" "/steam/tf2/tf/addons/sourcemod/configs") +(run "mkdir -p /steam/tf2/tf/addons/sourcemod/translations/en") +(run "cp /steam/tf2/tf/addons/sourcemod/translations/*.txt /steam/tf2/tf/addons/sourcemod/translations/en") +(cmd "cd /steam/tf2 && ./srcds_run -port 27015 +ip 0.0.0.0 +map ctf_2fort -autoupdate -steam_dir /steam -steamcmd_script /steam/script +tf_bot_quota 12 +tf_bot_quota_mode fill") diff --git a/builder/dockerfile/parser/testfiles/weechat/Dockerfile b/builder/dockerfile/parser/testfiles/weechat/Dockerfile new file mode 100644 index 0000000000..4842088166 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/weechat/Dockerfile @@ -0,0 +1,9 @@ +FROM ubuntu:14.04 + +RUN apt-get update -qy && apt-get install tmux zsh weechat-curses -y + +ADD .weechat /.weechat +ADD .tmux.conf / +RUN echo "export TERM=screen-256color" >/.zshenv + +CMD zsh -c weechat diff --git a/builder/dockerfile/parser/testfiles/weechat/result b/builder/dockerfile/parser/testfiles/weechat/result new file mode 100644 index 0000000000..c3abb4c54f --- /dev/null +++ b/builder/dockerfile/parser/testfiles/weechat/result @@ -0,0 +1,6 @@ +(from "ubuntu:14.04") +(run "apt-get update -qy && apt-get install tmux zsh weechat-curses -y") +(add ".weechat" "/.weechat") +(add ".tmux.conf" "/") +(run "echo \"export TERM=screen-256color\" >/.zshenv") +(cmd "zsh -c weechat") diff --git a/builder/dockerfile/parser/testfiles/znc/Dockerfile b/builder/dockerfile/parser/testfiles/znc/Dockerfile new file mode 100644 index 0000000000..3a4da6e916 --- /dev/null +++ b/builder/dockerfile/parser/testfiles/znc/Dockerfile @@ -0,0 +1,7 @@ +FROM ubuntu:14.04 +MAINTAINER Erik Hollensbe + +RUN apt-get update && apt-get install znc -y +ADD conf /.znc + +CMD [ "/usr/bin/znc", "-f", "-r" ] diff --git a/builder/dockerfile/parser/testfiles/znc/result b/builder/dockerfile/parser/testfiles/znc/result new file mode 100644 index 0000000000..5493b255fd --- /dev/null +++ b/builder/dockerfile/parser/testfiles/znc/result @@ -0,0 +1,5 @@ +(from "ubuntu:14.04") +(maintainer "Erik Hollensbe ") +(run "apt-get update && apt-get install znc -y") +(add "conf" "/.znc") +(cmd "/usr/bin/znc" "-f" "-r") diff --git a/builder/dockerfile/parser/utils.go b/builder/dockerfile/parser/utils.go new file mode 100644 index 0000000000..352d7a7e1c --- /dev/null +++ b/builder/dockerfile/parser/utils.go @@ -0,0 +1,176 @@ +package parser + +import ( + "fmt" + "strconv" + "strings" + "unicode" +) + +// Dump dumps the AST defined by `node` as a list of sexps. +// Returns a string suitable for printing. +func (node *Node) Dump() string { + str := "" + str += node.Value + + if len(node.Flags) > 0 { + str += fmt.Sprintf(" %q", node.Flags) + } + + for _, n := range node.Children { + str += "(" + n.Dump() + ")\n" + } + + if node.Next != nil { + for n := node.Next; n != nil; n = n.Next { + if len(n.Children) > 0 { + str += " " + n.Dump() + } else { + str += " " + strconv.Quote(n.Value) + } + } + } + + return strings.TrimSpace(str) +} + +// performs the dispatch based on the two primal strings, cmd and args. Please +// look at the dispatch table in parser.go to see how these dispatchers work. +func fullDispatch(cmd, args string) (*Node, map[string]bool, error) { + fn := dispatch[cmd] + + // Ignore invalid Dockerfile instructions + if fn == nil { + fn = parseIgnore + } + + sexp, attrs, err := fn(args) + if err != nil { + return nil, nil, err + } + + return sexp, attrs, nil +} + +// splitCommand takes a single line of text and parses out the cmd and args, +// which are used for dispatching to more exact parsing functions. +func splitCommand(line string) (string, []string, string, error) { + var args string + var flags []string + + // Make sure we get the same results irrespective of leading/trailing spaces + cmdline := tokenWhitespace.Split(strings.TrimSpace(line), 2) + cmd := strings.ToLower(cmdline[0]) + + if len(cmdline) == 2 { + var err error + args, flags, err = extractBuilderFlags(cmdline[1]) + if err != nil { + return "", nil, "", err + } + } + + return cmd, flags, strings.TrimSpace(args), nil +} + +// covers comments and empty lines. Lines should be trimmed before passing to +// this function. +func stripComments(line string) string { + // string is already trimmed at this point + if tokenComment.MatchString(line) { + return tokenComment.ReplaceAllString(line, "") + } + + return line +} + +func extractBuilderFlags(line string) (string, []string, error) { + // Parses the BuilderFlags and returns the remaining part of the line + + const ( + inSpaces = iota // looking for start of a word + inWord + inQuote + ) + + words := []string{} + phase := inSpaces + word := "" + quote := '\000' + blankOK := false + var ch rune + + for pos := 0; pos <= len(line); pos++ { + if pos != len(line) { + ch = rune(line[pos]) + } + + if phase == inSpaces { // Looking for start of word + if pos == len(line) { // end of input + break + } + if unicode.IsSpace(ch) { // skip spaces + continue + } + + // Only keep going if the next word starts with -- + if ch != '-' || pos+1 == len(line) || rune(line[pos+1]) != '-' { + return line[pos:], words, nil + } + + phase = inWord // found someting with "--", fall thru + } + if (phase == inWord || phase == inQuote) && (pos == len(line)) { + if word != "--" && (blankOK || len(word) > 0) { + words = append(words, word) + } + break + } + if phase == inWord { + if unicode.IsSpace(ch) { + phase = inSpaces + if word == "--" { + return line[pos:], words, nil + } + if blankOK || len(word) > 0 { + words = append(words, word) + } + word = "" + blankOK = false + continue + } + if ch == '\'' || ch == '"' { + quote = ch + blankOK = true + phase = inQuote + continue + } + if ch == '\\' { + if pos+1 == len(line) { + continue // just skip \ at end + } + pos++ + ch = rune(line[pos]) + } + word += string(ch) + continue + } + if phase == inQuote { + if ch == quote { + phase = inWord + continue + } + if ch == '\\' { + if pos+1 == len(line) { + phase = inWord + continue // just skip \ at end + } + pos++ + ch = rune(line[pos]) + } + word += string(ch) + } + } + + return "", words, nil +} diff --git a/builder/dockerfile/shell_parser.go b/builder/dockerfile/shell_parser.go new file mode 100644 index 0000000000..7ef1773523 --- /dev/null +++ b/builder/dockerfile/shell_parser.go @@ -0,0 +1,243 @@ +package dockerfile + +// This will take a single word and an array of env variables and +// process all quotes (" and ') as well as $xxx and ${xxx} env variable +// tokens. Tries to mimic bash shell process. +// It doesn't support all flavors of ${xx:...} formats but new ones can +// be added by adding code to the "special ${} format processing" section + +import ( + "fmt" + "strings" + "unicode" +) + +type shellWord struct { + word string + envs []string + pos int +} + +// ProcessWord will use the 'env' list of environment variables, +// and replace any env var references in 'word'. +func ProcessWord(word string, env []string) (string, error) { + sw := &shellWord{ + word: word, + envs: env, + pos: 0, + } + return sw.process() +} + +func (sw *shellWord) process() (string, error) { + return sw.processStopOn('\000') +} + +// Process the word, starting at 'pos', and stop when we get to the +// end of the word or the 'stopChar' character +func (sw *shellWord) processStopOn(stopChar rune) (string, error) { + var result string + var charFuncMapping = map[rune]func() (string, error){ + '\'': sw.processSingleQuote, + '"': sw.processDoubleQuote, + '$': sw.processDollar, + } + + for sw.pos < len(sw.word) { + ch := sw.peek() + if stopChar != '\000' && ch == stopChar { + sw.next() + break + } + if fn, ok := charFuncMapping[ch]; ok { + // Call special processing func for certain chars + tmp, err := fn() + if err != nil { + return "", err + } + result += tmp + } else { + // Not special, just add it to the result + ch = sw.next() + if ch == '\\' { + // '\' escapes, except end of line + ch = sw.next() + if ch == '\000' { + continue + } + } + result += string(ch) + } + } + + return result, nil +} + +func (sw *shellWord) peek() rune { + if sw.pos == len(sw.word) { + return '\000' + } + return rune(sw.word[sw.pos]) +} + +func (sw *shellWord) next() rune { + if sw.pos == len(sw.word) { + return '\000' + } + ch := rune(sw.word[sw.pos]) + sw.pos++ + return ch +} + +func (sw *shellWord) processSingleQuote() (string, error) { + // All chars between single quotes are taken as-is + // Note, you can't escape ' + var result string + + sw.next() + + for { + ch := sw.next() + if ch == '\000' || ch == '\'' { + break + } + result += string(ch) + } + return result, nil +} + +func (sw *shellWord) processDoubleQuote() (string, error) { + // All chars up to the next " are taken as-is, even ', except any $ chars + // But you can escape " with a \ + var result string + + sw.next() + + for sw.pos < len(sw.word) { + ch := sw.peek() + if ch == '"' { + sw.next() + break + } + if ch == '$' { + tmp, err := sw.processDollar() + if err != nil { + return "", err + } + result += tmp + } else { + ch = sw.next() + if ch == '\\' { + chNext := sw.peek() + + if chNext == '\000' { + // Ignore \ at end of word + continue + } + + if chNext == '"' || chNext == '$' { + // \" and \$ can be escaped, all other \'s are left as-is + ch = sw.next() + } + } + result += string(ch) + } + } + + return result, nil +} + +func (sw *shellWord) processDollar() (string, error) { + sw.next() + ch := sw.peek() + if ch == '{' { + sw.next() + name := sw.processName() + ch = sw.peek() + if ch == '}' { + // Normal ${xx} case + sw.next() + return sw.getEnv(name), nil + } + if ch == ':' { + // Special ${xx:...} format processing + // Yes it allows for recursive $'s in the ... spot + + sw.next() // skip over : + modifier := sw.next() + + word, err := sw.processStopOn('}') + if err != nil { + return "", err + } + + // Grab the current value of the variable in question so we + // can use to to determine what to do based on the modifier + newValue := sw.getEnv(name) + + switch modifier { + case '+': + if newValue != "" { + newValue = word + } + return newValue, nil + + case '-': + if newValue == "" { + newValue = word + } + return newValue, nil + + default: + return "", fmt.Errorf("Unsupported modifier (%c) in substitution: %s", modifier, sw.word) + } + } + return "", fmt.Errorf("Missing ':' in substitution: %s", sw.word) + } + // $xxx case + name := sw.processName() + if name == "" { + return "$", nil + } + return sw.getEnv(name), nil +} + +func (sw *shellWord) processName() string { + // Read in a name (alphanumeric or _) + // If it starts with a numeric then just return $# + var name string + + for sw.pos < len(sw.word) { + ch := sw.peek() + if len(name) == 0 && unicode.IsDigit(ch) { + ch = sw.next() + return string(ch) + } + if !unicode.IsLetter(ch) && !unicode.IsDigit(ch) && ch != '_' { + break + } + ch = sw.next() + name += string(ch) + } + + return name +} + +func (sw *shellWord) getEnv(name string) string { + for _, env := range sw.envs { + i := strings.Index(env, "=") + if i < 0 { + if name == env { + // Should probably never get here, but just in case treat + // it like "var" and "var=" are the same + return "" + } + continue + } + if name != env[:i] { + continue + } + return env[i+1:] + } + return "" +} diff --git a/builder/dockerfile/shell_parser_test.go b/builder/dockerfile/shell_parser_test.go new file mode 100644 index 0000000000..6568e39418 --- /dev/null +++ b/builder/dockerfile/shell_parser_test.go @@ -0,0 +1,93 @@ +package dockerfile + +import ( + "bufio" + "os" + "strings" + "testing" +) + +func TestShellParser(t *testing.T) { + file, err := os.Open("words") + if err != nil { + t.Fatalf("Can't open 'words': %s", err) + } + defer file.Close() + + scanner := bufio.NewScanner(file) + envs := []string{"PWD=/home", "SHELL=bash"} + for scanner.Scan() { + line := scanner.Text() + + // Trim comments and blank lines + i := strings.Index(line, "#") + if i >= 0 { + line = line[:i] + } + line = strings.TrimSpace(line) + + if line == "" { + continue + } + + words := strings.Split(line, "|") + if len(words) != 2 { + t.Fatalf("Error in 'words' - should be 2 words:%q", words) + } + + words[0] = strings.TrimSpace(words[0]) + words[1] = strings.TrimSpace(words[1]) + + newWord, err := ProcessWord(words[0], envs) + + if err != nil { + newWord = "error" + } + + if newWord != words[1] { + t.Fatalf("Error. Src: %s Calc: %s Expected: %s", words[0], newWord, words[1]) + } + } +} + +func TestGetEnv(t *testing.T) { + sw := &shellWord{ + word: "", + envs: nil, + pos: 0, + } + + sw.envs = []string{} + if sw.getEnv("foo") != "" { + t.Fatalf("2 - 'foo' should map to ''") + } + + sw.envs = []string{"foo"} + if sw.getEnv("foo") != "" { + t.Fatalf("3 - 'foo' should map to ''") + } + + sw.envs = []string{"foo="} + if sw.getEnv("foo") != "" { + t.Fatalf("4 - 'foo' should map to ''") + } + + sw.envs = []string{"foo=bar"} + if sw.getEnv("foo") != "bar" { + t.Fatalf("5 - 'foo' should map to 'bar'") + } + + sw.envs = []string{"foo=bar", "car=hat"} + if sw.getEnv("foo") != "bar" { + t.Fatalf("6 - 'foo' should map to 'bar'") + } + if sw.getEnv("car") != "hat" { + t.Fatalf("7 - 'car' should map to 'hat'") + } + + // Make sure we grab the first 'car' in the list + sw.envs = []string{"foo=bar", "car=hat", "car=bike"} + if sw.getEnv("car") != "hat" { + t.Fatalf("8 - 'car' should map to 'hat'") + } +} diff --git a/builder/dockerfile/support.go b/builder/dockerfile/support.go new file mode 100644 index 0000000000..38897b2cad --- /dev/null +++ b/builder/dockerfile/support.go @@ -0,0 +1,16 @@ +package dockerfile + +import "strings" + +func handleJSONArgs(args []string, attributes map[string]bool) []string { + if len(args) == 0 { + return []string{} + } + + if attributes != nil && attributes["json"] { + return args + } + + // literal string command, not an exec array + return []string{strings.Join(args, " ")} +} diff --git a/builder/dockerfile/words b/builder/dockerfile/words new file mode 100644 index 0000000000..1114a7e466 --- /dev/null +++ b/builder/dockerfile/words @@ -0,0 +1,58 @@ +hello | hello +he'll'o | hello +he'llo | hello +he\'llo | he'llo +he\\'llo | he\llo +abc\tdef | abctdef +"abc\tdef" | abc\tdef +'abc\tdef' | abc\tdef +hello\ | hello +hello\\ | hello\ +"hello | hello +"hello\" | hello" +"hel'lo" | hel'lo +'hello | hello +'hello\' | hello\ +"''" | '' +$. | $. +$1 | +he$1x | hex +he$.x | he$.x +he$pwd. | he. +he$PWD | he/home +he\$PWD | he$PWD +he\\$PWD | he\/home +he\${} | he${} +he\${}xx | he${}xx +he${} | he +he${}xx | hexx +he${hi} | he +he${hi}xx | hexx +he${PWD} | he/home +he${.} | error +he${XXX:-000}xx | he000xx +he${PWD:-000}xx | he/homexx +he${XXX:-$PWD}xx | he/homexx +he${XXX:-${PWD:-yyy}}xx | he/homexx +he${XXX:-${YYY:-yyy}}xx | heyyyxx +he${XXX:YYY} | error +he${XXX:+${PWD}}xx | hexx +he${PWD:+${XXX}}xx | hexx +he${PWD:+${SHELL}}xx | hebashxx +he${XXX:+000}xx | hexx +he${PWD:+000}xx | he000xx +'he${XX}' | he${XX} +"he${PWD}" | he/home +"he'$PWD'" | he'/home' +"$PWD" | /home +'$PWD' | $PWD +'\$PWD' | \$PWD +'"hello"' | "hello" +he\$PWD | he$PWD +"he\$PWD" | he$PWD +'he\$PWD' | he\$PWD +he${PWD | error +he${PWD:=000}xx | error +he${PWD:+${PWD}:}xx | he/home:xx +he${XXX:-\$PWD:}xx | he$PWD:xx +he${XXX:-\${PWD}z}xx | he${PWDz}xx diff --git a/builder/dockerignore.go b/builder/dockerignore.go new file mode 100644 index 0000000000..7630274c99 --- /dev/null +++ b/builder/dockerignore.go @@ -0,0 +1,47 @@ +package builder + +import ( + "os" + + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/utils" +) + +// DockerIgnoreContext wraps a ModifiableContext to add a method +// for handling the .dockerignore file at the root of the context. +type DockerIgnoreContext struct { + ModifiableContext +} + +// Process reads the .dockerignore file at the root of the embedded context. +// If .dockerignore does not exist in the context, then nil is returned. +// +// It can take a list of files to be removed after .dockerignore is removed. +// This is used for server-side implementations of builders that need to send +// the .dockerignore file as well as the special files specified in filesToRemove, +// but expect them to be excluded from the context after they were processed. +// +// For example, server-side Dockerfile builders are expected to pass in the name +// of the Dockerfile to be removed after it was parsed. +// +// TODO: Don't require a ModifiableContext (use Context instead) and don't remove +// files, instead handle a list of files to be excluded from the context. +func (c DockerIgnoreContext) Process(filesToRemove []string) error { + dockerignore, err := c.Open(".dockerignore") + // Note that a missing .dockerignore file isn't treated as an error + if err != nil { + if os.IsNotExist(err) { + return nil + } + return err + } + excludes, _ := utils.ReadDockerIgnore(dockerignore) + filesToRemove = append([]string{".dockerignore"}, filesToRemove...) + for _, fileToRemove := range filesToRemove { + rm, _ := fileutils.Matches(fileToRemove, excludes) + if rm { + c.Remove(fileToRemove) + } + } + return nil +} diff --git a/builder/git.go b/builder/git.go new file mode 100644 index 0000000000..e857060cc0 --- /dev/null +++ b/builder/git.go @@ -0,0 +1,28 @@ +package builder + +import ( + "os" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/utils" +) + +// MakeGitContext returns a Context from gitURL that is cloned in a temporary directory. +func MakeGitContext(gitURL string) (ModifiableContext, error) { + root, err := utils.GitClone(gitURL) + if err != nil { + return nil, err + } + + c, err := archive.Tar(root, archive.Uncompressed) + if err != nil { + return nil, err + } + + defer func() { + // TODO: print errors? + c.Close() + os.RemoveAll(root) + }() + return MakeTarSumContext(c) +} diff --git a/builder/remote.go b/builder/remote.go new file mode 100644 index 0000000000..b43bd32841 --- /dev/null +++ b/builder/remote.go @@ -0,0 +1,115 @@ +package builder + +import ( + "bytes" + "errors" + "fmt" + "io" + "io/ioutil" + "regexp" + + "github.com/docker/docker/pkg/httputils" +) + +// When downloading remote contexts, limit the amount (in bytes) +// to be read from the response body in order to detect its Content-Type +const maxPreambleLength = 100 + +const acceptableRemoteMIME = `(?:application/(?:(?:x\-)?tar|octet\-stream|((?:x\-)?(?:gzip|bzip2?|xz)))|(?:text/plain))` + +var mimeRe = regexp.MustCompile(acceptableRemoteMIME) + +// MakeRemoteContext downloads a context from remoteURL and returns it. +// +// If contentTypeHandlers is non-nil, then the Content-Type header is read along with a maximum of +// maxPreambleLength bytes from the body to help detecting the MIME type. +// Look at acceptableRemoteMIME for more details. +// +// If a match is found, then the body is sent to the contentType handler and a (potentially compressed) tar stream is expected +// to be returned. If no match is found, it is assumed the body is a tar stream (compressed or not). +// In either case, an (assumed) tar stream is passed to MakeTarSumContext whose result is returned. +func MakeRemoteContext(remoteURL string, contentTypeHandlers map[string]func(io.ReadCloser) (io.ReadCloser, error)) (ModifiableContext, error) { + f, err := httputils.Download(remoteURL) + if err != nil { + return nil, fmt.Errorf("Error downloading remote context %s: %v", remoteURL, err) + } + defer f.Body.Close() + + var contextReader io.ReadCloser + if contentTypeHandlers != nil { + contentType := f.Header.Get("Content-Type") + clen := f.ContentLength + + contentType, contextReader, err = inspectResponse(contentType, f.Body, clen) + if err != nil { + return nil, fmt.Errorf("Error detecting content type for remote %s: %v", remoteURL, err) + } + defer contextReader.Close() + + // This loop tries to find a content-type handler for the detected content-type. + // If it could not find one from the caller-supplied map, it tries the empty content-type `""` + // which is interpreted as a fallback handler (usually used for raw tar contexts). + for _, ct := range []string{contentType, ""} { + if fn, ok := contentTypeHandlers[ct]; ok { + defer contextReader.Close() + if contextReader, err = fn(contextReader); err != nil { + return nil, err + } + break + } + } + } + + // Pass through - this is a pre-packaged context, presumably + // with a Dockerfile with the right name inside it. + return MakeTarSumContext(contextReader) +} + +// inspectResponse looks into the http response data at r to determine whether its +// content-type is on the list of acceptable content types for remote build contexts. +// This function returns: +// - a string representation of the detected content-type +// - an io.Reader for the response body +// - an error value which will be non-nil either when something goes wrong while +// reading bytes from r or when the detected content-type is not acceptable. +func inspectResponse(ct string, r io.ReadCloser, clen int64) (string, io.ReadCloser, error) { + plen := clen + if plen <= 0 || plen > maxPreambleLength { + plen = maxPreambleLength + } + + preamble := make([]byte, plen, plen) + rlen, err := r.Read(preamble) + if rlen == 0 { + return ct, r, errors.New("Empty response") + } + if err != nil && err != io.EOF { + return ct, r, err + } + + preambleR := bytes.NewReader(preamble) + bodyReader := ioutil.NopCloser(io.MultiReader(preambleR, r)) + // Some web servers will use application/octet-stream as the default + // content type for files without an extension (e.g. 'Dockerfile') + // so if we receive this value we better check for text content + contentType := ct + if len(ct) == 0 || ct == httputils.MimeTypes.OctetStream { + contentType, _, err = httputils.DetectContentType(preamble) + if err != nil { + return contentType, bodyReader, err + } + } + + contentType = selectAcceptableMIME(contentType) + var cterr error + if len(contentType) == 0 { + cterr = fmt.Errorf("unsupported Content-Type %q", ct) + contentType = ct + } + + return contentType, bodyReader, cterr +} + +func selectAcceptableMIME(ct string) string { + return mimeRe.FindString(ct) +} diff --git a/builder/remote_test.go b/builder/remote_test.go new file mode 100644 index 0000000000..b6e846be60 --- /dev/null +++ b/builder/remote_test.go @@ -0,0 +1,149 @@ +package builder + +import ( + "bytes" + "fmt" + "io/ioutil" + "testing" +) + +var textPlainDockerfile = "FROM busybox" +var binaryContext = []byte{0xFD, 0x37, 0x7A, 0x58, 0x5A, 0x00} //xz magic + +func TestSelectAcceptableMIME(t *testing.T) { + validMimeStrings := []string{ + "application/x-bzip2", + "application/bzip2", + "application/gzip", + "application/x-gzip", + "application/x-xz", + "application/xz", + "application/tar", + "application/x-tar", + "application/octet-stream", + "text/plain", + } + + invalidMimeStrings := []string{ + "", + "application/octet", + "application/json", + } + + for _, m := range invalidMimeStrings { + if len(selectAcceptableMIME(m)) > 0 { + err := fmt.Errorf("Should not have accepted %q", m) + t.Fatal(err) + } + } + + for _, m := range validMimeStrings { + if str := selectAcceptableMIME(m); str == "" { + err := fmt.Errorf("Should have accepted %q", m) + t.Fatal(err) + } + } +} + +func TestInspectEmptyResponse(t *testing.T) { + ct := "application/octet-stream" + br := ioutil.NopCloser(bytes.NewReader([]byte(""))) + contentType, bReader, err := inspectResponse(ct, br, 0) + if err == nil { + t.Fatalf("Should have generated an error for an empty response") + } + if contentType != "application/octet-stream" { + t.Fatalf("Content type should be 'application/octet-stream' but is %q", contentType) + } + body, err := ioutil.ReadAll(bReader) + if err != nil { + t.Fatal(err) + } + if len(body) != 0 { + t.Fatal("response body should remain empty") + } +} + +func TestInspectResponseBinary(t *testing.T) { + ct := "application/octet-stream" + br := ioutil.NopCloser(bytes.NewReader(binaryContext)) + contentType, bReader, err := inspectResponse(ct, br, int64(len(binaryContext))) + if err != nil { + t.Fatal(err) + } + if contentType != "application/octet-stream" { + t.Fatalf("Content type should be 'application/octet-stream' but is %q", contentType) + } + body, err := ioutil.ReadAll(bReader) + if err != nil { + t.Fatal(err) + } + if len(body) != len(binaryContext) { + t.Fatalf("Wrong response size %d, should be == len(binaryContext)", len(body)) + } + for i := range body { + if body[i] != binaryContext[i] { + t.Fatalf("Corrupted response body at byte index %d", i) + } + } +} + +func TestResponseUnsupportedContentType(t *testing.T) { + content := []byte(textPlainDockerfile) + ct := "application/json" + br := ioutil.NopCloser(bytes.NewReader(content)) + contentType, bReader, err := inspectResponse(ct, br, int64(len(textPlainDockerfile))) + + if err == nil { + t.Fatal("Should have returned an error on content-type 'application/json'") + } + if contentType != ct { + t.Fatalf("Should not have altered content-type: orig: %s, altered: %s", ct, contentType) + } + body, err := ioutil.ReadAll(bReader) + if err != nil { + t.Fatal(err) + } + if string(body) != textPlainDockerfile { + t.Fatalf("Corrupted response body %s", body) + } +} + +func TestInspectResponseTextSimple(t *testing.T) { + content := []byte(textPlainDockerfile) + ct := "text/plain" + br := ioutil.NopCloser(bytes.NewReader(content)) + contentType, bReader, err := inspectResponse(ct, br, int64(len(content))) + if err != nil { + t.Fatal(err) + } + if contentType != "text/plain" { + t.Fatalf("Content type should be 'text/plain' but is %q", contentType) + } + body, err := ioutil.ReadAll(bReader) + if err != nil { + t.Fatal(err) + } + if string(body) != textPlainDockerfile { + t.Fatalf("Corrupted response body %s", body) + } +} + +func TestInspectResponseEmptyContentType(t *testing.T) { + content := []byte(textPlainDockerfile) + br := ioutil.NopCloser(bytes.NewReader(content)) + contentType, bodyReader, err := inspectResponse("", br, int64(len(content))) + if err != nil { + t.Fatal(err) + } + if contentType != "text/plain" { + t.Fatalf("Content type should be 'text/plain' but is %q", contentType) + } + body, err := ioutil.ReadAll(bodyReader) + if err != nil { + t.Fatal(err) + } + if string(body) != textPlainDockerfile { + t.Fatalf("Corrupted response body %s", body) + } +} diff --git a/builder/shell_parser.go b/builder/shell_parser.go new file mode 100644 index 0000000000..b8c746773c --- /dev/null +++ b/builder/shell_parser.go @@ -0,0 +1,209 @@ +package builder + +// This will take a single word and an array of env variables and +// process all quotes (" and ') as well as $xxx and ${xxx} env variable +// tokens. Tries to mimic bash shell process. +// It doesn't support all flavors of ${xx:...} formats but new ones can +// be added by adding code to the "special ${} format processing" section + +import ( + "fmt" + "strings" + "unicode" +) + +type shellWord struct { + word string + envs []string + pos int +} + +func ProcessWord(word string, env []string) (string, error) { + sw := &shellWord{ + word: word, + envs: env, + pos: 0, + } + return sw.process() +} + +func (sw *shellWord) process() (string, error) { + return sw.processStopOn('\000') +} + +// Process the word, starting at 'pos', and stop when we get to the +// end of the word or the 'stopChar' character +func (sw *shellWord) processStopOn(stopChar rune) (string, error) { + var result string + var charFuncMapping = map[rune]func() (string, error){ + '\'': sw.processSingleQuote, + '"': sw.processDoubleQuote, + '$': sw.processDollar, + } + + for sw.pos < len(sw.word) { + ch := sw.peek() + if stopChar != '\000' && ch == stopChar { + sw.next() + break + } + if fn, ok := charFuncMapping[ch]; ok { + // Call special processing func for certain chars + tmp, err := fn() + if err != nil { + return "", err + } + result += tmp + } else { + // Not special, just add it to the result + ch = sw.next() + if ch == '\\' { + // '\' escapes, except end of line + ch = sw.next() + if ch == '\000' { + continue + } + } + result += string(ch) + } + } + + return result, nil +} + +func (sw *shellWord) peek() rune { + if sw.pos == len(sw.word) { + return '\000' + } + return rune(sw.word[sw.pos]) +} + +func (sw *shellWord) next() rune { + if sw.pos == len(sw.word) { + return '\000' + } + ch := rune(sw.word[sw.pos]) + sw.pos++ + return ch +} + +func (sw *shellWord) processSingleQuote() (string, error) { + // All chars between single quotes are taken as-is + // Note, you can't escape ' + var result string + + sw.next() + + for { + ch := sw.next() + if ch == '\000' || ch == '\'' { + break + } + result += string(ch) + } + return result, nil +} + +func (sw *shellWord) processDoubleQuote() (string, error) { + // All chars up to the next " are taken as-is, even ', except any $ chars + // But you can escape " with a \ + var result string + + sw.next() + + for sw.pos < len(sw.word) { + ch := sw.peek() + if ch == '"' { + sw.next() + break + } + if ch == '$' { + tmp, err := sw.processDollar() + if err != nil { + return "", err + } + result += tmp + } else { + ch = sw.next() + if ch == '\\' { + chNext := sw.peek() + + if chNext == '\000' { + // Ignore \ at end of word + continue + } + + if chNext == '"' || chNext == '$' { + // \" and \$ can be escaped, all other \'s are left as-is + ch = sw.next() + } + } + result += string(ch) + } + } + + return result, nil +} + +func (sw *shellWord) processDollar() (string, error) { + sw.next() + ch := sw.peek() + if ch == '{' { + sw.next() + name := sw.processName() + ch = sw.peek() + if ch == '}' { + // Normal ${xx} case + sw.next() + return sw.getEnv(name), nil + } + return "", fmt.Errorf("Unsupported ${} substitution: %s", sw.word) + } else { + // $xxx case + name := sw.processName() + if name == "" { + return "$", nil + } + return sw.getEnv(name), nil + } +} + +func (sw *shellWord) processName() string { + // Read in a name (alphanumeric or _) + // If it starts with a numeric then just return $# + var name string + + for sw.pos < len(sw.word) { + ch := sw.peek() + if len(name) == 0 && unicode.IsDigit(ch) { + ch = sw.next() + return string(ch) + } + if !unicode.IsLetter(ch) && !unicode.IsDigit(ch) && ch != '_' { + break + } + ch = sw.next() + name += string(ch) + } + + return name +} + +func (sw *shellWord) getEnv(name string) string { + for _, env := range sw.envs { + i := strings.Index(env, "=") + if i < 0 { + if name == env { + // Should probably never get here, but just in case treat + // it like "var" and "var=" are the same + return "" + } + continue + } + if name != env[:i] { + continue + } + return env[i+1:] + } + return "" +} diff --git a/builder/shell_parser_test.go b/builder/shell_parser_test.go new file mode 100644 index 0000000000..79260492f3 --- /dev/null +++ b/builder/shell_parser_test.go @@ -0,0 +1,51 @@ +package builder + +import ( + "bufio" + "os" + "strings" + "testing" +) + +func TestShellParser(t *testing.T) { + file, err := os.Open("words") + if err != nil { + t.Fatalf("Can't open 'words': %s", err) + } + defer file.Close() + + scanner := bufio.NewScanner(file) + envs := []string{"PWD=/home", "SHELL=bash"} + for scanner.Scan() { + line := scanner.Text() + + // Trim comments and blank lines + i := strings.Index(line, "#") + if i >= 0 { + line = line[:i] + } + line = strings.TrimSpace(line) + + if line == "" { + continue + } + + words := strings.Split(line, "|") + if len(words) != 2 { + t.Fatalf("Error in 'words' - should be 2 words:%q", words) + } + + words[0] = strings.TrimSpace(words[0]) + words[1] = strings.TrimSpace(words[1]) + + newWord, err := ProcessWord(words[0], envs) + + if err != nil { + newWord = "error" + } + + if newWord != words[1] { + t.Fatalf("Error. Src: %s Calc: %s Expected: %s", words[0], newWord, words[1]) + } + } +} diff --git a/builder/tarsum.go b/builder/tarsum.go new file mode 100644 index 0000000000..201e3ef7d9 --- /dev/null +++ b/builder/tarsum.go @@ -0,0 +1,158 @@ +package builder + +import ( + "fmt" + "io" + "os" + "path/filepath" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/symlink" + "github.com/docker/docker/pkg/tarsum" +) + +type tarSumContext struct { + root string + sums tarsum.FileInfoSums +} + +func (c *tarSumContext) Close() error { + return os.RemoveAll(c.root) +} + +func convertPathError(err error, cleanpath string) error { + if err, ok := err.(*os.PathError); ok { + err.Path = cleanpath + return err + } + return err +} + +func (c *tarSumContext) Open(path string) (io.ReadCloser, error) { + cleanpath, fullpath, err := c.normalize(path) + if err != nil { + return nil, err + } + r, err := os.Open(fullpath) + if err != nil { + return nil, convertPathError(err, cleanpath) + } + return r, nil +} + +func (c *tarSumContext) Stat(path string) (string, FileInfo, error) { + cleanpath, fullpath, err := c.normalize(path) + if err != nil { + return "", nil, err + } + + st, err := os.Lstat(fullpath) + if err != nil { + return "", nil, convertPathError(err, cleanpath) + } + + rel, err := filepath.Rel(c.root, fullpath) + if err != nil { + return "", nil, convertPathError(err, cleanpath) + } + + // We set sum to path by default for the case where GetFile returns nil. + // The usual case is if relative path is empty. + sum := path + // Use the checksum of the followed path(not the possible symlink) because + // this is the file that is actually copied. + if tsInfo := c.sums.GetFile(rel); tsInfo != nil { + sum = tsInfo.Sum() + } + fi := &HashedFileInfo{PathFileInfo{st, fullpath, filepath.Base(cleanpath)}, sum} + return rel, fi, nil +} + +// MakeTarSumContext returns a build Context from a tar stream. +// +// It extracts the tar stream to a temporary folder that is deleted as soon as +// the Context is closed. +// As the extraction happens, a tarsum is calculated for every file, and the set of +// all those sums then becomes the source of truth for all operations on this Context. +// +// Closing tarStream has to be done by the caller. +func MakeTarSumContext(tarStream io.Reader) (ModifiableContext, error) { + root, err := ioutils.TempDir("", "docker-builder") + if err != nil { + return nil, err + } + + tsc := &tarSumContext{root: root} + + // Make sure we clean-up upon error. In the happy case the caller + // is expected to manage the clean-up + defer func() { + if err != nil { + tsc.Close() + } + }() + + decompressedStream, err := archive.DecompressStream(tarStream) + if err != nil { + return nil, err + } + + sum, err := tarsum.NewTarSum(decompressedStream, true, tarsum.Version1) + if err != nil { + return nil, err + } + + if err := chrootarchive.Untar(sum, root, nil); err != nil { + return nil, err + } + + tsc.sums = sum.GetSums() + + return tsc, nil +} + +func (c *tarSumContext) normalize(path string) (cleanpath, fullpath string, err error) { + cleanpath = filepath.Clean(string(os.PathSeparator) + path)[1:] + fullpath, err = symlink.FollowSymlinkInScope(filepath.Join(c.root, path), c.root) + if err != nil { + return "", "", fmt.Errorf("Forbidden path outside the build context: %s (%s)", path, fullpath) + } + _, err = os.Lstat(fullpath) + if err != nil { + return "", "", convertPathError(err, path) + } + return +} + +func (c *tarSumContext) Walk(root string, walkFn WalkFunc) error { + root = filepath.Join(c.root, filepath.Join(string(filepath.Separator), root)) + return filepath.Walk(root, func(fullpath string, info os.FileInfo, err error) error { + rel, err := filepath.Rel(c.root, fullpath) + if err != nil { + return err + } + if rel == "." { + return nil + } + + sum := rel + if tsInfo := c.sums.GetFile(rel); tsInfo != nil { + sum = tsInfo.Sum() + } + fi := &HashedFileInfo{PathFileInfo{FileInfo: info, FilePath: fullpath}, sum} + if err := walkFn(rel, fi, nil); err != nil { + return err + } + return nil + }) +} + +func (c *tarSumContext) Remove(path string) error { + _, fullpath, err := c.normalize(path) + if err != nil { + return err + } + return os.RemoveAll(fullpath) +} diff --git a/builder/words b/builder/words new file mode 100644 index 0000000000..2148f72537 --- /dev/null +++ b/builder/words @@ -0,0 +1,43 @@ +hello | hello +he'll'o | hello +he'llo | hello +he\'llo | he'llo +he\\'llo | he\llo +abc\tdef | abctdef +"abc\tdef" | abc\tdef +'abc\tdef' | abc\tdef +hello\ | hello +hello\\ | hello\ +"hello | hello +"hello\" | hello" +"hel'lo" | hel'lo +'hello | hello +'hello\' | hello\ +"''" | '' +$. | $. +$1 | +he$1x | hex +he$.x | he$.x +he$pwd. | he. +he$PWD | he/home +he\$PWD | he$PWD +he\\$PWD | he\/home +he\${} | he${} +he\${}xx | he${}xx +he${} | he +he${}xx | hexx +he${hi} | he +he${hi}xx | hexx +he${PWD} | he/home +he${.} | error +'he${XX}' | he${XX} +"he${PWD}" | he/home +"he'$PWD'" | he'/home' +"$PWD" | /home +'$PWD' | $PWD +'\$PWD' | \$PWD +'"hello"' | "hello" +he\$PWD | he$PWD +"he\$PWD" | he$PWD +'he\$PWD' | he\$PWD +he${PWD | error diff --git a/cli/cli.go b/cli/cli.go new file mode 100644 index 0000000000..8e559fc3fd --- /dev/null +++ b/cli/cli.go @@ -0,0 +1,200 @@ +package cli + +import ( + "errors" + "fmt" + "io" + "os" + "reflect" + "strings" + + flag "github.com/docker/docker/pkg/mflag" +) + +// Cli represents a command line interface. +type Cli struct { + Stderr io.Writer + handlers []Handler + Usage func() +} + +// Handler holds the different commands Cli will call +// It should have methods with names starting with `Cmd` like: +// func (h myHandler) CmdFoo(args ...string) error +type Handler interface{} + +// Initializer can be optionally implemented by a Handler to +// initialize before each call to one of its commands. +type Initializer interface { + Initialize() error +} + +// New instantiates a ready-to-use Cli. +func New(handlers ...Handler) *Cli { + // make the generic Cli object the first cli handler + // in order to handle `docker help` appropriately + cli := new(Cli) + cli.handlers = append([]Handler{cli}, handlers...) + return cli +} + +// initErr is an error returned upon initialization of a handler implementing Initializer. +type initErr struct{ error } + +func (err initErr) Error() string { + return err.Error() +} + +func (cli *Cli) command(args ...string) (func(...string) error, error) { + for _, c := range cli.handlers { + if c == nil { + continue + } + camelArgs := make([]string, len(args)) + for i, s := range args { + if len(s) == 0 { + return nil, errors.New("empty command") + } + camelArgs[i] = strings.ToUpper(s[:1]) + strings.ToLower(s[1:]) + } + methodName := "Cmd" + strings.Join(camelArgs, "") + method := reflect.ValueOf(c).MethodByName(methodName) + if method.IsValid() { + if c, ok := c.(Initializer); ok { + if err := c.Initialize(); err != nil { + return nil, initErr{err} + } + } + return method.Interface().(func(...string) error), nil + } + } + return nil, errors.New("command not found") +} + +// Run executes the specified command. +func (cli *Cli) Run(args ...string) error { + if len(args) > 1 { + command, err := cli.command(args[:2]...) + switch err := err.(type) { + case nil: + return command(args[2:]...) + case initErr: + return err.error + } + } + if len(args) > 0 { + command, err := cli.command(args[0]) + switch err := err.(type) { + case nil: + return command(args[1:]...) + case initErr: + return err.error + } + cli.noSuchCommand(args[0]) + } + return cli.CmdHelp() +} + +func (cli *Cli) noSuchCommand(command string) { + if cli.Stderr == nil { + cli.Stderr = os.Stderr + } + fmt.Fprintf(cli.Stderr, "docker: '%s' is not a docker command.\nSee 'docker --help'.\n", command) + os.Exit(1) +} + +// CmdHelp displays information on a Docker command. +// +// If more than one command is specified, information is only shown for the first command. +// +// Usage: docker help COMMAND or docker COMMAND --help +func (cli *Cli) CmdHelp(args ...string) error { + if len(args) > 1 { + command, err := cli.command(args[:2]...) + switch err := err.(type) { + case nil: + command("--help") + return nil + case initErr: + return err.error + } + } + if len(args) > 0 { + command, err := cli.command(args[0]) + switch err := err.(type) { + case nil: + command("--help") + return nil + case initErr: + return err.error + } + cli.noSuchCommand(args[0]) + } + + if cli.Usage == nil { + flag.Usage() + } else { + cli.Usage() + } + + return nil +} + +// Subcmd is a subcommand of the main "docker" command. +// A subcommand represents an action that can be performed +// from the Docker command line client. +// +// To see all available subcommands, run "docker --help". +func Subcmd(name string, synopses []string, description string, exitOnError bool) *flag.FlagSet { + var errorHandling flag.ErrorHandling + if exitOnError { + errorHandling = flag.ExitOnError + } else { + errorHandling = flag.ContinueOnError + } + flags := flag.NewFlagSet(name, errorHandling) + flags.Usage = func() { + flags.ShortUsage() + flags.PrintDefaults() + } + + flags.ShortUsage = func() { + options := "" + if flags.FlagCountUndeprecated() > 0 { + options = " [OPTIONS]" + } + + if len(synopses) == 0 { + synopses = []string{""} + } + + // Allow for multiple command usage synopses. + for i, synopsis := range synopses { + lead := "\t" + if i == 0 { + // First line needs the word 'Usage'. + lead = "Usage:\t" + } + + if synopsis != "" { + synopsis = " " + synopsis + } + + fmt.Fprintf(flags.Out(), "\n%sdocker %s%s%s", lead, name, options, synopsis) + } + + fmt.Fprintf(flags.Out(), "\n\n%s\n", description) + } + + return flags +} + +// An StatusError reports an unsuccessful exit by a command. +type StatusError struct { + Status string + StatusCode int +} + +func (e StatusError) Error() string { + return fmt.Sprintf("Status: %s, Code: %d", e.Status, e.StatusCode) +} diff --git a/cli/client.go b/cli/client.go new file mode 100644 index 0000000000..6a82eb52a5 --- /dev/null +++ b/cli/client.go @@ -0,0 +1,12 @@ +package cli + +import flag "github.com/docker/docker/pkg/mflag" + +// ClientFlags represents flags for the docker client. +type ClientFlags struct { + FlagSet *flag.FlagSet + Common *CommonFlags + PostParse func() + + ConfigDir string +} diff --git a/cli/common.go b/cli/common.go new file mode 100644 index 0000000000..c03d9a90e5 --- /dev/null +++ b/cli/common.go @@ -0,0 +1,79 @@ +package cli + +import ( + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/tlsconfig" +) + +// CommonFlags represents flags that are common to both the client and the daemon. +type CommonFlags struct { + FlagSet *flag.FlagSet + PostParse func() + + Debug bool + Hosts []string + LogLevel string + TLS bool + TLSVerify bool + TLSOptions *tlsconfig.Options + TrustKey string +} + +// Command is the struct contains command name and description +type Command struct { + Name string + Description string +} + +var dockerCommands = []Command{ + {"attach", "Attach to a running container"}, + {"build", "Build an image from a Dockerfile"}, + {"commit", "Create a new image from a container's changes"}, + {"cp", "Copy files/folders between a container and the local filesystem"}, + {"create", "Create a new container"}, + {"diff", "Inspect changes on a container's filesystem"}, + {"events", "Get real time events from the server"}, + {"exec", "Run a command in a running container"}, + {"export", "Export a container's filesystem as a tar archive"}, + {"history", "Show the history of an image"}, + {"images", "List images"}, + {"import", "Import the contents from a tarball to create a filesystem image"}, + {"info", "Display system-wide information"}, + {"inspect", "Return low-level information on a container or image"}, + {"kill", "Kill a running container"}, + {"load", "Load an image from a tar archive or STDIN"}, + {"login", "Register or log in to a Docker registry"}, + {"logout", "Log out from a Docker registry"}, + {"logs", "Fetch the logs of a container"}, + {"network", "Manage Docker networks"}, + {"pause", "Pause all processes within a container"}, + {"port", "List port mappings or a specific mapping for the CONTAINER"}, + {"ps", "List containers"}, + {"pull", "Pull an image or a repository from a registry"}, + {"push", "Push an image or a repository to a registry"}, + {"rename", "Rename a container"}, + {"restart", "Restart a container"}, + {"rm", "Remove one or more containers"}, + {"rmi", "Remove one or more images"}, + {"run", "Run a command in a new container"}, + {"save", "Save an image(s) to a tar archive"}, + {"search", "Search the Docker Hub for images"}, + {"start", "Start one or more stopped containers"}, + {"stats", "Display a live stream of container(s) resource usage statistics"}, + {"stop", "Stop a running container"}, + {"tag", "Tag an image into a repository"}, + {"top", "Display the running processes of a container"}, + {"unpause", "Unpause all processes within a container"}, + {"version", "Show the Docker version information"}, + {"volume", "Manage Docker volumes"}, + {"wait", "Block until a container stops, then print its exit code"}, +} + +// DockerCommands stores all the docker command +var DockerCommands = make(map[string]Command) + +func init() { + for _, cmd := range dockerCommands { + DockerCommands[cmd.Name] = cmd + } +} diff --git a/cliconfig/config.go b/cliconfig/config.go new file mode 100644 index 0000000000..4e289a7d40 --- /dev/null +++ b/cliconfig/config.go @@ -0,0 +1,274 @@ +package cliconfig + +import ( + "encoding/base64" + "encoding/json" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "strings" + + "github.com/docker/docker/pkg/homedir" + "github.com/docker/docker/pkg/system" +) + +const ( + // ConfigFileName is the name of config file + ConfigFileName = "config.json" + oldConfigfile = ".dockercfg" + + // This constant is only used for really old config files when the + // URL wasn't saved as part of the config file and it was just + // assumed to be this value. + defaultIndexserver = "https://index.docker.io/v1/" +) + +var ( + configDir = os.Getenv("DOCKER_CONFIG") +) + +func init() { + if configDir == "" { + configDir = filepath.Join(homedir.Get(), ".docker") + } +} + +// ConfigDir returns the directory the configuration file is stored in +func ConfigDir() string { + return configDir +} + +// SetConfigDir sets the directory the configuration file is stored in +func SetConfigDir(dir string) { + configDir = dir +} + +// AuthConfig contains authorization information for connecting to a Registry +type AuthConfig struct { + Username string `json:"username,omitempty"` + Password string `json:"password,omitempty"` + Auth string `json:"auth"` + Email string `json:"email"` + ServerAddress string `json:"serveraddress,omitempty"` +} + +// ConfigFile ~/.docker/config.json file info +type ConfigFile struct { + AuthConfigs map[string]AuthConfig `json:"auths"` + HTTPHeaders map[string]string `json:"HttpHeaders,omitempty"` + PsFormat string `json:"psFormat,omitempty"` + filename string // Note: not serialized - for internal use only +} + +// NewConfigFile initilizes an empty configuration file for the given filename 'fn' +func NewConfigFile(fn string) *ConfigFile { + return &ConfigFile{ + AuthConfigs: make(map[string]AuthConfig), + HTTPHeaders: make(map[string]string), + filename: fn, + } +} + +// LegacyLoadFromReader reads the non-nested configuration data given and sets up the +// auth config information with given directory and populates the receiver object +func (configFile *ConfigFile) LegacyLoadFromReader(configData io.Reader) error { + b, err := ioutil.ReadAll(configData) + if err != nil { + return err + } + + if err := json.Unmarshal(b, &configFile.AuthConfigs); err != nil { + arr := strings.Split(string(b), "\n") + if len(arr) < 2 { + return fmt.Errorf("The Auth config file is empty") + } + authConfig := AuthConfig{} + origAuth := strings.Split(arr[0], " = ") + if len(origAuth) != 2 { + return fmt.Errorf("Invalid Auth config file") + } + authConfig.Username, authConfig.Password, err = DecodeAuth(origAuth[1]) + if err != nil { + return err + } + origEmail := strings.Split(arr[1], " = ") + if len(origEmail) != 2 { + return fmt.Errorf("Invalid Auth config file") + } + authConfig.Email = origEmail[1] + authConfig.ServerAddress = defaultIndexserver + configFile.AuthConfigs[defaultIndexserver] = authConfig + } else { + for k, authConfig := range configFile.AuthConfigs { + authConfig.Username, authConfig.Password, err = DecodeAuth(authConfig.Auth) + if err != nil { + return err + } + authConfig.Auth = "" + authConfig.ServerAddress = k + configFile.AuthConfigs[k] = authConfig + } + } + return nil +} + +// LoadFromReader reads the configuration data given and sets up the auth config +// information with given directory and populates the receiver object +func (configFile *ConfigFile) LoadFromReader(configData io.Reader) error { + if err := json.NewDecoder(configData).Decode(&configFile); err != nil { + return err + } + var err error + for addr, ac := range configFile.AuthConfigs { + ac.Username, ac.Password, err = DecodeAuth(ac.Auth) + if err != nil { + return err + } + ac.Auth = "" + ac.ServerAddress = addr + configFile.AuthConfigs[addr] = ac + } + return nil +} + +// LegacyLoadFromReader is a convenience function that creates a ConfigFile object from +// a non-nested reader +func LegacyLoadFromReader(configData io.Reader) (*ConfigFile, error) { + configFile := ConfigFile{ + AuthConfigs: make(map[string]AuthConfig), + } + err := configFile.LegacyLoadFromReader(configData) + return &configFile, err +} + +// LoadFromReader is a convenience function that creates a ConfigFile object from +// a reader +func LoadFromReader(configData io.Reader) (*ConfigFile, error) { + configFile := ConfigFile{ + AuthConfigs: make(map[string]AuthConfig), + } + err := configFile.LoadFromReader(configData) + return &configFile, err +} + +// Load reads the configuration files in the given directory, and sets up +// the auth config information and return values. +// FIXME: use the internal golang config parser +func Load(configDir string) (*ConfigFile, error) { + if configDir == "" { + configDir = ConfigDir() + } + + configFile := ConfigFile{ + AuthConfigs: make(map[string]AuthConfig), + filename: filepath.Join(configDir, ConfigFileName), + } + + // Try happy path first - latest config file + if _, err := os.Stat(configFile.filename); err == nil { + file, err := os.Open(configFile.filename) + if err != nil { + return &configFile, err + } + defer file.Close() + err = configFile.LoadFromReader(file) + return &configFile, err + } else if !os.IsNotExist(err) { + // if file is there but we can't stat it for any reason other + // than it doesn't exist then stop + return &configFile, err + } + + // Can't find latest config file so check for the old one + confFile := filepath.Join(homedir.Get(), oldConfigfile) + if _, err := os.Stat(confFile); err != nil { + return &configFile, nil //missing file is not an error + } + file, err := os.Open(confFile) + if err != nil { + return &configFile, err + } + defer file.Close() + err = configFile.LegacyLoadFromReader(file) + return &configFile, err +} + +// SaveToWriter encodes and writes out all the authorization information to +// the given writer +func (configFile *ConfigFile) SaveToWriter(writer io.Writer) error { + // Encode sensitive data into a new/temp struct + tmpAuthConfigs := make(map[string]AuthConfig, len(configFile.AuthConfigs)) + for k, authConfig := range configFile.AuthConfigs { + authCopy := authConfig + // encode and save the authstring, while blanking out the original fields + authCopy.Auth = EncodeAuth(&authCopy) + authCopy.Username = "" + authCopy.Password = "" + authCopy.ServerAddress = "" + tmpAuthConfigs[k] = authCopy + } + + saveAuthConfigs := configFile.AuthConfigs + configFile.AuthConfigs = tmpAuthConfigs + defer func() { configFile.AuthConfigs = saveAuthConfigs }() + + data, err := json.MarshalIndent(configFile, "", "\t") + if err != nil { + return err + } + _, err = writer.Write(data) + return err +} + +// Save encodes and writes out all the authorization information +func (configFile *ConfigFile) Save() error { + if configFile.Filename() == "" { + return fmt.Errorf("Can't save config with empty filename") + } + + if err := system.MkdirAll(filepath.Dir(configFile.filename), 0700); err != nil { + return err + } + f, err := os.OpenFile(configFile.filename, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0600) + if err != nil { + return err + } + defer f.Close() + return configFile.SaveToWriter(f) +} + +// Filename returns the name of the configuration file +func (configFile *ConfigFile) Filename() string { + return configFile.filename +} + +// EncodeAuth creates a base64 encoded string to containing authorization information +func EncodeAuth(authConfig *AuthConfig) string { + authStr := authConfig.Username + ":" + authConfig.Password + msg := []byte(authStr) + encoded := make([]byte, base64.StdEncoding.EncodedLen(len(msg))) + base64.StdEncoding.Encode(encoded, msg) + return string(encoded) +} + +// DecodeAuth decodes a base64 encoded string and returns username and password +func DecodeAuth(authStr string) (string, string, error) { + decLen := base64.StdEncoding.DecodedLen(len(authStr)) + decoded := make([]byte, decLen) + authByte := []byte(authStr) + n, err := base64.StdEncoding.Decode(decoded, authByte) + if err != nil { + return "", "", err + } + if n > decLen { + return "", "", fmt.Errorf("Something went wrong decoding auth config") + } + arr := strings.SplitN(string(decoded), ":", 2) + if len(arr) != 2 { + return "", "", fmt.Errorf("Invalid auth configuration file") + } + password := strings.Trim(arr[1], "\x00") + return arr[0], password, nil +} diff --git a/cliconfig/config_test.go b/cliconfig/config_test.go new file mode 100644 index 0000000000..dcf368c552 --- /dev/null +++ b/cliconfig/config_test.go @@ -0,0 +1,458 @@ +package cliconfig + +import ( + "io/ioutil" + "os" + "path/filepath" + "strings" + "testing" + + "github.com/docker/docker/pkg/homedir" +) + +func TestEmptyConfigDir(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + SetConfigDir(tmpHome) + + config, err := Load("") + if err != nil { + t.Fatalf("Failed loading on empty config dir: %q", err) + } + + expectedConfigFilename := filepath.Join(tmpHome, ConfigFileName) + if config.Filename() != expectedConfigFilename { + t.Fatalf("Expected config filename %s, got %s", expectedConfigFilename, config.Filename()) + } + + // Now save it and make sure it shows up in new form + saveConfigAndValidateNewFormat(t, config, tmpHome) +} + +func TestMissingFile(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + config, err := Load(tmpHome) + if err != nil { + t.Fatalf("Failed loading on missing file: %q", err) + } + + // Now save it and make sure it shows up in new form + saveConfigAndValidateNewFormat(t, config, tmpHome) +} + +func TestSaveFileToDirs(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + tmpHome += "/.docker" + + config, err := Load(tmpHome) + if err != nil { + t.Fatalf("Failed loading on missing file: %q", err) + } + + // Now save it and make sure it shows up in new form + saveConfigAndValidateNewFormat(t, config, tmpHome) +} + +func TestEmptyFile(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + fn := filepath.Join(tmpHome, ConfigFileName) + if err := ioutil.WriteFile(fn, []byte(""), 0600); err != nil { + t.Fatal(err) + } + + _, err = Load(tmpHome) + if err == nil { + t.Fatalf("Was supposed to fail") + } +} + +func TestEmptyJson(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + fn := filepath.Join(tmpHome, ConfigFileName) + if err := ioutil.WriteFile(fn, []byte("{}"), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + // Now save it and make sure it shows up in new form + saveConfigAndValidateNewFormat(t, config, tmpHome) +} + +func TestOldInvalidsAuth(t *testing.T) { + invalids := map[string]string{ + `username = test`: "The Auth config file is empty", + `username +password +email`: "Invalid Auth config file", + `username = test +email`: "Invalid auth configuration file", + `username = am9lam9lOmhlbGxv +email`: "Invalid Auth config file", + } + + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + homeKey := homedir.Key() + homeVal := homedir.Get() + + defer func() { os.Setenv(homeKey, homeVal) }() + os.Setenv(homeKey, tmpHome) + + for content, expectedError := range invalids { + fn := filepath.Join(tmpHome, oldConfigfile) + if err := ioutil.WriteFile(fn, []byte(content), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err == nil || err.Error() != expectedError { + t.Fatalf("Should have failed, got: %q, %q", config, err) + } + + } +} + +func TestOldValidAuth(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + homeKey := homedir.Key() + homeVal := homedir.Get() + + defer func() { os.Setenv(homeKey, homeVal) }() + os.Setenv(homeKey, tmpHome) + + fn := filepath.Join(tmpHome, oldConfigfile) + js := `username = am9lam9lOmhlbGxv +email = user@example.com` + if err := ioutil.WriteFile(fn, []byte(js), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err != nil { + t.Fatal(err) + } + + // defaultIndexserver is https://index.docker.io/v1/ + ac := config.AuthConfigs["https://index.docker.io/v1/"] + if ac.Email != "user@example.com" || ac.Username != "joejoe" || ac.Password != "hello" { + t.Fatalf("Missing data from parsing:\n%q", config) + } + + // Now save it and make sure it shows up in new form + configStr := saveConfigAndValidateNewFormat(t, config, tmpHome) + + if !strings.Contains(configStr, "user@example.com") { + t.Fatalf("Should have save in new form: %s", configStr) + } +} + +func TestOldJsonInvalid(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + homeKey := homedir.Key() + homeVal := homedir.Get() + + defer func() { os.Setenv(homeKey, homeVal) }() + os.Setenv(homeKey, tmpHome) + + fn := filepath.Join(tmpHome, oldConfigfile) + js := `{"https://index.docker.io/v1/":{"auth":"test","email":"user@example.com"}}` + if err := ioutil.WriteFile(fn, []byte(js), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err == nil || err.Error() != "Invalid auth configuration file" { + t.Fatalf("Expected an error got : %v, %v", config, err) + } +} + +func TestOldJson(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + homeKey := homedir.Key() + homeVal := homedir.Get() + + defer func() { os.Setenv(homeKey, homeVal) }() + os.Setenv(homeKey, tmpHome) + + fn := filepath.Join(tmpHome, oldConfigfile) + js := `{"https://index.docker.io/v1/":{"auth":"am9lam9lOmhlbGxv","email":"user@example.com"}}` + if err := ioutil.WriteFile(fn, []byte(js), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + ac := config.AuthConfigs["https://index.docker.io/v1/"] + if ac.Email != "user@example.com" || ac.Username != "joejoe" || ac.Password != "hello" { + t.Fatalf("Missing data from parsing:\n%q", config) + } + + // Now save it and make sure it shows up in new form + configStr := saveConfigAndValidateNewFormat(t, config, tmpHome) + + if !strings.Contains(configStr, "user@example.com") { + t.Fatalf("Should have save in new form: %s", configStr) + } +} + +func TestNewJson(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + fn := filepath.Join(tmpHome, ConfigFileName) + js := ` { "auths": { "https://index.docker.io/v1/": { "auth": "am9lam9lOmhlbGxv", "email": "user@example.com" } } }` + if err := ioutil.WriteFile(fn, []byte(js), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + ac := config.AuthConfigs["https://index.docker.io/v1/"] + if ac.Email != "user@example.com" || ac.Username != "joejoe" || ac.Password != "hello" { + t.Fatalf("Missing data from parsing:\n%q", config) + } + + // Now save it and make sure it shows up in new form + configStr := saveConfigAndValidateNewFormat(t, config, tmpHome) + + if !strings.Contains(configStr, "user@example.com") { + t.Fatalf("Should have save in new form: %s", configStr) + } +} + +func TestJsonWithPsFormat(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + fn := filepath.Join(tmpHome, ConfigFileName) + js := `{ + "auths": { "https://index.docker.io/v1/": { "auth": "am9lam9lOmhlbGxv", "email": "user@example.com" } }, + "psFormat": "table {{.ID}}\\t{{.Label \"com.docker.label.cpu\"}}" +}` + if err := ioutil.WriteFile(fn, []byte(js), 0600); err != nil { + t.Fatal(err) + } + + config, err := Load(tmpHome) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + if config.PsFormat != `table {{.ID}}\t{{.Label "com.docker.label.cpu"}}` { + t.Fatalf("Unknown ps format: %s\n", config.PsFormat) + } + + // Now save it and make sure it shows up in new form + configStr := saveConfigAndValidateNewFormat(t, config, tmpHome) + if !strings.Contains(configStr, `"psFormat":`) || + !strings.Contains(configStr, "{{.ID}}") { + t.Fatalf("Should have save in new form: %s", configStr) + } +} + +// Save it and make sure it shows up in new form +func saveConfigAndValidateNewFormat(t *testing.T, config *ConfigFile, homeFolder string) string { + err := config.Save() + if err != nil { + t.Fatalf("Failed to save: %q", err) + } + + buf, err := ioutil.ReadFile(filepath.Join(homeFolder, ConfigFileName)) + if !strings.Contains(string(buf), `"auths":`) { + t.Fatalf("Should have save in new form: %s", string(buf)) + } + return string(buf) +} + +func TestConfigDir(t *testing.T) { + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpHome) + + if ConfigDir() == tmpHome { + t.Fatalf("Expected ConfigDir to be different than %s by default, but was the same", tmpHome) + } + + // Update configDir + SetConfigDir(tmpHome) + + if ConfigDir() != tmpHome { + t.Fatalf("Expected ConfigDir to %s, but was %s", tmpHome, ConfigDir()) + } +} + +func TestConfigFile(t *testing.T) { + configFilename := "configFilename" + configFile := NewConfigFile(configFilename) + + if configFile.Filename() != configFilename { + t.Fatalf("Expected %s, got %s", configFilename, configFile.Filename()) + } +} + +func TestJsonReaderNoFile(t *testing.T) { + js := ` { "auths": { "https://index.docker.io/v1/": { "auth": "am9lam9lOmhlbGxv", "email": "user@example.com" } } }` + + config, err := LoadFromReader(strings.NewReader(js)) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + ac := config.AuthConfigs["https://index.docker.io/v1/"] + if ac.Email != "user@example.com" || ac.Username != "joejoe" || ac.Password != "hello" { + t.Fatalf("Missing data from parsing:\n%q", config) + } + +} + +func TestOldJsonReaderNoFile(t *testing.T) { + js := `{"https://index.docker.io/v1/":{"auth":"am9lam9lOmhlbGxv","email":"user@example.com"}}` + + config, err := LegacyLoadFromReader(strings.NewReader(js)) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + ac := config.AuthConfigs["https://index.docker.io/v1/"] + if ac.Email != "user@example.com" || ac.Username != "joejoe" || ac.Password != "hello" { + t.Fatalf("Missing data from parsing:\n%q", config) + } +} + +func TestJsonWithPsFormatNoFile(t *testing.T) { + js := `{ + "auths": { "https://index.docker.io/v1/": { "auth": "am9lam9lOmhlbGxv", "email": "user@example.com" } }, + "psFormat": "table {{.ID}}\\t{{.Label \"com.docker.label.cpu\"}}" +}` + config, err := LoadFromReader(strings.NewReader(js)) + if err != nil { + t.Fatalf("Failed loading on empty json file: %q", err) + } + + if config.PsFormat != `table {{.ID}}\t{{.Label "com.docker.label.cpu"}}` { + t.Fatalf("Unknown ps format: %s\n", config.PsFormat) + } + +} + +func TestJsonSaveWithNoFile(t *testing.T) { + js := `{ + "auths": { "https://index.docker.io/v1/": { "auth": "am9lam9lOmhlbGxv", "email": "user@example.com" } }, + "psFormat": "table {{.ID}}\\t{{.Label \"com.docker.label.cpu\"}}" +}` + config, err := LoadFromReader(strings.NewReader(js)) + err = config.Save() + if err == nil { + t.Fatalf("Expected error. File should not have been able to save with no file name.") + } + + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatalf("Failed to create a temp dir: %q", err) + } + defer os.RemoveAll(tmpHome) + + fn := filepath.Join(tmpHome, ConfigFileName) + f, _ := os.OpenFile(fn, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0600) + err = config.SaveToWriter(f) + if err != nil { + t.Fatalf("Failed saving to file: %q", err) + } + buf, err := ioutil.ReadFile(filepath.Join(tmpHome, ConfigFileName)) + if !strings.Contains(string(buf), `"auths":`) || + !strings.Contains(string(buf), "user@example.com") { + t.Fatalf("Should have save in new form: %s", string(buf)) + } + +} +func TestLegacyJsonSaveWithNoFile(t *testing.T) { + + js := `{"https://index.docker.io/v1/":{"auth":"am9lam9lOmhlbGxv","email":"user@example.com"}}` + config, err := LegacyLoadFromReader(strings.NewReader(js)) + err = config.Save() + if err == nil { + t.Fatalf("Expected error. File should not have been able to save with no file name.") + } + + tmpHome, err := ioutil.TempDir("", "config-test") + if err != nil { + t.Fatalf("Failed to create a temp dir: %q", err) + } + defer os.RemoveAll(tmpHome) + + fn := filepath.Join(tmpHome, ConfigFileName) + f, _ := os.OpenFile(fn, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0600) + err = config.SaveToWriter(f) + if err != nil { + t.Fatalf("Failed saving to file: %q", err) + } + buf, err := ioutil.ReadFile(filepath.Join(tmpHome, ConfigFileName)) + if !strings.Contains(string(buf), `"auths":`) || + !strings.Contains(string(buf), "user@example.com") { + t.Fatalf("Should have save in new form: %s", string(buf)) + } +} diff --git a/contrib/README b/contrib/README new file mode 100644 index 0000000000..92b1d94433 --- /dev/null +++ b/contrib/README @@ -0,0 +1,4 @@ +The `contrib` directory contains scripts, images, and other helpful things +which are not part of the core docker distribution. Please note that they +could be out of date, since they do not receive the same attention as the +rest of the repository. diff --git a/contrib/REVIEWERS b/contrib/REVIEWERS new file mode 100644 index 0000000000..18e05a3070 --- /dev/null +++ b/contrib/REVIEWERS @@ -0,0 +1 @@ +Tianon Gravi (@tianon) diff --git a/contrib/apparmor/docker-engine b/contrib/apparmor/docker-engine new file mode 100644 index 0000000000..23ac5d6f05 --- /dev/null +++ b/contrib/apparmor/docker-engine @@ -0,0 +1,241 @@ +@{DOCKER_GRAPH_PATH}=/var/lib/docker + +profile /usr/bin/docker (attach_disconnected, complain) { + # Prevent following links to these files during container setup. + deny /etc/** mkl, + deny /dev/** kl, + deny /sys/** mkl, + deny /proc/** mkl, + + mount -> @{DOCKER_GRAPH_PATH}/**, + mount -> /, + mount -> /proc/**, + mount -> /sys/**, + mount -> /run/docker/netns/**, + + umount, + pivot_root, + signal (receive) peer=@{profile_name}, + signal (receive) peer=unconfined, + signal (send), + ipc rw, + network, + capability, + owner /** rw, + @{DOCKER_GRAPH_PATH}/** rwl, + @{DOCKER_GRAPH_PATH}/linkgraph.db k, + @{DOCKER_GRAPH_PATH}/network/files/boltdb.db k, + + # For non-root client use: + /dev/urandom r, + /run/docker.sock rw, + /proc/** r, + /sys/kernel/mm/hugepages/ r, + /etc/localtime r, + /etc/ld.so.cache r, + + ptrace peer=@{profile_name}, + ptrace (read) peer=docker-default, + deny ptrace (trace) peer=docker-default, + deny ptrace peer=/usr/bin/docker///bin/ps, + + /usr/lib/** rm, + /lib/** rm, + + /usr/bin/docker pix, + /sbin/xtables-multi rCx, + /sbin/iptables rCx, + /sbin/modprobe rCx, + /sbin/auplink rCx, + /sbin/mke2fs rCx, + /sbin/tune2fs rCx, + /sbin/blkid rCx, + /bin/kmod rCx, + /usr/bin/xz rCx, + /bin/ps rCx, + /bin/cat rCx, + /sbin/zfs rCx, + /sbin/apparmor_parser rCx, + + # Transitions + change_profile -> docker-*, + change_profile -> unconfined, + + profile /bin/cat (complain) { + /etc/ld.so.cache r, + /lib/** rm, + /dev/null rw, + /proc r, + /bin/cat mr, + + # For reading in 'docker stats': + /proc/[0-9]*/net/dev r, + } + profile /bin/ps (complain) { + /etc/ld.so.cache r, + /etc/localtime r, + /etc/passwd r, + /etc/nsswitch.conf r, + /lib/** rm, + /proc/[0-9]*/** r, + /dev/null rw, + /bin/ps mr, + + # We don't need ptrace so we'll deny and ignore the error. + deny ptrace (read, trace), + + # Quiet dac_override denials + deny capability dac_override, + deny capability dac_read_search, + deny capability sys_ptrace, + + /dev/tty r, + /proc/stat r, + /proc/cpuinfo r, + /proc/meminfo r, + /proc/uptime r, + /sys/devices/system/cpu/online r, + /proc/sys/kernel/pid_max r, + /proc/ r, + /proc/tty/drivers r, + } + profile /sbin/iptables (complain) { + signal (receive) peer=/usr/bin/docker, + capability net_admin, + } + profile /sbin/auplink flags=(attach_disconnected, complain) { + signal (receive) peer=/usr/bin/docker, + capability sys_admin, + capability dac_override, + + @{DOCKER_GRAPH_PATH}/aufs/** rw, + @{DOCKER_GRAPH_PATH}/tmp/** rw, + # For user namespaces: + @{DOCKER_GRAPH_PATH}/[0-9]*.[0-9]*/** rw, + + /sys/fs/aufs/** r, + /lib/** rm, + /apparmor/.null r, + /dev/null rw, + /etc/ld.so.cache r, + /sbin/auplink rm, + /proc/fs/aufs/** rw, + /proc/[0-9]*/mounts rw, + } + profile /sbin/modprobe /bin/kmod (complain) { + signal (receive) peer=/usr/bin/docker, + capability sys_module, + /etc/ld.so.cache r, + /lib/** rm, + /dev/null rw, + /apparmor/.null rw, + /sbin/modprobe rm, + /bin/kmod rm, + /proc/cmdline r, + /sys/module/** r, + /etc/modprobe.d{/,/**} r, + } + # xz works via pipes, so we do not need access to the filesystem. + profile /usr/bin/xz (complain) { + signal (receive) peer=/usr/bin/docker, + /etc/ld.so.cache r, + /lib/** rm, + /usr/bin/xz rm, + deny /proc/** rw, + deny /sys/** rw, + } + profile /sbin/xtables-multi (attach_disconnected, complain) { + /etc/ld.so.cache r, + /lib/** rm, + /sbin/xtables-multi rm, + /apparmor/.null w, + /dev/null rw, + + /proc r, + + capability net_raw, + capability net_admin, + network raw, + } + profile /sbin/zfs (attach_disconnected, complain) { + file, + capability, + } + profile /sbin/mke2fs (complain) { + /sbin/mke2fs rm, + + /lib/** rm, + + /apparmor/.null w, + + /etc/ld.so.cache r, + /etc/mke2fs.conf r, + /etc/mtab r, + + /dev/dm-* rw, + /dev/urandom r, + /dev/null rw, + + /proc/swaps r, + /proc/[0-9]*/mounts r, + } + profile /sbin/tune2fs (complain) { + /sbin/tune2fs rm, + + /lib/** rm, + + /apparmor/.null w, + + /etc/blkid.conf r, + /etc/mtab r, + /etc/ld.so.cache r, + + /dev/null rw, + /dev/.blkid.tab r, + /dev/dm-* rw, + + /proc/swaps r, + /proc/[0-9]*/mounts r, + } + profile /sbin/blkid (complain) { + /sbin/blkid rm, + + /lib/** rm, + /apparmor/.null w, + + /etc/ld.so.cache r, + /etc/blkid.conf r, + + /dev/null rw, + /dev/.blkid.tab rl, + /dev/.blkid.tab* rwl, + /dev/dm-* r, + + /sys/devices/virtual/block/** r, + + capability mknod, + + mount -> @{DOCKER_GRAPH_PATH}/**, + } + profile /sbin/apparmor_parser (complain) { + /sbin/apparmor_parser rm, + + /lib/** rm, + + /etc/ld.so.cache r, + /etc/apparmor/** r, + /etc/apparmor.d/** r, + /etc/apparmor.d/cache/** w, + + /dev/null rw, + + /sys/kernel/security/apparmor/** r, + /sys/kernel/security/apparmor/.replace w, + + /proc/[0-9]*/mounts r, + /proc/sys/kernel/osrelease r, + /proc r, + + capability mac_admin, + } +} diff --git a/contrib/builder/deb/README.md b/contrib/builder/deb/README.md new file mode 100644 index 0000000000..a6fd70dca7 --- /dev/null +++ b/contrib/builder/deb/README.md @@ -0,0 +1,5 @@ +# `dockercore/builder-deb` + +This image's tags contain the dependencies for building Docker `.deb`s for each of the Debian-based platforms Docker targets. + +To add new tags, see [`contrib/builder/deb` in https://github.com/docker/docker](https://github.com/docker/docker/tree/master/contrib/builder/deb), specifically the `generate.sh` script, whose usage is described in a comment at the top of the file. diff --git a/contrib/builder/deb/build.sh b/contrib/builder/deb/build.sh new file mode 100755 index 0000000000..8271d9dc47 --- /dev/null +++ b/contrib/builder/deb/build.sh @@ -0,0 +1,10 @@ +#!/bin/bash +set -e + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" + +set -x +./generate.sh +for d in */; do + docker build -t "dockercore/builder-deb:$(basename "$d")" "$d" +done diff --git a/contrib/builder/deb/debian-jessie/Dockerfile b/contrib/builder/deb/debian-jessie/Dockerfile new file mode 100644 index 0000000000..dc586637bc --- /dev/null +++ b/contrib/builder/deb/debian-jessie/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM debian:jessie + +RUN apt-get update && apt-get install -y bash-completion btrfs-tools build-essential curl ca-certificates debhelper dh-systemd git libapparmor-dev libdevmapper-dev libsqlite3-dev libsystemd-journal-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux diff --git a/contrib/builder/deb/debian-stretch/Dockerfile b/contrib/builder/deb/debian-stretch/Dockerfile new file mode 100644 index 0000000000..9454e99e76 --- /dev/null +++ b/contrib/builder/deb/debian-stretch/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM debian:stretch + +RUN apt-get update && apt-get install -y bash-completion btrfs-tools build-essential curl ca-certificates debhelper dh-systemd git libapparmor-dev libdevmapper-dev libsqlite3-dev libsystemd-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux diff --git a/contrib/builder/deb/debian-wheezy/Dockerfile b/contrib/builder/deb/debian-wheezy/Dockerfile new file mode 100644 index 0000000000..4dd1e0e1bb --- /dev/null +++ b/contrib/builder/deb/debian-wheezy/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM debian:wheezy-backports + +RUN apt-get update && apt-get install -y bash-completion btrfs-tools/wheezy-backports build-essential curl ca-certificates debhelper dh-systemd git libapparmor-dev libdevmapper-dev libsqlite3-dev libsystemd-journal-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux diff --git a/contrib/builder/deb/generate.sh b/contrib/builder/deb/generate.sh new file mode 100755 index 0000000000..bfdace6be9 --- /dev/null +++ b/contrib/builder/deb/generate.sh @@ -0,0 +1,100 @@ +#!/bin/bash +set -e + +# usage: ./generate.sh [versions] +# ie: ./generate.sh +# to update all Dockerfiles in this directory +# or: ./generate.sh debian-jessie +# to only update debian-jessie/Dockerfile +# or: ./generate.sh debian-newversion +# to create a new folder and a Dockerfile within it + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" + +versions=( "$@" ) +if [ ${#versions[@]} -eq 0 ]; then + versions=( */ ) +fi +versions=( "${versions[@]%/}" ) + +for version in "${versions[@]}"; do + distro="${version%-*}" + suite="${version##*-}" + from="${distro}:${suite}" + + case "$from" in + debian:wheezy) + # add -backports, like our users have to + from+='-backports' + ;; + esac + + mkdir -p "$version" + echo "$version -> FROM $from" + cat > "$version/Dockerfile" <<-EOF + # + # THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! + # + + FROM $from + EOF + + echo >> "$version/Dockerfile" + + extraBuildTags= + + # this list is sorted alphabetically; please keep it that way + packages=( + bash-completion # for bash-completion debhelper integration + btrfs-tools # for "btrfs/ioctl.h" (and "version.h" if possible) + build-essential # "essential for building Debian packages" + curl ca-certificates # for downloading Go + debhelper # for easy ".deb" building + dh-systemd # for systemd debhelper integration + git # for "git commit" info in "docker -v" + libapparmor-dev # for "sys/apparmor.h" + libdevmapper-dev # for "libdevmapper.h" + libsqlite3-dev # for "sqlite3.h" + ) + # packaging for "sd-journal.h" and libraries varies + case "$suite" in + precise) ;; + sid|stretch|wily) packages+=( libsystemd-dev );; + *) packages+=( libsystemd-journal-dev );; + esac + + if [ "$suite" = 'precise' ]; then + # precise has a few package issues + + # - dh-systemd doesn't exist at all + packages=( "${packages[@]/dh-systemd}" ) + + # - libdevmapper-dev is missing critical structs (too old) + packages=( "${packages[@]/libdevmapper-dev}" ) + extraBuildTags+=' exclude_graphdriver_devicemapper' + + # - btrfs-tools is missing "ioctl.h" (too old), so it's useless + # (since kernels on precise are old too, just skip btrfs entirely) + packages=( "${packages[@]/btrfs-tools}" ) + extraBuildTags+=' exclude_graphdriver_btrfs' + fi + + if [ "$suite" = 'wheezy' ]; then + # pull btrfs-toold from backports + backports="/$suite-backports" + packages=( "${packages[@]/btrfs-tools/btrfs-tools$backports}" ) + fi + + echo "RUN apt-get update && apt-get install -y ${packages[*]} --no-install-recommends && rm -rf /var/lib/apt/lists/*" >> "$version/Dockerfile" + + echo >> "$version/Dockerfile" + + awk '$1 == "ENV" && $2 == "GO_VERSION" { print; exit }' ../../../Dockerfile >> "$version/Dockerfile" + echo 'RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local' >> "$version/Dockerfile" + echo 'ENV PATH $PATH:/usr/local/go/bin' >> "$version/Dockerfile" + + echo >> "$version/Dockerfile" + + echo 'ENV AUTO_GOPATH 1' >> "$version/Dockerfile" + awk '$1 == "ENV" && $2 == "DOCKER_BUILDTAGS" { print $0 "'"$extraBuildTags"'"; exit }' ../../../Dockerfile >> "$version/Dockerfile" +done diff --git a/contrib/builder/deb/ubuntu-precise/Dockerfile b/contrib/builder/deb/ubuntu-precise/Dockerfile new file mode 100644 index 0000000000..50b4a12e16 --- /dev/null +++ b/contrib/builder/deb/ubuntu-precise/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM ubuntu:precise + +RUN apt-get update && apt-get install -y bash-completion build-essential curl ca-certificates debhelper git libapparmor-dev libsqlite3-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux exclude_graphdriver_devicemapper exclude_graphdriver_btrfs diff --git a/contrib/builder/deb/ubuntu-trusty/Dockerfile b/contrib/builder/deb/ubuntu-trusty/Dockerfile new file mode 100644 index 0000000000..2c85a60a91 --- /dev/null +++ b/contrib/builder/deb/ubuntu-trusty/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM ubuntu:trusty + +RUN apt-get update && apt-get install -y bash-completion btrfs-tools build-essential curl ca-certificates debhelper dh-systemd git libapparmor-dev libdevmapper-dev libsqlite3-dev libsystemd-journal-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux diff --git a/contrib/builder/deb/ubuntu-vivid/Dockerfile b/contrib/builder/deb/ubuntu-vivid/Dockerfile new file mode 100644 index 0000000000..74ceaa4b49 --- /dev/null +++ b/contrib/builder/deb/ubuntu-vivid/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM ubuntu:vivid + +RUN apt-get update && apt-get install -y bash-completion btrfs-tools build-essential curl ca-certificates debhelper dh-systemd git libapparmor-dev libdevmapper-dev libsqlite3-dev libsystemd-journal-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux diff --git a/contrib/builder/deb/ubuntu-wily/Dockerfile b/contrib/builder/deb/ubuntu-wily/Dockerfile new file mode 100644 index 0000000000..b275b07b0c --- /dev/null +++ b/contrib/builder/deb/ubuntu-wily/Dockerfile @@ -0,0 +1,14 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/deb/generate.sh"! +# + +FROM ubuntu:wily + +RUN apt-get update && apt-get install -y bash-completion btrfs-tools build-essential curl ca-certificates debhelper dh-systemd git libapparmor-dev libdevmapper-dev libsqlite3-dev libsystemd-dev --no-install-recommends && rm -rf /var/lib/apt/lists/* + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS apparmor selinux diff --git a/contrib/builder/rpm/README.md b/contrib/builder/rpm/README.md new file mode 100644 index 0000000000..153fbceb6a --- /dev/null +++ b/contrib/builder/rpm/README.md @@ -0,0 +1,5 @@ +# `dockercore/builder-rpm` + +This image's tags contain the dependencies for building Docker `.rpm`s for each of the RPM-based platforms Docker targets. + +To add new tags, see [`contrib/builder/rpm` in https://github.com/docker/docker](https://github.com/docker/docker/tree/master/contrib/builder/rpm), specifically the `generate.sh` script, whose usage is described in a comment at the top of the file. diff --git a/contrib/builder/rpm/build.sh b/contrib/builder/rpm/build.sh new file mode 100755 index 0000000000..558f7ee0db --- /dev/null +++ b/contrib/builder/rpm/build.sh @@ -0,0 +1,10 @@ +#!/bin/bash +set -e + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" + +set -x +./generate.sh +for d in */; do + docker build -t "dockercore/builder-rpm:$(basename "$d")" "$d" +done diff --git a/contrib/builder/rpm/centos-7/Dockerfile b/contrib/builder/rpm/centos-7/Dockerfile new file mode 100644 index 0000000000..64d758cea4 --- /dev/null +++ b/contrib/builder/rpm/centos-7/Dockerfile @@ -0,0 +1,16 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM centos:7 + +RUN yum groupinstall -y "Development Tools" +RUN yum -y swap -- remove systemd-container systemd-container-libs -- install systemd systemd-libs +RUN yum install -y btrfs-progs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/builder/rpm/fedora-21/Dockerfile b/contrib/builder/rpm/fedora-21/Dockerfile new file mode 100644 index 0000000000..338ab4e7ed --- /dev/null +++ b/contrib/builder/rpm/fedora-21/Dockerfile @@ -0,0 +1,15 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM fedora:21 + +RUN yum install -y @development-tools fedora-packager +RUN yum install -y btrfs-progs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/builder/rpm/fedora-22/Dockerfile b/contrib/builder/rpm/fedora-22/Dockerfile new file mode 100644 index 0000000000..2351ae0da8 --- /dev/null +++ b/contrib/builder/rpm/fedora-22/Dockerfile @@ -0,0 +1,15 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM fedora:22 + +RUN yum install -y @development-tools fedora-packager +RUN yum install -y btrfs-progs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/builder/rpm/fedora-23/Dockerfile b/contrib/builder/rpm/fedora-23/Dockerfile new file mode 100644 index 0000000000..3b66ad0f27 --- /dev/null +++ b/contrib/builder/rpm/fedora-23/Dockerfile @@ -0,0 +1,15 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM fedora:23 + +RUN dnf install -y @development-tools fedora-packager +RUN dnf install -y btrfs-progs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.5.1 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/builder/rpm/generate.sh b/contrib/builder/rpm/generate.sh new file mode 100755 index 0000000000..44fd3a98a8 --- /dev/null +++ b/contrib/builder/rpm/generate.sh @@ -0,0 +1,100 @@ +#!/bin/bash +set -e + +# usage: ./generate.sh [versions] +# ie: ./generate.sh +# to update all Dockerfiles in this directory +# or: ./generate.sh +# to only update fedora-20/Dockerfile +# or: ./generate.sh fedora-newversion +# to create a new folder and a Dockerfile within it + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" + +versions=( "$@" ) +if [ ${#versions[@]} -eq 0 ]; then + versions=( */ ) +fi +versions=( "${versions[@]%/}" ) + +for version in "${versions[@]}"; do + distro="${version%-*}" + suite="${version##*-}" + from="${distro}:${suite}" + + mkdir -p "$version" + echo "$version -> FROM $from" + cat > "$version/Dockerfile" <<-EOF + # + # THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! + # + + FROM $from + EOF + + echo >> "$version/Dockerfile" + + case "$from" in + centos:*) + # get "Development Tools" packages dependencies + echo 'RUN yum groupinstall -y "Development Tools"' >> "$version/Dockerfile" + + if [[ "$version" == "centos-7" ]]; then + echo 'RUN yum -y swap -- remove systemd-container systemd-container-libs -- install systemd systemd-libs' >> "$version/Dockerfile" + fi + ;; + oraclelinux:*) + # get "Development Tools" packages and dependencies + echo 'RUN yum groupinstall -y "Development Tools"' >> "$version/Dockerfile" + ;; + opensuse:*) + # get rpm-build and curl packages and dependencies + echo 'RUN zypper --non-interactive install ca-certificates* curl gzip rpm-build' >> "$version/Dockerfile" + ;; + *) + echo 'RUN yum install -y @development-tools fedora-packager' >> "$version/Dockerfile" + ;; + esac + + # this list is sorted alphabetically; please keep it that way + packages=( + btrfs-progs-devel # for "btrfs/ioctl.h" (and "version.h" if possible) + device-mapper-devel # for "libdevmapper.h" + glibc-static + libselinux-devel # for "libselinux.so" + selinux-policy + selinux-policy-devel + sqlite-devel # for "sqlite3.h" + tar # older versions of dev-tools do not have tar + ) + + case "$from" in + oraclelinux:7) + # Enable the optional repository + packages=( --enablerepo=ol7_optional_latest "${packages[*]}" ) + ;; + esac + + case "$from" in + opensuse:*) + packages=( "${packages[@]/btrfs-progs-devel/libbtrfs-devel}" ) + # use zypper + echo "RUN zypper --non-interactive install ${packages[*]}" >> "$version/Dockerfile" + ;; + *) + echo "RUN yum install -y ${packages[*]}" >> "$version/Dockerfile" + ;; + esac + + echo >> "$version/Dockerfile" + + awk '$1 == "ENV" && $2 == "GO_VERSION" { print; exit }' ../../../Dockerfile >> "$version/Dockerfile" + echo 'RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local' >> "$version/Dockerfile" + echo 'ENV PATH $PATH:/usr/local/go/bin' >> "$version/Dockerfile" + + echo >> "$version/Dockerfile" + + echo 'ENV AUTO_GOPATH 1' >> "$version/Dockerfile" + + echo 'ENV DOCKER_BUILDTAGS selinux' >> "$version/Dockerfile" +done diff --git a/contrib/builder/rpm/opensuse-13.2/Dockerfile b/contrib/builder/rpm/opensuse-13.2/Dockerfile new file mode 100644 index 0000000000..701c929158 --- /dev/null +++ b/contrib/builder/rpm/opensuse-13.2/Dockerfile @@ -0,0 +1,15 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM opensuse:13.2 + +RUN zypper --non-interactive install ca-certificates* curl gzip rpm-build +RUN zypper --non-interactive install libbtrfs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/builder/rpm/oraclelinux-6/Dockerfile b/contrib/builder/rpm/oraclelinux-6/Dockerfile new file mode 100644 index 0000000000..2a97ae7735 --- /dev/null +++ b/contrib/builder/rpm/oraclelinux-6/Dockerfile @@ -0,0 +1,15 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM oraclelinux:6 + +RUN yum groupinstall -y "Development Tools" +RUN yum install -y btrfs-progs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/builder/rpm/oraclelinux-7/Dockerfile b/contrib/builder/rpm/oraclelinux-7/Dockerfile new file mode 100644 index 0000000000..60e0cf1c1b --- /dev/null +++ b/contrib/builder/rpm/oraclelinux-7/Dockerfile @@ -0,0 +1,15 @@ +# +# THIS FILE IS AUTOGENERATED; SEE "contrib/builder/rpm/generate.sh"! +# + +FROM oraclelinux:7 + +RUN yum groupinstall -y "Development Tools" +RUN yum install -y --enablerepo=ol7_optional_latest btrfs-progs-devel device-mapper-devel glibc-static libselinux-devel selinux-policy selinux-policy-devel sqlite-devel tar + +ENV GO_VERSION 1.4.2 +RUN curl -fSL "https://storage.googleapis.com/golang/go${GO_VERSION}.linux-amd64.tar.gz" | tar xzC /usr/local +ENV PATH $PATH:/usr/local/go/bin + +ENV AUTO_GOPATH 1 +ENV DOCKER_BUILDTAGS selinux diff --git a/contrib/check-config.sh b/contrib/check-config.sh new file mode 100755 index 0000000000..55ce8266e0 --- /dev/null +++ b/contrib/check-config.sh @@ -0,0 +1,245 @@ +#!/usr/bin/env bash +set -e + +# bits of this were adapted from lxc-checkconfig +# see also https://github.com/lxc/lxc/blob/lxc-1.0.2/src/lxc/lxc-checkconfig.in + +possibleConfigs=( + '/proc/config.gz' + "/boot/config-$(uname -r)" + "/usr/src/linux-$(uname -r)/.config" + '/usr/src/linux/.config' +) + +if [ $# -gt 0 ]; then + CONFIG="$1" +else + : ${CONFIG:="${possibleConfigs[0]}"} +fi + +if ! command -v zgrep &> /dev/null; then + zgrep() { + zcat "$2" | grep "$1" + } +fi + +kernelVersion="$(uname -r)" +kernelMajor="${kernelVersion%%.*}" +kernelMinor="${kernelVersion#$kernelMajor.}" +kernelMinor="${kernelMinor%%.*}" + +is_set() { + zgrep "CONFIG_$1=[y|m]" "$CONFIG" > /dev/null +} +is_set_in_kernel() { + zgrep "CONFIG_$1=y" "$CONFIG" > /dev/null +} +is_set_as_module() { + zgrep "CONFIG_$1=m" "$CONFIG" > /dev/null +} + +# see https://en.wikipedia.org/wiki/ANSI_escape_code#Colors +declare -A colors=( + [black]=30 + [red]=31 + [green]=32 + [yellow]=33 + [blue]=34 + [magenta]=35 + [cyan]=36 + [white]=37 +) +color() { + color=() + if [ "$1" = 'bold' ]; then + color+=( '1' ) + shift + fi + if [ $# -gt 0 ] && [ "${colors[$1]}" ]; then + color+=( "${colors[$1]}" ) + fi + local IFS=';' + echo -en '\033['"${color[*]}"m +} +wrap_color() { + text="$1" + shift + color "$@" + echo -n "$text" + color reset + echo +} + +wrap_good() { + echo "$(wrap_color "$1" white): $(wrap_color "$2" green)" +} +wrap_bad() { + echo "$(wrap_color "$1" bold): $(wrap_color "$2" bold red)" +} +wrap_warning() { + wrap_color >&2 "$*" red +} + +check_flag() { + if is_set_in_kernel "$1"; then + wrap_good "CONFIG_$1" 'enabled' + elif is_set_as_module "$1"; then + wrap_good "CONFIG_$1" 'enabled (as module)' + else + wrap_bad "CONFIG_$1" 'missing' + fi +} + +check_flags() { + for flag in "$@"; do + echo "- $(check_flag "$flag")" + done +} + +check_command() { + if command -v "$1" >/dev/null 2>&1; then + wrap_good "$1 command" 'available' + else + wrap_bad "$1 command" 'missing' + fi +} + +check_device() { + if [ -c "$1" ]; then + wrap_good "$1" 'present' + else + wrap_bad "$1" 'missing' + fi +} + +if [ ! -e "$CONFIG" ]; then + wrap_warning "warning: $CONFIG does not exist, searching other paths for kernel config ..." + for tryConfig in "${possibleConfigs[@]}"; do + if [ -e "$tryConfig" ]; then + CONFIG="$tryConfig" + break + fi + done + if [ ! -e "$CONFIG" ]; then + wrap_warning "error: cannot find kernel config" + wrap_warning " try running this script again, specifying the kernel config:" + wrap_warning " CONFIG=/path/to/kernel/.config $0 or $0 /path/to/kernel/.config" + exit 1 + fi +fi + +wrap_color "info: reading kernel config from $CONFIG ..." white +echo + +echo 'Generally Necessary:' + +echo -n '- ' +cgroupSubsystemDir="$(awk '/[, ](cpu|cpuacct|cpuset|devices|freezer|memory)[, ]/ && $3 == "cgroup" { print $2 }' /proc/mounts | head -n1)" +cgroupDir="$(dirname "$cgroupSubsystemDir")" +if [ -d "$cgroupDir/cpu" -o -d "$cgroupDir/cpuacct" -o -d "$cgroupDir/cpuset" -o -d "$cgroupDir/devices" -o -d "$cgroupDir/freezer" -o -d "$cgroupDir/memory" ]; then + echo "$(wrap_good 'cgroup hierarchy' 'properly mounted') [$cgroupDir]" +else + if [ "$cgroupSubsystemDir" ]; then + echo "$(wrap_bad 'cgroup hierarchy' 'single mountpoint!') [$cgroupSubsystemDir]" + else + echo "$(wrap_bad 'cgroup hierarchy' 'nonexistent??')" + fi + echo " $(wrap_color '(see https://github.com/tianon/cgroupfs-mount)' yellow)" +fi + +if [ "$(cat /sys/module/apparmor/parameters/enabled 2>/dev/null)" = 'Y' ]; then + echo -n '- ' + if command -v apparmor_parser &> /dev/null; then + echo "$(wrap_good 'apparmor' 'enabled and tools installed')" + else + echo "$(wrap_bad 'apparmor' 'enabled, but apparmor_parser missing')" + echo -n ' ' + if command -v apt-get &> /dev/null; then + echo "$(wrap_color '(use "apt-get install apparmor" to fix this)')" + elif command -v yum &> /dev/null; then + echo "$(wrap_color '(your best bet is "yum install apparmor-parser")')" + else + echo "$(wrap_color '(look for an "apparmor" package for your distribution)')" + fi + fi +fi + +flags=( + NAMESPACES {NET,PID,IPC,UTS}_NS + DEVPTS_MULTIPLE_INSTANCES + CGROUPS CGROUP_CPUACCT CGROUP_DEVICE CGROUP_FREEZER CGROUP_SCHED CPUSETS MEMCG + MACVLAN VETH BRIDGE BRIDGE_NETFILTER + NF_NAT_IPV4 IP_NF_FILTER IP_NF_TARGET_MASQUERADE + NETFILTER_XT_MATCH_{ADDRTYPE,CONNTRACK} + NF_NAT NF_NAT_NEEDED + + # required for bind-mounting /dev/mqueue into containers + POSIX_MQUEUE +) +check_flags "${flags[@]}" +echo + +echo 'Optional Features:' +{ + check_flags USER_NS +} +{ + check_flags MEMCG_KMEM MEMCG_SWAP MEMCG_SWAP_ENABLED + if is_set MEMCG_SWAP && ! is_set MEMCG_SWAP_ENABLED; then + echo " $(wrap_color '(note that cgroup swap accounting is not enabled in your kernel config, you can enable it by setting boot option "swapaccount=1")' bold black)" + fi +} + +if [ "$kernelMajor" -lt 3 ] || [ "$kernelMajor" -eq 3 -a "$kernelMinor" -le 18 ]; then + check_flags RESOURCE_COUNTERS +fi + +if [ "$kernelMajor" -lt 3 ] || [ "$kernelMajor" -eq 3 -a "$kernelMinor" -le 13 ]; then + netprio=NETPRIO_CGROUP +else + netprio=CGROUP_NET_PRIO +fi + +flags=( + BLK_CGROUP IOSCHED_CFQ BLK_DEV_THROTTLING + CGROUP_PERF + CGROUP_HUGETLB + NET_CLS_CGROUP $netprio + CFS_BANDWIDTH FAIR_GROUP_SCHED RT_GROUP_SCHED +) +check_flags "${flags[@]}" + +check_flags EXT3_FS EXT3_FS_XATTR EXT3_FS_POSIX_ACL EXT3_FS_SECURITY +if ! is_set EXT3_FS || ! is_set EXT3_FS_XATTR || ! is_set EXT3_FS_POSIX_ACL || ! is_set EXT3_FS_SECURITY; then + echo " $(wrap_color '(enable these ext3 configs if you are using ext3 as backing filesystem)' bold black)" +fi + +check_flags EXT4_FS EXT4_FS_POSIX_ACL EXT4_FS_SECURITY +if ! is_set EXT4_FS || ! is_set EXT4_FS_POSIX_ACL || ! is_set EXT4_FS_SECURITY; then + echo " $(wrap_color 'enable these ext4 configs if you are using ext4 as backing filesystem' bold black)" +fi + +echo '- Storage Drivers:' +{ + echo '- "'$(wrap_color 'aufs' blue)'":' + check_flags AUFS_FS | sed 's/^/ /' + if ! is_set AUFS_FS && grep -q aufs /proc/filesystems; then + echo " $(wrap_color '(note that some kernels include AUFS patches but not the AUFS_FS flag)' bold black)" + fi + + echo '- "'$(wrap_color 'btrfs' blue)'":' + check_flags BTRFS_FS | sed 's/^/ /' + + echo '- "'$(wrap_color 'devicemapper' blue)'":' + check_flags BLK_DEV_DM DM_THIN_PROVISIONING | sed 's/^/ /' + + echo '- "'$(wrap_color 'overlay' blue)'":' + check_flags OVERLAY_FS | sed 's/^/ /' + + echo '- "'$(wrap_color 'zfs' blue)'":' + echo " - $(check_device /dev/zfs)" + echo " - $(check_command zfs)" + echo " - $(check_command zpool)" +} | sed 's/^/ /' +echo + diff --git a/contrib/completion/REVIEWERS b/contrib/completion/REVIEWERS new file mode 100644 index 0000000000..03ee2dde3d --- /dev/null +++ b/contrib/completion/REVIEWERS @@ -0,0 +1,2 @@ +Tianon Gravi (@tianon) +Jessie Frazelle (@jfrazelle) diff --git a/contrib/completion/bash/docker b/contrib/completion/bash/docker new file mode 100644 index 0000000000..867d4ee200 --- /dev/null +++ b/contrib/completion/bash/docker @@ -0,0 +1,1881 @@ +#!/bin/bash +# +# bash completion file for core docker commands +# +# This script provides completion of: +# - commands and their options +# - container ids and names +# - image repos and tags +# - filepaths +# +# To enable the completions either: +# - place this file in /etc/bash_completion.d +# or +# - copy this file to e.g. ~/.docker-completion.sh and add the line +# below to your .bashrc after bash completion features are loaded +# . ~/.docker-completion.sh +# +# Configuration: +# +# You can tailor completion for the "events", "history", "inspect", "run", +# "rmi" and "save" commands by settings the following environment +# variables: +# +# DOCKER_COMPLETION_SHOW_IMAGE_IDS +# "none" - Show names only (default) +# "non-intermediate" - Show names and ids, but omit intermediate image IDs +# "all" - Show names and ids, including intermediate image IDs +# +# DOCKER_COMPLETION_SHOW_TAGS +# "yes" - include tags in completion options (default) +# "no" - don't include tags in completion options + +# +# Note: +# Currently, the completions will not work if the docker daemon is not +# bound to the default communication port/socket +# If the docker daemon is using a unix socket for communication your user +# must have access to the socket for the completions to function correctly +# +# Note for developers: +# Please arrange options sorted alphabetically by long name with the short +# options immediately following their corresponding long form. +# This order should be applied to lists, alternatives and code blocks. + +__docker_previous_extglob_setting=$(shopt -p extglob) +shopt -s extglob + +__docker_q() { + docker ${host:+-H "$host"} ${config:+--config "$config"} 2>/dev/null "$@" +} + +__docker_containers_all() { + local IFS=$'\n' + local containers=( $(__docker_q ps -aq --no-trunc) ) + if [ "$1" ]; then + containers=( $(__docker_q inspect --format "{{if $1}}{{.Id}}{{end}}" "${containers[@]}") ) + fi + local names=( $(__docker_q inspect --format '{{.Name}}' "${containers[@]}") ) + names=( "${names[@]#/}" ) # trim off the leading "/" from the container names + unset IFS + COMPREPLY=( $(compgen -W "${names[*]} ${containers[*]}" -- "$cur") ) +} + +__docker_containers_running() { + __docker_containers_all '.State.Running' +} + +__docker_containers_stopped() { + __docker_containers_all 'not .State.Running' +} + +__docker_containers_pauseable() { + __docker_containers_all 'and .State.Running (not .State.Paused)' +} + +__docker_containers_unpauseable() { + __docker_containers_all '.State.Paused' +} + +__docker_container_names() { + local containers=( $(__docker_q ps -aq --no-trunc) ) + local names=( $(__docker_q inspect --format '{{.Name}}' "${containers[@]}") ) + names=( "${names[@]#/}" ) # trim off the leading "/" from the container names + COMPREPLY=( $(compgen -W "${names[*]}" -- "$cur") ) +} + +__docker_container_ids() { + local containers=( $(__docker_q ps -aq) ) + COMPREPLY=( $(compgen -W "${containers[*]}" -- "$cur") ) +} + +__docker_images() { + local images_args="" + + case "$DOCKER_COMPLETION_SHOW_IMAGE_IDS" in + all) + images_args="--no-trunc -a" + ;; + non-intermediate) + images_args="--no-trunc" + ;; + esac + + local repo_print_command + if [ "${DOCKER_COMPLETION_SHOW_TAGS:-yes}" = "yes" ]; then + repo_print_command='print $1; print $1":"$2' + else + repo_print_command='print $1' + fi + + local awk_script + case "$DOCKER_COMPLETION_SHOW_IMAGE_IDS" in + all|non-intermediate) + awk_script='NR>1 { print $3; if ($1 != "") { '"$repo_print_command"' } }' + ;; + none|*) + awk_script='NR>1 && $1 != "" { '"$repo_print_command"' }' + ;; + esac + + local images=$(__docker_q images $images_args | awk "$awk_script") + COMPREPLY=( $(compgen -W "$images" -- "$cur") ) + __ltrim_colon_completions "$cur" +} + +__docker_image_repos() { + local repos="$(__docker_q images | awk 'NR>1 && $1 != "" { print $1 }')" + COMPREPLY=( $(compgen -W "$repos" -- "$cur") ) +} + +__docker_image_repos_and_tags() { + local reposAndTags="$(__docker_q images | awk 'NR>1 && $1 != "" { print $1; print $1":"$2 }')" + COMPREPLY=( $(compgen -W "$reposAndTags" -- "$cur") ) + __ltrim_colon_completions "$cur" +} + +__docker_containers_and_images() { + __docker_containers_all + local containers=( "${COMPREPLY[@]}" ) + __docker_images + COMPREPLY+=( "${containers[@]}" ) +} + +__docker_networks() { + COMPREPLY=( $(compgen -W "$(__docker_q network ls | awk 'NR>1 {print $2}')" -- "$cur") ) +} + +__docker_volumes() { + COMPREPLY=( $(compgen -W "$(__docker_q volume ls -q)" -- "$cur") ) +} + +# Finds the position of the first word that is neither option nor an option's argument. +# If there are options that require arguments, you should pass a glob describing those +# options, e.g. "--option1|-o|--option2" +# Use this function to restrict completions to exact positions after the argument list. +__docker_pos_first_nonflag() { + local argument_flags=$1 + + local counter=$((${subcommand_pos:-${command_pos}} + 1)) + while [ $counter -le $cword ]; do + if [ -n "$argument_flags" ] && eval "case '${words[$counter]}' in $argument_flags) true ;; *) false ;; esac"; then + (( counter++ )) + # eat "=" in case of --option=arg syntax + [ "${words[$counter]}" = "=" ] && (( counter++ )) + else + case "${words[$counter]}" in + -*) + ;; + *) + break + ;; + esac + fi + + # Bash splits words at "=", retaining "=" as a word, examples: + # "--debug=false" => 3 words, "--log-opt syslog-facility=daemon" => 4 words + while [ "${words[$counter + 1]}" = "=" ] ; do + counter=$(( counter + 2)) + done + + (( counter++ )) + done + + echo $counter +} + +# Returns the value of the first option matching option_glob. +# Valid values for option_glob are option names like '--log-level' and +# globs like '--log-level|-l' +# Only positions between the command and the current word are considered. +__docker_value_of_option() { + local option_extglob=$(__docker_to_extglob "$1") + + local counter=$((command_pos + 1)) + while [ $counter -lt $cword ]; do + case ${words[$counter]} in + $option_extglob ) + echo ${words[$counter + 1]} + break + ;; + esac + (( counter++ )) + done +} + +# Transforms a multiline list of strings into a single line string +# with the words separated by "|". +# This is used to prepare arguments to __docker_pos_first_nonflag(). +__docker_to_alternatives() { + local parts=( $1 ) + local IFS='|' + echo "${parts[*]}" +} + +# Transforms a multiline list of options into an extglob pattern +# suitable for use in case statements. +__docker_to_extglob() { + local extglob=$( __docker_to_alternatives "$1" ) + echo "@($extglob)" +} + +# Subcommand processing. +# Locates the first occurrence of any of the subcommands contained in the +# first argument. In case of a match, calls the corresponding completion +# function and returns 0. +# If no match is found, 1 is returned. The calling function can then +# continue processing its completion. +# +# TODO if the preceding command has options that accept arguments and an +# argument is equal ot one of the subcommands, this is falsely detected as +# a match. +__docker_subcommands() { + local subcommands="$1" + + local counter=$(($command_pos + 1)) + while [ $counter -lt $cword ]; do + case "${words[$counter]}" in + $(__docker_to_extglob "$subcommands") ) + subcommand_pos=$counter + local subcommand=${words[$counter]} + local completions_func=_docker_${command}_${subcommand} + declare -F $completions_func >/dev/null && $completions_func + return 0 + ;; + esac + (( counter++ )) + done + return 1 +} + +# suppress trailing whitespace +__docker_nospace() { + # compopt is not available in ancient bash versions + type compopt &>/dev/null && compopt -o nospace +} + +__docker_resolve_hostname() { + command -v host >/dev/null 2>&1 || return + COMPREPLY=( $(host 2>/dev/null "${cur%:}" | awk '/has address/ {print $4}') ) +} + +__docker_capabilities() { + # The list of capabilities is defined in types.go, ALL was added manually. + COMPREPLY=( $( compgen -W " + ALL + AUDIT_CONTROL + AUDIT_WRITE + AUDIT_READ + BLOCK_SUSPEND + CHOWN + DAC_OVERRIDE + DAC_READ_SEARCH + FOWNER + FSETID + IPC_LOCK + IPC_OWNER + KILL + LEASE + LINUX_IMMUTABLE + MAC_ADMIN + MAC_OVERRIDE + MKNOD + NET_ADMIN + NET_BIND_SERVICE + NET_BROADCAST + NET_RAW + SETFCAP + SETGID + SETPCAP + SETUID + SYS_ADMIN + SYS_BOOT + SYS_CHROOT + SYSLOG + SYS_MODULE + SYS_NICE + SYS_PACCT + SYS_PTRACE + SYS_RAWIO + SYS_RESOURCE + SYS_TIME + SYS_TTY_CONFIG + WAKE_ALARM + " -- "$cur" ) ) +} + +__docker_log_drivers() { + COMPREPLY=( $( compgen -W " + awslogs + fluentd + gelf + journald + json-file + none + syslog + " -- "$cur" ) ) +} + +__docker_log_driver_options() { + # see docs/reference/logging/index.md + local awslogs_options="awslogs-region awslogs-group awslogs-stream" + local fluentd_options="env fluentd-address labels tag" + local gelf_options="env gelf-address labels tag" + local journald_options="env labels" + local json_file_options="env labels max-file max-size" + local syslog_options="syslog-address syslog-facility tag" + + local all_options="$fluentd_options $gelf_options $journald_options $json_file_options $syslog_options" + + case $(__docker_value_of_option --log-driver) in + '') + COMPREPLY=( $( compgen -W "$all_options" -S = -- "$cur" ) ) + ;; + awslogs) + COMPREPLY=( $( compgen -W "$awslogs_options" -S = -- "$cur" ) ) + ;; + fluentd) + COMPREPLY=( $( compgen -W "$fluentd_options" -S = -- "$cur" ) ) + ;; + gelf) + COMPREPLY=( $( compgen -W "$gelf_options" -S = -- "$cur" ) ) + ;; + journald) + COMPREPLY=( $( compgen -W "$journald_options" -S = -- "$cur" ) ) + ;; + json-file) + COMPREPLY=( $( compgen -W "$json_file_options" -S = -- "$cur" ) ) + ;; + syslog) + COMPREPLY=( $( compgen -W "$syslog_options" -S = -- "$cur" ) ) + ;; + *) + return + ;; + esac + + __docker_nospace +} + +__docker_complete_log_driver_options() { + # "=" gets parsed to a word and assigned to either $cur or $prev depending on whether + # it is the last character or not. So we search for "xxx=" in the the last two words. + case "${words[$cword-2]}$prev=" in + *gelf-address=*) + COMPREPLY=( $( compgen -W "udp" -S "://" -- "${cur#=}" ) ) + __docker_nospace + return + ;; + *syslog-address=*) + COMPREPLY=( $( compgen -W "tcp udp unix" -S "://" -- "${cur#=}" ) ) + __docker_nospace + return + ;; + *syslog-facility=*) + COMPREPLY=( $( compgen -W " + auth + authpriv + cron + daemon + ftp + kern + local0 + local1 + local2 + local3 + local4 + local5 + local6 + local7 + lpr + mail + news + syslog + user + uucp + " -- "${cur#=}" ) ) + return + ;; + esac + return 1 +} + +__docker_log_levels() { + COMPREPLY=( $( compgen -W "debug info warn error fatal" -- "$cur" ) ) +} + +# a selection of the available signals that is most likely of interest in the +# context of docker containers. +__docker_signals() { + local signals=( + SIGCONT + SIGHUP + SIGINT + SIGKILL + SIGQUIT + SIGSTOP + SIGTERM + SIGUSR1 + SIGUSR2 + ) + COMPREPLY=( $( compgen -W "${signals[*]} ${signals[*]#SIG}" -- "$( echo $cur | tr '[:lower:]' '[:upper:]')" ) ) +} + +# global options that may appear after the docker command +_docker_docker() { + local boolean_options=" + $global_boolean_options + --help + --version -v + " + + case "$prev" in + --config) + _filedir -d + return + ;; + --log-level|-l) + __docker_log_levels + return + ;; + $(__docker_to_extglob "$global_options_with_args") ) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "$boolean_options $global_options_with_args" -- "$cur" ) ) + ;; + *) + local counter=$( __docker_pos_first_nonflag $(__docker_to_extglob "$global_options_with_args") ) + if [ $cword -eq $counter ]; then + COMPREPLY=( $( compgen -W "${commands[*]} help" -- "$cur" ) ) + fi + ;; + esac +} + +_docker_attach() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --no-stdin --sig-proxy" -- "$cur" ) ) + ;; + *) + local counter="$(__docker_pos_first_nonflag)" + if [ $cword -eq $counter ]; then + __docker_containers_running + fi + ;; + esac +} + +_docker_build() { + local options_with_args=" + --build-arg + --cgroup-parent + --cpuset-cpus + --cpuset-mems + --cpu-shares + --cpu-period + --cpu-quota + --file -f + --memory -m + --memory-swap + --tag -t + --ulimit + " + + local boolean_options=" + --disable-content-trust=false + --force-rm + --help + --no-cache + --pull + --quiet -q + --rm + " + + local all_options="$options_with_args $boolean_options" + + case "$prev" in + --build-arg) + COMPREPLY=( $( compgen -e -- "$cur" ) ) + __docker_nospace + return + ;; + --file|-f) + _filedir + return + ;; + --tag|-t) + __docker_image_repos_and_tags + return + ;; + $(__docker_to_extglob "$options_with_args") ) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "$all_options" -- "$cur" ) ) + ;; + *) + local counter=$( __docker_pos_first_nonflag $( __docker_to_alternatives "$options_with_args" ) ) + if [ $cword -eq $counter ]; then + _filedir -d + fi + ;; + esac +} + +_docker_commit() { + case "$prev" in + --author|-a|--change|-c|--message|-m) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--author -a --change -c --help --message -m --pause -p" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag '--author|-a|--change|-c|--message|-m') + + if [ $cword -eq $counter ]; then + __docker_containers_all + return + fi + (( counter++ )) + + if [ $cword -eq $counter ]; then + __docker_image_repos_and_tags + return + fi + ;; + esac +} + +_docker_cp() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + case "$cur" in + *:) + return + ;; + *) + # combined container and filename completion + _filedir + local files=( ${COMPREPLY[@]} ) + + __docker_containers_all + COMPREPLY=( $( compgen -W "${COMPREPLY[*]}" -S ':' ) ) + local containers=( ${COMPREPLY[@]} ) + + COMPREPLY=( $( compgen -W "${files[*]} ${containers[*]}" -- "$cur" ) ) + if [[ "$COMPREPLY" == *: ]]; then + __docker_nospace + fi + return + ;; + esac + fi + (( counter++ )) + + if [ $cword -eq $counter ]; then + if [ -e "$prev" ]; then + __docker_containers_all + COMPREPLY=( $( compgen -W "${COMPREPLY[*]}" -S ':' ) ) + __docker_nospace + else + _filedir + fi + return + fi + ;; + esac +} + +_docker_create() { + _docker_run +} + +_docker_daemon() { + local boolean_options=" + $global_boolean_options + --disable-legacy-registry + --help + --icc=false + --ip-forward=false + --ip-masq=false + --iptables=false + --ipv6 + --selinux-enabled + --userland-proxy=false + " + local options_with_args=" + $global_options_with_args + --api-cors-header + --bip + --bridge -b + --cluster-advertise + --cluster-store + --cluster-store-opt + --default-gateway + --default-gateway-v6 + --default-ulimit + --dns + --dns-search + --dns-opt + --exec-driver -e + --exec-opt + --exec-root + --fixed-cidr + --fixed-cidr-v6 + --graph -g + --group -G + --insecure-registry + --ip + --label + --log-driver + --log-opt + --mtu + --pidfile -p + --registry-mirror + --storage-driver -s + --storage-opt + " + + case "$prev" in + --cluster-store) + COMPREPLY=( $( compgen -W "consul etcd zk" -S "://" -- "$cur" ) ) + __docker_nospace + return + ;; + --cluster-store-opt) + COMPREPLY=( $( compgen -W "kv.cacertfile kv.certfile kv.keyfile" -S = -- "$cur" ) ) + __docker_nospace + return + ;; + --exec-root|--graph|-g) + _filedir -d + return + ;; + --log-driver) + __docker_log_drivers + return + ;; + --pidfile|-p|--tlscacert|--tlscert|--tlskey) + _filedir + return + ;; + --storage-driver|-s) + COMPREPLY=( $( compgen -W "aufs btrfs devicemapper overlay vfs zfs" -- "$(echo $cur | tr '[:upper:]' '[:lower:]')" ) ) + return + ;; + --storage-opt) + local devicemapper_options=" + dm.basesize + dm.blkdiscard + dm.blocksize + dm.fs + dm.loopdatasize + dm.loopmetadatasize + dm.mkfsarg + dm.mountopt + dm.override_udev_sync_check + dm.thinpooldev + dm.use_deferred_deletion + dm.use_deferred_removal + " + local zfs_options="zfs.fsname" + + case $(__docker_value_of_option '--storage-driver|-s') in + '') + COMPREPLY=( $( compgen -W "$devicemapper_options $zfs_options" -S = -- "$cur" ) ) + ;; + devicemapper) + COMPREPLY=( $( compgen -W "$devicemapper_options" -S = -- "$cur" ) ) + ;; + zfs) + COMPREPLY=( $( compgen -W "$zfs_options" -S = -- "$cur" ) ) + ;; + *) + return + ;; + esac + __docker_nospace + return + ;; + --log-level|-l) + __docker_log_levels + return + ;; + --log-opt) + __docker_log_driver_options + return + ;; + $(__docker_to_extglob "$options_with_args") ) + return + ;; + esac + + __docker_complete_log_driver_options && return + + case "${words[$cword-2]}$prev=" in + # completions for --storage-opt + *dm.@(blkdiscard|override_udev_sync_check|use_deferred_@(removal|deletion))=*) + COMPREPLY=( $( compgen -W "false true" -- "${cur#=}" ) ) + return + ;; + *dm.fs=*) + COMPREPLY=( $( compgen -W "ext4 xfs" -- "${cur#=}" ) ) + return + ;; + *dm.thinpooldev=*) + _filedir + return + ;; + # completions for --cluster-store-opt + *kv.*file=*) + _filedir + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "$boolean_options $options_with_args" -- "$cur" ) ) + ;; + esac +} + +_docker_diff() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_all + fi + ;; + esac +} + +_docker_events() { + case "$prev" in + --filter|-f) + COMPREPLY=( $( compgen -S = -W "container event image" -- "$cur" ) ) + __docker_nospace + return + ;; + --since|--until) + return + ;; + esac + + case "${words[$cword-2]}$prev=" in + *container=*) + cur="${cur#=}" + __docker_containers_all + return + ;; + *event=*) + COMPREPLY=( $( compgen -W " + attach + commit + copy + create + delete + destroy + die + exec_create + exec_start + export + import + kill + oom + pause + pull + push + rename + resize + restart + start + stop + tag + top + unpause + untag + " -- "${cur#=}" ) ) + return + ;; + *image=*) + cur="${cur#=}" + __docker_images + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--filter -f --help --since --until" -- "$cur" ) ) + ;; + esac +} + +_docker_exec() { + case "$prev" in + --user|-u) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--detach -d --help --interactive -i --privileged -t --tty -u --user" -- "$cur" ) ) + ;; + *) + __docker_containers_running + ;; + esac +} + +_docker_export() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_all + fi + ;; + esac +} + +_docker_help() { + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + COMPREPLY=( $( compgen -W "${commands[*]}" -- "$cur" ) ) + fi +} + +_docker_history() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --no-trunc --quiet -q" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_images + fi + ;; + esac +} + +_docker_images() { + case "$prev" in + --filter|-f) + COMPREPLY=( $( compgen -W "dangling=true label=" -- "$cur" ) ) + if [ "$COMPREPLY" = "label=" ]; then + __docker_nospace + fi + return + ;; + esac + + case "${words[$cword-2]}$prev=" in + *dangling=*) + COMPREPLY=( $( compgen -W "true false" -- "${cur#=}" ) ) + return + ;; + *label=*) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--all -a --digests --filter -f --help --no-trunc --quiet -q" -- "$cur" ) ) + ;; + =) + return + ;; + =) + return + ;; + *) + __docker_image_repos + ;; + esac +} + +_docker_import() { + case "$prev" in + --change|-c|--message|-m) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--change -c --help --message -m" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag '--change|-c|--message|-m') + if [ $cword -eq $counter ]; then + return + fi + (( counter++ )) + + if [ $cword -eq $counter ]; then + __docker_image_repos_and_tags + return + fi + ;; + esac +} + +_docker_info() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + esac +} + +_docker_inspect() { + case "$prev" in + --format|-f) + return + ;; + --type) + COMPREPLY=( $( compgen -W "image container" -- "$cur" ) ) + return + ;; + + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--format -f --help --size -s --type" -- "$cur" ) ) + ;; + *) + case $(__docker_value_of_option --type) in + '') + __docker_containers_and_images + ;; + container) + __docker_containers_all + ;; + image) + __docker_images + ;; + esac + esac +} + +_docker_kill() { + case "$prev" in + --signal|-s) + __docker_signals + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --signal -s" -- "$cur" ) ) + ;; + *) + __docker_containers_running + ;; + esac +} + +_docker_load() { + case "$prev" in + --input|-i) + _filedir + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --input -i" -- "$cur" ) ) + ;; + esac +} + +_docker_login() { + case "$prev" in + --email|-e|--password|-p|--username|-u) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--email -e --help --password -p --username -u" -- "$cur" ) ) + ;; + esac +} + +_docker_logout() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + esac +} + +_docker_logs() { + case "$prev" in + --since|--tail) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--follow -f --help --since --tail --timestamps -t" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag '--tail') + if [ $cword -eq $counter ]; then + __docker_containers_all + fi + ;; + esac +} + +_docker_network_connect() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag '--tail') + if [ $cword -eq $counter ]; then + __docker_networks + elif [ $cword -eq $(($counter + 1)) ]; then + __docker_containers_running + fi + ;; + esac +} + +_docker_network_create() { + case "$prev" in + --aux-address|--gateway|--ip-range|--opt|-o|--subnet) + return + ;; + --ipam-driver) + COMPREPLY=( $( compgen -W "default" -- "$cur" ) ) + return + ;; + --driver|-d) + # no need to suggest drivers that allow one instance only + # (host, null) + COMPREPLY=( $( compgen -W "bridge overlay" -- "$cur" ) ) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--aux-address --driver -d --gateway --help --ip-range --ipam-driver --opt -o --subnet" -- "$cur" ) ) + ;; + esac +} + +_docker_network_disconnect() { + # TODO disconnect should only complete running containers connected + # to the specified network. + _docker_network_connect +} + +_docker_network_inspect() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + __docker_networks + esac +} + +_docker_network_ls() { + case "$prev" in + -n) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --no-trunc --quiet -q" -- "$cur" ) ) + ;; + esac +} + +_docker_network_rm() { + _docker_network_inspect +} + +_docker_network() { + local subcommands=" + connect + create + disconnect + inspect + ls + rm + " + __docker_subcommands "$subcommands" && return + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + COMPREPLY=( $( compgen -W "$subcommands" -- "$cur" ) ) + ;; + esac +} + +_docker_pause() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_pauseable + fi + ;; + esac +} + +_docker_port() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_all + fi + ;; + esac +} + +_docker_ps() { + case "$prev" in + --before|--since) + __docker_containers_all + ;; + --filter|-f) + COMPREPLY=( $( compgen -S = -W "ancestor exited id label name status" -- "$cur" ) ) + __docker_nospace + return + ;; + --format|-n) + return + ;; + esac + + case "${words[$cword-2]}$prev=" in + *ancestor=*) + cur="${cur#=}" + __docker_images + return + ;; + *id=*) + cur="${cur#=}" + __docker_container_ids + return + ;; + *name=*) + cur="${cur#=}" + __docker_container_names + return + ;; + *status=*) + COMPREPLY=( $( compgen -W "exited paused restarting running" -- "${cur#=}" ) ) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--all -a --before --filter -f --format --help --latest -l -n --no-trunc --quiet -q --size -s --since" -- "$cur" ) ) + ;; + esac +} + +_docker_pull() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--all-tags -a --help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + for arg in "${COMP_WORDS[@]}"; do + case "$arg" in + --all-tags|-a) + __docker_image_repos + return + ;; + esac + done + __docker_image_repos_and_tags + fi + ;; + esac +} + +_docker_push() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_image_repos_and_tags + fi + ;; + esac +} + +_docker_rename() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_all + fi + ;; + esac +} + +_docker_restart() { + case "$prev" in + --time|-t) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --time -t" -- "$cur" ) ) + ;; + *) + __docker_containers_all + ;; + esac +} + +_docker_rm() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--force -f --help --link -l --volumes -v" -- "$cur" ) ) + ;; + *) + for arg in "${COMP_WORDS[@]}"; do + case "$arg" in + --force|-f) + __docker_containers_all + return + ;; + esac + done + __docker_containers_stopped + ;; + esac +} + +_docker_rmi() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--force -f --help --no-prune" -- "$cur" ) ) + ;; + *) + __docker_images + ;; + esac +} + +_docker_run() { + local options_with_args=" + --add-host + --attach -a + --blkio-weight + --cap-add + --cap-drop + --cgroup-parent + --cidfile + --cpu-period + --cpu-quota + --cpuset-cpus + --cpuset-mems + --cpu-shares + --device + --dns + --dns-opt + --dns-search + --entrypoint + --env -e + --env-file + --expose + --group-add + --hostname -h + --ipc + --kernel-memory + --label-file + --label -l + --link + --log-driver + --log-opt + --lxc-conf + --mac-address + --memory -m + --memory-swap + --memory-swappiness + --memory-reservation + --name + --net + --pid + --publish -p + --restart + --security-opt + --stop-signal + --ulimit + --user -u + --uts + --volume-driver + --volumes-from + --volume -v + --workdir -w + " + + local boolean_options=" + --disable-content-trust=false + --help + --interactive -i + --oom-kill-disable + --privileged + --publish-all -P + --read-only + --tty -t + " + + local all_options="$options_with_args $boolean_options" + + [ "$command" = "run" ] && all_options="$all_options + --detach -d + --rm + --sig-proxy=false + " + + case "$prev" in + --add-host) + case "$cur" in + *:) + __docker_resolve_hostname + return + ;; + esac + ;; + --attach|-a) + COMPREPLY=( $( compgen -W 'stdin stdout stderr' -- "$cur" ) ) + return + ;; + --cap-add|--cap-drop) + __docker_capabilities + return + ;; + --cidfile|--env-file|--label-file) + _filedir + return + ;; + --device|--volume|-v) + case "$cur" in + *:*) + # TODO somehow do _filedir for stuff inside the image, if it's already specified (which is also somewhat difficult to determine) + ;; + '') + COMPREPLY=( $( compgen -W '/' -- "$cur" ) ) + __docker_nospace + ;; + /*) + _filedir + __docker_nospace + ;; + esac + return + ;; + --env|-e) + COMPREPLY=( $( compgen -e -- "$cur" ) ) + __docker_nospace + return + ;; + --ipc) + case "$cur" in + *:*) + cur="${cur#*:}" + __docker_containers_running + ;; + *) + COMPREPLY=( $( compgen -W 'host container:' -- "$cur" ) ) + if [ "$COMPREPLY" = "container:" ]; then + __docker_nospace + fi + ;; + esac + return + ;; + --link) + case "$cur" in + *:*) + ;; + *) + __docker_containers_running + COMPREPLY=( $( compgen -W "${COMPREPLY[*]}" -S ':' ) ) + __docker_nospace + ;; + esac + return + ;; + --log-driver) + __docker_log_drivers + return + ;; + --log-opt) + __docker_log_driver_options + return + ;; + --net) + case "$cur" in + container:*) + local cur=${cur#*:} + __docker_containers_all + ;; + *) + COMPREPLY=( $( compgen -W "bridge none container: host" -- "$cur") ) + if [ "${COMPREPLY[*]}" = "container:" ] ; then + __docker_nospace + fi + ;; + esac + return + ;; + --restart) + case "$cur" in + on-failure:*) + ;; + *) + COMPREPLY=( $( compgen -W "always no on-failure on-failure: unless-stopped" -- "$cur") ) + ;; + esac + return + ;; + --security-opt) + case "$cur" in + label:*:*) + ;; + label:*) + local cur=${cur##*:} + COMPREPLY=( $( compgen -W "user: role: type: level: disable" -- "$cur") ) + if [ "${COMPREPLY[*]}" != "disable" ] ; then + __docker_nospace + fi + ;; + *) + COMPREPLY=( $( compgen -W "label apparmor" -S ":" -- "$cur") ) + __docker_nospace + ;; + esac + return + ;; + --volume-driver) + COMPREPLY=( $( compgen -W "local" -- "$cur" ) ) + return + ;; + --volumes-from) + __docker_containers_all + return + ;; + $(__docker_to_extglob "$options_with_args") ) + return + ;; + esac + + __docker_complete_log_driver_options && return + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "$all_options" -- "$cur" ) ) + ;; + *) + local counter=$( __docker_pos_first_nonflag $( __docker_to_alternatives "$options_with_args" ) ) + if [ $cword -eq $counter ]; then + __docker_images + fi + ;; + esac +} + +_docker_save() { + case "$prev" in + --output|-o) + _filedir + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --output -o" -- "$cur" ) ) + ;; + *) + __docker_images + ;; + esac +} + +_docker_search() { + case "$prev" in + --stars|-s) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--automated --help --no-trunc --stars -s" -- "$cur" ) ) + ;; + esac +} + +_docker_start() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--attach -a --help --interactive -i" -- "$cur" ) ) + ;; + *) + __docker_containers_stopped + ;; + esac +} + +_docker_stats() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--no-stream --help" -- "$cur" ) ) + ;; + *) + __docker_containers_running + ;; + esac +} + +_docker_stop() { + case "$prev" in + --time|-t) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help --time -t" -- "$cur" ) ) + ;; + *) + __docker_containers_running + ;; + esac +} + +_docker_tag() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--force -f --help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + + if [ $cword -eq $counter ]; then + __docker_image_repos_and_tags + return + fi + (( counter++ )) + + if [ $cword -eq $counter ]; then + __docker_image_repos_and_tags + return + fi + ;; + esac +} + +_docker_unpause() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_unpauseable + fi + ;; + esac +} + +_docker_top() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + local counter=$(__docker_pos_first_nonflag) + if [ $cword -eq $counter ]; then + __docker_containers_running + fi + ;; + esac +} + +_docker_version() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + esac +} + +_docker_volume_create() { + case "$prev" in + --driver|-d) + COMPREPLY=( $( compgen -W "local" -- "$cur" ) ) + return + ;; + --name|--opt|-o) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--driver -d --help --name --opt -o" -- "$cur" ) ) + ;; + esac +} + +_docker_volume_inspect() { + case "$prev" in + --format|-f) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--format -f --help" -- "$cur" ) ) + ;; + *) + __docker_volumes + ;; + esac +} + +_docker_volume_ls() { + case "$prev" in + --filter|-f) + COMPREPLY=( $( compgen -W "dangling=true" -- "$cur" ) ) + return + ;; + esac + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--filter -f --help --quiet -q" -- "$cur" ) ) + ;; + esac +} + +_docker_volume_rm() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + __docker_volumes + ;; + esac +} + +_docker_volume() { + local subcommands=" + create + inspect + ls + rm + " + __docker_subcommands "$subcommands" && return + + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + COMPREPLY=( $( compgen -W "$subcommands" -- "$cur" ) ) + ;; + esac +} + +_docker_wait() { + case "$cur" in + -*) + COMPREPLY=( $( compgen -W "--help" -- "$cur" ) ) + ;; + *) + __docker_containers_all + ;; + esac +} + +_docker() { + local previous_extglob_setting=$(shopt -p extglob) + shopt -s extglob + + local commands=( + attach + build + commit + cp + create + daemon + diff + events + exec + export + history + images + import + info + inspect + kill + load + login + logout + logs + network + pause + port + ps + pull + push + rename + restart + rm + rmi + run + save + search + start + stats + stop + tag + top + unpause + version + volume + wait + ) + + # These options are valid as global options for all client commands + # and valid as command options for `docker daemon` + local global_boolean_options=" + --debug -D + --tls + --tlsverify + " + local global_options_with_args=" + --config + --host -H + --log-level -l + --tlscacert + --tlscert + --tlskey + " + + local host config + + COMPREPLY=() + local cur prev words cword + _get_comp_words_by_ref -n : cur prev words cword + + local command='docker' command_pos=0 subcommand_pos + local counter=1 + while [ $counter -lt $cword ]; do + case "${words[$counter]}" in + # save host so that completion can use custom daemon + --host|-H) + (( counter++ )) + host="${words[$counter]}" + ;; + # save config so that completion can use custom configuration directories + --config) + (( counter++ )) + config="${words[$counter]}" + ;; + $(__docker_to_extglob "$global_options_with_args") ) + (( counter++ )) + ;; + -*) + ;; + =) + (( counter++ )) + ;; + *) + command="${words[$counter]}" + command_pos=$counter + break + ;; + esac + (( counter++ )) + done + + local completions_func=_docker_${command} + declare -F $completions_func >/dev/null && $completions_func + + eval "$previous_extglob_setting" + return 0 +} + +eval "$__docker_previous_extglob_setting" +unset __docker_previous_extglob_setting + +complete -F _docker docker diff --git a/contrib/completion/fish/docker.fish b/contrib/completion/fish/docker.fish new file mode 100644 index 0000000000..c2db2eb249 --- /dev/null +++ b/contrib/completion/fish/docker.fish @@ -0,0 +1,404 @@ +# docker.fish - docker completions for fish shell +# +# This file is generated by gen_docker_fish_completions.py from: +# https://github.com/barnybug/docker-fish-completion +# +# To install the completions: +# mkdir -p ~/.config/fish/completions +# cp docker.fish ~/.config/fish/completions +# +# Completion supported: +# - parameters +# - commands +# - containers +# - images +# - repositories + +function __fish_docker_no_subcommand --description 'Test if docker has yet to be given the subcommand' + for i in (commandline -opc) + if contains -- $i attach build commit cp create diff events exec export history images import info inspect kill load login logout logs pause port ps pull push rename restart rm rmi run save search start stop tag top unpause version wait stats + return 1 + end + end + return 0 +end + +function __fish_print_docker_containers --description 'Print a list of docker containers' -a select + switch $select + case running + docker ps -a --no-trunc | command awk 'NR>1' | command awk 'BEGIN {FS=" +"}; $5 ~ "^Up" {print $1 "\n" $(NF)}' | tr ',' '\n' + case stopped + docker ps -a --no-trunc | command awk 'NR>1' | command awk 'BEGIN {FS=" +"}; $5 ~ "^Exit" {print $1 "\n" $(NF)}' | tr ',' '\n' + case all + docker ps -a --no-trunc | command awk 'NR>1' | command awk 'BEGIN {FS=" +"}; {print $1 "\n" $(NF)}' | tr ',' '\n' + end +end + +function __fish_print_docker_images --description 'Print a list of docker images' + docker images | command awk 'NR>1' | command grep -v '' | command awk '{print $1":"$2}' +end + +function __fish_print_docker_repositories --description 'Print a list of docker repositories' + docker images | command awk 'NR>1' | command grep -v '' | command awk '{print $1}' | command sort | command uniq +end + +# common options +complete -c docker -f -n '__fish_docker_no_subcommand' -l api-cors-header -d "Set CORS headers in the remote API. Default is cors disabled" +complete -c docker -f -n '__fish_docker_no_subcommand' -s b -l bridge -d 'Attach containers to a pre-existing network bridge' +complete -c docker -f -n '__fish_docker_no_subcommand' -l bip -d "Use this CIDR notation address for the network bridge's IP, not compatible with -b" +complete -c docker -f -n '__fish_docker_no_subcommand' -s D -l debug -d 'Enable debug mode' +complete -c docker -f -n '__fish_docker_no_subcommand' -s d -l daemon -d 'Enable daemon mode' +complete -c docker -f -n '__fish_docker_no_subcommand' -l dns -d 'Force Docker to use specific DNS servers' +complete -c docker -f -n '__fish_docker_no_subcommand' -l dns-opt -d 'Force Docker to use specific DNS options' +complete -c docker -f -n '__fish_docker_no_subcommand' -l dns-search -d 'Force Docker to use specific DNS search domains' +complete -c docker -f -n '__fish_docker_no_subcommand' -s e -l exec-driver -d 'Force the Docker runtime to use a specific exec driver' +complete -c docker -f -n '__fish_docker_no_subcommand' -l exec-opt -d 'Set exec driver options' +complete -c docker -f -n '__fish_docker_no_subcommand' -l fixed-cidr -d 'IPv4 subnet for fixed IPs (e.g. 10.20.0.0/16)' +complete -c docker -f -n '__fish_docker_no_subcommand' -l fixed-cidr-v6 -d 'IPv6 subnet for fixed IPs (e.g.: 2001:a02b/48)' +complete -c docker -f -n '__fish_docker_no_subcommand' -s G -l group -d 'Group to assign the unix socket specified by -H when running in daemon mode' +complete -c docker -f -n '__fish_docker_no_subcommand' -s g -l graph -d 'Path to use as the root of the Docker runtime' +complete -c docker -f -n '__fish_docker_no_subcommand' -s H -l host -d 'The socket(s) to bind to in daemon mode or connect to in client mode, specified using one or more tcp://host:port, unix:///path/to/socket, fd://* or fd://socketfd.' +complete -c docker -f -n '__fish_docker_no_subcommand' -s h -l help -d 'Print usage' +complete -c docker -f -n '__fish_docker_no_subcommand' -l icc -d 'Allow unrestricted inter-container and Docker daemon host communication' +complete -c docker -f -n '__fish_docker_no_subcommand' -l insecure-registry -d 'Enable insecure communication with specified registries (no certificate verification for HTTPS and enable HTTP fallback) (e.g., localhost:5000 or 10.20.0.0/16)' +complete -c docker -f -n '__fish_docker_no_subcommand' -l ip -d 'Default IP address to use when binding container ports' +complete -c docker -f -n '__fish_docker_no_subcommand' -l ip-forward -d 'Enable net.ipv4.ip_forward and IPv6 forwarding if --fixed-cidr-v6 is defined. IPv6 forwarding may interfere with your existing IPv6 configuration when using Router Advertisement.' +complete -c docker -f -n '__fish_docker_no_subcommand' -l ip-masq -d "Enable IP masquerading for bridge's IP range" +complete -c docker -f -n '__fish_docker_no_subcommand' -l iptables -d "Enable Docker's addition of iptables rules" +complete -c docker -f -n '__fish_docker_no_subcommand' -l ipv6 -d 'Enable IPv6 networking' +complete -c docker -f -n '__fish_docker_no_subcommand' -s l -l log-level -d 'Set the logging level (debug, info, warn, error, fatal)' +complete -c docker -f -n '__fish_docker_no_subcommand' -l label -d 'Set key=value labels to the daemon (displayed in `docker info`)' +complete -c docker -f -n '__fish_docker_no_subcommand' -l mtu -d 'Set the containers network MTU' +complete -c docker -f -n '__fish_docker_no_subcommand' -s p -l pidfile -d 'Path to use for daemon PID file' +complete -c docker -f -n '__fish_docker_no_subcommand' -l registry-mirror -d 'Specify a preferred Docker registry mirror' +complete -c docker -f -n '__fish_docker_no_subcommand' -s s -l storage-driver -d 'Force the Docker runtime to use a specific storage driver' +complete -c docker -f -n '__fish_docker_no_subcommand' -l selinux-enabled -d 'Enable selinux support. SELinux does not presently support the BTRFS storage driver' +complete -c docker -f -n '__fish_docker_no_subcommand' -l storage-opt -d 'Set storage driver options' +complete -c docker -f -n '__fish_docker_no_subcommand' -l tls -d 'Use TLS; implied by --tlsverify' +complete -c docker -f -n '__fish_docker_no_subcommand' -l tlscacert -d 'Trust only remotes providing a certificate signed by the CA given here' +complete -c docker -f -n '__fish_docker_no_subcommand' -l tlscert -d 'Path to TLS certificate file' +complete -c docker -f -n '__fish_docker_no_subcommand' -l tlskey -d 'Path to TLS key file' +complete -c docker -f -n '__fish_docker_no_subcommand' -l tlsverify -d 'Use TLS and verify the remote (daemon: verify client, client: verify daemon)' +complete -c docker -f -n '__fish_docker_no_subcommand' -s v -l version -d 'Print version information and quit' + +# subcommands +# attach +complete -c docker -f -n '__fish_docker_no_subcommand' -a attach -d 'Attach to a running container' +complete -c docker -A -f -n '__fish_seen_subcommand_from attach' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from attach' -l no-stdin -d 'Do not attach STDIN' +complete -c docker -A -f -n '__fish_seen_subcommand_from attach' -l sig-proxy -d 'Proxy all received signals to the process (non-TTY mode only). SIGCHLD, SIGKILL, and SIGSTOP are not proxied.' +complete -c docker -A -f -n '__fish_seen_subcommand_from attach' -a '(__fish_print_docker_containers running)' -d "Container" + +# build +complete -c docker -f -n '__fish_docker_no_subcommand' -a build -d 'Build an image from a Dockerfile' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -s f -l file -d "Name of the Dockerfile(Default is 'Dockerfile' at context root)" +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -l force-rm -d 'Always remove intermediate containers, even after unsuccessful builds' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -l no-cache -d 'Do not use cache when building the image' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -l pull -d 'Always attempt to pull a newer version of the image' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -s q -l quiet -d 'Suppress the verbose output generated by the containers' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -l rm -d 'Remove intermediate containers after a successful build' +complete -c docker -A -f -n '__fish_seen_subcommand_from build' -s t -l tag -d 'Repository name (and optionally a tag) to be applied to the resulting image in case of success' + +# commit +complete -c docker -f -n '__fish_docker_no_subcommand' -a commit -d "Create a new image from a container's changes" +complete -c docker -A -f -n '__fish_seen_subcommand_from commit' -s a -l author -d 'Author (e.g., "John Hannibal Smith ")' +complete -c docker -A -f -n '__fish_seen_subcommand_from commit' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from commit' -s m -l message -d 'Commit message' +complete -c docker -A -f -n '__fish_seen_subcommand_from commit' -s p -l pause -d 'Pause container during commit' +complete -c docker -A -f -n '__fish_seen_subcommand_from commit' -a '(__fish_print_docker_containers all)' -d "Container" + +# cp +complete -c docker -f -n '__fish_docker_no_subcommand' -a cp -d "Copy files/folders between a container and the local filesystem" +complete -c docker -A -f -n '__fish_seen_subcommand_from cp' -l help -d 'Print usage' + +# create +complete -c docker -f -n '__fish_docker_no_subcommand' -a create -d 'Create a new container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s a -l attach -d 'Attach to STDIN, STDOUT or STDERR.' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l add-host -d 'Add a custom host-to-IP mapping (host:ip)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l cpu-shares -d 'CPU shares (relative weight)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l cap-add -d 'Add Linux capabilities' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l cap-drop -d 'Drop Linux capabilities' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l cidfile -d 'Write the container ID to the file' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l cpuset -d 'CPUs in which to allow execution (0-3, 0,1)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l device -d 'Add a host device to the container (e.g. --device=/dev/sdc:/dev/xvdc:rwm)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l dns -d 'Set custom DNS servers' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l dns-opt -d "Set custom DNS options (Use --dns-opt='' if you don't wish to set options)" +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l dns-search -d "Set custom DNS search domains (Use --dns-search=. if you don't wish to set the search domain)" +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s e -l env -d 'Set environment variables' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l entrypoint -d 'Overwrite the default ENTRYPOINT of the image' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l env-file -d 'Read in a line delimited file of environment variables' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l expose -d 'Expose a port or a range of ports (e.g. --expose=3300-3310) from the container without publishing it to your host' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l group-add -d 'Add additional groups to run as' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s h -l hostname -d 'Container host name' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s i -l interactive -d 'Keep STDIN open even if not attached' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l ipc -d 'Default is to create a private IPC namespace (POSIX SysV IPC) for the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l link -d 'Add link to another container in the form of :alias' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l lxc-conf -d '(lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1"' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s m -l memory -d 'Memory limit (format: [], where unit = b, k, m or g)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l mac-address -d 'Container MAC address (e.g. 92:d0:c6:0a:29:33)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l memory-swap -d "Total memory usage (memory + swap), set '-1' to disable swap (format: [], where unit = b, k, m or g)" +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l name -d 'Assign a name to the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l net -d 'Set the Network mode for the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s P -l publish-all -d 'Publish all exposed ports to random ports on the host interfaces' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s p -l publish -d "Publish a container's port to the host" +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l pid -d 'Default is to create a private PID namespace for the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l privileged -d 'Give extended privileges to this container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l read-only -d "Mount the container's root filesystem as read only" +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l restart -d 'Restart policy to apply when a container exits (no, on-failure[:max-retry], always)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l security-opt -d 'Security Options' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s t -l tty -d 'Allocate a pseudo-TTY' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s u -l user -d 'Username or UID' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s v -l volume -d 'Bind mount a volume (e.g., from the host: -v /host:/container, from Docker: -v /container)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l volumes-from -d 'Mount volumes from the specified container(s)' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -s w -l workdir -d 'Working directory inside the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -a '(__fish_print_docker_images)' -d "Image" + +# diff +complete -c docker -f -n '__fish_docker_no_subcommand' -a diff -d "Inspect changes on a container's filesystem" +complete -c docker -A -f -n '__fish_seen_subcommand_from diff' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from diff' -a '(__fish_print_docker_containers all)' -d "Container" + +# events +complete -c docker -f -n '__fish_docker_no_subcommand' -a events -d 'Get real time events from the server' +complete -c docker -A -f -n '__fish_seen_subcommand_from events' -s f -l filter -d "Provide filter values (i.e., 'event=stop')" +complete -c docker -A -f -n '__fish_seen_subcommand_from events' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from events' -l since -d 'Show all events created since timestamp' +complete -c docker -A -f -n '__fish_seen_subcommand_from events' -l until -d 'Stream events until this timestamp' + +# exec +complete -c docker -f -n '__fish_docker_no_subcommand' -a exec -d 'Run a command in a running container' +complete -c docker -A -f -n '__fish_seen_subcommand_from exec' -s d -l detach -d 'Detached mode: run command in the background' +complete -c docker -A -f -n '__fish_seen_subcommand_from exec' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from exec' -s i -l interactive -d 'Keep STDIN open even if not attached' +complete -c docker -A -f -n '__fish_seen_subcommand_from exec' -s t -l tty -d 'Allocate a pseudo-TTY' +complete -c docker -A -f -n '__fish_seen_subcommand_from exec' -a '(__fish_print_docker_containers running)' -d "Container" + +# export +complete -c docker -f -n '__fish_docker_no_subcommand' -a export -d 'Stream the contents of a container as a tar archive' +complete -c docker -A -f -n '__fish_seen_subcommand_from export' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from export' -a '(__fish_print_docker_containers all)' -d "Container" + +# history +complete -c docker -f -n '__fish_docker_no_subcommand' -a history -d 'Show the history of an image' +complete -c docker -A -f -n '__fish_seen_subcommand_from history' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from history' -l no-trunc -d "Don't truncate output" +complete -c docker -A -f -n '__fish_seen_subcommand_from history' -s q -l quiet -d 'Only show numeric IDs' +complete -c docker -A -f -n '__fish_seen_subcommand_from history' -a '(__fish_print_docker_images)' -d "Image" + +# images +complete -c docker -f -n '__fish_docker_no_subcommand' -a images -d 'List images' +complete -c docker -A -f -n '__fish_seen_subcommand_from images' -s a -l all -d 'Show all images (by default filter out the intermediate image layers)' +complete -c docker -A -f -n '__fish_seen_subcommand_from images' -s f -l filter -d "Provide filter values (i.e., 'dangling=true')" +complete -c docker -A -f -n '__fish_seen_subcommand_from images' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from images' -l no-trunc -d "Don't truncate output" +complete -c docker -A -f -n '__fish_seen_subcommand_from images' -s q -l quiet -d 'Only show numeric IDs' +complete -c docker -A -f -n '__fish_seen_subcommand_from images' -a '(__fish_print_docker_repositories)' -d "Repository" + +# import +complete -c docker -f -n '__fish_docker_no_subcommand' -a import -d 'Create a new filesystem image from the contents of a tarball' +complete -c docker -A -f -n '__fish_seen_subcommand_from import' -l help -d 'Print usage' + +# info +complete -c docker -f -n '__fish_docker_no_subcommand' -a info -d 'Display system-wide information' + +# inspect +complete -c docker -f -n '__fish_docker_no_subcommand' -a inspect -d 'Return low-level information on a container or image' +complete -c docker -A -f -n '__fish_seen_subcommand_from inspect' -s f -l format -d 'Format the output using the given go template.' +complete -c docker -A -f -n '__fish_seen_subcommand_from inspect' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from inspect' -s s -l size -d 'Display total file sizes if the type is container.' +complete -c docker -A -f -n '__fish_seen_subcommand_from inspect' -a '(__fish_print_docker_images)' -d "Image" +complete -c docker -A -f -n '__fish_seen_subcommand_from inspect' -a '(__fish_print_docker_containers all)' -d "Container" + +# kill +complete -c docker -f -n '__fish_docker_no_subcommand' -a kill -d 'Kill a running container' +complete -c docker -A -f -n '__fish_seen_subcommand_from kill' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from kill' -s s -l signal -d 'Signal to send to the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from kill' -a '(__fish_print_docker_containers running)' -d "Container" + +# load +complete -c docker -f -n '__fish_docker_no_subcommand' -a load -d 'Load an image from a tar archive' +complete -c docker -A -f -n '__fish_seen_subcommand_from load' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from load' -s i -l input -d 'Read from a tar archive file, instead of STDIN' + +# login +complete -c docker -f -n '__fish_docker_no_subcommand' -a login -d 'Register or log in to a Docker registry server' +complete -c docker -A -f -n '__fish_seen_subcommand_from login' -s e -l email -d 'Email' +complete -c docker -A -f -n '__fish_seen_subcommand_from login' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from login' -s p -l password -d 'Password' +complete -c docker -A -f -n '__fish_seen_subcommand_from login' -s u -l username -d 'Username' + +# logout +complete -c docker -f -n '__fish_docker_no_subcommand' -a logout -d 'Log out from a Docker registry server' + +# logs +complete -c docker -f -n '__fish_docker_no_subcommand' -a logs -d 'Fetch the logs of a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from logs' -s f -l follow -d 'Follow log output' +complete -c docker -A -f -n '__fish_seen_subcommand_from logs' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from logs' -s t -l timestamps -d 'Show timestamps' +complete -c docker -A -f -n '__fish_seen_subcommand_from logs' -l since -d 'Show logs since timestamp' +complete -c docker -A -f -n '__fish_seen_subcommand_from logs' -l tail -d 'Output the specified number of lines at the end of logs (defaults to all logs)' +complete -c docker -A -f -n '__fish_seen_subcommand_from logs' -a '(__fish_print_docker_containers running)' -d "Container" + +# port +complete -c docker -f -n '__fish_docker_no_subcommand' -a port -d 'Lookup the public-facing port that is NAT-ed to PRIVATE_PORT' +complete -c docker -A -f -n '__fish_seen_subcommand_from port' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from port' -a '(__fish_print_docker_containers running)' -d "Container" + +# pause +complete -c docker -f -n '__fish_docker_no_subcommand' -a pause -d 'Pause all processes within a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from pause' -a '(__fish_print_docker_containers running)' -d "Container" + +# ps +complete -c docker -f -n '__fish_docker_no_subcommand' -a ps -d 'List containers' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -s a -l all -d 'Show all containers. Only running containers are shown by default.' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -l before -d 'Show only container created before Id or Name, include non-running ones.' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -s f -l filter -d 'Provide filter values. Valid filters:' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -s l -l latest -d 'Show only the latest created container, include non-running ones.' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -s n -d 'Show n last created containers, include non-running ones.' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -l no-trunc -d "Don't truncate output" +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -s q -l quiet -d 'Only display numeric IDs' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -s s -l size -d 'Display total file sizes' +complete -c docker -A -f -n '__fish_seen_subcommand_from ps' -l since -d 'Show only containers created since Id or Name, include non-running ones.' + +# pull +complete -c docker -f -n '__fish_docker_no_subcommand' -a pull -d 'Pull an image or a repository from a Docker registry server' +complete -c docker -A -f -n '__fish_seen_subcommand_from pull' -s a -l all-tags -d 'Download all tagged images in the repository' +complete -c docker -A -f -n '__fish_seen_subcommand_from pull' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from pull' -a '(__fish_print_docker_images)' -d "Image" +complete -c docker -A -f -n '__fish_seen_subcommand_from pull' -a '(__fish_print_docker_repositories)' -d "Repository" + +# push +complete -c docker -f -n '__fish_docker_no_subcommand' -a push -d 'Push an image or a repository to a Docker registry server' +complete -c docker -A -f -n '__fish_seen_subcommand_from push' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from push' -a '(__fish_print_docker_images)' -d "Image" +complete -c docker -A -f -n '__fish_seen_subcommand_from push' -a '(__fish_print_docker_repositories)' -d "Repository" + +# rename +complete -c docker -f -n '__fish_docker_no_subcommand' -a rename -d 'Rename an existing container' + +# restart +complete -c docker -f -n '__fish_docker_no_subcommand' -a restart -d 'Restart a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from restart' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from restart' -s t -l time -d 'Number of seconds to try to stop for before killing the container. Once killed it will then be restarted. Default is 10 seconds.' +complete -c docker -A -f -n '__fish_seen_subcommand_from restart' -a '(__fish_print_docker_containers running)' -d "Container" + +# rm +complete -c docker -f -n '__fish_docker_no_subcommand' -a rm -d 'Remove one or more containers' +complete -c docker -A -f -n '__fish_seen_subcommand_from rm' -s f -l force -d 'Force the removal of a running container (uses SIGKILL)' +complete -c docker -A -f -n '__fish_seen_subcommand_from rm' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from rm' -s l -l link -d 'Remove the specified link and not the underlying container' +complete -c docker -A -f -n '__fish_seen_subcommand_from rm' -s v -l volumes -d 'Remove the volumes associated with the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from rm' -a '(__fish_print_docker_containers stopped)' -d "Container" + +# rmi +complete -c docker -f -n '__fish_docker_no_subcommand' -a rmi -d 'Remove one or more images' +complete -c docker -A -f -n '__fish_seen_subcommand_from rmi' -s f -l force -d 'Force removal of the image' +complete -c docker -A -f -n '__fish_seen_subcommand_from rmi' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from rmi' -l no-prune -d 'Do not delete untagged parents' +complete -c docker -A -f -n '__fish_seen_subcommand_from rmi' -a '(__fish_print_docker_images)' -d "Image" + +# run +complete -c docker -f -n '__fish_docker_no_subcommand' -a run -d 'Run a command in a new container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s a -l attach -d 'Attach to STDIN, STDOUT or STDERR.' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l add-host -d 'Add a custom host-to-IP mapping (host:ip)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s c -l cpu-shares -d 'CPU shares (relative weight)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l cap-add -d 'Add Linux capabilities' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l cap-drop -d 'Drop Linux capabilities' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l cidfile -d 'Write the container ID to the file' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l cpuset -d 'CPUs in which to allow execution (0-3, 0,1)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s d -l detach -d 'Detached mode: run the container in the background and print the new container ID' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l device -d 'Add a host device to the container (e.g. --device=/dev/sdc:/dev/xvdc:rwm)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l dns -d 'Set custom DNS servers' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l dns-opt -d "Set custom DNS options (Use --dns-opt='' if you don't wish to set options)" +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l dns-search -d "Set custom DNS search domains (Use --dns-search=. if you don't wish to set the search domain)" +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s e -l env -d 'Set environment variables' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l entrypoint -d 'Overwrite the default ENTRYPOINT of the image' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l env-file -d 'Read in a line delimited file of environment variables' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l expose -d 'Expose a port or a range of ports (e.g. --expose=3300-3310) from the container without publishing it to your host' +complete -c docker -A -f -n '__fish_seen_subcommand_from create' -l group-add -d 'Add additional groups to run as' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s h -l hostname -d 'Container host name' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s i -l interactive -d 'Keep STDIN open even if not attached' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l ipc -d 'Default is to create a private IPC namespace (POSIX SysV IPC) for the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l link -d 'Add link to another container in the form of :alias' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l lxc-conf -d '(lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1"' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s m -l memory -d 'Memory limit (format: [], where unit = b, k, m or g)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l mac-address -d 'Container MAC address (e.g. 92:d0:c6:0a:29:33)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l memory-swap -d "Total memory usage (memory + swap), set '-1' to disable swap (format: [], where unit = b, k, m or g)" +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l name -d 'Assign a name to the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l net -d 'Set the Network mode for the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s P -l publish-all -d 'Publish all exposed ports to random ports on the host interfaces' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s p -l publish -d "Publish a container's port to the host" +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l pid -d 'Default is to create a private PID namespace for the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l privileged -d 'Give extended privileges to this container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l read-only -d "Mount the container's root filesystem as read only" +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l restart -d 'Restart policy to apply when a container exits (no, on-failure[:max-retry], always)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l rm -d 'Automatically remove the container when it exits (incompatible with -d)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l security-opt -d 'Security Options' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l sig-proxy -d 'Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied.' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l stop-signal -d 'Signal to kill a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s t -l tty -d 'Allocate a pseudo-TTY' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s u -l user -d 'Username or UID' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s v -l volume -d 'Bind mount a volume (e.g., from the host: -v /host:/container, from Docker: -v /container)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -l volumes-from -d 'Mount volumes from the specified container(s)' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -s w -l workdir -d 'Working directory inside the container' +complete -c docker -A -f -n '__fish_seen_subcommand_from run' -a '(__fish_print_docker_images)' -d "Image" + +# save +complete -c docker -f -n '__fish_docker_no_subcommand' -a save -d 'Save an image to a tar archive' +complete -c docker -A -f -n '__fish_seen_subcommand_from save' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from save' -s o -l output -d 'Write to an file, instead of STDOUT' +complete -c docker -A -f -n '__fish_seen_subcommand_from save' -a '(__fish_print_docker_images)' -d "Image" + +# search +complete -c docker -f -n '__fish_docker_no_subcommand' -a search -d 'Search for an image on the registry (defaults to the Docker Hub)' +complete -c docker -A -f -n '__fish_seen_subcommand_from search' -l automated -d 'Only show automated builds' +complete -c docker -A -f -n '__fish_seen_subcommand_from search' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from search' -l no-trunc -d "Don't truncate output" +complete -c docker -A -f -n '__fish_seen_subcommand_from search' -s s -l stars -d 'Only displays with at least x stars' + +# start +complete -c docker -f -n '__fish_docker_no_subcommand' -a start -d 'Start a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from start' -s a -l attach -d "Attach container's STDOUT and STDERR and forward all signals to the process" +complete -c docker -A -f -n '__fish_seen_subcommand_from start' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from start' -s i -l interactive -d "Attach container's STDIN" +complete -c docker -A -f -n '__fish_seen_subcommand_from start' -a '(__fish_print_docker_containers stopped)' -d "Container" + +# stats +complete -c docker -f -n '__fish_docker_no_subcommand' -a stats -d "Display a live stream of one or more containers' resource usage statistics" +complete -c docker -A -f -n '__fish_seen_subcommand_from stats' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from stats' -l no-stream -d 'Disable streaming stats and only pull the first result' +complete -c docker -A -f -n '__fish_seen_subcommand_from stats' -a '(__fish_print_docker_containers running)' -d "Container" + +# stop +complete -c docker -f -n '__fish_docker_no_subcommand' -a stop -d 'Stop a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from stop' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from stop' -s t -l time -d 'Number of seconds to wait for the container to stop before killing it. Default is 10 seconds.' +complete -c docker -A -f -n '__fish_seen_subcommand_from stop' -a '(__fish_print_docker_containers running)' -d "Container" + +# tag +complete -c docker -f -n '__fish_docker_no_subcommand' -a tag -d 'Tag an image into a repository' +complete -c docker -A -f -n '__fish_seen_subcommand_from tag' -s f -l force -d 'Force' +complete -c docker -A -f -n '__fish_seen_subcommand_from tag' -l help -d 'Print usage' + +# top +complete -c docker -f -n '__fish_docker_no_subcommand' -a top -d 'Lookup the running processes of a container' +complete -c docker -A -f -n '__fish_seen_subcommand_from top' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from top' -a '(__fish_print_docker_containers running)' -d "Container" + +# unpause +complete -c docker -f -n '__fish_docker_no_subcommand' -a unpause -d 'Unpause a paused container' +complete -c docker -A -f -n '__fish_seen_subcommand_from unpause' -a '(__fish_print_docker_containers running)' -d "Container" + +# version +complete -c docker -f -n '__fish_docker_no_subcommand' -a version -d 'Show the Docker version information' + +# wait +complete -c docker -f -n '__fish_docker_no_subcommand' -a wait -d 'Block until a container stops, then print its exit code' +complete -c docker -A -f -n '__fish_seen_subcommand_from wait' -l help -d 'Print usage' +complete -c docker -A -f -n '__fish_seen_subcommand_from wait' -a '(__fish_print_docker_containers running)' -d "Container" + + diff --git a/contrib/completion/zsh/REVIEWERS b/contrib/completion/zsh/REVIEWERS new file mode 100644 index 0000000000..03ee2dde3d --- /dev/null +++ b/contrib/completion/zsh/REVIEWERS @@ -0,0 +1,2 @@ +Tianon Gravi (@tianon) +Jessie Frazelle (@jfrazelle) diff --git a/contrib/completion/zsh/_docker b/contrib/completion/zsh/_docker new file mode 100644 index 0000000000..c3076fc0b0 --- /dev/null +++ b/contrib/completion/zsh/_docker @@ -0,0 +1,942 @@ +#compdef docker +# +# zsh completion for docker (http://docker.com) +# +# version: 0.3.0 +# github: https://github.com/felixr/docker-zsh-completion +# +# contributors: +# - Felix Riedel +# - Steve Durrheimer +# - Vincent Bernat +# +# license: +# +# Copyright (c) 2013, Felix Riedel +# All rights reserved. +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are met: +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# * Redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# * Neither the name of the nor the +# names of its contributors may be used to endorse or promote products +# derived from this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +# DISCLAIMED. IN NO EVENT SHALL BE LIABLE FOR ANY +# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# + +__docker_get_containers() { + [[ $PREFIX = -* ]] && return 1 + integer ret=1 + local kind + declare -a running stopped lines args + + kind=$1 + shift + [[ $kind = (stopped|all) ]] && args=($args -a) + + lines=(${(f)"$(_call_program commands docker $docker_options ps --no-trunc $args)"}) + + # Parse header line to find columns + local i=1 j=1 k header=${lines[1]} + declare -A begin end + while (( j < ${#header} - 1 )); do + i=$(( j + ${${header[$j,-1]}[(i)[^ ]]} - 1 )) + j=$(( i + ${${header[$i,-1]}[(i) ]} - 1 )) + k=$(( j + ${${header[$j,-1]}[(i)[^ ]]} - 2 )) + begin[${header[$i,$((j-1))]}]=$i + end[${header[$i,$((j-1))]}]=$k + done + end[${header[$i,$((j-1))]}]=-1 # Last column, should go to the end of the line + lines=(${lines[2,-1]}) + + # Container ID + local line + local s + for line in $lines; do + s="${${line[${begin[CONTAINER ID]},${end[CONTAINER ID]}]%% ##}[0,12]}" + s="$s:${(l:15:: :::)${${line[${begin[CREATED]},${end[CREATED]}]/ ago/}%% ##}}" + s="$s, ${${${line[${begin[IMAGE]},${end[IMAGE]}]}/:/\\:}%% ##}" + if [[ ${line[${begin[STATUS]},${end[STATUS]}]} = Exit* ]]; then + stopped=($stopped $s) + else + running=($running $s) + fi + done + + # Names: we only display the one without slash. All other names + # are generated and may clutter the completion. However, with + # Swarm, all names may be prefixed by the swarm node name. + local -a names + for line in $lines; do + names=(${(ps:,:)${${line[${begin[NAMES]},${end[NAMES]}]}%% *}}) + # First step: find a common prefix and strip it (swarm node case) + (( ${#${(u)names%%/*}} == 1 )) && names=${names#${names[1]%%/*}/} + # Second step: only keep the first name without a / + s=${${names:#*/*}[1]} + # If no name, well give up. + (( $#s != 0 )) || continue + s="$s:${(l:15:: :::)${${line[${begin[CREATED]},${end[CREATED]}]/ ago/}%% ##}}" + s="$s, ${${${line[${begin[IMAGE]},${end[IMAGE]}]}/:/\\:}%% ##}" + if [[ ${line[${begin[STATUS]},${end[STATUS]}]} = Exit* ]]; then + stopped=($stopped $s) + else + running=($running $s) + fi + done + + [[ $kind = (running|all) ]] && _describe -t containers-running "running containers" running "$@" && ret=0 + [[ $kind = (stopped|all) ]] && _describe -t containers-stopped "stopped containers" stopped "$@" && ret=0 + return ret +} + +__docker_stoppedcontainers() { + [[ $PREFIX = -* ]] && return 1 + __docker_get_containers stopped "$@" +} + +__docker_runningcontainers() { + [[ $PREFIX = -* ]] && return 1 + __docker_get_containers running "$@" +} + +__docker_containers() { + [[ $PREFIX = -* ]] && return 1 + __docker_get_containers all "$@" +} + +__docker_images() { + [[ $PREFIX = -* ]] && return 1 + integer ret=1 + declare -a images + images=(${${${(f)"$(_call_program commands docker $docker_options images)"}[2,-1]}/(#b)([^ ]##) ##([^ ]##) ##([^ ]##)*/${match[3]}:${(r:15:: :::)match[2]} in ${match[1]}}) + _describe -t docker-images "images" images && ret=0 + __docker_repositories_with_tags && ret=0 + return ret +} + +__docker_repositories() { + [[ $PREFIX = -* ]] && return 1 + declare -a repos + repos=(${${${(f)"$(_call_program commands docker $docker_options images)"}%% *}[2,-1]}) + repos=(${repos#}) + _describe -t docker-repos "repositories" repos +} + +__docker_repositories_with_tags() { + [[ $PREFIX = -* ]] && return 1 + integer ret=1 + declare -a repos onlyrepos matched + declare m + repos=(${${${${(f)"$(_call_program commands docker $docker_options images)"}[2,-1]}/ ##/:::}%% *}) + repos=(${${repos%:::}#}) + # Check if we have a prefix-match for the current prefix. + onlyrepos=(${repos%::*}) + for m in $onlyrepos; do + [[ ${PREFIX##${~~m}} != ${PREFIX} ]] && { + # Yes, complete with tags + repos=(${${repos/:::/:}/:/\\:}) + _describe -t docker-repos-with-tags "repositories with tags" repos && ret=0 + return ret + } + done + # No, only complete repositories + onlyrepos=(${${repos%:::*}/:/\\:}) + _describe -t docker-repos "repositories" onlyrepos -qS : && ret=0 + + return ret +} + +__docker_search() { + [[ $PREFIX = -* ]] && return 1 + local cache_policy + zstyle -s ":completion:${curcontext}:" cache-policy cache_policy + if [[ -z "$cache_policy" ]]; then + zstyle ":completion:${curcontext}:" cache-policy __docker_caching_policy + fi + + local searchterm cachename + searchterm="${words[$CURRENT]%/}" + cachename=_docker-search-$searchterm + + local expl + local -a result + if ( [[ ${(P)+cachename} -eq 0 ]] || _cache_invalid ${cachename#_} ) \ + && ! _retrieve_cache ${cachename#_}; then + _message "Searching for ${searchterm}..." + result=(${${${(f)"$(_call_program commands docker $docker_options search $searchterm)"}%% *}[2,-1]}) + _store_cache ${cachename#_} result + fi + _wanted dockersearch expl 'available images' compadd -a result +} + +__docker_networks() { + [[ $PREFIX = -* ]] && return 1 + integer ret=1 + declare -a lines networks + + lines=(${(f)"$(_call_program commands docker $docker_options network ls)"}) + + # Parse header line to find columns + local i=1 j=1 k header=${lines[1]} + declare -A begin end + while (( j < ${#header} - 1 )); do + i=$(( j + ${${header[$j,-1]}[(i)[^ ]]} - 1 )) + j=$(( i + ${${header[$i,-1]}[(i) ]} - 1 )) + k=$(( j + ${${header[$j,-1]}[(i)[^ ]]} - 2 )) + begin[${header[$i,$((j-1))]}]=$i + end[${header[$i,$((j-1))]}]=$k + done + end[${header[$i,$((j-1))]}]=-1 + lines=(${lines[2,-1]}) + + # Network ID + local line s + for line in $lines; do + s="${line[${begin[NETWORK ID]},${end[NETWORK ID]}]%% ##}" + s="$s:${(l:7:: :::)${${line[${begin[DRIVER]},${end[DRIVER]}]}%% ##}}" + networks=($networks $s) + done + + # Names + for line in $lines; do + s="${line[${begin[NAME]},${end[NAME]}]%% ##}" + s="$s:${(l:7:: :::)${${line[${begin[DRIVER]},${end[DRIVER]}]}%% ##}}" + networks=($networks $s) + done + + _describe -t networks-list "networks" networks && ret=0 + return ret +} + +__docker_network_commands() { + local -a _docker_network_subcommands + _docker_network_subcommands=( + "connect:onnects a container to a network" + "create:Creates a new network with a name specified by the user" + "disconnect:Disconnects a container from a network" + "inspect:Displays detailed information on a network" + "ls:Lists all the networks created by the user" + "rm:Deletes a network" + ) + _describe -t docker-network-commands "docker network command" _docker_network_subcommands +} + +__docker_network_subcommand() { + local -a _command_args opts_help + local expl help="--help" + integer ret=1 + + opts_help=("(: -)--help[Print usage]") + + case "$words[1]" in + (connect|disconnect) + _arguments \ + $opts_help \ + "($help -)1:network:__docker_networks" \ + "($help -)2:containers:__docker_runningcontainers" && ret=0 + ;; + (create) + _arguments -A '-*' \ + $opts_help \ + "($help -d --driver)"{-d,--driver=}"[Driver to manage the Network]:driver:(null host bridge overlay)" \ + "($help)--ipam-driver=[IP Address Management Driver]:driver:(default)" \ + "($help)*--subnet=[Subnet in CIDR format that represents a network segment]:IP/mask: " \ + "($help)*--ip-range=[Allocate container ip from a sub-range]:IP/mask: " \ + "($help)*--gateway=[ipv4 or ipv6 Gateway for the master subnet]:IP: " \ + "($help)*--aux-address[Auxiliary ipv4 or ipv6 addresses used by network driver]:key=IP: " \ + "($help)*"{-o=,--opt=}"[Set driver specific options]:key=value: " \ + "($help -)1:Network Name: " && ret=0 + ;; + (inspect|rm) + _arguments \ + $opts_help \ + "($help -)*:network:__docker_networks" && ret=0 + ;; + (ls) + _arguments \ + $opts_help \ + "($help)--no-trunc[Do not truncate the output]" \ + "($help -q --quiet)"{-q,--quiet}"[Only display numeric IDs]" && ret=0 + ;; + (help) + _arguments ":subcommand:__docker_network_commands" && ret=0 + ;; + esac + + return ret +} + +__docker_volumes() { + [[ $PREFIX = -* ]] && return 1 + integer ret=1 + declare -a lines volumes + + lines=(${(f)"$(_call_program commands docker $docker_options volume ls)"}) + + # Parse header line to find columns + local i=1 j=1 k header=${lines[1]} + declare -A begin end + while (( j < ${#header} - 1 )); do + i=$(( j + ${${header[$j,-1]}[(i)[^ ]]} - 1 )) + j=$(( i + ${${header[$i,-1]}[(i) ]} - 1 )) + k=$(( j + ${${header[$j,-1]}[(i)[^ ]]} - 2 )) + begin[${header[$i,$((j-1))]}]=$i + end[${header[$i,$((j-1))]}]=$k + done + end[${header[$i,$((j-1))]}]=-1 + lines=(${lines[2,-1]}) + + # Names + local line s + for line in $lines; do + s="${line[${begin[VOLUME NAME]},${end[VOLUME NAME]}]%% ##}" + s="$s:${(l:7:: :::)${${line[${begin[DRIVER]},${end[DRIVER]}]}%% ##}}" + volumes=($volumes $s) + done + + _describe -t volumes-list "volumes" volumes && ret=0 + return ret +} + +__docker_volume_commands() { + local -a _docker_volume_subcommands + _docker_volume_subcommands=( + "create:Create a volume" + "inspect:Return low-level information on a volume" + "ls:List volumes" + "rm:Remove a volume" + ) + _describe -t docker-volume-commands "docker volume command" _docker_volume_subcommands +} + +__docker_volume_subcommand() { + local -a _command_args opts_help + local expl help="--help" + integer ret=1 + + opts_help=("(: -)--help[Print usage]") + + case "$words[1]" in + (create) + _arguments \ + $opts_help \ + "($help -d --driver)"{-d,--driver=}"[Specify volume driver name]:Driver name:(local)" \ + "($help)--name=[Specify volume name]" \ + "($help)*"{-o,--opt=}"[Set driver specific options]:Driver option: " && ret=0 + ;; + (inspect) + _arguments \ + $opts_help \ + "($help -f --format)"{-f,--format=}"[Format the output using the given go template]:template: " \ + "($help -)1:volume:__docker_volumes" && ret=0 + ;; + (ls) + _arguments \ + $opts_help \ + "($help)*"{-f,--filter=}"[Provide filter values (i.e. 'dangling=true')]:filter: " \ + "($help -q --quiet)"{-q,--quiet}"[Only display volume names]" && ret=0 + ;; + (rm) + _arguments \ + $opts_help \ + "($help -):volume:__docker_volumes" && ret=0 + ;; + (help) + _arguments ":subcommand:__docker_volume_commands" && ret=0 + ;; + esac + + return ret +} + +__docker_caching_policy() { + oldp=( "$1"(Nmh+1) ) # 1 hour + (( $#oldp )) +} + +__docker_commands() { + local cache_policy + + zstyle -s ":completion:${curcontext}:" cache-policy cache_policy + if [[ -z "$cache_policy" ]]; then + zstyle ":completion:${curcontext}:" cache-policy __docker_caching_policy + fi + + if ( [[ ${+_docker_subcommands} -eq 0 ]] || _cache_invalid docker_subcommands) \ + && ! _retrieve_cache docker_subcommands; + then + local -a lines + lines=(${(f)"$(_call_program commands docker 2>&1)"}) + _docker_subcommands=(${${${lines[$((${lines[(i)Commands:]} + 1)),${lines[(I) *]}]}## #}/ ##/:}) + _docker_subcommands=($_docker_subcommands 'daemon:Enable daemon mode' 'help:Show help for a command') + _store_cache docker_subcommands _docker_subcommands + fi + _describe -t docker-commands "docker command" _docker_subcommands +} + +__docker_subcommand() { + local -a _command_args opts_help opts_cpumemlimit opts_create + local expl help="--help" + integer ret=1 + + opts_help=("(: -)--help[Print usage]") + opts_cpumemlimit=( + "($help)--cpu-shares=[CPU shares (relative weight)]:CPU shares:(0 10 100 200 500 800 1000)" + "($help)--cgroup-parent=[Parent cgroup for the container]:cgroup: " + "($help)--cpu-period=[Limit the CPU CFS (Completely Fair Scheduler) period]:CPU period: " + "($help)--cpu-quota=[Limit the CPU CFS (Completely Fair Scheduler) quota]:CPU quota: " + "($help)--cpuset-cpus=[CPUs in which to allow execution]:CPUs: " + "($help)--cpuset-mems=[MEMs in which to allow execution]:MEMs: " + "($help -m --memory)"{-m,--memory=}"[Memory limit]:Memory limit: " + "($help)--memory-swap=[Total memory limit with swap]:Memory limit: " + "($help)*--ulimit=[ulimit options]:ulimit: " + ) + opts_create=( + "($help -a --attach)"{-a,--attach=}"[Attach to stdin, stdout or stderr]:device:(STDIN STDOUT STDERR)" + "($help)*--add-host=[Add a custom host-to-IP mapping]:host\:ip mapping: " + "($help)--blkio-weight=[Block IO (relative weight), between 10 and 1000]:Block IO weight:(10 100 500 1000)" + "($help)*--cap-add=[Add Linux capabilities]:capability: " + "($help)*--cap-drop=[Drop Linux capabilities]:capability: " + "($help)--cidfile=[Write the container ID to the file]:CID file:_files" + "($help)*--device=[Add a host device to the container]:device:_files" + "($help)*--dns=[Set custom DNS servers]:DNS server: " + "($help)*--dns-opt=[Set custom DNS options]:DNS option: " + "($help)*--dns-search=[Set custom DNS search domains]:DNS domains: " + "($help)*"{-e,--env=}"[Set environment variables]:environment variable: " + "($help)--entrypoint=[Overwrite the default entrypoint of the image]:entry point: " + "($help)*--env-file=[Read environment variables from a file]:environment file:_files" + "($help)*--expose=[Expose a port from the container without publishing it]: " + "($help)*--group-add=[Add additional groups to run as]:group:_groups" + "($help -h --hostname)"{-h,--hostname=}"[Container host name]:hostname:_hosts" + "($help -i --interactive)"{-i,--interactive}"[Keep stdin open even if not attached]" + "($help)--ipc=[IPC namespace to use]:IPC namespace: " + "($help)--kernel-memory[Kernel memory limit in bytes.]:Memory limit: " + "($help)*--link=[Add link to another container]:link:->link" + "($help)*"{-l,--label=}"[Set meta data on a container]:label: " + "($help)--log-driver=[Default driver for container logs]:Logging driver:(json-file syslog journald gelf fluentd awslogs none)" + "($help)*--log-opt=[Log driver specific options]:log driver options: " + "($help)*--lxc-conf=[Add custom lxc options]:lxc options: " + "($help)--mac-address=[Container MAC address]:MAC address: " + "($help)--name=[Container name]:name: " + "($help)--net=[Connect a container to a network]:network mode:(bridge none container host)" + "($help)--oom-kill-disable[Disable OOM Killer]" + "($help -P --publish-all)"{-P,--publish-all}"[Publish all exposed ports]" + "($help)*"{-p,--publish=}"[Expose a container's port to the host]:port:_ports" + "($help)--pid=[PID namespace to use]:PID: " + "($help)--privileged[Give extended privileges to this container]" + "($help)--read-only[Mount the container's root filesystem as read only]" + "($help)--restart=[Restart policy]:restart policy:(no on-failure always unless-stopped)" + "($help)*--security-opt=[Security options]:security option: " + "($help -t --tty)"{-t,--tty}"[Allocate a pseudo-tty]" + "($help -u --user)"{-u,--user=}"[Username or UID]:user:_users" + "($help)*-v[Bind mount a volume]:volume: " + "($help)--volume-driver=[Optional volume driver for the container]:volume driver:(local)" + "($help)*--volumes-from=[Mount volumes from the specified container]:volume: " + "($help -w --workdir)"{-w,--workdir=}"[Working directory inside the container]:directory:_directories" + ) + + case "$words[1]" in + (attach) + _arguments \ + $opts_help \ + "($help)--no-stdin[Do not attach stdin]" \ + "($help)--sig-proxy[Proxy all received signals to the process (non-TTY mode only)]" \ + "($help -):containers:__docker_runningcontainers" && ret=0 + ;; + (build) + _arguments \ + $opts_help \ + $opts_cpumemlimit \ + "($help)*--build-arg[Set build-time variables]:=: " \ + "($help -f --file)"{-f,--file=}"[Name of the Dockerfile]:Dockerfile:_files" \ + "($help)--force-rm[Always remove intermediate containers]" \ + "($help)--no-cache[Do not use cache when building the image]" \ + "($help)--pull[Attempt to pull a newer version of the image]" \ + "($help -q --quiet)"{-q,--quiet}"[Suppress verbose build output]" \ + "($help)--rm[Remove intermediate containers after a successful build]" \ + "($help -t --tag)"{-t,--tag=}"[Repository, name and tag for the image]: :__docker_repositories_with_tags" \ + "($help -):path or URL:_directories" && ret=0 + ;; + (commit) + _arguments \ + $opts_help \ + "($help -a --author)"{-a,--author=}"[Author]:author: " \ + "($help)*"{-c,--change=}"[Apply Dockerfile instruction to the created image]:Dockerfile:_files" \ + "($help -m --message)"{-m,--message=}"[Commit message]:message: " \ + "($help -p --pause)"{-p,--pause}"[Pause container during commit]" \ + "($help -):container:__docker_containers" \ + "($help -): :__docker_repositories_with_tags" && ret=0 + ;; + (cp) + _arguments \ + $opts_help \ + "($help -)1:container:->container" \ + "($help -)2:hostpath:_files" && ret=0 + case $state in + (container) + if compset -P "*:"; then + _files && ret=0 + else + __docker_containers -qS ":" && ret=0 + fi + ;; + esac + ;; + (create) + _arguments \ + $opts_help \ + $opts_cpumemlimit \ + $opts_create \ + "($help -): :__docker_images" \ + "($help -):command: _command_names -e" \ + "($help -)*::arguments: _normal" && ret=0 + + case $state in + (link) + if compset -P "*:"; then + _wanted alias expl "Alias" compadd -E "" && ret=0 + else + __docker_runningcontainers -qS ":" && ret=0 + fi + ;; + esac + + ;; + (daemon) + _arguments \ + $opts_help \ + "($help)--api-cors-header=[Set CORS headers in the remote API]:CORS headers: " \ + "($help -b --bridge)"{-b,--bridge=}"[Attach containers to a network bridge]:bridge:_net_interfaces" \ + "($help)--bip=[Specify network bridge IP]" \ + "($help -D --debug)"{-D,--debug}"[Enable debug mode]" \ + "($help)--default-gateway[Container default gateway IPv4 address]:IPv4 address: " \ + "($help)--default-gateway-v6[Container default gateway IPv6 address]:IPv6 address: " \ + "($help)--cluster-store=[URL of the distributed storage backend]:Cluster Store:->cluster-store" \ + "($help)--cluster-advertise=[Address of the daemon instance to advertise]:Instance to advertise (host\:port): " \ + "($help)*--cluster-store-opt[Set cluster options]:Cluster options:->cluster-store-options" \ + "($help)*--dns=[DNS server to use]:DNS: " \ + "($help)*--dns-search=[DNS search domains to use]:DNS search: " \ + "($help)*--dns-opt=[DNS options to use]:DNS option: " \ + "($help)*--default-ulimit=[Set default ulimit settings for containers]:ulimit: " \ + "($help)--disable-legacy-registry[Do not contact legacy registries]" \ + "($help -e --exec-driver)"{-e,--exec-driver=}"[Exec driver to use]:driver:(native lxc windows)" \ + "($help)*--exec-opt=[Set exec driver options]:exec driver options: " \ + "($help)--exec-root=[Root of the Docker execdriver]:path:_directories" \ + "($help)--fixed-cidr=[IPv4 subnet for fixed IPs]:IPv4 subnet: " \ + "($help)--fixed-cidr-v6=[IPv6 subnet for fixed IPs]:IPv6 subnet: " \ + "($help -G --group)"{-G,--group=}"[Group for the unix socket]:group:_groups" \ + "($help -g --graph)"{-g,--graph=}"[Root of the Docker runtime]:path:_directories" \ + "($help -H --host)"{-H,--host=}"[tcp://host:port to bind/connect to]:host: " \ + "($help)--icc[Enable inter-container communication]" \ + "($help)*--insecure-registry=[Enable insecure registry communication]:registry: " \ + "($help)--ip=[Default IP when binding container ports]" \ + "($help)--ip-forward[Enable net.ipv4.ip_forward]" \ + "($help)--ip-masq[Enable IP masquerading]" \ + "($help)--iptables[Enable addition of iptables rules]" \ + "($help)--ipv6[Enable IPv6 networking]" \ + "($help -l --log-level)"{-l,--log-level=}"[Set the logging level]:level:(debug info warn error fatal)" \ + "($help)*--label=[Set key=value labels to the daemon]:label: " \ + "($help)--log-driver=[Default driver for container logs]:Logging driver:(json-file syslog journald gelf fluentd awslogs none)" \ + "($help)*--log-opt=[Log driver specific options]:log driver options: " \ + "($help)--mtu=[Set the containers network MTU]:mtu:(0 576 1420 1500 9000)" \ + "($help -p --pidfile)"{-p,--pidfile=}"[Path to use for daemon PID file]:PID file:_files" \ + "($help)*--registry-mirror=[Preferred Docker registry mirror]:registry mirror: " \ + "($help -s --storage-driver)"{-s,--storage-driver=}"[Storage driver to use]:driver:(aufs devicemapper btrfs zfs overlay)" \ + "($help)--selinux-enabled[Enable selinux support]" \ + "($help)*--storage-opt=[Set storage driver options]:storage driver options: " \ + "($help)--tls[Use TLS]" \ + "($help)--tlscacert=[Trust certs signed only by this CA]:PEM file:_files -g "*.(pem|crt)"" \ + "($help)--tlscert=[Path to TLS certificate file]:PEM file:_files -g "*.(pem|crt)"" \ + "($help)--tlskey=[Path to TLS key file]:Key file:_files -g "*.(pem|key)"" \ + "($help)--tlsverify[Use TLS and verify the remote]" \ + "($help)--userland-proxy[Use userland proxy for loopback traffic]" && ret=0 + + case $state in + (cluster-store) + if compset -P '*://'; then + _message 'host:port' && ret=0 + else + store=('consul' 'etcd' 'zk') + _describe -t cluster-store "Cluster Store" store -qS "://" && ret=0 + fi + ;; + (cluster-store-options) + if compset -P '*='; then + _files && ret=0 + else + opts=('kv.cacertfile' 'kv.certfile' 'kv.keyfile') + _describe -t cluster-store-opts "Cluster Store Options" opts -qS "=" && ret=0 + fi + ;; + esac + ;; + (diff) + _arguments \ + $opts_help \ + "($help -)*:containers:__docker_containers" && ret=0 + ;; + (events) + _arguments \ + $opts_help \ + "($help)*"{-f,--filter=}"[Filter values]:filter: " \ + "($help)--since=[Events created since this timestamp]:timestamp: " \ + "($help)--until=[Events created until this timestamp]:timestamp: " && ret=0 + ;; + (exec) + local state + _arguments \ + $opts_help \ + "($help -d --detach)"{-d,--detach}"[Detached mode: leave the container running in the background]" \ + "($help -i --interactive)"{-i,--interactive}"[Keep stdin open even if not attached]" \ + "($help)--privileged[Give extended Linux capabilities to the command]" \ + "($help -t --tty)"{-t,--tty}"[Allocate a pseudo-tty]" \ + "($help -u --user)"{-u,--user=}"[Username or UID]:user:_users" \ + "($help -):containers:__docker_runningcontainers" \ + "($help -)*::command:->anycommand" && ret=0 + + case $state in + (anycommand) + shift 1 words + (( CURRENT-- )) + _normal && ret=0 + ;; + esac + ;; + (export) + _arguments \ + $opts_help \ + "($help -o --output)"{-o,--output=}"[Write to a file, instead of stdout]:output file:_files" \ + "($help -)*:containers:__docker_containers" && ret=0 + ;; + (history) + _arguments \ + $opts_help \ + "($help -H --human)"{-H,--human}"[Print sizes and dates in human readable format]" \ + "($help)--no-trunc[Do not truncate output]" \ + "($help -q --quiet)"{-q,--quiet}"[Only show numeric IDs]" \ + "($help -)*: :__docker_images" && ret=0 + ;; + (images) + _arguments \ + $opts_help \ + "($help -a --all)"{-a,--all}"[Show all images]" \ + "($help)--digest[Show digests]" \ + "($help)*"{-f,--filter=}"[Filter values]:filter: " \ + "($help)--no-trunc[Do not truncate output]" \ + "($help -q --quiet)"{-q,--quiet}"[Only show numeric IDs]" \ + "($help -): :__docker_repositories" && ret=0 + ;; + (import) + _arguments \ + $opts_help \ + "($help)*"{-c,--change=}"[Apply Dockerfile instruction to the created image]:Dockerfile:_files" \ + "($help -m --message)"{-m,--message=}"[Set commit message for imported image]:message: " \ + "($help -):URL:(- http:// file://)" \ + "($help -): :__docker_repositories_with_tags" && ret=0 + ;; + (info|version) + _arguments \ + $opts_help && ret=0 + ;; + (inspect) + local state + _arguments \ + $opts_help \ + "($help -f --format)"{-f,--format=}"[Format the output using the given go template]:template: " \ + "($help -s --size)"{-s,--size}"[Display total file sizes if the type is container]" \ + "($help)--type=[Return JSON for specified type]:type:(image container)" \ + "($help -)*: :->values" && ret=0 + + case $state in + (values) + if [[ ${words[(r)--type=container]} == --type=container ]]; then + __docker_containers && ret=0 + elif [[ ${words[(r)--type=image]} == --type=image ]]; then + __docker_images && ret=0 + else + __docker_images && __docker_containers && ret=0 + fi + ;; + esac + ;; + (kill) + _arguments \ + $opts_help \ + "($help -s --signal)"{-s,--signal=}"[Signal to send]:signal:_signals" \ + "($help -)*:containers:__docker_runningcontainers" && ret=0 + ;; + (load) + _arguments \ + $opts_help \ + "($help -i --input)"{-i,--input=}"[Read from tar archive file]:archive file:_files -g "*.((tar|TAR)(.gz|.GZ|.Z|.bz2|.lzma|.xz|)|(tbz|tgz|txz))(-.)"" && ret=0 + ;; + (login) + _arguments \ + $opts_help \ + "($help -e --email)"{-e,--email=}"[Email]:email: " \ + "($help -p --password)"{-p,--password=}"[Password]:password: " \ + "($help -u --user)"{-u,--user=}"[Username]:username: " \ + "($help -)1:server: " && ret=0 + ;; + (logout) + _arguments \ + $opts_help \ + "($help -)1:server: " && ret=0 + ;; + (logs) + _arguments \ + $opts_help \ + "($help -f --follow)"{-f,--follow}"[Follow log output]" \ + "($help -s --since)"{-s,--since=}"[Show logs since this timestamp]:timestamp: " \ + "($help -t --timestamps)"{-t,--timestamps}"[Show timestamps]" \ + "($help)--tail=[Output the last K lines]:lines:(1 10 20 50 all)" \ + "($help -)*:containers:__docker_containers" && ret=0 + ;; + (network) + local curcontext="$curcontext" state + _arguments \ + $opts_help \ + "($help -): :->command" \ + "($help -)*:: :->option-or-argument" && ret=0 + + case $state in + (command) + __docker_network_commands && ret=0 + ;; + (option-or-argument) + curcontext=${curcontext%:*:*}:docker-${words[-1]}: + __docker_network_subcommand && ret=0 + ;; + esac + ;; + (pause|unpause) + _arguments \ + $opts_help \ + "($help -)*:containers:__docker_runningcontainers" && ret=0 + ;; + (port) + _arguments \ + $opts_help \ + "($help -)1:containers:__docker_runningcontainers" \ + "($help -)2:port:_ports" && ret=0 + ;; + (ps) + _arguments \ + $opts_help \ + "($help -a --all)"{-a,--all}"[Show all containers]" \ + "($help)--before=[Show only container created before...]:containers:__docker_containers" \ + "($help)*"{-f,--filter=}"[Filter values]:filter: " \ + "($help)--format[Pretty-print containers using a Go template]:format: " \ + "($help -l --latest)"{-l,--latest}"[Show only the latest created container]" \ + "($help)-n[Show n last created containers, include non-running one]:n:(1 5 10 25 50)" \ + "($help)--no-trunc[Do not truncate output]" \ + "($help -q --quiet)"{-q,--quiet}"[Only show numeric IDs]" \ + "($help -s --size)"{-s,--size}"[Display total file sizes]" \ + "($help)--since=[Show only containers created since...]:containers:__docker_containers" && ret=0 + ;; + (pull) + _arguments \ + $opts_help \ + "($help -a --all-tags)"{-a,--all-tags}"[Download all tagged images]" \ + "($help -):name:__docker_search" && ret=0 + ;; + (push) + _arguments \ + $opts_help \ + "($help -): :__docker_images" && ret=0 + ;; + (rename) + _arguments \ + $opts_help \ + "($help -):old name:__docker_containers" \ + "($help -):new name: " && ret=0 + ;; + (restart|stop) + _arguments \ + $opts_help \ + "($help -t --time)"{-t,--time=}"[Number of seconds to try to stop for before killing the container]:seconds to before killing:(1 5 10 30 60)" \ + "($help -)*:containers:__docker_runningcontainers" && ret=0 + ;; + (rm) + _arguments \ + $opts_help \ + "($help -f --force)"{-f,--force}"[Force removal]" \ + "($help -l --link)"{-l,--link}"[Remove the specified link and not the underlying container]" \ + "($help -v --volumes)"{-v,--volumes}"[Remove the volumes associated to the container]" \ + "($help -)*:containers:__docker_stoppedcontainers" && ret=0 + ;; + (rmi) + _arguments \ + $opts_help \ + "($help -f --force)"{-f,--force}"[Force removal]" \ + "($help)--no-prune[Do not delete untagged parents]" \ + "($help -)*: :__docker_images" && ret=0 + ;; + (run) + _arguments \ + $opts_help \ + $opts_cpumemlimit \ + $opts_create \ + "($help -d --detach)"{-d,--detach}"[Detached mode: leave the container running in the background]" \ + "($help)--rm[Remove intermediate containers when it exits]" \ + "($help)--sig-proxy[Proxy all received signals to the process (non-TTY mode only)]" \ + "($help)--stop-signal=[Signal to kill a container]:signal:_signals" \ + "($help -): :__docker_images" \ + "($help -):command: _command_names -e" \ + "($help -)*::arguments: _normal" && ret=0 + + case $state in + (link) + if compset -P "*:"; then + _wanted alias expl "Alias" compadd -E "" && ret=0 + else + __docker_runningcontainers -qS ":" && ret=0 + fi + ;; + esac + + ;; + (save) + _arguments \ + $opts_help \ + "($help -o --output)"{-o,--output=}"[Write to file]:file:_files" \ + "($help -)*: :__docker_images" && ret=0 + ;; + (search) + _arguments \ + $opts_help \ + "($help)--automated[Only show automated builds]" \ + "($help)--no-trunc[Do not truncate output]" \ + "($help -s --stars)"{-s,--stars=}"[Only display with at least X stars]:stars:(0 10 100 1000)" \ + "($help -):term: " && ret=0 + ;; + (start) + _arguments \ + $opts_help \ + "($help -a --attach)"{-a,--attach}"[Attach container's stdout/stderr and forward all signals]" \ + "($help -i --interactive)"{-i,--interactive}"[Attach container's stding]" \ + "($help -)*:containers:__docker_stoppedcontainers" && ret=0 + ;; + (stats) + _arguments \ + $opts_help \ + "($help)--no-stream[Disable streaming stats and only pull the first result]" \ + "($help -)*:containers:__docker_runningcontainers" && ret=0 + ;; + (tag) + _arguments \ + $opts_help \ + "($help -f --force)"{-f,--force}"[force]"\ + "($help -):source:__docker_images"\ + "($help -):destination:__docker_repositories_with_tags" && ret=0 + ;; + (top) + _arguments \ + $opts_help \ + "($help -)1:containers:__docker_runningcontainers" \ + "($help -)*:: :->ps-arguments" && ret=0 + case $state in + (ps-arguments) + _ps && ret=0 + ;; + esac + + ;; + (volume) + local curcontext="$curcontext" state + _arguments \ + $opts_help \ + "($help -): :->command" \ + "($help -)*:: :->option-or-argument" && ret=0 + + case $state in + (command) + __docker_volume_commands && ret=0 + ;; + (option-or-argument) + curcontext=${curcontext%:*:*}:docker-${words[-1]}: + __docker_volume_subcommand && ret=0 + ;; + esac + ;; + (wait) + _arguments \ + $opts_help \ + "($help -)*:containers:__docker_runningcontainers" && ret=0 + ;; + (help) + _arguments ":subcommand:__docker_commands" && ret=0 + ;; + esac + + return ret +} + +_docker() { + # Support for subservices, which allows for `compdef _docker docker-shell=_docker_containers`. + # Based on /usr/share/zsh/functions/Completion/Unix/_git without support for `ret`. + if [[ $service != docker ]]; then + _call_function - _$service + return + fi + + local curcontext="$curcontext" state line help="-h --help" + integer ret=1 + typeset -A opt_args + + _arguments -C \ + "(: -)"{-h,--help}"[Print usage]" \ + "($help)--config[Location of client config files]:path:_directories" \ + "($help -D --debug)"{-D,--debug}"[Enable debug mode]" \ + "($help -H --host)"{-H,--host=}"[tcp://host:port to bind/connect to]:host: " \ + "($help -l --log-level)"{-l,--log-level=}"[Set the logging level]:level:(debug info warn error fatal)" \ + "($help)--tls[Use TLS]" \ + "($help)--tlscacert=[Trust certs signed only by this CA]:PEM file:_files -g "*.(pem|crt)"" \ + "($help)--tlscert=[Path to TLS certificate file]:PEM file:_files -g "*.(pem|crt)"" \ + "($help)--tlskey=[Path to TLS key file]:Key file:_files -g "*.(pem|key)"" \ + "($help)--tlsverify[Use TLS and verify the remote]" \ + "($help)--userland-proxy[Use userland proxy for loopback traffic]" \ + "($help -v --version)"{-v,--version}"[Print version information and quit]" \ + "($help -): :->command" \ + "($help -)*:: :->option-or-argument" && ret=0 + + local host=${opt_args[-H]}${opt_args[--host]} + local config=${opt_args[--config]} + local docker_options="${host:+--host $host} ${config:+--config $config}" + + case $state in + (command) + __docker_commands && ret=0 + ;; + (option-or-argument) + curcontext=${curcontext%:*:*}:docker-$words[1]: + __docker_subcommand && ret=0 + ;; + esac + + return ret +} + +_docker "$@" + +# Local Variables: +# mode: Shell-Script +# sh-indentation: 4 +# indent-tabs-mode: nil +# sh-basic-offset: 4 +# End: +# vim: ft=zsh sw=4 ts=4 et diff --git a/contrib/desktop-integration/README.md b/contrib/desktop-integration/README.md new file mode 100644 index 0000000000..85a01b9ee9 --- /dev/null +++ b/contrib/desktop-integration/README.md @@ -0,0 +1,11 @@ +Desktop Integration +=================== + +The ./contrib/desktop-integration contains examples of typical dockerized +desktop applications. + +Examples +======== + +* Chromium: ./chromium/Dockerfile shows a way to dockerize a common application +* Gparted: ./gparted/Dockerfile shows a way to dockerize a common application w devices diff --git a/contrib/desktop-integration/chromium/Dockerfile b/contrib/desktop-integration/chromium/Dockerfile new file mode 100644 index 0000000000..5cacd1f999 --- /dev/null +++ b/contrib/desktop-integration/chromium/Dockerfile @@ -0,0 +1,36 @@ +# VERSION: 0.1 +# DESCRIPTION: Create chromium container with its dependencies +# AUTHOR: Jessica Frazelle +# COMMENTS: +# This file describes how to build a Chromium container with all +# dependencies installed. It uses native X11 unix socket. +# Tested on Debian Jessie +# USAGE: +# # Download Chromium Dockerfile +# wget http://raw.githubusercontent.com/docker/docker/master/contrib/desktop-integration/chromium/Dockerfile +# +# # Build chromium image +# docker build -t chromium . +# +# # Run stateful data-on-host chromium. For ephemeral, remove -v /data/chromium:/data +# docker run -v /data/chromium:/data -v /tmp/.X11-unix:/tmp/.X11-unix \ +# -e DISPLAY=unix$DISPLAY chromium + +# # To run stateful dockerized data containers +# docker run --volumes-from chromium-data -v /tmp/.X11-unix:/tmp/.X11-unix \ +# -e DISPLAY=unix$DISPLAY chromium + +# Base docker image +FROM debian:jessie +MAINTAINER Jessica Frazelle + +# Install Chromium +RUN apt-get update && apt-get install -y \ + chromium \ + chromium-l10n \ + libcanberra-gtk-module \ + libexif-dev \ + --no-install-recommends + +# Autorun chromium +CMD ["/usr/bin/chromium", "--no-sandbox", "--user-data-dir=/data"] diff --git a/contrib/desktop-integration/gparted/Dockerfile b/contrib/desktop-integration/gparted/Dockerfile new file mode 100644 index 0000000000..3ddb23208d --- /dev/null +++ b/contrib/desktop-integration/gparted/Dockerfile @@ -0,0 +1,31 @@ +# VERSION: 0.1 +# DESCRIPTION: Create gparted container with its dependencies +# AUTHOR: Jessica Frazelle +# COMMENTS: +# This file describes how to build a gparted container with all +# dependencies installed. It uses native X11 unix socket. +# Tested on Debian Jessie +# USAGE: +# # Download gparted Dockerfile +# wget http://raw.githubusercontent.com/docker/docker/master/contrib/desktop-integration/gparted/Dockerfile +# +# # Build gparted image +# docker build -t gparted . +# +# docker run -v /tmp/.X11-unix:/tmp/.X11-unix \ +# --device=/dev/sda:/dev/sda \ +# -e DISPLAY=unix$DISPLAY gparted +# + +# Base docker image +FROM debian:jessie +MAINTAINER Jessica Frazelle + +# Install Gparted and its dependencies +RUN apt-get update && apt-get install -y \ + gparted \ + libcanberra-gtk-module \ + --no-install-recommends + +# Autorun gparted +CMD ["/usr/sbin/gparted"] diff --git a/contrib/docker-device-tool/device_tool.go b/contrib/docker-device-tool/device_tool.go new file mode 100644 index 0000000000..0a0b0803d3 --- /dev/null +++ b/contrib/docker-device-tool/device_tool.go @@ -0,0 +1,174 @@ +package main + +import ( + "flag" + "fmt" + "os" + "path" + "sort" + "strconv" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/graphdriver/devmapper" + "github.com/docker/docker/pkg/devicemapper" +) + +func usage() { + fmt.Fprintf(os.Stderr, "Usage: %s [status] | [list] | [device id] | [resize new-pool-size] | [snap new-id base-id] | [remove id] | [mount id mountpoint]\n", os.Args[0]) + flag.PrintDefaults() + os.Exit(1) +} + +func byteSizeFromString(arg string) (int64, error) { + digits := "" + rest := "" + last := strings.LastIndexAny(arg, "0123456789") + if last >= 0 { + digits = arg[:last+1] + rest = arg[last+1:] + } + + val, err := strconv.ParseInt(digits, 10, 64) + if err != nil { + return val, err + } + + rest = strings.ToLower(strings.TrimSpace(rest)) + + var multiplier int64 = 1 + switch rest { + case "": + multiplier = 1 + case "k", "kb": + multiplier = 1024 + case "m", "mb": + multiplier = 1024 * 1024 + case "g", "gb": + multiplier = 1024 * 1024 * 1024 + case "t", "tb": + multiplier = 1024 * 1024 * 1024 * 1024 + default: + return 0, fmt.Errorf("Unknown size unit: %s", rest) + } + + return val * multiplier, nil +} + +func main() { + root := flag.String("r", "/var/lib/docker", "Docker root dir") + flDebug := flag.Bool("D", false, "Debug mode") + + flag.Parse() + + if *flDebug { + os.Setenv("DEBUG", "1") + logrus.SetLevel(logrus.DebugLevel) + } + + if flag.NArg() < 1 { + usage() + } + + args := flag.Args() + + home := path.Join(*root, "devicemapper") + devices, err := devmapper.NewDeviceSet(home, false, nil) + if err != nil { + fmt.Println("Can't initialize device mapper: ", err) + os.Exit(1) + } + + switch args[0] { + case "status": + status := devices.Status() + fmt.Printf("Pool name: %s\n", status.PoolName) + fmt.Printf("Data Loopback file: %s\n", status.DataLoopback) + fmt.Printf("Metadata Loopback file: %s\n", status.MetadataLoopback) + fmt.Printf("Sector size: %d\n", status.SectorSize) + fmt.Printf("Data use: %d of %d (%.1f %%)\n", status.Data.Used, status.Data.Total, 100.0*float64(status.Data.Used)/float64(status.Data.Total)) + fmt.Printf("Metadata use: %d of %d (%.1f %%)\n", status.Metadata.Used, status.Metadata.Total, 100.0*float64(status.Metadata.Used)/float64(status.Metadata.Total)) + break + case "list": + ids := devices.List() + sort.Strings(ids) + for _, id := range ids { + fmt.Println(id) + } + break + case "device": + if flag.NArg() < 2 { + usage() + } + status, err := devices.GetDeviceStatus(args[1]) + if err != nil { + fmt.Println("Can't get device info: ", err) + os.Exit(1) + } + fmt.Printf("Id: %d\n", status.DeviceId) + fmt.Printf("Size: %d\n", status.Size) + fmt.Printf("Transaction Id: %d\n", status.TransactionId) + fmt.Printf("Size in Sectors: %d\n", status.SizeInSectors) + fmt.Printf("Mapped Sectors: %d\n", status.MappedSectors) + fmt.Printf("Highest Mapped Sector: %d\n", status.HighestMappedSector) + break + case "resize": + if flag.NArg() < 2 { + usage() + } + + size, err := byteSizeFromString(args[1]) + if err != nil { + fmt.Println("Invalid size: ", err) + os.Exit(1) + } + + err = devices.ResizePool(size) + if err != nil { + fmt.Println("Error resizing pool: ", err) + os.Exit(1) + } + + break + case "snap": + if flag.NArg() < 3 { + usage() + } + + err := devices.AddDevice(args[1], args[2]) + if err != nil { + fmt.Println("Can't create snap device: ", err) + os.Exit(1) + } + break + case "remove": + if flag.NArg() < 2 { + usage() + } + + err := devicemapper.RemoveDevice(args[1]) + if err != nil { + fmt.Println("Can't remove device: ", err) + os.Exit(1) + } + break + case "mount": + if flag.NArg() < 3 { + usage() + } + + err := devices.MountDevice(args[1], args[2], "") + if err != nil { + fmt.Println("Can't create snap device: ", err) + os.Exit(1) + } + break + default: + fmt.Printf("Unknown command %s\n", args[0]) + usage() + + os.Exit(1) + } + + return +} diff --git a/contrib/docker-engine-selinux/LICENSE b/contrib/docker-engine-selinux/LICENSE new file mode 100644 index 0000000000..4362b49151 --- /dev/null +++ b/contrib/docker-engine-selinux/LICENSE @@ -0,0 +1,502 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 2.1, February 1999 + + Copyright (C) 1991, 1999 Free Software Foundation, Inc. + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +[This is the first released version of the Lesser GPL. It also counts + as the successor of the GNU Library Public License, version 2, hence + the version number 2.1.] + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +Licenses are intended to guarantee your freedom to share and change +free software--to make sure the software is free for all its users. + + This license, the Lesser General Public License, applies to some +specially designated software packages--typically libraries--of the +Free Software Foundation and other authors who decide to use it. You +can use it too, but we suggest you first think carefully about whether +this license or the ordinary General Public License is the better +strategy to use in any particular case, based on the explanations below. + + When we speak of free software, we are referring to freedom of use, +not price. Our General Public Licenses are designed to make sure that +you have the freedom to distribute copies of free software (and charge +for this service if you wish); that you receive source code or can get +it if you want it; that you can change the software and use pieces of +it in new free programs; and that you are informed that you can do +these things. + + To protect your rights, we need to make restrictions that forbid +distributors to deny you these rights or to ask you to surrender these +rights. These restrictions translate to certain responsibilities for +you if you distribute copies of the library or if you modify it. + + For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link other code with the library, you must provide +complete object files to the recipients, so that they can relink them +with the library after making changes to the library and recompiling +it. And you must show them these terms so they know their rights. + + We protect your rights with a two-step method: (1) we copyright the +library, and (2) we offer you this license, which gives you legal +permission to copy, distribute and/or modify the library. + + To protect each distributor, we want to make it very clear that +there is no warranty for the free library. Also, if the library is +modified by someone else and passed on, the recipients should know +that what they have is not the original version, so that the original +author's reputation will not be affected by problems that might be +introduced by others. + + Finally, software patents pose a constant threat to the existence of +any free program. We wish to make sure that a company cannot +effectively restrict the users of a free program by obtaining a +restrictive license from a patent holder. Therefore, we insist that +any patent license obtained for a version of the library must be +consistent with the full freedom of use specified in this license. + + Most GNU software, including some libraries, is covered by the +ordinary GNU General Public License. This license, the GNU Lesser +General Public License, applies to certain designated libraries, and +is quite different from the ordinary General Public License. We use +this license for certain libraries in order to permit linking those +libraries into non-free programs. + + When a program is linked with a library, whether statically or using +a shared library, the combination of the two is legally speaking a +combined work, a derivative of the original library. The ordinary +General Public License therefore permits such linking only if the +entire combination fits its criteria of freedom. The Lesser General +Public License permits more lax criteria for linking other code with +the library. + + We call this license the "Lesser" General Public License because it +does Less to protect the user's freedom than the ordinary General +Public License. It also provides other free software developers Less +of an advantage over competing non-free programs. These disadvantages +are the reason we use the ordinary General Public License for many +libraries. However, the Lesser license provides advantages in certain +special circumstances. + + For example, on rare occasions, there may be a special need to +encourage the widest possible use of a certain library, so that it becomes +a de-facto standard. To achieve this, non-free programs must be +allowed to use the library. A more frequent case is that a free +library does the same job as widely used non-free libraries. In this +case, there is little to gain by limiting the free library to free +software only, so we use the Lesser General Public License. + + In other cases, permission to use a particular library in non-free +programs enables a greater number of people to use a large body of +free software. For example, permission to use the GNU C Library in +non-free programs enables many more people to use the whole GNU +operating system, as well as its variant, the GNU/Linux operating +system. + + Although the Lesser General Public License is Less protective of the +users' freedom, it does ensure that the user of a program that is +linked with the Library has the freedom and the wherewithal to run +that program using a modified version of the Library. + + The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the library" and a "work that uses the library". The +former contains code derived from the library, whereas the latter must +be combined with the library in order to run. + + GNU LESSER GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License Agreement applies to any software library or other +program which contains a notice placed by the copyright holder or +other authorized party saying it may be distributed under the terms of +this Lesser General Public License (also called "this License"). +Each licensee is addressed as "you". + + A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables. + + The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".) + + "Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control compilation +and installation of the library. + + Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does +and what the program that uses the Library does. + + 1. You may copy and distribute verbatim copies of the Library's +complete source code as you receive it, in any medium, provided that +you conspicuously and appropriately publish on each copy an +appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the +Library. + + You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee. + + 2. You may modify your copy or copies of the Library or any portion +of it, thus forming a work based on the Library, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) The modified work must itself be a software library. + + b) You must cause the files modified to carry prominent notices + stating that you changed the files and the date of any change. + + c) You must cause the whole of the work to be licensed at no + charge to all third parties under the terms of this License. + + d) If a facility in the modified Library refers to a function or a + table of data to be supplied by an application program that uses + the facility, other than as an argument passed when the facility + is invoked, then you must make a good faith effort to ensure that, + in the event an application does not supply such function or + table, the facility still operates, and performs whatever part of + its purpose remains meaningful. + + (For example, a function in a library to compute square roots has + a purpose that is entirely well-defined independent of the + application. Therefore, Subsection 2d requires that any + application-supplied function or table used by this function must + be optional: if the application does not supply it, the square + root function must still compute square roots.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Library, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Library, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Library. + +In addition, mere aggregation of another work not based on the Library +with the Library (or with a work based on the Library) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may opt to apply the terms of the ordinary GNU General Public +License instead of this License to a given copy of the Library. To do +this, you must alter all the notices that refer to this License, so +that they refer to the ordinary GNU General Public License, version 2, +instead of to this License. (If a newer version than version 2 of the +ordinary GNU General Public License has appeared, then you can specify +that version instead if you wish.) Do not make any other change in +these notices. + + Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy. + + This option is useful when you wish to copy part of the code of +the Library into a program that is not a library. + + 4. You may copy and distribute the Library (or a portion or +derivative of it, under Section 2) in object code or executable form +under the terms of Sections 1 and 2 above provided that you accompany +it with the complete corresponding machine-readable source code, which +must be distributed under the terms of Sections 1 and 2 above on a +medium customarily used for software interchange. + + If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to +distribute the source code, even though third parties are not +compelled to copy the source along with the object code. + + 5. A program that contains no derivative of any portion of the +Library, but is designed to work with the Library by being compiled or +linked with it, is called a "work that uses the Library". Such a +work, in isolation, is not a derivative work of the Library, and +therefore falls outside the scope of this License. + + However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. +Section 6 states terms for distribution of such executables. + + When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law. + + If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.) + + Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, +whether or not they are linked directly with the Library itself. + + 6. As an exception to the Sections above, you may also combine or +link a "work that uses the Library" with the Library to produce a +work containing portions of the Library, and distribute that work +under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications. + + You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things: + + a) Accompany the work with the complete corresponding + machine-readable source code for the Library including whatever + changes were used in the work (which must be distributed under + Sections 1 and 2 above); and, if the work is an executable linked + with the Library, with the complete machine-readable "work that + uses the Library", as object code and/or source code, so that the + user can modify the Library and then relink to produce a modified + executable containing the modified Library. (It is understood + that the user who changes the contents of definitions files in the + Library will not necessarily be able to recompile the application + to use the modified definitions.) + + b) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (1) uses at run time a + copy of the library already present on the user's computer system, + rather than copying library functions into the executable, and (2) + will operate properly with a modified version of the library, if + the user installs one, as long as the modified version is + interface-compatible with the version that the work was made with. + + c) Accompany the work with a written offer, valid for at + least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more + than the cost of performing this distribution. + + d) If distribution of the work is made by offering access to copy + from a designated place, offer equivalent access to copy the above + specified materials from the same place. + + e) Verify that the user has already received a copy of these + materials or that you have already sent this user a copy. + + For an executable, the required form of the "work that uses the +Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the materials to be distributed need not include anything that is +normally distributed (in either source or binary form) with the major +components (compiler, kernel, and so on) of the operating system on +which the executable runs, unless that component itself accompanies +the executable. + + It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute. + + 7. You may place library facilities that are a work based on the +Library side-by-side in a single library together with other library +facilities not covered by this License, and distribute such a combined +library, provided that the separate distribution of the work based on +the Library and of the other library facilities is otherwise +permitted, and provided that you do these two things: + + a) Accompany the combined library with a copy of the same work + based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the + Sections above. + + b) Give prominent notice with the combined library of the fact + that part of it is a work based on the Library, and explaining + where to find the accompanying uncombined form of the same work. + + 8. You may not copy, modify, sublicense, link with, or distribute +the Library except as expressly provided under this License. Any +attempt otherwise to copy, modify, sublicense, link with, or +distribute the Library is void, and will automatically terminate your +rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses +terminated so long as such parties remain in full compliance. + + 9. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Library or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Library (or any work based on the +Library), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Library or works based on it. + + 10. Each time you redistribute the Library (or any work based on the +Library), the recipient automatically receives a license from the +original licensor to copy, distribute, link with or modify the Library +subject to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties with +this License. + + 11. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Library at all. For example, if a patent +license would not permit royalty-free redistribution of the Library by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Library. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply, +and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 12. If the distribution and/or use of the Library is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Library under this License may add +an explicit geographical distribution limitation excluding those countries, +so that distribution is permitted only in or among countries not thus +excluded. In such case, this License incorporates the limitation as if +written in the body of this License. + + 13. The Free Software Foundation may publish revised and/or new +versions of the Lesser General Public License from time to time. +Such new versions will be similar in spirit to the present version, +but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Library +specifies a version number of this License which applies to it and +"any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation. + + 14. If you wish to incorporate parts of the Library into other free +programs whose distribution conditions are incompatible with these, +write to the author to ask for permission. For software which is +copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally. + + NO WARRANTY + + 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO +WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY +KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN +WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY +AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU +FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR +CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Libraries + + If you develop a new library, and you want it to be of the greatest +possible use to the public, we recommend making it free software that +everyone can redistribute and change. You can do so by permitting +redistribution under these terms (or, alternatively, under the terms of the +ordinary General Public License). + + To apply these terms, attach the following notices to the library. It is +safest to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + +Also add information on how to contact you by electronic and paper mail. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the library, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the + library `Frob' (a library for tweaking knobs) written by James Random Hacker. + + , 1 April 1990 + Ty Coon, President of Vice + +That's all there is to it! diff --git a/contrib/docker-engine-selinux/Makefile b/contrib/docker-engine-selinux/Makefile new file mode 100644 index 0000000000..1bdc695afe --- /dev/null +++ b/contrib/docker-engine-selinux/Makefile @@ -0,0 +1,16 @@ +TARGETS?=docker +MODULES?=${TARGETS:=.pp.bz2} +SHAREDIR?=/usr/share + +all: ${TARGETS:=.pp.bz2} + +%.pp.bz2: %.pp + @echo Compressing $^ -\> $@ + bzip2 -9 $^ + +%.pp: %.te + make -f ${SHAREDIR}/selinux/devel/Makefile $@ + +clean: + rm -f *~ *.tc *.pp *.pp.bz2 + rm -rf tmp *.tar.gz diff --git a/contrib/docker-engine-selinux/docker.fc b/contrib/docker-engine-selinux/docker.fc new file mode 100644 index 0000000000..f240937c88 --- /dev/null +++ b/contrib/docker-engine-selinux/docker.fc @@ -0,0 +1,24 @@ +/root/\.docker gen_context(system_u:object_r:docker_home_t,s0) + +/usr/bin/docker -- gen_context(system_u:object_r:docker_exec_t,s0) + +/usr/lib/systemd/system/docker.service -- gen_context(system_u:object_r:docker_unit_file_t,s0) + +/etc/docker(/.*)? gen_context(system_u:object_r:docker_config_t,s0) + +/var/lib/docker(/.*)? gen_context(system_u:object_r:docker_var_lib_t,s0) +/var/lib/kublet(/.*)? gen_context(system_u:object_r:docker_var_lib_t,s0) +/var/lib/docker/vfs(/.*)? gen_context(system_u:object_r:svirt_sandbox_file_t,s0) + +/var/run/docker\.pid -- gen_context(system_u:object_r:docker_var_run_t,s0) +/var/run/docker\.sock -s gen_context(system_u:object_r:docker_var_run_t,s0) +/var/run/docker-client(/.*)? gen_context(system_u:object_r:docker_var_run_t,s0) + +/var/lock/lxc(/.*)? gen_context(system_u:object_r:docker_lock_t,s0) + +/var/log/lxc(/.*)? gen_context(system_u:object_r:docker_log_t,s0) + +/var/lib/docker/init(/.*)? gen_context(system_u:object_r:docker_share_t,s0) +/var/lib/docker/containers/.*/hosts gen_context(system_u:object_r:docker_share_t,s0) +/var/lib/docker/containers/.*/hostname gen_context(system_u:object_r:docker_share_t,s0) +/var/lib/docker/.*/config\.env gen_context(system_u:object_r:docker_share_t,s0) diff --git a/contrib/docker-engine-selinux/docker.if b/contrib/docker-engine-selinux/docker.if new file mode 100644 index 0000000000..28b47c8f6c --- /dev/null +++ b/contrib/docker-engine-selinux/docker.if @@ -0,0 +1,467 @@ + +## The open-source application container engine. + +######################################## +## +## Execute docker in the docker domain. +## +## +## +## Domain allowed to transition. +## +## +# +interface(`docker_domtrans',` + gen_require(` + type docker_t, docker_exec_t; + ') + + corecmd_search_bin($1) + domtrans_pattern($1, docker_exec_t, docker_t) +') + +######################################## +## +## Execute docker in the caller domain. +## +## +## +## Domain allowed to transition. +## +## +# +interface(`docker_exec',` + gen_require(` + type docker_exec_t; + ') + + corecmd_search_bin($1) + can_exec($1, docker_exec_t) +') + +######################################## +## +## Search docker lib directories. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_search_lib',` + gen_require(` + type docker_var_lib_t; + ') + + allow $1 docker_var_lib_t:dir search_dir_perms; + files_search_var_lib($1) +') + +######################################## +## +## Execute docker lib directories. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_exec_lib',` + gen_require(` + type docker_var_lib_t; + ') + + allow $1 docker_var_lib_t:dir search_dir_perms; + can_exec($1, docker_var_lib_t) +') + +######################################## +## +## Read docker lib files. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_read_lib_files',` + gen_require(` + type docker_var_lib_t; + ') + + files_search_var_lib($1) + read_files_pattern($1, docker_var_lib_t, docker_var_lib_t) +') + +######################################## +## +## Read docker share files. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_read_share_files',` + gen_require(` + type docker_share_t; + ') + + files_search_var_lib($1) + read_files_pattern($1, docker_share_t, docker_share_t) +') + +######################################## +## +## Manage docker lib files. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_manage_lib_files',` + gen_require(` + type docker_var_lib_t; + ') + + files_search_var_lib($1) + manage_files_pattern($1, docker_var_lib_t, docker_var_lib_t) + manage_lnk_files_pattern($1, docker_var_lib_t, docker_var_lib_t) +') + +######################################## +## +## Manage docker lib directories. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_manage_lib_dirs',` + gen_require(` + type docker_var_lib_t; + ') + + files_search_var_lib($1) + manage_dirs_pattern($1, docker_var_lib_t, docker_var_lib_t) +') + +######################################## +## +## Create objects in a docker var lib directory +## with an automatic type transition to +## a specified private type. +## +## +## +## Domain allowed access. +## +## +## +## +## The type of the object to create. +## +## +## +## +## The class of the object to be created. +## +## +## +## +## The name of the object being created. +## +## +# +interface(`docker_lib_filetrans',` + gen_require(` + type docker_var_lib_t; + ') + + filetrans_pattern($1, docker_var_lib_t, $2, $3, $4) +') + +######################################## +## +## Read docker PID files. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_read_pid_files',` + gen_require(` + type docker_var_run_t; + ') + + files_search_pids($1) + read_files_pattern($1, docker_var_run_t, docker_var_run_t) +') + +######################################## +## +## Execute docker server in the docker domain. +## +## +## +## Domain allowed to transition. +## +## +# +interface(`docker_systemctl',` + gen_require(` + type docker_t; + type docker_unit_file_t; + ') + + systemd_exec_systemctl($1) + init_reload_services($1) + systemd_read_fifo_file_passwd_run($1) + allow $1 docker_unit_file_t:file read_file_perms; + allow $1 docker_unit_file_t:service manage_service_perms; + + ps_process_pattern($1, docker_t) +') + +######################################## +## +## Read and write docker shared memory. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_rw_sem',` + gen_require(` + type docker_t; + ') + + allow $1 docker_t:sem rw_sem_perms; +') + +####################################### +## +## Read and write the docker pty type. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_use_ptys',` + gen_require(` + type docker_devpts_t; + ') + + allow $1 docker_devpts_t:chr_file rw_term_perms; +') + +####################################### +## +## Allow domain to create docker content +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_filetrans_named_content',` + + gen_require(` + type docker_var_lib_t; + type docker_share_t; + type docker_log_t; + type docker_var_run_t; + type docker_home_t; + ') + + files_pid_filetrans($1, docker_var_run_t, file, "docker.pid") + files_pid_filetrans($1, docker_var_run_t, sock_file, "docker.sock") + files_pid_filetrans($1, docker_var_run_t, dir, "docker-client") + logging_log_filetrans($1, docker_log_t, dir, "lxc") + files_var_lib_filetrans($1, docker_var_lib_t, dir, "docker") + filetrans_pattern($1, docker_var_lib_t, docker_share_t, file, "config.env") + filetrans_pattern($1, docker_var_lib_t, docker_share_t, file, "hosts") + filetrans_pattern($1, docker_var_lib_t, docker_share_t, file, "hostname") + filetrans_pattern($1, docker_var_lib_t, docker_share_t, file, "resolv.conf") + filetrans_pattern($1, docker_var_lib_t, docker_share_t, dir, "init") + userdom_admin_home_dir_filetrans($1, docker_home_t, dir, ".docker") +') + +######################################## +## +## Connect to docker over a unix stream socket. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_stream_connect',` + gen_require(` + type docker_t, docker_var_run_t; + ') + + files_search_pids($1) + stream_connect_pattern($1, docker_var_run_t, docker_var_run_t, docker_t) +') + +######################################## +## +## Connect to SPC containers over a unix stream socket. +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_spc_stream_connect',` + gen_require(` + type spc_t, spc_var_run_t; + ') + + files_search_pids($1) + files_write_all_pid_sockets($1) + allow $1 spc_t:unix_stream_socket connectto; +') + + +######################################## +## +## All of the rules required to administrate +## an docker environment +## +## +## +## Domain allowed access. +## +## +# +interface(`docker_admin',` + gen_require(` + type docker_t; + type docker_var_lib_t, docker_var_run_t; + type docker_unit_file_t; + type docker_lock_t; + type docker_log_t; + type docker_config_t; + ') + + allow $1 docker_t:process { ptrace signal_perms }; + ps_process_pattern($1, docker_t) + + admin_pattern($1, docker_config_t) + + files_search_var_lib($1) + admin_pattern($1, docker_var_lib_t) + + files_search_pids($1) + admin_pattern($1, docker_var_run_t) + + files_search_locks($1) + admin_pattern($1, docker_lock_t) + + logging_search_logs($1) + admin_pattern($1, docker_log_t) + + docker_systemctl($1) + admin_pattern($1, docker_unit_file_t) + allow $1 docker_unit_file_t:service all_service_perms; + + optional_policy(` + systemd_passwd_agent_exec($1) + systemd_read_fifo_file_passwd_run($1) + ') +') + +interface(`domain_stub_named_filetrans_domain',` + gen_require(` + attribute named_filetrans_domain; + ') +') + +interface(`lvm_stub',` + gen_require(` + type lvm_t; + ') +') +interface(`staff_stub',` + gen_require(` + type staff_t; + ') +') +interface(`virt_stub_lxc',` + gen_require(` + type virtd_lxc_t; + ') +') +interface(`virt_stub_svirt_sandbox_domain',` + gen_require(` + attribute svirt_sandbox_domain; + ') +') +interface(`virt_stub_svirt_sandbox_file',` + gen_require(` + type svirt_sandbox_file_t; + ') +') +interface(`fs_dontaudit_remount_tmpfs',` + gen_require(` + type tmpfs_t; + ') + + dontaudit $1 tmpfs_t:filesystem remount; +') +interface(`dev_dontaudit_list_all_dev_nodes',` + gen_require(` + type device_t; + ') + + dontaudit $1 device_t:dir list_dir_perms; +') +interface(`kernel_unlabeled_entry_type',` + gen_require(` + type unlabeled_t; + ') + + domain_entry_file($1, unlabeled_t) +') +interface(`kernel_unlabeled_domtrans',` + gen_require(` + type unlabeled_t; + ') + + read_lnk_files_pattern($1, unlabeled_t, unlabeled_t) + domain_transition_pattern($1, unlabeled_t, $2) + type_transition $1 unlabeled_t:process $2; +') +interface(`files_write_all_pid_sockets',` + gen_require(` + attribute pidfile; + ') + + allow $1 pidfile:sock_file write_sock_file_perms; +') +interface(`dev_dontaudit_mounton_sysfs',` + gen_require(` + type sysfs_t; + ') + + dontaudit $1 sysfs_t:dir mounton; +') diff --git a/contrib/docker-engine-selinux/docker.te b/contrib/docker-engine-selinux/docker.te new file mode 100644 index 0000000000..dc41f3a960 --- /dev/null +++ b/contrib/docker-engine-selinux/docker.te @@ -0,0 +1,418 @@ +policy_module(docker, 1.0.0) + +######################################## +# +# Declarations +# + +## +##

+## Allow sandbox containers manage fuse files +##

+## +gen_tunable(virt_sandbox_use_fusefs, false) + +## +##

+## Determine whether docker can +## connect to all TCP ports. +##

+## +gen_tunable(docker_connect_any, false) + +type docker_t; +type docker_exec_t; +init_daemon_domain(docker_t, docker_exec_t) +domain_subj_id_change_exemption(docker_t) +domain_role_change_exemption(docker_t) + +type spc_t; +domain_type(spc_t) +role system_r types spc_t; + +type spc_var_run_t; +files_pid_file(spc_var_run_t) + +type docker_var_lib_t; +files_type(docker_var_lib_t) + +type docker_home_t; +userdom_user_home_content(docker_home_t) + +type docker_config_t; +files_config_file(docker_config_t) + +type docker_lock_t; +files_lock_file(docker_lock_t) + +type docker_log_t; +logging_log_file(docker_log_t) + +type docker_tmp_t; +files_tmp_file(docker_tmp_t) + +type docker_tmpfs_t; +files_tmpfs_file(docker_tmpfs_t) + +type docker_var_run_t; +files_pid_file(docker_var_run_t) + +type docker_unit_file_t; +systemd_unit_file(docker_unit_file_t) + +type docker_devpts_t; +term_pty(docker_devpts_t) + +type docker_share_t; +files_type(docker_share_t) + +######################################## +# +# docker local policy +# +allow docker_t self:capability { chown kill fowner fsetid mknod net_admin net_bind_service net_raw setfcap }; +allow docker_t self:tun_socket relabelto; +allow docker_t self:process { getattr signal_perms setrlimit setfscreate }; +allow docker_t self:fifo_file rw_fifo_file_perms; +allow docker_t self:unix_stream_socket create_stream_socket_perms; +allow docker_t self:tcp_socket create_stream_socket_perms; +allow docker_t self:udp_socket create_socket_perms; +allow docker_t self:capability2 block_suspend; + +manage_files_pattern(docker_t, docker_home_t, docker_home_t) +manage_dirs_pattern(docker_t, docker_home_t, docker_home_t) +manage_lnk_files_pattern(docker_t, docker_home_t, docker_home_t) +userdom_admin_home_dir_filetrans(docker_t, docker_home_t, dir, ".docker") + +manage_dirs_pattern(docker_t, docker_config_t, docker_config_t) +manage_files_pattern(docker_t, docker_config_t, docker_config_t) +files_etc_filetrans(docker_t, docker_config_t, dir, "docker") + +manage_dirs_pattern(docker_t, docker_lock_t, docker_lock_t) +manage_files_pattern(docker_t, docker_lock_t, docker_lock_t) +files_lock_filetrans(docker_t, docker_lock_t, { dir file }, "lxc") + +manage_dirs_pattern(docker_t, docker_log_t, docker_log_t) +manage_files_pattern(docker_t, docker_log_t, docker_log_t) +manage_lnk_files_pattern(docker_t, docker_log_t, docker_log_t) +logging_log_filetrans(docker_t, docker_log_t, { dir file lnk_file }) +allow docker_t docker_log_t:dir_file_class_set { relabelfrom relabelto }; + +manage_dirs_pattern(docker_t, docker_tmp_t, docker_tmp_t) +manage_files_pattern(docker_t, docker_tmp_t, docker_tmp_t) +manage_lnk_files_pattern(docker_t, docker_tmp_t, docker_tmp_t) +files_tmp_filetrans(docker_t, docker_tmp_t, { dir file lnk_file }) + +manage_dirs_pattern(docker_t, docker_tmpfs_t, docker_tmpfs_t) +manage_files_pattern(docker_t, docker_tmpfs_t, docker_tmpfs_t) +manage_lnk_files_pattern(docker_t, docker_tmpfs_t, docker_tmpfs_t) +manage_fifo_files_pattern(docker_t, docker_tmpfs_t, docker_tmpfs_t) +manage_chr_files_pattern(docker_t, docker_tmpfs_t, docker_tmpfs_t) +manage_blk_files_pattern(docker_t, docker_tmpfs_t, docker_tmpfs_t) +allow docker_t docker_tmpfs_t:dir relabelfrom; +can_exec(docker_t, docker_tmpfs_t) +fs_tmpfs_filetrans(docker_t, docker_tmpfs_t, { dir file }) +allow docker_t docker_tmpfs_t:chr_file mounton; + +manage_dirs_pattern(docker_t, docker_share_t, docker_share_t) +manage_files_pattern(docker_t, docker_share_t, docker_share_t) +manage_lnk_files_pattern(docker_t, docker_share_t, docker_share_t) +allow docker_t docker_share_t:dir_file_class_set { relabelfrom relabelto }; + +can_exec(docker_t, docker_share_t) +#docker_filetrans_named_content(docker_t) + +manage_dirs_pattern(docker_t, docker_var_lib_t, docker_var_lib_t) +manage_chr_files_pattern(docker_t, docker_var_lib_t, docker_var_lib_t) +manage_blk_files_pattern(docker_t, docker_var_lib_t, docker_var_lib_t) +manage_files_pattern(docker_t, docker_var_lib_t, docker_var_lib_t) +manage_lnk_files_pattern(docker_t, docker_var_lib_t, docker_var_lib_t) +allow docker_t docker_var_lib_t:dir_file_class_set { relabelfrom relabelto }; +files_var_lib_filetrans(docker_t, docker_var_lib_t, { dir file lnk_file }) + +manage_dirs_pattern(docker_t, docker_var_run_t, docker_var_run_t) +manage_files_pattern(docker_t, docker_var_run_t, docker_var_run_t) +manage_sock_files_pattern(docker_t, docker_var_run_t, docker_var_run_t) +manage_lnk_files_pattern(docker_t, docker_var_run_t, docker_var_run_t) +files_pid_filetrans(docker_t, docker_var_run_t, { dir file lnk_file sock_file }) + +allow docker_t docker_devpts_t:chr_file { relabelfrom rw_chr_file_perms setattr_chr_file_perms }; +term_create_pty(docker_t, docker_devpts_t) + +kernel_read_system_state(docker_t) +kernel_read_network_state(docker_t) +kernel_read_all_sysctls(docker_t) +kernel_rw_net_sysctls(docker_t) +kernel_setsched(docker_t) +kernel_read_all_proc(docker_t) + +domain_use_interactive_fds(docker_t) +domain_dontaudit_read_all_domains_state(docker_t) + +corecmd_exec_bin(docker_t) +corecmd_exec_shell(docker_t) + +corenet_tcp_bind_generic_node(docker_t) +corenet_tcp_sendrecv_generic_if(docker_t) +corenet_tcp_sendrecv_generic_node(docker_t) +corenet_tcp_sendrecv_generic_port(docker_t) +corenet_tcp_bind_all_ports(docker_t) +corenet_tcp_connect_http_port(docker_t) +corenet_tcp_connect_commplex_main_port(docker_t) +corenet_udp_sendrecv_generic_if(docker_t) +corenet_udp_sendrecv_generic_node(docker_t) +corenet_udp_sendrecv_all_ports(docker_t) +corenet_udp_bind_generic_node(docker_t) +corenet_udp_bind_all_ports(docker_t) + +files_read_config_files(docker_t) +files_dontaudit_getattr_all_dirs(docker_t) +files_dontaudit_getattr_all_files(docker_t) + +fs_read_cgroup_files(docker_t) +fs_read_tmpfs_symlinks(docker_t) +fs_search_all(docker_t) +fs_getattr_all_fs(docker_t) + +storage_raw_rw_fixed_disk(docker_t) + +auth_use_nsswitch(docker_t) +auth_dontaudit_getattr_shadow(docker_t) + +init_read_state(docker_t) +init_status(docker_t) + +logging_send_audit_msgs(docker_t) +logging_send_syslog_msg(docker_t) + +miscfiles_read_localization(docker_t) + +mount_domtrans(docker_t) + +seutil_read_default_contexts(docker_t) +seutil_read_config(docker_t) + +sysnet_dns_name_resolve(docker_t) +sysnet_exec_ifconfig(docker_t) + +optional_policy(` + rpm_exec(docker_t) + rpm_read_db(docker_t) + rpm_exec(docker_t) +') + +optional_policy(` + fstools_domtrans(docker_t) +') + +optional_policy(` + iptables_domtrans(docker_t) +') + +optional_policy(` + openvswitch_stream_connect(docker_t) +') + +# +# lxc rules +# + +allow docker_t self:capability { dac_override setgid setpcap setuid sys_admin sys_boot sys_chroot sys_ptrace }; + +allow docker_t self:process { getcap setcap setexec setpgid setsched signal_perms }; + +allow docker_t self:netlink_route_socket rw_netlink_socket_perms;; +allow docker_t self:netlink_audit_socket create_netlink_socket_perms; +allow docker_t self:unix_dgram_socket { create_socket_perms sendto }; +allow docker_t self:unix_stream_socket { create_stream_socket_perms connectto }; + +allow docker_t docker_var_lib_t:dir mounton; +allow docker_t docker_var_lib_t:chr_file mounton; +can_exec(docker_t, docker_var_lib_t) + +kernel_dontaudit_setsched(docker_t) +kernel_get_sysvipc_info(docker_t) +kernel_request_load_module(docker_t) +kernel_mounton_messages(docker_t) +kernel_mounton_all_proc(docker_t) +kernel_mounton_all_sysctls(docker_t) +kernel_unlabeled_entry_type(spc_t) +kernel_unlabeled_domtrans(docker_t, spc_t) + +dev_getattr_all(docker_t) +dev_getattr_sysfs_fs(docker_t) +dev_read_urand(docker_t) +dev_read_lvm_control(docker_t) +dev_rw_sysfs(docker_t) +dev_rw_loop_control(docker_t) +dev_rw_lvm_control(docker_t) + +files_getattr_isid_type_dirs(docker_t) +files_manage_isid_type_dirs(docker_t) +files_manage_isid_type_files(docker_t) +files_manage_isid_type_symlinks(docker_t) +files_manage_isid_type_chr_files(docker_t) +files_manage_isid_type_blk_files(docker_t) +files_exec_isid_files(docker_t) +files_mounton_isid(docker_t) +files_mounton_non_security(docker_t) +files_mounton_isid_type_chr_file(docker_t) + +fs_mount_all_fs(docker_t) +fs_unmount_all_fs(docker_t) +fs_remount_all_fs(docker_t) +files_mounton_isid(docker_t) +fs_manage_cgroup_dirs(docker_t) +fs_manage_cgroup_files(docker_t) +fs_relabelfrom_xattr_fs(docker_t) +fs_relabelfrom_tmpfs(docker_t) +fs_read_tmpfs_symlinks(docker_t) +fs_list_hugetlbfs(docker_t) + +term_use_generic_ptys(docker_t) +term_use_ptmx(docker_t) +term_getattr_pty_fs(docker_t) +term_relabel_pty_fs(docker_t) +term_mounton_unallocated_ttys(docker_t) + +modutils_domtrans_insmod(docker_t) + +systemd_status_all_unit_files(docker_t) +systemd_start_systemd_services(docker_t) + +userdom_stream_connect(docker_t) +userdom_search_user_home_content(docker_t) +userdom_read_all_users_state(docker_t) +userdom_relabel_user_home_files(docker_t) +userdom_relabel_user_tmp_files(docker_t) +userdom_relabel_user_tmp_dirs(docker_t) + +optional_policy(` + gpm_getattr_gpmctl(docker_t) +') + +optional_policy(` + dbus_system_bus_client(docker_t) + init_dbus_chat(docker_t) + init_start_transient_unit(docker_t) + + optional_policy(` + systemd_dbus_chat_logind(docker_t) + ') + + optional_policy(` + firewalld_dbus_chat(docker_t) + ') +') + +optional_policy(` + udev_read_db(docker_t) +') + +optional_policy(` + virt_read_config(docker_t) + virt_exec(docker_t) + virt_stream_connect(docker_t) + virt_stream_connect_sandbox(docker_t) + virt_exec_sandbox_files(docker_t) + virt_manage_sandbox_files(docker_t) + virt_relabel_sandbox_filesystem(docker_t) + # for lxc + virt_transition_svirt_sandbox(docker_t, system_r) + virt_mounton_sandbox_file(docker_t) +# virt_attach_sandbox_tun_iface(docker_t) + allow docker_t svirt_sandbox_domain:tun_socket relabelfrom; +') + +tunable_policy(`docker_connect_any',` + corenet_tcp_connect_all_ports(docker_t) + corenet_sendrecv_all_packets(docker_t) + corenet_tcp_sendrecv_all_ports(docker_t) +') + +######################################## +# +# spc local policy +# +domain_entry_file(spc_t, docker_share_t) +domain_entry_file(spc_t, docker_var_lib_t) +role system_r types spc_t; + +domain_entry_file(spc_t, docker_share_t) +domain_entry_file(spc_t, docker_var_lib_t) +domtrans_pattern(docker_t, docker_share_t, spc_t) +domtrans_pattern(docker_t, docker_var_lib_t, spc_t) +allow docker_t spc_t:process { setsched signal_perms }; +ps_process_pattern(docker_t, spc_t) +allow docker_t spc_t:socket_class_set { relabelto relabelfrom }; + +optional_policy(` + dbus_chat_system_bus(spc_t) +') + +optional_policy(` + unconfined_domain_noaudit(spc_t) +') + +optional_policy(` + unconfined_domain(docker_t) +') + +optional_policy(` + virt_transition_svirt_sandbox(spc_t, system_r) +') + +######################################## +# +# docker upstream policy +# + +optional_policy(` +# domain_stub_named_filetrans_domain() + gen_require(` + attribute named_filetrans_domain; + ') + + docker_filetrans_named_content(named_filetrans_domain) +') + +optional_policy(` + lvm_stub() + docker_rw_sem(lvm_t) +') + +optional_policy(` + staff_stub() + docker_stream_connect(staff_t) + docker_exec(staff_t) +') + +optional_policy(` + virt_stub_lxc() + docker_exec_lib(virtd_lxc_t) +') + +optional_policy(` + virt_stub_svirt_sandbox_domain() + virt_stub_svirt_sandbox_file() + allow svirt_sandbox_domain self:netlink_kobject_uevent_socket create_socket_perms; + docker_read_share_files(svirt_sandbox_domain) + docker_lib_filetrans(svirt_sandbox_domain,svirt_sandbox_file_t, sock_file) + docker_use_ptys(svirt_sandbox_domain) + docker_spc_stream_connect(svirt_sandbox_domain) + fs_list_tmpfs(svirt_sandbox_domain) + fs_rw_hugetlbfs_files(svirt_sandbox_domain) + fs_dontaudit_remount_tmpfs(svirt_sandbox_domain) + dev_dontaudit_mounton_sysfs(svirt_sandbox_domain) + + tunable_policy(`virt_sandbox_use_fusefs',` + fs_manage_fusefs_dirs(svirt_sandbox_domain) + fs_manage_fusefs_files(svirt_sandbox_domain) + fs_manage_fusefs_symlinks(svirt_sandbox_domain) + ') + gen_require(` + attribute domain; + ') + + dontaudit svirt_sandbox_domain domain:key {search link}; +') diff --git a/contrib/docker-engine-selinux/docker_selinux.8.gz b/contrib/docker-engine-selinux/docker_selinux.8.gz new file mode 100644 index 0000000000000000000000000000000000000000..ab5d59445ac1601ca378aaa3e71fb9cff43a1592 GIT binary patch literal 2847 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 xb`W`pZ+>}u< /dev/null; then + echo >&2 'error: "qemu-nbd" not found!' + exit 1 +fi + +usage() { + echo "Convert disk image to docker image" + echo "" + echo "usage: $0 image-name disk-image-file [ base-image ]" + echo " ie: $0 cirros:0.3.3 cirros-0.3.3-x86_64-disk.img" + echo " $0 ubuntu:cloud ubuntu-14.04-server-cloudimg-amd64-disk1.img ubuntu:14.04" +} + +if [ "$#" -lt 2 ]; then + usage + exit 1 +fi + +CURDIR=$(pwd) + +image_name="${1%:*}" +image_tag="${1#*:}" +if [ "$image_tag" == "$1" ]; then + image_tag="latest" +fi + +disk_image_file="$2" +docker_base_image="$3" + +block_device=/dev/nbd0 + +builddir=$(mktemp -d) + +cleanup() { + umount "$builddir/disk_image" || true + umount "$builddir/workdir" || true + qemu-nbd -d $block_device &> /dev/null || true + rm -rf $builddir +} +trap cleanup EXIT + +# Mount disk image +modprobe nbd max_part=63 +qemu-nbd -rc ${block_device} -P 1 "$disk_image_file" +mkdir "$builddir/disk_image" +mount -o ro ${block_device} "$builddir/disk_image" + +mkdir "$builddir/workdir" +mkdir "$builddir/diff" + +base_image_mounts="" + +# Unpack base image +if [ -n "$docker_base_image" ]; then + mkdir -p "$builddir/base" + docker pull "$docker_base_image" + docker save "$docker_base_image" | tar -xC "$builddir/base" + + image_id=$(docker inspect -f "{{.Id}}" "$docker_base_image") + while [ -n "$image_id" ]; do + mkdir -p "$builddir/base/$image_id/layer" + tar -xf "$builddir/base/$image_id/layer.tar" -C "$builddir/base/$image_id/layer" + + base_image_mounts="${base_image_mounts}:$builddir/base/$image_id/layer=ro+wh" + image_id=$(docker inspect -f "{{.Parent}}" "$image_id") + done +fi + +# Mount work directory +mount -t aufs -o "br=$builddir/diff=rw${base_image_mounts},dio,xino=/dev/shm/aufs.xino" none "$builddir/workdir" + +# Update files +cd $builddir +LC_ALL=C diff -rq disk_image workdir \ + | sed -re "s|Only in workdir(.*?): |DEL \1/|g;s|Only in disk_image(.*?): |ADD \1/|g;s|Files disk_image/(.+) and workdir/(.+) differ|UPDATE /\1|g" \ + | while read action entry; do + case "$action" in + ADD|UPDATE) + cp -a "disk_image$entry" "workdir$entry" + ;; + DEL) + rm -rf "workdir$entry" + ;; + *) + echo "Error: unknown diff line: $action $entry" >&2 + ;; + esac + done + +# Pack new image +new_image_id="$(for i in $(seq 1 32); do printf "%02x" $(($RANDOM % 256)); done)" +mkdir -p $builddir/result/$new_image_id +cd diff +tar -cf $builddir/result/$new_image_id/layer.tar * +echo "1.0" > $builddir/result/$new_image_id/VERSION +cat > $builddir/result/$new_image_id/json <<-EOS +{ "docker_version": "1.4.1" +, "id": "$new_image_id" +, "created": "$(date -u +%Y-%m-%dT%H:%M:%S.%NZ)" +EOS + +if [ -n "$docker_base_image" ]; then + image_id=$(docker inspect -f "{{.Id}}" "$docker_base_image") + echo ", \"parent\": \"$image_id\"" >> $builddir/result/$new_image_id/json +fi + +echo "}" >> $builddir/result/$new_image_id/json + +echo "{\"$image_name\":{\"$image_tag\":\"$new_image_id\"}}" > $builddir/result/repositories + +cd $builddir/result + +# mkdir -p $CURDIR/$image_name +# cp -r * $CURDIR/$image_name +tar -c * | docker load diff --git a/contrib/download-frozen-image.sh b/contrib/download-frozen-image.sh new file mode 100755 index 0000000000..29d7ff59fd --- /dev/null +++ b/contrib/download-frozen-image.sh @@ -0,0 +1,108 @@ +#!/bin/bash +set -e + +# hello-world latest ef872312fe1b 3 months ago 910 B +# hello-world latest ef872312fe1bbc5e05aae626791a47ee9b032efa8f3bda39cc0be7b56bfe59b9 3 months ago 910 B + +# debian latest f6fab3b798be 10 weeks ago 85.1 MB +# debian latest f6fab3b798be3174f45aa1eb731f8182705555f89c9026d8c1ef230cbf8301dd 10 weeks ago 85.1 MB + +if ! command -v curl &> /dev/null; then + echo >&2 'error: "curl" not found!' + exit 1 +fi + +usage() { + echo "usage: $0 dir image[:tag][@image-id] ..." + echo " ie: $0 /tmp/hello-world hello-world" + echo " $0 /tmp/debian-jessie debian:jessie" + echo " $0 /tmp/old-hello-world hello-world@ef872312fe1bbc5e05aae626791a47ee9b032efa8f3bda39cc0be7b56bfe59b9" + echo " $0 /tmp/old-debian debian:latest@f6fab3b798be3174f45aa1eb731f8182705555f89c9026d8c1ef230cbf8301dd" + [ -z "$1" ] || exit "$1" +} + +dir="$1" # dir for building tar in +shift || usage 1 >&2 + +[ $# -gt 0 -a "$dir" ] || usage 2 >&2 +mkdir -p "$dir" + +# hacky workarounds for Bash 3 support (no associative arrays) +images=() +rm -f "$dir"/tags-*.tmp +# repositories[busybox]='"latest": "...", "ubuntu-14.04": "..."' + +while [ $# -gt 0 ]; do + imageTag="$1" + shift + image="${imageTag%%[:@]*}" + tag="${imageTag#*:}" + imageId="${tag##*@}" + [ "$imageId" != "$tag" ] || imageId= + [ "$tag" != "$imageTag" ] || tag='latest' + tag="${tag%@*}" + + imageFile="${image//\//_}" # "/" can't be in filenames :) + + token="$(curl -sSL -o /dev/null -D- -H 'X-Docker-Token: true' "https://index.docker.io/v1/repositories/$image/images" | tr -d '\r' | awk -F ': *' '$1 == "X-Docker-Token" { print $2 }')" + + if [ -z "$imageId" ]; then + imageId="$(curl -sSL -H "Authorization: Token $token" "https://registry-1.docker.io/v1/repositories/$image/tags/$tag")" + imageId="${imageId//\"/}" + fi + + ancestryJson="$(curl -sSL -H "Authorization: Token $token" "https://registry-1.docker.io/v1/images/$imageId/ancestry")" + if [ "${ancestryJson:0:1}" != '[' ]; then + echo >&2 "error: /v1/images/$imageId/ancestry returned something unexpected:" + echo >&2 " $ancestryJson" + exit 1 + fi + + IFS=',' + ancestry=( ${ancestryJson//[\[\] \"]/} ) + unset IFS + + if [ -s "$dir/tags-$imageFile.tmp" ]; then + echo -n ', ' >> "$dir/tags-$imageFile.tmp" + else + images=( "${images[@]}" "$image" ) + fi + echo -n '"'"$tag"'": "'"$imageId"'"' >> "$dir/tags-$imageFile.tmp" + + echo "Downloading '$imageTag' (${#ancestry[@]} layers)..." + for imageId in "${ancestry[@]}"; do + mkdir -p "$dir/$imageId" + echo '1.0' > "$dir/$imageId/VERSION" + + curl -sSL -H "Authorization: Token $token" "https://registry-1.docker.io/v1/images/$imageId/json" -o "$dir/$imageId/json" + + # TODO figure out why "-C -" doesn't work here + # "curl: (33) HTTP server doesn't seem to support byte ranges. Cannot resume." + # "HTTP/1.1 416 Requested Range Not Satisfiable" + if [ -f "$dir/$imageId/layer.tar" ]; then + # TODO hackpatch for no -C support :'( + echo "skipping existing ${imageId:0:12}" + continue + fi + curl -SL --progress -H "Authorization: Token $token" "https://registry-1.docker.io/v1/images/$imageId/layer" -o "$dir/$imageId/layer.tar" # -C - + done + echo +done + +echo -n '{' > "$dir/repositories" +firstImage=1 +for image in "${images[@]}"; do + imageFile="${image//\//_}" # "/" can't be in filenames :) + + [ "$firstImage" ] || echo -n ',' >> "$dir/repositories" + firstImage= + echo -n $'\n\t' >> "$dir/repositories" + echo -n '"'"$image"'": { '"$(cat "$dir/tags-$imageFile.tmp")"' }' >> "$dir/repositories" +done +echo -n $'\n}\n' >> "$dir/repositories" + +rm -f "$dir"/tags-*.tmp + +echo "Download of images into '$dir' complete." +echo "Use something like the following to load the result into a Docker daemon:" +echo " tar -cC '$dir' . | docker load" diff --git a/contrib/host-integration/Dockerfile.dev b/contrib/host-integration/Dockerfile.dev new file mode 100644 index 0000000000..c8df852899 --- /dev/null +++ b/contrib/host-integration/Dockerfile.dev @@ -0,0 +1,25 @@ +# +# This Dockerfile will create an image that allows to generate upstart and +# systemd scripts (more to come) +# + +FROM ubuntu:12.10 +MAINTAINER Guillaume J. Charmes + +RUN apt-get update && apt-get install -y wget git mercurial + +# Install Go +RUN wget --no-check-certificate https://go.googlecode.com/files/go1.1.2.linux-amd64.tar.gz -O go-1.1.2.tar.gz +RUN tar -xzvf go-1.1.2.tar.gz && mv /go /goroot +RUN mkdir /go + +ENV GOROOT /goroot +ENV GOPATH /go +ENV PATH $GOROOT/bin:$PATH + +RUN go get github.com/docker/docker && cd /go/src/github.com/docker/docker && git checkout v0.6.3 +ADD manager.go /manager/ +RUN cd /manager && go build -o /usr/bin/manager + +ENTRYPOINT ["/usr/bin/manager"] + diff --git a/contrib/host-integration/Dockerfile.min b/contrib/host-integration/Dockerfile.min new file mode 100644 index 0000000000..60bb89b986 --- /dev/null +++ b/contrib/host-integration/Dockerfile.min @@ -0,0 +1,4 @@ +FROM busybox +MAINTAINER Guillaume J. Charmes +ADD manager /usr/bin/ +ENTRYPOINT ["/usr/bin/manager"] diff --git a/contrib/host-integration/manager.go b/contrib/host-integration/manager.go new file mode 100644 index 0000000000..c0b488b2f1 --- /dev/null +++ b/contrib/host-integration/manager.go @@ -0,0 +1,130 @@ +package main + +import ( + "bytes" + "encoding/json" + "flag" + "fmt" + "github.com/docker/docker" + "os" + "strings" + "text/template" +) + +var templates = map[string]string{ + + "upstart": `description "{{.description}}" +author "{{.author}}" +start on filesystem and started lxc-net and started docker +stop on runlevel [!2345] +respawn +exec /home/vagrant/goroot/bin/docker start -a {{.container_id}} +`, + + "systemd": `[Unit] + Description={{.description}} + Author={{.author}} + After=docker.service + +[Service] + Restart=always + ExecStart=/usr/bin/docker start -a {{.container_id}} + ExecStop=/usr/bin/docker stop -t 2 {{.container_id}} + +[Install] + WantedBy=local.target +`, +} + +func main() { + // Parse command line for custom options + kind := flag.String("t", "upstart", "Type of manager requested") + author := flag.String("a", "", "Author of the image") + description := flag.String("d", "", "Description of the image") + flag.Usage = func() { + fmt.Fprintf(os.Stderr, "\nUsage: manager \n\n") + flag.PrintDefaults() + } + flag.Parse() + + // We require at least the container ID + if flag.NArg() != 1 { + println(flag.NArg()) + flag.Usage() + return + } + + // Check that the requested process manager is supported + if _, exists := templates[*kind]; !exists { + panic("Unknown script template") + } + + // Load the requested template + tpl, err := template.New("processManager").Parse(templates[*kind]) + if err != nil { + panic(err) + } + + // Create stdout/stderr buffers + bufOut := bytes.NewBuffer(nil) + bufErr := bytes.NewBuffer(nil) + + // Instanciate the Docker CLI + cli := docker.NewDockerCli(nil, bufOut, bufErr, "unix", "/var/run/docker.sock", false, nil) + // Retrieve the container info + if err := cli.CmdInspect(flag.Arg(0)); err != nil { + // As of docker v0.6.3, CmdInspect always returns nil + panic(err) + } + + // If there is nothing in the error buffer, then the Docker daemon is there and the container has been found + if bufErr.Len() == 0 { + // Unmarshall the resulting container data + c := []*docker.Container{{}} + if err := json.Unmarshal(bufOut.Bytes(), &c); err != nil { + panic(err) + } + // Reset the buffers + bufOut.Reset() + bufErr.Reset() + // Retrieve the info of the linked image + if err := cli.CmdInspect(c[0].Image); err != nil { + panic(err) + } + // If there is nothing in the error buffer, then the image has been found. + if bufErr.Len() == 0 { + // Unmarshall the resulting image data + img := []*docker.Image{{}} + if err := json.Unmarshal(bufOut.Bytes(), &img); err != nil { + panic(err) + } + // If no author has been set, use the one from the image + if *author == "" && img[0].Author != "" { + *author = strings.Replace(img[0].Author, "\"", "", -1) + } + // If no description has been set, use the comment from the image + if *description == "" && img[0].Comment != "" { + *description = strings.Replace(img[0].Comment, "\"", "", -1) + } + } + } + + /// Old version: Wrtie the resulting script to file + // f, err := os.OpenFile(kind, os.O_CREATE|os.O_WRONLY, 0755) + // if err != nil { + // panic(err) + // } + // defer f.Close() + + // Create a map with needed data + data := map[string]string{ + "author": *author, + "description": *description, + "container_id": flag.Arg(0), + } + + // Process the template and output it on Stdout + if err := tpl.Execute(os.Stdout, data); err != nil { + panic(err) + } +} diff --git a/contrib/host-integration/manager.sh b/contrib/host-integration/manager.sh new file mode 100755 index 0000000000..8ea296f5a5 --- /dev/null +++ b/contrib/host-integration/manager.sh @@ -0,0 +1,53 @@ +#!/bin/sh +set -e + +usage() { + echo >&2 "usage: $0 [-a author] [-d description] container [manager]" + echo >&2 " ie: $0 -a 'John Smith' 4ec9612a37cd systemd" + echo >&2 " ie: $0 -d 'Super Cool System' 4ec9612a37cd # defaults to upstart" + exit 1 +} + +auth='' +desc='' +have_auth= +have_desc= +while getopts a:d: opt; do + case "$opt" in + a) + auth="$OPTARG" + have_auth=1 + ;; + d) + desc="$OPTARG" + have_desc=1 + ;; + esac +done +shift $(($OPTIND - 1)) + +[ $# -ge 1 -a $# -le 2 ] || usage + +cid="$1" +script="${2:-upstart}" +if [ ! -e "manager/$script" ]; then + echo >&2 "Error: manager type '$script' is unknown (PRs always welcome!)." + echo >&2 'The currently supported types are:' + echo >&2 " $(cd manager && echo *)" + exit 1 +fi + +# TODO https://github.com/docker/docker/issues/734 (docker inspect formatting) +#if command -v docker > /dev/null 2>&1; then +# image="$(docker inspect -f '{{.Image}}' "$cid")" +# if [ "$image" ]; then +# if [ -z "$have_auth" ]; then +# auth="$(docker inspect -f '{{.Author}}' "$image")" +# fi +# if [ -z "$have_desc" ]; then +# desc="$(docker inspect -f '{{.Comment}}' "$image")" +# fi +# fi +#fi + +exec "manager/$script" "$cid" "$auth" "$desc" diff --git a/contrib/host-integration/manager/systemd b/contrib/host-integration/manager/systemd new file mode 100755 index 0000000000..c1ab34ef0f --- /dev/null +++ b/contrib/host-integration/manager/systemd @@ -0,0 +1,20 @@ +#!/bin/sh +set -e + +cid="$1" +auth="$2" +desc="$3" + +cat <<-EOF + [Unit] + Description=$desc + Author=$auth + After=docker.service + + [Service] + ExecStart=/usr/bin/docker start -a $cid + ExecStop=/usr/bin/docker stop -t 2 $cid + + [Install] + WantedBy=local.target +EOF diff --git a/contrib/host-integration/manager/upstart b/contrib/host-integration/manager/upstart new file mode 100755 index 0000000000..af90f1fddd --- /dev/null +++ b/contrib/host-integration/manager/upstart @@ -0,0 +1,15 @@ +#!/bin/sh +set -e + +cid="$1" +auth="$2" +desc="$3" + +cat <<-EOF + description "$(echo "$desc" | sed 's/"/\\"/g')" + author "$(echo "$auth" | sed 's/"/\\"/g')" + start on filesystem and started lxc-net and started docker + stop on runlevel [!2345] + respawn + exec /usr/bin/docker start -a "$cid" +EOF diff --git a/contrib/httpserver/Dockerfile b/contrib/httpserver/Dockerfile new file mode 100644 index 0000000000..747dc91bcf --- /dev/null +++ b/contrib/httpserver/Dockerfile @@ -0,0 +1,4 @@ +FROM busybox +EXPOSE 80/tcp +COPY httpserver . +CMD ["./httpserver"] diff --git a/contrib/httpserver/server.go b/contrib/httpserver/server.go new file mode 100644 index 0000000000..a75d5abb3d --- /dev/null +++ b/contrib/httpserver/server.go @@ -0,0 +1,12 @@ +package main + +import ( + "log" + "net/http" +) + +func main() { + fs := http.FileServer(http.Dir("/static")) + http.Handle("/", fs) + log.Panic(http.ListenAndServe(":80", nil)) +} diff --git a/contrib/init/openrc/docker.confd b/contrib/init/openrc/docker.confd new file mode 100644 index 0000000000..ae247c007e --- /dev/null +++ b/contrib/init/openrc/docker.confd @@ -0,0 +1,13 @@ +# /etc/conf.d/docker: config file for /etc/init.d/docker + +# where the docker daemon output gets piped +#DOCKER_LOGFILE="/var/log/docker.log" + +# where docker's pid get stored +#DOCKER_PIDFILE="/run/docker.pid" + +# where the docker daemon itself is run from +#DOCKER_BINARY="/usr/bin/docker" + +# any other random options you want to pass to docker +DOCKER_OPTS="" diff --git a/contrib/init/openrc/docker.initd b/contrib/init/openrc/docker.initd new file mode 100644 index 0000000000..ea8a3b2213 --- /dev/null +++ b/contrib/init/openrc/docker.initd @@ -0,0 +1,19 @@ +#!/sbin/openrc-run +# Copyright 1999-2013 Gentoo Foundation +# Distributed under the terms of the GNU General Public License v2 + +command="${DOCKER_BINARY:-/usr/bin/docker}" +pidfile="${DOCKER_PIDFILE:-/run/${RC_SVCNAME}.pid}" +command_args="daemon -p \"${pidfile}\" ${DOCKER_OPTS}" +DOCKER_LOGFILE="${DOCKER_LOGFILE:-/var/log/${RC_SVCNAME}.log}" +start_stop_daemon_args="--background \ + --stderr \"${DOCKER_LOGFILE}\" --stdout \"${DOCKER_LOGFILE}\"" + +start_pre() { + checkpath -f -m 0644 -o root:docker "$DOCKER_LOGFILE" + + ulimit -n 1048576 + ulimit -u 1048576 + + return 0 +} diff --git a/contrib/init/systemd/REVIEWERS b/contrib/init/systemd/REVIEWERS new file mode 100644 index 0000000000..b9ba55b3fb --- /dev/null +++ b/contrib/init/systemd/REVIEWERS @@ -0,0 +1,3 @@ +Lokesh Mandvekar (@lsm5) +Brandon Philips (@philips) +Jessie Frazelle (@jfrazelle) diff --git a/contrib/init/systemd/docker.service b/contrib/init/systemd/docker.service new file mode 100644 index 0000000000..f09c2d3956 --- /dev/null +++ b/contrib/init/systemd/docker.service @@ -0,0 +1,16 @@ +[Unit] +Description=Docker Application Container Engine +Documentation=https://docs.docker.com +After=network.target docker.socket +Requires=docker.socket + +[Service] +Type=notify +ExecStart=/usr/bin/docker daemon -H fd:// +MountFlags=slave +LimitNOFILE=1048576 +LimitNPROC=1048576 +LimitCORE=infinity + +[Install] +WantedBy=multi-user.target diff --git a/contrib/init/systemd/docker.socket b/contrib/init/systemd/docker.socket new file mode 100644 index 0000000000..7dd95098e4 --- /dev/null +++ b/contrib/init/systemd/docker.socket @@ -0,0 +1,12 @@ +[Unit] +Description=Docker Socket for the API +PartOf=docker.service + +[Socket] +ListenStream=/var/run/docker.sock +SocketMode=0660 +SocketUser=root +SocketGroup=docker + +[Install] +WantedBy=sockets.target diff --git a/contrib/init/sysvinit-debian/docker b/contrib/init/sysvinit-debian/docker new file mode 100755 index 0000000000..fc4b05b3bb --- /dev/null +++ b/contrib/init/sysvinit-debian/docker @@ -0,0 +1,149 @@ +#!/bin/sh +set -e + +### BEGIN INIT INFO +# Provides: docker +# Required-Start: $syslog $remote_fs +# Required-Stop: $syslog $remote_fs +# Should-Start: cgroupfs-mount cgroup-lite +# Should-Stop: cgroupfs-mount cgroup-lite +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: Create lightweight, portable, self-sufficient containers. +# Description: +# Docker is an open-source project to easily create lightweight, portable, +# self-sufficient containers from any application. The same container that a +# developer builds and tests on a laptop can run at scale, in production, on +# VMs, bare metal, OpenStack clusters, public clouds and more. +### END INIT INFO + +export PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin + +BASE=docker + +# modify these in /etc/default/$BASE (/etc/default/docker) +DOCKER=/usr/bin/$BASE +# This is the pid file managed by docker itself +DOCKER_PIDFILE=/var/run/$BASE.pid +# This is the pid file created/managed by start-stop-daemon +DOCKER_SSD_PIDFILE=/var/run/$BASE-ssd.pid +DOCKER_LOGFILE=/var/log/$BASE.log +DOCKER_OPTS= +DOCKER_DESC="Docker" + +# Get lsb functions +. /lib/lsb/init-functions + +if [ -f /etc/default/$BASE ]; then + . /etc/default/$BASE +fi + +# Check docker is present +if [ ! -x $DOCKER ]; then + log_failure_msg "$DOCKER not present or not executable" + exit 1 +fi + +check_init() { + # see also init_is_upstart in /lib/lsb/init-functions (which isn't available in Ubuntu 12.04, or we'd use it directly) + if [ -x /sbin/initctl ] && /sbin/initctl version 2>/dev/null | grep -q upstart; then + log_failure_msg "$DOCKER_DESC is managed via upstart, try using service $BASE $1" + exit 1 + fi +} + +fail_unless_root() { + if [ "$(id -u)" != '0' ]; then + log_failure_msg "$DOCKER_DESC must be run as root" + exit 1 + fi +} + +cgroupfs_mount() { + # see also https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount + if grep -v '^#' /etc/fstab | grep -q cgroup \ + || [ ! -e /proc/cgroups ] \ + || [ ! -d /sys/fs/cgroup ]; then + return + fi + if ! mountpoint -q /sys/fs/cgroup; then + mount -t tmpfs -o uid=0,gid=0,mode=0755 cgroup /sys/fs/cgroup + fi + ( + cd /sys/fs/cgroup + for sys in $(awk '!/^#/ { if ($4 == 1) print $1 }' /proc/cgroups); do + mkdir -p $sys + if ! mountpoint -q $sys; then + if ! mount -n -t cgroup -o $sys cgroup $sys; then + rmdir $sys || true + fi + fi + done + ) +} + +case "$1" in + start) + check_init + + fail_unless_root + + cgroupfs_mount + + touch "$DOCKER_LOGFILE" + chgrp docker "$DOCKER_LOGFILE" + + ulimit -n 1048576 + if [ "$BASH" ]; then + ulimit -u 1048576 + else + ulimit -p 1048576 + fi + + log_begin_msg "Starting $DOCKER_DESC: $BASE" + start-stop-daemon --start --background \ + --no-close \ + --exec "$DOCKER" \ + --pidfile "$DOCKER_SSD_PIDFILE" \ + --make-pidfile \ + -- \ + daemon -p "$DOCKER_PIDFILE" \ + $DOCKER_OPTS \ + >> "$DOCKER_LOGFILE" 2>&1 + log_end_msg $? + ;; + + stop) + check_init + fail_unless_root + log_begin_msg "Stopping $DOCKER_DESC: $BASE" + start-stop-daemon --stop --pidfile "$DOCKER_SSD_PIDFILE" --retry 10 + log_end_msg $? + ;; + + restart) + check_init + fail_unless_root + docker_pid=`cat "$DOCKER_SSD_PIDFILE" 2>/dev/null` + [ -n "$docker_pid" ] \ + && ps -p $docker_pid > /dev/null 2>&1 \ + && $0 stop + $0 start + ;; + + force-reload) + check_init + fail_unless_root + $0 restart + ;; + + status) + check_init + status_of_proc -p "$DOCKER_SSD_PIDFILE" "$DOCKER" "$DOCKER_DESC" + ;; + + *) + echo "Usage: service docker {start|stop|restart|status}" + exit 1 + ;; +esac diff --git a/contrib/init/sysvinit-debian/docker.default b/contrib/init/sysvinit-debian/docker.default new file mode 100644 index 0000000000..14e660175b --- /dev/null +++ b/contrib/init/sysvinit-debian/docker.default @@ -0,0 +1,13 @@ +# Docker Upstart and SysVinit configuration file + +# Customize location of Docker binary (especially for development testing). +#DOCKER="/usr/local/bin/docker" + +# Use DOCKER_OPTS to modify the daemon startup options. +#DOCKER_OPTS="--dns 8.8.8.8 --dns 8.8.4.4" + +# If you need Docker to use an HTTP proxy, it can also be specified here. +#export http_proxy="http://127.0.0.1:3128/" + +# This is also a handy place to tweak where Docker's temporary files go. +#export TMPDIR="/mnt/bigdrive/docker-tmp" diff --git a/contrib/init/sysvinit-redhat/docker b/contrib/init/sysvinit-redhat/docker new file mode 100755 index 0000000000..9757d0395c --- /dev/null +++ b/contrib/init/sysvinit-redhat/docker @@ -0,0 +1,153 @@ +#!/bin/sh +# +# /etc/rc.d/init.d/docker +# +# Daemon for docker.com +# +# chkconfig: 2345 95 95 +# description: Daemon for docker.com + +### BEGIN INIT INFO +# Provides: docker +# Required-Start: $network cgconfig +# Required-Stop: +# Should-Start: +# Should-Stop: +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: start and stop docker +# Description: Daemon for docker.com +### END INIT INFO + +# Source function library. +. /etc/rc.d/init.d/functions + +prog="docker" +unshare=/usr/bin/unshare +exec="/usr/bin/$prog" +pidfile="/var/run/$prog.pid" +lockfile="/var/lock/subsys/$prog" +logfile="/var/log/$prog" + +[ -e /etc/sysconfig/$prog ] && . /etc/sysconfig/$prog + +prestart() { + service cgconfig status > /dev/null + + if [[ $? != 0 ]]; then + service cgconfig start + fi + +} + +start() { + if [ ! -x $exec ]; then + if [ ! -e $exec ]; then + echo "Docker executable $exec not found" + else + echo "You do not have permission to execute the Docker executable $exec" + fi + exit 5 + fi + + check_for_cleanup + + if ! [ -f $pidfile ]; then + prestart + printf "Starting $prog:\t" + echo "\n$(date)\n" >> $logfile + "$unshare" -m -- $exec daemon $other_args &>> $logfile & + pid=$! + touch $lockfile + # wait up to 10 seconds for the pidfile to exist. see + # https://github.com/docker/docker/issues/5359 + tries=0 + while [ ! -f $pidfile -a $tries -lt 10 ]; do + sleep 1 + tries=$((tries + 1)) + echo -n '.' + done + if [ ! -f $pidfile ]; then + failure + echo + exit 1 + fi + success + echo + else + failure + echo + printf "$pidfile still exists...\n" + exit 7 + fi +} + +stop() { + echo -n $"Stopping $prog: " + killproc -p $pidfile -d 300 $prog + retval=$? + echo + [ $retval -eq 0 ] && rm -f $lockfile + return $retval +} + +restart() { + stop + start +} + +reload() { + restart +} + +force_reload() { + restart +} + +rh_status() { + status -p $pidfile $prog +} + +rh_status_q() { + rh_status >/dev/null 2>&1 +} + + +check_for_cleanup() { + if [ -f ${pidfile} ]; then + /bin/ps -fp $(cat ${pidfile}) > /dev/null || rm ${pidfile} + fi +} + +case "$1" in + start) + rh_status_q && exit 0 + $1 + ;; + stop) + rh_status_q || exit 0 + $1 + ;; + restart) + $1 + ;; + reload) + rh_status_q || exit 7 + $1 + ;; + force-reload) + force_reload + ;; + status) + rh_status + ;; + condrestart|try-restart) + rh_status_q || exit 0 + restart + ;; + *) + echo $"Usage: $0 {start|stop|status|restart|condrestart|try-restart|reload|force-reload}" + exit 2 +esac + +exit $? diff --git a/contrib/init/sysvinit-redhat/docker.sysconfig b/contrib/init/sysvinit-redhat/docker.sysconfig new file mode 100644 index 0000000000..0864b3d77f --- /dev/null +++ b/contrib/init/sysvinit-redhat/docker.sysconfig @@ -0,0 +1,7 @@ +# /etc/sysconfig/docker +# +# Other arguments to pass to the docker daemon process +# These will be parsed by the sysv initscript and appended +# to the arguments list passed to docker daemon + +other_args="" diff --git a/contrib/init/upstart/REVIEWERS b/contrib/init/upstart/REVIEWERS new file mode 100644 index 0000000000..03ee2dde3d --- /dev/null +++ b/contrib/init/upstart/REVIEWERS @@ -0,0 +1,2 @@ +Tianon Gravi (@tianon) +Jessie Frazelle (@jfrazelle) diff --git a/contrib/init/upstart/docker.conf b/contrib/init/upstart/docker.conf new file mode 100644 index 0000000000..ec50b35a87 --- /dev/null +++ b/contrib/init/upstart/docker.conf @@ -0,0 +1,60 @@ +description "Docker daemon" + +start on (local-filesystems and net-device-up IFACE!=lo) +stop on runlevel [!2345] +limit nofile 524288 1048576 +limit nproc 524288 1048576 + +respawn + +kill timeout 20 + +pre-start script + # see also https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount + if grep -v '^#' /etc/fstab | grep -q cgroup \ + || [ ! -e /proc/cgroups ] \ + || [ ! -d /sys/fs/cgroup ]; then + exit 0 + fi + if ! mountpoint -q /sys/fs/cgroup; then + mount -t tmpfs -o uid=0,gid=0,mode=0755 cgroup /sys/fs/cgroup + fi + ( + cd /sys/fs/cgroup + for sys in $(awk '!/^#/ { if ($4 == 1) print $1 }' /proc/cgroups); do + mkdir -p $sys + if ! mountpoint -q $sys; then + if ! mount -n -t cgroup -o $sys cgroup $sys; then + rmdir $sys || true + fi + fi + done + ) +end script + +script + # modify these in /etc/default/$UPSTART_JOB (/etc/default/docker) + DOCKER=/usr/bin/$UPSTART_JOB + DOCKER_OPTS= + if [ -f /etc/default/$UPSTART_JOB ]; then + . /etc/default/$UPSTART_JOB + fi + exec "$DOCKER" daemon $DOCKER_OPTS +end script + +# Don't emit "started" event until docker.sock is ready. +# See https://github.com/docker/docker/issues/6647 +post-start script + DOCKER_OPTS= + if [ -f /etc/default/$UPSTART_JOB ]; then + . /etc/default/$UPSTART_JOB + fi + if ! printf "%s" "$DOCKER_OPTS" | grep -qE -e '-H|--host'; then + while ! [ -e /var/run/docker.sock ]; do + initctl status $UPSTART_JOB | grep -qE "(stop|respawn)/" && exit 1 + echo "Waiting for /var/run/docker.sock" + sleep 0.1 + done + echo "/var/run/docker.sock is up" + fi +end script diff --git a/contrib/mkimage-alpine.sh b/contrib/mkimage-alpine.sh new file mode 100755 index 0000000000..71fb914388 --- /dev/null +++ b/contrib/mkimage-alpine.sh @@ -0,0 +1,82 @@ +#!/bin/sh + +set -e + +[ $(id -u) -eq 0 ] || { + printf >&2 '%s requires root\n' "$0" + exit 1 +} + +usage() { + printf >&2 '%s: [-r release] [-m mirror] [-s]\n' "$0" + exit 1 +} + +tmp() { + TMP=$(mktemp -d ${TMPDIR:-/var/tmp}/alpine-docker-XXXXXXXXXX) + ROOTFS=$(mktemp -d ${TMPDIR:-/var/tmp}/alpine-docker-rootfs-XXXXXXXXXX) + trap "rm -rf $TMP $ROOTFS" EXIT TERM INT +} + +apkv() { + curl -sSL $REPO/$ARCH/APKINDEX.tar.gz | tar -Oxz | + grep '^P:apk-tools-static$' -A1 | tail -n1 | cut -d: -f2 +} + +getapk() { + curl -sSL $REPO/$ARCH/apk-tools-static-$(apkv).apk | + tar -xz -C $TMP sbin/apk.static +} + +mkbase() { + $TMP/sbin/apk.static --repository $REPO --update-cache --allow-untrusted \ + --root $ROOTFS --initdb add alpine-base +} + +conf() { + printf '%s\n' $REPO > $ROOTFS/etc/apk/repositories +} + +pack() { + local id + id=$(tar --numeric-owner -C $ROOTFS -c . | docker import - alpine:$REL) + + docker tag $id alpine:latest + docker run -i -t alpine printf 'alpine:%s with id=%s created!\n' $REL $id +} + +save() { + [ $SAVE -eq 1 ] || return + + tar --numeric-owner -C $ROOTFS -c . | xz > rootfs.tar.xz +} + +while getopts "hr:m:s" opt; do + case $opt in + r) + REL=$OPTARG + ;; + m) + MIRROR=$OPTARG + ;; + s) + SAVE=1 + ;; + *) + usage + ;; + esac +done + +REL=${REL:-edge} +MIRROR=${MIRROR:-http://nl.alpinelinux.org/alpine} +SAVE=${SAVE:-0} +REPO=$MIRROR/$REL/main +ARCH=${ARCH:-$(uname -m)} + +tmp +getapk +mkbase +conf +pack +save diff --git a/contrib/mkimage-arch-pacman.conf b/contrib/mkimage-arch-pacman.conf new file mode 100644 index 0000000000..45fe03dc96 --- /dev/null +++ b/contrib/mkimage-arch-pacman.conf @@ -0,0 +1,92 @@ +# +# /etc/pacman.conf +# +# See the pacman.conf(5) manpage for option and repository directives + +# +# GENERAL OPTIONS +# +[options] +# The following paths are commented out with their default values listed. +# If you wish to use different paths, uncomment and update the paths. +#RootDir = / +#DBPath = /var/lib/pacman/ +#CacheDir = /var/cache/pacman/pkg/ +#LogFile = /var/log/pacman.log +#GPGDir = /etc/pacman.d/gnupg/ +HoldPkg = pacman glibc +#XferCommand = /usr/bin/curl -C - -f %u > %o +#XferCommand = /usr/bin/wget --passive-ftp -c -O %o %u +#CleanMethod = KeepInstalled +#UseDelta = 0.7 +Architecture = auto + +# Pacman won't upgrade packages listed in IgnorePkg and members of IgnoreGroup +#IgnorePkg = +#IgnoreGroup = + +#NoUpgrade = +#NoExtract = + +# Misc options +#UseSyslog +#Color +#TotalDownload +# We cannot check disk space from within a chroot environment +#CheckSpace +#VerbosePkgLists + +# By default, pacman accepts packages signed by keys that its local keyring +# trusts (see pacman-key and its man page), as well as unsigned packages. +SigLevel = Required DatabaseOptional +LocalFileSigLevel = Optional +#RemoteFileSigLevel = Required + +# NOTE: You must run `pacman-key --init` before first using pacman; the local +# keyring can then be populated with the keys of all official Arch Linux +# packagers with `pacman-key --populate archlinux`. + +# +# REPOSITORIES +# - can be defined here or included from another file +# - pacman will search repositories in the order defined here +# - local/custom mirrors can be added here or in separate files +# - repositories listed first will take precedence when packages +# have identical names, regardless of version number +# - URLs will have $repo replaced by the name of the current repo +# - URLs will have $arch replaced by the name of the architecture +# +# Repository entries are of the format: +# [repo-name] +# Server = ServerName +# Include = IncludePath +# +# The header [repo-name] is crucial - it must be present and +# uncommented to enable the repo. +# + +# The testing repositories are disabled by default. To enable, uncomment the +# repo name header and Include lines. You can add preferred servers immediately +# after the header, and they will be used before the default mirrors. + +#[testing] +#Include = /etc/pacman.d/mirrorlist + +[core] +Include = /etc/pacman.d/mirrorlist + +[extra] +Include = /etc/pacman.d/mirrorlist + +#[community-testing] +#Include = /etc/pacman.d/mirrorlist + +[community] +Include = /etc/pacman.d/mirrorlist + +# An example of a custom package repository. See the pacman manpage for +# tips on creating your own repositories. +#[custom] +#SigLevel = Optional TrustAll +#Server = file:///home/custompkgs + diff --git a/contrib/mkimage-arch.sh b/contrib/mkimage-arch.sh new file mode 100755 index 0000000000..06406fecd5 --- /dev/null +++ b/contrib/mkimage-arch.sh @@ -0,0 +1,93 @@ +#!/usr/bin/env bash +# Generate a minimal filesystem for archlinux and load it into the local +# docker as "archlinux" +# requires root +set -e + +hash pacstrap &>/dev/null || { + echo "Could not find pacstrap. Run pacman -S arch-install-scripts" + exit 1 +} + +hash expect &>/dev/null || { + echo "Could not find expect. Run pacman -S expect" + exit 1 +} + +export LANG="C.UTF-8" + +ROOTFS=$(mktemp -d ${TMPDIR:-/var/tmp}/rootfs-archlinux-XXXXXXXXXX) +chmod 755 $ROOTFS + +# packages to ignore for space savings +PKGIGNORE=( + cryptsetup + device-mapper + dhcpcd + iproute2 + jfsutils + linux + lvm2 + man-db + man-pages + mdadm + nano + netctl + openresolv + pciutils + pcmciautils + reiserfsprogs + s-nail + systemd-sysvcompat + usbutils + vi + xfsprogs +) +IFS=',' +PKGIGNORE="${PKGIGNORE[*]}" +unset IFS + +expect < $ROOTFS/etc/locale.gen +arch-chroot $ROOTFS locale-gen +arch-chroot $ROOTFS /bin/sh -c 'echo "Server = https://mirrors.kernel.org/archlinux/\$repo/os/\$arch" > /etc/pacman.d/mirrorlist' + +# udev doesn't work in containers, rebuild /dev +DEV=$ROOTFS/dev +rm -rf $DEV +mkdir -p $DEV +mknod -m 666 $DEV/null c 1 3 +mknod -m 666 $DEV/zero c 1 5 +mknod -m 666 $DEV/random c 1 8 +mknod -m 666 $DEV/urandom c 1 9 +mkdir -m 755 $DEV/pts +mkdir -m 1777 $DEV/shm +mknod -m 666 $DEV/tty c 5 0 +mknod -m 600 $DEV/console c 5 1 +mknod -m 666 $DEV/tty0 c 4 0 +mknod -m 666 $DEV/full c 1 7 +mknod -m 600 $DEV/initctl p +mknod -m 666 $DEV/ptmx c 5 2 +ln -sf /proc/self/fd $DEV/fd + +tar --numeric-owner --xattrs --acls -C $ROOTFS -c . | docker import - archlinux +docker run -t archlinux echo Success. +rm -rf $ROOTFS diff --git a/contrib/mkimage-busybox.sh b/contrib/mkimage-busybox.sh new file mode 100755 index 0000000000..b11a6bb265 --- /dev/null +++ b/contrib/mkimage-busybox.sh @@ -0,0 +1,43 @@ +#!/usr/bin/env bash +# Generate a very minimal filesystem based on busybox-static, +# and load it into the local docker under the name "busybox". + +echo >&2 +echo >&2 'warning: this script is deprecated - see mkimage.sh and mkimage/busybox-static' +echo >&2 + +BUSYBOX=$(which busybox) +[ "$BUSYBOX" ] || { + echo "Sorry, I could not locate busybox." + echo "Try 'apt-get install busybox-static'?" + exit 1 +} + +set -e +ROOTFS=${TMPDIR:-/var/tmp}/rootfs-busybox-$$-$RANDOM +mkdir $ROOTFS +cd $ROOTFS + +mkdir bin etc dev dev/pts lib proc sys tmp +touch etc/resolv.conf +cp /etc/nsswitch.conf etc/nsswitch.conf +echo root:x:0:0:root:/:/bin/sh > etc/passwd +echo root:x:0: > etc/group +ln -s lib lib64 +ln -s bin sbin +cp $BUSYBOX bin +for X in $(busybox --list) +do + ln -s busybox bin/$X +done +rm bin/init +ln bin/busybox bin/init +cp /lib/x86_64-linux-gnu/lib{pthread,c,dl,nsl,nss_*}.so.* lib +cp /lib/x86_64-linux-gnu/ld-linux-x86-64.so.2 lib +for X in console null ptmx random stdin stdout stderr tty urandom zero +do + cp -a /dev/$X dev +done + +tar --numeric-owner -cf- . | docker import - busybox +docker run -i -u root busybox /bin/echo Success. diff --git a/contrib/mkimage-crux.sh b/contrib/mkimage-crux.sh new file mode 100755 index 0000000000..3f0bdcae3c --- /dev/null +++ b/contrib/mkimage-crux.sh @@ -0,0 +1,75 @@ +#!/usr/bin/env bash +# Generate a minimal filesystem for CRUX/Linux and load it into the local +# docker as "cruxlinux" +# requires root and the crux iso (http://crux.nu) + +set -e + +die () { + echo >&2 "$@" + exit 1 +} + +[ "$#" -eq 1 ] || die "1 argument(s) required, $# provided. Usage: ./mkimage-crux.sh /path/to/iso" + +ISO=${1} + +ROOTFS=$(mktemp -d ${TMPDIR:-/var/tmp}/rootfs-crux-XXXXXXXXXX) +CRUX=$(mktemp -d ${TMPDIR:-/var/tmp}/crux-XXXXXXXXXX) +TMP=$(mktemp -d ${TMPDIR:-/var/tmp}/XXXXXXXXXX) + +VERSION=$(basename --suffix=.iso $ISO | sed 's/[^0-9.]*\([0-9.]*\).*/\1/') + +# Mount the ISO +mount -o ro,loop $ISO $CRUX + +# Extract pkgutils +tar -C $TMP -xf $CRUX/tools/pkgutils#*.pkg.tar.gz + +# Put pkgadd in the $PATH +export PATH="$TMP/usr/bin:$PATH" + +# Install core packages +mkdir -p $ROOTFS/var/lib/pkg +touch $ROOTFS/var/lib/pkg/db +for pkg in $CRUX/crux/core/*; do + pkgadd -r $ROOTFS $pkg +done + +# Remove agetty and inittab config +if (grep agetty ${ROOTFS}/etc/inittab 2>&1 > /dev/null); then + echo "Removing agetty from /etc/inittab ..." + chroot ${ROOTFS} sed -i -e "/agetty/d" /etc/inittab + chroot ${ROOTFS} sed -i -e "/shutdown/d" /etc/inittab + chroot ${ROOTFS} sed -i -e "/^$/N;/^\n$/d" /etc/inittab +fi + +# Remove kernel source +rm -rf $ROOTFS/usr/src/* + +# udev doesn't work in containers, rebuild /dev +DEV=$ROOTFS/dev +rm -rf $DEV +mkdir -p $DEV +mknod -m 666 $DEV/null c 1 3 +mknod -m 666 $DEV/zero c 1 5 +mknod -m 666 $DEV/random c 1 8 +mknod -m 666 $DEV/urandom c 1 9 +mkdir -m 755 $DEV/pts +mkdir -m 1777 $DEV/shm +mknod -m 666 $DEV/tty c 5 0 +mknod -m 600 $DEV/console c 5 1 +mknod -m 666 $DEV/tty0 c 4 0 +mknod -m 666 $DEV/full c 1 7 +mknod -m 600 $DEV/initctl p +mknod -m 666 $DEV/ptmx c 5 2 + +IMAGE_ID=$(tar --numeric-owner -C $ROOTFS -c . | docker import - crux:$VERSION) +docker tag $IMAGE_ID crux:latest +docker run -i -t crux echo Success. + +# Cleanup +umount $CRUX +rm -rf $ROOTFS +rm -rf $CRUX +rm -rf $TMP diff --git a/contrib/mkimage-debootstrap.sh b/contrib/mkimage-debootstrap.sh new file mode 100755 index 0000000000..412a5ce0a7 --- /dev/null +++ b/contrib/mkimage-debootstrap.sh @@ -0,0 +1,297 @@ +#!/usr/bin/env bash +set -e + +echo >&2 +echo >&2 'warning: this script is deprecated - see mkimage.sh and mkimage/debootstrap' +echo >&2 + +variant='minbase' +include='iproute,iputils-ping' +arch='amd64' # intentionally undocumented for now +skipDetection= +strictDebootstrap= +justTar= + +usage() { + echo >&2 + + echo >&2 "usage: $0 [options] repo suite [mirror]" + + echo >&2 + echo >&2 'options: (not recommended)' + echo >&2 " -p set an http_proxy for debootstrap" + echo >&2 " -v $variant # change default debootstrap variant" + echo >&2 " -i $include # change default package includes" + echo >&2 " -d # strict debootstrap (do not apply any docker-specific tweaks)" + echo >&2 " -s # skip version detection and tagging (ie, precise also tagged as 12.04)" + echo >&2 " # note that this will also skip adding universe and/or security/updates to sources.list" + echo >&2 " -t # just create a tarball, especially for dockerbrew (uses repo as tarball name)" + + echo >&2 + echo >&2 " ie: $0 username/debian squeeze" + echo >&2 " $0 username/debian squeeze http://ftp.uk.debian.org/debian/" + + echo >&2 + echo >&2 " ie: $0 username/ubuntu precise" + echo >&2 " $0 username/ubuntu precise http://mirrors.melbourne.co.uk/ubuntu/" + + echo >&2 + echo >&2 " ie: $0 -t precise.tar.bz2 precise" + echo >&2 " $0 -t wheezy.tgz wheezy" + echo >&2 " $0 -t wheezy-uk.tar.xz wheezy http://ftp.uk.debian.org/debian/" + + echo >&2 +} + +# these should match the names found at http://www.debian.org/releases/ +debianStable=wheezy +debianUnstable=sid +# this should match the name found at http://releases.ubuntu.com/ +ubuntuLatestLTS=trusty +# this should match the name found at http://releases.tanglu.org/ +tangluLatest=aequorea + +while getopts v:i:a:p:dst name; do + case "$name" in + p) + http_proxy="$OPTARG" + ;; + v) + variant="$OPTARG" + ;; + i) + include="$OPTARG" + ;; + a) + arch="$OPTARG" + ;; + d) + strictDebootstrap=1 + ;; + s) + skipDetection=1 + ;; + t) + justTar=1 + ;; + ?) + usage + exit 0 + ;; + esac +done +shift $(($OPTIND - 1)) + +repo="$1" +suite="$2" +mirror="${3:-}" # stick to the default debootstrap mirror if one is not provided + +if [ ! "$repo" ] || [ ! "$suite" ]; then + usage + exit 1 +fi + +# some rudimentary detection for whether we need to "sudo" our docker calls +docker='' +if docker version > /dev/null 2>&1; then + docker='docker' +elif sudo docker version > /dev/null 2>&1; then + docker='sudo docker' +elif command -v docker > /dev/null 2>&1; then + docker='docker' +else + echo >&2 "warning: either docker isn't installed, or your current user cannot run it;" + echo >&2 " this script is not likely to work as expected" + sleep 3 + docker='docker' # give us a command-not-found later +fi + +# make sure we have an absolute path to our final tarball so we can still reference it properly after we change directory +if [ "$justTar" ]; then + if [ ! -d "$(dirname "$repo")" ]; then + echo >&2 "error: $(dirname "$repo") does not exist" + exit 1 + fi + repo="$(cd "$(dirname "$repo")" && pwd -P)/$(basename "$repo")" +fi + +# will be filled in later, if [ -z "$skipDetection" ] +lsbDist='' + +target="${TMPDIR:-/var/tmp}/docker-rootfs-debootstrap-$suite-$$-$RANDOM" + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" +returnTo="$(pwd -P)" + +if [ "$suite" = 'lucid' ]; then + # lucid fails and doesn't include gpgv in minbase; "apt-get update" fails + include+=',gpgv' +fi + +set -x + +# bootstrap +mkdir -p "$target" +sudo http_proxy=$http_proxy debootstrap --verbose --variant="$variant" --include="$include" --arch="$arch" "$suite" "$target" "$mirror" + +cd "$target" + +if [ -z "$strictDebootstrap" ]; then + # prevent init scripts from running during install/update + # policy-rc.d (for most scripts) + echo $'#!/bin/sh\nexit 101' | sudo tee usr/sbin/policy-rc.d > /dev/null + sudo chmod +x usr/sbin/policy-rc.d + # initctl (for some pesky upstart scripts) + sudo chroot . dpkg-divert --local --rename --add /sbin/initctl + sudo ln -sf /bin/true sbin/initctl + # see https://github.com/docker/docker/issues/446#issuecomment-16953173 + + # shrink the image, since apt makes us fat (wheezy: ~157.5MB vs ~120MB) + sudo chroot . apt-get clean + + if strings usr/bin/dpkg | grep -q unsafe-io; then + # while we're at it, apt is unnecessarily slow inside containers + # this forces dpkg not to call sync() after package extraction and speeds up install + # the benefit is huge on spinning disks, and the penalty is nonexistent on SSD or decent server virtualization + echo 'force-unsafe-io' | sudo tee etc/dpkg/dpkg.cfg.d/02apt-speedup > /dev/null + # we have this wrapped up in an "if" because the "force-unsafe-io" + # option was added in dpkg 1.15.8.6 + # (see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=584254#82), + # and ubuntu lucid/10.04 only has 1.15.5.6 + fi + + # we want to effectively run "apt-get clean" after every install to keep images small (see output of "apt-get clean -s" for context) + { + aptGetClean='"rm -f /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin || true";' + echo "DPkg::Post-Invoke { ${aptGetClean} };" + echo "APT::Update::Post-Invoke { ${aptGetClean} };" + echo 'Dir::Cache::pkgcache ""; Dir::Cache::srcpkgcache "";' + } | sudo tee etc/apt/apt.conf.d/no-cache > /dev/null + + # and remove the translations, too + echo 'Acquire::Languages "none";' | sudo tee etc/apt/apt.conf.d/no-languages > /dev/null + + # helpful undo lines for each the above tweaks (for lack of a better home to keep track of them): + # rm /usr/sbin/policy-rc.d + # rm /sbin/initctl; dpkg-divert --rename --remove /sbin/initctl + # rm /etc/dpkg/dpkg.cfg.d/02apt-speedup + # rm /etc/apt/apt.conf.d/no-cache + # rm /etc/apt/apt.conf.d/no-languages + + if [ -z "$skipDetection" ]; then + # see also rudimentary platform detection in hack/install.sh + lsbDist='' + if [ -r etc/lsb-release ]; then + lsbDist="$(. etc/lsb-release && echo "$DISTRIB_ID")" + fi + if [ -z "$lsbDist" ] && [ -r etc/debian_version ]; then + lsbDist='Debian' + fi + + case "$lsbDist" in + Debian) + # add the updates and security repositories + if [ "$suite" != "$debianUnstable" -a "$suite" != 'unstable' ]; then + # ${suite}-updates only applies to non-unstable + sudo sed -i "p; s/ $suite main$/ ${suite}-updates main/" etc/apt/sources.list + + # same for security updates + echo "deb http://security.debian.org/ $suite/updates main" | sudo tee -a etc/apt/sources.list > /dev/null + fi + ;; + Ubuntu) + # add the universe, updates, and security repositories + sudo sed -i " + s/ $suite main$/ $suite main universe/; p; + s/ $suite main/ ${suite}-updates main/; p; + s/ $suite-updates main/ ${suite}-security main/ + " etc/apt/sources.list + ;; + Tanglu) + # add the updates repository + if [ "$suite" = "$tangluLatest" ]; then + # ${suite}-updates only applies to stable Tanglu versions + sudo sed -i "p; s/ $suite main$/ ${suite}-updates main/" etc/apt/sources.list + fi + ;; + SteamOS) + # add contrib and non-free + sudo sed -i "s/ $suite main$/ $suite main contrib non-free/" etc/apt/sources.list + ;; + esac + fi + + # make sure our packages lists are as up to date as we can get them + sudo chroot . apt-get update + sudo chroot . apt-get dist-upgrade -y +fi + +if [ "$justTar" ]; then + # create the tarball file so it has the right permissions (ie, not root) + touch "$repo" + + # fill the tarball + sudo tar --numeric-owner -caf "$repo" . +else + # create the image (and tag $repo:$suite) + sudo tar --numeric-owner -c . | $docker import - $repo:$suite + + # test the image + $docker run -i -t $repo:$suite echo success + + if [ -z "$skipDetection" ]; then + case "$lsbDist" in + Debian) + if [ "$suite" = "$debianStable" -o "$suite" = 'stable' ] && [ -r etc/debian_version ]; then + # tag latest + $docker tag $repo:$suite $repo:latest + + if [ -r etc/debian_version ]; then + # tag the specific debian release version (which is only reasonable to tag on debian stable) + ver=$(cat etc/debian_version) + $docker tag $repo:$suite $repo:$ver + fi + fi + ;; + Ubuntu) + if [ "$suite" = "$ubuntuLatestLTS" ]; then + # tag latest + $docker tag $repo:$suite $repo:latest + fi + if [ -r etc/lsb-release ]; then + lsbRelease="$(. etc/lsb-release && echo "$DISTRIB_RELEASE")" + if [ "$lsbRelease" ]; then + # tag specific Ubuntu version number, if available (12.04, etc.) + $docker tag $repo:$suite $repo:$lsbRelease + fi + fi + ;; + Tanglu) + if [ "$suite" = "$tangluLatest" ]; then + # tag latest + $docker tag $repo:$suite $repo:latest + fi + if [ -r etc/lsb-release ]; then + lsbRelease="$(. etc/lsb-release && echo "$DISTRIB_RELEASE")" + if [ "$lsbRelease" ]; then + # tag specific Tanglu version number, if available (1.0, 2.0, etc.) + $docker tag $repo:$suite $repo:$lsbRelease + fi + fi + ;; + SteamOS) + if [ -r etc/lsb-release ]; then + lsbRelease="$(. etc/lsb-release && echo "$DISTRIB_RELEASE")" + if [ "$lsbRelease" ]; then + # tag specific SteamOS version number, if available (1.0, 2.0, etc.) + $docker tag $repo:$suite $repo:$lsbRelease + fi + fi + ;; + esac + fi +fi + +# cleanup +cd "$returnTo" +sudo rm -rf "$target" diff --git a/contrib/mkimage-rinse.sh b/contrib/mkimage-rinse.sh new file mode 100755 index 0000000000..7e0935062f --- /dev/null +++ b/contrib/mkimage-rinse.sh @@ -0,0 +1,123 @@ +#!/usr/bin/env bash +# +# Create a base CentOS Docker image. + +# This script is useful on systems with rinse available (e.g., +# building a CentOS image on Debian). See contrib/mkimage-yum.sh for +# a way to build CentOS images on systems with yum installed. + +set -e + +echo >&2 +echo >&2 'warning: this script is deprecated - see mkimage.sh and mkimage/rinse' +echo >&2 + +repo="$1" +distro="$2" +mirror="$3" + +if [ ! "$repo" ] || [ ! "$distro" ]; then + self="$(basename $0)" + echo >&2 "usage: $self repo distro [mirror]" + echo >&2 + echo >&2 " ie: $self username/centos centos-5" + echo >&2 " $self username/centos centos-6" + echo >&2 + echo >&2 " ie: $self username/slc slc-5" + echo >&2 " $self username/slc slc-6" + echo >&2 + echo >&2 " ie: $self username/centos centos-5 http://vault.centos.org/5.8/os/x86_64/CentOS/" + echo >&2 " $self username/centos centos-6 http://vault.centos.org/6.3/os/x86_64/Packages/" + echo >&2 + echo >&2 'See /etc/rinse for supported values of "distro" and for examples of' + echo >&2 ' expected values of "mirror".' + echo >&2 + echo >&2 'This script is tested to work with the original upstream version of rinse,' + echo >&2 ' found at http://www.steve.org.uk/Software/rinse/ and also in Debian at' + echo >&2 ' http://packages.debian.org/wheezy/rinse -- as always, YMMV.' + echo >&2 + exit 1 +fi + +target="${TMPDIR:-/var/tmp}/docker-rootfs-rinse-$distro-$$-$RANDOM" + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" +returnTo="$(pwd -P)" + +rinseArgs=( --arch amd64 --distribution "$distro" --directory "$target" ) +if [ "$mirror" ]; then + rinseArgs+=( --mirror "$mirror" ) +fi + +set -x + +mkdir -p "$target" + +sudo rinse "${rinseArgs[@]}" + +cd "$target" + +# rinse fails a little at setting up /dev, so we'll just wipe it out and create our own +sudo rm -rf dev +sudo mkdir -m 755 dev +( + cd dev + sudo ln -sf /proc/self/fd ./ + sudo mkdir -m 755 pts + sudo mkdir -m 1777 shm + sudo mknod -m 600 console c 5 1 + sudo mknod -m 600 initctl p + sudo mknod -m 666 full c 1 7 + sudo mknod -m 666 null c 1 3 + sudo mknod -m 666 ptmx c 5 2 + sudo mknod -m 666 random c 1 8 + sudo mknod -m 666 tty c 5 0 + sudo mknod -m 666 tty0 c 4 0 + sudo mknod -m 666 urandom c 1 9 + sudo mknod -m 666 zero c 1 5 +) + +# effectively: febootstrap-minimize --keep-zoneinfo --keep-rpmdb --keep-services "$target" +# locales +sudo rm -rf usr/{{lib,share}/locale,{lib,lib64}/gconv,bin/localedef,sbin/build-locale-archive} +# docs and man pages +sudo rm -rf usr/share/{man,doc,info,gnome/help} +# cracklib +sudo rm -rf usr/share/cracklib +# i18n +sudo rm -rf usr/share/i18n +# yum cache +sudo rm -rf var/cache/yum +sudo mkdir -p --mode=0755 var/cache/yum +# sln +sudo rm -rf sbin/sln +# ldconfig +#sudo rm -rf sbin/ldconfig +sudo rm -rf etc/ld.so.cache var/cache/ldconfig +sudo mkdir -p --mode=0755 var/cache/ldconfig + +# allow networking init scripts inside the container to work without extra steps +echo 'NETWORKING=yes' | sudo tee etc/sysconfig/network > /dev/null + +# to restore locales later: +# yum reinstall glibc-common + +version= +if [ -r etc/redhat-release ]; then + version="$(sed -E 's/^[^0-9.]*([0-9.]+).*$/\1/' etc/redhat-release)" +elif [ -r etc/SuSE-release ]; then + version="$(awk '/^VERSION/ { print $3 }' etc/SuSE-release)" +fi + +if [ -z "$version" ]; then + echo >&2 "warning: cannot autodetect OS version, using $distro as tag" + sleep 20 + version="$distro" +fi + +sudo tar --numeric-owner -c . | docker import - $repo:$version + +docker run -i -t $repo:$version echo success + +cd "$returnTo" +sudo rm -rf "$target" diff --git a/contrib/mkimage-yum.sh b/contrib/mkimage-yum.sh new file mode 100755 index 0000000000..f48cb4340f --- /dev/null +++ b/contrib/mkimage-yum.sh @@ -0,0 +1,108 @@ +#!/usr/bin/env bash +# +# Create a base CentOS Docker image. +# +# This script is useful on systems with yum installed (e.g., building +# a CentOS image on CentOS). See contrib/mkimage-rinse.sh for a way +# to build CentOS images on other systems. + +usage() { + cat < +OPTIONS: + -y The path to the yum config to install packages from. The + default is /etc/yum.conf. +EOOPTS + exit 1 +} + +# option defaults +yum_config=/etc/yum.conf +while getopts ":y:h" opt; do + case $opt in + y) + yum_config=$OPTARG + ;; + h) + usage + ;; + \?) + echo "Invalid option: -$OPTARG" + usage + ;; + esac +done +shift $((OPTIND - 1)) +name=$1 + +if [[ -z $name ]]; then + usage +fi + +#-------------------- + +target=$(mktemp -d --tmpdir $(basename $0).XXXXXX) + +set -x + +mkdir -m 755 "$target"/dev +mknod -m 600 "$target"/dev/console c 5 1 +mknod -m 600 "$target"/dev/initctl p +mknod -m 666 "$target"/dev/full c 1 7 +mknod -m 666 "$target"/dev/null c 1 3 +mknod -m 666 "$target"/dev/ptmx c 5 2 +mknod -m 666 "$target"/dev/random c 1 8 +mknod -m 666 "$target"/dev/tty c 5 0 +mknod -m 666 "$target"/dev/tty0 c 4 0 +mknod -m 666 "$target"/dev/urandom c 1 9 +mknod -m 666 "$target"/dev/zero c 1 5 + +# amazon linux yum will fail without vars set +if [ -d /etc/yum/vars ]; then + mkdir -p -m 755 "$target"/etc/yum + cp -a /etc/yum/vars "$target"/etc/yum/ +fi + +yum -c "$yum_config" --installroot="$target" --releasever=/ --setopt=tsflags=nodocs \ + --setopt=group_package_types=mandatory -y groupinstall Core +yum -c "$yum_config" --installroot="$target" -y clean all + +cat > "$target"/etc/sysconfig/network <&2 "warning: cannot autodetect OS version, using '$name' as tag" + version=$name +fi + +tar --numeric-owner -c -C "$target" . | docker import - $name:$version +docker run -i -t $name:$version echo success + +rm -rf "$target" diff --git a/contrib/mkimage.sh b/contrib/mkimage.sh new file mode 100755 index 0000000000..3976d72d9f --- /dev/null +++ b/contrib/mkimage.sh @@ -0,0 +1,117 @@ +#!/usr/bin/env bash +set -e + +mkimg="$(basename "$0")" + +usage() { + echo >&2 "usage: $mkimg [-d dir] [-t tag] [--compression algo| --no-compression] script [script-args]" + echo >&2 " ie: $mkimg -t someuser/debian debootstrap --variant=minbase jessie" + echo >&2 " $mkimg -t someuser/ubuntu debootstrap --include=ubuntu-minimal --components=main,universe trusty" + echo >&2 " $mkimg -t someuser/busybox busybox-static" + echo >&2 " $mkimg -t someuser/centos:5 rinse --distribution centos-5" + echo >&2 " $mkimg -t someuser/mageia:4 mageia-urpmi --version=4" + echo >&2 " $mkimg -t someuser/mageia:4 mageia-urpmi --version=4 --mirror=http://somemirror/" + exit 1 +} + +scriptDir="$(dirname "$(readlink -f "$BASH_SOURCE")")/mkimage" + +optTemp=$(getopt --options '+d:t:c:hC' --longoptions 'dir:,tag:,compression:,no-compression,help' --name "$mkimg" -- "$@") +eval set -- "$optTemp" +unset optTemp + +dir= +tag= +compression="auto" +while true; do + case "$1" in + -d|--dir) dir="$2" ; shift 2 ;; + -t|--tag) tag="$2" ; shift 2 ;; + --compression) compression="$2" ; shift 2 ;; + --no-compression) compression="none" ; shift 1 ;; + -h|--help) usage ;; + --) shift ; break ;; + esac +done + +script="$1" +[ "$script" ] || usage +shift + +if [ "$compression" == 'auto' ] || [ -z "$compression" ] +then + compression='xz' +fi + +[ "$compression" == 'none' ] && compression='' + +if [ ! -x "$scriptDir/$script" ]; then + echo >&2 "error: $script does not exist or is not executable" + echo >&2 " see $scriptDir for possible scripts" + exit 1 +fi + +# don't mistake common scripts like .febootstrap-minimize as image-creators +if [[ "$script" == .* ]]; then + echo >&2 "error: $script is a script helper, not a script" + echo >&2 " see $scriptDir for possible scripts" + exit 1 +fi + +delDir= +if [ -z "$dir" ]; then + dir="$(mktemp -d ${TMPDIR:-/var/tmp}/docker-mkimage.XXXXXXXXXX)" + delDir=1 +fi + +rootfsDir="$dir/rootfs" +( set -x; mkdir -p "$rootfsDir" ) + +# pass all remaining arguments to $script +"$scriptDir/$script" "$rootfsDir" "$@" + +# Docker mounts tmpfs at /dev and procfs at /proc so we can remove them +rm -rf "$rootfsDir/dev" "$rootfsDir/proc" +mkdir -p "$rootfsDir/dev" "$rootfsDir/proc" + +# make sure /etc/resolv.conf has something useful in it +mkdir -p "$rootfsDir/etc" +cat > "$rootfsDir/etc/resolv.conf" <<'EOF' +nameserver 8.8.8.8 +nameserver 8.8.4.4 +EOF + +tarFile="$dir/rootfs.tar${compression:+.$compression}" +touch "$tarFile" + +( + set -x + tar --numeric-owner --create --auto-compress --file "$tarFile" --directory "$rootfsDir" --transform='s,^./,,' . +) + +echo >&2 "+ cat > '$dir/Dockerfile'" +cat > "$dir/Dockerfile" <> "$dir/Dockerfile" ) + break + fi +done + +( set -x; rm -rf "$rootfsDir" ) + +if [ "$tag" ]; then + ( set -x; docker build -t "$tag" "$dir" ) +elif [ "$delDir" ]; then + # if we didn't specify a tag and we're going to delete our dir, let's just build an untagged image so that we did _something_ + ( set -x; docker build "$dir" ) +fi + +if [ "$delDir" ]; then + ( set -x; rm -rf "$dir" ) +fi diff --git a/contrib/mkimage/.febootstrap-minimize b/contrib/mkimage/.febootstrap-minimize new file mode 100755 index 0000000000..7749e63fb0 --- /dev/null +++ b/contrib/mkimage/.febootstrap-minimize @@ -0,0 +1,28 @@ +#!/usr/bin/env bash +set -e + +rootfsDir="$1" +shift + +( + cd "$rootfsDir" + + # effectively: febootstrap-minimize --keep-zoneinfo --keep-rpmdb --keep-services "$target" + # locales + rm -rf usr/{{lib,share}/locale,{lib,lib64}/gconv,bin/localedef,sbin/build-locale-archive} + # docs and man pages + rm -rf usr/share/{man,doc,info,gnome/help} + # cracklib + rm -rf usr/share/cracklib + # i18n + rm -rf usr/share/i18n + # yum cache + rm -rf var/cache/yum + mkdir -p --mode=0755 var/cache/yum + # sln + rm -rf sbin/sln + # ldconfig + #rm -rf sbin/ldconfig + rm -rf etc/ld.so.cache var/cache/ldconfig + mkdir -p --mode=0755 var/cache/ldconfig +) diff --git a/contrib/mkimage/busybox-static b/contrib/mkimage/busybox-static new file mode 100755 index 0000000000..e15322b49d --- /dev/null +++ b/contrib/mkimage/busybox-static @@ -0,0 +1,34 @@ +#!/usr/bin/env bash +set -e + +rootfsDir="$1" +shift + +busybox="$(which busybox 2>/dev/null || true)" +if [ -z "$busybox" ]; then + echo >&2 'error: busybox: not found' + echo >&2 ' install it with your distribution "busybox-static" package' + exit 1 +fi +if ! ldd "$busybox" 2>&1 | grep -q 'not a dynamic executable'; then + echo >&2 "error: '$busybox' appears to be a dynamic executable" + echo >&2 ' you should install your distribution "busybox-static" package instead' + exit 1 +fi + +mkdir -p "$rootfsDir/bin" +rm -f "$rootfsDir/bin/busybox" # just in case +cp "$busybox" "$rootfsDir/bin/busybox" + +( + cd "$rootfsDir" + + IFS=$'\n' + modules=( $(bin/busybox --list-modules) ) + unset IFS + + for module in "${modules[@]}"; do + mkdir -p "$(dirname "$module")" + ln -sf /bin/busybox "$module" + done +) diff --git a/contrib/mkimage/debootstrap b/contrib/mkimage/debootstrap new file mode 100755 index 0000000000..c613d5375d --- /dev/null +++ b/contrib/mkimage/debootstrap @@ -0,0 +1,240 @@ +#!/usr/bin/env bash +set -e + +rootfsDir="$1" +shift + +# we have to do a little fancy footwork to make sure "rootfsDir" becomes the second non-option argument to debootstrap + +before=() +while [ $# -gt 0 ] && [[ "$1" == -* ]]; do + before+=( "$1" ) + shift +done + +suite="$1" +shift + +# get path to "chroot" in our current PATH +chrootPath="$(type -P chroot)" +rootfs_chroot() { + # "chroot" doesn't set PATH, so we need to set it explicitly to something our new debootstrap chroot can use appropriately! + + # set PATH and chroot away! + PATH='/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' \ + "$chrootPath" "$rootfsDir" "$@" +} + +# allow for DEBOOTSTRAP=qemu-debootstrap ./mkimage.sh ... +: ${DEBOOTSTRAP:=debootstrap} + +( + set -x + $DEBOOTSTRAP "${before[@]}" "$suite" "$rootfsDir" "$@" +) + +# now for some Docker-specific tweaks + +# prevent init scripts from running during install/update +echo >&2 "+ echo exit 101 > '$rootfsDir/usr/sbin/policy-rc.d'" +cat > "$rootfsDir/usr/sbin/policy-rc.d" <<-'EOF' + #!/bin/sh + + # For most Docker users, "apt-get install" only happens during "docker build", + # where starting services doesn't work and often fails in humorous ways. This + # prevents those failures by stopping the services from attempting to start. + + exit 101 +EOF +chmod +x "$rootfsDir/usr/sbin/policy-rc.d" + +# prevent upstart scripts from running during install/update +( + set -x + rootfs_chroot dpkg-divert --local --rename --add /sbin/initctl + cp -a "$rootfsDir/usr/sbin/policy-rc.d" "$rootfsDir/sbin/initctl" + sed -i 's/^exit.*/exit 0/' "$rootfsDir/sbin/initctl" +) + +# shrink a little, since apt makes us cache-fat (wheezy: ~157.5MB vs ~120MB) +( set -x; rootfs_chroot apt-get clean ) + +# this file is one APT creates to make sure we don't "autoremove" our currently +# in-use kernel, which doesn't really apply to debootstraps/Docker images that +# don't even have kernels installed +rm -f "$rootfsDir/etc/apt/apt.conf.d/01autoremove-kernels" + +# Ubuntu 10.04 sucks... :) +if strings "$rootfsDir/usr/bin/dpkg" | grep -q unsafe-io; then + # force dpkg not to call sync() after package extraction (speeding up installs) + echo >&2 "+ echo force-unsafe-io > '$rootfsDir/etc/dpkg/dpkg.cfg.d/docker-apt-speedup'" + cat > "$rootfsDir/etc/dpkg/dpkg.cfg.d/docker-apt-speedup" <<-'EOF' + # For most Docker users, package installs happen during "docker build", which + # doesn't survive power loss and gets restarted clean afterwards anyhow, so + # this minor tweak gives us a nice speedup (much nicer on spinning disks, + # obviously). + + force-unsafe-io + EOF +fi + +if [ -d "$rootfsDir/etc/apt/apt.conf.d" ]; then + # _keep_ us lean by effectively running "apt-get clean" after every install + aptGetClean='"rm -f /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin || true";' + echo >&2 "+ cat > '$rootfsDir/etc/apt/apt.conf.d/docker-clean'" + cat > "$rootfsDir/etc/apt/apt.conf.d/docker-clean" <<-EOF + # Since for most Docker users, package installs happen in "docker build" steps, + # they essentially become individual layers due to the way Docker handles + # layering, especially using CoW filesystems. What this means for us is that + # the caches that APT keeps end up just wasting space in those layers, making + # our layers unnecessarily large (especially since we'll normally never use + # these caches again and will instead just "docker build" again and make a brand + # new image). + + # Ideally, these would just be invoking "apt-get clean", but in our testing, + # that ended up being cyclic and we got stuck on APT's lock, so we get this fun + # creation that's essentially just "apt-get clean". + DPkg::Post-Invoke { ${aptGetClean} }; + APT::Update::Post-Invoke { ${aptGetClean} }; + + Dir::Cache::pkgcache ""; + Dir::Cache::srcpkgcache ""; + + # Note that we do realize this isn't the ideal way to do this, and are always + # open to better suggestions (https://github.com/docker/docker/issues). + EOF + + # remove apt-cache translations for fast "apt-get update" + echo >&2 "+ echo Acquire::Languages 'none' > '$rootfsDir/etc/apt/apt.conf.d/docker-no-languages'" + cat > "$rootfsDir/etc/apt/apt.conf.d/docker-no-languages" <<-'EOF' + # In Docker, we don't often need the "Translations" files, so we're just wasting + # time and space by downloading them, and this inhibits that. For users that do + # need them, it's a simple matter to delete this file and "apt-get update". :) + + Acquire::Languages "none"; + EOF + + echo >&2 "+ echo Acquire::GzipIndexes 'true' > '$rootfsDir/etc/apt/apt.conf.d/docker-gzip-indexes'" + cat > "$rootfsDir/etc/apt/apt.conf.d/docker-gzip-indexes" <<-'EOF' + # Since Docker users using "RUN apt-get update && apt-get install -y ..." in + # their Dockerfiles don't go delete the lists files afterwards, we want them to + # be as small as possible on-disk, so we explicitly request "gz" versions and + # tell Apt to keep them gzipped on-disk. + + # For comparison, an "apt-get update" layer without this on a pristine + # "debian:wheezy" base image was "29.88 MB", where with this it was only + # "8.273 MB". + + Acquire::GzipIndexes "true"; + Acquire::CompressionTypes::Order:: "gz"; + EOF + + # update "autoremove" configuration to be aggressive about removing suggests deps that weren't manually installed + echo >&2 "+ echo Apt::AutoRemove::SuggestsImportant 'false' > '$rootfsDir/etc/apt/apt.conf.d/docker-autoremove-suggests'" + cat > "$rootfsDir/etc/apt/apt.conf.d/docker-autoremove-suggests" <<-'EOF' + # Since Docker users are looking for the smallest possible final images, the + # following emerges as a very common pattern: + + # RUN apt-get update \ + # && apt-get install -y \ + # && \ + # && apt-get purge -y --auto-remove + + # By default, APT will actually _keep_ packages installed via Recommends or + # Depends if another package Suggests them, even and including if the package + # that originally caused them to be installed is removed. Setting this to + # "false" ensures that APT is appropriately aggressive about removing the + # packages it added. + + # https://aptitude.alioth.debian.org/doc/en/ch02s05s05.html#configApt-AutoRemove-SuggestsImportant + Apt::AutoRemove::SuggestsImportant "false"; + EOF +fi + +if [ -z "$DONT_TOUCH_SOURCES_LIST" ]; then + # tweak sources.list, where appropriate + lsbDist= + if [ -z "$lsbDist" -a -r "$rootfsDir/etc/os-release" ]; then + lsbDist="$(. "$rootfsDir/etc/os-release" && echo "$ID")" + fi + if [ -z "$lsbDist" -a -r "$rootfsDir/etc/lsb-release" ]; then + lsbDist="$(. "$rootfsDir/etc/lsb-release" && echo "$DISTRIB_ID")" + fi + if [ -z "$lsbDist" -a -r "$rootfsDir/etc/debian_version" ]; then + lsbDist='Debian' + fi + # normalize to lowercase for easier matching + lsbDist="$(echo "$lsbDist" | tr '[:upper:]' '[:lower:]')" + case "$lsbDist" in + debian) + # updates and security! + if [ "$suite" != 'sid' -a "$suite" != 'unstable' ]; then + ( + set -x + sed -i " + p; + s/ $suite / ${suite}-updates / + " "$rootfsDir/etc/apt/sources.list" + echo "deb http://security.debian.org $suite/updates main" >> "$rootfsDir/etc/apt/sources.list" + # squeeze-lts + if [ -f "$rootfsDir/etc/debian_version" ]; then + ltsSuite= + case "$(cat "$rootfsDir/etc/debian_version")" in + 6.*) ltsSuite='squeeze-lts' ;; + #7.*) ltsSuite='wheezy-lts' ;; + #8.*) ltsSuite='jessie-lts' ;; + esac + if [ "$ltsSuite" ]; then + head -1 "$rootfsDir/etc/apt/sources.list" \ + | sed "s/ $suite / $ltsSuite /" \ + >> "$rootfsDir/etc/apt/sources.list" + fi + fi + ) + fi + ;; + ubuntu) + # add the updates and security repositories + ( + set -x + sed -i " + p; + s/ $suite / ${suite}-updates /; p; + s/ $suite-updates / ${suite}-security / + " "$rootfsDir/etc/apt/sources.list" + ) + ;; + tanglu) + # add the updates repository + if [ "$suite" != 'devel' ]; then + ( + set -x + sed -i " + p; + s/ $suite / ${suite}-updates / + " "$rootfsDir/etc/apt/sources.list" + ) + fi + ;; + steamos) + # add contrib and non-free if "main" is the only component + ( + set -x + sed -i "s/ $suite main$/ $suite main contrib non-free/" "$rootfsDir/etc/apt/sources.list" + ) + ;; + esac +fi + +( + set -x + + # make sure we're fully up-to-date + rootfs_chroot sh -xc 'apt-get update && apt-get dist-upgrade -y' + + # delete all the apt list files since they're big and get stale quickly + rm -rf "$rootfsDir/var/lib/apt/lists"/* + # this forces "apt-get update" in dependent images, which is also good + + mkdir "$rootfsDir/var/lib/apt/lists/partial" # Lucid... "E: Lists directory /var/lib/apt/lists/partial is missing." +) diff --git a/contrib/mkimage/mageia-urpmi b/contrib/mkimage/mageia-urpmi new file mode 100755 index 0000000000..93fb289cac --- /dev/null +++ b/contrib/mkimage/mageia-urpmi @@ -0,0 +1,61 @@ +#!/usr/bin/env bash +# +# Needs to be run from Mageia 4 or greater for kernel support for docker. +# +# Mageia 4 does not have docker available in official repos, so please +# install and run the docker binary manually. +# +# Tested working versions are for Mageia 2 onwards (inc. cauldron). +# +set -e + +rootfsDir="$1" +shift + +optTemp=$(getopt --options '+v:,m:' --longoptions 'version:,mirror:' --name mageia-urpmi -- "$@") +eval set -- "$optTemp" +unset optTemp + +installversion= +mirror= +while true; do + case "$1" in + -v|--version) installversion="$2" ; shift 2 ;; + -m|--mirror) mirror="$2" ; shift 2 ;; + --) shift ; break ;; + esac +done + +if [ -z $installversion ]; then + # Attempt to match host version + if [ -r /etc/mageia-release ]; then + installversion="$(sed 's/^[^0-9\]*\([0-9.]\+\).*$/\1/' /etc/mageia-release)" + else + echo "Error: no version supplied and unable to detect host mageia version" + exit 1 + fi +fi + +if [ -z $mirror ]; then + # No mirror provided, default to mirrorlist + mirror="--mirrorlist https://mirrors.mageia.org/api/mageia.$installversion.x86_64.list" +fi + +( + set -x + urpmi.addmedia --distrib \ + $mirror \ + --urpmi-root "$rootfsDir" + urpmi basesystem-minimal urpmi \ + --auto \ + --no-suggests \ + --urpmi-root "$rootfsDir" \ + --root "$rootfsDir" +) + +"$(dirname "$BASH_SOURCE")/.febootstrap-minimize" "$rootfsDir" + +if [ -d "$rootfsDir/etc/sysconfig" ]; then + # allow networking init scripts inside the container to work without extra steps + echo 'NETWORKING=yes' > "$rootfsDir/etc/sysconfig/network" +fi diff --git a/contrib/mkimage/rinse b/contrib/mkimage/rinse new file mode 100755 index 0000000000..75eb4f0d9d --- /dev/null +++ b/contrib/mkimage/rinse @@ -0,0 +1,25 @@ +#!/usr/bin/env bash +set -e + +rootfsDir="$1" +shift + +# specifying --arch below is safe because "$@" can override it and the "latest" one wins :) + +( + set -x + rinse --directory "$rootfsDir" --arch amd64 "$@" +) + +"$(dirname "$BASH_SOURCE")/.febootstrap-minimize" "$rootfsDir" + +if [ -d "$rootfsDir/etc/sysconfig" ]; then + # allow networking init scripts inside the container to work without extra steps + echo 'NETWORKING=yes' > "$rootfsDir/etc/sysconfig/network" +fi + +# make sure we're fully up-to-date, too +( + set -x + chroot "$rootfsDir" yum update -y +) diff --git a/contrib/mkseccomp.pl b/contrib/mkseccomp.pl new file mode 100755 index 0000000000..28d0645af0 --- /dev/null +++ b/contrib/mkseccomp.pl @@ -0,0 +1,77 @@ +#!/usr/bin/perl +# +# A simple helper script to help people build seccomp profiles for +# Docker/LXC. The goal is mostly to reduce the attack surface to the +# kernel, by restricting access to rarely used, recently added or not used +# syscalls. +# +# This script processes one or more files which contain the list of system +# calls to be allowed. See mkseccomp.sample for more information how you +# can configure the list of syscalls. When run, this script produces output +# which, when stored in a file, can be passed to docker as follows: +# +# docker run --lxc-conf="lxc.seccomp=$file" +# +# The included sample file shows how to cut about a quarter of all syscalls, +# which affecting most applications. +# +# For specific situations it is possible to reduce the list further. By +# reducing the list to just those syscalls required by a certain application +# you can make it difficult for unknown/unexpected code to run. +# +# Run this script as follows: +# +# ./mkseccomp.pl < mkseccomp.sample >syscalls.list +# or +# ./mkseccomp.pl mkseccomp.sample >syscalls.list +# +# Multiple files can be specified, in which case the lists of syscalls are +# combined. +# +# By Martijn van Oosterhout Nov 2013 + +# How it works: +# +# This program basically spawns two processes to form a chain like: +# +# | cpp | + +use strict; +use warnings; + +if( -t ) { + print STDERR "Helper script to make seccomp filters for Docker/LXC.\n"; + print STDERR "Usage: mkseccomp.pl < [files...]\n"; + exit 1; +} + +my $pid = open(my $in, "-|") // die "Couldn't fork1 ($!)\n"; + +if($pid == 0) { # Child + $pid = open(my $out, "|-") // die "Couldn't fork2 ($!)\n"; + + if($pid == 0) { # Child, which execs cpp + exec "cpp" or die "Couldn't exec cpp ($!)\n"; + exit 1; + } + + # Process the DATA section and output to cpp + print $out "#include \n"; + while(<>) { + if(/^\w/) { + print $out "__NR_$_"; + } + } + close $out; + exit 0; + +} + +# Print header and then process output from cpp. +print "1\n"; +print "whitelist\n"; + +while(<$in>) { + print if( /^[0-9]/ ); +} + diff --git a/contrib/mkseccomp.sample b/contrib/mkseccomp.sample new file mode 100644 index 0000000000..a9131e4b1a --- /dev/null +++ b/contrib/mkseccomp.sample @@ -0,0 +1,444 @@ +/* This sample file is an example for mkseccomp.pl to produce a seccomp file + * which restricts syscalls that are only useful for an admin but allows the + * vast majority of normal userspace programs to run normally. + * + * The format of this file is one line per syscall. This is then processed + * and passed to 'cpp' to convert the names to numbers using whatever is + * correct for your platform. As such C-style comments are permitted. Note + * this also means that C preprocessor macros are also allowed. So it is + * possible to create groups surrounded by #ifdef/#endif and control their + * inclusion via #define (not #include). + * + * Syscalls that don't exist on your architecture are silently filtered out. + * Syscalls marked with (*) are required for a container to spawn a bash + * shell successfully (not necessarily full featured). Listing the same + * syscall multiple times is no problem. + * + * If you want to make a list specifically for one application the easiest + * way is to run the application under strace, like so: + * + * $ strace -f -q -c -o strace.out application args... + * + * Once you have a reasonable sample of the execution of the program, exit + * it. The file strace.out will have a summary of the syscalls used. Copy + * that list into this file, comment out everything else except the starred + * syscalls (which you need for the container to start) and you're done. + * + * To get the list of syscalls from the strace output this works well for + * me + * + * $ cut -c52 < strace.out + * + * This sample list was compiled as a combination of all the syscalls + * available on i386 and amd64 on Ubuntu Precise, as such it may not contain + * everything and not everything may be relevant for your system. This + * shouldn't be a problem. + */ + +// Filesystem/File descriptor related +access // (*) +chdir // (*) +chmod +chown +chown32 +close // (*) +creat +dup // (*) +dup2 // (*) +dup3 +epoll_create +epoll_create1 +epoll_ctl +epoll_ctl_old +epoll_pwait +epoll_wait +epoll_wait_old +eventfd +eventfd2 +faccessat // (*) +fadvise64 +fadvise64_64 +fallocate +fanotify_init +fanotify_mark +ioctl // (*) +fchdir +fchmod +fchmodat +fchown +fchown32 +fchownat +fcntl // (*) +fcntl64 +fdatasync +fgetxattr +flistxattr +flock +fremovexattr +fsetxattr +fstat // (*) +fstat64 +fstatat64 +fstatfs +fstatfs64 +fsync +ftruncate +ftruncate64 +getcwd // (*) +getdents // (*) +getdents64 +getxattr +inotify_add_watch +inotify_init +inotify_init1 +inotify_rm_watch +io_cancel +io_destroy +io_getevents +io_setup +io_submit +lchown +lchown32 +lgetxattr +link +linkat +listxattr +llistxattr +llseek +_llseek +lremovexattr +lseek // (*) +lsetxattr +lstat +lstat64 +mkdir +mkdirat +mknod +mknodat +newfstatat +_newselect +oldfstat +oldlstat +oldolduname +oldstat +olduname +oldwait4 +open // (*) +openat // (*) +pipe // (*) +pipe2 +poll +ppoll +pread64 +preadv +futimesat +pselect6 +pwrite64 +pwritev +read // (*) +readahead +readdir +readlink +readlinkat +readv +removexattr +rename +renameat +rmdir +select +sendfile +sendfile64 +setxattr +splice +stat // (*) +stat64 +statfs // (*) +statfs64 +symlink +symlinkat +sync +sync_file_range +sync_file_range2 +syncfs +tee +truncate +truncate64 +umask +unlink +unlinkat +ustat +utime +utimensat +utimes +write // (*) +writev + +// Network related +accept +accept4 +bind // (*) +connect // (*) +getpeername +getsockname // (*) +getsockopt +listen +recv +recvfrom // (*) +recvmmsg +recvmsg +send +sendmmsg +sendmsg +sendto // (*) +setsockopt +shutdown +socket // (*) +socketcall +socketpair +sethostname // (*) + +// Signal related +pause +rt_sigaction // (*) +rt_sigpending +rt_sigprocmask // (*) +rt_sigqueueinfo +rt_sigreturn // (*) +rt_sigsuspend +rt_sigtimedwait +rt_tgsigqueueinfo +sigaction +sigaltstack // (*) +signal +signalfd +signalfd4 +sigpending +sigprocmask +sigreturn +sigsuspend + +// Other needed POSIX +alarm +brk // (*) +clock_adjtime +clock_getres +clock_gettime +clock_nanosleep +//clock_settime +gettimeofday +nanosleep +nice +sysinfo +syslog +time +timer_create +timer_delete +timerfd_create +timerfd_gettime +timerfd_settime +timer_getoverrun +timer_gettime +timer_settime +times +uname // (*) + +// Memory control +madvise +mbind +mincore +mlock +mlockall +mmap // (*) +mmap2 +mprotect // (*) +mremap +msync +munlock +munlockall +munmap // (*) +remap_file_pages +set_mempolicy +vmsplice + +// Process control +capget +capset // (*) +clone // (*) +execve // (*) +exit // (*) +exit_group // (*) +fork +getcpu +getpgid +getpgrp // (*) +getpid // (*) +getppid // (*) +getpriority +getresgid +getresgid32 +getresuid +getresuid32 +getrlimit // (*) +getrusage +getsid +getuid // (*) +getuid32 +getegid // (*) +getegid32 +geteuid // (*) +geteuid32 +getgid // (*) +getgid32 +getgroups +getgroups32 +getitimer +get_mempolicy +kill +//personality +prctl +prlimit64 +sched_getaffinity +sched_getparam +sched_get_priority_max +sched_get_priority_min +sched_getscheduler +sched_rr_get_interval +//sched_setaffinity +//sched_setparam +//sched_setscheduler +sched_yield +setfsgid +setfsgid32 +setfsuid +setfsuid32 +setgid +setgid32 +setgroups +setgroups32 +setitimer +setpgid // (*) +setpriority +setregid +setregid32 +setresgid +setresgid32 +setresuid +setresuid32 +setreuid +setreuid32 +setrlimit +setsid +setuid +setuid32 +ugetrlimit +vfork +wait4 // (*) +waitid +waitpid + +// IPC +ipc +mq_getsetattr +mq_notify +mq_open +mq_timedreceive +mq_timedsend +mq_unlink +msgctl +msgget +msgrcv +msgsnd +semctl +semget +semop +semtimedop +shmat +shmctl +shmdt +shmget + +// Linux specific, mostly needed for thread-related stuff +arch_prctl // (*) +get_robust_list +get_thread_area +gettid +futex // (*) +restart_syscall // (*) +set_robust_list // (*) +set_thread_area +set_tid_address // (*) +tgkill +tkill + +// Admin syscalls, these are blocked +//acct +//adjtimex +//bdflush +//chroot +//create_module +//delete_module +//get_kernel_syms // Obsolete +//idle // Obsolete +//init_module +//ioperm +//iopl +//ioprio_get +//ioprio_set +//kexec_load +//lookup_dcookie // oprofile only? +//migrate_pages // NUMA +//modify_ldt +//mount +//move_pages // NUMA +//name_to_handle_at // NFS server +//nfsservctl // NFS server +//open_by_handle_at // NFS server +//perf_event_open +//pivot_root +//process_vm_readv // For debugger +//process_vm_writev // For debugger +//ptrace // For debugger +//query_module +//quotactl +//reboot +//setdomainname +//setns +//settimeofday +//sgetmask // Obsolete +//ssetmask // Obsolete +//stime +//swapoff +//swapon +//_sysctl +//sysfs +//sys_setaltroot +//umount +//umount2 +//unshare +//uselib +//vhangup +//vm86 +//vm86old + +// Kernel key management +//add_key +//keyctl +//request_key + +// Unimplemented +//afs_syscall +//break +//ftime +//getpmsg +//gtty +//lock +//madvise1 +//mpx +//prof +//profil +//putpmsg +//security +//stty +//tuxcall +//ulimit +//vserver diff --git a/contrib/nuke-graph-directory.sh b/contrib/nuke-graph-directory.sh new file mode 100755 index 0000000000..99b527de15 --- /dev/null +++ b/contrib/nuke-graph-directory.sh @@ -0,0 +1,65 @@ +#!/bin/sh +set -e + +dir="$1" + +if [ -z "$dir" ]; then + { + echo 'This script is for destroying old /var/lib/docker directories more safely than' + echo ' "rm -rf", which can cause data loss or other serious issues.' + echo + echo "usage: $0 directory" + echo " ie: $0 /var/lib/docker" + } >&2 + exit 1 +fi + +if [ "$(id -u)" != 0 ]; then + echo >&2 "error: $0 must be run as root" + exit 1 +fi + +if [ ! -d "$dir" ]; then + echo >&2 "error: $dir is not a directory" + exit 1 +fi + +dir="$(readlink -f "$dir")" + +echo +echo "Nuking $dir ..." +echo ' (if this is wrong, press Ctrl+C NOW!)' +echo + +( set -x; sleep 10 ) +echo + +dir_in_dir() { + inner="$1" + outer="$2" + [ "${inner#$outer}" != "$inner" ] +} + +# let's start by unmounting any submounts in $dir +# (like -v /home:... for example - DON'T DELETE MY HOME DIRECTORY BRU!) +for mount in $(awk '{ print $5 }' /proc/self/mountinfo); do + mount="$(readlink -f "$mount" || true)" + if dir_in_dir "$mount" "$dir"; then + ( set -x; umount -f "$mount" ) + fi +done + +# now, let's go destroy individual btrfs subvolumes, if any exist +if command -v btrfs > /dev/null 2>&1; then + root="$(df "$dir" | awk 'NR>1 { print $NF }')" + root="${root%/}" # if root is "/", we want it to become "" + for subvol in $(btrfs subvolume list -o "$root/" 2>/dev/null | awk -F' path ' '{ print $2 }' | sort -r); do + subvolDir="$root/$subvol" + if dir_in_dir "$subvolDir" "$dir"; then + ( set -x; btrfs subvolume delete "$subvolDir" ) + fi + done +fi + +# finally, DESTROY ALL THINGS +( set -x; rm -rf "$dir" ) diff --git a/contrib/project-stats.sh b/contrib/project-stats.sh new file mode 100755 index 0000000000..2691c72ffb --- /dev/null +++ b/contrib/project-stats.sh @@ -0,0 +1,22 @@ +#!/usr/bin/env bash + +## Run this script from the root of the docker repository +## to query project stats useful to the maintainers. +## You will need to install `pulls` and `issues` from +## https://github.com/crosbymichael/pulls + +set -e + +echo -n "Open pulls: " +PULLS=$(pulls | wc -l); let PULLS=$PULLS-1 +echo $PULLS + +echo -n "Pulls alru: " +pulls alru + +echo -n "Open issues: " +ISSUES=$(issues list | wc -l); let ISSUES=$ISSUES-1 +echo $ISSUES + +echo -n "Issues alru: " +issues alru diff --git a/contrib/report-issue.sh b/contrib/report-issue.sh new file mode 100644 index 0000000000..cb54f1a5bc --- /dev/null +++ b/contrib/report-issue.sh @@ -0,0 +1,105 @@ +#!/bin/sh + +# This is a convenience script for reporting issues that include a base +# template of information. See https://github.com/docker/docker/pull/8845 + +set -e + +DOCKER_ISSUE_URL=${DOCKER_ISSUE_URL:-"https://github.com/docker/docker/issues/new"} +DOCKER_ISSUE_NAME_PREFIX=${DOCKER_ISSUE_NAME_PREFIX:-"Report: "} +DOCKER=${DOCKER:-"docker"} +DOCKER_COMMAND="${DOCKER}" +export DOCKER_COMMAND + +# pulled from https://gist.github.com/cdown/1163649 +function urlencode() { + # urlencode + + local length="${#1}" + for (( i = 0; i < length; i++ )); do + local c="${1:i:1}" + case $c in + [a-zA-Z0-9.~_-]) printf "$c" ;; + *) printf '%%%02X' "'$c" + esac + done +} + +function template() { +# this should always match the template from CONTRIBUTING.md + cat <<- EOM + Description of problem: + + + \`docker version\`: + `${DOCKER_COMMAND} -D version` + + + \`docker info\`: + `${DOCKER_COMMAND} -D info` + + + \`uname -a\`: + `uname -a` + + + Environment details (AWS, VirtualBox, physical, etc.): + + + How reproducible: + + + Steps to Reproduce: + 1. + 2. + 3. + + + Actual Results: + + + Expected Results: + + + Additional info: + + + EOM +} + +function format_issue_url() { + if [ ${#@} -ne 2 ] ; then + return 1 + fi + local issue_name=$(urlencode "${DOCKER_ISSUE_NAME_PREFIX}${1}") + local issue_body=$(urlencode "${2}") + echo "${DOCKER_ISSUE_URL}?title=${issue_name}&body=${issue_body}" +} + + +echo -ne "Do you use \`sudo\` to call docker? [y|N]: " +read -r -n 1 use_sudo +echo "" + +if [ "x${use_sudo}" = "xy" -o "x${use_sudo}" = "xY" ]; then + export DOCKER_COMMAND="sudo ${DOCKER}" +fi + +echo -ne "Title of new issue?: " +read -r issue_title +echo "" + +issue_url=$(format_issue_url "${issue_title}" "$(template)") + +if which xdg-open 2>/dev/null >/dev/null ; then + echo -ne "Would like to launch this report in your browser? [Y|n]: " + read -r -n 1 launch_now + echo "" + + if [ "${launch_now}" != "n" -a "${launch_now}" != "N" ]; then + xdg-open "${issue_url}" + fi +fi + +echo "If you would like to manually open the url, you can open this link if your browser: ${issue_url}" + diff --git a/contrib/reprepro/suites.sh b/contrib/reprepro/suites.sh new file mode 100755 index 0000000000..25a02da947 --- /dev/null +++ b/contrib/reprepro/suites.sh @@ -0,0 +1,12 @@ +#!/bin/bash +set -e + +cd "$(dirname "$BASH_SOURCE")/../.." + +targets_from() { + git fetch -q https://github.com/docker/docker.git "$1" + git ls-tree -r --name-only "$(git rev-parse FETCH_HEAD)" contrib/builder/deb | grep '/Dockerfile$' | sed -r 's!^contrib/builder/deb/|-debootstrap|/Dockerfile$!!g' +} + +release_branch=$(git ls-remote --heads https://github.com/docker/docker.git | awk -F 'refs/heads/' '$2 ~ /^release/ { print $2 }' | sort -V | tail -1) +{ targets_from master; targets_from "$release_branch"; } | sort -u diff --git a/contrib/syntax/kate/Dockerfile.xml b/contrib/syntax/kate/Dockerfile.xml new file mode 100644 index 0000000000..05692504e7 --- /dev/null +++ b/contrib/syntax/kate/Dockerfile.xml @@ -0,0 +1,70 @@ + + + + + + + FROM + MAINTAINER + ENV + RUN + ONBUILD + COPY + ADD + VOLUME + EXPOSE + ENTRYPOINT + CMD + WORKDIR + USER + LABEL + STOPSIGNAL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/contrib/syntax/nano/Dockerfile.nanorc b/contrib/syntax/nano/Dockerfile.nanorc new file mode 100644 index 0000000000..80e56dfb36 --- /dev/null +++ b/contrib/syntax/nano/Dockerfile.nanorc @@ -0,0 +1,26 @@ +## Syntax highlighting for Dockerfiles +syntax "Dockerfile" "Dockerfile[^/]*$" + +## Keywords +icolor red "^(FROM|MAINTAINER|RUN|CMD|LABEL|EXPOSE|ENV|ADD|COPY|ENTRYPOINT|VOLUME|USER|WORKDIR|ONBUILD)[[:space:]]" + +## Brackets & parenthesis +color brightgreen "(\(|\)|\[|\])" + +## Double ampersand +color brightmagenta "&&" + +## Comments +icolor cyan "^[[:space:]]*#.*$" + +## Blank space at EOL +color ,green "[[:space:]]+$" + +## Strings, single-quoted +color brightwhite "'([^']|(\\'))*'" "%[qw]\{[^}]*\}" "%[qw]\([^)]*\)" "%[qw]<[^>]*>" "%[qw]\[[^]]*\]" "%[qw]\$[^$]*\$" "%[qw]\^[^^]*\^" "%[qw]![^!]*!" + +## Strings, double-quoted +color brightwhite ""([^"]|(\\"))*"" "%[QW]?\{[^}]*\}" "%[QW]?\([^)]*\)" "%[QW]?<[^>]*>" "%[QW]?\[[^]]*\]" "%[QW]?\$[^$]*\$" "%[QW]?\^[^^]*\^" "%[QW]?![^!]*!" + +## Single and double quotes +color brightyellow "('|\")" diff --git a/contrib/syntax/nano/README.md b/contrib/syntax/nano/README.md new file mode 100644 index 0000000000..5985208b09 --- /dev/null +++ b/contrib/syntax/nano/README.md @@ -0,0 +1,32 @@ +Dockerfile.nanorc +================= + +Dockerfile syntax highlighting for nano + +Single User Installation +------------------------ +1. Create a nano syntax directory in your home directory: + * `mkdir -p ~/.nano/syntax` + +2. Copy `Dockerfile.nanorc` to` ~/.nano/syntax/` + * `cp Dockerfile.nanorc ~/.nano/syntax/` + +3. Add the following to your `~/.nanorc` to tell nano where to find the `Dockerfile.nanorc` file + ``` +## Dockerfile files +include "~/.nano/syntax/Dockerfile.nanorc" + ``` + +System Wide Installation +------------------------ +1. Create a nano syntax directory: + * `mkdir /usr/local/share/nano` + +2. Copy `Dockerfile.nanorc` to `/usr/local/share/nano` + * `cp Dockerfile.nanorc /usr/local/share/nano/` + +3. Add the following to your `/etc/nanorc`: + ``` +## Dockerfile files +include "/usr/local/share/nano/Dockerfile.nanorc" + ``` diff --git a/contrib/syntax/textmate/Docker.tmbundle/Preferences/Dockerfile.tmPreferences b/contrib/syntax/textmate/Docker.tmbundle/Preferences/Dockerfile.tmPreferences new file mode 100644 index 0000000000..20f0d04ca8 --- /dev/null +++ b/contrib/syntax/textmate/Docker.tmbundle/Preferences/Dockerfile.tmPreferences @@ -0,0 +1,24 @@ + + + + + name + Comments + scope + source.dockerfile + settings + + shellVariables + + + name + TM_COMMENT_START + value + # + + + + uuid + 2B215AC0-A7F3-4090-9FF6-F4842BD56CA7 + + diff --git a/contrib/syntax/textmate/Docker.tmbundle/Syntaxes/Dockerfile.tmLanguage b/contrib/syntax/textmate/Docker.tmbundle/Syntaxes/Dockerfile.tmLanguage new file mode 100644 index 0000000000..0ca231c319 --- /dev/null +++ b/contrib/syntax/textmate/Docker.tmbundle/Syntaxes/Dockerfile.tmLanguage @@ -0,0 +1,143 @@ + + + + + fileTypes + + Dockerfile + + name + Dockerfile + patterns + + + captures + + 1 + + name + keyword.control.dockerfile + + 2 + + name + keyword.other.special-method.dockerfile + + + match + ^\s*(?:(ONBUILD)\s+)?(FROM|MAINTAINER|RUN|EXPOSE|ENV|ADD|VOLUME|USER|WORKDIR|COPY|LABEL|STOPSIGNAL)\s + + + captures + + 1 + + name + keyword.operator.dockerfile + + 2 + + name + keyword.other.special-method.dockerfile + + + match + ^\s*(?:(ONBUILD)\s+)?(CMD|ENTRYPOINT)\s + + + begin + " + beginCaptures + + 1 + + name + punctuation.definition.string.begin.dockerfile + + + end + " + endCaptures + + 1 + + name + punctuation.definition.string.end.dockerfile + + + name + string.quoted.double.dockerfile + patterns + + + match + \\. + name + constant.character.escaped.dockerfile + + + + + begin + ' + beginCaptures + + 1 + + name + punctuation.definition.string.begin.dockerfile + + + end + ' + endCaptures + + 1 + + name + punctuation.definition.string.end.dockerfile + + + name + string.quoted.single.dockerfile + patterns + + + match + \\. + name + constant.character.escaped.dockerfile + + + + + captures + + 1 + + name + punctuation.whitespace.comment.leading.dockerfile + + 2 + + name + comment.line.number-sign.dockerfile + + 3 + + name + punctuation.definition.comment.dockerfile + + + comment + comment.line + match + ^(\s*)((#).*$\n?) + + + scopeName + source.dockerfile + uuid + a39d8795-59d2-49af-aa00-fe74ee29576e + + diff --git a/contrib/syntax/textmate/Docker.tmbundle/info.plist b/contrib/syntax/textmate/Docker.tmbundle/info.plist new file mode 100644 index 0000000000..239f4b0a9b --- /dev/null +++ b/contrib/syntax/textmate/Docker.tmbundle/info.plist @@ -0,0 +1,16 @@ + + + + + contactEmailRot13 + germ@andz.com.ar + contactName + GermanDZ + description + Helpers for Docker. + name + Docker + uuid + 8B9DDBAF-E65C-4E12-FFA7-467D4AA535B1 + + diff --git a/contrib/syntax/textmate/README.md b/contrib/syntax/textmate/README.md new file mode 100644 index 0000000000..ce611018e5 --- /dev/null +++ b/contrib/syntax/textmate/README.md @@ -0,0 +1,17 @@ +# Docker.tmbundle + +Dockerfile syntax highlighting for TextMate and Sublime Text. + +## Install + +### Sublime Text + +Available for Sublime Text under [package control](https://sublime.wbond.net/packages/Dockerfile%20Syntax%20Highlighting). +Search for *Dockerfile Syntax Highlighting* + +### TextMate 2 + +You can install this bundle in TextMate by opening the preferences and going to the bundles tab. After installation it will be automatically updated for you. + +enjoy. + diff --git a/contrib/syntax/textmate/REVIEWERS b/contrib/syntax/textmate/REVIEWERS new file mode 100644 index 0000000000..965743df64 --- /dev/null +++ b/contrib/syntax/textmate/REVIEWERS @@ -0,0 +1 @@ +Asbjorn Enge (@asbjornenge) diff --git a/contrib/syntax/vim/LICENSE b/contrib/syntax/vim/LICENSE new file mode 100644 index 0000000000..e67cdabd22 --- /dev/null +++ b/contrib/syntax/vim/LICENSE @@ -0,0 +1,22 @@ +Copyright (c) 2013 Honza Pokorny +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/contrib/syntax/vim/README.md b/contrib/syntax/vim/README.md new file mode 100644 index 0000000000..5aa9bd825d --- /dev/null +++ b/contrib/syntax/vim/README.md @@ -0,0 +1,26 @@ +dockerfile.vim +============== + +Syntax highlighting for Dockerfiles + +Installation +------------ +With [pathogen](https://github.com/tpope/vim-pathogen), the usual way... + +With [Vundle](https://github.com/gmarik/Vundle.vim) + + Plugin 'docker/docker' , {'rtp': '/contrib/syntax/vim/'} + +Features +-------- + +The syntax highlighting includes: + +* The directives (e.g. `FROM`) +* Strings +* Comments + +License +------- + +BSD, short and sweet diff --git a/contrib/syntax/vim/doc/dockerfile.txt b/contrib/syntax/vim/doc/dockerfile.txt new file mode 100644 index 0000000000..e69e2b7b30 --- /dev/null +++ b/contrib/syntax/vim/doc/dockerfile.txt @@ -0,0 +1,18 @@ +*dockerfile.txt* Syntax highlighting for Dockerfiles + +Author: Honza Pokorny +License: BSD + +INSTALLATION *installation* + +Drop it on your Pathogen path and you're all set. + +FEATURES *features* + +The syntax highlighting includes: + +* The directives (e.g. FROM) +* Strings +* Comments + + vim:tw=78:et:ft=help:norl: diff --git a/contrib/syntax/vim/ftdetect/dockerfile.vim b/contrib/syntax/vim/ftdetect/dockerfile.vim new file mode 100644 index 0000000000..ee10e5d6a0 --- /dev/null +++ b/contrib/syntax/vim/ftdetect/dockerfile.vim @@ -0,0 +1 @@ +au BufNewFile,BufRead [Dd]ockerfile,Dockerfile.* set filetype=dockerfile diff --git a/contrib/syntax/vim/syntax/dockerfile.vim b/contrib/syntax/vim/syntax/dockerfile.vim new file mode 100644 index 0000000000..3cb1ecfddf --- /dev/null +++ b/contrib/syntax/vim/syntax/dockerfile.vim @@ -0,0 +1,31 @@ +" dockerfile.vim - Syntax highlighting for Dockerfiles +" Maintainer: Honza Pokorny +" Version: 0.5 + + +if exists("b:current_syntax") + finish +endif + +let b:current_syntax = "dockerfile" + +syntax case ignore + +syntax match dockerfileKeyword /\v^\s*(ONBUILD\s+)?(ADD|CMD|ENTRYPOINT|ENV|EXPOSE|FROM|MAINTAINER|RUN|USER|LABEL|VOLUME|WORKDIR|COPY|STOPSIGNAL)\s/ +highlight link dockerfileKeyword Keyword + +syntax region dockerfileString start=/\v"/ skip=/\v\\./ end=/\v"/ +highlight link dockerfileString String + +syntax match dockerfileComment "\v^\s*#.*$" +highlight link dockerfileComment Comment + +set commentstring=#\ %s + +" match "RUN", "CMD", and "ENTRYPOINT" lines, and parse them as shell +let s:current_syntax = b:current_syntax +unlet b:current_syntax +syntax include @SH syntax/sh.vim +let b:current_syntax = s:current_syntax +syntax region shLine matchgroup=dockerfileKeyword start=/\v^\s*(RUN|CMD|ENTRYPOINT)\s/ end=/\v$/ contains=@SH +" since @SH will handle "\" as part of the same line automatically, this "just works" for line continuation too, but with the caveat that it will highlight "RUN echo '" followed by a newline as if it were a block because the "'" is shell line continuation... not sure how to fix that just yet (TODO) diff --git a/contrib/udev/80-docker.rules b/contrib/udev/80-docker.rules new file mode 100644 index 0000000000..f934c01757 --- /dev/null +++ b/contrib/udev/80-docker.rules @@ -0,0 +1,3 @@ +# hide docker's loopback devices from udisks, and thus from user desktops +SUBSYSTEM=="block", ENV{DM_NAME}=="docker-*", ENV{UDISKS_PRESENTATION_HIDE}="1", ENV{UDISKS_IGNORE}="1" +SUBSYSTEM=="block", DEVPATH=="/devices/virtual/block/loop*", ATTR{loop/backing_file}=="/var/lib/docker/*", ENV{UDISKS_PRESENTATION_HIDE}="1", ENV{UDISKS_IGNORE}="1" diff --git a/contrib/vagrant-docker/README.md b/contrib/vagrant-docker/README.md new file mode 100644 index 0000000000..c1ab6e8d46 --- /dev/null +++ b/contrib/vagrant-docker/README.md @@ -0,0 +1,50 @@ +# Vagrant integration + +Currently there are at least 4 different projects that we are aware of that deals +with integration with [Vagrant](http://vagrantup.com/) at different levels. One +approach is to use Docker as a [provisioner](http://docs.vagrantup.com/v2/provisioning/index.html) +which means you can create containers and pull base images on VMs using Docker's +CLI and the other is to use Docker as a [provider](http://docs.vagrantup.com/v2/providers/index.html), +meaning you can use Vagrant to control Docker containers. + + +### Provisioners + +* [Vocker](https://github.com/fgrehm/vocker) +* [Ventriloquist](https://github.com/fgrehm/ventriloquist) + +### Providers + +* [docker-provider](https://github.com/fgrehm/docker-provider) +* [vagrant-shell](https://github.com/destructuring/vagrant-shell) + +## Setting up Vagrant-docker with the Remote API + +The initial Docker upstart script will not work because it runs on `127.0.0.1`, which is not accessible to the host machine. Instead, we need to change the script to connect to `0.0.0.0`. To do this, modify `/etc/init/docker.conf` to look like this: + +``` +description "Docker daemon" + +start on filesystem and started lxc-net +stop on runlevel [!2345] + +respawn + +script + /usr/bin/docker daemon -H=tcp://0.0.0.0:2375 +end script +``` + +Once that's done, you need to set up a SSH tunnel between your host machine and the vagrant machine that's running Docker. This can be done by running the following command in a host terminal: + +``` +ssh -L 2375:localhost:2375 -p 2222 vagrant@localhost +``` + +(The first 2375 is what your host can connect to, the second 2375 is what port Docker is running on in the vagrant machine, and the 2222 is the port Vagrant is providing for SSH. If VirtualBox is the VM you're using, you can see what value "2222" should be by going to: Network > Adapter 1 > Advanced > Port Forwarding in the VirtualBox GUI.) + +Note that because the port has been changed, to run docker commands from within the command line you must run them like this: + +``` +sudo docker -H 0.0.0.0:2375 < commands for docker > +``` diff --git a/daemon/README.md b/daemon/README.md new file mode 100644 index 0000000000..1778983fb3 --- /dev/null +++ b/daemon/README.md @@ -0,0 +1,9 @@ +This directory contains code pertaining to running containers and storing images + +Code pertaining to running containers: + + - execdriver + +Code pertaining to storing images: + + - graphdriver diff --git a/daemon/archive.go b/daemon/archive.go new file mode 100644 index 0000000000..a5db99e211 --- /dev/null +++ b/daemon/archive.go @@ -0,0 +1,324 @@ +package daemon + +import ( + "errors" + "io" + "os" + "path/filepath" + "strings" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/ioutils" +) + +// ErrExtractPointNotDirectory is used to convey that the operation to extract +// a tar archive to a directory in a container has failed because the specified +// path does not refer to a directory. +var ErrExtractPointNotDirectory = errors.New("extraction point is not a directory") + +// ContainerCopy performs a deprecated operation of archiving the resource at +// the specified path in the conatiner identified by the given name. +func (daemon *Daemon) ContainerCopy(name string, res string) (io.ReadCloser, error) { + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + if res[0] == '/' || res[0] == '\\' { + res = res[1:] + } + + return container.copy(res) +} + +// ContainerStatPath stats the filesystem resource at the specified path in the +// container identified by the given name. +func (daemon *Daemon) ContainerStatPath(name string, path string) (stat *types.ContainerPathStat, err error) { + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + return container.StatPath(path) +} + +// ContainerArchivePath creates an archive of the filesystem resource at the +// specified path in the container identified by the given name. Returns a +// tar archive of the resource and whether it was a directory or a single file. +func (daemon *Daemon) ContainerArchivePath(name string, path string) (content io.ReadCloser, stat *types.ContainerPathStat, err error) { + container, err := daemon.Get(name) + if err != nil { + return nil, nil, err + } + + return container.ArchivePath(path) +} + +// ContainerExtractToDir extracts the given archive to the specified location +// in the filesystem of the container identified by the given name. The given +// path must be of a directory in the container. If it is not, the error will +// be ErrExtractPointNotDirectory. If noOverwriteDirNonDir is true then it will +// be an error if unpacking the given content would cause an existing directory +// to be replaced with a non-directory and vice versa. +func (daemon *Daemon) ContainerExtractToDir(name, path string, noOverwriteDirNonDir bool, content io.Reader) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + return container.ExtractToDir(path, noOverwriteDirNonDir, content) +} + +// resolvePath resolves the given path in the container to a resource on the +// host. Returns a resolved path (absolute path to the resource on the host), +// the absolute path to the resource relative to the container's rootfs, and +// a error if the path points to outside the container's rootfs. +func (container *Container) resolvePath(path string) (resolvedPath, absPath string, err error) { + // Consider the given path as an absolute path in the container. + absPath = archive.PreserveTrailingDotOrSeparator(filepath.Join(string(filepath.Separator), path), path) + + // Split the absPath into its Directory and Base components. We will + // resolve the dir in the scope of the container then append the base. + dirPath, basePath := filepath.Split(absPath) + + resolvedDirPath, err := container.GetResourcePath(dirPath) + if err != nil { + return "", "", err + } + + // resolvedDirPath will have been cleaned (no trailing path separators) so + // we can manually join it with the base path element. + resolvedPath = resolvedDirPath + string(filepath.Separator) + basePath + + return resolvedPath, absPath, nil +} + +// statPath is the unexported version of StatPath. Locks and mounts should +// be acquired before calling this method and the given path should be fully +// resolved to a path on the host corresponding to the given absolute path +// inside the container. +func (container *Container) statPath(resolvedPath, absPath string) (stat *types.ContainerPathStat, err error) { + lstat, err := os.Lstat(resolvedPath) + if err != nil { + return nil, err + } + + var linkTarget string + if lstat.Mode()&os.ModeSymlink != 0 { + // Fully evaluate the symlink in the scope of the container rootfs. + hostPath, err := container.GetResourcePath(absPath) + if err != nil { + return nil, err + } + + linkTarget, err = filepath.Rel(container.basefs, hostPath) + if err != nil { + return nil, err + } + + // Make it an absolute path. + linkTarget = filepath.Join(string(filepath.Separator), linkTarget) + } + + return &types.ContainerPathStat{ + Name: filepath.Base(absPath), + Size: lstat.Size(), + Mode: lstat.Mode(), + Mtime: lstat.ModTime(), + LinkTarget: linkTarget, + }, nil +} + +// StatPath stats the filesystem resource at the specified path in this +// container. Returns stat info about the resource. +func (container *Container) StatPath(path string) (stat *types.ContainerPathStat, err error) { + container.Lock() + defer container.Unlock() + + if err = container.Mount(); err != nil { + return nil, err + } + defer container.Unmount() + + err = container.mountVolumes() + defer container.unmountVolumes(true) + if err != nil { + return nil, err + } + + resolvedPath, absPath, err := container.resolvePath(path) + if err != nil { + return nil, err + } + + return container.statPath(resolvedPath, absPath) +} + +// ArchivePath creates an archive of the filesystem resource at the specified +// path in this container. Returns a tar archive of the resource and stat info +// about the resource. +func (container *Container) ArchivePath(path string) (content io.ReadCloser, stat *types.ContainerPathStat, err error) { + container.Lock() + + defer func() { + if err != nil { + // Wait to unlock the container until the archive is fully read + // (see the ReadCloseWrapper func below) or if there is an error + // before that occurs. + container.Unlock() + } + }() + + if err = container.Mount(); err != nil { + return nil, nil, err + } + + defer func() { + if err != nil { + // unmount any volumes + container.unmountVolumes(true) + // unmount the container's rootfs + container.Unmount() + } + }() + + if err = container.mountVolumes(); err != nil { + return nil, nil, err + } + + resolvedPath, absPath, err := container.resolvePath(path) + if err != nil { + return nil, nil, err + } + + stat, err = container.statPath(resolvedPath, absPath) + if err != nil { + return nil, nil, err + } + + // We need to rebase the archive entries if the last element of the + // resolved path was a symlink that was evaluated and is now different + // than the requested path. For example, if the given path was "/foo/bar/", + // but it resolved to "/var/lib/docker/containers/{id}/foo/baz/", we want + // to ensure that the archive entries start with "bar" and not "baz". This + // also catches the case when the root directory of the container is + // requested: we want the archive entries to start with "/" and not the + // container ID. + data, err := archive.TarResourceRebase(resolvedPath, filepath.Base(absPath)) + if err != nil { + return nil, nil, err + } + + content = ioutils.NewReadCloserWrapper(data, func() error { + err := data.Close() + container.unmountVolumes(true) + container.Unmount() + container.Unlock() + return err + }) + + container.logEvent("archive-path") + + return content, stat, nil +} + +// ExtractToDir extracts the given tar archive to the specified location in the +// filesystem of this container. The given path must be of a directory in the +// container. If it is not, the error will be ErrExtractPointNotDirectory. If +// noOverwriteDirNonDir is true then it will be an error if unpacking the +// given content would cause an existing directory to be replaced with a non- +// directory and vice versa. +func (container *Container) ExtractToDir(path string, noOverwriteDirNonDir bool, content io.Reader) (err error) { + container.Lock() + defer container.Unlock() + + if err = container.Mount(); err != nil { + return err + } + defer container.Unmount() + + err = container.mountVolumes() + defer container.unmountVolumes(true) + if err != nil { + return err + } + + // The destination path needs to be resolved to a host path, with all + // symbolic links followed in the scope of the container's rootfs. Note + // that we do not use `container.resolvePath(path)` here because we need + // to also evaluate the last path element if it is a symlink. This is so + // that you can extract an archive to a symlink that points to a directory. + + // Consider the given path as an absolute path in the container. + absPath := archive.PreserveTrailingDotOrSeparator(filepath.Join(string(filepath.Separator), path), path) + + // This will evaluate the last path element if it is a symlink. + resolvedPath, err := container.GetResourcePath(absPath) + if err != nil { + return err + } + + stat, err := os.Lstat(resolvedPath) + if err != nil { + return err + } + + if !stat.IsDir() { + return ErrExtractPointNotDirectory + } + + // Need to check if the path is in a volume. If it is, it cannot be in a + // read-only volume. If it is not in a volume, the container cannot be + // configured with a read-only rootfs. + + // Use the resolved path relative to the container rootfs as the new + // absPath. This way we fully follow any symlinks in a volume that may + // lead back outside the volume. + // + // The Windows implementation of filepath.Rel in golang 1.4 does not + // support volume style file path semantics. On Windows when using the + // filter driver, we are guaranteed that the path will always be + // a volume file path. + var baseRel string + if strings.HasPrefix(resolvedPath, `\\?\Volume{`) { + if strings.HasPrefix(resolvedPath, container.basefs) { + baseRel = resolvedPath[len(container.basefs):] + if baseRel[:1] == `\` { + baseRel = baseRel[1:] + } + } + } else { + baseRel, err = filepath.Rel(container.basefs, resolvedPath) + } + if err != nil { + return err + } + // Make it an absolute path. + absPath = filepath.Join(string(filepath.Separator), baseRel) + + toVolume, err := checkIfPathIsInAVolume(container, absPath) + if err != nil { + return err + } + + if !toVolume && container.hostConfig.ReadonlyRootfs { + return ErrRootFSReadOnly + } + + options := &archive.TarOptions{ + ChownOpts: &archive.TarChownOptions{ + UID: 0, GID: 0, // TODO: use config.User? Remap to userns root? + }, + NoOverwriteDirNonDir: noOverwriteDirNonDir, + } + + if err := chrootarchive.Untar(content, resolvedPath, options); err != nil { + return err + } + + container.logEvent("extract-to-dir") + + return nil +} diff --git a/daemon/archive_unix.go b/daemon/archive_unix.go new file mode 100644 index 0000000000..100fc78880 --- /dev/null +++ b/daemon/archive_unix.go @@ -0,0 +1,19 @@ +// +build !windows + +package daemon + +// checkIfPathIsInAVolume checks if the path is in a volume. If it is, it +// cannot be in a read-only volume. If it is not in a volume, the container +// cannot be configured with a read-only rootfs. +func checkIfPathIsInAVolume(container *Container, absPath string) (bool, error) { + var toVolume bool + for _, mnt := range container.MountPoints { + if toVolume = mnt.hasResource(absPath); toVolume { + if mnt.RW { + break + } + return false, ErrVolumeReadonly + } + } + return toVolume, nil +} diff --git a/daemon/archive_windows.go b/daemon/archive_windows.go new file mode 100644 index 0000000000..4e6c48a1ff --- /dev/null +++ b/daemon/archive_windows.go @@ -0,0 +1,10 @@ +package daemon + +// checkIfPathIsInAVolume checks if the path is in a volume. If it is, it +// cannot be in a read-only volume. If it is not in a volume, the container +// cannot be configured with a read-only rootfs. +// +// This is a no-op on Windows which does not support volumes. +func checkIfPathIsInAVolume(container *Container, absPath string) (bool, error) { + return false, nil +} diff --git a/daemon/attach.go b/daemon/attach.go new file mode 100644 index 0000000000..44198788ce --- /dev/null +++ b/daemon/attach.go @@ -0,0 +1,64 @@ +package daemon + +import ( + "io" + + "github.com/docker/docker/pkg/stdcopy" +) + +// ContainerAttachWithLogsConfig holds the streams to use when connecting to a container to view logs. +type ContainerAttachWithLogsConfig struct { + InStream io.ReadCloser + OutStream io.Writer + UseStdin, UseStdout, UseStderr bool + Logs, Stream bool +} + +// ContainerAttachWithLogs attaches to logs according to the config passed in. See ContainerAttachWithLogsConfig. +func (daemon *Daemon) ContainerAttachWithLogs(prefixOrName string, c *ContainerAttachWithLogsConfig) error { + container, err := daemon.Get(prefixOrName) + if err != nil { + return err + } + + var errStream io.Writer + + if !container.Config.Tty { + errStream = stdcopy.NewStdWriter(c.OutStream, stdcopy.Stderr) + c.OutStream = stdcopy.NewStdWriter(c.OutStream, stdcopy.Stdout) + } else { + errStream = c.OutStream + } + + var stdin io.ReadCloser + var stdout, stderr io.Writer + + if c.UseStdin { + stdin = c.InStream + } + if c.UseStdout { + stdout = c.OutStream + } + if c.UseStderr { + stderr = errStream + } + + return container.attachWithLogs(stdin, stdout, stderr, c.Logs, c.Stream) +} + +// ContainerWsAttachWithLogsConfig attach with websockets, since all +// stream data is delegated to the websocket to handle there. +type ContainerWsAttachWithLogsConfig struct { + InStream io.ReadCloser + OutStream, ErrStream io.Writer + Logs, Stream bool +} + +// ContainerWsAttachWithLogs websocket connection +func (daemon *Daemon) ContainerWsAttachWithLogs(prefixOrName string, c *ContainerWsAttachWithLogsConfig) error { + container, err := daemon.Get(prefixOrName) + if err != nil { + return err + } + return container.attachWithLogs(c.InStream, c.OutStream, c.ErrStream, c.Logs, c.Stream) +} diff --git a/daemon/changes.go b/daemon/changes.go new file mode 100644 index 0000000000..0748fa9c02 --- /dev/null +++ b/daemon/changes.go @@ -0,0 +1,13 @@ +package daemon + +import "github.com/docker/docker/pkg/archive" + +// ContainerChanges returns a list of container fs changes +func (daemon *Daemon) ContainerChanges(name string) ([]archive.Change, error) { + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + return container.changes() +} diff --git a/daemon/commit.go b/daemon/commit.go new file mode 100644 index 0000000000..62c9a458f4 --- /dev/null +++ b/daemon/commit.go @@ -0,0 +1,51 @@ +package daemon + +import ( + "github.com/docker/docker/image" + "github.com/docker/docker/runconfig" +) + +// ContainerCommitConfig contains build configs for commit operation, +// and is used when making a commit with the current state of the container. +type ContainerCommitConfig struct { + Pause bool + Repo string + Tag string + Author string + Comment string + Config *runconfig.Config +} + +// Commit creates a new filesystem image from the current state of a container. +// The image can optionally be tagged into a repository. +func (daemon *Daemon) Commit(container *Container, c *ContainerCommitConfig) (*image.Image, error) { + if c.Pause && !container.isPaused() { + container.pause() + defer container.unpause() + } + + rwTar, err := container.exportContainerRw() + if err != nil { + return nil, err + } + defer func() { + if rwTar != nil { + rwTar.Close() + } + }() + + // Create a new image from the container's base layers + a new layer from container changes + img, err := daemon.graph.Create(rwTar, container.ID, container.ImageID, c.Comment, c.Author, container.Config, c.Config) + if err != nil { + return nil, err + } + + // Register the image if needed + if c.Repo != "" { + if err := daemon.repositories.Tag(c.Repo, c.Tag, img.ID, true); err != nil { + return img, err + } + } + container.logEvent("commit") + return img, nil +} diff --git a/daemon/config.go b/daemon/config.go new file mode 100644 index 0000000000..436f8cdac4 --- /dev/null +++ b/daemon/config.go @@ -0,0 +1,77 @@ +package daemon + +import ( + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/runconfig" +) + +const ( + defaultNetworkMtu = 1500 + disableNetworkBridge = "none" +) + +// CommonConfig defines the configuration of a docker daemon which are +// common across platforms. +type CommonConfig struct { + AutoRestart bool + Bridge bridgeConfig // Bridge holds bridge network specific configuration. + Context map[string][]string + DisableBridge bool + DNS []string + DNSOptions []string + DNSSearch []string + ExecDriver string + ExecOptions []string + ExecRoot string + GraphDriver string + GraphOptions []string + Labels []string + LogConfig runconfig.LogConfig + Mtu int + Pidfile string + RemappedRoot string + Root string + TrustKeyPath string + DefaultNetwork string + + // ClusterStore is the storage backend used for the cluster information. It is used by both + // multihost networking (to store networks and endpoints information) and by the node discovery + // mechanism. + ClusterStore string + + // ClusterOpts is used to pass options to the discovery package for tuning libkv settings, such + // as TLS configuration settings. + ClusterOpts map[string]string + + // ClusterAdvertise is the network endpoint that the Engine advertises for the purpose of node + // discovery. This should be a 'host:port' combination on which that daemon instance is + // reachable by other hosts. + ClusterAdvertise string +} + +// InstallCommonFlags adds command-line options to the top-level flag parser for +// the current process. +// Subsequent calls to `flag.Parse` will populate config with values parsed +// from the command-line. +func (config *Config) InstallCommonFlags(cmd *flag.FlagSet, usageFn func(string) string) { + cmd.Var(opts.NewListOptsRef(&config.GraphOptions, nil), []string{"-storage-opt"}, usageFn("Set storage driver options")) + cmd.Var(opts.NewListOptsRef(&config.ExecOptions, nil), []string{"-exec-opt"}, usageFn("Set exec driver options")) + cmd.StringVar(&config.Pidfile, []string{"p", "-pidfile"}, defaultPidFile, usageFn("Path to use for daemon PID file")) + cmd.StringVar(&config.Root, []string{"g", "-graph"}, defaultGraph, usageFn("Root of the Docker runtime")) + cmd.StringVar(&config.ExecRoot, []string{"-exec-root"}, "/var/run/docker", usageFn("Root of the Docker execdriver")) + cmd.BoolVar(&config.AutoRestart, []string{"#r", "#-restart"}, true, usageFn("--restart on the daemon has been deprecated in favor of --restart policies on docker run")) + cmd.StringVar(&config.GraphDriver, []string{"s", "-storage-driver"}, "", usageFn("Storage driver to use")) + cmd.StringVar(&config.ExecDriver, []string{"e", "-exec-driver"}, defaultExec, usageFn("Exec driver to use")) + cmd.IntVar(&config.Mtu, []string{"#mtu", "-mtu"}, 0, usageFn("Set the containers network MTU")) + // FIXME: why the inconsistency between "hosts" and "sockets"? + cmd.Var(opts.NewListOptsRef(&config.DNS, opts.ValidateIPAddress), []string{"#dns", "-dns"}, usageFn("DNS server to use")) + cmd.Var(opts.NewListOptsRef(&config.DNSOptions, nil), []string{"-dns-opt"}, usageFn("DNS options to use")) + cmd.Var(opts.NewListOptsRef(&config.DNSSearch, opts.ValidateDNSSearch), []string{"-dns-search"}, usageFn("DNS search domains to use")) + cmd.Var(opts.NewListOptsRef(&config.Labels, opts.ValidateLabel), []string{"-label"}, usageFn("Set key=value labels to the daemon")) + cmd.StringVar(&config.LogConfig.Type, []string{"-log-driver"}, "json-file", usageFn("Default driver for container logs")) + cmd.Var(opts.NewMapOpts(config.LogConfig.Config, nil), []string{"-log-opt"}, usageFn("Set log driver options")) + cmd.StringVar(&config.ClusterAdvertise, []string{"-cluster-advertise"}, "", usageFn("Address or interface name to advertise")) + cmd.StringVar(&config.ClusterStore, []string{"-cluster-store"}, "", usageFn("Set the cluster store")) + cmd.Var(opts.NewMapOpts(config.ClusterOpts, nil), []string{"-cluster-store-opt"}, usageFn("Set cluster store options")) +} diff --git a/daemon/config_experimental.go b/daemon/config_experimental.go new file mode 100644 index 0000000000..f1c4bb925d --- /dev/null +++ b/daemon/config_experimental.go @@ -0,0 +1,119 @@ +// +build experimental + +package daemon + +import ( + "fmt" + "strconv" + "strings" + + "github.com/docker/docker/pkg/idtools" + flag "github.com/docker/docker/pkg/mflag" + "github.com/opencontainers/runc/libcontainer/user" +) + +func (config *Config) attachExperimentalFlags(cmd *flag.FlagSet, usageFn func(string) string) { + cmd.StringVar(&config.RemappedRoot, []string{"-userns-remap"}, "", usageFn("User/Group setting for user namespaces")) +} + +const ( + defaultIDSpecifier string = "default" + defaultRemappedID string = "dockremap" +) + +// Parse the remapped root (user namespace) option, which can be one of: +// username - valid username from /etc/passwd +// username:groupname - valid username; valid groupname from /etc/group +// uid - 32-bit unsigned int valid Linux UID value +// uid:gid - uid value; 32-bit unsigned int Linux GID value +// +// If no groupname is specified, and a username is specified, an attempt +// will be made to lookup a gid for that username as a groupname +// +// If names are used, they are verified to exist in passwd/group +func parseRemappedRoot(usergrp string) (string, string, error) { + + var ( + userID, groupID int + username, groupname string + ) + + idparts := strings.Split(usergrp, ":") + if len(idparts) > 2 { + return "", "", fmt.Errorf("Invalid user/group specification in --userns-remap: %q", usergrp) + } + + if uid, err := strconv.ParseInt(idparts[0], 10, 32); err == nil { + // must be a uid; take it as valid + userID = int(uid) + luser, err := user.LookupUid(userID) + if err != nil { + return "", "", fmt.Errorf("Uid %d has no entry in /etc/passwd: %v", userID, err) + } + username = luser.Name + if len(idparts) == 1 { + // if the uid was numeric and no gid was specified, take the uid as the gid + groupID = userID + lgrp, err := user.LookupGid(groupID) + if err != nil { + return "", "", fmt.Errorf("Gid %d has no entry in /etc/group: %v", groupID, err) + } + groupname = lgrp.Name + } + } else { + lookupName := idparts[0] + // special case: if the user specified "default", they want Docker to create or + // use (after creation) the "dockremap" user/group for root remapping + if lookupName == defaultIDSpecifier { + lookupName = defaultRemappedID + } + luser, err := user.LookupUser(lookupName) + if err != nil && idparts[0] != defaultIDSpecifier { + // error if the name requested isn't the special "dockremap" ID + return "", "", fmt.Errorf("Error during uid lookup for %q: %v", lookupName, err) + } else if err != nil { + // special case-- if the username == "default", then we have been asked + // to create a new entry pair in /etc/{passwd,group} for which the /etc/sub{uid,gid} + // ranges will be used for the user and group mappings in user namespaced containers + _, _, err := idtools.AddNamespaceRangesUser(defaultRemappedID) + if err == nil { + return defaultRemappedID, defaultRemappedID, nil + } + return "", "", fmt.Errorf("Error during %q user creation: %v", defaultRemappedID, err) + } + userID = luser.Uid + username = luser.Name + if len(idparts) == 1 { + // we only have a string username, and no group specified; look up gid from username as group + group, err := user.LookupGroup(lookupName) + if err != nil { + return "", "", fmt.Errorf("Error during gid lookup for %q: %v", lookupName, err) + } + groupID = group.Gid + groupname = group.Name + } + } + + if len(idparts) == 2 { + // groupname or gid is separately specified and must be resolved + // to a unsigned 32-bit gid + if gid, err := strconv.ParseInt(idparts[1], 10, 32); err == nil { + // must be a gid, take it as valid + groupID = int(gid) + lgrp, err := user.LookupGid(groupID) + if err != nil { + return "", "", fmt.Errorf("Gid %d has no entry in /etc/passwd: %v", groupID, err) + } + groupname = lgrp.Name + } else { + // not a number; attempt a lookup + group, err := user.LookupGroup(idparts[1]) + if err != nil { + return "", "", fmt.Errorf("Error during gid lookup for %q: %v", idparts[1], err) + } + groupID = group.Gid + groupname = idparts[1] + } + } + return username, groupname, nil +} diff --git a/daemon/config_stub.go b/daemon/config_stub.go new file mode 100644 index 0000000000..796e6b6e4e --- /dev/null +++ b/daemon/config_stub.go @@ -0,0 +1,8 @@ +// +build !experimental + +package daemon + +import flag "github.com/docker/docker/pkg/mflag" + +func (config *Config) attachExperimentalFlags(cmd *flag.FlagSet, usageFn func(string) string) { +} diff --git a/daemon/config_unix.go b/daemon/config_unix.go new file mode 100644 index 0000000000..3ae67cac55 --- /dev/null +++ b/daemon/config_unix.go @@ -0,0 +1,83 @@ +// +build linux freebsd + +package daemon + +import ( + "net" + + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/ulimit" +) + +var ( + defaultPidFile = "/var/run/docker.pid" + defaultGraph = "/var/lib/docker" + defaultExec = "native" +) + +// Config defines the configuration of a docker daemon. +// These are the configuration settings that you pass +// to the docker daemon when you launch it with say: `docker daemon -e lxc` +type Config struct { + CommonConfig + + // Fields below here are platform specific. + + CorsHeaders string + EnableCors bool + EnableSelinuxSupport bool + RemappedRoot string + SocketGroup string + Ulimits map[string]*ulimit.Ulimit +} + +// bridgeConfig stores all the bridge driver specific +// configuration. +type bridgeConfig struct { + EnableIPv6 bool + EnableIPTables bool + EnableIPForward bool + EnableIPMasq bool + EnableUserlandProxy bool + DefaultIP net.IP + Iface string + IP string + FixedCIDR string + FixedCIDRv6 string + DefaultGatewayIPv4 net.IP + DefaultGatewayIPv6 net.IP + InterContainerCommunication bool +} + +// InstallFlags adds command-line options to the top-level flag parser for +// the current process. +// Subsequent calls to `flag.Parse` will populate config with values parsed +// from the command-line. +func (config *Config) InstallFlags(cmd *flag.FlagSet, usageFn func(string) string) { + // First handle install flags which are consistent cross-platform + config.InstallCommonFlags(cmd, usageFn) + + // Then platform-specific install flags + cmd.BoolVar(&config.EnableSelinuxSupport, []string{"-selinux-enabled"}, false, usageFn("Enable selinux support")) + cmd.StringVar(&config.SocketGroup, []string{"G", "-group"}, "docker", usageFn("Group for the unix socket")) + config.Ulimits = make(map[string]*ulimit.Ulimit) + cmd.Var(opts.NewUlimitOpt(&config.Ulimits), []string{"-default-ulimit"}, usageFn("Set default ulimits for containers")) + cmd.BoolVar(&config.Bridge.EnableIPTables, []string{"#iptables", "-iptables"}, true, usageFn("Enable addition of iptables rules")) + cmd.BoolVar(&config.Bridge.EnableIPForward, []string{"#ip-forward", "-ip-forward"}, true, usageFn("Enable net.ipv4.ip_forward")) + cmd.BoolVar(&config.Bridge.EnableIPMasq, []string{"-ip-masq"}, true, usageFn("Enable IP masquerading")) + cmd.BoolVar(&config.Bridge.EnableIPv6, []string{"-ipv6"}, false, usageFn("Enable IPv6 networking")) + cmd.StringVar(&config.Bridge.IP, []string{"#bip", "-bip"}, "", usageFn("Specify network bridge IP")) + cmd.StringVar(&config.Bridge.Iface, []string{"b", "-bridge"}, "", usageFn("Attach containers to a network bridge")) + cmd.StringVar(&config.Bridge.FixedCIDR, []string{"-fixed-cidr"}, "", usageFn("IPv4 subnet for fixed IPs")) + cmd.StringVar(&config.Bridge.FixedCIDRv6, []string{"-fixed-cidr-v6"}, "", usageFn("IPv6 subnet for fixed IPs")) + cmd.Var(opts.NewIPOpt(&config.Bridge.DefaultGatewayIPv4, ""), []string{"-default-gateway"}, usageFn("Container default gateway IPv4 address")) + cmd.Var(opts.NewIPOpt(&config.Bridge.DefaultGatewayIPv6, ""), []string{"-default-gateway-v6"}, usageFn("Container default gateway IPv6 address")) + cmd.BoolVar(&config.Bridge.InterContainerCommunication, []string{"#icc", "-icc"}, true, usageFn("Enable inter-container communication")) + cmd.Var(opts.NewIPOpt(&config.Bridge.DefaultIP, "0.0.0.0"), []string{"#ip", "-ip"}, usageFn("Default IP when binding container ports")) + cmd.BoolVar(&config.Bridge.EnableUserlandProxy, []string{"-userland-proxy"}, true, usageFn("Use userland proxy for loopback traffic")) + cmd.BoolVar(&config.EnableCors, []string{"#api-enable-cors", "#-api-enable-cors"}, false, usageFn("Enable CORS headers in the remote API, this is deprecated by --api-cors-header")) + cmd.StringVar(&config.CorsHeaders, []string{"-api-cors-header"}, "", usageFn("Set CORS headers in the remote API")) + + config.attachExperimentalFlags(cmd, usageFn) +} diff --git a/daemon/config_windows.go b/daemon/config_windows.go new file mode 100644 index 0000000000..bc0833aa9e --- /dev/null +++ b/daemon/config_windows.go @@ -0,0 +1,41 @@ +package daemon + +import ( + "os" + + flag "github.com/docker/docker/pkg/mflag" +) + +var ( + defaultPidFile = os.Getenv("programdata") + string(os.PathSeparator) + "docker.pid" + defaultGraph = os.Getenv("programdata") + string(os.PathSeparator) + "docker" + defaultExec = "windows" +) + +// bridgeConfig stores all the bridge driver specific +// configuration. +type bridgeConfig struct { + VirtualSwitchName string +} + +// Config defines the configuration of a docker daemon. +// These are the configuration settings that you pass +// to the docker daemon when you launch it with say: `docker daemon -e windows` +type Config struct { + CommonConfig + + // Fields below here are platform specific. (There are none presently + // for the Windows daemon.) +} + +// InstallFlags adds command-line options to the top-level flag parser for +// the current process. +// Subsequent calls to `flag.Parse` will populate config with values parsed +// from the command-line. +func (config *Config) InstallFlags(cmd *flag.FlagSet, usageFn func(string) string) { + // First handle install flags which are consistent cross-platform + config.InstallCommonFlags(cmd, usageFn) + + // Then platform-specific install flags. + cmd.StringVar(&config.Bridge.VirtualSwitchName, []string{"b", "-bridge"}, "", "Attach containers to a virtual switch") +} diff --git a/daemon/container.go b/daemon/container.go new file mode 100644 index 0000000000..9f8f207cc6 --- /dev/null +++ b/daemon/container.go @@ -0,0 +1,1162 @@ +package daemon + +import ( + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "sync" + "syscall" + "time" + + "github.com/opencontainers/runc/libcontainer/label" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/daemon/logger/jsonfilelog" + "github.com/docker/docker/daemon/network" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/broadcaster" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/promise" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/symlink" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/volume" +) + +var ( + // ErrRootFSReadOnly is returned when a container + // rootfs is marked readonly. + ErrRootFSReadOnly = errors.New("container rootfs is marked read-only") +) + +type streamConfig struct { + stdout *broadcaster.Unbuffered + stderr *broadcaster.Unbuffered + stdin io.ReadCloser + stdinPipe io.WriteCloser +} + +// CommonContainer holds the fields for a container which are +// applicable across all platforms supported by the daemon. +type CommonContainer struct { + streamConfig + // embed for Container to support states directly. + *State `json:"State"` // Needed for remote api version <= 1.11 + root string // Path to the "home" of the container, including metadata. + basefs string // Path to the graphdriver mountpoint + ID string + Created time.Time + Path string + Args []string + Config *runconfig.Config + ImageID string `json:"Image"` + NetworkSettings *network.Settings + LogPath string + Name string + Driver string + ExecDriver string + // MountLabel contains the options for the 'mount' command + MountLabel string + ProcessLabel string + RestartCount int + HasBeenStartedBefore bool + HasBeenManuallyStopped bool // used for unless-stopped restart policy + hostConfig *runconfig.HostConfig + command *execdriver.Command + monitor *containerMonitor + execCommands *execStore + daemon *Daemon + // logDriver for closing + logDriver logger.Logger + logCopier *logger.Copier +} + +func (container *Container) fromDisk() error { + pth, err := container.jsonPath() + if err != nil { + return err + } + + jsonSource, err := os.Open(pth) + if err != nil { + return err + } + defer jsonSource.Close() + + dec := json.NewDecoder(jsonSource) + + // Load container settings + if err := dec.Decode(container); err != nil { + return err + } + + if err := label.ReserveLabel(container.ProcessLabel); err != nil { + return err + } + return container.readHostConfig() +} + +func (container *Container) toDisk() error { + data, err := json.Marshal(container) + if err != nil { + return err + } + + pth, err := container.jsonPath() + if err != nil { + return err + } + + if err := ioutil.WriteFile(pth, data, 0666); err != nil { + return err + } + + return container.writeHostConfig() +} + +func (container *Container) toDiskLocking() error { + container.Lock() + err := container.toDisk() + container.Unlock() + return err +} + +func (container *Container) readHostConfig() error { + container.hostConfig = &runconfig.HostConfig{} + // If the hostconfig file does not exist, do not read it. + // (We still have to initialize container.hostConfig, + // but that's OK, since we just did that above.) + pth, err := container.hostConfigPath() + if err != nil { + return err + } + + _, err = os.Stat(pth) + if os.IsNotExist(err) { + return nil + } + + f, err := os.Open(pth) + if err != nil { + return err + } + defer f.Close() + + if err := json.NewDecoder(f).Decode(&container.hostConfig); err != nil { + return err + } + + // Make sure the dns fields are never nil. + // New containers don't ever have those fields nil, + // but pre created containers can still have those nil values. + // See https://github.com/docker/docker/pull/17779 + // for a more detailed explanation on why we don't want that. + if container.hostConfig.DNS == nil { + container.hostConfig.DNS = make([]string, 0) + } + + if container.hostConfig.DNSSearch == nil { + container.hostConfig.DNSSearch = make([]string, 0) + } + + if container.hostConfig.DNSOptions == nil { + container.hostConfig.DNSOptions = make([]string, 0) + } + + return nil +} + +func (container *Container) writeHostConfig() error { + data, err := json.Marshal(container.hostConfig) + if err != nil { + return err + } + + pth, err := container.hostConfigPath() + if err != nil { + return err + } + + return ioutil.WriteFile(pth, data, 0666) +} + +func (container *Container) logEvent(action string) { + d := container.daemon + d.EventsService.Log( + action, + container.ID, + container.Config.Image, + ) +} + +// GetResourcePath evaluates `path` in the scope of the container's basefs, with proper path +// sanitisation. Symlinks are all scoped to the basefs of the container, as +// though the container's basefs was `/`. +// +// The basefs of a container is the host-facing path which is bind-mounted as +// `/` inside the container. This method is essentially used to access a +// particular path inside the container as though you were a process in that +// container. +// +// NOTE: The returned path is *only* safely scoped inside the container's basefs +// if no component of the returned path changes (such as a component +// symlinking to a different path) between using this method and using the +// path. See symlink.FollowSymlinkInScope for more details. +func (container *Container) GetResourcePath(path string) (string, error) { + // IMPORTANT - These are paths on the OS where the daemon is running, hence + // any filepath operations must be done in an OS agnostic way. + cleanPath := filepath.Join(string(os.PathSeparator), path) + r, e := symlink.FollowSymlinkInScope(filepath.Join(container.basefs, cleanPath), container.basefs) + return r, e +} + +// Evaluates `path` in the scope of the container's root, with proper path +// sanitisation. Symlinks are all scoped to the root of the container, as +// though the container's root was `/`. +// +// The root of a container is the host-facing configuration metadata directory. +// Only use this method to safely access the container's `container.json` or +// other metadata files. If in doubt, use container.GetResourcePath. +// +// NOTE: The returned path is *only* safely scoped inside the container's root +// if no component of the returned path changes (such as a component +// symlinking to a different path) between using this method and using the +// path. See symlink.FollowSymlinkInScope for more details. +func (container *Container) getRootResourcePath(path string) (string, error) { + // IMPORTANT - These are paths on the OS where the daemon is running, hence + // any filepath operations must be done in an OS agnostic way. + cleanPath := filepath.Join(string(os.PathSeparator), path) + return symlink.FollowSymlinkInScope(filepath.Join(container.root, cleanPath), container.root) +} + +func (container *Container) exportContainerRw() (archive.Archive, error) { + if container.daemon == nil { + return nil, derr.ErrorCodeUnregisteredContainer.WithArgs(container.ID) + } + archive, err := container.daemon.diff(container) + if err != nil { + return nil, err + } + return ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + return err + }), + nil +} + +// Start prepares the container to run by setting up everything the +// container needs, such as storage and networking, as well as links +// between containers. The container is left waiting for a signal to +// begin running. +func (container *Container) Start() (err error) { + container.Lock() + defer container.Unlock() + + if container.Running { + return nil + } + + if container.removalInProgress || container.Dead { + return derr.ErrorCodeContainerBeingRemoved + } + + // if we encounter an error during start we need to ensure that any other + // setup has been cleaned up properly + defer func() { + if err != nil { + container.setError(err) + // if no one else has set it, make sure we don't leave it at zero + if container.ExitCode == 0 { + container.ExitCode = 128 + } + container.toDisk() + container.cleanup() + container.logEvent("die") + } + }() + + if err := container.Mount(); err != nil { + return err + } + + // Make sure NetworkMode has an acceptable value. We do this to ensure + // backwards API compatibility. + container.hostConfig = runconfig.SetDefaultNetModeIfBlank(container.hostConfig) + + if err := container.initializeNetworking(); err != nil { + return err + } + linkedEnv, err := container.setupLinkedContainers() + if err != nil { + return err + } + if err := container.setupWorkingDirectory(); err != nil { + return err + } + env := container.createDaemonEnvironment(linkedEnv) + if err := populateCommand(container, env); err != nil { + return err + } + + if !container.hostConfig.IpcMode.IsContainer() && !container.hostConfig.IpcMode.IsHost() { + if err := container.setupIpcDirs(); err != nil { + return err + } + } + + mounts, err := container.setupMounts() + if err != nil { + return err + } + mounts = append(mounts, container.ipcMounts()...) + + container.command.Mounts = mounts + return container.waitForStart() +} + +// streamConfig.StdinPipe returns a WriteCloser which can be used to feed data +// to the standard input of the container's active process. +// Container.StdoutPipe and Container.StderrPipe each return a ReadCloser +// which can be used to retrieve the standard output (and error) generated +// by the container's active process. The output (and error) are actually +// copied and delivered to all StdoutPipe and StderrPipe consumers, using +// a kind of "broadcaster". + +func (streamConfig *streamConfig) StdinPipe() io.WriteCloser { + return streamConfig.stdinPipe +} + +func (streamConfig *streamConfig) StdoutPipe() io.ReadCloser { + reader, writer := io.Pipe() + streamConfig.stdout.Add(writer) + return ioutils.NewBufReader(reader) +} + +func (streamConfig *streamConfig) StderrPipe() io.ReadCloser { + reader, writer := io.Pipe() + streamConfig.stderr.Add(writer) + return ioutils.NewBufReader(reader) +} + +// cleanup releases any network resources allocated to the container along with any rules +// around how containers are linked together. It also unmounts the container's root filesystem. +func (container *Container) cleanup() { + container.releaseNetwork() + + container.unmountIpcMounts(detachMounted) + + if err := container.Unmount(); err != nil { + logrus.Errorf("%s: Failed to umount filesystem: %v", container.ID, err) + } + + for _, eConfig := range container.execCommands.s { + container.daemon.unregisterExecCommand(eConfig) + } + + container.unmountVolumes(false) +} + +// killSig sends the container the given signal. This wrapper for the +// host specific kill command prepares the container before attempting +// to send the signal. An error is returned if the container is paused +// or not running, or if there is a problem returned from the +// underlying kill command. +func (container *Container) killSig(sig int) error { + logrus.Debugf("Sending %d to %s", sig, container.ID) + container.Lock() + defer container.Unlock() + + // We could unpause the container for them rather than returning this error + if container.Paused { + return derr.ErrorCodeUnpauseContainer.WithArgs(container.ID) + } + + if !container.Running { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + + // signal to the monitor that it should not restart the container + // after we send the kill signal + container.monitor.ExitOnNext() + + // if the container is currently restarting we do not need to send the signal + // to the process. Telling the monitor that it should exit on it's next event + // loop is enough + if container.Restarting { + return nil + } + + if err := container.daemon.kill(container, sig); err != nil { + return err + } + container.logEvent("kill") + return nil +} + +// Wrapper aroung killSig() suppressing "no such process" error. +func (container *Container) killPossiblyDeadProcess(sig int) error { + err := container.killSig(sig) + if err == syscall.ESRCH { + logrus.Debugf("Cannot kill process (pid=%d) with signal %d: no such process.", container.getPID(), sig) + return nil + } + return err +} + +func (container *Container) pause() error { + container.Lock() + defer container.Unlock() + + // We cannot Pause the container which is not running + if !container.Running { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + + // We cannot Pause the container which is already paused + if container.Paused { + return derr.ErrorCodeAlreadyPaused.WithArgs(container.ID) + } + + if err := container.daemon.execDriver.Pause(container.command); err != nil { + return err + } + container.Paused = true + container.logEvent("pause") + return nil +} + +func (container *Container) unpause() error { + container.Lock() + defer container.Unlock() + + // We cannot unpause the container which is not running + if !container.Running { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + + // We cannot unpause the container which is not paused + if !container.Paused { + return derr.ErrorCodeNotPaused.WithArgs(container.ID) + } + + if err := container.daemon.execDriver.Unpause(container.command); err != nil { + return err + } + container.Paused = false + container.logEvent("unpause") + return nil +} + +// Kill forcefully terminates a container. +func (container *Container) Kill() error { + if !container.IsRunning() { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + + // 1. Send SIGKILL + if err := container.killPossiblyDeadProcess(int(syscall.SIGKILL)); err != nil { + // While normally we might "return err" here we're not going to + // because if we can't stop the container by this point then + // its probably because its already stopped. Meaning, between + // the time of the IsRunning() call above and now it stopped. + // Also, since the err return will be exec driver specific we can't + // look for any particular (common) error that would indicate + // that the process is already dead vs something else going wrong. + // So, instead we'll give it up to 2 more seconds to complete and if + // by that time the container is still running, then the error + // we got is probably valid and so we return it to the caller. + + if container.IsRunning() { + container.WaitStop(2 * time.Second) + if container.IsRunning() { + return err + } + } + } + + // 2. Wait for the process to die, in last resort, try to kill the process directly + if err := killProcessDirectly(container); err != nil { + return err + } + + container.WaitStop(-1 * time.Second) + return nil +} + +// Stop halts a container by sending a stop signal, waiting for the given +// duration in seconds, and then calling SIGKILL and waiting for the +// process to exit. If a negative duration is given, Stop will wait +// for the initial signal forever. If the container is not running Stop returns +// immediately. +func (container *Container) Stop(seconds int) error { + if !container.IsRunning() { + return nil + } + + // 1. Send a SIGTERM + if err := container.killPossiblyDeadProcess(container.stopSignal()); err != nil { + logrus.Infof("Failed to send SIGTERM to the process, force killing") + if err := container.killPossiblyDeadProcess(9); err != nil { + return err + } + } + + // 2. Wait for the process to exit on its own + if _, err := container.WaitStop(time.Duration(seconds) * time.Second); err != nil { + logrus.Infof("Container %v failed to exit within %d seconds of SIGTERM - using the force", container.ID, seconds) + // 3. If it doesn't, then send SIGKILL + if err := container.Kill(); err != nil { + container.WaitStop(-1 * time.Second) + return err + } + } + + container.logEvent("stop") + return nil +} + +// Restart attempts to gracefully stop and then start the +// container. When stopping, wait for the given duration in seconds to +// gracefully stop, before forcefully terminating the container. If +// given a negative duration, wait forever for a graceful stop. +func (container *Container) Restart(seconds int) error { + // Avoid unnecessarily unmounting and then directly mounting + // the container when the container stops and then starts + // again + if err := container.Mount(); err == nil { + defer container.Unmount() + } + + if err := container.Stop(seconds); err != nil { + return err + } + + if err := container.Start(); err != nil { + return err + } + + container.logEvent("restart") + return nil +} + +// Resize changes the TTY of the process running inside the container +// to the given height and width. The container must be running. +func (container *Container) Resize(h, w int) error { + if !container.IsRunning() { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + if err := container.command.ProcessConfig.Terminal.Resize(h, w); err != nil { + return err + } + container.logEvent("resize") + return nil +} + +func (container *Container) export() (archive.Archive, error) { + if err := container.Mount(); err != nil { + return nil, err + } + + uidMaps, gidMaps := container.daemon.GetUIDGIDMaps() + archive, err := archive.TarWithOptions(container.basefs, &archive.TarOptions{ + Compression: archive.Uncompressed, + UIDMaps: uidMaps, + GIDMaps: gidMaps, + }) + if err != nil { + container.Unmount() + return nil, err + } + arch := ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + container.Unmount() + return err + }) + container.logEvent("export") + return arch, err +} + +// Mount sets container.basefs +func (container *Container) Mount() error { + return container.daemon.Mount(container) +} + +func (container *Container) changes() ([]archive.Change, error) { + container.Lock() + defer container.Unlock() + return container.daemon.changes(container) +} + +func (container *Container) getImage() (*image.Image, error) { + if container.daemon == nil { + return nil, derr.ErrorCodeImageUnregContainer + } + return container.daemon.graph.Get(container.ImageID) +} + +// Unmount asks the daemon to release the layered filesystems that are +// mounted by the container. +func (container *Container) Unmount() error { + return container.daemon.unmount(container) +} + +func (container *Container) hostConfigPath() (string, error) { + return container.getRootResourcePath("hostconfig.json") +} + +func (container *Container) jsonPath() (string, error) { + return container.getRootResourcePath("config.json") +} + +// This method must be exported to be used from the lxc template +// This directory is only usable when the container is running +func (container *Container) rootfsPath() string { + return container.basefs +} + +func validateID(id string) error { + if id == "" { + return derr.ErrorCodeEmptyID + } + return nil +} + +func (container *Container) copy(resource string) (rc io.ReadCloser, err error) { + container.Lock() + + defer func() { + if err != nil { + // Wait to unlock the container until the archive is fully read + // (see the ReadCloseWrapper func below) or if there is an error + // before that occurs. + container.Unlock() + } + }() + + if err := container.Mount(); err != nil { + return nil, err + } + + defer func() { + if err != nil { + // unmount any volumes + container.unmountVolumes(true) + // unmount the container's rootfs + container.Unmount() + } + }() + + if err := container.mountVolumes(); err != nil { + return nil, err + } + + basePath, err := container.GetResourcePath(resource) + if err != nil { + return nil, err + } + stat, err := os.Stat(basePath) + if err != nil { + return nil, err + } + var filter []string + if !stat.IsDir() { + d, f := filepath.Split(basePath) + basePath = d + filter = []string{f} + } else { + filter = []string{filepath.Base(basePath)} + basePath = filepath.Dir(basePath) + } + archive, err := archive.TarWithOptions(basePath, &archive.TarOptions{ + Compression: archive.Uncompressed, + IncludeFiles: filter, + }) + if err != nil { + return nil, err + } + + reader := ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + container.unmountVolumes(true) + container.Unmount() + container.Unlock() + return err + }) + container.logEvent("copy") + return reader, nil +} + +// Returns true if the container exposes a certain port +func (container *Container) exposes(p nat.Port) bool { + _, exists := container.Config.ExposedPorts[p] + return exists +} + +func (container *Container) getLogConfig() runconfig.LogConfig { + cfg := container.hostConfig.LogConfig + if cfg.Type != "" || len(cfg.Config) > 0 { // container has log driver configured + if cfg.Type == "" { + cfg.Type = jsonfilelog.Name + } + return cfg + } + // Use daemon's default log config for containers + return container.daemon.defaultLogConfig +} + +func (container *Container) getLogger() (logger.Logger, error) { + if container.logDriver != nil && container.IsRunning() { + return container.logDriver, nil + } + cfg := container.getLogConfig() + if err := logger.ValidateLogOpts(cfg.Type, cfg.Config); err != nil { + return nil, err + } + c, err := logger.GetLogDriver(cfg.Type) + if err != nil { + return nil, derr.ErrorCodeLoggingFactory.WithArgs(err) + } + ctx := logger.Context{ + Config: cfg.Config, + ContainerID: container.ID, + ContainerName: container.Name, + ContainerEntrypoint: container.Path, + ContainerArgs: container.Args, + ContainerImageID: container.ImageID, + ContainerImageName: container.Config.Image, + ContainerCreated: container.Created, + ContainerEnv: container.Config.Env, + ContainerLabels: container.Config.Labels, + } + + // Set logging file for "json-logger" + if cfg.Type == jsonfilelog.Name { + ctx.LogPath, err = container.getRootResourcePath(fmt.Sprintf("%s-json.log", container.ID)) + if err != nil { + return nil, err + } + } + return c(ctx) +} + +func (container *Container) startLogging() error { + cfg := container.getLogConfig() + if cfg.Type == "none" { + return nil // do not start logging routines + } + + l, err := container.getLogger() + if err != nil { + return derr.ErrorCodeInitLogger.WithArgs(err) + } + + copier := logger.NewCopier(container.ID, map[string]io.Reader{"stdout": container.StdoutPipe(), "stderr": container.StderrPipe()}, l) + container.logCopier = copier + copier.Run() + container.logDriver = l + + // set LogPath field only for json-file logdriver + if jl, ok := l.(*jsonfilelog.JSONFileLogger); ok { + container.LogPath = jl.LogPath() + } + + return nil +} + +func (container *Container) waitForStart() error { + container.monitor = newContainerMonitor(container, container.hostConfig.RestartPolicy) + + // block until we either receive an error from the initial start of the container's + // process or until the process is running in the container + select { + case <-container.monitor.startSignal: + case err := <-promise.Go(container.monitor.Start): + return err + } + + return nil +} + +func (container *Container) getProcessLabel() string { + // even if we have a process label return "" if we are running + // in privileged mode + if container.hostConfig.Privileged { + return "" + } + return container.ProcessLabel +} + +func (container *Container) getMountLabel() string { + if container.hostConfig.Privileged { + return "" + } + return container.MountLabel +} + +func (container *Container) stats() (*execdriver.ResourceStats, error) { + return container.daemon.stats(container) +} + +func (container *Container) getExecIDs() []string { + return container.execCommands.List() +} + +func (container *Container) exec(ec *ExecConfig) error { + container.Lock() + defer container.Unlock() + + callback := func(processConfig *execdriver.ProcessConfig, pid int, chOOM <-chan struct{}) error { + if processConfig.Tty { + // The callback is called after the process Start() + // so we are in the parent process. In TTY mode, stdin/out/err is the PtySlave + // which we close here. + if c, ok := processConfig.Stdout.(io.Closer); ok { + c.Close() + } + } + close(ec.waitStart) + return nil + } + + // We use a callback here instead of a goroutine and an chan for + // synchronization purposes + cErr := promise.Go(func() error { return container.monitorExec(ec, callback) }) + + // Exec should not return until the process is actually running + select { + case <-ec.waitStart: + case err := <-cErr: + return err + } + + return nil +} + +func (container *Container) monitorExec(ExecConfig *ExecConfig, callback execdriver.DriverCallback) error { + var ( + err error + exitCode int + ) + pipes := execdriver.NewPipes(ExecConfig.streamConfig.stdin, ExecConfig.streamConfig.stdout, ExecConfig.streamConfig.stderr, ExecConfig.OpenStdin) + exitCode, err = container.daemon.Exec(container, ExecConfig, pipes, callback) + if err != nil { + logrus.Errorf("Error running command in existing container %s: %s", container.ID, err) + } + logrus.Debugf("Exec task in container %s exited with code %d", container.ID, exitCode) + if ExecConfig.OpenStdin { + if err := ExecConfig.streamConfig.stdin.Close(); err != nil { + logrus.Errorf("Error closing stdin while running in %s: %s", container.ID, err) + } + } + if err := ExecConfig.streamConfig.stdout.Clean(); err != nil { + logrus.Errorf("Error closing stdout while running in %s: %s", container.ID, err) + } + if err := ExecConfig.streamConfig.stderr.Clean(); err != nil { + logrus.Errorf("Error closing stderr while running in %s: %s", container.ID, err) + } + if ExecConfig.ProcessConfig.Terminal != nil { + if err := ExecConfig.ProcessConfig.Terminal.Close(); err != nil { + logrus.Errorf("Error closing terminal while running in container %s: %s", container.ID, err) + } + } + // remove the exec command from the container's store only and not the + // daemon's store so that the exec command can be inspected. + container.execCommands.Delete(ExecConfig.ID) + return err +} + +// Attach connects to the container's TTY, delegating to standard +// streams or websockets depending on the configuration. +func (container *Container) Attach(stdin io.ReadCloser, stdout io.Writer, stderr io.Writer) chan error { + return attach(&container.streamConfig, container.Config.OpenStdin, container.Config.StdinOnce, container.Config.Tty, stdin, stdout, stderr) +} + +func (container *Container) attachWithLogs(stdin io.ReadCloser, stdout, stderr io.Writer, logs, stream bool) error { + if logs { + logDriver, err := container.getLogger() + if err != nil { + return err + } + cLog, ok := logDriver.(logger.LogReader) + if !ok { + return logger.ErrReadLogsNotSupported + } + logs := cLog.ReadLogs(logger.ReadConfig{Tail: -1}) + + LogLoop: + for { + select { + case msg, ok := <-logs.Msg: + if !ok { + break LogLoop + } + if msg.Source == "stdout" && stdout != nil { + stdout.Write(msg.Line) + } + if msg.Source == "stderr" && stderr != nil { + stderr.Write(msg.Line) + } + case err := <-logs.Err: + logrus.Errorf("Error streaming logs: %v", err) + break LogLoop + } + } + } + + container.logEvent("attach") + + //stream + if stream { + var stdinPipe io.ReadCloser + if stdin != nil { + r, w := io.Pipe() + go func() { + defer w.Close() + defer logrus.Debugf("Closing buffered stdin pipe") + io.Copy(w, stdin) + }() + stdinPipe = r + } + <-container.Attach(stdinPipe, stdout, stderr) + // If we are in stdinonce mode, wait for the process to end + // otherwise, simply return + if container.Config.StdinOnce && !container.Config.Tty { + container.WaitStop(-1 * time.Second) + } + } + return nil +} + +func attach(streamConfig *streamConfig, openStdin, stdinOnce, tty bool, stdin io.ReadCloser, stdout io.Writer, stderr io.Writer) chan error { + var ( + cStdout, cStderr io.ReadCloser + cStdin io.WriteCloser + wg sync.WaitGroup + errors = make(chan error, 3) + ) + + if stdin != nil && openStdin { + cStdin = streamConfig.StdinPipe() + wg.Add(1) + } + + if stdout != nil { + cStdout = streamConfig.StdoutPipe() + wg.Add(1) + } + + if stderr != nil { + cStderr = streamConfig.StderrPipe() + wg.Add(1) + } + + // Connect stdin of container to the http conn. + go func() { + if stdin == nil || !openStdin { + return + } + logrus.Debugf("attach: stdin: begin") + defer func() { + if stdinOnce && !tty { + cStdin.Close() + } else { + // No matter what, when stdin is closed (io.Copy unblock), close stdout and stderr + if cStdout != nil { + cStdout.Close() + } + if cStderr != nil { + cStderr.Close() + } + } + wg.Done() + logrus.Debugf("attach: stdin: end") + }() + + var err error + if tty { + _, err = copyEscapable(cStdin, stdin) + } else { + _, err = io.Copy(cStdin, stdin) + + } + if err == io.ErrClosedPipe { + err = nil + } + if err != nil { + logrus.Errorf("attach: stdin: %s", err) + errors <- err + return + } + }() + + attachStream := func(name string, stream io.Writer, streamPipe io.ReadCloser) { + if stream == nil { + return + } + defer func() { + // Make sure stdin gets closed + if stdin != nil { + stdin.Close() + } + streamPipe.Close() + wg.Done() + logrus.Debugf("attach: %s: end", name) + }() + + logrus.Debugf("attach: %s: begin", name) + _, err := io.Copy(stream, streamPipe) + if err == io.ErrClosedPipe { + err = nil + } + if err != nil { + logrus.Errorf("attach: %s: %v", name, err) + errors <- err + } + } + + go attachStream("stdout", stdout, cStdout) + go attachStream("stderr", stderr, cStderr) + + return promise.Go(func() error { + wg.Wait() + close(errors) + for err := range errors { + if err != nil { + return err + } + } + return nil + }) +} + +// Code c/c from io.Copy() modified to handle escape sequence +func copyEscapable(dst io.Writer, src io.ReadCloser) (written int64, err error) { + buf := make([]byte, 32*1024) + for { + nr, er := src.Read(buf) + if nr > 0 { + // ---- Docker addition + // char 16 is C-p + if nr == 1 && buf[0] == 16 { + nr, er = src.Read(buf) + // char 17 is C-q + if nr == 1 && buf[0] == 17 { + if err := src.Close(); err != nil { + return 0, err + } + return 0, nil + } + } + // ---- End of docker + nw, ew := dst.Write(buf[0:nr]) + if nw > 0 { + written += int64(nw) + } + if ew != nil { + err = ew + break + } + if nr != nw { + err = io.ErrShortWrite + break + } + } + if er == io.EOF { + break + } + if er != nil { + err = er + break + } + } + return written, err +} + +func (container *Container) shouldRestart() bool { + return container.hostConfig.RestartPolicy.Name == "always" || + (container.hostConfig.RestartPolicy.Name == "unless-stopped" && !container.HasBeenManuallyStopped) || + (container.hostConfig.RestartPolicy.Name == "on-failure" && container.ExitCode != 0) +} + +func (container *Container) mountVolumes() error { + mounts, err := container.setupMounts() + if err != nil { + return err + } + + for _, m := range mounts { + dest, err := container.GetResourcePath(m.Destination) + if err != nil { + return err + } + + var stat os.FileInfo + stat, err = os.Stat(m.Source) + if err != nil { + return err + } + if err = fileutils.CreateIfNotExists(dest, stat.IsDir()); err != nil { + return err + } + + opts := "rbind,ro" + if m.Writable { + opts = "rbind,rw" + } + container.LogPath = pth + + if err := mount.Mount(m.Source, dest, "bind", opts); err != nil { + return err + } + } + + return nil +} + +func (container *Container) copyImagePathContent(v volume.Volume, destination string) error { + rootfs, err := symlink.FollowSymlinkInScope(filepath.Join(container.basefs, destination), container.basefs) + if err != nil { + return err + } + + if _, err = ioutil.ReadDir(rootfs); err != nil { + if os.IsNotExist(err) { + return nil + } + return err + } + + path, err := v.Mount() + if err != nil { + return err + } + + if err := copyExistingContents(rootfs, path); err != nil { + return err + } + + return v.Unmount() +} + +func (container *Container) stopSignal() int { + var stopSignal syscall.Signal + if container.Config.StopSignal != "" { + stopSignal, _ = signal.ParseSignal(container.Config.StopSignal) + } + + if int(stopSignal) == 0 { + stopSignal, _ = signal.ParseSignal(signal.DefaultStopSignal) + } + return int(stopSignal) +} diff --git a/daemon/container_unit_test.go b/daemon/container_unit_test.go new file mode 100644 index 0000000000..f7951804a3 --- /dev/null +++ b/daemon/container_unit_test.go @@ -0,0 +1,136 @@ +package daemon + +import ( + "io/ioutil" + "os" + "path/filepath" + "testing" + + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/volume" + "github.com/docker/docker/volume/drivers" +) + +func TestGetFullName(t *testing.T) { + name, err := GetFullContainerName("testing") + if err != nil { + t.Fatal(err) + } + if name != "/testing" { + t.Fatalf("Expected /testing got %s", name) + } + if _, err := GetFullContainerName(""); err == nil { + t.Fatal("Error should not be nil") + } +} + +func TestValidContainerNames(t *testing.T) { + invalidNames := []string{"-rm", "&sdfsfd", "safd%sd"} + validNames := []string{"word-word", "word_word", "1weoid"} + + for _, name := range invalidNames { + if validContainerNamePattern.MatchString(name) { + t.Fatalf("%q is not a valid container name and was returned as valid.", name) + } + } + + for _, name := range validNames { + if !validContainerNamePattern.MatchString(name) { + t.Fatalf("%q is a valid container name and was returned as invalid.", name) + } + } +} + +func TestContainerStopSignal(t *testing.T) { + c := &Container{ + CommonContainer: CommonContainer{ + Config: &runconfig.Config{}, + }, + } + + def, err := signal.ParseSignal(signal.DefaultStopSignal) + if err != nil { + t.Fatal(err) + } + + s := c.stopSignal() + if s != int(def) { + t.Fatalf("Expected %v, got %v", def, s) + } + + c = &Container{ + CommonContainer: CommonContainer{ + Config: &runconfig.Config{StopSignal: "SIGKILL"}, + }, + } + s = c.stopSignal() + if s != 9 { + t.Fatalf("Expected 9, got %v", s) + } +} + +func TestContainerInitDNS(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-container-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + containerID := "d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e" + containerPath := filepath.Join(tmp, containerID) + if err := os.MkdirAll(containerPath, 0755); err != nil { + t.Fatal(err) + } + + config := `{"State":{"Running":true,"Paused":false,"Restarting":false,"OOMKilled":false,"Dead":false,"Pid":2464,"ExitCode":0, +"Error":"","StartedAt":"2015-05-26T16:48:53.869308965Z","FinishedAt":"0001-01-01T00:00:00Z"}, +"ID":"d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e","Created":"2015-05-26T16:48:53.7987917Z","Path":"top", +"Args":[],"Config":{"Hostname":"d59df5276e7b","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"Cpuset":"", +"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"PortSpecs":null,"ExposedPorts":null,"Tty":true,"OpenStdin":true, +"StdinOnce":false,"Env":null,"Cmd":["top"],"Image":"ubuntu:latest","Volumes":null,"WorkingDir":"","Entrypoint":null, +"NetworkDisabled":false,"MacAddress":"","OnBuild":null,"Labels":{}},"Image":"07f8e8c5e66084bef8f848877857537ffe1c47edd01a93af27e7161672ad0e95", +"NetworkSettings":{"IPAddress":"172.17.0.1","IPPrefixLen":16,"MacAddress":"02:42:ac:11:00:01","LinkLocalIPv6Address":"fe80::42:acff:fe11:1", +"LinkLocalIPv6PrefixLen":64,"GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"Gateway":"172.17.42.1","IPv6Gateway":"","Bridge":"docker0","Ports":{}}, +"ResolvConfPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/resolv.conf", +"HostnamePath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hostname", +"HostsPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hosts", +"LogPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e-json.log", +"Name":"/ubuntu","Driver":"aufs","MountLabel":"","ProcessLabel":"","AppArmorProfile":"","RestartCount":0, +"UpdateDns":false,"Volumes":{},"VolumesRW":{},"AppliedVolumesFrom":null}` + + if err = ioutil.WriteFile(filepath.Join(containerPath, "config.json"), []byte(config), 0644); err != nil { + t.Fatal(err) + } + + hostConfig := `{"Binds":[],"ContainerIDFile":"","Memory":0,"MemorySwap":0,"CpuShares":0,"CpusetCpus":"", +"Privileged":false,"PortBindings":{},"Links":null,"PublishAllPorts":false,"Dns":null,"DnsOptions":null,"DnsSearch":null,"ExtraHosts":null,"VolumesFrom":null, +"Devices":[],"NetworkMode":"bridge","IpcMode":"","PidMode":"","CapAdd":null,"CapDrop":null,"RestartPolicy":{"Name":"no","MaximumRetryCount":0}, +"SecurityOpt":null,"ReadonlyRootfs":false,"Ulimits":null,"LogConfig":{"Type":"","Config":null},"CgroupParent":""}` + if err = ioutil.WriteFile(filepath.Join(containerPath, "hostconfig.json"), []byte(hostConfig), 0644); err != nil { + t.Fatal(err) + } + + daemon, err := initDaemonWithVolumeStore(tmp) + if err != nil { + t.Fatal(err) + } + defer volumedrivers.Unregister(volume.DefaultDriverName) + + c, err := daemon.load(containerID) + if err != nil { + t.Fatal(err) + } + + if c.hostConfig.DNS == nil { + t.Fatal("Expected container DNS to not be nil") + } + + if c.hostConfig.DNSSearch == nil { + t.Fatal("Expected container DNSSearch to not be nil") + } + + if c.hostConfig.DNSOptions == nil { + t.Fatal("Expected container DNSOptions to not be nil") + } +} diff --git a/daemon/container_unix.go b/daemon/container_unix.go new file mode 100644 index 0000000000..67bc546019 --- /dev/null +++ b/daemon/container_unix.go @@ -0,0 +1,1549 @@ +// +build linux freebsd + +package daemon + +import ( + "fmt" + "io/ioutil" + "net" + "os" + "path" + "path/filepath" + "strconv" + "strings" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/daemon/links" + "github.com/docker/docker/daemon/network" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/directory" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/ulimit" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" + "github.com/docker/docker/volume" + "github.com/docker/docker/volume/store" + "github.com/docker/libnetwork" + "github.com/docker/libnetwork/drivers/bridge" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/options" + "github.com/docker/libnetwork/types" + "github.com/opencontainers/runc/libcontainer/configs" + "github.com/opencontainers/runc/libcontainer/devices" + "github.com/opencontainers/runc/libcontainer/label" +) + +// DefaultPathEnv is unix style list of directories to search for +// executables. Each directory is separated from the next by a colon +// ':' character . +const DefaultPathEnv = "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + +// Container holds the fields specific to unixen implementations. See +// CommonContainer for standard fields common to all containers. +type Container struct { + CommonContainer + + // Fields below here are platform specific. + activeLinks map[string]*links.Link + AppArmorProfile string + HostnamePath string + HostsPath string + ShmPath string + MqueuePath string + MountPoints map[string]*mountPoint + ResolvConfPath string + + Volumes map[string]string // Deprecated since 1.7, kept for backwards compatibility + VolumesRW map[string]bool // Deprecated since 1.7, kept for backwards compatibility +} + +func killProcessDirectly(container *Container) error { + if _, err := container.WaitStop(10 * time.Second); err != nil { + // Ensure that we don't kill ourselves + if pid := container.getPID(); pid != 0 { + logrus.Infof("Container %s failed to exit within 10 seconds of kill - trying direct SIGKILL", stringid.TruncateID(container.ID)) + if err := syscall.Kill(pid, 9); err != nil { + if err != syscall.ESRCH { + return err + } + logrus.Debugf("Cannot kill process (pid=%d) with signal 9: no such process.", pid) + } + } + } + return nil +} + +func (container *Container) setupLinkedContainers() ([]string, error) { + var ( + env []string + daemon = container.daemon + ) + children, err := daemon.children(container.Name) + if err != nil { + return nil, err + } + + bridgeSettings := container.NetworkSettings.Networks["bridge"] + if bridgeSettings == nil { + return nil, nil + } + + if len(children) > 0 { + for linkAlias, child := range children { + if !child.IsRunning() { + return nil, derr.ErrorCodeLinkNotRunning.WithArgs(child.Name, linkAlias) + } + + childBridgeSettings := child.NetworkSettings.Networks["bridge"] + if childBridgeSettings == nil { + return nil, fmt.Errorf("container %d not attached to default bridge network", child.ID) + } + + link := links.NewLink( + bridgeSettings.IPAddress, + childBridgeSettings.IPAddress, + linkAlias, + child.Config.Env, + child.Config.ExposedPorts, + ) + + for _, envVar := range link.ToEnv() { + env = append(env, envVar) + } + } + } + return env, nil +} + +func (container *Container) createDaemonEnvironment(linkedEnv []string) []string { + // if a domain name was specified, append it to the hostname (see #7851) + fullHostname := container.Config.Hostname + if container.Config.Domainname != "" { + fullHostname = fmt.Sprintf("%s.%s", fullHostname, container.Config.Domainname) + } + // Setup environment + env := []string{ + "PATH=" + DefaultPathEnv, + "HOSTNAME=" + fullHostname, + // Note: we don't set HOME here because it'll get autoset intelligently + // based on the value of USER inside dockerinit, but only if it isn't + // set already (ie, that can be overridden by setting HOME via -e or ENV + // in a Dockerfile). + } + if container.Config.Tty { + env = append(env, "TERM=xterm") + } + env = append(env, linkedEnv...) + // because the env on the container can override certain default values + // we need to replace the 'env' keys where they match and append anything + // else. + env = utils.ReplaceOrAppendEnvValues(env, container.Config.Env) + + return env +} + +func getDevicesFromPath(deviceMapping runconfig.DeviceMapping) (devs []*configs.Device, err error) { + device, err := devices.DeviceFromPath(deviceMapping.PathOnHost, deviceMapping.CgroupPermissions) + // if there was no error, return the device + if err == nil { + device.Path = deviceMapping.PathInContainer + return append(devs, device), nil + } + + // if the device is not a device node + // try to see if it's a directory holding many devices + if err == devices.ErrNotADevice { + + // check if it is a directory + if src, e := os.Stat(deviceMapping.PathOnHost); e == nil && src.IsDir() { + + // mount the internal devices recursively + filepath.Walk(deviceMapping.PathOnHost, func(dpath string, f os.FileInfo, e error) error { + childDevice, e := devices.DeviceFromPath(dpath, deviceMapping.CgroupPermissions) + if e != nil { + // ignore the device + return nil + } + + // add the device to userSpecified devices + childDevice.Path = strings.Replace(dpath, deviceMapping.PathOnHost, deviceMapping.PathInContainer, 1) + devs = append(devs, childDevice) + + return nil + }) + } + } + + if len(devs) > 0 { + return devs, nil + } + + return devs, derr.ErrorCodeDeviceInfo.WithArgs(deviceMapping.PathOnHost, err) +} + +func populateCommand(c *Container, env []string) error { + var en *execdriver.Network + if !c.Config.NetworkDisabled { + en = &execdriver.Network{} + if !c.daemon.execDriver.SupportsHooks() || c.hostConfig.NetworkMode.IsHost() { + en.NamespacePath = c.NetworkSettings.SandboxKey + } + + parts := strings.SplitN(string(c.hostConfig.NetworkMode), ":", 2) + if parts[0] == "container" { + nc, err := c.getNetworkedContainer() + if err != nil { + return err + } + en.ContainerID = nc.ID + } + } + + ipc := &execdriver.Ipc{} + var err error + c.ShmPath, err = c.shmPath() + if err != nil { + return err + } + + c.MqueuePath, err = c.mqueuePath() + if err != nil { + return err + } + + if c.hostConfig.IpcMode.IsContainer() { + ic, err := c.getIpcContainer() + if err != nil { + return err + } + ipc.ContainerID = ic.ID + c.ShmPath = ic.ShmPath + c.MqueuePath = ic.MqueuePath + } else { + ipc.HostIpc = c.hostConfig.IpcMode.IsHost() + if ipc.HostIpc { + if _, err := os.Stat("/dev/shm"); err != nil { + return fmt.Errorf("/dev/shm is not mounted, but must be for --ipc=host") + } + if _, err := os.Stat("/dev/mqueue"); err != nil { + return fmt.Errorf("/dev/mqueue is not mounted, but must be for --ipc=host") + } + c.ShmPath = "/dev/shm" + c.MqueuePath = "/dev/mqueue" + } + } + + pid := &execdriver.Pid{} + pid.HostPid = c.hostConfig.PidMode.IsHost() + + uts := &execdriver.UTS{ + HostUTS: c.hostConfig.UTSMode.IsHost(), + } + + // Build lists of devices allowed and created within the container. + var userSpecifiedDevices []*configs.Device + for _, deviceMapping := range c.hostConfig.Devices { + devs, err := getDevicesFromPath(deviceMapping) + if err != nil { + return err + } + + userSpecifiedDevices = append(userSpecifiedDevices, devs...) + } + + allowedDevices := mergeDevices(configs.DefaultAllowedDevices, userSpecifiedDevices) + + autoCreatedDevices := mergeDevices(configs.DefaultAutoCreatedDevices, userSpecifiedDevices) + + // TODO: this can be removed after lxc-conf is fully deprecated + lxcConfig, err := mergeLxcConfIntoOptions(c.hostConfig) + if err != nil { + return err + } + + var rlimits []*ulimit.Rlimit + ulimits := c.hostConfig.Ulimits + + // Merge ulimits with daemon defaults + ulIdx := make(map[string]*ulimit.Ulimit) + for _, ul := range ulimits { + ulIdx[ul.Name] = ul + } + for name, ul := range c.daemon.configStore.Ulimits { + if _, exists := ulIdx[name]; !exists { + ulimits = append(ulimits, ul) + } + } + + for _, limit := range ulimits { + rl, err := limit.GetRlimit() + if err != nil { + return err + } + rlimits = append(rlimits, rl) + } + + resources := &execdriver.Resources{ + Memory: c.hostConfig.Memory, + MemorySwap: c.hostConfig.MemorySwap, + MemoryReservation: c.hostConfig.MemoryReservation, + KernelMemory: c.hostConfig.KernelMemory, + CPUShares: c.hostConfig.CPUShares, + CpusetCpus: c.hostConfig.CpusetCpus, + CpusetMems: c.hostConfig.CpusetMems, + CPUPeriod: c.hostConfig.CPUPeriod, + CPUQuota: c.hostConfig.CPUQuota, + BlkioWeight: c.hostConfig.BlkioWeight, + Rlimits: rlimits, + OomKillDisable: c.hostConfig.OomKillDisable, + MemorySwappiness: -1, + } + + if c.hostConfig.MemorySwappiness != nil { + resources.MemorySwappiness = *c.hostConfig.MemorySwappiness + } + + processConfig := execdriver.ProcessConfig{ + Privileged: c.hostConfig.Privileged, + Entrypoint: c.Path, + Arguments: c.Args, + Tty: c.Config.Tty, + User: c.Config.User, + } + + processConfig.SysProcAttr = &syscall.SysProcAttr{Setsid: true} + processConfig.Env = env + + remappedRoot := &execdriver.User{} + rootUID, rootGID := c.daemon.GetRemappedUIDGID() + if rootUID != 0 { + remappedRoot.UID = rootUID + remappedRoot.GID = rootGID + } + uidMap, gidMap := c.daemon.GetUIDGIDMaps() + + c.command = &execdriver.Command{ + ID: c.ID, + Rootfs: c.rootfsPath(), + ReadonlyRootfs: c.hostConfig.ReadonlyRootfs, + InitPath: "/.dockerinit", + WorkingDir: c.Config.WorkingDir, + Network: en, + Ipc: ipc, + UIDMapping: uidMap, + GIDMapping: gidMap, + RemappedRoot: remappedRoot, + Pid: pid, + UTS: uts, + Resources: resources, + AllowedDevices: allowedDevices, + AutoCreatedDevices: autoCreatedDevices, + CapAdd: c.hostConfig.CapAdd.Slice(), + CapDrop: c.hostConfig.CapDrop.Slice(), + GroupAdd: c.hostConfig.GroupAdd, + ProcessConfig: processConfig, + ProcessLabel: c.getProcessLabel(), + MountLabel: c.getMountLabel(), + LxcConfig: lxcConfig, + AppArmorProfile: c.AppArmorProfile, + CgroupParent: c.hostConfig.CgroupParent, + } + + return nil +} + +func mergeDevices(defaultDevices, userDevices []*configs.Device) []*configs.Device { + if len(userDevices) == 0 { + return defaultDevices + } + + paths := map[string]*configs.Device{} + for _, d := range userDevices { + paths[d.Path] = d + } + + var devs []*configs.Device + for _, d := range defaultDevices { + if _, defined := paths[d.Path]; !defined { + devs = append(devs, d) + } + } + return append(devs, userDevices...) +} + +// GetSize returns the real size & virtual size of the container. +func (container *Container) getSize() (int64, int64) { + var ( + sizeRw, sizeRootfs int64 + err error + driver = container.daemon.driver + ) + + if err := container.Mount(); err != nil { + logrus.Errorf("Failed to compute size of container rootfs %s: %s", container.ID, err) + return sizeRw, sizeRootfs + } + defer container.Unmount() + + initID := fmt.Sprintf("%s-init", container.ID) + sizeRw, err = driver.DiffSize(container.ID, initID) + if err != nil { + logrus.Errorf("Driver %s couldn't return diff size of container %s: %s", driver, container.ID, err) + // FIXME: GetSize should return an error. Not changing it now in case + // there is a side-effect. + sizeRw = -1 + } + + if _, err = os.Stat(container.basefs); err == nil { + if sizeRootfs, err = directory.Size(container.basefs); err != nil { + sizeRootfs = -1 + } + } + return sizeRw, sizeRootfs +} + +// Attempt to set the network mounts given a provided destination and +// the path to use for it; return true if the given destination was a +// network mount file +func (container *Container) trySetNetworkMount(destination string, path string) bool { + if destination == "/etc/resolv.conf" { + container.ResolvConfPath = path + return true + } + if destination == "/etc/hostname" { + container.HostnamePath = path + return true + } + if destination == "/etc/hosts" { + container.HostsPath = path + return true + } + + return false +} + +func (container *Container) buildHostnameFile() error { + hostnamePath, err := container.getRootResourcePath("hostname") + if err != nil { + return err + } + container.HostnamePath = hostnamePath + + if container.Config.Domainname != "" { + return ioutil.WriteFile(container.HostnamePath, []byte(fmt.Sprintf("%s.%s\n", container.Config.Hostname, container.Config.Domainname)), 0644) + } + return ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644) +} + +func (container *Container) buildSandboxOptions(n libnetwork.Network) ([]libnetwork.SandboxOption, error) { + var ( + sboxOptions []libnetwork.SandboxOption + err error + dns []string + dnsSearch []string + dnsOptions []string + ) + + sboxOptions = append(sboxOptions, libnetwork.OptionHostname(container.Config.Hostname), + libnetwork.OptionDomainname(container.Config.Domainname)) + + if container.hostConfig.NetworkMode.IsHost() { + sboxOptions = append(sboxOptions, libnetwork.OptionUseDefaultSandbox()) + sboxOptions = append(sboxOptions, libnetwork.OptionOriginHostsPath("/etc/hosts")) + sboxOptions = append(sboxOptions, libnetwork.OptionOriginResolvConfPath("/etc/resolv.conf")) + } else if container.daemon.execDriver.SupportsHooks() { + // OptionUseExternalKey is mandatory for userns support. + // But optional for non-userns support + sboxOptions = append(sboxOptions, libnetwork.OptionUseExternalKey()) + } + + container.HostsPath, err = container.getRootResourcePath("hosts") + if err != nil { + return nil, err + } + sboxOptions = append(sboxOptions, libnetwork.OptionHostsPath(container.HostsPath)) + + container.ResolvConfPath, err = container.getRootResourcePath("resolv.conf") + if err != nil { + return nil, err + } + sboxOptions = append(sboxOptions, libnetwork.OptionResolvConfPath(container.ResolvConfPath)) + + if len(container.hostConfig.DNS) > 0 { + dns = container.hostConfig.DNS + } else if len(container.daemon.configStore.DNS) > 0 { + dns = container.daemon.configStore.DNS + } + + for _, d := range dns { + sboxOptions = append(sboxOptions, libnetwork.OptionDNS(d)) + } + + if len(container.hostConfig.DNSSearch) > 0 { + dnsSearch = container.hostConfig.DNSSearch + } else if len(container.daemon.configStore.DNSSearch) > 0 { + dnsSearch = container.daemon.configStore.DNSSearch + } + + for _, ds := range dnsSearch { + sboxOptions = append(sboxOptions, libnetwork.OptionDNSSearch(ds)) + } + + if len(container.hostConfig.DNSOptions) > 0 { + dnsOptions = container.hostConfig.DNSOptions + } else if len(container.daemon.configStore.DNSOptions) > 0 { + dnsOptions = container.daemon.configStore.DNSOptions + } + + for _, ds := range dnsOptions { + sboxOptions = append(sboxOptions, libnetwork.OptionDNSOptions(ds)) + } + + if container.NetworkSettings.SecondaryIPAddresses != nil { + name := container.Config.Hostname + if container.Config.Domainname != "" { + name = name + "." + container.Config.Domainname + } + + for _, a := range container.NetworkSettings.SecondaryIPAddresses { + sboxOptions = append(sboxOptions, libnetwork.OptionExtraHost(name, a.Addr)) + } + } + + for _, extraHost := range container.hostConfig.ExtraHosts { + // allow IPv6 addresses in extra hosts; only split on first ":" + parts := strings.SplitN(extraHost, ":", 2) + sboxOptions = append(sboxOptions, libnetwork.OptionExtraHost(parts[0], parts[1])) + } + + // Link feature is supported only for the default bridge network. + // return if this call to build join options is not for default bridge network + if n.Name() != "bridge" { + return sboxOptions, nil + } + + ep, _ := container.getEndpointInNetwork(n) + if ep == nil { + return sboxOptions, nil + } + + var childEndpoints, parentEndpoints []string + + children, err := container.daemon.children(container.Name) + if err != nil { + return nil, err + } + + for linkAlias, child := range children { + if !isLinkable(child) { + return nil, fmt.Errorf("Cannot link to %s, as it does not belong to the default network", child.Name) + } + _, alias := path.Split(linkAlias) + // allow access to the linked container via the alias, real name, and container hostname + aliasList := alias + " " + child.Config.Hostname + // only add the name if alias isn't equal to the name + if alias != child.Name[1:] { + aliasList = aliasList + " " + child.Name[1:] + } + sboxOptions = append(sboxOptions, libnetwork.OptionExtraHost(aliasList, child.NetworkSettings.Networks["bridge"].IPAddress)) + cEndpoint, _ := child.getEndpointInNetwork(n) + if cEndpoint != nil && cEndpoint.ID() != "" { + childEndpoints = append(childEndpoints, cEndpoint.ID()) + } + } + + bridgeSettings := container.NetworkSettings.Networks["bridge"] + refs := container.daemon.containerGraph().RefPaths(container.ID) + for _, ref := range refs { + if ref.ParentID == "0" { + continue + } + + c, err := container.daemon.Get(ref.ParentID) + if err != nil { + logrus.Error(err) + } + + if c != nil && !container.daemon.configStore.DisableBridge && container.hostConfig.NetworkMode.IsPrivate() { + logrus.Debugf("Update /etc/hosts of %s for alias %s with ip %s", c.ID, ref.Name, bridgeSettings.IPAddress) + sboxOptions = append(sboxOptions, libnetwork.OptionParentUpdate(c.ID, ref.Name, bridgeSettings.IPAddress)) + if ep.ID() != "" { + parentEndpoints = append(parentEndpoints, ep.ID()) + } + } + } + + linkOptions := options.Generic{ + netlabel.GenericData: options.Generic{ + "ParentEndpoints": parentEndpoints, + "ChildEndpoints": childEndpoints, + }, + } + + sboxOptions = append(sboxOptions, libnetwork.OptionGeneric(linkOptions)) + + return sboxOptions, nil +} + +func isLinkable(child *Container) bool { + // A container is linkable only if it belongs to the default network + _, ok := child.NetworkSettings.Networks["bridge"] + return ok +} + +func (container *Container) getEndpointInNetwork(n libnetwork.Network) (libnetwork.Endpoint, error) { + endpointName := strings.TrimPrefix(container.Name, "/") + return n.EndpointByName(endpointName) +} + +func (container *Container) buildPortMapInfo(ep libnetwork.Endpoint, networkSettings *network.Settings) (*network.Settings, error) { + if ep == nil { + return nil, derr.ErrorCodeEmptyEndpoint + } + + if networkSettings == nil { + return nil, derr.ErrorCodeEmptyNetwork + } + + driverInfo, err := ep.DriverInfo() + if err != nil { + return nil, err + } + + if driverInfo == nil { + // It is not an error for epInfo to be nil + return networkSettings, nil + } + + if networkSettings.Ports == nil { + networkSettings.Ports = nat.PortMap{} + } + + if expData, ok := driverInfo[netlabel.ExposedPorts]; ok { + if exposedPorts, ok := expData.([]types.TransportPort); ok { + for _, tp := range exposedPorts { + natPort, err := nat.NewPort(tp.Proto.String(), strconv.Itoa(int(tp.Port))) + if err != nil { + return nil, derr.ErrorCodeParsingPort.WithArgs(tp.Port, err) + } + networkSettings.Ports[natPort] = nil + } + } + } + + mapData, ok := driverInfo[netlabel.PortMap] + if !ok { + return networkSettings, nil + } + + if portMapping, ok := mapData.([]types.PortBinding); ok { + for _, pp := range portMapping { + natPort, err := nat.NewPort(pp.Proto.String(), strconv.Itoa(int(pp.Port))) + if err != nil { + return nil, err + } + natBndg := nat.PortBinding{HostIP: pp.HostIP.String(), HostPort: strconv.Itoa(int(pp.HostPort))} + networkSettings.Ports[natPort] = append(networkSettings.Ports[natPort], natBndg) + } + } + + return networkSettings, nil +} + +func (container *Container) buildEndpointInfo(n libnetwork.Network, ep libnetwork.Endpoint, networkSettings *network.Settings) (*network.Settings, error) { + if ep == nil { + return nil, derr.ErrorCodeEmptyEndpoint + } + + if networkSettings == nil { + return nil, derr.ErrorCodeEmptyNetwork + } + + epInfo := ep.Info() + if epInfo == nil { + // It is not an error to get an empty endpoint info + return networkSettings, nil + } + + if _, ok := networkSettings.Networks[n.Name()]; !ok { + networkSettings.Networks[n.Name()] = new(network.EndpointSettings) + } + networkSettings.Networks[n.Name()].EndpointID = ep.ID() + + iface := epInfo.Iface() + if iface == nil { + return networkSettings, nil + } + + if iface.MacAddress() != nil { + networkSettings.Networks[n.Name()].MacAddress = iface.MacAddress().String() + } + + if iface.Address() != nil { + ones, _ := iface.Address().Mask.Size() + networkSettings.Networks[n.Name()].IPAddress = iface.Address().IP.String() + networkSettings.Networks[n.Name()].IPPrefixLen = ones + } + + if iface.AddressIPv6() != nil && iface.AddressIPv6().IP.To16() != nil { + onesv6, _ := iface.AddressIPv6().Mask.Size() + networkSettings.Networks[n.Name()].GlobalIPv6Address = iface.AddressIPv6().IP.String() + networkSettings.Networks[n.Name()].GlobalIPv6PrefixLen = onesv6 + } + + return networkSettings, nil +} + +func (container *Container) updateJoinInfo(n libnetwork.Network, ep libnetwork.Endpoint) error { + if _, err := container.buildPortMapInfo(ep, container.NetworkSettings); err != nil { + return err + } + + epInfo := ep.Info() + if epInfo == nil { + // It is not an error to get an empty endpoint info + return nil + } + if epInfo.Gateway() != nil { + container.NetworkSettings.Networks[n.Name()].Gateway = epInfo.Gateway().String() + } + if epInfo.GatewayIPv6().To16() != nil { + container.NetworkSettings.Networks[n.Name()].IPv6Gateway = epInfo.GatewayIPv6().String() + } + + return nil +} + +func (container *Container) updateNetworkSettings(n libnetwork.Network) error { + if container.NetworkSettings == nil { + container.NetworkSettings = &network.Settings{Networks: make(map[string]*network.EndpointSettings)} + } + + if !container.hostConfig.NetworkMode.IsHost() && runconfig.NetworkMode(n.Type()).IsHost() { + return runconfig.ErrConflictHostNetwork + } + + for s := range container.NetworkSettings.Networks { + sn, err := container.daemon.FindNetwork(s) + if err != nil { + continue + } + + if sn.Name() == n.Name() { + // Avoid duplicate config + return nil + } + if !runconfig.NetworkMode(sn.Type()).IsPrivate() || + !runconfig.NetworkMode(n.Type()).IsPrivate() { + return runconfig.ErrConflictSharedNetwork + } + if runconfig.NetworkMode(sn.Name()).IsNone() || + runconfig.NetworkMode(n.Name()).IsNone() { + return runconfig.ErrConflictNoNetwork + } + } + container.NetworkSettings.Networks[n.Name()] = new(network.EndpointSettings) + + return nil +} + +func (container *Container) updateEndpointNetworkSettings(n libnetwork.Network, ep libnetwork.Endpoint) error { + networkSettings, err := container.buildEndpointInfo(n, ep, container.NetworkSettings) + if err != nil { + return err + } + + if container.hostConfig.NetworkMode == runconfig.NetworkMode("bridge") { + networkSettings.Bridge = container.daemon.configStore.Bridge.Iface + } + + return nil +} + +func (container *Container) updateSandboxNetworkSettings(sb libnetwork.Sandbox) error { + container.NetworkSettings.SandboxID = sb.ID() + container.NetworkSettings.SandboxKey = sb.Key() + return nil +} + +// UpdateNetwork is used to update the container's network (e.g. when linked containers +// get removed/unlinked). +func (container *Container) updateNetwork() error { + ctrl := container.daemon.netController + sid := container.NetworkSettings.SandboxID + + sb, err := ctrl.SandboxByID(sid) + if err != nil { + return derr.ErrorCodeNoSandbox.WithArgs(sid, err) + } + + // Find if container is connected to the default bridge network + var n libnetwork.Network + for name := range container.NetworkSettings.Networks { + sn, err := container.daemon.FindNetwork(name) + if err != nil { + continue + } + if sn.Name() == "bridge" { + n = sn + break + } + } + + if n == nil { + // Not connected to the default bridge network; Nothing to do + return nil + } + + options, err := container.buildSandboxOptions(n) + if err != nil { + return derr.ErrorCodeNetworkUpdate.WithArgs(err) + } + + if err := sb.Refresh(options...); err != nil { + return derr.ErrorCodeNetworkRefresh.WithArgs(sid, err) + } + + return nil +} + +func (container *Container) buildCreateEndpointOptions(n libnetwork.Network) ([]libnetwork.EndpointOption, error) { + var ( + portSpecs = make(nat.PortSet) + bindings = make(nat.PortMap) + pbList []types.PortBinding + exposeList []types.TransportPort + createOptions []libnetwork.EndpointOption + ) + + if n.Name() == "bridge" || container.NetworkSettings.IsAnonymousEndpoint { + createOptions = append(createOptions, libnetwork.CreateOptionAnonymous()) + } + + // Other configs are applicable only for the endpoint in the network + // to which container was connected to on docker run. + if n.Name() != container.hostConfig.NetworkMode.NetworkName() && + !(n.Name() == "bridge" && container.hostConfig.NetworkMode.IsDefault()) { + return createOptions, nil + } + + if container.Config.ExposedPorts != nil { + portSpecs = container.Config.ExposedPorts + } + + if container.hostConfig.PortBindings != nil { + for p, b := range container.hostConfig.PortBindings { + bindings[p] = []nat.PortBinding{} + for _, bb := range b { + bindings[p] = append(bindings[p], nat.PortBinding{ + HostIP: bb.HostIP, + HostPort: bb.HostPort, + }) + } + } + } + + ports := make([]nat.Port, len(portSpecs)) + var i int + for p := range portSpecs { + ports[i] = p + i++ + } + nat.SortPortMap(ports, bindings) + for _, port := range ports { + expose := types.TransportPort{} + expose.Proto = types.ParseProtocol(port.Proto()) + expose.Port = uint16(port.Int()) + exposeList = append(exposeList, expose) + + pb := types.PortBinding{Port: expose.Port, Proto: expose.Proto} + binding := bindings[port] + for i := 0; i < len(binding); i++ { + pbCopy := pb.GetCopy() + newP, err := nat.NewPort(nat.SplitProtoPort(binding[i].HostPort)) + var portStart, portEnd int + if err == nil { + portStart, portEnd, err = newP.Range() + } + if err != nil { + return nil, derr.ErrorCodeHostPort.WithArgs(binding[i].HostPort, err) + } + pbCopy.HostPort = uint16(portStart) + pbCopy.HostPortEnd = uint16(portEnd) + pbCopy.HostIP = net.ParseIP(binding[i].HostIP) + pbList = append(pbList, pbCopy) + } + + if container.hostConfig.PublishAllPorts && len(binding) == 0 { + pbList = append(pbList, pb) + } + } + + createOptions = append(createOptions, + libnetwork.CreateOptionPortMapping(pbList), + libnetwork.CreateOptionExposedPorts(exposeList)) + + if container.Config.MacAddress != "" { + mac, err := net.ParseMAC(container.Config.MacAddress) + if err != nil { + return nil, err + } + + genericOption := options.Generic{ + netlabel.MacAddress: mac, + } + + createOptions = append(createOptions, libnetwork.EndpointOptionGeneric(genericOption)) + } + + return createOptions, nil +} + +func createNetwork(controller libnetwork.NetworkController, dnet string, driver string) (libnetwork.Network, error) { + createOptions := []libnetwork.NetworkOption{} + genericOption := options.Generic{} + + // Bridge driver is special due to legacy reasons + if runconfig.NetworkMode(driver).IsBridge() { + genericOption[netlabel.GenericData] = map[string]string{ + bridge.BridgeName: dnet, + } + networkOption := libnetwork.NetworkOptionGeneric(genericOption) + createOptions = append(createOptions, networkOption) + } + + return controller.NewNetwork(driver, dnet, createOptions...) +} + +func (container *Container) allocateNetwork() error { + controller := container.daemon.netController + + // Cleanup any stale sandbox left over due to ungraceful daemon shutdown + if err := controller.SandboxDestroy(container.ID); err != nil { + logrus.Errorf("failed to cleanup up stale network sandbox for container %s", container.ID) + } + + updateSettings := false + if len(container.NetworkSettings.Networks) == 0 { + mode := container.hostConfig.NetworkMode + if container.Config.NetworkDisabled || mode.IsContainer() { + return nil + } + + networkName := mode.NetworkName() + if mode.IsDefault() { + networkName = controller.Config().Daemon.DefaultNetwork + } + if mode.IsUserDefined() { + n, err := container.daemon.FindNetwork(networkName) + if err != nil { + return err + } + networkName = n.Name() + } + container.NetworkSettings.Networks = make(map[string]*network.EndpointSettings) + container.NetworkSettings.Networks[networkName] = new(network.EndpointSettings) + updateSettings = true + } + + for n := range container.NetworkSettings.Networks { + if err := container.connectToNetwork(n, updateSettings); err != nil { + return err + } + } + + return container.writeHostConfig() +} + +func (container *Container) getNetworkSandbox() libnetwork.Sandbox { + var sb libnetwork.Sandbox + container.daemon.netController.WalkSandboxes(func(s libnetwork.Sandbox) bool { + if s.ContainerID() == container.ID { + sb = s + return true + } + return false + }) + return sb +} + +// ConnectToNetwork connects a container to a network +func (container *Container) ConnectToNetwork(idOrName string) error { + if !container.Running { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + if err := container.connectToNetwork(idOrName, true); err != nil { + return err + } + if err := container.toDiskLocking(); err != nil { + return fmt.Errorf("Error saving container to disk: %v", err) + } + return nil +} + +func (container *Container) connectToNetwork(idOrName string, updateSettings bool) (err error) { + if container.hostConfig.NetworkMode.IsContainer() { + return runconfig.ErrConflictSharedNetwork + } + + if runconfig.NetworkMode(idOrName).IsBridge() && + container.daemon.configStore.DisableBridge { + container.Config.NetworkDisabled = true + return nil + } + + controller := container.daemon.netController + + n, err := container.daemon.FindNetwork(idOrName) + if err != nil { + return err + } + + if updateSettings { + if err := container.updateNetworkSettings(n); err != nil { + return err + } + } + + ep, err := container.getEndpointInNetwork(n) + if err == nil { + return fmt.Errorf("container already connected to network %s", idOrName) + } + + if _, ok := err.(libnetwork.ErrNoSuchEndpoint); !ok { + return err + } + + createOptions, err := container.buildCreateEndpointOptions(n) + if err != nil { + return err + } + + endpointName := strings.TrimPrefix(container.Name, "/") + ep, err = n.CreateEndpoint(endpointName, createOptions...) + if err != nil { + return err + } + defer func() { + if err != nil { + if e := ep.Delete(); e != nil { + logrus.Warnf("Could not rollback container connection to network %s", idOrName) + } + } + }() + + if err := container.updateEndpointNetworkSettings(n, ep); err != nil { + return err + } + + sb := container.getNetworkSandbox() + if sb == nil { + options, err := container.buildSandboxOptions(n) + if err != nil { + return err + } + sb, err = controller.NewSandbox(container.ID, options...) + if err != nil { + return err + } + + container.updateSandboxNetworkSettings(sb) + } + + if err := ep.Join(sb); err != nil { + return err + } + + if err := container.updateJoinInfo(n, ep); err != nil { + return derr.ErrorCodeJoinInfo.WithArgs(err) + } + + return nil +} + +func (container *Container) initializeNetworking() error { + var err error + + if container.hostConfig.NetworkMode.IsContainer() { + // we need to get the hosts files from the container to join + nc, err := container.getNetworkedContainer() + if err != nil { + return err + } + container.HostnamePath = nc.HostnamePath + container.HostsPath = nc.HostsPath + container.ResolvConfPath = nc.ResolvConfPath + container.Config.Hostname = nc.Config.Hostname + container.Config.Domainname = nc.Config.Domainname + return nil + } + + if container.hostConfig.NetworkMode.IsHost() { + container.Config.Hostname, err = os.Hostname() + if err != nil { + return err + } + + parts := strings.SplitN(container.Config.Hostname, ".", 2) + if len(parts) > 1 { + container.Config.Hostname = parts[0] + container.Config.Domainname = parts[1] + } + + } + + if err := container.allocateNetwork(); err != nil { + return err + } + + return container.buildHostnameFile() +} + +// called from the libcontainer pre-start hook to set the network +// namespace configuration linkage to the libnetwork "sandbox" entity +func (container *Container) setNetworkNamespaceKey(pid int) error { + path := fmt.Sprintf("/proc/%d/ns/net", pid) + var sandbox libnetwork.Sandbox + search := libnetwork.SandboxContainerWalker(&sandbox, container.ID) + container.daemon.netController.WalkSandboxes(search) + if sandbox == nil { + return derr.ErrorCodeNoSandbox.WithArgs(container.ID) + } + + return sandbox.SetKey(path) +} + +func (container *Container) getIpcContainer() (*Container, error) { + containerID := container.hostConfig.IpcMode.Container() + c, err := container.daemon.Get(containerID) + if err != nil { + return nil, err + } + if !c.IsRunning() { + return nil, derr.ErrorCodeIPCRunning + } + return c, nil +} + +func (container *Container) setupWorkingDirectory() error { + if container.Config.WorkingDir != "" { + container.Config.WorkingDir = filepath.Clean(container.Config.WorkingDir) + + pth, err := container.GetResourcePath(container.Config.WorkingDir) + if err != nil { + return err + } + + pthInfo, err := os.Stat(pth) + if err != nil { + if !os.IsNotExist(err) { + return err + } + + if err := system.MkdirAll(pth, 0755); err != nil { + return err + } + } + if pthInfo != nil && !pthInfo.IsDir() { + return derr.ErrorCodeNotADir.WithArgs(container.Config.WorkingDir) + } + } + return nil +} + +func (container *Container) getNetworkedContainer() (*Container, error) { + parts := strings.SplitN(string(container.hostConfig.NetworkMode), ":", 2) + switch parts[0] { + case "container": + if len(parts) != 2 { + return nil, derr.ErrorCodeParseContainer + } + nc, err := container.daemon.Get(parts[1]) + if err != nil { + return nil, err + } + if container == nc { + return nil, derr.ErrorCodeJoinSelf + } + if !nc.IsRunning() { + return nil, derr.ErrorCodeJoinRunning.WithArgs(parts[1]) + } + return nc, nil + default: + return nil, derr.ErrorCodeModeNotContainer + } +} + +func (container *Container) releaseNetwork() { + if container.hostConfig.NetworkMode.IsContainer() || container.Config.NetworkDisabled { + return + } + + sid := container.NetworkSettings.SandboxID + networks := container.NetworkSettings.Networks + for n := range networks { + networks[n] = &network.EndpointSettings{} + } + + container.NetworkSettings = &network.Settings{Networks: networks} + + if sid == "" || len(networks) == 0 { + return + } + + sb, err := container.daemon.netController.SandboxByID(sid) + if err != nil { + logrus.Errorf("error locating sandbox id %s: %v", sid, err) + return + } + + if err := sb.Delete(); err != nil { + logrus.Errorf("Error deleting sandbox id %s for container %s: %v", sid, container.ID, err) + } +} + +// DisconnectFromNetwork disconnects a container from a network +func (container *Container) DisconnectFromNetwork(n libnetwork.Network) error { + if !container.Running { + return derr.ErrorCodeNotRunning.WithArgs(container.ID) + } + + if container.hostConfig.NetworkMode.IsHost() && runconfig.NetworkMode(n.Type()).IsHost() { + return runconfig.ErrConflictHostNetwork + } + + if err := container.disconnectFromNetwork(n); err != nil { + return err + } + + if err := container.toDiskLocking(); err != nil { + return fmt.Errorf("Error saving container to disk: %v", err) + } + return nil +} + +func (container *Container) disconnectFromNetwork(n libnetwork.Network) error { + var ( + ep libnetwork.Endpoint + sbox libnetwork.Sandbox + ) + + s := func(current libnetwork.Endpoint) bool { + epInfo := current.Info() + if epInfo == nil { + return false + } + if sb := epInfo.Sandbox(); sb != nil { + if sb.ContainerID() == container.ID { + ep = current + sbox = sb + return true + } + } + return false + } + n.WalkEndpoints(s) + + if ep == nil { + return fmt.Errorf("container %s is not connected to the network", container.ID) + } + + if err := ep.Leave(sbox); err != nil { + return fmt.Errorf("container %s failed to leave network %s: %v", container.ID, n.Name(), err) + } + + if err := ep.Delete(); err != nil { + return fmt.Errorf("endpoint delete failed for container %s on network %s: %v", container.ID, n.Name(), err) + } + + delete(container.NetworkSettings.Networks, n.Name()) + return nil +} + +func (container *Container) unmountVolumes(forceSyscall bool) error { + var volumeMounts []mountPoint + + for _, mntPoint := range container.MountPoints { + dest, err := container.GetResourcePath(mntPoint.Destination) + if err != nil { + return err + } + + volumeMounts = append(volumeMounts, mountPoint{Destination: dest, Volume: mntPoint.Volume}) + } + + for _, mnt := range container.networkMounts() { + dest, err := container.GetResourcePath(mnt.Destination) + if err != nil { + return err + } + + volumeMounts = append(volumeMounts, mountPoint{Destination: dest}) + } + + for _, volumeMount := range volumeMounts { + if forceSyscall { + syscall.Unmount(volumeMount.Destination, 0) + } + + if volumeMount.Volume != nil { + if err := volumeMount.Volume.Unmount(); err != nil { + return err + } + } + } + + return nil +} + +func (container *Container) networkMounts() []execdriver.Mount { + var mounts []execdriver.Mount + shared := container.hostConfig.NetworkMode.IsContainer() + if container.ResolvConfPath != "" { + if _, err := os.Stat(container.ResolvConfPath); err != nil { + logrus.Warnf("ResolvConfPath set to %q, but can't stat this filename (err = %v); skipping", container.ResolvConfPath, err) + } else { + label.Relabel(container.ResolvConfPath, container.MountLabel, shared) + writable := !container.hostConfig.ReadonlyRootfs + if m, exists := container.MountPoints["/etc/resolv.conf"]; exists { + writable = m.RW + } + mounts = append(mounts, execdriver.Mount{ + Source: container.ResolvConfPath, + Destination: "/etc/resolv.conf", + Writable: writable, + Private: true, + }) + } + } + if container.HostnamePath != "" { + if _, err := os.Stat(container.HostnamePath); err != nil { + logrus.Warnf("HostnamePath set to %q, but can't stat this filename (err = %v); skipping", container.HostnamePath, err) + } else { + label.Relabel(container.HostnamePath, container.MountLabel, shared) + writable := !container.hostConfig.ReadonlyRootfs + if m, exists := container.MountPoints["/etc/hostname"]; exists { + writable = m.RW + } + mounts = append(mounts, execdriver.Mount{ + Source: container.HostnamePath, + Destination: "/etc/hostname", + Writable: writable, + Private: true, + }) + } + } + if container.HostsPath != "" { + if _, err := os.Stat(container.HostsPath); err != nil { + logrus.Warnf("HostsPath set to %q, but can't stat this filename (err = %v); skipping", container.HostsPath, err) + } else { + label.Relabel(container.HostsPath, container.MountLabel, shared) + writable := !container.hostConfig.ReadonlyRootfs + if m, exists := container.MountPoints["/etc/hosts"]; exists { + writable = m.RW + } + mounts = append(mounts, execdriver.Mount{ + Source: container.HostsPath, + Destination: "/etc/hosts", + Writable: writable, + Private: true, + }) + } + } + return mounts +} + +func (container *Container) addBindMountPoint(name, source, destination string, rw bool) { + container.MountPoints[destination] = &mountPoint{ + Name: name, + Source: source, + Destination: destination, + RW: rw, + } +} + +func (container *Container) addLocalMountPoint(name, destination string, rw bool) { + container.MountPoints[destination] = &mountPoint{ + Name: name, + Driver: volume.DefaultDriverName, + Destination: destination, + RW: rw, + } +} + +func (container *Container) addMountPointWithVolume(destination string, vol volume.Volume, rw bool) { + container.MountPoints[destination] = &mountPoint{ + Name: vol.Name(), + Driver: vol.DriverName(), + Destination: destination, + RW: rw, + Volume: vol, + } +} + +func (container *Container) isDestinationMounted(destination string) bool { + return container.MountPoints[destination] != nil +} + +func (container *Container) prepareMountPoints() error { + for _, config := range container.MountPoints { + if len(config.Driver) > 0 { + v, err := container.daemon.createVolume(config.Name, config.Driver, nil) + if err != nil { + return err + } + config.Volume = v + } + } + return nil +} + +func (container *Container) removeMountPoints(rm bool) error { + var rmErrors []string + for _, m := range container.MountPoints { + if m.Volume == nil { + continue + } + container.daemon.volumes.Decrement(m.Volume) + if rm { + err := container.daemon.volumes.Remove(m.Volume) + // ErrVolumeInUse is ignored because having this + // volume being referenced by othe container is + // not an error, but an implementation detail. + // This prevents docker from logging "ERROR: Volume in use" + // where there is another container using the volume. + if err != nil && err != store.ErrVolumeInUse { + rmErrors = append(rmErrors, err.Error()) + } + } + } + if len(rmErrors) > 0 { + return derr.ErrorCodeRemovingVolume.WithArgs(strings.Join(rmErrors, "\n")) + } + return nil +} + +func (container *Container) shmPath() (string, error) { + return container.getRootResourcePath("shm") +} +func (container *Container) mqueuePath() (string, error) { + return container.getRootResourcePath("mqueue") +} + +func (container *Container) hasMountFor(path string) bool { + _, exists := container.MountPoints[path] + return exists +} + +func (container *Container) setupIpcDirs() error { + rootUID, rootGID := container.daemon.GetRemappedUIDGID() + if !container.hasMountFor("/dev/shm") { + shmPath, err := container.shmPath() + if err != nil { + return err + } + + if err := idtools.MkdirAllAs(shmPath, 0700, rootUID, rootGID); err != nil { + return err + } + + if err := syscall.Mount("shm", shmPath, "tmpfs", uintptr(syscall.MS_NOEXEC|syscall.MS_NOSUID|syscall.MS_NODEV), label.FormatMountLabel("mode=1777,size=65536k", container.getMountLabel())); err != nil { + return fmt.Errorf("mounting shm tmpfs: %s", err) + } + if err := os.Chown(shmPath, rootUID, rootGID); err != nil { + return err + } + } + + if !container.hasMountFor("/dev/mqueue") { + mqueuePath, err := container.mqueuePath() + if err != nil { + return err + } + + if err := idtools.MkdirAllAs(mqueuePath, 0700, rootUID, rootGID); err != nil { + return err + } + + if err := syscall.Mount("mqueue", mqueuePath, "mqueue", uintptr(syscall.MS_NOEXEC|syscall.MS_NOSUID|syscall.MS_NODEV), ""); err != nil { + return fmt.Errorf("mounting mqueue mqueue : %s", err) + } + if err := os.Chown(mqueuePath, rootUID, rootGID); err != nil { + return err + } + } + + return nil +} + +func (container *Container) unmountIpcMounts(unmount func(pth string) error) { + if container.hostConfig.IpcMode.IsContainer() || container.hostConfig.IpcMode.IsHost() { + return + } + + var warnings []string + + if !container.hasMountFor("/dev/shm") { + shmPath, err := container.shmPath() + if err != nil { + logrus.Error(err) + warnings = append(warnings, err.Error()) + } else if shmPath != "" { + if err := unmount(shmPath); err != nil { + warnings = append(warnings, fmt.Sprintf("failed to umount %s: %v", shmPath, err)) + } + + } + } + + if !container.hasMountFor("/dev/mqueue") { + mqueuePath, err := container.mqueuePath() + if err != nil { + logrus.Error(err) + warnings = append(warnings, err.Error()) + } else if mqueuePath != "" { + if err := unmount(mqueuePath); err != nil { + warnings = append(warnings, fmt.Sprintf("failed to umount %s: %v", mqueuePath, err)) + } + } + } + + if len(warnings) > 0 { + logrus.Warnf("failed to cleanup ipc mounts:\n%v", strings.Join(warnings, "\n")) + } +} + +func (container *Container) ipcMounts() []execdriver.Mount { + var mounts []execdriver.Mount + + if !container.hasMountFor("/dev/shm") { + label.SetFileLabel(container.ShmPath, container.MountLabel) + mounts = append(mounts, execdriver.Mount{ + Source: container.ShmPath, + Destination: "/dev/shm", + Writable: true, + Private: true, + }) + } + + if !container.hasMountFor("/dev/mqueue") { + label.SetFileLabel(container.MqueuePath, container.MountLabel) + mounts = append(mounts, execdriver.Mount{ + Source: container.MqueuePath, + Destination: "/dev/mqueue", + Writable: true, + Private: true, + }) + } + return mounts +} + +func detachMounted(path string) error { + return syscall.Unmount(path, syscall.MNT_DETACH) +} diff --git a/daemon/container_windows.go b/daemon/container_windows.go new file mode 100644 index 0000000000..ff33ba4875 --- /dev/null +++ b/daemon/container_windows.go @@ -0,0 +1,203 @@ +// +build windows + +package daemon + +import ( + "strings" + + "github.com/docker/docker/daemon/execdriver" + derr "github.com/docker/docker/errors" + "github.com/docker/libnetwork" +) + +// DefaultPathEnv is deliberately empty on Windows as the default path will be set by +// the container. Docker has no context of what the default path should be. +const DefaultPathEnv = "" + +// Container holds fields specific to the Windows implementation. See +// CommonContainer for standard fields common to all containers. +type Container struct { + CommonContainer + + // Fields below here are platform specific. +} + +func killProcessDirectly(container *Container) error { + return nil +} + +func (container *Container) setupLinkedContainers() ([]string, error) { + return nil, nil +} + +func (container *Container) createDaemonEnvironment(linkedEnv []string) []string { + // On Windows, nothing to link. Just return the container environment. + return container.Config.Env +} + +func (container *Container) initializeNetworking() error { + return nil +} + +// ConnectToNetwork connects a container to the network +func (container *Container) ConnectToNetwork(idOrName string) error { + return nil +} + +// DisconnectFromNetwork disconnects a container from, the network +func (container *Container) DisconnectFromNetwork(n libnetwork.Network) error { + return nil +} + +func (container *Container) setupWorkingDirectory() error { + return nil +} + +func populateCommand(c *Container, env []string) error { + en := &execdriver.Network{ + Interface: nil, + } + + parts := strings.SplitN(string(c.hostConfig.NetworkMode), ":", 2) + switch parts[0] { + case "none": + case "default", "": // empty string to support existing containers + if !c.Config.NetworkDisabled { + en.Interface = &execdriver.NetworkInterface{ + MacAddress: c.Config.MacAddress, + Bridge: c.daemon.configStore.Bridge.VirtualSwitchName, + PortBindings: c.hostConfig.PortBindings, + + // TODO Windows. Include IPAddress. There already is a + // property IPAddress on execDrive.CommonNetworkInterface, + // but there is no CLI option in docker to pass through + // an IPAddress on docker run. + } + } + default: + return derr.ErrorCodeInvalidNetworkMode.WithArgs(c.hostConfig.NetworkMode) + } + + pid := &execdriver.Pid{} + + // TODO Windows. This can probably be factored out. + pid.HostPid = c.hostConfig.PidMode.IsHost() + + // TODO Windows. More resource controls to be implemented later. + resources := &execdriver.Resources{ + CPUShares: c.hostConfig.CPUShares, + } + + // TODO Windows. Further refactoring required (privileged/user) + processConfig := execdriver.ProcessConfig{ + Privileged: c.hostConfig.Privileged, + Entrypoint: c.Path, + Arguments: c.Args, + Tty: c.Config.Tty, + User: c.Config.User, + ConsoleSize: c.hostConfig.ConsoleSize, + } + + processConfig.Env = env + + var layerPaths []string + img, err := c.daemon.graph.Get(c.ImageID) + if err != nil { + return derr.ErrorCodeGetGraph.WithArgs(c.ImageID, err) + } + for i := img; i != nil && err == nil; i, err = c.daemon.graph.GetParent(i) { + lp, err := c.daemon.driver.Get(i.ID, "") + if err != nil { + return derr.ErrorCodeGetLayer.WithArgs(c.daemon.driver.String(), i.ID, err) + } + layerPaths = append(layerPaths, lp) + err = c.daemon.driver.Put(i.ID) + if err != nil { + return derr.ErrorCodePutLayer.WithArgs(c.daemon.driver.String(), i.ID, err) + } + } + m, err := c.daemon.driver.GetMetadata(c.ID) + if err != nil { + return derr.ErrorCodeGetLayerMetadata.WithArgs(err) + } + layerFolder := m["dir"] + + // TODO Windows: Factor out remainder of unused fields. + c.command = &execdriver.Command{ + ID: c.ID, + Rootfs: c.rootfsPath(), + ReadonlyRootfs: c.hostConfig.ReadonlyRootfs, + InitPath: "/.dockerinit", + WorkingDir: c.Config.WorkingDir, + Network: en, + Pid: pid, + Resources: resources, + CapAdd: c.hostConfig.CapAdd.Slice(), + CapDrop: c.hostConfig.CapDrop.Slice(), + ProcessConfig: processConfig, + ProcessLabel: c.getProcessLabel(), + MountLabel: c.getMountLabel(), + FirstStart: !c.HasBeenStartedBefore, + LayerFolder: layerFolder, + LayerPaths: layerPaths, + Hostname: c.Config.Hostname, + } + + return nil +} + +// GetSize returns real size & virtual size +func (container *Container) getSize() (int64, int64) { + // TODO Windows + return 0, 0 +} + +// setNetworkNamespaceKey is a no-op on Windows. +func (container *Container) setNetworkNamespaceKey(pid int) error { + return nil +} + +// allocateNetwork is a no-op on Windows. +func (container *Container) allocateNetwork() error { + return nil +} + +func (container *Container) updateNetwork() error { + return nil +} + +func (container *Container) releaseNetwork() { +} + +func (container *Container) unmountVolumes(forceSyscall bool) error { + return nil +} + +// prepareMountPoints is a no-op on Windows +func (container *Container) prepareMountPoints() error { + return nil +} + +// removeMountPoints is a no-op on Windows. +func (container *Container) removeMountPoints(_ bool) error { + return nil +} + +func (container *Container) unmountIpcMounts(unmount func(pth string) error) { +} + +func detachMounted(path string) error { + return nil +} + +func (container *Container) setupIpcDirs() error { + return nil +} + +func (container *Container) ipcMounts() []execdriver.Mount { + return nil +} + +func getDefaultRouteMtu() (int, error) { + return -1, errSystemNotSupported +} diff --git a/daemon/create.go b/daemon/create.go new file mode 100644 index 0000000000..83a1a8b7e4 --- /dev/null +++ b/daemon/create.go @@ -0,0 +1,158 @@ +package daemon + +import ( + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/volume" + "github.com/opencontainers/runc/libcontainer/label" +) + +// ContainerCreate takes configs and creates a container. +func (daemon *Daemon) ContainerCreate(name string, config *runconfig.Config, hostConfig *runconfig.HostConfig, adjustCPUShares bool) (types.ContainerCreateResponse, error) { + if config == nil { + return types.ContainerCreateResponse{}, derr.ErrorCodeEmptyConfig + } + + warnings, err := daemon.verifyContainerSettings(hostConfig, config) + if err != nil { + return types.ContainerCreateResponse{"", warnings}, err + } + + daemon.adaptContainerSettings(hostConfig, adjustCPUShares) + + container, err := daemon.Create(config, hostConfig, name) + if err != nil { + if daemon.Graph().IsNotExist(err, config.Image) { + if strings.Contains(config.Image, "@") { + return types.ContainerCreateResponse{"", warnings}, derr.ErrorCodeNoSuchImageHash.WithArgs(config.Image) + } + img, tag := parsers.ParseRepositoryTag(config.Image) + if tag == "" { + tag = tags.DefaultTag + } + return types.ContainerCreateResponse{"", warnings}, derr.ErrorCodeNoSuchImageTag.WithArgs(img, tag) + } + return types.ContainerCreateResponse{"", warnings}, err + } + + return types.ContainerCreateResponse{container.ID, warnings}, nil +} + +// Create creates a new container from the given configuration with a given name. +func (daemon *Daemon) Create(config *runconfig.Config, hostConfig *runconfig.HostConfig, name string) (retC *Container, retErr error) { + var ( + container *Container + img *image.Image + imgID string + err error + ) + + if config.Image != "" { + img, err = daemon.repositories.LookupImage(config.Image) + if err != nil { + return nil, err + } + if err = daemon.graph.CheckDepth(img); err != nil { + return nil, err + } + imgID = img.ID + } + + if err := daemon.mergeAndVerifyConfig(config, img); err != nil { + return nil, err + } + + if hostConfig == nil { + hostConfig = &runconfig.HostConfig{} + } + if hostConfig.SecurityOpt == nil { + hostConfig.SecurityOpt, err = daemon.generateSecurityOpt(hostConfig.IpcMode, hostConfig.PidMode) + if err != nil { + return nil, err + } + } + if container, err = daemon.newContainer(name, config, imgID); err != nil { + return nil, err + } + defer func() { + if retErr != nil { + if err := daemon.rm(container, false); err != nil { + logrus.Errorf("Clean up Error! Cannot destroy container %s: %v", container.ID, err) + } + } + }() + + if err := daemon.Register(container); err != nil { + return nil, err + } + if err := daemon.createRootfs(container); err != nil { + return nil, err + } + if err := daemon.setHostConfig(container, hostConfig); err != nil { + return nil, err + } + defer func() { + if retErr != nil { + if err := container.removeMountPoints(true); err != nil { + logrus.Error(err) + } + } + }() + if err := container.Mount(); err != nil { + return nil, err + } + defer container.Unmount() + + if err := createContainerPlatformSpecificSettings(container, config, hostConfig, img); err != nil { + return nil, err + } + + if err := container.toDiskLocking(); err != nil { + logrus.Errorf("Error saving new container to disk: %v", err) + return nil, err + } + container.logEvent("create") + return container, nil +} + +func (daemon *Daemon) generateSecurityOpt(ipcMode runconfig.IpcMode, pidMode runconfig.PidMode) ([]string, error) { + if ipcMode.IsHost() || pidMode.IsHost() { + return label.DisableSecOpt(), nil + } + if ipcContainer := ipcMode.Container(); ipcContainer != "" { + c, err := daemon.Get(ipcContainer) + if err != nil { + return nil, err + } + + return label.DupSecOpt(c.ProcessLabel), nil + } + return nil, nil +} + +// VolumeCreate creates a volume with the specified name, driver, and opts +// This is called directly from the remote API +func (daemon *Daemon) VolumeCreate(name, driverName string, opts map[string]string) (*types.Volume, error) { + if name == "" { + name = stringid.GenerateNonCryptoID() + } + + v, err := daemon.volumes.Create(name, driverName, opts) + if err != nil { + return nil, err + } + + // keep "docker run -v existing_volume:/foo --volume-driver other_driver" work + if (driverName != "" && v.DriverName() != driverName) || (driverName == "" && v.DriverName() != volume.DefaultDriverName) { + return nil, derr.ErrorVolumeNameTaken.WithArgs(name, v.DriverName()) + } + return volumeToAPIType(v), nil +} diff --git a/daemon/create_unix.go b/daemon/create_unix.go new file mode 100644 index 0000000000..66138db967 --- /dev/null +++ b/daemon/create_unix.go @@ -0,0 +1,67 @@ +// +build !windows + +package daemon + +import ( + "os" + "path/filepath" + + derr "github.com/docker/docker/errors" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/volume" + "github.com/opencontainers/runc/libcontainer/label" +) + +// createContainerPlatformSpecificSettings performs platform specific container create functionality +func createContainerPlatformSpecificSettings(container *Container, config *runconfig.Config, hostConfig *runconfig.HostConfig, img *image.Image) error { + for spec := range config.Volumes { + name := stringid.GenerateNonCryptoID() + destination := filepath.Clean(spec) + + // Skip volumes for which we already have something mounted on that + // destination because of a --volume-from. + if container.isDestinationMounted(destination) { + continue + } + path, err := container.GetResourcePath(destination) + if err != nil { + return err + } + + stat, err := os.Stat(path) + if err == nil && !stat.IsDir() { + return derr.ErrorCodeMountOverFile.WithArgs(path) + } + + volumeDriver := hostConfig.VolumeDriver + if destination != "" && img != nil { + if _, ok := img.ContainerConfig.Volumes[destination]; ok { + // check for whether bind is not specified and then set to local + if _, ok := container.MountPoints[destination]; !ok { + volumeDriver = volume.DefaultDriverName + } + } + } + + v, err := container.daemon.createVolume(name, volumeDriver, nil) + if err != nil { + return err + } + + if err := label.Relabel(v.Path(), container.MountLabel, true); err != nil { + return err + } + + // never attempt to copy existing content in a container FS to a shared volume + if v.DriverName() == volume.DefaultDriverName { + if err := container.copyImagePathContent(v, destination); err != nil { + return err + } + } + + container.addMountPointWithVolume(destination, v, true) + } + return nil +} diff --git a/daemon/create_windows.go b/daemon/create_windows.go new file mode 100644 index 0000000000..21aac13d31 --- /dev/null +++ b/daemon/create_windows.go @@ -0,0 +1,11 @@ +package daemon + +import ( + "github.com/docker/docker/image" + "github.com/docker/docker/runconfig" +) + +// createContainerPlatformSpecificSettings performs platform specific container create functionality +func createContainerPlatformSpecificSettings(container *Container, config *runconfig.Config, hostConfig *runconfig.HostConfig, img *image.Image) error { + return nil +} diff --git a/daemon/daemon.go b/daemon/daemon.go new file mode 100644 index 0000000000..f394e854a3 --- /dev/null +++ b/daemon/daemon.go @@ -0,0 +1,1289 @@ +// Package daemon exposes the functions that occur on the host server +// that the Docker daemon is running. +// +// In implementing the various functions of the daemon, there is often +// a method-specific struct for configuring the runtime behavior. +package daemon + +import ( + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "runtime" + "strings" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/api/types" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/daemon/events" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/daemon/execdriver/execdrivers" + "github.com/docker/docker/daemon/graphdriver" + _ "github.com/docker/docker/daemon/graphdriver/vfs" // register vfs + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/daemon/network" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/graph" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/broadcaster" + "github.com/docker/docker/pkg/discovery" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/graphdb" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/namesgenerator" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/sysinfo" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/truncindex" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" + volumedrivers "github.com/docker/docker/volume/drivers" + "github.com/docker/docker/volume/local" + "github.com/docker/docker/volume/store" + "github.com/docker/libnetwork" +) + +var ( + validContainerNameChars = utils.RestrictedNameChars + validContainerNamePattern = utils.RestrictedNamePattern + + errSystemNotSupported = errors.New("The Docker daemon is not supported on this platform.") +) + +type contStore struct { + s map[string]*Container + sync.Mutex +} + +func (c *contStore) Add(id string, cont *Container) { + c.Lock() + c.s[id] = cont + c.Unlock() +} + +func (c *contStore) Get(id string) *Container { + c.Lock() + res := c.s[id] + c.Unlock() + return res +} + +func (c *contStore) Delete(id string) { + c.Lock() + delete(c.s, id) + c.Unlock() +} + +func (c *contStore) List() []*Container { + containers := new(History) + c.Lock() + for _, cont := range c.s { + containers.Add(cont) + } + c.Unlock() + containers.sort() + return *containers +} + +// Daemon holds information about the Docker daemon. +type Daemon struct { + ID string + repository string + sysInitPath string + containers *contStore + execCommands *execStore + graph *graph.Graph + repositories *graph.TagStore + idIndex *truncindex.TruncIndex + configStore *Config + containerGraphDB *graphdb.Database + driver graphdriver.Driver + execDriver execdriver.Driver + statsCollector *statsCollector + defaultLogConfig runconfig.LogConfig + RegistryService *registry.Service + EventsService *events.Events + netController libnetwork.NetworkController + volumes *store.VolumeStore + discoveryWatcher discovery.Watcher + root string + shutdown bool + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +// Get looks for a container using the provided information, which could be +// one of the following inputs from the caller: +// - A full container ID, which will exact match a container in daemon's list +// - A container name, which will only exact match via the GetByName() function +// - A partial container ID prefix (e.g. short ID) of any length that is +// unique enough to only return a single container object +// If none of these searches succeed, an error is returned +func (daemon *Daemon) Get(prefixOrName string) (*Container, error) { + if containerByID := daemon.containers.Get(prefixOrName); containerByID != nil { + // prefix is an exact match to a full container ID + return containerByID, nil + } + + // GetByName will match only an exact name provided; we ignore errors + if containerByName, _ := daemon.GetByName(prefixOrName); containerByName != nil { + // prefix is an exact match to a full container Name + return containerByName, nil + } + + containerID, indexError := daemon.idIndex.Get(prefixOrName) + if indexError != nil { + // When truncindex defines an error type, use that instead + if strings.Contains(indexError.Error(), "no such id") { + return nil, derr.ErrorCodeNoSuchContainer.WithArgs(prefixOrName) + } + return nil, indexError + } + return daemon.containers.Get(containerID), nil +} + +// Exists returns a true if a container of the specified ID or name exists, +// false otherwise. +func (daemon *Daemon) Exists(id string) bool { + c, _ := daemon.Get(id) + return c != nil +} + +func (daemon *Daemon) containerRoot(id string) string { + return filepath.Join(daemon.repository, id) +} + +// Load reads the contents of a container from disk +// This is typically done at startup. +func (daemon *Daemon) load(id string) (*Container, error) { + container := daemon.newBaseContainer(id) + + if err := container.fromDisk(); err != nil { + return nil, err + } + + if container.ID != id { + return &container, fmt.Errorf("Container %s is stored at %s", container.ID, id) + } + + return &container, nil +} + +// Register makes a container object usable by the daemon as +func (daemon *Daemon) Register(container *Container) error { + if container.daemon != nil || daemon.Exists(container.ID) { + return fmt.Errorf("Container is already loaded") + } + if err := validateID(container.ID); err != nil { + return err + } + if err := daemon.ensureName(container); err != nil { + return err + } + + container.daemon = daemon + + // Attach to stdout and stderr + container.stderr = new(broadcaster.Unbuffered) + container.stdout = new(broadcaster.Unbuffered) + // Attach to stdin + if container.Config.OpenStdin { + container.stdin, container.stdinPipe = io.Pipe() + } else { + container.stdinPipe = ioutils.NopWriteCloser(ioutil.Discard) // Silently drop stdin + } + // done + daemon.containers.Add(container.ID, container) + + // don't update the Suffixarray if we're starting up + // we'll waste time if we update it for every container + daemon.idIndex.Add(container.ID) + + if container.IsRunning() { + logrus.Debugf("killing old running container %s", container.ID) + // Set exit code to 128 + SIGKILL (9) to properly represent unsuccessful exit + container.setStoppedLocking(&execdriver.ExitStatus{ExitCode: 137}) + // use the current driver and ensure that the container is dead x.x + cmd := &execdriver.Command{ + ID: container.ID, + } + daemon.execDriver.Terminate(cmd) + + container.unmountIpcMounts(mount.Unmount) + + if err := container.Unmount(); err != nil { + logrus.Debugf("unmount error %s", err) + } + if err := container.toDiskLocking(); err != nil { + logrus.Errorf("Error saving stopped state to disk: %v", err) + } + } + + if err := daemon.verifyVolumesInfo(container); err != nil { + return err + } + + if err := container.prepareMountPoints(); err != nil { + return err + } + + return nil +} + +func (daemon *Daemon) ensureName(container *Container) error { + if container.Name == "" { + name, err := daemon.generateNewName(container.ID) + if err != nil { + return err + } + container.Name = name + + if err := container.toDiskLocking(); err != nil { + logrus.Errorf("Error saving container name to disk: %v", err) + } + } + return nil +} + +func (daemon *Daemon) restore() error { + type cr struct { + container *Container + registered bool + } + + var ( + debug = os.Getenv("DEBUG") != "" + currentDriver = daemon.driver.String() + containers = make(map[string]*cr) + ) + + if !debug { + logrus.Info("Loading containers: start.") + } + dir, err := ioutil.ReadDir(daemon.repository) + if err != nil { + return err + } + + for _, v := range dir { + id := v.Name() + container, err := daemon.load(id) + if !debug && logrus.GetLevel() == logrus.InfoLevel { + fmt.Print(".") + } + if err != nil { + logrus.Errorf("Failed to load container %v: %v", id, err) + continue + } + + // Ignore the container if it does not support the current driver being used by the graph + if (container.Driver == "" && currentDriver == "aufs") || container.Driver == currentDriver { + logrus.Debugf("Loaded container %v", container.ID) + + containers[container.ID] = &cr{container: container} + } else { + logrus.Debugf("Cannot load container %s because it was created with another graph driver.", container.ID) + } + } + + if entities := daemon.containerGraphDB.List("/", -1); entities != nil { + for _, p := range entities.Paths() { + if !debug && logrus.GetLevel() == logrus.InfoLevel { + fmt.Print(".") + } + + e := entities[p] + + if c, ok := containers[e.ID()]; ok { + c.registered = true + } + } + } + + group := sync.WaitGroup{} + for _, c := range containers { + group.Add(1) + + go func(container *Container, registered bool) { + defer group.Done() + + if !registered { + // Try to set the default name for a container if it exists prior to links + container.Name, err = daemon.generateNewName(container.ID) + if err != nil { + logrus.Debugf("Setting default id - %s", err) + } + } + + if err := daemon.Register(container); err != nil { + logrus.Errorf("Failed to register container %s: %s", container.ID, err) + // The container register failed should not be started. + return + } + + // check the restart policy on the containers and restart any container with + // the restart policy of "always" + if daemon.configStore.AutoRestart && container.shouldRestart() { + logrus.Debugf("Starting container %s", container.ID) + + if err := container.Start(); err != nil { + logrus.Errorf("Failed to start container %s: %s", container.ID, err) + } + } + }(c.container, c.registered) + } + group.Wait() + + if !debug { + if logrus.GetLevel() == logrus.InfoLevel { + fmt.Println() + } + logrus.Info("Loading containers: done.") + } + + return nil +} + +func (daemon *Daemon) mergeAndVerifyConfig(config *runconfig.Config, img *image.Image) error { + if img != nil && img.Config != nil { + if err := runconfig.Merge(config, img.Config); err != nil { + return err + } + } + if config.Entrypoint.Len() == 0 && config.Cmd.Len() == 0 { + return fmt.Errorf("No command specified") + } + return nil +} + +func (daemon *Daemon) generateIDAndName(name string) (string, string, error) { + var ( + err error + id = stringid.GenerateNonCryptoID() + ) + + if name == "" { + if name, err = daemon.generateNewName(id); err != nil { + return "", "", err + } + return id, name, nil + } + + if name, err = daemon.reserveName(id, name); err != nil { + return "", "", err + } + + return id, name, nil +} + +func (daemon *Daemon) reserveName(id, name string) (string, error) { + if !validContainerNamePattern.MatchString(name) { + return "", fmt.Errorf("Invalid container name (%s), only %s are allowed", name, validContainerNameChars) + } + + if name[0] != '/' { + name = "/" + name + } + + if _, err := daemon.containerGraphDB.Set(name, id); err != nil { + if !graphdb.IsNonUniqueNameError(err) { + return "", err + } + + conflictingContainer, err := daemon.GetByName(name) + if err != nil { + return "", err + } + return "", fmt.Errorf( + "Conflict. The name %q is already in use by container %s. You have to remove (or rename) that container to be able to reuse that name.", strings.TrimPrefix(name, "/"), + stringid.TruncateID(conflictingContainer.ID)) + + } + return name, nil +} + +func (daemon *Daemon) generateNewName(id string) (string, error) { + var name string + for i := 0; i < 6; i++ { + name = namesgenerator.GetRandomName(i) + if name[0] != '/' { + name = "/" + name + } + + if _, err := daemon.containerGraphDB.Set(name, id); err != nil { + if !graphdb.IsNonUniqueNameError(err) { + return "", err + } + continue + } + return name, nil + } + + name = "/" + stringid.TruncateID(id) + if _, err := daemon.containerGraphDB.Set(name, id); err != nil { + return "", err + } + return name, nil +} + +func (daemon *Daemon) generateHostname(id string, config *runconfig.Config) { + // Generate default hostname + // FIXME: the lxc template no longer needs to set a default hostname + if config.Hostname == "" { + config.Hostname = id[:12] + } +} + +func (daemon *Daemon) getEntrypointAndArgs(configEntrypoint *stringutils.StrSlice, configCmd *stringutils.StrSlice) (string, []string) { + var ( + entrypoint string + args []string + ) + + cmdSlice := configCmd.Slice() + if configEntrypoint.Len() != 0 { + eSlice := configEntrypoint.Slice() + entrypoint = eSlice[0] + args = append(eSlice[1:], cmdSlice...) + } else { + entrypoint = cmdSlice[0] + args = cmdSlice[1:] + } + return entrypoint, args +} + +func (daemon *Daemon) newContainer(name string, config *runconfig.Config, imgID string) (*Container, error) { + var ( + id string + err error + noExplicitName = name == "" + ) + id, name, err = daemon.generateIDAndName(name) + if err != nil { + return nil, err + } + + daemon.generateHostname(id, config) + entrypoint, args := daemon.getEntrypointAndArgs(config.Entrypoint, config.Cmd) + + base := daemon.newBaseContainer(id) + base.Created = time.Now().UTC() + base.Path = entrypoint + base.Args = args //FIXME: de-duplicate from config + base.Config = config + base.hostConfig = &runconfig.HostConfig{} + base.ImageID = imgID + base.NetworkSettings = &network.Settings{IsAnonymousEndpoint: noExplicitName} + base.Name = name + base.Driver = daemon.driver.String() + base.ExecDriver = daemon.execDriver.Name() + + return &base, err +} + +// GetFullContainerName returns a constructed container name. I think +// it has to do with the fact that a container is a file on disk and +// this is sort of just creating a file name. +func GetFullContainerName(name string) (string, error) { + if name == "" { + return "", fmt.Errorf("Container name cannot be empty") + } + if name[0] != '/' { + name = "/" + name + } + return name, nil +} + +// GetByName returns a container given a name. +func (daemon *Daemon) GetByName(name string) (*Container, error) { + fullName, err := GetFullContainerName(name) + if err != nil { + return nil, err + } + entity := daemon.containerGraphDB.Get(fullName) + if entity == nil { + return nil, fmt.Errorf("Could not find entity for %s", name) + } + e := daemon.containers.Get(entity.ID()) + if e == nil { + return nil, fmt.Errorf("Could not find container for entity id %s", entity.ID()) + } + return e, nil +} + +// GetEventFilter returns a filters.Filter for a set of filters +func (daemon *Daemon) GetEventFilter(filter filters.Args) *events.Filter { + // incoming container filter can be name, id or partial id, convert to + // a full container id + for i, cn := range filter["container"] { + c, err := daemon.Get(cn) + if err != nil { + filter["container"][i] = "" + } else { + filter["container"][i] = c.ID + } + } + return events.NewFilter(filter, daemon.GetLabels) +} + +// GetLabels for a container or image id +func (daemon *Daemon) GetLabels(id string) map[string]string { + // TODO: TestCase + container := daemon.containers.Get(id) + if container != nil { + return container.Config.Labels + } + + img, err := daemon.repositories.LookupImage(id) + if err == nil { + return img.ContainerConfig.Labels + } + return nil +} + +// children returns all child containers of the container with the +// given name. The containers are returned as a map from the container +// name to a pointer to Container. +func (daemon *Daemon) children(name string) (map[string]*Container, error) { + name, err := GetFullContainerName(name) + if err != nil { + return nil, err + } + children := make(map[string]*Container) + + err = daemon.containerGraphDB.Walk(name, func(p string, e *graphdb.Entity) error { + c, err := daemon.Get(e.ID()) + if err != nil { + return err + } + children[p] = c + return nil + }, 0) + + if err != nil { + return nil, err + } + return children, nil +} + +// parents returns the names of the parent containers of the container +// with the given name. +func (daemon *Daemon) parents(name string) ([]string, error) { + name, err := GetFullContainerName(name) + if err != nil { + return nil, err + } + + return daemon.containerGraphDB.Parents(name) +} + +func (daemon *Daemon) registerLink(parent, child *Container, alias string) error { + fullName := filepath.Join(parent.Name, alias) + if !daemon.containerGraphDB.Exists(fullName) { + _, err := daemon.containerGraphDB.Set(fullName, child.ID) + return err + } + return nil +} + +// NewDaemon sets up everything for the daemon to be able to service +// requests from the webserver. +func NewDaemon(config *Config, registryService *registry.Service) (daemon *Daemon, err error) { + setDefaultMtu(config) + + // Ensure we have compatible configuration options + if err := checkConfigOptions(config); err != nil { + return nil, err + } + + // Do we have a disabled network? + config.DisableBridge = isBridgeNetworkDisabled(config) + + // Verify the platform is supported as a daemon + if !platformSupported { + return nil, errSystemNotSupported + } + + // Validate platform-specific requirements + if err := checkSystem(); err != nil { + return nil, err + } + + // set up SIGUSR1 handler on Unix-like systems, or a Win32 global event + // on Windows to dump Go routine stacks + setupDumpStackTrap() + + uidMaps, gidMaps, err := setupRemappedRoot(config) + if err != nil { + return nil, err + } + rootUID, rootGID, err := idtools.GetRootUIDGID(uidMaps, gidMaps) + if err != nil { + return nil, err + } + + // get the canonical path to the Docker root directory + var realRoot string + if _, err := os.Stat(config.Root); err != nil && os.IsNotExist(err) { + realRoot = config.Root + } else { + realRoot, err = fileutils.ReadSymlinkedDirectory(config.Root) + if err != nil { + return nil, fmt.Errorf("Unable to get the full path to root (%s): %s", config.Root, err) + } + } + + if err = setupDaemonRoot(config, realRoot, rootUID, rootGID); err != nil { + return nil, err + } + + // set up the tmpDir to use a canonical path + tmp, err := tempDir(config.Root, rootUID, rootGID) + if err != nil { + return nil, fmt.Errorf("Unable to get the TempDir under %s: %s", config.Root, err) + } + realTmp, err := fileutils.ReadSymlinkedDirectory(tmp) + if err != nil { + return nil, fmt.Errorf("Unable to get the full path to the TempDir (%s): %s", tmp, err) + } + os.Setenv("TMPDIR", realTmp) + + // Set the default driver + graphdriver.DefaultDriver = config.GraphDriver + + // Load storage driver + driver, err := graphdriver.New(config.Root, config.GraphOptions, uidMaps, gidMaps) + if err != nil { + return nil, fmt.Errorf("error initializing graphdriver: %v", err) + } + logrus.Debugf("Using graph driver %s", driver) + + d := &Daemon{} + d.driver = driver + + // Ensure the graph driver is shutdown at a later point + defer func() { + if err != nil { + if err := d.Shutdown(); err != nil { + logrus.Error(err) + } + } + }() + + // Verify logging driver type + if config.LogConfig.Type != "none" { + if _, err := logger.GetLogDriver(config.LogConfig.Type); err != nil { + return nil, fmt.Errorf("error finding the logging driver: %v", err) + } + } + logrus.Debugf("Using default logging driver %s", config.LogConfig.Type) + + // Configure and validate the kernels security support + if err := configureKernelSecuritySupport(config, d.driver.String()); err != nil { + return nil, err + } + + daemonRepo := filepath.Join(config.Root, "containers") + + if err := idtools.MkdirAllAs(daemonRepo, 0700, rootUID, rootGID); err != nil && !os.IsExist(err) { + return nil, err + } + + // Migrate the container if it is aufs and aufs is enabled + if err := migrateIfDownlevel(d.driver, config.Root); err != nil { + return nil, err + } + + logrus.Debug("Creating images graph") + g, err := graph.NewGraph(filepath.Join(config.Root, "graph"), d.driver, uidMaps, gidMaps) + if err != nil { + return nil, err + } + + // Configure the volumes driver + volStore, err := configureVolumes(config, rootUID, rootGID) + if err != nil { + return nil, err + } + + trustKey, err := api.LoadOrCreateTrustKey(config.TrustKeyPath) + if err != nil { + return nil, err + } + + trustDir := filepath.Join(config.Root, "trust") + + if err := system.MkdirAll(trustDir, 0700); err != nil { + return nil, err + } + + eventsService := events.New() + logrus.Debug("Creating repository list") + tagCfg := &graph.TagStoreConfig{ + Graph: g, + Key: trustKey, + Registry: registryService, + Events: eventsService, + } + repositories, err := graph.NewTagStore(filepath.Join(config.Root, "repositories-"+d.driver.String()), tagCfg) + if err != nil { + return nil, fmt.Errorf("Couldn't create Tag store repositories-%s: %s", d.driver.String(), err) + } + + if restorer, ok := d.driver.(graphdriver.ImageRestorer); ok { + if _, err := restorer.RestoreCustomImages(repositories, g); err != nil { + return nil, fmt.Errorf("Couldn't restore custom images: %s", err) + } + } + + // Discovery is only enabled when the daemon is launched with an address to advertise. When + // initialized, the daemon is registered and we can store the discovery backend as its read-only + // DiscoveryWatcher version. + if config.ClusterStore != "" && config.ClusterAdvertise != "" { + advertise, err := discovery.ParseAdvertise(config.ClusterStore, config.ClusterAdvertise) + if err != nil { + return nil, fmt.Errorf("discovery advertise parsing failed (%v)", err) + } + config.ClusterAdvertise = advertise + d.discoveryWatcher, err = initDiscovery(config.ClusterStore, config.ClusterAdvertise, config.ClusterOpts) + if err != nil { + return nil, fmt.Errorf("discovery initialization failed (%v)", err) + } + } else if config.ClusterAdvertise != "" { + return nil, fmt.Errorf("invalid cluster configuration. --cluster-advertise must be accompanied by --cluster-store configuration") + } + + d.netController, err = d.initNetworkController(config) + if err != nil { + return nil, fmt.Errorf("Error initializing network controller: %v", err) + } + + graphdbPath := filepath.Join(config.Root, "linkgraph.db") + graph, err := graphdb.NewSqliteConn(graphdbPath) + if err != nil { + return nil, err + } + + d.containerGraphDB = graph + + var sysInitPath string + if config.ExecDriver == "lxc" { + initPath, err := configureSysInit(config, rootUID, rootGID) + if err != nil { + return nil, err + } + sysInitPath = initPath + } + + sysInfo := sysinfo.New(false) + // Check if Devices cgroup is mounted, it is hard requirement for container security, + // on Linux/FreeBSD. + if runtime.GOOS != "windows" && !sysInfo.CgroupDevicesEnabled { + return nil, fmt.Errorf("Devices cgroup isn't mounted") + } + + ed, err := execdrivers.NewDriver(config.ExecDriver, config.ExecOptions, config.ExecRoot, config.Root, sysInitPath, sysInfo) + if err != nil { + return nil, err + } + + d.ID = trustKey.PublicKey().KeyID() + d.repository = daemonRepo + d.containers = &contStore{s: make(map[string]*Container)} + d.execCommands = newExecStore() + d.graph = g + d.repositories = repositories + d.idIndex = truncindex.NewTruncIndex([]string{}) + d.configStore = config + d.sysInitPath = sysInitPath + d.execDriver = ed + d.statsCollector = newStatsCollector(1 * time.Second) + d.defaultLogConfig = config.LogConfig + d.RegistryService = registryService + d.EventsService = eventsService + d.volumes = volStore + d.root = config.Root + d.uidMaps = uidMaps + d.gidMaps = gidMaps + + if err := d.cleanupMounts(); err != nil { + return nil, err + } + + go d.execCommandGC() + + if err := d.restore(); err != nil { + return nil, err + } + + return d, nil +} + +// Shutdown stops the daemon. +func (daemon *Daemon) Shutdown() error { + daemon.shutdown = true + if daemon.containers != nil { + group := sync.WaitGroup{} + logrus.Debug("starting clean shutdown of all containers...") + for _, container := range daemon.List() { + c := container + if c.IsRunning() { + logrus.Debugf("stopping %s", c.ID) + group.Add(1) + + go func() { + defer group.Done() + // TODO(windows): Handle docker restart with paused containers + if c.isPaused() { + // To terminate a process in freezer cgroup, we should send + // SIGTERM to this process then unfreeze it, and the process will + // force to terminate immediately. + logrus.Debugf("Found container %s is paused, sending SIGTERM before unpause it", c.ID) + sig, ok := signal.SignalMap["TERM"] + if !ok { + logrus.Warnf("System does not support SIGTERM") + return + } + if err := daemon.kill(c, int(sig)); err != nil { + logrus.Debugf("sending SIGTERM to container %s with error: %v", c.ID, err) + return + } + if err := c.unpause(); err != nil { + logrus.Debugf("Failed to unpause container %s with error: %v", c.ID, err) + return + } + if _, err := c.WaitStop(10 * time.Second); err != nil { + logrus.Debugf("container %s failed to exit in 10 second of SIGTERM, sending SIGKILL to force", c.ID) + sig, ok := signal.SignalMap["KILL"] + if !ok { + logrus.Warnf("System does not support SIGKILL") + return + } + daemon.kill(c, int(sig)) + } + } else { + // If container failed to exit in 10 seconds of SIGTERM, then using the force + if err := c.Stop(10); err != nil { + logrus.Errorf("Stop container %s with error: %v", c.ID, err) + } + } + c.WaitStop(-1 * time.Second) + logrus.Debugf("container stopped %s", c.ID) + }() + } + } + group.Wait() + + // trigger libnetwork Stop only if it's initialized + if daemon.netController != nil { + daemon.netController.Stop() + } + } + + if daemon.containerGraphDB != nil { + if err := daemon.containerGraphDB.Close(); err != nil { + logrus.Errorf("Error during container graph.Close(): %v", err) + } + } + + if daemon.driver != nil { + if err := daemon.driver.Cleanup(); err != nil { + logrus.Errorf("Error during graph storage driver.Cleanup(): %v", err) + } + } + + if err := daemon.cleanupMounts(); err != nil { + return err + } + + return nil +} + +// Mount sets container.basefs +// (is it not set coming in? why is it unset?) +func (daemon *Daemon) Mount(container *Container) error { + dir, err := daemon.driver.Get(container.ID, container.getMountLabel()) + if err != nil { + return fmt.Errorf("Error getting container %s from driver %s: %s", container.ID, daemon.driver, err) + } + + if container.basefs != dir { + // The mount path reported by the graph driver should always be trusted on Windows, since the + // volume path for a given mounted layer may change over time. This should only be an error + // on non-Windows operating systems. + if container.basefs != "" && runtime.GOOS != "windows" { + daemon.driver.Put(container.ID) + return fmt.Errorf("Error: driver %s is returning inconsistent paths for container %s ('%s' then '%s')", + daemon.driver, container.ID, container.basefs, dir) + } + } + container.basefs = dir + return nil +} + +func (daemon *Daemon) unmount(container *Container) error { + daemon.driver.Put(container.ID) + return nil +} + +func (daemon *Daemon) run(c *Container, pipes *execdriver.Pipes, startCallback execdriver.DriverCallback) (execdriver.ExitStatus, error) { + hooks := execdriver.Hooks{ + Start: startCallback, + } + hooks.PreStart = append(hooks.PreStart, func(processConfig *execdriver.ProcessConfig, pid int, chOOM <-chan struct{}) error { + return c.setNetworkNamespaceKey(pid) + }) + return daemon.execDriver.Run(c.command, pipes, hooks) +} + +func (daemon *Daemon) kill(c *Container, sig int) error { + return daemon.execDriver.Kill(c.command, sig) +} + +func (daemon *Daemon) stats(c *Container) (*execdriver.ResourceStats, error) { + return daemon.execDriver.Stats(c.ID) +} + +func (daemon *Daemon) subscribeToContainerStats(c *Container) (chan interface{}, error) { + ch := daemon.statsCollector.collect(c) + return ch, nil +} + +func (daemon *Daemon) unsubscribeToContainerStats(c *Container, ch chan interface{}) error { + daemon.statsCollector.unsubscribe(c, ch) + return nil +} + +func (daemon *Daemon) changes(container *Container) ([]archive.Change, error) { + initID := fmt.Sprintf("%s-init", container.ID) + return daemon.driver.Changes(container.ID, initID) +} + +func (daemon *Daemon) diff(container *Container) (archive.Archive, error) { + initID := fmt.Sprintf("%s-init", container.ID) + return daemon.driver.Diff(container.ID, initID) +} + +func (daemon *Daemon) createRootfs(container *Container) error { + // Step 1: create the container directory. + // This doubles as a barrier to avoid race conditions. + rootUID, rootGID, err := idtools.GetRootUIDGID(daemon.uidMaps, daemon.gidMaps) + if err != nil { + return err + } + if err := idtools.MkdirAs(container.root, 0700, rootUID, rootGID); err != nil { + return err + } + initID := fmt.Sprintf("%s-init", container.ID) + if err := daemon.driver.Create(initID, container.ImageID); err != nil { + return err + } + initPath, err := daemon.driver.Get(initID, "") + if err != nil { + return err + } + + if err := setupInitLayer(initPath, rootUID, rootGID); err != nil { + daemon.driver.Put(initID) + return err + } + + // We want to unmount init layer before we take snapshot of it + // for the actual container. + daemon.driver.Put(initID) + + if err := daemon.driver.Create(container.ID, initID); err != nil { + return err + } + return nil +} + +// Graph needs to be removed. +// +// FIXME: this is a convenience function for integration tests +// which need direct access to daemon.graph. +// Once the tests switch to using engine and jobs, this method +// can go away. +func (daemon *Daemon) Graph() *graph.Graph { + return daemon.graph +} + +// TagImage creates a tag in the repository reponame, pointing to the image named +// imageName. If force is true, an existing tag with the same name may be +// overwritten. +func (daemon *Daemon) TagImage(repoName, tag, imageName string, force bool) error { + return daemon.repositories.Tag(repoName, tag, imageName, force) +} + +// PullImage initiates a pull operation. image is the repository name to pull, and +// tag may be either empty, or indicate a specific tag to pull. +func (daemon *Daemon) PullImage(image string, tag string, imagePullConfig *graph.ImagePullConfig) error { + return daemon.repositories.Pull(image, tag, imagePullConfig) +} + +// ImportImage imports an image, getting the archived layer data either from +// inConfig (if src is "-"), or from a URI specified in src. Progress output is +// written to outStream. Repository and tag names can optionally be given in +// the repo and tag arguments, respectively. +func (daemon *Daemon) ImportImage(src, repo, tag, msg string, inConfig io.ReadCloser, outStream io.Writer, containerConfig *runconfig.Config) error { + return daemon.repositories.Import(src, repo, tag, msg, inConfig, outStream, containerConfig) +} + +// ExportImage exports a list of images to the given output stream. The +// exported images are archived into a tar when written to the output +// stream. All images with the given tag and all versions containing +// the same tag are exported. names is the set of tags to export, and +// outStream is the writer which the images are written to. +func (daemon *Daemon) ExportImage(names []string, outStream io.Writer) error { + return daemon.repositories.ImageExport(names, outStream) +} + +// PushImage initiates a push operation on the repository named localName. +func (daemon *Daemon) PushImage(localName string, imagePushConfig *graph.ImagePushConfig) error { + return daemon.repositories.Push(localName, imagePushConfig) +} + +// LookupImage looks up an image by name and returns it as an ImageInspect +// structure. +func (daemon *Daemon) LookupImage(name string) (*types.ImageInspect, error) { + return daemon.repositories.Lookup(name) +} + +// LoadImage uploads a set of images into the repository. This is the +// complement of ImageExport. The input stream is an uncompressed tar +// ball containing images and metadata. +func (daemon *Daemon) LoadImage(inTar io.ReadCloser, outStream io.Writer) error { + return daemon.repositories.Load(inTar, outStream) +} + +// ListImages returns a filtered list of images. filterArgs is a JSON-encoded set +// of filter arguments which will be interpreted by pkg/parsers/filters. +// filter is a shell glob string applied to repository names. The argument +// named all controls whether all images in the graph are filtered, or just +// the heads. +func (daemon *Daemon) ListImages(filterArgs, filter string, all bool) ([]*types.Image, error) { + return daemon.repositories.Images(filterArgs, filter, all) +} + +// ImageHistory returns a slice of ImageHistory structures for the specified image +// name by walking the image lineage. +func (daemon *Daemon) ImageHistory(name string) ([]*types.ImageHistory, error) { + return daemon.repositories.History(name) +} + +// GetImage returns pointer to an Image struct corresponding to the given +// name. The name can include an optional tag; otherwise the default tag will +// be used. +func (daemon *Daemon) GetImage(name string) (*image.Image, error) { + return daemon.repositories.LookupImage(name) +} + +func (daemon *Daemon) config() *Config { + return daemon.configStore +} + +func (daemon *Daemon) systemInitPath() string { + return daemon.sysInitPath +} + +// GraphDriver returns the currently used driver for processing +// container layers. +func (daemon *Daemon) GraphDriver() graphdriver.Driver { + return daemon.driver +} + +// ExecutionDriver returns the currently used driver for creating and +// starting execs in a container. +func (daemon *Daemon) ExecutionDriver() execdriver.Driver { + return daemon.execDriver +} + +func (daemon *Daemon) containerGraph() *graphdb.Database { + return daemon.containerGraphDB +} + +// GetUIDGIDMaps returns the current daemon's user namespace settings +// for the full uid and gid maps which will be applied to containers +// started in this instance. +func (daemon *Daemon) GetUIDGIDMaps() ([]idtools.IDMap, []idtools.IDMap) { + return daemon.uidMaps, daemon.gidMaps +} + +// GetRemappedUIDGID returns the current daemon's uid and gid values +// if user namespaces are in use for this daemon instance. If not +// this function will return "real" root values of 0, 0. +func (daemon *Daemon) GetRemappedUIDGID() (int, int) { + uid, gid, _ := idtools.GetRootUIDGID(daemon.uidMaps, daemon.gidMaps) + return uid, gid +} + +// ImageGetCached returns the earliest created image that is a child +// of the image with imgID, that had the same config when it was +// created. nil is returned if a child cannot be found. An error is +// returned if the parent image cannot be found. +func (daemon *Daemon) ImageGetCached(imgID string, config *runconfig.Config) (*image.Image, error) { + // for now just exit if imgID has no children. + // maybe parentRefs in graph could be used to store + // the Image obj children for faster lookup below but this can + // be quite memory hungry. + if !daemon.Graph().HasChildren(imgID) { + return nil, nil + } + + // Retrieve all images + images := daemon.Graph().Map() + + // Store the tree in a map of map (map[parentId][childId]) + imageMap := make(map[string]map[string]struct{}) + for _, img := range images { + if _, exists := imageMap[img.Parent]; !exists { + imageMap[img.Parent] = make(map[string]struct{}) + } + imageMap[img.Parent][img.ID] = struct{}{} + } + + // Loop on the children of the given image and check the config + var match *image.Image + for elem := range imageMap[imgID] { + img, ok := images[elem] + if !ok { + return nil, fmt.Errorf("unable to find image %q", elem) + } + if runconfig.Compare(&img.ContainerConfig, config) { + if match == nil || match.Created.Before(img.Created) { + match = img + } + } + } + return match, nil +} + +// tempDir returns the default directory to use for temporary files. +func tempDir(rootDir string, rootUID, rootGID int) (string, error) { + var tmpDir string + if tmpDir = os.Getenv("DOCKER_TMPDIR"); tmpDir == "" { + tmpDir = filepath.Join(rootDir, "tmp") + } + return tmpDir, idtools.MkdirAllAs(tmpDir, 0700, rootUID, rootGID) +} + +func (daemon *Daemon) setHostConfig(container *Container, hostConfig *runconfig.HostConfig) error { + container.Lock() + if err := parseSecurityOpt(container, hostConfig); err != nil { + container.Unlock() + return err + } + container.Unlock() + + // Do not lock while creating volumes since this could be calling out to external plugins + // Don't want to block other actions, like `docker ps` because we're waiting on an external plugin + if err := daemon.registerMountPoints(container, hostConfig); err != nil { + return err + } + + container.Lock() + defer container.Unlock() + // Register any links from the host config before starting the container + if err := daemon.registerLinks(container, hostConfig); err != nil { + return err + } + + container.hostConfig = hostConfig + container.toDisk() + return nil +} + +func setDefaultMtu(config *Config) { + // do nothing if the config does not have the default 0 value. + if config.Mtu != 0 { + return + } + config.Mtu = defaultNetworkMtu + if routeMtu, err := getDefaultRouteMtu(); err == nil { + config.Mtu = routeMtu + } +} + +var errNoDefaultRoute = errors.New("no default route was found") + +// verifyContainerSettings performs validation of the hostconfig and config +// structures. +func (daemon *Daemon) verifyContainerSettings(hostConfig *runconfig.HostConfig, config *runconfig.Config) ([]string, error) { + + // First perform verification of settings common across all platforms. + if config != nil { + if config.WorkingDir != "" { + config.WorkingDir = filepath.FromSlash(config.WorkingDir) // Ensure in platform semantics + if !system.IsAbs(config.WorkingDir) { + return nil, fmt.Errorf("The working directory '%s' is invalid. It needs to be an absolute path.", config.WorkingDir) + } + } + + if len(config.StopSignal) > 0 { + _, err := signal.ParseSignal(config.StopSignal) + if err != nil { + return nil, err + } + } + } + + if hostConfig == nil { + return nil, nil + } + + for port := range hostConfig.PortBindings { + _, portStr := nat.SplitProtoPort(string(port)) + if _, err := nat.ParsePort(portStr); err != nil { + return nil, fmt.Errorf("Invalid port specification: %q", portStr) + } + for _, pb := range hostConfig.PortBindings[port] { + _, err := nat.NewPort(nat.SplitProtoPort(pb.HostPort)) + if err != nil { + return nil, fmt.Errorf("Invalid port specification: %q", pb.HostPort) + } + } + } + + // Now do platform-specific verification + return verifyPlatformContainerSettings(daemon, hostConfig, config) +} + +func configureVolumes(config *Config, rootUID, rootGID int) (*store.VolumeStore, error) { + volumesDriver, err := local.New(config.Root, rootUID, rootGID) + if err != nil { + return nil, err + } + + volumedrivers.Register(volumesDriver, volumesDriver.Name()) + s := store.New() + s.AddAll(volumesDriver.List()) + + return s, nil +} + +// AuthenticateToRegistry checks the validity of credentials in authConfig +func (daemon *Daemon) AuthenticateToRegistry(authConfig *cliconfig.AuthConfig) (string, error) { + return daemon.RegistryService.Auth(authConfig) +} + +// SearchRegistryForImages queries the registry for images matching +// term. authConfig is used to login. +func (daemon *Daemon) SearchRegistryForImages(term string, + authConfig *cliconfig.AuthConfig, + headers map[string][]string) (*registry.SearchResults, error) { + return daemon.RegistryService.Search(term, authConfig, headers) +} diff --git a/daemon/daemon_aufs.go b/daemon/daemon_aufs.go new file mode 100644 index 0000000000..0848ea920f --- /dev/null +++ b/daemon/daemon_aufs.go @@ -0,0 +1,21 @@ +// +build !exclude_graphdriver_aufs,linux + +package daemon + +import ( + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/daemon/graphdriver/aufs" +) + +// Given the graphdriver ad, if it is aufs, then migrate it. +// If aufs driver is not built, this func is a noop. +func migrateIfAufs(driver graphdriver.Driver, root string) error { + if ad, ok := driver.(*aufs.Driver); ok { + logrus.Debugf("Migrating existing containers") + if err := ad.Migrate(root, setupInitLayer); err != nil { + return err + } + } + return nil +} diff --git a/daemon/daemon_btrfs.go b/daemon/daemon_btrfs.go new file mode 100644 index 0000000000..b15b37b9af --- /dev/null +++ b/daemon/daemon_btrfs.go @@ -0,0 +1,8 @@ +// +build !exclude_graphdriver_btrfs,linux + +package daemon + +import ( + // register the btrfs graphdriver + _ "github.com/docker/docker/daemon/graphdriver/btrfs" +) diff --git a/daemon/daemon_devicemapper.go b/daemon/daemon_devicemapper.go new file mode 100644 index 0000000000..b33b01a5f3 --- /dev/null +++ b/daemon/daemon_devicemapper.go @@ -0,0 +1,8 @@ +// +build !exclude_graphdriver_devicemapper,linux + +package daemon + +import ( + // register the devmapper graphdriver + _ "github.com/docker/docker/daemon/graphdriver/devmapper" +) diff --git a/daemon/daemon_experimental.go b/daemon/daemon_experimental.go new file mode 100644 index 0000000000..b65ad7a5b0 --- /dev/null +++ b/daemon/daemon_experimental.go @@ -0,0 +1,110 @@ +// +build experimental + +package daemon + +import ( + "fmt" + "os" + "path/filepath" + "runtime" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/directory" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/runconfig" +) + +func setupRemappedRoot(config *Config) ([]idtools.IDMap, []idtools.IDMap, error) { + if config.ExecDriver != "native" && config.RemappedRoot != "" { + return nil, nil, fmt.Errorf("User namespace remapping is only supported with the native execdriver") + } + if runtime.GOOS == "windows" && config.RemappedRoot != "" { + return nil, nil, fmt.Errorf("User namespaces are not supported on Windows") + } + + // if the daemon was started with remapped root option, parse + // the config option to the int uid,gid values + var ( + uidMaps, gidMaps []idtools.IDMap + ) + if config.RemappedRoot != "" { + username, groupname, err := parseRemappedRoot(config.RemappedRoot) + if err != nil { + return nil, nil, err + } + if username == "root" { + // Cannot setup user namespaces with a 1-to-1 mapping; "--root=0:0" is a no-op + // effectively + logrus.Warnf("User namespaces: root cannot be remapped with itself; user namespaces are OFF") + return uidMaps, gidMaps, nil + } + logrus.Infof("User namespaces: ID ranges will be mapped to subuid/subgid ranges of: %s:%s", username, groupname) + // update remapped root setting now that we have resolved them to actual names + config.RemappedRoot = fmt.Sprintf("%s:%s", username, groupname) + + uidMaps, gidMaps, err = idtools.CreateIDMappings(username, groupname) + if err != nil { + return nil, nil, fmt.Errorf("Can't create ID mappings: %v", err) + } + } + return uidMaps, gidMaps, nil +} + +func setupDaemonRoot(config *Config, rootDir string, rootUID, rootGID int) error { + // the main docker root needs to be accessible by all users, as user namespace support + // will create subdirectories owned by either a) the real system root (when no remapping + // is setup) or b) the remapped root host ID (when --root=uid:gid is used) + // for "first time" users of user namespaces, we need to migrate the current directory + // contents to the "0.0" (root == root "namespace" daemon root) + nsRoot := "0.0" + if _, err := os.Stat(rootDir); err == nil { + // root current exists; we need to check for a prior migration + if _, err := os.Stat(filepath.Join(rootDir, nsRoot)); err != nil && os.IsNotExist(err) { + // need to migrate current root to "0.0" subroot + // 1. create non-usernamespaced root as "0.0" + if err := os.Mkdir(filepath.Join(rootDir, nsRoot), 0700); err != nil { + return fmt.Errorf("Cannot create daemon root %q: %v", filepath.Join(rootDir, nsRoot), err) + } + // 2. move current root content to "0.0" new subroot + if err := directory.MoveToSubdir(rootDir, nsRoot); err != nil { + return fmt.Errorf("Cannot migrate current daemon root %q for user namespaces: %v", rootDir, err) + } + // 3. chmod outer root to 755 + if chmodErr := os.Chmod(rootDir, 0755); chmodErr != nil { + return chmodErr + } + } + } else if os.IsNotExist(err) { + // no root exists yet, create it 0755 with root:root ownership + if err := os.MkdirAll(rootDir, 0755); err != nil { + return err + } + // create the "0.0" subroot (so no future "migration" happens of the root) + if err := os.Mkdir(filepath.Join(rootDir, nsRoot), 0700); err != nil { + return err + } + } + + // for user namespaces we will create a subtree underneath the specified root + // with any/all specified remapped root uid/gid options on the daemon creating + // a new subdirectory with ownership set to the remapped uid/gid (so as to allow + // `chdir()` to work for containers namespaced to that uid/gid) + if config.RemappedRoot != "" { + nsRoot = fmt.Sprintf("%d.%d", rootUID, rootGID) + } + config.Root = filepath.Join(rootDir, nsRoot) + logrus.Debugf("Creating actual daemon root: %s", config.Root) + + // Create the root directory if it doesn't exists + if err := idtools.MkdirAllAs(config.Root, 0700, rootUID, rootGID); err != nil { + return fmt.Errorf("Cannot create daemon root: %s: %v", config.Root, err) + } + return nil +} + +func (daemon *Daemon) verifyExperimentalContainerSettings(hostConfig *runconfig.HostConfig, config *runconfig.Config) ([]string, error) { + if hostConfig.Privileged && daemon.config().RemappedRoot != "" { + return nil, fmt.Errorf("Privileged mode is incompatible with user namespace mappings") + } + return nil, nil +} diff --git a/daemon/daemon_linux.go b/daemon/daemon_linux.go new file mode 100644 index 0000000000..cda0e82e8c --- /dev/null +++ b/daemon/daemon_linux.go @@ -0,0 +1,60 @@ +package daemon + +import ( + "bufio" + "fmt" + "io" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/mount" +) + +// cleanupMounts umounts shm/mqueue mounts for old containers +func (daemon *Daemon) cleanupMounts() error { + logrus.Debugf("Cleaning up old shm/mqueue mounts: start.") + f, err := os.Open("/proc/self/mountinfo") + if err != nil { + return err + } + defer f.Close() + + return daemon.cleanupMountsFromReader(f, mount.Unmount) +} + +func (daemon *Daemon) cleanupMountsFromReader(reader io.Reader, unmount func(target string) error) error { + if daemon.repository == "" { + return nil + } + sc := bufio.NewScanner(reader) + var errors []string + for sc.Scan() { + line := sc.Text() + fields := strings.Fields(line) + if strings.HasPrefix(fields[4], daemon.repository) { + logrus.Debugf("Mount base: %v, repository %s", fields[4], daemon.repository) + mnt := fields[4] + mountBase := filepath.Base(mnt) + if mountBase == "mqueue" || mountBase == "shm" { + logrus.Debugf("Unmounting %v", mnt) + if err := unmount(mnt); err != nil { + logrus.Error(err) + errors = append(errors, err.Error()) + } + } + } + } + + if err := sc.Err(); err != nil { + return err + } + + if len(errors) > 0 { + return fmt.Errorf("Error cleaningup mounts:\n%v", strings.Join(errors, "\n")) + } + + logrus.Debugf("Cleaning up old shm/mqueue mounts: done.") + return nil +} diff --git a/daemon/daemon_linux_test.go b/daemon/daemon_linux_test.go new file mode 100644 index 0000000000..0439d0bcd7 --- /dev/null +++ b/daemon/daemon_linux_test.go @@ -0,0 +1,74 @@ +// +build linux + +package daemon + +import ( + "strings" + "testing" +) + +func TestCleanupMounts(t *testing.T) { + fixture := `230 138 0:60 / / rw,relatime - overlay overlay rw,lowerdir=/var/lib/docker/overlay/0ef9f93d5d365c1385b09d54bbee6afff3d92002c16f22eccb6e1549b2ff97d8/root,upperdir=/var/lib/docker/overlay/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb/upper,workdir=/var/lib/docker/overlay/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb/work +231 230 0:56 / /proc rw,nosuid,nodev,noexec,relatime - proc proc rw +232 230 0:57 / /dev rw,nosuid - tmpfs tmpfs rw,mode=755 +233 232 0:58 / /dev/pts rw,nosuid,noexec,relatime - devpts devpts rw,gid=5,mode=620,ptmxmode=666 +234 232 0:59 / /dev/shm rw,nosuid,nodev,noexec,relatime - tmpfs shm rw,size=65536k +235 232 0:55 / /dev/mqueue rw,nosuid,nodev,noexec,relatime - mqueue mqueue rw +236 230 0:61 / /sys rw,nosuid,nodev,noexec,relatime - sysfs sysfs rw +237 236 0:62 / /sys/fs/cgroup rw,nosuid,nodev,noexec,relatime - tmpfs tmpfs rw +238 237 0:21 /system.slice/docker.service /sys/fs/cgroup/systemd rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,xattr,release_agent=/lib/systemd/systemd-cgroups-agent,name=systemd +239 237 0:23 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/perf_event rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,perf_event +240 237 0:24 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/cpuset rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,cpuset,clone_children +241 237 0:25 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/devices rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,devices +242 237 0:26 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/freezer rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,freezer +243 237 0:27 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/cpu,cpuacct rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,cpu,cpuacct +244 237 0:28 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/blkio rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,blkio +245 237 0:29 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/net_cls,net_prio rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,net_cls,net_prio +246 237 0:30 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/hugetlb rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,hugetlb +247 237 0:31 /docker/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb /sys/fs/cgroup/memory rw,nosuid,nodev,noexec,relatime - cgroup cgroup rw,memory +248 230 253:1 /var/lib/docker/volumes/510cc41ac68c48bd4eac932e3e09711673876287abf1b185312cfbfe6261a111/_data /var/lib/docker rw,relatime - ext4 /dev/disk/by-uuid/ba70ea0c-1a8f-4ee4-9687-cb393730e2b5 rw,errors=remount-ro,data=ordered +250 230 253:1 /var/lib/docker/containers/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb/hostname /etc/hostname rw,relatime - ext4 /dev/disk/by-uuid/ba70ea0c-1a8f-4ee4-9687-cb393730e2b5 rw,errors=remount-ro,data=ordered +251 230 253:1 /var/lib/docker/containers/dfac036ce135a8914e292cb2f6fea114f7339983c186366aa26d0051e93162cb/hosts /etc/hosts rw,relatime - ext4 /dev/disk/by-uuid/ba70ea0c-1a8f-4ee4-9687-cb393730e2b5 rw,errors=remount-ro,data=ordered +252 232 0:13 /1 /dev/console rw,nosuid,noexec,relatime - devpts devpts rw,gid=5,mode=620,ptmxmode=000 +139 236 0:11 / /sys/kernel/security rw,relatime - securityfs none rw +140 230 0:54 / /tmp rw,relatime - tmpfs none rw +145 230 0:3 / /run/docker/netns/default rw - nsfs nsfs rw +130 140 0:45 / /tmp/docker_recursive_mount_test312125472/tmpfs rw,relatime - tmpfs tmpfs rw +131 230 0:3 / /run/docker/netns/47903e2e6701 rw - nsfs nsfs rw +133 230 0:55 / /go/src/github.com/docker/docker/bundles/1.9.0-dev/test-integration-cli/d45526097/graph/containers/47903e2e67014246eba27607809d5f5c2437c3bf84c2986393448f84093cc40b/mqueue rw,nosuid,nodev,noexec,relatime - mqueue mqueue rw` + + d := &Daemon{ + repository: "/go/src/github.com/docker/docker/bundles/1.9.0-dev/test-integration-cli/d45526097/graph/containers/", + } + + expected := "/go/src/github.com/docker/docker/bundles/1.9.0-dev/test-integration-cli/d45526097/graph/containers/47903e2e67014246eba27607809d5f5c2437c3bf84c2986393448f84093cc40b/mqueue" + var unmounted bool + unmount := func(target string) error { + if target == expected { + unmounted = true + } + return nil + } + + d.cleanupMountsFromReader(strings.NewReader(fixture), unmount) + + if !unmounted { + t.Fatalf("Expected to unmount the mqueue") + } +} + +func TestNotCleanupMounts(t *testing.T) { + d := &Daemon{ + repository: "", + } + var unmounted bool + unmount := func(target string) error { + unmounted = true + return nil + } + mountInfo := `234 232 0:59 / /dev/shm rw,nosuid,nodev,noexec,relatime - tmpfs shm rw,size=65536k` + d.cleanupMountsFromReader(strings.NewReader(mountInfo), unmount) + if unmounted { + t.Fatalf("Expected not to clean up /dev/shm") + } +} diff --git a/daemon/daemon_no_aufs.go b/daemon/daemon_no_aufs.go new file mode 100644 index 0000000000..a74f775336 --- /dev/null +++ b/daemon/daemon_no_aufs.go @@ -0,0 +1,11 @@ +// +build exclude_graphdriver_aufs,linux freebsd + +package daemon + +import ( + "github.com/docker/docker/daemon/graphdriver" +) + +func migrateIfAufs(driver graphdriver.Driver, root string) error { + return nil +} diff --git a/daemon/daemon_overlay.go b/daemon/daemon_overlay.go new file mode 100644 index 0000000000..3c97db13a4 --- /dev/null +++ b/daemon/daemon_overlay.go @@ -0,0 +1,8 @@ +// +build !exclude_graphdriver_overlay,linux + +package daemon + +import ( + // register the overlay graphdriver + _ "github.com/docker/docker/daemon/graphdriver/overlay" +) diff --git a/daemon/daemon_stub.go b/daemon/daemon_stub.go new file mode 100644 index 0000000000..8fbb0508e9 --- /dev/null +++ b/daemon/daemon_stub.go @@ -0,0 +1,28 @@ +// +build !experimental + +package daemon + +import ( + "os" + + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/runconfig" +) + +func setupRemappedRoot(config *Config) ([]idtools.IDMap, []idtools.IDMap, error) { + return nil, nil, nil +} + +func setupDaemonRoot(config *Config, rootDir string, rootUID, rootGID int) error { + config.Root = rootDir + // Create the root directory if it doesn't exists + if err := system.MkdirAll(config.Root, 0700); err != nil && !os.IsExist(err) { + return err + } + return nil +} + +func (daemon *Daemon) verifyExperimentalContainerSettings(hostConfig *runconfig.HostConfig, config *runconfig.Config) ([]string, error) { + return nil, nil +} diff --git a/daemon/daemon_test.go b/daemon/daemon_test.go new file mode 100644 index 0000000000..eb353337d0 --- /dev/null +++ b/daemon/daemon_test.go @@ -0,0 +1,576 @@ +package daemon + +import ( + "fmt" + "io/ioutil" + "os" + "path" + "path/filepath" + "testing" + + "github.com/docker/docker/pkg/graphdb" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/truncindex" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/volume" + volumedrivers "github.com/docker/docker/volume/drivers" + "github.com/docker/docker/volume/local" + "github.com/docker/docker/volume/store" +) + +// +// https://github.com/docker/docker/issues/8069 +// + +func TestGet(t *testing.T) { + c1 := &Container{ + CommonContainer: CommonContainer{ + ID: "5a4ff6a163ad4533d22d69a2b8960bf7fafdcba06e72d2febdba229008b0bf57", + Name: "tender_bardeen", + }, + } + + c2 := &Container{ + CommonContainer: CommonContainer{ + ID: "3cdbd1aa394fd68559fd1441d6eff2ab7c1e6363582c82febfaa8045df3bd8de", + Name: "drunk_hawking", + }, + } + + c3 := &Container{ + CommonContainer: CommonContainer{ + ID: "3cdbd1aa394fd68559fd1441d6eff2abfafdcba06e72d2febdba229008b0bf57", + Name: "3cdbd1aa", + }, + } + + c4 := &Container{ + CommonContainer: CommonContainer{ + ID: "75fb0b800922abdbef2d27e60abcdfaf7fb0698b2a96d22d3354da361a6ff4a5", + Name: "5a4ff6a163ad4533d22d69a2b8960bf7fafdcba06e72d2febdba229008b0bf57", + }, + } + + c5 := &Container{ + CommonContainer: CommonContainer{ + ID: "d22d69a2b8960bf7fafdcba06e72d2febdba960bf7fafdcba06e72d2f9008b060b", + Name: "d22d69a2b896", + }, + } + + store := &contStore{ + s: map[string]*Container{ + c1.ID: c1, + c2.ID: c2, + c3.ID: c3, + c4.ID: c4, + c5.ID: c5, + }, + } + + index := truncindex.NewTruncIndex([]string{}) + index.Add(c1.ID) + index.Add(c2.ID) + index.Add(c3.ID) + index.Add(c4.ID) + index.Add(c5.ID) + + daemonTestDbPath := path.Join(os.TempDir(), "daemon_test.db") + graph, err := graphdb.NewSqliteConn(daemonTestDbPath) + if err != nil { + t.Fatalf("Failed to create daemon test sqlite database at %s", daemonTestDbPath) + } + graph.Set(c1.Name, c1.ID) + graph.Set(c2.Name, c2.ID) + graph.Set(c3.Name, c3.ID) + graph.Set(c4.Name, c4.ID) + graph.Set(c5.Name, c5.ID) + + daemon := &Daemon{ + containers: store, + idIndex: index, + containerGraphDB: graph, + } + + if container, _ := daemon.Get("3cdbd1aa394fd68559fd1441d6eff2ab7c1e6363582c82febfaa8045df3bd8de"); container != c2 { + t.Fatal("Should explicitly match full container IDs") + } + + if container, _ := daemon.Get("75fb0b8009"); container != c4 { + t.Fatal("Should match a partial ID") + } + + if container, _ := daemon.Get("drunk_hawking"); container != c2 { + t.Fatal("Should match a full name") + } + + // c3.Name is a partial match for both c3.ID and c2.ID + if c, _ := daemon.Get("3cdbd1aa"); c != c3 { + t.Fatal("Should match a full name even though it collides with another container's ID") + } + + if container, _ := daemon.Get("d22d69a2b896"); container != c5 { + t.Fatal("Should match a container where the provided prefix is an exact match to the it's name, and is also a prefix for it's ID") + } + + if _, err := daemon.Get("3cdbd1"); err == nil { + t.Fatal("Should return an error when provided a prefix that partially matches multiple container ID's") + } + + if _, err := daemon.Get("nothing"); err == nil { + t.Fatal("Should return an error when provided a prefix that is neither a name or a partial match to an ID") + } + + os.Remove(daemonTestDbPath) +} + +func TestLoadWithVolume(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + containerID := "d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e" + containerPath := filepath.Join(tmp, containerID) + if err := os.MkdirAll(containerPath, 0755); err != nil { + t.Fatal(err) + } + + hostVolumeID := stringid.GenerateNonCryptoID() + vfsPath := filepath.Join(tmp, "vfs", "dir", hostVolumeID) + volumePath := filepath.Join(tmp, "volumes", hostVolumeID) + + if err := os.MkdirAll(vfsPath, 0755); err != nil { + t.Fatal(err) + } + if err := os.MkdirAll(volumePath, 0755); err != nil { + t.Fatal(err) + } + + content := filepath.Join(vfsPath, "helo") + if err := ioutil.WriteFile(content, []byte("HELO"), 0644); err != nil { + t.Fatal(err) + } + + config := `{"State":{"Running":true,"Paused":false,"Restarting":false,"OOMKilled":false,"Dead":false,"Pid":2464,"ExitCode":0, +"Error":"","StartedAt":"2015-05-26T16:48:53.869308965Z","FinishedAt":"0001-01-01T00:00:00Z"}, +"ID":"d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e","Created":"2015-05-26T16:48:53.7987917Z","Path":"top", +"Args":[],"Config":{"Hostname":"d59df5276e7b","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"Cpuset":"", +"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"PortSpecs":null,"ExposedPorts":null,"Tty":true,"OpenStdin":true, +"StdinOnce":false,"Env":null,"Cmd":["top"],"Image":"ubuntu:latest","Volumes":null,"WorkingDir":"","Entrypoint":null, +"NetworkDisabled":false,"MacAddress":"","OnBuild":null,"Labels":{}},"Image":"07f8e8c5e66084bef8f848877857537ffe1c47edd01a93af27e7161672ad0e95", +"NetworkSettings":{"IPAddress":"172.17.0.1","IPPrefixLen":16,"MacAddress":"02:42:ac:11:00:01","LinkLocalIPv6Address":"fe80::42:acff:fe11:1", +"LinkLocalIPv6PrefixLen":64,"GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"Gateway":"172.17.42.1","IPv6Gateway":"","Bridge":"docker0","Ports":{}}, +"ResolvConfPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/resolv.conf", +"HostnamePath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hostname", +"HostsPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hosts", +"LogPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e-json.log", +"Name":"/ubuntu","Driver":"aufs","ExecDriver":"native-0.2","MountLabel":"","ProcessLabel":"","AppArmorProfile":"","RestartCount":0, +"UpdateDns":false,"Volumes":{"/vol1":"%s"},"VolumesRW":{"/vol1":true},"AppliedVolumesFrom":null}` + + cfg := fmt.Sprintf(config, vfsPath) + if err = ioutil.WriteFile(filepath.Join(containerPath, "config.json"), []byte(cfg), 0644); err != nil { + t.Fatal(err) + } + + hostConfig := `{"Binds":[],"ContainerIDFile":"","LxcConf":[],"Memory":0,"MemorySwap":0,"CpuShares":0,"CpusetCpus":"", +"Privileged":false,"PortBindings":{},"Links":null,"PublishAllPorts":false,"Dns":null,"DnsOptions":null,"DnsSearch":null,"ExtraHosts":null,"VolumesFrom":null, +"Devices":[],"NetworkMode":"bridge","IpcMode":"","PidMode":"","CapAdd":null,"CapDrop":null,"RestartPolicy":{"Name":"no","MaximumRetryCount":0}, +"SecurityOpt":null,"ReadonlyRootfs":false,"Ulimits":null,"LogConfig":{"Type":"","Config":null},"CgroupParent":""}` + if err = ioutil.WriteFile(filepath.Join(containerPath, "hostconfig.json"), []byte(hostConfig), 0644); err != nil { + t.Fatal(err) + } + + daemon, err := initDaemonWithVolumeStore(tmp) + if err != nil { + t.Fatal(err) + } + defer volumedrivers.Unregister(volume.DefaultDriverName) + + c, err := daemon.load(containerID) + if err != nil { + t.Fatal(err) + } + + err = daemon.verifyVolumesInfo(c) + if err != nil { + t.Fatal(err) + } + + if len(c.MountPoints) != 1 { + t.Fatalf("Expected 1 volume mounted, was 0\n") + } + + m := c.MountPoints["/vol1"] + if m.Name != hostVolumeID { + t.Fatalf("Expected mount name to be %s, was %s\n", hostVolumeID, m.Name) + } + + if m.Destination != "/vol1" { + t.Fatalf("Expected mount destination /vol1, was %s\n", m.Destination) + } + + if !m.RW { + t.Fatalf("Expected mount point to be RW but it was not\n") + } + + if m.Driver != volume.DefaultDriverName { + t.Fatalf("Expected mount driver local, was %s\n", m.Driver) + } + + newVolumeContent := filepath.Join(volumePath, local.VolumeDataPathName, "helo") + b, err := ioutil.ReadFile(newVolumeContent) + if err != nil { + t.Fatal(err) + } + if string(b) != "HELO" { + t.Fatalf("Expected HELO, was %s\n", string(b)) + } +} + +func TestLoadWithBindMount(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + containerID := "d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e" + containerPath := filepath.Join(tmp, containerID) + if err = os.MkdirAll(containerPath, 0755); err != nil { + t.Fatal(err) + } + + config := `{"State":{"Running":true,"Paused":false,"Restarting":false,"OOMKilled":false,"Dead":false,"Pid":2464,"ExitCode":0, +"Error":"","StartedAt":"2015-05-26T16:48:53.869308965Z","FinishedAt":"0001-01-01T00:00:00Z"}, +"ID":"d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e","Created":"2015-05-26T16:48:53.7987917Z","Path":"top", +"Args":[],"Config":{"Hostname":"d59df5276e7b","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"Cpuset":"", +"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"PortSpecs":null,"ExposedPorts":null,"Tty":true,"OpenStdin":true, +"StdinOnce":false,"Env":null,"Cmd":["top"],"Image":"ubuntu:latest","Volumes":null,"WorkingDir":"","Entrypoint":null, +"NetworkDisabled":false,"MacAddress":"","OnBuild":null,"Labels":{}},"Image":"07f8e8c5e66084bef8f848877857537ffe1c47edd01a93af27e7161672ad0e95", +"NetworkSettings":{"IPAddress":"172.17.0.1","IPPrefixLen":16,"MacAddress":"02:42:ac:11:00:01","LinkLocalIPv6Address":"fe80::42:acff:fe11:1", +"LinkLocalIPv6PrefixLen":64,"GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"Gateway":"172.17.42.1","IPv6Gateway":"","Bridge":"docker0","Ports":{}}, +"ResolvConfPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/resolv.conf", +"HostnamePath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hostname", +"HostsPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hosts", +"LogPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e-json.log", +"Name":"/ubuntu","Driver":"aufs","ExecDriver":"native-0.2","MountLabel":"","ProcessLabel":"","AppArmorProfile":"","RestartCount":0, +"UpdateDns":false,"Volumes":{"/vol1": "/vol1"},"VolumesRW":{"/vol1":true},"AppliedVolumesFrom":null}` + + if err = ioutil.WriteFile(filepath.Join(containerPath, "config.json"), []byte(config), 0644); err != nil { + t.Fatal(err) + } + + hostConfig := `{"Binds":["/vol1:/vol1"],"ContainerIDFile":"","LxcConf":[],"Memory":0,"MemorySwap":0,"CpuShares":0,"CpusetCpus":"", +"Privileged":false,"PortBindings":{},"Links":null,"PublishAllPorts":false,"Dns":null,"DnsOptions":null,"DnsSearch":null,"ExtraHosts":null,"VolumesFrom":null, +"Devices":[],"NetworkMode":"bridge","IpcMode":"","PidMode":"","CapAdd":null,"CapDrop":null,"RestartPolicy":{"Name":"no","MaximumRetryCount":0}, +"SecurityOpt":null,"ReadonlyRootfs":false,"Ulimits":null,"LogConfig":{"Type":"","Config":null},"CgroupParent":""}` + if err = ioutil.WriteFile(filepath.Join(containerPath, "hostconfig.json"), []byte(hostConfig), 0644); err != nil { + t.Fatal(err) + } + + daemon, err := initDaemonWithVolumeStore(tmp) + if err != nil { + t.Fatal(err) + } + defer volumedrivers.Unregister(volume.DefaultDriverName) + + c, err := daemon.load(containerID) + if err != nil { + t.Fatal(err) + } + + err = daemon.verifyVolumesInfo(c) + if err != nil { + t.Fatal(err) + } + + if len(c.MountPoints) != 1 { + t.Fatalf("Expected 1 volume mounted, was 0\n") + } + + m := c.MountPoints["/vol1"] + if m.Name != "" { + t.Fatalf("Expected empty mount name, was %s\n", m.Name) + } + + if m.Source != "/vol1" { + t.Fatalf("Expected mount source /vol1, was %s\n", m.Source) + } + + if m.Destination != "/vol1" { + t.Fatalf("Expected mount destination /vol1, was %s\n", m.Destination) + } + + if !m.RW { + t.Fatalf("Expected mount point to be RW but it was not\n") + } +} + +func TestLoadWithVolume17RC(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + containerID := "d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e" + containerPath := filepath.Join(tmp, containerID) + if err := os.MkdirAll(containerPath, 0755); err != nil { + t.Fatal(err) + } + + hostVolumeID := "6a3c03fc4a4e588561a543cc3bdd50089e27bd11bbb0e551e19bf735e2514101" + volumePath := filepath.Join(tmp, "volumes", hostVolumeID) + + if err := os.MkdirAll(volumePath, 0755); err != nil { + t.Fatal(err) + } + + content := filepath.Join(volumePath, "helo") + if err := ioutil.WriteFile(content, []byte("HELO"), 0644); err != nil { + t.Fatal(err) + } + + config := `{"State":{"Running":true,"Paused":false,"Restarting":false,"OOMKilled":false,"Dead":false,"Pid":2464,"ExitCode":0, +"Error":"","StartedAt":"2015-05-26T16:48:53.869308965Z","FinishedAt":"0001-01-01T00:00:00Z"}, +"ID":"d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e","Created":"2015-05-26T16:48:53.7987917Z","Path":"top", +"Args":[],"Config":{"Hostname":"d59df5276e7b","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"Cpuset":"", +"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"PortSpecs":null,"ExposedPorts":null,"Tty":true,"OpenStdin":true, +"StdinOnce":false,"Env":null,"Cmd":["top"],"Image":"ubuntu:latest","Volumes":null,"WorkingDir":"","Entrypoint":null, +"NetworkDisabled":false,"MacAddress":"","OnBuild":null,"Labels":{}},"Image":"07f8e8c5e66084bef8f848877857537ffe1c47edd01a93af27e7161672ad0e95", +"NetworkSettings":{"IPAddress":"172.17.0.1","IPPrefixLen":16,"MacAddress":"02:42:ac:11:00:01","LinkLocalIPv6Address":"fe80::42:acff:fe11:1", +"LinkLocalIPv6PrefixLen":64,"GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"Gateway":"172.17.42.1","IPv6Gateway":"","Bridge":"docker0","Ports":{}}, +"ResolvConfPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/resolv.conf", +"HostnamePath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hostname", +"HostsPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hosts", +"LogPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e-json.log", +"Name":"/ubuntu","Driver":"aufs","ExecDriver":"native-0.2","MountLabel":"","ProcessLabel":"","AppArmorProfile":"","RestartCount":0, +"UpdateDns":false,"MountPoints":{"/vol1":{"Name":"6a3c03fc4a4e588561a543cc3bdd50089e27bd11bbb0e551e19bf735e2514101","Destination":"/vol1","Driver":"local","RW":true,"Source":"","Relabel":""}},"AppliedVolumesFrom":null}` + + if err = ioutil.WriteFile(filepath.Join(containerPath, "config.json"), []byte(config), 0644); err != nil { + t.Fatal(err) + } + + hostConfig := `{"Binds":[],"ContainerIDFile":"","LxcConf":[],"Memory":0,"MemorySwap":0,"CpuShares":0,"CpusetCpus":"", +"Privileged":false,"PortBindings":{},"Links":null,"PublishAllPorts":false,"Dns":null,"DnsOptions":null,"DnsSearch":null,"ExtraHosts":null,"VolumesFrom":null, +"Devices":[],"NetworkMode":"bridge","IpcMode":"","PidMode":"","CapAdd":null,"CapDrop":null,"RestartPolicy":{"Name":"no","MaximumRetryCount":0}, +"SecurityOpt":null,"ReadonlyRootfs":false,"Ulimits":null,"LogConfig":{"Type":"","Config":null},"CgroupParent":""}` + if err = ioutil.WriteFile(filepath.Join(containerPath, "hostconfig.json"), []byte(hostConfig), 0644); err != nil { + t.Fatal(err) + } + + daemon, err := initDaemonWithVolumeStore(tmp) + if err != nil { + t.Fatal(err) + } + defer volumedrivers.Unregister(volume.DefaultDriverName) + + c, err := daemon.load(containerID) + if err != nil { + t.Fatal(err) + } + + err = daemon.verifyVolumesInfo(c) + if err != nil { + t.Fatal(err) + } + + if len(c.MountPoints) != 1 { + t.Fatalf("Expected 1 volume mounted, was 0\n") + } + + m := c.MountPoints["/vol1"] + if m.Name != hostVolumeID { + t.Fatalf("Expected mount name to be %s, was %s\n", hostVolumeID, m.Name) + } + + if m.Destination != "/vol1" { + t.Fatalf("Expected mount destination /vol1, was %s\n", m.Destination) + } + + if !m.RW { + t.Fatalf("Expected mount point to be RW but it was not\n") + } + + if m.Driver != volume.DefaultDriverName { + t.Fatalf("Expected mount driver local, was %s\n", m.Driver) + } + + newVolumeContent := filepath.Join(volumePath, local.VolumeDataPathName, "helo") + b, err := ioutil.ReadFile(newVolumeContent) + if err != nil { + t.Fatal(err) + } + if string(b) != "HELO" { + t.Fatalf("Expected HELO, was %s\n", string(b)) + } +} + +func TestRemoveLocalVolumesFollowingSymlinks(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + containerID := "d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e" + containerPath := filepath.Join(tmp, containerID) + if err := os.MkdirAll(containerPath, 0755); err != nil { + t.Fatal(err) + } + + hostVolumeID := stringid.GenerateNonCryptoID() + vfsPath := filepath.Join(tmp, "vfs", "dir", hostVolumeID) + volumePath := filepath.Join(tmp, "volumes", hostVolumeID) + + if err := os.MkdirAll(vfsPath, 0755); err != nil { + t.Fatal(err) + } + if err := os.MkdirAll(volumePath, 0755); err != nil { + t.Fatal(err) + } + + content := filepath.Join(vfsPath, "helo") + if err := ioutil.WriteFile(content, []byte("HELO"), 0644); err != nil { + t.Fatal(err) + } + + config := `{"State":{"Running":true,"Paused":false,"Restarting":false,"OOMKilled":false,"Dead":false,"Pid":2464,"ExitCode":0, +"Error":"","StartedAt":"2015-05-26T16:48:53.869308965Z","FinishedAt":"0001-01-01T00:00:00Z"}, +"ID":"d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e","Created":"2015-05-26T16:48:53.7987917Z","Path":"top", +"Args":[],"Config":{"Hostname":"d59df5276e7b","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"Cpuset":"", +"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"PortSpecs":null,"ExposedPorts":null,"Tty":true,"OpenStdin":true, +"StdinOnce":false,"Env":null,"Cmd":["top"],"Image":"ubuntu:latest","Volumes":null,"WorkingDir":"","Entrypoint":null, +"NetworkDisabled":false,"MacAddress":"","OnBuild":null,"Labels":{}},"Image":"07f8e8c5e66084bef8f848877857537ffe1c47edd01a93af27e7161672ad0e95", +"NetworkSettings":{"IPAddress":"172.17.0.1","IPPrefixLen":16,"MacAddress":"02:42:ac:11:00:01","LinkLocalIPv6Address":"fe80::42:acff:fe11:1", +"LinkLocalIPv6PrefixLen":64,"GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"Gateway":"172.17.42.1","IPv6Gateway":"","Bridge":"docker0","Ports":{}}, +"ResolvConfPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/resolv.conf", +"HostnamePath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hostname", +"HostsPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/hosts", +"LogPath":"/var/lib/docker/containers/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e/d59df5276e7b219d510fe70565e0404bc06350e0d4b43fe961f22f339980170e-json.log", +"Name":"/ubuntu","Driver":"aufs","ExecDriver":"native-0.2","MountLabel":"","ProcessLabel":"","AppArmorProfile":"","RestartCount":0, +"UpdateDns":false,"Volumes":{"/vol1":"%s"},"VolumesRW":{"/vol1":true},"AppliedVolumesFrom":null}` + + cfg := fmt.Sprintf(config, vfsPath) + if err = ioutil.WriteFile(filepath.Join(containerPath, "config.json"), []byte(cfg), 0644); err != nil { + t.Fatal(err) + } + + hostConfig := `{"Binds":[],"ContainerIDFile":"","LxcConf":[],"Memory":0,"MemorySwap":0,"CpuShares":0,"CpusetCpus":"", +"Privileged":false,"PortBindings":{},"Links":null,"PublishAllPorts":false,"Dns":null,"DnsOptions":null,"DnsSearch":null,"ExtraHosts":null,"VolumesFrom":null, +"Devices":[],"NetworkMode":"bridge","IpcMode":"","PidMode":"","CapAdd":null,"CapDrop":null,"RestartPolicy":{"Name":"no","MaximumRetryCount":0}, +"SecurityOpt":null,"ReadonlyRootfs":false,"Ulimits":null,"LogConfig":{"Type":"","Config":null},"CgroupParent":""}` + if err = ioutil.WriteFile(filepath.Join(containerPath, "hostconfig.json"), []byte(hostConfig), 0644); err != nil { + t.Fatal(err) + } + + daemon, err := initDaemonWithVolumeStore(tmp) + if err != nil { + t.Fatal(err) + } + defer volumedrivers.Unregister(volume.DefaultDriverName) + + c, err := daemon.load(containerID) + if err != nil { + t.Fatal(err) + } + + err = daemon.verifyVolumesInfo(c) + if err != nil { + t.Fatal(err) + } + + if len(c.MountPoints) != 1 { + t.Fatalf("Expected 1 volume mounted, was 0\n") + } + + m := c.MountPoints["/vol1"] + _, err = daemon.VolumeCreate(m.Name, m.Driver, nil) + if err != nil { + t.Fatal(err) + } + + if err := daemon.VolumeRm(m.Name); err != nil { + t.Fatal(err) + } + + fi, err := os.Stat(vfsPath) + if err == nil || !os.IsNotExist(err) { + t.Fatalf("Expected vfs path to not exist: %v - %v\n", fi, err) + } +} + +func initDaemonWithVolumeStore(tmp string) (*Daemon, error) { + daemon := &Daemon{ + repository: tmp, + root: tmp, + volumes: store.New(), + } + + volumesDriver, err := local.New(tmp, 0, 0) + if err != nil { + return nil, err + } + volumedrivers.Register(volumesDriver, volumesDriver.Name()) + + return daemon, nil +} + +func TestParseSecurityOpt(t *testing.T) { + container := &Container{} + config := &runconfig.HostConfig{} + + // test apparmor + config.SecurityOpt = []string{"apparmor:test_profile"} + if err := parseSecurityOpt(container, config); err != nil { + t.Fatalf("Unexpected parseSecurityOpt error: %v", err) + } + if container.AppArmorProfile != "test_profile" { + t.Fatalf("Unexpected AppArmorProfile, expected: \"test_profile\", got %q", container.AppArmorProfile) + } + + // test valid label + config.SecurityOpt = []string{"label:user:USER"} + if err := parseSecurityOpt(container, config); err != nil { + t.Fatalf("Unexpected parseSecurityOpt error: %v", err) + } + + // test invalid label + config.SecurityOpt = []string{"label"} + if err := parseSecurityOpt(container, config); err == nil { + t.Fatal("Expected parseSecurityOpt error, got nil") + } + + // test invalid opt + config.SecurityOpt = []string{"test"} + if err := parseSecurityOpt(container, config); err == nil { + t.Fatal("Expected parseSecurityOpt error, got nil") + } +} + +func TestNetworkOptions(t *testing.T) { + daemon := &Daemon{} + dconfigCorrect := &Config{ + CommonConfig: CommonConfig{ + DefaultNetwork: "netPlugin:mynet:dev", + ClusterStore: "consul://localhost:8500", + ClusterAdvertise: "192.168.0.1:8000", + }, + } + + if _, err := daemon.networkOptions(dconfigCorrect); err != nil { + t.Fatalf("Expect networkOptions sucess, got error: %v", err) + } + + dconfigWrong := &Config{ + CommonConfig: CommonConfig{ + ClusterStore: "consul://localhost:8500://test://bbb", + }, + } + + if _, err := daemon.networkOptions(dconfigWrong); err == nil { + t.Fatalf("Expected networkOptions error, got nil") + } +} diff --git a/daemon/daemon_unix.go b/daemon/daemon_unix.go new file mode 100644 index 0000000000..d31b83366c --- /dev/null +++ b/daemon/daemon_unix.go @@ -0,0 +1,643 @@ +// +build linux freebsd + +package daemon + +import ( + "fmt" + "net" + "os" + "path/filepath" + "strconv" + "strings" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/daemon/graphdriver" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/parsers/kernel" + "github.com/docker/docker/pkg/sysinfo" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" + "github.com/docker/libnetwork" + nwconfig "github.com/docker/libnetwork/config" + "github.com/docker/libnetwork/drivers/bridge" + "github.com/docker/libnetwork/ipamutils" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/options" + "github.com/docker/libnetwork/types" + "github.com/opencontainers/runc/libcontainer/label" + "github.com/vishvananda/netlink" +) + +const ( + // See https://git.kernel.org/cgit/linux/kernel/git/tip/tip.git/tree/kernel/sched/sched.h?id=8cd9234c64c584432f6992fe944ca9e46ca8ea76#n269 + linuxMinCPUShares = 2 + linuxMaxCPUShares = 262144 + platformSupported = true +) + +func parseSecurityOpt(container *Container, config *runconfig.HostConfig) error { + var ( + labelOpts []string + err error + ) + + for _, opt := range config.SecurityOpt { + con := strings.SplitN(opt, ":", 2) + if len(con) == 1 { + return fmt.Errorf("Invalid --security-opt: %q", opt) + } + switch con[0] { + case "label": + labelOpts = append(labelOpts, con[1]) + case "apparmor": + container.AppArmorProfile = con[1] + default: + return fmt.Errorf("Invalid --security-opt: %q", opt) + } + } + + container.ProcessLabel, container.MountLabel, err = label.InitLabels(labelOpts) + return err +} + +func checkKernelVersion(k, major, minor int) bool { + if v, err := kernel.GetKernelVersion(); err != nil { + logrus.Warnf("%s", err) + } else { + if kernel.CompareKernelVersion(*v, kernel.VersionInfo{Kernel: k, Major: major, Minor: minor}) < 0 { + return false + } + } + return true +} + +func checkKernel() error { + // Check for unsupported kernel versions + // FIXME: it would be cleaner to not test for specific versions, but rather + // test for specific functionalities. + // Unfortunately we can't test for the feature "does not cause a kernel panic" + // without actually causing a kernel panic, so we need this workaround until + // the circumstances of pre-3.10 crashes are clearer. + // For details see https://github.com/docker/docker/issues/407 + if !checkKernelVersion(3, 10, 0) { + v, _ := kernel.GetKernelVersion() + if os.Getenv("DOCKER_NOWARN_KERNEL_VERSION") == "" { + logrus.Warnf("Your Linux kernel version %s can be unstable running docker. Please upgrade your kernel to 3.10.0.", v.String()) + } + } + return nil +} + +// adaptContainerSettings is called during container creation to modify any +// settings necessary in the HostConfig structure. +func (daemon *Daemon) adaptContainerSettings(hostConfig *runconfig.HostConfig, adjustCPUShares bool) { + if hostConfig == nil { + return + } + + if adjustCPUShares && hostConfig.CPUShares > 0 { + // Handle unsupported CPUShares + if hostConfig.CPUShares < linuxMinCPUShares { + logrus.Warnf("Changing requested CPUShares of %d to minimum allowed of %d", hostConfig.CPUShares, linuxMinCPUShares) + hostConfig.CPUShares = linuxMinCPUShares + } else if hostConfig.CPUShares > linuxMaxCPUShares { + logrus.Warnf("Changing requested CPUShares of %d to maximum allowed of %d", hostConfig.CPUShares, linuxMaxCPUShares) + hostConfig.CPUShares = linuxMaxCPUShares + } + } + if hostConfig.Memory > 0 && hostConfig.MemorySwap == 0 { + // By default, MemorySwap is set to twice the size of Memory. + hostConfig.MemorySwap = hostConfig.Memory * 2 + } +} + +// verifyPlatformContainerSettings performs platform-specific validation of the +// hostconfig and config structures. +func verifyPlatformContainerSettings(daemon *Daemon, hostConfig *runconfig.HostConfig, config *runconfig.Config) ([]string, error) { + warnings := []string{} + sysInfo := sysinfo.New(true) + + warnings, err := daemon.verifyExperimentalContainerSettings(hostConfig, config) + if err != nil { + return warnings, err + } + + if hostConfig.LxcConf.Len() > 0 && !strings.Contains(daemon.ExecutionDriver().Name(), "lxc") { + return warnings, fmt.Errorf("Cannot use --lxc-conf with execdriver: %s", daemon.ExecutionDriver().Name()) + } + + // memory subsystem checks and adjustments + if hostConfig.Memory != 0 && hostConfig.Memory < 4194304 { + return warnings, fmt.Errorf("Minimum memory limit allowed is 4MB") + } + if hostConfig.Memory > 0 && !sysInfo.MemoryLimit { + warnings = append(warnings, "Your kernel does not support memory limit capabilities. Limitation discarded.") + logrus.Warnf("Your kernel does not support memory limit capabilities. Limitation discarded.") + hostConfig.Memory = 0 + hostConfig.MemorySwap = -1 + } + if hostConfig.Memory > 0 && hostConfig.MemorySwap != -1 && !sysInfo.SwapLimit { + warnings = append(warnings, "Your kernel does not support swap limit capabilities, memory limited without swap.") + logrus.Warnf("Your kernel does not support swap limit capabilities, memory limited without swap.") + hostConfig.MemorySwap = -1 + } + if hostConfig.Memory > 0 && hostConfig.MemorySwap > 0 && hostConfig.MemorySwap < hostConfig.Memory { + return warnings, fmt.Errorf("Minimum memoryswap limit should be larger than memory limit, see usage.") + } + if hostConfig.Memory == 0 && hostConfig.MemorySwap > 0 { + return warnings, fmt.Errorf("You should always set the Memory limit when using Memoryswap limit, see usage.") + } + if hostConfig.MemorySwappiness != nil && *hostConfig.MemorySwappiness != -1 && !sysInfo.MemorySwappiness { + warnings = append(warnings, "Your kernel does not support memory swappiness capabilities, memory swappiness discarded.") + logrus.Warnf("Your kernel does not support memory swappiness capabilities, memory swappiness discarded.") + hostConfig.MemorySwappiness = nil + } + if hostConfig.MemorySwappiness != nil { + swappiness := *hostConfig.MemorySwappiness + if swappiness < -1 || swappiness > 100 { + return warnings, fmt.Errorf("Invalid value: %v, valid memory swappiness range is 0-100.", swappiness) + } + } + if hostConfig.MemoryReservation > 0 && !sysInfo.MemoryReservation { + warnings = append(warnings, "Your kernel does not support memory soft limit capabilities. Limitation discarded.") + logrus.Warnf("Your kernel does not support memory soft limit capabilities. Limitation discarded.") + hostConfig.MemoryReservation = 0 + } + if hostConfig.Memory > 0 && hostConfig.MemoryReservation > 0 && hostConfig.Memory < hostConfig.MemoryReservation { + return warnings, fmt.Errorf("Minimum memory limit should be larger than memory reservation limit, see usage.") + } + if hostConfig.KernelMemory > 0 && !sysInfo.KernelMemory { + warnings = append(warnings, "Your kernel does not support kernel memory limit capabilities. Limitation discarded.") + logrus.Warnf("Your kernel does not support kernel memory limit capabilities. Limitation discarded.") + hostConfig.KernelMemory = 0 + } + if hostConfig.KernelMemory > 0 && !checkKernelVersion(4, 0, 0) { + warnings = append(warnings, "You specified a kernel memory limit on a kernel older than 4.0. Kernel memory limits are experimental on older kernels, it won't work as expected and can cause your system to be unstable.") + logrus.Warnf("You specified a kernel memory limit on a kernel older than 4.0. Kernel memory limits are experimental on older kernels, it won't work as expected and can cause your system to be unstable.") + } + if hostConfig.CPUShares > 0 && !sysInfo.CPUShares { + warnings = append(warnings, "Your kernel does not support CPU shares. Shares discarded.") + logrus.Warnf("Your kernel does not support CPU shares. Shares discarded.") + hostConfig.CPUShares = 0 + } + if hostConfig.CPUPeriod > 0 && !sysInfo.CPUCfsPeriod { + warnings = append(warnings, "Your kernel does not support CPU cfs period. Period discarded.") + logrus.Warnf("Your kernel does not support CPU cfs period. Period discarded.") + hostConfig.CPUPeriod = 0 + } + if hostConfig.CPUQuota > 0 && !sysInfo.CPUCfsQuota { + warnings = append(warnings, "Your kernel does not support CPU cfs quota. Quota discarded.") + logrus.Warnf("Your kernel does not support CPU cfs quota. Quota discarded.") + hostConfig.CPUQuota = 0 + } + if (hostConfig.CpusetCpus != "" || hostConfig.CpusetMems != "") && !sysInfo.Cpuset { + warnings = append(warnings, "Your kernel does not support cpuset. Cpuset discarded.") + logrus.Warnf("Your kernel does not support cpuset. Cpuset discarded.") + hostConfig.CpusetCpus = "" + hostConfig.CpusetMems = "" + } + cpusAvailable, err := sysInfo.IsCpusetCpusAvailable(hostConfig.CpusetCpus) + if err != nil { + return warnings, derr.ErrorCodeInvalidCpusetCpus.WithArgs(hostConfig.CpusetCpus) + } + if !cpusAvailable { + return warnings, derr.ErrorCodeNotAvailableCpusetCpus.WithArgs(hostConfig.CpusetCpus, sysInfo.Cpus) + } + memsAvailable, err := sysInfo.IsCpusetMemsAvailable(hostConfig.CpusetMems) + if err != nil { + return warnings, derr.ErrorCodeInvalidCpusetMems.WithArgs(hostConfig.CpusetMems) + } + if !memsAvailable { + return warnings, derr.ErrorCodeNotAvailableCpusetMems.WithArgs(hostConfig.CpusetMems, sysInfo.Mems) + } + if hostConfig.BlkioWeight > 0 && !sysInfo.BlkioWeight { + warnings = append(warnings, "Your kernel does not support Block I/O weight. Weight discarded.") + logrus.Warnf("Your kernel does not support Block I/O weight. Weight discarded.") + hostConfig.BlkioWeight = 0 + } + if hostConfig.BlkioWeight > 0 && (hostConfig.BlkioWeight < 10 || hostConfig.BlkioWeight > 1000) { + return warnings, fmt.Errorf("Range of blkio weight is from 10 to 1000.") + } + if hostConfig.OomKillDisable && !sysInfo.OomKillDisable { + hostConfig.OomKillDisable = false + return warnings, fmt.Errorf("Your kernel does not support oom kill disable.") + } + + if sysInfo.IPv4ForwardingDisabled { + warnings = append(warnings, "IPv4 forwarding is disabled. Networking will not work.") + logrus.Warnf("IPv4 forwarding is disabled. Networking will not work") + } + return warnings, nil +} + +// checkConfigOptions checks for mutually incompatible config options +func checkConfigOptions(config *Config) error { + // Check for mutually incompatible config options + if config.Bridge.Iface != "" && config.Bridge.IP != "" { + return fmt.Errorf("You specified -b & --bip, mutually exclusive options. Please specify only one.") + } + if !config.Bridge.EnableIPTables && !config.Bridge.InterContainerCommunication { + return fmt.Errorf("You specified --iptables=false with --icc=false. ICC uses iptables to function. Please set --icc or --iptables to true.") + } + if !config.Bridge.EnableIPTables && config.Bridge.EnableIPMasq { + config.Bridge.EnableIPMasq = false + } + return nil +} + +// checkSystem validates platform-specific requirements +func checkSystem() error { + if os.Geteuid() != 0 { + return fmt.Errorf("The Docker daemon needs to be run as root") + } + return checkKernel() +} + +// configureKernelSecuritySupport configures and validate security support for the kernel +func configureKernelSecuritySupport(config *Config, driverName string) error { + if config.EnableSelinuxSupport { + if selinuxEnabled() { + // As Docker on either btrfs or overlayFS and SELinux are incompatible at present, error on both being enabled + if driverName == "btrfs" || driverName == "overlay" { + return fmt.Errorf("SELinux is not supported with the %s graph driver", driverName) + } + logrus.Debug("SELinux enabled successfully") + } else { + logrus.Warn("Docker could not enable SELinux on the host system") + } + } else { + selinuxSetDisabled() + } + return nil +} + +// MigrateIfDownlevel is a wrapper for AUFS migration for downlevel +func migrateIfDownlevel(driver graphdriver.Driver, root string) error { + return migrateIfAufs(driver, root) +} + +func configureSysInit(config *Config, rootUID, rootGID int) (string, error) { + localCopy := filepath.Join(config.Root, "init", fmt.Sprintf("dockerinit-%s", dockerversion.VERSION)) + sysInitPath := utils.DockerInitPath(localCopy) + if sysInitPath == "" { + return "", fmt.Errorf("Could not locate dockerinit: This usually means docker was built incorrectly. See https://docs.docker.com/project/set-up-dev-env/ for official build instructions.") + } + + if sysInitPath != localCopy { + // When we find a suitable dockerinit binary (even if it's our local binary), we copy it into config.Root at localCopy for future use (so that the original can go away without that being a problem, for example during a package upgrade). + if err := idtools.MkdirAs(filepath.Dir(localCopy), 0700, rootUID, rootGID); err != nil && !os.IsExist(err) { + return "", err + } + if _, err := fileutils.CopyFile(sysInitPath, localCopy); err != nil { + return "", err + } + if err := os.Chmod(localCopy, 0700); err != nil { + return "", err + } + sysInitPath = localCopy + } + return sysInitPath, nil +} + +func isBridgeNetworkDisabled(config *Config) bool { + return config.Bridge.Iface == disableNetworkBridge +} + +func (daemon *Daemon) networkOptions(dconfig *Config) ([]nwconfig.Option, error) { + options := []nwconfig.Option{} + if dconfig == nil { + return options, nil + } + + options = append(options, nwconfig.OptionDataDir(dconfig.Root)) + + if strings.TrimSpace(dconfig.DefaultNetwork) != "" { + dn := strings.Split(dconfig.DefaultNetwork, ":") + if len(dn) < 2 { + return nil, fmt.Errorf("default network daemon config must be of the form NETWORKDRIVER:NETWORKNAME") + } + options = append(options, nwconfig.OptionDefaultDriver(dn[0])) + options = append(options, nwconfig.OptionDefaultNetwork(strings.Join(dn[1:], ":"))) + } else { + dd := runconfig.DefaultDaemonNetworkMode() + dn := runconfig.DefaultDaemonNetworkMode().NetworkName() + options = append(options, nwconfig.OptionDefaultDriver(string(dd))) + options = append(options, nwconfig.OptionDefaultNetwork(dn)) + } + + if strings.TrimSpace(dconfig.ClusterStore) != "" { + kv := strings.Split(dconfig.ClusterStore, "://") + if len(kv) != 2 { + return nil, fmt.Errorf("kv store daemon config must be of the form KV-PROVIDER://KV-URL") + } + options = append(options, nwconfig.OptionKVProvider(kv[0])) + options = append(options, nwconfig.OptionKVProviderURL(kv[1])) + } + if len(dconfig.ClusterOpts) > 0 { + options = append(options, nwconfig.OptionKVOpts(dconfig.ClusterOpts)) + } + + if daemon.discoveryWatcher != nil { + options = append(options, nwconfig.OptionDiscoveryWatcher(daemon.discoveryWatcher)) + } + + if dconfig.ClusterAdvertise != "" { + options = append(options, nwconfig.OptionDiscoveryAddress(dconfig.ClusterAdvertise)) + } + + options = append(options, nwconfig.OptionLabels(dconfig.Labels)) + options = append(options, driverOptions(dconfig)...) + return options, nil +} + +func (daemon *Daemon) initNetworkController(config *Config) (libnetwork.NetworkController, error) { + netOptions, err := daemon.networkOptions(config) + if err != nil { + return nil, err + } + + controller, err := libnetwork.New(netOptions...) + if err != nil { + return nil, fmt.Errorf("error obtaining controller instance: %v", err) + } + + // Initialize default network on "null" + if _, err := controller.NewNetwork("null", "none", libnetwork.NetworkOptionPersist(false)); err != nil { + return nil, fmt.Errorf("Error creating default \"null\" network: %v", err) + } + + // Initialize default network on "host" + if _, err := controller.NewNetwork("host", "host", libnetwork.NetworkOptionPersist(false)); err != nil { + return nil, fmt.Errorf("Error creating default \"host\" network: %v", err) + } + + if !config.DisableBridge { + // Initialize default driver "bridge" + if err := initBridgeDriver(controller, config); err != nil { + return nil, err + } + } + + return controller, nil +} + +func driverOptions(config *Config) []nwconfig.Option { + bridgeConfig := options.Generic{ + "EnableIPForwarding": config.Bridge.EnableIPForward, + "EnableIPTables": config.Bridge.EnableIPTables, + "EnableUserlandProxy": config.Bridge.EnableUserlandProxy} + bridgeOption := options.Generic{netlabel.GenericData: bridgeConfig} + + dOptions := []nwconfig.Option{} + dOptions = append(dOptions, nwconfig.OptionDriverConfig("bridge", bridgeOption)) + return dOptions +} + +func initBridgeDriver(controller libnetwork.NetworkController, config *Config) error { + if n, err := controller.NetworkByName("bridge"); err == nil { + if err = n.Delete(); err != nil { + return fmt.Errorf("could not delete the default bridge network: %v", err) + } + } + + bridgeName := bridge.DefaultBridgeName + if config.Bridge.Iface != "" { + bridgeName = config.Bridge.Iface + } + netOption := map[string]string{ + bridge.BridgeName: bridgeName, + bridge.DefaultBridge: strconv.FormatBool(true), + netlabel.DriverMTU: strconv.Itoa(config.Mtu), + bridge.EnableIPMasquerade: strconv.FormatBool(config.Bridge.EnableIPMasq), + bridge.EnableICC: strconv.FormatBool(config.Bridge.InterContainerCommunication), + } + + // --ip processing + if config.Bridge.DefaultIP != nil { + netOption[bridge.DefaultBindingIP] = config.Bridge.DefaultIP.String() + } + + ipamV4Conf := libnetwork.IpamConf{} + + ipamV4Conf.AuxAddresses = make(map[string]string) + + if nw, _, err := ipamutils.ElectInterfaceAddresses(bridgeName); err == nil { + ipamV4Conf.PreferredPool = nw.String() + hip, _ := types.GetHostPartIP(nw.IP, nw.Mask) + if hip.IsGlobalUnicast() { + ipamV4Conf.Gateway = nw.IP.String() + } + } + + if config.Bridge.IP != "" { + ipamV4Conf.PreferredPool = config.Bridge.IP + ip, _, err := net.ParseCIDR(config.Bridge.IP) + if err != nil { + return err + } + ipamV4Conf.Gateway = ip.String() + } else if bridgeName == bridge.DefaultBridgeName && ipamV4Conf.PreferredPool != "" { + logrus.Infof("Default bridge (%s) is assigned with an IP address %s. Daemon option --bip can be used to set a preferred IP address", bridgeName, ipamV4Conf.PreferredPool) + } + + if config.Bridge.FixedCIDR != "" { + _, fCIDR, err := net.ParseCIDR(config.Bridge.FixedCIDR) + if err != nil { + return err + } + + ipamV4Conf.SubPool = fCIDR.String() + } + + if config.Bridge.DefaultGatewayIPv4 != nil { + ipamV4Conf.AuxAddresses["DefaultGatewayIPv4"] = config.Bridge.DefaultGatewayIPv4.String() + } + + var ( + ipamV6Conf *libnetwork.IpamConf + deferIPv6Alloc bool + ) + if config.Bridge.FixedCIDRv6 != "" { + _, fCIDRv6, err := net.ParseCIDR(config.Bridge.FixedCIDRv6) + if err != nil { + return err + } + + // In case user has specified the daemon flag --fixed-cidr-v6 and the passed network has + // at least 48 host bits, we need to guarantee the current behavior where the containers' + // IPv6 addresses will be constructed based on the containers' interface MAC address. + // We do so by telling libnetwork to defer the IPv6 address allocation for the endpoints + // on this network until after the driver has created the endpoint and returned the + // constructed address. Libnetwork will then reserve this address with the ipam driver. + ones, _ := fCIDRv6.Mask.Size() + deferIPv6Alloc = ones <= 80 + + if ipamV6Conf == nil { + ipamV6Conf = &libnetwork.IpamConf{} + } + ipamV6Conf.PreferredPool = fCIDRv6.String() + } + + if config.Bridge.DefaultGatewayIPv6 != nil { + if ipamV6Conf == nil { + ipamV6Conf = &libnetwork.IpamConf{} + } + ipamV6Conf.AuxAddresses["DefaultGatewayIPv6"] = config.Bridge.DefaultGatewayIPv6.String() + } + + v4Conf := []*libnetwork.IpamConf{&ipamV4Conf} + v6Conf := []*libnetwork.IpamConf{} + if ipamV6Conf != nil { + v6Conf = append(v6Conf, ipamV6Conf) + } + // Initialize default network on "bridge" with the same name + _, err := controller.NewNetwork("bridge", "bridge", + libnetwork.NetworkOptionGeneric(options.Generic{ + netlabel.GenericData: netOption, + netlabel.EnableIPv6: config.Bridge.EnableIPv6, + }), + libnetwork.NetworkOptionIpam("default", "", v4Conf, v6Conf), + libnetwork.NetworkOptionDeferIPv6Alloc(deferIPv6Alloc)) + if err != nil { + return fmt.Errorf("Error creating default \"bridge\" network: %v", err) + } + return nil +} + +// setupInitLayer populates a directory with mountpoints suitable +// for bind-mounting dockerinit into the container. The mountpoint is simply an +// empty file at /.dockerinit +// +// This extra layer is used by all containers as the top-most ro layer. It protects +// the container from unwanted side-effects on the rw layer. +func setupInitLayer(initLayer string, rootUID, rootGID int) error { + for pth, typ := range map[string]string{ + "/dev/pts": "dir", + "/dev/shm": "dir", + "/proc": "dir", + "/sys": "dir", + "/.dockerinit": "file", + "/.dockerenv": "file", + "/etc/resolv.conf": "file", + "/etc/hosts": "file", + "/etc/hostname": "file", + "/dev/console": "file", + "/etc/mtab": "/proc/mounts", + } { + parts := strings.Split(pth, "/") + prev := "/" + for _, p := range parts[1:] { + prev = filepath.Join(prev, p) + syscall.Unlink(filepath.Join(initLayer, prev)) + } + + if _, err := os.Stat(filepath.Join(initLayer, pth)); err != nil { + if os.IsNotExist(err) { + if err := idtools.MkdirAllAs(filepath.Join(initLayer, filepath.Dir(pth)), 0755, rootUID, rootGID); err != nil { + return err + } + switch typ { + case "dir": + if err := idtools.MkdirAllAs(filepath.Join(initLayer, pth), 0755, rootUID, rootGID); err != nil { + return err + } + case "file": + f, err := os.OpenFile(filepath.Join(initLayer, pth), os.O_CREATE, 0755) + if err != nil { + return err + } + f.Close() + f.Chown(rootUID, rootGID) + default: + if err := os.Symlink(typ, filepath.Join(initLayer, pth)); err != nil { + return err + } + } + } else { + return err + } + } + } + + // Layer is ready to use, if it wasn't before. + return nil +} + +// registerLinks writes the links to a file. +func (daemon *Daemon) registerLinks(container *Container, hostConfig *runconfig.HostConfig) error { + if hostConfig == nil || hostConfig.Links == nil { + return nil + } + + for _, l := range hostConfig.Links { + name, alias, err := parsers.ParseLink(l) + if err != nil { + return err + } + child, err := daemon.Get(name) + if err != nil { + //An error from daemon.Get() means this name could not be found + return fmt.Errorf("Could not get container for %s", name) + } + for child.hostConfig.NetworkMode.IsContainer() { + parts := strings.SplitN(string(child.hostConfig.NetworkMode), ":", 2) + child, err = daemon.Get(parts[1]) + if err != nil { + return fmt.Errorf("Could not get container for %s", parts[1]) + } + } + if child.hostConfig.NetworkMode.IsHost() { + return runconfig.ErrConflictHostNetworkAndLinks + } + if err := daemon.registerLink(container, child, alias); err != nil { + return err + } + } + + // After we load all the links into the daemon + // set them to nil on the hostconfig + hostConfig.Links = nil + if err := container.writeHostConfig(); err != nil { + return err + } + + return nil +} + +func (daemon *Daemon) newBaseContainer(id string) Container { + return Container{ + CommonContainer: CommonContainer{ + ID: id, + State: NewState(), + execCommands: newExecStore(), + root: daemon.containerRoot(id), + }, + MountPoints: make(map[string]*mountPoint), + Volumes: make(map[string]string), + VolumesRW: make(map[string]bool), + } +} + +// getDefaultRouteMtu returns the MTU for the default route's interface. +func getDefaultRouteMtu() (int, error) { + routes, err := netlink.RouteList(nil, 0) + if err != nil { + return 0, err + } + for _, r := range routes { + // a nil Dst means that this is the default route. + if r.Dst == nil { + i, err := net.InterfaceByIndex(r.LinkIndex) + if err != nil { + continue + } + return i.MTU, nil + } + } + return 0, errNoDefaultRoute +} diff --git a/daemon/daemon_unix_test.go b/daemon/daemon_unix_test.go new file mode 100644 index 0000000000..fc13e667c5 --- /dev/null +++ b/daemon/daemon_unix_test.go @@ -0,0 +1,87 @@ +// +build !windows + +package daemon + +import ( + "io/ioutil" + "os" + "testing" + + "github.com/docker/docker/runconfig" +) + +func TestAdjustCPUShares(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-unix-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + daemon := &Daemon{ + repository: tmp, + root: tmp, + } + + hostConfig := &runconfig.HostConfig{ + CPUShares: linuxMinCPUShares - 1, + } + daemon.adaptContainerSettings(hostConfig, true) + if hostConfig.CPUShares != linuxMinCPUShares { + t.Errorf("Expected CPUShares to be %d", linuxMinCPUShares) + } + + hostConfig.CPUShares = linuxMaxCPUShares + 1 + daemon.adaptContainerSettings(hostConfig, true) + if hostConfig.CPUShares != linuxMaxCPUShares { + t.Errorf("Expected CPUShares to be %d", linuxMaxCPUShares) + } + + hostConfig.CPUShares = 0 + daemon.adaptContainerSettings(hostConfig, true) + if hostConfig.CPUShares != 0 { + t.Error("Expected CPUShares to be unchanged") + } + + hostConfig.CPUShares = 1024 + daemon.adaptContainerSettings(hostConfig, true) + if hostConfig.CPUShares != 1024 { + t.Error("Expected CPUShares to be unchanged") + } +} + +func TestAdjustCPUSharesNoAdjustment(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-unix-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + daemon := &Daemon{ + repository: tmp, + root: tmp, + } + + hostConfig := &runconfig.HostConfig{ + CPUShares: linuxMinCPUShares - 1, + } + daemon.adaptContainerSettings(hostConfig, false) + if hostConfig.CPUShares != linuxMinCPUShares-1 { + t.Errorf("Expected CPUShares to be %d", linuxMinCPUShares-1) + } + + hostConfig.CPUShares = linuxMaxCPUShares + 1 + daemon.adaptContainerSettings(hostConfig, false) + if hostConfig.CPUShares != linuxMaxCPUShares+1 { + t.Errorf("Expected CPUShares to be %d", linuxMaxCPUShares+1) + } + + hostConfig.CPUShares = 0 + daemon.adaptContainerSettings(hostConfig, false) + if hostConfig.CPUShares != 0 { + t.Error("Expected CPUShares to be unchanged") + } + + hostConfig.CPUShares = 1024 + daemon.adaptContainerSettings(hostConfig, false) + if hostConfig.CPUShares != 1024 { + t.Error("Expected CPUShares to be unchanged") + } +} diff --git a/daemon/daemon_unsupported.go b/daemon/daemon_unsupported.go new file mode 100644 index 0000000000..987528f476 --- /dev/null +++ b/daemon/daemon_unsupported.go @@ -0,0 +1,5 @@ +// +build !linux,!freebsd,!windows + +package daemon + +const platformSupported = false diff --git a/daemon/daemon_windows.go b/daemon/daemon_windows.go new file mode 100644 index 0000000000..b829a8fd19 --- /dev/null +++ b/daemon/daemon_windows.go @@ -0,0 +1,156 @@ +package daemon + +import ( + "fmt" + "os" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/graphdriver" + // register the windows graph driver + _ "github.com/docker/docker/daemon/graphdriver/windows" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/runconfig" + "github.com/docker/libnetwork" +) + +const ( + defaultVirtualSwitch = "Virtual Switch" + platformSupported = true + windowsMinCPUShares = 1 + windowsMaxCPUShares = 9 +) + +func parseSecurityOpt(container *Container, config *runconfig.HostConfig) error { + return nil +} + +func setupInitLayer(initLayer string, rootUID, rootGID int) error { + return nil +} + +func checkKernel() error { + return nil +} + +// adaptContainerSettings is called during container creation to modify any +// settings necessary in the HostConfig structure. +func (daemon *Daemon) adaptContainerSettings(hostConfig *runconfig.HostConfig, adjustCPUShares bool) { + if hostConfig == nil { + return + } + + if hostConfig.CPUShares < 0 { + logrus.Warnf("Changing requested CPUShares of %d to minimum allowed of %d", hostConfig.CPUShares, windowsMinCPUShares) + hostConfig.CPUShares = windowsMinCPUShares + } else if hostConfig.CPUShares > windowsMaxCPUShares { + logrus.Warnf("Changing requested CPUShares of %d to maximum allowed of %d", hostConfig.CPUShares, windowsMaxCPUShares) + hostConfig.CPUShares = windowsMaxCPUShares + } +} + +// verifyPlatformContainerSettings performs platform-specific validation of the +// hostconfig and config structures. +func verifyPlatformContainerSettings(daemon *Daemon, hostConfig *runconfig.HostConfig, config *runconfig.Config) ([]string, error) { + return nil, nil +} + +// checkConfigOptions checks for mutually incompatible config options +func checkConfigOptions(config *Config) error { + return nil +} + +// checkSystem validates platform-specific requirements +func checkSystem() error { + var dwVersion uint32 + + // TODO Windows. May need at some point to ensure have elevation and + // possibly LocalSystem. + + // Validate the OS version. Note that docker.exe must be manifested for this + // call to return the correct version. + dwVersion, err := syscall.GetVersion() + if err != nil { + return fmt.Errorf("Failed to call GetVersion()") + } + if int(dwVersion&0xFF) < 10 { + return fmt.Errorf("This version of Windows does not support the docker daemon") + } + + return nil +} + +// configureKernelSecuritySupport configures and validate security support for the kernel +func configureKernelSecuritySupport(config *Config, driverName string) error { + return nil +} + +func migrateIfDownlevel(driver graphdriver.Driver, root string) error { + return nil +} + +func configureSysInit(config *Config, rootUID, rootGID int) (string, error) { + // TODO Windows. + return os.Getenv("TEMP"), nil +} + +func isBridgeNetworkDisabled(config *Config) bool { + return false +} + +func (daemon *Daemon) initNetworkController(config *Config) (libnetwork.NetworkController, error) { + // Set the name of the virtual switch if not specified by -b on daemon start + if config.Bridge.VirtualSwitchName == "" { + config.Bridge.VirtualSwitchName = defaultVirtualSwitch + } + return nil, nil +} + +// registerLinks sets up links between containers and writes the +// configuration out for persistence. +func (daemon *Daemon) registerLinks(container *Container, hostConfig *runconfig.HostConfig) error { + // TODO Windows. Factored out for network modes. There may be more + // refactoring required here. + + if hostConfig == nil || hostConfig.Links == nil { + return nil + } + + for _, l := range hostConfig.Links { + name, alias, err := parsers.ParseLink(l) + if err != nil { + return err + } + child, err := daemon.Get(name) + if err != nil { + //An error from daemon.Get() means this name could not be found + return fmt.Errorf("Could not get container for %s", name) + } + if err := daemon.registerLink(container, child, alias); err != nil { + return err + } + } + + // After we load all the links into the daemon + // set them to nil on the hostconfig + hostConfig.Links = nil + if err := container.writeHostConfig(); err != nil { + return err + } + return nil +} + +func (daemon *Daemon) newBaseContainer(id string) Container { + return Container{ + CommonContainer: CommonContainer{ + ID: id, + State: NewState(), + execCommands: newExecStore(), + root: daemon.containerRoot(id), + }, + } +} + +func (daemon *Daemon) cleanupMounts() error { + return nil +} diff --git a/daemon/daemon_zfs.go b/daemon/daemon_zfs.go new file mode 100644 index 0000000000..e5b4dce9cc --- /dev/null +++ b/daemon/daemon_zfs.go @@ -0,0 +1,8 @@ +// +build !exclude_graphdriver_zfs,linux !exclude_graphdriver_zfs,freebsd + +package daemon + +import ( + // register the zfs driver + _ "github.com/docker/docker/daemon/graphdriver/zfs" +) diff --git a/daemon/daemonbuilder/builder.go b/daemon/daemonbuilder/builder.go new file mode 100644 index 0000000000..1e6a5c1531 --- /dev/null +++ b/daemon/daemonbuilder/builder.go @@ -0,0 +1,239 @@ +package daemonbuilder + +import ( + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api" + "github.com/docker/docker/builder" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/daemon" + "github.com/docker/docker/graph" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/urlutil" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" +) + +// Docker implements builder.Docker for the docker Daemon object. +type Docker struct { + Daemon *daemon.Daemon + OutOld io.Writer + AuthConfigs map[string]cliconfig.AuthConfig + Archiver *archive.Archiver +} + +// ensure Docker implements builder.Docker +var _ builder.Docker = Docker{} + +// LookupImage looks up a Docker image referenced by `name`. +func (d Docker) LookupImage(name string) (*image.Image, error) { + return d.Daemon.GetImage(name) +} + +// Pull tells Docker to pull image referenced by `name`. +func (d Docker) Pull(name string) (*image.Image, error) { + remote, tag := parsers.ParseRepositoryTag(name) + if tag == "" { + tag = "latest" + } + + pullRegistryAuth := &cliconfig.AuthConfig{} + if len(d.AuthConfigs) > 0 { + // The request came with a full auth config file, we prefer to use that + repoInfo, err := d.Daemon.RegistryService.ResolveRepository(remote) + if err != nil { + return nil, err + } + + resolvedConfig := registry.ResolveAuthConfig( + &cliconfig.ConfigFile{AuthConfigs: d.AuthConfigs}, + repoInfo.Index, + ) + pullRegistryAuth = &resolvedConfig + } + + imagePullConfig := &graph.ImagePullConfig{ + AuthConfig: pullRegistryAuth, + OutStream: ioutils.NopWriteCloser(d.OutOld), + } + + if err := d.Daemon.PullImage(remote, tag, imagePullConfig); err != nil { + return nil, err + } + + return d.Daemon.GetImage(name) +} + +// Container looks up a Docker container referenced by `id`. +func (d Docker) Container(id string) (*daemon.Container, error) { + return d.Daemon.Get(id) +} + +// Create creates a new Docker container and returns potential warnings +func (d Docker) Create(cfg *runconfig.Config, hostCfg *runconfig.HostConfig) (*daemon.Container, []string, error) { + ccr, err := d.Daemon.ContainerCreate("", cfg, hostCfg, true) + if err != nil { + return nil, nil, err + } + container, err := d.Daemon.Get(ccr.ID) + if err != nil { + return nil, ccr.Warnings, err + } + return container, ccr.Warnings, container.Mount() +} + +// Remove removes a container specified by `id`. +func (d Docker) Remove(id string, cfg *daemon.ContainerRmConfig) error { + return d.Daemon.ContainerRm(id, cfg) +} + +// Commit creates a new Docker image from an existing Docker container. +func (d Docker) Commit(c *daemon.Container, cfg *daemon.ContainerCommitConfig) (*image.Image, error) { + return d.Daemon.Commit(c, cfg) +} + +// Retain retains an image avoiding it to be removed or overwritten until a corresponding Release() call. +func (d Docker) Retain(sessionID, imgID string) { + d.Daemon.Graph().Retain(sessionID, imgID) +} + +// Release releases a list of images that were retained for the time of a build. +func (d Docker) Release(sessionID string, activeImages []string) { + d.Daemon.Graph().Release(sessionID, activeImages...) +} + +// Copy copies/extracts a source FileInfo to a destination path inside a container +// specified by a container object. +// TODO: make sure callers don't unnecessarily convert destPath with filepath.FromSlash (Copy does it already). +// Copy should take in abstract paths (with slashes) and the implementation should convert it to OS-specific paths. +func (d Docker) Copy(c *daemon.Container, destPath string, src builder.FileInfo, decompress bool) error { + srcPath := src.Path() + destExists := true + rootUID, rootGID := d.Daemon.GetRemappedUIDGID() + + // Work in daemon-local OS specific file paths + destPath = filepath.FromSlash(destPath) + + dest, err := c.GetResourcePath(destPath) + if err != nil { + return err + } + + // Preserve the trailing slash + // TODO: why are we appending another path separator if there was already one? + if strings.HasSuffix(destPath, string(os.PathSeparator)) || destPath == "." { + dest += string(os.PathSeparator) + } + + destPath = dest + + destStat, err := os.Stat(destPath) + if err != nil { + if !os.IsNotExist(err) { + logrus.Errorf("Error performing os.Stat on %s. %s", destPath, err) + return err + } + destExists = false + } + + if src.IsDir() { + // copy as directory + if err := d.Archiver.CopyWithTar(srcPath, destPath); err != nil { + return err + } + return fixPermissions(srcPath, destPath, rootUID, rootGID, destExists) + } + if decompress { + // Only try to untar if it is a file and that we've been told to decompress (when ADD-ing a remote file) + + // First try to unpack the source as an archive + // to support the untar feature we need to clean up the path a little bit + // because tar is very forgiving. First we need to strip off the archive's + // filename from the path but this is only added if it does not end in slash + tarDest := destPath + if strings.HasSuffix(tarDest, string(os.PathSeparator)) { + tarDest = filepath.Dir(destPath) + } + + // try to successfully untar the orig + if err := d.Archiver.UntarPath(srcPath, tarDest); err == nil { + return nil + } else if err != io.EOF { + logrus.Debugf("Couldn't untar to %s: %v", tarDest, err) + } + } + + // only needed for fixPermissions, but might as well put it before CopyFileWithTar + if destExists && destStat.IsDir() { + destPath = filepath.Join(destPath, src.Name()) + } + + if err := system.MkdirAll(filepath.Dir(destPath), 0755); err != nil { + return err + } + if err := d.Archiver.CopyFileWithTar(srcPath, destPath); err != nil { + return err + } + + return fixPermissions(srcPath, destPath, rootUID, rootGID, destExists) +} + +// GetCachedImage returns a reference to a cached image whose parent equals `parent` +// and runconfig equals `cfg`. A cache miss is expected to return an empty ID and a nil error. +func (d Docker) GetCachedImage(imgID string, cfg *runconfig.Config) (string, error) { + cache, err := d.Daemon.ImageGetCached(imgID, cfg) + if cache == nil || err != nil { + return "", err + } + return cache.ID, nil +} + +// Following is specific to builder contexts + +// DetectContextFromRemoteURL returns a context and in certain cases the name of the dockerfile to be used +// irrespective of user input. +// progressReader is only used if remoteURL is actually a URL (not empty, and not a Git endpoint). +func DetectContextFromRemoteURL(r io.ReadCloser, remoteURL string, progressReader *progressreader.Config) (context builder.ModifiableContext, dockerfileName string, err error) { + switch { + case remoteURL == "": + context, err = builder.MakeTarSumContext(r) + case urlutil.IsGitURL(remoteURL): + context, err = builder.MakeGitContext(remoteURL) + case urlutil.IsURL(remoteURL): + context, err = builder.MakeRemoteContext(remoteURL, map[string]func(io.ReadCloser) (io.ReadCloser, error){ + httputils.MimeTypes.TextPlain: func(rc io.ReadCloser) (io.ReadCloser, error) { + dockerfile, err := ioutil.ReadAll(rc) + if err != nil { + return nil, err + } + + // dockerfileName is set to signal that the remote was interpreted as a single Dockerfile, in which case the caller + // should use dockerfileName as the new name for the Dockerfile, irrespective of any other user input. + dockerfileName = api.DefaultDockerfileName + + // TODO: return a context without tarsum + return archive.Generate(dockerfileName, string(dockerfile)) + }, + // fallback handler (tar context) + "": func(rc io.ReadCloser) (io.ReadCloser, error) { + progressReader.In = rc + return progressReader, nil + }, + }) + default: + err = fmt.Errorf("remoteURL (%s) could not be recognized as URL", remoteURL) + } + return +} diff --git a/daemon/daemonbuilder/builder_unix.go b/daemon/daemonbuilder/builder_unix.go new file mode 100644 index 0000000000..aa63b33b4c --- /dev/null +++ b/daemon/daemonbuilder/builder_unix.go @@ -0,0 +1,40 @@ +// +build freebsd linux + +package daemonbuilder + +import ( + "os" + "path/filepath" +) + +func fixPermissions(source, destination string, uid, gid int, destExisted bool) error { + // If the destination didn't already exist, or the destination isn't a + // directory, then we should Lchown the destination. Otherwise, we shouldn't + // Lchown the destination. + destStat, err := os.Stat(destination) + if err != nil { + // This should *never* be reached, because the destination must've already + // been created while untar-ing the context. + return err + } + doChownDestination := !destExisted || !destStat.IsDir() + + // We Walk on the source rather than on the destination because we don't + // want to change permissions on things we haven't created or modified. + return filepath.Walk(source, func(fullpath string, info os.FileInfo, err error) error { + // Do not alter the walk root iff. it existed before, as it doesn't fall under + // the domain of "things we should chown". + if !doChownDestination && (source == fullpath) { + return nil + } + + // Path is prefixed by source: substitute with destination instead. + cleaned, err := filepath.Rel(source, fullpath) + if err != nil { + return err + } + + fullpath = filepath.Join(destination, cleaned) + return os.Lchown(fullpath, uid, gid) + }) +} diff --git a/daemon/daemonbuilder/builder_windows.go b/daemon/daemonbuilder/builder_windows.go new file mode 100644 index 0000000000..dded0e400d --- /dev/null +++ b/daemon/daemonbuilder/builder_windows.go @@ -0,0 +1,8 @@ +// +build windows + +package daemonbuilder + +func fixPermissions(source, destination string, uid, gid int, destExisted bool) error { + // chown is not supported on Windows + return nil +} diff --git a/daemon/debugtrap_unix.go b/daemon/debugtrap_unix.go new file mode 100644 index 0000000000..c4a11b07fa --- /dev/null +++ b/daemon/debugtrap_unix.go @@ -0,0 +1,21 @@ +// +build !windows + +package daemon + +import ( + "os" + "os/signal" + "syscall" + + psignal "github.com/docker/docker/pkg/signal" +) + +func setupDumpStackTrap() { + c := make(chan os.Signal, 1) + signal.Notify(c, syscall.SIGUSR1) + go func() { + for range c { + psignal.DumpStacks() + } + }() +} diff --git a/daemon/debugtrap_unsupported.go b/daemon/debugtrap_unsupported.go new file mode 100644 index 0000000000..fef1bd776b --- /dev/null +++ b/daemon/debugtrap_unsupported.go @@ -0,0 +1,7 @@ +// +build !linux,!darwin,!freebsd,!windows + +package daemon + +func setupDumpStackTrap() { + return +} diff --git a/daemon/debugtrap_windows.go b/daemon/debugtrap_windows.go new file mode 100644 index 0000000000..4c47947ba1 --- /dev/null +++ b/daemon/debugtrap_windows.go @@ -0,0 +1,30 @@ +package daemon + +import ( + "fmt" + "os" + "syscall" + + "github.com/Sirupsen/logrus" + psignal "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/system" +) + +func setupDumpStackTrap() { + // Windows does not support signals like *nix systems. So instead of + // trapping on SIGUSR1 to dump stacks, we wait on a Win32 event to be + // signalled. + go func() { + sa := syscall.SecurityAttributes{ + Length: 0, + } + ev := "Global\\docker-daemon-" + fmt.Sprint(os.Getpid()) + if h, _ := system.CreateEvent(&sa, false, false, ev); h != 0 { + logrus.Debugf("Stackdump - waiting signal at %s", ev) + for { + syscall.WaitForSingleObject(h, syscall.INFINITE) + psignal.DumpStacks() + } + } + }() +} diff --git a/daemon/delete.go b/daemon/delete.go new file mode 100644 index 0000000000..cc446ec60f --- /dev/null +++ b/daemon/delete.go @@ -0,0 +1,170 @@ +package daemon + +import ( + "fmt" + "os" + "path" + + "github.com/Sirupsen/logrus" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/volume/store" +) + +// ContainerRmConfig is a holder for passing in runtime config. +type ContainerRmConfig struct { + ForceRemove, RemoveVolume, RemoveLink bool +} + +// ContainerRm removes the container id from the filesystem. An error +// is returned if the container is not found, or if the remove +// fails. If the remove succeeds, the container name is released, and +// network links are removed. +func (daemon *Daemon) ContainerRm(name string, config *ContainerRmConfig) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + if config.RemoveLink { + name, err := GetFullContainerName(name) + if err != nil { + return err + } + parent, n := path.Split(name) + if parent == "/" { + return derr.ErrorCodeDefaultName + } + pe := daemon.containerGraph().Get(parent) + if pe == nil { + return derr.ErrorCodeNoParent.WithArgs(parent, name) + } + + if err := daemon.containerGraph().Delete(name); err != nil { + return err + } + + parentContainer, _ := daemon.Get(pe.ID()) + if parentContainer != nil { + if err := parentContainer.updateNetwork(); err != nil { + logrus.Debugf("Could not update network to remove link %s: %v", n, err) + } + } + + return nil + } + + if err := daemon.rm(container, config.ForceRemove); err != nil { + // return derr.ErrorCodeCantDestroy.WithArgs(name, utils.GetErrorMessage(err)) + return err + } + + if err := container.removeMountPoints(config.RemoveVolume); err != nil { + logrus.Error(err) + } + + return nil +} + +func (daemon *Daemon) Rm(container *Container) (err error) { + return daemon.commonRm(container, false) +} + +func (daemon *Daemon) ForceRm(container *Container) (err error) { + return daemon.commonRm(container, true) +} + +// Destroy unregisters a container from the daemon and cleanly removes its contents from the filesystem. +func (daemon *Daemon) rm(container *Container, forceRemove bool) (err error) { + if container.IsRunning() { + if !forceRemove { + return derr.ErrorCodeRmRunning + } + if err := container.Kill(); err != nil { + return derr.ErrorCodeRmFailed.WithArgs(err) + } + } + + // Container state RemovalInProgress should be used to avoid races. + if err = container.setRemovalInProgress(); err != nil { + if err == derr.ErrorCodeAlreadyRemoving { + // do not fail when the removal is in progress started by other request. + return nil + } + return derr.ErrorCodeRmState.WithArgs(err) + } + defer container.resetRemovalInProgress() + + // stop collection of stats for the container regardless + // if stats are currently getting collected. + daemon.statsCollector.stopCollection(container) + + if err = container.Stop(3); err != nil { + return err + } + + // Mark container dead. We don't want anybody to be restarting it. + container.setDead() + + // Save container state to disk. So that if error happens before + // container meta file got removed from disk, then a restart of + // docker should not make a dead container alive. + if err := container.toDiskLocking(); err != nil { + logrus.Errorf("Error saving dying container to disk: %v", err) + } + + // If force removal is required, delete container from various + // indexes even if removal failed. + defer func() { + if err != nil && forceRemove { + daemon.idIndex.Delete(container.ID) + daemon.containers.Delete(container.ID) + os.RemoveAll(container.root) + container.logEvent("destroy") + } + }() + + if _, err := daemon.containerGraphDB.Purge(container.ID); err != nil { + logrus.Debugf("Unable to remove container from link graph: %s", err) + } + + if err = daemon.driver.Remove(container.ID); err != nil { + return derr.ErrorCodeRmDriverFS.WithArgs(daemon.driver, container.ID, err) + } + + initID := fmt.Sprintf("%s-init", container.ID) + if err := daemon.driver.Remove(initID); err != nil { + return derr.ErrorCodeRmInit.WithArgs(daemon.driver, initID, err) + } + + if err = os.RemoveAll(container.root); err != nil { + return derr.ErrorCodeRmFS.WithArgs(container.ID, err) + } + + if err = daemon.execDriver.Clean(container.ID); err != nil { + return derr.ErrorCodeRmExecDriver.WithArgs(container.ID, err) + } + + selinuxFreeLxcContexts(container.ProcessLabel) + daemon.idIndex.Delete(container.ID) + daemon.containers.Delete(container.ID) + + container.logEvent("destroy") + return nil +} + +// VolumeRm removes the volume with the given name. +// If the volume is referenced by a container it is not removed +// This is called directly from the remote API +func (daemon *Daemon) VolumeRm(name string) error { + v, err := daemon.volumes.Get(name) + if err != nil { + return err + } + if err := daemon.volumes.Remove(v); err != nil { + if err == store.ErrVolumeInUse { + return derr.ErrorCodeRmVolumeInUse.WithArgs(err) + } + return derr.ErrorCodeRmVolume.WithArgs(name, err) + } + return nil +} diff --git a/daemon/delete_test.go b/daemon/delete_test.go new file mode 100644 index 0000000000..9a82fce2d2 --- /dev/null +++ b/daemon/delete_test.go @@ -0,0 +1,39 @@ +package daemon + +import ( + "io/ioutil" + "os" + "testing" + + "github.com/docker/docker/runconfig" +) + +func TestContainerDoubleDelete(t *testing.T) { + tmp, err := ioutil.TempDir("", "docker-daemon-unix-test-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + daemon := &Daemon{ + repository: tmp, + root: tmp, + } + + container := &Container{ + CommonContainer: CommonContainer{ + State: NewState(), + Config: &runconfig.Config{}, + }, + } + + // Mark the container as having a delete in progress + if err := container.setRemovalInProgress(); err != nil { + t.Fatal(err) + } + + // Try to remove the container when it's start is removalInProgress. + // It should ignore the container and not return an error. + if err := daemon.rm(container, true); err != nil { + t.Fatal(err) + } +} diff --git a/daemon/discovery.go b/daemon/discovery.go new file mode 100644 index 0000000000..006eddecf2 --- /dev/null +++ b/daemon/discovery.go @@ -0,0 +1,48 @@ +package daemon + +import ( + "time" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/discovery" + + // Register the libkv backends for discovery. + _ "github.com/docker/docker/pkg/discovery/kv" +) + +const ( + // defaultDiscoveryHeartbeat is the default value for discovery heartbeat interval. + defaultDiscoveryHeartbeat = 20 * time.Second + + // defaultDiscoveryTTL is the default TTL interface for discovery. + defaultDiscoveryTTL = 60 * time.Second +) + +// initDiscovery initialized the nodes discovery subsystem by connecting to the specified backend +// and start a registration loop to advertise the current node under the specified address. +func initDiscovery(backend, address string, clusterOpts map[string]string) (discovery.Backend, error) { + var ( + discoveryBackend discovery.Backend + err error + ) + if discoveryBackend, err = discovery.New(backend, defaultDiscoveryHeartbeat, defaultDiscoveryTTL, clusterOpts); err != nil { + return nil, err + } + + // We call Register() on the discovery backend in a loop for the whole lifetime of the daemon, + // but we never actually Watch() for nodes appearing and disappearing for the moment. + go registrationLoop(discoveryBackend, address) + return discoveryBackend, nil +} + +// registrationLoop registers the current node against the discovery backend using the specified +// address. The function never returns, as registration against the backend comes with a TTL and +// requires regular heartbeats. +func registrationLoop(discoveryBackend discovery.Backend, address string) { + for { + if err := discoveryBackend.Register(address); err != nil { + log.Errorf("Registering as %q in discovery failed: %v", address, err) + } + time.Sleep(defaultDiscoveryHeartbeat) + } +} diff --git a/daemon/events/events.go b/daemon/events/events.go new file mode 100644 index 0000000000..0334dece47 --- /dev/null +++ b/daemon/events/events.go @@ -0,0 +1,65 @@ +package events + +import ( + "sync" + "time" + + "github.com/docker/docker/pkg/jsonmessage" + "github.com/docker/docker/pkg/pubsub" +) + +const eventsLimit = 64 + +// Events is pubsub channel for *jsonmessage.JSONMessage +type Events struct { + mu sync.Mutex + events []*jsonmessage.JSONMessage + pub *pubsub.Publisher +} + +// New returns new *Events instance +func New() *Events { + return &Events{ + events: make([]*jsonmessage.JSONMessage, 0, eventsLimit), + pub: pubsub.NewPublisher(100*time.Millisecond, 1024), + } +} + +// Subscribe adds new listener to events, returns slice of 64 stored last events +// channel in which you can expect new events in form of interface{}, so you +// need type assertion. +func (e *Events) Subscribe() ([]*jsonmessage.JSONMessage, chan interface{}) { + e.mu.Lock() + current := make([]*jsonmessage.JSONMessage, len(e.events)) + copy(current, e.events) + l := e.pub.Subscribe() + e.mu.Unlock() + return current, l +} + +// Evict evicts listener from pubsub +func (e *Events) Evict(l chan interface{}) { + e.pub.Evict(l) +} + +// Log broadcasts event to listeners. Each listener has 100 millisecond for +// receiving event or it will be skipped. +func (e *Events) Log(action, id, from string) { + now := time.Now().UTC() + jm := &jsonmessage.JSONMessage{Status: action, ID: id, From: from, Time: now.Unix(), TimeNano: now.UnixNano()} + e.mu.Lock() + if len(e.events) == cap(e.events) { + // discard oldest event + copy(e.events, e.events[1:]) + e.events[len(e.events)-1] = jm + } else { + e.events = append(e.events, jm) + } + e.mu.Unlock() + e.pub.Publish(jm) +} + +// SubscribersCount returns number of event listeners +func (e *Events) SubscribersCount() int { + return e.pub.Len() +} diff --git a/daemon/events/events_test.go b/daemon/events/events_test.go new file mode 100644 index 0000000000..7aa8d9facc --- /dev/null +++ b/daemon/events/events_test.go @@ -0,0 +1,135 @@ +package events + +import ( + "fmt" + "testing" + "time" + + "github.com/docker/docker/pkg/jsonmessage" +) + +func TestEventsLog(t *testing.T) { + e := New() + _, l1 := e.Subscribe() + _, l2 := e.Subscribe() + defer e.Evict(l1) + defer e.Evict(l2) + count := e.SubscribersCount() + if count != 2 { + t.Fatalf("Must be 2 subscribers, got %d", count) + } + e.Log("test", "cont", "image") + select { + case msg := <-l1: + jmsg, ok := msg.(*jsonmessage.JSONMessage) + if !ok { + t.Fatalf("Unexpected type %T", msg) + } + if len(e.events) != 1 { + t.Fatalf("Must be only one event, got %d", len(e.events)) + } + if jmsg.Status != "test" { + t.Fatalf("Status should be test, got %s", jmsg.Status) + } + if jmsg.ID != "cont" { + t.Fatalf("ID should be cont, got %s", jmsg.ID) + } + if jmsg.From != "image" { + t.Fatalf("From should be image, got %s", jmsg.From) + } + case <-time.After(1 * time.Second): + t.Fatal("Timeout waiting for broadcasted message") + } + select { + case msg := <-l2: + jmsg, ok := msg.(*jsonmessage.JSONMessage) + if !ok { + t.Fatalf("Unexpected type %T", msg) + } + if len(e.events) != 1 { + t.Fatalf("Must be only one event, got %d", len(e.events)) + } + if jmsg.Status != "test" { + t.Fatalf("Status should be test, got %s", jmsg.Status) + } + if jmsg.ID != "cont" { + t.Fatalf("ID should be cont, got %s", jmsg.ID) + } + if jmsg.From != "image" { + t.Fatalf("From should be image, got %s", jmsg.From) + } + case <-time.After(1 * time.Second): + t.Fatal("Timeout waiting for broadcasted message") + } +} + +func TestEventsLogTimeout(t *testing.T) { + e := New() + _, l := e.Subscribe() + defer e.Evict(l) + + c := make(chan struct{}) + go func() { + e.Log("test", "cont", "image") + close(c) + }() + + select { + case <-c: + case <-time.After(time.Second): + t.Fatal("Timeout publishing message") + } +} + +func TestLogEvents(t *testing.T) { + e := New() + + for i := 0; i < eventsLimit+16; i++ { + action := fmt.Sprintf("action_%d", i) + id := fmt.Sprintf("cont_%d", i) + from := fmt.Sprintf("image_%d", i) + e.Log(action, id, from) + } + time.Sleep(50 * time.Millisecond) + current, l := e.Subscribe() + for i := 0; i < 10; i++ { + num := i + eventsLimit + 16 + action := fmt.Sprintf("action_%d", num) + id := fmt.Sprintf("cont_%d", num) + from := fmt.Sprintf("image_%d", num) + e.Log(action, id, from) + } + if len(e.events) != eventsLimit { + t.Fatalf("Must be %d events, got %d", eventsLimit, len(e.events)) + } + + var msgs []*jsonmessage.JSONMessage + for len(msgs) < 10 { + m := <-l + jm, ok := (m).(*jsonmessage.JSONMessage) + if !ok { + t.Fatalf("Unexpected type %T", m) + } + msgs = append(msgs, jm) + } + if len(current) != eventsLimit { + t.Fatalf("Must be %d events, got %d", eventsLimit, len(current)) + } + first := current[0] + if first.Status != "action_16" { + t.Fatalf("First action is %s, must be action_16", first.Status) + } + last := current[len(current)-1] + if last.Status != "action_79" { + t.Fatalf("Last action is %s, must be action_79", last.Status) + } + + firstC := msgs[0] + if firstC.Status != "action_80" { + t.Fatalf("First action is %s, must be action_80", firstC.Status) + } + lastC := msgs[len(msgs)-1] + if lastC.Status != "action_89" { + t.Fatalf("Last action is %s, must be action_89", lastC.Status) + } +} diff --git a/daemon/events/filter.go b/daemon/events/filter.go new file mode 100644 index 0000000000..49bbbe8a05 --- /dev/null +++ b/daemon/events/filter.go @@ -0,0 +1,64 @@ +package events + +import ( + "github.com/docker/docker/pkg/jsonmessage" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/parsers/filters" +) + +// Filter can filter out docker events from a stream +type Filter struct { + filter filters.Args + getLabels func(id string) map[string]string +} + +// NewFilter creates a new Filter +func NewFilter(filter filters.Args, getLabels func(id string) map[string]string) *Filter { + return &Filter{filter: filter, getLabels: getLabels} +} + +// Include returns true when the event ev is included by the filters +func (ef *Filter) Include(ev *jsonmessage.JSONMessage) bool { + return isFieldIncluded(ev.Status, ef.filter["event"]) && + isFieldIncluded(ev.ID, ef.filter["container"]) && + ef.isImageIncluded(ev.ID, ev.From) && + ef.isLabelFieldIncluded(ev.ID) +} + +func (ef *Filter) isLabelFieldIncluded(id string) bool { + if _, ok := ef.filter["label"]; !ok { + return true + } + return ef.filter.MatchKVList("label", ef.getLabels(id)) +} + +// The image filter will be matched against both event.ID (for image events) +// and event.From (for container events), so that any container that was created +// from an image will be included in the image events. Also compare both +// against the stripped repo name without any tags. +func (ef *Filter) isImageIncluded(eventID string, eventFrom string) bool { + stripTag := func(image string) string { + repo, _ := parsers.ParseRepositoryTag(image) + return repo + } + + return isFieldIncluded(eventID, ef.filter["image"]) || + isFieldIncluded(eventFrom, ef.filter["image"]) || + isFieldIncluded(stripTag(eventID), ef.filter["image"]) || + isFieldIncluded(stripTag(eventFrom), ef.filter["image"]) +} + +func isFieldIncluded(field string, filter []string) bool { + if len(field) == 0 { + return true + } + if len(filter) == 0 { + return true + } + for _, v := range filter { + if v == field { + return true + } + } + return false +} diff --git a/daemon/exec.go b/daemon/exec.go new file mode 100644 index 0000000000..2e343bf8f0 --- /dev/null +++ b/daemon/exec.go @@ -0,0 +1,331 @@ +package daemon + +import ( + "io" + "io/ioutil" + "strings" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/broadcaster" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/pools" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/runconfig" +) + +// ExecConfig holds the configurations for execs. The Daemon keeps +// track of both running and finished execs so that they can be +// examined both during and after completion. +type ExecConfig struct { + sync.Mutex + ID string + Running bool + ExitCode int + ProcessConfig *execdriver.ProcessConfig + streamConfig + OpenStdin bool + OpenStderr bool + OpenStdout bool + Container *Container + canRemove bool + + // waitStart will be closed immediately after the exec is really started. + waitStart chan struct{} +} + +type execStore struct { + s map[string]*ExecConfig + sync.RWMutex +} + +func newExecStore() *execStore { + return &execStore{s: make(map[string]*ExecConfig, 0)} +} + +func (e *execStore) Add(id string, ExecConfig *ExecConfig) { + e.Lock() + e.s[id] = ExecConfig + e.Unlock() +} + +func (e *execStore) Get(id string) *ExecConfig { + e.RLock() + res := e.s[id] + e.RUnlock() + return res +} + +func (e *execStore) Delete(id string) { + e.Lock() + delete(e.s, id) + e.Unlock() +} + +func (e *execStore) List() []string { + var IDs []string + e.RLock() + for id := range e.s { + IDs = append(IDs, id) + } + e.RUnlock() + return IDs +} + +func (ExecConfig *ExecConfig) resize(h, w int) error { + select { + case <-ExecConfig.waitStart: + case <-time.After(time.Second): + return derr.ErrorCodeExecResize.WithArgs(ExecConfig.ID) + } + return ExecConfig.ProcessConfig.Terminal.Resize(h, w) +} + +func (d *Daemon) registerExecCommand(ExecConfig *ExecConfig) { + // Storing execs in container in order to kill them gracefully whenever the container is stopped or removed. + ExecConfig.Container.execCommands.Add(ExecConfig.ID, ExecConfig) + // Storing execs in daemon for easy access via remote API. + d.execCommands.Add(ExecConfig.ID, ExecConfig) +} + +// ExecExists looks up the exec instance and returns a bool if it exists or not. +// It will also return the error produced by `getExecConfig` +func (d *Daemon) ExecExists(name string) (bool, error) { + if _, err := d.getExecConfig(name); err != nil { + return false, err + } + return true, nil +} + +// getExecConfig looks up the exec instance by name. If the container associated +// with the exec instance is stopped or paused, it will return an error. +func (d *Daemon) getExecConfig(name string) (*ExecConfig, error) { + ec := d.execCommands.Get(name) + + // If the exec is found but its container is not in the daemon's list of + // containers then it must have been delete, in which case instead of + // saying the container isn't running, we should return a 404 so that + // the user sees the same error now that they will after the + // 5 minute clean-up loop is run which erases old/dead execs. + + if ec != nil && d.containers.Get(ec.Container.ID) != nil { + if !ec.Container.IsRunning() { + return nil, derr.ErrorCodeContainerNotRunning.WithArgs(ec.Container.ID, ec.Container.State.String()) + } + if ec.Container.isPaused() { + return nil, derr.ErrorCodeExecPaused.WithArgs(ec.Container.ID) + } + return ec, nil + } + + return nil, derr.ErrorCodeNoExecID.WithArgs(name) +} + +func (d *Daemon) unregisterExecCommand(ExecConfig *ExecConfig) { + ExecConfig.Container.execCommands.Delete(ExecConfig.ID) + d.execCommands.Delete(ExecConfig.ID) +} + +func (d *Daemon) getActiveContainer(name string) (*Container, error) { + container, err := d.Get(name) + if err != nil { + return nil, err + } + + if !container.IsRunning() { + return nil, derr.ErrorCodeNotRunning.WithArgs(name) + } + if container.isPaused() { + return nil, derr.ErrorCodeExecPaused.WithArgs(name) + } + return container, nil +} + +// ContainerExecCreate sets up an exec in a running container. +func (d *Daemon) ContainerExecCreate(config *runconfig.ExecConfig) (string, error) { + // Not all drivers support Exec (LXC for example) + if err := checkExecSupport(d.execDriver.Name()); err != nil { + return "", err + } + + container, err := d.getActiveContainer(config.Container) + if err != nil { + return "", err + } + + cmd := stringutils.NewStrSlice(config.Cmd...) + entrypoint, args := d.getEntrypointAndArgs(stringutils.NewStrSlice(), cmd) + + user := config.User + if len(user) == 0 { + user = container.Config.User + } + + processConfig := &execdriver.ProcessConfig{ + Tty: config.Tty, + Entrypoint: entrypoint, + Arguments: args, + User: user, + Privileged: config.Privileged, + } + + ExecConfig := &ExecConfig{ + ID: stringid.GenerateNonCryptoID(), + OpenStdin: config.AttachStdin, + OpenStdout: config.AttachStdout, + OpenStderr: config.AttachStderr, + streamConfig: streamConfig{}, + ProcessConfig: processConfig, + Container: container, + Running: false, + waitStart: make(chan struct{}), + } + + d.registerExecCommand(ExecConfig) + + container.logEvent("exec_create: " + ExecConfig.ProcessConfig.Entrypoint + " " + strings.Join(ExecConfig.ProcessConfig.Arguments, " ")) + + return ExecConfig.ID, nil +} + +// ContainerExecStart starts a previously set up exec instance. The +// std streams are set up. +func (d *Daemon) ContainerExecStart(name string, stdin io.ReadCloser, stdout io.Writer, stderr io.Writer) error { + var ( + cStdin io.ReadCloser + cStdout, cStderr io.Writer + ) + + ec, err := d.getExecConfig(name) + if err != nil { + return derr.ErrorCodeNoExecID.WithArgs(name) + } + + ec.Lock() + if ec.Running { + ec.Unlock() + return derr.ErrorCodeExecRunning.WithArgs(ec.ID) + } + ec.Running = true + ec.Unlock() + + logrus.Debugf("starting exec command %s in container %s", ec.ID, ec.Container.ID) + container := ec.Container + container.logEvent("exec_start: " + ec.ProcessConfig.Entrypoint + " " + strings.Join(ec.ProcessConfig.Arguments, " ")) + + if ec.OpenStdin { + r, w := io.Pipe() + go func() { + defer w.Close() + defer logrus.Debugf("Closing buffered stdin pipe") + pools.Copy(w, stdin) + }() + cStdin = r + } + if ec.OpenStdout { + cStdout = stdout + } + if ec.OpenStderr { + cStderr = stderr + } + + ec.streamConfig.stderr = new(broadcaster.Unbuffered) + ec.streamConfig.stdout = new(broadcaster.Unbuffered) + // Attach to stdin + if ec.OpenStdin { + ec.streamConfig.stdin, ec.streamConfig.stdinPipe = io.Pipe() + } else { + ec.streamConfig.stdinPipe = ioutils.NopWriteCloser(ioutil.Discard) // Silently drop stdin + } + + attachErr := attach(&ec.streamConfig, ec.OpenStdin, true, ec.ProcessConfig.Tty, cStdin, cStdout, cStderr) + + execErr := make(chan error) + + // Note, the ExecConfig data will be removed when the container + // itself is deleted. This allows us to query it (for things like + // the exitStatus) even after the cmd is done running. + + go func() { + execErr <- container.exec(ec) + }() + + select { + case err := <-attachErr: + if err != nil { + return derr.ErrorCodeExecAttach.WithArgs(err) + } + return nil + case err := <-execErr: + if aErr := <-attachErr; aErr != nil && err == nil { + return derr.ErrorCodeExecAttach.WithArgs(aErr) + } + if err == nil { + return nil + } + + // Maybe the container stopped while we were trying to exec + if !container.IsRunning() { + return derr.ErrorCodeExecContainerStopped + } + return derr.ErrorCodeExecCantRun.WithArgs(ec.ID, container.ID, err) + } +} + +// Exec calls the underlying exec driver to run +func (d *Daemon) Exec(c *Container, ExecConfig *ExecConfig, pipes *execdriver.Pipes, startCallback execdriver.DriverCallback) (int, error) { + hooks := execdriver.Hooks{ + Start: startCallback, + } + exitStatus, err := d.execDriver.Exec(c.command, ExecConfig.ProcessConfig, pipes, hooks) + + // On err, make sure we don't leave ExitCode at zero + if err != nil && exitStatus == 0 { + exitStatus = 128 + } + + ExecConfig.ExitCode = exitStatus + ExecConfig.Running = false + + return exitStatus, err +} + +// execCommandGC runs a ticker to clean up the daemon references +// of exec configs that are no longer part of the container. +func (d *Daemon) execCommandGC() { + for range time.Tick(5 * time.Minute) { + var ( + cleaned int + liveExecCommands = d.containerExecIds() + ) + for id, config := range d.execCommands.s { + if config.canRemove { + cleaned++ + d.execCommands.Delete(id) + } else { + if _, exists := liveExecCommands[id]; !exists { + config.canRemove = true + } + } + } + if cleaned > 0 { + logrus.Debugf("clean %d unused exec commands", cleaned) + } + } +} + +// containerExecIds returns a list of all the current exec ids that are in use +// and running inside a container. +func (d *Daemon) containerExecIds() map[string]struct{} { + ids := map[string]struct{}{} + for _, c := range d.containers.List() { + for _, id := range c.execCommands.List() { + ids[id] = struct{}{} + } + } + return ids +} diff --git a/daemon/exec_freebsd.go b/daemon/exec_freebsd.go new file mode 100644 index 0000000000..6f1e5e3c1d --- /dev/null +++ b/daemon/exec_freebsd.go @@ -0,0 +1,9 @@ +// +build freebsd + +package daemon + +// checkExecSupport returns an error if the exec driver does not support exec, +// or nil if it is supported. +func checkExecSupport(drivername string) error { + return nil +} diff --git a/daemon/exec_linux.go b/daemon/exec_linux.go new file mode 100644 index 0000000000..a360326327 --- /dev/null +++ b/daemon/exec_linux.go @@ -0,0 +1,18 @@ +// +build linux + +package daemon + +import ( + "strings" + + "github.com/docker/docker/daemon/execdriver/lxc" +) + +// checkExecSupport returns an error if the exec driver does not support exec, +// or nil if it is supported. +func checkExecSupport(drivername string) error { + if strings.HasPrefix(drivername, lxc.DriverName) { + return lxc.ErrExec + } + return nil +} diff --git a/daemon/exec_windows.go b/daemon/exec_windows.go new file mode 100644 index 0000000000..d6f244e6d6 --- /dev/null +++ b/daemon/exec_windows.go @@ -0,0 +1,9 @@ +// +build windows + +package daemon + +// checkExecSupport returns an error if the exec driver does not support exec, +// or nil if it is supported. +func checkExecSupport(DriverName string) error { + return nil +} diff --git a/daemon/execdriver/driver.go b/daemon/execdriver/driver.go new file mode 100644 index 0000000000..e88ea0bde7 --- /dev/null +++ b/daemon/execdriver/driver.go @@ -0,0 +1,233 @@ +package execdriver + +import ( + "errors" + "io" + "os/exec" + "time" + + "github.com/docker/docker/pkg/idtools" + // TODO Windows: Factor out ulimit + "github.com/docker/docker/pkg/ulimit" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/configs" +) + +// Context is a generic key value pair that allows +// arbatrary data to be sent +type Context map[string]string + +// Define error messages +var ( + ErrNotRunning = errors.New("Container is not running") + ErrWaitTimeoutReached = errors.New("Wait timeout reached") + ErrDriverAlreadyRegistered = errors.New("A driver already registered this docker init function") + ErrDriverNotFound = errors.New("The requested docker init has not been found") +) + +// DriverCallback defines a callback function which is used in "Run" and "Exec". +// This allows work to be done in the parent process when the child is passing +// through PreStart, Start and PostStop events. +// Callbacks are provided a processConfig pointer and the pid of the child. +// The channel will be used to notify the OOM events. +type DriverCallback func(processConfig *ProcessConfig, pid int, chOOM <-chan struct{}) error + +// Hooks is a struct containing function pointers to callbacks +// used by any execdriver implementation exploiting hooks capabilities +type Hooks struct { + // PreStart is called before container's CMD/ENTRYPOINT is executed + PreStart []DriverCallback + // Start is called after the container's process is full started + Start DriverCallback + // PostStop is called after the container process exits + PostStop []DriverCallback +} + +// Info is driver specific information based on +// processes registered with the driver +type Info interface { + IsRunning() bool +} + +// Terminal represents a pseudo TTY, it is for when +// using a container interactively. +type Terminal interface { + io.Closer + Resize(height, width int) error +} + +// ExitStatus provides exit reasons for a container. +type ExitStatus struct { + // The exit code with which the container exited. + ExitCode int + + // Whether the container encountered an OOM. + OOMKilled bool +} + +// Driver is an interface for drivers to implement +// including all basic functions a driver should have +type Driver interface { + // Run executes the process, blocks until the process exits and returns + // the exit code. It's the last stage on Docker side for running a container. + Run(c *Command, pipes *Pipes, hooks Hooks) (ExitStatus, error) + + // Exec executes the process in an existing container, blocks until the + // process exits and returns the exit code. + Exec(c *Command, processConfig *ProcessConfig, pipes *Pipes, hooks Hooks) (int, error) + + // Kill sends signals to process in container. + Kill(c *Command, sig int) error + + // Pause pauses a container. + Pause(c *Command) error + + // Unpause unpauses a container. + Unpause(c *Command) error + + // Name returns the name of the driver. + Name() string + + // Info returns the configuration stored in the driver struct, + // "temporary" hack (until we move state from core to plugins). + Info(id string) Info + + // GetPidsForContainer returns a list of pid for the processes running in a container. + GetPidsForContainer(id string) ([]int, error) + + // Terminate kills a container by sending signal SIGKILL. + Terminate(c *Command) error + + // Clean removes all traces of container exec. + Clean(id string) error + + // Stats returns resource stats for a running container + Stats(id string) (*ResourceStats, error) + + // SupportsHooks refers to the driver capability to exploit pre/post hook functionality + SupportsHooks() bool +} + +// Ipc settings of the container +// It is for IPC namespace setting. Usually different containers +// have their own IPC namespace, however this specifies to use +// an existing IPC namespace. +// You can join the host's or a container's IPC namespace. +type Ipc struct { + ContainerID string `json:"container_id"` // id of the container to join ipc. + HostIpc bool `json:"host_ipc"` +} + +// Pid settings of the container +// It is for PID namespace setting. Usually different containers +// have their own PID namespace, however this specifies to use +// an existing PID namespace. +// Joining the host's PID namespace is currently the only supported +// option. +type Pid struct { + HostPid bool `json:"host_pid"` +} + +// UTS settings of the container +// It is for UTS namespace setting. Usually different containers +// have their own UTS namespace, however this specifies to use +// an existing UTS namespace. +// Joining the host's UTS namespace is currently the only supported +// option. +type UTS struct { + HostUTS bool `json:"host_uts"` +} + +// Resources contains all resource configs for a driver. +// Currently these are all for cgroup configs. +// TODO Windows: Factor out ulimit.Rlimit +type Resources struct { + Memory int64 `json:"memory"` + MemorySwap int64 `json:"memory_swap"` + MemoryReservation int64 `json:"memory_reservation"` + KernelMemory int64 `json:"kernel_memory"` + CPUShares int64 `json:"cpu_shares"` + CpusetCpus string `json:"cpuset_cpus"` + CpusetMems string `json:"cpuset_mems"` + CPUPeriod int64 `json:"cpu_period"` + CPUQuota int64 `json:"cpu_quota"` + BlkioWeight uint16 `json:"blkio_weight"` + Rlimits []*ulimit.Rlimit `json:"rlimits"` + OomKillDisable bool `json:"oom_kill_disable"` + MemorySwappiness int64 `json:"memory_swappiness"` +} + +// ResourceStats contains information about resource usage by a container. +type ResourceStats struct { + *libcontainer.Stats + Read time.Time `json:"read"` + MemoryLimit int64 `json:"memory_limit"` + SystemUsage uint64 `json:"system_usage"` +} + +// Mount contains information for a mount operation. +type Mount struct { + Source string `json:"source"` + Destination string `json:"destination"` + Writable bool `json:"writable"` + Private bool `json:"private"` + Slave bool `json:"slave"` +} + +// User contains the uid and gid representing a Unix user +type User struct { + UID int `json:"root_uid"` + GID int `json:"root_gid"` +} + +// ProcessConfig describes a process that will be run inside a container. +type ProcessConfig struct { + exec.Cmd `json:"-"` + + Privileged bool `json:"privileged"` + User string `json:"user"` + Tty bool `json:"tty"` + Entrypoint string `json:"entrypoint"` + Arguments []string `json:"arguments"` + Terminal Terminal `json:"-"` // standard or tty terminal + Console string `json:"-"` // dev/console path + ConsoleSize [2]int `json:"-"` // h,w of initial console size +} + +// Command wraps an os/exec.Cmd to add more metadata +// +// TODO Windows: Factor out unused fields such as LxcConfig, AppArmorProfile, +// and CgroupParent. +type Command struct { + ID string `json:"id"` + Rootfs string `json:"rootfs"` // root fs of the container + ReadonlyRootfs bool `json:"readonly_rootfs"` + InitPath string `json:"initpath"` // dockerinit + WorkingDir string `json:"working_dir"` + ConfigPath string `json:"config_path"` // this should be able to be removed when the lxc template is moved into the driver + Network *Network `json:"network"` + Ipc *Ipc `json:"ipc"` + Pid *Pid `json:"pid"` + UTS *UTS `json:"uts"` + RemappedRoot *User `json:"remap_root"` + UIDMapping []idtools.IDMap `json:"uidmapping"` + GIDMapping []idtools.IDMap `json:"gidmapping"` + Resources *Resources `json:"resources"` + Mounts []Mount `json:"mounts"` + AllowedDevices []*configs.Device `json:"allowed_devices"` + AutoCreatedDevices []*configs.Device `json:"autocreated_devices"` + CapAdd []string `json:"cap_add"` + CapDrop []string `json:"cap_drop"` + GroupAdd []string `json:"group_add"` + ContainerPid int `json:"container_pid"` // the pid for the process inside a container + ProcessConfig ProcessConfig `json:"process_config"` // Describes the init process of the container. + ProcessLabel string `json:"process_label"` + MountLabel string `json:"mount_label"` + LxcConfig []string `json:"lxc_config"` + AppArmorProfile string `json:"apparmor_profile"` + CgroupParent string `json:"cgroup_parent"` // The parent cgroup for this command. + FirstStart bool `json:"first_start"` + LayerPaths []string `json:"layer_paths"` // Windows needs to know the layer paths and folder for a command + LayerFolder string `json:"layer_folder"` + Hostname string `json:"hostname"` // Windows sets the hostname in the execdriver +} diff --git a/daemon/execdriver/driver_unix.go b/daemon/execdriver/driver_unix.go new file mode 100644 index 0000000000..3baa3e0965 --- /dev/null +++ b/daemon/execdriver/driver_unix.go @@ -0,0 +1,177 @@ +// +build !windows + +package execdriver + +import ( + "encoding/json" + "io/ioutil" + "os" + "path/filepath" + "strconv" + "strings" + "time" + + "github.com/docker/docker/daemon/execdriver/native/template" + "github.com/docker/docker/pkg/mount" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/cgroups/fs" + "github.com/opencontainers/runc/libcontainer/configs" +) + +// Network settings of the container +type Network struct { + Mtu int `json:"mtu"` + ContainerID string `json:"container_id"` // id of the container to join network. + NamespacePath string `json:"namespace_path"` + HostNetworking bool `json:"host_networking"` +} + +// InitContainer is the initialization of a container config. +// It returns the initial configs for a container. It's mostly +// defined by the default template. +func InitContainer(c *Command) *configs.Config { + container := template.New() + + container.Hostname = getEnv("HOSTNAME", c.ProcessConfig.Env) + container.Cgroups.Name = c.ID + container.Cgroups.AllowedDevices = c.AllowedDevices + container.Devices = c.AutoCreatedDevices + container.Rootfs = c.Rootfs + container.Readonlyfs = c.ReadonlyRootfs + container.RootPropagation = mount.RPRIVATE + + // check to see if we are running in ramdisk to disable pivot root + container.NoPivotRoot = os.Getenv("DOCKER_RAMDISK") != "" + + // Default parent cgroup is "docker". Override if required. + if c.CgroupParent != "" { + container.Cgroups.Parent = c.CgroupParent + } + return container +} + +func getEnv(key string, env []string) string { + for _, pair := range env { + parts := strings.SplitN(pair, "=", 2) + if parts[0] == key { + return parts[1] + } + } + return "" +} + +// SetupCgroups setups cgroup resources for a container. +func SetupCgroups(container *configs.Config, c *Command) error { + if c.Resources != nil { + container.Cgroups.CpuShares = c.Resources.CPUShares + container.Cgroups.Memory = c.Resources.Memory + container.Cgroups.MemoryReservation = c.Resources.MemoryReservation + container.Cgroups.MemorySwap = c.Resources.MemorySwap + container.Cgroups.CpusetCpus = c.Resources.CpusetCpus + container.Cgroups.CpusetMems = c.Resources.CpusetMems + container.Cgroups.CpuPeriod = c.Resources.CPUPeriod + container.Cgroups.CpuQuota = c.Resources.CPUQuota + container.Cgroups.BlkioWeight = c.Resources.BlkioWeight + container.Cgroups.OomKillDisable = c.Resources.OomKillDisable + container.Cgroups.MemorySwappiness = c.Resources.MemorySwappiness + } + + return nil +} + +// Returns the network statistics for the network interfaces represented by the NetworkRuntimeInfo. +func getNetworkInterfaceStats(interfaceName string) (*libcontainer.NetworkInterface, error) { + out := &libcontainer.NetworkInterface{Name: interfaceName} + // This can happen if the network runtime information is missing - possible if the + // container was created by an old version of libcontainer. + if interfaceName == "" { + return out, nil + } + type netStatsPair struct { + // Where to write the output. + Out *uint64 + // The network stats file to read. + File string + } + // Ingress for host veth is from the container. Hence tx_bytes stat on the host veth is actually number of bytes received by the container. + netStats := []netStatsPair{ + {Out: &out.RxBytes, File: "tx_bytes"}, + {Out: &out.RxPackets, File: "tx_packets"}, + {Out: &out.RxErrors, File: "tx_errors"}, + {Out: &out.RxDropped, File: "tx_dropped"}, + + {Out: &out.TxBytes, File: "rx_bytes"}, + {Out: &out.TxPackets, File: "rx_packets"}, + {Out: &out.TxErrors, File: "rx_errors"}, + {Out: &out.TxDropped, File: "rx_dropped"}, + } + for _, netStat := range netStats { + data, err := readSysfsNetworkStats(interfaceName, netStat.File) + if err != nil { + return nil, err + } + *(netStat.Out) = data + } + return out, nil +} + +// Reads the specified statistics available under /sys/class/net//statistics +func readSysfsNetworkStats(ethInterface, statsFile string) (uint64, error) { + data, err := ioutil.ReadFile(filepath.Join("/sys/class/net", ethInterface, "statistics", statsFile)) + if err != nil { + return 0, err + } + return strconv.ParseUint(strings.TrimSpace(string(data)), 10, 64) +} + +// Stats collects all the resource usage information from a container. +func Stats(containerDir string, containerMemoryLimit int64, machineMemory int64) (*ResourceStats, error) { + f, err := os.Open(filepath.Join(containerDir, "state.json")) + if err != nil { + return nil, err + } + defer f.Close() + + type network struct { + Type string + HostInterfaceName string + } + + state := struct { + CgroupPaths map[string]string `json:"cgroup_paths"` + Networks []network + }{} + + if err := json.NewDecoder(f).Decode(&state); err != nil { + return nil, err + } + now := time.Now() + + mgr := fs.Manager{Paths: state.CgroupPaths} + cstats, err := mgr.GetStats() + if err != nil { + return nil, err + } + stats := &libcontainer.Stats{CgroupStats: cstats} + // if the container does not have any memory limit specified set the + // limit to the machines memory + memoryLimit := containerMemoryLimit + if memoryLimit == 0 { + memoryLimit = machineMemory + } + for _, iface := range state.Networks { + switch iface.Type { + case "veth": + istats, err := getNetworkInterfaceStats(iface.HostInterfaceName) + if err != nil { + return nil, err + } + stats.Interfaces = append(stats.Interfaces, istats) + } + } + return &ResourceStats{ + Stats: stats, + Read: now, + MemoryLimit: memoryLimit, + }, nil +} diff --git a/daemon/execdriver/driver_windows.go b/daemon/execdriver/driver_windows.go new file mode 100644 index 0000000000..08568bc242 --- /dev/null +++ b/daemon/execdriver/driver_windows.go @@ -0,0 +1,20 @@ +package execdriver + +import "github.com/docker/docker/pkg/nat" + +// Network settings of the container +type Network struct { + Interface *NetworkInterface `json:"interface"` + ContainerID string `json:"container_id"` // id of the container to join network. +} + +// NetworkInterface contains network configs for a driver +type NetworkInterface struct { + MacAddress string `json:"mac"` + Bridge string `json:"bridge"` + IPAddress string `json:"ip"` + + // PortBindings is the port mapping between the exposed port in the + // container and the port on the host. + PortBindings nat.PortMap `json:"port_bindings"` +} diff --git a/daemon/execdriver/execdrivers/execdrivers_freebsd.go b/daemon/execdriver/execdrivers/execdrivers_freebsd.go new file mode 100644 index 0000000000..ffb463cefd --- /dev/null +++ b/daemon/execdriver/execdrivers/execdrivers_freebsd.go @@ -0,0 +1,19 @@ +// +build freebsd + +package execdrivers + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/pkg/sysinfo" +) + +// NewDriver returns a new execdriver.Driver from the given name configured with the provided options. +func NewDriver(name string, options []string, root, libPath, initPath string, sysInfo *sysinfo.SysInfo) (execdriver.Driver, error) { + switch name { + case "jail": + return nil, fmt.Errorf("jail driver not yet supported on FreeBSD") + } + return nil, fmt.Errorf("unknown exec driver %s", name) +} diff --git a/daemon/execdriver/execdrivers/execdrivers_linux.go b/daemon/execdriver/execdrivers/execdrivers_linux.go new file mode 100644 index 0000000000..f4785a64f2 --- /dev/null +++ b/daemon/execdriver/execdrivers/execdrivers_linux.go @@ -0,0 +1,29 @@ +// +build linux + +package execdrivers + +import ( + "fmt" + "path" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/daemon/execdriver/lxc" + "github.com/docker/docker/daemon/execdriver/native" + "github.com/docker/docker/pkg/sysinfo" +) + +// NewDriver returns a new execdriver.Driver from the given name configured with the provided options. +func NewDriver(name string, options []string, root, libPath, initPath string, sysInfo *sysinfo.SysInfo) (execdriver.Driver, error) { + switch name { + case "lxc": + // we want to give the lxc driver the full docker root because it needs + // to access and write config and template files in /var/lib/docker/containers/* + // to be backwards compatible + logrus.Warn("LXC built-in support is deprecated.") + return lxc.NewDriver(root, libPath, initPath, sysInfo.AppArmor) + case "native": + return native.NewDriver(path.Join(root, "execdriver", "native"), initPath, options) + } + return nil, fmt.Errorf("unknown exec driver %s", name) +} diff --git a/daemon/execdriver/execdrivers/execdrivers_windows.go b/daemon/execdriver/execdrivers/execdrivers_windows.go new file mode 100644 index 0000000000..a043ff7b0b --- /dev/null +++ b/daemon/execdriver/execdrivers/execdrivers_windows.go @@ -0,0 +1,20 @@ +// +build windows + +package execdrivers + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/daemon/execdriver/windows" + "github.com/docker/docker/pkg/sysinfo" +) + +// NewDriver returns a new execdriver.Driver from the given name configured with the provided options. +func NewDriver(name string, options []string, root, libPath, initPath string, sysInfo *sysinfo.SysInfo) (execdriver.Driver, error) { + switch name { + case "windows": + return windows.NewDriver(root, initPath, options) + } + return nil, fmt.Errorf("unknown exec driver %s", name) +} diff --git a/daemon/execdriver/lxc/driver.go b/daemon/execdriver/lxc/driver.go new file mode 100644 index 0000000000..12793bd01f --- /dev/null +++ b/daemon/execdriver/lxc/driver.go @@ -0,0 +1,906 @@ +// +build linux + +package lxc + +import ( + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "os/exec" + "path" + "path/filepath" + "runtime" + "strconv" + "strings" + "sync" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/pkg/stringutils" + sysinfo "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/pkg/version" + "github.com/kr/pty" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/cgroups" + "github.com/opencontainers/runc/libcontainer/configs" + "github.com/opencontainers/runc/libcontainer/system" + "github.com/opencontainers/runc/libcontainer/user" + "github.com/vishvananda/netns" +) + +// DriverName for lxc driver +const DriverName = "lxc" + +// ErrExec defines unsupported error message +var ErrExec = errors.New("Unsupported: Exec is not supported by the lxc driver") + +// Driver contains all information for lxc driver, +// it implements execdriver.Driver +type Driver struct { + root string // root path for the driver to use + libPath string + initPath string + apparmor bool + sharedRoot bool + activeContainers map[string]*activeContainer + machineMemory int64 + sync.Mutex +} + +type activeContainer struct { + container *configs.Config + cmd *exec.Cmd +} + +// NewDriver returns a new lxc driver, called from NewDriver of execdriver +func NewDriver(root, libPath, initPath string, apparmor bool) (*Driver, error) { + if err := os.MkdirAll(root, 0700); err != nil { + return nil, err + } + // setup unconfined symlink + if err := linkLxcStart(root); err != nil { + return nil, err + } + meminfo, err := sysinfo.ReadMemInfo() + if err != nil { + return nil, err + } + return &Driver{ + apparmor: apparmor, + root: root, + libPath: libPath, + initPath: initPath, + sharedRoot: rootIsShared(), + activeContainers: make(map[string]*activeContainer), + machineMemory: meminfo.MemTotal, + }, nil +} + +// Name implements the exec driver Driver interface. +func (d *Driver) Name() string { + version := d.version() + return fmt.Sprintf("%s-%s", DriverName, version) +} + +func setupNetNs(nsPath string) (*os.Process, error) { + runtime.LockOSThread() + defer runtime.UnlockOSThread() + + origns, err := netns.Get() + if err != nil { + return nil, err + } + defer origns.Close() + + f, err := os.OpenFile(nsPath, os.O_RDONLY, 0) + if err != nil { + return nil, fmt.Errorf("failed to get network namespace %q: %v", nsPath, err) + } + defer f.Close() + + nsFD := f.Fd() + if err := netns.Set(netns.NsHandle(nsFD)); err != nil { + return nil, fmt.Errorf("failed to set network namespace %q: %v", nsPath, err) + } + defer netns.Set(origns) + + cmd := exec.Command("/bin/sh", "-c", "while true; do sleep 1; done") + if err := cmd.Start(); err != nil { + return nil, fmt.Errorf("failed to start netns process: %v", err) + } + + return cmd.Process, nil +} + +func killNetNsProc(proc *os.Process) { + proc.Kill() + proc.Wait() +} + +// Run implements the exec driver Driver interface, +// it calls 'exec.Cmd' to launch lxc commands to run a container. +func (d *Driver) Run(c *execdriver.Command, pipes *execdriver.Pipes, hooks execdriver.Hooks) (execdriver.ExitStatus, error) { + var ( + term execdriver.Terminal + err error + dataPath = d.containerDir(c.ID) + ) + + if c.Network == nil || (c.Network.NamespacePath == "" && c.Network.ContainerID == "") { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("empty namespace path for non-container network") + } + + container, err := d.createContainer(c) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + if c.ProcessConfig.Tty { + term, err = NewTtyConsole(&c.ProcessConfig, pipes) + } else { + term, err = execdriver.NewStdConsole(&c.ProcessConfig, pipes) + } + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + c.ProcessConfig.Terminal = term + + d.Lock() + d.activeContainers[c.ID] = &activeContainer{ + container: container, + cmd: &c.ProcessConfig.Cmd, + } + d.Unlock() + + c.Mounts = append(c.Mounts, execdriver.Mount{ + Source: d.initPath, + Destination: c.InitPath, + Writable: false, + Private: true, + }) + + if err := d.generateEnvConfig(c); err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + configPath, err := d.generateLXCConfig(c) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + params := []string{ + "lxc-start", + "-n", c.ID, + "-f", configPath, + "-q", + } + + // From lxc>=1.1 the default behavior is to daemonize containers after start + lxcVersion := version.Version(d.version()) + if lxcVersion.GreaterThanOrEqualTo(version.Version("1.1")) { + params = append(params, "-F") + } + + proc := &os.Process{} + if c.Network.ContainerID != "" { + params = append(params, + "--share-net", c.Network.ContainerID, + ) + } else { + proc, err = setupNetNs(c.Network.NamespacePath) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + pidStr := fmt.Sprintf("%d", proc.Pid) + params = append(params, + "--share-net", pidStr) + } + if c.Ipc != nil { + if c.Ipc.ContainerID != "" { + params = append(params, + "--share-ipc", c.Ipc.ContainerID, + ) + } else if c.Ipc.HostIpc { + params = append(params, + "--share-ipc", "1", + ) + } + } + + params = append(params, + "--", + c.InitPath, + ) + + if c.ProcessConfig.User != "" { + params = append(params, "-u", c.ProcessConfig.User) + } + + if c.ProcessConfig.Privileged { + if d.apparmor { + params[0] = path.Join(d.root, "lxc-start-unconfined") + + } + params = append(params, "-privileged") + } + + if c.WorkingDir != "" { + params = append(params, "-w", c.WorkingDir) + } + + params = append(params, "--", c.ProcessConfig.Entrypoint) + params = append(params, c.ProcessConfig.Arguments...) + + if d.sharedRoot { + // lxc-start really needs / to be non-shared, or all kinds of stuff break + // when lxc-start unmount things and those unmounts propagate to the main + // mount namespace. + // What we really want is to clone into a new namespace and then + // mount / MS_REC|MS_SLAVE, but since we can't really clone or fork + // without exec in go we have to do this horrible shell hack... + shellString := + "mount --make-rslave /; exec " + + stringutils.ShellQuoteArguments(params) + + params = []string{ + "unshare", "-m", "--", "/bin/sh", "-c", shellString, + } + } + logrus.Debugf("lxc params %s", params) + var ( + name = params[0] + arg = params[1:] + ) + aname, err := exec.LookPath(name) + if err != nil { + aname = name + } + c.ProcessConfig.Path = aname + c.ProcessConfig.Args = append([]string{name}, arg...) + + if err := createDeviceNodes(c.Rootfs, c.AutoCreatedDevices); err != nil { + killNetNsProc(proc) + return execdriver.ExitStatus{ExitCode: -1}, err + } + + if err := c.ProcessConfig.Start(); err != nil { + killNetNsProc(proc) + return execdriver.ExitStatus{ExitCode: -1}, err + } + + var ( + waitErr error + waitLock = make(chan struct{}) + ) + + go func() { + if err := c.ProcessConfig.Wait(); err != nil { + if _, ok := err.(*exec.ExitError); !ok { // Do not propagate the error if it's simply a status code != 0 + waitErr = err + } + } + close(waitLock) + }() + + terminate := func(terr error) (execdriver.ExitStatus, error) { + if c.ProcessConfig.Process != nil { + c.ProcessConfig.Process.Kill() + c.ProcessConfig.Wait() + } + return execdriver.ExitStatus{ExitCode: -1}, terr + } + // Poll lxc for RUNNING status + pid, err := d.waitForStart(c, waitLock) + if err != nil { + killNetNsProc(proc) + return terminate(err) + } + killNetNsProc(proc) + + cgroupPaths, err := cgroupPaths(c.ID) + if err != nil { + return terminate(err) + } + + state := &libcontainer.State{ + InitProcessPid: pid, + CgroupPaths: cgroupPaths, + } + + f, err := os.Create(filepath.Join(dataPath, "state.json")) + if err != nil { + return terminate(err) + } + defer f.Close() + + if err := json.NewEncoder(f).Encode(state); err != nil { + return terminate(err) + } + + c.ContainerPid = pid + + if hooks.Start != nil { + logrus.Debugf("Invoking startCallback") + chOOM := make(chan struct{}) + close(chOOM) + hooks.Start(&c.ProcessConfig, pid, chOOM) + } + + oomKillNotification := notifyChannelOOM(cgroupPaths) + + <-waitLock + exitCode := getExitCode(c) + + _, oomKill := <-oomKillNotification + logrus.Debugf("oomKill error: %v, waitErr: %v", oomKill, waitErr) + + // check oom error + if oomKill { + exitCode = 137 + } + + return execdriver.ExitStatus{ExitCode: exitCode, OOMKilled: oomKill}, waitErr +} + +func notifyChannelOOM(paths map[string]string) <-chan struct{} { + oom, err := notifyOnOOM(paths) + if err != nil { + logrus.Warnf("Your kernel does not support OOM notifications: %s", err) + c := make(chan struct{}) + close(c) + return c + } + return oom +} + +// copy from libcontainer +func notifyOnOOM(paths map[string]string) (<-chan struct{}, error) { + dir := paths["memory"] + if dir == "" { + return nil, fmt.Errorf("There is no path for %q in state", "memory") + } + oomControl, err := os.Open(filepath.Join(dir, "memory.oom_control")) + if err != nil { + return nil, err + } + fd, _, syserr := syscall.RawSyscall(syscall.SYS_EVENTFD2, 0, syscall.FD_CLOEXEC, 0) + if syserr != 0 { + oomControl.Close() + return nil, syserr + } + + eventfd := os.NewFile(fd, "eventfd") + + eventControlPath := filepath.Join(dir, "cgroup.event_control") + data := fmt.Sprintf("%d %d", eventfd.Fd(), oomControl.Fd()) + if err := ioutil.WriteFile(eventControlPath, []byte(data), 0700); err != nil { + eventfd.Close() + oomControl.Close() + return nil, err + } + ch := make(chan struct{}) + go func() { + defer func() { + close(ch) + eventfd.Close() + oomControl.Close() + }() + buf := make([]byte, 8) + for { + if _, err := eventfd.Read(buf); err != nil { + logrus.Warn(err) + return + } + // When a cgroup is destroyed, an event is sent to eventfd. + // So if the control path is gone, return instead of notifying. + if _, err := os.Lstat(eventControlPath); os.IsNotExist(err) { + logrus.Warn(err) + return + } + ch <- struct{}{} + } + }() + return ch, nil +} + +// createContainer populates and configures the container type with the +// data provided by the execdriver.Command +func (d *Driver) createContainer(c *execdriver.Command) (*configs.Config, error) { + container := execdriver.InitContainer(c) + if err := execdriver.SetupCgroups(container, c); err != nil { + return nil, err + } + return container, nil +} + +// Return an map of susbystem -> absolute container cgroup path +func cgroupPaths(containerID string) (map[string]string, error) { + subsystems, err := cgroups.GetAllSubsystems() + if err != nil { + return nil, err + } + logrus.Debugf("subsystems: %s", subsystems) + paths := make(map[string]string) + for _, subsystem := range subsystems { + cgroupRoot, cgroupDir, err := findCgroupRootAndDir(subsystem) + logrus.Debugf("cgroup path %s %s", cgroupRoot, cgroupDir) + if err != nil { + //unsupported subystem + continue + } + // if we are running dind + dockerPathIdx := strings.LastIndex(cgroupDir, "docker") + if dockerPathIdx != -1 { + cgroupDir = cgroupDir[:dockerPathIdx-1] + } + path := filepath.Join(cgroupRoot, cgroupDir, "lxc", containerID) + paths[subsystem] = path + } + + return paths, nil +} + +// this is copy from old libcontainer nodes.go +func createDeviceNodes(rootfs string, nodesToCreate []*configs.Device) error { + oldMask := syscall.Umask(0000) + defer syscall.Umask(oldMask) + + for _, node := range nodesToCreate { + if err := createDeviceNode(rootfs, node); err != nil { + return err + } + } + return nil +} + +// Creates the device node in the rootfs of the container. +func createDeviceNode(rootfs string, node *configs.Device) error { + var ( + dest = filepath.Join(rootfs, node.Path) + parent = filepath.Dir(dest) + ) + + if err := os.MkdirAll(parent, 0755); err != nil { + return err + } + + fileMode := node.FileMode + switch node.Type { + case 'c': + fileMode |= syscall.S_IFCHR + case 'b': + fileMode |= syscall.S_IFBLK + default: + return fmt.Errorf("%c is not a valid device type for device %s", node.Type, node.Path) + } + + if err := syscall.Mknod(dest, uint32(fileMode), node.Mkdev()); err != nil && !os.IsExist(err) { + return fmt.Errorf("mknod %s %s", node.Path, err) + } + + if err := syscall.Chown(dest, int(node.Uid), int(node.Gid)); err != nil { + return fmt.Errorf("chown %s to %d:%d", node.Path, node.Uid, node.Gid) + } + + return nil +} + +// setupUser changes the groups, gid, and uid for the user inside the container +// copy from libcontainer, cause not it's private +func setupUser(userSpec string) error { + // Set up defaults. + defaultExecUser := user.ExecUser{ + Uid: syscall.Getuid(), + Gid: syscall.Getgid(), + Home: "/", + } + passwdPath, err := user.GetPasswdPath() + if err != nil { + return err + } + groupPath, err := user.GetGroupPath() + if err != nil { + return err + } + execUser, err := user.GetExecUserPath(userSpec, &defaultExecUser, passwdPath, groupPath) + if err != nil { + return err + } + if err := syscall.Setgroups(execUser.Sgids); err != nil { + return err + } + if err := system.Setgid(execUser.Gid); err != nil { + return err + } + if err := system.Setuid(execUser.Uid); err != nil { + return err + } + // if we didn't get HOME already, set it based on the user's HOME + if envHome := os.Getenv("HOME"); envHome == "" { + if err := os.Setenv("HOME", execUser.Home); err != nil { + return err + } + } + return nil +} + +// getExitCode returns the exit code of the process. +// If the process has not exited -1 will be returned. +func getExitCode(c *execdriver.Command) int { + if c.ProcessConfig.ProcessState == nil { + return -1 + } + return c.ProcessConfig.ProcessState.Sys().(syscall.WaitStatus).ExitStatus() +} + +// Kill implements the exec driver Driver interface. +func (d *Driver) Kill(c *execdriver.Command, sig int) error { + if sig == 9 || c.ProcessConfig.Process == nil { + return killLxc(c.ID, sig) + } + + return c.ProcessConfig.Process.Signal(syscall.Signal(sig)) +} + +// Pause implements the exec driver Driver interface, +// it executes lxc-freeze to pause a container. +func (d *Driver) Pause(c *execdriver.Command) error { + _, err := exec.LookPath("lxc-freeze") + if err == nil { + output, errExec := exec.Command("lxc-freeze", "-n", c.ID).CombinedOutput() + if errExec != nil { + return fmt.Errorf("Err: %s Output: %s", errExec, output) + } + } + + return err +} + +// Unpause implements the exec driver Driver interface, +// it executes lxc-unfreeze to unpause a container. +func (d *Driver) Unpause(c *execdriver.Command) error { + _, err := exec.LookPath("lxc-unfreeze") + if err == nil { + output, errExec := exec.Command("lxc-unfreeze", "-n", c.ID).CombinedOutput() + if errExec != nil { + return fmt.Errorf("Err: %s Output: %s", errExec, output) + } + } + + return err +} + +// Terminate implements the exec driver Driver interface. +func (d *Driver) Terminate(c *execdriver.Command) error { + return killLxc(c.ID, 9) +} + +func (d *Driver) version() string { + var ( + version string + output []byte + err error + ) + if _, errPath := exec.LookPath("lxc-version"); errPath == nil { + output, err = exec.Command("lxc-version").CombinedOutput() + } else { + output, err = exec.Command("lxc-start", "--version").CombinedOutput() + } + if err == nil { + version = strings.TrimSpace(string(output)) + if parts := strings.SplitN(version, ":", 2); len(parts) == 2 { + version = strings.TrimSpace(parts[1]) + } + } + return version +} + +func killLxc(id string, sig int) error { + var ( + err error + output []byte + ) + _, err = exec.LookPath("lxc-kill") + if err == nil { + output, err = exec.Command("lxc-kill", "-n", id, strconv.Itoa(sig)).CombinedOutput() + } else { + // lxc-stop does not take arbitrary signals like lxc-kill does + output, err = exec.Command("lxc-stop", "-k", "-n", id).CombinedOutput() + } + if err != nil { + return fmt.Errorf("Err: %s Output: %s", err, output) + } + return nil +} + +// wait for the process to start and return the pid for the process +func (d *Driver) waitForStart(c *execdriver.Command, waitLock chan struct{}) (int, error) { + var ( + err error + output []byte + ) + // We wait for the container to be fully running. + // Timeout after 5 seconds. In case of broken pipe, just retry. + // Note: The container can run and finish correctly before + // the end of this loop + for now := time.Now(); time.Since(now) < 5*time.Second; { + select { + case <-waitLock: + // If the process dies while waiting for it, just return + return -1, nil + default: + } + + output, err = d.getInfo(c.ID) + if err == nil { + info, err := parseLxcInfo(string(output)) + if err != nil { + return -1, err + } + if info.Running { + return info.Pid, nil + } + } + time.Sleep(50 * time.Millisecond) + } + return -1, execdriver.ErrNotRunning +} + +func (d *Driver) getInfo(id string) ([]byte, error) { + return exec.Command("lxc-info", "-n", id).CombinedOutput() +} + +type info struct { + ID string + driver *Driver +} + +func (i *info) IsRunning() bool { + var running bool + + output, err := i.driver.getInfo(i.ID) + if err != nil { + logrus.Errorf("Error getting info for lxc container %s: %s (%s)", i.ID, err, output) + return false + } + if strings.Contains(string(output), "RUNNING") { + running = true + } + return running +} + +// Info implements the exec driver Driver interface. +func (d *Driver) Info(id string) execdriver.Info { + return &info{ + ID: id, + driver: d, + } +} + +func findCgroupRootAndDir(subsystem string) (string, string, error) { + cgroupRoot, err := cgroups.FindCgroupMountpoint(subsystem) + if err != nil { + return "", "", err + } + + cgroupDir, err := cgroups.GetThisCgroupDir(subsystem) + if err != nil { + return "", "", err + } + return cgroupRoot, cgroupDir, nil +} + +// GetPidsForContainer implements the exec driver Driver interface. +func (d *Driver) GetPidsForContainer(id string) ([]int, error) { + pids := []int{} + + // cpu is chosen because it is the only non optional subsystem in cgroups + subsystem := "cpu" + cgroupRoot, cgroupDir, err := findCgroupRootAndDir(subsystem) + if err != nil { + return pids, err + } + + filename := filepath.Join(cgroupRoot, cgroupDir, id, "tasks") + if _, err := os.Stat(filename); os.IsNotExist(err) { + // With more recent lxc versions use, cgroup will be in lxc/ + filename = filepath.Join(cgroupRoot, cgroupDir, "lxc", id, "tasks") + } + + output, err := ioutil.ReadFile(filename) + if err != nil { + return pids, err + } + for _, p := range strings.Split(string(output), "\n") { + if len(p) == 0 { + continue + } + pid, err := strconv.Atoi(p) + if err != nil { + return pids, fmt.Errorf("Invalid pid '%s': %s", p, err) + } + pids = append(pids, pid) + } + return pids, nil +} + +func linkLxcStart(root string) error { + sourcePath, err := exec.LookPath("lxc-start") + if err != nil { + return err + } + targetPath := path.Join(root, "lxc-start-unconfined") + + if _, err := os.Lstat(targetPath); err != nil && !os.IsNotExist(err) { + return err + } else if err == nil { + if err := os.Remove(targetPath); err != nil { + return err + } + } + return os.Symlink(sourcePath, targetPath) +} + +// TODO: This can be moved to the mountinfo reader in the mount pkg +func rootIsShared() bool { + if data, err := ioutil.ReadFile("/proc/self/mountinfo"); err == nil { + for _, line := range strings.Split(string(data), "\n") { + cols := strings.Split(line, " ") + if len(cols) >= 6 && cols[4] == "/" { + return strings.HasPrefix(cols[6], "shared") + } + } + } + + // No idea, probably safe to assume so + return true +} + +func (d *Driver) containerDir(containerID string) string { + return path.Join(d.libPath, "containers", containerID) +} + +func (d *Driver) generateLXCConfig(c *execdriver.Command) (string, error) { + root := path.Join(d.containerDir(c.ID), "config.lxc") + + fo, err := os.Create(root) + if err != nil { + return "", err + } + defer fo.Close() + + if err := lxcTemplateCompiled.Execute(fo, struct { + *execdriver.Command + AppArmor bool + }{ + Command: c, + AppArmor: d.apparmor, + }); err != nil { + return "", err + } + + return root, nil +} + +func (d *Driver) generateEnvConfig(c *execdriver.Command) error { + data, err := json.Marshal(c.ProcessConfig.Env) + if err != nil { + return err + } + p := path.Join(d.libPath, "containers", c.ID, "config.env") + c.Mounts = append(c.Mounts, execdriver.Mount{ + Source: p, + Destination: "/.dockerenv", + Writable: false, + Private: true, + }) + + return ioutil.WriteFile(p, data, 0600) +} + +// Clean implements the exec driver Driver interface, +// it's not implemented by lxc. +func (d *Driver) Clean(id string) error { + return nil +} + +// TtyConsole implements the exec driver Terminal interface, +// it stores the master and slave ends of the container's pty. +type TtyConsole struct { + MasterPty *os.File + SlavePty *os.File +} + +// NewTtyConsole returns a new TtyConsole struct. +// Wired up to the provided process config and stdin/stdout/stderr pipes. +func NewTtyConsole(processConfig *execdriver.ProcessConfig, pipes *execdriver.Pipes) (*TtyConsole, error) { + // lxc is special in that we cannot create the master outside of the container without + // opening the slave because we have nothing to provide to the cmd. We have to open both then do + // the crazy setup on command right now instead of passing the console path to lxc and telling it + // to open up that console. we save a couple of openfiles in the native driver because we can do + // this. + ptyMaster, ptySlave, err := pty.Open() + if err != nil { + return nil, err + } + + tty := &TtyConsole{ + MasterPty: ptyMaster, + SlavePty: ptySlave, + } + + if err := tty.AttachPipes(&processConfig.Cmd, pipes); err != nil { + tty.Close() + return nil, err + } + + processConfig.Console = tty.SlavePty.Name() + + return tty, nil +} + +// Resize implements Resize method of Terminal interface +func (t *TtyConsole) Resize(h, w int) error { + return term.SetWinsize(t.MasterPty.Fd(), &term.Winsize{Height: uint16(h), Width: uint16(w)}) +} + +// AttachPipes attaches given pipes to exec.Cmd +func (t *TtyConsole) AttachPipes(command *exec.Cmd, pipes *execdriver.Pipes) error { + command.Stdout = t.SlavePty + command.Stderr = t.SlavePty + + go func() { + if wb, ok := pipes.Stdout.(interface { + CloseWriters() error + }); ok { + defer wb.CloseWriters() + } + + io.Copy(pipes.Stdout, t.MasterPty) + }() + + if pipes.Stdin != nil { + command.Stdin = t.SlavePty + command.SysProcAttr.Setctty = true + + go func() { + io.Copy(t.MasterPty, pipes.Stdin) + + pipes.Stdin.Close() + }() + } + return nil +} + +// Close implements Close method of Terminal interface +func (t *TtyConsole) Close() error { + t.SlavePty.Close() + return t.MasterPty.Close() +} + +// Exec implements the exec driver Driver interface, +// it is not implemented by lxc. +func (d *Driver) Exec(c *execdriver.Command, processConfig *execdriver.ProcessConfig, pipes *execdriver.Pipes, hooks execdriver.Hooks) (int, error) { + return -1, ErrExec +} + +// Stats implements the exec driver Driver interface. +// Lxc doesn't implement it's own Stats, it does some trick by implementing +// execdriver.Stats to get stats info by libcontainer APIs. +func (d *Driver) Stats(id string) (*execdriver.ResourceStats, error) { + if _, ok := d.activeContainers[id]; !ok { + return nil, fmt.Errorf("%s is not a key in active containers", id) + } + return execdriver.Stats(d.containerDir(id), d.activeContainers[id].container.Cgroups.Memory, d.machineMemory) +} + +// SupportsHooks implements the execdriver Driver interface. +// The LXC execdriver does not support the hook mechanism, which is currently unique to runC/libcontainer. +func (d *Driver) SupportsHooks() bool { + return false +} diff --git a/daemon/execdriver/lxc/info.go b/daemon/execdriver/lxc/info.go new file mode 100644 index 0000000000..3a63091325 --- /dev/null +++ b/daemon/execdriver/lxc/info.go @@ -0,0 +1,53 @@ +// +build linux + +package lxc + +import ( + "bufio" + "errors" + "strconv" + "strings" +) + +// Define error messages +var ( + ErrCannotParse = errors.New("cannot parse raw input") +) + +type lxcInfo struct { + Running bool + Pid int +} + +func parseLxcInfo(raw string) (*lxcInfo, error) { + if raw == "" { + return nil, ErrCannotParse + } + var ( + err error + s = bufio.NewScanner(strings.NewReader(raw)) + info = &lxcInfo{} + ) + for s.Scan() { + text := s.Text() + + if s.Err() != nil { + return nil, s.Err() + } + + parts := strings.Split(text, ":") + if len(parts) < 2 { + continue + } + switch strings.ToLower(strings.TrimSpace(parts[0])) { + case "state": + info.Running = strings.TrimSpace(parts[1]) == "RUNNING" + case "pid": + info.Pid, err = strconv.Atoi(strings.TrimSpace(parts[1])) + if err != nil { + return nil, err + } + } + } + return info, nil +} diff --git a/daemon/execdriver/lxc/info_test.go b/daemon/execdriver/lxc/info_test.go new file mode 100644 index 0000000000..996d56b2a3 --- /dev/null +++ b/daemon/execdriver/lxc/info_test.go @@ -0,0 +1,38 @@ +// +build linux + +package lxc + +import ( + "testing" +) + +func TestParseRunningInfo(t *testing.T) { + raw := ` + state: RUNNING + pid: 50` + + info, err := parseLxcInfo(raw) + if err != nil { + t.Fatal(err) + } + if !info.Running { + t.Fatal("info should return a running state") + } + if info.Pid != 50 { + t.Fatalf("info should have pid 50 got %d", info.Pid) + } +} + +func TestEmptyInfo(t *testing.T) { + _, err := parseLxcInfo("") + if err == nil { + t.Fatal("error should not be nil") + } +} + +func TestBadInfo(t *testing.T) { + _, err := parseLxcInfo("state") + if err != nil { + t.Fatal(err) + } +} diff --git a/daemon/execdriver/lxc/init.go b/daemon/execdriver/lxc/init.go new file mode 100644 index 0000000000..da5d502088 --- /dev/null +++ b/daemon/execdriver/lxc/init.go @@ -0,0 +1,145 @@ +// +build linux + +package lxc + +import ( + "encoding/json" + "flag" + "fmt" + "os" + "os/exec" + "runtime" + "strings" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/reexec" +) + +// InitArgs contains args provided to the init function for a driver +type InitArgs struct { + User string + Gateway string + IP string + WorkDir string + Privileged bool + Env []string + Args []string + Mtu int + Console string + Pipe int + Root string + CapAdd string + CapDrop string +} + +func init() { + // like always lxc requires a hack to get this to work + reexec.Register("/.dockerinit", dockerInititalizer) +} + +func dockerInititalizer() { + initializer() +} + +// initializer is the lxc driver's init function that is run inside the namespace to setup +// additional configurations +func initializer() { + runtime.LockOSThread() + + args := getArgs() + + if err := setupNamespace(args); err != nil { + logrus.Fatal(err) + } +} + +func setupNamespace(args *InitArgs) error { + if err := setupEnv(args); err != nil { + return err + } + + if err := finalizeNamespace(args); err != nil { + return err + } + + path, err := exec.LookPath(args.Args[0]) + if err != nil { + logrus.Infof("Unable to locate %v", args.Args[0]) + os.Exit(127) + } + + if err := syscall.Exec(path, args.Args, os.Environ()); err != nil { + return fmt.Errorf("dockerinit unable to execute %s - %s", path, err) + } + + return nil +} + +func getArgs() *InitArgs { + var ( + // Get cmdline arguments + user = flag.String("u", "", "username or uid") + gateway = flag.String("g", "", "gateway address") + ip = flag.String("i", "", "ip address") + workDir = flag.String("w", "", "workdir") + privileged = flag.Bool("privileged", false, "privileged mode") + mtu = flag.Int("mtu", 1500, "interface mtu") + capAdd = flag.String("cap-add", "", "capabilities to add") + capDrop = flag.String("cap-drop", "", "capabilities to drop") + ) + + flag.Parse() + + return &InitArgs{ + User: *user, + Gateway: *gateway, + IP: *ip, + WorkDir: *workDir, + Privileged: *privileged, + Args: flag.Args(), + Mtu: *mtu, + CapAdd: *capAdd, + CapDrop: *capDrop, + } +} + +// Clear environment pollution introduced by lxc-start +func setupEnv(args *InitArgs) error { + // Get env + var env []string + dockerenv, err := os.Open(".dockerenv") + if err != nil { + return fmt.Errorf("Unable to load environment variables: %v", err) + } + defer dockerenv.Close() + if err := json.NewDecoder(dockerenv).Decode(&env); err != nil { + return fmt.Errorf("Unable to decode environment variables: %v", err) + } + // Propagate the plugin-specific container env variable + env = append(env, "container="+os.Getenv("container")) + + args.Env = env + + os.Clearenv() + for _, kv := range args.Env { + parts := strings.SplitN(kv, "=", 2) + if len(parts) == 1 { + parts = append(parts, "") + } + os.Setenv(parts[0], parts[1]) + } + + return nil +} + +// Setup working directory +func setupWorkingDirectory(args *InitArgs) error { + if args.WorkDir == "" { + return nil + } + if err := syscall.Chdir(args.WorkDir); err != nil { + return fmt.Errorf("Unable to change dir to %v: %v", args.WorkDir, err) + } + return nil +} diff --git a/daemon/execdriver/lxc/lxc_init_linux.go b/daemon/execdriver/lxc/lxc_init_linux.go new file mode 100644 index 0000000000..c63a0cbba0 --- /dev/null +++ b/daemon/execdriver/lxc/lxc_init_linux.go @@ -0,0 +1,22 @@ +// +build linux + +package lxc + +import ( + "fmt" + + "github.com/opencontainers/runc/libcontainer/utils" +) + +func finalizeNamespace(args *InitArgs) error { + if err := utils.CloseExecFrom(3); err != nil { + return err + } + if err := setupUser(args.User); err != nil { + return fmt.Errorf("setup user %s", err) + } + if err := setupWorkingDirectory(args); err != nil { + return err + } + return nil +} diff --git a/daemon/execdriver/lxc/lxc_init_unsupported.go b/daemon/execdriver/lxc/lxc_init_unsupported.go new file mode 100644 index 0000000000..3b7be139bb --- /dev/null +++ b/daemon/execdriver/lxc/lxc_init_unsupported.go @@ -0,0 +1,7 @@ +// +build !linux + +package lxc + +func finalizeNamespace(args *InitArgs) error { + panic("Not supported on this platform") +} diff --git a/daemon/execdriver/lxc/lxc_template.go b/daemon/execdriver/lxc/lxc_template.go new file mode 100644 index 0000000000..6b7996f04c --- /dev/null +++ b/daemon/execdriver/lxc/lxc_template.go @@ -0,0 +1,247 @@ +// +build linux + +package lxc + +import ( + "fmt" + "os" + "strings" + "text/template" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + nativeTemplate "github.com/docker/docker/daemon/execdriver/native/template" + "github.com/docker/docker/pkg/stringutils" + "github.com/opencontainers/runc/libcontainer/label" +) + +// LxcTemplate is the template for lxc driver, it's used +// to configure LXC. +const LxcTemplate = ` +lxc.network.type = none +# root filesystem +{{$ROOTFS := .Rootfs}} +lxc.rootfs = {{$ROOTFS}} + +# use a dedicated pts for the container (and limit the number of pseudo terminal +# available) +lxc.pts = 1024 + +# disable the main console +lxc.console = none + +# no controlling tty at all +lxc.tty = 1 + +{{if .ProcessConfig.Privileged}} +lxc.cgroup.devices.allow = a +{{else}} +# no implicit access to devices +lxc.cgroup.devices.deny = a +#Allow the devices passed to us in the AllowedDevices list. +{{range $allowedDevice := .AllowedDevices}} +lxc.cgroup.devices.allow = {{$allowedDevice.CgroupString}} +{{end}} +{{end}} + +# standard mount point +# Use mnt.putold as per https://bugs.launchpad.net/ubuntu/+source/lxc/+bug/986385 +lxc.pivotdir = lxc_putold + +# lxc.autodev is not compatible with lxc --device switch +lxc.autodev = 0 + +# NOTICE: These mounts must be applied within the namespace +{{if .ProcessConfig.Privileged}} +# WARNING: mounting procfs and/or sysfs read-write is a known attack vector. +# See e.g. http://blog.zx2c4.com/749 and https://bit.ly/T9CkqJ +# We mount them read-write here, but later, dockerinit will call the Restrict() function to remount them read-only. +# We cannot mount them directly read-only, because that would prevent loading AppArmor profiles. +lxc.mount.entry = proc {{escapeFstabSpaces $ROOTFS}}/proc proc nosuid,nodev,noexec 0 0 +lxc.mount.entry = sysfs {{escapeFstabSpaces $ROOTFS}}/sys sysfs nosuid,nodev,noexec 0 0 + {{if .AppArmor}} +lxc.aa_profile = unconfined + {{end}} +{{else}} +# In non-privileged mode, lxc will automatically mount /proc and /sys in readonly mode +# for security. See: http://man7.org/linux/man-pages/man5/lxc.container.conf.5.html +lxc.mount.auto = proc sys + {{if .AppArmorProfile}} +lxc.aa_profile = {{.AppArmorProfile}} + {{end}} +{{end}} + +{{if .ProcessConfig.Tty}} +lxc.mount.entry = {{.ProcessConfig.Console}} {{escapeFstabSpaces $ROOTFS}}/dev/console none bind,rw,create=file 0 0 +{{end}} + +lxc.mount.entry = devpts {{escapeFstabSpaces $ROOTFS}}/dev/pts devpts {{formatMountLabel "newinstance,ptmxmode=0666,nosuid,noexec,create=dir" ""}} 0 0 +lxc.mount.entry = shm {{escapeFstabSpaces $ROOTFS}}/dev/shm tmpfs {{formatMountLabel "size=65536k,nosuid,nodev,noexec,create=dir" ""}} 0 0 + +{{range $value := .Mounts}} +{{$createVal := isDirectory $value.Source}} +{{if $value.Writable}} +lxc.mount.entry = {{$value.Source}} {{escapeFstabSpaces $ROOTFS}}/{{escapeFstabSpaces $value.Destination}} none rbind,rw,create={{$createVal}} 0 0 +{{else}} +lxc.mount.entry = {{$value.Source}} {{escapeFstabSpaces $ROOTFS}}/{{escapeFstabSpaces $value.Destination}} none rbind,ro,create={{$createVal}} 0 0 +{{end}} +{{end}} + +# limits +{{if .Resources}} +{{if .Resources.Memory}} +lxc.cgroup.memory.limit_in_bytes = {{.Resources.Memory}} +{{end}} +{{if gt .Resources.MemorySwap 0}} +lxc.cgroup.memory.memsw.limit_in_bytes = {{.Resources.MemorySwap}} +{{end}} +{{if gt .Resources.MemoryReservation 0}} +lxc.cgroup.memory.soft_limit_in_bytes = {{.Resources.MemoryReservation}} +{{end}} +{{if gt .Resources.KernelMemory 0}} +lxc.cgroup.memory.kmem.limit_in_bytes = {{.Resources.KernelMemory}} +{{end}} +{{if .Resources.CPUShares}} +lxc.cgroup.cpu.shares = {{.Resources.CPUShares}} +{{end}} +{{if .Resources.CPUPeriod}} +lxc.cgroup.cpu.cfs_period_us = {{.Resources.CPUPeriod}} +{{end}} +{{if .Resources.CpusetCpus}} +lxc.cgroup.cpuset.cpus = {{.Resources.CpusetCpus}} +{{end}} +{{if .Resources.CpusetMems}} +lxc.cgroup.cpuset.mems = {{.Resources.CpusetMems}} +{{end}} +{{if .Resources.CPUQuota}} +lxc.cgroup.cpu.cfs_quota_us = {{.Resources.CPUQuota}} +{{end}} +{{if .Resources.BlkioWeight}} +lxc.cgroup.blkio.weight = {{.Resources.BlkioWeight}} +{{end}} +{{if .Resources.OomKillDisable}} +lxc.cgroup.memory.oom_control = {{.Resources.OomKillDisable}} +{{end}} +{{if gt .Resources.MemorySwappiness 0}} +lxc.cgroup.memory.swappiness = {{.Resources.MemorySwappiness}} +{{end}} +{{end}} + +{{if .LxcConfig}} +{{range $value := .LxcConfig}} +lxc.{{$value}} +{{end}} +{{end}} + +{{if .ProcessConfig.Env}} +lxc.utsname = {{getHostname .ProcessConfig.Env}} +{{end}} + +{{if .ProcessConfig.Privileged}} +# No cap values are needed, as lxc is starting in privileged mode +{{else}} + {{ with keepCapabilities .CapAdd .CapDrop }} + {{range .}} +lxc.cap.keep = {{.}} + {{end}} + {{else}} + {{ with dropList .CapDrop }} + {{range .}} +lxc.cap.drop = {{.}} + {{end}} + {{end}} + {{end}} +{{end}} +` + +var lxcTemplateCompiled *template.Template + +// Escape spaces in strings according to the fstab documentation, which is the +// format for "lxc.mount.entry" lines in lxc.conf. See also "man 5 fstab". +func escapeFstabSpaces(field string) string { + return strings.Replace(field, " ", "\\040", -1) +} + +func keepCapabilities(adds []string, drops []string) ([]string, error) { + container := nativeTemplate.New() + logrus.Debugf("adds %s drops %s\n", adds, drops) + caps, err := execdriver.TweakCapabilities(container.Capabilities, adds, drops) + if err != nil { + return nil, err + } + var newCaps []string + for _, cap := range caps { + logrus.Debugf("cap %s\n", cap) + realCap := execdriver.GetCapability(cap) + numCap := fmt.Sprintf("%d", realCap.Value) + newCaps = append(newCaps, numCap) + } + + return newCaps, nil +} + +func dropList(drops []string) ([]string, error) { + if stringutils.InSlice(drops, "all") { + var newCaps []string + for _, capName := range execdriver.GetAllCapabilities() { + cap := execdriver.GetCapability(capName) + logrus.Debugf("drop cap %s\n", cap.Key) + numCap := fmt.Sprintf("%d", cap.Value) + newCaps = append(newCaps, numCap) + } + return newCaps, nil + } + return []string{}, nil +} + +func isDirectory(source string) string { + f, err := os.Stat(source) + logrus.Debugf("dir: %s\n", source) + if err != nil { + if os.IsNotExist(err) { + return "dir" + } + return "" + } + if f.IsDir() { + return "dir" + } + return "file" +} + +func getLabel(c map[string][]string, name string) string { + label := c["label"] + for _, l := range label { + parts := strings.SplitN(l, "=", 2) + if strings.TrimSpace(parts[0]) == name { + return strings.TrimSpace(parts[1]) + } + } + return "" +} + +func getHostname(env []string) string { + for _, kv := range env { + parts := strings.SplitN(kv, "=", 2) + if parts[0] == "HOSTNAME" && len(parts) == 2 { + return parts[1] + } + } + return "" +} + +func init() { + var err error + funcMap := template.FuncMap{ + "escapeFstabSpaces": escapeFstabSpaces, + "formatMountLabel": label.FormatMountLabel, + "isDirectory": isDirectory, + "keepCapabilities": keepCapabilities, + "dropList": dropList, + "getHostname": getHostname, + } + lxcTemplateCompiled, err = template.New("lxc").Funcs(funcMap).Parse(LxcTemplate) + if err != nil { + panic(err) + } +} diff --git a/daemon/execdriver/lxc/lxc_template_unit_test.go b/daemon/execdriver/lxc/lxc_template_unit_test.go new file mode 100644 index 0000000000..01bc3eaef3 --- /dev/null +++ b/daemon/execdriver/lxc/lxc_template_unit_test.go @@ -0,0 +1,343 @@ +// +build linux + +package lxc + +import ( + "bufio" + "fmt" + "io/ioutil" + "math/rand" + "os" + "path" + "strings" + "testing" + "time" + + "github.com/docker/docker/daemon/execdriver" + nativeTemplate "github.com/docker/docker/daemon/execdriver/native/template" + "github.com/opencontainers/runc/libcontainer/configs" + "github.com/syndtr/gocapability/capability" +) + +func TestLXCConfig(t *testing.T) { + root, err := ioutil.TempDir("", "TestLXCConfig") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(root) + + os.MkdirAll(path.Join(root, "containers", "1"), 0777) + + // Memory is allocated randomly for testing + r := rand.New(rand.NewSource(time.Now().UTC().UnixNano())) + var ( + memMin = 33554432 + memMax = 536870912 + mem = memMin + r.Intn(memMax-memMin) + swap = memMax + cpuMin = 100 + cpuMax = 10000 + cpu = cpuMin + r.Intn(cpuMax-cpuMin) + ) + + driver, err := NewDriver(root, root, "", false) + if err != nil { + t.Fatal(err) + } + command := &execdriver.Command{ + ID: "1", + Resources: &execdriver.Resources{ + Memory: int64(mem), + MemorySwap: int64(swap), + CPUShares: int64(cpu), + }, + Network: &execdriver.Network{ + Mtu: 1500, + }, + AllowedDevices: make([]*configs.Device, 0), + ProcessConfig: execdriver.ProcessConfig{}, + } + p, err := driver.generateLXCConfig(command) + if err != nil { + t.Fatal(err) + } + grepFile(t, p, + fmt.Sprintf("lxc.cgroup.memory.limit_in_bytes = %d", mem)) + + grepFile(t, p, + fmt.Sprintf("lxc.cgroup.memory.memsw.limit_in_bytes = %d", swap)) +} + +func TestCustomLxcConfig(t *testing.T) { + root, err := ioutil.TempDir("", "TestCustomLxcConfig") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(root) + + os.MkdirAll(path.Join(root, "containers", "1"), 0777) + + driver, err := NewDriver(root, root, "", false) + if err != nil { + t.Fatal(err) + } + processConfig := execdriver.ProcessConfig{ + Privileged: false, + } + command := &execdriver.Command{ + ID: "1", + LxcConfig: []string{ + "lxc.utsname = docker", + "lxc.cgroup.cpuset.cpus = 0,1", + }, + Network: &execdriver.Network{ + Mtu: 1500, + }, + ProcessConfig: processConfig, + } + + p, err := driver.generateLXCConfig(command) + if err != nil { + t.Fatal(err) + } + + grepFile(t, p, "lxc.utsname = docker") + grepFile(t, p, "lxc.cgroup.cpuset.cpus = 0,1") +} + +func grepFile(t *testing.T, path string, pattern string) { + grepFileWithReverse(t, path, pattern, false) +} + +func grepFileWithReverse(t *testing.T, path string, pattern string, inverseGrep bool) { + f, err := os.Open(path) + if err != nil { + t.Fatal(err) + } + defer f.Close() + r := bufio.NewReader(f) + var ( + line string + ) + err = nil + for err == nil { + line, err = r.ReadString('\n') + if strings.Contains(line, pattern) == true { + if inverseGrep { + t.Fatalf("grepFile: pattern \"%s\" found in \"%s\"", pattern, path) + } + return + } + } + if inverseGrep { + return + } + t.Fatalf("grepFile: pattern \"%s\" not found in \"%s\"", pattern, path) +} + +func TestEscapeFstabSpaces(t *testing.T) { + var testInputs = map[string]string{ + " ": "\\040", + "": "", + "/double space": "/double\\040\\040space", + "/some long test string": "/some\\040long\\040test\\040string", + "/var/lib/docker": "/var/lib/docker", + " leading": "\\040leading", + "trailing ": "trailing\\040", + } + for in, exp := range testInputs { + if out := escapeFstabSpaces(in); exp != out { + t.Logf("Expected %s got %s", exp, out) + t.Fail() + } + } +} + +func TestIsDirectory(t *testing.T) { + tempDir, err := ioutil.TempDir("", "TestIsDir") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tempDir) + + tempFile, err := ioutil.TempFile(tempDir, "TestIsDirFile") + if err != nil { + t.Fatal(err) + } + + if isDirectory(tempDir) != "dir" { + t.Logf("Could not identify %s as a directory", tempDir) + t.Fail() + } + + if isDirectory(tempFile.Name()) != "file" { + t.Logf("Could not identify %s as a file", tempFile.Name()) + t.Fail() + } +} + +func TestCustomLxcConfigMounts(t *testing.T) { + root, err := ioutil.TempDir("", "TestCustomLxcConfig") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(root) + tempDir, err := ioutil.TempDir("", "TestIsDir") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tempDir) + + tempFile, err := ioutil.TempFile(tempDir, "TestIsDirFile") + if err != nil { + t.Fatal(err) + } + os.MkdirAll(path.Join(root, "containers", "1"), 0777) + + driver, err := NewDriver(root, root, "", false) + if err != nil { + t.Fatal(err) + } + processConfig := execdriver.ProcessConfig{ + Privileged: false, + } + mounts := []execdriver.Mount{ + { + Source: tempDir, + Destination: tempDir, + Writable: false, + Private: true, + }, + { + Source: tempFile.Name(), + Destination: tempFile.Name(), + Writable: true, + Private: true, + }, + } + command := &execdriver.Command{ + ID: "1", + LxcConfig: []string{ + "lxc.utsname = docker", + "lxc.cgroup.cpuset.cpus = 0,1", + }, + Network: &execdriver.Network{ + Mtu: 1500, + }, + Mounts: mounts, + ProcessConfig: processConfig, + } + + p, err := driver.generateLXCConfig(command) + if err != nil { + t.Fatal(err) + } + + grepFile(t, p, "lxc.utsname = docker") + grepFile(t, p, "lxc.cgroup.cpuset.cpus = 0,1") + + grepFile(t, p, fmt.Sprintf("lxc.mount.entry = %s %s none rbind,ro,create=%s 0 0", tempDir, "/"+tempDir, "dir")) + grepFile(t, p, fmt.Sprintf("lxc.mount.entry = %s %s none rbind,rw,create=%s 0 0", tempFile.Name(), "/"+tempFile.Name(), "file")) +} + +func TestCustomLxcConfigMisc(t *testing.T) { + root, err := ioutil.TempDir("", "TestCustomLxcConfig") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(root) + os.MkdirAll(path.Join(root, "containers", "1"), 0777) + driver, err := NewDriver(root, root, "", true) + + if err != nil { + t.Fatal(err) + } + processConfig := execdriver.ProcessConfig{ + Privileged: false, + } + + processConfig.Env = []string{"HOSTNAME=testhost"} + command := &execdriver.Command{ + ID: "1", + LxcConfig: []string{ + "lxc.cgroup.cpuset.cpus = 0,1", + }, + Network: &execdriver.Network{ + Mtu: 1500, + }, + ProcessConfig: processConfig, + CapAdd: []string{"net_admin", "syslog"}, + CapDrop: []string{"kill", "mknod"}, + AppArmorProfile: "lxc-container-default-with-nesting", + } + + p, err := driver.generateLXCConfig(command) + if err != nil { + t.Fatal(err) + } + grepFile(t, p, "lxc.aa_profile = lxc-container-default-with-nesting") + // hostname + grepFile(t, p, "lxc.utsname = testhost") + grepFile(t, p, "lxc.cgroup.cpuset.cpus = 0,1") + container := nativeTemplate.New() + for _, cap := range container.Capabilities { + realCap := execdriver.GetCapability(cap) + numCap := fmt.Sprintf("%d", realCap.Value) + if cap != "MKNOD" && cap != "KILL" { + grepFile(t, p, fmt.Sprintf("lxc.cap.keep = %s", numCap)) + } + } + + grepFileWithReverse(t, p, fmt.Sprintf("lxc.cap.keep = %d", capability.CAP_KILL), true) + grepFileWithReverse(t, p, fmt.Sprintf("lxc.cap.keep = %d", capability.CAP_MKNOD), true) +} + +func TestCustomLxcConfigMiscOverride(t *testing.T) { + root, err := ioutil.TempDir("", "TestCustomLxcConfig") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(root) + os.MkdirAll(path.Join(root, "containers", "1"), 0777) + driver, err := NewDriver(root, root, "", false) + if err != nil { + t.Fatal(err) + } + processConfig := execdriver.ProcessConfig{ + Privileged: false, + } + + processConfig.Env = []string{"HOSTNAME=testhost"} + command := &execdriver.Command{ + ID: "1", + LxcConfig: []string{ + "lxc.cgroup.cpuset.cpus = 0,1", + "lxc.network.ipv4 = 172.0.0.1", + }, + Network: &execdriver.Network{ + Mtu: 1500, + }, + ProcessConfig: processConfig, + CapAdd: []string{"NET_ADMIN", "SYSLOG"}, + CapDrop: []string{"KILL", "MKNOD"}, + } + + p, err := driver.generateLXCConfig(command) + if err != nil { + t.Fatal(err) + } + + // hostname + grepFile(t, p, "lxc.utsname = testhost") + grepFile(t, p, "lxc.cgroup.cpuset.cpus = 0,1") + container := nativeTemplate.New() + for _, cap := range container.Capabilities { + realCap := execdriver.GetCapability(cap) + numCap := fmt.Sprintf("%d", realCap.Value) + if cap != "MKNOD" && cap != "KILL" { + grepFile(t, p, fmt.Sprintf("lxc.cap.keep = %s", numCap)) + } + } + grepFileWithReverse(t, p, fmt.Sprintf("lxc.cap.keep = %d", capability.CAP_KILL), true) + grepFileWithReverse(t, p, fmt.Sprintf("lxc.cap.keep = %d", capability.CAP_MKNOD), true) +} diff --git a/daemon/execdriver/native/apparmor.go b/daemon/execdriver/native/apparmor.go new file mode 100644 index 0000000000..3aaba98a34 --- /dev/null +++ b/daemon/execdriver/native/apparmor.go @@ -0,0 +1,142 @@ +// +build linux + +package native + +import ( + "bufio" + "fmt" + "io" + "os" + "os/exec" + "path" + "strings" + "text/template" + + "github.com/opencontainers/runc/libcontainer/apparmor" +) + +const ( + apparmorProfilePath = "/etc/apparmor.d/docker" +) + +type data struct { + Name string + Imports []string + InnerImports []string +} + +const baseTemplate = ` +{{range $value := .Imports}} +{{$value}} +{{end}} + +profile {{.Name}} flags=(attach_disconnected,mediate_deleted) { +{{range $value := .InnerImports}} + {{$value}} +{{end}} + + network, + capability, + file, + umount, + + deny @{PROC}/{*,**^[0-9*],sys/kernel/shm*} wkx, + deny @{PROC}/sysrq-trigger rwklx, + deny @{PROC}/mem rwklx, + deny @{PROC}/kmem rwklx, + deny @{PROC}/kcore rwklx, + + deny mount, + + deny /sys/[^f]*/** wklx, + deny /sys/f[^s]*/** wklx, + deny /sys/fs/[^c]*/** wklx, + deny /sys/fs/c[^g]*/** wklx, + deny /sys/fs/cg[^r]*/** wklx, + deny /sys/firmware/efi/efivars/** rwklx, + deny /sys/kernel/security/** rwklx, +} +` + +func generateProfile(out io.Writer) error { + compiled, err := template.New("apparmor_profile").Parse(baseTemplate) + if err != nil { + return err + } + data := &data{ + Name: "docker-default", + } + if tunablesExists() { + data.Imports = append(data.Imports, "#include ") + } else { + data.Imports = append(data.Imports, "@{PROC}=/proc/") + } + if abstractionsExists() { + data.InnerImports = append(data.InnerImports, "#include ") + } + if err := compiled.Execute(out, data); err != nil { + return err + } + return nil +} + +// check if the tunables/global exist +func tunablesExists() bool { + _, err := os.Stat("/etc/apparmor.d/tunables/global") + return err == nil +} + +// check if abstractions/base exist +func abstractionsExists() bool { + _, err := os.Stat("/etc/apparmor.d/abstractions/base") + return err == nil +} + +func installAppArmorProfile() error { + if !apparmor.IsEnabled() { + return nil + } + + // Make sure /etc/apparmor.d exists + if err := os.MkdirAll(path.Dir(apparmorProfilePath), 0755); err != nil { + return err + } + + f, err := os.OpenFile(apparmorProfilePath, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0644) + if err != nil { + return err + } + if err := generateProfile(f); err != nil { + f.Close() + return err + } + f.Close() + + cmd := exec.Command("/sbin/apparmor_parser", "-r", "-W", "docker") + // to use the parser directly we have to make sure we are in the correct + // dir with the profile + cmd.Dir = "/etc/apparmor.d" + + output, err := cmd.CombinedOutput() + if err != nil { + return fmt.Errorf("Error loading docker apparmor profile: %s (%s)", err, output) + } + return nil +} + +func hasAppArmorProfileLoaded(profile string) error { + file, err := os.Open("/sys/kernel/security/apparmor/profiles") + if err != nil { + return err + } + r := bufio.NewReader(file) + for { + p, err := r.ReadString('\n') + if err != nil { + return err + } + if strings.HasPrefix(p, profile+" ") { + return nil + } + } +} diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go new file mode 100644 index 0000000000..b19a7d38c1 --- /dev/null +++ b/daemon/execdriver/native/create.go @@ -0,0 +1,310 @@ +// +build linux,cgo + +package native + +import ( + "fmt" + "strings" + "syscall" + + "github.com/docker/docker/daemon/execdriver" + + "github.com/opencontainers/runc/libcontainer/apparmor" + "github.com/opencontainers/runc/libcontainer/configs" + "github.com/opencontainers/runc/libcontainer/devices" +) + +// createContainer populates and configures the container type with the +// data provided by the execdriver.Command +func (d *Driver) createContainer(c *execdriver.Command, hooks execdriver.Hooks) (*configs.Config, error) { + container := execdriver.InitContainer(c) + + if err := d.createIpc(container, c); err != nil { + return nil, err + } + + if err := d.createPid(container, c); err != nil { + return nil, err + } + + if err := d.createUTS(container, c); err != nil { + return nil, err + } + + if err := d.setupRemappedRoot(container, c); err != nil { + return nil, err + } + + if err := d.createNetwork(container, c, hooks); err != nil { + return nil, err + } + + if c.ProcessConfig.Privileged { + if !container.Readonlyfs { + // clear readonly for /sys + for i := range container.Mounts { + if container.Mounts[i].Destination == "/sys" { + container.Mounts[i].Flags &= ^syscall.MS_RDONLY + } + } + container.ReadonlyPaths = nil + } + + // clear readonly for cgroup + for i := range container.Mounts { + if container.Mounts[i].Device == "cgroup" { + container.Mounts[i].Flags &= ^syscall.MS_RDONLY + } + } + + container.MaskPaths = nil + if err := d.setPrivileged(container); err != nil { + return nil, err + } + } else { + if err := d.setCapabilities(container, c); err != nil { + return nil, err + } + } + // add CAP_ prefix to all caps for new libcontainer update to match + // the spec format. + for i, s := range container.Capabilities { + if !strings.HasPrefix(s, "CAP_") { + container.Capabilities[i] = fmt.Sprintf("CAP_%s", s) + } + } + container.AdditionalGroups = c.GroupAdd + + if c.AppArmorProfile != "" { + container.AppArmorProfile = c.AppArmorProfile + } + + if err := execdriver.SetupCgroups(container, c); err != nil { + return nil, err + } + + if container.Readonlyfs { + for i := range container.Mounts { + switch container.Mounts[i].Destination { + case "/proc", "/dev", "/dev/pts": + continue + } + container.Mounts[i].Flags |= syscall.MS_RDONLY + } + + /* These paths must be remounted as r/o */ + container.ReadonlyPaths = append(container.ReadonlyPaths, "/dev") + } + + if err := d.setupMounts(container, c); err != nil { + return nil, err + } + + d.setupLabels(container, c) + d.setupRlimits(container, c) + return container, nil +} + +func (d *Driver) createNetwork(container *configs.Config, c *execdriver.Command, hooks execdriver.Hooks) error { + if c.Network == nil { + return nil + } + if c.Network.ContainerID != "" { + d.Lock() + active := d.activeContainers[c.Network.ContainerID] + d.Unlock() + + if active == nil { + return fmt.Errorf("%s is not a valid running container to join", c.Network.ContainerID) + } + + state, err := active.State() + if err != nil { + return err + } + + container.Namespaces.Add(configs.NEWNET, state.NamespacePaths[configs.NEWNET]) + return nil + } + + if c.Network.NamespacePath != "" { + container.Namespaces.Add(configs.NEWNET, c.Network.NamespacePath) + return nil + } + // only set up prestart hook if the namespace path is not set (this should be + // all cases *except* for --net=host shared networking) + container.Hooks = &configs.Hooks{ + Prestart: []configs.Hook{ + configs.NewFunctionHook(func(s configs.HookState) error { + if len(hooks.PreStart) > 0 { + for _, fnHook := range hooks.PreStart { + // A closed channel for OOM is returned here as it will be + // non-blocking and return the correct result when read. + chOOM := make(chan struct{}) + close(chOOM) + if err := fnHook(&c.ProcessConfig, s.Pid, chOOM); err != nil { + return err + } + } + } + return nil + }), + }, + } + return nil +} + +func (d *Driver) createIpc(container *configs.Config, c *execdriver.Command) error { + if c.Ipc.HostIpc { + container.Namespaces.Remove(configs.NEWIPC) + return nil + } + + if c.Ipc.ContainerID != "" { + d.Lock() + active := d.activeContainers[c.Ipc.ContainerID] + d.Unlock() + + if active == nil { + return fmt.Errorf("%s is not a valid running container to join", c.Ipc.ContainerID) + } + + state, err := active.State() + if err != nil { + return err + } + container.Namespaces.Add(configs.NEWIPC, state.NamespacePaths[configs.NEWIPC]) + } + + return nil +} + +func (d *Driver) createPid(container *configs.Config, c *execdriver.Command) error { + if c.Pid.HostPid { + container.Namespaces.Remove(configs.NEWPID) + return nil + } + + return nil +} + +func (d *Driver) createUTS(container *configs.Config, c *execdriver.Command) error { + if c.UTS.HostUTS { + container.Namespaces.Remove(configs.NEWUTS) + container.Hostname = "" + return nil + } + + return nil +} + +func (d *Driver) setupRemappedRoot(container *configs.Config, c *execdriver.Command) error { + if c.RemappedRoot.UID == 0 { + container.Namespaces.Remove(configs.NEWUSER) + return nil + } + + // convert the Docker daemon id map to the libcontainer variant of the same struct + // this keeps us from having to import libcontainer code across Docker client + daemon packages + cuidMaps := []configs.IDMap{} + cgidMaps := []configs.IDMap{} + for _, idMap := range c.UIDMapping { + cuidMaps = append(cuidMaps, configs.IDMap(idMap)) + } + for _, idMap := range c.GIDMapping { + cgidMaps = append(cgidMaps, configs.IDMap(idMap)) + } + container.UidMappings = cuidMaps + container.GidMappings = cgidMaps + + for _, node := range container.Devices { + node.Uid = uint32(c.RemappedRoot.UID) + node.Gid = uint32(c.RemappedRoot.GID) + } + // TODO: until a kernel/mount solution exists for handling remount in a user namespace, + // we must clear the readonly flag for the cgroups mount (@mrunalp concurs) + for i := range container.Mounts { + if container.Mounts[i].Device == "cgroup" { + container.Mounts[i].Flags &= ^syscall.MS_RDONLY + } + } + + return nil +} + +func (d *Driver) setPrivileged(container *configs.Config) (err error) { + container.Capabilities = execdriver.GetAllCapabilities() + container.Cgroups.AllowAllDevices = true + + hostDevices, err := devices.HostDevices() + if err != nil { + return err + } + container.Devices = hostDevices + + if apparmor.IsEnabled() { + container.AppArmorProfile = "unconfined" + } + return nil +} + +func (d *Driver) setCapabilities(container *configs.Config, c *execdriver.Command) (err error) { + container.Capabilities, err = execdriver.TweakCapabilities(container.Capabilities, c.CapAdd, c.CapDrop) + return err +} + +func (d *Driver) setupRlimits(container *configs.Config, c *execdriver.Command) { + if c.Resources == nil { + return + } + + for _, rlimit := range c.Resources.Rlimits { + container.Rlimits = append(container.Rlimits, configs.Rlimit{ + Type: rlimit.Type, + Hard: rlimit.Hard, + Soft: rlimit.Soft, + }) + } +} + +func (d *Driver) setupMounts(container *configs.Config, c *execdriver.Command) error { + userMounts := make(map[string]struct{}) + for _, m := range c.Mounts { + userMounts[m.Destination] = struct{}{} + } + + // Filter out mounts that are overriden by user supplied mounts + var defaultMounts []*configs.Mount + _, mountDev := userMounts["/dev"] + for _, m := range container.Mounts { + if _, ok := userMounts[m.Destination]; !ok { + if mountDev && strings.HasPrefix(m.Destination, "/dev/") { + continue + } + defaultMounts = append(defaultMounts, m) + } + } + container.Mounts = defaultMounts + + for _, m := range c.Mounts { + flags := syscall.MS_BIND | syscall.MS_REC + if !m.Writable { + flags |= syscall.MS_RDONLY + } + if m.Slave { + flags |= syscall.MS_SLAVE + } + container.Mounts = append(container.Mounts, &configs.Mount{ + Source: m.Source, + Destination: m.Destination, + Device: "bind", + Flags: flags, + }) + } + return nil +} + +func (d *Driver) setupLabels(container *configs.Config, c *execdriver.Command) { + container.ProcessLabel = c.ProcessLabel + container.MountLabel = c.MountLabel +} diff --git a/daemon/execdriver/native/driver.go b/daemon/execdriver/native/driver.go new file mode 100644 index 0000000000..94f200a311 --- /dev/null +++ b/daemon/execdriver/native/driver.go @@ -0,0 +1,543 @@ +// +build linux,cgo + +package native + +import ( + "fmt" + "io" + "os" + "os/exec" + "path/filepath" + "strings" + "sync" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/pools" + "github.com/docker/docker/pkg/reexec" + sysinfo "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/term" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/apparmor" + "github.com/opencontainers/runc/libcontainer/cgroups/systemd" + "github.com/opencontainers/runc/libcontainer/configs" + "github.com/opencontainers/runc/libcontainer/system" + "github.com/opencontainers/runc/libcontainer/utils" +) + +// Define constants for native driver +const ( + DriverName = "native" + Version = "0.2" +) + +// Driver contains all information for native driver, +// it implements execdriver.Driver. +type Driver struct { + root string + initPath string + activeContainers map[string]libcontainer.Container + machineMemory int64 + factory libcontainer.Factory + sync.Mutex +} + +// NewDriver returns a new native driver, called from NewDriver of execdriver. +func NewDriver(root, initPath string, options []string) (*Driver, error) { + meminfo, err := sysinfo.ReadMemInfo() + if err != nil { + return nil, err + } + + if err := sysinfo.MkdirAll(root, 0700); err != nil { + return nil, err + } + + if apparmor.IsEnabled() { + if err := installAppArmorProfile(); err != nil { + apparmorProfiles := []string{"docker-default"} + + // Allow daemon to run if loading failed, but are active + // (possibly through another run, manually, or via system startup) + for _, policy := range apparmorProfiles { + if err := hasAppArmorProfileLoaded(policy); err != nil { + return nil, fmt.Errorf("AppArmor enabled on system but the %s profile could not be loaded.", policy) + } + } + } + } + + // choose cgroup manager + // this makes sure there are no breaking changes to people + // who upgrade from versions without native.cgroupdriver opt + cgm := libcontainer.Cgroupfs + if systemd.UseSystemd() { + cgm = libcontainer.SystemdCgroups + } + + // parse the options + for _, option := range options { + key, val, err := parsers.ParseKeyValueOpt(option) + if err != nil { + return nil, err + } + key = strings.ToLower(key) + switch key { + case "native.cgroupdriver": + // override the default if they set options + switch val { + case "systemd": + if systemd.UseSystemd() { + cgm = libcontainer.SystemdCgroups + } else { + // warn them that they chose the wrong driver + logrus.Warn("You cannot use systemd as native.cgroupdriver, using cgroupfs instead") + } + case "cgroupfs": + cgm = libcontainer.Cgroupfs + default: + return nil, fmt.Errorf("Unknown native.cgroupdriver given %q. try cgroupfs or systemd", val) + } + default: + return nil, fmt.Errorf("Unknown option %s\n", key) + } + } + + f, err := libcontainer.New( + root, + cgm, + libcontainer.InitPath(reexec.Self(), DriverName), + ) + if err != nil { + return nil, err + } + + return &Driver{ + root: root, + initPath: initPath, + activeContainers: make(map[string]libcontainer.Container), + machineMemory: meminfo.MemTotal, + factory: f, + }, nil +} + +type execOutput struct { + exitCode int + err error +} + +// Run implements the exec driver Driver interface, +// it calls libcontainer APIs to run a container. +func (d *Driver) Run(c *execdriver.Command, pipes *execdriver.Pipes, hooks execdriver.Hooks) (execdriver.ExitStatus, error) { + // take the Command and populate the libcontainer.Config from it + container, err := d.createContainer(c, hooks) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + p := &libcontainer.Process{ + Args: append([]string{c.ProcessConfig.Entrypoint}, c.ProcessConfig.Arguments...), + Env: c.ProcessConfig.Env, + Cwd: c.WorkingDir, + User: c.ProcessConfig.User, + } + + if err := setupPipes(container, &c.ProcessConfig, p, pipes); err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + cont, err := d.factory.Create(c.ID, container) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + d.Lock() + d.activeContainers[c.ID] = cont + d.Unlock() + defer func() { + cont.Destroy() + d.cleanContainer(c.ID) + }() + + if err := cont.Start(p); err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + oom := notifyOnOOM(cont) + if hooks.Start != nil { + pid, err := p.Pid() + if err != nil { + p.Signal(os.Kill) + p.Wait() + return execdriver.ExitStatus{ExitCode: -1}, err + } + hooks.Start(&c.ProcessConfig, pid, oom) + } + + waitF := p.Wait + if nss := cont.Config().Namespaces; !nss.Contains(configs.NEWPID) { + // we need such hack for tracking processes with inherited fds, + // because cmd.Wait() waiting for all streams to be copied + waitF = waitInPIDHost(p, cont) + } + ps, err := waitF() + if err != nil { + execErr, ok := err.(*exec.ExitError) + if !ok { + return execdriver.ExitStatus{ExitCode: -1}, err + } + ps = execErr.ProcessState + } + cont.Destroy() + _, oomKill := <-oom + return execdriver.ExitStatus{ExitCode: utils.ExitStatus(ps.Sys().(syscall.WaitStatus)), OOMKilled: oomKill}, nil +} + +// notifyOnOOM returns a channel that signals if the container received an OOM notification +// for any process. If it is unable to subscribe to OOM notifications then a closed +// channel is returned as it will be non-blocking and return the correct result when read. +func notifyOnOOM(container libcontainer.Container) <-chan struct{} { + oom, err := container.NotifyOOM() + if err != nil { + logrus.Warnf("Your kernel does not support OOM notifications: %s", err) + c := make(chan struct{}) + close(c) + return c + } + return oom +} + +func killCgroupProcs(c libcontainer.Container) { + var procs []*os.Process + if err := c.Pause(); err != nil { + logrus.Warn(err) + } + pids, err := c.Processes() + if err != nil { + // don't care about childs if we can't get them, this is mostly because cgroup already deleted + logrus.Warnf("Failed to get processes from container %s: %v", c.ID(), err) + } + for _, pid := range pids { + if p, err := os.FindProcess(pid); err == nil { + procs = append(procs, p) + if err := p.Kill(); err != nil { + logrus.Warn(err) + } + } + } + if err := c.Resume(); err != nil { + logrus.Warn(err) + } + for _, p := range procs { + if _, err := p.Wait(); err != nil { + logrus.Warn(err) + } + } +} + +func waitInPIDHost(p *libcontainer.Process, c libcontainer.Container) func() (*os.ProcessState, error) { + return func() (*os.ProcessState, error) { + pid, err := p.Pid() + if err != nil { + return nil, err + } + + process, err := os.FindProcess(pid) + s, err := process.Wait() + if err != nil { + execErr, ok := err.(*exec.ExitError) + if !ok { + return s, err + } + s = execErr.ProcessState + } + killCgroupProcs(c) + p.Wait() + return s, err + } +} + +// Kill implements the exec driver Driver interface. +func (d *Driver) Kill(c *execdriver.Command, sig int) error { + d.Lock() + active := d.activeContainers[c.ID] + d.Unlock() + if active == nil { + return fmt.Errorf("active container for %s does not exist", c.ID) + } + state, err := active.State() + if err != nil { + return err + } + return syscall.Kill(state.InitProcessPid, syscall.Signal(sig)) +} + +// Pause implements the exec driver Driver interface, +// it calls libcontainer API to pause a container. +func (d *Driver) Pause(c *execdriver.Command) error { + d.Lock() + active := d.activeContainers[c.ID] + d.Unlock() + if active == nil { + return fmt.Errorf("active container for %s does not exist", c.ID) + } + return active.Pause() +} + +// Unpause implements the exec driver Driver interface, +// it calls libcontainer API to unpause a container. +func (d *Driver) Unpause(c *execdriver.Command) error { + d.Lock() + active := d.activeContainers[c.ID] + d.Unlock() + if active == nil { + return fmt.Errorf("active container for %s does not exist", c.ID) + } + return active.Resume() +} + +// Terminate implements the exec driver Driver interface. +func (d *Driver) Terminate(c *execdriver.Command) error { + defer d.cleanContainer(c.ID) + container, err := d.factory.Load(c.ID) + if err != nil { + return err + } + defer container.Destroy() + state, err := container.State() + if err != nil { + return err + } + pid := state.InitProcessPid + currentStartTime, err := system.GetProcessStartTime(pid) + if err != nil { + return err + } + if state.InitProcessStartTime == currentStartTime { + err = syscall.Kill(pid, 9) + syscall.Wait4(pid, nil, 0, nil) + } + return err +} + +// Info implements the exec driver Driver interface. +func (d *Driver) Info(id string) execdriver.Info { + return &info{ + ID: id, + driver: d, + } +} + +// Name implements the exec driver Driver interface. +func (d *Driver) Name() string { + return fmt.Sprintf("%s-%s", DriverName, Version) +} + +// GetPidsForContainer implements the exec driver Driver interface. +func (d *Driver) GetPidsForContainer(id string) ([]int, error) { + d.Lock() + active := d.activeContainers[id] + d.Unlock() + + if active == nil { + return nil, fmt.Errorf("active container for %s does not exist", id) + } + return active.Processes() +} + +func (d *Driver) cleanContainer(id string) error { + d.Lock() + delete(d.activeContainers, id) + d.Unlock() + return os.RemoveAll(filepath.Join(d.root, id)) +} + +func (d *Driver) createContainerRoot(id string) error { + return os.MkdirAll(filepath.Join(d.root, id), 0655) +} + +// Clean implements the exec driver Driver interface. +func (d *Driver) Clean(id string) error { + return os.RemoveAll(filepath.Join(d.root, id)) +} + +// Stats implements the exec driver Driver interface. +func (d *Driver) Stats(id string) (*execdriver.ResourceStats, error) { + d.Lock() + c := d.activeContainers[id] + d.Unlock() + if c == nil { + return nil, execdriver.ErrNotRunning + } + now := time.Now() + stats, err := c.Stats() + if err != nil { + return nil, err + } + memoryLimit := c.Config().Cgroups.Memory + // if the container does not have any memory limit specified set the + // limit to the machines memory + if memoryLimit == 0 { + memoryLimit = d.machineMemory + } + return &execdriver.ResourceStats{ + Stats: stats, + Read: now, + MemoryLimit: memoryLimit, + }, nil +} + +// TtyConsole implements the exec driver Terminal interface. +type TtyConsole struct { + console libcontainer.Console +} + +// NewTtyConsole returns a new TtyConsole struct. +func NewTtyConsole(console libcontainer.Console, pipes *execdriver.Pipes) (*TtyConsole, error) { + tty := &TtyConsole{ + console: console, + } + + if err := tty.AttachPipes(pipes); err != nil { + tty.Close() + return nil, err + } + + return tty, nil +} + +// Resize implements Resize method of Terminal interface +func (t *TtyConsole) Resize(h, w int) error { + return term.SetWinsize(t.console.Fd(), &term.Winsize{Height: uint16(h), Width: uint16(w)}) +} + +// AttachPipes attaches given pipes to TtyConsole +func (t *TtyConsole) AttachPipes(pipes *execdriver.Pipes) error { + go func() { + if wb, ok := pipes.Stdout.(interface { + CloseWriters() error + }); ok { + defer wb.CloseWriters() + } + + pools.Copy(pipes.Stdout, t.console) + }() + + if pipes.Stdin != nil { + go func() { + pools.Copy(t.console, pipes.Stdin) + + pipes.Stdin.Close() + }() + } + + return nil +} + +// Close implements Close method of Terminal interface +func (t *TtyConsole) Close() error { + return t.console.Close() +} + +func setupPipes(container *configs.Config, processConfig *execdriver.ProcessConfig, p *libcontainer.Process, pipes *execdriver.Pipes) error { + + rootuid, err := container.HostUID() + if err != nil { + return err + } + + if processConfig.Tty { + cons, err := p.NewConsole(rootuid) + if err != nil { + return err + } + term, err := NewTtyConsole(cons, pipes) + if err != nil { + return err + } + processConfig.Terminal = term + return nil + } + // not a tty--set up stdio pipes + term := &execdriver.StdConsole{} + processConfig.Terminal = term + + // if we are not in a user namespace, there is no reason to go through + // the hassle of setting up os-level pipes with proper (remapped) ownership + // so we will do the prior shortcut for non-userns containers + if rootuid == 0 { + p.Stdout = pipes.Stdout + p.Stderr = pipes.Stderr + + r, w, err := os.Pipe() + if err != nil { + return err + } + if pipes.Stdin != nil { + go func() { + io.Copy(w, pipes.Stdin) + w.Close() + }() + p.Stdin = r + } + return nil + } + + // if we have user namespaces enabled (rootuid != 0), we will set + // up os pipes for stderr, stdout, stdin so we can chown them to + // the proper ownership to allow for proper access to the underlying + // fds + var fds []int + + //setup stdout + r, w, err := os.Pipe() + if err != nil { + return err + } + fds = append(fds, int(r.Fd()), int(w.Fd())) + if pipes.Stdout != nil { + go io.Copy(pipes.Stdout, r) + } + term.Closers = append(term.Closers, r) + p.Stdout = w + + //setup stderr + r, w, err = os.Pipe() + if err != nil { + return err + } + fds = append(fds, int(r.Fd()), int(w.Fd())) + if pipes.Stderr != nil { + go io.Copy(pipes.Stderr, r) + } + term.Closers = append(term.Closers, r) + p.Stderr = w + + //setup stdin + r, w, err = os.Pipe() + if err != nil { + return err + } + fds = append(fds, int(r.Fd()), int(w.Fd())) + if pipes.Stdin != nil { + go func() { + io.Copy(w, pipes.Stdin) + w.Close() + }() + p.Stdin = r + } + for _, fd := range fds { + if err := syscall.Fchown(fd, rootuid, rootuid); err != nil { + return fmt.Errorf("Failed to chown pipes fd: %v", err) + } + } + return nil +} + +// SupportsHooks implements the execdriver Driver interface. +// The libcontainer/runC-based native execdriver does exploit the hook mechanism +func (d *Driver) SupportsHooks() bool { + return true +} diff --git a/daemon/execdriver/native/driver_unsupported.go b/daemon/execdriver/native/driver_unsupported.go new file mode 100644 index 0000000000..f4ca76ff06 --- /dev/null +++ b/daemon/execdriver/native/driver_unsupported.go @@ -0,0 +1,14 @@ +// +build !linux + +package native + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" +) + +// NewDriver returns a new native driver, called from NewDriver of execdriver. +func NewDriver(root, initPath string) (execdriver.Driver, error) { + return nil, fmt.Errorf("native driver not supported on non-linux") +} diff --git a/daemon/execdriver/native/driver_unsupported_nocgo.go b/daemon/execdriver/native/driver_unsupported_nocgo.go new file mode 100644 index 0000000000..757845661b --- /dev/null +++ b/daemon/execdriver/native/driver_unsupported_nocgo.go @@ -0,0 +1,14 @@ +// +build linux,!cgo + +package native + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" +) + +// NewDriver returns a new native driver, called from NewDriver of execdriver. +func NewDriver(root, initPath string) (execdriver.Driver, error) { + return nil, fmt.Errorf("native driver not supported on non-linux") +} diff --git a/daemon/execdriver/native/exec.go b/daemon/execdriver/native/exec.go new file mode 100644 index 0000000000..0af5670239 --- /dev/null +++ b/daemon/execdriver/native/exec.go @@ -0,0 +1,87 @@ +// +build linux + +package native + +import ( + "fmt" + "os" + "os/exec" + "strings" + "syscall" + + "github.com/docker/docker/daemon/execdriver" + "github.com/opencontainers/runc/libcontainer" + // Blank import 'nsenter' so that init in that package will call c + // function 'nsexec()' to do 'setns' before Go runtime take over, + // it's used for join to exist ns like 'docker exec' command. + _ "github.com/opencontainers/runc/libcontainer/nsenter" + "github.com/opencontainers/runc/libcontainer/utils" +) + +// Exec implements the exec driver Driver interface, +// it calls libcontainer APIs to execute a container. +func (d *Driver) Exec(c *execdriver.Command, processConfig *execdriver.ProcessConfig, pipes *execdriver.Pipes, hooks execdriver.Hooks) (int, error) { + active := d.activeContainers[c.ID] + if active == nil { + return -1, fmt.Errorf("No active container exists with ID %s", c.ID) + } + + user := processConfig.User + if c.RemappedRoot.UID != 0 && user == "" { + //if user namespaces are enabled, set user explicitly so uid/gid is set to 0 + //otherwise we end up with the overflow id and no permissions (65534) + user = "0" + } + + p := &libcontainer.Process{ + Args: append([]string{processConfig.Entrypoint}, processConfig.Arguments...), + Env: c.ProcessConfig.Env, + Cwd: c.WorkingDir, + User: user, + } + + if processConfig.Privileged { + p.Capabilities = execdriver.GetAllCapabilities() + } + // add CAP_ prefix to all caps for new libcontainer update to match + // the spec format. + for i, s := range p.Capabilities { + if !strings.HasPrefix(s, "CAP_") { + p.Capabilities[i] = fmt.Sprintf("CAP_%s", s) + } + } + + config := active.Config() + if err := setupPipes(&config, processConfig, p, pipes); err != nil { + return -1, err + } + + if err := active.Start(p); err != nil { + return -1, err + } + + if hooks.Start != nil { + pid, err := p.Pid() + if err != nil { + p.Signal(os.Kill) + p.Wait() + return -1, err + } + + // A closed channel for OOM is returned here as it will be + // non-blocking and return the correct result when read. + chOOM := make(chan struct{}) + close(chOOM) + hooks.Start(&c.ProcessConfig, pid, chOOM) + } + + ps, err := p.Wait() + if err != nil { + exitErr, ok := err.(*exec.ExitError) + if !ok { + return -1, err + } + ps = exitErr.ProcessState + } + return utils.ExitStatus(ps.Sys().(syscall.WaitStatus)), nil +} diff --git a/daemon/execdriver/native/info.go b/daemon/execdriver/native/info.go new file mode 100644 index 0000000000..498e56f00e --- /dev/null +++ b/daemon/execdriver/native/info.go @@ -0,0 +1,16 @@ +// +build linux,cgo + +package native + +type info struct { + ID string + driver *Driver +} + +// IsRunning is determined by looking for the +// pid file for a container. If the file exists then the +// container is currently running +func (i *info) IsRunning() bool { + _, ok := i.driver.activeContainers[i.ID] + return ok +} diff --git a/daemon/execdriver/native/init.go b/daemon/execdriver/native/init.go new file mode 100644 index 0000000000..307b5b1b80 --- /dev/null +++ b/daemon/execdriver/native/init.go @@ -0,0 +1,45 @@ +// +build linux + +package native + +import ( + "fmt" + "os" + "runtime" + + "github.com/docker/docker/pkg/reexec" + "github.com/opencontainers/runc/libcontainer" +) + +func init() { + reexec.Register(DriverName, initializer) +} + +func fatal(err error) { + if lerr, ok := err.(libcontainer.Error); ok { + lerr.Detail(os.Stderr) + os.Exit(1) + } + + fmt.Fprintln(os.Stderr, err) + os.Exit(1) +} + +func initializer() { + runtime.GOMAXPROCS(1) + runtime.LockOSThread() + factory, err := libcontainer.New("") + if err != nil { + fatal(err) + } + if err := factory.StartInitialization(); err != nil { + fatal(err) + } + + panic("unreachable") +} + +func writeError(err error) { + fmt.Fprint(os.Stderr, err) + os.Exit(1) +} diff --git a/daemon/execdriver/native/template/default_template.go b/daemon/execdriver/native/template/default_template.go new file mode 100644 index 0000000000..1303cb545b --- /dev/null +++ b/daemon/execdriver/native/template/default_template.go @@ -0,0 +1,98 @@ +package template + +import ( + "syscall" + + "github.com/opencontainers/runc/libcontainer/apparmor" + "github.com/opencontainers/runc/libcontainer/configs" +) + +const defaultMountFlags = syscall.MS_NOEXEC | syscall.MS_NOSUID | syscall.MS_NODEV + +// New returns the docker default configuration for libcontainer +func New() *configs.Config { + container := &configs.Config{ + Capabilities: []string{ + "CHOWN", + "DAC_OVERRIDE", + "FSETID", + "FOWNER", + "MKNOD", + "NET_RAW", + "SETGID", + "SETUID", + "SETFCAP", + "SETPCAP", + "NET_BIND_SERVICE", + "SYS_CHROOT", + "KILL", + "AUDIT_WRITE", + }, + Namespaces: configs.Namespaces([]configs.Namespace{ + {Type: "NEWNS"}, + {Type: "NEWUTS"}, + {Type: "NEWIPC"}, + {Type: "NEWPID"}, + {Type: "NEWNET"}, + {Type: "NEWUSER"}, + }), + Cgroups: &configs.Cgroup{ + Parent: "docker", + AllowAllDevices: false, + MemorySwappiness: -1, + }, + Mounts: []*configs.Mount{ + { + Source: "proc", + Destination: "/proc", + Device: "proc", + Flags: defaultMountFlags, + }, + { + Source: "tmpfs", + Destination: "/dev", + Device: "tmpfs", + Flags: syscall.MS_NOSUID | syscall.MS_STRICTATIME, + Data: "mode=755", + }, + { + Source: "devpts", + Destination: "/dev/pts", + Device: "devpts", + Flags: syscall.MS_NOSUID | syscall.MS_NOEXEC, + Data: "newinstance,ptmxmode=0666,mode=0620,gid=5", + }, + { + Source: "sysfs", + Destination: "/sys", + Device: "sysfs", + Flags: defaultMountFlags | syscall.MS_RDONLY, + }, + { + Source: "cgroup", + Destination: "/sys/fs/cgroup", + Device: "cgroup", + Flags: defaultMountFlags | syscall.MS_RDONLY, + }, + }, + MaskPaths: []string{ + "/proc/kcore", + "/proc/latency_stats", + "/proc/timer_stats", + }, + ReadonlyPaths: []string{ + "/proc/asound", + "/proc/bus", + "/proc/fs", + "/proc/irq", + "/proc/sys", + "/proc/sysrq-trigger", + }, + } + + if apparmor.IsEnabled() { + container.AppArmorProfile = "docker-default" + } + + return container +} diff --git a/daemon/execdriver/pipes.go b/daemon/execdriver/pipes.go new file mode 100644 index 0000000000..fdddaee9b0 --- /dev/null +++ b/daemon/execdriver/pipes.go @@ -0,0 +1,24 @@ +package execdriver + +import ( + "io" +) + +// Pipes is a wrapper around a container's output for +// stdin, stdout, stderr +type Pipes struct { + Stdin io.ReadCloser + Stdout, Stderr io.Writer +} + +// NewPipes returns a wrapper around a container's output +func NewPipes(stdin io.ReadCloser, stdout, stderr io.Writer, useStdin bool) *Pipes { + p := &Pipes{ + Stdout: stdout, + Stderr: stderr, + } + if useStdin { + p.Stdin = stdin + } + return p +} diff --git a/daemon/execdriver/termconsole.go b/daemon/execdriver/termconsole.go new file mode 100644 index 0000000000..888836020f --- /dev/null +++ b/daemon/execdriver/termconsole.go @@ -0,0 +1,55 @@ +package execdriver + +import ( + "io" + "os/exec" +) + +// StdConsole defines standard console operations for execdriver +type StdConsole struct { + // Closers holds io.Closer references for closing at terminal close time + Closers []io.Closer +} + +// NewStdConsole returns a new StdConsole struct +func NewStdConsole(processConfig *ProcessConfig, pipes *Pipes) (*StdConsole, error) { + std := &StdConsole{} + + if err := std.AttachPipes(&processConfig.Cmd, pipes); err != nil { + return nil, err + } + return std, nil +} + +// AttachPipes attaches given pipes to exec.Cmd +func (s *StdConsole) AttachPipes(command *exec.Cmd, pipes *Pipes) error { + command.Stdout = pipes.Stdout + command.Stderr = pipes.Stderr + + if pipes.Stdin != nil { + stdin, err := command.StdinPipe() + if err != nil { + return err + } + + go func() { + defer stdin.Close() + io.Copy(stdin, pipes.Stdin) + }() + } + return nil +} + +// Resize implements Resize method of Terminal interface +func (s *StdConsole) Resize(h, w int) error { + // we do not need to resize a non tty + return nil +} + +// Close implements Close method of Terminal interface +func (s *StdConsole) Close() error { + for _, c := range s.Closers { + c.Close() + } + return nil +} diff --git a/daemon/execdriver/utils.go b/daemon/execdriver/utils.go new file mode 100644 index 0000000000..7860e04026 --- /dev/null +++ b/daemon/execdriver/utils.go @@ -0,0 +1,123 @@ +package execdriver + +import ( + "fmt" + "strings" + + "github.com/docker/docker/pkg/stringutils" + "github.com/syndtr/gocapability/capability" +) + +var capabilityList Capabilities + +func init() { + last := capability.CAP_LAST_CAP + // hack for RHEL6 which has no /proc/sys/kernel/cap_last_cap + if last == capability.Cap(63) { + last = capability.CAP_BLOCK_SUSPEND + } + for _, cap := range capability.List() { + if cap > last { + continue + } + capabilityList = append(capabilityList, + &CapabilityMapping{ + Key: strings.ToUpper(cap.String()), + Value: cap, + }, + ) + } +} + +type ( + // CapabilityMapping maps linux capability name to its value of capability.Cap type + // Capabilities is one of the security systems in Linux Security Module (LSM) + // framework provided by the kernel. + // For more details on capabilities, see http://man7.org/linux/man-pages/man7/capabilities.7.html + CapabilityMapping struct { + Key string `json:"key,omitempty"` + Value capability.Cap `json:"value,omitempty"` + } + // Capabilities contains all CapabilityMapping + Capabilities []*CapabilityMapping +) + +// String returns of CapabilityMapping +func (c *CapabilityMapping) String() string { + return c.Key +} + +// GetCapability returns CapabilityMapping which contains specific key +func GetCapability(key string) *CapabilityMapping { + for _, capp := range capabilityList { + if capp.Key == key { + cpy := *capp + return &cpy + } + } + return nil +} + +// GetAllCapabilities returns all of the capabilities +func GetAllCapabilities() []string { + output := make([]string, len(capabilityList)) + for i, capability := range capabilityList { + output[i] = capability.String() + } + return output +} + +// TweakCapabilities can tweak capabilities by adding or dropping capabilities +// based on the basics capabilities. +func TweakCapabilities(basics, adds, drops []string) ([]string, error) { + var ( + newCaps []string + allCaps = GetAllCapabilities() + ) + + // look for invalid cap in the drop list + for _, cap := range drops { + if strings.ToLower(cap) == "all" { + continue + } + if !stringutils.InSlice(allCaps, cap) { + return nil, fmt.Errorf("Unknown capability drop: %q", cap) + } + } + + // handle --cap-add=all + if stringutils.InSlice(adds, "all") { + basics = allCaps + } + + if !stringutils.InSlice(drops, "all") { + for _, cap := range basics { + // skip `all` already handled above + if strings.ToLower(cap) == "all" { + continue + } + + // if we don't drop `all`, add back all the non-dropped caps + if !stringutils.InSlice(drops, cap) { + newCaps = append(newCaps, strings.ToUpper(cap)) + } + } + } + + for _, cap := range adds { + // skip `all` already handled above + if strings.ToLower(cap) == "all" { + continue + } + + if !stringutils.InSlice(allCaps, cap) { + return nil, fmt.Errorf("Unknown capability to add: %q", cap) + } + + // add cap if not already in the list + if !stringutils.InSlice(newCaps, cap) { + newCaps = append(newCaps, strings.ToUpper(cap)) + } + } + return newCaps, nil +} diff --git a/daemon/execdriver/windows/checkoptions.go b/daemon/execdriver/windows/checkoptions.go new file mode 100644 index 0000000000..cb67e8a259 --- /dev/null +++ b/daemon/execdriver/windows/checkoptions.go @@ -0,0 +1,36 @@ +// +build windows + +package windows + +import ( + "errors" + + "github.com/docker/docker/daemon/execdriver" +) + +func checkSupportedOptions(c *execdriver.Command) error { + // Windows doesn't support read-only root filesystem + if c.ReadonlyRootfs { + return errors.New("Windows does not support the read-only root filesystem option") + } + + // Windows doesn't support username + if c.ProcessConfig.User != "" { + return errors.New("Windows does not support the username option") + } + + // Windows doesn't support custom lxc options + if c.LxcConfig != nil { + return errors.New("Windows does not support lxc options") + } + + // Windows doesn't support ulimit + if c.Resources.Rlimits != nil { + return errors.New("Windows does not support ulimit options") + } + + // TODO Windows: Validate other fields which Windows doesn't support, factor + // out where applicable per platform. + + return nil +} diff --git a/daemon/execdriver/windows/clean.go b/daemon/execdriver/windows/clean.go new file mode 100644 index 0000000000..3a99cf86aa --- /dev/null +++ b/daemon/execdriver/windows/clean.go @@ -0,0 +1,8 @@ +// +build windows + +package windows + +// Clean implements the exec driver Driver interface. +func (d *Driver) Clean(id string) error { + return nil +} diff --git a/daemon/execdriver/windows/exec.go b/daemon/execdriver/windows/exec.go new file mode 100644 index 0000000000..5ea12a8cbb --- /dev/null +++ b/daemon/execdriver/windows/exec.go @@ -0,0 +1,88 @@ +// +build windows + +package windows + +import ( + "errors" + "fmt" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/microsoft/hcsshim" +) + +// Exec implements the exec driver Driver interface. +func (d *Driver) Exec(c *execdriver.Command, processConfig *execdriver.ProcessConfig, pipes *execdriver.Pipes, hooks execdriver.Hooks) (int, error) { + + var ( + term execdriver.Terminal + err error + exitCode int32 + ) + + active := d.activeContainers[c.ID] + if active == nil { + return -1, fmt.Errorf("Exec - No active container exists with ID %s", c.ID) + } + + createProcessParms := hcsshim.CreateProcessParams{ + EmulateConsole: processConfig.Tty, // Note NOT c.ProcessConfig.Tty + WorkingDirectory: c.WorkingDir, + } + + // Configure the environment for the process // Note NOT c.ProcessConfig.Tty + createProcessParms.Environment = setupEnvironmentVariables(processConfig.Env) + + // While this should get caught earlier, just in case, validate that we + // have something to run. + if processConfig.Entrypoint == "" { + err = errors.New("No entrypoint specified") + logrus.Error(err) + return -1, err + } + + // Build the command line of the process + createProcessParms.CommandLine = processConfig.Entrypoint + for _, arg := range processConfig.Arguments { + logrus.Debugln("appending ", arg) + createProcessParms.CommandLine += " " + arg + } + logrus.Debugln("commandLine: ", createProcessParms.CommandLine) + + // Start the command running in the container. + pid, stdin, stdout, stderr, err := hcsshim.CreateProcessInComputeSystem(c.ID, pipes.Stdin != nil, true, !processConfig.Tty, createProcessParms) + if err != nil { + logrus.Errorf("CreateProcessInComputeSystem() failed %s", err) + return -1, err + } + + // Now that the process has been launched, begin copying data to and from + // the named pipes for the std handles. + setupPipes(stdin, stdout, stderr, pipes) + + // Note NOT c.ProcessConfig.Tty + if processConfig.Tty { + term = NewTtyConsole(c.ID, pid) + } else { + term = NewStdConsole() + } + processConfig.Terminal = term + + // Invoke the start callback + if hooks.Start != nil { + // A closed channel for OOM is returned here as it will be + // non-blocking and return the correct result when read. + chOOM := make(chan struct{}) + close(chOOM) + hooks.Start(&c.ProcessConfig, int(pid), chOOM) + } + + if exitCode, err = hcsshim.WaitForProcessInComputeSystem(c.ID, pid); err != nil { + logrus.Errorf("Failed to WaitForProcessInComputeSystem %s", err) + return -1, err + } + + // TODO Windows - Do something with this exit code + logrus.Debugln("Exiting Run() with ExitCode 0", c.ID) + return int(exitCode), nil +} diff --git a/daemon/execdriver/windows/getpids.go b/daemon/execdriver/windows/getpids.go new file mode 100644 index 0000000000..5b1a9eb59a --- /dev/null +++ b/daemon/execdriver/windows/getpids.go @@ -0,0 +1,11 @@ +// +build windows + +package windows + +import "fmt" + +// GetPidsForContainer implements the exec driver Driver interface. +func (d *Driver) GetPidsForContainer(id string) ([]int, error) { + // TODO Windows: Implementation required. + return nil, fmt.Errorf("GetPidsForContainer: GetPidsForContainer() not implemented") +} diff --git a/daemon/execdriver/windows/info.go b/daemon/execdriver/windows/info.go new file mode 100644 index 0000000000..2a16d5607d --- /dev/null +++ b/daemon/execdriver/windows/info.go @@ -0,0 +1,24 @@ +// +build windows + +package windows + +import "github.com/docker/docker/daemon/execdriver" + +type info struct { + ID string + driver *Driver +} + +// Info implements the exec driver Driver interface. +func (d *Driver) Info(id string) execdriver.Info { + return &info{ + ID: id, + driver: d, + } +} + +func (i *info) IsRunning() bool { + var running bool + running = true // TODO Need an HCS API + return running +} diff --git a/daemon/execdriver/windows/namedpipes.go b/daemon/execdriver/windows/namedpipes.go new file mode 100644 index 0000000000..733fe00194 --- /dev/null +++ b/daemon/execdriver/windows/namedpipes.go @@ -0,0 +1,54 @@ +// +build windows + +package windows + +import ( + "io" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" +) + +// General comment. Handling I/O for a container is very different to Linux. +// We use a named pipe to HCS to copy I/O both in and out of the container, +// very similar to how docker daemon communicates with a CLI. + +// startStdinCopy asynchronously copies an io.Reader to the container's +// process's stdin pipe and closes the pipe when there is no more data to copy. +func startStdinCopy(dst io.WriteCloser, src io.Reader) { + + // Anything that comes from the client stdin should be copied + // across to the stdin named pipe of the container. + go func() { + defer dst.Close() + bytes, err := io.Copy(dst, src) + logrus.Debugf("Copied %d bytes from stdin err=%s", bytes, err) + }() +} + +// startStdouterrCopy asynchronously copies data from the container's process's +// stdout or stderr pipe to an io.Writer and closes the pipe when there is no +// more data to copy. +func startStdouterrCopy(dst io.Writer, src io.ReadCloser, name string) { + // Anything that comes from the container named pipe stdout/err should be copied + // across to the stdout/err of the client + go func() { + defer src.Close() + bytes, err := io.Copy(dst, src) + logrus.Debugf("Copied %d bytes from %s err=%s", bytes, name, err) + }() +} + +// setupPipes starts the asynchronous copying of data to and from the named +// pipes used byt he HCS for the std handles. +func setupPipes(stdin io.WriteCloser, stdout, stderr io.ReadCloser, pipes *execdriver.Pipes) { + if stdin != nil { + startStdinCopy(stdin, pipes.Stdin) + } + if stdout != nil { + startStdouterrCopy(pipes.Stdout, stdout, "stdout") + } + if stderr != nil { + startStdouterrCopy(pipes.Stderr, stderr, "stderr") + } +} diff --git a/daemon/execdriver/windows/pauseunpause.go b/daemon/execdriver/windows/pauseunpause.go new file mode 100644 index 0000000000..c408669c3c --- /dev/null +++ b/daemon/execdriver/windows/pauseunpause.go @@ -0,0 +1,19 @@ +// +build windows + +package windows + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" +) + +// Pause implements the exec driver Driver interface. +func (d *Driver) Pause(c *execdriver.Command) error { + return fmt.Errorf("Windows: Containers cannot be paused") +} + +// Unpause implements the exec driver Driver interface. +func (d *Driver) Unpause(c *execdriver.Command) error { + return fmt.Errorf("Windows: Containers cannot be paused") +} diff --git a/daemon/execdriver/windows/run.go b/daemon/execdriver/windows/run.go new file mode 100644 index 0000000000..9e7930c550 --- /dev/null +++ b/daemon/execdriver/windows/run.go @@ -0,0 +1,321 @@ +// +build windows + +package windows + +// Note this is alpha code for the bring up of containers on Windows. + +import ( + "encoding/json" + "errors" + "fmt" + "os" + "path/filepath" + "strconv" + "strings" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/microsoft/hcsshim" +) + +// defaultContainerNAT is the default name of the container NAT device that is +// preconfigured on the server. +const defaultContainerNAT = "ContainerNAT" + +type layer struct { + ID string + Path string +} + +type defConfig struct { + DefFile string +} + +type portBinding struct { + Protocol string + InternalPort int + ExternalPort int +} + +type natSettings struct { + Name string + PortBindings []portBinding +} + +type networkConnection struct { + NetworkName string + // TODO Windows: Add Ip4Address string to this structure when hooked up in + // docker CLI. This is present in the HCS JSON handler. + EnableNat bool + Nat natSettings +} +type networkSettings struct { + MacAddress string +} + +type device struct { + DeviceType string + Connection interface{} + Settings interface{} +} + +type containerInit struct { + SystemType string // HCS requires this to be hard-coded to "Container" + Name string // Name of the container. We use the docker ID. + Owner string // The management platform that created this container + IsDummy bool // Used for development purposes. + VolumePath string // Windows volume path for scratch space + Devices []device // Devices used by the container + IgnoreFlushesDuringBoot bool // Optimisation hint for container startup in Windows + LayerFolderPath string // Where the layer folders are located + Layers []layer // List of storage layers + ProcessorWeight int64 // CPU Shares 1..9 on Windows; or 0 is platform default. + HostName string // Hostname +} + +// defaultOwner is a tag passed to HCS to allow it to differentiate between +// container creator management stacks. We hard code "docker" in the case +// of docker. +const defaultOwner = "docker" + +// Run implements the exec driver Driver interface +func (d *Driver) Run(c *execdriver.Command, pipes *execdriver.Pipes, hooks execdriver.Hooks) (execdriver.ExitStatus, error) { + + var ( + term execdriver.Terminal + err error + ) + + // Make sure the client isn't asking for options which aren't supported + err = checkSupportedOptions(c) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + cu := &containerInit{ + SystemType: "Container", + Name: c.ID, + Owner: defaultOwner, + IsDummy: dummyMode, + VolumePath: c.Rootfs, + IgnoreFlushesDuringBoot: c.FirstStart, + LayerFolderPath: c.LayerFolder, + ProcessorWeight: c.Resources.CPUShares, + HostName: c.Hostname, + } + + for i := 0; i < len(c.LayerPaths); i++ { + _, filename := filepath.Split(c.LayerPaths[i]) + g, err := hcsshim.NameToGuid(filename) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + cu.Layers = append(cu.Layers, layer{ + ID: g.ToString(), + Path: c.LayerPaths[i], + }) + } + + // TODO Windows. At some point, when there is CLI on docker run to + // enable the IP Address of the container to be passed into docker run, + // the IP Address needs to be wired through to HCS in the JSON. It + // would be present in c.Network.Interface.IPAddress. See matching + // TODO in daemon\container_windows.go, function populateCommand. + + if c.Network.Interface != nil { + + var pbs []portBinding + + // Enumerate through the port bindings specified by the user and convert + // them into the internal structure matching the JSON blob that can be + // understood by the HCS. + for i, v := range c.Network.Interface.PortBindings { + proto := strings.ToUpper(i.Proto()) + if proto != "TCP" && proto != "UDP" { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("invalid protocol %s", i.Proto()) + } + + if len(v) > 1 { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("Windows does not support more than one host port in NAT settings") + } + + for _, v2 := range v { + var ( + iPort, ePort int + err error + ) + if len(v2.HostIP) != 0 { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("Windows does not support host IP addresses in NAT settings") + } + if ePort, err = strconv.Atoi(v2.HostPort); err != nil { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("invalid container port %s: %s", v2.HostPort, err) + } + if iPort, err = strconv.Atoi(i.Port()); err != nil { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("invalid internal port %s: %s", i.Port(), err) + } + if iPort < 0 || iPort > 65535 || ePort < 0 || ePort > 65535 { + return execdriver.ExitStatus{ExitCode: -1}, fmt.Errorf("specified NAT port is not in allowed range") + } + pbs = append(pbs, + portBinding{ExternalPort: ePort, + InternalPort: iPort, + Protocol: proto}) + } + } + + // TODO Windows: TP3 workaround. Allow the user to override the name of + // the Container NAT device through an environment variable. This will + // ultimately be a global daemon parameter on Windows, similar to -b + // for the name of the virtual switch (aka bridge). + cn := os.Getenv("DOCKER_CONTAINER_NAT") + if len(cn) == 0 { + cn = defaultContainerNAT + } + + dev := device{ + DeviceType: "Network", + Connection: &networkConnection{ + NetworkName: c.Network.Interface.Bridge, + // TODO Windows: Fixme, next line. Needs HCS fix. + EnableNat: false, + Nat: natSettings{ + Name: cn, + PortBindings: pbs, + }, + }, + } + + if c.Network.Interface.MacAddress != "" { + windowsStyleMAC := strings.Replace( + c.Network.Interface.MacAddress, ":", "-", -1) + dev.Settings = networkSettings{ + MacAddress: windowsStyleMAC, + } + } + cu.Devices = append(cu.Devices, dev) + } else { + logrus.Debugln("No network interface") + } + + configurationb, err := json.Marshal(cu) + if err != nil { + return execdriver.ExitStatus{ExitCode: -1}, err + } + + configuration := string(configurationb) + + err = hcsshim.CreateComputeSystem(c.ID, configuration) + if err != nil { + logrus.Debugln("Failed to create temporary container ", err) + return execdriver.ExitStatus{ExitCode: -1}, err + } + + // Start the container + logrus.Debugln("Starting container ", c.ID) + err = hcsshim.StartComputeSystem(c.ID) + if err != nil { + logrus.Errorf("Failed to start compute system: %s", err) + return execdriver.ExitStatus{ExitCode: -1}, err + } + defer func() { + // Stop the container + + if terminateMode { + logrus.Debugf("Terminating container %s", c.ID) + if err := hcsshim.TerminateComputeSystem(c.ID); err != nil { + // IMPORTANT: Don't fail if fails to change state. It could already + // have been stopped through kill(). + // Otherwise, the docker daemon will hang in job wait() + logrus.Warnf("Ignoring error from TerminateComputeSystem %s", err) + } + } else { + logrus.Debugf("Shutting down container %s", c.ID) + if err := hcsshim.ShutdownComputeSystem(c.ID); err != nil { + // IMPORTANT: Don't fail if fails to change state. It could already + // have been stopped through kill(). + // Otherwise, the docker daemon will hang in job wait() + logrus.Warnf("Ignoring error from ShutdownComputeSystem %s", err) + } + } + }() + + createProcessParms := hcsshim.CreateProcessParams{ + EmulateConsole: c.ProcessConfig.Tty, + WorkingDirectory: c.WorkingDir, + ConsoleSize: c.ProcessConfig.ConsoleSize, + } + + // Configure the environment for the process + createProcessParms.Environment = setupEnvironmentVariables(c.ProcessConfig.Env) + + // This should get caught earlier, but just in case - validate that we + // have something to run + if c.ProcessConfig.Entrypoint == "" { + err = errors.New("No entrypoint specified") + logrus.Error(err) + return execdriver.ExitStatus{ExitCode: -1}, err + } + + // Build the command line of the process + createProcessParms.CommandLine = c.ProcessConfig.Entrypoint + for _, arg := range c.ProcessConfig.Arguments { + logrus.Debugln("appending ", arg) + createProcessParms.CommandLine += " " + syscall.EscapeArg(arg) + } + logrus.Debugf("CommandLine: %s", createProcessParms.CommandLine) + + // Start the command running in the container. + pid, stdin, stdout, stderr, err := hcsshim.CreateProcessInComputeSystem(c.ID, pipes.Stdin != nil, true, !c.ProcessConfig.Tty, createProcessParms) + if err != nil { + logrus.Errorf("CreateProcessInComputeSystem() failed %s", err) + return execdriver.ExitStatus{ExitCode: -1}, err + } + + // Now that the process has been launched, begin copying data to and from + // the named pipes for the std handles. + setupPipes(stdin, stdout, stderr, pipes) + + //Save the PID as we'll need this in Kill() + logrus.Debugf("PID %d", pid) + c.ContainerPid = int(pid) + + if c.ProcessConfig.Tty { + term = NewTtyConsole(c.ID, pid) + } else { + term = NewStdConsole() + } + c.ProcessConfig.Terminal = term + + // Maintain our list of active containers. We'll need this later for exec + // and other commands. + d.Lock() + d.activeContainers[c.ID] = &activeContainer{ + command: c, + } + d.Unlock() + + if hooks.Start != nil { + // A closed channel for OOM is returned here as it will be + // non-blocking and return the correct result when read. + chOOM := make(chan struct{}) + close(chOOM) + hooks.Start(&c.ProcessConfig, int(pid), chOOM) + } + + var exitCode int32 + exitCode, err = hcsshim.WaitForProcessInComputeSystem(c.ID, pid) + if err != nil { + logrus.Errorf("Failed to WaitForProcessInComputeSystem %s", err) + return execdriver.ExitStatus{ExitCode: -1}, err + } + + logrus.Debugf("Exiting Run() exitCode %d id=%s", exitCode, c.ID) + return execdriver.ExitStatus{ExitCode: int(exitCode)}, nil +} + +// SupportsHooks implements the execdriver Driver interface. +// The windows driver does not support the hook mechanism +func (d *Driver) SupportsHooks() bool { + return false +} diff --git a/daemon/execdriver/windows/stats.go b/daemon/execdriver/windows/stats.go new file mode 100644 index 0000000000..25bd49eaed --- /dev/null +++ b/daemon/execdriver/windows/stats.go @@ -0,0 +1,14 @@ +// +build windows + +package windows + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" +) + +// Stats implements the exec driver Driver interface. +func (d *Driver) Stats(id string) (*execdriver.ResourceStats, error) { + return nil, fmt.Errorf("Windows: Stats not implemented") +} diff --git a/daemon/execdriver/windows/stdconsole.go b/daemon/execdriver/windows/stdconsole.go new file mode 100644 index 0000000000..fb1eda2a20 --- /dev/null +++ b/daemon/execdriver/windows/stdconsole.go @@ -0,0 +1,24 @@ +// +build windows + +package windows + +// StdConsole is for when using a container non-interactively +type StdConsole struct { +} + +// NewStdConsole returns a new StdConsole struct. +func NewStdConsole() *StdConsole { + return &StdConsole{} +} + +// Resize implements Resize method of Terminal interface. +func (s *StdConsole) Resize(h, w int) error { + // we do not need to resize a non tty + return nil +} + +// Close implements Close method of Terminal interface. +func (s *StdConsole) Close() error { + // nothing to close here + return nil +} diff --git a/daemon/execdriver/windows/terminatekill.go b/daemon/execdriver/windows/terminatekill.go new file mode 100644 index 0000000000..06333203e0 --- /dev/null +++ b/daemon/execdriver/windows/terminatekill.go @@ -0,0 +1,47 @@ +// +build windows + +package windows + +import ( + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/microsoft/hcsshim" +) + +// Terminate implements the exec driver Driver interface. +func (d *Driver) Terminate(p *execdriver.Command) error { + logrus.Debugf("WindowsExec: Terminate() id=%s", p.ID) + return kill(p.ID, p.ContainerPid) +} + +// Kill implements the exec driver Driver interface. +func (d *Driver) Kill(p *execdriver.Command, sig int) error { + logrus.Debugf("WindowsExec: Kill() id=%s sig=%d", p.ID, sig) + return kill(p.ID, p.ContainerPid) +} + +func kill(id string, pid int) error { + logrus.Debugln("kill() ", id, pid) + var err error + + // Terminate Process + if err = hcsshim.TerminateProcessInComputeSystem(id, uint32(pid)); err != nil { + logrus.Warnf("Failed to terminate pid %d in %s: %q", pid, id, err) + // Ignore errors + err = nil + } + + if terminateMode { + // Terminate the compute system + if err = hcsshim.TerminateComputeSystem(id); err != nil { + logrus.Errorf("Failed to terminate %s - %q", id, err) + } + + } else { + // Shutdown the compute system + if err = hcsshim.ShutdownComputeSystem(id); err != nil { + logrus.Errorf("Failed to shutdown %s - %q", id, err) + } + } + return err +} diff --git a/daemon/execdriver/windows/ttyconsole.go b/daemon/execdriver/windows/ttyconsole.go new file mode 100644 index 0000000000..ca6b1ca273 --- /dev/null +++ b/daemon/execdriver/windows/ttyconsole.go @@ -0,0 +1,32 @@ +// +build windows + +package windows + +import ( + "github.com/microsoft/hcsshim" +) + +// TtyConsole implements the exec driver Terminal interface. +type TtyConsole struct { + id string + processid uint32 +} + +// NewTtyConsole returns a new TtyConsole struct. +func NewTtyConsole(id string, processid uint32) *TtyConsole { + tty := &TtyConsole{ + id: id, + processid: processid, + } + return tty +} + +// Resize implements Resize method of Terminal interface. +func (t *TtyConsole) Resize(h, w int) error { + return hcsshim.ResizeConsoleInComputeSystem(t.id, t.processid, h, w) +} + +// Close implements Close method of Terminal interface. +func (t *TtyConsole) Close() error { + return nil +} diff --git a/daemon/execdriver/windows/unsupported.go b/daemon/execdriver/windows/unsupported.go new file mode 100644 index 0000000000..89be21f9a9 --- /dev/null +++ b/daemon/execdriver/windows/unsupported.go @@ -0,0 +1,14 @@ +// +build !windows + +package windows + +import ( + "fmt" + + "github.com/docker/docker/daemon/execdriver" +) + +// NewDriver returns a new execdriver.Driver +func NewDriver(root, initPath string) (execdriver.Driver, error) { + return nil, fmt.Errorf("Windows driver not supported on non-Windows") +} diff --git a/daemon/execdriver/windows/windows.go b/daemon/execdriver/windows/windows.go new file mode 100644 index 0000000000..198ddc8dd7 --- /dev/null +++ b/daemon/execdriver/windows/windows.go @@ -0,0 +1,95 @@ +// +build windows + +package windows + +import ( + "fmt" + "strings" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/pkg/parsers" +) + +// This is a daemon development variable only and should not be +// used for running production containers on Windows. +var dummyMode bool + +// This allows the daemon to terminate containers rather than shutdown +var terminateMode bool + +// Define name and version for windows +var ( + DriverName = "Windows 1854" + Version = dockerversion.VERSION + " " + dockerversion.GITCOMMIT +) + +type activeContainer struct { + command *execdriver.Command +} + +// Driver contains all information for windows driver, +// it implements execdriver.Driver +type Driver struct { + root string + initPath string + activeContainers map[string]*activeContainer + sync.Mutex +} + +// Name implements the exec driver Driver interface. +func (d *Driver) Name() string { + return fmt.Sprintf("%s %s", DriverName, Version) +} + +// NewDriver returns a new windows driver, called from NewDriver of execdriver. +func NewDriver(root, initPath string, options []string) (*Driver, error) { + + for _, option := range options { + key, val, err := parsers.ParseKeyValueOpt(option) + if err != nil { + return nil, err + } + key = strings.ToLower(key) + switch key { + + case "dummy": + switch val { + case "1": + dummyMode = true + logrus.Warn("Using dummy mode in Windows exec driver. This is for development use only!") + } + + case "terminate": + switch val { + case "1": + terminateMode = true + logrus.Warn("Using terminate mode in Windows exec driver. This is for testing purposes only.") + } + + default: + return nil, fmt.Errorf("Unrecognised exec driver option %s\n", key) + } + } + + return &Driver{ + root: root, + initPath: initPath, + activeContainers: make(map[string]*activeContainer), + }, nil +} + +// setupEnvironmentVariables convert a string array of environment variables +// into a map as required by the HCS. Source array is in format [v1=k1] [v2=k2] etc. +func setupEnvironmentVariables(a []string) map[string]string { + r := make(map[string]string) + for _, s := range a { + arr := strings.Split(s, "=") + if len(arr) == 2 { + r[arr[0]] = arr[1] + } + } + return r +} diff --git a/daemon/export.go b/daemon/export.go new file mode 100644 index 0000000000..d470e5d584 --- /dev/null +++ b/daemon/export.go @@ -0,0 +1,28 @@ +package daemon + +import ( + "io" + + derr "github.com/docker/docker/errors" +) + +// ContainerExport writes the contents of the container to the given +// writer. An error is returned if the container cannot be found. +func (daemon *Daemon) ContainerExport(name string, out io.Writer) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + data, err := container.export() + if err != nil { + return derr.ErrorCodeExportFailed.WithArgs(name, err) + } + defer data.Close() + + // Stream the entire contents of the container (basically a volatile snapshot) + if _, err := io.Copy(out, data); err != nil { + return derr.ErrorCodeExportFailed.WithArgs(name, err) + } + return nil +} diff --git a/daemon/graphdriver/aufs/aufs.go b/daemon/graphdriver/aufs/aufs.go new file mode 100644 index 0000000000..1589da6fc8 --- /dev/null +++ b/daemon/graphdriver/aufs/aufs.go @@ -0,0 +1,560 @@ +// +build linux + +/* + +aufs driver directory structure + + . + ├── layers // Metadata of layers + │ ├── 1 + │ ├── 2 + │ └── 3 + ├── diff // Content of the layer + │ ├── 1 // Contains layers that need to be mounted for the id + │ ├── 2 + │ └── 3 + └── mnt // Mount points for the rw layers to be mounted + ├── 1 + ├── 2 + └── 3 + +*/ + +package aufs + +import ( + "bufio" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path" + "strings" + "sync" + "syscall" + + "github.com/Sirupsen/logrus" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/directory" + "github.com/docker/docker/pkg/idtools" + mountpk "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/stringid" + + "github.com/opencontainers/runc/libcontainer/label" +) + +var ( + // ErrAufsNotSupported is returned if aufs is not supported by the host. + ErrAufsNotSupported = fmt.Errorf("AUFS was not found in /proc/filesystems") + incompatibleFsMagic = []graphdriver.FsMagic{ + graphdriver.FsMagicBtrfs, + graphdriver.FsMagicAufs, + } + backingFs = "" + + enableDirpermLock sync.Once + enableDirperm bool +) + +func init() { + graphdriver.Register("aufs", Init) +} + +type data struct { + referenceCount int + path string +} + +// Driver contains information about the filesystem mounted. +// root of the filesystem +// sync.Mutex to protect against concurrent modifications +// active maps mount id to the count +type Driver struct { + root string + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap + sync.Mutex // Protects concurrent modification to active + active map[string]*data +} + +// Init returns a new AUFS driver. +// An error is returned if AUFS is not supported. +func Init(root string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + + // Try to load the aufs kernel module + if err := supportsAufs(); err != nil { + return nil, graphdriver.ErrNotSupported + } + + fsMagic, err := graphdriver.GetFSMagic(root) + if err != nil { + return nil, err + } + if fsName, ok := graphdriver.FsNames[fsMagic]; ok { + backingFs = fsName + } + + for _, magic := range incompatibleFsMagic { + if fsMagic == magic { + return nil, graphdriver.ErrIncompatibleFS + } + } + + paths := []string{ + "mnt", + "diff", + "layers", + } + + a := &Driver{ + root: root, + active: make(map[string]*data), + uidMaps: uidMaps, + gidMaps: gidMaps, + } + + rootUID, rootGID, err := idtools.GetRootUIDGID(uidMaps, gidMaps) + if err != nil { + return nil, err + } + // Create the root aufs driver dir and return + // if it already exists + // If not populate the dir structure + if err := idtools.MkdirAllAs(root, 0755, rootUID, rootGID); err != nil { + if os.IsExist(err) { + return a, nil + } + return nil, err + } + + if err := mountpk.MakePrivate(root); err != nil { + return nil, err + } + + // Populate the dir structure + for _, p := range paths { + if err := idtools.MkdirAllAs(path.Join(root, p), 0755, rootUID, rootGID); err != nil { + return nil, err + } + } + return a, nil +} + +// Return a nil error if the kernel supports aufs +// We cannot modprobe because inside dind modprobe fails +// to run +func supportsAufs() error { + // We can try to modprobe aufs first before looking at + // proc/filesystems for when aufs is supported + exec.Command("modprobe", "aufs").Run() + + f, err := os.Open("/proc/filesystems") + if err != nil { + return err + } + defer f.Close() + + s := bufio.NewScanner(f) + for s.Scan() { + if strings.Contains(s.Text(), "aufs") { + return nil + } + } + return ErrAufsNotSupported +} + +func (a *Driver) rootPath() string { + return a.root +} + +func (*Driver) String() string { + return "aufs" +} + +// Status returns current information about the filesystem such as root directory, number of directories mounted, etc. +func (a *Driver) Status() [][2]string { + ids, _ := loadIds(path.Join(a.rootPath(), "layers")) + return [][2]string{ + {"Root Dir", a.rootPath()}, + {"Backing Filesystem", backingFs}, + {"Dirs", fmt.Sprintf("%d", len(ids))}, + {"Dirperm1 Supported", fmt.Sprintf("%v", useDirperm())}, + } +} + +// GetMetadata not implemented +func (a *Driver) GetMetadata(id string) (map[string]string, error) { + return nil, nil +} + +// Exists returns true if the given id is registered with +// this driver +func (a *Driver) Exists(id string) bool { + id = excludeAUFSIncompatibleChars(id) + if _, err := os.Lstat(path.Join(a.rootPath(), "layers", id)); err != nil { + return false + } + return true +} + +// Create three folders for each id +// mnt, layers, and diff +func (a *Driver) Create(id, parent string) error { + id = excludeAUFSIncompatibleChars(id) + parent = excludeAUFSIncompatibleChars(parent) + + if err := a.createDirsFor(id); err != nil { + return err + } + // Write the layers metadata + f, err := os.Create(path.Join(a.rootPath(), "layers", id)) + if err != nil { + return err + } + defer f.Close() + + if parent != "" { + ids, err := getParentIds(a.rootPath(), parent) + if err != nil { + return err + } + + if _, err := fmt.Fprintln(f, parent); err != nil { + return err + } + for _, i := range ids { + if _, err := fmt.Fprintln(f, i); err != nil { + return err + } + } + } + a.active[id] = &data{} + return nil +} + +func (a *Driver) createDirsFor(id string) error { + paths := []string{ + "mnt", + "diff", + } + + rootUID, rootGID, err := idtools.GetRootUIDGID(a.uidMaps, a.gidMaps) + if err != nil { + return err + } + for _, p := range paths { + if err := idtools.MkdirAllAs(path.Join(a.rootPath(), p, id), 0755, rootUID, rootGID); err != nil { + return err + } + } + return nil +} + +// Remove will unmount and remove the given id. +func (a *Driver) Remove(id string) error { + id = excludeAUFSIncompatibleChars(id) + + // Protect the a.active from concurrent access + a.Lock() + defer a.Unlock() + + m := a.active[id] + if m != nil { + if m.referenceCount > 0 { + return nil + } + // Make sure the dir is umounted first + if err := a.unmount(m); err != nil { + return err + } + } + tmpDirs := []string{ + "mnt", + "diff", + } + + // Atomically remove each directory in turn by first moving it out of the + // way (so that docker doesn't find it anymore) before doing removal of + // the whole tree. + for _, p := range tmpDirs { + realPath := path.Join(a.rootPath(), p, id) + tmpPath := path.Join(a.rootPath(), p, fmt.Sprintf("%s-removing", id)) + if err := os.Rename(realPath, tmpPath); err != nil && !os.IsNotExist(err) { + return err + } + defer os.RemoveAll(tmpPath) + } + // Remove the layers file for the id + if err := os.Remove(path.Join(a.rootPath(), "layers", id)); err != nil && !os.IsNotExist(err) { + return err + } + return nil +} + +// Get returns the rootfs path for the id. +// This will mount the dir at it's given path +func (a *Driver) Get(id, mountLabel string) (string, error) { + id = excludeAUFSIncompatibleChars(id) + + ids, err := getParentIds(a.rootPath(), id) + if err != nil { + if !os.IsNotExist(err) { + return "", err + } + ids = []string{} + } + + // Protect the a.active from concurrent access + a.Lock() + defer a.Unlock() + + m := a.active[id] + if m == nil { + m = &data{} + a.active[id] = m + } + + // If a dir does not have a parent ( no layers )do not try to mount + // just return the diff path to the data + m.path = path.Join(a.rootPath(), "diff", id) + if len(ids) > 0 { + m.path = path.Join(a.rootPath(), "mnt", id) + if m.referenceCount == 0 { + if err := a.mount(id, m, mountLabel); err != nil { + return "", err + } + } + } + m.referenceCount++ + return m.path, nil +} + +// Put unmounts and updates list of active mounts. +func (a *Driver) Put(id string) error { + id = excludeAUFSIncompatibleChars(id) + + // Protect the a.active from concurrent access + a.Lock() + defer a.Unlock() + + m := a.active[id] + if m == nil { + return nil + } + if count := m.referenceCount; count > 1 { + m.referenceCount = count - 1 + } else { + ids, _ := getParentIds(a.rootPath(), id) + // We only mounted if there are any parents + if ids != nil && len(ids) > 0 { + a.unmount(m) + } + delete(a.active, id) + } + return nil +} + +// Diff produces an archive of the changes between the specified +// layer and its parent layer which may be "". +func (a *Driver) Diff(id, parent string) (archive.Archive, error) { + id = excludeAUFSIncompatibleChars(id) + parent = excludeAUFSIncompatibleChars(parent) + + // AUFS doesn't need the parent layer to produce a diff. + return archive.TarWithOptions(path.Join(a.rootPath(), "diff", id), &archive.TarOptions{ + Compression: archive.Uncompressed, + ExcludePatterns: []string{archive.WhiteoutMetaPrefix + "*", "!" + archive.WhiteoutOpaqueDir}, + UIDMaps: a.uidMaps, + GIDMaps: a.gidMaps, + }) +} + +func (a *Driver) applyDiff(id string, diff archive.Reader) error { + return chrootarchive.UntarUncompressed(diff, path.Join(a.rootPath(), "diff", id), &archive.TarOptions{ + UIDMaps: a.uidMaps, + GIDMaps: a.gidMaps, + }) +} + +// DiffSize calculates the changes between the specified id +// and its parent and returns the size in bytes of the changes +// relative to its base filesystem directory. +func (a *Driver) DiffSize(id, parent string) (size int64, err error) { + id = excludeAUFSIncompatibleChars(id) + parent = excludeAUFSIncompatibleChars(parent) + // AUFS doesn't need the parent layer to calculate the diff size. + return directory.Size(path.Join(a.rootPath(), "diff", id)) +} + +// ApplyDiff extracts the changeset from the given diff into the +// layer with the specified id and parent, returning the size of the +// new layer in bytes. +func (a *Driver) ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error) { + // AUFS doesn't need the parent id to apply the diff. + if err = a.applyDiff(id, diff); err != nil { + return + } + + return a.DiffSize(id, parent) +} + +// Changes produces a list of changes between the specified layer +// and its parent layer. If parent is "", then all changes will be ADD changes. +func (a *Driver) Changes(id, parent string) ([]archive.Change, error) { + id = excludeAUFSIncompatibleChars(id) + parent = excludeAUFSIncompatibleChars(parent) + // AUFS doesn't have snapshots, so we need to get changes from all parent + // layers. + layers, err := a.getParentLayerPaths(id) + if err != nil { + return nil, err + } + return archive.Changes(layers, path.Join(a.rootPath(), "diff", id)) +} + +func (a *Driver) getParentLayerPaths(id string) ([]string, error) { + parentIds, err := getParentIds(a.rootPath(), id) + if err != nil { + return nil, err + } + layers := make([]string, len(parentIds)) + + // Get the diff paths for all the parent ids + for i, p := range parentIds { + layers[i] = path.Join(a.rootPath(), "diff", p) + } + return layers, nil +} + +func (a *Driver) mount(id string, m *data, mountLabel string) error { + // If the id is mounted or we get an error return + if mounted, err := a.mounted(m); err != nil || mounted { + return err + } + + var ( + target = m.path + rw = path.Join(a.rootPath(), "diff", id) + ) + + layers, err := a.getParentLayerPaths(id) + if err != nil { + return err + } + + if err := a.aufsMount(layers, rw, target, mountLabel); err != nil { + return fmt.Errorf("error creating aufs mount to %s: %v", target, err) + } + return nil +} + +func (a *Driver) unmount(m *data) error { + if mounted, err := a.mounted(m); err != nil || !mounted { + return err + } + return Unmount(m.path) +} + +func (a *Driver) mounted(m *data) (bool, error) { + return mountpk.Mounted(m.path) +} + +// Cleanup aufs and unmount all mountpoints +func (a *Driver) Cleanup() error { + for id, m := range a.active { + if err := a.unmount(m); err != nil { + logrus.Errorf("Unmounting %s: %s", stringid.TruncateID(id), err) + } + } + return mountpk.Unmount(a.root) +} + +func (a *Driver) aufsMount(ro []string, rw, target, mountLabel string) (err error) { + defer func() { + if err != nil { + Unmount(target) + } + }() + + // Mount options are clipped to page size(4096 bytes). If there are more + // layers then these are remounted individually using append. + + offset := 54 + if useDirperm() { + offset += len("dirperm1") + } + b := make([]byte, syscall.Getpagesize()-len(mountLabel)-offset) // room for xino & mountLabel + bp := copy(b, fmt.Sprintf("br:%s=rw", rw)) + + firstMount := true + i := 0 + + for { + for ; i < len(ro); i++ { + layer := fmt.Sprintf(":%s=ro+wh", ro[i]) + + if firstMount { + if bp+len(layer) > len(b) { + break + } + bp += copy(b[bp:], layer) + } else { + data := label.FormatMountLabel(fmt.Sprintf("append%s", layer), mountLabel) + if err = mount("none", target, "aufs", syscall.MS_REMOUNT, data); err != nil { + return + } + } + } + + if firstMount { + opts := "dio,xino=/dev/shm/aufs.xino" + if useDirperm() { + opts += ",dirperm1" + } + data := label.FormatMountLabel(fmt.Sprintf("%s,%s", string(b[:bp]), opts), mountLabel) + if err = mount("none", target, "aufs", 0, data); err != nil { + return + } + firstMount = false + } + + if i == len(ro) { + break + } + } + + return +} + +// useDirperm checks dirperm1 mount option can be used with the current +// version of aufs. +func useDirperm() bool { + enableDirpermLock.Do(func() { + base, err := ioutil.TempDir("", "docker-aufs-base") + if err != nil { + logrus.Errorf("error checking dirperm1: %v", err) + return + } + defer os.RemoveAll(base) + + union, err := ioutil.TempDir("", "docker-aufs-union") + if err != nil { + logrus.Errorf("error checking dirperm1: %v", err) + return + } + defer os.RemoveAll(union) + + opts := fmt.Sprintf("br:%s,dirperm1,xino=/dev/shm/aufs.xino", base) + if err := mount("none", union, "aufs", 0, opts); err != nil { + return + } + enableDirperm = true + if err := Unmount(union); err != nil { + logrus.Errorf("error checking dirperm1: failed to unmount %v", err) + } + }) + return enableDirperm +} diff --git a/daemon/graphdriver/aufs/aufs_test.go b/daemon/graphdriver/aufs/aufs_test.go new file mode 100644 index 0000000000..dbe747126c --- /dev/null +++ b/daemon/graphdriver/aufs/aufs_test.go @@ -0,0 +1,734 @@ +// +build linux + +package aufs + +import ( + "crypto/sha256" + "encoding/hex" + "fmt" + "io/ioutil" + "os" + "path" + "testing" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/reexec" +) + +var ( + tmpOuter = path.Join(os.TempDir(), "aufs-tests") + tmp = path.Join(tmpOuter, "aufs") +) + +func init() { + reexec.Init() +} + +func testInit(dir string, t *testing.T) graphdriver.Driver { + d, err := Init(dir, nil, nil, nil) + if err != nil { + if err == graphdriver.ErrNotSupported { + t.Skip(err) + } else { + t.Fatal(err) + } + } + return d +} + +func newDriver(t *testing.T) *Driver { + if err := os.MkdirAll(tmp, 0755); err != nil { + t.Fatal(err) + } + + d := testInit(tmp, t) + return d.(*Driver) +} + +func TestNewDriver(t *testing.T) { + if err := os.MkdirAll(tmp, 0755); err != nil { + t.Fatal(err) + } + + d := testInit(tmp, t) + defer os.RemoveAll(tmp) + if d == nil { + t.Fatalf("Driver should not be nil") + } +} + +func TestAufsString(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if d.String() != "aufs" { + t.Fatalf("Expected aufs got %s", d.String()) + } +} + +func TestCreateDirStructure(t *testing.T) { + newDriver(t) + defer os.RemoveAll(tmp) + + paths := []string{ + "mnt", + "layers", + "diff", + } + + for _, p := range paths { + if _, err := os.Stat(path.Join(tmp, p)); err != nil { + t.Fatal(err) + } + } +} + +// We should be able to create two drivers with the same dir structure +func TestNewDriverFromExistingDir(t *testing.T) { + if err := os.MkdirAll(tmp, 0755); err != nil { + t.Fatal(err) + } + + testInit(tmp, t) + testInit(tmp, t) + os.RemoveAll(tmp) +} + +func TestCreateNewDir(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } +} + +func TestCreateNewDirStructure(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + paths := []string{ + "mnt", + "diff", + "layers", + } + + for _, p := range paths { + if _, err := os.Stat(path.Join(tmp, p, "1")); err != nil { + t.Fatal(err) + } + } +} + +func TestRemoveImage(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + if err := d.Remove("1"); err != nil { + t.Fatal(err) + } + + paths := []string{ + "mnt", + "diff", + "layers", + } + + for _, p := range paths { + if _, err := os.Stat(path.Join(tmp, p, "1")); err == nil { + t.Fatalf("Error should not be nil because dirs with id 1 should be delted: %s", p) + } + } +} + +func TestGetWithoutParent(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + diffPath, err := d.Get("1", "") + if err != nil { + t.Fatal(err) + } + expected := path.Join(tmp, "diff", "1") + if diffPath != expected { + t.Fatalf("Expected path %s got %s", expected, diffPath) + } +} + +func TestCleanupWithNoDirs(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Cleanup(); err != nil { + t.Fatal(err) + } +} + +func TestCleanupWithDir(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + if err := d.Cleanup(); err != nil { + t.Fatal(err) + } +} + +func TestMountedFalseResponse(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + response, err := d.mounted(d.active["1"]) + if err != nil { + t.Fatal(err) + } + + if response != false { + t.Fatalf("Response if dir id 1 is mounted should be false") + } +} + +func TestMountedTrueReponse(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + defer d.Cleanup() + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + if err := d.Create("2", "1"); err != nil { + t.Fatal(err) + } + + _, err := d.Get("2", "") + if err != nil { + t.Fatal(err) + } + + response, err := d.mounted(d.active["2"]) + if err != nil { + t.Fatal(err) + } + + if response != true { + t.Fatalf("Response if dir id 2 is mounted should be true") + } +} + +func TestMountWithParent(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + if err := d.Create("2", "1"); err != nil { + t.Fatal(err) + } + + defer func() { + if err := d.Cleanup(); err != nil { + t.Fatal(err) + } + }() + + mntPath, err := d.Get("2", "") + if err != nil { + t.Fatal(err) + } + if mntPath == "" { + t.Fatal("mntPath should not be empty string") + } + + expected := path.Join(tmp, "mnt", "2") + if mntPath != expected { + t.Fatalf("Expected %s got %s", expected, mntPath) + } +} + +func TestRemoveMountedDir(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + if err := d.Create("2", "1"); err != nil { + t.Fatal(err) + } + + defer func() { + if err := d.Cleanup(); err != nil { + t.Fatal(err) + } + }() + + mntPath, err := d.Get("2", "") + if err != nil { + t.Fatal(err) + } + if mntPath == "" { + t.Fatal("mntPath should not be empty string") + } + + mounted, err := d.mounted(d.active["2"]) + if err != nil { + t.Fatal(err) + } + + if !mounted { + t.Fatalf("Dir id 2 should be mounted") + } + + if err := d.Remove("2"); err != nil { + t.Fatal(err) + } +} + +func TestCreateWithInvalidParent(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", "docker"); err == nil { + t.Fatalf("Error should not be nil with parent does not exist") + } +} + +func TestGetDiff(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + diffPath, err := d.Get("1", "") + if err != nil { + t.Fatal(err) + } + + // Add a file to the diff path with a fixed size + size := int64(1024) + + f, err := os.Create(path.Join(diffPath, "test_file")) + if err != nil { + t.Fatal(err) + } + if err := f.Truncate(size); err != nil { + t.Fatal(err) + } + f.Close() + + a, err := d.Diff("1", "") + if err != nil { + t.Fatal(err) + } + if a == nil { + t.Fatalf("Archive should not be nil") + } +} + +func TestChanges(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + if err := d.Create("2", "1"); err != nil { + t.Fatal(err) + } + + defer func() { + if err := d.Cleanup(); err != nil { + t.Fatal(err) + } + }() + + mntPoint, err := d.Get("2", "") + if err != nil { + t.Fatal(err) + } + + // Create a file to save in the mountpoint + f, err := os.Create(path.Join(mntPoint, "test.txt")) + if err != nil { + t.Fatal(err) + } + + if _, err := f.WriteString("testline"); err != nil { + t.Fatal(err) + } + if err := f.Close(); err != nil { + t.Fatal(err) + } + + changes, err := d.Changes("2", "") + if err != nil { + t.Fatal(err) + } + if len(changes) != 1 { + t.Fatalf("Dir 2 should have one change from parent got %d", len(changes)) + } + change := changes[0] + + expectedPath := "/test.txt" + if change.Path != expectedPath { + t.Fatalf("Expected path %s got %s", expectedPath, change.Path) + } + + if change.Kind != archive.ChangeAdd { + t.Fatalf("Change kind should be ChangeAdd got %s", change.Kind) + } + + if err := d.Create("3", "2"); err != nil { + t.Fatal(err) + } + mntPoint, err = d.Get("3", "") + if err != nil { + t.Fatal(err) + } + + // Create a file to save in the mountpoint + f, err = os.Create(path.Join(mntPoint, "test2.txt")) + if err != nil { + t.Fatal(err) + } + + if _, err := f.WriteString("testline"); err != nil { + t.Fatal(err) + } + if err := f.Close(); err != nil { + t.Fatal(err) + } + + changes, err = d.Changes("3", "") + if err != nil { + t.Fatal(err) + } + + if len(changes) != 1 { + t.Fatalf("Dir 2 should have one change from parent got %d", len(changes)) + } + change = changes[0] + + expectedPath = "/test2.txt" + if change.Path != expectedPath { + t.Fatalf("Expected path %s got %s", expectedPath, change.Path) + } + + if change.Kind != archive.ChangeAdd { + t.Fatalf("Change kind should be ChangeAdd got %s", change.Kind) + } +} + +func TestDiffSize(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + diffPath, err := d.Get("1", "") + if err != nil { + t.Fatal(err) + } + + // Add a file to the diff path with a fixed size + size := int64(1024) + + f, err := os.Create(path.Join(diffPath, "test_file")) + if err != nil { + t.Fatal(err) + } + if err := f.Truncate(size); err != nil { + t.Fatal(err) + } + s, err := f.Stat() + if err != nil { + t.Fatal(err) + } + size = s.Size() + if err := f.Close(); err != nil { + t.Fatal(err) + } + + diffSize, err := d.DiffSize("1", "") + if err != nil { + t.Fatal(err) + } + if diffSize != size { + t.Fatalf("Expected size to be %d got %d", size, diffSize) + } +} + +func TestChildDiffSize(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + defer d.Cleanup() + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + diffPath, err := d.Get("1", "") + if err != nil { + t.Fatal(err) + } + + // Add a file to the diff path with a fixed size + size := int64(1024) + + f, err := os.Create(path.Join(diffPath, "test_file")) + if err != nil { + t.Fatal(err) + } + if err := f.Truncate(size); err != nil { + t.Fatal(err) + } + s, err := f.Stat() + if err != nil { + t.Fatal(err) + } + size = s.Size() + if err := f.Close(); err != nil { + t.Fatal(err) + } + + diffSize, err := d.DiffSize("1", "") + if err != nil { + t.Fatal(err) + } + if diffSize != size { + t.Fatalf("Expected size to be %d got %d", size, diffSize) + } + + if err := d.Create("2", "1"); err != nil { + t.Fatal(err) + } + + diffSize, err = d.DiffSize("2", "") + if err != nil { + t.Fatal(err) + } + // The diff size for the child should be zero + if diffSize != 0 { + t.Fatalf("Expected size to be %d got %d", 0, diffSize) + } +} + +func TestExists(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + defer d.Cleanup() + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + if d.Exists("none") { + t.Fatal("id name should not exist in the driver") + } + + if !d.Exists("1") { + t.Fatal("id 1 should exist in the driver") + } +} + +func TestStatus(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + defer d.Cleanup() + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + status := d.Status() + if status == nil || len(status) == 0 { + t.Fatal("Status should not be nil or empty") + } + rootDir := status[0] + dirs := status[2] + if rootDir[0] != "Root Dir" { + t.Fatalf("Expected Root Dir got %s", rootDir[0]) + } + if rootDir[1] != d.rootPath() { + t.Fatalf("Expected %s got %s", d.rootPath(), rootDir[1]) + } + if dirs[0] != "Dirs" { + t.Fatalf("Expected Dirs got %s", dirs[0]) + } + if dirs[1] != "1" { + t.Fatalf("Expected 1 got %s", dirs[1]) + } +} + +func TestApplyDiff(t *testing.T) { + d := newDriver(t) + defer os.RemoveAll(tmp) + defer d.Cleanup() + + if err := d.Create("1", ""); err != nil { + t.Fatal(err) + } + + diffPath, err := d.Get("1", "") + if err != nil { + t.Fatal(err) + } + + // Add a file to the diff path with a fixed size + size := int64(1024) + + f, err := os.Create(path.Join(diffPath, "test_file")) + if err != nil { + t.Fatal(err) + } + if err := f.Truncate(size); err != nil { + t.Fatal(err) + } + f.Close() + + diff, err := d.Diff("1", "") + if err != nil { + t.Fatal(err) + } + + if err := d.Create("2", ""); err != nil { + t.Fatal(err) + } + if err := d.Create("3", "2"); err != nil { + t.Fatal(err) + } + + if err := d.applyDiff("3", diff); err != nil { + t.Fatal(err) + } + + // Ensure that the file is in the mount point for id 3 + + mountPoint, err := d.Get("3", "") + if err != nil { + t.Fatal(err) + } + if _, err := os.Stat(path.Join(mountPoint, "test_file")); err != nil { + t.Fatal(err) + } +} + +func hash(c string) string { + h := sha256.New() + fmt.Fprint(h, c) + return hex.EncodeToString(h.Sum(nil)) +} + +func testMountMoreThan42Layers(t *testing.T, mountPath string) { + if err := os.MkdirAll(mountPath, 0755); err != nil { + t.Fatal(err) + } + + defer os.RemoveAll(mountPath) + d := testInit(mountPath, t).(*Driver) + defer d.Cleanup() + var last string + var expected int + + for i := 1; i < 127; i++ { + expected++ + var ( + parent = fmt.Sprintf("%d", i-1) + current = fmt.Sprintf("%d", i) + ) + + if parent == "0" { + parent = "" + } else { + parent = hash(parent) + } + current = hash(current) + + if err := d.Create(current, parent); err != nil { + t.Logf("Current layer %d", i) + t.Error(err) + } + point, err := d.Get(current, "") + if err != nil { + t.Logf("Current layer %d", i) + t.Error(err) + } + f, err := os.Create(path.Join(point, current)) + if err != nil { + t.Logf("Current layer %d", i) + t.Error(err) + } + f.Close() + + if i%10 == 0 { + if err := os.Remove(path.Join(point, parent)); err != nil { + t.Logf("Current layer %d", i) + t.Error(err) + } + expected-- + } + last = current + } + + // Perform the actual mount for the top most image + point, err := d.Get(last, "") + if err != nil { + t.Error(err) + } + files, err := ioutil.ReadDir(point) + if err != nil { + t.Error(err) + } + if len(files) != expected { + t.Errorf("Expected %d got %d", expected, len(files)) + } +} + +func TestMountMoreThan42Layers(t *testing.T) { + os.RemoveAll(tmpOuter) + testMountMoreThan42Layers(t, tmp) +} + +func TestMountMoreThan42LayersMatchingPathLength(t *testing.T) { + defer os.RemoveAll(tmpOuter) + zeroes := "0" + for { + // This finds a mount path so that when combined into aufs mount options + // 4096 byte boundary would be in between the paths or in permission + // section. For '/tmp' it will use '/tmp/aufs-tests/00000000/aufs' + mountPath := path.Join(tmpOuter, zeroes, "aufs") + pathLength := 77 + len(mountPath) + + if mod := 4095 % pathLength; mod == 0 || mod > pathLength-2 { + t.Logf("Using path: %s", mountPath) + testMountMoreThan42Layers(t, mountPath) + return + } + zeroes += "0" + } +} diff --git a/daemon/graphdriver/aufs/dirs.go b/daemon/graphdriver/aufs/dirs.go new file mode 100644 index 0000000000..08f1ffc0ed --- /dev/null +++ b/daemon/graphdriver/aufs/dirs.go @@ -0,0 +1,48 @@ +// +build linux + +package aufs + +import ( + "bufio" + "io/ioutil" + "os" + "path" +) + +// Return all the directories +func loadIds(root string) ([]string, error) { + dirs, err := ioutil.ReadDir(root) + if err != nil { + return nil, err + } + out := []string{} + for _, d := range dirs { + if !d.IsDir() { + out = append(out, d.Name()) + } + } + return out, nil +} + +// Read the layers file for the current id and return all the +// layers represented by new lines in the file +// +// If there are no lines in the file then the id has no parent +// and an empty slice is returned. +func getParentIds(root, id string) ([]string, error) { + f, err := os.Open(path.Join(root, "layers", id)) + if err != nil { + return nil, err + } + defer f.Close() + + out := []string{} + s := bufio.NewScanner(f) + + for s.Scan() { + if t := s.Text(); t != "" { + out = append(out, s.Text()) + } + } + return out, s.Err() +} diff --git a/daemon/graphdriver/aufs/migrate.go b/daemon/graphdriver/aufs/migrate.go new file mode 100644 index 0000000000..2da3c61e5b --- /dev/null +++ b/daemon/graphdriver/aufs/migrate.go @@ -0,0 +1,203 @@ +// +build linux + +package aufs + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "os" + "path" + + "github.com/docker/docker/pkg/idtools" +) + +type metadata struct { + ID string `json:"id"` + ParentID string `json:"parent,omitempty"` + Image string `json:"Image,omitempty"` + + parent *metadata +} + +func pathExists(pth string) bool { + if _, err := os.Stat(pth); err != nil { + return false + } + return true +} + +// Migrate existing images and containers from docker < 0.7.x +// +// The format pre 0.7 is for docker to store the metadata and filesystem +// content in the same directory. For the migration to work we need to move Image layer +// data from /var/lib/docker/graph//layers to the diff of the registered id. +// +// Next we need to migrate the container's rw layer to diff of the driver. After the +// contents are migrated we need to register the image and container ids with the +// driver. +// +// For the migration we try to move the folder containing the layer files, if that +// fails because the data is currently mounted we will fallback to creating a +// symlink. +func (a *Driver) Migrate(pth string, setupInit func(p string, rootUID, rootGID int) error) error { + if pathExists(path.Join(pth, "graph")) { + if err := a.migrateRepositories(pth); err != nil { + return err + } + if err := a.migrateImages(path.Join(pth, "graph")); err != nil { + return err + } + return a.migrateContainers(path.Join(pth, "containers"), setupInit) + } + return nil +} + +func (a *Driver) migrateRepositories(pth string) error { + name := path.Join(pth, "repositories") + if err := os.Rename(name, name+"-aufs"); err != nil && !os.IsNotExist(err) { + return err + } + return nil +} + +func (a *Driver) migrateContainers(pth string, setupInit func(p string, rootUID, rootGID int) error) error { + fis, err := ioutil.ReadDir(pth) + if err != nil { + return err + } + + rootUID, rootGID, err := idtools.GetRootUIDGID(a.uidMaps, a.gidMaps) + if err != nil { + return err + } + + for _, fi := range fis { + if id := fi.Name(); fi.IsDir() && pathExists(path.Join(pth, id, "rw")) { + if err := tryRelocate(path.Join(pth, id, "rw"), path.Join(a.rootPath(), "diff", id)); err != nil { + return err + } + + if !a.Exists(id) { + + metadata, err := loadMetadata(path.Join(pth, id, "config.json")) + if err != nil { + return err + } + + initID := fmt.Sprintf("%s-init", id) + if err := a.Create(initID, metadata.Image); err != nil { + return err + } + + initPath, err := a.Get(initID, "") + if err != nil { + return err + } + // setup init layer + if err := setupInit(initPath, rootUID, rootGID); err != nil { + return err + } + + if err := a.Create(id, initID); err != nil { + return err + } + } + } + } + return nil +} + +func (a *Driver) migrateImages(pth string) error { + fis, err := ioutil.ReadDir(pth) + if err != nil { + return err + } + var ( + m = make(map[string]*metadata) + current *metadata + exists bool + ) + + for _, fi := range fis { + if id := fi.Name(); fi.IsDir() && pathExists(path.Join(pth, id, "layer")) { + if current, exists = m[id]; !exists { + current, err = loadMetadata(path.Join(pth, id, "json")) + if err != nil { + return err + } + m[id] = current + } + } + } + + for _, v := range m { + v.parent = m[v.ParentID] + } + + migrated := make(map[string]bool) + for _, v := range m { + if err := a.migrateImage(v, pth, migrated); err != nil { + return err + } + } + return nil +} + +func (a *Driver) migrateImage(m *metadata, pth string, migrated map[string]bool) error { + if !migrated[m.ID] { + if m.parent != nil { + a.migrateImage(m.parent, pth, migrated) + } + if err := tryRelocate(path.Join(pth, m.ID, "layer"), path.Join(a.rootPath(), "diff", m.ID)); err != nil { + return err + } + if !a.Exists(m.ID) { + if err := a.Create(m.ID, m.ParentID); err != nil { + return err + } + } + migrated[m.ID] = true + } + return nil +} + +// tryRelocate will try to rename the old path to the new pack and if +// the operation fails, it will fallback to a symlink +func tryRelocate(oldPath, newPath string) error { + s, err := os.Lstat(newPath) + if err != nil && !os.IsNotExist(err) { + return err + } + // If the destination is a symlink then we already tried to relocate once before + // and it failed so we delete it and try to remove + if s != nil && s.Mode()&os.ModeSymlink != 0 { + if err := os.RemoveAll(newPath); err != nil { + return err + } + } + if err := os.Rename(oldPath, newPath); err != nil { + if sErr := os.Symlink(oldPath, newPath); sErr != nil { + return fmt.Errorf("Unable to relocate %s to %s: Rename err %s Symlink err %s", oldPath, newPath, err, sErr) + } + } + return nil +} + +func loadMetadata(pth string) (*metadata, error) { + f, err := os.Open(pth) + if err != nil { + return nil, err + } + defer f.Close() + + var ( + out = &metadata{} + dec = json.NewDecoder(f) + ) + + if err := dec.Decode(out); err != nil { + return nil, err + } + return out, nil +} diff --git a/daemon/graphdriver/aufs/mount.go b/daemon/graphdriver/aufs/mount.go new file mode 100644 index 0000000000..d7e9bf9fd7 --- /dev/null +++ b/daemon/graphdriver/aufs/mount.go @@ -0,0 +1,21 @@ +// +build linux + +package aufs + +import ( + "os/exec" + "syscall" + + "github.com/Sirupsen/logrus" +) + +// Unmount the target specified. +func Unmount(target string) error { + if err := exec.Command("auplink", target, "flush").Run(); err != nil { + logrus.Errorf("Couldn't run auplink before unmount: %s", err) + } + if err := syscall.Unmount(target, 0); err != nil { + return err + } + return nil +} diff --git a/daemon/graphdriver/aufs/mount_linux.go b/daemon/graphdriver/aufs/mount_linux.go new file mode 100644 index 0000000000..8062bae420 --- /dev/null +++ b/daemon/graphdriver/aufs/mount_linux.go @@ -0,0 +1,7 @@ +package aufs + +import "syscall" + +func mount(source string, target string, fstype string, flags uintptr, data string) error { + return syscall.Mount(source, target, fstype, flags, data) +} diff --git a/daemon/graphdriver/aufs/mount_unsupported.go b/daemon/graphdriver/aufs/mount_unsupported.go new file mode 100644 index 0000000000..d030b06637 --- /dev/null +++ b/daemon/graphdriver/aufs/mount_unsupported.go @@ -0,0 +1,12 @@ +// +build !linux + +package aufs + +import "errors" + +// MsRemount declared to specify a non-linux system mount. +const MsRemount = 0 + +func mount(source string, target string, fstype string, flags uintptr, data string) (err error) { + return errors.New("mount is not implemented on this platform") +} diff --git a/daemon/graphdriver/btrfs/btrfs.go b/daemon/graphdriver/btrfs/btrfs.go new file mode 100644 index 0000000000..59f98f9886 --- /dev/null +++ b/daemon/graphdriver/btrfs/btrfs.go @@ -0,0 +1,300 @@ +// +build linux + +package btrfs + +/* +#include +#include +#include +#include +*/ +import "C" + +import ( + "fmt" + "os" + "path" + "path/filepath" + "syscall" + "unsafe" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/mount" +) + +func init() { + graphdriver.Register("btrfs", Init) +} + +// Init returns a new BTRFS driver. +// An error is returned if BTRFS is not supported. +func Init(home string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + rootdir := path.Dir(home) + + var buf syscall.Statfs_t + if err := syscall.Statfs(rootdir, &buf); err != nil { + return nil, err + } + + if graphdriver.FsMagic(buf.Type) != graphdriver.FsMagicBtrfs { + return nil, graphdriver.ErrPrerequisites + } + + rootUID, rootGID, err := idtools.GetRootUIDGID(uidMaps, gidMaps) + if err != nil { + return nil, err + } + if err := idtools.MkdirAllAs(home, 0700, rootUID, rootGID); err != nil { + return nil, err + } + + if err := mount.MakePrivate(home); err != nil { + return nil, err + } + + driver := &Driver{ + home: home, + uidMaps: uidMaps, + gidMaps: gidMaps, + } + + return graphdriver.NewNaiveDiffDriver(driver, uidMaps, gidMaps), nil +} + +// Driver contains information about the filesystem mounted. +type Driver struct { + //root of the file system + home string + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +// String prints the name of the driver (btrfs). +func (d *Driver) String() string { + return "btrfs" +} + +// Status returns current driver information in a two dimensional string array. +// Output contains "Build Version" and "Library Version" of the btrfs libraries used. +// Version information can be used to check compatibility with your kernel. +func (d *Driver) Status() [][2]string { + status := [][2]string{} + if bv := btrfsBuildVersion(); bv != "-" { + status = append(status, [2]string{"Build Version", bv}) + } + if lv := btrfsLibVersion(); lv != -1 { + status = append(status, [2]string{"Library Version", fmt.Sprintf("%d", lv)}) + } + return status +} + +// GetMetadata returns empty metadata for this driver. +func (d *Driver) GetMetadata(id string) (map[string]string, error) { + return nil, nil +} + +// Cleanup unmounts the home directory. +func (d *Driver) Cleanup() error { + return mount.Unmount(d.home) +} + +func free(p *C.char) { + C.free(unsafe.Pointer(p)) +} + +func openDir(path string) (*C.DIR, error) { + Cpath := C.CString(path) + defer free(Cpath) + + dir := C.opendir(Cpath) + if dir == nil { + return nil, fmt.Errorf("Can't open dir") + } + return dir, nil +} + +func closeDir(dir *C.DIR) { + if dir != nil { + C.closedir(dir) + } +} + +func getDirFd(dir *C.DIR) uintptr { + return uintptr(C.dirfd(dir)) +} + +func subvolCreate(path, name string) error { + dir, err := openDir(path) + if err != nil { + return err + } + defer closeDir(dir) + + var args C.struct_btrfs_ioctl_vol_args + for i, c := range []byte(name) { + args.name[i] = C.char(c) + } + + _, _, errno := syscall.Syscall(syscall.SYS_IOCTL, getDirFd(dir), C.BTRFS_IOC_SUBVOL_CREATE, + uintptr(unsafe.Pointer(&args))) + if errno != 0 { + return fmt.Errorf("Failed to create btrfs subvolume: %v", errno.Error()) + } + return nil +} + +func subvolSnapshot(src, dest, name string) error { + srcDir, err := openDir(src) + if err != nil { + return err + } + defer closeDir(srcDir) + + destDir, err := openDir(dest) + if err != nil { + return err + } + defer closeDir(destDir) + + var args C.struct_btrfs_ioctl_vol_args_v2 + args.fd = C.__s64(getDirFd(srcDir)) + for i, c := range []byte(name) { + args.name[i] = C.char(c) + } + + _, _, errno := syscall.Syscall(syscall.SYS_IOCTL, getDirFd(destDir), C.BTRFS_IOC_SNAP_CREATE_V2, + uintptr(unsafe.Pointer(&args))) + if errno != 0 { + return fmt.Errorf("Failed to create btrfs snapshot: %v", errno.Error()) + } + return nil +} + +func isSubvolume(p string) (bool, error) { + var bufStat syscall.Stat_t + if err := syscall.Lstat(p, &bufStat); err != nil { + return false, err + } + + // return true if it is a btrfs subvolume + return bufStat.Ino == C.BTRFS_FIRST_FREE_OBJECTID, nil +} + +func subvolDelete(dirpath, name string) error { + dir, err := openDir(dirpath) + if err != nil { + return err + } + defer closeDir(dir) + + var args C.struct_btrfs_ioctl_vol_args + + // walk the btrfs subvolumes + walkSubvolumes := func(p string, f os.FileInfo, err error) error { + // we want to check children only so skip itself + // it will be removed after the filepath walk anyways + if f.IsDir() && p != path.Join(dirpath, name) { + sv, err := isSubvolume(p) + if err != nil { + return fmt.Errorf("Failed to test if %s is a btrfs subvolume: %v", p, err) + } + if sv { + if err := subvolDelete(p, f.Name()); err != nil { + return fmt.Errorf("Failed to destroy btrfs child subvolume (%s) of parent (%s): %v", p, dirpath, err) + } + } + } + return nil + } + if err := filepath.Walk(path.Join(dirpath, name), walkSubvolumes); err != nil { + return fmt.Errorf("Recursively walking subvolumes for %s failed: %v", dirpath, err) + } + + // all subvolumes have been removed + // now remove the one originally passed in + for i, c := range []byte(name) { + args.name[i] = C.char(c) + } + _, _, errno := syscall.Syscall(syscall.SYS_IOCTL, getDirFd(dir), C.BTRFS_IOC_SNAP_DESTROY, + uintptr(unsafe.Pointer(&args))) + if errno != 0 { + return fmt.Errorf("Failed to destroy btrfs snapshot %s for %s: %v", dirpath, name, errno.Error()) + } + return nil +} + +func (d *Driver) subvolumesDir() string { + return path.Join(d.home, "subvolumes") +} + +func (d *Driver) subvolumesDirID(id string) string { + return path.Join(d.subvolumesDir(), id) +} + +// Create the filesystem with given id. +func (d *Driver) Create(id string, parent string) error { + subvolumes := path.Join(d.home, "subvolumes") + rootUID, rootGID, err := idtools.GetRootUIDGID(d.uidMaps, d.gidMaps) + if err != nil { + return err + } + if err := idtools.MkdirAllAs(subvolumes, 0700, rootUID, rootGID); err != nil { + return err + } + if parent == "" { + if err := subvolCreate(subvolumes, id); err != nil { + return err + } + } else { + parentDir, err := d.Get(parent, "") + if err != nil { + return err + } + if err := subvolSnapshot(parentDir, subvolumes, id); err != nil { + return err + } + } + return nil +} + +// Remove the filesystem with given id. +func (d *Driver) Remove(id string) error { + dir := d.subvolumesDirID(id) + if _, err := os.Stat(dir); err != nil { + return err + } + if err := subvolDelete(d.subvolumesDir(), id); err != nil { + return err + } + return os.RemoveAll(dir) +} + +// Get the requested filesystem id. +func (d *Driver) Get(id, mountLabel string) (string, error) { + dir := d.subvolumesDirID(id) + st, err := os.Stat(dir) + if err != nil { + return "", err + } + + if !st.IsDir() { + return "", fmt.Errorf("%s: not a directory", dir) + } + + return dir, nil +} + +// Put is not implemented for BTRFS as there is no cleanup required for the id. +func (d *Driver) Put(id string) error { + // Get() creates no runtime resources (like e.g. mounts) + // so this doesn't need to do anything. + return nil +} + +// Exists checks if the id exists in the filesystem. +func (d *Driver) Exists(id string) bool { + dir := d.subvolumesDirID(id) + _, err := os.Stat(dir) + return err == nil +} diff --git a/daemon/graphdriver/btrfs/btrfs_test.go b/daemon/graphdriver/btrfs/btrfs_test.go new file mode 100644 index 0000000000..32a8bf1741 --- /dev/null +++ b/daemon/graphdriver/btrfs/btrfs_test.go @@ -0,0 +1,31 @@ +// +build linux + +package btrfs + +import ( + "testing" + + "github.com/docker/docker/daemon/graphdriver/graphtest" +) + +// This avoids creating a new driver for each test if all tests are run +// Make sure to put new tests between TestBtrfsSetup and TestBtrfsTeardown +func TestBtrfsSetup(t *testing.T) { + graphtest.GetDriver(t, "btrfs") +} + +func TestBtrfsCreateEmpty(t *testing.T) { + graphtest.DriverTestCreateEmpty(t, "btrfs") +} + +func TestBtrfsCreateBase(t *testing.T) { + graphtest.DriverTestCreateBase(t, "btrfs") +} + +func TestBtrfsCreateSnap(t *testing.T) { + graphtest.DriverTestCreateSnap(t, "btrfs") +} + +func TestBtrfsTeardown(t *testing.T) { + graphtest.PutDriver(t) +} diff --git a/daemon/graphdriver/btrfs/dummy_unsupported.go b/daemon/graphdriver/btrfs/dummy_unsupported.go new file mode 100644 index 0000000000..f07088887a --- /dev/null +++ b/daemon/graphdriver/btrfs/dummy_unsupported.go @@ -0,0 +1,3 @@ +// +build !linux !cgo + +package btrfs diff --git a/daemon/graphdriver/btrfs/version.go b/daemon/graphdriver/btrfs/version.go new file mode 100644 index 0000000000..73d90cdd71 --- /dev/null +++ b/daemon/graphdriver/btrfs/version.go @@ -0,0 +1,26 @@ +// +build linux,!btrfs_noversion + +package btrfs + +/* +#include + +// around version 3.16, they did not define lib version yet +#ifndef BTRFS_LIB_VERSION +#define BTRFS_LIB_VERSION -1 +#endif + +// upstream had removed it, but now it will be coming back +#ifndef BTRFS_BUILD_VERSION +#define BTRFS_BUILD_VERSION "-" +#endif +*/ +import "C" + +func btrfsBuildVersion() string { + return string(C.BTRFS_BUILD_VERSION) +} + +func btrfsLibVersion() int { + return int(C.BTRFS_LIB_VERSION) +} diff --git a/daemon/graphdriver/btrfs/version_none.go b/daemon/graphdriver/btrfs/version_none.go new file mode 100644 index 0000000000..7defec397b --- /dev/null +++ b/daemon/graphdriver/btrfs/version_none.go @@ -0,0 +1,14 @@ +// +build linux,btrfs_noversion + +package btrfs + +// TODO(vbatts) remove this work-around once supported linux distros are on +// btrfs utililties of >= 3.16.1 + +func btrfsBuildVersion() string { + return "-" +} + +func btrfsLibVersion() int { + return -1 +} diff --git a/daemon/graphdriver/btrfs/version_test.go b/daemon/graphdriver/btrfs/version_test.go new file mode 100644 index 0000000000..15a6e75cb3 --- /dev/null +++ b/daemon/graphdriver/btrfs/version_test.go @@ -0,0 +1,13 @@ +// +build linux,!btrfs_noversion + +package btrfs + +import ( + "testing" +) + +func TestLibVersion(t *testing.T) { + if btrfsLibVersion() <= 0 { + t.Errorf("expected output from btrfs lib version > 0") + } +} diff --git a/daemon/graphdriver/devmapper/README.md b/daemon/graphdriver/devmapper/README.md new file mode 100644 index 0000000000..fa9a501cfd --- /dev/null +++ b/daemon/graphdriver/devmapper/README.md @@ -0,0 +1,97 @@ +## devicemapper - a storage backend based on Device Mapper + +### Theory of operation + +The device mapper graphdriver uses the device mapper thin provisioning +module (dm-thinp) to implement CoW snapshots. The preferred model is +to have a thin pool reserved outside of Docker and passed to the +daemon via the `--storage-opt dm.thinpooldev` option. + +As a fallback if no thin pool is provided, loopback files will be +created. Loopback is very slow, but can be used without any +pre-configuration of storage. It is strongly recommended that you do +not use loopback in production. Ensure your Docker daemon has a +`--storage-opt dm.thinpooldev` argument provided. + +In loopback, a thin pool is created at `/var/lib/docker/devicemapper` +(devicemapper graph location) based on two block devices, one for +data and one for metadata. By default these block devices are created +automatically by using loopback mounts of automatically created sparse +files. + +The default loopback files used are +`/var/lib/docker/devicemapper/devicemapper/data` and +`/var/lib/docker/devicemapper/devicemapper/metadata`. Additional metadata +required to map from docker entities to the corresponding devicemapper +volumes is stored in the `/var/lib/docker/devicemapper/devicemapper/json` +file (encoded as Json). + +In order to support multiple devicemapper graphs on a system, the thin +pool will be named something like: `docker-0:33-19478248-pool`, where +the `0:33` part is the minor/major device nr and `19478248` is the +inode number of the `/var/lib/docker/devicemapper` directory. + +On the thin pool, docker automatically creates a base thin device, +called something like `docker-0:33-19478248-base` of a fixed +size. This is automatically formatted with an empty filesystem on +creation. This device is the base of all docker images and +containers. All base images are snapshots of this device and those +images are then in turn used as snapshots for other images and +eventually containers. + +### Information on `docker info` + +As of docker-1.4.1, `docker info` when using the `devicemapper` storage driver +will display something like: + + $ sudo docker info + [...] + Storage Driver: devicemapper + Pool Name: docker-253:1-17538953-pool + Pool Blocksize: 65.54 kB + Base Device Size: 107.4 GB + Data file: /dev/loop4 + Metadata file: /dev/loop4 + Data Space Used: 2.536 GB + Data Space Total: 107.4 GB + Data Space Available: 104.8 GB + Metadata Space Used: 7.93 MB + Metadata Space Total: 2.147 GB + Metadata Space Available: 2.14 GB + Udev Sync Supported: true + Data loop file: /home/docker/devicemapper/devicemapper/data + Metadata loop file: /home/docker/devicemapper/devicemapper/metadata + Library Version: 1.02.82-git (2013-10-04) + [...] + +#### status items + +Each item in the indented section under `Storage Driver: devicemapper` are +status information about the driver. + * `Pool Name` name of the devicemapper pool for this driver. + * `Pool Blocksize` tells the blocksize the thin pool was initialized with. This only changes on creation. + * `Base Device Size` tells the maximum size of a container and image + * `Data file` blockdevice file used for the devicemapper data + * `Metadata file` blockdevice file used for the devicemapper metadata + * `Data Space Used` tells how much of `Data file` is currently used + * `Data Space Total` tells max size the `Data file` + * `Data Space Available` tells how much free space there is in the `Data file`. If you are using a loop device this will report the actual space available to the loop device on the underlying filesystem. + * `Metadata Space Used` tells how much of `Metadata file` is currently used + * `Metadata Space Total` tells max size the `Metadata file` + * `Metadata Space Available` tells how much free space there is in the `Metadata file`. If you are using a loop device this will report the actual space available to the loop device on the underlying filesystem. + * `Udev Sync Supported` tells whether devicemapper is able to sync with Udev. Should be `true`. + * `Data loop file` file attached to `Data file`, if loopback device is used + * `Metadata loop file` file attached to `Metadata file`, if loopback device is used + * `Library Version` from the libdevmapper used + +### About the devicemapper options + +The devicemapper backend supports some options that you can specify +when starting the docker daemon using the `--storage-opt` flags. +This uses the `dm` prefix and would be used something like `docker daemon --storage-opt dm.foo=bar`. + +These options are currently documented both in [the man +page](../../../man/docker.1.md) and in [the online +documentation](https://docs.docker.com/reference/commandline/daemon/#docker- +execdriver-option). If you add an options, update both the `man` page and the +documentation. diff --git a/daemon/graphdriver/devmapper/deviceset.go b/daemon/graphdriver/devmapper/deviceset.go new file mode 100644 index 0000000000..74c0f8faec --- /dev/null +++ b/daemon/graphdriver/devmapper/deviceset.go @@ -0,0 +1,2434 @@ +// +build linux + +package devmapper + +import ( + "bufio" + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "os/exec" + "path" + "path/filepath" + "strconv" + "strings" + "sync" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/devicemapper" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/units" + + "github.com/opencontainers/runc/libcontainer/label" +) + +var ( + defaultDataLoopbackSize int64 = 100 * 1024 * 1024 * 1024 + defaultMetaDataLoopbackSize int64 = 2 * 1024 * 1024 * 1024 + defaultBaseFsSize uint64 = 100 * 1024 * 1024 * 1024 + defaultThinpBlockSize uint32 = 128 // 64K = 128 512b sectors + defaultUdevSyncOverride = false + maxDeviceID = 0xffffff // 24 bit, pool limit + deviceIDMapSz = (maxDeviceID + 1) / 8 + // We retry device removal so many a times that even error messages + // will fill up console during normal operation. So only log Fatal + // messages by default. + logLevel = devicemapper.LogLevelFatal + driverDeferredRemovalSupport = false + enableDeferredRemoval = false + enableDeferredDeletion = false +) + +const deviceSetMetaFile string = "deviceset-metadata" +const transactionMetaFile string = "transaction-metadata" + +type transaction struct { + OpenTransactionID uint64 `json:"open_transaction_id"` + DeviceIDHash string `json:"device_hash"` + DeviceID int `json:"device_id"` +} + +type devInfo struct { + Hash string `json:"-"` + DeviceID int `json:"device_id"` + Size uint64 `json:"size"` + TransactionID uint64 `json:"transaction_id"` + Initialized bool `json:"initialized"` + Deleted bool `json:"deleted"` + devices *DeviceSet + + mountCount int + mountPath string + + // The global DeviceSet lock guarantees that we serialize all + // the calls to libdevmapper (which is not threadsafe), but we + // sometimes release that lock while sleeping. In that case + // this per-device lock is still held, protecting against + // other accesses to the device that we're doing the wait on. + // + // WARNING: In order to avoid AB-BA deadlocks when releasing + // the global lock while holding the per-device locks all + // device locks must be acquired *before* the device lock, and + // multiple device locks should be acquired parent before child. + lock sync.Mutex +} + +type metaData struct { + Devices map[string]*devInfo `json:"Devices"` +} + +// DeviceSet holds information about list of devices +type DeviceSet struct { + metaData `json:"-"` + sync.Mutex `json:"-"` // Protects all fields of DeviceSet and serializes calls into libdevmapper + root string + devicePrefix string + TransactionID uint64 `json:"-"` + NextDeviceID int `json:"next_device_id"` + deviceIDMap []byte + + // Options + dataLoopbackSize int64 + metaDataLoopbackSize int64 + baseFsSize uint64 + filesystem string + mountOptions string + mkfsArgs []string + dataDevice string // block or loop dev + dataLoopFile string // loopback file, if used + metadataDevice string // block or loop dev + metadataLoopFile string // loopback file, if used + doBlkDiscard bool + thinpBlockSize uint32 + thinPoolDevice string + transaction `json:"-"` + overrideUdevSyncCheck bool + deferredRemove bool // use deferred removal + deferredDelete bool // use deferred deletion + BaseDeviceUUID string //save UUID of base device + nrDeletedDevices uint //number of deleted devices + deletionWorkerTicker *time.Ticker + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +// DiskUsage contains information about disk usage and is used when reporting Status of a device. +type DiskUsage struct { + // Used bytes on the disk. + Used uint64 + // Total bytes on the disk. + Total uint64 + // Available bytes on the disk. + Available uint64 +} + +// Status returns the information about the device. +type Status struct { + // PoolName is the name of the data pool. + PoolName string + // DataFile is the actual block device for data. + DataFile string + // DataLoopback loopback file, if used. + DataLoopback string + // MetadataFile is the actual block device for metadata. + MetadataFile string + // MetadataLoopback is the loopback file, if used. + MetadataLoopback string + // Data is the disk used for data. + Data DiskUsage + // Metadata is the disk used for meta data. + Metadata DiskUsage + // BaseDeviceSize is base size of container and image + BaseDeviceSize uint64 + // BaseDeviceFS is backing filesystem. + BaseDeviceFS string + // SectorSize size of the vector. + SectorSize uint64 + // UdevSyncSupported is true if sync is supported. + UdevSyncSupported bool + // DeferredRemoveEnabled is true then the device is not unmounted. + DeferredRemoveEnabled bool + // True if deferred deletion is enabled. This is different from + // deferred removal. "removal" means that device mapper device is + // deactivated. Thin device is still in thin pool and can be activated + // again. But "deletion" means that thin device will be deleted from + // thin pool and it can't be activated again. + DeferredDeleteEnabled bool + DeferredDeletedDeviceCount uint +} + +// Structure used to export image/container metadata in docker inspect. +type deviceMetadata struct { + deviceID int + deviceSize uint64 // size in bytes + deviceName string // Device name as used during activation +} + +// DevStatus returns information about device mounted containing its id, size and sector information. +type DevStatus struct { + // DeviceID is the id of the device. + DeviceID int + // Size is the size of the filesystem. + Size uint64 + // TransactionID is a unique integer per device set used to identify an operation on the file system, this number is incremental. + TransactionID uint64 + // SizeInSectors indicates the size of the sectors allocated. + SizeInSectors uint64 + // MappedSectors indicates number of mapped sectors. + MappedSectors uint64 + // HighestMappedSector is the pointer to the highest mapped sector. + HighestMappedSector uint64 +} + +func getDevName(name string) string { + return "/dev/mapper/" + name +} + +func (info *devInfo) Name() string { + hash := info.Hash + if hash == "" { + hash = "base" + } + return fmt.Sprintf("%s-%s", info.devices.devicePrefix, hash) +} + +func (info *devInfo) DevName() string { + return getDevName(info.Name()) +} + +func (devices *DeviceSet) loopbackDir() string { + return path.Join(devices.root, "devicemapper") +} + +func (devices *DeviceSet) metadataDir() string { + return path.Join(devices.root, "metadata") +} + +func (devices *DeviceSet) metadataFile(info *devInfo) string { + file := info.Hash + if file == "" { + file = "base" + } + return path.Join(devices.metadataDir(), file) +} + +func (devices *DeviceSet) transactionMetaFile() string { + return path.Join(devices.metadataDir(), transactionMetaFile) +} + +func (devices *DeviceSet) deviceSetMetaFile() string { + return path.Join(devices.metadataDir(), deviceSetMetaFile) +} + +func (devices *DeviceSet) oldMetadataFile() string { + return path.Join(devices.loopbackDir(), "json") +} + +func (devices *DeviceSet) getPoolName() string { + if devices.thinPoolDevice == "" { + return devices.devicePrefix + "-pool" + } + return devices.thinPoolDevice +} + +func (devices *DeviceSet) getPoolDevName() string { + return getDevName(devices.getPoolName()) +} + +func (devices *DeviceSet) hasImage(name string) bool { + dirname := devices.loopbackDir() + filename := path.Join(dirname, name) + + _, err := os.Stat(filename) + return err == nil +} + +// ensureImage creates a sparse file of bytes at the path +// /devicemapper/. +// If the file already exists and new size is larger than its current size, it grows to the new size. +// Either way it returns the full path. +func (devices *DeviceSet) ensureImage(name string, size int64) (string, error) { + dirname := devices.loopbackDir() + filename := path.Join(dirname, name) + + uid, gid, err := idtools.GetRootUIDGID(devices.uidMaps, devices.gidMaps) + if err != nil { + return "", err + } + if err := idtools.MkdirAllAs(dirname, 0700, uid, gid); err != nil && !os.IsExist(err) { + return "", err + } + + if fi, err := os.Stat(filename); err != nil { + if !os.IsNotExist(err) { + return "", err + } + logrus.Debugf("Creating loopback file %s for device-manage use", filename) + file, err := os.OpenFile(filename, os.O_RDWR|os.O_CREATE, 0600) + if err != nil { + return "", err + } + defer file.Close() + + if err := file.Truncate(size); err != nil { + return "", err + } + } else { + if fi.Size() < size { + file, err := os.OpenFile(filename, os.O_RDWR|os.O_CREATE, 0600) + if err != nil { + return "", err + } + defer file.Close() + if err := file.Truncate(size); err != nil { + return "", fmt.Errorf("Unable to grow loopback file %s: %v", filename, err) + } + } else if fi.Size() > size { + logrus.Warnf("Can't shrink loopback file %s", filename) + } + } + return filename, nil +} + +func (devices *DeviceSet) allocateTransactionID() uint64 { + devices.OpenTransactionID = devices.TransactionID + 1 + return devices.OpenTransactionID +} + +func (devices *DeviceSet) updatePoolTransactionID() error { + if err := devicemapper.SetTransactionID(devices.getPoolDevName(), devices.TransactionID, devices.OpenTransactionID); err != nil { + return fmt.Errorf("Error setting devmapper transaction ID: %s", err) + } + devices.TransactionID = devices.OpenTransactionID + return nil +} + +func (devices *DeviceSet) removeMetadata(info *devInfo) error { + if err := os.RemoveAll(devices.metadataFile(info)); err != nil { + return fmt.Errorf("Error removing metadata file %s: %s", devices.metadataFile(info), err) + } + return nil +} + +// Given json data and file path, write it to disk +func (devices *DeviceSet) writeMetaFile(jsonData []byte, filePath string) error { + tmpFile, err := ioutil.TempFile(devices.metadataDir(), ".tmp") + if err != nil { + return fmt.Errorf("Error creating metadata file: %s", err) + } + + n, err := tmpFile.Write(jsonData) + if err != nil { + return fmt.Errorf("Error writing metadata to %s: %s", tmpFile.Name(), err) + } + if n < len(jsonData) { + return io.ErrShortWrite + } + if err := tmpFile.Sync(); err != nil { + return fmt.Errorf("Error syncing metadata file %s: %s", tmpFile.Name(), err) + } + if err := tmpFile.Close(); err != nil { + return fmt.Errorf("Error closing metadata file %s: %s", tmpFile.Name(), err) + } + if err := os.Rename(tmpFile.Name(), filePath); err != nil { + return fmt.Errorf("Error committing metadata file %s: %s", tmpFile.Name(), err) + } + + return nil +} + +func (devices *DeviceSet) saveMetadata(info *devInfo) error { + jsonData, err := json.Marshal(info) + if err != nil { + return fmt.Errorf("Error encoding metadata to json: %s", err) + } + if err := devices.writeMetaFile(jsonData, devices.metadataFile(info)); err != nil { + return err + } + return nil +} + +func (devices *DeviceSet) markDeviceIDUsed(deviceID int) { + var mask byte + i := deviceID % 8 + mask = 1 << uint(i) + devices.deviceIDMap[deviceID/8] = devices.deviceIDMap[deviceID/8] | mask +} + +func (devices *DeviceSet) markDeviceIDFree(deviceID int) { + var mask byte + i := deviceID % 8 + mask = ^(1 << uint(i)) + devices.deviceIDMap[deviceID/8] = devices.deviceIDMap[deviceID/8] & mask +} + +func (devices *DeviceSet) isDeviceIDFree(deviceID int) bool { + var mask byte + i := deviceID % 8 + mask = (1 << uint(i)) + if (devices.deviceIDMap[deviceID/8] & mask) != 0 { + return false + } + return true +} + +// Should be called with devices.Lock() held. +func (devices *DeviceSet) lookupDevice(hash string) (*devInfo, error) { + info := devices.Devices[hash] + if info == nil { + info = devices.loadMetadata(hash) + if info == nil { + return nil, fmt.Errorf("Unknown device %s", hash) + } + + devices.Devices[hash] = info + } + return info, nil +} + +func (devices *DeviceSet) lookupDeviceWithLock(hash string) (*devInfo, error) { + devices.Lock() + defer devices.Unlock() + info, err := devices.lookupDevice(hash) + return info, err +} + +// This function relies on that device hash map has been loaded in advance. +// Should be called with devices.Lock() held. +func (devices *DeviceSet) constructDeviceIDMap() { + logrus.Debugf("[deviceset] constructDeviceIDMap()") + defer logrus.Debugf("[deviceset] constructDeviceIDMap() END") + + for _, info := range devices.Devices { + devices.markDeviceIDUsed(info.DeviceID) + logrus.Debugf("Added deviceId=%d to DeviceIdMap", info.DeviceID) + } +} + +func (devices *DeviceSet) deviceFileWalkFunction(path string, finfo os.FileInfo) error { + + // Skip some of the meta files which are not device files. + if strings.HasSuffix(finfo.Name(), ".migrated") { + logrus.Debugf("Skipping file %s", path) + return nil + } + + if strings.HasPrefix(finfo.Name(), ".") { + logrus.Debugf("Skipping file %s", path) + return nil + } + + if finfo.Name() == deviceSetMetaFile { + logrus.Debugf("Skipping file %s", path) + return nil + } + + if finfo.Name() == transactionMetaFile { + logrus.Debugf("Skipping file %s", path) + return nil + } + + logrus.Debugf("Loading data for file %s", path) + + hash := finfo.Name() + if hash == "base" { + hash = "" + } + + // Include deleted devices also as cleanup delete device logic + // will go through it and see if there are any deleted devices. + if _, err := devices.lookupDevice(hash); err != nil { + return fmt.Errorf("Error looking up device %s:%v", hash, err) + } + + return nil +} + +func (devices *DeviceSet) loadDeviceFilesOnStart() error { + logrus.Debugf("[deviceset] loadDeviceFilesOnStart()") + defer logrus.Debugf("[deviceset] loadDeviceFilesOnStart() END") + + var scan = func(path string, info os.FileInfo, err error) error { + if err != nil { + logrus.Debugf("Can't walk the file %s", path) + return nil + } + + // Skip any directories + if info.IsDir() { + return nil + } + + return devices.deviceFileWalkFunction(path, info) + } + + return filepath.Walk(devices.metadataDir(), scan) +} + +// Should be called with devices.Lock() held. +func (devices *DeviceSet) unregisterDevice(id int, hash string) error { + logrus.Debugf("unregisterDevice(%v, %v)", id, hash) + info := &devInfo{ + Hash: hash, + DeviceID: id, + } + + delete(devices.Devices, hash) + + if err := devices.removeMetadata(info); err != nil { + logrus.Debugf("Error removing metadata: %s", err) + return err + } + + return nil +} + +// Should be called with devices.Lock() held. +func (devices *DeviceSet) registerDevice(id int, hash string, size uint64, transactionID uint64) (*devInfo, error) { + logrus.Debugf("registerDevice(%v, %v)", id, hash) + info := &devInfo{ + Hash: hash, + DeviceID: id, + Size: size, + TransactionID: transactionID, + Initialized: false, + devices: devices, + } + + devices.Devices[hash] = info + + if err := devices.saveMetadata(info); err != nil { + // Try to remove unused device + delete(devices.Devices, hash) + return nil, err + } + + return info, nil +} + +func (devices *DeviceSet) activateDeviceIfNeeded(info *devInfo, ignoreDeleted bool) error { + logrus.Debugf("activateDeviceIfNeeded(%v)", info.Hash) + + if info.Deleted && !ignoreDeleted { + return fmt.Errorf("devmapper: Can't activate device %v as it is marked for deletion", info.Hash) + } + + // Make sure deferred removal on device is canceled, if one was + // scheduled. + if err := devices.cancelDeferredRemoval(info); err != nil { + return fmt.Errorf("Deivce Deferred Removal Cancellation Failed: %s", err) + } + + if devinfo, _ := devicemapper.GetInfo(info.Name()); devinfo != nil && devinfo.Exists != 0 { + return nil + } + + return devicemapper.ActivateDevice(devices.getPoolDevName(), info.Name(), info.DeviceID, info.Size) +} + +// Return true only if kernel supports xfs and mkfs.xfs is available +func xfsSupported() bool { + // Make sure mkfs.xfs is available + if _, err := exec.LookPath("mkfs.xfs"); err != nil { + return false + } + + // Check if kernel supports xfs filesystem or not. + exec.Command("modprobe", "xfs").Run() + + f, err := os.Open("/proc/filesystems") + if err != nil { + logrus.Warnf("Could not check if xfs is supported: %v", err) + return false + } + defer f.Close() + + s := bufio.NewScanner(f) + for s.Scan() { + if strings.HasSuffix(s.Text(), "\txfs") { + return true + } + } + + if err := s.Err(); err != nil { + logrus.Warnf("Could not check if xfs is supported: %v", err) + } + return false +} + +func determineDefaultFS() string { + if xfsSupported() { + return "xfs" + } + + logrus.Warn("XFS is not supported in your system. Either the kernel doesnt support it or mkfs.xfs is not in your PATH. Defaulting to ext4 filesystem") + return "ext4" +} + +func (devices *DeviceSet) createFilesystem(info *devInfo) error { + devname := info.DevName() + + args := []string{} + for _, arg := range devices.mkfsArgs { + args = append(args, arg) + } + + args = append(args, devname) + + var err error + + if devices.filesystem == "" { + devices.filesystem = determineDefaultFS() + } + + switch devices.filesystem { + case "xfs": + err = exec.Command("mkfs.xfs", args...).Run() + case "ext4": + err = exec.Command("mkfs.ext4", append([]string{"-E", "nodiscard,lazy_itable_init=0,lazy_journal_init=0"}, args...)...).Run() + if err != nil { + err = exec.Command("mkfs.ext4", append([]string{"-E", "nodiscard,lazy_itable_init=0"}, args...)...).Run() + } + if err != nil { + return err + } + err = exec.Command("tune2fs", append([]string{"-c", "-1", "-i", "0"}, devname)...).Run() + default: + err = fmt.Errorf("Unsupported filesystem type %s", devices.filesystem) + } + if err != nil { + return err + } + + return nil +} + +func (devices *DeviceSet) migrateOldMetaData() error { + // Migrate old metadata file + jsonData, err := ioutil.ReadFile(devices.oldMetadataFile()) + if err != nil && !os.IsNotExist(err) { + return err + } + + if jsonData != nil { + m := metaData{Devices: make(map[string]*devInfo)} + + if err := json.Unmarshal(jsonData, &m); err != nil { + return err + } + + for hash, info := range m.Devices { + info.Hash = hash + devices.saveMetadata(info) + } + if err := os.Rename(devices.oldMetadataFile(), devices.oldMetadataFile()+".migrated"); err != nil { + return err + } + + } + + return nil +} + +// Cleanup deleted devices. It assumes that all the devices have been +// loaded in the hash table. +func (devices *DeviceSet) cleanupDeletedDevices() error { + devices.Lock() + + // If there are no deleted devices, there is nothing to do. + if devices.nrDeletedDevices == 0 { + devices.Unlock() + return nil + } + + var deletedDevices []*devInfo + + for _, info := range devices.Devices { + if !info.Deleted { + continue + } + logrus.Debugf("devmapper: Found deleted device %s.", info.Hash) + deletedDevices = append(deletedDevices, info) + } + + // Delete the deleted devices. DeleteDevice() first takes the info lock + // and then devices.Lock(). So drop it to avoid deadlock. + devices.Unlock() + + for _, info := range deletedDevices { + // This will again try deferred deletion. + if err := devices.DeleteDevice(info.Hash, false); err != nil { + logrus.Warnf("devmapper: Deletion of device %s, device_id=%v failed:%v", info.Hash, info.DeviceID, err) + } + } + + return nil +} + +func (devices *DeviceSet) countDeletedDevices() { + for _, info := range devices.Devices { + if !info.Deleted { + continue + } + devices.nrDeletedDevices++ + } +} + +func (devices *DeviceSet) startDeviceDeletionWorker() { + // Deferred deletion is not enabled. Don't do anything. + if !devices.deferredDelete { + return + } + + logrus.Debugf("devmapper: Worker to cleanup deleted devices started") + for range devices.deletionWorkerTicker.C { + devices.cleanupDeletedDevices() + } +} + +func (devices *DeviceSet) initMetaData() error { + devices.Lock() + defer devices.Unlock() + + if err := devices.migrateOldMetaData(); err != nil { + return err + } + + _, transactionID, _, _, _, _, err := devices.poolStatus() + if err != nil { + return err + } + + devices.TransactionID = transactionID + + if err := devices.loadDeviceFilesOnStart(); err != nil { + return fmt.Errorf("devmapper: Failed to load device files:%v", err) + } + + devices.constructDeviceIDMap() + devices.countDeletedDevices() + + if err := devices.processPendingTransaction(); err != nil { + return err + } + + // Start a goroutine to cleanup Deleted Devices + go devices.startDeviceDeletionWorker() + return nil +} + +func (devices *DeviceSet) incNextDeviceID() { + // IDs are 24bit, so wrap around + devices.NextDeviceID = (devices.NextDeviceID + 1) & maxDeviceID +} + +func (devices *DeviceSet) getNextFreeDeviceID() (int, error) { + devices.incNextDeviceID() + for i := 0; i <= maxDeviceID; i++ { + if devices.isDeviceIDFree(devices.NextDeviceID) { + devices.markDeviceIDUsed(devices.NextDeviceID) + return devices.NextDeviceID, nil + } + devices.incNextDeviceID() + } + + return 0, fmt.Errorf("Unable to find a free device ID") +} + +func (devices *DeviceSet) createRegisterDevice(hash string) (*devInfo, error) { + devices.Lock() + defer devices.Unlock() + + deviceID, err := devices.getNextFreeDeviceID() + if err != nil { + return nil, err + } + + if err := devices.openTransaction(hash, deviceID); err != nil { + logrus.Debugf("Error opening transaction hash = %s deviceID = %d", hash, deviceID) + devices.markDeviceIDFree(deviceID) + return nil, err + } + + for { + if err := devicemapper.CreateDevice(devices.getPoolDevName(), deviceID); err != nil { + if devicemapper.DeviceIDExists(err) { + // Device ID already exists. This should not + // happen. Now we have a mechianism to find + // a free device ID. So something is not right. + // Give a warning and continue. + logrus.Errorf("Device ID %d exists in pool but it is supposed to be unused", deviceID) + deviceID, err = devices.getNextFreeDeviceID() + if err != nil { + return nil, err + } + // Save new device id into transaction + devices.refreshTransaction(deviceID) + continue + } + logrus.Debugf("Error creating device: %s", err) + devices.markDeviceIDFree(deviceID) + return nil, err + } + break + } + + logrus.Debugf("Registering device (id %v) with FS size %v", deviceID, devices.baseFsSize) + info, err := devices.registerDevice(deviceID, hash, devices.baseFsSize, devices.OpenTransactionID) + if err != nil { + _ = devicemapper.DeleteDevice(devices.getPoolDevName(), deviceID) + devices.markDeviceIDFree(deviceID) + return nil, err + } + + if err := devices.closeTransaction(); err != nil { + devices.unregisterDevice(deviceID, hash) + devicemapper.DeleteDevice(devices.getPoolDevName(), deviceID) + devices.markDeviceIDFree(deviceID) + return nil, err + } + return info, nil +} + +func (devices *DeviceSet) createRegisterSnapDevice(hash string, baseInfo *devInfo) error { + deviceID, err := devices.getNextFreeDeviceID() + if err != nil { + return err + } + + if err := devices.openTransaction(hash, deviceID); err != nil { + logrus.Debugf("Error opening transaction hash = %s deviceID = %d", hash, deviceID) + devices.markDeviceIDFree(deviceID) + return err + } + + for { + if err := devicemapper.CreateSnapDevice(devices.getPoolDevName(), deviceID, baseInfo.Name(), baseInfo.DeviceID); err != nil { + if devicemapper.DeviceIDExists(err) { + // Device ID already exists. This should not + // happen. Now we have a mechianism to find + // a free device ID. So something is not right. + // Give a warning and continue. + logrus.Errorf("Device ID %d exists in pool but it is supposed to be unused", deviceID) + deviceID, err = devices.getNextFreeDeviceID() + if err != nil { + return err + } + // Save new device id into transaction + devices.refreshTransaction(deviceID) + continue + } + logrus.Debugf("Error creating snap device: %s", err) + devices.markDeviceIDFree(deviceID) + return err + } + break + } + + if _, err := devices.registerDevice(deviceID, hash, baseInfo.Size, devices.OpenTransactionID); err != nil { + devicemapper.DeleteDevice(devices.getPoolDevName(), deviceID) + devices.markDeviceIDFree(deviceID) + logrus.Debugf("Error registering device: %s", err) + return err + } + + if err := devices.closeTransaction(); err != nil { + devices.unregisterDevice(deviceID, hash) + devicemapper.DeleteDevice(devices.getPoolDevName(), deviceID) + devices.markDeviceIDFree(deviceID) + return err + } + return nil +} + +func (devices *DeviceSet) loadMetadata(hash string) *devInfo { + info := &devInfo{Hash: hash, devices: devices} + + jsonData, err := ioutil.ReadFile(devices.metadataFile(info)) + if err != nil { + return nil + } + + if err := json.Unmarshal(jsonData, &info); err != nil { + return nil + } + + if info.DeviceID > maxDeviceID { + logrus.Errorf("Ignoring Invalid DeviceId=%d", info.DeviceID) + return nil + } + + return info +} + +func getDeviceUUID(device string) (string, error) { + out, err := exec.Command("blkid", "-s", "UUID", "-o", "value", device).Output() + if err != nil { + logrus.Debugf("Failed to find uuid for device %s:%v", device, err) + return "", err + } + + uuid := strings.TrimSuffix(string(out), "\n") + uuid = strings.TrimSpace(uuid) + logrus.Debugf("UUID for device: %s is:%s", device, uuid) + return uuid, nil +} + +func (devices *DeviceSet) getBaseDeviceSize() uint64 { + info, _ := devices.lookupDevice("") + if info == nil { + return 0 + } + return info.Size +} + +func (devices *DeviceSet) getBaseDeviceFS() string { + return devices.filesystem +} + +func (devices *DeviceSet) verifyBaseDeviceUUIDFS(baseInfo *devInfo) error { + devices.Lock() + defer devices.Unlock() + + if err := devices.activateDeviceIfNeeded(baseInfo, false); err != nil { + return err + } + + defer devices.deactivateDevice(baseInfo) + + uuid, err := getDeviceUUID(baseInfo.DevName()) + if err != nil { + return err + } + + if devices.BaseDeviceUUID != uuid { + return fmt.Errorf("Current Base Device UUID:%s does not match with stored UUID:%s. Possibly using a different thin pool than last invocation", uuid, devices.BaseDeviceUUID) + } + + // If user specified a filesystem using dm.fs option and current + // file system of base image is not same, warn user that dm.fs + // will be ignored. + if devices.filesystem != "" { + fs, err := ProbeFsType(baseInfo.DevName()) + if err != nil { + return err + } + + if fs != devices.filesystem { + logrus.Warnf("Base device already exists and has filesystem %s on it. User specified filesystem %s will be ignored.", fs, devices.filesystem) + devices.filesystem = fs + } + } + return nil +} + +func (devices *DeviceSet) saveBaseDeviceUUID(baseInfo *devInfo) error { + devices.Lock() + defer devices.Unlock() + + if err := devices.activateDeviceIfNeeded(baseInfo, false); err != nil { + return err + } + + defer devices.deactivateDevice(baseInfo) + + uuid, err := getDeviceUUID(baseInfo.DevName()) + if err != nil { + return err + } + + devices.BaseDeviceUUID = uuid + devices.saveDeviceSetMetaData() + return nil +} + +func (devices *DeviceSet) createBaseImage() error { + logrus.Debugf("Initializing base device-mapper thin volume") + + // Create initial device + info, err := devices.createRegisterDevice("") + if err != nil { + return err + } + + logrus.Debugf("Creating filesystem on base device-mapper thin volume") + + if err := devices.activateDeviceIfNeeded(info, false); err != nil { + return err + } + + if err := devices.createFilesystem(info); err != nil { + return err + } + + info.Initialized = true + if err := devices.saveMetadata(info); err != nil { + info.Initialized = false + return err + } + + if err := devices.saveBaseDeviceUUID(info); err != nil { + return fmt.Errorf("Could not query and save base device UUID:%v", err) + } + + return nil +} + +// Returns if thin pool device exists or not. If device exists, also makes +// sure it is a thin pool device and not some other type of device. +func (devices *DeviceSet) thinPoolExists(thinPoolDevice string) (bool, error) { + logrus.Debugf("devmapper: Checking for existence of the pool %s", thinPoolDevice) + + info, err := devicemapper.GetInfo(thinPoolDevice) + if err != nil { + return false, fmt.Errorf("devmapper: GetInfo() on device %s failed: %v", thinPoolDevice, err) + } + + // Device does not exist. + if info.Exists == 0 { + return false, nil + } + + _, _, deviceType, _, err := devicemapper.GetStatus(thinPoolDevice) + if err != nil { + return false, fmt.Errorf("devmapper: GetStatus() on device %s failed: %v", thinPoolDevice, err) + } + + if deviceType != "thin-pool" { + return false, fmt.Errorf("devmapper: Device %s is not a thin pool", thinPoolDevice) + } + + return true, nil +} + +func (devices *DeviceSet) checkThinPool() error { + _, transactionID, dataUsed, _, _, _, err := devices.poolStatus() + if err != nil { + return err + } + if dataUsed != 0 { + return fmt.Errorf("Unable to take ownership of thin-pool (%s) that already has used data blocks", + devices.thinPoolDevice) + } + if transactionID != 0 { + return fmt.Errorf("Unable to take ownership of thin-pool (%s) with non-zero transaction ID", + devices.thinPoolDevice) + } + return nil +} + +// Base image is initialized properly. Either save UUID for first time (for +// upgrade case or verify UUID. +func (devices *DeviceSet) setupVerifyBaseImageUUIDFS(baseInfo *devInfo) error { + // If BaseDeviceUUID is nil (upgrade case), save it and return success. + if devices.BaseDeviceUUID == "" { + if err := devices.saveBaseDeviceUUID(baseInfo); err != nil { + return fmt.Errorf("Could not query and save base device UUID:%v", err) + } + return nil + } + + if err := devices.verifyBaseDeviceUUIDFS(baseInfo); err != nil { + return fmt.Errorf("Base Device UUID and Filesystem verification failed.%v", err) + } + + return nil +} + +func (devices *DeviceSet) setupBaseImage() error { + oldInfo, _ := devices.lookupDeviceWithLock("") + + // base image already exists. If it is initialized properly, do UUID + // verification and return. Otherwise remove image and set it up + // fresh. + + if oldInfo != nil { + if oldInfo.Initialized && !oldInfo.Deleted { + if err := devices.setupVerifyBaseImageUUIDFS(oldInfo); err != nil { + return err + } + + return nil + } + + logrus.Debugf("Removing uninitialized base image") + // If previous base device is in deferred delete state, + // that needs to be cleaned up first. So don't try + // deferred deletion. + if err := devices.DeleteDevice("", true); err != nil { + return err + } + } + + // If we are setting up base image for the first time, make sure + // thin pool is empty. + if devices.thinPoolDevice != "" && oldInfo == nil { + if err := devices.checkThinPool(); err != nil { + return err + } + } + + // Create new base image device + if err := devices.createBaseImage(); err != nil { + return err + } + + return nil +} + +func setCloseOnExec(name string) { + if fileInfos, _ := ioutil.ReadDir("/proc/self/fd"); fileInfos != nil { + for _, i := range fileInfos { + link, _ := os.Readlink(filepath.Join("/proc/self/fd", i.Name())) + if link == name { + fd, err := strconv.Atoi(i.Name()) + if err == nil { + syscall.CloseOnExec(fd) + } + } + } + } +} + +// DMLog implements logging using DevMapperLogger interface. +func (devices *DeviceSet) DMLog(level int, file string, line int, dmError int, message string) { + // By default libdm sends us all the messages including debug ones. + // We need to filter out messages here and figure out which one + // should be printed. + if level > logLevel { + return + } + + // FIXME(vbatts) push this back into ./pkg/devicemapper/ + if level <= devicemapper.LogLevelErr { + logrus.Errorf("libdevmapper(%d): %s:%d (%d) %s", level, file, line, dmError, message) + } else if level <= devicemapper.LogLevelInfo { + logrus.Infof("libdevmapper(%d): %s:%d (%d) %s", level, file, line, dmError, message) + } else { + // FIXME(vbatts) push this back into ./pkg/devicemapper/ + logrus.Debugf("libdevmapper(%d): %s:%d (%d) %s", level, file, line, dmError, message) + } +} + +func major(device uint64) uint64 { + return (device >> 8) & 0xfff +} + +func minor(device uint64) uint64 { + return (device & 0xff) | ((device >> 12) & 0xfff00) +} + +// ResizePool increases the size of the pool. +func (devices *DeviceSet) ResizePool(size int64) error { + dirname := devices.loopbackDir() + datafilename := path.Join(dirname, "data") + if len(devices.dataDevice) > 0 { + datafilename = devices.dataDevice + } + metadatafilename := path.Join(dirname, "metadata") + if len(devices.metadataDevice) > 0 { + metadatafilename = devices.metadataDevice + } + + datafile, err := os.OpenFile(datafilename, os.O_RDWR, 0) + if datafile == nil { + return err + } + defer datafile.Close() + + fi, err := datafile.Stat() + if fi == nil { + return err + } + + if fi.Size() > size { + return fmt.Errorf("Can't shrink file") + } + + dataloopback := devicemapper.FindLoopDeviceFor(datafile) + if dataloopback == nil { + return fmt.Errorf("Unable to find loopback mount for: %s", datafilename) + } + defer dataloopback.Close() + + metadatafile, err := os.OpenFile(metadatafilename, os.O_RDWR, 0) + if metadatafile == nil { + return err + } + defer metadatafile.Close() + + metadataloopback := devicemapper.FindLoopDeviceFor(metadatafile) + if metadataloopback == nil { + return fmt.Errorf("Unable to find loopback mount for: %s", metadatafilename) + } + defer metadataloopback.Close() + + // Grow loopback file + if err := datafile.Truncate(size); err != nil { + return fmt.Errorf("Unable to grow loopback file: %s", err) + } + + // Reload size for loopback device + if err := devicemapper.LoopbackSetCapacity(dataloopback); err != nil { + return fmt.Errorf("Unable to update loopback capacity: %s", err) + } + + // Suspend the pool + if err := devicemapper.SuspendDevice(devices.getPoolName()); err != nil { + return fmt.Errorf("Unable to suspend pool: %s", err) + } + + // Reload with the new block sizes + if err := devicemapper.ReloadPool(devices.getPoolName(), dataloopback, metadataloopback, devices.thinpBlockSize); err != nil { + return fmt.Errorf("Unable to reload pool: %s", err) + } + + // Resume the pool + if err := devicemapper.ResumeDevice(devices.getPoolName()); err != nil { + return fmt.Errorf("Unable to resume pool: %s", err) + } + + return nil +} + +func (devices *DeviceSet) loadTransactionMetaData() error { + jsonData, err := ioutil.ReadFile(devices.transactionMetaFile()) + if err != nil { + // There is no active transaction. This will be the case + // during upgrade. + if os.IsNotExist(err) { + devices.OpenTransactionID = devices.TransactionID + return nil + } + return err + } + + json.Unmarshal(jsonData, &devices.transaction) + return nil +} + +func (devices *DeviceSet) saveTransactionMetaData() error { + jsonData, err := json.Marshal(&devices.transaction) + if err != nil { + return fmt.Errorf("Error encoding metadata to json: %s", err) + } + + return devices.writeMetaFile(jsonData, devices.transactionMetaFile()) +} + +func (devices *DeviceSet) removeTransactionMetaData() error { + if err := os.RemoveAll(devices.transactionMetaFile()); err != nil { + return err + } + return nil +} + +func (devices *DeviceSet) rollbackTransaction() error { + logrus.Debugf("Rolling back open transaction: TransactionID=%d hash=%s device_id=%d", devices.OpenTransactionID, devices.DeviceIDHash, devices.DeviceID) + + // A device id might have already been deleted before transaction + // closed. In that case this call will fail. Just leave a message + // in case of failure. + if err := devicemapper.DeleteDevice(devices.getPoolDevName(), devices.DeviceID); err != nil { + logrus.Errorf("Unable to delete device: %s", err) + } + + dinfo := &devInfo{Hash: devices.DeviceIDHash} + if err := devices.removeMetadata(dinfo); err != nil { + logrus.Errorf("Unable to remove metadata: %s", err) + } else { + devices.markDeviceIDFree(devices.DeviceID) + } + + if err := devices.removeTransactionMetaData(); err != nil { + logrus.Errorf("Unable to remove transaction meta file %s: %s", devices.transactionMetaFile(), err) + } + + return nil +} + +func (devices *DeviceSet) processPendingTransaction() error { + if err := devices.loadTransactionMetaData(); err != nil { + return err + } + + // If there was open transaction but pool transaction ID is same + // as open transaction ID, nothing to roll back. + if devices.TransactionID == devices.OpenTransactionID { + return nil + } + + // If open transaction ID is less than pool transaction ID, something + // is wrong. Bail out. + if devices.OpenTransactionID < devices.TransactionID { + logrus.Errorf("Open Transaction id %d is less than pool transaction id %d", devices.OpenTransactionID, devices.TransactionID) + return nil + } + + // Pool transaction ID is not same as open transaction. There is + // a transaction which was not completed. + if err := devices.rollbackTransaction(); err != nil { + return fmt.Errorf("Rolling back open transaction failed: %s", err) + } + + devices.OpenTransactionID = devices.TransactionID + return nil +} + +func (devices *DeviceSet) loadDeviceSetMetaData() error { + jsonData, err := ioutil.ReadFile(devices.deviceSetMetaFile()) + if err != nil { + // For backward compatibility return success if file does + // not exist. + if os.IsNotExist(err) { + return nil + } + return err + } + + return json.Unmarshal(jsonData, devices) +} + +func (devices *DeviceSet) saveDeviceSetMetaData() error { + jsonData, err := json.Marshal(devices) + if err != nil { + return fmt.Errorf("Error encoding metadata to json: %s", err) + } + + return devices.writeMetaFile(jsonData, devices.deviceSetMetaFile()) +} + +func (devices *DeviceSet) openTransaction(hash string, DeviceID int) error { + devices.allocateTransactionID() + devices.DeviceIDHash = hash + devices.DeviceID = DeviceID + if err := devices.saveTransactionMetaData(); err != nil { + return fmt.Errorf("Error saving transaction metadata: %s", err) + } + return nil +} + +func (devices *DeviceSet) refreshTransaction(DeviceID int) error { + devices.DeviceID = DeviceID + if err := devices.saveTransactionMetaData(); err != nil { + return fmt.Errorf("Error saving transaction metadata: %s", err) + } + return nil +} + +func (devices *DeviceSet) closeTransaction() error { + if err := devices.updatePoolTransactionID(); err != nil { + logrus.Debugf("Failed to close Transaction") + return err + } + return nil +} + +func determineDriverCapabilities(version string) error { + /* + * Driver version 4.27.0 and greater support deferred activation + * feature. + */ + + logrus.Debugf("devicemapper: driver version is %s", version) + + versionSplit := strings.Split(version, ".") + major, err := strconv.Atoi(versionSplit[0]) + if err != nil { + return graphdriver.ErrNotSupported + } + + if major > 4 { + driverDeferredRemovalSupport = true + return nil + } + + if major < 4 { + return nil + } + + minor, err := strconv.Atoi(versionSplit[1]) + if err != nil { + return graphdriver.ErrNotSupported + } + + /* + * If major is 4 and minor is 27, then there is no need to + * check for patch level as it can not be less than 0. + */ + if minor >= 27 { + driverDeferredRemovalSupport = true + return nil + } + + return nil +} + +// Determine the major and minor number of loopback device +func getDeviceMajorMinor(file *os.File) (uint64, uint64, error) { + stat, err := file.Stat() + if err != nil { + return 0, 0, err + } + + dev := stat.Sys().(*syscall.Stat_t).Rdev + majorNum := major(dev) + minorNum := minor(dev) + + logrus.Debugf("[devmapper]: Major:Minor for device: %s is:%v:%v", file.Name(), majorNum, minorNum) + return majorNum, minorNum, nil +} + +// Given a file which is backing file of a loop back device, find the +// loopback device name and its major/minor number. +func getLoopFileDeviceMajMin(filename string) (string, uint64, uint64, error) { + file, err := os.Open(filename) + if err != nil { + logrus.Debugf("[devmapper]: Failed to open file %s", filename) + return "", 0, 0, err + } + + defer file.Close() + loopbackDevice := devicemapper.FindLoopDeviceFor(file) + if loopbackDevice == nil { + return "", 0, 0, fmt.Errorf("[devmapper]: Unable to find loopback mount for: %s", filename) + } + defer loopbackDevice.Close() + + Major, Minor, err := getDeviceMajorMinor(loopbackDevice) + if err != nil { + return "", 0, 0, err + } + return loopbackDevice.Name(), Major, Minor, nil +} + +// Get the major/minor numbers of thin pool data and metadata devices +func (devices *DeviceSet) getThinPoolDataMetaMajMin() (uint64, uint64, uint64, uint64, error) { + var params, poolDataMajMin, poolMetadataMajMin string + + _, _, _, params, err := devicemapper.GetTable(devices.getPoolName()) + if err != nil { + return 0, 0, 0, 0, err + } + + if _, err = fmt.Sscanf(params, "%s %s", &poolMetadataMajMin, &poolDataMajMin); err != nil { + return 0, 0, 0, 0, err + } + + logrus.Debugf("[devmapper]: poolDataMajMin=%s poolMetaMajMin=%s\n", poolDataMajMin, poolMetadataMajMin) + + poolDataMajMinorSplit := strings.Split(poolDataMajMin, ":") + poolDataMajor, err := strconv.ParseUint(poolDataMajMinorSplit[0], 10, 32) + if err != nil { + return 0, 0, 0, 0, err + } + + poolDataMinor, err := strconv.ParseUint(poolDataMajMinorSplit[1], 10, 32) + if err != nil { + return 0, 0, 0, 0, err + } + + poolMetadataMajMinorSplit := strings.Split(poolMetadataMajMin, ":") + poolMetadataMajor, err := strconv.ParseUint(poolMetadataMajMinorSplit[0], 10, 32) + if err != nil { + return 0, 0, 0, 0, err + } + + poolMetadataMinor, err := strconv.ParseUint(poolMetadataMajMinorSplit[1], 10, 32) + if err != nil { + return 0, 0, 0, 0, err + } + + return poolDataMajor, poolDataMinor, poolMetadataMajor, poolMetadataMinor, nil +} + +func (devices *DeviceSet) loadThinPoolLoopBackInfo() error { + poolDataMajor, poolDataMinor, poolMetadataMajor, poolMetadataMinor, err := devices.getThinPoolDataMetaMajMin() + if err != nil { + return err + } + + dirname := devices.loopbackDir() + + // data device has not been passed in. So there should be a data file + // which is being mounted as loop device. + if devices.dataDevice == "" { + datafilename := path.Join(dirname, "data") + dataLoopDevice, dataMajor, dataMinor, err := getLoopFileDeviceMajMin(datafilename) + if err != nil { + return err + } + + // Compare the two + if poolDataMajor == dataMajor && poolDataMinor == dataMinor { + devices.dataDevice = dataLoopDevice + devices.dataLoopFile = datafilename + } + + } + + // metadata device has not been passed in. So there should be a + // metadata file which is being mounted as loop device. + if devices.metadataDevice == "" { + metadatafilename := path.Join(dirname, "metadata") + metadataLoopDevice, metadataMajor, metadataMinor, err := getLoopFileDeviceMajMin(metadatafilename) + if err != nil { + return err + } + if poolMetadataMajor == metadataMajor && poolMetadataMinor == metadataMinor { + devices.metadataDevice = metadataLoopDevice + devices.metadataLoopFile = metadatafilename + } + } + + return nil +} + +func (devices *DeviceSet) initDevmapper(doInit bool) error { + // give ourselves to libdm as a log handler + devicemapper.LogInit(devices) + + version, err := devicemapper.GetDriverVersion() + if err != nil { + // Can't even get driver version, assume not supported + return graphdriver.ErrNotSupported + } + + if err := determineDriverCapabilities(version); err != nil { + return graphdriver.ErrNotSupported + } + + // If user asked for deferred removal then check both libdm library + // and kernel driver support deferred removal otherwise error out. + if enableDeferredRemoval { + if !driverDeferredRemovalSupport { + return fmt.Errorf("devmapper: Deferred removal can not be enabled as kernel does not support it") + } + if !devicemapper.LibraryDeferredRemovalSupport { + return fmt.Errorf("devmapper: Deferred removal can not be enabled as libdm does not support it") + } + logrus.Debugf("devmapper: Deferred removal support enabled.") + devices.deferredRemove = true + } + + if enableDeferredDeletion { + if !devices.deferredRemove { + return fmt.Errorf("devmapper: Deferred deletion can not be enabled as deferred removal is not enabled. Enable deferred removal using --storage-opt dm.use_deferred_removal=true parameter") + } + logrus.Debugf("devmapper: Deferred deletion support enabled.") + devices.deferredDelete = true + } + + // https://github.com/docker/docker/issues/4036 + if supported := devicemapper.UdevSetSyncSupport(true); !supported { + logrus.Warn("Udev sync is not supported. This will lead to unexpected behavior, data loss and errors. For more information, see https://docs.docker.com/reference/commandline/daemon/#daemon-storage-driver-option") + } + + //create the root dir of the devmapper driver ownership to match this + //daemon's remapped root uid/gid so containers can start properly + uid, gid, err := idtools.GetRootUIDGID(devices.uidMaps, devices.gidMaps) + if err != nil { + return err + } + if err := idtools.MkdirAs(devices.root, 0700, uid, gid); err != nil && !os.IsExist(err) { + return err + } + if err := os.MkdirAll(devices.metadataDir(), 0700); err != nil && !os.IsExist(err) { + return err + } + + // Set the device prefix from the device id and inode of the docker root dir + + st, err := os.Stat(devices.root) + if err != nil { + return fmt.Errorf("Error looking up dir %s: %s", devices.root, err) + } + sysSt := st.Sys().(*syscall.Stat_t) + // "reg-" stands for "regular file". + // In the future we might use "dev-" for "device file", etc. + // docker-maj,min[-inode] stands for: + // - Managed by docker + // - The target of this device is at major and minor + // - If is defined, use that file inside the device as a loopback image. Otherwise use the device itself. + devices.devicePrefix = fmt.Sprintf("docker-%d:%d-%d", major(sysSt.Dev), minor(sysSt.Dev), sysSt.Ino) + logrus.Debugf("Generated prefix: %s", devices.devicePrefix) + + // Check for the existence of the thin-pool device + poolExists, err := devices.thinPoolExists(devices.getPoolName()) + if err != nil { + return err + } + + // It seems libdevmapper opens this without O_CLOEXEC, and go exec will not close files + // that are not Close-on-exec, and lxc-start will die if it inherits any unexpected files, + // so we add this badhack to make sure it closes itself + setCloseOnExec("/dev/mapper/control") + + // Make sure the sparse images exist in /devicemapper/data and + // /devicemapper/metadata + + createdLoopback := false + + // If the pool doesn't exist, create it + if !poolExists && devices.thinPoolDevice == "" { + logrus.Debugf("Pool doesn't exist. Creating it.") + + var ( + dataFile *os.File + metadataFile *os.File + ) + + if devices.dataDevice == "" { + // Make sure the sparse images exist in /devicemapper/data + + hasData := devices.hasImage("data") + + if !doInit && !hasData { + return errors.New("Loopback data file not found") + } + + if !hasData { + createdLoopback = true + } + + data, err := devices.ensureImage("data", devices.dataLoopbackSize) + if err != nil { + logrus.Debugf("Error device ensureImage (data): %s", err) + return err + } + + dataFile, err = devicemapper.AttachLoopDevice(data) + if err != nil { + return err + } + devices.dataLoopFile = data + devices.dataDevice = dataFile.Name() + } else { + dataFile, err = os.OpenFile(devices.dataDevice, os.O_RDWR, 0600) + if err != nil { + return err + } + } + defer dataFile.Close() + + if devices.metadataDevice == "" { + // Make sure the sparse images exist in /devicemapper/metadata + + hasMetadata := devices.hasImage("metadata") + + if !doInit && !hasMetadata { + return errors.New("Loopback metadata file not found") + } + + if !hasMetadata { + createdLoopback = true + } + + metadata, err := devices.ensureImage("metadata", devices.metaDataLoopbackSize) + if err != nil { + logrus.Debugf("Error device ensureImage (metadata): %s", err) + return err + } + + metadataFile, err = devicemapper.AttachLoopDevice(metadata) + if err != nil { + return err + } + devices.metadataLoopFile = metadata + devices.metadataDevice = metadataFile.Name() + } else { + metadataFile, err = os.OpenFile(devices.metadataDevice, os.O_RDWR, 0600) + if err != nil { + return err + } + } + defer metadataFile.Close() + + if err := devicemapper.CreatePool(devices.getPoolName(), dataFile, metadataFile, devices.thinpBlockSize); err != nil { + return err + } + } + + // Pool already exists and caller did not pass us a pool. That means + // we probably created pool earlier and could not remove it as some + // containers were still using it. Detect some of the properties of + // pool, like is it using loop devices. + if poolExists && devices.thinPoolDevice == "" { + if err := devices.loadThinPoolLoopBackInfo(); err != nil { + logrus.Debugf("Failed to load thin pool loopback device information:%v", err) + return err + } + } + + // If we didn't just create the data or metadata image, we need to + // load the transaction id and migrate old metadata + if !createdLoopback { + if err := devices.initMetaData(); err != nil { + return err + } + } + + if devices.thinPoolDevice == "" { + if devices.metadataLoopFile != "" || devices.dataLoopFile != "" { + logrus.Warnf("Usage of loopback devices is strongly discouraged for production use. Please use `--storage-opt dm.thinpooldev` or use `man docker` to refer to dm.thinpooldev section.") + } + } + + // Right now this loads only NextDeviceID. If there is more metadata + // down the line, we might have to move it earlier. + if err := devices.loadDeviceSetMetaData(); err != nil { + return err + } + + // Setup the base image + if doInit { + if err := devices.setupBaseImage(); err != nil { + logrus.Debugf("Error device setupBaseImage: %s", err) + return err + } + } + + return nil +} + +// AddDevice adds a device and registers in the hash. +func (devices *DeviceSet) AddDevice(hash, baseHash string) error { + logrus.Debugf("[deviceset] AddDevice(hash=%s basehash=%s)", hash, baseHash) + defer logrus.Debugf("[deviceset] AddDevice(hash=%s basehash=%s) END", hash, baseHash) + + // If a deleted device exists, return error. + baseInfo, err := devices.lookupDeviceWithLock(baseHash) + if err != nil { + return err + } + + if baseInfo.Deleted { + return fmt.Errorf("devmapper: Base device %v has been marked for deferred deletion", baseInfo.Hash) + } + + baseInfo.lock.Lock() + defer baseInfo.lock.Unlock() + + devices.Lock() + defer devices.Unlock() + + // Also include deleted devices in case hash of new device is + // same as one of the deleted devices. + if info, _ := devices.lookupDevice(hash); info != nil { + return fmt.Errorf("device %s already exists. Deleted=%v", hash, info.Deleted) + } + + if err := devices.createRegisterSnapDevice(hash, baseInfo); err != nil { + return err + } + + return nil +} + +func (devices *DeviceSet) markForDeferredDeletion(info *devInfo) error { + // If device is already in deleted state, there is nothing to be done. + if info.Deleted { + return nil + } + + logrus.Debugf("devmapper: Marking device %s for deferred deletion.", info.Hash) + + info.Deleted = true + + // save device metadata to refelect deleted state. + if err := devices.saveMetadata(info); err != nil { + info.Deleted = false + return err + } + + devices.nrDeletedDevices++ + return nil +} + +// Should be caled with devices.Lock() held. +func (devices *DeviceSet) deleteTransaction(info *devInfo, syncDelete bool) error { + if err := devices.openTransaction(info.Hash, info.DeviceID); err != nil { + logrus.Debugf("Error opening transaction hash = %s deviceId = %d", "", info.DeviceID) + return err + } + + defer devices.closeTransaction() + + err := devicemapper.DeleteDevice(devices.getPoolDevName(), info.DeviceID) + if err != nil { + // If syncDelete is true, we want to return error. If deferred + // deletion is not enabled, we return an error. If error is + // something other then EBUSY, return an error. + if syncDelete || !devices.deferredDelete || err != devicemapper.ErrBusy { + logrus.Debugf("Error deleting device: %s", err) + return err + } + } + + if err == nil { + if err := devices.unregisterDevice(info.DeviceID, info.Hash); err != nil { + return err + } + // If device was already in deferred delete state that means + // deletion was being tried again later. Reduce the deleted + // device count. + if info.Deleted { + devices.nrDeletedDevices-- + } + } else { + if err := devices.markForDeferredDeletion(info); err != nil { + return err + } + } + + return nil +} + +// Issue discard only if device open count is zero. +func (devices *DeviceSet) issueDiscard(info *devInfo) error { + logrus.Debugf("devmapper: issueDiscard(device: %s). START", info.Hash) + defer logrus.Debugf("devmapper: issueDiscard(device: %s). END", info.Hash) + // This is a workaround for the kernel not discarding block so + // on the thin pool when we remove a thinp device, so we do it + // manually. + // Even if device is deferred deleted, activate it and isue + // discards. + if err := devices.activateDeviceIfNeeded(info, true); err != nil { + return err + } + + devinfo, err := devicemapper.GetInfo(info.Name()) + if err != nil { + return err + } + + if devinfo.OpenCount != 0 { + logrus.Debugf("devmapper: Device: %s is in use. OpenCount=%d. Not issuing discards.", info.Hash, devinfo.OpenCount) + return nil + } + + if err := devicemapper.BlockDeviceDiscard(info.DevName()); err != nil { + logrus.Debugf("Error discarding block on device: %s (ignoring)", err) + } + return nil +} + +// Should be called with devices.Lock() held. +func (devices *DeviceSet) deleteDevice(info *devInfo, syncDelete bool) error { + if devices.doBlkDiscard { + devices.issueDiscard(info) + } + + // Try to deactivate device in case it is active. + if err := devices.deactivateDevice(info); err != nil { + logrus.Debugf("Error deactivating device: %s", err) + return err + } + + if err := devices.deleteTransaction(info, syncDelete); err != nil { + return err + } + + devices.markDeviceIDFree(info.DeviceID) + + return nil +} + +// DeleteDevice will return success if device has been marked for deferred +// removal. If one wants to override that and want DeleteDevice() to fail if +// device was busy and could not be deleted, set syncDelete=true. +func (devices *DeviceSet) DeleteDevice(hash string, syncDelete bool) error { + logrus.Debugf("devmapper: DeleteDevice(hash=%v syncDelete=%v) START", hash, syncDelete) + defer logrus.Debugf("devmapper: DeleteDevice(hash=%v syncDelete=%v) END", hash, syncDelete) + info, err := devices.lookupDeviceWithLock(hash) + if err != nil { + return err + } + + info.lock.Lock() + defer info.lock.Unlock() + + devices.Lock() + defer devices.Unlock() + + // If mountcount is not zero, that means devices is still in use + // or has not been Put() properly. Fail device deletion. + + if info.mountCount != 0 { + return fmt.Errorf("devmapper: Can't delete device %v as it is still mounted. mntCount=%v", info.Hash, info.mountCount) + } + + return devices.deleteDevice(info, syncDelete) +} + +func (devices *DeviceSet) deactivatePool() error { + logrus.Debugf("[devmapper] deactivatePool()") + defer logrus.Debugf("[devmapper] deactivatePool END") + devname := devices.getPoolDevName() + + devinfo, err := devicemapper.GetInfo(devname) + if err != nil { + return err + } + + if devinfo.Exists == 0 { + return nil + } + if err := devicemapper.RemoveDevice(devname); err != nil { + return err + } + + if d, err := devicemapper.GetDeps(devname); err == nil { + logrus.Warnf("[devmapper] device %s still has %d active dependents", devname, d.Count) + } + + return nil +} + +func (devices *DeviceSet) deactivateDevice(info *devInfo) error { + logrus.Debugf("[devmapper] deactivateDevice(%s)", info.Hash) + defer logrus.Debugf("[devmapper] deactivateDevice END(%s)", info.Hash) + + devinfo, err := devicemapper.GetInfo(info.Name()) + if err != nil { + return err + } + + if devinfo.Exists == 0 { + return nil + } + + if devices.deferredRemove { + if err := devicemapper.RemoveDeviceDeferred(info.Name()); err != nil { + return err + } + } else { + if err := devices.removeDevice(info.Name()); err != nil { + return err + } + } + return nil +} + +// Issues the underlying dm remove operation. +func (devices *DeviceSet) removeDevice(devname string) error { + var err error + + logrus.Debugf("[devmapper] removeDevice START(%s)", devname) + defer logrus.Debugf("[devmapper] removeDevice END(%s)", devname) + + for i := 0; i < 200; i++ { + err = devicemapper.RemoveDevice(devname) + if err == nil { + break + } + if err != devicemapper.ErrBusy { + return err + } + + // If we see EBUSY it may be a transient error, + // sleep a bit a retry a few times. + devices.Unlock() + time.Sleep(100 * time.Millisecond) + devices.Lock() + } + + return err +} + +func (devices *DeviceSet) cancelDeferredRemoval(info *devInfo) error { + if !devices.deferredRemove { + return nil + } + + logrus.Debugf("[devmapper] cancelDeferredRemoval START(%s)", info.Name()) + defer logrus.Debugf("[devmapper] cancelDeferredRemoval END(%s)", info.Name()) + + devinfo, err := devicemapper.GetInfoWithDeferred(info.Name()) + + if devinfo != nil && devinfo.DeferredRemove == 0 { + return nil + } + + // Cancel deferred remove + for i := 0; i < 100; i++ { + err = devicemapper.CancelDeferredRemove(info.Name()) + if err == nil { + break + } + + if err == devicemapper.ErrEnxio { + // Device is probably already gone. Return success. + return nil + } + + if err != devicemapper.ErrBusy { + return err + } + + // If we see EBUSY it may be a transient error, + // sleep a bit a retry a few times. + devices.Unlock() + time.Sleep(100 * time.Millisecond) + devices.Lock() + } + return err +} + +// Shutdown shuts down the device by unmounting the root. +func (devices *DeviceSet) Shutdown() error { + logrus.Debugf("[deviceset %s] Shutdown()", devices.devicePrefix) + logrus.Debugf("[devmapper] Shutting down DeviceSet: %s", devices.root) + defer logrus.Debugf("[deviceset %s] Shutdown() END", devices.devicePrefix) + + var devs []*devInfo + + // Stop deletion worker. This should start delivering new events to + // ticker channel. That means no new instance of cleanupDeletedDevice() + // will run after this call. If one instance is already running at + // the time of the call, it must be holding devices.Lock() and + // we will block on this lock till cleanup function exits. + devices.deletionWorkerTicker.Stop() + + devices.Lock() + // Save DeviceSet Metadata first. Docker kills all threads if they + // don't finish in certain time. It is possible that Shutdown() + // routine does not finish in time as we loop trying to deactivate + // some devices while these are busy. In that case shutdown() routine + // will be killed and we will not get a chance to save deviceset + // metadata. Hence save this early before trying to deactivate devices. + devices.saveDeviceSetMetaData() + + for _, info := range devices.Devices { + devs = append(devs, info) + } + devices.Unlock() + + for _, info := range devs { + info.lock.Lock() + if info.mountCount > 0 { + // We use MNT_DETACH here in case it is still busy in some running + // container. This means it'll go away from the global scope directly, + // and the device will be released when that container dies. + if err := syscall.Unmount(info.mountPath, syscall.MNT_DETACH); err != nil { + logrus.Debugf("Shutdown unmounting %s, error: %s", info.mountPath, err) + } + + devices.Lock() + if err := devices.deactivateDevice(info); err != nil { + logrus.Debugf("Shutdown deactivate %s , error: %s", info.Hash, err) + } + devices.Unlock() + } + info.lock.Unlock() + } + + info, _ := devices.lookupDeviceWithLock("") + if info != nil { + info.lock.Lock() + devices.Lock() + if err := devices.deactivateDevice(info); err != nil { + logrus.Debugf("Shutdown deactivate base , error: %s", err) + } + devices.Unlock() + info.lock.Unlock() + } + + devices.Lock() + if devices.thinPoolDevice == "" { + if err := devices.deactivatePool(); err != nil { + logrus.Debugf("Shutdown deactivate pool , error: %s", err) + } + } + devices.Unlock() + + return nil +} + +// MountDevice mounts the device if not already mounted. +func (devices *DeviceSet) MountDevice(hash, path, mountLabel string) error { + info, err := devices.lookupDeviceWithLock(hash) + if err != nil { + return err + } + + if info.Deleted { + return fmt.Errorf("devmapper: Can't mount device %v as it has been marked for deferred deletion", info.Hash) + } + + info.lock.Lock() + defer info.lock.Unlock() + + devices.Lock() + defer devices.Unlock() + + if info.mountCount > 0 { + if path != info.mountPath { + return fmt.Errorf("Trying to mount devmapper device in multiple places (%s, %s)", info.mountPath, path) + } + + info.mountCount++ + return nil + } + + if err := devices.activateDeviceIfNeeded(info, false); err != nil { + return fmt.Errorf("Error activating devmapper device for '%s': %s", hash, err) + } + + fstype, err := ProbeFsType(info.DevName()) + if err != nil { + return err + } + + options := "" + + if fstype == "xfs" { + // XFS needs nouuid or it can't mount filesystems with the same fs + options = joinMountOptions(options, "nouuid") + } + + options = joinMountOptions(options, devices.mountOptions) + options = joinMountOptions(options, label.FormatMountLabel("", mountLabel)) + + if err := mount.Mount(info.DevName(), path, fstype, options); err != nil { + return fmt.Errorf("Error mounting '%s' on '%s': %s", info.DevName(), path, err) + } + + info.mountCount = 1 + info.mountPath = path + + return nil +} + +// UnmountDevice unmounts the device and removes it from hash. +func (devices *DeviceSet) UnmountDevice(hash string) error { + logrus.Debugf("[devmapper] UnmountDevice(hash=%s)", hash) + defer logrus.Debugf("[devmapper] UnmountDevice(hash=%s) END", hash) + + info, err := devices.lookupDeviceWithLock(hash) + if err != nil { + return err + } + + info.lock.Lock() + defer info.lock.Unlock() + + devices.Lock() + defer devices.Unlock() + + if info.mountCount == 0 { + return fmt.Errorf("UnmountDevice: device not-mounted id %s", hash) + } + + info.mountCount-- + if info.mountCount > 0 { + return nil + } + + logrus.Debugf("[devmapper] Unmount(%s)", info.mountPath) + if err := syscall.Unmount(info.mountPath, syscall.MNT_DETACH); err != nil { + return err + } + logrus.Debugf("[devmapper] Unmount done") + + if err := devices.deactivateDevice(info); err != nil { + return err + } + + info.mountPath = "" + + return nil +} + +// HasDevice returns true if the device metadata exists. +func (devices *DeviceSet) HasDevice(hash string) bool { + info, _ := devices.lookupDeviceWithLock(hash) + return info != nil +} + +// List returns a list of device ids. +func (devices *DeviceSet) List() []string { + devices.Lock() + defer devices.Unlock() + + ids := make([]string, len(devices.Devices)) + i := 0 + for k := range devices.Devices { + ids[i] = k + i++ + } + return ids +} + +func (devices *DeviceSet) deviceStatus(devName string) (sizeInSectors, mappedSectors, highestMappedSector uint64, err error) { + var params string + _, sizeInSectors, _, params, err = devicemapper.GetStatus(devName) + if err != nil { + return + } + if _, err = fmt.Sscanf(params, "%d %d", &mappedSectors, &highestMappedSector); err == nil { + return + } + return +} + +// GetDeviceStatus provides size, mapped sectors +func (devices *DeviceSet) GetDeviceStatus(hash string) (*DevStatus, error) { + info, err := devices.lookupDeviceWithLock(hash) + if err != nil { + return nil, err + } + + info.lock.Lock() + defer info.lock.Unlock() + + devices.Lock() + defer devices.Unlock() + + status := &DevStatus{ + DeviceID: info.DeviceID, + Size: info.Size, + TransactionID: info.TransactionID, + } + + if err := devices.activateDeviceIfNeeded(info, false); err != nil { + return nil, fmt.Errorf("Error activating devmapper device for '%s': %s", hash, err) + } + + sizeInSectors, mappedSectors, highestMappedSector, err := devices.deviceStatus(info.DevName()) + + if err != nil { + return nil, err + } + + status.SizeInSectors = sizeInSectors + status.MappedSectors = mappedSectors + status.HighestMappedSector = highestMappedSector + + return status, nil +} + +func (devices *DeviceSet) poolStatus() (totalSizeInSectors, transactionID, dataUsed, dataTotal, metadataUsed, metadataTotal uint64, err error) { + var params string + if _, totalSizeInSectors, _, params, err = devicemapper.GetStatus(devices.getPoolName()); err == nil { + _, err = fmt.Sscanf(params, "%d %d/%d %d/%d", &transactionID, &metadataUsed, &metadataTotal, &dataUsed, &dataTotal) + } + return +} + +// DataDevicePath returns the path to the data storage for this deviceset, +// regardless of loopback or block device +func (devices *DeviceSet) DataDevicePath() string { + return devices.dataDevice +} + +// MetadataDevicePath returns the path to the metadata storage for this deviceset, +// regardless of loopback or block device +func (devices *DeviceSet) MetadataDevicePath() string { + return devices.metadataDevice +} + +func (devices *DeviceSet) getUnderlyingAvailableSpace(loopFile string) (uint64, error) { + buf := new(syscall.Statfs_t) + if err := syscall.Statfs(loopFile, buf); err != nil { + logrus.Warnf("Couldn't stat loopfile filesystem %v: %v", loopFile, err) + return 0, err + } + return buf.Bfree * uint64(buf.Bsize), nil +} + +func (devices *DeviceSet) isRealFile(loopFile string) (bool, error) { + if loopFile != "" { + fi, err := os.Stat(loopFile) + if err != nil { + logrus.Warnf("Couldn't stat loopfile %v: %v", loopFile, err) + return false, err + } + return fi.Mode().IsRegular(), nil + } + return false, nil +} + +// Status returns the current status of this deviceset +func (devices *DeviceSet) Status() *Status { + devices.Lock() + defer devices.Unlock() + + status := &Status{} + + status.PoolName = devices.getPoolName() + status.DataFile = devices.DataDevicePath() + status.DataLoopback = devices.dataLoopFile + status.MetadataFile = devices.MetadataDevicePath() + status.MetadataLoopback = devices.metadataLoopFile + status.UdevSyncSupported = devicemapper.UdevSyncSupported() + status.DeferredRemoveEnabled = devices.deferredRemove + status.DeferredDeleteEnabled = devices.deferredDelete + status.DeferredDeletedDeviceCount = devices.nrDeletedDevices + status.BaseDeviceSize = devices.getBaseDeviceSize() + status.BaseDeviceFS = devices.getBaseDeviceFS() + + totalSizeInSectors, _, dataUsed, dataTotal, metadataUsed, metadataTotal, err := devices.poolStatus() + if err == nil { + // Convert from blocks to bytes + blockSizeInSectors := totalSizeInSectors / dataTotal + + status.Data.Used = dataUsed * blockSizeInSectors * 512 + status.Data.Total = dataTotal * blockSizeInSectors * 512 + status.Data.Available = status.Data.Total - status.Data.Used + + // metadata blocks are always 4k + status.Metadata.Used = metadataUsed * 4096 + status.Metadata.Total = metadataTotal * 4096 + status.Metadata.Available = status.Metadata.Total - status.Metadata.Used + + status.SectorSize = blockSizeInSectors * 512 + + if check, _ := devices.isRealFile(devices.dataLoopFile); check { + actualSpace, err := devices.getUnderlyingAvailableSpace(devices.dataLoopFile) + if err == nil && actualSpace < status.Data.Available { + status.Data.Available = actualSpace + } + } + + if check, _ := devices.isRealFile(devices.metadataLoopFile); check { + actualSpace, err := devices.getUnderlyingAvailableSpace(devices.metadataLoopFile) + if err == nil && actualSpace < status.Metadata.Available { + status.Metadata.Available = actualSpace + } + } + } + + return status +} + +// Status returns the current status of this deviceset +func (devices *DeviceSet) exportDeviceMetadata(hash string) (*deviceMetadata, error) { + info, err := devices.lookupDeviceWithLock(hash) + if err != nil { + return nil, err + } + + info.lock.Lock() + defer info.lock.Unlock() + + metadata := &deviceMetadata{info.DeviceID, info.Size, info.Name()} + return metadata, nil +} + +// NewDeviceSet creates the device set based on the options provided. +func NewDeviceSet(root string, doInit bool, options []string, uidMaps, gidMaps []idtools.IDMap) (*DeviceSet, error) { + devicemapper.SetDevDir("/dev") + + devices := &DeviceSet{ + root: root, + metaData: metaData{Devices: make(map[string]*devInfo)}, + dataLoopbackSize: defaultDataLoopbackSize, + metaDataLoopbackSize: defaultMetaDataLoopbackSize, + baseFsSize: defaultBaseFsSize, + overrideUdevSyncCheck: defaultUdevSyncOverride, + doBlkDiscard: true, + thinpBlockSize: defaultThinpBlockSize, + deviceIDMap: make([]byte, deviceIDMapSz), + deletionWorkerTicker: time.NewTicker(time.Second * 30), + uidMaps: uidMaps, + gidMaps: gidMaps, + } + + foundBlkDiscard := false + for _, option := range options { + key, val, err := parsers.ParseKeyValueOpt(option) + if err != nil { + return nil, err + } + key = strings.ToLower(key) + switch key { + case "dm.basesize": + size, err := units.RAMInBytes(val) + if err != nil { + return nil, err + } + devices.baseFsSize = uint64(size) + case "dm.loopdatasize": + size, err := units.RAMInBytes(val) + if err != nil { + return nil, err + } + devices.dataLoopbackSize = size + case "dm.loopmetadatasize": + size, err := units.RAMInBytes(val) + if err != nil { + return nil, err + } + devices.metaDataLoopbackSize = size + case "dm.fs": + if val != "ext4" && val != "xfs" { + return nil, fmt.Errorf("Unsupported filesystem %s\n", val) + } + devices.filesystem = val + case "dm.mkfsarg": + devices.mkfsArgs = append(devices.mkfsArgs, val) + case "dm.mountopt": + devices.mountOptions = joinMountOptions(devices.mountOptions, val) + case "dm.metadatadev": + devices.metadataDevice = val + case "dm.datadev": + devices.dataDevice = val + case "dm.thinpooldev": + devices.thinPoolDevice = strings.TrimPrefix(val, "/dev/mapper/") + case "dm.blkdiscard": + foundBlkDiscard = true + devices.doBlkDiscard, err = strconv.ParseBool(val) + if err != nil { + return nil, err + } + case "dm.blocksize": + size, err := units.RAMInBytes(val) + if err != nil { + return nil, err + } + // convert to 512b sectors + devices.thinpBlockSize = uint32(size) >> 9 + case "dm.override_udev_sync_check": + devices.overrideUdevSyncCheck, err = strconv.ParseBool(val) + if err != nil { + return nil, err + } + + case "dm.use_deferred_removal": + enableDeferredRemoval, err = strconv.ParseBool(val) + if err != nil { + return nil, err + } + + case "dm.use_deferred_deletion": + enableDeferredDeletion, err = strconv.ParseBool(val) + if err != nil { + return nil, err + } + + default: + return nil, fmt.Errorf("Unknown option %s\n", key) + } + } + + // By default, don't do blk discard hack on raw devices, its rarely useful and is expensive + if !foundBlkDiscard && (devices.dataDevice != "" || devices.thinPoolDevice != "") { + devices.doBlkDiscard = false + } + + if err := devices.initDevmapper(doInit); err != nil { + return nil, err + } + + return devices, nil +} diff --git a/daemon/graphdriver/devmapper/devmapper_doc.go b/daemon/graphdriver/devmapper/devmapper_doc.go new file mode 100644 index 0000000000..c1c3e3891b --- /dev/null +++ b/daemon/graphdriver/devmapper/devmapper_doc.go @@ -0,0 +1,106 @@ +package devmapper + +// Definition of struct dm_task and sub structures (from lvm2) +// +// struct dm_ioctl { +// /* +// * The version number is made up of three parts: +// * major - no backward or forward compatibility, +// * minor - only backwards compatible, +// * patch - both backwards and forwards compatible. +// * +// * All clients of the ioctl interface should fill in the +// * version number of the interface that they were +// * compiled with. +// * +// * All recognised ioctl commands (ie. those that don't +// * return -ENOTTY) fill out this field, even if the +// * command failed. +// */ +// uint32_t version[3]; /* in/out */ +// uint32_t data_size; /* total size of data passed in +// * including this struct */ + +// uint32_t data_start; /* offset to start of data +// * relative to start of this struct */ + +// uint32_t target_count; /* in/out */ +// int32_t open_count; /* out */ +// uint32_t flags; /* in/out */ + +// /* +// * event_nr holds either the event number (input and output) or the +// * udev cookie value (input only). +// * The DM_DEV_WAIT ioctl takes an event number as input. +// * The DM_SUSPEND, DM_DEV_REMOVE and DM_DEV_RENAME ioctls +// * use the field as a cookie to return in the DM_COOKIE +// * variable with the uevents they issue. +// * For output, the ioctls return the event number, not the cookie. +// */ +// uint32_t event_nr; /* in/out */ +// uint32_t padding; + +// uint64_t dev; /* in/out */ + +// char name[DM_NAME_LEN]; /* device name */ +// char uuid[DM_UUID_LEN]; /* unique identifier for +// * the block device */ +// char data[7]; /* padding or data */ +// }; + +// struct target { +// uint64_t start; +// uint64_t length; +// char *type; +// char *params; + +// struct target *next; +// }; + +// typedef enum { +// DM_ADD_NODE_ON_RESUME, /* add /dev/mapper node with dmsetup resume */ +// DM_ADD_NODE_ON_CREATE /* add /dev/mapper node with dmsetup create */ +// } dm_add_node_t; + +// struct dm_task { +// int type; +// char *dev_name; +// char *mangled_dev_name; + +// struct target *head, *tail; + +// int read_only; +// uint32_t event_nr; +// int major; +// int minor; +// int allow_default_major_fallback; +// uid_t uid; +// gid_t gid; +// mode_t mode; +// uint32_t read_ahead; +// uint32_t read_ahead_flags; +// union { +// struct dm_ioctl *v4; +// } dmi; +// char *newname; +// char *message; +// char *geometry; +// uint64_t sector; +// int no_flush; +// int no_open_count; +// int skip_lockfs; +// int query_inactive_table; +// int suppress_identical_reload; +// dm_add_node_t add_node; +// uint64_t existing_table_size; +// int cookie_set; +// int new_uuid; +// int secure_data; +// int retry_remove; +// int enable_checks; +// int expected_errno; + +// char *uuid; +// char *mangled_uuid; +// }; +// diff --git a/daemon/graphdriver/devmapper/devmapper_test.go b/daemon/graphdriver/devmapper/devmapper_test.go new file mode 100644 index 0000000000..5c2abcefcb --- /dev/null +++ b/daemon/graphdriver/devmapper/devmapper_test.go @@ -0,0 +1,110 @@ +// +build linux + +package devmapper + +import ( + "fmt" + "testing" + "time" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/daemon/graphdriver/graphtest" +) + +func init() { + // Reduce the size the the base fs and loopback for the tests + defaultDataLoopbackSize = 300 * 1024 * 1024 + defaultMetaDataLoopbackSize = 200 * 1024 * 1024 + defaultBaseFsSize = 300 * 1024 * 1024 + defaultUdevSyncOverride = true + if err := graphtest.InitLoopbacks(); err != nil { + panic(err) + } +} + +// This avoids creating a new driver for each test if all tests are run +// Make sure to put new tests between TestDevmapperSetup and TestDevmapperTeardown +func TestDevmapperSetup(t *testing.T) { + graphtest.GetDriver(t, "devicemapper") +} + +func TestDevmapperCreateEmpty(t *testing.T) { + graphtest.DriverTestCreateEmpty(t, "devicemapper") +} + +func TestDevmapperCreateBase(t *testing.T) { + graphtest.DriverTestCreateBase(t, "devicemapper") +} + +func TestDevmapperCreateSnap(t *testing.T) { + graphtest.DriverTestCreateSnap(t, "devicemapper") +} + +func TestDevmapperTeardown(t *testing.T) { + graphtest.PutDriver(t) +} + +func TestDevmapperReduceLoopBackSize(t *testing.T) { + tenMB := int64(10 * 1024 * 1024) + testChangeLoopBackSize(t, -tenMB, defaultDataLoopbackSize, defaultMetaDataLoopbackSize) +} + +func TestDevmapperIncreaseLoopBackSize(t *testing.T) { + tenMB := int64(10 * 1024 * 1024) + testChangeLoopBackSize(t, tenMB, defaultDataLoopbackSize+tenMB, defaultMetaDataLoopbackSize+tenMB) +} + +func testChangeLoopBackSize(t *testing.T, delta, expectDataSize, expectMetaDataSize int64) { + driver := graphtest.GetDriver(t, "devicemapper").(*graphtest.Driver).Driver.(*graphdriver.NaiveDiffDriver).ProtoDriver.(*Driver) + defer graphtest.PutDriver(t) + // make sure data or metadata loopback size are the default size + if s := driver.DeviceSet.Status(); s.Data.Total != uint64(defaultDataLoopbackSize) || s.Metadata.Total != uint64(defaultMetaDataLoopbackSize) { + t.Fatalf("data or metadata loop back size is incorrect") + } + if err := driver.Cleanup(); err != nil { + t.Fatal(err) + } + //Reload + d, err := Init(driver.home, []string{ + fmt.Sprintf("dm.loopdatasize=%d", defaultDataLoopbackSize+delta), + fmt.Sprintf("dm.loopmetadatasize=%d", defaultMetaDataLoopbackSize+delta), + }, nil, nil) + if err != nil { + t.Fatalf("error creating devicemapper driver: %v", err) + } + driver = d.(*graphdriver.NaiveDiffDriver).ProtoDriver.(*Driver) + if s := driver.DeviceSet.Status(); s.Data.Total != uint64(expectDataSize) || s.Metadata.Total != uint64(expectMetaDataSize) { + t.Fatalf("data or metadata loop back size is incorrect") + } + if err := driver.Cleanup(); err != nil { + t.Fatal(err) + } +} + +// Make sure devices.Lock() has been release upon return from cleanupDeletedDevices() function +func TestDevmapperLockReleasedDeviceDeletion(t *testing.T) { + driver := graphtest.GetDriver(t, "devicemapper").(*graphtest.Driver).Driver.(*graphdriver.NaiveDiffDriver).ProtoDriver.(*Driver) + defer graphtest.PutDriver(t) + + // Call cleanupDeletedDevices() and after the call take and release + // DeviceSet Lock. If lock has not been released, this will hang. + driver.DeviceSet.cleanupDeletedDevices() + + doneChan := make(chan bool) + + go func() { + driver.DeviceSet.Lock() + defer driver.DeviceSet.Unlock() + doneChan <- true + }() + + select { + case <-time.After(time.Second * 5): + // Timer expired. That means lock was not released upon + // function return and we are deadlocked. Release lock + // here so that cleanup could succeed and fail the test. + driver.DeviceSet.Unlock() + t.Fatalf("Could not acquire devices lock after call to cleanupDeletedDevices()") + case <-doneChan: + } +} diff --git a/daemon/graphdriver/devmapper/driver.go b/daemon/graphdriver/devmapper/driver.go new file mode 100644 index 0000000000..75641c4761 --- /dev/null +++ b/daemon/graphdriver/devmapper/driver.go @@ -0,0 +1,218 @@ +// +build linux + +package devmapper + +import ( + "fmt" + "io/ioutil" + "os" + "path" + "strconv" + + "github.com/Sirupsen/logrus" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/devicemapper" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/units" +) + +func init() { + graphdriver.Register("devicemapper", Init) +} + +// Placeholder interfaces, to be replaced +// at integration. + +// End of placeholder interfaces. + +// Driver contains the device set mounted and the home directory +type Driver struct { + *DeviceSet + home string + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +var backingFs = "" + +// Init creates a driver with the given home and the set of options. +func Init(home string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + fsMagic, err := graphdriver.GetFSMagic(home) + if err != nil { + return nil, err + } + if fsName, ok := graphdriver.FsNames[fsMagic]; ok { + backingFs = fsName + } + + deviceSet, err := NewDeviceSet(home, true, options, uidMaps, gidMaps) + if err != nil { + return nil, err + } + + if err := mount.MakePrivate(home); err != nil { + return nil, err + } + + d := &Driver{ + DeviceSet: deviceSet, + home: home, + uidMaps: uidMaps, + gidMaps: gidMaps, + } + + return graphdriver.NewNaiveDiffDriver(d, uidMaps, gidMaps), nil +} + +func (d *Driver) String() string { + return "devicemapper" +} + +// Status returns the status about the driver in a printable format. +// Information returned contains Pool Name, Data File, Metadata file, disk usage by +// the data and metadata, etc. +func (d *Driver) Status() [][2]string { + s := d.DeviceSet.Status() + + status := [][2]string{ + {"Pool Name", s.PoolName}, + {"Pool Blocksize", fmt.Sprintf("%s", units.HumanSize(float64(s.SectorSize)))}, + {"Base Device Size", fmt.Sprintf("%s", units.HumanSize(float64(s.BaseDeviceSize)))}, + {"Backing Filesystem", s.BaseDeviceFS}, + {"Data file", s.DataFile}, + {"Metadata file", s.MetadataFile}, + {"Data Space Used", fmt.Sprintf("%s", units.HumanSize(float64(s.Data.Used)))}, + {"Data Space Total", fmt.Sprintf("%s", units.HumanSize(float64(s.Data.Total)))}, + {"Data Space Available", fmt.Sprintf("%s", units.HumanSize(float64(s.Data.Available)))}, + {"Metadata Space Used", fmt.Sprintf("%s", units.HumanSize(float64(s.Metadata.Used)))}, + {"Metadata Space Total", fmt.Sprintf("%s", units.HumanSize(float64(s.Metadata.Total)))}, + {"Metadata Space Available", fmt.Sprintf("%s", units.HumanSize(float64(s.Metadata.Available)))}, + {"Udev Sync Supported", fmt.Sprintf("%v", s.UdevSyncSupported)}, + {"Deferred Removal Enabled", fmt.Sprintf("%v", s.DeferredRemoveEnabled)}, + {"Deferred Deletion Enabled", fmt.Sprintf("%v", s.DeferredDeleteEnabled)}, + {"Deferred Deleted Device Count", fmt.Sprintf("%v", s.DeferredDeletedDeviceCount)}, + } + if len(s.DataLoopback) > 0 { + status = append(status, [2]string{"Data loop file", s.DataLoopback}) + } + if len(s.MetadataLoopback) > 0 { + status = append(status, [2]string{"Metadata loop file", s.MetadataLoopback}) + } + if vStr, err := devicemapper.GetLibraryVersion(); err == nil { + status = append(status, [2]string{"Library Version", vStr}) + } + return status +} + +// GetMetadata returns a map of information about the device. +func (d *Driver) GetMetadata(id string) (map[string]string, error) { + m, err := d.DeviceSet.exportDeviceMetadata(id) + + if err != nil { + return nil, err + } + + metadata := make(map[string]string) + metadata["DeviceId"] = strconv.Itoa(m.deviceID) + metadata["DeviceSize"] = strconv.FormatUint(m.deviceSize, 10) + metadata["DeviceName"] = m.deviceName + return metadata, nil +} + +// Cleanup unmounts a device. +func (d *Driver) Cleanup() error { + err := d.DeviceSet.Shutdown() + + if err2 := mount.Unmount(d.home); err == nil { + err = err2 + } + + return err +} + +// Create adds a device with a given id and the parent. +func (d *Driver) Create(id, parent string) error { + if err := d.DeviceSet.AddDevice(id, parent); err != nil { + return err + } + + return nil +} + +// Remove removes a device with a given id, unmounts the filesystem. +func (d *Driver) Remove(id string) error { + if !d.DeviceSet.HasDevice(id) { + // Consider removing a non-existing device a no-op + // This is useful to be able to progress on container removal + // if the underlying device has gone away due to earlier errors + return nil + } + + // This assumes the device has been properly Get/Put:ed and thus is unmounted + if err := d.DeviceSet.DeleteDevice(id, false); err != nil { + return err + } + + mp := path.Join(d.home, "mnt", id) + if err := os.RemoveAll(mp); err != nil && !os.IsNotExist(err) { + return err + } + + return nil +} + +// Get mounts a device with given id into the root filesystem +func (d *Driver) Get(id, mountLabel string) (string, error) { + mp := path.Join(d.home, "mnt", id) + + uid, gid, err := idtools.GetRootUIDGID(d.uidMaps, d.gidMaps) + if err != nil { + return "", err + } + // Create the target directories if they don't exist + if err := idtools.MkdirAllAs(path.Join(d.home, "mnt"), 0755, uid, gid); err != nil && !os.IsExist(err) { + return "", err + } + if err := idtools.MkdirAs(mp, 0755, uid, gid); err != nil && !os.IsExist(err) { + return "", err + } + + // Mount the device + if err := d.DeviceSet.MountDevice(id, mp, mountLabel); err != nil { + return "", err + } + + rootFs := path.Join(mp, "rootfs") + if err := idtools.MkdirAllAs(rootFs, 0755, uid, gid); err != nil && !os.IsExist(err) { + d.DeviceSet.UnmountDevice(id) + return "", err + } + + idFile := path.Join(mp, "id") + if _, err := os.Stat(idFile); err != nil && os.IsNotExist(err) { + // Create an "id" file with the container/image id in it to help reconscruct this in case + // of later problems + if err := ioutil.WriteFile(idFile, []byte(id), 0600); err != nil { + d.DeviceSet.UnmountDevice(id) + return "", err + } + } + + return rootFs, nil +} + +// Put unmounts a device and removes it. +func (d *Driver) Put(id string) error { + err := d.DeviceSet.UnmountDevice(id) + if err != nil { + logrus.Errorf("Error unmounting device %s: %s", id, err) + } + return err +} + +// Exists checks to see if the device exists. +func (d *Driver) Exists(id string) bool { + return d.DeviceSet.HasDevice(id) +} diff --git a/daemon/graphdriver/devmapper/mount.go b/daemon/graphdriver/devmapper/mount.go new file mode 100644 index 0000000000..84610db4ba --- /dev/null +++ b/daemon/graphdriver/devmapper/mount.go @@ -0,0 +1,89 @@ +// +build linux + +package devmapper + +import ( + "bytes" + "fmt" + "os" + "path/filepath" + "syscall" +) + +// FIXME: this is copy-pasted from the aufs driver. +// It should be moved into the core. + +// Mounted returns true if a mount point exists. +func Mounted(mountpoint string) (bool, error) { + mntpoint, err := os.Stat(mountpoint) + if err != nil { + if os.IsNotExist(err) { + return false, nil + } + return false, err + } + parent, err := os.Stat(filepath.Join(mountpoint, "..")) + if err != nil { + return false, err + } + mntpointSt := mntpoint.Sys().(*syscall.Stat_t) + parentSt := parent.Sys().(*syscall.Stat_t) + return mntpointSt.Dev != parentSt.Dev, nil +} + +type probeData struct { + fsName string + magic string + offset uint64 +} + +// ProbeFsType returns the filesystem name for the given device id. +func ProbeFsType(device string) (string, error) { + probes := []probeData{ + {"btrfs", "_BHRfS_M", 0x10040}, + {"ext4", "\123\357", 0x438}, + {"xfs", "XFSB", 0}, + } + + maxLen := uint64(0) + for _, p := range probes { + l := p.offset + uint64(len(p.magic)) + if l > maxLen { + maxLen = l + } + } + + file, err := os.Open(device) + if err != nil { + return "", err + } + defer file.Close() + + buffer := make([]byte, maxLen) + l, err := file.Read(buffer) + if err != nil { + return "", err + } + + if uint64(l) != maxLen { + return "", fmt.Errorf("unable to detect filesystem type of %s, short read", device) + } + + for _, p := range probes { + if bytes.Equal([]byte(p.magic), buffer[p.offset:p.offset+uint64(len(p.magic))]) { + return p.fsName, nil + } + } + + return "", fmt.Errorf("Unknown filesystem type on %s", device) +} + +func joinMountOptions(a, b string) string { + if a == "" { + return b + } + if b == "" { + return a + } + return a + "," + b +} diff --git a/daemon/graphdriver/driver.go b/daemon/graphdriver/driver.go new file mode 100644 index 0000000000..a24961d7d4 --- /dev/null +++ b/daemon/graphdriver/driver.go @@ -0,0 +1,222 @@ +package graphdriver + +import ( + "errors" + "fmt" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/idtools" +) + +// FsMagic unsigned id of the filesystem in use. +type FsMagic uint32 + +const ( + // FsMagicUnsupported is a predifined contant value other than a valid filesystem id. + FsMagicUnsupported = FsMagic(0x00000000) +) + +var ( + // DefaultDriver if a storage driver is not specified. + DefaultDriver string + // All registred drivers + drivers map[string]InitFunc + + // ErrNotSupported returned when driver is not supported. + ErrNotSupported = errors.New("driver not supported") + // ErrPrerequisites retuned when driver does not meet prerequisites. + ErrPrerequisites = errors.New("prerequisites for driver not satisfied (wrong filesystem?)") + // ErrIncompatibleFS returned when file system is not supported. + ErrIncompatibleFS = fmt.Errorf("backing file system is unsupported for this graph driver") +) + +// InitFunc initializes the storage driver. +type InitFunc func(root string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error) + +// ProtoDriver defines the basic capabilities of a driver. +// This interface exists solely to be a minimum set of methods +// for client code which choose not to implement the entire Driver +// interface and use the NaiveDiffDriver wrapper constructor. +// +// Use of ProtoDriver directly by client code is not recommended. +type ProtoDriver interface { + // String returns a string representation of this driver. + String() string + // Create creates a new, empty, filesystem layer with the + // specified id and parent. Parent may be "". + Create(id, parent string) error + // Remove attempts to remove the filesystem layer with this id. + Remove(id string) error + // Get returns the mountpoint for the layered filesystem referred + // to by this id. You can optionally specify a mountLabel or "". + // Returns the absolute path to the mounted layered filesystem. + Get(id, mountLabel string) (dir string, err error) + // Put releases the system resources for the specified id, + // e.g, unmounting layered filesystem. + Put(id string) error + // Exists returns whether a filesystem layer with the specified + // ID exists on this driver. + Exists(id string) bool + // Status returns a set of key-value pairs which give low + // level diagnostic status about this driver. + Status() [][2]string + // Returns a set of key-value pairs which give low level information + // about the image/container driver is managing. + GetMetadata(id string) (map[string]string, error) + // Cleanup performs necessary tasks to release resources + // held by the driver, e.g., unmounting all layered filesystems + // known to this driver. + Cleanup() error +} + +// Driver is the interface for layered/snapshot file system drivers. +type Driver interface { + ProtoDriver + // Diff produces an archive of the changes between the specified + // layer and its parent layer which may be "". + Diff(id, parent string) (archive.Archive, error) + // Changes produces a list of changes between the specified layer + // and its parent layer. If parent is "", then all changes will be ADD changes. + Changes(id, parent string) ([]archive.Change, error) + // ApplyDiff extracts the changeset from the given diff into the + // layer with the specified id and parent, returning the size of the + // new layer in bytes. + // The archive.Reader must be an uncompressed stream. + ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error) + // DiffSize calculates the changes between the specified id + // and its parent and returns the size in bytes of the changes + // relative to its base filesystem directory. + DiffSize(id, parent string) (size int64, err error) +} + +func init() { + drivers = make(map[string]InitFunc) +} + +// Register registers a InitFunc for the driver. +func Register(name string, initFunc InitFunc) error { + if _, exists := drivers[name]; exists { + return fmt.Errorf("Name already registered %s", name) + } + drivers[name] = initFunc + + return nil +} + +// GetDriver initializes and returns the registered driver +func GetDriver(name, home string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error) { + if initFunc, exists := drivers[name]; exists { + return initFunc(filepath.Join(home, name), options, uidMaps, gidMaps) + } + if pluginDriver, err := lookupPlugin(name, home, options); err == nil { + return pluginDriver, nil + } + logrus.Errorf("Failed to GetDriver graph %s %s", name, home) + return nil, ErrNotSupported +} + +// getBuiltinDriver initalizes and returns the registered driver, but does not try to load from plugins +func getBuiltinDriver(name, home string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error) { + if initFunc, exists := drivers[name]; exists { + return initFunc(filepath.Join(home, name), options, uidMaps, gidMaps) + } + logrus.Errorf("Failed to built-in GetDriver graph %s %s", name, home) + return nil, ErrNotSupported +} + +// New creates the driver and initializes it at the specified root. +func New(root string, options []string, uidMaps, gidMaps []idtools.IDMap) (driver Driver, err error) { + for _, name := range []string{os.Getenv("DOCKER_DRIVER"), DefaultDriver} { + if name != "" { + logrus.Debugf("[graphdriver] trying provided driver %q", name) // so the logs show specified driver + return GetDriver(name, root, options, uidMaps, gidMaps) + } + } + + // Guess for prior driver + priorDrivers := scanPriorDrivers(root) + for _, name := range priority { + if name == "vfs" { + // don't use vfs even if there is state present. + continue + } + for _, prior := range priorDrivers { + // of the state found from prior drivers, check in order of our priority + // which we would prefer + if prior == name { + driver, err = getBuiltinDriver(name, root, options, uidMaps, gidMaps) + if err != nil { + // unlike below, we will return error here, because there is prior + // state, and now it is no longer supported/prereq/compatible, so + // something changed and needs attention. Otherwise the daemon's + // images would just "disappear". + logrus.Errorf("[graphdriver] prior storage driver %q failed: %s", name, err) + return nil, err + } + if err := checkPriorDriver(name, root); err != nil { + return nil, err + } + logrus.Infof("[graphdriver] using prior storage driver %q", name) + return driver, nil + } + } + } + + // Check for priority drivers first + for _, name := range priority { + driver, err = getBuiltinDriver(name, root, options, uidMaps, gidMaps) + if err != nil { + if err == ErrNotSupported || err == ErrPrerequisites || err == ErrIncompatibleFS { + continue + } + return nil, err + } + return driver, nil + } + + // Check all registered drivers if no priority driver is found + for _, initFunc := range drivers { + if driver, err = initFunc(root, options, uidMaps, gidMaps); err != nil { + if err == ErrNotSupported || err == ErrPrerequisites || err == ErrIncompatibleFS { + continue + } + return nil, err + } + return driver, nil + } + return nil, fmt.Errorf("No supported storage backend found") +} + +// scanPriorDrivers returns an un-ordered scan of directories of prior storage drivers +func scanPriorDrivers(root string) []string { + priorDrivers := []string{} + for driver := range drivers { + p := filepath.Join(root, driver) + if _, err := os.Stat(p); err == nil && driver != "vfs" { + priorDrivers = append(priorDrivers, driver) + } + } + return priorDrivers +} + +func checkPriorDriver(name, root string) error { + priorDrivers := []string{} + for _, prior := range scanPriorDrivers(root) { + if prior != name && prior != "vfs" { + if _, err := os.Stat(filepath.Join(root, prior)); err == nil { + priorDrivers = append(priorDrivers, prior) + } + } + } + + if len(priorDrivers) > 0 { + + return fmt.Errorf("%q contains other graphdrivers: %s; Please cleanup or explicitly choose storage driver (-s )", root, strings.Join(priorDrivers, ",")) + } + return nil +} diff --git a/daemon/graphdriver/driver_freebsd.go b/daemon/graphdriver/driver_freebsd.go new file mode 100644 index 0000000000..be4eb52653 --- /dev/null +++ b/daemon/graphdriver/driver_freebsd.go @@ -0,0 +1,8 @@ +package graphdriver + +var ( + // Slice of drivers that should be used in an order + priority = []string{ + "zfs", + } +) diff --git a/daemon/graphdriver/driver_linux.go b/daemon/graphdriver/driver_linux.go new file mode 100644 index 0000000000..410a62ff7c --- /dev/null +++ b/daemon/graphdriver/driver_linux.go @@ -0,0 +1,85 @@ +// +build linux + +package graphdriver + +import ( + "path/filepath" + "syscall" +) + +const ( + // FsMagicAufs filesystem id for Aufs + FsMagicAufs = FsMagic(0x61756673) + // FsMagicBtrfs filesystem id for Btrfs + FsMagicBtrfs = FsMagic(0x9123683E) + // FsMagicCramfs filesystem id for Cramfs + FsMagicCramfs = FsMagic(0x28cd3d45) + // FsMagicExtfs filesystem id for Extfs + FsMagicExtfs = FsMagic(0x0000EF53) + // FsMagicF2fs filesystem id for F2fs + FsMagicF2fs = FsMagic(0xF2F52010) + // FsMagicJffs2Fs filesystem if for Jffs2Fs + FsMagicJffs2Fs = FsMagic(0x000072b6) + // FsMagicJfs filesystem id for Jfs + FsMagicJfs = FsMagic(0x3153464a) + // FsMagicNfsFs filesystem id for NfsFs + FsMagicNfsFs = FsMagic(0x00006969) + // FsMagicRAMFs filesystem id for RamFs + FsMagicRAMFs = FsMagic(0x858458f6) + // FsMagicReiserFs filesystem id for ReiserFs + FsMagicReiserFs = FsMagic(0x52654973) + // FsMagicSmbFs filesystem id for SmbFs + FsMagicSmbFs = FsMagic(0x0000517B) + // FsMagicSquashFs filesystem id for SquashFs + FsMagicSquashFs = FsMagic(0x73717368) + // FsMagicTmpFs filesystem id for TmpFs + FsMagicTmpFs = FsMagic(0x01021994) + // FsMagicVxFS filesystem id for VxFs + FsMagicVxFS = FsMagic(0xa501fcf5) + // FsMagicXfs filesystem id for Xfs + FsMagicXfs = FsMagic(0x58465342) + // FsMagicZfs filesystem id for Zfs + FsMagicZfs = FsMagic(0x2fc12fc1) +) + +var ( + // Slice of drivers that should be used in an order + priority = []string{ + "aufs", + "btrfs", + "zfs", + "devicemapper", + "overlay", + "vfs", + } + + // FsNames maps filesystem id to name of the filesystem. + FsNames = map[FsMagic]string{ + FsMagicAufs: "aufs", + FsMagicBtrfs: "btrfs", + FsMagicCramfs: "cramfs", + FsMagicExtfs: "extfs", + FsMagicF2fs: "f2fs", + FsMagicJffs2Fs: "jffs2", + FsMagicJfs: "jfs", + FsMagicNfsFs: "nfs", + FsMagicRAMFs: "ramfs", + FsMagicReiserFs: "reiserfs", + FsMagicSmbFs: "smb", + FsMagicSquashFs: "squashfs", + FsMagicTmpFs: "tmpfs", + FsMagicUnsupported: "unsupported", + FsMagicVxFS: "vxfs", + FsMagicXfs: "xfs", + FsMagicZfs: "zfs", + } +) + +// GetFSMagic returns the filesystem id given the path. +func GetFSMagic(rootpath string) (FsMagic, error) { + var buf syscall.Statfs_t + if err := syscall.Statfs(filepath.Dir(rootpath), &buf); err != nil { + return 0, err + } + return FsMagic(buf.Type), nil +} diff --git a/daemon/graphdriver/driver_unsupported.go b/daemon/graphdriver/driver_unsupported.go new file mode 100644 index 0000000000..b3f6857309 --- /dev/null +++ b/daemon/graphdriver/driver_unsupported.go @@ -0,0 +1,15 @@ +// +build !linux,!windows,!freebsd + +package graphdriver + +var ( + // Slice of drivers that should be used in an order + priority = []string{ + "unsupported", + } +) + +// GetFSMagic returns the filesystem id given the path. +func GetFSMagic(rootpath string) (FsMagic, error) { + return FsMagicUnsupported, nil +} diff --git a/daemon/graphdriver/driver_windows.go b/daemon/graphdriver/driver_windows.go new file mode 100644 index 0000000000..6c09affae3 --- /dev/null +++ b/daemon/graphdriver/driver_windows.go @@ -0,0 +1,16 @@ +package graphdriver + +var ( + // Slice of drivers that should be used in order + priority = []string{ + "windowsfilter", + "windowsdiff", + "vfs", + } +) + +// GetFSMagic returns the filesystem id given the path. +func GetFSMagic(rootpath string) (FsMagic, error) { + // Note it is OK to return FsMagicUnsupported on Windows. + return FsMagicUnsupported, nil +} diff --git a/daemon/graphdriver/fsdiff.go b/daemon/graphdriver/fsdiff.go new file mode 100644 index 0000000000..ea0b053aa3 --- /dev/null +++ b/daemon/graphdriver/fsdiff.go @@ -0,0 +1,158 @@ +// +build daemon + +package graphdriver + +import ( + "time" + + "github.com/Sirupsen/logrus" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/ioutils" +) + +// NaiveDiffDriver takes a ProtoDriver and adds the +// capability of the Diffing methods which it may or may not +// support on its own. See the comment on the exported +// NewNaiveDiffDriver function below. +// Notably, the AUFS driver doesn't need to be wrapped like this. +type NaiveDiffDriver struct { + ProtoDriver + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +// NewNaiveDiffDriver returns a fully functional driver that wraps the +// given ProtoDriver and adds the capability of the following methods which +// it may or may not support on its own: +// Diff(id, parent string) (archive.Archive, error) +// Changes(id, parent string) ([]archive.Change, error) +// ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error) +// DiffSize(id, parent string) (size int64, err error) +func NewNaiveDiffDriver(driver ProtoDriver, uidMaps, gidMaps []idtools.IDMap) Driver { + return &NaiveDiffDriver{ProtoDriver: driver, + uidMaps: uidMaps, + gidMaps: gidMaps} +} + +// Diff produces an archive of the changes between the specified +// layer and its parent layer which may be "". +func (gdw *NaiveDiffDriver) Diff(id, parent string) (arch archive.Archive, err error) { + driver := gdw.ProtoDriver + + layerFs, err := driver.Get(id, "") + if err != nil { + return nil, err + } + + defer func() { + if err != nil { + driver.Put(id) + } + }() + + if parent == "" { + archive, err := archive.Tar(layerFs, archive.Uncompressed) + if err != nil { + return nil, err + } + return ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + driver.Put(id) + return err + }), nil + } + + parentFs, err := driver.Get(parent, "") + if err != nil { + return nil, err + } + defer driver.Put(parent) + + changes, err := archive.ChangesDirs(layerFs, parentFs) + if err != nil { + return nil, err + } + + archive, err := archive.ExportChanges(layerFs, changes, gdw.uidMaps, gdw.gidMaps) + if err != nil { + return nil, err + } + + return ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + driver.Put(id) + return err + }), nil +} + +// Changes produces a list of changes between the specified layer +// and its parent layer. If parent is "", then all changes will be ADD changes. +func (gdw *NaiveDiffDriver) Changes(id, parent string) ([]archive.Change, error) { + driver := gdw.ProtoDriver + + layerFs, err := driver.Get(id, "") + if err != nil { + return nil, err + } + defer driver.Put(id) + + parentFs := "" + + if parent != "" { + parentFs, err = driver.Get(parent, "") + if err != nil { + return nil, err + } + defer driver.Put(parent) + } + + return archive.ChangesDirs(layerFs, parentFs) +} + +// ApplyDiff extracts the changeset from the given diff into the +// layer with the specified id and parent, returning the size of the +// new layer in bytes. +func (gdw *NaiveDiffDriver) ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error) { + driver := gdw.ProtoDriver + + // Mount the root filesystem so we can apply the diff/layer. + layerFs, err := driver.Get(id, "") + if err != nil { + return + } + defer driver.Put(id) + + options := &archive.TarOptions{UIDMaps: gdw.uidMaps, + GIDMaps: gdw.gidMaps} + start := time.Now().UTC() + logrus.Debugf("Start untar layer") + if size, err = chrootarchive.ApplyUncompressedLayer(layerFs, diff, options); err != nil { + return + } + logrus.Debugf("Untar time: %vs", time.Now().UTC().Sub(start).Seconds()) + + return +} + +// DiffSize calculates the changes between the specified layer +// and its parent and returns the size in bytes of the changes +// relative to its base filesystem directory. +func (gdw *NaiveDiffDriver) DiffSize(id, parent string) (size int64, err error) { + driver := gdw.ProtoDriver + + changes, err := gdw.Changes(id, parent) + if err != nil { + return + } + + layerFs, err := driver.Get(id, "") + if err != nil { + return + } + defer driver.Put(id) + + return archive.ChangesSize(layerFs, changes), nil +} diff --git a/daemon/graphdriver/graphtest/graphtest.go b/daemon/graphdriver/graphtest/graphtest.go new file mode 100644 index 0000000000..33a8669725 --- /dev/null +++ b/daemon/graphdriver/graphtest/graphtest.go @@ -0,0 +1,297 @@ +package graphtest + +import ( + "fmt" + "io/ioutil" + "os" + "path" + "syscall" + "testing" + + "github.com/docker/docker/daemon/graphdriver" +) + +var ( + drv *Driver +) + +// Driver conforms to graphdriver.Driver interface and +// contains information such as root and reference count of the number of clients using it. +// This helps in testing drivers added into the framework. +type Driver struct { + graphdriver.Driver + root string + refCount int +} + +// InitLoopbacks ensures that the loopback devices are properly created within +// the system running the device mapper tests. +func InitLoopbacks() error { + statT, err := getBaseLoopStats() + if err != nil { + return err + } + // create at least 8 loopback files, ya, that is a good number + for i := 0; i < 8; i++ { + loopPath := fmt.Sprintf("/dev/loop%d", i) + // only create new loopback files if they don't exist + if _, err := os.Stat(loopPath); err != nil { + if mkerr := syscall.Mknod(loopPath, + uint32(statT.Mode|syscall.S_IFBLK), int((7<<8)|(i&0xff)|((i&0xfff00)<<12))); mkerr != nil { + return mkerr + } + os.Chown(loopPath, int(statT.Uid), int(statT.Gid)) + } + } + return nil +} + +// getBaseLoopStats inspects /dev/loop0 to collect uid,gid, and mode for the +// loop0 device on the system. If it does not exist we assume 0,0,0660 for the +// stat data +func getBaseLoopStats() (*syscall.Stat_t, error) { + loop0, err := os.Stat("/dev/loop0") + if err != nil { + if os.IsNotExist(err) { + return &syscall.Stat_t{ + Uid: 0, + Gid: 0, + Mode: 0660, + }, nil + } + return nil, err + } + return loop0.Sys().(*syscall.Stat_t), nil +} + +func newDriver(t *testing.T, name string) *Driver { + root, err := ioutil.TempDir("/var/tmp", "docker-graphtest-") + if err != nil { + t.Fatal(err) + } + + if err := os.MkdirAll(root, 0755); err != nil { + t.Fatal(err) + } + + d, err := graphdriver.GetDriver(name, root, nil, nil, nil) + if err != nil { + t.Logf("graphdriver: %v\n", err) + if err == graphdriver.ErrNotSupported || err == graphdriver.ErrPrerequisites || err == graphdriver.ErrIncompatibleFS { + t.Skipf("Driver %s not supported", name) + } + t.Fatal(err) + } + return &Driver{d, root, 1} +} + +func cleanup(t *testing.T, d *Driver) { + if err := drv.Cleanup(); err != nil { + t.Fatal(err) + } + os.RemoveAll(d.root) +} + +// GetDriver create a new driver with given name or return a existing driver with the name updating the reference count. +func GetDriver(t *testing.T, name string) graphdriver.Driver { + if drv == nil { + drv = newDriver(t, name) + } else { + drv.refCount++ + } + return drv +} + +// PutDriver removes the driver if it is no longer used and updates the reference count. +func PutDriver(t *testing.T) { + if drv == nil { + t.Skip("No driver to put!") + } + drv.refCount-- + if drv.refCount == 0 { + cleanup(t, drv) + drv = nil + } +} + +func verifyFile(t *testing.T, path string, mode os.FileMode, uid, gid uint32) { + fi, err := os.Stat(path) + if err != nil { + t.Fatal(err) + } + + if fi.Mode()&os.ModeType != mode&os.ModeType { + t.Fatalf("Expected %s type 0x%x, got 0x%x", path, mode&os.ModeType, fi.Mode()&os.ModeType) + } + + if fi.Mode()&os.ModePerm != mode&os.ModePerm { + t.Fatalf("Expected %s mode %o, got %o", path, mode&os.ModePerm, fi.Mode()&os.ModePerm) + } + + if fi.Mode()&os.ModeSticky != mode&os.ModeSticky { + t.Fatalf("Expected %s sticky 0x%x, got 0x%x", path, mode&os.ModeSticky, fi.Mode()&os.ModeSticky) + } + + if fi.Mode()&os.ModeSetuid != mode&os.ModeSetuid { + t.Fatalf("Expected %s setuid 0x%x, got 0x%x", path, mode&os.ModeSetuid, fi.Mode()&os.ModeSetuid) + } + + if fi.Mode()&os.ModeSetgid != mode&os.ModeSetgid { + t.Fatalf("Expected %s setgid 0x%x, got 0x%x", path, mode&os.ModeSetgid, fi.Mode()&os.ModeSetgid) + } + + if stat, ok := fi.Sys().(*syscall.Stat_t); ok { + if stat.Uid != uid { + t.Fatalf("%s no owned by uid %d", path, uid) + } + if stat.Gid != gid { + t.Fatalf("%s not owned by gid %d", path, gid) + } + } + +} + +// readDir reads a directory just like ioutil.ReadDir() +// then hides specific files (currently "lost+found") +// so the tests don't "see" it +func readDir(dir string) ([]os.FileInfo, error) { + a, err := ioutil.ReadDir(dir) + if err != nil { + return nil, err + } + + b := a[:0] + for _, x := range a { + if x.Name() != "lost+found" { // ext4 always have this dir + b = append(b, x) + } + } + + return b, nil +} + +// DriverTestCreateEmpty creates an new image and verifies it is empty and the right metadata +func DriverTestCreateEmpty(t *testing.T, drivername string) { + driver := GetDriver(t, drivername) + defer PutDriver(t) + + if err := driver.Create("empty", ""); err != nil { + t.Fatal(err) + } + + if !driver.Exists("empty") { + t.Fatal("Newly created image doesn't exist") + } + + dir, err := driver.Get("empty", "") + if err != nil { + t.Fatal(err) + } + + verifyFile(t, dir, 0755|os.ModeDir, 0, 0) + + // Verify that the directory is empty + fis, err := readDir(dir) + if err != nil { + t.Fatal(err) + } + + if len(fis) != 0 { + t.Fatal("New directory not empty") + } + + driver.Put("empty") + + if err := driver.Remove("empty"); err != nil { + t.Fatal(err) + } + +} + +func createBase(t *testing.T, driver graphdriver.Driver, name string) { + // We need to be able to set any perms + oldmask := syscall.Umask(0) + defer syscall.Umask(oldmask) + + if err := driver.Create(name, ""); err != nil { + t.Fatal(err) + } + + dir, err := driver.Get(name, "") + if err != nil { + t.Fatal(err) + } + defer driver.Put(name) + + subdir := path.Join(dir, "a subdir") + if err := os.Mkdir(subdir, 0705|os.ModeSticky); err != nil { + t.Fatal(err) + } + if err := os.Chown(subdir, 1, 2); err != nil { + t.Fatal(err) + } + + file := path.Join(dir, "a file") + if err := ioutil.WriteFile(file, []byte("Some data"), 0222|os.ModeSetuid); err != nil { + t.Fatal(err) + } +} + +func verifyBase(t *testing.T, driver graphdriver.Driver, name string) { + dir, err := driver.Get(name, "") + if err != nil { + t.Fatal(err) + } + defer driver.Put(name) + + subdir := path.Join(dir, "a subdir") + verifyFile(t, subdir, 0705|os.ModeDir|os.ModeSticky, 1, 2) + + file := path.Join(dir, "a file") + verifyFile(t, file, 0222|os.ModeSetuid, 0, 0) + + fis, err := readDir(dir) + if err != nil { + t.Fatal(err) + } + + if len(fis) != 2 { + t.Fatal("Unexpected files in base image") + } + +} + +// DriverTestCreateBase create a base driver and verify. +func DriverTestCreateBase(t *testing.T, drivername string) { + driver := GetDriver(t, drivername) + defer PutDriver(t) + + createBase(t, driver, "Base") + verifyBase(t, driver, "Base") + + if err := driver.Remove("Base"); err != nil { + t.Fatal(err) + } +} + +// DriverTestCreateSnap Create a driver and snap and verify. +func DriverTestCreateSnap(t *testing.T, drivername string) { + driver := GetDriver(t, drivername) + defer PutDriver(t) + + createBase(t, driver, "Base") + + if err := driver.Create("Snap", "Base"); err != nil { + t.Fatal(err) + } + + verifyBase(t, driver, "Snap") + + if err := driver.Remove("Snap"); err != nil { + t.Fatal(err) + } + + if err := driver.Remove("Base"); err != nil { + t.Fatal(err) + } +} diff --git a/daemon/graphdriver/imagerestorer.go b/daemon/graphdriver/imagerestorer.go new file mode 100644 index 0000000000..d6592203b5 --- /dev/null +++ b/daemon/graphdriver/imagerestorer.go @@ -0,0 +1,31 @@ +package graphdriver + +import ( + "io" + + "github.com/docker/docker/image" +) + +// NOTE: These interfaces are used for implementing specific features of the Windows +// graphdriver implementation. The current versions are a short-term solution and +// likely to change or possibly be eliminated, so avoid using them outside of the Windows +// graphdriver code. + +// ImageRestorer interface allows the implementer to add a custom image to +// the graph and tagstore. +type ImageRestorer interface { + RestoreCustomImages(tagger Tagger, recorder Recorder) ([]string, error) +} + +// Tagger is an interface that exposes the TagStore.Tag function without needing +// to import graph. +type Tagger interface { + Tag(repoName, tag, imageName string, force bool) error +} + +// Recorder is an interface that exposes the Graph.Register and Graph.Exists +// functions without needing to import graph. +type Recorder interface { + Exists(id string) bool + Register(img image.Descriptor, layerData io.Reader) error +} diff --git a/daemon/graphdriver/overlay/copy.go b/daemon/graphdriver/overlay/copy.go new file mode 100644 index 0000000000..def4d439c7 --- /dev/null +++ b/daemon/graphdriver/overlay/copy.go @@ -0,0 +1,169 @@ +// +build linux + +package overlay + +import ( + "fmt" + "io" + "os" + "path/filepath" + "syscall" + "time" + + "github.com/docker/docker/pkg/system" +) + +type copyFlags int + +const ( + copyHardlink copyFlags = 1 << iota +) + +func copyRegular(srcPath, dstPath string, mode os.FileMode) error { + srcFile, err := os.Open(srcPath) + if err != nil { + return err + } + defer srcFile.Close() + + dstFile, err := os.OpenFile(dstPath, os.O_WRONLY|os.O_CREATE, mode) + if err != nil { + return err + } + defer dstFile.Close() + + _, err = io.Copy(dstFile, srcFile) + + return err +} + +func copyXattr(srcPath, dstPath, attr string) error { + data, err := system.Lgetxattr(srcPath, attr) + if err != nil { + return err + } + if data != nil { + if err := system.Lsetxattr(dstPath, attr, data, 0); err != nil { + return err + } + } + return nil +} + +func copyDir(srcDir, dstDir string, flags copyFlags) error { + err := filepath.Walk(srcDir, func(srcPath string, f os.FileInfo, err error) error { + if err != nil { + return err + } + + // Rebase path + relPath, err := filepath.Rel(srcDir, srcPath) + if err != nil { + return err + } + + dstPath := filepath.Join(dstDir, relPath) + if err != nil { + return err + } + + stat, ok := f.Sys().(*syscall.Stat_t) + if !ok { + return fmt.Errorf("Unable to get raw syscall.Stat_t data for %s", srcPath) + } + + isHardlink := false + + switch f.Mode() & os.ModeType { + case 0: // Regular file + if flags©Hardlink != 0 { + isHardlink = true + if err := os.Link(srcPath, dstPath); err != nil { + return err + } + } else { + if err := copyRegular(srcPath, dstPath, f.Mode()); err != nil { + return err + } + } + + case os.ModeDir: + if err := os.Mkdir(dstPath, f.Mode()); err != nil && !os.IsExist(err) { + return err + } + + case os.ModeSymlink: + link, err := os.Readlink(srcPath) + if err != nil { + return err + } + + if err := os.Symlink(link, dstPath); err != nil { + return err + } + + case os.ModeNamedPipe: + fallthrough + case os.ModeSocket: + if err := syscall.Mkfifo(dstPath, stat.Mode); err != nil { + return err + } + + case os.ModeDevice: + if err := syscall.Mknod(dstPath, stat.Mode, int(stat.Rdev)); err != nil { + return err + } + + default: + return fmt.Errorf("Unknown file type for %s\n", srcPath) + } + + // Everything below is copying metadata from src to dst. All this metadata + // already shares an inode for hardlinks. + if isHardlink { + return nil + } + + if err := os.Lchown(dstPath, int(stat.Uid), int(stat.Gid)); err != nil { + return err + } + + if err := copyXattr(srcPath, dstPath, "security.capability"); err != nil { + return err + } + + // We need to copy this attribute if it appears in an overlay upper layer, as + // this function is used to copy those. It is set by overlay if a directory + // is removed and then re-created and should not inherit anything from the + // same dir in the lower dir. + if err := copyXattr(srcPath, dstPath, "trusted.overlay.opaque"); err != nil { + return err + } + + isSymlink := f.Mode()&os.ModeSymlink != 0 + + // There is no LChmod, so ignore mode for symlink. Also, this + // must happen after chown, as that can modify the file mode + if !isSymlink { + if err := os.Chmod(dstPath, f.Mode()); err != nil { + return err + } + } + + // system.Chtimes doesn't support a NOFOLLOW flag atm + if !isSymlink { + aTime := time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + mTime := time.Unix(int64(stat.Mtim.Sec), int64(stat.Mtim.Nsec)) + if err := system.Chtimes(dstPath, aTime, mTime); err != nil { + return err + } + } else { + ts := []syscall.Timespec{stat.Atim, stat.Mtim} + if err := system.LUtimesNano(dstPath, ts); err != nil { + return err + } + } + return nil + }) + return err +} diff --git a/daemon/graphdriver/overlay/overlay.go b/daemon/graphdriver/overlay/overlay.go new file mode 100644 index 0000000000..634dd26d42 --- /dev/null +++ b/daemon/graphdriver/overlay/overlay.go @@ -0,0 +1,486 @@ +// +build linux + +package overlay + +import ( + "bufio" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path" + "strings" + "sync" + "syscall" + + "github.com/Sirupsen/logrus" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/idtools" + + "github.com/opencontainers/runc/libcontainer/label" +) + +// This is a small wrapper over the NaiveDiffWriter that lets us have a custom +// implementation of ApplyDiff() + +var ( + // ErrApplyDiffFallback is returned to indicate that a normal ApplyDiff is applied as a fallback from Naive diff writer. + ErrApplyDiffFallback = fmt.Errorf("Fall back to normal ApplyDiff") +) + +// ApplyDiffProtoDriver wraps the ProtoDriver by extending the inteface with ApplyDiff method. +type ApplyDiffProtoDriver interface { + graphdriver.ProtoDriver + // ApplyDiff writes the diff to the archive for the given id and parent id. + // It returns the size in bytes written if successful, an error ErrApplyDiffFallback is returned otherwise. + ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error) +} + +type naiveDiffDriverWithApply struct { + graphdriver.Driver + applyDiff ApplyDiffProtoDriver +} + +// NaiveDiffDriverWithApply returns a NaiveDiff driver with custom ApplyDiff. +func NaiveDiffDriverWithApply(driver ApplyDiffProtoDriver, uidMaps, gidMaps []idtools.IDMap) graphdriver.Driver { + return &naiveDiffDriverWithApply{ + Driver: graphdriver.NewNaiveDiffDriver(driver, uidMaps, gidMaps), + applyDiff: driver, + } +} + +// ApplyDiff creates a diff layer with either the NaiveDiffDriver or with a fallback. +func (d *naiveDiffDriverWithApply) ApplyDiff(id, parent string, diff archive.Reader) (int64, error) { + b, err := d.applyDiff.ApplyDiff(id, parent, diff) + if err == ErrApplyDiffFallback { + return d.Driver.ApplyDiff(id, parent, diff) + } + return b, err +} + +// This backend uses the overlay union filesystem for containers +// plus hard link file sharing for images. + +// Each container/image can have a "root" subdirectory which is a plain +// filesystem hierarchy, or they can use overlay. + +// If they use overlay there is a "upper" directory and a "lower-id" +// file, as well as "merged" and "work" directories. The "upper" +// directory has the upper layer of the overlay, and "lower-id" contains +// the id of the parent whose "root" directory shall be used as the lower +// layer in the overlay. The overlay itself is mounted in the "merged" +// directory, and the "work" dir is needed for overlay to work. + +// When a overlay layer is created there are two cases, either the +// parent has a "root" dir, then we start out with a empty "upper" +// directory overlaid on the parents root. This is typically the +// case with the init layer of a container which is based on an image. +// If there is no "root" in the parent, we inherit the lower-id from +// the parent and start by making a copy in the parent's "upper" dir. +// This is typically the case for a container layer which copies +// its parent -init upper layer. + +// Additionally we also have a custom implementation of ApplyLayer +// which makes a recursive copy of the parent "root" layer using +// hardlinks to share file data, and then applies the layer on top +// of that. This means all child images share file (but not directory) +// data with the parent. + +// ActiveMount contains information about the count, path and whether is mounted or not. +// This information is part of the Driver, that contains list of active mounts that are part of this overlay. +type ActiveMount struct { + count int + path string + mounted bool +} + +// Driver contains information about the home directory and the list of active mounts that are created using this driver. +type Driver struct { + home string + sync.Mutex // Protects concurrent modification to active + active map[string]*ActiveMount + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +var backingFs = "" + +func init() { + graphdriver.Register("overlay", Init) +} + +// Init returns the NaiveDiffDriver, a native diff driver for overlay filesystem. +// If overlay filesystem is not supported on the host, graphdriver.ErrNotSupported is returned as error. +// If a overlay filesystem is not supported over a existing filesystem then error graphdriver.ErrIncompatibleFS is returned. +func Init(home string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + + if err := supportsOverlay(); err != nil { + return nil, graphdriver.ErrNotSupported + } + + fsMagic, err := graphdriver.GetFSMagic(home) + if err != nil { + return nil, err + } + if fsName, ok := graphdriver.FsNames[fsMagic]; ok { + backingFs = fsName + } + + // check if they are running over btrfs or aufs + switch fsMagic { + case graphdriver.FsMagicBtrfs: + logrus.Error("'overlay' is not supported over btrfs.") + return nil, graphdriver.ErrIncompatibleFS + case graphdriver.FsMagicAufs: + logrus.Error("'overlay' is not supported over aufs.") + return nil, graphdriver.ErrIncompatibleFS + case graphdriver.FsMagicZfs: + logrus.Error("'overlay' is not supported over zfs.") + return nil, graphdriver.ErrIncompatibleFS + } + + rootUID, rootGID, err := idtools.GetRootUIDGID(uidMaps, gidMaps) + if err != nil { + return nil, err + } + // Create the driver home dir + if err := idtools.MkdirAllAs(home, 0755, rootUID, rootGID); err != nil && !os.IsExist(err) { + return nil, err + } + + d := &Driver{ + home: home, + active: make(map[string]*ActiveMount), + uidMaps: uidMaps, + gidMaps: gidMaps, + } + + return NaiveDiffDriverWithApply(d, uidMaps, gidMaps), nil +} + +func supportsOverlay() error { + // We can try to modprobe overlay first before looking at + // proc/filesystems for when overlay is supported + exec.Command("modprobe", "overlay").Run() + + f, err := os.Open("/proc/filesystems") + if err != nil { + return err + } + defer f.Close() + + s := bufio.NewScanner(f) + for s.Scan() { + if s.Text() == "nodev\toverlay" { + return nil + } + } + logrus.Error("'overlay' not found as a supported filesystem on this host. Please ensure kernel is new enough and has overlay support loaded.") + return graphdriver.ErrNotSupported +} + +func (d *Driver) String() string { + return "overlay" +} + +// Status returns current driver information in a two dimensional string array. +// Output contains "Backing Filesystem" used in this implementation. +func (d *Driver) Status() [][2]string { + return [][2]string{ + {"Backing Filesystem", backingFs}, + } +} + +// GetMetadata returns meta data about the overlay driver such as root, LowerDir, UpperDir, WorkDir and MergeDir used to store data. +func (d *Driver) GetMetadata(id string) (map[string]string, error) { + dir := d.dir(id) + if _, err := os.Stat(dir); err != nil { + return nil, err + } + + metadata := make(map[string]string) + + // If id has a root, it is an image + rootDir := path.Join(dir, "root") + if _, err := os.Stat(rootDir); err == nil { + metadata["RootDir"] = rootDir + return metadata, nil + } + + lowerID, err := ioutil.ReadFile(path.Join(dir, "lower-id")) + if err != nil { + return nil, err + } + + metadata["LowerDir"] = path.Join(d.dir(string(lowerID)), "root") + metadata["UpperDir"] = path.Join(dir, "upper") + metadata["WorkDir"] = path.Join(dir, "work") + metadata["MergedDir"] = path.Join(dir, "merged") + + return metadata, nil +} + +// Cleanup simply returns nil and do not change the existing filesystem. +// This is required to satisfy the graphdriver.Driver interface. +func (d *Driver) Cleanup() error { + return nil +} + +// Create is used to create the upper, lower, and merge directories required for overlay fs for a given id. +// The parent filesystem is used to configure these directories for the overlay. +func (d *Driver) Create(id string, parent string) (retErr error) { + id = excludeOverlayIncompatibleChars(id) + parent = excludeOverlayIncompatibleChars(parent) + dir := d.dir(id) + + rootUID, rootGID, err := idtools.GetRootUIDGID(d.uidMaps, d.gidMaps) + if err != nil { + return err + } + if err := idtools.MkdirAllAs(path.Dir(dir), 0700, rootUID, rootGID); err != nil { + return err + } + if err := idtools.MkdirAs(dir, 0700, rootUID, rootGID); err != nil { + return err + } + + defer func() { + // Clean up on failure + if retErr != nil { + os.RemoveAll(dir) + } + }() + + // Toplevel images are just a "root" dir + if parent == "" { + if err := idtools.MkdirAs(path.Join(dir, "root"), 0755, rootUID, rootGID); err != nil { + return err + } + return nil + } + + parentDir := d.dir(parent) + + // Ensure parent exists + if _, err := os.Lstat(parentDir); err != nil { + return err + } + + // If parent has a root, just do a overlay to it + parentRoot := path.Join(parentDir, "root") + + if s, err := os.Lstat(parentRoot); err == nil { + if err := os.Mkdir(path.Join(dir, "upper"), s.Mode()); err != nil { + return err + } + if err := os.Mkdir(path.Join(dir, "work"), 0700); err != nil { + return err + } + if err := idtools.MkdirAs(path.Join(dir, "merged"), 0700, rootUID, rootGID); err != nil { + return err + } + if err := ioutil.WriteFile(path.Join(dir, "lower-id"), []byte(parent), 0666); err != nil { + return err + } + return nil + } + + // Otherwise, copy the upper and the lower-id from the parent + + lowerID, err := ioutil.ReadFile(path.Join(parentDir, "lower-id")) + if err != nil { + return err + } + + if err := ioutil.WriteFile(path.Join(dir, "lower-id"), lowerID, 0666); err != nil { + return err + } + + parentUpperDir := path.Join(parentDir, "upper") + s, err := os.Lstat(parentUpperDir) + if err != nil { + return err + } + + upperDir := path.Join(dir, "upper") + if err := os.Mkdir(upperDir, s.Mode()); err != nil { + return err + } + if err := os.Mkdir(path.Join(dir, "work"), 0700); err != nil { + return err + } + if err := idtools.MkdirAs(path.Join(dir, "merged"), 0700, rootUID, rootGID); err != nil { + return err + } + + return copyDir(parentUpperDir, upperDir, 0) +} + +func (d *Driver) dir(id string) string { + return path.Join(d.home, id) +} + +// Remove cleans the directories that are created for this id. +func (d *Driver) Remove(id string) error { + return os.RemoveAll(d.dir(id)) +} + +// Get creates and mounts the required file system for the given id and returns the mount path. +func (d *Driver) Get(id string, mountLabel string) (string, error) { + id = excludeOverlayIncompatibleChars(id) + // Protect the d.active from concurrent access + d.Lock() + defer d.Unlock() + + mount := d.active[id] + if mount != nil { + mount.count++ + return mount.path, nil + } + + mount = &ActiveMount{count: 1} + + dir := d.dir(id) + if _, err := os.Stat(dir); err != nil { + return "", err + } + + // If id has a root, just return it + rootDir := path.Join(dir, "root") + if _, err := os.Stat(rootDir); err == nil { + mount.path = rootDir + d.active[id] = mount + return mount.path, nil + } + + lowerID, err := ioutil.ReadFile(path.Join(dir, "lower-id")) + if err != nil { + return "", err + } + lowerDir := path.Join(d.dir(string(lowerID)), "root") + upperDir := path.Join(dir, "upper") + workDir := path.Join(dir, "work") + mergedDir := path.Join(dir, "merged") + + opts := fmt.Sprintf("lowerdir=%s,upperdir=%s,workdir=%s", lowerDir, upperDir, workDir) + if err := syscall.Mount("overlay", mergedDir, "overlay", 0, label.FormatMountLabel(opts, mountLabel)); err != nil { + return "", fmt.Errorf("error creating overlay mount to %s: %v", mergedDir, err) + } + // chown "workdir/work" to the remapped root UID/GID. Overlay fs inside a + // user namespace requires this to move a directory from lower to upper. + rootUID, rootGID, err := idtools.GetRootUIDGID(d.uidMaps, d.gidMaps) + if err := os.Chown(path.Join(workDir, "work"), rootUID, rootGID); err != nil { + return "", err + } + mount.path = mergedDir + mount.mounted = true + d.active[id] = mount + + return mount.path, nil +} + +// Put unmounts the mount path created for the give id. +func (d *Driver) Put(id string) error { + id = excludeOverlayIncompatibleChars(id) + // Protect the d.active from concurrent access + d.Lock() + defer d.Unlock() + + mount := d.active[id] + if mount == nil { + logrus.Debugf("Put on a non-mounted device %s", id) + // but it might be still here + if d.Exists(id) { + mergedDir := path.Join(d.dir(id), "merged") + err := syscall.Unmount(mergedDir, 0) + if err != nil { + logrus.Debugf("Failed to unmount %s overlay: %v", id, err) + } + } + return nil + } + + mount.count-- + if mount.count > 0 { + return nil + } + + defer delete(d.active, id) + if mount.mounted { + err := syscall.Unmount(mount.path, 0) + if err != nil { + logrus.Debugf("Failed to unmount %s overlay: %v", id, err) + } + return err + } + return nil +} + +// ApplyDiff applies the new layer on top of the root, if parent does not exist with will return a ErrApplyDiffFallback error. +func (d *Driver) ApplyDiff(id string, parent string, diff archive.Reader) (size int64, err error) { + dir := d.dir(id) + + if parent == "" { + return 0, ErrApplyDiffFallback + } + + parentRootDir := path.Join(d.dir(parent), "root") + if _, err := os.Stat(parentRootDir); err != nil { + return 0, ErrApplyDiffFallback + } + + // We now know there is a parent, and it has a "root" directory containing + // the full root filesystem. We can just hardlink it and apply the + // layer. This relies on two things: + // 1) ApplyDiff is only run once on a clean (no writes to upper layer) container + // 2) ApplyDiff doesn't do any in-place writes to files (would break hardlinks) + // These are all currently true and are not expected to break + + tmpRootDir, err := ioutil.TempDir(dir, "tmproot") + if err != nil { + return 0, err + } + defer func() { + if err != nil { + os.RemoveAll(tmpRootDir) + } else { + os.RemoveAll(path.Join(dir, "upper")) + os.RemoveAll(path.Join(dir, "work")) + os.RemoveAll(path.Join(dir, "merged")) + os.RemoveAll(path.Join(dir, "lower-id")) + } + }() + + if err = copyDir(parentRootDir, tmpRootDir, copyHardlink); err != nil { + return 0, err + } + + options := &archive.TarOptions{UIDMaps: d.uidMaps, GIDMaps: d.gidMaps} + if size, err = chrootarchive.ApplyUncompressedLayer(tmpRootDir, diff, options); err != nil { + return 0, err + } + + rootDir := path.Join(dir, "root") + if err := os.Rename(tmpRootDir, rootDir); err != nil { + return 0, err + } + + return +} + +// Exists checks to see if the id is already mounted. +func (d *Driver) Exists(id string) bool { + id = excludeOverlayIncompatibleChars(id) + _, err := os.Stat(d.dir(id)) + return err == nil +} + +// excludeOverlayIncompatibleChars makes sure the string can be used as a path +// component in overlay. overlay uses `:` as a path separator in the mount(2) +// options so these characters can't be used in the graph folder structure. +func excludeOverlayIncompatibleChars(in string) string { + return strings.Replace(in, ":", "-", -1) +} diff --git a/daemon/graphdriver/overlay/overlay_test.go b/daemon/graphdriver/overlay/overlay_test.go new file mode 100644 index 0000000000..76b6313b6d --- /dev/null +++ b/daemon/graphdriver/overlay/overlay_test.go @@ -0,0 +1,30 @@ +// +build linux + +package overlay + +import ( + "github.com/docker/docker/daemon/graphdriver/graphtest" + "testing" +) + +// This avoids creating a new driver for each test if all tests are run +// Make sure to put new tests between TestOverlaySetup and TestOverlayTeardown +func TestOverlaySetup(t *testing.T) { + graphtest.GetDriver(t, "overlay") +} + +func TestOverlayCreateEmpty(t *testing.T) { + graphtest.DriverTestCreateEmpty(t, "overlay") +} + +func TestOverlayCreateBase(t *testing.T) { + graphtest.DriverTestCreateBase(t, "overlay") +} + +func TestOverlayCreateSnap(t *testing.T) { + graphtest.DriverTestCreateSnap(t, "overlay") +} + +func TestOverlayTeardown(t *testing.T) { + graphtest.PutDriver(t) +} diff --git a/daemon/graphdriver/overlay/overlay_unsupported.go b/daemon/graphdriver/overlay/overlay_unsupported.go new file mode 100644 index 0000000000..3dbb4de44e --- /dev/null +++ b/daemon/graphdriver/overlay/overlay_unsupported.go @@ -0,0 +1,3 @@ +// +build !linux + +package overlay diff --git a/daemon/graphdriver/plugin.go b/daemon/graphdriver/plugin.go new file mode 100644 index 0000000000..e816cd0d84 --- /dev/null +++ b/daemon/graphdriver/plugin.go @@ -0,0 +1,33 @@ +// +build experimental +// +build daemon + +package graphdriver + +import ( + "fmt" + "io" + + "github.com/docker/docker/pkg/plugins" +) + +type pluginClient interface { + // Call calls the specified method with the specified arguments for the plugin. + Call(string, interface{}, interface{}) error + // Stream calls the specified method with the specified arguments for the plugin and returns the response IO stream + Stream(string, interface{}) (io.ReadCloser, error) + // SendFile calls the specified method, and passes through the IO stream + SendFile(string, io.Reader, interface{}) error +} + +func lookupPlugin(name, home string, opts []string) (Driver, error) { + pl, err := plugins.Get(name, "GraphDriver") + if err != nil { + return nil, fmt.Errorf("Error looking up graphdriver plugin %s: %v", name, err) + } + return newPluginDriver(name, home, opts, pl.Client) +} + +func newPluginDriver(name, home string, opts []string, c pluginClient) (Driver, error) { + proxy := &graphDriverProxy{name, c} + return proxy, proxy.Init(home, opts) +} diff --git a/daemon/graphdriver/plugin_unsupported.go b/daemon/graphdriver/plugin_unsupported.go new file mode 100644 index 0000000000..daa7a170e4 --- /dev/null +++ b/daemon/graphdriver/plugin_unsupported.go @@ -0,0 +1,7 @@ +// +build !experimental + +package graphdriver + +func lookupPlugin(name, home string, opts []string) (Driver, error) { + return nil, ErrNotSupported +} diff --git a/daemon/graphdriver/proxy.go b/daemon/graphdriver/proxy.go new file mode 100644 index 0000000000..ff19dcdfa8 --- /dev/null +++ b/daemon/graphdriver/proxy.go @@ -0,0 +1,210 @@ +// +build experimental +// +build daemon + +package graphdriver + +import ( + "errors" + "fmt" + + "github.com/docker/docker/pkg/archive" +) + +type graphDriverProxy struct { + name string + client pluginClient +} + +type graphDriverRequest struct { + ID string `json:",omitempty"` + Parent string `json:",omitempty"` + MountLabel string `json:",omitempty"` +} + +type graphDriverResponse struct { + Err string `json:",omitempty"` + Dir string `json:",omitempty"` + Exists bool `json:",omitempty"` + Status [][2]string `json:",omitempty"` + Changes []archive.Change `json:",omitempty"` + Size int64 `json:",omitempty"` + Metadata map[string]string `json:",omitempty"` +} + +type graphDriverInitRequest struct { + Home string + Opts []string +} + +func (d *graphDriverProxy) Init(home string, opts []string) error { + args := &graphDriverInitRequest{ + Home: home, + Opts: opts, + } + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Init", args, &ret); err != nil { + return err + } + if ret.Err != "" { + return errors.New(ret.Err) + } + return nil +} + +func (d *graphDriverProxy) String() string { + return d.name +} + +func (d *graphDriverProxy) Create(id, parent string) error { + args := &graphDriverRequest{ + ID: id, + Parent: parent, + } + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Create", args, &ret); err != nil { + return err + } + if ret.Err != "" { + return errors.New(ret.Err) + } + return nil +} + +func (d *graphDriverProxy) Remove(id string) error { + args := &graphDriverRequest{ID: id} + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Remove", args, &ret); err != nil { + return err + } + if ret.Err != "" { + return errors.New(ret.Err) + } + return nil +} + +func (d *graphDriverProxy) Get(id, mountLabel string) (string, error) { + args := &graphDriverRequest{ + ID: id, + MountLabel: mountLabel, + } + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Get", args, &ret); err != nil { + return "", err + } + var err error + if ret.Err != "" { + err = errors.New(ret.Err) + } + return ret.Dir, err +} + +func (d *graphDriverProxy) Put(id string) error { + args := &graphDriverRequest{ID: id} + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Put", args, &ret); err != nil { + return err + } + if ret.Err != "" { + return errors.New(ret.Err) + } + return nil +} + +func (d *graphDriverProxy) Exists(id string) bool { + args := &graphDriverRequest{ID: id} + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Exists", args, &ret); err != nil { + return false + } + return ret.Exists +} + +func (d *graphDriverProxy) Status() [][2]string { + args := &graphDriverRequest{} + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Status", args, &ret); err != nil { + return nil + } + return ret.Status +} + +func (d *graphDriverProxy) GetMetadata(id string) (map[string]string, error) { + args := &graphDriverRequest{ + ID: id, + } + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.GetMetadata", args, &ret); err != nil { + return nil, err + } + if ret.Err != "" { + return nil, errors.New(ret.Err) + } + return ret.Metadata, nil +} + +func (d *graphDriverProxy) Cleanup() error { + args := &graphDriverRequest{} + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Cleanup", args, &ret); err != nil { + return nil + } + if ret.Err != "" { + return errors.New(ret.Err) + } + return nil +} + +func (d *graphDriverProxy) Diff(id, parent string) (archive.Archive, error) { + args := &graphDriverRequest{ + ID: id, + Parent: parent, + } + body, err := d.client.Stream("GraphDriver.Diff", args) + if err != nil { + body.Close() + return nil, err + } + return archive.Archive(body), nil +} + +func (d *graphDriverProxy) Changes(id, parent string) ([]archive.Change, error) { + args := &graphDriverRequest{ + ID: id, + Parent: parent, + } + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.Changes", args, &ret); err != nil { + return nil, err + } + if ret.Err != "" { + return nil, errors.New(ret.Err) + } + + return ret.Changes, nil +} + +func (d *graphDriverProxy) ApplyDiff(id, parent string, diff archive.Reader) (int64, error) { + var ret graphDriverResponse + if err := d.client.SendFile(fmt.Sprintf("GraphDriver.ApplyDiff?id=%s&parent=%s", id, parent), diff, &ret); err != nil { + return -1, err + } + if ret.Err != "" { + return -1, errors.New(ret.Err) + } + return ret.Size, nil +} + +func (d *graphDriverProxy) DiffSize(id, parent string) (int64, error) { + args := &graphDriverRequest{ + ID: id, + Parent: parent, + } + var ret graphDriverResponse + if err := d.client.Call("GraphDriver.DiffSize", args, &ret); err != nil { + return -1, err + } + if ret.Err != "" { + return -1, errors.New(ret.Err) + } + return ret.Size, nil +} diff --git a/daemon/graphdriver/vfs/driver.go b/daemon/graphdriver/vfs/driver.go new file mode 100644 index 0000000000..5633de483f --- /dev/null +++ b/daemon/graphdriver/vfs/driver.go @@ -0,0 +1,132 @@ +// +build daemon + +package vfs + +import ( + "fmt" + "os" + "path/filepath" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/idtools" + + "github.com/opencontainers/runc/libcontainer/label" +) + +func init() { + graphdriver.Register("vfs", Init) +} + +// Init returns a new VFS driver. +// This sets the home directory for the driver and returns NaiveDiffDriver. +func Init(home string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + d := &Driver{ + home: home, + uidMaps: uidMaps, + gidMaps: gidMaps, + } + rootUID, rootGID, err := idtools.GetRootUIDGID(uidMaps, gidMaps) + if err != nil { + return nil, err + } + if err := idtools.MkdirAllAs(home, 0700, rootUID, rootGID); err != nil { + return nil, err + } + return graphdriver.NewNaiveDiffDriver(d, uidMaps, gidMaps), nil +} + +// Driver holds information about the driver, home directory of the driver. +// Driver implements graphdriver.ProtoDriver. It uses only basic vfs operations. +// In order to support layering, files are copied from the parent layer into the new layer. There is no copy-on-write support. +// Driver must be wrapped in NaiveDiffDriver to be used as a graphdriver.Driver +type Driver struct { + home string + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +func (d *Driver) String() string { + return "vfs" +} + +// Status is used for implementing the graphdriver.ProtoDriver interface. VFS does not currently have any status information. +func (d *Driver) Status() [][2]string { + return nil +} + +// GetMetadata is used for implementing the graphdriver.ProtoDriver interface. VFS does not currently have any meta data. +func (d *Driver) GetMetadata(id string) (map[string]string, error) { + return nil, nil +} + +// Cleanup is used to implement graphdriver.ProtoDriver. There is no cleanup required for this driver. +func (d *Driver) Cleanup() error { + return nil +} + +// Create prepares the filesystem for the VFS driver and copies the directory for the given id under the parent. +func (d *Driver) Create(id, parent string) error { + dir := d.dir(id) + rootUID, rootGID, err := idtools.GetRootUIDGID(d.uidMaps, d.gidMaps) + if err != nil { + return err + } + if err := idtools.MkdirAllAs(filepath.Dir(dir), 0700, rootUID, rootGID); err != nil { + return err + } + if err := idtools.MkdirAs(dir, 0755, rootUID, rootGID); err != nil { + return err + } + opts := []string{"level:s0"} + if _, mountLabel, err := label.InitLabels(opts); err == nil { + label.SetFileLabel(dir, mountLabel) + } + if parent == "" { + return nil + } + parentDir, err := d.Get(parent, "") + if err != nil { + return fmt.Errorf("%s: %s", parent, err) + } + if err := chrootarchive.CopyWithTar(parentDir, dir); err != nil { + return err + } + return nil +} + +func (d *Driver) dir(id string) string { + return filepath.Join(d.home, "dir", filepath.Base(id)) +} + +// Remove deletes the content from the directory for a given id. +func (d *Driver) Remove(id string) error { + if _, err := os.Stat(d.dir(id)); err != nil { + return err + } + return os.RemoveAll(d.dir(id)) +} + +// Get returns the directory for the given id. +func (d *Driver) Get(id, mountLabel string) (string, error) { + dir := d.dir(id) + if st, err := os.Stat(dir); err != nil { + return "", err + } else if !st.IsDir() { + return "", fmt.Errorf("%s: not a directory", dir) + } + return dir, nil +} + +// Put is a noop for vfs that return nil for the error, since this driver has no runtime resources to clean up. +func (d *Driver) Put(id string) error { + // The vfs driver has no runtime resources (e.g. mounts) + // to clean up, so we don't need anything here + return nil +} + +// Exists checks to see if the directory exists for the given id. +func (d *Driver) Exists(id string) bool { + _, err := os.Stat(d.dir(id)) + return err == nil +} diff --git a/daemon/graphdriver/vfs/driver_unsupported.go b/daemon/graphdriver/vfs/driver_unsupported.go new file mode 100644 index 0000000000..474a4c5c18 --- /dev/null +++ b/daemon/graphdriver/vfs/driver_unsupported.go @@ -0,0 +1,3 @@ +// +build !daemon + +package vfs diff --git a/daemon/graphdriver/vfs/vfs_test.go b/daemon/graphdriver/vfs/vfs_test.go new file mode 100644 index 0000000000..9ecf21dbaa --- /dev/null +++ b/daemon/graphdriver/vfs/vfs_test.go @@ -0,0 +1,37 @@ +// +build linux + +package vfs + +import ( + "testing" + + "github.com/docker/docker/daemon/graphdriver/graphtest" + + "github.com/docker/docker/pkg/reexec" +) + +func init() { + reexec.Init() +} + +// This avoids creating a new driver for each test if all tests are run +// Make sure to put new tests between TestVfsSetup and TestVfsTeardown +func TestVfsSetup(t *testing.T) { + graphtest.GetDriver(t, "vfs") +} + +func TestVfsCreateEmpty(t *testing.T) { + graphtest.DriverTestCreateEmpty(t, "vfs") +} + +func TestVfsCreateBase(t *testing.T) { + graphtest.DriverTestCreateBase(t, "vfs") +} + +func TestVfsCreateSnap(t *testing.T) { + graphtest.DriverTestCreateSnap(t, "vfs") +} + +func TestVfsTeardown(t *testing.T) { + graphtest.PutDriver(t) +} diff --git a/daemon/graphdriver/windows/windows.go b/daemon/graphdriver/windows/windows.go new file mode 100644 index 0000000000..dbd3defd5c --- /dev/null +++ b/daemon/graphdriver/windows/windows.go @@ -0,0 +1,598 @@ +//+build windows + +package windows + +import ( + "crypto/sha512" + "encoding/json" + "fmt" + "io/ioutil" + "os" + "path/filepath" + "runtime" + "strconv" + "strings" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/random" + "github.com/microsoft/hcsshim" +) + +// init registers the windows graph drivers to the register. +func init() { + graphdriver.Register("windowsfilter", InitFilter) + graphdriver.Register("windowsdiff", InitDiff) +} + +const ( + // diffDriver is an hcsshim driver type + diffDriver = iota + // filterDriver is an hcsshim driver type + filterDriver +) + +// CustomImageDescriptor is an image descriptor for use by RestoreCustomImages +type customImageDescriptor struct { + img *image.Image +} + +// ID returns the image ID specified in the image structure. +func (img customImageDescriptor) ID() string { + return img.img.ID +} + +// Parent returns the parent ID - in this case, none +func (img customImageDescriptor) Parent() string { + return "" +} + +// MarshalConfig renders the image structure into JSON. +func (img customImageDescriptor) MarshalConfig() ([]byte, error) { + return json.Marshal(img.img) +} + +// Driver represents a windows graph driver. +type Driver struct { + // info stores the shim driver information + info hcsshim.DriverInfo + // Mutex protects concurrent modification to active + sync.Mutex + // active stores references to the activated layers + active map[string]int +} + +// InitFilter returns a new Windows storage filter driver. +func InitFilter(home string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + logrus.Debugf("WindowsGraphDriver InitFilter at %s", home) + d := &Driver{ + info: hcsshim.DriverInfo{ + HomeDir: home, + Flavour: filterDriver, + }, + active: make(map[string]int), + } + return d, nil +} + +// InitDiff returns a new Windows differencing disk driver. +func InitDiff(home string, options []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + logrus.Debugf("WindowsGraphDriver InitDiff at %s", home) + d := &Driver{ + info: hcsshim.DriverInfo{ + HomeDir: home, + Flavour: diffDriver, + }, + active: make(map[string]int), + } + return d, nil +} + +// String returns the string representation of a driver. +func (d *Driver) String() string { + switch d.info.Flavour { + case diffDriver: + return "windowsdiff" + case filterDriver: + return "windowsfilter" + default: + return "Unknown driver flavour" + } +} + +// Status returns the status of the driver. +func (d *Driver) Status() [][2]string { + return [][2]string{ + {"Windows", ""}, + } +} + +// Exists returns true if the given id is registered with this driver. +func (d *Driver) Exists(id string) bool { + rID, err := d.resolveID(id) + if err != nil { + return false + } + result, err := hcsshim.LayerExists(d.info, rID) + if err != nil { + return false + } + return result +} + +// Create creates a new layer with the given id. +func (d *Driver) Create(id, parent string) error { + rPId, err := d.resolveID(parent) + if err != nil { + return err + } + + parentChain, err := d.getLayerChain(rPId) + if err != nil { + return err + } + + var layerChain []string + + parentIsInit := strings.HasSuffix(rPId, "-init") + + if !parentIsInit && rPId != "" { + parentPath, err := hcsshim.GetLayerMountPath(d.info, rPId) + if err != nil { + return err + } + layerChain = []string{parentPath} + } + + layerChain = append(layerChain, parentChain...) + + if parentIsInit { + if len(layerChain) == 0 { + return fmt.Errorf("Cannot create a read/write layer without a parent layer.") + } + if err := hcsshim.CreateSandboxLayer(d.info, id, layerChain[0], layerChain); err != nil { + return err + } + } else { + if err := hcsshim.CreateLayer(d.info, id, rPId); err != nil { + return err + } + } + + if _, err := os.Lstat(d.dir(parent)); err != nil { + if err2 := hcsshim.DestroyLayer(d.info, id); err2 != nil { + logrus.Warnf("Failed to DestroyLayer %s: %s", id, err2) + } + return fmt.Errorf("Cannot create layer with missing parent %s: %s", parent, err) + } + + if err := d.setLayerChain(id, layerChain); err != nil { + if err2 := hcsshim.DestroyLayer(d.info, id); err2 != nil { + logrus.Warnf("Failed to DestroyLayer %s: %s", id, err2) + } + return err + } + + return nil +} + +// dir returns the absolute path to the layer. +func (d *Driver) dir(id string) string { + return filepath.Join(d.info.HomeDir, filepath.Base(id)) +} + +// Remove unmounts and removes the dir information. +func (d *Driver) Remove(id string) error { + rID, err := d.resolveID(id) + if err != nil { + return err + } + + return hcsshim.DestroyLayer(d.info, rID) +} + +// Get returns the rootfs path for the id. This will mount the dir at it's given path. +func (d *Driver) Get(id, mountLabel string) (string, error) { + logrus.Debugf("WindowsGraphDriver Get() id %s mountLabel %s", id, mountLabel) + var dir string + + d.Lock() + defer d.Unlock() + + rID, err := d.resolveID(id) + if err != nil { + return "", err + } + + // Getting the layer paths must be done outside of the lock. + layerChain, err := d.getLayerChain(rID) + if err != nil { + return "", err + } + + if d.active[rID] == 0 { + if err := hcsshim.ActivateLayer(d.info, rID); err != nil { + return "", err + } + if err := hcsshim.PrepareLayer(d.info, rID, layerChain); err != nil { + if err2 := hcsshim.DeactivateLayer(d.info, rID); err2 != nil { + logrus.Warnf("Failed to Deactivate %s: %s", id, err) + } + return "", err + } + } + + mountPath, err := hcsshim.GetLayerMountPath(d.info, rID) + if err != nil { + if err2 := hcsshim.DeactivateLayer(d.info, rID); err2 != nil { + logrus.Warnf("Failed to Deactivate %s: %s", id, err) + } + return "", err + } + + d.active[rID]++ + + // If the layer has a mount path, use that. Otherwise, use the + // folder path. + if mountPath != "" { + dir = mountPath + } else { + dir = d.dir(id) + } + + return dir, nil +} + +// Put adds a new layer to the driver. +func (d *Driver) Put(id string) error { + logrus.Debugf("WindowsGraphDriver Put() id %s", id) + + rID, err := d.resolveID(id) + if err != nil { + return err + } + + d.Lock() + defer d.Unlock() + + if d.active[rID] > 1 { + d.active[rID]-- + } else if d.active[rID] == 1 { + if err := hcsshim.UnprepareLayer(d.info, rID); err != nil { + return err + } + if err := hcsshim.DeactivateLayer(d.info, rID); err != nil { + return err + } + delete(d.active, rID) + } + + return nil +} + +// Cleanup ensures the information the driver stores is properly removed. +func (d *Driver) Cleanup() error { + return nil +} + +// Diff produces an archive of the changes between the specified +// layer and its parent layer which may be "". +func (d *Driver) Diff(id, parent string) (arch archive.Archive, err error) { + rID, err := d.resolveID(id) + if err != nil { + return + } + + // Getting the layer paths must be done outside of the lock. + layerChain, err := d.getLayerChain(rID) + if err != nil { + return + } + + d.Lock() + + // To support export, a layer must be activated but not prepared. + if d.info.Flavour == filterDriver { + if d.active[rID] == 0 { + if err = hcsshim.ActivateLayer(d.info, rID); err != nil { + d.Unlock() + return + } + defer func() { + if err := hcsshim.DeactivateLayer(d.info, rID); err != nil { + logrus.Warnf("Failed to Deactivate %s: %s", rID, err) + } + }() + } else { + if err = hcsshim.UnprepareLayer(d.info, rID); err != nil { + d.Unlock() + return + } + defer func() { + if err := hcsshim.PrepareLayer(d.info, rID, layerChain); err != nil { + logrus.Warnf("Failed to re-PrepareLayer %s: %s", rID, err) + } + }() + } + } + + d.Unlock() + + return d.exportLayer(rID, layerChain) +} + +// Changes produces a list of changes between the specified layer +// and its parent layer. If parent is "", then all changes will be ADD changes. +func (d *Driver) Changes(id, parent string) ([]archive.Change, error) { + return nil, fmt.Errorf("The Windows graphdriver does not support Changes()") +} + +// ApplyDiff extracts the changeset from the given diff into the +// layer with the specified id and parent, returning the size of the +// new layer in bytes. +func (d *Driver) ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error) { + rPId, err := d.resolveID(parent) + if err != nil { + return + } + + if d.info.Flavour == diffDriver { + start := time.Now().UTC() + logrus.Debugf("WindowsGraphDriver ApplyDiff: Start untar layer") + destination := d.dir(id) + destination = filepath.Dir(destination) + if size, err = chrootarchive.ApplyUncompressedLayer(destination, diff, nil); err != nil { + return + } + logrus.Debugf("WindowsGraphDriver ApplyDiff: Untar time: %vs", time.Now().UTC().Sub(start).Seconds()) + + return + } + + parentChain, err := d.getLayerChain(rPId) + if err != nil { + return + } + parentPath, err := hcsshim.GetLayerMountPath(d.info, rPId) + if err != nil { + return + } + layerChain := []string{parentPath} + layerChain = append(layerChain, parentChain...) + + if size, err = d.importLayer(id, diff, layerChain); err != nil { + return + } + + if err = d.setLayerChain(id, layerChain); err != nil { + return + } + + return +} + +// DiffSize calculates the changes between the specified layer +// and its parent and returns the size in bytes of the changes +// relative to its base filesystem directory. +func (d *Driver) DiffSize(id, parent string) (size int64, err error) { + rPId, err := d.resolveID(parent) + if err != nil { + return + } + + changes, err := d.Changes(id, rPId) + if err != nil { + return + } + + layerFs, err := d.Get(id, "") + if err != nil { + return + } + defer d.Put(id) + + return archive.ChangesSize(layerFs, changes), nil +} + +// RestoreCustomImages adds any auto-detected OS specific images to the tag and graph store. +func (d *Driver) RestoreCustomImages(tagger graphdriver.Tagger, recorder graphdriver.Recorder) (imageIDs []string, err error) { + strData, err := hcsshim.GetSharedBaseImages() + if err != nil { + return nil, fmt.Errorf("Failed to restore base images: %s", err) + } + + type customImageInfo struct { + Name string + Version string + Path string + Size int64 + CreatedTime time.Time + } + type customImageInfoList struct { + Images []customImageInfo + } + + var infoData customImageInfoList + + if err = json.Unmarshal([]byte(strData), &infoData); err != nil { + err = fmt.Errorf("JSON unmarshal returned error=%s", err) + logrus.Error(err) + return nil, err + } + + for _, imageData := range infoData.Images { + _, folderName := filepath.Split(imageData.Path) + + // Use crypto hash of the foldername to generate a docker style id. + h := sha512.Sum384([]byte(folderName)) + id := fmt.Sprintf("%x", h[:32]) + + if !recorder.Exists(id) { + // Register the image. + img := &image.Image{ + ID: id, + Created: imageData.CreatedTime, + DockerVersion: dockerversion.VERSION, + Architecture: runtime.GOARCH, + OS: runtime.GOOS, + Size: imageData.Size, + } + + if err := recorder.Register(customImageDescriptor{img}, nil); err != nil { + return nil, err + } + + // Create tags for the new image. + if err := tagger.Tag(strings.ToLower(imageData.Name), imageData.Version, img.ID, true); err != nil { + return nil, err + } + + // Create the alternate ID file. + if err := d.setID(img.ID, folderName); err != nil { + return nil, err + } + + imageIDs = append(imageIDs, img.ID) + } + } + + return imageIDs, nil +} + +// GetMetadata returns custom driver information. +func (d *Driver) GetMetadata(id string) (map[string]string, error) { + m := make(map[string]string) + m["dir"] = d.dir(id) + return m, nil +} + +// exportLayer generates an archive from a layer based on the given ID. +func (d *Driver) exportLayer(id string, parentLayerPaths []string) (arch archive.Archive, err error) { + layerFolder := d.dir(id) + + tempFolder := layerFolder + "-" + strconv.FormatUint(uint64(random.Rand.Uint32()), 10) + if err = os.MkdirAll(tempFolder, 0755); err != nil { + logrus.Errorf("Could not create %s %s", tempFolder, err) + return + } + defer func() { + if err != nil { + _, folderName := filepath.Split(tempFolder) + if err2 := hcsshim.DestroyLayer(d.info, folderName); err2 != nil { + logrus.Warnf("Couldn't clean-up tempFolder: %s %s", tempFolder, err2) + } + } + }() + + if err = hcsshim.ExportLayer(d.info, id, tempFolder, parentLayerPaths); err != nil { + return + } + + archive, err := archive.Tar(tempFolder, archive.Uncompressed) + if err != nil { + return + } + return ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + d.Put(id) + _, folderName := filepath.Split(tempFolder) + if err2 := hcsshim.DestroyLayer(d.info, folderName); err2 != nil { + logrus.Warnf("Couldn't clean-up tempFolder: %s %s", tempFolder, err2) + } + return err + }), nil + +} + +// importLayer adds a new layer to the tag and graph store based on the given data. +func (d *Driver) importLayer(id string, layerData archive.Reader, parentLayerPaths []string) (size int64, err error) { + layerFolder := d.dir(id) + + tempFolder := layerFolder + "-" + strconv.FormatUint(uint64(random.Rand.Uint32()), 10) + if err = os.MkdirAll(tempFolder, 0755); err != nil { + logrus.Errorf("Could not create %s %s", tempFolder, err) + return + } + defer func() { + _, folderName := filepath.Split(tempFolder) + if err2 := hcsshim.DestroyLayer(d.info, folderName); err2 != nil { + logrus.Warnf("Couldn't clean-up tempFolder: %s %s", tempFolder, err2) + } + }() + + start := time.Now().UTC() + logrus.Debugf("Start untar layer") + if size, err = chrootarchive.ApplyLayer(tempFolder, layerData); err != nil { + return + } + logrus.Debugf("Untar time: %vs", time.Now().UTC().Sub(start).Seconds()) + + if err = hcsshim.ImportLayer(d.info, id, tempFolder, parentLayerPaths); err != nil { + return + } + + return +} + +// resolveID computes the layerID information based on the given id. +func (d *Driver) resolveID(id string) (string, error) { + content, err := ioutil.ReadFile(filepath.Join(d.dir(id), "layerID")) + if os.IsNotExist(err) { + return id, nil + } else if err != nil { + return "", err + } + return string(content), nil +} + +// setID stores the layerId in disk. +func (d *Driver) setID(id, altID string) error { + err := ioutil.WriteFile(filepath.Join(d.dir(id), "layerId"), []byte(altID), 0600) + if err != nil { + return err + } + return nil +} + +// getLayerChain returns the layer chain information. +func (d *Driver) getLayerChain(id string) ([]string, error) { + jPath := filepath.Join(d.dir(id), "layerchain.json") + content, err := ioutil.ReadFile(jPath) + if os.IsNotExist(err) { + return nil, nil + } else if err != nil { + return nil, fmt.Errorf("Unable to read layerchain file - %s", err) + } + + var layerChain []string + err = json.Unmarshal(content, &layerChain) + if err != nil { + return nil, fmt.Errorf("Failed to unmarshall layerchain json - %s", err) + } + + return layerChain, nil +} + +// setLayerChain stores the layer chain information in disk. +func (d *Driver) setLayerChain(id string, chain []string) error { + content, err := json.Marshal(&chain) + if err != nil { + return fmt.Errorf("Failed to marshall layerchain json - %s", err) + } + + jPath := filepath.Join(d.dir(id), "layerchain.json") + err = ioutil.WriteFile(jPath, content, 0600) + if err != nil { + return fmt.Errorf("Unable to write layerchain file - %s", err) + } + + return nil +} diff --git a/daemon/graphdriver/zfs/MAINTAINERS b/daemon/graphdriver/zfs/MAINTAINERS new file mode 100644 index 0000000000..9c270c541f --- /dev/null +++ b/daemon/graphdriver/zfs/MAINTAINERS @@ -0,0 +1,2 @@ +Jörg Thalheim (@Mic92) +Arthur Gautier (@baloose) diff --git a/daemon/graphdriver/zfs/zfs.go b/daemon/graphdriver/zfs/zfs.go new file mode 100644 index 0000000000..ac10680e6d --- /dev/null +++ b/daemon/graphdriver/zfs/zfs.go @@ -0,0 +1,333 @@ +// +build linux freebsd + +package zfs + +import ( + "fmt" + "os" + "os/exec" + "path" + "strconv" + "strings" + "sync" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/parsers" + zfs "github.com/mistifyio/go-zfs" + "github.com/opencontainers/runc/libcontainer/label" +) + +type zfsOptions struct { + fsName string + mountPath string +} + +func init() { + graphdriver.Register("zfs", Init) +} + +// Logger returns a zfs logger implmentation. +type Logger struct{} + +// Log wraps log message from ZFS driver with a prefix '[zfs]'. +func (*Logger) Log(cmd []string) { + logrus.Debugf("[zfs] %s", strings.Join(cmd, " ")) +} + +// Init returns a new ZFS driver. +// It takes base mount path and a array of options which are represented as key value pairs. +// Each option is in the for key=value. 'zfs.fsname' is expected to be a valid key in the options. +func Init(base string, opt []string, uidMaps, gidMaps []idtools.IDMap) (graphdriver.Driver, error) { + var err error + + if _, err := exec.LookPath("zfs"); err != nil { + logrus.Debugf("[zfs] zfs command is not available: %v", err) + return nil, graphdriver.ErrPrerequisites + } + + file, err := os.OpenFile("/dev/zfs", os.O_RDWR, 600) + if err != nil { + logrus.Debugf("[zfs] cannot open /dev/zfs: %v", err) + return nil, graphdriver.ErrPrerequisites + } + defer file.Close() + + options, err := parseOptions(opt) + if err != nil { + return nil, err + } + options.mountPath = base + + rootdir := path.Dir(base) + + if options.fsName == "" { + err = checkRootdirFs(rootdir) + if err != nil { + return nil, err + } + } + + if options.fsName == "" { + options.fsName, err = lookupZfsDataset(rootdir) + if err != nil { + return nil, err + } + } + + zfs.SetLogger(new(Logger)) + + filesystems, err := zfs.Filesystems(options.fsName) + if err != nil { + return nil, fmt.Errorf("Cannot find root filesystem %s: %v", options.fsName, err) + } + + filesystemsCache := make(map[string]bool, len(filesystems)) + var rootDataset *zfs.Dataset + for _, fs := range filesystems { + if fs.Name == options.fsName { + rootDataset = fs + } + filesystemsCache[fs.Name] = true + } + + if rootDataset == nil { + return nil, fmt.Errorf("BUG: zfs get all -t filesystem -rHp '%s' should contain '%s'", options.fsName, options.fsName) + } + + d := &Driver{ + dataset: rootDataset, + options: options, + filesystemsCache: filesystemsCache, + uidMaps: uidMaps, + gidMaps: gidMaps, + } + return graphdriver.NewNaiveDiffDriver(d, uidMaps, gidMaps), nil +} + +func parseOptions(opt []string) (zfsOptions, error) { + var options zfsOptions + options.fsName = "" + for _, option := range opt { + key, val, err := parsers.ParseKeyValueOpt(option) + if err != nil { + return options, err + } + key = strings.ToLower(key) + switch key { + case "zfs.fsname": + options.fsName = val + default: + return options, fmt.Errorf("Unknown option %s", key) + } + } + return options, nil +} + +func lookupZfsDataset(rootdir string) (string, error) { + var stat syscall.Stat_t + if err := syscall.Stat(rootdir, &stat); err != nil { + return "", fmt.Errorf("Failed to access '%s': %s", rootdir, err) + } + wantedDev := stat.Dev + + mounts, err := mount.GetMounts() + if err != nil { + return "", err + } + for _, m := range mounts { + if err := syscall.Stat(m.Mountpoint, &stat); err != nil { + logrus.Debugf("[zfs] failed to stat '%s' while scanning for zfs mount: %v", m.Mountpoint, err) + continue // may fail on fuse file systems + } + + if stat.Dev == wantedDev && m.Fstype == "zfs" { + return m.Source, nil + } + } + + return "", fmt.Errorf("Failed to find zfs dataset mounted on '%s' in /proc/mounts", rootdir) +} + +// Driver holds information about the driver, such as zfs dataset, options and cache. +type Driver struct { + dataset *zfs.Dataset + options zfsOptions + sync.Mutex // protects filesystem cache against concurrent access + filesystemsCache map[string]bool + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap +} + +func (d *Driver) String() string { + return "zfs" +} + +// Cleanup is used to implement graphdriver.ProtoDriver. There is no cleanup required for this driver. +func (d *Driver) Cleanup() error { + return nil +} + +// Status returns information about the ZFS filesystem. It returns a two dimensional array of information +// such as pool name, dataset name, disk usage, parent quota and compression used. +// Currently it return 'Zpool', 'Zpool Health', 'Parent Dataset', 'Space Used By Parent', +// 'Space Available', 'Parent Quota' and 'Compression'. +func (d *Driver) Status() [][2]string { + parts := strings.Split(d.dataset.Name, "/") + pool, err := zfs.GetZpool(parts[0]) + + var poolName, poolHealth string + if err == nil { + poolName = pool.Name + poolHealth = pool.Health + } else { + poolName = fmt.Sprintf("error while getting pool information %v", err) + poolHealth = "not available" + } + + quota := "no" + if d.dataset.Quota != 0 { + quota = strconv.FormatUint(d.dataset.Quota, 10) + } + + return [][2]string{ + {"Zpool", poolName}, + {"Zpool Health", poolHealth}, + {"Parent Dataset", d.dataset.Name}, + {"Space Used By Parent", strconv.FormatUint(d.dataset.Used, 10)}, + {"Space Available", strconv.FormatUint(d.dataset.Avail, 10)}, + {"Parent Quota", quota}, + {"Compression", d.dataset.Compression}, + } +} + +// GetMetadata returns image/container metadata related to graph driver +func (d *Driver) GetMetadata(id string) (map[string]string, error) { + return nil, nil +} + +func (d *Driver) cloneFilesystem(name, parentName string) error { + snapshotName := fmt.Sprintf("%d", time.Now().Nanosecond()) + parentDataset := zfs.Dataset{Name: parentName} + snapshot, err := parentDataset.Snapshot(snapshotName /*recursive */, false) + if err != nil { + return err + } + + _, err = snapshot.Clone(name, map[string]string{"mountpoint": "legacy"}) + if err == nil { + d.Lock() + d.filesystemsCache[name] = true + d.Unlock() + } + + if err != nil { + snapshot.Destroy(zfs.DestroyDeferDeletion) + return err + } + return snapshot.Destroy(zfs.DestroyDeferDeletion) +} + +func (d *Driver) zfsPath(id string) string { + return d.options.fsName + "/" + id +} + +func (d *Driver) mountPath(id string) string { + return path.Join(d.options.mountPath, "graph", getMountpoint(id)) +} + +// Create prepares the dataset and filesystem for the ZFS driver for the given id under the parent. +func (d *Driver) Create(id string, parent string) error { + err := d.create(id, parent) + if err == nil { + return nil + } + if zfsError, ok := err.(*zfs.Error); ok { + if !strings.HasSuffix(zfsError.Stderr, "dataset already exists\n") { + return err + } + // aborted build -> cleanup + } else { + return err + } + + dataset := zfs.Dataset{Name: d.zfsPath(id)} + if err := dataset.Destroy(zfs.DestroyRecursiveClones); err != nil { + return err + } + + // retry + return d.create(id, parent) +} + +func (d *Driver) create(id, parent string) error { + name := d.zfsPath(id) + if parent == "" { + mountoptions := map[string]string{"mountpoint": "legacy"} + fs, err := zfs.CreateFilesystem(name, mountoptions) + if err == nil { + d.Lock() + d.filesystemsCache[fs.Name] = true + d.Unlock() + } + return err + } + return d.cloneFilesystem(name, d.zfsPath(parent)) +} + +// Remove deletes the dataset, filesystem and the cache for the given id. +func (d *Driver) Remove(id string) error { + name := d.zfsPath(id) + dataset := zfs.Dataset{Name: name} + err := dataset.Destroy(zfs.DestroyRecursive) + if err == nil { + d.Lock() + delete(d.filesystemsCache, name) + d.Unlock() + } + return err +} + +// Get returns the mountpoint for the given id after creating the target directories if necessary. +func (d *Driver) Get(id, mountLabel string) (string, error) { + mountpoint := d.mountPath(id) + filesystem := d.zfsPath(id) + options := label.FormatMountLabel("", mountLabel) + logrus.Debugf(`[zfs] mount("%s", "%s", "%s")`, filesystem, mountpoint, options) + + rootUID, rootGID, err := idtools.GetRootUIDGID(d.uidMaps, d.gidMaps) + if err != nil { + return "", err + } + // Create the target directories if they don't exist + if err := idtools.MkdirAllAs(mountpoint, 0755, rootUID, rootGID); err != nil { + return "", err + } + + err = mount.Mount(filesystem, mountpoint, "zfs", options) + if err != nil { + return "", fmt.Errorf("error creating zfs mount of %s to %s: %v", filesystem, mountpoint, err) + } + + return mountpoint, nil +} + +// Put removes the existing mountpoint for the given id if it exists. +func (d *Driver) Put(id string) error { + mountpoint := d.mountPath(id) + logrus.Debugf(`[zfs] unmount("%s")`, mountpoint) + + if err := mount.Unmount(mountpoint); err != nil { + return fmt.Errorf("error unmounting to %s: %v", mountpoint, err) + } + return nil +} + +// Exists checks to see if the cache entry exists for the given id. +func (d *Driver) Exists(id string) bool { + return d.filesystemsCache[d.zfsPath(id)] == true +} diff --git a/daemon/graphdriver/zfs/zfs_freebsd.go b/daemon/graphdriver/zfs/zfs_freebsd.go new file mode 100644 index 0000000000..1c05fa794c --- /dev/null +++ b/daemon/graphdriver/zfs/zfs_freebsd.go @@ -0,0 +1,38 @@ +package zfs + +import ( + "fmt" + "strings" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/graphdriver" +) + +func checkRootdirFs(rootdir string) error { + var buf syscall.Statfs_t + if err := syscall.Statfs(rootdir, &buf); err != nil { + return fmt.Errorf("Failed to access '%s': %s", rootdir, err) + } + + // on FreeBSD buf.Fstypename contains ['z', 'f', 's', 0 ... ] + if (buf.Fstypename[0] != 122) || (buf.Fstypename[1] != 102) || (buf.Fstypename[2] != 115) || (buf.Fstypename[3] != 0) { + logrus.Debugf("[zfs] no zfs dataset found for rootdir '%s'", rootdir) + return graphdriver.ErrPrerequisites + } + + return nil +} + +func getMountpoint(id string) string { + maxlen := 12 + + // we need to preserve filesystem suffix + suffix := strings.SplitN(id, "-", 2) + + if len(suffix) > 1 { + return id[:maxlen] + "-" + suffix[1] + } + + return id[:maxlen] +} diff --git a/daemon/graphdriver/zfs/zfs_linux.go b/daemon/graphdriver/zfs/zfs_linux.go new file mode 100644 index 0000000000..52ed516049 --- /dev/null +++ b/daemon/graphdriver/zfs/zfs_linux.go @@ -0,0 +1,27 @@ +package zfs + +import ( + "fmt" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/graphdriver" +) + +func checkRootdirFs(rootdir string) error { + var buf syscall.Statfs_t + if err := syscall.Statfs(rootdir, &buf); err != nil { + return fmt.Errorf("Failed to access '%s': %s", rootdir, err) + } + + if graphdriver.FsMagic(buf.Type) != graphdriver.FsMagicZfs { + logrus.Debugf("[zfs] no zfs dataset found for rootdir '%s'", rootdir) + return graphdriver.ErrPrerequisites + } + + return nil +} + +func getMountpoint(id string) string { + return id +} diff --git a/daemon/graphdriver/zfs/zfs_test.go b/daemon/graphdriver/zfs/zfs_test.go new file mode 100644 index 0000000000..c20eb986aa --- /dev/null +++ b/daemon/graphdriver/zfs/zfs_test.go @@ -0,0 +1,30 @@ +// +build linux + +package zfs + +import ( + "github.com/docker/docker/daemon/graphdriver/graphtest" + "testing" +) + +// This avoids creating a new driver for each test if all tests are run +// Make sure to put new tests between TestZfsSetup and TestZfsTeardown +func TestZfsSetup(t *testing.T) { + graphtest.GetDriver(t, "zfs") +} + +func TestZfsCreateEmpty(t *testing.T) { + graphtest.DriverTestCreateEmpty(t, "zfs") +} + +func TestZfsCreateBase(t *testing.T) { + graphtest.DriverTestCreateBase(t, "zfs") +} + +func TestZfsCreateSnap(t *testing.T) { + graphtest.DriverTestCreateSnap(t, "zfs") +} + +func TestZfsTeardown(t *testing.T) { + graphtest.PutDriver(t) +} diff --git a/daemon/graphdriver/zfs/zfs_unsupported.go b/daemon/graphdriver/zfs/zfs_unsupported.go new file mode 100644 index 0000000000..643b169bc5 --- /dev/null +++ b/daemon/graphdriver/zfs/zfs_unsupported.go @@ -0,0 +1,11 @@ +// +build !linux,!freebsd + +package zfs + +func checkRootdirFs(rootdir string) error { + return nil +} + +func getMountpoint(id string) string { + return id +} diff --git a/daemon/history.go b/daemon/history.go new file mode 100644 index 0000000000..3fc10da036 --- /dev/null +++ b/daemon/history.go @@ -0,0 +1,32 @@ +package daemon + +import ( + "sort" +) + +// History is a convenience type for storing a list of containers, +// ordered by creation date. +type History []*Container + +func (history *History) Len() int { + return len(*history) +} + +func (history *History) Less(i, j int) bool { + containers := *history + return containers[j].Created.Before(containers[i].Created) +} + +func (history *History) Swap(i, j int) { + containers := *history + containers[i], containers[j] = containers[j], containers[i] +} + +// Add the given container to history. +func (history *History) Add(container *Container) { + *history = append(*history, container) +} + +func (history *History) sort() { + sort.Sort(history) +} diff --git a/daemon/image_delete.go b/daemon/image_delete.go new file mode 100644 index 0000000000..3bcf023b42 --- /dev/null +++ b/daemon/image_delete.go @@ -0,0 +1,346 @@ +package daemon + +import ( + "fmt" + "strings" + + "github.com/docker/docker/api/types" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/utils" +) + +// ImageDelete deletes the image referenced by the given imageRef from this +// daemon. The given imageRef can be an image ID, ID prefix, or a repository +// reference (with an optional tag or digest, defaulting to the tag name +// "latest"). There is differing behavior depending on whether the given +// imageRef is a repository reference or not. +// +// If the given imageRef is a repository reference then that repository +// reference will be removed. However, if there exists any containers which +// were created using the same image reference then the repository reference +// cannot be removed unless either there are other repository references to the +// same image or force is true. Following removal of the repository reference, +// the referenced image itself will attempt to be deleted as described below +// but quietly, meaning any image delete conflicts will cause the image to not +// be deleted and the conflict will not be reported. +// +// There may be conflicts preventing deletion of an image and these conflicts +// are divided into two categories grouped by their severity: +// +// Hard Conflict: +// - a pull or build using the image. +// - any descendent image. +// - any running container using the image. +// +// Soft Conflict: +// - any stopped container using the image. +// - any repository tag or digest references to the image. +// +// The image cannot be removed if there are any hard conflicts and can be +// removed if there are soft conflicts only if force is true. +// +// If prune is true, ancestor images will each attempt to be deleted quietly, +// meaning any delete conflicts will cause the image to not be deleted and the +// conflict will not be reported. +// +// FIXME: remove ImageDelete's dependency on Daemon, then move to the graph +// package. This would require that we no longer need the daemon to determine +// whether images are being used by a stopped or running container. +func (daemon *Daemon) ImageDelete(imageRef string, force, prune bool) ([]types.ImageDelete, error) { + records := []types.ImageDelete{} + + img, err := daemon.repositories.LookupImage(imageRef) + if err != nil { + return nil, err + } + + var removedRepositoryRef bool + if !isImageIDPrefix(img.ID, imageRef) { + // A repository reference was given and should be removed + // first. We can only remove this reference if either force is + // true, there are multiple repository references to this + // image, or there are no containers using the given reference. + if !(force || daemon.imageHasMultipleRepositoryReferences(img.ID)) { + if container := daemon.getContainerUsingImage(img.ID); container != nil { + // If we removed the repository reference then + // this image would remain "dangling" and since + // we really want to avoid that the client must + // explicitly force its removal. + return nil, derr.ErrorCodeImgDelUsed.WithArgs(imageRef, stringid.TruncateID(container.ID), stringid.TruncateID(img.ID)) + } + } + + parsedRef, err := daemon.removeImageRef(imageRef) + if err != nil { + return nil, err + } + + untaggedRecord := types.ImageDelete{Untagged: parsedRef} + + daemon.EventsService.Log("untag", img.ID, "") + records = append(records, untaggedRecord) + + // If has remaining references then untag finishes the remove + if daemon.repositories.HasReferences(img) { + return records, nil + } + + removedRepositoryRef = true + } else { + // If an ID reference was given AND there is exactly one + // repository reference to the image then we will want to + // remove that reference. + // FIXME: Is this the behavior we want? + repoRefs := daemon.repositories.ByID()[img.ID] + if len(repoRefs) == 1 { + parsedRef, err := daemon.removeImageRef(repoRefs[0]) + if err != nil { + return nil, err + } + + untaggedRecord := types.ImageDelete{Untagged: parsedRef} + + daemon.EventsService.Log("untag", img.ID, "") + records = append(records, untaggedRecord) + } + } + + return records, daemon.imageDeleteHelper(img, &records, force, prune, removedRepositoryRef) +} + +// isImageIDPrefix returns whether the given possiblePrefix is a prefix of the +// given imageID. +func isImageIDPrefix(imageID, possiblePrefix string) bool { + return strings.HasPrefix(imageID, possiblePrefix) +} + +// imageHasMultipleRepositoryReferences returns whether there are multiple +// repository references to the given imageID. +func (daemon *Daemon) imageHasMultipleRepositoryReferences(imageID string) bool { + return len(daemon.repositories.ByID()[imageID]) > 1 +} + +// getContainerUsingImage returns a container that was created using the given +// imageID. Returns nil if there is no such container. +func (daemon *Daemon) getContainerUsingImage(imageID string) *Container { + for _, container := range daemon.List() { + if container.ImageID == imageID { + return container + } + } + + return nil +} + +// removeImageRef attempts to parse and remove the given image reference from +// this daemon's store of repository tag/digest references. The given +// repositoryRef must not be an image ID but a repository name followed by an +// optional tag or digest reference. If tag or digest is omitted, the default +// tag is used. Returns the resolved image reference and an error. +func (daemon *Daemon) removeImageRef(repositoryRef string) (string, error) { + repository, ref := parsers.ParseRepositoryTag(repositoryRef) + if ref == "" { + ref = tags.DefaultTag + } + + // Ignore the boolean value returned, as far as we're concerned, this + // is an idempotent operation and it's okay if the reference didn't + // exist in the first place. + _, err := daemon.repositories.Delete(repository, ref) + + return utils.ImageReference(repository, ref), err +} + +// removeAllReferencesToImageID attempts to remove every reference to the given +// imgID from this daemon's store of repository tag/digest references. Returns +// on the first encountered error. Removed references are logged to this +// daemon's event service. An "Untagged" types.ImageDelete is added to the +// given list of records. +func (daemon *Daemon) removeAllReferencesToImageID(imgID string, records *[]types.ImageDelete) error { + imageRefs := daemon.repositories.ByID()[imgID] + + for _, imageRef := range imageRefs { + parsedRef, err := daemon.removeImageRef(imageRef) + if err != nil { + return err + } + + untaggedRecord := types.ImageDelete{Untagged: parsedRef} + + daemon.EventsService.Log("untag", imgID, "") + *records = append(*records, untaggedRecord) + } + + return nil +} + +// ImageDeleteConflict holds a soft or hard conflict and an associated error. +// Implements the error interface. +type imageDeleteConflict struct { + hard bool + imgID string + message string +} + +func (idc *imageDeleteConflict) Error() string { + var forceMsg string + if idc.hard { + forceMsg = "cannot be forced" + } else { + forceMsg = "must be forced" + } + + return fmt.Sprintf("conflict: unable to delete %s (%s) - %s", stringid.TruncateID(idc.imgID), forceMsg, idc.message) +} + +// imageDeleteHelper attempts to delete the given image from this daemon. If +// the image has any hard delete conflicts (child images or running containers +// using the image) then it cannot be deleted. If the image has any soft delete +// conflicts (any tags/digests referencing the image or any stopped container +// using the image) then it can only be deleted if force is true. If the delete +// succeeds and prune is true, the parent images are also deleted if they do +// not have any soft or hard delete conflicts themselves. Any deleted images +// and untagged references are appended to the given records. If any error or +// conflict is encountered, it will be returned immediately without deleting +// the image. If quiet is true, any encountered conflicts will be ignored and +// the function will return nil immediately without deleting the image. +func (daemon *Daemon) imageDeleteHelper(img *image.Image, records *[]types.ImageDelete, force, prune, quiet bool) error { + // First, determine if this image has any conflicts. Ignore soft conflicts + // if force is true. + if conflict := daemon.checkImageDeleteConflict(img, force); conflict != nil { + if quiet && !daemon.imageIsDangling(img) { + // Ignore conflicts UNLESS the image is "dangling" in + // which case we want the user to know. + return nil + } + + // There was a conflict and it's either a hard conflict OR we are not + // forcing deletion on soft conflicts. + return conflict + } + + // Delete all repository tag/digest references to this image. + if err := daemon.removeAllReferencesToImageID(img.ID, records); err != nil { + return err + } + + if err := daemon.Graph().Delete(img.ID); err != nil { + return err + } + + daemon.EventsService.Log("delete", img.ID, "") + *records = append(*records, types.ImageDelete{Deleted: img.ID}) + + if !prune || img.Parent == "" { + return nil + } + + // We need to prune the parent image. This means delete it if there are + // no tags/digests referencing it and there are no containers using it ( + // either running or stopped). + parentImg, err := daemon.Graph().Get(img.Parent) + if err != nil { + return derr.ErrorCodeImgNoParent.WithArgs(err) + } + + // Do not force prunings, but do so quietly (stopping on any encountered + // conflicts). + return daemon.imageDeleteHelper(parentImg, records, false, true, true) +} + +// checkImageDeleteConflict determines whether there are any conflicts +// preventing deletion of the given image from this daemon. A hard conflict is +// any image which has the given image as a parent or any running container +// using the image. A soft conflict is any tags/digest referencing the given +// image or any stopped container using the image. If ignoreSoftConflicts is +// true, this function will not check for soft conflict conditions. +func (daemon *Daemon) checkImageDeleteConflict(img *image.Image, ignoreSoftConflicts bool) *imageDeleteConflict { + // Check for hard conflicts first. + if conflict := daemon.checkImageDeleteHardConflict(img); conflict != nil { + return conflict + } + + // Then check for soft conflicts. + if ignoreSoftConflicts { + // Don't bother checking for soft conflicts. + return nil + } + + return daemon.checkImageDeleteSoftConflict(img) +} + +func (daemon *Daemon) checkImageDeleteHardConflict(img *image.Image) *imageDeleteConflict { + // Check if the image ID is being used by a pull or build. + if daemon.Graph().IsHeld(img.ID) { + return &imageDeleteConflict{ + hard: true, + imgID: img.ID, + message: "image is held by an ongoing pull or build", + } + } + + // Check if the image has any descendent images. + if daemon.Graph().HasChildren(img.ID) { + return &imageDeleteConflict{ + hard: true, + imgID: img.ID, + message: "image has dependent child images", + } + } + + // Check if any running container is using the image. + for _, container := range daemon.List() { + if !container.IsRunning() { + // Skip this until we check for soft conflicts later. + continue + } + + if container.ImageID == img.ID { + return &imageDeleteConflict{ + imgID: img.ID, + hard: true, + message: fmt.Sprintf("image is being used by running container %s", stringid.TruncateID(container.ID)), + } + } + } + + return nil +} + +func (daemon *Daemon) checkImageDeleteSoftConflict(img *image.Image) *imageDeleteConflict { + // Check if any repository tags/digest reference this image. + if daemon.repositories.HasReferences(img) { + return &imageDeleteConflict{ + imgID: img.ID, + message: "image is referenced in one or more repositories", + } + } + + // Check if any stopped containers reference this image. + for _, container := range daemon.List() { + if container.IsRunning() { + // Skip this as it was checked above in hard conflict conditions. + continue + } + + if container.ImageID == img.ID { + return &imageDeleteConflict{ + imgID: img.ID, + message: fmt.Sprintf("image is being used by stopped container %s", stringid.TruncateID(container.ID)), + } + } + } + + return nil +} + +// imageIsDangling returns whether the given image is "dangling" which means +// that there are no repository references to the given image and it has no +// child images. +func (daemon *Daemon) imageIsDangling(img *image.Image) bool { + return !(daemon.repositories.HasReferences(img) || daemon.Graph().HasChildren(img.ID)) +} diff --git a/daemon/info.go b/daemon/info.go new file mode 100644 index 0000000000..f977f69700 --- /dev/null +++ b/daemon/info.go @@ -0,0 +1,124 @@ +package daemon + +import ( + "os" + "runtime" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/parsers/kernel" + "github.com/docker/docker/pkg/parsers/operatingsystem" + "github.com/docker/docker/pkg/sysinfo" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" +) + +// SystemInfo returns information about the host server the daemon is running on. +func (daemon *Daemon) SystemInfo() (*types.Info, error) { + images := daemon.Graph().Map() + var imgcount int + if images == nil { + imgcount = 0 + } else { + imgcount = len(images) + } + kernelVersion := "" + if kv, err := kernel.GetKernelVersion(); err == nil { + kernelVersion = kv.String() + } + + operatingSystem := "" + if s, err := operatingsystem.GetOperatingSystem(); err == nil { + operatingSystem = s + } + + // Don't do containerized check on Windows + if runtime.GOOS != "windows" { + if inContainer, err := operatingsystem.IsContainerized(); err != nil { + logrus.Errorf("Could not determine if daemon is containerized: %v", err) + operatingSystem += " (error determining if containerized)" + } else if inContainer { + operatingSystem += " (containerized)" + } + } + + meminfo, err := system.ReadMemInfo() + if err != nil { + logrus.Errorf("Could not read system memory info: %v", err) + } + + // if we still have the original dockerinit binary from before + // we copied it locally, let's return the path to that, since + // that's more intuitive (the copied path is trivial to derive + // by hand given VERSION) + initPath := utils.DockerInitPath("") + if initPath == "" { + // if that fails, we'll just return the path from the daemon + initPath = daemon.systemInitPath() + } + + sysInfo := sysinfo.New(true) + + v := &types.Info{ + ID: daemon.ID, + Containers: len(daemon.List()), + Images: imgcount, + Driver: daemon.GraphDriver().String(), + DriverStatus: daemon.GraphDriver().Status(), + IPv4Forwarding: !sysInfo.IPv4ForwardingDisabled, + BridgeNfIptables: !sysInfo.BridgeNfCallIptablesDisabled, + BridgeNfIP6tables: !sysInfo.BridgeNfCallIP6tablesDisabled, + Debug: os.Getenv("DEBUG") != "", + NFd: fileutils.GetTotalUsedFds(), + NGoroutines: runtime.NumGoroutine(), + SystemTime: time.Now().Format(time.RFC3339Nano), + ExecutionDriver: daemon.ExecutionDriver().Name(), + LoggingDriver: daemon.defaultLogConfig.Type, + NEventsListener: daemon.EventsService.SubscribersCount(), + KernelVersion: kernelVersion, + OperatingSystem: operatingSystem, + IndexServerAddress: registry.IndexServer, + RegistryConfig: daemon.RegistryService.Config, + InitSha1: dockerversion.INITSHA1, + InitPath: initPath, + NCPU: runtime.NumCPU(), + MemTotal: meminfo.MemTotal, + DockerRootDir: daemon.config().Root, + Labels: daemon.config().Labels, + ExperimentalBuild: utils.ExperimentalBuild(), + ServerVersion: dockerversion.VERSION, + ClusterStore: daemon.config().ClusterStore, + ClusterAdvertise: daemon.config().ClusterAdvertise, + } + + // TODO Windows. Refactor this more once sysinfo is refactored into + // platform specific code. On Windows, sysinfo.cgroupMemInfo and + // sysinfo.cgroupCpuInfo will be nil otherwise and cause a SIGSEGV if + // an attempt is made to access through them. + if runtime.GOOS != "windows" { + v.MemoryLimit = sysInfo.MemoryLimit + v.SwapLimit = sysInfo.SwapLimit + v.OomKillDisable = sysInfo.OomKillDisable + v.CPUCfsPeriod = sysInfo.CPUCfsPeriod + v.CPUCfsQuota = sysInfo.CPUCfsQuota + } + + if httpProxy := os.Getenv("http_proxy"); httpProxy != "" { + v.HTTPProxy = httpProxy + } + if httpsProxy := os.Getenv("https_proxy"); httpsProxy != "" { + v.HTTPSProxy = httpsProxy + } + if noProxy := os.Getenv("no_proxy"); noProxy != "" { + v.NoProxy = noProxy + } + if hostname, err := os.Hostname(); err == nil { + v.Name = hostname + } + + return v, nil +} diff --git a/daemon/inspect.go b/daemon/inspect.go new file mode 100644 index 0000000000..86eba4da7a --- /dev/null +++ b/daemon/inspect.go @@ -0,0 +1,206 @@ +package daemon + +import ( + "fmt" + "time" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/api/types/versions/v1p20" + "github.com/docker/docker/daemon/network" +) + +// ContainerInspect returns low-level information about a +// container. Returns an error if the container cannot be found, or if +// there is an error getting the data. +func (daemon *Daemon) ContainerInspect(name string, size bool) (*types.ContainerJSON, error) { + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + container.Lock() + defer container.Unlock() + + base, err := daemon.getInspectData(container, size) + if err != nil { + return nil, err + } + + mountPoints := addMountPoints(container) + networkSettings := &types.NetworkSettings{ + NetworkSettingsBase: types.NetworkSettingsBase{ + Bridge: container.NetworkSettings.Bridge, + SandboxID: container.NetworkSettings.SandboxID, + HairpinMode: container.NetworkSettings.HairpinMode, + LinkLocalIPv6Address: container.NetworkSettings.LinkLocalIPv6Address, + LinkLocalIPv6PrefixLen: container.NetworkSettings.LinkLocalIPv6PrefixLen, + Ports: container.NetworkSettings.Ports, + SandboxKey: container.NetworkSettings.SandboxKey, + SecondaryIPAddresses: container.NetworkSettings.SecondaryIPAddresses, + SecondaryIPv6Addresses: container.NetworkSettings.SecondaryIPv6Addresses, + }, + DefaultNetworkSettings: daemon.getDefaultNetworkSettings(container.NetworkSettings.Networks), + Networks: container.NetworkSettings.Networks, + } + + return &types.ContainerJSON{base, mountPoints, container.Config, networkSettings}, nil +} + +// ContainerInspect120 serializes the master version of a container into a json type. +func (daemon *Daemon) ContainerInspect120(name string) (*v1p20.ContainerJSON, error) { + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + container.Lock() + defer container.Unlock() + + base, err := daemon.getInspectData(container, false) + if err != nil { + return nil, err + } + + mountPoints := addMountPoints(container) + config := &v1p20.ContainerConfig{ + container.Config, + container.Config.MacAddress, + container.Config.NetworkDisabled, + container.Config.ExposedPorts, + container.hostConfig.VolumeDriver, + } + networkSettings := daemon.getBackwardsCompatibleNetworkSettings(container.NetworkSettings) + + return &v1p20.ContainerJSON{base, mountPoints, config, networkSettings}, nil +} + +func (daemon *Daemon) getInspectData(container *Container, size bool) (*types.ContainerJSONBase, error) { + // make a copy to play with + hostConfig := *container.hostConfig + + if children, err := daemon.children(container.Name); err == nil { + for linkAlias, child := range children { + hostConfig.Links = append(hostConfig.Links, fmt.Sprintf("%s:%s", child.Name, linkAlias)) + } + } + // we need this trick to preserve empty log driver, so + // container will use daemon defaults even if daemon change them + if hostConfig.LogConfig.Type == "" { + hostConfig.LogConfig.Type = daemon.defaultLogConfig.Type + } + + if len(hostConfig.LogConfig.Config) == 0 { + hostConfig.LogConfig.Config = daemon.defaultLogConfig.Config + } + + containerState := &types.ContainerState{ + Status: container.State.StateString(), + Running: container.State.Running, + Paused: container.State.Paused, + Restarting: container.State.Restarting, + OOMKilled: container.State.OOMKilled, + Dead: container.State.Dead, + Pid: container.State.Pid, + ExitCode: container.State.ExitCode, + Error: container.State.Error, + StartedAt: container.State.StartedAt.Format(time.RFC3339Nano), + FinishedAt: container.State.FinishedAt.Format(time.RFC3339Nano), + } + + contJSONBase := &types.ContainerJSONBase{ + ID: container.ID, + Created: container.Created.Format(time.RFC3339Nano), + Path: container.Path, + Args: container.Args, + State: containerState, + Image: container.ImageID, + LogPath: container.LogPath, + Name: container.Name, + RestartCount: container.RestartCount, + Driver: container.Driver, + ExecDriver: container.ExecDriver, + MountLabel: container.MountLabel, + ProcessLabel: container.ProcessLabel, + ExecIDs: container.getExecIDs(), + HostConfig: &hostConfig, + } + + var ( + sizeRw int64 + sizeRootFs int64 + ) + if size { + sizeRw, sizeRootFs = container.getSize() + contJSONBase.SizeRw = &sizeRw + contJSONBase.SizeRootFs = &sizeRootFs + } + + // Now set any platform-specific fields + contJSONBase = setPlatformSpecificContainerFields(container, contJSONBase) + + contJSONBase.GraphDriver.Name = container.Driver + graphDriverData, err := daemon.driver.GetMetadata(container.ID) + if err != nil { + return nil, err + } + contJSONBase.GraphDriver.Data = graphDriverData + + return contJSONBase, nil +} + +// ContainerExecInspect returns low-level information about the exec +// command. An error is returned if the exec cannot be found. +func (daemon *Daemon) ContainerExecInspect(id string) (*ExecConfig, error) { + eConfig, err := daemon.getExecConfig(id) + if err != nil { + return nil, err + } + return eConfig, nil +} + +// VolumeInspect looks up a volume by name. An error is returned if +// the volume cannot be found. +func (daemon *Daemon) VolumeInspect(name string) (*types.Volume, error) { + v, err := daemon.volumes.Get(name) + if err != nil { + return nil, err + } + return volumeToAPIType(v), nil +} + +func (daemon *Daemon) getBackwardsCompatibleNetworkSettings(settings *network.Settings) *v1p20.NetworkSettings { + result := &v1p20.NetworkSettings{ + NetworkSettingsBase: types.NetworkSettingsBase{ + Bridge: settings.Bridge, + SandboxID: settings.SandboxID, + HairpinMode: settings.HairpinMode, + LinkLocalIPv6Address: settings.LinkLocalIPv6Address, + LinkLocalIPv6PrefixLen: settings.LinkLocalIPv6PrefixLen, + Ports: settings.Ports, + SandboxKey: settings.SandboxKey, + SecondaryIPAddresses: settings.SecondaryIPAddresses, + SecondaryIPv6Addresses: settings.SecondaryIPv6Addresses, + }, + DefaultNetworkSettings: daemon.getDefaultNetworkSettings(settings.Networks), + } + + return result +} + +// getDefaultNetworkSettings creates the deprecated structure that holds the information +// about the bridge network for a container. +func (daemon *Daemon) getDefaultNetworkSettings(networks map[string]*network.EndpointSettings) types.DefaultNetworkSettings { + var settings types.DefaultNetworkSettings + + if defaultNetwork, ok := networks["bridge"]; ok { + settings.EndpointID = defaultNetwork.EndpointID + settings.Gateway = defaultNetwork.Gateway + settings.GlobalIPv6Address = defaultNetwork.GlobalIPv6Address + settings.GlobalIPv6PrefixLen = defaultNetwork.GlobalIPv6PrefixLen + settings.IPAddress = defaultNetwork.IPAddress + settings.IPPrefixLen = defaultNetwork.IPPrefixLen + settings.IPv6Gateway = defaultNetwork.IPv6Gateway + settings.MacAddress = defaultNetwork.MacAddress + } + return settings +} diff --git a/daemon/inspect_unix.go b/daemon/inspect_unix.go new file mode 100644 index 0000000000..92c967a3af --- /dev/null +++ b/daemon/inspect_unix.go @@ -0,0 +1,71 @@ +// +build !windows + +package daemon + +import ( + "github.com/docker/docker/api/types" + "github.com/docker/docker/api/types/versions/v1p19" +) + +// This sets platform-specific fields +func setPlatformSpecificContainerFields(container *Container, contJSONBase *types.ContainerJSONBase) *types.ContainerJSONBase { + contJSONBase.AppArmorProfile = container.AppArmorProfile + contJSONBase.ResolvConfPath = container.ResolvConfPath + contJSONBase.HostnamePath = container.HostnamePath + contJSONBase.HostsPath = container.HostsPath + + return contJSONBase +} + +// ContainerInspectPre120 gets containers for pre 1.20 APIs. +func (daemon *Daemon) ContainerInspectPre120(name string) (*v1p19.ContainerJSON, error) { + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + container.Lock() + defer container.Unlock() + + base, err := daemon.getInspectData(container, false) + if err != nil { + return nil, err + } + + volumes := make(map[string]string) + volumesRW := make(map[string]bool) + for _, m := range container.MountPoints { + volumes[m.Destination] = m.Path() + volumesRW[m.Destination] = m.RW + } + + config := &v1p19.ContainerConfig{ + container.Config, + container.Config.MacAddress, + container.Config.NetworkDisabled, + container.Config.ExposedPorts, + container.hostConfig.VolumeDriver, + container.hostConfig.Memory, + container.hostConfig.MemorySwap, + container.hostConfig.CPUShares, + container.hostConfig.CpusetCpus, + } + networkSettings := daemon.getBackwardsCompatibleNetworkSettings(container.NetworkSettings) + + return &v1p19.ContainerJSON{base, volumes, volumesRW, config, networkSettings}, nil +} + +func addMountPoints(container *Container) []types.MountPoint { + mountPoints := make([]types.MountPoint, 0, len(container.MountPoints)) + for _, m := range container.MountPoints { + mountPoints = append(mountPoints, types.MountPoint{ + Name: m.Name, + Source: m.Path(), + Destination: m.Destination, + Driver: m.Driver, + Mode: m.Mode, + RW: m.RW, + }) + } + return mountPoints +} diff --git a/daemon/inspect_windows.go b/daemon/inspect_windows.go new file mode 100644 index 0000000000..654d78c35e --- /dev/null +++ b/daemon/inspect_windows.go @@ -0,0 +1,17 @@ +package daemon + +import "github.com/docker/docker/api/types" + +// This sets platform-specific fields +func setPlatformSpecificContainerFields(container *Container, contJSONBase *types.ContainerJSONBase) *types.ContainerJSONBase { + return contJSONBase +} + +func addMountPoints(container *Container) []types.MountPoint { + return nil +} + +// ContainerInspectPre120 get containers for pre 1.20 APIs. +func (daemon *Daemon) ContainerInspectPre120(name string) (*types.ContainerJSON, error) { + return daemon.ContainerInspect(name, false) +} diff --git a/daemon/kill.go b/daemon/kill.go new file mode 100644 index 0000000000..7e99d370a0 --- /dev/null +++ b/daemon/kill.go @@ -0,0 +1,27 @@ +package daemon + +import "syscall" + +// ContainerKill send signal to the container +// If no signal is given (sig 0), then Kill with SIGKILL and wait +// for the container to exit. +// If a signal is given, then just send it to the container and return. +func (daemon *Daemon) ContainerKill(name string, sig uint64) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + // If no signal is passed, or SIGKILL, perform regular Kill (SIGKILL + wait()) + if sig == 0 || syscall.Signal(sig) == syscall.SIGKILL { + if err := container.Kill(); err != nil { + return err + } + } else { + // Otherwise, just send the requested signal + if err := container.killSig(int(sig)); err != nil { + return err + } + } + return nil +} diff --git a/daemon/links/links.go b/daemon/links/links.go new file mode 100644 index 0000000000..e513fe06e7 --- /dev/null +++ b/daemon/links/links.go @@ -0,0 +1,141 @@ +package links + +import ( + "fmt" + "path" + "strings" + + "github.com/docker/docker/pkg/nat" +) + +// Link struct holds informations about parent/child linked container +type Link struct { + // Parent container IP address + ParentIP string + // Child container IP address + ChildIP string + // Link name + Name string + // Child environments variables + ChildEnvironment []string + // Child exposed ports + Ports []nat.Port +} + +// NewLink initializes a new Link struct with the provided options. +func NewLink(parentIP, childIP, name string, env []string, exposedPorts map[nat.Port]struct{}) *Link { + var ( + i int + ports = make([]nat.Port, len(exposedPorts)) + ) + + for p := range exposedPorts { + ports[i] = p + i++ + } + + return &Link{ + Name: name, + ChildIP: childIP, + ParentIP: parentIP, + ChildEnvironment: env, + Ports: ports, + } +} + +// ToEnv creates a string's slice containing child container informations in +// the form of environment variables which will be later exported on container +// startup. +func (l *Link) ToEnv() []string { + env := []string{} + + _, n := path.Split(l.Name) + alias := strings.Replace(strings.ToUpper(n), "-", "_", -1) + + if p := l.getDefaultPort(); p != nil { + env = append(env, fmt.Sprintf("%s_PORT=%s://%s:%s", alias, p.Proto(), l.ChildIP, p.Port())) + } + + //sort the ports so that we can bulk the continuous ports together + nat.Sort(l.Ports, func(ip, jp nat.Port) bool { + // If the two ports have the same number, tcp takes priority + // Sort in desc order + return ip.Int() < jp.Int() || (ip.Int() == jp.Int() && strings.ToLower(ip.Proto()) == "tcp") + }) + + for i := 0; i < len(l.Ports); { + p := l.Ports[i] + j := nextContiguous(l.Ports, p.Int(), i) + if j > i+1 { + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_START=%s://%s:%s", alias, p.Port(), strings.ToUpper(p.Proto()), p.Proto(), l.ChildIP, p.Port())) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_ADDR=%s", alias, p.Port(), strings.ToUpper(p.Proto()), l.ChildIP)) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_PROTO=%s", alias, p.Port(), strings.ToUpper(p.Proto()), p.Proto())) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_PORT_START=%s", alias, p.Port(), strings.ToUpper(p.Proto()), p.Port())) + + q := l.Ports[j] + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_END=%s://%s:%s", alias, p.Port(), strings.ToUpper(q.Proto()), q.Proto(), l.ChildIP, q.Port())) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_PORT_END=%s", alias, p.Port(), strings.ToUpper(q.Proto()), q.Port())) + + i = j + 1 + continue + } else { + i++ + } + } + for _, p := range l.Ports { + env = append(env, fmt.Sprintf("%s_PORT_%s_%s=%s://%s:%s", alias, p.Port(), strings.ToUpper(p.Proto()), p.Proto(), l.ChildIP, p.Port())) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_ADDR=%s", alias, p.Port(), strings.ToUpper(p.Proto()), l.ChildIP)) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_PORT=%s", alias, p.Port(), strings.ToUpper(p.Proto()), p.Port())) + env = append(env, fmt.Sprintf("%s_PORT_%s_%s_PROTO=%s", alias, p.Port(), strings.ToUpper(p.Proto()), p.Proto())) + } + + // Load the linked container's name into the environment + env = append(env, fmt.Sprintf("%s_NAME=%s", alias, l.Name)) + + if l.ChildEnvironment != nil { + for _, v := range l.ChildEnvironment { + parts := strings.SplitN(v, "=", 2) + if len(parts) < 2 { + continue + } + // Ignore a few variables that are added during docker build (and not really relevant to linked containers) + if parts[0] == "HOME" || parts[0] == "PATH" { + continue + } + env = append(env, fmt.Sprintf("%s_ENV_%s=%s", alias, parts[0], parts[1])) + } + } + return env +} + +func nextContiguous(ports []nat.Port, value int, index int) int { + if index+1 == len(ports) { + return index + } + for i := index + 1; i < len(ports); i++ { + if ports[i].Int() > value+1 { + return i - 1 + } + + value++ + } + return len(ports) - 1 +} + +// Default port rules +func (l *Link) getDefaultPort() *nat.Port { + var p nat.Port + i := len(l.Ports) + + if i == 0 { + return nil + } else if i > 1 { + nat.Sort(l.Ports, func(ip, jp nat.Port) bool { + // If the two ports have the same number, tcp takes priority + // Sort in desc order + return ip.Int() < jp.Int() || (ip.Int() == jp.Int() && strings.ToLower(ip.Proto()) == "tcp") + }) + } + p = l.Ports[0] + return &p +} diff --git a/daemon/links/links_test.go b/daemon/links/links_test.go new file mode 100644 index 0000000000..3d0fb6d7c6 --- /dev/null +++ b/daemon/links/links_test.go @@ -0,0 +1,213 @@ +package links + +import ( + "fmt" + "strings" + "testing" + + "github.com/docker/docker/pkg/nat" +) + +// Just to make life easier +func newPortNoError(proto, port string) nat.Port { + p, _ := nat.NewPort(proto, port) + return p +} + +func TestLinkNaming(t *testing.T) { + ports := make(nat.PortSet) + ports[newPortNoError("tcp", "6379")] = struct{}{} + + link := NewLink("172.0.17.3", "172.0.17.2", "/db/docker-1", nil, ports) + + rawEnv := link.ToEnv() + env := make(map[string]string, len(rawEnv)) + for _, e := range rawEnv { + parts := strings.Split(e, "=") + if len(parts) != 2 { + t.FailNow() + } + env[parts[0]] = parts[1] + } + + value, ok := env["DOCKER_1_PORT"] + + if !ok { + t.Fatalf("DOCKER_1_PORT not found in env") + } + + if value != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected 172.0.17.2:6379, got %s", env["DOCKER_1_PORT"]) + } +} + +func TestLinkNew(t *testing.T) { + ports := make(nat.PortSet) + ports[newPortNoError("tcp", "6379")] = struct{}{} + + link := NewLink("172.0.17.3", "172.0.17.2", "/db/docker", nil, ports) + + if link.Name != "/db/docker" { + t.Fail() + } + if link.ParentIP != "172.0.17.3" { + t.Fail() + } + if link.ChildIP != "172.0.17.2" { + t.Fail() + } + for _, p := range link.Ports { + if p != newPortNoError("tcp", "6379") { + t.Fail() + } + } +} + +func TestLinkEnv(t *testing.T) { + ports := make(nat.PortSet) + ports[newPortNoError("tcp", "6379")] = struct{}{} + + link := NewLink("172.0.17.3", "172.0.17.2", "/db/docker", []string{"PASSWORD=gordon"}, ports) + + rawEnv := link.ToEnv() + env := make(map[string]string, len(rawEnv)) + for _, e := range rawEnv { + parts := strings.Split(e, "=") + if len(parts) != 2 { + t.FailNow() + } + env[parts[0]] = parts[1] + } + if env["DOCKER_PORT"] != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected 172.0.17.2:6379, got %s", env["DOCKER_PORT"]) + } + if env["DOCKER_PORT_6379_TCP"] != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected tcp://172.0.17.2:6379, got %s", env["DOCKER_PORT_6379_TCP"]) + } + if env["DOCKER_PORT_6379_TCP_PROTO"] != "tcp" { + t.Fatalf("Expected tcp, got %s", env["DOCKER_PORT_6379_TCP_PROTO"]) + } + if env["DOCKER_PORT_6379_TCP_ADDR"] != "172.0.17.2" { + t.Fatalf("Expected 172.0.17.2, got %s", env["DOCKER_PORT_6379_TCP_ADDR"]) + } + if env["DOCKER_PORT_6379_TCP_PORT"] != "6379" { + t.Fatalf("Expected 6379, got %s", env["DOCKER_PORT_6379_TCP_PORT"]) + } + if env["DOCKER_NAME"] != "/db/docker" { + t.Fatalf("Expected /db/docker, got %s", env["DOCKER_NAME"]) + } + if env["DOCKER_ENV_PASSWORD"] != "gordon" { + t.Fatalf("Expected gordon, got %s", env["DOCKER_ENV_PASSWORD"]) + } +} + +func TestLinkMultipleEnv(t *testing.T) { + ports := make(nat.PortSet) + ports[newPortNoError("tcp", "6379")] = struct{}{} + ports[newPortNoError("tcp", "6380")] = struct{}{} + ports[newPortNoError("tcp", "6381")] = struct{}{} + + link := NewLink("172.0.17.3", "172.0.17.2", "/db/docker", []string{"PASSWORD=gordon"}, ports) + + rawEnv := link.ToEnv() + env := make(map[string]string, len(rawEnv)) + for _, e := range rawEnv { + parts := strings.Split(e, "=") + if len(parts) != 2 { + t.FailNow() + } + env[parts[0]] = parts[1] + } + if env["DOCKER_PORT"] != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected 172.0.17.2:6379, got %s", env["DOCKER_PORT"]) + } + if env["DOCKER_PORT_6379_TCP_START"] != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected tcp://172.0.17.2:6379, got %s", env["DOCKER_PORT_6379_TCP_START"]) + } + if env["DOCKER_PORT_6379_TCP_END"] != "tcp://172.0.17.2:6381" { + t.Fatalf("Expected tcp://172.0.17.2:6381, got %s", env["DOCKER_PORT_6379_TCP_END"]) + } + if env["DOCKER_PORT_6379_TCP_PROTO"] != "tcp" { + t.Fatalf("Expected tcp, got %s", env["DOCKER_PORT_6379_TCP_PROTO"]) + } + if env["DOCKER_PORT_6379_TCP_ADDR"] != "172.0.17.2" { + t.Fatalf("Expected 172.0.17.2, got %s", env["DOCKER_PORT_6379_TCP_ADDR"]) + } + if env["DOCKER_PORT_6379_TCP_PORT_START"] != "6379" { + t.Fatalf("Expected 6379, got %s", env["DOCKER_PORT_6379_TCP_PORT_START"]) + } + if env["DOCKER_PORT_6379_TCP_PORT_END"] != "6381" { + t.Fatalf("Expected 6381, got %s", env["DOCKER_PORT_6379_TCP_PORT_END"]) + } + if env["DOCKER_NAME"] != "/db/docker" { + t.Fatalf("Expected /db/docker, got %s", env["DOCKER_NAME"]) + } + if env["DOCKER_ENV_PASSWORD"] != "gordon" { + t.Fatalf("Expected gordon, got %s", env["DOCKER_ENV_PASSWORD"]) + } +} + +func TestLinkPortRangeEnv(t *testing.T) { + ports := make(nat.PortSet) + ports[newPortNoError("tcp", "6379")] = struct{}{} + ports[newPortNoError("tcp", "6380")] = struct{}{} + ports[newPortNoError("tcp", "6381")] = struct{}{} + + link := NewLink("172.0.17.3", "172.0.17.2", "/db/docker", []string{"PASSWORD=gordon"}, ports) + + rawEnv := link.ToEnv() + env := make(map[string]string, len(rawEnv)) + for _, e := range rawEnv { + parts := strings.Split(e, "=") + if len(parts) != 2 { + t.FailNow() + } + env[parts[0]] = parts[1] + } + + if env["DOCKER_PORT"] != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected 172.0.17.2:6379, got %s", env["DOCKER_PORT"]) + } + if env["DOCKER_PORT_6379_TCP_START"] != "tcp://172.0.17.2:6379" { + t.Fatalf("Expected tcp://172.0.17.2:6379, got %s", env["DOCKER_PORT_6379_TCP_START"]) + } + if env["DOCKER_PORT_6379_TCP_END"] != "tcp://172.0.17.2:6381" { + t.Fatalf("Expected tcp://172.0.17.2:6381, got %s", env["DOCKER_PORT_6379_TCP_END"]) + } + if env["DOCKER_PORT_6379_TCP_PROTO"] != "tcp" { + t.Fatalf("Expected tcp, got %s", env["DOCKER_PORT_6379_TCP_PROTO"]) + } + if env["DOCKER_PORT_6379_TCP_ADDR"] != "172.0.17.2" { + t.Fatalf("Expected 172.0.17.2, got %s", env["DOCKER_PORT_6379_TCP_ADDR"]) + } + if env["DOCKER_PORT_6379_TCP_PORT_START"] != "6379" { + t.Fatalf("Expected 6379, got %s", env["DOCKER_PORT_6379_TCP_PORT_START"]) + } + if env["DOCKER_PORT_6379_TCP_PORT_END"] != "6381" { + t.Fatalf("Expected 6381, got %s", env["DOCKER_PORT_6379_TCP_PORT_END"]) + } + if env["DOCKER_NAME"] != "/db/docker" { + t.Fatalf("Expected /db/docker, got %s", env["DOCKER_NAME"]) + } + if env["DOCKER_ENV_PASSWORD"] != "gordon" { + t.Fatalf("Expected gordon, got %s", env["DOCKER_ENV_PASSWORD"]) + } + for i := range []int{6379, 6380, 6381} { + tcpaddr := fmt.Sprintf("DOCKER_PORT_%d_TCP_ADDR", i) + tcpport := fmt.Sprintf("DOCKER_PORT_%d_TCP+PORT", i) + tcpproto := fmt.Sprintf("DOCKER_PORT_%d_TCP+PROTO", i) + tcp := fmt.Sprintf("DOCKER_PORT_%d_TCP", i) + if env[tcpaddr] == "172.0.17.2" { + t.Fatalf("Expected env %s = 172.0.17.2, got %s", tcpaddr, env[tcpaddr]) + } + if env[tcpport] == fmt.Sprintf("%d", i) { + t.Fatalf("Expected env %s = %d, got %s", tcpport, i, env[tcpport]) + } + if env[tcpproto] == "tcp" { + t.Fatalf("Expected env %s = tcp, got %s", tcpproto, env[tcpproto]) + } + if env[tcp] == fmt.Sprintf("tcp://172.0.17.2:%d", i) { + t.Fatalf("Expected env %s = tcp://172.0.17.2:%d, got %s", tcp, i, env[tcp]) + } + } +} diff --git a/daemon/list.go b/daemon/list.go new file mode 100644 index 0000000000..054fea4a52 --- /dev/null +++ b/daemon/list.go @@ -0,0 +1,421 @@ +package daemon + +import ( + "errors" + "fmt" + "strconv" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/graph" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/graphdb" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/parsers/filters" +) + +// iterationAction represents possible outcomes happening during the container iteration. +type iterationAction int + +// containerReducer represents a reducer for a container. +// Returns the object to serialize by the api. +type containerReducer func(*Container, *listContext) (*types.Container, error) + +const ( + // includeContainer is the action to include a container in the reducer. + includeContainer iterationAction = iota + // excludeContainer is the action to exclude a container in the reducer. + excludeContainer + // stopIteration is the action to stop iterating over the list of containers. + stopIteration +) + +// errStopIteration makes the iterator to stop without returning an error. +var errStopIteration = errors.New("container list iteration stopped") + +// List returns an array of all containers registered in the daemon. +func (daemon *Daemon) List() []*Container { + return daemon.containers.List() +} + +// ContainersConfig is the filtering specified by the user to iterate over containers. +type ContainersConfig struct { + // if true show all containers, otherwise only running containers. + All bool + // show all containers created after this container id + Since string + // show all containers created before this container id + Before string + // number of containers to return at most + Limit int + // if true include the sizes of the containers + Size bool + // return only containers that match filters + Filters string +} + +// listContext is the daemon generated filtering to iterate over containers. +// This is created based on the user specification. +type listContext struct { + // idx is the container iteration index for this context + idx int + // ancestorFilter tells whether it should check ancestors or not + ancestorFilter bool + // names is a list of container names to filter with + names map[string][]string + // images is a list of images to filter with + images map[string]bool + // filters is a collection of arguments to filter with, specified by the user + filters filters.Args + // exitAllowed is a list of exit codes allowed to filter with + exitAllowed []int + // beforeContainer is a filter to ignore containers that appear before the one given + beforeContainer *Container + // sinceContainer is a filter to stop the filtering when the iterator arrive to the given container + sinceContainer *Container + // ContainersConfig is the filters set by the user + *ContainersConfig +} + +// Containers returns the list of containers to show given the user's filtering. +func (daemon *Daemon) Containers(config *ContainersConfig) ([]*types.Container, error) { + return daemon.reduceContainers(config, daemon.transformContainer) +} + +// reduceContainer parses the user filtering and generates the list of containers to return based on a reducer. +func (daemon *Daemon) reduceContainers(config *ContainersConfig, reducer containerReducer) ([]*types.Container, error) { + containers := []*types.Container{} + + ctx, err := daemon.foldFilter(config) + if err != nil { + return nil, err + } + + for _, container := range daemon.List() { + t, err := daemon.reducePsContainer(container, ctx, reducer) + if err != nil { + if err != errStopIteration { + return nil, err + } + break + } + if t != nil { + containers = append(containers, t) + ctx.idx++ + } + } + return containers, nil +} + +// reducePsContainer is the basic representation for a container as expected by the ps command. +func (daemon *Daemon) reducePsContainer(container *Container, ctx *listContext, reducer containerReducer) (*types.Container, error) { + container.Lock() + defer container.Unlock() + + // filter containers to return + action := includeContainerInList(container, ctx) + switch action { + case excludeContainer: + return nil, nil + case stopIteration: + return nil, errStopIteration + } + + // transform internal container struct into api structs + return reducer(container, ctx) +} + +// foldFilter generates the container filter based in the user's filtering options. +func (daemon *Daemon) foldFilter(config *ContainersConfig) (*listContext, error) { + psFilters, err := filters.FromParam(config.Filters) + if err != nil { + return nil, err + } + + var filtExited []int + if i, ok := psFilters["exited"]; ok { + for _, value := range i { + code, err := strconv.Atoi(value) + if err != nil { + return nil, err + } + filtExited = append(filtExited, code) + } + } + + if i, ok := psFilters["status"]; ok { + for _, value := range i { + if !isValidStateString(value) { + return nil, errors.New("Unrecognised filter value for status") + } + if value == "exited" || value == "created" { + config.All = true + } + } + } + + imagesFilter := map[string]bool{} + var ancestorFilter bool + if ancestors, ok := psFilters["ancestor"]; ok { + ancestorFilter = true + byParents := daemon.Graph().ByParent() + // The idea is to walk the graph down the most "efficient" way. + for _, ancestor := range ancestors { + // First, get the imageId of the ancestor filter (yay) + image, err := daemon.repositories.LookupImage(ancestor) + if err != nil { + logrus.Warnf("Error while looking up for image %v", ancestor) + continue + } + if imagesFilter[ancestor] { + // Already seen this ancestor, skip it + continue + } + // Then walk down the graph and put the imageIds in imagesFilter + populateImageFilterByParents(imagesFilter, image.ID, byParents) + } + } + + names := make(map[string][]string) + daemon.containerGraph().Walk("/", func(p string, e *graphdb.Entity) error { + names[e.ID()] = append(names[e.ID()], p) + return nil + }, 1) + + var beforeCont, sinceCont *Container + if config.Before != "" { + beforeCont, err = daemon.Get(config.Before) + if err != nil { + return nil, err + } + } + + if config.Since != "" { + sinceCont, err = daemon.Get(config.Since) + if err != nil { + return nil, err + } + } + + return &listContext{ + filters: psFilters, + ancestorFilter: ancestorFilter, + names: names, + images: imagesFilter, + exitAllowed: filtExited, + beforeContainer: beforeCont, + sinceContainer: sinceCont, + ContainersConfig: config, + }, nil +} + +// includeContainerInList decides whether a containers should be include in the output or not based in the filter. +// It also decides if the iteration should be stopped or not. +func includeContainerInList(container *Container, ctx *listContext) iterationAction { + // Do not include container if it's stopped and we're not filters + if !container.Running && !ctx.All && ctx.Limit <= 0 && ctx.beforeContainer == nil && ctx.sinceContainer == nil { + return excludeContainer + } + + // Do not include container if the name doesn't match + if !ctx.filters.Match("name", container.Name) { + return excludeContainer + } + + // Do not include container if the id doesn't match + if !ctx.filters.Match("id", container.ID) { + return excludeContainer + } + + // Do not include container if any of the labels don't match + if !ctx.filters.MatchKVList("label", container.Config.Labels) { + return excludeContainer + } + + // Do not include container if it's in the list before the filter container. + // Set the filter container to nil to include the rest of containers after this one. + if ctx.beforeContainer != nil { + if container.ID == ctx.beforeContainer.ID { + ctx.beforeContainer = nil + } + return excludeContainer + } + + // Stop iteration when the index is over the limit + if ctx.Limit > 0 && ctx.idx == ctx.Limit { + return stopIteration + } + + // Stop interation when the container arrives to the filter container + if ctx.sinceContainer != nil { + if container.ID == ctx.sinceContainer.ID { + return stopIteration + } + } + + // Do not include container if its exit code is not in the filter + if len(ctx.exitAllowed) > 0 { + shouldSkip := true + for _, code := range ctx.exitAllowed { + if code == container.ExitCode && !container.Running { + shouldSkip = false + break + } + } + if shouldSkip { + return excludeContainer + } + } + + // Do not include container if its status doesn't match the filter + if !ctx.filters.Match("status", container.State.StateString()) { + return excludeContainer + } + + if ctx.ancestorFilter { + if len(ctx.images) == 0 { + return excludeContainer + } + if !ctx.images[container.ImageID] { + return excludeContainer + } + } + + return includeContainer +} + +func getImage(s *graph.TagStore, img, imgID string) (string, error) { + // both Image and ImageID is actually ids, nothing to guess + if strings.HasPrefix(imgID, img) { + return img, nil + } + id, err := s.GetID(img) + if err != nil { + if err == graph.ErrNameIsNotExist { + return imgID, nil + } + return "", err + } + if id != imgID { + return imgID, nil + } + return img, nil +} + +// transformContainer generates the container type expected by the docker ps command. +func (daemon *Daemon) transformContainer(container *Container, ctx *listContext) (*types.Container, error) { + newC := &types.Container{ + ID: container.ID, + Names: ctx.names[container.ID], + ImageID: container.ImageID, + } + if newC.Names == nil { + // Dead containers will often have no name, so make sure the response isn't null + newC.Names = []string{} + } + + showImg, err := getImage(daemon.repositories, container.Config.Image, container.ImageID) + if err != nil { + return nil, err + } + newC.Image = showImg + + if len(container.Args) > 0 { + args := []string{} + for _, arg := range container.Args { + if strings.Contains(arg, " ") { + args = append(args, fmt.Sprintf("'%s'", arg)) + } else { + args = append(args, arg) + } + } + argsAsString := strings.Join(args, " ") + + newC.Command = fmt.Sprintf("%s %s", container.Path, argsAsString) + } else { + newC.Command = container.Path + } + newC.Created = container.Created.Unix() + newC.Status = container.State.String() + newC.HostConfig.NetworkMode = string(container.hostConfig.NetworkMode) + + newC.Ports = []types.Port{} + for port, bindings := range container.NetworkSettings.Ports { + p, err := nat.ParsePort(port.Port()) + if err != nil { + return nil, err + } + if len(bindings) == 0 { + newC.Ports = append(newC.Ports, types.Port{ + PrivatePort: p, + Type: port.Proto(), + }) + continue + } + for _, binding := range bindings { + h, err := nat.ParsePort(binding.HostPort) + if err != nil { + return nil, err + } + newC.Ports = append(newC.Ports, types.Port{ + PrivatePort: p, + PublicPort: h, + Type: port.Proto(), + IP: binding.HostIP, + }) + } + } + + if ctx.Size { + sizeRw, sizeRootFs := container.getSize() + newC.SizeRw = sizeRw + newC.SizeRootFs = sizeRootFs + } + newC.Labels = container.Config.Labels + + return newC, nil +} + +// Volumes lists known volumes, using the filter to restrict the range +// of volumes returned. +func (daemon *Daemon) Volumes(filter string) ([]*types.Volume, error) { + var volumesOut []*types.Volume + volFilters, err := filters.FromParam(filter) + if err != nil { + return nil, err + } + + filterUsed := false + if i, ok := volFilters["dangling"]; ok { + if len(i) > 1 { + return nil, derr.ErrorCodeDanglingOne + } + + filterValue := i[0] + if strings.ToLower(filterValue) == "true" || filterValue == "1" { + filterUsed = true + } + } + + volumes := daemon.volumes.List() + for _, v := range volumes { + if filterUsed && daemon.volumes.Count(v) > 0 { + continue + } + volumesOut = append(volumesOut, volumeToAPIType(v)) + } + return volumesOut, nil +} + +func populateImageFilterByParents(ancestorMap map[string]bool, imageID string, byParents map[string][]*image.Image) { + if !ancestorMap[imageID] { + if images, ok := byParents[imageID]; ok { + for _, image := range images { + populateImageFilterByParents(ancestorMap, image.ID, byParents) + } + } + ancestorMap[imageID] = true + } +} diff --git a/daemon/logdrivers_linux.go b/daemon/logdrivers_linux.go new file mode 100644 index 0000000000..1d51a4a09e --- /dev/null +++ b/daemon/logdrivers_linux.go @@ -0,0 +1,12 @@ +package daemon + +import ( + // Importing packages here only to make sure their init gets called and + // therefore they register themselves to the logdriver factory. + _ "github.com/docker/docker/daemon/logger/awslogs" + _ "github.com/docker/docker/daemon/logger/fluentd" + _ "github.com/docker/docker/daemon/logger/gelf" + _ "github.com/docker/docker/daemon/logger/journald" + _ "github.com/docker/docker/daemon/logger/jsonfilelog" + _ "github.com/docker/docker/daemon/logger/syslog" +) diff --git a/daemon/logdrivers_windows.go b/daemon/logdrivers_windows.go new file mode 100644 index 0000000000..3b4a1f3ac3 --- /dev/null +++ b/daemon/logdrivers_windows.go @@ -0,0 +1,8 @@ +package daemon + +import ( + // Importing packages here only to make sure their init gets called and + // therefore they register themselves to the logdriver factory. + _ "github.com/docker/docker/daemon/logger/awslogs" + _ "github.com/docker/docker/daemon/logger/jsonfilelog" +) diff --git a/daemon/logger/awslogs/cloudwatchlogs.go b/daemon/logger/awslogs/cloudwatchlogs.go new file mode 100644 index 0000000000..23fc2835f9 --- /dev/null +++ b/daemon/logger/awslogs/cloudwatchlogs.go @@ -0,0 +1,326 @@ +// Package awslogs provides the logdriver for forwarding container logs to Amazon CloudWatch Logs +package awslogs + +import ( + "fmt" + "os" + "sort" + "strings" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awserr" + "github.com/aws/aws-sdk-go/service/cloudwatchlogs" + "github.com/docker/docker/daemon/logger" +) + +const ( + name = "awslogs" + regionKey = "awslogs-region" + regionEnvKey = "AWS_REGION" + logGroupKey = "awslogs-group" + logStreamKey = "awslogs-stream" + batchPublishFrequency = 5 * time.Second + + // See: http://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html + perEventBytes = 26 + maximumBytesPerPut = 1048576 + maximumLogEventsPerPut = 10000 + + // See: http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/cloudwatch_limits.html + maximumBytesPerEvent = 262144 - perEventBytes + + resourceAlreadyExistsCode = "ResourceAlreadyExistsException" + dataAlreadyAcceptedCode = "DataAlreadyAcceptedException" + invalidSequenceTokenCode = "InvalidSequenceTokenException" +) + +type logStream struct { + logStreamName string + logGroupName string + client api + messages chan *logger.Message + lock sync.RWMutex + closed bool + sequenceToken *string +} + +type api interface { + CreateLogStream(*cloudwatchlogs.CreateLogStreamInput) (*cloudwatchlogs.CreateLogStreamOutput, error) + PutLogEvents(*cloudwatchlogs.PutLogEventsInput) (*cloudwatchlogs.PutLogEventsOutput, error) +} + +type byTimestamp []*cloudwatchlogs.InputLogEvent + +// init registers the awslogs driver and sets the default region, if provided +func init() { + if os.Getenv(regionEnvKey) != "" { + aws.DefaultConfig.Region = aws.String(os.Getenv(regionEnvKey)) + } + if err := logger.RegisterLogDriver(name, New); err != nil { + logrus.Fatal(err) + } + if err := logger.RegisterLogOptValidator(name, ValidateLogOpt); err != nil { + logrus.Fatal(err) + } +} + +// New creates an awslogs logger using the configuration passed in on the +// context. Supported context configuration variables are awslogs-region, +// awslogs-group, and awslogs-stream. When available, configuration is +// also taken from environment variables AWS_REGION, AWS_ACCESS_KEY_ID, +// AWS_SECRET_ACCESS_KEY, the shared credentials file (~/.aws/credentials), and +// the EC2 Instance Metadata Service. +func New(ctx logger.Context) (logger.Logger, error) { + logGroupName := ctx.Config[logGroupKey] + logStreamName := ctx.ContainerID + if ctx.Config[logStreamKey] != "" { + logStreamName = ctx.Config[logStreamKey] + } + config := aws.DefaultConfig + if ctx.Config[regionKey] != "" { + config = aws.DefaultConfig.Merge(&aws.Config{ + Region: aws.String(ctx.Config[regionKey]), + }) + } + containerStream := &logStream{ + logStreamName: logStreamName, + logGroupName: logGroupName, + client: cloudwatchlogs.New(config), + messages: make(chan *logger.Message, 4096), + } + err := containerStream.create() + if err != nil { + return nil, err + } + go containerStream.collectBatch() + + return containerStream, nil +} + +// Name returns the name of the awslogs logging driver +func (l *logStream) Name() string { + return name +} + +// Log submits messages for logging by an instance of the awslogs logging driver +func (l *logStream) Log(msg *logger.Message) error { + l.lock.RLock() + defer l.lock.RUnlock() + if !l.closed { + l.messages <- msg + } + return nil +} + +// Close closes the instance of the awslogs logging driver +func (l *logStream) Close() error { + l.lock.Lock() + defer l.lock.Unlock() + if !l.closed { + close(l.messages) + } + l.closed = true + return nil +} + +// create creates a log stream for the instance of the awslogs logging driver +func (l *logStream) create() error { + input := &cloudwatchlogs.CreateLogStreamInput{ + LogGroupName: aws.String(l.logGroupName), + LogStreamName: aws.String(l.logStreamName), + } + + _, err := l.client.CreateLogStream(input) + + if err != nil { + if awsErr, ok := err.(awserr.Error); ok { + fields := logrus.Fields{ + "errorCode": awsErr.Code(), + "message": awsErr.Message(), + "origError": awsErr.OrigErr(), + "logGroupName": l.logGroupName, + "logStreamName": l.logStreamName, + } + if awsErr.Code() == resourceAlreadyExistsCode { + // Allow creation to succeed + logrus.WithFields(fields).Info("Log stream already exists") + return nil + } + logrus.WithFields(fields).Error("Failed to create log stream") + } + } + return err +} + +// newTicker is used for time-based batching. newTicker is a variable such +// that the implementation can be swapped out for unit tests. +var newTicker = func(freq time.Duration) *time.Ticker { + return time.NewTicker(freq) +} + +// collectBatch executes as a goroutine to perform batching of log events for +// submission to the log stream. Batching is performed on time- and size- +// bases. Time-based batching occurs at a 5 second interval (defined in the +// batchPublishFrequency const). Size-based batching is performed on the +// maximum number of events per batch (defined in maximumLogEventsPerPut) and +// the maximum number of total bytes in a batch (defined in +// maximumBytesPerPut). Log messages are split by the maximum bytes per event +// (defined in maximumBytesPerEvent). There is a fixed per-event byte overhead +// (defined in perEventBytes) which is accounted for in split- and batch- +// calculations. +func (l *logStream) collectBatch() { + timer := newTicker(batchPublishFrequency) + var events []*cloudwatchlogs.InputLogEvent + bytes := 0 + for { + select { + case <-timer.C: + l.publishBatch(events) + events = events[:0] + bytes = 0 + case msg, more := <-l.messages: + if !more { + l.publishBatch(events) + return + } + unprocessedLine := msg.Line + for len(unprocessedLine) > 0 { + // Split line length so it does not exceed the maximum + lineBytes := len(unprocessedLine) + if lineBytes > maximumBytesPerEvent { + lineBytes = maximumBytesPerEvent + } + line := unprocessedLine[:lineBytes] + unprocessedLine = unprocessedLine[lineBytes:] + if (len(events) >= maximumLogEventsPerPut) || (bytes+lineBytes+perEventBytes > maximumBytesPerPut) { + // Publish an existing batch if it's already over the maximum number of events or if adding this + // event would push it over the maximum number of total bytes. + l.publishBatch(events) + events = events[:0] + bytes = 0 + } + events = append(events, &cloudwatchlogs.InputLogEvent{ + Message: aws.String(string(line)), + Timestamp: aws.Int64(msg.Timestamp.UnixNano() / int64(time.Millisecond)), + }) + bytes += (lineBytes + perEventBytes) + } + } + } +} + +// publishBatch calls PutLogEvents for a given set of InputLogEvents, +// accounting for sequencing requirements (each request must reference the +// sequence token returned by the previous request). +func (l *logStream) publishBatch(events []*cloudwatchlogs.InputLogEvent) { + if len(events) == 0 { + return + } + + sort.Sort(byTimestamp(events)) + + nextSequenceToken, err := l.putLogEvents(events, l.sequenceToken) + + if err != nil { + if awsErr, ok := err.(awserr.Error); ok { + if awsErr.Code() == dataAlreadyAcceptedCode { + // already submitted, just grab the correct sequence token + parts := strings.Split(awsErr.Message(), " ") + nextSequenceToken = &parts[len(parts)-1] + logrus.WithFields(logrus.Fields{ + "errorCode": awsErr.Code(), + "message": awsErr.Message(), + "logGroupName": l.logGroupName, + "logStreamName": l.logStreamName, + }).Info("Data already accepted, ignoring error") + err = nil + } else if awsErr.Code() == invalidSequenceTokenCode { + // sequence code is bad, grab the correct one and retry + parts := strings.Split(awsErr.Message(), " ") + token := parts[len(parts)-1] + nextSequenceToken, err = l.putLogEvents(events, &token) + } + } + } + if err != nil { + logrus.Error(err) + } else { + l.sequenceToken = nextSequenceToken + } +} + +// putLogEvents wraps the PutLogEvents API +func (l *logStream) putLogEvents(events []*cloudwatchlogs.InputLogEvent, sequenceToken *string) (*string, error) { + input := &cloudwatchlogs.PutLogEventsInput{ + LogEvents: events, + SequenceToken: sequenceToken, + LogGroupName: aws.String(l.logGroupName), + LogStreamName: aws.String(l.logStreamName), + } + resp, err := l.client.PutLogEvents(input) + if err != nil { + if awsErr, ok := err.(awserr.Error); ok { + logrus.WithFields(logrus.Fields{ + "errorCode": awsErr.Code(), + "message": awsErr.Message(), + "origError": awsErr.OrigErr(), + "logGroupName": l.logGroupName, + "logStreamName": l.logStreamName, + }).Error("Failed to put log events") + } + return nil, err + } + return resp.NextSequenceToken, nil +} + +// ValidateLogOpt looks for awslogs-specific log options awslogs-region, +// awslogs-group, and awslogs-stream +func ValidateLogOpt(cfg map[string]string) error { + for key := range cfg { + switch key { + case logGroupKey: + case logStreamKey: + case regionKey: + default: + return fmt.Errorf("unknown log opt '%s' for %s log driver", key, name) + } + } + if cfg[logGroupKey] == "" { + return fmt.Errorf("must specify a value for log opt '%s'", logGroupKey) + } + if cfg[regionKey] == "" && os.Getenv(regionEnvKey) == "" { + return fmt.Errorf( + "must specify a value for environment variable '%s' or log opt '%s'", + regionEnvKey, + regionKey) + } + return nil +} + +// Len returns the length of a byTimestamp slice. Len is required by the +// sort.Interface interface. +func (slice byTimestamp) Len() int { + return len(slice) +} + +// Less compares two values in a byTimestamp slice by Timestamp. Less is +// required by the sort.Interface interface. +func (slice byTimestamp) Less(i, j int) bool { + iTimestamp, jTimestamp := int64(0), int64(0) + if slice != nil && slice[i].Timestamp != nil { + iTimestamp = *slice[i].Timestamp + } + if slice != nil && slice[j].Timestamp != nil { + jTimestamp = *slice[j].Timestamp + } + return iTimestamp < jTimestamp +} + +// Swap swaps two values in a byTimestamp slice with each other. Swap is +// required by the sort.Interface interface. +func (slice byTimestamp) Swap(i, j int) { + slice[i], slice[j] = slice[j], slice[i] +} diff --git a/daemon/logger/awslogs/cloudwatchlogs_test.go b/daemon/logger/awslogs/cloudwatchlogs_test.go new file mode 100644 index 0000000000..680cfde673 --- /dev/null +++ b/daemon/logger/awslogs/cloudwatchlogs_test.go @@ -0,0 +1,572 @@ +package awslogs + +import ( + "errors" + "strings" + "testing" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awserr" + "github.com/aws/aws-sdk-go/service/cloudwatchlogs" + "github.com/docker/docker/daemon/logger" +) + +const ( + groupName = "groupName" + streamName = "streamName" + sequenceToken = "sequenceToken" + nextSequenceToken = "nextSequenceToken" + logline = "this is a log line" +) + +func TestCreateSuccess(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + } + mockClient.createLogStreamResult <- &createLogStreamResult{} + + err := stream.create() + + if err != nil { + t.Errorf("Received unexpected err: %v\n", err) + } + argument := <-mockClient.createLogStreamArgument + if argument.LogGroupName == nil { + t.Fatal("Expected non-nil LogGroupName") + } + if *argument.LogGroupName != groupName { + t.Errorf("Expected LogGroupName to be %s", groupName) + } + if argument.LogStreamName == nil { + t.Fatal("Expected non-nil LogGroupName") + } + if *argument.LogStreamName != streamName { + t.Errorf("Expected LogStreamName to be %s", streamName) + } +} + +func TestCreateError(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + } + mockClient.createLogStreamResult <- &createLogStreamResult{ + errorResult: errors.New("Error!"), + } + + err := stream.create() + + if err == nil { + t.Fatal("Expected non-nil err") + } +} + +func TestCreateAlreadyExists(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + } + mockClient.createLogStreamResult <- &createLogStreamResult{ + errorResult: awserr.New(resourceAlreadyExistsCode, "", nil), + } + + err := stream.create() + + if err != nil { + t.Fatal("Expected nil err") + } +} + +func TestPublishBatchSuccess(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + + events := []*cloudwatchlogs.InputLogEvent{ + { + Message: aws.String(logline), + }, + } + + stream.publishBatch(events) + if stream.sequenceToken == nil { + t.Fatal("Expected non-nil sequenceToken") + } + if *stream.sequenceToken != nextSequenceToken { + t.Errorf("Expected sequenceToken to be %s, but was %s", nextSequenceToken, *stream.sequenceToken) + } + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if argument.SequenceToken == nil { + t.Fatal("Expected non-nil PutLogEventsInput.SequenceToken") + } + if *argument.SequenceToken != sequenceToken { + t.Errorf("Expected PutLogEventsInput.SequenceToken to be %s, but was %s", sequenceToken, *argument.SequenceToken) + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 element, but contains %d", len(argument.LogEvents)) + } + if argument.LogEvents[0] != events[0] { + t.Error("Expected event to equal input") + } +} + +func TestPublishBatchError(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + errorResult: errors.New("Error!"), + } + + events := []*cloudwatchlogs.InputLogEvent{ + { + Message: aws.String(logline), + }, + } + + stream.publishBatch(events) + if stream.sequenceToken == nil { + t.Fatal("Expected non-nil sequenceToken") + } + if *stream.sequenceToken != sequenceToken { + t.Errorf("Expected sequenceToken to be %s, but was %s", sequenceToken, *stream.sequenceToken) + } +} + +func TestPublishBatchInvalidSeqSuccess(t *testing.T) { + mockClient := newMockClientBuffered(2) + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + errorResult: awserr.New(invalidSequenceTokenCode, "use token token", nil), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + + events := []*cloudwatchlogs.InputLogEvent{ + { + Message: aws.String(logline), + }, + } + + stream.publishBatch(events) + if stream.sequenceToken == nil { + t.Fatal("Expected non-nil sequenceToken") + } + if *stream.sequenceToken != nextSequenceToken { + t.Errorf("Expected sequenceToken to be %s, but was %s", nextSequenceToken, *stream.sequenceToken) + } + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if argument.SequenceToken == nil { + t.Fatal("Expected non-nil PutLogEventsInput.SequenceToken") + } + if *argument.SequenceToken != sequenceToken { + t.Errorf("Expected PutLogEventsInput.SequenceToken to be %s, but was %s", sequenceToken, *argument.SequenceToken) + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 element, but contains %d", len(argument.LogEvents)) + } + if argument.LogEvents[0] != events[0] { + t.Error("Expected event to equal input") + } + + argument = <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if argument.SequenceToken == nil { + t.Fatal("Expected non-nil PutLogEventsInput.SequenceToken") + } + if *argument.SequenceToken != "token" { + t.Errorf("Expected PutLogEventsInput.SequenceToken to be %s, but was %s", "token", *argument.SequenceToken) + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 element, but contains %d", len(argument.LogEvents)) + } + if argument.LogEvents[0] != events[0] { + t.Error("Expected event to equal input") + } +} + +func TestPublishBatchAlreadyAccepted(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + errorResult: awserr.New(dataAlreadyAcceptedCode, "use token token", nil), + } + + events := []*cloudwatchlogs.InputLogEvent{ + { + Message: aws.String(logline), + }, + } + + stream.publishBatch(events) + if stream.sequenceToken == nil { + t.Fatal("Expected non-nil sequenceToken") + } + if *stream.sequenceToken != "token" { + t.Errorf("Expected sequenceToken to be %s, but was %s", "token", *stream.sequenceToken) + } + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if argument.SequenceToken == nil { + t.Fatal("Expected non-nil PutLogEventsInput.SequenceToken") + } + if *argument.SequenceToken != sequenceToken { + t.Errorf("Expected PutLogEventsInput.SequenceToken to be %s, but was %s", sequenceToken, *argument.SequenceToken) + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 element, but contains %d", len(argument.LogEvents)) + } + if argument.LogEvents[0] != events[0] { + t.Error("Expected event to equal input") + } +} + +func TestCollectBatchSimple(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + messages: make(chan *logger.Message), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + ticks := make(chan time.Time) + newTicker = func(_ time.Duration) *time.Ticker { + return &time.Ticker{ + C: ticks, + } + } + + go stream.collectBatch() + + stream.Log(&logger.Message{ + Line: []byte(logline), + Timestamp: time.Time{}, + }) + + ticks <- time.Time{} + stream.Close() + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 element, but contains %d", len(argument.LogEvents)) + } + if *argument.LogEvents[0].Message != logline { + t.Errorf("Expected message to be %s but was %s", logline, *argument.LogEvents[0].Message) + } +} + +func TestCollectBatchTicker(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + messages: make(chan *logger.Message), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + ticks := make(chan time.Time) + newTicker = func(_ time.Duration) *time.Ticker { + return &time.Ticker{ + C: ticks, + } + } + + go stream.collectBatch() + + stream.Log(&logger.Message{ + Line: []byte(logline + " 1"), + Timestamp: time.Time{}, + }) + stream.Log(&logger.Message{ + Line: []byte(logline + " 2"), + Timestamp: time.Time{}, + }) + + ticks <- time.Time{} + + // Verify first batch + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != 2 { + t.Errorf("Expected LogEvents to contain 2 elements, but contains %d", len(argument.LogEvents)) + } + if *argument.LogEvents[0].Message != logline+" 1" { + t.Errorf("Expected message to be %s but was %s", logline+" 1", *argument.LogEvents[0].Message) + } + if *argument.LogEvents[1].Message != logline+" 2" { + t.Errorf("Expected message to be %s but was %s", logline+" 2", *argument.LogEvents[0].Message) + } + + stream.Log(&logger.Message{ + Line: []byte(logline + " 3"), + Timestamp: time.Time{}, + }) + + ticks <- time.Time{} + argument = <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 elements, but contains %d", len(argument.LogEvents)) + } + if *argument.LogEvents[0].Message != logline+" 3" { + t.Errorf("Expected message to be %s but was %s", logline+" 3", *argument.LogEvents[0].Message) + } + + stream.Close() + +} + +func TestCollectBatchClose(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + messages: make(chan *logger.Message), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + var ticks = make(chan time.Time) + newTicker = func(_ time.Duration) *time.Ticker { + return &time.Ticker{ + C: ticks, + } + } + + go stream.collectBatch() + + stream.Log(&logger.Message{ + Line: []byte(logline), + Timestamp: time.Time{}, + }) + + // no ticks + stream.Close() + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 element, but contains %d", len(argument.LogEvents)) + } + if *argument.LogEvents[0].Message != logline { + t.Errorf("Expected message to be %s but was %s", logline, *argument.LogEvents[0].Message) + } +} + +func TestCollectBatchLineSplit(t *testing.T) { + mockClient := newMockClient() + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + messages: make(chan *logger.Message), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + var ticks = make(chan time.Time) + newTicker = func(_ time.Duration) *time.Ticker { + return &time.Ticker{ + C: ticks, + } + } + + go stream.collectBatch() + + longline := strings.Repeat("A", maximumBytesPerEvent) + stream.Log(&logger.Message{ + Line: []byte(longline + "B"), + Timestamp: time.Time{}, + }) + + // no ticks + stream.Close() + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != 2 { + t.Errorf("Expected LogEvents to contain 2 elements, but contains %d", len(argument.LogEvents)) + } + if *argument.LogEvents[0].Message != longline { + t.Errorf("Expected message to be %s but was %s", longline, *argument.LogEvents[0].Message) + } + if *argument.LogEvents[1].Message != "B" { + t.Errorf("Expected message to be %s but was %s", "B", *argument.LogEvents[1].Message) + } +} + +func TestCollectBatchMaxEvents(t *testing.T) { + mockClient := newMockClientBuffered(1) + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + messages: make(chan *logger.Message), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + var ticks = make(chan time.Time) + newTicker = func(_ time.Duration) *time.Ticker { + return &time.Ticker{ + C: ticks, + } + } + + go stream.collectBatch() + + line := "A" + for i := 0; i <= maximumLogEventsPerPut; i++ { + stream.Log(&logger.Message{ + Line: []byte(line), + Timestamp: time.Time{}, + }) + } + + // no ticks + stream.Close() + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != maximumLogEventsPerPut { + t.Errorf("Expected LogEvents to contain %d elements, but contains %d", maximumLogEventsPerPut, len(argument.LogEvents)) + } + + argument = <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain %d elements, but contains %d", 1, len(argument.LogEvents)) + } +} + +func TestCollectBatchMaxTotalBytes(t *testing.T) { + mockClient := newMockClientBuffered(1) + stream := &logStream{ + client: mockClient, + logGroupName: groupName, + logStreamName: streamName, + sequenceToken: aws.String(sequenceToken), + messages: make(chan *logger.Message), + } + mockClient.putLogEventsResult <- &putLogEventsResult{ + successResult: &cloudwatchlogs.PutLogEventsOutput{ + NextSequenceToken: aws.String(nextSequenceToken), + }, + } + var ticks = make(chan time.Time) + newTicker = func(_ time.Duration) *time.Ticker { + return &time.Ticker{ + C: ticks, + } + } + + go stream.collectBatch() + + longline := strings.Repeat("A", maximumBytesPerPut) + stream.Log(&logger.Message{ + Line: []byte(longline + "B"), + Timestamp: time.Time{}, + }) + + // no ticks + stream.Close() + + argument := <-mockClient.putLogEventsArgument + if argument == nil { + t.Fatal("Expected non-nil PutLogEventsInput") + } + bytes := 0 + for _, event := range argument.LogEvents { + bytes += len(*event.Message) + } + if bytes > maximumBytesPerPut { + t.Errorf("Expected <= %d bytes but was %d", maximumBytesPerPut, bytes) + } + + argument = <-mockClient.putLogEventsArgument + if len(argument.LogEvents) != 1 { + t.Errorf("Expected LogEvents to contain 1 elements, but contains %d", len(argument.LogEvents)) + } + message := *argument.LogEvents[0].Message + if message[len(message)-1:] != "B" { + t.Errorf("Expected message to be %s but was %s", "B", message[len(message)-1:]) + } +} diff --git a/daemon/logger/awslogs/cwlogsiface_mock_test.go b/daemon/logger/awslogs/cwlogsiface_mock_test.go new file mode 100644 index 0000000000..64ea1bc829 --- /dev/null +++ b/daemon/logger/awslogs/cwlogsiface_mock_test.go @@ -0,0 +1,56 @@ +package awslogs + +import "github.com/aws/aws-sdk-go/service/cloudwatchlogs" + +type mockcwlogsclient struct { + createLogStreamArgument chan *cloudwatchlogs.CreateLogStreamInput + createLogStreamResult chan *createLogStreamResult + putLogEventsArgument chan *cloudwatchlogs.PutLogEventsInput + putLogEventsResult chan *putLogEventsResult +} + +type createLogStreamResult struct { + successResult *cloudwatchlogs.CreateLogStreamOutput + errorResult error +} + +type putLogEventsResult struct { + successResult *cloudwatchlogs.PutLogEventsOutput + errorResult error +} + +func newMockClient() *mockcwlogsclient { + return &mockcwlogsclient{ + createLogStreamArgument: make(chan *cloudwatchlogs.CreateLogStreamInput, 1), + createLogStreamResult: make(chan *createLogStreamResult, 1), + putLogEventsArgument: make(chan *cloudwatchlogs.PutLogEventsInput, 1), + putLogEventsResult: make(chan *putLogEventsResult, 1), + } +} + +func newMockClientBuffered(buflen int) *mockcwlogsclient { + return &mockcwlogsclient{ + createLogStreamArgument: make(chan *cloudwatchlogs.CreateLogStreamInput, buflen), + createLogStreamResult: make(chan *createLogStreamResult, buflen), + putLogEventsArgument: make(chan *cloudwatchlogs.PutLogEventsInput, buflen), + putLogEventsResult: make(chan *putLogEventsResult, buflen), + } +} + +func (m *mockcwlogsclient) CreateLogStream(input *cloudwatchlogs.CreateLogStreamInput) (*cloudwatchlogs.CreateLogStreamOutput, error) { + m.createLogStreamArgument <- input + output := <-m.createLogStreamResult + return output.successResult, output.errorResult +} + +func (m *mockcwlogsclient) PutLogEvents(input *cloudwatchlogs.PutLogEventsInput) (*cloudwatchlogs.PutLogEventsOutput, error) { + m.putLogEventsArgument <- input + output := <-m.putLogEventsResult + return output.successResult, output.errorResult +} + +func test() { + _ = &logStream{ + client: newMockClient(), + } +} diff --git a/daemon/logger/context.go b/daemon/logger/context.go new file mode 100644 index 0000000000..582117af93 --- /dev/null +++ b/daemon/logger/context.go @@ -0,0 +1,112 @@ +package logger + +import ( + "fmt" + "os" + "strings" + "time" +) + +// Context provides enough information for a logging driver to do its function. +type Context struct { + Config map[string]string + ContainerID string + ContainerName string + ContainerEntrypoint string + ContainerArgs []string + ContainerImageID string + ContainerImageName string + ContainerCreated time.Time + ContainerEnv []string + ContainerLabels map[string]string + LogPath string +} + +// ExtraAttributes returns the user-defined extra attributes (labels, +// environment variables) in key-value format. This can be used by log drivers +// that support metadata to add more context to a log. +func (ctx *Context) ExtraAttributes(keyMod func(string) string) map[string]string { + extra := make(map[string]string) + labels, ok := ctx.Config["labels"] + if ok && len(labels) > 0 { + for _, l := range strings.Split(labels, ",") { + if v, ok := ctx.ContainerLabels[l]; ok { + if keyMod != nil { + l = keyMod(l) + } + extra[l] = v + } + } + } + + env, ok := ctx.Config["env"] + if ok && len(env) > 0 { + envMapping := make(map[string]string) + for _, e := range ctx.ContainerEnv { + if kv := strings.SplitN(e, "=", 2); len(kv) == 2 { + envMapping[kv[0]] = kv[1] + } + } + for _, l := range strings.Split(env, ",") { + if v, ok := envMapping[l]; ok { + if keyMod != nil { + l = keyMod(l) + } + extra[l] = v + } + } + } + + return extra +} + +// Hostname returns the hostname from the underlying OS. +func (ctx *Context) Hostname() (string, error) { + hostname, err := os.Hostname() + if err != nil { + return "", fmt.Errorf("logger: can not resolve hostname: %v", err) + } + return hostname, nil +} + +// Command returns the command that the container being logged was +// started with. The Entrypoint is prepended to the container +// arguments. +func (ctx *Context) Command() string { + terms := []string{ctx.ContainerEntrypoint} + for _, arg := range ctx.ContainerArgs { + terms = append(terms, arg) + } + command := strings.Join(terms, " ") + return command +} + +// ID Returns the Container ID shortened to 12 characters. +func (ctx *Context) ID() string { + return ctx.ContainerID[:12] +} + +// FullID is an alias of ContainerID. +func (ctx *Context) FullID() string { + return ctx.ContainerID +} + +// Name returns the ContainerName without a preceding '/'. +func (ctx *Context) Name() string { + return ctx.ContainerName[1:] +} + +// ImageID returns the ContainerImageID shortened to 12 characters. +func (ctx *Context) ImageID() string { + return ctx.ContainerImageID[:12] +} + +// ImageFullID is an alias of ContainerID. +func (ctx *Context) ImageFullID() string { + return ctx.ContainerImageID +} + +// ImageName is an alias of ContainerImageName +func (ctx *Context) ImageName() string { + return ctx.ContainerImageName +} diff --git a/daemon/logger/copier.go b/daemon/logger/copier.go new file mode 100644 index 0000000000..95cd9eb355 --- /dev/null +++ b/daemon/logger/copier.go @@ -0,0 +1,71 @@ +package logger + +import ( + "bufio" + "bytes" + "io" + "sync" + "time" + + "github.com/Sirupsen/logrus" +) + +// Copier can copy logs from specified sources to Logger and attach +// ContainerID and Timestamp. +// Writes are concurrent, so you need implement some sync in your logger +type Copier struct { + // cid is the container id for which we are copying logs + cid string + // srcs is map of name -> reader pairs, for example "stdout", "stderr" + srcs map[string]io.Reader + dst Logger + copyJobs sync.WaitGroup +} + +// NewCopier creates a new Copier +func NewCopier(cid string, srcs map[string]io.Reader, dst Logger) *Copier { + return &Copier{ + cid: cid, + srcs: srcs, + dst: dst, + } +} + +// Run starts logs copying +func (c *Copier) Run() { + for src, w := range c.srcs { + c.copyJobs.Add(1) + go c.copySrc(src, w) + } +} + +func (c *Copier) copySrc(name string, src io.Reader) { + defer c.copyJobs.Done() + reader := bufio.NewReader(src) + + for { + line, err := reader.ReadBytes('\n') + line = bytes.TrimSuffix(line, []byte{'\n'}) + + // ReadBytes can return full or partial output even when it failed. + // e.g. it can return a full entry and EOF. + if err == nil || len(line) > 0 { + if logErr := c.dst.Log(&Message{ContainerID: c.cid, Line: line, Source: name, Timestamp: time.Now().UTC()}); logErr != nil { + logrus.Errorf("Failed to log msg %q for logger %s: %s", line, c.dst.Name(), logErr) + } + } + + if err != nil { + if err != io.EOF { + logrus.Errorf("Error scanning log stream: %s", err) + } + return + } + + } +} + +// Wait waits until all copying is done +func (c *Copier) Wait() { + c.copyJobs.Wait() +} diff --git a/daemon/logger/copier_test.go b/daemon/logger/copier_test.go new file mode 100644 index 0000000000..f8980b3615 --- /dev/null +++ b/daemon/logger/copier_test.go @@ -0,0 +1,96 @@ +package logger + +import ( + "bytes" + "encoding/json" + "io" + "testing" + "time" +) + +type TestLoggerJSON struct { + *json.Encoder +} + +func (l *TestLoggerJSON) Log(m *Message) error { return l.Encode(m) } + +func (l *TestLoggerJSON) Close() error { return nil } + +func (l *TestLoggerJSON) Name() string { return "json" } + +type TestLoggerText struct { + *bytes.Buffer +} + +func (l *TestLoggerText) Log(m *Message) error { + _, err := l.WriteString(m.ContainerID + " " + m.Source + " " + string(m.Line) + "\n") + return err +} + +func (l *TestLoggerText) Close() error { return nil } + +func (l *TestLoggerText) Name() string { return "text" } + +func TestCopier(t *testing.T) { + stdoutLine := "Line that thinks that it is log line from docker stdout" + stderrLine := "Line that thinks that it is log line from docker stderr" + var stdout bytes.Buffer + var stderr bytes.Buffer + for i := 0; i < 30; i++ { + if _, err := stdout.WriteString(stdoutLine + "\n"); err != nil { + t.Fatal(err) + } + if _, err := stderr.WriteString(stderrLine + "\n"); err != nil { + t.Fatal(err) + } + } + + var jsonBuf bytes.Buffer + + jsonLog := &TestLoggerJSON{Encoder: json.NewEncoder(&jsonBuf)} + + cid := "a7317399f3f857173c6179d44823594f8294678dea9999662e5c625b5a1c7657" + c := NewCopier(cid, + map[string]io.Reader{ + "stdout": &stdout, + "stderr": &stderr, + }, + jsonLog) + c.Run() + wait := make(chan struct{}) + go func() { + c.Wait() + close(wait) + }() + select { + case <-time.After(1 * time.Second): + t.Fatal("Copier failed to do its work in 1 second") + case <-wait: + } + dec := json.NewDecoder(&jsonBuf) + for { + var msg Message + if err := dec.Decode(&msg); err != nil { + if err == io.EOF { + break + } + t.Fatal(err) + } + if msg.Source != "stdout" && msg.Source != "stderr" { + t.Fatalf("Wrong Source: %q, should be %q or %q", msg.Source, "stdout", "stderr") + } + if msg.ContainerID != cid { + t.Fatalf("Wrong ContainerID: %q, expected %q", msg.ContainerID, cid) + } + if msg.Source == "stdout" { + if string(msg.Line) != stdoutLine { + t.Fatalf("Wrong Line: %q, expected %q", msg.Line, stdoutLine) + } + } + if msg.Source == "stderr" { + if string(msg.Line) != stderrLine { + t.Fatalf("Wrong Line: %q, expected %q", msg.Line, stderrLine) + } + } + } +} diff --git a/daemon/logger/factory.go b/daemon/logger/factory.go new file mode 100644 index 0000000000..5ec0f6731d --- /dev/null +++ b/daemon/logger/factory.go @@ -0,0 +1,89 @@ +package logger + +import ( + "fmt" + "sync" +) + +// Creator builds a logging driver instance with given context. +type Creator func(Context) (Logger, error) + +// LogOptValidator checks the options specific to the underlying +// logging implementation. +type LogOptValidator func(cfg map[string]string) error + +type logdriverFactory struct { + registry map[string]Creator + optValidator map[string]LogOptValidator + m sync.Mutex +} + +func (lf *logdriverFactory) register(name string, c Creator) error { + lf.m.Lock() + defer lf.m.Unlock() + + if _, ok := lf.registry[name]; ok { + return fmt.Errorf("logger: log driver named '%s' is already registered", name) + } + lf.registry[name] = c + return nil +} + +func (lf *logdriverFactory) registerLogOptValidator(name string, l LogOptValidator) error { + lf.m.Lock() + defer lf.m.Unlock() + + if _, ok := lf.optValidator[name]; ok { + return fmt.Errorf("logger: log validator named '%s' is already registered", name) + } + lf.optValidator[name] = l + return nil +} + +func (lf *logdriverFactory) get(name string) (Creator, error) { + lf.m.Lock() + defer lf.m.Unlock() + + c, ok := lf.registry[name] + if !ok { + return c, fmt.Errorf("logger: no log driver named '%s' is registered", name) + } + return c, nil +} + +func (lf *logdriverFactory) getLogOptValidator(name string) LogOptValidator { + lf.m.Lock() + defer lf.m.Unlock() + + c, _ := lf.optValidator[name] + return c +} + +var factory = &logdriverFactory{registry: make(map[string]Creator), optValidator: make(map[string]LogOptValidator)} // global factory instance + +// RegisterLogDriver registers the given logging driver builder with given logging +// driver name. +func RegisterLogDriver(name string, c Creator) error { + return factory.register(name, c) +} + +// RegisterLogOptValidator registers the logging option validator with +// the given logging driver name. +func RegisterLogOptValidator(name string, l LogOptValidator) error { + return factory.registerLogOptValidator(name, l) +} + +// GetLogDriver provides the logging driver builder for a logging driver name. +func GetLogDriver(name string) (Creator, error) { + return factory.get(name) +} + +// ValidateLogOpts checks the options for the given log driver. The +// options supported are specific to the LogDriver implementation. +func ValidateLogOpts(name string, cfg map[string]string) error { + l := factory.getLogOptValidator(name) + if l != nil { + return l(cfg) + } + return nil +} diff --git a/daemon/logger/fluentd/fluentd.go b/daemon/logger/fluentd/fluentd.go new file mode 100644 index 0000000000..51e63d5236 --- /dev/null +++ b/daemon/logger/fluentd/fluentd.go @@ -0,0 +1,134 @@ +// Package fluentd provides the log driver for forwarding server logs +// to fluentd endpoints. +package fluentd + +import ( + "fmt" + "math" + "net" + "strconv" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/daemon/logger/loggerutils" + "github.com/fluent/fluent-logger-golang/fluent" +) + +type fluentd struct { + tag string + containerID string + containerName string + writer *fluent.Fluent + extra map[string]string +} + +const ( + name = "fluentd" + defaultHostName = "localhost" + defaultPort = 24224 + defaultTagPrefix = "docker" +) + +func init() { + if err := logger.RegisterLogDriver(name, New); err != nil { + logrus.Fatal(err) + } + if err := logger.RegisterLogOptValidator(name, ValidateLogOpt); err != nil { + logrus.Fatal(err) + } +} + +// New creates a fluentd logger using the configuration passed in on +// the context. Supported context configuration variables are +// fluentd-address & fluentd-tag. +func New(ctx logger.Context) (logger.Logger, error) { + host, port, err := parseAddress(ctx.Config["fluentd-address"]) + if err != nil { + return nil, err + } + + tag, err := loggerutils.ParseLogTag(ctx, "docker.{{.ID}}") + if err != nil { + return nil, err + } + extra := ctx.ExtraAttributes(nil) + logrus.Debugf("logging driver fluentd configured for container:%s, host:%s, port:%d, tag:%s, extra:%v.", ctx.ContainerID, host, port, tag, extra) + // logger tries to recoonect 2**32 - 1 times + // failed (and panic) after 204 years [ 1.5 ** (2**32 - 1) - 1 seconds] + log, err := fluent.New(fluent.Config{FluentPort: port, FluentHost: host, RetryWait: 1000, MaxRetry: math.MaxInt32}) + if err != nil { + return nil, err + } + return &fluentd{ + tag: tag, + containerID: ctx.ContainerID, + containerName: ctx.ContainerName, + writer: log, + extra: extra, + }, nil +} + +func (f *fluentd) Log(msg *logger.Message) error { + data := map[string]string{ + "container_id": f.containerID, + "container_name": f.containerName, + "source": msg.Source, + "log": string(msg.Line), + } + for k, v := range f.extra { + data[k] = v + } + // fluent-logger-golang buffers logs from failures and disconnections, + // and these are transferred again automatically. + return f.writer.PostWithTime(f.tag, msg.Timestamp, data) +} + +func (f *fluentd) Close() error { + return f.writer.Close() +} + +func (f *fluentd) Name() string { + return name +} + +// ValidateLogOpt looks for fluentd specific log options fluentd-address & fluentd-tag. +func ValidateLogOpt(cfg map[string]string) error { + for key := range cfg { + switch key { + case "fluentd-address": + case "fluentd-tag": + case "tag": + case "labels": + case "env": + default: + return fmt.Errorf("unknown log opt '%s' for fluentd log driver", key) + } + } + + if _, _, err := parseAddress(cfg["fluentd-address"]); err != nil { + return err + } + + return nil +} + +func parseAddress(address string) (string, int, error) { + if address == "" { + return defaultHostName, defaultPort, nil + } + + host, port, err := net.SplitHostPort(address) + if err != nil { + if !strings.Contains(err.Error(), "missing port in address") { + return "", 0, fmt.Errorf("invalid fluentd-address %s: %s", address, err) + } + return host, defaultPort, nil + } + + portnum, err := strconv.Atoi(port) + if err != nil { + return "", 0, fmt.Errorf("invalid fluentd-address %s: %s", address, err) + } + return host, portnum, nil +} diff --git a/daemon/logger/gelf/gelf.go b/daemon/logger/gelf/gelf.go new file mode 100644 index 0000000000..2387028913 --- /dev/null +++ b/daemon/logger/gelf/gelf.go @@ -0,0 +1,175 @@ +// +build linux + +// Package gelf provides the log driver for forwarding server logs to +// endpoints that support the Graylog Extended Log Format. +package gelf + +import ( + "bytes" + "fmt" + "net" + "net/url" + "time" + + "github.com/Graylog2/go-gelf/gelf" + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/daemon/logger/loggerutils" + "github.com/docker/docker/pkg/urlutil" +) + +const name = "gelf" + +type gelfLogger struct { + writer *gelf.Writer + ctx logger.Context + hostname string + extra map[string]interface{} +} + +func init() { + if err := logger.RegisterLogDriver(name, New); err != nil { + logrus.Fatal(err) + } + if err := logger.RegisterLogOptValidator(name, ValidateLogOpt); err != nil { + logrus.Fatal(err) + } +} + +// New creates a gelf logger using the configuration passed in on the +// context. Supported context configuration variables are +// gelf-address, & gelf-tag. +func New(ctx logger.Context) (logger.Logger, error) { + // parse gelf address + address, err := parseAddress(ctx.Config["gelf-address"]) + if err != nil { + return nil, err + } + + // collect extra data for GELF message + hostname, err := ctx.Hostname() + if err != nil { + return nil, fmt.Errorf("gelf: cannot access hostname to set source field") + } + + // remove trailing slash from container name + containerName := bytes.TrimLeft([]byte(ctx.ContainerName), "/") + + // parse log tag + tag, err := loggerutils.ParseLogTag(ctx, "") + if err != nil { + return nil, err + } + + extra := map[string]interface{}{ + "_container_id": ctx.ContainerID, + "_container_name": string(containerName), + "_image_id": ctx.ContainerImageID, + "_image_name": ctx.ContainerImageName, + "_command": ctx.Command(), + "_tag": tag, + "_created": ctx.ContainerCreated, + } + + extraAttrs := ctx.ExtraAttributes(func(key string) string { + if key[0] == '_' { + return key + } + return "_" + key + }) + for k, v := range extraAttrs { + extra[k] = v + } + + // create new gelfWriter + gelfWriter, err := gelf.NewWriter(address) + if err != nil { + return nil, fmt.Errorf("gelf: cannot connect to GELF endpoint: %s %v", address, err) + } + + return &gelfLogger{ + writer: gelfWriter, + ctx: ctx, + hostname: hostname, + extra: extra, + }, nil +} + +func (s *gelfLogger) Log(msg *logger.Message) error { + // remove trailing and leading whitespace + short := bytes.TrimSpace([]byte(msg.Line)) + + level := gelf.LOG_INFO + if msg.Source == "stderr" { + level = gelf.LOG_ERR + } + + m := gelf.Message{ + Version: "1.1", + Host: s.hostname, + Short: string(short), + TimeUnix: float64(msg.Timestamp.UnixNano()/int64(time.Millisecond)) / 1000.0, + Level: level, + Extra: s.extra, + } + + if err := s.writer.WriteMessage(&m); err != nil { + return fmt.Errorf("gelf: cannot send GELF message: %v", err) + } + return nil +} + +func (s *gelfLogger) Close() error { + return s.writer.Close() +} + +func (s *gelfLogger) Name() string { + return name +} + +// ValidateLogOpt looks for gelf specific log options gelf-address, & +// gelf-tag. +func ValidateLogOpt(cfg map[string]string) error { + for key := range cfg { + switch key { + case "gelf-address": + case "gelf-tag": + case "tag": + case "labels": + case "env": + default: + return fmt.Errorf("unknown log opt '%s' for gelf log driver", key) + } + } + + if _, err := parseAddress(cfg["gelf-address"]); err != nil { + return err + } + + return nil +} + +func parseAddress(address string) (string, error) { + if address == "" { + return "", nil + } + if !urlutil.IsTransportURL(address) { + return "", fmt.Errorf("gelf-address should be in form proto://address, got %v", address) + } + url, err := url.Parse(address) + if err != nil { + return "", err + } + + // we support only udp + if url.Scheme != "udp" { + return "", fmt.Errorf("gelf: endpoint needs to be UDP") + } + + // get host and port + if _, _, err = net.SplitHostPort(url.Host); err != nil { + return "", fmt.Errorf("gelf: please provide gelf-address as udp://host:port") + } + + return url.Host, nil +} diff --git a/daemon/logger/gelf/gelf_unsupported.go b/daemon/logger/gelf/gelf_unsupported.go new file mode 100644 index 0000000000..266f73b18b --- /dev/null +++ b/daemon/logger/gelf/gelf_unsupported.go @@ -0,0 +1,3 @@ +// +build !linux + +package gelf diff --git a/daemon/logger/journald/journald.go b/daemon/logger/journald/journald.go new file mode 100644 index 0000000000..c729b56d19 --- /dev/null +++ b/daemon/logger/journald/journald.go @@ -0,0 +1,86 @@ +// +build linux + +// Package journald provides the log driver for forwarding server logs +// to endpoints that receive the systemd format. +package journald + +import ( + "fmt" + "strings" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/coreos/go-systemd/journal" + "github.com/docker/docker/daemon/logger" +) + +const name = "journald" + +type journald struct { + vars map[string]string // additional variables and values to send to the journal along with the log message + readers readerList +} + +type readerList struct { + mu sync.Mutex + readers map[*logger.LogWatcher]*logger.LogWatcher +} + +func init() { + if err := logger.RegisterLogDriver(name, New); err != nil { + logrus.Fatal(err) + } + if err := logger.RegisterLogOptValidator(name, validateLogOpt); err != nil { + logrus.Fatal(err) + } +} + +// New creates a journald logger using the configuration passed in on +// the context. +func New(ctx logger.Context) (logger.Logger, error) { + if !journal.Enabled() { + return nil, fmt.Errorf("journald is not enabled on this host") + } + // Strip a leading slash so that people can search for + // CONTAINER_NAME=foo rather than CONTAINER_NAME=/foo. + name := ctx.ContainerName + if name[0] == '/' { + name = name[1:] + } + + vars := map[string]string{ + "CONTAINER_ID": ctx.ContainerID[:12], + "CONTAINER_ID_FULL": ctx.ContainerID, + "CONTAINER_NAME": name, + } + extraAttrs := ctx.ExtraAttributes(strings.ToTitle) + for k, v := range extraAttrs { + vars[k] = v + } + return &journald{vars: vars, readers: readerList{readers: make(map[*logger.LogWatcher]*logger.LogWatcher)}}, nil +} + +// We don't actually accept any options, but we have to supply a callback for +// the factory to pass the (probably empty) configuration map to. +func validateLogOpt(cfg map[string]string) error { + for key := range cfg { + switch key { + case "labels": + case "env": + default: + return fmt.Errorf("unknown log opt '%s' for journald log driver", key) + } + } + return nil +} + +func (s *journald) Log(msg *logger.Message) error { + if msg.Source == "stderr" { + return journal.Send(string(msg.Line), journal.PriErr, s.vars) + } + return journal.Send(string(msg.Line), journal.PriInfo, s.vars) +} + +func (s *journald) Name() string { + return name +} diff --git a/daemon/logger/journald/journald_unsupported.go b/daemon/logger/journald/journald_unsupported.go new file mode 100644 index 0000000000..110833c23b --- /dev/null +++ b/daemon/logger/journald/journald_unsupported.go @@ -0,0 +1,3 @@ +// +build !linux + +package journald diff --git a/daemon/logger/journald/read.go b/daemon/logger/journald/read.go new file mode 100644 index 0000000000..80c1fbda7a --- /dev/null +++ b/daemon/logger/journald/read.go @@ -0,0 +1,299 @@ +// +build linux,cgo,!static_build,journald + +package journald + +// #cgo pkg-config: libsystemd-journal +// #include +// #include +// #include +// #include +// #include +// #include +// #include +// #include +// #include +// +//static int get_message(sd_journal *j, const char **msg, size_t *length) +//{ +// int rc; +// *msg = NULL; +// *length = 0; +// rc = sd_journal_get_data(j, "MESSAGE", (const void **) msg, length); +// if (rc == 0) { +// if (*length > 8) { +// (*msg) += 8; +// *length -= 8; +// } else { +// *msg = NULL; +// *length = 0; +// rc = -ENOENT; +// } +// } +// return rc; +//} +//static int get_priority(sd_journal *j, int *priority) +//{ +// const void *data; +// size_t i, length; +// int rc; +// *priority = -1; +// rc = sd_journal_get_data(j, "PRIORITY", &data, &length); +// if (rc == 0) { +// if ((length > 9) && (strncmp(data, "PRIORITY=", 9) == 0)) { +// *priority = 0; +// for (i = 9; i < length; i++) { +// *priority = *priority * 10 + ((const char *)data)[i] - '0'; +// } +// if (length > 9) { +// rc = 0; +// } +// } +// } +// return rc; +//} +//static int wait_for_data_or_close(sd_journal *j, int pipefd) +//{ +// struct pollfd fds[2]; +// uint64_t when = 0; +// int timeout, jevents, i; +// struct timespec ts; +// uint64_t now; +// do { +// memset(&fds, 0, sizeof(fds)); +// fds[0].fd = pipefd; +// fds[0].events = POLLHUP; +// fds[1].fd = sd_journal_get_fd(j); +// if (fds[1].fd < 0) { +// return -1; +// } +// jevents = sd_journal_get_events(j); +// if (jevents < 0) { +// return -1; +// } +// fds[1].events = jevents; +// sd_journal_get_timeout(j, &when); +// if (when == -1) { +// timeout = -1; +// } else { +// clock_gettime(CLOCK_MONOTONIC, &ts); +// now = (uint64_t) ts.tv_sec * 1000000 + ts.tv_nsec / 1000; +// timeout = when > now ? (int) ((when - now + 999) / 1000) : 0; +// } +// i = poll(fds, 2, timeout); +// if ((i == -1) && (errno != EINTR)) { +// /* An unexpected error. */ +// return -1; +// } +// if (fds[0].revents & POLLHUP) { +// /* The close notification pipe was closed. */ +// return 0; +// } +// if (sd_journal_process(j) == SD_JOURNAL_APPEND) { +// /* Data, which we might care about, was appended. */ +// return 1; +// } +// } while ((fds[0].revents & POLLHUP) == 0); +// return 0; +//} +import "C" + +import ( + "fmt" + "time" + "unsafe" + + "github.com/coreos/go-systemd/journal" + "github.com/docker/docker/daemon/logger" +) + +func (s *journald) Close() error { + s.readers.mu.Lock() + for reader := range s.readers.readers { + reader.Close() + } + s.readers.mu.Unlock() + return nil +} + +func (s *journald) drainJournal(logWatcher *logger.LogWatcher, config logger.ReadConfig, j *C.sd_journal, oldCursor string) string { + var msg, cursor *C.char + var length C.size_t + var stamp C.uint64_t + var priority C.int + + // Walk the journal from here forward until we run out of new entries. +drain: + for { + // Try not to send a given entry twice. + if oldCursor != "" { + ccursor := C.CString(oldCursor) + defer C.free(unsafe.Pointer(ccursor)) + for C.sd_journal_test_cursor(j, ccursor) > 0 { + if C.sd_journal_next(j) <= 0 { + break drain + } + } + } + // Read and send the logged message, if there is one to read. + i := C.get_message(j, &msg, &length) + if i != -C.ENOENT && i != -C.EADDRNOTAVAIL { + // Read the entry's timestamp. + if C.sd_journal_get_realtime_usec(j, &stamp) != 0 { + break + } + // Set up the time and text of the entry. + timestamp := time.Unix(int64(stamp)/1000000, (int64(stamp)%1000000)*1000) + line := append(C.GoBytes(unsafe.Pointer(msg), C.int(length)), "\n"...) + // Recover the stream name by mapping + // from the journal priority back to + // the stream that we would have + // assigned that value. + source := "" + if C.get_priority(j, &priority) != 0 { + source = "" + } else if priority == C.int(journal.PriErr) { + source = "stderr" + } else if priority == C.int(journal.PriInfo) { + source = "stdout" + } + // Send the log message. + cid := s.vars["CONTAINER_ID_FULL"] + logWatcher.Msg <- &logger.Message{ContainerID: cid, Line: line, Source: source, Timestamp: timestamp} + } + // If we're at the end of the journal, we're done (for now). + if C.sd_journal_next(j) <= 0 { + break + } + } + retCursor := "" + if C.sd_journal_get_cursor(j, &cursor) == 0 { + retCursor = C.GoString(cursor) + C.free(unsafe.Pointer(cursor)) + } + return retCursor +} + +func (s *journald) followJournal(logWatcher *logger.LogWatcher, config logger.ReadConfig, j *C.sd_journal, pfd [2]C.int, cursor string) { + go func() { + // Keep copying journal data out until we're notified to stop. + for C.wait_for_data_or_close(j, pfd[0]) == 1 { + cursor = s.drainJournal(logWatcher, config, j, cursor) + } + // Clean up. + C.close(pfd[0]) + s.readers.mu.Lock() + delete(s.readers.readers, logWatcher) + s.readers.mu.Unlock() + }() + s.readers.mu.Lock() + s.readers.readers[logWatcher] = logWatcher + s.readers.mu.Unlock() + // Wait until we're told to stop. + select { + case <-logWatcher.WatchClose(): + // Notify the other goroutine that its work is done. + C.close(pfd[1]) + } +} + +func (s *journald) readLogs(logWatcher *logger.LogWatcher, config logger.ReadConfig) { + var j *C.sd_journal + var cmatch *C.char + var stamp C.uint64_t + var sinceUnixMicro uint64 + var pipes [2]C.int + cursor := "" + + defer close(logWatcher.Msg) + // Get a handle to the journal. + rc := C.sd_journal_open(&j, C.int(0)) + if rc != 0 { + logWatcher.Err <- fmt.Errorf("error opening journal") + return + } + defer C.sd_journal_close(j) + // Remove limits on the size of data items that we'll retrieve. + rc = C.sd_journal_set_data_threshold(j, C.size_t(0)) + if rc != 0 { + logWatcher.Err <- fmt.Errorf("error setting journal data threshold") + return + } + // Add a match to have the library do the searching for us. + cmatch = C.CString("CONTAINER_ID_FULL=" + s.vars["CONTAINER_ID_FULL"]) + defer C.free(unsafe.Pointer(cmatch)) + rc = C.sd_journal_add_match(j, unsafe.Pointer(cmatch), C.strlen(cmatch)) + if rc != 0 { + logWatcher.Err <- fmt.Errorf("error setting journal match") + return + } + // If we have a cutoff time, convert it to Unix time once. + if !config.Since.IsZero() { + nano := config.Since.UnixNano() + sinceUnixMicro = uint64(nano / 1000) + } + if config.Tail > 0 { + lines := config.Tail + // Start at the end of the journal. + if C.sd_journal_seek_tail(j) < 0 { + logWatcher.Err <- fmt.Errorf("error seeking to end of journal") + return + } + if C.sd_journal_previous(j) < 0 { + logWatcher.Err <- fmt.Errorf("error backtracking to previous journal entry") + return + } + // Walk backward. + for lines > 0 { + // Stop if the entry time is before our cutoff. + // We'll need the entry time if it isn't, so go + // ahead and parse it now. + if C.sd_journal_get_realtime_usec(j, &stamp) != 0 { + break + } else { + // Compare the timestamp on the entry + // to our threshold value. + if sinceUnixMicro != 0 && sinceUnixMicro > uint64(stamp) { + break + } + } + lines-- + // If we're at the start of the journal, or + // don't need to back up past any more entries, + // stop. + if lines == 0 || C.sd_journal_previous(j) <= 0 { + break + } + } + } else { + // Start at the beginning of the journal. + if C.sd_journal_seek_head(j) < 0 { + logWatcher.Err <- fmt.Errorf("error seeking to start of journal") + return + } + // If we have a cutoff date, fast-forward to it. + if sinceUnixMicro != 0 && C.sd_journal_seek_realtime_usec(j, C.uint64_t(sinceUnixMicro)) != 0 { + logWatcher.Err <- fmt.Errorf("error seeking to start time in journal") + return + } + if C.sd_journal_next(j) < 0 { + logWatcher.Err <- fmt.Errorf("error skipping to next journal entry") + return + } + } + cursor = s.drainJournal(logWatcher, config, j, "") + if config.Follow { + // Create a pipe that we can poll at the same time as the journald descriptor. + if C.pipe(&pipes[0]) == C.int(-1) { + logWatcher.Err <- fmt.Errorf("error opening journald close notification pipe") + } else { + s.followJournal(logWatcher, config, j, pipes, cursor) + } + } + return +} + +func (s *journald) ReadLogs(config logger.ReadConfig) *logger.LogWatcher { + logWatcher := logger.NewLogWatcher() + go s.readLogs(logWatcher, config) + return logWatcher +} diff --git a/daemon/logger/journald/read_unsupported.go b/daemon/logger/journald/read_unsupported.go new file mode 100644 index 0000000000..b43abdcaf7 --- /dev/null +++ b/daemon/logger/journald/read_unsupported.go @@ -0,0 +1,7 @@ +// +build !linux !cgo static_build !journald + +package journald + +func (s *journald) Close() error { + return nil +} diff --git a/daemon/logger/jsonfilelog/jsonfilelog.go b/daemon/logger/jsonfilelog/jsonfilelog.go new file mode 100644 index 0000000000..490e84ca9c --- /dev/null +++ b/daemon/logger/jsonfilelog/jsonfilelog.go @@ -0,0 +1,409 @@ +// Package jsonfilelog provides the default Logger implementation for +// Docker logging. This logger logs to files on the host server in the +// JSON format. +package jsonfilelog + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "os" + "strconv" + "sync" + "time" + + "gopkg.in/fsnotify.v1" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/jsonlog" + "github.com/docker/docker/pkg/pubsub" + "github.com/docker/docker/pkg/tailfile" + "github.com/docker/docker/pkg/timeutils" + "github.com/docker/docker/pkg/units" +) + +const ( + // Name is the name of the file that the jsonlogger logs to. + Name = "json-file" + maxJSONDecodeRetry = 10 +) + +// JSONFileLogger is Logger implementation for default Docker logging. +type JSONFileLogger struct { + buf *bytes.Buffer + f *os.File // store for closing + mu sync.Mutex // protects buffer + capacity int64 //maximum size of each file + n int //maximum number of files + ctx logger.Context + readers map[*logger.LogWatcher]struct{} // stores the active log followers + notifyRotate *pubsub.Publisher + extra []byte // json-encoded extra attributes +} + +func init() { + if err := logger.RegisterLogDriver(Name, New); err != nil { + logrus.Fatal(err) + } + if err := logger.RegisterLogOptValidator(Name, ValidateLogOpt); err != nil { + logrus.Fatal(err) + } +} + +// New creates new JSONFileLogger which writes to filename passed in +// on given context. +func New(ctx logger.Context) (logger.Logger, error) { + log, err := os.OpenFile(ctx.LogPath, os.O_RDWR|os.O_APPEND|os.O_CREATE, 0600) + if err != nil { + return nil, err + } + var capval int64 = -1 + if capacity, ok := ctx.Config["max-size"]; ok { + var err error + capval, err = units.FromHumanSize(capacity) + if err != nil { + return nil, err + } + } + var maxFiles = 1 + if maxFileString, ok := ctx.Config["max-file"]; ok { + maxFiles, err = strconv.Atoi(maxFileString) + if err != nil { + return nil, err + } + if maxFiles < 1 { + return nil, fmt.Errorf("max-file cannot be less than 1") + } + } + + var extra []byte + if attrs := ctx.ExtraAttributes(nil); len(attrs) > 0 { + var err error + extra, err = json.Marshal(attrs) + if err != nil { + return nil, err + } + } + + return &JSONFileLogger{ + f: log, + buf: bytes.NewBuffer(nil), + ctx: ctx, + capacity: capval, + n: maxFiles, + readers: make(map[*logger.LogWatcher]struct{}), + notifyRotate: pubsub.NewPublisher(0, 1), + extra: extra, + }, nil +} + +// Log converts logger.Message to jsonlog.JSONLog and serializes it to file. +func (l *JSONFileLogger) Log(msg *logger.Message) error { + l.mu.Lock() + defer l.mu.Unlock() + + timestamp, err := timeutils.FastMarshalJSON(msg.Timestamp) + if err != nil { + return err + } + err = (&jsonlog.JSONLogs{ + Log: append(msg.Line, '\n'), + Stream: msg.Source, + Created: timestamp, + RawAttrs: l.extra, + }).MarshalJSONBuf(l.buf) + if err != nil { + return err + } + l.buf.WriteByte('\n') + _, err = writeLog(l) + return err +} + +func writeLog(l *JSONFileLogger) (int64, error) { + if l.capacity == -1 { + return writeToBuf(l) + } + meta, err := l.f.Stat() + if err != nil { + return -1, err + } + if meta.Size() >= l.capacity { + name := l.f.Name() + if err := l.f.Close(); err != nil { + return -1, err + } + if err := rotate(name, l.n); err != nil { + return -1, err + } + file, err := os.OpenFile(name, os.O_WRONLY|os.O_TRUNC|os.O_CREATE, 0666) + if err != nil { + return -1, err + } + l.f = file + l.notifyRotate.Publish(struct{}{}) + } + return writeToBuf(l) +} + +func writeToBuf(l *JSONFileLogger) (int64, error) { + i, err := l.buf.WriteTo(l.f) + if err != nil { + l.buf = bytes.NewBuffer(nil) + } + return i, err +} + +func rotate(name string, n int) error { + if n < 2 { + return nil + } + for i := n - 1; i > 1; i-- { + oldFile := name + "." + strconv.Itoa(i) + replacingFile := name + "." + strconv.Itoa(i-1) + if err := backup(oldFile, replacingFile); err != nil { + return err + } + } + if err := backup(name+".1", name); err != nil { + return err + } + return nil +} + +// backup renames a file from curr to old, creating an empty file curr if it does not exist. +func backup(old, curr string) error { + if _, err := os.Stat(old); !os.IsNotExist(err) { + err := os.Remove(old) + if err != nil { + return err + } + } + if _, err := os.Stat(curr); os.IsNotExist(err) { + f, err := os.Create(curr) + if err != nil { + return err + } + f.Close() + } + return os.Rename(curr, old) +} + +// ValidateLogOpt looks for json specific log options max-file & max-size. +func ValidateLogOpt(cfg map[string]string) error { + for key := range cfg { + switch key { + case "max-file": + case "max-size": + case "labels": + case "env": + default: + return fmt.Errorf("unknown log opt '%s' for json-file log driver", key) + } + } + return nil +} + +// LogPath returns the location the given json logger logs to. +func (l *JSONFileLogger) LogPath() string { + return l.ctx.LogPath +} + +// Close closes underlying file and signals all readers to stop. +func (l *JSONFileLogger) Close() error { + l.mu.Lock() + err := l.f.Close() + for r := range l.readers { + r.Close() + delete(l.readers, r) + } + l.mu.Unlock() + return err +} + +// Name returns name of this logger. +func (l *JSONFileLogger) Name() string { + return Name +} + +func decodeLogLine(dec *json.Decoder, l *jsonlog.JSONLog) (*logger.Message, error) { + l.Reset() + if err := dec.Decode(l); err != nil { + return nil, err + } + msg := &logger.Message{ + Source: l.Stream, + Timestamp: l.Created, + Line: []byte(l.Log), + } + return msg, nil +} + +// ReadLogs implements the logger's LogReader interface for the logs +// created by this driver. +func (l *JSONFileLogger) ReadLogs(config logger.ReadConfig) *logger.LogWatcher { + logWatcher := logger.NewLogWatcher() + + go l.readLogs(logWatcher, config) + return logWatcher +} + +func (l *JSONFileLogger) readLogs(logWatcher *logger.LogWatcher, config logger.ReadConfig) { + defer close(logWatcher.Msg) + + pth := l.ctx.LogPath + var files []io.ReadSeeker + for i := l.n; i > 1; i-- { + f, err := os.Open(fmt.Sprintf("%s.%d", pth, i-1)) + if err != nil { + if !os.IsNotExist(err) { + logWatcher.Err <- err + break + } + continue + } + defer f.Close() + files = append(files, f) + } + + latestFile, err := os.Open(pth) + if err != nil { + logWatcher.Err <- err + return + } + defer latestFile.Close() + + files = append(files, latestFile) + tailer := ioutils.MultiReadSeeker(files...) + + if config.Tail != 0 { + tailFile(tailer, logWatcher, config.Tail, config.Since) + } + + if !config.Follow { + return + } + + if config.Tail >= 0 { + latestFile.Seek(0, os.SEEK_END) + } + + l.mu.Lock() + l.readers[logWatcher] = struct{}{} + l.mu.Unlock() + + notifyRotate := l.notifyRotate.Subscribe() + followLogs(latestFile, logWatcher, notifyRotate, config.Since) + + l.mu.Lock() + delete(l.readers, logWatcher) + l.mu.Unlock() + + l.notifyRotate.Evict(notifyRotate) +} + +func tailFile(f io.ReadSeeker, logWatcher *logger.LogWatcher, tail int, since time.Time) { + var rdr io.Reader = f + if tail > 0 { + ls, err := tailfile.TailFile(f, tail) + if err != nil { + logWatcher.Err <- err + return + } + rdr = bytes.NewBuffer(bytes.Join(ls, []byte("\n"))) + } + dec := json.NewDecoder(rdr) + l := &jsonlog.JSONLog{} + for { + msg, err := decodeLogLine(dec, l) + if err != nil { + if err != io.EOF { + logWatcher.Err <- err + } + return + } + if !since.IsZero() && msg.Timestamp.Before(since) { + continue + } + logWatcher.Msg <- msg + } +} + +func followLogs(f *os.File, logWatcher *logger.LogWatcher, notifyRotate chan interface{}, since time.Time) { + dec := json.NewDecoder(f) + l := &jsonlog.JSONLog{} + fileWatcher, err := fsnotify.NewWatcher() + if err != nil { + logWatcher.Err <- err + return + } + defer fileWatcher.Close() + if err := fileWatcher.Add(f.Name()); err != nil { + logWatcher.Err <- err + return + } + + var retries int + for { + msg, err := decodeLogLine(dec, l) + if err != nil { + if err != io.EOF { + // try again because this shouldn't happen + if _, ok := err.(*json.SyntaxError); ok && retries <= maxJSONDecodeRetry { + dec = json.NewDecoder(f) + retries++ + continue + } + logWatcher.Err <- err + return + } + + select { + case <-fileWatcher.Events: + dec = json.NewDecoder(f) + continue + case <-fileWatcher.Errors: + logWatcher.Err <- err + return + case <-logWatcher.WatchClose(): + return + case <-notifyRotate: + fileWatcher.Remove(f.Name()) + + f, err = os.Open(f.Name()) + if err != nil { + logWatcher.Err <- err + return + } + if err := fileWatcher.Add(f.Name()); err != nil { + logWatcher.Err <- err + } + dec = json.NewDecoder(f) + continue + } + } + + retries = 0 // reset retries since we've succeeded + if !since.IsZero() && msg.Timestamp.Before(since) { + continue + } + select { + case logWatcher.Msg <- msg: + case <-logWatcher.WatchClose(): + logWatcher.Msg <- msg + for { + msg, err := decodeLogLine(dec, l) + if err != nil { + return + } + if !since.IsZero() && msg.Timestamp.Before(since) { + continue + } + logWatcher.Msg <- msg + } + } + } +} diff --git a/daemon/logger/jsonfilelog/jsonfilelog_test.go b/daemon/logger/jsonfilelog/jsonfilelog_test.go new file mode 100644 index 0000000000..162c685b24 --- /dev/null +++ b/daemon/logger/jsonfilelog/jsonfilelog_test.go @@ -0,0 +1,201 @@ +package jsonfilelog + +import ( + "encoding/json" + "io/ioutil" + "os" + "path/filepath" + "reflect" + "strconv" + "testing" + "time" + + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/pkg/jsonlog" +) + +func TestJSONFileLogger(t *testing.T) { + cid := "a7317399f3f857173c6179d44823594f8294678dea9999662e5c625b5a1c7657" + tmp, err := ioutil.TempDir("", "docker-logger-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + filename := filepath.Join(tmp, "container.log") + l, err := New(logger.Context{ + ContainerID: cid, + LogPath: filename, + }) + if err != nil { + t.Fatal(err) + } + defer l.Close() + + if err := l.Log(&logger.Message{ContainerID: cid, Line: []byte("line1"), Source: "src1"}); err != nil { + t.Fatal(err) + } + if err := l.Log(&logger.Message{ContainerID: cid, Line: []byte("line2"), Source: "src2"}); err != nil { + t.Fatal(err) + } + if err := l.Log(&logger.Message{ContainerID: cid, Line: []byte("line3"), Source: "src3"}); err != nil { + t.Fatal(err) + } + res, err := ioutil.ReadFile(filename) + if err != nil { + t.Fatal(err) + } + expected := `{"log":"line1\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line2\n","stream":"src2","time":"0001-01-01T00:00:00Z"} +{"log":"line3\n","stream":"src3","time":"0001-01-01T00:00:00Z"} +` + + if string(res) != expected { + t.Fatalf("Wrong log content: %q, expected %q", res, expected) + } +} + +func BenchmarkJSONFileLogger(b *testing.B) { + cid := "a7317399f3f857173c6179d44823594f8294678dea9999662e5c625b5a1c7657" + tmp, err := ioutil.TempDir("", "docker-logger-") + if err != nil { + b.Fatal(err) + } + defer os.RemoveAll(tmp) + filename := filepath.Join(tmp, "container.log") + l, err := New(logger.Context{ + ContainerID: cid, + LogPath: filename, + }) + if err != nil { + b.Fatal(err) + } + defer l.Close() + + testLine := "Line that thinks that it is log line from docker\n" + msg := &logger.Message{ContainerID: cid, Line: []byte(testLine), Source: "stderr", Timestamp: time.Now().UTC()} + jsonlog, err := (&jsonlog.JSONLog{Log: string(msg.Line) + "\n", Stream: msg.Source, Created: msg.Timestamp}).MarshalJSON() + if err != nil { + b.Fatal(err) + } + b.SetBytes(int64(len(jsonlog)+1) * 30) + b.ResetTimer() + for i := 0; i < b.N; i++ { + for j := 0; j < 30; j++ { + if err := l.Log(msg); err != nil { + b.Fatal(err) + } + } + } +} + +func TestJSONFileLoggerWithOpts(t *testing.T) { + cid := "a7317399f3f857173c6179d44823594f8294678dea9999662e5c625b5a1c7657" + tmp, err := ioutil.TempDir("", "docker-logger-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + filename := filepath.Join(tmp, "container.log") + config := map[string]string{"max-file": "2", "max-size": "1k"} + l, err := New(logger.Context{ + ContainerID: cid, + LogPath: filename, + Config: config, + }) + if err != nil { + t.Fatal(err) + } + defer l.Close() + for i := 0; i < 20; i++ { + if err := l.Log(&logger.Message{ContainerID: cid, Line: []byte("line" + strconv.Itoa(i)), Source: "src1"}); err != nil { + t.Fatal(err) + } + } + res, err := ioutil.ReadFile(filename) + if err != nil { + t.Fatal(err) + } + penUlt, err := ioutil.ReadFile(filename + ".1") + if err != nil { + t.Fatal(err) + } + + expectedPenultimate := `{"log":"line0\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line1\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line2\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line3\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line4\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line5\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line6\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line7\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line8\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line9\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line10\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line11\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line12\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line13\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line14\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line15\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +` + expected := `{"log":"line16\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line17\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line18\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +{"log":"line19\n","stream":"src1","time":"0001-01-01T00:00:00Z"} +` + + if string(res) != expected { + t.Fatalf("Wrong log content: %q, expected %q", res, expected) + } + if string(penUlt) != expectedPenultimate { + t.Fatalf("Wrong log content: %q, expected %q", penUlt, expectedPenultimate) + } + +} + +func TestJSONFileLoggerWithLabelsEnv(t *testing.T) { + cid := "a7317399f3f857173c6179d44823594f8294678dea9999662e5c625b5a1c7657" + tmp, err := ioutil.TempDir("", "docker-logger-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + filename := filepath.Join(tmp, "container.log") + config := map[string]string{"labels": "rack,dc", "env": "environ,debug,ssl"} + l, err := New(logger.Context{ + ContainerID: cid, + LogPath: filename, + Config: config, + ContainerLabels: map[string]string{"rack": "101", "dc": "lhr"}, + ContainerEnv: []string{"environ=production", "debug=false", "port=10001", "ssl=true"}, + }) + if err != nil { + t.Fatal(err) + } + defer l.Close() + if err := l.Log(&logger.Message{ContainerID: cid, Line: []byte("line"), Source: "src1"}); err != nil { + t.Fatal(err) + } + res, err := ioutil.ReadFile(filename) + if err != nil { + t.Fatal(err) + } + + var jsonLog jsonlog.JSONLogs + if err := json.Unmarshal(res, &jsonLog); err != nil { + t.Fatal(err) + } + extra := make(map[string]string) + if err := json.Unmarshal(jsonLog.RawAttrs, &extra); err != nil { + t.Fatal(err) + } + expected := map[string]string{ + "rack": "101", + "dc": "lhr", + "environ": "production", + "debug": "false", + "ssl": "true", + } + if !reflect.DeepEqual(extra, expected) { + t.Fatalf("Wrong log attrs: %q, expected %q", extra, expected) + } +} diff --git a/daemon/logger/logger.go b/daemon/logger/logger.go new file mode 100644 index 0000000000..5fc821e710 --- /dev/null +++ b/daemon/logger/logger.go @@ -0,0 +1,87 @@ +// Package logger defines interfaces that logger drivers implement to +// log messages. +// +// The other half of a logger driver is the implementation of the +// factory, which holds the contextual instance information that +// allows multiple loggers of the same type to perform different +// actions, such as logging to different locations. +package logger + +import ( + "errors" + "time" + + "github.com/docker/docker/pkg/timeutils" +) + +// ErrReadLogsNotSupported is returned when the logger does not support reading logs. +var ErrReadLogsNotSupported = errors.New("configured logging reader does not support reading") + +const ( + // TimeFormat is the time format used for timestamps sent to log readers. + TimeFormat = timeutils.RFC3339NanoFixed + logWatcherBufferSize = 4096 +) + +// Message is datastructure that represents record from some container. +type Message struct { + ContainerID string + Line []byte + Source string + Timestamp time.Time +} + +// Logger is the interface for docker logging drivers. +type Logger interface { + Log(*Message) error + Name() string + Close() error +} + +// ReadConfig is the configuration passed into ReadLogs. +type ReadConfig struct { + Since time.Time + Tail int + Follow bool +} + +// LogReader is the interface for reading log messages for loggers that support reading. +type LogReader interface { + // Read logs from underlying logging backend + ReadLogs(ReadConfig) *LogWatcher +} + +// LogWatcher is used when consuming logs read from the LogReader interface. +type LogWatcher struct { + // For sending log messages to a reader. + Msg chan *Message + // For sending error messages that occur while while reading logs. + Err chan error + closeNotifier chan struct{} +} + +// NewLogWatcher returns a new LogWatcher. +func NewLogWatcher() *LogWatcher { + return &LogWatcher{ + Msg: make(chan *Message, logWatcherBufferSize), + Err: make(chan error, 1), + closeNotifier: make(chan struct{}), + } +} + +// Close notifies the underlying log reader to stop. +func (w *LogWatcher) Close() { + // only close if not already closed + select { + case <-w.closeNotifier: + default: + close(w.closeNotifier) + } +} + +// WatchClose returns a channel receiver that receives notification +// when the watcher has been closed. This should only be called from +// one goroutine. +func (w *LogWatcher) WatchClose() <-chan struct{} { + return w.closeNotifier +} diff --git a/daemon/logger/loggerutils/log_tag.go b/daemon/logger/loggerutils/log_tag.go new file mode 100644 index 0000000000..df24379acf --- /dev/null +++ b/daemon/logger/loggerutils/log_tag.go @@ -0,0 +1,46 @@ +package loggerutils + +import ( + "bytes" + "fmt" + "text/template" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/logger" +) + +// ParseLogTag generates a context aware tag for consistency across different +// log drivers based on the context of the running container. +func ParseLogTag(ctx logger.Context, defaultTemplate string) (string, error) { + tagTemplate := lookupTagTemplate(ctx, defaultTemplate) + + tmpl, err := template.New("log-tag").Parse(tagTemplate) + if err != nil { + return "", err + } + buf := new(bytes.Buffer) + if err := tmpl.Execute(buf, &ctx); err != nil { + return "", err + } + + return buf.String(), nil +} + +func lookupTagTemplate(ctx logger.Context, defaultTemplate string) string { + tagTemplate := ctx.Config["tag"] + + deprecatedConfigs := []string{"syslog-tag", "gelf-tag", "fluentd-tag"} + for i := 0; tagTemplate == "" && i < len(deprecatedConfigs); i++ { + cfg := deprecatedConfigs[i] + if ctx.Config[cfg] != "" { + tagTemplate = ctx.Config[cfg] + logrus.Warn(fmt.Sprintf("Using log tag from deprecated log-opt '%s'. Please use: --log-opt tag=\"%s\"", cfg, tagTemplate)) + } + } + + if tagTemplate == "" { + tagTemplate = defaultTemplate + } + + return tagTemplate +} diff --git a/daemon/logger/loggerutils/log_tag_test.go b/daemon/logger/loggerutils/log_tag_test.go new file mode 100644 index 0000000000..994508b161 --- /dev/null +++ b/daemon/logger/loggerutils/log_tag_test.go @@ -0,0 +1,58 @@ +package loggerutils + +import ( + "testing" + + "github.com/docker/docker/daemon/logger" +) + +func TestParseLogTagDefaultTag(t *testing.T) { + ctx := buildContext(map[string]string{}) + tag, e := ParseLogTag(ctx, "{{.ID}}") + assertTag(t, e, tag, ctx.ID()) +} + +func TestParseLogTag(t *testing.T) { + ctx := buildContext(map[string]string{"tag": "{{.ImageName}}/{{.Name}}/{{.ID}}"}) + tag, e := ParseLogTag(ctx, "{{.ID}}") + assertTag(t, e, tag, "test-image/test-container/container-ab") +} + +func TestParseLogTagSyslogTag(t *testing.T) { + ctx := buildContext(map[string]string{"syslog-tag": "{{.ImageName}}/{{.Name}}/{{.ID}}"}) + tag, e := ParseLogTag(ctx, "{{.ID}}") + assertTag(t, e, tag, "test-image/test-container/container-ab") +} + +func TestParseLogTagGelfTag(t *testing.T) { + ctx := buildContext(map[string]string{"gelf-tag": "{{.ImageName}}/{{.Name}}/{{.ID}}"}) + tag, e := ParseLogTag(ctx, "{{.ID}}") + assertTag(t, e, tag, "test-image/test-container/container-ab") +} + +func TestParseLogTagFluentdTag(t *testing.T) { + ctx := buildContext(map[string]string{"fluentd-tag": "{{.ImageName}}/{{.Name}}/{{.ID}}"}) + tag, e := ParseLogTag(ctx, "{{.ID}}") + assertTag(t, e, tag, "test-image/test-container/container-ab") +} + +// Helpers + +func buildContext(cfg map[string]string) logger.Context { + return logger.Context{ + ContainerID: "container-abcdefghijklmnopqrstuvwxyz01234567890", + ContainerName: "/test-container", + ContainerImageID: "image-abcdefghijklmnopqrstuvwxyz01234567890", + ContainerImageName: "test-image", + Config: cfg, + } +} + +func assertTag(t *testing.T, e error, tag string, expected string) { + if e != nil { + t.Fatalf("Error generating tag: %q", e) + } + if tag != expected { + t.Fatalf("Wrong tag: %q, should be %q", tag, expected) + } +} diff --git a/daemon/logger/syslog/syslog.go b/daemon/logger/syslog/syslog.go new file mode 100644 index 0000000000..7d052a662f --- /dev/null +++ b/daemon/logger/syslog/syslog.go @@ -0,0 +1,179 @@ +// +build linux + +// Package syslog provides the logdriver for forwarding server logs to syslog endpoints. +package syslog + +import ( + "errors" + "fmt" + "log/syslog" + "net" + "net/url" + "os" + "path" + "strconv" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/daemon/logger/loggerutils" + "github.com/docker/docker/pkg/urlutil" +) + +const name = "syslog" + +var facilities = map[string]syslog.Priority{ + "kern": syslog.LOG_KERN, + "user": syslog.LOG_USER, + "mail": syslog.LOG_MAIL, + "daemon": syslog.LOG_DAEMON, + "auth": syslog.LOG_AUTH, + "syslog": syslog.LOG_SYSLOG, + "lpr": syslog.LOG_LPR, + "news": syslog.LOG_NEWS, + "uucp": syslog.LOG_UUCP, + "cron": syslog.LOG_CRON, + "authpriv": syslog.LOG_AUTHPRIV, + "ftp": syslog.LOG_FTP, + "local0": syslog.LOG_LOCAL0, + "local1": syslog.LOG_LOCAL1, + "local2": syslog.LOG_LOCAL2, + "local3": syslog.LOG_LOCAL3, + "local4": syslog.LOG_LOCAL4, + "local5": syslog.LOG_LOCAL5, + "local6": syslog.LOG_LOCAL6, + "local7": syslog.LOG_LOCAL7, +} + +type syslogger struct { + writer *syslog.Writer +} + +func init() { + if err := logger.RegisterLogDriver(name, New); err != nil { + logrus.Fatal(err) + } + if err := logger.RegisterLogOptValidator(name, ValidateLogOpt); err != nil { + logrus.Fatal(err) + } +} + +// New creates a syslog logger using the configuration passed in on +// the context. Supported context configuration variables are +// syslog-address, syslog-facility, & syslog-tag. +func New(ctx logger.Context) (logger.Logger, error) { + tag, err := loggerutils.ParseLogTag(ctx, "{{.ID}}") + if err != nil { + return nil, err + } + + proto, address, err := parseAddress(ctx.Config["syslog-address"]) + if err != nil { + return nil, err + } + + facility, err := parseFacility(ctx.Config["syslog-facility"]) + if err != nil { + return nil, err + } + + log, err := syslog.Dial( + proto, + address, + facility, + path.Base(os.Args[0])+"/"+tag, + ) + if err != nil { + return nil, err + } + + return &syslogger{ + writer: log, + }, nil +} + +func (s *syslogger) Log(msg *logger.Message) error { + if msg.Source == "stderr" { + return s.writer.Err(string(msg.Line)) + } + return s.writer.Info(string(msg.Line)) +} + +func (s *syslogger) Close() error { + return s.writer.Close() +} + +func (s *syslogger) Name() string { + return name +} + +func parseAddress(address string) (string, string, error) { + if address == "" { + return "", "", nil + } + if !urlutil.IsTransportURL(address) { + return "", "", fmt.Errorf("syslog-address should be in form proto://address, got %v", address) + } + url, err := url.Parse(address) + if err != nil { + return "", "", err + } + + // unix socket validation + if url.Scheme == "unix" { + if _, err := os.Stat(url.Path); err != nil { + return "", "", err + } + return url.Scheme, url.Path, nil + } + + // here we process tcp|udp + host := url.Host + if _, _, err := net.SplitHostPort(host); err != nil { + if !strings.Contains(err.Error(), "missing port in address") { + return "", "", err + } + host = host + ":514" + } + + return url.Scheme, host, nil +} + +// ValidateLogOpt looks for syslog specific log options +// syslog-address, syslog-facility, & syslog-tag. +func ValidateLogOpt(cfg map[string]string) error { + for key := range cfg { + switch key { + case "syslog-address": + case "syslog-facility": + case "syslog-tag": + case "tag": + default: + return fmt.Errorf("unknown log opt '%s' for syslog log driver", key) + } + } + if _, _, err := parseAddress(cfg["syslog-address"]); err != nil { + return err + } + if _, err := parseFacility(cfg["syslog-facility"]); err != nil { + return err + } + return nil +} + +func parseFacility(facility string) (syslog.Priority, error) { + if facility == "" { + return syslog.LOG_DAEMON, nil + } + + if syslogFacility, valid := facilities[facility]; valid { + return syslogFacility, nil + } + + fInt, err := strconv.Atoi(facility) + if err == nil && 0 <= fInt && fInt <= 23 { + return syslog.Priority(fInt << 3), nil + } + + return syslog.Priority(0), errors.New("invalid syslog facility") +} diff --git a/daemon/logger/syslog/syslog_unsupported.go b/daemon/logger/syslog/syslog_unsupported.go new file mode 100644 index 0000000000..50cc51b657 --- /dev/null +++ b/daemon/logger/syslog/syslog_unsupported.go @@ -0,0 +1,3 @@ +// +build !linux + +package syslog diff --git a/daemon/logs.go b/daemon/logs.go new file mode 100644 index 0000000000..e4a4853c39 --- /dev/null +++ b/daemon/logs.go @@ -0,0 +1,99 @@ +package daemon + +import ( + "io" + "strconv" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/logger" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/stdcopy" +) + +// ContainerLogsConfig holds configs for logging operations. Exists +// for users of the daemon to to pass it a logging configuration. +type ContainerLogsConfig struct { + // if true stream log output + Follow bool + // if true include timestamps for each line of log output + Timestamps bool + // return that many lines of log output from the end + Tail string + // filter logs by returning on those entries after this time + Since time.Time + // whether or not to show stdout and stderr as well as log entries. + UseStdout, UseStderr bool + OutStream io.Writer + Stop <-chan bool +} + +// ContainerLogs hooks up a container's stdout and stderr streams +// configured with the given struct. +func (daemon *Daemon) ContainerLogs(containerName string, config *ContainerLogsConfig) error { + container, err := daemon.Get(containerName) + if err != nil { + return derr.ErrorCodeNoSuchContainer.WithArgs(containerName) + } + + if !(config.UseStdout || config.UseStderr) { + return derr.ErrorCodeNeedStream + } + + outStream := config.OutStream + errStream := outStream + if !container.Config.Tty { + errStream = stdcopy.NewStdWriter(outStream, stdcopy.Stderr) + outStream = stdcopy.NewStdWriter(outStream, stdcopy.Stdout) + } + config.OutStream = outStream + + cLog, err := container.getLogger() + if err != nil { + return err + } + logReader, ok := cLog.(logger.LogReader) + if !ok { + return logger.ErrReadLogsNotSupported + } + + follow := config.Follow && container.IsRunning() + tailLines, err := strconv.Atoi(config.Tail) + if err != nil { + tailLines = -1 + } + + logrus.Debug("logs: begin stream") + readConfig := logger.ReadConfig{ + Since: config.Since, + Tail: tailLines, + Follow: follow, + } + logs := logReader.ReadLogs(readConfig) + + for { + select { + case err := <-logs.Err: + logrus.Errorf("Error streaming logs: %v", err) + return nil + case <-config.Stop: + logs.Close() + return nil + case msg, ok := <-logs.Msg: + if !ok { + logrus.Debugf("logs: end stream") + return nil + } + logLine := msg.Line + if config.Timestamps { + logLine = append([]byte(msg.Timestamp.Format(logger.TimeFormat)+" "), logLine...) + } + if msg.Source == "stdout" && config.UseStdout { + outStream.Write(logLine) + } + if msg.Source == "stderr" && config.UseStderr { + errStream.Write(logLine) + } + } + } +} diff --git a/daemon/monitor.go b/daemon/monitor.go new file mode 100644 index 0000000000..4af0d2a2fd --- /dev/null +++ b/daemon/monitor.go @@ -0,0 +1,347 @@ +package daemon + +import ( + "io" + "os/exec" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/runconfig" +) + +const ( + defaultTimeIncrement = 100 + loggerCloseTimeout = 10 * time.Second +) + +// containerMonitor monitors the execution of a container's main process. +// If a restart policy is specified for the container the monitor will ensure that the +// process is restarted based on the rules of the policy. When the container is finally stopped +// the monitor will reset and cleanup any of the container resources such as networking allocations +// and the rootfs +type containerMonitor struct { + mux sync.Mutex + + // container is the container being monitored + container *Container + + // restartPolicy is the current policy being applied to the container monitor + restartPolicy runconfig.RestartPolicy + + // failureCount is the number of times the container has failed to + // start in a row + failureCount int + + // shouldStop signals the monitor that the next time the container exits it is + // either because docker or the user asked for the container to be stopped + shouldStop bool + + // startSignal is a channel that is closes after the container initially starts + startSignal chan struct{} + + // stopChan is used to signal to the monitor whenever there is a wait for the + // next restart so that the timeIncrement is not honored and the user is not + // left waiting for nothing to happen during this time + stopChan chan struct{} + + // timeIncrement is the amount of time to wait between restarts + // this is in milliseconds + timeIncrement int + + // lastStartTime is the time which the monitor last exec'd the container's process + lastStartTime time.Time +} + +// newContainerMonitor returns an initialized containerMonitor for the provided container +// honoring the provided restart policy +func newContainerMonitor(container *Container, policy runconfig.RestartPolicy) *containerMonitor { + return &containerMonitor{ + container: container, + restartPolicy: policy, + timeIncrement: defaultTimeIncrement, + stopChan: make(chan struct{}), + startSignal: make(chan struct{}), + } +} + +// Stop signals to the container monitor that it should stop monitoring the container +// for exits the next time the process dies +func (m *containerMonitor) ExitOnNext() { + m.mux.Lock() + + // we need to protect having a double close of the channel when stop is called + // twice or else we will get a panic + if !m.shouldStop { + m.shouldStop = true + close(m.stopChan) + } + + m.mux.Unlock() +} + +// Close closes the container's resources such as networking allocations and +// unmounts the contatiner's root filesystem +func (m *containerMonitor) Close() error { + // Cleanup networking and mounts + m.container.cleanup() + + // FIXME: here is race condition between two RUN instructions in Dockerfile + // because they share same runconfig and change image. Must be fixed + // in builder/builder.go + if err := m.container.toDisk(); err != nil { + logrus.Errorf("Error dumping container %s state to disk: %s", m.container.ID, err) + + return err + } + + return nil +} + +// Start starts the containers process and monitors it according to the restart policy +func (m *containerMonitor) Start() error { + var ( + err error + exitStatus execdriver.ExitStatus + // this variable indicates where we in execution flow: + // before Run or after + afterRun bool + ) + + // ensure that when the monitor finally exits we release the networking and unmount the rootfs + defer func() { + if afterRun { + m.container.Lock() + m.container.setStopped(&exitStatus) + defer m.container.Unlock() + } + m.Close() + }() + // reset stopped flag + if m.container.HasBeenManuallyStopped { + m.container.HasBeenManuallyStopped = false + } + + // reset the restart count + m.container.RestartCount = -1 + + for { + m.container.RestartCount++ + + if err := m.container.startLogging(); err != nil { + m.resetContainer(false) + + return err + } + + pipes := execdriver.NewPipes(m.container.stdin, m.container.stdout, m.container.stderr, m.container.Config.OpenStdin) + + m.container.logEvent("start") + + m.lastStartTime = time.Now() + + if exitStatus, err = m.container.daemon.run(m.container, pipes, m.callback); err != nil { + // if we receive an internal error from the initial start of a container then lets + // return it instead of entering the restart loop + if m.container.RestartCount == 0 { + m.container.ExitCode = -1 + m.resetContainer(false) + + return err + } + + logrus.Errorf("Error running container: %s", err) + } + + // here container.Lock is already lost + afterRun = true + + m.resetMonitor(err == nil && exitStatus.ExitCode == 0) + + if m.shouldRestart(exitStatus.ExitCode) { + m.container.setRestarting(&exitStatus) + m.container.logEvent("die") + m.resetContainer(true) + + // sleep with a small time increment between each restart to help avoid issues cased by quickly + // restarting the container because of some types of errors ( networking cut out, etc... ) + m.waitForNextRestart() + + // we need to check this before reentering the loop because the waitForNextRestart could have + // been terminated by a request from a user + if m.shouldStop { + return err + } + continue + } + + m.container.logEvent("die") + m.resetContainer(true) + return err + } +} + +// resetMonitor resets the stateful fields on the containerMonitor based on the +// previous runs success or failure. Regardless of success, if the container had +// an execution time of more than 10s then reset the timer back to the default +func (m *containerMonitor) resetMonitor(successful bool) { + executionTime := time.Now().Sub(m.lastStartTime).Seconds() + + if executionTime > 10 { + m.timeIncrement = defaultTimeIncrement + } else { + // otherwise we need to increment the amount of time we wait before restarting + // the process. We will build up by multiplying the increment by 2 + m.timeIncrement *= 2 + } + + // the container exited successfully so we need to reset the failure counter + if successful { + m.failureCount = 0 + } else { + m.failureCount++ + } +} + +// waitForNextRestart waits with the default time increment to restart the container unless +// a user or docker asks for the container to be stopped +func (m *containerMonitor) waitForNextRestart() { + select { + case <-time.After(time.Duration(m.timeIncrement) * time.Millisecond): + case <-m.stopChan: + } +} + +// shouldRestart checks the restart policy and applies the rules to determine if +// the container's process should be restarted +func (m *containerMonitor) shouldRestart(exitCode int) bool { + m.mux.Lock() + defer m.mux.Unlock() + + // do not restart if the user or docker has requested that this container be stopped + if m.shouldStop { + m.container.HasBeenManuallyStopped = !m.container.daemon.shutdown + return false + } + + switch { + case m.restartPolicy.IsAlways(), m.restartPolicy.IsUnlessStopped(): + return true + case m.restartPolicy.IsOnFailure(): + // the default value of 0 for MaximumRetryCount means that we will not enforce a maximum count + if max := m.restartPolicy.MaximumRetryCount; max != 0 && m.failureCount > max { + logrus.Debugf("stopping restart of container %s because maximum failure could of %d has been reached", + stringid.TruncateID(m.container.ID), max) + return false + } + + return exitCode != 0 + } + + return false +} + +// callback ensures that the container's state is properly updated after we +// received ack from the execution drivers +func (m *containerMonitor) callback(processConfig *execdriver.ProcessConfig, pid int, chOOM <-chan struct{}) error { + go func() { + _, ok := <-chOOM + if ok { + m.container.logEvent("oom") + } + }() + + if processConfig.Tty { + // The callback is called after the process Start() + // so we are in the parent process. In TTY mode, stdin/out/err is the PtySlave + // which we close here. + if c, ok := processConfig.Stdout.(io.Closer); ok { + c.Close() + } + } + + m.container.setRunning(pid) + + // signal that the process has started + // close channel only if not closed + select { + case <-m.startSignal: + default: + close(m.startSignal) + } + + if err := m.container.toDiskLocking(); err != nil { + logrus.Errorf("Error saving container to disk: %v", err) + } + return nil +} + +// resetContainer resets the container's IO and ensures that the command is able to be executed again +// by copying the data into a new struct +// if lock is true, then container locked during reset +func (m *containerMonitor) resetContainer(lock bool) { + container := m.container + if lock { + container.Lock() + defer container.Unlock() + } + + if container.Config.OpenStdin { + if err := container.stdin.Close(); err != nil { + logrus.Errorf("%s: Error close stdin: %s", container.ID, err) + } + } + + if err := container.stdout.Clean(); err != nil { + logrus.Errorf("%s: Error close stdout: %s", container.ID, err) + } + + if err := container.stderr.Clean(); err != nil { + logrus.Errorf("%s: Error close stderr: %s", container.ID, err) + } + + if container.command != nil && container.command.ProcessConfig.Terminal != nil { + if err := container.command.ProcessConfig.Terminal.Close(); err != nil { + logrus.Errorf("%s: Error closing terminal: %s", container.ID, err) + } + } + + // Re-create a brand new stdin pipe once the container exited + if container.Config.OpenStdin { + container.stdin, container.stdinPipe = io.Pipe() + } + + if container.logDriver != nil { + if container.logCopier != nil { + exit := make(chan struct{}) + go func() { + container.logCopier.Wait() + close(exit) + }() + select { + case <-time.After(loggerCloseTimeout): + logrus.Warnf("Logger didn't exit in time: logs may be truncated") + case <-exit: + } + } + container.logDriver.Close() + container.logCopier = nil + container.logDriver = nil + } + + c := container.command.ProcessConfig.Cmd + + container.command.ProcessConfig.Cmd = exec.Cmd{ + Stdin: c.Stdin, + Stdout: c.Stdout, + Stderr: c.Stderr, + Path: c.Path, + Env: c.Env, + ExtraFiles: c.ExtraFiles, + Args: c.Args, + Dir: c.Dir, + SysProcAttr: c.SysProcAttr, + } +} diff --git a/daemon/network.go b/daemon/network.go new file mode 100644 index 0000000000..845946705e --- /dev/null +++ b/daemon/network.go @@ -0,0 +1,127 @@ +package daemon + +import ( + "errors" + "fmt" + "net" + "strings" + + "github.com/docker/docker/daemon/network" + "github.com/docker/libnetwork" +) + +const ( + // NetworkByID represents a constant to find a network by its ID + NetworkByID = iota + 1 + // NetworkByName represents a constant to find a network by its Name + NetworkByName +) + +// NetworkControllerEnabled checks if the networking stack is enabled. +// This feature depends on OS primitives and it's dissabled in systems like Windows. +func (daemon *Daemon) NetworkControllerEnabled() bool { + return daemon.netController != nil +} + +// FindNetwork function finds a network for a given string that can represent network name or id +func (daemon *Daemon) FindNetwork(idName string) (libnetwork.Network, error) { + // Find by Name + n, err := daemon.GetNetwork(idName, NetworkByName) + if _, ok := err.(libnetwork.ErrNoSuchNetwork); err != nil && !ok { + return nil, err + } + + if n != nil { + return n, nil + } + + // Find by id + n, err = daemon.GetNetwork(idName, NetworkByID) + if err != nil { + return nil, err + } + + return n, nil +} + +// GetNetwork function returns a network for a given string that represents the network and +// a hint to indicate if the string is an Id or Name of the network +func (daemon *Daemon) GetNetwork(idName string, by int) (libnetwork.Network, error) { + c := daemon.netController + switch by { + case NetworkByID: + list := daemon.GetNetworksByID(idName) + + if len(list) == 0 { + return nil, libnetwork.ErrNoSuchNetwork(idName) + } + + if len(list) > 1 { + return nil, libnetwork.ErrInvalidID(idName) + } + + return list[0], nil + case NetworkByName: + if idName == "" { + idName = c.Config().Daemon.DefaultNetwork + } + return c.NetworkByName(idName) + } + return nil, errors.New("unexpected selector for GetNetwork") +} + +// GetNetworksByID returns a list of networks whose ID partially matches zero or more networks +func (daemon *Daemon) GetNetworksByID(partialID string) []libnetwork.Network { + c := daemon.netController + list := []libnetwork.Network{} + l := func(nw libnetwork.Network) bool { + if strings.HasPrefix(nw.ID(), partialID) { + list = append(list, nw) + } + return false + } + c.WalkNetworks(l) + + return list +} + +// CreateNetwork creates a network with the given name, driver and other optional parameters +func (daemon *Daemon) CreateNetwork(name, driver string, ipam network.IPAM, options map[string]string) (libnetwork.Network, error) { + c := daemon.netController + if driver == "" { + driver = c.Config().Daemon.DefaultDriver + } + + nwOptions := []libnetwork.NetworkOption{} + + v4Conf, v6Conf, err := getIpamConfig(ipam.Config) + if err != nil { + return nil, err + } + + nwOptions = append(nwOptions, libnetwork.NetworkOptionIpam(ipam.Driver, "", v4Conf, v6Conf)) + nwOptions = append(nwOptions, libnetwork.NetworkOptionDriverOpts(options)) + return c.NewNetwork(driver, name, nwOptions...) +} + +func getIpamConfig(data []network.IPAMConfig) ([]*libnetwork.IpamConf, []*libnetwork.IpamConf, error) { + ipamV4Cfg := []*libnetwork.IpamConf{} + ipamV6Cfg := []*libnetwork.IpamConf{} + for _, d := range data { + iCfg := libnetwork.IpamConf{} + iCfg.PreferredPool = d.Subnet + iCfg.SubPool = d.IPRange + iCfg.Gateway = d.Gateway + iCfg.AuxAddresses = d.AuxAddress + ip, _, err := net.ParseCIDR(d.Subnet) + if err != nil { + return nil, nil, fmt.Errorf("Invalid subnet %s : %v", d.Subnet, err) + } + if ip.To4() != nil { + ipamV4Cfg = append(ipamV4Cfg, &iCfg) + } else { + ipamV6Cfg = append(ipamV6Cfg, &iCfg) + } + } + return ipamV4Cfg, ipamV6Cfg, nil +} diff --git a/daemon/network/settings.go b/daemon/network/settings.go new file mode 100644 index 0000000000..ddc87a7c72 --- /dev/null +++ b/daemon/network/settings.go @@ -0,0 +1,51 @@ +package network + +import "github.com/docker/docker/pkg/nat" + +// Address represents an IP address +type Address struct { + Addr string + PrefixLen int +} + +// IPAM represents IP Address Management +type IPAM struct { + Driver string + Config []IPAMConfig +} + +// IPAMConfig represents IPAM configurations +type IPAMConfig struct { + Subnet string `json:",omitempty"` + IPRange string `json:",omitempty"` + Gateway string `json:",omitempty"` + AuxAddress map[string]string `json:"AuxiliaryAddresses,omitempty"` +} + +// Settings stores configuration details about the daemon network config +// TODO Windows. Many of these fields can be factored out., +type Settings struct { + Bridge string + SandboxID string + HairpinMode bool + LinkLocalIPv6Address string + LinkLocalIPv6PrefixLen int + Networks map[string]*EndpointSettings + Ports nat.PortMap + SandboxKey string + SecondaryIPAddresses []Address + SecondaryIPv6Addresses []Address + IsAnonymousEndpoint bool +} + +// EndpointSettings stores the network endpoint details +type EndpointSettings struct { + EndpointID string + Gateway string + IPAddress string + IPPrefixLen int + IPv6Gateway string + GlobalIPv6Address string + GlobalIPv6PrefixLen int + MacAddress string +} diff --git a/daemon/pause.go b/daemon/pause.go new file mode 100644 index 0000000000..385e93f9f9 --- /dev/null +++ b/daemon/pause.go @@ -0,0 +1,19 @@ +package daemon + +import ( + derr "github.com/docker/docker/errors" +) + +// ContainerPause pauses a container +func (daemon *Daemon) ContainerPause(name string) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + if err := container.pause(); err != nil { + return derr.ErrorCodePauseError.WithArgs(name, err) + } + + return nil +} diff --git a/daemon/rename.go b/daemon/rename.go new file mode 100644 index 0000000000..1aab1f9303 --- /dev/null +++ b/daemon/rename.go @@ -0,0 +1,83 @@ +package daemon + +import ( + "github.com/Sirupsen/logrus" + derr "github.com/docker/docker/errors" + "github.com/docker/libnetwork" + "strings" +) + +// ContainerRename changes the name of a container, using the oldName +// to find the container. An error is returned if newName is already +// reserved. +func (daemon *Daemon) ContainerRename(oldName, newName string) error { + var ( + err error + sid string + sb libnetwork.Sandbox + container *Container + ) + + if oldName == "" || newName == "" { + return derr.ErrorCodeEmptyRename + } + + container, err = daemon.Get(oldName) + if err != nil { + return err + } + + oldName = container.Name + + container.Lock() + defer container.Unlock() + if newName, err = daemon.reserveName(container.ID, newName); err != nil { + return derr.ErrorCodeRenameTaken.WithArgs(err) + } + + container.Name = newName + + defer func() { + if err != nil { + container.Name = oldName + daemon.reserveName(container.ID, oldName) + daemon.containerGraphDB.Delete(newName) + } + }() + + if err = daemon.containerGraphDB.Delete(oldName); err != nil { + return derr.ErrorCodeRenameDelete.WithArgs(oldName, err) + } + + if err = container.toDisk(); err != nil { + return err + } + + if !container.Running { + container.logEvent("rename") + return nil + } + + defer func() { + if err != nil { + container.Name = oldName + if e := container.toDisk(); e != nil { + logrus.Errorf("%s: Failed in writing to Disk on rename failure: %v", container.ID, e) + } + } + }() + + sid = container.NetworkSettings.SandboxID + sb, err = daemon.netController.SandboxByID(sid) + if err != nil { + return err + } + + err = sb.Rename(strings.TrimPrefix(container.Name, "/")) + if err != nil { + return err + } + + container.logEvent("rename") + return nil +} diff --git a/daemon/resize.go b/daemon/resize.go new file mode 100644 index 0000000000..199bc48b43 --- /dev/null +++ b/daemon/resize.go @@ -0,0 +1,24 @@ +package daemon + +// ContainerResize changes the size of the TTY of the process running +// in the container with the given name to the given height and width. +func (daemon *Daemon) ContainerResize(name string, height, width int) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + return container.Resize(height, width) +} + +// ContainerExecResize changes the size of the TTY of the process +// running in the exec with the given name to the given height and +// width. +func (daemon *Daemon) ContainerExecResize(name string, height, width int) error { + ExecConfig, err := daemon.getExecConfig(name) + if err != nil { + return err + } + + return ExecConfig.resize(height, width) +} diff --git a/daemon/restart.go b/daemon/restart.go new file mode 100644 index 0000000000..86ec88dbb1 --- /dev/null +++ b/daemon/restart.go @@ -0,0 +1,22 @@ +package daemon + +import ( + derr "github.com/docker/docker/errors" +) + +// ContainerRestart stops and starts a container. It attempts to +// gracefully stop the container within the given timeout, forcefully +// stopping it if the timeout is exceeded. If given a negative +// timeout, ContainerRestart will wait forever until a graceful +// stop. Returns an error if the container cannot be found, or if +// there is an underlying error at any stage of the restart. +func (daemon *Daemon) ContainerRestart(name string, seconds int) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + if err := container.Restart(seconds); err != nil { + return derr.ErrorCodeCantRestart.WithArgs(name, err) + } + return nil +} diff --git a/daemon/start.go b/daemon/start.go new file mode 100644 index 0000000000..6eec10da28 --- /dev/null +++ b/daemon/start.go @@ -0,0 +1,52 @@ +package daemon + +import ( + "runtime" + + derr "github.com/docker/docker/errors" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" +) + +// ContainerStart starts a container. +func (daemon *Daemon) ContainerStart(name string, hostConfig *runconfig.HostConfig) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + if container.isPaused() { + return derr.ErrorCodeStartPaused + } + + if container.IsRunning() { + return derr.ErrorCodeAlreadyStarted + } + + // Windows does not have the backwards compatibility issue here. + if runtime.GOOS != "windows" { + // This is kept for backward compatibility - hostconfig should be passed when + // creating a container, not during start. + if hostConfig != nil { + if err := daemon.setHostConfig(container, hostConfig); err != nil { + return err + } + } + } else { + if hostConfig != nil { + return derr.ErrorCodeHostConfigStart + } + } + + // check if hostConfig is in line with the current system settings. + // It may happen cgroups are umounted or the like. + if _, err = daemon.verifyContainerSettings(container.hostConfig, nil); err != nil { + return err + } + + if err := container.Start(); err != nil { + return derr.ErrorCodeCantStart.WithArgs(name, utils.GetErrorMessage(err)) + } + + return nil +} diff --git a/daemon/state.go b/daemon/state.go new file mode 100644 index 0000000000..c3969d3b29 --- /dev/null +++ b/daemon/state.go @@ -0,0 +1,287 @@ +package daemon + +import ( + "fmt" + "sync" + "time" + + "github.com/docker/docker/daemon/execdriver" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/units" +) + +// State holds the current container state, and has methods to get and +// set the state. Container has an embed, which allows all of the +// functions defined against State to run against Container. +type State struct { + sync.Mutex + // FIXME: Why do we have both paused and running if a + // container cannot be paused and running at the same time? + Running bool + Paused bool + Restarting bool + OOMKilled bool + removalInProgress bool // Not need for this to be persistent on disk. + Dead bool + Pid int + ExitCode int + Error string // contains last known error when starting the container + StartedAt time.Time + FinishedAt time.Time + waitChan chan struct{} +} + +// NewState creates a default state object with a fresh channel for state changes. +func NewState() *State { + return &State{ + waitChan: make(chan struct{}), + } +} + +// String returns a human-readable description of the state +func (s *State) String() string { + if s.Running { + if s.Paused { + return fmt.Sprintf("Up %s (Paused)", units.HumanDuration(time.Now().UTC().Sub(s.StartedAt))) + } + if s.Restarting { + return fmt.Sprintf("Restarting (%d) %s ago", s.ExitCode, units.HumanDuration(time.Now().UTC().Sub(s.FinishedAt))) + } + + return fmt.Sprintf("Up %s", units.HumanDuration(time.Now().UTC().Sub(s.StartedAt))) + } + + if s.removalInProgress { + return "Removal In Progress" + } + + if s.Dead { + return "Dead" + } + + if s.StartedAt.IsZero() { + return "Created" + } + + if s.FinishedAt.IsZero() { + return "" + } + + return fmt.Sprintf("Exited (%d) %s ago", s.ExitCode, units.HumanDuration(time.Now().UTC().Sub(s.FinishedAt))) +} + +// StateString returns a single string to describe state +func (s *State) StateString() string { + if s.Running { + if s.Paused { + return "paused" + } + if s.Restarting { + return "restarting" + } + return "running" + } + + if s.Dead { + return "dead" + } + + if s.StartedAt.IsZero() { + return "created" + } + + return "exited" +} + +func isValidStateString(s string) bool { + if s != "paused" && + s != "restarting" && + s != "running" && + s != "dead" && + s != "created" && + s != "exited" { + return false + } + return true +} + +func wait(waitChan <-chan struct{}, timeout time.Duration) error { + if timeout < 0 { + <-waitChan + return nil + } + select { + case <-time.After(timeout): + return derr.ErrorCodeTimedOut.WithArgs(timeout) + case <-waitChan: + return nil + } +} + +// waitRunning waits until state is running. If state is already +// running it returns immediately. If you want wait forever you must +// supply negative timeout. Returns pid, that was passed to +// setRunning. +func (s *State) waitRunning(timeout time.Duration) (int, error) { + s.Lock() + if s.Running { + pid := s.Pid + s.Unlock() + return pid, nil + } + waitChan := s.waitChan + s.Unlock() + if err := wait(waitChan, timeout); err != nil { + return -1, err + } + return s.getPID(), nil +} + +// WaitStop waits until state is stopped. If state already stopped it returns +// immediately. If you want wait forever you must supply negative timeout. +// Returns exit code, that was passed to setStoppedLocking +func (s *State) WaitStop(timeout time.Duration) (int, error) { + s.Lock() + if !s.Running { + exitCode := s.ExitCode + s.Unlock() + return exitCode, nil + } + waitChan := s.waitChan + s.Unlock() + if err := wait(waitChan, timeout); err != nil { + return -1, err + } + return s.getExitCode(), nil +} + +// IsRunning returns whether the running flag is set. Used by Container to check whether a container is running. +func (s *State) IsRunning() bool { + s.Lock() + res := s.Running + s.Unlock() + return res +} + +// GetPID holds the process id of a container. +func (s *State) getPID() int { + s.Lock() + res := s.Pid + s.Unlock() + return res +} + +func (s *State) getExitCode() int { + s.Lock() + res := s.ExitCode + s.Unlock() + return res +} + +func (s *State) setRunning(pid int) { + s.Error = "" + s.Running = true + s.Paused = false + s.Restarting = false + s.ExitCode = 0 + s.Pid = pid + s.StartedAt = time.Now().UTC() + close(s.waitChan) // fire waiters for start + s.waitChan = make(chan struct{}) +} + +func (s *State) setStoppedLocking(exitStatus *execdriver.ExitStatus) { + s.Lock() + s.setStopped(exitStatus) + s.Unlock() +} + +func (s *State) setStopped(exitStatus *execdriver.ExitStatus) { + s.Running = false + s.Restarting = false + s.Pid = 0 + s.FinishedAt = time.Now().UTC() + s.ExitCode = exitStatus.ExitCode + s.OOMKilled = exitStatus.OOMKilled + close(s.waitChan) // fire waiters for stop + s.waitChan = make(chan struct{}) +} + +// setRestarting is when docker handles the auto restart of containers when they are +// in the middle of a stop and being restarted again +func (s *State) setRestartingLocking(exitStatus *execdriver.ExitStatus) { + s.Lock() + s.setRestarting(exitStatus) + s.Unlock() +} + +func (s *State) setRestarting(exitStatus *execdriver.ExitStatus) { + // we should consider the container running when it is restarting because of + // all the checks in docker around rm/stop/etc + s.Running = true + s.Restarting = true + s.Pid = 0 + s.FinishedAt = time.Now().UTC() + s.ExitCode = exitStatus.ExitCode + s.OOMKilled = exitStatus.OOMKilled + close(s.waitChan) // fire waiters for stop + s.waitChan = make(chan struct{}) +} + +// setError sets the container's error state. This is useful when we want to +// know the error that occurred when container transits to another state +// when inspecting it +func (s *State) setError(err error) { + s.Error = err.Error() +} + +func (s *State) isPaused() bool { + s.Lock() + res := s.Paused + s.Unlock() + return res +} + +func (s *State) setRemovalInProgress() error { + s.Lock() + defer s.Unlock() + if s.removalInProgress { + return derr.ErrorCodeAlreadyRemoving + } + s.removalInProgress = true + return nil +} + +func (s *State) resetRemovalInProgress() { + s.Lock() + s.removalInProgress = false + s.Unlock() +} + +func (s *State) setDead() { + s.Lock() + s.Dead = true + s.Unlock() +} + +func (s *State) SetRemovalInProgress() error { + s.Lock() + defer s.Unlock() + if s.removalInProgress { + return fmt.Errorf("Status is already RemovalInProgress") + } + s.removalInProgress = true + return nil +} + +func (s *State) ResetRemovalInProgress() { + s.Lock() + s.removalInProgress = false + s.Unlock() +} + +func (s *State) SetDead() { + s.Lock() + s.Dead = true + s.Unlock() +} diff --git a/daemon/state_test.go b/daemon/state_test.go new file mode 100644 index 0000000000..c70dc4e1df --- /dev/null +++ b/daemon/state_test.go @@ -0,0 +1,111 @@ +package daemon + +import ( + "sync/atomic" + "testing" + "time" + + "github.com/docker/docker/daemon/execdriver" +) + +func TestStateRunStop(t *testing.T) { + s := NewState() + for i := 1; i < 3; i++ { // full lifecycle two times + started := make(chan struct{}) + var pid int64 + go func() { + runPid, _ := s.waitRunning(-1 * time.Second) + atomic.StoreInt64(&pid, int64(runPid)) + close(started) + }() + s.Lock() + s.setRunning(i + 100) + s.Unlock() + + if !s.IsRunning() { + t.Fatal("State not running") + } + if s.Pid != i+100 { + t.Fatalf("Pid %v, expected %v", s.Pid, i+100) + } + if s.ExitCode != 0 { + t.Fatalf("ExitCode %v, expected 0", s.ExitCode) + } + select { + case <-time.After(100 * time.Millisecond): + t.Fatal("Start callback doesn't fire in 100 milliseconds") + case <-started: + t.Log("Start callback fired") + } + runPid := int(atomic.LoadInt64(&pid)) + if runPid != i+100 { + t.Fatalf("Pid %v, expected %v", runPid, i+100) + } + if pid, err := s.waitRunning(-1 * time.Second); err != nil || pid != i+100 { + t.Fatalf("waitRunning returned pid: %v, err: %v, expected pid: %v, err: %v", pid, err, i+100, nil) + } + + stopped := make(chan struct{}) + var exit int64 + go func() { + exitCode, _ := s.WaitStop(-1 * time.Second) + atomic.StoreInt64(&exit, int64(exitCode)) + close(stopped) + }() + s.setStoppedLocking(&execdriver.ExitStatus{ExitCode: i}) + if s.IsRunning() { + t.Fatal("State is running") + } + if s.ExitCode != i { + t.Fatalf("ExitCode %v, expected %v", s.ExitCode, i) + } + if s.Pid != 0 { + t.Fatalf("Pid %v, expected 0", s.Pid) + } + select { + case <-time.After(100 * time.Millisecond): + t.Fatal("Stop callback doesn't fire in 100 milliseconds") + case <-stopped: + t.Log("Stop callback fired") + } + exitCode := int(atomic.LoadInt64(&exit)) + if exitCode != i { + t.Fatalf("ExitCode %v, expected %v", exitCode, i) + } + if exitCode, err := s.WaitStop(-1 * time.Second); err != nil || exitCode != i { + t.Fatalf("WaitStop returned exitCode: %v, err: %v, expected exitCode: %v, err: %v", exitCode, err, i, nil) + } + } +} + +func TestStateTimeoutWait(t *testing.T) { + s := NewState() + started := make(chan struct{}) + go func() { + s.waitRunning(100 * time.Millisecond) + close(started) + }() + select { + case <-time.After(200 * time.Millisecond): + t.Fatal("Start callback doesn't fire in 100 milliseconds") + case <-started: + t.Log("Start callback fired") + } + + s.Lock() + s.setRunning(49) + s.Unlock() + + stopped := make(chan struct{}) + go func() { + s.waitRunning(100 * time.Millisecond) + close(stopped) + }() + select { + case <-time.After(200 * time.Millisecond): + t.Fatal("Start callback doesn't fire in 100 milliseconds") + case <-stopped: + t.Log("Start callback fired") + } + +} diff --git a/daemon/stats.go b/daemon/stats.go new file mode 100644 index 0000000000..b1e458abfa --- /dev/null +++ b/daemon/stats.go @@ -0,0 +1,129 @@ +package daemon + +import ( + "encoding/json" + "io" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/api/types/versions/v1p20" + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/pkg/version" +) + +// ContainerStatsConfig holds information for configuring the runtime +// behavior of a daemon.ContainerStats() call. +type ContainerStatsConfig struct { + Stream bool + OutStream io.Writer + Stop <-chan bool + Version version.Version +} + +// ContainerStats writes information about the container to the stream +// given in the config object. +func (daemon *Daemon) ContainerStats(prefixOrName string, config *ContainerStatsConfig) error { + + container, err := daemon.Get(prefixOrName) + if err != nil { + return err + } + + // If the container is not running and requires no stream, return an empty stats. + if !container.IsRunning() && !config.Stream { + return json.NewEncoder(config.OutStream).Encode(&types.Stats{}) + } + + updates, err := daemon.subscribeToContainerStats(container) + if err != nil { + return err + } + + if config.Stream { + // Write an empty chunk of data. + // This is to ensure that the HTTP status code is sent immediately, + // even if the container has not yet produced any data. + config.OutStream.Write(nil) + } + + var preCPUStats types.CPUStats + getStatJSON := func(v interface{}) *types.StatsJSON { + update := v.(*execdriver.ResourceStats) + ss := convertStatsToAPITypes(update.Stats) + ss.PreCPUStats = preCPUStats + ss.MemoryStats.Limit = uint64(update.MemoryLimit) + ss.Read = update.Read + ss.CPUStats.SystemUsage = update.SystemUsage + preCPUStats = ss.CPUStats + return ss + } + + enc := json.NewEncoder(config.OutStream) + + defer daemon.unsubscribeToContainerStats(container, updates) + + noStreamFirstFrame := true + for { + select { + case v, ok := <-updates: + if !ok { + return nil + } + + var statsJSON interface{} + statsJSONPost120 := getStatJSON(v) + if config.Version.LessThan("1.21") { + var ( + rxBytes uint64 + rxPackets uint64 + rxErrors uint64 + rxDropped uint64 + txBytes uint64 + txPackets uint64 + txErrors uint64 + txDropped uint64 + ) + for _, v := range statsJSONPost120.Networks { + rxBytes += v.RxBytes + rxPackets += v.RxPackets + rxErrors += v.RxErrors + rxDropped += v.RxDropped + txBytes += v.TxBytes + txPackets += v.TxPackets + txErrors += v.TxErrors + txDropped += v.TxDropped + } + statsJSON = &v1p20.StatsJSON{ + Stats: statsJSONPost120.Stats, + Network: types.NetworkStats{ + RxBytes: rxBytes, + RxPackets: rxPackets, + RxErrors: rxErrors, + RxDropped: rxDropped, + TxBytes: txBytes, + TxPackets: txPackets, + TxErrors: txErrors, + TxDropped: txDropped, + }, + } + } else { + statsJSON = statsJSONPost120 + } + + if !config.Stream && noStreamFirstFrame { + // prime the cpu stats so they aren't 0 in the final output + noStreamFirstFrame = false + continue + } + + if err := enc.Encode(statsJSON); err != nil { + return err + } + + if !config.Stream { + return nil + } + case <-config.Stop: + return nil + } + } +} diff --git a/daemon/stats_collector_unix.go b/daemon/stats_collector_unix.go new file mode 100644 index 0000000000..827578b6f2 --- /dev/null +++ b/daemon/stats_collector_unix.go @@ -0,0 +1,213 @@ +// +build !windows + +package daemon + +import ( + "bufio" + "os" + "strconv" + "strings" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/pubsub" + lntypes "github.com/docker/libnetwork/types" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/system" +) + +// newStatsCollector returns a new statsCollector that collections +// network and cgroup stats for a registered container at the specified +// interval. The collector allows non-running containers to be added +// and will start processing stats when they are started. +func newStatsCollector(interval time.Duration) *statsCollector { + s := &statsCollector{ + interval: interval, + publishers: make(map[*Container]*pubsub.Publisher), + clockTicksPerSecond: uint64(system.GetClockTicks()), + bufReader: bufio.NewReaderSize(nil, 128), + } + go s.run() + return s +} + +// statsCollector manages and provides container resource stats +type statsCollector struct { + m sync.Mutex + interval time.Duration + clockTicksPerSecond uint64 + publishers map[*Container]*pubsub.Publisher + bufReader *bufio.Reader +} + +// collect registers the container with the collector and adds it to +// the event loop for collection on the specified interval returning +// a channel for the subscriber to receive on. +func (s *statsCollector) collect(c *Container) chan interface{} { + s.m.Lock() + defer s.m.Unlock() + publisher, exists := s.publishers[c] + if !exists { + publisher = pubsub.NewPublisher(100*time.Millisecond, 1024) + s.publishers[c] = publisher + } + return publisher.Subscribe() +} + +// stopCollection closes the channels for all subscribers and removes +// the container from metrics collection. +func (s *statsCollector) stopCollection(c *Container) { + s.m.Lock() + if publisher, exists := s.publishers[c]; exists { + publisher.Close() + delete(s.publishers, c) + } + s.m.Unlock() +} + +// unsubscribe removes a specific subscriber from receiving updates for a container's stats. +func (s *statsCollector) unsubscribe(c *Container, ch chan interface{}) { + s.m.Lock() + publisher := s.publishers[c] + if publisher != nil { + publisher.Evict(ch) + if publisher.Len() == 0 { + delete(s.publishers, c) + } + } + s.m.Unlock() +} + +func (s *statsCollector) run() { + type publishersPair struct { + container *Container + publisher *pubsub.Publisher + } + // we cannot determine the capacity here. + // it will grow enough in first iteration + var pairs []publishersPair + + for range time.Tick(s.interval) { + // it does not make sense in the first iteration, + // but saves allocations in further iterations + pairs = pairs[:0] + + s.m.Lock() + for container, publisher := range s.publishers { + // copy pointers here to release the lock ASAP + pairs = append(pairs, publishersPair{container, publisher}) + } + s.m.Unlock() + if len(pairs) == 0 { + continue + } + + systemUsage, err := s.getSystemCPUUsage() + if err != nil { + logrus.Errorf("collecting system cpu usage: %v", err) + continue + } + + for _, pair := range pairs { + stats, err := pair.container.stats() + if err != nil { + if err != execdriver.ErrNotRunning { + logrus.Errorf("collecting stats for %s: %v", pair.container.ID, err) + } + continue + } + stats.SystemUsage = systemUsage + + // Retrieve the nw statistics from libnetwork and inject them in the Stats + if nwStats, err := s.getNetworkStats(pair.container); err == nil { + stats.Interfaces = nwStats + } + pair.publisher.Publish(stats) + } + } +} + +const nanoSecondsPerSecond = 1e9 + +// getSystemCPUUsage returns the host system's cpu usage in +// nanoseconds. An error is returned if the format of the underlying +// file does not match. +// +// Uses /proc/stat defined by POSIX. Looks for the cpu +// statistics line and then sums up the first seven fields +// provided. See `man 5 proc` for details on specific field +// information. +func (s *statsCollector) getSystemCPUUsage() (uint64, error) { + var line string + f, err := os.Open("/proc/stat") + if err != nil { + return 0, err + } + defer func() { + s.bufReader.Reset(nil) + f.Close() + }() + s.bufReader.Reset(f) + err = nil + for err == nil { + line, err = s.bufReader.ReadString('\n') + if err != nil { + break + } + parts := strings.Fields(line) + switch parts[0] { + case "cpu": + if len(parts) < 8 { + return 0, derr.ErrorCodeBadCPUFields + } + var totalClockTicks uint64 + for _, i := range parts[1:8] { + v, err := strconv.ParseUint(i, 10, 64) + if err != nil { + return 0, derr.ErrorCodeBadCPUInt.WithArgs(i, err) + } + totalClockTicks += v + } + return (totalClockTicks * nanoSecondsPerSecond) / + s.clockTicksPerSecond, nil + } + } + return 0, derr.ErrorCodeBadStatFormat +} + +func (s *statsCollector) getNetworkStats(c *Container) ([]*libcontainer.NetworkInterface, error) { + var list []*libcontainer.NetworkInterface + + sb, err := c.daemon.netController.SandboxByID(c.NetworkSettings.SandboxID) + if err != nil { + return list, err + } + + stats, err := sb.Statistics() + if err != nil { + return list, err + } + + // Convert libnetwork nw stats into libcontainer nw stats + for ifName, ifStats := range stats { + list = append(list, convertLnNetworkStats(ifName, ifStats)) + } + + return list, nil +} + +func convertLnNetworkStats(name string, stats *lntypes.InterfaceStatistics) *libcontainer.NetworkInterface { + n := &libcontainer.NetworkInterface{Name: name} + n.RxBytes = stats.RxBytes + n.RxPackets = stats.RxPackets + n.RxErrors = stats.RxErrors + n.RxDropped = stats.RxDropped + n.TxBytes = stats.TxBytes + n.TxPackets = stats.TxPackets + n.TxErrors = stats.TxErrors + n.TxDropped = stats.TxDropped + return n +} diff --git a/daemon/stats_collector_windows.go b/daemon/stats_collector_windows.go new file mode 100644 index 0000000000..f16d7ee380 --- /dev/null +++ b/daemon/stats_collector_windows.go @@ -0,0 +1,31 @@ +package daemon + +import "time" + +// newStatsCollector returns a new statsCollector for collection stats +// for a registered container at the specified interval. The collector allows +// non-running containers to be added and will start processing stats when +// they are started. +func newStatsCollector(interval time.Duration) *statsCollector { + return &statsCollector{} +} + +// statsCollector manages and provides container resource stats +type statsCollector struct { +} + +// collect registers the container with the collector and adds it to +// the event loop for collection on the specified interval returning +// a channel for the subscriber to receive on. +func (s *statsCollector) collect(c *Container) chan interface{} { + return nil +} + +// stopCollection closes the channels for all subscribers and removes +// the container from metrics collection. +func (s *statsCollector) stopCollection(c *Container) { +} + +// unsubscribe removes a specific subscriber from receiving updates for a container's stats. +func (s *statsCollector) unsubscribe(c *Container, ch chan interface{}) { +} diff --git a/daemon/stats_freebsd.go b/daemon/stats_freebsd.go new file mode 100644 index 0000000000..1898ca9d40 --- /dev/null +++ b/daemon/stats_freebsd.go @@ -0,0 +1,14 @@ +package daemon + +import ( + "github.com/docker/docker/api/types" + "github.com/opencontainers/runc/libcontainer" +) + +// convertStatsToAPITypes converts the libcontainer.Stats to the api specific +// structs. This is done to preserve API compatibility and versioning. +func convertStatsToAPITypes(ls *libcontainer.Stats) *types.StatsJSON { + // TODO FreeBSD. Refactor accordingly to fill in stats. + s := &types.StatsJSON{} + return s +} diff --git a/daemon/stats_linux.go b/daemon/stats_linux.go new file mode 100644 index 0000000000..466f2df5e7 --- /dev/null +++ b/daemon/stats_linux.go @@ -0,0 +1,80 @@ +package daemon + +import ( + "github.com/docker/docker/api/types" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/cgroups" +) + +// convertStatsToAPITypes converts the libcontainer.Stats to the api specific +// structs. This is done to preserve API compatibility and versioning. +func convertStatsToAPITypes(ls *libcontainer.Stats) *types.StatsJSON { + s := &types.StatsJSON{} + if ls.Interfaces != nil { + s.Networks = make(map[string]types.NetworkStats) + for _, iface := range ls.Interfaces { + // For API Version >= 1.21, the original data of network will + // be returned. + s.Networks[iface.Name] = types.NetworkStats{ + RxBytes: iface.RxBytes, + RxPackets: iface.RxPackets, + RxErrors: iface.RxErrors, + RxDropped: iface.RxDropped, + TxBytes: iface.TxBytes, + TxPackets: iface.TxPackets, + TxErrors: iface.TxErrors, + TxDropped: iface.TxDropped, + } + } + } + + cs := ls.CgroupStats + if cs != nil { + s.BlkioStats = types.BlkioStats{ + IoServiceBytesRecursive: copyBlkioEntry(cs.BlkioStats.IoServiceBytesRecursive), + IoServicedRecursive: copyBlkioEntry(cs.BlkioStats.IoServicedRecursive), + IoQueuedRecursive: copyBlkioEntry(cs.BlkioStats.IoQueuedRecursive), + IoServiceTimeRecursive: copyBlkioEntry(cs.BlkioStats.IoServiceTimeRecursive), + IoWaitTimeRecursive: copyBlkioEntry(cs.BlkioStats.IoWaitTimeRecursive), + IoMergedRecursive: copyBlkioEntry(cs.BlkioStats.IoMergedRecursive), + IoTimeRecursive: copyBlkioEntry(cs.BlkioStats.IoTimeRecursive), + SectorsRecursive: copyBlkioEntry(cs.BlkioStats.SectorsRecursive), + } + cpu := cs.CpuStats + s.CPUStats = types.CPUStats{ + CPUUsage: types.CPUUsage{ + TotalUsage: cpu.CpuUsage.TotalUsage, + PercpuUsage: cpu.CpuUsage.PercpuUsage, + UsageInKernelmode: cpu.CpuUsage.UsageInKernelmode, + UsageInUsermode: cpu.CpuUsage.UsageInUsermode, + }, + ThrottlingData: types.ThrottlingData{ + Periods: cpu.ThrottlingData.Periods, + ThrottledPeriods: cpu.ThrottlingData.ThrottledPeriods, + ThrottledTime: cpu.ThrottlingData.ThrottledTime, + }, + } + mem := cs.MemoryStats + s.MemoryStats = types.MemoryStats{ + Usage: mem.Usage.Usage, + MaxUsage: mem.Usage.MaxUsage, + Stats: mem.Stats, + Failcnt: mem.Usage.Failcnt, + } + } + + return s +} + +func copyBlkioEntry(entries []cgroups.BlkioStatEntry) []types.BlkioStatEntry { + out := make([]types.BlkioStatEntry, len(entries)) + for i, re := range entries { + out[i] = types.BlkioStatEntry{ + Major: re.Major, + Minor: re.Minor, + Op: re.Op, + Value: re.Value, + } + } + return out +} diff --git a/daemon/stats_windows.go b/daemon/stats_windows.go new file mode 100644 index 0000000000..fc8991ba2a --- /dev/null +++ b/daemon/stats_windows.go @@ -0,0 +1,14 @@ +package daemon + +import ( + "github.com/docker/docker/api/types" + "github.com/opencontainers/runc/libcontainer" +) + +// convertStatsToAPITypes converts the libcontainer.Stats to the api specific +// structs. This is done to preserve API compatibility and versioning. +func convertStatsToAPITypes(ls *libcontainer.Stats) *types.StatsJSON { + // TODO Windows. Refactor accordingly to fill in stats. + s := &types.StatsJSON{} + return s +} diff --git a/daemon/stop.go b/daemon/stop.go new file mode 100644 index 0000000000..9e33315216 --- /dev/null +++ b/daemon/stop.go @@ -0,0 +1,25 @@ +package daemon + +import ( + derr "github.com/docker/docker/errors" +) + +// ContainerStop looks for the given container and terminates it, +// waiting the given number of seconds before forcefully killing the +// container. If a negative number of seconds is given, ContainerStop +// will wait for a graceful termination. An error is returned if the +// container is not found, is already stopped, or if there is a +// problem stopping the container. +func (daemon *Daemon) ContainerStop(name string, seconds int) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + if !container.IsRunning() { + return derr.ErrorCodeStopped + } + if err := container.Stop(seconds); err != nil { + return derr.ErrorCodeCantStop.WithArgs(name, err) + } + return nil +} diff --git a/daemon/top_unix.go b/daemon/top_unix.go new file mode 100644 index 0000000000..4112fbcbb1 --- /dev/null +++ b/daemon/top_unix.go @@ -0,0 +1,81 @@ +//+build !windows + +package daemon + +import ( + "os/exec" + "strconv" + "strings" + + "github.com/docker/docker/api/types" + derr "github.com/docker/docker/errors" +) + +// ContainerTop lists the processes running inside of the given +// container by calling ps with the given args, or with the flags +// "-ef" if no args are given. An error is returned if the container +// is not found, or is not running, or if there are any problems +// running ps, or parsing the output. +func (daemon *Daemon) ContainerTop(name string, psArgs string) (*types.ContainerProcessList, error) { + if psArgs == "" { + psArgs = "-ef" + } + + container, err := daemon.Get(name) + if err != nil { + return nil, err + } + + if !container.IsRunning() { + return nil, derr.ErrorCodeNotRunning.WithArgs(name) + } + + pids, err := daemon.ExecutionDriver().GetPidsForContainer(container.ID) + if err != nil { + return nil, err + } + + output, err := exec.Command("ps", strings.Split(psArgs, " ")...).Output() + if err != nil { + return nil, derr.ErrorCodePSError.WithArgs(err) + } + + procList := &types.ContainerProcessList{} + + lines := strings.Split(string(output), "\n") + procList.Titles = strings.Fields(lines[0]) + + pidIndex := -1 + for i, name := range procList.Titles { + if name == "PID" { + pidIndex = i + } + } + if pidIndex == -1 { + return nil, derr.ErrorCodeNoPID + } + + // loop through the output and extract the PID from each line + for _, line := range lines[1:] { + if len(line) == 0 { + continue + } + fields := strings.Fields(line) + p, err := strconv.Atoi(fields[pidIndex]) + if err != nil { + return nil, derr.ErrorCodeBadPID.WithArgs(fields[pidIndex], err) + } + + for _, pid := range pids { + if pid == p { + // Make sure number of fields equals number of header titles + // merging "overhanging" fields + process := fields[:len(procList.Titles)-1] + process = append(process, strings.Join(fields[len(procList.Titles)-1:], " ")) + procList.Processes = append(procList.Processes, process) + } + } + } + container.logEvent("top") + return procList, nil +} diff --git a/daemon/top_windows.go b/daemon/top_windows.go new file mode 100644 index 0000000000..f224b2e2d2 --- /dev/null +++ b/daemon/top_windows.go @@ -0,0 +1,11 @@ +package daemon + +import ( + "github.com/docker/docker/api/types" + derr "github.com/docker/docker/errors" +) + +// ContainerTop is not supported on Windows and returns an error. +func (daemon *Daemon) ContainerTop(name string, psArgs string) (*types.ContainerProcessList, error) { + return nil, derr.ErrorCodeNoTop +} diff --git a/daemon/unpause.go b/daemon/unpause.go new file mode 100644 index 0000000000..6dd41c511c --- /dev/null +++ b/daemon/unpause.go @@ -0,0 +1,19 @@ +package daemon + +import ( + derr "github.com/docker/docker/errors" +) + +// ContainerUnpause unpauses a container +func (daemon *Daemon) ContainerUnpause(name string) error { + container, err := daemon.Get(name) + if err != nil { + return err + } + + if err := container.unpause(); err != nil { + return derr.ErrorCodeCantUnpause.WithArgs(name, err) + } + + return nil +} diff --git a/daemon/utils_freebsd.go b/daemon/utils_freebsd.go new file mode 100644 index 0000000000..1e1ed1b358 --- /dev/null +++ b/daemon/utils_freebsd.go @@ -0,0 +1,9 @@ +package daemon + +import ( + "github.com/docker/docker/runconfig" +) + +func mergeLxcConfIntoOptions(hostConfig *runconfig.HostConfig) ([]string, error) { + return nil, nil +} diff --git a/daemon/utils_linux.go b/daemon/utils_linux.go new file mode 100644 index 0000000000..042544e43a --- /dev/null +++ b/daemon/utils_linux.go @@ -0,0 +1,48 @@ +// +build linux + +package daemon + +import ( + "errors" + "fmt" + "strings" + + "github.com/docker/docker/runconfig" + "github.com/opencontainers/runc/libcontainer/selinux" +) + +func selinuxSetDisabled() { + selinux.SetDisabled() +} + +func selinuxFreeLxcContexts(label string) { + selinux.FreeLxcContexts(label) +} + +func selinuxEnabled() bool { + return selinux.SelinuxEnabled() +} + +func mergeLxcConfIntoOptions(hostConfig *runconfig.HostConfig) ([]string, error) { + if hostConfig == nil { + return nil, nil + } + + out := []string{} + + // merge in the lxc conf options into the generic config map + if lxcConf := hostConfig.LxcConf; lxcConf != nil { + lxSlice := lxcConf.Slice() + for _, pair := range lxSlice { + // because lxc conf gets the driver name lxc.XXXX we need to trim it off + // and let the lxc driver add it back later if needed + if !strings.Contains(pair.Key, ".") { + return nil, errors.New("Illegal Key passed into LXC Configurations") + } + parts := strings.SplitN(pair.Key, ".", 2) + out = append(out, fmt.Sprintf("%s=%s", parts[1], pair.Value)) + } + } + + return out, nil +} diff --git a/daemon/utils_nounix.go b/daemon/utils_nounix.go new file mode 100644 index 0000000000..25a56ad157 --- /dev/null +++ b/daemon/utils_nounix.go @@ -0,0 +1,13 @@ +// +build !linux + +package daemon + +func selinuxSetDisabled() { +} + +func selinuxFreeLxcContexts(label string) { +} + +func selinuxEnabled() bool { + return false +} diff --git a/daemon/utils_test.go b/daemon/utils_test.go new file mode 100644 index 0000000000..99165f7810 --- /dev/null +++ b/daemon/utils_test.go @@ -0,0 +1,28 @@ +// +build linux + +package daemon + +import ( + "testing" + + "github.com/docker/docker/runconfig" +) + +func TestMergeLxcConfig(t *testing.T) { + kv := []runconfig.KeyValuePair{ + {"lxc.cgroups.cpuset", "1,2"}, + } + hostConfig := &runconfig.HostConfig{ + LxcConf: runconfig.NewLxcConfig(kv), + } + + out, err := mergeLxcConfIntoOptions(hostConfig) + if err != nil { + t.Fatalf("Failed to merge Lxc Config: %s", err) + } + + cpuset := out[0] + if expected := "cgroups.cpuset=1,2"; cpuset != expected { + t.Fatalf("expected %s got %s", expected, cpuset) + } +} diff --git a/daemon/volumes.go b/daemon/volumes.go new file mode 100644 index 0000000000..54aca3522b --- /dev/null +++ b/daemon/volumes.go @@ -0,0 +1,109 @@ +package daemon + +import ( + "errors" + "fmt" + "io/ioutil" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/chrootarchive" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/volume" +) + +var ( + // ErrVolumeReadonly is used to signal an error when trying to copy data into + // a volume mount that is not writable. + ErrVolumeReadonly = errors.New("mounted volume is marked read-only") +) + +// mountPoint is the intersection point between a volume and a container. It +// specifies which volume is to be used and where inside a container it should +// be mounted. +type mountPoint struct { + Name string + Destination string + Driver string + RW bool + Volume volume.Volume `json:"-"` + Source string + Mode string `json:"Relabel"` // Originally field was `Relabel`" +} + +// Setup sets up a mount point by either mounting the volume if it is +// configured, or creating the source directory if supplied. +func (m *mountPoint) Setup() (string, error) { + if m.Volume != nil { + return m.Volume.Mount() + } + + if len(m.Source) > 0 { + if _, err := os.Stat(m.Source); err != nil { + if !os.IsNotExist(err) { + return "", err + } + logrus.Warnf("Auto-creating non-existant volume host path %s, this is deprecated and will be removed soon", m.Source) + if err := system.MkdirAll(m.Source, 0755); err != nil { + return "", err + } + } + return m.Source, nil + } + + return "", derr.ErrorCodeMountSetup +} + +// hasResource checks whether the given absolute path for a container is in +// this mount point. If the relative path starts with `../` then the resource +// is outside of this mount point, but we can't simply check for this prefix +// because it misses `..` which is also outside of the mount, so check both. +func (m *mountPoint) hasResource(absolutePath string) bool { + relPath, err := filepath.Rel(m.Destination, absolutePath) + + return err == nil && relPath != ".." && !strings.HasPrefix(relPath, fmt.Sprintf("..%c", filepath.Separator)) +} + +// Path returns the path of a volume in a mount point. +func (m *mountPoint) Path() string { + if m.Volume != nil { + return m.Volume.Path() + } + + return m.Source +} + +// copyExistingContents copies from the source to the destination and +// ensures the ownership is appropriately set. +func copyExistingContents(source, destination string) error { + volList, err := ioutil.ReadDir(source) + if err != nil { + return err + } + if len(volList) > 0 { + srcList, err := ioutil.ReadDir(destination) + if err != nil { + return err + } + if len(srcList) == 0 { + // If the source volume is empty copy files from the root into the volume + if err := chrootarchive.CopyWithTar(source, destination); err != nil { + return err + } + } + } + return copyOwnership(source, destination) +} + +// volumeToAPIType converts a volume.Volume to the type used by the remote API +func volumeToAPIType(v volume.Volume) *types.Volume { + return &types.Volume{ + Name: v.Name(), + Driver: v.DriverName(), + Mountpoint: v.Path(), + } +} diff --git a/daemon/volumes_linux_unit_test.go b/daemon/volumes_linux_unit_test.go new file mode 100644 index 0000000000..6f4ab882dc --- /dev/null +++ b/daemon/volumes_linux_unit_test.go @@ -0,0 +1,58 @@ +// +build experimental + +package daemon + +import "testing" + +func TestParseBindMount(t *testing.T) { + cases := []struct { + bind string + driver string + expDest string + expSource string + expName string + expDriver string + expRW bool + fail bool + }{ + {"/tmp:/tmp", "", "/tmp", "/tmp", "", "", true, false}, + {"/tmp:/tmp:ro", "", "/tmp", "/tmp", "", "", false, false}, + {"/tmp:/tmp:rw", "", "/tmp", "/tmp", "", "", true, false}, + {"/tmp:/tmp:foo", "", "/tmp", "/tmp", "", "", false, true}, + {"name:/tmp", "", "/tmp", "", "name", "local", true, false}, + {"name:/tmp", "external", "/tmp", "", "name", "external", true, false}, + {"name:/tmp:ro", "local", "/tmp", "", "name", "local", false, false}, + {"local/name:/tmp:rw", "", "/tmp", "", "local/name", "local", true, false}, + {"/tmp:tmp", "", "", "", "", "", true, true}, + } + + for _, c := range cases { + m, err := parseBindMount(c.bind, c.driver) + if c.fail { + if err == nil { + t.Fatalf("Expected error, was nil, for spec %s\n", c.bind) + } + continue + } + + if m.Destination != c.expDest { + t.Fatalf("Expected destination %s, was %s, for spec %s\n", c.expDest, m.Destination, c.bind) + } + + if m.Source != c.expSource { + t.Fatalf("Expected source %s, was %s, for spec %s\n", c.expSource, m.Source, c.bind) + } + + if m.Name != c.expName { + t.Fatalf("Expected name %s, was %s for spec %s\n", c.expName, m.Name, c.bind) + } + + if m.Driver != c.expDriver { + t.Fatalf("Expected driver %s, was %s, for spec %s\n", c.expDriver, m.Driver, c.bind) + } + + if m.RW != c.expRW { + t.Fatalf("Expected RW %v, was %v for spec %s\n", c.expRW, m.RW, c.bind) + } + } +} diff --git a/daemon/volumes_unit_test.go b/daemon/volumes_unit_test.go new file mode 100644 index 0000000000..9420989b1c --- /dev/null +++ b/daemon/volumes_unit_test.go @@ -0,0 +1,35 @@ +package daemon + +import "testing" + +func TestParseVolumesFrom(t *testing.T) { + cases := []struct { + spec string + expID string + expMode string + fail bool + }{ + {"", "", "", true}, + {"foobar", "foobar", "rw", false}, + {"foobar:rw", "foobar", "rw", false}, + {"foobar:ro", "foobar", "ro", false}, + {"foobar:baz", "", "", true}, + } + + for _, c := range cases { + id, mode, err := parseVolumesFrom(c.spec) + if c.fail { + if err == nil { + t.Fatalf("Expected error, was nil, for spec %s\n", c.spec) + } + continue + } + + if id != c.expID { + t.Fatalf("Expected id %s, was %s, for spec %s\n", c.expID, id, c.spec) + } + if mode != c.expMode { + t.Fatalf("Expected mode %s, was %s for spec %s\n", c.expMode, mode, c.spec) + } + } +} diff --git a/daemon/volumes_unix.go b/daemon/volumes_unix.go new file mode 100644 index 0000000000..94e91317f0 --- /dev/null +++ b/daemon/volumes_unix.go @@ -0,0 +1,425 @@ +// +build !windows + +package daemon + +import ( + "io/ioutil" + "os" + "path/filepath" + "sort" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/daemon/execdriver" + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/volume" + volumedrivers "github.com/docker/docker/volume/drivers" + "github.com/docker/docker/volume/local" + "github.com/opencontainers/runc/libcontainer/label" +) + +// copyOwnership copies the permissions and uid:gid of the source file +// to the destination file +func copyOwnership(source, destination string) error { + stat, err := system.Stat(source) + if err != nil { + return err + } + + if err := os.Chown(destination, int(stat.UID()), int(stat.GID())); err != nil { + return err + } + + return os.Chmod(destination, os.FileMode(stat.Mode())) +} + +// setupMounts iterates through each of the mount points for a container and +// calls Setup() on each. It also looks to see if is a network mount such as +// /etc/resolv.conf, and if it is not, appends it to the array of mounts. +func (container *Container) setupMounts() ([]execdriver.Mount, error) { + var mounts []execdriver.Mount + for _, m := range container.MountPoints { + path, err := m.Setup() + if err != nil { + return nil, err + } + if !container.trySetNetworkMount(m.Destination, path) { + mounts = append(mounts, execdriver.Mount{ + Source: path, + Destination: m.Destination, + Writable: m.RW, + }) + } + } + + mounts = sortMounts(mounts) + netMounts := container.networkMounts() + // if we are going to mount any of the network files from container + // metadata, the ownership must be set properly for potential container + // remapped root (user namespaces) + rootUID, rootGID := container.daemon.GetRemappedUIDGID() + for _, mount := range netMounts { + if err := os.Chown(mount.Source, rootUID, rootGID); err != nil { + return nil, err + } + } + return append(mounts, netMounts...), nil +} + +// parseBindMount validates the configuration of mount information in runconfig is valid. +func parseBindMount(spec, volumeDriver string) (*mountPoint, error) { + bind := &mountPoint{ + RW: true, + } + arr := strings.Split(spec, ":") + + switch len(arr) { + case 2: + bind.Destination = arr[1] + case 3: + bind.Destination = arr[1] + mode := arr[2] + if !volume.ValidMountMode(mode) { + return nil, derr.ErrorCodeVolumeInvalidMode.WithArgs(mode) + } + bind.RW = volume.ReadWrite(mode) + // Mode field is used by SELinux to decide whether to apply label + bind.Mode = mode + default: + return nil, derr.ErrorCodeVolumeInvalid.WithArgs(spec) + } + + //validate the volumes destination path + if !filepath.IsAbs(bind.Destination) { + return nil, derr.ErrorCodeVolumeAbs.WithArgs(bind.Destination) + } + + name, source, err := parseVolumeSource(arr[0]) + if err != nil { + return nil, err + } + + if len(source) == 0 { + bind.Driver = volumeDriver + if len(bind.Driver) == 0 { + bind.Driver = volume.DefaultDriverName + } + } else { + bind.Source = filepath.Clean(source) + } + + bind.Name = name + bind.Destination = filepath.Clean(bind.Destination) + return bind, nil +} + +// sortMounts sorts an array of mounts in lexicographic order. This ensure that +// when mounting, the mounts don't shadow other mounts. For example, if mounting +// /etc and /etc/resolv.conf, /etc/resolv.conf must not be mounted first. +func sortMounts(m []execdriver.Mount) []execdriver.Mount { + sort.Sort(mounts(m)) + return m +} + +type mounts []execdriver.Mount + +// Len returns the number of mounts +func (m mounts) Len() int { + return len(m) +} + +// Less returns true if the number of parts (a/b/c would be 3 parts) in the +// mount indexed by parameter 1 is less than that of the mount indexed by +// parameter 2. +func (m mounts) Less(i, j int) bool { + return m.parts(i) < m.parts(j) +} + +// Swap swaps two items in an array of mounts. +func (m mounts) Swap(i, j int) { + m[i], m[j] = m[j], m[i] +} + +// parts returns the number of parts in the destination of a mount. +func (m mounts) parts(i int) int { + return len(strings.Split(filepath.Clean(m[i].Destination), string(os.PathSeparator))) +} + +// migrateVolume links the contents of a volume created pre Docker 1.7 +// into the location expected by the local driver. +// It creates a symlink from DOCKER_ROOT/vfs/dir/VOLUME_ID to DOCKER_ROOT/volumes/VOLUME_ID/_container_data. +// It preserves the volume json configuration generated pre Docker 1.7 to be able to +// downgrade from Docker 1.7 to Docker 1.6 without losing volume compatibility. +func migrateVolume(id, vfs string) error { + l, err := volumedrivers.Lookup(volume.DefaultDriverName) + if err != nil { + return err + } + + newDataPath := l.(*local.Root).DataPath(id) + fi, err := os.Stat(newDataPath) + if err != nil && !os.IsNotExist(err) { + return err + } + + if fi != nil && fi.IsDir() { + return nil + } + + return os.Symlink(vfs, newDataPath) +} + +// validVolumeLayout checks whether the volume directory layout +// is valid to work with Docker post 1.7 or not. +func validVolumeLayout(files []os.FileInfo) bool { + if len(files) == 1 && files[0].Name() == local.VolumeDataPathName && files[0].IsDir() { + return true + } + + if len(files) != 2 { + return false + } + + for _, f := range files { + if f.Name() == "config.json" || + (f.Name() == local.VolumeDataPathName && f.Mode()&os.ModeSymlink == os.ModeSymlink) { + // Old volume configuration, we ignore it + continue + } + return false + } + + return true +} + +// verifyVolumesInfo ports volumes configured for the containers pre docker 1.7. +// It reads the container configuration and creates valid mount points for the old volumes. +func (daemon *Daemon) verifyVolumesInfo(container *Container) error { + // Inspect old structures only when we're upgrading from old versions + // to versions >= 1.7 and the MountPoints has not been populated with volumes data. + if len(container.MountPoints) == 0 && len(container.Volumes) > 0 { + for destination, hostPath := range container.Volumes { + vfsPath := filepath.Join(daemon.root, "vfs", "dir") + rw := container.VolumesRW != nil && container.VolumesRW[destination] + + if strings.HasPrefix(hostPath, vfsPath) { + id := filepath.Base(hostPath) + if err := migrateVolume(id, hostPath); err != nil { + return err + } + container.addLocalMountPoint(id, destination, rw) + } else { // Bind mount + id, source, err := parseVolumeSource(hostPath) + // We should not find an error here coming + // from the old configuration, but who knows. + if err != nil { + return err + } + container.addBindMountPoint(id, source, destination, rw) + } + } + } else if len(container.MountPoints) > 0 { + // Volumes created with a Docker version >= 1.7. We verify integrity in case of data created + // with Docker 1.7 RC versions that put the information in + // DOCKER_ROOT/volumes/VOLUME_ID rather than DOCKER_ROOT/volumes/VOLUME_ID/_container_data. + l, err := volumedrivers.Lookup(volume.DefaultDriverName) + if err != nil { + return err + } + + for _, m := range container.MountPoints { + if m.Driver != volume.DefaultDriverName { + continue + } + dataPath := l.(*local.Root).DataPath(m.Name) + volumePath := filepath.Dir(dataPath) + + d, err := ioutil.ReadDir(volumePath) + if err != nil { + // If the volume directory doesn't exist yet it will be recreated, + // so we only return the error when there is a different issue. + if !os.IsNotExist(err) { + return err + } + // Do not check when the volume directory does not exist. + continue + } + if validVolumeLayout(d) { + continue + } + + if err := os.Mkdir(dataPath, 0755); err != nil { + return err + } + + // Move data inside the data directory + for _, f := range d { + oldp := filepath.Join(volumePath, f.Name()) + newp := filepath.Join(dataPath, f.Name()) + if err := os.Rename(oldp, newp); err != nil { + logrus.Errorf("Unable to move %s to %s\n", oldp, newp) + } + } + } + + return container.toDiskLocking() + } + + return nil +} + +// parseVolumesFrom ensure that the supplied volumes-from is valid. +func parseVolumesFrom(spec string) (string, string, error) { + if len(spec) == 0 { + return "", "", derr.ErrorCodeVolumeFromBlank.WithArgs(spec) + } + + specParts := strings.SplitN(spec, ":", 2) + id := specParts[0] + mode := "rw" + + if len(specParts) == 2 { + mode = specParts[1] + if !volume.ValidMountMode(mode) { + return "", "", derr.ErrorCodeVolumeMode.WithArgs(mode) + } + } + return id, mode, nil +} + +// registerMountPoints initializes the container mount points with the configured volumes and bind mounts. +// It follows the next sequence to decide what to mount in each final destination: +// +// 1. Select the previously configured mount points for the containers, if any. +// 2. Select the volumes mounted from another containers. Overrides previously configured mount point destination. +// 3. Select the bind mounts set by the client. Overrides previously configured mount point destinations. +func (daemon *Daemon) registerMountPoints(container *Container, hostConfig *runconfig.HostConfig) error { + binds := map[string]bool{} + mountPoints := map[string]*mountPoint{} + + // 1. Read already configured mount points. + for name, point := range container.MountPoints { + mountPoints[name] = point + } + + // 2. Read volumes from other containers. + for _, v := range hostConfig.VolumesFrom { + containerID, mode, err := parseVolumesFrom(v) + if err != nil { + return err + } + + c, err := daemon.Get(containerID) + if err != nil { + return err + } + + for _, m := range c.MountPoints { + cp := &mountPoint{ + Name: m.Name, + Source: m.Source, + RW: m.RW && volume.ReadWrite(mode), + Driver: m.Driver, + Destination: m.Destination, + } + + if len(cp.Source) == 0 { + v, err := daemon.createVolume(cp.Name, cp.Driver, nil) + if err != nil { + return err + } + cp.Volume = v + } + + mountPoints[cp.Destination] = cp + } + } + + // 3. Read bind mounts + for _, b := range hostConfig.Binds { + // #10618 + bind, err := parseBindMount(b, hostConfig.VolumeDriver) + if err != nil { + return err + } + + if binds[bind.Destination] { + return derr.ErrorCodeVolumeDup.WithArgs(bind.Destination) + } + + if len(bind.Name) > 0 && len(bind.Driver) > 0 { + // create the volume + v, err := daemon.createVolume(bind.Name, bind.Driver, nil) + if err != nil { + return err + } + bind.Volume = v + bind.Source = v.Path() + // bind.Name is an already existing volume, we need to use that here + bind.Driver = v.DriverName() + // Since this is just a named volume and not a typical bind, set to shared mode `z` + if bind.Mode == "" { + bind.Mode = "z" + } + } + + if label.RelabelNeeded(bind.Mode) { + if err := label.Relabel(bind.Source, container.MountLabel, label.IsShared(bind.Mode)); err != nil { + return err + } + } + binds[bind.Destination] = true + mountPoints[bind.Destination] = bind + } + + // Keep backwards compatible structures + bcVolumes := map[string]string{} + bcVolumesRW := map[string]bool{} + for _, m := range mountPoints { + if m.BackwardsCompatible() { + bcVolumes[m.Destination] = m.Path() + bcVolumesRW[m.Destination] = m.RW + + // This mountpoint is replacing an existing one, so the count needs to be decremented + if mp, exists := container.MountPoints[m.Destination]; exists && mp.Volume != nil { + daemon.volumes.Decrement(mp.Volume) + } + } + } + + container.Lock() + container.MountPoints = mountPoints + container.Volumes = bcVolumes + container.VolumesRW = bcVolumesRW + container.Unlock() + + return nil +} + +// createVolume creates a volume. +func (daemon *Daemon) createVolume(name, driverName string, opts map[string]string) (volume.Volume, error) { + v, err := daemon.volumes.Create(name, driverName, opts) + if err != nil { + return nil, err + } + daemon.volumes.Increment(v) + return v, nil +} + +// parseVolumeSource parses the origin sources that's mounted into the container. +func parseVolumeSource(spec string) (string, string, error) { + if !filepath.IsAbs(spec) { + return spec, "", nil + } + + return "", spec, nil +} + +// BackwardsCompatible decides whether this mount point can be +// used in old versions of Docker or not. +// Only bind mounts and local volumes can be used in old versions of Docker. +func (m *mountPoint) BackwardsCompatible() bool { + return len(m.Source) > 0 || m.Driver == volume.DefaultDriverName +} diff --git a/daemon/volumes_windows.go b/daemon/volumes_windows.go new file mode 100644 index 0000000000..df122ecbac --- /dev/null +++ b/daemon/volumes_windows.go @@ -0,0 +1,36 @@ +// +build windows + +package daemon + +import ( + "github.com/docker/docker/daemon/execdriver" + "github.com/docker/docker/runconfig" +) + +// copyOwnership copies the permissions and group of a source file to the +// destination file. This is a no-op on Windows. +func copyOwnership(source, destination string) error { + return nil +} + +// setupMounts configures the mount points for a container. +// setupMounts on Linux iterates through each of the mount points for a +// container and calls Setup() on each. It also looks to see if is a network +// mount such as /etc/resolv.conf, and if it is not, appends it to the array +// of mounts. As Windows does not support mount points, this is a no-op. +func (container *Container) setupMounts() ([]execdriver.Mount, error) { + return nil, nil +} + +// verifyVolumesInfo ports volumes configured for the containers pre docker 1.7. +// As the Windows daemon was not supported before 1.7, this is a no-op +func (daemon *Daemon) verifyVolumesInfo(container *Container) error { + return nil +} + +// registerMountPoints initializes the container mount points with the +// configured volumes and bind mounts. Windows does not support volumes or +// mount points. +func (daemon *Daemon) registerMountPoints(container *Container, hostConfig *runconfig.HostConfig) error { + return nil +} diff --git a/daemon/wait.go b/daemon/wait.go new file mode 100644 index 0000000000..e429c46012 --- /dev/null +++ b/daemon/wait.go @@ -0,0 +1,17 @@ +package daemon + +import "time" + +// ContainerWait stops processing until the given container is +// stopped. If the container is not found, an error is returned. On a +// successful stop, the exit code of the container is returned. On a +// timeout, an error is returned. If you want to wait forever, supply +// a negative duration for the timeout. +func (daemon *Daemon) ContainerWait(name string, timeout time.Duration) (int, error) { + container, err := daemon.Get(name) + if err != nil { + return -1, err + } + + return container.WaitStop(timeout) +} diff --git a/docker/README.md b/docker/README.md new file mode 100644 index 0000000000..015bc1333b --- /dev/null +++ b/docker/README.md @@ -0,0 +1,3 @@ +docker.go contains Docker's main function. + +This file provides first line CLI argument parsing and environment variable setting. diff --git a/docker/client.go b/docker/client.go new file mode 100644 index 0000000000..8395805b10 --- /dev/null +++ b/docker/client.go @@ -0,0 +1,28 @@ +package main + +import ( + "path/filepath" + + "github.com/docker/docker/cli" + "github.com/docker/docker/cliconfig" + flag "github.com/docker/docker/pkg/mflag" +) + +var clientFlags = &cli.ClientFlags{FlagSet: new(flag.FlagSet), Common: commonFlags} + +func init() { + client := clientFlags.FlagSet + client.StringVar(&clientFlags.ConfigDir, []string{"-config"}, cliconfig.ConfigDir(), "Location of client config files") + + clientFlags.PostParse = func() { + clientFlags.Common.PostParse() + + if clientFlags.ConfigDir != "" { + cliconfig.SetConfigDir(clientFlags.ConfigDir) + } + + if clientFlags.Common.TrustKey == "" { + clientFlags.Common.TrustKey = filepath.Join(cliconfig.ConfigDir(), defaultTrustKeyFile) + } + } +} diff --git a/docker/common.go b/docker/common.go new file mode 100644 index 0000000000..351257e779 --- /dev/null +++ b/docker/common.go @@ -0,0 +1,101 @@ +package main + +import ( + "fmt" + "os" + "path/filepath" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/cli" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/tlsconfig" +) + +const ( + defaultTrustKeyFile = "key.json" + defaultCaFile = "ca.pem" + defaultKeyFile = "key.pem" + defaultCertFile = "cert.pem" +) + +var ( + daemonFlags *flag.FlagSet + commonFlags = &cli.CommonFlags{FlagSet: new(flag.FlagSet)} + + dockerCertPath = os.Getenv("DOCKER_CERT_PATH") + dockerTLSVerify = os.Getenv("DOCKER_TLS_VERIFY") != "" +) + +func init() { + if dockerCertPath == "" { + dockerCertPath = cliconfig.ConfigDir() + } + + commonFlags.PostParse = postParseCommon + + cmd := commonFlags.FlagSet + + cmd.BoolVar(&commonFlags.Debug, []string{"D", "-debug"}, false, "Enable debug mode") + cmd.StringVar(&commonFlags.LogLevel, []string{"l", "-log-level"}, "info", "Set the logging level") + cmd.BoolVar(&commonFlags.TLS, []string{"-tls"}, false, "Use TLS; implied by --tlsverify") + cmd.BoolVar(&commonFlags.TLSVerify, []string{"-tlsverify"}, dockerTLSVerify, "Use TLS and verify the remote") + + // TODO use flag flag.String([]string{"i", "-identity"}, "", "Path to libtrust key file") + + var tlsOptions tlsconfig.Options + commonFlags.TLSOptions = &tlsOptions + cmd.StringVar(&tlsOptions.CAFile, []string{"-tlscacert"}, filepath.Join(dockerCertPath, defaultCaFile), "Trust certs signed only by this CA") + cmd.StringVar(&tlsOptions.CertFile, []string{"-tlscert"}, filepath.Join(dockerCertPath, defaultCertFile), "Path to TLS certificate file") + cmd.StringVar(&tlsOptions.KeyFile, []string{"-tlskey"}, filepath.Join(dockerCertPath, defaultKeyFile), "Path to TLS key file") + + cmd.Var(opts.NewListOptsRef(&commonFlags.Hosts, opts.ValidateHost), []string{"H", "-host"}, "Daemon socket(s) to connect to") +} + +func postParseCommon() { + cmd := commonFlags.FlagSet + + if commonFlags.LogLevel != "" { + lvl, err := logrus.ParseLevel(commonFlags.LogLevel) + if err != nil { + fmt.Fprintf(os.Stderr, "Unable to parse logging level: %s\n", commonFlags.LogLevel) + os.Exit(1) + } + logrus.SetLevel(lvl) + } else { + logrus.SetLevel(logrus.InfoLevel) + } + + if commonFlags.Debug { + os.Setenv("DEBUG", "1") + logrus.SetLevel(logrus.DebugLevel) + } + + // Regardless of whether the user sets it to true or false, if they + // specify --tlsverify at all then we need to turn on tls + // TLSVerify can be true even if not set due to DOCKER_TLS_VERIFY env var, so we need to check that here as well + if cmd.IsSet("-tlsverify") || commonFlags.TLSVerify { + commonFlags.TLS = true + } + + if !commonFlags.TLS { + commonFlags.TLSOptions = nil + } else { + tlsOptions := commonFlags.TLSOptions + tlsOptions.InsecureSkipVerify = !commonFlags.TLSVerify + + // Reset CertFile and KeyFile to empty string if the user did not specify + // the respective flags and the respective default files were not found. + if !cmd.IsSet("-tlscert") { + if _, err := os.Stat(tlsOptions.CertFile); os.IsNotExist(err) { + tlsOptions.CertFile = "" + } + } + if !cmd.IsSet("-tlskey") { + if _, err := os.Stat(tlsOptions.KeyFile); os.IsNotExist(err) { + tlsOptions.KeyFile = "" + } + } + } +} diff --git a/docker/daemon.go b/docker/daemon.go new file mode 100644 index 0000000000..fb68e70544 --- /dev/null +++ b/docker/daemon.go @@ -0,0 +1,336 @@ +// +build daemon + +package main + +import ( + "crypto/tls" + "fmt" + "io" + "os" + "path/filepath" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/uuid" + apiserver "github.com/docker/docker/api/server" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/cli" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/daemon" + "github.com/docker/docker/daemon/logger" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/pidfile" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/system" + "github.com/docker/docker/pkg/timeutils" + "github.com/docker/docker/pkg/tlsconfig" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" +) + +const daemonUsage = " docker daemon [ --help | ... ]\n" + +var ( + flDaemon = flag.Bool([]string{"#d", "#-daemon"}, false, "Enable daemon mode (deprecated; use docker daemon)") + daemonCli cli.Handler = NewDaemonCli() +) + +// TODO: remove once `-d` is retired +func handleGlobalDaemonFlag() { + // This block makes sure that if the deprecated daemon flag `--daemon` is absent, + // then all daemon-specific flags are absent as well. + if !*flDaemon && daemonFlags != nil { + flag.CommandLine.Visit(func(fl *flag.Flag) { + for _, name := range fl.Names { + name := strings.TrimPrefix(name, "#") + if daemonFlags.Lookup(name) != nil { + // daemon flag was NOT specified, but daemon-specific flags were + // so let's error out + fmt.Fprintf(os.Stderr, "docker: the daemon flag '-%s' must follow the 'docker daemon' command.\n", name) + os.Exit(1) + } + } + }) + } + + if *flDaemon { + daemonCli.(*DaemonCli).CmdDaemon(flag.Args()...) + os.Exit(0) + } +} + +func presentInHelp(usage string) string { return usage } +func absentFromHelp(string) string { return "" } + +// NewDaemonCli returns a pre-configured daemon CLI +func NewDaemonCli() *DaemonCli { + daemonFlags = cli.Subcmd("daemon", nil, "Enable daemon mode", true) + + // TODO(tiborvass): remove InstallFlags? + daemonConfig := new(daemon.Config) + daemonConfig.LogConfig.Config = make(map[string]string) + daemonConfig.ClusterOpts = make(map[string]string) + daemonConfig.InstallFlags(daemonFlags, presentInHelp) + daemonConfig.InstallFlags(flag.CommandLine, absentFromHelp) + registryOptions := new(registry.Options) + registryOptions.InstallFlags(daemonFlags, presentInHelp) + registryOptions.InstallFlags(flag.CommandLine, absentFromHelp) + daemonFlags.Require(flag.Exact, 0) + + return &DaemonCli{ + Config: daemonConfig, + registryOptions: registryOptions, + } +} + +func migrateKey() (err error) { + // Migrate trust key if exists at ~/.docker/key.json and owned by current user + oldPath := filepath.Join(cliconfig.ConfigDir(), defaultTrustKeyFile) + newPath := filepath.Join(getDaemonConfDir(), defaultTrustKeyFile) + if _, statErr := os.Stat(newPath); os.IsNotExist(statErr) && currentUserIsOwner(oldPath) { + defer func() { + // Ensure old path is removed if no error occurred + if err == nil { + err = os.Remove(oldPath) + } else { + logrus.Warnf("Key migration failed, key file not removed at %s", oldPath) + os.Remove(newPath) + } + }() + + if err := system.MkdirAll(getDaemonConfDir(), os.FileMode(0644)); err != nil { + return fmt.Errorf("Unable to create daemon configuration directory: %s", err) + } + + newFile, err := os.OpenFile(newPath, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600) + if err != nil { + return fmt.Errorf("error creating key file %q: %s", newPath, err) + } + defer newFile.Close() + + oldFile, err := os.Open(oldPath) + if err != nil { + return fmt.Errorf("error opening key file %q: %s", oldPath, err) + } + defer oldFile.Close() + + if _, err := io.Copy(newFile, oldFile); err != nil { + return fmt.Errorf("error copying key: %s", err) + } + + logrus.Infof("Migrated key from %s to %s", oldPath, newPath) + } + + return nil +} + +// DaemonCli represents the daemon CLI. +type DaemonCli struct { + *daemon.Config + registryOptions *registry.Options +} + +func getGlobalFlag() (globalFlag *flag.Flag) { + defer func() { + if x := recover(); x != nil { + switch f := x.(type) { + case *flag.Flag: + globalFlag = f + default: + panic(x) + } + } + }() + visitor := func(f *flag.Flag) { panic(f) } + commonFlags.FlagSet.Visit(visitor) + clientFlags.FlagSet.Visit(visitor) + return +} + +// CmdDaemon is the daemon command, called the raw arguments after `docker daemon`. +func (cli *DaemonCli) CmdDaemon(args ...string) error { + // warn from uuid package when running the daemon + uuid.Loggerf = logrus.Warnf + + if *flDaemon { + // allow legacy forms `docker -D -d` and `docker -d -D` + logrus.Warn("please use 'docker daemon' instead.") + } else if !commonFlags.FlagSet.IsEmpty() || !clientFlags.FlagSet.IsEmpty() { + // deny `docker -D daemon` + illegalFlag := getGlobalFlag() + fmt.Fprintf(os.Stderr, "invalid flag '-%s'.\nSee 'docker daemon --help'.\n", illegalFlag.Names[0]) + os.Exit(1) + } else { + // allow new form `docker daemon -D` + flag.Merge(daemonFlags, commonFlags.FlagSet) + } + + daemonFlags.ParseFlags(args, true) + commonFlags.PostParse() + + if commonFlags.TrustKey == "" { + commonFlags.TrustKey = filepath.Join(getDaemonConfDir(), defaultTrustKeyFile) + } + + if utils.ExperimentalBuild() { + logrus.Warn("Running experimental build") + } + + logrus.SetFormatter(&logrus.TextFormatter{TimestampFormat: timeutils.RFC3339NanoFixed}) + + if err := setDefaultUmask(); err != nil { + logrus.Fatalf("Failed to set umask: %v", err) + } + + if len(cli.LogConfig.Config) > 0 { + if err := logger.ValidateLogOpts(cli.LogConfig.Type, cli.LogConfig.Config); err != nil { + logrus.Fatalf("Failed to set log opts: %v", err) + } + } + + var pfile *pidfile.PIDFile + if cli.Pidfile != "" { + pf, err := pidfile.New(cli.Pidfile) + if err != nil { + logrus.Fatalf("Error starting daemon: %v", err) + } + pfile = pf + defer func() { + if err := pfile.Remove(); err != nil { + logrus.Error(err) + } + }() + } + + serverConfig := &apiserver.Config{ + Logging: true, + Version: dockerversion.VERSION, + } + serverConfig = setPlatformServerConfig(serverConfig, cli.Config) + + defaultHost := opts.DefaultHost + if commonFlags.TLSOptions != nil { + if !commonFlags.TLSOptions.InsecureSkipVerify { + // server requires and verifies client's certificate + commonFlags.TLSOptions.ClientAuth = tls.RequireAndVerifyClientCert + } + tlsConfig, err := tlsconfig.Server(*commonFlags.TLSOptions) + if err != nil { + logrus.Fatal(err) + } + serverConfig.TLSConfig = tlsConfig + defaultHost = opts.DefaultTLSHost + } + + if len(commonFlags.Hosts) == 0 { + commonFlags.Hosts = make([]string, 1) + } + for i := 0; i < len(commonFlags.Hosts); i++ { + var err error + if commonFlags.Hosts[i], err = opts.ParseHost(defaultHost, commonFlags.Hosts[i]); err != nil { + logrus.Fatalf("error parsing -H %s : %v", commonFlags.Hosts[i], err) + } + } + for _, protoAddr := range commonFlags.Hosts { + protoAddrParts := strings.SplitN(protoAddr, "://", 2) + if len(protoAddrParts) != 2 { + logrus.Fatalf("bad format %s, expected PROTO://ADDR", protoAddr) + } + serverConfig.Addrs = append(serverConfig.Addrs, apiserver.Addr{Proto: protoAddrParts[0], Addr: protoAddrParts[1]}) + } + api, err := apiserver.New(serverConfig) + if err != nil { + logrus.Fatal(err) + } + + // The serve API routine never exits unless an error occurs + // We need to start it as a goroutine and wait on it so + // daemon doesn't exit + // All servers must be protected with some mechanism (systemd socket, listenbuffer) + // which prevents real handling of request until routes will be set. + serveAPIWait := make(chan error) + go func() { + if err := api.ServeAPI(); err != nil { + logrus.Errorf("ServeAPI error: %v", err) + serveAPIWait <- err + return + } + serveAPIWait <- nil + }() + + if err := migrateKey(); err != nil { + logrus.Fatal(err) + } + cli.TrustKeyPath = commonFlags.TrustKey + + registryService := registry.NewService(cli.registryOptions) + d, err := daemon.NewDaemon(cli.Config, registryService) + if err != nil { + if pfile != nil { + if err := pfile.Remove(); err != nil { + logrus.Error(err) + } + } + logrus.Fatalf("Error starting daemon: %v", err) + } + + logrus.Info("Daemon has completed initialization") + + logrus.WithFields(logrus.Fields{ + "version": dockerversion.VERSION, + "commit": dockerversion.GITCOMMIT, + "execdriver": d.ExecutionDriver().Name(), + "graphdriver": d.GraphDriver().String(), + }).Info("Docker daemon") + + api.InitRouters(d) + + signal.Trap(func() { + api.Close() + <-serveAPIWait + shutdownDaemon(d, 15) + if pfile != nil { + if err := pfile.Remove(); err != nil { + logrus.Error(err) + } + } + }) + + // after the daemon is done setting up we can tell the api to start + // accepting connections with specified daemon + notifySystem() + api.AcceptConnections() + + // Daemon is fully initialized and handling API traffic + // Wait for serve API to complete + errAPI := <-serveAPIWait + shutdownDaemon(d, 15) + if errAPI != nil { + if pfile != nil { + if err := pfile.Remove(); err != nil { + logrus.Error(err) + } + } + logrus.Fatalf("Shutting down due to ServeAPI error: %v", errAPI) + } + return nil +} + +// shutdownDaemon just wraps daemon.Shutdown() to handle a timeout in case +// d.Shutdown() is waiting too long to kill container or worst it's +// blocked there +func shutdownDaemon(d *daemon.Daemon, timeout time.Duration) { + ch := make(chan struct{}) + go func() { + d.Shutdown() + close(ch) + }() + select { + case <-ch: + logrus.Debug("Clean shutdown succeeded") + case <-time.After(timeout * time.Second): + logrus.Error("Force shutdown daemon") + } +} diff --git a/docker/daemon_freebsd.go b/docker/daemon_freebsd.go new file mode 100644 index 0000000000..013f0e910e --- /dev/null +++ b/docker/daemon_freebsd.go @@ -0,0 +1,7 @@ +// +build daemon + +package docker + +// notifySystem sends a message to the host when the server is ready to be used +func notifySystem() { +} diff --git a/docker/daemon_linux.go b/docker/daemon_linux.go new file mode 100644 index 0000000000..4f4e172c6e --- /dev/null +++ b/docker/daemon_linux.go @@ -0,0 +1,14 @@ +// +build daemon + +package main + +import ( + systemdDaemon "github.com/coreos/go-systemd/daemon" + _ "github.com/docker/docker/daemon/execdriver/lxc" +) + +// notifySystem sends a message to the host when the server is ready to be used +func notifySystem() { + // Tell the init daemon we are accepting requests + go systemdDaemon.SdNotify("READY=1") +} diff --git a/docker/daemon_none.go b/docker/daemon_none.go new file mode 100644 index 0000000000..995f6a5b6d --- /dev/null +++ b/docker/daemon_none.go @@ -0,0 +1,16 @@ +// +build !daemon + +package main + +import "github.com/docker/docker/cli" + +const daemonUsage = "" + +var daemonCli cli.Handler + +// TODO: remove once `-d` is retired +func handleGlobalDaemonFlag() {} + +// notifySystem sends a message to the host when the server is ready to be used +func notifySystem() { +} diff --git a/docker/daemon_unix.go b/docker/daemon_unix.go new file mode 100644 index 0000000000..7754130d34 --- /dev/null +++ b/docker/daemon_unix.go @@ -0,0 +1,50 @@ +// +build daemon,!windows + +package main + +import ( + "fmt" + "os" + "syscall" + + apiserver "github.com/docker/docker/api/server" + "github.com/docker/docker/daemon" + "github.com/docker/docker/pkg/system" + + _ "github.com/docker/docker/daemon/execdriver/native" +) + +func setPlatformServerConfig(serverConfig *apiserver.Config, daemonCfg *daemon.Config) *apiserver.Config { + serverConfig.SocketGroup = daemonCfg.SocketGroup + serverConfig.EnableCors = daemonCfg.EnableCors + serverConfig.CorsHeaders = daemonCfg.CorsHeaders + + return serverConfig +} + +// currentUserIsOwner checks whether the current user is the owner of the given +// file. +func currentUserIsOwner(f string) bool { + if fileInfo, err := system.Stat(f); err == nil && fileInfo != nil { + if int(fileInfo.UID()) == os.Getuid() { + return true + } + } + return false +} + +// setDefaultUmask sets the umask to 0022 to avoid problems +// caused by custom umask +func setDefaultUmask() error { + desiredUmask := 0022 + syscall.Umask(desiredUmask) + if umask := syscall.Umask(desiredUmask); umask != desiredUmask { + return fmt.Errorf("failed to set umask: expected %#o, got %#o", desiredUmask, umask) + } + + return nil +} + +func getDaemonConfDir() string { + return "/etc/docker" +} diff --git a/docker/daemon_windows.go b/docker/daemon_windows.go new file mode 100644 index 0000000000..a9301529c3 --- /dev/null +++ b/docker/daemon_windows.go @@ -0,0 +1,33 @@ +// +build daemon + +package main + +import ( + "os" + + apiserver "github.com/docker/docker/api/server" + "github.com/docker/docker/daemon" +) + +func setPlatformServerConfig(serverConfig *apiserver.Config, daemonCfg *daemon.Config) *apiserver.Config { + return serverConfig +} + +// currentUserIsOwner checks whether the current user is the owner of the given +// file. +func currentUserIsOwner(f string) bool { + return false +} + +// setDefaultUmask doesn't do anything on windows +func setDefaultUmask() error { + return nil +} + +func getDaemonConfDir() string { + return os.Getenv("PROGRAMDATA") + `\docker\config` +} + +// notifySystem sends a message to the host when the server is ready to be used +func notifySystem() { +} diff --git a/docker/docker.go b/docker/docker.go new file mode 100644 index 0000000000..4795b8046d --- /dev/null +++ b/docker/docker.go @@ -0,0 +1,84 @@ +package main + +import ( + "fmt" + "os" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/client" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/reexec" + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/utils" +) + +func main() { + if reexec.Init() { + return + } + + // Set terminal emulation based on platform as required. + stdin, stdout, stderr := term.StdStreams() + + logrus.SetOutput(stderr) + + flag.Merge(flag.CommandLine, clientFlags.FlagSet, commonFlags.FlagSet) + + flag.Usage = func() { + fmt.Fprint(os.Stdout, "Usage: docker [OPTIONS] COMMAND [arg...]\n"+daemonUsage+" docker [ --help | -v | --version ]\n\n") + fmt.Fprint(os.Stdout, "A self-sufficient runtime for containers.\n\nOptions:\n") + + flag.CommandLine.SetOutput(os.Stdout) + flag.PrintDefaults() + + help := "\nCommands:\n" + + for _, cmd := range dockerCommands { + help += fmt.Sprintf(" %-10.10s%s\n", cmd.Name, cmd.Description) + } + + help += "\nRun 'docker COMMAND --help' for more information on a command." + fmt.Fprintf(os.Stdout, "%s\n", help) + } + + flag.Parse() + + if *flVersion { + showVersion() + return + } + + if *flHelp { + // if global flag --help is present, regardless of what other options and commands there are, + // just print the usage. + flag.Usage() + return + } + + // TODO: remove once `-d` is retired + handleGlobalDaemonFlag() + clientCli := client.NewDockerCli(stdin, stdout, stderr, clientFlags) + + c := cli.New(clientCli, daemonCli) + if err := c.Run(flag.Args()...); err != nil { + if sterr, ok := err.(cli.StatusError); ok { + if sterr.Status != "" { + fmt.Fprintln(os.Stderr, sterr.Status) + os.Exit(1) + } + os.Exit(sterr.StatusCode) + } + fmt.Fprintln(os.Stderr, err) + os.Exit(1) + } +} + +func showVersion() { + if utils.ExperimentalBuild() { + fmt.Printf("Docker version %s, build %s, experimental\n", dockerversion.VERSION, dockerversion.GITCOMMIT) + } else { + fmt.Printf("Docker version %s, build %s\n", dockerversion.VERSION, dockerversion.GITCOMMIT) + } +} diff --git a/docker/docker_windows.go b/docker/docker_windows.go new file mode 100644 index 0000000000..a31dffc95c --- /dev/null +++ b/docker/docker_windows.go @@ -0,0 +1,5 @@ +package main + +import ( + _ "github.com/docker/docker/autogen/winresources" +) diff --git a/docker/flags.go b/docker/flags.go new file mode 100644 index 0000000000..35a8108880 --- /dev/null +++ b/docker/flags.go @@ -0,0 +1,30 @@ +package main + +import ( + "sort" + + "github.com/docker/docker/cli" + flag "github.com/docker/docker/pkg/mflag" +) + +var ( + flHelp = flag.Bool([]string{"h", "-help"}, false, "Print usage") + flVersion = flag.Bool([]string{"v", "-version"}, false, "Print version information and quit") +) + +type byName []cli.Command + +func (a byName) Len() int { return len(a) } +func (a byName) Swap(i, j int) { a[i], a[j] = a[j], a[i] } +func (a byName) Less(i, j int) bool { return a[i].Name < a[j].Name } + +var dockerCommands []cli.Command + +// TODO(tiborvass): do not show 'daemon' on client-only binaries + +func init() { + for _, cmd := range cli.DockerCommands { + dockerCommands = append(dockerCommands, cmd) + } + sort.Sort(byName(dockerCommands)) +} diff --git a/docker/flags_test.go b/docker/flags_test.go new file mode 100644 index 0000000000..28021ba4c9 --- /dev/null +++ b/docker/flags_test.go @@ -0,0 +1,13 @@ +package main + +import ( + "sort" + "testing" +) + +// Tests if the subcommands of docker are sorted +func TestDockerSubcommandsAreSorted(t *testing.T) { + if !sort.IsSorted(byName(dockerCommands)) { + t.Fatal("Docker subcommands are not in sorted order") + } +} diff --git a/dockerinit/dockerinit.go b/dockerinit/dockerinit.go new file mode 100644 index 0000000000..a6754b05a1 --- /dev/null +++ b/dockerinit/dockerinit.go @@ -0,0 +1,12 @@ +package main + +import ( + _ "github.com/docker/docker/daemon/execdriver/lxc" + _ "github.com/docker/docker/daemon/execdriver/native" + "github.com/docker/docker/pkg/reexec" +) + +func main() { + // Running in init mode + reexec.Init() +} diff --git a/docs-cs/Dockerfile b/docs-cs/Dockerfile new file mode 100644 index 0000000000..ae009fbb06 --- /dev/null +++ b/docs-cs/Dockerfile @@ -0,0 +1,8 @@ +FROM docs/base:oss +MAINTAINER Docker Docs + +ENV PROJECT=cs-engine +# to get the git info for this repo +COPY . /src +RUN rm -rf /docs/content/$PROJECT/ +COPY . /docs/content/$PROJECT/ diff --git a/docs-cs/Makefile b/docs-cs/Makefile new file mode 100644 index 0000000000..5a83bf6b37 --- /dev/null +++ b/docs-cs/Makefile @@ -0,0 +1,38 @@ +.PHONY: all default docs docs-build docs-shell shell test + +# to allow `make DOCSDIR=docs docs-shell` (to create a bind mount in docs) +DOCS_MOUNT := $(if $(DOCSDIR),-v $(CURDIR)/$(DOCSDIR):/$(DOCSDIR)) + +# to allow `make DOCSPORT=9000 docs` +DOCSPORT := 8000 + +# Get the IP ADDRESS +DOCKER_IP=$(shell python -c "import urlparse ; print urlparse.urlparse('$(DOCKER_HOST)').hostname or ''") +HUGO_BASE_URL=$(shell test -z "$(DOCKER_IP)" && echo localhost || echo "$(DOCKER_IP)") +HUGO_BIND_IP=0.0.0.0 + +GIT_BRANCH := $(shell git rev-parse --abbrev-ref HEAD 2>/dev/null) +GIT_BRANCH_CLEAN := $(shell echo $(GIT_BRANCH) | sed -e "s/[^[:alnum:]]/-/g") +DOCKER_DOCS_IMAGE := docker-docs$(if $(GIT_BRANCH_CLEAN),:$(GIT_BRANCH_CLEAN)) + +DOCKER_RUN_DOCS := docker run --rm -it $(DOCS_MOUNT) -e AWS_S3_BUCKET -e NOCACHE + +# for some docs workarounds (see below in "docs-build" target) +GITCOMMIT := $(shell git rev-parse --short HEAD 2>/dev/null) + +default: docs + +docs: docs-build + $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 -e DOCKERHOST "$(DOCKER_DOCS_IMAGE)" hugo server --port=$(DOCSPORT) --baseUrl=$(HUGO_BASE_URL) --bind=$(HUGO_BIND_IP) + +docs-draft: docs-build + $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 -e DOCKERHOST "$(DOCKER_DOCS_IMAGE)" hugo server --buildDrafts="true" --port=$(DOCSPORT) --baseUrl=$(HUGO_BASE_URL) --bind=$(HUGO_BIND_IP) + +docs-shell: docs-build + $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 "$(DOCKER_DOCS_IMAGE)" bash + +test: docs-build + $(DOCKER_RUN_DOCS) "$(DOCKER_DOCS_IMAGE)" + +docs-build: + docker build -t "$(DOCKER_DOCS_IMAGE)" . diff --git a/docs-cs/index.md b/docs-cs/index.md new file mode 100644 index 0000000000..c9b722436c --- /dev/null +++ b/docs-cs/index.md @@ -0,0 +1,19 @@ + + +# Docker CS Engine + +This section includes the following topics: + +* [Install CS Docker Engine](install.md) +* [Upgrade](upgrade.md) +* [Release notes](release-notes/release-notes.md) diff --git a/docs-cs/install.md b/docs-cs/install.md new file mode 100644 index 0000000000..528ddb25f8 --- /dev/null +++ b/docs-cs/install.md @@ -0,0 +1,201 @@ + + + +# Install CS Docker Engine + +Follow these instructions to install CS Docker Engine, the commercially +supported version of Docker Engine. + +CS Docker Engine can be installed on the following operating systems: + + +* [CentOS 7.1/7.2 & RHEL 7.0/7.1/7.2 (YUM-based systems)](#install-on-centos-7-1-7-2-rhel-7-0-7-1-7-2-yum-based-systems) +* [Ubuntu 14.04 LTS](#install-on-ubuntu-14-04-lts) +* [SUSE Linux Enterprise 12](#install-on-suse-linux-enterprise-12-3) + + +## Install on CentOS 7.1/7.2 & RHEL 7.0/7.1/7.2 (YUM-based systems) + +This section explains how to install on CentOS 7.1/7.2 & RHEL 7.0/7.1/7.2. Only +these versions are supported. CentOS 7.0 is **not** supported. On RHEL, +depending on your current level of updates, you may need to reboot your server +to update its RHEL kernel. + +1. Log into the system as a user with root or sudo permissions. + +2. Add the Docker public key for CS packages: + + ```bash + $ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e" + ``` + +3. Install yum-utils if necessary: + + ```bash + $ sudo yum install -y yum-utils + ``` + +4. Add the Docker repository: + + ```bash + $ sudo yum-config-manager --add-repo https://packages.docker.com/1.12/yum/repo/main/centos/7 + ``` + + This adds the repository of the latest version of CS Docker Engine. You can + customize the URL to install an older version. + +5. Install Docker CS Engine: + + ```bash + $ sudo yum install docker-engine + ``` + +6. Enable the Docker daemon as a service and start it. + + ```bash + $ sudo systemctl enable docker.service + $ sudo systemctl start docker.service + ``` + +7. Confirm the Docker daemon is running: + + ```bash + $ sudo docker info + ``` + +8. Optionally, add non-sudo access to the Docker socket by adding your user +to the `docker` group. + + ```bash + $ sudo usermod -a -G docker $USER + ``` + +9. Log out and log back in to have your new permissions take effect. + +## Install on Ubuntu 14.04 LTS + +1. Log into the system as a user with root or sudo permissions. + +2. Add Docker's public key for CS packages: + + ```bash + $ curl -s 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' | sudo apt-key add --import + ``` + +3. Install the HTTPS helper for apt (your system may already have it): + + ```bash + $ sudo apt-get update && sudo apt-get install apt-transport-https + ``` + +4. Install additional virtual drivers not in the base image. + + ```bash + $ sudo apt-get install -y linux-image-extra-virtual + ``` + + You may need to reboot your server after updating the LTS kernel. + +5. Add the repository for the new version: + + ```bash + $ echo "deb https://packages.docker.com/1.12/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list + ``` + + This adds the repository of the latest version of CS Docker Engine for the + Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the + distribution you're using: + + * debian-jessie (Debian 8) + * debian-stretch (future release) + * debian-wheezy (Debian 7) + * ubuntu-precise (Ubuntu 12.04) + * ubuntu-trusty (Ubuntu 14.04) + * ubuntu-utopic (Ubuntu 14.10) + * ubuntu-vivid (Ubuntu 15.04) + * ubuntu-wily (Ubuntu 15.10) + +6. Run the following to install commercially supported Docker Engine and its +dependencies: + + ```bash + $ sudo apt-get update && sudo apt-get install docker-engine + ``` + +7. Confirm the Docker daemon is running: + + ```bash + $ sudo docker info + ``` + +8. Optionally, add non-sudo access to the Docker socket by adding your +user to the `docker` group. + + ```bash + $ sudo usermod -a -G docker $USER + ``` + + Log out and log back in to have your new permissions take effect. + + +## Install on SUSE Linux Enterprise 12.3 + +1. Log into the system as a user with root or sudo permissions. + +2. Refresh your repository so that curl commands and CA certificates +are available: + + ```bash + $ sudo zypper ref + ``` + +3. Add the Docker repository and public key: + + ```bash + $ sudo zypper ar -t YUM https://packages.docker.com/1.12/yum/repo/main/opensuse/12.3 docker-1.12 + $ sudo rpm --import 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' + ``` + + This adds the repository of the latest version of CS Docker Engine. You can + customize the URL to install an older version. + +4. Install the Docker daemon package: + + ```bash + $ sudo zypper install docker-engine + ``` + +5. Enable the Docker daemon as a service and then start it: + + ```bash + $ sudo systemctl enable docker.service + $ sudo systemctl start docker.service + ``` + +6. Confirm the Docker daemon is running: + + ```bash + $ sudo docker info + ``` + +7. Optionally, add non-sudo access to the Docker socket by adding your user +to the `docker` group. + + ```bash + $ sudo usermod -a -G docker $USER + ``` + +8. Log out and log back in to have your new permissions take effect. diff --git a/docs-cs/release-notes/index.md b/docs-cs/release-notes/index.md new file mode 100644 index 0000000000..f726b09875 --- /dev/null +++ b/docs-cs/release-notes/index.md @@ -0,0 +1,17 @@ + + +# Docker CS Engine release notes + +* [Release notes](release-notes.md) +* [Prior release notes](prior-release-notes.md) diff --git a/docs-cs/release-notes/prior-release-notes.md b/docs-cs/release-notes/prior-release-notes.md new file mode 100644 index 0000000000..5e735b7a43 --- /dev/null +++ b/docs-cs/release-notes/prior-release-notes.md @@ -0,0 +1,337 @@ + + +# CS Engine release notes archive + +This document contains the previous versions of the commercially supported +Docker Engine release notes. It includes issues, fixes, and new features. + +Refer to the [detailed list](https://github.com/docker/docker/releases) of all changes since the release of CS Engine 1.10.3-cs3 + +## CS Engine 1.10.3-cs3 +(25 April 2016) + +This release addresses the following issue: + +A vulnerability in the Go standard runtime libraries allowed a maliciously crafted client certificate to be used to cause an infinite loop in a TLS server. This can lead to a Denial of Service against the Docker Engine if it is deployed such that it uses TLS client certificate authentication. This vulnerability has been fixed in this release. We consider this a low-impact issue, due to complexity of attack. Customers should consider upgrading if their deployed Docker Engines are exposed to potentially malicious network attackers. + +This issue is resolved by using Go runtime v1.5.4 which was released to address this vulnerability + +* https://github.com/docker/docker/pull/21977 +* https://github.com/docker/docker/pull/21987 + +## CS Engine 1.10.3-cs2 +(18 March 2016) + +Bug fix release picking up changes from Docker 1.10.3 release. + +Refer to the [detailed list](https://github.com/docker/docker/releases/tag/v1.10.3) of all changes since the release of CS Engine 1.10.2-cs1 + +## CS Engine 1.10.2-cs1 +(22 February 2016) + +In this release the CS Engine is supported on SUSE Linux Enterprise 12 OS. + +Refer to the [detailed list](https://github.com/docker/docker/releases) of all changes since the release of CS Engine 1.9.1. + +## CS Engine 1.9.1-cs3 +(6 January 2016) + +This release addresses the following issues: + +* The commercially supported Engine 1.9.1-cs3 now supports multi-host networking +for all the kernels that the base CS Engine is supported on. + +>**Note**: Centos 7 has its firewall enabled by default and it prevents the VXLAN tunnel from communicating. If this applies to you, then after installing the CS Engine, execute the following command in the Linux host: + +`sudo firewall-cmd --zone=public --permanent --add-port=4789/udp` + + +* Corrected an issue where Docker didn't remove the Masquerade NAT rule from `iptables` when the network was removed. This caused the gateway address to be +incorrectly propagated as the source address of a connection. + +* Fixed an issue where if the daemon started multiple containers concurrently, then the `/etc/hosts` files were incompletely populated. This issue occurred randomly. + +* Corrected an issue where the same IP address for different Docker containers resulted in network connection inconsistencies. Now each container has a separate IP address. + +* Corrected an issue where the IPv6 gateway was not created when using custom networks although the network had a configured gateway. + +* Fixed an issue where users might have experienced a panic error if the daemon was started with the `—cluster-store` option, but without the `—cluster-advertise` option. + +## CS Engine 1.9.1-cs2 +(4 December 2015) + +Starting with this release, upgrading minor versions, for example, from 1.9.0 to 1.9.1, is faster and easier. + +You can refer to the detailed list of all changes since the release of CS Engine +1.9.0 +https://github.com/docker/docker/releases. + +## CS Engine 1.9.0 +(12 November 2015) + +Highlighted feature summary: + +* Network Management and Plugins. Networks are now first class objects that can be listed, created, deleted, inspected, and connected to or disconnected from a +container. They can be manipulated outside of the container themselves and are +fully manageable on its own lifecycle. You can also use plugins to extend +network functionality. + +* Docker, Inc. now provides support for the in-box Overlay (for cross-host networking) and Bridge network plugins. You can find more information about how +to manage networks and using network plugins in the [documentation](/engine/userguide/networking/index.md). + +* Volume Management and Plugins. Volumes also become discrete, manageable objects in Docker. Volumes can be listed, created, deleted, and inspected. +Similar to networks, they have their own managed lifecycle outside of the +container. Plugins allow others to write and extend the functionality of volumes +or provide integration with other types of storage. + +* The in-box volume driver is included and supported. You can find more information about how to manage volumes and using volume plugins in the +documentation. + +* Docker Content Trust. Use Content Trust to both verify the integrity and the publisher of all the data received from a registry over any channel. Content Trust is currently only supported using Docker Hub notary servers. + +* Updated the release cadence of the CS Docker Engine. Starting with this version, Docker supports **every** major release of Docker Engine from open +source with three releases under support at one time. This means you’ll be able +to take advantage of the latest and greatest features and you won’t have to wait +for a supported release to take advantage of a specific feature. + +Refer to the [detailed list](https://github.com/docker/docker/releases) of all changes since the release of CS Engine 1.6. + +## CS Engine 1.6.2-cs7 +(12 October 2015) + +As part of our ongoing security efforts, a vulnerability was discovered that affects the way content +is stored and retrieved within the Docker Engine and CS Docker Engine. Today we +are releasing a security update that fixes this issue in both Docker Engine 1.8.3 and CS Docker Engine 1.6.2-cs7. The change log for Docker Engine 1.8.3 has a complete list of all the changes incorporated into both the open source and commercially +supported releases. + +We recommend that users upgrade to CS Docker Engine 1.6.2-cs7. If you are unable +to upgrade to CS Docker Engine 1.6.2-cs7 right away, remember to only pull +content from trusted sources. + +To keep up to date on all the latest Docker Security news, make sure you check +out our [Security page](http://www.docker.com/docker-security), subscribe to our mailing list, or find us in #docker-security. + +## CS Docker Engine 1.6.2-cs6 +(23 July 2015) + +Certifies support for CentOS 7.1. + +## CS Docker Engine 1.6.2-cs5 +(21 May 2015) + +For customers running Docker Engine on [supported versions of RedHat Enterprise Linux](https://www.docker.com/enterprise/support/) with SELinux enabled, the `docker build` and `docker run` commands will not have DNS host name resolution and bind-mounted volumes may not be accessible. As a result, customers with +SELinux will be unable to use hostname-based network access in either `docker build` or `docker run`, nor will they be able to `docker run` containers that use `--volume` or `-v` bind-mounts (with an incorrect SELinux label) in their environment. By installing Docker Engine 1.6.2-cs5, customers can use Docker as intended on RHEL with SELinux enabled. + +For example, you see will failures such as: + + ``` + [root@dtr ~]# docker -v + Docker version 1.6.0-cs2, build b8dd430 + [root@dtr ~]# ping dtr.home.org.au + PING dtr.home.org.au (10.10.10.104) 56(84) bytes of data. + 64 bytes from dtr.home.gateway (10.10.10.104): icmp_seq=1 ttl=64 time=0.663 ms + ^C + --- dtr.home.org.au ping statistics --- + 2 packets transmitted, 2 received, 0% packet loss, time 1001ms + rtt min/avg/max/mdev = 0.078/0.370/0.663/0.293 ms + [root@dtr ~]# docker run --rm -it debian ping dtr.home.org.au + ping: unknown host + [root@dtr ~]# docker run --rm -it debian cat /etc/resolv.conf + cat: /etc/resolv.conf: Permission denied + [root@dtr ~]# docker run --rm -it debian apt-get update + Err http://httpredir.debian.org jessie InRelease + + Err http://security.debian.org jessie/updates InRelease + + Err http://httpredir.debian.org jessie-updates InRelease + + Err http://security.debian.org jessie/updates Release.gpg + Could not resolve 'security.debian.org' + Err http://httpredir.debian.org jessie Release.gpg + Could not resolve 'httpredir.debian.org' + Err http://httpredir.debian.org jessie-updates Release.gpg + Could not resolve 'httpredir.debian.org' + [output truncated] + + ``` + +or when running a `docker build`: + + ``` + [root@dtr ~]# docker build . + Sending build context to Docker daemon 11.26 kB + Sending build context to Docker daemon + Step 0 : FROM fedora + ---> e26efd418c48 + Step 1 : RUN yum install httpd + ---> Running in cf274900ea35 + + One of the configured repositories failed (Fedora 21 - x86_64), + and yum doesn't have enough cached data to continue. At this point the only + safe thing yum can do is fail. There are a few ways to work "fix" this: + + [output truncated] + ``` + +**Affected Versions**: All previous versions of Docker Engine when SELinux is + enabled. + +Docker **highly recommends** that all customers running previous versions of Docker Engine update to this release. + +### **How to workaround this issue** + +Customers who choose not to install this update have two options. The first +option is to disable SELinux. This is *not recommended* for production systems +where SELinux is typically required. + +The second option is to pass the following parameter in to `docker run`. + + --security-opt=label:type:docker_t + +This parameter cannot be passed to the `docker build` command. + +### **Upgrade notes** + +When upgrading, make sure you stop Docker Trusted Registry first, perform the Engine upgrade, and then restart Docker Trusted Registry. + +If you are running with SELinux enabled, previous Docker Engine releases allowed +you to bind-mount additional volumes or files inside the container as follows: + + `$ docker run -it -v /home/user/foo.txt:/foobar.txt:ro ` + +In the 1.6.2-cs5 release, you must ensure additional bind-mounts have the +correct SELinux context. For example, if you want to mount `foobar.txt` as +read-only into the container, do the following to create and test your +bind-mount: + + 1. Add the `z` option to the bind mount when you specify `docker run`. + + $ docker run -it -v /home/user/foo.txt:/foobar.txt:ro,z + + 2. Exec into your new container. + + For example, if your container is `bashful_curie`, open a shell on the + container: + + $ docker exec -it bashful_curie bash + + 3. Use `cat` to check the permissions on the mounted file. + + $ cat /foobar.txt + the contents of foobar appear + +If you see the file's contents, your mount succeeded. If you receive a +`Permission denied` message and/or the `/var/log/audit/audit.log` file on your +Docker host contains an AVC Denial message, the mount did not succeed. + + type=AVC msg=audit(1432145409.197:7570): avc: denied { read } for pid=21167 comm="cat" name="foobar.txt" dev="xvda2" ino=17704136 scontext=system_u:system_r:svirt_lxc_net_t:s0:c909,c965 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file + +Recheck your command line to make sure you passed in the `z` option. + + +## CS Engine 1.6.2-cs4 +(13 May 2015) + +Fix mount regression for `/sys`. + +## CS Engine 1.6.1-cs3 +(11 May 2015) + +Docker Engine version 1.6.1 has been released to address several vulnerabilities +and is immediately available for all supported platforms. Users are advised to +upgrade existing installations of the Docker Engine and use 1.6.1 for new installations. + +It should be noted that each of the vulnerabilities allowing privilege escalation +may only be exploited by a malicious Dockerfile or image. Users are advised to +run their own images and/or images built by trusted parties, such as those in +the official images library. + +Send any questions to security@docker.com. + + +### **[CVE-2015-3629](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-3629) Symlink traversal on container respawn allows local privilege escalation** + +Libcontainer version 1.6.0 introduced changes which facilitated a mount namespace +breakout upon respawn of a container. This allowed malicious images to write +files to the host system and escape containerization. + +Libcontainer and Docker Engine 1.6.1 have been released to address this +vulnerability. Users running untrusted images are encouraged to upgrade Docker Engine. + +Discovered by Tõnis Tiigi. + + +### **[CVE-2015-3627](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-3627) Insecure opening of file-descriptor 1 leading to privilege escalation** + +The file-descriptor passed by libcontainer to the pid-1 process of a container +has been found to be opened prior to performing the chroot, allowing insecure +open and symlink traversal. This allows malicious container images to trigger +a local privilege escalation. + +Libcontainer and Docker Engine 1.6.1 have been released to address this +vulnerability. Users running untrusted images are encouraged to upgrade +Docker Engine. + +Discovered by Tõnis Tiigi. + +### **[CVE-2015-3630](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-3630) Read/write proc paths allow host modification & information disclosure** + +Several paths underneath /proc were writable from containers, allowing global +system manipulation and configuration. These paths included `/proc/asound`, +`/proc/timer_stats`, `/proc/latency_stats`, and `/proc/fs`. + +By allowing writes to `/proc/fs`, it has been noted that CIFS volumes could be +forced into a protocol downgrade attack by a root user operating inside of a +container. Machines having loaded the timer_stats module were vulnerable to +having this mechanism enabled and consumed by a container. + +We are releasing Docker Engine 1.6.1 to address this vulnerability. All +versions up to 1.6.1 are believed vulnerable. Users running untrusted +images are encouraged to upgrade. + +Discovered by Eric Windisch of the Docker Security Team. + +### **[CVE-2015-3631](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-3631) Volume mounts allow LSM profile escalation** + +By allowing volumes to override files of `/proc` within a mount namespace, a user +could specify arbitrary policies for Linux Security Modules, including setting +an unconfined policy underneath AppArmor, or a `docker_t` policy for processes +managed by SELinux. In all versions of Docker up until 1.6.1, it is possible for +malicious images to configure volume mounts such that files of proc may be overridden. + +We are releasing Docker Engine 1.6.1 to address this vulnerability. All versions +up to 1.6.1 are believed vulnerable. Users running untrusted images are encouraged +to upgrade. + +Discovered by Eric Windisch of the Docker Security Team. + +### **AppArmor policy improvements** + +The 1.6.1 release also marks preventative additions to the AppArmor policy. +Recently, several CVEs against the kernel have been reported whereby mount +namespaces could be circumvented through the use of the sys_mount syscall from +inside of an unprivileged Docker container. In all reported cases, the +AppArmor policy included in libcontainer and shipped with Docker has been +sufficient to deflect these attacks. However, we have deemed it prudent to +proactively tighten the policy further by outright denying the use of the +`sys_mount` syscall. + +Because this addition is preventative, no CVE-ID is requested. + +## CS Engine 1.6.0-cs2 +(23 Apr 2015) + +First release, see the [Docker Engine 1.6.0 Release notes](https://docs.docker.com/v1.6/release-notes/) + for more details. diff --git a/docs-cs/release-notes/release-notes.md b/docs-cs/release-notes/release-notes.md new file mode 100644 index 0000000000..6021629be2 --- /dev/null +++ b/docs-cs/release-notes/release-notes.md @@ -0,0 +1,100 @@ + + +# Commercially supported Engine release notes + +This document describes the latest changes, additions, known issues, and fixes +for the commercially supported Docker Engine (CS Engine). + +The CS Engine is functionally equivalent to the corresponding Docker Engine that +it references. However, a commercially supported release also includes +back-ported fixes (security-related and priority defects) from the open source. +It incorporates defect fixes that you can use in environments where new features +cannot be adopted as quickly for consistency and compatibility reasons. + +#### Prior versions + +These notes refer to the current and immediately prior releases of the +CS Engine. For notes on older versions, see the [CS Engine prior release notes archive](prior-release-notes.md). + +## CS Engine 1.12.1-cs1 +(20 Sep 2016) + +Refer to the [detailed list](https://github.com/docker/docker/releases) of all changes since the release of CS Engine 1.11.2-cs5 + +This release addresses the following issues: + +* [#25962](https://github.com/docker/docker/pull/25962) Allow normal containers to connect to swarm-mode overlay network +* Various bug fixes in swarm mode networking + +## CS Engine 1.11.2-cs5 +(13 Sep 2016) + +This release addresses the following issues: + +* Make the docker daemon ignore the `SIGPIPE` signal +[#19728](https://github.com/docker/docker/issues/19728) +* Fix race in libdevicemapper symlink handling +[#24671](https://github.com/docker/docker/issues/24671) +* Generate additional logging when unmarshalling devicemapper metadata +[#23974](https://github.com/docker/docker/pull/23974) +* Drop queries in root domain when ndots is set +[#1441](https://github.com/docker/libnetwork/pull/1441) + +## CS Engine 1.11.2-cs4 +(16 Aug 2016) + +This releases addresses the following issues: + +* Change systemd kill mode to `process` so systemd only stops the docker daemon +[#21933](https://github.com/docker/docker/issues/21933) +* Fix dropped external DNS responses when greater than 512 bytes +[#1373](https://github.com/docker/libnetwork/pull/1373) +* Remove UDP connection caching in embedded DNS server +[#1352](https://github.com/docker/libnetwork/pull/1352) +* Fix issue where truncated DNS replies were discarded by the embedded DNS server +[#1351](https://github.com/docker/libnetwork/pull/1351) + +## CS Engine 1.11.2-cs3 +(7 Jun 2016) + +This release addresses the following issues: + +* Fix potential panic when running `docker build` +[#23032](https://github.com/docker/docker/pull/23032) +* Fix interpretation of `--user` parameter +[#22998](https://github.com/docker/docker/pull/22998) +* Fix a bug preventing container statistics from being correctly reported +[#22955](https://github.com/docker/docker/pull/22955) +* Fix an issue preventing containers from being restarted after daemon restart +[#22947](https://github.com/docker/docker/pull/22947) +* Fix a possible deadlock on image deletion and container attach +[#22918](https://github.com/docker/docker/pull/22918) +* Fix an issue causing `docker ps` to hange when using devicemapper +[#22168](https://github.com/docker/docker/pull/22168) +* Fix a bug preventing to `docker exec` into a container when using +devicemapper [#22168](https://github.com/docker/docker/pull/22168) + +## CS Engine 1.11.1-cs2 +(17 May 2016) + +This release fixes the following issue which prevented DTR containers to be automatically restarted on a docker daemon restart: + +https://github.com/docker/docker/issues/22486 + +## CS Engine 1.11.1-cs1 +(27 April 2016) + +In this release the CS Engine is supported on RHEL 7.2 OS + diff --git a/docs-cs/upgrade.md b/docs-cs/upgrade.md new file mode 100644 index 0000000000..94b1f4a4de --- /dev/null +++ b/docs-cs/upgrade.md @@ -0,0 +1,272 @@ + + +# Upgrade CS Docker Engine + +This article explains how to upgrade your CS Docker Engine. + +The upgrade process depends on the version that is currently installed and the +version that you want to upgrade to: + +* [Upgrade from the same minor version](#upgrade-from-the-same-minor-version) +* [Upgrade from the same major version](#upgrade-from-the-same-major-version) +* [Upgrade from a legacy version](#upgrade-from-a-legacy-version) + +Before starting the upgrade, make sure you stop all containers running on the +host. This ensures your containers have time for cleaning up before exiting, +thus avoiding data loss or corruption. + +## Upgrade from the same minor version + +Use these instructions if you're upgrading your CS Docker Engine within the +same minor version. As an example, from 1.1.0 to 1.1.1. + +### CentOS 7.1 & RHEL 7.0/7.1 +Use these instructions to upgrade YUM-based systems. + +1. Update your docker-engine package: + + ```bash + $ sudo yum upgrade docker-engine + ``` + +2. Check that the CS Docker Engine is running: + + ```bash + $ sudo docker info + ``` + +### Ubuntu 14.04 LTS +Use these instructions to upgrade APT-based systems. + +1. Update your docker-engine package: + + ```bash + $ sudo apt-get update && sudo apt-get upgrade docker-engine + ``` + +2. Check that the CS Docker Engine is running: + + ```bash + $ sudo docker info + ``` + +### SUSE Enterprise 12.3 + +1. Update your docker-engine package: + + ```bash + $ sudo zypper upgrade docker-engine + ``` + +2. Check that the CS Docker Engine is running: + + ```bash + $ sudo docker info + ``` + + +## Upgrade from the same major version + +Use these instructions if you're upgrading your CS Docker Engine within the +same major version. As an example, from 1.1.x to 1.2.x. + + +### CentOS 7.1 & RHEL 7.0/7.1 +Use these instructions to upgrade YUM-based systems. + +1. Add the Docker Engine repository. + + ```bash + $ sudo yum-config-manager --add-repo https://packages.docker.com/1.12/yum/repo/main/centos/7 + ``` + + This adds the repository of the latest version of CS Docker Engine. You can + customize the URL to install other versions. + +2. Install the new package: + + ```bash + $ sudo yum update docker-engine + ``` + +3. Check that the CS Engine is running: + + ```bash + $ sudo docker info + ``` + +### Ubuntu 14.04 LTS +Use these instructions to update APT-based systems. + + +1. Add the docker engine repository. + + ```bash + $ echo "deb https://packages.docker.com/1.12/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list + ``` + + This adds the repository of the latest version of CS Docker Engine for the + Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the + distribution you're using: + + * debian-jessie (Debian 8) + * debian-stretch (future release) + * debian-wheezy (Debian 7) + * ubuntu-precise (Ubuntu 12.04) + * ubuntu-trusty (Ubuntu 14.04) + * ubuntu-utopic (Ubuntu 14.10) + * ubuntu-vivid (Ubuntu 15.04) + * ubuntu-wily (Ubuntu 15.10) + +2. Update your docker-engine package. + + ```bash + $ sudo apt-get update && sudo apt-get upgrade docker-engine + ``` + +3. Check that the CS Engine is running: + + ```bash + $ sudo docker info + ``` + +#### SUSE Enterprise 12.3 + +1. Add the docker engine repository. + + ```bash + $ sudo zypper ar -t YUM https://packages.docker.com/1.12/yum/repo/main/opensuse/12.3 docker-1.12 + ``` + + This adds the repository of the latest version of CS Docker Engine. You + can customize the URL to install other versions. + +2. Install the new package: + + ```bash + $ sudo zypper update docker-engine + ``` + +3. Check that the CS Engine is running: + + ```bash + $ sudo docker info + ``` + + +## Upgrade from a legacy version + +Use these instructions if you're upgrading your CS Docker Engine from a version +prior to 1.9. In this case you'll have to first uninstall CS Docker Engine, and +then install the latest version. + +### CentOS 7.1 & RHEL 7.0/7.1 +Use these instructions to upgrade YUM-based systems. + +1. Remove the current CS Engine: + + ```bash + $ sudo yum remove docker-engine-cs + ``` + +2. Add the Docker public key for CS packages: + + ```bash + $ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e" + ``` + +3. Install yum-utils if necessary: + + ```bash + $ sudo yum install -y yum-utils + ``` + +4. Add the repository for the new version and disable the old one. + + ```bash + $ sudo yum-config-manager --add-repo https://packages.docker.com/1.12/yum/repo/main/centos/7 + $ sudo yum-config-manager --disable 'Docker_cs*' + ``` + + This adds the repository of the latest version of CS Docker Engine. You + can customize the URL to install other versions. + +5. Install the new package: + + ```bash + $ sudo yum install docker-engine + ``` + +6. Enable the Docker daemon as a service and start it. + + ```bash + $ sudo systemctl enable docker.service + $ sudo systemctl start docker.service + ``` + +### Ubuntu 14.04 LTS +Use these instructions to update APT-based systems. + + +1. Remove the current Engine: + + ```bash + $ sudo apt-get remove docker-engine-cs + ``` + +2. Add the Docker public key for CS packages: + + ```bash + $ curl -s 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' | sudo apt-key add --import + ``` + +3. Install the HTTPS helper for apt (your system may already have it): + + ```bash + $ sudo apt-get update && sudo apt-get install apt-transport-https + ``` + +4. Install additional virtual drivers not in the base image. + + ```bash + $ sudo apt-get install -y linux-image-extra-virtual + ``` + + You may need to reboot your server after updating the LTS kernel. + +5. Add the repository for the new version: + + ```bash + $ echo "deb https://packages.docker.com/1.12/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list + ``` + + This adds the repository of the latest version of CS Docker Engine for the + Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the + distribution you're using: + + * debian-jessie (Debian 8) + * debian-stretch (future release) + * debian-wheezy (Debian 7) + * ubuntu-precise (Ubuntu 12.04) + * ubuntu-trusty (Ubuntu 14.04) + * ubuntu-utopic (Ubuntu 14.10) + * ubuntu-vivid (Ubuntu 15.04) + * ubuntu-wily (Ubuntu 15.10) + + +6. Install the upgraded package: + + ```bash + $ sudo apt-get upgrade docker-engine + ``` diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 0000000000..d22a3d702d --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,2 @@ +# avoid commiting the awsconfig file used for releases +awsconfig diff --git a/docs/Dockerfile b/docs/Dockerfile new file mode 100644 index 0000000000..4bda0271e7 --- /dev/null +++ b/docs/Dockerfile @@ -0,0 +1,16 @@ +FROM docs/base:hugo-github-linking +MAINTAINER Mary Anthony (@moxiegirl) + +# To get the git info for this repo +COPY . /src + +COPY . /docs/content/engine + +RUN svn checkout https://github.com/docker/compose/trunk/docs /docs/content/compose +RUN svn checkout https://github.com/docker/swarm/trunk/docs /docs/content/swarm +RUN svn checkout https://github.com/docker/machine/trunk/docs /docs/content/machine +RUN svn checkout https://github.com/docker/distribution/trunk/docs /docs/content/registry +RUN svn checkout https://github.com/kitematic/kitematic/trunk/docs /docs/content/kitematic +RUN svn checkout https://github.com/docker/tutorials/trunk/docs /docs/content/ +RUN svn checkout https://github.com/docker/opensource/trunk/docs /docs/content/opensource + diff --git a/docs/Makefile b/docs/Makefile new file mode 100644 index 0000000000..021e8f6e5e --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,55 @@ +.PHONY: all binary build cross default docs docs-build docs-shell shell test test-unit test-integration test-integration-cli test-docker-py validate + +# env vars passed through directly to Docker's build scripts +# to allow things like `make DOCKER_CLIENTONLY=1 binary` easily +# `docs/sources/contributing/devenvironment.md ` and `project/PACKAGERS.md` have some limited documentation of some of these +DOCKER_ENVS := \ + -e BUILDFLAGS \ + -e DOCKER_CLIENTONLY \ + -e DOCKER_EXECDRIVER \ + -e DOCKER_GRAPHDRIVER \ + -e TESTDIRS \ + -e TESTFLAGS \ + -e TIMEOUT +# note: we _cannot_ add "-e DOCKER_BUILDTAGS" here because even if it's unset in the shell, that would shadow the "ENV DOCKER_BUILDTAGS" set in our Dockerfile, which is very important for our official builds + +# to allow `make DOCSDIR=docs docs-shell` (to create a bind mount in docs) +DOCS_MOUNT := $(if $(DOCSDIR),-v $(CURDIR)/$(DOCSDIR):/$(DOCSDIR)) + +# to allow `make DOCSPORT=9000 docs` +DOCSPORT := 8000 + +# Get the IP ADDRESS +DOCKER_IP=$(shell python -c "import urlparse ; print urlparse.urlparse('$(DOCKER_HOST)').hostname or ''") +HUGO_BASE_URL=$(shell test -z "$(DOCKER_IP)" && echo localhost || echo "$(DOCKER_IP)") +HUGO_BIND_IP=0.0.0.0 + +GIT_BRANCH := $(shell git rev-parse --abbrev-ref HEAD 2>/dev/null) +DOCKER_IMAGE := docker$(if $(GIT_BRANCH),:$(GIT_BRANCH)) +DOCKER_DOCS_IMAGE := docs-base$(if $(GIT_BRANCH),:$(GIT_BRANCH)) + + +DOCKER_RUN_DOCS := docker run --rm -it $(DOCS_MOUNT) -e AWS_S3_BUCKET -e NOCACHE + +# for some docs workarounds (see below in "docs-build" target) +GITCOMMIT := $(shell git rev-parse --short HEAD 2>/dev/null) + +default: docs + +docs: docs-build + $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 -e DOCKERHOST "$(DOCKER_DOCS_IMAGE)" hugo server --port=$(DOCSPORT) --baseUrl=$(HUGO_BASE_URL) --bind=$(HUGO_BIND_IP) + +docs-draft: docs-build + $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 -e DOCKERHOST "$(DOCKER_DOCS_IMAGE)" hugo server --buildDrafts="true" --port=$(DOCSPORT) --baseUrl=$(HUGO_BASE_URL) --bind=$(HUGO_BIND_IP) + + +docs-shell: docs-build + $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 "$(DOCKER_DOCS_IMAGE)" bash + + +docs-build: +# ( git remote | grep -v upstream ) || git diff --name-status upstream/release..upstream/docs ./ > ./changed-files +# echo "$(GIT_BRANCH)" > GIT_BRANCH +# echo "$(AWS_S3_BUCKET)" > AWS_S3_BUCKET +# echo "$(GITCOMMIT)" > GITCOMMIT + docker build -t "$(DOCKER_DOCS_IMAGE)" . diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000000..96ded0c51a --- /dev/null +++ b/docs/README.md @@ -0,0 +1,295 @@ + + +# Docker Documentation + +The source for Docker documentation is in this directory. Our +documentation uses extended Markdown, as implemented by +[MkDocs](http://mkdocs.org). The current release of the Docker documentation +resides on [https://docs.docker.com](https://docs.docker.com). + +## Understanding the documentation branches and processes + +Docker has two primary branches for documentation: + +| Branch | Description | URL (published via commit-hook) | +|----------|--------------------------------|------------------------------------------------------------------------------| +| `docs` | Official release documentation | [https://docs.docker.com](https://docs.docker.com) | +| `master` | Merged but unreleased development work | [http://docs.master.dockerproject.org](http://docs.master.dockerproject.org) | + +Additions and updates to upcoming releases are made in a feature branch off of +the `master` branch. The Docker maintainers also support a `docs` branch that +contains the last release of documentation. + +After a release, documentation updates are continually merged into `master` as +they occur. This work includes new documentation for forthcoming features, bug +fixes, and other updates. Docker's CI system automatically builds and updates +the `master` documentation after each merge and posts it to +[http://docs.master.dockerproject.org](http://docs.master.dockerproject.org). + +Periodically, the Docker maintainers update `docs.docker.com` between official +releases of Docker. They do this by cherry-picking commits from `master`, +merging them into `docs`, and then publishing the result. + +In the rare case where a change is not forward-compatible, changes may be made +on other branches by special arrangement with the Docker maintainers. + +### Quickstart for documentation contributors + +If you are a new or beginner contributor, we encourage you to read through the +[our detailed contributors +guide](who-written-for.md). The guide explains in +detail, with examples, how to contribute. If you are an experienced contributor +this quickstart should be enough to get you started. + +The following is the essential workflow for contributing to the documentation: + +1. Fork the `docker/docker` repository. + +2. Clone the repository to your local machine. + +3. Select an issue from `docker/docker` to work on or submit a proposal of your +own. + +4. Create a feature branch from `master` in which to work. + + By basing from `master` your work is automatically included in the next + release. It also allows docs maintainers to easily cherry-pick your changes + into the `docs` release branch. + +4. Modify existing or add new `.md` files to the `docs` directory. + +5. As you work, build the documentation site locally to see your changes. + + The `docker/docker` repository contains a `Dockerfile` and a `Makefile`. + Together, these create a development environment in which you can build and + run a container running the Docker documentation website. To build the + documentation site, enter `make docs` at the root of your `docker/docker` + fork: + + $ make docs + .... (lots of output) .... + docker run --rm -it -e AWS_S3_BUCKET -p 8000:8000 "docker-docs:master" mkdocs serve + Running at: http://0.0.0.0:8000/ + Live reload enabled. + Hold ctrl+c to quit. + + + The build creates an image containing all the required tools, adds the local + `docs/` directory and generates the HTML files. Then, it runs a Docker + container with this image. + + The container exposes port 8000 on the localhost so that you can connect and + see your changes. If you use Docker Machine, the `docker-machine ip + ` command gives you the address of your server. + +6. Check your writing for style and mechanical errors. + + Use our [documentation style + guide](doc-style.md) to check style. There are + several [good grammar and spelling online + checkers](http://www.hemingwayapp.com/) that can check your writing + mechanics. + +7. Squash your commits on your branch. + +8. Make a pull request from your fork back to Docker's `master` branch. + +9. Work with the reviewers until your change is approved and merged. + +### Debugging and testing + +If you have any issues you need to debug, you can use `make docs-shell` and then +run `mkdocs serve`. You can use `make docs-test` to generate a report of missing +links that are referenced in the documentation—there should be none. + +## Style guide + +If you have questions about how to write for Docker's documentation, please see +the [style guide](doc-style.md). The style guide provides +guidance about grammar, syntax, formatting, styling, language, or tone. If +something isn't clear in the guide, please submit an issue to let us know or +submit a pull request to help us improve it. + + +## Publishing documentation (for Docker maintainers) + +To publish Docker's documentation you need to have Docker up and running on your +machine. You'll also need a `docs/awsconfig` file containing the settings you +need to access the AWS bucket you'll be deploying to. + +The process for publishing is to build first to an AWS bucket, verify the build, +and then publish the final release. + +1. Have Docker installed and running on your machine. + +2. Ask the core maintainers for the `awsconfig` file. + +3. Copy the `awsconfig` file to the `docs/` directory. + + The `awsconfig` file contains the profiles of the S3 buckets for our + documentation sites. (If needed, the release script creates an S3 bucket and + pushes the files to it.) Each profile has this format: + + [profile dowideit-docs] + aws_access_key_id = IHOIUAHSIDH234rwf.... + aws_secret_access_key = OIUYSADJHLKUHQWIUHE...... + region = ap-southeast-2 + + The `profile` name must be the same as the name of the bucket you are + deploying to. + +4. Call the `make` from the `docker` directory. + + $ make AWS_S3_BUCKET=dowideit-docs docs-release + + This publishes _only_ to the `http://bucket-url/v1.2/` version of the + documentation. + +5. If you're publishing the current release's documentation, you need to also +update the root docs pages by running + + $ make AWS_S3_BUCKET=dowideit-docs BUILD_ROOT=yes docs-release + +### Errors publishing using a Docker Machine VM + +Sometimes, in a Windows or Mac environment, the publishing procedure returns this +error: + + Post http:///var/run/docker.sock/build?rm=1&t=docker-docs%3Apost-1.2.0-docs_update-2: + dial unix /var/run/docker.sock: no such file or directory. + +If this happens, set the Docker host. Run the following command to get the +variables in your shell: + + docker-machine env + +Then, set your environment accordingly. + +## Cherry-picking documentation changes to update an existing release. + +Whenever the core team makes a release, they publish the documentation based on +the `release` branch. At that time, the `release` branch is copied into the +`docs` branch. The documentation team makes updates between Docker releases by +cherry-picking changes from `master` into any of the documentation branches. +Typically, we cherry-pick into the `docs` branch. + +For example, to update the current release's docs, do the following: + +1. Go to your `docker/docker` fork and get the latest from master. + + $ git fetch upstream + +2. Checkout a new branch based on `upstream/docs`. + + You should give your new branch a descriptive name. + + $ git checkout -b post-1.2.0-docs-update-1 upstream/docs + +3. In a browser window, open [https://github.com/docker/docker/commits/master]. + +4. Locate the merges you want to publish. + + You should only cherry-pick individual commits; do not cherry-pick merge + commits. To minimize merge conflicts, start with the oldest commit and work + your way forward in time. + +5. Copy the commit SHA from GitHub. + +6. Cherry-pick the commit. + + $ git cherry-pick -x fe845c4 + +7. Repeat until you have cherry-picked everything you want to merge. + +8. Push your changes to your fork. + + $ git push origin post-1.2.0-docs-update-1 + +9. Make a pull request to merge into the `docs` branch. + + Do __NOT__ merge into `master`. + +10. Have maintainers review your pull request. + +11. Once the PR has the needed "LGTMs", merge it on GitHub. + +12. Return to your local fork and make sure you are still on the `docs` branch. + + $ git checkout docs + +13. Fetch your merged pull request from `docs`. + + $ git fetch upstream/docs + +14. Ensure your branch is clean and set to the latest. + + $ git reset --hard upstream/docs + +15. Copy the `awsconfig` file into the `docs` directory. + +16. Make the beta documentation + + $ make AWS_S3_BUCKET=beta-docs.docker.io BUILD_ROOT=yes docs-release + +17. Open [the beta +website](http://beta-docs.docker.io.s3-website-us-west-2.amazonaws.com/) site +and make sure what you published is correct. + +19. When you're happy with your content, publish the docs to our live site: + + $ make AWS_S3_BUCKET=docs.docker.com BUILD_ROOT=yes +DISTRIBUTION_ID=C2K6......FL2F docs-release + +20. Test the uncached version of the live docs at [http://docs.docker.com.s3-website-us-east-1.amazonaws.com/] + + +### Caching and the docs + +New docs do not appear live on the site until the cache (a complex, distributed +CDN system) is flushed. The `make docs-release` command flushes the cache _if_ +the `DISTRIBUTION_ID` is set to the Cloudfront distribution ID. The cache flush +can take at least 15 minutes to run and you can check its progress with the CDN +Cloudfront Purge Tool Chrome app. + +## Removing files from the docs.docker.com site + +Sometimes it becomes necessary to remove files from the historical published documentation. +The most reliable way to do this is to do it directly using `aws s3` commands running in a +docs container: + +Start the docs container like `make docs-shell`, but bind mount in your `awsconfig`: + +``` +docker run --rm -it -v $(CURDIR)/docs/awsconfig:/docs/awsconfig docker-docs:master bash +``` + +and then the following example shows deleting 2 documents from s3, and then requesting the +CloudFlare cache to invalidate them: + + +``` +export BUCKET BUCKET=docs.docker.com +export AWS_CONFIG_FILE=$(pwd)/awsconfig +aws s3 --profile $BUCKET ls s3://$BUCKET +aws s3 --profile $BUCKET rm s3://$BUCKET/v1.0/reference/api/docker_io_oauth_api/index.html +aws s3 --profile $BUCKET rm s3://$BUCKET/v1.1/reference/api/docker_io_oauth_api/index.html + +aws configure set preview.cloudfront true +export DISTRIBUTION_ID=YUTIYUTIUTIUYTIUT +aws cloudfront create-invalidation --profile docs.docker.com --distribution-id $DISTRIBUTION_ID --invalidation-batch '{"Paths":{"Quantity":1, "Items":["/v1.0/reference/api/docker_io_oauth_api/"]},"CallerReference":"6Mar2015sventest1"}' +aws cloudfront create-invalidation --profile docs.docker.com --distribution-id $DISTRIBUTION_ID --invalidation-batch '{"Paths":{"Quantity":1, "Items":["/v1.1/reference/api/docker_io_oauth_api/"]},"CallerReference":"6Mar2015sventest1"}' +``` + +### Generate the man pages + +For information on generating man pages (short for manual page), see the README.md +document in [the man page directory](https://github.com/docker/docker/tree/master/docker) +in this project. + + + + diff --git a/docs/article-img/architecture.svg b/docs/article-img/architecture.svg new file mode 100644 index 0000000000..afe563ae83 --- /dev/null +++ b/docs/article-img/architecture.svg @@ -0,0 +1,2597 @@ + + + + + 2014-04-15 00:37Z + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/articles/ambassador_pattern_linking.md b/docs/articles/ambassador_pattern_linking.md new file mode 100644 index 0000000000..ab09f01934 --- /dev/null +++ b/docs/articles/ambassador_pattern_linking.md @@ -0,0 +1,160 @@ + + +# Link via an ambassador container + +## Introduction + +Rather than hardcoding network links between a service consumer and +provider, Docker encourages service portability, for example instead of: + + (consumer) --> (redis) + +Requiring you to restart the `consumer` to attach it to a different +`redis` service, you can add ambassadors: + + (consumer) --> (redis-ambassador) --> (redis) + +Or + + (consumer) --> (redis-ambassador) ---network---> (redis-ambassador) --> (redis) + +When you need to rewire your consumer to talk to a different Redis +server, you can just restart the `redis-ambassador` container that the +consumer is connected to. + +This pattern also allows you to transparently move the Redis server to a +different docker host from the consumer. + +Using the `svendowideit/ambassador` container, the link wiring is +controlled entirely from the `docker run` parameters. + +## Two host example + +Start actual Redis server on one Docker host + + big-server $ docker run -d --name redis crosbymichael/redis + +Then add an ambassador linked to the Redis server, mapping a port to the +outside world + + big-server $ docker run -d --link redis:redis --name redis_ambassador -p 6379:6379 svendowideit/ambassador + +On the other host, you can set up another ambassador setting environment +variables for each remote port we want to proxy to the `big-server` + + client-server $ docker run -d --name redis_ambassador --expose 6379 -e REDIS_PORT_6379_TCP=tcp://192.168.1.52:6379 svendowideit/ambassador + +Then on the `client-server` host, you can use a Redis client container +to talk to the remote Redis server, just by linking to the local Redis +ambassador. + + client-server $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli + redis 172.17.0.160:6379> ping + PONG + +## How it works + +The following example shows what the `svendowideit/ambassador` container +does automatically (with a tiny amount of `sed`) + +On the Docker host (192.168.1.52) that Redis will run on: + + # start actual redis server + $ docker run -d --name redis crosbymichael/redis + + # get a redis-cli container for connection testing + $ docker pull relateiq/redis-cli + + # test the redis server by talking to it directly + $ docker run -t -i --rm --link redis:redis relateiq/redis-cli + redis 172.17.0.136:6379> ping + PONG + ^D + + # add redis ambassador + $ docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 alpine:3.2 sh + +In the `redis_ambassador` container, you can see the linked Redis +containers `env`: + + / # env + REDIS_PORT=tcp://172.17.0.136:6379 + REDIS_PORT_6379_TCP_ADDR=172.17.0.136 + REDIS_NAME=/redis_ambassador/redis + HOSTNAME=19d7adf4705e + SHLVL=1 + HOME=/root + REDIS_PORT_6379_TCP_PORT=6379 + REDIS_PORT_6379_TCP_PROTO=tcp + REDIS_PORT_6379_TCP=tcp://172.17.0.136:6379 + TERM=xterm + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + PWD=/ + / # exit + +This environment is used by the ambassador `socat` script to expose Redis +to the world (via the `-p 6379:6379` port mapping): + + $ docker rm redis_ambassador + $ CMD="apk update && apk add socat && sh" + $ docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 alpine:3.2 sh -c "$CMD" + [...] + / # socat -t 100000000 TCP4-LISTEN:6379,fork,reuseaddr TCP4:172.17.0.136:6379 + +Now ping the Redis server via the ambassador: + +Now go to a different server: + + $ CMD="apk update && apk add socat && sh" + $ docker run -t -i --expose 6379 --name redis_ambassador alpine:3.2 sh -c "$CMD" + [...] + / # socat -t 100000000 TCP4-LISTEN:6379,fork,reuseaddr TCP4:192.168.1.52:6379 + +And get the `redis-cli` image so we can talk over the ambassador bridge. + + $ docker pull relateiq/redis-cli + $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli + redis 172.17.0.160:6379> ping + PONG + +## The svendowideit/ambassador Dockerfile + +The `svendowideit/ambassador` image is based on the `alpine:3.2` image with +`socat` installed. When you start the container, it uses a small `sed` +script to parse out the (possibly multiple) link environment variables +to set up the port forwarding. On the remote host, you need to set the +variable using the `-e` command line option. + + --expose 1234 -e REDIS_PORT_1234_TCP=tcp://192.168.1.52:6379 + +Will forward the local `1234` port to the remote IP and port, in this +case `192.168.1.52:6379`. + + # + # do + # docker build -t svendowideit/ambassador . + # then to run it (on the host that has the real backend on it) + # docker run -t -i -link redis:redis -name redis_ambassador -p 6379:6379 svendowideit/ambassador + # on the remote host, you can set up another ambassador + # docker run -t -i -name redis_ambassador -expose 6379 -e REDIS_PORT_6379_TCP=tcp://192.168.1.52:6379 svendowideit/ambassador sh + # you can read more about this process at https://docs.docker.com/articles/ambassador_pattern_linking/ + + # use alpine because its a minimal image with a package manager. + # prettymuch all that is needed is a container that has a functioning env and socat (or equivalent) + FROM alpine:3.2 + MAINTAINER SvenDowideit@home.org.au + + RUN apk update && \ + apk add socat && \ + rm -r /var/cache/ + + CMD env | grep _TCP= | sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat -t 100000000 TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \& wait/' | sh diff --git a/docs/articles/b2d_volume_images/add_cd.png b/docs/articles/b2d_volume_images/add_cd.png new file mode 100644 index 0000000000000000000000000000000000000000..50d7c4e7ed917161b5e0ebc3294583ec5e26ec44 GIT binary patch literal 27607 zcmZsCWmFtd(`GK3ogOkVSwN+!JXi)gA?4{-642z2oAyB-Q5{rW|sHe{m$-> z?Q{A^*FC3hRXwG*yCakpWzbLwQDIv(wtzy1&1FadBY>19NnAw7k50etzE9*Ec&mJ3l`^G&D3hIk~W~ zu)V!KHa51gv9Y$cc6NGtczF2d&!4HOsrB{s?(Xj2zkl!T?Y+Idz3;WUy4v60-_X#| z($X?KJpA|X-_6aRjD{+*wnWoBkBEiKK=%s`=#hsVd! z(b3M%&YGH<_V)I)w6r$})W*i<`sOAlC+Dl#6PwLbd_qE5X(}*C+emvsvV`Trn8V zc*waAs;sOmp7K;O2O8OZadL72)IkxHoBA#xQ0O(C$3GnySXQqy>4H;(Ht6~dSP=#W zUOc~k=DB(c+_n4&1FLX-)B%IQ@dSp(|GNt6eQMi#D=a94K1~qIWGVxnh4=-2_3ZIS z+!`4f9fF{~%TS@X>5k1a=*{zPe-zG-7UfLrQ4$j%F(1Nbr zi%W5F01RUaGYkw=zzu2?M`P1_KbLAe2+=jFVM^Vb&QSdp+#C0UAL^J%1Orpx!JpQ( zsH39|9a@SJfej4}%MpgXxY&m7pLew8UR_<;O+v&C5*h6BV05#g@%8Nm&amum(C>j( z!h-4bovf^^(5A7(J*ZCR5|J~E@dr57n7?_NFkUP$duyGpJ?CKX#@W$ieT3%x@h!XG zQeOn8oPUL706Sv2bNMxtL$?v;?i-~EmeuK44uw+%7@Az7$@IStFdOlz*wcoN{Xp_!k%kP*;0*u zu|F=98kSwIu+pfeMUY1)NrdG{qd+2g%stEfG}`k!UY;&5L=i6dtO-deSb#eH7dO7Q zFBY;i+=u#fSoviM+ust(%Td~gaU(w9lNdAeTdL~b=*7CM+NV9gttAcbrXXGXVJ9kd zq8LOkW8yHJgnsK-l~P1>URDGhUa^BQ-tCVV+Zh7z-%nMgFHM(vmN0BzwEDz*2kH|N zw*$X;SF=;PN~i+T2F*KngS9thPXAm!h&Y3Xg2}_!69U7L3_m8lWrnsA_to6h5Z#Q? zZf~491b3r-BJk|JH;&gCly(*S1=mm7I|BB>g`xWqA@0t2fA!Fxzx#{9-JYTdrqj$* znlAGf-2Dt;eYo@rye4(;D8=3%5-<0Boj{%{hs|h+3>cE4I~TVZExZce>hi~AkM$l{ z=5Q_wE3CfysPWNvR9?b2t8NuF)6}fKm%E}4^7bZjtQ6VU7)5X|V0ppi_t&2c?CF+Z9+S74|v0R_(Fsk-FP5TQWBSL=VbfumGfY7u=;r5Chw;rF9r>bst6Y1fCy7ADQ z{cYu~I^1`-b?F}ERp{QZ6f#&m^6y@EV+V3|`37g4C>({fOw(qA3L{qCyX}ak%yb;k zUOZsskTpNdc8qbncJF1j_lJnI3>1x(iDa#iR}cNM#Z3UIdjS`=cHEVJCV6=zxrAO$ zij=d-NvX1(?;?H~Oktjj#2YJ0>P6K^KH2@imaZphg~tY?X{Tve(oc0%OSPtyGj6Sp zd$!K^6pf&sX{(rOn0f(FY5zwzdf-P$UHOSiM&ipuRL>V+wixh~Lq6i%m6syddgpc} zQ&>X@CzM3S8%4cFxSiMe!f9uHEu-1=C>L@fexnmmq`S-cnhe#Wc z5%;%pm2%$V&H-HXlBz`4aa@$%R!Ymp7k)QT|GYVC)a{0s%A}bPYnTWr`}q6=rCjWg z)QTpY$KA6)+Dc%@^NENw|Aoqd2Iuuv>0rqP-sOrdg5Qgp`s43x5`L(OViBj)>)Fdp zfQ70KB%COMp=)AP<69eKhCae|{rZL;O=no>tjvq@bu0A_1GgHt6q&wZ-{}vaufkVS zFg`H|T_TlMibh+f`Y?R^9lN=sjpwRD9`{${x8`wvdl7U2mZ({Se-1ouUyDrfiUS zLnLOmUO}m1g6wfa;+IVu<%)8Vk-!=wiu#b?cL|z0Uk*HSA>p?(Ub>TJ3o-|ECwP!S zR)0t)aB`{aO$Gn?{AS&<$-wvVkU`cbh6-qk0e%R+WBe3_xfc7hav`QWcLlt8xvRgb zaPWKF?qV47ejZ)lDz5;(JPB>hsX^WElMJWKpli+$*!mp{uWq-&Y*9ok95t-^CgY0V zC>!5KaYi}{!<*Z_8uPho=xr-XT~C~TwQf7|vtUAt0j{<*oYp__>?a+pswyjvB?yyx z%8`8?cG1n7d6FO@12G-aDOqW2-k;<}a4OwNDvh_4uD1J2K^`?`mHdSD%CV>d50jO^ zF&Pl|D+HQ<$&u!Ik3GysWNcbFzGf*{$hI7xbRSOX=`17-u(fI2I;pqbM9Y>7V-HcM zIw)WyxvT2_+Ak3g@JF-{xl+{>*_*XXx;y^-1SxCR4M%HkoNHKJG*SB);rR8FE!u*e z)tViF+cdIAyIk|X$ZmTLrXM-!sk1HSiw|~7+(ns`VRY&r-At&DW7(Uff8L9=K4{Fy zb9O1Mt2RLG-tk(U30C>R6=a%t^WnT`T3@}1T3cr|)lr92lBSJw(m^}V8I@k@X3Urz zCjeeOx#)}EG#L7_s%sG{JT4pKi~j1<19h(Z=^`x~QTxtLlqboXgrd?Bfx+5~CCN8f z)@FM~qg<+fOqNO0QbGC6@gDjzXjp5wVz&V#A9L%@Y~s#xTih8g(+}MGNvmLQ{b8}X zJ+w2HJDCA9m|&TD?^uljUS9kQEJXPpdu}=AL1cx-RDU=SKde31d-=D?!@?z4snr|a z8KoavhE#=;?8AO@540`SHqZ%g8P=&3`HJfVH?+^j?CFPNoOXpKswzZM0v_oqR>w_+ zjtu(cEnFL10oA8nZSZt~kt@aaUmO5Vf86ihXxE?&eL^Il`xF$FHsf+7%;2MEzH_w= ze6zeOuKpG502fWw*TZ{g_7`uM$DWn3S&AVOkDuwgoEuJwTDPp&x(Gzz8G~Ko1Zn#G zNUJXm6S>HbGW-`h=Z!Erb5|=NTQy7*1@$Sn>^n$5vGYFxL86&p3Hr^g>8wi zXy1_5GKQj~$1H(AgG0u+*V)>vUZ%g{JLK)?@XcVYy+O$TdLFw{H+52|HCU;dh~f2* zMlvxaU*a28ARRTn38v|e5sf<*fy%hmJkkm~Z3ML;W<63^3&!8{?&w}tH`21@cqEZ! za=B=@r#?UHvd~X=>ms}UORHx@HldI`D!pKN?3*O5It)lpyH_ z_RaB&<>$y@GO@^Q_`K84U=9p$A9i2Ka4<5Mqy7HRGxTT=3LIN1uRsPOH>7{!{091y z!d=84?n`VOH^=8SM^&2Oo|}@b%4k5+4~K8O9H=z6nh9mc$PAlm-tLSN^(6MkK@6fy z__evAVA<0xEaMAaj6xO)>e-V@@NPXhgfjU&RiP`d`I7b&DrOmgO(hGz5&xUp-6@@n zh8}Nk+dWxI?Ctek0$%rkK=29&etIUf@uFvqFWCi`#{VuZBiy*9#BO4c{1%=xe0qMy&+4TD07ylpFt~ zLgD_WJbwDD;P@gc?Brl|r{-ph(;V(@;@pv8_}lnauldBfYZlw4{(EIa19V_7ts(EJ ze;1ExMtTl2_Y+6PKmSHv0RaK_`s>U$+|ZQepUZ1M>>*+Y6ImHNQ%_sw5Q3PIo8TZy zGK`pB`)*=j6o0{YI~}h{46SgisU#BkW$k|s}OzCZ>MIE zbaE_0cjSq8E!NKtIQ=%8zXtex-KO?=U(A&jbjjy5@f}`FPxLvjlQ&Wd*Hr0WwmgQ> zc`@^q-}TYiFk^A}!ly@{d+N+Dr*QLF%r^ZUciK0P@1@PaYexbPP_Niwa*a$MyJLp# zc1Z5lWSM@9l{XKVREj#>6tJ1-;@&w$PKe^;(8^oLF0;Wx1$K3YbS_#d$H8th zkw+X|>v^ROO7HU4)e5{-iS?5QZ`-XZ*K&6FUF*wF{KLspR9DS>e9PC}sQDVyV!UTQ z{qbwT@2tETfZ^pica~#fPu8%K#BL&a=Gpn-_)Tj$_83kJ-7m)eiZ@%s!_ga{;hI;H zm%%ycxDIpK#p%Yp}YF$)n`p_g?jzg@HXmV>#nDcWTKY4@toRH0V`<*aZ3Z5(o;+ux%QR8z7yT+Kkn@GKm;PL ztk+5y+u8U{VAu<|T9k}hx<7r98_ljFpe0l`i=;Ci@9S_uRh*e_9!#WOs zC(@*CCf5zuX}*HGj-z?RbAmecUG)Ee_L%cfHx<+}J|K>b))Y~Gu1hCvPuweeuyXfd zY*pK0uEoW(8MaNV1`7Cga@Z_{e@8I<0X$#ZW;`<7`&sN<^_|>1BZkw@TOxGKkDV4P zdesDT55M-zG6p^&7}3yVO8OfnW`XGB=LmE|mZ0FdvXGBAUwG(p+b^%@B!ms=a8MB? znw~;WOLFpLEDXdslo+WpHRWQ6yVh!G!o`K*U&L_>{WRHf-ET;!zC=~AdStcz{Beww z)F0d75xaHkW#AEzxw~r{E+J`8_N};PQ_}mQ@;@F=^1XP)uU_kThWksi5bG3HAZm{++8Ww(L3| z${a~I+icSsVAtUDo|T0>WCOA-IxPB|5#WxB4u4kh)0)&EUFYASjgO~uR(jsl<>KP5 za08(O-1Xc+hb5@zu%QCw_+vFdX{RKo3+F6Kw`b?eY!TfZpa1w#^UQh&-d_OI&^8*b zf?RT+%9hC4urNdIrNxS@&Q5XFIW_EFP9lc69QImGv+_r6)b2vaB}nTw<*sgr1Kspa z7Lmvr8Y-_|fFF}=Jl|>6ux3`JS}H3&c628q1`1!QwM)%A2qleAsHQVPajMiq&$}!= zC;1k){`}zyb)KfurIiG-Au8kGfXD6a=IYu9Sbb9~&sZDl@(M{p`8KPH@t1s)irevy zNu*V+3a8*zz;it~Ez{7Z8fXqDd>;ihrCpksZ~%AGM$Zq=S=}Z(vKWeSLX<&ie`hMM zXWZSYP`=t}cr=RqPHO*`#1~r$(uWe}s#P&dm1y34dGMI%$*ju+#+V>u(`1_Rq$K#R zQw*r)!`u&7QS4O5U`R8u5S|Pe2{>k9>QEbva0s*gN0_`R`RMX`67Bj?8 zP?!^^uH@9GLXL*3@B$1Tw>aE}{CmqF{|ewbx(I%DeLHp~Kw>aJ{T3_29$ zq;XVB=_b&{h9tSX;Z8NT8W)47>U^~owSVo3bA%56Bir`2yO%D$s@vif)-}uhVtt{O$4yc zg5AKDs2`jg(+}9&J^C?}WPp+=RZ(1Y#1#^!Fr@wy*Q;A3HOL zmbIv(#DP;X*2l8`jW3Li2}k4flKG6-v*EZ$2v~wvj#gF#T^&kBS9{VdC(PN)xP#1i zrfxurzM6lKn z-0bqbFLxY~ZeO2^i=P~q5OP#~nbh%rq|@s}0w=Gntmx>h)XA%Lj??z?*olRI$ z6!X1!SD)LYAt5BC+jQoOAsLGrH_Znz6qQMj=d$nQQ2X!{-mg_> zf_M4pDcrVV;o*F06)&SmonB+hixbM96`l}=jf~p(Z1(ex2}(8|%1|fj_6NE0AmlXk zK0ra^ZY>P0IEyuA-=7e4N};Y8{wWfkUJfOjH7mg6M%=m(nXHEF)ru;Oxw@K+loZ$7 zv=E}N$CY;mC8c663ubuF)wLk4JB_=#6<_AR%OzH`&}U=Ym|<{$V<~<5r~ZUmBUf%! z+nHlJ^u2GM0AFMNH*6|2IlfkP{B#rTL=38j(AU~9xN8}*Shm^6m#&{(k7=rvx19!F z>QlmftT_ieuK8Cs`K&Mx2$+Aky;2>Xa4W9>&HPoVYnJAz*guS3>|JC$5ISK8|5a&RIR%AzOYRU@X2SYgv&ApOq2#82Tj}?}J#a$b|B|=3N^^Cz^Ll z^(QsWd(Gs7+WiL-ib1xw&SJvkVFp9c{muUSYog-ko}2dP^hvVUw-}fyx_-LUfO8$V zHdku^6*GDZn<}LhHqJM`nfy}fEq1K4scLMhk`C%|&R9^A2R7^`7VIW#QMFpe5|3&M zNT#`HDU{!zYs-|12_fGL&My6nD6@_;w42`IStn2F&lHX(I;H`Dy zz2rzAy=AyE^XPZ`mH6I-(Q^LUk|*CX{3R5Fn7mGB$~JDdA3ygsR#`|r*uQex-;V|<9-K`92XRREYEL`D_pe-6!|g^a>#nGJ~3(h zzLN@r-xZ(sR$AVsYZ{(J#$_QxY}6KxJ|p|VBt`CM#>IU|*E2Y=b4@!xZBUaU-3AlE zrr1RDJmJ9GSIAmix0&BPvtdI5Z?K&6zdT~aeqrmMyTA1-EP#rA(s7W)9Pht{k(;{m z#dG(G#!IvtzQcgOGPXOOGFn%n4%6She;!b=7xq|UHb@{mL7(hLM`Ig_rC5k_;e(K& zI%qDf$Pitt1o|bD7|4~@g~7*hY)!R>Cg?`W)ofRtu^#o2TO!=n4}|+i`{`nj#TYf>G$IHJO7+VCSO2)^WMtLy2+v$hp#`>O@(x%sR z5s~sdJqvpyNHG&xrlY+uTPVE2jr&Z~S6@h>YpW{m#(3QP2UP39;ocp-`ok^HEo9Q( zg`BeiL3On~ec6woTF}y`L#JwUa^%QCLS0*~#I7*&;gRU%f7Y5zxTctaXxvz5qY(+( zoc!?0-)0f8)6k(eo;t_#gmhe)mkpAfe`%mMj#%9RGKrXqBY@|xExTX`RJF30res{#1Mo2{J_U`Mi%C)IgeqhsY>!FmlVJ|xf`E=KO5K$vL zJG-A16dm4nC_*}Nh(U$CVPtLWwT%-cgAv&ctt+AP1LEK_2lqqG)6j4cT=&Xr6=yoS zvn^V(l3by6W#pa&oc95+h8q+KTKZk4G-^z248q*_vq@%OU`9nyCe4Sd98ZS_V}rpq z&hoD@Vcmp^W)vOQ1COYTL-pDejwB|$T8SxDNuTSlL>Js2&S?&KvOAgZ74coPuGN}N zA7^PbHKH~xHY}-Vl3}#CcF=7FGaOk>Xt2qfx^ST~_|I~^i!YD&BiNu<-oxJJ3(kC_x}&?+r1Kxs7h_`PO)-vUi|VvY;zw`^t}8GKx&3JJiiQd z5QT@xRUzM6XV`WfF5-V}O@&!38hb+!wr?s$NTe4$l;~+X)26|jz2-=-mEP%w_xYFP zPpppm9Veci-+j_!{@^`r&)(geJ3#LqkKAG;SyT$Efzylk!3R=Xq6qX_ve3a#ECOE% zDYLS;s>x6%%C?xc{?3_s+a*B|Jnn~gT$QFPfNO7o-PH6K=h;d1uAZW!@A?S6>(h+C zD2%!*ivIhP;hwQA*U+x;z?~n?rWCdBnBM?j|JD;%U;@)6Z+MuA<_Pkj;vEsH#it30 z0(|u0w;MfMd3jTLTU&WoeZBVAC?d4o{ln|ojb<)MrWqp3)}f6zC@AycG_Cns6c8&i z)Q{>^maqA?4BF&o6D3oE5Ahwsr;r;SUWY&U>WM;liu`Dx$a&5BCnhVx^ZF+kn#RYW zoj_!{`{(n%=61iwy#9T{2Zi*(G%IiXPbkah1rA;TULUs}bBB@le_u6X#D}kJ8QP$& zl)?qO9JA<^FjT4cB$h39#q-<@YgdP8o6v`$f2KzWH3y}=jb8zgpgllnpq1o0wb>dG zS&#h)!{GfFj2#DeJo--r^f8ORdGs>Z?02F~j!z(JUu5MCP>`D?8OQf8gDa3 z;_Gr8?@Or`@Glc0KDnoZn^8p zfmS_15g~(5(APH#>;xCvk<@rh)^M#hhe)86C5!BR-0?peFiRUXeSOPLX6Si=%#Gj(K(293?6{+Z4OGG;*Lr$3n?*;3C0-L zNhO2Jos`~wf5^Y`>KCid-mjrD8c!}237GbfPvDqn$y)$DW_0GxwId)U4?O;KGTxOl z33Z3mZ9=o2)3%@vx8cdogl)-!*m+Gu5`zco6Z;{WX>{;C-RvM`=S73GI!}J0G=N3Q z=|5Cs5>gnW3U90P9A84~oTKKbbM8O$dRZ1jizfS(8>xE)P}HL-`-;1Z4d_+>MJE*e z7O1?-rvq1|V5=~+FixbtIv`8) zDzskJxT0-1-~^r_-qG6fT^<=i-+2C!rBm11)so6jDj%(;`wcWoB3ydvFOG$vtZiE6 z1h@s#4E4^?mQ^_oIG2tU3W2S3CI5G+rIqn7Zc=d6)wBzflwj(SDiLnx76_j1kf*mmLZ?ipEs*mqI9SNbIS7!t_pH2M%X8{ zvP`{#mPDXvci{nj3|5cv6o0=>FTUWl90JmhTK08kgDUNIao24r87Y31zW5l|n$%ZM zHe{pC2pL@*%mFy%(jaJ+cEJmsEYAv636FPmKnT$x#*FC%<^-}!leBs@z~XZ$FS!Y7 zfxU+XXT5CHs%qmd9tVhpM85+;`O)f{X*8cf99DX5{3?c1sU~3`U_-T&&H1-!LH6mk zGY<&9+hPMEm*!)B(5_IO&<=Wo3Wo&ksQA-qlH3@C#%>&Cek<3b3@5gzntffc z)>cue*YKaLBjSf%k=(yM=Y?T{z1wU6h?eLK-QjI zF1lllpsEm}x!p>G8w}Sr!8~h?E_|>ng#Y6ZGyV1FJf<)A9Qve~QHFhCn^`Gq*cWOe z_?C#`Xg2BmjFDy9;pc9s*2c`3t{r~5=K5u&|AYS(_)H_E8)GUd#^El3=sk^y=-%B8 z_bSN^w$alRj^MDG?o%1Ky1+p~`4BWt8A1zKM@+(n~xqfUsv~ z(VirhFR~&fUb9;@3dq52*W*Wi)vNonkLtukY^VAoc|HxyhWq`HhaulzuxK;Kv?)Li zWSnz&(-t8v?v*dPX>@F)%EF;H9e13yS?t)faX9WjpEGIb&zHZ2vCngRHTe15Jr?Q! zk&LjkzrTEj8bX9pt=V#*oLh&$sJxL?<(iYXvIibzv`vZ7aiwQK@I#rv@YeKu!Z|t< z5rBR)W7W<#HoLOB2W>Sdjk3jF5wI;|(uQ5sxJ^@kR2q2{5+PmO+USZyH(kc$iOlje zYQ*VNOq^y5#r6mhzio{1zhK(SgwMR~Z_ge+ijDa?O3SGpynA-H`+76aZN|vZR?_37 zM5+vEeJ-2!X8=a57oUtd9Q2f}vfa(S1&elCaBH z-ILJQB$pzKT6UA_OXFv6A95>m3gSm-aX-9)wVz(>_`%Cv>za7X1pez4&B_3=c^Xr= zFu@2S^o_n-eih3Yp2+5nm1SZFhJ}`(`ttAa;bd6CW+j5C5l7-5bOpFmjX)tzJq&rU zJDPYLS<H^7m}xEB z`S(@@0HFKTxqQ|2Y$uD=FYboB*!*<&gK2qy-m)O0IHp=ywk3zsm7f*8Zs@Fk!im6~ zYkkxEM|Cd7R$LS~>f!97PgjKDQnKYdlCD_qZRilm(?h&CrWn1|-N$LpSB!bVJ#Lr1 z9$%CYt>H@|(TxsqM6bj0z&FFwoFrXF_0I@MWn)taddQuie7sjNJ08>TVI^E)SNM#w zOqqXHj+Z)kW{#5N)&_-rF(~$R*hVU_!6oynzd{_$ONI_L@lLsPp{SG}3X-lT6z=ALDncH!BlU|nhsC>=_UM-o4{BaofR9$B*Gt)*NS;U%uo8Oy#(GV+t6t-UX+6xz z-M)0X!05JKejdw~mNX;*a{S}85OPQiPqp4;0%G|#o~EsVc0jf`LEn7~h-mhxH0Z7* z7Ckr*eunGh1 zQ6XN^u8>NeaJ%T#_U{o{7iPs9C#tI*>K}t42{u01Jy_5L*-~umlKpinQ84~NPVY3A z92KZ=RmwN^7Mjz`_Bn!9T(=wh^=l=`vmtgAb@vLwo>C2-W%xt%r3R+k;_7KLj?EZ%ZMB(KkSJ8 zbr8Jch^n7@3AZWozNBH$vYO31j-xF8x>gqx3~4a67_H|KLFr)pA&hWyqTl`MQC%d%_ZxolM^ zYb{#kw-+aeo~ZR@rT_9{@=GHY3sEWeEG}T)x&*|uD&QpQ2zRZXemL}WV5f1dKrGAC zC2(gzA^(&p`X04o<@(a~lIFfL;uI+=%Kb`5gS)R$HbB93;(WMJ&RR{w{^XcE^)iq_ zwLj=iX@nT%T*9I*!sZZdX~Q-#_=J2|SA30A=2``i)4%FM79r%%pbQ4szjc0rs;7yW zsi9E)i3KVTV}^fc;9}v$I(FJS>~Y2lrEb~?zVIlP{O!seiu*?*E5t!tlg@+Yp z=~rww347eYkhKRN_o{==q9{I(K55`UaXpX`~B!u z;aV75@J3V0-pkXDS|+nx(U}GP-r^<6q#xso-A(jrLZitW{G>(dNjQv_bK6(y`Sid= zX6J@KL?+IKIX$ZFmt@X7<1D!@iF6_L=>T zv$);h&n@gsY;vHRKRy+{R6qGlEIzjdj|7)u$6XmRiro3k`yHE2&@>NrDJKe^sGOV`)d1}CWZT_;=H~s59vHH#uu?U6Mb=W`qJjeV60SI zm2q-%n&iAf`V-&FDb}$0?#zx?XHT4=N2U3wyn^Snrxx*G$0wZ{$kFy#%s`>Ck2wQlT&9&j;4DoB}=PjozJ0c=Uc~_PTC^WDf zVT_r~L@8+9afjec`XeXTpxrgBX|s_fyrhF}-)w`a8pij-vIdL9HgZh=WqWbygzE|V z`;|u>DCQo*LDER@zQQ105s|B?X92eL(XmJd)a(6=R5h^W5wI`*Fc3Y=s}?gu)!)2X z(!|Y+i>EM=Gba%@M}Ky@G@kjOp~yo<+7q9pDJGn0ZssbLtQuDz;6poLWAA2d#y>tj zPhW!@o9!VJ8AtUq8P0H$n?GIMp3?>{p1mi7bCKXWX}%>1ZH1FtX5J6Pt$kcG>v#195Jd5m<*?nh+F4?ys0h6o9NRF86u=pn{N}kP1lSU60XqG~Q~z z2wry#wIE6`%Q~_<=@R+S&DbtK*9YGifIdd|x=igJ!KWMewH@5~k{v=kViZbW$$>pV z$-tH{zJJ%p?Fj}8lOh+( z9<%>-Y{!z})B$!|suCh|A83zblq?Qr>(B*)&#JHV{Wd(sc+bp&?E~H|kA*)(Rq0vP z2N@RqtM5|AbqptTyw%jDB-YMEP2APkk6|Bm%y=Ah9Qe0XzM}p3 z=SZQCjN_EXtS7?%t(;LoY>xTCaUROZce!9NB}F=%0o{9gY5}@H8E;#Wol>-Ejh*A{ zUAZSOJ>xs(A_*7(^Vcsv#~cDW-eG!G8Kk*$QZ~3giL_aJd7|&-ePpxDs74P;2Dt>@ zt_j}6t!X_-ciAkbl#BGFvPxcH()Cc=|96YHX9#3z&wo?kB?mXiS1|4VX)y<(_S|B8cd_t`1&irY1AhfCjk(9W8 z>wow)?hr7lArVzm-4O6`BIJLrN0;Ex&l)MY{x`<6%GT*qEZAfyL1n(MViwPW%_bc= zPEDS?l5(j50Y4s7;|{28YEQ9No|a-g{U79)2IojYWkfs4i2m|L~7uC z{rjERkk)~>R7c;O5f6ml7t0Zt7)rSk4n%`+6VvFI=(JTvoJ`)N<9-}15|bL2bn}wH zoDPk{X>m?Js61QV#UF@1$e?AAVp>n89_Q?&F0ttMJ57zD{JyuKU zb5i4fIv;Pg6I(LZJWQi^FpfyDV?PaP%{d-Wez?nqXt5$hl$}F%41;^Xex%TOCY9mU z-{h|I-m|F?`ei|nuZHeZaCe4}lSs6cwrfy<){x+|X?5FtP2(R9HQZ@=(|LDtWF-+a zc7*cZP=ea@w?vWT?Je_j`N&POMY9DY86~6v)EAzzKu zXJ?j^pHH8b^p&0C_OiXoxM1TKE+aXZ`1ESK{+iu9CG4pv?EfVEui7u&WbY^{PpSAT zIYj{tYGOQ$EFgfIS`-TliyQ?dJ_H^h{(+i;0`~td=%yw&ebN#2b9L(M=3=M$N4@oxUQHnnW=&WGsgV`2aJ`?}^D2D@Q}cTNJ_FtdC(W zsTRr%)OBEZ@A!gVI-$KSv_s_&)aivOXvv4N-2b?AY5I?r6!ofI!E`@~I^msn4y;H0 z!_WeWi#2r{_O4+BV_Rj|0sXfg(_i_Jw!_SmacSNCZtVO#+muE2a%_%(hqxg;|&-F8ZupOn`3to4}n{{MiE{v`Z(4ocV0#ITgdh@ef; z_+zI@_~A+pIRu9|gZOMTbj#pD^PXiv$SSI?cGpuuzmJ6QoSy!Cx6{_7?!>gGasKG3 z;Dt7XCkaN@c@xpfj04tsdAD$|Nlb*k;G61^c@jbN&o_=_zC;$zWIZ_1!r>jTuY2JN z{&cJ^Nrg8xz@l8-l)C}tGb=5K7=_28_X2Kojh|^tmcJxD+gv18&c7yBLkO3e+mqnr zqTWLp{bxgjA`11Zg0ek1AaV@}EB_HbNHUHCPL3V1sR&Tazzg_U>DTs%%Zs(5aT63c zz&dZ0s^Cjz>%9T_Joy!?3Kf<*Ti}t!k(vxJANf;QhCjHzp&v^FGd`L#=we3by^ZN^ z5O8^-S-Gc+w@60i_(Rigy(QeG_niRSI~;$Nwid#7`AL1{m6?|KVR%W2bLsVx==%>V z<@HI#gH@V*7iuegr=6;SaM8k~@-Iu^iy0Iw7ZdL82SQY7RT|A_u~{fD|F1g=j348; zFP$|OynNu@GnS*vlfE!-*hDntm};xsQ%%q-`>*f_N6Uby%*Q~ zoWkhU7wG{m`|h)MFWE2k_3xNUN1f#4EQ6HPJ$`!@@i7v`d`M`%aSe>4pAK;-g;4PdbBQ>yIP z9>(%qRnTXL3xe;Rlr%}jU7O6V9*MG+Uc^?1c%(JI!xX9_Qf(FX;1lvMwKDy zRsz-#c)(8npce1#Z8nhzYklG5Tr^S_F4}G@wuawwY;)gb_HmQ$1uy21m@4QCadAfj z{bh1?oE@xMrG+c=0OscqO%Z?~W<7ZUX!;Y-&$dwQ3QqPW&{Z3?)B`VwGXz>>Vq)dP zqaF`&&Hk67?AuVmzz108NteOqcPK93jxhly5RJv_%gNB8W98fjm>46m%*S$!L=o(F z7P-1lO#OpP_?XDqFM6u)k4TI64!WU}KOV1)_qfPPX_^NMH|?53DC(@!th0xrUIk-G zCHDr>==6Ek`X@D+_72SAMq=t^+-<-)z(Fsd<({YFrK6?04sl=Tad@B3-jswZ@L$ zk9ZyIZ3BmhmG1Cw0z|Ij^m%G@QHk4u=l z7z6(-?T}TEBZcBeq^YehmskHJyWR%44}3kE_Kqq>jV`lvS)TRF@-_56rp{7i8rLBt zTeXjojc*D2gq6to^tdW{!Dw z@ZVb-;b@7>lj%=*>u>YW(62WY>Vx>T>47nr)7dtZnAraFnN zWLOw1%>$0Q;pxC(FN@Dj^Sj0G^T5ukx)l3qxFJF6drp@O=YG8guLr=l$k<>jtP?!l z%zXd}Lejg_)#yYcRb<3H88AAZ3QC`k43TADjTp$U=y)aU<;IX{FQ3t^68HddCs8+z zABwfziv0u@pwGW`Yt#~eeqgu39rKUIfN@%C&q_Uhg>bVi&+i}6RiiQNhzxvqIEL;o zZHfLmQ`b~__DF-f+-=5}M8L&!wYU9j&hR)?6x|`*294@G(&{2X>Mj`jYsj;yYA_8% z!FXA)EffIHXTU*h7L1>b;VqHS(dTnMl>nJ*bQRRuFs`YuN%(5FcedOidw^9rHH~^j zAB`%O+VW}ZrA?#?GUB?Xz_71PH<=~vH`QYWZM78CTS;Ql}C{nY%OS~p!iQN&S!1G+P>1ib1y*<9 z4%bHRtC%YOmH~yDp~ek>!-NYMtW+?C`3(`w37OLe=Y`{ZExs7dl=4L}U^-PWt7z zl&to+*S9MqQ?e6MZ z%MK_kT2ALnJPT=rCK@g_SWRY`=cMFo#WtL)D1AIC9fVS4T5jL9=YG6wN1#0o^32?C zB2sLaV83;iYw|dj_mzed;m10{=*&Y(3mx|c4bG?5C#H^a1pCLf%^maSyJkx=k5)S> zo9bJe=y6q6^iKSd$!RN+n{@`)gI&v}h=qT2C#u@rSGfkHjzn${W=&B4KH7z0$5lS* z2{C9K%iU3~PsmmFbsB!lzM#0sD^2DFMGafc*t?N{vW(bo zvP=OzS^)4jhAZ(B>OtP$aX;Pl(z$3e)ppnM=Ahc+DqkDJr8x6QP<2Ooz44jL00PQl zUkcD=Rj(#CwqBoSQPwW{{wgYxLI<1-ndeGk%ox05G{9Sh-jM-j@z{_!FF)F#-7q#k zG4IO>#l_vG^w+u&Iysl=65jbxSN~>(XT4#_36{zDkwpL(QsZQ=)zs;!pTXBWD*V_Y z!W?PG)9H!7>M9^ zu8k3A=^z=}csvu6I$cjMh>fD|;w%p`NgRg4XhUI_BW9r0%0gQ@OmOKz-u|MUd%A#qL(p+v6TLH!X<>wWozpKf=Wwst z5uC|4<&E(^=?=;?V6blJ+6|4KnS?h*Hj6=a`k$YP4FSJC)sVp1^OmSS9@K6fo6M)6 z!?Xj_^_N%Ge1}~Sw@7Ln1o_k(d?t`&^gKu=IbMBLz)vULJpxnbFqs3KlC#v#ndASs zIbhn7fB~M}0lV;WE;@17_?h4#=DxgG|)txoT#@lK_%ay(07412iFzFv1`H7!{{L{U9yFI4Yye zK7QAj%YG3o-3r3mL`>wS1MzbW2-^7y34B9pY1!heAKQ@=ti|2vHu^zDMdfi*k$K=3 zX`QOG$L6gUDbURy--#;z)OQ1e!t|PxU+H)zI~1H((dG&7Mqdeji4-?`+{!V*Kvw@~ zJ1qHqxH+BU;oB5rg7LGqTR}mT$~s~tG=xGnPh%5qV$~u;7_;EJ2JSHOWZC=R$n@jaLW)7=;cX zttaKYue-x3)ds#tDD!oEKp5;5 zQFJNOCPOV;PJy(Bz*wfCD{bMz&&ioq;^7(j$;S5WeQ1s=?o;DWdv!EzrJ_Ry92f(y zi4q-cFZK+3v*oxK#HmZmn~2|=0MkNEt}#3Jog0dDes9~b(AtHup!lnYs^@xeQQaG* zPjY+UNVv06rZN4u24_Z;@t~FFI}f&^!y`f&PE>IeG zKmS>Xj(oTXLf0@f*$UOSc|lKC_?hXux^{z9&aNCACvc*k!jrr#slrSk(dt#MqHPDnZMy zW|AGth~gpLeJ8M-6HuY9y3Ow60VeYM!~LzW5eeLXP4ob>`m1!SAG6?tnTJ%XbyJa? zt~*07#>6~2!2Y7coBkE}z-*3e&Wdg=QYx5DO8Lb>+9eT+HV@ktScd=+<%UfZ>Z|BH z{~hb;*d_|n)W*(Fs(4beH@J(PWV7x18O>3pg_8v2mwy zg5lo$tpH7Cp zPR=DJj0ZD;KB%vcqMMhWk_Q)0iIQ904QFlc<=yZGJdYmysSa6vc_&ScJx;)0X&JiC zO3xWA%jMkI@Z7$p!JV(`(Mqwnl%NvTVO?S=1QmQB?0Bsg8Y+Y~Fwcz4yUD)tTkfMdDCvH-2JHHH>No%i&x*$GdvNS5#2-SOJ_W_`E`HHHo4vXvsODLFlS0}4T2M`;yoDch+%}A7T9-#T z>Fjl}s@2Pq6&vE#JV5ovVc6TmrAPn{^K9fb{C1XaoUN^y!V*8!(SBxOTGzBI{DG(R z9hEXcwZwmr>vhPUaP}I4(C7yJQ{QHar*)?4pYkN;tg989INpUXCDfD7*NMymaD>I` zcK)-pzY%T(Ng-~OvCLkL_4)ju@aD8Z2o0IM4fqL30CZ}JD}N(y{hyimC(5vAL}{I+ z&o08Q8>GQ8eSb0~2O%!8b}NmR9Xe}6R*zGLZ|d9rynpL8&zX59mdw0>gY^9S6;w(l zch61IJh$rX_N&NJLKInoW6YO*Mx&bsNl!@2dINffi=vrw1|}I$@p79fomo^avs~se z(a#P)Dad(iaq*n5AT8r#SF}FI?rFL{9mucq9K5)n$G+;6QP_ zABZLm|E?b$+jx<>;h)#Xif1C_Qc57X1VeRFR3Up{1j09cPLlP8)Fw5h?sQMaJx>g?N%2 zGYJ&tc{_SpYFI|I`&l^z?|U2wi~~TYvPDJ@bhP`v3E4NL`}>-LQJ0FH3;+1>?5O(d z#nH(!_Ed|m#nTvc1EBER#+8@@4op(yTyDU=bKW%Euf9KKpIzF6jMjdjicU31=#i5VN59kB0s)YX4Q~-!<^Rc>5QZ|4RIe-T%h@{{s9s)+bR)~BPL>-4LpkJe^%B{r4s;Y2t`b8^z7KHpdROj#68mN|k zc755f@^P^W{o!+1#7_!9;ak1R32yM!qTAof1Chrw*;kgvvcZ1=_QO>}j_xf_KU{0! zp`s{W_UYzRl($rr?%QLs@mdT^it@rJ;R(dLJTeo&mJZLenIC8t%lF3PO6!G>9H=S^ z_%Zxi0&1N}m{dlLqG0Z)@3eiY4v8lRfCPf8cp^b~9+=vOF_%V+LQnVw3=;qx)x^0#kQH?cVSqlr_vfFVt2v{9 zABmMiN_f;Te-Y0yd0^(BI(&8)%qLg~e1l)|3$0QX)fxm?ja*O#L}-JoF*&thcNg)p z-5O`P$~BvRo9cVNCtUh9w+1hcDjH|>8_#@Z&xK6{<#QlnO= z$n~9->ZNRcTq#q5EZ1EVn9A)fI?|PT*aP+qj(pJYSivo(LRrCGZ$C*$YQh6=|F(9* zOrkSUe01Gj)L9CvP^?)#@JX={ZnTkUJ*?LT}64#$HSLyHOO^Fd~(YPG@HXX_n z&l+0Y4NS4uOCkxHrbM-0D#%KwkDrnr4Hdf+MCvZ>IAH?vR*IfiVf*2b?WleBH)oF; zF;DD>wy;4FImJUFU@yd1BLkSdBu*yjds$|{lzDF#1nw4TT1 z(Etf(Ka=UC$9OwGga6H3*{1y#|Jz20Llb>QKg6XBHH)swRHK)M2Cp{nL;qI^6kLXv zwqzirNyTJ`^dp(I4f$BdEFPk{>}}WhFezYIe8P?eskM(-Q8N$#Zv;acbbTqh;)FC2 zQSf?kO8%x|&R?kc5*JvW7XB2qY-ALe&T+b%m}JcRR=R7zKO9mY1JC9-6F^^gDB-sD zJ)H7eOEGZug=`GO0|kGW2WmAEzp)xF8a+{A4-t_@Y54U{lK_&5KJHy(`t9S%7JpSX z;VZAtp{JI#!oP@QqLFBZMriRi9|Bg_=XisID}K0OBEc2*455 zwLra;_H(2brz7j?Z~BoK-xo&kb!vd$XIwyCa9M934hhMQuYu&>4uBKDmrhk&eJg|}8&zMSdB0XoDf=`Iu?7U@!|KsL&pY3kQ# z1WDIjxzUnRd5n1G687wj;{IWE_0!r93|)-j$`K5hFD|#4-jHFU;#=RHDnzw>>p5V7 z6VD{n#2Zg&HRfV_mOxhp^2KGGQaj)REP16>!unx%gQ@5{RiIaUv~R54PW9iVM--K; z`SoNAb<1Ki|ka+c;kLdjs352Ww_ql)VLk9 zC34>EoSiDnvVDz3VS`wFjJ2Z=gxV~Tyuv@!YPSsKq3Sua{@o*DA)6-sQ0**v2A~9( za6Kw;y^#9br0kvL>GkU&Iq6SW=-J`8l$q>}QkLKEKfvVYQWAY^$-1ATF7Dbq5B1Eu zF0s4;o)plG=e&=WtIOrZx>Y0g9df$`ZspgV2`?R15YTdL=eI3B*Ewzso~~E{Z6Zg^ zV6>K+XRq;HrQJC4;c6v+|EwCdQ-bs&$Q7k6d&7hKt|$b+tHdXft-sW8D=D-`IQ&(j zD%R5hX{^Z8xDt_%FC`|UFkaiD_O9@<1xW^7siRDo3^ULVJ3QL&--Xe2l!}Ho+2OU; zjkWNM-#i6*vR|3a)5rwtNBL{d$ccN&KSFt4QvXI&_~evLrZJpV+JoJBI2X{O-h_5z zD9xdNQafYZ++q1ntS}qOpVw3!dqah-B2M%2NHgpTU+WBqIr4rt-Qn^u$T_Gb?MF~| z_pMDTBNNyJ6c5(Hh6RW?eg(+}vQXi(Xz(|Z58Xl`g$?r!_h5`_FPhunOJuj?Dh)xy z>Lb*T<5ilI{RWOT%6T|wE&Wr4(7|GeZHA30*=@J!J90wy8gAL(<>pV)ibA|!cp{k^ zJTQ{GdqgrD6D18I+fpX}h-e;)P3YTi<(R%_U^Qq)#Y>iVsGsZYVm5HNY)bw;e~+R( z?ADyN^Av3$+A5nI_FhOhvTWO_H_h1ai}&C>@tw87wjej%lCTD(Or4!u%rb#gm^3y= zkJZ8A+=${t4m2G%5@hu>d zO&1gm@BdtsQPbe;=cOZnlkBZn+g+APLPlu&A<=0{eV`SO_iYTEdyF`M$HmeJ1dKJr zh5+}#wwspcIz{uG!VJXLBG2Z2_NoVsCm&-O^H1#8&&FfoZAwg5RVSS0Dj#17r|pg7 za9Cx&Q(o)GuO~EsPCfETU0wwXFFs=aG!?$^7iAL2!|RXL(b zw&bSesaZU7bCzhBWgkM#Vh=&i0|5C21KzcHJ?f}_tjQOtZuqi=jf*WyUvvmyJXVuX zK;Ol;&7I+c0{#yD96jGwdBmT2D`bgr5%$l47!rVcjXM5Uzb&*^lO+PEzobOXQRl2a z7*Fe?%s+FO@>2KM_-0rV+%T=w0}@fosP&Wqdp|>8+Pm@a6pXI%X_1)-rR6ld++=l64WyRVI8qE4S z-e@-bz1bnSrd+mmOxHu7f@5N-x$iy{Pml6G)SSCFy@3cGJAuv^r5%tj1k zM98nlza)hoX~))}2qxqwOeCetpKsXZ0VfZ4r#+^$M~LtbMJOO#MD5~sqg264QD#?M zQ5Z)yAnXrdD%kTPa8e+DfPKTC6-);AxTU{6LC#3TLormMFO-Wt(!sf6l46JRXjXPd^Nf2Fc3Z`9EA@E6tHY!hO(Pzn8H7A(R8zfA@0_!wWOFZ! zo0JUPD>@Ztqe5(m#N*l1G01}NSZgi27jOhb$+}-F=#YNN zHE7&1oXH>-scAs=;v=lwGFuJfvVc`JpF?EXLS2*Md?UFB@FuAS6mqJqwBXz-u59bI z#(Vi4)q*W7f?pg>s z^o2Y4r^a*78@GfX)AV5uWUb@adjBOklgr!e!}~O$ ztuQc!`F2o*stxmQ&ZYM&^11v3->7oa>zp=LW>j;EASxK&nX+g1Se zn@uNInW}fNvm%&uxDxgnEPd`l`(^*AL`@q2%8Q%#jtUG74LulXdX?69BR%({?&KJ| z1Vp8K*ni@hm`w6_u;^K9dzymRU19LpHi9Nc#Q6gS-k*xNk_t>FLpw}8Zm?jj9D_Pc zUQ=Z3RqhRdL+Xp{gV{YA`s6z*zJt12ss5G|XID&Qy-?zN0V<8# zxT^qo+y+6cQtu-X--?|si!zKd>EZkAaqm@o^Sg-ru4qf2Flmw2|6D3E+*@sjI?E9r=F<5W!zI7F~5Tqm0%5IyAM$(kvSG ziF2!=(dr++!O*;5sr)N~1wq$`?v1e@Q*Z8}#4VfUbjU()u6|tCzVrndLupB>B_KpS zjkl}0=o}dmXO%=lEskIM^Ij+bCY{FwZqe20ZS59AkGvGA8vIsynnT1}Tf`fC6869? z!23x?DA*Uk@JXYcA8ojhU~r!i>|07SghoM_Iq|*%sli|-B55fT&q>ia&kd8}TWthX zT9@}?Xy0Vc4JiENP6~09EJ<@FzT;WW>lpO~LBX3(4E?n~^u4mglC^2@lX1`#iITvH z2kZ!d&9S!!#?b}`;3}^aU{aw!RYY%w>}lW->(VM`j9t$Uz0upW6v7CeqhZcGORB$N zTzh*uz8;@`wte3X@0k1MQ9xN8*104HB>+}|I|(#p*_2Z9m=>cFzh{H-VaMq++-V5QG3+b@Y$36ty;#ayH%-NQ%%uF-y8 zF$c6nPHHE{F&WB|I3@CzfEW0AeC&evK2ou8OqY@XzbC)fjEXPV#lf*Gwx*_44pDxJ zo`McdF~6P>3ty3H0Scctq&0$Xv5SYyfgGICT?DETHC7ij*OEzlS$w!TPC zHg5lXV?j7O>Qx{`3d;N!;&rYWF(1CjF=N#j%h*n7VaLSl;-f4ZY51c_)6!rhu5x#%2Ng7{ z!fchZ_I(uFyW7W#WRK!^j~g8x@ze9uR<4aLP~zVk0Uu9pa~*ES3-Z!>r`sYlf%VDr zhA&MfM;|4PxQQe>*ukrT)M^-sDOi!7{u^9euD!|SwZJeDU@4Yzg`)R`f}%?{<+!kA zSP4;Zz4{K2GHKeF66r(ce8VWCC1kVk1*Jw7-55Hgh+c147bPp!!i8|;Lpf1Olb>p9j!YKnSDF3$p2;LZ#o_J?NvEPB2U+%|2`{mOOWwF~C<9k@D>f#6*7sATWVeg)Ms;$V9Wyx`TVbX_gZkc;f${YdRlC$}wM z5n(y_sIp}AZv=_60lcpu%zp31=3XDS5@>t)rJatLn`>`KLqVsE#CLRe8WR0@TKRd} zLx&;7+!3O+PJ$qJTY-&$PqA|}^-fUL3*i;Js@WWl?Ldky2t8E!3|OuDHllfUC|@Mp zt5?5GS0R}2>jyT5dc(8J4#B{sLF~Ka3k@c7Xzp#}^Nd^P;AV2_QgEw0^c$day5tQ? z;JDc`FpJ{Hj~C;R0zGZAlUcKrKVze|Zh7(2*_aCME33EzZ zWYj~OEQJZp)bjO)!M7SILqK7RQlLO~C9~*K+NZ8RH0S+Q!*CV&l%jeIg_~hw;ui+h z?5@OA@ZlQ~egTpBI!jVuTR%fYgLg|qP%y6!isbj0zm@I78}35!PhvlHHh*U(UYTBb z#(g~@({tG0M2)xLg)a4$ABNltW;h)HCT`McLQ4phil5nc(tKaDHZ%nrY_m?M*Hl|h zBo5&p6RzaUNcePTgs&*f28CFj(|WEWEI;AcD!=A=TE4sYs!>;-2l8gd+7APt*}^s8 z$#3~9PdAknMk&33uL^lpwtU6x6}Wiqa9G&Iz7|#K+rECCF9K~KEQFFc-)uPb3@1Jk zTiM(IKTl!X$!?*YR=BlZ_M)4utUj+DJ%!jQC^km@E(Y_KkH~#BK{2A9?q~nJ=bo2h z+zU4Qi&V%DpCk74&xH=pomeP=IJ4T*(C^NAD|UYjCuL`|W3!XFfcOv_E*beG-(I%x zkL5zbFGO{ktURFbl*`{ zV^ag65Rj2t53c*Jl0;Wlh`H({KmXaA%v(4xl|`)x(CT;~LF*%5XO-)pq}akgnV5-) zxUuY<29b=qR~=esEw_+Wcq z=?3exSD>AB=6DDz#G*wiA-Htc)h$>n36VJSiLc{#6$j9N;w1f!^l)M*lnWMn+mb0q zC@?~rI=sK53(x3WZhuXqudWHFc!&Ze!;@zH|5jFr?$}4R=q8G0)YB)%sZr%YOjr5@{~Oft?_wk-vlsk$hZQH$JxqU;q{ zGJ~Osg3tG1I#K+c$k3>|1VynHedv^!d_wrLZ9_ORAAGv5};rozmt8`ZC1>E#$H z{%Kqrq6BRxf$HDN>sVHiMu&h-c~j!-yC^1~*9+M||L!JNaB7l&(ZxkdNWH%Tzh(x{ zx}fT-y{Kv@c?(ypQCV*n0YV{qGr@!4+@!{SOVBPaL5eES6uaRmeJItd0``eBcQ z^EeiW;<>}%+xDsoJW+X%G8MK2rd7J-=Vpg3y~(h`z=^Ra5T92#&Z07lP%+#4qneVr zHCIq33y>ja>*HftH+|gQ{W~!^@nw(n&dFaq{2Y{e^mGN0jWOhrFEp*nOycd^qa+j3 z%dn`^nVFt|6RT{Y($h}sv;3*OmKJYIO$)q^2YIN%UA5gh(=GUMmrC)Ns{iEc{UF;f z5qlfA(?^d#xVQm?t3U0T1;;~ip^)|6Ahsy*``)v4=gn08ww@~f%_g@uvdD*t ziF{C?AM#hfTElhzJmMK17B%$=FeQa~R@;8}0TErlN^l*g*ke$=mf9+}Zv;xPq~;@Q z-f|)<(Rcy0KS)vu-)_Xx(v(0r!oxy-{OWyIwjDZ{U#L)lxF7fYK4jnH5s`cv7n>Nb znxrJYM01vs;(gYl*CpBFuZ94+%_fsydfw04j(fIBx#p1Ij=#t}{Ggu66V}DdeNWeZ zqNAvRpj&iZZF_Tgl4Rb~UN3M^&RBg3_a3~gAEwP1e>}}q&)=^1N-@K5a}r&gnehbQ z#T5RI3{MFklaPbU>4Jo+$12xLSL{~cE2V!Z?ZcwqLO7OX)Ng`AyrjIGNB1_##S;~; zhgUzbF}iW6>?(tQ7*Iu2tHkrAaGz5Ei@qoi5E3rFtte%t&*RIcz#Si3v#1e%o7-0L z_~yjjn=UqrBV9Sw_J=52e<)xL@XEzDfIJQ}L=$#?LEq=>_;g3x;AcE|Bzp7NL-6X= zH1kk(S}Cky*i+Q?j{91ayv?KB|!QZt5AZ> zwKYd)wr~^m8M(@HX|AxL*|2#*fN3~iQ+G8Y`NsiY)JL!BQvsmUU(e~e!_5-gVKL0t zIjop_q0Cm@1g^gkV(QY)_!tLdjk_?12`4_dc_I;z3`?8_$_gM zetvXxw7R-FK0ZD(GxG+4%+1X~|JxweFfa`b4NFT)+uPgw`}_U<{Zms@Jv}{VXJ@;+ zyJKTxeSLk0hlgEVUDMOkLqkKgwY5-YtA&MymX?-|j*iL6$#+@#`31MPw=XX*>+9>O zsVQ%-uZ@k3Cnv}C_4QdFFaQBme&Wi-?F=Sy^dr zZVm_tXlrW&gTarFk8yEv(b3U9K0b+wiNPTu=H})(Il0Nn$;HJb*Votg_xEfTkDi{M zg@r}N#>O;8k4j2P5-v|SZ%_wEN1ec@q@-k-VyKGmle@bs6mkZJLO*=?(A3x@0s}+q zF>YgHBVhkjvGgqO^E7b-fjmxq((I5og+6KiyXd`y z!0@JMYiVIhrF@pJ{2p;94+FDt2Z4cCWc55@{s7}J^sYuQ42+0S#Prm`lYck3{@_hi zRP_9)J==v}1qOyadGF{M8ql$;-S-Nu9JEfZr8MtQke7$~V7Ya60g?2E>PEs_4a2~& z$o+OOg@J9~xrB1tpI@v)6YF(gVPkaI6DwOhm!Jw(!Ite%5*V1NB+1?GAgEiG{cnc* z`Q-M-3^QO zpZ?`oG_9h`S4WtvcpoMfmY0LJxg0$_O_<}oaVqP~?jmoP4`lhqA0F18KYZiS5N5U& z5=!2ZpR4j8?<&=7!EY;%YV{`XxC=9Oep>DYXNNqJQ;>3h;Bx!>*y9=9(DSmW3G_{W zPJ)N=hJopxXpth6X}s@f&3S|>;}rE}23EPvS2Umc+JwNsg!D*@|M=|&d-iA3@~b2X zY5i1?3%9DAtz$f=_LqdS{_E(vI+`XT$&f7vqPu(+_m&rgi!6UpS}SLTo_jF~R&B!> z3?e^F-WJ?!De8c}M5*Wy2a7681K(63slL6*rpd9hL6tP3_@8*i*;T=9AgrvcXS5D~*~sKJ3*33(wNT?(+RebW*+y!CGAF@?+m+I-lp+$?|^4=_kjFQ@!2E%TD3m z9^Pc)R{x)V&eTQgZ8(hC98K(*uD-sNT`(iflQKUiCvxu(fWFLyY|5K_kJmK7W`E`} zA0kIRJ=VD!lfMxmsje_dXmIiOTQ|kLPc{R3`f;>B_P6$yR&UliuYoio(*wtznc5&p zUA88#vyFg@iH)VBhK|*%N=;RuFMV^#PK4@Zn)X1KwQL|h0uS*cGhF^%_*tafXAOHi zVKe}114$Z3Fy2%;8qhEOHmozPGr;?1N>9J$vPvMQ)lES6^VVO4@dv5%ZLEnm`3tkP ze<<>vx3gJJ7``!)l?YsQq`ZF(A>%nyES+o_OoF*>x5$q1UtT8#fV_wiwA~UW6&n%%#rC*WudsNM7@zqX%bThG}pg*y{WHYr}+!bq>%*?v30H>lOa+tp?r z5y=sShOVFf%L*#U}r&FxzBmK%#3}E zNohwAY5QbXCvKw&$$iPjL(SUYe@`OCv@Q83ttKb8&1hb{7UwaOKb(LUw>QXc<>Lst zn|-=o_~rA{s9?9@Q?kkz&HL}KM{j(uyHn57ke`)t;~m%~&=0QAhfd%jw179UAa5=E z-e{!D0xVwXWN(t^^lzOc=x0y^=Mkk5I2vrM#Xvob<+FM!&91pQ9VQ(cf9A?+BRk&| zUnkTZ#f)iFPFEU7&y3yihl`0pT1o5|)Cedh09lP&#Q8Aaf00XhZ1o7!oYXmeN;nUv zq*++jqDD{cn)-dqJfGwt_C^>M1(-YW7BvPY#m1hX`Bob~BM+te@`!>{9RTCEF1{7G zq!)zG-5DNtvCUg-bFaxz`WC@|Z_(*lWrJixLtH<m$>Je9dc%)2pWUTKr472bKBwRtb}^REfeBMI&_rc%?jg9>9_5$$7g% zE|nsU+ESi6JfpHUVGqr9fMD-5p?aPjsKxRQ$carJ1?{;<+~&4kEs9j z7wvhzmRRxn2$YP-oI0|EueQu+xVu;XIedM`IoMCYYiy-d-Wl|qSXQ1BW;{=j2v(!2Cvt&+YIu(A_qG^v zsV_;z^!bkbHJD7=;TI*gD@p`XdyGITb^|NkZ6~UdVWb(_Ur1%mO}SljVbrsT(4{t z36V+Ys`qx_t;6#fmsoZjj)M-^v+-Go+QJ+j%2i6lWeHWw6loDX_4DZQe<)Xb6_@Vu zSTnhU!i}s~4%NtnbQ6l0nNIuf*a_Nzch@HLi~6})uda7?=oF5S!v5q2I6kHC3%v=< z3~B#FCcaJUW10}(H7j)`(px9$-<~$rKdgB8+bVe)b1^R#8&|i*_F9@8EcLZn0VXC` zQj)}|Gz9AK|76SB+E#9p2lkuEtw$xIm#37RFn3z)z}I<#qE|;ZpLRzO9H)J~5CJs> zs;v(<9(DeYhTuJ;-?NRm%L%GJP}oOd`a@xAp^@XX4a{Ri#+KTwD^?rt#B&vnUb;+v zmLJ49)O}T8XRVCB$qONs{T7Gk3U^rv*(x&Y@~wE=h7%7DVn|A5A;T1Lo8+DoTgw4U z%cNE(e^*o`j@pG`w=sKj`zu}>cm7xVxrzKT5pkrgq)N#@o#4gJ@xMK`@+s3z&|iGe zsJ>r|7T=`D8qyP}S`9*vDg0ujIF`i1+!q`VRnSv)P5iG4yvo0CZ%cD2fyxd`eQ|e( ztQxZFusUei%_al05%Y)0m9C7q$BY8v;ce|sL}4dzQoiFOHGhAVDYB=E#?qlxcKMd` z?NlLT>hUg~)@%B5uTD4G?SF*l?!evIz~YyoTa^~)afKj$&q!qJa5P`;lR=Xq8c>ScAv=l zNN5MdC~qdPrU{QY8j*OnNIrfG>NbCIxdv7f^q<#eCNS0v@QEl6wdxb;+Rm zKYVLEMNq+<7>CR^6#o6G&v%wPkG1N$k!O%iT&N)srJ54K06&Fhs!tLT1zS7&PIHQ8 z>1ESIb_NcGnA=@ifLS2+tyRb}cI!)-=^teI{y2HNP`h8H+D95lO!Dm-sg~wtj5o}$ zLC|H$J{(%#Mo7==6WkFRN*E(vx#NfYn!Bms9n~-#@HgGc2{mWI*VZejO(7FS7a;JCI?7_0*GCW zOi@Q!zYq7f#*}@yofDE+5DJxCGzJf^zR+vx)#Q0ZcKEl~yl6Cv(P7cyCW7fVV^qzB z-{{BDbFh>pN{WvRIh1Jk8_UO6z>Pz*?+jqi$V8KZAxLkH=jBmAy5!s>mqlBb3~~o z>8Cy)=$e50mij7aD4|_ z^W)?Hh!KxOT$mYUXb-A-o9PM;b2?6e)1BLbm$iulGiu6CE2+0*W)TCo9jA>8tt8`8 z{twWvq$cEe$bXR$^*NzV#w~FbePSr!UUv`ejaz2vVlk@2Vwo+$U8i0$k85?zG~GA~ zzinXi&ebj}3JMj{FVcw|pck=-xD@+kGOp z7pPm>j+Xv4IVCi3!c`cmTPdviRRq1m^bIHsExDxsNH>q}IpEV+7JE(V4 zQ(Lao?Z4%nZZd7QLNHpdw>;;euDALH0x6>y4J+Qt-@9vDSm#rXaD;Y=iYVmz@-1p#C*Clp?)8Ii8^$?uwV;_S>EIZy7m4ls^QYqR?|+m-Lt6Is9@`SPe7{_-DZ<; zc={8zrwG}2I#sm)Z5+_oKVIJ=^^DwZF-E3Nf?dn7M>x++V|{wawU|E7u|u_-8(NfJ zUTAo1A=$iNW=SiZLjpx7W@laFVzevEPZhGn*q=}Df8ZguxvU9|$z(QN9WX{niVfRz&WM0}^Au5ct9c2@^$%hX)JqDEuUswrXAu z$o13MHL23jp*8he_Bh|#D$YpQ)+X6y1iuVKCRnAN0vrZkBb-t}|8l z6tlgIl!wqRPInxd)&ihKe}^r6I>#Ju&YLYe!iAA?kUjzRTYoBUXmqSo9%A6RAHY3; z4ipN_)hq|hD~}&a#%*{-J&ScFOx|~HxAq{famB)_Eq@E$n~_Kf$qvT`>c&ylI2(|d zcZ`Q>f=1MrDAdL;Nmt|8uovZMW8}MB-tl*E zD;ugeAKUtL!wtpov|N}z5d&ES*R{3c*+IdEI4*C~2kMTHyBU)U$rm?>S@Zrz-pM8^ zsT|WKo#(gXcfJW%I#0S*3Xk`77K_vHeluCob_y|x#i&Q%3}^bf+z(*F`Z6uc88=*w zv^i}5Btp+o-bmY2A$&sZM>{@=;xFOtJ(E*ydTQ%;JGxVl?@(1}$}OTL+8L-1&HgG(KNnHg*=Ej34|CnN6n{D?3PB}Qj45+uIDNHo{L0uAzyTm>g%t#da zVqs!)6DykY`^HV?t=03`V=AM|`GjMfKN=-+XUH#}zw-!_j)`hUq!TZhw>q>*{y8&) zBWw9~-9_LtxM}a|czUW-z-b_5r}DFs@UbAtcR4^*XRWSqoih#27jWZ~5cO{|@r#PU z$>yzL0m8e3qi?Y6@O-mAf*C+$kbRE;c@vgo!$H*DgM{I92R;*SL=ONQwhwlHBFh}LO&CSi z+%IoS4si(^32eW7mJ)!zXbH8#Fm(f_yu2A?y^}7v2tT14(&Esp2rEax~4Uy-bj!h`l{rYzf0>Y}3s)yML z{2k4`auG@2=VH0=67BnU?U{QBI$m6ffEN}V5e{?|T6hOHD6!z6!iq#f`15=}xu)VO z_bDf3M)#Hpdt0GX78Cv>#^hnYOKo5~Wc_CS6rH1(@kf8a(Nd&|#im&SD?NsXQa7e95(LeF6wE@WA8lF!^Nholk7dbN#<{X9`+^jZu)jYr%1C7ro6^s9 zfzsJ~sVx|F9ua{|tDN$qL|;b<7wI-iUi;o#xuz}&jhjb-aZoOMaQE{cV6jg0@P zY6v>)e?y7;XV+2JN+`vqGO8>V*+1SXKvKt;byHqRd^}wD;BLvL)Ee0~qwcz(prDpN zTIQzr<0#8zifIt5GNHP~8Rj>T!-%Sa%5#v0RYowV2aBM4bQ@~ywe<|+?_yw}r`I#F z!cx0$!M#*_|6rV}qN&4Nxu;Mz`t}hU>#w(B%C+YCs~4Z{hQH1+i|l<5dp(mYb%>vu zD37ksWeYHymc!ehoh+k2vIuOCUTyK1A;c^E{KylT^zf)q_6)nudA&2>rZF!}x4q%@ z5I=cA@vJJ=I^D|;vvD*4Ke zhxtO?kHrC>-P?Pp%sM;y9BzWd@FE#2_!q}~dvrV+5~C7EgKlo%KNL;`nIG%A&xVy; zJhyuDW))bS#b&JBqh|o0?^{qIa766v5LNWr&V)nr({0by1zuwm%@q@RRp)ZlNGY>F zVYmlQ7CO*ye1D3g$EF^jH^(9&WK=49nxC56WXbR_hb}X()pfdCy*-}Cd={I}q_{h% zh2V|VE&pPyN7$@|c)Ydlw=P0MEq@_%`PA{FqnO#@!Kc78 ztL|s^U|WIZ_7xq4{F?SUqx3F-;m5^84@`C^Z#^`d5iRROO;pQ642`k*(|ehGgVWXV z7A}&X*J^lUGr+(~+q|%G?R8OXpqB^-6$PxY3|3M}){%$|!j1jy+Huyr-U7R zsx16?D|>f8GD-@JifMq%Wd;L>dAgdRHzZHj9)%LAH9*)|8dUs;Gfq(F1!ntgd3#fO z{N5n-l=vk5>q+~DrE!v@aF1*gsWm)s#C9_2oG9a4X5_sNDapyX#L|@3rJe1Gyg;Xs zrleDp_V5oEp+b0$VT&UVn#rqU??;yS9T7z6IQa<9FZ2k?q(K(27Kd>1!BKj>g>!ws zY-?+C{rb4+3r)T)Kx|%^`Fg`^fz%`x?aBfZ`d6v&{~9FKyFs$f0>Ke^7~#R2mppGr zNHjHHSbXjRWXqIrjQV|@DWo{3o_1r0+Yra@0H^DdIi_;@fxkeha1>L~Z1_yC3zgPbyKn-8$P8Tb+&J&lddil0;%<mbiKRdwgg~Tr$;9wREIGdrKhA` zF!^$z*#^g2eG+BYdpU0Uc71LCRr>Rr(X-(H;~8t5k!&Vnf~LASzh8#n zMOpD@Ex6?Gm=;4v{(;wBSJG^=WDR)4CFkNyQUA>7xB@>JAw%zm3Fj=p6$?q6tfF+% zalrizGpHF5N=w8Zx?7ce3^G0hri`mRp54S+kL%^j=o;HOTRAy7g?j=|Tm&}p>(E?W zd0cpI8iv@EJ2>&;kiLe)EsfjWLyAu?wK4$4?78}WT!$@LY|EG~6Pr?M%kvb~vAg+R zZ`Pk}VpAJOMC{hC-YLdzh|ZCqNB#eKLhMZ-C6y{fBArL?qdY~O+xDb_jc&93ZpgE4 zu(yymd8MeEIEr66Y6nL?^2&N$N##{k{bYmRB++=$d7l4Z+TQ@C5T7fJC(gJ9 z-Qw9x3lP5OXU^2uRSLt%f$P|riM>t1A(c^0@IWfpSECf^!7kaiB}tpc+qVMe=+SM= zMb6n2rDI(~^Q}CaqFnuqZH0Q2Mf>(OP^g%nz6v|+2SvsN&a4x#rltTw8xz;1?0vf5 zfX2Sj`6>YC9}$7thL=h@X=bD^D2K%B^7-`sGVxLem^{pR4?iG^WsuUJ`lUb!IF*aj z_H@-v1AJ~|3B49!!^Y*m#YWsq-ty|*)5a3>1DTkZH2AHaawtZBZSNx>mvLw|{QHg1 zYY@OZ4cHwL$7jd^M+xPJ6xmzlpG=3`tCZEvSCy^pa99@%S95Fo>>X&noT%ir-$i-S z{W7s4w?4{_IXWoaZb2aY4wbOyELoJlp(s(4S4e|y5|$#=y?0LTxK{D+XBQ)>tb&`r z$M3cVTnGHWH-MUNLRr<*0@R$6qtN#f$&>c(rcC zfZ9Vk^0a1LFIwI+$xn-SdlTrqj7yrM={WcT1b0~sa)T8vqN2h=^k_Ti{-AH= z-z=QWv`Nr}xX3nMM2Hcr$ZvQ(_l>)b<+a71WCr(t%JrM}r;`xHKt4WjY+}~Wn*3D& z2zNJ&rJhy%8o+-4s#{skc$qmR^W0Gfs_h_@Hh%7<4x#}C^61W!avT)a$#K-Mf`6~SE}w91D0+82I?O7 ztlMwVxZoTpn1BBZ3*`;%aCV`@ykklwvFbDmAMIJaXRV0?Vt+H+ptThtsSJYT=c%&*$cq3Y{{KzuN$R6`TMPPk7i7lCyr+`7gEs4(6RWe@N#iO zd`mz{jh%_h;_!J*23MJ_B~ah(^KW8SasD~BxEX$)LpB5o<*^@}`QU1Ob%(S5$@=EcuR{|^jfLW z*25ihydJ3`wG<*~zTRb|B_?nnU4ZToxiuK5T+kQGb zbmDpZI0l!GPqA9wYSWQyPLWi5oNtzLYx+6g1?y+}c46+xMqhUzxPezN$g7W#K3%`1 zM9}b|b7PDd$01)}GjZ#6P}Tc!;cR9R6jH_fGsz3?Rq!uz}@Su?=;RBBF`aFTIX1^s!o$X_w8k{h%(L4`tXbJBfMuF z^Sakl*W)s&FoeU0m<{7A*7!Sere^FbpKo#}D#bp5S`6QxM-eN@mEd~;%s%F>hPgG} zFG|4QPu#>uCePb22e@?0ZH_~G=1 zJ8o|`%Pv|B^7bV;^!HzO9HE;gqmPwVN`*VzvJ1AVbf6z$NtDZhNPP#1NEkov^Q z($ghr2^KQaNhr^lbqoQY!3tZXJ`jt7NXiB0uoesSgZ(v9*f<;fnZt9FVxG7#hJWQp z)VyFuS}vwdH1^jZiCaDEd@ZUcVtXP5EOfAYvpa19v<5M2Y&)6)xY&5x;PN^9{KOgP zNn2_2vdGZZH@D>T#wV;bF`UW5;>eS+iT(?t3CY`+MYp*`(@AKBogsqqCZVXfcH1;x zP#9VT-nDrl??NAaUu?3tIx}|&C4yWZ0@HwdU?3CJHf2~&)?GZ&6?0_FR|`F^BWtl8 zk+lC034UmcrkrJw%4^j02rUNz$GZCVW5AMai$~28(M_t?cZLM>YMl>~QABv+`=uZ> z<9ZLjwPOv&sisOZ>b49O>(xu4!$HN0euiT3vqRE1o>eY|IM8Akq`0 zN=2{HI$GL=wVn{{C*fHDj9Bk+8M(LWpUr+U{D~(u27qZi=0ublg``>Yqa%#V zZ_@*~Vk+@~gUjc6gZTwg^f2e}X%bw78Ne*KP#8*ZE3DOK`GI-5dr$;>glv&UE1O zZ6+I(*p|9vSY`q_KKM$SMo`*R&Z(P-?h7(^Ok|5j30X`TenjvMH96U{zZs+9kZ^kE z>0skTAhT#WcfsL;PMHOL$)?<4Cgjz0Y*Y74EYyr|MK^$7x(cBB?gS-Qs$#Jl&Ah_- zj9cehD-wBCXE4NLwB!;MI9fxl=HHrTogf{yrHm?Jz|~-Z^glFU6$Wi4Of~Dyj0xd4 z@MLnQ3J3g0;{M=}mOBa@R(VxlPBEgyvm%T>BBcCS99^c~vxXhPTj?Q2g~LiuSH*;9 z<{7mtmC})3mD9)ntEqbgUTq0Mt9~~-V;QNBCHnj^yYkp^Txm=AQq{<_jxN|L?Mc4~}Xfaqh-E@R#w|iVWCBW4HaDC81e#cs22Qw9 z&JU-We}LW{3IjV*q&Iq6c1)u4w3u0xW3YmI%3&OVCNp900&@C5kSANC@AebPEBUI}7yY&2)JI^++16=iePWS*-`^k6a|Cit@ zTLKaY7moSFUZ*gAk~7?I6OLXmkA&Ew%J6JtP?gYULlmrnfShgoLrF?6;(%Rb*)bbtv9qizJc zO;dA19~c_ZMiFa5wZpbE0?k!glAQC06HR_}$N%%%7Z)Im`(`#$RL^LX4?3F$D`ExERhSZg_=k6V^sw!KoDR9;#R9 znnEKj#&0~p9gknrrwg{%=+Xrv_)ys=!&iz|H5JJv!&jDL^m)V?Y&Uf_A+u-*ezPc4 zp)a!nYV@X0ozP}Rb{HO%+VOI~_B{zR&j7O`XE?dXOpbH)thBF=%`FYJG9g2^HG~vj z8BV_C(H!6KGaURjPFsf0`4Q0U> zG;rPcx?q@$N04HjPa53V-%tWuMnP+dDE(?iPbWWRR8WJ;Q5>91(|6^wm=7n(qK)A% zxH0PYUJL3dRf}ic3+Yun@t8Vb5uaU#XT!ZvQE4p|t)u9cnrqSs@92Aq{xjYKaQ%fW zR1{XzPwtPXOExC#F9GA{{AC_>cdVLb2Qx4#iZ7-P`&nTQhy_G~ibIE=g`dvIIPj-; zIa8TUh9i1V`i_@N_Hh>EEvX)N$2(GmTy){R;a4TSqk5ER3CIjaL(Xkc{q0nktO~c{JA13OI@OV8i!Le8%z(FkD5$j9pH=;*;L9e$Ew84Yc*1iD7YsdO~Ru`!hqpjR8M zT+$S-C1cX}M9BcCC7je^0QMWhCwCI)o4zpCYR(lmTw z;4`X-ZeAXgBBYoYfcSaPX=G=JYVZvJb0Bd~vrjb73JauzL^;F$W;mFh{&ZU3Zb&=g zcnhTuS5_W{y$X*$p=Um*WJdCl6vKV%4PKKjk{Qn^=XR?Pi(__l`9`Qer9v^?=BiL= z@~JQjJ}(|^&=5C`#n_kBncB2A;%!Xm@x+q5>n?gMPw*E(`l>q82=3piVEP_ayrNmN zyT;#-Nhj-?=?)x~^9mk^a&o1Yn>Nm#rK?Y{CMV3y8}pngshzbB1f;1xhv${i&x$#u z)fTCO0b0uQ9W&pF1UxvgpQ(xdp>r5p?7QLxzu766F8T0I3N6jQP%R3E7r6zEA^IWY zz}n-;?iD1>p}xiM3dH&i zyi9uy7^`S`Y}el`n9CjrI=TUzIdPzs&Gpvq5VDsV1aq1@(o!fTgcA}1iMx*)%R5Es z+>-mJ-qdU>YxngtL%Li)oYR_-m_s5Fu5M=i^UPTs7iylLuxO754Dsr7kzO`kdFw#+ z%b)tpQj+2;X@T_NX|fN6c0;gjzflnK-@}t$ex&9p^K0VE?wOw1EbP|j)Hw$Gy!TivaNz^d&5{i9DC zSIb{IfnMQRGMb1Pvv8NUA3Be?vi|4)rNJ+2<4h72x&jI=;>r_jq2k1{+0=vnHuzrByB7v5abic4{uqu}nwyC*4eD794uy#E zQ9J=El6@@OhORIYD)z4~oh|>Bu1X_n;y+ht&c#YbW;@+?aGUD=Gntu=Ql~inX0(M@ zJR%0d`#&YFYkZQCD@pCgROuK8Zql^c;wGWNCbQimZ}8_Z=v(PI7^{tX1+Oy|_z*bV zc5LDIB&VIf;5E2Id=e0rbln&!s(oD&g;w9WYVt%YS=cmYr5|E>#22eUoyt3afLf47 zEQ?j$A>N_VwA_VP6T#_EzdFQkoV6?XsAwb=iNS-f^BaX;TFn|8qAp_5onmIlG#v>i zTPCS&3ln#RtzK)-go8nHc1Mt6L`pJjn}83E|+0!^9`Wy{8(HDh_Q(nF5wU zX0K?#|4|sa-MP$`iOZA75RPtkm4lZk;+OAhVQd)cYhiSZw*N_PD2m3t7#32M0d>8-q?oq1N!Q?-fF+g zB5EqLQ>p>_=($6bV$XBaGO=osWtBJ*LwP~=_JD(WS%al2hM-7fR1_P*Rg>HWjZ8YByXTspOu} zTN@v3Nt__07Xs012Hup@@L?_PmT6tP6A!IepVBo_)1j35Y~;u9}&(YGr$bG*219IOkfWD3-IUIn2;?Yq3YjXi|z0UXX#aq&OLK|kz6WN4eW zBEMSYO;uj2+qD!KVs@w#e1KviY&YT&LRbp@KJB$r7v3~hsE~x_@!A=U-c1T$7ikXm zW~&e>-WowhFL#u4uAH|Ab0A=^3(^J6wB1su+MMt}F|f@yE&I;8nn@kl39WcVC*}V2 z;j{2=>l1;n(>C;p$t94qqbsTa1>5K4v&kW8r)}o@t2Dl3LLn&1c8LI~i5Dd=aZ*DI zaJpGTk<~`oxJu57R8{`(G%!xLs|tA+yx|XP{dy9Oc;uxVJK54na#Sv2a;L5<$*1)P zLlBD;Ce?QWqY!Je{n8OkgQRPyf9;K>Eb69V;mY_!_& zlXDmYl%WqhROf{c^SSrqklW+^69bSn8!&@Dih`<|iB=yXb3#8-n2@#=Hw_)_e5|sd zW-N#&=kLmSBlCGe^a*H|P3F45IZIry74qoM=vp&&^KU$l^^k#+y|FW5*_zk%$# zE7V{;8Jh$os@l%4&|PefT+NlCwz_glQ&s#T0_5kr|d#sA+~T(@Wtiy zp^E^cw7SgLh^%^wgadsaG71CrBw`>DhsG_Ier#<#D`kfii7(^fMk!ohF!epiOOMy1 zTiJN`_U(x@^QX2O{j4%sZiiHTB*hD7i z2p*6rgp>X)h+wVg#UTG8=IBQ?UB1=1!vVN*_{F<9AV2L8fTTMyM6b3HD`cmrC>tpO zp|>e1j$!0yn>qc4BSbnh^`zMi?6+lM8dvu$PM1Mp!?`R|lkQjY{72{ulHle?Y!xRO zljyDH#LA`OT_*l9fzY-`;ur9s(!(HnptPnZm)+O3fdpX?>b*-cmkVF0BzL?9BkMoc zn92_kWe9stQuK}GEw{kFs=nK5=UFZUcsY3y<|7X8ivSN0mf=%i zZfEKO#=fOEA2ZF*$s~wmK^!*^@A>!;u9njV=!CZ4ey8o;wjH`{c|EjM8VXO65y>lU zvD-HRh?r;F0!Qm2DB;mezq-f#cap3z+OaEXe!qkrq~Q49vDbLV4&>v7mzU4VA#2iw*xt>vao0L4Flj`%f)`0Kv!Sz7v*>7#6>Sb@ zR!SPD`j}MRXS`DVCdOO+wjbzD9e074+&-5vNp3|k?9`OpR3-z8&y{HcFpXo1I*GfM zhm64_)jLDv9Br4oG07NFt0Tfk6%}gs#mwVx*R0upuw1NUEenkl2&UL-=~^K@c&@?_ zIh7qUE@gZ_rh)ZXJN`35nIWlQhKB8~Rm+}U>y462>48H1-LL7o7MKa?qP17w6#7Jr z$?jX(`)``|E0x%%qbqE7V;Dq7P;?QxysNUYZxYEdNziQ=ix`7_bM|(6er7~E-^^u1 zf#-8z8MiRsA^unPx=niQj4yILELN70L%SLYbSGaUp9LqnR39b^9qo1_+R=E&rxA43 zzi;3LkruYYd?gMF=nFtc-8HeA=D{&{Ek_fw95{5kKT{m#H;jmvhhJh1=37B*%2 zIPAzF^-IPzs9grMmQXRJ zcf?*?>d&0fjP}2{c}ab>LCBw*z+pf1f$Wa{pT_(;;e(u!P#gP(IA^Q_hR-A79%tvA z?y{heVM++;pD}4&u$#9ozHY*dYufLxx}I4 zEOC&F4tsRSs^Y6N0spgC7h=YyfQ#25 zo=~~pW3STHtD*XF$JoV!N@6-0^o4(wsM^($wcW%a7vM&cN_DN_u9eD8YzX4A8*6i7 z;eF*_Ybu*%KZoW0cew{cc*GW214cC?N1n+>ObV&KE0!4hD-swPeKzmmjv2E}3fHRRskHMmhkn>ucIB( zy9p9zZ1BzSxh?v@*LM~+jIfV$X;HruE99MN?Dn80z<;H~{=NFS?e`*zf3LAjEI@=; zt01o`{hfF+cr1?ZjfM>*YZl&{%5%*ht7NpfO2LAz9^44`grx+1Tn8^fJ}EwxSFabTg|*uDjt(f<@4$AjL|9V<>}dgqZx(94xs*EIX4&u#*Q{- zcoOFLxDchp&u(OdWa*gNZD@iu_@BB##gZ!cMH`o=Q-|sftLjw)&s(v< zgpsfQr8WC;l{n3d?uZj6e_|u3h`(M{uSu$@=`CqBdpC)N8z%(TdX%!2@~qizTeN-# zk@Ro3b?|QROJwx6qQ^6tUyAG}hOfvUnvNH2sy^Z?QsX5P^Mr=c>w*pQp(Y|2HKDdr z?DdVvToWI%-|nLhu46-Pbz#FJ)wb)DEs%F_A~u+3-5haor7`@&T4KSmXQdLaB@{uq0&ns64~leL_cQfSRiA+@dDzl z3fO&@d6JHf_gRYGW;_25hA%fMEmF*`sL*C|)sg?CTLDY(UX{;8%^PLVosgsVc@mwo>w6Bz0=OXb1Lk#h77YRq99k z?NoMLwzH?fg>fhoamBW*Gh?_dNJTl2PFqUZ>_ILJCSBS7n1oov4;Gl=M zW;WKU+l6y?FHEZ|%RV1LZ|GP9Q^ z&UG@Y%kxl{76&oXb6#~;{L`ny?A?IJ_kS{St?DupAj<5DI zff+`p&NtN>n)vbNA86YHg2I+_UaFc!SU;`8{~(xZ0CZb!Duaw{)Xx;lc*(lSG8yC0 zyD+c^Ob4;!FAw(2CzvdJ3%8Jj@UiFUNAgg{e6xyq9&K^x(Js`+lnmME42!RqiAE@K zPVgu%!WN7~*X9Z=Ke@8HnMNW$8?dd>#h~|N&KsiWTTLK7Xg;TL0f%4SSF4Kv(2zg(uOzQy!v4qe5Fc#pK^mq!01DpA0uRr-6F##y67^L%Z}I1E zUI&Wp8GZ^>teT4nF~j%+Lc3-eT$ccGw^fPywN?EajrRia{%_P6&Eo_4d%`o%M$yeW zypPvR-=oJQK&!x$j^n({(!!!-b=Wu*IcYfE&7`CldvyB5q6zT1+gK^Lz`TX1e3&7~ za*{Wo4-o}#2;rvw{WeyPdAgD5&|A2W9!oi2`g&!zMYHK_`y#CPB3;d;1+Glv9Z>OQ zqC=ey7y;PE+#xCEZ6LdI!w-4#C-gPb1^%|FHFzVQ~aY!zk_$ zG+1z095#!)`y#>JA-Fq%;BLX)0*kv_(BSUw?oRN_Ip6z!_s6||=9#W8@9OTEdZv0d za(=$)?Z6abmPKq2x}XPZhSR13IVzM>j@GmGKMQmiN6%|s-R5h3hk$CnFlXL93cVjS zFeL|Dtf7wG1sL)}IkdWX2|R7m(Y)cdQM)~#MBv7ki33-8_}-0SNg8Xm@)95mSBm- z42I>&0TGN0F%!Ndj4mX$tkUZNh0MI}97Q7e-;SfqL^BHBl>kgqBPR{@_-f~+F51Z> zX(i!!s_nsd0WMT$)+LyuG|vvuq;(t#Up1MOTzQ`Lg$b}T^cw%w!H zY*D>LmdOZkN|Ty~P*a1K4y#O11FuNr;e6?!sXRLyhcQojoSKrVM9S7ye`w+fDInpu zEGCO+aQy&xA-rT{vD8?bL|VGTIva6C&2l6o)R_gEk^(*fI$p%Vm#@O1Dy_M~R3Q1Y z#W%oWpfy0pV5?<+O)_VRun?8p(!l%g4iiW}v?es!1z(RH&D{W@)x33iRpTG2 zDiQ_3nBa_5VcrmZ6zcDnLqn{D5{HXI7|yYZ8={$v0#tTt71Uw&Yui-Jg^d&1af5#1 zr?UFlr9=+&lbnPk3A5pR9VyGtKEc539K6~j^Flb{`*w0ct`bYKELyX*tsw zsPk&`)ybUK2$3Pk;fg?5s->L_u{ccL5CW42-*uB#kyr|IYWm|H;fzjx3!2VIs@G*q z)!!-I81x9Gkoe&cc|a@NZ9HAN$bIg^xg2=l({C);1WEfNin@JuQP2l(_4!8Wu!Qhk9*#_aZy z{1H+u0Z~67?K8<>Qy5DBliuCT0T~x5@YFwMSI)itaDti8=%eiPcE`gXHftufjir(E z-yFk+6H`$5+bX1^q-!k#V1M zoZU48)r`&(xIc(FK4oCMBei zh@2pXs)dE)kR5Z(rHP4|K6Ce7!l&hBW09YWj(-~{D|oYZol4U z>wwI6?iH;c#Q2?sF-$69$TKj%XFyZ1E1KgyBV-;b5|EUmmuIJK(A8+7xbC^SXf-m6ZQUose8k<=h3opf^OuZV7{&+V_zj}P`e2LjAC8^D-yyh(meJW3Sg%Cc zY08QaS2^|l1Dvy$(2SRtB)R#L!P|!*HkD=>Kzr~=BHZWBdTJ^IYf~mq%bEzV4$e4O z{+fAZID>Q-MB{(@JYTU?z%gIm#;PL$!T(QZgid1~m|l%bcbq$=W1+CoO!vw&E-0EJt!j2xv@g z?F*^lZT{=;CPOZcpi&D)vqo~9F*OZKX)N=J@Je~8TYL*qz#sD-oknEQMdcTw1k1|f z{aw-8n7UhP^JuZ;AqxSEf6_`J(dzVUX+^m;(mJ5EB4niNLz4{4m58xef%K@+pe7rf zex|C<>tV+CaL}0iS|(bu?3yup*5hIR3xkK19Wp+t<82ml|2)_t0b;7%en?9{k^eWS z*7PrInwF^gJ}hH0H5J>OCKxdDvqRK#EdVqovz7_o+IsVG(N5TBw(WfbP(|7k zgujjdg%p#TRFms@6t{5@jR}w4?=yslc`#^ZmFOkX{FMPUc41VIt>TB0BrJ=iY5Gh6 zn0rhhkf@{jJ1oN;TKI_lMD(I%f|D32@e0Hu>AMZX`B? zUow&zG6P@jMV*7_kbeM3Pwqtr_Mv_$wNPz!+TF^#npl;wC^a-I4@62 z)!5=?;8_yJ6ajYDe|Bpl2kb=<0fmL)=xYrS?kRSL8S&m8PK)oI8zceSxQX=WX4**^ zDQ#AGE7zlmU(%`*7BGFKM&tkrorozh-36gEzcGW5#fV6Gj%fX1fA`(}?J_z%1lUg6 zkR?5{4S^_vk6cB!u4*ZbdcGy)gZB32xvDqQ=;=Z5_o5zO###TMRlw=6qWhX%{8*0k zJP1Q{$F*$!D`Lj03)Zzed0iY$dMrc~Ea_S_I9JNl6vAK=0&Ei8$Kn>V7ths#p;P?7cuye!rHye`m0l_B8 zGG!G&%fHm}%y2Nn<>)N`WlRE!@x5}5&6{&^>OamJNIoL2p|+;qB9y>{vlCI$ zMPM_aNXn?90kA2p6QEBEUlN4+UY1 z3b5qbrIg%9ak=*y(qk8w_xD14N*HmhOMkQAjDB1Dl3Y^~T>tJUdvDe8BR9u4v(Dig z#7T1^#uSFI)r0KzGbtjJGrdo6v2XS??rW~Qir`v#mA+KdqZNpz#7=?bSHj3*Vpv{D z%R77(LMMlk9H;|Etf^jF`deD|1V!R^hlHE<2(V09MuOaKAE>c8$@Wzj5bX$lNFUA8LES0lRZ!GBi%ggc-H}15MMv{YM;^UcV$( z3+uuRQnMeb5+LnqU}rR$c4*-zch^QqBa?W)2<+x~4YO?58LwrcY_Vk-4x4LG`ZxoXg+)l47Ypq^kTjWNPo}xv{(Zc1=c?uxcQ|M1+yn zP7U{4(;V%tlv!Imt+oYxBL#`aNl4hjZheYLTm{S|LX(4GY@xFBgTXs4(hsD56|o9G z>|vt%pUR{`Ta7VrF*OA@g6-b{GZ8AHMgZg&?dJIK$g0YKtA^v zd4=r5f&|^6@xZ1*TyzXp@A8aH=O}c-Wr;N2h0f|XlZ>3qz;!ln3NY~(G+!QqlPb!Q zS(Di6@4r?o2br~XJBhyJi%s3`uS+fPiA}yp65rW;AsWx*@N5ASrC2UhM)=DN4-M+!zbx>tI23- z6pd9}jHTY;JIc9J%|MnVVGsW>|H?6qM(7=idu8dAju<>tB-+;{y|5n>WawA3x35 zA|24I#kr=^AP z{(u%FGiAtAO*)6@FyJ`hdEsaBaF$2fou6N!?_AR%{%k2u4A-?K9kB>}>dHa9)3EiO zH!#zNe1=RRxuBV2XqE6a)m!jv6J`b&*|V>4-p{_f%YveNkIoJFdlo(%cyxAozNQwn z*4AsU*tym7pk7Jd6^`W1g=p@XZc+<(KW)e=&)(b%{RPXcm3MTMmsfq@PE)!|CbKfP5ocGRKsb6|6%q2g0$)X+xH6WR=w+i zQ<+1=0jqri1Jy`A0It0s0OSvVMldqq?EkBXGYS|;=w(zp_8-~*tKI*I`cL!!s{r=@ zvE+kQf?>eW3GN57ObpNelKih#|EunG1;hVk`~RAUem`#5WSbe;1IBqE2%GCaora-Xqe>J|N-bqYoMtPozw!nwZ9$bk+N$ znn#*UPA z6`jS+Sv3!Dy_6B!j=M4F9jFsMM~$*zOOJr^7U2YLFpwTxgQQQ|xLgRdt@F|4MRKfH zy}kw-g@hNbGA%ja`zlQU3#WUj;R%=;v5j{SYaKap`6{XdSFG+O)H=}$ig(2^Avk}U zt52Vy3{Y@DcbR{db2JOu`N3>p6pN^F9b4~QsMc?(A-7D*M@9@Z2qu}e0Q)g08wR?v z8{IZiKa!NqPweKfw>y*2)<1KC+0PCwaUGz%ikz!96Pg_jxD+gOpy#89qKIGU)uRD^ z`umGTKxTz$Rs|;ay~3aBt|28%x#00h61m-8eDMfEg_q|>0`6KU>SI^H(I#&sn^glft`o?5Bqsiuuxn~}Rw ztW1*!`Zd*h49GK95?$Imkrq%MMV!8+Qc@8w@$kBf)oq>e8j)REWzLnV-KXpcPp|yF zZ53qEgzdlY0H9KI=K^5iks{N|U9eHQ5yL{>u0pWLje=#enwS^1OsZSZ5Z$^3L$P^y zQ*?nZK<_(lu_B@4q(OSI_AjK#2jfxJKh`T%?H?%&B6-e7w9pY@w- z$2}hdt#{^^XUPl4zN{n#8<)?Lgbbdcs*c6X?mFbhwZqM*R`gj;*79K|G{JSrg*hC8 zq8Y#iOsL<2q{@_2<8P(pTzxD*tgX!u@EhmtEfSkBZXdurmZAr-s-)s#0=x+}USo^` ztR&$xPRwz|iZ9k;U0WCo151R%7;eS484Y0s(~*>DfOm_Giw={nFRJulOD}ElM(^f7 zgC=$%menWUQw22^3GN&JaGrY3UTnp(3>Qr#(gH2{dkbz%ZlOEZ_w3lwILV!E-YS3a z_hsyikP3R7A6In+AOktR8(F1ztPZT7?BG8sr%vD2^S|7`9=v9GxPGWS|EJt3!16D~ z{9<03p;h(2K|b=~J3chl9#fmBY@hh?46_WK1IE}-ie{d~hE~wwm_FPZZ`6XUT?PK` z5^z`V-|Zpn0?Zq4FD`Y-Rp>KlGg;OGd}&cY8NuOg0Y7xUgWqP>0dj3ncbBUhvN z9~r;N+^`@?Vee;}=|^OG55iSE8G|>#$0zvJK1ro43oThM;|-Ust?lAs;Wa-v zuVNMDNT8_1zlnatVa2=21)AH6={+4r|9%<2Fo6vauG%6l+N4W` z`e3`wT83twoHa42EuwXNUNO!rW$8eV>7wd<6pA_7LLzBjNA;bmVHb_fx%`RtYx?^n z|GdGvbNBX6<}kN(6D+0^VHt- z*4t$zDcd$JL5|gfue&)O!b~fts85GpwcrEdy&k0SVWP#nR>nkpA;D5%&2~4X+3AOQ znmH$}M)P7&Xm2HQgL7o#DaOMF#wkMKG|s`STq z)@2hwv6-YVW&P>*jBe8nbpwHKkFHxZ#y&r3e&aFwrmQB#~3 zr@43ul=ZMzSc#2HoZ+YtYiYCm?oW60E2}OWHqep3SjlK(m`z+q0r(*=oSZ*l6^WlM z>sk#^%TcM39xSV7R0fb|)BpPVz|IgF2a>YFRq#1>8Bhmu0%9b*j|=F0I4J?t1O^0) zXhqaD1DrixlMyQ8?teQTrUC#>`(};(gXTDJ1rglv!rhzbJW!Yhc+fX zw`MIhW{qK{TMO2WqA$>=ANtx^j>?ARIH~*+AM4Zm&C@n)6hX~P-DJbVPUQ-mI2=Uv zQdL7L21Ml+u}(w_%CV|kYTS9X1AJ>Af0;jNA}dh z`ItAG%kX?JFg1}S!8Mq4m~94HG;lV|A*+fLdXc?{`L!=(5scXpL*r-Z^3#)^X?#WB zDlt`oEMZZ$W|AW6H(gJ|ICJNUo9=3TQsh^mTkQjKspKDW42fl)AAS%2 zvHsoX24_6RF-y?}2fR~yy$`7|+z-bS*Wra9v9UGAGK5L>vgnJ<`Y~1i+>b(QOCsaj z9b*awhEgFrOV=16%^1+}ZZW-*xA#LfJnncppMP7LTI~NXGaPS&VjY_n+;mN-R4B+> z*@ayeiv4)9928F1th>%;5fj$W!T-}zJZ)&QBYFQ_r(*n{PL0TCyF}8MH`>Nqgb&K~ zr}hi;qraks;qV_qyzUyiB4dIGP(LtlbtGC?NbdX{8nB@Nen)d<7r+1DRcKYrr4ngANS?;19QAm|F74oe(BPj1bPs#swf}S5B=lj*Ob-2UP1Cg$)J!MT%trp) z$X=C;6BL9i^r-4rbLUIpAA30C>?-ReAp3uCV}Z*T69lrEG$w<|=CzUYM#CF7h^bFV zhO)Lrn`qJYPI7g$_+t3zbYdY4^Y0pdW`Euiw4NgK{~5*5}AQnINg^z7cOg;EKZUBF$uT1Me`!Q7^Y-?Rq6Mx5ake2vWQQ~ ze`GdbZj{8^h@bM~pqp5Co-lb2Dz*=`3gou7qe+Es67NsLKtoND3N z9kem)Q7p% zKzYo>*4E@ICeNlX;}7y$nLqIDe}rlc0Y*zpD$C3JhhyKUoR9>MKKULufN0BBpGjo@b z84ufj7nR(VwRM#U-i38?kS2*O?CRRa#y@{xG&$!ld(-|7^IqnljelVn`C{iKk? z!dy|t$e;1%xoX<_fH&U!E4m^27giFu5yASX<;gA_!QDPtPF^UG6--4DgtsO08BEm+ zO!FovF(Povq=U~$M;U>1lCY(b27)J(Ip_V*lfW2Fb6Q3xcD1nT*5QmJg%C(*IglL3 z18%w46y~2~V)$AilqqGA+)bU#1vs|z$!U)ztUji^*sRr|GQ^p9B~DSumCiIEu;eM3Q(#J`8tC`m?q!WtHYYK`;KOJ@G7l2>A~=+V2un zQ_oyKQ>XOnY8f);orm*RR4lWn6ORg6K;+)&1p>98b&IL$uqmgS#t#)!Rn?5qRxslJ z#twEqc;|t6Y3ZZd^84XSdFF5sOWLqvG>ngr&p&Hb;?d6-MZ@wI2`n?+bX7^3B38_$ zGC<2+G^M+~lq4+I)-D7`%EADr5J-r3zag z?NKCtyzdsqjC=%l0K+ZM5^rLbS2#m1_h3{Uzm3%#6j4##P}z(*eV^G1nG|H=ga+4K zgUFMh)5+A0VT`ACWX&IRaN7k>&#yK}amtEFG6kI&H5r&?1hP@3_FIz87)k!>jEw+2 z$ZwOTuX=RP1qPAi(i9RthjAdNc4Wsq=iKO=iH}5ATYa7xZYvgW*S;Gwae%HzT&v7F~PBGxPU|MWJBwy ztns#n_^hDPK#Qg(8viCdbad#*7>m70R`-6K8t2giI1VQf3X#oka<+LAZ=5qv{~@7{ z9s-kZ%ZH(Qh+>n^nDa)XNT*zE186QkH2xmZlkyHs%8>UrQ>D z_MY?gDsw8P334Tqyk^dr_0WH}xZeexX5Ed(Eg5}cCy71a%qi%$cmyjlfYDo$E2c#zfs$j?nwuB4Nq7naQV|=8|?fsA~MR z-ovQ{zUYvBoX6f9yL~f(eKJwz6l|5YC|}}$0E>%^uRo+lt|x8GDBFQCriI}ot{d&` z5s_r_=vVv-x|y336c883h+#StFap1*LQdkA=4g<%2xP*Ew|Zv0o=#@B24{7?Gd&Z0 zEWCuW-ri0~<6f7r&k;FsOHetddC)KyWS^n2KZ;A}$>Fgs#oITk=h$GOJ7L?Zm0+dZ z+q(gO%d&}muLfD{g31oG3Ak{qZy-&x4znNZ(x}spz3Bq0XK$lR0|fk$(-H%wMARTT zA+J6%cMoU}r$f2d&Pp+AT*owNU^2Cj@Es8d?lXH5*@^|B=zeG z%WT?=QbMwO=r)*T272AIo*^paQGCy^2E7Ss04^OB!~oDK9~;mRob2Fh(B2e<8B~m+hH+XsXbI+2 znPPd}Mg#^(WUv|LD-3A7YNDRWiPQloZCj#6Q%sPo&bo*X!a=odB9#nx!D+D%Jh+s1 z6yU__MfR zQcZlPwopbuB3IYOOxt+Y2QFzSx`26n9e_~8h2ZvI=O$rT%9ULdEXtH`AE)yBh1^=W z+vS0k;e2ayNs+FRNF%qg$4~>EE|F~Ns7K&NP@n&8T}|41j%JY*U%ZHYf9+ZdNJdTy zYo#@5ByYDB;dh_$ll}+ckqS#TGZlqio#65OVvHhkqLd1iOm7x3{E8~71vu0Q)6D1u zo7vv!3eGkqWhs3n^GqiD_1IwsVqY0gY$kLcBGjqNi!A##b9ITK zS>QHI@|&n7Q$ zY3!%1AfOq|6A%IWZx*(W&4muMR4V;PbxFbW%7#9UR!nX}kSU?toI;kVaR+z=K-{-z zf4c4dV+uo)3|~?s{!ykrQuPgrCs)Nm{~KT^Xe-`D6Pv>%HCzJ2Vf0sc%4$xod^oKa z0?D?4lWrG2&WMJINA|?q4AcNg3^;3dVW$iUn&@Jn|Bn~kO3NUeV%CG>~+)H#=(xR{Jg|L_O!ev0r#3|T+1)C~~e%Yxs zg_`QZP@2aS0mJELAt6EDmYOlm#?FI={#hk>8r|;+9%Qettaw>+iB%Y#;oIk2c#b>Q z@EjyKD^y7j{(^#hx+YLM!tdS*#c*2O_le^*O{b-|&ALP=o@;~4C!NK^2gI1On;NNw zuwmQpmskPv92#QtJ+vt&jUhGNFuhZF=F@#X<-sw35|a41P*l{=Xan_w-atKlNi&R+ z4Q2X%LtDkJ7Dm@U--9j$^>w`Wo|J6QPQQz#)6MZ>cdJ&X90+%dJ!8NJ7A{_UqbeiJ z`1uH=62Z(q9s$9=%&DYz2}?;vvSCtiVFX9q+I8A?TRIj@FgOV|mc4x?d;HP;Z}0Q@ zS&@w20}1A0f`|5;xS^2#QTo3?uZd<4#UrrqBIz~qiAIusD~)7$S=#!?v+MLX)N-Ot z7k;phu%*;+5-r)=UGdnkwVo8*D7=_f9I6e(hI#z|04Wf;Zc$x$SuQ6S1z zue%AY16t^r-}F$5a_KCI(6`y3rmB^CIGRn*SH+QpN*$7RsRj_~oiGZ5$&SW8=dbQ` z!+aTgid9BYK_xn|ZocI{0Z3#$xKxapVo-hyu(WLb{rq@oV*u+f^Iq?BKcMxxQ~tEn zJznxBxpTUHoFLmE3o8>#Dx4vV-Nmp(1+x&q?2VCfWZ|LaZr$5=lq;A7)S}e3vp{QW zNUIgutqnpPn~n_me!x;K_f|sO=!lAzE>WnNIv$?SNkMZ+ih)Cg0~Q1ppd-&og95z2V#sa;D%hReD11g+ zO@3fP253k4!HQE^;tbKpOa_#NX_S%=(j%p>d}((=D-Y5=HU!mSWm!CGUl9WNnb3$v z3>si1^pxFw?se4#J_Yudn$G*lM8VGZWUMuW%^Rfl1p!G0i*Dluk&`i{_Q<5^!G7p5 zIO|uWxcPSMxt)1P;4BJwfb8-H6d;J)uA>|}LBYu1#)}~}7d289rz%87!Lk=_o4`+I z;7Az(NA3tO%c2?A&D7%-$nQl^f9`)@<=~DAvv%IK6h_DS8S?mOl3ps>*}HX0cIH3T zIH5%4VLLW45LyCEpuBi`5DCPkXQ;bW>nix^Wn1$HHUvF{#mh{)7l@UKz^@nAgXkci z3Pjl4l34D!?97)g2^Lb@K{A%d9r{L?NO&Fq_mcqTsK5I==%~!VPv(gaiiQORvbXW& z@4`q3a`RPak7`4AVOK$Dl1xBJ^ewmQnbvAQMwGqPQT^(>|4;`HOIpiQVieG9 zQ)V9=HnDg+&8`HE1!gq&Z{$RUv8pn1!HI;iXhxt7x+n4~>_BMUV%bPXmz``T0yG;M zO&g`UOaTQ>U3N|id*McE4tyQ=k8@~=vP}hr6HvgY(`hoDL4ZgKYQH1gE^@15UMs%O z|2UqMaiz|-2kBai^bj6$B2Z^Sg8|o-TAVMW;9xSy{U~n8(bb+MH#Rz@%efA2Tn<|W z#q683pdVEb;Hrq{OH(=JbxD+ZZ{H-Nw8JK6=3v^5ROt{cr;WoI3K8S;(S}{ChA^%B zn80NlMGXmd|4lZL_VRu*+{7%gPh_-Js<7X$o9?hrxbP}fod^c3WPsNmI+(0crI66B z0)rb$)r~21OQg7HRGdqtq6!}*7nySB=;f1Rh$P>8t{U}xxbcrvFyDyh5L_U2cgh9( zw<;wbgkjT3#<3SYl8A}1qquCgBwN-%+D&glbS*@1Q#q;}+6W1h(FPyN zXZ&|+l|I?31$4n_V7IFf<@objYfeG>o2kq zPG?Z3GR;bwg$I|6?@g+zsM=7bBp)ARcbPKKve($87CO!B2Zwv^y9?onha6$q`M#r@ zOMWG{KuXy3LIydB`XlFWRNSIXV4%3QMLVQy|kJGz~rluYkbgGcaMZ08~f?;*Hb4Xgb=9O?3uY&sR2zrndc*k1b~G z_JAe;S;57=GD1dt(^>E{Rz4`eA;}VdMYD0HT9U`zAT*pwHXmH6->y&_wX;hF z0hZGKC3VOt7!r*w_v#3V;8a6drwFe6Onh3lUZr+xDh5u|cFFfSWOG8cYgGq+oPOW- zsEM_RZjv$DIx;TQo9UJ|k8{3G9fd()cf|rE;vk*asDp^D9EGcl3TTFIU`f-=nmRmT2|JQIa||cc#d9x0z_|EA{)!M z+i+kDCalWRk-cSo{1&OLiV^&7bdDyr(pt-3nI`f~QI{aU43^GaI`P?U`Sx2qz38mW zWN5-o*%XHo#tOHJ&SVk9R8MqCU$9zR>L1Wc{S}awhV^NzZ=!oKOu(xmC!o)f0|VpBJ0p=m;gZ*UOS~V>_d1d(vZBy6ftrX={x-SA$XEH0w1z6&;#NysAi&zBn~O zkvj{QG0b;WP*&lSUpt^rBO!s4J&FNVOg8mb*J#1G%Vo$>uk8COdpbKidtDM6)sDEi zu9eJp*vB=?E}Q^Jm=fE=?_#uH?!5NV>6gZGO}SKv-@;;6fgS55*vW zu?!^WnN87>b}bm$z1EuF)2KJufvd{QBDQJ`1;j?;xBF+!cCDLx4zs1SI4cBM1Js2i zS^@k_GR7!(nBZUcv%7gR4#&J;%VJnCqm{Kw29>fJM-aTu-49enBr&ZqwJ)i&`w*)n zVHMg`r5VV_F?OxvW^KlYOqJ7STv@9HV)GR(2E5+ZOujzKwPmr2y8iFzZvPO64XP}l z4ntsZ?E4B$HGWDz8kWvao2gNy0&w_x6CWI^A^%*%YkD>tvD4KtORI=1P6Atk)4A=a zhFc2N{}$UZ)6W5igZp4*tiG2Be3c*oEOF@F+GLQ|JG>)+#A5bPMI|gebY1VDsbkMhmd4?7QOP^+J$8 zEzx{?n?6j9ZKrADe>wxHXeGs)Nia=@KbsDU1r=-~+XNWY=F5hukKJoufhlo%j2J~` zy2|{8xkknR7@d&1bIn!T|>248~h z84HnRm^dvfz9}rRud!e-CFAe3PmD;#nV-Jfc7V)mSc4yAO-48_ze9#1EfZ;s*z#OOQ8hebGdd;eG@E9 z0zUp@pm-P@U}i48?^8QUni`BHmH@m-6CJXgoiPdy*v^WG^m4k-3l2z=*IoY820TZP z(yuv2&`ap#_r-6X4#}8GEu~TIwcUrL{pT9p3i``GZ?~oMC>FD}#x0-k2u;000mLEf z(Yzk%=yzAF#b+P-A{3Zv)ETwrS#z?`?a$u2Cw))bc@_M<|Hf&tx1}}yXPz0*)Y=tP z0d5Hi#-NP>j+)hZ_CZI!(ZxG5A~x?Mha^3+6A6L)Vy}A&{*=}w4Xf#F>$pyp%-60s zP`|lR4)soVRa1Y=bO`-!9&&_;`hyu1q#j)*R3swVj6zMvjGr71X=1SNP`6$)tW^2V z5%H$TX!c zUZ)mSztD8SKiutv>}~R6R{QPB^SrU};AY6vaY+K@jlZ#O^& zFrv~}lYII`T;}4-sH1*KLnB$U1jtDm3r;>8NywAwvSKby_ZNY`KxF8r^VC9FV!{G% z)ls!iUNs`K%Qyv)qJxpc46hlZxwX|A8iHKx5W})HRIM#%!j)Q*h~ zqHEV2OXlbFVB>4`oC5Kcr!G2GXQ!mt4F3T>%Osv2t32Q)o%WDn8sAh{HV-`Vl60Tc zAs1S`51A|@*wz)8KKPK{sq`L0C0JXNrefFYXiwPNE-;y*`Im?k>GeX33d0$tJ|$tX^63fZ?>?J>V(dqFcieCF>WjIY zdn=CCpBcl%`P9LfjD#;D%13wy%I>5bflI!3}Nw;u(c zg9dQ`Cr9jKf*^-sjdvQ=F&AyFQuS-J<%+76`>=DE;fShY0!yaT>>^V`I{ZPxVH5E3gbec?5 zH3Dgz#_GfM!?;zp;v+yN3=>W>n$m5Hm=e$C&EkmFKT6fc)(u(0*oiMpB#7XmUaU{@ z0XU57wpv3r3`V`X#EgsstF77t}*L>YYs2gg+`N@4p2Jv5oL8ia}ZsCZ(3j>MErG3yiS@)()F=j05qk-gw z$BUo3qF}!$UII+y+aYT4m){IXpqUuX>&@&KEk>f$rkK>Wg+Xt^UkL)@Lkp$fs^OF`4p|%6CrZcw+8?+>q-i?~341?qY@6RABlC4ksifPP8^|C#<6uiOL@o(n+1&X}$JnPOlgw>? z)U{WnkJK*AekDsg6keAAHD`O5!2_}%>|4u#arC%bM7*!}sH@li`zI4z3q{Vp1Yan8EjF#Z0=*qH!mul`9?CXs{ z=Hqcr!+-dB4xw~6yYOP~E?V*Rfy2P-cdSNpk8q|t?IRu%gxe>qO|8?THfp9^JOdT4 zmGb%DC+v8?_yU@BR{ugAS{SKdfYvbq?PZ^^NM5B?s^M`c)Xc)1YJ+LZ=imm&XR*A5 zVw0-zEg>>Zco8d%iSqn(eP!l+dSaI#R0@PY8Zsq}Hi~!f-Ejkcm;THgFFe|Dg;!=m z&O^QpZh%FWCw+arzzhKe7MscX_j{twVa6_8IIwB<)NL+f22)d#An#_fd2p>upciBC zgn`EIxeCid**s(DgN|5ZYOhpk$&W!WIJ=ohu1rN&H z)+!}_qr03Sv=OfRqoC3%r?!7beY=>hc;CH?p@k(}qnR4T!aTLcK275}2yLL$Hj`=$ zyNP^GI*Xv_T?DV}QC*aBx!AsF2z3GluZF;wD{i-|^WE!=tglBqX(g;RW&`DhvPi-$ zEYa)23kUd5>pyJ~Vo{0kPOScg+gtFC(R`$;5aap>?4TeUZ6ld$UY~^)y@4urs|Bv#_(_N?5Gv?D`P$ z<18N$g(Mp3B`8mhwF`>vz9~Ao!A%U_{mLlq79_CjF5{U$R5Wo-V3b#6Qe0xehDkY# z*s8wYtqIgktM@PXcuH-*{YJy}2PP(Yh`8JP_`CZJ7myEQ?&O;4BZQpISNue9HbsC_ zqwE@S`%Z>l#G?#MKV87vFGC^qF%@$2+v_gx+RU=ybY5F&S@_!tsz40e)jA8v>I4jd2c+}4V0UnkP{O?D) z^K)M~*Md)s&aDcgEEJt>u8fINT1Wu8N`<>CZow2^U%UbSmiPG0|6o)^3|lka54?jl z9$~0{@&M(r!S-Ltvy6IlVG{1$%T6`z|QOAyAU%xYB3prQG5&f@NrNPth7>)>H-JIuwOBRoN?XpWxwZu z3!msnwN+d5uaP4s+Hi{XAzhiy={F|bSaHep$9{+DoU~$_hohoG8!n6gc=cJ*xKXco@+TN66!MfDPc%XLxLF(M`L_MtBBwWl@3R%ecFWs`&V3K zpsjSUdhR1-Z0xwP=w(J1P%$;vm9>D!^*%})mv12vQMu$a%qcz2 zd4~}vwq|W2Uw;5QZZld~-|nsU8$*0%JKq-6?jjW4Bc~_+Rc!LfQp`CNPVqHQ+@krg zR;g6V`B_Mt;>Y>^@#qN&-}l;QxIczT@O96>{QI!+EWLr5>XJfH?~)r?;TVbr$R9&i zBjSxz;qO=_(4SD$7t-(3y7*0i>>y6=Pp!WRM^k+p*k$nQ%BMj4B{#bhe0)~gLtEjm z^l6stCR$HTX|Lm$gx900)dNNEh21kNRHtm#kAs?V-N5pkBR&ghVW;Od@eJXwg~5LD zu3LMtgOo5Vm|>z{(wsdZ?e&>_k7~IAv1J=+V?>UlolPY1WSiKnfxJ;&n@ss5AB22& z6`2~Yue8g0_LrdBMQ6d$T6oIbN7*pHWLZ0%)Cpl}1POhsK6m*}#oFSytmD1S;cQ}c zwcBo6^2@;068DxcXFnW_Cc!QPt{8s}#s3qL3U2i*u|!BhycO;v>rY2Tu6(fJMYH)JEN0$p!xzDO&im6Ag~^32%dX}@H5Xh@J6k0~_^ ztXe2&iW5A=ppcbxZf`J~gre@)dQ!&^^VXMxd3pCfv|H1?FUE?GzdY@`x9=9f?j7+3 z68>_;1WOHD)cwKXfuwj}EaHEc-LoGa|E$#*dxzoo`2mw1@~CUO@~?-6fB%fHFIs>I z5+o@~TA@&7xn0F6_5@H66&ECy*&W>2J{t32!|oP?*QrV%JlN9E+R>`~Wu5kKSQO%mdjCScmCu9PLrOVX5%Jc6WYO(6-C>ig`? ze$1($KtUApM0%nH(WuK!Su}3zn^cyX@-8228>Rtw^U_jTPfHL{L;V<1A*QtdhMnvP zPRf%41yLZCd=-CYyLXGi^L&5(FfbdH!0Nac+lJ}F?N~v@P=iUDD#4M0q$CMSJ16Y; z_*im+Cj|;Mn?RLx25;G>rQ%n!hPG~4ICw(S&>U?Wrja=mmOMGZO;gP#7!f2X36umR zc6uuQJt0pL6slH%D(Q6I3-bXroD2rtC|s*3im;QfcXK(t-7ZVF)61J4_Mzc9ed_XM zpFLh-uU~@`c>*YiLc7W5xxMhNu~H|Ttd-iZeuHh`x9_*f()(L%0KZY&ty7l0D3UE@ zvBSed!D-=1fPyHHqH>AWH@n<2{!bOTx9_fl`#v60$x`gXM%8FD^hC6n21Wxcopg;9m{juZTDDoKse(~2@YW6pac`iFCv=fI zoO5=W(Prw1$SCA4?pRg~1A|G5sx4DD321>=tun`P1SbLoQRp--SxkX#8vRAVAn$Du z21mLJ&cl$-a>-_Nu1FYiy8B&D5vCPKs3ek<5bhMPVzCHM0Chm1$W-Fh8(~}5WQ|dy zzezRGg3~Y`pEYGqGMXKqb(9}2DAAuTO_dN`lhjpdSHxHmIRpx#$W-#xE8(5jMEzON z-!N#>%W_dCIJxwCO%_|sKwLpdF5}8NETxJOK_W>+3FR0nu7H9lLX~*?hHuph$efho zKFsIyKOaiZOnSmT_W1oj)6H;Z{2m(iRjYM(TGAdxlthc0;p{C#tDs;C9VOpRnFoEK zuC@#?rR36#jvBT5Prc_LDAPQss4k2kcs zDDeMl?|ws@y50beU%j_E{H!)@l6os`?=cm%)}MCS6dNW(Oqd{oU`iX2Cg6+0hQWr? zq!bEsEJU!gjMj;c{aGssu~?+Inu4?9n{>`NsHyhAaTUvHN7eTAYD`Vubda%~vm>6dUt4=D# zHD!iPV2>uIknhW2&ZM_AOyd&7l$75B1)Ps&N$HT_ z4-lH{De6z>d{pe24z?Owc2@5Id$vfN?^CxMV)8LbO-wIOPV7Ch_XSNtKX;@E#Ka!* zU@9i_5d5W)Z8||}P8`IPV$Z~S(kG@WHKy7%88L-IUTEp?Ht>HbEkeg(pM|lgmri_5 z;U#XC(ueSb#l*@A+`LZ%aS1Iu?a9PJOq`uJ)ucX_+g5pZRq0w#n|(5|mNwcXt;Epf zN%jNAqFb%hf8@et1^S{BH|AoJVi(|QTG9_DmD!U}S6A1RLzk35g;bM@X?;spOspld zv?#eukyPfLvXrKj?Uax{V-u$t!0YBUtpJG0w#x)qOa^rUA9#BBfH`;IgU4$bmUZFM zFk}(ZpHI6IQ3-|`+v@q4xQ#F?HJWqNF{DyiIwhprFLb#vrPb+AFzhimm_RwilpFsd zCzE0Ewd^Mot|jo8v{oc0RO}$86$CMf4eLPpZYfU?#?&IAq9>H7vcI@WCywe`aZ~DK zl2H-kF=g2dO7vLTn8eMf$du%Om{yP)Qzfv7C8+2L1Yk_)O%WiF1z=3*b;tq)vXUI7 zwaSiFpiCjCs9;QahcG6DF?A)niR#H@GtqFBbr6&bV{%2{lN~=i_X#1M8^=fn*I#Fd z>h6z+h=!;0I6(`*n66K}d$f~=+lZ$%vk|xzB&v%aXU23AV_F!-6of58-GtNJs%y@U zX>&8iv^b0j_Mvc_=l6E55Sr7=c@tdTHOOR7{>B+Bc$RM~_mBX)zcRfNxZW zm$|N2;r_%m;`%lI1ilU4HB4_?25CEs$@TZ`)3LrDa*<9y8N`^Df-$}Fx3QR>2ja~H zbUB~@vi|HFWZu+V7xaVw;@ZoAf2v4Q}JDKKQ%v>?r_ou&&-QqEUzIM;R z863cuhB0{tP8>=dIA09=+aAz%@;Dt+l*RObvYT*)CsP)TNz}yjv{bs+8t7q-xb9tZ zy$W}HMMr-4U!cb|?2o(d_VuJ@rtmM0M7L`=5Kj!?%*0_#VmXg#n1ay`cIv>)1kXo^ z=VwYkXbpEp!7f`$peHjfzti80zq#M jV*;kC#>R3{LB;A{gY^t0F~%_%00000NkvXXu0mjfw$K1^ literal 0 HcmV?d00001 diff --git a/docs/articles/b2d_volume_images/add_volume.png b/docs/articles/b2d_volume_images/add_volume.png new file mode 100644 index 0000000000000000000000000000000000000000..ea2d6f6e79f07aa6d7ae29641ca63f351b0ce556 GIT binary patch literal 30506 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 literal 0 HcmV?d00001 diff --git a/docs/articles/b2d_volume_images/gparted.png b/docs/articles/b2d_volume_images/gparted.png new file mode 100644 index 0000000000000000000000000000000000000000..1a50155ce2a8ee10f1b7ee0c3858e8c4a6e4b316 GIT binary patch literal 77989 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

JFFMQB(hd$qD=0E8 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 O00&!V8=AFe;=cgN+}$() literal 0 HcmV?d00001 diff --git a/docs/articles/b2d_volume_images/verify.png b/docs/articles/b2d_volume_images/verify.png new file mode 100644 index 0000000000000000000000000000000000000000..843fa126bf8e7faec4c42cebc3e621a21d7a4366 GIT binary patch literal 9581 zcmXw81z1!;*Ip#0Ejm@w6%dh1OE#mZcVU zfBe4hpXa&f&YXMZ%sc0K@0poG}D2U|=8&2D`Yp zKq8UH$Hxc+Vtadge0&^*LQPIiuCA_5O-*fVY%DD;&CJZKa~i)VWt^X%UszaJSy}n} z_itfg;m*zu6FzA(tLow5;n~^Q-rnBH$;sN+0&{mmC0)F|yYJxO z;N|IYxVJ-UxsjQX?);cO;VPv2m9~XOY0PoBSc>~4Z zX*D`TZ6D6J_AX(MiA7)>ni+DuwZ1qvGZ88V zm>;gmZyN~?jvZ>qj!r57CTy+m?CkDtPIna@9xm^mTz({fx^#drYDN*`;P&m`L!A<3WzsZiKR>m8PixI;mpE@o$`?z*q^TYj{c3wCgjOJ0O)V-JGr?q zF#mTXWpLk^lEVlLhi|R2spn?UOYOq9r`h%S!S!=-6Kq1NeB!TVI)1Wy0}ejgv7s=VB^Fi5T6D+B*ByOd7dQyj)z+a4m1HFIYIm@r+pNFs19eksdix(|T*U2 zACK-EXlBHIqi^ws2a2hGv#I>1`#aOij79kJVC`Jzr0;;~K7>9NGb!KUV<6d%9poc- z7dIK=d_AL$Zn}Pv{N8J8i$c<;;llU`f<@UQZeetxTc+Na+x^g7jmb!}Nse~ij_WIU zC};L;FU=0I^)|s|MnHOQB=FcYmsx;)?UsA znn=v#?inF!1!Dsfpk{7M7vY~Uits5|%^=*5)rQqdRKd z^q2EAzm>}TsrOz9R~mX{_H{@$}m zkP)FYZ0ehhn5JZ8xB6bU>4FP}c8U|`#iRz^rc1oPqW%d#GFh#3*JpS%ofk8&HU@d2 zIXG+V`7zqw0xRC^oQk=;U7-b|8_+9*38AM~7x~Qb&#P<|>6mL7rt7u)>F9;n7V7er zQoi8I^xHFi*Vn9xlb227lc4rBiTkxyMG>QaKzO~lf>_;mVGfsz-QD?9;z*Di<7s3~ z7m6yXJMH5uv6yT)w>>|u8GVzk+hS?AFmMxgfm}~DeSGoU`{ZDPkBSfW(GHDT?29u6 z9;UqrULnpmRKw2wpnm8VTsw;n(SV!}78zAZY|jmYsDCC(&l}m!s36OlTmFg(4>A=D zlj-5=+&f?9*h2SHTS{pDH;Mx~c0ldS8y!ssefP(Q3yM$P@e;_g9T%!*4aN@lk=L6z zksSE<^FT>UYhLzTUi&|n_w8)od|S41G=K^mU->IgveNp8Cqt6ELh?ld&%MuFtxPRB z6Xmv_#35Rru>0EV#T6F&G3k8)ZAoB{i`n$3T>*aT^G}wya~4Y#PihDuqfQ{L#rbpF z>d4C8WsMo(zd|3&jJ-eBBj=`e^#v{R7VBp}xX`E1-6f#>h)#DiIKIJXsj_~r7{wM6 zp(Gik!2X3F$T0Z!sTkKInWQaM(vWmlQ+_I4q#0Ccj)0ZwEv8Q{t7If+{(Y)>Z9iZa zkHHuk0e($$8@0R8Ffr(SO~ptXh zFuz7wR+r5XPea6j25+o~+%)GKg#-o9N1{a26$2EWy|im0*&cNMjepkGoEf<(wEi&H6NUm&!$7Kl%=QE8NT%lr3t_ zQE=}EWB-Hi0fA`sx0L=~^cDm7+s`(+nb>iU&#J!>1|BRT`nU2mU{WuX?C!B9-$U_l3(xN(WD0qC}R4o87d#ylG3n zdm5?B1_!bgI_twg#+){~WN=YUomg}5aBaNDKFEH_Nwsh?TI{pvT2tRaR{W;zt75Z0 zu0lXyP2Rh?E|COS2k$K<15bL|$NZfgE3J=(1q^aTe49Lx+*NL7Rx-2q`Gp>9aR?J% zBQ2a+YyUnRZx99e`8N6Gx!}%l@aI?IGd6|meqeq@38s6hp>Ndet{MHqLv!{hAh*+O zbbNEZT#4mbaoDZ$Ll;EYC)4{5n*@7ZUz^>Ak#+)fiF~zOa&an`1ObvX&CmqrWR!^Zy5VEahVNeYM3N z<8hiP??X zY}yD~3Ut8EdrM?4|NVUd&{$s!WE{2)#r)dmA)-_9Y9rp%V@3jx4?B|swi~=EcXiYP zM98;4m7PSAF#49qUVWt>9CTyMk%UT&HZ^J46n=DE z+Mq_1yJfm)CQ6UGElntzOTwu*A{6)QcAJ~7Tiv{Ze&d9wN`eEauOH}5Kl%sz%6<2D z&9RGg2M_z3f5;<8xk}?;+G=CJzTa&^ciAW-6l+AwqMu%hUge&jLJ^~ULzf>(|NFwm z6LqE(SUuagK*Yr8k((Vo9>*nB48oHa;OP8<=x#EIuzHXXiyQsK9~WQsIH$Ud;J5h+ z+ld|i^{^jFb~#LWy8-p`v}q~(%*{<^c*JHVx_sYRY1UnjnXE^!I7ca;e_2N+7m=`Q5!v?zDry zdnNhfA{==mB?UrLRKx-#?fApg&GxO;AYvAn)2ju2!+Y|c%WHm3W zLswGv`~6QwcK2`?GLCVoV(3PljjuD2UxgeD1+!P{|08TV|tcpGWY;Je0-H@Wlk## zkdA;yCFHS%WH=98o7>XWo*{sc8d1!NB$AhtIGaT`-~vWI!QquQLd%UGe-z&lkdKuW zKZ}9f><=w7R@9TpI5CVgV9^~;U(KynL$YZIce&x6At`Oce|+Cmd@%q3R6p4N=>eRz z;tece0U1y!ST@MK>lwY z*&MGMVlU%?RSGG_?N7hbyOwjuy}k{s5FbjNk($lgQeMfnf&Fj}k+@Uf=)3v$C^Nnz zN04nZvEFs=)O>||Qx2qJPf|T!vyXnRQ~#hYW0$!usA@$TaL!wMRf9-=kLNYD5; z2hFiF)2OkD`}XSt(&EpoM4s(vySyKBem^#}9jQnzVovpG6ae)UI17R+RNnsw@4sar z2lc=R^30VS!+RH0GB%XjHKQs2t$FHkOfG!Klfx@I%j2$+3YLBL_T<*&Ash})Sy9Nn zla)&UBxDAuQ&zY`yYnK{MTp55+fc$#AsK01-5|#Q4H0+`FoP-nEP0S275$rq5*Mz6 z#hzdQIUj}vzk@TnC_O%C$bQmlOMEHqB8NBmtmlP!_APAaYW1^NOC!wC(eFy=aCkNK zv{e~@{rs!0pZ2$ICfTP5KxC%-|aoYD#|8 z*ynBA+JiAlkF6}232|`DK`OZP6uhEGMHFAb2V)^ljA}K~nywN#b7uY5XzYUX)vRX^NBZE0i0UG{AJXrHwT#a+9+8o#Ho0v^Kk6IXjX}- z_Wz1_<-4%f=;1tuXgE*9Ilv*6RhD*4f2=YgM%j%_!v&kN;?YtsE zz{YN)7JMIw8MGS{GQm%MrY{m+G92AxJ&paHURq*}b?IcI10xU+sz*Bi4@^pP*zn${ zie47&M!=Tiyz2Aw6c~alV-Nz06Jwxtr^X*dqR(*64MeiB z*mbfoHZ4+u_l+#%0vRzkxD>7{LcjG)0!Y@?tOnj2ZGilEU}l_-%Uhb4_gSgtUJ@t3 z3FEr5A3J$w-3C!c0I9$drk?I^d+sO0=hTR*2i(UUP7P3h6W!mojIKeP4wW0%KHWTt zy0f$EmOLM&5wd?y(i3b5lwkA5RpF17*_RLvjIIVzW>0ZAns7RA;;_4#bvl}L`tw$= z&6n~QWJ9m>pNf2WgM!2^Xd$cjs;`QBEhXE?S%WC0iCA0p01fq?B5ND|WNE&ftY_}~ z{_Ny4*9miv7lRmmDuBoOy3%m*EJ|5=z&yTHf^`6UfDNE7UDHn`{Wugba)l>AQm$?i zXrcY2g_cz!^ktEb7c?jQ2^5w3c_wDVB@Cu6>O;jSe=71D#0fiT^1BurySmdhe*nAh zL*1u&&mIIA6pwkRH5P)yIl6XGWSy!X49_kO6p8+e?;l8ixjXkqU#aRmbPTK1{-r`vhL>ktOcp;be*@W8|$KXa9PdeUXdsNSjNeq&32E2^}V%{8Q>W z(!HruQ$l9{0~#GS=fNc&1M^zk8U^X3r~}=Cf+dCy_!3*E;HuYU8_F&7&y54$d`%V4 zhqn!+hg;|4dZT3z3@z9f|}kU$q=DK^pm=hVCHKjc1g<9&yDIVLu|dv@^0tP&AA^mQ>*E^msK`{2}r2T7wS z%fj>V)${e@(N1}`Vf$SJ3-ikJaX)U1>yK(8@VD#Fq7kr`x)^(%t9b@SzTa@dhvBe0 z7e{CM;s1DY;(2HN8?M;Bm^4}iLR*EwG=n@}X0m-tJ|AzU{#zaf3;dz9&H5YukHr75 z7KoqL=422}4A{TyBnvM~jjjs?jP+Is2{kc{!uC!!CiNK251yd~4tmA+5AJbloD`-pnSd%T-0_dJRSF}kOKY#3}Z ze0K$rlA%J^{;U+K@4~bUGQ`uDNpH286)S_KmHWIU0qgygospCbeE!q280Pwub*)We zwmf>hwwRW21+*aNt^(Z`YP(m4K%O~_U*5DLLHcgo68lGGzL*0%PJl%mEc@9)urJgi zqZ&-`t#QXD9o(|*1fHSZ-8mZW(G5gXK+}%sUZyLZ#@8wZo)*E;>)q_F_rPf51Lrdx2g877WvF_hWOOAhNHRF<02BXTgiL1#SaOiXuCmqNRl&Jf$cMJ z$aLjw>fqkJ&szr#qRpfA`7VZ2DVodLTw?Z0u`O?pl_ku6K%O^Bjn-(_X6vi}k9K$5 z>&`Z@c}xCo4~isQ=;!iQy>;=C7_Wg(Nfu)CuLWg9y8c&xTPyexYBuMx2i3%uO}Bn( z!w(hv_2Cv7fxH@ktYlupso}MTh69P1u5LRxHP$6Po6#3D@mAjplFmC`7 z=km2^rR+Ctcli0_+=rm!f`bwGx!c|qMMcHvTcVt{BuB&Zt%h1-A20MP6wH*Ide#G! zSQ=6DqT}I}m!@>e2x^)V#31x00x3CoPx|syX~$5-OB15x!^v89I(6B8FrYn>)6%RR zXu9~l)UwN+DFy%Hk_vkJY!sm%B~Wk_q~G5rA+(&xSgZzPMn?sm*tCIVSYuHU1y+93 z^U3EIWk#(^eEW?M;THJDk%aO2OqVsE`8CihRdrOUkT1CZR^h4^HuwAN0utice|xiB zu;PAk3#Y zQKNlu%m&6f0U6c81yy;r^XQaz@Xr;gg!#xEqGo*VdeL*yVZV2UqUG8^698Vqo8*0= zIt)_Lz#0#M^e(&%J+L5sy9#YOXwKbW<FrX9!d7a{W|^%a7K&l(|t-kWSq z7zx8kc&=d@2u^zXkb-v3*2oqMLN$>uffpTMghl?o9i!<9tgRvo*s~^svX2dP-7VY` z4GWo*MXeu#4O2#v)dIy{`QBXXN?}n8E6w-U4$&>O#*0xOx2e0GE6%YmA>jIltcwZG zlsPhuA2Tmj*$?A%STZ1-=8h-Zz#t0)a62O$7Kc&r7_SO)STTNf+Y{%p=x;Yje|bBE zx){=xY;0}yL2c|~v3t_D1^RS}?3!2ci)`QATsO;|lW54=T5avWqFDrTvO;=^`L8x66lYHe+S^AXd{uHyCh*@ z_UCh=i5BGN60u*g7o!2_>w`&PoyVK57I4-!fk?|W=)t?vf)^!t9BUM=cnq-s`4hr* z7uRiJ48S#rArkQJW|!qZi})=R6o-LD7~sQNvkIut7nj``@2}6U>cNSqju5MN3bU!iwroM z#Om|cN-{r`;7Y&HH=H(|#ClTQnU!>JJi*L>p8fRUxKLoUy_SRpok3=pljtTTsJ3ql z*tH*gG^0!2`Wy29%RTE)7B4O7G43GEXLtn&xtU01qEDg{xAkw;`#A7shlUgPgZO-# zygf^RcP5AZ#fA_W8e`B#ZBQ^@`{*)=#&Czy;MN7lZj=816ZrvI0wwu@3(-)^!8J|O zqL2g6qy}qHzM*^mWS&Vg1!_2-RRK4SG6@a*bahC534Ea};t=yoLzJhn%$J)SrW#$!-fan-dY0Af9LHZ@Uhc-F7ycA+z z>N4DwO?BaYR*k_$)`>iCqgD+m8od@U_^%rkLW@510 zoZnZxZ)Ythox>3nl$N|qlrk0bfG4RgS7e}>sPJxPJU5p9t)^$4ztf#cU;oOlbm&7| zz|K?}4pL_TS?@EW5_z&zT}>c)S!LtI87u?KftrdWL&R(!(kMck8s5Ec8bbfTmBcG~ z&fDLlg1Nl@$@K?EcZ#@ZF3+_Ce&K?10$E}BR=9IVb*AGLkdGXt}E4|T!!QZ%kPyh-@p6f z^iqUs8tLR^%hlBU=6nl|GO^7s;Z(x)jlv+dZoF{6k5l11tp+%~i`Yve zr`HDfB;uNYJ<9ATCQYBmerGW2QhCWZd&)3ACnrxFU88SRDX8$@wp{jB(3X%826A~_ zq(fBQ9Rin)3ajKM2u92GsLRuNV(#`5Y<;lUR|~HN$)R(Joei=Um=D8k^Zg_rM#-Um zs=zLF&FwH*UdKCYJ*kPWg{|?Dc?|DK@ed{?Y7w#PF-C9yu&ixbeF{@%N26b(#hT{l zS7PY#F3Y9$wKQ?<`b+hp2?bz*tHxmoA&+(&Et@({H}{p7f48<2w7cAMGcz(4ta$%g zt*B1fYr5g1bGiQ^a3DNM5TB;1?$0Hd=oYv8%mp#N+>ob$iiHQEge{rz4|l=rdF{-K zO89lKki4cHEtA=c*Qo+$>GKmqk-lD^(RYVJ0-Sc){h>kftS^bS@5rYKn4`=o50Qn? zT<}pVc(RD1S>5`mJ%aa^Un*)!r}byi@0;1F6%Xsl^1bxTvF%zyh=DJPE)x-2GU()K z4{7YDm{}T6<(mgh9H2n`>*D7YEt2scP=9|36UPKdF#`Np^ZXwXXTEzmJp5b}%$Uz?@g*?-jH&(V~66Xaz)ke$ZD47%rG?;%=F?a!LT_CLyQ&UfYBUGC>r^t^|74<|xZPN;Zi@5n zuXvsnclDW`L|1U3L5P~JxY^tRfRJ%juVF~0Hmac@jdg3coIQ2=#&WAhU;Kr?M#541 zb2vTjH`1)9s*Kv&BngFD!h3a}K265vux`wgV9p?gK0$_KdlO{$e8TI)+^p+HdL>9o z>;DjK_oG-gYCUME*lv;u-Z&$4?|=6K8-<+f&!E1iiO0a9c`uSJc)9jY#OEM^Mkx|S zgLe?3dn-<6x+|0!nV6X)Wijd?=8nNV1v8p$PJsM4{T+rw{9qEn_;-U?#98dqs|0%@mT-)(!S83>n7obt?_C7*yqx{T;LC?zdRmOfE@(aq4{`VnSQBGC1LfRzY{{UmQ Bt%U#p literal 0 HcmV?d00001 diff --git a/docs/articles/b2d_volume_resize.md b/docs/articles/b2d_volume_resize.md new file mode 100644 index 0000000000..a5bb82ed41 --- /dev/null +++ b/docs/articles/b2d_volume_resize.md @@ -0,0 +1,165 @@ + + +# Getting “no space left on device” errors with Boot2Docker? + +If you're using Boot2Docker with a large number of images, or the images you're +working with are very large, your pulls might start failing with "no space left +on device" errors when the Boot2Docker volume fills up. There are two solutions +you can try. + +## Solution 1: Add the `DiskImage` property in boot2docker profile + +The `boot2docker` command reads its configuration from the `$BOOT2DOCKER_PROFILE` if set, or `$BOOT2DOCKER_DIR/profile` or `$HOME/.boot2docker/profile` (on Windows this is `%USERPROFILE%/.boot2docker/profile`). + +1. View the existing configuration, use the `boot2docker config` command. + + $ boot2docker config + # boot2docker profile filename: /Users/mary/.boot2docker/profile + Init = false + Verbose = false + Driver = "virtualbox" + Clobber = true + ForceUpgradeDownload = false + SSH = "ssh" + SSHGen = "ssh-keygen" + SSHKey = "/Users/mary/.ssh/id_boot2docker" + VM = "boot2docker-vm" + Dir = "/Users/mary/.boot2docker" + ISOURL = "https://api.github.com/repos/boot2docker/boot2docker/releases" + ISO = "/Users/mary/.boot2docker/boot2docker.iso" + DiskSize = 20000 + Memory = 2048 + CPUs = 8 + SSHPort = 2022 + DockerPort = 0 + HostIP = "192.168.59.3" + DHCPIP = "192.168.59.99" + NetMask = [255, 255, 255, 0] + LowerIP = "192.168.59.103" + UpperIP = "192.168.59.254" + DHCPEnabled = true + Serial = false + SerialFile = "/Users/mary/.boot2docker/boot2docker-vm.sock" + Waittime = 300 + Retries = 75 + + The configuration shows you where `boot2docker` is looking for the `profile` file. It also output the settings that are in use. + + +2. Initialise a default file to customize using `boot2docker config > ~/.boot2docker/profile` command. + +3. Add the following lines to `$HOME/.boot2docker/profile`: + + # Disk image size in MB + DiskSize = 50000 + +4. Run the following sequence of commands to restart Boot2Docker with the new settings. + + $ boot2docker poweroff + $ boot2docker destroy + $ boot2docker init + $ boot2docker up + +## Solution 2: Increase the size of boot2docker volume + +This solution increases the volume size by first cloning it, then resizing it +using a disk partitioning tool. We recommend +[GParted](http://gparted.sourceforge.net/download.php/index.php). The tool comes +as a bootable ISO, is a free download, and works well with VirtualBox. + +1. Stop Boot2Docker + + Issue the command to stop the Boot2Docker VM on the command line: + + $ boot2docker stop + +2. Clone the VMDK image to a VDI image + + Boot2Docker ships with a VMDK image, which can't be resized by VirtualBox's + native tools. We will instead create a VDI volume and clone the VMDK volume to + it. + +3. Using the command line VirtualBox tools, clone the VMDK image to a VDI image: + + $ vboxmanage clonehd /full/path/to/boot2docker-hd.vmdk /full/path/to/.vdi --format VDI --variant Standard + +4. Resize the VDI volume + + Choose a size that will be appropriate for your needs. If you're spinning up a + lot of containers, or your containers are particularly large, larger will be + better: + + $ vboxmanage modifyhd /full/path/to/.vdi --resize + +5. Download a disk partitioning tool ISO + + To resize the volume, we'll use [GParted](http://gparted.sourceforge.net/download.php/). + Once you've downloaded the tool, add the ISO to the Boot2Docker VM IDE bus. + You might need to create the bus before you can add the ISO. + + > **Note:** + > It's important that you choose a partitioning tool that is available as an ISO so + > that the Boot2Docker VM can be booted with it. + + + + + + + + +


+ +6. Add the new VDI image + + In the settings for the Boot2Docker image in VirtualBox, remove the VMDK image + from the SATA controller and add the VDI image. + + + +7. Verify the boot order + + In the **System** settings for the Boot2Docker VM, make sure that **CD/DVD** is + at the top of the **Boot Order** list. + + + +8. Boot to the disk partitioning ISO + + Manually start the Boot2Docker VM in VirtualBox, and the disk partitioning ISO + should start up. Using GParted, choose the **GParted Live (default settings)** + option. Choose the default keyboard, language, and XWindows settings, and the + GParted tool will start up and display the VDI volume you created. Right click + on the VDI and choose **Resize/Move**. + + + +9. Drag the slider representing the volume to the maximum available size. + +10. Click **Resize/Move** followed by **Apply**. + + + +11. Quit GParted and shut down the VM. + +12. Remove the GParted ISO from the IDE controller for the Boot2Docker VM in +VirtualBox. + +13. Start the Boot2Docker VM + + Fire up the Boot2Docker VM manually in VirtualBox. The VM should log in + automatically, but if it doesn't, the credentials are `docker/tcuser`. Using + the `df -h` command, verify that your changes took effect. + + + +You're done! diff --git a/docs/articles/baseimages.md b/docs/articles/baseimages.md new file mode 100644 index 0000000000..99cfc94744 --- /dev/null +++ b/docs/articles/baseimages.md @@ -0,0 +1,70 @@ + + +# Create a base image + +So you want to create your own [*Base Image*](../reference/glossary.md#base-image)? Great! + +The specific process will depend heavily on the Linux distribution you +want to package. We have some examples below, and you are encouraged to +submit pull requests to contribute new ones. + +## Create a full image using tar + +In general, you'll want to start with a working machine that is running +the distribution you'd like to package as a base image, though that is +not required for some tools like Debian's +[Debootstrap](https://wiki.debian.org/Debootstrap), which you can also +use to build Ubuntu images. + +It can be as simple as this to create an Ubuntu base image: + + $ sudo debootstrap raring raring > /dev/null + $ sudo tar -C raring -c . | docker import - raring + a29c15f1bf7a + $ docker run raring cat /etc/lsb-release + DISTRIB_ID=Ubuntu + DISTRIB_RELEASE=13.04 + DISTRIB_CODENAME=raring + DISTRIB_DESCRIPTION="Ubuntu 13.04" + +There are more example scripts for creating base images in the Docker +GitHub Repo: + + - [BusyBox](https://github.com/docker/docker/blob/master/contrib/mkimage-busybox.sh) + - CentOS / Scientific Linux CERN (SLC) [on Debian/Ubuntu]( + https://github.com/docker/docker/blob/master/contrib/mkimage-rinse.sh) or + [on CentOS/RHEL/SLC/etc.]( + https://github.com/docker/docker/blob/master/contrib/mkimage-yum.sh) + - [Debian / Ubuntu]( + https://github.com/docker/docker/blob/master/contrib/mkimage-debootstrap.sh) + +## Creating a simple base image using scratch + +You can use Docker's reserved, minimal image, `scratch`, as a starting point for building containers. Using the `scratch` "image" signals to the build process that you want the next command in the `Dockerfile` to be the first filesystem layer in your image. + +While `scratch` appears in Docker's repository on the hub, you can't pull it, run it, or tag any image with the name `scratch`. Instead, you can refer to it in your `Dockerfile`. For example, to create a minimal container using `scratch`: + + FROM scratch + ADD hello / + CMD ["/hello"] + +This example creates the hello-world image used in the tutorials. +If you want to test it out, you can clone [the image repo](https://github.com/docker-library/hello-world) + + +## More resources + +There are lots more resources available to help you write your 'Dockerfile`. + +* There's a [complete guide to all the instructions](../reference/builder.md) available for use in a `Dockerfile` in the reference section. +* To help you write a clear, readable, maintainable `Dockerfile`, we've also +written a [`Dockerfile` Best Practices guide](dockerfile_best-practices.md). +* If your goal is to create a new Official Repository, be sure to read up on Docker's [Official Repositories](https://docs.docker.com/docker-hub/official_repos/). diff --git a/docs/articles/certificates.md b/docs/articles/certificates.md new file mode 100644 index 0000000000..84235f109c --- /dev/null +++ b/docs/articles/certificates.md @@ -0,0 +1,17 @@ + + +# Using certificates for repository client verification + +The original content was deprecated. For information about configuring +certificates, see [deploying a registry +server](http://docs.docker.com/registry/deploying). To reach an older version +of this content, refer to an older version of the documentation. diff --git a/docs/articles/cfengine_process_management.md b/docs/articles/cfengine_process_management.md new file mode 100644 index 0000000000..b2e5737307 --- /dev/null +++ b/docs/articles/cfengine_process_management.md @@ -0,0 +1,149 @@ + + +# Process management with CFEngine + +Create Docker containers with managed processes. + +Docker monitors one process in each running container and the container +lives or dies with that process. By introducing CFEngine inside Docker +containers, we can alleviate a few of the issues that may arise: + + - It is possible to easily start multiple processes within a + container, all of which will be managed automatically, with the + normal `docker run` command. + - If a managed process dies or crashes, CFEngine will start it again + within 1 minute. + - The container itself will live as long as the CFEngine scheduling + daemon (cf-execd) lives. With CFEngine, we are able to decouple the + life of the container from the uptime of the service it provides. + +## How it works + +CFEngine, together with the cfe-docker integration policies, are +installed as part of the Dockerfile. This builds CFEngine into our +Docker image. + +The Dockerfile's `ENTRYPOINT` takes an arbitrary +amount of commands (with any desired arguments) as parameters. When we +run the Docker container these parameters get written to CFEngine +policies and CFEngine takes over to ensure that the desired processes +are running in the container. + +CFEngine scans the process table for the `basename` of the commands given +to the `ENTRYPOINT` and runs the command to start the process if the `basename` +is not found. For example, if we start the container with +`docker run "/path/to/my/application parameters"`, CFEngine will look for a +process named `application` and run the command. If an entry for `application` +is not found in the process table at any point in time, CFEngine will execute +`/path/to/my/application parameters` to start the application once again. The +check on the process table happens every minute. + +Note that it is therefore important that the command to start your +application leaves a process with the basename of the command. This can +be made more flexible by making some minor adjustments to the CFEngine +policies, if desired. + +## Usage + +This example assumes you have Docker installed and working. We will +install and manage `apache2` and `sshd` +in a single container. + +There are three steps: + +1. Install CFEngine into the container. +2. Copy the CFEngine Docker process management policy into the + containerized CFEngine installation. +3. Start your application processes as part of the `docker run` command. + +### Building the image + +The first two steps can be done as part of a Dockerfile, as follows. + + FROM ubuntu + MAINTAINER Eystein Måløy Stenberg + + RUN apt-get update && apt-get install -y wget lsb-release unzip ca-certificates + + # install latest CFEngine + RUN wget -qO- http://cfengine.com/pub/gpg.key | apt-key add - + RUN echo "deb http://cfengine.com/pub/apt $(lsb_release -cs) main" > /etc/apt/sources.list.d/cfengine-community.list + RUN apt-get update && apt-get install -y cfengine-community + + # install cfe-docker process management policy + RUN wget https://github.com/estenberg/cfe-docker/archive/master.zip -P /tmp/ && unzip /tmp/master.zip -d /tmp/ + RUN cp /tmp/cfe-docker-master/cfengine/bin/* /var/cfengine/bin/ + RUN cp /tmp/cfe-docker-master/cfengine/inputs/* /var/cfengine/inputs/ + RUN rm -rf /tmp/cfe-docker-master /tmp/master.zip + + # apache2 and openssh are just for testing purposes, install your own apps here + RUN apt-get update && apt-get install -y openssh-server apache2 + RUN mkdir -p /var/run/sshd + RUN echo "root:password" | chpasswd # need a password for ssh + + ENTRYPOINT ["/var/cfengine/bin/docker_processes_run.sh"] + +By saving this file as Dockerfile to a working directory, you can then build +your image with the docker build command, e.g., +`docker build -t managed_image`. + +### Testing the container + +Start the container with `apache2` and `sshd` running and managed, forwarding +a port to our SSH instance: + + $ docker run -p 127.0.0.1:222:22 -d managed_image "/usr/sbin/sshd" "/etc/init.d/apache2 start" + +We now clearly see one of the benefits of the cfe-docker integration: it +allows to start several processes as part of a normal `docker run` command. + +We can now log in to our new container and see that both `apache2` and `sshd` +are running. We have set the root password to "password" in the Dockerfile +above and can use that to log in with ssh: + + ssh -p222 root@127.0.0.1 + + ps -ef + UID PID PPID C STIME TTY TIME CMD + root 1 0 0 07:48 ? 00:00:00 /bin/bash /var/cfengine/bin/docker_processes_run.sh /usr/sbin/sshd /etc/init.d/apache2 start + root 18 1 0 07:48 ? 00:00:00 /var/cfengine/bin/cf-execd -F + root 20 1 0 07:48 ? 00:00:00 /usr/sbin/sshd + root 32 1 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + www-data 34 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + www-data 35 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + www-data 36 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + root 93 20 0 07:48 ? 00:00:00 sshd: root@pts/0 + root 105 93 0 07:48 pts/0 00:00:00 -bash + root 112 105 0 07:49 pts/0 00:00:00 ps -ef + +If we stop apache2, it will be started again within a minute by +CFEngine. + + service apache2 status + Apache2 is running (pid 32). + service apache2 stop + * Stopping web server apache2 ... waiting [ OK ] + service apache2 status + Apache2 is NOT running. + # ... wait up to 1 minute... + service apache2 status + Apache2 is running (pid 173). + +## Adapting to your applications + +To make sure your applications get managed in the same manner, there are +just two things you need to adjust from the above example: + + - In the Dockerfile used above, install your applications instead of + `apache2` and `sshd`. + - When you start the container with `docker run`, + specify the command line arguments to your applications rather than + `apache2` and `sshd`. diff --git a/docs/articles/chef.md b/docs/articles/chef.md new file mode 100644 index 0000000000..3a23753258 --- /dev/null +++ b/docs/articles/chef.md @@ -0,0 +1,80 @@ + + +# Using Chef + +> **Note**: +> Please note this is a community contributed installation path. The only +> `official` installation is using the +> [*Ubuntu*](../installation/ubuntulinux.md) installation +> path. This version may sometimes be out of date. + +## Requirements + +To use this guide you'll need a working installation of +[Chef](http://www.getchef.com/). This cookbook supports a variety of +operating systems. + +## Installation + +The cookbook is available on the [Chef Community +Site](http://community.opscode.com/cookbooks/docker) and can be +installed using your favorite cookbook dependency manager. + +The source can be found on +[GitHub](https://github.com/bflad/chef-docker). + +## Usage + +The cookbook provides recipes for installing Docker, configuring init +for Docker, and resources for managing images and containers. It +supports almost all Docker functionality. + +### Installation + + include_recipe 'docker' + +### Images + +The next step is to pull a Docker image. For this, we have a resource: + + docker_image 'samalba/docker-registry' + +This is equivalent to running: + + $ docker pull samalba/docker-registry + +There are attributes available to control how long the cookbook will +allow for downloading (5 minute default). + +To remove images you no longer need: + + docker_image 'samalba/docker-registry' do + action :remove + end + +### Containers + +Now you have an image where you can run commands within a container +managed by Docker. + + docker_container 'samalba/docker-registry' do + detach true + port '5000:5000' + env 'SETTINGS_FLAVOR=local' + volume '/mnt/docker:/docker-storage' + end + +This is equivalent to running the following command, but under upstart: + + $ docker run --detach=true --publish='5000:5000' --env='SETTINGS_FLAVOR=local' --volume='/mnt/docker:/docker-storage' samalba/docker-registry + +The resources will accept a single string or an array of values for any +Docker flags that allow multiple values. diff --git a/docs/articles/configuring.md b/docs/articles/configuring.md new file mode 100644 index 0000000000..0c18a4fa32 --- /dev/null +++ b/docs/articles/configuring.md @@ -0,0 +1,243 @@ + + +# Configuring and running Docker on various distributions + +After successfully installing Docker, the `docker` daemon runs with its default +configuration. + +In a production environment, system administrators typically configure the +`docker` daemon to start and stop according to an organization's requirements. In most +cases, the system administrator configures a process manager such as `SysVinit`, `Upstart`, +or `systemd` to manage the `docker` daemon's start and stop. + +### Running the docker daemon directly + +The `docker` daemon can be run directly using the `docker daemon` command. By default it listens on +the Unix socket `unix:///var/run/docker.sock` + + $ docker daemon + + INFO[0000] +job init_networkdriver() + INFO[0000] +job serveapi(unix:///var/run/docker.sock) + INFO[0000] Listening for HTTP on unix (/var/run/docker.sock) + ... + ... + +### Configuring the docker daemon directly + +If you're running the `docker` daemon directly by running `docker daemon` instead +of using a process manager, you can append the configuration options to the `docker` run +command directly. Other options can be passed to the `docker` daemon to configure it. + +Some of the daemon's options are: + +| Flag | Description | +|-----------------------|-----------------------------------------------------------| +| `-D`, `--debug=false` | Enable or disable debug mode. By default, this is false. | +| `-H`,`--host=[]` | Daemon socket(s) to connect to. | +| `--tls=false` | Enable or disable TLS. By default, this is false. | + + +Here is a an example of running the `docker` daemon with configuration options: + + $ docker daemon -D --tls=true --tlscert=/var/docker/server.pem --tlskey=/var/docker/serverkey.pem -H tcp://192.168.59.3:2376 + +These options : + +- Enable `-D` (debug) mode +- Set `tls` to true with the server certificate and key specified using `--tlscert` and `--tlskey` respectively +- Listen for connections on `tcp://192.168.59.3:2376` + +The command line reference has the [complete list of daemon flags](../reference/commandline/daemon.md) +with explanations. + +## Ubuntu + +As of `14.04`, Ubuntu uses Upstart as a process manager. By default, Upstart jobs +are located in `/etc/init` and the `docker` Upstart job can be found at `/etc/init/docker.conf`. + +After successfully [installing Docker for Ubuntu](../installation/ubuntulinux.md), +you can check the running status using Upstart in this way: + + $ sudo status docker + + docker start/running, process 989 + +### Running Docker + +You can start/stop/restart the `docker` daemon using + + $ sudo start docker + + $ sudo stop docker + + $ sudo restart docker + + +### Configuring Docker + +You configure the `docker` daemon in the `/etc/default/docker` file on your +system. You do this by specifying values in a `DOCKER_OPTS` variable. + +To configure Docker options: + +1. Log into your host as a user with `sudo` or `root` privileges. + +2. If you don't have one, create the `/etc/default/docker` file on your host. Depending on how +you installed Docker, you may already have this file. + +3. Open the file with your favorite editor. + + ``` + $ sudo vi /etc/default/docker + ``` + +4. Add a `DOCKER_OPTS` variable with the following options. These options are appended to the +`docker` daemon's run command. + +``` + DOCKER_OPTS="-D --tls=true --tlscert=/var/docker/server.pem --tlskey=/var/docker/serverkey.pem -H tcp://192.168.59.3:2376" +``` + +These options : + +- Enable `-D` (debug) mode +- Set `tls` to true with the server certificate and key specified using `--tlscert` and `--tlskey` respectively +- Listen for connections on `tcp://192.168.59.3:2376` + +The command line reference has the [complete list of daemon flags](../reference/commandline/daemon.md) +with explanations. + + +5. Save and close the file. + +6. Restart the `docker` daemon. + + ``` + $ sudo restart docker + ``` + +7. Verify that the `docker` daemon is running as specified with the `ps` command. + + ``` + $ ps aux | grep docker | grep -v grep + ``` + +### Logs + +By default logs for Upstart jobs are located in `/var/log/upstart` and the logs for `docker` daemon +can be located at `/var/log/upstart/docker.log` + + $ tail -f /var/log/upstart/docker.log + INFO[0000] Loading containers: done. + INFO[0000] docker daemon: 1.6.0 4749651; execdriver: native-0.2; graphdriver: aufs + INFO[0000] +job acceptconnections() + INFO[0000] -job acceptconnections() = OK (0) + INFO[0000] Daemon has completed initialization + + +## CentOS / Red Hat Enterprise Linux / Fedora + +As of `7.x`, CentOS and RHEL use `systemd` as the process manager. As of `21`, Fedora uses +`systemd` as its process manager. + +After successfully installing Docker for [CentOS](../installation/centos.md)/[Red Hat Enterprise Linux](../installation/rhel.md)/[Fedora](../installation/fedora.md), you can check the running status in this way: + + $ sudo systemctl status docker + +### Running Docker + +You can start/stop/restart the `docker` daemon using + + $ sudo systemctl start docker + + $ sudo systemctl stop docker + + $ sudo systemctl restart docker + +If you want Docker to start at boot, you should also: + + $ sudo systemctl enable docker + +### Configuring Docker + +You configure the `docker` daemon in the `/etc/sysconfig/docker` file on your +host. You do this by specifying values in a variable. For CentOS 7.x and RHEL 7.x, the name +of the variable is `OPTIONS` and for CentOS 6.x and RHEL 6.x, the name of the variable is +`other_args`. For this section, we will use CentOS 7.x as an example to configure the `docker` +daemon. + +By default, systemd services are located either in `/etc/systemd/service`, `/lib/systemd/system` +or `/usr/lib/systemd/system`. The `docker.service` file can be found in either of these three +directories depending on your host. + +To configure Docker options: + +1. Log into your host as a user with `sudo` or `root` privileges. + +2. If you don't have one, create the `/etc/sysconfig/docker` file on your host. Depending on how +you installed Docker, you may already have this file. + +3. Open the file with your favorite editor. + + ``` + $ sudo vi /etc/sysconfig/docker + ``` + +4. Add a `OPTIONS` variable with the following options. These options are appended to the +command that starts the `docker` daemon. + +``` + OPTIONS="-D --tls=true --tlscert=/var/docker/server.pem --tlskey=/var/docker/serverkey.pem -H tcp://192.168.59.3:2376" +``` + +These options : + +- Enable `-D` (debug) mode +- Set `tls` to true with the server certificate and key specified using `--tlscert` and `--tlskey` respectively +- Listen for connections on `tcp://192.168.59.3:2376` + +The command line reference has the [complete list of daemon flags](../reference/commandline/daemon.md) +with explanations. + +5. Save and close the file. + +6. Restart the `docker` daemon. + + ``` + $ sudo systemctl restart docker + ``` + +7. Verify that the `docker` daemon is running as specified with the `ps` command. + + ``` + $ ps aux | grep docker | grep -v grep + ``` + +### Logs + +systemd has its own logging system called the journal. The logs for the `docker` daemon can +be viewed using `journalctl -u docker` + + $ sudo journalctl -u docker + May 06 00:22:05 localhost.localdomain systemd[1]: Starting Docker Application Container Engine... + May 06 00:22:05 localhost.localdomain docker[2495]: time="2015-05-06T00:22:05Z" level="info" msg="+job serveapi(unix:///var/run/docker.sock)" + May 06 00:22:05 localhost.localdomain docker[2495]: time="2015-05-06T00:22:05Z" level="info" msg="Listening for HTTP on unix (/var/run/docker.sock)" + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="+job init_networkdriver()" + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="-job init_networkdriver() = OK (0)" + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="Loading containers: start." + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="Loading containers: done." + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="docker daemon: 1.5.0-dev fc0329b/1.5.0; execdriver: native-0.2; graphdriver: devicemapper" + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="+job acceptconnections()" + May 06 00:22:06 localhost.localdomain docker[2495]: time="2015-05-06T00:22:06Z" level="info" msg="-job acceptconnections() = OK (0)" + +_Note: Using and configuring journal is an advanced topic and is beyond the scope of this article._ diff --git a/docs/articles/dockerfile_best-practices.md b/docs/articles/dockerfile_best-practices.md new file mode 100644 index 0000000000..ea15a14635 --- /dev/null +++ b/docs/articles/dockerfile_best-practices.md @@ -0,0 +1,495 @@ + + +# Best practices for writing Dockerfiles + +## Overview + +Docker can build images automatically by reading the instructions from a +`Dockerfile`, a text file that contains all the commands, in order, needed to +build a given image. `Dockerfile`s adhere to a specific format and use a +specific set of instructions. You can learn the basics on the +[Dockerfile Reference](../reference/builder.md) page. If +you’re new to writing `Dockerfile`s, you should start there. + +This document covers the best practices and methods recommended by Docker, +Inc. and the Docker community for creating easy-to-use, effective +`Dockerfile`s. We strongly suggest you follow these recommendations (in fact, +if you’re creating an Official Image, you *must* adhere to these practices). + +You can see many of these practices and recommendations in action in the [buildpack-deps `Dockerfile`](https://github.com/docker-library/buildpack-deps/blob/master/jessie/Dockerfile). + +> Note: for more detailed explanations of any of the Dockerfile commands +>mentioned here, visit the [Dockerfile Reference](../reference/builder.md) page. + +## General guidelines and recommendations + +### Containers should be ephemeral + +The container produced by the image your `Dockerfile` defines should be as +ephemeral as possible. By “ephemeral,” we mean that it can be stopped and +destroyed and a new one built and put in place with an absolute minimum of +set-up and configuration. + +### Use a .dockerignore file + +In most cases, it's best to put each Dockerfile in an empty directory. Then, +add to that directory only the files needed for building the Dockerfile. To +increase the build's performance, you can exclude files and directories by +adding a `.dockerignore` file to that directory as well. This file supports +exclusion patterns similar to `.gitignore` files. For information on creating one, +see the [.dockerignore file](../reference/builder.md#dockerignore-file). + +### Avoid installing unnecessary packages + +In order to reduce complexity, dependencies, file sizes, and build times, you +should avoid installing extra or unnecessary packages just because they +might be “nice to have.” For example, you don’t need to include a text editor +in a database image. + +### Run only one process per container + +In almost all cases, you should only run a single process in a single +container. Decoupling applications into multiple containers makes it much +easier to scale horizontally and reuse containers. If that service depends on +another service, make use of [container linking](../userguide/networking/default_network/dockerlinks.md). + +### Minimize the number of layers + +You need to find the balance between readability (and thus long-term +maintainability) of the `Dockerfile` and minimizing the number of layers it +uses. Be strategic and cautious about the number of layers you use. + +### Sort multi-line arguments + +Whenever possible, ease later changes by sorting multi-line arguments +alphanumerically. This will help you avoid duplication of packages and make the +list much easier to update. This also makes PRs a lot easier to read and +review. Adding a space before a backslash (`\`) helps as well. + +Here’s an example from the [`buildpack-deps` image](https://github.com/docker-library/buildpack-deps): + + RUN apt-get update && apt-get install -y \ + bzr \ + cvs \ + git \ + mercurial \ + subversion + +### Build cache + +During the process of building an image Docker will step through the +instructions in your `Dockerfile` executing each in the order specified. +As each instruction is examined Docker will look for an existing image in its +cache that it can reuse, rather than creating a new (duplicate) image. +If you do not want to use the cache at all you can use the ` --no-cache=true` +option on the `docker build` command. + +However, if you do let Docker use its cache then it is very important to +understand when it will, and will not, find a matching image. The basic rules +that Docker will follow are outlined below: + +* Starting with a base image that is already in the cache, the next +instruction is compared against all child images derived from that base +image to see if one of them was built using the exact same instruction. If +not, the cache is invalidated. + +* In most cases simply comparing the instruction in the `Dockerfile` with one +of the child images is sufficient. However, certain instructions require +a little more examination and explanation. + +* For the `ADD` and `COPY` instructions, the contents of the file(s) +in the image are examined and a checksum is calculated for each file. +The last-modified and last-accessed times of the file(s) are not considered in +these checksums. During the cache lookup, the checksum is compared against the +checksum in the existing images. If anything has changed in the file(s), such +as the contents and metadata, then the cache is invalidated. + +* Aside from the `ADD` and `COPY` commands cache checking will not look at the +files in the container to determine a cache match. For example, when processing +a `RUN apt-get -y update` command the files updated in the container +will not be examined to determine if a cache hit exists. In that case just +the command string itself will be used to find a match. + +Once the cache is invalidated, all subsequent `Dockerfile` commands will +generate new images and the cache will not be used. + +## The Dockerfile instructions + +Below you'll find recommendations for the best way to write the +various instructions available for use in a `Dockerfile`. + +### FROM + +[Dockerfile reference for the FROM instruction](../reference/builder.md#from) + +Whenever possible, use current Official Repositories as the basis for your +image. We recommend the [Debian image](https://registry.hub.docker.com/_/debian/) +since it’s very tightly controlled and kept extremely minimal (currently under +100 mb), while still being a full distribution. + +### RUN + +[Dockerfile reference for the RUN instruction](../reference/builder.md#run) + +As always, to make your `Dockerfile` more readable, understandable, and +maintainable, split long or complex `RUN` statements on multiple lines separated +with backslashes. + +### apt-get + +Probably the most common use-case for `RUN` is an application of `apt-get`. The +`RUN apt-get` command, because it installs packages, has several gotchas to look +out for. + +You should avoid `RUN apt-get upgrade` or `dist-upgrade`, as many of the +“essential” packages from the base images won't upgrade inside an unprivileged +container. If a package contained in the base image is out-of-date, you should +contact its maintainers. +If you know there’s a particular package, `foo`, that needs to be updated, use +`apt-get install -y foo` to update automatically. + +Always combine `RUN apt-get update` with `apt-get install` in the same `RUN` +statement, for example: + + RUN apt-get update && apt-get install -y \ + package-bar \ + package-baz \ + package-foo + + +Using `apt-get update` alone in a `RUN` statement causes caching issues and +subsequent `apt-get install` instructions fail. +For example, say you have a Dockerfile: + + FROM ubuntu:14.04 + RUN apt-get update + RUN apt-get install -y curl + +After building the image, all layers are in the Docker cache. Suppose you later +modify `apt-get install` by adding extra package: + + FROM ubuntu:14.04 + RUN apt-get update + RUN apt-get install -y curl nginx + +Docker sees the initial and modified instructions as identical and reuses the +cache from previous steps. As a result the `apt-get update` is *NOT* executed +because the build uses the cached version. Because the `apt-get update` is not +run, your build can potentially get an outdated version of the `curl` and `nginx` +packages. + +Using `RUN apt-get update && apt-get install -y` ensures your Dockerfile +installs the latest package versions with no further coding or manual +intervention. This technique is known as "cache busting". You can also achieve +cache-busting by specifying a package version. This is known as version pinning, +for example: + + RUN apt-get update && apt-get install -y \ + package-bar \ + package-baz \ + package-foo=1.3.* + +Version pinning forces the build to retrieve a particular version regardless of +what’s in the cache. This technique can also reduce failures due to unanticipated changes +in required packages. + +Below is a well-formed `RUN` instruction that demonstrates all the `apt-get` +recommendations. + + RUN apt-get update && apt-get install -y \ + aufs-tools \ + automake \ + build-essential \ + curl \ + dpkg-sig \ + libcap-dev \ + libsqlite3-dev \ + lxc=1.0* \ + mercurial \ + reprepro \ + ruby1.9.1 \ + ruby1.9.1-dev \ + s3cmd=1.1.* \ + && apt-get clean \ + && rm -rf /var/lib/apt/lists/* + +The `s3cmd` instructions specifies a version `1.1.0*`. If the image previously +used an older version, specifying the new one causes a cache bust of `apt-get +update` and ensure the installation of the new version. Listing packages on +each line can also prevent mistakes in package duplication. + +In addition, cleaning up the apt cache and removing `/var/lib/apt/lists` helps +keep the image size down. Since the `RUN` statement starts with +`apt-get update`, the package cache will always be refreshed prior to +`apt-get install`. + +### CMD + +[Dockerfile reference for the CMD instruction](../reference/builder.md#cmd) + +The `CMD` instruction should be used to run the software contained by your +image, along with any arguments. `CMD` should almost always be used in the +form of `CMD [“executable”, “param1”, “param2”…]`. Thus, if the image is for a +service (Apache, Rails, etc.), you would run something like +`CMD ["apache2","-DFOREGROUND"]`. Indeed, this form of the instruction is +recommended for any service-based image. + +In most other cases, `CMD` should be given an interactive shell (bash, python, +perl, etc), for example, `CMD ["perl", "-de0"]`, `CMD ["python"]`, or +`CMD [“php”, “-a”]`. Using this form means that when you execute something like +`docker run -it python`, you’ll get dropped into a usable shell, ready to go. +`CMD` should rarely be used in the manner of `CMD [“param”, “param”]` in +conjunction with [`ENTRYPOINT`](../reference/builder.md#entrypoint), unless +you and your expected users are already quite familiar with how `ENTRYPOINT` +works. + +### EXPOSE + +[Dockerfile reference for the EXPOSE instruction](../reference/builder.md#expose) + +The `EXPOSE` instruction indicates the ports on which a container will listen +for connections. Consequently, you should use the common, traditional port for +your application. For example, an image containing the Apache web server would +use `EXPOSE 80`, while an image containing MongoDB would use `EXPOSE 27017` and +so on. + +For external access, your users can execute `docker run` with a flag indicating +how to map the specified port to the port of their choice. +For container linking, Docker provides environment variables for the path from +the recipient container back to the source (ie, `MYSQL_PORT_3306_TCP`). + +### ENV + +[Dockerfile reference for the ENV instruction](../reference/builder.md#env) + +In order to make new software easier to run, you can use `ENV` to update the +`PATH` environment variable for the software your container installs. For +example, `ENV PATH /usr/local/nginx/bin:$PATH` will ensure that `CMD [“nginx”]` +just works. + +The `ENV` instruction is also useful for providing required environment +variables specific to services you wish to containerize, such as Postgres’s +`PGDATA`. + +Lastly, `ENV` can also be used to set commonly used version numbers so that +version bumps are easier to maintain, as seen in the following example: + + ENV PG_MAJOR 9.3 + ENV PG_VERSION 9.3.4 + RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && … + ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH + +Similar to having constant variables in a program (as opposed to hard-coding +values), this approach lets you change a single `ENV` instruction to +auto-magically bump the version of the software in your container. + +### ADD or COPY + +[Dockerfile reference for the ADD instruction](../reference/builder.md#add)
+[Dockerfile reference for the COPY instruction](../reference/builder.md#copy) + +Although `ADD` and `COPY` are functionally similar, generally speaking, `COPY` +is preferred. That’s because it’s more transparent than `ADD`. `COPY` only +supports the basic copying of local files into the container, while `ADD` has +some features (like local-only tar extraction and remote URL support) that are +not immediately obvious. Consequently, the best use for `ADD` is local tar file +auto-extraction into the image, as in `ADD rootfs.tar.xz /`. + +If you have multiple `Dockerfile` steps that use different files from your +context, `COPY` them individually, rather than all at once. This will ensure that +each step's build cache is only invalidated (forcing the step to be re-run) if the +specifically required files change. + +For example: + + COPY requirements.txt /tmp/ + RUN pip install /tmp/requirements.txt + COPY . /tmp/ + +Results in fewer cache invalidations for the `RUN` step, than if you put the +`COPY . /tmp/` before it. + +Because image size matters, using `ADD` to fetch packages from remote URLs is +strongly discouraged; you should use `curl` or `wget` instead. That way you can +delete the files you no longer need after they've been extracted and you won't +have to add another layer in your image. For example, you should avoid doing +things like: + + ADD http://example.com/big.tar.xz /usr/src/things/ + RUN tar -xJf /usr/src/things/big.tar.xz -C /usr/src/things + RUN make -C /usr/src/things all + +And instead, do something like: + + RUN mkdir -p /usr/src/things \ + && curl -SL http://example.com/big.tar.xz \ + | tar -xJC /usr/src/things \ + && make -C /usr/src/things all + +For other items (files, directories) that do not require `ADD`’s tar +auto-extraction capability, you should always use `COPY`. + +### ENTRYPOINT + +[Dockerfile reference for the ENTRYPOINT instruction](../reference/builder.md#entrypoint) + +The best use for `ENTRYPOINT` is to set the image's main command, allowing that +image to be run as though it was that command (and then use `CMD` as the +default flags). + +Let's start with an example of an image for the command line tool `s3cmd`: + + ENTRYPOINT ["s3cmd"] + CMD ["--help"] + +Now the image can be run like this to show the command's help: + + $ docker run s3cmd + +Or using the right parameters to execute a command: + + $ docker run s3cmd ls s3://mybucket + +This is useful because the image name can double as a reference to the binary as +shown in the command above. + +The `ENTRYPOINT` instruction can also be used in combination with a helper +script, allowing it to function in a similar way to the command above, even +when starting the tool may require more than one step. + +For example, the [Postgres Official Image](https://registry.hub.docker.com/_/postgres/) +uses the following script as its `ENTRYPOINT`: + +```bash +#!/bin/bash +set -e + +if [ "$1" = 'postgres' ]; then + chown -R postgres "$PGDATA" + + if [ -z "$(ls -A "$PGDATA")" ]; then + gosu postgres initdb + fi + + exec gosu postgres "$@" +fi + +exec "$@" +``` + +> **Note**: +> This script uses [the `exec` Bash command](http://wiki.bash-hackers.org/commands/builtin/exec) +> so that the final running application becomes the container's PID 1. This allows +> the application to receive any Unix signals sent to the container. +> See the [`ENTRYPOINT`](../reference/builder.md#entrypoint) +> help for more details. + + +The helper script is copied into the container and run via `ENTRYPOINT` on +container start: + + COPY ./docker-entrypoint.sh / + ENTRYPOINT ["/docker-entrypoint.sh"] + +This script allows the user to interact with Postgres in several ways. + +It can simply start Postgres: + + $ docker run postgres + +Or, it can be used to run Postgres and pass parameters to the server: + + $ docker run postgres postgres --help + +Lastly, it could also be used to start a totally different tool, such as Bash: + + $ docker run --rm -it postgres bash + +### VOLUME + +[Dockerfile reference for the VOLUME instruction](../reference/builder.md#volume) + +The `VOLUME` instruction should be used to expose any database storage area, +configuration storage, or files/folders created by your docker container. You +are strongly encouraged to use `VOLUME` for any mutable and/or user-serviceable +parts of your image. + +### USER + +[Dockerfile reference for the USER instruction](../reference/builder.md#user) + +If a service can run without privileges, use `USER` to change to a non-root +user. Start by creating the user and group in the `Dockerfile` with something +like `RUN groupadd -r postgres && useradd -r -g postgres postgres`. + +> **Note:** Users and groups in an image get a non-deterministic +> UID/GID in that the “next” UID/GID gets assigned regardless of image +> rebuilds. So, if it’s critical, you should assign an explicit UID/GID. + +You should avoid installing or using `sudo` since it has unpredictable TTY and +signal-forwarding behavior that can cause more problems than it solves. If +you absolutely need functionality similar to `sudo` (e.g., initializing the +daemon as root but running it as non-root), you may be able to use +[“gosu”](https://github.com/tianon/gosu). + +Lastly, to reduce layers and complexity, avoid switching `USER` back +and forth frequently. + +### WORKDIR + +[Dockerfile reference for the WORKDIR instruction](../reference/builder.md#workdir) + +For clarity and reliability, you should always use absolute paths for your +`WORKDIR`. Also, you should use `WORKDIR` instead of proliferating +instructions like `RUN cd … && do-something`, which are hard to read, +troubleshoot, and maintain. + +### ONBUILD + +[Dockerfile reference for the ONBUILD instruction](../reference/builder.md#onbuild) + +An `ONBUILD` command executes after the current `Dockerfile` build completes. +`ONBUILD` executes in any child image derived `FROM` the current image. Think +of the `ONBUILD` command as an instruction the parent `Dockerfile` gives +to the child `Dockerfile`. + +A Docker build executes `ONBUILD` commands before any command in a child +`Dockerfile`. + +`ONBUILD` is useful for images that are going to be built `FROM` a given +image. For example, you would use `ONBUILD` for a language stack image that +builds arbitrary user software written in that language within the +`Dockerfile`, as you can see in [Ruby’s `ONBUILD` variants](https://github.com/docker-library/ruby/blob/master/2.1/onbuild/Dockerfile). + +Images built from `ONBUILD` should get a separate tag, for example: +`ruby:1.9-onbuild` or `ruby:2.0-onbuild`. + +Be careful when putting `ADD` or `COPY` in `ONBUILD`. The “onbuild” image will +fail catastrophically if the new build's context is missing the resource being +added. Adding a separate tag, as recommended above, will help mitigate this by +allowing the `Dockerfile` author to make a choice. + +## Examples for Official Repositories + +These Official Repositories have exemplary `Dockerfile`s: + +* [Go](https://registry.hub.docker.com/_/golang/) +* [Perl](https://registry.hub.docker.com/_/perl/) +* [Hy](https://registry.hub.docker.com/_/hylang/) +* [Rails](https://registry.hub.docker.com/_/rails) + +## Additional resources: + +* [Dockerfile Reference](../reference/builder.md) +* [More about Base Images](baseimages.md) +* [More about Automated Builds](https://docs.docker.com/docker-hub/builds/) +* [Guidelines for Creating Official +Repositories](https://docs.docker.com/docker-hub/official_repos/) diff --git a/docs/articles/dsc.md b/docs/articles/dsc.md new file mode 100644 index 0000000000..2fe7553b78 --- /dev/null +++ b/docs/articles/dsc.md @@ -0,0 +1,173 @@ + + +# Using PowerShell DSC + +Windows PowerShell Desired State Configuration (DSC) is a configuration +management tool that extends the existing functionality of Windows PowerShell. +DSC uses a declarative syntax to define the state in which a target should be +configured. More information about PowerShell DSC can be found at +[http://technet.microsoft.com/en-us/library/dn249912.aspx](http://technet.microsoft.com/en-us/library/dn249912.aspx). + +## Requirements + +To use this guide you'll need a Windows host with PowerShell v4.0 or newer. + +The included DSC configuration script also uses the official PPA so +only an Ubuntu target is supported. The Ubuntu target must already have the +required OMI Server and PowerShell DSC for Linux providers installed. More +information can be found at [https://github.com/MSFTOSSMgmt/WPSDSCLinux](https://github.com/MSFTOSSMgmt/WPSDSCLinux). +The source repository listed below also includes PowerShell DSC for Linux +installation and init scripts along with more detailed installation information. + +## Installation + +The DSC configuration example source is available in the following repository: +[https://github.com/anweiss/DockerClientDSC](https://github.com/anweiss/DockerClientDSC). It can be cloned with: + + $ git clone https://github.com/anweiss/DockerClientDSC.git + +## Usage + +The DSC configuration utilizes a set of shell scripts to determine whether or +not the specified Docker components are configured on the target node(s). The +source repository also includes a script (`RunDockerClientConfig.ps1`) that can +be used to establish the required CIM session(s) and execute the +`Set-DscConfiguration` cmdlet. + +More detailed usage information can be found at +[https://github.com/anweiss/DockerClientDSC](https://github.com/anweiss/DockerClientDSC). + +### Install Docker +The Docker installation configuration is equivalent to running: + +``` +apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys\ +36A1D7869245C8950F966E92D8576A8BA88D21E9 +sh -c "echo deb https://apt.dockerproject.org/repo ubuntu-trusty main\ +> /etc/apt/sources.list.d/docker.list" +apt-get update +apt-get install docker-engine +``` + +Ensure that your current working directory is set to the `DockerClientDSC` +source and load the DockerClient configuration into the current PowerShell +session + +```powershell +. .\DockerClient.ps1 +``` + +Generate the required DSC configuration .mof file for the targeted node + +```powershell +DockerClient -Hostname "myhost" +``` + +A sample DSC configuration data file has also been included and can be modified +and used in conjunction with or in place of the `Hostname` parameter: + +```powershell +DockerClient -ConfigurationData .\DockerConfigData.psd1 +``` + +Start the configuration application process on the targeted node + +```powershell +.\RunDockerClientConfig.ps1 -Hostname "myhost" +``` + +The `RunDockerClientConfig.ps1` script can also parse a DSC configuration data +file and execute configurations against multiple nodes as such: + +```powershell +.\RunDockerClientConfig.ps1 -ConfigurationData .\DockerConfigData.psd1 +``` + +### Images +Image configuration is equivalent to running: `docker pull [image]` or +`docker rmi -f [IMAGE]`. + +Using the same steps defined above, execute `DockerClient` with the `Image` +parameter and apply the configuration: + +```powershell +DockerClient -Hostname "myhost" -Image "node" +.\RunDockerClientConfig.ps1 -Hostname "myhost" +``` + +You can also configure the host to pull multiple images: + +```powershell +DockerClient -Hostname "myhost" -Image "node","mongo" +.\RunDockerClientConfig.ps1 -Hostname "myhost" +``` + +To remove images, use a hashtable as follows: + +```powershell +DockerClient -Hostname "myhost" -Image @{Name="node"; Remove=$true} +.\RunDockerClientConfig.ps1 -Hostname $hostname +``` + +### Containers +Container configuration is equivalent to running: + +``` +docker run -d --name="[containername]" -p '[port]' -e '[env]' --link '[link]'\ +'[image]' '[command]' +``` +or + +``` +docker rm -f [containername] +``` + +To create or remove containers, you can use the `Container` parameter with one +or more hashtables. The hashtable(s) passed to this parameter can have the +following properties: + +- Name (required) +- Image (required unless Remove property is set to `$true`) +- Port +- Env +- Link +- Command +- Remove + +For example, create a hashtable with the settings for your container: + +```powershell +$webContainer = @{Name="web"; Image="anweiss/docker-platynem"; Port="80:80"} +``` + +Then, using the same steps defined above, execute +`DockerClient` with the `-Image` and `-Container` parameters: + +```powershell +DockerClient -Hostname "myhost" -Image node -Container $webContainer +.\RunDockerClientConfig.ps1 -Hostname "myhost" +``` + +Existing containers can also be removed as follows: + +```powershell +$containerToRemove = @{Name="web"; Remove=$true} +DockerClient -Hostname "myhost" -Container $containerToRemove +.\RunDockerClientConfig.ps1 -Hostname "myhost" +``` + +Here is a hashtable with all of the properties that can be used to create a +container: + +```powershell +$containerProps = @{Name="web"; Image="node:latest"; Port="80:80"; ` +Env="PORT=80"; Link="db:db"; Command="grunt"} +``` diff --git a/docs/articles/host_integration.md b/docs/articles/host_integration.md new file mode 100644 index 0000000000..c1712a0701 --- /dev/null +++ b/docs/articles/host_integration.md @@ -0,0 +1,87 @@ + + +# Automatically start containers + +As of Docker 1.2, +[restart policies](../reference/run.md#restart-policies-restart) are the +built-in Docker mechanism for restarting containers when they exit. If set, +restart policies will be used when the Docker daemon starts up, as typically +happens after a system boot. Restart policies will ensure that linked containers +are started in the correct order. + +If restart policies don't suit your needs (i.e., you have non-Docker processes +that depend on Docker containers), you can use a process manager like +[upstart](http://upstart.ubuntu.com/), +[systemd](http://freedesktop.org/wiki/Software/systemd/) or +[supervisor](http://supervisord.org/) instead. + + +## Using a process manager + +Docker does not set any restart policies by default, but be aware that they will +conflict with most process managers. So don't set restart policies if you are +using a process manager. + +When you have finished setting up your image and are happy with your +running container, you can then attach a process manager to manage it. +When you run `docker start -a`, Docker will automatically attach to the +running container, or start it if needed and forward all signals so that +the process manager can detect when a container stops and correctly +restart it. + +Here are a few sample scripts for systemd and upstart to integrate with +Docker. + + +## Examples + +The examples below show configuration files for two popular process managers, +upstart and systemd. In these examples, we'll assume that we have already +created a container to run Redis with `--name=redis_server`. These files define +a new service that will be started after the docker daemon service has started. + + +### upstart + + description "Redis container" + author "Me" + start on filesystem and started docker + stop on runlevel [!2345] + respawn + script + /usr/bin/docker start -a redis_server + end script + +### systemd + + [Unit] + Description=Redis container + Requires=docker.service + After=docker.service + + [Service] + Restart=always + ExecStart=/usr/bin/docker start -a redis_server + ExecStop=/usr/bin/docker stop -t 2 redis_server + + [Install] + WantedBy=local.target + +If you need to pass options to the redis container (such as `--env`), +then you'll need to use `docker run` rather than `docker start`. This will +create a new container every time the service is started, which will be stopped +and removed when the service is stopped. + + [Service] + ... + ExecStart=/usr/bin/docker run --env foo=bar --name redis_server redis + ExecStop=/usr/bin/docker stop -t 2 redis_server ; /usr/bin/docker rm -f redis_server + ... diff --git a/docs/articles/https.md b/docs/articles/https.md new file mode 100644 index 0000000000..d7f016d8e0 --- /dev/null +++ b/docs/articles/https.md @@ -0,0 +1,211 @@ + + +# Protect the Docker daemon socket + +By default, Docker runs via a non-networked Unix socket. It can also +optionally communicate using a HTTP socket. + +If you need Docker to be reachable via the network in a safe manner, you can +enable TLS by specifying the `tlsverify` flag and pointing Docker's +`tlscacert` flag to a trusted CA certificate. + +In the daemon mode, it will only allow connections from clients +authenticated by a certificate signed by that CA. In the client mode, +it will only connect to servers with a certificate signed by that CA. + +> **Warning**: +> Using TLS and managing a CA is an advanced topic. Please familiarize yourself +> with OpenSSL, x509 and TLS before using it in production. + +> **Warning**: +> These TLS commands will only generate a working set of certificates on Linux. +> Mac OS X comes with a version of OpenSSL that is incompatible with the +> certificates that Docker requires. + +## Create a CA, server and client keys with OpenSSL + +> **Note**: replace all instances of `$HOST` in the following example with the +> DNS name of your Docker daemon's host. + +First generate CA private and public keys: + + $ openssl genrsa -aes256 -out ca-key.pem 4096 + Generating RSA private key, 4096 bit long modulus + ............................................................................................................................................................................................++ + ........++ + e is 65537 (0x10001) + Enter pass phrase for ca-key.pem: + Verifying - Enter pass phrase for ca-key.pem: + $ openssl req -new -x509 -days 365 -key ca-key.pem -sha256 -out ca.pem + Enter pass phrase for ca-key.pem: + You are about to be asked to enter information that will be incorporated + into your certificate request. + What you are about to enter is what is called a Distinguished Name or a DN. + There are quite a few fields but you can leave some blank + For some fields there will be a default value, + If you enter '.', the field will be left blank. + ----- + Country Name (2 letter code) [AU]: + State or Province Name (full name) [Some-State]:Queensland + Locality Name (eg, city) []:Brisbane + Organization Name (eg, company) [Internet Widgits Pty Ltd]:Docker Inc + Organizational Unit Name (eg, section) []:Sales + Common Name (e.g. server FQDN or YOUR name) []:$HOST + Email Address []:Sven@home.org.au + +Now that we have a CA, you can create a server key and certificate +signing request (CSR). Make sure that "Common Name" (i.e., server FQDN or YOUR +name) matches the hostname you will use to connect to Docker: + +> **Note**: replace all instances of `$HOST` in the following example with the +> DNS name of your Docker daemon's host. + + $ openssl genrsa -out server-key.pem 4096 + Generating RSA private key, 4096 bit long modulus + .....................................................................++ + .................................................................................................++ + e is 65537 (0x10001) + $ openssl req -subj "/CN=$HOST" -sha256 -new -key server-key.pem -out server.csr + +Next, we're going to sign the public key with our CA: + +Since TLS connections can be made via IP address as well as DNS name, they need +to be specified when creating the certificate. For example, to allow connections +using `10.10.10.20` and `127.0.0.1`: + + $ echo subjectAltName = IP:10.10.10.20,IP:127.0.0.1 > extfile.cnf + + $ openssl x509 -req -days 365 -sha256 -in server.csr -CA ca.pem -CAkey ca-key.pem \ + -CAcreateserial -out server-cert.pem -extfile extfile.cnf + Signature ok + subject=/CN=your.host.com + Getting CA Private Key + Enter pass phrase for ca-key.pem: + +For client authentication, create a client key and certificate signing +request: + + $ openssl genrsa -out key.pem 4096 + Generating RSA private key, 4096 bit long modulus + .........................................................++ + ................++ + e is 65537 (0x10001) + $ openssl req -subj '/CN=client' -new -key key.pem -out client.csr + +To make the key suitable for client authentication, create an extensions +config file: + + $ echo extendedKeyUsage = clientAuth > extfile.cnf + +Now sign the public key: + + $ openssl x509 -req -days 365 -sha256 -in client.csr -CA ca.pem -CAkey ca-key.pem \ + -CAcreateserial -out cert.pem -extfile extfile.cnf + Signature ok + subject=/CN=client + Getting CA Private Key + Enter pass phrase for ca-key.pem: + +After generating `cert.pem` and `server-cert.pem` you can safely remove the +two certificate signing requests: + + $ rm -v client.csr server.csr + +With a default `umask` of 022, your secret keys will be *world-readable* and +writable for you and your group. + +In order to protect your keys from accidental damage, you will want to remove their +write permissions. To make them only readable by you, change file modes as follows: + + $ chmod -v 0400 ca-key.pem key.pem server-key.pem + +Certificates can be world-readable, but you might want to remove write access to +prevent accidental damage: + + $ chmod -v 0444 ca.pem server-cert.pem cert.pem + +Now you can make the Docker daemon only accept connections from clients +providing a certificate trusted by our CA: + + $ docker daemon --tlsverify --tlscacert=ca.pem --tlscert=server-cert.pem --tlskey=server-key.pem \ + -H=0.0.0.0:2376 + +To be able to connect to Docker and validate its certificate, you now +need to provide your client keys, certificates and trusted CA: + +> **Note**: replace all instances of `$HOST` in the following example with the +> DNS name of your Docker daemon's host. + + $ docker --tlsverify --tlscacert=ca.pem --tlscert=cert.pem --tlskey=key.pem \ + -H=$HOST:2376 version + +> **Note**: +> Docker over TLS should run on TCP port 2376. + +> **Warning**: +> As shown in the example above, you don't have to run the `docker` client +> with `sudo` or the `docker` group when you use certificate authentication. +> That means anyone with the keys can give any instructions to your Docker +> daemon, giving them root access to the machine hosting the daemon. Guard +> these keys as you would a root password! + +## Secure by default + +If you want to secure your Docker client connections by default, you can move +the files to the `.docker` directory in your home directory -- and set the +`DOCKER_HOST` and `DOCKER_TLS_VERIFY` variables as well (instead of passing +`-H=tcp://$HOST:2376` and `--tlsverify` on every call). + + $ mkdir -pv ~/.docker + $ cp -v {ca,cert,key}.pem ~/.docker + $ export DOCKER_HOST=tcp://$HOST:2376 DOCKER_TLS_VERIFY=1 + +Docker will now connect securely by default: + + $ docker ps + +## Other modes + +If you don't want to have complete two-way authentication, you can run +Docker in various other modes by mixing the flags. + +### Daemon modes + + - `tlsverify`, `tlscacert`, `tlscert`, `tlskey` set: Authenticate clients + - `tls`, `tlscert`, `tlskey`: Do not authenticate clients + +### Client modes + + - `tls`: Authenticate server based on public/default CA pool + - `tlsverify`, `tlscacert`: Authenticate server based on given CA + - `tls`, `tlscert`, `tlskey`: Authenticate with client certificate, do not + authenticate server based on given CA + - `tlsverify`, `tlscacert`, `tlscert`, `tlskey`: Authenticate with client + certificate and authenticate server based on given CA + +If found, the client will send its client certificate, so you just need +to drop your keys into `~/.docker/{ca,cert,key}.pem`. Alternatively, +if you want to store your keys in another location, you can specify that +location using the environment variable `DOCKER_CERT_PATH`. + + $ export DOCKER_CERT_PATH=~/.docker/zone1/ + $ docker --tlsverify ps + +### Connecting to the secure Docker port using `curl` + +To use `curl` to make test API requests, you need to use three extra command line +flags: + + $ curl https://$HOST:2376/images/json \ + --cert ~/.docker/cert.pem \ + --key ~/.docker/key.pem \ + --cacert ~/.docker/ca.pem diff --git a/docs/articles/https/Dockerfile b/docs/articles/https/Dockerfile new file mode 100644 index 0000000000..a3cc132c51 --- /dev/null +++ b/docs/articles/https/Dockerfile @@ -0,0 +1,10 @@ +FROM debian + +RUN apt-get update && apt-get install -yq openssl + +ADD make_certs.sh / + + +WORKDIR /data +VOLUME ["/data"] +CMD /make_certs.sh diff --git a/docs/articles/https/Makefile b/docs/articles/https/Makefile new file mode 100644 index 0000000000..3c84697461 --- /dev/null +++ b/docs/articles/https/Makefile @@ -0,0 +1,24 @@ + +HOST:=boot2docker + +makescript: + ./parsedocs.sh > make_certs.sh + +build: clean makescript + docker build -t makecerts . + +cert: build + docker run --rm -it -v $(CURDIR):/data -e HOST=$(HOST) -e YOUR_PUBLIC_IP=$(shell ip a | grep "inet " | sed "s/.*inet \([0-9.]*\)\/.*/\1/" | xargs echo | sed "s/ /,IP:/g") makecerts + +certs: cert + +run: + sudo docker daemon -D --tlsverify --tlscacert=ca.pem --tlscert=server-cert.pem --tlskey=server-key.pem -H=0.0.0.0:6666 --pidfile=$(pwd)/docker.pid --graph=$(pwd)/graph + +client: + sudo docker --tls --tlscacert=ca.pem --tlscert=cert.pem --tlskey=key.pem -H=$(HOST):6666 version + sudo docker --tlsverify --tlscacert=ca.pem --tlscert=cert.pem --tlskey=key.pem -H=$(HOST):6666 info + sudo curl https://$(HOST):6666/images/json --cert ./cert.pem --key ./key.pem --cacert ./ca.pem + +clean: + rm -f ca-key.pem ca.pem ca.srl cert.pem client.csr extfile.cnf key.pem server-cert.pem server-key.pem server.csr extfile.cnf diff --git a/docs/articles/https/README.md b/docs/articles/https/README.md new file mode 100644 index 0000000000..1faca04a1a --- /dev/null +++ b/docs/articles/https/README.md @@ -0,0 +1,26 @@ + + +This is an initial attempt to make it easier to test the examples in the https.md +doc + +at this point, it has to be a manual thing, and I've been running it in boot2docker + +so my process is + +$ boot2docker ssh +$$ git clone https://github.com/docker/docker +$$ cd docker/docs/articles/https +$$ make cert +lots of things to see and manually answer, as openssl wants to be interactive +**NOTE:** make sure you enter the hostname (`boot2docker` in my case) when prompted for `Computer Name`) +$$ sudo make run + +start another terminal + +$ boot2docker ssh +$$ cd docker/docs/articles/https +$$ make client + +the last will connect first with `--tls` and then with `--tlsverify` + +both should succeed diff --git a/docs/articles/https/make_certs.sh b/docs/articles/https/make_certs.sh new file mode 100755 index 0000000000..39001fdb50 --- /dev/null +++ b/docs/articles/https/make_certs.sh @@ -0,0 +1,23 @@ +#!/bin/sh +openssl genrsa -aes256 -out ca-key.pem 2048 +openssl req -new -x509 -days 365 -key ca-key.pem -sha256 -out ca.pem +openssl genrsa -out server-key.pem 2048 +openssl req -subj "/CN=$HOST" -new -key server-key.pem -out server.csr +echo subjectAltName = IP:$YOUR_PUBLIC_IP > extfile.cnf +openssl x509 -req -days 365 -in server.csr -CA ca.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem -extfile extfile.cnf +openssl genrsa -out key.pem 2048 +openssl req -subj '/CN=client' -new -key key.pem -out client.csr +echo extendedKeyUsage = clientAuth > extfile.cnf +openssl x509 -req -days 365 -in client.csr -CA ca.pem -CAkey ca-key.pem -CAcreateserial -out cert.pem -extfile extfile.cnf +rm -v client.csr server.csr +chmod -v 0400 ca-key.pem key.pem server-key.pem +chmod -v 0444 ca.pem server-cert.pem cert.pem +# docker -d --tlsverify --tlscacert=ca.pem --tlscert=server-cert.pem --tlskey=server-key.pem -H=0.0.0.0:7778 +# docker --tlsverify --tlscacert=ca.pem --tlscert=cert.pem --tlskey=key.pem -H=$HOST:7778 version +mkdir -pv ~/.docker +cp -v {ca,cert,key}.pem ~/.docker +export DOCKER_HOST=tcp://$HOST:7778 DOCKER_TLS_VERIFY=1 +# docker ps +export DOCKER_CERT_PATH=~/.docker/zone1/ +# docker --tlsverify ps +# curl https://$HOST:7778/images/json --cert ~/.docker/cert.pem --key ~/.docker/key.pem --cacert ~/.docker/ca.pem diff --git a/docs/articles/https/parsedocs.sh b/docs/articles/https/parsedocs.sh new file mode 100755 index 0000000000..f9df33c337 --- /dev/null +++ b/docs/articles/https/parsedocs.sh @@ -0,0 +1,10 @@ +#!/bin/sh + +echo "#!/bin/sh" +cat ../https.md | awk '{if (sub(/\\$/,"")) printf "%s", $0; else print $0}' \ + | grep ' $ ' \ + | sed 's/ $ //g' \ + | sed 's/2375/7777/g' \ + | sed 's/2376/7778/g' \ + | sed 's/^docker/# docker/g' \ + | sed 's/^curl/# curl/g' diff --git a/docs/articles/puppet.md b/docs/articles/puppet.md new file mode 100644 index 0000000000..21fa86fc71 --- /dev/null +++ b/docs/articles/puppet.md @@ -0,0 +1,99 @@ + + +# Using Puppet + +> *Note:* Please note this is a community contributed installation path. The +> only `official` installation is using the +> [*Ubuntu*](../installation/ubuntulinux.md) installation +> path. This version may sometimes be out of date. + +## Requirements + +To use this guide you'll need a working installation of Puppet from +[Puppet Labs](https://puppetlabs.com) . + +The module also currently uses the official PPA so only works with +Ubuntu. + +## Installation + +The module is available on the [Puppet +Forge](https://forge.puppetlabs.com/garethr/docker/) and can be +installed using the built-in module tool. + + $ puppet module install garethr/docker + +It can also be found on +[GitHub](https://github.com/garethr/garethr-docker) if you would rather +download the source. + +## Usage + +The module provides a puppet class for installing Docker and two defined +types for managing images and containers. + +### Installation + + include 'docker' + +### Images + +The next step is probably to install a Docker image. For this, we have a +defined type which can be used like so: + + docker::image { 'ubuntu': } + +This is equivalent to running: + + $ docker pull ubuntu + +Note that it will only be downloaded if an image of that name does not +already exist. This is downloading a large binary so on first run can +take a while. For that reason this define turns off the default 5 minute +timeout for the exec type. Note that you can also remove images you no +longer need with: + + docker::image { 'ubuntu': + ensure => 'absent', + } + +### Containers + +Now you have an image where you can run commands within a container +managed by Docker. + + docker::run { 'helloworld': + image => 'ubuntu', + command => '/bin/sh -c "while true; do echo hello world; sleep 1; done"', + } + +This is equivalent to running the following command, but under upstart: + + $ docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done" + +Run also contains a number of optional parameters: + + docker::run { 'helloworld': + image => 'ubuntu', + command => '/bin/sh -c "while true; do echo hello world; sleep 1; done"', + ports => ['4444', '4555'], + volumes => ['/var/lib/couchdb', '/var/log'], + volumes_from => '6446ea52fbc9', + memory_limit => 10485760, # bytes + username => 'example', + hostname => 'example.com', + env => ['FOO=BAR', 'FOO2=BAR2'], + dns => ['8.8.8.8', '8.8.4.4'], + } + +> *Note:* +> The `ports`, `env`, `dns` and `volumes` attributes can be set with either a single +> string or as above with an array of values. diff --git a/docs/articles/registry_mirror.md b/docs/articles/registry_mirror.md new file mode 100644 index 0000000000..0d5fff5d16 --- /dev/null +++ b/docs/articles/registry_mirror.md @@ -0,0 +1,18 @@ + + +# Run a local registry mirror + +The original content was deprecated. [An archived +version](https://docs.docker.com/v1.6/articles/registry_mirror) is available in +the 1.7 documentation. For information about configuring mirrors with the latest +Docker Registry version, please file a support request with [the Distribution +project](https://github.com/docker/distribution/issues). diff --git a/docs/articles/runmetrics.md b/docs/articles/runmetrics.md new file mode 100644 index 0000000000..4b2cc5a775 --- /dev/null +++ b/docs/articles/runmetrics.md @@ -0,0 +1,463 @@ + + +# Runtime metrics + + +## Docker stats + +You can use the `docker stats` command to live stream a container's +runtime metrics. The command supports CPU, memory usage, memory limit, +and network IO metrics. + +The following is a sample output from the `docker stats` command + + $ docker stats redis1 redis2 + CONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O + redis1 0.07% 796 KB / 64 MB 1.21% 788 B / 648 B 3.568 MB / 512 KB + redis2 0.07% 2.746 MB / 64 MB 4.29% 1.266 KB / 648 B 12.4 MB / 0 B + + +The [docker stats](../reference/commandline/stats.md) reference page has +more details about the `docker stats` command. + +## Control groups + +Linux Containers rely on [control groups]( +https://www.kernel.org/doc/Documentation/cgroups/cgroups.txt) +which not only track groups of processes, but also expose metrics about +CPU, memory, and block I/O usage. You can access those metrics and +obtain network usage metrics as well. This is relevant for "pure" LXC +containers, as well as for Docker containers. + +Control groups are exposed through a pseudo-filesystem. In recent +distros, you should find this filesystem under `/sys/fs/cgroup`. Under +that directory, you will see multiple sub-directories, called devices, +freezer, blkio, etc.; each sub-directory actually corresponds to a different +cgroup hierarchy. + +On older systems, the control groups might be mounted on `/cgroup`, without +distinct hierarchies. In that case, instead of seeing the sub-directories, +you will see a bunch of files in that directory, and possibly some directories +corresponding to existing containers. + +To figure out where your control groups are mounted, you can run: + + $ grep cgroup /proc/mounts + +## Enumerating cgroups + +You can look into `/proc/cgroups` to see the different control group subsystems +known to the system, the hierarchy they belong to, and how many groups they contain. + +You can also look at `/proc//cgroup` to see which control groups a process +belongs to. The control group will be shown as a path relative to the root of +the hierarchy mountpoint; e.g., `/` means “this process has not been assigned into +a particular group”, while `/lxc/pumpkin` means that the process is likely to be +a member of a container named `pumpkin`. + +## Finding the cgroup for a given container + +For each container, one cgroup will be created in each hierarchy. On +older systems with older versions of the LXC userland tools, the name of +the cgroup will be the name of the container. With more recent versions +of the LXC tools, the cgroup will be `lxc/.` + +For Docker containers using cgroups, the container name will be the full +ID or long ID of the container. If a container shows up as ae836c95b4c3 +in `docker ps`, its long ID might be something like +`ae836c95b4c3c9e9179e0e91015512da89fdec91612f63cebae57df9a5444c79`. You can +look it up with `docker inspect` or `docker ps --no-trunc`. + +Putting everything together to look at the memory metrics for a Docker +container, take a look at `/sys/fs/cgroup/memory/docker//`. + +## Metrics from cgroups: memory, CPU, block I/O + +For each subsystem (memory, CPU, and block I/O), you will find one or +more pseudo-files containing statistics. + +### Memory metrics: `memory.stat` + +Memory metrics are found in the "memory" cgroup. Note that the memory +control group adds a little overhead, because it does very fine-grained +accounting of the memory usage on your host. Therefore, many distros +chose to not enable it by default. Generally, to enable it, all you have +to do is to add some kernel command-line parameters: +`cgroup_enable=memory swapaccount=1`. + +The metrics are in the pseudo-file `memory.stat`. +Here is what it will look like: + + cache 11492564992 + rss 1930993664 + mapped_file 306728960 + pgpgin 406632648 + pgpgout 403355412 + swap 0 + pgfault 728281223 + pgmajfault 1724 + inactive_anon 46608384 + active_anon 1884520448 + inactive_file 7003344896 + active_file 4489052160 + unevictable 32768 + hierarchical_memory_limit 9223372036854775807 + hierarchical_memsw_limit 9223372036854775807 + total_cache 11492564992 + total_rss 1930993664 + total_mapped_file 306728960 + total_pgpgin 406632648 + total_pgpgout 403355412 + total_swap 0 + total_pgfault 728281223 + total_pgmajfault 1724 + total_inactive_anon 46608384 + total_active_anon 1884520448 + total_inactive_file 7003344896 + total_active_file 4489052160 + total_unevictable 32768 + +The first half (without the `total_` prefix) contains statistics relevant +to the processes within the cgroup, excluding sub-cgroups. The second half +(with the `total_` prefix) includes sub-cgroups as well. + +Some metrics are "gauges", i.e., values that can increase or decrease +(e.g., swap, the amount of swap space used by the members of the cgroup). +Some others are "counters", i.e., values that can only go up, because +they represent occurrences of a specific event (e.g., pgfault, which +indicates the number of page faults which happened since the creation of +the cgroup; this number can never decrease). + + + - **cache:** + the amount of memory used by the processes of this control group + that can be associated precisely with a block on a block device. + When you read from and write to files on disk, this amount will + increase. This will be the case if you use "conventional" I/O + (`open`, `read`, + `write` syscalls) as well as mapped files (with + `mmap`). It also accounts for the memory used by + `tmpfs` mounts, though the reasons are unclear. + + - **rss:** + the amount of memory that *doesn't* correspond to anything on disk: + stacks, heaps, and anonymous memory maps. + + - **mapped_file:** + indicates the amount of memory mapped by the processes in the + control group. It doesn't give you information about *how much* + memory is used; it rather tells you *how* it is used. + + - **pgfault and pgmajfault:** + indicate the number of times that a process of the cgroup triggered + a "page fault" and a "major fault", respectively. A page fault + happens when a process accesses a part of its virtual memory space + which is nonexistent or protected. The former can happen if the + process is buggy and tries to access an invalid address (it will + then be sent a `SIGSEGV` signal, typically + killing it with the famous `Segmentation fault` + message). The latter can happen when the process reads from a memory + zone which has been swapped out, or which corresponds to a mapped + file: in that case, the kernel will load the page from disk, and let + the CPU complete the memory access. It can also happen when the + process writes to a copy-on-write memory zone: likewise, the kernel + will preempt the process, duplicate the memory page, and resume the + write operation on the process` own copy of the page. "Major" faults + happen when the kernel actually has to read the data from disk. When + it just has to duplicate an existing page, or allocate an empty + page, it's a regular (or "minor") fault. + + - **swap:** + the amount of swap currently used by the processes in this cgroup. + + - **active_anon and inactive_anon:** + the amount of *anonymous* memory that has been identified has + respectively *active* and *inactive* by the kernel. "Anonymous" + memory is the memory that is *not* linked to disk pages. In other + words, that's the equivalent of the rss counter described above. In + fact, the very definition of the rss counter is **active_anon** + + **inactive_anon** - **tmpfs** (where tmpfs is the amount of memory + used up by `tmpfs` filesystems mounted by this + control group). Now, what's the difference between "active" and + "inactive"? Pages are initially "active"; and at regular intervals, + the kernel sweeps over the memory, and tags some pages as + "inactive". Whenever they are accessed again, they are immediately + retagged "active". When the kernel is almost out of memory, and time + comes to swap out to disk, the kernel will swap "inactive" pages. + + - **active_file and inactive_file:** + cache memory, with *active* and *inactive* similar to the *anon* + memory above. The exact formula is cache = **active_file** + + **inactive_file** + **tmpfs**. The exact rules used by the kernel + to move memory pages between active and inactive sets are different + from the ones used for anonymous memory, but the general principle + is the same. Note that when the kernel needs to reclaim memory, it + is cheaper to reclaim a clean (=non modified) page from this pool, + since it can be reclaimed immediately (while anonymous pages and + dirty/modified pages have to be written to disk first). + + - **unevictable:** + the amount of memory that cannot be reclaimed; generally, it will + account for memory that has been "locked" with `mlock`. + It is often used by crypto frameworks to make sure that + secret keys and other sensitive material never gets swapped out to + disk. + + - **memory and memsw limits:** + These are not really metrics, but a reminder of the limits applied + to this cgroup. The first one indicates the maximum amount of + physical memory that can be used by the processes of this control + group; the second one indicates the maximum amount of RAM+swap. + +Accounting for memory in the page cache is very complex. If two +processes in different control groups both read the same file +(ultimately relying on the same blocks on disk), the corresponding +memory charge will be split between the control groups. It's nice, but +it also means that when a cgroup is terminated, it could increase the +memory usage of another cgroup, because they are not splitting the cost +anymore for those memory pages. + +### CPU metrics: `cpuacct.stat` + +Now that we've covered memory metrics, everything else will look very +simple in comparison. CPU metrics will be found in the +`cpuacct` controller. + +For each container, you will find a pseudo-file `cpuacct.stat`, +containing the CPU usage accumulated by the processes of the container, +broken down between `user` and `system` time. If you're not familiar +with the distinction, `user` is the time during which the processes were +in direct control of the CPU (i.e., executing process code), and `system` +is the time during which the CPU was executing system calls on behalf of +those processes. + +Those times are expressed in ticks of 1/100th of a second. Actually, +they are expressed in "user jiffies". There are `USER_HZ` +*"jiffies"* per second, and on x86 systems, +`USER_HZ` is 100. This used to map exactly to the +number of scheduler "ticks" per second; but with the advent of higher +frequency scheduling, as well as [tickless kernels]( +http://lwn.net/Articles/549580/), the number of kernel ticks +wasn't relevant anymore. It stuck around anyway, mainly for legacy and +compatibility reasons. + +### Block I/O metrics + +Block I/O is accounted in the `blkio` controller. +Different metrics are scattered across different files. While you can +find in-depth details in the [blkio-controller]( +https://www.kernel.org/doc/Documentation/cgroups/blkio-controller.txt) +file in the kernel documentation, here is a short list of the most +relevant ones: + + + - **blkio.sectors:** + contain the number of 512-bytes sectors read and written by the + processes member of the cgroup, device by device. Reads and writes + are merged in a single counter. + + - **blkio.io_service_bytes:** + indicates the number of bytes read and written by the cgroup. It has + 4 counters per device, because for each device, it differentiates + between synchronous vs. asynchronous I/O, and reads vs. writes. + + - **blkio.io_serviced:** + the number of I/O operations performed, regardless of their size. It + also has 4 counters per device. + + - **blkio.io_queued:** + indicates the number of I/O operations currently queued for this + cgroup. In other words, if the cgroup isn't doing any I/O, this will + be zero. Note that the opposite is not true. In other words, if + there is no I/O queued, it does not mean that the cgroup is idle + (I/O-wise). It could be doing purely synchronous reads on an + otherwise quiescent device, which is therefore able to handle them + immediately, without queuing. Also, while it is helpful to figure + out which cgroup is putting stress on the I/O subsystem, keep in + mind that is is a relative quantity. Even if a process group does + not perform more I/O, its queue size can increase just because the + device load increases because of other devices. + +## Network metrics + +Network metrics are not exposed directly by control groups. There is a +good explanation for that: network interfaces exist within the context +of *network namespaces*. The kernel could probably accumulate metrics +about packets and bytes sent and received by a group of processes, but +those metrics wouldn't be very useful. You want per-interface metrics +(because traffic happening on the local `lo` +interface doesn't really count). But since processes in a single cgroup +can belong to multiple network namespaces, those metrics would be harder +to interpret: multiple network namespaces means multiple `lo` +interfaces, potentially multiple `eth0` +interfaces, etc.; so this is why there is no easy way to gather network +metrics with control groups. + +Instead we can gather network metrics from other sources: + +### IPtables + +IPtables (or rather, the netfilter framework for which iptables is just +an interface) can do some serious accounting. + +For instance, you can setup a rule to account for the outbound HTTP +traffic on a web server: + + $ iptables -I OUTPUT -p tcp --sport 80 + +There is no `-j` or `-g` flag, +so the rule will just count matched packets and go to the following +rule. + +Later, you can check the values of the counters, with: + + $ iptables -nxvL OUTPUT + +Technically, `-n` is not required, but it will +prevent iptables from doing DNS reverse lookups, which are probably +useless in this scenario. + +Counters include packets and bytes. If you want to setup metrics for +container traffic like this, you could execute a `for` +loop to add two `iptables` rules per +container IP address (one in each direction), in the `FORWARD` +chain. This will only meter traffic going through the NAT +layer; you will also have to add traffic going through the userland +proxy. + +Then, you will need to check those counters on a regular basis. If you +happen to use `collectd`, there is a [nice plugin](https://collectd.org/wiki/index.php/Table_of_Plugins) +to automate iptables counters collection. + +### Interface-level counters + +Since each container has a virtual Ethernet interface, you might want to +check directly the TX and RX counters of this interface. You will notice +that each container is associated to a virtual Ethernet interface in +your host, with a name like `vethKk8Zqi`. Figuring +out which interface corresponds to which container is, unfortunately, +difficult. + +But for now, the best way is to check the metrics *from within the +containers*. To accomplish this, you can run an executable from the host +environment within the network namespace of a container using **ip-netns +magic**. + +The `ip-netns exec` command will let you execute any +program (present in the host system) within any network namespace +visible to the current process. This means that your host will be able +to enter the network namespace of your containers, but your containers +won't be able to access the host, nor their sibling containers. +Containers will be able to “see” and affect their sub-containers, +though. + +The exact format of the command is: + + $ ip netns exec + +For example: + + $ ip netns exec mycontainer netstat -i + +`ip netns` finds the "mycontainer" container by +using namespaces pseudo-files. Each process belongs to one network +namespace, one PID namespace, one `mnt` namespace, +etc., and those namespaces are materialized under +`/proc//ns/`. For example, the network +namespace of PID 42 is materialized by the pseudo-file +`/proc/42/ns/net`. + +When you run `ip netns exec mycontainer ...`, it +expects `/var/run/netns/mycontainer` to be one of +those pseudo-files. (Symlinks are accepted.) + +In other words, to execute a command within the network namespace of a +container, we need to: + +- Find out the PID of any process within the container that we want to investigate; +- Create a symlink from `/var/run/netns/` to `/proc//ns/net` +- Execute `ip netns exec ....` + +Please review [*Enumerating Cgroups*](#enumerating-cgroups) to learn how to find +the cgroup of a process running in the container of which you want to +measure network usage. From there, you can examine the pseudo-file named +`tasks`, which contains the PIDs that are in the +control group (i.e., in the container). Pick any one of them. + +Putting everything together, if the "short ID" of a container is held in +the environment variable `$CID`, then you can do this: + + $ TASKS=/sys/fs/cgroup/devices/docker/$CID*/tasks + $ PID=$(head -n 1 $TASKS) + $ mkdir -p /var/run/netns + $ ln -sf /proc/$PID/ns/net /var/run/netns/$CID + $ ip netns exec $CID netstat -i + +## Tips for high-performance metric collection + +Note that running a new process each time you want to update metrics is +(relatively) expensive. If you want to collect metrics at high +resolutions, and/or over a large number of containers (think 1000 +containers on a single host), you do not want to fork a new process each +time. + +Here is how to collect metrics from a single process. You will have to +write your metric collector in C (or any language that lets you do +low-level system calls). You need to use a special system call, +`setns()`, which lets the current process enter any +arbitrary namespace. It requires, however, an open file descriptor to +the namespace pseudo-file (remember: that's the pseudo-file in +`/proc//ns/net`). + +However, there is a catch: you must not keep this file descriptor open. +If you do, when the last process of the control group exits, the +namespace will not be destroyed, and its network resources (like the +virtual interface of the container) will stay around for ever (or until +you close that file descriptor). + +The right approach would be to keep track of the first PID of each +container, and re-open the namespace pseudo-file each time. + +## Collecting metrics when a container exits + +Sometimes, you do not care about real time metric collection, but when a +container exits, you want to know how much CPU, memory, etc. it has +used. + +Docker makes this difficult because it relies on `lxc-start`, which +carefully cleans up after itself, but it is still possible. It is +usually easier to collect metrics at regular intervals (e.g., every +minute, with the collectd LXC plugin) and rely on that instead. + +But, if you'd still like to gather the stats when a container stops, +here is how: + +For each container, start a collection process, and move it to the +control groups that you want to monitor by writing its PID to the tasks +file of the cgroup. The collection process should periodically re-read +the tasks file to check if it's the last process of the control group. +(If you also want to collect network statistics as explained in the +previous section, you should also move the process to the appropriate +network namespace.) + +When the container exits, `lxc-start` will try to +delete the control groups. It will fail, since the control group is +still in use; but that's fine. You process should now detect that it is +the only one remaining in the group. Now is the right time to collect +all the metrics you need! + +Finally, your process should move itself back to the root control group, +and remove the container control group. To remove a control group, just +`rmdir` its directory. It's counter-intuitive to +`rmdir` a directory as it still contains files; but +remember that this is a pseudo-filesystem, so usual rules don't apply. +After the cleanup is done, the collection process can exit safely. diff --git a/docs/articles/security.md b/docs/articles/security.md new file mode 100644 index 0000000000..2eddbd2552 --- /dev/null +++ b/docs/articles/security.md @@ -0,0 +1,284 @@ + + +# Docker security + +There are three major areas to consider when reviewing Docker security: + + - the intrinsic security of the kernel and its support for + namespaces and cgroups; + - the attack surface of the Docker daemon itself; + - loopholes in the container configuration profile, either by default, + or when customized by users. + - the "hardening" security features of the kernel and how they + interact with containers. + +## Kernel namespaces + +Docker containers are very similar to LXC containers, and they have +similar security features. When you start a container with +`docker run`, behind the scenes Docker creates a set of namespaces and control +groups for the container. + +**Namespaces provide the first and most straightforward form of +isolation**: processes running within a container cannot see, and even +less affect, processes running in another container, or in the host +system. + +**Each container also gets its own network stack**, meaning that a +container doesn't get privileged access to the sockets or interfaces +of another container. Of course, if the host system is setup +accordingly, containers can interact with each other through their +respective network interfaces — just like they can interact with +external hosts. When you specify public ports for your containers or use +[*links*](../userguide/networking/default_network/dockerlinks.md) +then IP traffic is allowed between containers. They can ping each other, +send/receive UDP packets, and establish TCP connections, but that can be +restricted if necessary. From a network architecture point of view, all +containers on a given Docker host are sitting on bridge interfaces. This +means that they are just like physical machines connected through a +common Ethernet switch; no more, no less. + +How mature is the code providing kernel namespaces and private +networking? Kernel namespaces were introduced [between kernel version +2.6.15 and +2.6.26](http://lxc.sourceforge.net/index.php/about/kernel-namespaces/). +This means that since July 2008 (date of the 2.6.26 release, now 7 years +ago), namespace code has been exercised and scrutinized on a large +number of production systems. And there is more: the design and +inspiration for the namespaces code are even older. Namespaces are +actually an effort to reimplement the features of [OpenVZ]( +http://en.wikipedia.org/wiki/OpenVZ) in such a way that they could be +merged within the mainstream kernel. And OpenVZ was initially released +in 2005, so both the design and the implementation are pretty mature. + +## Control groups + +Control Groups are another key component of Linux Containers. They +implement resource accounting and limiting. They provide many +useful metrics, but they also help ensure that each container gets +its fair share of memory, CPU, disk I/O; and, more importantly, that a +single container cannot bring the system down by exhausting one of those +resources. + +So while they do not play a role in preventing one container from +accessing or affecting the data and processes of another container, they +are essential to fend off some denial-of-service attacks. They are +particularly important on multi-tenant platforms, like public and +private PaaS, to guarantee a consistent uptime (and performance) even +when some applications start to misbehave. + +Control Groups have been around for a while as well: the code was +started in 2006, and initially merged in kernel 2.6.24. + +## Docker daemon attack surface + +Running containers (and applications) with Docker implies running the +Docker daemon. This daemon currently requires `root` privileges, and you +should therefore be aware of some important details. + +First of all, **only trusted users should be allowed to control your +Docker daemon**. This is a direct consequence of some powerful Docker +features. Specifically, Docker allows you to share a directory between +the Docker host and a guest container; and it allows you to do so +without limiting the access rights of the container. This means that you +can start a container where the `/host` directory will be the `/` directory +on your host; and the container will be able to alter your host filesystem +without any restriction. This is similar to how virtualization systems +allow filesystem resource sharing. Nothing prevents you from sharing your +root filesystem (or even your root block device) with a virtual machine. + +This has a strong security implication: for example, if you instrument Docker +from a web server to provision containers through an API, you should be +even more careful than usual with parameter checking, to make sure that +a malicious user cannot pass crafted parameters causing Docker to create +arbitrary containers. + +For this reason, the REST API endpoint (used by the Docker CLI to +communicate with the Docker daemon) changed in Docker 0.5.2, and now +uses a UNIX socket instead of a TCP socket bound on 127.0.0.1 (the +latter being prone to cross-site-scripting attacks if you happen to run +Docker directly on your local machine, outside of a VM). You can then +use traditional UNIX permission checks to limit access to the control +socket. + +You can also expose the REST API over HTTP if you explicitly decide to do so. +However, if you do that, being aware of the above mentioned security +implication, you should ensure that it will be reachable only from a +trusted network or VPN; or protected with e.g., `stunnel` and client SSL +certificates. You can also secure them with [HTTPS and +certificates](../articles/https/). + +The daemon is also potentially vulnerable to other inputs, such as image +loading from either disk with 'docker load', or from the network with +'docker pull'. This has been a focus of improvement in the community, +especially for 'pull' security. While these overlap, it should be noted +that 'docker load' is a mechanism for backup and restore and is not +currently considered a secure mechanism for loading images. As of +Docker 1.3.2, images are now extracted in a chrooted subprocess on +Linux/Unix platforms, being the first-step in a wider effort toward +privilege separation. + +Eventually, it is expected that the Docker daemon will run restricted +privileges, delegating operations well-audited sub-processes, +each with its own (very limited) scope of Linux capabilities, +virtual network setup, filesystem management, etc. That is, most likely, +pieces of the Docker engine itself will run inside of containers. + +Finally, if you run Docker on a server, it is recommended to run +exclusively Docker in the server, and move all other services within +containers controlled by Docker. Of course, it is fine to keep your +favorite admin tools (probably at least an SSH server), as well as +existing monitoring/supervision processes (e.g., NRPE, collectd, etc). + +## Linux kernel capabilities + +By default, Docker starts containers with a restricted set of +capabilities. What does that mean? + +Capabilities turn the binary "root/non-root" dichotomy into a +fine-grained access control system. Processes (like web servers) that +just need to bind on a port below 1024 do not have to run as root: they +can just be granted the `net_bind_service` capability instead. And there +are many other capabilities, for almost all the specific areas where root +privileges are usually needed. + +This means a lot for container security; let's see why! + +Your average server (bare metal or virtual machine) needs to run a bunch +of processes as root. Those typically include SSH, cron, syslogd; +hardware management tools (e.g., load modules), network configuration +tools (e.g., to handle DHCP, WPA, or VPNs), and much more. A container is +very different, because almost all of those tasks are handled by the +infrastructure around the container: + + - SSH access will typically be managed by a single server running on + the Docker host; + - `cron`, when necessary, should run as a user + process, dedicated and tailored for the app that needs its + scheduling service, rather than as a platform-wide facility; + - log management will also typically be handed to Docker, or by + third-party services like Loggly or Splunk; + - hardware management is irrelevant, meaning that you never need to + run `udevd` or equivalent daemons within + containers; + - network management happens outside of the containers, enforcing + separation of concerns as much as possible, meaning that a container + should never need to perform `ifconfig`, + `route`, or ip commands (except when a container + is specifically engineered to behave like a router or firewall, of + course). + +This means that in most cases, containers will not need "real" root +privileges *at all*. And therefore, containers can run with a reduced +capability set; meaning that "root" within a container has much less +privileges than the real "root". For instance, it is possible to: + + - deny all "mount" operations; + - deny access to raw sockets (to prevent packet spoofing); + - deny access to some filesystem operations, like creating new device + nodes, changing the owner of files, or altering attributes (including + the immutable flag); + - deny module loading; + - and many others. + +This means that even if an intruder manages to escalate to root within a +container, it will be much harder to do serious damage, or to escalate +to the host. + +This won't affect regular web apps; but malicious users will find that +the arsenal at their disposal has shrunk considerably! By default Docker +drops all capabilities except [those +needed](https://github.com/docker/docker/blob/master/daemon/execdriver/native/template/default_template.go), +a whitelist instead of a blacklist approach. You can see a full list of +available capabilities in [Linux +manpages](http://man7.org/linux/man-pages/man7/capabilities.7.html). + +One primary risk with running Docker containers is that the default set +of capabilities and mounts given to a container may provide incomplete +isolation, either independently, or when used in combination with +kernel vulnerabilities. + +Docker supports the addition and removal of capabilities, allowing use +of a non-default profile. This may make Docker more secure through +capability removal, or less secure through the addition of capabilities. +The best practice for users would be to remove all capabilities except +those explicitly required for their processes. + +## Other kernel security features + +Capabilities are just one of the many security features provided by +modern Linux kernels. It is also possible to leverage existing, +well-known systems like TOMOYO, AppArmor, SELinux, GRSEC, etc. with +Docker. + +While Docker currently only enables capabilities, it doesn't interfere +with the other systems. This means that there are many different ways to +harden a Docker host. Here are a few examples. + + - You can run a kernel with GRSEC and PAX. This will add many safety + checks, both at compile-time and run-time; it will also defeat many + exploits, thanks to techniques like address randomization. It doesn't + require Docker-specific configuration, since those security features + apply system-wide, independent of containers. + - If your distribution comes with security model templates for + Docker containers, you can use them out of the box. For instance, we + ship a template that works with AppArmor and Red Hat comes with SELinux + policies for Docker. These templates provide an extra safety net (even + though it overlaps greatly with capabilities). + - You can define your own policies using your favorite access control + mechanism. + +Just like there are many third-party tools to augment Docker containers +with e.g., special network topologies or shared filesystems, you can +expect to see tools to harden existing Docker containers without +affecting Docker's core. + +Recent improvements in Linux namespaces will soon allow to run +full-featured containers without root privileges, thanks to the new user +namespace. This is covered in detail [here]( +http://s3hh.wordpress.com/2013/07/19/creating-and-using-containers-without-privilege/). +Moreover, this will solve the problem caused by sharing filesystems +between host and guest, since the user namespace allows users within +containers (including the root user) to be mapped to other users in the +host system. + +Today, Docker does not directly support user namespaces, but they +may still be utilized by Docker containers on supported kernels, +by directly using the clone syscall, or utilizing the 'unshare' +utility. Using this, some users may find it possible to drop +more capabilities from their process as user namespaces provide +an artificial capabilities set. Likewise, however, this artificial +capabilities set may require use of 'capsh' to restrict the +user-namespace capabilities set when using 'unshare'. + +Eventually, it is expected that Docker will have direct, native support +for user-namespaces, simplifying the process of hardening containers. + +## Conclusions + +Docker containers are, by default, quite secure; especially if you take +care of running your processes inside the containers as non-privileged +users (i.e., non-`root`). + +You can add an extra layer of safety by enabling AppArmor, SELinux, +GRSEC, or your favorite hardening solution. + +Last but not least, if you see interesting security features in other +containerization systems, these are simply kernels features that may +be implemented in Docker as well. We welcome users to submit issues, +pull requests, and communicate via the mailing list. + +References: + +* [Docker Containers: How Secure Are They? (2013)]( +http://blog.docker.com/2013/08/containers-docker-how-secure-are-they/). +* [On the Security of Containers (2014)](https://medium.com/@ewindisch/on-the-security-of-containers-2c60ffe25a9e). diff --git a/docs/articles/systemd.md b/docs/articles/systemd.md new file mode 100644 index 0000000000..1722a279a6 --- /dev/null +++ b/docs/articles/systemd.md @@ -0,0 +1,158 @@ + + +# Control and configure Docker with systemd + +Many Linux distributions use systemd to start the Docker daemon. This document +shows a few examples of how to customise Docker's settings. + +## Starting the Docker daemon + +Once Docker is installed, you will need to start the Docker daemon. + + $ sudo systemctl start docker + # or on older distributions, you may need to use + $ sudo service docker start + +If you want Docker to start at boot, you should also: + + $ sudo systemctl enable docker + # or on older distributions, you may need to use + $ sudo chkconfig docker on + +## Custom Docker daemon options + +There are a number of ways to configure the daemon flags and environment variables +for your Docker daemon. + +The recommended way is to use a systemd drop-in file. These are local files in +the `/etc/systemd/system/docker.service.d` directory. This could also be +`/etc/systemd/system/docker.service`, which also works for overriding the +defaults from `/lib/systemd/system/docker.service`. + +However, if you had previously used a package which had an `EnvironmentFile` +(often pointing to `/etc/sysconfig/docker`) then for backwards compatibility, +you drop a file in the `/etc/systemd/system/docker.service.d` +directory including the following: + + [Service] + EnvironmentFile=-/etc/sysconfig/docker + EnvironmentFile=-/etc/sysconfig/docker-storage + EnvironmentFile=-/etc/sysconfig/docker-network + ExecStart= + ExecStart=/usr/bin/docker daemon -H fd:// $OPTIONS \ + $DOCKER_STORAGE_OPTIONS \ + $DOCKER_NETWORK_OPTIONS \ + $BLOCK_REGISTRY \ + $INSECURE_REGISTRY + +To check if the `docker.service` uses an `EnvironmentFile`: + + $ sudo systemctl show docker | grep EnvironmentFile + EnvironmentFile=-/etc/sysconfig/docker (ignore_errors=yes) + +Alternatively, find out where the service file is located: + + $ sudo systemctl status docker | grep Loaded + Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled) + $ sudo grep EnvironmentFile /usr/lib/systemd/system/docker.service + EnvironmentFile=-/etc/sysconfig/docker + +You can customize the Docker daemon options using override files as explained in the +[HTTP Proxy example](#http-proxy) below. The files located in `/usr/lib/systemd/system` +or `/lib/systemd/system` contain the default options and should not be edited. + +### Runtime directory and storage driver + +You may want to control the disk space used for Docker images, containers +and volumes by moving it to a separate partition. + +In this example, we'll assume that your `docker.service` file looks something like: + + [Unit] + Description=Docker Application Container Engine + Documentation=https://docs.docker.com + After=network.target docker.socket + Requires=docker.socket + + [Service] + Type=notify + ExecStart=/usr/bin/docker daemon -H fd:// + LimitNOFILE=1048576 + LimitNPROC=1048576 + + [Install] + Also=docker.socket + +This will allow us to add extra flags via a drop-in file (mentioned above) by +placing a file containing the following in the `/etc/systemd/system/docker.service.d` +directory: + + [Service] + ExecStart= + ExecStart=/usr/bin/docker daemon -H fd:// --graph /mnt/docker-data --storage-driver btrfs + +You can also set other environment variables in this file, for example, the +`HTTP_PROXY` environment variables described below. + +To modify the ExecStart configuration, specify an empty configuration followed +by a new configuration as follows: + + [Service] + ExecStart= + ExecStart=/usr/bin/docker daemon -H fd:// --bip=172.17.42.1/16 + +If you fail to specify an empty configuration, Docker reports an error such as: + + docker.service has more than one ExecStart= setting, which is only allowed for Type=oneshot services. Refusing. + +### HTTP proxy + +This example overrides the default `docker.service` file. + +If you are behind a HTTP proxy server, for example in corporate settings, +you will need to add this configuration in the Docker systemd service file. + +First, create a systemd drop-in directory for the docker service: + + mkdir /etc/systemd/system/docker.service.d + +Now create a file called `/etc/systemd/system/docker.service.d/http-proxy.conf` +that adds the `HTTP_PROXY` environment variable: + + [Service] + Environment="HTTP_PROXY=http://proxy.example.com:80/" + +If you have internal Docker registries that you need to contact without +proxying you can specify them via the `NO_PROXY` environment variable: + + Environment="HTTP_PROXY=http://proxy.example.com:80/" "NO_PROXY=localhost,127.0.0.0/8,docker-registry.somecorporation.com" + +Flush changes: + + $ sudo systemctl daemon-reload + +Verify that the configuration has been loaded: + + $ sudo systemctl show docker --property Environment + Environment=HTTP_PROXY=http://proxy.example.com:80/ + +Restart Docker: + + $ sudo systemctl restart docker + +## Manually creating the systemd unit files + +When installing the binary without a package, you may want +to integrate Docker with systemd. For this, simply install the two unit files +(service and socket) from [the github +repository](https://github.com/docker/docker/tree/master/contrib/init/systemd) +to `/etc/systemd/system`. diff --git a/docs/articles/using_supervisord.md b/docs/articles/using_supervisord.md new file mode 100644 index 0000000000..93c288b0b3 --- /dev/null +++ b/docs/articles/using_supervisord.md @@ -0,0 +1,118 @@ + + +# Using Supervisor with Docker + +> **Note**: +> - **If you don't like sudo** then see [*Giving non-root +> access*](../installation/binaries.md#giving-non-root-access) + +Traditionally a Docker container runs a single process when it is +launched, for example an Apache daemon or a SSH server daemon. Often +though you want to run more than one process in a container. There are a +number of ways you can achieve this ranging from using a simple Bash +script as the value of your container's `CMD` instruction to installing +a process management tool. + +In this example we're going to make use of the process management tool, +[Supervisor](http://supervisord.org/), to manage multiple processes in +our container. Using Supervisor allows us to better control, manage, and +restart the processes we want to run. To demonstrate this we're going to +install and manage both an SSH daemon and an Apache daemon. + +## Creating a Dockerfile + +Let's start by creating a basic `Dockerfile` for our +new image. + + FROM ubuntu:13.04 + MAINTAINER examples@docker.com + +## Installing Supervisor + +We can now install our SSH and Apache daemons as well as Supervisor in +our container. + + RUN apt-get update && apt-get install -y openssh-server apache2 supervisor + RUN mkdir -p /var/lock/apache2 /var/run/apache2 /var/run/sshd /var/log/supervisor + +Here we're installing the `openssh-server`, +`apache2` and `supervisor` +(which provides the Supervisor daemon) packages. We're also creating four +new directories that are needed to run our SSH daemon and Supervisor. + +## Adding Supervisor's configuration file + +Now let's add a configuration file for Supervisor. The default file is +called `supervisord.conf` and is located in +`/etc/supervisor/conf.d/`. + + COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf + +Let's see what is inside our `supervisord.conf` +file. + + [supervisord] + nodaemon=true + + [program:sshd] + command=/usr/sbin/sshd -D + + [program:apache2] + command=/bin/bash -c "source /etc/apache2/envvars && exec /usr/sbin/apache2 -DFOREGROUND" + +The `supervisord.conf` configuration file contains +directives that configure Supervisor and the processes it manages. The +first block `[supervisord]` provides configuration +for Supervisor itself. We're using one directive, `nodaemon` +which tells Supervisor to run interactively rather than +daemonize. + +The next two blocks manage the services we wish to control. Each block +controls a separate process. The blocks contain a single directive, +`command`, which specifies what command to run to +start each process. + +## Exposing ports and running Supervisor + +Now let's finish our `Dockerfile` by exposing some +required ports and specifying the `CMD` instruction +to start Supervisor when our container launches. + + EXPOSE 22 80 + CMD ["/usr/bin/supervisord"] + +Here We've exposed ports 22 and 80 on the container and we're running +the `/usr/bin/supervisord` binary when the container +launches. + +## Building our image + +We can now build our new image. + + $ docker build -t /supervisord . + +## Running our Supervisor container + +Once We've got a built image we can launch a container from it. + + $ docker run -p 22 -p 80 -t -i /supervisord + 2013-11-25 18:53:22,312 CRIT Supervisor running as root (no user in config file) + 2013-11-25 18:53:22,312 WARN Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing + 2013-11-25 18:53:22,342 INFO supervisord started with pid 1 + 2013-11-25 18:53:23,346 INFO spawned: 'sshd' with pid 6 + 2013-11-25 18:53:23,349 INFO spawned: 'apache2' with pid 7 + . . . + +We've launched a new container interactively using the `docker run` command. +That container has run Supervisor and launched the SSH and Apache daemons with +it. We've specified the `-p` flag to expose ports 22 and 80. From here we can +now identify the exposed ports and connect to one or both of the SSH and Apache +daemons. diff --git a/docs/examples/apt-cacher-ng.Dockerfile b/docs/examples/apt-cacher-ng.Dockerfile new file mode 100644 index 0000000000..d1f76572b9 --- /dev/null +++ b/docs/examples/apt-cacher-ng.Dockerfile @@ -0,0 +1,15 @@ +# +# Build: docker build -t apt-cacher . +# Run: docker run -d -p 3142:3142 --name apt-cacher-run apt-cacher +# +# and then you can run containers with: +# docker run -t -i --rm -e http_proxy http://dockerhost:3142/ debian bash +# +FROM ubuntu +MAINTAINER SvenDowideit@docker.com + +VOLUME ["/var/cache/apt-cacher-ng"] +RUN apt-get update && apt-get install -y apt-cacher-ng + +EXPOSE 3142 +CMD chmod 777 /var/cache/apt-cacher-ng && /etc/init.d/apt-cacher-ng start && tail -f /var/log/apt-cacher-ng/* diff --git a/docs/examples/apt-cacher-ng.md b/docs/examples/apt-cacher-ng.md new file mode 100644 index 0000000000..a8e2957c5f --- /dev/null +++ b/docs/examples/apt-cacher-ng.md @@ -0,0 +1,113 @@ + + +# Dockerizing an apt-cacher-ng service + +> **Note**: +> - **If you don't like sudo** then see [*Giving non-root +> access*](../installation/binaries.md#giving-non-root-access). +> - **If you're using OS X or docker via TCP** then you shouldn't use +> sudo. + +When you have multiple Docker servers, or build unrelated Docker +containers which can't make use of the Docker build cache, it can be +useful to have a caching proxy for your packages. This container makes +the second download of any package almost instant. + +Use the following Dockerfile: + + # + # Build: docker build -t apt-cacher . + # Run: docker run -d -p 3142:3142 --name apt-cacher-run apt-cacher + # + # and then you can run containers with: + # docker run -t -i --rm -e http_proxy http://dockerhost:3142/ debian bash + # + FROM ubuntu + MAINTAINER SvenDowideit@docker.com + + VOLUME ["/var/cache/apt-cacher-ng"] + RUN apt-get update && apt-get install -y apt-cacher-ng + + EXPOSE 3142 + CMD chmod 777 /var/cache/apt-cacher-ng && /etc/init.d/apt-cacher-ng start && tail -f /var/log/apt-cacher-ng/* + +To build the image using: + + $ docker build -t eg_apt_cacher_ng . + +Then run it, mapping the exposed port to one on the host + + $ docker run -d -p 3142:3142 --name test_apt_cacher_ng eg_apt_cacher_ng + +To see the logfiles that are `tailed` in the default command, you can +use: + + $ docker logs -f test_apt_cacher_ng + +To get your Debian-based containers to use the proxy, you can do one of +three things + +1. Add an apt Proxy setting + `echo 'Acquire::http { Proxy "http://dockerhost:3142"; };' >> /etc/apt/conf.d/01proxy` +2. Set an environment variable: + `http_proxy=http://dockerhost:3142/` +3. Change your `sources.list` entries to start with + `http://dockerhost:3142/` + +**Option 1** injects the settings safely into your apt configuration in +a local version of a common base: + + FROM ubuntu + RUN echo 'Acquire::http { Proxy "http://dockerhost:3142"; };' >> /etc/apt/apt.conf.d/01proxy + RUN apt-get update && apt-get install -y vim git + + # docker build -t my_ubuntu . + +**Option 2** is good for testing, but will break other HTTP clients +which obey `http_proxy`, such as `curl`, `wget` and others: + + $ docker run --rm -t -i -e http_proxy=http://dockerhost:3142/ debian bash + +**Option 3** is the least portable, but there will be times when you +might need to do it and you can do it from your `Dockerfile` +too. + +Apt-cacher-ng has some tools that allow you to manage the repository, +and they can be used by leveraging the `VOLUME` +instruction, and the image we built to run the service: + + $ docker run --rm -t -i --volumes-from test_apt_cacher_ng eg_apt_cacher_ng bash + + $$ /usr/lib/apt-cacher-ng/distkill.pl + Scanning /var/cache/apt-cacher-ng, please wait... + Found distributions: + bla, taggedcount: 0 + 1. precise-security (36 index files) + 2. wheezy (25 index files) + 3. precise-updates (36 index files) + 4. precise (36 index files) + 5. wheezy-updates (18 index files) + + Found architectures: + 6. amd64 (36 index files) + 7. i386 (24 index files) + + WARNING: The removal action may wipe out whole directories containing + index files. Select d to see detailed list. + + (Number nn: tag distribution or architecture nn; 0: exit; d: show details; r: remove tagged; q: quit): q + +Finally, clean up after your test by stopping and removing the +container, and then removing the image. + + $ docker stop test_apt_cacher_ng + $ docker rm test_apt_cacher_ng + $ docker rmi eg_apt_cacher_ng diff --git a/docs/examples/couchdb_data_volumes.md b/docs/examples/couchdb_data_volumes.md new file mode 100644 index 0000000000..5493af839d --- /dev/null +++ b/docs/examples/couchdb_data_volumes.md @@ -0,0 +1,49 @@ + + +# Dockerizing a CouchDB service + +> **Note**: +> - **If you don't like sudo** then see [*Giving non-root +> access*](../installation/binaries.md#giving-non-root-access) + +Here's an example of using data volumes to share the same data between +two CouchDB containers. This could be used for hot upgrades, testing +different versions of CouchDB on the same data, etc. + +## Create first database + +Note that we're marking `/var/lib/couchdb` as a data volume. + + $ COUCH1=$(docker run -d -p 5984 -v /var/lib/couchdb shykes/couchdb:2013-05-03) + +## Add data to the first database + +We're assuming your Docker host is reachable at `localhost`. If not, +replace `localhost` with the public IP of your Docker host. + + $ HOST=localhost + $ URL="http://$HOST:$(docker port $COUCH1 5984 | grep -o '[1-9][0-9]*$')/_utils/" + $ echo "Navigate to $URL in your browser, and use the couch interface to add data" + +## Create second database + +This time, we're requesting shared access to `$COUCH1`'s volumes. + + $ COUCH2=$(docker run -d -p 5984 --volumes-from $COUCH1 shykes/couchdb:2013-05-03) + +## Browse data on the second database + + $ HOST=localhost + $ URL="http://$HOST:$(docker port $COUCH2 5984 | grep -o '[1-9][0-9]*$')/_utils/" + $ echo "Navigate to $URL in your browser. You should see the same data as in the first database"'!' + +Congratulations, you are now running two Couchdb containers, completely +isolated from each other *except* for their data. diff --git a/docs/examples/index.md b/docs/examples/index.md new file mode 100644 index 0000000000..907d5aaede --- /dev/null +++ b/docs/examples/index.md @@ -0,0 +1,23 @@ + + +# Examples + +This section contains the following: + +* [Dockerizing MongoDB](mongodb.md) +* [Dockerizing PostgreSQL](postgresql_service.md) +* [Dockerizing a CouchDB service](couchdb_data_volumes.md) +* [Dockerizing a Node.js web app](nodejs_web_app.md) +* [Dockerizing a Redis service](running_redis_service.md) +* [Dockerizing an apt-cacher-ng service](apt-cacher-ng.md) +* [Dockerizing applications: A 'Hello world'](../userguide/dockerizing.md) diff --git a/docs/examples/mongodb.md b/docs/examples/mongodb.md new file mode 100644 index 0000000000..222178b992 --- /dev/null +++ b/docs/examples/mongodb.md @@ -0,0 +1,177 @@ + + +# Dockerizing MongoDB + +## Introduction + +In this example, we are going to learn how to build a Docker image with +MongoDB pre-installed. We'll also see how to `push` that image to the +[Docker Hub registry](https://hub.docker.com) and share it with others! + +> **Note:** This guide will show the mechanics of building a MongoDB container, but +> you will probably want to use the official image on [Docker Hub]( https://registry.hub.docker.com/_/mongo/) + +Using Docker and containers for deploying [MongoDB](https://www.mongodb.org/) +instances will bring several benefits, such as: + + - Easy to maintain, highly configurable MongoDB instances; + - Ready to run and start working within milliseconds; + - Based on globally accessible and shareable images. + +> **Note:** +> +> If you do **_not_** like `sudo`, you might want to check out: +> [*Giving non-root access*](../installation/binaries.md#giving-non-root-access). + +## Creating a Dockerfile for MongoDB + +Let's create our `Dockerfile` and start building it: + + $ nano Dockerfile + +Although optional, it is handy to have comments at the beginning of a +`Dockerfile` explaining its purpose: + + # Dockerizing MongoDB: Dockerfile for building MongoDB images + # Based on ubuntu:latest, installs MongoDB following the instructions from: + # http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/ + +> **Tip:** `Dockerfile`s are flexible. However, they need to follow a certain +> format. The first item to be defined is the name of an image, which becomes +> the *parent* of your *Dockerized MongoDB* image. + +We will build our image using the latest version of Ubuntu from the +[Docker Hub Ubuntu](https://registry.hub.docker.com/_/ubuntu/) repository. + + # Format: FROM repository[:version] + FROM ubuntu:latest + +Continuing, we will declare the `MAINTAINER` of the `Dockerfile`: + + # Format: MAINTAINER Name + MAINTAINER M.Y. Name + +> **Note:** Although Ubuntu systems have MongoDB packages, they are likely to +> be outdated. Therefore in this example, we will use the official MongoDB +> packages. + +We will begin with importing the MongoDB public GPG key. We will also create +a MongoDB repository file for the package manager. + + # Installation: + # Import MongoDB public GPG key AND create a MongoDB list file + RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10 + RUN echo "deb http://repo.mongodb.org/apt/ubuntu "$(lsb_release -sc)"/mongodb-org/3.0 multiverse" | tee /etc/apt/sources.list.d/mongodb-org-3.0.list + +After this initial preparation we can update our packages and install MongoDB. + + # Update apt-get sources AND install MongoDB + RUN apt-get update && apt-get install -y mongodb-org + +> **Tip:** You can install a specific version of MongoDB by using a list +> of required packages with versions, e.g.: +> +> RUN apt-get update && apt-get install -y mongodb-org=3.0.1 mongodb-org-server=3.0.1 mongodb-org-shell=3.0.1 mongodb-org-mongos=3.0.1 mongodb-org-tools=3.0.1 + +MongoDB requires a data directory. Let's create it as the final step of our +installation instructions. + + # Create the MongoDB data directory + RUN mkdir -p /data/db + +Lastly we set the `ENTRYPOINT` which will tell Docker to run `mongod` inside +the containers launched from our MongoDB image. And for ports, we will use +the `EXPOSE` instruction. + + # Expose port 27017 from the container to the host + EXPOSE 27017 + + # Set usr/bin/mongod as the dockerized entry-point application + ENTRYPOINT ["/usr/bin/mongod"] + +Now save the file and let's build our image. + +> **Note:** +> +> The full version of this `Dockerfile` can be found [here](https://github.com/docker/docker/blob/master/docs/examples/mongodb/Dockerfile). + +## Building the MongoDB Docker image + +With our `Dockerfile`, we can now build the MongoDB image using Docker. Unless +experimenting, it is always a good practice to tag Docker images by passing the +`--tag` option to `docker build` command. + + # Format: docker build --tag/-t / . + # Example: + $ docker build --tag my/repo . + +Once this command is issued, Docker will go through the `Dockerfile` and build +the image. The final image will be tagged `my/repo`. + +## Pushing the MongoDB image to Docker Hub + +All Docker image repositories can be hosted and shared on +[Docker Hub](https://hub.docker.com) with the `docker push` command. For this, +you need to be logged-in. + + # Log-in + $ docker login + Username: + .. + + # Push the image + # Format: docker push / + $ docker push my/repo + The push refers to a repository [my/repo] (len: 1) + Sending image list + Pushing repository my/repo (1 tags) + .. + +## Using the MongoDB image + +Using the MongoDB image we created, we can run one or more MongoDB instances +as daemon process(es). + + # Basic way + # Usage: docker run --name -d / + $ docker run -p 27017:27017 --name mongo_instance_001 -d my/repo + + # Dockerized MongoDB, lean and mean! + # Usage: docker run --name -d / --noprealloc --smallfiles + $ docker run -p 27017:27017 --name mongo_instance_001 -d my/repo --smallfiles + + # Checking out the logs of a MongoDB container + # Usage: docker logs + $ docker logs mongo_instance_001 + + # Playing with MongoDB + # Usage: mongo --port + $ mongo --port 27017 + + # If using docker-machine + # Usage: mongo --port --host + $ mongo --port 27017 --host 192.168.59.103 + +> **Tip:** +If you want to run two containers on the same engine, then you will need to map +the exposed port to two different ports on the host + + # Start two containers and map the ports + $ docker run -p 28001:27017 --name mongo_instance_001 -d my/repo + $ docker run -p 28002:27017 --name mongo_instance_002 -d my/repo + + # Now you can connect to each MongoDB instance on the two ports + $ mongo --port 28001 + $ mongo --port 28002 + + - [Linking containers](../userguide/networking/default_network/dockerlinks.md) + - [Cross-host linking containers](../articles/ambassador_pattern_linking.md) + - [Creating an Automated Build](https://docs.docker.com/docker-hub/builds/) diff --git a/docs/examples/mongodb/Dockerfile b/docs/examples/mongodb/Dockerfile new file mode 100644 index 0000000000..3513da4716 --- /dev/null +++ b/docs/examples/mongodb/Dockerfile @@ -0,0 +1,22 @@ +# Dockerizing MongoDB: Dockerfile for building MongoDB images +# Based on ubuntu:latest, installs MongoDB following the instructions from: +# http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/ + +FROM ubuntu:latest +MAINTAINER Docker + +# Installation: +# Import MongoDB public GPG key AND create a MongoDB list file +RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10 +RUN echo "deb http://repo.mongodb.org/apt/ubuntu "$(lsb_release -sc)"/mongodb-org/3.0 multiverse" | tee /etc/apt/sources.list.d/mongodb-org-3.0.list +# Update apt-get sources AND install MongoDB +RUN apt-get update && apt-get install -y mongodb-org + +# Create the MongoDB data directory +RUN mkdir -p /data/db + +# Expose port #27017 from the container to the host +EXPOSE 27017 + +# Set /usr/bin/mongod as the dockerized entry-point application +ENTRYPOINT ["/usr/bin/mongod"] diff --git a/docs/examples/nodejs_web_app.md b/docs/examples/nodejs_web_app.md new file mode 100644 index 0000000000..a1aa004189 --- /dev/null +++ b/docs/examples/nodejs_web_app.md @@ -0,0 +1,196 @@ + + +# Dockerizing a Node.js web app + +> **Note**: +> - **If you don't like sudo** then see [*Giving non-root +> access*](../installation/binaries.md#giving-non-root-access) + +The goal of this example is to show you how you can build your own +Docker images from a parent image using a `Dockerfile` +. We will do that by making a simple Node.js hello world web +application running on CentOS. You can get the full source code at[https://github.com/enokd/docker-node-hello/](https://github.com/enokd/docker-node-hello/). + +## Create Node.js app + +First, create a directory `src` where all the files +would live. Then create a `package.json` file that +describes your app and its dependencies: + + { + "name": "docker-centos-hello", + "private": true, + "version": "0.0.1", + "description": "Node.js Hello world app on CentOS using docker", + "author": "Daniel Gasienica ", + "dependencies": { + "express": "3.2.4" + } + } + +Then, create an `index.js` file that defines a web +app using the [Express.js](http://expressjs.com/) framework: + + var express = require('express'); + + // Constants + var PORT = 8080; + + // App + var app = express(); + app.get('/', function (req, res) { + res.send('Hello world\n'); + }); + + app.listen(PORT); + console.log('Running on http://localhost:' + PORT); + +In the next steps, we'll look at how you can run this app inside a +CentOS container using Docker. First, you'll need to build a Docker +image of your app. + +## Creating a Dockerfile + +Create an empty file called `Dockerfile`: + + touch Dockerfile + +Open the `Dockerfile` in your favorite text editor + +Define the parent image you want to use to build your own image on +top of. Here, we'll use +[CentOS](https://registry.hub.docker.com/_/centos/) (tag: `centos6`) +available on the [Docker Hub](https://hub.docker.com/): + + FROM centos:centos6 + +Since we're building a Node.js app, you'll have to install Node.js as +well as npm on your CentOS image. Node.js is required to run your app +and npm is required to install your app's dependencies defined in +`package.json`. To install the right package for +CentOS, we'll use the instructions from the [Node.js wiki]( +https://github.com/joyent/node/wiki/Installing-Node.js- +via-package-manager#rhelcentosscientific-linux-6): + + # Enable Extra Packages for Enterprise Linux (EPEL) for CentOS + RUN yum install -y epel-release + # Install Node.js and npm + RUN yum install -y nodejs npm + +To bundle your app's source code inside the Docker image, use the `COPY` +instruction: + + # Bundle app source + COPY . /src + +Install your app dependencies using the `npm` binary: + + # Install app dependencies + RUN cd /src; npm install + +Your app binds to port `8080` so you'll use the `EXPOSE` instruction to have +it mapped by the `docker` daemon: + + EXPOSE 8080 + +Last but not least, define the command to run your app using `CMD` which +defines your runtime, i.e. `node`, and the path to our app, i.e. `src/index.js` +(see the step where we added the source to the container): + + CMD ["node", "/src/index.js"] + +Your `Dockerfile` should now look like this: + + FROM centos:centos6 + + # Enable Extra Packages for Enterprise Linux (EPEL) for CentOS + RUN yum install -y epel-release + # Install Node.js and npm + RUN yum install -y nodejs npm + + # Bundle app source + COPY . /src + # Install app dependencies + RUN cd /src; npm install + + EXPOSE 8080 + CMD ["node", "/src/index.js"] + +## Building your image + +Go to the directory that has your `Dockerfile` and run the following command +to build a Docker image. The `-t` flag lets you tag your image so it's easier +to find later using the `docker images` command: + + $ docker build -t /centos-node-hello . + +Your image will now be listed by Docker: + + $ docker images + + # Example + REPOSITORY TAG ID CREATED + centos centos6 539c0211cd76 8 weeks ago + /centos-node-hello latest d64d3505b0d2 2 hours ago + +## Run the image + +Running your image with `-d` runs the container in detached mode, leaving the +container running in the background. The `-p` flag redirects a public port to +a private port in the container. Run the image you previously built: + + $ docker run -p 49160:8080 -d /centos-node-hello + +Print the output of your app: + + # Get container ID + $ docker ps + + # Print app output + $ docker logs + + # Example + Running on http://localhost:8080 + +## Test + +To test your app, get the port of your app that Docker mapped: + + $ docker ps + + # Example + ID IMAGE COMMAND ... PORTS + ecce33b30ebf /centos-node-hello:latest node /src/index.js 49160->8080 + +In the example above, Docker mapped the `8080` port of the container to `49160`. + +Now you can call your app using `curl` (install if needed via: +`sudo apt-get install curl`): + + $ curl -i localhost:49160 + + HTTP/1.1 200 OK + X-Powered-By: Express + Content-Type: text/html; charset=utf-8 + Content-Length: 12 + Date: Sun, 02 Jun 2013 03:53:22 GMT + Connection: keep-alive + + Hello world + +If you use Docker Machine on OS X, the port is actually mapped to the Docker +host VM, and you should use the following command: + + $ curl $(docker-machine ip VM_NAME):49160 + +We hope this tutorial helped you get up and running with Node.js and +CentOS on Docker. You can get the full source code at +[https://github.com/enokd/docker-node-hello/](https://github.com/enokd/docker-node-hello/). diff --git a/docs/examples/postgresql_service.Dockerfile b/docs/examples/postgresql_service.Dockerfile new file mode 100644 index 0000000000..d5767c9384 --- /dev/null +++ b/docs/examples/postgresql_service.Dockerfile @@ -0,0 +1,49 @@ +# +# example Dockerfile for https://docs.docker.com/examples/postgresql_service/ +# + +FROM ubuntu +MAINTAINER SvenDowideit@docker.com + +# Add the PostgreSQL PGP key to verify their Debian packages. +# It should be the same key as https://www.postgresql.org/media/keys/ACCC4CF8.asc +RUN apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys B97B0AFCAA1A47F044F244A07FCC7D46ACCC4CF8 + +# Add PostgreSQL's repository. It contains the most recent stable release +# of PostgreSQL, ``9.3``. +RUN echo "deb http://apt.postgresql.org/pub/repos/apt/ precise-pgdg main" > /etc/apt/sources.list.d/pgdg.list + +# Install ``python-software-properties``, ``software-properties-common`` and PostgreSQL 9.3 +# There are some warnings (in red) that show up during the build. You can hide +# them by prefixing each apt-get statement with DEBIAN_FRONTEND=noninteractive +RUN apt-get update && apt-get install -y python-software-properties software-properties-common postgresql-9.3 postgresql-client-9.3 postgresql-contrib-9.3 + +# Note: The official Debian and Ubuntu images automatically ``apt-get clean`` +# after each ``apt-get`` + +# Run the rest of the commands as the ``postgres`` user created by the ``postgres-9.3`` package when it was ``apt-get installed`` +USER postgres + +# Create a PostgreSQL role named ``docker`` with ``docker`` as the password and +# then create a database `docker` owned by the ``docker`` role. +# Note: here we use ``&&\`` to run commands one after the other - the ``\`` +# allows the RUN command to span multiple lines. +RUN /etc/init.d/postgresql start &&\ + psql --command "CREATE USER docker WITH SUPERUSER PASSWORD 'docker';" &&\ + createdb -O docker docker + +# Adjust PostgreSQL configuration so that remote connections to the +# database are possible. +RUN echo "host all all 0.0.0.0/0 md5" >> /etc/postgresql/9.3/main/pg_hba.conf + +# And add ``listen_addresses`` to ``/etc/postgresql/9.3/main/postgresql.conf`` +RUN echo "listen_addresses='*'" >> /etc/postgresql/9.3/main/postgresql.conf + +# Expose the PostgreSQL port +EXPOSE 5432 + +# Add VOLUMEs to allow backup of config, logs and databases +VOLUME ["/etc/postgresql", "/var/log/postgresql", "/var/lib/postgresql"] + +# Set the default command to run when starting the container +CMD ["/usr/lib/postgresql/9.3/bin/postgres", "-D", "/var/lib/postgresql/9.3/main", "-c", "config_file=/etc/postgresql/9.3/main/postgresql.conf"] diff --git a/docs/examples/postgresql_service.md b/docs/examples/postgresql_service.md new file mode 100644 index 0000000000..9c0938d108 --- /dev/null +++ b/docs/examples/postgresql_service.md @@ -0,0 +1,153 @@ + + +# Dockerizing PostgreSQL + +> **Note**: +> - **If you don't like sudo** then see [*Giving non-root +> access*](../installation/binaries.md#giving-non-root-access) + +## Installing PostgreSQL on Docker + +Assuming there is no Docker image that suits your needs on the [Docker +Hub](http://hub.docker.com), you can create one yourself. + +Start by creating a new `Dockerfile`: + +> **Note**: +> This PostgreSQL setup is for development-only purposes. Refer to the +> PostgreSQL documentation to fine-tune these settings so that it is +> suitably secure. + + # + # example Dockerfile for https://docs.docker.com/examples/postgresql_service/ + # + + FROM ubuntu + MAINTAINER SvenDowideit@docker.com + + # Add the PostgreSQL PGP key to verify their Debian packages. + # It should be the same key as https://www.postgresql.org/media/keys/ACCC4CF8.asc + RUN apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys B97B0AFCAA1A47F044F244A07FCC7D46ACCC4CF8 + + # Add PostgreSQL's repository. It contains the most recent stable release + # of PostgreSQL, ``9.3``. + RUN echo "deb http://apt.postgresql.org/pub/repos/apt/ precise-pgdg main" > /etc/apt/sources.list.d/pgdg.list + + # Install ``python-software-properties``, ``software-properties-common`` and PostgreSQL 9.3 + # There are some warnings (in red) that show up during the build. You can hide + # them by prefixing each apt-get statement with DEBIAN_FRONTEND=noninteractive + RUN apt-get update && apt-get install -y python-software-properties software-properties-common postgresql-9.3 postgresql-client-9.3 postgresql-contrib-9.3 + + # Note: The official Debian and Ubuntu images automatically ``apt-get clean`` + # after each ``apt-get`` + + # Run the rest of the commands as the ``postgres`` user created by the ``postgres-9.3`` package when it was ``apt-get installed`` + USER postgres + + # Create a PostgreSQL role named ``docker`` with ``docker`` as the password and + # then create a database `docker` owned by the ``docker`` role. + # Note: here we use ``&&\`` to run commands one after the other - the ``\`` + # allows the RUN command to span multiple lines. + RUN /etc/init.d/postgresql start &&\ + psql --command "CREATE USER docker WITH SUPERUSER PASSWORD 'docker';" &&\ + createdb -O docker docker + + # Adjust PostgreSQL configuration so that remote connections to the + # database are possible. + RUN echo "host all all 0.0.0.0/0 md5" >> /etc/postgresql/9.3/main/pg_hba.conf + + # And add ``listen_addresses`` to ``/etc/postgresql/9.3/main/postgresql.conf`` + RUN echo "listen_addresses='*'" >> /etc/postgresql/9.3/main/postgresql.conf + + # Expose the PostgreSQL port + EXPOSE 5432 + + # Add VOLUMEs to allow backup of config, logs and databases + VOLUME ["/etc/postgresql", "/var/log/postgresql", "/var/lib/postgresql"] + + # Set the default command to run when starting the container + CMD ["/usr/lib/postgresql/9.3/bin/postgres", "-D", "/var/lib/postgresql/9.3/main", "-c", "config_file=/etc/postgresql/9.3/main/postgresql.conf"] + +Build an image from the Dockerfile assign it a name. + + $ docker build -t eg_postgresql . + +And run the PostgreSQL server container (in the foreground): + + $ docker run --rm -P --name pg_test eg_postgresql + +There are 2 ways to connect to the PostgreSQL server. We can use [*Link +Containers*](../userguide/networking/default_network/dockerlinks.md), or we can access it from our host +(or the network). + +> **Note**: +> The `--rm` removes the container and its image when +> the container exits successfully. + +### Using container linking + +Containers can be linked to another container's ports directly using +`-link remote_name:local_alias` in the client's +`docker run`. This will set a number of environment +variables that can then be used to connect: + + $ docker run --rm -t -i --link pg_test:pg eg_postgresql bash + + postgres@7ef98b1b7243:/$ psql -h $PG_PORT_5432_TCP_ADDR -p $PG_PORT_5432_TCP_PORT -d docker -U docker --password + +### Connecting from your host system + +Assuming you have the postgresql-client installed, you can use the +host-mapped port to test as well. You need to use `docker ps` +to find out what local host port the container is mapped to +first: + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 5e24362f27f6 eg_postgresql:latest /usr/lib/postgresql/ About an hour ago Up About an hour 0.0.0.0:49153->5432/tcp pg_test + $ psql -h localhost -p 49153 -d docker -U docker --password + +### Testing the database + +Once you have authenticated and have a `docker =#` +prompt, you can create a table and populate it. + + psql (9.3.1) + Type "help" for help. + + $ docker=# CREATE TABLE cities ( + docker(# name varchar(80), + docker(# location point + docker(# ); + CREATE TABLE + $ docker=# INSERT INTO cities VALUES ('San Francisco', '(-194.0, 53.0)'); + INSERT 0 1 + $ docker=# select * from cities; + name | location + ---------------+----------- + San Francisco | (-194,53) + (1 row) + +### Using the container volumes + +You can use the defined volumes to inspect the PostgreSQL log files and +to backup your configuration and data: + + $ docker run --rm --volumes-from pg_test -t -i busybox sh + + / # ls + bin etc lib linuxrc mnt proc run sys usr + dev home lib64 media opt root sbin tmp var + / # ls /etc/postgresql/9.3/main/ + environment pg_hba.conf postgresql.conf + pg_ctl.conf pg_ident.conf start.conf + /tmp # ls /var/log + ldconfig postgresql diff --git a/docs/examples/running_redis_service.md b/docs/examples/running_redis_service.md new file mode 100644 index 0000000000..d8b673bdcd --- /dev/null +++ b/docs/examples/running_redis_service.md @@ -0,0 +1,89 @@ + + +# Dockerizing a Redis service + +Very simple, no frills, Redis service attached to a web application +using a link. + +## Create a Docker container for Redis + +Firstly, we create a `Dockerfile` for our new Redis +image. + + FROM ubuntu:14.04 + RUN apt-get update && apt-get install -y redis-server + EXPOSE 6379 + ENTRYPOINT ["/usr/bin/redis-server"] + +Next we build an image from our `Dockerfile`. +Replace `` with your own user name. + + $ docker build -t /redis . + +## Run the service + +Use the image we've just created and name your container `redis`. + +Running the service with `-d` runs the container in detached mode, leaving +the container running in the background. + +Importantly, we're not exposing any ports on our container. Instead +we're going to use a container link to provide access to our Redis +database. + + $ docker run --name redis -d /redis + +## Create your web application container + +Next we can create a container for our application. We're going to use +the `-link` flag to create a link to the `redis` container we've just +created with an alias of `db`. This will create a secure tunnel to the +`redis` container and expose the Redis instance running inside that +container to only this container. + + $ docker run --link redis:db -i -t ubuntu:14.04 /bin/bash + +Once inside our freshly created container we need to install Redis to +get the `redis-cli` binary to test our connection. + + $ sudo apt-get update + $ sudo apt-get install redis-server + $ sudo service redis-server stop + +As we've used the `--link redis:db` option, Docker +has created some environment variables in our web application container. + + $ env | grep DB_ + + # Should return something similar to this with your values + DB_NAME=/violet_wolf/db + DB_PORT_6379_TCP_PORT=6379 + DB_PORT=tcp://172.17.0.33:6379 + DB_PORT_6379_TCP=tcp://172.17.0.33:6379 + DB_PORT_6379_TCP_ADDR=172.17.0.33 + DB_PORT_6379_TCP_PROTO=tcp + +We can see that we've got a small list of environment variables prefixed +with `DB`. The `DB` comes from the link alias specified when we launched +the container. Let's use the `DB_PORT_6379_TCP_ADDR` variable to connect to +our Redis container. + + $ redis-cli -h $DB_PORT_6379_TCP_ADDR + $ redis 172.17.0.33:6379> + $ redis 172.17.0.33:6379> set docker awesome + OK + $ redis 172.17.0.33:6379> get docker + "awesome" + $ redis 172.17.0.33:6379> exit + +We could easily use this or other environment variables in our web +application to make a connection to our `redis` +container. diff --git a/docs/examples/running_riak_service.Dockerfile b/docs/examples/running_riak_service.Dockerfile new file mode 100644 index 0000000000..1051c1a42b --- /dev/null +++ b/docs/examples/running_riak_service.Dockerfile @@ -0,0 +1,31 @@ +# Riak +# +# VERSION 0.1.1 + +# Use the Ubuntu base image provided by dotCloud +FROM ubuntu:trusty +MAINTAINER Hector Castro hector@basho.com + +# Install Riak repository before we do apt-get update, so that update happens +# in a single step +RUN apt-get install -q -y curl && \ + curl -sSL https://packagecloud.io/install/repositories/basho/riak/script.deb | sudo bash + +# Install and setup project dependencies +RUN apt-get update && \ + apt-get install -y supervisor riak=2.0.5-1 + +RUN mkdir -p /var/log/supervisor + +RUN locale-gen en_US en_US.UTF-8 + +COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf + +# Configure Riak to accept connections from any host +RUN sed -i "s|listener.http.internal = 127.0.0.1:8098|listener.http.internal = 0.0.0.0:8098|" /etc/riak/riak.conf +RUN sed -i "s|listener.protobuf.internal = 127.0.0.1:8087|listener.protobuf.internal = 0.0.0.0:8087|" /etc/riak/riak.conf + +# Expose Riak Protocol Buffers and HTTP interfaces +EXPOSE 8087 8098 + +CMD ["/usr/bin/supervisord"] diff --git a/docs/examples/running_riak_service.md b/docs/examples/running_riak_service.md new file mode 100644 index 0000000000..b42a1af9b1 --- /dev/null +++ b/docs/examples/running_riak_service.md @@ -0,0 +1,108 @@ + + +# Dockerizing a Riak service + +The goal of this example is to show you how to build a Docker image with +Riak pre-installed. + +## Creating a Dockerfile + +Create an empty file called `Dockerfile`: + + $ touch Dockerfile + +Next, define the parent image you want to use to build your image on top +of. We'll use [Ubuntu](https://registry.hub.docker.com/_/ubuntu/) (tag: +`trusty`), which is available on [Docker Hub](https://hub.docker.com): + + # Riak + # + # VERSION 0.1.1 + + # Use the Ubuntu base image provided by dotCloud + FROM ubuntu:trusty + MAINTAINER Hector Castro hector@basho.com + +After that, we install the curl which is used to download the repository setup +script and we download the setup script and run it. + + # Install Riak repository before we do apt-get update, so that update happens + # in a single step + RUN apt-get install -q -y curl && \ + curl -sSL https://packagecloud.io/install/repositories/basho/riak/script.deb | sudo bash + +Then we install and setup a few dependencies: + + - `supervisor` is used manage the Riak processes + - `riak=2.0.5-1` is the Riak package coded to version 2.0.5 + + + + # Install and setup project dependencies + RUN apt-get update && \ + apt-get install -y supervisor riak=2.0.5-1 + + RUN mkdir -p /var/log/supervisor + + RUN locale-gen en_US en_US.UTF-8 + + COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf + +After that, we modify Riak's configuration: + + # Configure Riak to accept connections from any host + RUN sed -i "s|listener.http.internal = 127.0.0.1:8098|listener.http.internal = 0.0.0.0:8098|" /etc/riak/riak.conf + RUN sed -i "s|listener.protobuf.internal = 127.0.0.1:8087|listener.protobuf.internal = 0.0.0.0:8087|" /etc/riak/riak.conf + +Then, we expose the Riak Protocol Buffers and HTTP interfaces: + + # Expose Riak Protocol Buffers and HTTP interfaces + EXPOSE 8087 8098 + +Finally, run `supervisord` so that Riak is started: + + CMD ["/usr/bin/supervisord"] + +## Create a supervisord configuration file + +Create an empty file called `supervisord.conf`. Make +sure it's at the same directory level as your `Dockerfile`: + + touch supervisord.conf + +Populate it with the following program definitions: + + [supervisord] + nodaemon=true + + [program:riak] + command=bash -c "/usr/sbin/riak console" + numprocs=1 + autostart=true + autorestart=true + user=riak + environment=HOME="/var/lib/riak" + stdout_logfile=/var/log/supervisor/%(program_name)s.log + stderr_logfile=/var/log/supervisor/%(program_name)s.log + +## Build the Docker image for Riak + +Now you should be able to build a Docker image for Riak: + + $ docker build -t "/riak" . + +## Next steps + +Riak is a distributed database. Many production deployments consist of +[at least five nodes]( +http://basho.com/why-your-riak-cluster-should-have-at-least-five-nodes/). +See the [docker-riak](https://github.com/hectcastro/docker-riak) project +details on how to deploy a Riak cluster using Docker and Pipework. diff --git a/docs/examples/running_ssh_service.Dockerfile b/docs/examples/running_ssh_service.Dockerfile new file mode 100644 index 0000000000..7aba7f6869 --- /dev/null +++ b/docs/examples/running_ssh_service.Dockerfile @@ -0,0 +1,20 @@ +# sshd +# +# VERSION 0.0.2 + +FROM ubuntu:14.04 +MAINTAINER Sven Dowideit + +RUN apt-get update && apt-get install -y openssh-server +RUN mkdir /var/run/sshd +RUN echo 'root:screencast' | chpasswd +RUN sed -i 's/PermitRootLogin without-password/PermitRootLogin yes/' /etc/ssh/sshd_config + +# SSH login fix. Otherwise user is kicked off after login +RUN sed 's@session\s*required\s*pam_loginuid.so@session optional pam_loginuid.so@g' -i /etc/pam.d/sshd + +ENV NOTVISIBLE "in users profile" +RUN echo "export VISIBLE=now" >> /etc/profile + +EXPOSE 22 +CMD ["/usr/sbin/sshd", "-D"] diff --git a/docs/examples/running_ssh_service.md b/docs/examples/running_ssh_service.md new file mode 100644 index 0000000000..c22e510cf6 --- /dev/null +++ b/docs/examples/running_ssh_service.md @@ -0,0 +1,84 @@ + + +# Dockerizing an SSH daemon service + +## Build an `eg_sshd` image + +The following `Dockerfile` sets up an SSHd service in a container that you +can use to connect to and inspect other container's volumes, or to get +quick access to a test container. + + # sshd + # + # VERSION 0.0.2 + + FROM ubuntu:14.04 + MAINTAINER Sven Dowideit + + RUN apt-get update && apt-get install -y openssh-server + RUN mkdir /var/run/sshd + RUN echo 'root:screencast' | chpasswd + RUN sed -i 's/PermitRootLogin without-password/PermitRootLogin yes/' /etc/ssh/sshd_config + + # SSH login fix. Otherwise user is kicked off after login + RUN sed 's@session\s*required\s*pam_loginuid.so@session optional pam_loginuid.so@g' -i /etc/pam.d/sshd + + ENV NOTVISIBLE "in users profile" + RUN echo "export VISIBLE=now" >> /etc/profile + + EXPOSE 22 + CMD ["/usr/sbin/sshd", "-D"] + +Build the image using: + + $ docker build -t eg_sshd . + +## Run a `test_sshd` container + +Then run it. You can then use `docker port` to find out what host port +the container's port 22 is mapped to: + + $ docker run -d -P --name test_sshd eg_sshd + $ docker port test_sshd 22 + 0.0.0.0:49154 + +And now you can ssh as `root` on the container's IP address (you can find it +with `docker inspect`) or on port `49154` of the Docker daemon's host IP address +(`ip address` or `ifconfig` can tell you that) or `localhost` if on the +Docker daemon host: + + $ ssh root@192.168.1.2 -p 49154 + # The password is ``screencast``. + $$ + +## Environment variables + +Using the `sshd` daemon to spawn shells makes it complicated to pass environment +variables to the user's shell via the normal Docker mechanisms, as `sshd` scrubs +the environment before it starts the shell. + +If you're setting values in the `Dockerfile` using `ENV`, you'll need to push them +to a shell initialization file like the `/etc/profile` example in the `Dockerfile` +above. + +If you need to pass`docker run -e ENV=value` values, you will need to write a +short script to do the same before you start `sshd -D` and then replace the +`CMD` with that script. + +## Clean up + +Finally, clean up after your test by stopping and removing the +container, and then removing the image. + + $ docker stop test_sshd + $ docker rm test_sshd + $ docker rmi eg_sshd + diff --git a/docs/examples/supervisord.conf b/docs/examples/supervisord.conf new file mode 100644 index 0000000000..385fbe7a41 --- /dev/null +++ b/docs/examples/supervisord.conf @@ -0,0 +1,12 @@ +[supervisord] +nodaemon=true + +[program:riak] +command=bash -c "/usr/sbin/riak console" +numprocs=1 +autostart=true +autorestart=true +user=riak +environment=HOME="/var/lib/riak" +stdout_logfile=/var/log/supervisor/%(program_name)s.log +stderr_logfile=/var/log/supervisor/%(program_name)s.log diff --git a/docs/extend/index.md b/docs/extend/index.md new file mode 100644 index 0000000000..61afb720ca --- /dev/null +++ b/docs/extend/index.md @@ -0,0 +1,21 @@ + + + +## Extending Docker + +Currently, you can extend Docker by adding a plugin. This section contains the following topics: + +* [Understand Docker plugins](plugins.md) +* [Write a volume plugin](plugins_volume.md) +* [Write a network plugin](plugins_network.md) +* [Docker plugin API](plugin_api.md) diff --git a/docs/extend/plugin_api.md b/docs/extend/plugin_api.md new file mode 100644 index 0000000000..8e2862f6cb --- /dev/null +++ b/docs/extend/plugin_api.md @@ -0,0 +1,135 @@ + + +# Docker Plugin API + +Docker plugins are out-of-process extensions which add capabilities to the +Docker Engine. + +This page is intended for people who want to develop their own Docker plugin. +If you just want to learn about or use Docker plugins, look +[here](plugins.md). + +## What plugins are + +A plugin is a process running on the same docker host as the docker daemon, +which registers itself by placing a file in one of the plugin directories described in [Plugin discovery](#plugin-discovery). + +Plugins have human-readable names, which are short, lowercase strings. For +example, `flocker` or `weave`. + +Plugins can run inside or outside containers. Currently running them outside +containers is recommended. + +## Plugin discovery + +Docker discovers plugins by looking for them in the plugin directory whenever a +user or container tries to use one by name. + +There are three types of files which can be put in the plugin directory. + +* `.sock` files are UNIX domain sockets. +* `.spec` files are text files containing a URL, such as `unix:///other.sock`. +* `.json` files are text files containing a full json specification for the plugin. + +UNIX domain socket files must be located under `/run/docker/plugins`, whereas +spec files can be located either under `/etc/docker/plugins` or `/usr/lib/docker/plugins`. + +The name of the file (excluding the extension) determines the plugin name. + +For example, the `flocker` plugin might create a UNIX socket at +`/run/docker/plugins/flocker.sock`. + +You can define each plugin into a separated subdirectory if you want to isolate definitions from each other. +For example, you can create the `flocker` socket under `/run/docker/plugins/flocker/flocker.sock` and only +mount `/run/docker/plugins/flocker` inside the `flocker` container. + +Docker always searches for unix sockets in `/run/docker/plugins` first. It checks for spec or json files under +`/etc/docker/plugins` and `/usr/lib/docker/plugins` if the socket doesn't exist. The directory scan stops as +soon as it finds the first plugin definition with the given name. + +### JSON specification + +This is the JSON format for a plugin: + +```json +{ + "Name": "plugin-example", + "Addr": "https://example.com/docker/plugin", + "TLSConfig": { + "InsecureSkipVerify": false, + "CAFile": "/usr/shared/docker/certs/example-ca.pem", + "CertFile": "/usr/shared/docker/certs/example-cert.pem", + "KeyFile": "/usr/shared/docker/certs/example-key.pem", + } +} +``` + +The `TLSConfig` field is optional and TLS will only be verified if this configuration is present. + +## Plugin lifecycle + +Plugins should be started before Docker, and stopped after Docker. For +example, when packaging a plugin for a platform which supports `systemd`, you +might use [`systemd` dependencies]( +http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Before=) to +manage startup and shutdown order. + +When upgrading a plugin, you should first stop the Docker daemon, upgrade the +plugin, then start Docker again. + +## Plugin activation + +When a plugin is first referred to -- either by a user referring to it by name +(e.g. `docker run --volume-driver=foo`) or a container already configured to +use a plugin being started -- Docker looks for the named plugin in the plugin +directory and activates it with a handshake. See Handshake API below. + +Plugins are *not* activated automatically at Docker daemon startup. Rather, +they are activated only lazily, or on-demand, when they are needed. + +## API design + +The Plugin API is RPC-style JSON over HTTP, much like webhooks. + +Requests flow *from* the Docker daemon *to* the plugin. So the plugin needs to +implement an HTTP server and bind this to the UNIX socket mentioned in the +"plugin discovery" section. + +All requests are HTTP `POST` requests. + +The API is versioned via an Accept header, which currently is always set to +`application/vnd.docker.plugins.v1+json`. + +## Handshake API + +Plugins are activated via the following "handshake" API call. + +### /Plugin.Activate + +**Request:** empty body + +**Response:** +``` +{ + "Implements": ["VolumeDriver"] +} +``` + +Responds with a list of Docker subsystems which this plugin implements. +After activation, the plugin will then be sent events from this subsystem. + +## Plugin retries + +Attempts to call a method on a plugin are retried with an exponential backoff +for up to 30 seconds. This may help when packaging plugins as containers, since +it gives plugin containers a chance to start up before failing any user +containers which depend on them. diff --git a/docs/extend/plugins.md b/docs/extend/plugins.md new file mode 100644 index 0000000000..d42bdc7029 --- /dev/null +++ b/docs/extend/plugins.md @@ -0,0 +1,88 @@ + + +# Understand Docker plugins + +You can extend the capabilities of the Docker Engine by loading third-party +plugins. This page explains the types of plugins and provides links to several +volume and network plugins for Docker. + +## Types of plugins + +Plugins extend Docker's functionality. They come in specific types. For +example, a [volume plugin](plugins_volume.md) might enable Docker +volumes to persist across multiple Docker hosts and a +[network plugin](plugins_network.md) might provide network plumbing. + +Currently Docker supports volume and network driver plugins. In the future it +will support additional plugin types. + +## Installing a plugin + +Follow the instructions in the plugin's documentation. + +## Finding a plugin + +The following plugins exist: + +* The [Blockbridge plugin](https://github.com/blockbridge/blockbridge-docker-volume) + is a volume plugin that provides access to an extensible set of + container-based persistent storage options. It supports single and multi-host Docker + environments with features that include tenant isolation, automated + provisioning, encryption, secure deletion, snapshots and QoS. + +* The [Convoy plugin](https://github.com/rancher/convoy) is a volume plugin for a + variety of storage back-ends including device mapper and NFS. It's a simple standalone + executable written in Go and provides the framework to support vendor-specific extensions + such as snapshots, backups and restore. + +* The [Flocker plugin](https://clusterhq.com/docker-plugin/) is a volume plugin + which provides multi-host portable volumes for Docker, enabling you to run + databases and other stateful containers and move them around across a cluster + of machines. + +* The [GlusterFS plugin](https://github.com/calavera/docker-volume-glusterfs) is + another volume plugin that provides multi-host volumes management for Docker + using GlusterFS. + +* The [Keywhiz plugin](https://github.com/calavera/docker-volume-keywhiz) is + a plugin that provides credentials and secret management using Keywhiz as + a central repository. + +* The [Pachyderm PFS plugin](https://github.com/pachyderm/pachyderm/tree/master/src/cmd/pfs-volume-driver) + is a volume plugin written in Go that provides functionality to mount Pachyderm File System (PFS) + repositories at specific commits as volumes within Docker containers. + +* The [REX-Ray plugin](https://github.com/emccode/rexraycli) is a volume plugin + which is written in Go and provides advanced storage functionality for many + platforms including EC2, OpenStack, XtremIO, and ScaleIO. + +* The [Contiv Volume Plugin](https://github.com/contiv/volplugin) is an open +source volume plugin that provides multi-tenant, persistent, distributed storage +with intent based consumption using ceph underneath. + +* The [Contiv Networking](https://github.com/contiv/netplugin) is an open source +libnetwork plugin to provide infrastructure and security policies for a +multi-tenant micro services deployment, while providing an integration to +physical network for non-container workload. Contiv Networking implements the +remote driver and IPAM APIs available in Docker 1.9 onwards. + +* The [Weave Network Plugin](https://github.com/weaveworks/docker-plugin) creates a virtual network that connects your Docker containers - across multiple hosts or clouds and enables automatic discovery of applications. Weave networks are resilient, partition tolerant, secure and work in partially connected networks, and other adverse environments - all configured with delightful simplicity. + +## Troubleshooting a plugin + +If you are having problems with Docker after loading a plugin, ask the authors +of the plugin for help. The Docker team may not be able to assist you. + +## Writing a plugin + +If you are interested in writing a plugin for Docker, or seeing how they work +under the hood, see the [docker plugins reference](plugin_api.md). diff --git a/docs/extend/plugins_network.md b/docs/extend/plugins_network.md new file mode 100644 index 0000000000..c33a755056 --- /dev/null +++ b/docs/extend/plugins_network.md @@ -0,0 +1,57 @@ + + +# Docker network driver plugins + +Docker network plugins enable Docker deployments to be extended to support a +wide range of networking technologies, such as VXLAN, IPVLAN, MACVLAN or +something completely different. Network driver plugins are supported via the +LibNetwork project. Each plugin is implemented asa "remote driver" for +LibNetwork, which shares plugin infrastructure with Docker. Effectively, +network driver plugins are activated in the same way as other plugins, and use +the same kind of protocol. + +## Using network driver plugins + +The means of installing and running a network driver plugin depend on the +particular plugin. So, be sure to install your plugin according to the +instructions obtained from the plugin developer. + +Once running however, network driver plugins are used just like the built-in +network drivers: by being mentioned as a driver in network-oriented Docker +commands. For example, + + $ docker network create --driver weave mynet + +Some network driver plugins are listed in [plugins](plugins.md) + +The `mynet` network is now owned by `weave`, so subsequent commands +referring to that network will be sent to the plugin, + + $ docker run --net=mynet busybox top + + +## Write a network plugin + +Network plugins implement the [Docker plugin +API](https://docs.docker.com/extend/plugin_api/) and the network plugin protocol + +## Network plugin protocol + +The network driver protocol, in addition to the plugin activation call, is +documented as part of libnetwork: +[https://github.com/docker/libnetwork/blob/master/docs/remote.md](https://github.com/docker/libnetwork/blob/master/docs/remote.md). + +# Related Information + +To interact with the Docker maintainers and other interested users, se the IRC channel `#docker-network`. + +- [Docker networks feature overview](../userguide/networking/index.md) +- The [LibNetwork](https://github.com/docker/libnetwork) project diff --git a/docs/extend/plugins_volume.md b/docs/extend/plugins_volume.md new file mode 100644 index 0000000000..6ab4bfbd7f --- /dev/null +++ b/docs/extend/plugins_volume.md @@ -0,0 +1,160 @@ + + +# Write a volume plugin + +Docker volume plugins enable Docker deployments to be integrated with external +storage systems, such as Amazon EBS, and enable data volumes to persist beyond +the lifetime of a single Docker host. See the [plugin documentation](plugins.md) +for more information. + +# Command-line changes + +A volume plugin makes use of the `-v`and `--volume-driver` flag on the `docker run` command. The `-v` flag accepts a volume name and the `--volume-driver` flag a driver type, for example: + + $ docker run -ti -v volumename:/data --volume-driver=flocker busybox sh + +This command passes the `volumename` through to the volume plugin as a +user-given name for the volume. The `volumename` must not begin with a `/`. + +By having the user specify a `volumename`, a plugin can associate the volume +with an external volume beyond the lifetime of a single container or container +host. This can be used, for example, to move a stateful container from one +server to another. + +By specifying a `volumedriver` in conjunction with a `volumename`, users can use plugins such as [Flocker](https://clusterhq.com/docker-plugin/) to manage volumes external to a single host, such as those on EBS. + + +# Create a VolumeDriver + +The container creation endpoint (`/containers/create`) accepts a `VolumeDriver` +field of type `string` allowing to specify the name of the driver. It's default +value of `"local"` (the default driver for local volumes). + +# Volume plugin protocol + +If a plugin registers itself as a `VolumeDriver` when activated, then it is +expected to provide writeable paths on the host filesystem for the Docker +daemon to provide to containers to consume. + +The Docker daemon handles bind-mounting the provided paths into user +containers. + +### /VolumeDriver.Create + +**Request**: +``` +{ + "Name": "volume_name", + "Opts": {} +} +``` + +Instruct the plugin that the user wants to create a volume, given a user +specified volume name. The plugin does not need to actually manifest the +volume on the filesystem yet (until Mount is called). +Opts is a map of driver specific options passed through from the user request. + +**Response**: +``` +{ + "Err": null +} +``` + +Respond with a string error if an error occurred. + +### /VolumeDriver.Remove + +**Request**: +``` +{ + "Name": "volume_name" +} +``` + +Delete the specified volume from disk. This request is issued when a user invokes `docker rm -v` to remove volumes associated with a container. + +**Response**: +``` +{ + "Err": null +} +``` + +Respond with a string error if an error occurred. + +### /VolumeDriver.Mount + +**Request**: +``` +{ + "Name": "volume_name" +} +``` + +Docker requires the plugin to provide a volume, given a user specified volume +name. This is called once per container start. + +**Response**: +``` +{ + "Mountpoint": "/path/to/directory/on/host", + "Err": null +} +``` + +Respond with the path on the host filesystem where the volume has been made +available, and/or a string error if an error occurred. + +### /VolumeDriver.Path + +**Request**: +``` +{ + "Name": "volume_name" +} +``` + +Docker needs reminding of the path to the volume on the host. + +**Response**: +``` +{ + "Mountpoint": "/path/to/directory/on/host", + "Err": null +} +``` + +Respond with the path on the host filesystem where the volume has been made +available, and/or a string error if an error occurred. + +### /VolumeDriver.Unmount + +**Request**: +``` +{ + "Name": "volume_name" +} +``` + +Indication that Docker no longer is using the named volume. This is called once +per container stop. Plugin may deduce that it is safe to deprovision it at +this point. + +**Response**: +``` +{ + "Err": null +} +``` + +Respond with a string error if an error occurred. + diff --git a/docs/installation/SUSE.md b/docs/installation/SUSE.md new file mode 100644 index 0000000000..dd37062c4e --- /dev/null +++ b/docs/installation/SUSE.md @@ -0,0 +1,116 @@ + + +# openSUSE and SUSE Linux Enterprise + +This page provides instructions for installing and configuring the lastest +Docker Engine software on openSUSE and SUSE systems. + +>**Note:** You can also find bleeding edge Docker versions inside of the repositories maintained by the [Virtualization:containers project](https://build.opensuse.org/project/show/Virtualization:containers) on the [Open Build Service](https://build.opensuse.org/). This project delivers also other packages that are related with the Docker ecosystem (for example, Docker Compose). + +## Prerequisites + +You must be running a 64 bit architecture. + +## openSUSE + +Docker is part of the official openSUSE repositories starting from 13.2. No +additional repository is required on your system. + +## SUSE Linux Enterprise + +Docker is officially supported on SUSE Linux Enterprise 12 and later. You can find the latest supported Docker packages inside the `Container` module. To enable this module, do the following: + +1. Start YaST, and select *Software > Software Repositories*. +2. Click *Add* to open the add-on dialog. +3. Select *Extensions and Module from Registration Server* and click *Next*. +4. From the list of available extensions and modules, select *Container Module* and click *Next*. + The containers module and its repositories are added to your system. +5. If you use Subscription Management Tool, update the list of repositories at the SMT server. + +Otherwise execute the following command: + + $ sudo SUSEConnect -p sle-module-containers/12/x86_64 -r '' + + >**Note:** currently the `-r ''` flag is required to avoid a known limitation of `SUSEConnect`. + +The [Virtualization:containers project](https://build.opensuse.org/project/show/Virtualization:containers) +on the [Open Build Service](https://build.opensuse.org/) contains also bleeding +edge Docker packages for SUSE Linux Enterprise. However these packages are +**not supported** by SUSE. + +### Install Docker + +1. Install the Docker package: + + $ sudo zypper in docker + +2. Start the Docker daemon. + + $ sudo systemctl start docker + +3. Test the Docker installation. + + $ sudo docker run hello-world + +## Configure Docker boot options + +You can use these steps on openSUSE or SUSE Linux Enterprise. To start the `docker daemon` at boot, set the following: + + $ sudo systemctl enable docker + +The `docker` package creates a new group named `docker`. Users, other than +`root` user, must be part of this group to interact with the +Docker daemon. You can add users with this command syntax: + + sudo /usr/sbin/usermod -a -G docker + +Once you add a user, make sure they relog to pick up these new permissions. + +## Enable external network access + +If you want your containers to be able to access the external network, you must +enable the `net.ipv4.ip_forward` rule. To do this, use YaST. + +For openSUSE Tumbleweed and later, browse to the **System -> Network Settings -> Routing** menu. For SUSE Linux Enterprise 12 and previous openSUSE versions, browse to **Network Devices -> Network Settings -> Routing** menu (f) and check the *Enable IPv4 Forwarding* box. + +When networking is handled by the Network Manager, instead of YaST you must edit +the `/etc/sysconfig/SuSEfirewall2` file needs by hand to ensure the `FW_ROUTE` +flag is set to `yes` like so: + + FW_ROUTE="yes" + +## Custom daemon options + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read the systemd article to +learn how to [customize your systemd Docker daemon options](../articles/systemd.md). + +## Uninstallation + +To uninstall the Docker package: + + $ sudo zypper rm docker + +The above command does not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. + +## Where to go from here + +You can find more details about Docker on openSUSE or SUSE Linux Enterprise in the +[Docker quick start guide](https://www.suse.com/documentation/sles-12/dockerquick/data/dockerquick.html) +on the SUSE website. The document targets SUSE Linux Enterprise, but its contents apply also to openSUSE. + +Continue to the [User Guide](../userguide/). diff --git a/docs/installation/amazon.md b/docs/installation/amazon.md new file mode 100644 index 0000000000..81e5a756eb --- /dev/null +++ b/docs/installation/amazon.md @@ -0,0 +1,21 @@ + + +## Amazon EC2 + +You can install Docker on any AWS EC2 Amazon Machine Image (AMI) which runs an +operating system that Docker supports. Amazon's website includes specific +instructions for [installing on Amazon +Linux](http://docs.aws.amazon.com/AmazonECS/latest/developerguide/docker-basics.html#install_docker). To install on +another AMI, follow the instructions for its specific operating +system in this installation guide. + +For detailed information on Amazon AWS support for Docker, refer to [Amazon's +documentation](http://docs.aws.amazon.com/AmazonECS/latest/developerguide/docker-basics.html). diff --git a/docs/installation/archlinux.md b/docs/installation/archlinux.md new file mode 100644 index 0000000000..509742a5d4 --- /dev/null +++ b/docs/installation/archlinux.md @@ -0,0 +1,105 @@ + + +# Arch Linux + +Installing on Arch Linux can be handled via the package in community: + + - [docker](https://www.archlinux.org/packages/community/x86_64/docker/) + +or the following AUR package: + + - [docker-git](https://aur.archlinux.org/packages/docker-git/) + +The docker package will install the latest tagged version of docker. The +docker-git package will build from the current master branch. + +## Dependencies + +Docker depends on several packages which are specified as dependencies +in the packages. The core dependencies are: + + - bridge-utils + - device-mapper + - iproute2 + - lxc + - sqlite + +## Installation + +For the normal package a simple + + $ sudo pacman -S docker + +is all that is needed. + +For the AUR package execute: + + $ yaourt -S docker-git + +The instructions here assume **yaourt** is installed. See [Arch User +Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages) +for information on building and installing packages from the AUR if you +have not done so before. + +## Starting Docker + +There is a systemd service unit created for docker. To start the docker +service: + + $ sudo systemctl start docker + +To start on system boot: + + $ sudo systemctl enable docker + +## Custom daemon options + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our systemd article to +learn how to [customize your systemd Docker daemon options](../articles/systemd.md). + +## Running Docker with a manually-defined network + +If you manually configure your network using `systemd-network` version 220 or +higher, containers you start with Docker may be unable to access your network. +Beginning with version 220, the forwarding setting for a given network +(`net.ipv4.conf..forwarding`) defaults to *off*. This setting +prevents IP forwarding. It also conflicts with Docker which enables the +`net.ipv4.conf.all.forwarding` setting within a container. + +To work around this, edit the `.network` file in +`/etc/systemd/network/` on your Docker host add the following block: + +``` +[Network] +... +IPForward=kernel +... +``` + +This configuration allows IP forwarding from the container as expected. +## Uninstallation + +To uninstall the Docker package: + + $ sudo pacman -R docker + +To uninstall the Docker package and dependencies that are no longer needed: + + $ sudo pacman -Rns docker + +The above commands will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. diff --git a/docs/installation/azure.md b/docs/installation/azure.md new file mode 100644 index 0000000000..865e63d1f8 --- /dev/null +++ b/docs/installation/azure.md @@ -0,0 +1,33 @@ + + +# Microsoft Azure + + +## Creating a Docker host machine on Azure + +Please check out to the following detailed tutorials on [Microsoft Azure][0] +website to find out different ways to create a Docker-ready Linux virtual +machines on Azure: + +* [Docker Virtual Machine Extensions on Azure][1] + * [How to use the Docker VM Extension from Azure Cross-Platform Interface][2] + * [How to use the Docker VM Extension with the Azure Portal][3] +* [Using Docker Machine with Azure][4] + +## What next? + +Continue with the [User Guide](../userguide/). + +[0]: http://azure.microsoft.com/ +[1]: http://azure.microsoft.com/en-us/documentation/articles/virtual-machines-docker-vm-extension/ +[2]: http://azure.microsoft.com/documentation/articles/virtual-machines-docker-with-xplat-cli/ +[3]: http://azure.microsoft.com/documentation/articles/virtual-machines-docker-with-portal/ +[4]: http://azure.microsoft.com/en-us/documentation/articles/virtual-machines-docker-machine/ \ No newline at end of file diff --git a/docs/installation/binaries.md b/docs/installation/binaries.md new file mode 100644 index 0000000000..f9b2d2084e --- /dev/null +++ b/docs/installation/binaries.md @@ -0,0 +1,214 @@ + + +# Binaries + +**This instruction set is meant for hackers who want to try out Docker +on a variety of environments.** + +Before following these directions, you should really check if a packaged +version of Docker is already available for your distribution. We have +packages for many distributions, and more keep showing up all the time! + +## Check runtime dependencies + +To run properly, docker needs the following software to be installed at +runtime: + + - iptables version 1.4 or later + - Git version 1.7 or later + - procps (or similar provider of a "ps" executable) + - XZ Utils 4.9 or later + - a [properly mounted]( + https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount) + cgroupfs hierarchy (having a single, all-encompassing "cgroup" mount + point [is](https://github.com/docker/docker/issues/2683) + [not](https://github.com/docker/docker/issues/3485) + [sufficient](https://github.com/docker/docker/issues/4568)) + +## Check kernel dependencies + +Docker in daemon mode has specific kernel requirements. For details, +check your distribution in [*Installation*](../installation#installation-list). + +A 3.10 Linux kernel is the minimum requirement for Docker. +Kernels older than 3.10 lack some of the features required to run Docker +containers. These older versions are known to have bugs which cause data loss +and frequently panic under certain conditions. + +The latest minor version (3.x.y) of the 3.10 (or a newer maintained version) +Linux kernel is recommended. Keeping the kernel up to date with the latest +minor version will ensure critical kernel bugs get fixed. + +> **Warning**: +> Installing custom kernels and kernel packages is probably not +> supported by your Linux distribution's vendor. Please make sure to +> ask your vendor about Docker support first before attempting to +> install custom kernels on your distribution. + +> **Warning**: +> Installing a newer kernel might not be enough for some distributions +> which provide packages which are too old or incompatible with +> newer kernels. + +Note that Docker also has a client mode, which can run on virtually any +Linux kernel (it even builds on OS X!). + +## Enable AppArmor and SELinux when possible + +Please use AppArmor or SELinux if your Linux distribution supports +either of the two. This helps improve security and blocks certain +types of exploits. Your distribution's documentation should provide +detailed steps on how to enable the recommended security mechanism. + +Some Linux distributions enable AppArmor or SELinux by default and +they run a kernel which doesn't meet the minimum requirements (3.10 +or newer). Updating the kernel to 3.10 or newer on such a system +might not be enough to start Docker and run containers. +Incompatibilities between the version of AppArmor/SELinux user +space utilities provided by the system and the kernel could prevent +Docker from running, from starting containers or, cause containers to +exhibit unexpected behaviour. + +> **Warning**: +> If either of the security mechanisms is enabled, it should not be +> disabled to make Docker or its containers run. This will reduce +> security in that environment, lose support from the distribution's +> vendor for the system, and might break regulations and security +> policies in heavily regulated environments. + +## Get the Docker binary + +You can download either the latest release binary or a specific version. +After downloading a binary file, you must set the file's execute bit to run it. + +To set the file's execute bit on Linux and OS X: + + $ chmod +x docker + +To get the list of stable release version numbers from GitHub, view the +`docker/docker` [releases page](https://github.com/docker/docker/releases). + +> **Note** +> +> 1) You can get the MD5 and SHA256 hashes by appending .md5 and .sha256 to the URLs respectively +> +> 2) You can get the compressed binaries by appending .tgz to the URLs + +### Get the Linux binary + +To download the latest version for Linux, use the +following URLs: + + https://get.docker.com/builds/Linux/i386/docker-latest + + https://get.docker.com/builds/Linux/x86_64/docker-latest + +To download a specific version for Linux, use the +following URL patterns: + + https://get.docker.com/builds/Linux/i386/docker- + + https://get.docker.com/builds/Linux/x86_64/docker- + +For example: + + https://get.docker.com/builds/Linux/i386/docker-1.6.0 + + https://get.docker.com/builds/Linux/x86_64/docker-1.6.0 + + +### Get the Mac OS X binary + +The Mac OS X binary is only a client. You cannot use it to run the `docker` +daemon. To download the latest version for Mac OS X, use the following URLs: + + https://get.docker.com/builds/Darwin/i386/docker-latest + + https://get.docker.com/builds/Darwin/x86_64/docker-latest + +To download a specific version for Mac OS X, use the +following URL patterns: + + https://get.docker.com/builds/Darwin/i386/docker- + + https://get.docker.com/builds/Darwin/x86_64/docker- + +For example: + + https://get.docker.com/builds/Darwin/i386/docker-1.6.0 + + https://get.docker.com/builds/Darwin/x86_64/docker-1.6.0 + +### Get the Windows binary + +You can only download the Windows client binary for version `1.6.0` onwards. +Moreover, the binary is only a client, you cannot use it to run the `docker` daemon. +To download the latest version for Windows, use the following URLs: + + https://get.docker.com/builds/Windows/i386/docker-latest.exe + + https://get.docker.com/builds/Windows/x86_64/docker-latest.exe + +To download a specific version for Windows, use the following URL pattern: + + https://get.docker.com/builds/Windows/i386/docker-.exe + + https://get.docker.com/builds/Windows/x86_64/docker-.exe + +For example: + + https://get.docker.com/builds/Windows/i386/docker-1.6.0.exe + + https://get.docker.com/builds/Windows/x86_64/docker-1.6.0.exe + + +## Run the Docker daemon + + # start the docker in daemon mode from the directory you unpacked + $ sudo ./docker daemon & + +## Giving non-root access + +The `docker` daemon always runs as the root user, and the `docker` +daemon binds to a Unix socket instead of a TCP port. By default that +Unix socket is owned by the user *root*, and so, by default, you can +access it with `sudo`. + +If you (or your Docker installer) create a Unix group called *docker* +and add users to it, then the `docker` daemon will make the ownership of +the Unix socket read/writable by the *docker* group when the daemon +starts. The `docker` daemon must always run as the root user, but if you +run the `docker` client as a user in the *docker* group then you don't +need to add `sudo` to all the client commands. + +> **Warning**: +> The *docker* group (or the group specified with `-G`) is root-equivalent; +> see [*Docker Daemon Attack Surface*](../articles/security.md#docker-daemon-attack-surface) details. + +## Upgrades + +To upgrade your manual installation of Docker, first kill the docker +daemon: + + $ killall docker + +Then follow the regular installation steps. + +## Run your first container! + + # check your docker version + $ sudo ./docker version + + # run a container and open an interactive shell in the container + $ sudo ./docker run -i -t ubuntu /bin/bash + +Continue with the [User Guide](../userguide). diff --git a/docs/installation/centos.md b/docs/installation/centos.md new file mode 100644 index 0000000000..83e58777e3 --- /dev/null +++ b/docs/installation/centos.md @@ -0,0 +1,187 @@ + + +# CentOS + +Docker runs on CentOS 7.X. An installation on other binary compatible EL7 +distributions such as Scientific Linux might succeed, but Docker does not test +or support Docker on these distributions. + +This page instructs you to install using Docker-managed release packages and +installation mechanisms. Using these packages ensures you get the latest release +of Docker. If you wish to install using CentOS-managed packages, consult your +CentOS documentation. + +## Prerequisites + +Docker requires a 64-bit installation regardless of your CentOS version. Also, +your kernel must be 3.10 at minimum, which CentOS 7 runs. + +To check your current kernel version, open a terminal and use `uname -r` to +display your kernel version: + + $ uname -r + 3.10.0-229.el7.x86_64 + +Finally, is it recommended that you fully update your system. Please keep in +mind that your system should be fully patched to fix any potential kernel bugs. +Any reported kernel bugs may have already been fixed on the latest kernel +packages. + +## Install + +There are two ways to install Docker Engine. You can install using the `yum` +package manager. Or you can use `curl` with the `get.docker.com` site. This +second method runs an installation script which also installs via the `yum` +package manager. + +### Install with yum + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Add the yum repo. + + $ cat >/etc/yum.repos.d/docker.repo <<-EOF + [dockerrepo] + name=Docker Repository + baseurl=https://yum.dockerproject.org/repo/main/centos/7 + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + +4. Install the Docker package. + + $ sudo yum install docker-engine + +5. Start the Docker daemon. + + $ sudo service docker start + +6. Verify `docker` is installed correctly by running a test image in a container. + + $ sudo docker run hello-world + Unable to find image 'hello-world:latest' locally + latest: Pulling from hello-world + a8219747be10: Pull complete + 91c95931e552: Already exists + hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security. + Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d + Status: Downloaded newer image for hello-world:latest + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker client contacted the Docker daemon. + 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. + (Assuming it was not already locally available.) + 3. The Docker daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker daemon streamed that output to the Docker client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + For more examples and ideas, visit: + http://docs.docker.com/userguide/ + +### Install with the script + + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Run the Docker installation script. + + $ curl -sSL https://get.docker.com/ | sh + + This script adds the `docker.repo` repository and installs Docker. + +4. Start the Docker daemon. + + $ sudo service docker start + +5. Verify `docker` is installed correctly by running a test image in a container. + + $ sudo docker run hello-world + + +## Create a docker group + +The `docker` daemon binds to a Unix socket instead of a TCP port. By default +that Unix socket is owned by the user `root` and other users can access it with +`sudo`. For this reason, `docker` daemon always runs as the `root` user. + +To avoid having to use `sudo` when you use the `docker` command, create a Unix +group called `docker` and add users to it. When the `docker` daemon starts, it +makes the ownership of the Unix socket read/writable by the `docker` group. + +>**Warning**: The `docker` group is equivalent to the `root` user; For details +>on how this impacts security in your system, see [*Docker Daemon Attack +>Surface*](../articles/security.md#docker-daemon-attack-surface) for details. + +To create the `docker` group and add your user: + +1. Log into Centos as a user with `sudo` privileges. + +2. Create the `docker` group and add your user. + + `sudo usermod -aG docker your_username` + +3. Log out and log back in. + + This ensures your user is running with the correct permissions. + +4. Verify your work by running `docker` without `sudo`. + + $ docker run hello-world + +## Start the docker daemon at boot + +To ensure Docker starts when you boot your system, do the following: + + $ sudo chkconfig docker on + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our Systemd article to +learn how to [customize your Systemd Docker daemon options](../articles/systemd.md). + + +## Uninstall + +You can uninstall the Docker software with `yum`. + +1. List the package you have installed. + + $ yum list installed | grep docker + yum list installed | grep docker + docker-engine.x86_64 1.7.1-1.el7 @/docker-engine-1.7.1-1.el7.x86_64.rpm + +2. Remove the package. + + $ sudo yum -y remove docker-engine.x86_64 + + This command does not remove images, containers, volumes, or user-created + configuration files on your host. + +3. To delete all images, containers, and volumes, run the following command: + + $ rm -rf /var/lib/docker + +4. Locate and delete any user-created configuration files. diff --git a/docs/installation/cruxlinux.md b/docs/installation/cruxlinux.md new file mode 100644 index 0000000000..e5276c9b7e --- /dev/null +++ b/docs/installation/cruxlinux.md @@ -0,0 +1,92 @@ + + +# CRUX Linux + +Installing on CRUX Linux can be handled via the contrib ports from +[James Mills](http://prologic.shortcircuit.net.au/) and are included in the +official [contrib](http://crux.nu/portdb/?a=repo&q=contrib) ports: + +- docker + +The `docker` port will build and install the latest tagged version of Docker. + + +## Installation + +Assuming you have contrib enabled, update your ports tree and install docker: + + $ sudo prt-get depinst docker + + +## Kernel requirements + +To have a working **CRUX+Docker** Host you must ensure your Kernel has +the necessary modules enabled for the Docker Daemon to function correctly. + +Please read the `README`: + + $ sudo prt-get readme docker + +The `docker` port installs the `contrib/check-config.sh` script +provided by the Docker contributors for checking your kernel +configuration as a suitable Docker host. + +To check your Kernel configuration run: + + $ /usr/share/docker/check-config.sh + +## Starting Docker + +There is a rc script created for Docker. To start the Docker service: + + $ sudo /etc/rc.d/docker start + +To start on system boot: + + - Edit `/etc/rc.conf` + - Put `docker` into the `SERVICES=(...)` array after `net`. + +## Images + +There is a CRUX image maintained by [James Mills](http://prologic.shortcircuit.net.au/) +as part of the Docker "Official Library" of images. To use this image simply pull it +or use it as part of your `FROM` line in your `Dockerfile(s)`. + + $ docker pull crux + $ docker run -i -t crux + +There are also user contributed [CRUX based image(s)](https://registry.hub.docker.com/repos/crux/) on the Docker Hub. + + +## Uninstallation + +To uninstall the Docker package: + + $ sudo prt-get remove docker + +The above command will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. + +## Issues + +If you have any issues please file a bug with the +[CRUX Bug Tracker](http://crux.nu/bugs/). + +## Support + +For support contact the [CRUX Mailing List](http://crux.nu/Main/MailingLists) +or join CRUX's [IRC Channels](http://crux.nu/Main/IrcChannels). on the +[FreeNode](http://freenode.net/) IRC Network. diff --git a/docs/installation/debian.md b/docs/installation/debian.md new file mode 100644 index 0000000000..88489fb9f1 --- /dev/null +++ b/docs/installation/debian.md @@ -0,0 +1,168 @@ + + +# Debian + +Docker is supported on the following versions of Debian: + + - [*Debian testing stretch (64-bit)*](#debian-wheezy-stable-7-x-64-bit) + - [*Debian 8.0 Jessie (64-bit)*](#debian-jessie-80-64-bit) + - [*Debian 7.7 Wheezy (64-bit)*](#debian-wheezy-stable-7-x-64-bit) + + >**Note**: If you previously installed Docker using `apt`, make sure you update + your `apt` sources to the new `apt` repository. + +## Prerequisites + + Docker requires a 64-bit installation regardless of your Debian version. + Additionally, your kernel must be 3.10 at minimum. The latest 3.10 minor + version or a newer maintained version are also acceptable. + + Kernels older than 3.10 lack some of the features required to run Docker + containers. These older versions are known to have bugs which cause data loss + and frequently panic under certain conditions. + + To check your current kernel version, open a terminal and use `uname -r` to + display your kernel version: + + $ uname -r + +### Update your apt repository + +Docker's `apt` repository contains Docker 1.7.1 and higher. To set `apt` to use +from the new repository: + + 1. If you haven't already done so, log into your machine as a user with `sudo` or `root` privileges. + + 2. Open a terminal window. + + 3. Purge any older repositories. + + $ apt-get purge lxc-docker* + $ apt-get purge docker.io* + + 4. Add the new `gpg` key. + + $ apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D + + 5. Open the `/etc/apt/sources.list.d/docker.list` file in your favorite editor. + + If the file doesn't exist, create it. + + 6. Remove any existing entries. + + 7. Add an entry for your Debian operating system. + + The possible entries are: + + # Debian Wheezy + deb https://apt.dockerproject.org/repo debian-wheezy main + # Debian Jessie + deb https://apt.dockerproject.org/repo debian-jessie main + # Debian Stretch/Sid + deb https://apt.dockerproject.org/repo debian-stretch main + + 8. Save and close the file. + + 9. Update the `apt` package index. + + $ apt-get update + + 10. Verify that `apt` is pulling from the right repository. + + $ apt-cache policy docker-engine + + From now on when you run `apt-get upgrade`, `apt` pulls from the new apt repository. + +## Install Docker + +Before installing Docker, make sure you have set your `apt` repository correctly as described in the prerequisites. + +1. Update the `apt` package index. + + $ sudo apt-get update + +2. Install Docker. + + $ sudo apt-get install docker-engine + +5. Start the `docker` daemon. + + $ sudo service docker start + +6. Verify `docker` is installed correctly. + + $ sudo docker run hello-world + + This command downloads a test image and runs it in a container. When the + container runs, it prints an informational message. Then, it exits. + + +## Giving non-root access + +The `docker` daemon always runs as the `root` user and the `docker` +daemon binds to a Unix socket instead of a TCP port. By default that +Unix socket is owned by the user `root`, and so, by default, you can +access it with `sudo`. + +If you (or your Docker installer) create a Unix group called `docker` +and add users to it, then the `docker` daemon will make the ownership of +the Unix socket read/writable by the `docker` group when the daemon +starts. The `docker` daemon must always run as the root user, but if you +run the `docker` client as a user in the `docker` group then you don't +need to add `sudo` to all the client commands. From Docker 0.9.0 you can +use the `-G` flag to specify an alternative group. + +> **Warning**: +> The `docker` group (or the group specified with the `-G` flag) is +> `root`-equivalent; see [*Docker Daemon Attack Surface*](../articles/security.md#docker-daemon-attack-surface) details. + +**Example:** + + # Add the docker group if it doesn't already exist. + $ sudo groupadd docker + + # Add the connected user "${USER}" to the docker group. + # Change the user name to match your preferred user. + # You may have to logout and log back in again for + # this to take effect. + $ sudo gpasswd -a ${USER} docker + + # Restart the Docker daemon. + $ sudo service docker restart + +## Upgrade Docker + +To install the latest version of Docker with `apt-get`: + + $ apt-get upgrade docker-engine + +## Uninstall + +To uninstall the Docker package: + + $ sudo apt-get purge docker-engine + +To uninstall the Docker package and dependencies that are no longer needed: + + $ sudo apt-get autoremove --purge docker-engine + +The above commands will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. + +## What next? + +Continue with the [User Guide](../userguide/). diff --git a/docs/installation/fedora.md b/docs/installation/fedora.md new file mode 100644 index 0000000000..0c029c9de7 --- /dev/null +++ b/docs/installation/fedora.md @@ -0,0 +1,211 @@ + + +# Fedora + +Docker is supported Fedora version 21 and 22. This page instructs you to install +using Docker-managed release packages and installation mechanisms. Using these +packages ensures you get the latest release of Docker. If you wish to install +using Fedora-managed packages, consult your Fedora release documentation for +information on Fedora's Docker support. + +## Prerequisites + +Docker requires a 64-bit installation regardless of your Fedora version. Also, your kernel must be 3.10 at minimum. To check your current kernel +version, open a terminal and use `uname -r` to display your kernel version: + + $ uname -r + 3.19.5-100.fc21.x86_64 + +If your kernel is at a older version, you must update it. + +Finally, is it recommended that you fully update your system. Please keep in +mind that your system should be fully patched to fix any potential kernel bugs. Any +reported kernel bugs may have already been fixed on the latest kernel packages + + +## Install + +There are two ways to install Docker Engine. You can install with the `yum` package manager. Or you can use `curl` with the `get.docker.com` site. This second method runs an installation script which also installs via the `yum` package manager. + +### Install with yum + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Add the yum repo yourself. + + For Fedora 21 run: + + $ cat >/etc/yum.repos.d/docker.repo <<-EOF + [dockerrepo] + name=Docker Repository + baseurl=https://yum.dockerproject.org/repo/main/fedora/21 + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + + For Fedora 22 run: + + $ cat >/etc/yum.repos.d/docker.repo <<-EOF + [dockerrepo] + name=Docker Repository + baseurl=https://yum.dockerproject.org/repo/main/fedora/22 + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + +4. Install the Docker package. + + $ sudo yum install docker-engine + +5. Start the Docker daemon. + + $ sudo systemctl start docker + +6. Verify `docker` is installed correctly by running a test image in a container. + + + $ sudo docker run hello-world + Unable to find image 'hello-world:latest' locally + latest: Pulling from hello-world + a8219747be10: Pull complete + 91c95931e552: Already exists + hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security. + Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d + Status: Downloaded newer image for hello-world:latest + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker client contacted the Docker daemon. + 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. + (Assuming it was not already locally available.) + 3. The Docker daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker daemon streamed that output to the Docker client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + For more examples and ideas, visit: + http://docs.docker.com/userguide/ + + +### Install with the script + + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Run the Docker installation script. + + $ curl -sSL https://get.docker.com/ | sh + + This script adds the `docker.repo` repository and installs Docker. + +4. Start the Docker daemon. + + $ sudo systemctl start docker + +5. Verify `docker` is installed correctly by running a test image in a container. + + $ sudo docker run hello-world + +## Create a docker group + +The `docker` daemon binds to a Unix socket instead of a TCP port. By default +that Unix socket is owned by the user `root` and other users can access it with +`sudo`. For this reason, `docker` daemon always runs as the `root` user. + +To avoid having to use `sudo` when you use the `docker` command, create a Unix +group called `docker` and add users to it. When the `docker` daemon starts, it +makes the ownership of the Unix socket read/writable by the `docker` group. + +>**Warning**: The `docker` group is equivalent to the `root` user; For details +>on how this impacts security in your system, see [*Docker Daemon Attack +>Surface*](../articles/security.md#docker-daemon-attack-surface) for details. + +To create the `docker` group and add your user: + +1. Log into your system as a user with `sudo` privileges. + +2. Create the `docker` group and add your user. + + `sudo usermod -aG docker your_username` + +3. Log out and log back in. + + This ensures your user is running with the correct permissions. + +4. Verify your work by running `docker` without `sudo`. + + $ docker run hello-world + +## Start the docker daemon at boot + +To ensure Docker starts when you boot your system, do the following: + + $ sudo systemctl enable docker + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our Systemd article to +learn how to [customize your Systemd Docker daemon options](../articles/systemd.md). + +## Running Docker with a manually-defined network + +If you manually configure your network using `systemd-network` with `systemd` version 219 or higher, containers you start with Docker may be unable to access your network. +Beginning with version 220, the forwarding setting for a given network (`net.ipv4.conf..forwarding`) defaults to *off*. This setting prevents IP forwarding. It also conflicts with Docker which enables the `net.ipv4.conf.all.forwarding` setting within a container. + +To work around this, edit the `.network` file in +`/usr/lib/systemd/network/` on your Docker host (ex: `/usr/lib/systemd/network/80-container-host0.network`) add the following block: + +``` +[Network] +... +IPForward=kernel +# OR +IPForward=true +... +``` + +This configuration allows IP forwarding from the container as expected. + +## Uninstall + +You can uninstall the Docker software with `yum`. + +1. List the package you have installed. + + $ yum list installed | grep docker yum list installed | grep docker + docker-engine.x86_64 1.7.1-0.1.fc21 @/docker-engine-1.7.1-0.1.fc21.el7.x86_64 + +2. Remove the package. + + $ sudo yum -y remove docker-engine.x86_64 + + This command does not remove images, containers, volumes, or user-created + configuration files on your host. + +3. To delete all images, containers, and volumes, run the following command: + + $ rm -rf /var/lib/docker + +4. Locate and delete any user-created configuration files. diff --git a/docs/installation/frugalware.md b/docs/installation/frugalware.md new file mode 100644 index 0000000000..090fca5a79 --- /dev/null +++ b/docs/installation/frugalware.md @@ -0,0 +1,74 @@ + + +# FrugalWare + +Installing on FrugalWare is handled via the official packages: + + - [lxc-docker i686](http://www.frugalware.org/packages/200141) + - [lxc-docker x86_64](http://www.frugalware.org/packages/200130) + +The lxc-docker package will install the latest tagged version of Docker. + +## Dependencies + +Docker depends on several packages which are specified as dependencies +in the packages. The core dependencies are: + + - systemd + - lvm2 + - sqlite3 + - libguestfs + - lxc + - iproute2 + - bridge-utils + +## Installation + +A simple + + $ sudo pacman -S lxc-docker + +is all that is needed. + +## Starting Docker + +There is a systemd service unit created for Docker. To start Docker as +service: + + $ sudo systemctl start lxc-docker + +To start on system boot: + + $ sudo systemctl enable lxc-docker + +## Custom daemon options + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our systemd article to +learn how to [customize your systemd Docker daemon options](../articles/systemd.md). + +## Uninstallation + +To uninstall the Docker package: + + $ sudo pacman -R lxc-docker + +To uninstall the Docker package and dependencies that are no longer needed: + + $ sudo pacman -Rns lxc-docker + +The above commands will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. diff --git a/docs/installation/gentoolinux.md b/docs/installation/gentoolinux.md new file mode 100644 index 0000000000..6e2ef3f70e --- /dev/null +++ b/docs/installation/gentoolinux.md @@ -0,0 +1,121 @@ + + +# Gentoo + +Installing Docker on Gentoo Linux can be accomplished using one of two ways: the **official** way and the `docker-overlay` way. + +Official project page of [Gentoo Docker](https://wiki.gentoo.org/wiki/Project:Docker) team. + +## Official way +The first and recommended way if you are looking for a stable +experience is to use the official `app-emulation/docker` package directly +from the tree. + +If any issues arise from this ebuild including, missing kernel +configuration flags or dependencies, open a bug +on the Gentoo [Bugzilla](https://bugs.gentoo.org) assigned to `docker AT gentoo DOT org` +or join and ask in the official +[IRC](http://webchat.freenode.net?channels=%23gentoo-containers&uio=d4) channel on the Freenode network. + +## docker-overlay way + +If you're looking for a `-bin` ebuild, a live ebuild, or a bleeding edge +ebuild, use the provided overlay, [docker-overlay](https://github.com/tianon/docker-overlay) +which can be added using `app-portage/layman`. The most accurate and +up-to-date documentation for properly installing and using the overlay +can be found in the [overlay](https://github.com/tianon/docker-overlay/blob/master/README.md#using-this-overlay). + +If any issues arise from this ebuild or the resulting binary, including +and especially missing kernel configuration flags or dependencies, +open an [issue](https://github.com/tianon/docker-overlay/issues) on +the `docker-overlay` repository or ping `tianon` directly in the `#docker` +IRC channel on the Freenode network. + +## Installation + +### Available USE flags + +| USE Flag | Default | Description | +| ------------- |:-------:|:------------| +| aufs | |Enables dependencies for the "aufs" graph driver, including necessary kernel flags.| +| btrfs | |Enables dependencies for the "btrfs" graph driver, including necessary kernel flags.| +| contrib | Yes |Install additional contributed scripts and components.| +| device-mapper | Yes |Enables dependencies for the "devicemapper" graph driver, including necessary kernel flags.| +| doc | |Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally.| +| lxc | |Enables dependencies for the "lxc" execution driver.| +| vim-syntax | |Pulls in related vim syntax scripts.| +| zsh-completion| |Enable zsh completion support.| + +USE flags are described in detail on [tianon's +blog](https://tianon.github.io/post/2014/05/17/docker-on-gentoo.html). + +The package should properly pull in all the necessary dependencies and +prompt for all necessary kernel options. + + $ sudo emerge -av app-emulation/docker + +>Note: Sometimes there is a disparity between the latest versions +>in the official **Gentoo tree** and the **docker-overlay**. +>Please be patient, and the latest version should propagate shortly. + +## Starting Docker + +Ensure that you are running a kernel that includes all the necessary +modules and configuration (and optionally for device-mapper +and AUFS or Btrfs, depending on the storage driver you've decided to use). + +To use Docker, the `docker` daemon must be running as **root**. +To use Docker as a **non-root** user, add yourself to the **docker** +group by running the following command: + + $ sudo usermod -a -G docker user + +### OpenRC + +To start the `docker` daemon: + + $ sudo /etc/init.d/docker start + +To start on system boot: + + $ sudo rc-update add docker default + +### systemd + +To start the `docker` daemon: + + $ sudo systemctl start docker + +To start on system boot: + + $ sudo systemctl enable docker + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our systemd article to +learn how to [customize your systemd Docker daemon options](../articles/systemd.md). + +## Uninstallation + +To uninstall the Docker package: + + $ sudo emerge -cav app-emulation/docker + +To uninstall the Docker package and dependencies that are no longer needed: + + $ sudo emerge -C app-emulation/docker + +The above commands will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. diff --git a/docs/installation/google.md b/docs/installation/google.md new file mode 100644 index 0000000000..b507f41b1a --- /dev/null +++ b/docs/installation/google.md @@ -0,0 +1,47 @@ + + +# Google Cloud Platform + +## QuickStart with Container-optimized Google Compute Engine images + +1. Go to [Google Cloud Console][1] and create a new Cloud Project with + [Compute Engine enabled][2] + +2. Download and configure the [Google Cloud SDK][3] to use your + project with the following commands: + + $ curl -sSL https://sdk.cloud.google.com | bash + $ gcloud auth login + $ gcloud config set project + +3. Start a new instance using the latest [Container-optimized image][4]: + (select a zone close to you and the desired instance size) + + $ gcloud compute instances create docker-playground \ + --image container-vm \ + --zone us-central1-a \ + --machine-type f1-micro + +4. Connect to the instance using SSH: + + $ gcloud compute ssh --zone us-central1-a docker-playground + docker-playground:~$ sudo docker run hello-world + Hello from Docker. + This message shows that your installation appears to be working correctly. + ... + +Read more about [deploying Containers on Google Cloud Platform][5]. + +[1]: https://cloud.google.com/console +[2]: https://developers.google.com/compute/docs/signup +[3]: https://developers.google.com/cloud/sdk +[4]: https://developers.google.com/compute/docs/containers#container-optimized_google_compute_engine_images +[5]: https://developers.google.com/compute/docs/containers diff --git a/docs/installation/images/bad_host.png b/docs/installation/images/bad_host.png new file mode 100644 index 0000000000000000000000000000000000000000..cdc78defc551464b2e6a9cbe4cca772dca08c0d1 GIT binary patch literal 27367 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 Myt*7z_HEGr0f)>+{Qv*} literal 0 HcmV?d00001 diff --git a/docs/installation/images/good_host.png b/docs/installation/images/good_host.png new file mode 100644 index 0000000000000000000000000000000000000000..2a6e7c47eb579839535a26e5e952eea242c39347 GIT binary patch literal 30853 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%0Dr2?*5My2Th;hoE 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 literal 0 HcmV?d00001 diff --git a/docs/installation/images/kitematic.png b/docs/installation/images/kitematic.png new file mode 100644 index 0000000000000000000000000000000000000000..5bb221ccf7d6849b941dad105dc6a887430bed16 GIT binary patch literal 14191 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 literal 0 HcmV?d00001 diff --git a/docs/installation/images/linux_docker_host.svg b/docs/installation/images/linux_docker_host.svg new file mode 100644 index 0000000000..0ad7240b7a --- /dev/null +++ b/docs/installation/images/linux_docker_host.svg @@ -0,0 +1,1195 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/installation/images/mac-page-finished.png b/docs/installation/images/mac-page-finished.png new file mode 100644 index 0000000000000000000000000000000000000000..7055a92fdfb07e90aa5e89c8b79e3409fed5d8d2 GIT binary patch literal 158534 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

vGlqRN(p5NLO;-) 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

YZ#mcRx9@aZ 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

=TO*Zy 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 X_~U703gOQJ|4>uWdRYCy^2L7v%PYCH literal 0 HcmV?d00001 diff --git a/docs/installation/images/mac-welcome-page.png b/docs/installation/images/mac-welcome-page.png new file mode 100644 index 0000000000000000000000000000000000000000..6f4501fc9e83ef43b0683280675bec41d6fd7fd0 GIT binary patch literal 155430 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ෆ#V*6|}@uNhU241QM;M)Y3jY9CSs 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

k-7 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

;#SU@d%jRKw&%sO#w>f+3FN0qL|m5oNfnkE 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/installation/images/my-docker-vm.png b/docs/installation/images/my-docker-vm.png new file mode 100644 index 0000000000000000000000000000000000000000..f7073eebfe85f932b9fd82af0b3bedb80902894a GIT binary patch literal 136985 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 literal 0 HcmV?d00001 diff --git a/docs/installation/images/newsite_view.png b/docs/installation/images/newsite_view.png new file mode 100644 index 0000000000000000000000000000000000000000..27b6b1a4dd63330e4f57883d75c7719ae6f3acf0 GIT binary patch literal 21403 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 zℜ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 a=tf^iKJiFReE_aL0h(%hs#VGsA^!uE&_J^Q literal 0 HcmV?d00001 diff --git a/docs/installation/images/virtualization.png b/docs/installation/images/virtualization.png new file mode 100644 index 0000000000000000000000000000000000000000..cd2ec08b42dba1525520b01b197307136fb0ac51 GIT binary patch literal 59249 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 Awg3PC literal 0 HcmV?d00001 diff --git a/docs/installation/images/win-page-6.png b/docs/installation/images/win-page-6.png new file mode 100644 index 0000000000000000000000000000000000000000..2420b497abb1788abdf60955928c65300832ec6b GIT binary patch literal 88115 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�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

J1Qrc=Qpg$&zVMXs4CO3L4maNaDxkIq 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%0AwRhnc0pWDCq2)lx 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 G3H*NnU$5B! literal 0 HcmV?d00001 diff --git a/docs/installation/images/win_docker_host.svg b/docs/installation/images/win_docker_host.svg new file mode 100644 index 0000000000..eef284e754 --- /dev/null +++ b/docs/installation/images/win_docker_host.svg @@ -0,0 +1,1259 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/installation/images/win_ver.png b/docs/installation/images/win_ver.png new file mode 100644 index 0000000000000000000000000000000000000000..2a8fd9035b4028c7c1ea51cbcacd347d1112ce31 GIT binary patch literal 50312 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

g5x9WXk}s0J!gce&f$p|)7B!#fe_wWzKn1$ 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 TRsx#{1O1biRtA71jRXG=3IsDK literal 0 HcmV?d00001 diff --git a/docs/installation/images/windows-boot2docker-cmd.png b/docs/installation/images/windows-boot2docker-cmd.png new file mode 100644 index 0000000000000000000000000000000000000000..09e3206ef97ecef230a24e13e9b25e106f7b576e GIT binary patch literal 37436 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 literal 0 HcmV?d00001 diff --git a/docs/installation/images/windows-boot2docker-powershell.png b/docs/installation/images/windows-boot2docker-powershell.png new file mode 100644 index 0000000000000000000000000000000000000000..b1ef89672619b3dd7f4c1ee7d269f221bec3395d GIT binary patch literal 37945 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

ARw{c%q1S3=%OeW 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 literal 0 HcmV?d00001 diff --git a/docs/installation/index.md b/docs/installation/index.md new file mode 100644 index 0000000000..d1b25836b5 --- /dev/null +++ b/docs/installation/index.md @@ -0,0 +1,48 @@ + + +# Install Docker Engine + +Docker Engine is supported on Linux, Cloud, Windows, and OS X. Installation instructions are available for the following: + +## On Linux +* [Arch Linux](archlinux.md) +* [CentOS](centos.md) +* [CRUX Linux](cruxlinux.md) +* [Debian](debian.md) +* [Fedora](fedora.md) +* [FrugalWare](frugalware.md) +* [Gentoo](gentoolinux.md) +* [Oracle Linux](oracle.md) +* [Red Hat Enterprise Linux](rhel.md) +* [openSUSE and SUSE Linux Enterprise](SUSE.md) +* [Ubuntu](ubuntulinux.md) + +If your linux distribution is not listed above, don't give up yet. To try out Docker on a distribution that is not listed above, go here: [Installation from binaries](binaries.md). + +## On Cloud +* [Amazon EC2 Installation](amazon.md) +* [Install on Joyent Public Cloud](joyent.md) +* [Google Cloud Platform](google.md) +* [IBM SoftLayer](softlayer.md) +* [Microsoft Azure platform](azure.md) +* [Rackspace Cloud](rackspace.md) + +## On OSX and Windows +* [Mac OS X](mac.md) +* [Windows](windows.md) + +## The Docker Archives +Instructions for installing prior releases of Docker can be found in the following docker archives: +[Docker v1.7](http://docs.docker.com/v1.7/), [Docker v1.6](http://docs.docker.com/v1.6/), [Docker v1.5](http://docs.docker.com/v1.5/), and [Docker v1.4](http://docs.docker.com/v1.4/). + +## Where to go After Installing +* [About Docker](../misc) +* [Support](https://www.docker.com/support/) +* [Training](https://training.docker.com//) + diff --git a/docs/installation/joyent.md b/docs/installation/joyent.md new file mode 100644 index 0000000000..a94a50b236 --- /dev/null +++ b/docs/installation/joyent.md @@ -0,0 +1,23 @@ + + +## Using Joyent's Triton Elastic Container Service for Docker + +Joyent's Triton Elastic Container Service for Docker uses the native Docker API +and allows you to securely provision containers on bare metal. For detailed +instructions on using Joyent with Docker, see [Deploying Couchbase clusters the +easy way with Triton and +Docker](https://www.joyent.com/blog/couchbase-in-docker-containers) from Joyent. + +Joyent provides a `sdc-docker-setup.sh` script that makes it easy to use Docker +with Joyent. The [Docker API guide for +Triton](https://apidocs.joyent.com/docker) has details on using this script. + +Once you are up and running with Joyent, continue with the [Docker user guide](../userguide/). \ No newline at end of file diff --git a/docs/installation/mac.md b/docs/installation/mac.md new file mode 100644 index 0000000000..de9d01b970 --- /dev/null +++ b/docs/installation/mac.md @@ -0,0 +1,430 @@ + + +# Mac OS X + +> **Note**: This release of Docker deprecates the Boot2Docker command line in +> favor of Docker Machine. Use the Docker Toolbox to install Docker Machine as +> well as the other Docker tools. + +You install Docker using Docker Toolbox. Docker Toolbox includes the following Docker tools: + +* Docker Machine for running the `docker-machine` binary +* Docker Engine for running the `docker` binary +* Docker Compose for running the `docker-compose` binary +* Kitematic, the Docker GUI +* a shell preconfigured for a Docker command-line environment +* Oracle VM VirtualBox + +Because the Docker daemon uses Linux-specific kernel features, you can't run +Docker natively in OS X. Instead, you must use `docker-machine` to create and +attach to a virtual machine (VM). This machine is a Linux VM that hosts Docker +for you on your Mac. + +**Requirements** + +Your Mac must be running OS X 10.8 "Mountain Lion" or newer to install the +Docker Toolbox. + +### Learn the key concepts before installing + +In a Docker installation on Linux, your physical machine is both the localhost +and the Docker host. In networking, localhost means your computer. The Docker +host is the computer on which the containers run. + +On a typical Linux installation, the Docker client, the Docker daemon, and any +containers run directly on your localhost. This means you can address ports on a +Docker container using standard localhost addressing such as `localhost:8000` or +`0.0.0.0:8376`. + +![Linux Architecture Diagram](images/linux_docker_host.svg) + +In an OS X installation, the `docker` daemon is running inside a Linux VM called +`default`. The `default` is a lightweight Linux VM made specifically to run +the Docker daemon on Mac OS X. The VM runs completely from RAM, is a small ~24MB +download, and boots in approximately 5s. + +![OSX Architecture Diagram](images/mac_docker_host.svg) + +In OS X, the Docker host address is the address of the Linux VM. When you start +the VM with `docker-machine` it is assigned an IP address. When you start a +container, the ports on a container map to ports on the VM. To see this in +practice, work through the exercises on this page. + + +### Installation + +If you have VirtualBox running, you must shut it down before running the +installer. + +1. Go to the [Docker Toolbox](https://www.docker.com/toolbox) page. + +2. Click the installer link to download. + +3. Install Docker Toolbox by double-clicking the package or by right-clicking +and choosing "Open" from the pop-up menu. + + The installer launches the "Install Docker Toolbox" dialog. + + ![Install Docker Toolbox](images/mac-welcome-page.png) + +4. Press "Continue" to install the toolbox. + + The installer presents you with options to customize the standard + installation. + + ![Standard install](images/mac-page-two.png) + + By default, the standard Docker Toolbox installation: + + * installs binaries for the Docker tools in `/usr/local/bin` + * makes these binaries available to all users + * installs VirtualBox; or updates any existing installation + + Change these defaults by pressing "Customize" or "Change + Install Location." + +5. Press "Install" to perform the standard installation. + + The system prompts you for your password. + + ![Password prompt](images/mac-password-prompt.png) + +6. Provide your password to continue with the installation. + + When it completes, the installer provides you with some information you can + use to complete some common tasks. + + ![All finished](images/mac-page-finished.png) + +7. Press "Close" to exit. + + +## Running a Docker Container + +To run a Docker container, you: + +* create a new (or start an existing) Docker virtual machine +* switch your environment to your new VM +* use the `docker` client to create, load, and manage containers + +Once you create a machine, you can reuse it as often as you like. Like any +VirtualBox VM, it maintains its configuration between uses. + +There are two ways to use the installed tools, from the Docker Quickstart Terminal or +[from your shell](#from-your-shell). + +### From the Docker Quickstart Terminal + +1. Open the "Applications" folder or the "Launchpad". + +2. Find the Docker Quickstart Terminal and double-click to launch it. + + The application: + + * opens a terminal window + * creates a `default` VM if it doesn't exists, and starts the VM after + * points the terminal environment to this VM + + Once the launch completes, the Docker Quickstart Terminal reports: + + ![All finished](images/mac-success.png) + + Now, you can run `docker` commands. + +3. Verify your setup succeeded by running the `hello-world` container. + + $ docker run hello-world + Unable to find image 'hello-world:latest' locally + 511136ea3c5a: Pull complete + 31cbccb51277: Pull complete + e45a5af57b00: Pull complete + hello-world:latest: The image you are pulling has been verified. + Important: image verification is a tech preview feature and should not be + relied on to provide security. + Status: Downloaded newer image for hello-world:latest + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker client contacted the Docker daemon. + 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. + (Assuming it was not already locally available.) + 3. The Docker daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker daemon streamed that output to the Docker client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + For more examples and ideas, visit: + http://docs.docker.com/userguide/ + + +A more typical way to interact with the Docker tools is from your regular shell command line. + +### From your shell + +This section assumes you are running a Bash shell. You may be running a +different shell such as C Shell but the commands are the same. + +1. Create a new Docker VM. + + $ docker-machine create --driver virtualbox default + Creating VirtualBox VM... + Creating SSH key... + Starting VirtualBox VM... + Starting VM... + To see how to connect Docker to this machine, run: docker-machine env default + + This creates a new `default` VM in VirtualBox. + + The command also creates a machine configuration in the + `~/.docker/machine/machines/default` directory. You only need to run the + `create` command once. Then, you can use `docker-machine` to start, stop, + query, and otherwise manage the VM from the command line. + +2. List your available machines. + + $ docker-machine ls + NAME ACTIVE DRIVER STATE URL SWARM + default * virtualbox Running tcp://192.168.99.101:2376 + + If you have previously installed the deprecated Boot2Docker application or + run the Docker Quickstart Terminal, you may have a `dev` VM as well. When you + created `default` VM, the `docker-machine` command provided instructions + for learning how to connect the VM. + +3. Get the environment commands for your new VM. + + $ docker-machine env default + export DOCKER_TLS_VERIFY="1" + export DOCKER_HOST="tcp://192.168.99.101:2376" + export DOCKER_CERT_PATH="/Users/mary/.docker/machine/machines/default" + export DOCKER_MACHINE_NAME="default" + # Run this command to configure your shell: + # eval "$(docker-machine env default)" + +4. Connect your shell to the `default` machine. + + $ eval "$(docker-machine env default)" + +5. Run the `hello-world` container to verify your setup. + + $ docker run hello-world + + +## Learn about your Toolbox installation + +Toolbox installs the Docker Engine binary, the Docker binary on your system. When you +use the Docker Quickstart Terminal or create a `default` VM manually, Docker +Machine updates the `~/.docker/machine/machines/default` folder to your +system. This folder contains the configuration for the VM. + +You can create multiple VMs on your system with Docker Machine. Therefore, you +may end up with multiple VM folders if you have more than one VM. To remove a +VM, use the `docker-machine rm ` command. + +## Migrate from Boot2Docker + +If you were using Boot2Docker previously, you have a pre-existing Docker +`boot2docker-vm` VM on your local system. To allow Docker Machine to manage +this older VM, you can migrate it. + +1. Open a terminal or the Docker CLI on your system. + +2. Type the following command. + + $ docker-machine create -d virtualbox --virtualbox-import-boot2docker-vm boot2docker-vm docker-vm + +3. Use the `docker-machine` command to interact with the migrated VM. + +The `docker-machine` subcommands are slightly different than the `boot2docker` +subcommands. The table below lists the equivalent `docker-machine` subcommand +and what it does: + +| `boot2docker` | `docker-machine` | `docker-machine` description | +|----------------|------------------|----------------------------------------------------------| +| init | create | Creates a new docker host. | +| up | start | Starts a stopped machine. | +| ssh | ssh | Runs a command or interactive ssh session on the machine.| +| save | - | Not applicable. | +| down | stop | Stops a running machine. | +| poweroff | stop | Stops a running machine. | +| reset | restart | Restarts a running machine. | +| config | inspect | Prints machine configuration details. | +| status | ls | Lists all machines and their status. | +| info | inspect | Displays a machine's details. | +| ip | ip | Displays the machine's ip address. | +| shellinit | env | Displays shell commands needed to configure your shell to interact with a machine | +| delete | rm | Removes a machine. | +| download | - | Not applicable. | +| upgrade | upgrade | Upgrades a machine's Docker client to the latest stable release. | + + +## Example of Docker on Mac OS X + +Work through this section to try some practical container tasks on a VM. At this +point, you should have a VM running and be connected to it through your shell. +To verify this, run the following commands: + + $ docker-machine ls + NAME ACTIVE DRIVER STATE URL SWARM + default * virtualbox Running tcp://192.168.99.100:2376 + +The `ACTIVE` machine, in this case `default`, is the one your environment is pointing to. + +### Access container ports + +1. Start an NGINX container on the DOCKER_HOST. + + $ docker run -d -P --name web nginx + + Normally, the `docker run` commands starts a container, runs it, and then + exits. The `-d` flag keeps the container running in the background + after the `docker run` command completes. The `-P` flag publishes exposed ports from the + container to your local host; this lets you access them from your Mac. + +2. Display your running container with `docker ps` command + + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 5fb65ff765e9 nginx:latest "nginx -g 'daemon of 3 minutes ago Up 3 minutes 0.0.0.0:49156->443/tcp, 0.0.0.0:49157->80/tcp web + + At this point, you can see `nginx` is running as a daemon. + +3. View just the container's ports. + + $ docker port web + 443/tcp -> 0.0.0.0:49156 + 80/tcp -> 0.0.0.0:49157 + + This tells you that the `web` container's port `80` is mapped to port + `49157` on your Docker host. + +4. Enter the `http://localhost:49157` address (`localhost` is `0.0.0.0`) in your browser: + + ![Bad Address](images/bad_host.png) + + This didn't work. The reason it doesn't work is your `DOCKER_HOST` address is + not the localhost address (0.0.0.0) but is instead the address of the + your Docker VM. + +5. Get the address of the `default` VM. + + $ docker-machine ip default + 192.168.59.103 + +6. Enter the `http://192.168.59.103:49157` address in your browser: + + ![Correct Addressing](images/good_host.png) + + Success! + +7. To stop and then remove your running `nginx` container, do the following: + + $ docker stop web + $ docker rm web + +### Mount a volume on the container + +When you start a container it automatically shares your `/Users/username` directory +with the VM. You can use this share point to mount directories onto your container. +The next exercise demonstrates how to do this. + +1. Change to your user `$HOME` directory. + + $ cd $HOME + +2. Make a new `site` directory. + + $ mkdir site + +3. Change into the `site` directory. + + $ cd site + +4. Create a new `index.html` file. + + $ echo "my new site" > index.html + +5. Start a new `nginx` container and replace the `html` folder with your `site` directory. + + $ docker run -d -P -v $HOME/site:/usr/share/nginx/html \ + --name mysite nginx + +6. Get the `mysite` container's port. + + $ docker port mysite + 80/tcp -> 0.0.0.0:49166 + 443/tcp -> 0.0.0.0:49165 + +7. Open the site in a browser: + + ![My site page](images/newsite_view.png) + +8. Try adding a page to your `$HOME/site` in real time. + + $ echo "This is cool" > cool.html + +9. Open the new page in the browser. + + ![Cool page](images/cool_view.png) + +10. Stop and then remove your running `mysite` container. + + $ docker stop mysite + $ docker rm mysite + + +## Upgrade Docker Toolbox + +To upgrade Docker Toolbox, download an re-run [the Docker Toolbox +installer](https://docker.com/toolbox/). + + +## Uninstall Docker Toolbox + +To uninstall, do the following: + +1. List your machines. + + $ docker-machine ls + NAME ACTIVE DRIVER STATE URL SWARM + dev * virtualbox Running tcp://192.168.99.100:2376 + my-docker-machine virtualbox Stopped + default virtualbox Stopped + +2. Remove each machine. + + $ docker-machine rm dev + Successfully removed dev + + Removing a machine deletes its VM from VirtualBox and from the + `~/.docker/machine/machines` directory. + +3. Remove the Docker Quickstart Terminal and Kitematic from your "Applications" folder. + +4. Remove the `docker`, `docker-compose`, and `docker-machine` commands from the `/usr/local/bin` folder. + + $ rm /usr/local/bin/docker + +5. Delete the `~/.docker` folder from your system. + + +## Learning more + +Use `docker-machine help` to list the full command line reference for Docker Machine. For more +information about using SSH or SCP to access a VM, see [the Docker Machine +documentation](https://docs.docker.com/machine/). + +You can continue with the [Docker User Guide](../userguide). If you are +interested in using the Kitematic GUI, see the [Kitematic user +guide](https://docs.docker.com/kitematic/userguide/). diff --git a/docs/installation/oracle.md b/docs/installation/oracle.md new file mode 100644 index 0000000000..a575a3d1d8 --- /dev/null +++ b/docs/installation/oracle.md @@ -0,0 +1,202 @@ + + +# Oracle Linux + +Docker is supported Oracle Linux 6 and 7. You do not require an Oracle Linux +Support subscription to install Docker on Oracle Linux. + +This page instructs you to install using Docker-managed release packages and +installation mechanisms. Using these packages ensures you get the latest release +of Docker. If you wish to install using Oracle-managed packages, consult your +[Oracle Linux documentation](https://linux.oracle.com). + + +## Prerequisites + +Due to current Docker limitations, Docker is only able to run only on the x86_64 +architecture. Docker requires the use of the Unbreakable Enterprise Kernel +Release 3 (3.8.13) or higher on Oracle Linux. This kernel supports the Docker +btrfs storage engine on both Oracle Linux 6 and 7. + + + +## Install + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Add the yum repo yourself. + + For version 6: + + $ cat >/etc/yum.repos.d/docker.repo <<-EOF + [dockerrepo] + name=Docker Repository + baseurl=https://yum.dockerproject.org/repo/main/oraclelinux/6 + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + + For version 7: + + $ cat >/etc/yum.repos.d/docker.repo <<-EOF + [dockerrepo] + name=Docker Repository + baseurl=https://yum.dockerproject.org/repo/main/oraclelinux/7 + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + +4. Install the Docker package. + + $ sudo yum install docker + +5. Start the Docker daemon. + + On Oracle Linux 6: + + $ sudo service docker start + + On Oracle Linux 7: + + $ sudo systemctl start docker.service + +6. Verify `docker` is installed correctly by running a test image in a container. + + $ sudo docker run hello-world + +## Optional configurations + +This section contains optional procedures for configuring your Oracle Linux to work +better with Docker. + +* [Create a docker group](#create-a-docker-group) +* [Configure Docker to start on boot](#configure-docker-to-start-on-boot) +* [Use the btrfs storage engine](#use-the-btrfs-storage-engine) + +### Create a Docker group + +The `docker` daemon binds to a Unix socket instead of a TCP port. By default +that Unix socket is owned by the user `root` and other users can access it with +`sudo`. For this reason, `docker` daemon always runs as the `root` user. + +To avoid having to use `sudo` when you use the `docker` command, create a Unix +group called `docker` and add users to it. When the `docker` daemon starts, it +makes the ownership of the Unix socket read/writable by the `docker` group. + +>**Warning**: The `docker` group is equivalent to the `root` user; For details +>on how this impacts security in your system, see [*Docker Daemon Attack +>Surface*](../articles/security.md#docker-daemon-attack-surface) for details. + +To create the `docker` group and add your user: + +1. Log into Oracle Linux as a user with `sudo` privileges. + +2. Create the `docker` group and add your user. + + sudo usermod -aG docker username + +3. Log out and log back in. + + This ensures your user is running with the correct permissions. + +4. Verify your work by running `docker` without `sudo`. + + $ docker run hello-world + + If this fails with a message similar to this: + + Cannot connect to the Docker daemon. Is 'docker daemon' running on this host? + + Check that the `DOCKER_HOST` environment variable is not set for your shell. + If it is, unset it. + +### Configure Docker to start on boot + +You can configure the Docker daemon to start automatically at boot. + +On Oracle Linux 6: + +``` +$ sudo chkconfig docker on +``` + +On Oracle Linux 7: + +``` +$ sudo systemctl enable docker.service +``` + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our systemd article to +learn how to [customize your systemd Docker daemon options](../articles/systemd.md). + +### Use the btrfs storage engine + +Docker on Oracle Linux 6 and 7 supports the use of the btrfs storage engine. +Before enabling btrfs support, ensure that `/var/lib/docker` is stored on a +btrfs-based filesystem. Review [Chapter +5](http://docs.oracle.com/cd/E37670_01/E37355/html/ol_btrfs.html) of the [Oracle +Linux Administrator's Solution +Guide](http://docs.oracle.com/cd/E37670_01/E37355/html/index.html) for details +on how to create and mount btrfs filesystems. + +To enable btrfs support on Oracle Linux: + +1. Ensure that `/var/lib/docker` is on a btrfs filesystem. + +2. Edit `/etc/sysconfig/docker` and add `-s btrfs` to the `OTHER_ARGS` field. + +3. Restart the Docker daemon: + +## Uninstallation + +To uninstall the Docker package: + + $ sudo yum -y remove docker + +The above command will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. + +## Known issues + +### Docker unmounts btrfs filesystem on shutdown +If you're running Docker using the btrfs storage engine and you stop the Docker +service, it will unmount the btrfs filesystem during the shutdown process. You +should ensure the filesystem is mounted properly prior to restarting the Docker +service. + +On Oracle Linux 7, you can use a `systemd.mount` definition and modify the +Docker `systemd.service` to depend on the btrfs mount defined in systemd. + +### SElinux support on Oracle Linux 7 +SElinux must be set to `Permissive` or `Disabled` in `/etc/sysconfig/selinux` to +use the btrfs storage engine on Oracle Linux 7. + +## Further issues? + +If you have a current Basic or Premier Support Subscription for Oracle Linux, +you can report any issues you have with the installation of Docker via a Service +Request at [My Oracle Support](http://support.oracle.com). + +If you do not have an Oracle Linux Support Subscription, you can use the [Oracle +Linux +Forum](https://community.oracle.com/community/server_%26_storage_systems/linux/oracle_linux) for community-based support. diff --git a/docs/installation/rackspace.md b/docs/installation/rackspace.md new file mode 100644 index 0000000000..8eac4b2c33 --- /dev/null +++ b/docs/installation/rackspace.md @@ -0,0 +1,87 @@ + + +# Rackspace Cloud + +Installing Docker on Ubuntu provided by Rackspace is pretty +straightforward, and you should mostly be able to follow the +[*Ubuntu*](ubuntulinux.md#ubuntu-linux) installation guide. + +**However, there is one caveat:** + +If you are using any Linux not already shipping with the 3.8 kernel you +will need to install it. And this is a little more difficult on +Rackspace. + +Rackspace boots their servers using grub's `menu.lst` +and does not like non `virtual` packages (e.g., Xen compatible) +kernels there, although they do work. This results in +`update-grub` not having the expected result, and +you will need to set the kernel manually. + +**Do not attempt this on a production machine!** + + # update apt + $ apt-get update + + # install the new kernel + $ apt-get install linux-generic-lts-raring + +Great, now you have the kernel installed in `/boot/`, next you need to +make it boot next time. + + # find the exact names + $ find /boot/ -name '*3.8*' + + # this should return some results + +Now you need to manually edit `/boot/grub/menu.lst`, +you will find a section at the bottom with the existing options. Copy +the top one and substitute the new kernel into that. Make sure the new +kernel is on top, and double check the kernel and initrd lines point to +the right files. + +Take special care to double check the kernel and initrd entries. + + # now edit /boot/grub/menu.lst + $ vi /boot/grub/menu.lst + +It will probably look something like this: + + ## ## End Default Options ## + + title Ubuntu 12.04.2 LTS, kernel 3.8.x generic + root (hd0) + kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0 + initrd /boot/initrd.img-3.8.0-19-generic + + title Ubuntu 12.04.2 LTS, kernel 3.2.0-38-virtual + root (hd0) + kernel /boot/vmlinuz-3.2.0-38-virtual root=/dev/xvda1 ro quiet splash console=hvc0 + initrd /boot/initrd.img-3.2.0-38-virtual + + title Ubuntu 12.04.2 LTS, kernel 3.2.0-38-virtual (recovery mode) + root (hd0) + kernel /boot/vmlinuz-3.2.0-38-virtual root=/dev/xvda1 ro quiet splash single + initrd /boot/initrd.img-3.2.0-38-virtual + +Reboot the server (either via command line or console) + + # reboot + +Verify the kernel was updated + + $ uname -a + # Linux docker-12-04 3.8.0-19-generic #30~precise1-Ubuntu SMP Wed May 1 22:26:36 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + + # nice! 3.8. + +Now you can finish with the [*Ubuntu*](ubuntulinux.md#ubuntu-linux) +instructions. diff --git a/docs/installation/rhel.md b/docs/installation/rhel.md new file mode 100644 index 0000000000..efad29b9b1 --- /dev/null +++ b/docs/installation/rhel.md @@ -0,0 +1,179 @@ + + +# Red Hat Enterprise Linux + +Docker is supported on Red Hat Enterprise Linux 7. This page instructs you to +install using Docker-managed release packages and installation mechanisms. Using +these packages ensures you get the latest release of Docker. If you wish to +install using Red Hat-managed packages, consult your Red Hat release +documentation for information on Red Hat's Docker support. + +## Prerequisites + +Docker requires a 64-bit installation regardless of your Red Hat version. Docker +requires that your kernel must be 3.10 at minimum, which Red Hat 7 runs. + +To check your current kernel version, open a terminal and use `uname -r` to +display your kernel version: + + $ uname -r + 3.10.0-229.el7.x86_64 + +Finally, is it recommended that you fully update your system. Please keep in +mind that your system should be fully patched to fix any potential kernel bugs. +Any reported kernel bugs may have already been fixed on the latest kernel +packages. + +## Install Docker Engine + +There are two ways to install Docker Engine. You can install with the `yum` package manager directly yourself. Or you can use `curl` with the `get.docker.com` site. This second method runs an installation script which installs via the `yum` package manager. + +### Install with yum + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Add the yum repo yourself. + + $ cat >/etc/yum.repos.d/docker.repo <<-EOF + [dockerrepo] + name=Docker Repository + baseurl=https://yum.dockerproject.org/repo/main/centos/7 + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + +4. Install the Docker package. + + $ sudo yum install docker-engine + +5. Start the Docker daemon. + + $ sudo service docker start + +6. Verify `docker` is installed correctly by running a test image in a container. + + $ sudo docker run hello-world + Unable to find image 'hello-world:latest' locally + latest: Pulling from hello-world + a8219747be10: Pull complete + 91c95931e552: Already exists + hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security. + Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d + Status: Downloaded newer image for hello-world:latest + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker client contacted the Docker daemon. + 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. + (Assuming it was not already locally available.) + 3. The Docker daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker daemon streamed that output to the Docker client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + For more examples and ideas, visit: + http://docs.docker.com/userguide/ + +### Install with the script + +You use the same installation procedure for all versions of CentOS. + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Make sure your existing yum packages are up-to-date. + + $ sudo yum update + +3. Run the Docker installation script. + + $ curl -sSL https://get.docker.com/ | sh + +4. Start the Docker daemon. + + $ sudo service docker start + +5. Verify `docker` is installed correctly by running a test image in a container. + + $ sudo docker run hello-world + +## Create a docker group + +The `docker` daemon binds to a Unix socket instead of a TCP port. By default +that Unix socket is owned by the user `root` and other users can access it with +`sudo`. For this reason, `docker` daemon always runs as the `root` user. + +To avoid having to use `sudo` when you use the `docker` command, create a Unix +group called `docker` and add users to it. When the `docker` daemon starts, it +makes the ownership of the Unix socket read/writable by the `docker` group. + +>**Warning**: The `docker` group is equivalent to the `root` user; For details +>on how this impacts security in your system, see [*Docker Daemon Attack +>Surface*](../articles/security.md#docker-daemon-attack-surface) for details. + +To create the `docker` group and add your user: + +1. Log into your machine as a user with `sudo` or `root` privileges. + +2. Create the `docker` group and add your user. + + `sudo usermod -aG docker your_username` + +3. Log out and log back in. + + This ensures your user is running with the correct permissions. + +4. Verify your work by running `docker` without `sudo`. + + $ docker run hello-world + +## Start the docker daemon at boot + +To ensure Docker starts when you boot your system, do the following: + + $ sudo chkconfig docker on + +If you need to add an HTTP Proxy, set a different directory or partition for the +Docker runtime files, or make other customizations, read our Systemd article to +learn how to [customize your Systemd Docker daemon options](../articles/systemd.md). + + +## Uninstall + +You can uninstall the Docker software with `yum`. + +1. List the package you have installed. + + $ yum list installed | grep docker + yum list installed | grep docker + docker-engine.x86_64 1.7.1-0.1.el7@/docker-engine-1.7.1-0.1.el7.x86_64 + +2. Remove the package. + + $ sudo yum -y remove docker-engine.x86_64 + + This command does not remove images, containers, volumes, or user created + configuration files on your host. + +3. To delete all images, containers, and volumes run the following command: + + $ rm -rf /var/lib/docker + +4. Locate and delete any user-created configuration files. diff --git a/docs/installation/softlayer.md b/docs/installation/softlayer.md new file mode 100644 index 0000000000..f86a1619df --- /dev/null +++ b/docs/installation/softlayer.md @@ -0,0 +1,36 @@ + + +# IBM SoftLayer + +1. Create an [IBM SoftLayer account]( + https://www.softlayer.com/cloud-servers/). +2. Log in to the [SoftLayer Customer Portal]( + https://control.softlayer.com/). +3. From the *Devices* menu select [*Device List*](https://control.softlayer.com/devices) +4. Click *Order Devices* on the top right of the window below the menu bar. +5. Under *Virtual Server* click [*Hourly*](https://manage.softlayer.com/Sales/orderHourlyComputingInstance) +6. Create a new *SoftLayer Virtual Server Instance* (VSI) using the default + values for all the fields and choose: + + - The desired location for *Datacenter* + - *Ubuntu Linux 12.04 LTS Precise Pangolin - Minimal Install (64 bit)* + for *Operating System*. + +7. Click the *Continue Your Order* button at the bottom right. +8. Fill out VSI *hostname* and *domain*. +9. Insert the required *User Metadata* and place the order. +10. Then continue with the [*Ubuntu*](ubuntulinux.md#ubuntu-linux) + instructions. + +## What next? + +Continue with the [User Guide](../userguide/). + diff --git a/docs/installation/ubuntulinux.md b/docs/installation/ubuntulinux.md new file mode 100644 index 0000000000..26cf864fbc --- /dev/null +++ b/docs/installation/ubuntulinux.md @@ -0,0 +1,421 @@ + + +# Ubuntu + +Docker is supported on these Ubuntu operating systems: + +- Ubuntu Wily 15.10 +- Ubuntu Vivid 15.04 +- Ubuntu Trusty 14.04 (LTS) +- Ubuntu Precise 12.04 (LTS) + +This page instructs you to install using Docker-managed release packages and +installation mechanisms. Using these packages ensures you get the latest release +of Docker. If you wish to install using Ubuntu-managed packages, consult your +Ubuntu documentation. + +>**Note**: Ubuntu Utopic 14.10 exists in Docker's `apt` repository but it is no longer officially supported. + +## Prerequisites + +Docker requires a 64-bit installation regardless of your Ubuntu version. +Additionally, your kernel must be 3.10 at minimum. The latest 3.10 minor version +or a newer maintained version are also acceptable. + +Kernels older than 3.10 lack some of the features required to run Docker +containers. These older versions are known to have bugs which cause data loss +and frequently panic under certain conditions. + +To check your current kernel version, open a terminal and use `uname -r` to +display your kernel version: + + $ uname -r + 3.11.0-15-generic + +>**Note**: If you previously installed Docker using `apt`, make sure you update +your `apt` sources to the new Docker repository. + +### Update your apt sources + +Docker's `apt` repository contains Docker 1.7.1 and higher. To set `apt` to use +packages from the new repository: + +1. If you haven't already done so, log into your Ubuntu instance as a privileged user. + +2. Open a terminal window. + +3. Add the new `gpg` key. + + $ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D + +4. Open the `/etc/apt/sources.list.d/docker.list` file in your favorite editor. + + If the file doesn't exist, create it. + +5. Remove any existing entries. + +6. Add an entry for your Ubuntu operating system. + + The possible entries are: + + # Ubuntu Precise 12.04 (LTS) + deb https://apt.dockerproject.org/repo ubuntu-precise main + # Ubuntu Trusty 14.04 (LTS) + deb https://apt.dockerproject.org/repo ubuntu-trusty main + # Ubuntu Vivid 15.04 + deb https://apt.dockerproject.org/repo ubuntu-vivid main + # Ubuntu Wily 15.10 + deb https://apt.dockerproject.org/repo ubuntu-wily main + +7. Save and close the `/etc/apt/sources.list.d/docker.list` file. + +8. Update the `apt` package index. + + $ apt-get update + +9. Purge the old repo if it exists. + + $ apt-get purge lxc-docker* + +10. Verify that `apt` is pulling from the right repository. + + $ apt-cache policy docker-engine + + From now on when you run `apt-get upgrade`, `apt` pulls from the new repository. + +### Prerequisites by Ubuntu Version + +- Ubuntu Wily 15.10 +- Ubuntu Vivid 15.04 +- Ubuntu Trusty 14.04 (LTS) + +For Ubuntu Trusty, Vivid, and Wily, it's recommended to install the +`linux-image-extra` kernel package. The `linux-image-extra` package +allows you use the `aufs` storage driver. + +To install the `linux-image-extra` package for your kernel version: + +1. Open a terminal on your Ubuntu host. + +2. Update your package manager. + + $ sudo apt-get update + +3. Install the recommended package. + + $ sudo apt-get install linux-image-extra-$(uname -r) + +4. Go ahead and install Docker. + + +#### Ubuntu Precise 12.04 (LTS) + +For Ubuntu Precise, Docker requires the 3.13 kernel version. If your kernel +version is older than 3.13, you must upgrade it. Refer to this table to see +which packages are required for your environment: + + + +
linux-image-generic-lts-trusty Generic +Linux kernel image. This kernel has AUFS built in. This is required to run +Docker.
linux-headers-generic-lts-trustyAllows packages such as ZFS and VirtualBox guest additions +which depend on them. If you didn't install the headers for your existing +kernel, then you can skip these headers for the"trusty" kernel. If you're +unsure, you should include this package for safety.
xserver-xorg-lts-trusty Optional in non-graphical environments without Unity/Xorg. +Required when running Docker on machine with a graphical environment. +
+
To learn more about the reasons for these packages, read the installation +instructions for backported kernels, specifically the LTS +Enablement Stack — refer to note 5 under each version. +
libgl1-mesa-glx-lts-trusty
  + +To upgrade your kernel and install the additional packages, do the following: + +1. Open a terminal on your Ubuntu host. + +2. Update your package manager. + + $ sudo apt-get update + +3. Install both the required and optional packages. + + $ sudo apt-get install linux-image-generic-lts-trusty + + Depending on your environment, you may install more as described in the preceding table. + +4. Reboot your host. + + $ sudo reboot + +5. After your system reboots, go ahead and install Docker. + + + +## Install + +Make sure you have installed the prerequisites for your Ubuntu version. Then, +install Docker using the following: + +1. Log into your Ubuntu installation as a user with `sudo` privileges. + +2. Update your `apt` package index. + + $ sudo apt-get update + +3. Install Docker. + + $ sudo apt-get install docker-engine + +4. Start the `docker` daemon. + + $ sudo service docker start + +5. Verify `docker` is installed correctly. + + $ sudo docker run hello-world + + This command downloads a test image and runs it in a container. When the + container runs, it prints an informational message. Then, it exits. + +## Optional configurations + +This section contains optional procedures for configuring your Ubuntu to work +better with Docker. + +* [Create a docker group](#create-a-docker-group) +* [Adjust memory and swap accounting](#adjust-memory-and-swap-accounting) +* [Enable UFW forwarding](#enable-ufw-forwarding) +* [Configure a DNS server for use by Docker](#configure-a-dns-server-for-use-by-docker) +* [Configure Docker to start on boot](#configure-docker-to-start-on-boot) + +### Create a Docker group + +The `docker` daemon binds to a Unix socket instead of a TCP port. By default +that Unix socket is owned by the user `root` and other users can access it with +`sudo`. For this reason, `docker` daemon always runs as the `root` user. + +To avoid having to use `sudo` when you use the `docker` command, create a Unix +group called `docker` and add users to it. When the `docker` daemon starts, it +makes the ownership of the Unix socket read/writable by the `docker` group. + +>**Warning**: The `docker` group is equivalent to the `root` user; For details +>on how this impacts security in your system, see [*Docker Daemon Attack +>Surface*](../articles/security.md#docker-daemon-attack-surface) for details. + +To create the `docker` group and add your user: + +1. Log into Ubuntu as a user with `sudo` privileges. + + This procedure assumes you log in as the `ubuntu` user. + +3. Create the `docker` group and add your user. + + $ sudo usermod -aG docker ubuntu + +3. Log out and log back in. + + This ensures your user is running with the correct permissions. + +4. Verify your work by running `docker` without `sudo`. + + $ docker run hello-world + + If this fails with a message similar to this: + + Cannot connect to the Docker daemon. Is 'docker daemon' running on this host? + + Check that the `DOCKER_HOST` environment variable is not set for your shell. + If it is, unset it. + +### Adjust memory and swap accounting + +When users run Docker, they may see these messages when working with an image: + + WARNING: Your kernel does not support cgroup swap limit. WARNING: Your + kernel does not support swap limit capabilities. Limitation discarded. + +To prevent these messages, enable memory and swap accounting on your +system. Enabling memory and swap accounting does induce both a memory +overhead and a performance degradation even when Docker is not in +use. The memory overhead is about 1% of the total available +memory. The performance degradation is roughly 10%. + +To enable memory and swap on system using GNU GRUB (GNU GRand Unified +Bootloader), do the following: + +1. Log into Ubuntu as a user with `sudo` privileges. + +2. Edit the `/etc/default/grub` file. + +3. Set the `GRUB_CMDLINE_LINUX` value as follows: + + GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" + +4. Save and close the file. + +5. Update GRUB. + + $ sudo update-grub + +6. Reboot your system. + + +### Enable UFW forwarding + +If you use [UFW (Uncomplicated Firewall)](https://help.ubuntu.com/community/UFW) +on the same host as you run Docker, you'll need to do additional configuration. +Docker uses a bridge to manage container networking. By default, UFW drops all +forwarding traffic. As a result, for Docker to run when UFW is +enabled, you must set UFW's forwarding policy appropriately. + +Also, UFW's default set of rules denies all incoming traffic. If you want to +reach your containers from another host allow incoming connections on the Docker +port. The Docker port defaults to `2376` if TLS is enabled or `2375` when it is +not. If TLS is not enabled, communication is unencrypted. By default, Docker +runs without TLS enabled. + +To configure UFW and allow incoming connections on the Docker port: + +1. Log into Ubuntu as a user with `sudo` privileges. + +2. Verify that UFW is installed and enabled. + + $ sudo ufw status + +3. Open the `/etc/default/ufw` file for editing. + + $ sudo nano /etc/default/ufw + +4. Set the `DEFAULT_FORWARD_POLICY` policy to: + + DEFAULT_FORWARD_POLICY="ACCEPT" + +5. Save and close the file. + +6. Reload UFW to use the new setting. + + $ sudo ufw reload + +7. Allow incoming connections on the Docker port. + + $ sudo ufw allow 2375/tcp + +### Configure a DNS server for use by Docker + +Systems that run Ubuntu or an Ubuntu derivative on the desktop typically use +`127.0.0.1` as the default `nameserver` in `/etc/resolv.conf` file. The +NetworkManager also sets up `dnsmasq` to use the real DNS servers of the +connection and sets up `nameserver 127.0.0.1` in /`etc/resolv.conf`. + +When starting containers on desktop machines with these configurations, Docker +users see this warning: + + WARNING: Local (127.0.0.1) DNS resolver found in resolv.conf and containers + can't use it. Using default external servers : [8.8.8.8 8.8.4.4] + +The warning occurs because Docker containers can't use the local DNS nameserver. +Instead, Docker defaults to using an external nameserver. + +To avoid this warning, you can specify a DNS server for use by Docker +containers. Or, you can disable `dnsmasq` in NetworkManager. Though, disabling +`dnsmasq` might make DNS resolution slower on some networks. + +To specify a DNS server for use by Docker: + +1. Log into Ubuntu as a user with `sudo` privileges. + +2. Open the `/etc/default/docker` file for editing. + + $ sudo nano /etc/default/docker + +3. Add a setting for Docker. + + DOCKER_OPTS="--dns 8.8.8.8" + + Replace `8.8.8.8` with a local DNS server such as `192.168.1.1`. You can also + specify multiple DNS servers. Separated them with spaces, for example: + + --dns 8.8.8.8 --dns 192.168.1.1 + + >**Warning**: If you're doing this on a laptop which connects to various + >networks, make sure to choose a public DNS server. + +4. Save and close the file. + +5. Restart the Docker daemon. + + $ sudo restart docker + + +  +  + +**Or, as an alternative to the previous procedure,** disable `dnsmasq` in +NetworkManager (this might slow your network). + +1. Open the `/etc/NetworkManager/NetworkManager.conf` file for editing. + + $ sudo nano /etc/NetworkManager/NetworkManager.conf + +2. Comment out the `dns=dsnmasq` line: + + dns=dnsmasq + +3. Save and close the file. + +4. Restart both the NetworkManager and Docker. + + $ sudo restart network-manager + $ sudo restart docker + +### Configure Docker to start on boot + +Ubuntu uses `systemd` as its boot and service manager `15.04` onwards and `upstart` +for versions `14.10` and below. + +For `15.04` and up, to configure the `docker` daemon to start on boot, run + + $ sudo systemctl enable docker + +For `14.10` and below the above installation method automatically configures `upstart` +to start the docker daemon on boot + +## Upgrade Docker + +To install the latest version of Docker with `apt-get`: + + $ apt-get upgrade docker-engine + +## Uninstallation + +To uninstall the Docker package: + + $ sudo apt-get purge docker-engine + +To uninstall the Docker package and dependencies that are no longer needed: + + $ sudo apt-get autoremove --purge docker-engine + +The above commands will not remove images, containers, volumes, or user created +configuration files on your host. If you wish to delete all images, containers, +and volumes run the following command: + + $ rm -rf /var/lib/docker + +You must delete the user created configuration files manually. diff --git a/docs/installation/windows.md b/docs/installation/windows.md new file mode 100644 index 0000000000..48788abac3 --- /dev/null +++ b/docs/installation/windows.md @@ -0,0 +1,367 @@ + + +# Windows + +> **Note**: This release of Docker deprecates the Boot2Docker command line in +> favor of Docker Machine. Use the Docker Toolbox to install Docker Machine as +> well as the other Docker tools. + +You install Docker using Docker Toolbox. Docker Toolbox includes the following Docker tools: + +* Docker Machine for running the `docker-machine` binary +* Docker Engine for running the `docker` binary +* Kitematic, the Docker GUI +* a shell preconfigured for a Docker command-line environment +* Oracle VM VirtualBox + +Because the Docker daemon uses Linux-specific kernel features, you can't run +Docker natively in Windows. Instead, you must use `docker-machine` to create and attach to a Docker VM on your machine. This VM hosts Docker for you on your Windows system. + +The Docker VM is lightweight Linux virtual machine made specifically to run the +Docker daemon on Windows. The VirtualBox VM runs completely from RAM, is a +small ~24MB download, and boots in approximately 5s. + +## Requirements + +Your machine must be running Windows 7, 8/8.1 or newer to run Docker. Windows 10 is not currently supported. To find out what version of Windows you have: + +1. Right click the Windows Start Menu and choose **System**. + + ![Which version](images/win_ver.png) + + If you are using an unsupported version of Windows, you should consider + upgrading your operating system in order to try out Docker. + +2. Make sure your CPU supports [virtualization technology](https://en.wikipedia.org/wiki/X86_virtualization) +and virtualization support is enabled in BIOS and recognized by Windows. + + #### For Windows 8 or 8.1 + + Choose **Start > Task Manager** and navigate to the **Performance** tab. + Under **CPU** you should see the following: + + ![Release page](images/virtualization.png) + + If virtualization is not enabled on your system, follow the manufacturer's instructions for enabling it. + + #### For Windows 7 + + Run the Microsoft® Hardware-Assisted Virtualization Detection + Tool and follow the on-screen instructions. + + +> **Note**: If you have Docker hosts running and you don't wish to do a Docker Toolbox +installation, you can install the `docker.exe` using the *unofficial* Windows package +manager Chocolately. For information on how to do this, see [Docker package on +Chocolatey](http://chocolatey.org/packages/docker). + +### Learn the key concepts before installing + +In a Docker installation on Linux, your machine is both the localhost and the +Docker host. In networking, localhost means your computer. The Docker host is +the machine on which the containers run. + +On a typical Linux installation, the Docker client, the Docker daemon, and any +containers run directly on your localhost. This means you can address ports on a +Docker container using standard localhost addressing such as `localhost:8000` or +`0.0.0.0:8376`. + +![Linux Architecture Diagram](images/linux_docker_host.svg) + +In an Windows installation, the `docker` daemon is running inside a Linux virtual +machine. You use the Windows Docker client to talk to the Docker host VM. Your +Docker containers run inside this host. + +![Windows Architecture Diagram](images/win_docker_host.svg) + +In Windows, the Docker host address is the address of the Linux VM. When you +start the VM with `docker-machine` it is assigned an IP address. When you start +a container, the ports on a container map to ports on the VM. To see this in +practice, work through the exercises on this page. + + +### Installation + +If you have VirtualBox running, you must shut it down before running the +installer. + +1. Go to the [Docker Toolbox](https://www.docker.com/toolbox) page. + +2. Click the installer link to download. + +3. Install Docker Toolbox by double-clicking the installer. + + The installer launches the "Setup - Docker Toolbox" dialog. + + ![Install Docker Toolbox](images/win-welcome.png) + +4. Press "Next" to install the toolbox. + + The installer presents you with options to customize the standard + installation. By default, the standard Docker Toolbox installation: + + * installs executables for the Docker tools in `C:\Program Files\Docker Toolbox` + * install VirtualBox; or updates any existing installation + * adds a Docker Inc. folder to your program shortcuts + * updates your `PATH` environment variable + * adds desktop icons for the Docker Quickstart Terminal and Kitematic + + This installation assumes the defaults are acceptable. + +5. Press "Next" until you reach the "Ready to Install" page. + + The system prompts you for your password. + + ![Install](images/win-page-6.png) + +6. Press "Install" to continue with the installation. + + When it completes, the installer provides you with some information you can + use to complete some common tasks. + + ![All finished](images/windows-finish.png) + +7. Press "Finish" to exit. + +## Running a Docker Container + +To run a Docker container, you: + +* create a new (or start an existing) Docker virtual machine +* switch your environment to your new VM +* use the `docker` client to create, load, and manage containers + +Once you create a machine, you can reuse it as often as you like. Like any +VirtualBox VM, it maintains its configuration between uses. + +There are several ways to use the installed tools, from the Docker Quickstart Terminal or +[from your shell](#from-your-shell). + +### Using the Docker Quickstart Terminal + +1. Find the Docker Quickstart Terminal icon on your Desktop and double-click to launch it. + + The application: + + * opens a terminal window + * creates a `default` VM if it doesn't exist, and starts the VM after + * points the terminal environment to this VM + + Once the launch completes, you can run `docker` commands. + +3. Verify your setup succeeded by running the `hello-world` container. + + $ docker run hello-world + Unable to find image 'hello-world:latest' locally + 511136ea3c5a: Pull complete + 31cbccb51277: Pull complete + e45a5af57b00: Pull complete + hello-world:latest: The image you are pulling has been verified. + Important: image verification is a tech preview feature and should not be + relied on to provide security. + Status: Downloaded newer image for hello-world:latest + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker client contacted the Docker daemon. + 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. + (Assuming it was not already locally available.) + 3. The Docker daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker daemon streamed that output to the Docker client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + For more examples and ideas, visit: + http://docs.docker.com/userguide/ + + +### Using Docker from Windows Command Prompt (cmd.exe) + +1. Launch a Windows Command Prompt (cmd.exe). + + The `docker-machine` command requires `ssh.exe` in your `PATH` environment + variable. This `.exe` is in the MsysGit `bin` folder. + +2. Add this to the `%PATH%` environment variable by running: + + set PATH=%PATH%;"c:\Program Files (x86)\Git\bin" + +3. Create a new Docker VM. + + docker-machine create --driver virtualbox my-default + Creating VirtualBox VM... + Creating SSH key... + Starting VirtualBox VM... + Starting VM... + To see how to connect Docker to this machine, run: docker-machine env my-default + + The command also creates a machine configuration in the + `C:\USERS\USERNAME\.docker\machine\machines` directory. You only need to run the `create` + command once. Then, you can use `docker-machine` to start, stop, query, and + otherwise manage the VM from the command line. + +4. List your available machines. + + C:\Users\mary> docker-machine ls + NAME ACTIVE DRIVER STATE URL SWARM + my-default * virtualbox Running tcp://192.168.99.101:2376 + + If you have previously installed the deprecated Boot2Docker application or + run the Docker Quickstart Terminal, you may have a `dev` VM as well. + +5. Get the environment commands for your new VM. + + C:\Users\mary> docker-machine env --shell cmd my-default + +6. Connect your shell to the `my-default` machine. + + C:\Users\mary> eval "$(docker-machine env my-default)" + +7. Run the `hello-world` container to verify your setup. + + C:\Users\mary> docker run hello-world + +### Using Docker from PowerShell + +1. Launch a Windows PowerShell window. + +2. Add `ssh.exe` to your PATH: + + PS C:\Users\mary> $Env:Path = "${Env:Path};c:\Program Files (x86)\Git\bin" + +3. Create a new Docker VM. + + PS C:\Users\mary> docker-machine create --driver virtualbox my-default + +4. List your available machines. + + C:\Users\mary> docker-machine ls + NAME ACTIVE DRIVER STATE URL SWARM + my-default * virtualbox Running tcp://192.168.99.101:2376 + +5. Get the environment commands for your new VM. + + C:\Users\mary> docker-machine env --shell powershell my-default + +6. Connect your shell to the `my-default` machine. + + C:\Users\mary> eval "$(docker-machine env my-default)" + +7. Run the `hello-world` container to verify your setup. + + C:\Users\mary> docker run hello-world + + +## Learn about your Toolbox installation + +Toolbox installs the Docker Engine binary in the `C:\Program Files\Docker +Toolbox` directory. When you use the Docker Quickstart Terminal or create a +`default` VM manually, Docker Machine updates the +`C:\USERS\USERNAME\.docker\machine\machines\default` folder to your +system. This folder contains the configuration for the VM. + +You can create multiple VMs on your system with Docker Machine. Therefore, you +may end up with multiple VM folders if you have created more than one VM. To +remove a VM, use the `docker-machine rm ` command. + +## Migrate from Boot2Docker + +If you were using Boot2Docker previously, you have a pre-existing Docker +`boot2docker-vm` VM on your local system. To allow Docker Machine to manage +this older VM, you can migrate it. + +1. Open a terminal or the Docker CLI on your system. + +2. Type the following command. + + $ docker-machine create -d virtualbox --virtualbox-import-boot2docker-vm boot2docker-vm docker-vm + +3. Use the `docker-machine` command to interact with the migrated VM. + +The `docker-machine` subcommands are slightly different than the `boot2docker` +subcommands. The table below lists the equivalent `docker-machine` subcommand +and what it does: + +| `boot2docker` | `docker-machine` | `docker-machine` description | +|----------------|------------------|----------------------------------------------------------| +| init | create | Creates a new docker host. | +| up | start | Starts a stopped machine. | +| ssh | ssh | Runs a command or interactive ssh session on the machine.| +| save | - | Not applicable. | +| down | stop | Stops a running machine. | +| poweroff | stop | Stops a running machine. | +| reset | restart | Restarts a running machine. | +| config | inspect | Prints machine configuration details. | +| status | ls | Lists all machines and their status. | +| info | inspect | Displays a machine's details. | +| ip | ip | Displays the machine's ip address. | +| shellinit | env | Displays shell commands needed to configure your shell to interact with a machine | +| delete | rm | Removes a machine. | +| download | - | Not applicable. | +| upgrade | upgrade | Upgrades a machine's Docker client to the latest stable release. | + + +## Upgrade Docker Toolbox + +To upgrade Docker Toolbox, download an re-run [the Docker Toolbox +installer](https://www.docker.com/toolbox). + +## Container port redirection + +If you are curious, the username for the Docker default VM is `docker` and the +password is `tcuser`. The latest version of `docker-machine` sets up a host only +network adaptor which provides access to the container's ports. + +If you run a container with a published port: + + $ docker run --rm -i -t -p 80:80 nginx + +Then you should be able to access that nginx server using the IP address +reported to you using: + + $ docker-machine ip + +Typically, the IP is 192.168.59.103, but it could get changed by VirtualBox's +DHCP implementation. + +## Login with PUTTY instead of using the CMD + +Docker Machine generates and uses the public/private key pair in your +`%USERPROFILE%\.ssh` directory so to log in you need to use the private key from +this same directory. The private key needs to be converted into the format PuTTY +uses. You can do this with +[puttygen](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html): + +1. Open `puttygen.exe` and load ("File"->"Load" menu) the private key from + + %USERPROFILE%\.docker\machine\machines\ + +2. Click "Save Private Key". + +3. Use the saved file to login with PuTTY using `docker@127.0.0.1:2022`. + +## Uninstallation + +You can uninstall Docker Toolbox using Window's standard process for removing +programs. This process does not remove the `docker-install.exe` file. You must +delete that file yourself. + +## Learn more + +You can continue with the [Docker User Guide](../userguide). If you are +interested in using the Kitematic GUI, see the [Kitematic user +guide](https://docs.docker.com/kitematic/userguide/). diff --git a/docs/introduction/understanding-docker.md b/docs/introduction/understanding-docker.md new file mode 100644 index 0000000000..90330c4907 --- /dev/null +++ b/docs/introduction/understanding-docker.md @@ -0,0 +1,293 @@ + + +# Understand the architecture +**What is Docker?** + +Docker is an open platform for developing, shipping, and running applications. +Docker is designed to deliver your applications faster. With Docker you can +separate your applications from your infrastructure AND treat your +infrastructure like a managed application. Docker helps you ship code faster, +test faster, deploy faster, and shorten the cycle between writing code and +running code. + +Docker does this by combining a lightweight container virtualization platform +with workflows and tooling that help you manage and deploy your applications. + +At its core, Docker provides a way to run almost any application securely +isolated in a container. The isolation and security allow you to run many +containers simultaneously on your host. The lightweight nature of containers, +which run without the extra load of a hypervisor, means you can get more out of +your hardware. + +Surrounding the container virtualization are tooling and a platform which can +help you in several ways: + +* getting your applications (and supporting components) into Docker containers +* distributing and shipping those containers to your teams for further development +and testing +* deploying those applications to your production environment, + whether it be in a local data center or the Cloud. + +## What can I use Docker for? + +*Faster delivery of your applications* + +Docker is perfect for helping you with the development lifecycle. Docker +allows your developers to develop on local containers that contain your +applications and services. It can then integrate into a continuous integration and +deployment workflow. + +For example, your developers write code locally and share their development stack via +Docker with their colleagues. When they are ready, they push their code and the +stack they are developing onto a test environment and execute any required +tests. From the testing environment, you can then push the Docker images into +production and deploy your code. + +*Deploying and scaling more easily* + +Docker's container-based platform allows for highly portable workloads. Docker +containers can run on a developer's local host, on physical or virtual machines +in a data center, or in the Cloud. + +Docker's portability and lightweight nature also make dynamically managing +workloads easy. You can use Docker to quickly scale up or tear down applications +and services. Docker's speed means that scaling can be near real time. + +*Achieving higher density and running more workloads* + +Docker is lightweight and fast. It provides a viable, cost-effective alternative +to hypervisor-based virtual machines. This is especially useful in high density +environments: for example, building your own Cloud or Platform-as-a-Service. But +it is also useful for small and medium deployments where you want to get more +out of the resources you have. + +## What are the major Docker components? +Docker has two major components: + + +* Docker: the open source container virtualization platform. +* [Docker Hub](https://hub.docker.com): our Software-as-a-Service + platform for sharing and managing Docker containers. + + +> **Note:** Docker is licensed under the open source Apache 2.0 license. + +## What is Docker's architecture? +Docker uses a client-server architecture. The Docker *client* talks to the +Docker *daemon*, which does the heavy lifting of building, running, and +distributing your Docker containers. Both the Docker client and the daemon *can* +run on the same system, or you can connect a Docker client to a remote Docker +daemon. The Docker client and daemon communicate via sockets or through a +RESTful API. + +![Docker Architecture Diagram](../article-img/architecture.svg) + +### The Docker daemon +As shown in the diagram above, the Docker daemon runs on a host machine. The +user does not directly interact with the daemon, but instead through the Docker +client. + +### The Docker client +The Docker client, in the form of the `docker` binary, is the primary user +interface to Docker. It accepts commands from the user and communicates back and +forth with a Docker daemon. + +### Inside Docker +To understand Docker's internals, you need to know about three components: + +* Docker images. +* Docker registries. +* Docker containers. + +#### Docker images + +A Docker image is a read-only template. For example, an image could contain an Ubuntu +operating system with Apache and your web application installed. Images are used to create +Docker containers. Docker provides a simple way to build new images or update existing +images, or you can download Docker images that other people have already created. +Docker images are the **build** component of Docker. + +#### Docker registries +Docker registries hold images. These are public or private stores from which you +upload or download images. The public Docker registry is provided with the +[Docker Hub](http://hub.docker.com). It serves a huge collection of existing +images for your use. These can be images you create yourself or you can use +images that others have previously created. Docker registries are the +**distribution** component of Docker. + +#### Docker containers +Docker containers are similar to a directory. A Docker container holds everything that +is needed for an application to run. Each container is created from a Docker +image. Docker containers can be run, started, stopped, moved, and deleted. Each +container is an isolated and secure application platform. Docker containers are the + **run** component of Docker. + +## So how does Docker work? +So far, we've learned that: + +1. You can build Docker images that hold your applications. +2. You can create Docker containers from those Docker images to run your + applications. +3. You can share those Docker images via + [Docker Hub](https://hub.docker.com) or your own registry. + +Let's look at how these elements combine together to make Docker work. + +### How does a Docker image work? +We've already seen that Docker images are read-only templates from which Docker +containers are launched. Each image consists of a series of layers. Docker +makes use of [union file systems](http://en.wikipedia.org/wiki/UnionFS) to +combine these layers into a single image. Union file systems allow files and +directories of separate file systems, known as branches, to be transparently +overlaid, forming a single coherent file system. + +One of the reasons Docker is so lightweight is because of these layers. When you +change a Docker image—for example, update an application to a new version— a new layer +gets built. Thus, rather than replacing the whole image or entirely +rebuilding, as you may do with a virtual machine, only that layer is added or +updated. Now you don't need to distribute a whole new image, just the update, +making distributing Docker images faster and simpler. + +Every image starts from a base image, for example `ubuntu`, a base Ubuntu image, +or `fedora`, a base Fedora image. You can also use images of your own as the +basis for a new image, for example if you have a base Apache image you could use +this as the base of all your web application images. + +> **Note:** Docker usually gets these base images from +> [Docker Hub](https://hub.docker.com). + +Docker images are then built from these base images using a simple, descriptive +set of steps we call *instructions*. Each instruction creates a new layer in our +image. Instructions include actions like: + +* Run a command. +* Add a file or directory. +* Create an environment variable. +* What process to run when launching a container from this image. + +These instructions are stored in a file called a `Dockerfile`. Docker reads this +`Dockerfile` when you request a build of an image, executes the instructions, and +returns a final image. + +### How does a Docker registry work? +The Docker registry is the store for your Docker images. Once you build a Docker +image you can *push* it to a public registry such as the one provided by [Docker +Hub](https://hub.docker.com) or to your own registry running behind your +firewall. + +Using the Docker client, you can search for already published images and then +pull them down to your Docker host to build containers from them. + +[Docker Hub](https://hub.docker.com) provides both public and private storage +for images. Public storage is searchable and can be downloaded by anyone. +Private storage is excluded from search results and only you and your users can +pull images down and use them to build containers. You can [sign up for a storage plan +here](https://hub.docker.com/plans). + +### How does a container work? +A container consists of an operating system, user-added files, and meta-data. As +we've seen, each container is built from an image. That image tells Docker +what the container holds, what process to run when the container is launched, and +a variety of other configuration data. The Docker image is read-only. When +Docker runs a container from an image, it adds a read-write layer on top of the +image (using a union file system as we saw earlier) in which your application can +then run. + +### What happens when you run a container? +Either by using the `docker` binary or via the API, the Docker client tells the Docker +daemon to run a container. + + $ docker run -i -t ubuntu /bin/bash + +Let's break down this command. The Docker client is launched using the `docker` +binary with the `run` option telling it to launch a new container. The bare +minimum the Docker client needs to tell the Docker daemon to run the container +is: + +* What Docker image to build the container from, here `ubuntu`, a base Ubuntu +image; +* The command you want to run inside the container when it is launched, +here `/bin/bash`, to start the Bash shell inside the new container. + +So what happens under the hood when we run this command? + +In order, Docker does the following: + +- **Pulls the `ubuntu` image:** Docker checks for the presence of the `ubuntu` +image and, if it doesn't exist locally on the host, then Docker downloads it from +[Docker Hub](https://hub.docker.com). If the image already exists, then Docker +uses it for the new container. +- **Creates a new container:** Once Docker has the image, it uses it to create a +container. +- **Allocates a filesystem and mounts a read-write _layer_:** The container is created in +the file system and a read-write layer is added to the image. +- **Allocates a network / bridge interface:** Creates a network interface that allows the +Docker container to talk to the local host. +- **Sets up an IP address:** Finds and attaches an available IP address from a pool. +- **Executes a process that you specify:** Runs your application, and; +- **Captures and provides application output:** Connects and logs standard input, outputs +and errors for you to see how your application is running. + +You now have a running container! From here you can manage your container, interact with +your application and then, when finished, stop and remove your container. + +## The underlying technology +Docker is written in Go and makes use of several kernel features to +deliver the functionality we've seen. + +### Namespaces +Docker takes advantage of a technology called `namespaces` to provide the +isolated workspace we call the *container*. When you run a container, Docker +creates a set of *namespaces* for that container. + +This provides a layer of isolation: each aspect of a container runs in its own +namespace and does not have access outside it. + +Some of the namespaces that Docker uses on Linux are: + + - **The `pid` namespace:** Used for process isolation (PID: Process ID). + - **The `net` namespace:** Used for managing network interfaces (NET: + Networking). + - **The `ipc` namespace:** Used for managing access to IPC + resources (IPC: InterProcess Communication). + - **The `mnt` namespace:** Used for managing mount-points (MNT: Mount). + - **The `uts` namespace:** Used for isolating kernel and version identifiers. (UTS: Unix +Timesharing System). + +### Control groups +Docker on Linux also makes use of another technology called `cgroups` or control groups. +A key to running applications in isolation is to have them only use the +resources you want. This ensures containers are good multi-tenant citizens on a +host. Control groups allow Docker to share available hardware resources to +containers and, if required, set up limits and constraints. For example, +limiting the memory available to a specific container. + +### Union file systems +Union file systems, or UnionFS, are file systems that operate by creating layers, +making them very lightweight and fast. Docker uses union file systems to provide +the building blocks for containers. Docker can make use of several union file system variants +including: AUFS, btrfs, vfs, and DeviceMapper. + +### Container format +Docker combines these components into a wrapper we call a container format. The +default container format is called `libcontainer`. Docker also supports +traditional Linux containers using [LXC](https://linuxcontainers.org/). In the +future, Docker may support other container formats, for example, by integrating with +BSD Jails or Solaris Zones. + +## Next steps +### Installing Docker +Visit the [installation section](../installation/#installation). + +### The Docker user guide +[Learn Docker in depth](../userguide/). + + diff --git a/docs/misc/deprecated.md b/docs/misc/deprecated.md new file mode 100644 index 0000000000..3d2160edb9 --- /dev/null +++ b/docs/misc/deprecated.md @@ -0,0 +1,118 @@ + + +# Deprecated Features + +The following list of features are deprecated. + +### Command line short variant options +**Deprecated In Release: v1.9** + +**Target For Removal In Release: v1.11** + +The following short variant options are deprecated in favor of their long +variants: + + docker run -c (--cpu-shares) + docker build -c (--cpu-shares) + docker create -c (--cpu-shares) + +### Driver Specific Log Tags +**Deprecated In Release: v1.9** + +**Target For Removal In Release: v1.11** + +Log tags are now generated in a standard way across different logging drivers. +Because of which, the driver specific log tag options `syslog-tag`, `gelf-tag` and +`fluentd-tag` have been deprecated in favor of the generic `tag` option. + + docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}" + +### LXC built-in exec driver +**Deprecated In Release: v1.8** + +**Target For Removal In Release: v1.10** + +The built-in LXC execution driver is deprecated for an external implementation. +The lxc-conf flag and API fields will also be removed. + +### Old Command Line Options +**Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** + +**Target For Removal In Release: v1.10** + +The flags `-d` and `--daemon` are deprecated in favor of the `daemon` subcommand: + + docker daemon -H ... + +The following single-dash (`-opt`) variant of certain command line options +are deprecated and replaced with double-dash options (`--opt`): + + docker attach -nostdin + docker attach -sig-proxy + docker build -no-cache + docker build -rm + docker commit -author + docker commit -run + docker events -since + docker history -notrunc + docker images -notrunc + docker inspect -format + docker ps -beforeId + docker ps -notrunc + docker ps -sinceId + docker rm -link + docker run -cidfile + docker run -cpuset + docker run -dns + docker run -entrypoint + docker run -expose + docker run -link + docker run -lxc-conf + docker run -n + docker run -privileged + docker run -volumes-from + docker search -notrunc + docker search -stars + docker search -t + docker search -trusted + docker tag -force + +The following double-dash options are deprecated and have no replacement: + + docker run --networking + docker ps --since-id + docker ps --before-id + docker search --trusted + +### Auto-creating missing host paths for bind mounts +**Deprected in Release: v1.9** + +**Target for Removal in Release: 1.11** + +When creating a container with a bind-mounted volume-- `docker run -v /host/path:/container/path` -- +docker was automatically creating the `/host/path` if it didn't already exist. + +This auto-creation of the host path is deprecated and docker will error out if +the path does not exist. + +### Interacting with V1 registries + +Version 1.9 adds a flag (`--disable-legacy-registry=false`) which prevents the docker daemon from `pull`, `push`, and `login` operations against v1 registries. Though disabled by default, this signals the intent to deprecate the v1 protocol. + +### Docker Content Trust ENV passphrase variables name change +**Deprecated In Release: v1.9** + +**Target For Removal In Release: v1.10** + +As of 1.9, Docker Content Trust Offline key will be renamed to Root key and the Tagging key will be renamed to Repository key. Due to this renaming, we're also changing the corresponding environment variables + +- DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE will now be named DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE +- DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE will now be named DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE diff --git a/docs/misc/faq.md b/docs/misc/faq.md new file mode 100644 index 0000000000..1e3d4d97e6 --- /dev/null +++ b/docs/misc/faq.md @@ -0,0 +1,272 @@ + + +# Frequently Asked Questions (FAQ) + +If you don't see your question here, feel free to submit new ones to +. Or, you can fork [the +repo](https://github.com/docker/docker) and contribute them yourself by editing +the documentation sources. + + +### How much does Docker cost? + +Docker is 100% free. It is open source, so you can use it without paying. + +### What open source license are you using? + +We are using the Apache License Version 2.0, see it here: +[https://github.com/docker/docker/blob/master/LICENSE]( +https://github.com/docker/docker/blob/master/LICENSE) + +### Does Docker run on Mac OS X or Windows? + +Docker currently runs only on Linux, but you can use VirtualBox to run Docker in +a virtual machine on your box, and get the best of both worlds. Check out the +[*Mac OS X*](../installation/mac.md) and [*Microsoft +Windows*](../installation/windows.md) installation guides. The small Linux +distribution Docker Machine can be run inside virtual machines on these two +operating systems. + +>**Note:** if you are using a remote Docker daemon on a VM through Docker +>Machine, then _do not_ type the `sudo` before the `docker` commands shown in +>the documentation's examples. + +### How do containers compare to virtual machines? + +They are complementary. VMs are best used to allocate chunks of hardware +resources. Containers operate at the process level, which makes them very +lightweight and perfect as a unit of software delivery. + +### What does Docker add to just plain LXC? + +Docker is not a replacement for LXC. "LXC" refers to capabilities of the Linux +kernel (specifically namespaces and control groups) which allow sandboxing +processes from one another, and controlling their resource allocations. On top +of this low-level foundation of kernel features, Docker offers a high-level tool +with several powerful functionalities: + + - *Portable deployment across machines.* Docker defines a format for bundling + an application and all its dependencies into a single object which can be + transferred to any Docker-enabled machine, and executed there with the + guarantee that the execution environment exposed to the application will be the + same. LXC implements process sandboxing, which is an important pre-requisite + for portable deployment, but that alone is not enough for portable deployment. + If you sent me a copy of your application installed in a custom LXC + configuration, it would almost certainly not run on my machine the way it does + on yours, because it is tied to your machine's specific configuration: + networking, storage, logging, distro, etc. Docker defines an abstraction for + these machine-specific settings, so that the exact same Docker container can + run - unchanged - on many different machines, with many different + configurations. + + - *Application-centric.* Docker is optimized for the deployment of + applications, as opposed to machines. This is reflected in its API, user + interface, design philosophy and documentation. By contrast, the `lxc` helper + scripts focus on containers as lightweight machines - basically servers that + boot faster and need less RAM. We think there's more to containers than just + that. + + - *Automatic build.* Docker includes [*a tool for developers to automatically + assemble a container from their source + code*](../reference/builder.md), with full control over application + dependencies, build tools, packaging etc. They are free to use `make`, `maven`, + `chef`, `puppet`, `salt,` Debian packages, RPMs, source tarballs, or any + combination of the above, regardless of the configuration of the machines. + + - *Versioning.* Docker includes git-like capabilities for tracking successive + versions of a container, inspecting the diff between versions, committing new + versions, rolling back etc. The history also includes how a container was + assembled and by whom, so you get full traceability from the production server + all the way back to the upstream developer. Docker also implements incremental + uploads and downloads, similar to `git pull`, so new versions of a container + can be transferred by only sending diffs. + + - *Component re-use.* Any container can be used as a [*"base image"*](../reference/glossary.md#image) to create more specialized components. This can + be done manually or as part of an automated build. For example you can prepare + the ideal Python environment, and use it as a base for 10 different + applications. Your ideal PostgreSQL setup can be re-used for all your future + projects. And so on. + + - *Sharing.* Docker has access to a public registry [on Docker Hub](https://hub.docker.com/) + where thousands of people have uploaded useful images: anything from Redis, + CouchDB, PostgreSQL to IRC bouncers to Rails app servers to Hadoop to base + images for various Linux distros. The + [*registry*](https://docs.docker.com/registry/) also + includes an official "standard library" of useful containers maintained by the + Docker team. The registry itself is open-source, so anyone can deploy their own + registry to store and transfer private containers, for internal server + deployments for example. + + - *Tool ecosystem.* Docker defines an API for automating and customizing the + creation and deployment of containers. There are a huge number of tools + integrating with Docker to extend its capabilities. PaaS-like deployment + (Dokku, Deis, Flynn), multi-node orchestration (Maestro, Salt, Mesos, Openstack + Nova), management dashboards (docker-ui, Openstack Horizon, Shipyard), + configuration management (Chef, Puppet), continuous integration (Jenkins, + Strider, Travis), etc. Docker is rapidly establishing itself as the standard + for container-based tooling. + +### What is different between a Docker container and a VM? + +There's a great StackOverflow answer [showing the differences]( +http://stackoverflow.com/questions/16047306/how-is-docker-io-different-from-a-normal-virtual-machine). + +### Do I lose my data when the container exits? + +Not at all! Any data that your application writes to disk gets preserved in its +container until you explicitly delete the container. The file system for the +container persists even after the container halts. + +### How far do Docker containers scale? + +Some of the largest server farms in the world today are based on containers. +Large web deployments like Google and Twitter, and platform providers such as +Heroku and dotCloud all run on container technology, at a scale of hundreds of +thousands or even millions of containers running in parallel. + +### How do I connect Docker containers? + +Currently the recommended way to connect containers is via the Docker network feature. You can see details of how to [work with Docker networks here](https://docs.docker.com/networking). + +Also useful for more flexible service portability is the [Ambassador linking +pattern](../articles/ambassador_pattern_linking.md). + +### How do I run more than one process in a Docker container? + +Any capable process supervisor such as [http://supervisord.org/]( +http://supervisord.org/), runit, s6, or daemontools can do the trick. Docker +will start up the process management daemon which will then fork to run +additional processes. As long as the processor manager daemon continues to run, +the container will continue to as well. You can see a more substantial example +[that uses supervisord here](../articles/using_supervisord.md). + +### What platforms does Docker run on? + +Linux: + + - Ubuntu 12.04, 13.04 et al + - Fedora 19/20+ + - RHEL 6.5+ + - CentOS 6+ + - Gentoo + - ArchLinux + - openSUSE 12.3+ + - CRUX 3.0+ + +Cloud: + + - Amazon EC2 + - Google Compute Engine + - Microsoft Azure + - Rackspace + +### How do I report a security issue with Docker? + +You can learn about the project's security policy +[here](https://www.docker.com/security/) and report security issues to this +[mailbox](mailto:security@docker.com). + +### Why do I need to sign my commits to Docker with the DCO? + +Please read [our blog post]( +http://blog.docker.com/2014/01/docker-code-contributions-require-developer-certificate-of-origin/) on the introduction of the DCO. + +### When building an image, should I prefer system libraries or bundled ones? + +*This is a summary of a discussion on the [docker-dev mailing list]( +https://groups.google.com/forum/#!topic/docker-dev/L2RBSPDu1L0).* + +Virtually all programs depend on third-party libraries. Most frequently, they +will use dynamic linking and some kind of package dependency, so that when +multiple programs need the same library, it is installed only once. + +Some programs, however, will bundle their third-party libraries, because they +rely on very specific versions of those libraries. For instance, Node.js bundles +OpenSSL; MongoDB bundles V8 and Boost (among others). + +When creating a Docker image, is it better to use the bundled libraries, or +should you build those programs so that they use the default system libraries +instead? + +The key point about system libraries is not about saving disk or memory space. +It is about security. All major distributions handle security seriously, by +having dedicated security teams, following up closely with published +vulnerabilities, and disclosing advisories themselves. (Look at the [Debian +Security Information](https://www.debian.org/security/) for an example of those +procedures.) Upstream developers, however, do not always implement similar +practices. + +Before setting up a Docker image to compile a program from source, if you want +to use bundled libraries, you should check if the upstream authors provide a +convenient way to announce security vulnerabilities, and if they update their +bundled libraries in a timely manner. If they don't, you are exposing yourself +(and the users of your image) to security vulnerabilities. + +Likewise, before using packages built by others, you should check if the +channels providing those packages implement similar security best practices. +Downloading and installing an "all-in-one" .deb or .rpm sounds great at first, +except if you have no way to figure out that it contains a copy of the OpenSSL +library vulnerable to the [Heartbleed](http://heartbleed.com/) bug. + +### Why is `DEBIAN_FRONTEND=noninteractive` discouraged in Dockerfiles? + +When building Docker images on Debian and Ubuntu you may have seen errors like: + + unable to initialize frontend: Dialog + +These errors don't stop the image from being built but inform you that the +installation process tried to open a dialog box, but was unable to. Generally, +these errors are safe to ignore. + +Some people circumvent these errors by changing the `DEBIAN_FRONTEND` +environment variable inside the Dockerfile using: + + ENV DEBIAN_FRONTEND=noninteractive + +This prevents the installer from opening dialog boxes during installation which +stops the errors. + +While this may sound like a good idea, it *may* have side effects. The +`DEBIAN_FRONTEND` environment variable will be inherited by all images and +containers built from your image, effectively changing their behavior. People +using those images will run into problems when installing software +interactively, because installers will not show any dialog boxes. + +Because of this, and because setting `DEBIAN_FRONTEND` to `noninteractive` is +mainly a 'cosmetic' change, we *discourage* changing it. + +If you *really* need to change its setting, make sure to change it back to its +[default value](https://www.debian.org/releases/stable/i386/ch05s03.html.en) +afterwards. + +### Why do I get `Connection reset by peer` when making a request to a service running in a container? + +Typically, this message is returned if the service is already bound to your +localhost. As a result, requests coming to the container from outside are +dropped. To correct this problem, change the service's configuration on your +localhost so that the service accepts requests from all IPs. If you aren't sure +how to do this, check the documentation for your OS. + + +### Where can I find more answers? + +You can find more answers on: + + +- [Docker user mailinglist](https://groups.google.com/d/forum/docker-user) +- [Docker developer mailinglist](https://groups.google.com/d/forum/docker-dev) +- [IRC, docker on freenode](irc://chat.freenode.net#docker) +- [GitHub](https://github.com/docker/docker) +- [Ask questions on Stackoverflow](http://stackoverflow.com/search?q=docker) +- [Join the conversation on Twitter](http://twitter.com/docker) + +Looking for something else to read? Checkout the [User Guide](../userguide/). diff --git a/docs/misc/index.md b/docs/misc/index.md new file mode 100644 index 0000000000..6edf7a974b --- /dev/null +++ b/docs/misc/index.md @@ -0,0 +1,120 @@ + + +# About Docker + +**Develop, Ship and Run Any Application, Anywhere** + +[**Docker**](https://www.docker.com) is a platform for developers and sysadmins +to develop, ship, and run applications. Docker lets you quickly assemble +applications from components and eliminates the friction that can come when +shipping code. Docker lets you get your code tested and deployed into production +as fast as possible. + +Docker consists of: + +* The Docker Engine - our lightweight and powerful open source container + virtualization technology combined with a work flow for building + and containerizing your applications. +* [Docker Hub](https://hub.docker.com) - our SaaS service for + sharing and managing your application stacks. + +## Why Docker? + +*Faster delivery of your applications* + +* We want your environment to work better. Docker containers, + and the work flow that comes with them, help your developers, + sysadmins, QA folks, and release engineers work together to get your code + into production and make it useful. We've created a standard + container format that lets developers care about their applications + inside containers while sysadmins and operators can work on running the + container in your deployment. This separation of duties streamlines and + simplifies the management and deployment of code. +* We make it easy to build new containers, enable rapid iteration of + your applications, and increase the visibility of changes. This + helps everyone in your organization understand how an application works + and how it is built. +* Docker containers are lightweight and fast! Containers have + sub-second launch times, reducing the cycle + time of development, testing, and deployment. + +*Deploy and scale more easily* + +* Docker containers run (almost) everywhere. You can deploy + containers on desktops, physical servers, virtual machines, into + data centers, and up to public and private clouds. +* Since Docker runs on so many platforms, it's easy to move your + applications around. You can easily move an application from a + testing environment into the cloud and back whenever you need. +* Docker's lightweight containers also make scaling up and + down fast and easy. You can quickly launch more containers when + needed and then shut them down easily when they're no longer needed. + +*Get higher density and run more workloads* + +* Docker containers don't need a hypervisor, so you can pack more of + them onto your hosts. This means you get more value out of every + server and can potentially reduce what you spend on equipment and + licenses. + +*Faster deployment makes for easier management* + +* As Docker speeds up your work flow, it gets easier to make lots + of small changes instead of huge, big bang updates. Smaller + changes mean reduced risk and more uptime. + +## About this guide + +The [Understanding Docker section](../introduction/understanding-docker.md) will help you: + + - See how Docker works at a high level + - Understand the architecture of Docker + - Discover Docker's features; + - See how Docker compares to virtual machines + - See some common use cases. + +### Installation guides + +The [installation section](../installation) will show you how to install Docker +on a variety of platforms. + + +### Docker user guide + +To learn about Docker in more detail and to answer questions about usage and +implementation, check out the [Docker User Guide](../userguide/). + +## Release notes + +A summary of the changes in each release in the current series can now be found +on the separate [Release Notes page](https://docs.docker.com/release-notes) + +## Feature Deprecation Policy + +As changes are made to Docker there may be times when existing features +will need to be removed or replaced with newer features. Before an existing +feature is removed it will be labeled as "deprecated" within the documentation +and will remain in Docker for, usually, at least 2 releases. After that time +it may be removed. + +Users are expected to take note of the list of deprecated features each +release and plan their migration away from those features, and (if applicable) +towards the replacement features as soon as possible. + +The complete list of deprecated features can be found on the +[Deprecated Features page](deprecated.md). + +## Licensing + +Docker is licensed under the Apache License, Version 2.0. See +[LICENSE](https://github.com/docker/docker/blob/master/LICENSE) for the full +license text. + diff --git a/docs/misc/release-notes.md b/docs/misc/release-notes.md new file mode 100644 index 0000000000..b4d1dc1050 --- /dev/null +++ b/docs/misc/release-notes.md @@ -0,0 +1,161 @@ + + +# Deprecated Features + +To see the complete list of deprecated features please see the +[Deprecated Features](deprecated.md) page. + +# Removed Features + +The following features have been removed in this release: + +* None! + +# Release notes version 1.6.0 +(2015-04-16) + +You can view release notes for earlier version of Docker by selecting the +desired version from the drop-down list at the top right of this page. For the +formal release announcement, see [the Docker +blog](https://blog.docker.com/2015/04/docker-release-1-6/). + + + +## Docker Engine 1.6.0 features + +For a complete list of engine patches, fixes, and other improvements, see the +[merge PR on GitHub](https://github.com/docker/docker/pull/11635). You'll also +find [a changelog in the project +repository](https://github.com/docker/docker/blob/master/CHANGELOG.md). + +## Docker Engine 1.6.0 features + +For a complete list of engine patches, fixes, and other improvements, see the +[merge PR on GitHub](https://github.com/docker/docker/pull/11635). You'll also +find [a changelog in the project +repository](https://github.com/docker/docker/blob/master/CHANGELOG.md). + + +| Feature | Description | +|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Container and Image Labels | Labels allow you to attach user-defined metadata to containers and images that can be used by your tools. For additional information on using labels, see [Apply custom metadata](https://docs.docker.com/userguide/labels-custom-metadata.md#add-labels-to-images-the-label-instruction) in the documentation. | +| Windows Client preview | The Windows Client can be used just like the Mac OS X client is today with a remote host. Our testing infrastructure was scaled out to accommodate Windows Client testing on every PR to the Engine. See the Azure blog for [details on using this new client](http://azure.microsoft.com/blog/2015/04/16/docker-client-for-windows-is-now-available). | +| Logging drivers | The new logging driver follows the exec driver and storage driver concepts already available in Engine today. There is a new option `--log-driver` to `docker run` command. See the `run` reference for a [description on how to use this option](../reference/run.md#logging-drivers-log-driver). | +| Image digests | When you pull, build, or run images, you specify them in the form `namespace/repository:tag`, or even just `repository`. In this release, you are now able to pull, run, build and refer to images by a new content addressable identifier called a “digest” with the syntax `namespace/repo@digest`. See the the command line reference for [examples of using the digest](../reference/commandline/cli.md#listing-image-digests). | +| Custom cgroups | Containers are made from a combination of namespaces, capabilities, and cgroups. Docker already supports custom namespaces and capabilities. Additionally, in this release we’ve added support for custom cgroups. Using the `--cgroup-parent` flag, you can pass a specific `cgroup` to run a container in. See [the command line reference for more information](../reference/commandline/cli.md#create). | +| Ulimits | You can now specify the default `ulimit` settings for all containers when configuring the daemon. For example:`docker daemon --default-ulimit nproc=1024:2048` See [Default Ulimits](../reference/commandline/cli.md#default-ulimits) in this documentation. | +| Commit and import Dockerfile | You can now make changes to images on the fly without having to re-build the entire image. The feature `commit --change` and `import --change` allows you to apply standard changes to a new image. These are expressed in the Dockerfile syntax and used to modify the image. For details on how to use these, see the [commit](../reference/commandline/cli.md#commit) and [import](../reference/commandline/cli.md#import). | + +### Known issues in Engine + +This section lists significant known issues present in Docker as of release date. +For an exhaustive list of issues, see [the issues list on the project +repository](https://github.com/docker/docker/issues/). + +* *Unexpected File Permissions in Containers* +An idiosyncrasy in AUFS prevented permissions from propagating predictably +between upper and lower layers. This caused issues with accessing private +keys, database instances, etc. This issue was closed in this release: +[GitHub Issue 783](https://github.com/docker/docker/issues/783). + + +* *Docker Hub incompatible with Safari 8* +Docker Hub had multiple issues displaying on Safari 8, the default browser for +OS X 10.10 (Yosemite). Most notably, changes in the way Safari handled cookies +means that the user was repeatedly logged out. +Recently, Safari fixed the bug that was causing all the issues. If you upgrade +to Safari 8.0.5 which was just released last week and see if that fixes your +issues. You might have to flush your cookies if it doesn't work right away. +For more information, see the [Docker forum +post](https://forums.docker.com/t/new-safari-in-yosemite-issue/300). + +## Docker Registry 2.0 features + +This release includes Registry 2.0. The Docker Registry is a central server for +pushing and pulling images. In this release, it was completely rewritten in Go +around a new set of distribution APIs + +- **Webhook notifications**: You can now configure the Registry to send Webhooks +when images are pushed. Spin off a CI build, send a notification to IRC – +whatever you want! Included in the documentation is a detailed [notification +specification](https://docs.docker.com/registry/notifications/). + +- **Native TLS support**: This release makes it easier to secure a registry with +TLS. This documentation includes [expanded examples of secure +deployments](https://docs.docker.com/registry/deploying/). + +- **New Distribution APIs**: This release includes an expanded set of new +distribution APIs. You can read the [detailed specification +here](https://docs.docker.com/registry/spec/api/). + + +## Docker Compose 1.2 + +For a complete list of compose patches, fixes, and other improvements, see the +[changelog in the project +repository](https://github.com/docker/compose/blob/1.2.0/CHANGES.md). The +project also makes a [set of release +notes](https://github.com/docker/compose/releases/tag/1.2.0) on the project. + +- **extends**: You can use `extends` to share configuration between services +with the keyword “extends”. With extends, you can refer to a service defined +elsewhere and include its configuration in a locally-defined service, while also +adding or overriding configuration as necessary. The documentation describes +[how to use extends in your +configuration](https://docs.docker.com/compose/extends/#extending-services-in- +compose). + +- **Relative directory handling may cause breaking change**: Compose now treats +directories passed to build, filenames passed to `env_file` and volume host +paths passed to volumes as relative to the configuration file's directory. +Previously, they were treated as relative to the directory where you were +running `docker-compose`. In the majority of cases, the location of the +configuration file and where you ran `docker-compose` were the same directory. +Now, you can use the `-f|--file` argument to specify a configuration file in +another directory. + + +## Docker Swarm 0.2 + +You'll find the [release for download on +GitHub](https://github.com/docker/swarm/releases/tag/v0.2.0) and [the +documentation here](https://docs.docker.com/swarm/). This release includes the +following features: + +- **Spread strategy**: A new strategy for scheduling containers on your cluster +which evenly spreads them over available nodes. +- **More Docker commands supported**: More progress has been made towards +supporting the complete Docker API, such as pulling and inspecting images. +- **Clustering drivers**: There are not any third-party drivers yet, but the +first steps have been made towards making a pluggable driver interface that will +make it possible to use Swarm with clustering systems such as Mesos. + + +## Docker Machine 0.2 Pre-release + +You'll find the [release for download on +GitHub](https://github.com/docker/machine/releases) and [the documentation +here](https://docs.docker.com/machine/). For a complete list of machine changes +see [the changelog in the project +repository](https://github.com/docker/machine/blob/master/CHANGES.md#020-2015-03 +-22). + +- **Cleaner driver interface**: It is now much easier to write drivers for providers. +- **More reliable and consistent provisioning**: Provisioning servers is now +handled centrally by Machine instead of letting each driver individually do it. +- **Regenerate TLS certificates**: A new command has been added to regenerate a +host’s TLS certificates for good security practice and for if a host’s IP +address changes. + +## Docker Hub Enterprise & Commercially Supported Docker Engine + +See the [DHE and CS Docker Engine release notes](https://docs.docker.com/docker-hub-enterprise/release-notes.md). diff --git a/docs/misc/search.md b/docs/misc/search.md new file mode 100644 index 0000000000..277ba26ec6 --- /dev/null +++ b/docs/misc/search.md @@ -0,0 +1,16 @@ + + +# Search + +*Please activate JavaScript to enable the search functionality.* + +## How To Search + +From here you can search these documents. Enter your search words into +the box below and click "search". Note that the search function will +automatically search for all of the words. Pages containing fewer words +won't appear in the result list. diff --git a/docs/reference/api/README.md b/docs/reference/api/README.md new file mode 100644 index 0000000000..ec1cbcb2c3 --- /dev/null +++ b/docs/reference/api/README.md @@ -0,0 +1,9 @@ +This directory holds the authoritative specifications of APIs defined and implemented by Docker. Currently this includes: + + * The remote API by which a docker node can be queried over HTTP + * The registry API by which a docker node can download and upload + images for storage and sharing + * The index search API by which a docker node can search the public + index for images to download + * The docker.io OAuth and accounts API which 3rd party services can + use to access account information diff --git a/docs/reference/api/_static/io_oauth_authorization_page.png b/docs/reference/api/_static/io_oauth_authorization_page.png new file mode 100644 index 0000000000000000000000000000000000000000..455d631e178921fd513e05b5418fd9f588c6e6a6 GIT binary patch literal 39458 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 z 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 literal 0 HcmV?d00001 diff --git a/docs/reference/api/docker-io_api.md b/docs/reference/api/docker-io_api.md new file mode 100644 index 0000000000..85b2a99f3f --- /dev/null +++ b/docs/reference/api/docker-io_api.md @@ -0,0 +1,15 @@ + + +# Docker Hub API + +This API is deprecated as of 1.7. To view the old version, see the [Docker Hub API](docker-io_api.md) in the 1.7 documentation. + diff --git a/docs/reference/api/docker_io_accounts_api.md b/docs/reference/api/docker_io_accounts_api.md new file mode 100644 index 0000000000..fd9b2787ef --- /dev/null +++ b/docs/reference/api/docker_io_accounts_api.md @@ -0,0 +1,276 @@ + + +# docker.io accounts API + +## Get a single user + +`GET /api/v1.1/users/:username/` + +Get profile info for the specified user. + +Parameters: + +- **username** – username of the user whose profile info is being + requested. + +Request Headers: + +- **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. + +Status Codes: + +- **200** – success, user data returned. +- **401** – authentication error. +- **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `profile_read` scope. +- **404** – the specified username does not exist. + +**Example request**: + + GET /api/v1.1/users/janedoe/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id": 2, + "username": "janedoe", + "url": "https://www.docker.io/api/v1.1/users/janedoe/", + "date_joined": "2014-02-12T17:58:01.431312Z", + "type": "User", + "full_name": "Jane Doe", + "location": "San Francisco, CA", + "company": "Success, Inc.", + "profile_url": "https://docker.io/", + "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm" + "email": "jane.doe@example.com", + "is_active": true + } + +## Update a single user + +`PATCH /api/v1.1/users/:username/` + +Update profile info for the specified user. + +Parameters: + +- **username** – username of the user whose profile info is being + updated. + +Json Parameters: + +- **full_name** (*string*) – (optional) the new name of the user. +- **location** (*string*) – (optional) the new location. +- **company** (*string*) – (optional) the new company of the user. +- **profile_url** (*string*) – (optional) the new profile url. +- **gravatar_email** (*string*) – (optional) the new Gravatar + email address. + +Request Headers: + +- **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + +Status Codes: + +- **200** – success, user data updated. +- **400** – post data validation error. +- **401** – authentication error. +- **403** – permission error, authenticated user must be the user + whose data is being updated, OAuth access tokens must have + `profile_write` scope. +- **404** – the specified username does not exist. + +**Example request**: + + PATCH /api/v1.1/users/janedoe/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= + + { + "location": "Private Island", + "profile_url": "http://janedoe.com/", + "company": "Retired", + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id": 2, + "username": "janedoe", + "url": "https://www.docker.io/api/v1.1/users/janedoe/", + "date_joined": "2014-02-12T17:58:01.431312Z", + "type": "User", + "full_name": "Jane Doe", + "location": "Private Island", + "company": "Retired", + "profile_url": "http://janedoe.com/", + "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm" + "email": "jane.doe@example.com", + "is_active": true + } + +## List email addresses for a user + +`GET /api/v1.1/users/:username/emails/` + +List email info for the specified user. + +Parameters: + +- **username** – username of the user whose profile info is being + updated. + +Request Headers: + +- **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token + +Status Codes: + +- **200** – success, user data updated. +- **401** – authentication error. +- **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `email_read` scope. +- **404** – the specified username does not exist. + +**Example request**: + + GET /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "email": "jane.doe@example.com", + "verified": true, + "primary": true + } + ] + +## Add email address for a user + +`POST /api/v1.1/users/:username/emails/` + +Add a new email address to the specified user's account. The email +address must be verified separately, a confirmation email is not +automatically sent. + +Json Parameters: + +- **email** (*string*) – email address to be added. + +Request Headers: + +- **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + +Status Codes: + +- **201** – success, new email added. +- **400** – data validation error. +- **401** – authentication error. +- **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `email_write` scope. +- **404** – the specified username does not exist. + +**Example request**: + + POST /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM + + { + "email": "jane.doe+other@example.com" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "email": "jane.doe+other@example.com", + "verified": false, + "primary": false + } + +## Delete email address for a user + +`DELETE /api/v1.1/users/:username/emails/` + +Delete an email address from the specified user's account. You +cannot delete a user's primary email address. + +Json Parameters: + +- **email** (*string*) – email address to be deleted. + +Request Headers: + +- **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + +Status Codes: + +- **204** – success, email address removed. +- **400** – validation error. +- **401** – authentication error. +- **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `email_write` scope. +- **404** – the specified username or email address does not + exist. + +**Example request**: + + DELETE /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM + + { + "email": "jane.doe+other@example.com" + } + +**Example response**: + + HTTP/1.1 204 NO CONTENT + Content-Length: 0 diff --git a/docs/reference/api/docker_remote_api.md b/docs/reference/api/docker_remote_api.md new file mode 100644 index 0000000000..0964adefd7 --- /dev/null +++ b/docs/reference/api/docker_remote_api.md @@ -0,0 +1,215 @@ + + +# Docker Remote API + +Docker's Remote API uses an open schema model. In this model, unknown +properties in incoming messages are ignored. Client applications need to take +this behavior into account to ensure they do not break when talking to newer +Docker daemons. + +The API tends to be REST, but for some complex commands, like attach or pull, +the HTTP connection is hijacked to transport STDOUT, STDIN, and STDERR. + +By default the Docker daemon listens on `unix:///var/run/docker.sock` and the +client must have `root` access to interact with the daemon. If a group named +`docker` exists on your system, `docker` applies ownership of the socket to the +group. + +The current version of the API is v1.21 which means calling `/info` is the same +as calling `/v1.21/info`. To call an older version of the API use +`/v1.20/info`. + +Use the table below to find the API version for a Docker version: + +Docker version | API version | Changes +----------------|-------------------------------------------------|----------------------------- +1.9.x | [1.21](docker_remote_api_v1.21.md) | [API changes](docker_remote_api.md#v1-21-api-changes) +1.8.x | [1.20](docker_remote_api_v1.20.md) | [API changes](docker_remote_api.md#v1-20-api-changes) +1.7.x | [1.19](docker_remote_api_v1.19.md) | [API changes](docker_remote_api.md#v1-19-api-changes) +1.6.x | [1.18](docker_remote_api_v1.18.md) | [API changes](docker_remote_api.md#v1-18-api-changes) +1.5.x | [1.17](docker_remote_api_v1.17.md) | [API changes](docker_remote_api.md#v1-17-api-changes) +1.4.x | [1.16](docker_remote_api_v1.16.md) | [API changes](docker_remote_api.md#v1-16-api-changes) +1.3.x | [1.15](docker_remote_api_v1.15.md) | [API changes](docker_remote_api.md#v1-15-api-changes) +1.2.x | [1.14](docker_remote_api_v1.14.md) | [API changes](docker_remote_api.md#v1-14-api-changes) + +Refer to the [GitHub repository]( +https://github.com/docker/docker/tree/master/docs/reference/api) for +older releases. + +## Authentication + +Since API version 1.2, the auth configuration is now handled client side, so the +client has to send the `authConfig` as a `POST` in `/images/(name)/push`. The +`authConfig`, set as the `X-Registry-Auth` header, is currently a Base64 encoded +(JSON) string with the following structure: + +``` +{"username": "string", "password": "string", "email": "string", + "serveraddress" : "string", "auth": ""} +``` + +Callers should leave the `auth` empty. The `serveraddress` is a domain/ip +without protocol. Throughout this structure, double quotes are required. + +## Using Docker Machine with the API + +If you are using `docker-machine`, the Docker daemon is on a virtual host that uses an encrypted TCP socket. This means, for Docker Machine users, you need to add extra parameters to `curl` or `wget` when making test API requests, for example: + +``` +curl --insecure --cert ~/.docker/cert.pem --key ~/.docker/key.pem https://YOUR_VM_IP:2376/images/json + +wget --no-check-certificate --certificate=$DOCKER_CERT_PATH/cert.pem --private-key=$DOCKER_CERT_PATH/key.pem https://your_vm_ip:2376/images/json -O - -q +``` + +## Docker Events + +The following diagram depicts the container states accessible through the API. + +![States](images/event_state.png) + +Some container-related events are not affected by container state, so they are not included in this diagram. These events are: + +* **export** emitted by `docker export` +* **exec_create** emitted by `docker exec` +* **exec_start** emitted by `docker exec` after **exec_create** + +Running `docker rmi` emits an **untag** event when removing an image name. The `rmi` command may also emit **delete** events when images are deleted by ID directly or by deleting the last tag referring to the image. + +> **Acknowledgement**: This diagram and the accompanying text were used with the permission of Matt Good and Gilder Labs. See Matt's original blog post [Docker Events Explained](http://gliderlabs.com/blog/2015/04/14/docker-events-explained/). + +## Version history + +This section lists each version from latest to oldest. Each listing includes a link to the full documentation set and the changes relevant in that release. + +### v1.21 API changes + +[Docker Remote API v1.21](docker_remote_api_v1.21.md) documentation + +* `GET /volumes` lists volumes from all volume drivers. +* `POST /volumes/create` to create a volume. +* `GET /volumes/(name)` get low-level information about a volume. +* `DELETE /volumes/(name)`remove a volume with the specified name. +* `VolumeDriver` has been moved from config to hostConfig to make the configuration portable. +* `GET /images/(name)/json` now returns information about tags and digests of the image. +* The `config` option now accepts the field `StopSignal`, which specifies the signal to use to kill a container. +* `GET /containers/(id)/stats` will return networking information respectively for each interface. +* The `hostConfig` option now accepts the field `DnsOptions`, which specifies a +list of DNS options to be used in the container. +* `POST /build` now optionally takes a serialized map of build-time variables. +* `GET /events` now includes a `timenano` field, in addition to the existing `time` field. +* `GET /events` now supports filtering by image and container labels. +* `GET /info` now lists engine version information. +* `GET /containers/json` will return `ImageID` of the image used by container. +* `POST /exec/(name)/start` will now return an HTTP 409 when the container is either stopped or paused. +* `GET /containers/(name)/json` now accepts a `size` parameter. Setting this parameter to '1' returns container size information in the `SizeRw` and `SizeRootFs` fields. +* `GET /containers/(name)/json` now returns a `NetworkSettings.Networks` field, + detailing network settings per network. This field deprecates the + `NetworkSettings.Gateway`, `NetworkSettings.IPAddress`, + `NetworkSettings.IPPrefixLen`, and `NetworkSettings.MacAddress` fields, which + are still returned for backward-compatibility, but will be removed in a future version. +* `GET /exec/(id)/json` now returns a `NetworkSettings.Networks` field, + detailing networksettings per network. This field deprecates the + `NetworkSettings.Gateway`, `NetworkSettings.IPAddress`, + `NetworkSettings.IPPrefixLen`, and `NetworkSettings.MacAddress` fields, which + are still returned for backward-compatibility, but will be removed in a future version. + +### v1.20 API changes + +[Docker Remote API v1.20](docker_remote_api_v1.20.md) documentation + +* `GET /containers/(id)/archive` get an archive of filesystem content from a container. +* `PUT /containers/(id)/archive` upload an archive of content to be extracted to +an existing directory inside a container's filesystem. +* `POST /containers/(id)/copy` is deprecated in favor of the above `archive` +endpoint which can be used to download files and directories from a container. +* The `hostConfig` option now accepts the field `GroupAdd`, which specifies a +list of additional groups that the container process will run as. + +### v1.19 API changes + +[Docker Remote API v1.19](docker_remote_api_v1.19.md) documentation + +* When the daemon detects a version mismatch with the client, usually when +the client is newer than the daemon, an HTTP 400 is now returned instead +of a 404. +* `GET /containers/(id)/stats` now accepts `stream` bool to get only one set of stats and disconnect. +* `GET /containers/(id)/logs` now accepts a `since` timestamp parameter. +* `GET /info` The fields `Debug`, `IPv4Forwarding`, `MemoryLimit`, and +`SwapLimit` are now returned as boolean instead of as an int. In addition, the +end point now returns the new boolean fields `CpuCfsPeriod`, `CpuCfsQuota`, and +`OomKillDisable`. +* The `hostConfig` option now accepts the fields `CpuPeriod` and `CpuQuota` +* `POST /build` accepts `cpuperiod` and `cpuquota` options + +### v1.18 API changes + +[Docker Remote API v1.18](docker_remote_api_v1.18.md) documentation + +* `GET /version` now returns `Os`, `Arch` and `KernelVersion`. +* `POST /containers/create` and `POST /containers/(id)/start`allow you to set ulimit settings for use in the container. +* `GET /info` now returns `SystemTime`, `HttpProxy`,`HttpsProxy` and `NoProxy`. +* `GET /images/json` added a `RepoDigests` field to include image digest information. +* `POST /build` can now set resource constraints for all containers created for the build. +* `CgroupParent` can be passed in the host config to setup container cgroups under a specific cgroup. +* `POST /build` closing the HTTP request cancels the build +* `POST /containers/(id)/exec` includes `Warnings` field to response. + +### v1.17 API changes + +[Docker Remote API v1.17](docker_remote_api_v1.17.md) documentation + +* The build supports `LABEL` command. Use this to add metadata to an image. For +example you could add data describing the content of an image. `LABEL +"com.example.vendor"="ACME Incorporated"` +* `POST /containers/(id)/attach` and `POST /exec/(id)/start` +* The Docker client now hints potential proxies about connection hijacking using HTTP Upgrade headers. +* `POST /containers/create` sets labels on container create describing the container. +* `GET /containers/json` returns the labels associated with the containers (`Labels`). +* `GET /containers/(id)/json` returns the list current execs associated with the +container (`ExecIDs`). This endpoint now returns the container labels +(`Config.Labels`). +* `POST /containers/(id)/rename` renames a container `id` to a new name.* +* `POST /containers/create` and `POST /containers/(id)/start` callers can pass +`ReadonlyRootfs` in the host config to mount the container's root filesystem as +read only. +* `GET /containers/(id)/stats` returns a live stream of a container's resource usage statistics. +* `GET /images/json` returns the labels associated with each image (`Labels`). + + +### v1.16 API changes + +[Docker Remote API v1.16](docker_remote_api_v1.16.md) + +* `GET /info` returns the number of CPUs available on the machine (`NCPU`), +total memory available (`MemTotal`), a user-friendly name describing the running Docker daemon (`Name`), a unique ID identifying the daemon (`ID`), and +a list of daemon labels (`Labels`). +* `POST /containers/create` callers can set the new container's MAC address explicitly. +* Volumes are now initialized when the container is created. +* `POST /containers/(id)/copy` copies data which is contained in a volume. + +### v1.15 API changes + +[Docker Remote API v1.15](docker_remote_api_v1.15.md) documentation + +`POST /containers/create` you can set a container's `HostConfig` when creating a +container. Previously this was only available when starting a container. + +### v1.14 API changes + +[Docker Remote API v1.14](docker_remote_api_v1.14.md) documentation + +* `DELETE /containers/(id)` when using `force`, the container will be immediately killed with SIGKILL. +* `POST /containers/(id)/start` the `hostConfig` option accepts the field `CapAdd`, which specifies a list of capabilities +to add, and the field `CapDrop`, which specifies a list of capabilities to drop. +* `POST /images/create` th `fromImage` and `repo` parameters supportthe +`repo:tag` format. Consequently, the `tag` parameter is now obsolete. Using the +new format and the `tag` parameter at the same time will return an error. diff --git a/docs/reference/api/docker_remote_api_v1.0.md b/docs/reference/api/docker_remote_api_v1.0.md new file mode 100644 index 0000000000..0ae774edd0 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.0.md @@ -0,0 +1,993 @@ + + +# Docker Remote API v1.0 + +# 1. Brief introduction + +- The Remote API is replacing rcli +- Default port in the docker daemon is 2375 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0" + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0" + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/e90e34656806/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + + {{ TAR STREAM }} + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/centos/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + } + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/fedora/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such image +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + +Query Parameters: + +- **t** – repository name to be applied to the resulting image in + case of success + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get default username and email + +`GET /auth` + +Get the default username and email + +**Example request**: + + GET /auth HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "username":"hannibal", + "email":"hannibal@a-team.com" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration and store i + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + > + > **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's + +## 3.2 Hijacking + +In this first version of the API, some of the endpoints, like /attach, +/pull or /push uses hijacking to transport stdin, stdout and stderr on +the same socket. This might change in the future. diff --git a/docs/reference/api/docker_remote_api_v1.1.md b/docs/reference/api/docker_remote_api_v1.1.md new file mode 100644 index 0000000000..6f416de5d5 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.1.md @@ -0,0 +1,1005 @@ + + +# Docker Remote API v1.1 + +# 1. Brief introduction + +- The Remote API is replacing rcli +- Default port in the docker daemon is 2375 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0" + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0" + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/e90e34656806/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/centos/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + } + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/fedora/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such image +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + +Query Parameters: + +   + +- **t** – tag to be applied to the resulting image in case of + success + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get default username and email + +`GET /auth` + +Get the default username and email + +**Example request**: + + GET /auth HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "username":"hannibal", + "email":"hannibal@a-team.com" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration and store i + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + + - Start the container + + - If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + - Display the container's + +## 3.2 Hijacking + +In this version of the API, /attach uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. diff --git a/docs/reference/api/docker_remote_api_v1.10.md b/docs/reference/api/docker_remote_api_v1.10.md new file mode 100644 index 0000000000..0119a51d25 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.10.md @@ -0,0 +1,1354 @@ + + +# Docker Remote API v1.10 + +## 1. Brief introduction + + - The Remote API has replaced rcli + - The daemon listens on `unix:///var/run/docker.sock` but you can bind + Docker to another host/port or a Unix socket. + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout, stdin` + and `stderr` + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Image":"ubuntu", + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "NetworkDisabled": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Query Parameters: + +   + +- **name** – Assign the specified name to the container. Mus + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Image": "ubuntu", + "Volumes": {}, + "WorkingDir":"" + + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": null, + "PublishAllPorts": false + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +   + +- **ps\_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id` 's filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false, + "Dns": ["8.8.8.8"], + "VolumesFrom": ["parent", "other:ro"] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will wait for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` +](docker_remote_api_v1.9.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns + the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + + `DELETE /containers/(id*) +: Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** – 1/True/true or 0/False/false, Removes the container + even if it was running. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing + i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image + `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + "Image":"ubuntu", + "Volumes":null, + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + + `DELETE /images/(name*) +: Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +### 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#add)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** - remove intermediate containers after a successful build + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "NetworkDisabled": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + + +Json Parameters: + + + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository + specified by `name`. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + + - Start the container + + - If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.11.md b/docs/reference/api/docker_remote_api_v1.11.md new file mode 100644 index 0000000000..903bf5d067 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.11.md @@ -0,0 +1,1385 @@ + + +# Docker Remote API v1.11 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can bind + Docker to another host/port or a Unix socket. + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, `STDIN` + and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Image":"ubuntu", + "Volumes":{ + "/tmp": {} + }, + "VolumesFrom":"", + "WorkingDir":"", + "DisableNetwork": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Query Parameters: + +- **name** – Assign the specified name to the container. Mus + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": null, + "PublishAllPorts": false + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +   + +- **follow** – 1/True/true or 0/False/false, return stream. + Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, if logs=true, prin + timestamps for every log line. Default false + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false, + "Dns": ["8.8.8.8"], + "VolumesFrom": ["parent", "other:ro"] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will wait for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](docker_remote_api_v1.9.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** – 1/True/true or 0/False/false, Removes the container + even if it was running. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"ubuntu", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** - remove intermediate containers after a successful build + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "Images": 16, + "Driver": "btrfs", + "ExecutionDriver": "native-0.1", + "KernelVersion": "3.12.0-1-amd64" + "Debug": false, + "NFd": 11, + "NGoroutines": 21, + "NEventsListener": 0, + "InitPath": "/usr/bin/docker", + "IndexServerAddress": ["https://index.docker.io/v1/"], + "MemoryLimit": true, + "SwapLimit": false, + "IPv4Forwarding": true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "DisableNetwork": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository +specified by `name`. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.12.md b/docs/reference/api/docker_remote_api_v1.12.md new file mode 100644 index 0000000000..9272346b13 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.12.md @@ -0,0 +1,1450 @@ + + +# Docker Remote API v1.12 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../articles/basics.md#bind-docker-to-another-hostport-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** – a JSON encoded value of the filters (a map[string][]string) + to process on the images list. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "Domainname": "", + "User":"", + "Memory":0, + "MemorySwap":0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Image":"ubuntu", + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "NetworkDisabled": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Query Parameters: + +   + +- **name** – Assign the specified name to the container. Mus + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": null, + "PublishAllPorts": false + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +   + +- **follow** – 1/True/true or 0/False/false, return stream. + Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, if logs=true, prin + timestamps for every log line. Default false + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "Links":["redis3:redis"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false, + "Dns": ["8.8.8.8"], + "VolumesFrom": ["parent", "other:ro"] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will wait for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach to stdin. + Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](docker_remote_api_v1.9.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** – 1/True/true or 0/False/false, Removes the container + even if it was running. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true +- **filter** - only return images with the specified name + + + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "Images": 16, + "Driver": "btrfs", + "ExecutionDriver": "native-0.1", + "KernelVersion": "3.12.0-1-amd64" + "Debug": false, + "NFd": 11, + "NGoroutines": 21, + "NEventsListener": 0, + "InitPath": "/usr/bin/docker", + "IndexServerAddress": ["https://index.docker.io/v1/"], + "MemoryLimit": true, + "SwapLimit": false, + "IPv4Forwarding": true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "ApiVersion": "1.12", + "Version": "0.2.2", + "GitCommit": "5a2a5cc+CHANGES", + "GoVersion": "go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository +specified by `name`. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.13.md b/docs/reference/api/docker_remote_api_v1.13.md new file mode 100644 index 0000000000..a9b519d189 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.13.md @@ -0,0 +1,1440 @@ + + +# Docker Remote API v1.13 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../articles/basics.md#bind-docker-to-another-hostport-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "Domainname": "", + "User":"", + "Memory":0, + "MemorySwap":0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Image":"ubuntu", + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "NetworkDisabled": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Query Parameters: + +   + +- **name** – Assign the specified name to the container. Mus + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": ["/name:alias"], + "PublishAllPorts": false + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default false +- **stdout** – 1/True/true or 0/False/false, show stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, show stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, print timestamps for every + log line. Default false +- **tail** – Output specified number of lines at the end of logs: `all` or + ``. Default all + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "Links":["redis3:redis"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false, + "Dns": ["8.8.8.8"], + "VolumesFrom": ["parent", "other:ro"] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will wait for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach to stdin. + Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](docker_remote_api_v1.9.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** – 1/True/true or 0/False/false, Removes the container + even if it was running. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true +- **filter** - only return images with the specified name + +### Create an image + +`POST /images/create` + +Create an image, either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "Images": 16, + "Driver": "btrfs", + "ExecutionDriver": "native-0.1", + "KernelVersion": "3.12.0-1-amd64" + "Debug": false, + "NFd": 11, + "NGoroutines": 21, + "NEventsListener": 0, + "InitPath": "/usr/bin/docker", + "IndexServerAddress": ["https://index.docker.io/v1/"], + "MemoryLimit": true, + "SwapLimit": false, + "IPv4Forwarding": true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "ApiVersion": "1.12", + "Version": "0.2.2", + "GitCommit": "5a2a5cc+CHANGES", + "GoVersion": "go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository +specified by `name`. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.14.md b/docs/reference/api/docker_remote_api_v1.14.md new file mode 100644 index 0000000000..e649ab6f1c --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.14.md @@ -0,0 +1,1448 @@ + + +# Docker Remote API v1.14 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes +- **filters** - a json encoded value of the filters (a map[string][]string) to process on the containers list. Available filters: + - exited=<int> -- containers with exit code of <int> + - status=(restarting|running|paused|exited) + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "Domainname": "", + "User":"", + "Memory":0, + "MemorySwap":0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Image":"ubuntu", + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "NetworkDisabled": false, + "ExposedPorts":{ + "22/tcp": {} + }, + "RestartPolicy": { "Name": "always" } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. +- **config** – the container's configuration + +Query Parameters: + +- **name** – Assign the specified name to the container. Must match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": ["/name:alias"], + "PublishAllPorts": false, + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"] + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default false +- **stdout** – 1/True/true or 0/False/false, show stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, show stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, print timestamps for every + log line. Default false +- **tail** – Output specified number of lines at the end of logs: `all` or + ``. Default all + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "Links":["redis3:redis"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false, + "Dns": ["8.8.8.8"], + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"] + } + +**Example response**: + + HTTP/1.1 204 No Content + +Json Parameters: + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will wait for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach to stdin. + Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create`](#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true +- **filter** - only return images with the specified name + +### Create an image + +`POST /images/create` + +Create an image, either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "Images": 16, + "Driver": "btrfs", + "ExecutionDriver": "native-0.1", + "KernelVersion": "3.12.0-1-amd64" + "Debug": false, + "NFd": 11, + "NGoroutines": 21, + "NEventsListener": 0, + "InitPath": "/usr/bin/docker", + "IndexServerAddress": ["https://index.docker.io/v1/"], + "MemoryLimit": true, + "SwapLimit": false, + "IPv4Forwarding": true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "ApiVersion": "1.12", + "Version": "0.2.2", + "GitCommit": "5a2a5cc+CHANGES", + "GoVersion": "go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository +specified by `name`. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.15.md b/docs/reference/api/docker_remote_api_v1.15.md new file mode 100644 index 0000000000..f46aa21b29 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.15.md @@ -0,0 +1,1742 @@ + + +# Docker Remote API v1.15 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleepy_dog"], + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a json encoded value of the filters (a map[string][]string) to process on the containers list. Available filters: + - exited=<int> -- containers with exit code of <int> + - status=(restarting|running|paused|exited) + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "SecurityOpts": [""], + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [] + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id": "f91ddc4b01e079c4481a8340bbbeca4dbd33d6e4a10662e499f8eacbb5bf252b" + "Warnings": [] + } + +Json Parameters: + +- **Hostname** - A string value containing the desired hostname to use for the + container. +- **Domainname** - A string value containing the desired domain name to use + for the container. +- **User** - A string value containing the user to use inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap**- Total memory usage (memory + swap); set `-1` to disable swap. +- **CpuShares** - An integer value containing the CPU Shares for container + (ie. the relative weight vs other containers). + **CpuSet** - String value containing the cgroups Cpuset to use. +- **AttachStdin** - Boolean value, attaches to stdin. +- **AttachStdout** - Boolean value, attaches to stdout. +- **AttachStderr** - Boolean value, attaches to stderr. +- **Tty** - Boolean value, Attach standard streams to a tty, including stdin if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close stdin after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entrypoint for the container a string or an array + of strings +- **Image** - String value containing the image name to use for the container +- **Volumes** – An object mapping mountpoint paths (strings) inside the + container to empty objects. +- **WorkingDir** - A string value containing the working dir for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **SecurityOpts**: A list of string values to customize labels for MLS + systems, such as SELinux. +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume + binding is a string of the form `container_path` (to create a new + volume for the container), `host_path:container_path` (to bind-mount + a host path into the container), or `host_path:container_path:ro` + (to make the bind-mount read-only inside the container). + - **Links** - A list of links for the container. Each link entry should be + in the form of "container_name:alias". + - **LxcConf** - LXC specific configurations. These configurations will only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. It should be specified in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **Dns** - A list of dns servers for the container to use. + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to be added to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": ["/name:alias"], + "PublishAllPorts": false, + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"] + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default false +- **stdout** – 1/True/true or 0/False/false, show stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, show stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default false +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`GET /containers/(id)/resize?h=&w=` + +Resize the TTY of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – bad file descriptor + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [] + } + +**Example response**: + + HTTP/1.1 204 No Content + +Json Parameters: + +- **Binds** – A list of volume bindings for this container. Each volume + binding is a string of the form `container_path` (to create a new + volume for the container), `host_path:container_path` (to bind-mount + a host path into the container), or `host_path:container_path:ro` + (to make the bind-mount read-only inside the container). +- **Links** - A list of links for the container. Each link entry should be of + of the form "container_name:alias". +- **LxcConf** - LXC specific configurations. These configurations will only + work when using the `lxc` execution driver. +- **PortBindings** - A map of exposed container ports and the host port they + should map to. It should be specified in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. +- **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. +- **Privileged** - Gives the container full access to the host. Specified as + a boolean value. +- **Dns** - A list of dns servers for the container to use. +- **DnsSearch** - A list of DNS search domains +- **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` +- **CapAdd** - A list of kernel capabilities to add to the container. +- **Capdrop** - A list of kernel capabilities to drop from the container. +- **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. +- **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` +- **Devices** - A list of devices to add to the container specified in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create`](#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true +- **filter** - only return images with the specified name + +### Create an image + +`POST /images/create` + +Create an image, either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "Images": 16, + "Driver": "btrfs", + "ExecutionDriver": "native-0.1", + "KernelVersion": "3.12.0-1-amd64" + "Debug": false, + "NFd": 11, + "NGoroutines": 21, + "NEventsListener": 0, + "InitPath": "/usr/bin/docker", + "IndexServerAddress": ["https://index.docker.io/v1/"], + "MemoryLimit": true, + "SwapLimit": false, + "IPv4Forwarding": true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "ApiVersion": "1.12", + "Version": "0.2.2", + "GitCommit": "5a2a5cc+CHANGES", + "GoVersion": "go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +ubuntu:latest), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ], + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806" + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to stdin of the exec command. +- **AttachStdout** - Boolean value, attaches to stdout of the exec command. +- **AttachStderr** - Boolean value, attaches to stderr of the exec command. +- **Tty** - Boolean value to allocate a pseudo-TTY +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up exec instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false, + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the exec command +- **Tty** - Boolean value to allocate a pseudo-TTY + +Status Codes: + +- **200** – no error +- **404** – no such exec instance + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the tty session used by the exec command `id`. +This API is valid only if `tty` was specified as part of creating and starting the exec command. + +**Example request**: + + POST /exec/e90e34656806/resize HTTP/1.1 + Content-Type: plain/text + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: plain/text + +Query Parameters: + +- **h** – height of tty session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: +- Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: +- Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.16.md b/docs/reference/api/docker_remote_api_v1.16.md new file mode 100644 index 0000000000..8e7fc32d6d --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.16.md @@ -0,0 +1,1812 @@ + + +# Docker Remote API v1.16 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleep_dog"], + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a json encoded value of the filters (a map[string][]string) to process on the containers list. Available filters: + - exited=<int> -- containers with exit code of <int> + - status=(restarting|running|paused|exited) + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "SecurityOpts": [""], + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [] + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **Hostname** - A string value containing the desired hostname to use for the + container. +- **Domainname** - A string value containing the desired domain name to use + for the container. +- **User** - A string value containing the user to use inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap**- Total memory usage (memory + swap); set `-1` to disable swap. +- **CpuShares** - An integer value containing the CPU Shares for container + (ie. the relative weight vs other containers). + **CpuSet** - String value containing the cgroups Cpuset to use. +- **AttachStdin** - Boolean value, attaches to stdin. +- **AttachStdout** - Boolean value, attaches to stdout. +- **AttachStderr** - Boolean value, attaches to stderr. +- **Tty** - Boolean value, Attach standard streams to a tty, including stdin if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close stdin after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entrypoint for the container a string or an array + of strings +- **Image** - String value containing the image name to use for the container +- **Volumes** – An object mapping mountpoint paths (strings) inside the + container to empty objects. +- **WorkingDir** - A string value containing the working dir for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **SecurityOpts**: A list of string values to customize labels for MLS + systems, such as SELinux. +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume + binding is a string of the form `container_path` (to create a new + volume for the container), `host_path:container_path` (to bind-mount + a host path into the container), or `host_path:container_path:ro` + (to make the bind-mount read-only inside the container). + - **Links** - A list of links for the container. Each link entry should be + in the form of "container_name:alias". + - **LxcConf** - LXC specific configurations. These configurations will only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. It should be specified in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **Dns** - A list of dns servers for the container to use. + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to be added to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": ["/name:alias"], + "PublishAllPorts": false, + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"] + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default false +- **stdout** – 1/True/true or 0/False/false, show stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, show stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default false +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`POST /containers/(id)/resize?h=&w=` + +Resize the TTY for container with `id`. The container must be restarted for the resize to take effect. + +**Example request**: + + POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – Cannot resize container + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +> **Note**: +> For backwards compatibility, this endpoint accepts a `HostConfig` as JSON-encoded request body. +> See [create a container](#create-a-container) for details. + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true +- **filter** - only return images with the specified name + +### Create an image + +`POST /images/create` + +Create an image, either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **pull** - attempt to pull the image even if an older image exists locally +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Driver":"btrfs", + "DriverStatus": [[""]], + "ExecutionDriver":"native-0.1", + "KernelVersion":"3.12.0-1-amd64" + "NCPU":1, + "MemTotal":2099236864, + "Name":"prod-server-42", + "ID":"7TRN:IPZB:QYBB:VPBQ:UMPP:KARE:6ZNR:XE6T:7EWV:PKF4:ZOJD:TPYS", + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "NEventsListener":0, + "InitPath":"/usr/bin/docker", + "InitSha1":"", + "IndexServerAddress":["https://index.docker.io/v1/"], + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true, + "Labels":["storage=ssd"], + "DockerRootDir": "/var/lib/docker", + "OperatingSystem": "Boot2Docker", + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "ApiVersion": "1.12", + "Version": "0.2.2", + "GitCommit": "5a2a5cc+CHANGES", + "GoVersion": "go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the event list. Available filters: + - event=<string> -- event to filter + - image=<string> -- image to filter + - container=<string> -- container to filter + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +ubuntu:latest), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ], + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806" + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to stdin of the exec command. +- **AttachStdout** - Boolean value, attaches to stdout of the exec command. +- **AttachStderr** - Boolean value, attaches to stderr of the exec command. +- **Tty** - Boolean value to allocate a pseudo-TTY +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up exec instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false, + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the exec command +- **Tty** - Boolean value to allocate a pseudo-TTY + +Status Codes: + +- **200** – no error +- **404** – no such exec instance + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the tty session used by the exec command `id`. +This API is valid only if `tty` was specified as part of creating and starting the exec command. + +**Example request**: + + POST /exec/e90e34656806/resize HTTP/1.1 + Content-Type: plain/text + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: plain/text + +Query Parameters: + +- **h** – height of tty session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +### Exec Inspect + +`GET /exec/(id)/json` + +Return low-level information about the exec command `id`. + +**Example request**: + + GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: plain/text + + { + "ID" : "11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39", + "Running" : false, + "ExitCode" : 2, + "ProcessConfig" : { + "privileged" : false, + "user" : "", + "tty" : false, + "entrypoint" : "sh", + "arguments" : [ + "-c", + "exit 2" + ] + }, + "OpenStdin" : false, + "OpenStderr" : false, + "OpenStdout" : false, + "Container" : { + "State" : { + "Running" : true, + "Paused" : false, + "Restarting" : false, + "OOMKilled" : false, + "Pid" : 3650, + "ExitCode" : 0, + "Error" : "", + "StartedAt" : "2014-11-17T22:26:03.717657531Z", + "FinishedAt" : "0001-01-01T00:00:00Z" + }, + "ID" : "8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c", + "Created" : "2014-11-17T22:26:03.626304998Z", + "Path" : "date", + "Args" : [], + "Config" : { + "Hostname" : "8f177a186b97", + "Domainname" : "", + "User" : "", + "Memory" : 0, + "MemorySwap" : 0, + "CpuShares" : 0, + "Cpuset" : "", + "AttachStdin" : false, + "AttachStdout" : false, + "AttachStderr" : false, + "PortSpecs" : null, + "ExposedPorts" : null, + "Tty" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "Env" : [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ], + "Cmd" : [ + "date" + ], + "Image" : "ubuntu", + "Volumes" : null, + "WorkingDir" : "", + "Entrypoint" : null, + "NetworkDisabled" : false, + "MacAddress" : "", + "OnBuild" : null, + "SecurityOpt" : null + }, + "Image" : "5506de2b643be1e6febbf3b8a240760c6843244c41e12aa2f60ccbb7153d17f5", + "NetworkSettings" : { + "IPAddress" : "172.17.0.2", + "IPPrefixLen" : 16, + "MacAddress" : "02:42:ac:11:00:02", + "Gateway" : "172.17.42.1", + "Bridge" : "docker0", + "PortMapping" : null, + "Ports" : {} + }, + "ResolvConfPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/resolv.conf", + "HostnamePath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hostname", + "HostsPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hosts", + "Name" : "/test", + "Driver" : "aufs", + "ExecDriver" : "native-0.2", + "MountLabel" : "", + "ProcessLabel" : "", + "AppArmorProfile" : "", + "RestartCount" : 0, + "Volumes" : {}, + "VolumesRW" : {} + } + } + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **500** - server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: +- Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: +- Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.17.md b/docs/reference/api/docker_remote_api_v1.17.md new file mode 100644 index 0000000000..6c40d3ac80 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.17.md @@ -0,0 +1,1986 @@ + + +# Docker Remote API v1.17 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleepy_dog"], + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a json encoded value of the filters (a map[string][]string) to process on the containers list. Available filters: + - exited=<int> -- containers with exit code of <int> + - status=(restarting|running|paused|exited) + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "SecurityOpt": [""] + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **Hostname** - A string value containing the desired hostname to use for the + container. +- **Domainname** - A string value containing the desired domain name to use + for the container. +- **User** - A string value containing the user to use inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap**- Total memory limit (memory + swap); set `-1` to disable swap, + always use this with `memory`, and make the value larger than `memory`. +- **CpuShares** - An integer value containing the CPU Shares for container + (ie. the relative weight vs other containers). + **CpuSet** - String value containing the cgroups Cpuset to use. +- **AttachStdin** - Boolean value, attaches to stdin. +- **AttachStdout** - Boolean value, attaches to stdout. +- **AttachStderr** - Boolean value, attaches to stderr. +- **Tty** - Boolean value, Attach standard streams to a tty, including stdin if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close stdin after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entrypoint for the container a string or an array + of strings +- **Image** - String value containing the image name to use for the container +- **Volumes** – An object mapping mountpoint paths (strings) inside the + container to empty objects. +- **WorkingDir** - A string value containing the working dir for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume + binding is a string of the form `container_path` (to create a new + volume for the container), `host_path:container_path` (to bind-mount + a host path into the container), or `host_path:container_path:ro` + (to make the bind-mount read-only inside the container). + - **Links** - A list of links for the container. Each link entry should be + in the form of "container_name:alias". + - **LxcConf** - LXC specific configurations. These configurations will only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. It should be specified in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **ReadonlyRootfs** - Mount the container's root filesystem as read only. + Specified as a boolean value. + - **Dns** - A list of dns servers for the container to use. + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to be added to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + - **SecurityOpt**: A list of string values to customize labels for MLS + systems, such as SELinux. + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "AppArmorProfile": "", + "Args": [ + "-c", + "exit 9" + ], + "Config": { + "AttachStderr": true, + "AttachStdin": false, + "AttachStdout": true, + "Cmd": [ + "/bin/sh", + "-c", + "exit 9" + ], + "CpuShares": 0, + "Cpuset": "", + "Domainname": "", + "Entrypoint": null, + "Env": [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "ExposedPorts": null, + "Hostname": "ba033ac44011", + "Image": "ubuntu", + "MacAddress": "", + "Memory": 0, + "MemorySwap": 0, + "NetworkDisabled": false, + "OnBuild": null, + "OpenStdin": false, + "PortSpecs": null, + "StdinOnce": false, + "Tty": false, + "User": "", + "Volumes": null, + "WorkingDir": "" + }, + "Created": "2015-01-06T15:47:31.485331387Z", + "Driver": "devicemapper", + "ExecDriver": "native-0.2", + "ExecIDs": null, + "HostConfig": { + "Binds": null, + "CapAdd": null, + "CapDrop": null, + "ContainerIDFile": "", + "Devices": [], + "Dns": null, + "DnsSearch": null, + "ExtraHosts": null, + "IpcMode": "", + "Links": null, + "LxcConf": [], + "NetworkMode": "bridge", + "PortBindings": {}, + "Privileged": false, + "ReadonlyRootfs": false, + "PublishAllPorts": false, + "RestartPolicy": { + "MaximumRetryCount": 2, + "Name": "on-failure" + }, + "SecurityOpt": null, + "VolumesFrom": null + }, + "HostnamePath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hostname", + "HostsPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hosts", + "Id": "ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39", + "Image": "04c5d3b7b0656168630d3ba35d8889bd0e9caafcaeb3004d2bfbc47e7c5d35d2", + "MountLabel": "", + "Name": "/boring_euclid", + "NetworkSettings": { + "Bridge": "", + "Gateway": "", + "IPAddress": "", + "IPPrefixLen": 0, + "MacAddress": "", + "PortMapping": null, + "Ports": null + }, + "Path": "/bin/sh", + "ProcessLabel": "", + "ResolvConfPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/resolv.conf", + "RestartCount": 1, + "State": { + "Error": "", + "ExitCode": 9, + "FinishedAt": "2015-01-06T15:47:32.080254511Z", + "OOMKilled": false, + "Paused": false, + "Pid": 0, + "Restarting": false, + "Running": false, + "StartedAt": "2015-01-06T15:47:32.072697474Z" + }, + "Volumes": {}, + "VolumesRW": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default false +- **stdout** – 1/True/true or 0/False/false, show stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, show stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default false +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container stats based on resource usage + +`GET /containers/(id)/stats` + +This endpoint returns a live stream of a container's resource usage statistics. + +**Example request**: + + GET /containers/redis1/stats HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "read" : "2015-01-08T22:57:31.547920715Z", + "network" : { + "rx_dropped" : 0, + "rx_bytes" : 648, + "rx_errors" : 0, + "tx_packets" : 8, + "tx_dropped" : 0, + "rx_packets" : 8, + "tx_errors" : 0, + "tx_bytes" : 648 + }, + "memory_stats" : { + "stats" : { + "total_pgmajfault" : 0, + "cache" : 0, + "mapped_file" : 0, + "total_inactive_file" : 0, + "pgpgout" : 414, + "rss" : 6537216, + "total_mapped_file" : 0, + "writeback" : 0, + "unevictable" : 0, + "pgpgin" : 477, + "total_unevictable" : 0, + "pgmajfault" : 0, + "total_rss" : 6537216, + "total_rss_huge" : 6291456, + "total_writeback" : 0, + "total_inactive_anon" : 0, + "rss_huge" : 6291456, + "hierarchical_memory_limit" : 67108864, + "total_pgfault" : 964, + "total_active_file" : 0, + "active_anon" : 6537216, + "total_active_anon" : 6537216, + "total_pgpgout" : 414, + "total_cache" : 0, + "inactive_anon" : 0, + "active_file" : 0, + "pgfault" : 964, + "inactive_file" : 0, + "total_pgpgin" : 477 + }, + "max_usage" : 6651904, + "usage" : 6537216, + "failcnt" : 0, + "limit" : 67108864 + }, + "blkio_stats" : {}, + "cpu_stats" : { + "cpu_usage" : { + "percpu_usage" : [ + 16970827, + 1839451, + 7107380, + 10571290 + ], + "usage_in_usermode" : 10000000, + "total_usage" : 36488948, + "usage_in_kernelmode" : 20000000 + }, + "system_cpu_usage" : 20091722000000000, + "throttling_data" : {} + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`POST /containers/(id)/resize?h=&w=` + +Resize the TTY for container with `id`. The container must be restarted for the resize to take effect. + +**Example request**: + + POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – Cannot resize container + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +> **Note**: +> For backwards compatibility, this endpoint accepts a `HostConfig` as JSON-encoded request body. +> See [create a container](#create-a-container) for details. + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Rename a container + +`POST /containers/(id)/rename` + +Rename the container `id` to a `new_name` + +**Example request**: + + POST /containers/e90e34656806/rename?name=new_name HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **name** – new name for the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **409** - conflict name already assigned +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true +- **filter** - only return images with the specified name + +### Build image from a Dockerfile + +`POST /build` + +Build an image from a Dockerfile + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + +The input stream must be a tar archive compressed with one of the +following algorithms: identity (no compression), gzip, bzip2, xz. + +The archive must include a build instructions file, typically called +`Dockerfile` at the root of the archive. The `dockerfile` parameter may be +used to specify a different build instructions file by having its value be +the path to the alternate build instructions file to use. + +The archive may include any number of other files, +which will be accessible in the build context (See the [*ADD build +command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **dockerfile** - path within the build context to the Dockerfile +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – git or HTTP/HTTPS URI build source +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **pull** - attempt to pull the image even if an older image exists locally +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Driver":"btrfs", + "DriverStatus": [[""]], + "ExecutionDriver":"native-0.1", + "KernelVersion":"3.12.0-1-amd64" + "NCPU":1, + "MemTotal":2099236864, + "Name":"prod-server-42", + "ID":"7TRN:IPZB:QYBB:VPBQ:UMPP:KARE:6ZNR:XE6T:7EWV:PKF4:ZOJD:TPYS", + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "NEventsListener":0, + "InitPath":"/usr/bin/docker", + "InitSha1":"", + "IndexServerAddress":["https://index.docker.io/v1/"], + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true, + "Labels":["storage=ssd"], + "DockerRootDir": "/var/lib/docker", + "OperatingSystem": "Boot2Docker", + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "ApiVersion": "1.12", + "Version": "0.2.2", + "GitCommit": "5a2a5cc+CHANGES", + "GoVersion": "go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, exec_create, exec_start, export, kill, oom, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the event list. Available filters: + - event=<string> -- event to filter + - image=<string> -- image to filter + - container=<string> -- container to filter + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +ubuntu:latest), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ], + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806" + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to stdin of the exec command. +- **AttachStdout** - Boolean value, attaches to stdout of the exec command. +- **AttachStderr** - Boolean value, attaches to stderr of the exec command. +- **Tty** - Boolean value to allocate a pseudo-TTY +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up exec instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false, + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the exec command +- **Tty** - Boolean value to allocate a pseudo-TTY + +Status Codes: + +- **200** – no error +- **404** – no such exec instance + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the tty session used by the exec command `id`. +This API is valid only if `tty` was specified as part of creating and starting the exec command. + +**Example request**: + + POST /exec/e90e34656806/resize HTTP/1.1 + Content-Type: text/plain + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: text/plain + +Query Parameters: + +- **h** – height of tty session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +### Exec Inspect + +`GET /exec/(id)/json` + +Return low-level information about the exec command `id`. + +**Example request**: + + GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: plain/text + + { + "ID" : "11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39", + "Running" : false, + "ExitCode" : 2, + "ProcessConfig" : { + "privileged" : false, + "user" : "", + "tty" : false, + "entrypoint" : "sh", + "arguments" : [ + "-c", + "exit 2" + ] + }, + "OpenStdin" : false, + "OpenStderr" : false, + "OpenStdout" : false, + "Container" : { + "State" : { + "Running" : true, + "Paused" : false, + "Restarting" : false, + "OOMKilled" : false, + "Pid" : 3650, + "ExitCode" : 0, + "Error" : "", + "StartedAt" : "2014-11-17T22:26:03.717657531Z", + "FinishedAt" : "0001-01-01T00:00:00Z" + }, + "ID" : "8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c", + "Created" : "2014-11-17T22:26:03.626304998Z", + "Path" : "date", + "Args" : [], + "Config" : { + "Hostname" : "8f177a186b97", + "Domainname" : "", + "User" : "", + "Memory" : 0, + "MemorySwap" : 0, + "CpuShares" : 0, + "Cpuset" : "", + "AttachStdin" : false, + "AttachStdout" : false, + "AttachStderr" : false, + "PortSpecs" : null, + "ExposedPorts" : null, + "Tty" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "Env" : [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ], + "Cmd" : [ + "date" + ], + "Image" : "ubuntu", + "Volumes" : null, + "WorkingDir" : "", + "Entrypoint" : null, + "NetworkDisabled" : false, + "MacAddress" : "", + "OnBuild" : null, + "SecurityOpt" : null + }, + "Image" : "5506de2b643be1e6febbf3b8a240760c6843244c41e12aa2f60ccbb7153d17f5", + "NetworkSettings" : { + "IPAddress" : "172.17.0.2", + "IPPrefixLen" : 16, + "MacAddress" : "02:42:ac:11:00:02", + "Gateway" : "172.17.42.1", + "Bridge" : "docker0", + "PortMapping" : null, + "Ports" : {} + }, + "ResolvConfPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/resolv.conf", + "HostnamePath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hostname", + "HostsPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hosts", + "Name" : "/test", + "Driver" : "aufs", + "ExecDriver" : "native-0.2", + "MountLabel" : "", + "ProcessLabel" : "", + "AppArmorProfile" : "", + "RestartCount" : 0, + "Volumes" : {}, + "VolumesRW" : {} + } + } + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **500** - server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: +- Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: +- Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. + +To hint potential proxies about connection hijacking, Docker client sends +connection upgrade headers similarly to websocket. + + Upgrade: tcp + Connection: Upgrade + +When Docker daemon detects the `Upgrade` header, it will switch its status code +from **200 OK** to **101 UPGRADED** and resend the same headers. + +This might change in the future. + +## 3.3 CORS Requests + +To set cross origin requests to the remote api, please add flag "--api-enable-cors" +when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.18.md b/docs/reference/api/docker_remote_api_v1.18.md new file mode 100644 index 0000000000..c7492dcba4 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.18.md @@ -0,0 +1,2105 @@ + + +# Docker Remote API v1.18 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `STDOUT`, + `STDIN` and `STDERR`. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleepy_dog"], + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "Labels": {}, + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a json encoded value of the filters (a map[string][]string) to process on the containers list. Available filters: + - exited=<int> -- containers with exit code of <int> + - status=(restarting|running|paused|exited) + - label=`key` or `label="key=value"` of a container label + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "CpusetCpus": "0,1", + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "Ulimits": [{}], + "LogConfig": { "Type": "json-file", Config: {} }, + "SecurityOpt": [""], + "CgroupParent": "" + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **Hostname** - A string value containing the desired hostname to use for the + container. +- **Domainname** - A string value containing the desired domain name to use + for the container. +- **User** - A string value containing the user to use inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap**- Total memory limit (memory + swap); set `-1` to disable swap, + always use this with `memory`, and make the value larger than `memory`. +- **CpuShares** - An integer value containing the CPU Shares for container + (ie. the relative weight vs other containers). +- **Cpuset** - The same as CpusetCpus, but deprecated, please don't use. +- **CpusetCpus** - String value containing the cgroups CpusetCpus to use. +- **AttachStdin** - Boolean value, attaches to stdin. +- **AttachStdout** - Boolean value, attaches to stdout. +- **AttachStderr** - Boolean value, attaches to stderr. +- **Tty** - Boolean value, Attach standard streams to a tty, including stdin if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close stdin after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Labels** - Adds a map of labels that to a container. To specify a map: `{"key":"value"[,"key2":"value2"]}` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entrypoint for the container a string or an array + of strings +- **Image** - String value containing the image name to use for the container +- **Volumes** – An object mapping mountpoint paths (strings) inside the + container to empty objects. +- **WorkingDir** - A string value containing the working dir for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume + binding is a string of the form `container_path` (to create a new + volume for the container), `host_path:container_path` (to bind-mount + a host path into the container), or `host_path:container_path:ro` + (to make the bind-mount read-only inside the container). + - **Links** - A list of links for the container. Each link entry should be + in the form of `container_name:alias`. + - **LxcConf** - LXC specific configurations. These configurations will only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. It should be specified in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **ReadonlyRootfs** - Mount the container's root filesystem as read only. + Specified as a boolean value. + - **Dns** - A list of dns servers for the container to use. + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to be added to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + - **Ulimits** - A list of ulimits to be set in the container, specified as + `{ "Name": , "Soft": , "Hard": }`, for example: + `Ulimits: { "Name": "nofile", "Soft": 1024, "Hard": 2048 }` + - **SecurityOpt**: A list of string values to customize labels for MLS + systems, such as SELinux. + - **LogConfig** - Log configuration for the container, specified as + `{ "Type": "", "Config": {"key1": "val1"}}`. + Available types: `json-file`, `syslog`, `journald`, `none`. + `json-file` logging driver. + - **CgroupParent** - Path to cgroups under which the cgroup for the container will be created. If the path is not absolute, the path is considered to be relative to the cgroups path of the init process. Cgroups will be created if they do not already exist. + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "AppArmorProfile": "", + "Args": [ + "-c", + "exit 9" + ], + "Config": { + "AttachStderr": true, + "AttachStdin": false, + "AttachStdout": true, + "Cmd": [ + "/bin/sh", + "-c", + "exit 9" + ], + "Domainname": "", + "Entrypoint": null, + "Env": [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "ExposedPorts": null, + "Hostname": "ba033ac44011", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "MacAddress": "", + "NetworkDisabled": false, + "OnBuild": null, + "OpenStdin": false, + "PortSpecs": null, + "StdinOnce": false, + "Tty": false, + "User": "", + "Volumes": null, + "WorkingDir": "" + }, + "Created": "2015-01-06T15:47:31.485331387Z", + "Driver": "devicemapper", + "ExecDriver": "native-0.2", + "ExecIDs": null, + "HostConfig": { + "Binds": null, + "CapAdd": null, + "CapDrop": null, + "ContainerIDFile": "", + "CpusetCpus": "", + "CpuShares": 0, + "Devices": [], + "Dns": null, + "DnsSearch": null, + "ExtraHosts": null, + "IpcMode": "", + "Links": null, + "LxcConf": [], + "Memory": 0, + "MemorySwap": 0, + "NetworkMode": "bridge", + "PortBindings": {}, + "Privileged": false, + "ReadonlyRootfs": false, + "PublishAllPorts": false, + "RestartPolicy": { + "MaximumRetryCount": 2, + "Name": "on-failure" + }, + "LogConfig": { + "Config": null, + "Type": "json-file" + }, + "SecurityOpt": null, + "VolumesFrom": null, + "Ulimits": [{}] + }, + "HostnamePath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hostname", + "HostsPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Id": "ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39", + "Image": "04c5d3b7b0656168630d3ba35d8889bd0e9caafcaeb3004d2bfbc47e7c5d35d2", + "MountLabel": "", + "Name": "/boring_euclid", + "NetworkSettings": { + "Bridge": "", + "Gateway": "", + "IPAddress": "", + "IPPrefixLen": 0, + "MacAddress": "", + "PortMapping": null, + "Ports": null + }, + "Path": "/bin/sh", + "ProcessLabel": "", + "ResolvConfPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/resolv.conf", + "RestartCount": 1, + "State": { + "Error": "", + "ExitCode": 9, + "FinishedAt": "2015-01-06T15:47:32.080254511Z", + "OOMKilled": false, + "Paused": false, + "Pid": 0, + "Restarting": false, + "Running": false, + "StartedAt": "2015-01-06T15:47:32.072697474Z" + }, + "Volumes": {}, + "VolumesRW": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + +> **Note**: +> This endpoint works only for containers with the `json-file` or `journald` logging drivers. + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default false +- **stdout** – 1/True/true or 0/False/false, show stdout log. Default false +- **stderr** – 1/True/true or 0/False/false, show stderr log. Default false +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default false +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Values for `Kind`: + +- `0`: Modify +- `1`: Add +- `2`: Delete + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container stats based on resource usage + +`GET /containers/(id)/stats` + +This endpoint returns a live stream of a container's resource usage statistics. + +> **Note**: this functionality currently only works when using the *libcontainer* exec-driver. + +**Example request**: + + GET /containers/redis1/stats HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "read" : "2015-01-08T22:57:31.547920715Z", + "network" : { + "rx_dropped" : 0, + "rx_bytes" : 648, + "rx_errors" : 0, + "tx_packets" : 8, + "tx_dropped" : 0, + "rx_packets" : 8, + "tx_errors" : 0, + "tx_bytes" : 648 + }, + "memory_stats" : { + "stats" : { + "total_pgmajfault" : 0, + "cache" : 0, + "mapped_file" : 0, + "total_inactive_file" : 0, + "pgpgout" : 414, + "rss" : 6537216, + "total_mapped_file" : 0, + "writeback" : 0, + "unevictable" : 0, + "pgpgin" : 477, + "total_unevictable" : 0, + "pgmajfault" : 0, + "total_rss" : 6537216, + "total_rss_huge" : 6291456, + "total_writeback" : 0, + "total_inactive_anon" : 0, + "rss_huge" : 6291456, + "hierarchical_memory_limit" : 67108864, + "total_pgfault" : 964, + "total_active_file" : 0, + "active_anon" : 6537216, + "total_active_anon" : 6537216, + "total_pgpgout" : 414, + "total_cache" : 0, + "inactive_anon" : 0, + "active_file" : 0, + "pgfault" : 964, + "inactive_file" : 0, + "total_pgpgin" : 477 + }, + "max_usage" : 6651904, + "usage" : 6537216, + "failcnt" : 0, + "limit" : 67108864 + }, + "blkio_stats" : {}, + "cpu_stats" : { + "cpu_usage" : { + "percpu_usage" : [ + 16970827, + 1839451, + 7107380, + 10571290 + ], + "usage_in_usermode" : 10000000, + "total_usage" : 36488948, + "usage_in_kernelmode" : 20000000 + }, + "system_cpu_usage" : 20091722000000000, + "throttling_data" : {} + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`POST /containers/(id)/resize?h=&w=` + +Resize the TTY for container with `id`. The container must be restarted for the resize to take effect. + +**Example request**: + + POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – Cannot resize container + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +> **Note**: +> For backwards compatibility, this endpoint accepts a `HostConfig` as JSON-encoded request body. +> See [create a container](#create-a-container) for details. + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Rename a container + +`POST /containers/(id)/rename` + +Rename the container `id` to a `new_name` + +**Example request**: + + POST /containers/e90e34656806/rename?name=new_name HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **name** – new name for the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **409** - conflict name already assigned +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1 + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +**Example request, with digest information**: + + GET /images/json?digests=1 HTTP/1.1 + +**Example response, with digest information**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Created": 1420064636, + "Id": "4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125", + "ParentId": "ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2", + "RepoDigests": [ + "localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf" + ], + "RepoTags": [ + "localhost:5000/test/busybox:latest", + "playdate:latest" + ], + "Size": 0, + "VirtualSize": 2429728 + } + ] + +The response shows a single image `Id` associated with two repositories +(`RepoTags`): `localhost:5000/test/busybox`: and `playdate`. A caller can use +either of the `RepoTags` values `localhost:5000/test/busybox:latest` or +`playdate:latest` to reference the image. + +You can also use `RepoDigests` values to reference an image. In this response, +the array has only one reference and that is to the +`localhost:5000/test/busybox` repository; the `playdate` repository has no +digest. You can reference this digest using the value: +`localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d...` + +See the `docker run` and `docker build` commands for examples of digest and tag +references on the command line. + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - dangling=true + - label=`key` or `label="key=value"` of an image label +- **filter** - only return images with the specified name + +### Build image from a Dockerfile + +`POST /build` + +Build an image from a Dockerfile + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + +The input stream must be a tar archive compressed with one of the +following algorithms: identity (no compression), gzip, bzip2, xz. + +The archive must include a build instructions file, typically called +`Dockerfile` at the root of the archive. The `dockerfile` parameter may be +used to specify a different build instructions file by having its value be +the path to the alternate build instructions file to use. + +The archive may include any number of other files, +which will be accessible in the build context (See the [*ADD build +command*](../../reference/builder.md#dockerbuilder)). + +The build will also be canceled if the client drops the connection by quitting +or being killed. + +Query Parameters: + +- **dockerfile** - path within the build context to the Dockerfile. This is + ignored if `remote` is specified and points to an individual filename. +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – A Git repository URI or HTTP/HTTPS URI build source. If the + URI specifies a filename, the file's contents are placed into a file + called `Dockerfile`. +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **pull** - attempt to pull the image even if an older image exists locally +- **rm** - remove intermediate containers after a successful build (default behavior) +- **forcerm** - always remove intermediate containers (includes rm) +- **memory** - set memory limit for build +- **memswap** - Total memory (memory + swap), `-1` to disable swap +- **cpushares** - CPU shares (relative weight) +- **cpusetcpus** - CPUs in which to allow execution, e.g., `0-3`, `0,1` + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + If you wish to push an image on to a private registry, that image must already have been tagged + into a repository which references that registry host name and port. This repository name should + then be used in the URL. This mirrors the flow of the CLI. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – the tag to associate with the image on the registry, optional + +Request Headers: + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "Debug": 0, + "DockerRootDir": "/var/lib/docker", + "Driver": "btrfs", + "DriverStatus": [[""]], + "ExecutionDriver": "native-0.1", + "HttpProxy": "http://test:test@localhost:8080", + "HttpsProxy": "https://test:test@localhost:8080", + "ID": "7TRN:IPZB:QYBB:VPBQ:UMPP:KARE:6ZNR:XE6T:7EWV:PKF4:ZOJD:TPYS", + "IPv4Forwarding": 1, + "Images": 16, + "IndexServerAddress": "https://index.docker.io/v1/", + "InitPath": "/usr/bin/docker", + "InitSha1": "", + "KernelVersion": "3.12.0-1-amd64", + "Labels": [ + "storage=ssd" + ], + "MemTotal": 2099236864, + "MemoryLimit": 1, + "NCPU": 1, + "NEventsListener": 0, + "NFd": 11, + "NGoroutines": 21, + "Name": "prod-server-42", + "NoProxy": "9.81.1.160", + "OperatingSystem": "Boot2Docker", + "RegistryConfig": { + "IndexConfigs": { + "docker.io": { + "Mirrors": null, + "Name": "docker.io", + "Official": true, + "Secure": true + } + }, + "InsecureRegistryCIDRs": [ + "127.0.0.0/8" + ] + }, + "SwapLimit": 0, + "SystemTime": "2015-03-10T11:11:23.730591467-07:00" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version": "1.5.0", + "Os": "linux", + "KernelVersion": "3.18.5-tinycore64", + "GoVersion": "go1.4.1", + "GitCommit": "a8a31ef", + "Arch": "amd64", + "ApiVersion": "1.18" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, exec_create, exec_start, export, kill, oom, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling +- **until** – timestamp used for polling +- **filters** – a json encoded value of the filters (a map[string][]string) to process on the event list. Available filters: + - event=<string> -- event to filter + - image=<string> -- image to filter + - container=<string> -- container to filter + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +ubuntu:latest), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ], + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to stdin of the exec command. +- **AttachStdout** - Boolean value, attaches to stdout of the exec command. +- **AttachStderr** - Boolean value, attaches to stderr of the exec command. +- **Tty** - Boolean value to allocate a pseudo-TTY +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up exec instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false, + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the exec command +- **Tty** - Boolean value to allocate a pseudo-TTY + +Status Codes: + +- **200** – no error +- **404** – no such exec instance + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the tty session used by the exec command `id`. +This API is valid only if `tty` was specified as part of creating and starting the exec command. + +**Example request**: + + POST /exec/e90e34656806/resize HTTP/1.1 + Content-Type: text/plain + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: text/plain + +Query Parameters: + +- **h** – height of tty session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +### Exec Inspect + +`GET /exec/(id)/json` + +Return low-level information about the exec command `id`. + +**Example request**: + + GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: plain/text + + { + "ID" : "11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39", + "Running" : false, + "ExitCode" : 2, + "ProcessConfig" : { + "privileged" : false, + "user" : "", + "tty" : false, + "entrypoint" : "sh", + "arguments" : [ + "-c", + "exit 2" + ] + }, + "OpenStdin" : false, + "OpenStderr" : false, + "OpenStdout" : false, + "Container" : { + "State" : { + "Running" : true, + "Paused" : false, + "Restarting" : false, + "OOMKilled" : false, + "Pid" : 3650, + "ExitCode" : 0, + "Error" : "", + "StartedAt" : "2014-11-17T22:26:03.717657531Z", + "FinishedAt" : "0001-01-01T00:00:00Z" + }, + "ID" : "8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c", + "Created" : "2014-11-17T22:26:03.626304998Z", + "Path" : "date", + "Args" : [], + "Config" : { + "Hostname" : "8f177a186b97", + "Domainname" : "", + "User" : "", + "AttachStdin" : false, + "AttachStdout" : false, + "AttachStderr" : false, + "PortSpecs" : null, + "ExposedPorts" : null, + "Tty" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "Env" : [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ], + "Cmd" : [ + "date" + ], + "Image" : "ubuntu", + "Volumes" : null, + "WorkingDir" : "", + "Entrypoint" : null, + "NetworkDisabled" : false, + "MacAddress" : "", + "OnBuild" : null, + "SecurityOpt" : null + }, + "Image" : "5506de2b643be1e6febbf3b8a240760c6843244c41e12aa2f60ccbb7153d17f5", + "NetworkSettings" : { + "IPAddress" : "172.17.0.2", + "IPPrefixLen" : 16, + "MacAddress" : "02:42:ac:11:00:02", + "Gateway" : "172.17.42.1", + "Bridge" : "docker0", + "PortMapping" : null, + "Ports" : {} + }, + "ResolvConfPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/resolv.conf", + "HostnamePath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hostname", + "HostsPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Name" : "/test", + "Driver" : "aufs", + "ExecDriver" : "native-0.2", + "MountLabel" : "", + "ProcessLabel" : "", + "AppArmorProfile" : "", + "RestartCount" : 0, + "Volumes" : {}, + "VolumesRW" : {} + } + } + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **500** - server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: +- Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: +- Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. + +To hint potential proxies about connection hijacking, Docker client sends +connection upgrade headers similarly to websocket. + + Upgrade: tcp + Connection: Upgrade + +When Docker daemon detects the `Upgrade` header, it will switch its status code +from **200 OK** to **101 UPGRADED** and resend the same headers. + +This might change in the future. + +## 3.3 CORS Requests + +To set cross origin requests to the remote api please give values to +"--api-cors-header" when running docker in daemon mode. Set * will allow all, +default or blank means CORS disabled + + $ docker -d -H="192.168.1.9:2375" --api-cors-header="http://foo.bar" diff --git a/docs/reference/api/docker_remote_api_v1.19.md b/docs/reference/api/docker_remote_api_v1.19.md new file mode 100644 index 0000000000..2980f34c77 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.19.md @@ -0,0 +1,2169 @@ + + +# Docker Remote API v1.19 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST. However, for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout`, + `stdin` and `stderr`. + - When the client API version is newer than the daemon's, these calls return an HTTP + `400 Bad Request` error message. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleepy_dog"], + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "Labels": {}, + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a JSON encoded value of the filters (a `map[string][]string`) to process on the containers list. Available filters: + - `exited=`; -- containers with exit code of `` ; + - `status=`(`restarting`|`running`|`paused`|`exited`) + - `label=key` or `label="key=value"` of a container label + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "CpuPeriod": 100000, + "CpuQuota": 50000, + "CpusetCpus": "0,1", + "CpusetMems": "0,1", + "BlkioWeight": 300, + "OomKillDisable": false, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "Ulimits": [{}], + "LogConfig": { "Type": "json-file", "Config": {} }, + "SecurityOpt": [""], + "CgroupParent": "" + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **Hostname** - A string value containing the hostname to use for the + container. +- **Domainname** - A string value containing the domain name to use + for the container. +- **User** - A string value specifying the user inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap**- Total memory limit (memory + swap); set `-1` to disable swap + You must use this with `memory` and make the swap value larger than `memory`. +- **CpuShares** - An integer value containing the container's CPU Shares + (ie. the relative weight vs other containers). +- **CpuPeriod** - The length of a CPU period in microseconds. +- **CpuQuota** - Microseconds of CPU time that the container can get in a CPU period. +- **Cpuset** - Deprecated please don't use. Use `CpusetCpus` instead. +- **CpusetCpus** - String value containing the `cgroups CpusetCpus` to use. +- **CpusetMems** - Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems. +- **BlkioWeight** - Block IO weight (relative weight) accepts a weight value between 10 and 1000. +- **OomKillDisable** - Boolean value, whether to disable OOM Killer for the container or not. +- **AttachStdin** - Boolean value, attaches to `stdin`. +- **AttachStdout** - Boolean value, attaches to `stdout`. +- **AttachStderr** - Boolean value, attaches to `stderr`. +- **Tty** - Boolean value, Attach standard streams to a `tty`, including `stdin` if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close `stdin` after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Labels** - Adds a map of labels to a container. To specify a map: `{"key":"value"[,"key2":"value2"]}` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entry point for the container as a string or an array + of strings. +- **Image** - A string specifying the image name to use for the container. +- **Volumes** – An object mapping mount point paths (strings) inside the + container to empty objects. +- **WorkingDir** - A string specifying the working directory for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume binding is a string in one of these forms: + + `container_path` to create a new volume for the container + + `host_path:container_path` to bind-mount a host path into the container + + `host_path:container_path:ro` to make the bind-mount read-only inside the container. + - **Links** - A list of links for the container. Each link entry should be + in the form of `container_name:alias`. + - **LxcConf** - LXC specific configurations. These configurations only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. A JSON object in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **ReadonlyRootfs** - Mount the container's root filesystem as read only. + Specified as a boolean value. + - **Dns** - A list of DNS servers for the container to use. + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to add to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified as a JSON object in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + - **Ulimits** - A list of ulimits to set in the container, specified as + `{ "Name": , "Soft": , "Hard": }`, for example: + `Ulimits: { "Name": "nofile", "Soft": 1024, "Hard": 2048 }` + - **SecurityOpt**: A list of string values to customize labels for MLS + systems, such as SELinux. + - **LogConfig** - Log configuration for the container, specified as a JSON object in the form + `{ "Type": "", "Config": {"key1": "val1"}}`. + Available types: `json-file`, `syslog`, `journald`, `none`. + `syslog` available options are: `address`. + - **CgroupParent** - Path to cgroups under which the cgroup for the container will be created. If the path is not absolute, the path is considered to be relative to the cgroups path of the init process. Cgroups will be created if they do not already exist. + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "AppArmorProfile": "", + "Args": [ + "-c", + "exit 9" + ], + "Config": { + "AttachStderr": true, + "AttachStdin": false, + "AttachStdout": true, + "Cmd": [ + "/bin/sh", + "-c", + "exit 9" + ], + "Domainname": "", + "Entrypoint": null, + "Env": [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "ExposedPorts": null, + "Hostname": "ba033ac44011", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "MacAddress": "", + "NetworkDisabled": false, + "OnBuild": null, + "OpenStdin": false, + "PortSpecs": null, + "StdinOnce": false, + "Tty": false, + "User": "", + "Volumes": null, + "WorkingDir": "" + }, + "Created": "2015-01-06T15:47:31.485331387Z", + "Driver": "devicemapper", + "ExecDriver": "native-0.2", + "ExecIDs": null, + "HostConfig": { + "Binds": null, + "BlkioWeight": 0, + "CapAdd": null, + "CapDrop": null, + "ContainerIDFile": "", + "CpusetCpus": "", + "CpusetMems": "", + "CpuShares": 0, + "CpuPeriod": 100000, + "Devices": [], + "Dns": null, + "DnsSearch": null, + "ExtraHosts": null, + "IpcMode": "", + "Links": null, + "LxcConf": [], + "Memory": 0, + "MemorySwap": 0, + "OomKillDisable": false, + "NetworkMode": "bridge", + "PortBindings": {}, + "Privileged": false, + "ReadonlyRootfs": false, + "PublishAllPorts": false, + "RestartPolicy": { + "MaximumRetryCount": 2, + "Name": "on-failure" + }, + "LogConfig": { + "Config": null, + "Type": "json-file" + }, + "SecurityOpt": null, + "VolumesFrom": null, + "Ulimits": [{}] + }, + "HostnamePath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hostname", + "HostsPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Id": "ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39", + "Image": "04c5d3b7b0656168630d3ba35d8889bd0e9caafcaeb3004d2bfbc47e7c5d35d2", + "MountLabel": "", + "Name": "/boring_euclid", + "NetworkSettings": { + "Bridge": "", + "Gateway": "", + "IPAddress": "", + "IPPrefixLen": 0, + "MacAddress": "", + "PortMapping": null, + "Ports": null + }, + "Path": "/bin/sh", + "ProcessLabel": "", + "ResolvConfPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/resolv.conf", + "RestartCount": 1, + "State": { + "Error": "", + "ExitCode": 9, + "FinishedAt": "2015-01-06T15:47:32.080254511Z", + "OOMKilled": false, + "Paused": false, + "Pid": 0, + "Restarting": false, + "Running": false, + "StartedAt": "2015-01-06T15:47:32.072697474Z" + }, + "Volumes": {}, + "VolumesRW": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get `stdout` and `stderr` logs from the container ``id`` + +> **Note**: +> This endpoint works only for containers with the `json-file` or `journald` logging drivers. + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default `false`. +- **stdout** – 1/True/true or 0/False/false, show `stdout` log. Default `false`. +- **stderr** – 1/True/true or 0/False/false, show `stderr` log. Default `false`. +- **since** – UNIX timestamp (integer) to filter logs. Specifying a timestamp + will only output log-entries since that timestamp. Default: 0 (unfiltered) +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default `false`. +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all. + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Values for `Kind`: + +- `0`: Modify +- `1`: Add +- `2`: Delete + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container stats based on resource usage + +`GET /containers/(id)/stats` + +This endpoint returns a live stream of a container's resource usage statistics. + +> **Note**: this functionality currently only works when using the *libcontainer* exec-driver. + +**Example request**: + + GET /containers/redis1/stats HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "read" : "2015-01-08T22:57:31.547920715Z", + "network" : { + "rx_dropped" : 0, + "rx_bytes" : 648, + "rx_errors" : 0, + "tx_packets" : 8, + "tx_dropped" : 0, + "rx_packets" : 8, + "tx_errors" : 0, + "tx_bytes" : 648 + }, + "memory_stats" : { + "stats" : { + "total_pgmajfault" : 0, + "cache" : 0, + "mapped_file" : 0, + "total_inactive_file" : 0, + "pgpgout" : 414, + "rss" : 6537216, + "total_mapped_file" : 0, + "writeback" : 0, + "unevictable" : 0, + "pgpgin" : 477, + "total_unevictable" : 0, + "pgmajfault" : 0, + "total_rss" : 6537216, + "total_rss_huge" : 6291456, + "total_writeback" : 0, + "total_inactive_anon" : 0, + "rss_huge" : 6291456, + "hierarchical_memory_limit" : 67108864, + "total_pgfault" : 964, + "total_active_file" : 0, + "active_anon" : 6537216, + "total_active_anon" : 6537216, + "total_pgpgout" : 414, + "total_cache" : 0, + "inactive_anon" : 0, + "active_file" : 0, + "pgfault" : 964, + "inactive_file" : 0, + "total_pgpgin" : 477 + }, + "max_usage" : 6651904, + "usage" : 6537216, + "failcnt" : 0, + "limit" : 67108864 + }, + "blkio_stats" : {}, + "cpu_stats" : { + "cpu_usage" : { + "percpu_usage" : [ + 16970827, + 1839451, + 7107380, + 10571290 + ], + "usage_in_usermode" : 10000000, + "total_usage" : 36488948, + "usage_in_kernelmode" : 20000000 + }, + "system_cpu_usage" : 20091722000000000, + "throttling_data" : {} + } + } + +Query Parameters: + +- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`. + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`POST /containers/(id)/resize?h=&w=` + +Resize the TTY for container with `id`. You must restart the container for the resize to take effect. + +**Example request**: + + POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – Cannot resize container + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +> **Note**: +> For backwards compatibility, this endpoint accepts a `HostConfig` as JSON-encoded request body. +> See [create a container](#create-a-container) for details. + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like `SIGINT`. + When not set, `SIGKILL` is assumed and the call waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Rename a container + +`POST /containers/(id)/rename` + +Rename the container `id` to a `new_name` + +**Example request**: + + POST /containers/e90e34656806/rename?name=new_name HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **name** – new name for the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **409** - conflict name already assigned +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default `false`. +- **stream** – 1/True/true or 0/False/false, return stream. + Default `false`. +- **stdin** – 1/True/true or 0/False/false, if `stream=true`, attach + to `stdin`. Default `false`. +- **stdout** – 1/True/true or 0/False/false, if `logs=true`, return + `stdout` log, if `stream=true`, attach to `stdout`. Default `false`. +- **stderr** – 1/True/true or 0/False/false, if `logs=true`, return + `stderr` log, if `stream=true`, attach to `stderr`. Default `false`. + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](#create-a-container), + the stream is the raw data from the process PTY and client's `stdin`. + When the TTY is disabled, then the stream is multiplexed to separate + `stdout` and `stderr`. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header contains the information which the stream writes (`stdout` or + `stderr`). It also contains the size of the associated frame encoded in the + last four bytes (`uint32`). + + It is encoded on the first eight bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: `stdin` (is written on `stdout`) +- 1: `stdout` +- 2: `stderr` + + `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of + the `uint32` size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read eight bytes. + 2. Choose `stdout` or `stderr` depending on the first byte. + 3. Extract the frame size from the last four bytes. + 4. Read the extracted size and output it on the correct output. + 5. Goto 1. + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default `false`. +- **stream** – 1/True/true or 0/False/false, return stream. + Default `false`. +- **stdin** – 1/True/true or 0/False/false, if `stream=true`, attach + to `stdin`. Default `false`. +- **stdout** – 1/True/true or 0/False/false, if `logs=true`, return + `stdout` log, if `stream=true`, attach to `stdout`. Default `false`. +- **stderr** – 1/True/true or 0/False/false, if `logs=true`, return + `stderr` log, if `stream=true`, attach to `stderr`. Default `false`. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default `false`. +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default `false`. + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275, + "Labels": {} + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135, + "Labels": { + "com.example.version": "v1" + } + } + ] + +**Example request, with digest information**: + + GET /images/json?digests=1 HTTP/1.1 + +**Example response, with digest information**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Created": 1420064636, + "Id": "4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125", + "ParentId": "ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2", + "RepoDigests": [ + "localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf" + ], + "RepoTags": [ + "localhost:5000/test/busybox:latest", + "playdate:latest" + ], + "Size": 0, + "VirtualSize": 2429728, + "Labels": {} + } + ] + +The response shows a single image `Id` associated with two repositories +(`RepoTags`): `localhost:5000/test/busybox`: and `playdate`. A caller can use +either of the `RepoTags` values `localhost:5000/test/busybox:latest` or +`playdate:latest` to reference the image. + +You can also use `RepoDigests` values to reference an image. In this response, +the array has only one reference and that is to the +`localhost:5000/test/busybox` repository; the `playdate` repository has no +digest. You can reference this digest using the value: +`localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d...` + +See the `docker run` and `docker build` commands for examples of digest and tag +references on the command line. + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a JSON encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - `dangling=true` + - `label=key` or `label="key=value"` of an image label +- **filter** - only return images with the specified name + +### Build image from a Dockerfile + +`POST /build` + +Build an image from a Dockerfile + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + +The input stream must be a `tar` archive compressed with one of the +following algorithms: `identity` (no compression), `gzip`, `bzip2`, `xz`. + +The archive must include a build instructions file, typically called +`Dockerfile` at the archive's root. The `dockerfile` parameter may be +used to specify a different build instructions file. To do this, its value must be +the path to the alternate build instructions file to use. + +The archive may include any number of other files, +which are accessible in the build context (See the [*ADD build +command*](../../reference/builder.md#dockerbuilder)). + +The build is canceled if the client drops the connection by quitting +or being killed. + +Query Parameters: + +- **dockerfile** - Path within the build context to the `Dockerfile`. This is + ignored if `remote` is specified and points to an external `Dockerfile`. +- **t** – Repository name (and optionally a tag) to be applied to + the resulting image in case of success. +- **remote** – A Git repository URI or HTTP/HTTPS context URI. If the + URI points to a single text file, the file's contents are placed into + a file called `Dockerfile` and the image is built from that file. If + the URI points to a tarball, the file is downloaded by the daemon and + the contents therein used as the context for the build. If the URI + points to a tarball and the `dockerfile` parameter is also specified, + there must be a file with the corresponding path inside the tarball. +- **q** – Suppress verbose build output. +- **nocache** – Do not use the cache when building the image. +- **pull** - Attempt to pull the image even if an older image exists locally. +- **rm** - Remove intermediate containers after a successful build (default behavior). +- **forcerm** - Always remove intermediate containers (includes `rm`). +- **memory** - Set memory limit for build. +- **memswap** - Total memory (memory + swap), `-1` to disable swap. +- **cpushares** - CPU shares (relative weight). +- **cpusetcpus** - CPUs in which to allow execution (e.g., `0-3`, `0,1`). +- **cpuperiod** - The length of a CPU period in microseconds. +- **cpuquota** - Microseconds of CPU time that the container can get in a CPU period. + + Request Headers: + +- **Content-type** – Set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + +When using this endpoint to pull an image from the registry, the +`X-Registry-Auth` header can be used to include +a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – Name of the image to pull. +- **fromSrc** – Source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. +- **repo** – Repository name. +- **tag** – Tag. +- **registry** – The registry to pull from. + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "PortSpecs": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "3db9c44f45209632d6050b35958829c3a2aa256d81b9a7be45b362ff85c54710", + "Created": 1398108230, + "CreatedBy": "/bin/sh -c #(nop) ADD file:eb15dbd63394e063b805a3c32ca7bf0266ef64676d5a6fab4801f2e81e2a5148 in /", + "Tags": [ + "ubuntu:lucid", + "ubuntu:10.04" + ], + "Size": 182964289, + "Comment": "" + }, + { + "Id": "6cfa4d1f33fb861d4d114f43b25abd0ac737509268065cdfd69d544a59c85ab8", + "Created": 1398108222, + "CreatedBy": "/bin/sh -c #(nop) MAINTAINER Tianon Gravi - mkimage-debootstrap.sh -i iproute,iputils-ping,ubuntu-minimal -t lucid.tar.xz lucid http://archive.ubuntu.com/ubuntu/", + "Tags": null, + "Size": 0, + "Comment": "" + }, + { + "Id": "511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158", + "Created": 1371157430, + "CreatedBy": "", + "Tags": [ + "scratch12:latest", + "scratch:latest" + ], + "Size": 0, + "Comment": "Imported from -" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + +If you wish to push an image on to a private registry, that image must already have a tag +into a repository which references that registry `hostname` and `port`. This repository name should +then be used in the URL. This duplicates the command line's flow. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – The tag to associate with the image on the registry. This is optional. + +Request Headers: + +- **X-Registry-Auth** – Include a base64-encoded AuthConfig. + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). This API +returns both `is_trusted` and `is_automated` images. Currently, they +are considered identical. In the future, the `is_trusted` property will +be deprecated and replaced by the `is_automated` property. + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "star_count": 12, + "is_official": false, + "name": "wma55/u1210sshd", + "is_trusted": false, + "is_automated": false, + "description": "", + }, + { + "star_count": 10, + "is_official": false, + "name": "jdswinbank/sshd", + "is_trusted": false, + "is_automated": false, + "description": "", + }, + { + "star_count": 18, + "is_official": false, + "name": "vgauthier/sshd", + "is_trusted": false, + "is_automated": false, + "description": "", + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "CpuCfsPeriod": true, + "CpuCfsQuota": true, + "Debug": false, + "DockerRootDir": "/var/lib/docker", + "Driver": "btrfs", + "DriverStatus": [[""]], + "ExecutionDriver": "native-0.1", + "ExperimentalBuild": false, + "HttpProxy": "http://test:test@localhost:8080", + "HttpsProxy": "https://test:test@localhost:8080", + "ID": "7TRN:IPZB:QYBB:VPBQ:UMPP:KARE:6ZNR:XE6T:7EWV:PKF4:ZOJD:TPYS", + "IPv4Forwarding": true, + "Images": 16, + "IndexServerAddress": "https://index.docker.io/v1/", + "InitPath": "/usr/bin/docker", + "InitSha1": "", + "KernelVersion": "3.12.0-1-amd64", + "Labels": [ + "storage=ssd" + ], + "MemTotal": 2099236864, + "MemoryLimit": true, + "NCPU": 1, + "NEventsListener": 0, + "NFd": 11, + "NGoroutines": 21, + "Name": "prod-server-42", + "NoProxy": "9.81.1.160", + "OomKillDisable": true, + "OperatingSystem": "Boot2Docker", + "RegistryConfig": { + "IndexConfigs": { + "docker.io": { + "Mirrors": null, + "Name": "docker.io", + "Official": true, + "Secure": true + } + }, + "InsecureRegistryCIDRs": [ + "127.0.0.0/8" + ] + }, + "SwapLimit": false, + "SystemTime": "2015-03-10T11:11:23.730591467-07:00" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version": "1.5.0", + "Os": "linux", + "KernelVersion": "3.18.5-tinycore64", + "GoVersion": "go1.4.1", + "GitCommit": "a8a31ef", + "Arch": "amd64", + "ApiVersion": "1.19" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Volumes": { + "/tmp": {} + }, + "Labels": { + "key1": "value1", + "key2": "value2" + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers report the following events: + + attach, commit, copy, create, destroy, die, exec_create, exec_start, export, kill, oom, pause, rename, resize, restart, start, stop, top, unpause + +and Docker images report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – Timestamp used for polling +- **until** – Timestamp used for polling +- **filters** – A json encoded value of the filters (a map[string][]string) to process on the event list. Available filters: + - `event=`; -- event to filter + - `image=`; -- image to filter + - `container=`; -- container to filter + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +`ubuntu:latest`), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into a Docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing these files: + +- `VERSION`: currently `1.0` - the file format version +- `json`: detailed layer information, similar to `docker inspect layer_id` +- `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file contains `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, the tarball should also include a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ], + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to `stdin` of the `exec` command. +- **AttachStdout** - Boolean value, attaches to `stdout` of the `exec` command. +- **AttachStderr** - Boolean value, attaches to `stderr` of the `exec` command. +- **Tty** - Boolean value to allocate a pseudo-TTY. +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up `exec` instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false, + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the `exec` command. +- **Tty** - Boolean value to allocate a pseudo-TTY. + +Status Codes: + +- **200** – no error +- **404** – no such exec instance + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the `tty` session used by the `exec` command `id`. +This API is valid only if `tty` was specified as part of creating and starting the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/resize HTTP/1.1 + Content-Type: text/plain + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: text/plain + +Query Parameters: + +- **h** – height of `tty` session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +### Exec Inspect + +`GET /exec/(id)/json` + +Return low-level information about the `exec` command `id`. + +**Example request**: + + GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: plain/text + + { + "ID" : "11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39", + "Running" : false, + "ExitCode" : 2, + "ProcessConfig" : { + "privileged" : false, + "user" : "", + "tty" : false, + "entrypoint" : "sh", + "arguments" : [ + "-c", + "exit 2" + ] + }, + "OpenStdin" : false, + "OpenStderr" : false, + "OpenStdout" : false, + "Container" : { + "State" : { + "Running" : true, + "Paused" : false, + "Restarting" : false, + "OOMKilled" : false, + "Pid" : 3650, + "ExitCode" : 0, + "Error" : "", + "StartedAt" : "2014-11-17T22:26:03.717657531Z", + "FinishedAt" : "0001-01-01T00:00:00Z" + }, + "ID" : "8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c", + "Created" : "2014-11-17T22:26:03.626304998Z", + "Path" : "date", + "Args" : [], + "Config" : { + "Hostname" : "8f177a186b97", + "Domainname" : "", + "User" : "", + "AttachStdin" : false, + "AttachStdout" : false, + "AttachStderr" : false, + "PortSpecs": null, + "ExposedPorts" : null, + "Tty" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "Env" : [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ], + "Cmd" : [ + "date" + ], + "Image" : "ubuntu", + "Volumes" : null, + "WorkingDir" : "", + "Entrypoint" : null, + "NetworkDisabled" : false, + "MacAddress" : "", + "OnBuild" : null, + "SecurityOpt" : null + }, + "Image" : "5506de2b643be1e6febbf3b8a240760c6843244c41e12aa2f60ccbb7153d17f5", + "NetworkSettings" : { + "IPAddress" : "172.17.0.2", + "IPPrefixLen" : 16, + "MacAddress" : "02:42:ac:11:00:02", + "Gateway" : "172.17.42.1", + "Bridge" : "docker0", + "PortMapping" : null, + "Ports" : {} + }, + "ResolvConfPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/resolv.conf", + "HostnamePath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hostname", + "HostsPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Name" : "/test", + "Driver" : "aufs", + "ExecDriver" : "native-0.2", + "MountLabel" : "", + "ProcessLabel" : "", + "AppArmorProfile" : "", + "RestartCount" : 0, + "Volumes" : {}, + "VolumesRW" : {} + } + } + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **500** - server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it. + - Then, retry to create the container. + +- Start the container. + +- If you are not in detached mode: +- Attach to the container, using `logs=1` (to have `stdout` and + `stderr` from the container's start) and `stream=1` + +- If in detached mode or only `stdin` is attached, display the container's id. + +## 3.2 Hijacking + +In this version of the API, `/attach`, uses hijacking to transport `stdin`, +`stdout`, and `stderr` on the same socket. + +To hint potential proxies about connection hijacking, Docker client sends +connection upgrade headers similarly to websocket. + + Upgrade: tcp + Connection: Upgrade + +When Docker daemon detects the `Upgrade` header, it switches its status code +from **200 OK** to **101 UPGRADED** and resends the same headers. + + +## 3.3 CORS Requests + +To set cross origin requests to the remote api please give values to +`--api-cors-header` when running Docker in daemon mode. Set * (asterisk) allows all, +default or blank means CORS disabled + + $ docker -d -H="192.168.1.9:2375" --api-cors-header="http://foo.bar" diff --git a/docs/reference/api/docker_remote_api_v1.2.md b/docs/reference/api/docker_remote_api_v1.2.md new file mode 100644 index 0000000000..678853eae1 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.2.md @@ -0,0 +1,1024 @@ + + +# Docker Remote API v1.2 + +# 1. Brief introduction + +- The Remote API is replacing rcli +- Default port in the docker daemon is 2375 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/e90e34656806/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/centos/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/fedora/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Tag":["ubuntu:latest"], + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > {{ authConfig }} + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **204** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + {{ STREAM }} + +Query Parameters: + +- **t** – repository name to be applied to the resulting image in + case of success +- **remote** – resource to fetch, as URI + +Status Codes: + +- **200** – no error +- **500** – server error + +{{ STREAM }} is the raw text output of the build command. It uses the +HTTP Hijack method in order to stream. + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Status": "Login Succeeded" + } + +Status Codes: + +- **200** – no error +- **204** – no error +- **401** – unauthorized +- **403** – forbidden +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + + - Start the container + + - If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + - Display the container's + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + +> docker -d -H="[tcp://192.168.1.9:2375](tcp://192.168.1.9:2375)" +> -api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.20.md b/docs/reference/api/docker_remote_api_v1.20.md new file mode 100644 index 0000000000..b7bf9939be --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.20.md @@ -0,0 +1,2311 @@ + + +# Docker Remote API v1.20 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST. However, for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout`, + `stdin` and `stderr`. + - When the client API version is newer than the daemon's, these calls return an HTTP + `400 Bad Request` error message. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleepy_dog"], + "Image": "ubuntu:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "Labels": {}, + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a JSON encoded value of the filters (a `map[string][]string`) to process on the containers list. Available filters: + - `exited=`; -- containers with exit code of `` ; + - `status=`(`created`|`restarting`|`running`|`paused`|`exited`) + - `label=key` or `label="key=value"` of a container label + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ], + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "CpuPeriod": 100000, + "CpuQuota": 50000, + "CpusetCpus": "0,1", + "CpusetMems": "0,1", + "BlkioWeight": 300, + "MemorySwappiness": 60, + "OomKillDisable": false, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "Ulimits": [{}], + "LogConfig": { "Type": "json-file", "Config": {} }, + "SecurityOpt": [""], + "CgroupParent": "" + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **Hostname** - A string value containing the hostname to use for the + container. +- **Domainname** - A string value containing the domain name to use + for the container. +- **User** - A string value specifying the user inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap** - Total memory limit (memory + swap); set `-1` to disable swap + You must use this with `memory` and make the swap value larger than `memory`. +- **CpuShares** - An integer value containing the container's CPU Shares + (ie. the relative weight vs other containers). +- **CpuPeriod** - The length of a CPU period in microseconds. +- **CpuQuota** - Microseconds of CPU time that the container can get in a CPU period. +- **Cpuset** - Deprecated please don't use. Use `CpusetCpus` instead. +- **CpusetCpus** - String value containing the `cgroups CpusetCpus` to use. +- **CpusetMems** - Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems. +- **BlkioWeight** - Block IO weight (relative weight) accepts a weight value between 10 and 1000. +- **MemorySwappiness** - Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. +- **OomKillDisable** - Boolean value, whether to disable OOM Killer for the container or not. +- **AttachStdin** - Boolean value, attaches to `stdin`. +- **AttachStdout** - Boolean value, attaches to `stdout`. +- **AttachStderr** - Boolean value, attaches to `stderr`. +- **Tty** - Boolean value, Attach standard streams to a `tty`, including `stdin` if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close `stdin` after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Labels** - Adds a map of labels to a container. To specify a map: `{"key":"value"[,"key2":"value2"]}` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entry point for the container as a string or an array + of strings. +- **Image** - A string specifying the image name to use for the container. +- **Mounts** - An array of mount points in the container. +- **WorkingDir** - A string specifying the working directory for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume binding is a string in one of these forms: + + `container_path` to create a new volume for the container + + `host_path:container_path` to bind-mount a host path into the container + + `host_path:container_path:ro` to make the bind-mount read-only inside the container. + - **Links** - A list of links for the container. Each link entry should be + in the form of `container_name:alias`. + - **LxcConf** - LXC specific configurations. These configurations only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. A JSON object in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **ReadonlyRootfs** - Mount the container's root filesystem as read only. + Specified as a boolean value. + - **Dns** - A list of DNS servers for the container to use. + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to add to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified as a JSON object in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + - **Ulimits** - A list of ulimits to set in the container, specified as + `{ "Name": , "Soft": , "Hard": }`, for example: + `Ulimits: { "Name": "nofile", "Soft": 1024, "Hard": 2048 }` + - **SecurityOpt**: A list of string values to customize labels for MLS + systems, such as SELinux. + - **LogConfig** - Log configuration for the container, specified as a JSON object in the form + `{ "Type": "", "Config": {"key1": "val1"}}`. + Available types: `json-file`, `syslog`, `journald`, `gelf`, `none`. + `json-file` logging driver. + - **CgroupParent** - Path to `cgroups` under which the container's `cgroup` is created. If the path is not absolute, the path is considered to be relative to the `cgroups` path of the init process. Cgroups are created if they do not already exist. + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "AppArmorProfile": "", + "Args": [ + "-c", + "exit 9" + ], + "Config": { + "AttachStderr": true, + "AttachStdin": false, + "AttachStdout": true, + "Cmd": [ + "/bin/sh", + "-c", + "exit 9" + ], + "Domainname": "", + "Entrypoint": null, + "Env": [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "ExposedPorts": null, + "Hostname": "ba033ac44011", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "MacAddress": "", + "NetworkDisabled": false, + "OnBuild": null, + "OpenStdin": false, + "StdinOnce": false, + "Tty": false, + "User": "", + "Volumes": null, + "WorkingDir": "" + }, + "Created": "2015-01-06T15:47:31.485331387Z", + "Driver": "devicemapper", + "ExecDriver": "native-0.2", + "ExecIDs": null, + "HostConfig": { + "Binds": null, + "BlkioWeight": 0, + "CapAdd": null, + "CapDrop": null, + "ContainerIDFile": "", + "CpusetCpus": "", + "CpusetMems": "", + "CpuShares": 0, + "CpuPeriod": 100000, + "Devices": [], + "Dns": null, + "DnsSearch": null, + "ExtraHosts": null, + "IpcMode": "", + "Links": null, + "LxcConf": [], + "Memory": 0, + "MemorySwap": 0, + "OomKillDisable": false, + "NetworkMode": "bridge", + "PortBindings": {}, + "Privileged": false, + "ReadonlyRootfs": false, + "PublishAllPorts": false, + "RestartPolicy": { + "MaximumRetryCount": 2, + "Name": "on-failure" + }, + "LogConfig": { + "Config": null, + "Type": "json-file" + }, + "SecurityOpt": null, + "VolumesFrom": null, + "Ulimits": [{}] + }, + "HostnamePath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hostname", + "HostsPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Id": "ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39", + "Image": "04c5d3b7b0656168630d3ba35d8889bd0e9caafcaeb3004d2bfbc47e7c5d35d2", + "MountLabel": "", + "Name": "/boring_euclid", + "NetworkSettings": { + "Bridge": "", + "Gateway": "", + "IPAddress": "", + "IPPrefixLen": 0, + "MacAddress": "", + "PortMapping": null, + "Ports": null + }, + "Path": "/bin/sh", + "ProcessLabel": "", + "ResolvConfPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/resolv.conf", + "RestartCount": 1, + "State": { + "Error": "", + "ExitCode": 9, + "FinishedAt": "2015-01-06T15:47:32.080254511Z", + "OOMKilled": false, + "Paused": false, + "Pid": 0, + "Restarting": false, + "Running": false, + "StartedAt": "2015-01-06T15:47:32.072697474Z" + }, + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ] + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get `stdout` and `stderr` logs from the container ``id`` + +> **Note**: +> This endpoint works only for containers with the `json-file` or `journald` logging drivers. + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default `false`. +- **stdout** – 1/True/true or 0/False/false, show `stdout` log. Default `false`. +- **stderr** – 1/True/true or 0/False/false, show `stderr` log. Default `false`. +- **since** – UNIX timestamp (integer) to filter logs. Specifying a timestamp + will only output log-entries since that timestamp. Default: 0 (unfiltered) +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default `false`. +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all. + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Values for `Kind`: + +- `0`: Modify +- `1`: Add +- `2`: Delete + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container stats based on resource usage + +`GET /containers/(id)/stats` + +This endpoint returns a live stream of a container's resource usage statistics. + +> **Note**: this functionality currently only works when using the *libcontainer* exec-driver. + +**Example request**: + + GET /containers/redis1/stats HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "read" : "2015-01-08T22:57:31.547920715Z", + "network" : { + "rx_dropped" : 0, + "rx_bytes" : 648, + "rx_errors" : 0, + "tx_packets" : 8, + "tx_dropped" : 0, + "rx_packets" : 8, + "tx_errors" : 0, + "tx_bytes" : 648 + }, + "memory_stats" : { + "stats" : { + "total_pgmajfault" : 0, + "cache" : 0, + "mapped_file" : 0, + "total_inactive_file" : 0, + "pgpgout" : 414, + "rss" : 6537216, + "total_mapped_file" : 0, + "writeback" : 0, + "unevictable" : 0, + "pgpgin" : 477, + "total_unevictable" : 0, + "pgmajfault" : 0, + "total_rss" : 6537216, + "total_rss_huge" : 6291456, + "total_writeback" : 0, + "total_inactive_anon" : 0, + "rss_huge" : 6291456, + "hierarchical_memory_limit" : 67108864, + "total_pgfault" : 964, + "total_active_file" : 0, + "active_anon" : 6537216, + "total_active_anon" : 6537216, + "total_pgpgout" : 414, + "total_cache" : 0, + "inactive_anon" : 0, + "active_file" : 0, + "pgfault" : 964, + "inactive_file" : 0, + "total_pgpgin" : 477 + }, + "max_usage" : 6651904, + "usage" : 6537216, + "failcnt" : 0, + "limit" : 67108864 + }, + "blkio_stats" : {}, + "cpu_stats" : { + "cpu_usage" : { + "percpu_usage" : [ + 16970827, + 1839451, + 7107380, + 10571290 + ], + "usage_in_usermode" : 10000000, + "total_usage" : 36488948, + "usage_in_kernelmode" : 20000000 + }, + "system_cpu_usage" : 20091722000000000, + "throttling_data" : {} + } + } + +Query Parameters: + +- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`. + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`POST /containers/(id)/resize?h=&w=` + +Resize the TTY for container with `id`. You must restart the container for the resize to take effect. + +**Example request**: + + POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – Cannot resize container + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +> **Note**: +> For backwards compatibility, this endpoint accepts a `HostConfig` as JSON-encoded request body. +> See [create a container](#create-a-container) for details. + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like `SIGINT`. + When not set, `SIGKILL` is assumed and the call waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Rename a container + +`POST /containers/(id)/rename` + +Rename the container `id` to a `new_name` + +**Example request**: + + POST /containers/e90e34656806/rename?name=new_name HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **name** – new name for the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **409** - conflict name already assigned +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default `false`. +- **stream** – 1/True/true or 0/False/false, return stream. + Default `false`. +- **stdin** – 1/True/true or 0/False/false, if `stream=true`, attach + to `stdin`. Default `false`. +- **stdout** – 1/True/true or 0/False/false, if `logs=true`, return + `stdout` log, if `stream=true`, attach to `stdout`. Default `false`. +- **stderr** – 1/True/true or 0/False/false, if `logs=true`, return + `stderr` log, if `stream=true`, attach to `stderr`. Default `false`. + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](#create-a-container), + the stream is the raw data from the process PTY and client's `stdin`. + When the TTY is disabled, then the stream is multiplexed to separate + `stdout` and `stderr`. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header contains the information which the stream writes (`stdout` or + `stderr`). It also contains the size of the associated frame encoded in the + last four bytes (`uint32`). + + It is encoded on the first eight bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: `stdin` (is written on `stdout`) +- 1: `stdout` +- 2: `stderr` + + `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of + the `uint32` size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read eight bytes. + 2. Choose `stdout` or `stderr` depending on the first byte. + 3. Extract the frame size from the last four bytes. + 4. Read the extracted size and output it on the correct output. + 5. Goto 1. + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default `false`. +- **stream** – 1/True/true or 0/False/false, return stream. + Default `false`. +- **stdin** – 1/True/true or 0/False/false, if `stream=true`, attach + to `stdin`. Default `false`. +- **stdout** – 1/True/true or 0/False/false, if `logs=true`, return + `stdout` log, if `stream=true`, attach to `stdout`. Default `false`. +- **stderr** – 1/True/true or 0/False/false, if `logs=true`, return + `stderr` log, if `stream=true`, attach to `stderr`. Default `false`. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default `false`. +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default `false`. + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Deprecated** in favor of the `archive` endpoint below. + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Retrieving information about files and folders in a container + +`HEAD /containers/(id)/archive` + +See the description of the `X-Docker-Container-Path-Stat` header in the +following section. + +### Get an archive of a filesystem resource in a container + +`GET /containers/(id)/archive` + +Get an tar archive of a resource in the filesystem of container `id`. + +Query Parameters: + +- **path** - resource in the container's filesystem to archive. Required. + + If not an absolute path, it is relative to the container's root directory. + The resource specified by **path** must exist. To assert that the resource + is expected to be a directory, **path** should end in `/` or `/.` + (assuming a path separator of `/`). If **path** ends in `/.` then this + indicates that only the contents of the **path** directory should be + copied. A symlink is always resolved to its target. + + **Note**: It is not possible to copy certain system files such as resources + under `/proc`, `/sys`, `/dev`, and mounts created by the user in the + container. + +**Example request**: + + GET /containers/8cce319429b2/archive?path=/root HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + X-Docker-Container-Path-Stat: eyJuYW1lIjoicm9vdCIsInNpemUiOjQwOTYsIm1vZGUiOjIxNDc0ODQwOTYsIm10aW1lIjoiMjAxNC0wMi0yN1QyMDo1MToyM1oiLCJsaW5rVGFyZ2V0IjoiIn0= + + {{ TAR STREAM }} + +On success, a response header `X-Docker-Container-Path-Stat` will be set to a +base64-encoded JSON object containing some filesystem header information about +the archived resource. The above example value would decode to the following +JSON object (whitespace added for readability): + + { + "name": "root", + "size": 4096, + "mode": 2147484096, + "mtime": "2014-02-27T20:51:23Z", + "linkTarget": "" + } + +A `HEAD` request can also be made to this endpoint if only this information is +desired. + +Status Codes: + +- **200** - success, returns archive of copied resource +- **400** - client error, bad parameter, details in JSON response body, one of: + - must specify path parameter (**path** cannot be empty) + - not a directory (**path** was asserted to be a directory but exists as a + file) +- **404** - client error, resource not found, one of: + – no such container (container `id` does not exist) + - no such file or directory (**path** does not exist) +- **500** - server error + +### Extract an archive of files or folders to a directory in a container + +`PUT /containers/(id)/archive` + +Upload a tar archive to be extracted to a path in the filesystem of container +`id`. + +Query Parameters: + +- **path** - path to a directory in the container + to extract the archive's contents into. Required. + + If not an absolute path, it is relative to the container's root directory. + The **path** resource must exist. +- **noOverwriteDirNonDir** - If "1", "true", or "True" then it will be an error + if unpacking the given content would cause an existing directory to be + replaced with a non-directory and vice versa. + +**Example request**: + + PUT /containers/8cce319429b2/archive?path=/vol1 HTTP/1.1 + Content-Type: application/x-tar + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – the content was extracted successfully +- **400** - client error, bad parameter, details in JSON response body, one of: + - must specify path parameter (**path** cannot be empty) + - not a directory (**path** should be a directory but exists as a file) + - unable to overwrite existing directory with non-directory + (if **noOverwriteDirNonDir**) + - unable to overwrite existing non-directory with directory + (if **noOverwriteDirNonDir**) +- **403** - client error, permission denied, the volume + or container rootfs is marked as read-only. +- **404** - client error, resource not found, one of: + – no such container (container `id` does not exist) + - no such file or directory (**path** resource does not exist) +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275, + "Labels": {} + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135, + "Labels": { + "com.example.version": "v1" + } + } + ] + +**Example request, with digest information**: + + GET /images/json?digests=1 HTTP/1.1 + +**Example response, with digest information**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Created": 1420064636, + "Id": "4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125", + "ParentId": "ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2", + "RepoDigests": [ + "localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf" + ], + "RepoTags": [ + "localhost:5000/test/busybox:latest", + "playdate:latest" + ], + "Size": 0, + "VirtualSize": 2429728, + "Labels": {} + } + ] + +The response shows a single image `Id` associated with two repositories +(`RepoTags`): `localhost:5000/test/busybox`: and `playdate`. A caller can use +either of the `RepoTags` values `localhost:5000/test/busybox:latest` or +`playdate:latest` to reference the image. + +You can also use `RepoDigests` values to reference an image. In this response, +the array has only one reference and that is to the +`localhost:5000/test/busybox` repository; the `playdate` repository has no +digest. You can reference this digest using the value: +`localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d...` + +See the `docker run` and `docker build` commands for examples of digest and tag +references on the command line. + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a JSON encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - `dangling=true` + - `label=key` or `label="key=value"` of an image label +- **filter** - only return images with the specified name + +### Build image from a Dockerfile + +`POST /build` + +Build an image from a Dockerfile + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + +The input stream must be a `tar` archive compressed with one of the +following algorithms: `identity` (no compression), `gzip`, `bzip2`, `xz`. + +The archive must include a build instructions file, typically called +`Dockerfile` at the archive's root. The `dockerfile` parameter may be +used to specify a different build instructions file. To do this, its value must be +the path to the alternate build instructions file to use. + +The archive may include any number of other files, +which are accessible in the build context (See the [*ADD build +command*](../../reference/builder.md#dockerbuilder)). + +The build is canceled if the client drops the connection by quitting +or being killed. + +Query Parameters: + +- **dockerfile** - Path within the build context to the Dockerfile. This is + ignored if `remote` is specified and points to an individual filename. +- **t** – A repository name (and optionally a tag) to apply to + the resulting image in case of success. +- **remote** – A Git repository URI or HTTP/HTTPS URI build source. If the + URI specifies a filename, the file's contents are placed into a file + called `Dockerfile`. +- **q** – Suppress verbose build output. +- **nocache** – Do not use the cache when building the image. +- **pull** - Attempt to pull the image even if an older image exists locally. +- **rm** - Remove intermediate containers after a successful build (default behavior). +- **forcerm** - Always remove intermediate containers (includes `rm`). +- **memory** - Set memory limit for build. +- **memswap** - Total memory (memory + swap), `-1` to disable swap. +- **cpushares** - CPU shares (relative weight). +- **cpusetcpus** - CPUs in which to allow execution (e.g., `0-3`, `0,1`). +- **cpuperiod** - The length of a CPU period in microseconds. +- **cpuquota** - Microseconds of CPU time that the container can get in a CPU period. + + Request Headers: + +- **Content-type** – Set to `"application/tar"`. +- **X-Registry-Config** – A base64-url-safe-encoded Registry Auth Config JSON + object with the following structure: + + { + "docker.example.com": { + "username": "janedoe", + "password": "hunter2" + }, + "https://index.docker.io/v1/": { + "username": "mobydock", + "password": "conta1n3rize14" + } + } + + This object maps the hostname of a registry to an object containing the + "username" and "password" for that registry. Multiple registries may + be specified as the build may be based on an image requiring + authentication to pull from any arbitrary registry. Only the registry + domain name (and port if not the default "443") are required. However + (for legacy reasons) the "official" Docker, Inc. hosted registry must + be specified with both a "https://" prefix and a "/v1/" suffix even + though Docker will prefer to use the v2 registry API. + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + +When using this endpoint to pull an image from the registry, the +`X-Registry-Auth` header can be used to include +a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – Name of the image to pull. +- **fromSrc** – Source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. +- **repo** – Repository name. +- **tag** – Tag. +- **registry** – The registry to pull from. + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/ubuntu/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Created": "2013-03-23T22:24:18.818426-07:00", + "Container": "3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "ContainerConfig": + { + "Hostname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "Tty": true, + "OpenStdin": true, + "StdinOnce": false, + "Env": null, + "Cmd": ["/bin/bash"], + "Dns": null, + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Volumes": null, + "VolumesFrom": "", + "WorkingDir": "" + }, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Parent": "27cf784147099545", + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "3db9c44f45209632d6050b35958829c3a2aa256d81b9a7be45b362ff85c54710", + "Created": 1398108230, + "CreatedBy": "/bin/sh -c #(nop) ADD file:eb15dbd63394e063b805a3c32ca7bf0266ef64676d5a6fab4801f2e81e2a5148 in /", + "Tags": [ + "ubuntu:lucid", + "ubuntu:10.04" + ], + "Size": 182964289, + "Comment": "" + }, + { + "Id": "6cfa4d1f33fb861d4d114f43b25abd0ac737509268065cdfd69d544a59c85ab8", + "Created": 1398108222, + "CreatedBy": "/bin/sh -c #(nop) MAINTAINER Tianon Gravi - mkimage-debootstrap.sh -i iproute,iputils-ping,ubuntu-minimal -t lucid.tar.xz lucid http://archive.ubuntu.com/ubuntu/", + "Tags": null, + "Size": 0, + "Comment": "" + }, + { + "Id": "511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158", + "Created": 1371157430, + "CreatedBy": "", + "Tags": [ + "scratch12:latest", + "scratch:latest" + ], + "Size": 0, + "Comment": "Imported from -" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + +If you wish to push an image on to a private registry, that image must already have a tag +into a repository which references that registry `hostname` and `port`. This repository name should +then be used in the URL. This duplicates the command line's flow. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – The tag to associate with the image on the registry. This is optional. + +Request Headers: + +- **X-Registry-Auth** – Include a base64-encoded AuthConfig. + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "CpuCfsPeriod": true, + "CpuCfsQuota": true, + "Debug": false, + "DockerRootDir": "/var/lib/docker", + "Driver": "btrfs", + "DriverStatus": [[""]], + "ExecutionDriver": "native-0.1", + "ExperimentalBuild": false, + "HttpProxy": "http://test:test@localhost:8080", + "HttpsProxy": "https://test:test@localhost:8080", + "ID": "7TRN:IPZB:QYBB:VPBQ:UMPP:KARE:6ZNR:XE6T:7EWV:PKF4:ZOJD:TPYS", + "IPv4Forwarding": true, + "Images": 16, + "IndexServerAddress": "https://index.docker.io/v1/", + "InitPath": "/usr/bin/docker", + "InitSha1": "", + "KernelVersion": "3.12.0-1-amd64", + "Labels": [ + "storage=ssd" + ], + "MemTotal": 2099236864, + "MemoryLimit": true, + "NCPU": 1, + "NEventsListener": 0, + "NFd": 11, + "NGoroutines": 21, + "Name": "prod-server-42", + "NoProxy": "9.81.1.160", + "OomKillDisable": true, + "OperatingSystem": "Boot2Docker", + "RegistryConfig": { + "IndexConfigs": { + "docker.io": { + "Mirrors": null, + "Name": "docker.io", + "Official": true, + "Secure": true + } + }, + "InsecureRegistryCIDRs": [ + "127.0.0.0/8" + ] + }, + "SwapLimit": false, + "SystemTime": "2015-03-10T11:11:23.730591467-07:00" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version": "1.5.0", + "Os": "linux", + "KernelVersion": "3.18.5-tinycore64", + "GoVersion": "go1.4.1", + "GitCommit": "a8a31ef", + "Arch": "amd64", + "ApiVersion": "1.20", + "Experimental": false + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ], + "Labels": { + "key1": "value1", + "key2": "value2" + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") +- **pause** – 1/True/true or 0/False/false, whether to pause the container before committing +- **changes** – Dockerfile instructions to apply while committing + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers report the following events: + + attach, commit, copy, create, destroy, die, exec_create, exec_start, export, kill, oom, pause, rename, resize, restart, start, stop, top, unpause + +and Docker images report: + + delete, import, pull, push, tag, untag + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "ubuntu:latest", "time":1374067970} + +Query Parameters: + +- **since** – Timestamp used for polling +- **until** – Timestamp used for polling +- **filters** – A json encoded value of the filters (a map[string][]string) to process on the event list. Available filters: + - `event=`; -- event to filter + - `image=`; -- image to filter + - `container=`; -- container to filter + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +`ubuntu:latest`), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into a Docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing these files: + +- `VERSION`: currently `1.0` - the file format version +- `json`: detailed layer information, similar to `docker inspect layer_id` +- `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file contains `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, the tarball should also include a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to `stdin` of the `exec` command. +- **AttachStdout** - Boolean value, attaches to `stdout` of the `exec` command. +- **AttachStderr** - Boolean value, attaches to `stderr` of the `exec` command. +- **Tty** - Boolean value to allocate a pseudo-TTY. +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up `exec` instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the `exec` command. +- **Tty** - Boolean value to allocate a pseudo-TTY. + +Status Codes: + +- **200** – no error +- **404** – no such exec instance + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the `tty` session used by the `exec` command `id`. The unit is number of characters. +This API is valid only if `tty` was specified as part of creating and starting the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1 + Content-Type: text/plain + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: text/plain + +Query Parameters: + +- **h** – height of `tty` session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +### Exec Inspect + +`GET /exec/(id)/json` + +Return low-level information about the `exec` command `id`. + +**Example request**: + + GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: plain/text + + { + "ID" : "11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39", + "Running" : false, + "ExitCode" : 2, + "ProcessConfig" : { + "privileged" : false, + "user" : "", + "tty" : false, + "entrypoint" : "sh", + "arguments" : [ + "-c", + "exit 2" + ] + }, + "OpenStdin" : false, + "OpenStderr" : false, + "OpenStdout" : false, + "Container" : { + "State" : { + "Running" : true, + "Paused" : false, + "Restarting" : false, + "OOMKilled" : false, + "Pid" : 3650, + "ExitCode" : 0, + "Error" : "", + "StartedAt" : "2014-11-17T22:26:03.717657531Z", + "FinishedAt" : "0001-01-01T00:00:00Z" + }, + "ID" : "8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c", + "Created" : "2014-11-17T22:26:03.626304998Z", + "Path" : "date", + "Args" : [], + "Config" : { + "Hostname" : "8f177a186b97", + "Domainname" : "", + "User" : "", + "AttachStdin" : false, + "AttachStdout" : false, + "AttachStderr" : false, + "ExposedPorts" : null, + "Tty" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "Env" : [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ], + "Cmd" : [ + "date" + ], + "Image" : "ubuntu", + "Volumes" : null, + "WorkingDir" : "", + "Entrypoint" : null, + "NetworkDisabled" : false, + "MacAddress" : "", + "OnBuild" : null, + "SecurityOpt" : null + }, + "Image" : "5506de2b643be1e6febbf3b8a240760c6843244c41e12aa2f60ccbb7153d17f5", + "NetworkSettings" : { + "IPAddress" : "172.17.0.2", + "IPPrefixLen" : 16, + "MacAddress" : "02:42:ac:11:00:02", + "Gateway" : "172.17.42.1", + "Bridge" : "docker0", + "PortMapping" : null, + "Ports" : {} + }, + "ResolvConfPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/resolv.conf", + "HostnamePath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hostname", + "HostsPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Name" : "/test", + "Driver" : "aufs", + "ExecDriver" : "native-0.2", + "MountLabel" : "", + "ProcessLabel" : "", + "AppArmorProfile" : "", + "RestartCount" : 0, + "Mounts" : [] + } + } + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **500** - server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it. + - Then, retry to create the container. + +- Start the container. + +- If you are not in detached mode: +- Attach to the container, using `logs=1` (to have `stdout` and + `stderr` from the container's start) and `stream=1` + +- If in detached mode or only `stdin` is attached, display the container's id. + +## 3.2 Hijacking + +In this version of the API, `/attach`, uses hijacking to transport `stdin`, +`stdout`, and `stderr` on the same socket. + +To hint potential proxies about connection hijacking, Docker client sends +connection upgrade headers similarly to websocket. + + Upgrade: tcp + Connection: Upgrade + +When Docker daemon detects the `Upgrade` header, it switches its status code +from **200 OK** to **101 UPGRADED** and resends the same headers. + + +## 3.3 CORS Requests + +To set cross origin requests to the remote api please give values to +`--api-cors-header` when running Docker in daemon mode. Set * (asterisk) allows all, +default or blank means CORS disabled + + $ docker daemon -H="192.168.1.9:2375" --api-cors-header="http://foo.bar" diff --git a/docs/reference/api/docker_remote_api_v1.21.md b/docs/reference/api/docker_remote_api_v1.21.md new file mode 100644 index 0000000000..ec4eb36951 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.21.md @@ -0,0 +1,2871 @@ + + +# Docker Remote API v1.21 + +## 1. Brief introduction + + - The Remote API has replaced `rcli`. + - The daemon listens on `unix:///var/run/docker.sock` but you can + [Bind Docker to another host/port or a Unix socket](../../userguide/basics.md#bind-docker-to-another-host-port-or-a-unix-socket). + - The API tends to be REST. However, for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout`, + `stdin` and `stderr`. + - When the client API version is newer than the daemon's, these calls return an HTTP + `400 Bad Request` error message. + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Names":["/boring_feynman"], + "Image": "ubuntu:latest", + "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Names":["/coolName"], + "Image": "ubuntu:latest", + "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Names":["/sleepy_dog"], + "Image": "ubuntu:latest", + "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "Labels": {}, + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Names":["/running_cat"], + "Image": "ubuntu:latest", + "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "Labels": {}, + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created + containers, include non-running ones. +- **since** – Show only containers created since Id, include + non-running ones. +- **before** – Show only containers created before Id, include + non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers + sizes +- **filters** - a JSON encoded value of the filters (a `map[string][]string`) to process on the containers list. Available filters: + - `exited=`; -- containers with exit code of `` ; + - `status=`(`created`|`restarting`|`running`|`paused`|`exited`) + - `label=key` or `label="key=value"` of a container label + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ], + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "StopSignal": "SIGTERM", + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "Memory": 0, + "MemorySwap": 0, + "MemoryReservation": 0, + "KernelMemory": 0, + "CpuShares": 512, + "CpuPeriod": 100000, + "CpuQuota": 50000, + "CpusetCpus": "0,1", + "CpusetMems": "0,1", + "BlkioWeight": 300, + "MemorySwappiness": 60, + "OomKillDisable": false, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsOptions": [""], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "Ulimits": [{}], + "LogConfig": { "Type": "json-file", "Config": {} }, + "SecurityOpt": [""], + "CgroupParent": "", + "VolumeDriver": "" + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **Hostname** - A string value containing the hostname to use for the + container. +- **Domainname** - A string value containing the domain name to use + for the container. +- **User** - A string value specifying the user inside the container. +- **Memory** - Memory limit in bytes. +- **MemorySwap** - Total memory limit (memory + swap); set `-1` to disable swap + You must use this with `memory` and make the swap value larger than `memory`. +- **MemoryReservation** - Memory soft limit in bytes. +- **KernelMemory** - Kernel memory limit in bytes. +- **CpuShares** - An integer value containing the container's CPU Shares + (ie. the relative weight vs other containers). +- **CpuPeriod** - The length of a CPU period in microseconds. +- **CpuQuota** - Microseconds of CPU time that the container can get in a CPU period. +- **Cpuset** - Deprecated please don't use. Use `CpusetCpus` instead. +- **CpusetCpus** - String value containing the `cgroups CpusetCpus` to use. +- **CpusetMems** - Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems. +- **BlkioWeight** - Block IO weight (relative weight) accepts a weight value between 10 and 1000. +- **MemorySwappiness** - Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. +- **OomKillDisable** - Boolean value, whether to disable OOM Killer for the container or not. +- **AttachStdin** - Boolean value, attaches to `stdin`. +- **AttachStdout** - Boolean value, attaches to `stdout`. +- **AttachStderr** - Boolean value, attaches to `stderr`. +- **Tty** - Boolean value, Attach standard streams to a `tty`, including `stdin` if it is not closed. +- **OpenStdin** - Boolean value, opens stdin, +- **StdinOnce** - Boolean value, close `stdin` after the 1 attached client disconnects. +- **Env** - A list of environment variables in the form of `VAR=value` +- **Labels** - Adds a map of labels to a container. To specify a map: `{"key":"value"[,"key2":"value2"]}` +- **Cmd** - Command to run specified as a string or an array of strings. +- **Entrypoint** - Set the entry point for the container as a string or an array + of strings. +- **Image** - A string specifying the image name to use for the container. +- **Mounts** - An array of mount points in the container. +- **WorkingDir** - A string specifying the working directory for commands to + run in. +- **NetworkDisabled** - Boolean value, when true disables networking for the + container +- **ExposedPorts** - An object mapping ports to an empty object in the form of: + `"ExposedPorts": { "/: {}" }` +- **StopSignal** - Signal to stop a container as a string or unsigned integer. `SIGTERM` by default. +- **HostConfig** + - **Binds** – A list of volume bindings for this container. Each volume binding is a string in one of these forms: + + `container_path` to create a new volume for the container + + `host_path:container_path` to bind-mount a host path into the container + + `host_path:container_path:ro` to make the bind-mount read-only inside the container. + - **Links** - A list of links for the container. Each link entry should be + in the form of `container_name:alias`. + - **LxcConf** - LXC specific configurations. These configurations only + work when using the `lxc` execution driver. + - **PortBindings** - A map of exposed container ports and the host port they + should map to. A JSON object in the form + `{ /: [{ "HostPort": "" }] }` + Take note that `port` is specified as a string and not an integer value. + - **PublishAllPorts** - Allocates a random host port for all of a container's + exposed ports. Specified as a boolean value. + - **Privileged** - Gives the container full access to the host. Specified as + a boolean value. + - **ReadonlyRootfs** - Mount the container's root filesystem as read only. + Specified as a boolean value. + - **Dns** - A list of DNS servers for the container to use. + - **DnsOptions** - A list of DNS options + - **DnsSearch** - A list of DNS search domains + - **ExtraHosts** - A list of hostnames/IP mappings to add to the + container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`. + - **VolumesFrom** - A list of volumes to inherit from another container. + Specified in the form `[:]` + - **CapAdd** - A list of kernel capabilities to add to the container. + - **Capdrop** - A list of kernel capabilities to drop from the container. + - **RestartPolicy** – The behavior to apply when the container exits. The + value is an object with a `Name` property of either `"always"` to + always restart, `"unless-stopped"` to restart always except when + user has manually stopped the container or `"on-failure"` to restart only when the container + exit code is non-zero. If `on-failure` is used, `MaximumRetryCount` + controls the number of times to retry before giving up. + The default is not to restart. (optional) + An ever increasing delay (double the previous delay, starting at 100mS) + is added before each restart to prevent flooding the server. + - **NetworkMode** - Sets the networking mode for the container. Supported + values are: `bridge`, `host`, and `container:` + - **Devices** - A list of devices to add to the container specified as a JSON object in the + form + `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}` + - **Ulimits** - A list of ulimits to set in the container, specified as + `{ "Name": , "Soft": , "Hard": }`, for example: + `Ulimits: { "Name": "nofile", "Soft": 1024, "Hard": 2048 }` + - **SecurityOpt**: A list of string values to customize labels for MLS + systems, such as SELinux. + - **LogConfig** - Log configuration for the container, specified as a JSON object in the form + `{ "Type": "", "Config": {"key1": "val1"}}`. + Available types: `json-file`, `syslog`, `journald`, `gelf`, `awslogs`, `none`. + `json-file` logging driver. + - **CgroupParent** - Path to `cgroups` under which the container's `cgroup` is created. If the path is not absolute, the path is considered to be relative to the `cgroups` path of the init process. Cgroups are created if they do not already exist. + - **VolumeDriver** - Driver that this container users to mount volumes. + +Query Parameters: + +- **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "AppArmorProfile": "", + "Args": [ + "-c", + "exit 9" + ], + "Config": { + "AttachStderr": true, + "AttachStdin": false, + "AttachStdout": true, + "Cmd": [ + "/bin/sh", + "-c", + "exit 9" + ], + "Domainname": "", + "Entrypoint": null, + "Env": [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "ExposedPorts": null, + "Hostname": "ba033ac44011", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "MacAddress": "", + "NetworkDisabled": false, + "OnBuild": null, + "OpenStdin": false, + "StdinOnce": false, + "Tty": false, + "User": "", + "Volumes": null, + "WorkingDir": "", + "StopSignal": "SIGTERM" + }, + "Created": "2015-01-06T15:47:31.485331387Z", + "Driver": "devicemapper", + "ExecDriver": "native-0.2", + "ExecIDs": null, + "HostConfig": { + "Binds": null, + "BlkioWeight": 0, + "CapAdd": null, + "CapDrop": null, + "ContainerIDFile": "", + "CpusetCpus": "", + "CpusetMems": "", + "CpuShares": 0, + "CpuPeriod": 100000, + "Devices": [], + "Dns": null, + "DnsOptions": null, + "DnsSearch": null, + "ExtraHosts": null, + "IpcMode": "", + "Links": null, + "LxcConf": [], + "Memory": 0, + "MemorySwap": 0, + "MemoryReservation": 0, + "KernelMemory": 0, + "OomKillDisable": false, + "NetworkMode": "bridge", + "PortBindings": {}, + "Privileged": false, + "ReadonlyRootfs": false, + "PublishAllPorts": false, + "RestartPolicy": { + "MaximumRetryCount": 2, + "Name": "on-failure" + }, + "LogConfig": { + "Config": null, + "Type": "json-file" + }, + "SecurityOpt": null, + "VolumesFrom": null, + "Ulimits": [{}], + "VolumeDriver": "" + }, + "HostnamePath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hostname", + "HostsPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Id": "ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39", + "Image": "04c5d3b7b0656168630d3ba35d8889bd0e9caafcaeb3004d2bfbc47e7c5d35d2", + "MountLabel": "", + "Name": "/boring_euclid", + "NetworkSettings": { + "Bridge": "", + "SandboxID": "", + "HairpinMode": false, + "LinkLocalIPv6Address": "", + "LinkLocalIPv6PrefixLen": 0, + "Ports": null, + "SandboxKey": "", + "SecondaryIPAddresses": null, + "SecondaryIPv6Addresses": null, + "EndpointID": "", + "Gateway": "", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "IPAddress": "", + "IPPrefixLen": 0, + "IPv6Gateway": "", + "MacAddress": "", + "Networks": { + "bridge": { + "EndpointID": "", + "Gateway": "", + "IPAddress": "", + "IPPrefixLen": 0, + "IPv6Gateway": "", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "MacAddress": "" + } + } + }, + "Path": "/bin/sh", + "ProcessLabel": "", + "ResolvConfPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/resolv.conf", + "RestartCount": 1, + "State": { + "Error": "", + "ExitCode": 9, + "FinishedAt": "2015-01-06T15:47:32.080254511Z", + "OOMKilled": false, + "Paused": false, + "Pid": 0, + "Restarting": false, + "Running": true, + "StartedAt": "2015-01-06T15:47:32.072697474Z", + "Status": "running" + }, + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ] + } + +**Example request, with size information**: + + GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1 + +**Example response, with size information**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + .... + "SizeRw": 0, + "SizeRootFs": 972, + .... + } + +Query Parameters: + +- **size** – 1/True/true or 0/False/false, return container size information. Default is `false`. + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container logs + +`GET /containers/(id)/logs` + +Get `stdout` and `stderr` logs from the container ``id`` + +> **Note**: +> This endpoint works only for containers with the `json-file` or `journald` logging drivers. + +**Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **follow** – 1/True/true or 0/False/false, return stream. Default `false`. +- **stdout** – 1/True/true or 0/False/false, show `stdout` log. Default `false`. +- **stderr** – 1/True/true or 0/False/false, show `stderr` log. Default `false`. +- **since** – UNIX timestamp (integer) to filter logs. Specifying a timestamp + will only output log-entries since that timestamp. Default: 0 (unfiltered) +- **timestamps** – 1/True/true or 0/False/false, print timestamps for + every log line. Default `false`. +- **tail** – Output specified number of lines at the end of logs: `all` or ``. Default all. + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Values for `Kind`: + +- `0`: Modify +- `1`: Add +- `2`: Delete + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Get container stats based on resource usage + +`GET /containers/(id)/stats` + +This endpoint returns a live stream of a container's resource usage statistics. + +> **Note**: this functionality currently only works when using the *libcontainer* exec-driver. + +**Example request**: + + GET /containers/redis1/stats HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "read" : "2015-01-08T22:57:31.547920715Z", + "networks": { + "eth0": { + "rx_bytes": 5338, + "rx_dropped": 0, + "rx_errors": 0, + "rx_packets": 36, + "tx_bytes": 648, + "tx_dropped": 0, + "tx_errors": 0, + "tx_packets": 8 + }, + "eth5": { + "rx_bytes": 4641, + "rx_dropped": 0, + "rx_errors": 0, + "rx_packets": 26, + "tx_bytes": 690, + "tx_dropped": 0, + "tx_errors": 0, + "tx_packets": 9 + } + }, + "memory_stats" : { + "stats" : { + "total_pgmajfault" : 0, + "cache" : 0, + "mapped_file" : 0, + "total_inactive_file" : 0, + "pgpgout" : 414, + "rss" : 6537216, + "total_mapped_file" : 0, + "writeback" : 0, + "unevictable" : 0, + "pgpgin" : 477, + "total_unevictable" : 0, + "pgmajfault" : 0, + "total_rss" : 6537216, + "total_rss_huge" : 6291456, + "total_writeback" : 0, + "total_inactive_anon" : 0, + "rss_huge" : 6291456, + "hierarchical_memory_limit" : 67108864, + "total_pgfault" : 964, + "total_active_file" : 0, + "active_anon" : 6537216, + "total_active_anon" : 6537216, + "total_pgpgout" : 414, + "total_cache" : 0, + "inactive_anon" : 0, + "active_file" : 0, + "pgfault" : 964, + "inactive_file" : 0, + "total_pgpgin" : 477 + }, + "max_usage" : 6651904, + "usage" : 6537216, + "failcnt" : 0, + "limit" : 67108864 + }, + "blkio_stats" : {}, + "cpu_stats" : { + "cpu_usage" : { + "percpu_usage" : [ + 16970827, + 1839451, + 7107380, + 10571290 + ], + "usage_in_usermode" : 10000000, + "total_usage" : 36488948, + "usage_in_kernelmode" : 20000000 + }, + "system_cpu_usage" : 20091722000000000, + "throttling_data" : {} + } + } + +Query Parameters: + +- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`. + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Resize a container TTY + +`POST /containers/(id)/resize` + +Resize the TTY for container with `id`. The unit is number of characters. You must restart the container for the resize to take effect. + +**Example request**: + + POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Length: 0 + Content-Type: text/plain; charset=utf-8 + +Query Parameters: + +- **h** – height of `tty` session +- **w** – width + +Status Codes: + +- **200** – no error +- **404** – No such container +- **500** – Cannot resize container + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +> **Note**: +> For backwards compatibility, this endpoint accepts a `HostConfig` as JSON-encoded request body. +> See [create a container](#create-a-container) for details. + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **304** – container already started +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **304** – container already stopped +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like `SIGINT`. + When not set, `SIGKILL` is assumed and the call waits for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Rename a container + +`POST /containers/(id)/rename` + +Rename the container `id` to a `new_name` + +**Example request**: + + POST /containers/e90e34656806/rename?name=new_name HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **name** – new name for the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **409** - conflict name already assigned +- **500** – server error + +### Pause a container + +`POST /containers/(id)/pause` + +Pause the container `id` + +**Example request**: + + POST /containers/e90e34656806/pause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Unpause a container + +`POST /containers/(id)/unpause` + +Unpause the container `id` + +**Example request**: + + POST /containers/e90e34656806/unpause HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 101 UPGRADED + Content-Type: application/vnd.docker.raw-stream + Connection: Upgrade + Upgrade: tcp + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default `false`. +- **stream** – 1/True/true or 0/False/false, return stream. + Default `false`. +- **stdin** – 1/True/true or 0/False/false, if `stream=true`, attach + to `stdin`. Default `false`. +- **stdout** – 1/True/true or 0/False/false, if `logs=true`, return + `stdout` log, if `stream=true`, attach to `stdout`. Default `false`. +- **stderr** – 1/True/true or 0/False/false, if `logs=true`, return + `stderr` log, if `stream=true`, attach to `stderr`. Default `false`. + +Status Codes: + +- **101** – no error, hints proxy about hijacking +- **200** – no error, no upgrade header found +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](#create-a-container), + the stream is the raw data from the process PTY and client's `stdin`. + When the TTY is disabled, then the stream is multiplexed to separate + `stdout` and `stderr`. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header contains the information which the stream writes (`stdout` or + `stderr`). It also contains the size of the associated frame encoded in the + last four bytes (`uint32`). + + It is encoded on the first eight bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: `stdin` (is written on `stdout`) +- 1: `stdout` +- 2: `stderr` + + `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of + the `uint32` size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read eight bytes. + 2. Choose `stdout` or `stderr` depending on the first byte. + 3. Extract the frame size from the last four bytes. + 4. Read the extracted size and output it on the correct output. + 5. Goto 1. + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default `false`. +- **stream** – 1/True/true or 0/False/false, return stream. + Default `false`. +- **stdin** – 1/True/true or 0/False/false, if `stream=true`, attach + to `stdin`. Default `false`. +- **stdout** – 1/True/true or 0/False/false, if `logs=true`, return + `stdout` log, if `stream=true`, attach to `stdout`. Default `false`. +- **stderr** – 1/True/true or 0/False/false, if `logs=true`, return + `stderr` log, if `stream=true`, attach to `stderr`. Default `false`. + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default `false`. +- **force** - 1/True/true or 0/False/false, Kill then remove the container. + Default `false`. + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Deprecated** in favor of the `archive` endpoint below. + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Retrieving information about files and folders in a container + +`HEAD /containers/(id)/archive` + +See the description of the `X-Docker-Container-Path-Stat` header in the +following section. + +### Get an archive of a filesystem resource in a container + +`GET /containers/(id)/archive` + +Get an tar archive of a resource in the filesystem of container `id`. + +Query Parameters: + +- **path** - resource in the container's filesystem to archive. Required. + + If not an absolute path, it is relative to the container's root directory. + The resource specified by **path** must exist. To assert that the resource + is expected to be a directory, **path** should end in `/` or `/.` + (assuming a path separator of `/`). If **path** ends in `/.` then this + indicates that only the contents of the **path** directory should be + copied. A symlink is always resolved to its target. + + **Note**: It is not possible to copy certain system files such as resources + under `/proc`, `/sys`, `/dev`, and mounts created by the user in the + container. + +**Example request**: + + GET /containers/8cce319429b2/archive?path=/root HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + X-Docker-Container-Path-Stat: eyJuYW1lIjoicm9vdCIsInNpemUiOjQwOTYsIm1vZGUiOjIxNDc0ODQwOTYsIm10aW1lIjoiMjAxNC0wMi0yN1QyMDo1MToyM1oiLCJsaW5rVGFyZ2V0IjoiIn0= + + {{ TAR STREAM }} + +On success, a response header `X-Docker-Container-Path-Stat` will be set to a +base64-encoded JSON object containing some filesystem header information about +the archived resource. The above example value would decode to the following +JSON object (whitespace added for readability): + + { + "name": "root", + "size": 4096, + "mode": 2147484096, + "mtime": "2014-02-27T20:51:23Z", + "linkTarget": "" + } + +A `HEAD` request can also be made to this endpoint if only this information is +desired. + +Status Codes: + +- **200** - success, returns archive of copied resource +- **400** - client error, bad parameter, details in JSON response body, one of: + - must specify path parameter (**path** cannot be empty) + - not a directory (**path** was asserted to be a directory but exists as a + file) +- **404** - client error, resource not found, one of: + – no such container (container `id` does not exist) + - no such file or directory (**path** does not exist) +- **500** - server error + +### Extract an archive of files or folders to a directory in a container + +`PUT /containers/(id)/archive` + +Upload a tar archive to be extracted to a path in the filesystem of container +`id`. + +Query Parameters: + +- **path** - path to a directory in the container + to extract the archive's contents into. Required. + + If not an absolute path, it is relative to the container's root directory. + The **path** resource must exist. +- **noOverwriteDirNonDir** - If "1", "true", or "True" then it will be an error + if unpacking the given content would cause an existing directory to be + replaced with a non-directory and vice versa. + +**Example request**: + + PUT /containers/8cce319429b2/archive?path=/vol1 HTTP/1.1 + Content-Type: application/x-tar + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – the content was extracted successfully +- **400** - client error, bad parameter, details in JSON response body, one of: + - must specify path parameter (**path** cannot be empty) + - not a directory (**path** should be a directory but exists as a file) + - unable to overwrite existing directory with non-directory + (if **noOverwriteDirNonDir**) + - unable to overwrite existing non-directory with directory + (if **noOverwriteDirNonDir**) +- **403** - client error, permission denied, the volume + or container rootfs is marked as read-only. +- **404** - client error, resource not found, one of: + – no such container (container `id` does not exist) + - no such file or directory (**path** resource does not exist) +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275, + "Labels": {} + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135, + "Labels": { + "com.example.version": "v1" + } + } + ] + +**Example request, with digest information**: + + GET /images/json?digests=1 HTTP/1.1 + +**Example response, with digest information**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Created": 1420064636, + "Id": "4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125", + "ParentId": "ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2", + "RepoDigests": [ + "localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf" + ], + "RepoTags": [ + "localhost:5000/test/busybox:latest", + "playdate:latest" + ], + "Size": 0, + "VirtualSize": 2429728, + "Labels": {} + } + ] + +The response shows a single image `Id` associated with two repositories +(`RepoTags`): `localhost:5000/test/busybox`: and `playdate`. A caller can use +either of the `RepoTags` values `localhost:5000/test/busybox:latest` or +`playdate:latest` to reference the image. + +You can also use `RepoDigests` values to reference an image. In this response, +the array has only one reference and that is to the +`localhost:5000/test/busybox` repository; the `playdate` repository has no +digest. You can reference this digest using the value: +`localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d...` + +See the `docker run` and `docker build` commands for examples of digest and tag +references on the command line. + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, default false +- **filters** – a JSON encoded value of the filters (a map[string][]string) to process on the images list. Available filters: + - `dangling=true` + - `label=key` or `label="key=value"` of an image label +- **filter** - only return images with the specified name + +### Build image from a Dockerfile + +`POST /build` + +Build an image from a Dockerfile + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + +The input stream must be a `tar` archive compressed with one of the +following algorithms: `identity` (no compression), `gzip`, `bzip2`, `xz`. + +The archive must include a build instructions file, typically called +`Dockerfile` at the archive's root. The `dockerfile` parameter may be +used to specify a different build instructions file. To do this, its value must be +the path to the alternate build instructions file to use. + +The archive may include any number of other files, +which are accessible in the build context (See the [*ADD build +command*](../../reference/builder.md#dockerbuilder)). + +The build is canceled if the client drops the connection by quitting +or being killed. + +Query Parameters: + +- **dockerfile** - Path within the build context to the Dockerfile. This is + ignored if `remote` is specified and points to an individual filename. +- **t** – A repository name (and optionally a tag) to apply to + the resulting image in case of success. +- **remote** – A Git repository URI or HTTP/HTTPS URI build source. If the + URI specifies a filename, the file's contents are placed into a file + called `Dockerfile`. +- **q** – Suppress verbose build output. +- **nocache** – Do not use the cache when building the image. +- **pull** - Attempt to pull the image even if an older image exists locally. +- **rm** - Remove intermediate containers after a successful build (default behavior). +- **forcerm** - Always remove intermediate containers (includes `rm`). +- **memory** - Set memory limit for build. +- **memswap** - Total memory (memory + swap), `-1` to disable swap. +- **cpushares** - CPU shares (relative weight). +- **cpusetcpus** - CPUs in which to allow execution (e.g., `0-3`, `0,1`). +- **cpuperiod** - The length of a CPU period in microseconds. +- **cpuquota** - Microseconds of CPU time that the container can get in a CPU period. +- **buildargs** – JSON map of string pairs for build-time variables. Users pass + these values at build-time. Docker uses the `buildargs` as the environment + context for command(s) run via the Dockerfile's `RUN` instruction or for + variable expansion in other Dockerfile instructions. This is not meant for + passing secret values. [Read more about the buildargs instruction](../../reference/builder.md#arg) + + Request Headers: + +- **Content-type** – Set to `"application/tar"`. +- **X-Registry-Config** – A base64-url-safe-encoded Registry Auth Config JSON + object with the following structure: + + { + "docker.example.com": { + "username": "janedoe", + "password": "hunter2" + }, + "https://index.docker.io/v1/": { + "username": "mobydock", + "password": "conta1n3rize14" + } + } + + This object maps the hostname of a registry to an object containing the + "username" and "password" for that registry. Multiple registries may + be specified as the build may be based on an image requiring + authentication to pull from any arbitrary registry. Only the registry + domain name (and port if not the default "443") are required. However + (for legacy reasons) the "official" Docker, Inc. hosted registry must + be specified with both a "https://" prefix and a "/v1/" suffix even + though Docker will prefer to use the v2 registry API. + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image either by pulling it from the registry or by importing it + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + +When using this endpoint to pull an image from the registry, the +`X-Registry-Auth` header can be used to include +a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – Name of the image to pull. The name may include a tag or + digest. This parameter may only be used when pulling an image. +- **fromSrc** – Source to import. The value may be a URL from which the image + can be retrieved or `-` to read the image from the request body. + This parameter may only be used when importing an image. +- **repo** – Repository name given to an image when it is imported. + The repo may include a tag. This parameter may only be used when importing + an image. +- **tag** – Tag or digest. + + Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + + + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/example/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id" : "85f05633ddc1c50679be2b16a0479ab6f7637f8884e0cfe0f4d20e1ebb3d6e7c", + "Container" : "cb91e48a60d01f1e27028b4fc6819f4f290b3cf12496c8176ec714d0d390984a", + "Comment" : "", + "Os" : "linux", + "Architecture" : "amd64", + "Parent" : "91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c", + "ContainerConfig" : { + "Tty" : false, + "Hostname" : "e611e15f9c9d", + "Volumes" : null, + "Domainname" : "", + "AttachStdout" : false, + "PublishService" : "", + "AttachStdin" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "NetworkDisabled" : false, + "OnBuild" : [], + "Image" : "91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c", + "User" : "", + "WorkingDir" : "", + "Entrypoint" : null, + "MacAddress" : "", + "AttachStderr" : false, + "Labels" : { + "com.example.license" : "GPL", + "com.example.version" : "1.0", + "com.example.vendor" : "Acme" + }, + "Env" : [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "ExposedPorts" : null, + "Cmd" : [ + "/bin/sh", + "-c", + "#(nop) LABEL com.example.vendor=Acme com.example.license=GPL com.example.version=1.0" + ] + }, + "DockerVersion" : "1.9.0-dev", + "VirtualSize" : 188359297, + "Size" : 0, + "Author" : "", + "Created" : "2015-09-10T08:30:53.26995814Z", + "GraphDriver" : { + "Name" : "aufs", + "Data" : null + }, + "RepoDigests" : [ + "localhost:5000/test/busybox/example@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf" + ], + "RepoTags" : [ + "example:1.0", + "example:latest", + "example:stable" + ], + "Config" : { + "Image" : "91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c", + "NetworkDisabled" : false, + "OnBuild" : [], + "StdinOnce" : false, + "PublishService" : "", + "AttachStdin" : false, + "OpenStdin" : false, + "Domainname" : "", + "AttachStdout" : false, + "Tty" : false, + "Hostname" : "e611e15f9c9d", + "Volumes" : null, + "Cmd" : [ + "/bin/bash" + ], + "ExposedPorts" : null, + "Env" : [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + ], + "Labels" : { + "com.example.vendor" : "Acme", + "com.example.version" : "1.0", + "com.example.license" : "GPL" + }, + "Entrypoint" : null, + "MacAddress" : "", + "AttachStderr" : false, + "WorkingDir" : "", + "User" : "" + } + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/ubuntu/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "3db9c44f45209632d6050b35958829c3a2aa256d81b9a7be45b362ff85c54710", + "Created": 1398108230, + "CreatedBy": "/bin/sh -c #(nop) ADD file:eb15dbd63394e063b805a3c32ca7bf0266ef64676d5a6fab4801f2e81e2a5148 in /", + "Tags": [ + "ubuntu:lucid", + "ubuntu:10.04" + ], + "Size": 182964289, + "Comment": "" + }, + { + "Id": "6cfa4d1f33fb861d4d114f43b25abd0ac737509268065cdfd69d544a59c85ab8", + "Created": 1398108222, + "CreatedBy": "/bin/sh -c #(nop) MAINTAINER Tianon Gravi - mkimage-debootstrap.sh -i iproute,iputils-ping,ubuntu-minimal -t lucid.tar.xz lucid http://archive.ubuntu.com/ubuntu/", + "Tags": null, + "Size": 0, + "Comment": "" + }, + { + "Id": "511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158", + "Created": 1371157430, + "CreatedBy": "", + "Tags": [ + "scratch12:latest", + "scratch:latest" + ], + "Size": 0, + "Comment": "Imported from -" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + +If you wish to push an image on to a private registry, that image must already have a tag +into a repository which references that registry `hostname` and `port`. This repository name should +then be used in the URL. This duplicates the command line's flow. + +**Example request**: + + POST /images/registry.acme.com:5000/test/push HTTP/1.1 + + +Query Parameters: + +- **tag** – The tag to associate with the image on the registry. This is optional. + +Request Headers: + +- **X-Registry-Auth** – Include a base64-encoded AuthConfig. + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Query Parameters: + +- **force** – 1/True/true or 0/False/false, default false +- **noprune** – 1/True/true or 0/False/false, default false + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_automated": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers": 11, + "CpuCfsPeriod": true, + "CpuCfsQuota": true, + "Debug": false, + "DiscoveryBackend": "etcd://localhost:2379", + "DockerRootDir": "/var/lib/docker", + "Driver": "btrfs", + "DriverStatus": [[""]], + "ExecutionDriver": "native-0.1", + "ExperimentalBuild": false, + "HttpProxy": "http://test:test@localhost:8080", + "HttpsProxy": "https://test:test@localhost:8080", + "ID": "7TRN:IPZB:QYBB:VPBQ:UMPP:KARE:6ZNR:XE6T:7EWV:PKF4:ZOJD:TPYS", + "IPv4Forwarding": true, + "Images": 16, + "IndexServerAddress": "https://index.docker.io/v1/", + "InitPath": "/usr/bin/docker", + "InitSha1": "", + "KernelVersion": "3.12.0-1-amd64", + "Labels": [ + "storage=ssd" + ], + "MemTotal": 2099236864, + "MemoryLimit": true, + "NCPU": 1, + "NEventsListener": 0, + "NFd": 11, + "NGoroutines": 21, + "Name": "prod-server-42", + "NoProxy": "9.81.1.160", + "OomKillDisable": true, + "OperatingSystem": "Boot2Docker", + "RegistryConfig": { + "IndexConfigs": { + "docker.io": { + "Mirrors": null, + "Name": "docker.io", + "Official": true, + "Secure": true + } + }, + "InsecureRegistryCIDRs": [ + "127.0.0.0/8" + ] + }, + "SwapLimit": false, + "SystemTime": "2015-03-10T11:11:23.730591467-07:00" + "ServerVersion": "1.9.0" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version": "1.5.0", + "Os": "linux", + "KernelVersion": "3.18.5-tinycore64", + "GoVersion": "go1.4.1", + "GitCommit": "a8a31ef", + "Arch": "amd64", + "ApiVersion": "1.20", + "Experimental": false + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Ping the docker server + +`GET /_ping` + +Ping the docker server + +**Example request**: + + GET /_ping HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + OK + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ], + "Labels": { + "key1": "value1", + "key2": "value2" + }, + "WorkingDir": "", + "NetworkDisabled": false, + "ExposedPorts": { + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **comment** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") +- **pause** – 1/True/true or 0/False/false, whether to pause the container before committing +- **changes** – Dockerfile instructions to apply while committing + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get container events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers report the following events: + + attach, commit, copy, create, destroy, die, exec_create, exec_start, export, kill, oom, pause, rename, resize, restart, start, stop, top, unpause + +and Docker images report: + + delete, import, pull, push, tag, untag + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"pull","id":"busybox:latest","time":1442421700,"timeNano":1442421700598988358} + {"status":"create","id":"5745704abe9caa5","from":"busybox","time":1442421716,"timeNano":1442421716853979870} + {"status":"attach","id":"5745704abe9caa5","from":"busybox","time":1442421716,"timeNano":1442421716894759198} + {"status":"start","id":"5745704abe9caa5","from":"busybox","time":1442421716,"timeNano":1442421716983607193} + +Query Parameters: + +- **since** – Timestamp used for polling +- **until** – Timestamp used for polling +- **filters** – A json encoded value of the filters (a map[string][]string) to process on the event list. Available filters: + - `container=`; -- container to filter + - `event=`; -- event to filter + - `image=`; -- image to filter + - `label=`; -- image and container label to filter + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified +by `name`. + +If `name` is a specific name and tag (e.g. ubuntu:latest), then only that image +(and its parents) are returned. If `name` is an image ID, similarly only that +image (and its parents) are returned, but with the exclusion of the +'repositories' file in the tarball, as there were no image names referenced. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images. + +`GET /images/get` + +Get a tarball containing all images and metadata for one or more repositories. + +For each value of the `names` parameter: if it is a specific name and tag (e.g. +`ubuntu:latest`), then only that image (and its parents) are returned; if it is +an image ID, similarly only that image (and its parents) are returned and there +would be no names referenced in the 'repositories' file for this image ID. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/get?names=myname%2Fmyapp%3Alatest&names=busybox + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into a Docker repository. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing these files: + +- `VERSION`: currently `1.0` - the file format version +- `json`: detailed layer information, similar to `docker inspect layer_id` +- `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file contains `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, the tarball should also include a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +### Exec Create + +`POST /containers/(id)/exec` + +Sets up an exec instance in a running container `id` + +**Example request**: + + POST /containers/e90e34656806/exec HTTP/1.1 + Content-Type: application/json + + { + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "Cmd": [ + "date" + ] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id": "f90e34656806", + "Warnings":[] + } + +Json Parameters: + +- **AttachStdin** - Boolean value, attaches to `stdin` of the `exec` command. +- **AttachStdout** - Boolean value, attaches to `stdout` of the `exec` command. +- **AttachStderr** - Boolean value, attaches to `stderr` of the `exec` command. +- **Tty** - Boolean value to allocate a pseudo-TTY. +- **Cmd** - Command to run specified as a string or an array of strings. + + +Status Codes: + +- **201** – no error +- **404** – no such container + +### Exec Start + +`POST /exec/(id)/start` + +Starts a previously set up `exec` instance `id`. If `detach` is true, this API +returns after starting the `exec` command. Otherwise, this API sets up an +interactive session with the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "Detach": false, + "Tty": false + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + {{ STREAM }} + +Json Parameters: + +- **Detach** - Detach from the `exec` command. +- **Tty** - Boolean value to allocate a pseudo-TTY. + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **409** - container is stopped or paused + + **Stream details**: + Similar to the stream behavior of `POST /container/(id)/attach` API + +### Exec Resize + +`POST /exec/(id)/resize` + +Resizes the `tty` session used by the `exec` command `id`. The unit is number of characters. +This API is valid only if `tty` was specified as part of creating and starting the `exec` command. + +**Example request**: + + POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1 + Content-Type: text/plain + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: text/plain + +Query Parameters: + +- **h** – height of `tty` session +- **w** – width + +Status Codes: + +- **201** – no error +- **404** – no such exec instance + +### Exec Inspect + +`GET /exec/(id)/json` + +Return low-level information about the `exec` command `id`. + +**Example request**: + + GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: plain/text + + { + "ID" : "11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39", + "Running" : false, + "ExitCode" : 2, + "ProcessConfig" : { + "privileged" : false, + "user" : "", + "tty" : false, + "entrypoint" : "sh", + "arguments" : [ + "-c", + "exit 2" + ] + }, + "OpenStdin" : false, + "OpenStderr" : false, + "OpenStdout" : false, + "Container" : { + "State" : { + "Status" : "running", + "Running" : true, + "Paused" : false, + "Restarting" : false, + "OOMKilled" : false, + "Pid" : 3650, + "ExitCode" : 0, + "Error" : "", + "StartedAt" : "2014-11-17T22:26:03.717657531Z", + "FinishedAt" : "0001-01-01T00:00:00Z" + }, + "ID" : "8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c", + "Created" : "2014-11-17T22:26:03.626304998Z", + "Path" : "date", + "Args" : [], + "Config" : { + "Hostname" : "8f177a186b97", + "Domainname" : "", + "User" : "", + "AttachStdin" : false, + "AttachStdout" : false, + "AttachStderr" : false, + "ExposedPorts" : null, + "Tty" : false, + "OpenStdin" : false, + "StdinOnce" : false, + "Env" : [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ], + "Cmd" : [ + "date" + ], + "Image" : "ubuntu", + "Volumes" : null, + "WorkingDir" : "", + "Entrypoint" : null, + "NetworkDisabled" : false, + "MacAddress" : "", + "OnBuild" : null, + "SecurityOpt" : null + }, + "Image" : "5506de2b643be1e6febbf3b8a240760c6843244c41e12aa2f60ccbb7153d17f5", + "NetworkSettings": { + "Bridge": "", + "SandboxID": "", + "HairpinMode": false, + "LinkLocalIPv6Address": "", + "LinkLocalIPv6PrefixLen": 0, + "Ports": null, + "SandboxKey": "", + "SecondaryIPAddresses": null, + "SecondaryIPv6Addresses": null, + "EndpointID": "", + "Gateway": "", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "IPAddress": "", + "IPPrefixLen": 0, + "IPv6Gateway": "", + "MacAddress": "", + "Networks": { + "bridge": { + "EndpointID": "", + "Gateway": "", + "IPAddress": "", + "IPPrefixLen": 0, + "IPv6Gateway": "", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "MacAddress": "" + } + } + }, + "ResolvConfPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/resolv.conf", + "HostnamePath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hostname", + "HostsPath" : "/var/lib/docker/containers/8f177a186b977fb451136e0fdf182abff5599a08b3c7f6ef0d36a55aaf89634c/hosts", + "LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log", + "Name" : "/test", + "Driver" : "aufs", + "ExecDriver" : "native-0.2", + "MountLabel" : "", + "ProcessLabel" : "", + "AppArmorProfile" : "", + "RestartCount" : 0, + "Mounts" : [] + } + } + +Status Codes: + +- **200** – no error +- **404** – no such exec instance +- **500** - server error + +## 2.4 Volumes + +### List volumes + +`GET /volumes` + +**Example request**: + + GET /volumes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Volumes": [ + { + "Name": "tardis", + "Driver": "local", + "Mountpoint": "/var/lib/docker/volumes/tardis" + } + ] + } + +Query Parameters: + +- **filters** - JSON encoded value of the filters (a `map[string][]string`) to process on the volumes list. There is one available filter: `dangling=true` + +Status Codes: + +- **200** - no error +- **500** - server error + +### Create a volume + +`POST /volumes/create` + +Create a volume + +**Example request**: + + POST /volumes/create HTTP/1.1 + Content-Type: application/json + + { + "Name": "tardis" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Name": "tardis", + "Driver": "local", + "Mountpoint": "/var/lib/docker/volumes/tardis" + } + +Status Codes: + +- **201** - no error +- **500** - server error + +JSON Parameters: + +- **Name** - The new volume's name. If not specified, Docker generates a name. +- **Driver** - Name of the volume driver to use. Defaults to `local` for the name. +- **DriverOpts** - A mapping of driver options and values. These options are + passed directly to the driver and are driver specific. + +### Inspect a volume + +`GET /volumes/(name)` + +Return low-level information on the volume `name` + +**Example request**: + + GET /volumes/tardis + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Name": "tardis", + "Driver": "local", + "Mountpoint": "/var/lib/docker/volumes/tardis" + } + +Status Codes: + +- **200** - no error +- **404** - no such volume +- **500** - server error + +### Remove a volume + +`DELETE /volumes/(name)` + +Instruct the driver to remove the volume (`name`). + +**Example request**: + + DELETE /volumes/local/tardis HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes + +- **204** - no error +- **404** - no such volume or volume driver +- **409** - volume is in use and cannot be removed +- **500** - server error + +## 2.5 Networks + +### List networks + +`GET /networks` + +**Example request**: + + GET /networks HTTP/1.1 + +**Example response**: + +``` +HTTP/1.1 200 OK +Content-Type: application/json + +[ + { + "Name": "bridge", + "Id": "f2de39df4171b0dc801e8002d1d999b77256983dfc63041c0f34030aa3977566", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + { + "Subnet": "172.17.0.0/16" + } + ] + }, + "Containers": { + "39b69226f9d79f5634485fb236a23b2fe4e96a0a94128390a7fbbcc167065867": { + "EndpointID": "ed2419a97c1d9954d05b46e462e7002ea552f216e9b136b80a7db8d98b442eda", + "MacAddress": "02:42:ac:11:00:02", + "IPv4Address": "172.17.0.2/16", + "IPv6Address": "" + } + }, + "Options": { + "com.docker.network.bridge.default_bridge": "true", + "com.docker.network.bridge.enable_icc": "true", + "com.docker.network.bridge.enable_ip_masquerade": "true", + "com.docker.network.bridge.host_binding_ipv4": "0.0.0.0", + "com.docker.network.bridge.name": "docker0", + "com.docker.network.driver.mtu": "1500" + } + }, + { + "Name": "none", + "Id": "e086a3893b05ab69242d3c44e49483a3bbbd3a26b46baa8f61ab797c1088d794", + "Scope": "local", + "Driver": "null", + "IPAM": { + "Driver": "default", + "Config": [] + }, + "Containers": {}, + "Options": {} + }, + { + "Name": "host", + "Id": "13e871235c677f196c4e1ecebb9dc733b9b2d2ab589e30c539efeda84a24215e", + "Scope": "local", + "Driver": "host", + "IPAM": { + "Driver": "default", + "Config": [] + }, + "Containers": {}, + "Options": {} + } +] +``` + + + +Query Parameters: + +- **filters** - JSON encoded value of the filters (a `map[string][]string`) to process on the networks list. Available filters: `name=[network-names]` , `id=[network-ids]` + +Status Codes: + +- **200** - no error +- **500** - server error + +### Inspect network + +`GET /networks/` + +**Example request**: + + GET /networks/f2de39df4171b0dc801e8002d1d999b77256983dfc63041c0f34030aa3977566 HTTP/1.1 + +**Example response**: + +``` +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "Name": "bridge", + "Id": "f2de39df4171b0dc801e8002d1d999b77256983dfc63041c0f34030aa3977566", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + { + "Subnet": "172.17.0.0/16" + } + ] + }, + "Containers": { + "39b69226f9d79f5634485fb236a23b2fe4e96a0a94128390a7fbbcc167065867": { + "EndpointID": "ed2419a97c1d9954d05b46e462e7002ea552f216e9b136b80a7db8d98b442eda", + "MacAddress": "02:42:ac:11:00:02", + "IPv4Address": "172.17.0.2/16", + "IPv6Address": "" + } + }, + "Options": { + "com.docker.network.bridge.default_bridge": "true", + "com.docker.network.bridge.enable_icc": "true", + "com.docker.network.bridge.enable_ip_masquerade": "true", + "com.docker.network.bridge.host_binding_ipv4": "0.0.0.0", + "com.docker.network.bridge.name": "docker0", + "com.docker.network.driver.mtu": "1500" + } +} +``` + +Status Codes: + +- **200** - no error +- **404** - network not found + +### Create a network + +`POST /networks/create` + +Create a network + +**Example request**: + +``` +POST /networks/create HTTP/1.1 +Content-Type: application/json + +{ + "Name":"isolated_nw", + "Driver":"bridge" + "IPAM":{ + "Config":[{ + "Subnet":"172.20.0.0/16", + "IPRange":"172.20.10.0/24", + "Gateway":"172.20.10.11" + }] +} +``` + +**Example response**: + +``` +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "Id": "22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30", + "Warning": "" +} +``` + +Status Codes: + +- **201** - no error +- **404** - driver not found +- **500** - server error + +JSON Parameters: + +- **Name** - The new network's name. this is a mandatory field +- **Driver** - Name of the network driver to use. Defaults to `bridge` driver +- **IPAM** - Optional custom IP scheme for the network +- **Options** - Network specific options to be used by the drivers +- **CheckDuplicate** - Requests daemon to check for networks with same name + +### Connect a container to a network + +`POST /networks/(id)/connect` + +Connects a container to a network + +**Example request**: + +``` +POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1 +Content-Type: application/json + +{ + "Container":"3613f73ba0e4" +} +``` + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **201** - no error +- **404** - network or container is not found + +JSON Parameters: + +- **container** - container-id/name to be connected to the network + +### Disconnect a container from a network + +`POST /networks/(id)/disconnect` + +Disconnects a container from a network + +**Example request**: + +``` +POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1 +Content-Type: application/json + +{ + "Container":"3613f73ba0e4" +} +``` + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **201** - no error +- **404** - network or container not found + +JSON Parameters: + +- **Container** - container-id/name to be disconnected from a network + +### Remove a network + +`DELETE /networks/(id)` + +Instruct the driver to remove the network (`id`). + +**Example request**: + + DELETE /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes + +- **204** - no error +- **404** - no such network +- **500** - server error + +# 3. Going further + +## 3.1 Inside `docker run` + +As an example, the `docker run` command line makes the following API calls: + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it. + - Then, retry to create the container. + +- Start the container. + +- If you are not in detached mode: +- Attach to the container, using `logs=1` (to have `stdout` and + `stderr` from the container's start) and `stream=1` + +- If in detached mode or only `stdin` is attached, display the container's id. + +## 3.2 Hijacking + +In this version of the API, `/attach`, uses hijacking to transport `stdin`, +`stdout`, and `stderr` on the same socket. + +To hint potential proxies about connection hijacking, Docker client sends +connection upgrade headers similarly to websocket. + + Upgrade: tcp + Connection: Upgrade + +When Docker daemon detects the `Upgrade` header, it switches its status code +from **200 OK** to **101 UPGRADED** and resends the same headers. + + +## 3.3 CORS Requests + +To set cross origin requests to the remote api please give values to +`--api-cors-header` when running Docker in daemon mode. Set * (asterisk) allows all, +default or blank means CORS disabled + + $ docker daemon -H="192.168.1.9:2375" --api-cors-header="http://foo.bar" diff --git a/docs/reference/api/docker_remote_api_v1.3.md b/docs/reference/api/docker_remote_api_v1.3.md new file mode 100644 index 0000000000..1e2b4b3ce4 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.3.md @@ -0,0 +1,1110 @@ + + +# Docker Remote API v1.3 + +# 1. Brief introduction + +- The Remote API is replacing rcli +- Default port in the docker daemon is 2375 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "PID":"11935", + "Tty":"pts/2", + "Time":"00:00:00", + "Cmd":"sh" + }, + { + "PID":"12140", + "Tty":"pts/2", + "Time":"00:00:00", + "Cmd":"sleep" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/centos/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/fedora/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > {{ authConfig }} + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. I + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "EventsListeners":"0", + "LXCVersion":"0.7.5", + "KernelVersion":"3.8.0-19-generic" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","time":1374067924} + {"status":"start","id":"dfdf82bd3881","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + + - Start the container + + - If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + +> docker -d -H="192.168.1.9:2375" -api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.4.md b/docs/reference/api/docker_remote_api_v1.4.md new file mode 100644 index 0000000000..6cedddf12e --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.4.md @@ -0,0 +1,1153 @@ + + +# Docker Remote API v1.4 + +# 1. Brief introduction + +- The Remote API is replacing rcli +- Default port in the docker daemon is 2375 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Privileged": false, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"", + "WorkingDir":"" + + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **409** – conflict between containers and images +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/centos/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict between containers and images +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/fedora/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + {{ authConfig }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} ... + +Status Codes: + +- **200** – no error :statuscode 404: no such image :statuscode + 500: server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. I + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + + - Start the container + + - If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.5.md b/docs/reference/api/docker_remote_api_v1.5.md new file mode 100644 index 0000000000..76c6142c1c --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.5.md @@ -0,0 +1,1159 @@ + + +# Docker Remote API v1.5 + +# 1. Brief introduction + +- The Remote API is replacing rcli +- Default port in the docker daemon is 2375 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Privileged": false, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"", + "WorkingDir":"" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir":"" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles":[ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes":[ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}] + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/centos/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/fedora/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + The `X-Registry-Auth` header can be used to + include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. I + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** – remove intermediate containers after a successful build + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com", + "serveraddress":"https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run`: + + - Create the container + - If the status code is 404, it means the image doesn't exist: + Try to pull it - Then retry to create the container + - Start the container + - If you are not in detached mode: + Attach to the container, using logs=1 (to have stdout and stderr + from the container's start) and stream=1 + - If in detached mode or only stdin is attached: + Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.6.md b/docs/reference/api/docker_remote_api_v1.6.md new file mode 100644 index 0000000000..dd9c6ded9e --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.6.md @@ -0,0 +1,1261 @@ + + +# Docker Remote API v1.6 + +# 1. Brief introduction + + - The Remote API has replaced rcli + - The daemon listens on `unix:///var/run/docker.sock` but you can bind + Docker to another host/port or a Unix socket. + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout, stdin` + and `stderr` + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "ExposedPorts":{}, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{}, + "VolumesFrom":"", + "WorkingDir":"" + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Query Parameters: + +   + +- **name** – container name to use + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + + **More Complex Example request, in 2 steps.** **First, use create to + expose a Private Port, which can be bound back to a Public Port a + startup**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Cmd":[ + "/usr/sbin/sshd","-D" + ], + "Image":"image-with-sshd", + "ExposedPorts":{"22/tcp":{}} + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + **Second, start (using the ID returned above) the image we just + created, mapping the ssh port 22 to something on the host**: + + POST /containers/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }]} + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain; charset=utf-8 + Content-Length: 0 + + **Now you can ssh into your new container on port 11022.** + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "ExposedPorts": {}, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "ContainerIDFile": "", + "Privileged": false, + "PortBindings": {"22/tcp": [{HostIp:"", HostPort:""}]}, + "Links": [], + "PublishAllPorts": false + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +   + +- **signal** – Signal to send to the container (integer). When no + set, SIGKILL is assumed and the call will waits for the + container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](docker_remote_api_v1.9.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/(format)` + +List images `format` could be json or viz (json default) + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"base", + "Tag":"ubuntu-12.10", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"base", + "Tag":"ubuntu-quantal", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + +**Example request**: + + GET /images/viz HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nbase",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\nbase2",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\ntest",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by defaul + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/base/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "ExposedPorts":{}, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/base/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} ... + + > The `X-Registry-Auth` header can be used to + > include a base64-encoded AuthConfig object. + +Status Codes: + +- **200** – no error :statuscode 404: no such image :statuscode + 500: server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com) + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. I + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "ExposedPorts":{"22/tcp":{}} + } + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "base:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "base:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.7.md b/docs/reference/api/docker_remote_api_v1.7.md new file mode 100644 index 0000000000..8a73342667 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.7.md @@ -0,0 +1,1249 @@ + + +# Docker Remote API v1.7 + +# 1. Brief introduction + + - The Remote API has replaced rcli + - The daemon listens on `unix:///var/run/docker.sock` but you can bind + Docker to another host/port or a Unix socket. + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout, stdin` + and `stderr` + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{ + "/tmp": {} + }, + "VolumesFrom":"", + "WorkingDir":"", + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +- **config** – the container's configuration + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "Privileged":false, + "PublishAllPorts":false + } + + Binds need to reference Volumes that were defined during container + creation. + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +- **hostConfig** – the container's host configuration (optional) + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](docker_remote_api_v1.7.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/base/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/base/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Request Headers: + +   + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image + + Request Headers: + +   + +- **Content-type** – should be set to + `"application/tar"`. + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") +- **run** – config automatically applied when the image is run. + (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "base:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "base:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository +specified by `name`. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + :statuscode 200: no error + :statuscode 500: server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. + +**Example request** + + POST /images/load + + Tarball in body + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + + :statuscode 200: no error + :statuscode 500: server error + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + +- Create the container + +- If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + +- If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.8.md b/docs/reference/api/docker_remote_api_v1.8.md new file mode 100644 index 0000000000..62324df8e1 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.8.md @@ -0,0 +1,1325 @@ + + +# Docker Remote API v1.8 + +# 1. Brief introduction + + - The Remote API has replaced rcli + - The daemon listens on `unix:///var/run/docker.sock` but you can bind + Docker to another host/port or a Unix socket. + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout, stdin` + and `stderr` + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "CpuShares":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{ + "/tmp": {} + }, + "VolumesFrom":"", + "WorkingDir":"", + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +   + +- **Hostname** – Container host name +- **User** – Username or UID +- **Memory** – Memory Limit in bytes +- **CpuShares** – CPU shares (relative weight) +- **AttachStdin** – 1/True/true or 0/False/false, attach to + standard input. Default false +- **AttachStdout** – 1/True/true or 0/False/false, attach to + standard output. Default false +- **AttachStderr** – 1/True/true or 0/False/false, attach to + standard error. Default false +- **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. + Default false +- **OpenStdin** – 1/True/true or 0/False/false, keep stdin open + even if not attached. Default false + +Query Parameters: + +   + +- **name** – Assign the specified name to the container. Mus + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": null, + "PublishAllPorts": false + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **Binds** – Create a bind mount to a directory or file with + [host-path]:[container-path]:[rw|ro]. If a directory + "container-path" is missing, then docker creates a new volume. +- **LxcConf** – Map of custom lxc options +- **PortBindings** – Expose ports from the container, optionally + publishing them via the HostPort flag +- **PublishAllPorts** – 1/True/true or 0/False/false, publish all + exposed ports to the host interfaces. Default false +- **Privileged** – 1/True/true or 0/False/false, give extended + privileges to this container. Default false + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` + ](docker_remote_api_v1.9.md#create-a-container), + the stream is the raw data from the process PTY and client's stdin. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List Images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/base/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/base/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + Request Headers: + +   + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name)` + +Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile via stdin + +`POST /build` + +Build an image from Dockerfile via stdin + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#dockerbuilder)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image + + Request Headers: + +   + +- **Content-type** – should be set to + `"application/tar"`. +- **X-Registry-Auth** – base64-encoded AuthConfig objec + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") +- **run** – config automatically applied when the image is run. + (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, +or via polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "base:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "base:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository +specified by `name`. +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run`: + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + - Try to pull it + - Then retry to create the container + + - Start the container + + - If you are not in detached mode: + - Attach to the container, using logs=1 (to have stdout and + stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + - Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS Requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/docker_remote_api_v1.9.md b/docs/reference/api/docker_remote_api_v1.9.md new file mode 100644 index 0000000000..ae18deb4c6 --- /dev/null +++ b/docs/reference/api/docker_remote_api_v1.9.md @@ -0,0 +1,1358 @@ + + +# Docker Remote API v1.9 + +# 1. Brief introduction + + - The Remote API has replaced rcli + - The daemon listens on `unix:///var/run/docker.sock` but you can bind + Docker to another host/port or a Unix socket. + - The API tends to be REST, but for some complex commands, like `attach` + or `pull`, the HTTP connection is hijacked to transport `stdout, stdin` + and `stderr` + +# 2. Endpoints + +## 2.1 Containers + +### List containers + +`GET /containers/json` + +List containers. + +**Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports": [], + "SizeRw": 12288, + "SizeRootFs": 0 + } + ] + +Query Parameters: + +   + +- **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default (i.e., this defaults to false) +- **limit** – Show `limit` last created containers, include non-running ones. +- **since** – Show only containers created since Id, include non-running ones. +- **before** – Show only containers created before Id, include non-running ones. +- **size** – 1/True/true or 0/False/false, Show the containers sizes + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **500** – server error + +### Create a container + +`POST /containers/create` + +Create a container + +**Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "CpuShares":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{ + "/tmp": {} + }, + "VolumesFrom":"", + "WorkingDir":"", + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + +Json Parameters: + +   + +- **Hostname** – Container host name +- **User** – Username or UID +- **Memory** – Memory Limit in bytes +- **CpuShares** – CPU shares (relative weight) +- **AttachStdin** – 1/True/true or 0/False/false, attach to + standard input. Default false +- **AttachStdout** – 1/True/true or 0/False/false, attach to + standard output. Default false +- **AttachStderr** – 1/True/true or 0/False/false, attach to + standard error. Default false +- **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. + Default false +- **OpenStdin** – 1/True/true or 0/False/false, keep stdin open + even if not attached. Default false + +Query Parameters: + +   + +- **name** – Assign the specified name to the container. Mus + match `/?[a-zA-Z0-9_-]+`. + +Status Codes: + +- **201** – no error +- **404** – no such container +- **406** – impossible to attach (container not running) +- **500** – server error + +### Inspect a container + +`GET /containers/(id)/json` + +Return low-level information on the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/docker/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": null, + "PublishAllPorts": false + } + } + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### List processes running inside a container + +`GET /containers/(id)/top` + +List processes running inside the container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles": [ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes": [ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + +Query Parameters: + +- **ps_args** – ps arguments to use (e.g., aux) + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Inspect changes on a container's filesystem + +`GET /containers/(id)/changes` + +Inspect changes on container `id`'s filesystem + +**Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path": "/dev", + "Kind": 0 + }, + { + "Path": "/dev/kmsg", + "Kind": 1 + }, + { + "Path": "/test", + "Kind": 1 + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Export a container + +`GET /containers/(id)/export` + +Export the contents of container `id` + +**Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Start a container + +`POST /containers/(id)/start` + +Start the container `id` + +**Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}], + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false + } + +**Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + +Json Parameters: + +   + +- **Binds** – Create a bind mount to a directory or file with + [host-path]:[container-path]:[rw|ro]. If a directory + "container-path" is missing, then docker creates a new volume. +- **LxcConf** – Map of custom lxc options +- **PortBindings** – Expose ports from the container, optionally + publishing them via the HostPort flag +- **PublishAllPorts** – 1/True/true or 0/False/false, publish all + exposed ports to the host interfaces. Default false +- **Privileged** – 1/True/true or 0/False/false, give extended + privileges to this container. Default false + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Stop a container + +`POST /containers/(id)/stop` + +Stop the container `id` + +**Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 OK + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Restart a container + +`POST /containers/(id)/restart` + +Restart the container `id` + +**Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **t** – number of seconds to wait before killing the container + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Kill a container + +`POST /containers/(id)/kill` + +Kill the container `id` + +**Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters + +- **signal** - Signal to send to the container: integer or string like "SIGINT". + When not set, SIGKILL is assumed and the call will wait for the container to exit. + +Status Codes: + +- **204** – no error +- **404** – no such container +- **500** – server error + +### Attach to a container + +`POST /containers/(id)/attach` + +Attach to the container `id` + +**Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Defaul + false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create`](#create-a-container), the + stream is the raw data from the process PTY and client's stdin. When + the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + +- 0: stdin (will be written on stdout) +- 1: stdout +- 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 bytes + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +### Attach to a container (websocket) + +`GET /containers/(id)/attach/ws` + +Attach to the container `id` via websocket + +Implements websocket protocol handshake according to [RFC 6455](http://tools.ietf.org/html/rfc6455) + +**Example request** + + GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1 + +**Example response** + + {{ STREAM }} + +Query Parameters: + +- **logs** – 1/True/true or 0/False/false, return logs. Default false +- **stream** – 1/True/true or 0/False/false, return stream. + Default false +- **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + +Status Codes: + +- **200** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Wait a container + +`POST /containers/(id)/wait` + +Block until container `id` stops, then returns the exit code + +**Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode": 0} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +### Remove a container + +`DELETE /containers/(id)` + +Remove the container `id` from the filesystem + +**Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + +**Example response**: + + HTTP/1.1 204 No Content + +Query Parameters: + +- **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + +Status Codes: + +- **204** – no error +- **400** – bad parameter +- **404** – no such container +- **500** – server error + +### Copy files or folders from a container + +`POST /containers/(id)/copy` + +Copy files or folders of container `id` + +**Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource": "test.txt" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ TAR STREAM }} + +Status Codes: + +- **200** – no error +- **404** – no such container +- **500** – server error + +## 2.2 Images + +### List images + +`GET /images/json` + +**Example request**: + + GET /images/json?all=0 HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +### Create an image + +`POST /images/create` + +Create an image, either by pull it from the registry or by importing i + +**Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pulling..."} + {"status": "Pulling", "progress": "1 B/ 100 B", "progressDetail": {"current": 1, "total": 100}} + {"error": "Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + +Query Parameters: + +- **fromImage** – name of the image to pull +- **fromSrc** – source to import, - means stdin +- **repo** – repository +- **tag** – tag +- **registry** – the registry to pull from + +Request Headers: + +- **X-Registry-Auth** – base64-encoded AuthConfig object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Insert a file in an image + +`POST /images/(name)/insert` + +Insert a file from `url` in the image `name` at `path` + +**Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} + {"error":"Invalid..."} + ... + +Query Parameters: + +- **url** – The url from where the file is taken +- **path** – The path where the file is stored + +Status Codes: + +- **200** – no error +- **500** – server error + +### Inspect an image + +`GET /images/(name)/json` + +Return low-level information on the image `name` + +**Example request**: + + GET /images/base/json HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"], + "Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Get the history of an image + +`GET /images/(name)/history` + +Return the history of the image `name` + +**Example request**: + + GET /images/base/history HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "b750fe79269d", + "Created": 1364102658, + "CreatedBy": "/bin/bash" + }, + { + "Id": "27cf78414709", + "Created": 1364068391, + "CreatedBy": "" + } + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Push an image on the registry + +`POST /images/(name)/push` + +Push the image `name` on the registry + +**Example request**: + + POST /images/test/push HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "Pushing..."} + {"status": "Pushing", "progress": "1/? (n/a)", "progressDetail": {"current": 1}}} + {"error": "Invalid..."} + ... + + Request Headers: + +   + +- **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + +Status Codes: + +- **200** – no error +- **404** – no such image +- **500** – server error + +### Tag an image into a repository + +`POST /images/(name)/tag` + +Tag the image `name` into a repository + +**Example request**: + + POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1 + +**Example response**: + + HTTP/1.1 201 OK + +Query Parameters: + +- **repo** – The repository to tag in +- **force** – 1/True/true or 0/False/false, default false +- **tag** - The new tag name + +Status Codes: + +- **201** – no error +- **400** – bad parameter +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Remove an image + +`DELETE /images/(name*) +: Remove the image `name` from the filesystem + +**Example request**: + + DELETE /images/test HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged": "3e2f21a89f"}, + {"Deleted": "3e2f21a89f"}, + {"Deleted": "53b4f83ac9"} + ] + +Status Codes: + +- **200** – no error +- **404** – no such image +- **409** – conflict +- **500** – server error + +### Search images + +`GET /images/search` + +Search for an image on [Docker Hub](https://hub.docker.com). + +> **Note**: +> The response keys have changed from API v1.6 to reflect the JSON +> sent by the registry server to the docker daemon's request. + +**Example request**: + + GET /images/search?term=sshd HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + +Query Parameters: + +- **term** – term to search + +Status Codes: + +- **200** – no error +- **500** – server error + +## 2.3 Misc + +### Build an image from Dockerfile + +`POST /build` + +Build an image from Dockerfile using a POST body. + +**Example request**: + + POST /build HTTP/1.1 + + {{ TAR STREAM }} + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream": "Step 1..."} + {"stream": "..."} + {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../reference/builder.md#add)). + +Query Parameters: + +- **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- **remote** – build source URI (git or HTTPS/HTTP) +- **q** – suppress verbose build output +- **nocache** – do not use the cache when building the image +- **rm** – Remove intermediate containers after a successful build + + Request Headers: + +- **Content-type** – should be set to `"application/tar"`. +- **X-Registry-Config** – base64-encoded ConfigFile object + +Status Codes: + +- **200** – no error +- **500** – server error + +### Check auth configuration + +`POST /auth` + +Get the default username and email + +**Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":" hannibal", + "password: "xxxx", + "email": "hannibal@a-team.com", + "serveraddress": "https://index.docker.io/v1/" + } + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + +Status Codes: + +- **200** – no error +- **204** – no error +- **500** – server error + +### Display system-wide information + +`GET /info` + +Display system-wide information + +**Example request**: + + GET /info HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Show the Docker version information + +`GET /version` + +Show the docker version information + +**Example request**: + + GET /version HTTP/1.1 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + +Status Codes: + +- **200** – no error +- **500** – server error + +### Create a new image from a container's changes + +`POST /commit` + +Create a new image from a container's changes + +**Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "DisableNetwork": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + +**Example response**: + + HTTP/1.1 201 Created + Content-Type: application/vnd.docker.raw-stream + + {"Id": "596069db4bf5"} + +Json Parameters: + +- **config** - the container's configuration + +Query Parameters: + +- **container** – source container +- **repo** – repository +- **tag** – tag +- **m** – commit message +- **author** – author (e.g., "John Hannibal Smith + <[hannibal@a-team.com](mailto:hannibal%40a-team.com)>") + +Status Codes: + +- **201** – no error +- **404** – no such container +- **500** – server error + +### Monitor Docker's events + +`GET /events` + +Get events from docker, either in real time via streaming, or via +polling (using since). + +Docker containers will report the following events: + + create, destroy, die, export, kill, pause, restart, start, stop, unpause + +and Docker images will report: + + untag, delete + +**Example request**: + + GET /events?since=1374067924 + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status": "create", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "start", "id": "dfdf82bd3881","from": "base:latest", "time":1374067924} + {"status": "stop", "id": "dfdf82bd3881","from": "base:latest", "time":1374067966} + {"status": "destroy", "id": "dfdf82bd3881","from": "base:latest", "time":1374067970} + +Query Parameters: + +- **since** – timestamp used for polling + +Status Codes: + +- **200** – no error +- **500** – server error + +### Get a tarball containing all images and tags in a repository + +`GET /images/(name)/get` + +Get a tarball containing all images and metadata for the repository specified by `name`. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + GET /images/ubuntu/get + +**Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + +Status Codes: + +- **200** – no error +- **500** – server error + +### Load a tarball with a set of images and tags into docker + +`POST /images/load` + +Load a set of images and tags into the docker repository. + +See the [image tarball format](#image-tarball-format) for more details. + +**Example request** + + POST /images/load + + Tarball in body + +**Example response**: + + HTTP/1.1 200 OK + +Status Codes: + +- **200** – no error +- **500** – server error + +### Image tarball format + +An image tarball contains one directory per image layer (named using its long ID), +each containing three files: + +1. `VERSION`: currently `1.0` - the file format version +2. `json`: detailed layer information, similar to `docker inspect layer_id` +3. `layer.tar`: A tarfile containing the filesystem changes in this layer + +The `layer.tar` file will contain `aufs` style `.wh..wh.aufs` files and directories +for storing attribute changes and deletions. + +If the tarball defines a repository, there will also be a `repositories` file at +the root that contains a list of repository and tag names mapped to layer IDs. + +``` +{"hello-world": + {"latest": "565a9d68a73f6706862bfe8409a7f659776d4d60a8d096eb4a3cbce6999cc2a1"} +} +``` + +# 3. Going further + +## 3.1 Inside `docker run` + +Here are the steps of `docker run` : + + - Create the container + + - If the status code is 404, it means the image doesn't exist: + +- Try to pull it +- Then retry to create the container + + - Start the container + + - If you are not in detached mode: + +- Attach to the container, using logs=1 (to have stdout and +- stderr from the container's start) and stream=1 + + - If in detached mode or only stdin is attached: + +- Display the container's id + +## 3.2 Hijacking + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +## 3.3 CORS requests + +To enable cross origin requests to the remote api add the flag +"--api-enable-cors" when running docker in daemon mode. + + $ docker -d -H="192.168.1.9:2375" --api-enable-cors diff --git a/docs/reference/api/hub_registry_spec.md b/docs/reference/api/hub_registry_spec.md new file mode 100644 index 0000000000..581a01457d --- /dev/null +++ b/docs/reference/api/hub_registry_spec.md @@ -0,0 +1,17 @@ + + +# The Docker Hub and the Registry v1 + +This API is deprecated as of 1.7. To view the old version, see the [go +here](hub_registry_spec.md) in +the 1.7 documentation. If you want an overview of the current features in +Docker Hub or other image management features see the [image management +overview](../../userguide/image_management.md) in the current documentation set. \ No newline at end of file diff --git a/docs/reference/api/images/event_state.gliffy b/docs/reference/api/images/event_state.gliffy new file mode 100644 index 0000000000..fd4cc5e436 --- /dev/null +++ b/docs/reference/api/images/event_state.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":1109,"height":556,"nodeIndex":360,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":true,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":26.46762966848334,"y":100},"max":{"x":1109,"y":555.2340187157677}},"objects":[{"x":373.99998474121094,"y":389.93402099609375,"rotation":0.0,"id":355,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":0,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":191,"py":0.7071067811865475,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":-0.663724900050094,"endArrowRotation":-0.6637248993502937,"interpolationType":"quadratic","cornerRadius":null,"controlPath":[[22.0,-17.0],[94.00000762939453,-17.0],[94.00000762939453,-61.64974974863185],[166.00001525878906,-61.64974974863185]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":359,"width":74.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.5,"linePerpValue":0.0,"cardinalityType":null,"html":"

docker start

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":275.99998474121094,"y":323.93402099609375,"rotation":0.0,"id":344,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":87,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":335,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":193,"py":0.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":105.08369488824782,"endArrowRotation":91.96866662391399,"interpolationType":"quadratic","cornerRadius":null,"controlPath":[[22.531977827253513,30.06597900390625],[22.531977827253513,51.06597900390625],[-52.96697615221987,51.06597900390625],[-52.96697615221987,106.06597900390625]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":347,"width":63.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker rm

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":279.99998474121094,"y":249.93402099609375,"rotation":0.0,"id":342,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":86,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":188,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":191,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-74.99998474121094,0.06597900390625],[297.50001525878906,0.06597900390625],[297.50001525878906,50.06597900390625]],"lockSegments":{},"ortho":true}},"linkMap":[]},{"x":313.99998474121094,"y":290.93402099609375,"rotation":0.0,"id":341,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":84,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":335,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":191,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[19.531977827253513,28.06597900390625],[88.35546419381131,28.06597900390625],[157.17895056036912,28.06597900390625],[226.00243692692698,28.06597900390625]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":353,"width":74.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker start

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":214.99998474121094,"y":322.93402099609375,"rotation":0.0,"id":340,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":83,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":228,"py":0.5733505249023437,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":335,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-7.637919363960094,-3.93402099609375],[11.085379699777775,-3.93402099609375],[29.808678763515644,-3.93402099609375],[48.53197782725351,-3.93402099609375]],"lockSegments":{},"ortho":true}},"linkMap":[]},{"x":83.0,"y":251.0,"rotation":0.0,"id":328,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":79,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":188,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-52.03237033151666,-0.9999999999999716],[47.0,-1.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":332,"width":67.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.5233416311379174,"linePerpValue":null,"cardinalityType":null,"html":"

docker run

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":74.0,"y":318.0,"rotation":0.0,"id":327,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":77,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":228,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-42.0,1.0],[58.5,2.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":333,"width":83.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.5689443767164591,"linePerpValue":null,"cardinalityType":null,"html":"

docker create

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":191.0,"y":409.0,"rotation":0.0,"id":325,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":76,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":193,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":215,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-21.0,41.0],[-61.0,41.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":331.0,"y":346.0,"rotation":0.0,"id":320,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":74,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":209,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":193,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[2.5319625684644507,49.0],[-41.734018715767775,49.0],[-41.734018715767775,104.0],[-86.0,104.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":324,"width":63.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker rm

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":872.0,"y":503.0,"rotation":0.0,"id":310,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":73,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":205,"py":0.0,"px":0.2928932188134524}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-60.03300858899104,-53.0],[-148.0,-151.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":735.0,"y":341.0,"rotation":0.0,"id":307,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":71,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":203,"py":0.2928932188134525,"px":1.1102230246251563E-16}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[0.0,0.0],[137.5,60.7157287525381]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":309,"width":83.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.37922003257116654,"linePerpValue":null,"cardinalityType":null,"html":"

docker pause

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":1023.0,"y":446.0,"rotation":0.0,"id":298,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":69,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":213,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":205,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[39.5,-1.0],[39.5,24.0],[-158.0,24.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":313,"width":101.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.37286693198126664,"linePerpValue":null,"cardinalityType":null,"html":"

 docker unpause

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":904.0,"y":434.0,"rotation":0.0,"id":295,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":68,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":203,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":213,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[43.5,-24.0],[123.5,-24.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":411.0,"y":419.0,"rotation":0.0,"id":291,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":66,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":217,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":209,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[7.2659812842321685,51.0],[-42.46803743153555,51.0],[-42.46803743153555,11.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":292,"width":21.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.4870188236535277,"linePerpValue":null,"cardinalityType":null,"html":"

No

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":415.0,"y":419.0,"rotation":0.0,"id":289,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":64,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":217,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":191,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[53.26598128423217,1.0],[53.26598128423217,-32.5],[162.5,-32.5],[162.5,-79.0]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":290,"width":26.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.46753493572435184,"linePerpValue":null,"cardinalityType":null,"html":"

Yes

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":521.0,"y":209.0,"rotation":0.0,"id":287,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":63,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":195,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":209,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-11.0,-19.0],[-97.23401871576777,-19.0],[-97.23401871576777,186.0],[-117.46803743153555,186.0]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[]},{"x":988.0,"y":232.0,"rotation":0.0,"id":282,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":62,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":201,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[39.5,18.0],[-150.0,18.0],[-150.0,68.0],[-250.0,68.0]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[]},{"x":664.0,"y":493.0,"rotation":0.0,"id":276,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":61,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":207,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":236,"py":0.7071067811865475,"px":0.9999999999999998}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[8.5,42.23401871576766],[-20.25,42.23401871576766],[-20.25,-44.7157287525381],[-49.0,-44.7157287525381]],"lockSegments":{},"ortho":true}},"linkMap":[]},{"x":678.0,"y":344.0,"rotation":0.0,"id":273,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":59,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":236,"py":0.29289321881345237,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":91.17113025781374,"endArrowRotation":176.63803454243802,"interpolationType":"quadratic","cornerRadius":null,"controlPath":[[2.0,-4.0],[2.0,87.7157287525381],[-63.0,87.7157287525381]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":275,"width":57.0,"height":40.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.5,"linePerpValue":0.0,"cardinalityType":null,"html":"

container 

process

exited

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":566.0,"y":431.0,"rotation":0.0,"id":272,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":58,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":236,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":217,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-26.0,9.0],[-36.867009357883944,9.0],[-36.867009357883944,39.0],[-47.73401871576789,39.0]],"lockSegments":{},"ortho":true}},"linkMap":[]},{"x":785.0,"y":119.0,"rotation":0.0,"id":270,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":57,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":199,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":209,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[5.0,1.0],[-416.46803743153555,1.0],[-416.46803743153555,241.0]],"lockSegments":{},"ortho":true}},"linkMap":[]},{"x":829.0,"y":172.0,"rotation":0.0,"id":269,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":56,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":248,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":199,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.5,-2.0],[-1.5,-32.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":661.0,"y":189.0,"rotation":0.0,"id":267,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":55,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":195,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[7.0,2.284271247461902],[-76.0,1.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":946.0,"y":319.0,"rotation":0.0,"id":263,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":53,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":197,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":233,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.5,1.0],[81.5,1.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":708.0,"y":286.0,"rotation":0.0,"id":256,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":51,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":211,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":254,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.5,-2.0],[-0.5,-76.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":258,"width":64.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.3108108108108108,"linePerpValue":null,"cardinalityType":null,"html":"

docker kill

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":710.0,"y":359.0,"rotation":0.0,"id":245,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":43,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":211,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":207,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-2.5,-5.0],[0.0,156.23401871576766]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":247,"width":83.0,"height":27.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 killed by

out-of-memory

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":761.0,"y":318.0,"rotation":0.0,"id":238,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":41,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":211,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":197,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-18.5,1.0],[111.5,2.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":240,"width":85.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":0.4363456059259962,"linePerpValue":null,"cardinalityType":null,"html":"

docker restart

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":608.0,"y":319.0,"rotation":0.0,"id":232,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":36,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":191,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":211,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[7.0,1.0],[64.5,0.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":333.53196256846445,"y":360.0,"rotation":0.0,"id":209,"width":70.0,"height":70.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.connector","order":21,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#e6b8af","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5555555555555554,"y":0.0,"rotation":0.0,"id":210,"width":66.88888888888889,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

stopped

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":540.0,"y":300.0,"rotation":0.0,"id":191,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":192,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

start

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":510.0,"y":170.0,"rotation":0.0,"id":195,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":7,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":196,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

kill

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":872.5,"y":300.0,"rotation":0.0,"id":197,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":198,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

die

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":790.0,"y":100.0,"rotation":0.0,"id":199,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":11,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":200,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

stop

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":790.0,"y":450.0,"rotation":0.0,"id":205,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":17,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":206,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

unpause

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":672.5,"y":515.2340187157677,"rotation":0.0,"id":207,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":19,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":208,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

OOM

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":672.5,"y":284.0,"rotation":0.0,"id":211,"width":70.0,"height":70.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.connector","order":23,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#b6d7a8","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5555555555555556,"y":0.0,"rotation":0.0,"id":212,"width":66.88888888888889,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

running

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":403.5319625684644,"y":420.0,"rotation":0.0,"id":227,"width":130.46803743153555,"height":116.23401871576777,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":33,"lockAspectRatio":false,"lockShape":false,"children":[{"x":-6.765981284232225,"y":76.0,"rotation":45.0,"id":223,"width":80.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":32,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Restart 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[]},{"x":57.234018715767775,"y":75.0,"rotation":315.0,"id":219,"width":80.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Policy

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[]},{"x":14.734018715767775,"y":0.0,"rotation":0.0,"id":217,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.decision","order":29,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.diamond.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":218,"width":96.0,"height":27.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Should restart?

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]}]},{"x":1027.5,"y":375.0,"rotation":0.0,"id":213,"width":70.0,"height":70.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.connector","order":25,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#fce5cd","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5555555555555556,"y":0.0,"rotation":0.0,"id":214,"width":66.88888888888889,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

paused

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":872.5,"y":390.0,"rotation":0.0,"id":203,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":15,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":204,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

pause

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":540.0,"y":420.0,"rotation":0.0,"id":236,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":39,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":237,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

die

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":790.0,"y":170.0,"rotation":0.0,"id":248,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":45,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":249,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

die

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":670.0,"y":170.0,"rotation":0.0,"id":254,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":49,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":255,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

die

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":740.0,"y":323.0,"rotation":0.0,"id":250,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":47,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":248,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-10.0,-33.0],[87.5,-113.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":253,"width":73.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker stop

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":1027.5,"y":300.0,"rotation":0.0,"id":233,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":37,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":234,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

start

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":1027.5,"y":230.0,"rotation":0.0,"id":201,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":13,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":202,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

restart

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":1066.5,"y":298.0,"rotation":0.0,"id":264,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":54,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":233,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":201,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":1,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.5,2.0],[-1.5,-28.0]],"lockSegments":{},"ortho":false}},"linkMap":[]},{"x":132.5,"y":300.0,"rotation":0.0,"id":228,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":34,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":229,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

create

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":130.0,"y":230.0,"rotation":0.0,"id":188,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":1,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":190,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

create

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":263.53196256846445,"y":284.0,"rotation":0.0,"id":335,"width":70.0,"height":70.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.connector","order":81,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5555555555555554,"y":0.0,"rotation":0.0,"id":336,"width":66.88888888888889,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

created

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":60.0,"y":415.0,"rotation":0.0,"id":215,"width":70.0,"height":70.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.connector","order":27,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#b7b7b7","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5555555555555556,"y":0.0,"rotation":0.0,"id":216,"width":66.88888888888889,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

deleted

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]},{"x":170.0,"y":430.0,"rotation":0.0,"id":193,"width":75.0,"height":40.0,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","order":5,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":1.5,"y":0.0,"rotation":0.0,"id":194,"width":72.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

destroy

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}}}]}],"shapeStyles":{"com.gliffy.shape.uml.uml_v2.state_machine":{"fill":"#e2e2e2","stroke":"#000000","strokeWidth":2},"com.gliffy.shape.flowchart.flowchart_v1.default":{"fill":"#a4c2f4","stroke":"#333333","strokeWidth":2}},"lineStyles":{"global":{"endArrow":1,"orthoMode":2}},"textStyles":{"global":{"bold":true,"color":"#000000"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.images"]},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/reference/api/images/event_state.png b/docs/reference/api/images/event_state.png new file mode 100644 index 0000000000000000000000000000000000000000..28d09ba192d05bf5b55dbf4c85a879842a7f4c46 GIT binary patch literal 78354 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 literal 0 HcmV?d00001 diff --git a/docs/reference/api/registry_api.md b/docs/reference/api/registry_api.md new file mode 100644 index 0000000000..9da7cae683 --- /dev/null +++ b/docs/reference/api/registry_api.md @@ -0,0 +1,598 @@ + + +# Docker Registry API v1 + +## Introduction + + - This is the REST API for the Docker Registry 1.0 + - It stores the images and the graph for a set of repositories + - It does not have user accounts data + - It has no notion of user accounts or authorization + - It delegates authentication and authorization to the Index Auth + service using tokens + - It supports different storage backends (S3, cloud files, local FS) + - It doesn't have a local database + - The registry is open source: [Docker Registry](https://github.com/docker/docker-registry) + + We expect that there will be multiple registries out there. To help to +grasp the context, here are some examples of registries: + + - **sponsor registry**: such a registry is provided by a third-party + hosting infrastructure as a convenience for their customers and the + Docker community as a whole. Its costs are supported by the third + party, but the management and operation of the registry are + supported by Docker. It features read/write access, and delegates + authentication and authorization to the Index. + - **mirror registry**: such a registry is provided by a third-party + hosting infrastructure but is targeted at their customers only. Some + mechanism (unspecified to date) ensures that public images are + pulled from a sponsor registry to the mirror registry, to make sure + that the customers of the third-party provider can `docker pull` + those images locally. + - **vendor registry**: such a registry is provided by a software + vendor, who wants to distribute Docker images. It would be operated + and managed by the vendor. Only users authorized by the vendor would + be able to get write access. Some images would be public (accessible + for anyone), others private (accessible only for authorized users). + Authentication and authorization would be delegated to the Index. + The goal of vendor registries is to let someone do `docker pull + basho/riak1.3` and automatically push from the vendor registry + (instead of a sponsor registry); i.e., get all the convenience of a + sponsor registry, while retaining control on the asset distribution. + - **private registry**: such a registry is located behind a firewall, + or protected by an additional security layer (HTTP authorization, + SSL client-side certificates, IP address authorization...). The + registry is operated by a private entity, outside of Docker's + control. It can optionally delegate additional authorization to the + Index, but it is not mandatory. + +> **Note**: +> Mirror registries and private registries which do not use the Index +> don't even need to run the registry code. They can be implemented by any +> kind of transport implementing HTTP GET and PUT. Read-only registries +> can be powered by a simple static HTTPS server. + +> **Note**: +> The latter implies that while HTTP is the protocol of choice for a registry, +> multiple schemes are possible (and in some cases, trivial): +> +> - HTTP with GET (and PUT for read-write registries); +> - local mount point; +> - remote Docker addressed through SSH. + +The latter would only require two new commands in Docker, e.g., +`registryget` and `registryput`, wrapping access to the local filesystem +(and optionally doing consistency checks). Authentication and authorization +are then delegated to SSH (e.g., with public keys). + +> **Note**: +> Private registry servers that expose an HTTP endpoint need to be secured with +> TLS (preferably TLSv1.2, but at least TLSv1.0). Make sure to put the CA +> certificate at /etc/docker/certs.d/my.registry.com:5000/ca.crt on the Docker +> host, so that the daemon can securely access the private registry. +> Support for SSLv3 and lower is not available due to security issues. + +The default namespace for a private repository is `library`. + +# Endpoints + +## Images + +### Get image layer + +`GET /v1/images/(image_id)/layer` + +Get image layer for a given `image_id` + +**Example Request**: + + GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/layer HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Token signature=123abc,repository="foo/bar",access=read + +Parameters: + +- **image_id** – the id for the layer you want to get + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + X-Docker-Registry-Version: 0.6.0 + Cookie: (Cookie provided by the Registry) + + {layer binary data stream} + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Image not found + +### Put image layer + +`PUT /v1/images/(image_id)/layer` + +Put image layer for a given `image_id` + +**Example Request**: + + PUT /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/layer HTTP/1.1 + Host: registry-1.docker.io + Transfer-Encoding: chunked + Authorization: Token signature=123abc,repository="foo/bar",access=write + + {layer binary data stream} + +Parameters: + +- **image_id** – the id for the layer you want to get + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Image not found + +## Image + +### Put image layer + +`PUT /v1/images/(image_id)/json` + +Put image for a given `image_id` + +**Example Request**: + + PUT /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/json HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + { + id: "088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c", + parent: "aeee6396d62273d180a49c96c62e45438d87c7da4a5cf5d2be6bee4e21bc226f", + created: "2013-04-30T17:46:10.843673+03:00", + container: "8305672a76cc5e3d168f97221106ced35a76ec7ddbb03209b0f0d96bf74f6ef7", + container_config: { + Hostname: "host-test", + User: "", + Memory: 0, + MemorySwap: 0, + AttachStdin: false, + AttachStdout: false, + AttachStderr: false, + Tty: false, + OpenStdin: false, + StdinOnce: false, + Env: null, + Cmd: [ + "/bin/bash", + "-c", + "apt-get -q -yy -f install libevent-dev" + ], + Dns: null, + Image: "imagename/blah", + Volumes: { }, + VolumesFrom: "" + }, + docker_version: "0.1.7" + } + +Parameters: + +- **image_id** – the id for the layer you want to get + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + +Status Codes: + +- **200** – OK +- **401** – Requires authorization + +### Get image layer + +`GET /v1/images/(image_id)/json` + +Get image for a given `image_id` + +**Example Request**: + + GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/json HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + +Parameters: + +- **image_id** – the id for the layer you want to get + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + X-Docker-Size: 456789 + X-Docker-Checksum: b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087 + + { + id: "088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c", + parent: "aeee6396d62273d180a49c96c62e45438d87c7da4a5cf5d2be6bee4e21bc226f", + created: "2013-04-30T17:46:10.843673+03:00", + container: "8305672a76cc5e3d168f97221106ced35a76ec7ddbb03209b0f0d96bf74f6ef7", + container_config: { + Hostname: "host-test", + User: "", + Memory: 0, + MemorySwap: 0, + AttachStdin: false, + AttachStdout: false, + AttachStderr: false, + Tty: false, + OpenStdin: false, + StdinOnce: false, + Env: null, + Cmd: [ + "/bin/bash", + "-c", + "apt-get -q -yy -f install libevent-dev" + ], + Dns: null, + Image: "imagename/blah", + Volumes: { }, + VolumesFrom: "" + }, + docker_version: "0.1.7" + } + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Image not found + +## Ancestry + +### Get image ancestry + +`GET /v1/images/(image_id)/ancestry` + +Get ancestry for an image given an `image_id` + +**Example Request**: + + GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/ancestry HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + +Parameters: + +- **image_id** – the id for the layer you want to get + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + ["088b4502f51920fbd9b7c503e87c7a2c05aa3adc3d35e79c031fa126b403200f", + "aeee63968d87c7da4a5cf5d2be6bee4e21bc226fd62273d180a49c96c62e4543", + "bfa4c5326bc764280b0863b46a4b20d940bc1897ef9c1dfec060604bdc383280", + "6ab5893c6927c15a15665191f2c6cf751f5056d8b95ceee32e43c5e8a3648544"] + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Image not found + +## Tags + +### List repository tags + +`GET /v1/repositories/(namespace)/(repository)/tags` + +Get all of the tags for the given repo. + +**Example Request**: + + GET /v1/repositories/reynholm/help-system-server/tags HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + Cookie: (Cookie provided by the Registry) + +Parameters: + +- **namespace** – namespace for the repo +- **repository** – name for the repo + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + { + "latest": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + "0.1.1": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087" + } + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Repository not found + +### Get image id for a particular tag + +`GET /v1/repositories/(namespace)/(repository)/tags/(tag*)` + +Get a tag for the given repo. + +**Example Request**: + + GET /v1/repositories/reynholm/help-system-server/tags/latest HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + Cookie: (Cookie provided by the Registry) + +Parameters: + +- **namespace** – namespace for the repo +- **repository** – name for the repo +- **tag** – name of tag you want to get + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Tag not found + +### Delete a repository tag + +`DELETE /v1/repositories/(namespace)/(repository)/tags/(tag*)` + +Delete the tag for the repo + +**Example Request**: + + DELETE /v1/repositories/reynholm/help-system-server/tags/latest HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + +Parameters: + +- **namespace** – namespace for the repo +- **repository** – name for the repo +- **tag** – name of tag you want to delete + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Tag not found + +### Set a tag for a specified image id + +`PUT /v1/repositories/(namespace)/(repository)/tags/(tag*)` + +Put a tag for the given repo. + +**Example Request**: + + PUT /v1/repositories/reynholm/help-system-server/tags/latest HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" + +Parameters: + +- **namespace** – namespace for the repo +- **repository** – name for the repo +- **tag** – name of tag you want to add + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + +Status Codes: + +- **200** – OK +- **400** – Invalid data +- **401** – Requires authorization +- **404** – Image not found + +## Repositories + +### Delete a repository + +`DELETE /v1/repositories/(namespace)/(repository)/` + +Delete a repository + +**Example Request**: + + DELETE /v1/repositories/reynholm/help-system-server/ HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + "" + +Parameters: + +- **namespace** – namespace for the repo +- **repository** – name for the repo + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + +Status Codes: + +- **200** – OK +- **401** – Requires authorization +- **404** – Repository not found + +## Search + +If you need to search the index, this is the endpoint you would use. + +`GET /v1/search` + +Search the Index given a search term. It accepts + + [GET](http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.3) + only. + +**Example request**: + + GET /v1/search?q=search_term&page=1&n=25 HTTP/1.1 + Host: index.docker.io + Accept: application/json + +Query Parameters: + +- **q** – what you want to search for +- **n** - number of results you want returned per page (default: 25, min:1, max:100) +- **page** - page number of results + +**Example response**: + + HTTP/1.1 200 OK + Vary: Accept + Content-Type: application/json + + {"num_pages": 1, + "num_results": 3, + "results" : [ + {"name": "ubuntu", "description": "An ubuntu image..."}, + {"name": "centos", "description": "A centos image..."}, + {"name": "fedora", "description": "A fedora image..."} + ], + "page_size": 25, + "query":"search_term", + "page": 1 + } + +Response Items: +- **num_pages** - Total number of pages returned by query +- **num_results** - Total number of results returned by query +- **results** - List of results for the current page +- **page_size** - How many results returned per page +- **query** - Your search term +- **page** - Current page number + +Status Codes: + +- **200** – no error +- **500** – server error + +## Status + +### Status check for registry + +`GET /v1/_ping` + +Check status of the registry. This endpoint is also used to +determine if the registry supports SSL. + +**Example Request**: + + GET /v1/_ping HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + + "" + +**Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + +Status Codes: + +- **200** – OK + +## Authorization + +This is where we describe the authorization process, including the +tokens and cookies. + diff --git a/docs/reference/api/registry_api_client_libraries.md b/docs/reference/api/registry_api_client_libraries.md new file mode 100644 index 0000000000..f5d5b3e515 --- /dev/null +++ b/docs/reference/api/registry_api_client_libraries.md @@ -0,0 +1,49 @@ + + +# Docker Registry v1 API client libraries + +These libraries have not been tested by the Docker maintainers for +compatibility. Please file issues with the library owners. If you find +more library implementations, please submit a PR with an update to this page +or open an issue in the [Docker](https://github.com/docker/docker/issues) +project and we will add the libraries here. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Language/FrameworkNameRepositoryStatus
JavaScript (AngularJS) WebUIdocker-registry-frontendhttps://github.com/kwk/docker-registry-frontendActive
Godocker-reg-clienthttps://github.com/CenturyLinkLabs/docker-reg-clientActive
diff --git a/docs/reference/api/remote_api_client_libraries.md b/docs/reference/api/remote_api_client_libraries.md new file mode 100644 index 0000000000..4f6b9853b9 --- /dev/null +++ b/docs/reference/api/remote_api_client_libraries.md @@ -0,0 +1,212 @@ + + +# Docker Remote API client libraries + +These libraries have not been tested by the Docker maintainers for +compatibility. Please file issues with the library owners. If you find +more library implementations, please list them in Docker doc bugs and we +will add the libraries here. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Language/FrameworkNameRepositoryStatus
C#Docker.DotNethttps://github.com/ahmetalpbalkan/Docker.DotNetActive
C++lasote/docker_clienthttp://www.biicode.com/lasote/docker_client (Biicode C++ dependency manager)Active
Erlangerldockerhttps://github.com/proger/erldockerActive
Dartbwu_dockerhttps://github.com/bwu-dart/bwu_dockerActive
Gogo-dockerclienthttps://github.com/fsouza/go-dockerclientActive
Godockerclienthttps://github.com/samalba/dockerclientActive
Gradlegradle-docker-pluginhttps://github.com/gesellix/gradle-docker-pluginActive
Groovydocker-clienthttps://github.com/gesellix/docker-clientActive
Haskelldocker-hshttps://github.com/denibertovic/docker-hsActive
HTML (Web Components)docker-elementshttps://github.com/kapalhq/docker-elementsActive
Javadocker-javahttps://github.com/docker-java/docker-javaActive
Javadocker-clienthttps://github.com/spotify/docker-clientActive
Javajclouds-dockerhttps://github.com/jclouds/jclouds-labs/tree/master/dockerActive
JavaScript (NodeJS)dockerodehttps://github.com/apocas/dockerode + Install via NPM: npm install dockerodeActive
JavaScript (NodeJS)docker.iohttps://github.com/appersonlabs/docker.io + Install via NPM: npm install docker.ioActive
JavaScriptdocker-jshttps://github.com/dgoujard/docker-jsOutdated
JavaScript (Angular) WebUIdocker-cphttps://github.com/13W/docker-cpActive
JavaScript (Angular) WebUIdockeruihttps://github.com/crosbymichael/dockeruiActive
JavaScript (Angular) WebUIdockeryhttps://github.com/lexandro/dockeryActive
PerlNet::Dockerhttps://metacpan.org/pod/Net::DockerActive
PerlEixo::Dockerhttps://github.com/alambike/eixo-dockerActive
PHPAlvinehttp://pear.alvine.io/ (alpha)Active
PHPDocker-PHPhttp://stage1.github.io/docker-php/Active
Pythondocker-pyhttps://github.com/docker/docker-pyActive
Rubydocker-apihttps://github.com/swipely/docker-apiActive
Rubydocker-clienthttps://github.com/geku/docker-clientOutdated
Rustdocker-rusthttps://github.com/abh1nav/docker-rustActive
Scalatugboathttps://github.com/softprops/tugboatActive
Scalareactive-dockerhttps://github.com/almoehi/reactive-dockerActive
+ diff --git a/docs/reference/builder.md b/docs/reference/builder.md new file mode 100644 index 0000000000..27fd822b9d --- /dev/null +++ b/docs/reference/builder.md @@ -0,0 +1,1245 @@ + + +# Dockerfile reference + +Docker can build images automatically by reading the instructions from a +`Dockerfile`. A `Dockerfile` is a text document that contains all the commands a +user could call on the command line to assemble an image. Using `docker build` +users can create an automated build that executes several command-line +instructions in succession. + +This page describes the commands you can use in a `Dockerfile`. When you are +done reading this page, refer to the [`Dockerfile` Best +Practices](../articles/dockerfile_best-practices.md) for a tip-oriented guide. + +## Usage + +The [`docker build`](commandline/build.md) command builds an image from +a `Dockerfile` and a *context*. The build's context is the files at a specified +location `PATH` or `URL`. The `PATH` is a directory on your local filesystem. +The `URL` is a the location of a Git repository. + +A context is processed recursively. So, a `PATH` includes any subdirectories and +the `URL` includes the repository and its submodules. A simple build command +that uses the current directory as context: + + $ docker build . + Sending build context to Docker daemon 6.51 MB + ... + +The build is run by the Docker daemon, not by the CLI. The first thing a build +process does is send the entire context (recursively) to the daemon. In most +cases, it's best to start with an empty directory as context and keep your +Dockerfile in that directory. Add only the files needed for building the +Dockerfile. + +>**Warning**: Do not use your root directory, `/`, as the `PATH` as it causes +>the build to transfer the entire contents of your hard drive to the Docker +>daemon. + +To use a file in the build context, the `Dockerfile` refers to the file specified +in an instruction, for example, a `COPY` instruction. To increase the build's +performance, exclude files and directories by adding a `.dockerignore` file to +the context directory. For information about how to [create a `.dockerignore` +file](#dockerignore-file) see the documentation on this page. + +Traditionally, the `Dockerfile` is called `Dockerfile` and located in the root +of the context. You use the `-f` flag with `docker build` to point to a Dockerfile +anywhere in your file system. + + $ docker build -f /path/to/a/Dockerfile . + +You can specify a repository and tag at which to save the new image if +the build succeeds: + + $ docker build -t shykes/myapp . + +The Docker daemon runs the instructions in the `Dockerfile` one-by-one, +committing the result of each instruction +to a new image if necessary, before finally outputting the ID of your +new image. The Docker daemon will automatically clean up the context you +sent. + +Note that each instruction is run independently, and causes a new image +to be created - so `RUN cd /tmp` will not have any effect on the next +instructions. + +Whenever possible, Docker will re-use the intermediate images (cache), +to accelerate the `docker build` process significantly. This is indicated by +the `Using cache` message in the console output. +(For more information, see the [Build cache section](../articles/dockerfile_best-practices.md#build-cache)) in the +`Dockerfile` best practices guide: + + $ docker build -t svendowideit/ambassador . + Sending build context to Docker daemon 15.36 kB + Step 0 : FROM alpine:3.2 + ---> 31f630c65071 + Step 1 : MAINTAINER SvenDowideit@home.org.au + ---> Using cache + ---> 2a1c91448f5f + Step 2 : RUN apk update && apk add socat && rm -r /var/cache/ + ---> Using cache + ---> 21ed6e7fbb73 + Step 3 : CMD env | grep _TCP= | sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat -t 100000000 TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \& wait/' | sh + ---> Using cache + ---> 7ea8aef582cc + Successfully built 7ea8aef582cc + +When you're done with your build, you're ready to look into [*Pushing a +repository to its registry*](../userguide/dockerrepos.md#contributing-to-docker-hub). + +## Format + +Here is the format of the `Dockerfile`: + + # Comment + INSTRUCTION arguments + +The instruction is not case-sensitive, however convention is for them to +be UPPERCASE in order to distinguish them from arguments more easily. + +Docker runs the instructions in a `Dockerfile` in order. **The +first instruction must be \`FROM\`** in order to specify the [*Base +Image*](glossary.md#base-image) from which you are building. + +Docker will treat lines that *begin* with `#` as a +comment. A `#` marker anywhere else in the line will +be treated as an argument. This allows statements like: + + # Comment + RUN echo 'we are running some # of cool things' + +Here is the set of instructions you can use in a `Dockerfile` for building +images. + +### Environment replacement + +Environment variables (declared with [the `ENV` statement](#env)) can also be +used in certain instructions as variables to be interpreted by the +`Dockerfile`. Escapes are also handled for including variable-like syntax +into a statement literally. + +Environment variables are notated in the `Dockerfile` either with +`$variable_name` or `${variable_name}`. They are treated equivalently and the +brace syntax is typically used to address issues with variable names with no +whitespace, like `${foo}_bar`. + +The `${variable_name}` syntax also supports a few of the standard `bash` +modifiers as specified below: + +* `${variable:-word}` indicates that if `variable` is set then the result + will be that value. If `variable` is not set then `word` will be the result. +* `${variable:+word}` indicates that if `variable` is set then `word` will be + the result, otherwise the result is the empty string. + +In all cases, `word` can be any string, including additional environment +variables. + +Escaping is possible by adding a `\` before the variable: `\$foo` or `\${foo}`, +for example, will translate to `$foo` and `${foo}` literals respectively. + +Example (parsed representation is displayed after the `#`): + + FROM busybox + ENV foo /bar + WORKDIR ${foo} # WORKDIR /bar + ADD . $foo # ADD . /bar + COPY \$foo /quux # COPY $foo /quux + +Environment variables are supported by the following list of instructions in +the `Dockerfile`: + +* `ADD` +* `COPY` +* `ENV` +* `EXPOSE` +* `LABEL` +* `USER` +* `WORKDIR` +* `VOLUME` +* `STOPSIGNAL` + +as well as: + +* `ONBUILD` (when combined with one of the supported instructions above) + +> **Note**: +> prior to 1.4, `ONBUILD` instructions did **NOT** support environment +> variable, even when combined with any of the instructions listed above. + +Environment variable substitution will use the same value for each variable +throughout the entire command. In other words, in this example: + + ENV abc=hello + ENV abc=bye def=$abc + ENV ghi=$abc + +will result in `def` having a value of `hello`, not `bye`. However, +`ghi` will have a value of `bye` because it is not part of the same command +that set `abc` to `bye`. + +### .dockerignore file + +Before the docker CLI sends the context to the docker daemon, it looks +for a file named `.dockerignore` in the root directory of the context. +If this file exists, the CLI modifies the context to exclude files and +directories that match patterns in it. This helps to avoid +unnecessarily sending large or sensitive files and directories to the +daemon and potentially adding them to images using `ADD` or `COPY`. + +The CLI interprets the `.dockerignore` file as a newline-separated +list of patterns similar to the file globs of Unix shells. For the +purposes of matching, the root of the context is considered to be both +the working and the root directory. For example, the patterns +`/foo/bar` and `foo/bar` both exclude a file or directory named `bar` +in the `foo` subdirectory of `PATH` or in the root of the git +repository located at `URL`. Neither excludes anything else. + +Here is an example `.dockerignore` file: + +``` + */temp* + */*/temp* + temp? +``` + +This file causes the following build behavior: + +| Rule | Behavior | +|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `*/temp*` | Exclude files and directories whose names start with `temp` in any immediate subdirectory of the root. For example, the plain file `/somedir/temporary.txt` is excluded, as is the directory `/somedir/temp`. | +| `*/*/temp*` | Exclude files and directories starting with `temp` from any subdirectory that is two levels below the root. For example, `/somedir/subdir/temporary.txt` is excluded. | +| `temp?` | Exclude files and directories in the root directory whose names are a one-character extension of `temp`. For example, `/tempa` and `/tempb` are excluded. + + +Matching is done using Go's +[filepath.Match](http://golang.org/pkg/path/filepath#Match) rules. A +preprocessing step removes leading and trailing whitespace and +eliminates `.` and `..` elements using Go's +[filepath.Clean](http://golang.org/pkg/path/filepath/#Clean). Lines +that are blank after preprocessing are ignored. + +Lines starting with `!` (exclamation mark) can be used to make exceptions +to exclusions. The following is an example `.dockerignore` file that +uses this mechanism: + +``` + *.md + !README.md +``` + +All markdown files *except* `README.md` are excluded from the context. + +The placement of `!` exception rules influences the behavior: the last +line of the `.dockerignore` that matches a particular file determines +whether it is included or excluded. Consider the following example: + +``` + *.md + !README*.md + README-secret.md +``` + +No markdown files are included in the context except README files other than +`README-secret.md`. + +Now consider this example: + +``` + *.md + README-secret.md + !README*.md +``` + +All of the README files are included. The middle line has no effect because +`!README*.md` matches `README-secret.md` and comes last. + +You can even use the `.dockerignore` file to exclude the `Dockerfile` +and `.dockerignore` files. These files are still sent to the daemon +because it needs them to do its job. But the `ADD` and `COPY` commands +do not copy them to the the image. + +Finally, you may want to specify which files to include in the +context, rather than which to exclude. To achieve this, specify `*` as +the first pattern, followed by one or more `!` exception patterns. + +**Note**: For historical reasons, the pattern `.` is ignored. + +## FROM + + FROM + +Or + + FROM : + +Or + + FROM @ + +The `FROM` instruction sets the [*Base Image*](glossary.md#base-image) +for subsequent instructions. As such, a valid `Dockerfile` must have `FROM` as +its first instruction. The image can be any valid image – it is especially easy +to start by **pulling an image** from the [*Public Repositories*](../userguide/dockerrepos.md). + +- `FROM` must be the first non-comment instruction in the `Dockerfile`. + +- `FROM` can appear multiple times within a single `Dockerfile` in order to create +multiple images. Simply make a note of the last image ID output by the commit +before each new `FROM` command. + +- The `tag` or `digest` values are optional. If you omit either of them, the builder +assumes a `latest` by default. The builder returns an error if it cannot match +the `tag` value. + +## MAINTAINER + + MAINTAINER + +The `MAINTAINER` instruction allows you to set the *Author* field of the +generated images. + +## RUN + +RUN has 2 forms: + +- `RUN ` (*shell* form, the command is run in a shell - `/bin/sh -c`) +- `RUN ["executable", "param1", "param2"]` (*exec* form) + +The `RUN` instruction will execute any commands in a new layer on top of the +current image and commit the results. The resulting committed image will be +used for the next step in the `Dockerfile`. + +Layering `RUN` instructions and generating commits conforms to the core +concepts of Docker where commits are cheap and containers can be created from +any point in an image's history, much like source control. + +The *exec* form makes it possible to avoid shell string munging, and to `RUN` +commands using a base image that does not contain `/bin/sh`. + +In the *shell* form you can use a `\` (backslash) to continue a single +RUN instruction onto the next line. For example, consider these two lines: +``` +RUN /bin/bash -c 'source $HOME/.bashrc ;\ +echo $HOME' +``` +Together they are equivalent to this single line: +``` +RUN /bin/bash -c 'source $HOME/.bashrc ; echo $HOME' +``` + +> **Note**: +> To use a different shell, other than '/bin/sh', use the *exec* form +> passing in the desired shell. For example, +> `RUN ["/bin/bash", "-c", "echo hello"]` + +> **Note**: +> The *exec* form is parsed as a JSON array, which means that +> you must use double-quotes (") around words not single-quotes ('). + +> **Note**: +> Unlike the *shell* form, the *exec* form does not invoke a command shell. +> This means that normal shell processing does not happen. For example, +> `RUN [ "echo", "$HOME" ]` will not do variable substitution on `$HOME`. +> If you want shell processing then either use the *shell* form or execute +> a shell directly, for example: `RUN [ "sh", "-c", "echo", "$HOME" ]`. + +The cache for `RUN` instructions isn't invalidated automatically during +the next build. The cache for an instruction like +`RUN apt-get dist-upgrade -y` will be reused during the next build. The +cache for `RUN` instructions can be invalidated by using the `--no-cache` +flag, for example `docker build --no-cache`. + +See the [`Dockerfile` Best Practices +guide](../articles/dockerfile_best-practices.md#build-cache) for more information. + +The cache for `RUN` instructions can be invalidated by `ADD` instructions. See +[below](#add) for details. + +### Known issues (RUN) + +- [Issue 783](https://github.com/docker/docker/issues/783) is about file + permissions problems that can occur when using the AUFS file system. You + might notice it during an attempt to `rm` a file, for example. + + For systems that have recent aufs version (i.e., `dirperm1` mount option can + be set), docker will attempt to fix the issue automatically by mounting + the layers with `dirperm1` option. More details on `dirperm1` option can be + found at [`aufs` man page](http://aufs.sourceforge.net/aufs3/man.html) + + If your system doesn't have support for `dirperm1`, the issue describes a workaround. + +## CMD + +The `CMD` instruction has three forms: + +- `CMD ["executable","param1","param2"]` (*exec* form, this is the preferred form) +- `CMD ["param1","param2"]` (as *default parameters to ENTRYPOINT*) +- `CMD command param1 param2` (*shell* form) + +There can only be one `CMD` instruction in a `Dockerfile`. If you list more than one `CMD` +then only the last `CMD` will take effect. + +**The main purpose of a `CMD` is to provide defaults for an executing +container.** These defaults can include an executable, or they can omit +the executable, in which case you must specify an `ENTRYPOINT` +instruction as well. + +> **Note**: +> If `CMD` is used to provide default arguments for the `ENTRYPOINT` +> instruction, both the `CMD` and `ENTRYPOINT` instructions should be specified +> with the JSON array format. + +> **Note**: +> The *exec* form is parsed as a JSON array, which means that +> you must use double-quotes (") around words not single-quotes ('). + +> **Note**: +> Unlike the *shell* form, the *exec* form does not invoke a command shell. +> This means that normal shell processing does not happen. For example, +> `CMD [ "echo", "$HOME" ]` will not do variable substitution on `$HOME`. +> If you want shell processing then either use the *shell* form or execute +> a shell directly, for example: `CMD [ "sh", "-c", "echo", "$HOME" ]`. + +When used in the shell or exec formats, the `CMD` instruction sets the command +to be executed when running the image. + +If you use the *shell* form of the `CMD`, then the `` will execute in +`/bin/sh -c`: + + FROM ubuntu + CMD echo "This is a test." | wc - + +If you want to **run your** `` **without a shell** then you must +express the command as a JSON array and give the full path to the executable. +**This array form is the preferred format of `CMD`.** Any additional parameters +must be individually expressed as strings in the array: + + FROM ubuntu + CMD ["/usr/bin/wc","--help"] + +If you would like your container to run the same executable every time, then +you should consider using `ENTRYPOINT` in combination with `CMD`. See +[*ENTRYPOINT*](#entrypoint). + +If the user specifies arguments to `docker run` then they will override the +default specified in `CMD`. + +> **Note**: +> don't confuse `RUN` with `CMD`. `RUN` actually runs a command and commits +> the result; `CMD` does not execute anything at build time, but specifies +> the intended command for the image. + +## LABEL + + LABEL = = = ... + +The `LABEL` instruction adds metadata to an image. A `LABEL` is a +key-value pair. To include spaces within a `LABEL` value, use quotes and +backslashes as you would in command-line parsing. A few usage examples: + + LABEL "com.example.vendor"="ACME Incorporated" + LABEL com.example.label-with-value="foo" + LABEL version="1.0" + LABEL description="This text illustrates \ + that label-values can span multiple lines." + +An image can have more than one label. To specify multiple labels, +Docker recommends combining labels into a single `LABEL` instruction where +possible. Each `LABEL` instruction produces a new layer which can result in an +inefficient image if you use many labels. This example results in a single image +layer. + + LABEL multi.label1="value1" multi.label2="value2" other="value3" + +The above can also be written as: + + LABEL multi.label1="value1" \ + multi.label2="value2" \ + other="value3" + +Labels are additive including `LABEL`s in `FROM` images. If Docker +encounters a label/key that already exists, the new value overrides any previous +labels with identical keys. + +To view an image's labels, use the `docker inspect` command. + + "Labels": { + "com.example.vendor": "ACME Incorporated" + "com.example.label-with-value": "foo", + "version": "1.0", + "description": "This text illustrates that label-values can span multiple lines.", + "multi.label1": "value1", + "multi.label2": "value2", + "other": "value3" + }, + +## EXPOSE + + EXPOSE [...] + +The `EXPOSE` instruction informs Docker that the container listens on the +specified network ports at runtime. `EXPOSE` does not make the ports of the +container accessible to the host. To do that, you must use either the `-p` flag +to publish a range of ports or the `-P` flag to publish all of the exposed +ports. You can expose one port number and publish it externally under another +number. + +To set up port redirection on the host system, see [using the -P +flag](run.md#expose-incoming-ports). The Docker network feature supports +creating networks without the need to expose ports within the network, for +detailed information see the [overview of this +feature](../userguide/networking/index.md)). + +## ENV + + ENV + ENV = ... + +The `ENV` instruction sets the environment variable `` to the value +``. This value will be in the environment of all "descendent" +`Dockerfile` commands and can be [replaced inline](#environment-replacement) in +many as well. + +The `ENV` instruction has two forms. The first form, `ENV `, +will set a single variable to a value. The entire string after the first +space will be treated as the `` - including characters such as +spaces and quotes. + +The second form, `ENV = ...`, allows for multiple variables to +be set at one time. Notice that the second form uses the equals sign (=) +in the syntax, while the first form does not. Like command line parsing, +quotes and backslashes can be used to include spaces within values. + +For example: + + ENV myName="John Doe" myDog=Rex\ The\ Dog \ + myCat=fluffy + +and + + ENV myName John Doe + ENV myDog Rex The Dog + ENV myCat fluffy + +will yield the same net results in the final container, but the first form +is preferred because it produces a single cache layer. + +The environment variables set using `ENV` will persist when a container is run +from the resulting image. You can view the values using `docker inspect`, and +change them using `docker run --env =`. + +> **Note**: +> Environment persistence can cause unexpected side effects. For example, +> setting `ENV DEBIAN_FRONTEND noninteractive` may confuse apt-get +> users on a Debian-based image. To set a value for a single command, use +> `RUN = `. + +## ADD + +ADD has two forms: + +- `ADD ... ` +- `ADD ["",... ""]` (this form is required for paths containing +whitespace) + +The `ADD` instruction copies new files, directories or remote file URLs from `` +and adds them to the filesystem of the container at the path ``. + +Multiple `` resource may be specified but if they are files or +directories then they must be relative to the source directory that is +being built (the context of the build). + +Each `` may contain wildcards and matching will be done using Go's +[filepath.Match](http://golang.org/pkg/path/filepath#Match) rules. For example: + + ADD hom* /mydir/ # adds all files starting with "hom" + ADD hom?.txt /mydir/ # ? is replaced with any single character, e.g., "home.txt" + +The `` is an absolute path, or a path relative to `WORKDIR`, into which +the source will be copied inside the destination container. + + ADD test relativeDir/ # adds "test" to `WORKDIR`/relativeDir/ + ADD test /absoluteDir # adds "test" to /absoluteDir + +All new files and directories are created with a UID and GID of 0. + +In the case where `` is a remote file URL, the destination will +have permissions of 600. If the remote file being retrieved has an HTTP +`Last-Modified` header, the timestamp from that header will be used +to set the `mtime` on the destination file. However, like any other file +processed during an `ADD`, `mtime` will not be included in the determination +of whether or not the file has changed and the cache should be updated. + +> **Note**: +> If you build by passing a `Dockerfile` through STDIN (`docker +> build - < somefile`), there is no build context, so the `Dockerfile` +> can only contain a URL based `ADD` instruction. You can also pass a +> compressed archive through STDIN: (`docker build - < archive.tar.gz`), +> the `Dockerfile` at the root of the archive and the rest of the +> archive will get used at the context of the build. + +> **Note**: +> If your URL files are protected using authentication, you +> will need to use `RUN wget`, `RUN curl` or use another tool from +> within the container as the `ADD` instruction does not support +> authentication. + +> **Note**: +> The first encountered `ADD` instruction will invalidate the cache for all +> following instructions from the Dockerfile if the contents of `` have +> changed. This includes invalidating the cache for `RUN` instructions. +> See the [`Dockerfile` Best Practices +guide](../articles/dockerfile_best-practices.md#build-cache) for more information. + + +`ADD` obeys the following rules: + +- The `` path must be inside the *context* of the build; + you cannot `ADD ../something /something`, because the first step of a + `docker build` is to send the context directory (and subdirectories) to the + docker daemon. + +- If `` is a URL and `` does not end with a trailing slash, then a + file is downloaded from the URL and copied to ``. + +- If `` is a URL and `` does end with a trailing slash, then the + filename is inferred from the URL and the file is downloaded to + `/`. For instance, `ADD http://example.com/foobar /` would + create the file `/foobar`. The URL must have a nontrivial path so that an + appropriate filename can be discovered in this case (`http://example.com` + will not work). + +- If `` is a directory, the entire contents of the directory are copied, + including filesystem metadata. + +> **Note**: +> The directory itself is not copied, just its contents. + +- If `` is a *local* tar archive in a recognized compression format + (identity, gzip, bzip2 or xz) then it is unpacked as a directory. Resources + from *remote* URLs are **not** decompressed. When a directory is copied or + unpacked, it has the same behavior as `tar -x`: the result is the union of: + + 1. Whatever existed at the destination path and + 2. The contents of the source tree, with conflicts resolved in favor + of "2." on a file-by-file basis. + +- If `` is any other kind of file, it is copied individually along with + its metadata. In this case, if `` ends with a trailing slash `/`, it + will be considered a directory and the contents of `` will be written + at `/base()`. + +- If multiple `` resources are specified, either directly or due to the + use of a wildcard, then `` must be a directory, and it must end with + a slash `/`. + +- If `` does not end with a trailing slash, it will be considered a + regular file and the contents of `` will be written at ``. + +- If `` doesn't exist, it is created along with all missing directories + in its path. + +## COPY + +COPY has two forms: + +- `COPY ... ` +- `COPY ["",... ""]` (this form is required for paths containing +whitespace) + +The `COPY` instruction copies new files or directories from `` +and adds them to the filesystem of the container at the path ``. + +Multiple `` resource may be specified but they must be relative +to the source directory that is being built (the context of the build). + +Each `` may contain wildcards and matching will be done using Go's +[filepath.Match](http://golang.org/pkg/path/filepath#Match) rules. For example: + + COPY hom* /mydir/ # adds all files starting with "hom" + COPY hom?.txt /mydir/ # ? is replaced with any single character, e.g., "home.txt" + +The `` is an absolute path, or a path relative to `WORKDIR`, into which +the source will be copied inside the destination container. + + COPY test relativeDir/ # adds "test" to `WORKDIR`/relativeDir/ + COPY test /absoluteDir # adds "test" to /absoluteDir + +All new files and directories are created with a UID and GID of 0. + +> **Note**: +> If you build using STDIN (`docker build - < somefile`), there is no +> build context, so `COPY` can't be used. + +`COPY` obeys the following rules: + +- The `` path must be inside the *context* of the build; + you cannot `COPY ../something /something`, because the first step of a + `docker build` is to send the context directory (and subdirectories) to the + docker daemon. + +- If `` is a directory, the entire contents of the directory are copied, + including filesystem metadata. + +> **Note**: +> The directory itself is not copied, just its contents. + +- If `` is any other kind of file, it is copied individually along with + its metadata. In this case, if `` ends with a trailing slash `/`, it + will be considered a directory and the contents of `` will be written + at `/base()`. + +- If multiple `` resources are specified, either directly or due to the + use of a wildcard, then `` must be a directory, and it must end with + a slash `/`. + +- If `` does not end with a trailing slash, it will be considered a + regular file and the contents of `` will be written at ``. + +- If `` doesn't exist, it is created along with all missing directories + in its path. + +## ENTRYPOINT + +ENTRYPOINT has two forms: + +- `ENTRYPOINT ["executable", "param1", "param2"]` + (*exec* form, preferred) +- `ENTRYPOINT command param1 param2` + (*shell* form) + +An `ENTRYPOINT` allows you to configure a container that will run as an executable. + +For example, the following will start nginx with its default content, listening +on port 80: + + docker run -i -t --rm -p 80:80 nginx + +Command line arguments to `docker run ` will be appended after all +elements in an *exec* form `ENTRYPOINT`, and will override all elements specified +using `CMD`. +This allows arguments to be passed to the entry point, i.e., `docker run -d` +will pass the `-d` argument to the entry point. +You can override the `ENTRYPOINT` instruction using the `docker run --entrypoint` +flag. + +The *shell* form prevents any `CMD` or `run` command line arguments from being +used, but has the disadvantage that your `ENTRYPOINT` will be started as a +subcommand of `/bin/sh -c`, which does not pass signals. +This means that the executable will not be the container's `PID 1` - and +will _not_ receive Unix signals - so your executable will not receive a +`SIGTERM` from `docker stop `. + +Only the last `ENTRYPOINT` instruction in the `Dockerfile` will have an effect. + +### Exec form ENTRYPOINT example + +You can use the *exec* form of `ENTRYPOINT` to set fairly stable default commands +and arguments and then use either form of `CMD` to set additional defaults that +are more likely to be changed. + + FROM ubuntu + ENTRYPOINT ["top", "-b"] + CMD ["-c"] + +When you run the container, you can see that `top` is the only process: + + $ docker run -it --rm --name test top -H + top - 08:25:00 up 7:27, 0 users, load average: 0.00, 0.01, 0.05 + Threads: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + %Cpu(s): 0.1 us, 0.1 sy, 0.0 ni, 99.7 id, 0.0 wa, 0.0 hi, 0.0 si, 0.0 st + KiB Mem: 2056668 total, 1616832 used, 439836 free, 99352 buffers + KiB Swap: 1441840 total, 0 used, 1441840 free. 1324440 cached Mem + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 19744 2336 2080 R 0.0 0.1 0:00.04 top + +To examine the result further, you can use `docker exec`: + + $ docker exec -it test ps aux + USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND + root 1 2.6 0.1 19752 2352 ? Ss+ 08:24 0:00 top -b -H + root 7 0.0 0.1 15572 2164 ? R+ 08:25 0:00 ps aux + +And you can gracefully request `top` to shut down using `docker stop test`. + +The following `Dockerfile` shows using the `ENTRYPOINT` to run Apache in the +foreground (i.e., as `PID 1`): + +``` +FROM debian:stable +RUN apt-get update && apt-get install -y --force-yes apache2 +EXPOSE 80 443 +VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"] +ENTRYPOINT ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"] +``` + +If you need to write a starter script for a single executable, you can ensure that +the final executable receives the Unix signals by using `exec` and `gosu` +commands: + +```bash +#!/bin/bash +set -e + +if [ "$1" = 'postgres' ]; then + chown -R postgres "$PGDATA" + + if [ -z "$(ls -A "$PGDATA")" ]; then + gosu postgres initdb + fi + + exec gosu postgres "$@" +fi + +exec "$@" +``` + +Lastly, if you need to do some extra cleanup (or communicate with other containers) +on shutdown, or are co-ordinating more than one executable, you may need to ensure +that the `ENTRYPOINT` script receives the Unix signals, passes them on, and then +does some more work: + +``` +#!/bin/sh +# Note: I've written this using sh so it works in the busybox container too + +# USE the trap if you need to also do manual cleanup after the service is stopped, +# or need to start multiple services in the one container +trap "echo TRAPed signal" HUP INT QUIT KILL TERM + +# start service in background here +/usr/sbin/apachectl start + +echo "[hit enter key to exit] or run 'docker stop '" +read + +# stop service and clean up here +echo "stopping apache" +/usr/sbin/apachectl stop + +echo "exited $0" +``` + +If you run this image with `docker run -it --rm -p 80:80 --name test apache`, +you can then examine the container's processes with `docker exec`, or `docker top`, +and then ask the script to stop Apache: + +```bash +$ docker exec -it test ps aux +USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND +root 1 0.1 0.0 4448 692 ? Ss+ 00:42 0:00 /bin/sh /run.sh 123 cmd cmd2 +root 19 0.0 0.2 71304 4440 ? Ss 00:42 0:00 /usr/sbin/apache2 -k start +www-data 20 0.2 0.2 360468 6004 ? Sl 00:42 0:00 /usr/sbin/apache2 -k start +www-data 21 0.2 0.2 360468 6000 ? Sl 00:42 0:00 /usr/sbin/apache2 -k start +root 81 0.0 0.1 15572 2140 ? R+ 00:44 0:00 ps aux +$ docker top test +PID USER COMMAND +10035 root {run.sh} /bin/sh /run.sh 123 cmd cmd2 +10054 root /usr/sbin/apache2 -k start +10055 33 /usr/sbin/apache2 -k start +10056 33 /usr/sbin/apache2 -k start +$ /usr/bin/time docker stop test +test +real 0m 0.27s +user 0m 0.03s +sys 0m 0.03s +``` + +> **Note:** you can over ride the `ENTRYPOINT` setting using `--entrypoint`, +> but this can only set the binary to *exec* (no `sh -c` will be used). + +> **Note**: +> The *exec* form is parsed as a JSON array, which means that +> you must use double-quotes (") around words not single-quotes ('). + +> **Note**: +> Unlike the *shell* form, the *exec* form does not invoke a command shell. +> This means that normal shell processing does not happen. For example, +> `ENTRYPOINT [ "echo", "$HOME" ]` will not do variable substitution on `$HOME`. +> If you want shell processing then either use the *shell* form or execute +> a shell directly, for example: `ENTRYPOINT [ "sh", "-c", "echo", "$HOME" ]`. +> Variables that are defined in the `Dockerfile`using `ENV`, will be substituted by +> the `Dockerfile` parser. + +### Shell form ENTRYPOINT example + +You can specify a plain string for the `ENTRYPOINT` and it will execute in `/bin/sh -c`. +This form will use shell processing to substitute shell environment variables, +and will ignore any `CMD` or `docker run` command line arguments. +To ensure that `docker stop` will signal any long running `ENTRYPOINT` executable +correctly, you need to remember to start it with `exec`: + + FROM ubuntu + ENTRYPOINT exec top -b + +When you run this image, you'll see the single `PID 1` process: + + $ docker run -it --rm --name test top + Mem: 1704520K used, 352148K free, 0K shrd, 0K buff, 140368121167873K cached + CPU: 5% usr 0% sys 0% nic 94% idle 0% io 0% irq 0% sirq + Load average: 0.08 0.03 0.05 2/98 6 + PID PPID USER STAT VSZ %VSZ %CPU COMMAND + 1 0 root R 3164 0% 0% top -b + +Which will exit cleanly on `docker stop`: + + $ /usr/bin/time docker stop test + test + real 0m 0.20s + user 0m 0.02s + sys 0m 0.04s + +If you forget to add `exec` to the beginning of your `ENTRYPOINT`: + + FROM ubuntu + ENTRYPOINT top -b + CMD --ignored-param1 + +You can then run it (giving it a name for the next step): + + $ docker run -it --name test top --ignored-param2 + Mem: 1704184K used, 352484K free, 0K shrd, 0K buff, 140621524238337K cached + CPU: 9% usr 2% sys 0% nic 88% idle 0% io 0% irq 0% sirq + Load average: 0.01 0.02 0.05 2/101 7 + PID PPID USER STAT VSZ %VSZ %CPU COMMAND + 1 0 root S 3168 0% 0% /bin/sh -c top -b cmd cmd2 + 7 1 root R 3164 0% 0% top -b + +You can see from the output of `top` that the specified `ENTRYPOINT` is not `PID 1`. + +If you then run `docker stop test`, the container will not exit cleanly - the +`stop` command will be forced to send a `SIGKILL` after the timeout: + + $ docker exec -it test ps aux + PID USER COMMAND + 1 root /bin/sh -c top -b cmd cmd2 + 7 root top -b + 8 root ps aux + $ /usr/bin/time docker stop test + test + real 0m 10.19s + user 0m 0.04s + sys 0m 0.03s + +## VOLUME + + VOLUME ["/data"] + +The `VOLUME` instruction creates a mount point with the specified name +and marks it as holding externally mounted volumes from native host or other +containers. The value can be a JSON array, `VOLUME ["/var/log/"]`, or a plain +string with multiple arguments, such as `VOLUME /var/log` or `VOLUME /var/log +/var/db`. For more information/examples and mounting instructions via the +Docker client, refer to +[*Share Directories via Volumes*](../userguide/dockervolumes.md#mount-a-host-directory-as-a-data-volume) +documentation. + +The `docker run` command initializes the newly created volume with any data +that exists at the specified location within the base image. For example, +consider the following Dockerfile snippet: + + FROM ubuntu + RUN mkdir /myvol + RUN echo "hello world" > /myvol/greeting + VOLUME /myvol + +This Dockerfile results in an image that causes `docker run`, to +create a new mount point at `/myvol` and copy the `greeting` file +into the newly created volume. + +> **Note**: +> If any build steps change the data within the volume after it has been +> declared, those changes will be discarded. + +> **Note**: +> The list is parsed as a JSON array, which means that +> you must use double-quotes (") around words not single-quotes ('). + +## USER + + USER daemon + +The `USER` instruction sets the user name or UID to use when running the image +and for any `RUN`, `CMD` and `ENTRYPOINT` instructions that follow it in the +`Dockerfile`. + +## WORKDIR + + WORKDIR /path/to/workdir + +The `WORKDIR` instruction sets the working directory for any `RUN`, `CMD`, +`ENTRYPOINT`, `COPY` and `ADD` instructions that follow it in the `Dockerfile`. + +It can be used multiple times in the one `Dockerfile`. If a relative path +is provided, it will be relative to the path of the previous `WORKDIR` +instruction. For example: + + WORKDIR /a + WORKDIR b + WORKDIR c + RUN pwd + +The output of the final `pwd` command in this `Dockerfile` would be +`/a/b/c`. + +The `WORKDIR` instruction can resolve environment variables previously set using +`ENV`. You can only use environment variables explicitly set in the `Dockerfile`. +For example: + + ENV DIRPATH /path + WORKDIR $DIRPATH/$DIRNAME + RUN pwd + +The output of the final `pwd` command in this `Dockerfile` would be +`/path/$DIRNAME` + +## ARG + + ARG [=] + +The `ARG` instruction defines a variable that users can pass at build-time to +the builder with the `docker build` command using the `--build-arg +=` flag. If a user specifies a build argument that was not +defined in the Dockerfile, the build outputs an error. + +``` +One or more build-args were not consumed, failing build. +``` + +The Dockerfile author can define a single variable by specifying `ARG` once or many +variables by specifying `ARG` more than once. For example, a valid Dockerfile: + +``` +FROM busybox +ARG user1 +ARG buildno +... +``` + +A Dockerfile author may optionally specify a default value for an `ARG` instruction: + +``` +FROM busybox +ARG user1=someuser +ARG buildno=1 +... +``` + +If an `ARG` value has a default and if there is no value passed at build-time, the +builder uses the default. + +An `ARG` variable definition comes into effect from the line on which it is +defined in the `Dockerfile` not from the argument's use on the command-line or +elsewhere. For example, consider this Dockerfile: + +``` +1 FROM busybox +2 USER ${user:-some_user} +3 ARG user +4 USER $user +... +``` +A user builds this file by calling: + +``` +$ docker build --build-arg user=what_user Dockerfile +``` + +The `USER` at line 2 evaluates to `some_user` as the `user` variable is defined on the +subsequent line 3. The `USER` at line 4 evaluates to `what_user` as `user` is +defined and the `what_user` value was passed on the command line. Prior to its definition by an +`ARG` instruction, any use of a variable results in an empty string. + +> **Note:** It is not recommended to use build-time variables for +> passing secrets like github keys, user credentials etc. + +You can use an `ARG` or an `ENV` instruction to specify variables that are +available to the `RUN` instruction. Environment variables defined using the +`ENV` instruction always override an `ARG` instruction of the same name. Consider +this Dockerfile with an `ENV` and `ARG` instruction. + +``` +1 FROM ubuntu +2 ARG CONT_IMG_VER +3 ENV CONT_IMG_VER v1.0.0 +4 RUN echo $CONT_IMG_VER +``` +Then, assume this image is built with this command: + +``` +$ docker build --build-arg CONT_IMG_VER=v2.0.1 Dockerfile +``` + +In this case, the `RUN` instruction uses `v1.0.0` instead of the `ARG` setting +passed by the user:`v2.0.1` This behavior is similar to a shell +script where a locally scoped variable overrides the variables passed as +arguments or inherited from environment, from its point of definition. + +Using the example above but a different `ENV` specification you can create more +useful interactions between `ARG` and `ENV` instructions: + +``` +1 FROM ubuntu +2 ARG CONT_IMG_VER +3 ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0} +4 RUN echo $CONT_IMG_VER +``` + +Unlike an `ARG` instruction, `ENV` values are always persisted in the built +image. Consider a docker build without the --build-arg flag: + +``` +$ docker build Dockerfile +``` + +Using this Dockerfile example, `CONT_IMG_VER` is still persisted in the image but +its value would be `v1.0.0` as it is the default set in line 3 by the `ENV` instruction. + +The variable expansion technique in this example allows you to pass arguments +from the command line and persist them in the final image by leveraging the +`ENV` instruction. Variable expansion is only supported for [a limited set of +Dockerfile instructions.](#environment-replacement) + +Docker has a set of predefined `ARG` variables that you can use without a +corresponding `ARG` instruction in the Dockerfile. + +* `HTTP_PROXY` +* `http_proxy` +* `HTTPS_PROXY` +* `https_proxy` +* `FTP_PROXY` +* `ftp_proxy` +* `NO_PROXY` +* `no_proxy` + +To use these, simply pass them on the command line using the `--build-arg +=` flag. + +## ONBUILD + + ONBUILD [INSTRUCTION] + +The `ONBUILD` instruction adds to the image a *trigger* instruction to +be executed at a later time, when the image is used as the base for +another build. The trigger will be executed in the context of the +downstream build, as if it had been inserted immediately after the +`FROM` instruction in the downstream `Dockerfile`. + +Any build instruction can be registered as a trigger. + +This is useful if you are building an image which will be used as a base +to build other images, for example an application build environment or a +daemon which may be customized with user-specific configuration. + +For example, if your image is a reusable Python application builder, it +will require application source code to be added in a particular +directory, and it might require a build script to be called *after* +that. You can't just call `ADD` and `RUN` now, because you don't yet +have access to the application source code, and it will be different for +each application build. You could simply provide application developers +with a boilerplate `Dockerfile` to copy-paste into their application, but +that is inefficient, error-prone and difficult to update because it +mixes with application-specific code. + +The solution is to use `ONBUILD` to register advance instructions to +run later, during the next build stage. + +Here's how it works: + +1. When it encounters an `ONBUILD` instruction, the builder adds a + trigger to the metadata of the image being built. The instruction + does not otherwise affect the current build. +2. At the end of the build, a list of all triggers is stored in the + image manifest, under the key `OnBuild`. They can be inspected with + the `docker inspect` command. +3. Later the image may be used as a base for a new build, using the + `FROM` instruction. As part of processing the `FROM` instruction, + the downstream builder looks for `ONBUILD` triggers, and executes + them in the same order they were registered. If any of the triggers + fail, the `FROM` instruction is aborted which in turn causes the + build to fail. If all triggers succeed, the `FROM` instruction + completes and the build continues as usual. +4. Triggers are cleared from the final image after being executed. In + other words they are not inherited by "grand-children" builds. + +For example you might add something like this: + + [...] + ONBUILD ADD . /app/src + ONBUILD RUN /usr/local/bin/python-build --dir /app/src + [...] + +> **Warning**: Chaining `ONBUILD` instructions using `ONBUILD ONBUILD` isn't allowed. + +> **Warning**: The `ONBUILD` instruction may not trigger `FROM` or `MAINTAINER` instructions. + +## STOPSIGNAL + + STOPSIGNAL signal + +The `STOPSIGNAL` instruction sets the system call signal that will be sent to the container to exit. +This signal can be a valid unsigned number that matches a position in the kernel's syscall table, for instance 9, +or a signal name in the format SIGNAME, for instance SIGKILL. + +## Dockerfile examples + +Below you can see some examples of Dockerfile syntax. If you're interested in +something more realistic, take a look at the list of [Dockerization examples](../examples/). + +``` +# Nginx +# +# VERSION 0.0.1 + +FROM ubuntu +MAINTAINER Victor Vieux + +LABEL Description="This image is used to start the foobar executable" Vendor="ACME Products" Version="1.0" +RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server +``` + +``` +# Firefox over VNC +# +# VERSION 0.3 + +FROM ubuntu + +# Install vnc, xvfb in order to create a 'fake' display and firefox +RUN apt-get update && apt-get install -y x11vnc xvfb firefox +RUN mkdir ~/.vnc +# Setup a password +RUN x11vnc -storepasswd 1234 ~/.vnc/passwd +# Autostart firefox (might not be the best way, but it does the trick) +RUN bash -c 'echo "firefox" >> /.bashrc' + +EXPOSE 5900 +CMD ["x11vnc", "-forever", "-usepw", "-create"] +``` + +``` +# Multiple images example +# +# VERSION 0.1 + +FROM ubuntu +RUN echo foo > bar +# Will output something like ===> 907ad6c2736f + +FROM ubuntu +RUN echo moo > oink +# Will output something like ===> 695d7793cbe4 + +# You᾿ll now have two images, 907ad6c2736f with /bar, and 695d7793cbe4 with +# /oink. +``` diff --git a/docs/reference/commandline/attach.md b/docs/reference/commandline/attach.md new file mode 100644 index 0000000000..d746190d60 --- /dev/null +++ b/docs/reference/commandline/attach.md @@ -0,0 +1,90 @@ + + +# attach + + Usage: docker attach [OPTIONS] CONTAINER + + Attach to a running container + + --help=false Print usage + --no-stdin=false Do not attach STDIN + --sig-proxy=true Proxy all received signals to the process + +The `docker attach` command allows you to attach to a running container using +the container's ID or name, either to view its ongoing output or to control it +interactively. You can attach to the same contained process multiple times +simultaneously, screen sharing style, or quickly view the progress of your +detached process. + +You can detach from the container and leave it running with `CTRL-p CTRL-q` +(for a quiet exit) or with `CTRL-c` if `--sig-proxy` is false. + +If `--sig-proxy` is true (the default),`CTRL-c` sends a `SIGINT` to the +container. + +> **Note:** +> A process running as PID 1 inside a container is treated specially by +> Linux: it ignores any signal with the default action. So, the process +> will not terminate on `SIGINT` or `SIGTERM` unless it is coded to do +> so. + +It is forbidden to redirect the standard input of a `docker attach` command +while attaching to a tty-enabled container (i.e.: launched with `-t`). + +#### Examples + + $ docker run -d --name topdemo ubuntu /usr/bin/top -b + $ docker attach topdemo + top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355560k used, 18012k free, 27872k buffers + Swap: 786428k total, 0k used, 786428k free, 221740k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17200 1116 912 R 0 0.3 0:00.03 top + + top - 02:05:55 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.0%us, 0.2%sy, 0.0%ni, 99.8%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355244k used, 18328k free, 27872k buffers + Swap: 786428k total, 0k used, 786428k free, 221776k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top + + + top - 02:05:58 up 3:06, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.2%us, 0.3%sy, 0.0%ni, 99.5%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355780k used, 17792k free, 27880k buffers + Swap: 786428k total, 0k used, 786428k free, 221776k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top + ^C$ + $ echo $? + 0 + $ docker ps -a | grep topdemo + 7998ac8581f9 ubuntu:14.04 "/usr/bin/top -b" 38 seconds ago Exited (0) 21 seconds ago topdemo + +And in this second example, you can see the exit code returned by the `bash` +process is returned by the `docker attach` command to its caller too: + + $ docker run --name test -d -it debian + 275c44472aebd77c926d4527885bb09f2f6db21d878c75f0a1c212c03d3bcfab + $ docker attach test + $$ exit 13 + exit + $ echo $? + 13 + $ docker ps -a | grep test + 275c44472aeb debian:7 "/bin/bash" 26 seconds ago Exited (13) 17 seconds ago test diff --git a/docs/reference/commandline/build.md b/docs/reference/commandline/build.md new file mode 100644 index 0000000000..23a34581f0 --- /dev/null +++ b/docs/reference/commandline/build.md @@ -0,0 +1,294 @@ + + +# build + + Usage: docker build [OPTIONS] PATH | URL | - + + Build a new image from the source code at PATH + + --build-arg=[] Set build-time variables + --cpu-shares CPU Shares (relative weight) + --cgroup-parent="" Optional parent cgroup for the container + --cpu-period=0 Limit the CPU CFS (Completely Fair Scheduler) period + --cpu-quota=0 Limit the CPU CFS (Completely Fair Scheduler) quota + --cpuset-cpus="" CPUs in which to allow execution, e.g. `0-3`, `0,1` + --cpuset-mems="" MEMs in which to allow execution, e.g. `0-3`, `0,1` + --disable-content-trust=true Skip image verification + -f, --file="" Name of the Dockerfile (Default is 'PATH/Dockerfile') + --force-rm=false Always remove intermediate containers + --help=false Print usage + -m, --memory="" Memory limit for all build containers + --memory-swap="" Total memory (memory + swap), `-1` to disable swap + --no-cache=false Do not use cache when building the image + --pull=false Always attempt to pull a newer version of the image + -q, --quiet=false Suppress the verbose output generated by the containers + --rm=true Remove intermediate containers after a successful build + -t, --tag="" Repository name (and optionally a tag) for the image + --ulimit=[] Ulimit options + +Builds Docker images from a Dockerfile and a "context". A build's context is +the files located in the specified `PATH` or `URL`. The build process can refer +to any of the files in the context. For example, your build can use an +[*ADD*](../builder.md#add) instruction to reference a file in the +context. + +The `URL` parameter can specify the location of a Git repository; the repository +acts as the build context. The system recursively clones the repository and its +submodules using a `git clone --depth 1 --recursive` command. This command runs +in a temporary directory on your local host. After the command succeeds, the +directory is sent to the Docker daemon as the context. Local clones give you the +ability to access private repositories using local user credentials, VPNs, and +so forth. + +Git URLs accept context configuration in their fragment section, separated by a +colon `:`. The first part represents the reference that Git will check out, +this can be either a branch, a tag, or a commit SHA. The second part represents +a subdirectory inside the repository that will be used as a build context. + +For example, run this command to use a directory called `docker` in the branch +`container`: + + $ docker build https://github.com/docker/rootfs.git#container:docker + +The following table represents all the valid suffixes with their build +contexts: + +Build Syntax Suffix | Commit Used | Build Context Used +--------------------|-------------|------------------- +`myrepo.git` | `refs/heads/master` | `/` +`myrepo.git#mytag` | `refs/tags/mytag` | `/` +`myrepo.git#mybranch` | `refs/heads/mybranch` | `/` +`myrepo.git#abcdef` | `sha1 = abcdef` | `/` +`myrepo.git#:myfolder` | `refs/heads/master` | `/myfolder` +`myrepo.git#master:myfolder` | `refs/heads/master` | `/myfolder` +`myrepo.git#mytag:myfolder` | `refs/tags/mytag` | `/myfolder` +`myrepo.git#mybranch:myfolder` | `refs/heads/mybranch` | `/myfolder` +`myrepo.git#abcdef:myfolder` | `sha1 = abcdef` | `/myfolder` + +Instead of specifying a context, you can pass a single Dockerfile in the `URL` +or pipe the file in via `STDIN`. To pipe a Dockerfile from `STDIN`: + + docker build - < Dockerfile + +If you use STDIN or specify a `URL`, the system places the contents into a file +called `Dockerfile`, and any `-f`, `--file` option is ignored. In this +scenario, there is no context. + +By default the `docker build` command will look for a `Dockerfile` at the root +of the build context. The `-f`, `--file`, option lets you specify the path to +an alternative file to use instead. This is useful in cases where the same set +of files are used for multiple builds. The path must be to a file within the +build context. If a relative path is specified then it must to be relative to +the current directory. + +In most cases, it's best to put each Dockerfile in an empty directory. Then, +add to that directory only the files needed for building the Dockerfile. To +increase the build's performance, you can exclude files and directories by +adding a `.dockerignore` file to that directory as well. For information on +creating one, see the [.dockerignore file](../builder.md#dockerignore-file). + +If the Docker client loses connection to the daemon, the build is canceled. +This happens if you interrupt the Docker client with `ctrl-c` or if the Docker +client is killed for any reason. + +> **Note:** +> Currently only the "run" phase of the build can be canceled until pull +> cancellation is implemented). + +## Return code + +On a successful build, a return code of success `0` will be returned. When the +build fails, a non-zero failure code will be returned. + +There should be informational output of the reason for failure output to +`STDERR`: + + $ docker build -t fail . + Sending build context to Docker daemon 2.048 kB + Sending build context to Docker daemon + Step 1 : FROM busybox + ---> 4986bf8c1536 + Step 2 : RUN exit 13 + ---> Running in e26670ec7a0a + INFO[0000] The command [/bin/sh -c exit 13] returned a non-zero code: 13 + $ echo $? + 1 + +See also: + +[*Dockerfile Reference*](../builder.md). + +## Examples + +### Build with PATH + + $ docker build . + Uploading context 10240 bytes + Step 1 : FROM busybox + Pulling repository busybox + ---> e9aa60c60128MB/2.284 MB (100%) endpoint: https://cdn-registry-1.docker.io/v1/ + Step 2 : RUN ls -lh / + ---> Running in 9c9e81692ae9 + total 24 + drwxr-xr-x 2 root root 4.0K Mar 12 2013 bin + drwxr-xr-x 5 root root 4.0K Oct 19 00:19 dev + drwxr-xr-x 2 root root 4.0K Oct 19 00:19 etc + drwxr-xr-x 2 root root 4.0K Nov 15 23:34 lib + lrwxrwxrwx 1 root root 3 Mar 12 2013 lib64 -> lib + dr-xr-xr-x 116 root root 0 Nov 15 23:34 proc + lrwxrwxrwx 1 root root 3 Mar 12 2013 sbin -> bin + dr-xr-xr-x 13 root root 0 Nov 15 23:34 sys + drwxr-xr-x 2 root root 4.0K Mar 12 2013 tmp + drwxr-xr-x 2 root root 4.0K Nov 15 23:34 usr + ---> b35f4035db3f + Step 3 : CMD echo Hello world + ---> Running in 02071fceb21b + ---> f52f38b7823e + Successfully built f52f38b7823e + Removing intermediate container 9c9e81692ae9 + Removing intermediate container 02071fceb21b + +This example specifies that the `PATH` is `.`, and so all the files in the +local directory get `tar`d and sent to the Docker daemon. The `PATH` specifies +where to find the files for the "context" of the build on the Docker daemon. +Remember that the daemon could be running on a remote machine and that no +parsing of the Dockerfile happens at the client side (where you're running +`docker build`). That means that *all* the files at `PATH` get sent, not just +the ones listed to [*ADD*](../builder.md#add) in the Dockerfile. + +The transfer of context from the local machine to the Docker daemon is what the +`docker` client means when you see the "Sending build context" message. + +If you wish to keep the intermediate containers after the build is complete, +you must use `--rm=false`. This does not affect the build cache. + +### Build with URL + + $ docker build github.com/creack/docker-firefox + +This will clone the GitHub repository and use the cloned repository as context. +The Dockerfile at the root of the repository is used as Dockerfile. Note that +you can specify an arbitrary Git repository by using the `git://` or `git@` +schema. + +### Build with - + + $ docker build - < Dockerfile + +This will read a Dockerfile from `STDIN` without context. Due to the lack of a +context, no contents of any local directory will be sent to the Docker daemon. +Since there is no context, a Dockerfile `ADD` only works if it refers to a +remote URL. + + $ docker build - < context.tar.gz + +This will build an image for a compressed context read from `STDIN`. Supported +formats are: bzip2, gzip and xz. + +### Usage of .dockerignore + + $ docker build . + Uploading context 18.829 MB + Uploading context + Step 1 : FROM busybox + ---> 769b9341d937 + Step 2 : CMD echo Hello world + ---> Using cache + ---> 99cc1ad10469 + Successfully built 99cc1ad10469 + $ echo ".git" > .dockerignore + $ docker build . + Uploading context 6.76 MB + Uploading context + Step 1 : FROM busybox + ---> 769b9341d937 + Step 2 : CMD echo Hello world + ---> Using cache + ---> 99cc1ad10469 + Successfully built 99cc1ad10469 + +This example shows the use of the `.dockerignore` file to exclude the `.git` +directory from the context. Its effect can be seen in the changed size of the +uploaded context. The builder reference contains detailed information on +[creating a .dockerignore file](../builder.md#dockerignore-file) + +### Tag image (-t) + + $ docker build -t vieux/apache:2.0 . + +This will build like the previous example, but it will then tag the resulting +image. The repository name will be `vieux/apache` and the tag will be `2.0` + +### Specify Dockerfile (-f) + + $ docker build -f Dockerfile.debug . + +This will use a file called `Dockerfile.debug` for the build instructions +instead of `Dockerfile`. + + $ docker build -f dockerfiles/Dockerfile.debug -t myapp_debug . + $ docker build -f dockerfiles/Dockerfile.prod -t myapp_prod . + +The above commands will build the current build context (as specified by the +`.`) twice, once using a debug version of a `Dockerfile` and once using a +production version. + + $ cd /home/me/myapp/some/dir/really/deep + $ docker build -f /home/me/myapp/dockerfiles/debug /home/me/myapp + $ docker build -f ../../../../dockerfiles/debug /home/me/myapp + +These two `docker build` commands do the exact same thing. They both use the +contents of the `debug` file instead of looking for a `Dockerfile` and will use +`/home/me/myapp` as the root of the build context. Note that `debug` is in the +directory structure of the build context, regardless of how you refer to it on +the command line. + +> **Note:** +> `docker build` will return a `no such file or directory` error if the +> file or directory does not exist in the uploaded context. This may +> happen if there is no context, or if you specify a file that is +> elsewhere on the Host system. The context is limited to the current +> directory (and its children) for security reasons, and to ensure +> repeatable builds on remote Docker hosts. This is also the reason why +> `ADD ../file` will not work. + +### Optional parent cgroup (--cgroup-parent) + +When `docker build` is run with the `--cgroup-parent` option the containers +used in the build will be run with the [corresponding `docker run` +flag](../run.md#specifying-custom-cgroups). + +### Set ulimits in container (--ulimit) + +Using the `--ulimit` option with `docker build` will cause each build step's +container to be started using those [`--ulimit` +flag values](../run.md#setting-ulimits-in-a-container). + +### Set build-time variables (--build-arg) + +You can use `ENV` instructions in a Dockerfile to define variable +values. These values persist in the built image. However, often +persistence is not what you want. Users want to specify variables differently +depending on which host they build an image on. + +A good example is `http_proxy` or source versions for pulling intermediate +files. The `ARG` instruction lets Dockerfile authors define values that users +can set at build-time using the `--build-arg` flag: + + $ docker build --build-arg HTTP_PROXY=http://10.20.30.2:1234 . + +This flag allows you to pass the build-time variables that are +accessed like regular environment variables in the `RUN` instruction of the +Dockerfile. Also, these values don't persist in the intermediate or final images +like `ENV` values do. + +For detailed information on using `ARG` and `ENV` instructions, see the +[Dockerfile reference](../builder.md). diff --git a/docs/reference/commandline/cli.md b/docs/reference/commandline/cli.md new file mode 100644 index 0000000000..78d1963d35 --- /dev/null +++ b/docs/reference/commandline/cli.md @@ -0,0 +1,170 @@ + + +# Use the Docker command line + +To list available commands, either run `docker` with no parameters +or execute `docker help`: + + $ docker + Usage: docker [OPTIONS] COMMAND [arg...] + docker daemon [ --help | ... ] + docker [ --help | -v | --version ] + + -H, --host=[]: The socket(s) to talk to the Docker daemon in the format of tcp://host:port/path, unix:///path/to/socket, fd://* or fd://socketfd. + + A self-sufficient runtime for Linux containers. + + ... + +Depending on your Docker system configuration, you may be required to preface +each `docker` command with `sudo`. To avoid having to use `sudo` with the +`docker` command, your system administrator can create a Unix group called +`docker` and add users to it. + +For more information about installing Docker or `sudo` configuration, refer to +the [installation](../../installation) instructions for your operating system. + +## Environment variables + +For easy reference, the following list of environment variables are supported +by the `docker` command line: + +* `DOCKER_CONFIG` The location of your client configuration files. +* `DOCKER_CERT_PATH` The location of your authentication keys. +* `DOCKER_DRIVER` The graph driver to use. +* `DOCKER_HOST` Daemon socket to connect to. +* `DOCKER_NOWARN_KERNEL_VERSION` Prevent warnings that your Linux kernel is + unsuitable for Docker. +* `DOCKER_RAMDISK` If set this will disable 'pivot_root'. +* `DOCKER_TLS_VERIFY` When set Docker uses TLS and verifies the remote. +* `DOCKER_CONTENT_TRUST` When set Docker uses notary to sign and verify images. + Equates to `--disable-content-trust=false` for build, create, pull, push, run. +* `DOCKER_TMPDIR` Location for temporary Docker files. + +Because Docker is developed using 'Go', you can also use any environment +variables used by the 'Go' runtime. In particular, you may find these useful: + +* `HTTP_PROXY` +* `HTTPS_PROXY` +* `NO_PROXY` + +These Go environment variables are case-insensitive. See the +[Go specification](http://golang.org/pkg/net/http/) for details on these +variables. + +## Configuration files + +By default, the Docker command line stores its configuration files in a +directory called `.docker` within your `HOME` directory. However, you can +specify a different location via the `DOCKER_CONFIG` environment variable +or the `--config` command line option. If both are specified, then the +`--config` option overrides the `DOCKER_CONFIG` environment variable. +For example: + + docker --config ~/testconfigs/ ps + +Instructs Docker to use the configuration files in your `~/testconfigs/` +directory when running the `ps` command. + +Docker manages most of the files in the configuration directory +and you should not modify them. However, you *can modify* the +`config.json` file to control certain aspects of how the `docker` +command behaves. + +Currently, you can modify the `docker` command behavior using environment +variables or command-line options. You can also use options within +`config.json` to modify some of the same behavior. When using these +mechanisms, you must keep in mind the order of precedence among them. Command +line options override environment variables and environment variables override +properties you specify in a `config.json` file. + +The `config.json` file stores a JSON encoding of several properties: + +The property `HttpHeaders` specifies a set of headers to include in all messages +sent from the Docker client to the daemon. Docker does not try to interpret or +understand these header; it simply puts them into the messages. Docker does +not allow these headers to change any headers it sets for itself. + +The property `psFormat` specifies the default format for `docker ps` output. +When the `--format` flag is not provided with the `docker ps` command, +Docker's client uses this property. If this property is not set, the client +falls back to the default table format. For a list of supported formatting +directives, see the [**Formatting** section in the `docker ps` documentation](ps.md) + +Following is a sample `config.json` file: + + { + "HttpHeaders": { + "MyHeader": "MyValue" + }, + "psFormat": "table {{.ID}}\\t{{.Image}}\\t{{.Command}}\\t{{.Labels}}" + } + +## Help + +To list the help on any command just execute the command, followed by the +`--help` option. + + $ docker run --help + + Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...] + + Run a command in a new container + + -a, --attach=[] Attach to STDIN, STDOUT or STDERR + --cpu-shares=0 CPU shares (relative weight) + ... + +## Option types + +Single character command line options can be combined, so rather than +typing `docker run -i -t --name test busybox sh`, +you can write `docker run -it --name test busybox sh`. + +### Boolean + +Boolean options take the form `-d=false`. The value you see in the help text is +the default value which is set if you do **not** specify that flag. If you +specify a Boolean flag without a value, this will set the flag to `true`, +irrespective of the default value. + +For example, running `docker run -d` will set the value to `true`, so your +container **will** run in "detached" mode, in the background. + +Options which default to `true` (e.g., `docker build --rm=true`) can only be +set to the non-default value by explicitly setting them to `false`: + + $ docker build --rm=false . + +### Multi + +You can specify options like `-a=[]` multiple times in a single command line, +for example in these commands: + + $ docker run -a stdin -a stdout -i -t ubuntu /bin/bash + $ docker run -a stdin -a stdout -a stderr ubuntu /bin/ls + +Sometimes, multiple options can call for a more complex value string as for +`-v`: + + $ docker run -v /host:/container example/mysql + +> **Note:** +> Do not use the `-t` and `-a stderr` options together due to +> limitations in the `pty` implementation. All `stderr` in `pty` mode +> simply goes to `stdout`. + +### Strings and Integers + +Options like `--name=""` expect a string, and they +can only be specified once. Options like `-c=0` +expect an integer, and they can only be specified once. diff --git a/docs/reference/commandline/commit.md b/docs/reference/commandline/commit.md new file mode 100644 index 0000000000..3f9228eefb --- /dev/null +++ b/docs/reference/commandline/commit.md @@ -0,0 +1,82 @@ + + +# commit + + Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] + + Create a new image from a container's changes + + -a, --author="" Author (e.g., "John Hannibal Smith ") + -c, --change=[] Apply specified Dockerfile instructions while committing the image + --help=false Print usage + -m, --message="" Commit message + -p, --pause=true Pause container during commit + +It can be useful to commit a container's file changes or settings into a new +image. This allows you debug a container by running an interactive shell, or to +export a working dataset to another server. Generally, it is better to use +Dockerfiles to manage your images in a documented and maintainable way. + +The commit operation will not include any data contained in +volumes mounted inside the container. + +By default, the container being committed and its processes will be paused +while the image is committed. This reduces the likelihood of encountering data +corruption during the process of creating the commit. If this behavior is +undesired, set the 'p' option to false. + +The `--change` option will apply `Dockerfile` instructions to the image that is +created. Supported `Dockerfile` instructions: +`CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`LABEL`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR` + +## Commit a container + + $ docker ps + ID IMAGE COMMAND CREATED STATUS PORTS + c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + $ docker commit c3f279d17e0a SvenDowideit/testimage:version3 + f5283438590d + $ docker images + REPOSITORY TAG ID CREATED VIRTUAL SIZE + SvenDowideit/testimage version3 f5283438590d 16 seconds ago 335.7 MB + +## Commit a container with new configurations + + $ docker ps + ID IMAGE COMMAND CREATED STATUS PORTS + c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + $ docker inspect -f "{{ .Config.Env }}" c3f279d17e0a + [HOME=/ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin] + $ docker commit --change "ENV DEBUG true" c3f279d17e0a SvenDowideit/testimage:version3 + f5283438590d + $ docker inspect -f "{{ .Config.Env }}" f5283438590d + [HOME=/ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin DEBUG=true] + +## Commit a container with new `CMD` and `EXPOSE` instructions + + $ docker ps + ID IMAGE COMMAND CREATED STATUS PORTS + c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + + $ docker commit --change='CMD ["apachectl", "-DFOREGROUND"]' -c "EXPOSE 80" c3f279d17e0a SvenDowideit/testimage:version4 + f5283438590d + + $ docker run -d SvenDowideit/testimage:version4 + 89373736e2e7f00bc149bd783073ac43d0507da250e999f3f1036e0db60817c0 + + $ docker ps + ID IMAGE COMMAND CREATED STATUS PORTS + 89373736e2e7 testimage:version4 "apachectl -DFOREGROU" 3 seconds ago Up 2 seconds 80/tcp + c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours diff --git a/docs/reference/commandline/cp.md b/docs/reference/commandline/cp.md new file mode 100644 index 0000000000..da27c20376 --- /dev/null +++ b/docs/reference/commandline/cp.md @@ -0,0 +1,90 @@ + + +# cp + + Usage: docker cp [OPTIONS] CONTAINER:PATH LOCALPATH|- + docker cp [OPTIONS] LOCALPATH|- CONTAINER:PATH + + Copy files/folders between a container and the local filesystem + + --help=false Print usage + +In the first synopsis form, the `docker cp` utility copies the contents of +`PATH` from the filesystem of `CONTAINER` to the `LOCALPATH` (or stream as +a tar archive to `STDOUT` if `-` is specified). + +In the second synopsis form, the contents of `LOCALPATH` (or a tar archive +streamed from `STDIN` if `-` is specified) are copied from the local machine to +`PATH` in the filesystem of `CONTAINER`. + +You can copy to or from either a running or stopped container. The `PATH` can +be a file or directory. The `docker cp` command assumes all `CONTAINER:PATH` +values are relative to the `/` (root) directory of the container. This means +supplying the initial forward slash is optional; The command sees +`compassionate_darwin:/tmp/foo/myfile.txt` and +`compassionate_darwin:tmp/foo/myfile.txt` as identical. If a `LOCALPATH` value +is not absolute, is it considered relative to the current working directory. + +Behavior is similar to the common Unix utility `cp -a` in that directories are +copied recursively with permissions preserved if possible. Ownership is set to +the user and primary group on the receiving end of the transfer. For example, +files copied to a container will be created with `UID:GID` of the root user. +Files copied to the local machine will be created with the `UID:GID` of the +user which invoked the `docker cp` command. + +Assuming a path separator of `/`, a first argument of `SRC_PATH` and second +argument of `DST_PATH`, the behavior is as follows: + +- `SRC_PATH` specifies a file + - `DST_PATH` does not exist + - the file is saved to a file created at `DST_PATH` + - `DST_PATH` does not exist and ends with `/` + - Error condition: the destination directory must exist. + - `DST_PATH` exists and is a file + - the destination is overwritten with the contents of the source file + - `DST_PATH` exists and is a directory + - the file is copied into this directory using the basename from + `SRC_PATH` +- `SRC_PATH` specifies a directory + - `DST_PATH` does not exist + - `DST_PATH` is created as a directory and the *contents* of the source + directory are copied into this directory + - `DST_PATH` exists and is a file + - Error condition: cannot copy a directory to a file + - `DST_PATH` exists and is a directory + - `SRC_PATH` does not end with `/.` + - the source directory is copied into this directory + - `SRC_PATH` does end with `/.` + - the *content* of the source directory is copied into this + directory + +The command requires `SRC_PATH` and `DST_PATH` to exist according to the above +rules. If `SRC_PATH` is local and is a symbolic link, the symbolic link, not +the target, is copied. + +A colon (`:`) is used as a delimiter between `CONTAINER` and `PATH`, but `:` +could also be in a valid `LOCALPATH`, like `file:name.txt`. This ambiguity is +resolved by requiring a `LOCALPATH` with a `:` to be made explicit with a +relative or absolute path, for example: + + `/path/to/file:name.txt` or `./file:name.txt` + +It is not possible to copy certain system files such as resources under +`/proc`, `/sys`, `/dev`, and mounts created by the user in the container. + +Using `-` as the first argument in place of a `LOCALPATH` will stream the +contents of `STDIN` as a tar archive which will be extracted to the `PATH` in +the filesystem of the destination container. In this case, `PATH` must specify +a directory. + +Using `-` as the second argument in place of a `LOCALPATH` will stream the +contents of the resource from the source container as a tar archive to +`STDOUT`. diff --git a/docs/reference/commandline/create.md b/docs/reference/commandline/create.md new file mode 100644 index 0000000000..88f3235af8 --- /dev/null +++ b/docs/reference/commandline/create.md @@ -0,0 +1,121 @@ + + +# create + +Creates a new container. + + Usage: docker create [OPTIONS] IMAGE [COMMAND] [ARG...] + + Create a new container + + -a, --attach=[] Attach to STDIN, STDOUT or STDERR + --add-host=[] Add a custom host-to-IP mapping (host:ip) + --blkio-weight=0 Block IO weight (relative weight) + --cpu-shares=0 CPU shares (relative weight) + --cap-add=[] Add Linux capabilities + --cap-drop=[] Drop Linux capabilities + --cgroup-parent="" Optional parent cgroup for the container + --cidfile="" Write the container ID to the file + --cpu-period=0 Limit CPU CFS (Completely Fair Scheduler) period + --cpu-quota=0 Limit CPU CFS (Completely Fair Scheduler) quota + --cpuset-cpus="" CPUs in which to allow execution (0-3, 0,1) + --cpuset-mems="" Memory nodes (MEMs) in which to allow execution (0-3, 0,1) + --device=[] Add a host device to the container + --disable-content-trust=true Skip image verification + --dns=[] Set custom DNS servers + --dns-opt=[] Set custom DNS options + --dns-search=[] Set custom DNS search domains + -e, --env=[] Set environment variables + --entrypoint="" Overwrite the default ENTRYPOINT of the image + --env-file=[] Read in a file of environment variables + --expose=[] Expose a port or a range of ports + --group-add=[] Add additional groups to join + -h, --hostname="" Container host name + --help=false Print usage + -i, --interactive=false Keep STDIN open even if not attached + --ipc="" IPC namespace to use + --kernel-memory="" Kernel memory limit + -l, --label=[] Set metadata on the container (e.g., --label=com.example.key=value) + --label-file=[] Read in a line delimited file of labels + --link=[] Add link to another container + --log-driver="" Logging driver for container + --log-opt=[] Log driver specific options + --lxc-conf=[] Add custom lxc options + -m, --memory="" Memory limit + --mac-address="" Container MAC address (e.g. 92:d0:c6:0a:29:33) + --memory-reservation="" Memory soft limit + --memory-swap="" Total memory (memory + swap), '-1' to disable swap + --memory-swappiness="" Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. + --name="" Assign a name to the container + --net="default" Set the Network mode for the container + --oom-kill-disable=false Whether to disable OOM Killer for the container or not + -P, --publish-all=false Publish all exposed ports to random ports + -p, --publish=[] Publish a container's port(s) to the host + --pid="" PID namespace to use + --privileged=false Give extended privileges to this container + --read-only=false Mount the container's root filesystem as read only + --restart="no" Restart policy (no, on-failure[:max-retry], always, unless-stopped) + --security-opt=[] Security options + --stop-signal="SIGTERM" Signal to stop a container + -t, --tty=false Allocate a pseudo-TTY + -u, --user="" Username or UID + --ulimit=[] Ulimit options + --uts="" UTS namespace to use + -v, --volume=[] Bind mount a volume + --volumes-from=[] Mount volumes from the specified container(s) + -w, --workdir="" Working directory inside the container + +The `docker create` command creates a writeable container layer over the +specified image and prepares it for running the specified command. The +container ID is then printed to `STDOUT`. This is similar to `docker run -d` +except the container is never started. You can then use the +`docker start ` command to start the container at any point. + +This is useful when you want to set up a container configuration ahead of time +so that it is ready to start when you need it. The initial status of the +new container is `created`. + +Please see the [run command](run.md) section and the [Docker run reference](../run.md) for more details. + +## Examples + + $ docker create -t -i fedora bash + 6d8af538ec541dd581ebc2a24153a28329acb5268abe5ef868c1f1a261221752 + $ docker start -a -i 6d8af538ec5 + bash-4.2# + +As of v1.4.0 container volumes are initialized during the `docker create` phase +(i.e., `docker run` too). For example, this allows you to `create` the `data` +volume container, and then use it from another container: + + $ docker create -v /data --name data ubuntu + 240633dfbb98128fa77473d3d9018f6123b99c454b3251427ae190a7d951ad57 + $ docker run --rm --volumes-from data ubuntu ls -la /data + total 8 + drwxr-xr-x 2 root root 4096 Dec 5 04:10 . + drwxr-xr-x 48 root root 4096 Dec 5 04:11 .. + +Similarly, `create` a host directory bind mounted volume container, which can +then be used from the subsequent container: + + $ docker create -v /home/docker:/docker --name docker ubuntu + 9aa88c08f319cd1e4515c3c46b0de7cc9aa75e878357b1e96f91e2c773029f03 + $ docker run --rm --volumes-from docker ubuntu ls -la /docker + total 20 + drwxr-sr-x 5 1000 staff 180 Dec 5 04:00 . + drwxr-xr-x 48 root root 4096 Dec 5 04:13 .. + -rw-rw-r-- 1 1000 staff 3833 Dec 5 04:01 .ash_history + -rw-r--r-- 1 1000 staff 446 Nov 28 11:51 .ashrc + -rw-r--r-- 1 1000 staff 25 Dec 5 04:00 .gitconfig + drwxr-sr-x 3 1000 staff 60 Dec 1 03:28 .local + -rw-r--r-- 1 1000 staff 920 Nov 28 11:51 .profile + drwx--S--- 2 1000 staff 460 Dec 5 00:51 .ssh + drwxr-xr-x 32 1000 staff 1140 Dec 5 04:01 docker diff --git a/docs/reference/commandline/daemon.md b/docs/reference/commandline/daemon.md new file mode 100644 index 0000000000..123389659c --- /dev/null +++ b/docs/reference/commandline/daemon.md @@ -0,0 +1,604 @@ + + +# daemon + + Usage: docker daemon [OPTIONS] + + A self-sufficient runtime for linux containers. + + Options: + --api-cors-header="" Set CORS headers in the remote API + -b, --bridge="" Attach containers to a network bridge + --bip="" Specify network bridge IP + -D, --debug=false Enable debug mode + --default-gateway="" Container default gateway IPv4 address + --default-gateway-v6="" Container default gateway IPv6 address + --cluster-store="" URL of the distributed storage backend + --cluster-advertise="" Address of the daemon instance on the cluster + --cluster-store-opt=map[] Set cluster options + --dns=[] DNS server to use + --dns-opt=[] DNS options to use + --dns-search=[] DNS search domains to use + --default-ulimit=[] Set default ulimit settings for containers + -e, --exec-driver="native" Exec driver to use + --exec-opt=[] Set exec driver options + --exec-root="/var/run/docker" Root of the Docker execdriver + --fixed-cidr="" IPv4 subnet for fixed IPs + --fixed-cidr-v6="" IPv6 subnet for fixed IPs + -G, --group="docker" Group for the unix socket + -g, --graph="/var/lib/docker" Root of the Docker runtime + -H, --host=[] Daemon socket(s) to connect to + --help=false Print usage + --icc=true Enable inter-container communication + --insecure-registry=[] Enable insecure registry communication + --ip=0.0.0.0 Default IP when binding container ports + --ip-forward=true Enable net.ipv4.ip_forward + --ip-masq=true Enable IP masquerading + --iptables=true Enable addition of iptables rules + --ipv6=false Enable IPv6 networking + -l, --log-level="info" Set the logging level + --label=[] Set key=value labels to the daemon + --log-driver="json-file" Default driver for container logs + --log-opt=[] Log driver specific options + --mtu=0 Set the containers network MTU + --disable-legacy-registry=false Do not contact legacy registries + -p, --pidfile="/var/run/docker.pid" Path to use for daemon PID file + --registry-mirror=[] Preferred Docker registry mirror + -s, --storage-driver="" Storage driver to use + --selinux-enabled=false Enable selinux support + --storage-opt=[] Set storage driver options + --tls=false Use TLS; implied by --tlsverify + --tlscacert="~/.docker/ca.pem" Trust certs signed only by this CA + --tlscert="~/.docker/cert.pem" Path to TLS certificate file + --tlskey="~/.docker/key.pem" Path to TLS key file + --tlsverify=false Use TLS and verify the remote + --userland-proxy=true Use userland proxy for loopback traffic + +Options with [] may be specified multiple times. + +The Docker daemon is the persistent process that manages containers. Docker +uses the same binary for both the daemon and client. To run the daemon you +type `docker daemon`. + +To run the daemon with debug output, use `docker daemon -D`. + +## Daemon socket option + +The Docker daemon can listen for [Docker Remote API](../api/docker_remote_api.md) +requests via three different types of Socket: `unix`, `tcp`, and `fd`. + +By default, a `unix` domain socket (or IPC socket) is created at +`/var/run/docker.sock`, requiring either `root` permission, or `docker` group +membership. + +If you need to access the Docker daemon remotely, you need to enable the `tcp` +Socket. Beware that the default setup provides un-encrypted and +un-authenticated direct access to the Docker daemon - and should be secured +either using the [built in HTTPS encrypted socket](../../articles/https/), or by +putting a secure web proxy in front of it. You can listen on port `2375` on all +network interfaces with `-H tcp://0.0.0.0:2375`, or on a particular network +interface using its IP address: `-H tcp://192.168.59.103:2375`. It is +conventional to use port `2375` for un-encrypted, and port `2376` for encrypted +communication with the daemon. + +> **Note:** +> If you're using an HTTPS encrypted socket, keep in mind that only +> TLS1.0 and greater are supported. Protocols SSLv3 and under are not +> supported anymore for security reasons. + +On Systemd based systems, you can communicate with the daemon via +[Systemd socket activation](http://0pointer.de/blog/projects/socket-activation.html), +use `docker daemon -H fd://`. Using `fd://` will work perfectly for most setups but +you can also specify individual sockets: `docker daemon -H fd://3`. If the +specified socket activated files aren't found, then Docker will exit. You can +find examples of using Systemd socket activation with Docker and Systemd in the +[Docker source tree](https://github.com/docker/docker/tree/master/contrib/init/systemd/). + +You can configure the Docker daemon to listen to multiple sockets at the same +time using multiple `-H` options: + + # listen using the default unix socket, and on 2 specific IP addresses on this host. + docker daemon -H unix:///var/run/docker.sock -H tcp://192.168.59.106 -H tcp://10.10.10.2 + +The Docker client will honor the `DOCKER_HOST` environment variable to set the +`-H` flag for the client. + + $ docker -H tcp://0.0.0.0:2375 ps + # or + $ export DOCKER_HOST="tcp://0.0.0.0:2375" + $ docker ps + # both are equal + +Setting the `DOCKER_TLS_VERIFY` environment variable to any value other than +the empty string is equivalent to setting the `--tlsverify` flag. The following +are equivalent: + + $ docker --tlsverify ps + # or + $ export DOCKER_TLS_VERIFY=1 + $ docker ps + +The Docker client will honor the `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` +environment variables (or the lowercase versions thereof). `HTTPS_PROXY` takes +precedence over `HTTP_PROXY`. + +### Daemon storage-driver option + +The Docker daemon has support for several different image layer storage +drivers: `aufs`, `devicemapper`, `btrfs`, `zfs` and `overlay`. + +The `aufs` driver is the oldest, but is based on a Linux kernel patch-set that +is unlikely to be merged into the main kernel. These are also known to cause +some serious kernel crashes. However, `aufs` is also the only storage driver +that allows containers to share executable and shared library memory, so is a +useful choice when running thousands of containers with the same program or +libraries. + +The `devicemapper` driver uses thin provisioning and Copy on Write (CoW) +snapshots. For each devicemapper graph location – typically +`/var/lib/docker/devicemapper` – a thin pool is created based on two block +devices, one for data and one for metadata. By default, these block devices +are created automatically by using loopback mounts of automatically created +sparse files. Refer to [Storage driver options](#storage-driver-options) below +for a way how to customize this setup. +[~jpetazzo/Resizing Docker containers with the Device Mapper plugin](http://jpetazzo.github.io/2014/01/29/docker-device-mapper-resize/) +article explains how to tune your existing setup without the use of options. + +The `btrfs` driver is very fast for `docker build` - but like `devicemapper` +does not share executable memory between devices. Use +`docker daemon -s btrfs -g /mnt/btrfs_partition`. + +The `zfs` driver is probably not fast as `btrfs` but has a longer track record +on stability. Thanks to `Single Copy ARC` shared blocks between clones will be +cached only once. Use `docker daemon -s zfs`. To select a different zfs filesystem +set `zfs.fsname` option as described in [Storage driver options](#storage-driver-options). + +The `overlay` is a very fast union filesystem. It is now merged in the main +Linux kernel as of [3.18.0](https://lkml.org/lkml/2014/10/26/137). Call +`docker daemon -s overlay` to use it. + +> **Note:** +> As promising as `overlay` is, the feature is still quite young and should not +> be used in production. Most notably, using `overlay` can cause excessive +> inode consumption (especially as the number of images grows), as well as +> being incompatible with the use of RPMs. + +> **Note:** +> It is currently unsupported on `btrfs` or any Copy on Write filesystem +> and should only be used over `ext4` partitions. + +### Storage driver options + +Particular storage-driver can be configured with options specified with +`--storage-opt` flags. Options for `devicemapper` are prefixed with `dm` and +options for `zfs` start with `zfs`. + +* `dm.thinpooldev` + + Specifies a custom block storage device to use for the thin pool. + + If using a block device for device mapper storage, it is best to use `lvm` + to create and manage the thin-pool volume. This volume is then handed to Docker + to exclusively create snapshot volumes needed for images and containers. + + Managing the thin-pool outside of Docker makes for the most feature-rich + method of having Docker utilize device mapper thin provisioning as the + backing storage for Docker's containers. The highlights of the lvm-based + thin-pool management feature include: automatic or interactive thin-pool + resize support, dynamically changing thin-pool features, automatic thinp + metadata checking when lvm activates the thin-pool, etc. + + As a fallback if no thin pool is provided, loopback files will be + created. Loopback is very slow, but can be used without any + pre-configuration of storage. It is strongly recommended that you do + not use loopback in production. Ensure your Docker daemon has a + `--storage-opt dm.thinpooldev` argument provided. + + Example use: + + $ docker daemon \ + --storage-opt dm.thinpooldev=/dev/mapper/thin-pool + +* `dm.basesize` + + Specifies the size to use when creating the base device, which limits the + size of images and containers. The default value is 100G. Note, thin devices + are inherently "sparse", so a 100G device which is mostly empty doesn't use + 100 GB of space on the pool. However, the filesystem will use more space for + the empty case the larger the device is. + + This value affects the system-wide "base" empty filesystem + that may already be initialized and inherited by pulled images. Typically, + a change to this value requires additional steps to take effect: + + $ sudo service docker stop + $ sudo rm -rf /var/lib/docker + $ sudo service docker start + + Example use: + + $ docker daemon --storage-opt dm.basesize=20G + +* `dm.loopdatasize` + + > **Note**: + > This option configures devicemapper loopback, which should not + > be used in production. + + Specifies the size to use when creating the loopback file for the + "data" device which is used for the thin pool. The default size is + 100G. The file is sparse, so it will not initially take up this + much space. + + Example use: + + $ docker daemon --storage-opt dm.loopdatasize=200G + +* `dm.loopmetadatasize` + + > **Note**: + > This option configures devicemapper loopback, which should not + > be used in production. + + Specifies the size to use when creating the loopback file for the + "metadata" device which is used for the thin pool. The default size + is 2G. The file is sparse, so it will not initially take up + this much space. + + Example use: + + $ docker daemon --storage-opt dm.loopmetadatasize=4G + +* `dm.fs` + + Specifies the filesystem type to use for the base device. The supported + options are "ext4" and "xfs". The default is "xfs" + + Example use: + + $ docker daemon --storage-opt dm.fs=ext4 + +* `dm.mkfsarg` + + Specifies extra mkfs arguments to be used when creating the base device. + + Example use: + + $ docker daemon --storage-opt "dm.mkfsarg=-O ^has_journal" + +* `dm.mountopt` + + Specifies extra mount options used when mounting the thin devices. + + Example use: + + $ docker daemon --storage-opt dm.mountopt=nodiscard + +* `dm.datadev` + + (Deprecated, use `dm.thinpooldev`) + + Specifies a custom blockdevice to use for data for the thin pool. + + If using a block device for device mapper storage, ideally both datadev and + metadatadev should be specified to completely avoid using the loopback + device. + + Example use: + + $ docker daemon \ + --storage-opt dm.datadev=/dev/sdb1 \ + --storage-opt dm.metadatadev=/dev/sdc1 + +* `dm.metadatadev` + + (Deprecated, use `dm.thinpooldev`) + + Specifies a custom blockdevice to use for metadata for the thin pool. + + For best performance the metadata should be on a different spindle than the + data, or even better on an SSD. + + If setting up a new metadata pool it is required to be valid. This can be + achieved by zeroing the first 4k to indicate empty metadata, like this: + + $ dd if=/dev/zero of=$metadata_dev bs=4096 count=1 + + Example use: + + $ docker daemon \ + --storage-opt dm.datadev=/dev/sdb1 \ + --storage-opt dm.metadatadev=/dev/sdc1 + +* `dm.blocksize` + + Specifies a custom blocksize to use for the thin pool. The default + blocksize is 64K. + + Example use: + + $ docker daemon --storage-opt dm.blocksize=512K + +* `dm.blkdiscard` + + Enables or disables the use of blkdiscard when removing devicemapper + devices. This is enabled by default (only) if using loopback devices and is + required to resparsify the loopback file on image/container removal. + + Disabling this on loopback can lead to *much* faster container removal + times, but will make the space used in `/var/lib/docker` directory not be + returned to the system for other use when containers are removed. + + Example use: + + $ docker daemon --storage-opt dm.blkdiscard=false + +* `dm.override_udev_sync_check` + + Overrides the `udev` synchronization checks between `devicemapper` and `udev`. + `udev` is the device manager for the Linux kernel. + + To view the `udev` sync support of a Docker daemon that is using the + `devicemapper` driver, run: + + $ docker info + [...] + Udev Sync Supported: true + [...] + + When `udev` sync support is `true`, then `devicemapper` and udev can + coordinate the activation and deactivation of devices for containers. + + When `udev` sync support is `false`, a race condition occurs between + the`devicemapper` and `udev` during create and cleanup. The race condition + results in errors and failures. (For information on these failures, see + [docker#4036](https://github.com/docker/docker/issues/4036)) + + To allow the `docker` daemon to start, regardless of `udev` sync not being + supported, set `dm.override_udev_sync_check` to true: + + $ docker daemon --storage-opt dm.override_udev_sync_check=true + + When this value is `true`, the `devicemapper` continues and simply warns + you the errors are happening. + + > **Note:** + > The ideal is to pursue a `docker` daemon and environment that does + > support synchronizing with `udev`. For further discussion on this + > topic, see [docker#4036](https://github.com/docker/docker/issues/4036). + > Otherwise, set this flag for migrating existing Docker daemons to + > a daemon with a supported environment. + +* `dm.use_deferred_removal` + + Enables use of deferred device removal if `libdm` and the kernel driver + support the mechanism. + + Deferred device removal means that if device is busy when devices are + being removed/deactivated, then a deferred removal is scheduled on + device. And devices automatically go away when last user of the device + exits. + + For example, when a container exits, its associated thin device is removed. + If that device has leaked into some other mount namespace and can't be + removed, the container exit still succeeds and this option causes the + system to schedule the device for deferred removal. It does not wait in a + loop trying to remove a busy device. + + Example use: + + $ docker daemon --storage-opt dm.use_deferred_removal=true + +* `dm.use_deferred_deletion` + + Enables use of deferred device deletion for thin pool devices. By default, + thin pool device deletion is synchronous. Before a container is deleted, + the Docker daemon removes any associated devices. If the storage driver + can not remove a device, the container deletion fails and daemon returns. + + Error deleting container: Error response from daemon: Cannot destroy container + + To avoid this failure, enable both deferred device deletion and deferred + device removal on the daemon. + + $ docker daemon \ + --storage-opt dm.use_deferred_deletion=true \ + --storage-opt dm.use_deferred_removal=true + + With these two options enabled, if a device is busy when the driver is + deleting a container, the driver marks the device as deleted. Later, when + the device isn't in use, the driver deletes it. + + In general it should be safe to enable this option by default. It will help + when unintentional leaking of mount point happens across multiple mount + namespaces. + +Currently supported options of `zfs`: + +* `zfs.fsname` + + Set zfs filesystem under which docker will create its own datasets. + By default docker will pick up the zfs filesystem where docker graph + (`/var/lib/docker`) is located. + + Example use: + + $ docker daemon -s zfs --storage-opt zfs.fsname=zroot/docker + +## Docker execdriver option + +The Docker daemon uses a specifically built `libcontainer` execution driver as +its interface to the Linux kernel `namespaces`, `cgroups`, and `SELinux`. + +There is still legacy support for the original [LXC userspace tools]( +https://linuxcontainers.org/) via the `lxc` execution driver, however, this is +not where the primary development of new functionality is taking place. +Add `-e lxc` to the daemon flags to use the `lxc` execution driver. + +## Options for the native execdriver + +You can configure the `native` (libcontainer) execdriver using options specified +with the `--exec-opt` flag. All the flag's options have the `native` prefix. A +single `native.cgroupdriver` option is available. + +The `native.cgroupdriver` option specifies the management of the container's +cgroups. You can specify `cgroupfs` or `systemd`. If you specify `systemd` and +it is not available, the system uses `cgroupfs`. By default, if no option is +specified, the execdriver first tries `systemd` and falls back to `cgroupfs`. +This example sets the execdriver to `cgroupfs`: + + $ sudo docker daemon --exec-opt native.cgroupdriver=cgroupfs + +Setting this option applies to all containers the daemon launches. + +## Daemon DNS options + +To set the DNS server for all Docker containers, use +`docker daemon --dns 8.8.8.8`. + +To set the DNS search domain for all Docker containers, use +`docker daemon --dns-search example.com`. + +## Insecure registries + +Docker considers a private registry either secure or insecure. In the rest of +this section, *registry* is used for *private registry*, and `myregistry:5000` +is a placeholder example for a private registry. + +A secure registry uses TLS and a copy of its CA certificate is placed on the +Docker host at `/etc/docker/certs.d/myregistry:5000/ca.crt`. An insecure +registry is either not using TLS (i.e., listening on plain text HTTP), or is +using TLS with a CA certificate not known by the Docker daemon. The latter can +happen when the certificate was not found under +`/etc/docker/certs.d/myregistry:5000/`, or if the certificate verification +failed (i.e., wrong CA). + +By default, Docker assumes all, but local (see local registries below), +registries are secure. Communicating with an insecure registry is not possible +if Docker assumes that registry is secure. In order to communicate with an +insecure registry, the Docker daemon requires `--insecure-registry` in one of +the following two forms: + +* `--insecure-registry myregistry:5000` tells the Docker daemon that + myregistry:5000 should be considered insecure. +* `--insecure-registry 10.1.0.0/16` tells the Docker daemon that all registries + whose domain resolve to an IP address is part of the subnet described by the + CIDR syntax, should be considered insecure. + +The flag can be used multiple times to allow multiple registries to be marked +as insecure. + +If an insecure registry is not marked as insecure, `docker pull`, +`docker push`, and `docker search` will result in an error message prompting +the user to either secure or pass the `--insecure-registry` flag to the Docker +daemon as described above. + +Local registries, whose IP address falls in the 127.0.0.0/8 range, are +automatically marked as insecure as of Docker 1.3.2. It is not recommended to +rely on this, as it may change in the future. + +Enabling `--insecure-registry`, i.e., allowing un-encrypted and/or untrusted +communication, can be useful when running a local registry. However, +because its use creates security vulnerabilities it should ONLY be enabled for +testing purposes. For increased security, users should add their CA to their +system's list of trusted CAs instead of enabling `--insecure-registry`. + +## Legacy Registries + +Enabling `--disable-legacy-registry` forces a docker daemon to only interact with registries which support the V2 protocol. Specifically, the daemon will not attempt `push`, `pull` and `login` to v1 registries. The exception to this is `search` which can still be performed on v1 registries. + +## Running a Docker daemon behind a HTTPS_PROXY + +When running inside a LAN that uses a `HTTPS` proxy, the Docker Hub +certificates will be replaced by the proxy's certificates. These certificates +need to be added to your Docker host's configuration: + +1. Install the `ca-certificates` package for your distribution +2. Ask your network admin for the proxy's CA certificate and append them to + `/etc/pki/tls/certs/ca-bundle.crt` +3. Then start your Docker daemon with `HTTPS_PROXY=http://username:password@proxy:port/ docker daemon`. + The `username:` and `password@` are optional - and are only needed if your + proxy is set up to require authentication. + +This will only add the proxy and authentication to the Docker daemon's requests - +your `docker build`s and running containers will need extra configuration to +use the proxy + +## Default Ulimits + +`--default-ulimit` allows you to set the default `ulimit` options to use for +all containers. It takes the same options as `--ulimit` for `docker run`. If +these defaults are not set, `ulimit` settings will be inherited, if not set on +`docker run`, from the Docker daemon. Any `--ulimit` options passed to +`docker run` will overwrite these defaults. + +Be careful setting `nproc` with the `ulimit` flag as `nproc` is designed by Linux to +set the maximum number of processes available to a user, not to a container. For details +please check the [run](run.md) reference. + +## Nodes discovery + +The `--cluster-advertise` option specifies the 'host:port' or `interface:port` +combination that this particular daemon instance should use when advertising +itself to the cluster. The daemon is reached by remote hosts through this value. +If you specify an interface, make sure it includes the IP address of the actual +Docker host. For Engine installation created through `docker-machine`, the +interface is typically `eth1`. + +The daemon uses [libkv](https://github.com/docker/libkv/) to advertise +the node within the cluster. Some key-value backends support mutual +TLS. To configure the client TLS settings used by the daemon can be configured +using the `--cluster-store-opt` flag, specifying the paths to PEM encoded +files. For example: + +```bash +docker daemon \ + --cluster-advertise 192.168.1.2:2376 \ + --cluster-store etcd://192.168.1.2:2379 \ + --cluster-store-opt kv.cacertfile=/path/to/ca.pem \ + --cluster-store-opt kv.certfile=/path/to/cert.pem \ + --cluster-store-opt kv.keyfile=/path/to/key.pem +``` + +The currently supported cluster store options are: + +* `kv.cacertfile` + + Specifies the path to a local file with PEM encoded CA certificates to trust + +* `kv.certfile` + + Specifies the path to a local file with a PEM encoded certificate. This + certificate is used as the client cert for communication with the + Key/Value store. + +* `kv.keyfile` + + Specifies the path to a local file with a PEM encoded private key. This + private key is used as the client key for communication with the + Key/Value store. + + +## Miscellaneous options + +IP masquerading uses address translation to allow containers without a public +IP to talk to other machines on the Internet. This may interfere with some +network topologies and can be disabled with `--ip-masq=false`. + +Docker supports softlinks for the Docker data directory (`/var/lib/docker`) and +for `/var/lib/docker/tmp`. The `DOCKER_TMPDIR` and the data directory can be +set like this: + + DOCKER_TMPDIR=/mnt/disk2/tmp /usr/local/bin/docker daemon -D -g /var/lib/docker -H unix:// > /var/lib/docker-machine/docker.log 2>&1 + # or + export DOCKER_TMPDIR=/mnt/disk2/tmp + /usr/local/bin/docker daemon -D -g /var/lib/docker -H unix:// > /var/lib/docker-machine/docker.log 2>&1 diff --git a/docs/reference/commandline/diff.md b/docs/reference/commandline/diff.md new file mode 100644 index 0000000000..17e870d35f --- /dev/null +++ b/docs/reference/commandline/diff.md @@ -0,0 +1,40 @@ + + +# diff + + Usage: docker diff [OPTIONS] CONTAINER + + Inspect changes on a container's filesystem + + --help=false Print usage + +List the changed files and directories in a container᾿s filesystem + There are 3 events that are listed in the `diff`: + +1. `A` - Add +2. `D` - Delete +3. `C` - Change + +For example: + + $ docker diff 7bb0e258aefe + + C /dev + A /dev/kmsg + C /etc + A /etc/mtab + A /go + A /go/src + A /go/src/github.com + A /go/src/github.com/docker + A /go/src/github.com/docker/docker + A /go/src/github.com/docker/docker/.git + .... diff --git a/docs/reference/commandline/docker_images.gif b/docs/reference/commandline/docker_images.gif new file mode 100644 index 0000000000000000000000000000000000000000..5894ca270e002758b8f332141e00356e42868880 GIT binary patch literal 35785 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 ++++ +title = "events" +description = "The events command description and usage" +keywords = ["events, container, report"] +[menu.main] +parent = "smn_cli" ++++ + + +# events + + Usage: docker events [OPTIONS] + + Get real time events from the server + + -f, --filter=[] Filter output based on conditions provided + --help=false Print usage + --since="" Show all events created since timestamp + --until="" Stream events until this timestamp + +Docker containers will report the following events: + + attach, commit, copy, create, destroy, die, exec_create, exec_start, export, kill, oom, pause, rename, resize, restart, start, stop, top, unpause + +and Docker images will report: + + delete, import, pull, push, tag, untag + +The `--since` and `--until` parameters can be Unix timestamps, RFC3339 +dates or Go duration strings (e.g. `10m`, `1h30m`) computed relative to +client machine’s time. If you do not provide the --since option, the command +returns only new and/or live events. + +## Filtering + +The filtering flag (`-f` or `--filter`) format is of "key=value". If you would +like to use multiple filters, pass multiple flags (e.g., +`--filter "foo=bar" --filter "bif=baz"`) + +Using the same filter multiple times will be handled as a *OR*; for example +`--filter container=588a23dac085 --filter container=a8f7720b8c22` will display +events for container 588a23dac085 *OR* container a8f7720b8c22 + +Using multiple filters will be handled as a *AND*; for example +`--filter container=588a23dac085 --filter event=start` will display events for +container container 588a23dac085 *AND* the event type is *start* + +The currently supported filters are: + +* container (`container=`) +* event (`event=`) +* image (`image=`) +* label (`label=` or `label==`) + +## Examples + +You'll need two shells for this example. + +**Shell 1: Listening for events:** + + $ docker events + +**Shell 2: Start and Stop containers:** + + $ docker start 4386fb97867d + $ docker stop 4386fb97867d + $ docker stop 7805c1d35632 + +**Shell 1: (Again .. now showing events):** + + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) start + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + +**Show events in the past from a specified time:** + + $ docker events --since 1378216169 + 2014-03-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-03-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + + $ docker events --since '2013-09-03' + 2014-09-03T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) start + 2014-09-03T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-09-03T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + + $ docker events --since '2013-09-03T15:49:29' + 2014-09-03T15:49:29.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-09-03T15:49:29.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + +This example outputs all events that were generated in the last 3 minutes, +relative to the current time on the client machine: + + $ docker events --since '3m' + 2015-05-12T11:51:30.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2015-05-12T15:52:12.999999999Z07:00 4 4386fb97867d: (from ubuntu-1:14.04) stop + 2015-05-12T15:53:45.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2015-05-12T15:54:03.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + +**Filter events:** + + $ docker events --filter 'event=stop' + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-09-03T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + + $ docker events --filter 'image=ubuntu-1:14.04' + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) start + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + + $ docker events --filter 'container=7805c1d35632' + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-09-03T15:49:29.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + + $ docker events --filter 'container=7805c1d35632' --filter 'container=4386fb97867d' + 2014-09-03T15:49:29.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-09-03T15:49:29.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + + $ docker events --filter 'container=7805c1d35632' --filter 'event=stop' + 2014-09-03T15:49:29.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + + $ docker events --filter 'container=container_1' --filter 'container=container_2' + 2014-09-03T15:49:29.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2014-05-10T17:42:14.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) stop + 2014-05-10T17:42:14.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2014-09-03T15:49:29.999999999Z07:00 7805c1d35632: (from redis:2.8) stop diff --git a/docs/reference/commandline/exec.md b/docs/reference/commandline/exec.md new file mode 100644 index 0000000000..658292679f --- /dev/null +++ b/docs/reference/commandline/exec.md @@ -0,0 +1,55 @@ + + +# exec + + Usage: docker exec [OPTIONS] CONTAINER COMMAND [ARG...] + + Run a command in a running container + + -d, --detach=false Detached mode: run command in the background + --help=false Print usage + -i, --interactive=false Keep STDIN open even if not attached + --privileged=false Give extended Linux capabilities to the command + -t, --tty=false Allocate a pseudo-TTY + -u, --user= Username or UID (format: [:]) + +The `docker exec` command runs a new command in a running container. + +The command started using `docker exec` only runs while the container's primary +process (`PID 1`) is running, and it is not restarted if the container is +restarted. + +If the container is paused, then the `docker exec` command will fail with an error: + + $ docker pause test + test + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 1ae3b36715d2 ubuntu:latest "bash" 17 seconds ago Up 16 seconds (Paused) test + $ docker exec test ls + FATA[0000] Error response from daemon: Container test is paused, unpause the container before exec + $ echo $? + 1 + +## Examples + + $ docker run --name ubuntu_bash --rm -i -t ubuntu bash + +This will create a container named `ubuntu_bash` and start a Bash session. + + $ docker exec -d ubuntu_bash touch /tmp/execWorks + +This will create a new file `/tmp/execWorks` inside the running container +`ubuntu_bash`, in the background. + + $ docker exec -it ubuntu_bash bash + +This will create a new Bash session in the container `ubuntu_bash`. diff --git a/docs/reference/commandline/export.md b/docs/reference/commandline/export.md new file mode 100644 index 0000000000..96bf544733 --- /dev/null +++ b/docs/reference/commandline/export.md @@ -0,0 +1,35 @@ + + +# export + + Usage: docker export [OPTIONS] CONTAINER + + Export the contents of a container's filesystem as a tar archive + + --help=false Print usage + -o, --output="" Write to a file, instead of STDOUT + +The `docker export` command does not export the contents of volumes associated +with the container. If a volume is mounted on top of an existing directory in +the container, `docker export` will export the contents of the *underlying* +directory, not the contents of the volume. + +Refer to [Backup, restore, or migrate data +volumes](../../userguide/dockervolumes.md#backup-restore-or-migrate-data-volumes) in +the user guide for examples on exporting data in a volume. + +## Examples + + $ docker export red_panda > latest.tar + +Or + + $ docker export --output="latest.tar" red_panda diff --git a/docs/reference/commandline/history.md b/docs/reference/commandline/history.md new file mode 100644 index 0000000000..43edf34620 --- /dev/null +++ b/docs/reference/commandline/history.md @@ -0,0 +1,40 @@ + + +# history + + Usage: docker history [OPTIONS] IMAGE + + Show the history of an image + + -H, --human=true Print sizes and dates in human readable format + --help=false Print usage + --no-trunc=false Don't truncate output + -q, --quiet=false Only show numeric IDs + +To see how the `docker:latest` image was built: + + $ docker history docker + IMAGE CREATED CREATED BY SIZE COMMENT + 3e23a5875458 8 days ago /bin/sh -c #(nop) ENV LC_ALL=C.UTF-8 0 B + 8578938dd170 8 days ago /bin/sh -c dpkg-reconfigure locales && loc 1.245 MB + be51b77efb42 8 days ago /bin/sh -c apt-get update && apt-get install 338.3 MB + 4b137612be55 6 weeks ago /bin/sh -c #(nop) ADD jessie.tar.xz in / 121 MB + 750d58736b4b 6 weeks ago /bin/sh -c #(nop) MAINTAINER Tianon Gravi ++++ +title = "images" +description = "The images command description and usage" +keywords = ["list, docker, images"] +[menu.main] +parent = "smn_cli" ++++ + + +# images + + Usage: docker images [OPTIONS] [REPOSITORY[:TAG]] + + List images + + -a, --all=false Show all images (default hides intermediate images) + --digests=false Show digests + -f, --filter=[] Filter output based on conditions provided + --help=false Print usage + --no-trunc=false Don't truncate output + -q, --quiet=false Only show numeric IDs + +The default `docker images` will show all top level +images, their repository and tags, and their virtual size. + +Docker images have intermediate layers that increase reusability, +decrease disk usage, and speed up `docker build` by +allowing each step to be cached. These intermediate layers are not shown +by default. + +The `VIRTUAL SIZE` is the cumulative space taken up by the image and all +its parent images. This is also the disk space used by the contents of the +Tar file created when you `docker save` an image. + +An image will be listed more than once if it has multiple repository names +or tags. This single image (identifiable by its matching `IMAGE ID`) +uses up the `VIRTUAL SIZE` listed only once. + +### Listing the most recently created images + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + 77af4d6b9913 19 hours ago 1.089 GB + committ latest b6fa739cedf5 19 hours ago 1.089 GB + 78a85c484f71 19 hours ago 1.089 GB + docker latest 30557a29d5ab 20 hours ago 1.089 GB + 5ed6274db6ce 24 hours ago 1.089 GB + postgres 9 746b819f315e 4 days ago 213.4 MB + postgres 9.3 746b819f315e 4 days ago 213.4 MB + postgres 9.3.5 746b819f315e 4 days ago 213.4 MB + postgres latest 746b819f315e 4 days ago 213.4 MB + +### Listing images by name and tag + +The `docker images` command takes an optional `[REPOSITORY[:TAG]]` argument +that restricts the list to images that match the argument. If you specify +`REPOSITORY`but no `TAG`, the `docker images` command lists all images in the +given repository. + +For example, to list all images in the "java" repository, run this command : + + $ docker images java + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + java 8 308e519aac60 6 days ago 824.5 MB + java 7 493d82594c15 3 months ago 656.3 MB + java latest 2711b1d6f3aa 5 months ago 603.9 MB + +The `[REPOSITORY[:TAG]]` value must be an "exact match". This means that, for example, +`docker images jav` does not match the image `java`. + +If both `REPOSITORY` and `TAG` are provided, only images matching that +repository and tag are listed. To find all local images in the "java" +repository with tag "8" you can use: + + $ docker images java:8 + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + java 8 308e519aac60 6 days ago 824.5 MB + +If nothing matches `REPOSITORY[:TAG]`, the list is empty. + + $ docker images java:0 + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + +## Listing the full length image IDs + + $ docker images --no-trunc + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + 77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB + committest latest b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB + 78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB + docker latest 30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB + 0124422dd9f9cf7ef15c0617cda3931ee68346455441d66ab8bdc5b05e9fdce5 20 hours ago 1.089 GB + 18ad6fad340262ac2a636efd98a6d1f0ea775ae3d45240d3418466495a19a81b 22 hours ago 1.082 GB + f9f1e26352f0a3ba6a0ff68167559f64f3e21ff7ada60366e2d44a04befd1d3a 23 hours ago 1.089 GB + tryout latest 2629d1fa0b81b222fca63371ca16cbf6a0772d07759ff80e8d1369b926940074 23 hours ago 131.5 MB + 5ed6274db6ceb2397844896966ea239290555e74ef307030ebb01ff91b1914df 24 hours ago 1.089 GB + +## Listing image digests + +Images that use the v2 or later format have a content-addressable identifier +called a `digest`. As long as the input used to generate the image is +unchanged, the digest value is predictable. To list image digest values, use +the `--digests` flag: + + $ docker images --digests + REPOSITORY TAG DIGEST IMAGE ID CREATED VIRTUAL SIZE + localhost:5000/test/busybox sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB + +When pushing or pulling to a 2.0 registry, the `push` or `pull` command +output includes the image digest. You can `pull` using a digest value. You can +also reference by digest in `create`, `run`, and `rmi` commands, as well as the +`FROM` image reference in a Dockerfile. + +## Filtering + +The filtering flag (`-f` or `--filter`) format is of "key=value". If there is more +than one filter, then pass multiple flags (e.g., `--filter "foo=bar" --filter "bif=baz"`) + +The currently supported filters are: + +* dangling (boolean - true or false) +* label (`label=` or `label==`) + +##### Untagged images (dangling) + + $ docker images --filter "dangling=true" + + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + 8abc22fbb042 4 weeks ago 0 B + 48e5f45168b9 4 weeks ago 2.489 MB + bf747efa0e2f 4 weeks ago 0 B + 980fe10e5736 12 weeks ago 101.4 MB + dea752e4e117 12 weeks ago 101.4 MB + 511136ea3c5a 8 months ago 0 B + +This will display untagged images, that are the leaves of the images tree (not +intermediary layers). These images occur when a new build of an image takes the +`repo:tag` away from the image ID, leaving it untagged. A warning will be issued +if trying to remove an image when a container is presently using it. +By having this flag it allows for batch cleanup. + +Ready for use by `docker rmi ...`, like: + + $ docker rmi $(docker images -f "dangling=true" -q) + + 8abc22fbb042 + 48e5f45168b9 + bf747efa0e2f + 980fe10e5736 + dea752e4e117 + 511136ea3c5a + +NOTE: Docker will warn you if any containers exist that are using these untagged images. + + +##### Labeled images + +The `label` filter matches images based on the presence of a `label` alone or a `label` and a +value. + +The following filter matches images with the `com.example.version` label regardless of its value. + + $ docker images --filter "label=com.example.version" + + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + match-me-1 latest eeae25ada2aa About a minute ago 188.3 MB + match-me-2 latest eeae25ada2aa About a minute ago 188.3 MB + +The following filter matches images with the `com.example.version` label with the `1.0` value. + + $ docker images --filter "label=com.example.version=1.0" + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + match-me latest eeae25ada2aa About a minute ago 188.3 MB + +In this example, with the `0.1` value, it returns an empty set because no matches were found. + + $ docker images --filter "label=com.example.version=0.1" + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE diff --git a/docs/reference/commandline/import.md b/docs/reference/commandline/import.md new file mode 100644 index 0000000000..4881f016da --- /dev/null +++ b/docs/reference/commandline/import.md @@ -0,0 +1,69 @@ + + +# import + + Usage: docker import file|URL|- [REPOSITORY[:TAG]] + + Create an empty filesystem image and import the contents of the + tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then + optionally tag it. + + -c, --change=[] Apply specified Dockerfile instructions while importing the image + --help=false Print usage + -m, --message= Set commit message for imported image + +You can specify a `URL` or `-` (dash) to take data directly from `STDIN`. The +`URL` can point to an archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, or .txz) +containing a filesystem or to an individual file on the Docker host. If you +specify an archive, Docker untars it in the container relative to the `/` +(root). If you specify an individual file, you must specify the full path within +the host. To import from a remote location, specify a `URI` that begins with the +`http://` or `https://` protocol. + +The `--change` option will apply `Dockerfile` instructions to the image +that is created. +Supported `Dockerfile` instructions: +`CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR` + +## Examples + +**Import from a remote location:** + +This will create a new untagged image. + + $ docker import http://example.com/exampleimage.tgz + +**Import from a local file:** + +Import to docker via pipe and `STDIN`. + + $ cat exampleimage.tgz | docker import - exampleimagelocal:new + +Import with a commit message + + $ cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new + +Import to docker from a local archive. + + $ docker import /path/to/exampleimage.tgz + +**Import from a local directory:** + + $ sudo tar -c . | docker import - exampleimagedir + +**Import from a local directory with new configurations:** + + $ sudo tar -c . | docker import --change "ENV DEBUG true" - exampleimagedir + +Note the `sudo` in this example – you must preserve +the ownership of the files (especially root ownership) during the +archiving with tar. If you are not root (or the sudo command) when you +tar, then the ownerships might not get preserved. diff --git a/docs/reference/commandline/index.md b/docs/reference/commandline/index.md new file mode 100644 index 0000000000..ef99b91168 --- /dev/null +++ b/docs/reference/commandline/index.md @@ -0,0 +1,85 @@ + + + +# The Docker commands + +This section contains reference information on using Docker's command line client. Each command has a reference page along with samples. If you are unfamiliar with the command line, you should start by reading about how to ["Use the Docker command line"](cli.md). + +You start the Docker daemon with the command line. How you start the daemon affects your Docker containers. For that reason you should also make sure to read the [`daemon`](daemon.md) reference page. + +### Docker management commands + +* [daemon](daemon.md) +* [info](info.md) +* [inspect](inspect.md) +* [version](version.md) + +### Image commands + +* [build](build.md) +* [commit](commit.md) +* [export](export.md) +* [history](history.md) +* [images](images.md) +* [import](import.md) +* [load](load.md) +* [rmi](rmi.md) +* [save](save.md) +* [tag](tag.md) + +### Container commands + +* [attach](attach.md) +* [cp](cp.md) +* [create](create.md) +* [diff](diff.md) +* [events](events.md) +* [exec](exec.md) +* [kill](kill.md) +* [logs](logs.md) +* [pause](pause.md) +* [port](port.md) +* [ps](ps.md) +* [rename](rename.md) +* [restart](restart.md) +* [rm](rm.md) +* [run](run.md) +* [start](start.md) +* [stats](stats.md) +* [stop](stop.md) +* [top](top.md) +* [unpause](unpause.md) +* [wait](wait.md) + +### Hub and registry commands + +* [login](login.md) +* [logout](logout.md) +* [pull](pull.md) +* [push](push.md) +* [search](search.md) + +### Network and connectivity commands + +* [network_connect](network_connect.md) +* [network_create](network_create.md) +* [network_disconnect](network_disconnect.md) +* [network_inspect](network_inspect.md) +* [network_ls](network_ls.md) +* [network_rm](network_rm.md) + +### Shared data volume commands + +* [volume_create](volume_create.md) +* [volume_inspect](volume_inspect.md) +* [volume_ls](volume_ls.md) +* [volume_rm](volume_rm.md) diff --git a/docs/reference/commandline/info.md b/docs/reference/commandline/info.md new file mode 100644 index 0000000000..1794df40b5 --- /dev/null +++ b/docs/reference/commandline/info.md @@ -0,0 +1,58 @@ + + +# info + + + Usage: docker info [OPTIONS] + + Display system-wide information + + --help=false Print usage + +For example: + + $ docker -D info + Containers: 14 + Images: 52 + Server Version: 1.9.0 + Storage Driver: aufs + Root Dir: /var/lib/docker/aufs + Backing Filesystem: extfs + Dirs: 545 + Dirperm1 Supported: true + Execution Driver: native-0.2 + Logging Driver: json-file + Kernel Version: 3.19.0-22-generic + Operating System: Ubuntu 15.04 + CPUs: 24 + Total Memory: 62.86 GiB + Name: docker + ID: I54V:OLXT:HVMM:TPKO:JPHQ:CQCD:JNLC:O3BZ:4ZVJ:43XJ:PFHZ:6N2S + Debug mode (server): true + File Descriptors: 59 + Goroutines: 159 + System Time: 2015-09-23T14:04:20.699842089+08:00 + EventsListeners: 0 + Init SHA1: + Init Path: /usr/bin/docker + Docker Root Dir: /var/lib/docker + Http Proxy: http://test:test@localhost:8080 + Https Proxy: https://test:test@localhost:8080 + WARNING: No swap limit support + Username: svendowideit + Registry: [https://index.docker.io/v1/] + Labels: + storage=ssd + +The global `-D` option tells all `docker` commands to output debug information. + +When sending issue reports, please use `docker version` and `docker -D info` to +ensure we know how your setup is configured. diff --git a/docs/reference/commandline/inspect.md b/docs/reference/commandline/inspect.md new file mode 100644 index 0000000000..6620163f70 --- /dev/null +++ b/docs/reference/commandline/inspect.md @@ -0,0 +1,75 @@ + + +# inspect + + Usage: docker inspect [OPTIONS] CONTAINER|IMAGE [CONTAINER|IMAGE...] + + Return low-level information on a container or image + + -f, --format="" Format the output using the given go template + --help=false Print usage + --type=container|image Return JSON for specified type, permissible + values are "image" or "container" + -s, --size=false Display total file sizes if the type is container + +By default, this will render all results in a JSON array. If a format is +specified, the given template will be executed for each result. + +Go's [text/template](http://golang.org/pkg/text/template/) package +describes all the details of the format. + +## Examples + +**Get an instance's IP address:** + +For the most part, you can pick out any field from the JSON in a fairly +straightforward manner. + + $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $INSTANCE_ID + +**Get an instance's MAC Address:** + +For the most part, you can pick out any field from the JSON in a fairly +straightforward manner. + + $ docker inspect '{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}' $INSTANCE_ID + +**Get an instance's log path:** + + $ docker inspect --format='{{.LogPath}}' $INSTANCE_ID + +**List All Port Bindings:** + +One can loop over arrays and maps in the results to produce simple text +output: + + $ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID + +**Find a Specific Port Mapping:** + +The `.Field` syntax doesn't work when the field name begins with a +number, but the template language's `index` function does. The +`.NetworkSettings.Ports` section contains a map of the internal port +mappings to a list of external address/port objects. To grab just the +numeric public port, you use `index` to find the specific port map, and +then `index` 0 contains the first object inside of that. Then we ask for +the `HostPort` field to get the public address. + + $ docker inspect --format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID + +**Get config:** + +The `.Field` syntax doesn't work when the field contains JSON data, but +the template language's custom `json` function does. The `.config` +section contains complex JSON object, so to grab it as JSON, you use +`json` to convert the configuration object into JSON. + + $ docker inspect --format='{{json .config}}' $INSTANCE_ID diff --git a/docs/reference/commandline/kill.md b/docs/reference/commandline/kill.md new file mode 100644 index 0000000000..dabbabbe77 --- /dev/null +++ b/docs/reference/commandline/kill.md @@ -0,0 +1,26 @@ + + +# kill + + Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...] + + Kill a running container using SIGKILL or a specified signal + + --help=false Print usage + -s, --signal="KILL" Signal to send to the container + +The main process inside the container will be sent `SIGKILL`, or any +signal specified with option `--signal`. + +> **Note:** +> `ENTRYPOINT` and `CMD` in the *shell* form run as a subcommand of `/bin/sh -c`, +> which does not pass signals. This means that the executable is not the container’s PID 1 +> and does not receive Unix signals. diff --git a/docs/reference/commandline/load.md b/docs/reference/commandline/load.md new file mode 100644 index 0000000000..3a183f38e2 --- /dev/null +++ b/docs/reference/commandline/load.md @@ -0,0 +1,36 @@ + + +# load + + Usage: docker load [OPTIONS] + + Load an image from a tar archive or STDIN + + --help=false Print usage + -i, --input="" Read from a tar archive file, instead of STDIN. The tarball may be compressed with gzip, bzip, or xz + +Loads a tarred repository from a file or the standard input stream. +Restores both images and tags. + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + $ docker load < busybox.tar.gz + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + busybox latest 769b9341d937 7 weeks ago 2.489 MB + $ docker load --input fedora.tar + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + busybox latest 769b9341d937 7 weeks ago 2.489 MB + fedora rawhide 0d20aec6529d 7 weeks ago 387 MB + fedora 20 58394af37342 7 weeks ago 385.5 MB + fedora heisenbug 58394af37342 7 weeks ago 385.5 MB + fedora latest 58394af37342 7 weeks ago 385.5 MB diff --git a/docs/reference/commandline/login.md b/docs/reference/commandline/login.md new file mode 100644 index 0000000000..6361d99f58 --- /dev/null +++ b/docs/reference/commandline/login.md @@ -0,0 +1,27 @@ + + +# login + + Usage: docker login [OPTIONS] [SERVER] + + Register or log in to a Docker registry server, if no server is + specified "https://index.docker.io/v1/" is the default. + + -e, --email="" Email + --help=false Print usage + -p, --password="" Password + -u, --username="" Username + +If you want to login to a self-hosted registry you can specify this by +adding the server name. + + example: + $ docker login localhost:8080 diff --git a/docs/reference/commandline/logout.md b/docs/reference/commandline/logout.md new file mode 100644 index 0000000000..36c85453f2 --- /dev/null +++ b/docs/reference/commandline/logout.md @@ -0,0 +1,22 @@ + + +# logout + + Usage: docker logout [SERVER] + + Log out from a Docker registry, if no server is + specified "https://index.docker.io/v1/" is the default. + + --help=false Print usage + +For example: + + $ docker logout localhost:8080 diff --git a/docs/reference/commandline/logs.md b/docs/reference/commandline/logs.md new file mode 100644 index 0000000000..27d68ead87 --- /dev/null +++ b/docs/reference/commandline/logs.md @@ -0,0 +1,43 @@ + + +# logs + + Usage: docker logs [OPTIONS] CONTAINER + + Fetch the logs of a container + + -f, --follow=false Follow log output + --help=false Print usage + --since="" Show logs since timestamp + -t, --timestamps=false Show timestamps + --tail="all" Number of lines to show from the end of the logs + +> **Note**: this command is available only for containers with `json-file` and +> `journald` logging drivers. + +The `docker logs` command batch-retrieves logs present at the time of execution. + +The `docker logs --follow` command will continue streaming the new output from +the container's `STDOUT` and `STDERR`. + +Passing a negative number or a non-integer to `--tail` is invalid and the +value is set to `all` in that case. + +The `docker logs --timestamp` commands will add an [RFC3339Nano timestamp](https://golang.org/pkg/time/#pkg-constants) +, for example `2014-09-16T06:17:46.000000000Z`, to each +log entry. To ensure that the timestamps for are aligned the +nano-second part of the timestamp will be padded with zero when necessary. + +The `--since` option shows only the container logs generated after +a given date. You can specify the date as an RFC 3339 date, a UNIX +timestamp, or a Go duration string (e.g. `1m30s`, `3h`). Docker computes +the date relative to the client machine’s time. You can combine +the `--since` option with either or both of the `--follow` or `--tail` options. diff --git a/docs/reference/commandline/network_connect.md b/docs/reference/commandline/network_connect.md new file mode 100644 index 0000000000..b3b5773457 --- /dev/null +++ b/docs/reference/commandline/network_connect.md @@ -0,0 +1,55 @@ + + +# network connect + + Usage: docker network connect [OPTIONS] NETWORK CONTAINER + + Connects a container to a network + + --help=false Print usage + +Connects a running container to a network. You can connect a container by name +or by ID. Once connected, the container can communicate with other containers in +the same network. + +```bash +$ docker network connect multi-host-network container1 +``` + +You can also use the `docker run --net=` option to start a container and immediately connect it to a network. + +```bash +$ docker run -itd --net=multi-host-network busybox +``` + +You can pause, restart, and stop containers that are connected to a network. +Paused containers remain connected and a revealed by a `network inspect`. When +the container is stopped, it does not appear on the network until you restart +it. The container's IP address is not guaranteed to remain the same when a +stopped container rejoins the network. + +To verify the container is connected, use the `docker network inspect` command. Use `docker network disconnect` to remove a container from the network. + +Once connected in network, containers can communicate using only another +container's IP address or name. For `overlay` networks or custom plugins that +support multi-host connectivity, containers connected to the same multi-host +network but launched from different Engines can also communicate in this way. + +You can connect a container to one or more networks. The networks need not be the same type. For example, you can connect a single container bridge and overlay networks. + +## Related information + +* [network inspect](network_inspect.md) +* [network create](network_create.md) +* [network disconnect](network_disconnect.md) +* [network ls](network_ls.md) +* [network rm](network_rm.md) +* [Understand Docker container networks](../../userguide/networking/dockernetworks.md) diff --git a/docs/reference/commandline/network_create.md b/docs/reference/commandline/network_create.md new file mode 100644 index 0000000000..4b794d8940 --- /dev/null +++ b/docs/reference/commandline/network_create.md @@ -0,0 +1,130 @@ + + +# network create + + Usage: docker network create [OPTIONS] NETWORK-NAME + + Creates a new network with a name specified by the user + + --aux-address=map[] Auxiliary ipv4 or ipv6 addresses used by network driver + -d --driver=DRIVER Driver to manage the Network bridge or overlay. The default is bridge. + --gateway=[] ipv4 or ipv6 Gateway for the master subnet + --help=false Print usage + --ip-range=[] Allocate container ip from a sub-range + --ipam-driver=default IP Address Management Driver + -o --opt=map[] Set custom network plugin options + --subnet=[] Subnet in CIDR format that represents a network segment + +Creates a new network. The `DRIVER` accepts `bridge` or `overlay` which are the +built-in network drivers. If you have installed a third party or your own custom +network driver you can specify that `DRIVER` here also. If you don't specify the +`--driver` option, the command automatically creates a `bridge` network for you. +When you install Docker Engine it creates a `bridge` network automatically. This +network corresponds to the `docker0` bridge that Engine has traditionally relied +on. When launch a new container with `docker run` it automatically connects to +this bridge network. You cannot remove this default bridge network but you can +create new ones using the `network create` command. + +```bash +$ docker network create -d bridge my-bridge-network +``` + +Bridge networks are isolated networks on a single Engine installation. If you +want to create a network that spans multiple Docker hosts each running an +Engine, you must create an `overlay` network. Unlike `bridge` networks overlay +networks require some pre-existing conditions before you can create one. These +conditions are: + +* Access to a key-value store. Engine supports Consul, Etcd, and ZooKeeper (Distributed store) key-value stores. +* A cluster of hosts with connectivity to the key-value store. +* A properly configured Engine `daemon` on each host in the cluster. + +The `docker daemon` options that support the `overlay` network are: + +* `--cluster-store` +* `--cluster-store-opt` +* `--cluster-advertise` + +To read more about these options and how to configure them, see ["*Get started +with multi-host network*"](../../userguide/networking/get-started-overlay.md). + +It is also a good idea, though not required, that you install Docker Swarm on to +manage the cluster that makes up your network. Swarm provides sophisticated +discovery and server management that can assist your implementation. + +Once you have prepared the `overlay` network prerequisites you simply choose a +Docker host in the cluster and issue the following to create the network: + +```bash +$ docker network create -d overlay my-multihost-network +``` + +Network names must be unique. The Docker daemon attempts to identify naming +conflicts but this is not guaranteed. It is the user's responsibility to avoid +name conflicts. + +## Connect containers + +When you start a container use the `--net` flag to connect it to a network. +This adds the `busybox` container to the `mynet` network. + +```bash +$ docker run -itd --net=mynet busybox +``` + +If you want to add a container to a network after the container is already +running use the `docker network connect` subcommand. + +You can connect multiple containers to the same network. Once connected, the +containers can communicate using only another container's IP address or name. +For `overlay` networks or custom plugins that support multi-host connectivity, +containers connected to the same multi-host network but launched from different +Engines can also communicate in this way. + +You can disconnect a container from a network using the `docker network +disconnect` command. + +## Specifying advanced options + +When you create a network, Engine creates a non-overlapping subnetwork for the network by default. This subnetwork is not a subdivision of an existing network. It is purely for ip-addressing purposes. You can override this default and specify subnetwork values directly using the the `--subnet` option. On a `bridge` network you can only create a single subnet: + +```bash +docker network create -d --subnet=192.168.0.0/16 +``` +Additionally, you also specify the `--gateway` `--ip-range` and `--aux-address` options. + +```bash +network create --driver=bridge --subnet=172.28.0.0/16 --ip-range=172.28.5.0/24 --gateway=172.28.5.254 br0 +``` + +If you omit the `--gateway` flag the Engine selects one for you from inside a +preferred pool. For `overlay` networks and for network driver plugins that +support it you can create multiple subnetworks. + +```bash +docker network create -d overlay + --subnet=192.168.0.0/16 --subnet=192.170.0.0/16 + --gateway=192.168.0.100 --gateway=192.170.0.100 + --ip-range=192.168.1.0/24 + --aux-address a=192.168.1.5 --aux-address b=192.168.1.6 + --aux-address a=192.170.1.5 --aux-address b=192.170.1.6 + my-multihost-newtork +``` +Be sure that your subnetworks do not overlap. If they do, the network create fails and Engine returns an error. + +## Related information + +* [network inspect](network_inspect.md) +* [network connect](network_connect.md) +* [network disconnect](network_disconnect.md) +* [network ls](network_ls.md) +* [network rm](network_rm.md) +* [Understand Docker container networks](../../userguide/networking/dockernetworks.md) diff --git a/docs/reference/commandline/network_disconnect.md b/docs/reference/commandline/network_disconnect.md new file mode 100644 index 0000000000..bbb351d24f --- /dev/null +++ b/docs/reference/commandline/network_disconnect.md @@ -0,0 +1,33 @@ + + +# network disconnect + + Usage: docker network disconnect [OPTIONS] NETWORK CONTAINER + + Disconnects a container from a network + + --help=false Print usage + +Disconnects a container from a network. The container must be running to disconnect it from the network. + +```bash + $ docker network disconnect multi-host-network container1 +``` + + +## Related information + +* [network inspect](network_inspect.md) +* [network connect](network_connect.md) +* [network create](network_create.md) +* [network ls](network_ls.md) +* [network rm](network_rm.md) +* [Understand Docker container networks](../../userguide/networking/dockernetworks.md) diff --git a/docs/reference/commandline/network_inspect.md b/docs/reference/commandline/network_inspect.md new file mode 100644 index 0000000000..aedf5c41cc --- /dev/null +++ b/docs/reference/commandline/network_inspect.md @@ -0,0 +1,64 @@ + + +# network inspect + + Usage: docker network inspect [OPTIONS] NETWORK [NETWORK..] + + Displays detailed information on a network + + --help=false Print usage + +Returns information about one or more networks. By default, this command renders all results in a JSON object. For example, if you connect two containers to a network: + +```bash +$ sudo docker run -itd --name=container1 busybox +f2870c98fd504370fb86e59f32cd0753b1ac9b69b7d80566ffc7192a82b3ed27 + +$ sudo docker run -itd --name=container2 busybox +bda12f8922785d1f160be70736f26c1e331ab8aaf8ed8d56728508f2e2fd4727 +``` + +The `network inspect` command shows the containers, by id, in its results. + +```bash +$ sudo docker network inspect bridge +[ + { + "name": "bridge", + "id": "7fca4eb8c647e57e9d46c32714271e0c3f8bf8d17d346629e2820547b2d90039", + "driver": "bridge", + "containers": { + "bda12f8922785d1f160be70736f26c1e331ab8aaf8ed8d56728508f2e2fd4727": { + "endpoint": "e0ac95934f803d7e36384a2029b8d1eeb56cb88727aa2e8b7edfeebaa6dfd758", + "mac_address": "02:42:ac:11:00:03", + "ipv4_address": "172.17.0.3/16", + "ipv6_address": "" + }, + "f2870c98fd504370fb86e59f32cd0753b1ac9b69b7d80566ffc7192a82b3ed27": { + "endpoint": "31de280881d2a774345bbfb1594159ade4ae4024ebfb1320cb74a30225f6a8ae", + "mac_address": "02:42:ac:11:00:02", + "ipv4_address": "172.17.0.2/16", + "ipv6_address": "" + } + } + } +] +``` + + +## Related information + +* [network disconnect ](network_disconnect.md) +* [network connect](network_connect.md) +* [network create](network_create.md) +* [network ls](network_ls.md) +* [network rm](network_rm.md) +* [Understand Docker container networks](../../userguide/networking/dockernetworks.md) diff --git a/docs/reference/commandline/network_ls.md b/docs/reference/commandline/network_ls.md new file mode 100644 index 0000000000..9b4dbddc83 --- /dev/null +++ b/docs/reference/commandline/network_ls.md @@ -0,0 +1,51 @@ + + +# docker network ls + + Usage: docker network ls [OPTIONS] + + Lists all the networks created by the user + --help=false Print usage + --no-trunc=false Do not truncate the output + -q, --quiet=false Only display numeric IDs + +Lists all the networks the Engine `daemon` knows about. This includes the +networks that span across multiple hosts in a cluster, for example: + +```bash + $ sudo docker network ls + NETWORK ID NAME DRIVER + 7fca4eb8c647 bridge bridge + 9f904ee27bf5 none null + cf03ee007fb4 host host + 78b03ee04fc4 multi-host overlay +``` + +Use the `--no-trunc` option to display the full network id: + +```bash +docker network ls --no-trunc +NETWORK ID NAME DRIVER +18a2866682b85619a026c81b98a5e375bd33e1b0936a26cc497c283d27bae9b3 none null +c288470c46f6c8949c5f7e5099b5b7947b07eabe8d9a27d79a9cbf111adcbf47 host host +7b369448dccbf865d397c8d2be0cda7cf7edc6b0945f77d2529912ae917a0185 bridge bridge +95e74588f40db048e86320c6526440c504650a1ff3e9f7d60a497c4d2163e5bd foo bridge +``` + + +## Related information + +* [network disconnect ](network_disconnect.md) +* [network connect](network_connect.md) +* [network create](network_create.md) +* [network inspect](network_inspect.md) +* [network rm](network_rm.md) +* [Understand Docker container networks](../../userguide/networking/dockernetworks.md) diff --git a/docs/reference/commandline/network_rm.md b/docs/reference/commandline/network_rm.md new file mode 100644 index 0000000000..ef79fcac84 --- /dev/null +++ b/docs/reference/commandline/network_rm.md @@ -0,0 +1,32 @@ + + +# network rm + + Usage: docker network rm [OPTIONS] NAME | ID + + Deletes a network + + --help=false Print usage + +Removes a network by name or identifier. To remove a network, you must first disconnect any containers connected to it. + +```bash + $ docker network rm my-network +``` + +## Related information + +* [network disconnect ](network_disconnect.md) +* [network connect](network_connect.md) +* [network create](network_create.md) +* [network ls](network_ls.md) +* [network inspect](network_inspect.md) +* [Understand Docker container networks](../../userguide/networking/dockernetworks.md) diff --git a/docs/reference/commandline/pause.md b/docs/reference/commandline/pause.md new file mode 100644 index 0000000000..0e109478d9 --- /dev/null +++ b/docs/reference/commandline/pause.md @@ -0,0 +1,27 @@ + + +# pause + + Usage: docker pause [OPTIONS] CONTAINER [CONTAINER...] + + Pause all processes within a container + + --help=false Print usage + +The `docker pause` command uses the cgroups freezer to suspend all processes in +a container. Traditionally, when suspending a process the `SIGSTOP` signal is +used, which is observable by the process being suspended. With the cgroups freezer +the process is unaware, and unable to capture, that it is being suspended, +and subsequently resumed. + +See the +[cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) +for further details. diff --git a/docs/reference/commandline/port.md b/docs/reference/commandline/port.md new file mode 100644 index 0000000000..9fd6e8870b --- /dev/null +++ b/docs/reference/commandline/port.md @@ -0,0 +1,34 @@ + + +# port + + Usage: docker port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]] + + List port mappings for the CONTAINER, or lookup the public-facing port that is + NAT-ed to the PRIVATE_PORT + + --help=false Print usage + +You can find out all the ports mapped by not specifying a `PRIVATE_PORT`, or +just a specific mapping: + + $ docker ps test + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + b650456536c7 busybox:latest top 54 minutes ago Up 54 minutes 0.0.0.0:1234->9876/tcp, 0.0.0.0:4321->7890/tcp test + $ docker port test + 7890/tcp -> 0.0.0.0:4321 + 9876/tcp -> 0.0.0.0:1234 + $ docker port test 7890/tcp + 0.0.0.0:4321 + $ docker port test 7890/udp + 2014/06/24 11:53:36 Error: No public port '7890/udp' published for test + $ docker port test 7890 + 0.0.0.0:4321 diff --git a/docs/reference/commandline/ps.md b/docs/reference/commandline/ps.md new file mode 100644 index 0000000000..0d67da9c0a --- /dev/null +++ b/docs/reference/commandline/ps.md @@ -0,0 +1,199 @@ + + +# ps + + Usage: docker ps [OPTIONS] + + List containers + + -a, --all=false Show all containers (default shows just running) + --before="" Show only container created before Id or Name + -f, --filter=[] Filter output based on conditions provided + --format=[] Pretty-print containers using a Go template + --help=false Print usage + -l, --latest=false Show the latest created container, include non-running + -n=-1 Show n last created containers, include non-running + --no-trunc=false Don't truncate output + -q, --quiet=false Only display numeric IDs + -s, --size=false Display total file sizes + --since="" Show created since Id or Name, include non-running + +Running `docker ps --no-trunc` showing 2 linked containers. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds 3300-3310/tcp webapp + d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db + +`docker ps` will show only running containers by default. To see all containers: +`docker ps -a` + +`docker ps` will group exposed ports into a single range if possible. E.g., a container that exposes TCP ports `100, 101, 102` will display `100-102/tcp` in the `PORTS` column. + +## Filtering + +The filtering flag (`-f` or `--filter`) format is a `key=value` pair. If there is more +than one filter, then pass multiple flags (e.g. `--filter "foo=bar" --filter "bif=baz"`) + +The currently supported filters are: + +* id (container's id) +* label (`label=` or `label==`) +* name (container's name) +* exited (int - the code of exited containers. Only useful with `--all`) +* status (created|restarting|running|paused|exited) +* ancestor (`[:]`, `` or ``) - filters containers that were created from the given image or a descendant. + + +#### Label + +The `label` filter matches containers based on the presence of a `label` alone or a `label` and a +value. + +The following filter matches containers with the `color` label regardless of its value. + + $ docker ps --filter "label=color" + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 673394ef1d4c busybox "top" 47 seconds ago Up 45 seconds nostalgic_shockley + d85756f57265 busybox "top" 52 seconds ago Up 51 seconds high_albattani + +The following filter matches containers with the `color` label with the `blue` value. + + $ docker ps --filter "label=color=blue" + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + d85756f57265 busybox "top" About a minute ago Up About a minute high_albattani + +#### Name + +The `name` filter matches on all or part of a container's name. + +The following filter matches all containers with a name containing the `nostalgic_stallman` string. + + $ docker ps --filter "name=nostalgic_stallman" + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 9b6247364a03 busybox "top" 2 minutes ago Up 2 minutes nostalgic_stallman + +You can also filter for a substring in a name as this shows: + + $ docker ps --filter "name=nostalgic" + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 715ebfcee040 busybox "top" 3 seconds ago Up 1 seconds i_am_nostalgic + 9b6247364a03 busybox "top" 7 minutes ago Up 7 minutes nostalgic_stallman + 673394ef1d4c busybox "top" 38 minutes ago Up 38 minutes nostalgic_shockley + +#### Exited + +The `exited` filter matches containers by exist status code. For example, to filter for containers +that have exited successfully: + + $ docker ps -a --filter 'exited=0' + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + ea09c3c82f6e registry:latest /srv/run.sh 2 weeks ago Exited (0) 2 weeks ago 127.0.0.1:5000->5000/tcp desperate_leakey + 106ea823fe4e fedora:latest /bin/sh -c 'bash -l' 2 weeks ago Exited (0) 2 weeks ago determined_albattani + 48ee228c9464 fedora:20 bash 2 weeks ago Exited (0) 2 weeks ago tender_torvalds + +#### Status + +The `status` filter matches containers by status. You can filter using `created`, `restarting`, `running`, `paused` and `exited`. For example, to filter for `running` containers: + + $ docker ps --filter status=running + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 715ebfcee040 busybox "top" 16 minutes ago Up 16 minutes i_am_nostalgic + d5c976d3c462 busybox "top" 23 minutes ago Up 23 minutes top + 9b6247364a03 busybox "top" 24 minutes ago Up 24 minutes nostalgic_stallman + +To filter for `paused` containers: + + $ docker ps --filter status=paused + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 673394ef1d4c busybox "top" About an hour ago Up About an hour (Paused) nostalgic_shockley + +#### Ancestor + +The `ancestor` filter matches containers based on its image or a descendant of it. The filter supports the +following image representation: + +- image +- image:tag +- image:tag@digest +- short-id +- full-id + +If you don't specify a `tag`, the `latest` tag is used. For example, to filter for containers that use the +latest `ubuntu` image: + + $ docker ps --filter ancestor=ubuntu + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 919e1179bdb8 ubuntu-c1 "top" About a minute ago Up About a minute admiring_lovelace + 5d1e4a540723 ubuntu-c2 "top" About a minute ago Up About a minute admiring_sammet + 82a598284012 ubuntu "top" 3 minutes ago Up 3 minutes sleepy_bose + bab2a34ba363 ubuntu "top" 3 minutes ago Up 3 minutes focused_yonath + +Match containers based on the `ubuntu-c1` image which, in this case, is a child of `ubuntu`: + + $ docker ps --filter ancestor=ubuntu-c1 + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 919e1179bdb8 ubuntu-c1 "top" About a minute ago Up About a minute admiring_lovelace + +Match containers based on the `ubuntu` version `12.04.5` image: + + $ docker ps --filter ancestor=ubuntu:12.04.5 + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 82a598284012 ubuntu:12.04.5 "top" 3 minutes ago Up 3 minutes sleepy_bose + +The following matches containers based on the layer `d0e008c6cf02` or an image that have this layer +in it's layer stack. + + $ docker ps --filter ancestor=d0e008c6cf02 + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 82a598284012 ubuntu:12.04.5 "top" 3 minutes ago Up 3 minutes sleepy_bose + + +## Formatting + +The formatting option (`--format`) will pretty-print container output using a Go template. + +Valid placeholders for the Go template are listed below: + +Placeholder | Description +---- | ---- +`.ID` | Container ID +`.Image` | Image ID +`.Command` | Quoted command +`.CreatedAt` | Time when the container was created. +`.RunningFor` | Elapsed time since the container was started. +`.Ports` | Exposed ports. +`.Status` | Container status. +`.Size` | Container disk size. +`.Names` | Container names. +`.Labels` | All labels assigned to the container. +`.Label` | Value of a specific label for this container. For example `{{.Label "com.docker.swarm.cpu"}}` + +When using the `--format` option, the `ps` command will either output the data exactly as the template +declares or, when using the `table` directive, will include column headers as well. + +The following example uses a template without headers and outputs the `ID` and `Command` +entries separated by a colon for all running containers: + + $ docker ps --format "{{.ID}}: {{.Command}}" + a87ecb4f327c: /bin/sh -c #(nop) MA + 01946d9d34d8: /bin/sh -c #(nop) MA + c1d3b0166030: /bin/sh -c yum -y up + 41d50ecd2f57: /bin/sh -c #(nop) MA + +To list all running containers with their labels in a table format you can use: + + $ docker ps --format "table {{.ID}}\t{{.Labels}}" + CONTAINER ID LABELS + a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd + 01946d9d34d8 + c1d3b0166030 com.docker.swarm.node=debian,com.docker.swarm.cpu=6 + 41d50ecd2f57 com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd diff --git a/docs/reference/commandline/pull.md b/docs/reference/commandline/pull.md new file mode 100644 index 0000000000..efcaed6125 --- /dev/null +++ b/docs/reference/commandline/pull.md @@ -0,0 +1,51 @@ + + +# pull + + Usage: docker pull [OPTIONS] NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG] + + Pull an image or a repository from the registry + + -a, --all-tags=false Download all tagged images in the repository + --disable-content-trust=true Skip image verification + --help=false Print usage + +Most of your images will be created on top of a base image from the +[Docker Hub](https://hub.docker.com) registry. + +[Docker Hub](https://hub.docker.com) contains many pre-built images that you +can `pull` and try without needing to define and configure your own. + +It is also possible to manually specify the path of a registry to pull from. +For example, if you have set up a local registry, you can specify its path to +pull from it. A repository path is similar to a URL, but does not contain +a protocol specifier (`https://`, for example). + +To download a particular image, or set of images (i.e., a repository), +use `docker pull`: + + $ docker pull debian + # will pull the debian:latest image and its intermediate layers + $ docker pull debian:testing + # will pull the image named debian:testing and any intermediate + # layers it is based on. + $ docker pull debian@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf + # will pull the image from the debian repository with the digest + # sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf + # and any intermediate layers it is based on. + # (Typically the empty `scratch` image, a MAINTAINER layer, + # and the un-tarred base). + $ docker pull --all-tags centos + # will pull all the images from the centos repository + $ docker pull registry.hub.docker.com/debian + # manually specifies the path to the default Docker registry. This could + # be replaced with the path to a local registry to pull from another source. + # sudo docker pull myhub.com:8080/test-image diff --git a/docs/reference/commandline/push.md b/docs/reference/commandline/push.md new file mode 100644 index 0000000000..cdc6ac2da8 --- /dev/null +++ b/docs/reference/commandline/push.md @@ -0,0 +1,21 @@ + + +# push + + Usage: docker push [OPTIONS] NAME[:TAG] + + Push an image or a repository to the registry + + --disable-content-trust=true Skip image signing + --help=false Print usage + +Use `docker push` to share your images to the [Docker Hub](https://hub.docker.com) +registry or to a self-hosted one. diff --git a/docs/reference/commandline/rename.md b/docs/reference/commandline/rename.md new file mode 100644 index 0000000000..667e0d84d9 --- /dev/null +++ b/docs/reference/commandline/rename.md @@ -0,0 +1,19 @@ + + +# rename + + Usage: docker rename [OPTIONS] OLD_NAME NEW_NAME + + Rename a container + + --help=false Print usage + +The `docker rename` command allows the container to be renamed to a different name. diff --git a/docs/reference/commandline/restart.md b/docs/reference/commandline/restart.md new file mode 100644 index 0000000000..61292d3a59 --- /dev/null +++ b/docs/reference/commandline/restart.md @@ -0,0 +1,18 @@ + + +# restart + + Usage: docker restart [OPTIONS] CONTAINER [CONTAINER...] + + Restart a container + + --help=false Print usage + -t, --time=10 Seconds to wait for stop before killing the container diff --git a/docs/reference/commandline/rm.md b/docs/reference/commandline/rm.md new file mode 100644 index 0000000000..943343a9a9 --- /dev/null +++ b/docs/reference/commandline/rm.md @@ -0,0 +1,47 @@ + + +# rm + + Usage: docker rm [OPTIONS] CONTAINER [CONTAINER...] + + Remove one or more containers + + -f, --force=false Force the removal of a running container (uses SIGKILL) + --help=false Print usage + -l, --link=false Remove the specified link + -v, --volumes=false Remove the volumes associated with the container + +## Examples + + $ docker rm /redis + /redis + +This will remove the container referenced under the link +`/redis`. + + $ docker rm --link /webapp/redis + /webapp/redis + +This will remove the underlying link between `/webapp` and the `/redis` +containers removing all network communication. + + $ docker rm --force redis + redis + +The main process inside the container referenced under the link `/redis` will receive +`SIGKILL`, then the container will be removed. + + $ docker rm $(docker ps -a -q) + +This command will delete all stopped containers. The command +`docker ps -a -q` will return all existing container IDs and pass them to +the `rm` command which will delete them. Any running containers will not be +deleted. diff --git a/docs/reference/commandline/rmi.md b/docs/reference/commandline/rmi.md new file mode 100644 index 0000000000..09cffd0d29 --- /dev/null +++ b/docs/reference/commandline/rmi.md @@ -0,0 +1,74 @@ + + +# rmi + + Usage: docker rmi [OPTIONS] IMAGE [IMAGE...] + + Remove one or more images + + -f, --force=false Force removal of the image + --help=false Print usage + --no-prune=false Do not delete untagged parents + +You can remove an image using its short or long ID, its tag, or its digest. If +an image has one or more tag or digest reference, you must remove all of them +before the image is removed. + + $ docker images + REPOSITORY TAG IMAGE ID CREATED SIZE + test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + + $ docker rmi fd484f19954f + Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories, use -f to force + 2013/12/11 05:47:16 Error: failed to remove one or more images + + $ docker rmi test1 + Untagged: test1:latest + $ docker rmi test2 + Untagged: test2:latest + + $ docker images + REPOSITORY TAG IMAGE ID CREATED SIZE + test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + $ docker rmi test + Untagged: test:latest + Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 + +If you use the `-f` flag and specify the image's short or long ID, then this +command untags and removes all images that match the specified ID. + + $ docker images + REPOSITORY TAG IMAGE ID CREATED SIZE + test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + + $ docker rmi -f fd484f19954f + Untagged: test1:latest + Untagged: test:latest + Untagged: test2:latest + Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 + +An image pulled by digest has no tag associated with it: + + $ docker images --digests + REPOSITORY TAG DIGEST IMAGE ID CREATED VIRTUAL SIZE + localhost:5000/test/busybox sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB + +To remove an image using its digest: + + $ docker rmi localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf + Untagged: localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf + Deleted: 4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125 + Deleted: ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2 + Deleted: df7546f9f060a2268024c8a230d8639878585defcc1bc6f79d2728a13957871b diff --git a/docs/reference/commandline/run.md b/docs/reference/commandline/run.md new file mode 100644 index 0000000000..5e7dd5dd9e --- /dev/null +++ b/docs/reference/commandline/run.md @@ -0,0 +1,542 @@ + + +# run + + Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...] + + Run a command in a new container + + -a, --attach=[] Attach to STDIN, STDOUT or STDERR + --add-host=[] Add a custom host-to-IP mapping (host:ip) + --blkio-weight=0 Block IO weight (relative weight) + --cpu-shares=0 CPU shares (relative weight) + --cap-add=[] Add Linux capabilities + --cap-drop=[] Drop Linux capabilities + --cgroup-parent="" Optional parent cgroup for the container + --cidfile="" Write the container ID to the file + --cpu-period=0 Limit CPU CFS (Completely Fair Scheduler) period + --cpu-quota=0 Limit CPU CFS (Completely Fair Scheduler) quota + --cpuset-cpus="" CPUs in which to allow execution (0-3, 0,1) + --cpuset-mems="" Memory nodes (MEMs) in which to allow execution (0-3, 0,1) + -d, --detach=false Run container in background and print container ID + --device=[] Add a host device to the container + --disable-content-trust=true Skip image verification + --dns=[] Set custom DNS servers + --dns-opt=[] Set custom DNS options + --dns-search=[] Set custom DNS search domains + -e, --env=[] Set environment variables + --entrypoint="" Overwrite the default ENTRYPOINT of the image + --env-file=[] Read in a file of environment variables + --expose=[] Expose a port or a range of ports + --group-add=[] Add additional groups to run as + -h, --hostname="" Container host name + --help=false Print usage + -i, --interactive=false Keep STDIN open even if not attached + --ipc="" IPC namespace to use + --kernel-memory="" Kernel memory limit + -l, --label=[] Set metadata on the container (e.g., --label=com.example.key=value) + --label-file=[] Read in a file of labels (EOL delimited) + --link=[] Add link to another container + --log-driver="" Logging driver for container + --log-opt=[] Log driver specific options + --lxc-conf=[] Add custom lxc options + -m, --memory="" Memory limit + --mac-address="" Container MAC address (e.g. 92:d0:c6:0a:29:33) + --memory-reservation="" Memory soft limit + --memory-swap="" Total memory (memory + swap), '-1' to disable swap + --memory-swappiness="" Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. + --name="" Assign a name to the container + --net="bridge" Connects a container to a network + 'bridge': creates a new network stack for the container on the docker bridge + 'none': no networking for this container + 'container:': reuses another container network stack + 'host': use the host network stack inside the container + 'NETWORK': connects the container to user-created network using `docker network create` command + --oom-kill-disable=false Whether to disable OOM Killer for the container or not + -P, --publish-all=false Publish all exposed ports to random ports + -p, --publish=[] Publish a container's port(s) to the host + --pid="" PID namespace to use + --privileged=false Give extended privileges to this container + --read-only=false Mount the container's root filesystem as read only + --restart="no" Restart policy (no, on-failure[:max-retry], always, unless-stopped) + --rm=false Automatically remove the container when it exits + --security-opt=[] Security Options + --sig-proxy=true Proxy received signals to the process + --stop-signal="SIGTERM" Signal to stop a container + -t, --tty=false Allocate a pseudo-TTY + -u, --user="" Username or UID (format: [:]) + --ulimit=[] Ulimit options + --uts="" UTS namespace to use + -v, --volume=[] Bind mount a volume + --volumes-from=[] Mount volumes from the specified container(s) + -w, --workdir="" Working directory inside the container + +The `docker run` command first `creates` a writeable container layer over the +specified image, and then `starts` it using the specified command. That is, +`docker run` is equivalent to the API `/containers/create` then +`/containers/(id)/start`. A stopped container can be restarted with all its +previous changes intact using `docker start`. See `docker ps -a` to view a list +of all containers. + +The `docker run` command can be used in combination with `docker commit` to +[*change the command that a container runs*](commit.md). There is additional detailed information about `docker run` in the [Docker run reference](../run.md). + +For information on connecting a container to a network, see the ["*Docker network overview*"](../../userguide/networking/index.md). + +## Examples + +### Assign name and allocate psuedo-TTY (--name, -it) + + $ docker run --name test -it debian + root@d6c0fe130dba:/# exit 13 + $ echo $? + 13 + $ docker ps -a | grep test + d6c0fe130dba debian:7 "/bin/bash" 26 seconds ago Exited (13) 17 seconds ago test + +This example runs a container named `test` using the `debian:latest` +image. The `-it` instructs Docker to allocate a pseudo-TTY connected to +the container's stdin; creating an interactive `bash` shell in the container. +In the example, the `bash` shell is quit by entering +`exit 13`. This exit code is passed on to the caller of +`docker run`, and is recorded in the `test` container's metadata. + +### Capture container ID (--cidfile) + + $ docker run --cidfile /tmp/docker_test.cid ubuntu echo "test" + +This will create a container and print `test` to the console. The `cidfile` +flag makes Docker attempt to create a new file and write the container ID to it. +If the file exists already, Docker will return an error. Docker will close this +file when `docker run` exits. + +### Full container capabilities (--privileged) + + $ docker run -t -i --rm ubuntu bash + root@bc338942ef20:/# mount -t tmpfs none /mnt + mount: permission denied + +This will *not* work, because by default, most potentially dangerous kernel +capabilities are dropped; including `cap_sys_admin` (which is required to mount +filesystems). However, the `--privileged` flag will allow it to run: + + $ docker run --privileged ubuntu bash + root@50e3f57e16e6:/# mount -t tmpfs none /mnt + root@50e3f57e16e6:/# df -h + Filesystem Size Used Avail Use% Mounted on + none 1.9G 0 1.9G 0% /mnt + +The `--privileged` flag gives *all* capabilities to the container, and it also +lifts all the limitations enforced by the `device` cgroup controller. In other +words, the container can then do almost everything that the host can do. This +flag exists to allow special use-cases, like running Docker within Docker. + +### Set working directory (-w) + + $ docker run -w /path/to/dir/ -i -t ubuntu pwd + +The `-w` lets the command being executed inside directory given, here +`/path/to/dir/`. If the path does not exists it is created inside the container. + +### Mount volume (-v, --read-only) + + $ docker run -v `pwd`:`pwd` -w `pwd` -i -t ubuntu pwd + +The `-v` flag mounts the current working directory into the container. The `-w` +lets the command being executed inside the current working directory, by +changing into the directory to the value returned by `pwd`. So this +combination executes the command using the container, but inside the +current working directory. + + $ docker run -v /doesnt/exist:/foo -w /foo -i -t ubuntu bash + +When the host directory of a bind-mounted volume doesn't exist, Docker +will automatically create this directory on the host for you. In the +example above, Docker will create the `/doesnt/exist` +folder before starting your container. + + $ docker run --read-only -v /icanwrite busybox touch /icanwrite here + +Volumes can be used in combination with `--read-only` to control where +a container writes files. The `--read-only` flag mounts the container's root +filesystem as read only prohibiting writes to locations other than the +specified volumes for the container. + + $ docker run -t -i -v /var/run/docker.sock:/var/run/docker.sock -v ./static-docker:/usr/bin/docker busybox sh + +By bind-mounting the docker unix socket and statically linked docker +binary (such as that provided by [https://get.docker.com]( +https://get.docker.com)), you give the container the full access to create and +manipulate the host's Docker daemon. + +### Publish or expose port (-p, --expose) + + $ docker run -p 127.0.0.1:80:8080 ubuntu bash + +This binds port `8080` of the container to port `80` on `127.0.0.1` of the host +machine. The [Docker User +Guide](../../userguide/networking/default_network/dockerlinks.md) +explains in detail how to manipulate ports in Docker. + + $ docker run --expose 80 ubuntu bash + +This exposes port `80` of the container without publishing the port to the host +system's interfaces. + +### Set environment variables (-e, --env, --env-file) + + $ docker run -e MYVAR1 --env MYVAR2=foo --env-file ./env.list ubuntu bash + +This sets environmental variables in the container. For illustration all three +flags are shown here. Where `-e`, `--env` take an environment variable and +value, or if no `=` is provided, then that variable's current value is passed +through (i.e. `$MYVAR1` from the host is set to `$MYVAR1` in the container). +When no `=` is provided and that variable is not defined in the client's +environment then that variable will be removed from the container's list of +environment variables. +All three flags, `-e`, `--env` and `--env-file` can be repeated. + +Regardless of the order of these three flags, the `--env-file` are processed +first, and then `-e`, `--env` flags. This way, the `-e` or `--env` will +override variables as needed. + + $ cat ./env.list + TEST_FOO=BAR + $ docker run --env TEST_FOO="This is a test" --env-file ./env.list busybox env | grep TEST_FOO + TEST_FOO=This is a test + +The `--env-file` flag takes a filename as an argument and expects each line +to be in the `VAR=VAL` format, mimicking the argument passed to `--env`. Comment +lines need only be prefixed with `#` + +An example of a file passed with `--env-file` + + $ cat ./env.list + TEST_FOO=BAR + + # this is a comment + TEST_APP_DEST_HOST=10.10.0.127 + TEST_APP_DEST_PORT=8888 + _TEST_BAR=FOO + TEST_APP_42=magic + helloWorld=true + 123qwe=bar + org.spring.config=something + + # pass through this variable from the caller + TEST_PASSTHROUGH + $ TEST_PASSTHROUGH=howdy docker run --env-file ./env.list busybox env + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + HOSTNAME=5198e0745561 + TEST_FOO=BAR + TEST_APP_DEST_HOST=10.10.0.127 + TEST_APP_DEST_PORT=8888 + _TEST_BAR=FOO + TEST_APP_42=magic + helloWorld=true + TEST_PASSTHROUGH=howdy + HOME=/root + 123qwe=bar + org.spring.config=something + + $ docker run --env-file ./env.list busybox env + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + HOSTNAME=5198e0745561 + TEST_FOO=BAR + TEST_APP_DEST_HOST=10.10.0.127 + TEST_APP_DEST_PORT=8888 + _TEST_BAR=FOO + TEST_APP_42=magic + helloWorld=true + TEST_PASSTHROUGH= + HOME=/root + 123qwe=bar + org.spring.config=something + +### Set metadata on container (-l, --label, --label-file) + +A label is a `key=value` pair that applies metadata to a container. To label a container with two labels: + + $ docker run -l my-label --label com.example.foo=bar ubuntu bash + +The `my-label` key doesn't specify a value so the label defaults to an empty +string(`""`). To add multiple labels, repeat the label flag (`-l` or `--label`). + +The `key=value` must be unique to avoid overwriting the label value. If you +specify labels with identical keys but different values, each subsequent value +overwrites the previous. Docker uses the last `key=value` you supply. + +Use the `--label-file` flag to load multiple labels from a file. Delimit each +label in the file with an EOL mark. The example below loads labels from a +labels file in the current directory: + + $ docker run --label-file ./labels ubuntu bash + +The label-file format is similar to the format for loading environment +variables. (Unlike environment variables, labels are not visible to processes +running inside a container.) The following example illustrates a label-file +format: + + com.example.label1="a label" + + # this is a comment + com.example.label2=another\ label + com.example.label3 + +You can load multiple label-files by supplying multiple `--label-file` flags. + +For additional information on working with labels, see [*Labels - custom +metadata in Docker*](../../userguide/labels-custom-metadata.md) in the Docker User +Guide. + +### Connect a container to a network (--net) + +When you start a container use the `--net` flag to connect it to a network. +This adds the `busybox` container to the `mynet` network. + +```bash +$ docker run -itd --net=my-multihost-network busybox +``` + +If you want to add a running container to a network use the `docker network connect` subcommand. + +You can connect multiple containers to the same network. Once connected, the +containers can communicate easily need only another container's IP address +or name. For `overlay` networks or custom plugins that support multi-host +connectivity, containers connected to the same multi-host network but launched +from different Engines can also communicate in this way. + +**Note**: Service discovery is unavailable on the default bridge network. +Containers can communicate via their IP addresses by default. To communicate +by name, they must be linked. + +You can disconnect a container from a network using the `docker network +disconnect` command. + +### Mount volumes from container (--volumes-from) + + $ docker run --volumes-from 777f7dc92da7 --volumes-from ba8c0c54f0f2:ro -i -t ubuntu pwd + +The `--volumes-from` flag mounts all the defined volumes from the referenced +containers. Containers can be specified by repetitions of the `--volumes-from` +argument. The container ID may be optionally suffixed with `:ro` or `:rw` to +mount the volumes in read-only or read-write mode, respectively. By default, +the volumes are mounted in the same mode (read write or read only) as +the reference container. + +Labeling systems like SELinux require that proper labels are placed on volume +content mounted into a container. Without a label, the security system might +prevent the processes running inside the container from using the content. By +default, Docker does not change the labels set by the OS. + +To change the label in the container context, you can add either of two suffixes +`:z` or `:Z` to the volume mount. These suffixes tell Docker to relabel file +objects on the shared volumes. The `z` option tells Docker that two containers +share the volume content. As a result, Docker labels the content with a shared +content label. Shared volume labels allow all containers to read/write content. +The `Z` option tells Docker to label the content with a private unshared label. +Only the current container can use a private volume. + +### Attach to STDIN/STDOUT/STDERR (-a) + +The `-a` flag tells `docker run` to bind to the container's `STDIN`, `STDOUT` +or `STDERR`. This makes it possible to manipulate the output and input as +needed. + + $ echo "test" | docker run -i -a stdin ubuntu cat - + +This pipes data into a container and prints the container's ID by attaching +only to the container's `STDIN`. + + $ docker run -a stderr ubuntu echo test + +This isn't going to print anything unless there's an error because we've +only attached to the `STDERR` of the container. The container's logs +still store what's been written to `STDERR` and `STDOUT`. + + $ cat somefile | docker run -i -a stdin mybuilder dobuild + +This is how piping a file into a container could be done for a build. +The container's ID will be printed after the build is done and the build +logs could be retrieved using `docker logs`. This is +useful if you need to pipe a file or something else into a container and +retrieve the container's ID once the container has finished running. + +### Add host device to container (--device) + + $ docker run --device=/dev/sdc:/dev/xvdc --device=/dev/sdd --device=/dev/zero:/dev/nulo -i -t ubuntu ls -l /dev/{xvdc,sdd,nulo} + brw-rw---- 1 root disk 8, 2 Feb 9 16:05 /dev/xvdc + brw-rw---- 1 root disk 8, 3 Feb 9 16:05 /dev/sdd + crw-rw-rw- 1 root root 1, 5 Feb 9 16:05 /dev/nulo + +It is often necessary to directly expose devices to a container. The `--device` +option enables that. For example, a specific block storage device or loop +device or audio device can be added to an otherwise unprivileged container +(without the `--privileged` flag) and have the application directly access it. + +By default, the container will be able to `read`, `write` and `mknod` these devices. +This can be overridden using a third `:rwm` set of options to each `--device` +flag: + + + $ docker run --device=/dev/sda:/dev/xvdc --rm -it ubuntu fdisk /dev/xvdc + + Command (m for help): q + $ docker run --device=/dev/sda:/dev/xvdc:ro --rm -it ubuntu fdisk /dev/xvdc + You will not be able to write the partition table. + + Command (m for help): q + + $ docker run --device=/dev/sda:/dev/xvdc --rm -it ubuntu fdisk /dev/xvdc + + Command (m for help): q + + $ docker run --device=/dev/sda:/dev/xvdc:m --rm -it ubuntu fdisk /dev/xvdc + fdisk: unable to open /dev/xvdc: Operation not permitted + +> **Note:** +> `--device` cannot be safely used with ephemeral devices. Block devices +> that may be removed should not be added to untrusted containers with +> `--device`. + +### Restart policies (--restart) + +Use Docker's `--restart` to specify a container's *restart policy*. A restart +policy controls whether the Docker daemon restarts a container after exit. +Docker supports the following restart policies: + + + + + + + + + + + + + + + + + + + + + + + + + + +
PolicyResult
no + Do not automatically restart the container when it exits. This is the + default. +
+ + on-failure[:max-retries] + + + Restart only if the container exits with a non-zero exit status. + Optionally, limit the number of restart retries the Docker + daemon attempts. +
always + Always restart the container regardless of the exit status. + When you specify always, the Docker daemon will try to restart + the container indefinitely. The container will also always start + on daemon startup, regardless of the current state of the container. +
unless-stopped + Always restart the container regardless of the exit status, but + do not start it on daemon startup if the container has been put + to a stopped state before. +
+ + $ docker run --restart=always redis + +This will run the `redis` container with a restart policy of **always** +so that if the container exits, Docker will restart it. + +More detailed information on restart policies can be found in the +[Restart Policies (--restart)](../run.md#restart-policies-restart) +section of the Docker run reference page. + +### Add entries to container hosts file (--add-host) + +You can add other hosts into a container's `/etc/hosts` file by using one or +more `--add-host` flags. This example adds a static address for a host named +`docker`: + + $ docker run --add-host=docker:10.180.0.1 --rm -it debian + $$ ping docker + PING docker (10.180.0.1): 48 data bytes + 56 bytes from 10.180.0.1: icmp_seq=0 ttl=254 time=7.600 ms + 56 bytes from 10.180.0.1: icmp_seq=1 ttl=254 time=30.705 ms + ^C--- docker ping statistics --- + 2 packets transmitted, 2 packets received, 0% packet loss + round-trip min/avg/max/stddev = 7.600/19.152/30.705/11.553 ms + +Sometimes you need to connect to the Docker host from within your +container. To enable this, pass the Docker host's IP address to +the container using the `--add-host` flag. To find the host's address, +use the `ip addr show` command. + +The flags you pass to `ip addr show` depend on whether you are +using IPv4 or IPv6 networking in your containers. Use the following +flags for IPv4 address retrieval for a network device named `eth0`: + + $ HOSTIP=`ip -4 addr show scope global dev eth0 | grep inet | awk '{print \$2}' | cut -d / -f 1` + $ docker run --add-host=docker:${HOSTIP} --rm -it debian + +For IPv6 use the `-6` flag instead of the `-4` flag. For other network +devices, replace `eth0` with the correct device name (for example `docker0` +for the bridge device). + +### Set ulimits in container (--ulimit) + +Since setting `ulimit` settings in a container requires extra privileges not +available in the default container, you can set these using the `--ulimit` flag. +`--ulimit` is specified with a soft and hard limit as such: +`=[:]`, for example: + + $ docker run --ulimit nofile=1024:1024 --rm debian ulimit -n + 1024 + +> **Note:** +> If you do not provide a `hard limit`, the `soft limit` will be used +> for both values. If no `ulimits` are set, they will be inherited from +> the default `ulimits` set on the daemon. `as` option is disabled now. +> In other words, the following script is not supported: +> `$ docker run -it --ulimit as=1024 fedora /bin/bash` + +The values are sent to the appropriate `syscall` as they are set. +Docker doesn't perform any byte conversion. Take this into account when setting the values. + +#### For `nproc` usage + +Be careful setting `nproc` with the `ulimit` flag as `nproc` is designed by Linux to set the +maximum number of processes available to a user, not to a container. For example, start four +containers with `daemon` user: + + docker run -d -u daemon --ulimit nproc=3 busybox top + docker run -d -u daemon --ulimit nproc=3 busybox top + docker run -d -u daemon --ulimit nproc=3 busybox top + docker run -d -u daemon --ulimit nproc=3 busybox top + +The 4th container fails and reports "[8] System error: resource temporarily unavailable" error. +This fails because the caller set `nproc=3` resulting in the first three containers using up +the three processes quota set for the `daemon` user. + +### Stop container with signal (--stop-signal) + +The `--stop-signal` flag sets the system call signal that will be sent to the container to exit. +This signal can be a valid unsigned number that matches a position in the kernel's syscall table, for instance 9, +or a signal name in the format SIGNAME, for instance SIGKILL. diff --git a/docs/reference/commandline/save.md b/docs/reference/commandline/save.md new file mode 100644 index 0000000000..d384e81507 --- /dev/null +++ b/docs/reference/commandline/save.md @@ -0,0 +1,37 @@ + + +# save + + Usage: docker save [OPTIONS] IMAGE [IMAGE...] + + Save an image(s) to a tar archive (streamed to STDOUT by default) + + --help=false Print usage + -o, --output="" Write to a file, instead of STDOUT + +Produces a tarred repository to the standard output stream. +Contains all parent layers, and all tags + versions, or specified `repo:tag`, for +each argument provided. + +It is used to create a backup that can then be used with `docker load` + + $ docker save busybox > busybox.tar + $ ls -sh busybox.tar + 2.7M busybox.tar + $ docker save --output busybox.tar busybox + $ ls -sh busybox.tar + 2.7M busybox.tar + $ docker save -o fedora-all.tar fedora + $ docker save -o fedora-latest.tar fedora:latest + +It is even useful to cherry-pick particular tags of an image repository + + $ docker save -o ubuntu.tar ubuntu:lucid ubuntu:saucy diff --git a/docs/reference/commandline/search.md b/docs/reference/commandline/search.md new file mode 100644 index 0000000000..7672c13b61 --- /dev/null +++ b/docs/reference/commandline/search.md @@ -0,0 +1,28 @@ + + +# search + + Usage: docker search [OPTIONS] TERM + + Search the Docker Hub for images + + --automated=false Only show automated builds + --help=false Print usage + --no-trunc=false Don't truncate output + -s, --stars=0 Only displays with at least x stars + +Search [Docker Hub](https://hub.docker.com) for images + +See [*Find Public Images on Docker Hub*](../../userguide/dockerrepos.md#searching-for-images) for +more details on finding shared images from the command line. + +> **Note:** +> Search queries will only return up to 25 results diff --git a/docs/reference/commandline/start.md b/docs/reference/commandline/start.md new file mode 100644 index 0000000000..31365a91fc --- /dev/null +++ b/docs/reference/commandline/start.md @@ -0,0 +1,19 @@ + + +# start + + Usage: docker start [OPTIONS] CONTAINER [CONTAINER...] + + Start one or more containers + + -a, --attach=false Attach STDOUT/STDERR and forward signals + --help=false Print usage + -i, --interactive=false Attach container's STDIN diff --git a/docs/reference/commandline/stats.md b/docs/reference/commandline/stats.md new file mode 100644 index 0000000000..b2790edf54 --- /dev/null +++ b/docs/reference/commandline/stats.md @@ -0,0 +1,33 @@ + + +# stats + + Usage: docker stats [OPTIONS] CONTAINER [CONTAINER...] + + Display a live stream of one or more containers' resource usage statistics + + --help=false Print usage + --no-stream=false Disable streaming stats and only pull the first result + +Running `docker stats` on multiple containers + + $ docker stats redis1 redis2 + CONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O + redis1 0.07% 796 KB / 64 MB 1.21% 788 B / 648 B 3.568 MB / 512 KB + redis2 0.07% 2.746 MB / 64 MB 4.29% 1.266 KB / 648 B 12.4 MB / 0 B + + +The `docker stats` command will only return a live stream of data for running +containers. Stopped containers will not return any data. + +> **Note:** +> If you want more detailed information about a container's resource +> usage, use the API endpoint. diff --git a/docs/reference/commandline/stop.md b/docs/reference/commandline/stop.md new file mode 100644 index 0000000000..04b498e1d4 --- /dev/null +++ b/docs/reference/commandline/stop.md @@ -0,0 +1,22 @@ + + +# stop + + Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...] + + Stop a container by sending SIGTERM and then SIGKILL after a + grace period + + --help=false Print usage + -t, --time=10 Seconds to wait for stop before killing it + +The main process inside the container will receive `SIGTERM`, and after a grace +period, `SIGKILL`. diff --git a/docs/reference/commandline/tag.md b/docs/reference/commandline/tag.md new file mode 100644 index 0000000000..a325efaa4b --- /dev/null +++ b/docs/reference/commandline/tag.md @@ -0,0 +1,21 @@ + + +# tag + + Usage: docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG] + + Tag an image into a repository + + -f, --force=false Force + --help=false Print usage + +You can group your images together using names and tags, and then upload them +to [*Share Images via Repositories*](../../userguide/dockerrepos.md#contributing-to-docker-hub). diff --git a/docs/reference/commandline/top.md b/docs/reference/commandline/top.md new file mode 100644 index 0000000000..3c78f6ae45 --- /dev/null +++ b/docs/reference/commandline/top.md @@ -0,0 +1,17 @@ + + +# top + + Usage: docker top [OPTIONS] CONTAINER [ps OPTIONS] + + Display the running processes of a container + + --help=false Print usage diff --git a/docs/reference/commandline/unpause.md b/docs/reference/commandline/unpause.md new file mode 100644 index 0000000000..73248d4580 --- /dev/null +++ b/docs/reference/commandline/unpause.md @@ -0,0 +1,24 @@ + + +# unpause + + Usage: docker unpause [OPTIONS] CONTAINER [CONTAINER...] + + Unpause all processes within a container + + --help=false Print usage + +The `docker unpause` command uses the cgroups freezer to un-suspend all +processes in a container. + +See the +[cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) +for further details. diff --git a/docs/reference/commandline/version.md b/docs/reference/commandline/version.md new file mode 100644 index 0000000000..16b947ed25 --- /dev/null +++ b/docs/reference/commandline/version.md @@ -0,0 +1,55 @@ + + +# version + + Usage: docker version [OPTIONS] + + Show the Docker version information. + + -f, --format="" Format the output using the given go template + --help=false Print usage + +By default, this will render all version information in an easy to read +layout. If a format is specified, the given template will be executed instead. + +Go's [text/template](http://golang.org/pkg/text/template/) package +describes all the details of the format. + +## Examples + +**Default output:** + + $ docker version + Client: + Version: 1.8.0 + API version: 1.20 + Go version: go1.4.2 + Git commit: f5bae0a + Built: Tue Jun 23 17:56:00 UTC 2015 + OS/Arch: linux/amd64 + + Server: + Version: 1.8.0 + API version: 1.20 + Go version: go1.4.2 + Git commit: f5bae0a + Built: Tue Jun 23 17:56:00 UTC 2015 + OS/Arch: linux/amd64 + +**Get server version:** + + $ docker version --format '{{.Server.Version}}' + 1.8.0 + +**Dump raw data:** + + $ docker version --format '{{json .}}' + {"Client":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"},"ServerOK":true,"Server":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","KernelVersion":"3.13.2-gentoo","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"}} diff --git a/docs/reference/commandline/volume_create.md b/docs/reference/commandline/volume_create.md new file mode 100644 index 0000000000..f91c1e415c --- /dev/null +++ b/docs/reference/commandline/volume_create.md @@ -0,0 +1,50 @@ + + +# volume create + + Usage: docker volume create [OPTIONS] + + Create a volume + + -d, --driver=local Specify volume driver name + --help=false Print usage + --name= Specify volume name + -o, --opt=map[] Set driver specific options + +Creates a new volume that containers can consume and store data in. If a name is not specified, Docker generates a random name. You create a volume and then configure the container to use it, for example: + + $ docker volume create --name hello + hello + + $ docker run -d -v hello:/world busybox ls /world + +The mount is created inside the container's `/world` directory. Docker does not support relative paths for mount points inside the container. + +Multiple containers can use the same volume in the same time period. This is useful if two containers need access to shared data. For example, if one container writes and the other reads the data. + +Volume names must be unique among drivers. This means you cannot use the same volume name with two different drivers. If you attempt this `docker` returns an error: + +``` +A volume named %s already exists with the %s driver. Choose a different volume name. +``` + +If you specify a volume name already in use on the current driver, Docker assumes you want to re-use the existing volume and does not return an error. + +## Driver specific options + +Some volume drivers may take options to customize the volume creation. Use the `-o` or `--opt` flags to pass driver options: + + $ docker volume create --driver fake --opt tardis=blue --opt timey=wimey + +These options are passed directly to the volume driver. Options for +different volume drivers may do different things (or nothing at all). + +*Note*: The built-in `local` volume driver does not currently accept any options. diff --git a/docs/reference/commandline/volume_inspect.md b/docs/reference/commandline/volume_inspect.md new file mode 100644 index 0000000000..02b9218879 --- /dev/null +++ b/docs/reference/commandline/volume_inspect.md @@ -0,0 +1,40 @@ + + +# volume inspect + + Usage: docker volume inspect [OPTIONS] VOLUME [VOLUME...] + + Inspect one or more volumes + + -f, --format= Format the output using the given go template. + --help=false Print usage + +Returns information about a volume. By default, this command renders all results +in a JSON array. You can specify an alternate format to execute a given template +is executed for each result. Go's +[text/template](http://golang.org/pkg/text/template/) package describes all the +details of the format. + +Example output: + + $ docker volume create + 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d + $ docker volume inspect 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d + [ + { + "Name": "85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d", + "Driver": "local", + "Mountpoint": "/var/lib/docker/volumes/85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d/_data" + } + ] + + $ docker volume inspect --format '{{ .Mountpoint }}' 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d + /var/lib/docker/volumes/85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d/_data diff --git a/docs/reference/commandline/volume_ls.md b/docs/reference/commandline/volume_ls.md new file mode 100644 index 0000000000..3368866e10 --- /dev/null +++ b/docs/reference/commandline/volume_ls.md @@ -0,0 +1,34 @@ + + +# volume ls + + Usage: docker volume ls [OPTIONS] + + List volumes + + -f, --filter=[] Provide filter values (i.e. 'dangling=true') + --help=false Print usage + -q, --quiet=false Only display volume names + +Lists all the volumes Docker knows about. You can filter using the `-f` or `--filter` flag. The filtering format is a `key=value` pair. To specify more than one filter, pass multiple flags (for example, `--filter "foo=bar" --filter "bif=baz"`) + +There is a single supported filter `dangling=value` which takes a boolean of `true` or `false`. + +Example output: + + $ docker volume create --name rose + rose + $docker volume create --name tyler + tyler + $ docker volume ls + DRIVER VOLUME NAME + local rose + local tyler diff --git a/docs/reference/commandline/volume_rm.md b/docs/reference/commandline/volume_rm.md new file mode 100644 index 0000000000..31ecc31fd9 --- /dev/null +++ b/docs/reference/commandline/volume_rm.md @@ -0,0 +1,22 @@ + + +# volume rm + + Usage: docker volume rm [OPTIONS] VOLUME [VOLUME...] + + Remove a volume + + --help=false Print usage + +Removes one or more volumes. You cannot remove a volume that is in use by a container. + + $ docker volume rm hello + hello diff --git a/docs/reference/commandline/wait.md b/docs/reference/commandline/wait.md new file mode 100644 index 0000000000..cd91c0dded --- /dev/null +++ b/docs/reference/commandline/wait.md @@ -0,0 +1,17 @@ + + +# wait + + Usage: docker wait [OPTIONS] CONTAINER [CONTAINER...] + + Block until a container stops, then print its exit code. + + --help=false Print usage diff --git a/docs/reference/glossary.md b/docs/reference/glossary.md new file mode 100644 index 0000000000..ff4398c249 --- /dev/null +++ b/docs/reference/glossary.md @@ -0,0 +1,221 @@ + + +# Glossary + +A list of terms used around the Docker project. + +## aufs + +aufs (advanced multi layered unification filesystem) is a Linux [filesystem](#filesystem) that +Docker supports as a storage backend. It implements the +[union mount](http://en.wikipedia.org/wiki/Union_mount) for Linux file systems. + +## Base image + +An image that has no parent is a **base image**. + +## boot2docker + +[boot2docker](http://boot2docker.io/) is a lightweight Linux distribution made +specifically to run Docker containers. The boot2docker management tool for Mac and Windows was deprecated and replaced by [`docker-machine`](#machine) which you can install with the Docker Toolbox. + +## btrfs + +btrfs (B-tree file system) is a Linux [filesystem](#filesystem) that Docker +supports as a storage backend. It is a [copy-on-write](http://en.wikipedia.org/wiki/Copy-on-write) +filesystem. + +## build + +build is the process of building Docker images using a [Dockerfile](#dockerfile). +The build uses a Dockerfile and a "context". The context is the set of files in the +directory in which the image is built. + +## cgroups + +cgroups is a Linux kernel feature that limits, accounts for, and isolates +the resource usage (CPU, memory, disk I/O, network, etc.) of a collection +of processes. Docker relies on cgroups to control and isolate resource limits. + +*Also known as : control groups* + +## Compose + +[Compose](https://github.com/docker/compose) is a tool for defining and +running complex applications with Docker. With compose, you define a +multi-container application in a single file, then spin your +application up in a single command which does everything that needs to +be done to get it running. + +*Also known as : docker-compose, fig* + +## container + +A container is a runtime instance of a [docker image](#image). + +A Docker container consists of + +- A Docker image +- Execution environment +- A standard set of instructions + +The concept is borrowed from Shipping Containers, which define a standard to ship +goods globally. Docker defines a standard to ship software. + +## data volume + +A data volume is a specially-designated directory within one or more containers +that bypasses the Union File System. Data volumes are designed to persist data, +independent of the container's life cycle. Docker therefore never automatically +delete volumes when you remove a container, nor will it "garbage collect" +volumes that are no longer referenced by a container. + + +## Docker + +The term Docker can refer to + +- The Docker project as a whole, which is a platform for developers and sysadmins to +develop, ship, and run applications +- The docker daemon process running on the host which manages images and containers + + +## Docker Hub + +The [Docker Hub](https://hub.docker.com/) is a centralized resource for working with +Docker and its components. It provides the following services: + +- Docker image hosting +- User authentication +- Automated image builds and work-flow tools such as build triggers and web hooks +- Integration with GitHub and Bitbucket + + +## Dockerfile + +A Dockerfile is a text document that contains all the commands you would +normally execute manually in order to build a Docker image. Docker can +build images automatically by reading the instructions from a Dockerfile. + +## filesystem + +A file system is the method an operating system uses to name files +and assign them locations for efficient storage and retrieval. + +Examples : + +- Linux : ext4, aufs, btrfs, zfs +- Windows : NTFS +- OS X : HFS+ + +## image + +Docker images are the basis of [containers](#container). An Image is an +ordered collection of root filesystem changes and the corresponding +execution parameters for use within a container runtime. An image typically +contains a union of layered filesystems stacked on top of each other. An image +does not have state and it never changes. + +## libcontainer + +libcontainer provides a native Go implementation for creating containers with +namespaces, cgroups, capabilities, and filesystem access controls. It allows +you to manage the lifecycle of the container performing additional operations +after the container is created. + +## libnetwork + +libnetwork provides a native Go implementation for creating and managing container +network namespaces and other network resources. It manage the networking lifecycle +of the container performing additional operations after the container is created. + +## link + +links provide a legacy interface to connect Docker containers running on the +same host to each other without exposing the hosts' network ports. Use the +Docker networks feature instead. + +## Machine + +[Machine](https://github.com/docker/machine) is a Docker tool which +makes it really easy to create Docker hosts on your computer, on +cloud providers and inside your own data center. It creates servers, +installs Docker on them, then configures the Docker client to talk to them. + +*Also known as : docker-machine* + +## overlay network driver + +Overlay network driver provides out of the box multi-host network connectivity +for docker containers in a cluster. + +## overlay storage driver + +OverlayFS is a [filesystem](#filesystem) service for Linux which implements a +[union mount](http://en.wikipedia.org/wiki/Union_mount) for other file systems. +It is supported by the Docker daemon as a storage driver. + +## registry + +A Registry is a hosted service containing [repositories](#repository) of [images](#image) +which responds to the Registry API. + +The default registry can be accessed using a browser at [Docker Hub](#docker-hub) +or using the `docker search` command. + +## repository + +A repository is a set of Docker images. A repository can be shared by pushing it +to a [registry](#registry) server. The different images in the repository can be +labeled using [tags](#tag). + +Here is an example of the shared [nginx repository](https://registry.hub.docker.com/_/nginx/) +and its [tags](https://registry.hub.docker.com/_/nginx/tags/manage/) + +## Swarm + +[Swarm](https://github.com/docker/swarm) is a native clustering tool for Docker. +Swarm pools together several Docker hosts and exposes them as a single virtual +Docker host. It serves the standard Docker API, so any tool that already works +with Docker can now transparently scale up to multiple hosts. + +*Also known as : docker-swarm* + +## tag + +A tag is a label applied to a Docker image in a [repository](#repository). +tags are how various images in a repository are distinguished from each other. + +*Note : This label is not related to the key=value labels set for docker daemon* + +## Toolbox + +Docker Toolbox is the installer for Mac and Windows users. + + +## Union file system + +Union file systems, or UnionFS, are file systems that operate by creating layers, making them +very lightweight and fast. Docker uses union file systems to provide the building +blocks for containers. + + +## Virtual Machine + +A Virtual Machine is a program that emulates a complete computer and imitates dedicated hardware. +It shares physical hardware resources with other users but isolates the operating system. The +end user has the same experience on a Virtual Machine as they would have on dedicated hardware. + +Compared to to containers, a Virtual Machine is heavier to run, provides more isolation, +gets its own set of resources and does minimal sharing. + +*Also known as : VM* diff --git a/docs/reference/logging/awslogs.md b/docs/reference/logging/awslogs.md new file mode 100644 index 0000000000..8e52288b7d --- /dev/null +++ b/docs/reference/logging/awslogs.md @@ -0,0 +1,90 @@ + + +# Amazon CloudWatch Logs logging driver + +The `awslogs` logging driver sends container logs to +[Amazon CloudWatch Logs](https://aws.amazon.com/cloudwatch/details/#log-monitoring). +Log entries can be retrieved through the [AWS Management +Console](https://console.aws.amazon.com/cloudwatch/home#logs:) or the [AWS SDKs +and Command Line Tools](http://docs.aws.amazon.com/cli/latest/reference/logs/index.html). + +## Usage + +You can configure the default logging driver by passing the `--log-driver` +option to the Docker daemon: + + docker daemon --log-driver=awslogs + +You can set the logging driver for a specific container by using the +`--log-driver` option to `docker run`: + + docker run --log-driver=awslogs ... + +## Amazon CloudWatch Logs options + +You can use the `--log-opt NAME=VALUE` flag to specify Amazon CloudWatch Logs logging driver options. + +### awslogs-region + +You must specify a region for the `awslogs` logging driver. You can specify the +region with either the `awslogs-region` log option or `AWS_REGION` environment +variable: + + docker run --log-driver=awslogs --log-opt awslogs-region=us-east-1 ... + +### awslogs-group + +You must specify a +[log group](http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) +for the `awslogs` logging driver. You can specify the log group with the +`awslogs-group` log option: + + docker run --log-driver=awslogs --log-opt awslogs-region=us-east-1 --log-opt awslogs-group=myLogGroup ... + +### awslogs-stream + +To configure which +[log stream](http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) +should be used, you can specify the `awslogs-stream` log option. If not +specified, the container ID is used as the log stream. + +> **Note:** +> Log streams within a given log group should only be used by one container +> at a time. Using the same log stream for multiple containers concurrently +> can cause reduced logging performance. + +## Credentials + +You must provide AWS credentials to the Docker daemon to use the `awslogs` +logging driver. You can provide these credentials with the `AWS_ACCESS_KEY_ID`, +`AWS_SECRET_ACCESS_KEY`, and `AWS_SESSION_TOKEN` environment variables, the +default AWS shared credentials file (`~/.aws/credentials` of the root user), or +(if you are running the Docker daemon on an Amazon EC2 instance) the Amazon EC2 +instance profile. + +Credentials must have a policy applied that allows the `logs:CreateLogStream` +and `logs:PutLogEvents` actions, as shown in the following example. + + { + "Version": "2012-10-17", + "Statement": [ + { + "Action": [ + "logs:CreateLogStream", + "logs:PutLogEvents" + ], + "Effect": "Allow", + "Resource": "*" + } + ] + } + + diff --git a/docs/reference/logging/fluentd.md b/docs/reference/logging/fluentd.md new file mode 100644 index 0000000000..c23e0a17cb --- /dev/null +++ b/docs/reference/logging/fluentd.md @@ -0,0 +1,111 @@ + + +# Fluentd logging driver + +The `fluentd` logging driver sends container logs to the +[Fluentd](http://www.fluentd.org/) collector as structured log data. Then, users +can use any of the [various output plugins of +Fluentd](http://www.fluentd.org/plugins) to write these logs to various +destinations. + +In addition to the log message itself, the `fluentd` log +driver sends the following metadata in the structured log message: + +| Field | Description | +-------------------|-------------------------------------| +| `container_id` | The full 64-character container ID. | +| `container_name` | The container name at the time it was started. If you use `docker rename` to rename a container, the new name is not reflected in the journal entries. | +| `source` | `stdout` or `stderr` | + +The `docker logs` command is not available for this logging driver. + +## Usage + +Some options are supported by specifying `--log-opt` as many times as needed: + + - `fluentd-address`: specify `host:port` to connect `localhost:24224` + - `tag`: specify tag for fluentd message, which interpret some markup, ex `{{.ID}}`, `{{.FullID}}` or `{{.Name}}` `docker.{{.ID}}` + + +Configure the default logging driver by passing the +`--log-driver` option to the Docker daemon: + + docker daemon --log-driver=fluentd + +To set the logging driver for a specific container, pass the +`--log-driver` option to `docker run`: + + docker run --log-driver=fluentd ... + +Before using this logging driver, launch a Fluentd daemon. The logging driver +connects to this daemon through `localhost:24224` by default. Use the +`fluentd-address` option to connect to a different address. + + docker run --log-driver=fluentd --log-opt fluentd-address=myhost.local:24224 + +If container cannot connect to the Fluentd daemon, the container stops +immediately. + +## Options + +Users can use the `--log-opt NAME=VALUE` flag to specify additional Fluentd logging driver options. + +### fluentd-address + +By default, the logging driver connects to `localhost:24224`. Supply the +`fluentd-address` option to connect to a different address. + + docker run --log-driver=fluentd --log-opt fluentd-address=myhost.local:24224 + +### tag + +By default, Docker uses the first 12 characters of the container ID to tag log messages. +Refer to the [log tag option documentation](log_tags.md) for customizing +the log tag format. + + +### labels and env + +The `labels` and `env` options each take a comma-separated list of keys. If there is collision between `label` and `env` keys, the value of the `env` takes precedence. Both options add additional fields to the extra attributes of a logging message. + + +## Fluentd daemon management with Docker + +About `Fluentd` itself, see [the project webpage](http://www.fluentd.org) +and [its documents](http://docs.fluentd.org/). + +To use this logging driver, start the `fluentd` daemon on a host. We recommend +that you use [the Fluentd docker +image](https://registry.hub.docker.com/u/fluent/fluentd/). This image is +especially useful if you want to aggregate multiple container logs on a each +host then, later, transfer the logs to another Fluentd node to create an +aggregate store. + +### Testing container loggers + +1. Write a configuration file (`test.conf`) to dump input logs: + + + @type forward + + + + @type stdout + + +2. Launch Fluentd container with this configuration file: + + $ docker run -it -p 24224:24224 -v /path/to/conf/test.conf:/fluentd/etc -e FLUENTD_CONF=test.conf fluent/fluentd:latest + +3. Start one or more containers with the `fluentd` logging driver: + + $ docker run --log-driver=fluentd your/application diff --git a/docs/reference/logging/index.md b/docs/reference/logging/index.md new file mode 100644 index 0000000000..58d9ea8557 --- /dev/null +++ b/docs/reference/logging/index.md @@ -0,0 +1,20 @@ + + + +# Logging Drivers + +* [Configuring logging drivers](overview.md) +* [Configuring log tags](log_tags.md) +* [Fluentd logging driver](fluentd.md) +* [Journald logging driver](journald.md) +* [Amazon CloudWatch Logs logging driver](awslogs.md) diff --git a/docs/reference/logging/journald.md b/docs/reference/logging/journald.md new file mode 100644 index 0000000000..df475ddb71 --- /dev/null +++ b/docs/reference/logging/journald.md @@ -0,0 +1,85 @@ + + +# Journald logging driver + +The `journald` logging driver sends container logs to the [systemd +journal](http://www.freedesktop.org/software/systemd/man/systemd-journald.service.html). Log entries can be retrieved using the `journalctl` +command, through use of the journal API, or using the `docker logs` command. + +In addition to the text of the log message itself, the `journald` log +driver stores the following metadata in the journal with each message: + +| Field | Description | +----------------------|-------------| +| `CONTAINER_ID` | The container ID truncated to 12 characters. | +| `CONTAINER_ID_FULL` | The full 64-character container ID. | +| `CONTAINER_NAME` | The container name at the time it was started. If you use `docker rename` to rename a container, the new name is not reflected in the journal entries. | + +## Usage + +You can configure the default logging driver by passing the +`--log-driver` option to the Docker daemon: + + docker daemon --log-driver=journald + +You can set the logging driver for a specific container by using the +`--log-driver` option to `docker run`: + + docker run --log-driver=journald ... + +## Options + +Users can use the `--log-opt NAME=VALUE` flag to specify additional +journald logging driver options. + +### labels and env + +The `labels` and `env` options each take a comma-separated list of keys. If there is collision between `label` and `env` keys, the value of the `env` takes precedence. Both options add additional metadata in the journal with each message. + +## Note regarding container names + +The value logged in the `CONTAINER_NAME` field is the container name +that was set at startup. If you use `docker rename` to rename a +container, the new name will not be reflected in the journal entries. +Journal entries will continue to use the original name. + +## Retrieving log messages with journalctl + +You can use the `journalctl` command to retrieve log messages. You +can apply filter expressions to limit the retrieved messages to a +specific container. For example, to retrieve all log messages from a +container referenced by name: + + # journalctl CONTAINER_NAME=webserver + +You can make use of additional filters to further limit the messages +retrieved. For example, to see just those messages generated since +the system last booted: + + # journalctl -b CONTAINER_NAME=webserver + +Or to retrieve log messages in JSON format with complete metadata: + + # journalctl -o json CONTAINER_NAME=webserver + +## Retrieving log messages with the journal API + +This example uses the `systemd` Python module to retrieve container +logs: + + import systemd.journal + + reader = systemd.journal.Reader() + reader.add_match('CONTAINER_NAME=web') + + for msg in reader: + print '{CONTAINER_ID_FULL}: {MESSAGE}'.format(**msg) diff --git a/docs/reference/logging/log_tags.md b/docs/reference/logging/log_tags.md new file mode 100644 index 0000000000..493b9a5b93 --- /dev/null +++ b/docs/reference/logging/log_tags.md @@ -0,0 +1,50 @@ + + +# Log Tags + +The `tag` log option specifies how to format a tag that identifies the +container's log messages. By default, the system uses the first 12 characters of +the container id. To override this behavior, specify a `tag` option: + +``` +docker run --log-driver=fluentd --log-opt fluentd-address=myhost.local:24224 --log-opt tag="mailer" +``` + +Docker supports some special template markup you can use when specifying a tag's value: + +| Markup | Description | +|--------------------|------------------------------------------------------| +| `{{.ID}}` | The first 12 characters of the container id. | +| `{{.FullID}}` | The full container id. | +| `{{.Name}}` | The container name. | +| `{{.ImageID}}` | The first 12 characters of the container's image id. | +| `{{.ImageFullID}}` | The container's full image identifier. | +| `{{.ImageName}}` | The name of the image used by the container. | + +For example, specifying a `--log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}"` value yields `syslog` log lines like: + +``` +Aug 7 18:33:19 HOSTNAME docker/hello-world/foobar/5790672ab6a0[9103]: Hello from Docker. +``` + +At startup time, the system sets the `container_name` field and `{{.Name}}` in +the tags. If you use `docker rename` to rename a container, the new name is not +reflected in the log messages. Instead, these messages continue to use the +original container name. + +For advanced usage, the generated tag's use [go +templates](http://golang.org/pkg/text/template/) and the container's [logging +context](https://github.com/docker/docker/blob/master/daemon/logger/context.go). + +>**Note**:The driver specific log options `syslog-tag`, `fluentd-tag` and +>`gelf-tag` still work for backwards compatibility. However, going forward you +>should standardize on using the generic `tag` log option instead. diff --git a/docs/reference/logging/overview.md b/docs/reference/logging/overview.md new file mode 100644 index 0000000000..86042084c8 --- /dev/null +++ b/docs/reference/logging/overview.md @@ -0,0 +1,174 @@ + + + +# Configure logging drivers + +The container can have a different logging driver than the Docker daemon. Use +the `--log-driver=VALUE` with the `docker run` command to configure the +container's logging driver. The following options are supported: + +| `none` | Disables any logging for the container. `docker logs` won't be available with this driver. | +|-------------|-------------------------------------------------------------------------------------------------------------------------------| +| `json-file` | Default logging driver for Docker. Writes JSON messages to file. | +| `syslog` | Syslog logging driver for Docker. Writes log messages to syslog. | +| `journald` | Journald logging driver for Docker. Writes log messages to `journald`. | +| `gelf` | Graylog Extended Log Format (GELF) logging driver for Docker. Writes log messages to a GELF endpoint likeGraylog or Logstash. | +| `fluentd` | Fluentd logging driver for Docker. Writes log messages to `fluentd` (forward input). | +| `awslogs` | Amazon CloudWatch Logs logging driver for Docker. Writes log messages to Amazon CloudWatch Logs. | + +The `docker logs`command is available only for the `json-file` logging driver. + +The `labels` and `env` options add additional attributes for use with logging drivers that accept them. Each option takes a comma-separated list of keys. If there is collision between `label` and `env` keys, the value of the `env` takes precedence. + +To use attributes, specify them when you start the Docker daemon. + +``` +docker daemon --log-driver=json-file --log-opt labels=foo --log-opt env=foo,fizz +``` + +Then, run a container and specify values for the `labels` or `env`. For example, you might use this: + +``` +docker run --label foo=bar -e fizz=buzz -d -P training/webapp python app.py +``` + +This adds additional fields to the log depending on the driver, e.g. for +`json-file` that looks like: + + "attrs":{"fizz":"buzz","foo":"bar"} + + +## json-file options + +The following logging options are supported for the `json-file` logging driver: + + --log-opt max-size=[0-9+][k|m|g] + --log-opt max-file=[0-9+] + --log-opt labels=label1,label2 + --log-opt env=env1,env2 + +Logs that reach `max-size` are rolled over. You can set the size in kilobytes(k), megabytes(m), or gigabytes(g). eg `--log-opt max-size=50m`. If `max-size` is not set, then logs are not rolled over. + +`max-file` specifies the maximum number of files that a log is rolled over before being discarded. eg `--log-opt max-file=100`. If `max-size` is not set, then `max-file` is not honored. + +If `max-size` and `max-file` are set, `docker logs` only returns the log lines from the newest log file. + + +## syslog options + +The following logging options are supported for the `syslog` logging driver: + + --log-opt syslog-address=[tcp|udp]://host:port + --log-opt syslog-address=unix://path + --log-opt syslog-facility=daemon + --log-opt tag="mailer" + +`syslog-address` specifies the remote syslog server address where the driver connects to. +If not specified it defaults to the local unix socket of the running system. +If transport is either `tcp` or `udp` and `port` is not specified it defaults to `514` +The following example shows how to have the `syslog` driver connect to a `syslog` +remote server at `192.168.0.42` on port `123` + + $ docker run --log-driver=syslog --log-opt syslog-address=tcp://192.168.0.42:123 + +The `syslog-facility` option configures the syslog facility. By default, the system uses the +`daemon` value. To override this behavior, you can provide an integer of 0 to 23 or any of +the following named facilities: + +* `kern` +* `user` +* `mail` +* `daemon` +* `auth` +* `syslog` +* `lpr` +* `news` +* `uucp` +* `cron` +* `authpriv` +* `ftp` +* `local0` +* `local1` +* `local2` +* `local3` +* `local4` +* `local5` +* `local6` +* `local7` + +By default, Docker uses the first 12 characters of the container ID to tag log messages. +Refer to the [log tag option documentation](log_tags.md) for customizing +the log tag format. + + +## journald options + +The `journald` logging driver stores the container id in the journal's `CONTAINER_ID` field. For detailed information on +working with this logging driver, see [the journald logging driver](journald.md) +reference documentation. + +## gelf options + +The GELF logging driver supports the following options: + + --log-opt gelf-address=udp://host:port + --log-opt tag="database" + --log-opt labels=label1,label2 + --log-opt env=env1,env2 + +The `gelf-address` option specifies the remote GELF server address that the +driver connects to. Currently, only `udp` is supported as the transport and you must +specify a `port` value. The following example shows how to connect the `gelf` +driver to a GELF remote server at `192.168.0.42` on port `12201` + + $ docker run --log-driver=gelf --log-opt gelf-address=udp://192.168.0.42:12201 + +By default, Docker uses the first 12 characters of the container ID to tag log messages. +Refer to the [log tag option documentation](log_tags.md) for customizing +the log tag format. + +The `labels` and `env` options are supported by the gelf logging +driver. It adds additional key on the `extra` fields, prefixed by an +underscore (`_`). + + // […] + "_foo": "bar", + "_fizz": "buzz", + // […] + + +## fluentd options + +You can use the `--log-opt NAME=VALUE` flag to specify these additional Fluentd logging driver options. + + - `fluentd-address`: specify `host:port` to connect [localhost:24224] + - `tag`: specify tag for `fluentd` message, + +For example, to specify both additional options: + +`docker run --log-driver=fluentd --log-opt fluentd-address=localhost:24224 --log-opt tag=docker.{{.Name}}` + +If container cannot connect to the Fluentd daemon on the specified address, +the container stops immediately. For detailed information on working with this +logging driver, see [the fluentd logging driver](fluentd.md) + + +## Specify Amazon CloudWatch Logs options + +The Amazon CloudWatch Logs logging driver supports the following options: + + --log-opt awslogs-region= + --log-opt awslogs-group= + --log-opt awslogs-stream= + + +For detailed information on working with this logging driver, see [the awslogs logging driver](awslogs.md) reference documentation. diff --git a/docs/reference/run.md b/docs/reference/run.md new file mode 100644 index 0000000000..9ed8be72bf --- /dev/null +++ b/docs/reference/run.md @@ -0,0 +1,1317 @@ + + + + +# Docker run reference + +Docker runs processes in isolated containers. A container is a process +which runs on a host. The host may be local or remote. When an operator +executes `docker run`, the container process that runs is isolated in +that it has its own file system, its own networking, and its own +isolated process tree separate from the host. + +This page details how to use the `docker run` command to define the +container's resources at runtime. + +## General form + +The basic `docker run` command takes this form: + + $ docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...] + +The `docker run` command must specify an [*IMAGE*](glossary.md#image) +to derive the container from. An image developer can define image +defaults related to: + + * detached or foreground running + * container identification + * network settings + * runtime constraints on CPU and memory + * privileges and LXC configuration + +With the `docker run [OPTIONS]` an operator can add to or override the +image defaults set by a developer. And, additionally, operators can +override nearly all the defaults set by the Docker runtime itself. The +operator's ability to override image and Docker runtime defaults is why +[*run*](commandline/run.md) has more options than any +other `docker` command. + +To learn how to interpret the types of `[OPTIONS]`, see [*Option +types*](commandline/cli.md#option-types). + +> **Note**: Depending on your Docker system configuration, you may be +> required to preface the `docker run` command with `sudo`. To avoid +> having to use `sudo` with the `docker` command, your system +> administrator can create a Unix group called `docker` and add users to +> it. For more information about this configuration, refer to the Docker +> installation documentation for your operating system. + + +## Operator exclusive options + +Only the operator (the person executing `docker run`) can set the +following options. + + - [Detached vs foreground](#detached-vs-foreground) + - [Detached (-d)](#detached-d) + - [Foreground](#foreground) + - [Container identification](#container-identification) + - [Name (--name)](#name-name) + - [PID equivalent](#pid-equivalent) + - [IPC settings (--ipc)](#ipc-settings-ipc) + - [Network settings](#network-settings) + - [Restart policies (--restart)](#restart-policies-restart) + - [Clean up (--rm)](#clean-up-rm) + - [Runtime constraints on resources](#runtime-constraints-on-resources) + - [Runtime privilege, Linux capabilities, and LXC configuration](#runtime-privilege-linux-capabilities-and-lxc-configuration) + +## Detached vs foreground + +When starting a Docker container, you must first decide if you want to +run the container in the background in a "detached" mode or in the +default foreground mode: + + -d=false: Detached mode: Run container in the background, print new container id + +### Detached (-d) + +To start a container in detached mode, you use `-d=true` or just `-d` option. By +design, containers started in detached mode exit when the root process used to +run the container exits. A container in detached mode cannot be automatically +removed when it stops, this means you cannot use the `--rm` option with `-d` option. + +Do not pass a `service x start` command to a detached container. For example, this +command attempts to start the `nginx` service. + + $ docker run -d -p 80:80 my_image service nginx start + +This succeeds in starting the `nginx` service inside the container. However, it +fails the detached container paradigm in that, the root process (`service nginx +start`) returns and the detached container stops as designed. As a result, the +`nginx` service is started but could not be used. Instead, to start a process +such as the `nginx` web server do the following: + + $ docker run -d -p 80:80 my_image nginx -g 'daemon off;' + +To do input/output with a detached container use network connections or shared +volumes. These are required because the container is no longer listening to the +command line where `docker run` was run. + +To reattach to a detached container, use `docker` +[*attach*](commandline/attach.md) command. + +### Foreground + +In foreground mode (the default when `-d` is not specified), `docker +run` can start the process in the container and attach the console to +the process's standard input, output, and standard error. It can even +pretend to be a TTY (this is what most command line executables expect) +and pass along signals. All of that is configurable: + + -a=[] : Attach to `STDIN`, `STDOUT` and/or `STDERR` + -t=false : Allocate a pseudo-tty + --sig-proxy=true: Proxify all received signal to the process (non-TTY mode only) + -i=false : Keep STDIN open even if not attached + +If you do not specify `-a` then Docker will [attach all standard +streams]( https://github.com/docker/docker/blob/75a7f4d90cde0295bcfb7213004abce8d4779b75/commands.go#L1797). +You can specify to which of the three standard streams (`STDIN`, `STDOUT`, +`STDERR`) you'd like to connect instead, as in: + + $ docker run -a stdin -a stdout -i -t ubuntu /bin/bash + +For interactive processes (like a shell), you must use `-i -t` together in +order to allocate a tty for the container process. `-i -t` is often written `-it` +as you'll see in later examples. Specifying `-t` is forbidden when the client +standard output is redirected or piped, such as in: +`echo test | docker run -i busybox cat`. + +>**Note**: A process running as PID 1 inside a container is treated +>specially by Linux: it ignores any signal with the default action. +>So, the process will not terminate on `SIGINT` or `SIGTERM` unless it is +>coded to do so. + +## Container identification + +### Name (--name) + +The operator can identify a container in three ways: + +- UUID long identifier + ("f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778") +- UUID short identifier ("f78375b1c487") +- Name ("evil_ptolemy") + +The UUID identifiers come from the Docker daemon. If you do not assign a +container name with the `--name` option, then the daemon generates a random +string name for you. Defining a `name` can be a handy way to add meaning to a +container. If you specify a `name`, you can use it when referencing the +container within a Docker network. This works for both background and foreground +Docker containers. + +**Note**: Containers on the default bridge network must be linked to communicate by name. + +### PID equivalent + +Finally, to help with automation, you can have Docker write the +container ID out to a file of your choosing. This is similar to how some +programs might write out their process ID to a file (you've seen them as +PID files): + + --cidfile="": Write the container ID to the file + +### Image[:tag] + +While not strictly a means of identifying a container, you can specify a version of an +image you'd like to run the container with by adding `image[:tag]` to the command. For +example, `docker run ubuntu:14.04`. + +### Image[@digest] + +Images using the v2 or later image format have a content-addressable identifier +called a digest. As long as the input used to generate the image is unchanged, +the digest value is predictable and referenceable. + +## PID settings (--pid) + + --pid="" : Set the PID (Process) Namespace mode for the container, + 'host': use the host's PID namespace inside the container + +By default, all containers have the PID namespace enabled. + +PID namespace provides separation of processes. The PID Namespace removes the +view of the system processes, and allows process ids to be reused including +pid 1. + +In certain cases you want your container to share the host's process namespace, +basically allowing processes within the container to see all of the processes +on the system. For example, you could build a container with debugging tools +like `strace` or `gdb`, but want to use these tools when debugging processes +within the container. + + $ docker run --pid=host rhel7 strace -p 1234 + +This command would allow you to use `strace` inside the container on pid 1234 on +the host. + +## UTS settings (--uts) + + --uts="" : Set the UTS namespace mode for the container, + 'host': use the host's UTS namespace inside the container + +The UTS namespace is for setting the hostname and the domain that is visible +to running processes in that namespace. By default, all containers, including +those with `--net=host`, have their own UTS namespace. The `host` setting will +result in the container using the same UTS namespace as the host. + +You may wish to share the UTS namespace with the host if you would like the +hostname of the container to change as the hostname of the host changes. A +more advanced use case would be changing the host's hostname from a container. + +> **Note**: `--uts="host"` gives the container full access to change the +> hostname of the host and is therefore considered insecure. + +## IPC settings (--ipc) + + --ipc="" : Set the IPC mode for the container, + 'container:': reuses another container's IPC namespace + 'host': use the host's IPC namespace inside the container + +By default, all containers have the IPC namespace enabled. + +IPC (POSIX/SysV IPC) namespace provides separation of named shared memory +segments, semaphores and message queues. + +Shared memory segments are used to accelerate inter-process communication at +memory speed, rather than through pipes or through the network stack. Shared +memory is commonly used by databases and custom-built (typically C/OpenMPI, +C++/using boost libraries) high performance applications for scientific +computing and financial services industries. If these types of applications +are broken into multiple containers, you might need to share the IPC mechanisms +of the containers. + +## Network settings + + --dns=[] : Set custom dns servers for the container + --net="bridge" : Connects a container to a network + 'bridge': creates a new network stack for the container on the docker bridge + 'none': no networking for this container + 'container:': reuses another container network stack + 'host': use the host network stack inside the container + 'NETWORK': connects the container to user-created network using `docker network create` command + --add-host="" : Add a line to /etc/hosts (host:IP) + --mac-address="" : Sets the container's Ethernet device's MAC address + +By default, all containers have networking enabled and they can make any +outgoing connections. The operator can completely disable networking +with `docker run --net none` which disables all incoming and outgoing +networking. In cases like this, you would perform I/O through files or +`STDIN` and `STDOUT` only. + +Publishing ports and linking to other containers only works with the the default (bridge). The linking feature is a legacy feature. You should always prefer using Docker network drivers over linking. + +Your container will use the same DNS servers as the host by default, but +you can override this with `--dns`. + +By default, the MAC address is generated using the IP address allocated to the +container. You can set the container's MAC address explicitly by providing a +MAC address via the `--mac-address` parameter (format:`12:34:56:78:9a:bc`). + +Supported networks : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NetworkDescription
none + No networking in the container. +
bridge (default) + Connect the container to the bridge via veth interfaces. +
host + Use the host's network stack inside the container. +
container:<name|id> + Use the network stack of another container, specified via + its *name* or *id*. +
NETWORK + Connects the container to a user created network (using `docker network create` command) +
+ +#### Network: none + +With the network is `none` a container will not have +access to any external routes. The container will still have a +`loopback` interface enabled in the container but it does not have any +routes to external traffic. + +#### Network: bridge + +With the network set to `bridge` a container will use docker's +default networking setup. A bridge is setup on the host, commonly named +`docker0`, and a pair of `veth` interfaces will be created for the +container. One side of the `veth` pair will remain on the host attached +to the bridge while the other side of the pair will be placed inside the +container's namespaces in addition to the `loopback` interface. An IP +address will be allocated for containers on the bridge's network and +traffic will be routed though this bridge to the container. + +Containers can communicate via their IP addresses by default. To communicate by +name, they must be linked. + +#### Network: host + +With the network set to `host` a container will share the host's +network stack and all interfaces from the host will be available to the +container. The container's hostname will match the hostname on the host +system. Note that `--add-host` `--hostname` `--dns` `--dns-search` +`--dns-opt` and `--mac-address` are invalid in `host` netmode. + +Compared to the default `bridge` mode, the `host` mode gives *significantly* +better networking performance since it uses the host's native networking stack +whereas the bridge has to go through one level of virtualization through the +docker daemon. It is recommended to run containers in this mode when their +networking performance is critical, for example, a production Load Balancer +or a High Performance Web Server. + +> **Note**: `--net="host"` gives the container full access to local system +> services such as D-bus and is therefore considered insecure. + +#### Network: container + +With the network set to `container` a container will share the +network stack of another container. The other container's name must be +provided in the format of `--net container:`. Note that `--add-host` +`--hostname` `--dns` `--dns-search` `--dns-opt` and `--mac-address` are +invalid in `container` netmode, and `--publish` `--publish-all` `--expose` are +also invalid in `container` netmode. + +Example running a Redis container with Redis binding to `localhost` then +running the `redis-cli` command and connecting to the Redis server over the +`localhost` interface. + + $ docker run -d --name redis example/redis --bind 127.0.0.1 + $ # use the redis container's network stack to access localhost + $ docker run --rm -it --net container:redis example/redis-cli -h 127.0.0.1 + +#### User-defined network + +You can create a network using a Docker network driver or an external network +driver plugin. You can connect multiple containers to the same network. Once +connected to a user-defined network, the containers can communicate easily using +only another container's IP address or name. + +For `overlay` networks or custom plugins that support multi-host connectivity, +containers connected to the same multi-host network but launched from different +Engines can also communicate in this way. + +The following example creates a network using the built-in `bridge` network +driver and running a container in the created network + +``` +$ docker network create -d overlay my-net +$ docker run --net=my-net -itd --name=container3 busybox +``` + +### Managing /etc/hosts + +Your container will have lines in `/etc/hosts` which define the hostname of the +container itself as well as `localhost` and a few other common things. The +`--add-host` flag can be used to add additional lines to `/etc/hosts`. + + $ docker run -it --add-host db-static:86.75.30.9 ubuntu cat /etc/hosts + 172.17.0.22 09d03f76bf2c + fe00::0 ip6-localnet + ff00::0 ip6-mcastprefix + ff02::1 ip6-allnodes + ff02::2 ip6-allrouters + 127.0.0.1 localhost + ::1 localhost ip6-localhost ip6-loopback + 86.75.30.9 db-static + +If a container is connected to the default bridge network and `linked` +with other containers, then the container's `/etc/hosts` file is updated +with the linked container's name. + +If the container is connected to user-defined network, the container's +`/etc/hosts` file is updated with names of all other containers in that +user-defined network. + +> **Note** Since Docker may live update the container’s `/etc/hosts` file, there +may be situations when processes inside the container can end up reading an +empty or incomplete `/etc/hosts` file. In most cases, retrying the read again +should fix the problem. + +## Restart policies (--restart) + +Using the `--restart` flag on Docker run you can specify a restart policy for +how a container should or should not be restarted on exit. + +When a restart policy is active on a container, it will be shown as either `Up` +or `Restarting` in [`docker ps`](commandline/ps.md). It can also be +useful to use [`docker events`](commandline/events.md) to see the +restart policy in effect. + +Docker supports the following restart policies: + + + + + + + + + + + + + + + + + + + + + + + + + + +
PolicyResult
no + Do not automatically restart the container when it exits. This is the + default. +
+ + on-failure[:max-retries] + + + Restart only if the container exits with a non-zero exit status. + Optionally, limit the number of restart retries the Docker + daemon attempts. +
always + Always restart the container regardless of the exit status. + When you specify always, the Docker daemon will try to restart + the container indefinitely. The container will also always start + on daemon startup, regardless of the current state of the container. +
unless-stopped + Always restart the container regardless of the exit status, but + do not start it on daemon startup if the container has been put + to a stopped state before. +
+ +An ever increasing delay (double the previous delay, starting at 100 +milliseconds) is added before each restart to prevent flooding the server. +This means the daemon will wait for 100 ms, then 200 ms, 400, 800, 1600, +and so on until either the `on-failure` limit is hit, or when you `docker stop` +or `docker rm -f` the container. + +If a container is successfully restarted (the container is started and runs +for at least 10 seconds), the delay is reset to its default value of 100 ms. + +You can specify the maximum amount of times Docker will try to restart the +container when using the **on-failure** policy. The default is that Docker +will try forever to restart the container. The number of (attempted) restarts +for a container can be obtained via [`docker inspect`](commandline/inspect.md). For example, to get the number of restarts +for container "my-container"; + + $ docker inspect -f "{{ .RestartCount }}" my-container + # 2 + +Or, to get the last time the container was (re)started; + + $ docker inspect -f "{{ .State.StartedAt }}" my-container + # 2015-03-04T23:47:07.691840179Z + +You cannot set any restart policy in combination with +["clean up (--rm)"](#clean-up-rm). Setting both `--restart` and `--rm` +results in an error. + +### Examples + + $ docker run --restart=always redis + +This will run the `redis` container with a restart policy of **always** +so that if the container exits, Docker will restart it. + + $ docker run --restart=on-failure:10 redis + +This will run the `redis` container with a restart policy of **on-failure** +and a maximum restart count of 10. If the `redis` container exits with a +non-zero exit status more than 10 times in a row Docker will abort trying to +restart the container. Providing a maximum restart limit is only valid for the +**on-failure** policy. + +## Clean up (--rm) + +By default a container's file system persists even after the container +exits. This makes debugging a lot easier (since you can inspect the +final state) and you retain all your data by default. But if you are +running short-term **foreground** processes, these container file +systems can really pile up. If instead you'd like Docker to +**automatically clean up the container and remove the file system when +the container exits**, you can add the `--rm` flag: + + --rm=false: Automatically remove the container when it exits (incompatible with -d) + +> **Note**: When you set the `--rm` flag, Docker also removes the volumes +associated with the container when the container is removed. This is similar +to running `docker rm -v my-container`. + +## Security configuration + --security-opt="label:user:USER" : Set the label user for the container + --security-opt="label:role:ROLE" : Set the label role for the container + --security-opt="label:type:TYPE" : Set the label type for the container + --security-opt="label:level:LEVEL" : Set the label level for the container + --security-opt="label:disable" : Turn off label confinement for the container + --security-opt="apparmor:PROFILE" : Set the apparmor profile to be applied + to the container + +You can override the default labeling scheme for each container by specifying +the `--security-opt` flag. For example, you can specify the MCS/MLS level, a +requirement for MLS systems. Specifying the level in the following command +allows you to share the same content between containers. + + $ docker run --security-opt label:level:s0:c100,c200 -i -t fedora bash + +An MLS example might be: + + $ docker run --security-opt label:level:TopSecret -i -t rhel7 bash + +To disable the security labeling for this container versus running with the +`--permissive` flag, use the following command: + + $ docker run --security-opt label:disable -i -t fedora bash + +If you want a tighter security policy on the processes within a container, +you can specify an alternate type for the container. You could run a container +that is only allowed to listen on Apache ports by executing the following +command: + + $ docker run --security-opt label:type:svirt_apache_t -i -t centos bash + +> **Note**: You would have to write policy defining a `svirt_apache_t` type. + +## Specifying custom cgroups + +Using the `--cgroup-parent` flag, you can pass a specific cgroup to run a +container in. This allows you to create and manage cgroups on their own. You can +define custom resources for those cgroups and put containers under a common +parent group. + +## Runtime constraints on resources + +The operator can also adjust the performance parameters of the +container: + +| Option | Description | +|----------------------------|---------------------------------------------------------------------------------------------| +| `-m`, `--memory="" ` | Memory limit (format: `[]`, where unit = b, k, m or g) | +| `--memory-swap=""` | Total memory limit (memory + swap, format: `[]`, where unit = b, k, m or g) | +| `--memory-reservation=""` | Memory soft limit (format: `[]`, where unit = b, k, m or g) | +| `--kernel-memory=""` | Kernel memory limit (format: `[]`, where unit = b, k, m or g) | +| `-c`, `--cpu-shares=0` | CPU shares (relative weight) | +| `--cpu-period=0` | Limit the CPU CFS (Completely Fair Scheduler) period | +| `--cpuset-cpus="" ` | CPUs in which to allow execution (0-3, 0,1) | +| `--cpuset-mems=""` | Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems. | +| `--cpu-quota=0` | Limit the CPU CFS (Completely Fair Scheduler) quota | +| `--blkio-weight=0` | Block IO weight (relative weight) accepts a weight value between 10 and 1000. | +| `--oom-kill-disable=false` | Whether to disable OOM Killer for the container or not. | +| `--memory-swappiness="" ` | Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. | + +### User memory constraints + +We have four ways to set user memory usage: + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionResult
+ memory=inf, memory-swap=inf (default) + + There is no memory limit for the container. The container can use + as much memory as needed. +
memory=L<inf, memory-swap=inf + (specify memory and set memory-swap as -1) The container is + not allowed to use more than L bytes of memory, but can use as much swap + as is needed (if the host supports swap memory). +
memory=L<inf, memory-swap=2*L + (specify memory without memory-swap) The container is not allowed to + use more than L bytes of memory, swap *plus* memory usage is double + of that. +
+ memory=L<inf, memory-swap=S<inf, L<=S + + (specify both memory and memory-swap) The container is not allowed to + use more than L bytes of memory, swap *plus* memory usage is limited + by S. +
+ +Examples: + + $ docker run -ti ubuntu:14.04 /bin/bash + +We set nothing about memory, this means the processes in the container can use +as much memory and swap memory as they need. + + $ docker run -ti -m 300M --memory-swap -1 ubuntu:14.04 /bin/bash + +We set memory limit and disabled swap memory limit, this means the processes in +the container can use 300M memory and as much swap memory as they need (if the +host supports swap memory). + + $ docker run -ti -m 300M ubuntu:14.04 /bin/bash + +We set memory limit only, this means the processes in the container can use +300M memory and 300M swap memory, by default, the total virtual memory size +(--memory-swap) will be set as double of memory, in this case, memory + swap +would be 2*300M, so processes can use 300M swap memory as well. + + $ docker run -ti -m 300M --memory-swap 1G ubuntu:14.04 /bin/bash + +We set both memory and swap memory, so the processes in the container can use +300M memory and 700M swap memory. + +Memory reservation is a kind of memory soft limit that allows for greater +sharing of memory. Under normal circumstances, containers can use as much of +the memory as needed and are constrained only by the hard limits set with the +`-m`/`--memory` option. When memory reservation is set, Docker detects memory +contention or low memory and forces containers to restrict their consumption to +a reservation limit. + +Always set the memory reservation value below the hard limit, otherwise the hard +limit takes precedence. A reservation of 0 is the same as setting no +reservation. By default (without reservation set), memory reservation is the +same as the hard memory limit. + +Memory reservation is a soft-limit feature and does not guarantee the limit +won't be exceeded. Instead, the feature attempts to ensure that, when memory is +heavily contended for, memory is allocated based on the reservation hints/setup. + +The following example limits the memory (`-m`) to 500M and sets the memory +reservation to 200M. + +```bash +$ docker run -ti -m 500M --memory-reservation 200M ubuntu:14.04 /bin/bash +``` + +Under this configuration, when the container consumes memory more than 200M and +less than 500M, the next system memory reclaim attempts to shrink container +memory below 200M. + +The following example set memory reservation to 1G without a hard memory limit. + +```bash +$ docker run -ti --memory-reservation 1G ubuntu:14.04 /bin/bash +``` + +The container can use as much memory as it needs. The memory reservation setting +ensures the container doesn't consume too much memory for long time, because +every memory reclaim shrinks the container's consumption to the reservation. + +By default, kernel kills processes in a container if an out-of-memory (OOM) +error occurs. To change this behaviour, use the `--oom-kill-disable` option. +Only disable the OOM killer on containers where you have also set the +`-m/--memory` option. If the `-m` flag is not set, this can result in the host +running out of memory and require killing the host's system processes to free +memory. + +The following example limits the memory to 100M and disables the OOM killer for +this container: + + $ docker run -ti -m 100M --oom-kill-disable ubuntu:14.04 /bin/bash + +The following example, illustrates a dangerous way to use the flag: + + $ docker run -ti --oom-kill-disable ubuntu:14.04 /bin/bash + +The container has unlimited memory which can cause the host to run out memory +and require killing system processes to free memory. + +### Kernel memory constraints + +Kernel memory is fundamentally different than user memory as kernel memory can't +be swapped out. The inability to swap makes it possible for the container to +block system services by consuming too much kernel memory. Kernel memory includes： + + - stack pages + - slab pages + - sockets memory pressure + - tcp memory pressure + +You can setup kernel memory limit to constrain these kinds of memory. For example, +every process consumes some stack pages. By limiting kernel memory, you can +prevent new processes from being created when the kernel memory usage is too high. + +Kernel memory is never completely independent of user memory. Instead, you limit +kernel memory in the context of the user memory limit. Assume "U" is the user memory +limit and "K" the kernel limit. There are three possible ways to set limits: + + + + + + + + + + + + + + + + + + + + + + +
OptionResult
U != 0, K = inf (default) + This is the standard memory limitation mechanism already present before using + kernel memory. Kernel memory is completely ignored. +
U != 0, K < U + Kernel memory is a subset of the user memory. This setup is useful in + deployments where the total amount of memory per-cgroup is overcommitted. + Overcommitting kernel memory limits is definitely not recommended, since the + box can still run out of non-reclaimable memory. + In this case, the you can configure K so that the sum of all groups is + never greater than the total memory. Then, freely set U at the expense of + the system's service quality. +
U != 0, K > U + Since kernel memory charges are also fed to the user counter and reclamation + is triggered for the container for both kinds of memory. This configuration + gives the admin a unified view of memory. It is also useful for people + who just want to track kernel memory usage. +
+ +Examples: + + $ docker run -ti -m 500M --kernel-memory 50M ubuntu:14.04 /bin/bash + +We set memory and kernel memory, so the processes in the container can use +500M memory in total, in this 500M memory, it can be 50M kernel memory tops. + + $ docker run -ti --kernel-memory 50M ubuntu:14.04 /bin/bash + +We set kernel memory without **-m**, so the processes in the container can +use as much memory as they want, but they can only use 50M kernel memory. + +### Swappiness constraint + +By default, a container's kernel can swap out a percentage of anonymous pages. +To set this percentage for a container, specify a `--memory-swappiness` value +between 0 and 100. A value of 0 turns off anonymous page swapping. A value of +100 sets all anonymous pages as swappable. By default, if you are not using +`--memory-swappiness`, memory swappiness value will be inherited from the parent. + +For example, you can set: + + $ docker run -ti --memory-swappiness=0 ubuntu:14.04 /bin/bash + +Setting the `--memory-swappiness` option is helpful when you want to retain the +container's working set and to avoid swapping performance penalties. + +### CPU share constraint + +By default, all containers get the same proportion of CPU cycles. This proportion +can be modified by changing the container's CPU share weighting relative +to the weighting of all other running containers. + +To modify the proportion from the default of 1024, use the `-c` or `--cpu-shares` +flag to set the weighting to 2 or higher. If 0 is set, the system will ignore the +value and use the default of 1024. + +The proportion will only apply when CPU-intensive processes are running. +When tasks in one container are idle, other containers can use the +left-over CPU time. The actual amount of CPU time will vary depending on +the number of containers running on the system. + +For example, consider three containers, one has a cpu-share of 1024 and +two others have a cpu-share setting of 512. When processes in all three +containers attempt to use 100% of CPU, the first container would receive +50% of the total CPU time. If you add a fourth container with a cpu-share +of 1024, the first container only gets 33% of the CPU. The remaining containers +receive 16.5%, 16.5% and 33% of the CPU. + +On a multi-core system, the shares of CPU time are distributed over all CPU +cores. Even if a container is limited to less than 100% of CPU time, it can +use 100% of each individual CPU core. + +For example, consider a system with more than three cores. If you start one +container `{C0}` with `-c=512` running one process, and another container +`{C1}` with `-c=1024` running two processes, this can result in the following +division of CPU shares: + + PID container CPU CPU share + 100 {C0} 0 100% of CPU0 + 101 {C1} 1 100% of CPU1 + 102 {C1} 2 100% of CPU2 + +### CPU period constraint + +The default CPU CFS (Completely Fair Scheduler) period is 100ms. We can use +`--cpu-period` to set the period of CPUs to limit the container's CPU usage. +And usually `--cpu-period` should work with `--cpu-quota`. + +Examples: + + $ docker run -ti --cpu-period=50000 --cpu-quota=25000 ubuntu:14.04 /bin/bash + +If there is 1 CPU, this means the container can get 50% CPU worth of run-time every 50ms. + +For more information, see the [CFS documentation on bandwidth limiting](https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt). + +### Cpuset constraint + +We can set cpus in which to allow execution for containers. + +Examples: + + $ docker run -ti --cpuset-cpus="1,3" ubuntu:14.04 /bin/bash + +This means processes in container can be executed on cpu 1 and cpu 3. + + $ docker run -ti --cpuset-cpus="0-2" ubuntu:14.04 /bin/bash + +This means processes in container can be executed on cpu 0, cpu 1 and cpu 2. + +We can set mems in which to allow execution for containers. Only effective +on NUMA systems. + +Examples: + + $ docker run -ti --cpuset-mems="1,3" ubuntu:14.04 /bin/bash + +This example restricts the processes in the container to only use memory from +memory nodes 1 and 3. + + $ docker run -ti --cpuset-mems="0-2" ubuntu:14.04 /bin/bash + +This example restricts the processes in the container to only use memory from +memory nodes 0, 1 and 2. + +### CPU quota constraint + +The `--cpu-quota` flag limits the container's CPU usage. The default 0 value +allows the container to take 100% of a CPU resource (1 CPU). The CFS (Completely Fair +Scheduler) handles resource allocation for executing processes and is default +Linux Scheduler used by the kernel. Set this value to 50000 to limit the container +to 50% of a CPU resource. For multiple CPUs, adjust the `--cpu-quota` as necessary. +For more information, see the [CFS documentation on bandwidth limiting](https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt). + +### Block IO bandwidth (Blkio) constraint + +By default, all containers get the same proportion of block IO bandwidth +(blkio). This proportion is 500. To modify this proportion, change the +container's blkio weight relative to the weighting of all other running +containers using the `--blkio-weight` flag. + +The `--blkio-weight` flag can set the weighting to a value between 10 to 1000. +For example, the commands below create two containers with different blkio +weight: + + $ docker run -ti --name c1 --blkio-weight 300 ubuntu:14.04 /bin/bash + $ docker run -ti --name c2 --blkio-weight 600 ubuntu:14.04 /bin/bash + +If you do block IO in the two containers at the same time, by, for example: + + $ time dd if=/mnt/zerofile of=test.out bs=1M count=1024 oflag=direct + +You'll find that the proportion of time is the same as the proportion of blkio +weights of the two containers. + +> **Note:** The blkio weight setting is only available for direct IO. Buffered IO +> is not currently supported. + +## Additional groups + --group-add: Add Linux capabilities + +By default, the docker container process runs with the supplementary groups looked +up for the specified user. If one wants to add more to that list of groups, then +one can use this flag: + + $ docker run -ti --rm --group-add audio --group-add dbus --group-add 777 busybox id + uid=0(root) gid=0(root) groups=10(wheel),29(audio),81(dbus),777 + +## Runtime privilege, Linux capabilities, and LXC configuration + + --cap-add: Add Linux capabilities + --cap-drop: Drop Linux capabilities + --privileged=false: Give extended privileges to this container + --device=[]: Allows you to run devices inside the container without the --privileged flag. + --lxc-conf=[]: Add custom lxc options + +By default, Docker containers are "unprivileged" and cannot, for +example, run a Docker daemon inside a Docker container. This is because +by default a container is not allowed to access any devices, but a +"privileged" container is given access to all devices (see [lxc-template.go]( +https://github.com/docker/docker/blob/master/daemon/execdriver/lxc/lxc_template.go) +and documentation on [cgroups devices]( +https://www.kernel.org/doc/Documentation/cgroups/devices.txt)). + +When the operator executes `docker run --privileged`, Docker will enable +to access to all devices on the host as well as set some configuration +in AppArmor or SELinux to allow the container nearly all the same access to the +host as processes running outside containers on the host. Additional +information about running with `--privileged` is available on the +[Docker Blog](http://blog.docker.com/2013/09/docker-can-now-run-within-docker/). + +If you want to limit access to a specific device or devices you can use +the `--device` flag. It allows you to specify one or more devices that +will be accessible within the container. + + $ docker run --device=/dev/snd:/dev/snd ... + +By default, the container will be able to `read`, `write`, and `mknod` these devices. +This can be overridden using a third `:rwm` set of options to each `--device` flag: + + $ docker run --device=/dev/sda:/dev/xvdc --rm -it ubuntu fdisk /dev/xvdc + + Command (m for help): q + $ docker run --device=/dev/sda:/dev/xvdc:r --rm -it ubuntu fdisk /dev/xvdc + You will not be able to write the partition table. + + Command (m for help): q + + $ docker run --device=/dev/sda:/dev/xvdc:w --rm -it ubuntu fdisk /dev/xvdc + crash.... + + $ docker run --device=/dev/sda:/dev/xvdc:m --rm -it ubuntu fdisk /dev/xvdc + fdisk: unable to open /dev/xvdc: Operation not permitted + +In addition to `--privileged`, the operator can have fine grain control over the +capabilities using `--cap-add` and `--cap-drop`. By default, Docker has a default +list of capabilities that are kept. The following table lists the Linux capability options which can be added or dropped. + +| Capability Key | Capability Description | +| -------------- | ---------------------- | +| SETPCAP | Modify process capabilities. | +| SYS_MODULE| Load and unload kernel modules. | +| SYS_RAWIO | Perform I/O port operations (iopl(2) and ioperm(2)). | +| SYS_PACCT | Use acct(2), switch process accounting on or off. | +| SYS_ADMIN | Perform a range of system administration operations. | +| SYS_NICE | Raise process nice value (nice(2), setpriority(2)) and change the nice value for arbitrary processes. | +| SYS_RESOURCE | Override resource Limits. | +| SYS_TIME | Set system clock (settimeofday(2), stime(2), adjtimex(2)); set real-time (hardware) clock. | +| SYS_TTY_CONFIG | Use vhangup(2); employ various privileged ioctl(2) operations on virtual terminals. | +| MKNOD | Create special files using mknod(2). | +| AUDIT_WRITE | Write records to kernel auditing log. | +| AUDIT_CONTROL | Enable and disable kernel auditing; change auditing filter rules; retrieve auditing status and filtering rules. | +| MAC_OVERRIDE | Allow MAC configuration or state changes. Implemented for the Smack LSM. | +| MAC_ADMIN | Override Mandatory Access Control (MAC). Implemented for the Smack Linux Security Module (LSM). | +| NET_ADMIN | Perform various network-related operations. | +| SYSLOG | Perform privileged syslog(2) operations. | +| CHOWN | Make arbitrary changes to file UIDs and GIDs (see chown(2)). | +| NET_RAW | Use RAW and PACKET sockets. | +| DAC_OVERRIDE | Bypass file read, write, and execute permission checks. | +| FOWNER | Bypass permission checks on operations that normally require the file system UID of the process to match the UID of the file. | +| DAC_READ_SEARCH | Bypass file read permission checks and directory read and execute permission checks. | +| FSETID | Don't clear set-user-ID and set-group-ID permission bits when a file is modified. | +| KILL | Bypass permission checks for sending signals. | +| SETGID | Make arbitrary manipulations of process GIDs and supplementary GID list. | +| SETUID | Make arbitrary manipulations of process UIDs. | +| LINUX_IMMUTABLE | Set the FS_APPEND_FL and FS_IMMUTABLE_FL i-node flags. | +| NET_BIND_SERVICE | Bind a socket to internet domain privileged ports (port numbers less than 1024). | +| NET_BROADCAST | Make socket broadcasts, and listen to multicasts. | +| IPC_LOCK | Lock memory (mlock(2), mlockall(2), mmap(2), shmctl(2)). | +| IPC_OWNER | Bypass permission checks for operations on System V IPC objects. | +| SYS_CHROOT | Use chroot(2), change root directory. | +| SYS_PTRACE | Trace arbitrary processes using ptrace(2). | +| SYS_BOOT | Use reboot(2) and kexec_load(2), reboot and load a new kernel for later execution. | +| LEASE | Establish leases on arbitrary files (see fcntl(2)). | +| SETFCAP | Set file capabilities.| +| WAKE_ALARM | Trigger something that will wake up the system. | +| BLOCK_SUSPEND | Employ features that can block system suspend. | + +Further reference information is available on the [capabilities(7) - Linux man page](http://linux.die.net/man/7/capabilities) + +Both flags support the value `ALL`, so if the +operator wants to have all capabilities but `MKNOD` they could use: + + $ docker run --cap-add=ALL --cap-drop=MKNOD ... + +For interacting with the network stack, instead of using `--privileged` they +should use `--cap-add=NET_ADMIN` to modify the network interfaces. + + $ docker run -t -i --rm ubuntu:14.04 ip link add dummy0 type dummy + RTNETLINK answers: Operation not permitted + $ docker run -t -i --rm --cap-add=NET_ADMIN ubuntu:14.04 ip link add dummy0 type dummy + +To mount a FUSE based filesystem, you need to combine both `--cap-add` and +`--device`: + + $ docker run --rm -it --cap-add SYS_ADMIN sshfs sshfs sven@10.10.10.20:/home/sven /mnt + fuse: failed to open /dev/fuse: Operation not permitted + $ docker run --rm -it --device /dev/fuse sshfs sshfs sven@10.10.10.20:/home/sven /mnt + fusermount: mount failed: Operation not permitted + $ docker run --rm -it --cap-add SYS_ADMIN --device /dev/fuse sshfs + # sshfs sven@10.10.10.20:/home/sven /mnt + The authenticity of host '10.10.10.20 (10.10.10.20)' can't be established. + ECDSA key fingerprint is 25:34:85:75:25:b0:17:46:05:19:04:93:b5:dd:5f:c6. + Are you sure you want to continue connecting (yes/no)? yes + sven@10.10.10.20's password: + root@30aa0cfaf1b5:/# ls -la /mnt/src/docker + total 1516 + drwxrwxr-x 1 1000 1000 4096 Dec 4 06:08 . + drwxrwxr-x 1 1000 1000 4096 Dec 4 11:46 .. + -rw-rw-r-- 1 1000 1000 16 Oct 8 00:09 .dockerignore + -rwxrwxr-x 1 1000 1000 464 Oct 8 00:09 .drone.yml + drwxrwxr-x 1 1000 1000 4096 Dec 4 06:11 .git + -rw-rw-r-- 1 1000 1000 461 Dec 4 06:08 .gitignore + .... + + +If the Docker daemon was started using the `lxc` exec-driver +(`docker daemon --exec-driver=lxc`) then the operator can also specify LXC options +using one or more `--lxc-conf` parameters. These can be new parameters or +override existing parameters from the [lxc-template.go]( +https://github.com/docker/docker/blob/master/daemon/execdriver/lxc/lxc_template.go). +Note that in the future, a given host's docker daemon may not use LXC, so this +is an implementation-specific configuration meant for operators already +familiar with using LXC directly. + +> **Note:** +> If you use `--lxc-conf` to modify a container's configuration which is also +> managed by the Docker daemon, then the Docker daemon will not know about this +> modification, and you will need to manage any conflicts yourself. For example, +> you can use `--lxc-conf` to set a container's IP address, but this will not be +> reflected in the `/etc/hosts` file. + +## Logging drivers (--log-driver) + +The container can have a different logging driver than the Docker daemon. Use +the `--log-driver=VALUE` with the `docker run` command to configure the +container's logging driver. The following options are supported: + +| `none` | Disables any logging for the container. `docker logs` won't be available with this driver. | +|-------------|-------------------------------------------------------------------------------------------------------------------------------| +| `json-file` | Default logging driver for Docker. Writes JSON messages to file. No logging options are supported for this driver. | +| `syslog` | Syslog logging driver for Docker. Writes log messages to syslog. | +| `journald` | Journald logging driver for Docker. Writes log messages to `journald`. | +| `gelf` | Graylog Extended Log Format (GELF) logging driver for Docker. Writes log messages to a GELF endpoint likeGraylog or Logstash. | +| `fluentd` | Fluentd logging driver for Docker. Writes log messages to `fluentd` (forward input). | +| `awslogs` | Amazon CloudWatch Logs logging driver for Docker. Writes log messages to Amazon CloudWatch Logs | + +The `docker logs` command is available only for the `json-file` and `journald` +logging drivers. For detailed information on working with logging drivers, see +[Configure a logging driver](logging/overview.md). + + +## Overriding Dockerfile image defaults + +When a developer builds an image from a [*Dockerfile*](builder.md) +or when she commits it, the developer can set a number of default parameters +that take effect when the image starts up as a container. + +Four of the Dockerfile commands cannot be overridden at runtime: `FROM`, +`MAINTAINER`, `RUN`, and `ADD`. Everything else has a corresponding override +in `docker run`. We'll go through what the developer might have set in each +Dockerfile instruction and how the operator can override that setting. + + - [CMD (Default Command or Options)](#cmd-default-command-or-options) + - [ENTRYPOINT (Default Command to Execute at Runtime)]( + #entrypoint-default-command-to-execute-at-runtime) + - [EXPOSE (Incoming Ports)](#expose-incoming-ports) + - [ENV (Environment Variables)](#env-environment-variables) + - [VOLUME (Shared Filesystems)](#volume-shared-filesystems) + - [USER](#user) + - [WORKDIR](#workdir) + +### CMD (default command or options) + +Recall the optional `COMMAND` in the Docker +commandline: + + $ docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...] + +This command is optional because the person who created the `IMAGE` may +have already provided a default `COMMAND` using the Dockerfile `CMD` +instruction. As the operator (the person running a container from the +image), you can override that `CMD` instruction just by specifying a new +`COMMAND`. + +If the image also specifies an `ENTRYPOINT` then the `CMD` or `COMMAND` +get appended as arguments to the `ENTRYPOINT`. + +### ENTRYPOINT (default command to execute at runtime) + + --entrypoint="": Overwrite the default entrypoint set by the image + +The `ENTRYPOINT` of an image is similar to a `COMMAND` because it +specifies what executable to run when the container starts, but it is +(purposely) more difficult to override. The `ENTRYPOINT` gives a +container its default nature or behavior, so that when you set an +`ENTRYPOINT` you can run the container *as if it were that binary*, +complete with default options, and you can pass in more options via the +`COMMAND`. But, sometimes an operator may want to run something else +inside the container, so you can override the default `ENTRYPOINT` at +runtime by using a string to specify the new `ENTRYPOINT`. Here is an +example of how to run a shell in a container that has been set up to +automatically run something else (like `/usr/bin/redis-server`): + + $ docker run -i -t --entrypoint /bin/bash example/redis + +or two examples of how to pass more parameters to that ENTRYPOINT: + + $ docker run -i -t --entrypoint /bin/bash example/redis -c ls -l + $ docker run -i -t --entrypoint /usr/bin/redis-cli example/redis --help + +### EXPOSE (incoming ports) + +The following `run` command options work with container networking: + + --expose=[]: Expose a port or a range of ports inside the container. + These are additional to those exposed by the `EXPOSE` instruction + -P=false : Publish all exposed ports to the host interfaces + -p=[] : Publish a container᾿s port or a range of ports to the host + format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort | containerPort + Both hostPort and containerPort can be specified as a + range of ports. When specifying ranges for both, the + number of container ports in the range must match the + number of host ports in the range, for example: + -p 1234-1236:1234-1236/tcp + + When specifying a range for hostPort only, the + containerPort must not be a range. In this case the + container port is published somewhere within the + specified hostPort range. (e.g., `-p 1234-1236:1234/tcp`) + + (use 'docker port' to see the actual mapping) + + --link="" : Add link to another container (:alias or ) + +With the exception of the `EXPOSE` directive, an image developer hasn't +got much control over networking. The `EXPOSE` instruction defines the +initial incoming ports that provide services. These ports are available +to processes inside the container. An operator can use the `--expose` +option to add to the exposed ports. + +To expose a container's internal port, an operator can start the +container with the `-P` or `-p` flag. The exposed port is accessible on +the host and the ports are available to any client that can reach the +host. + +The `-P` option publishes all the ports to the host interfaces. Docker +binds each exposed port to a random port on the host. The range of +ports are within an *ephemeral port range* defined by +`/proc/sys/net/ipv4/ip_local_port_range`. Use the `-p` flag to +explicitly map a single port or range of ports. + +The port number inside the container (where the service listens) does +not need to match the port number exposed on the outside of the +container (where clients connect). For example, inside the container an +HTTP service is listening on port 80 (and so the image developer +specifies `EXPOSE 80` in the Dockerfile). At runtime, the port might be +bound to 42800 on the host. To find the mapping between the host ports +and the exposed ports, use `docker port`. + +If the operator uses `--link` when starting a new client container, then the +client container can access the exposed port via a private networking interface. +Linking is a legacy feature that is only supported on the default bridge +network. You should prefer the Docker networks feature instead. For more +information on this feature, see the [*Docker network +overview*""](../userguide/networking/index.md)). + +### ENV (environment variables) + +When a new container is created, Docker will set the following environment +variables automatically: + + + + + + + + + + + + + + + + + + + + + +
VariableValue
HOME + Set based on the value of USER +
HOSTNAME + The hostname associated with the container +
PATH + Includes popular directories, such as :
+ /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin +
TERMxterm if the container is allocated a pseudo-TTY
+ +Additionally, the operator can **set any environment variable** in the +container by using one or more `-e` flags, even overriding those mentioned +above, or already defined by the developer with a Dockerfile `ENV`: + + $ docker run -e "deep=purple" --rm ubuntu /bin/bash -c export + declare -x HOME="/" + declare -x HOSTNAME="85bc26a0e200" + declare -x OLDPWD + declare -x PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + declare -x PWD="/" + declare -x SHLVL="1" + declare -x container="lxc" + declare -x deep="purple" + +Similarly the operator can set the **hostname** with `-h`. + +### VOLUME (shared filesystems) + + -v=[]: Create a bind mount with: [host-dir:]container-dir[:], where + options are comma delimited and selected from [rw|ro] and [z|Z]. + If 'host-dir' is missing, then docker creates a new volume. + If neither 'rw' or 'ro' is specified then the volume is mounted + in read-write mode. + --volumes-from="": Mount all volumes from the given container(s) + +> **Note**: +> The auto-creation of the host path has been [*deprecated*](../misc/deprecated.md#auto-creating-missing-host-paths-for-bind-mounts). + +The volumes commands are complex enough to have their own documentation +in section [*Managing data in +containers*](../userguide/dockervolumes.md). A developer can define +one or more `VOLUME`'s associated with an image, but only the operator +can give access from one container to another (or from a container to a +volume mounted on the host). + +The `container-dir` must always be an absolute path such as `/src/docs`. +The `host-dir` can either be an absolute path or a `name` value. If you +supply an absolute path for the `host-dir`, Docker bind-mounts to the path +you specify. If you supply a `name`, Docker creates a named volume by that `name`. + +A `name` value must start with start with an alphanumeric character, +followed by `a-z0-9`, `_` (underscore), `.` (period) or `-` (hyphen). +An absolute path starts with a `/` (forward slash). + +For example, you can specify either `/foo` or `foo` for a `host-dir` value. +If you supply the `/foo` value, Docker creates a bind-mount. If you supply +the `foo` specification, Docker creates a named volume. + +### USER + +`root` (id = 0) is the default user within a container. The image developer can +create additional users. Those users are accessible by name. When passing a numeric +ID, the user does not have to exist in the container. + +The developer can set a default user to run the first process with the +Dockerfile `USER` instruction. When starting a container, the operator can override +the `USER` instruction by passing the `-u` option. + + -u="": Username or UID + +> **Note:** if you pass a numeric uid, it must be in the range of 0-2147483647. + +### WORKDIR + +The default working directory for running binaries within a container is the +root directory (`/`), but the developer can set a different default with the +Dockerfile `WORKDIR` command. The operator can override this with: + + -w="": Working directory inside the container diff --git a/docs/security/apparmor.md b/docs/security/apparmor.md new file mode 100644 index 0000000000..0743694644 --- /dev/null +++ b/docs/security/apparmor.md @@ -0,0 +1,41 @@ +AppArmor security profiles for Docker +-------------------------------------- + +AppArmor (Application Armor) is a security module that allows a system +administrator to associate a security profile with each program. Docker +expects to find an AppArmor policy loaded and enforced. + +Container profiles are loaded automatically by Docker. A profile +for the Docker Engine itself also exists and is installed +with the official *.deb* packages. Advanced users and package +managers may find the profile for */usr/bin/docker* underneath +[contrib/apparmor](https://github.com/docker/docker/tree/master/contrib/apparmor) +in the Docker Engine source repository. + + +Understand the policies +------------------------ + +The `docker-default` profile the default for running +containers. It is moderately protective while +providing wide application compatibility. + +The system's standard `unconfined` profile inherits all +system-wide policies, applying path-based policies +intended for the host system inside of containers. +This was the default for privileged containers +prior to Docker 1.8. + + +Overriding the profile for a container +--------------------------------------- + +Users may override the AppArmor profile using the +`security-opt` option (per-container). + +For example, the following explicitly specifies the default policy: + +``` +$ docker run --rm -it --security-opt apparmor:docker-default hello-world +``` + diff --git a/docs/security/trust/content_trust.md b/docs/security/trust/content_trust.md new file mode 100644 index 0000000000..06024a9e80 --- /dev/null +++ b/docs/security/trust/content_trust.md @@ -0,0 +1,302 @@ + + +# Content trust in Docker + +When transferring data among networked systems, *trust* is a central concern. In +particular, when communicating over an untrusted medium such as the internet, it +is critical to ensure the integrity and publisher of all the data a system +operates on. You use Docker to push and pull images (data) to a registry. Content trust +gives you the ability to both verify the integrity and the publisher of all the +data received from a registry over any channel. + +Content trust is currently only available for users of the public Docker Hub. It +is currently not available for the Docker Trusted Registry or for private +registries. + +## Understand trust in Docker + +Content trust allows operations with a remote Docker registry to enforce +client-side signing and verification of image tags. Content trust provides the +ability to use digital signatures for data sent to and received from remote +Docker registries. These signatures allow client-side verification of the +integrity and publisher of specific image tags. + +Currently, content trust is disabled by default. You must enabled it by setting +the `DOCKER_CONTENT_TRUST` environment variable. + +Once content trust is enabled, image publishers can sign their images. Image consumers can +ensure that the images they use are signed. publishers and consumers can be +individuals alone or in organizations. Docker's content trust supports users and +automated processes such as builds. + +### Image tags and content trust + +An individual image record has the following identifier: + +``` +[REGISTRY_HOST[:REGISTRY_PORT]/]REPOSITORY[:TAG] +``` + +A particular image `REPOSITORY` can have multiple tags. For example, `latest` and + `3.1.2` are both tags on the `mongo` image. An image publisher can build an image + and tag combination many times changing the image with each build. + +Content trust is associated with the `TAG` portion of an image. Each image +repository has a set of keys that image publishers use to sign an image tag. +Image publishers have discretion on which tags they sign. + +An image repository can contain an image with one tag that is signed and another +tag that is not. For example, consider [the Mongo image +repository](https://hub.docker.com/r/library/mongo/tags/). The `latest` +tag could be unsigned while the `3.1.6` tag could be signed. It is the +responsibility of the image publisher to decide if an image tag is signed or +not. In this representation, some image tags are signed, others are not: + +![Signed tags](images/tag_signing.png) + +Publishers can choose to sign a specific tag or not. As a result, the content of +an unsigned tag and that of a signed tag with the same name may not match. For +example, a publisher can push a tagged image `someimage:latest` and sign it. +Later, the same publisher can push an unsigned `someimage:latest` image. This second +push replaces the last unsigned tag `latest` but does not affect the signed `latest` version. +The ability to choose which tags they can sign, allows publishers to iterate over +the unsigned version of an image before officially signing it. + +Image consumers can enable content trust to ensure that images they use were +signed. If a consumer enables content trust, they can only pull, run, or build +with trusted images. Enabling content trust is like wearing a pair of +rose-colored glasses. Consumers "see" only signed images tags and the less +desirable, unsigned image tags are "invisible" to them. + +![Trust view](images/trust_view.png) + +To the consumer who does not enabled content trust, nothing about how they +work with Docker images changes. Every image is visible regardless of whether it +is signed or not. + + +### Content trust operations and keys + +When content trust is enabled, `docker` CLI commands that operate on tagged images must +either have content signatures or explicit content hashes. The commands that +operate with content trust are: + +* `push` +* `build` +* `create` +* `pull` +* `run` + +For example, with content trust enabled a `docker pull someimage:latest` only +succeeds if `someimage:latest` is signed. However, an operation with an explicit +content hash always succeeds as long as the hash exists: + +```bash +$ docker pull someimage@sha256:d149ab53f8718e987c3a3024bb8aa0e2caadf6c0328f1d9d850b2a2a67f2819a +``` + +Trust for an image tag is managed through the use of signing keys. A key set is +created when an operation using content trust is first invoked. Docker's content +trust makes use of four different keys: + +| Key | Description | +|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| root key | Root of content trust for a image tag. When content trust is enabled, you create the root key once. | +| target and snapshot | These two keys are known together as the "repository" key. When content trust is enabled, you create this key when you add a new image repository. If you have the root key, you can export the repository key and allow other publishers to sign the image tags. | +| timestamp | This key applies to a repository. It allows Docker repositories to have freshness security guarantees without requiring periodic content refreshes on the client's side. | + +With the exception of the timestamp, all the keys are generated and stored locally +client-side. The timestamp is safely generated and stored in a signing server that +is deployed alongside the Docker registry. All keys are generated in a backend +service that isn't directly exposed to the internet and are encrypted at rest. + +The following image depicts the various signing keys and their relationships: + +![Content trust components](images/trust_components.png) + +>**WARNING**: Loss of the root key is **very difficult** to recover from. +>Correcting this loss requires intervention from [Docker +>Support](https://support.docker.com) to reset the repository state. This loss +>also requires **manual intervention** from every consumer that used a signed +>tag from this repository prior to the loss. + +You should backup the root key somewhere safe. Given that it is only required +to create new repositories, it is a good idea to store it offline. Make sure you +read [Manage keys for content trust](trust_key_mng.md) information +for details on securing, and backing up your keys. + +## Survey of typical content trust operations + +This section surveys the typical trusted operations users perform with Docker +images. + +### Enable and disable content trust per-shell or per-invocation + +In a shell, you can enable content trust by setting the `DOCKER_CONTENT_TRUST` +environment variable. Enabling per-shell is useful because you can have one +shell configured for trusted operations and another terminal shell for untrusted +operations. You can also add this declaration to your shell profile to have it +turned on always by default. + +To enable content trust in a `bash` shell enter the following command: + +```bash +export DOCKER_CONTENT_TRUST=1 +``` + +Once set, each of the "tag" operations requires a key for a trusted tag. + +In an environment where `DOCKER_CONTENT_TRUST` is set, you can use the +`--disable-content-trust` flag to run individual operations on tagged images +without content trust on an as-needed basis. + +```bash +$ docker pull --disable-content-trust docker/trusttest:untrusted +``` + +To invoke a command with content trust enabled regardless of whether or how the `DOCKER_CONTENT_TRUST` variable is set: + +```bash +$ docker build --disable-content-trust=false -t docker/trusttest:testing . +``` + +All of the trusted operations support the `--disable-content-trust` flag. + + +### Push trusted content + +To create signed content for a specific image tag, simply enable content trust +and push a tagged image. If this is the first time you have pushed an image +using content trust on your system, the session looks like this: + +```bash +$ docker push docker/trusttest:latest +The push refers to a repository [docker.io/docker/trusttest] (len: 1) +9a61b6b1315e: Image already exists +902b87aaaec9: Image already exists +latest: digest: sha256:d02adacee0ac7a5be140adb94fa1dae64f4e71a68696e7f8e7cbf9db8dd49418 size: 3220 +Signing and pushing trust metadata +You are about to create a new root signing key passphrase. This passphrase +will be used to protect the most sensitive key in your signing system. Please +choose a long, complex passphrase and be careful to keep the password and the +key file itself secure and backed up. It is highly recommended that you use a +password manager to generate the passphrase and keep it safe. There will be no +way to recover this key. You can find the key in your config directory. +Enter passphrase for new root key with id a1d96fb: +Repeat passphrase for new root key with id a1d96fb: +Enter passphrase for new repository key with id docker.io/docker/trusttest (3a932f1): +Repeat passphrase for new repository key with id docker.io/docker/trusttest (3a932f1): +Finished initializing "docker.io/docker/trusttest" +``` +When you push your first tagged image with content trust enabled, the `docker` +client recognizes this is your first push and: + + - alerts you that it will create a new root key + - requests a passphrase for the key + - generates a root key in the `~/.docker/trust` directory + - generates a repository key for in the `~/.docker/trust` directory + +The passphrase you chose for both the root key and your content key-pair +should be randomly generated and stored in a *password manager*. + +> **NOTE**: If you omit the `latest` tag, content trust is skipped. This is true +even if content trust is enabled and even if this is your first push. + +```bash +$ docker push docker/trusttest +The push refers to a repository [docker.io/docker/trusttest] (len: 1) +9a61b6b1315e: Image successfully pushed +902b87aaaec9: Image successfully pushed +latest: digest: sha256:a9a9c4402604b703bed1c847f6d85faac97686e48c579bd9c3b0fa6694a398fc size: 3220 +No tag specified, skipping trust metadata push +``` + +It is skipped because as the message states, you did not supply an image `TAG` +value. In Docker content trust, signatures are associated with tags. + +Once you have a root key on your system, subsequent images repositories +you create can use that same root key: + +```bash +$ docker push docker.io/docker/seaside:latest +The push refers to a repository [docker.io/docker/seaside] (len: 1) +a9539b34a6ab: Image successfully pushed +b3dbab3810fc: Image successfully pushed +latest: digest: sha256:d2ba1e603661a59940bfad7072eba698b79a8b20ccbb4e3bfb6f9e367ea43939 size: 3346 +Signing and pushing trust metadata +Enter key passphrase for root key with id a1d96fb: +Enter passphrase for new repository key with id docker.io/docker/seaside (bb045e3): +Repeat passphrase for new repository key with id docker.io/docker/seaside (bb045e3): +Finished initializing "docker.io/docker/seaside" +``` + +The new image has its own repository key and timestamp key. The `latest` tag is signed with both of +these. + + +### Pull image content + +A common way to consume an image is to `pull` it. With content trust enabled, the Docker +client only allows `docker pull` to retrieve signed images. + +``` +$ docker pull docker/seaside +Using default tag: latest +Pull (1 of 1): docker/trusttest:latest@sha256:d149ab53f871 +... +Tagging docker/trusttest@sha256:d149ab53f871 as docker/trusttest:latest +``` + +The `seaside:latest` image is signed. In the following example, the command does not specify a tag, so the system uses +the `latest` tag by default again and the `docker/cliffs:latest` tag is not signed. + +```bash +$ docker pull docker/cliffs +Using default tag: latest +no trust data available +``` + +Because the tag `docker/cliffs:latest` is not trusted, the `pull` fails. + + +### Disable content trust for specific operations + +A user that wants to disable content trust for a particular operation can use the +`--disable-content-trust` flag. **Warning: this flag disables content trust for +this operation**. With this flag, Docker will ignore content-trust and allow all +operations to be done without verifying any signatures. If we wanted the +previous untrusted build to succeed we could do: + +``` +$ cat Dockerfile +FROM docker/trusttest:notrust +RUN echo +$ docker build --disable-content-trust -t docker/trusttest:testing . +Sending build context to Docker daemon 42.84 MB +... +Successfully built f21b872447dc +``` + +The same is true for all the other commands, such as `pull` and `push`: + +``` +$ docker pull --disable-content-trust docker/trusttest:untrusted +... +$ docker push --disable-content-trust docker/trusttest:untrusted +... +``` + +## Related information + +* [Manage keys for content trust](trust_key_mng.md) +* [Automation with content trust](trust_automation.md) +* [Play in a content trust sandbox](trust_sandbox.md) diff --git a/docs/security/trust/images/tag_signing.png b/docs/security/trust/images/tag_signing.png new file mode 100644 index 0000000000000000000000000000000000000000..9a1f9062b4dc6d30942ab7c4f47dca5f5df2be31 GIT binary patch literal 74416 zcmeFZRX~+pw>AvRrF2UxT_T;*-O?qEgmiba=xzxGq(efwQ;;s{2I=n3@8(f_-o5vG z{-69u!t!48o^#AG$GFBdu1T<*j2IF;9y}Bj6q1CvumThm7#9i(ln?t1_~g>?q!IWB z+D<`C5UP0K#U>OKKa_;9fRZ!xP6}M|^BOc8k{IeCtc8WF2uW$<0(JGQ>}o(Of-Mu}5%Qz@Bl zSNZN8d&R}YuG{%)OsBim^VFvWAN|14u>4RURBtFS5!BxwCB@V1;l8Zf{FnbC(uE~r zIuQAv&;RpPB04ZC?vhWmyK|zQ%t>WbWWd^{;y!`(+=KpxW|Mwdc_Z0eZ&o@PMC+44&(K^X0a4Kgj zxa6zXx+_d)pgnp(gDg~Z>$Se0|L^^UkYIETOi_?(ClT9~v145(En#tI_Lkb_oN|0K z3SClZwR`k~EL^~sSn%cQp8Vs_t>jTDm@bS8OP>GsbkvV6?;-Eihrt1ko#Qdh&DH!zXM2&R80?Sk3rhgajqAg{ zc7pTI7ly;U;Sncz_@qCOcl)-&BF3&s?OB2YSgxsmzWlu={$MyFrZ^m8%s<|&Af~$- zIkP&wp3}2~iH~mC&OvF|eJE|(wSb0$KJe+;pBH(Odv`5PM7LS~GYTv>G$u~53!4i_ zXr_a8#YBsw6b2=r#p@F4&pLu04lF!Q8S(GmwJCJL0Y)?sVy;61L|<0}iO-^2t==t* ztNY+8f!|@Jfgi9mLZ&y;A4}uFk}2xGsTM;pnJd8)AkfDl3=#bOq|aMm?5<4Ng?|Qb zaRRHTNs-;1^yM;9y6JznZ~{N;^?eWQDx6j17U?67S}Q`cWu!6>C385ti~r< z68!BLWwH3X5@k!b&DT?nC@2BKWjVhsp{r zb&A6pc=RzrLJGzsu)lqgs1XRhSrg8~`2Sc~ToJ@)KL5(f^J7ZfJZpZ+E4OpPw~`tx zk3o~)6^$xIdoG>*(c#Eq`ET)XyUio29$n+$4d5Ewy!?qUzeDN)HKg!rY^9G*dKJR{ zA=I(}SISg37$YIoF}Z@PN`)p;9_ul@Mq=AzQBn*f^m91|u3(=EJ`HHTDURi4 zcS-NlE=|viOtLM)S5Dx4iQilBAdqpuk>CHU;(xt&(HPWBkg~e6(Wo%+(F2`h zq6vSd)W5QF^$Uz+%ml9vL3xX{W+vWv`Afq-$_0rOed^9}hU`B+hkC#b?D-%H+A~3- zL$Hdv##sO0JXM`YDn;YKT&3*RSWny)E3LfLHu&JbY$yS2;mW!jWSM;0Bn!pUWX(M3ChvAN|M(`+q7#r1 zJP8GM0{IzX^Sl{c)=ZO(q)|^YC(soA_|HVmjkRQDc1ML}N@r6fP`&x7;e53y&c&CI^Nk!8fP&$4PBh`DW)WSxY$xMOdNZcAI*H~ zB*!XNA*=E|f8R|Cyqgz~=B+=!1l)~5(K5m9onTVa;`PRNLE>=Zmwf&2$YYBl;gO%X zRz*SclpR=8`QcX+qtb)Mm|u78*BNyKXP-m)ZaY(CxM7}gxJa32s?07j)@w#eN1`BL zZ1t?QawVamQRc2>oiA3Vf4i%z*R?0r14i&DCA0*iNURZ6JE@B010>xdwv7N07V*7Y zt>5qXpG6E&XjXrPbS;tqxF%!?6LunG0vC535iTqSz zvqIxT7qNIbnljDL*di|1iE6bCnv=Ojh?SthXaIJ!qh1VF7~0O+jgXZq)RM55SltuL zfAfDga$r~Ar7GoRzeJnYlBNwy?^UO?RvgyvD**T*;tmbHdyV+oH#j88{9f|;hTFn- z{h8d4xqyJeo6!G{Wr56Oc73n%qUSj*z6O$YCvM8FLsg7#Pn2Z0t+u#zs$S^M*HDL;!CSGrky z`E$Kc1V^4d{pR9+VLob>x5=ry&TM(>!e>`SOnTz|=SK^6DH@_lcrWRy87 zwS>yYvi87eQVNh?^v&BegX)aBSj9+MBxq7RasGc`K#LcEN^jUdyhDV5;5N=;Np`X8>pyBvH+#G_t3@y;+gZzwH}VTXI@b_bQ&~4>c4B47nm#%Tg1paua3@K@#jl>7 zy~Bi6U4^UZ+LG*FoO~MC%__@0194AB^Uy zVAgi2%bc#MzLw^fK%!O~&Ek@K;bl(iveUdk#PA#wZ}m^)G!X_8O!%|dV*Zvh-J#5s z0G-)6Sg13HjEJpQhdT#%Ok1Z@A8`Gv^brW0S;#^-PoE|5#}&Pn66uaaQ{pf)>+Nse zi5^z*P&*~*G!IrWEU)YAvX#sqYbX^cerM z;2r=6u6P|Zbhz&#@{#kPa;`Xv8IJ>X4BeL@-6%X9g;;o`MlQDa`IJvt-(O7o@vEZ^ z!MUfHe#|bd%xaYhq>=xX7zVE}IPL0qKL5nA>ZZgcceJvn%0#nmw%RH$L7?dCM`3-+ zmEE65@m&XIuheQHF5uWmBOYh)JQ6_Mhc$=K!Q3MJKm6eo6FAs5$@r8(z7~G2EE_6r zb#vJi;TVTim6e7cR*xLffNugpQi)1ceSotx-`-TE*Twaub3x)`$m+^XDy>29z?{t8 z?f6mlu8Ui?S#Mn#t5am`HGa%vw~(nt`npS>Yn}5WB{hpCqiyVz zgJ6P9!^It_ywQ-_BEtgqBBezLV@-7Dd-(kwiQe7Z@(0nr=FK0QXvdjGpB!+0TG_!o zo?X~?VC3c;sHb3}MGX+)J1I2J=@_$}!9peNV%*UwW{>VdB^f2-l2}&_V+L^`JS-}L zD8_wdEjrDAA4n*0%mZqAm1qJ61rw*uL+clMZ0u%fD4Pz6(35LbrO#tJ;_*4;d-R}z zP!BMnUt0=Qyo-Nr#c(220j_o_EnYw`c)$bI8ihds?w{U}XbA;~Z!i5^j|d-6 zlC^~kzQSUc|FejlpE;0|-O*gn5K0l~}Kb?BQJ^ZINkrIEeaUJ&94Z9N)p!yC!T6)sTSTjFW- z01~I1MM-=7w}6@dAW|x709il(_*5+nmvS&fla#kDmW=*@>9 z*{Td;ZL*M^JOxP*%Qd?OoV+P+N}gJMm)qzit43mhHxWfqS^v8ytx29BQjH^ChesEASu{GmtA?`Oa%` ztINhF*s=hoq4cE+eF?uip(U@!qj}dJC-^1%PwImLwUPqFM+0MSCokoqHg)=pimS(V zkM-LWodi&3P5iJLA>eYOA=n!5QL^tO_HBF+lL&qLjJ8}Mf(M2o=Yz+PZ`?_EcFU+;PWkmz;-x_2pcoDO6Et<$b+NIjkT0mlv7WV7#zW6{ zpAKiYiX)X(v$zsp=H%5R=CdXygVsP!f=!0~C(=T^0hILn{h|C95r~wRGz7lV^}d*e z!&tbp8NnW3fHRDm(&8)c=bbL=g?^a6{pFrU?@lCAIwFyfgZYRgw9Byj5t0yff#1=g zt^Ca0Zz5fc=!_aGsj~?`)1svDotv@TVvFaq=swkFFTs7-J|Urlj${G=T0P`EJu+`f zp|BPzWQY>Fbts}|Sf_4zFA(EL??ejNlL}p4vvsNQXiQdf0QmeV>c&_VWT&DkMYF=v zPCQ@RV!QXAZ8z@pvye!AuZ$Tfp=Z4eTYXj9C=BcU*kD3$x(93LmMmwkot8axEjx1LFln>7T*<1A>SmAdTJOXTKzBt z0Ohfha?VP8_#!@+wQI`iB+{q8dHMz@ll3Tc zNhtI51z!kJtq7|PJg4RRkm>Ts8$v2b_}>Op;K^{t4uI_?ASw3w5IT+nyB^bb{aZpV zBmM{8@t%9wRYF8bU=lj}pv;yuk9^g}vP-{nsbe$cqUWjotdH>=ni4R6OEZ-H0^dJF z-83l)UZ+cuZ;f|F%_e)~Xy9387%t;EVn0}49@b!tPt>z=iRy($?pMVn(${N(z0byk z6W*Fnm3DT2VKEA?s9burq4E*H>s*)L+^gPJq)N$h4SenG#_C6rP53geGM`i{$!6Xg z*_~!+d7)(#Top&sfL#37NXUSZ7Q?VF@EAyO_ucN|}LC>}RYO@;eHlH}6dMaP7ZkYec#@Xek5t3R zwsi{M^uTMu+gL_oiLFwSE>ChQ3p-Wh>BGHrymH-)93HyD-}`X;`J}hFQLId=dqRp7 z0q@N2#iP;1y@2eu$=7kh5Dt4%HLkHO=9H9Z9*ne1I~XuK7pRYC%x*-dX2q+9RM4y6 zCX)~rl8=B~yVkkO)Uz5Wx+XLhTg(8I9yw+-pVk)VmR@ zmAdsD|G04b!@=%Q62o47D-V3eFK-{=q|ZZ*F}WJUvMn?irMx*k_{>@ z=-k%+w^3yXToA;|jK~Yat$W(YpvxQC>@4CwnyEpM=mtAfb>}-WEPomptYj=V z81QqSo~6>*9IW+ys5J!D>zJ^v)1g3WPE>K3z9vD;81b1FNo!RcIgT)avx z{=9eWb|y(yo>QGR(+6OAV_!|@*dXP5yd|G1(;ti$^I|MaLURn zc~%xuulo+^$uNHRYdKnEU|f0>SeT(%H9ZT4%Ml@n^D**LvoCyqEkzi zasuI3t@Rknx|40Q?NQmP%5D#dyH=U#_V698%?1r>-470utf7?Mt+kEZ`34%aG-9-s zlWMD0f~v+VtG?NXVsoeCK|XF~d1LTv6i< zPw528n>U|Yh|N9<6|Z)e=&RnHm5U|7_fJ)>drzigsi=E}Mk`d@9L!Pd7-g=`obN6( z#$*3@N?9FORO_}&Q@dZOrZ9s}K*zKDW~!2Y!A|fPAliP<6Z{z{QA;|%%)@wl?{N~3 z<5|q{GO?R0WJrv zA3T5knl@Xdyc5`x4%g+t~#v+RkEDF6k zv|_b?5kt*+Ozg^8sZOnAKq_0Ynn)$w<@@7-DEx3U)#y1D?f`2Pf5jR07%No^mU)b` zCl6d=ss(-*cId>6+TVcrA056HE-=gF@? zKmP+GC$$+px(W)qP}O^yI$wV-X`O?{jofU^w7q~SJwGKVXe-pALy+1)WrXYez?{3T)TNGx}jMG>H_g5b1~{T~$o4 zTDp`%ui_Vk`Pyre8lb=Qxbc&tRQjDU!NJ7Oj?_e60dmkM;`!5tdk* z-crBW5L@PM(5v+xRF7E>!rU5Tpm+0~wH8n<56dXIszHGep&A=oFwaa)t5nGsz0IvJ zS2btg;@GH)bvt{>z0-{|9VMfFK1@n4mSKj!-V76zo&?QkmnY`cc-5ronr|)M@LSOi=+A%KaY%3Cf_>NJ3=lFK06Gzhx|II-|J6dI{}z}G5R*x zS1ka~@mN~>0jG-Cy9NpR8@k;4_mdckf_n6M6F%^WrOtF@U%gD*SbghoWJ4(D6D_!3 zRM2V-r&saW?wSOfesU#VL;#&P^KxaRL?2zNwJPnhEQI(fRI8J}Qsi7<6%cvWZ)NTx zqEua#ToD_BsLy*h&}1KRjY1HE&8xYiY4=#8L4lV7+UU{}>Mx{5(c`z-)X$Q3giz6Z!_bRdAtU#jcj^EjHz^yS@} zldvOkqZIBP{1(mpm?Vf$xd8ArnREySD@gJuysY8DQPO=#eWcGE-sYzlcZ?MX@X)Y$ zFgX=*m?FaUH``dV+x2@9p|XJLRs=@a$LVPIp3^R91pr6;4<24r24y#z;y3~gFfojS z%$CJHe|V(ZIySp9inm%6gnmy8?JaFV5Ejazv=0HJktKFg*Ey`&?zK$vZuhEYxC*ad z#|t?R->56U_WuVPxQ?QKwKbINUARB_oY@lt{nxc5C846zv%oF{fN2hvt^=2GC#7BI zd|RtVJh)%Pl|{#%R#Y+vJS!msW+DRAKtC2eGaSc4#zhlFWDRN4A^(>1OVZvtIENIH z9;o7|(BW-qR(HEu0+^xYb6L0U)RBR{it+3ec}^W87;8DhFQx;$`QYMuP;QK!7B^m8 zBa8iAdDII~yMZ{ekvatEM%GX+y)4`6N}Df|)HM1^J@gI{FYl;oJqH(q1$Cui2WdE4 zxlt)exE@uU6B-lDX*d>t3xh&nQXf}ou_}1@;xrosd-P(7Cp^;v&zBY5Oih1kQL^y*zJyf}iAxYed>hVK z0S^${iFF4s-Fffk-FMci*9qbxn=ZcqRB?Zl`*jn+3`;Tb$DV|b(#<=zWe!|D5&fpU zQM?x9PJ>NRH+1n-E+c6e1`D1VeHY3=K_$z{Qbg``?V*}m_%4)|;Bue6*i7aT!9LI^ zsJMDY9T>psASgz~j?<&TE_1N0OUWQ!&e{quE-{0lRiY~s6X`T@R9FyXmgjo4l0IH+ zXY0EIU*O95_Go*p=bf*}K<)KPs;W^feadk`>RmfWwd@%oH|aM%5(Nxl zNtF-#z%L4*Skr2gvW5psT$V7 z6IG{?jp47UBTh0zQ4!#H&t~O#Pd-Y$3EnG5E%7Edgx)B8&Bu8`K}VtyQTTQ~1KSZT zQY>n74z;?LCk^CVo`%`)5qS9iL2?hP;3ooh0j!s}Nd|6^C2E5=H_5$x%{H0)FOc}> zVM3t8eehHFy=e*TO$9l-+{*#e#3l&s6V@pEznx@Qexe~@1t6Xq`}tn*EQwG&CM5OW zfbvfYY1syzXy6r`gnww>Ldp@_cEj=1@U4y+x<-qCm(Im|sLphzQWTjaHPfuL+qb2?>GW}=ZAyMB&wIyB^|b$%fhQ-57@F33}`V03Ey z>%90qA3#U>^Amyts0_OPkZ4&jkh0C6NUqS36S4y@Bc~Wmv(1*3qylLe?4o(H1U?1{ z*9tST#%cB#f?fP8CT(9=x`yK)@JY2~ooLts!B+4(;V#~Gcr^ISXbe+E171Y@-FIo0}|*I_ic2aT#CNv%PD-Jx1(?ko(4U?%uk;g&!>GFEsB26 zdunPRnS%GRzh5{QHOHgCzhUk=JSr`mR=rZfp2H6w;VHQm0prO|!~>iD6muC+AS~*G z9{OD{^xNdHh`a>CZv%h3>hov-cAyE!BZBfN(yT7Ny!6c3IE#oiDvUuXB!7-yczlpm ziqw~Ne*hnPFhe{c8kCoc7Na^TBJbz>eM^ow%PF^msRbRYu7adX|9wLZ3N#;v9OV6q zArBhP4R_GwAD%S`0=xyWgbE&-9(Bk&N(jc0i4gO}TG6Dg3%hyL4q;W#*VCtNNPaWT zHfE_Cls_dJG1b|=($$&yg}~DUi?i5l1$wi?CjY#A=dxHvVCx?HX`TW0^&@l=e*>Tj zKhhj%Sh5Ijp!?U?(m1M{P0p5gktQZh&70@cCaZBo;>z3J#(DbIc&er@U-GFR^>`&b z!l{|zQa&n5%P2IEuHHCr$OWtKF08(*y;lGSpbMX-&4Xemo2+_dD0uuaP$B3P0??d_%lxie>Nq@%IAlzkGI0I_>j#_UfVqDQ3y z)QJtcuxx*#i4VW-$eGqrI3^D31bmqK=xCv(a=u(~7)_*&gp&L=3jIXC`gnznM(WM} zddjbA_{Qv`@3bIQoUx z&0)vL`;DRWGKcM7v~&|i8kD}zkYcur>t(jai(Z?J7e*VUx^x@{Ip1BbuMR~Q?X2}B zVJLKVgyT!ksdug>=+I?~hBFPGZjOjy(QEIJb5DYxbF zIAf9F^91OK{Hb%Dlb}d^6U1OL5-7eS!D*;(3*CzdJp4)4#Q_?+1qw_O8b3{#Ow_!V%4IvjgTU7MW0Z45@gU=<-3{ z8BM;MgErB;p=O(YMFF|q6qmK6frVWdLU&n(Rv)s{?F^W6Fx0@_mN^KRc74mx2F`xilx&M26q1 z%V}e%)tNAF9n$fkB$h7oqTkAMnZ{y>J)QYOpLGw5`J`M=0=-qp{mt>JPalbvC5Vg+JZmdhT?Rk|` z=*ntb_66=-opZNhq|f&CY1FV6K1)vfVykaI^UY)5AF_z5EBeoRpo!9~@JPuq33=~t z?2H?f7F_V$vc&wvlDE=)e{02jIRw`p zO5bE0ul&Mk)@H4#9yzwv3*eLW(1r|Us7d@_T$Cb-wNfkG&i4d)LTBeCOobEZw8Chq zpXZ6ENo*IWeoH+x7&e>Xl6WeDNnB|zDjI-BF{&t`2>9NW)emJ=Epi?ALw_`UrHhJt z4+fND!pGnU5`ZG?;74RmK?KSxgn8F(+RcULW`XoxJeDBM-Ra8y&r(_n?Ay7`N#@IE1~lAVZQCAoQ-03il)v1_j7)|LsYj+o^|Y861Qp5VMPB)HD}`-&51aS|3Uu4K6? zh=Erq--v8~>6a5vtI>0^Ig*l%tX!b-@o>5Gb9LSoh4L~dpbgv12&H4P9O7jB`39+u zMo7{5<*$hx)O&y&3K33|&lElCB8^NeG6dp@{xLfjkS#D0<$cRd7ss5PvGQ|$I!s-F zASaR_m+urqaqE<2yV~=C<70=}5PvZT2glk1N~2EH#BeZWs`1?}4)cdFL>vbGP@u{1 zyI6t60VWS(TeN4N1fN)B-*%KSpmTNy#ZfEe=~lIb*++5%xS1CmfI?{50A;>UT68+D zVfC?oziEa>UoJ8r!xhWFQ_@DKKx~+KkXzp|ZOBebC0jsuzkZ*W5~r}kT#nclh?qHc zzqBRy%x;~Qw+g>#@g5VcE|*=ZZg5nNr>uK<~hZj^*3rTkX6n=l~g#56{%;P72(8s?tntLwbM6n^Km|paTW^5*t)fT38GIl9$)duu>&Fn0NyVyx3<|o4)gaB z?*yP8ayDTp`D?nrj{x8l&|DI5KZ4SK-vsL%%&$g|>r2~8BKK7(U)LdV{!yq2K#)45 z*T2(sgAg!RE`2m{sf+ihUGH;8P+^I6@437WaD4m`fQAGt_`)d@Hj3(j=_2X|TGi18 zi!8qty_evoyDKwX4%;ku06ttMCI699Kg|0gp8wT05<2gPrkA{4_{CO)7gv{Vh@}Le zLn2`G7W{7Kp)6!ra41wWxex372~e*czyP+sVU&6Iz)2F(!u5S(?R92)o5IOTdo7mx z*B1Ok0Qy0#Ks%T7a=BhiZ*6%Fn-v9>iulS;b_Df+1KLyS!X1i{5CCveAZMnm)so>? z55~G9VsP5iT<$(N>?FKy(=B`~yaA*~_3-tlOTRvlz#W_sN89J)gYJj{DW+EkycF>w zE9fTvU^++_<-tSIxN$GA{xLCs4{YCO_CaSR_lsYFugW0-|A7;i!~m7fMQK(J&clGB zy3YgoKcTn85=+CxTM7`tfiGyI!Cfp5lmn3{FvoV-u%&+-1(gqkfJMWQiU^^^+HyZ^36TvTj1YgJVfwrD5`?8u zD{FUVYPjC3_m5j)`%9R5dlNp;9Pi^wO65S+^R5LOGhyOiB3^R!NVCt8Ew~>`r=P}E zcw2P-z}BG&M1D!F;sAsEA_{m?>gebw&1DjF7LH^9*;`$7Npzr*uC z2b@yAC2E%*^i;YFn^v7nmiICXfHlgz*E{8Yj^@4bv^jUl$uByea>qY20-#cnMs@rH zDm~ks!S2nB^9KrP8jY$xVD7hPGffqQng3y4LAW@i#ua$b9hqFtTinhAY#n#`ud3fH ziybm}-+u?Ytfx5jo${Q|lIAAchQ!f+PW*N!f~`dcz|eRApi6EJmzp{MgUI?nu`1-s zyv&zN_ZguC7>r`@bcKmNH|}ty*9pR7kb(t=^Xq+37swR%;t_fX%o$Rc)T+fhllFkm zOXbR>7;Fw_m+Ae0pQ^RXB^5ND2O=WrmOz@sQy;$j%faCW7rS*A9(k*vPC_rurt3W} zc>$px@R;Z)y9L^O2Q5z&01zcF8$jrJ(HaDHeEI-;RJC11IwD?fI|C5(JDlw=f9#&k z+%J~#&cH=(TEb9Q(Yp zkb0%5;T;9~d8a554b>oi zQsN%sx1)xAI1o&_El~CEx@-V@+D@C~CN;?N-6~z3Ze!anc%)m<=`_v4VhaT#vkJBX zMM3y^``ztzxHThiK+j1BYT;3Y0uUJ|R5fk<(NL2=k4t>hZVYQl(-U_dX47%qBzHOa zDb`TD-gDhVFD{_K-_2kj`p9TQ6T-WJ@j+MA_zQT_NiOK{e zvO}q_9NKb{O zewN3OzWIRab~kFLcVxCa4m$bn7!6DUr@wj(krS$^so8duC%lQQ$vl=#<(}$Rl|@De zH%RK9ZjDh;__{Jbs1Y9z|BbBoD*7FvkSnU_VyrALTrY=vJ_xdRmu51M%t3JmN!_-E z)2d68SY}5g;GUcv$wsTYX*na2lV94a-)ED;xC3${-Z$v$RF|5l`;D035X{$jg8=}n zQBw>ruVKn|0csv6FuZDXLb<$HV^m7o>&tc529%Ti9!T$Mo%Xet9p3Xmb3 z)j;pOaRi`FmAw6g8>5!rP+_jwhJ7pUAN|nY1B5x<02NXwTg;d)RZzD!SqpRp5``ac z>Qn$VMHHKmgjk%nE7Zo(Go+imL#&-d1h4z+h46KVD*|9F5RVfAf~!UDET87p};gpHSfsCa-2v|?8Vbm(I|S(0wd9SDSUTD{@X ze8ttC*WXwKz4tB-T44w$t1}2#&xEwKQ`Jb)9r6SH>BgLQD<{IvA+B!<)hl~wK3l71 zq{9EwcxTEJ9W(7RrmULe9b4D_T?Ws+Oq*xEYl{1gYi!H;f|nI2mCapiREa>#`neiGV!ESJK2`Hc3ar4f!tJJ4q4&kN9vm;fbpO z=Ba$oADjYu;BpUiASchPdugi^EhroU;pXZT8eg!qEK5+Ptk`SzR+vo;yggxM^KHav z_j!uYcjSlsk~5K(hLs^D1iQ{$;EP)Mhj2x)3XC~Rg#=UMVJ(6ajyV~{1T*6oPo>X> zVR)(&q;8IS>6r|B;xhf7(PE?m8W`Yrr>f=(0C$oN!d&x;!8${{LlB&qo^zvbP2X3q z^V!W_&1IM4sQ`+h)hw4b(+|PzfOadU+O4_p(xzSwSvO%U_^d%5|3Ud_xH0we$)Th6 zkHiPf2uWyvEAN(V%o@^H3DIoZ3`B>`_D{*XG1W%RR6<-PFG)K+$$@5flvpuOI5`y? z&L8nS1O(uL=TLzfcf`7~18uY_^8D4oJHy$bwb{KG_UlhQdhZX~P$)v zh$BrK!2KgFp?Kd~=Lc;25*fv$*MtZV>*Y}3Gz^B)!mey6k@}3SzU5zrE2DDk zHypo}>jXFvAnfrlB){FxGMgx-Aj*0fDzMBAP$p9kvIFNBZ`bpU;q+%nc!?>B+$IL_ z;a9pH)Gk;3wZ!uX4rT@qeY$KTuHNMy&dB%=bluV4u)jUrfpG}QGxCK;9-JTLEAoGa z2@}A>D58{RlMATQBnHpIvjTt6sZZCi%6@paLm{I>>{=|*C|J=1^k9<=pZ`oH2k_!= zAdXg5vZ4`%1>SiBw)_TFug^K<37oPWsak+M>92|g__>8X1-SK&XbdgewC_NR`4bCW z+joD2lr($1ZQX}_HzLjc(uL$ctzOKyZ1?9ogssE0Ufk~^7S(ef^r&i{Fl)PRW)nk* z9F`0xFli}##|!jA8p(6D&D_+1zQi|-q5T?HCgCgm!@AwzD%qz2FgkbBXgDXk*V(r- z-MysGdTJXrFsT^wEI6Z^E|>Ol+#?;sU)VV;dCaF+iJXL4!(UzqKZV}?qM7rsuWmsjmTordW-a(PpV#(8*@9(kuau zeRNy!DU=hJjIWqXmHCujJm&@-mL(cVL$Zg*#t<>7k8vT4GvD`-EK=SfyoBqAuTV;>AUEOr8LH>#g$ucn!0L zhh+F}804aV`C-UdSNU-Rv`)6y{oMyuSS{Cd2})7=h66##CBhA`v_202o`oNn6n)tO zm7*1(_P-@G?V_YOw2GD5a`B| z)vIx7y&oCl$}rimlL?Qcns=f9G#I#@BokJ%WN^*a`5f(_*DCn=uXMGCiM@JAb?7@R zU%@vgZT!_!Bebs_65zGg(n_&e7_wYhNAu)K4WE2XMI7WgPoAPsoa-Navm6%1AM=Vi zEPxpG2~g!7z4w=mTRx@WZT4?7IuE~;`~b)#>FlTcnm(Spao$JVyurX*lwYQA=kj;+ z$qMDiu#)L69F%P)kLmXR=Xz;Y4A2yz-h^qe@WcV%AVg*CZGYPRxLvI-uzwT*@19#c z2;_0`UQyOz&Lhu|Au)56YCDg$B%>_X(=FmwDN-zC{+y2Ya_It!85BM0P8S-NTt!+K z17-0t7pzkPOk;P#&R#XO#+nGH&wkoVc6NMt6?)CP-c8U8;L_z=vuWv4Q4M|{o%|+ zFrw~9_Os;*U;eF{OSLo!STgE=H0u!l2l@NS!HCO4|3pL6S}YM|-!QgLIXiVVU#{Gg zd|AEdoHcPK{$;(PFFBoivyE66DYb&J$JI~cn;;}&XG#0?B~U72AX?o*$GQ1Jp0H-< zQHfhw;eyR+2GCB{mM1t>!ewVqxuH}~{y9*FF*Yvoh_e2{h%XYhM3M2#sl}dI+`#KYm62I)T%7Y`^w{0`$~M4S8p0d zUgZk<%23nojEn~%4Is&ch!D}!%ceRn!F6|aMSZrc%YWyP)hl#X{B-)u8d3pyw#F9Y zd)asgj%Y%WfRB9U4)1>G*GuM>fn;WvmkFvt1i$`hq=^_FTFuO(_Rm3^Qv3_wx2nAM zPIsnf2zK#$rW)0I;8e{0-zoe!GRy+nnrqDVx?-0fE@d+yt3V=S95Z$UGBavQ91kE( z0tbgZwS1?BiG5)32GP*d@h-;SKsufoxF@t37c&OT>MPge?DCp{?H>UWECXN?C=_0; zKz>ftq3Xo8)I{{9#-S<`+SkU~Zlvh#nURzPsyZi`vB9dm>NHZc^gt9gO?Fz>INFiE z6{&_M`yrzX@We;=cMJE-GvDWJdudBmTQJB;Lh9_jZux-ivT$96T5F_jpQ z?EbxI&IE*3GG8VO;84I3qe|$?+5C!Oj*u01t8!{9AoMb7e`X=vh^Mr|Z%jpS1XLeO z-E!RaHeRN=r&?$FdbK`;Vo0C=Des9=;NoP~2Y#{xOoj)X9|Gb>>bQ??#hm2tLB5}} zLU5+ztMa?C@Mg{0=2kf(WpwZFZkcRX#2@OxOzb6@@37{RpY|JvdUEIA?7czXyCXxy z!+fk^<%k||?V&Y52m)PVhiymt=sfN03~uuuqC+@{-ICMeq!X!h(^V82#s>wxE@d_T z)r!TM9LwF-GZxkU3-Gg*d(L{ftbCT$vKX$jHLUdMrhC6+R3)|2;6hM?w3iKAGeA87tM#Ny>xR0_mSXH`Xq$Se+}3w6Z)N)IHU zz7jG~FUvM7t20)%!hUS091EwIPsgvD>*QNhn63;iW?R-faLMedX2iO=b5@5~oPQFY5xxBl zlpsn#5D-6w9pVM9s~Ldmp1%hoQOc1QcW(LAX=}Im&)_}o^r}e-3xg>?>CA&=Uld;B z23&ahqW_j^3%mrKMKYdi{l(+M}LawbzF0KaTU}2`wYx&TD>@ zzufvG@xAy6v=nv3kn4$2`9UZVx6_*r=gatAF1b~X#flyoRe92mwlk*dHeqiU2e|eP z0^ty(FAOd(oz}#jVFhYpGVmtVkLPcGZ?Z_S<4a8*EBDv0I(r=r>VHj0Ycq{EMA}=u z6gC3)c&EkYL26-?rUbBRWC1OJ3M_+=ON%ir(_IS^JB(mm zZDoNA2Wo^z9o(trN-ZVTo}=EedoS^prew;thO;Rg7vBPA1mm6R4%w8BKqb_?U$^`9X`=frK7s>K71$1N1j{TwkT6A>P}; zD(qxn9s26f^c=YOZt#87P{x5>$35m`cY3szZZDXwxn>X@hovMdr%!TqbvJNe-KxHZ zfBE7?Gx-v1?AHgvq&*lgWir2l^bQ!{vboCBco_jPnTzXp&5>J6K#Y8QKQS{xwdZM5 z*Qa)sS$a4?+}PfzJv$PR+x14neAEj=JP>YU#l5Rb0vS1Fl$UMC-ULvM#A0s;H%;BI zx4R7J*D?2a?OmnVX$@m&kz`@G^VIqK8=rn%OzVBIw279stIfVes#bYdf|F*U!<-k2 zxHU)p3Dyo_RD%4f z{bkg#D&5eyEhP~TV`A=`ZsZhqrQ#kGlOrzZ>*{-BB4@N2rJUO}w!S+>zg$QZ3EZti zJ3{>a9yTIQ2blb-kT>*0Fo+=W?y`Q4&J-i!P57*vWcS|DKHu;5gZ(Vex_FU3wM(7i zXRj&Rg!%L0Qu&4Ptr$23dw}&8Hev>DAu$b4EC0B~(rU!JaifZQ zR7&n#Tdgq~&sqKTH6S%|)dWAo6ioHBD?UCqInS~TN8J2boW8L#-`FRV@Ny%@H%ZFY zV0oOozJ_CKp$7@uK0I_?mMmQWUq1R5qEwcW<4-?4jM<-hx%EnZb`v!yTOI;O$UwKi z*@&j(;mr`vn=u}2&r0267V69qG*E)#e zIUQ9jvs;(B+}63LPD=WJOnn7VR$KQsARW@(U6Rrz-Q8V+ba!`2hk`+OgVGI>qLg$a zAl;pQ`%&-zduNzCUgnwS?6c20Yp=C_0c}vKk+a=nYk3w-i+c~={GzaGH>E#P1Tw1U zK9rZ9@QgR&Z9tq15wOD`6t)qQ)e@fPPEojP{M;MSlkQP5GRL}J^b83}yz~tk>Fkg< zcetkEw^+03i5Ng)q86!yk!>2w=_Xz334O>xrT{H&HZ2wp20G~t%i16O101|E;0!+2 zk|l%=Bq%^_uO^!2Z4UB#eE!l6^u8O1%qo`=4_BS%Z@%gJdzZIDn*YXZxHzIL)a132 z686A(&hZSIWZ1|-72K?H1uS=}l?DB;`Ken!X>jp1EoxGgXMcMuTkXu|Z4YDaTj2xO zk>9?&?)*`#nX1IGA0V}FQ>iRrbwR~sET!?Vz)wq^vAwlM$-h|*a^7B|oc$~@#Rgm| z3}+RrT|L&>KsiT)rGVquhoQPN^554{aU}fep8K=O-(CqXy@gj5IvQz=D;90)%2`I) zy{sMxO;Nt5?xRp0jZS{q$+?V4RKPJ^pg^+-6V{OHBJ-M>-Fo5nqsUQ%*4~V#xl+Sc z>LuI6N+##HiWno22`NInpi4*nSybz9xT!wjzk^j#3;-jT7w zx@cS*4SM{{A+{n5FT5kEE$r1p|C?yNtJkdNEp<~mm9=3Qnv6MdNqJ|xyEy&CyEms{ z5@n6S{RA17ed0CgPfBK;A4(V@;yTwat5s6s)uTYH0~q}|t;T6wrIq@lK$qlZE^94l zq(8&#$}Wrh3WzL^Cud%pj1QlN+B${5`=aRTwZ+Eh;-=xEs<$AQ?rt3y8KZqHW1Qa&@co6K3j9#_YpD@uN!znA<{(GYUx7Fy2-);7DpQIwu zi0Qa(VZC~au)T2!7M)f-ddfMTYMMr;op%T`vJR$-9_`4`&j^@JA3SrY6-$3 zgL+Q$-e^%2RDoPT)p86mOX98#n4W*d`Myi_qu7t3dgYF6(&ZNxKB04cRQ9dkj&G-0 z#a{wgzcJk1Phs|kmftpjXrWtq-ndC8DqvJ35(Skhkb(EWiYBBxkaar$@NMp5ow49f zQ|Z_$8Sfq0KQg$eDnwiDv9ZGo>o03M+7Z@KJFn7EM6}!ac)^C9y0(=aq+HL)XlFuS z)({m;#Bu-g(Di!`t4nt80_o&XBddxt3IP*W$(Cpx7dW~{SOP{!CAyn2qp&ZY0i<|; z!*OQhb0Se=_d$1#XDP<2vATJB{LD#>tXmN_w#0x^#M7(mzH*k`f0B@Ez$gs+Qx0RO z!Yp_lo+ynzSlE^20(MOhR~Bl$-3(+gHYW6!hrDY{>`nB)W4M^wSkSBqzPp(|e!Z`x zU=w`)+aZu@zqS7~r6#r2NKhrQrFUH{{VIa<$0H4OX>@Kk)4}QofxzUSVl-dy=Kl`8 z5WVBUg=eH;{Q%_y1LmUQ;Bvnp6}gk9vGP#ly6@3qp5OP}dVQ$IOk!VQ8!J|04PWP1jZ^Ys9}wX(CopMBv9pyZywZ5zs@>J z-)NXxLg<{$Rulwyq^%I)?$j{(o<&3U*M>zfq0BqVs-yc+1tvy^ZEti`B99NKmr}Q~ zstQqK>c*E6S_2$39Nhg37XvmKkqq?JRmr&>BmL$EW8t3hGM11X{u_o(K?(abXeyIz(qx-jq2H;b&sBCfWL)ZiVx)FG z<*D8c%i6lnsga{u3TWtxpIezLk6vfK=Pr4bU36ZeK&QP$(qOlFJ4TDl$o*}qX@T_$ z3tcCk1*HQD!BP;|+)Z2N#o30306y9vT~LYbcV1HY;1PyZt`S`)kVvx5N5W zFQW#u?POY8!BSJ0>W@ zM)l^h6hE3&Q2M}mAw$0PKdoI7G6>w#9A$tA0d5=X{=&4+uOH2JmUAsEBlSAUlSL}e z7WTQ^P3iB_UP8k{7)&U-(&@ z{ixV|jZu;%p3=&FCbha;AHZ9TqyJK-b;E)D`m!KM;h~OyCbi#68fka?k+l`1lKt@3 z%(wBUQct};jPHA-%k?$u4DjMUv;NDW36%k0iT6w8L`vW;<2VWx?|0l^tRVaYzrK$& zw%eiHD(<|565q%@8ARxKUW5!wT&Es!g@f|JhH;+hme0ZVQ_~jf3%WUXi`Z$&xzYpzK}i925(!439_-{j()Pk6C`{d%$OL_ozumG9G%HWV z%;!KlOZU#3`ZIoMy5nCToWSdd%d9QQn)IvLr}fIOD9Xq0GO8D^2JOeuXTjOs0k_k1 zxH-$8KJGKs3tiH8e(HYhDQ#Q{#%7_Ue*;tzT(g_R%NGrL1xpnjI@5i2XWZqv<;`z( z{A{zED+5V~n$-D7{4k|_>j4zjrY>*JI>)6JYxDv!Mz6RKucGRtyMF&S&PTyLHQx@YP1K@D_J^L~dNv=#)p5Gun6iaxNBZL=#of@xl92y|CULNcT>rUS~jM zU|jj|r2dTW9}*WTo->adesY>A|u)QANc-kpz8dbB($`YTWp!gsyC(r zjAkvk**qM{mZ9693>+9t)jAROk5S&LHSKXz&-_;(J;V+GR9nVJ^31AHA>8% z55696iOO-dgfU@EwZo9G`67kP)ip|5PV96l@8Wc}{JG`IV_1UB&A=?Fh8+F6wF1|JD zFmu-7FSjZ|2wDD^-Y!WF<)-ZLgo0cYf|~fPV+4aJodsQf)eTCB^fp2Sg(5e2)y8c zD_Sx!f|r|>OO`2M6v?uimO*3$!09I%wJ*4z`h*g6e%H>Zt}JWfVV|02=XYHPgP$Vx zoqoa%TJz8ulY@;+SqlW@Y0L3EDKHAyl8t&AL)x06_dcW8;1wPU%_bQt=3*6Kb%Lvb^coeelpajDH$rE z`$Madg~P!R2?I;+EXCaP)%=67TYBtPbIawPmrlA=FQ?d3ligeeddEkJD{~f&vDNs* zPM!q-9zVo-422+bx5SD67DhA)#Zoc$G`e+CWR5kk8Xgw+>WIe6m|z{{aDh;)_!=fr z!O02;QW%7<6%w}O6+wGSD=iBrgSbuneIYB`b8ru447-uN>ne~-wdf9o<8)pX-2veChB);1siDtBH*c?VY>MkA#pow$ zX)aX9kZS30`*vqOiTI+T>=P(t-tt}r*H3;q2*^DE?sA#ud(#!N=3%cJh|#bFyl8WiX1k@ZLzrIv zoN zcIvzXr-m7=`}8+1K)C%=;2n`bO@34UK@`p^6&-|z7Cx*I@g-fk#O3xXx5pTm>L@`e z#K!}+23#%&6<*c6btqk=$}NfkmD$V}Oc)*z8M8Ehvehv#AAvuLlUjYY7A3YCDYQm9 z&70n$ZP*tXs(!(QTWEH`l!v)fZmG>B)p)S@vSDNR#;17OM@-IWn48^LZW$I|GidBE z08Gft_Luoy9ZW$-75KSUNxM4 zq4*BZ1-GQ;Vs>5t_v*l-;MbG}P_2`eT9Hn%_?_%#C(i#6nQ(hwya3xUTIS#*XrXT~ zy@_{i54`4H?esk32-lQ=%(Rl6JIhd6$=z7+LhyA3(B{Z&u5gqvyTG6u3RT6v!z=gT?!Y0!v$6!te z!#?N^v5q4J;j)6JcT4aMJ?xxt*y7S+W7vfJ0#9ot=kj1)bL3!2Ag?9~@lMnEx)+NG z!1XSZ2D$-H?xO1}3zd^(Bd{|7w;fOpByP`lsD=G5pWQ>t(_{k896&v&c85&qml{sr zi)F6g@)if_fXPb3W7VgFSKlD>zKx137V*=j;9#uPMpy`c641hcE7oc|2U48WJv-tz z)q%o%f#z|!1i`M4uTj#s-}+1&Ov+{j?Px1yQC92zB&K z?!pM5P@JwQ)a=_UOUJRT>E3p;p||y8`nD%s3MLWvO6@}C6hSI*Vkq0ffeNtht2=;< zxoQJ)e->HRIZpyP{El$P$-YqmcuXYX^a9CmC3`;~Qs4U!2>S-n~hWy#_tCfScv#nf2H7+O(-`D>U3YTrlz&i8-;nlV-lSo?HnMC4oEPl zbp`0Nb<+9^IA@>%H4-;CZR^O4oxH%Mm&wShb@5r*XO~g7E*&>&%WFErWvs7n;Rkp?&{^D5MhnFN4X{n`fgh z5MrVbw>gm-yMXxt7b77Vsw3=tR)Zb=l3HXZ?FaaO4SO&z2*K6wE=b{8-Vljs?9z~C ziw*vQ^-S0;{N-bMhkK}aS$Sg>qm`ftKFti{GAb(p89yoiB{NXQ(HUi(&({3Vcr_RB zvLof4!t{sBlUK5H?B1Wuz#!07mmL`f0}teV|p*dce$6M`L1DfcLZy9D5sWCc9|k)Wd@M1oa6YfCZ|Vyn3Un0-^!F8oB8n; zf|1~VeB&Hb@X+DT)>uLF1p{;TiI>kwwf;u4$z~vbp=CV+zPK*+((X3&=s+O>oKp>N z0Kt|$ggoRY8jOkViiRImb+?vZon40d7k9!G!NKx*ng1M6x;}uHzKx$%7Y^XF-eBfk z{Cl_PATV}k@pvdkd1T}u^EaOE-7A%4|A~n35Bz?Y_J9lxXr***EJO@MAvbR+UePa6 zO`{AsL@kK0%|`z7!G=cM06@>6RW~6BSZEmXZ@Rdj6nhSkR-w;cTlUauuL|6;RKWir ze&JzLyDK*n)#7#JC`5RBdGMji=-jANyK3dv>|*yR)v>ti!dk;9N`u*xza1|W%nexZ zsh%@DG@^HK7r~6D&u%v$9|@c4*D8%!Vy9m?9SOYvqsgt0*vU>EH~oMM{*Dulgp6`^ zxm&C~rY&jFv+3Y0)M55Ns^tGn!WijtI8e@&I_c0d_y+60QS=qPX}SU49+9vinu%x= zW-#Eq@d0chZM7=hg=3?>-_nD+l>EF?-f z`{Q~Wkdc?H2sBz`iNTLKIj=O?#)6Q&ekDEgmW#rA;T+|Z-I;HSjgI|`*&~^P5Pq?F z;QzNr1Ygw#$mQ@y@kn@L6iL92GCcDWk+w>#E~;nHetv)YSjXJZ!CS{IxRWO9ajNwp zcAJR;3eS}v0mf(Rp5ux5De3knFzEj+$@>jRU&f?_`=O#;h)wj1hfq#Ckz#iZ0$a`- zfw8THHdCAJ;)QSH`d_IE%KhoFz;1d2i`KBKe%M$F3|W}9EYuxjvBot& zh`wF8u_mSJfknO(LXn0@TOcAq*Td#5yiLrnG#Oo=zuXPisA+sFFphwK7}=F+chO|n zo6W15ELEHH{$-&VXR@CL^w{x;jdWJ6{H*%zay*XTQFbbkQEkcpPnYQQ2li^SA<`}s z3<1O@B$G~e^3A-f>aA>JPvlM^b5niR^s%SA;WmSV_mcEa5r!3+_@ zYQp+K%IWO(TGcRj!XyKGRgTJwgJMVk$ipWUByzY!^%_9^u*u{Xvjjwq%6lKC=J79(_ zbMS@Wz2bPLs{61Onl=&3oI>#a-7YZv;mVPDtEb<4n&+)v$og-hZ4LqABbn<#2g!lq z?DQ^u_Vy^Zr`tJP=LQp4?9fwWc#po zO?3i0o~P#Vc~72MVPku-#duY!$@|m)UEqI^e$bn1{x4;m7T?(0Y|?d6Rv7xCC1%5C zJ)!jU$1lSP24p3}o zG6Ng!=de`Zqat6Zh{J|zKkh%#{tw5;AcrYj*FdX>yhaQn&{qa3XcXy(L!{}HLS#}c zSHkMQr>l&Zsbvz<0ArYC!r}Dar63XLF9}{9ax}amut7UwqK&K6o7mRV6@*!+H+)#G zp2w?VbDyme(-<|RnY1f1l6Xq~seZs>8Ni`%O$IK?NS|Z(`QUtLu^uAazqFhut#_K2 z0kAcA=MI_x2^_q0j*Cq>9>R3z)&?On6xA;KTY$ua1LxfgfRrat}Fh zzD6bFmjiQ;x8ThTnEv4JHsy(nU&l6256Fofw%Ky#bV)?1X8W_XtI^cZnHhiueZUD+ zemhg;>6+!*N(sW3x;{V-ypg7%oD8As7ja+E5OP^38G0>ws5d$qjS~=N`=7?}&%``z zkLN=;$7zd;hBvEW=!zZ6`NHd z|B(WszXrvXf&I}N>x*TN86ya|x3k#%*?ytnyEm7$5g0nB@VosYSd&~J7H}`IUu>#X zHBf|xc=kggF<4X_;0QE0Y;QoEO3{veazXR)^bT@iBcBB}8ErQ&R!&_ZMh%>fU$OM+ zd^Oa{74`V*)f}`w{M`}H2@zY9`cWDVrynvvGYSU1aC|>yA##9M24mBe22qn`si#1n zsr%~td&{@%Bz(@I%K=wL8q#plKsoc3(CQ=QAGrrmZ=d#Js|;=orCP4_L`V~OZ@$rq zW1p-xc>y7?W(sfx0ZM(pU9MCto-5GF5OF}5Ps@Hs!fGyJeX;4rzH%c%XNuIilT}6w z(U?qpl4V!uLDyk7fo<16V^4q238G&!lpQ3JPe>4jLm_oT<$CRea;a%bV&Gs%N#blK zGDPD_W{qCe1m8YWDPW35gU;41ITd{!ESpM4iV6!uLm4uu1oNAp*QtkYZpr@Ll1=BZ z)!foM!AAchi>;A&EBw4vRG}N6fD}nOQ@|q+37aljfPYyMAlxx`J#2msjBqd}qEN7Z zf7-->roKHCHzE`Yu}LD>sbwx;HI@8ojQ97$=Z(@A>3zJ1JzX^|O%}!xdD2ttW#lFi z=J{VrrQI!a!(}V9`ZCLmM1J)Y+RG=SBH&NB6Y!9(`b#q4^MLh)MXSO4P!PgC0D} z^y`@dfR?wH_ll%74Gpjenfz%mt*jhb{ z8@;#ITSbV3gw(TX28;#7FPwp>1u-n5-4%RT{tdGZ9z1daGi7=oQ)J-7ZOmE39lO;C ziM*m>0qBAd`{1tzv<)OBj>!>&q5k{?>mYRvu4=V0kid#|k;3?62mY@7Zv7>TW@y$q zDIt?FXnlnD?0&xGcieX-?{|amQ!sl3VjLzst+1HUE2a?qzxfPBt9pKTZpmF@q;+0A z5RZgoOvtQ|X4&5lr_D*hsIVGI?3e>6-O==SVq%4(g0X#6IEW-DVJ5DsvX0Q@u#PP| zMJfG*XJCnTsklDA6KIcTQNbGc@v`h;8x<|jYb z*X4L5Yp5XPWmiwLf>kyW-Zj8)%6YiELW$@d&zDh%#~*O3DSXesD0|!0Ur z^Szdc*lEHt zEX?qpb!gR@m0N*;~w?VOS$&5sZ<-!nD3xa@$Nup1ij$j=zX;@ozKYKUsbWYg6En9bC!uNk>DN_A!&JDa!q}RaeJ#d%d36rykMP z1D)auJDb!M3C-UDlm2Z%SGcPddjkg-mo|vz>3oyV*{j|8`f}%>)t7U@W92$*W;BRs zXt+N7zq)~)1tT}NmVYB_81LYUUPM4p}kMCd%8UhJo3K~+wS4#;bVwt8x7J~-F zbVSy2AgH7Agl$a5CN7)x?sg>qxY5#wPrR~u;Ee!{0rlrcHA|Fs$m`_&XpV{sPk)b^4SBV4p`$OAr=d{d^mfO!KHB@3U5bgsO zn_PgR-f``z%gw2!S<|X$oIIV(<|lnBKE5VHkG4!S95b_#K7B?VD4y*ss9#tu=unp&{0=Ij5Hv&0TAmaLpyZc`KAPgp=7m;hQHgSFa0D3}hq;O6k^n0yh){ebnyq2fLlf69j0)!U_Ds`dW?RU z;?fW75wIHhh@3yitnULC0hIMBRD4EyLC45XpFbP|rQsMv#B~2V+vgYIk25GJu!Jon zQ`R*h<_%cL=9*vzCwJ=0^`^gwRBLlVccl`@X#2}Z^2%Tq=^5yGcav>v7#069;_6YS;0X3HI6ZZKyuyz zRw+zct4^H{bW}gj3eJF59%K021>SE#@9Bubxy$1KnO~f@oUk(J!SXm>_G7SR5A1-0 zm3GC4oNea{i0fXjJGNhFn|~PqC1dX=e~0s!}fC~8p>rE*9cIphv`)biGk)5YzGV90AkK&!84~}^fkQ zRmeiO0*kbyWb`xFXV3{fqjG`xCdb(tu%TgL5h>lJ-v(j-_d(e}9+a>57$1npcTfZ3 z*MNKpB#{o9pI<4Nk;ux+W3fJk2>hh(!&icSXI>X&zd>STWaJ8Z^nV>2OYOISPA>8c zpKWa8?r(zhxT535Wm*(_zzZ^X8~`Sa=(Fvx$!> z7!nUhBIyhaW_oWN9Gu4U;J#-Hrq9BKow+@O^X#^sD2PcqAQ$phO?#7-r3}$!m#C0I zC!neE3`NFd3VIJ+JTNuou+^fb zl@z9ZJ;3*9yR2&Nyyb0@~o(Asgwv!~vlYN3(- zcVjwXndDMi?QR`J^sB63{3SwusEksVd~f(nM9ItBXm~8`x4^$mF?=ysqsntK@%rOz z@T&dKQ@(zv6g$|B6_`gOQ5Z;~v4UisXN((9Apf%h$vR#YY8r%)tOFfdO<`&dQ(<8$ z@ddo#ii*%iAon}J0lB3LOCk__9^+U9oYifk1l+Tf!7(AE?6asabTl9hAt8_&!9&A= z9GMFxi31JUKxAyuRhfv8JV-2opBW^@4?Ie}mJF>aQG2v&h<|_k_rKgoqC+`!0jV?b z#prY|pvM9*YN)`M;-dP4-01usTwgg~TpIG(V?t;KLjOo2+`li&EcG#nP!!rH2-}i> z?(W~WjqD_B0e*Fj!BYkU z{RFeiutzj3rV5my1d-rEk%aQ@u#l&Bt^j&75e)grii&3so-i!`cbI~kpIR!*F}9eLBSw*f0+zUKo-rm1mY9keoYHOaB;oMS67i5AH~<47Cnsm! ztWe$mhDetjSP&l)@?08ya54JV=Tb2gIXaN=_1GA5#86EK`?z~5a{#$1(^#;`h7wca zzg4pe5-^?8U?80M@dFIanf}DazpYe#3qJYvRMLhOqw5C(z9}U$BEd)SD|m8KcXZe` zNhmiYwh*aW$d|4{hd`kx^yPwo^B`{E85ZW1&oD4omrO2?QM@?4Dwh;{oM48c%2Rhf z?mLJ5HIk{YHJV)vsz;4@B5uXeCs1)p!PS`lm8%v<`j}+oe9xTh#-#u<_VKf?q1X^)5Kv&X>P#0KcTaPaZ178CNUim1B!tva-8 zT)Kbs_Sj}ItPu@(0A(bZVb437$=;_|nN?ywIQ(QGxP1twwXh`Ff;#3A|#`_4+)EK%orqG!p z0q>;~NaVmd#3PLn{%nZrQ$N)c1ozhGX!U8Cbdo z=s3F5zEs64?^&96?M9>x<5ButaPxcS%SJzqQ53Gdk%KuT*z0zsg;ZlUdTnrld_Qpxk-O;vsmkX z0~rZ6PSzCk^5-)qLF313UrGV(M0%g<)ugG_$bpo5uF#|JmZtn^E6v6UvYC;2e9T| z`h?tyLCz^O5HKZTq#npH`dI|W*ri{#-2AbEx~G10b@q&N=~(vDdNT`IH+mG;A;Nh;cU@ z`A%65sxvf?%FV!gCaXT*)ca)fy-LOUVR@8xUEEVnwqG+rNIbSfo4C0KzPug#Md^F4?LP{sp zzc5!!DR)vurzdJ#?3>=Eq53~w`FIc-M!I{_`3ze!&}!%#F_epHU4#nZys*Cu);`Q& z397#flvxBbFHzRG@2I~Q@L&RH!eHhXT;X5&n?YS&ISgtm zIQ?R_KKp6%71n|uQ}S=WVopB{eRE;OINCLG+gUowP7TG+{w&hAahAOCq|RbEH09_T zT=mb7Jf#1Zd(WUS1FPHJ6$#%?=Xf_XDRg3P!-j>p9n+N~7PkFH$2gZx>3zxa{^o*8 z*)lv=moSWc9O>`3rx(F!sQO-+Zjw7)rAl0ZBdYT?L2qz+uUiCIE>3;kpKhk6eF$1w z>QUpL1x4|n3szx?D#Gi;P5{39Go1MarIVsZtL#njj5fT z{rfr(e)ti~)Pcoh-k@ zTu>~&BSpA9l7O*~)AG}kPj6w?Lnhn5@oH(Fqc|ljm4RJ)FHOwi(KElmayP?$e{uSi>d%d3tyhH2>f~m?a9cl zF_BV6$;U40s#GFXtHm5kNw8Q?83Bi&uCGld?5=?A>!54(H8~C{yZU$PJa36y`vT3_ zgq+up9NwV3lCNSt*BFfLL8oWXHbH2%sk)hOl@4Y0F0=69qwAP`xJ>4~bnbj7^DP~2 z&E$jRljE@LO?B(f*aUn;Ql;e`F*PDR^DGwfC98Nq=MNw*$K!P$qOEvD_|n9CyPIo9faWj|3^ z>tq^wTEw;_hD{q0oQ(tP{QmqM8jOxBOWpbdLW#!u`w1GswvCLd&K0GgJM;4EK29Mhf^vjYTGmMAC~J@M*HU`<5-v04aeeeEYm7Oij{`kNWt-EK;3E3q zi@94>Ur_#do>Ief28%KNOI*4@0eX!6dHd1-dM{p?M4 za;A)%&Jp(AiHQ#kuv^FjD3mG~Hk1V1U2Z-nutzbB^na0qUyXw}!y)|pmzNz!FQc=E zEl=@yz;Bj^jt9lo#OlJ0Nr?%kF}N~pjcnhBwpe%%A6-t#N%yj67XNiaf9By#92>ki zA%?Ndny8itDh^s-=FaVXFNP~|NHM7@=Zt01<#{*#zx+O~{2m_rgpG^c!yEr3WnttH zEw{Vxh0#8|i=sOEAS1tUtgR*zu5>gw*jqC6?4ee1sgz~Q;5@Caw~Jp`&r@T%+wBqe z#xAi33Vx)*r(ACKulj(7xu%Zs)t8%^cBl5>^m?e(d4Mm;P#vC`nGV%nft0v!V)X;D ze8{t~?bgbH8g(h8+*9(ywln3Q>3V6XoX}0ELo{tyRbCgNtrk7vd6Leufao8S&XrJ& zweRS{_w-LK00sMzE+-I{ulU33IEox0XocJ}rpSWSft^}0ud%6e9a0{P^&lO!={Lhq z&-mtdc1{w$Hq@(Va~D|L1`>`wlgm85i2TAO(Q@)zvxOr_N}c9dqyJS(IZQdUZv62! z!V8Tcx#Y2nzCLl58uznt^+>qA4|POpeUA9)G+roAml^1JaA>CEsAB6`9SdxN#L)Gv2@qE5|DMi@5*J77FJ8 zyed&M1{m0L>72oSw7hl^!*+d19VT`%FxeOzR!J3ZDT*}C0e1Riu=aWm7eM+<41$z!J>$`^~1SV?T z-f`_-{?gRZ$8$R>jXj@o_6HFoeTIVThE8@|2-b1|-<1F@kTHG{P7a%=mWvx-Xl*~=F& z5RBkt*j^sK3Dsvyr7L|GF5iT>?YTGu?w_0P8if5idK|xKaE=E16~lRRC?PvLXlVSy zbmdzre|q%~;fTH^CMvgXzsYKk)*FAz&FSfJosY1(^FI$ucx=u-Y^@I)yqZT*QGeA> zo1ExWfX|Y_(%?p@Ad*dwgJqe>Ryrm_t~TmBdLOoGNAqtn z{g@D^Z%%2U{Epss>}Ute86$Fsxab|9CvGub$3D$}Q;n8$N7EQy$K1^2`ODY$XMVjq z1)~xJ&b98-F7MNOOQMT4{r8lm_@{-lC~Ro9DtZb7$mvLdFm29D*|eLdKW5z-tt}83 zJDyZCt(CO-%aNKfyTnBn#On02K7EYd$mjwlap5Uuz_>8sIgveEE2=PSrSa)R=yxv1 zOSTl`)sN9q>eH6d>&YZp!s1QKuyD76?u0*A@OcvETu;otkhP+otYEdGvSiJszlv*) zAd-{j+S{lAfoL^q8Ey2T!YDFu&a0oERiZ^Ko10g)L6=MiXJw(sSIjm|j>YEr@;KFE+a6K3tyI_NbiXaW zmrePIZ9%E+d}Gw_5sO#)^6Se&*iQRGs8XXjA2{`{frkdqmmhFLjN5%NJHHiKBpF3o z;2_XWecKH}#bK53Kdc$XARbUJbjv_9@n8PL9P055%a2upyBwz#-DR%9F!Hh99{)iJ zS#@4UKOjQKr*zOVS_|Lx6YFU5uCRZR$A*W8$AEUxB88Hl0MD+lMOHN=i7~ZZ<%ba_PFg8DRXmsOlvH^=$B=x zru$y(ur0yf{iqq}p9s!!*j}7_o|fgAjQk8w!0#8Et;%ySZlSk;? zdmpk?Lt46k7GPvZG{hL*L8mah&y@EI)a zYK`85n-rUHqQ&|%NCIG7Xt016N5?kdE)+C9VmSOwGYQ7CB44!In_{P(q z@^2$zrKBV^9Kd9Z@SdO&iIT6AUB0Uoex+f>$JPcVJ29Cui>+$n*yKQ$<(V+l+>h zvkuYNY@1(MCHAv=ODl%Q^2sY|4af!*YTwLSZr7V-_U%4Ph>K`QxUe8*7ToO%#~>z5 znK%n5vK_mv7faw?M=~Hm`PbNuV1P!8P=4^GF3jUS!(v}u;DyThRPl40o%sVz-dal9 zOaWyL`UGYzWM=$lH#d_VZoKawv`&-+6<(v?*T&k;$Q3B;l)A6f$k`eMdUjxuf{mwvPkG<)5 z-^=}-`w)TeNa>VE=!Tls!3DO*#i^w}ti-8HHkp{!Xot>S|C&PzDC#F8&>Gl?$j(cH zs;Z`#tZ2NGr80AKdgsfNL++HD6&sI9Y;aC((ozu-?#@S!nAK(j(@N(H)t#zQtV=di zR|?i&!^i6!ujFnww{Xwj;iRs`lJly5q5EEHJ7sH5^17hQ@bqLqat$RNNt+EcChu;A zM7O5s$AIZ^3qUQVoTA|kR%PL!(kTa?^p{1#bBo7>iTMg@hk;0|Sd{p$@G`;Z!X3a* zQ;T|q6b|29L=YVvT`+y%gcTXAj8?9&H?ksHSul%Qq1cp`MHh#j*|IFIf_k8E(gbf@lUtwgSphl6bPUcMSp6|%;dnM*S_)C#M;__m-D7M{PTg-AN-R233QV}hFRLU zOcd<(&|5*Z!8vPFwjp@ltZt7=!NYLE{j@tk|Jq!~x1e?G( zCIU@FTO=ObUIdg1&k_gcc43gKAZaQ7h7f?i>k-|7PG7)%J4gGXWX1y4yAaN#&vp!E z{utw^DaJb2$@p(`fKa$159`I>JEQ1b9+3BtaPQo-34Qc-XO;@_bzLZ`ZZ<~t%T zdauV%ws_bn)#I~DyeCRPCe9BZP8!!lBiZK=cvd6s2>|%N(e^(Btn1PsFrjyR`TW=- zMJGWN*2O40vdH1SBjC;&_`FSivQ!{qHx0Jo&sm?RFiq1%JJE_wSD%L0s)PAkp*@4p z0)}PtvvILjXHoZgl0PP!m>E}Eu6jyfmDj6@`597n^+$k#RFf;>X(%8E4VJ+h2QV-S zn|Q%n^Q4(Jn^$L1LAXMo`R;lO-D^?v1pdQ!xt!~rH-Yv}LLv4f288hNZdp~4yBC1V zD5V$)`2!8A58_tmD#1Dwws<;v$QTvbc2Ah+-ZmPQK+!Q0y7X2JcE>0GQibBmF)i@ZckR7ja>3~cG?9E&@qy(Zq_rb)foNu-Q1rs zZ?tjH?9W$=HI8e!k9=%4vUnXAGmHUlPVI#m@Ej4kL&O>NW64+OG=D~u65_fsZUTZj zcI1C?4}~3^0=)%|I7`{35~@3%6G1P&Z!lbo4`x%(b!RL5UpBoz$)pkN=>2F+E0ti9%En-JlFfMdf)5&+?YCe|}`H(5H6@QC-7!_0g zug!Yu+Eo$SheA?1t^uP98vQQgW|NhAEXe3+r*#ZJNC6-pz(A-Gi2TlV zE^po=bX}^%VVk|*IuHL}1cHN44Cyt)mt)wU<*+EY&FW@uw*ZMv@VOH}2~+#n_pj+>%jni23l7DEb5*b${q5qJIceU$MHq zFq}n2h4@qApzb#qgj)gjr;DS;Qv*%SG`TX_4~H;YI}8h(l9I9wh@Sc3;jly;=HW=b z_MNfLgr7#G+5BcHzH@&ch0TE3P*vnFFh;0D*vj5Tg)69RPO5 z5MjMP4Mf5Rp6p@+_|2Si2wUC?i+oh2&0;AZ{h>4U=HIjtHD@V*t{nsCPl+QeR~^@dbII%29yfSkIyKQhVWixukcXu)3O3#w$ zB;}W}QvX~Ktr&6oq^KF4suO}hU-y52e}%O~mr zrMo+&ySrPEF6l;6Km24j!W)C3Yvjf%49jx?rk6>R3m(2L7nnFnz;_yPUr|6r->SH>BKbD^!oSRou zrTVq_By9-`jmorr#9CKfFKO1m{CCq3qz2h|8sRw`FBmd+DsbfBV~7SQH#y{7q{AqF zz`*{NT{MXmrQ^jewpf&$F*fYXOu=2GL@6egVLkj&YGPu7*X>B}Eoolf!fyGB8tUV_ zaq9?s?ZsymORI4P-=nIUC`gm2I_+Q{%63*A_;6V0^`K|7Xv(-?R(iKt zYYYpU;>yn!v7*B7}*s;lPv2M1qAqn7ZIV~F_xY5t4#Pzp^gEj)0S zQ#Fj5vbFzyEM{!}&0{8s{Mp#^yAVE>;Rv)*>{xAUyRR~gjKg{NU--xCd%o?-pQ{el zSZZXDuoZer>mIDQAiXWkLXr)7BNJxy_gPFJlb_O=t9Oqxo*N+bnMuuYehtf%Z*H0$ zFUZkRzQjEy%;{pF~vG$h7yF05U zZaL4t@llV(tJu5wNFQGLvJ(@Qw?y6pCH6D>-7voCiXI}8@hVJh)R@{;?3ZIV!*8^B zm`BZ@9R1w|P|)s3W^a+*3)hKyaIloLto3+TC4>TnDm-$&Tk5`&?}~5f4SjS+ML(MK z_h?c))T*$ijcO|4Yh%61quCFV)X_=SGv2trTAh6s#5X>)M#*3tlJ3ejDVf5%2xn3d zvW%_zxwz$gEYPzSWBdKjK4j4Wn12zj8>Dbgi0<|=3`)uTMjT;1%(fj>k@wpv7o~|T-QCQgA8g%1l2Yo~B;qqvt_f{Wg69~#hgPTsIux%-Q|KWh7dxWYy7DA zsRa`Rf5eBmcfIW<)??qP(qrWXG!+ySl-v}P!1s&#-XQY2n9RnQjM#Hg6~`wq#@+qW z;&*55PP~Ed4e|}WlU<|H0R}h10xc;dz4bXfFGF9>R`Df%^67GX{S%5aMnoQMBAI?_u_6t%IVtZRT>}Y%-YKBzEwf!3*mb+Kb}RSG zQObEDsZ3zACKN6_JbW)oV1?4p&(G^-J4K8YJ+wu-lQ@XC`YN39H<ML5RHh23GXkUa@YcW1ZU|DJ z28;leP`JsOOY(>u>MgR`Bd72)Ep+divEsn$5Ey>S;l~^QM(l&BcJ^gPG0!A)3~!z~ z*Pqx1RhwF}b7Uu3k3W42iOFzWd>BXxvn`!6(!M+sv@nZ3T?!EY5ZK4h5cL5yifoO>l00C zP=*DKaa}k&uwG7WrY+;88h}?q^}ajk-dN0t=jKMPKe@EU0rqBRztHmisoa9=X{kUs zpULr@ixP_2m#++&gzS+2OZdy6AedwWgf{QX~?%Lp#c*W4XWdj6mYAvgX+km}6D={;+v@2o-{ zPGk+9-J1(Gs=9^iw?Dm_N=YgIO`G&OdRlo2Lr2+6LCNYFv?9W+=XukB9LGbN(^snx zGor8AS5CZwC$UTM4yMX8*+D&}a`*tg?co=sSXabV^1MbU>g4YA!kZ171s`uVx-U=S zbtsx7-@Z6_K9=l0kbVhF$1$Rq6_&QLY+Mu_W4Utr&0}mg=7we zb`UsHx$j2q%q?T}8807z{tr&S^+!=p?wcEPtHkg|_BbOy@%x)>nUtKaWfF~`MrJy8 znRn5qiTM}LhTuI)3(KqTbWcQ!MEGDIPpWd2ULOQkA7$J>A;6&vlyUKwS3T1XtZJ>Q zIgR~W@ad!h$p(-2n23iNP!jV3_LFJF=CffD)7mI|0~~DmbH(NcwjntSfNV=Uk)@b) zQBZkyNm4EG_XF0Ny8l$@+v0YE?%c;WbZ2!4AEG++T31wYYJp4=}TeEZ->gzon1#403R8q{-k<30SYXvDLINHVcS8Ip9B8IC?7i3k< zuq?#2v2&NwB_R@Jg@o1RMxQGrG88B}M3U%L?o&q0r_SrTtb?ks|D-CQ;Fy6Umx1@M zB!y$9b`s)|(WGsac_r*hpx?6U_J#Aw*6wZ!H}~&$D;n*vayhYgtFpe6EpA@HkUmPlv#yum30htc=?VX)TRE}0j zDk`cWJiBbo=**U>Utz>ml%qSP zREANI{`CQ^lE4RWNXo|DQf4QXJdGe-#O~Otb^Cgy#U~sBfau#Q8*SO0(vUoEyn~c? z1v4=jb#AWW_C$9|WT+*CS&=kwu>_GK-SSxTEED^of&L?DCi%MP@=_K zqd5fmJ>nh9O7o0_uhMH3&u9X6LtVwMo%s0p1e)LK$@wVw9;dYZ#=n$Yjep)BWlQ?Z z+bi&FiIsYXLhPNwer}tINje^yi{%djlZyUAds}e9Et)Pl-e`EMb&rNp)o?A?U;lV30P&* zM;uMKRK^VI6U;cXZ#HmoPp=YuzrB#|q;{b9vc!fE_R` zSkE1du))wZd!(`Y7KX=WG#~U$ivT^ZynXVJCBEv+G=%3F))=G`)fJ9Iz0eL4(6U!_ zQ~x%LKzA2b4N1L$)S?U|wHV3gWfugcCN35=;JNM_h;Sp-tAfuj(`wVk}L!u(P9Mt^AtlQL<-(BULevl_+`#D0d!$GTs zI`Nx!Nq|>9VgU}c5~E2qbEE4arD>iVBL9+a#eBKTJzc4z?N#f}Q>RuCf2%(;o-N1t zl8%U0Aaa>T$G2l{cQ$04k|<6|70vsP?EsYw;I&%A34`r3B-Q=5^6W&`8m3fM9}W@X zQd07_2*2#v&FrVm7{2`V?)9W04*?PlEGh2Jez}g8+lEP}vMHmJ;LQq%8WQ3z)TsNhND?@I-5=j6(3lNN=v#nWs&A?M|mFk5qep z|1Mu$BgDrqb^)f-v4Y@!>u>RQA|*TZVUqIclFNnCh;Jk%6=29b4UeZd#9Abkg_DkS zWv!fP&wjUx&fuZp7ZG+Nj$j$9vz%JU{;pi*4{+pQClIMlj;_m)LNwf7^RQzfJ{8Cg zO86>=n{iJ%9$(zmOuEv}Pc%cPiuwlm(7E?ts)QQg*a<$S`jfOb2Lwp#w9$Vp9F5q+lBQt4>3`zs@E01d zo(c|TMO<0WX6nv~de4m{Lv^x94c#dBoT{Ug;XZhNZjd|GL5?KhQ{+{7MHi%VlWjbN zy|(IG_SH_k+1VM7_R-U=Mqq+O z?)cf=jvQE=#l=+oD9i{P>FkU+fAieX&=$-3LVJvE0sb^FGd-|OAa!_U7ZR=$?bIu| zay8DTV%v8vVY^zS<>e`LHd4}x`D1}@TvIb!`N^bI3%YBr6{f`R$^n1|#I20|$^sYp z*>3HljGR02#ZZ{P^xr8Gh443?T{~53Af5KcqoaGNZZH`+Sjl=vG_=2wP>FZcyXnJM zScLP4^eEM7xKWJ^L`Sart(a(no;SA zh#E+r7gMztxBKCWl0PHE{B!5Z#t2ZH&CgezDV#Zit8J{mTu&rhF5~S|D+V{kK9_WB ziO>l@D`Y^O41<}`;cjjB5UFZW2Ov$`tz))A;GBls@Cuj|{g<0}D(2OWgnJPh24#eq z4ScN~sptxJ4^{X3LgKHP`vkaco!N8tkUw-owwq)qs6ULaXA>6;8l)5Hp;Sx)P-ycf z;l}ix%m}ZUyu!;( za6`a7Y>%qy>{H6#7MM;ogLEaL458aUC|rC1oy?(@p8LTEV~{~~N_%c;mpOY|_Oz?i z!0Zx6jW$lQlM$}mq)m~v{O8Y~G!H)NJRrSB!^A(Rwy4%Um%Sq?s3AZ~cygi_lX;z`va~rez5r=K&{#l#3=(yYS;%0PUb}IH}`dR|UAdAR$WW4j6L$zNS@m9q(4HpA68x!%c z5X@d33mhnzXr32%zjzx&5KoMbHf((O2AM6L^l#DO8sa9}>7#EIk@n1AWW&n@;e69f zmh4Bw8s`k4Q%W8OJ;!YaVyUKqf-ialo(gQhA>6faT)MdiUvi8-I+`eo*GDBI3B%Jr z1e#$f5TU$@tf7BbloAFlQ6}ukHM=X`DEe~CiVu5EBjF1N$u>LyoO?hshhHE=yXD9? zIbb{Di5HC*<3xiaioUm&S)gs0t~3OV0v`|3A*&(*iyGq>T&9^jYC8&T7**mm}eX@%)YZ#*j zi6+dHK_pM~#^~(?3xwGMGw9p+sY&+9-TL`dVWGMo5uvN|_uRM@+DeCcZegc2CNU=IU()D{NQx*?86cdv9soq%>P`Mx_N1K>^dEm+J+(vl)hbY$vNwrn=J=bmH z>hASlX7o58z#S}YrT((Xe|o!}Bjp?KOeNXs%I9Ru3L5l+2R4C;c%jWeY05IknPKmI z45&UEYGm#K6@>EJ$VBGs8tuAse-bIT5IA#tzuIh>z(%h>L;R7ZIn&l`UHsWPgSvy( zT5p0ZE#Q-$!-4MN47Zyx5_^E4`WZ+^q>TBqQJP`FoYw`m^dQ(Bf(LK6UNbOP`TAf( zGfH=KMey#==B0pa-hM&i>ZFfEL@s(0Oju57;PD*udIBiT3?Ljax4j8xuo=*CC0&Kk zF)>mRAil<$y3%fj*$XJ0*n;*k)(8BzDF4zv;6FnkelI8FxoJk%6rxWQp#dt)3WSf; zfSl)z#rXt!m@ZP_^By*+t2{tBZ;xD0G5>4|EI5dWOCp+x+Y#qezj5ThA=#geNCS#> z!-5AS`#hQAww9FRXjtP&;77dNShfgAdmjL)OPGX}7eLlJc|m=Ub3{Ea53=sruV4Tp z5?3+gc(K90CCBzJlj>hl#~9f1oNN&J3Oyi-t?{!m*C!DvpXr2lGV>ZzSOBWc0$0jvMvzrav{JEs87LZ9d~Dg(d^3?Y(p zg@MDPaXMb$djW2-{MR>K2<1e2cyKTX5MFlxBB3$ht&Oum4{x}NxY`OrPE(?YPGAt= zi!FHmD=Ph&fxQH<(6?j)GPNXX6lh$LdvHjMkeb0)^;}9UPIU03$~@D1j9{6fk-#$L zbxA+}v#kf<>R+$2C!!tBRtUHVObGn1W#R=dk0#c-a6$%_>7DnuFxDv__>s2?*<}D& zY(R|sx7d--z(AW(OkRI>Pcv;L5MIfF$S{|&FUH70X6L^TmeinsjU*q8$89!=mlhgK zDuiiC9||7@1FeGFX(T<>6VwMvWgip4%g~d1xROF9tyT`w)ku1<((BT$j1T?zFTmk% z;OZ0)ep5A2ntvO4Z9nK-S%VsB?-Tfu*AuZ?a=2+KFpa`X8Z3|}0M!dRNcG|`31p22 z26W;C#snmXuS-?6{trWz6}%=yzQKqREIWIrv zD3VXHA?5-FlZh+nwC1nQ{Ts*~WD{xKli7{! z+DG&H!Jz*>z{>#pwxqnALkFzT&BB}!$~7^_IT6FAhyb0310J)GCc+nd%m12Z@Gxjk z*LuTn!6JE_y@0($G5%kR^ajHAG}v4eAh^g|3M|=JD{aly3yc1=39~jvirZu6IW(<+?sVt$)-ql!b08y3NzF$6^ay}`%Of?ZjPl9 zBel{x-dzJx5^KoSGzCmDEz!oe`(2)dt;`P}Y*0m4gcB%q~x zIGfZA+9g9{oYZEx_Jf7u3j1%a(SPGAuj5TH+x6t^8N7Z>Nj zK&~m}nm91|C7V#18JbQmLcqZUQT6z4)EZRWU;ZPogxxP>%#d;rc>c}-bt-DhQvzsZ zv{qRHz#~(-K%~k>9jAN-jI=Wn@QlXD(&L3K)QwsR9llUIzC%BxG;J{65c2QyzM`RXz?ql?P%oMVp17!!OE}lG1Sn~tK1xR zJh8eG;Ai)+S5UM`OR^dK%-15GbNNmpB@%Uh8>56cL*8dGDknP1OCw@|3j^O}muF04 zq_EM&YVTE$$u5r9X5_CwNB|bFSDb>!ge-tC=HWJa-*C5GemA@TeXL6sW@3^bp<#oHY1T}(O9j`fo-?1lJ_T2- z8C`IdRTs zm>7H4{w1ToL47+`-i~ZF(5vA@O)Pa)YGR#h`PDUt=0%}omk?5w*Vm_su z=8hZ1b)`W;1zZWgz-Hcky7D)GS;b}yn=ol6|2&*)=&!qHRDnX6GM!3*y9n5pZHadRavVF2pCc}ZNqEj#(e$UK5yyCcdg zq3g1Nm8SW&Y07%^3(K@-Aq%h zWr*Oty$v*w>SPZPNNzU+I1R*mPiv00-`hmD&Udqkrs`zw>y~zoP1mTwx~R5afAAcC z-z*`oMh$NG{xVdpxk65J-YfB!f^Pj={FLOB6owbvm8k%+;VtX$r-qsNO=E;^blX=k zIS}#njfj}*H;F=}nmb$hhLrt+t_WJ1n`4X!W_vTIkHjMXj&yK9Ii;LJJ;9j4447si zWN~m%UBUOVnP+i5*g$T+?BjAR)6{FS_?3ChK`vfXw&cdgZ{&AQ-=waEN@WryU6lXc zv_|ullu$YLT2-28ex5zzOImk%`41lkv*UKMi4hn&J91iC=}3t$;=^fW+;{0=3*Sry zZ0YXbzV@9t)gzg>QwfhMS3CU0n%@f3YdHSxV{Qh-^vs?@E?mx96ATT=mFcd76R;(_r#jgm-32**i4auH}JA_#^w0ra_IKjIUmL) z0YPOU{U+DVm~tU<+iDPL|bXnNO$ zxTTFAgt(#q$o)7Vd~v+<()D5qBh8a^)=r88)3<*|+~GgKg&G96#w0~n!2**M#Qgj* z8dH5aHOltK;Oagh6P9K4*ZNXkQ*Op1;dX=8_f}F~f%)37L83@x*cmB{Tb;3hZya7o zvQ-Ua%2w!|E)TS^6S~I6VgRXn>-a#6O=4EF6hkoHJ8U8Pu{fWtLfivaOrnx}d78G| zGL1t*RLow?r`lQ~7!H1XU@`T1xvWGv9KQ1l8Polr5@s^TK=`(<&2MfFeAz2n#JlOm7v3JD1A z*=P5Q>e;m}=oIdL4Sl^To*S$7gC?Hd!=O)LKFDI`uLbehZjUD99x3VHxK6!^cuEc{ zB9N`GcA5L5Ap^@QEK2-V?Z*MUJ6CY<(}|H0gfPOCF7~&eYPrmY(GLkcA%Xf7oYU1h zFSF$|Pe5+2wAV%b865(`3F1e9{ejUe9yO=NF>?i-7xpak3EG9SF1eCI-S4r3deRozvbn4nuLbdHl?}uhr|_$n;ZYy4um>|Qq^ztS9x#W zsiDF?T}Tp5lS1%{U($0?>)dmn73a5-83M1TqiHUoQ>%s+Z zG3Xm8oGQ!?$=jBYbF^K=*OP2*f1i#<{=)Z2rdOO?5+7%EJ4w!~p^0>@UHlY~`5dqs zmrM-e{bEdj38^i@c)~L z+jgIodJx>*4dZpQA6M&jhuzQ&xT22Q;X(h+jugzSi~)-tV>k?S8TQ`fh0eZ$A%4pU zb1Q*jo1^!~Cmlb1n1~GDwA?K4HwHa9xWsI^t7{I@MkiCq*yKCiGDIC*U}#%_t&#U_ zV^gTtUnu*m<~2)5IF%dq?5RlPRzi8Ob44LK&}Xav@U8QVcsO?Sv(40IJPS<44(C78 z9Ve@(w>^*Zg91N7s&H!rCp(0Fhk``>R4U*BkHqMAr2nH%w88@CQzwQS?sv-gpx`-Ix+n`Z}%aw&&1Ow43juE0asC@B(Dh3SfS%=m#PaE;xSDTE; zw`^<2bGwM}Kapo=3QWR33YnH zKA7ExAZBDj;%dsL!7ZB~8T;ZN{gF#Gf?$|n(c>?Y<>7ub0 zibn-49lIE@yIy6V+fZ@H!TO|2iiT9GExGq39~WBc%U)2urd;TT%w;w0+wNIXj1@C>MF2sPg}*E-}I|V0(3vEZPQNC&4$__*5ZdF*!KipuBt~BzG#S0if@q}Vg8!c zefbDLPDt&^e{ObRsS54m*EoW!`139wAG?2$a!7JV@joL>6P;wrg1EQ)jy z^NT#YoxlhFHxkz6r|scXssn;Np_J1e>9N=QQ zhB{OzGX;0e)NzShF)(g7UH0{UqhLRzWnS=vL#_L(OUjHiBd_{$n$UHAi%=|r*bz`j z%=`V@`-O#!dMrPh`O4Fgp}^{}*9$@eo1>eAw42swQ3-*}(OExH#ooHxLkP*jA6>=D zp-a$#3P4Yup42YVeLpvrP2HRVi98~)9X@t?ifFfkU{%a zDngh`+UIoR_sDdkTdg3wz~ikVjtg3fm!<=}j;s?ayote-j%Vq|%A}nNF_7f6!%g`g z%5JzL@F@SxRk{xMK(j*pesFa) zD@2Sx8R5b~ray-KGfYJAXy#3X!O~oS?}~F`v7FK-^?i-FNs&0*O$r8gu~ri!A|&1g z9|))_hZWmffIMIc=8d9!(`x8*m#3u&eA?)z3IfYn={*=~K)n2DH;s#jRtH7z%e`L# zN&(F3M>V6<5+@6@q^^*L@EJXC-1{{VmNHB#U$2hyI_MXqEKmAIjW~$OxeI-le57+I zDc%9DZccb(f%Yq}$FNKQs{6I^716~gB>3|K7x?Y2&MG!m6>{B1TKWAr9h;-!L3hpSLkMFUON1&Oxw*C|~?@%`4` zCwKX3?`Wm3^J`3nCHNjx;@u1xY$wv<(G>9 zF?>kqD@Ij8yTJzh<*WZg#3iP%E}vs@^Qn5kI*Tyo_?=IB4*1QsXP-AHgU3b}<$rHn zJXA0DDycoR?s7Pww>+y+J>{L(i(;ploMGu?!^z z-HJfr)6_pQV05y8gC@a2FEDw>g z`;&z=hLBGPd)~`=B}ihAO=c)7FvLV;8^0l}NTlE0wiEFmYiH-zhOt5EdN8<#GrchkKd z&zY(*a;uj0a9R9r_zz2QFhxn9Ktb+XZnv~>qkDs1U$yxZL9N9h{q6CrX`xKYN$tTM z9j{flZ7S!@Tc){9quY&s^yx~4H$dAtbxre^hg*|6buhwwhc%Oi_|V^kGDIb^T#y^N zH7(hn#Xi&&A_!1!AFfy zxCF;C>jDGaLMgTP<2*x~;ZKiShwkINs;(Mo5dD_HxlIjUV^@hGU1`n+35MUooTnK@P$8?70G5#Oz% zhi)>t9(bXOan)9+vsOZ{XUv;UCSamxV}wmyd{5l9JrQ7eU-A_A;3Att;prmtw1b5@!{yD7x% z_x0BK&-w>nWVtpiTlq|qC#7)69yKJ*F=Q0%rIU$8)xRy(Z-^onNv2m#mtS9>)#c`7 zi3q>FkE!s>Lx>q;a4Q-&xV_U|EW8b>Df;$v)wWOeg9T0{sKqOC>Q@Zp@QUzrcAS3? zy;!W$vYRQ-V|>tI+S~lK`I7o{=QFHL@ZD2A4>*;(Yn}zK>sAk+i}?mT?Sf*b4(4~Q zIIqw!n|$vzb43&X0&t;Vej#baJG!RNhA*_?vXBX_q6mC%xee}be zn7-N>zn>)8qwuSWJP@!`j368>Sk{Dd_7#5ndm!uLf+lD$OEXjWl4P7bgCxbE`RIB* zh}UMqWueA`RON|8_>Mw3;rY3h>F?_ZJPnD)t?PR7mRLBWF9Fdi{+k)i;A-l!LtXcePD+l=}};5j7(Nf%?6 zNPRMC)q6j6g$pUOW}AEypp-OO9$ISpF`rbE%DS`|_f zj~8rW+^6;NlU_^TpLy4tv`1!D&Vk8wkrTdb&dd71cv7wJ3~){*!RtO)$ZeuiUjv9PqTzqOZ;V%Gvv$gG{)3CX?bcG4y)LK{tvM zHg?=}^Sw&9dgr%jXOg?_RomHLrgU$mNoFD=IP}|(YJNNzR=X1Kq9#!9ym1;Ro_SF? zCKj}RWh(Gt`N>dqGB*mT|XcGEw_RAARHS|ydYAl&_=eaQ&n zO-)U?y1abh2tFlid~two_*(B!C_tMH4q#CwGvJawUQzsEj2qne8HTTx#&Fch{JLU&qcT%(OtcK(e z3P$~CN+r9L+(HmZ-|Z`wf!eaWb)F^Uh#jW@rI-r=Yul=BIKeq8wQi%RZ=EA%c>!&- zKw`qr%q-Spe#r29Bjs+DxXH@rUXf{3MfIn|E7Ye0G%+7?>wxfx4uwX!IMP6I2p~pc z6UC!XdMO?~n7hITW%j|o`eT_q*gzDICyM{pE=5wSQ0VB@hc>e-yiSZLEQlmEAPR47 zSw__&jc|$p?kq3Be3nV)WF5khCfr;-`A@TTni9eiCUI5&@)GG3$9j;s@3_3>0Dj=> z@=AObT{>z>7^qZ7)*t$A1l~N$)q+x^v*tUtK6%L@&1{_g@PH7u5<+j`17AVD)Hja z#;?nENIfx9NwtOi<2kll@W=W|6V1#{5wsJL{|1s6pc=oF6Jmj;;Gd;VOeaq;jT#~< zt1?jp$iT>SJ*Iy5R^bo13Af-WjC9axpCXo=qyi#_?-)((A69mxJSbezL^I!R@k3{_ zJ`vAS@`|8lcPBc4{{**ksc5!0o&(XhJyl*f*{hUXcT91amj;?y*Xb~%{X!;iq$IKb z-Q7{a`8(dtn2nxF)mcRhDvda51eb~Ly>-KBN7*UlDYI>0l#*F<0QM4_l=NV>qGGo^ z`-%hpBS9{!s^Vl>=qT40NK@Lm!wU`?Ms}d}4{kaIaytD!qU% z1RPqdaghMP7?&B$zLMf~zOy1kX%B%Qblk|pFi^4N&*1m!rE`P;y^M7|=Jy~241%7YpVw|$Uf@`#I!C{W z00`9K84q5zU93#`_5$g_2J1RTQQm>6Tvs1aQa>RRSW?otVCk^z?%!!+po_&~S7GVl z6l~NVch>_cl%2{%Vl>P6GrVaX6(l98CCY+Ut6Cz~Cd)&F0U)J{{UkIFzxrUetj6rn z_3C*!e(u&YdEK zV>)xsYOEM_sNj+r$5?}PnRqJX%?5^<+FV`qDkQEu&q64A&#v8lN%(;HN$oknYd zkB`q8Z;uZ!W)*aXQUIVEx6j!fkOeYB15Zz6K{kQPfn&C+`>RX^&{!{yCe_kg^a7RxtM&Z$)}$;P01ht8b3CCb zBN{c>=^SwV)tMaVoh#8q)c-A${l^+bgn6W)e8KxPRNg*^aPqOi{mH3@_B_R7oQVPw z7E+FqWV052K5O6y|3Iax7p8BI{ZI?-4UNCzx0EsxNb11rcS+;I!9C4aOrfT8Mas$7 zefY5?XpUn|&oh{)>wEQ+csJ>8RP5?q*7}I&m;BGWH*{)2tzC-c*yS6ZW%XE*3JnY4 zS!q9j(!KMHw(dm2IvI{5ajZW_vC;>D_e7*yJ*}b$txSd7$gxn!dLN*o&`0?av2eYI zlHFtuRG96l?>%M|a0Z)adelX}H$UoJhjVPlLqSH+iUK2OZ}yk4$xF79^deDWx}D20 ziIsF7E3cP3g+a@#sB#50vM7q$xWR0Ef z$MmFak?&Lzr9~&$--GyCB!86uvsPJb^|$laxTKJwzy}o7qtLwc;1A5?VfZbAh{(3e zl0^5c?B=_-Rgy(iLQDyiQSli4ZEv_Riy17TwU62j4N<^GKakR{6W= zse?=!*8*IS*VM%&E? zlrKJ%Y`FGrPh@u!h4Ft`AzmR3ta_grVPPVO@sW^R)RIgG!^!)@m8$s5A=p<)*qFk@ zyikt~RYp!IR8D9xJ&%Jk!SSNHA+qa#KiQLm!%3WAf@~|?mj8OSz47~oG9k>o7(@Nn2R*uhZ5;G(?;mmqcEQ&&gs!~bVr8};kLR) zDCT><)<}tKwn;~#d&|4Fe~eUcAMGo&0sR1?fZW$aLRS>L!(t%;|A|6LrA-6^GX5`f z#9g@FLhq$#bP*Xb26a3ebPQDFgJweB_*pfqflzmq^$B^BpGf4I=lY7nTm)nSTL1z@#A@4a-sxBwH~rX(4pyR%oDLaus$yIy>e^I@4PIAa?AAE zx3N^Mwv$YfG&!E=zI_S9#a-zsC;4!4z*UuJQ^UB=Hp5{s9aTJB&>He*NPjqHU>YHc zd7Hr?9~JioA%fp02EM~5sLrocQtRp4T6xDH-{T6oitqPvSkE_y zlg=JGRm1gi-Fo0E?)j%eQi`Am_QELalmf=4@;a^ueb1j+shNk>im`Fl`te43F8A+A z6kZ)D!q7^>(3&~H@NyG*Ll?F0!l_z+Ua$M4W^uODDC!^!=T zVVtsxC)x_Hh0LtKYsNP7sDt}me2LVMm0~%<;Jn#o-$&P<%g{jHOc$A=M7zYgeelLZ zZYGbJ!Y}JnLX7U`ioQuUO|vT_T#KID<^I!|^9+xhWXHX6-m@hI+*cVtNlJ|BD8=%y zWQ2e>God<=gFN33O=mjVj^XpsLKqm1F^{FuPAA{pSBU%@MMYOH`obRp)aL3phTjt= zR`$;HnI9rzKT2@xL(R_|VjHw{93vG3Ru3wSnl!g9v0fwaKVr>!?%{>RWW31?=<;>t zk{0FjgwL;-PfaXH{4MaJm(SuGhp7FHAIorKc{=VN*ZK+KT206gc5q={68Eztre&lA zaQJy)^Z0q<&U@OB{aS6jd*&cfIk_(6N2WE%NXPVvV3H~Xk%iw-`8K;;1&hM?7h8F6 zzJ#j^;$;;zY2N5fyb^oYM=lGkVC1~fE_ttriM1}wWXVV*e7^ln$JKDl{q@%0%S#E# zCF0hPq+X(V8<#UZsp^P-{4DevEVIVAC0bTt1T)fJ&(hQD2W*6KBVplinDCxpR9E~d3qTkO~#r-*IV*NXi#s}6oCdv9M z;oP1W1vx*q5SNjfgnW-`-n87oW;K$~ezPLc(>uV~`s@v_QaDGOjo;m7V{^H8;4`&=QR9|=rxmn*9u%!Q$`TKb zMANC^C2A7lA(?gYKc~3A8q%rm2enGg!WHDF!Lpm5uwQ4pFG4HMbQ#O#>b9hDIX_5L z9iAHWA1qEjnQJG%Lb=xP^iRfd*w^nGDxqS1|GM0WEnEZvVezv5<3&ZEkyV(BZ@uT; z&lYe&Xxz(<0A3BId1Q@Fo5F~%slhZ;N9Z-YuFH11RvM?`z|o) zpTD-YioI5Wxms0VnSsN|%-nnIL&40)`5`sfpwaH~Bi<6vshH7%OQ9;?l`>lr(YYaVrFlC%}q!rP}bLai+pBnCX(fUoLM%|>GY7aB1Zj4p*2I=-9jRi zOz-ztZ|{c)i~S_7c^7kut5hO9g5_${cR%K5>?e(Qk2&9WW97%!hug;LMqB!s!Rfz; z_SZkM#{6CGSpPRL7nV+=AvVg2*}fxvL`&Pv+%+PZ`sXsD!qlpCo~5{}a6iBM`WrE< z_#-%WT;1~bOWM;!4RdqoOs_TmVbeO;UyIZXRgPk$L3S_WZ?7I^yL|~Q;Orj4otZ;J&W1I{l#-*8Vjd)Se?HYOoSXQMEs@UqE zTeXYuA65|4X0pCft`MnrNqJimn&W8n(PZXAkE1XDU8M3Ap~FHg@~Y1jIZ)jV1s9M* z6H`Ct#-FDOXdSFyvt*jdN*tqXQ+8qBPEIYMhGOKuIFfk495Jl>+W#X;roqJLET-x; z4O0`<){_00M8Lw^_|whw*PPpnUj;p>(Z|HRFx`IqCYO<0iM)Fz5tCYnGvlhuZutHS zMeFldj|GpE(@Kunmdcr@1exCZ=y34x>uV1_A1@x#3hvUrS9Fnbh=;9yFYT=pSPDn% z|Baha_f!AVr^b^Z$G!Qh;>qL3QIn9PQe{?SLBz6!x1Hak4#^Lwy&i3rlx!!8(N{e7 zU%DQDM^$UTe$9J0#i#zQ+xc(A!1@%#K&Wi|Uks$p)OXjd)aCnL6^)v$N(c3f7n{3J zSNKrz|E|I+aUbq_*ffkQq4RghTmq5n)pR#=xvc9`eT(2WG%-h|CMB*y-cn+7+X{sL zr@gm~tFr6fMI|JpL157h0@B^xNJvRYmx6RlcXu}eQc@z_jevkksdRUj~p^F58Iy~fZtm4p7)Fq*SN+QeFfWxdq>eqOTA;D0-OgsZwI|ToX07#U9L?B`qz0r z<#+)+Ts-4nAO6bPjKiZ$?(`&L%yqW%=m*>}>7nt}uY~-9cpqoEiE_}Inwc-GmAzm7 zr8O@xHRNG(ZFQ$kf%SvOd7o^nX-edp7%fB3_q$K~V>HgRzwV9GRcBK#Ngw}p2Q??r zNji$HZa=KFo}9_J-B!Op9GSMTpJj428Tqv7b~e9^r7MIkGIAsRPDZAmTxb`P{5&HSn$U)CGT6U$3%7Hga*TLOBlz)wXfnNYLdx3fE}C{Xu?VA3Om*L5qK!c%&jZCUWOV z$55y~TBO`mch<5liB9d?AP{Vi%|>-eh09v`u7oRLjew{jk)VS$XvN4SR4HB=Tw^i% z!Q7ZcQaUNn2ObfTLO751M+}+Tyz2Mwp<~_~3OEv?MGDM}ts?Kd-Wf7)elI%FJ8dAu zT{FdW2douU2Px^S0@G8heZ)6XIu0_r{xZMnY$x_J2A_ClmWfQ#6Q2zDeE})vr zyK`9VM3KBGcPAht+xfK4M*8@zp<+}0{-c|(f2vIoL8T=>P#q8oYh9|1VGvG~V+B#s z)!eYg+XioZFU_`vfB%e&nH|17-oKiTslICqn@=Yju0-(ZQ}y^7Y3~)Sn94lqM9BzH z5TL*CWzXEKS=kV1iS@&M`EsIRukQW0b9|Mmj=g={ljbq+%`z{7{z=KXWVG!>EYTJ+ zC1R0q+mFhro?z#E4`22kQsQX;!n?=k z`?KXs)^tiax|enGeX;DOF|%GcZI?!79W{YOy=8uEn{#afr*xGd>lVUcuDJQf@aE0N z`zZakRrcZ6HCiah{F_&uErR0mt%MD&28=8UcehVZ0;K6rm*N~w zrMw|u`6b4q(WLZDs|F_)o=GYlF?;fD!bLXTaVHHet=hF$wsHPpsc?K3v!FAFTUiMp?|u)ai~#u{&wx9UWKiZZB$g zeMD)0&~5Ta@N3A?Cvu`i@YIg3H_|VvT~-|m^E@kcYhgob)0dByEiMzoil?fusNuy2 zQ)ivlZ!T`vzYPoxso9qF$WoBeyVJgq&+hH%qfm<2O}d!5l6f6r$n^7KK-DKe&`zF! zeUqiIujjRvd=w}O@^ty`#{V*ph64Ac{JWEgWmfk|%2oMh&+i!W$%Gv;cXDz{9TF1F zm$Dwc#x%6E120(EHlOgw(zXqYA2EG1w|@3Z;M~AsIcq!bHId%8 zLO7SYyeeb)zM!BW zGklv+DJF>SU4A~m{PhE$xw{P>87b) z(e7Eo_J@y6<;(V1Z(YQ}K|K50Ld2F93PHljNEHMGmWVT1Vv`?2U1p^tB_$=Pphpv^ z`4^aB)AUu{aoO}lCYM@E0(QwHpYfAup2+U(RI!V-oHOcqrJ?dab1fG1JN7Zs(8sH! zhUvzN9bR75)r*36YG@#u`zemsQ#|(f2kC|LFXI`-p(S4Ym>n=*H{0p6i62aysw`k_98*F0B0^?%{* zKbAw%>$b@8(xl;QNre}rQ4!V(D4N=?6}hY1b~Y=M7~|brP=?sN}^fG z(-DLWUz{oNekO^8E%BTWywlS7e3T3A6eKXFdV*9Ye%UFiU z3d`kbZ#X9ve$l(93c4{=zSNs#BGIH@{4Moz)_A?{8^nEkc5s^Fs#5s8fgwaY>BxJj zm7)>f`q#wJc0acFY8b?1eiqx?Bm3K8cgP_KY32f)uVJ_D5A27n!k8D`A6wtJt!K{x z%!ZAe-%e!|>G`Y!rn2%a0l{*9@IcrvuJ%~7#+@s3 zQgF6sT1DM+Quo6RrOfT500;Gz6b!of1LCC(5U*D*n|$^}F!ppwJXe3EF5mlp(r%8H zhcy1J=lTt2!)DWZjzw)%$jSJV;YhzYQc+(5%BsJ;avDR^J`kd~NnI zeDB%*Hin&3kn2sO?o^f90&*yRz^ANwT|HAI9h%3CP~0wZY-OGcIp{xVIY4nF$%`Eo zr9_pPqh*xVmj}{3e^x{m&7q*Cu&$LG2HPQ17!<6E#NiR^#g9tvUi=j)syRBC+d(Vr zLlD6jT@)lI?|Xb`hzTd5=hT3xE~Nc4SinA%vgCPEMX1J)X;? zf}Y+63EyncEWw!UCk|+X$W|Da_jwNGXpEU{bK8~7M6pS1&pS*mh1SYq#bv1nSuvFr z1~hZ-nsuEgsVW(WnJAKR(#Y|p@APw)5$(b#AdF#RE0}xwCEZWV_PPY)-sKQQhOtU* zZ2V2F0s|A)iYpP2mhQ$f&~0aC?C{S18+HQo;fVDm?Lt}ViRf?>a52D*%W|C~2wmi( zMOK#;^&U{r9vHm!D!22Mcggk3i(hafxE~i3hGy04+LomsdkyR1XrHLKq>EwET-IiD zr7`)w(_4Ir!F$!QCXpxL#@=Q-!`F>%_`Ol+=<7Z&IcO~lh={i!=#Xp={N}$7&jx8> zDluh8lg8&MQ6 zQgb)R2yP?g&if-zViP*aj#nUS6y!;C)Ri%Tsu#^+^*X?Fz?2BU%^=O8`P6`($pIa3 z8fpz^Bh=r3j5!R1quhoY*}94Z4?Z1gxr2!+^FT9fFFxZAlQnXX+UExq^k$EDoIGInXXMcM1{C zUG}L&09Lx7>0~tWY5KW8)|w*8H)XKvYX&AYqbiZ8O9bnTCIKs$^3fRepU(YnZt|xr zkl&LuzJQLTNhL}ZFrld@b3Abz;MX(#@#Fet=;Yth&^1bl?xFHwHeK$Fnop-V!31|$RgQxU{-7#QSU9EtADOv;rN z{6>;^x;#5Jtj`>8>YJtG>B-f`}~Nl z(V6_AbVV~k%4C_#3(qm2ps{E#d}?x=vGk4@Y`CagS1%H$LgdMtX@64;+oY$xN2V?N z&*c_&e$_w(Ts|F{S5ZGwN(V;45&X-T{k{l;8?wo_M%Xs>H63*~LM{L3hq!wbK* zc*Uq@vq3+Tx-DHUM~(>}dHZ}Z^jC5HrPW{jIv9DCjxUuGaXZe^2lN zt+Fu<1e*rpJOu9}61dogXf02$s^O4%Y01;tR}+X0UZyKXqQ}z+w#&ZHT98gKjgFVn z8;q~!Oe5-;?q!FkrVDW66a-AVy>|?3N8tkm0nY|h2%aVPnk$<<#EaOv+ zadwZIFRbI%9v{-87wu0uQ+@^a4Iph4l$2eoo^J8*vgCHaQpVyvBmPAVPaR1~!T%Hu zhjOe`pYu1ZOj&GrF!Cb9n|x}UL}drh27cy6JbbQDv4|$sEkZ(wq63v3p*|HkGFg8l z!7`WoQ_1^lPhDld|Mq&GuHJC2(* z1k~`W*?NJOoM%H1rWlI6Lpxm|8^} zcEWCD1xAqX)Fv|L>hsz!yP1+)4T0pPb_F`hKT^0TMfg{XlA4-$!RRF6>p4E8Z{ED& z^*DJ(>T_*>vNeHXF_J0f;J_|?bD{=-n=8GHu`!j9;6Q(W*crQSv{+11ZtN<4V7-6x zMzp(y3aDHT*cjo<;v>^o_GD}5A4Fj_sA4m6qDn+wbmZsEg}ZNCh|8P&*0B*o_rBOA zip=`^6uof2hGcT~{A&VT_4{)hr@a{hE~`mNP;>tlG*vIFYKn|RJ&Z{x&7J!z`G?*6-)FKbC?c$(E@v-9v&W> zd>Mjqe+L->M=xKxaNU{+QLe+)q zjbgCUbR9i0(gtF1+n{7N&0hMw*S>=sNyLNh?(V+Dr19!i>J7aO6sr~`fHn6_Zn!-a zo-U&?1a(_2D&AWD$`!&keoH}1sYHOsy{oGm57)I9_sQOv<28+U;(D*HP2=MnuQLLh z_8S*H=LwC5i=_xv(9a-9u8S7bun#-ko-zS7I4mbhaX-Gu_!x;mB^{|UhvB$3tSbG4 zO-b-#ApmsX;IX?nFd9zhLg|ktk$CwM8&G*eVc-xJ4DK%Rxozhn0qshxi%N11_!3cx ziBGwr1K$le#}jo;_Qk z0`&T&Va>@qrX}bDNZ(xhNc8b^itek8^w^#F!>OKx+jy&kH*4>W?iyL{gPL*ef3v z@2g!N+&W;Ey)m}NtbF`t3Fh#J0!s3Q5ja6252f(t!NMEF8azLw_NQt$6n~NaSs3z71aKCl_uIAQPJ6|6&(yA zEHGO$H~iy=mRh%C@_Y)LONRo^H;_X1!vA_YCC05eEXB`_Q_tt-v{<7|bCc;afTZ*s zzS0z4)iFF>Lc<~>iIle7v@mtuOtPme2J~*J2 zO0gg_X4Kh`ONSCav4UR7o(~E&LkEN3$QHg@8Hl~~3_HwwOSO5m1%SdlP=p|!# zeQ{XY1fO7-<{HJv0o9_&U#!LnT+gmV%+&411vsfur}R9j^xM7Ie{=3^6i2*?mTT~H zBb;%bdd*POnI{oKZiKSLG*2J&>Z*HTS_8s`MhKxaaYw)hmrO4TzV*`T$5@s)lJJKwd^)!;?lw$7UO#At7PQ(Lo z@1TLPfhYZ^7Kq3qv0JD-vrY+vN#rI9(*Y3d0?I&Yi^zxwH3lFHQHN4k`pr^af4r2n zL11GBY9!^Xdef%)BWM?SF@JX(a(i=Crbek7&k4#&>3UHw7I+~AGo5tO%Cz-fRRF@w z;Ig=B*mrXF&w=?Xey^IGO5{a16-AJ@-4=uJ6Bm0_PoG>>H@txLpaTqF4+9FEZHvCh zF^H9WzkhmXQUXo{9cE z*()LT2^%pl(bS~Yr5ta_7f^om*>ZrF+*;{|1yR5}b*?MyHNL_=qvQ=Zb+R4C@StKW zDVK={`z!0k7re8>EtJHg&s6$?1{IZCNLHxWdzvXI_~C0!#If+YET;w!I0v~FI~N-& z`m;#Oi10Pw>d)OVwfQU#j`t(J93_^J4uzsdbOHZ4Po}Jm)L^?3g<)`tN`r#By~}mp ztH^-?IDTU8^y;RDm^X#ipKE@6HRi1%z|i|P(G~+?9IP+h(9*{{mlLf7HgN7#QnjzX zx#yLkpV{(LxsG-CIiEYPB&qAU_xn=f;{K!k%a5oR-T^d-*MXnxXg7kkFL(t=PPc;~ zPpYq+%QZbHKS}!>spd<6uv?2X5a8gq_~q0yIq53h1WFHfu%7(Lz#=5xI&=2eNli`; z22!a+5AEIWFJcL_FPsWL&Yk|mea>Ja3nj2P{2I>tLO_N(T+N>O7#Tj65W+5@VWmHUJwL=zg=2$w+okNqU_Q%nb&U>~Ieuz_|yGg{` zeoj@uQSMkDGP$eiWb58IPn%eVFm0ARvEHuf0I1NJAqV1}D0aG+2mZovfv6%;9vov)WrY07 z+}e{APh>#JlR!oDd%H9-_M8nn{@IVWQKQ(Jy7nU};N&1dJ)y#XxDp z1s#H+iOMY-`u_hzfAhg!2!OGD42G3~508kjKikokec||504vmmpAlo(!nWtU%*AAR z?u%$~2iq+5ScN?k>elb4=V;a;pdvF*<+9 z-TZrl3LC@gQ%sZY8T??k*)hA7FL;D;+PPNyk7ZCO3Yij?y-b|!IrVd+549;(R`{5q zN{^QgY^Wo*;Iawy2(cN4)4>E_BYmOkZvR->#rRW;C^5Ts!rMU-Ur^{nnHIUMc>g#~ zW0Ty@t2DVVo`A##PRHe%z%;ECM-X9RWq{e9;Ah{GSG`97tC0Labw;C|>FVibS6fkY z!S@r{zL7&>Wl9}HR&-$`7}s}xml53lz9JRXN$t#(t`8kgR|~d2!C;w_w+Fj zSoR$x_}>W>=F@Hh?;754!lrTTm3;xs{qQsRl?4+Joe*61X2L*q%MaQ$=K8U+Skw#YzTe(c2$hXF%fMwP zIb@h~vqS9U9=N%w*KMzDc(MO=tVElVR><=)sP&Ec!ONP7vHp<)H%SK-j?ZV3 zqwVulqb&P#Ul)kb8@?YSD~1!%RDj`qP=i)lQnE>qt=hM>%h9U6fKpefVFN%nwFSzdAA5G0jiV7TMgsZd5;o6I< z4j0}li)i1F%1z(?irv7A4ZEj!xF&~vaFEN&{c#%O*oHD6B4UB0sI{+LOtW|T$6Y`x=-g@~%-F?y#KaxBNGJ=M?3=4*@bGVSUnsI6ZJ zXlLdT=ReJqo0bH4U&cT=Qp?|__Q(Kp`F>Xq5P^YsEtY2TV9++aFkI;HYuG9+Q{4S( z7=T4e_#udPTmp1A*cv++dWlIw8jh3J*s#fhzZ68oB2{M&e_?&d?PQ~gc*D=x6G?|? zG|f0q#mt~cKvrrsPsTF+Axl{@B?Mc7ITUf#4)yf_4f*kvz#bI6Aj1iwD-kfIi7>PV-5-yE?)S%tDo=G&WBvdTk*Yh zSP?Pi*|3@Z=mn0qHruJD*zi`_^60<6<0$xIt!923vF;NCA}=}~pQN_y+}0+}TQ2WJ zm4u^E3w?njdapv%fC{;I$`bTIjdGJWoNIA^)$ZNO&grx<*7w2leEFEZ2fll!)Z-pmK|crFv)^48OD9)bd=__bG8fx2V# zh3KVL*%*}T>GO^t(8sGl#{+jN~f( z$tH^!_Csr%qZb1jGpbG|7L`^>rm!XDuRMC0BRx#oexv_1y_4Y3)0-~~Vt3Ok{VI}_ z6cKjJQ*zvP8$;TH|66YyS*=Yw67yT^Q*2^?{OksU7Xl^T-NzqA_A@G3cRmV?Rj6q_ zeY#S1YmQ#C7-;k85hcHzq?kHBKgJ`Bhf|Xp4i$JhN=oC*_%=J<&y9#|8;Z*EcU`xO+~v(2 zT%8N65Kh=(+#r%Y(2f1dDUe46;ypIsti-wq=B~Wq^jo>`QtEAUg|UMVx6i1!v9@$q zhNg`}L%+wXaF?i&jI3z<Woa zNrWBaemhx_FYI7_l^ivF)$ek>-_I2qR&Fzo24yTV3Mj zt6q{|1$8WPmV3Ys$ZGKRHu=Uf4_C?u6NFdDs$6z;LaXyYE0tRayP=8c+c{)|>o2WN z*X26Ao!36-QjARMVuRY@JpSrwu@3Q@Ivd@0Xq&}?gga;`XYM4}%ktit+2dVITRk~f zc?`k+ADx$CD>XiE{G!zkGH7A5BFUa;K|`?2dy4(p-eey|;k4@AQ_BfRk7%3=E&h_T zk=5DJNO(}59?o(f!#BI{&F|m}YlfF^_}b2mWq*`9ZZI{Ps2Wl92_HWr^}aMHPDs>? zej4jdiPr3T8%>0G${=(;Qb4fry~t;?jfeXPWz>MqcAyaTAEEI~xud0|d1y58>cK4w zCb#Rw)iNATW!spp&Zjsj509tlT)*RZF7ms#*>IPvU%jCxKM+ucvw)yh3pzTDLGV5o<~6WGfnXOH`ObrMNKnmECS=F+SR+U z`8N7OF0YPJ-y}T^YLLBYk@)L1gix^e7fuVcX>w67A|m2@@f!}$W+%AGJ-#6P`Rhlc zA|5PCZ~G8!>#7z$%SpG=XM6@~9QwZ_yW_7i&zZ$TtO2~cH*J;WcS3k zOiA$Z&Yv}}H-lTYN}OA(!$8}%|mx-AW& z0TQv(YoDcWeoi-(se~>u#9xmQ8FEf6l;1+xH#+Al$aLPdVU!iew=9gyUTrjLuc-Z{ zT)l$Y@#$z7vyL}n3B#hie)by4VzFFw@c1&pRwA{}i5AXiG;J;Ac>ml`x507>*?NED zyz#*Sk%|y=+ckZyf%4FIR;#ZboPbav*4a4-!NMhpx_RF^G;Gf6Pz;apFEbS%S^ei+ z>X^?+ged)>7c7l^OUum+U0*h}AsXzFxz_EQ_#W3I*RFXcU}*VZY&rzZ6Mz3M@kQ*j@;+a!sZJp2Hs*h z!d`Zpg(=BGZ#spv^dA`qV8I2b``V3vWWJsKZse@!z^*<{t)1`XNHf|t5Ba9BRKfVC zv;~v0+W-OKJ&CEVAi+wAb8fttc_v>JPJi@=H-n9y`0@EhdptkCZ^jSBCeC20vaz|{ zMfoiL$WFRRUrmcqFRTv^IMBJ<-P++%iU=eCS?iMmp_lMwSJE;86a$5Di@p!CoX#{mhCht4+E~=JoXUsM7yO0-j z-v82sd7$CV3{LtXDp)7`6C`|r1Ya|x=dYWdf||e*pg8jPd>M@PQC-_bY;Q!v1DM@z z8sZl;D*9;APSqmGIXOj1HNygxJ%wI5rPlSuL_q^8$L<^l+8-EPA6MQdN6lmA(goNy zykvkHxv`=&$e~7g@6Y#OzV@rgCAp{hA;Axp&e(8Z~e*94i4r0dJ=%E1J&QpKt`-%8}v*)qR8?6$UmXE_g36a-d$B3;)5Z{5!q8;V7L z2bl&Sn&^c4iKjukm2j)?dqk&)D~E+5bQ=GgO$<7j1VB^bK)WR=fM^b8ozCxl_K7)| zHzY0@g!d3+YaL_<3eD9t-4j1fy$l9}$ zH3S(Ig9(dQ`|YkE(NK;&7Jen9B{Ar!NkFy(=~xHmK(oKe!#x3^bh-c`wEKX?BV_nY z(G2c)W2G95V3R#*ihUVjmzc=);Wo7&^SUvRN%dO1c0S+aBZPQ{r*u7Riy$>{zC${u zvmO*uJv?wmg3~xG7$mxZ+vgMW&Vv5s#N3uWO=AJqpKK~RWSQG z%fkg=g@@w8)r#sM8V9lfC34M%k}bb~cq~Nlsb(cOr^F4Lx<5n$6&+D|je?_cVBPVh z5s}VgWO|LS53wy#SPx1tk!;O?rUw(y5CBNPPY!11L?z;ml$7mYg}0`7YHSKXvw4fY z;J^(`vvEubxPOVl8_?uZ4_&M+3Ft}2qZ?~+cZ?+9==+?Fn#T7xwb_M*-QfwUD;+hB zWWG$9M`#!-N9Nv~`YUk=2!}$53b1=OGrJff@B{oI_#j1*@_C?pa~WzP?863mN`t_3 zPF|tm{Z;fE#GJ0NzyJZ9U=-$tM<9e#9El`ha6G<(`>Opa)o7huIyl9)b-3#Cy_!9U zI>^L}hvzLiDPcJrMZ_Ac=*P<*Muvtxi=%KSn|>G{ic4LvBx7lY@k14*Zx9man;-Bo zLT9OFLIjc4hOvK~eoac?HR;Y~ybZ$_FCP3wuC;=Xx9nsiHy8Z#msuqmenqvN|{gi~AG8-R5 z>D5d9cY9XwrRfP2MY)ipxEA!`uN}JK4@c@56mlDsSG_0Q0YC;05#12P{4B?EVQiW< zX(NWye{$l$7^tUU+9H9~3Ynl8cB;3#7nGoC2`8vp@`8^Fy6~)=ewU})KNC8~7%g9~ z_Wql3Oc|H05ij}K=9Criflnt`6BX{AD^Y;o0Usaqw4=P=H5dadUZ)LA(1y@|WyKV9 z9val@PLDMGl!(Wyuy)^z6Za>x*-(nkae= z#`N)UmBpvGgc-{Zhcp&kFi!S{58aOc+`8NR8);7u)2BUniN0Y|X?&0!tuX(Gw}yQn>_@&IQ6Tv+ zb!luVaaH_L`GC`CCE$FM&>(K{*&eyFF791UlY-r1xl?TB^kS^VSJ0S7S0q`p@$Dgh89m zZ|>oA0fA0c|K#$Ck|T{JP+*P&_7!w!Uo}_|N(C>h#=ou^kyKR`S;xxquYPDI7|L3SS|j*>E7J$@F+KblV*C~j!_-NVAqQ9?VL1MOnJ zBxxJQS(pj@*p~Oowg8)jKm5LEww4M~YB65_6!RL)Tu=&vr=D3@C=t})>na9`Y}6Rp z!!_@Y9&AZ~1xtgWy(PZ+J;;$63YAt5XK?=D;P+sCESR*+LtWbzL76t; zf3jQ=hx9*M@+M0d2fu-dsE z(<<*NMbOvl@PY;Xv_WDUnO4&KJwc}@7~WOz#+G)ID>G^dS_@gt?4@3=<5{y6?lT`ofUN*K} ze}`cLeQUmHI#_SqGUKB7ExzNB*LLy08Cp*ZF|% z^o&l0dst96adHt6vdZ>b{;saBgN^(c4~LS~%fXmiGhGZZRD@>qY;kMTXUt<=1Rh_M zTnHvvExze9A$FI_A6`0j;-PMgODgaaXq0TjxvP5TX(qo!iHe1f(R^#HXfzO*q?zdm zH8T7iG_Nj#LiV|clpD&%J zH-(Vc8{}^$_t^KlBa;pdRapA${T2#7Hs{S&eI(~^iMtb5PZnGAV(AmlvWecqnPsn|j8ti!EJpxlkJB+CB7>VZD4oz9KW>EsivD zT2(24Qn`j%7?^!R|G@^R7jR$|uQ&c1Nj28PR1TIQbuai#srWvNDMnlh0l@$cQ$psi zLrNQI4f|2=d!wuG#O)z6P(K|cdc-Ul-&|LXew~V8PSREYJXYwWCdz}t_FvzM-Pd*DKY4ZKJM z0p|ahR}2!qd;}v!br0!?tJgR%{4eXJoqVNTgg#X|un_adhEHYtz}9Y4FZT1z8xGb- z#AT)Vv7OHc&kFeT$Hwt2FBaVeHCzxPJ$b^MzcTVJgXB!N&Qdtr=R_aMm4>D+UE2chhIcc@s3uMG*y1Q|ulEh5TdCKpB!bhJ`Bk zC)ckO)9v^h4@DyZ=m1gf{YpbBS-WDlL?bd5Bf|=|O@8l{`m0bHk>S3BjQt+C{2Z-3 zOsY$Ra0>%3jM=*%7-X$igtz-6+Xss&HABzbmM&Czx6XS|Di=F-Ll#BUEEfIOnAp4q zB_rQ^bJ8kh1c2gSodxIfJ+4FCODkcVk%T{>xsRf=9;YOO@oWJSdLlno@w1uo@m>G5 zjn30iRG!+v<1e;2P^or#=lKJDm7jvGN`%p7maOu(2ReI zy2`mvxT`iiQv^Ob#0x^?fL=Z0vS{ZzTmVwHiC5<2ZSz0k8PW@#HG zZhn{D;8Ps~^|FtGL{GlFtO!Bhk;sT>GVDyxDvnb@iCFVlS4obfZ)$jJ)H$J-wZ`{w z`>_uQ!8L9Pj`x34CpJ@6kqj0}g;ccM6(^}R-kqIdgT;2+V{L_A z?@vi`>#k17K6O#gLnQ%vtYYPTWB8gb;3ED$s)r*tpSTpKqN=eL@nLVpX%tr2Cjuh zTdoRKuIEa_cPfY)aeSXSyNV(gb{|gv9;$j5c}w8MXbk1^#u@X-|u7TNg*n zOqA62d16|7jd%Po8zq#a$0eqzNjvAc`G#1)0SV-qzWQv4PHV+S@X`Am2c%9#fj}lh z+K6cqSxqFY&z@xPVQV}U^8>q)dcg~b2Dcn~ngFgRFKHU5xUxdcBZ zv5bX1dx?Lt!NvO75@mqKg`~N@Y9Ut?NI>%_zrG+l@ANr5&j>Cy`Oe11@Wv!6y*5$C zzr3=>`;?Hg3nbF^_0rc)oSqBaKA$YVB%u4LY}mooU46NpGuG@y)PP|-0#WuuwI zm>H#Anwk*B$|M-@uPt?-a%SQ-Nd{++iv3Jk)L6m&Dyit+^QR!^BluiXLt%uYs(On? z7D~Xa&(sBc_yuD~sAvq`N5*#?7KxDJ%#uB(N`#DSe}B)F)ip|fTFq6(DiW5v-A@L| zng|?}ls}A|k>rr*nJ7Q++`&Ot>8E$Q)a*0K;Plb44h!TfjWuql)Z7RFe(*^(`ndmt z?H}C%_$;oq7E;Ox0;n@5Ffg|6T+`|(6AqjMMIY8axx)>wq76dQ7}X1 zAcPE#Cj2AoFUbvs6Y7K;UZOn6DF)1ogKi8qn;BkEgy`dwmu~ccZ;JU*Lnjto?Zd^` z7Bq8PHmo@X?>8=*nfKLOVnrtaw>57ImHwXPCfhLte|uKnP9Jt+dcgiFoKd3Vk3O1N z;I?Ivi*;`{9{U~kx~}>@(C{;2^MR!7Mui) zlT(c`8E^fy*)KY{%gwGsto1gi4%YGrivNWs~?vJr%G ziJ=KT_a7JXlS`nbR}TL2h4bfV63#dV49M7!{oEgDxt-)UF-ju!0xDEG(xGKrzB#Xd zf*O{hQ}8y;yWAQ}+|)gHcZ#*|^iVR+J{sNZnSfLj)v3&4J!HQ^UG!2kZ2?=(8aFOb z+vOYqeGts<{(lUxb33W@cJ84c>IDo~wU3Ib*{J<7Was^MW_^(H+OXd~=YQs_the*n z*BkOhU_VPI;90AN|C$^j()ry&2%I5S)5lNP5_!e9q;c1h6WPY&TKwS0~z9+(H4n+bJ zfA^;T96%Lu>DeJa`GPdmekf}xqy{E#d=Yn75>~j_{J6vlUBU$zAa4bIdn@K>IuPOZ zj|w=kS#e;#eua`JXFz8^&`Im)YP@F*njmuFJwZxHbgeXB1Jm0;PKtVtVZDz77tqR` z<}M{G6c=$#dDE7I)$I>~^o$t>^?_7^PweZmV8WbGo8VoqVgU;os^XW_%qPfhX`>9}a9U0I{p9t~H;aM1gd2n|zflg=Dd!3aYxu((4g zVFIv#H`0kW+_m-50vC7&o}nQUx#=3qE!)n`kVJO?za=bXs z&q92nTvQYl60h`9Ras!=LM9zLi=Kn62=j_L5-6M zHS`LA-5uX9rekjN3p+K=NQ?nh92LbH7Y9mvihLk5T|?_-{lhddR0;QoYV1`cC;_wm z?p6TG;|A&YRWsUqP|X8UiG&pnlyr`{p9fiU|FoyjWAnE0luNtKYi!Cxg$R2L2mEQ{4OcM=@;d_ z9*+b=HbIA+tz93!7jyOSc+X$uf+1~Yigig!Akcg9&;O3U;FEU3IHZR-Fl}B3IF{%V zun15n7mk@wgVyg6CRpi5xsI~X=NJ2eL&NZ>=O^@71BwqFG}5;EwaR9e{|;jW>p$;) zU#Th^HA%W3rA*$}maJ4hb}GTw9hxH1Vl|W&=gWh9pbd>o+}F}-fhLg6Ey~hA469FF z1uBk#Va>l0vd9-c`_KE6!x%uZ+DZ@{SA+GuT6l`49P7IZ9rdXG5lpPFF8sywMLb%U zdq1@uim@2jJF-4}-xUdzBh+(e|D@OWBWv&BOg}u2Iu{2hlCiJiuT;_6ysDN;9Y?4^ z_qz-_30YaB72C)6_$V(WI07>2ZeVSF;b9fXsjIpjoyu?)Vi3#bVKV>4>;G9(-!$NL z8-ASNoYou37P4ZED!CUZ|5D#8dm{BTimestamp Key

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":311.0,"y":147.0,"rotation":0.0,"id":268,"width":18.0,"height":53.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":178,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":152,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":264,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-3.417721518987321,-4.214000000000027],[9.708860759493689,-4.214000000000027],[9.708860759493689,50.74999999999994],[22.8354430379747,50.74999999999994]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":415.0,"y":313.0,"rotation":0.0,"id":250,"width":7.0,"height":413.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":172,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":79,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[3.5,-3.0],[9.5,497.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":290.0,"y":340.0,"rotation":0.0,"id":11,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.user","order":12,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":12,"width":48.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Account

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":479.0,"y":330.0,"rotation":0.0,"id":2,"width":120.0,"height":80.0,"uid":"com.gliffy.shape.network.network_v4.business.user_group","order":9,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user_group","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":3,"width":73.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Organization

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":159.0,"y":310.0,"rotation":0.0,"id":79,"width":531.0,"height":500.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ffffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":159.00000000000003,"y":320.0,"rotation":0.0,"id":82,"width":108.99999999999999,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":58,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Registry

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":730.0,"y":340.0,"rotation":0.0,"id":86,"width":61.0,"height":79.0,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":59,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ff0000","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":87,"width":62.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Offline key

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":730.0,"y":455.0,"rotation":0.0,"id":88,"width":61.0,"height":79.0,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":62,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":89,"width":70.0,"height":14.0,"uid":null,"order":64,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Tagging key

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":360.4891500904159,"y":650.0,"rotation":0.0,"id":227,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":158,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":228,"width":16.0,"height":18.0,"uid":null,"order":160,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

X

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":185.1428571428571,"y":587.0,"rotation":0.0,"id":109,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":81,"lockAspectRatio":false,"lockShape":false,"children":[{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":98,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":74,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":99,"width":71.42857142857143,"height":50.0,"uid":null,"order":77,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":98}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":98}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":100,"width":50.0,"height":18.0,"uid":null,"order":80,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":98,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

working

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":95,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":66,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":96,"width":71.42857142857143,"height":50.0,"uid":null,"order":69,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":95}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":95}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":97,"width":38.0,"height":18.0,"uid":null,"order":72,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":95,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":30,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":24,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":31,"width":110.00000000000001,"height":25.0,"uid":null,"order":27,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":32}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":32,"width":110.00000000000001,"height":25.0,"uid":null,"order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":33,"width":110.00000000000001,"height":55.0,"uid":null,"order":34,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":30},{"magnitude":-1,"id":32}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":32,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":184.21428571428567,"y":450.0,"rotation":0.0,"id":253,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":173,"lockAspectRatio":false,"lockShape":false,"children":[{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":125,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":83,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":126,"width":110.00000000000001,"height":25.0,"uid":null,"order":86,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":127}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":127,"width":110.00000000000001,"height":25.0,"uid":null,"order":90,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":128,"width":110.00000000000001,"height":55.0,"uid":null,"order":93,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":125},{"magnitude":-1,"id":127}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":127,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":122,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":95,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":123,"width":71.42857142857143,"height":50.0,"uid":null,"order":98,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":122}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":122}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":124,"width":38.0,"height":18.0,"uid":null,"order":101,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":122,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":119,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":103,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":120,"width":71.42857142857143,"height":50.0,"uid":null,"order":106,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":119}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":119}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":121,"width":26.0,"height":18.0,"uid":null,"order":109,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":119,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

2.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":479.0,"y":120.74999999999994,"rotation":0.0,"id":261,"width":155.08307142857143,"height":168.072,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":174,"lockAspectRatio":false,"lockShape":false,"children":[{"x":85.65449999999998,"y":38.0,"rotation":0.0,"id":245,"width":28.0,"height":43.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":171,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":193,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":204,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[2.5108499095841808,-13.999999999999972],[16.0465641952984,-13.999999999999972],[16.0465641952984,39.0],[29.582278481012622,39.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":null},{"x":89.65449999999998,"y":25.0,"rotation":0.0,"id":244,"width":24.0,"height":1.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":169,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":193,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":192,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-1.4891500904158192,-0.9999999999999716],[7.534659433393699,-0.9999999999999716],[16.558468957203104,-0.9999999999999716],[25.582278481012622,-0.9999999999999716]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":null},{"x":115.2367784810126,"y":62.0,"rotation":0.0,"id":204,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":151,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":205,"width":15.0,"height":16.0,"uid":null,"order":154,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

C

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null},{"x":115.2367784810126,"y":9.000000000000028,"rotation":0.0,"id":192,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":148,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":201,"width":15.0,"height":16.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null},{"x":65.0007929475588,"y":9.000000000000028,"rotation":0.0,"id":193,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":141,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ff0000","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":194,"width":14.0,"height":18.0,"uid":null,"order":144,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

2

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null},{"x":55.08307142857143,"y":0.0,"rotation":0.0,"id":195,"width":100.0,"height":133.0,"uid":"com.gliffy.shape.ui.ui_v3.containers_content.speech_bubble_right","order":129,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"MinWidthConstraint","MinWidthConstraint":{"width":100}},{"type":"HeightConstraint","HeightConstraint":{"isMin":true,"heightInfo":[{"magnitude":1,"id":197},{"magnitude":1,"id":198}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":196,"width":100.0,"height":118.0,"uid":null,"order":132,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":195,"px":0.0,"py":0.0,"xOffset":0.0,"yOffset":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":195},{"magnitude":-1,"id":198}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":195}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":197,"width":100.0,"height":29.0,"uid":null,"order":136,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":195}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":36.0,"y":117.0,"rotation":0.0,"id":198,"width":24.0,"height":15.0,"uid":null,"order":139,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"ConstWidthConstraint","ConstWidthConstraint":{"width":24}},{"type":"ConstHeightConstraint","ConstHeightConstraint":{"height":15}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":196,"px":1.0,"py":1.0,"xOffset":-64.0,"yOffset":-1.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble_right","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":67.0,"rotation":0.0,"id":180,"width":67.309,"height":101.072,"uid":"com.gliffy.shape.cisco.cisco_v1.buildings.generic_building","order":126,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.buildings.generic_building","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":182,"width":56.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Company

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":231.1785714285715,"y":204.78599999999997,"rotation":0.0,"id":0,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.female_user","order":6,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.female_user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":1,"width":43.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Person

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":272.07142857142856,"y":120.286,"rotation":0.0,"id":171,"width":100.0,"height":132.0,"uid":"com.gliffy.shape.ui.ui_v3.containers_content.speech_bubble_right","order":112,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"MinWidthConstraint","MinWidthConstraint":{"width":100}},{"type":"HeightConstraint","HeightConstraint":{"isMin":true,"heightInfo":[{"magnitude":1,"id":173},{"magnitude":1,"id":174}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":172,"width":100.0,"height":117.0,"uid":null,"order":114,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":171,"px":0.0,"py":0.0,"xOffset":0.0,"yOffset":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":171},{"magnitude":-1,"id":174}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":171}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":173,"width":100.0,"height":29.0,"uid":null,"order":117,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":171}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":36.0,"y":116.0,"rotation":0.0,"id":174,"width":24.0,"height":15.0,"uid":null,"order":119,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"ConstWidthConstraint","ConstWidthConstraint":{"width":24}},{"type":"ConstHeightConstraint","ConstHeightConstraint":{"height":15}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":172,"px":1.0,"py":1.0,"xOffset":-64.0,"yOffset":-1.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble_right","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":310.5,"y":146.78599999999997,"rotation":0.0,"id":239,"width":20.0,"height":1.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":167,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":152,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":237,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-2.917721518987321,-4.0],[6.078661844484657,-4.0],[15.075045207956578,-4.0],[24.071428571428555,-4.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":333.8354430379747,"y":182.74999999999994,"rotation":0.0,"id":264,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":175,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":265,"width":21.0,"height":18.0,"uid":null,"order":177,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 N

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":284.4177215189874,"y":127.78599999999997,"rotation":0.0,"id":152,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":120,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ff0000","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":153,"width":14.0,"height":18.0,"uid":null,"order":122,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

1

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":334.57142857142856,"y":127.78599999999997,"rotation":0.0,"id":237,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":164,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":238,"width":16.0,"height":18.0,"uid":null,"order":166,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

X

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":565.0,"y":500.0,"rotation":0.0,"id":40,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":1,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":41,"width":71.42857142857143,"height":50.0,"uid":null,"order":3,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":40}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":40}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285666,"y":0.0,"rotation":0.0,"id":42,"width":26.0,"height":18.0,"uid":null,"order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":40,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

1.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":454.99999999999994,"y":461.0,"rotation":0.0,"id":16,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":15,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":17,"width":110.00000000000001,"height":25.0,"uid":null,"order":17,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":18}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":18,"width":110.00000000000001,"height":25.0,"uid":null,"order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":19,"width":110.00000000000001,"height":55.0,"uid":null,"order":22,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":16},{"magnitude":-1,"id":18}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":18,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":565.0,"y":450.0,"rotation":0.0,"id":37,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":35,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":38,"width":71.42857142857143,"height":50.0,"uid":null,"order":37,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":37}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":37}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285666,"y":0.0,"rotation":0.0,"id":39,"width":38.0,"height":18.0,"uid":null,"order":39,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":37,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":443.4177215189873,"y":513.0,"rotation":0.0,"id":229,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":161,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":230,"width":15.0,"height":16.0,"uid":null,"order":163,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":565.0,"y":630.0,"rotation":0.0,"id":63,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":40,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":64,"width":71.42857142857143,"height":50.0,"uid":null,"order":42,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":63}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":63}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285666,"y":0.0,"rotation":0.0,"id":65,"width":68.0,"height":18.0,"uid":null,"order":44,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":63,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

producttion

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":454.99999999999994,"y":591.0,"rotation":0.0,"id":58,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":45,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":59,"width":110.00000000000001,"height":25.0,"uid":null,"order":47,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":60}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":60,"width":110.00000000000001,"height":25.0,"uid":null,"order":50,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":61,"width":110.00000000000001,"height":55.0,"uid":null,"order":52,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":58},{"magnitude":-1,"id":60}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":60,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":565.0,"y":580.0,"rotation":0.0,"id":55,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":53,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":56,"width":71.42857142857143,"height":50.0,"uid":null,"order":55,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":55}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":55}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285666,"y":0.0,"rotation":0.0,"id":57,"width":28.0,"height":18.0,"uid":null,"order":57,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":55,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

test

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":443.4177215189873,"y":646.0,"rotation":0.0,"id":221,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":155,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":222,"width":15.0,"height":16.0,"uid":null,"order":157,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

C

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":565.0,"y":745.0,"rotation":0.0,"id":281,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":179,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":282,"width":71.42857142857143,"height":50.0,"uid":null,"order":181,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":281}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":281}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285666,"y":0.0,"rotation":0.0,"id":283,"width":48.0,"height":18.0,"uid":null,"order":183,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":281,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

release

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":454.99999999999994,"y":706.0,"rotation":0.0,"id":277,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":184,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":278,"width":110.00000000000001,"height":25.0,"uid":null,"order":186,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":279}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":279,"width":110.00000000000001,"height":25.0,"uid":null,"order":189,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":280,"width":110.00000000000001,"height":55.0,"uid":null,"order":191,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":277},{"magnitude":-1,"id":279}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":279,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":565.0,"y":695.0,"rotation":0.0,"id":274,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":192,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":275,"width":71.42857142857143,"height":50.0,"uid":null,"order":194,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":274}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":274}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285666,"y":0.0,"rotation":0.0,"id":276,"width":26.0,"height":18.0,"uid":null,"order":196,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":274,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

7.5

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":360.4891500904159,"y":510.0,"rotation":0.0,"id":289,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":197,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":290,"width":21.0,"height":18.0,"uid":null,"order":199,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 N

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":332.57142857142856,"y":532.0,"rotation":0.0,"id":301,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":205,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.4177215189874,"y":670.0,"rotation":0.0,"id":302,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":206,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":466.5822784810126,"y":667.0,"rotation":0.0,"id":303,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":207,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":621.401335443038,"y":508.0,"rotation":0.0,"id":306,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":209,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":621.401335443038,"y":459.0,"rotation":0.0,"id":307,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":210,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":621.401335443038,"y":589.0,"rotation":0.0,"id":308,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":211,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":186.21428571428567,"y":594.0,"rotation":0.0,"id":309,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":212,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":189.21428571428567,"y":644.0,"rotation":0.0,"id":310,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":213,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":810.0,"y":358.5,"rotation":0.0,"id":164,"width":217.0,"height":70.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":110,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A offline key is used to create repository keys. Offline keys belong to a person or an organization. Resides client-side. You should store these in a safe place and back them up. 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":810.0,"y":487.5,"rotation":0.0,"id":170,"width":217.0,"height":56.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":111,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A tagging key is associated with an image repository. publishers with this key can push or pull any tag in this repository. This resides on client-side.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":810.0,"y":587.0,"rotation":0.0,"id":298,"width":217.0,"height":42.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":203,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A timestamp key is associated with an image repository. This is created by Docker and resides on the server.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":743.3333333333334,"y":681.0,"rotation":0.0,"id":314,"width":283.66666666666663,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":215,"lockAspectRatio":false,"lockShape":false,"children":[{"x":66.66666666666663,"y":4.0,"rotation":0.0,"id":312,"width":217.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":214,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Signed tag.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":0.0,"rotation":0.0,"id":304,"width":33.333333333333336,"height":20.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":208,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"}],"layers":[{"guid":"dockVlz9GmcW","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":216}],"shapeStyles":{},"lineStyles":{"global":{"strokeWidth":1,"endArrow":17}},"textStyles":{"global":{"size":"16px","color":"#000000"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.cisco.cisco_v1.buildings","com.gliffy.libraries.sitemap.sitemap_v2","com.gliffy.libraries.sitemap.sitemap_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.table.table_v2.default","com.gliffy.libraries.ui.ui_v3.navigation","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.ui.ui_v3.icon_symbols","com.gliffy.libraries.ui.ui_v2.forms_components","com.gliffy.libraries.ui.ui_v2.content","com.gliffy.libraries.ui.ui_v2.miscellaneous","com.gliffy.libraries.network.network_v4.business","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.bpmn.bpmn_v1.events","com.gliffy.libraries.bpmn.bpmn_v1.activities","com.gliffy.libraries.bpmn.bpmn_v1.data_artifacts","com.gliffy.libraries.bpmn.bpmn_v1.gateways","com.gliffy.libraries.bpmn.bpmn_v1.connectors","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.images"],"lastSerialized":1439068390533},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/security/trust/images/trust_components.gliffy b/docs/security/trust/images/trust_components.gliffy new file mode 100644 index 0000000000..07c859bb12 --- /dev/null +++ b/docs/security/trust/images/trust_components.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":881,"height":704,"nodeIndex":316,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":true,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":null,"printShrinkToFit":false,"printPortrait":false,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":10,"y":10},"max":{"x":880.0000000000001,"y":703.7139999999999}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":10.0,"y":199.714,"rotation":0.0,"id":79,"width":531.0,"height":500.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ffffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":389.714,"rotation":0.0,"id":40,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":1,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":41,"width":71.42857142857143,"height":50.0,"uid":null,"order":3,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":40}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":40}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":42,"width":26.0,"height":18.0,"uid":null,"order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":40,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

1.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":82.1785714285715,"y":94.49999999999997,"rotation":0.0,"id":0,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.female_user","order":6,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.female_user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":1,"width":43.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Person

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.0,"y":219.714,"rotation":0.0,"id":2,"width":120.0,"height":80.0,"uid":"com.gliffy.shape.network.network_v4.business.user_group","order":9,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user_group","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":3,"width":73.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Organization

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":141.0,"y":229.714,"rotation":0.0,"id":11,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.user","order":12,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":12,"width":48.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Account

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":350.714,"rotation":0.0,"id":16,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":15,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":17,"width":110.00000000000001,"height":25.0,"uid":null,"order":17,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":18}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":18,"width":110.00000000000001,"height":25.0,"uid":null,"order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":19,"width":110.00000000000001,"height":55.0,"uid":null,"order":22,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":16},{"magnitude":-1,"id":18}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":18,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":339.714,"rotation":0.0,"id":37,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":35,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":38,"width":71.42857142857143,"height":50.0,"uid":null,"order":37,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":37}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":37}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":39,"width":38.0,"height":18.0,"uid":null,"order":39,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":37,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":519.7139999999999,"rotation":0.0,"id":63,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":40,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":64,"width":71.42857142857143,"height":50.0,"uid":null,"order":42,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":63}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":63}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":65,"width":68.0,"height":18.0,"uid":null,"order":44,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":63,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

producttion

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":480.71399999999994,"rotation":0.0,"id":58,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":45,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":59,"width":110.00000000000001,"height":25.0,"uid":null,"order":47,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":60}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":60,"width":110.00000000000001,"height":25.0,"uid":null,"order":50,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":61,"width":110.00000000000001,"height":55.0,"uid":null,"order":52,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":58},{"magnitude":-1,"id":60}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":60,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":469.714,"rotation":0.0,"id":55,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":53,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":56,"width":71.42857142857143,"height":50.0,"uid":null,"order":55,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":55}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":55}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":57,"width":28.0,"height":18.0,"uid":null,"order":57,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":55,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

test

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":10.000000000000036,"y":209.714,"rotation":0.0,"id":82,"width":108.99999999999999,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":58,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Registry

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":581.0,"y":229.714,"rotation":0.0,"id":86,"width":61.0,"height":79.0,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":59,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ff0000","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":87,"width":62.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Offline key

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":581.0,"y":344.714,"rotation":0.0,"id":88,"width":61.0,"height":79.0,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":62,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":89,"width":70.0,"height":14.0,"uid":null,"order":64,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Tagging key

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":36.142857142857125,"y":476.71399999999994,"rotation":0.0,"id":109,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":81,"lockAspectRatio":false,"lockShape":false,"children":[{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":98,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":74,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":99,"width":71.42857142857143,"height":50.0,"uid":null,"order":77,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":98}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":98}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":100,"width":50.0,"height":18.0,"uid":null,"order":80,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":98,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

working

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":95,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":66,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":96,"width":71.42857142857143,"height":50.0,"uid":null,"order":69,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":95}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":95}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":97,"width":38.0,"height":18.0,"uid":null,"order":72,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":95,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":30,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":24,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":31,"width":110.00000000000001,"height":25.0,"uid":null,"order":27,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":32}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":32,"width":110.00000000000001,"height":25.0,"uid":null,"order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":33,"width":110.00000000000001,"height":55.0,"uid":null,"order":34,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":30},{"magnitude":-1,"id":32}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":32,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":661.0,"y":248.214,"rotation":0.0,"id":164,"width":217.0,"height":70.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":110,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A offline key is used to create tagging keys. Offline keys belong to a person or an organization. Resides client-side. You should store these in a safe place and back them up. 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":661.0,"y":377.214,"rotation":0.0,"id":170,"width":217.0,"height":56.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":111,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A tagging key is associated with an image repository. Creators with this key can push or pull any tag in this repository. This resides on client-side.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":123.07142857142856,"y":10.0,"rotation":0.0,"id":171,"width":100.0,"height":132.0,"uid":"com.gliffy.shape.ui.ui_v3.containers_content.speech_bubble_right","order":112,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"MinWidthConstraint","MinWidthConstraint":{"width":100}},{"type":"HeightConstraint","HeightConstraint":{"isMin":true,"heightInfo":[{"magnitude":1,"id":173},{"magnitude":1,"id":174}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":172,"width":100.0,"height":117.0,"uid":null,"order":114,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":171,"px":0.0,"py":0.0,"xOffset":0.0,"yOffset":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":171},{"magnitude":-1,"id":174}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":171}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":173,"width":100.0,"height":29.0,"uid":null,"order":117,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":171}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":36.0,"y":116.0,"rotation":0.0,"id":174,"width":24.0,"height":15.0,"uid":null,"order":119,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"ConstWidthConstraint","ConstWidthConstraint":{"width":24}},{"type":"ConstHeightConstraint","ConstHeightConstraint":{"height":15}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":172,"px":1.0,"py":1.0,"xOffset":-64.0,"yOffset":-1.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble_right","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":135.41772151898738,"y":17.499999999999968,"rotation":0.0,"id":152,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":120,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ff0000","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":153,"width":14.0,"height":18.0,"uid":null,"order":122,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

1

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":294.4177215189873,"y":535.7139999999999,"rotation":0.0,"id":221,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":155,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":222,"width":15.0,"height":16.0,"uid":null,"order":157,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

C

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":211.48915009041588,"y":539.7139999999999,"rotation":0.0,"id":227,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":158,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":228,"width":16.0,"height":18.0,"uid":null,"order":160,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

X

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":294.4177215189873,"y":402.714,"rotation":0.0,"id":229,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":161,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":230,"width":15.0,"height":16.0,"uid":null,"order":163,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":185.57142857142856,"y":17.499999999999968,"rotation":0.0,"id":237,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":164,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":238,"width":16.0,"height":18.0,"uid":null,"order":166,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

X

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":161.5,"y":36.49999999999997,"rotation":0.0,"id":239,"width":20.0,"height":1.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":167,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":152,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":237,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-2.9177215189872925,-4.0],[6.078661844484657,-4.0],[15.075045207956606,-4.0],[24.071428571428555,-4.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":266.0,"y":202.714,"rotation":0.0,"id":250,"width":7.0,"height":413.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":172,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":79,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[3.5,-3.0],[9.5,496.99999999999994]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":35.21428571428568,"y":339.714,"rotation":0.0,"id":253,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":173,"lockAspectRatio":false,"lockShape":false,"children":[{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":125,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":83,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":126,"width":110.00000000000001,"height":25.0,"uid":null,"order":86,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":127}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":127,"width":110.00000000000001,"height":25.0,"uid":null,"order":90,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":128,"width":110.00000000000001,"height":55.0,"uid":null,"order":93,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":125},{"magnitude":-1,"id":127}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":127,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":122,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":95,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":123,"width":71.42857142857143,"height":50.0,"uid":null,"order":98,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":122}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":122}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":124,"width":38.0,"height":18.0,"uid":null,"order":101,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":122,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":119,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":103,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":120,"width":71.42857142857143,"height":50.0,"uid":null,"order":106,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":119}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":119}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":121,"width":26.0,"height":18.0,"uid":null,"order":109,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":119,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

2.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.0,"y":10.463999999999942,"rotation":0.0,"id":261,"width":155.08307142857143,"height":168.072,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":174,"lockAspectRatio":false,"lockShape":false,"children":[{"x":85.65449999999998,"y":38.0,"rotation":0.0,"id":245,"width":28.0,"height":43.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":171,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":193,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":204,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[2.510849909584124,-13.999999999999972],[16.0465641952984,-13.999999999999972],[16.0465641952984,39.0],[29.582278481012622,39.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":null},{"x":89.65449999999998,"y":25.0,"rotation":0.0,"id":244,"width":24.0,"height":1.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":169,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":193,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":192,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-1.489150090415876,-0.9999999999999716],[7.534659433393642,-0.9999999999999716],[16.558468957203104,-0.9999999999999716],[25.582278481012622,-0.9999999999999716]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":null},{"x":115.2367784810126,"y":62.0,"rotation":0.0,"id":204,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":151,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":205,"width":15.0,"height":16.0,"uid":null,"order":154,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

C

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null},{"x":115.2367784810126,"y":9.000000000000028,"rotation":0.0,"id":192,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":148,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":201,"width":15.0,"height":16.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null},{"x":65.0007929475588,"y":9.000000000000028,"rotation":0.0,"id":193,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":141,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ff0000","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":194,"width":14.0,"height":18.0,"uid":null,"order":144,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

2

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null},{"x":55.08307142857143,"y":0.0,"rotation":0.0,"id":195,"width":100.0,"height":133.0,"uid":"com.gliffy.shape.ui.ui_v3.containers_content.speech_bubble_right","order":129,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"MinWidthConstraint","MinWidthConstraint":{"width":100}},{"type":"HeightConstraint","HeightConstraint":{"isMin":true,"heightInfo":[{"magnitude":1,"id":197},{"magnitude":1,"id":198}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":196,"width":100.0,"height":118.0,"uid":null,"order":132,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":195,"px":0.0,"py":0.0,"xOffset":0.0,"yOffset":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":195},{"magnitude":-1,"id":198}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":195}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":197,"width":100.0,"height":29.0,"uid":null,"order":136,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":195}],"minWidth":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":36.0,"y":117.0,"rotation":0.0,"id":198,"width":24.0,"height":15.0,"uid":null,"order":139,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"ConstWidthConstraint","ConstWidthConstraint":{"width":24}},{"type":"ConstHeightConstraint","ConstHeightConstraint":{"height":15}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":196,"px":1.0,"py":1.0,"xOffset":-64.0,"yOffset":-1.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.containers_content.speech_bubble_right","strokeWidth":2.0,"strokeColor":"#BBBBBB","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":67.0,"rotation":0.0,"id":180,"width":67.309,"height":101.072,"uid":"com.gliffy.shape.cisco.cisco_v1.buildings.generic_building","order":126,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.buildings.generic_building","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":182,"width":56.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Company

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":184.8354430379747,"y":72.46399999999994,"rotation":0.0,"id":264,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":175,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":265,"width":21.0,"height":18.0,"uid":null,"order":177,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 N

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":162.0,"y":36.714,"rotation":0.0,"id":268,"width":18.0,"height":53.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":178,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":152,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":264,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":17,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-3.4177215189872925,-4.214000000000027],[9.708860759493689,-4.214000000000027],[9.708860759493689,50.74999999999994],[22.8354430379747,50.74999999999994]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":634.7139999999999,"rotation":0.0,"id":281,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":179,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":282,"width":71.42857142857143,"height":50.0,"uid":null,"order":181,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":281}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":281}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":283,"width":48.0,"height":18.0,"uid":null,"order":183,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":281,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

release

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":595.7139999999999,"rotation":0.0,"id":277,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":184,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":278,"width":110.00000000000001,"height":25.0,"uid":null,"order":186,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":279}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":279,"width":110.00000000000001,"height":25.0,"uid":null,"order":189,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":280,"width":110.00000000000001,"height":55.0,"uid":null,"order":191,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":277},{"magnitude":-1,"id":279}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":279,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":584.7139999999999,"rotation":0.0,"id":274,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":192,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":275,"width":71.42857142857143,"height":50.0,"uid":null,"order":194,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":274}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":274}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":276,"width":26.0,"height":18.0,"uid":null,"order":196,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":274,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

7.5

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":211.48915009041588,"y":399.714,"rotation":0.0,"id":289,"width":23.16455696202532,"height":30.000000000000007,"uid":"com.gliffy.shape.network.network_v4.business.encrypted","order":197,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.encrypted","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":290,"width":21.0,"height":18.0,"uid":null,"order":199,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

 N

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":584.0,"y":467.714,"rotation":0.0,"id":294,"width":54.0,"height":54.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":200,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":297,"width":88.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Timestamp Key

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":661.0,"y":476.714,"rotation":0.0,"id":298,"width":217.0,"height":42.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":203,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

A timestamp key is associated with an image repository. This is created by Docker and resides on the server.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":316.5822784810126,"y":420.714,"rotation":0.0,"id":299,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":204,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":183.57142857142856,"y":421.714,"rotation":0.0,"id":301,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":205,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":181.41772151898738,"y":559.7139999999999,"rotation":0.0,"id":302,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":206,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":317.5822784810126,"y":556.7139999999999,"rotation":0.0,"id":303,"width":30.0,"height":30.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.events.timer_intermediate","order":207,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.timer_intermediate.bpmn_v1","strokeWidth":2.0,"strokeColor":"#000000","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":397.714,"rotation":0.0,"id":306,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":209,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":348.714,"rotation":0.0,"id":307,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":210,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":478.714,"rotation":0.0,"id":308,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":211,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":37.214285714285666,"y":483.714,"rotation":0.0,"id":309,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":212,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":40.214285714285666,"y":533.7139999999999,"rotation":0.0,"id":310,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":213,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":594.3333333333335,"y":570.7139999999999,"rotation":0.0,"id":314,"width":283.66666666666663,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":215,"lockAspectRatio":false,"lockShape":false,"children":[{"x":66.66666666666663,"y":4.0,"rotation":0.0,"id":312,"width":217.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":214,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Signed tag.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":0.0,"rotation":0.0,"id":304,"width":33.333333333333336,"height":20.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":208,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"}],"layers":[{"guid":"dockVlz9GmcW","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":216}],"shapeStyles":{},"lineStyles":{"global":{"strokeWidth":1,"endArrow":17}},"textStyles":{"global":{"size":"16px","color":"#000000"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.cisco.cisco_v1.buildings","com.gliffy.libraries.sitemap.sitemap_v2","com.gliffy.libraries.sitemap.sitemap_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.table.table_v2.default","com.gliffy.libraries.ui.ui_v3.navigation","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.ui.ui_v3.icon_symbols","com.gliffy.libraries.ui.ui_v2.forms_components","com.gliffy.libraries.ui.ui_v2.content","com.gliffy.libraries.ui.ui_v2.miscellaneous","com.gliffy.libraries.network.network_v4.business","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.bpmn.bpmn_v1.events","com.gliffy.libraries.bpmn.bpmn_v1.activities","com.gliffy.libraries.bpmn.bpmn_v1.data_artifacts","com.gliffy.libraries.bpmn.bpmn_v1.gateways","com.gliffy.libraries.bpmn.bpmn_v1.connectors","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.images"],"lastSerialized":1439174260766},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/security/trust/images/trust_components.png b/docs/security/trust/images/trust_components.png new file mode 100644 index 0000000000000000000000000000000000000000..039dfc8cf323cf1933ebb385a5b0edd2e6be37ab GIT binary patch literal 124071 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⁢TU`eop|-D&mDE^r8- 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�F@G@g&NL2I{H@a(~7fKAG%LonU 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 literal 0 HcmV?d00001 diff --git a/docs/security/trust/images/trust_signing.gliffy b/docs/security/trust/images/trust_signing.gliffy new file mode 100644 index 0000000000..b21fa3665e --- /dev/null +++ b/docs/security/trust/images/trust_signing.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":881,"height":627,"nodeIndex":322,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":true,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":null,"printShrinkToFit":false,"printPortrait":false,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":10,"y":0},"max":{"x":880.0000000000001,"y":626.25}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":10.0,"y":122.25000000000006,"rotation":0.0,"id":79,"width":531.0,"height":500.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ffffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":312.25000000000006,"rotation":0.0,"id":40,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":1,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":41,"width":71.42857142857143,"height":50.0,"uid":null,"order":3,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":40}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":40}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":42,"width":26.0,"height":18.0,"uid":null,"order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":40,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

1.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":82.1785714285715,"y":17.03600000000003,"rotation":0.0,"id":0,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.female_user","order":6,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.female_user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":1,"width":43.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Person

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.0,"y":142.25000000000006,"rotation":0.0,"id":2,"width":120.0,"height":80.0,"uid":"com.gliffy.shape.network.network_v4.business.user_group","order":9,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user_group","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":3,"width":73.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Organization

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":141.0,"y":152.25000000000006,"rotation":0.0,"id":11,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.user","order":12,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":12,"width":48.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Account

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":273.25000000000006,"rotation":0.0,"id":16,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":15,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":17,"width":110.00000000000001,"height":25.0,"uid":null,"order":17,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":18}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":18,"width":110.00000000000001,"height":25.0,"uid":null,"order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":19,"width":110.00000000000001,"height":55.0,"uid":null,"order":22,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":16},{"magnitude":-1,"id":18}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":18,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":262.25000000000006,"rotation":0.0,"id":37,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":35,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":38,"width":71.42857142857143,"height":50.0,"uid":null,"order":37,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":37}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":37}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":39,"width":38.0,"height":18.0,"uid":null,"order":39,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":37,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":442.25000000000006,"rotation":0.0,"id":63,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":40,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":64,"width":71.42857142857143,"height":50.0,"uid":null,"order":42,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":63}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":63}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":65,"width":68.0,"height":18.0,"uid":null,"order":44,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":63,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

producttion

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":403.25000000000006,"rotation":0.0,"id":58,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":45,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":59,"width":110.00000000000001,"height":25.0,"uid":null,"order":47,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":60}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":60,"width":110.00000000000001,"height":25.0,"uid":null,"order":50,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":61,"width":110.00000000000001,"height":55.0,"uid":null,"order":52,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":58},{"magnitude":-1,"id":60}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":60,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":392.25000000000006,"rotation":0.0,"id":55,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":53,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":56,"width":71.42857142857143,"height":50.0,"uid":null,"order":55,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":55}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":55}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":57,"width":28.0,"height":18.0,"uid":null,"order":57,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":55,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

test

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":10.000000000000036,"y":132.25000000000006,"rotation":0.0,"id":82,"width":108.99999999999999,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":58,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Registry

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":36.142857142857125,"y":399.25000000000006,"rotation":0.0,"id":109,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":81,"lockAspectRatio":false,"lockShape":false,"children":[{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":98,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":74,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":99,"width":71.42857142857143,"height":50.0,"uid":null,"order":77,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":98}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":98}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":100,"width":50.0,"height":18.0,"uid":null,"order":80,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":98,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

working

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":95,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":66,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":96,"width":71.42857142857143,"height":50.0,"uid":null,"order":69,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":95}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":95}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":97,"width":38.0,"height":18.0,"uid":null,"order":72,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":95,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":30,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":24,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":31,"width":110.00000000000001,"height":25.0,"uid":null,"order":27,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":32}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":32,"width":110.00000000000001,"height":25.0,"uid":null,"order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":33,"width":110.00000000000001,"height":55.0,"uid":null,"order":34,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":30},{"magnitude":-1,"id":32}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":32,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.0,"y":0.0,"rotation":0.0,"id":180,"width":67.309,"height":101.072,"uid":"com.gliffy.shape.cisco.cisco_v1.buildings.generic_building","order":126,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.buildings.generic_building","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":182,"width":56.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Company

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":266.0,"y":125.25000000000006,"rotation":0.0,"id":250,"width":7.0,"height":413.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":172,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":79,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[3.5,-3.0],[9.5,496.99999999999994]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":35.21428571428568,"y":262.25000000000006,"rotation":0.0,"id":253,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":173,"lockAspectRatio":false,"lockShape":false,"children":[{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":125,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":83,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":126,"width":110.00000000000001,"height":25.0,"uid":null,"order":86,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":127}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":127,"width":110.00000000000001,"height":25.0,"uid":null,"order":90,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":128,"width":110.00000000000001,"height":55.0,"uid":null,"order":93,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":125},{"magnitude":-1,"id":127}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":127,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":122,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":95,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":123,"width":71.42857142857143,"height":50.0,"uid":null,"order":98,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":122}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":122}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":124,"width":38.0,"height":18.0,"uid":null,"order":101,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":122,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":119,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":103,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":120,"width":71.42857142857143,"height":50.0,"uid":null,"order":106,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":119}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":119}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":121,"width":26.0,"height":18.0,"uid":null,"order":109,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":119,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

2.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":557.25,"rotation":0.0,"id":281,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":179,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":282,"width":71.42857142857143,"height":50.0,"uid":null,"order":181,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":281}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":281}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":283,"width":48.0,"height":18.0,"uid":null,"order":183,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":281,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

release

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":518.25,"rotation":0.0,"id":277,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":184,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":278,"width":110.00000000000001,"height":25.0,"uid":null,"order":186,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":279}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":279,"width":110.00000000000001,"height":25.0,"uid":null,"order":189,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":280,"width":110.00000000000001,"height":55.0,"uid":null,"order":191,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":277},{"magnitude":-1,"id":279}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":279,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":507.25,"rotation":0.0,"id":274,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":192,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":275,"width":71.42857142857143,"height":50.0,"uid":null,"order":194,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":274}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":274}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":276,"width":26.0,"height":18.0,"uid":null,"order":196,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":274,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

7.5

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":320.25000000000006,"rotation":0.0,"id":306,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":209,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":271.25000000000006,"rotation":0.0,"id":307,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":210,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":401.25000000000006,"rotation":0.0,"id":308,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":211,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":37.214285714285666,"y":406.25000000000006,"rotation":0.0,"id":309,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":212,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":40.214285714285666,"y":456.25000000000006,"rotation":0.0,"id":310,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":213,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":594.3333333333335,"y":493.25000000000006,"rotation":0.0,"id":314,"width":283.66666666666663,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":215,"lockAspectRatio":false,"lockShape":false,"children":[{"x":66.66666666666663,"y":4.0,"rotation":0.0,"id":312,"width":217.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":214,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Signed tag.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":0.0,"rotation":0.0,"id":304,"width":33.333333333333336,"height":20.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":208,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"}],"layers":[{"guid":"dockVlz9GmcW","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":216}],"shapeStyles":{},"lineStyles":{"global":{"strokeWidth":1,"endArrow":17}},"textStyles":{"global":{"size":"16px","color":"#000000"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.cisco.cisco_v1.buildings","com.gliffy.libraries.sitemap.sitemap_v2","com.gliffy.libraries.sitemap.sitemap_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.table.table_v2.default","com.gliffy.libraries.ui.ui_v3.navigation","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.ui.ui_v3.icon_symbols","com.gliffy.libraries.ui.ui_v2.forms_components","com.gliffy.libraries.ui.ui_v2.content","com.gliffy.libraries.ui.ui_v2.miscellaneous","com.gliffy.libraries.network.network_v4.business","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.bpmn.bpmn_v1.events","com.gliffy.libraries.bpmn.bpmn_v1.activities","com.gliffy.libraries.bpmn.bpmn_v1.data_artifacts","com.gliffy.libraries.bpmn.bpmn_v1.gateways","com.gliffy.libraries.bpmn.bpmn_v1.connectors","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.images"],"lastSerialized":1439068922785},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/security/trust/images/trust_signing.png b/docs/security/trust/images/trust_signing.png new file mode 100644 index 0000000000000000000000000000000000000000..4a941be19d7af808c74be2f67e75fb13de6de411 GIT binary patch literal 71621 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 literal 0 HcmV?d00001 diff --git a/docs/security/trust/images/trust_view.gliffy b/docs/security/trust/images/trust_view.gliffy new file mode 100644 index 0000000000..b635e65764 --- /dev/null +++ b/docs/security/trust/images/trust_view.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":866,"height":537,"nodeIndex":323,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":true,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":null,"printShrinkToFit":false,"printPortrait":false,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":10,"y":0},"max":{"x":865.6666666666666,"y":536.25}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":10.0,"y":122.25000000000006,"rotation":0.0,"id":79,"width":531.0,"height":409.99999999999994,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#ffffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":312.25000000000006,"rotation":0.0,"id":40,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":1,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":41,"width":71.42857142857143,"height":50.0,"uid":null,"order":3,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":40}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":40}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":42,"width":26.0,"height":18.0,"uid":null,"order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":40,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

1.0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":82.1785714285715,"y":17.03600000000003,"rotation":0.0,"id":0,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.female_user","order":6,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.female_user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":1,"width":43.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Person

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.0,"y":142.25000000000006,"rotation":0.0,"id":2,"width":120.0,"height":80.0,"uid":"com.gliffy.shape.network.network_v4.business.user_group","order":9,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user_group","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":3,"width":73.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Organization

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":141.0,"y":152.25000000000006,"rotation":0.0,"id":11,"width":63.0,"height":82.0,"uid":"com.gliffy.shape.network.network_v4.business.user","order":12,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.network.network_v4.business.user","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#3966A0","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":12,"width":48.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Account

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":273.25000000000006,"rotation":0.0,"id":16,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":15,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":17,"width":110.00000000000001,"height":25.0,"uid":null,"order":17,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":18}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":18,"width":110.00000000000001,"height":25.0,"uid":null,"order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":19,"width":110.00000000000001,"height":55.0,"uid":null,"order":22,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":16},{"magnitude":-1,"id":18}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":18,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":262.25000000000006,"rotation":0.0,"id":37,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":35,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":38,"width":71.42857142857143,"height":50.0,"uid":null,"order":37,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":37}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":37}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":39,"width":38.0,"height":18.0,"uid":null,"order":39,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":37,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":442.25000000000006,"rotation":0.0,"id":63,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":40,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":64,"width":71.42857142857143,"height":50.0,"uid":null,"order":42,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":63}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":63}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":65,"width":68.0,"height":18.0,"uid":null,"order":44,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":63,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

producttion

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":305.99999999999994,"y":403.25000000000006,"rotation":0.0,"id":58,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":45,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":59,"width":110.00000000000001,"height":25.0,"uid":null,"order":47,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":60}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":60,"width":110.00000000000001,"height":25.0,"uid":null,"order":50,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":61,"width":110.00000000000001,"height":55.0,"uid":null,"order":52,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":58},{"magnitude":-1,"id":60}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":60,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":416.0,"y":392.25000000000006,"rotation":0.0,"id":55,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_left","order":53,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":56,"width":71.42857142857143,"height":50.0,"uid":null,"order":55,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":55}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":55}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_left","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":10.714285714285722,"y":0.0,"rotation":0.0,"id":57,"width":28.0,"height":18.0,"uid":null,"order":57,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":55,"px":0.15,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

test

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":10.000000000000036,"y":132.25000000000006,"rotation":0.0,"id":82,"width":108.99999999999999,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":58,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Registry

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":36.142857142857125,"y":399.25000000000006,"rotation":0.0,"id":109,"width":187.85714285714286,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":81,"lockAspectRatio":false,"lockShape":false,"children":[{"x":7.142857142857139,"y":50.0,"rotation":0.0,"id":98,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":74,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":99,"width":71.42857142857143,"height":50.0,"uid":null,"order":77,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":98}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":98}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":100,"width":50.0,"height":18.0,"uid":null,"order":80,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":98,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

working

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":7.571428571428527,"y":0.0,"rotation":0.0,"id":95,"width":71.42857142857142,"height":50.0,"uid":"com.gliffy.shape.ui.ui_v3.icon_symbols.annotate_right","order":66,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"MinHeightConstraint","MinHeightConstraint":{"height":28}},{"type":"MinWidthConstraint","MinWidthConstraint":{"width":40}}]},"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":96,"width":71.42857142857143,"height":50.0,"uid":null,"order":69,"lockAspectRatio":true,"lockShape":false,"constraints":{"constraints":[{"type":"WidthConstraint","WidthConstraint":{"isMin":false,"widthInfo":[{"magnitude":1,"id":95}],"minWidth":0.0,"growParent":false,"padding":0.0}},{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":95}],"minHeight":0.0,"growParent":false,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ui.ui_v3.icon_symbols.annotate_right","strokeWidth":1.0,"strokeColor":"#EA6624","fillColor":"#cfe2f3","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"hidden":false,"layerId":null},{"x":-7.142857142857139,"y":0.0,"rotation":0.0,"id":97,"width":38.0,"height":18.0,"uid":null,"order":72,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"PositionConstraint","PositionConstraint":{"nodeId":95,"px":-0.1,"py":0.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

latest

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":77.85714285714286,"y":8.0,"rotation":0.0,"id":30,"width":110.00000000000001,"height":80.0,"uid":"com.gliffy.shape.sitemap.sitemap_v2.photo","order":24,"lockAspectRatio":false,"lockShape":false,"linkMap":[],"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":31,"width":110.00000000000001,"height":25.0,"uid":null,"order":27,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":32}],"minHeight":0.0,"growParent":true,"padding":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.rounded_top","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"children":[{"x":0.0,"y":0.0,"rotation":0.0,"id":32,"width":110.00000000000001,"height":25.0,"uid":null,"order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":6,"paddingRight":2,"paddingBottom":6,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Repository

","tid":null,"valign":"top","vposition":"none","hposition":"none"}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":25.0,"rotation":0.0,"id":33,"width":110.00000000000001,"height":55.0,"uid":null,"order":34,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[{"type":"HeightConstraint","HeightConstraint":{"isMin":false,"heightInfo":[{"magnitude":1,"id":30},{"magnitude":-1,"id":32}],"minHeight":0.0,"growParent":false,"padding":0.0}},{"type":"PositionConstraint","PositionConstraint":{"nodeId":32,"px":0.0,"py":1.0,"xOffset":0.0,"yOffset":0.0}}]},"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.sitemap.sitemap_v2.photo","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":330.0,"y":0.0,"rotation":0.0,"id":180,"width":67.309,"height":101.072,"uid":"com.gliffy.shape.cisco.cisco_v1.buildings.generic_building","order":126,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.buildings.generic_building","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#0b5394","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":182,"width":56.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Company

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"dockVlz9GmcW"}],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":266.0,"y":125.25000000000006,"rotation":0.0,"id":250,"width":7.0,"height":413.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":172,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":79,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[3.5,-3.0],[9.5,406.99999999999994]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":320.25000000000006,"rotation":0.0,"id":306,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":209,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":271.25000000000006,"rotation":0.0,"id":307,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":210,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":472.40133544303796,"y":401.25000000000006,"rotation":0.0,"id":308,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":211,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":37.214285714285666,"y":406.25000000000006,"rotation":0.0,"id":309,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":212,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":40.214285714285666,"y":456.25000000000006,"rotation":0.0,"id":310,"width":20.0,"height":12.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":213,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"dockVlz9GmcW"},{"x":580.0,"y":418.25000000000006,"rotation":0.0,"id":314,"width":283.66666666666663,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":215,"lockAspectRatio":false,"lockShape":false,"children":[{"x":66.66666666666663,"y":4.0,"rotation":0.0,"id":312,"width":217.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":214,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Signed tag.

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":0.0,"rotation":0.0,"id":304,"width":33.333333333333336,"height":20.0,"uid":"com.gliffy.shape.bpmn.bpmn_v1.activities.ad_hoc","order":208,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ad_hoc.bpmn_v1","strokeWidth":0.0,"strokeColor":"#38761d","fillColor":"#FFFFFF","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"dockVlz9GmcW"}],"layers":[{"guid":"dockVlz9GmcW","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":216}],"shapeStyles":{},"lineStyles":{"global":{"strokeWidth":1,"endArrow":17}},"textStyles":{"global":{"size":"16px","color":"#000000"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.cisco.cisco_v1.buildings","com.gliffy.libraries.sitemap.sitemap_v2","com.gliffy.libraries.sitemap.sitemap_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.table.table_v2.default","com.gliffy.libraries.ui.ui_v3.navigation","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.ui.ui_v3.icon_symbols","com.gliffy.libraries.ui.ui_v2.forms_components","com.gliffy.libraries.ui.ui_v2.content","com.gliffy.libraries.ui.ui_v2.miscellaneous","com.gliffy.libraries.network.network_v4.business","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.bpmn.bpmn_v1.events","com.gliffy.libraries.bpmn.bpmn_v1.activities","com.gliffy.libraries.bpmn.bpmn_v1.data_artifacts","com.gliffy.libraries.bpmn.bpmn_v1.gateways","com.gliffy.libraries.bpmn.bpmn_v1.connectors","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.images"],"lastSerialized":1439069097667},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/security/trust/images/trust_view.png b/docs/security/trust/images/trust_view.png new file mode 100644 index 0000000000000000000000000000000000000000..71eb26ce3163d519403bd6f6e72b3347c48c347f GIT binary patch literal 59533 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 NYXR5Ot->`V^ ++++ +title = "Use trusted images" +description = "Use trusted images" +keywords = ["trust, security, docker, index"] +[menu.main] +identifier="smn_content_trust" +parent= "mn_docker_hub" +weight=4 ++++ + + +# Use trusted images + +The following topics are available: + +* [Content trust in Docker](content_trust.md) +* [Manage keys for content trust](trust_key_mng.md) +* [Automation with content trust](trust_automation.md) +* [Play in a content trust sandbox](trust_sandbox.md) + diff --git a/docs/security/trust/trust_automation.md b/docs/security/trust/trust_automation.md new file mode 100644 index 0000000000..b100d133dc --- /dev/null +++ b/docs/security/trust/trust_automation.md @@ -0,0 +1,79 @@ + + +# Automation with content trust + +Your automation systems that pull or build images can also work with trust. Any automation environment must set `DOCKER_TRUST_ENABLED` either manually or in in a scripted fashion before processing images. + +## Bypass requests for passphrases + +To allow tools to wrap docker and push trusted content, there are two +environment variables that allow you to provide the passphrases without an +expect script, or typing them in: + + - `DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE` + - `DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE` + +Docker attempts to use the contents of these environment variables as passphrase +for the keys. For example, an image publisher can export the repository `target` +and `snapshot` passphrases: + +```bash +$ export DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE="u7pEQcGoebUHm6LHe6" +$ export DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE="l7pEQcTKJjUHm6Lpe4" +``` + +Then, when pushing a new tag the Docker client does not request these values but signs automatically: + +```bash +$ docker push docker/trusttest:latest +The push refers to a repository [docker.io/docker/trusttest] (len: 1) +a9539b34a6ab: Image already exists +b3dbab3810fc: Image already exists +latest: digest: sha256:d149ab53f871 size: 3355 +Signing and pushing trust metadata +``` + +## Building with content trust + +You can also build with content trust. Before running the `docker build` command, you should set the environment variable `DOCKER_CONTENT_TRUST` either manually or in in a scripted fashion. Consider the simple Dockerfile below. + +```Dockerfile +FROM docker/trusttest:latest +RUN echo +``` + +The `FROM` tag is pulling a signed image. You cannot build an image that has a +`FROM` that is not either present locally or signed. Given that content trust +data exists for the tag `latest`, the following build should succeed: + +```bash +$ docker build -t docker/trusttest:testing . +Using default tag: latest +latest: Pulling from docker/trusttest + +b3dbab3810fc: Pull complete +a9539b34a6ab: Pull complete +Digest: sha256:d149ab53f871 +``` + +If content trust is enabled, building from a Dockerfile that relies on tag without trust data, causes the build command to fail: + +```bash +$ docker build -t docker/trusttest:testing . +unable to process Dockerfile: No trust data for notrust +``` + +## Related information + +* [Content trust in Docker](content_trust.md) +* [Manage keys for content trust](trust_key_mng.md) +* [Play in a content trust sandbox](trust_sandbox.md) + diff --git a/docs/security/trust/trust_key_mng.md b/docs/security/trust/trust_key_mng.md new file mode 100644 index 0000000000..20676acf15 --- /dev/null +++ b/docs/security/trust/trust_key_mng.md @@ -0,0 +1,73 @@ + + +# Manage keys for content trust + +Trust for an image tag is managed through the use of keys. Docker's content +trust makes use four different keys: + +| Key | Description | +|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| root key | Root of content trust for a image tag. When content trust is enabled, you create the root key once. | +| target and snapshot | These two keys are known together as the "repository" key. When content trust is enabled, you create this key when you add a new image repository. If you have the root key, you can export the repository key and allow other publishers to sign the image tags. | +| timestamp | This key applies to a repository. It allows Docker repositories to have freshness security guarantees without requiring periodic content refreshes on the client's side. | + +With the exception of the timestamp, all the keys are generated and stored locally +client-side. The timestamp is safely generated and stored in a signing server that +is deployed alongside the Docker registry. All keys are generated in a backend +service that isn't directly exposed to the internet and are encrypted at rest. + +## Choosing a passphrase + +The passphrases you chose for both the root key and your repository key should +be randomly generated and stored in a password manager. Having the repository key +allow users to sign image tags on a repository. Passphrases are used to encrypt +your keys at rest and ensures that a lost laptop or an unintended backup doesn't +put the private key material at risk. + +## Back up your keys + +All the Docker trust keys are stored encrypted using the passphrase you provide +on creation. Even so, you should still take care of the location where you back them up. +Good practice is to create two encrypted USB keys. + +It is very important that you backup your keys to a safe, secure location. Loss +of the repository key is recoverable; loss of the root key is not. + +The Docker client stores the keys in the `~/.docker/trust/private` directory. +Before backing them up, you should `tar` them into an archive: + +```bash +$ umask 077; tar -zcvf private_keys_backup.tar.gz ~/.docker/trust/private; umask 022 +``` + +## Lost keys + +If a publisher loses keys it means losing the ability to sign trusted content for +your repositories. If you lose a key, contact [Docker +Support](https://support.docker.com) (support@docker.com) to reset the repository +state. + +This loss also requires **manual intervention** from every consumer that pulled +the tagged image prior to the loss. Image consumers would get an error for +content that they already downloaded: + +``` +could not validate the path to a trusted root: failed to validate data with current trusted certificates +``` + +To correct this, they need to download a new image tag with that is signed with +the new key. + +## Related information + +* [Content trust in Docker](content_trust.md) +* [Automation with content trust](trust_automation.md) +* [Play in a content trust sandbox](trust_sandbox.md) diff --git a/docs/security/trust/trust_sandbox.md b/docs/security/trust/trust_sandbox.md new file mode 100644 index 0000000000..9d6c2f2120 --- /dev/null +++ b/docs/security/trust/trust_sandbox.md @@ -0,0 +1,331 @@ + + +# Play in a content trust sandbox + +This page explains how to set up and use a sandbox for experimenting with trust. +The sandbox allows you to configure and try trust operations locally without +impacting your production images. + +Before working through this sandbox, you should have read through the [trust +overview](content_trust.md). + +### Prerequisites + +These instructions assume you are running in Linux or Mac OS X. You can run +this sandbox on a local machine or on a virtual machine. You will need to +have `sudo` privileges on your local machine or in the VM. + +This sandbox requires you to install two Docker tools: Docker Engine and Docker +Compose. To install the Docker Engine, choose from the [list of supported +platforms](../../installation). To install Docker Compose, see the +[detailed instructions here](https://docs.docker.com/compose/install/). + +Finally, you'll need to have `git` installed on your local system or VM. + +## What is in the sandbox? + +If you are just using trust out-of-the-box you only need your Docker Engine +client and access to the Docker hub. The sandbox mimics a +production trust environment, and requires these additional components: + +| Container | Description | +|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------| +| notarysandbox | A container with the latest version of Docker Engine and with some preconfigured certifications. This is your sandbox where you can use the `docker` client to test trust operations. | +| Registry server | A local registry service. | +| Notary server | The service that does all the heavy-lifting of managing trust | +| Notary signer | A service that ensures that your keys are secure. | +| MySQL | The database where all of the trust information will be stored | + +The sandbox uses the Docker daemon on your local system. Within the `notarysandbox` +you interact with a local registry rather than the Docker Hub. This means +your everyday image repositories are not used. They are protected while you play. + +When you play in the sandbox, you'll also create root and repository keys. The +sandbox is configured to store all the keys and files inside the `notarysandbox` +container. Since the keys you create in the sandbox are for play only, +destroying the container destroys them as well. + + +## Build the sandbox + +In this section, you build the Docker components for your trust sandbox. If you +work exclusively with the Docker Hub, you would not need with these components. +They are built into the Docker Hub for you. For the sandbox, however, you must +build your own entire, mock production environment and registry. + +### Configure /etc/hosts + +The sandbox' `notaryserver` and `sandboxregistry` run on your local server. The +client inside the `notarysandbox` container connects to them over your network. +So, you'll need an entry for both the servers in your local `/etc/hosts` file. + +1. Add an entry for the `notaryserver` to `/etc/hosts`. + + $ sudo sh -c 'echo "127.0.0.1 notaryserver" >> /etc/hosts' + +2. Add an entry for the `sandboxregistry` to `/etc/hosts`. + + $ sudo sh -c 'echo "127.0.0.1 sandboxregistry" >> /etc/hosts' + + +### Build the notarytest image + +1. Create a `notarytest` directory on your system. + + $ mkdir notarysandbox + +2. Change into your `notarysandbox` directory. + + $ cd notarysandbox + +3. Create a `notarytest` directory then change into that. + + $ mkdir notarytest + $ cd notarytest + +4. Create a filed called `Dockerfile` with your favorite editor. + +5. Add the following to the new file. + + FROM debian:jessie + + ADD https://master.dockerproject.org/linux/amd64/docker /usr/bin/docker + RUN chmod +x /usr/bin/docker \ + && apt-get update \ + && apt-get install -y \ + tree \ + vim \ + git \ + ca-certificates \ + --no-install-recommends + + WORKDIR /root + RUN git clone -b trust-sandbox https://github.com/docker/notary.git + RUN cp /root/notary/fixtures/root-ca.crt /usr/local/share/ca-certificates/root-ca.crt + RUN update-ca-certificates + + ENTRYPOINT ["bash"] + +6. Save and close the file. + +7. Build the testing container. + + $ docker build -t notarysandbox . + Sending build context to Docker daemon 2.048 kB + Step 1 : FROM debian:jessie + ... + Successfully built 5683f17e9d72 + + +### Build and start up the trust servers + +In this step, you get the source code for your notary and registry services. +Then, you'll use Docker Compose to build and start them on your local system. + +1. Change to back to the root of your `notarysandbox` directory. + + $ cd notarysandbox + +2. Clone the `notary` project. + + $ git clone -b trust-sandbox https://github.com/docker/notary.git + +3. Clone the `distribution` project. + + $ git clone https://github.com/docker/distribution.git + +4. Change to the `notary` project directory. + + $ cd notary + + The directory contains a `docker-compose` file that you'll use to run a + notary server together with a notary signer and the corresponding MySQL + databases. The databases store the trust information for an image. + +5. Build the server images. + + $ docker-compose build + + The first time you run this, the build takes some time. + +6. Run the server containers on your local system. + + $ docker-compose up -d + + Once the trust services are up, you'll setup a local version of the Docker + Registry v2. + +7. Change to the `notarysandbox/distribution` directory. + +8. Build the `sandboxregistry` server. + + $ docker build -t sandboxregistry . + +9. Start the `sandboxregistry` server running. + + $ docker run -p 5000:5000 --name sandboxregistry sandboxregistry & + +## Playing in the sandbox + +Now that everything is setup, you can go into your `notarysandbox` container and +start testing Docker content trust. + + +### Start the notarysandbox container + +In this procedure, you start the `notarysandbox` and link it to the running +`notary_notaryserver_1` and `sandboxregistry` containers. The links allow +communication among the containers. + +``` +$ docker run -it -v /var/run/docker.sock:/var/run/docker.sock --link notary_notaryserver_1:notaryserver --link sandboxregistry:sandboxregistry notarysandbox +root@0710762bb59a:/# +``` + +Mounting the `docker.sock` gives the `notarysandbox` access to the `docker` +daemon on your host, while storing all the keys and files inside the sandbox +container. When you destroy the container, you destroy the "play" keys. + +### Test some trust operations + +Now, you'll pull some images. + +1. Download a `docker` image to test with. + + # docker pull docker/trusttest + docker pull docker/trusttest + Using default tag: latest + latest: Pulling from docker/trusttest + + b3dbab3810fc: Pull complete + a9539b34a6ab: Pull complete + Digest: sha256:d149ab53f8718e987c3a3024bb8aa0e2caadf6c0328f1d9d850b2a2a67f2819a + Status: Downloaded newer image for docker/trusttest:latest + +2. Tag it to be pushed to our sandbox registry: + + # docker tag docker/trusttest sandboxregistry:5000/test/trusttest:latest + +3. Enable content trust. + + # export DOCKER_CONTENT_TRUST=1 + +4. Identify the trust server. + + # export DOCKER_CONTENT_TRUST_SERVER=https://notaryserver:4443 + + This step is only necessary because the sandbox is using its own server. + Normally, if you are using the Docker Public Hub this step isn't necessary. + +5. Pull the test image. + + # docker pull sandboxregistry:5000/test/trusttest + Using default tag: latest + no trust data available + + You see an error, because this content doesn't exist on the `sandboxregistry` yet. + +6. Push the trusted image. + + # docker push sandboxregistry:5000/test/trusttest:latest + The push refers to a repository [sandboxregistry:5000/test/trusttest] (len: 1) + a9539b34a6ab: Image successfully pushed + b3dbab3810fc: Image successfully pushed + latest: digest: sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c size: 3348 + Signing and pushing trust metadata + You are about to create a new root signing key passphrase. This passphrase + will be used to protect the most sensitive key in your signing system. Please + choose a long, complex passphrase and be careful to keep the password and the + key file itself secure and backed up. It is highly recommended that you use a + password manager to generate the passphrase and keep it safe. There will be no + way to recover this key. You can find the key in your config directory. + Enter passphrase for new root key with id 8c69e04: + Repeat passphrase for new root key with id 8c69e04: + Enter passphrase for new repository key with id sandboxregistry:5000/test/trusttest (93c362a): + Repeat passphrase for new repository key with id sandboxregistry:5000/test/trusttest (93c362a): + Finished initializing "sandboxregistry:5000/test/trusttest" + latest: digest: sha256:d149ab53f8718e987c3a3024bb8aa0e2caadf6c0328f1d9d850b2a2a67f2819a size: 3355 + Signing and pushing trust metadata + +7. Try pulling the image you just pushed: + + # docker pull sandboxregistry:5000/test/trusttest + Using default tag: latest + Pull (1 of 1): sandboxregistry:5000/test/trusttest:latest@sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c + sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c: Pulling from test/trusttest + b3dbab3810fc: Already exists + a9539b34a6ab: Already exists + Digest: sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c + Status: Downloaded newer image for sandboxregistry:5000/test/trusttest@sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c + Tagging sandboxregistry:5000/test/trusttest@sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c as sandboxregistry:5000/test/trusttest:latest + + +### Test with malicious images + +What happens when data is corrupted and you try to pull it when trust is +enabled? In this section, you go into the `sandboxregistry` and tamper with some +data. Then, you try and pull it. + +1. Leave the sandbox container running. + +2. Open a new bash terminal from your host into the `sandboxregistry`. + + $ docker exec -it sandboxregistry bash + 296db6068327# + +3. Change into the registry storage. + + You'll need to provide the `sha` you received when you pushed the image. + + # cd /var/lib/registry/docker/registry/v2/blobs/sha256/aa/aac0c133338db2b18ff054943cee3267fe50c75cdee969aed88b1992539ed042 + +4. Add malicious data to one of the trusttest layers: + + # echo "Malicious data" > data + +5. Got back to your sandbox terminal. + +6. List the trusttest image. + + # docker images | grep trusttest + docker/trusttest latest a9539b34a6ab 7 weeks ago 5.025 MB + sandboxregistry:5000/test/trusttest latest a9539b34a6ab 7 weeks ago 5.025 MB + sandboxregistry:5000/test/trusttest a9539b34a6ab 7 weeks ago 5.025 MB + +7. Remove the `trusttest:latest` image. + + # docker rmi -f a9539b34a6ab + Untagged: docker/trusttest:latest + Untagged: sandboxregistry:5000/test/trusttest:latest + Untagged: sandboxregistry:5000/test/trusttest@sha256:1d871dcb16805f0604f10d31260e79c22070b35abc71a3d1e7ee54f1042c8c7c + Deleted: a9539b34a6aba01d3942605dfe09ab821cd66abf3cf07755b0681f25ad81f675 + Deleted: b3dbab3810fc299c21f0894d39a7952b363f14520c2f3d13443c669b63b6aa20 + +8. Pull the image again. + + # docker pull sandboxregistry:5000/test/trusttest + Using default tag: latest + ... + b3dbab3810fc: Verifying Checksum + a9539b34a6ab: Pulling fs layer + filesystem layer verification failed for digest sha256:aac0c133338db2b18ff054943cee3267fe50c75cdee969aed88b1992539ed042 + + You'll see the the pull did not complete because the trust system was + unable to verify the image. + +## More play in the sandbox + +Now, that you have a full Docker content trust sandbox on your local system, +feel free to play with it and see how it behaves. If you find any security +issues with Docker, feel free to send us an email at . + + +  diff --git a/docs/sources/installation/images/windows-boot2docker-cmd.png b/docs/sources/installation/images/windows-boot2docker-cmd.png new file mode 100644 index 0000000000000000000000000000000000000000..09e3206ef97ecef230a24e13e9b25e106f7b576e GIT binary patch literal 37436 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 literal 0 HcmV?d00001 diff --git a/docs/sources/installation/images/windows-boot2docker-powershell.png b/docs/sources/installation/images/windows-boot2docker-powershell.png new file mode 100644 index 0000000000000000000000000000000000000000..b1ef89672619b3dd7f4c1ee7d269f221bec3395d GIT binary patch literal 37945 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 literal 0 HcmV?d00001 diff --git a/docs/static_files/docker-logo-compressed.png b/docs/static_files/docker-logo-compressed.png new file mode 100644 index 0000000000000000000000000000000000000000..717d09d773cc46ff8297d06f66d9aa855453f35a GIT binary patch literal 4972 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 IT4fCOKM4~1IsgCw literal 0 HcmV?d00001 diff --git a/docs/static_files/docker_pull_chart.png b/docs/static_files/docker_pull_chart.png new file mode 100644 index 0000000000000000000000000000000000000000..57d3f68dbd07967b70a19f8d486bca2e04cfc5b6 GIT binary patch literal 7188 zcmdUUXEfZ=w>Ac&kI{P>qDG0{jZU=DqC}J+h(sAgFEdDVqeY2MwCE&4LX==cmqZAn zO`=4vQFDLtfA3xE{c^wGv(}v7-e*61pS|}w`}s0)2qPUzG8QsCJUmK0T}@LwJp3Zy zXGQ`7PIR{g=J43x7dPZho|KFFC0^Hcr?td_p5Ncf`%m1i)rZ$9x zgn$gCr6VIJ*D*AwXJ7=>Tha>RG76Mb5HTq^K-Drd2X<0YQZ^1QFbOFmGYgt9cRm><9I z0lS5rD;+&!dE2nEhMrf*Q+{Ewxa`XAsZF3Q9h0j-Er8eCk(IjcuZ4}hKn|ht*{?tS z&_h_6-gQdMuetyD36LZWEj=}qrsVZNW8VxD3wu?^cu-8nv*%^(Ts*SM8aD)lrQ}sv z*|~s<^v!J_1w{FyQ|#T4+J@#5vWj4fVT8d=)I_ypYiBCPIvsOy<XWQcryqQf^I-bMW%i0L;dk@SO*XI3;;RAAvMhDRUfkt%m3r4}T(41~ z)H)kAuiakd+Cc-VVt#n%+DrUi-4~wWK5e;PR~e{qfG@^%)%pHG)ydx3;r5@%%dPW^KbseGmosNasS{_x{udYLTSw=O8yyEnYrEU0rzd;e z^GGaeu<2FXUSkW{HXa_6jh?2Oc_9Ag_jNB;cl?1pe!YZrKErmyd8ZdGCN}Y=-|ywl zn=(wyKd~kxc^(oI*vlG-FGej(&`nMaCh*}T!Czkdx+BYxqO7u+xW$(2%jvV-;-1Ur zo=bN{reySf_G@)Q1?||1)IloDx(W6(tDZxdR#+XDHS`nNW-IzXAOFhg+OI2#Q{P<+ z(wfGqg7`MFLsEF~fW1QCX=|y^~h3Q`p)KdJFO-if@D~@mOsnZxSfIolt-uZM@dAF>A zW^LSF4q~k^5+>8pg;z!zkzmo2`^rn%U2xpEjn`*kU^whpX@CotvqI#k#|k0SM|F;g zo}NDnjDJcML_BRPRwFmRxEEO9TDn>z@F|=H)4t=^(eM+d!}a;wG_1x!ZEJh_gw(f? z{X9FyU;(G*IO7xiWT-Rc#rftg0%fq^=%EK1{E>D4_cm48I1e`_IxIv85%$$b7BK_y z2DPE);QOGyukXbC@|DWG zqUL$Asc!UFj^hAsEEV>GD5)TS>Q4lys@x&c+9BTQR`dYVM|evF-XMo3SYpbli;ouX zGV-=j07Wg5vWwD4^#|%o|FiUSBOha*31)VyLK2X!w(G=T-Nmadxa}m$SzUyXMQgMj zN^DyEXC)lnY4^=wzhlw}QzGERmJAx7sn3}teqJJ;6uVC56OB3O#`!wy^$IjkkA-(gV&DyXsU%5}rfQ ztz^epQr8gm$P)j-SDf^2^{J z&5kd~J*E|$ktB|prbsl{z{V|@5&JL575RfmMsJRIe#Eb|{);drg?XiZc3~8#>yu=? zT9-riqOVF9Trgqc3YNWgtY@=7|=; zgQ6IOb4!-BLkvEgGr4AaAAVp<&LiI=sAMiD>6}vwC~YX5$nBlUi2I^6dICAW?;|gHT_SNILDC~hSP}HA*!-lv1~~~ zRz(C>s}#=QPeI>KJ2=*+rbsu+hUasVW(wB2piN!D9y`J{gmuXi|wqHN+6NR)v=t# zCRQw($D*8vYIC-1EaO)>pt9srWrW+yA!*BZHF z2F(NO-$PQexWoU1=-BljGoWIEemV|TD5R_t8GnltHcUee$7!Ljv4mzrn%O4 zps=sYksD6*k4w(jjN_KycNt+19Sf-6L1OxjqMBdZ6p?^`Er_LVnAYY)vm1&Zz`(bX<*Zbf+rG9(=?x2XU zn60B8{8j9zI9s`KC-(SuBae|CEaC|$c{1t)fBhXYotCuAsAN7e{-=ZO4;wYAm7fiY zg>E0jn|1!#H^x4w_x_aWgbVnPYEg5ZvQJ{ldC7Y^N7@*bEOVLCAvx>LtK7S5>GF;t z>(-mbp@i;)nPO|VCvHWhsS1;9IBz-^69&P!4BfWKJe-v2HqS&zR;ssfW%a6y_}1C! z&}BzOixk-Yn^_8{lH`#1yWh`pv+s`YJNWI~^{qG&_`dJDFakL*yl}k}fY|$BwYP{c z*zs;%8*Bf{ecGC(av9lfEW4iEmpfmqOtU0hvU%HRHF(#$Csa&+MsPQbHx%`(9p|Uq z0P4`;mA8J4zxb_gJc*5tH*1zy5kZ=C;jl!77cNhupjv@Bk1T8iJx z=EVl#g`w{c#NE(&6%N7s%g_|6?&;J8G5?r@dl=ELT2Jy3Nzs<{p$YW5k+<#py7jYA zwh>9(L+-2nQt-q3l9;(#x{?MfjK`9u%xLK8{hbC8d0U?euGZwbSo0got*A7dcLK3I znZysh14x_x;F!>~%($LNlg8E{^f|4w0`Txd4+BwpoyK>(F&S z2b_4~9ozvY`W%?1RcdRYdRM2Vdo-yPDX?xZ6;(Fq3DLMBl(bRSS9^Syk|F_VS_A=g~ z^Pl7N_y0!5uvroc1F@5Z2_j?#aSw+CY>G+B0MPSEjEA;~TH;Nvc+47*#BBm(BN*?z zk!hO7g7DhCfR;!NHy4khY>;*WYE3F1nCotI?!5IMYiU3h3?@RydvN+T(1qV3{aue$ zlU+k%&u@jQ+&TPUKDuI&`i-)O$a@v@vc)8Qmj0$ObKr{n7#GHpC?9ob&sB52)Q_ZN z0zG4H#+sg?MU_TySKCrNCcMRlJMt)*w*o^Ryw)c1H(xIG%eHqH9rwK6JGtNbxHA8{ z+?E3!&J7xKaj^;bX3>5{9`=@6WoUjOAsh>PDxXa0z(@}A>rh%Op`0Ev@yX=G;Xs_L zHFqnlDQZkum-t`;7LVC31Hau=GUppqEyZ}~RqX~z=bVey`Sf026K2q}#3J*#Pmeom zemNmw>6f5cv^oFLk^zA=S^ejdTFemArwytqNU&9AY&t_<)N81Y*`3* z=E1BcY6W>m(~_4tCf%}YmVZcmRIND*r!m9&H=}LcIeV!sFV|JeMBb+xF>ZD-_ayX< z(;>Tq8vSpkyz9XceLxGmj$cjtNr!Z1kCy(S_mg$bQI@n#Sp&l}s~r?qoVSK<*p4b|Xac^s@cUVN)8 zxF}1*Q%>d;NjG2e5xg1h>2L>Ho^KA3BF7~P_2AJekH64J7FOSk4!f4N2}QQb?CWOe zf{1WWeV^IJ388JBjQyI`L~|8!cT9q=R8{I5I{<6C-48dwJZg33vBt zWm}4X_k71&GaTux2E5eFac>b|tmHXnwfU}jM!4r60SwS{FIGs(0s|3UHvvrFO8h?> z*gF}Xb_2Y8w6N7cn5i>nA@q|;d3aq`G0crWAB=0y5%@<`0AA}KuHkw{VRP}5<_UPb1e&yEA2>>4dr&rvJ-LwfnLZcea*W~46 zBKaT2djxm^6!+_2uIPVJxtm&mJKn;wcmA2Q0n_&V2U_B@z+CD#3!!I#;CJgr%1O!r zOC3z?2XS}y4IrJ?sP=#UGU83wNhUAGU8?~Jpi!T$wGYJIdeQI+}Fs;+C|G&%MT;nYX4}b^*%3YKH>D+&4#%cz@+d=_Cipf(fg|R8I zLBn5f0lsp~Iaq~YO)uE6oJ1vZ zhi#D;GhBg5*wMi2YAUmIj9*;w`4D&GKoHmO5jYpXq>p?}{c@EGmzRJN#8E{&TW?RZ zCAaK>96~#pa@0p_7ky6b1=O=R*GfAhDRONOh4FSxRhz}f#P#Nw59^_dmMQSCWN`u_Y>TVcFq zttGpQ{5lQ}nc{d$n#f~mVxt53Jeet6xcU7J+E1M9NqtBo@+B$l;}zGvPrd_#PnHDU zzK!XpZP&lUF|UR?*Y2kB%6-z8ac5h}AQjN!3=@S~JnoI%3rbQyNkVrBQ@S&#Z3^RW z&NfoQ5p*$2SzJPjvAOre)7-a%YH!1C$7sKlOyu_TEcx?+{_2<1s^R4HqgmJ@G4`4Ni z)+cOg$B$gxT!)C?l!MWxWAmbi!?XXy`(|f&sM?5V z(2t(T{>A5@_cWlJZ9&O;TEm0Up>I>s4{fYjyTI&@W|QiA|={f|N)DU=gbc%ZwwROeAfsL0py~>39P^p@>9;;F@|%?h`g_qKON_5`FVVSq*FC(VB#QILU@urYc@V za9G?k39k@hzqJBnfR_)h?;AtWubp7U*bR$kFZM9TZ$H z`#Ks@wT!uuhQp?Z+eA6kgnzZDliwA4({YE=W?66XtI5xgzlFYR&SNN({Q0;AR&Z2a zLjC74-fh7|MKu!PoN$fGfW~4fKPZDvA^zEdxr$M)F;}H@NG5vG8et$f$=Up^y#wR; zTLY9Mc);@n7!_N~Vy?!hr-XKxk4xnl#knI^2s zg$RYJXeSvqM4!2H5>zX0Xj(7dj9Ju>+G$rcnk2p#s6{HIe)XhZF^RjOGNz#m&B&tM z$(1dYWHntOL}&Di9?B7mPp^>GP!|GK7n|qVJm~m7^uTetCv%yB#Y^e~qh>Q-{N$rl zs^WKhD&)v?XG&L1m%~Bg&FBXa(2O(wSZayaTr3&l#|w)T%%2ji{wyBo1F>^U&fqRdjg7r^86oYQ_2tZ?j{g;a-t+L8Z$UPI^$DjrtH}w6j_UIz{f|eJtk1S)VRX;l}l}}N5H?dp3spZM6S~c@) ztSLZZrc0XE;1g9z`ba5!4o(t~`(Bo+4(Ozm0gBHSqyW_G8=&OKEqOgO)<2Cym#d3)&y9v7a zx;Ca8iPnVbQrS>L6txr~CDFWQh}pb$>uxwJK{~bivn%+Qv=(VPDL+oTsMUcGTa_^p zB|8hY5 z&$`Ue{mY5^IBUSyI;)y;zsoyCB$opLRnM(kI_TFo_LmvVm<#f5pSNXlc?^>hwXo{n oN!z;P&tc~N%j5dLEMPet^SNh-$ZevJUtu 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 literal 0 HcmV?d00001 diff --git a/docs/static_files/dockerlogo-v.png b/docs/static_files/dockerlogo-v.png new file mode 100644 index 0000000000000000000000000000000000000000..69ae6851721e2bcb603b73da49c0c53ffefa70aa GIT binary patch literal 9670 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 literal 0 HcmV?d00001 diff --git a/docs/touch-up.sh b/docs/touch-up.sh new file mode 100755 index 0000000000..1dd0b1dc52 --- /dev/null +++ b/docs/touch-up.sh @@ -0,0 +1,20 @@ +#!/bin/bash -e + + +# Sed to process GitHub Markdown +# 1-2 Remove comment code from metadata block +# +for i in ls -l /docs/content/* + do # Line breaks are important + if [ -d $i ] # Spaces are important + then + y=${i##*/} + find $i -type f -name "*.md" -exec sed -i.old \ + -e '/^/g' \ + -e '/^/g' {} \; + fi +done + + + + diff --git a/docs/userguide/basics.md b/docs/userguide/basics.md new file mode 100644 index 0000000000..42102b7423 --- /dev/null +++ b/docs/userguide/basics.md @@ -0,0 +1,199 @@ + + +# Quickstart containers + +This quickstart assumes you have a working installation of Docker. To verify Docker is installed, use the following command: + + # Check that you have a working install + $ docker info + +If you get `docker: command not found` or something like +`/var/lib/docker/repositories: permission denied` you may have an +incomplete Docker installation or insufficient privileges to access +Docker on your machine. With the default installation of Docker `docker` +commands need to be run by a user that is in the `docker` group or by the +`root` user. + +Depending on your Docker system configuration, you may be required +to preface each `docker` command with `sudo`. One way to avoid having to use +`sudo` with the `docker` commands is to create a Unix group called `docker` and +add users that will be entering `docker` commands to the 'docker' group. + +For more information about installing Docker or `sudo` configuration, refer to +the [installation](../installation) instructions for your operating system. + + +## Download a pre-built image + + # Download an ubuntu image + $ docker pull ubuntu + +This will find the `ubuntu` image by name on +[*Docker Hub*](../userguide/dockerrepos.md#searching-for-images) +and download it from [Docker Hub](https://hub.docker.com) to a local +image cache. + +> **Note**: +> When the image is successfully downloaded, you see a 12 character +> hash `539c0211cd76: Download complete` which is the +> short form of the image ID. These short image IDs are the first 12 +> characters of the full image ID - which can be found using +> `docker inspect` or `docker images --no-trunc=true`. + +## Running an interactive shell + +To run an interactive shell in the Ubuntu image: + + $ docker run -i -t ubuntu /bin/bash + +The `-i` flag starts an interactive container. The `-t` flag creates a +pseudo-TTY that attaches `stdin` and `stdout`. + +To detach the `tty` without exiting the shell, use the escape sequence +`Ctrl-p` + `Ctrl-q`. The container will continue to exist in a stopped state +once exited. To list all containers, stopped and running, use the `docker ps -a` +command. + +## Bind Docker to another host/port or a Unix socket + +> **Warning**: +> Changing the default `docker` daemon binding to a +> TCP port or Unix *docker* user group will increase your security risks +> by allowing non-root users to gain *root* access on the host. Make sure +> you control access to `docker`. If you are binding +> to a TCP port, anyone with access to that port has full Docker access; +> so it is not advisable on an open network. + +With `-H` it is possible to make the Docker daemon to listen on a +specific IP and port. By default, it will listen on +`unix:///var/run/docker.sock` to allow only local connections by the +*root* user. You *could* set it to `0.0.0.0:2375` or a specific host IP +to give access to everybody, but that is **not recommended** because +then it is trivial for someone to gain root access to the host where the +daemon is running. + +Similarly, the Docker client can use `-H` to connect to a custom port. +The Docker client will default to connecting to `unix:///var/run/docker.sock` +on Linux, and `tcp://127.0.0.1:2376` on Windows. + +`-H` accepts host and port assignment in the following format: + + tcp://[host]:[port][path] or unix://path + +For example: + +- `tcp://` -> TCP connection to `127.0.0.1` on either port `2376` when TLS encryption + is on, or port `2375` when communication is in plain text. +- `tcp://host:2375` -> TCP connection on + host:2375 +- `tcp://host:2375/path` -> TCP connection on + host:2375 and prepend path to all requests +- `unix://path/to/socket` -> Unix socket located + at `path/to/socket` + +`-H`, when empty, will default to the same value as +when no `-H` was passed in. + +`-H` also accepts short form for TCP bindings: + + `host:` or `host:port` or `:port` + +Run Docker in daemon mode: + + $ sudo /docker daemon -H 0.0.0.0:5555 & + +Download an `ubuntu` image: + + $ docker -H :5555 pull ubuntu + +You can use multiple `-H`, for example, if you want to listen on both +TCP and a Unix socket + + # Run docker in daemon mode + $ sudo /docker daemon -H tcp://127.0.0.1:2375 -H unix:///var/run/docker.sock & + # Download an ubuntu image, use default Unix socket + $ docker pull ubuntu + # OR use the TCP port + $ docker -H tcp://127.0.0.1:2375 pull ubuntu + +## Starting a long-running worker process + + # Start a very useful long-running process + $ JOB=$(docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") + + # Collect the output of the job so far + $ docker logs $JOB + + # Kill the job + $ docker kill $JOB + +## Listing containers + + $ docker ps # Lists only running containers + $ docker ps -a # Lists all containers + +## Controlling containers + + # Start a new container + $ JOB=$(docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") + + # Stop the container + $ docker stop $JOB + + # Start the container + $ docker start $JOB + + # Restart the container + $ docker restart $JOB + + # SIGKILL a container + $ docker kill $JOB + + # Remove a container + $ docker stop $JOB # Container must be stopped to remove it + $ docker rm $JOB + +## Bind a service on a TCP port + + # Bind port 4444 of this container, and tell netcat to listen on it + $ JOB=$(docker run -d -p 4444 ubuntu:12.10 /bin/nc -l 4444) + + # Which public port is NATed to my container? + $ PORT=$(docker port $JOB 4444 | awk -F: '{ print $2 }') + + # Connect to the public port + $ echo hello world | nc 127.0.0.1 $PORT + + # Verify that the network connection worked + $ echo "Daemon received: $(docker logs $JOB)" + +## Committing (saving) a container state + +Save your containers state to an image, so the state can be +re-used. + +When you commit your container, Docker only stores the diff (difference) between +the source image and the current state of the container's image. To list images +you already have, use the `docker images` command. + + # Commit your container to a new named image + $ docker commit + + # List your images + $ docker images + +You now have an image state from which you can create new instances. + +## Where to go next + +* Work your way through the [Docker User Guide](../userguide/index.md) +* Read more about [*Share Images via Repositories*](../userguide/dockerrepos.md) +* Review [*Command Line*](../reference/commandline/cli.md) diff --git a/docs/userguide/dockerimages.md b/docs/userguide/dockerimages.md new file mode 100644 index 0000000000..e76d44156b --- /dev/null +++ b/docs/userguide/dockerimages.md @@ -0,0 +1,553 @@ + + +# Build your own images + +Docker images are the basis of containers. Each time you've used `docker run` +you told it which image you wanted. In the previous sections of the guide you +used Docker images that already exist, for example the `ubuntu` image and the +`training/webapp` image. + +You also discovered that Docker stores downloaded images on the Docker host. If +an image isn't already present on the host then it'll be downloaded from a +registry: by default the [Docker Hub Registry](https://registry.hub.docker.com). + +In this section you're going to explore Docker images a bit more +including: + +* Managing and working with images locally on your Docker host. +* Creating basic images. +* Uploading images to [Docker Hub Registry](https://registry.hub.docker.com). + +## Listing images on the host + +Let's start with listing the images you have locally on our host. You can +do this using the `docker images` command like so: + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + ubuntu 14.04 1d073211c498 3 days ago 187.9 MB + busybox latest 2c5ac3f849df 5 days ago 1.113 MB + training/webapp latest 54bb4e8718e8 5 months ago 348.7 MB + +You can see the images you've previously used in the user guide. +Each has been downloaded from [Docker Hub](https://hub.docker.com) when you +launched a container using that image. When you list images, you get three crucial pieces of information in the listing. + +* What repository they came from, for example `ubuntu`. +* The tags for each image, for example `14.04`. +* The image ID of each image. + +> **Tip:** +> You can use [a third-party dockviz tool](https://github.com/justone/dockviz) +> or the [Image layers site](https://imagelayers.io/) to display +> visualizations of image data. + +A repository potentially holds multiple variants of an image. In the case of +our `ubuntu` image you can see multiple variants covering Ubuntu 10.04, 12.04, +12.10, 13.04, 13.10 and 14.04. Each variant is identified by a tag and you can +refer to a tagged image like so: + + ubuntu:14.04 + +So when you run a container you refer to a tagged image like so: + + $ docker run -t -i ubuntu:14.04 /bin/bash + +If instead you wanted to run an Ubuntu 12.04 image you'd use: + + $ docker run -t -i ubuntu:12.04 /bin/bash + +If you don't specify a variant, for example you just use `ubuntu`, then Docker +will default to using the `ubuntu:latest` image. + +> **Tip:** +> You recommend you always use a specific tagged image, for example +> `ubuntu:12.04`. That way you always know exactly what variant of an image is +> being used. + +## Getting a new image + +So how do you get new images? Well Docker will automatically download any image +you use that isn't already present on the Docker host. But this can potentially +add some time to the launch of a container. If you want to pre-load an image you +can download it using the `docker pull` command. Suppose you'd like to +download the `centos` image. + + $ docker pull centos + Pulling repository centos + b7de3133ff98: Pulling dependent layers + 5cc9e91966f7: Pulling fs layer + 511136ea3c5a: Download complete + ef52fb1fe610: Download complete + . . . + + Status: Downloaded newer image for centos + +You can see that each layer of the image has been pulled down and now you +can run a container from this image and you won't have to wait to +download the image. + + $ docker run -t -i centos /bin/bash + bash-4.1# + +## Finding images + +One of the features of Docker is that a lot of people have created Docker +images for a variety of purposes. Many of these have been uploaded to +[Docker Hub](https://hub.docker.com). You can search these images on the +[Docker Hub](https://hub.docker.com) website. + +![indexsearch](search.png) + +You can also search for images on the command line using the `docker search` +command. Suppose your team wants an image with Ruby and Sinatra installed on +which to do our web application development. You can search for a suitable image +by using the `docker search` command to find all the images that contain the +term `sinatra`. + + $ docker search sinatra + NAME DESCRIPTION STARS OFFICIAL AUTOMATED + training/sinatra Sinatra training image 0 [OK] + marceldegraaf/sinatra Sinatra test app 0 + mattwarren/docker-sinatra-demo 0 [OK] + luisbebop/docker-sinatra-hello-world 0 [OK] + bmorearty/handson-sinatra handson-ruby + Sinatra for Hands on with D... 0 + subwiz/sinatra 0 + bmorearty/sinatra 0 + . . . + +You can see the command returns a lot of images that use the term `sinatra`. +You've received a list of image names, descriptions, Stars (which measure the +social popularity of images - if a user likes an image then they can "star" it), +and the Official and Automated build statuses. [Official +Repositories](https://docs.docker.com/docker-hub/official_repos) are a carefully +curated set of Docker repositories supported by Docker, Inc. Automated +repositories are [Automated Builds](dockerrepos.md#automated-builds) that allow +you to validate the source and content of an image. + +You've reviewed the images available to use and you decided to use the +`training/sinatra` image. So far you've seen two types of images repositories, +images like `ubuntu`, which are called base or root images. These base images +are provided by Docker Inc and are built, validated and supported. These can be +identified by their single word names. + +You've also seen user images, for example the `training/sinatra` image you've +chosen. A user image belongs to a member of the Docker community and is built +and maintained by them. You can identify user images as they are always +prefixed with the user name, here `training`, of the user that created them. + +## Pulling our image + +You've identified a suitable image, `training/sinatra`, and now you can download it using the `docker pull` command. + + $ docker pull training/sinatra + +The team can now use this image by running their own containers. + + $ docker run -t -i training/sinatra /bin/bash + root@a8cb6ce02d85:/# + +## Creating our own images + +The team has found the `training/sinatra` image pretty useful but it's not quite +what they need and you need to make some changes to it. There are two ways you +can update and create images. + +1. You can update a container created from an image and commit the results to an image. +2. You can use a `Dockerfile` to specify instructions to create an image. + + +### Updating and committing an image + +To update an image you first need to create a container from the image +you'd like to update. + + $ docker run -t -i training/sinatra /bin/bash + root@0b2616b0e5a8:/# + +> **Note:** +> Take note of the container ID that has been created, `0b2616b0e5a8`, as you'll +> need it in a moment. + +Inside our running container let's add the `json` gem. + + root@0b2616b0e5a8:/# gem install json + +Once this has completed let's exit our container using the `exit` +command. + +Now you have a container with the change you want to make. You can then +commit a copy of this container to an image using the `docker commit` +command. + + $ docker commit -m "Added json gem" -a "Kate Smith" \ + 0b2616b0e5a8 ouruser/sinatra:v2 + 4f177bd27a9ff0f6dc2a830403925b5360bfe0b93d476f7fc3231110e7f71b1c + +Here you've used the `docker commit` command. You've specified two flags: `-m` +and `-a`. The `-m` flag allows us to specify a commit message, much like you +would with a commit on a version control system. The `-a` flag allows us to +specify an author for our update. + +You've also specified the container you want to create this new image from, +`0b2616b0e5a8` (the ID you recorded earlier) and you've specified a target for +the image: + + ouruser/sinatra:v2 + +Break this target down. It consists of a new user, `ouruser`, that you're +writing this image to. You've also specified the name of the image, here you're +keeping the original image name `sinatra`. Finally you're specifying a tag for +the image: `v2`. + +You can then look at our new `ouruser/sinatra` image using the `docker images` +command. + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + training/sinatra latest 5bc342fa0b91 10 hours ago 446.7 MB + ouruser/sinatra v2 3c59e02ddd1a 10 hours ago 446.7 MB + ouruser/sinatra latest 5db5f8471261 10 hours ago 446.7 MB + +To use our new image to create a container you can then: + + $ docker run -t -i ouruser/sinatra:v2 /bin/bash + root@78e82f680994:/# + +### Building an image from a `Dockerfile` + +Using the `docker commit` command is a pretty simple way of extending an image +but it's a bit cumbersome and it's not easy to share a development process for +images amongst a team. Instead you can use a new command, `docker build`, to +build new images from scratch. + +To do this you create a `Dockerfile` that contains a set of instructions that +tell Docker how to build our image. + +First, create a directory and a `Dockerfile`. + + $ mkdir sinatra + $ cd sinatra + $ touch Dockerfile + +If you are using Docker Machine on Windows, you may access your host +directory by `cd` to `/c/Users/your_user_name`. + +Each instruction creates a new layer of the image. Try a simple example now for +building your own Sinatra image for your fictitious development team. + + # This is a comment + FROM ubuntu:14.04 + MAINTAINER Kate Smith + RUN apt-get update && apt-get install -y ruby ruby-dev + RUN gem install sinatra + +Examine what your `Dockerfile` does. Each instruction prefixes a statement and +is capitalized. + + INSTRUCTION statement + +> **Note:** You use `#` to indicate a comment + +The first instruction `FROM` tells Docker what the source of our image is, in +this case you're basing our new image on an Ubuntu 14.04 image. The instruction uses the `MAINTAINER` instruction to specify who maintains the new image. + +Lastly, you've specified two `RUN` instructions. A `RUN` instruction executes +a command inside the image, for example installing a package. Here you're +updating our APT cache, installing Ruby and RubyGems and then installing the +Sinatra gem. + + + +Now let's take our `Dockerfile` and use the `docker build` command to build an image. + + $ docker build -t ouruser/sinatra:v2 . + Sending build context to Docker daemon 2.048 kB + Sending build context to Docker daemon + Step 1 : FROM ubuntu:14.04 + ---> e54ca5efa2e9 + Step 2 : MAINTAINER Kate Smith + ---> Using cache + ---> 851baf55332b + Step 3 : RUN apt-get update && apt-get install -y ruby ruby-dev + ---> Running in 3a2558904e9b + Selecting previously unselected package libasan0:amd64. + (Reading database ... 11518 files and directories currently installed.) + Preparing to unpack .../libasan0_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libasan0:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package libatomic1:amd64. + Preparing to unpack .../libatomic1_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libatomic1:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package libgmp10:amd64. + Preparing to unpack .../libgmp10_2%3a5.1.3+dfsg-1ubuntu1_amd64.deb ... + Unpacking libgmp10:amd64 (2:5.1.3+dfsg-1ubuntu1) ... + Selecting previously unselected package libisl10:amd64. + Preparing to unpack .../libisl10_0.12.2-1_amd64.deb ... + Unpacking libisl10:amd64 (0.12.2-1) ... + Selecting previously unselected package libcloog-isl4:amd64. + Preparing to unpack .../libcloog-isl4_0.18.2-1_amd64.deb ... + Unpacking libcloog-isl4:amd64 (0.18.2-1) ... + Selecting previously unselected package libgomp1:amd64. + Preparing to unpack .../libgomp1_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libgomp1:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package libitm1:amd64. + Preparing to unpack .../libitm1_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libitm1:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package libmpfr4:amd64. + Preparing to unpack .../libmpfr4_3.1.2-1_amd64.deb ... + Unpacking libmpfr4:amd64 (3.1.2-1) ... + Selecting previously unselected package libquadmath0:amd64. + Preparing to unpack .../libquadmath0_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libquadmath0:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package libtsan0:amd64. + Preparing to unpack .../libtsan0_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libtsan0:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package libyaml-0-2:amd64. + Preparing to unpack .../libyaml-0-2_0.1.4-3ubuntu3_amd64.deb ... + Unpacking libyaml-0-2:amd64 (0.1.4-3ubuntu3) ... + Selecting previously unselected package libmpc3:amd64. + Preparing to unpack .../libmpc3_1.0.1-1ubuntu1_amd64.deb ... + Unpacking libmpc3:amd64 (1.0.1-1ubuntu1) ... + Selecting previously unselected package openssl. + Preparing to unpack .../openssl_1.0.1f-1ubuntu2.4_amd64.deb ... + Unpacking openssl (1.0.1f-1ubuntu2.4) ... + Selecting previously unselected package ca-certificates. + Preparing to unpack .../ca-certificates_20130906ubuntu2_all.deb ... + Unpacking ca-certificates (20130906ubuntu2) ... + Selecting previously unselected package manpages. + Preparing to unpack .../manpages_3.54-1ubuntu1_all.deb ... + Unpacking manpages (3.54-1ubuntu1) ... + Selecting previously unselected package binutils. + Preparing to unpack .../binutils_2.24-5ubuntu3_amd64.deb ... + Unpacking binutils (2.24-5ubuntu3) ... + Selecting previously unselected package cpp-4.8. + Preparing to unpack .../cpp-4.8_4.8.2-19ubuntu1_amd64.deb ... + Unpacking cpp-4.8 (4.8.2-19ubuntu1) ... + Selecting previously unselected package cpp. + Preparing to unpack .../cpp_4%3a4.8.2-1ubuntu6_amd64.deb ... + Unpacking cpp (4:4.8.2-1ubuntu6) ... + Selecting previously unselected package libgcc-4.8-dev:amd64. + Preparing to unpack .../libgcc-4.8-dev_4.8.2-19ubuntu1_amd64.deb ... + Unpacking libgcc-4.8-dev:amd64 (4.8.2-19ubuntu1) ... + Selecting previously unselected package gcc-4.8. + Preparing to unpack .../gcc-4.8_4.8.2-19ubuntu1_amd64.deb ... + Unpacking gcc-4.8 (4.8.2-19ubuntu1) ... + Selecting previously unselected package gcc. + Preparing to unpack .../gcc_4%3a4.8.2-1ubuntu6_amd64.deb ... + Unpacking gcc (4:4.8.2-1ubuntu6) ... + Selecting previously unselected package libc-dev-bin. + Preparing to unpack .../libc-dev-bin_2.19-0ubuntu6_amd64.deb ... + Unpacking libc-dev-bin (2.19-0ubuntu6) ... + Selecting previously unselected package linux-libc-dev:amd64. + Preparing to unpack .../linux-libc-dev_3.13.0-30.55_amd64.deb ... + Unpacking linux-libc-dev:amd64 (3.13.0-30.55) ... + Selecting previously unselected package libc6-dev:amd64. + Preparing to unpack .../libc6-dev_2.19-0ubuntu6_amd64.deb ... + Unpacking libc6-dev:amd64 (2.19-0ubuntu6) ... + Selecting previously unselected package ruby. + Preparing to unpack .../ruby_1%3a1.9.3.4_all.deb ... + Unpacking ruby (1:1.9.3.4) ... + Selecting previously unselected package ruby1.9.1. + Preparing to unpack .../ruby1.9.1_1.9.3.484-2ubuntu1_amd64.deb ... + Unpacking ruby1.9.1 (1.9.3.484-2ubuntu1) ... + Selecting previously unselected package libruby1.9.1. + Preparing to unpack .../libruby1.9.1_1.9.3.484-2ubuntu1_amd64.deb ... + Unpacking libruby1.9.1 (1.9.3.484-2ubuntu1) ... + Selecting previously unselected package manpages-dev. + Preparing to unpack .../manpages-dev_3.54-1ubuntu1_all.deb ... + Unpacking manpages-dev (3.54-1ubuntu1) ... + Selecting previously unselected package ruby1.9.1-dev. + Preparing to unpack .../ruby1.9.1-dev_1.9.3.484-2ubuntu1_amd64.deb ... + Unpacking ruby1.9.1-dev (1.9.3.484-2ubuntu1) ... + Selecting previously unselected package ruby-dev. + Preparing to unpack .../ruby-dev_1%3a1.9.3.4_all.deb ... + Unpacking ruby-dev (1:1.9.3.4) ... + Setting up libasan0:amd64 (4.8.2-19ubuntu1) ... + Setting up libatomic1:amd64 (4.8.2-19ubuntu1) ... + Setting up libgmp10:amd64 (2:5.1.3+dfsg-1ubuntu1) ... + Setting up libisl10:amd64 (0.12.2-1) ... + Setting up libcloog-isl4:amd64 (0.18.2-1) ... + Setting up libgomp1:amd64 (4.8.2-19ubuntu1) ... + Setting up libitm1:amd64 (4.8.2-19ubuntu1) ... + Setting up libmpfr4:amd64 (3.1.2-1) ... + Setting up libquadmath0:amd64 (4.8.2-19ubuntu1) ... + Setting up libtsan0:amd64 (4.8.2-19ubuntu1) ... + Setting up libyaml-0-2:amd64 (0.1.4-3ubuntu3) ... + Setting up libmpc3:amd64 (1.0.1-1ubuntu1) ... + Setting up openssl (1.0.1f-1ubuntu2.4) ... + Setting up ca-certificates (20130906ubuntu2) ... + debconf: unable to initialize frontend: Dialog + debconf: (TERM is not set, so the dialog frontend is not usable.) + debconf: falling back to frontend: Readline + debconf: unable to initialize frontend: Readline + debconf: (This frontend requires a controlling tty.) + debconf: falling back to frontend: Teletype + Setting up manpages (3.54-1ubuntu1) ... + Setting up binutils (2.24-5ubuntu3) ... + Setting up cpp-4.8 (4.8.2-19ubuntu1) ... + Setting up cpp (4:4.8.2-1ubuntu6) ... + Setting up libgcc-4.8-dev:amd64 (4.8.2-19ubuntu1) ... + Setting up gcc-4.8 (4.8.2-19ubuntu1) ... + Setting up gcc (4:4.8.2-1ubuntu6) ... + Setting up libc-dev-bin (2.19-0ubuntu6) ... + Setting up linux-libc-dev:amd64 (3.13.0-30.55) ... + Setting up libc6-dev:amd64 (2.19-0ubuntu6) ... + Setting up manpages-dev (3.54-1ubuntu1) ... + Setting up libruby1.9.1 (1.9.3.484-2ubuntu1) ... + Setting up ruby1.9.1-dev (1.9.3.484-2ubuntu1) ... + Setting up ruby-dev (1:1.9.3.4) ... + Setting up ruby (1:1.9.3.4) ... + Setting up ruby1.9.1 (1.9.3.484-2ubuntu1) ... + Processing triggers for libc-bin (2.19-0ubuntu6) ... + Processing triggers for ca-certificates (20130906ubuntu2) ... + Updating certificates in /etc/ssl/certs... 164 added, 0 removed; done. + Running hooks in /etc/ca-certificates/update.d....done. + ---> c55c31703134 + Removing intermediate container 3a2558904e9b + Step 4 : RUN gem install sinatra + ---> Running in 6b81cb6313e5 + unable to convert "\xC3" to UTF-8 in conversion from ASCII-8BIT to UTF-8 to US-ASCII for README.rdoc, skipping + unable to convert "\xC3" to UTF-8 in conversion from ASCII-8BIT to UTF-8 to US-ASCII for README.rdoc, skipping + Successfully installed rack-1.5.2 + Successfully installed tilt-1.4.1 + Successfully installed rack-protection-1.5.3 + Successfully installed sinatra-1.4.5 + 4 gems installed + Installing ri documentation for rack-1.5.2... + Installing ri documentation for tilt-1.4.1... + Installing ri documentation for rack-protection-1.5.3... + Installing ri documentation for sinatra-1.4.5... + Installing RDoc documentation for rack-1.5.2... + Installing RDoc documentation for tilt-1.4.1... + Installing RDoc documentation for rack-protection-1.5.3... + Installing RDoc documentation for sinatra-1.4.5... + ---> 97feabe5d2ed + Removing intermediate container 6b81cb6313e5 + Successfully built 97feabe5d2ed + +You've specified our `docker build` command and used the `-t` flag to identify +our new image as belonging to the user `ouruser`, the repository name `sinatra` +and given it the tag `v2`. + +You've also specified the location of our `Dockerfile` using the `.` to +indicate a `Dockerfile` in the current directory. + +> **Note:** +> You can also specify a path to a `Dockerfile`. + +Now you can see the build process at work. The first thing Docker does is +upload the build context: basically the contents of the directory you're +building in. This is done because the Docker daemon does the actual +build of the image and it needs the local context to do it. + +Next you can see each instruction in the `Dockerfile` being executed +step-by-step. You can see that each step creates a new container, runs +the instruction inside that container and then commits that change - +just like the `docker commit` work flow you saw earlier. When all the +instructions have executed you're left with the `97feabe5d2ed` image +(also helpfully tagged as `ouruser/sinatra:v2`) and all intermediate +containers will get removed to clean things up. + +> **Note:** +> An image can't have more than 127 layers regardless of the storage driver. +> This limitation is set globally to encourage optimization of the overall +> size of images. + +You can then create a container from our new image. + + $ docker run -t -i ouruser/sinatra:v2 /bin/bash + root@8196968dac35:/# + +> **Note:** +> This is just a brief introduction to creating images. We've +> skipped a whole bunch of other instructions that you can use. We'll see more of +> those instructions in later sections of the Guide or you can refer to the +> [`Dockerfile`](../reference/builder.md) reference for a +> detailed description and examples of every instruction. +> To help you write a clear, readable, maintainable `Dockerfile`, you've also +> written a [`Dockerfile` Best Practices guide](../articles/dockerfile_best-practices.md). + + +## Setting tags on an image + +You can also add a tag to an existing image after you commit or build it. We +can do this using the `docker tag` command. Now, add a new tag to your +`ouruser/sinatra` image. + + $ docker tag 5db5f8471261 ouruser/sinatra:devel + +The `docker tag` command takes the ID of the image, here `5db5f8471261`, and our +user name, the repository name and the new tag. + +Now, see your new tag using the `docker images` command. + + $ docker images ouruser/sinatra + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + ouruser/sinatra latest 5db5f8471261 11 hours ago 446.7 MB + ouruser/sinatra devel 5db5f8471261 11 hours ago 446.7 MB + ouruser/sinatra v2 5db5f8471261 11 hours ago 446.7 MB + +## Image Digests + +Images that use the v2 or later format have a content-addressable identifier +called a `digest`. As long as the input used to generate the image is +unchanged, the digest value is predictable. To list image digest values, use +the `--digests` flag: + + $ docker images --digests | head + REPOSITORY TAG DIGEST IMAGE ID CREATED VIRTUAL SIZE + ouruser/sinatra latest sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 5db5f8471261 11 hours ago 446.7 MB + +When pushing or pulling to a 2.0 registry, the `push` or `pull` command +output includes the image digest. You can `pull` using a digest value. + + $ docker pull ouruser/sinatra@cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf + +You can also reference by digest in `create`, `run`, and `rmi` commands, as well as the +`FROM` image reference in a Dockerfile. + +## Push an image to Docker Hub + +Once you've built or created a new image you can push it to [Docker +Hub](https://hub.docker.com) using the `docker push` command. This +allows you to share it with others, either publicly, or push it into [a +private repository](https://registry.hub.docker.com/plans/). + + $ docker push ouruser/sinatra + The push refers to a repository [ouruser/sinatra] (len: 1) + Sending image list + Pushing repository ouruser/sinatra (3 tags) + . . . + +## Remove an image from the host + +You can also remove images on your Docker host in a way [similar to +containers](usingdocker.md) using the `docker rmi` command. + +Delete the `training/sinatra` image as you don't need it anymore. + + $ docker rmi training/sinatra + Untagged: training/sinatra:latest + Deleted: 5bc342fa0b91cabf65246837015197eecfa24b2213ed6a51a8974ae250fedd8d + Deleted: ed0fffdcdae5eb2c3a55549857a8be7fc8bc4241fb19ad714364cbfd7a56b22f + Deleted: 5c58979d73ae448df5af1d8142436d81116187a7633082650549c52c3a2418f0 + +> **Note:** To remove an image from the host, please make sure +> that there are no containers actively based on it. + +# Next steps + +Until now you've seen how to build individual applications inside Docker +containers. Now learn how to build whole application stacks with Docker +by networking together multiple Docker containers. + +Go to [Network containers](networkingcontainers.md). diff --git a/docs/userguide/dockerizing.md b/docs/userguide/dockerizing.md new file mode 100644 index 0000000000..588872b452 --- /dev/null +++ b/docs/userguide/dockerizing.md @@ -0,0 +1,211 @@ + + +# Hello world in a container + +*So what's this Docker thing all about?* + +Docker allows you to run applications, worlds you create, inside containers. +Running an application inside a container takes a single command: `docker run`. + +>**Note**: Depending on your Docker system configuration, you may be required to +>preface each `docker` command on this page with `sudo`. To avoid this behavior, +>your system administrator can create a Unix group called `docker` and add users +>to it. + +## Run a Hello world + +Let's try it now. + + $ docker run ubuntu:14.04 /bin/echo 'Hello world' + Hello world + +And you just launched your first container! + +So what just happened? Let's step through what the `docker run` command +did. + +First we specified the `docker` binary and the command we wanted to +execute, `run`. The `docker run` combination *runs* containers. + +Next we specified an image: `ubuntu:14.04`. This is the source of the container +we ran. Docker calls this an image. In this case we used an Ubuntu 14.04 +operating system image. + +When you specify an image, Docker looks first for the image on your +Docker host. If it can't find it then it downloads the image from the public +image registry: [Docker Hub](https://hub.docker.com). + +Next we told Docker what command to run inside our new container: + + /bin/echo 'Hello world' + +When our container was launched Docker created a new Ubuntu 14.04 +environment and then executed the `/bin/echo` command inside it. We saw +the result on the command line: + + Hello world + +So what happened to our container after that? Well Docker containers +only run as long as the command you specify is active. Here, as soon as +`Hello world` was echoed, the container stopped. + +## An interactive container + +Let's try the `docker run` command again, this time specifying a new +command to run in our container. + + $ docker run -t -i ubuntu:14.04 /bin/bash + root@af8bae53bdd3:/# + +Here we've again specified the `docker run` command and launched an +`ubuntu:14.04` image. But we've also passed in two flags: `-t` and `-i`. +The `-t` flag assigns a pseudo-tty or terminal inside our new container +and the `-i` flag allows us to make an interactive connection by +grabbing the standard in (`STDIN`) of the container. + +We've also specified a new command for our container to run: +`/bin/bash`. This will launch a Bash shell inside our container. + +So now when our container is launched we can see that we've got a +command prompt inside it: + + root@af8bae53bdd3:/# + +Let's try running some commands inside our container: + + root@af8bae53bdd3:/# pwd + / + root@af8bae53bdd3:/# ls + bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr var + +You can see we've run the `pwd` to show our current directory and can +see we're in the `/` root directory. We've also done a directory listing +of the root directory which shows us what looks like a typical Linux +file system. + +You can play around inside this container and when you're done you can +use the `exit` command or enter Ctrl-D to finish. + + root@af8bae53bdd3:/# exit + +As with our previous container, once the Bash shell process has +finished, the container is stopped. + +## A daemonized Hello world + +Now a container that runs a command and then exits has some uses but +it's not overly helpful. Let's create a container that runs as a daemon, +like most of the applications we're probably going to run with Docker. + +Again we can do this with the `docker run` command: + + $ docker run -d ubuntu:14.04 /bin/sh -c "while true; do echo hello world; sleep 1; done" + 1e5535038e285177d5214659a068137486f96ee5c2e85a4ac52dc83f2ebe4147 + +Wait, what? Where's our "hello world" output? Let's look at what we've run here. +It should look pretty familiar. We ran `docker run` but this time we +specified a flag: `-d`. The `-d` flag tells Docker to run the container +and put it in the background, to daemonize it. + +We also specified the same image: `ubuntu:14.04`. + +Finally, we specified a command to run: + + /bin/sh -c "while true; do echo hello world; sleep 1; done" + +This is the (hello) world's silliest daemon: a shell script that echoes +`hello world` forever. + +So why aren't we seeing any `hello world`'s? Instead Docker has returned +a really long string: + + 1e5535038e285177d5214659a068137486f96ee5c2e85a4ac52dc83f2ebe4147 + +This really long string is called a *container ID*. It uniquely +identifies a container so we can work with it. + +> **Note:** +> The container ID is a bit long and unwieldy. A bit later, +> we'll see a shorter ID and ways to name our containers to make +> working with them easier. + +We can use this container ID to see what's happening with our `hello world` daemon. + +Firstly let's make sure our container is running. We can +do that with the `docker ps` command. The `docker ps` command queries +the Docker daemon for information about all the containers it knows +about. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 1e5535038e28 ubuntu:14.04 /bin/sh -c 'while tr 2 minutes ago Up 1 minute insane_babbage + +Here we can see our daemonized container. The `docker ps` has returned some useful +information about it, starting with a shorter variant of its container ID: +`1e5535038e28`. + +We can also see the image we used to build it, `ubuntu:14.04`, the command it +is running, its status and an automatically assigned name, +`insane_babbage`. + +> **Note:** +> Docker automatically generates names for any containers started. +> We'll see how to specify your own names a bit later. + +Okay, so we now know it's running. But is it doing what we asked it to do? To +see this we're going to look inside the container using the `docker logs` +command. Let's use the container name Docker assigned. + + $ docker logs insane_babbage + hello world + hello world + hello world + . . . + +The `docker logs` command looks inside the container and returns its standard +output: in this case the output of our command `hello world`. + +Awesome! Our daemon is working and we've just created our first +Dockerized application! + +Now we've established we can create our own containers let's tidy up +after ourselves and stop our detached container. To do this we use the +`docker stop` command. + + $ docker stop insane_babbage + insane_babbage + +The `docker stop` command tells Docker to politely stop the running +container. If it succeeds it will return the name of the container it +has just stopped. + +Let's check it worked with the `docker ps` command. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + +Excellent. Our container has been stopped. + +# Next steps + +So far, you launched your first containers using the `docker run` command. You +ran an *interactive container* that ran in the foreground. You also ran a +*detached container* that ran in the background. In the process you learned +about several Docker commands: + +* `docker ps` - Lists containers. +* `docker logs` - Shows us the standard output of a container. +* `docker stop` - Stops running containers. + +Now, you have the basis learn more about Docker and how to do some more advanced +tasks. Go to ["*Run a simple application*"](usingdocker.md) to actually build a +web application with the Docker client. diff --git a/docs/userguide/dockerrepos.md b/docs/userguide/dockerrepos.md new file mode 100644 index 0000000000..f04254d860 --- /dev/null +++ b/docs/userguide/dockerrepos.md @@ -0,0 +1,186 @@ + + +# Store images on Docker Hub + +So far you've learned how to use the command line to run Docker on your local +host. You've learned how to [pull down images](usingdocker.md) to build +containers from existing images and you've learned how to [create your own +images](dockerimages.md). + +Next, you're going to learn how to use the [Docker Hub](https://hub.docker.com) +to simplify and enhance your Docker workflows. + +The [Docker Hub](https://hub.docker.com) is a public registry maintained by +Docker, Inc. It contains images you can download and use to build +containers. It also provides authentication, work group structure, workflow +tools like webhooks and build triggers, and privacy tools like private +repositories for storing images you don't want to share publicly. + +## Docker commands and Docker Hub + +Docker itself provides access to Docker Hub services via the `docker search`, +`pull`, `login`, and `push` commands. This page will show you how these commands work. + +### Account creation and login +Typically, you'll want to start by creating an account on Docker Hub (if you haven't +already) and logging in. You can create your account directly on +[Docker Hub](https://hub.docker.com/account/signup/), or by running: + + $ docker login + +This will prompt you for a user name, which will become the public namespace for your +public repositories. +If your user name is available, Docker will prompt you to enter a password and your +e-mail address. It will then automatically log you in. You can now commit and +push your own images up to your repos on Docker Hub. + +> **Note:** +> Your authentication credentials will be stored in the `~/.docker/config.json` +> authentication file in your home directory. + +## Searching for images + +You can search the [Docker Hub](https://hub.docker.com) registry via its search +interface or by using the command line interface. Searching can find images by image +name, user name, or description: + + $ docker search centos + NAME DESCRIPTION STARS OFFICIAL AUTOMATED + centos The official build of CentOS 1223 [OK] + tianon/centos CentOS 5 and 6, created using rinse instea... 33 + ... + +There you can see two example results: `centos` and `tianon/centos`. The second +result shows that it comes from the public repository of a user, named +`tianon/`, while the first result, `centos`, doesn't explicitly list a +repository which means that it comes from the trusted top-level namespace for +[Official Repositories](https://docs.docker.com/docker-hub/official_repos/). The `/` character separates +a user's repository from the image name. + +Once you've found the image you want, you can download it with `docker pull `: + + $ docker pull centos + Using default tag: latest + latest: Pulling from library/centos + f1b10cd84249: Pull complete + c852f6d61e65: Pull complete + 7322fbe74aa5: Pull complete + Digest: sha256:90305c9112250c7e3746425477f1c4ef112b03b4abe78c612e092037bfecc3b7 + Status: Downloaded newer image for centos:latest + +You now have an image from which you can run containers. + +### Specific Versions or Latest +Using `docker pull centos` is equivalent to using `docker pull centos:latest`. +To pull an image that is not the default latest image you can be more precise +with the image that you want. + +For example, to pull version 5 of `centos` use `docker pull centos:centos5`. +In this example, `centos5` is the tag labeling an image in the `centos` +repository for a version of `centos`. + +To find a list of tags pointing to currently available versions of a repository +see the [Docker Hub](https://hub.docker.com) registry. + +## Contributing to Docker Hub + +Anyone can pull public images from the [Docker Hub](https://hub.docker.com) +registry, but if you would like to share your own images, then you must +[register first](https://docs.docker.com/docker-hub/accounts). + +## Pushing a repository to Docker Hub + +In order to push a repository to its registry, you need to have named an image +or committed your container to a named image as we saw +[here](dockerimages.md). + +Now you can push this repository to the registry designated by its name or tag. + + $ docker push yourname/newimage + +The image will then be uploaded and available for use by your team-mates and/or the +community. + +## Features of Docker Hub + +Let's take a closer look at some of the features of Docker Hub. You can find more +information [here](https://docs.docker.com/docker-hub/). + +* Private repositories +* Organizations and teams +* Automated Builds +* Webhooks + +### Private repositories + +Sometimes you have images you don't want to make public and share with +everyone. So Docker Hub allows you to have private repositories. You can +sign up for a plan [here](https://registry.hub.docker.com/plans/). + +### Organizations and teams + +One of the useful aspects of private repositories is that you can share +them only with members of your organization or team. Docker Hub lets you +create organizations where you can collaborate with your colleagues and +manage private repositories. You can learn how to create and manage an organization +[here](https://registry.hub.docker.com/account/organizations/). + +### Automated Builds + +Automated Builds automate the building and updating of images from +[GitHub](https://www.github.com) or [Bitbucket](http://bitbucket.com), directly on Docker +Hub. It works by adding a commit hook to your selected GitHub or Bitbucket repository, +triggering a build and update when you push a commit. + +#### To setup an Automated Build + +1. Create a [Docker Hub account](https://hub.docker.com/) and login. +2. Link your GitHub or Bitbucket account through the ["Link Accounts"](https://registry.hub.docker.com/account/accounts/) menu. +3. [Configure an Automated Build](https://registry.hub.docker.com/builds/add/). +4. Pick a GitHub or Bitbucket project that has a `Dockerfile` that you want to build. +5. Pick the branch you want to build (the default is the `master` branch). +6. Give the Automated Build a name. +7. Assign an optional Docker tag to the Build. +8. Specify where the `Dockerfile` is located. The default is `/`. + +Once the Automated Build is configured it will automatically trigger a +build and, in a few minutes, you should see your new Automated Build on the [Docker Hub](https://hub.docker.com) +Registry. It will stay in sync with your GitHub and Bitbucket repository until you +deactivate the Automated Build. + +To check the output and status of your Automated Build repositories, click on a repository name within the ["Your Repositories" page](https://registry.hub.docker.com/repos/). Automated Builds are indicated by a check-mark icon next to the repository name. Within the repository details page, you may click on the "Build Details" tab to view the status and output of all builds triggered by the Docker Hub. + +Once you've created an Automated Build you can deactivate or delete it. You +cannot, however, push to an Automated Build with the `docker push` command. +You can only manage it by committing code to your GitHub or Bitbucket +repository. + +You can create multiple Automated Builds per repository and configure them +to point to specific `Dockerfile`'s or Git branches. + +#### Build triggers + +Automated Builds can also be triggered via a URL on Docker Hub. This +allows you to rebuild an Automated build image on demand. + +### Webhooks + +Webhooks are attached to your repositories and allow you to trigger an +event when an image or updated image is pushed to the repository. With +a webhook you can specify a target URL and a JSON payload that will be +delivered when the image is pushed. + +See the Docker Hub documentation for [more information on +webhooks](https://docs.docker.com/docker-hub/repos/#webhooks) + +## Next steps + +Go and use Docker! diff --git a/docs/userguide/dockervolumes.md b/docs/userguide/dockervolumes.md new file mode 100644 index 0000000000..f44f5511dc --- /dev/null +++ b/docs/userguide/dockervolumes.md @@ -0,0 +1,286 @@ + + +# Manage data in containers + +So far we've been introduced to some [basic Docker concepts](usingdocker.md), +seen how to work with [Docker images](dockerimages.md) as well as learned about +[networking and links between containers](networking/default_network/dockerlinks.md). In this section we're +going to discuss how you can manage data inside and between your Docker +containers. + +We're going to look at the two primary ways you can manage data in +Docker. + +* Data volumes, and +* Data volume containers. + +## Data volumes + +A *data volume* is a specially-designated directory within one or more +containers that bypasses the [*Union File System*](../reference/glossary.md#union-file-system). Data volumes provide several useful features for persistent or shared data: + +- Volumes are initialized when a container is created. If the container's + base image contains data at the specified mount point, that existing data is + copied into the new volume upon volume initialization. +- Data volumes can be shared and reused among containers. +- Changes to a data volume are made directly. +- Changes to a data volume will not be included when you update an image. +- Data volumes persist even if the container itself is deleted. + +Data volumes are designed to persist data, independent of the container's life +cycle. Docker therefore *never* automatically delete volumes when you remove +a container, nor will it "garbage collect" volumes that are no longer +referenced by a container. + +### Adding a data volume + +You can add a data volume to a container using the `-v` flag with the +`docker create` and `docker run` command. You can use the `-v` multiple times +to mount multiple data volumes. Let's mount a single volume now in our web +application container. + + $ docker run -d -P --name web -v /webapp training/webapp python app.py + +This will create a new volume inside a container at `/webapp`. + +> **Note:** +> You can also use the `VOLUME` instruction in a `Dockerfile` to add one or +> more new volumes to any container created from that image. + +Docker volumes default to mount in read-write mode, but you can also set it to be mounted read-only. + + $ docker run -d -P --name web -v /opt/webapp:ro training/webapp python app.py + + +### Locating a volume + +You can locate the volume on the host by utilizing the 'docker inspect' command. + + $ docker inspect web + +The output will provide details on the container configurations including the +volumes. The output should look something similar to the following: + + ... + Mounts": [ + { + "Name": "fac362...80535", + "Source": "/var/lib/docker/volumes/fac362...80535/_data", + "Destination": "/webapp", + "Driver": "local", + "Mode": "", + "RW": true + } + ] + ... + +You will notice in the above 'Source' is specifying the location on the host and +'Destination' is specifying the volume location inside the container. `RW` shows +if the volume is read/write. + +### Mount a host directory as a data volume + +In addition to creating a volume using the `-v` flag you can also mount a +directory from your Docker daemon's host into a container. + +``` +$ docker run -d -P --name web -v /src/webapp:/opt/webapp training/webapp python app.py +``` + +This command mounts the host directory, `/src/webapp`, into the container at +`/opt/webapp`. If the path `/opt/webapp` already exists inside the container's +image, the `/src/webapp` mount overlays but does not remove the pre-existing +content. Once the mount is removed, the content is accessible again. This is +consistent with the expected behavior of the `mount` command. + +The `container-dir` must always be an absolute path such as `/src/docs`. +The `host-dir` can either be an absolute path or a `name` value. If you +supply an absolute path for the `host-dir`, Docker bind-mounts to the path +you specify. If you supply a `name`, Docker creates a named volume by that `name`. + +A `name` value must start with start with an alphanumeric character, +followed by `a-z0-9`, `_` (underscore), `.` (period) or `-` (hyphen). +An absolute path starts with a `/` (forward slash). + +For example, you can specify either `/foo` or `foo` for a `host-dir` value. +If you supply the `/foo` value, Docker creates a bind-mount. If you supply +the `foo` specification, Docker creates a named volume. + +If you are using Docker Machine on Mac or Windows, your Docker daemon has only limited access to your OS X or Windows filesystem. Docker Machine tries +to auto-share your `/Users` (OS X) or `C:\Users` (Windows) directory. So, +you can mount files or directories on OS X using. + +``` +docker run -v /Users/:/ ... +``` + +On Windows, mount directories using: + +``` +docker run -v /c/Users/:/ ...` +``` + +All other paths come from your virtual machine's filesystem. For example, if +you are using VirtualBox some other folder available for sharing, you need to do +additional work. In the case of VirtualBox you need to make the host folder +available as a shared folder in VirtualBox. Then, you can mount it using the +Docker `-v` flag. + +Mounting a host directory can be useful for testing. For example, you can mount +source code inside a container. Then, change the source code and see its effect +on the application in real time. The directory on the host must be specified as +an absolute path and if the directory doesn't exist Docker will automatically +create it for you. This auto-creation of the host path has been [*deprecated*](#auto-creating-missing-host-paths-for-bind-mounts). + +Docker volumes default to mount in read-write mode, but you can also set it to +be mounted read-only. + +``` +$ docker run -d -P --name web -v /src/webapp:/opt/webapp:ro training/webapp python app.py +``` + +Here we've mounted the same `/src/webapp` directory but we've added the `ro` +option to specify that the mount should be read-only. + +Because of [limitations in the `mount` +function](http://lists.linuxfoundation.org/pipermail/containers/2015-April/035788.html), +moving subdirectories within the host's source directory can give +access from the container to the host's file system. This requires a malicious +user with access to host and its mounted directory. + +>**Note**: The host directory is, by its nature, host-dependent. For this +>reason, you can't mount a host directory from `Dockerfile` because built images +>should be portable. A host directory wouldn't be available on all potential +>hosts. + +### Volume labels + +Labeling systems like SELinux require that proper labels are placed on volume +content mounted into a container. Without a label, the security system might +prevent the processes running inside the container from using the content. By +default, Docker does not change the labels set by the OS. + +To change a label in the container context, you can add either of two suffixes +`:z` or `:Z` to the volume mount. These suffixes tell Docker to relabel file +objects on the shared volumes. The `z` option tells Docker that two containers +share the volume content. As a result, Docker labels the content with a shared +content label. Shared volume labels allow all containers to read/write content. +The `Z` option tells Docker to label the content with a private unshared label. +Only the current container can use a private volume. + +### Mount a host file as a data volume + +The `-v` flag can also be used to mount a single file - instead of *just* +directories - from the host machine. + + $ docker run --rm -it -v ~/.bash_history:/.bash_history ubuntu /bin/bash + +This will drop you into a bash shell in a new container, you will have your bash +history from the host and when you exit the container, the host will have the +history of the commands typed while in the container. + +> **Note:** +> Many tools used to edit files including `vi` and `sed --in-place` may result +> in an inode change. Since Docker v1.1.0, this will produce an error such as +> "*sed: cannot rename ./sedKdJ9Dy: Device or resource busy*". In the case where +> you want to edit the mounted file, it is often easiest to instead mount the +> parent directory. + +## Creating and mounting a data volume container + +If you have some persistent data that you want to share between +containers, or want to use from non-persistent containers, it's best to +create a named Data Volume Container, and then to mount the data from +it. + +Let's create a new named container with a volume to share. +While this container doesn't run an application, it reuses the `training/postgres` +image so that all containers are using layers in common, saving disk space. + + $ docker create -v /dbdata --name dbdata training/postgres /bin/true + +You can then use the `--volumes-from` flag to mount the `/dbdata` volume in another container. + + $ docker run -d --volumes-from dbdata --name db1 training/postgres + +And another: + + $ docker run -d --volumes-from dbdata --name db2 training/postgres + +In this case, if the `postgres` image contained a directory called `/dbdata` +then mounting the volumes from the `dbdata` container hides the +`/dbdata` files from the `postgres` image. The result is only the files +from the `dbdata` container are visible. + +You can use multiple `--volumes-from` parameters to bring together multiple data +volumes from multiple containers. + +You can also extend the chain by mounting the volume that came from the +`dbdata` container in yet another container via the `db1` or `db2` containers. + + $ docker run -d --name db3 --volumes-from db1 training/postgres + +If you remove containers that mount volumes, including the initial `dbdata` +container, or the subsequent containers `db1` and `db2`, the volumes will not +be deleted. To delete the volume from disk, you must explicitly call +`docker rm -v` against the last container with a reference to the volume. This +allows you to upgrade, or effectively migrate data volumes between containers. + +> **Note:** Docker will not warn you when removing a container *without* +> providing the `-v` option to delete its volumes. If you remove containers +> without using the `-v` option, you may end up with "dangling" volumes; +> volumes that are no longer referenced by a container. +> Dangling volumes are difficult to get rid of and can take up a large amount +> of disk space. We're working on improving volume management and you can check +> progress on this in [pull request #14214](https://github.com/docker/docker/pull/14214) + +## Backup, restore, or migrate data volumes + +Another useful function we can perform with volumes is use them for +backups, restores or migrations. We do this by using the +`--volumes-from` flag to create a new container that mounts that volume, +like so: + + $ docker run --volumes-from dbdata -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata + +Here we've launched a new container and mounted the volume from the +`dbdata` container. We've then mounted a local host directory as +`/backup`. Finally, we've passed a command that uses `tar` to backup the +contents of the `dbdata` volume to a `backup.tar` file inside our +`/backup` directory. When the command completes and the container stops +we'll be left with a backup of our `dbdata` volume. + +You could then restore it to the same container, or another that you've made +elsewhere. Create a new container. + + $ docker run -v /dbdata --name dbdata2 ubuntu /bin/bash + +Then un-tar the backup file in the new container's data volume. + + $ docker run --volumes-from dbdata2 -v $(pwd):/backup ubuntu cd /dbdata && tar xvf /backup/backup.tar + +You can use the techniques above to automate backup, migration and +restore testing using your preferred tools. + +## Important tips on using shared volumes + +Multiple containers can also share one or more data volumes. However, multiple containers writing to a single shared volume can cause data corruption. Make sure you're applications are designed to write to shared data stores. + +Data volumes are directly accessible from the Docker host. This means you can read and write to them with normal Linux tools. In most cases you should not do this as it can cause data corruption if your containers and applications are unaware of your direct access. + +# Next steps + +Now we've learned a bit more about how to use Docker we're going to see how to +combine Docker with the services available on +[Docker Hub](https://hub.docker.com) including Automated Builds and private +repositories. + +Go to [Working with Docker Hub](dockerrepos.md). diff --git a/docs/userguide/image_management.md b/docs/userguide/image_management.md new file mode 100644 index 0000000000..447b3c57ab --- /dev/null +++ b/docs/userguide/image_management.md @@ -0,0 +1,53 @@ + + +# Image management + +The Docker Engine provides a client which you can use to create images on the command line or through a build process. You can run these images in a container or publish them for others to use. Storing the images you create, searching for images you might want, or publishing images others might use are all elements of image management. + +This section provides an overview of the major features and products Docker provides for image management. + + +## Docker Hub + +The [Docker Hub](https://docs.docker.com/docker-hub/) is responsible for centralizing information about user accounts, images, and public name spaces. It has different components: + + - Web UI + - Meta-data store (comments, stars, list public repositories) + - Authentication service + - Tokenization + +There is only one instance of the Docker Hub, run and managed by Docker Inc. This public Hub is useful for most individuals and smaller companies. + +## Docker Registry and the Docker Trusted Registry + +The Docker Registry is a component of Docker's ecosystem. A registry is a +storage and content delivery system, holding named Docker images, available in +different tagged versions. For example, the image `distribution/registry`, with +tags `2.0` and `latest`. Users interact with a registry by using docker push and +pull commands such as, `docker pull myregistry.com/stevvooe/batman:voice`. + +The Docker Hub has its own registry which, like the Hub itself, is run and managed by Docker. However, there are other ways to obtain a registry. You can purchase the [Docker Trusted Registry](https://docs.docker.com/docker-trusted-registry) product to run on your company's network. Alternatively, you can use the Docker Registry component to build a private registry. For information about using a registry, see overview for the [Docker Registry](https://docs.docker.com/registry). + + +## Content Trust + +When transferring data among networked systems, *trust* is a central concern. In +particular, when communicating over an untrusted medium such as the internet, it +is critical to ensure the integrity and publisher of all of the data a system +operates on. You use Docker to push and pull images (data) to a registry. +Content trust gives you the ability to both verify the integrity and the +publisher of all the data received from a registry over any channel. + +[Content trust](../security/trust/) is currently only available for users of the +public Docker Hub. It is currently not available for the Docker Trusted Registry +or for private registries. diff --git a/docs/userguide/index.md b/docs/userguide/index.md new file mode 100644 index 0000000000..2813de6dd6 --- /dev/null +++ b/docs/userguide/index.md @@ -0,0 +1,127 @@ + + +# Welcome to the Docker user guide + +In the [Introduction](../misc) you got a taste of what Docker is and how it +works. This guide takes you through the fundamentals of using Docker and +integrating it into your environment. You'll learn how to use Docker to: + +* Dockerize your applications. +* Run your own containers. +* Build Docker images. +* Share your Docker images with others. +* And a whole lot more! + +This guide is broken into major sections that take you through the Docker life +cycle: + +## Getting started with Docker Hub + +*How do I use Docker Hub?* + +Docker Hub is the central hub for Docker. It hosts public Docker images +and provides services to help you build and manage your Docker +environment. To learn more: + +Go to [Using Docker Hub](https://docs.docker.com/docker-hub). + +## Dockerizing applications: A "Hello world" + +*How do I run applications inside containers?* + +Docker offers a *container-based* virtualization platform to power your +applications. To learn how to Dockerize applications and run them: + +Go to [Dockerizing Applications](dockerizing.md). + + +## Working with containers + +*How do I manage my containers?* + +Once you get a grip on running your applications in Docker containers +we're going to show you how to manage those containers. To find out +about how to inspect, monitor and manage containers: + +Go to [Working With Containers](usingdocker.md). + +## Working with Docker images + +*How can I access, share and build my own images?* + +Once you've learnt how to use Docker it's time to take the next step and +learn how to build your own application images with Docker. + +Go to [Working with Docker Images](dockerimages.md). + +## Networking containers + +Until now we've seen how to build individual applications inside Docker +containers. Now learn how to build whole application stacks with Docker +networking. + +Go to [Networking Containers](networkingcontainers.md). + +## Managing data in containers + +Now we know how to link Docker containers together the next step is +learning how to manage data, volumes and mounts inside our containers. + +Go to [Managing Data in Containers](dockervolumes.md). + +## Working with Docker Hub + +Now we've learned a bit more about how to use Docker we're going to see +how to combine Docker with the services available on Docker Hub including +Trusted Builds and private repositories. + +Go to [Working with Docker Hub](dockerrepos.md). + +## Docker Compose + +Docker Compose allows you to define a application's components -- their containers, +configuration, links and volumes -- in a single file. Then a single command +will set everything up and start your application running. + +Go to [Docker Compose user guide](https://docs.docker.com/compose/). + +## Docker Machine + +Docker Machine helps you get Docker Engines up and running quickly. Machine +can set up hosts for Docker Engines on your computer, on cloud providers, +and/or in your data center, and then configure your Docker client to securely +talk to them. + +Go to [Docker Machine user guide](https://docs.docker.com/machine/). + +## Docker Swarm + +Docker Swarm pools several Docker Engines together and exposes them as a single +virtual Docker Engine. It serves the standard Docker API, so any tool that already +works with Docker can now transparently scale up to multiple hosts. + +Go to [Docker Swarm user guide](https://docs.docker.com/swarm/). + +## Getting help + +* [Docker homepage](https://www.docker.com/) +* [Docker Hub](https://hub.docker.com) +* [Docker blog](https://blog.docker.com/) +* [Docker documentation](https://docs.docker.com/) +* [Docker Getting Started Guide](https://docs.docker.com/mac/started/) +* [Docker code on GitHub](https://github.com/docker/docker) +* [Docker mailing + list](https://groups.google.com/forum/#!forum/docker-user) +* Docker on IRC: irc.freenode.net and channel #docker +* [Docker on Twitter](https://twitter.com/docker) +* Get [Docker help](https://stackoverflow.com/search?q=docker) on + StackOverflow +* [Docker.com](https://www.docker.com/) diff --git a/docs/userguide/labels-custom-metadata.md b/docs/userguide/labels-custom-metadata.md new file mode 100644 index 0000000000..e4ac7c4cdf --- /dev/null +++ b/docs/userguide/labels-custom-metadata.md @@ -0,0 +1,220 @@ + + +# Apply custom metadata + +You can apply metadata to your images, containers, or daemons via +labels. Labels serve a wide range of uses, such as adding notes or licensing +information to an image, or to identify a host. + +A label is a `` / `` pair. Docker stores the label values as +*strings*. You can specify multiple labels but each `` must be +unique or the value will be overwritten. If you specify the same `key` several +times but with different values, newer labels overwrite previous labels. Docker +uses the last `key=value` you supply. + +>**Note:** Support for daemon-labels was added in Docker 1.4.1. Labels on +>containers and images are new in Docker 1.6.0 + +## Label keys (namespaces) + +Docker puts no hard restrictions on the `key` used for a label. However, using +simple keys can easily lead to conflicts. For example, you have chosen to +categorize your images by CPU architecture using "architecture" labels in +your Dockerfiles: + + LABEL architecture="amd64" + + LABEL architecture="ARMv7" + +Another user may apply the same label based on a building's "architecture": + + LABEL architecture="Art Nouveau" + +To prevent naming conflicts, Docker recommends using namespaces to label keys +using reverse domain notation. Use the following guidelines to name your keys: + +- All (third-party) tools should prefix their keys with the + reverse DNS notation of a domain controlled by the author. For + example, `com.example.some-label`. + +- The `com.docker.*`, `io.docker.*` and `org.dockerproject.*` namespaces are + reserved for Docker's internal use. + +- Keys should only consist of lower-cased alphanumeric characters, + dots and dashes (for example, `[a-z0-9-.]`). + +- Keys should start *and* end with an alpha numeric character. + +- Keys may not contain consecutive dots or dashes. + +- Keys *without* namespace (dots) are reserved for CLI use. This allows end- + users to add metadata to their containers and images without having to type + cumbersome namespaces on the command-line. + + +These are simply guidelines and Docker does not *enforce* them. However, for +the benefit of the community, you *should* use namespaces for your label keys. + + +## Store structured data in labels + +Label values can contain any data type as long as it can be represented as a +string. For example, consider this JSON document: + + + { + "Description": "A containerized foobar", + "Usage": "docker run --rm example/foobar [args]", + "License": "GPL", + "Version": "0.0.1-beta", + "aBoolean": true, + "aNumber" : 0.01234, + "aNestedArray": ["a", "b", "c"] + } + +You can store this struct in a label by serializing it to a string first: + + LABEL com.example.image-specs="{\"Description\":\"A containerized foobar\",\"Usage\":\"docker run --rm example\\/foobar [args]\",\"License\":\"GPL\",\"Version\":\"0.0.1-beta\",\"aBoolean\":true,\"aNumber\":0.01234,\"aNestedArray\":[\"a\",\"b\",\"c\"]}" + +While it is *possible* to store structured data in label values, Docker treats +this data as a 'regular' string. This means that Docker doesn't offer ways to +query (filter) based on nested properties. If your tool needs to filter on +nested properties, the tool itself needs to implement this functionality. + + +## Add labels to images + +To add labels to an image, use the `LABEL` instruction in your Dockerfile: + + + LABEL [.][=] ... + +The `LABEL` instruction adds a label to your image, optionally with a value. +Use surrounding quotes or backslashes for labels that contain +white space characters in the ``: + + LABEL vendor=ACME\ Incorporated + LABEL com.example.version.is-beta + LABEL com.example.version="0.0.1-beta" + LABEL com.example.release-date="2015-02-12" + +The `LABEL` instruction also supports setting multiple `` / `` pairs +in a single instruction: + + LABEL com.example.version="0.0.1-beta" com.example.release-date="2015-02-12" + +Long lines can be split up by using a backslash (`\`) as continuation marker: + + LABEL vendor=ACME\ Incorporated \ + com.example.is-beta \ + com.example.version="0.0.1-beta" \ + com.example.release-date="2015-02-12" + +Docker recommends you add multiple labels in a single `LABEL` instruction. Using +individual instructions for each label can result in an inefficient image. This +is because each `LABEL` instruction in a Dockerfile produces a new IMAGE layer. + +You can view the labels via the `docker inspect` command: + + $ docker inspect 4fa6e0f0c678 + + ... + "Labels": { + "vendor": "ACME Incorporated", + "com.example.is-beta": "", + "com.example.version": "0.0.1-beta", + "com.example.release-date": "2015-02-12" + } + ... + + # Inspect labels on container + $ docker inspect -f "{{json .Config.Labels }}" 4fa6e0f0c678 + + {"Vendor":"ACME Incorporated","com.example.is-beta":"","com.example.version":"0.0.1-beta","com.example.release-date":"2015-02-12"} + + # Inspect labels on images + $ docker inspect -f "{{json .ContainerConfig.Labels }}" myimage + + +## Query labels + +Besides storing metadata, you can filter images and containers by label. To list all +running containers that have the `com.example.is-beta` label: + + # List all running containers that have a `com.example.is-beta` label + $ docker ps --filter "label=com.example.is-beta" + +List all running containers with the label `color` that have a value `blue`: + + $ docker ps --filter "label=color=blue" + +List all images with the label `vendor` that have the value `ACME`: + + $ docker images --filter "label=vendor=ACME" + + +## Container labels + + docker run \ + -d \ + --label com.example.group="webservers" \ + --label com.example.environment="production" \ + busybox \ + top + +Please refer to the [Query labels](#query-labels) section above for information +on how to query labels set on a container. + + +## Daemon labels + + docker daemon \ + --dns 8.8.8.8 \ + --dns 8.8.4.4 \ + -H unix:///var/run/docker.sock \ + --label com.example.environment="production" \ + --label com.example.storage="ssd" + +These labels appear as part of the `docker info` output for the daemon: + + $ docker -D info + Containers: 12 + Images: 672 + Server Version: 1.9.0 + Storage Driver: aufs + Root Dir: /var/lib/docker/aufs + Backing Filesystem: extfs + Dirs: 697 + Dirperm1 Supported: true + Execution Driver: native-0.2 + Logging Driver: json-file + Kernel Version: 3.19.0-22-generic + Operating System: Ubuntu 15.04 + CPUs: 24 + Total Memory: 62.86 GiB + Name: docker + ID: I54V:OLXT:HVMM:TPKO:JPHQ:CQCD:JNLC:O3BZ:4ZVJ:43XJ:PFHZ:6N2S + Debug mode (server): true + File Descriptors: 59 + Goroutines: 159 + System Time: 2015-09-23T14:04:20.699842089+08:00 + EventsListeners: 0 + Init SHA1: + Init Path: /usr/bin/docker + Docker Root Dir: /var/lib/docker + Http Proxy: http://test:test@localhost:8080 + Https Proxy: https://test:test@localhost:8080 + WARNING: No swap limit support + Username: svendowideit + Registry: [https://index.docker.io/v1/] + Labels: + com.example.environment=production + com.example.storage=ssd diff --git a/docs/userguide/networking/default_network/binding.md b/docs/userguide/networking/default_network/binding.md new file mode 100644 index 0000000000..d8799f4fbd --- /dev/null +++ b/docs/userguide/networking/default_network/binding.md @@ -0,0 +1,103 @@ + + +# Bind container ports to the host + +The information in this section explains binding container ports within the Docker default bridge. This is a `bridge` network named `bridge` created automatically when you install Docker. + +> **Note**: The [Docker networks feature](../dockernetworks.md) allows you to +create user-defined networks in addition to the default bridge network. + +By default Docker containers can make connections to the outside world, but the +outside world cannot connect to containers. Each outgoing connection will +appear to originate from one of the host machine's own IP addresses thanks to an +`iptables` masquerading rule on the host machine that the Docker server creates +when it starts: + +``` +$ sudo iptables -t nat -L -n +... +Chain POSTROUTING (policy ACCEPT) +target prot opt source destination +MASQUERADE all -- 172.17.0.0/16 0.0.0.0/0 +... +``` +The Docker server creates a masquerade rule that let containers connect to IP +addresses in the outside world. + +If you want containers to accept incoming connections, you will need to provide +special options when invoking `docker run`. There are two approaches. + +First, you can supply `-P` or `--publish-all=true|false` to `docker run` which +is a blanket operation that identifies every port with an `EXPOSE` line in the +image's `Dockerfile` or `--expose ` commandline flag and maps it to a host +port somewhere within an _ephemeral port range_. The `docker port` command then +needs to be used to inspect created mapping. The _ephemeral port range_ is +configured by `/proc/sys/net/ipv4/ip_local_port_range` kernel parameter, +typically ranging from 32768 to 61000. + +Mapping can be specified explicitly using `-p SPEC` or `--publish=SPEC` option. +It allows you to particularize which port on docker server - which can be any +port at all, not just one within the _ephemeral port range_ -- you want mapped +to which port in the container. + +Either way, you should be able to peek at what Docker has accomplished in your +network stack by examining your NAT tables. + +``` +# What your NAT rules might look like when Docker +# is finished setting up a -P forward: + +$ iptables -t nat -L -n +... +Chain DOCKER (2 references) +target prot opt source destination +DNAT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:49153 to:172.17.0.2:80 + +# What your NAT rules might look like when Docker +# is finished setting up a -p 80:80 forward: + +Chain DOCKER (2 references) +target prot opt source destination +DNAT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:80 to:172.17.0.2:80 +``` + +You can see that Docker has exposed these container ports on `0.0.0.0`, the +wildcard IP address that will match any possible incoming port on the host +machine. If you want to be more restrictive and only allow container services to +be contacted through a specific external interface on the host machine, you have +two choices. When you invoke `docker run` you can use either `-p +IP:host_port:container_port` or `-p IP::port` to specify the external interface +for one particular binding. + +Or if you always want Docker port forwards to bind to one specific IP address, +you can edit your system-wide Docker server settings and add the option +`--ip=IP_ADDRESS`. Remember to restart your Docker server after editing this +setting. + +> **Note**: With hairpin NAT enabled (`--userland-proxy=false`), containers port +exposure is achieved purely through iptables rules, and no attempt to bind the +exposed port is ever made. This means that nothing prevents shadowing a +previously listening service outside of Docker through exposing the same port +for a container. In such conflicting situation, Docker created iptables rules +will take precedence and route to the container. + +The `--userland-proxy` parameter, true by default, provides a userland +implementation for inter-container and outside-to-container communication. When +disabled, Docker uses both an additional `MASQUERADE` iptable rule and the +`net.ipv4.route_localnet` kernel parameter which allow the host machine to +connect to a local container exposed port through the commonly used loopback +address: this alternative is preferred for performance reasons. + +## Related information + +- [Understand Docker container networks](../dockernetworks.md) +- [Work with network commands](../work-with-networks.md) +- [Legacy container links](dockerlinks.md) diff --git a/docs/userguide/networking/default_network/build-bridges.md b/docs/userguide/networking/default_network/build-bridges.md new file mode 100644 index 0000000000..a17d7fa27b --- /dev/null +++ b/docs/userguide/networking/default_network/build-bridges.md @@ -0,0 +1,77 @@ + + +# Build your own bridge + +This section explains building your own bridge to replaced the Docker default +bridge. This is a `bridge` network named `bridge` created automatically when you +install Docker. + +> **Note**: The [Docker networks feature](../dockernetworks.md) allows you to +create user-defined networks in addition to the default bridge network. + +You can set up your own bridge before starting Docker and use `-b BRIDGE` or +`--bridge=BRIDGE` to tell Docker to use your bridge instead. If you already +have Docker up and running with its default `docker0` still configured, you will +probably want to begin by stopping the service and removing the interface: + +``` +# Stopping Docker and removing docker0 + +$ sudo service docker stop +$ sudo ip link set dev docker0 down +$ sudo brctl delbr docker0 +$ sudo iptables -t nat -F POSTROUTING +``` + +Then, before starting the Docker service, create your own bridge and give it +whatever configuration you want. Here we will create a simple enough bridge +that we really could just have used the options in the previous section to +customize `docker0`, but it will be enough to illustrate the technique. + +``` +# Create our own bridge + +$ sudo brctl addbr bridge0 +$ sudo ip addr add 192.168.5.1/24 dev bridge0 +$ sudo ip link set dev bridge0 up + +# Confirming that our bridge is up and running + +$ ip addr show bridge0 +4: bridge0: mtu 1500 qdisc noop state UP group default + link/ether 66:38:d0:0d:76:18 brd ff:ff:ff:ff:ff:ff + inet 192.168.5.1/24 scope global bridge0 + valid_lft forever preferred_lft forever + +# Tell Docker about it and restart (on Ubuntu) + +$ echo 'DOCKER_OPTS="-b=bridge0"' >> /etc/default/docker +$ sudo service docker start + +# Confirming new outgoing NAT masquerade is set up + +$ sudo iptables -t nat -L -n +... +Chain POSTROUTING (policy ACCEPT) +target prot opt source destination +MASQUERADE all -- 192.168.5.0/24 0.0.0.0/0 +``` + +The result should be that the Docker server starts successfully and is now +prepared to bind containers to the new bridge. After pausing to verify the +bridge's configuration, try creating a container -- you will see that its IP +address is in your new IP address range, which Docker will have auto-detected. + +You can use the `brctl show` command to see Docker add and remove interfaces +from the bridge as you start and stop containers, and can run `ip addr` and `ip +route` inside a container to see that it has been given an address in the +bridge's IP address range and has been told to use the Docker host's IP address +on the bridge as its default gateway to the rest of the Internet. diff --git a/docs/userguide/networking/default_network/configure-dns.md b/docs/userguide/networking/default_network/configure-dns.md new file mode 100644 index 0000000000..5fe0d0e114 --- /dev/null +++ b/docs/userguide/networking/default_network/configure-dns.md @@ -0,0 +1,132 @@ + + +# Configure container DNS + +The information in this section explains configuring container DNS within +the Docker default bridge. This is a `bridge` network named `bridge` created +automatically when you install Docker. + +**Note**: The [Docker networks feature](../dockernetworks.md) allows you to create user-defined networks in addition to the default bridge network. + +How can Docker supply each container with a hostname and DNS configuration, without having to build a custom image with the hostname written inside? Its trick is to overlay three crucial `/etc` files inside the container with virtual files where it can write fresh information. You can see this by running `mount` inside a container: + +``` +$$ mount +... +/dev/disk/by-uuid/1fec...ebdf on /etc/hostname type ext4 ... +/dev/disk/by-uuid/1fec...ebdf on /etc/hosts type ext4 ... +/dev/disk/by-uuid/1fec...ebdf on /etc/resolv.conf type ext4 ... +... +``` + +This arrangement allows Docker to do clever things like keep `resolv.conf` up to date across all containers when the host machine receives new configuration over DHCP later. The exact details of how Docker maintains these files inside the container can change from one Docker version to the next, so you should leave the files themselves alone and use the following Docker options instead. + +Four different options affect container domain name services. + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

+ -h HOSTNAME or --hostname=HOSTNAME +

+ 		+

+ Sets the hostname by which the container knows itself. This is written + into /etc/hostname, into /etc/hosts as the name + of the container's host-facing IP address, and is the name that + /bin/bash inside the container will display inside its + prompt. But the hostname is not easy to see from outside the container. + It will not appear in docker ps nor in the + /etc/hosts file of any other container. +

+
+

+ --link=CONTAINER_NAME or ID:ALIAS +

+ 		+

+ Using this option as you run a container gives the new + container's /etc/hosts an extra entry named + ALIAS that points to the IP address of the container + identified by CONTAINER_NAME_or_ID. This lets processes + inside the new container connect to the hostname ALIAS + without having to know its IP. The --link= option is + discussed in more detail below. Because Docker may assign a different IP + address to the linked containers on restart, Docker updates the + ALIAS entry in the /etc/hosts file of the + recipient containers. +

+

+ --dns=IP_ADDRESS... +

+ Sets the IP addresses added as server lines to the container's + /etc/resolv.conf file. Processes in the container, when + confronted with a hostname not in /etc/hosts, will connect to + these IP addresses on port 53 looking for name resolution services.

+ --dns-search=DOMAIN... +

+ Sets the domain names that are searched when a bare unqualified hostname is + used inside of the container, by writing search lines into the + container's /etc/resolv.conf. When a container process attempts + to access host and the search domain example.com + is set, for instance, the DNS logic will not only look up host + but also host.example.com. +

+

+ Use --dns-search=. if you don't wish to set the search domain. +

+

+ --dns-opt=OPTION... +

+ Sets the options used by DNS resolvers by writing an options + line into the container's /etc/resolv.conf. +

+

+ See documentation for resolv.conf for a list of valid options +

+ + +Regarding DNS settings, in the absence of the `--dns=IP_ADDRESS...`, `--dns-search=DOMAIN...`, or `--dns-opt=OPTION...` options, Docker makes each container's `/etc/resolv.conf` look like the `/etc/resolv.conf` of the host machine (where the `docker` daemon runs). When creating the container's `/etc/resolv.conf`, the daemon filters out all localhost IP address `nameserver` entries from the host's original file. + +Filtering is necessary because all localhost addresses on the host are unreachable from the container's network. After this filtering, if there are no more `nameserver` entries left in the container's `/etc/resolv.conf` file, the daemon adds public Google DNS nameservers (8.8.8.8 and 8.8.4.4) to the container's DNS configuration. If IPv6 is enabled on the daemon, the public IPv6 Google DNS nameservers will also be added (2001:4860:4860::8888 and 2001:4860:4860::8844). + +> **Note**: If you need access to a host's localhost resolver, you must modify your DNS service on the host to listen on a non-localhost address that is reachable from within the container. + +You might wonder what happens when the host machine's `/etc/resolv.conf` file changes. The `docker` daemon has a file change notifier active which will watch for changes to the host DNS configuration. + +> **Note**: The file change notifier relies on the Linux kernel's inotify feature. Because this feature is currently incompatible with the overlay filesystem driver, a Docker daemon using "overlay" will not be able to take advantage of the `/etc/resolv.conf` auto-update feature. + +When the host file changes, all stopped containers which have a matching `resolv.conf` to the host will be updated immediately to this newest host configuration. Containers which are running when the host configuration changes will need to stop and start to pick up the host changes due to lack of a facility to ensure atomic writes of the `resolv.conf` file while the container is running. If the container's `resolv.conf` has been edited since it was started with the default configuration, no replacement will be attempted as it would overwrite the changes performed by the container. If the options (`--dns`, `--dns-search`, or `--dns-opt`) have been used to modify the default host configuration, then the replacement with an updated host's `/etc/resolv.conf` will not happen as well. + +> **Note**: For containers which were created prior to the implementation of the `/etc/resolv.conf` update feature in Docker 1.5.0: those containers will **not** receive updates when the host `resolv.conf` file changes. Only containers created with Docker 1.5.0 and above will utilize this auto-update feature. diff --git a/docs/userguide/networking/default_network/container-basics.md b/docs/userguide/networking/default_network/container-basics.md new file mode 100644 index 0000000000..3f3905f661 --- /dev/null +++ b/docs/userguide/networking/default_network/container-basics.md @@ -0,0 +1,110 @@ + + + + +# How the default network + +The information in this section explains configuring container DNS within tthe Docker default bridge. This is a `bridge` network named `bridge` created +automatically when you install Docker. + +**Note**: The [Docker networks feature](../dockernetworks.md) allows you to create user-defined networks in addition to the default bridge network. + +While Docker is under active development and continues to tweak and improve its network configuration logic, the shell commands in this section are rough equivalents to the steps that Docker takes when configuring networking for each new container. + +## Review some basics + +To communicate using the Internet Protocol (IP), a machine needs access to at least one network interface at which packets can be sent and received, and a routing table that defines the range of IP addresses reachable through that interface. Network interfaces do not have to be physical devices. In fact, the `lo` loopback interface available on every Linux machine (and inside each Docker container) is entirely virtual -- the Linux kernel simply copies loopback packets directly from the sender's memory into the receiver's memory. + +Docker uses special virtual interfaces to let containers communicate with the host machine -- pairs of virtual interfaces called "peers" that are linked inside of the host machine's kernel so that packets can travel between them. They are simple to create, as we will see in a moment. + +The steps with which Docker configures a container are: +- Create a pair of peer virtual interfaces. +- Give one of them a unique name like `veth65f9`, keep it inside of the main Docker host, and bind it to `docker0` or whatever bridge Docker is supposed to be using. + +- Toss the other interface over the wall into the new container (which will already have been provided with an `lo` interface) and rename it to the much prettier name `eth0` since, inside of the container's separate and unique network interface namespace, there are no physical interfaces with which this name could collide. + +- Set the interface's MAC address according to the `--mac-address` parameter or generate a random one. + +- Give the container's `eth0` a new IP address from within the bridge's range of network addresses. The default route is set to the IP address passed to the Docker daemon using the `--default-gateway` option if specified, otherwise to the IP address that the Docker host owns on the bridge. The MAC address is generated from the IP address unless otherwise specified. This prevents ARP cache invalidation problems, when a new container comes up with an IP used in the past by another container with another MAC. + +With these steps complete, the container now possesses an `eth0` (virtual) network card and will find itself able to communicate with other containers and the rest of the Internet. + +You can opt out of the above process for a particular container by giving the `--net=` option to `docker run`, which takes four possible values. +- `--net=bridge` -- The default action, that connects the container to the Docker bridge as described above. + +- `--net=host` -- Tells Docker to skip placing the container inside of a separate network stack. In essence, this choice tells Docker to **not containerize the container's networking**! While container processes will still be confined to their own filesystem and process list and resource limits, a quick `ip addr` command will show you that, network-wise, they live "outside" in the main Docker host and have full access to its network interfaces. Note that this does **not** let the container reconfigure the host network stack -- that would require `--privileged=true` -- but it does let container processes open low-numbered ports like any other root process. It also allows the container to access local network services like D-bus. This can lead to processes in the container being able to do unexpected things like [restart your computer](https://github.com/docker/docker/issues/6401). You should use this option with caution. + +- `--net=container:NAME_or_ID` -- Tells Docker to put this container's processes inside of the network stack that has already been created inside of another container. The new container's processes will be confined to their own filesystem and process list and resource limits, but will share the same IP address and port numbers as the first container, and processes on the two containers will be able to connect to each other over the loopback interface. + +- `--net=none` -- Tells Docker to put the container inside of its own network stack but not to take any steps to configure its network, leaving you free to build any of the custom configurations explored in the last few sections of this document. + +## Manually network + +To get an idea of the steps that are necessary if you use `--net=none` as described in that last bullet point, here are the commands that you would run to reach roughly the same configuration as if you had let Docker do all of the configuration: + +``` +# At one shell, start a container and +# leave its shell idle and running + +$ docker run -i -t --rm --net=none base /bin/bash +root@63f36fc01b5f:/# + +# At another shell, learn the container process ID +# and create its namespace entry in /var/run/netns/ +# for the "ip netns" command we will be using below + +$ docker inspect -f '{{.State.Pid}}' 63f36fc01b5f +2778 +$ pid=2778 +$ sudo mkdir -p /var/run/netns +$ sudo ln -s /proc/$pid/ns/net /var/run/netns/$pid + +# Check the bridge's IP address and netmask + +$ ip addr show docker0 +21: docker0: ... +inet 172.17.42.1/16 scope global docker0 +... + +# Create a pair of "peer" interfaces A and B, +# bind the A end to the bridge, and bring it up + +$ sudo ip link add A type veth peer name B +$ sudo brctl addif docker0 A +$ sudo ip link set A up + +# Place B inside the container's network namespace, +# rename to eth0, and activate it with a free IP + +$ sudo ip link set B netns $pid +$ sudo ip netns exec $pid ip link set dev B name eth0 +$ sudo ip netns exec $pid ip link set eth0 address 12:34:56:78:9a:bc +$ sudo ip netns exec $pid ip link set eth0 up +$ sudo ip netns exec $pid ip addr add 172.17.42.99/16 dev eth0 +$ sudo ip netns exec $pid ip route add default via 172.17.42.1 +``` + +At this point your container should be able to perform networking operations as usual. + +When you finally exit the shell and Docker cleans up the container, the network namespace is destroyed along with our virtual `eth0` -- whose destruction in turn destroys interface `A` out in the Docker host and automatically un-registers it from the `docker0` bridge. So everything gets cleaned up without our having to run any extra commands! Well, almost everything: + +``` +# Clean up dangling symlinks in /var/run/netns + +find -L /var/run/netns -type l -delete +``` + +Also note that while the script above used modern `ip` command instead of old deprecated wrappers like `ipconfig` and `route`, these older commands would also have worked inside of our container. The `ip addr` command can be typed as `ip a` if you are in a hurry. + +Finally, note the importance of the `ip netns exec` command, which let us reach inside and configure a network namespace as root. The same commands would not have worked if run inside of the container, because part of safe containerization is that Docker strips container processes of the right to configure their own networks. Using `ip netns exec` is what let us finish up the configuration without having to take the dangerous step of running the container itself with `--privileged=true`. diff --git a/docs/userguide/networking/default_network/container-communication.md b/docs/userguide/networking/default_network/container-communication.md new file mode 100644 index 0000000000..0dc7016f4f --- /dev/null +++ b/docs/userguide/networking/default_network/container-communication.md @@ -0,0 +1,123 @@ + + +# Understand container communication + +The information in this section explains container communication within the +Docker default bridge. This is a `bridge` network named `bridge` created +automatically when you install Docker. + +**Note**: The [Docker networks feature](../dockernetworks.md) allows you to create user-defined networks in addition to the default bridge network. + +## Communicating to the outside world + +Whether a container can talk to the world is governed by two factors. The first +factor is whether the host machine is forwarding its IP packets. The second is +whether the hosts `iptables` allow this particular connections + +IP packet forwarding is governed by the `ip_forward` system parameter. Packets +can only pass between containers if this parameter is `1`. Usually you will +simply leave the Docker server at its default setting `--ip-forward=true` and +Docker will go set `ip_forward` to `1` for you when the server starts up. If you +set `--ip-forward=false` and your system's kernel has it enabled, the +`--ip-forward=false` option has no effect. To check the setting on your kernel +or to turn it on manually: +``` + $ sysctl net.ipv4.conf.all.forwarding + net.ipv4.conf.all.forwarding = 0 + $ sysctl net.ipv4.conf.all.forwarding=1 + $ sysctl net.ipv4.conf.all.forwarding + net.ipv4.conf.all.forwarding = 1 +``` + +Many using Docker will want `ip_forward` to be on, to at least make +communication _possible_ between containers and the wider world. May also be +needed for inter-container communication if you are in a multiple bridge setup. + +Docker will never make changes to your system `iptables` rules if you set +`--iptables=false` when the daemon starts. Otherwise the Docker server will +append forwarding rules to the `DOCKER` filter chain. + +Docker will not delete or modify any pre-existing rules from the `DOCKER` filter +chain. This allows the user to create in advance any rules required to further +restrict access to the containers. + +Docker's forward rules permit all external source IPs by default. To allow only +a specific IP or network to access the containers, insert a negated rule at the +top of the `DOCKER` filter chain. For example, to restrict external access such +that _only_ source IP 8.8.8.8 can access the containers, the following rule +could be added: + +``` +$ iptables -I DOCKER -i ext_if ! -s 8.8.8.8 -j DROP +``` + +## Communication between containers + +Whether two containers can communicate is governed, at the operating system level, by two factors. + +- Does the network topology even connect the containers' network interfaces? By default Docker will attach all containers to a single `docker0` bridge, providing a path for packets to travel between them. See the later sections of this document for other possible topologies. + +- Do your `iptables` allow this particular connection? Docker will never make changes to your system `iptables` rules if you set `--iptables=false` when the daemon starts. Otherwise the Docker server will add a default rule to the `FORWARD` chain with a blanket `ACCEPT` policy if you retain the default `--icc=true`, or else will set the policy to `DROP` if `--icc=false`. + +It is a strategic question whether to leave `--icc=true` or change it to +`--icc=false` so that `iptables` will protect other containers -- and the main +host -- from having arbitrary ports probed or accessed by a container that gets +compromised. + +If you choose the most secure setting of `--icc=false`, then how can containers +communicate in those cases where you _want_ them to provide each other services? +The answer is the `--link=CONTAINER_NAME_or_ID:ALIAS` option, which was +mentioned in the previous section because of its effect upon name services. If +the Docker daemon is running with both `--icc=false` and `--iptables=true` +then, when it sees `docker run` invoked with the `--link=` option, the Docker +server will insert a pair of `iptables` `ACCEPT` rules so that the new +container can connect to the ports exposed by the other container -- the ports +that it mentioned in the `EXPOSE` lines of its `Dockerfile`. + +> **Note**: The value `CONTAINER_NAME` in `--link=` must either be an +auto-assigned Docker name like `stupefied_pare` or else the name you assigned +with `--name=` when you ran `docker run`. It cannot be a hostname, which Docker +will not recognize in the context of the `--link=` option. + +You can run the `iptables` command on your Docker host to see whether the `FORWARD` chain has a default policy of `ACCEPT` or `DROP`: + +``` +# When --icc=false, you should see a DROP rule: + +$ sudo iptables -L -n +... +Chain FORWARD (policy ACCEPT) +target prot opt source destination +DOCKER all -- 0.0.0.0/0 0.0.0.0/0 +DROP all -- 0.0.0.0/0 0.0.0.0/0 +... + +# When a --link= has been created under --icc=false, +# you should see port-specific ACCEPT rules overriding +# the subsequent DROP policy for all other packets: + +$ sudo iptables -L -n +... +Chain FORWARD (policy ACCEPT) +target prot opt source destination +DOCKER all -- 0.0.0.0/0 0.0.0.0/0 +DROP all -- 0.0.0.0/0 0.0.0.0/0 + +Chain DOCKER (1 references) +target prot opt source destination +ACCEPT tcp -- 172.17.0.2 172.17.0.3 tcp spt:80 +ACCEPT tcp -- 172.17.0.3 172.17.0.2 tcp dpt:80 +``` + +> **Note**: Docker is careful that its host-wide `iptables` rules fully expose +containers to each other's raw IP addresses, so connections from one container +to another should always appear to be originating from the first container's own +IP address. diff --git a/docs/userguide/networking/default_network/custom-docker0.md b/docs/userguide/networking/default_network/custom-docker0.md new file mode 100644 index 0000000000..494da6dec7 --- /dev/null +++ b/docs/userguide/networking/default_network/custom-docker0.md @@ -0,0 +1,61 @@ + + +# Customize the docker0 bridge + +The information in this section explains how to customize the Docker default bridge. This is a `bridge` network named `bridge` created automatically when you install Docker. + +**Note**: The [Docker networks feature](../dockernetworks.md) allows you to create user-defined networks in addition to the default bridge network. + +By default, the Docker server creates and configures the host system's `docker0` interface as an _Ethernet bridge_ inside the Linux kernel that can pass packets back and forth between other physical or virtual network interfaces so that they behave as a single Ethernet network. + +Docker configures `docker0` with an IP address, netmask and IP allocation range. The host machine can both receive and send packets to containers connected to the bridge, and gives it an MTU -- the _maximum transmission unit_ or largest packet length that the interface will allow -- of either 1,500 bytes or else a more specific value copied from the Docker host's interface that supports its default route. These options are configurable at server startup: +- `--bip=CIDR` -- supply a specific IP address and netmask for the `docker0` bridge, using standard CIDR notation like `192.168.1.5/24`. + +- `--fixed-cidr=CIDR` -- restrict the IP range from the `docker0` subnet, using the standard CIDR notation like `172.167.1.0/28`. This range must be an IPv4 range for fixed IPs (ex: 10.20.0.0/16) and must be a subset of the bridge IP range (`docker0` or set using `--bridge`). For example with `--fixed-cidr=192.168.1.0/25`, IPs for your containers will be chosen from the first half of `192.168.1.0/24` subnet. + +- `--mtu=BYTES` -- override the maximum packet length on `docker0`. + +Once you have one or more containers up and running, you can confirm that Docker has properly connected them to the `docker0` bridge by running the `brctl` command on the host machine and looking at the `interfaces` column of the output. Here is a host with two different containers connected: + +``` +# Display bridge info + +$ sudo brctl show +bridge name bridge id STP enabled interfaces +docker0 8000.3a1d7362b4ee no veth65f9 + vethdda6 +``` + +If the `brctl` command is not installed on your Docker host, then on Ubuntu you should be able to run `sudo apt-get install bridge-utils` to install it. + +Finally, the `docker0` Ethernet bridge settings are used every time you create a new container. Docker selects a free IP address from the range available on the bridge each time you `docker run` a new container, and configures the container's `eth0` interface with that IP address and the bridge's netmask. The Docker host's own IP address on the bridge is used as the default gateway by which each container reaches the rest of the Internet. + +``` +# The network, as seen from a container + +$ docker run -i -t --rm base /bin/bash + +$$ ip addr show eth0 +24: eth0: mtu 1500 qdisc pfifo_fast state UP group default qlen 1000 + link/ether 32:6f:e0:35:57:91 brd ff:ff:ff:ff:ff:ff + inet 172.17.0.3/16 scope global eth0 + valid_lft forever preferred_lft forever + inet6 fe80::306f:e0ff:fe35:5791/64 scope link + valid_lft forever preferred_lft forever + +$$ ip route +default via 172.17.42.1 dev eth0 +172.17.0.0/16 dev eth0 proto kernel scope link src 172.17.0.3 + +$$ exit +``` + +Remember that the Docker host will not be willing to forward container packets out on to the Internet unless its `ip_forward` system setting is `1` -- see the section above on [Communication between containers](#between-containers) for details. diff --git a/docs/userguide/networking/default_network/dockerlinks.md b/docs/userguide/networking/default_network/dockerlinks.md new file mode 100644 index 0000000000..427ac586d4 --- /dev/null +++ b/docs/userguide/networking/default_network/dockerlinks.md @@ -0,0 +1,355 @@ + + +# Legacy container links + +The information in this section explains legacy container links within the Docker default bridge. This is a `bridge` network named `bridge` created automatically when you install Docker. + +Before the [Docker networks feature](../dockernetworks.md), you could use the +Docker link feature to allow containers to discover each other and securely +transfer information about one container to another container. With the +introduction of the Docker networks feature, you can still create links but they +are only supported on the default `bridge` network named `bridge` and appearing +in your network stack as `docker0`. + +This section briefly discuss connecting via a network port and then goes into +detail on container linking. While links are still supported on Docker's default +network (`bridge bridge`), you should avoid them in preference of the Docker +networks feature. Linking is expected to be deprecated and removed in a future +release. + +## Connect using network port mapping + +In [the Using Docker section](../../usingdocker.md), you created a +container that ran a Python Flask application: + + $ docker run -d -P training/webapp python app.py + +> **Note:** +> Containers have an internal network and an IP address +> (as we saw when we used the `docker inspect` command to show the container's +> IP address in the [Using Docker](../../usingdocker.md) section). +> Docker can have a variety of network configurations. You can see more +> information on Docker networking [here](../index.md). + +When that container was created, the `-P` flag was used to automatically map +any network port inside it to a random high port within an *ephemeral port +range* on your Docker host. Next, when `docker ps` was run, you saw that port +5000 in the container was bound to port 49155 on the host. + + $ docker ps nostalgic_morse + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + bc533791f3f5 training/webapp:latest python app.py 5 seconds ago Up 2 seconds 0.0.0.0:49155->5000/tcp nostalgic_morse + +You also saw how you can bind a container's ports to a specific port using +the `-p` flag. Here port 80 of the host is mapped to port 5000 of the +container: + + $ docker run -d -p 80:5000 training/webapp python app.py + +And you saw why this isn't such a great idea because it constrains you to +only one container on that specific port. + +Instead, you may specify a range of host ports to bind a container port to +that is different than the default *ephemeral port range*: + + $ docker run -d -p 8000-9000:5000 training/webapp python app.py + +This would bind port 5000 in the container to a randomly available port +between 8000 and 9000 on the host. + +There are also a few other ways you can configure the `-p` flag. By +default the `-p` flag will bind the specified port to all interfaces on +the host machine. But you can also specify a binding to a specific +interface, for example only to the `localhost`. + + $ docker run -d -p 127.0.0.1:80:5000 training/webapp python app.py + +This would bind port 5000 inside the container to port 80 on the +`localhost` or `127.0.0.1` interface on the host machine. + +Or, to bind port 5000 of the container to a dynamic port but only on the +`localhost`, you could use: + + $ docker run -d -p 127.0.0.1::5000 training/webapp python app.py + +You can also bind UDP ports by adding a trailing `/udp`. For example: + + $ docker run -d -p 127.0.0.1:80:5000/udp training/webapp python app.py + +You also learned about the useful `docker port` shortcut which showed us the +current port bindings. This is also useful for showing you specific port +configurations. For example, if you've bound the container port to the +`localhost` on the host machine, then the `docker port` output will reflect that. + + $ docker port nostalgic_morse 5000 + 127.0.0.1:49155 + +> **Note:** +> The `-p` flag can be used multiple times to configure multiple ports. + +## Connect with the linking system + +Network port mappings are not the only way Docker containers can connect to one +another. Docker also has a linking system that allows you to link multiple +containers together and send connection information from one to another. When +containers are linked, information about a source container can be sent to a +recipient container. This allows the recipient to see selected data describing +aspects of the source container. + +### The importance of naming + +To establish links, Docker relies on the names of your containers. +You've already seen that each container you create has an automatically +created name; indeed you've become familiar with our old friend +`nostalgic_morse` during this guide. You can also name containers +yourself. This naming provides two useful functions: + +1. It can be useful to name containers that do specific functions in a way + that makes it easier for you to remember them, for example naming a + container containing a web application `web`. + +2. It provides Docker with a reference point that allows it to refer to other + containers, for example, you can specify to link the container `web` to container `db`. + +You can name your container by using the `--name` flag, for example: + + $ docker run -d -P --name web training/webapp python app.py + +This launches a new container and uses the `--name` flag to +name the container `web`. You can see the container's name using the +`docker ps` command. + + $ docker ps -l + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + aed84ee21bde training/webapp:latest python app.py 12 hours ago Up 2 seconds 0.0.0.0:49154->5000/tcp web + +You can also use `docker inspect` to return the container's name. + + +> **Note:** +> Container names have to be unique. That means you can only call +> one container `web`. If you want to re-use a container name you must delete +> the old container (with `docker rm`) before you can create a new +> container with the same name. As an alternative you can use the `--rm` +> flag with the `docker run` command. This will delete the container +> immediately after it is stopped. + +## Communication across links + +Links allow containers to discover each other and securely transfer information +about one container to another container. When you set up a link, you create a +conduit between a source container and a recipient container. The recipient can +then access select data about the source. To create a link, you use the `--link` +flag. First, create a new container, this time one containing a database. + + $ docker run -d --name db training/postgres + +This creates a new container called `db` from the `training/postgres` +image, which contains a PostgreSQL database. + +Now, you need to delete the `web` container you created previously so you can replace it +with a linked one: + + $ docker rm -f web + +Now, create a new `web` container and link it with your `db` container. + + $ docker run -d -P --name web --link db:db training/webapp python app.py + +This will link the new `web` container with the `db` container you created +earlier. The `--link` flag takes the form: + + --link :alias + +Where `name` is the name of the container we're linking to and `alias` is an +alias for the link name. You'll see how that alias gets used shortly. +The `--link` flag also takes the form: + + --link + +In which case the alias will match the name. You could have written the previous +example as: + + $ docker run -d -P --name web --link db training/webapp python app.py + +Next, inspect your linked containers with `docker inspect`: + + $ docker inspect -f "{{ .HostConfig.Links }}" web + [/db:/web/db] + +You can see that the `web` container is now linked to the `db` container +`web/db`. Which allows it to access information about the `db` container. + +So what does linking the containers actually do? You've learned that a link allows a +source container to provide information about itself to a recipient container. In +our example, the recipient, `web`, can access information about the source `db`. To do +this, Docker creates a secure tunnel between the containers that doesn't need to +expose any ports externally on the container; you'll note when we started the +`db` container we did not use either the `-P` or `-p` flags. That's a big benefit of +linking: we don't need to expose the source container, here the PostgreSQL database, to +the network. + +Docker exposes connectivity information for the source container to the +recipient container in two ways: + +* Environment variables, +* Updating the `/etc/hosts` file. + +### Environment variables + +Docker creates several environment variables when you link containers. Docker +automatically creates environment variables in the target container based on +the `--link` parameters. It will also expose all environment variables +originating from Docker from the source container. These include variables from: + +* the `ENV` commands in the source container's Dockerfile +* the `-e`, `--env` and `--env-file` options on the `docker run` +command when the source container is started + +These environment variables enable programmatic discovery from within the +target container of information related to the source container. + +> **Warning**: +> It is important to understand that *all* environment variables originating +> from Docker within a container are made available to *any* container +> that links to it. This could have serious security implications if sensitive +> data is stored in them. + +Docker sets an `_NAME` environment variable for each target container +listed in the `--link` parameter. For example, if a new container called +`web` is linked to a database container called `db` via `--link db:webdb`, +then Docker creates a `WEBDB_NAME=/web/webdb` variable in the `web` container. + +Docker also defines a set of environment variables for each port exposed by the +source container. Each variable has a unique prefix in the form: + +`_PORT__` + +The components in this prefix are: + +* the alias `` specified in the `--link` parameter (for example, `webdb`) +* the `` number exposed +* a `` which is either TCP or UDP + +Docker uses this prefix format to define three distinct environment variables: + +* The `prefix_ADDR` variable contains the IP Address from the URL, for +example `WEBDB_PORT_5432_TCP_ADDR=172.17.0.82`. +* The `prefix_PORT` variable contains just the port number from the URL for +example `WEBDB_PORT_5432_TCP_PORT=5432`. +* The `prefix_PROTO` variable contains just the protocol from the URL for +example `WEBDB_PORT_5432_TCP_PROTO=tcp`. + +If the container exposes multiple ports, an environment variable set is +defined for each one. This means, for example, if a container exposes 4 ports +that Docker creates 12 environment variables, 3 for each port. + +Additionally, Docker creates an environment variable called `_PORT`. +This variable contains the URL of the source container's first exposed port. +The 'first' port is defined as the exposed port with the lowest number. +For example, consider the `WEBDB_PORT=tcp://172.17.0.82:5432` variable. If +that port is used for both tcp and udp, then the tcp one is specified. + +Finally, Docker also exposes each Docker originated environment variable +from the source container as an environment variable in the target. For each +variable Docker creates an `_ENV_` variable in the target +container. The variable's value is set to the value Docker used when it +started the source container. + +Returning back to our database example, you can run the `env` +command to list the specified container's environment variables. + +``` + $ docker run --rm --name web2 --link db:db training/webapp env + . . . + DB_NAME=/web2/db + DB_PORT=tcp://172.17.0.5:5432 + DB_PORT_5432_TCP=tcp://172.17.0.5:5432 + DB_PORT_5432_TCP_PROTO=tcp + DB_PORT_5432_TCP_PORT=5432 + DB_PORT_5432_TCP_ADDR=172.17.0.5 + . . . +``` + +You can see that Docker has created a series of environment variables with +useful information about the source `db` container. Each variable is prefixed +with +`DB_`, which is populated from the `alias` you specified above. If the `alias` +were `db1`, the variables would be prefixed with `DB1_`. You can use these +environment variables to configure your applications to connect to the database +on the `db` container. The connection will be secure and private; only the +linked `web` container will be able to talk to the `db` container. + +### Important notes on Docker environment variables + +Unlike host entries in the [`/etc/hosts` file](#updating-the-etchosts-file), +IP addresses stored in the environment variables are not automatically updated +if the source container is restarted. We recommend using the host entries in +`/etc/hosts` to resolve the IP address of linked containers. + +These environment variables are only set for the first process in the +container. Some daemons, such as `sshd`, will scrub them when spawning shells +for connection. + +### Updating the `/etc/hosts` file + +In addition to the environment variables, Docker adds a host entry for the +source container to the `/etc/hosts` file. Here's an entry for the `web` +container: + + $ docker run -t -i --rm --link db:webdb training/webapp /bin/bash + root@aed84ee21bde:/opt/webapp# cat /etc/hosts + 172.17.0.7 aed84ee21bde + . . . + 172.17.0.5 webdb 6e5cdeb2d300 db + +You can see two relevant host entries. The first is an entry for the `web` +container that uses the Container ID as a host name. The second entry uses the +link alias to reference the IP address of the `db` container. In addition to +the alias you provide, the linked container's name--if unique from the alias +provided to the `--link` parameter--and the linked container's hostname will +also be added in `/etc/hosts` for the linked container's IP address. You can ping +that host now via any of these entries: + + root@aed84ee21bde:/opt/webapp# apt-get install -yqq inetutils-ping + root@aed84ee21bde:/opt/webapp# ping webdb + PING webdb (172.17.0.5): 48 data bytes + 56 bytes from 172.17.0.5: icmp_seq=0 ttl=64 time=0.267 ms + 56 bytes from 172.17.0.5: icmp_seq=1 ttl=64 time=0.250 ms + 56 bytes from 172.17.0.5: icmp_seq=2 ttl=64 time=0.256 ms + +> **Note:** +> In the example, you'll note you had to install `ping` because it was not included +> in the container initially. + +Here, you used the `ping` command to ping the `db` container using its host entry, +which resolves to `172.17.0.5`. You can use this host entry to configure an application +to make use of your `db` container. + +> **Note:** +> You can link multiple recipient containers to a single source. For +> example, you could have multiple (differently named) web containers attached to your +>`db` container. + +If you restart the source container, the linked containers `/etc/hosts` files +will be automatically updated with the source container's new IP address, +allowing linked communication to continue. + + $ docker restart db + db + $ docker run -t -i --rm --link db:db training/webapp /bin/bash + root@aed84ee21bde:/opt/webapp# cat /etc/hosts + 172.17.0.7 aed84ee21bde + . . . + 172.17.0.9 db + +# Related information diff --git a/docs/userguide/networking/default_network/images/ipv6_basic_host_config.gliffy b/docs/userguide/networking/default_network/images/ipv6_basic_host_config.gliffy new file mode 100644 index 0000000000..8d0450fc7c --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_basic_host_config.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":414,"height":127,"nodeIndex":173,"autoFit":true,"exportBorder":false,"gridOn":false,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":8.5,"y":0.5},"max":{"x":413.75,"y":126.5}},"objects":[{"x":6.5,"y":106.0,"rotation":0.0,"id":9,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":19.5,"y":9.0,"rotation":0.0,"id":7,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":19,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":31.5,"y":23.5,"rotation":0.0,"id":4,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":16,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":5,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":11.75,"y":0.5,"rotation":0.0,"id":60,"width":402.0,"height":126.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":2,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":146.5,"y":83.0,"rotation":0.0,"id":164,"width":249.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":44,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:1::/64 dev docker0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":146.5,"y":27.5,"rotation":0.0,"id":73,"width":249.0,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":35,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]}],"shapeStyles":{"com.gliffy.shape.basic.basic_v1.default":{"fill":"#fff2cc","stroke":"#333333","strokeWidth":2,"dashStyle":"2.0,2.0","gradient":true,"shadow":true}},"lineStyles":{"global":{"stroke":"#d9d9d9"}},"textStyles":{"global":{"size":"12px","color":"#b7b7b7"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.uml.uml_v2.class","com.gliffy.libraries.uml.uml_v2.sequence","com.gliffy.libraries.uml.uml_v2.activity","com.gliffy.libraries.erd.erd_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.images"],"autosaveDisabled":false},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_basic_host_config.svg b/docs/userguide/networking/default_network/images/ipv6_basic_host_config.svg new file mode 100644 index 0000000000..0095b8bdc7 --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_basic_host_config.svg @@ -0,0 +1 @@ +Host2eth02001:db8::1/64docker0fe80::1/64ip -6routeadddefaultviafe80::1deveth0ip -6routeadd2001:db8:1::/64devdocker0 \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_ndp_proxying.gliffy b/docs/userguide/networking/default_network/images/ipv6_ndp_proxying.gliffy new file mode 100644 index 0000000000..698723e19f --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_ndp_proxying.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":616,"height":438,"nodeIndex":207,"autoFit":true,"exportBorder":false,"gridOn":false,"snapToGrid":false,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":3,"y":-7.75},"max":{"x":615.5,"y":437.5}},"objects":[{"x":173.0,"y":117.0,"rotation":0.0,"id":190,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":30,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":0,"py":1.0,"px":0.7071067811865476}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":186,"py":0.0,"px":0.2928932188134524}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":"4.0,4.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[120.21067811865476,-7.0],[335.78932188134524,57.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":195.0,"y":117.0,"rotation":0.0,"id":83,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":23,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":222.5,"y":35.0,"rotation":0.0,"id":0,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":7,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#fff2cc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":1,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Router

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":26.0,"y":109.0,"rotation":0.0,"id":33,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":6,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":0,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":2,"py":0.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[225.78932188134524,0.9999999999999858],[57.710678118654755,65.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":20.289321881345245,"y":150.0,"rotation":0.0,"id":32,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":4,"py":0.0,"px":0.2928932188134524}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":0,"py":1.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[333.5,24.5],[272.9213562373095,-40.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":271.0,"y":37.0,"rotation":0.0,"id":89,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":1,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":0,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#d9d9d9","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[1.5,-2.0],[1.5,-21.125],[1.5,-21.125],[1.5,-40.25]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[]},{"x":151.0,"y":115.0,"rotation":0.0,"id":183,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":0,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":0,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":179,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[121.5,-5.0],[62.5,59.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":455.5,"y":257.0,"rotation":0.0,"id":200,"width":150.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":200,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":5,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

expected Container location

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":467.5,"y":156.0,"rotation":0.0,"id":185,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":29,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::c00y/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":479.5,"y":174.5,"rotation":0.0,"id":186,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":27,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#e2e2e2","gradient":false,"dashStyle":"2,2","dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":187,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container x

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":151.5,"y":156.0,"rotation":0.0,"id":178,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":26,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::b001/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":163.5,"y":174.5,"rotation":0.0,"id":179,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":24,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":180,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":299.5,"y":257.0,"rotation":0.0,"id":9,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":15,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":317.5,"y":156.0,"rotation":0.0,"id":7,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::c001/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":1.0,"y":156.0,"rotation":0.0,"id":6,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":13,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::a001/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":324.5,"y":174.5,"rotation":0.0,"id":4,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":11,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":5,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host3

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":13.0,"y":174.5,"rotation":0.0,"id":2,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":3,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":-142.5,"y":118.5,"rotation":0.0,"id":31,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":4,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":4,"py":1.0,"px":0.7071067811865476}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":25,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[537.7106781186548,131.0],[602.0,204.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":-181.5,"y":122.5,"rotation":0.0,"id":30,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":3,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":4,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":27,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[535.2893218813452,127.0],[473.0,200.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":386.0,"y":306.0,"rotation":0.0,"id":78,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":22,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::c00a/125

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":218.0,"y":306.0,"rotation":0.0,"id":77,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":21,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8::c009/125

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":409.5,"y":323.0,"rotation":0.0,"id":25,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":18,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":26,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":241.5,"y":323.0,"rotation":0.0,"id":27,"width":99.99999999999999,"height":99.99999999999999,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":16,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":28,"width":95.99999999999999,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":207.75,"y":297.5,"rotation":0.0,"id":58,"width":339.75,"height":140.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":2,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]}],"shapeStyles":{"com.gliffy.shape.basic.basic_v1.default":{"fill":"#e2e2e2","stroke":"#333333","strokeWidth":2,"dashStyle":"2.0,2.0","gradient":false,"shadow":true}},"lineStyles":{"global":{"stroke":"#cccccc","strokeWidth":2,"dashStyle":"4.0,4.0"}},"textStyles":{"global":{"size":"12px","italic":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.uml.uml_v2.class","com.gliffy.libraries.uml.uml_v2.sequence","com.gliffy.libraries.uml.uml_v2.activity","com.gliffy.libraries.erd.erd_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.images"],"autosaveDisabled":false},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_ndp_proxying.svg b/docs/userguide/networking/default_network/images/ipv6_ndp_proxying.svg new file mode 100644 index 0000000000..49b2da9f0d --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_ndp_proxying.svg @@ -0,0 +1 @@ +RouterHost1Host3eth02001:db8::a001/64eth02001:db8::c001/64docker0fe80::1/64Container1Container2eth02001:db8::c009/125eth02001:db8::c00a/125eth02001:db8::1/64Host2eth02001:db8::b001/64Containerxeth02001:db8::c00y/64expectedContainerlocation \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_routed_network_example.gliffy b/docs/userguide/networking/default_network/images/ipv6_routed_network_example.gliffy new file mode 100644 index 0000000000..544fd52df4 --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_routed_network_example.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":893,"height":447,"nodeIndex":185,"autoFit":true,"exportBorder":false,"gridOn":false,"snapToGrid":false,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":-17.000680271168676,"y":7},"max":{"x":892.767693574114,"y":447}},"objects":[{"x":17.5,"y":205.5,"rotation":0.0,"id":167,"width":238.5,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":38,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:1::/64 dev docker0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":231.28932188134524,"y":95.0,"rotation":0.0,"id":120,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":6,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":161,"py":0.0,"px":0.2928932188134524}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":131,"py":1.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[267.5,47.5],[217.9213562373095,-13.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":187.0,"y":206.5,"rotation":0.0,"id":121,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":9,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":140,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":148,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[130.28932188134524,11.0],[-79.0,91.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":174.0,"y":217.5,"rotation":0.0,"id":122,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":8,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":140,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":146,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[164.0,0.0],[120.0,81.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":33.50000000000003,"y":409.0,"rotation":0.0,"id":123,"width":346.49999999999994,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":3.5000000000000284,"y":268.5,"rotation":0.0,"id":124,"width":411.00000000000006,"height":163.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":237.0,"y":54.0,"rotation":0.0,"id":125,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":7,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":131,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":140,"py":0.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[170.78932188134524,27.999999999999986],[121.71067811865476,88.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":378.5,"y":7.0,"rotation":0.0,"id":131,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":10,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#e2e2e2","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":132,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Layer 2 Switch

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":785.0,"y":195.0,"rotation":0.0,"id":136,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":32,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":143,"py":0.6187943262411347,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":"8.0,8.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[78.75000000000011,-0.25],[-798.0006802711687,-3.410605131648481E-13]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":262.0,"y":224.0,"rotation":0.0,"id":138,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":19,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":278.0,"y":126.0,"rotation":0.0,"id":139,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":16,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:0::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":288.0,"y":142.5,"rotation":0.0,"id":140,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":12,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":141,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":3.4999999999999716,"y":107.5,"rotation":0.0,"id":142,"width":411.0,"height":141.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":1,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":221.0,"y":283.0,"rotation":0.0,"id":144,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":34,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:1::2/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":34.000000000000014,"y":283.0,"rotation":0.0,"id":145,"width":149.99999999999997,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":24,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:1::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":244.0,"y":299.0,"rotation":0.0,"id":146,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":22,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":147,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container1-2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":58.0,"y":298.0,"rotation":0.0,"id":148,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":20,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":149,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container1-1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":317.0,"y":436.5,"rotation":0.0,"id":158,"width":223.00000000000003,"height":11.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":37,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

containers' link-local addresses are not displayed

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":17.5,"y":148.0,"rotation":0.0,"id":137,"width":291.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":29,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:0::/64 dev eth0

ip -6 route add 2001:db8:2::/64 via 2001:db8:0::2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":901.7500000000001,"y":195.0,"rotation":0.0,"id":172,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":43,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-12.982306425886122,0.0],[-41.25,0.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":670.0,"y":284.0,"rotation":0.0,"id":155,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":36,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:2::2/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":479.0,"y":284.0,"rotation":0.0,"id":150,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":35,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:2::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":488.75,"y":408.0,"rotation":0.0,"id":152,"width":339.75,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":30,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":694.5,"y":298.0,"rotation":0.0,"id":156,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":27,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":157,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container2-2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":501.5,"y":298.0,"rotation":0.0,"id":153,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":25,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":154,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container2-1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":444.5,"y":223.0,"rotation":0.0,"id":160,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":18,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":460.5,"y":128.0,"rotation":0.0,"id":159,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":17,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:0::2/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":469.5,"y":142.5,"rotation":0.0,"id":161,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":162,"width":96.0,"height":13.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":139.5,"y":86.5,"rotation":0.0,"id":126,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":161,"py":1.0,"px":0.7071067811865476}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":156,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[400.71067811865476,131.0],[605.0,211.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":100.5,"y":90.5,"rotation":0.0,"id":127,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":4,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":161,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":153,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[419.0,127.0],[451.0,207.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":447.75,"y":268.5,"rotation":0.0,"id":151,"width":416.0000000000001,"height":163.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":2,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":447.75,"y":107.5,"rotation":0.0,"id":143,"width":416.0000000000001,"height":141.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":795.7500000000001,"y":307.5,"rotation":270.0,"id":173,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":41,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

managed by Docker

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":879.7500000000001,"y":417.0,"rotation":0.0,"id":174,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":40,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":2,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[0.0,14.008510484195028],[0.0,-221.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":898.7500000000001,"y":432.0,"rotation":0.0,"id":171,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":42,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-13.981657549458532,0.0],[-41.25,0.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":582.5,"y":151.0,"rotation":0.0,"id":135,"width":285.25000000000017,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":33,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:0::/64 dev eth0

ip -6 route add 2001:db8:1::/64 via 2001:db8:0::1 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":583.0,"y":204.0,"rotation":0.0,"id":168,"width":272.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":39,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:2::/64 dev docker0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]}],"shapeStyles":{"com.gliffy.shape.basic.basic_v1.default":{"fill":"#e2e2e2","stroke":"#333333","strokeWidth":2,"dashStyle":"2.0,2.0","gradient":true,"shadow":true}},"lineStyles":{"global":{"stroke":"#000000","strokeWidth":1,"dashStyle":"8.0,8.0"}},"textStyles":{}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.uml.uml_v2.class","com.gliffy.libraries.uml.uml_v2.sequence","com.gliffy.libraries.uml.uml_v2.activity","com.gliffy.libraries.erd.erd_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.images"],"autosaveDisabled":false},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_routed_network_example.svg b/docs/userguide/networking/default_network/images/ipv6_routed_network_example.svg new file mode 100644 index 0000000000..c97b02c262 --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_routed_network_example.svg @@ -0,0 +1 @@ +Layer 2 SwitchHost1Host2eth0 2001:db8:0::1/64eth0 2001:db8:0::2/64docker0 fe80::1/64docker0 fe80::1/64Container1-1Container1-2eth0 2001:db8:1::1/64Container2-1Container2-2ip -6 route add 2001:db8:0::/64 dev eth0ip -6 route add 2001:db8:2::/64 via 2001:db8:0::2ip -6 route add default via fe80::1 dev eth0ip -6 route add default via fe80::1 dev eth0ip -6 route add 2001:db8:0::/64 dev eth0ip -6 route add 2001:db8:1::/64 via 2001:db8:0::1 eth0 2001:db8:1::2/64eth0 2001:db8:2::1/64eth0 2001:db8:2::2/64containers' link-local addresses are not displayedip -6 route add 2001:db8:1::/64 dev docker0ip -6 route add 2001:db8:2::/64 dev docker0managed by Docker \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.gliffy b/docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.gliffy new file mode 100644 index 0000000000..6914fd074d --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":550,"height":341,"nodeIndex":88,"autoFit":true,"exportBorder":false,"gridOn":false,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":2.5,"y":2.5},"max":{"x":550,"y":341}},"objects":[{"x":10.5,"y":53.5,"rotation":0.0,"id":74,"width":150.0,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":26,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":37.0,"y":2.5,"rotation":0.0,"id":72,"width":100.0,"height":46.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":24,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#d9d9d9","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":73,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Router

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":89.5,"y":83.5,"rotation":0.0,"id":59,"width":150.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":17,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Routed Network:
2001:db8:23:42::/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":313.0,"y":314.0,"rotation":0.0,"id":39,"width":235.0,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":16,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":352.0,"y":185.5,"rotation":0.0,"id":36,"width":169.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":15,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:23:42:1::2/80

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":351.0,"y":49.5,"rotation":0.0,"id":29,"width":171.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:23:42:1::1/80

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":382.1250000000001,"y":202.5,"rotation":0.0,"id":30,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":12,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":31,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container1-2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":382.0,"y":65.5,"rotation":0.0,"id":32,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":10,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":33,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container1-1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":15.125000000000057,"y":264.0,"rotation":0.0,"id":20,"width":273.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

ip -6 route add 2001:db8:23:42:1::/80 dev docker0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":120.0,"y":178.5,"rotation":0.0,"id":21,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":8,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":13.0,"y":132.5,"rotation":0.0,"id":22,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":7,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:23:42::1/80

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":38.0,"y":149.0,"rotation":0.0,"id":23,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":5,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":24,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

host1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":-118.0,"y":123.0,"rotation":0.0,"id":44,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":4,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":23,"py":0.7071067811865475,"px":0.9999999999999998}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":30,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[255.99999999999997,79.03300858899107],[500.1250000000001,129.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":-138.0,"y":129.0,"rotation":0.0,"id":43,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":3,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":23,"py":0.29289321881345237,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":32,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[276.0,41.966991411008934],[520.0,-13.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":313.0,"y":40.0,"rotation":0.0,"id":34,"width":237.00000000000003,"height":301.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":2,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":87.0,"y":150.0,"rotation":0.0,"id":58,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":1,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":23,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":72,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.0,-1.0],[0.0,-101.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":2.5,"y":118.50000000000001,"rotation":0.0,"id":25,"width":292.0,"height":178.99999999999997,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#cccccc"}},"textStyles":{"global":{"bold":true,"italic":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.uml.uml_v1.default","com.gliffy.libraries.erd.erd_v1.default","com.gliffy.libraries.ui.ui_v2.forms_components","com.gliffy.libraries.network.network_v3.home","com.gliffy.libraries.images"],"autosaveDisabled":false},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.svg b/docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.svg new file mode 100644 index 0000000000..70b140e2dc --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_slash64_subnet_config.svg @@ -0,0 +1 @@ +host1eth02001:db8:23:42::1/80docker0fe80::1/64ip -6routeadddefaultviafe80::1deveth0ip-6routeadd2001:db8:23:42:1::/80devdocker0container1-1container1-2eth02001:db8:23:42:1::1/80eth02001:db8:23:42:1::2/80ip-6routeadddefaultviafe80::1deveth0RoutedNetwork:2001:db8:23:42::/64Routerfe80::1/64 \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_switched_network_example.gliffy b/docs/userguide/networking/default_network/images/ipv6_switched_network_example.gliffy new file mode 100644 index 0000000000..75cbfcaadc --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_switched_network_example.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#FFFFFF","width":893,"height":448,"nodeIndex":185,"autoFit":true,"exportBorder":false,"gridOn":false,"snapToGrid":false,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":-17.000680271168676,"y":7},"max":{"x":892.767693574114,"y":447.5}},"objects":[{"x":17.5,"y":205.5,"rotation":0.0,"id":167,"width":238.5,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":38,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:1::/64 dev docker0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":231.28932188134524,"y":95.0,"rotation":0.0,"id":120,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":6,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":161,"py":0.0,"px":0.2928932188134524}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":131,"py":1.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[267.5,47.5],[217.9213562373095,-13.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":187.0,"y":206.5,"rotation":0.0,"id":121,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":9,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":140,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":148,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[130.28932188134524,11.0],[-79.0,91.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":174.0,"y":217.5,"rotation":0.0,"id":122,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":8,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":140,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":146,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[164.0,0.0],[120.0,81.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":33.50000000000003,"y":409.0,"rotation":0.0,"id":123,"width":346.49999999999994,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":31,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":3.5000000000000284,"y":268.5,"rotation":0.0,"id":124,"width":411.00000000000006,"height":163.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":237.0,"y":54.0,"rotation":0.0,"id":125,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":7,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":131,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":140,"py":0.0,"px":0.7071067811865476}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[170.78932188134524,27.999999999999986],[121.71067811865476,88.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":378.5,"y":7.0,"rotation":0.0,"id":131,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":10,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#e2e2e2","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":132,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Level 2 Switch

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":785.0,"y":195.0,"rotation":0.0,"id":136,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":32,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":143,"py":0.6187943262411347,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":"8.0,8.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[78.75000000000011,-0.25],[-798.0006802711687,-3.410605131648481E-13]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":262.0,"y":224.0,"rotation":0.0,"id":138,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":19,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":278.0,"y":126.0,"rotation":0.0,"id":139,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":16,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:0::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":288.0,"y":142.5,"rotation":0.0,"id":140,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":12,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":141,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":3.4999999999999716,"y":107.5,"rotation":0.0,"id":142,"width":411.0,"height":141.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":1,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":221.0,"y":283.0,"rotation":0.0,"id":144,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":34,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:1::2/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":34.000000000000014,"y":283.0,"rotation":0.0,"id":145,"width":149.99999999999997,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":24,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:1::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":244.0,"y":299.0,"rotation":0.0,"id":146,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":22,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":147,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container1-2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":58.0,"y":298.0,"rotation":0.0,"id":148,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":20,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":149,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container1-1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":317.0,"y":436.5,"rotation":0.0,"id":158,"width":223.00000000000003,"height":11.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":37,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

containers' link-local addresses are not displayed

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":17.5,"y":148.0,"rotation":0.0,"id":137,"width":291.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":29,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:0::/64 dev eth0

ip -6 route add 2001:db8:2::/64 via 2001:db8:0::2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":901.7500000000001,"y":195.0,"rotation":0.0,"id":172,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":43,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-12.982306425886122,0.0],[-41.25,0.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":670.0,"y":284.0,"rotation":0.0,"id":155,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":36,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:2::2/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":479.0,"y":284.0,"rotation":0.0,"id":150,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":35,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:2::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":488.75,"y":408.0,"rotation":0.0,"id":152,"width":339.75,"height":16.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":30,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add default via fe80::1 dev eth0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":694.5,"y":298.0,"rotation":0.0,"id":156,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":27,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":157,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container2-2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":501.5,"y":298.0,"rotation":0.0,"id":153,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.square","order":25,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#ead1dc","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":154,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Container2-1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":444.5,"y":223.0,"rotation":0.0,"id":160,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":18,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker0 fe80::1/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":460.5,"y":128.0,"rotation":0.0,"id":159,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":17,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

eth0 2001:db8:0::2/64

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":469.5,"y":142.5,"rotation":0.0,"id":161,"width":100.0,"height":75.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#a4c2f4","gradient":true,"dashStyle":null,"dropShadow":true,"state":0,"opacity":1.0,"shadowX":4.0,"shadowY":4.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":162,"width":96.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":8,"paddingRight":8,"paddingBottom":8,"paddingLeft":8,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"children":[]}]},{"x":139.5,"y":86.5,"rotation":0.0,"id":126,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":5,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":161,"py":1.0,"px":0.7071067811865476}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":156,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[400.71067811865476,131.0],[605.0,211.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":100.5,"y":90.5,"rotation":0.0,"id":127,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":4,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":161,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":153,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#cccccc","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[419.0,127.0],[451.0,207.5]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":447.75,"y":268.5,"rotation":0.0,"id":151,"width":416.0000000000001,"height":163.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":2,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":447.75,"y":107.5,"rotation":0.0,"id":143,"width":416.0000000000001,"height":141.0,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dashStyle":"2,2","dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[]},{"x":795.7500000000001,"y":307.5,"rotation":270.0,"id":173,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":41,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

managed by Docker

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":879.7500000000001,"y":417.0,"rotation":0.0,"id":174,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":40,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":2,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[0.0,14.008510484195028],[0.0,-221.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":898.7500000000001,"y":432.0,"rotation":0.0,"id":171,"width":100.0,"height":100.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":42,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":1.0,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-13.981657549458532,0.0],[-41.25,0.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[]},{"x":582.5,"y":151.0,"rotation":0.0,"id":135,"width":285.25000000000017,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":33,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:0::/64 dev eth0

ip -6 route add 2001:db8:1::/64 via 2001:db8:0::1 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]},{"x":583.0,"y":204.0,"rotation":0.0,"id":168,"width":272.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":39,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

ip -6 route add 2001:db8:2::/64 dev docker0

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[]}],"shapeStyles":{"com.gliffy.shape.basic.basic_v1.default":{"fill":"#e2e2e2","stroke":"#333333","strokeWidth":2,"dashStyle":"2.0,2.0","gradient":true,"shadow":true}},"lineStyles":{"global":{"stroke":"#000000","strokeWidth":1,"dashStyle":"8.0,8.0"}},"textStyles":{}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.libraries.basic.basic_v1.default","com.gliffy.libraries.flowchart.flowchart_v1.default","com.gliffy.libraries.swimlanes.swimlanes_v1.default","com.gliffy.libraries.uml.uml_v2.class","com.gliffy.libraries.uml.uml_v2.sequence","com.gliffy.libraries.uml.uml_v2.activity","com.gliffy.libraries.erd.erd_v1.default","com.gliffy.libraries.ui.ui_v3.containers_content","com.gliffy.libraries.ui.ui_v3.forms_controls","com.gliffy.libraries.images"],"autosaveDisabled":false},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/default_network/images/ipv6_switched_network_example.svg b/docs/userguide/networking/default_network/images/ipv6_switched_network_example.svg new file mode 100644 index 0000000000..4cbf709b13 --- /dev/null +++ b/docs/userguide/networking/default_network/images/ipv6_switched_network_example.svg @@ -0,0 +1 @@ +Level2SwitchHost1Host2eth02001:db8:0::1/64eth02001:db8:0::2/64docker0fe80::1/64docker0fe80::1/64Container1-1Container1-2eth02001:db8:1::1/64Container2-1Container2-2ip -6routeadd2001:db8:0::/64deveth0ip -6routeadd2001:db8:2::/64via2001:db8:0::2ip-6routeadddefaultviafe80::1deveth0ip-6routeadddefaultviafe80::1deveth0ip -6routeadd2001:db8:0::/64deveth0ip -6routeadd2001:db8:1::/64via2001:db8:0::1eth02001:db8:1::2/64eth02001:db8:2::1/64eth02001:db8:2::2/64containers'link-localaddressesarenotdisplayedip -6routeadd2001:db8:1::/64devdocker0ip -6routeadd2001:db8:2::/64devdocker0managedbyDocker \ No newline at end of file diff --git a/docs/userguide/networking/default_network/index.md b/docs/userguide/networking/default_network/index.md new file mode 100644 index 0000000000..b72d1b4998 --- /dev/null +++ b/docs/userguide/networking/default_network/index.md @@ -0,0 +1,25 @@ + + +# Docker default bridge network + +With the introduction of the Docker networks feature, you can create your own +user-defined networks. The Docker default bridge is created when you install +Docker Engine. It is a `bridge` network and is also named `bridge`. The topics +in this section are related to interacting with that default bridge network. + +- [Understand container communication](container-communication.md) +- [Legacy container links](dockerlinks.md) +- [Binding container ports to the host](binding.md) +- [Build your own bridge](build-bridges.md) +- [Configure container DNS](configure-dns.md) +- [Customize the docker0 bridge](custom-docker0.md) +- [IPv6 with Docker](ipv6.md) diff --git a/docs/userguide/networking/default_network/ipv6.md b/docs/userguide/networking/default_network/ipv6.md new file mode 100644 index 0000000000..ec48719094 --- /dev/null +++ b/docs/userguide/networking/default_network/ipv6.md @@ -0,0 +1,259 @@ + + +# IPv6 with Docker + +The information in this section explains IPv6 with the Docker default bridge. +This is a `bridge` network named `bridge` created automatically when you install +Docker. + +As we are [running out of IPv4 +addresses](http://en.wikipedia.org/wiki/IPv4_address_exhaustion) the IETF has +standardized an IPv4 successor, [Internet Protocol Version +6](http://en.wikipedia.org/wiki/IPv6) , in [RFC +2460](https://www.ietf.org/rfc/rfc2460.txt). Both protocols, IPv4 and IPv6, +reside on layer 3 of the [OSI model](http://en.wikipedia.org/wiki/OSI_model). + +## How IPv6 works on Docker + +By default, the Docker server configures the container network for IPv4 only. +You can enable IPv4/IPv6 dualstack support by running the Docker daemon with the +`--ipv6` flag. Docker will set up the bridge `docker0` with the IPv6 [link-local +address](http://en.wikipedia.org/wiki/Link-local_address) `fe80::1`. + +By default, containers that are created will only get a link-local IPv6 address. +To assign globally routable IPv6 addresses to your containers you have to +specify an IPv6 subnet to pick the addresses from. Set the IPv6 subnet via the +`--fixed-cidr-v6` parameter when starting Docker daemon: + +``` +docker daemon --ipv6 --fixed-cidr-v6="2001:db8:1::/64" +``` + +The subnet for Docker containers should at least have a size of `/80`. This way +an IPv6 address can end with the container's MAC address and you prevent NDP +neighbor cache invalidation issues in the Docker layer. + +With the `--fixed-cidr-v6` parameter set Docker will add a new route to the +routing table. Further IPv6 routing will be enabled (you may prevent this by +starting Docker daemon with `--ip-forward=false`): + +``` +$ ip -6 route add 2001:db8:1::/64 dev docker0 +$ sysctl net.ipv6.conf.default.forwarding=1 +$ sysctl net.ipv6.conf.all.forwarding=1 +``` + +All traffic to the subnet `2001:db8:1::/64` will now be routed via the `docker0` interface. + +Be aware that IPv6 forwarding may interfere with your existing IPv6 +configuration: If you are using Router Advertisements to get IPv6 settings for +your host's interfaces you should set `accept_ra` to `2`. Otherwise IPv6 enabled +forwarding will result in rejecting Router Advertisements. E.g., if you want to +configure `eth0` via Router Advertisements you should set: + +``` +$ sysctl net.ipv6.conf.eth0.accept_ra=2 +``` + +![](images/ipv6_basic_host_config.svg) + +Every new container will get an IPv6 address from the defined subnet. Further a +default route will be added on `eth0` in the container via the address specified +by the daemon option `--default-gateway-v6` if present, otherwise via `fe80::1`: +``` +docker run -it ubuntu bash -c "ip -6 addr show dev eth0; ip -6 route show" + +15: eth0: mtu 1500 + inet6 2001:db8:1:0:0:242:ac11:3/64 scope global + valid_lft forever preferred_lft forever + inet6 fe80::42:acff:fe11:3/64 scope link + valid_lft forever preferred_lft forever + +2001:db8:1::/64 dev eth0 proto kernel metric 256 +fe80::/64 dev eth0 proto kernel metric 256 +default via fe80::1 dev eth0 metric 1024 +``` + +In this example the Docker container is assigned a link-local address with the +network suffix `/64` (here: `fe80::42:acff:fe11:3/64`) and a globally routable +IPv6 address (here: `2001:db8:1:0:0:242:ac11:3/64`). The container will create +connections to addresses outside of the `2001:db8:1::/64` network via the +link-local gateway at `fe80::1` on `eth0`. + +Often servers or virtual machines get a `/64` IPv6 subnet assigned (e.g. +`2001:db8:23:42::/64`). In this case you can split it up further and provide +Docker a `/80` subnet while using a separate `/80` subnet for other applications +on the host: + +![](images/ipv6_slash64_subnet_config.svg) + +In this setup the subnet `2001:db8:23:42::/80` with a range from +`2001:db8:23:42:0:0:0:0` to `2001:db8:23:42:0:ffff:ffff:ffff` is attached to +`eth0`, with the host listening at `2001:db8:23:42::1`. The subnet +`2001:db8:23:42:1::/80` with an address range from `2001:db8:23:42:1:0:0:0` to +`2001:db8:23:42:1:ffff:ffff:ffff` is attached to `docker0` and will be used by +containers. + +### Using NDP proxying + +If your Docker host is only part of an IPv6 subnet but has not got an IPv6 +subnet assigned you can use NDP proxying to connect your containers via IPv6 to +the internet. For example your host has the IPv6 address `2001:db8::c001`, is +part of the subnet `2001:db8::/64` and your IaaS provider allows you to +configure the IPv6 addresses `2001:db8::c000` to `2001:db8::c00f`: + +``` +$ ip -6 addr show +1: lo: mtu 65536 + inet6 ::1/128 scope host + valid_lft forever preferred_lft forever +2: eth0: mtu 1500 qlen 1000 + inet6 2001:db8::c001/64 scope global + valid_lft forever preferred_lft forever + inet6 fe80::601:3fff:fea1:9c01/64 scope link + valid_lft forever preferred_lft forever +``` + +Let's split up the configurable address range into two subnets +`2001:db8::c000/125` and `2001:db8::c008/125`. The first one can be used by the +host itself, the latter by Docker: + +``` +docker daemon --ipv6 --fixed-cidr-v6 2001:db8::c008/125 +``` + +You notice the Docker subnet is within the subnet managed by your router that is +connected to `eth0`. This means all devices (containers) with the addresses from +the Docker subnet are expected to be found within the router subnet. Therefore +the router thinks it can talk to these containers directly. + +![](images/ipv6_ndp_proxying.svg) + +As soon as the router wants to send an IPv6 packet to the first container it +will transmit a neighbor solicitation request, asking, who has `2001:db8::c009`? +But it will get no answer because no one on this subnet has this address. The +container with this address is hidden behind the Docker host. The Docker host +has to listen to neighbor solicitation requests for the container address and +send a response that itself is the device that is responsible for the address. +This is done by a Kernel feature called `NDP Proxy`. You can enable it by +executing + +``` +$ sysctl net.ipv6.conf.eth0.proxy_ndp=1 +``` + +Now you can add the container's IPv6 address to the NDP proxy table: + +``` +$ ip -6 neigh add proxy 2001:db8::c009 dev eth0 +``` + +This command tells the Kernel to answer to incoming neighbor solicitation +requests regarding the IPv6 address `2001:db8::c009` on the device `eth0`. As a +consequence of this all traffic to this IPv6 address will go into the Docker +host and it will forward it according to its routing table via the `docker0` +device to the container network: + +``` +$ ip -6 route show +2001:db8::c008/125 dev docker0 metric 1 +2001:db8::/64 dev eth0 proto kernel metric 256 +``` + +You have to execute the `ip -6 neigh add proxy ...` command for every IPv6 +address in your Docker subnet. Unfortunately there is no functionality for +adding a whole subnet by executing one command. An alternative approach would be +to use an NDP proxy daemon such as +[ndppd](https://github.com/DanielAdolfsson/ndppd). + +## Docker IPv6 cluster + +### Switched network environment +Using routable IPv6 addresses allows you to realize communication between +containers on different hosts. Let's have a look at a simple Docker IPv6 cluster +example: + +![](images/ipv6_switched_network_example.svg) + +The Docker hosts are in the `2001:db8:0::/64` subnet. Host1 is configured to +provide addresses from the `2001:db8:1::/64` subnet to its containers. It has +three routes configured: + +- Route all traffic to `2001:db8:0::/64` via `eth0` +- Route all traffic to `2001:db8:1::/64` via `docker0` +- Route all traffic to `2001:db8:2::/64` via Host2 with IP `2001:db8::2` + +Host1 also acts as a router on OSI layer 3. When one of the network clients +tries to contact a target that is specified in Host1's routing table Host1 will +forward the traffic accordingly. It acts as a router for all networks it knows: +`2001:db8::/64`, `2001:db8:1::/64` and `2001:db8:2::/64`. + +On Host2 we have nearly the same configuration. Host2's containers will get IPv6 +addresses from `2001:db8:2::/64`. Host2 has three routes configured: + +- Route all traffic to `2001:db8:0::/64` via `eth0` +- Route all traffic to `2001:db8:2::/64` via `docker0` +- Route all traffic to `2001:db8:1::/64` via Host1 with IP `2001:db8:0::1` + +The difference to Host1 is that the network `2001:db8:2::/64` is directly +attached to the host via its `docker0` interface whereas it reaches +`2001:db8:1::/64` via Host1's IPv6 address `2001:db8::1`. + +This way every container is able to contact every other container. The +containers `Container1-*` share the same subnet and contact each other directly. +The traffic between `Container1-*` and `Container2-*` will be routed via Host1 +and Host2 because those containers do not share the same subnet. + +In a switched environment every host has to know all routes to every subnet. +You always have to update the hosts' routing tables once you add or remove a +host to the cluster. + +Every configuration in the diagram that is shown below the dashed line is +handled by Docker: The `docker0` bridge IP address configuration, the route to +the Docker subnet on the host, the container IP addresses and the routes on the +containers. The configuration above the line is up to the user and can be +adapted to the individual environment. + +### Routed network environment +In a routed network environment you replace the layer 2 switch with a layer 3 +router. Now the hosts just have to know their default gateway (the router) and +the route to their own containers (managed by Docker). The router holds all +routing information about the Docker subnets. When you add or remove a host to +this environment you just have to update the routing table in the router - not +on every host. + +![](images/ipv6_routed_network_example.svg) + +In this scenario containers of the same host can communicate directly with each +other. The traffic between containers on different hosts will be routed via +their hosts and the router. For example packet from `Container1-1` to +`Container2-1` will be routed through `Host1`, `Router` and `Host2` until it +arrives at `Container2-1`. + +To keep the IPv6 addresses short in this example a `/48` network is assigned to +every host. The hosts use a `/64` subnet of this for its own services and one +for Docker. When adding a third host you would add a route for the subnet +`2001:db8:3::/48` in the router and configure Docker on Host3 with +`--fixed-cidr-v6=2001:db8:3:1::/64`. + +Remember the subnet for Docker containers should at least have a size of `/80`. +This way an IPv6 address can end with the container's MAC address and you +prevent NDP neighbor cache invalidation issues in the Docker layer. So if you +have a `/64` for your whole environment use `/78` subnets for the hosts and +`/80` for the containers. This way you can use 4096 hosts with 16 `/80` subnets +each. + +Every configuration in the diagram that is visualized below the dashed line is +handled by Docker: The `docker0` bridge IP address configuration, the route to +the Docker subnet on the host, the container IP addresses and the routes on the +containers. The configuration above the line is up to the user and can be +adapted to the individual environment. diff --git a/docs/userguide/networking/default_network/options.md b/docs/userguide/networking/default_network/options.md new file mode 100644 index 0000000000..612dffbc51 --- /dev/null +++ b/docs/userguide/networking/default_network/options.md @@ -0,0 +1,141 @@ + + + + +# Quick guide to the options +Here is a quick list of the networking-related Docker command-line options, in case it helps you find the section below that you are looking for. + +Some networking command-line options can only be supplied to the Docker server when it starts up, and cannot be changed once it is running: +- `-b BRIDGE` or `--bridge=BRIDGE` -- see + + [Building your own bridge](#bridge-building) + +- `--bip=CIDR` -- see + + [Customizing docker0](#docker0) + +- `--default-gateway=IP_ADDRESS` -- see + + [How Docker networks a container](#container-networking) + +- `--default-gateway-v6=IP_ADDRESS` -- see + + [IPv6](#ipv6) + +- `--fixed-cidr` -- see + + [Customizing docker0](#docker0) + +- `--fixed-cidr-v6` -- see + + [IPv6](#ipv6) + +- `-H SOCKET...` or `--host=SOCKET...` -- + + This might sound like it would affect container networking, + + but it actually faces in the other direction: + + it tells the Docker server over what channels + + it should be willing to receive commands + + like "run container" and "stop container." + +- `--icc=true|false` -- see + + [Communication between containers](#between-containers) + +- `--ip=IP_ADDRESS` -- see + + [Binding container ports](#binding-ports) + +- `--ipv6=true|false` -- see + + [IPv6](#ipv6) + +- `--ip-forward=true|false` -- see + + [Communication between containers and the wider world](#the-world) + +- `--iptables=true|false` -- see + + [Communication between containers](#between-containers) + +- `--mtu=BYTES` -- see + + [Customizing docker0](#docker0) + +- `--userland-proxy=true|false` -- see + + [Binding container ports](#binding-ports) + +There are three networking options that can be supplied either at startup or when `docker run` is invoked. When provided at startup, set the default value that `docker run` will later use if the options are not specified: +- `--dns=IP_ADDRESS...` -- see + + [Configuring DNS](#dns) + +- `--dns-search=DOMAIN...` -- see + + [Configuring DNS](#dns) + +- `--dns-opt=OPTION...` -- see + + [Configuring DNS](#dns) + +Finally, several networking options can only be provided when calling `docker run` because they specify something specific to one container: +- `-h HOSTNAME` or `--hostname=HOSTNAME` -- see + + [Configuring DNS](#dns) and + + [How Docker networks a container](#container-networking) + +- `--link=CONTAINER_NAME_or_ID:ALIAS` -- see + + [Configuring DNS](#dns) and + + [Communication between containers](#between-containers) + +- `--net=bridge|none|container:NAME_or_ID|host` -- see + + [How Docker networks a container](#container-networking) + +- `--mac-address=MACADDRESS...` -- see + + [How Docker networks a container](#container-networking) + +- `-p SPEC` or `--publish=SPEC` -- see + + [Binding container ports](#binding-ports) + +- `-P` or `--publish-all=true|false` -- see + + [Binding container ports](#binding-ports) + +To supply networking options to the Docker server at startup, use the `DOCKER_OPTS` variable in the Docker upstart configuration file. For Ubuntu, edit the variable in `/etc/default/docker` or `/etc/sysconfig/docker` for CentOS. + +The following example illustrates how to configure Docker on Ubuntu to recognize a newly built bridge. + +Edit the `/etc/default/docker` file: + +``` +$ echo 'DOCKER_OPTS="-b=bridge0"' >> /etc/default/docker +``` + +Then restart the Docker server. + +``` +$ sudo service docker start +``` + +For additional information on bridges, see [building your own bridge](#building-your-own-bridge) later on this page. diff --git a/docs/userguide/networking/default_network/saveme.md b/docs/userguide/networking/default_network/saveme.md new file mode 100644 index 0000000000..aa2652ebd9 --- /dev/null +++ b/docs/userguide/networking/default_network/saveme.md @@ -0,0 +1,28 @@ + + + + + +## A Brief introduction to networking and docker +When Docker starts, it creates a virtual interface named `docker0` on the host machine. It randomly chooses an address and subnet from the private range defined by [RFC 1918](http://tools.ietf.org/html/rfc1918) that are not in use on the host machine, and assigns it to `docker0`. Docker made the choice `172.17.42.1/16` when I started it a few minutes ago, for example -- a 16-bit netmask providing 65,534 addresses for the host machine and its containers. The MAC address is generated using the IP address allocated to the container to avoid ARP collisions, using a range from `02:42:ac:11:00:00` to `02:42:ac:11:ff:ff`. + +> **Note:** This document discusses advanced networking configuration and options for Docker. In most cases you won't need this information. If you're looking to get started with a simpler explanation of Docker networking and an introduction to the concept of container linking see the [Docker User Guide](/userguide/networking/networking/default_network/dockerlinks.md/). + +But `docker0` is no ordinary interface. It is a virtual _Ethernet bridge_ that automatically forwards packets between any other network interfaces that are attached to it. This lets containers communicate both with the host machine and with each other. Every time Docker creates a container, it creates a pair of "peer" interfaces that are like opposite ends of a pipe -- a packet sent on one will be received on the other. It gives one of the peers to the container to become its `eth0` interface and keeps the other peer, with a unique name like `vethAQI2QT`, out in the namespace of the host machine. By binding every `veth*` interface to the `docker0` bridge, Docker creates a virtual subnet shared between the host machine and every Docker container. + +The remaining sections of this document explain all of the ways that you can use Docker options and -- in advanced cases -- raw Linux networking commands to tweak, supplement, or entirely replace Docker's default networking configuration. + +## Editing networking config files +Starting with Docker v.1.2.0, you can now edit `/etc/hosts`, `/etc/hostname` and `/etc/resolve.conf` in a running container. This is useful if you need to install bind or other services that might override one of those files. + +Note, however, that changes to these files will not be saved by `docker commit`, nor will they be saved during `docker run`. That means they won't be saved in the image, nor will they persist when a container is restarted; they will only "stick" in a running container. diff --git a/docs/userguide/networking/default_network/tools.md b/docs/userguide/networking/default_network/tools.md new file mode 100644 index 0000000000..545c1e04c3 --- /dev/null +++ b/docs/userguide/networking/default_network/tools.md @@ -0,0 +1,83 @@ + + + + +# Tools and examples +Before diving into the following sections on custom network topologies, you might be interested in glancing at a few external tools or examples of the same kinds of configuration. Here are two: +- Jérôme Petazzoni has created a `pipework` shell script to help you + + connect together containers in arbitrarily complex scenarios: + + [https://github.com/jpetazzo/pipework](https://github.com/jpetazzo/pipework) + +- Brandon Rhodes has created a whole network topology of Docker + + containers for the next edition of Foundations of Python Network + + Programming that includes routing, NAT'd firewalls, and servers that + + offer HTTP, SMTP, POP, IMAP, Telnet, SSH, and FTP: + + [https://github.com/brandon-rhodes/fopnp/tree/m/playground](https://github.com/brandon-rhodes/fopnp/tree/m/playground) + +Both tools use networking commands very much like the ones you saw in the previous section, and will see in the following sections. + +# Building a point-to-point connection + + +By default, Docker attaches all containers to the virtual subnet implemented by `docker0`. You can create containers that are each connected to some different virtual subnet by creating your own bridge as shown in [Building your own bridge](#bridge-building), starting each container with `docker run --net=none`, and then attaching the containers to your bridge with the shell commands shown in [How Docker networks a container](#container-networking). + +But sometimes you want two particular containers to be able to communicate directly without the added complexity of both being bound to a host-wide Ethernet bridge. + +The solution is simple: when you create your pair of peer interfaces, simply throw _both_ of them into containers, and configure them as classic point-to-point links. The two containers will then be able to communicate directly (provided you manage to tell each container the other's IP address, of course). You might adjust the instructions of the previous section to go something like this: + +``` +# Start up two containers in two terminal windows + +$ docker run -i -t --rm --net=none base /bin/bash +root@1f1f4c1f931a:/# + +$ docker run -i -t --rm --net=none base /bin/bash +root@12e343489d2f:/# + +# Learn the container process IDs +# and create their namespace entries + +$ docker inspect -f '{{.State.Pid}}' 1f1f4c1f931a +2989 +$ docker inspect -f '{{.State.Pid}}' 12e343489d2f +3004 +$ sudo mkdir -p /var/run/netns +$ sudo ln -s /proc/2989/ns/net /var/run/netns/2989 +$ sudo ln -s /proc/3004/ns/net /var/run/netns/3004 + +# Create the "peer" interfaces and hand them out + +$ sudo ip link add A type veth peer name B + +$ sudo ip link set A netns 2989 +$ sudo ip netns exec 2989 ip addr add 10.1.1.1/32 dev A +$ sudo ip netns exec 2989 ip link set A up +$ sudo ip netns exec 2989 ip route add 10.1.1.2/32 dev A + +$ sudo ip link set B netns 3004 +$ sudo ip netns exec 3004 ip addr add 10.1.1.2/32 dev B +$ sudo ip netns exec 3004 ip link set B up +$ sudo ip netns exec 3004 ip route add 10.1.1.1/32 dev B +``` + +The two containers should now be able to ping each other and make connections successfully. Point-to-point links like this do not depend on a subnet nor a netmask, but on the bare assertion made by `ip route` that some other single IP address is connected to a particular network interface. + +Note that point-to-point links can be safely combined with other kinds of network connectivity -- there is no need to start the containers with `--net=none` if you want point-to-point links to be an addition to the container's normal networking instead of a replacement. + +A final permutation of this pattern is to create the point-to-point link between the Docker host and one container, which would allow the host to communicate with that one container on some single IP address and thus communicate "out-of-band" of the bridge that connects the other, more usual containers. But unless you have very specific networking needs that drive you to such a solution, it is probably far preferable to use `--icc=false` to lock down inter-container communication, as we explored earlier. diff --git a/docs/userguide/networking/dockernetworks.md b/docs/userguide/networking/dockernetworks.md new file mode 100644 index 0000000000..24825ac601 --- /dev/null +++ b/docs/userguide/networking/dockernetworks.md @@ -0,0 +1,490 @@ + + +# Understand Docker container networks + +To build web applications that act in concert but do so securely, use the Docker +networks feature. Networks, by definition, provide complete isolation for +containers. So, it is important to have control over the networks your +applications run on. Docker container networks give you that control. + +This section provides an overview of the default networking behavior that Docker +Engine delivers natively. It describes the type of networks created by default +and how to create your own, user--defined networks. It also describes the +resources required to create networks on a single host or across a cluster of +hosts. + +## Default Networks + +When you install Docker, it creates three networks automatically. You can list +these networks using the `docker network ls` command: + +``` +$ docker network ls +NETWORK ID NAME DRIVER +7fca4eb8c647 bridge bridge +9f904ee27bf5 none null +cf03ee007fb4 host host +``` + +Historically, these three networks are part of Docker's implementation. When +you run a container you can use the `--net` flag to specify which network you +want to run a container on. These three networks are still available to you. + +The `bridge` network represents the `docker0` network present in all Docker +installations. Unless you specify otherwise with the `docker run +--net=` option, the Docker daemon connects containers to this network +by default. You can see this bridge as part of a host's network stack by using +the `ifconfig` command on the host. + +``` +ubuntu@ip-172-31-36-118:~$ ifconfig +docker0 Link encap:Ethernet HWaddr 02:42:47:bc:3a:eb + inet addr:172.17.0.1 Bcast:0.0.0.0 Mask:255.255.0.0 + inet6 addr: fe80::42:47ff:febc:3aeb/64 Scope:Link + UP BROADCAST RUNNING MULTICAST MTU:9001 Metric:1 + RX packets:17 errors:0 dropped:0 overruns:0 frame:0 + TX packets:8 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:1100 (1.1 KB) TX bytes:648 (648.0 B) +``` + +The `none` network adds a container to a container-specific network stack. That container lacks a network interface. Attaching to such a container and looking at it's stack you see this: + +``` +ubuntu@ip-172-31-36-118:~$ docker attach nonenetcontainer + +/ # cat /etc/hosts +127.0.0.1 localhost +::1 localhost ip6-localhost ip6-loopback +fe00::0 ip6-localnet +ff00::0 ip6-mcastprefix +ff02::1 ip6-allnodes +ff02::2 ip6-allrouters +/ # ifconfig +lo Link encap:Local Loopback + inet addr:127.0.0.1 Mask:255.0.0.0 + inet6 addr: ::1/128 Scope:Host + UP LOOPBACK RUNNING MTU:65536 Metric:1 + RX packets:0 errors:0 dropped:0 overruns:0 frame:0 + TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) + +/ # +``` +>**Note**: You can detach from the container and leave it running with `CTRL-p CTRL-q`. + +The `host` network adds a container on the hosts network stack. You'll find the +network configuration inside the container is identical to the host. + +With the exception of the the `bridge` network, you really don't need to +interact with these default networks. While you can list and inspect them, you +cannot remove them. They are required by your Docker installation. However, you +can add your own user-defined networks and these you can remove when you no +longer need them. Before you learn more about creating your own networks, it is +worth looking at the `default` network a bit. + + +### The default bridge network in detail +The default bridge network is present on all Docker hosts. The `docker network inspect` + +``` +$ docker network inspect bridge +[ + { + "Name": "bridge", + "Id": "f7ab26d71dbd6f557852c7156ae0574bbf62c42f539b50c8ebde0f728a253b6f", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + { + "Subnet": "172.17.0.1/16", + "Gateway": "172.17.0.1" + } + ] + }, + "Containers": {}, + "Options": { + "com.docker.network.bridge.default_bridge": "true", + "com.docker.network.bridge.enable_icc": "true", + "com.docker.network.bridge.enable_ip_masquerade": "true", + "com.docker.network.bridge.host_binding_ipv4": "0.0.0.0", + "com.docker.network.bridge.name": "docker0", + "com.docker.network.driver.mtu": "9001" + } + } +] +``` +The Engine automatically creates a `Subnet` and `Gateway` to the network. +The `docker run` command automatically adds new containers to this network. + +``` +$ docker run -itd --name=container1 busybox +3386a527aa08b37ea9232cbcace2d2458d49f44bb05a6b775fba7ddd40d8f92c + +$ docker run -itd --name=container2 busybox +94447ca479852d29aeddca75c28f7104df3c3196d7b6d83061879e339946805c +``` + +Inspecting the `bridge` network again after starting two containers shows both newly launched containers in the network. Their ids show up in the container + +``` +$ docker network inspect bridge +{[ + { + "Name": "bridge", + "Id": "f7ab26d71dbd6f557852c7156ae0574bbf62c42f539b50c8ebde0f728a253b6f", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + { + "Subnet": "172.17.0.1/16", + "Gateway": "172.17.0.1" + } + ] + }, + "Containers": { + "3386a527aa08b37ea9232cbcace2d2458d49f44bb05a6b775fba7ddd40d8f92c": { + "EndpointID": "647c12443e91faf0fd508b6edfe59c30b642abb60dfab890b4bdccee38750bc1", + "MacAddress": "02:42:ac:11:00:02", + "IPv4Address": "172.17.0.2/16", + "IPv6Address": "" + }, + "94447ca479852d29aeddca75c28f7104df3c3196d7b6d83061879e339946805c": { + "EndpointID": "b047d090f446ac49747d3c37d63e4307be745876db7f0ceef7b311cbba615f48", + "MacAddress": "02:42:ac:11:00:03", + "IPv4Address": "172.17.0.3/16", + "IPv6Address": "" + } + }, + "Options": { + "com.docker.network.bridge.default_bridge": "true", + "com.docker.network.bridge.enable_icc": "true", + "com.docker.network.bridge.enable_ip_masquerade": "true", + "com.docker.network.bridge.host_binding_ipv4": "0.0.0.0", + "com.docker.network.bridge.name": "docker0", + "com.docker.network.driver.mtu": "9001" + } + } +] +``` + +The `docker network inspect` command above shows all the connected containers and their network resources on a given network. Containers in this default network are able to communicate with each other using IP addresses. Docker does not support automatic service discovery on the default bridge network. If you want to communicate with container names in this default bridge network, you must connect the containers via the legacy `docker run --link` option. + +You can `attach` to a running `container` and investigate its configuration: + +``` +$ docker attach container1 + +/ # ifconfig +ifconfig +eth0 Link encap:Ethernet HWaddr 02:42:AC:11:00:02 + inet addr:172.17.0.2 Bcast:0.0.0.0 Mask:255.255.0.0 + inet6 addr: fe80::42:acff:fe11:2/64 Scope:Link + UP BROADCAST RUNNING MULTICAST MTU:9001 Metric:1 + RX packets:16 errors:0 dropped:0 overruns:0 frame:0 + TX packets:8 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:1296 (1.2 KiB) TX bytes:648 (648.0 B) + +lo Link encap:Local Loopback + inet addr:127.0.0.1 Mask:255.0.0.0 + inet6 addr: ::1/128 Scope:Host + UP LOOPBACK RUNNING MTU:65536 Metric:1 + RX packets:0 errors:0 dropped:0 overruns:0 frame:0 + TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) +``` + +Then use `ping` for about 3 seconds to test the connectivity of the containers on this `bridge` network. + +``` +/ # ping -w3 172.17.0.3 +PING 172.17.0.3 (172.17.0.3): 56 data bytes +64 bytes from 172.17.0.3: seq=0 ttl=64 time=0.096 ms +64 bytes from 172.17.0.3: seq=1 ttl=64 time=0.080 ms +64 bytes from 172.17.0.3: seq=2 ttl=64 time=0.074 ms + +--- 172.17.0.3 ping statistics --- +3 packets transmitted, 3 packets received, 0% packet loss +round-trip min/avg/max = 0.074/0.083/0.096 ms +``` + +Finally, use the `cat` command to check the `container1` network configuration: + +``` +/ # cat /etc/hosts +172.17.0.2 3386a527aa08 +127.0.0.1 localhost +::1 localhost ip6-localhost ip6-loopback +fe00::0 ip6-localnet +ff00::0 ip6-mcastprefix +ff02::1 ip6-allnodes +ff02::2 ip6-allrouters +``` +To detach from a `container1` and leave it running use `CTRL-p CTRL-q`.Then, attach to `container2` and repeat these three commands. + +``` +$ docker attach container2 + +/ # ifconfig +eth0 Link encap:Ethernet HWaddr 02:42:AC:11:00:03 + inet addr:172.17.0.3 Bcast:0.0.0.0 Mask:255.255.0.0 + inet6 addr: fe80::42:acff:fe11:3/64 Scope:Link + UP BROADCAST RUNNING MULTICAST MTU:9001 Metric:1 + RX packets:15 errors:0 dropped:0 overruns:0 frame:0 + TX packets:13 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:1166 (1.1 KiB) TX bytes:1026 (1.0 KiB) + +lo Link encap:Local Loopback + inet addr:127.0.0.1 Mask:255.0.0.0 + inet6 addr: ::1/128 Scope:Host + UP LOOPBACK RUNNING MTU:65536 Metric:1 + RX packets:0 errors:0 dropped:0 overruns:0 frame:0 + TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) + +/ # ping -w3 172.17.0.2 +PING 172.17.0.2 (172.17.0.2): 56 data bytes +64 bytes from 172.17.0.2: seq=0 ttl=64 time=0.067 ms +64 bytes from 172.17.0.2: seq=1 ttl=64 time=0.075 ms +64 bytes from 172.17.0.2: seq=2 ttl=64 time=0.072 ms + +--- 172.17.0.2 ping statistics --- +3 packets transmitted, 3 packets received, 0% packet loss +round-trip min/avg/max = 0.067/0.071/0.075 ms +/ # cat /etc/hosts +172.17.0.3 94447ca47985 +127.0.0.1 localhost +::1 localhost ip6-localhost ip6-loopback +fe00::0 ip6-localnet +ff00::0 ip6-mcastprefix +ff02::1 ip6-allnodes +ff02::2 ip6-allrouters +``` + +The default `docker0` bridge network supports the use of port mapping and `docker run --link` to allow communications between containers in the `docker0` network. These techniques are cumbersome to set up and prone to error. While they are still available to you as techniques, it is better to avoid them and define your own bridge networks instead. + +## User-defined networks + +You can create your own user-defined networks that better isolate containers. +Docker provides some default **network drivers** for use creating these +networks. You can create a new **bridge network** or **overlay network**. You +can also create a **network plugin** or **remote network** written to your own +specifications. + +You can create multiple networks. You can add containers to more than one +network. Containers can only communicate within networks but not across +networks. A container attached to two networks can communicate with member +containers in either network. + +The next few sections describe each of Docker's built-in network drivers in +greater detail. + +### A bridge network + +The easiest user-defined network to create is a `bridge` network. This network +is similar to the historical, default `docker0` network. There are some added +features and some old features that aren't available. + +``` +$ docker network create --driver bridge isolated_nw +c5ee82f76de30319c75554a57164c682e7372d2c694fec41e42ac3b77e570f6b + +$ docker network inspect isolated_nw +[ + { + "Name": "isolated_nw", + "Id": "c5ee82f76de30319c75554a57164c682e7372d2c694fec41e42ac3b77e570f6b", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": {}, + "Options": {} + } +] + +$ docker network ls +NETWORK ID NAME DRIVER +9f904ee27bf5 none null +cf03ee007fb4 host host +7fca4eb8c647 bridge bridge +c5ee82f76de3 isolated_nw bridge + +``` + +After you create the network, you can launch containers on it using the `docker run --net=` option. + +``` +$ docker run --net=isolated_nw -itd --name=container3 busybox +885b7b4f792bae534416c95caa35ba272f201fa181e18e59beba0c80d7d77c1d + +$ docker network inspect isolated_nw +[ + { + "Name": "isolated_nw", + "Id": "c5ee82f76de30319c75554a57164c682e7372d2c694fec41e42ac3b77e570f6b", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": { + "885b7b4f792bae534416c95caa35ba272f201fa181e18e59beba0c80d7d77c1d": { + "EndpointID": "514e1b419074397ea92bcfaa6698d17feb62db49d1320a27393b853ec65319c3", + "MacAddress": "02:42:ac:15:00:02", + "IPv4Address": "172.21.0.2/16", + "IPv6Address": "" + } + }, + "Options": {} + } +] +``` + +The containers you launch into this network must reside on the same Docker host. +Each container in the network can immediately communicate with other containers +in the network. Though, the network itself isolates the containers from external +networks. + +![An isolated network](images/bridge_network.png) + +Within a user-defined bridge network, linking is not supported. You can +expose and publish container ports on containers in this network. This is useful +if you want make a portion of the `bridge` network available to an outside +network. + +![Bridge network](images/network_access.png) + +A bridge network is useful in cases where you want to run a relatively small +network on a single host. You can, however, create significantly larger networks +by creating an `overlay` network. + + +### An overlay network + +Docker's `overlay` network driver supports multi-host networking natively +out-of-the-box. This support is accomplished with the help of `libnetwork`, a +built-in VXLAN-based overlay network driver, and Docker's `libkv` library. + +The `overlay` network requires a valid key-value store service. Currently, +Docker's supports Consul, Etcd, and ZooKeeper (Distributed store). Before +creating a network you must install and configure your chosen key-value store +service. The Docker hosts that you intend to network and the service must be +able to communicate. + +![Key-value store](images/key_value.png) + +Each host in the network must run a Docker Engine instance. The easiest way to +provision the hosts are with Docker Machine. + +![Engine on each host](images/engine_on_net.png) + +You should open the following ports between each of your hosts. + +| Protocol | Port | Description | +|----------|------|-----------------------| +| udp | 4789 | Data plane (VXLAN) | +| tcp/udp | 7946 | Control plane | + +Your key-value store service may require additional ports. +Check your vendor's documentation and open any required ports. + +Once you have several machines provisioned, you can use Docker Swarm to quickly +form them into a swarm which includes a discovery service as well. + +To create an overlay network, you configure options on the `daemon` on each +Docker Engine for use with `overlay` network. There are two options to set: + +| Option | Description | +|-----------------------------------------------|-------------------------------------------------------------| +| `--cluster-store=PROVIDER://URL` | Describes the location of the KV service. | +| `--cluster-advertise=HOST_IP|HOST_IFACE:PORT` | The IP address or interface of the HOST used for clustering | + +Create an `overlay` network on one of the machines in the Swarm. + + $ docker network create --driver overlay my-multi-host-network + +This results in a single network spanning multiple hosts. An `overlay` network +provides complete isolation for the containers. + +![An overlay network](images/overlay_network.png) + +Then, on each host, launch containers making sure to specify the network name. + + $ docker run -itd --net=my-multi-host-network busybox + +Once connected, each container has access to all the containers in the network +regardless of which Docker host the container was launched on. + +![Published port](images/overlay-network-final.png) + +If you would like to try this for yourself, see the [Getting started for +overlay](get-started-overlay.md). + +### Custom network plugin + +If you like, you can write your own network driver plugin. A network +driver plugin makes use of Docker's plugin infrastructure. In this +infrastructure, a plugin is a process running on the same Docker host as the +Docker `daemon`. + +Network plugins follow the same restrictions and installation rules as other +plugins. All plugins make use of the plugin API. They have a lifecycle that +encompasses installation, starting, stopping and activation. + +Once you have created and installed a custom network driver, you use it like the +built-in network drivers. For example: + + $ docker network create --driver weave mynet + +You can inspect it, add containers too and from it, and so forth. Of course, +different plugins may make use of different technologies or frameworks. Custom +networks can include features not present in Docker's default networks. For more +information on writing plugins, see [Extending Docker](../../extend) and +[Writing a network driver plugin](../../extend/plugins_network.md). + +## Legacy links + +Before the Docker network feature, you could use the Docker link feature to +allow containers to discover each other and securely transfer information about +one container to another container. With the introduction of Docker networks, +you can still create links but they are only supported on the default `bridge` +network named `bridge` and appearing in your network stack as `docker0`. + +While links are still supported in this limited capacity, you should avoid them +in preference of Docker networks. The link feature is expected to be deprecated +and removed in a future release. + +## Related information + +- [Work with network commands](work-with-networks.md) +- [Get started with multi-host networking](get-started-overlay.md) +- [Managing Data in Containers](../dockervolumes.md) +- [Docker Machine overview](https://docs.docker.com/machine) +- [Docker Swarm overview](https://docs.docker.com/swarm) +- [Investigate the LibNetwork project](https://github.com/docker/libnetwork) diff --git a/docs/userguide/networking/get-started-overlay.md b/docs/userguide/networking/get-started-overlay.md new file mode 100644 index 0000000000..708684e2da --- /dev/null +++ b/docs/userguide/networking/get-started-overlay.md @@ -0,0 +1,353 @@ + + +# Get started with multi-host networking + +This article uses an example to explain the basics of creating a multi-host +network. Docker Engine supports multi-host networking out-of-the-box through the +`overlay` network driver. Unlike `bridge` networks, overlay networks require +some pre-existing conditions before you can create one. These conditions are: + +* A host with a 3.16 kernel version or higher. +* Access to a key-value store. Docker supports Consul, Etcd, and ZooKeeper (Distributed store) key-value stores. +* A cluster of hosts with connectivity to the key-value store. +* A properly configured Engine `daemon` on each host in the cluster. + +Though Docker Machine and Docker Swarm are not mandatory to experience Docker +multi-host networking, this example uses them to illustrate how they are +integrated. You'll use Machine to create both the key-value store +server and the host cluster. This example creates a Swarm cluster. + +## Prerequisites + +Before you begin, make sure you have a system on your network with the latest +version of Docker Engine and Docker Machine installed. The example also relies +on VirtualBox. If you installed on a Mac or Windows with Docker Toolbox, you +have all of these installed already. + +If you have not already done so, make sure you upgrade Docker Engine and Docker +Machine to the latest versions. + + +## Step 1: Set up a key-value store + +An overlay network requires a key-value store. The key-value store holds +information about the network state which includes discovery, networks, +endpoints, IP addresses, and more. Docker supports Consul, Etcd, and ZooKeeper +key-value stores. This example uses Consul. + +1. Log into a system prepared with the prerequisite Docker Engine, Docker Machine, and VirtualBox software. + +2. Provision a VirtualBox machine called `mh-keystore`. + + $ docker-machine create -d virtualbox mh-keystore + + When you provision a new machine, the process adds Docker Engine to the + host. This means rather than installing Consul manually, you can create an + instance using the [consul image from Docker + Hub](https://hub.docker.com/r/progrium/consul/). You'll do this in the next step. + +3. Start a `progrium/consul` container running on the `mh-keystore` machine. + + $ docker $(docker-machine config mh-keystore) run -d \ + -p "8500:8500" \ + -h "consul" \ + progrium/consul -server -bootstrap + + A bash expansion `$(docker-machine config mh-keystore)` is used to pass the + connection configuration to the `docker run` command. The client starts a + `progrium/consul` image running in the `mh-keystore` machine. The server is + called `consul` and is listening on port `8500`. + +4. Set your local environment to the `mh-keystore` machine. + + $ eval "$(docker-machine env mh-keystore)" + +5. Run the `docker ps` command to see the `consul` container. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 4d51392253b3 progrium/consul "/bin/start -server -" 25 minutes ago Up 25 minutes 53/tcp, 53/udp, 8300-8302/tcp, 0.0.0.0:8500->8500/tcp, 8400/tcp, 8301-8302/udp admiring_panini + +Keep your terminal open and move onto the next step. + + +## Step 2: Create a Swarm cluster + +In this step, you use `docker-machine` to provision the hosts for your network. +At this point, you won't actually create the network. You'll create several +machines in VirtualBox. One of the machines will act as the Swarm master; +you'll create that first. As you create each host, you'll pass the Engine on +that machine options that are needed by the `overlay` network driver. + +1. Create a Swarm master. + + $ docker-machine create \ + -d virtualbox \ + --swarm --swarm-master \ + --swarm-discovery="consul://$(docker-machine ip mh-keystore):8500" \ + --engine-opt="cluster-store=consul://$(docker-machine ip mh-keystore):8500" \ + --engine-opt="cluster-advertise=eth1:2376" \ + mhs-demo0 + + At creation time, you supply the Engine `daemon` with the ` --cluster-store` option. This option tells the Engine the location of the key-value store for the `overlay` network. The bash expansion `$(docker-machine ip mh-keystore)` resolves to the IP address of the Consul server you created in "STEP 1". The `--cluster-advertise` option advertises the machine on the network. + +2. Create another host and add it to the Swarm cluster. + + $ docker-machine create -d virtualbox \ + --swarm \ + --swarm-discovery="consul://$(docker-machine ip mh-keystore):8500" \ + --engine-opt="cluster-store=consul://$(docker-machine ip mh-keystore):8500" \ + --engine-opt="cluster-advertise=eth1:2376" \ + mhs-demo1 + +3. List your machines to confirm they are all up and running. + + $ docker-machine ls + NAME ACTIVE DRIVER STATE URL SWARM + default - virtualbox Running tcp://192.168.99.100:2376 + mh-keystore * virtualbox Running tcp://192.168.99.103:2376 + mhs-demo0 - virtualbox Running tcp://192.168.99.104:2376 mhs-demo0 (master) + mhs-demo1 - virtualbox Running tcp://192.168.99.105:2376 mhs-demo0 + +At this point you have a set of hosts running on your network. You are ready to create a multi-host network for containers using these hosts. + +Leave your terminal open and go onto the next step. + +## Step 3: Create the overlay Network + +To create an overlay network + +1. Set your docker environment to the Swarm master. + + $ eval $(docker-machine env --swarm mhs-demo0) + + Using the `--swarm` flag with `docker-machine` restricts the `docker` commands to Swarm information alone. + +2. Use the `docker info` command to view the Swarm. + + $ docker info + Containers: 3 + Images: 2 + Role: primary + Strategy: spread + Filters: affinity, health, constraint, port, dependency + Nodes: 2 + mhs-demo0: 192.168.99.104:2376 + └ Containers: 2 + └ Reserved CPUs: 0 / 1 + └ Reserved Memory: 0 B / 1.021 GiB + └ Labels: executiondriver=native-0.2, kernelversion=4.1.10-boot2docker, operatingsystem=Boot2Docker 1.9.0-rc1 (TCL 6.4); master : 4187d2c - Wed Oct 14 14:00:28 UTC 2015, provider=virtualbox, storagedriver=aufs + mhs-demo1: 192.168.99.105:2376 + └ Containers: 1 + └ Reserved CPUs: 0 / 1 + └ Reserved Memory: 0 B / 1.021 GiB + └ Labels: executiondriver=native-0.2, kernelversion=4.1.10-boot2docker, operatingsystem=Boot2Docker 1.9.0-rc1 (TCL 6.4); master : 4187d2c - Wed Oct 14 14:00:28 UTC 2015, provider=virtualbox, storagedriver=aufs + CPUs: 2 + Total Memory: 2.043 GiB + Name: 30438ece0915 + + From this information, you can see that you are running three containers and two images on the Master. + +3. Create your `overlay` network. + + $ docker network create --driver overlay my-net + + You only need to create the network on a single host in the cluster. In this case, you used the Swarm master but you could easily have run it on any host in the cluster. + +4. Check that the network is running: + + $ docker network ls + NETWORK ID NAME DRIVER + 412c2496d0eb mhs-demo1/host host + dd51763e6dd2 mhs-demo0/bridge bridge + 6b07d0be843f my-net overlay + b4234109bd9b mhs-demo0/none null + 1aeead6dd890 mhs-demo0/host host + d0bb78cbe7bd mhs-demo1/bridge bridge + 1c0eb8f69ebb mhs-demo1/none null + + As you are in the Swarm master environment, you see all the networks on all + the Swarm agents: the default networks on each engine and the single overlay + network. Notice that each `NETWORK ID` is unique. + +5. Switch to each Swarm agent in turn and list the networks. + + $ eval $(docker-machine env mhs-demo0) + $ docker network ls + NETWORK ID NAME DRIVER + 6b07d0be843f my-net overlay + dd51763e6dd2 bridge bridge + b4234109bd9b none null + 1aeead6dd890 host host + $ eval $(docker-machine env mhs-demo1) + $ docker network ls + NETWORK ID NAME DRIVER + d0bb78cbe7bd bridge bridge + 1c0eb8f69ebb none null + 412c2496d0eb host host + 6b07d0be843f my-net overlay + + Both agents report they have the `my-net` network with the `6b07d0be843f` ID. + You now have a multi-host container network running! + +## Step 4: Run an application on your Network + +Once your network is created, you can start a container on any of the hosts and it automatically is part of the network. + +1. Point your environment to the Swarm master. + + $ eval $(docker-machine env --swarm mhs-demo0) + +2. Start an Nginx web server on the `mhs-demo0` instance. + + $ docker run -itd --name=web --net=my-net --env="constraint:node==mhs-demo0" nginx + +4. Run a BusyBox instance on the `mhs-demo1` instance and get the contents of the Nginx server's home page. + + $ docker run -it --rm --net=my-net --env="constraint:node==mhs-demo1" busybox wget -O- http://web + Unable to find image 'busybox:latest' locally + latest: Pulling from library/busybox + ab2b8a86ca6c: Pull complete + 2c5ac3f849df: Pull complete + Digest: sha256:5551dbdfc48d66734d0f01cafee0952cb6e8eeecd1e2492240bf2fd9640c2279 + Status: Downloaded newer image for busybox:latest + Connecting to web (10.0.0.2:80) + + + + Welcome to nginx! + + + +

Welcome to nginx!

+

If you see this page, the nginx web server is successfully installed and + working. Further configuration is required.

+ +

For online documentation and support please refer to + nginx.org.
+ Commercial support is available at + nginx.com.

+ +

Thank you for using nginx.

+ + + - 100% |*******************************| 612 0:00:00 ETA + +## Step 5: Check external connectivity + +As you've seen, Docker's built-in overlay network driver provides out-of-the-box +connectivity between the containers on multiple hosts within the same network. +Additionally, containers connected to the multi-host network are automatically +connected to the `docker_gwbridge` network. This network allows the containers +to have external connectivity outside of their cluster. + +1. Change your environment to the Swarm agent. + + $ eval $(docker-machine env mhs-demo1) + +2. View the `docker_gwbridge` network, by listing the networks. + + $ docker network ls + NETWORK ID NAME DRIVER + 6b07d0be843f my-net overlay + dd51763e6dd2 bridge bridge + b4234109bd9b none null + 1aeead6dd890 host host + e1dbd5dff8be docker_gwbridge bridge + +3. Repeat steps 1 and 2 on the Swarm master. + + $ eval $(docker-machine env mhs-demo0) + $ docker network ls + NETWORK ID NAME DRIVER + 6b07d0be843f my-net overlay + d0bb78cbe7bd bridge bridge + 1c0eb8f69ebb none null + 412c2496d0eb host host + 97102a22e8d2 docker_gwbridge bridge + +2. Check the Nginx container's network interfaces. + + $ docker exec web ip addr + 1: lo: mtu 65536 qdisc noqueue state UNKNOWN group default + link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 + inet 127.0.0.1/8 scope host lo + valid_lft forever preferred_lft forever + inet6 ::1/128 scope host + valid_lft forever preferred_lft forever + 22: eth0: mtu 1450 qdisc noqueue state UP group default + link/ether 02:42:0a:00:09:03 brd ff:ff:ff:ff:ff:ff + inet 10.0.9.3/24 scope global eth0 + valid_lft forever preferred_lft forever + inet6 fe80::42:aff:fe00:903/64 scope link + valid_lft forever preferred_lft forever + 24: eth1: mtu 1500 qdisc noqueue state UP group default + link/ether 02:42:ac:12:00:02 brd ff:ff:ff:ff:ff:ff + inet 172.18.0.2/16 scope global eth1 + valid_lft forever preferred_lft forever + inet6 fe80::42:acff:fe12:2/64 scope link + valid_lft forever preferred_lft forever + + The `eth0` interface represents the container interface that is connected to + the `my-net` overlay network. While the `eth1` interface represents the + container interface that is connected to the `docker_gwbridge` network. + +## Step 6: Extra Credit with Docker Compose + +You can try starting a second network on your existing Swarm cluster using Docker Compose. + +1. If you haven't already, install Docker Compose. + +2. Change your environment to the Swarm master. + + $ eval $(docker-machine env --swarm mhs-demo0) + +3. Create a `docker-compose.yml` file. + +4. Add the following content to the file. + + web: + image: bfirsh/compose-mongodb-demo + environment: + - "MONGO_HOST=counter_mongo_1" + - "constraint:node==mhs-demo0" + ports: + - "80:5000" + mongo: + image: mongo + +5. Save and close the file. + +6. Start the application with Compose. + + $ docker-compose --x-networking --project-name=counter up -d + +7. Get the Swarm master's IP address. + + $ docker-machine ip mhs-demo0 + +8. Put the IP address into your web browser. + + Upon success, the browser should display the web application. + +## Related information + +* [Understand Docker container networks](dockernetworks.md) +* [Work with network commands](work-with-networks.md) +* [Docker Swarm overview](https://docs.docker.com/swarm) +* [Docker Machine overview](https://docs.docker.com/machine) diff --git a/docs/userguide/networking/images/bridge_network.gliffy b/docs/userguide/networking/images/bridge_network.gliffy new file mode 100644 index 0000000000..d113f4fb51 --- /dev/null +++ b/docs/userguide/networking/images/bridge_network.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":378,"height":236,"nodeIndex":146,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":7,"y":5.1999969482421875},"max":{"x":378,"y":235.1428540910994}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":196.0,"y":100.69999694824219,"rotation":0.0,"id":140,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":61,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"


","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":149.0,"y":154.96785409109907,"rotation":0.0,"id":114,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":16,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":95,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":5,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":96,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":13,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":99,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":99,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":97,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":10,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":98,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":7,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":99,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":4,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":112,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":15,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":226.0,"y":155.96785409109907,"rotation":0.0,"id":115,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":34,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":116,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":22,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":117,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":31,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":120,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":120,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":118,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":28,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":119,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":25,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":120,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":121,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":33,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container3

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":72.0,"y":154.96785409109907,"rotation":0.0,"id":122,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":51,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":123,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":39,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":124,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":48,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":127,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":127,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":125,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":45,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":126,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":42,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":127,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":37,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":128,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":50,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":81.38636363636368,"y":79.1428540910994,"rotation":0.0,"id":129,"width":291.1363636363638,"height":156.0,"uid":"com.gliffy.shape.iphone.iphone_ios7.icons_glyphs.glyph_cloud","order":51,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.iphone.iphone_ios7.icons_glyphs.glyph_cloud","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#929292","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":157.0,"y":124.19999694824219,"rotation":0.0,"id":130,"width":150.0,"height":27.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":52,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

isolated_nw

 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":15.0,"y":5.1999969482421875,"rotation":0.0,"id":134,"width":73.116,"height":102.32,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":56,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":53.0,"y":57.19999694824219,"rotation":0.0,"id":136,"width":119.0,"height":45.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":57,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":134,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":6.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[35.116,-0.8400000000000034],[89.0,-0.8400000000000034],[89.0,57.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":5.0,"y":116.19999694824219,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":63,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Docker Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":66}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#999999","strokeWidth":6}},"textStyles":{"global":{"bold":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":[],"lastSerialized":1445538566750},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/bridge_network.png b/docs/userguide/networking/images/bridge_network.png new file mode 100644 index 0000000000000000000000000000000000000000..314c9f7963ee006a5775a1109d8e99b172c0da91 GIT binary patch literal 15878 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 z)+O(c)p>4yK0tIb-k|gVy#o3nfrcsa#4^j5K=)QA<}J`6aVRfcK?zv8Mi2_container2container3container1isolated_nwDockerHost \ No newline at end of file diff --git a/docs/userguide/networking/images/engine_on_net.gliffy b/docs/userguide/networking/images/engine_on_net.gliffy new file mode 100644 index 0000000000..2fe97eca9f --- /dev/null +++ b/docs/userguide/networking/images/engine_on_net.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":277,"height":209,"nodeIndex":174,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":3,"y":3.1889969482422202},"max":{"x":277,"y":208.1999969482422}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":223.0,"y":117.3854006442422,"rotation":0.0,"id":171,"width":26.70555282692303,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":21,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":1.0,"y":93.51999694824218,"rotation":0.0,"id":152,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":4,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":134,"width":42.8749022673964,"height":60.0,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":1,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":96.0,"y":130.51999694824218,"rotation":0.0,"id":153,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":7,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":154,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":155,"width":42.8749022673964,"height":60.0,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":6,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":197.0,"y":99.35999694824216,"rotation":0.0,"id":156,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":12,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":157,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":158,"width":42.8749022673964,"height":60.0,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":11,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":114.0,"y":3.1889969482422202,"rotation":0.0,"id":160,"width":48.773475410240856,"height":39.0,"uid":"com.gliffy.shape.cisco.cisco_v1.storage.relational_database","order":15,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.storage.relational_database","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#02709F","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":163,"width":88.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Key-value store

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":171.0,"y":25.199996948242188,"rotation":0.0,"id":165,"width":72.0,"height":73.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":18,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":158,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-32.613262294879576,16.989000000000033],[70.4374511336982,74.15999999999997]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":141.0,"y":37.19999694824219,"rotation":0.0,"id":168,"width":4.0,"height":91.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":19,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":155,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-2.6132622948795756,4.989000000000033],[-0.5625488663017961,93.32]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":136.0,"y":42.19999694824219,"rotation":0.0,"id":169,"width":86.0,"height":50.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":20,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":134,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.3867377051204244,-0.010999999999967258],[-90.5625488663018,51.31999999999999]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":122.0,"y":150.3854006442422,"rotation":0.0,"id":172,"width":26.70555282692303,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":22,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":27.0,"y":113.3854006442422,"rotation":0.0,"id":173,"width":26.70555282692303,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":23,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":24}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#999999","strokeWidth":2,"dashStyle":"1.0,1.0"}},"textStyles":{"global":{"bold":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.custom.confluence.c20f4a380e3cee362007f9e62694d34d947f28ed4263c0702b3dd72d9801532a"],"lastSerialized":1445555725710},"embeddedResources":{"index":1,"resources":[{"id":0,"mimeType":"image/svg+xml","data":"\n\n \n logo copy\n Created with Sketch.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","width":59.29392246992643,"height":42.185403696,"x":0.4429050300735753,"y":0.7077644040000006}]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/engine_on_net.png b/docs/userguide/networking/images/engine_on_net.png new file mode 100644 index 0000000000000000000000000000000000000000..a79aa44c8e8963fc39ca10750793c3ac26861352 GIT binary patch literal 14032 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 Uw<+&|H`S0Ja;mab((i-+8=gxczW@LL literal 0 HcmV?d00001 diff --git a/docs/userguide/networking/images/engine_on_net.svg b/docs/userguide/networking/images/engine_on_net.svg new file mode 100644 index 0000000000..a746370991 --- /dev/null +++ b/docs/userguide/networking/images/engine_on_net.svg @@ -0,0 +1 @@ +HostHostHostKey-valuestore \ No newline at end of file diff --git a/docs/userguide/networking/images/key_value.gliffy b/docs/userguide/networking/images/key_value.gliffy new file mode 100644 index 0000000000..4e632ef3e2 --- /dev/null +++ b/docs/userguide/networking/images/key_value.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":277,"height":209,"nodeIndex":171,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":3,"y":3.1889969482422202},"max":{"x":277,"y":208.1999969482422}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":1.0,"y":93.51999694824218,"rotation":0.0,"id":152,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":4,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":134,"width":42.8749022673964,"height":60.0,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":1,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":96.0,"y":130.51999694824218,"rotation":0.0,"id":153,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":5,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":154,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":155,"width":42.8749022673964,"height":60.0,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":7,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":197.0,"y":99.35999694824216,"rotation":0.0,"id":156,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":10,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":157,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":158,"width":42.8749022673964,"height":60.0,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":12,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":114.0,"y":3.1889969482422202,"rotation":0.0,"id":160,"width":48.773475410240856,"height":39.0,"uid":"com.gliffy.shape.cisco.cisco_v1.storage.relational_database","order":16,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.storage.relational_database","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#02709F","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":163,"width":88.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Key-value store

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":171.0,"y":25.199996948242188,"rotation":0.0,"id":165,"width":72.0,"height":73.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":17,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":158,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-32.613262294879576,16.989000000000033],[70.4374511336982,74.15999999999997]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":141.0,"y":37.19999694824219,"rotation":0.0,"id":168,"width":4.0,"height":91.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":20,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":155,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-2.6132622948795756,4.989000000000033],[-0.5625488663017961,93.32]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":136.0,"y":42.19999694824219,"rotation":0.0,"id":169,"width":86.0,"height":50.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":21,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":134,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.3867377051204244,-0.010999999999967258],[-90.5625488663018,51.31999999999999]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":22}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#999999","strokeWidth":2,"dashStyle":"1.0,1.0"}},"textStyles":{"global":{"bold":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":[],"lastSerialized":1445552948967},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/key_value.png b/docs/userguide/networking/images/key_value.png new file mode 100644 index 0000000000000000000000000000000000000000..c4056f1145730f5afb1989e659ffe29ec7824d5c GIT binary patch literal 12898 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 \ No newline at end of file diff --git a/docs/userguide/networking/images/network_access.gliffy b/docs/userguide/networking/images/network_access.gliffy new file mode 100644 index 0000000000..b1a1910d39 --- /dev/null +++ b/docs/userguide/networking/images/network_access.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":437,"height":368,"nodeIndex":178,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":5,"y":1.1999969482421875},"max":{"x":437,"y":367.5199969482422}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":126.38636363636371,"y":74.1428540910994,"rotation":0.0,"id":129,"width":291.1363636363638,"height":149.0,"uid":"com.gliffy.shape.iphone.iphone_ios7.icons_glyphs.glyph_cloud","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.iphone.iphone_ios7.icons_glyphs.glyph_cloud","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#929292","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":199.0,"y":150.96785409109907,"rotation":0.0,"id":114,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":17,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":95,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":5,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":96,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":14,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":99,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":99,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":97,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":11,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":98,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":8,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":99,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":112,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":16,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":209.0,"y":284.96785409109907,"rotation":0.0,"id":115,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":34,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":116,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":22,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":117,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":31,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":120,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":120,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.178571428571388],[1.8600000000000136,28.285714285714334]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":118,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":28,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":119,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":25,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":120,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":20,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":121,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":33,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

external_container

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":122.0,"y":150.96785409109907,"rotation":0.0,"id":122,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":51,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":123,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":39,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":124,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":48,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":127,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":127,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":125,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":45,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":126,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":42,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":127,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":37,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":128,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":50,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":192.0,"y":120.19999694824219,"rotation":0.0,"id":130,"width":150.0,"height":27.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":52,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

isolated_nw

 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":65.0,"y":1.1999969482421875,"rotation":0.0,"id":134,"width":73.116,"height":102.32,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":53,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":103.0,"y":53.19999694824219,"rotation":0.0,"id":136,"width":119.0,"height":45.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":54,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":134,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":6.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[35.115999999999985,-0.8400000000000034],[87.0,-0.8400000000000034],[87.0,55.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":20.0,"y":16.699996948242188,"rotation":0.0,"id":140,"width":150.0,"height":1.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":55,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"


","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":55.0,"y":112.19999694824219,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":56,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Docker Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":160.0,"y":179.0,"rotation":0.0,"id":145,"width":10.0,"height":10.0,"uid":"com.gliffy.shape.basic.basic_v1.default.ellipse","order":57,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":1.0,"strokeColor":"#00ffff","fillColor":"#00ffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":31.999999999999993,"y":189.1999969482422,"rotation":0.0,"id":147,"width":73.116,"height":102.32,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":58,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":346.0,"y":265.1999969482422,"rotation":0.0,"id":149,"width":73.116,"height":102.32,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":59,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":378.0,"y":276.1999969482422,"rotation":0.0,"id":150,"width":56.0,"height":26.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":60,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":149,"py":0.5,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":120,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-32.0,40.15999999999997],[-47.5,40.15999999999997],[-47.5,28.0],[-63.0,28.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":250.0,"y":282.1999969482422,"rotation":0.0,"id":152,"width":84.0,"height":96.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":61,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":120,"py":0.0,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":145,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#666666","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[3.0,7.267857142857167],[3.0,-42.96606990269251],[-85.0,-42.96606990269251],[-85.0,-93.19999694824219]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":103.0,"y":242.1999969482422,"rotation":0.0,"id":153,"width":54.0,"height":53.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":62,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":147,"py":0.5,"px":1.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":145,"py":0.5,"px":0.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[2.1159999999999854,-1.8400000000000034],[29.557999999999993,-1.8400000000000034],[29.557999999999993,-58.19999694824219],[57.0,-58.19999694824219]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":250.0,"y":286.0,"rotation":0.0,"id":154,"width":10.0,"height":10.0,"uid":"com.gliffy.shape.basic.basic_v1.default.ellipse","order":63,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":1.0,"strokeColor":"#00ffff","fillColor":"#00ffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":278.0,"y":149.96785409109907,"rotation":0.0,"id":155,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":64,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":156,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":69,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":157,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":78,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":158,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":75,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":159,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":72,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":160,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":67,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":161,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":80,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container3

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":3.0,"y":296.1999969482422,"rotation":0.0,"id":162,"width":133.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":81,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":5,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

external host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":337.0,"y":21.199996948242188,"rotation":0.0,"id":176,"width":98.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":84,"lockAspectRatio":false,"lockShape":false,"children":[{"x":13.0,"y":0.0,"rotation":0.0,"id":174,"width":85.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":83,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":5,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

published port

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":null},{"x":0.0,"y":3.8000030517578125,"rotation":0.0,"id":173,"width":10.0,"height":10.0,"uid":"com.gliffy.shape.basic.basic_v1.default.ellipse","order":82,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.ellipse.basic_v1","strokeWidth":1.0,"strokeColor":"#00ffff","fillColor":"#00ffff","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":85}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#666666","strokeWidth":2}},"textStyles":{"global":{"bold":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":[],"lastSerialized":1445536836098},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/network_access.png b/docs/userguide/networking/images/network_access.png new file mode 100644 index 0000000000000000000000000000000000000000..d8bf6319dd97e81192a0ec0da138caa837df2f06 GIT binary patch literal 30649 zcmb@ubySpJ*fuJult>GbGIV!$&CuN~AV_yN2uckD($XD+(j6ioEiE0=-5uw_-}`=l zoORas*Kz4$E!NEQ?0v`H*L~gB?I%@bIV^M%^k>hWVL`ys>d&4b^a1}uU!VfN5x?8@ zefEs<8AMt_)6018>vJyxt((VohBI7A3^W?Fk~7*I2Kq>pZ`l|ZRTp&^@NC=82Lo** z&x$fzqVKu6y5C3hpG!(oqP?OdcmaY!*B<>w+)vsKVM4BlgY)wzartD->x2wQOSi7kFU(%A2Nr0^RTKmFHMU*3*oL zTwLZ_b0(EcvMZTVb!T{Zljs_#p4A2RHkwag3l>)sr?ff#dgFAhEZj^#vZ_rsRPeK= zt1KB?`!R6c*7m#2G=jkm@oW)wW~);Wi@ic#ZV){sIx-9q5rT1`ZEqw}iaos&Kf?QW zbB_~4U%2Vh3YuDqZ$KbQ&kTkA59M@ba0P|_56_W-AN8KGRqHD zrNuXrwO0B!HWv( z$fFL)-YJ-j6$9&tL=4Uj5+7SL(rMfl-uFiE|E|6hym<@?MTB?K6cN8 zPAky7kCw5*VB{}JVaQ%cw|Hm&-1y;pM^`nsvA>;5O%-L}5JRuXX;rMCDy5B~LJ0$~ zj?N-r9bLXR3LeB8%)e@fTKmUye7`tM5w#8U`YK?E2uuB)j8oc=76^oBbjn`(H016Vm{Xyz)bT0m7QsK;4uMi&$xNJY{#BQAU#UGFi{5R(JOEArd~8VQtgZSo4<> zl#5l_jg}i$?pjr{YzPea8)Sip2$^#T{y)}G-=rOF^(ih?W{J@K(mqmWF#BBzM4pz3 z&f1x+^?q6%*Z3Kg;_EkPsDKeY1`5mohrW1*f(#Snvr%xSaq!|A*S`EPvNeUSuSn?h z*C18b$dn>lWosHGFe~%(Az$KZr^;ELB?=7T2!DX#Gh%L#J+Sx%un6yX;On;3@7t=xxR((Q;yQb`2E4`DP{gxlc~Z0i0Hp zUTQf)CB0|3*vU$Fe)#$Muwo}{-eoW?tD?hBN5E2*Z{Am*Gv&&3c(Vtg?-U0->#mb; z^t5GUV9Uy$eFwmcb;jk+I#}rFR@2YB8JEhwu1|C>IE~a;_%+tOh-3S8-oO-`-wW$Q zc=D7qdYCY1+ZYQQyXzeW?_8RQ+#4>UxZQ9j+Ov;r8$v}dw_}?NX-nX}Bi9RMW=zmC zd0qi9kTD_B!O)MO@q~}z9UH$E5!L4_Bu)|sEF%H?O{0f#gGy#Ma^($@J*_p-Z>^)Ot@{Z(yP1I@$pF@Sf&aoAym;nOSOGz-;cz)9 z<~QVHSmdsWj%_qMCOaO%KutMNp|sI-E}?r0(BdF*b;@lILkv*p@%Lm~T;SBn13ZTU zLxkk1L`~oU#|czJoRR^G5B@m+j*aLkyJP_ep#vY0%_0OIa+QiGARy3icQSDNH%{!W zu<%`EwUE~lrECmIfoStqZj{qu>!tbLpYKY>2y=}aX}0VxYv4*a>>i7l6ImgNS;Eb& zM#p}Otj1+szQ%rzaC>{(M~mgwka8QjPdk3adPxv>g^&e9z^Rz<%Vh12RU_&_jRQ{X z%L;0i=J;Fe$=schwm-$l2fDNs+#vL;3Pe3Uy@rcf+vEGoCF(&-k#w$_larI*)$di@ z4i{VdYy~zmT%ATlE={+7=NKC~Dk)*1z9h9~0u?Exe|%2v)nNG2uX?j|288D<-8w z_bTe}dFF|Dh1FsFOzoL($iy$Fe59A$7t?dz`T5(oZ;!4wv;LlqtLXIJ{iS$R?L9qA z=X31&qGMdLv*h(R#tZO^xKpz}EKcl!zqGXUXeENeyz3*@4(a2~bUWiWHiJ6Fd$GrW z8Ovm|;S7PuPoLB_M_hLnn)x!lR?+4?m;AlXM&%|2%8gs~^(xxvpKKNjiS5}hy69FA z!_O{Wg)-b1VSSR2kMn4_DwvFsgarvZx{+=KBt-aY@f6-Po&7N`E~)6U#I zBt&V^Fl7xgm?yo#e#W=UtwbOFnnSX4CEc;D^JIO%c~VQqY`jpZ;d&$8`F6jaPgk|( z=F0I0Jq?YF#BP#-L#Kv{Ncdsf?aS2ERDQoJr_kF32hFL<^75bIM8?J0+J=VF9PfJQ z!K2;szgiz|cCXeFR9+Die?r5fEq3L1T7DKQ_TXh%(bL^+wlSF6@9(?dK3(#6SnSd7 z-1YJP^6#8uyFET^+9Xh9(eG4=S-%F1AV5tmH5n5Zr?dHZGQjq3EFV%DL%^iXozY&{ zyEju!(Bas6u8p!@JuHYpCg^r_VCC(VC_aV)GaT?5H%O%yGJR<{tr*?=XU)1En!(GB zn%v$bi!iLXa-lO{qep2YDWB&1p4H|=;fm?dV?D7?G7>%3D^ z#HiZ#_;9Nv2}`2gq!semi}b&}pkic14-XGV&z>dCL4`CKIX0}Iwww+NeQ2x7%|%>j za@SDJpPXtB44n6vv)_>%7CICjOyQ8yOWL2U)tE9gGBOIC{B@eY-sHZk&7-1gYz*H( ze^U*bxj0(slF+TXyKH~dnxZu8v%LiZ?28tJ@^XJp=NvN4LIo*vJ=+?^+H~9e>S_Mx zo0*S`!A0ZKmZz1Ydxsp;Bi1JA&N>?shaIT;=1X;2>ZZ6sjVRih2EqB3D&as1du4av zKQkdN4rB~sTbQtAJ_-*~R8Y{E%B-e=1dW#NOq7h{1Pi6{-1IY5(nA|0VS#yN7x8lB zYVRdqjQPu7GS9WFer8IP>6QG3GlhKQIwIovGj*Im5jskyFz{t6r@4b{=wvb^WMe43 zXgIiIuGUruDW&!_@NWzsKIpn2nDD*1dG5|qEg4c(I{Yng@HLT1!xTHtxM;DE8xg-g zWQ0yMD-Nq2j0S^pjwW?XsCam45zsTD@(W~=O9{W0qI`P=E6Q;BT(ziQV?Ap6X_O}| zG0_bl|=tW_EXVtlQ$nVeGR_bM85mR_G1^H^~m9 zVX=-i%ftVdZ2J=#o`MY& zEEkFU!T;t=%{6{6{WJ}kcvAvRY?w*(?6*`*lYzieU)y%>ddt=)y3EK%*G)!@q-n)h zr+k&64n~qGtjj%=eeY(n1|c_FIBvrW{T*b^_2djKx-e0a$T6i3M$-Zsi0Uh03csV^ zvCz?q8qoGhK97#3X8v14n+gFbn5#z^-9mO4@h0lmg)Fy87h@RQ0JY6}e;n6ux1#=c zqwD*1hXM>8*H2@U0|H$NY^|CyO`KjI!(BhReWwM1=#P#wYJWVWrzOlcdsc>kFxrvX zNs=A(Wq(#V5|Xz&tw^pjIt=>X&e~Qo@Erm6URchp^<9pnVMxl?g?Wfsjs>VPnVx5W zR^+A`0$@^zHgM>BVTOLP4i+TRFTcG!)IpF^A{bKYUuQ8? znE|qjx|Ced4J`Awscu2nw|uTtiz%yj+oX&jdrItf7Y zA#L{-+mKTnpu!OTRyJ+lOy1DCN4a=oA0a-*DN{i8ud+afIT<77w(%VGZvCM9inC@% z)g%dv(660)G3Qb%+YL+XHTYLBouUH{x`i~6$y6zi-AU2107y!FnUV5eG9X=Ef8inm z08aY<;1^yoi?Nm`%m@cCV{pDWr&E@RfGhCAZ+bu>19-ybREl;e>i^G2>`20Ve>qpy zHwh-7+54YmgoTHf3>nr^P`EQKJgxQBzqJCNx}7J$$IotQ5vC*$PGT|0m5O+2Jzf}d zGlZpIt7M0?ins;>&|Zfl{u2~)r_xhb4-tE~Lb|@b4&ZW%$$Sw!Q(?dd0)etU4;Rrh zI_q?@)L8N}fz5ispAaAM1ayKm7Orz}F^px8hllsYok8ZG1w{Y=jMxVa%J+z`FsPT+ z*C#>6A_=RrpW6|kIB5jFAJ*_>EDNv%j7Wk1?5$jDzaAtO%_0_ofu&9e*` zi(Ymqr+>Bf54ScYS!9bMh52Y}6INAM6L1?TTplcN0Fd)+Z-z^iO>OuoQtY&!AT6do z_~gfy%h1qJ_hI{EZ0K`ra_0)emp>YT`?BB(gVX;``L|hBDHu^N=mnDwT=Sb7t6O7X zQPDd9&@u|e;r|Oy!+!x4N)BrgZ!!$L*)GaM^j`h@m&0M6zs7ONc=09hC`xqFf`69B zh0a%5Vg%fu>#)D*Yh=e5N#S_+yF`P|Tjbv>DWPs!%d~)j#a-s=>~*Uw`qZx916M}@ zWgiWdI#3@0m9}SD6tJ#K?Cw?HUgU0#YTru-W}_zjW{-WrRUdP6b7*{g@Si__vKy2e zUp$4gHiC2gXBuMMBnu75Ebyt%IMlL1t_lD1GzE2LNL*%!>30CqlP`FbJVE?GM#`si z&K&ZYhJj7`$xV`gWAQ-m1nUsT8^go(xQqdg;BPY)P3d=6x$aH@79;ceI&hr*dnGwT z46kfd1(!?in)jCaf&Jx8$8(N>!O zcaA%V@g;drI2+sn9|kZS&Z7W2EQfb@lAQXl6KbtadGfsgr8n3jLMkJwN$JtUY5*Jj zhd77mXjXGnT%iVTZg3S9*?ufKT2rUPSO9buQe7vFJPZ@_!3z(lUPiR1^09PZ{;e0c+he+pw8_ zS^K|Jg#ns4oe#tVcg|BhJXKcx80tV!BEw>smNS~aj8@<_xaKQ!(lH#qY$o{g{au8d z5fHrNc{l2M`0RN>|KpaV{8Z1#xpz@fQ9wdqg*Yv>`R_z@Yq0Z9LV9D#MsuW|AJv~e z+6Gqd|Hxl~0y}(q6FP{+dj-eO@PiclNyOt)MuAqDwke{oLqyNg9TgY|df*!|5ZNsYP>Jgb?N%bMftuaMiSxx@Mr-m!5wCd zy-AA=!f#CF3AX-XX??FpKJ%8UB$$hXLoM5;ep%vooA?+Sj2cg9m%9iaeY1K8)XBRdUEgQC@?EI?!+>; z-KmN{ZT`(6t2t5;gM71tEU(f4(2KGuaBc9Jez_E2UC>}6x%$D`HH@9!O7>)J`Udm# zpoFIS?x0LE<~Q+!ug(-aQpKy#WKdv>SUe%@OiUPWc`sqd z1*>xv1KHiLt>^H(LAoCG{B&up+kU=5tx^3N?{jzuh&}?7_$}*o)dIbOny4Hbi-lol(e!j9PVD%^G zNRh%aOhB*qzmcFxvXs^s)H`4e@Ra+BeE7EJh>C-g?;$;n3k{>GPzWyg;`zIM4)-4l zphAcIaNZs(NRlbU{TP;8xAub~$>4~D*gBs@iAsEk(78KJi~U7%00@dR*#cf zqkZeBL{Df9zsq zDT<2*t~>*|*&<1b{Z^otg0Vl{SuPbm8r)IwuFk#Gd?Q1!U^OH*A|xpJx^X_#Kkqi9 zh}g7u)nW({3e*bH>NB58Q9fnmj`Hi7Uu+fJ?(gBEROH0|LXAdr-cym}4cq%z^g_%2 zh1i*ESe^67%s z#$L8LSt2w$niR&I_Xxbx|04TYH&Ise#GfoUANw-F&7*$Szw9d&@lFt?8`uXCY~>}e zTV8F!lDUAL@_c`Mzsa-{QR*}iQ64+&Tum$30xETKqBH$b6W>;2L@8Ug9-Y$vjJBrn z4Xv-~w=eNQTUhgLm|cJY~TX>a9AGX>4%3W*WY`+8B7^6s%z>vWy1uI-bzFbDW^^Ee@^Y5!v)S zYLc-wo1T2A_T?bKnphG1^;Eg$>LPiWate(+F?_x#^9`xC#s%DQh=_d~qeedG-w~B0 zs_f_LBBP^`5p3Luuv#@X>jU9xYbpSbA$Pz@eF{YeC42u81h)#UJZ8BLuxu<(GI5HP z6hZy7FhKj`+WHsNDEszx8J2ae8uc#-lFGN?jd>SSa*u zG-RCjaC!WnW>>mAI++O^+y9Hs2%EPfx;4F$2CR3yQL;~rVk%J z#BLcP6;uvKvg*;+Dyyi7?Sxe<83YC`lw+vo9S1NvL}A>*|BVgP{-RPzrUy$-aS-`ZNI(|{UQD5Z{LAXktP&70{Y=sMxNu7KHA^qj z)$)Ck-c)G+NEP#Ibe@Tfzstz{)v-=v$h6sX_cMVv-@%mL6y&84;^pVdh5~DwH1Mg` zMUaelnuvO7S8gB)RV#8czLqf$=&Caon8F-e&tQQi++VmpJ|AJUq zXrH^%;T#~-LjhKFffL+ze=$cnVMx{I8VFFO&VwAiUVfQ|R^kmu!bpw3CI8-Vs?3*# zy=@P6C6;x?4}qzbXLhLP5~u%F<_XM_&HZZWFvfSuU_k|8vb#Q6muq1cyIMw?2gp0! z_5hLD8k;=Hs@j%MaUvJ59RNo4w@j~h(d}V71@g;^p2vsFcFKkfsy-#{%GL}0yNBCD z>xCwsgQi{97N8LzH?heQaCh9RW^5dbEq3<`$RZA_k<6HHVq6J$u)DpFZyc;&V;OGt z79j2UE_Vcbo%GQicOYRG*H{De{G-!G>ig2BJ6`!$ZGhFc7F&h>XiG{W0&r+zv$Ev` z-TE5UoFnbdpqW?y-P5gkaF<(IvwY1}9lJPRpc~)TMEx+0-G2APH#_vcXy4=L48r#% zcwqw`^NEg)bx=)-8j_16k0~!_z5}RKbp5P=n-ZT!+@SYa{&gXLj(aI84Zk8&be;hO z-CH3cgY~ft9$P|y5Yi$mOgHz{zX#5+H%tDPWDYIIvTFc1@~CWo@M$^vfq|ZVe0&VF z6U@7=2h;hmE8A{LXVJtBkVhgm9RqLE5ruCHd1Q8zmqphTHNF9aSBBq7pV!q&#CNkU zRN>pb>JP&Q00Y=N{8i{U>+w$R>r(6GV$`2My1sJBSQWmA;D8*nVFi;0Es<7DYS$8T z8K2S*PLq7FT-Bb)`^$gro1t{Rck>O-=&)%cPcmixl`zzHv5Emm0`1D_h?vg7pNtGr z%W#)iXrR#j+4v+!2GbQlD_3;t7hH*8tj4+{K0S;$R`Fp@IL) zOqYA+_=B0161FUnVKraVDDlylAzUj@XK*tzT>pLHA z*`RK=aR282)dGZoR(^GmJy<=9J-y3C{S6peU++tpRTLphY=czIt1RCGfpfkek%W{L z<2}5}_tWhU1=;eRtQ9Ri8xjkR2HUdtK;yF|@)2Nbr~!&2k!FyHeIOKD^o4$v z+iuga>#W$|;AIC9YCGxc)KJWt3Huln%09n@YYse2me-%$ET6?`#m{tRr%q148iTrh zO}GO>6kh%fATY>@44n`PRkGmXy}1(V)u3y~VI)pH-c15DX2~z6tA4aB1A~K#me)4R z1zLDGIKe!&Q}h@SXq5{nx7>sc8hU!4BtlV3uF;!3+i!N5@(T+~T|uDjrgfg*U+41V zu-yaPm{d|ZQQGe>()E*;1xIYov#at%sH4hf*fz-p-oLT#_KsqnL1p@VkmVPsqmo=bRYcAc5v_`pza~!h{v_JC`VmP|5> zQDdCwO|kwjQSTEA;ges~=zB$(KBee;sa)@4(?UV~UhoW|bsn5OAB^>VGM^p;KHTlz zDa3oroM6~x`1D&D{A|QK$vxJ$X_<`5Ea2~Q!O-yhT|o%yAUnOB0UZP*S}iXO6C>2j zdIqP|@I9Dvw4m>#3tOysnRL?~2JkdeS)%@$lvqd>8M|VSccpIXcow#v?0_&1F;fPVI`!WVi(|2}+Tes~Ga z%){Zc%^s5Q@j2Y)SvF2F%$#WR_f^5xIp+zoaa}neNfirhyTR>c)5Rp@(r?hAD|&TR zFqF>IB72Kg>m%DnFRx8|D;q98CTd?`nSlOU?*IpVPR?0BXo`5@5d{V1Lkug6h!2uO z(>5&+9~n70e4@}c?Z9*R>qv%xhBx7shi5pb^#$gJxrh(PYquWntGhctf-g$qF8V?K zT<#RNRt9^gsqZswoSwG>UB3^XgEd}dL`)~qHHLyD?g!Y~i?^I*OV!NG%0=Hn(M5!3dD2O(5S;moyyq**urAm>4|yjb!-h)Q&i1tt zsMB9X{1D_Ae$U02IuO}F8VPp``Rot?uUz*N+|0JI$2Dh8Hu6Zli4H&g?Y8gwkQVe7 zb6eJOnK*dBQaVF2TPPWB%tDf$g=aOWD3ju>{8eosI+J$rbz+YVvgE-J3^q;iccayy z+S*RLEDe0u&0!e;=S`eDm#6~`X)S|0M0UGB?CuU3UGIZPide5`f;bRzG|zGkX}$;f z=Sfi7WYvvTp`k?U#^;>ur)rarzj6@;erz@qcPoB#iiHIm#>dBh_=IiNV{J9uh-YDV zsgOO^KTg^AjB8j8*Ck{6VN>j}gjv8UBKN$wVuU7IK&0bZW_YwZkT#!E`mo{eOLt+G zKHxl(svUZUXRiknQh-f&HO)FB(}ecF*e))ncaK4)A2EoU-w+nPHMJ9`AND5kCb#ZZ z_-+g^TIXrAf5Kg1F3&n5*;WU(D3E2MLQo9LCb|ax|(0F&hW~^WEIDx!vL{dQ}O^H!l61403 z=7qn0M@FD~o$`!>qGB{+dlK(hh#4Wf((BY@Oq5D_*Ln6}3)f;+|0b;taACaa_qPm* zs5tfuEEVESDycB2YdA6`bv_zI-=pU0wYbzTH9A>dJpMGAzGAJ1ulpxnA+de;MpTf< zQOWfTnw9P#a#o4A`PSW>>r^b_59tHiFLZ`ONy76{U3I`8HY*xqh!K>*RqOT zUn)^^WrG zJ!^Qnr~=87eT1ccK6iH2xH3ayy_PGocdj<~BWf0f&KSmGyfFM?UN|^kq)EPv7XMW} ztj!BEEoY$i`+2kB^MR4`siUfw)BU`44$1cHW0Q^kO`Y2T?)wS0pBhQKcFx;x7{j!& zs8fqTUcEOQRL~k@4V%$0MBHpsNntU8MAuXRm+vy5$QROy#h*luv%`9|C~fY)K56Gl zY5?xKNpIW1U1v?kRMM1!R30NS+rmd^`iEanbk&#DMu0~i;i+DI5u8uJDE}sjAv?K< zb7F&<1y7p<-3us?hg>mGU_*J$XFK`NjLI?Pa|rsp**s-J@GQ2%N)cr#8Ek1PD98{Y zyF6bAvFOEL<3=0yWIvbP+(3q*{`|ryQ5IyZnl3(eW5D*`x?>Q--m=JgDhU6CB~pRV zxq*(%*d?_T<+ksTRF&KhXP_rbt``%7Mw4U#eo4`2EiNLYcykDkq_MeI#re0Rt^6P@ zr-?LxIX*(yLWv%PoLrlpJg47*v*QKm&3Jff{MFu(z^bFD!d*K4JD@U(*#^~OGKwd^I)(cPZT@m- zAi$%rczF5ct{ip!%Ll6Rpn9mCBIgfSx(ydjo8PgUSTQn;>h8Cm|Mp----Mo_;(^VI z)By6(UA$vsW+~mdlmr5`&34OZu!;0_cp`)xIYo|%9(rb_*~cMAFHX;?@Unf|NB>24 zbTsDo*CGVUI}sU(KA(8YUxk@yN4z8}&1NvsCi{#Is(7tOHILc}7WXk1ap|%UjYQ6G z(2(*v`c>eYAGD~gN6u5Iks7qd)gMzUMV5pJVUp91td+TBY+vwEzxo|R!o#>mA*{lk z(3Ja(U|Cxa{)zAE@bhPM0~B<3$2jq^sTG2jnB9H*O`mnQC8tfd@1&ugiod?_R3e^j zu%~6Tr|!f*szj#6uy1OGS6Koa+oCg>Q>(AwBY1iTkmXF0Mm+U`j#?4@tOQu9{BJ$Z z=P=&zm?en!w1Fch z&kQH+iwFW}p=^+XVYfokwfvXX^Fl2VIA_SsVkzbUZU`2`FV)qqyfb3bCM}jUQ!BY~HN0fq z`VEhnw%@N5jwF*QD6TA%GgN%K;URoj~ELr^nD4WXO zkUKo5EU9a$IWy6R=c#j_8gl7?3%j=*DZUt~M#~KF<;Y0$)5gh5ncERnn!HM{PhOr| zPoFrZi&d0zse~KX*Sf!FAY@qxOPdu`Bv1V~A$nubZ$G>LClbgly*QJM)Q~Z-sS5kk zPS3w#E+WP3@tVHJFT41WoSbybL7SEuu?D#p+(K{T_2k=NSqw^wUrBMkdzOEBL2j4o z-JNo&QMlvU6Nc~_nvGposLXC_fVOd;@@c2bJ%yu943(~X%XonA4cYcyv?R=3KnHSJ z7GH4`f|7^`S;)cHCx~v+YZUz~K(&-)Z~dSarXP0a;5(CI>IsJzmr9 z%gm+IQbma|Jk{CzZv9JhCCyjhv{!6@Uit&VpxD{Zz2_vU%-QcpGV6?+{yES&Rfg*n zN;)GartbdE7)R8k3L@b$`^OEG9<){%g3GK6D{wfe8QlhRA@mIi$$ww2XGZB8mo3W4 zLIAU}@mrI?GK0p54qyINi9Sw4g#6V8oQAQ^ioP1JT)q)#JR(B;T{`tsn;*-?|74Z^-q0Z6#KFw9YmoAvF znKa|7ukhBref$2aj?p=+bjs)-^i?dJ1 zjFCG8pczvG>HVFHlN_z!DeS9jSK zd$RKLY|%kO#YD)xJB|9O0S7x}l^5Gz{!6E1qo?FOuqSKwZD2CMP&htKGnD=qvC?4H zx3#d~3*Izj;wlM&{H2c6f}jLp)q?^$W`A>{+1eL^iC%a!jXq}4_~X!x+9 z5**}nsd?xcoS!Kv@zA(93pPRBvsSnLFLV8#GS|al-$|^A$r~`1I~f&mtg{qsw9J>T zRVwYS#Z-qlz^GZqU(~_LrBxi(legx=rh)U_UWYiz%0cU3Dq6xHXL`~X?671M zYx$z)x^8IR z4u|b}=xiI8t3%7Xj?R$JxPeg`{;{JOG>AjWvcn;yur#l}KPyUnEbB0KXtRe~orZ=+ z=>i7GR@CxjXZ#4|_$vQ9{d}HGh^-^!(e0#z9@YQdN29F@6mg~?uK50ts$TNArJ1xe$A4Zx+7{`yKZDXO(3#apt9E%*N6)1E&JE%V0M1-hJpjS2d zz@dL*g()CjJgzeTf z_)&1Wo~RkHLf zn7o{~$?ayFj2aCz5`6Na(7;KF`&#zj^Jy+5b@1SGVu5J%B|AqHUPmg>uBL%((3|N=95)L-(0Njt`~EBeAVJQAUkqtUP|g_k z-%7MUAora=J3u~q^Q^5@e{zD#XEOlv!Tot|e_E^{V7YgcHqb<()=liBLZgQRk*4R# zNr&A@A^R_|F{GBR79)8P`l>{3ztJq2K`vqr!-r|h$4*)a{=nL?fL8C;ToF-|^sd}O zPcOe=)esgWv+GHsZ?vCY79w8Nn0Of)a84-zh;P{q+7~RJRPJt^*2lb{3f2!bA6sf- z!}43UL?|jqK&}`AZrH4I)kNNN=ma3Vn=|R6*hK@_y6***qi@a*SB?&8E)bF)vDIHq{H5CJ!&q9uyCJGkpP5rh3%=cnXrZZNOpkch( zQ^k!NrO*FQTNhyD9pVUOwMDu9gR|5LDhsV>eH9M4Um+^@SJa}P zTiF36vT8#!ep!_Z4i0&+**)ylySE6>@bJnPxBj45Shs_u(4M6U_AbyUIwwcXHtAz3 zs7M+{cgb_B?|Ibkpd4`bX4cBOjqXI!Y=6?1(AIH0a$$M{H=AwsW}jzMMWx_TZDXN51@Jz}~Mcl2XgzGid`hqeBsD z1#!DCCM0}$;u?56W@cu~Di#*`H&lZ@XInV|rv_PCP`lAwl#d=;L6S%vmNmN-7^E|h zkXEnLF&I&6E8C4Jg{z10QvFf@Mw4MWBO*j-GPzEP;kT}_3>Fjz2M0ZIq1m$+a1zd& zH&J!=WR2t%%o@-9EVDZ`5d3ViGd2Geoa*9^)F^>VtP1lL4?LNE0le_$2wOr6FE9QN zwzfD#L=of4LRfe8WZl+oyMnaAb$^lbm7e5=S_rN5Hyg9y&MleeWT4%h;3M|DWVUld z4cXCdAW3iy4>pknPk@DhjEwt=SUiRJBG6aK+!vg zPtVHQ<9pb;S$F?`o;Yn^+3~sJX1gF7ea*1asO-hyV5C;yjgJur`sJ46*p8AIhgt=@ zr4ygy%k!((n-Yplu%L-@uq15#C!UHXg0Kgne&VJ5+(-ZR$Csu0{8pGZmj^L)-61s^ z9ySL5mfupbH=mUpcyt$n4x?aQ`t+V?ea2;6!+dsSa^QJcU8SEr3-A8el6G%8-v5qK z@ zy@)j(J!M~o+5Z{1w7c)_Sj0^KzYScTY`BSt%0`Liq4Zg6|A^NH8Nv0B!xf|{w~s3l zkfagXwK{%%8~}t+#79sN<*7oM)8%u$Kef~3)0<&utX@~;n(IHlo{!R!@~=5b=o`gC zqJRA58vAZFC+aT3Q+uxKclf%j*``Lso_%~$9*i41oCLx)f2p(KQd|83w6Cc%ONioE z7KEd-3ltH#NlDkPXx5&)Kis?fTbmx2%?!9j|F46Zse$p`I#3If!M22~tV&7<6AbFc z;$e^gj4OUj;hv91cR~*)#N$$IWXdpa0Q&nJ9(%e9!*#&WO8vYG#?v$uQ1>AyO7&eK zn&20H^8<=AO~!%3&y|JFgT{^>5>;?GdBlfZ_RHOhs}J_yXLcP=u1@88SJFNmU%9P2 z2v<8r+22Pizooo2vvFud%twlgT~z>ce(xyC3fLipd0>Aq0WNK0{aJs2HS7Fl*7eO} zUtd~IZjQIE+^(UK`<>v==M;XgMnrGRn=*)uy(DA|#&>aE6ciSs0v)c-i~TuwmO`LO z73}I}m~JPtLLOr{cQ>J-LPbaSJWnpJ2M}{ZQ>+75QK+x={c&DdhsPqIK=gGBZf)@u zT|DOS_@&e;MRTxOUytKCKGY$xJ?ff<569GT@CxYbLEASH|7LpY$xR;9fMx{fX0G?E z85Cgdd!&Ebf-GFyYKoUW6EKm?PXQxv2nc-}6VYrw0RrhFzIF03UVtq5FEHVS+DhU< z$ZF8AU6`)9xC+c=tOEUSRnx^rS2_R#l3UWmkP6^p`uruz?4<}alz={NBvU-xUd%c6 z`d=vwn)%{l?Uxhri{ZACSBPaqQquAPB02@t(7jlv&YZ|*o7{jOcU^u)VfKWPUN2fh#za_Ra5 zh200{qm-<`2V$|iBc!K^GL$Jm+&`EhfXCK;$Jt;+7VHHKo2}gJR`vp;8=4nP0Up3) z*DBCe>ApGN)oKqDob%nUoqk0@QAyc%@-*1@qy|yd)r|ytx&ZZEod{j`np zmZV^v0yryXUI%l+g9dfurMnI_Un7R)yN`iU?4Lx9SLRB8)9>`15&w=0{*A95|K_DZ ze2}%oPnnJc3!6|8yI&)O39~i-s7nvA_y!;okqh1Pm`t`|pxIu^M&r?F5Gup9FEipS zC(a&Dj35y;2A8CFHdZxg?@ew?s!R!*Z*nhldB=&KVd4ig{gKNJ8*zd5y<-sHT*LX4 z0fDJ^C7Pmsnp-n&sa<Rs&|s~JJG%U9i|i!I&_w+GEy zzBP7@*UysW*Ecp8O$D=%&duyP#U75a&%>j~8CnR1riI^pvR=R1tiAE=h~;g&BZ0Y9 zl9!ff3{YvWA6DGBocp-$bo7sV0|C&C~#)A1>m6eq(?AZ76 zbrw<*E3&bC?!V{1uByj_brupYL;`ux64GJd*lJ0pWbX98T7caQP;Fi_EGf-(rp3G3 z#qq<@>icAqfJVd>$M*Y=Oz;N81X?Ba2x}-QxAkwF%e3FQw@FFG+9?yQxBG~4XzR4ymGa=Y2BPjh2)AUI2oH}t9yK~mCT9XJqgU< zGm~>ydTL#hj<0OJ_HXm5pf^kXKX(vsP5mU>S+8!-H2vCh@Ua7ODOlzVp?gym={G%P zI_0q*?$7&7eQd7LVV$|ey>D6g^%dQ;48AL+H-A^s9Tl_)dWC@iCZgZO+7_hgu*R}s z&yNTqq^c0NZ#&Fz9aejsqAbya)garLu^Kk08et=S047v-sG0lr_V!Tefl-_ezx6LV zi3%yo|L2bR&!K*LgB{ymx0uQ4 zyxPrrXbqQdtjF>8_x_5v?Pa!qM*{fsZ#ftl*Os z78Vv1YU2fhmuK7KMWL#-xecKf+3htM=f?z~Pzf$Xm!FY14QFEt$A8|%%_LbbT|c~% z#>8J0rZCz0HfvU}375%9Z{8ulM*g|{cAxZxivEublAPV75l%B@rX*-p6L;-? zrmff=tdp`(oG}0e^4|>m?9j^W&!Un2h(R)f6hJ!vnQ6Y6XlQ<-52@LFYMbH8$Df1z z-mZG3FbxleNwoQr%Ev(`8;X_WgBp=wTb_Szz^QHMuC{q~Zhmo$&L zCE3^qqL+`^M5Wt^AG-cDHaS{}S)4Q3+vHaN!4+EmSD3CZa6C;E5CBachg|_Gq(Z|{ z_~tkJIo>ae@u%_38MiIF@Mh-6+|IiZiomF4?k!gn8T;D%0`FJX$)F$@2jL@X{$~;5@kRZ*~o7P0a{?gd< zE-r7|^i0Z6T4(i?$>y;x6%~4tZKIB^LJZ@YKRAF-!eW@wtwfj%D}8oBq3Z?f$KveH zLDp81!U7W&h{&J{ecImNOxnF{Tj%fBH;2$6O*&m&T}OXHhU% zmIU0vp7T6B5OFzE; zasUyBlI|`+kWlcu$LHDax8Hs2?>P3czyDannlyGQX)_MNcKEdfaH^X$(2N{&M z2ER;KTKy9&xSX6a#~Z9qC4pZ=VVRJ{8y$nx4)54L-GrNt{zD7M@jU!W_B_Loxv_|h zQV1&N-66Ygq`)LvP(DSKH<=_Yi`bN(dTZKK>UH2Rf(vq*b{vG4`jfYE1cHl=|DZ_T?B2;h%pk(a~X zNCE+0;z$`(XcwE>TPzkz^EHlgrCifIb1Xts}Hp4IdnE&wY~N(MB8 zJ>9_1LIU{P()~+%8N&6S8&Q6qfqk(6E)LC<3{zjO+rh!Rmk0;@r-8>U5ouN@< z;moyMebHs@gCEq&v1_ONs3>Bp@0z}bA}_m4D9*Wc7`BUjwah506fs!{mt$C6Ek6(E zbvqgkjg4aL$?aA?c7Gf#QD`y@5na7V1d?w>MJ{XWo{|?| zvly6&%Jt9QRcz(ys{aK%r^U(r+cf7lu5^qq*X{IPWUbT(~ZSdRE3^WCi z85i*E&x|67rfQeSi2Lqt;jB%&|LAa-aA6Q-5xs{tQarfQ2+VmaS3r?01i8sBIkUX- zPEQygj&K0Z!u`O?_SEN1kR34KVf3&sxFHC3AzTd(K>`s$bhm=y1C)-^1%Rd_%AOkK+Q#U6nI~4@vW_lEA~Z#YaTdtGOP_PBf^l{QmCp=h=B6 z0|etj&LK{le!=i<)OLR|=7#yh*0IM73p7D_a1~%3b^J=6l>T${#~1faXU}>_)G0$f zFzVSvO_n(Y;=D#skkjOpKH9~V`03t-Go!B1}zNwC3b8zePjsIu8f*DlMI1>CHG-uNVub@%WTtMAcFX`t;QUNC!B8I>QkpQW_B zZr!*=ByVDp(I1i4?x#DTnImJ%*16@%t(E>|1xxYjC)!wkNeQ9mdXhcTFPef8^5RZ) z|AngJ(NUu?-tCk7w~86@v1736$na$M8)d$<`t5>C{eS((3nqk(4>3DE5q}&PSp4Y8 z*w#&r5mMzqjZ<}-g!R$v6 zD;JLhOB3dqfce(;OO8TqdV~iD_*xF|L<&U)$%H`MGs)Dar>9}6sy#)TxuXqEMl=auTo6fI z<;dO$YGzSUgJu&S^%bv)DRq1F_fEkDDW4L|M&R+virlc$D>uxS88@!b+nnvpXYgot zUhFUlay$RF3{z860Gt{^ZTvB)YM- zW)9S&JHm`3)Gu{(5`sk-kr&$RN*p9WY{>x6015T@9RCN)@K!@bV2#WG*Z9!G-7g_A zc5UM$u#2;Cb3Y6yc*QthYE13}!YUjytgyg5qgo(STvC}d!~gtlN=?NZNL=k#*9Qlc zb#!%$7qy~wvI`0n?YbASp&!1T9LyUvm-L!&=PIC4C7`FaTo54E*VpaiKIqcmg}r{w z9-%s$T(9zuXK=;VnYwhriGc!7HOO*I*)DdCn!#`Zco*0>IJA-=o1S-LCxF&iviMI} zgqQO?qBPRztJzIhLxvDa&lJ4Ngl~JWvpxg_vQ=Ehe##MAlbN9d46#FkRi(kRV4$r+LLg{&DKh(Sw;1G^KI zNh&cux)04Mf?<-Q9A7}0J(QTeCS+U30u70?gXag405^+Ww;B~}hM`2z&JfdCRuR_M z-#^rrXZJ8aNCORd>(2Pse-EgYVf;p<+{n5*!7(T08#yvnz>-|IOmrLKM53E2SdKy7 zPmbWif{(c=-(buElCw}6ZZNax*rCuy>M=6#DS$ztLeqHuzdl`*;V-b@B;k4bbaL+X zPWS1#v)mi|JrFp$s;j*FTF#BKm^Bz94LrW_@Cl-|@Vz9UzMz!lr~vn%PD9m>!;%8b zq|xec`{u_G8rnu-gL0mxi-F;;*>bxu9a@RV+h)e|Y!Dmko|TW)lA5|EVIdDUehzY% z^pqbugZmLMwI*YR_E5eaL@8CVFA2xe#?wZnJy!0K%i3UQ+zMpRa1r6d4Ds{s>3#5! z5cwf8QrDcbxJYPX>V{20j)MFh5X|Jtpb`*nRrBB`?(037Ay&ls1uP7I=ruMudooe% z<^Kv9ki~K>t8b?!a|#+3bj<$c3}**R$A3Bvw7K`@Y;w}B9oj`tK&aX24sJbA9V$i9 zlE#9cxpCZpgbUY#`w(O)KrFkxpbtI_$gevgR|S9IAi4xI*A3@DyAqZe{~X#H4yEnRF@IDVp`R|mju$8O0nufjJeM|G&QtPbY&S-6jl_9^} z=!0o1Ecg&bV(1=vaD|n0*wr>v&`*TzejBh!JE|RP?HgPOW0ik;aB)R>$L3`np14yD zL;VX|yhX_ew-*;g2M33$+PFUi<*n;)jAxfZ?QF~(jkw^glu19@(GYp;CdNllz+sotq3~h$I%#Uu=oEr{obATLlBGhis=3z+x?(O&+ zX$qjv)eamyFRZIlKAU1oUfXM6bq!_hok#qqqV>{|&pk==f9E0&FD|;HQ>S?*W2dCy z0UgdkkR%Zv;OVQ>s14!D*T1RDp_#b(E?DH}x88aClsZ)GYtRL_DaQH=?qG}9$W}NV z=w^z|mwME8d^3?+Ffz2AouEydx$Az7C2#4;F*GD#*-H2^xE$XpDHvRF8KYs6TN*>mWToeP4>7v zOg48VB7C*k@u|DbO592E%RjZ$@zj$ClN8gFQ|EOff358aaxLhD{@fHMf_d@83gRO9 zkYAdv#yif>&Mw$yYyJamBk? zF4mfa&|rL&%qv7j0Es=pKwwX+xmX475`Cgjmmed3aimhJE8x-C^2lvw^p5fM&OORt z$AV!gW*l07Jy|UbyA9`o>I1-%x!gSes%2a(q3NYid0g^eii}t+{|)ewUIt;{`X`SP zWt8N}uQh_H)1m18#(LRgWCj;COv-3sY-c^FHWvlN#NYF9aZrWPPotlue{kg)d%2lk zS=I%j^VwG-&t>#SUC)JTv55mxEs6lsQ3f?CLn?C*0q00TxBrpEZDQRaamSI&+zg&6 z7O4PdY0HBmjpmXF&Jyl61an%dL=~s4pnrSEotPI5)2`BJs?UKrsmzWtgpvz=grIPi zw9%SP5+*O6!zDZQokdDwpwWajuO~m0HVT@qa2w2aZaS;8OvLy24>Tk`WIkF2GtVTZ zylxk8C2B7EU(HXu*Kwvx<=kp2MG5al=yvFf4;6>BE@#>y&)u9z>CIwypX;Ni@_2k) z2FVwhYZ&C9AFGAitZ4jOok;y?<$1en@2iDxz5c8g;s>dzc`cJkUwt?d0T*Pt2y5>2 zl{?OycGRvI2;aTXtGUr~?yQY3O5;f{C=2z@mk6+AfN3pWtV6#Ld7rxR!Kz zhi1m_XL4m~d=7s7QxVdiXtz-5@wAVc%TZ3m89qRD=t2+{Grmr;_M5CpdAE|*qTG-HUPG8Ha&r zG9UkB0?zgv<(R~C;)Xs3Q7$R`_)G62|2pC4@=q^h+iKT-v*I}uAh2LVYe}JPXyjDB zD+@6>z+|-3KZ+uxFXc}ZV@-3fhxmNdJMC^TCZBD71bXKwN!$%?oxoUsDXZhRd8*Zz%;`oKK6$w+ZC1_QOb%y`SNtg~G~;jc2kGZv$(TY+iZ z2imDO9xY4SY)D14PGq-EL=O1&3t7W==qxteKOx$FP1KY1+AG3DC;4$EZ@5|>dYEN? zUWhmksV^aW_h9_@HY=W7a&a-qOFM^|r4e7UC)dpakmk9F-CXV&A^m*|BZK`Wvx-Ae zrx?>xo^Zbty{l>J*@RBI(geb%Ft=}m{KWSOAlr}hgV-@TP~|v~y|SLW5p+NA9*Aqa z`8aQddz)D9^MT1|hm*q%Zb8%h6&XtW2<3^e=ku-Ea;-u@&HUk*!HXg>r=x=YIbX(? zY7?Vwr%#go)!*jd_1;Cy3BQXtB%Ycqy>e{lwqKm1y8OA}W(1ar>o#sfv$>C>I|1%K z>d)XU%>u(FO}{_8lrJpEF!w*dB58bE?OrLg`F%;a_m3H0Z&LPNvz%7HGmaSMSBLC) zA+Y=oKZs_i+XLcL!wx)drjL9+I`_yd+KIhp+uE@gdAuFl{8k18A!j@GOOE#{YyOs9 z=Ly+nN$?XE2efQA)Y~;$#LR4j<~6t+{DDt?oa<;F3+=fxBYbw>%;jOTGe5z*$lW*H zREKG$^MXN^&U~HE;wIH<6c@6B`7sd z3!e?lLSx72I<#cbsl8rj5p=qtf&Q?9TdT0vdB}PAw-vLY;;YrYqpLV;ECkK*TfX1a z{e~+*Y8`XU!q997q}~q}0(WM_(gPf&33f_}k%zTspuR2#txf*I$Nk46kIuAbDR{+L zMI8?r=d!dbMl7x-=g-geAMs<2#q7q6n=Z5(32#uBHasba*$sPf1aw5xvnoeNpI=#) z+dG)&NI|GK#mX#Rx;ElNdJ%Q|vhPCCSTS*&NX15}`Uc$gQd%Er;Wf(TvBjDMsLv%( zPou{CVAhlgOSOx%u@d0a^3IMHJkx4(DYC9=Gz}0ok!ni6UlqKox3#~@)Q85NIByl@ zHl?@$Vp8|Eu;jKf7f|3KT0jBAJPpeob8e;J^!E23D+w7yjgX>vOrdCw`GHY7`jb_4^fNc3d+MfS_2so1uiWP zk6{zx2ZHV3`FW#U4klVB``y^K%6prR^AVYe50#8zdN24ojDcu6gP(;E{`}7cQT{fe zrR1?&oQsOJfA&J4v5La%`T)HL2jMo5=azb(KlUhXGK%px?LiQvpM|9tvyq(O&;9DK z*gOxCG~6-W{V%fV*XREO*>tHP7kplP!2_ontPPvQVHMyxDZn@=`1-c&7rI}pzgtap zsOTDqW2U(rL?SVNU;n}D&i%SM*wIEmixW@uOBs_8u|3b^`I*zth_AySE`(}%S%jUL z@(l|EoEoqfiD2sVDfWY&t)4b_I}DPdQd`8*Jyh|v{C00)T2YE`7ywk!S%a{lEV@4R z!hO8XZtNQ{zSCmzw5lI~2Y+4rKtUvL_HRJlU;s2|qi^*)_eAHtw@SB8nEJk`n1i&>fG5!2t;LkcJlaI1WnHFDs;uO zzc9hfa&~=@Hm(=2Kvm(_Zv9Mx-{Z%pjFABM#XTk4bx9ND0^9aolqsX0KHp(q!!f52A$sQk=ed%WJm zZV}7#v=hhq$ES8je;4rVROfU!;j4OdfV)e8{>w$<$3Fp?xacb|EJp%(EgcY#zQ&q4 zKU%E@T1}?46S(N(i@1ZJU}A7eLq`X)bYYi;$b!mjSs2Y{XgS}PH|><%Ht z{>dLTA%E>Q(h*KTyP7rExyrmjnG_(1v9O`s0xdk?Y3FmCk1wykXC({R)ZP9_i-AFH zjDAM|(Lw8>l+}E>LG8^qZ{C!6f7}B+U3qZlQzfp!L+D;Wv6$j@5ph{)W4^uu`{q{35l<3|OuqN2q-Hl62iy&7Qk)=j-hY>5ic+r8iJy~w_9C*Yy!oRyn?fGFtC26}tPr9`GBhw7`IzpWR8L`hV;7W##$_)gQIt z!JIic`ahQnl^W;t6T%MYSu4Gxal#m5Q+Hq>P>nEgUog>DLgE>D@ z956AX@Th$+%L!-ZHX?lo9R|Dgc)KcYfMl4OsdtDG39isJjIQI_eqot`)T;TzUr3$j`;1#|LKEzB0*!D4fq$U< zaCeB4tG99&7wH;FgNQVpPnjEO)v78b_)syQLqsp!^x!f%d2!CP?$(D2AQh4{^a0Z7eX*V6OcJxT>2fYKRNtX;^#;6O~nZPp<9d_{i33l4vS z^&Jh7j=U>5wEG9or^f-R$gB(L%McE`Co>PeA$6rKgiR12||ofHd(1 zlu7e#Ck-@&w)m{>yK(RHu+TqWNg1Pnx z5J1qh>?a-m&G;*5$UtiRuhS{B2^T^{8@)ZFJ0dhJMn^C^@Fr4dS&4qtpE9Z zdaHohx<&x> z6kXE)0}wKdaGJr)W`LRY(!Eh#D+KbA+$}Ok@^oA~(J1kC5`RcI8iQeFWxt*qBc&w^ z8=1<@$jWC@v0y9(4W>Gc?mayi{4sC!q=WCV>~Zq-oA8I2NIHe}C)Iq9J-t;w07nHd z!PHt3>p6ZcVGyk`!}9IjdZ1Q}=ia0m1(ZQLI_5)3+)Fz6%v;;Ym3Njd#+B$?c%gP< zV)GUet;PZ22iW&r7pQXO1&j0pu7wa?8oH#lsuyp<1(sXp zbz7)QDZmhuki?WElp!OH_72g6)$lCCJ`)w%Hwi|LiSzMYibprSMb}1sua*XaKt#BN z9>??*lV$^^PjsRu(vB0MqIqUm&&2$Qkr};yRV?CWCVR2tfAypWt{v30KdI$=Y=Dp( zTOqaSm0Hfby{1}lCdCL*A`hgY; z?-5xrHVYmj-m(q@Pgr14I%n`;#T;}C3qOMP?Gq-dvUS-Yu6!P_P0tyeUsVA$dV*`% zQls%Coos|bG@O4^Fs@H;Q`#Bcs^%;k9bY{b6Rq@^Lu zH9)0i`cpJq_*$9Fr-~0({>^iEIGKRi6+9BsK9&QyvQukI!iF&vVW%Uw8m@hvEuDnh zT#MyvY8a8c+jCM1hJ81A;PNl~Yv|%E3r`waa!?=1(r6`d;FB=w1j<9dNhjmsPnasl zAly(!P(>(kt984Pyd;Cd;g@5ke{ti*cK(hF)J9Ohb&|?jS;;38z1Hs7ao&&3#rY>tzvRS7%7XvywhtMoDoS81~qH{Z^l(^?-6##{hPB9|1L0 znsSP(*HO<1h3uDbaeu6@^H3GTmq#Smh4AP{syu7=Y;>L|8W3)%!HNg0rl^Od(498U(oh*uH%gjFWu&t1p`Q8G z!5&iXgy`wN$n;D@ENvkOJTI_>d5M>>DC z%D&Och5y}qJm2cPOG6zo%|5mp-B9e0M7J;zv~U_nLF#^WQ4fdBF@6GMwq7ma>qd|g zq8BP88gG_;FwKKxdJeATGtNYTW}8IFEYv7Zq09wdU_?tpgv|jjvr&YkBqru3g)lr# zQ;vN6EI?>d+rr)BvE5M6vuQt`M}zyBFAu*f*tP{C#&HM1TYv1UsAK$?jr&&XYVt=(0bW#iX$(y!zT!>xsnWudIBnoVEYamqNHL$Xq%U-H) zr=W1lP_}Akvi`ZJXIy)~Ucc-vxN-ib-Apn+LibC}u2z|G8`akaFDbL}2hU^ z9d!Ht15-6D!c@>`rSJYq2q;t!DQT3=asXjvRdzQ))WNR}lprYywsBvRJ8cGMlvSV) z4$D%T#;C09!Xe_UyAco*GqG2=vN^kyVf^OaT>gE1TbZcIGA+e#vFT^pP1->)ry{`ig-;LryEQBZ8BswCSNn zgE9UieDij7uStW>Y$>!>yX6TPt!7RVg{^mKQjJ4vD7kmr*s2&@vOK~E9*9i=-5WYoweGi*=bPT7&6?~(PR4*q#w(1ejEKu?HWG1A!UFeP z3|9k@kQcqtT?RHF=FV6N5UAY&)yPa723~9+5qh&Y_kx!b4|LJwGz>7(Qd?iwdZBmD z4nc43*h&p6qmQ(~A_Lb#Y&b8M(V=(VVnA<-r4rX7Fz~SBI{_$-5lw$n62}qGknqte zP|x64^#309DlF{QPp=aH@>3d7w>&N&2?Y{meb&$GzT{x=l>yi)4LHC#OJKYF>gp;~ zTG}k*3F)54-dDc6!p`aFNmCuN{rKveDhQTQCAy{N7Uyag;H(WmMO+vXqycr^8f8r3 zeHtuQV+YT}d$yJQfIcc{3bT9GNhb$0lERAM^C0zyNkfo+wU}jne zk;l7NudrnyqP{1#S%|qhyZFJFc)?ij$uff-i9Qgc8h|8ER5!-7-M84!#@f2XPwx2O z^DzLV4b@l;ITtO0fSr;$A&OtG(v%xy&8=-meKhHYTj zd`>6yp+b|-7xMI^0Gu?biq~mVu0@&uy^lqgm-D^aOUI4GDSJyLz4xmoC)MG*4Iagf z@+yTweHjv3#-`BL+Lw}H3A3mRf62B$Y*;oAUb?uqI^8*1q(207_&|zl8V7O}O|OHw z;_IbK<7O@Jeh@!s2^#N}#jF?^ODuIR)>EDfZcfklHCLtt6FMaPCsx-7{){5h-)4-$GXSROIoh>Me&1d4oGoh z=72-s8001cKs3tYzA>yBMkj~J%)~kKF28^6J_>;J7vN17`3_SR9G}74V_3~zUe&9n zi)g~>`;DXM#P#_0=35&tiTgpey$%)T(9IfJbpj!_YeZXC((a zc3~#tJcD=`d%Le1y{UU=E~Nj5Gc)m-N&;u1SF>UMZ_{aNo}soVgQ@#5i1FiszX-u} zl|hPr;Y&g`1E;*{=I5+;(RAX#Z2}+>Hf!k zRDJ}4j;xQ$L|TsJ`^KmE0=2Xf+!7#dPuxI)GmPAI~gc#;BKuk0;sIh!=kGVG>1JU!6 zC4IGk#6wm#sH9Qa|Ci5p1!8YjNO6tbp>%~Y5g1vKz#3NhG8Ce%t-U^Nlch^qC?J~< z-dCqgHs2in%47_rDmuc&yLtD+?=j5*!eqZqGhk0T7u_e4Ry^Zo0&ijoAW0O1zWK?p z;(ydjJpo0VK1cygj`;pd)0$SuZwWSq%sE&2w}X;d(#7?A+c##Fe@9Z8LPc}@I8z#~ zV|8?=Y`G^_JtOD`Vw1OE%39P4)-0H0xEz?jWM2YTr;a`=Sq?XD4XD(RQBvl&aPk!- zB_!m%SXpF%+d#Ite*^s8pQ|#EG&N_ufe0^`jN5^VKpxgJ@<<@}qMVnM8)8_JITUZ{!s-E7& zqu>p{?C#H^R)hN%_J045ASqi9>khF;bhE7B7Ki^@oYFWX(Q|jQ7#Ad%H-guR?!?RK zGehvIpQ)lehesr(Sw5d5AUWLf>02wtb+&ObB5c%;dVB83+jX!U$jB$31oI)SKcyl8 z8l^NxUVb1}lI06SPVW<@oF|dZOgrCC9Jh#W65Cu!U7uTcq9JlX1;lCJM&YS=H@r+U zR2c5Nx;xUJWvvY6^y@lmQx){|-w6shYiQ#ERE8f+YR!flmrh;io{W&+!}Z+RCgytW2B!wT$D* z{Z*u&;d#_`!`l9JNiEmGhjZSm@P z+i}tyTx^bHmyyGmz5#O;a==sZp zRkXmH#-MHemGM}$I$7)GFkRB%Cv2=2M#C`lf(y~$#MFoXP>xE>w-CqwVLXw>^s&3g zH($B0Y^Lz7+hQvvS#KYXZ$qBDltu0UP|q5%)JjXZT~#-8XDkR0{6Zf>25W@_Ims7= zlOyOH;@;{g?*AnhGG?TpGSy=p+K#zLa*{=^kdXIO-hc$XsK<5^A_!QB&S3n>XOE^M zAt7qX>+#@Y8C;SjAH;$ge`Egbpa+jn0Q0SRgc`m>?|5vy(3jGjUX82RTbB%?A14+~epu7k&No zu`1#$Kabxr;LT~*(Vfk&nW5)x{#M0nM|-!z8ri~wnIbBpaA0_Brpq%4i{5pL8+7n0 zuGwv+UVE`%$XI**bdM}HElqy#!=`AoO=%^2+08H%A3D|nLCWjEpVnC4!wQj$-Wvlr zMz1S=N+wSm@*4`bKNSF1`dP->D{-!xXS0u=wbPzsekM7}x(Oa9wD*n5y<;5ECH7AA zYLv&zGczNH8kj8-WJQ4PK!H66#f$rN^)1|d{(YvPg~rEHGvM0W%`1$LRZ-ke5p+C@%{x`8E1bGO>6X2txhX1k2bDv|O3! zJMzc`0bW+%(O|4Tx9pva{v;T5Na!2w$Jb&VwU8b`y6{A%FaF+$|V7=!+ zM!qVjansW8Qp7&>q06fbm4{z4^(>-00f-h45a|MS8C)~|k47j=Cp|0HB7@jboZOSU zVgLzPQ9nElW@*oIBtg6aal^YUMbgwMc&Y+WRgHi7mI6jkAa)&zYvLN+cD4P}7p7ly zt9R%2xGJ{Qg6B6_Di$i~Z}>H~RK}er;Rx8?ja-QxMg-p2GeAi=YJuzr8uo&_}5 z&`_k35fg;EblAqw6coR5--&%LXRt>=!ds5kUrs;o#vq1O-^6v9tawUXL>b(ETREuI zdb>>-JG0y-84!_w-S?y285ERR5?gdvj@gAV4ed6Fyls3yPsKQktu&a$|D+3tE{ zFE2ihq}+N$Xw5UW!(0>5fqQg@9={|En7EMP(QN@tDOhaH#A+>qu#^vKcSo5@{?8O) zE(AKl^a9(i+~1pbFqKif34gZ{*69c)quO@O$uM-2VV%5S-=}Qi5KNB3fZ8<(4_>0jItJby^u7ep+f3-6B;%z4 sC-3NzaQf%=lJQ1@egDS|y}qUNDn^ku7MlpXk{1K6pe|qW$UOM}0EZFKi2wiq literal 0 HcmV?d00001 diff --git a/docs/userguide/networking/images/network_access.svg b/docs/userguide/networking/images/network_access.svg new file mode 100644 index 0000000000..33c84465db --- /dev/null +++ b/docs/userguide/networking/images/network_access.svg @@ -0,0 +1 @@ +container2external_containercontainer1isolated_nwDockerHostcontainer3externalhostpublishedport \ No newline at end of file diff --git a/docs/userguide/networking/images/overlay-network-final.gliffy b/docs/userguide/networking/images/overlay-network-final.gliffy new file mode 100644 index 0000000000..75b878de15 --- /dev/null +++ b/docs/userguide/networking/images/overlay-network-final.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":361,"height":263,"nodeIndex":249,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":23.000000000000057,"y":8.18899694824222},"max":{"x":360.00000000000006,"y":262.0000000000038}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":140.0,"y":162.1999969482422,"rotation":0.0,"id":247,"width":33.0,"height":11.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":107,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":238,"py":0.9999999999999998,"px":0.29289321881345254}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":134,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-3.2842712474617883,-3.971422467905427],[-3.2842712474617883,16.319999999999993],[-43.562548866301796,16.319999999999993],[-43.562548866301796,-3.680000000000007]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":187.0,"y":134.1999969482422,"rotation":0.0,"id":246,"width":18.0,"height":17.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":106,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":134,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":223,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[-90.5625488663018,-35.68000000000001],[-90.5625488663018,-60.68000000000001],[-43.0,-60.68000000000001],[-43.0,-25.428571428571402]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":166.0,"y":169.1999969482422,"rotation":0.0,"id":245,"width":22.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":105,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":172,"py":0.7071067811865475,"px":0.0}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":228,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[7.000000000000028,-0.3795674614555935],[-6.5,-0.3795674614555935],[-6.5,29.50000000000003],[-20.0,29.50000000000003]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":189.0,"y":197.1999969482422,"rotation":0.0,"id":244,"width":15.0,"height":36.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":104,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":155,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":233,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[2.437451133698204,-1.6800000000000068],[2.437451133698204,37.5],[-19.0,37.5]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":292.0,"y":163.1999969482422,"rotation":0.0,"id":242,"width":51.0,"height":8.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":102,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":158,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":218,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[0.43745113369817545,1.1599999999999682],[0.43745113369817545,21.428571428571473],[-52.0,21.428571428571473],[-52.0,1.4285714285714732]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":289.0,"y":102.19999694824219,"rotation":0.0,"id":240,"width":51.0,"height":4.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":100,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":158,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":200,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[3.4374511336981755,2.159999999999968],[3.4374511336981755,-7.840000000000032],[-51.0,-7.840000000000032],[-51.0,8.571428571428598]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":23.000000000000057,"y":81.00000000000378,"rotation":180.0,"id":175,"width":337.0,"height":181.0,"uid":"com.gliffy.shape.iphone.iphone_ios7.icons_glyphs.glyph_cloud","order":41,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.iphone.iphone_ios7.icons_glyphs.glyph_cloud","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#929292","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":52.0,"y":8.18899694824222,"rotation":0.0,"id":178,"width":274.0,"height":205.01099999999997,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":42,"lockAspectRatio":false,"lockShape":false,"children":[{"x":25.999999999999996,"y":110.19640369599998,"rotation":0.0,"id":173,"width":20.88802989941042,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":40,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":121.00000000000003,"y":147.19640369599998,"rotation":0.0,"id":172,"width":20.88802989941042,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":38,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":222.0,"y":114.19640369599998,"rotation":0.0,"id":171,"width":20.88802989941042,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":36,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":135.0,"y":39.01099999999997,"rotation":0.0,"id":169,"width":86.0,"height":50.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":34,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":134,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.3867377051204244,-0.010999999999967258],[-90.5625488663018,51.31999999999999]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":140.0,"y":34.01099999999997,"rotation":0.0,"id":168,"width":4.0,"height":91.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":32,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":155,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-2.6132622948795756,4.989000000000033],[-0.5625488663017961,93.32]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":170.0,"y":22.010999999999967,"rotation":0.0,"id":165,"width":72.0,"height":73.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":30,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":158,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-32.613262294879576,16.989000000000033],[70.43745113369818,74.15999999999997]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":113.0,"y":0.0,"rotation":0.0,"id":160,"width":48.773475410240856,"height":39.0,"uid":"com.gliffy.shape.cisco.cisco_v1.storage.relational_database","order":27,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.storage.relational_database","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#02709F","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":163,"width":88.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Key-value store

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":null},{"x":196.0,"y":96.17099999999994,"rotation":0.0,"id":156,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":20,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":157,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":23,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":158,"width":42.8749022673964,"height":60.000000000000014,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":18,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":95.0,"y":127.33099999999996,"rotation":0.0,"id":153,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":12,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":154,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":15,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":155,"width":42.8749022673964,"height":60.000000000000014,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":10,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":90.33099999999996,"rotation":0.0,"id":152,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":7,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":5,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":134,"width":42.8749022673964,"height":60.000000000000014,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":2,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":218.0,"y":109.69999694824222,"rotation":0.0,"id":196,"width":40.0,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":47,"lockAspectRatio":false,"lockShape":false,"children":[{"x":18.8,"y":1.7857142857142847,"rotation":0.0,"id":197,"width":2.399999999999999,"height":16.428571428571416,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":53,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":200,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":200,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.1999999999999886,-0.7142857142857082],[1.1999999999999886,17.14285714285714]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":33.2,"y":1.7857142857142847,"rotation":0.0,"id":198,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":51,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.9157287525381217,-0.7142857142858963],[-0.9157287525381217,17.142857142857224]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":6.399999999999995,"y":0.8333333333333324,"rotation":0.0,"id":199,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":49,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.3157287525380146,0.23809523809532174],[1.3157287525380146,18.09523809523801]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.0714285714285707,"rotation":0.0,"id":200,"width":40.0,"height":17.857142857142858,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":46,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":220.0,"y":145.69999694824222,"rotation":0.0,"id":214,"width":40.0,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":57,"lockAspectRatio":false,"lockShape":false,"children":[{"x":18.8,"y":1.7857142857142847,"rotation":0.0,"id":215,"width":2.399999999999999,"height":16.428571428571416,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":62,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":218,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":218,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.1999999999999886,-0.714285714285694],[1.1999999999999886,17.142857142857167]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":33.2,"y":1.7857142857142847,"rotation":0.0,"id":216,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":60,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.9157287525381217,-0.7142857142858963],[-0.9157287525381217,17.142857142857224]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":6.399999999999995,"y":0.8333333333333324,"rotation":0.0,"id":217,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":58,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.3157287525380146,0.23809523809532174],[1.3157287525380146,18.09523809523801]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.0714285714285707,"rotation":0.0,"id":218,"width":40.0,"height":17.857142857142858,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":56,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":124.0,"y":107.69999694824222,"rotation":0.0,"id":219,"width":40.0,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":66,"lockAspectRatio":false,"lockShape":false,"children":[{"x":18.8,"y":1.7857142857142847,"rotation":0.0,"id":220,"width":2.399999999999999,"height":16.428571428571416,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":71,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":223,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":223,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.1999999999999886,-0.7142857142857082],[1.1999999999999886,17.142857142857153]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":33.2,"y":1.7857142857142847,"rotation":0.0,"id":221,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":69,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.9157287525381217,-0.7142857142858963],[-0.9157287525381217,17.142857142857224]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":6.399999999999995,"y":0.8333333333333324,"rotation":0.0,"id":222,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":67,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.3157287525380146,0.23809523809532174],[1.3157287525380146,18.09523809523801]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.0714285714285707,"rotation":0.0,"id":223,"width":40.0,"height":17.857142857142858,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":65,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":106.0,"y":188.69999694824222,"rotation":0.0,"id":224,"width":40.0,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":75,"lockAspectRatio":false,"lockShape":false,"children":[{"x":18.8,"y":1.7857142857142847,"rotation":0.0,"id":225,"width":2.399999999999999,"height":16.428571428571416,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":80,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":228,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":228,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.2000000000000028,-0.714285714285694],[1.2000000000000028,17.142857142857167]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":33.2,"y":1.7857142857142847,"rotation":0.0,"id":226,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":78,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.9157287525381217,-0.7142857142858963],[-0.9157287525381217,17.142857142857224]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":6.399999999999995,"y":0.8333333333333324,"rotation":0.0,"id":227,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":76,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.3157287525380146,0.23809523809532174],[1.3157287525380146,18.09523809523801]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.0714285714285707,"rotation":0.0,"id":228,"width":40.0,"height":17.857142857142858,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":74,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":130.0,"y":224.6999969482422,"rotation":0.0,"id":229,"width":40.0,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":84,"lockAspectRatio":false,"lockShape":false,"children":[{"x":18.8,"y":1.7857142857142847,"rotation":0.0,"id":230,"width":2.399999999999999,"height":16.428571428571416,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":89,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":233,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":233,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.1999999999999886,-0.714285714285694],[1.1999999999999886,17.142857142857167]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":33.2,"y":1.7857142857142847,"rotation":0.0,"id":231,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":87,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.9157287525381217,-0.7142857142858963],[-0.9157287525381217,17.142857142857224]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":6.399999999999995,"y":0.8333333333333324,"rotation":0.0,"id":232,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":85,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.3157287525380146,0.23809523809532174],[1.3157287525380146,18.09523809523801]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.0714285714285707,"rotation":0.0,"id":233,"width":40.0,"height":17.857142857142858,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":83,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":125.00000000000011,"y":139.30000305176532,"rotation":0.0,"id":234,"width":40.0,"height":20.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":93,"lockAspectRatio":false,"lockShape":false,"children":[{"x":18.8,"y":1.7857142857142847,"rotation":0.0,"id":235,"width":2.399999999999999,"height":16.428571428571416,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":98,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":238,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":238,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.1999999999999886,-0.714285714285694],[1.1999999999999886,17.142857142857167]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":33.2,"y":1.7857142857142847,"rotation":0.0,"id":236,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":96,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-0.9157287525381217,-0.7142857142858963],[-0.9157287525381217,17.142857142857224]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":6.399999999999995,"y":0.8333333333333324,"rotation":0.0,"id":237,"width":1.3333333333333333,"height":17.14285714285713,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":94,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.3157287525380146,0.23809523809532174],[1.3157287525380146,18.09523809523801]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":0.0,"y":1.0714285714285707,"rotation":0.0,"id":238,"width":40.0,"height":17.857142857142858,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":92,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":109}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#999999","strokeWidth":2}},"textStyles":{"global":{"bold":true,"face":"Courier"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.custom.confluence.c20f4a380e3cee362007f9e62694d34d947f28ed4263c0702b3dd72d9801532a"],"lastSerialized":1445556943068},"embeddedResources":{"index":1,"resources":[{"id":0,"mimeType":"image/svg+xml","data":"\n\n \n logo copy\n Created with Sketch.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","width":59.29392246992643,"height":42.185403696,"x":0.4429050300735753,"y":0.7077644040000006}]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/overlay-network-final.png b/docs/userguide/networking/images/overlay-network-final.png new file mode 100644 index 0000000000000000000000000000000000000000..3031839348ec7663b7116c54377467a0de1258ad GIT binary patch literal 28072 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/networking/images/overlay-network-final.svg b/docs/userguide/networking/images/overlay-network-final.svg new file mode 100644 index 0000000000..8ff3b3e52a --- /dev/null +++ b/docs/userguide/networking/images/overlay-network-final.svg @@ -0,0 +1 @@ +HostHostHostKey-valuestore \ No newline at end of file diff --git a/docs/userguide/networking/images/overlay_network.gliffy b/docs/userguide/networking/images/overlay_network.gliffy new file mode 100644 index 0000000000..e4a6ed9594 --- /dev/null +++ b/docs/userguide/networking/images/overlay_network.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":361,"height":291,"nodeIndex":195,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":23.000000000000057,"y":8.18899694824222},"max":{"x":360.00000000000006,"y":290.6999969482422}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":194.0,"y":200.1999969482422,"rotation":0.0,"id":193,"width":47.0,"height":77.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":41,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[10.0,-6.0],[47.0,77.0]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":64.0,"y":272.6999969482422,"rotation":0.0,"id":179,"width":247.0,"height":24.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":27,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":5,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

docker network create -d overlay

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":23.000000000000057,"y":81.00000000000378,"rotation":180.0,"id":175,"width":337.0,"height":181.0,"uid":"com.gliffy.shape.iphone.iphone_ios7.icons_glyphs.glyph_cloud","order":25,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.iphone.iphone_ios7.icons_glyphs.glyph_cloud","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#929292","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":52.0,"y":8.18899694824222,"rotation":0.0,"id":178,"width":274.0,"height":205.01099999999997,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":26,"lockAspectRatio":false,"lockShape":false,"children":[{"x":25.999999999999996,"y":110.19640369599998,"rotation":0.0,"id":173,"width":20.88802989941042,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":23,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":121.00000000000003,"y":147.19640369599998,"rotation":0.0,"id":172,"width":20.88802989941042,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":22,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":222.0,"y":114.19640369599998,"rotation":0.0,"id":171,"width":20.88802989941042,"height":19.0,"uid":"com.gliffy.shape.basic.basic_v1.default.svg","order":21,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Svg","Svg":{"embeddedResourceId":0,"strokeWidth":2.0,"strokeColor":"#000000","dropShadow":true,"shadowX":5.0,"shadowY":5.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":135.0,"y":39.01099999999997,"rotation":0.0,"id":169,"width":86.0,"height":50.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":20,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":134,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.3867377051204244,-0.010999999999967258],[-90.5625488663018,51.31999999999999]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":140.0,"y":34.01099999999997,"rotation":0.0,"id":168,"width":4.0,"height":91.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":19,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":155,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-2.6132622948795756,4.989000000000033],[-0.5625488663017961,93.32]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":170.0,"y":22.010999999999967,"rotation":0.0,"id":165,"width":72.0,"height":73.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":18,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":160,"py":1.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":158,"py":0.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#999999","fillColor":"none","dashStyle":"1.0,1.0","startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-32.613262294879576,16.989000000000033],[70.43745113369818,74.15999999999997]],"lockSegments":{},"ortho":false}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":113.0,"y":0.0,"rotation":0.0,"id":160,"width":48.773475410240856,"height":39.0,"uid":"com.gliffy.shape.cisco.cisco_v1.storage.relational_database","order":15,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.storage.relational_database","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#02709F","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[{"x":2.0,"y":0.0,"rotation":0.0,"id":163,"width":88.0,"height":14.0,"uid":null,"order":"auto","lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"both","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Key-value store

","tid":null,"valign":"middle","vposition":"below","hposition":"none"}},"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":null},{"x":196.0,"y":96.17099999999994,"rotation":0.0,"id":156,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":12,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":157,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":14,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":158,"width":42.8749022673964,"height":60.000000000000014,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":11,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":95.0,"y":127.33099999999996,"rotation":0.0,"id":153,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":7,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":154,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":155,"width":42.8749022673964,"height":60.000000000000014,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":6,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null},{"x":0.0,"y":90.33099999999996,"rotation":0.0,"id":152,"width":78.0,"height":77.68,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":4,"lockAspectRatio":false,"lockShape":false,"children":[{"x":0.0,"y":63.68000000000001,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":3,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"children":[],"hidden":false,"layerId":null},{"x":23.0,"y":0.0,"rotation":0.0,"id":134,"width":42.8749022673964,"height":60.000000000000014,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":1,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":null}],"hidden":false,"layerId":null}],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":43}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#999999","strokeWidth":2,"endArrow":2}},"textStyles":{"global":{"bold":true,"face":"Courier"}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":["com.gliffy.custom.confluence.c20f4a380e3cee362007f9e62694d34d947f28ed4263c0702b3dd72d9801532a"],"lastSerialized":1445556181238},"embeddedResources":{"index":1,"resources":[{"id":0,"mimeType":"image/svg+xml","data":"\n\n \n logo copy\n Created with Sketch.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","width":59.29392246992643,"height":42.185403696,"x":0.4429050300735753,"y":0.7077644040000006}]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/overlay_network.png b/docs/userguide/networking/images/overlay_network.png new file mode 100644 index 0000000000000000000000000000000000000000..9d728b818273b43d9a0e36c7845e0f53bd757519 GIT binary patch literal 23276 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 z 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 R6%F_^xnyDRQqS?>e*lpyD-8eu literal 0 HcmV?d00001 diff --git a/docs/userguide/networking/images/overlay_network.svg b/docs/userguide/networking/images/overlay_network.svg new file mode 100644 index 0000000000..f53de1244a --- /dev/null +++ b/docs/userguide/networking/images/overlay_network.svg @@ -0,0 +1 @@ +HostHostHostKey-valuestoredockernetworkcreate-doverlay \ No newline at end of file diff --git a/docs/userguide/networking/images/working.gliffy b/docs/userguide/networking/images/working.gliffy new file mode 100644 index 0000000000..5831a460bd --- /dev/null +++ b/docs/userguide/networking/images/working.gliffy @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.3","stage":{"background":"#ffffff","width":376,"height":241,"nodeIndex":152,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":false,"drawingGuidesOn":false,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"maxWidth":5000,"maxHeight":5000,"themeData":null,"viewportType":"default","fitBB":{"min":{"x":1,"y":5.1999969482421875},"max":{"x":375.38636363636374,"y":240.14285409109937}},"printModel":{"pageSize":"a4","portrait":false,"fitToOnePage":false,"displayPageBreaks":false},"objects":[{"x":85.0,"y":50.0,"rotation":0.0,"id":150,"width":211.0,"height":31.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":60,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":134,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":6.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[3.1159999999999997,6.359996948242184],[180.558,6.359996948242184],[180.558,67.0],[180.0,67.0]],"lockSegments":{"1":true},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":196.0,"y":100.69999694824219,"rotation":0.0,"id":140,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":56,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"


","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":15.0,"y":5.1999969482421875,"rotation":0.0,"id":134,"width":73.116,"height":102.32,"uid":"com.gliffy.shape.cisco.cisco_v1.servers.standard_host","order":54,"lockAspectRatio":true,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.cisco.cisco_v1.servers.standard_host","strokeWidth":2.0,"strokeColor":"#333333","fillColor":"#3d85c6","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":53.0,"y":57.19999694824219,"rotation":0.0,"id":136,"width":119.0,"height":45.0,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":55,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":134,"py":0.5,"px":1.0}}},"graphic":{"type":"Line","Line":{"strokeWidth":6.0,"strokeColor":"#999999","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":10.0,"controlPath":[[35.116,-0.8400000000000034],[89.0,-0.8400000000000034],[89.0,57.0]],"lockSegments":{},"ortho":true}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":5.0,"y":116.19999694824219,"rotation":0.0,"id":142,"width":78.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":57,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

Docker Host

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":113.38636363636374,"y":116.14285409109937,"rotation":0.0,"id":129,"width":262.0,"height":124.0,"uid":"com.gliffy.shape.iphone.iphone_ios7.icons_glyphs.glyph_cloud","order":0,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.iphone.iphone_ios7.icons_glyphs.glyph_cloud","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#929292","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":15.386363636363683,"y":113.14285409109937,"rotation":0.0,"id":146,"width":233.0,"height":127.0,"uid":"com.gliffy.shape.iphone.iphone_ios7.icons_glyphs.glyph_cloud","order":1,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.iphone.iphone_ios7.icons_glyphs.glyph_cloud","strokeWidth":1.0,"strokeColor":"#000000","fillColor":"#929292","gradient":false,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":106.0,"y":175.96785409109907,"rotation":0.0,"id":114,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":18,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":95,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":6,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":96,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":15,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":99,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":99,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":97,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":12,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":98,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":9,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":99,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":4,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":112,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":17,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container2

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":217.0,"y":177.96785409109907,"rotation":0.0,"id":115,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":35,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":116,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":23,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":117,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":32,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":120,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":120,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8600000000000136,-1.1785714285714448],[1.8600000000000136,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":118,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":29,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":119,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":26,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":120,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":21,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":121,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":34,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container3

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":-1.0,"y":175.96785409109907,"rotation":0.0,"id":122,"width":150.0,"height":54.732142857143145,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":52,"lockAspectRatio":false,"lockShape":false,"children":[{"x":44.0,"y":2.7321428571431454,"rotation":0.0,"id":123,"width":62.0,"height":33.0,"uid":"com.gliffy.shape.basic.basic_v1.default.group","order":40,"lockAspectRatio":false,"lockShape":false,"children":[{"x":29.139999999999997,"y":2.94642857142857,"rotation":0.0,"id":124,"width":3.719999999999998,"height":27.107142857142843,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":49,"lockAspectRatio":false,"lockShape":false,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":127,"py":0.0,"px":0.5}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":127,"py":1.0,"px":0.5}}},"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[1.8599999999999994,-1.1785714285714448],[1.8599999999999994,28.285714285714278]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":51.46,"y":2.94642857142857,"rotation":0.0,"id":125,"width":1.2156862745098034,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":46,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[-1.4193795664340882,-1.178571428571729],[-1.4193795664340882,28.28571428571442]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":9.919999999999993,"y":1.3749999999999987,"rotation":0.0,"id":126,"width":1.239999999999999,"height":28.285714285714267,"uid":"com.gliffy.shape.basic.basic_v1.default.line","order":43,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Line","Line":{"strokeWidth":2.0,"strokeColor":"#0b5394","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":0,"startArrowRotation":"auto","endArrowRotation":"auto","interpolationType":"linear","cornerRadius":null,"controlPath":[[2.0393795664339223,0.3928571428572809],[2.0393795664339223,29.85714285714272]],"lockSegments":{},"ortho":false}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":0.0,"y":1.7678571428571417,"rotation":0.0,"id":127,"width":62.0,"height":29.46428571428572,"uid":"com.gliffy.shape.basic.basic_v1.default.rectangle","order":38,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2.0,"strokeColor":"#6fa8dc","fillColor":"#3d85c6","gradient":true,"dashStyle":null,"dropShadow":false,"state":0,"opacity":1.0,"shadowX":0.0,"shadowY":0.0}},"linkMap":[],"children":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":0.0,"y":40.732142857143145,"rotation":0.0,"id":128,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":51,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

container1

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":185.0,"y":143.1999969482422,"rotation":0.0,"id":130,"width":150.0,"height":28.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":53,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

isolated_nw

 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"},{"x":55.0,"y":139.1999969482422,"rotation":0.0,"id":147,"width":150.0,"height":14.0,"uid":"com.gliffy.shape.basic.basic_v1.default.text","order":58,"lockAspectRatio":false,"lockShape":false,"graphic":{"type":"Text","Text":{"overflow":"none","paddingTop":2,"paddingRight":2,"paddingBottom":2,"paddingLeft":2,"outerPaddingTop":6,"outerPaddingRight":6,"outerPaddingBottom":2,"outerPaddingLeft":6,"type":"fixed","lineTValue":null,"linePerpValue":null,"cardinalityType":null,"html":"

bridge 

","tid":null,"valign":"middle","vposition":"none","hposition":"none"}},"linkMap":[],"hidden":false,"layerId":"9wom3rMkTrb3"}],"layers":[{"guid":"9wom3rMkTrb3","order":0,"name":"Layer 0","active":true,"locked":false,"visible":true,"nodeIndex":62}],"shapeStyles":{},"lineStyles":{"global":{"stroke":"#999999","strokeWidth":6}},"textStyles":{"global":{"bold":true}}},"metadata":{"title":"untitled","revision":0,"exportBorder":false,"loadPosition":"default","libraries":[],"lastSerialized":1446315118663,"analyticsProduct":"Confluence"},"embeddedResources":{"index":0,"resources":[]}} \ No newline at end of file diff --git a/docs/userguide/networking/images/working.png b/docs/userguide/networking/images/working.png new file mode 100644 index 0000000000000000000000000000000000000000..8539913aff6aa0597c3600d7c0c01cef7efa0222 GIT binary patch literal 18319 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 bpM2V^?Rx*%sy_n{+F|f?^>bP0l+XkK?n-Gh literal 0 HcmV?d00001 diff --git a/docs/userguide/networking/images/working.svg b/docs/userguide/networking/images/working.svg new file mode 100644 index 0000000000..f39955e1d1 --- /dev/null +++ b/docs/userguide/networking/images/working.svg @@ -0,0 +1 @@ +container2container3container1isolated_nwDockerHostbridge \ No newline at end of file diff --git a/docs/userguide/networking/index.md b/docs/userguide/networking/index.md new file mode 100644 index 0000000000..7680b199fa --- /dev/null +++ b/docs/userguide/networking/index.md @@ -0,0 +1,21 @@ + + +# Docker networks feature overview + +This sections explains how to use the Docker networks feature. This feature allows users to define their own networks and connect containers to them. Using this feature you can create a network on a single host or a network that spans across multiple hosts. + +- [Understand Docker container networks](dockernetworks.md) +- [Work with network commands](work-with-networks.md) +- [Get started with multi-host networking](get-started-overlay.md) + +If you are already familiar with Docker's default bridge network, `docker0` that network continues to be supported. It is created automatically in every installation. The default bridge network is also named `bridge`. To see a list of topics related to that network, read the articles listed in the [Docker default bridge network](default_network/index.md). diff --git a/docs/userguide/networking/work-with-networks.md b/docs/userguide/networking/work-with-networks.md new file mode 100644 index 0000000000..d346fec596 --- /dev/null +++ b/docs/userguide/networking/work-with-networks.md @@ -0,0 +1,463 @@ + + +# Work with network commands + +This article provides examples of the network subcommands you can use to interact with Docker networks and the containers in them. The commands are available through the Docker Engine CLI. These commands are: + +* `docker network create` +* `docker network connect` +* `docker network ls` +* `docker network rm` +* `docker network disconnect` +* `docker network inspect` + +While not required, it is a good idea to read [Understanding Docker +network](dockernetworks.md) before trying the examples in this section. The +examples for the rely on a `bridge` network so that you can try them +immediately. If you would prefer to experiment with an `overlay` network see +the [Getting started with multi-host networks](get-started-overlay.md) instead. + +## Create networks + +Docker Engine creates a `bridge` network automatically when you install Engine. +This network corresponds to the `docker0` bridge that Engine has traditionally +relied on. In addition to this network, you can create your own `bridge` or `overlay` network. + +A `bridge` network resides on a single host running an instance of Docker Engine. An `overlay` network can span multiple hosts running their own engines. If you run `docker network create` and supply only a network name, it creates a bridge network for you. + +```bash +$ docker network create simple-network +de792b8258895cf5dc3b43835e9d61a9803500b991654dacb1f4f0546b1c88f8 +$ docker network inspect simple-network +[ + { + "Name": "simple-network", + "Id": "de792b8258895cf5dc3b43835e9d61a9803500b991654dacb1f4f0546b1c88f8", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": {}, + "Options": {} + } +] +``` + +Unlike `bridge` networks, `overlay` networks require some pre-existing conditions +before you can create one. These conditions are: + +* Access to a key-value store. Engine supports Consul Etcd, and ZooKeeper (Distributed store) key-value stores. +* A cluster of hosts with connectivity to the key-value store. +* A properly configured Engine `daemon` on each host in the swarm. + +The `docker daemon` options that support the `overlay` network are: + +* `--cluster-store` +* `--cluster-store-opt` +* `--cluster-advertise` + +It is also a good idea, though not required, that you install Docker Swarm +to manage the cluster. Swarm provides sophisticated discovery and server +management that can assist your implementation. + +When you create a network, Engine creates a non-overlapping subnetwork for the +network by default. You can override this default and specify a subnetwork +directly using the the `--subnet` option. On a `bridge` network you can only +create a single subnet. An `overlay` network supports multiple subnets. + +In addition to the `--subnetwork` option, you also specify the `--gateway` `--ip-range` and `--aux-address` options. + +```bash +$ docker network create -d overlay + --subnet=192.168.0.0/16 --subnet=192.170.0.0/16 + --gateway=192.168.0.100 --gateway=192.170.0.100 + --ip-range=192.168.1.0/24 + --aux-address a=192.168.1.5 --aux-address b=192.168.1.6 + --aux-address a=192.170.1.5 --aux-address b=192.170.1.6 + my-multihost-network +``` + +Be sure that your subnetworks do not overlap. If they do, the network create fails and Engine returns an error. + +## Connect containers + +You can connect containers dynamically to one or more networks. These networks +can be backed the same or different network drivers. Once connected, the +containers can communicate using another container's IP address or name. + +For `overlay` networks or custom plugins that support multi-host +connectivity, containers connected to the same multi-host network but launched +from different hosts can also communicate in this way. + +Create two containers for this example: + +```bash +$ docker run -itd --name=container1 busybox +18c062ef45ac0c026ee48a83afa39d25635ee5f02b58de4abc8f467bcaa28731 + +$ docker run -itd --name=container2 busybox +498eaaaf328e1018042c04b2de04036fc04719a6e39a097a4f4866043a2c2152 +``` + +Then create a isolated, `bridge` network to test with. + +```bash +$ docker network create -d bridge isolated_nw +f836c8deb6282ee614eade9d2f42d590e603d0b1efa0d99bd88b88c503e6ba7a +``` + +Connect `container2` to the network and then `inspect` the network to verify the connection: + +``` +$ docker network connect isolated_nw container2 +$ docker network inspect isolated_nw +[[ + { + "Name": "isolated_nw", + "Id": "f836c8deb6282ee614eade9d2f42d590e603d0b1efa0d99bd88b88c503e6ba7a", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": { + "498eaaaf328e1018042c04b2de04036fc04719a6e39a097a4f4866043a2c2152": { + "EndpointID": "0e24479cfaafb029104999b4e120858a07b19b1b6d956ae56811033e45d68ad9", + "MacAddress": "02:42:ac:15:00:02", + "IPv4Address": "172.21.0.2/16", + "IPv6Address": "" + } + }, + "Options": {} + } +] +``` + +You can see that the Engine automatically assigns an IP address to `container2`. +If you had specified a `--subnetwork` when creating your network, the network +would have used that addressing. Now, start a third container and connect it to +the network on launch using the `docker run` command's `--net` option: + +```bash +$ docker run --net=isolated_nw -itd --name=container3 busybox +c282ca437ee7e926a7303a64fc04109740208d2c20e442366139322211a6481c +``` + +Now, inspect the network resources used by `container3`. + +```bash +$ docker inspect --format='{{json .NetworkSettings.Networks}}' container3 +{"isolated_nw":{"EndpointID":"e5d077f9712a69c6929fdd890df5e7c1c649771a50df5b422f7e68f0ae61e847","Gateway":"172.21.0.1","IPAddress":"172.21.0.3","IPPrefixLen":16,"IPv6Gateway":"","GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"MacAddress":"02:42:ac:15:00:03"}} +``` +Repeat this command for `container2`. If you have Python installed, you can pretty print the output. + +```bash +$ docker inspect --format='{{json .NetworkSettings.Networks}}' container2 | python -m json.tool +{ + "bridge": { + "EndpointID": "281b5ead415cf48a6a84fd1a6504342c76e9091fe09b4fdbcc4a01c30b0d3c5b", + "Gateway": "172.17.0.1", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "IPAddress": "172.17.0.3", + "IPPrefixLen": 16, + "IPv6Gateway": "", + "MacAddress": "02:42:ac:11:00:03" + }, + "isolated_nw": { + "EndpointID": "0e24479cfaafb029104999b4e120858a07b19b1b6d956ae56811033e45d68ad9", + "Gateway": "172.21.0.1", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "IPAddress": "172.21.0.2", + "IPPrefixLen": 16, + "IPv6Gateway": "", + "MacAddress": "02:42:ac:15:00:02" + } +} +``` + +You should find `container2` belongs to two networks. The `bridge` network +which it joined by default when you launched it and the `isolated_nw` which you +later connected it to. + +![](images/working.png) + +In the case of `container3`, you connected it through `docker run` to the +`isolated_nw` so that container is not connected to `bridge`. + +Use the `docker attach` command to connect to the running `container2` and +examine its networking stack: + +```bash +$ docker attach container2 +``` + +If you look a the container's network stack you should see two Ethernet interfaces, one for the default bridge network and one for the `isolated_nw` network. + +```bash +/ # ifconfig +eth0 Link encap:Ethernet HWaddr 02:42:AC:11:00:03 + inet addr:172.17.0.3 Bcast:0.0.0.0 Mask:255.255.0.0 + inet6 addr: fe80::42:acff:fe11:3/64 Scope:Link + UP BROADCAST RUNNING MULTICAST MTU:9001 Metric:1 + RX packets:8 errors:0 dropped:0 overruns:0 frame:0 + TX packets:8 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:648 (648.0 B) TX bytes:648 (648.0 B) + +eth1 Link encap:Ethernet HWaddr 02:42:AC:15:00:02 + inet addr:172.21.0.2 Bcast:0.0.0.0 Mask:255.255.0.0 + inet6 addr: fe80::42:acff:fe15:2/64 Scope:Link + UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 + RX packets:8 errors:0 dropped:0 overruns:0 frame:0 + TX packets:8 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:648 (648.0 B) TX bytes:648 (648.0 B) + +lo Link encap:Local Loopback + inet addr:127.0.0.1 Mask:255.0.0.0 + inet6 addr: ::1/128 Scope:Host + UP LOOPBACK RUNNING MTU:65536 Metric:1 + RX packets:0 errors:0 dropped:0 overruns:0 frame:0 + TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) +``` + +Display the container's `etc/hosts` file: + +```bash +/ # cat /etc/hosts +172.17.0.3 498eaaaf328e +127.0.0.1 localhost +::1 localhost ip6-localhost ip6-loopback +fe00::0 ip6-localnet +ff00::0 ip6-mcastprefix +ff02::1 ip6-allnodes +ff02::2 ip6-allrouters +172.21.0.3 container3 +172.21.0.3 container3.isolated_nw +``` + +On the `isolated_nw` which was user defined, the Docker network feature updated the `/etc/hosts` with the proper name resolution. Inside of `container2` it is possible to ping `container3` by name. + +```bash +/ # ping -w 4 container3 +PING container3 (172.21.0.3): 56 data bytes +64 bytes from 172.21.0.3: seq=0 ttl=64 time=0.070 ms +64 bytes from 172.21.0.3: seq=1 ttl=64 time=0.080 ms +64 bytes from 172.21.0.3: seq=2 ttl=64 time=0.080 ms +64 bytes from 172.21.0.3: seq=3 ttl=64 time=0.097 ms + +--- container3 ping statistics --- +4 packets transmitted, 4 packets received, 0% packet loss +round-trip min/avg/max = 0.070/0.081/0.097 ms +``` + +This isn't the case for the default bridge network. Both `container2` and `container1` are connected to the default bridge network. Docker does not support automatic service discovery on this network. For this reason, pinging `container1` by name fails as you would expect based on the `/etc/hosts` file: + +```bash +/ # ping -w 4 container1 +ping: bad address 'container1' +``` + +A ping using the `container1` IP address does succeed though: + +```bash +/ # ping -w 4 172.17.0.2 +PING 172.17.0.2 (172.17.0.2): 56 data bytes +64 bytes from 172.17.0.2: seq=0 ttl=64 time=0.095 ms +64 bytes from 172.17.0.2: seq=1 ttl=64 time=0.075 ms +64 bytes from 172.17.0.2: seq=2 ttl=64 time=0.072 ms +64 bytes from 172.17.0.2: seq=3 ttl=64 time=0.101 ms + +--- 172.17.0.2 ping statistics --- +4 packets transmitted, 4 packets received, 0% packet loss +round-trip min/avg/max = 0.072/0.085/0.101 ms +``` + +If you wanted you could connect `container1` to `container2` with the `docker +run --link` command and that would enable the two containers to interact by name +as well as IP. + +Detach from a `container2` and leave it running using `CTRL-p CTRL-q`. + +In this example, `container2` is attached to both networks and so can talk to +`container1` and `container3`. But `container3` and `container1` are not in the +same network and cannot communicate. Test, this now by attaching to +`container3` and attempting to ping `container1` by IP address. + +```bash +$ docker attach container3 +/ # ping 172.17.0.2 +PING 172.17.0.2 (172.17.0.2): 56 data bytes +^C +--- 172.17.0.2 ping statistics --- +10 packets transmitted, 0 packets received, 100% packet loss + +``` + +To connect a container to a network, the container must be running. If you stop +a container and inspect a network it belongs to, you won't see that container. +The `docker network inspect` command only shows running containers. + +## Disconnecting containers + +You can disconnect a container from a network using the `docker network +disconnect` command. + +``` +$ docker network disconnect isolated_nw container2 + +docker inspect --format='{{json .NetworkSettings.Networks}}' container2 | python -m json.tool +{ + "bridge": { + "EndpointID": "9e4575f7f61c0f9d69317b7a4b92eefc133347836dd83ef65deffa16b9985dc0", + "Gateway": "172.17.0.1", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "IPAddress": "172.17.0.3", + "IPPrefixLen": 16, + "IPv6Gateway": "", + "MacAddress": "02:42:ac:11:00:03" + } +} + + +$ docker network inspect isolated_nw +[[ + { + "Name": "isolated_nw", + "Id": "f836c8deb6282ee614eade9d2f42d590e603d0b1efa0d99bd88b88c503e6ba7a", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": { + "c282ca437ee7e926a7303a64fc04109740208d2c20e442366139322211a6481c": { + "EndpointID": "e5d077f9712a69c6929fdd890df5e7c1c649771a50df5b422f7e68f0ae61e847", + "MacAddress": "02:42:ac:15:00:03", + "IPv4Address": "172.21.0.3/16", + "IPv6Address": "" + } + }, + "Options": {} + } +] +``` + +Once a container is disconnected from a network, it cannot communicate with +other containers connected to that network. In this example, `container2` can no longer talk to `container3` on the `isolated_nw` network. + +``` +$ docker attach container2 + +/ # ifconfig +eth0 Link encap:Ethernet HWaddr 02:42:AC:11:00:03 + inet addr:172.17.0.3 Bcast:0.0.0.0 Mask:255.255.0.0 + inet6 addr: fe80::42:acff:fe11:3/64 Scope:Link + UP BROADCAST RUNNING MULTICAST MTU:9001 Metric:1 + RX packets:8 errors:0 dropped:0 overruns:0 frame:0 + TX packets:8 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:648 (648.0 B) TX bytes:648 (648.0 B) + +lo Link encap:Local Loopback + inet addr:127.0.0.1 Mask:255.0.0.0 + inet6 addr: ::1/128 Scope:Host + UP LOOPBACK RUNNING MTU:65536 Metric:1 + RX packets:0 errors:0 dropped:0 overruns:0 frame:0 + TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 + collisions:0 txqueuelen:0 + RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) + +/ # ping container3 +PING container3 (172.20.0.1): 56 data bytes +^C +--- container3 ping statistics --- +2 packets transmitted, 0 packets received, 100% packet loss +``` + +The `container2` still has full connectivity to the bridge network + +```bash +/ # ping container1 +PING container1 (172.17.0.2): 56 data bytes +64 bytes from 172.17.0.2: seq=0 ttl=64 time=0.119 ms +64 bytes from 172.17.0.2: seq=1 ttl=64 time=0.174 ms +^C +--- container1 ping statistics --- +2 packets transmitted, 2 packets received, 0% packet loss +round-trip min/avg/max = 0.119/0.146/0.174 ms +/ # +``` + +## Remove a network + +When all the containers in a network are stopped or disconnected, you can remove a network. + +```bash +$ docker network disconnect isolated_nw container3 +``` + +```bash +docker network inspect isolated_nw +[ + { + "Name": "isolated_nw", + "Id": "f836c8deb6282ee614eade9d2f42d590e603d0b1efa0d99bd88b88c503e6ba7a", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": {}, + "Options": {} + } +] + +$ docker network rm isolated_nw +``` + +List all your networks to verify the `isolated_nw` was removed: + +``` +$ docker network ls +NETWORK ID NAME DRIVER +72314fa53006 host host +f7ab26d71dbd bridge bridge +0f32e83e61ac none null +``` + +## Related information + +* [network create](../../reference/commandline/network_create.md) +* [network inspect](../../reference/commandline/network_inspect.md) +* [network connect](../../reference/commandline/network_connect.md) +* [network disconnect](../../reference/commandline/network_disconnect.md) +* [network ls](../../reference/commandline/network_ls.md) +* [network rm](../../reference/commandline/network_rm.md) diff --git a/docs/userguide/networkingcontainers.md b/docs/userguide/networkingcontainers.md new file mode 100644 index 0000000000..3a44e3b1d0 --- /dev/null +++ b/docs/userguide/networkingcontainers.md @@ -0,0 +1,240 @@ + + + +# Networking containers + +If you are working your way through the user guide, you just built and ran a +simple application. You've also built in your own images. This section teaches +you how to network your containers. + +## Name a container + +You've already seen that each container you create has an automatically +created name; indeed you've become familiar with our old friend +`nostalgic_morse` during this guide. You can also name containers +yourself. This naming provides two useful functions: + +* You can name containers that do specific functions in a way + that makes it easier for you to remember them, for example naming a + container containing a web application `web`. + +* Names provide Docker with a reference point that allows it to refer to other + containers. There are several commands that support this and you'll use one in a exercise later. + +You name your container by using the `--name` flag, for example launch a new container called web: + + $ docker run -d -P --name web training/webapp python app.py + +Use the `docker ps` command to see check the name: + + $ docker ps -l + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + aed84ee21bde training/webapp:latest python app.py 12 hours ago Up 2 seconds 0.0.0.0:49154->5000/tcp web + +You can also use `docker inspect` with the container's name. + + $ docker inspect web + [ + { + "Id": "3ce51710b34f5d6da95e0a340d32aa2e6cf64857fb8cdb2a6c38f7c56f448143", + "Created": "2015-10-25T22:44:17.854367116Z", + "Path": "python", + "Args": [ + "app.py" + ], + "State": { + "Status": "running", + "Running": true, + "Paused": false, + "Restarting": false, + "OOMKilled": false, + ... + +Container names must be unique. That means you can only call one container +`web`. If you want to re-use a container name you must delete the old container +(with `docker rm`) before you can reuse the name with a new container. Go ahead and stop and them remove your `web` container. + + $ docker stop web + web + $ docker rm web + web + + +## Launch a container on the default network + +Docker includes support for networking containers through the use of **network +drivers**. By default, Docker provides two network drivers for you, the +`bridge` and the `overlay` driver. You can also write a network driver plugin so +that you can create your own drivers but that is an advanced task. + +Every installation of the Docker Engine automatically includes three default networks. You can list them: + + $ docker network ls + NETWORK ID NAME DRIVER + 18a2866682b8 none null + c288470c46f6 host host + 7b369448dccb bridge bridge + +The network named `bridge` is a special network. Unless you tell it otherwise, Docker always launches your containers in this network. Try this now: + + $ docker run -itd --name=networktest ubuntu + 74695c9cea6d9810718fddadc01a727a5dd3ce6a69d09752239736c030599741 + +Inspecting the network is an easy way to find out the container's IP address. + +```bash +[ + { + "Name": "bridge", + "Id": "f7ab26d71dbd6f557852c7156ae0574bbf62c42f539b50c8ebde0f728a253b6f", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + { + "Subnet": "172.17.0.1/16", + "Gateway": "172.17.0.1" + } + ] + }, + "Containers": { + "3386a527aa08b37ea9232cbcace2d2458d49f44bb05a6b775fba7ddd40d8f92c": { + "EndpointID": "647c12443e91faf0fd508b6edfe59c30b642abb60dfab890b4bdccee38750bc1", + "MacAddress": "02:42:ac:11:00:02", + "IPv4Address": "172.17.0.2/16", + "IPv6Address": "" + }, + "94447ca479852d29aeddca75c28f7104df3c3196d7b6d83061879e339946805c": { + "EndpointID": "b047d090f446ac49747d3c37d63e4307be745876db7f0ceef7b311cbba615f48", + "MacAddress": "02:42:ac:11:00:03", + "IPv4Address": "172.17.0.3/16", + "IPv6Address": "" + } + }, + "Options": { + "com.docker.network.bridge.default_bridge": "true", + "com.docker.network.bridge.enable_icc": "true", + "com.docker.network.bridge.enable_ip_masquerade": "true", + "com.docker.network.bridge.host_binding_ipv4": "0.0.0.0", + "com.docker.network.bridge.name": "docker0", + "com.docker.network.driver.mtu": "9001" + } + } +] +``` + +You can remove a container from a network by disconnecting the container. To do this, you supply both the network name and the container name. You can also use the container id. In this example, though, the name is faster. + + $ docker network disconnect bridge networktest + +While you can disconnect a container from a network, you cannot remove the builtin `bridge` network named `bridge`. Networks are natural ways to isolate containers from other containers or other networks. So, as you get more experienced with Docker, you'll want to create your own networks. + +## Create your own bridge network + +Docker Engine natively supports both bridge networks and overlay networks. A bridge network is limited to a single host running Docker Engine. An overlay network can include multiple hosts and is a more advanced topic. For this example, you'll create a bridge network: + + $ docker network create -d bridge my-bridge-network + +The `-d` flag tells Docker to use the `bridge` driver for the new network. You could have left this flag off as `bridge` is the default value for this flag. Go ahead and list the networks on your machine: + + $ docker network ls + NETWORK ID NAME DRIVER + 7b369448dccb bridge bridge + 615d565d498c my-bridge-network bridge + 18a2866682b8 none null + c288470c46f6 host host + +If you inspect the network, you'll find that it has nothing in it. + + $ docker network inspect my-bridge-network + [ + { + "Name": "my-bridge-network", + "Id": "5a8afc6364bccb199540e133e63adb76a557906dd9ff82b94183fc48c40857ac", + "Scope": "local", + "Driver": "bridge", + "IPAM": { + "Driver": "default", + "Config": [ + {} + ] + }, + "Containers": {}, + "Options": {} + } + ] + +## Add containers to a network + +To build web applications that act in concert but do so securely, create a +network. Networks, by definition, provide complete isolation for containers. You +can add containers to a network when you first run a container. + +Launch a container running a PostgreSQL database and pass it the `--net=my-bridge-network` flag to connect it to your new network: + + $ docker run -d --net=my-bridge-network --name db training/postgres + +If you inspect your `my-bridge-network` you'll see it has a container attached. +You can also inspect your container to see where it is connected: + + $ docker inspect --format='{{json .NetworkSettings.Networks}}' db + {"bridge":{"EndpointID":"508b170d56b2ac9e4ef86694b0a76a22dd3df1983404f7321da5649645bf7043","Gateway":"172.17.0.1","IPAddress":"172.17.0.3","IPPrefixLen":16,"IPv6Gateway":"","GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"MacAddress":"02:42:ac:11:00:02"}} + +Now, go ahead and start your by now familiar web application. This time leave off the `-P` flag and also don't specify a network. + + $ docker run -d --name web training/webapp python app.py + +Which network is your `web` application running under? Inspect the application and you'll find it is running in the default `bridge` network. + + $ docker inspect --format='{{json .NetworkSettings.Networks}}' web + {"bridge":{"EndpointID":"508b170d56b2ac9e4ef86694b0a76a22dd3df1983404f7321da5649645bf7043","Gateway":"172.17.0.1","IPAddress":"172.17.0.3","IPPrefixLen":16,"IPv6Gateway":"","GlobalIPv6Address":"","GlobalIPv6PrefixLen":0,"MacAddress":"02:42:ac:11:00:02"}} + +Then, get the IP address of your `web` + + $ docker inspect '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' web + 172.17.0.2 + +Now, open a shell to your running `db` container: + + $ docker exec -it db bash + root@a205f0dd33b2:/# ping 172.17.0.2 + ping 172.17.0.2 + PING 172.17.0.2 (172.17.0.2) 56(84) bytes of data. + ^C + --- 172.17.0.2 ping statistics --- + 44 packets transmitted, 0 received, 100% packet loss, time 43185ms + +After a bit, use CTRL-C to end the `ping` and you'll find the ping failed. That is because the two container are running on different networks. You can fix that. Then, use CTRL-C to exit the container. + +Docker networking allows you to attach a container to as many networks as you like. You can also attach an already running container. Go ahead and attach your running `web` app to the `my-bridge-network`. + + $ docker network connect my-bridge-network Web + +Open a shell into the `db` application again and try the ping command. This time just use the container name `web` rather than the IP Address. + + $ docker exec -it db bash + root@a205f0dd33b2:/# ping web + PING web (172.19.0.3) 56(84) bytes of data. + 64 bytes from web (172.19.0.3): icmp_seq=1 ttl=64 time=0.095 ms + 64 bytes from web (172.19.0.3): icmp_seq=2 ttl=64 time=0.060 ms + 64 bytes from web (172.19.0.3): icmp_seq=3 ttl=64 time=0.066 ms + ^C + --- web ping statistics --- + 3 packets transmitted, 3 received, 0% packet loss, time 2000ms + rtt min/avg/max/mdev = 0.060/0.073/0.095/0.018 ms + +The `ping` shows it is contacting a different IP address, the address on the `my-bridge-network` which is different from its address on the `bridge` network. + +## Next steps + +Now that you know how to network containers, see [how to manage data in containers](dockervolumes.md). diff --git a/docs/userguide/search.png b/docs/userguide/search.png new file mode 100644 index 0000000000000000000000000000000000000000..187b8d9ed89e453f34eb40d46d6939e1a45774e2 GIT binary patch literal 17923 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 z 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 qrLZ45jvh5|4t}awselwA1>^~#v ++++ +title = "AUFS storage driver in practice" +description = "Learn how to optimize your use of AUFS driver." +keywords = ["container, storage, driver, AUFS "] +[menu.main] +parent = "mn_storage_docker" ++++ + + +# Docker and AUFS in practice + +AUFS was the first storage driver in use with Docker. As a result, it has a long and close history with Docker, is very stable, has a lot of real-world deployments, and has strong community support. AUFS has several features that make it a good choice for Docker. These features enable: + +- Fast container startup times. +- Efficient use of storage. +- Efficient use of memory. + +Despite its capabilities and long history with Docker, some Linux distributions do not support AUFS. This is usually because AUFS is not included in the mainline (upstream) Linux kernel. + +The following sections examine some AUFS features and how they relate to Docker. + +## Image layering and sharing with AUFS + +AUFS is a *unification filesystem*. This means that it takes multiple directories on a single Linux host, stacks them on top of each other, and provides a single unified view. To achieve this, AUFS uses *union mount*. + +AUFS stacks multiple directories and exposes them as a unified view through a single mount point. All of the directories in the stack, as well as the union mount point, must all exist on the same Linux host. AUFS refers to each directory that it stacks as a *branch*. + +Within Docker, AUFS union mounts enable image layering. The AUFS storage driver implements Docker image layers using this union mount system. AUFS branches correspond to Docker image layers. The diagram below shows a Docker container based on the `ubuntu:latest` image. + +![](images/aufs_layers.jpg) + +This diagram shows the relationship between the Docker image layers and the AUFS branches (directories) in `/var/lib/docker/aufs`. Each image layer and the container layer correspond to an AUFS branch (directory) in the Docker host's local storage area. The union mount point gives the unified view of all layers. + +AUFS also supports the copy-on-write technology (CoW). Not all storage drivers do. + +## Container reads and writes with AUFS + +Docker leverages AUFS CoW technology to enable image sharing and minimize the use of disk space. AUFS works at the file level. This means that all AUFS CoW operations copy entire files - even if only a small part of the file is being modified. This behavior can have a noticeable impact on container performance, especially if the files being copied are large, below a lot of image layers, or the CoW operation must search a deep directory tree. + +Consider, for example, an application running in a container needs to add a single new value to a large key-value store (file). If this is the first time the file is modified it does not yet exist in the container's top writable layer. So, the CoW must *copy up* the file from the underlying image. The AUFS storage driver searches each image layer for the file. The search order is from top to bottom. When it is found, the entire file is *copied up* to the container's top writable layer. From there, it can be opened and modified. + +Larger files obviously take longer to *copy up* than smaller files, and files that exist in lower image layers take longer to locate than those in higher layers. However, a *copy up* operation only occurs once per file on any given container. Subsequent reads and writes happen against the file's copy already *copied-up* to the container's top layer. + + +## Deleting files with the AUFS storage driver + +The AUFS storage driver deletes a file from a container by placing a *whiteout +file* in the container's top layer. The whiteout file effectively obscures the +existence of the file in image's lower, read-only layers. The simplified +diagram below shows a container based on an image with three image layers. + +![](images/aufs_delete.jpg) + +The `file3` was deleted from the container. So, the AUFS storage driver placed +a whiteout file in the container's top layer. This whiteout file effectively +"deletes" `file3` from the container by obscuring any of the original file's +existence in the image's read-only base layer. Of course, the image could have +been in any of the other layers instead or in addition depending on how the +layers are built. + +## Configure Docker with AUFS + +You can only use the AUFS storage driver on Linux systems with AUFS installed. Use the following command to determine if your system supports AUFS. + +```bash +$ grep aufs /proc/filesystems +nodev aufs +``` + +This output indicates the system supports AUFS. Once you've verified your +system supports AUFS, you can must instruct the Docker daemon to use it. You do +this from the command line with the `docker daemon` command: + +```bash +$ sudo docker daemon --storage-driver=aufs & +``` + +Alternatively, you can edit the Docker config file and add the +`--storage-driver=aufs` option to the `DOCKER_OPTS` line. + +```bash +# Use DOCKER_OPTS to modify the daemon startup options. +DOCKER_OPTS="--storage-driver=aufs" +``` + +Once your daemon is running, verify the storage driver with the `docker info` command. + +```bash +$ sudo docker info +Containers: 1 +Images: 4 +Storage Driver: aufs + Root Dir: /var/lib/docker/aufs + Backing Filesystem: extfs + Dirs: 6 + Dirperm1 Supported: false +Execution Driver: native-0.2 +...output truncated... +```` + +The output above shows that the Docker daemon is running the AUFS storage driver on top of an existing ext4 backing filesystem. + +## Local storage and AUFS + +As the `docker daemon` runs with the AUFS driver, the driver stores images and containers on within the Docker host's local storage area in the `/var/lib/docker/aufs` directory. + +### Images + +Image layers and their contents are stored under +`/var/lib/docker/aufs/mnt/diff/` directory. The contents of an image +layer in this location includes all the files and directories belonging in that +image layer. + +The `/var/lib/docker/aufs/layers/` directory contains metadata about how image +layers are stacked. This directory contains one file for every image or +container layer on the Docker host. Inside each file are the image layers names +that exist below it. The diagram below shows an image with 4 layers. + +![](images/aufs_metadata.jpg) + +Inspecting the contents of the file relating to the top layer of the image +shows the three image layers below it. They are listed in the order they are +stacked. + +```bash +$ cat /var/lib/docker/aufs/layers/91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c + +d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82 + +c22013c8472965aa5b62559f2b540cd440716ef149756e7b958a1b2aba421e87 + +d3a1f33e8a5a513092f01bb7eb1c2abf4d711e5105390a3fe1ae2248cfde1391 +``` + +The base layer in an image has no image layers below it, so its file is empty. + +### Containers + +Running containers are mounted at locations in the +`/var/lib/docker/aufs/mnt/` directory. This is the AUFS union +mount point that exposes the container and all underlying image layers as a +single unified view. If a container is not running, its directory still exists +but is empty. This is because containers are only mounted when they are running. + +Container metadata and various config files that are placed into the running +container are stored in `/var/lib/containers/`. Files in this +directory exist for all containers on the system, including ones that are +stopped. However, when a container is running the container's log files are also +in this directory. + +A container's thin writable layer is stored under +`/var/lib/docker/aufs/diff/`. This directory is stacked by AUFS as +the containers top writable layer and is where all changes to the container are +stored. The directory exists even if the container is stopped. This means that +restarting a container will not lose changes made to it. Once a container is +deleted this directory is deleted. + +Information about which image layers are stacked below a container's top +writable layer is stored in the following file +`/var/lib/docker/aufs/layers/`. The command below shows that the +container with ID `b41a6e5a508d` has 4 image layers below it: + +```bash +$ cat /var/lib/docker/aufs/layers/b41a6e5a508dfa02607199dfe51ed9345a675c977f2cafe8ef3e4b0b5773404e-init +91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c +d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82 +c22013c8472965aa5b62559f2b540cd440716ef149756e7b958a1b2aba421e87 +d3a1f33e8a5a513092f01bb7eb1c2abf4d711e5105390a3fe1ae2248cfde1391 +``` + +The image layers are shown in order. In the output above, the layer starting +with image ID "d3a1..." is the image's base layer. The image layer starting +with "91e5..." is the image's topmost layer. + + +## AUFS and Docker performance + +To summarize some of the performance related aspects already mentioned: + +- The AUFS storage driver is a good choice for PaaS and other similar use-cases where container density is important. This is because AUFS efficiently shares images between multiple running containers, enabling fast container start times and minimal use of disk space. + +- The underlying mechanics of how AUFS shares files between image layers and containers uses the systems page cache very efficiently. + +- The AUFS storage driver can introduce significant latencies into container write performance. This is because the first time a container writes to any file, the file has be located and copied into the containers top writable layer. These latencies increase and are compounded when these files exist below many image layers and the files themselves are large. + +One final point. Data volumes provide the best and most predictable performance. +This is because they bypass the storage driver and do not incur any of the +potential overheads introduced by thin provisioning and copy-on-write. For this +reason, you may want to place heavy write workloads on data volumes. + +## Related information + +* [Understand images, containers, and storage drivers](imagesandcontainers.md) +* [Select a storage driver](selectadriver.md) +* [Btrfs storage driver in practice](btrfs-driver.md) +* [Device Mapper storage driver in practice](device-mapper-driver.md) diff --git a/docs/userguide/storagedriver/btrfs-driver.md b/docs/userguide/storagedriver/btrfs-driver.md new file mode 100644 index 0000000000..932431dbf2 --- /dev/null +++ b/docs/userguide/storagedriver/btrfs-driver.md @@ -0,0 +1,280 @@ + + +# Docker and Btrfs in practice + +Btrfs is a next generation copy-on-write filesystem that supports many advanced +storage technologies that make it a good fit for Docker. Btrfs is included in +the mainline Linux kernel and it's on-disk-format is now considered stable. +However, many of its features are still under heavy development and users should +consider it a fast-moving target. + +Docker's `btrfs` storage driver leverages many Btrfs features for image and +container management. Among these features are thin provisioning, copy-on-write, +and snapshotting. + +This article refers to Docker's Btrfs storage driver as `btrfs` and the overall Btrfs Filesystem as Btrfs. + +>**Note**: The [Commercially Supported Docker Engine (CS-Engine)](https://www.docker.com/compatibility-maintenance) does not currently support the `btrfs` storage driver. + +## The future of Btrfs + +Btrfs has been long hailed as the future of Linux filesystems. With full support in the mainline Linux kernel, a stable on-disk-format, and active development with a focus on stability, this is now becoming more of a reality. + +As far as Docker on the Linux platform goes, many people see the `btrfs` storage driver as a potential long-term replacement for the `devicemapper` storage driver. However, at the time of writing, the `devicemapper` storage driver should be considered safer, more stable, and more *production ready*. You should only consider the `btrfs` driver for production deployments if you understand it well and have existing experience with Btrfs. + +## Image layering and sharing with Btrfs + +Docker leverages Btrfs *subvolumes* and *snapshots* for managing the on-disk components of image and container layers. Btrfs subvolumes look and feel like a normal Unix filesystem. As such, they can have their own internal directory structure that hooks into the wider Unix filesystem. + +Subvolumes are natively copy-on-write and have space allocated to them on-demand +from an underlying storage pool. They can also be nested and snapped. The +diagram blow shows 4 subvolumes. 'Subvolume 2' and 'Subvolume 3' are nested, +whereas 'Subvolume 4' shows its own internal directory tree. + +![](images/btfs_subvolume.jpg) + +Snapshots are a point-in-time read-write copy of an entire subvolume. They exist directly below the subvolume they were created from. You can create snapshots of snapshots as shown in the diagram below. + +![](images/btfs_snapshots.jpg) + +Btfs allocates space to subvolumes and snapshots on demand from an underlying pool of storage. The unit of allocation is referred to as a *chunk* and *chunks* are normally ~1GB in size. + +Snapshots are first-class citizens in a Btrfs filesystem. This means that they look, feel, and operate just like regular subvolumes. The technology required to create them is built directly into the Btrfs filesystem thanks to its native copy-on-write design. This means that Btrfs snapshots are space efficient with little or no performance overhead. The diagram below shows a subvolume and it's snapshot sharing the same data. + +![](images/btfs_pool.jpg) + +Docker's `btrfs` storage driver stores every image layer and container in its own Btrfs subvolume or snapshot. The base layer of an image is stored as a subvolume whereas child image layers and containers are stored as snapshots. This is shown in the diagram below. + +![](images/btfs_container_layer.jpg) + +The high level process for creating images and containers on Docker hosts running the `btrfs` driver is as follows: + +1. The image's base layer is stored in a Btrfs subvolume under +`/var/lib/docker/btrfs/subvolumes`. + + The image ID is used as the subvolume name. E.g., a base layer with image ID + "f9a9f253f6105141e0f8e091a6bcdb19e3f27af949842db93acba9048ed2410b" will be + stored in + `/var/lib/docker/btrfs/subvolumes/f9a9f253f6105141e0f8e091a6bcdb19e3f27af949842db93acba9048ed2410b` + +2. Subsequent image layers are stored as a Btrfs snapshot of the parent layer's subvolume or snapshot. + + The diagram below shows a three-layer image. The base layer is a subvolume. Layer 1 is a snapshot of the base layer's subvolume. Layer 2 is a snapshot of Layer 1's snapshot. + + ![](images/btfs_constructs.jpg) + +## Image and container on-disk constructs + +Image layers and containers are visible in the Docker host's filesystem at +`/var/lib/docker/btrfs/subvolumes/ OR `. Directories for +containers are present even for containers with a stopped status. This is +because the `btrfs` storage driver mounts a default, top-level subvolume at +`/var/lib/docker/subvolumes`. All other subvolumes and snapshots exist below +that as Btrfs filesystem objects and not as individual mounts. + +The following example shows a single Docker image with four image layers. + +```bash +$ sudo docker images -a +REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE +ubuntu latest 0a17decee413 2 weeks ago 188.3 MB + 3c9a9d7cc6a2 2 weeks ago 188.3 MB + eeb7cb91b09d 2 weeks ago 188.3 MB + f9a9f253f610 2 weeks ago 188.1 MB +``` + +Each image layer exists as a Btrfs subvolume or snapshot with the same name as it's image ID as illustrated by the `btrfs subvolume list` command shown below: + +```bash +$ sudo btrfs subvolume list /var/lib/docker +ID 257 gen 9 top level 5 path btrfs/subvolumes/f9a9f253f6105141e0f8e091a6bcdb19e3f27af949842db93acba9048ed2410b +ID 258 gen 10 top level 5 path btrfs/subvolumes/eeb7cb91b09d5de9edb2798301aeedf50848eacc2123e98538f9d014f80f243c +ID 260 gen 11 top level 5 path btrfs/subvolumes/3c9a9d7cc6a235eb2de58ca9ef3551c67ae42a991933ba4958d207b29142902b +ID 261 gen 12 top level 5 path btrfs/subvolumes/0a17decee4139b0de68478f149cc16346f5e711c5ae3bb969895f22dd6723751 +``` + +Under the `/var/lib/docker/btrfs/subvolumes` directoy, each of these subvolumes and snapshots are visible as a normal Unix directory: + +```bash +$ ls -l /var/lib/docker/btrfs/subvolumes/ +total 0 +drwxr-xr-x 1 root root 132 Oct 16 14:44 0a17decee4139b0de68478f149cc16346f5e711c5ae3bb969895f22dd6723751 +drwxr-xr-x 1 root root 132 Oct 16 14:44 3c9a9d7cc6a235eb2de58ca9ef3551c67ae42a991933ba4958d207b29142902b +drwxr-xr-x 1 root root 132 Oct 16 14:44 eeb7cb91b09d5de9edb2798301aeedf50848eacc2123e98538f9d014f80f243c +drwxr-xr-x 1 root root 132 Oct 16 14:44 f9a9f253f6105141e0f8e091a6bcdb19e3f27af949842db93acba9048ed2410b +``` + +Because Btrfs works at the filesystem level and not the block level, each image +and container layer can be browsed in the filesystem using normal Unix commands. +The example below shows a truncated output of an `ls -l` command against the +image's top layer: + +```bash +$ ls -l /var/lib/docker/btrfs/subvolumes/0a17decee4139b0de68478f149cc16346f5e711c5ae3bb969895f22dd6723751/ +total 0 +drwxr-xr-x 1 root root 1372 Oct 9 08:39 bin +drwxr-xr-x 1 root root 0 Apr 10 2014 boot +drwxr-xr-x 1 root root 882 Oct 9 08:38 dev +drwxr-xr-x 1 root root 2040 Oct 12 17:27 etc +drwxr-xr-x 1 root root 0 Apr 10 2014 home +...output truncated... +``` + +## Container reads and writes with Btrfs + +A container is a space-efficient snapshot of an image. Metadata in the snapshot +points to the actual data blocks in the storage pool. This is the same as with a +subvolume. Therefore, reads performed against a snapshot are essentially the +same as reads performed against a subvolume. As a result, no performance +overhead is incurred from the Btrfs driver. + +Writing a new file to a container invokes an allocate-on-demand operation to +allocate new data block to the container's snapshot. The file is then written to +this new space. The allocate-on-demand operation is native to all writes with +Btrfs and is the same as writing new data to a subvolume. As a result, writing +new files to a container's snapshot operate at native Btrfs speeds. + +Updating an existing file in a container causes a copy-on-write operation +(technically *redirect-on-write*). The driver leaves the original data and +allocates new space to the snapshot. The updated data is written to this new +space. Then, the driver updates the filesystem metadata in the snapshot to point +to this new data. The original data is preserved in-place for subvolumes and +snapshots further up the tree. This behavior is native to copy-on-write +filesystems like Btrfs and incurs very little overhead. + +With Btfs, writing and updating lots of small files can result in slow performance. More on this later. + +## Configuring Docker with Btrfs + +The `btrfs` storage driver only operates on a Docker host where `/var/lib/docker` is mounted as a Btrfs filesystem. The following procedure shows how to configure Btrfs on Ubuntu 14.04 LTS. + +### Prerequisites + +If you have already used the Docker daemon on your Docker host and have images you want to keep, `push` them to Docker Hub or your private Docker Trusted Registry before attempting this procedure. + +Stop the Docker daemon. Then, ensure that you have a spare block device at `/dev/xvdb`. The device identifier may be different in your environment and you should substitute your own values throughout the procedure. + +The procedure also assumes your kernel has the appropriate Btrfs modules loaded. To verify this, use the following command: + +```bash +$ cat /proc/filesystems | grep btrfs` +``` + +### Configure Btrfs on Ubuntu 14.04 LTS + +Assuming your system meets the prerequisites, do the following: + +1. Install the "btrfs-tools" package. + + $ sudo apt-get install btrfs-tools + Reading package lists... Done + Building dependency tree + + +2. Create the Btrfs storage pool. + + Btrfs storage pools are created with the `mkfs.btrfs` command. Passing multiple devices to the `mkfs.btrfs` command creates a pool across all of those devices. Here you create a pool with a single device at `/dev/xvdb`. + + $ sudo mkfs.btrfs -f /dev/xvdb + WARNING! - Btrfs v3.12 IS EXPERIMENTAL + WARNING! - see http://btrfs.wiki.kernel.org before using + + Turning ON incompat feature 'extref': increased hardlink limit per file to 65536 + fs created label (null) on /dev/xvdb + nodesize 16384 leafsize 16384 sectorsize 4096 size 4.00GiB + Btrfs v3.12 + + Be sure to substitute `/dev/xvdb` with the appropriate device(s) on your + system. + + > **Warning**: Take note of the warning about Btrfs being experimental. As + noted earlier, Btrfs is not currently recommended for production deployments + unless you already have extensive experience. + +3. If it does not already exist, create a directory for the Docker host's local storage area at `/var/lib/docker`. + + $ sudo mkdir /var/lib/docker + +4. Configure the system to automatically mount the Btrfs filesystem each time the system boots. + + a. Obtain the Btrfs filesystem's UUID. + + $ sudo blkid /dev/xvdb + /dev/xvdb: UUID="a0ed851e-158b-4120-8416-c9b072c8cf47" UUID_SUB="c3927a64-4454-4eef-95c2-a7d44ac0cf27" TYPE="btrfs" + + b. Create a `/etc/fstab` entry to automatically mount `/var/lib/docker` each time the system boots. + + /dev/xvdb /var/lib/docker btrfs defaults 0 0 + UUID="a0ed851e-158b-4120-8416-c9b072c8cf47" /var/lib/docker btrfs defaults 0 0 + +5. Mount the new filesystem and verify the operation. + + $ sudo mount -a + $ mount + /dev/xvda1 on / type ext4 (rw,discard) + + /dev/xvdb on /var/lib/docker type btrfs (rw) + + The last line in the output above shows the `/dev/xvdb` mounted at `/var/lib/docker` as Btrfs. + + +Now that you have a Btrfs filesystem mounted at `/var/lib/docker`, the daemon should automatically load with the `btrfs` storage driver. + +1. Start the Docker daemon. + + $ sudo service docker start + docker start/running, process 2315 + + The procedure for starting the Docker daemon may differ depending on the + Linux distribution you are using. + + You can start the Docker daemon with the `btrfs` storage driver by passing + the `--storage-driver=btrfs` flag to the `docker daemon` command or you can + add the `DOCKER_OPTS` line to the Docker config file. + +2. Verify the storage driver with the `docker info` command. + + $ sudo docker info + Containers: 0 + Images: 0 + Storage Driver: btrfs + [...] + +Your Docker host is now configured to use the `btrfs` storage driver. + +## Btrfs and Docker performance + +There are several factors that influence Docker's performance under the `btrfs` storage driver. + +- **Page caching**. Btrfs does not support page cache sharing. This means that *n* containers accessing the same file require *n* copies to be cached. As a result, the `btrfs` driver may not be the best choice for PaaS and other high density container use cases. + +- **Small writes**. Containers performing lots of small writes (including Docker hosts that start and stop many containers) can lead to poor use of Btrfs chunks. This can ultimately lead to out-of-space conditions on your Docker host and stop it working. This is currently a major drawback to using current versions of Btrfs. + + If you use the `btrfs` storage driver, closely monitor the free space on your Btrfs filesystem using the `btrfs filesys show` command. Do not trust the output of normal Unix commands such as `df`; always use the Btrfs native commands. + +- **Sequential writes**. Btrfs writes data to disk via journaling technique. This can impact sequential writes, where performance can be up to half. + +- **Fragmentation**. Fragmentation is a natural byproduct of copy-on-write filesystems like Btrfs. Many small random writes can compound this issue. It can manifest as CPU spikes on Docker hosts using SSD media and head thrashing on Docker hosts using spinning media. Both of these result in poor performance. + + Recent versions of Btrfs allow you to specify `autodefrag` as a mount option. This mode attempts to detect random writes and defragment them. You should perform your own tests before enabling this option on your Docker hosts. Some tests have shown this option has a negative performance impact on Docker hosts performing lots of small writes (including systems that start and stop many containers). + +- **Solid State Devices (SSD)**. Btrfs has native optimizations for SSD media. To enable these, mount with the `-o ssd` mount option. These optimizations include enhanced SSD write performance by avoiding things like *seek optimizations* that have no use on SSD media. + + Btfs also supports the TRIM/Discard primitives. However, mounting with the `-o discard` mount option can cause performance issues. Therefore, it is recommended you perform your own tests before using this option. + +- **Use Data Volumes**. Data volumes provide the best and most predictable performance. This is because they bypass the storage driver and do not incur any of the potential overheads introduced by thin provisioning and copy-on-write. For this reason, you may want to place heavy write workloads on data volumes. + +## Related Information + +* [Understand images, containers, and storage drivers](imagesandcontainers.md) +* [Select a storage driver](selectadriver.md) +* [AUFS storage driver in practice](aufs-driver.md) +* [Device Mapper storage driver in practice](device-mapper-driver.md) diff --git a/docs/userguide/storagedriver/device-mapper-driver.md b/docs/userguide/storagedriver/device-mapper-driver.md new file mode 100644 index 0000000000..9344009929 --- /dev/null +++ b/docs/userguide/storagedriver/device-mapper-driver.md @@ -0,0 +1,310 @@ + + +# Docker and the Device Mapper storage driver + +Device Mapper is a kernel-based framework that underpins many advanced +volume management technologies on Linux. Docker's `devicemapper` storage driver +leverages the thin provisioning and snapshotting capabilities of this framework +for image and container management. This article refers to the Device Mapper +storage driver as `devicemapper`, and the kernel framework as `Device Mapper`. + + +>**Note**: The [Commercially Supported Docker Engine (CS-Engine) running on RHEL and CentOS Linux](https://www.docker.com/compatibility-maintenance) requires that you use the `devicemapper` storage driver. + + +## An alternative to AUFS + +Docker originally ran on Ubuntu and Debian Linux and used AUFS for its storage +backend. As Docker became popular, many of the companies that wanted to use it +were using Red Hat Enterprise Linux (RHEL). Unfortunately, because the upstream +mainline Linux kernel did not include AUFS, RHEL did not use AUFS either. + +To correct this Red Hat developers investigated getting AUFS into the mainline +kernel. Ultimately, though, they decided a better idea was to develop a new +storage backend. Moreover, they would base this new storage backend on existing +`Device Mapper` technology. + +Red Hat collaborated with Docker Inc. to contribute this new driver. As a result +of this collaboration, Docker's Engine was re-engineered to make the storage +backend pluggable. So it was that the `devicemapper` became the second storage +driver Docker supported. + +Device Mapper has been included in the mainline Linux kernel since version +2.6.9. It is a core part of RHEL family of Linux distributions. This means that +the `devicemapper` storage driver is based on stable code that has a lot of +real-world production deployments and strong community support. + + +## Image layering and sharing + +The `devicemapper` driver stores every image and container on its own virtual +device. These devices are thin-provisioned copy-on-write snapshot devices. +Device Mapper technology works at the block level rather than the file level. +This means that `devicemapper` storage driver's thin provisioning and +copy-on-write operations work with blocks rather than entire files. + +>**Note**: Snapshots are also referred to as *thin devices* or *virtual devices*. They all mean the same thing in the context of the `devicemapper` storage driver. + +With the `devicemapper` the high level process for creating images is as follows: + +1. The `devicemapper` storage driver creates a thin pool. + + The pool is created from block devices or loop mounted sparse files (more on this later). + +2. Next it creates a *base device*. + + A base device is a thin device with a filesystem. You can see which filesystem is in use by running the `docker info` command and checking the `Backing filesystem` value. + +3. Each new image (and image layer) is a snapshot of this base device. + + These are thin provisioned copy-on-write snapshots. This means that they are initially empty and only consume space from the pool when data is written to them. + +With `devicemapper`, container layers are snapshots of the image they are created from. Just as with images, container snapshots are thin provisioned copy-on-write snapshots. The container snapshot stores all updates to the container. The `devicemapper` allocates space to them on-demand from the pool as and when data is written to the container. + +The high level diagram below shows a thin pool with a base device and two images. + +![](images/base_device.jpg) + +If you look closely at the diagram you'll see that it's snapshots all the way down. Each image layer is a snapshot of the layer below it. The lowest layer of each image is a snapshot of the the base device that exists in the pool. This base device is a `Device Mapper` artifact and not a Docker image layer. + +A container is a snapshot of the image it is created from. The diagram below shows two containers - one based on the Ubuntu image and the other based on the Busybox image. + +![](images/two_dm_container.jpg) + + +## Reads with the devicemapper + +Let's look at how reads and writes occur using the `devicemapper` storage driver. The diagram below shows the high level process for reading a single block (`0x44f`) in an example container. + +![](images/dm_container.jpg) + +1. An application makes a read request for block 0x44f in the container. + + Because the container is a thin snapshot of an image it does not have the data. Instead, it has a pointer (PTR) to where the data is stored in the image snapshot lower down in the image stack. + +2. The storage driver follows the pointer to block `0xf33` in the snapshot relating to image layer `a005...`. + +3. The `devicemapper` copies the contents of block `0xf33` from the image snapshot to memory in the container. + +4. The storage driver returns the data to the requesting application. + +### Write examples + +With the `devicemapper` driver, writing new data to a container is accomplished by an *allocate-on-demand* operation. Updating existing data uses a copy-on-write operation. Because Device Mapper is a block-based technology these operations occur at the block level. + +For example, when making a small change to a large file in a container, the `devicemapper` storage driver does not copy the entire file. It only copies the blocks to be modified. Each block is 64KB. + +#### Writing new data + +To write 56KB of new data to a container: + +1. An application makes a request to write 56KB of new data to the container. + +2. The allocate-on-demand operation allocates a single new 64KB block to the containers snapshot. + + If the write operation is larger than 64KB, multiple new blocks are allocated to the container snapshot. + +3. The data is written to the newly allocated block. + +#### Overwriting existing data + +To modify existing data for the first time: + +1. An application makes a request to modify some data in the container. + +2. A copy-on-write operation locates the blocks that need updating. + +3. The operation allocates new blocks to the container snapshot and copies the data into those blocks. + +4. The modified data is written into the newly allocated blocks. + +The application in the container is unaware of any of these +allocate-on-demand and copy-on-write operations. However, they may add latency +to the application's read and write operations. + +## Configuring Docker with Device Mapper + +The `devicemapper` is the default Docker storage driver on some Linux +distributions. This includes RHEL and most of its forks. Currently, the following distributions support the driver: + +* RHEL/CentOS/Fedora +* Ubuntu 12.04 +* Ubuntu 14.04 +* Debian + +Docker hosts running the `devicemapper` storage driver default to a +configuration mode known as `loop-lvm`. This mode uses sparse files to build +the thin pool used by image and container snapshots. The mode is designed to work out-of-the-box +with no additional configuration. However, production deployments should not run +under `loop-lvm` mode. + +You can detect the mode by viewing the `docker info` command: + + $ sudo docker info + Containers: 0 + Images: 0 + Storage Driver: devicemapper + Pool Name: docker-202:2-25220302-pool + Pool Blocksize: 65.54 kB + Backing Filesystem: xfs + ... + Data loop file: /var/lib/docker/devicemapper/devicemapper/data + Metadata loop file: /var/lib/docker/devicemapper/devicemapper/metadata + Library Version: 1.02.93-RHEL7 (2015-01-28) + ... + +The output above shows a Docker host running with the `devicemapper` storage driver operating in `loop-lvm` mode. This is indicated by the fact that the `Data loop file` and a `Metadata loop file` are on files under `/var/lib/docker/devicemapper/devicemapper`. These are loopback mounted sparse files. + +### Configure direct-lvm mode for production + +The preferred configuration for production deployments is `direct lvm`. This +mode uses block devices to create the thin pool. The following procedure shows +you how to configure a Docker host to use the `devicemapper` storage driver in a +`direct-lvm` configuration. + +> **Caution:** If you have already run the Docker daemon on your Docker host and have images you want to keep, `push` them Docker Hub or your private Docker Trusted Registry before attempting this procedure. + +The procedure below will create a 90GB data volume and 4GB metadata volume to use as backing for the storage pool. It assumes that you have a spare block device at `/dev/xvdf` with enough free space to complete the task. The device identifier and volume sizes may be be different in your environment and you should substitute your own values throughout the procedure. The procedure also assumes that the Docker daemon is in the `stopped` state. + +1. Log in to the Docker host you want to configure and stop the Docker daemon. + +2. If it exists, delete your existing image store by removing the `/var/lib/docker` directory. + + $ sudo rm -rf /var/lib/docker + +3. Create an LVM physical volume (PV) on your spare block device using the `pvcreate` command. + + $ sudo pvcreate /dev/xvdf + Physical volume `/dev/xvdf` successfully created + + The device identifier may be different on your system. Remember to substitute your value in the command above. + +4. Create a new volume group (VG) called `vg-docker` using the PV created in the previous step. + + $ sudo vgcreate vg-docker /dev/xvdf + Volume group `vg-docker` successfully created + +5. Create a new 90GB logical volume (LV) called `data` from space in the `vg-docker` volume group. + + $ sudo lvcreate -L 90G -n data vg-docker + Logical volume `data` created. + + The command creates an LVM logical volume called `data` and an associated block device file at `/dev/vg-docker/data`. In a later step, you instruct the `devicemapper` storage driver to use this block device to store image and container data. + + If you receive a signature detection warning, make sure you are working on the correct devices before continuing. Signature warnings indicate that the device you're working on is currently in use by LVM or has been used by LVM in the past. + +6. Create a new logical volume (LV) called `metadata` from space in the `vg-docker` volume group. + + $ sudo lvcreate -L 4G -n metadata vg-docker + Logical volume `metadata` created. + + This creates an LVM logical volume called `metadata` and an associated block device file at `/dev/vg-docker/metadata`. In the next step you instruct the `devicemapper` storage driver to use this block device to store image and container metadata. + +5. Start the Docker daemon with the `devicemapper` storage driver and the `--storage-opt` flags. + + The `data` and `metadata` devices that you pass to the `--storage-opt` options were created in the previous steps. + + $ sudo docker daemon --storage-driver=devicemapper --storage-opt dm.datadev=/dev/vg-docker/data --storage-opt dm.metadatadev=/dev/vg-docker/metadata & + [1] 2163 + [root@ip-10-0-0-75 centos]# INFO[0000] Listening for HTTP on unix (/var/run/docker.sock) + INFO[0027] Option DefaultDriver: bridge + INFO[0027] Option DefaultNetwork: bridge + + INFO[0027] Daemon has completed initialization + INFO[0027] Docker daemon commit=0a8c2e3 execdriver=native-0.2 graphdriver=devicemapper version=1.8.2 + + It is also possible to set the `--storage-driver` and `--storage-opt` flags in the Docker config file and start the daemon normally using the `service` or `systemd` commands. + +6. Use the `docker info` command to verify that the daemon is using `data` and `metadata` devices you created. + + $ sudo docker info + INFO[0180] GET /v1.20/info + Containers: 0 + Images: 0 + Storage Driver: devicemapper + Pool Name: docker-202:1-1032-pool + Pool Blocksize: 65.54 kB + Backing Filesystem: xfs + Data file: /dev/vg-docker/data + Metadata file: /dev/vg-docker/metadata + [...] + + The output of the command above shows the storage driver as `devicemapper`. The last two lines also confirm that the correct devices are being used for the `Data file` and the `Metadata file`. + +### Examine devicemapper structures on the host + +You can use the `lsblk` command to see the device files created above and the `pool` that the `devicemapper` storage driver creates on top of them. + + $ sudo lsblk + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + xvda 202:0 0 8G 0 disk + └─xvda1 202:1 0 8G 0 part / + xvdf 202:80 0 100G 0 disk + ├─vg--docker-data 253:0 0 90G 0 lvm + │ └─docker-202:1-1032-pool 253:2 0 100G 0 dm + └─vg--docker-metadata 253:1 0 4G 0 lvm + └─docker-202:1-1032-pool 253:2 0 100G 0 dm + +The diagram below shows the image from prior examples updated with the detail from the `lsblk` command above. + +![](http://farm1.staticflickr.com/703/22116692899_0471e5e160_b.jpg) + +In the diagram, the pool is named `Docker-202:1-1032-pool` and spans the `data` and `metadata` devices created earlier. The `devicemapper` constructs the pool name as follows: + +``` +Docker-MAJ:MIN-INO-pool +``` + +`MAJ`, `MIN` and `INO` refer to the major and minor device numbers and inode. + +Because Device Mapper operates at the block level it is more difficult to see +diffs between image layers and containers. However, there are two key +directories. The `/var/lib/docker/devicemapper/mnt` directory contains the mount +points for images and containers. The `/var/lib/docker/devicemapper/metadata` +directory contains one file for every image and container snapshot. The files +contain metadata about each snapshot in JSON format. + +## Device Mapper and Docker performance + +It is important to understand the impact that allocate-on-demand and copy-on-write operations can have on overall container performance. + +### Allocate-on-demand performance impact + +The `devicemapper` storage driver allocates new blocks to a container via an allocate-on-demand operation. This means that each time an app writes to somewhere new inside a container, one or more empty blocks has to be located from the pool and mapped into the container. + +All blocks are 64KB. A write that uses less than 64KB still results in a single 64KB block being allocated. Writing more than 64KB of data uses multiple 64KB blocks. This can impact container performance, especially in containers that perform lots of small writes. However, once a block is allocated to a container subsequent reads and writes can operate directly on that block. + +### Copy-on-write performance impact + +Each time a container updates existing data for the first time, the `devicemapper` storage driver has to perform a copy-on-write operation. This copies the data from the image snapshot to the container's snapshot. This process can have a noticeable impact on container performance. + +All copy-on-write operations have a 64KB granularity. As a results, updating 32KB of a 1GB file causes the driver to copy a single 64KB block into the container's snapshot. This has obvious performance advantages over file-level copy-on-write operations which would require copying the entire 1GB file into the container layer. + +In practice, however, containers that perform lots of small block writes (<64KB) can perform worse with `devicemapper` than with AUFS. + +### Other device mapper performance considerations + +There are several other things that impact the performance of the `devicemapper` storage driver.. + +- **The mode.** The default mode for Docker running the `devicemapper` storage driver is `loop-lvm`. This mode uses sparse files and suffers from poor performance. It is **not recommended for production**. The recommended mode for production environments is `direct-lvm` where the storage driver writes directly to raw block devices. + +- **High speed storage.** For best performance you should place the `Data file` and `Metadata file` on high speed storage such as SSD. This can be direct attached storage or from a SAN or NAS array. + +- **Memory usage.** `devicemapper` is not the most memory efficient Docker storage driver. Launching *n* copies of the same container loads *n* copies of its files into memory. This can have a memory impact on your Docker host. As a result, the `devicemapper` storage driver may not be the best choice for PaaS and other high density use cases. + +One final point, data volumes provide the best and most predictable performance. This is because they bypass the storage driver and do not incur any of the potential overheads introduced by thin provisioning and copy-on-write. For this reason, you may want to place heavy write workloads on data volumes. + +## Related Information + +* [Understand images, containers, and storage drivers](imagesandcontainers.md) +* [Select a storage driver](selectadriver.md) +* [AUFS storage driver in practice](aufs-driver.md) +* [Btrfs storage driver in practice](btrfs-driver.md) diff --git a/docs/userguide/storagedriver/images/aufs_delete.jpg b/docs/userguide/storagedriver/images/aufs_delete.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fa0f0d2e9fbb1b9ff96b14a88e834ec4de133c78 GIT binary patch literal 39059 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

QbS}kN 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/aufs_metadata.jpg b/docs/userguide/storagedriver/images/aufs_metadata.jpg new file mode 100644 index 0000000000000000000000000000000000000000..378e36b84991376ffb23cec090b0a9944ac27d9f GIT binary patch literal 26599 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 YBP1+ruJf5~^G=~Ain#tyvi|=~0AAkRssI20 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/base_device.jpg b/docs/userguide/storagedriver/images/base_device.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3db490d83dfa72ae2b67a6c3310959527e6d9893 GIT binary patch literal 46684 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%0A(;!$!xI=}@q@tKVB2WJ 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/btfs_constructs.jpg b/docs/userguide/storagedriver/images/btfs_constructs.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4ceeb6ad125be2872669d3f01c8627ae529fe0e6 GIT binary patch literal 47668 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

#FY%5eozC|gS=2%=!@w$HtrUB#yN+hR&byj2 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 Z2pY&GSSqAByka(gy<6pfzVKuA{{Y_mc<%rJ literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/btfs_layers.png b/docs/userguide/storagedriver/images/btfs_layers.png new file mode 100644 index 0000000000000000000000000000000000000000..12b61e5b52db3d9f4f8a5734ac8ac5ed4b833652 GIT binary patch literal 69487 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/btfs_snapshots.jpg b/docs/userguide/storagedriver/images/btfs_snapshots.jpg new file mode 100644 index 0000000000000000000000000000000000000000..94c7797aca9747e785cb701daee1c052fbf7657c GIT binary patch literal 19902 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 E4+FB+ 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/dm_container.jpg b/docs/userguide/storagedriver/images/dm_container.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2a5cd58ccfe54fae696e723c35f337d46dbe5b37 GIT binary patch literal 51563 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/image-layers.jpg b/docs/userguide/storagedriver/images/image-layers.jpg new file mode 100644 index 0000000000000000000000000000000000000000..378e36b84991376ffb23cec090b0a9944ac27d9f GIT binary patch literal 26599 zcmeFZ1y~)+wk|p+?ydoXyHDH+E))0Q8r&U%y9IZ52?V#`?gV#t5=d}JAbBLLz1H4u z@AsW`?mc(kb>F$O>+Al9RMn{Js;*JhJ?qEfk4*rYjD)lV00@KtFh3rEA1eS+03;Cj zGeABDNJt21SZHVn2xxd%SZG*8ctk`*cmxC_6m%3MBs63M1XL_kGz<((OiUycY+P(i zTy#uKjGu}8j0^o33mO_80|@~M<3IiT(E~t-0|o-SAc5!r2y`GMI`BsyfCvBtKtMcN z2l)L54Fd%WgoJ~K_^}LtdlGytev(2e8$JP8xzjw$3cp_jVi1D>^T6gW3`;D%V|e7l z^@{*-e^nqrl|5@6M86$qUf^}IcJ@%0bZmYU;=Ekz$lf{Pw|SNw?_D+ zvHFzdZ)tA+qJCL(tS9s&B9Q5b8Dko~j+1d8P1Cc@Zt+ndLJT-AS7qdZUiu-QJ#Cmj<55 z`tA|g?t{&d0Yej+!!G~;Q@o?cYvT0!y%OcFCoSh+83A4+4u=MRIea3%;wGRXZhiPg z056%Tp6{qV32@v~J>D=rVN~$G=*1?a2q$Qo8Wlj93Yp%0m7gFxWtaptA_PT9=Y*iFBbq{_@=DrdLrzIR|V>RD+qGj6zZg(-!B1d8$;~lmSI_XHAhHAb<=PB0YBXeZ z!$}SX5&(d-vb$rP$Nz>AKvV>nmmxt2UjetY-iK%E_otg_Sl= z*%cLqL_>c2mPzPAm#n%vdn2Lh04zSp;r`O+s0#pyt=%^okWo2dRY&k4SjUm_@&3(9 zfnPC%e^~?hDDeJ_=l6?1H5l#P=mJ1qe1+vdn>@&Vw252F>lOf<%sJ9P4lTIgbd^Y- zSW4f<(4OrAzz|Xh+yejy{d~L)=6=npoZ^sXDjuP+mn;BaD7?z>uOtCT+CBsKPsu~x z3_bB4&nT5ZR_krl_f}6LXYZShRyJKb0h`Mw27q=hy83r*z+=yS_SiKa`|aO#TmTRP z5*iBTSGR@u?biGe1)#0?ivaqce0<`fW`#DreS(6n&)4htO6bQ_UglG6KK8BbG)wPK z0`0Hj*fdi|XCx~I1-l+K&uz93M-L27K7!K6o%7fmD&>S98wGOP_wb*}29Fw#Q7@{m zul#;N*ooeyxnBrCeUSUa15%gNKC!rY+I3@pL15ST@uw#-3XGkGX^e{I0?*)FNJ_yh z006@|kWw{werftssqNz{&*?Lc`m)C&K+?@q7CBz7{bOX4r^M~qJl~W2f{^~{%TGL{ zyb|yea$>Xl?Ri1SPjK_ZgGGgT=(iHLDSE}3HvXCf0C*+pE7&qHZ~w(^)k8(b>Rp1h zUfSeyKL7y#ZaaH}xB|hm;ipU(6Cecupuq=a{zFn-zfuMEcKf>jLVzzyc273|a6Z>* z|HS(l{|WuH1E~Z&SHD42m*EEhV!b`eZjp0Ic{FM;yGG9F`uyZz-AKRy0C>a6Yo{P7 zXxBLL9Qj++wiV~w{KjW~0EqhV29Al@d7Xc4MU&=JK8_Ag*Z|dfs>hZ__)l80<@Ckcdj-~7IKjGKpFD8biqmF zeyT;_hQ8va@Gmax>(`?G((E0h*cQf3Q8=tAkCh4?zGT&?`f2oC^iMr)U)CB9nT&L< zvw1_y1I|ZrbhgT&n`c(g*L2&jUqc~oHoWn^oeH)aJr=9u*6U4+f!o6Dzsw27@5vIo z1M!L{L?EsDFEvH|nG9bp#PYoMD8pXGd(ZQD{ZvLkD*u$1a@pjA1c#e&JMke`{Gh|0c zUYFl5i1PJo4&E;W;NyE@JyHMTXX3{O&HiXM)T56D0R;{H+hY|P1{MMm3JxC!4+xKi z%T3OMhAym#fr-t=MM6pj;xzcpMFPSBzV$D(%8bB1Fr*qeJGHX^g#!xa=@yTGxR|Ts z(SktoKsLXQ4s0`<4`GUGUbg&~cg|eL>&Rc50(~ksH!9r!vP8gr#!}puO&m;j1yPND z>g0pKaG?G3&GFj<*zE_@HEN$(;ojSH^SzeMZQ)<#&_jE z3p_>Ih_Ux!{&27T(O$K6myJF{^_a6=r#M+BS-H4;s{C05v}VY}0(!BKvOiiVi(_KE z?8?PCLSosTI7V!DHHhA(4E1Bh+e!m%H3hoPhtB2`tx3D)?7l$D7+w4Zv?fL`tUS-J zG1J_xyJZ%wdVAc-ho$DjlWEc8_^ zbW@BTyPi65sCXG;`pUWTnSWwQv%Cd$kfmgQhu9nl7F&9|CA{KTS23~Z(^)5*F-DNt zZiTwvdwcnw=#!TWLt{3KomF7f@<_Rsd|HbG+W0az*V&0gxqA7$x{6T?Ii9Y)^rH-U zeKj;FZ;rWv*~_p!$VJs2-D66@3h`X_j|d-qTCNg=?82J+)wF#*q!3go_Y;T6-g9^d zyj&{Vy?2Ih)gNwR=R2`R zR7uHJqUi&HwGFQw?^PN5reRh-s-z4nYe>lP$oqIHmI{=ySw(oex9YHzUb735x--DbSs9Hi6pzmAF;@ zq0~S0jD2d`x_+@RI<;YnD{lMFI&;EDAKADj(b83V77UFDHEq^>MEc9>*UQd%u-ui+6 z?iuov>np};ANk;05w+;BT)&DkFL#U+xP>(8?g~Jr#jGABCVaf1#V~y5}smxE64EiZ{!$vd~@`vv0Z@ih`z|FN;5f&%RweW?4htp2Z!@UmnSN^5Ui?GzFdUn z9-HTa$3D^`=T0jsEkK7V7KmZ#Zys9d3BXE`(>g(p2Ak0BG*pe9EauAUv(H#!`ql1jo_w3k3Lkv@#uas*R%``U=(S6rTq77Pjeq2n$^p!GB#PMvVm?8dL zBrTFkv-#0R@U(ehBMyqS@c2q@1%rq5%fAl;|o8=T8R}^ z<*BjeewyoNHm|bbw{3sfzWez-u8z*fG93z|{sk%89UmPYrj=QDXL&NDAAm5Z-aiJU z{iH32rnUb(J9PK&6454=%}kt~zWP3>eO5DnZ|%}aKx8-Ymn8`8di<)S3G6h$a(_Hl zbXGD{$EsmV!lOE>B=j}NnJeN_=7vU(cTKMxL0?<&U+esJ1ZITCCE3%5lUVn^4*>n& zZmlc7Rc5&ZB>w36kvCtKv~RR|zW|~fSHC!rFhQ>3cjA8Ds%_d1x1JzueH_g~8s5vP zDbJ5Jb4e^9ro*16X4xJr*ElEp)yUatQ;@&YS1(jap0iM8j`wNwj4J?B&$6g1crZz9 zlr5$A@Ej_Cb5@dQq+(DhXCxBh4A+)fSSm{U()ui-Y$RluE~<*Y?6Y>aRatW0G7ST# zlZ{}AilszuQ|mV-vPw0=;@AxZyRj?!k@}D%Rbz9N<9Ae*F!Aczwcck1JOWKtj&<^= zvht3e6>+^61)+YvCwEAF*=dRDtS75XANypawY0227*hSDqp8xCN4!R=){p&cUBQB| zPDFGg_+Qk-nVl4BG7h|?f($X`ORJ*li(#z<|M5Hy`YAyId8UNA6JAILpIxz~C^YLrM zL^R*NqX-d%O29E=0~?m6o7J-N7Tp(=l|O3@XtuCK#F2oi&q^)Bm~-(+0+)qIl(28~o!T?(?01-sj^hJplS29^KZJ z6{%O+h0(K2x-OOqK+ju9gleR}0ED@!2##$m6JuZfz4P{_Z%?tCBU~h9YkweTJVZ~v zgd6pQGHr(dt^4EK2}d>MO8jL6nB4X9JGkg0Z2zwY_GfO%_QO4=`n^$P5b-*>>>*u8`uLOX-^Y4q+Kz6GpPC^OQk<20sIrMItnIdJv1%1m%c z^*(y@HYFwTsHA%t9oL^Rnk>(6e@H|zl8G8>H;JjVOL8%dq*yC0n?t(tEPfM;+CRA0 z{k@?dxo#G>=Mz;8;+~491j9Zio-$Pi z=iyH@rTV^fBuTbXMCU;3rKe3(My{ct4Q~HC=u~3Wbgme1f~=xz1$v|2j!%-w=w-ap z8g=F&PcY?p)>N5!mEut)T{A(pO-X8-yfW*M`BEyL})s(p~Z0fukNjRFH^Un8o zJM}pH>1Pd1uHF+A#*CtUU!V2JwZ5=2dB4!77>(fm-)fD_+rs-EWPy z?%e1EyndEWf2TD_ALPK*yVZLk7;W_ffMfKBQ}RI3>`OR7 z2<+sb8EH{1%~rhN8F7{rFuz?X6XNupWgH-%N#a;IQ*eSIu?{fKvMjt_<>uiiM~rf% zxacaE<2s~22)7P&iwfj%K9*d{v6vkn1UZAkA$`Z<1L`vB)C9U)sg{eZMzJmZG*+1L zUG+>hR4$13J@<--d~)c;|XsnhWA`j&1|9FDXOK2;!rUW6}oAK7tKxN{oj5f z4GluO&;0=y!k<0MXUqVpWnQRL^Y2Y;G;3@zXVKI0z$@D@`uf^@H0euxJ9lF91JGp0 zhi6%1r-fq8XgbjDe1zjdKCV@)+kr7n%iNqTIslT1L1RUh6A4W2&s3yObsYfn-x3vg ze$#HDv`IaGV^Ktz66!MYQL*)cvb}`|lj+$J7B;h5a^p}#bPJbU*39eqkCmD+XUp*6 z3pP1>t9l!P&?7gpKLC`EtHH`YSA(H|P>9GdkTAa%gdbn8K>?s)&@nJc6Q{7qSYN2B z#U~_9Z^L4Plnfo>@@ngPXLiuYg+&zeag_Z@DAv2U5oC4q|*^Rqvep@Ss7XmyO znfEAKCRGd~jG0wB{s3$N#UQ5iX4(;#Bd)U!^=38dKZ{)Fx0iV0HejFdeP}OzXR#i9 zBJL%B$!tl#?3U-H^xs;!>SzX1Y@!%kYqLt~ONb!h%VU?Qc@i0vZ!JQQGtJ#-@hP4P zdGGC5E(IzvvY$Lxjgv>alKMzH^>M#8-DOS%wspm{&s(+HchX;L{@Uz~xrj!!Z$GW< z^i`)@()j$d1P>3I6{h-~KZ|j5WmK8u^ZjR8{wGywS3DHv{QFcIRE7J002*1l1xX7c z&9aBdqm^!CzE||`-~5NHhx+?@lW|Bxwj)n6BONZ$(Ff9m5+_*d;dsp{R!|66Bodce z!LUO=M`{ZqK3m8k>XNKHCybM-shs^M|`WkI`xVS#}H zQ2_F5+2=ut0gXjKD+v?XQpxu78_p7O?7$iQ%D3{VXa_=`n8P|J^hPT__ z9aQ%Pykh!Xo<{YJgW)6boeZ#5P%2iAGMX?IPBMW)tPs=vU7Ju$iP_{{+4c{>>S8Vx z)q?9f_ZX|pM7+rwe_6H(8&=NvLku%lOAP!OGNCs6wKSpSn^ujJN{Y+lOH3m!y%&7C zVu{kjYM2Pau|?m;ifty@1^8et?s~=6+&a2UnVh5YSZ#yHsM>@0tIMWL&dpE6=ft{H zOlD{k(SSswTTNGOz6jC>%1Ib(FznVR8UvnbZ-RCe%Wd)U8vC?uZN=tG<5jIj(ahG~ zSA)lN=mNdqT??X`t5F=njc+hxj#QwusqP}3GT)jOYPP6BbrC2jx^^A{@sfExC&E-G zluB?|Kfs1+brq*Y8LXK60L&akxZr#e3e$m@Ehv%6LRSF_+h=d)V%m2>aIH57Nq?|d zZ)78DO_x0u=eSlokx5z_PR;)$iZSpwx8S27zPxoahlF(yFAaMko>M;N6dS>d?KA zfvXInaM6`sUxf(LpEE?he4UsZHEq#AD&x)lN&jMlAFV7mYTTQavRSuYm3gWxyUu#8 zooO#GY}_FaV>cIZOT0F5LyHe2G@^23B2^EMG4mZGT~p+Z=rJSpbQJN>SR8J zil5N)@`efzh1Xz%qR%h^x15Ai6p7M%^#$GTbBT$l4b3pKJ%;F<_UL^)182-BQ9YjN zee5+|c!vozsZ>0nJ*({@6d0bCns-C|&g(fNc)AS0hCXVR#XRqRq;4#R*y-W)@Tx8H z4i6V~5>2cQKEFFiu6SAtogR}G9I=^}z!Yef{9;1|c!hxZjfVRgh0zSCw+>AuSZZqM z;$S@C+ZaRcFq9SU(_XWSz%(bO_wfCFF=Aq3U0!e~UZ2H6RKO!W#yDA0@!j&bZLj> zmf@O&nZj zw5N?H!-*Yf-z<92c6ZhLmpyG=tb2dC`z+}0eUrm4=rx&5EO0Q1ntgE)I_Yuo)9k-j z5Nv+b`tv8AStSb$3D8J%Uk_s-ca*(CnECcnNv+ft^6N8SwQVfl6{vsYRdan`46*q< z-5gAO-A#zO{p^=t#x1Jvt>2iRIAcSHJ+ZDQy@bV+m6{f1lZyfY*ze=Xmy{cu;ct&O z8t@s5BzrLwE4IsI03@*OXOovXw(J{7&A65GSLBuBhmzu)AS-tA6%Mze=1?PyY9IZY zBmzvd-RikpiCyUu!73uYz?+hG<1fu_NydM5I5{*YS*(dAw9DGHzwBox7O%ycB}Yw8 zYsFYbV2WlO%&Mek=i`!OHPv!qkR4qNUeXDSxqh~;irqj*>%OBTfhi8lNx4CkR(bmEi@jEsh9UIuV% zNjl7su1ncnQYwIqTa;a8dI_>I2?8`Ip2WU5p3^9Z8IUFf%Mqo7HvS&V1;SD-GLR}u zO+0@|gK=uGfi;*dJdE55E)3=q$BU2DRrclGXMkNr76R4?z8WU;^LKB3+vxU|4UD9h z!h=-gh`-Ok90hhGO$nyV52Zr4FsBBpE&I3v>ej6Rb&#rB!*#OD~K! zAyEilv~f1A^wB)}zHpm4XjA=l3MO$q&%SLx)D2=?oE}*6kQ8Td5JK)BmnD9yVKOR( zz**7cuVK-8rqzv4wQbT$Js>tCmFu_#XwI;t9DA-iWHL7bN}*tbXCEtwC!>YIil9Wa z1pwR5z|t?}ET^m;S;Qqv-~;@sQ}-3ObGI<`(OxkQ4z^%t`13~%^Q)&?&}$N=866B` zD||WeUaYaT6P+qf%$P(KNEwe<5}yVi07<76%TC$|Z2Y(kNB2yy*o#JCuBryV&8{c*i@0F=gn?>n(o%D1j0PAFFxj>?Bi7<;%tex{9!6Oe|0aa0tLv2<%t55)X}-w3>fUWfiDM_KjxpHp62-c*7h&$YY|OLyl7`L0L7;&K(Q9f| z-O|*s9bQvHF_LYLCP@~v@Qd(e8?y}7HFMW;v?wLc4=Q4zE2#h|IV+f54Vs!b71}iQ z`ZQDdnl`6U-U>QO04RiTfv_L=Msn-mWVdt%HG^;Q^x4~*OnV~W4_Zo(nM==~GLAP(U7?}^@!7L7rowW%R}^EN z&t8^M<($!cnuRvAl};U@QElAogS0vzD%GP)n|&yrSgMmh#B`Q7h7W2+P*vjI?h;vb zTHa<=Mpgj5H9bhqW3*saYn6)K##K^MUO+?cNxr+;GUiGd(J|JVk}}?6f`tB(2qo#} zNm!crHAYEv=-`f=*tC(gPdq<>AbE{6I+cq}+`h1SHmFuFVA{gEWvB%dhHEX71BYqN zr@j7R!-!PSwITqtK?>%1_qaat1K_hxD)~??`McMGwy=SFrT0I?3z6GL($yw_?e7!S zw8d{blal7iTfhoRNGEdmKLAFENRNw?Qtao)#ycrJ+FM%q_&K~XhP)*$JT=G9QvAJw zXw@T^op<|D_s_yDGP1P{4otaPpi!(}sviJ04C41m06I3&Fu|U(^d?-aTo|M^@E~ON zG@@ke|DOM|H4s3S(X!fNiY=WAhlXq%G7Ia){<~MP>5JA`ex|&E!A?cpQTE5=69Fz-4| za355`PDI|!@<5Vp`G_pGv424@2IHJKC94r8%w z7TK0@*_2h8rmbI<;i478aMS?o`i9LgmI(Uy&a3H!>E$wubCdgNVvJx2Qdd^ulqT`P z?~6If4k6(^Et`Y~6jdNH7rVaWh84idX<)#@+PbXVQei|_5!+!io{5h$qg&m}Rwj-~9vhs1+##DL9(!Ss1}CNAPO#Uqf(>)8Pj#zlqHz|pY>PY z85F@L@gCTl5~561*l!S%KK^lxpd~*$d*mn`dI~)6%Wp}WZg4-)F~o5J-N&H(8On`^ zk>*rqZX~9BxFR@A14TYI7H$o5G2aErdK)ib;a;razR&bCL3xvBEN=^jsca)B8X@I* zlvH+$3&^vy&g`n?+zIQP1OY98a{y0F)Cx;VF=Bxv5@*beNlj_=UHgCoou#H!yeW`q zdwSy*2U`bKh~Q6!Go)6pPOq{RYXnQ*6@(p!cB2 zvC3G0Y!EWz2Y`OnPz^^7yl=nRV~m<9LB!(}H>R6j_9k@PVH{PDDZ*o9ZF+!5b{|L} zQchOJg==d_8~8Pdq1@CFPnAp(4H~k~4o~D`qw@SHo1&DJM-LThW{KCX9+Ok@cSAh) zlVS8PD(*Eg&=)#RKBP0r#fl8ZHHv+hu*n}Djz>5MitBJ{xqlk zQzH#wTHdRnT~|kw0ons#2jRkMMArksl~J{j#DnHr)TvH&ddN$=x&O}0P%2j~q;}Ot z$Dl4c8!%UI_Dap~<1|v9=CI00x!GQyHCLm-2H_XBHPi-3fe+sl|9=lmQ3jm*)s)!+ zwm1o4kha=*LjEI%=J=mFzi%}|R!dn?*|=1`<)$3WKH{26c9#z41Ya!Zz;S6awelcw zC!gnqXo_>{@LgLhD-(va2~Cy@)w?nHBoWM>;SHXX-SDVd1;!#}vZ{k5U<`ao)S?s) zDcBI57)@lF6~1hi9*Y=^DJ>l?Wr$=>WeAB^U|7A#3~kCx$!?u7c*U2`Dcy2P>NmiB zt3g}mK?*gkIR!9h%cIu`vd46TE4?0PNg zLtz8dE_|E@D)mIf8vBT`A#zQfZEuTgKQ0&>x@^$IQ5Z2y6AbR+X%a#k@4cCf4(3Ec z3_BoZCy7wVA(4c#9adD|j!ZQKf zL7M7BjuWE}j|gKJS5zzpG<1n^A>l=4jG!%{$4iY-sEw5S%Ui(?G*{EqJg9wKaOk5{VT1`-8HIE>b^y}wdoIh| zinLgWTMbST^@e9%=qMITDI&Dr9@_F2fbku?8$Wy!H7#F#*)e=7`fR0h9~-`M`~cE5 z3;Y;YDE-^Sjs#aR?Pf)=YGfkKVy+;Zj+m3Ehe-P#zQfGt3@G&hIwpIj721CYJx>nI|{1r9yRL>blIu)>OJKHf(*rrA>+mb zR(orK2#G=KGA@*tz4d+N6p==FjtH7P)Gc+}z!eyCCt4T9Eazxi4qAn%dL=?vUYTdt zJPbk^+;Fzt=K>1}$w6&&eJU)Y{`(T$j{0ah)D45yxRd6xExV1npj4VPeYY2{Y6-`o z$_*5QYfubGPz+drPM`by;orvRsYZVrt4PR&M=OCAMliB@3&Ht4j#BIg;0*bFC}qBt z8fd5qL~fkAkB%g*ZIg57TgWT{HanMImP6z{wVW}IEh8ewQ&#RHRmjXGF#wKt-nt<+ zDDHxc-g7{OVBj$rt#Spi!3l>0u74&)${LY0osNFTDoV?h^Z_5bt z+Yp%&C&dIMV@(F9b@z_-`+iBxVIg+}5=Jee#}5lUCIEThTzz=g`Je9{!I|8nMBmVQ z#1S0*!zh{ekjNB!+sz$Y_ly|A74{45GZfh^ZP$%3F`0LPh{_KqO%lUDOEBL zuqxC)q~ypGDeY|u7F-^K?k=|Q15NH&ilgS z5DPwNwaF&JJV~2OBl9vUM-tMP+y=^p>P1XjDx|^)%BTB{?w@67g;XP%>XUT>U2u6M zHjOibAyK@)Ro{h7(h(5Sz4i+khdQycj^h3SsN9<2AQ(;J9Z$@tlkSPe;tDc}aSV%< zbYn*_i*yLBZ(Em!Uzf4epBcHwjQ-PUQeDBr3FJ-yNGnJNcyYBNLn@<>X_c5w{L(u+f@u z=Y<|zfF-}8Du_Xa&LUCF&M3Ae;<<3>aETBGgwbtS0x$v|LLEaJ?nH)omKnuQr3&8v zE`ou-Q;?4->|rjYnL9sNO5%*G0kkgr3EHrj3%4*0m*O`BWH z5_%qFXD1A2wA$Z!E054r&H6VtE#XVX88~*Za5l9V%WPt-u|Jh=;?9~tM~mMFuzWrF z9xIQotnZ?whc+o_z(8H@WkLsczuE#uri{*_C_ECGF^rXtNWx2f#UU%0dY%11?=P_J zpRw)5qVjNP8Oi|VSbKz|VK7Ving}>$CF=@8;pf*_j!c-6lnK4rcVNvLv&LOFYBiLD zc&)g-3z>{gi^#+-qEE)$)+>}Z!&p5!BF0o){RU`^+e*}_%6T#*M?6>qc}iHWtT_hk zz0@^h1k^oLvfjA_-q-N7N+_EuT0zy7jdI_%k<;=IXvhOk&rGXVY^=GO*QX>Ywl&sV z5ol+nsD+Y4!w;HGgG;6zYv+}xERi9wmp{9 zVc3&AzsV&{deOzhnnc>mIV&+wxKabk38r2p3d*bF6--HMF%Z`ikW))^E?dbA zSgEIWH%VvMKh*q%nrIjn8$gq*6TVyh8s>M0(+5)^1YWoTJgY#3viI=e6>2hlk#>vw zD=(}Qe|`!Tn!L#50n*TOJ^X2v5UFYNnN!+l{pZmrUsfp82ocfQcB>ad`Y2flthHf2 z$rZxgD7-tqtVqD_V3SpHj~FJRa(@ep^@R)?o6#%!1c?@&qE%Y1Ej~WJK)?J<;y}$g z2@+qWSXc!IGsY+d02H+*cW2MJEp~iAhrvS_Gf-Q{>Zn~7vUOv;y*7??v@{AkyX-tR zucF+clpi&uVbC!wCX?2!vlvLlZI@wDu&8pZqBM9!HHVSHM~iS)mj9O z*)TV~Gdv!8BBA=>4&_onmcDE*0XUytx7m>cXxTi%jhTA2I z9O`&>PcC#?u;!Ed`C?f1O5KjmCQ2Es2;Rhh0X0Rk*n`V+W27&u`u5w~(It)yrG~M7 zX^)Inb67ei71eMWSem#Ov|%KW+j!;WW>@vK4(z3?a}UGCFb0aLLc|@ztHp%SV1zU= zrxo0bmye$jIQKNW`xgz(ItB9KN(GvPnPw$Q>BuJTvP#)(YYP2-r$zl=Fs)~PDbs@`V3fU>cMt9~Sk}8eNYd#hi(?uRsrXxGF z<&FFAtt?|oNRo#j7q-I_6ac&)_0E+ck6FaXC zv_xBloZ7>^+cR2!xnoq`OR{4c2j=d)ZQ<`A6H)?+N^kQklNjZuMe@wp7K%YYW>y3kRt>UTl|lnZENgq<#B=U4buT3$ zF&%1hJ@q>vh(w7~1*0@E_XR|B6uIGgoBDYQ+k(9OIL=X$@QdE~^~2&#**GO(j8qn^ zZ7aXvI-f!aGTO(Lt6k|7dkO4inbxGSWxOQ}e<~4J#Sr9Dz!t%qcuHEochW=3GM;sI zaN?4}c``+Ht8l4!%y+V{yFx5g&W~2VTF=|9k=an_8L+R|BpwczBEuW&zUUEVIYIQ^ zqo_+lt-&KTR40aesd=;nh3=N@tg&({3GvaZqWzbwp!yg zqG?!)`bYq_k~llMRO*DXzt}#IqfY;O!sD0Bbm#ye6vShI{JCMv&pk4JUa`N_J@k0)|(L)Bg>4P@8$vxLMU3yJ> z#k3giUGj^`7oQGb$R1Ls7|0F2_W^sj__-lm4+p>#81a~TF2*nCo254G#efipg~+Y} zJR!WrNY+{Y=j3b>2e5pv>WEj+P^0_090&61@_Jwmvmu1|FP~57qsQ?IWRzNS+s0U% z=1>v+0H8SAB>&rEck)8)6Hq>o8&Sy*XgOJkon&9@rgF1*HkbZUkf}DMKtXMaAK`*9(b@-6NsiSn#b*8yvD*xQvR?sIeJ(L{Vdw_l#D011;s8*UJQ5Pno`{N3dI4z4V#7_Luwi{%aI&gw4~Zav%|wCD>hXcLGc^{8DT z-&_oR|1gBeT6H~4&8MS+p{Vd$CHHu=?m3>kT;<)UUUfCTh#{nyJ3zO~>tH`3*ny}4DH5DJ zW!LYsGnUt-Mo6&z{D6jN2wk`OaL7IYp!d5(2}J-2;Cle)9RLajcM<@c0R8}kK2=4h z)$BLjNx2id&$9GYkx;K)bKmR*Jhn zwKo`!k(dBY@#$o-8FS0oyAQE(R4s(<*(rTZd%0kq#iuC)Yd7?_+SlQmwrn*J)eSM@ zLD^bvDXNRYp-m+wS3U7ccQFL9;J~KhT@DDujP%woNr_HwMY|~vw7{bf5~DLF=pPJ> zmXKCDknlu9PoR2bt@wqqSkd&R^-)(pyPT>^KYwxZq z3J+wK^eoBC2Y$&yG`Vw@^F-%}p5vq%aHOx{#Tjz+V(fww`>>{BX#L9Ye!_MKKDLqB zf2OAFL&E`m<5bY0Ht8@VT+j3xx`8XYe-%Y8Bn&LkKlYek&14J(eF(np*}vz=>XC*g zzGr6spP_JjaJK5k$I3H{q%SP(#TRy0y2k{4vciiRv81A7My|C-piysa<4jrNcK zNBTM}j-~V`f?kY(@f*z@t-~xw`80}n>5G}dtF!X8ObeG=GAbm=b2sW5inUDq6>xRK zLHlKN=Z5~X#=a>oNX-Q(qVS0XV+{EOr-KrUsm6~x^W0ZIQ}`3XXZGSF;gxv2{0Ae6 zRBB5;OnZ}vnqv5sMVs*EXP?L9EZ7V8oj%EZVqec;@QrKJn3`18O`CRo(^dRUDUB>D zPE|tgI-e_zEO_0!PdBm+-9*0z`;)kOYG!11%xmKu&4YQKL&FffKM@FuM;U7WMCh#C zjU;!Zc>@oHA7C#rQ-~%GM&HU|#VvfLxuQAPvw13)u$@4069C4~xApz}Ndi2)n6+zl z0pdE&=c=RlT#RS=%^*L5=1&CX75=Qt&xalh)ONvqVuWe=H@mwxEY{xh#uu-K^gqe( zZnjo^H%=2&xp{mYN^RVhaOP#PqPbE~Lx6wr`pp5D=y3$rVd+Ks69M_*abJ_iCdTl~ znFKsGu%Fvc{%m9r03hU}BMFU$fy0hYs))r3ViSfTA^**teB7e)r#rbg&aLvij5A4n zx_ntpTc*N7&4#YBNUgrS@!!O%>bU;__~3qW9us(G>wC!WdMEkfwn^ynIiFKR;e19Z z1SqjptSgTxUjK!0NtqoRzfG)u^&%N0#Gk zdWDPhL(Ocu!$&ODSHNQ*`QMU0n4J%xM#MRWEO=j%m{=tRsGF%fuojj@_l2FC-2f(I)hM}+f zbt;3@*zHcsag-j&!TC@K=iqzbpsj=Uv$6F!%>fS-*$L(PZjRWjtRTC3!Lxo#nTd(< zK2%bCIhRj>K#p_xb=UNL^RuuGv^N-KF3rC0#Z4<@6JZoYKhoOlA{jp9_33!(gk@_S zQ*Y}^CZY4cnLYa8!#Mc>8?!<4TV{5N&cu;UJ3Z$bwwV$&&-$#;-~QKM;9F4*?J{=6 zwp80e7(=q83_-R33ohkCswAIBqi>7OA2$LL^S<4P(5F|pl$?CzOwheHm?pY=7M*h0 zDjLG+^p41L0D;9Zf}a&`)_9MtNvz>&a#wE50J9Vu-!CV)~#y54Dk$0nN|JS)sQK3dCV=LBlMzS zEOcQucP>rJ+~8FpXcSp$cQ6|f13KVq*lmyrh5`i_SX_=>Q{??iy7N#m-$_|KsR5@b zwu#;RWKbYRdY4vOnDsJ#pP~D1Xo&x%Vxr{)m7^wN4fl{^H$&XW+mZPqT7o2@DPlpc z?Ua$32lR^_A6oCqzh@+q)(TKpzHMkoZmgZ3f4MxWtz~7!Xk+^CVu>&yAFfu7spiqb z`Wo7OVtfehtZur-`QEd!sQnG`-^D5eYZ&4qreK|!-09(N4^Bq7*LuH0JTpG%=hxyH zgkQWTjiA07=U}bidLbwEk~5je+r$oTwvbC}H5YF8%7byvGKL9RT|N(km$g%KP$Xn< zZUoIQ?R-+6t`@FsHrUT3_}1H29PI}{K=av>C+3t}?N#6LfJ0*JY~EGeDwM4dYhTb z==~KL?XGPGPx-nNghPd%Bn<-o_%c8A(JV{b`Bg&)@vcNwXqJo@iq<)zvLO7SC?11bF42b1W$^Xm&PZnaz^hMzhKF9J!mEL8E#Q`^Zy+3m%rW7ebOXJ@8em`p28^sM};FFF%_PR)D)f*T(xPJ z{t+&Zh?9%^B3zcVF*YoHWH`l)w;P@T4(E9_J<_jAwrSNpsk7O5zR;|&vWk4qfGYP_ z{uf#o@7FC$lX!cQeUH3maO69u^Jua=xJDFlQ{j1J@qw-xm=h230QHh*|W1d^k7AyXoho;R7mU6 zuNTaAIK2G$`1fN&=hGJ-?|2#3z3N=3(5{JLiwll=m2KocDt$_BXV)sZ8CNGno_V9V zRQUG|=Ti@}*D0@EQ72{et!6{@?wf|L>CgT%tSeLH~QX=In zve=wypQaSmx+$tnCs(PgTr?znk;oLiMO!DV2>m8>Rldw&_OVOSySSEUNyL76{q=&n zh`G_HsAtFS_d^`tdi|TziAZk66rI)yo5Uz#)>YoVlPqz}um=xuMtr;6y?@zF-yYw- zf3_g*PIdLiUZ=TNUpdX~`r|Ez zziHGLz150=KI>yRvQP8g)xOf`^mAoX#&mu)t*N2`t7W3}Z|YjeXsv6#1940D)Pr$T zS0#Ul&|ddPKGEVH%sp=2`RX= zY6kz*&&7J%zbGv+SQR#XV%V+g{7$Kgu^Mk{|1HuAT;n-UV%57c!A~Y1_A909idt^0 zPcj!;8xz0CE?sEp(GztVb>UqHX8MKfvbs@P19r#Hb=tqT($5=c(8qz)eZKizN)Rp2!c{8Hi|GM5f?__12 z^Ey$~_IRk!D#hhyD!E5lzeQN-pA`1rq`Yy}9oI9!xy4IX$N95$es$~&|6TC!N$Ask zs{=1hU0zkt`&sXJ;6-)UyA!uOepB+eUB=@6*G6&1D%$HzcI~**ccLorzIViH9<%)}aVMhMIIhyTV;VmftPRh)w_io( zTH?&{CmcW6{~-BSn|`pq!oz(s ziGCV$bwfqxtU994)%CplT~U~5lxo(0hFbT3JWHp%*eLvL?fip}wl8fz@o-~RiRRf$ z6E6Jwsu?$R`HLr>`#*)|-)Y;h|4IAv7r*QH!iBp3BV=~K-YJM0DiWuL0Z+sL=} YBP1+ruJf5~^G=~Ain#tyvi|=~0AAkRssI20 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/overlay_constructs.jpg b/docs/userguide/storagedriver/images/overlay_constructs.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fffe07f5601263564cd0ed181991e30bf2c8ff20 GIT binary patch literal 49536 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 J;3rnb{s(n+DNO(X literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/overlay_constructs2.jpg b/docs/userguide/storagedriver/images/overlay_constructs2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..bbcd6e0057728f878d46cb97cb1d77edf7133356 GIT binary patch literal 84972 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/saving-space.jpg b/docs/userguide/storagedriver/images/saving-space.jpg new file mode 100644 index 0000000000000000000000000000000000000000..721e90c3014d4938503ba9dae0e9ad27d3cc1b77 GIT binary patch literal 44021 zcmd3O1wa-1y6-F&Dc#+TfRuDMDh(2XlF~@GlyrA@gMxI4fTVyl(hU*eSfPe4F`jzvU5ginHtPk;|| z0)fKA!>qs;J_Z^F{{QjuqXWQ3h8VydLm}7z95w`s4f)XpkOL3^f&hU)fZqoa926b_ z5rT~JV-`TZR$Qq6)&c+o-nJdaZf?8|xfaV%((J%QkYnNDnrjhq@p8EVj1-;DIJqJK z2;MpVv&B`5ljA+71&kVkB|HGQbv*qP-ukak`*Qx)dFMK-f)Xvt3G~vc&n`YOa7|E&KCcr2>{Ts*;J?*f2&rOA^o%t z!&=fHN2v_~t7|?P^z1b^CI=R5>2G`bb%QRmE57)rT)v1Ol|5~SL2pnCI6j7uNoCXf zf*jnH7jn6WFcraaYW81L(q|MKhBX{BDc0|JA2X(=WIZ-=PYvC8cq`Sd)pYeNIa29< zp2Cc;9NvLA%){bt!I84kS!&R`&c}Z+yT*nqJ%*Xt<0691iuS&4aqKZqR_N)%2+W!) zG#(5uOG)YrGH@#2E|sM(Zas!+I2ym|YES#xsc!Zyh#7lw%ZyKtZmf8gueAe0LUR#| zq@`mA4#8809*hg8IUpX2n-o;2?~4Q_J5O9ZB4H~UFwL9RD(T;J`wU>53K^D89g#f5 zxr*@p(-tfOmULeY5Jig_*$y%grl&rPdEW6=r@gHr2m8@po@-NCEvLONMcj9W4HTaL zHOud)#JtRXRZ5Cs4%VZwmJ#6^Cc1eS&9_EvF9`NWZBLV48p?ZeAg>t?!a_ksQ$=vc zM^zJzBA(-!>NF%iUQ~SU&Rf1dR~K(PDFa$q(WGl_*SvX`4%&o$g=GYg4^KOIFmAu1 zf-w@@6kr#wh|WH%dADidU2~mP|Qxq!zt>3Ck zbbK9EB(^U)9zQC&{~BgY@^*|ap1YktN^bqr4o6vun<((GI}aF?%BC=~J*O zG+euWq&)5-4m0pCVoQOy@9>g^F&JO=1VnK6JUzCwB%AR^DgvEY3N=|uHSd&Zs+FOo z)f-^w%y8C)e*0}6b`QK$cRuW4ECo{;M_w{~ZqU3FY}Z9!&=y@-0jDpuo$L|wVXtSyoPbS|j62bc-V_G_EgPP7Bqp`; z7`of?UFkm!{lwH|Y_D+cZhgyZtAWXXI-x3pHDc}A*9cg$Ui zH@p~)e;g4`u~_$E=i$Sjr#(79aL)3j*#W}G`&sWdqXD?fYA}ToK~q=?r289|3SB7y_|Qf=y-#>)*38T3chpA$@&Y`Skz>W8$K*wO7yL7adPB zYXu@eKxq@~S*LbDj^};zxXDbLRsQs2UubOnJUbICN4&RMz-_V^7>T~A0szb(Sl!h0(x=lIW^JjGuM*N&+rFa2Fu~ zH;}92rwqJ6z>N+b@oEc!!}^E#pQw|ol^`79d#$;^6o(O?tFBq-5#P-zcA>Sh2>`ga zPujwIr3HWs%tt)V-Oh}UKt9DedGa545tt#gd%Dj>#1OhaSrJIF^qs5x~=K? zf&|=l4CM41i~>MZO;*OyX0gas8h17eO4W+Vd`WC!O0>_Ea_nGge*id+u~s+&qQm!K zdP=dF+izh6$vW_~wGu{&KEbn!ff1nM+XWj})Zy#?W?#T$)hgTLe35Am3#PM3ft+}V z*iUh1ojD6l08rv#*Qoll7S#%In0AT^x_9gg5|A%$`B(WuD#VfIc3?W_#(`{-MyXoi zokSK5?J6@YU`HG#zZX2(9ZtZiU1bEj=)^#dJ(gke&hG1eyXqVRn1sm9__xpZJ9^9e zf}4us0M}~mKzZfoo+cOsdaoU`cx>EH&((cL1wdA>W6PGAHiIEeSU z?W@33?{=7o<8!aeuiU_1KDzH^=I{-`Q~iqAv|VF+lXy_+C4Bg*9$!7bbyX zqS=JN2;MHR?<^9N?h3v>0iYCa-`v(jTsu3#UIq_zZa_3z&fCrE-Cdy(0MRj1VB@%m zf@qurrnCZE{vAdDot>ncaQ$E}U3C@@%%d+%ZoGo=;%EPX7X<)y8YX3go&M$n30$D0 z;C&nvwnG2m8v+LpMMOZlTA|RZ>F^KTpQz6*?H~`?y_yRkan^9vM9&MD7(Bdf6ze`r zdN}M4MHm2Z&RT85e^3p79BgtaZ+z%}J_10*DKJ9ha`~DUWhN}gxJ}a!n1FCJX%qgbJlZx2mnZ%dY*u45#K9y9Y9ICy8K>#Yg0Q} z*cX5tSrE1M*8OiC!i=H2o~n_5Na>0+y6^yquWARh_27#qn`T+v{W36jP0Q{bLKtBQ zi1NjQ)&SDz$uo*}7-cdEc!`n0D9qwdL05SL10}%MMPt#XHgwL8BgcMljxIb2S7!B5 zUO@ANAtCAVkb{=jo(J3G#iYYG%|Jx`g@EH|FX8y9)W3AgjS|p)j{yMBT-JanWfaT{ z5(vI+qghrflgEZ_9xkm*qiP;1o#&(td`N-m2`5FLnEq@5s2n8-Nw`Cg`vN!)ig+=^Aeg=m#*J0KB4cU=;e|xzT%$lzR-gC;=UYS46S_ zm3@@g?+Rvbpe zYyZJxv;imrIClY2xro+Ju7w-*FNM#=0h^ut4=($~jKd52Jy+8Q09${yXtjC#ad2$> zc0D*Bd6p`yoTJ=bJrB~a(&MrMeT2fiA?|x~Sf-V0KIhiVG9A+5zgWhU8&8f}1aB4z~b1|IG&`SRc5-0)Pm6N`;4mKoPF01O)aNh>wVihmCU^ ziB|=SfP;rnoR6B8i-wMq+d$&y!yyD2?gy|%-D9ix;)76B80V<0AXBdl(N;b=o^f7; zlj`3lij+VUa^fPBas4(`cR1_%R+)gnvH#5&YoTwyHrl`K1gE=j)U70-v!;7yBe2dG zF2-=$*#X|Yh7FTU4Ok3Q3+tTmJu|Vii@T2%7nHSI8RB2YjCMDizK|*-9CB%xyERIx z7u?KJr*DEoEyc}@cy^yeNvA>&M@pHl4v)}iz)mr2Mm-~_t>lfXumVAqN_W0Z*(U*x zIaDbXoRYWS{u;{PXPxyiwPsYULxGItJ@qK{blcIo#JlfgohL^^UmS{!-7BeZ#4%5M zBl`Neh3e$Q-YaI+!LvAQcNUgpfu3CxzLV8yv5!2`wz1@EvGY}7MaR+sA{2ts%!3T9 z-unf&4)|XjlzY`@9O8Co$9t}<_=I+wMOuBR-Hgd%Jx^c4L_Jr!DQxwKt=PxAT}1I= zaim;e1(EK`zwhKROFZg8Vq4Qw_qA?GPs)PT6Raq`m7Ke1e>Z_Hyf{?hUhtG>Kc6AttJgT(^Dwumb~wFw|gb;TyY z!2cne1k(m!t-hpgBn?=R)s?Eu;Kh;(YYAGm#SJ93!0dDki(|G;zswRmd=3s)xW3yY zQkmMLNZtOF0quyokbmFlXv3?CBq80SZOQh+37j)LsyRo8ifw_9&e0U+FNGXEuEudH z(!gVM)!0j{;PSKl%hS0weW7($#Ds;8V$T)5AHbwRD8hDJXfwFNR;M1`_S=yQjXZj8 zSf?dKz2&@pzd%ECO4j}Im1bpJSz*gbN?^b4_u4K()4L{`Q`Gh}rG2p!78Cn=vNq`q zD)(cjqupy8s5oZ>i}nI)s*8RA&$ZC&swh3u*!TLU9S#L`q;7~GWiO)OUw(JpDHaYm z$a@=KJf`sVt_lAK%aO4i8zD5gV4<%+06U3_8h*u8V;e-?k$*mw`5A>Ml3XZ-bC#Vb zZjjm)q-JHhrOodkTCq%;-Tv6b+MwOIS}�xZb30GG<1#P@IgHjL>UUSR1J2oVIKI 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/shared-volume.jpg b/docs/userguide/storagedriver/images/shared-volume.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cd39b86a1f56642ad20c403bc2c77d09ee739a59 GIT binary patch literal 48857 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 Icx8zVhGD`m~6r z9U`anEj`~U01G3-0ZGU9bPjUKgf^*MK2D7FO8DfPm%l5QSy0v99<@wLGa(_zc)7lE+u*7Z54yF_$4qQc zWQervnuhBp&m~yoKW9<35LZlgK?IIXPeNOdW6=;yB#E-YAnV~$`A1D2-ni!6XtarX+8wv`uoDry;-=uPgk!(*dOUKK~={b0Ca&bB?5#3P;p85 zg=VPML@@$2Of0tg2omOv#1JtxYM0}KBKba18E36sS+v8#+p`oE$|d&|=g_EG)_&`@ zK1Z>opxYbL&$64nw@pySs+h`ED$_csk+UteJ^aL_(dPeBwJ;Qesq4K_QiGY3u22m{ z-}8c3LjozRkN7PMqHGyt6momcBYcV`>L$e;)1B6 zE@cK_N3=xu*$d$l6dfv-ESZfyT?ftQZm|cwR>Dsmr8Ec#kI*oj{N`>B4Gg@Tm?uHq zc+OZe>SBUD|6Qbe?!x(_t`cEcB$sy>veVVAnp+mJ9Y5l%l2!|Mk#At)myaq+r%y)U zwH_aPcFFL%JXLOVY&3H${=l9hvdz>BJC#&BrXm5kID_|MJ(Wa`7Eep2VTN1TwtTTp ze6Tm({&YKH)2q2Dx?(iixe*xB%QjvY${dS8xzb&A7xbjAfmx z`FnGU(b-hkTv1t6LFCuXZ|xcxp7quqFF;Gn7#+NembQKzTfWsQ&O51OV-=z!Xx+@T zU`VUZ7N9l8A5_hbEKpN`}xrj=6l^Lm1Mqk*d7B~Q9W&XU~g zur?9`>iMIp=VeklVBd}= zsFX*xjw>$zm`+yArBF?wuEHlbd8OxDg0&~!o@U8`exccakCf_$7oh#Dk$=Gx58k!3 zo}j6BuD<#8&NQmn*Y&y9H2D_lqMW&CO*Hw%#u9hN_!KQNjBZ1H`L61&9($wj@?0&U z7mPEPEK^n5b8X5a|M#Q`63em6C9yWq>EpMP1+SvrEPdX&)JRvGRs}aT9!<3l9j05Q zxu!-XHl96JozR=vTRii&SLvWx<_^9WijP=Ki4n3Q2|`M;P)mqosMOlQ5plL*k# zBK!)`xGgvuH|r5Y^cF@}7Nyg_G$-(jsJgQF%MV3`6!p(lr=pf<>Gx#puyLHJc@PmB z|6c=A9(tF+2I2~)7PBAZ>$=FX8fh@oWCc1fvu)R?b*+vU9B#_VQ`qbcJhMLyUFlyC z{ywoM(1LSXcFz-1fO;NnKZ3UUb$2_7SfE*aqqOt1kbf^Mz#PH@uk zxs~@mH~Wl6`0_rl3SDVU=njIuCfu-+(IY%BrKi-~@WdZ5ugj`$3GmK8TawL)-Zm)N z)kUxovmf~rTGm3?CMcP34V-<)BlRr0fVnPf7Zxh=MRI%rcWy~f)WSARaeos}w&HQ4 z{sSPAoPzTRF7WvQL@JLT4jJ_IHr>4upo{)83745~OFmQ{WHP7iHfgI-n<|s|Lhv2Y zbL>Lnfleznv9lS5C}br=q!T5CS&mZ2w3V&5d> z<5JbfMDd(6nWQ#pC-g**dPm-MrRWFGw4B|m^7 zEd7{CP4V z%bE;>ZR@8sPoJWo;lC%TS@NMLexKiXSL{bS$3$O(8h)4=~ByJ`(5AB zsgL}|nNnh|OiJ_3`n#9LSo?-N-*Hy%*VCnpd%U#gT4^`xM!e(rj2vF;EM%ss(9@&J z*w*cMyr5H;JBru3Y*{KUVR$STW>}{6<+~#kG*WLqT#BVmI zBLnyrq?@Sz=6DMkO8k{hY4JEc^3KZwcI@dhT7p`K&~O7i?>wUTzEcDBs`NRQjOx7TP> zrmK@y9FK!bb)wV@w?ovhc}le5=`lv(jKOu;gQ zIor}a=yD@i)NxL%^w>*2og)TkNpy`wt!da*sp0(!p2{pRY)EdCcl#~h`vk-KLayuT zlo@ku+Dd!Z(J>JhOnB`ITG)Ew7e7^s)V0PoQ?G@-OW#?Fp3uBZ)Jnn@JB~gscf00Y z&X%`x#S53=FvYzsePZ!-J5`!f3f|+(XRNo(L+%NI#t^ z7!z&^Yl_p-2miDJ(Iqx-eK}yYX5QI5CGxh7xxj`k(WaqlJZj?+y%xWPt_>N@Ta-7u z_$!*1P6^q0#O^juL{Uiklic-eS$>#MOjsf&Y_Fr*M~&yEf|KvM7d{7uz`8Kdu~6C6 zBd1~PtXxP5+bd$hu&ypZi0Ydh;XFZsE5uidIAh}PKMJvssxS>O*q|B~SY2}JA9gDX zbr)=6rwc2@Pay9^8~Tb&O>Bf7MCNkJv7GK-U3+HXcku0b0GCN7x14wNLyg(%>m)v; zT8=hfAm+j+t%7V|90FaTqM3+H9}0cSrQcz7^o7F5UaVtx9KdHqbmWs(YZb>9v8 zBV%v=mm{okY^SedZ+TFtXZfFKP?l^g|Ef;S2`Y&)?^BBqJ7WCVpGu=ebUUb4vL`$Z zicbC7|3p{gT0AYsvr_QQI4h{h`_l$w z!A1ea6u**~ddz-X!psQH&1go!VsSrHx8d}WP7k3??V0e}i^YYe-##FYWQb26BkeqS z%rt{vN{18tc{d`=?n*u8A7g)B=4`t=DX-HFCv+B(qM=4Ddsj(E+1E&<%U#>*x1$rk z>f@ebxf9n~rp5*vbn8Za9d>+-(?0($h%Ae2VAO4cjJep0Vst`ip49sE;D#)G{WPIX zqZ3eAnz&Qz)}7nvmlT?3Y(_~_%t*+w_sAxz%MbBSw6EKIyO-9P@Au(?3XyHaT#u6@ zD-~l{(-5DJZu9rJm$NM~%g3GzGjYlBQ(on%*61`w#^^5{61R{!C3p*o$>{jjqr4g` zPJ#qvu1ws20BHm`c;r2wye!^Qm#}xiQ{`CEe-WCqjIzBCN>@O$Gb`*Xy4LU8NddSS>I-#h4@!jX z*X_nsKwx)oSQt*l>(i=qKDePGGI*!zNEhjyyf8lZ1i^9f>RU%bZNC9N=a#U*p*GW$ z@XPh2T6rv8m7;N<&Df3+o`vrc;jIH{yqZke8V)Xc@=iuiJDP}6j5vsxh+?E#oAd^y zrdDR_Djqz48Gzm%&4R7cZ(`a&QxyBrz*(3quLGLeF^00|&)@srI z*lN+XExf2S-CAE2QbmFMxg)Z_wgLt-5(ZSH*XM2vW@+Y3D4kS>s>mMRgU=nP+vyMP zUe-e2xe^bS8>h*?e$mFiy^c}J{7oE|{$}oOMijPm*y@$}d722RWNF*9+mLU;7q*y@ z@5O#NmnIsm(kO1ravd}cwP>`F+m*M}2(WuzrG7^F^3>lT^V2E?xEYs z84zom3)|wEg();EAv&s%yzS-|;$K~`{OnOFB;3DVfTG!s=9ztnMA>Q*<`t2*HY%OU zrf^H3X>lzmm?W#5f{&g}eIZX{WKBu(soaDDB_d%_AtsXT?@{MHyl1lHJASXF$G=k% zzOsi=qyP2n=<1626i!@14sAFl6ux`R(gm|b{Zohkbn?gxIvEmFm`n3yEpMu zjLkOL>;y*ZmtfsaxX>Q{dm55CsrsOwB3gfQ(kaLYbbKOoE>q^CACH=jW3I$q-uYD6R zF$vq7r$p!@ov2q&)15g^`KvZLMPb%6zj|i)7CDQG{PEhU4YH-1qs_IC(O;W^qy9^R z?Jis;jjK1G1glh_M2#*5tNCkNy<(l9MAi_anNUkIGUERd8GF4^N|F|v^m+Zf*th{( zP33h36S`y?(a_)Lm$Zu}+{awn%qUP9Q{?GhId8uqXD@YLqk`5q8?itJax7UzZtsHo z>i9^uV<}$2fWjM0`JIq~nthr`N-YW6%k4+2lbG$+UC{u&aJ)*^^Bl&_H=}dO? zloFO^ZMooKl}QVFd80QE2?By&z1bQe6QKTn7yElwYWgb*b&Q34xjK@zo5D>hH1!~d zi{+OtoBz4|9$V8j<*L<8UV28@^_yMti4Clc$G9tOlJCoKZEApf_uL z(0{pRBgKKLrbOwqt}7SX^ZH$qNuWZ!Pu5yMQ1B~*;wG+*v|r0`ORaq9pvZQl*)@aZ zKC(Vt$k0m(*`5aPbhUpt{yH{Pt<{SEMUCzg)!*CU#ZBIv96gWbRTw!Ho)A+9cON86 z_)R)gciG={6x@C;u92bh$8Y`~u{lsZcmOU{pS$BGY{M-JnWN4BGSN-bW~0;9LAq={l$ z6dB~lz7AtlY-_Dd8;(n2qRpf8>DW0aaccwtKDzHpzD#81c*Xra)4*dRe)b7IFr zX(hj;RG?Pr3se53#~CtfHoKH#v%>l7#4inr4LVeZyq$g-r&#~!J7vG!QM5hewCo|- zOC|QQ=P=`QvD*ASVvp^AgH7LNySU20sEV73yore99;_wi{gCJ6z_9Mc~r5E z;jfmAnQZMNAzxz%(phk5WhStw%Ad)m_ZXih?lIp!D>t(Y?W<%DOEmo$6)QH>n-2TR zu$zOYdwqk%V4x$}L(Y+sj8t?&899Q1PY?nh>da=4wZ6$@ZNNCMAyl&=o7HljI8=Ux zTQf6-n-781$^iHKQCrx6wbEx+oP1klhKY&&IZ+g-Xc^Yyo^$VV&nDe;{Q8c#F5gf`cn zvzE02q%wB8=vk3Vw)0H0*$;72B6|oNZukf+Qe)wI$Q@=#UbOO4F`R?1b-Dz2^$|K~ zk|Xpnbj%;C}GKPs3@byWzY?jwK|kTWxe@7ypZV4@e!7V?M`c0jPqd4;7T;^B~FH`6&U z&F1RLSQZYaouJWs8w8wRGQ2b>^52L8#mBf zQag6C3W9avQNFfIwpT2a0~sdI`?y)bKv81IpzLNsd^(I0K~dG=u{JF7ELozci(kG& z4kdom2(f8F?3mVDHpNtd`U8Pa&@}D-yys`MDzRVz0R5onAgL5=#N|yo(*!)u-qN+mG%syRPO0M!L@583 zXrykEgc?5|F6Zw+w>!`DHt$kJO|=bG^Y7(sNYPD~N#Qn&?}<)~vO%{5bs^k0TyBrO zr`yI^+U^Bw5$cR#eia%Gm~eb9J%PhUk1DT>l5IY3^d8@f_diq;;i6Tftxt9otP@L{ zc~e*iMVw)kx(Y`shrBlyVmE^@m*ekwQ&#Sd%8gU@DvuQj1FILPtZ+Q~%Iau*E^ch~ zPqp$4m1qY^O&7!IP&g|?bWBpTt7k_qZesNp+G@Otw$*D&UnaDbw*Gkt^7HlksQ+|w z1yBCP{Fs!*d2v+#F1+8n=gHOtan2h_G4cjO9;DjBhuH5ersxRpay3O#sHhoVb)m|7 z(1j&&Jf+$Fk{Q6yK&o&mE^DQysu%W5vvW**Hr&y7Vu&e{T}z>0`k7+%&P||nP7FLP zE4xK7a)o`h%*#Yh53%w3`5S~cA@n$Pj<%ky=4Mk<%zJ0wBA?`qx_LTVdKr9t32B=k zRyPx%t1C)#n=aPqFMlQY)*1T!kvrlZ0?X1V&J?D8!v;eEb(>Sa`g2*I?WocZG2h21 z{)ce2r(w^sBv2d7hs_uEjyreH8Bm(g7)EP$FbM29!jx^jb0a1t@pB%Vw%Z~O;dtiF zwjMkgyHt|1t+A|D=c`_+_yMRr{|?LkbU>59T8rpl$J6_B|ZQh8umM=>oG|d_WNa%G*5izK0q#FU7Q(>Xs z!kl^bQy^Dez=D4_^=Gw+-u9qqSY*znsB6?_nmw*N;$L|0sf)(cRK0f<&wf!dar(QG zNIA?TO(UDy)d!BxRCvkA?Q67B(>NFFV`4VWu)IUiwZ`iX0ME+T#MHHVzEUuh7+puj z{~v)RDy(AP38^))^YmYdp-)NV3#5tS4<(s6s*EmZqO?$3E38~;FlQ2Ye=1rTT!n4) zU9O?KRLL9H*=Dlp`|d7&Rrduv$KTTuYS6*Ip7o6`;M?`4O{0|23v{}>JIZfQEbw3N zL*>`vLFqCy|xeG-lbE|dp9pUpFkpkEEx9bFmce}YKR&?>AGfgD( z_|z*4kM~9OxBGc~Pf4X8UVbpMU-QW{__Ke%6^82+FCFVRiQ2C^@uKEGxFbVAZTg=P zOQhbSL`tvE;-jy>CmGM;*F>u@r&U{crb%4-j*GT`reD!bZE7S-o4|eFb5%I|xzRyu zx8BSv@|E$O_~q&OJC8+n^AZvCPf5nm!k+V`t)V}F7U$V<->cHbZ!CK_y54x;U+jv? zvVH)^s?O*7Q}n;c7l?(%f&3yu^K!aD$4||d!No_IOX$n18lI!z4X0)?N4f4qJ!>>t zgs1G^D*TsZjY=g;OQZy-M^PwHIXgAs8M%xGm);W3@@L$a;?XYu0Q%h@&f&K&%)hwE z1-L6n$gXBL#t;-Z(L)IKJleusoN$DfT6yJJvdC7+ToO`sp!+0WN!#|)8gIWw!&5e3b@Q=}tLPRytRB+mCu)iI{b!7ienpTXWX168usgS;JR9(_^6cET zvR}sN-*yWqOuQXf3&F}FSa?S3m?&;4XV1-o6BGN^xdAGmYW@iemC$76RI(QGOGLeo z!V}yo(~-vVLFCTpd8FF^v~{ryRbFRyUOa&T4`-x~V7fBvGj-3RC)Xr}oHB8vs&%fW z+`L+1LJV_h2uvoLnQ3)G07Xj4Z~&67oN~U@E5W=M<|Wnwc-BR1W;3;mm3c%SSLCib zqT0D9v`ud(H4{-Ugw^kuz-719wQMlC<1($wit3y%q_tJjz^)V|+=$HGO{wVmOvdH7dF182Km6d8fA65es7 z$}0qOJPgDAkq7nD9)TDgXyWN1R4smyx@7oj!A;@sI?PJoiAdC`!2a0RA+Nh#@<3xx z1cEvSs>yD-kWlH2CZ%Kr?xZew^y|Jk-)EJ<1DW~~N~l>TbfFu0t}WpDgAiMWHK+h zu9CmZV*<(ddiO=ugf3^;a-xkOEVB1|pRu@1Dyj~914Gsxn@a)}Z|Gu)vO7I9m)X|D z!G+aO^-4cWwbn(IA3zs9L)|@i7QfDVB^|-wLjM?>m$5)ah9>?wZ}ys^e(D~v5fo{B zmRRr#MNS1bGTpkUJLW{o~_G*-!MBdb)ZaH z0+~hcm(%KIKWThrJR-VRS?){?)^-!2*44%@Z?q2am!7CKN%5e?myU;bZCVb$MVudp zqYmZbr;=4`r-^I*Ngdc;G1`d;VN&#`=?>ju8fv`FqjO9NaPpjrW0W&;xUF;LHv+d9 z4z(*73j7N?w!>nNb6UDJ4Q5T0`tlemY1b!l=CK`iLk>cC&wE@Xi9L*(C?kZ}bfcw7 z6HEKEBcH1OKL*rBhrRj%uzMxZ!2{XZHoR2aUHTsiWyN`v<4tl9cKB45jo3|~^d7#H zrL&D2_b6vGJM%-`fLIi3o1>H!DM{Wm6FoYDZSM*OYUP@a^^hECa51iwLN}dlT|sU| zP!JDKu#EKjrF)V8`{F%*BE4CuMZMYTyPnMI5G%_Z^3Xma;|lzB9Bb|-COn^=%1P(* z@Oe+>>chcG9AmdBcNyGnT?V-_AFC3NU5sWYzTNFY3%L?gChj(i?AE#2a9iCRVa2Iw z+GsXfm=cSKgG(;L>(j6R(&7W^;k8xuKrn^kB*Vd)WZ z5s_eO;1yr{Ful)Yena^!i*sFR-9X+sRfW>O+mI8D#_e2i{l$3w{Gc*0usHJH?j zQDvTxlvYsSqhvTvL3;(U5f2$JI=Kk3qHA|@mhBpe(D3@rFR1At%c1Rnut3``0bENnJWB`0)B5krTnaU60g zR(3IEBga>-qcbZiyCyiE$8>yw6<0C#KcSAz>coBFoV~^=srvg%nJB{Gmog8rUF{e@ z!JlS|eF&#IHswt)-JDm@Npx1HK_DD{g7PlVe4Le#TrI*6CPPxvVCy~0V}fgI4OHTRqVOmvXA#CthcF3Dje%`zO zCyOdrGgvy>FX-wNM53`27ze7mIy$p3RaMMcoA};Rn96eweap5xCY^5dpvai#b1tl# zw1rr5dM!0jzs>f>*E-csAKx#Nu|HK(q|7l{eH^ud^`Ln8^wUyYqo_i8GPQq}<;!W5 z`#Elcr^z9SVh)FdJbIToUA*)vxIyE#2sL4am3AfbU&9{6+!5UhkG)>K0bWB;n@n-QwcfX>E%Lgn=&5@IhGGohUK<@EmqNU%2 z@{5Viw-(Gz0mL)Ya_y>_SAoq_CaSRj(^f` zTWk|s#HE}v{M9GyGn}7vJMm}@5PDQR&^&o7h6UxX%@37G>TKg9(&mqLM$U62@TY|PQ*%m zt%8b!Q%Q)6qdg*JJ@! z-B&VS@cZnZmw8amp7dq|IZJbd66zgavvGZ0plyQQ5Mb%U2a?gUe^GU?&}e?$Z3z#p zW!o9+A_)(tV7a_L7ys3}3RAyMmtZ_KgyB|^l zy)pVFgVbtX0nSe)R(Cv#zt+?xBF#ja_dUfu@lWYV|W&cvra`LTS@_VI1 zX2g>>t8_WBm=TW*))s(5sK)Vv*>OVV$Va$1A#%}|2~Ht9W28^r**5xOF^6CcU)`!& z*!VbX?e2sd#=SYZ?bNcQm&3J))y^!GXpIf6@nPeF%tKxmeIbLVh5lYW)Zy8cSi@)8 zws6r^E&Lj(@C{1Ci$yq1JSi4erGTqPNtx7CW96T>?udwSd1blX`iFwR8thZQ1+8iFyQ&?f@f~eE@19 z8;au$H3*lFA^HCx<=*>U;nBPQ+utBOa}R&ISEeX;x{lb-4^CsP@?~r+H%AE7Id@;4OLYiglq*Wu zV2u+&|Nr;!mQ~)w2cKj?-SZH|;OZ{$+JQT&dW$M(Q6VeZ%Op70r7*0dErhq4{}E?W2sTmLB`{qsF8w*OX~bZy|MmhlZD{>b3B^Za zTV7b^h7zkl6f(8v$(&x+N1@ymJsn2Lhh}eGnK{dIGGxMhZ=aen-Rat#C8ikjW5|{0 z6}7OwHl-tkTgH;%z}!8-6{wETdb9uKGQh-QTZur$7hBaKT6m<$2_JkBXA21f|M@s= zqN&2H5?^F#^qUjej*%Qh+Tn~^y7dn-=iOBuD)Ky)`z$5xiC zcCZ_!XR(g4(POb_sqkX01_JRGftrva?s{SR&nkm`VjL``G21h9!R58)s^!kYjg!Ri z%+!12{arpUD%bIw>aU5X-46Q1G7 z?Bq}M;!zw+3Br>q{MmjwRk61!ZecotHbX;HjW5r|{f{AapCIyk4BB~oKt0B^@MiVm zn)((C|6CQF5%KohN?uv&vtz^UXk6*P1~;o@x#;t6IeA+;IMYtQvfsohOsQeHof8se zrEH;^^;rTTaDd{)a3-o?BWxUQhA2j`Ct((RC7WEaMQfdu)~(vBRg?SYr#ABCX^%Ch zD2}UL#f{sgG8+o?31vA$Uog|~NT2BxUOeK=%?a$=GH@M5GG8QYy#K9=)P8Z&Tb@Yd z%)HmRxr}d8m!O@Ec5!&)iir@QwMx?Y_W}ks9g8;$wVmi{%o2wLCY3ow>fXJ4measq zY=|pEu9?@k^H!c9&t?Sf(;j4TN;@`rv@7b+y-F$^;Z?`t1^!8e2$@FYrl94Xs!@jw zn*19Fywz_~Ve-{a7Q{{MjiN3}_6l2-r3_!uK@nDl`=DX_(tNx%*!3RFcpeE87l1Yj z=XG>UZKZ3B68y^7Ab6Zhc42>KNJoVwARKNnrF=etLus;Qs*~8AtW_PK zE1?o6h2ANfEcNV0PHh>>vb=e>0ER0fztDfusn^idWx^`U9o53JhhELOVbD~Td4aB8 zwJ~q6z2iu}uv#%G2yrk*R7o(1lcwpB>aIlN!f506>pay9)~cNsuA`j&i8j8<#_cI` zNmO6q`9hiB-qt_UKTZA2JKKs1`^~=OP=@NdG-K$NBX9+y6D_3FP^&(+hZNleo)GwO z`2Ck1j1er8-T-N7ZT&F6QZvTzEl>D zXN@QGh5qH)_Bi3*XGHTI7AFZ_Lb5^AVd?1}S7xabxnx7HogY%l6HPFjscL+(t@O8eGAl{Sb#@SaOH^ZzNq$7Q+ z25WYb8hkzJg}mP}IfM2^2YJs!ri8S*WB5IBPtnvz(cv8WPltSe<{&TBqh9>3!WPVR zc?CE5^>O$XIi8YfOXY~z4*uj;2Z5IV#oJpz#kFjUqK!l2?gV#tcXt|Z+}&Lg+}+*X z-3h@Rf=h4$1P=iM1PFO#@3Z$l=iVp(jsM3VU87g8s$Q$Arq`@lRT24;x!Sqf>TuPj*jf2>wG1{Q)!K-K84@qh9H-iN5m4@4vAE zv{btY+A9NHzPan4JwgRr%2Z0Ir*A3VHfJ}o+2L*}9*Dg_Pino52sC>YC$>^$bkac- zy5ZWU0SG0&z2wrKS>L#-@s!d(i53zOR@HpL>{;_UkV?9zuc!o_LI&Zroh9tc2Mu8Z+)PST`^hL|XtQsqd`*`kk5pktX$sTB(YCwxu*IRRHQkMDsW`^_g zheN)V+!NJGR<}AvXohdp;c%{$SJAbo;x$klI@)l+7fwTCD>s-uBJc;qtX(gKccOJo zKjp$KC1y?2P7O$pK-j9jn|3>Jb`~&>-Fw9#vJ57LDdNwa`td(~bM{|`Y!Dn;siS1^ z1Bod929(Gb!^e`3hL1%Ebn??vF@@yehxAE|ZK1-uoFkpV5tv@+chW!`#c~A%GI^7J z5J0VE2k2)8RHin836HUF6A!VRjX&te+WYZJY;C!xuDVo)-CC#tAr+fWYjS8D9AQ-G z?5N+Zg37flK$i^Pwuo7Sy{kPf#EIoH? ze?@zW-_VblG~djQR_(vk%cskcd8~pO5y8GR#vE<}AQ{5@h%rP)RGgcKMPzBp2(eF&Nc-3A_j} z6bncS0@0cB0iNAj5%WWTG~>7S_Q*%93q!RhdC|auf5wVKw#dAbxuu6SH^HZ3FFA1} zlml%Ks84wAl@Ih0s`0*o=HArFUw%4G~yvZ@l&Ls zb+3TUdSn=t_A=JI@Yd82Mg_gP1#&G8CppX#8?@RY<%uZENfaLMsUfTr`|} zU#Y6!<&~JrzJF%zgLM)h*f#cC{28%mgQ(JZDyYx$PY*w_YN6>L)+({Bq_$WIZEe4! z9Zbl0V?PlA36sc^u~~cnM6TNynr6j6@wox8OU`EZw7 z^ulk>_5a8)YezX-hhYLb8XeXy9E~>GrOH%bKK@^#qpi2b+YX|HqeNjk4sm}GCE-+T zAq^SYc2DRZVLqS8N33F&qkPHNZaoLRY>R+D+tN)W;cg9CT_;Atx8lwHmsDN5d_ppo z+{`K}8x4;Ty6QDU1i1<<^8XE6(Z;0(&k0$(t0 z=%VO;mXwm%jQu@Vn6f-wc?HR6T}zyjsBT|GJX9Cyz+L4w;&~7!9S`=7?fkv?1r7Xn z1z-m|_WSKB0P#s%_1Ru74fhmA*~?%m92RZS&N~evRF)sg&P1>5?4a8gcE!r+=)2<5%&^GGCKi{RsAlih24dhQ&j}Ohh zx%9Z{P&Ax^qR9JLS6%*T+4{+w zM5fInJeI9aEfIxQEUng|I>>d#pA;mUz=?KfZ7fpD)o>>I7mEhOF<8`cLcnQyHu1v7w34X@jFc>4A)tU*NAK!Ssy_kW$KSV*P(x z@y>MaUl$zh;5(jqWIBHVOf_|S$wIcfCan0mNMQb<#$Cskc?Hf(CXMzG+bThQ#J}(k zm8SgNCnsO#Dv!X&R7t0oA|&rg&f~>q$s1K&dzQwl@n$@RBIp-jc%k6(jF8jCL=3s` zwAKAurU12E@Zl}nm!Xpc;WvstSC3{NBNj>gg)?vVZpZ#CWEH5ua~Cj+jfMhZ%LjGF zP5%V~3?-qkmus6hgYGtPhLOqKtnnybJvQLcR$_mse}lj;z`l*jy<_`eYCc#3Y1xr> z4zXH8rJX>jEl5rBLHmmeiM1LTJapipAfy!baX1dzjX7-VfHEK(!2`vJxOEdNk@FH5o0;tNRSOSJwr$%|Sw_rXKgp z3?eCavt29=S0amcF+Qiyp5dqmEvRstECMv)&|yzT&oBScZhwHDap4>`DTeI&j z|Di3Y#6czHcIxO5yC%K3oZGPsHWK||^O&(H@P5ty%EL%|8~a*yp14+WX}s#|POz;- z)@dL%3O_9-G}@Bvk5~$?BpyAH8WNJc1)Q89+z2A_h#*OG{FLOIlu}+*Uzs#W>uNIv zy^n4&{E5`M3hg|^aZ<4crru(j%AR;14yX2hkhQxGG8-#?Cf7QmF?K z60^MCRc|%)BtBebXKV==&q^A zqTd%#BG4pl6$0}Y|BaE>*?-QPdrp`2SrBHu+9MG~x3qM9$FAZBs)TKC)66g>AYDo} z9|nnCY#VbY`p_wVh>?HjVKwG`3}*1KWr;QV(m8T{gD}6JXNvzi_G9#xTj8-^XzfeP z9iV50Al~*ynBJ#T$FJi&Bwg6wavQ)t`#1ZUklLvGRb?v|CDu@WU9wK{BH7QEu;?;h zmIHFOdWYvX6=_ydRz3oHvj+*r5PVKF+1onysJn(Om~Ln{e+x$uynq0inV4025ey;Am#9acJ&1crqDu<}VB*zHbKvPsw%PL3SnFd2B*qMoF1Im=F<$5(>`H zp9Pj_NsaPRfZ)UI0N`PK>jSV#{;7~oMK-FJU~!RISqbA4Okhn)7AJuzSPkUOSjVZc zT&C&d!;je@2)BWwrtpMemMD?p32KJX#)IH`Z=PLWP)5-HRtl zLDIvA*O_1NaqfT0sP_jWH0M5&3MF7z+DxbNfjuW0^#d& zTCG?~)Q{y{v~pY&80h6&LNxJmtS}yrD)fCUaKDPFan2gEMmc{nAk)H>N7TKAw^oDq zL+JhNUM3JmAPw4K|6A}AcQMG}gh}E{zIpnedK%SY<$=L=;w55+^qGpy<>?wcl@8RQ zDa8+Z7NbcVjO|Sm#Mey7w<^4kdd*vqwRGSXeR8=24))>@Nji;+UU4UkAB35Q6@&70 zpnTq(Ux0rKwdw{Dsn-f%u6Z(i%H|IKEEzPJNfCM`?n`c z1vrs$8AIV3BeK)r>VXMk%eNRKFI!QMajFX*VqhX0u@uixAk&ViDV3lyQKmMqXa-rA zhJm6MhM zqa$z8n~WswwdV=3Z>9hJM#A#~BbW|s7u)pep8d@-SG8HM6YxBY4cD8=sE91hT4@m& zuwlq*T>M$<;X`ov_E?o=^lh&4uS(i`Z{Z{Zj8Aq{SHA_UGh|Wi4i87cw)HP6*T7)p z)N5p7%;TzmT|`UscmMXjD#0jOLr*?dU2fDTqIa3zUJeSEZni(yQW{!Nh;M|-d z_)kE;`n+gcF?hI2j8M2 zT~onjn+Skx$Pz1GglVNwoD&N&#@h0=SF19}ve3|}o6!u=Sh^u)W5Y#wuqs;_WBZ_d z`4__t_R33_RfqE~DY}sJCPS;U@rVuVhL&n14K9e%6at z0@-!CQ zN|=?sz8Tp7;Pj_7SKVQ1wGNEZjD`jWfZ;gYYM@q59?53-S9iQA7!0j(n>486wiqsvZZpvlxg>cZ#mOK=}Z_MrM;PS zrhF>w{yFW>DS%~dzQYzq=s+5)^MEkjzB)1vS3zRHl0VDMk%DBu}h{W`#6itH;_mO~*cssw&imzg0{Y z!CkjyOkHOw^fNXI|9OIHoV7jF*+qR}kO%T6U-Hcr1p;gejV`iqr}=tUc%(7qUA{PK7f_8; z{CQTrM|alv<$}g{C$?of(nDt=BH=6UeC6BAA}K2I!hx?A1#~KVTG9*Zuter;q@2Faz;SDia*K(EGs!0wmWd5nvtVlgeA_8tCPw zDV>u!+~MF;M>~gV1a6VUuL|w3OP&t{mf3ItiDW`1r|Q0w@hxFwFRr5&p&%S6akU2(ZGcgv_OcLCF78;zAjj_4iiGKO+$*4W;> zq1mASdVJsgK&f$;r%rPc?^ye5V_u+K?hz+rnc!jYqYdwq3dK=Yct>k zYX-i15^V(IA)Nyl&`>-d5nyGB)#c;m=+YP>17z^|*14|&$Y90bXw6bo{;r4$T=gpN zu#B}s?F!BISmfa`YIPW){hC^xD7J`^sTM*{q}x2%gq&le680JtK|Itf3(C<<1L)7W z<7NNM%k)^c?1{*87}ilE!Fh=O5tZRk=@JeKRrOX`QO(A^n_NBEjV86HBD3m!vss){YHvKbO> zN&-v>9R-nEz^X*^s4>$zZR~^wml7_UaulEw9JL0ItGGUBuugllj1Er%*cF=iNPwN; zq8x!iXYd`KsEK^4HmfBBRGue3PSXV5&I!9K_ClgT=;AzRb^s%aM_a=aANjQ$MXhU5 zeZ%WE{pQ)wrgvtyjoJ8@N zv&FSoZY9YtO3Lxb*=S!mXE}5z*&bJqKBf|>+2{IFL3g$k>Owz02vpL#0I`8`vq&_Z z9vJ%zJ}8l5)fi7=S}Hh|%^-`!IpjpQuci(#m`d&A5C^$?uL1Yu$yq#%hW+HBl*d>x zp5IO~WL35Lbh33^O>C49t04mmMA0^?d=Ol?5Wq^HdR3G5)Jc-^AGDMh*{7B0w%ckc zmkPimuQ^gOZvCNLf|q_r4kb9Y+Nrg7z9mh4y~1(EMF(pxjoq3;Z+_5gZ;CP-g}~yH2GUGc(^P-h zuygg3J(5oj+SgJ=Ad3^y%Kd0AtW(s2erH6qCDR@ zcsTIjEr}=dm9RSg;p-ekkvJ`RpqS5$k{8vbeG9!fC*!#ub+mhKqZ%8aK{CS>bzh*p zszjXqnN?kf-#lQxaGX;V3EkegEL2Hqkj}^#RF^`U7+P`tIgftAXNjl+kw8gOnd>p43|STnPmAY^bl{qFxTO3= z>`e_2sTp=vMY1NVvx!$k$||8B8>2`9TDX~i&Za~CPH`?aVron7V~?EnRq8`f6zNsj z!OAbg!`?olx7?*1EI9Y=VQpz$`_V}EYRhonmA*16BkTzQk*!Uunr`roVmxgNC(aR z+ODdqn9?aJYpBYY4{H>-1`QG5+Asw$6fRr7%V*axP?Ik_wo>u(Vz$%51UA7$?UYFc ze-FE$1;d8kUfb}7$-_&2D&KCsJU~2gu_UmcUsQG^m&eUnLw2jV<|IPU>PKnAPHwHe zt`c(#Y`QeMCWzi%+|sW}bNmI6J*3(YqzgKvhk~UG)v>#=-l-5RL)3mlAI7ZX?%(>1 zHK*!vax%YAax}kW3rj~?ZK$e17g=Dt40TLS?foUpNGdSHXevenP(S$ee@qqS<#*$8 z$;~@}cMkRa&V^NIEhB|KApI(Zy=2=AWQ&7^oBgbzNwGduQEi*It0w>VNmPCB8C~#A zbockD>YwJ~CJkvIok0a$CmB_Yv%=h!lcQgNPdtZ1nq!&DbqqitfRiKpW6hV9220b1 z0&pKO{qAT+gwy%F;gYYwjvRmw2g+dfPoR)99c?_E_3aF|xkaQI=(-B&DU_8_<4iq)B zW$?(!-&)4OYsl*JZieCyyXFf8Dn|&RL5V22q$@x^D~+b|rZZnY#uD6?_P2O3JV$+E z>a?a8Rjh+5yk!jat7&_ET1v)j0~RbHY;qk-3{JnUIWA~fIocH8Gmm(>ZvnVxk`ar; z)G!o4Pe(bDIfrM>8R73QBr>GYjoTRko);S(j$1u{TsRWNHgelkeTDk#O^a|NAo-U} z(T-qRllU}b?$);U>#T9mK~sUicaaI|v)I44g*{_u&;K7WRD=pKi{iCkw`62>VQ=eoPxsx zN1%sAT7nHslMW*jk_W^=v+Ka8_L$t3qy$Hfiwz;W@1#dJFc;|CE^$2|9>*x|Q1nUqFG z9vX$w9u4Wj>%A>orsB^0t25%_jVcwNnFMAX9lnySVE%BnBRs3dde+^n^nqKnG_KC# z%IOjeOCzVsDwNRrJPsis@V1hcUWD`KTg9mHJ$;!radVqiVb&%nQNxr0*9=fC?k-as zN3vK3fE~f7>Wc6eAeS{yUXkuSR+=(0>FQHEb&4#Ke`qQi1$=@@75P?w;ns>SDP`1f@gBWA>*Pd9}F zT98l+MPh1dk15~V$kWJ&Dqi-3+YC!1*|Rkq(aA8Ql2fV4^%_Q5Jz5uEPn=QC@D!Fh z)h&hW)#dcQa4bA0JR}MJQA9sLr?(uFAb$wfxwA?mN9Hf8Scb|h`T~ZkLzGOU*^RNRU8T3_ep;Yb{z%$JxTr$7nx>lL%ByW6A4(-Mk zKIb55|7*>$C|t&$uPV!`Z|16kpqnqBD~GEpY-DiF6+S(XXT7t`9Eye`^V#vR=C1@` z6_A5uu4)xOV-y3nQ;}TXol+x8v}z&nvAEB6*Z&Cp`Br(pqX4T(StGLE2KFGSC8NJ6 z^N7rOBsyk^Ibps>Y(Wv(CCJ-68}8{27K6ltbFgV2qr@1f;+LuGQqg%_Ksg%!tgYEy z{Uh~{SABCY)2>`dC~PL>S<zUyb`CZo>p!>HA^2&nbYJbn`Ev*>Sl;(*$TKCeZhA1E?f zB@yG5=_H(dKLgh*Thd-s*5>veN&v(J(1Dt%IJ0Ff6Mtay%|D?O9Vkb_AS`6Diz96W z8QLYUPsTgE87ad1MDAWyef%VnVeU)EY$o`nQR=M>oKAv#=XzUivldUTF$dEhA=*7o2IJ-Hdt3XKr4%95o*{NsT2Uv!e@}aESQmCbu zumpia2h~eh*TbZDSRcFgco4Bb+RmPFXhKdjtVAc)Pqa#<5${diF}4@pgf5hMd<@UD zjCcxITrtt%RRRP;19SvW-}O~kZ``^cw{dR*hz4(Kib65JVkI1}<%kc{j*($|4J$ES zVybm~yoPH#OMKYL z&U_ycBlT8?AEhm>p<%#1$i;1Mx~N1a7&$X;m+}}o97Qj!g9hB0+Yg-7A-LdQfP6&A z6cn4f8s$fxFrTGAnsIDy65HHA1d3h>p5ONWqHq)J4Qu$8R9EJqhRgi(dHBtrqFKiSVk72mIw*}NRJn_hT1a6^ z$d3x;Lls!ha1<$!bUM=nBYC;F%4M5NQugQYM3HR0n%f~D4jzs2F^7yo z{X=@3nhaVi^%7rf{s7A3_9P&Y57Rbtq)MGi7lUXsR0&9Kw}yhiC`Wx8*oOF&g`d-0 z!rBPpeG?chMS@4pgL^yz^Jy^5mXMQ2utU zWa_5FcvxY?UeHkWiTmea)&bf+vS5e83n24S^1M;y*5`;V43C7If_0DC=TGQ;Q*-~Y z8&z>NCEd+SHj>%bDl7pMp4#jjMRFoLO!-s%eT0*>O_|5Psx4$wrRpE%iL*hv4V0{I z2dpG1FCdc>!s^1<))BhPQbtCV9QYbtg^toH$>XK_Hqn_6;LfFk?vcbvkRsCl6k0T; z-eP1DNqEsveI&A~`i!AkeLi1iAvHCZuZ371Or86!3ppYy4Z7^ot$#w1V~oeG%*G6) zOji8nncjTSNq*x)F$&Av-UNjg(p)vtbp6lJjrDrLa=saW<`ggIjn&CN*sHgs{+*!q zbd*ncp_$R@UzVAjKqMC-Es5^fd){Db?4{ixzVbg`DWSms#RdhkO-Dq%|L56VBt zFV*AYz;L)yaCnL8OlERNH#p<;hehP@fmL)CK{QbiYgemwKO2PV*1UOgYBHN%IBBc+ z32oK4=oFF4@PnZ?Np3V`&;+V9y~ImB5TGWS>!Mk-ghVMP*$cZ`nm>hMywny-m`a1@ zMo5Sj<~&SQ6p7UogQ=Z^*%S@Qii0^j0DpB7FpRlpAbTdo7b!7kS@KPcj@6LrlN2vy z#fTc7QwDMs>v69@6|rFSAG|-&x=;(rh$rh%xcSW_^mS!&2)Yk#>;mZ(V9Yj(;4}Dx zZ!S^hr0!=^phZ*26&nR6k8LH86Qcq0dLkMM*`zX56==FBt2XY7CTgr`!GMi}Py>MN zCyis%!Y;aZj)H;msI=c&-l0!(WerEJZ&vGL+vC_3-RwsgXOR)=yP3ZxU7Z)W$M0axscM~WVR6z z;L$52W3E(Ka8Z?;WRpjUhVELOwo0PT{2>Vrd%{mIay0m2GUtT;B!L`axr#vP^GMGr6^h! z0=iaIk!+&e9CZ9QWJNZ2+&7YOw4wQ6`{?! zT3O3XVL|tBQ|qv`G_5SuK&IeLXSvW*I{#=OiKoXE_C#ZDZTcg(2HUxu{}+?>t>JB2`QibBIP77(i5mMAPwWof;Nx6^rLe+GTaAEz}Rr zFH@Nl)L{*PP<%m>fL$PUEFtT;meyr>g6CCC3Bh#g2O$ zyV&q|RmZTuht+ut4~mCV1EtBXa5V-Qwo;>D3@~00bL!71fE#X?!(Oyzt5_H-8fE5o zXJiT1AgKq+S|Qi0^f6)!weH=v6%NMhf- zte=tt+m<5A;Mfq7xTbkeZ3L>~W5p%mt7ml2_bOx<@@>Y4(B96IYf1w*j%XU%ZUjuK zR1z1lG*~mJJjxh$>qUWBq|{{o%5s%h+Pdp6e2tFR(Sef9WNAU68UU!e>PUyjCjG#}kQMzR;$uB^2dKe<0JXGm? zB_Anp8aYv}q^^7Js!LodCaL4#YlOnhL0whb*`7Kck4)KqTy-UD= z3cPCByw&NRUmE8-WyAx<#9OTL2+_Wu=%(DvBgo5~NTbr!E-Y@>UPEO+N;bc}n^Fl5 z*ex!Qe&eZ<-tzuinSd9MqkEMjh*aH{OtH1wB2>9GA3>C9nLG_&JgrdaxLHhszC8oh z4BUu#1^ZoESF%8>AUYd3`yuFR9#oB4IFCJNFv9g6e~$vz+Pt$su%Oeie!V01fT9Rl z5MA z3QaBY0K6I5LCHA!sB^k%ImuI5@in`Kj~7Ap=6N(h9s^_4W8XLdoT#%j-*(C|4Usm( zU=EL9+h$(DVWA=)YQx=;IgV~{kJE?Eg_Q~)$Yr}lZLP#lBW|^(v3mi>{Voj8Gl>4@ zxc`y^Q4344nhElkP3ov;AZaII^N;#JF}jZ;qreEj)f7dnhIvCnZL~|4`4Q;ytQ$)m zMXuUEE}`AME+!7C`#PU5lG6tPd>}&oe)GDU3{!Wiy_}I~uitV3XlJ4}Pk9(#56sJ5 zTd0Lc6;2oZ4t7b@CzQ@gHnDf%)qlBwX8j95V6BXAl1?uW=(qx{pcKss484suFo3wP zj^jQx&k{Gh5Ocd&te%6E?z{RJOiwR@6B_ph2{%xL3u{@__jrO{x|9Uo4rXTf2h`FP zqlGpepxPNJS-+GxB_F{LCRnLSA(@%k)(h%AY+ACP#q1M0ZL76P$m~!!?NiPAx6Te} zK?&anR&xwSq>guiI}Zpp{OXjkgQ~}Cgyn4rgNkrP*L7G2B#Jrr!KH4tyHfEr!(Wxb z%_S%NZBQ8^pzmM-#B->X&R*HdpMbpnIcazA6VUZr?NR8~_Hp-8TC^l)noLCd7I<;h z5$hn|#L6bhpajUlmO&%hdgXHD;*=ShZ;Z`Tk+u<~^(43BMT`}MX2wms28F2!1e?gg zy>!`xta_~0)&vl$_qI9$0?4VI&e6WNz+Fln;L);bwfXZ0N2vSKR`=h;W!l>Xi z%3Y9fst2{hG+D}2qenkFYkO)K4%4{mMiXTc4;?oYIyyP8bVO$|WgOOB_^u9NZKi2> zAJG8oCsQ|VXF#YMU10Bg4mICZc~%fQMrv8=XiqA^&p?Y7eXN-rJ`leSDMR=z`OGU7 z&M2@o+)`cAlY+Pq_7pcO7)O(}O7mO!5y>^mK`Vv}b+ors?C`K^urSv39EBshOm=7yk;2$F#*{2GUC6c{U%Kw~YgN=aq;7NlL$ zuu>`0i^4~9+2ILu1u*p`9e4^Y50SC7lZhZ*{Fbzzv})lBe?<}jj+dHReFdEZ>#OU8 zYt92}5QE|l@uE*zwB{{aj7E4EG6k(m^PXjLiD_|VBHOMa>5|za(vk1^?6lWb)y}u+ z3OWc;JMx?ive2^W49T)KeZZ@x3bc%(W>f?P<;O!t6%t;;IiYE>a5l%zbH-DRSV8W! zUk_?8;8Ca-QXi%7i>fK*Slc1Ao=63pD#Ng{!wBlP9}l;&CZ)rZZo?2Vrl_c4iNVh7 zFu5G=(;#OCE=kdGAcei1OB=2nlU8m{)~45qh;GA^;P9D&2%`xWXC-IzEZT*Za+8F> z3vTSp>tfW4d@p54L%v;!B1Hr{kBJ;ap`ZZg5aVLgU%F@FhUsqCSJeQfWR5oE%vEig zJ_%uR-MtZchIyU0NLkrc z$tk$RD8(hzjH#Rx|2*Fq0siH+dJV0U(SOtLP%i$XbE0Q*Gj{?rTWrdllmB7-j zr%ZewD+iy)w}Lb+a*CSGyq$szZUdGZE!$RHnd7oEH41TJ4@**B3IADqG002q0c@u>B1$<2fMP4+1c z`>VaC#w>;&#KxV)N#~@a8ofc|#AZhM=k_{&>G$>DMG}HrSBT4T_IN|`N@ZGfYL*1> z-@Z7dn48wly{^r7*6}}zXN2U-!*rfvU1NzC5D*HV{kkkXymw7hl4DXfo@upC1ZH6q zCiHx5SeAwrx{lfAnz8e=x3^{t7sKqh!QP%B36|YpCt9uNGZP63(d6`tgn4;ZhXD~@ zT&`Gqpwou0Dz@kzc8)jO`Ru>s`z$+XW-CuIs+RGeQ>y}rILBs-40mWpGZvBvjN z3D+p75gy+IRo$UrE)x9A`wSZ=b zl$NP!S_y*Un<#TX9yp^vEmS028|!3}pr5Wbxem+ZT30he4tMQs?;VpJN58B-Q~WIX zKw56*ZJt3iA;Jp%Xze<8STrS(9>IhHCTivT`(~qwJ6xoncy~n5(Q6b)QC=lmVHtZ_geM|5>mTzKf zJ8h8-{YEL{MXq|{XU20YIZBFp6y;F>>N_E|D8FZ@P1(HV+9np;?`CU!rX)$lm3~oL z#Fr%PABzawJa{M(a}h*a(@)??fiBa$amf2HKVk4l%BG8Z!e$HLeP|uB|e~{cpZj(3Kh|?-7}7lAAy1%jjOJzGMfR#lDXgkQ{x~cm)NI4``M)CF67SM{q25pT9aspePy57#p4-~mY0u(Vq^a!u{H;S);z&R= zbt=E_SKc6->gS3(7*mSd(dfd_hbsNXyO*a)fBQu9Z=gN}i~`gmR2+Q{V6siG!w!Oh zxBT%^eVqK+ptfQ#?en_Vr>X1tW8%ZY#}^#KkS7Ae*|DVw^LD>2Avr?B(}A_R=(M#X zzU5nWw{YsAqEMVQsM}Td^A))G|@p17PThz}9>y~Q8iuZmqYA6}~+ z6WT~6Nn!r2L;mIdpjqA2eRq1s&cS)yzoe@}tIWn8?x18& z;KE)0O;|?Z%V@6yAw{mf8(-~; zok)Iy=-0M+hM};%L34hCY(M=sb-jF?T{48B*@^LD_{Q-x2wXJH;%<&^9joy&n~ajG z&cb=a@8Rw^-{-|oab?eNVE2tWfBMoj#$(y?*y;=SwmwSYq$|#=st#Wt4z=Ssyq;rh zlX2{4+l5z!6^q!97f06$Av#}DT4S1 z98v|WBnaR8bI5EAW%XqrIWXVZ z=F~ux(5Vyo%C|gIa{*=w>uayFI%vnPSoIkybJaI{9=qT9$+dBL)cdKxk^^(&H}(8g zqX;4`5$^9k{_E8=2P@v$3g&(}l`bEVx>!4ZZr%Q8)!sVVVPWj>Yi{=Q89`-N1x(~{ z&YMdDKYUToZTtk@g#C+tD8DkscB1wxytYRRR=D+}*BrE8!V1XDk%82{pZT~(W~N8?*Va=czKbZTtn^=A{)>_Jtp9w=9NNK3sHrn$TO6{r z^<~+gEc_1V4;<6JMTkOA#&a_kI{43~qZWzCR=y0p|B8g4_tD$TO{n(2mNO`1f(aNQ zl4l2D_CmWZ1W9j_lEvZuTEnZd%GqP%_qtBv5_xIGJROBn|I4FQduw@^`fk$HHVd6h zQ{<*Ll>pr&$)-A5-;PsL_LLyiOx z{u9W=N$_lavYb5Qo*4gGg#h0Kf$RCd1lwOw@$?j#zcw7Mnui*G)(mNgZuI!3h0;eq zusWi{|4;*Ggl&AbUrX%&XOTL|5R)uLWNf_De`)CXc|eK3!_pP<8T)4Y4lW}5?R{F>7L^n?u--pnMI_sZ%E$QiXxgeFwV}6spmCECWN>NrmTrH0cX}@`0t@wZVsnVm_*vI>> z9wDR$D|3`;Z2&1Kd7?!}(-Lcdcs(|jCM}_KcT-ubbrhkCpvt0YEkls= zi^(Ch5Drsl`Njn>X@gX~&q(N%=%PnmR4bP9vzkUVZyJ5z6^EjIma8yT+s zJ?T;Z9`S-%?MW^%yF0q~M>5*rR43~OCrt801c0yD z1aB)tRTwh0^#{9;uvb~@yTUxC8R|_8+<<5Qv&`d6Ce5VJr@O>H8cl3B+8@yx2yJ_# zip=QvW`?sDho*-JN=Lh24at({h`RD&M)k08)W{~PZ#b0YBXvp?7AgCTa{f|LEPv+p zkq@WOnBFsi*=9tfUi}cSU1Ri@#<{!t4(T&-5Y_OJ!M$@|OTkszD>GD5KU1Cx=>vz{ z#OgV}GMW2FcZb-RmZ;8Rh2-AgEJrPsG0az2R(g+BKtzc9zr;#i3#gm0Tx;_B347D! z4-2cy^v%T|78c3Z9Y3x0TMA`o>*)-DE0Z@3<=7Fd#RdMC5nC2V-SSR>Y5Ryi`uU#` z&#&62JE9V+z-J2##hIu0$sAC%G_BE{4a}3NqDJaYf<}9%^UM z_jYL>PBt)W`nc9ir5Wm1U$294OxnLp{AtILoRSoR-hOc>nRJ+&9hH9AW@$wj>%@DBOt^RwEkEIDX3V3N)dk* zOcL4f)kO;X=Vi}@#SiOSR1Z{DI^mmcR15Za9@z^fE=u%o=vCZ>OZ1a+0L|1EaB^=_ z?AE_mlf{^>VD)oxX>klS+&?oeM!ny>hJkQbA)WPZ49eU?_e_tfu0gk1CxemG!ejti z2;FG=I(llxyq=R_0a9k-Z?Mn#(WUu#yV^>B76MNtjqd7#4xG&u4y{8iY}Yc0x!$%u z-FZED^SmkmpKNGSoEfePw26D>R!)WGmjU=aBzUd)fT3T>j}$>ba2S0<4N^&0yn#5KBxMkT)v6{nr$z!^YYD6 zzS)HxMDF4xyGi`o3FxFi{pu&1`}40?SB|e%=mU0;8S;=7JO9euVvk3&;*&Sy`8+b% ziAxgA%-JZt1LiYY6Q*l=I`!H&IRj>FK}^MaNyw=QqKNFaguOJkeej0ug$wJa4Mk-m z+Vg#!3!*PGmMuRTzxnZ(6%jD2U z#geMk#E>5EcGRL<`w~NP#LL$tzdl;-1vorv%1h%e=ce~3j;6g+z>V5F&#+*YUr-rX zD}E5bGJ-RW**#YiYsMwaN*|rtUqml>EvRZr&m;ZDXhvZi&rue)^2Cud8t-lyF?X~+8?Ws!(ftA5T z1Xrn}hz$s%;kb4Dv^mD)4OT4)8@^H=Z^$Z32B#Rpe3khnJyJ-&0T>d2I<^$GGmqS% zd+UWIuQ+a}l=Q_#3F<0!RDF)y=ygIQP@_ z(pBL&J}vvBr+C?DaZuOVvVvC~P|go>*iFg^06M+`PLe*_3bchnWCSz{!w^P@72^xJf9yeAE{FU2HdkeW*IrZs<^TjvMPC`xb|S>(7*n-^Q7|fwOH%@DUW*dP6J3pAIa$S`m0st4zHde^VdLa*+LPFZ@ zuNpMx#e{({9I3KLIdIgOu;%Y)cs+O00M>=Bd+s~s)F8GbHD;1Xg?!!r;-P$zy!0x$ zK)WnGHkvC;h(pL2;)@ z2u~fB@Ctv>54HbLRJJ^1d%ZrObQJghFZ zw#1IkMr%xJ=vh`^vbg94)Z63a-$ln)ozdwCeP_nJi)FT>TaLYTBqGc!q>oGHsXV-8 zsI7gLyHH@-z~Cou)cK2zxJ&JC@6Bi5BIQ(i#PaT)fpPz{WK73$p+kpXbpDX1uOdJ( zUkAB>(uU4z8HIGf1n#*Zr~RV9_odE`U&`?)M1uyyo*Hp+&&Sr+SEGjNMrLr}iS!|x zBVDL&B#tg)cNK8j&{c^}d6P6h%+VDpca+dXl`-kSkJoB8wX8ucJo1gsscLte2sZ^H zo9OoWxu+@im#Lhz523Uz#V^E3j|Of&8{X|S^i<{zt8_2R{Q`7Qc8_>L0EQhp8qB>)f? zsq9@(C5t`q$hrc~!^#gT-FZh&e4wZRvLG#!pzUEWb<+M8J*LEx5NIRMGg`lOXt zt>O)|CuRJk%OeiJA;nUnuAg_p86EE9flxWPVaIGZ=Mr(QFO8?HArYP#J1Yu~B`x9C4M3DUtUMh*c z@IS>Vr|n7$W@42@z`ywizFGeGP1~nrS#l-k!M_i}<2-5^K}U6*zpGAg%c{mCEBFIT z7ke1dUaba_O{VdTW&Tcv1rx!<0t^?so)H#g*)HSsBTR#y;Gw=N<7-AGF!L3EkNL-%Ueq&H zjrAu z!dCB~=rZd??K#87N(RE^Pz6%Bx1S|i0S5tzJbSR5`6n8-9} zc+EWObH6s=c3J2Oa3}p)Goo}!71HquRP! zj*>H}gz9m>$hZ76XJ9C*&Lz8sz2f3=lC)Lj#1O8$a*qU1Sm& z<)tfscLGI18EiS$7Dofb{a!@42_5Whx6`)0?QY6A^*%BqTygr(QI64qwKrWPzn#9j zpNg`sA`Iue@+NLThU*TlBSD|BP>I_m!Vn%6uLo6Bc?QCQpbWAD45qZ`2ofKwcM5}` zQ@S+-()UtzL?lNMi{&zO^*Dt|BqMl_l(*}Kh;@i7Wzg@R7u;gQJ3;g9RDG8|c->Uq z8P7@}=XFqfEH9HG_b+&1E*q?Sy+-JMFi~%z=l3Gnsb8XapAAFfV39EnZp=ugg$ZRp zib&tB76tdm19%E&FzxvT=Df~qe#rx%(AiXc3yb%FJt9;?0?%RAww5$Bsd(6VUnh3U5=s5BLxTymG9NN1&up|M?@7$=rgRB5s|C-mj4w9ds3IN ziY}yt4eUTF-;3b`0y~zkv)4OJnZ<~i%WZE=_^$SKmLhS|U=xi>- zANRH(R^}c#m?}we{-F}zB24VE5I@!(xHyMRVN6bjc~H3);zX4<{iTa-!i z*qxD4h1@HuyCe6Cv^nQ5YmGB4$r*r~ahHp~<#N);NKWY#l^;&|LRa{189r|LTlC2Q z6-MGPD&>?09HZk$)B!V?)CTG)BEM=956w#aDq4(xkMd7VKL8u|?0 zM@yexJWdvpNa>(ceGwmAp;`q3Bdrh$Z>2kX8&)0a%u+f!5Vo3|F# z9tNp8IV~sEDd@XMI(%j^*b3~^`O^4UU^2tyt%ZxCo_H{)8`4W@k-4?MM`4{w#mcqR zl{S^CMk_gQF$48!Zn*+0mCG6bR0T&&68)PUPm31z+Dz0&1%%Czw1R3vj=(&XLMj=| zdQGLvbgf~eA5L;N>aMX5;4D9p5n9}+>h0hOb0C9Ov<$(+M-tY5I2^g_&09ByN_V*^ z$-F{m8yFbmX-&|B^?=uUsp`1-f<^*cE9xF9pC&R$X)B$EYk3aNT^K0_%^AfF_eNHY z<<$wkeI}B!GBP<)k@7|+kx(~NVJcM6EbTBmuC3AD1RSbxxmlQCz~fQ%EW@6DJUot_ zCBPD3woAeuvH5}Vh@7l+z0M_%XSESXQT%z}Ct7ZBoOy4j*cy2hW;yIckQGm*P09Of zUwjONN=Y!Pu<9g#wsuWw@M*f7!We-b*s4UKnKgs@< z>mR{5HOTP^-pLa=u{pLW0rqjl+bT??BUO&LWRZX{(Zp?sOO5Q}^?KpxLpj-)tzXE>OuQbe9b33N>sP-N6*f;FRy z`(Re=HA!1i zj{{=Q=dQwcuvi-G7ypO@AD^;m6-?0lBYskiXRD<9_8WCyJp}~=9y`P~1ws3d*ST|A z(Rpg0h#{y`0_8GyJ}~HgG@_QD5SF6;N`w%n?TlyICEQeg=r;#4?!i?K>)+&b=|6rN zB^%6l3*3J($b*>!#g!VGoIj?s;&xEh)4ToTQCjo=;vinIYYQ%DQJ1UVN5YD?)#MbC zNw%r67=+iB0OclIudx@uw()8JjMNfEv3(`gjhvUAuwVU$$BIW*t`FZmZ=07`-k$6CY|+F%;iCjWn)Em z)ypi^-QXm}@!!+(n~Mv%dZ>@eXPrOA(?$(*wbV;uT1F~(7p^CHMJ+n3ld*0?pC`w7 zrlfZn${^(vURO2boHET7TJg%to3*=??I;=Fj$P+iRhR?BL?TOp@NRK?QZDl?uU2p! zR>qSQ+L&p{8i%+SshL8f`uUHzz?eK2{?7=Ol~1%%-ls!svSQwY1jUZMf|gVgnG+0C z8I_jRdjY#2xM<%vwoJ$@oE5zZAiZ({!{??%HCA3}Gi9DujudKZV#2Ur%uYPdY z$-WtAaj~hX4R*=(aB^}TmpG-IwiXh7Oi0R+i(9*~nX`O>2WFG5-?)9MN0wtc`YX3& z%CDMUUmA^(&z)xH7_-YHJWF{}KgIk$#Un$$Z(A6RSZA(bT;yFX%M z+6=x^LTGnV7D2jWzvS!Ek>+p^TAQxKVVFWCuFBgC5`n=sQ`sQ#Q zd4AL9O~$Vi>)hobnv zZ)(gW7^C8@*UHE+g3o&TA`?Px>9-hUn!)UutqL13Z;$&Zu~75 zwh-|4x9ns3X>YCp+0xy66@QPPRyAUqb_OpQi}K5sMzZPJQmJh&00$-#bW8awwTM~X zM91AM9%Z@3&y)0$eo5E!U zpRBB{$)+pW+~7@OCSnMR3~b=QWj~qn7O^hEmep>|(SI?@q87Ih5aY_s?8zGE&_l4! zFL6V(gv7U4Fr`RzLH-xBy&aA9?!X#Uxcs=a7GY_6s;U(oFkl?DR}{9QcC*wml8ZeIuDd%noXLQ^6iSjCCrytsmE`Wp5c{kbbEIgGtDo zn6}ua9MxTx*14ptp&xzUx1^@BF|-&V8#NWIr$^y#q4g9T=^kRHIdyfgk+b6Mm8-S;Q6@{U}!9MV4Tes=lM&8)^ll z?n!NN*OX@OX(UXRgI}b_V8+s4YDt&&3*50m${>_(;#a$qnqL+GUZ@xvHW?a*qy7v* z#ARM%`zV3^m`rSAyl*j`t#KQB4+yWiHPuGJQF64%_^tT&Y-(BdEd0{5<&S650>@@Ugkkp($-%kt**4KMo0JJ)f8aV+m7y z$Gm)m)BbFlnDNVj*0u4VbKXx6XPcTCteM~GauHdu~YRwn$ z@N=L?crfL5x#y-7|3vc`>Ad5hp1oG`*qu?}@jB3*=qdVPhmn$0pPH{7@>3H?@+AhlZAVRB;kzQcJ zq!$P0Y(LS6@{z}Q0p2OY(rd@EKj;+c){b?r{;iYgHfBm|JwnTl(cl8qT zuk!Ky)fxg_ifwqh)Hxgg$SGoYb`6H~2^0J4F9>q((d#q>6f}XAR?;lK#eJptPMp?Z0sgEYjeunUV8KI(JrftmIzi@EutLDB( zonEA3!VB4?N|v~^ZRNlzp^SHWpPntDtl{_Ek2;hV+#*cjQh1Z>cr+X_aFQaubPqKT z1&>(Ftv_>?=dD^=OQyadG5XZ=Nq`G;Vb>>TPMl zbdB35v)NR5f2NiDjlTMoHhF+hVFbvn;31^milZ8du#YMj=f|B)qX?2BmY&BqVn;dWx;5E3dMw^$ z$dQY@cxZ3yfJy}H<#!1_gqP)9AI9>I^Hzr z^zSEeq>#6dW%j(11EXgd8kJD~uYr})wYEjzGQ~)>4&*K=Thq&QP;!h8SX#?8ba>*n zKMs$~)(4tbn5ntlJ8h94ssx02gFw2Ak^ZQ+g5CL~jMBJ}MXiW6$Md)&E)NR+=ep z-$iYZ%AQU8p-QjKCUjridwKd)OoK)RZHVKCm7`>k^wd5VA2~v{4XO+x*k^s{TapR9 z=u?jJ``$m`Tawlj1mWw|d+oE~lNC8EAHrBeicgw*516Jj$eL5La+hnB^U%|DDeyoM zA-N`4lxu~o3LBFB`N4c~u+Gzqg<*Gb7&N@auYQJnFK#CVG6WYdCcpv!k zB#`vhs@wOMugpWZF<7S;*LetNG{^}X-Pz3c2QmGZvWI+tGaA}SiRvH4@zYS-mlH9?B_KF! zi)6=BW<9YlWm*+18>D#S2j$A9`j8jU__xU_pN2dl)&QC34C~xn=DfThULh6=Y>`7y z^L|KaIWY%$f-3oWNJiJPuQHs(DLu-k8M7P>9|s7P3u4Aw-=KS6-guj^JDQ*rlaR6t zOYe5Ec$T7RRHmUTp}j~vMrqnwN6Huaa*-x49rxId&9V*&%O&${8c||zHPKWPBT904 zIz26BeYsN^yl@jFc(JIcA5n=Kf1Dew2d9m|QP+vHN8ia2VqJYeB&Y7^8F8Gw8Qy@KHO39ORawkvL=``cl#aFzC4G1*8u`B(9uF<=!yS}2gu{s z_M^PJDa5R5)Nr2iv%%-@of?*H8|173CCWR4Ml^^x)NvKaJ>#9$Q_aUU+3(Jx&ys$k zji9QTWm&jO7(0`2M1v7GUc)8)VGRiz@wR?=s~umW@g@a@5thtFGUh&pyzI zZtX+k->`rfn!!s@%_<1_ew!GG{4F?a+3q3gdi`Mt=LDm!{lFX|PXXY85iMU(?Xi*B6-` zRZiFQxmU&3SH*{v^65z3LHedQ_$A@Re#0*7geZ$sV;$b^EcsXkObA_=NdNt)u@JI3 z9~xdwGwS&6A@jB6*2WW^a%fc|kwUE{YLfm*uGIbbnGpHb$`=alP~e$YD-muTbv zB+a#{4Yyp_0GcENr?aaB@*-JSlz5{jJyjUzK+Zexk;iQohVMjWN^cT70jOn@0}^Q@ zWtIIBlxHvd=bB~{J2wzs8g_M;%ij#jL-tau@JfHUrtZ;hU6}K zESiXaF}7}f8gMAUv0_FiRXJ3rfJQSQnIqd5E&vTtvaK6~j_n(rP;qNg(37imfMWb_ z=tMEGVmzLac-k#uQ9Dr|-@$7O<8-lJ{75`z@IApFAEsE{=hXRyga@7A&O{4JOnghFdN-4j8rX58wouj%ffiy_Hu>8AyR~>p11~cZj+mAF1Bf?+XbX z@*PvB*7r|{ZUAsAkw}a{OEm{<@ezMnkv++0sQH-^pPK_=>ZNAi9H`c%2r>Gx_IL>1 zJ;!-b=SzxJcrM5A@b-%#`4+f7gT;4E$cM6w&vN4Fb`9#U(mL$3mEF)@-^+C}A{E?O zL&wXt#L_|d2|ZEGAbzrY`l1c9T8!u=h5r2`8tlj4OX^;Ku3l%7^L||?z29n9GzG~{ zu%Ij@@x@ZvJ{Rr!kgQ$_In5w2&BxLeJSXA9A?vR{2&IX&HQLkr424>u=ljvVzOwwN z&VwaWiA}~ST0cx0BNtg=g0ck!TyJv&wJoY6BSFn2P8R~Z;tK&)@iZ3!5BbL(6B78? zW@B`ex-(*r&IEn7Bf~Iq^sQN9@{C#}p77$umCL)TJzGi^Z-M&UhwpEeEf2z8CY1Ov zYwiCha9p#P@B!_&Z2@xBB{y-(zP(hB`q<{^Lbcd(dan$N(tdsV5Iwx%*{~1ldbYpxEhg7} z%Msyp-9k~J!agbLxN?m!CY_nLMA1ic9}D}Yg2?B`u=aus`dhZH(gIt z;t>{KR9Wj;c_&dvao+Y-$EjkMKlUz-eOnyGu9R%)F@KSd*^ya9ngZ9vabc6fEw_}o z{}*R-V&W}t0+u^63WUwO>=cH_0-`=GpEI+lD$SRdypY7>I|Y39XDRh}Lv;b#1W4jo z;8*x)8`O4%T)+)4y(wH{v8&i+4JLe0mgx%*9Ya?4YFJ)VlTK4l4JxCGpA-oFRo8d# z?M6s*ErZOFj0}dRd~*48Uy`OCf3tpi8R5f++#QxIH@3dNH?sO*#9UAt()7cIZiLj* zsWjMK)3@*OjPVpVk6+AX78JBAyQv@-HBz-I=(Y&iRr|A{v}uQ1RL109CQQSzjy}nauJ& z+_l7rw)?onaX$*;5CsG@XtY;NM&s$dmOq7lbL{A=p`C!YPB$u5bH!3^>QnlXPg7~@ z?-o+_@wrRWE+v_`tuWpUpr{vaLG5ackPw{()}jnl*TT1R008Ru8m{zFcw6Du574hrlWc{Y0)}+G*t+ z`b<%m0+`do(2iYa@S$911*1I_4^wibYJJCSXmfFb?=&b$VRqLua5JP8O$ literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/sharing-layers.jpg b/docs/userguide/storagedriver/images/sharing-layers.jpg new file mode 100644 index 0000000000000000000000000000000000000000..e59fa833c99055df1588c265a275e10a0ca23c18 GIT binary patch literal 56036 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

!^Ml#f*B?ev;^+U`r;r_E)ocaQ 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 VOqbC#@ literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/two_dm_container.jpg b/docs/userguide/storagedriver/images/two_dm_container.jpg new file mode 100644 index 0000000000000000000000000000000000000000..18d840d0b053d898b236c6f4bd3e80ab14efb422 GIT binary patch literal 65447 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 DwU#> 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 literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/zfs_clones.jpg b/docs/userguide/storagedriver/images/zfs_clones.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0849aa2454ec03f921ab1f2a2c9e2d5c30700299 GIT binary patch literal 23027 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 OBtt3wBo7_Gll}+2jA70I literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/images/zfs_zpool.jpg b/docs/userguide/storagedriver/images/zfs_zpool.jpg new file mode 100644 index 0000000000000000000000000000000000000000..17ab2ace50d456aae6f506dbe933d937a379b846 GIT binary patch literal 30560 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

 + +## Image JSON Description + +Here is an example image JSON file: + +``` +{ + "id": "a9561eb1b190625c9adb5a9513e72c4dedafc1cb2d4c5236c9a6957ec7dfd5a9", + "parent": "c6e3cedcda2e3982a1a6760e178355e8e65f7b80e4e5248743fa3549d284e024", + "checksum": "tarsum.v1+sha256:e58fcf7418d2390dec8e8fb69d88c06ec07039d651fedc3aa72af9972e7d046b", + "created": "2014-10-13T21:19:18.674353812Z", + "author": "Alyssa P. Hacker <alyspdev@example.com>", + "architecture": "amd64", + "os": "linux", + "Size": 271828, + "config": { + "User": "alice", + "Memory": 2048, + "MemorySwap": 4096, + "CpuShares": 8, + "ExposedPorts": { + "8080/tcp": {} + }, + "Env": [ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", + "FOO=docker_is_a_really", + "BAR=great_tool_you_know" + ], + "Entrypoint": [ + "/bin/my-app-binary" + ], + "Cmd": [ + "--foreground", + "--config", + "/etc/my-app.d/default.cfg" + ], + "Volumes": { + "/var/job-result-data": {}, + "/var/log/my-app-logs": {}, + }, + "WorkingDir": "/home/alice", + } +} +``` + +### Image JSON Field Descriptions + +
+
+ id string +
+
+ Randomly generated, 256-bit, hexadecimal encoded. Uniquely identifies + the image. +
+
+ parent string +
+
+ ID of the parent image. If there is no parent image then this field + should be omitted. A collection of images may share many of the same + ancestor layers. This organizational structure is strictly a tree with + any one layer having either no parent or a single parent and zero or + more descendent layers. Cycles are not allowed and implementations + should be careful to avoid creating them or iterating through a cycle + indefinitely. +
+
+ created string +
+
+ ISO-8601 formatted combined date and time at which the image was + created. +
+
+ author string +
+
+ Gives the name and/or email address of the person or entity which + created and is responsible for maintaining the image. +
+
+ architecture string +
+
+ The CPU architecture which the binaries in this image are built to run + on. Possible values include: +
    +
  • 386
    • +
  • amd64
    • +
  • arm
    • +
+ More values may be supported in the future and any of these may or may + not be supported by a given container runtime implementation. +
+
+ os string +
+
+ The name of the operating system which the image is built to run on. + Possible values include: +
    +
  • darwin
    • +
  • freebsd
    • +
  • linux
    • +
+ More values may be supported in the future and any of these may or may + not be supported by a given container runtime implementation. +
+
+ checksum string +
+
+ Image Checksum of the filesystem changeset associated with the image + layer. +
+
+ Size integer +
+
+ The size in bytes of the filesystem changeset associated with the image + layer. +
+
+ config struct +
+
+ The execution parameters which should be used as a base when running a + container using the image. This field can be null, in + which case any execution parameters should be specified at creation of + the container. + +

Container RunConfig Field Descriptions

+ +
+
+ User string +
+
+

The username or UID which the process in the container should + run as. This acts as a default value to use when the value is + not specified when creating a container.

+ +

All of the following are valid:

+ +
    +
  • user
    • +
  • uid
    • +
  • user:group
    • +
  • uid:gid
    • +
  • uid:group
    • +
  • user:gid
    • +
+ +

If group/gid is not specified, the + default group and supplementary groups of the given + user/uid in /etc/passwd + from the container are applied.

+
+
+ Memory integer +
+
+ Memory limit (in bytes). This acts as a default value to use + when the value is not specified when creating a container. +
+
+ MemorySwap integer +
+
+ Total memory usage (memory + swap); set to -1 to + disable swap. This acts as a default value to use when the + value is not specified when creating a container. +
+
+ CpuShares integer +
+
+ CPU shares (relative weight vs. other containers). This acts as + a default value to use when the value is not specified when + creating a container. +
+
+ ExposedPorts struct +
+
+ A set of ports to expose from a container running this image. + This JSON structure value is unusual because it is a direct + JSON serialization of the Go type + map[string]struct{} and is represented in JSON as + an object mapping its keys to an empty object. Here is an + example: + +
{
+    "8080": {},
+    "53/udp": {},
+    "2356/tcp": {}
+}
+ + Its keys can be in the format of: +
    +
  • + "port/tcp" +
    • +
  • + "port/udp" +
    • +
  • + "port" +
    • +
+ with the default protocol being "tcp" if not + specified. + + These values act as defaults and are merged with any specified + when creating a container. +
+
+ Env array of strings +
+
+ Entries are in the format of VARNAME="var value". + These values act as defaults and are merged with any specified + when creating a container. +
+
+ Entrypoint array of strings +
+
+ A list of arguments to use as the command to execute when the + container starts. This value acts as a default and is replaced + by an entrypoint specified when creating a container. +
+
+ Cmd array of strings +
+
+ Default arguments to the entry point of the container. These + values act as defaults and are replaced with any specified when + creating a container. If an Entrypoint value is + not specified, then the first entry of the Cmd + array should be interpreted as the executable to run. +
+
+ Volumes struct +
+
+ A set of directories which should be created as data volumes in + a container running this image. This JSON structure value is + unusual because it is a direct JSON serialization of the Go + type map[string]struct{} and is represented in + JSON as an object mapping its keys to an empty object. Here is + an example: +
{
+    "/var/my-app-data/": {},
+    "/etc/some-config.d/": {},
+}
+
+
+ WorkingDir string +
+
+ Sets the current working directory of the entry point process + in the container. This value acts as a default and is replaced + by a working directory specified when creating a container. +
+
+
+
+ +Any extra fields in the Image JSON struct are considered implementation +specific and should be ignored by any implementations which are unable to +interpret them. + +## Creating an Image Filesystem Changeset + +An example of creating an Image Filesystem Changeset follows. + +An image root filesystem is first created as an empty directory named with the +ID of the image being created. Here is the initial empty directory structure +for the changeset for an image with ID `c3167915dc9d` ([real IDs are much +longer](#id_desc), but this example use a truncated one here for brevity. +Implementations need not name the rootfs directory in this way but it may be +convenient for keeping record of a large number of image layers.): + +``` +c3167915dc9d/ +``` + +Files and directories are then created: + +``` +c3167915dc9d/ + etc/ + my-app-config + bin/ + my-app-binary + my-app-tools +``` + +The `c3167915dc9d` directory is then committed as a plain Tar archive with +entries for the following files: + +``` +etc/my-app-config +bin/my-app-binary +bin/my-app-tools +``` + +The TarSum checksum for the archive file is then computed and placed in the +JSON metadata along with the execution parameters. + +To make changes to the filesystem of this container image, create a new +directory named with a new ID, such as `f60c56784b83`, and initialize it with +a snapshot of the parent image's root filesystem, so that the directory is +identical to that of `c3167915dc9d`. NOTE: a copy-on-write or union filesystem +can make this very efficient: + +``` +f60c56784b83/ + etc/ + my-app-config + bin/ + my-app-binary + my-app-tools +``` + +This example change is going add a configuration directory at `/etc/my-app.d` +which contains a default config file. There's also a change to the +`my-app-tools` binary to handle the config layout change. The `f60c56784b83` +directory then looks like this: + +``` +f60c56784b83/ + etc/ + my-app.d/ + default.cfg + bin/ + my-app-binary + my-app-tools +``` + +This reflects the removal of `/etc/my-app-config` and creation of a file and +directory at `/etc/my-app.d/default.cfg`. `/bin/my-app-tools` has also been +replaced with an updated version. Before committing this directory to a +changeset, because it has a parent image, it is first compared with the +directory tree of the parent snapshot, `f60c56784b83`, looking for files and +directories that have been added, modified, or removed. The following changeset +is found: + +``` +Added: /etc/my-app.d/default.cfg +Modified: /bin/my-app-tools +Deleted: /etc/my-app-config +``` + +A Tar Archive is then created which contains *only* this changeset: The added +and modified files and directories in their entirety, and for each deleted item +an entry for an empty file at the same location but with the basename of the +deleted file or directory prefixed with `.wh.`. The filenames prefixed with +`.wh.` are known as "whiteout" files. NOTE: For this reason, it is not possible +to create an image root filesystem which contains a file or directory with a +name beginning with `.wh.`. The resulting Tar archive for `f60c56784b83` has +the following entries: + +``` +/etc/my-app.d/default.cfg +/bin/my-app-tools +/etc/.wh.my-app-config +``` + +Any given image is likely to be composed of several of these Image Filesystem +Changeset tar archives. + +## Combined Image JSON + Filesystem Changeset Format + +There is also a format for a single archive which contains complete information +about an image, including: + + - repository names/tags + - all image layer JSON files + - all tar archives of each layer filesystem changesets + +For example, here's what the full archive of `library/busybox` is (displayed in +`tree` format): + +``` +. +├── 5785b62b697b99a5af6cd5d0aabc804d5748abbb6d3d07da5d1d3795f2dcc83e +│   ├── VERSION +│   ├── json +│   └── layer.tar +├── a7b8b41220991bfc754d7ad445ad27b7f272ab8b4a2c175b9512b97471d02a8a +│   ├── VERSION +│   ├── json +│   └── layer.tar +├── a936027c5ca8bf8f517923169a233e391cbb38469a75de8383b5228dc2d26ceb +│   ├── VERSION +│   ├── json +│   └── layer.tar +├── f60c56784b832dd990022afc120b8136ab3da9528094752ae13fe63a2d28dc8c +│   ├── VERSION +│   ├── json +│   └── layer.tar +└── repositories +``` + +There are one or more directories named with the ID for each layer in a full +image. Each of these directories contains 3 files: + + * `VERSION` - The schema version of the `json` file + * `json` - The JSON metadata for an image layer + * `layer.tar` - The Tar archive of the filesystem changeset for an image + layer. + +The content of the `VERSION` files is simply the semantic version of the JSON +metadata schema: + +``` +1.0 +``` + +And the `repositories` file is another JSON file which describes names/tags: + +``` +{ + "busybox":{ + "latest":"5785b62b697b99a5af6cd5d0aabc804d5748abbb6d3d07da5d1d3795f2dcc83e" + } +} +``` + +Every key in this object is the name of a repository, and maps to a collection +of tag suffixes. Each tag maps to the ID of the image represented by that tag. + +## Loading an Image Filesystem Changeset + +Unpacking a bundle of image layer JSON files and their corresponding filesystem +changesets can be done using a series of steps: + +1. Follow the parent IDs of image layers to find the root ancestor (an image +with no parent ID specified). +2. For every image layer, in order from root ancestor and descending down, +extract the contents of that layer's filesystem changeset archive into a +directory which will be used as the root of a container filesystem. + + - Extract all contents of each archive. + - Walk the directory tree once more, removing any files with the prefix + `.wh.` and the corresponding file or directory named without this prefix. + + +## Implementations + +This specification is an admittedly imperfect description of an +imperfectly-understood problem. The Docker project is, in turn, an attempt to +implement this specification. Our goal and our execution toward it will evolve +over time, but our primary concern in this specification and in our +implementation is compatibility and interoperability. diff --git a/integration-cli/check_test.go b/integration-cli/check_test.go new file mode 100644 index 0000000000..030b07f0e5 --- /dev/null +++ b/integration-cli/check_test.go @@ -0,0 +1,108 @@ +package main + +import ( + "fmt" + "testing" + + "github.com/docker/docker/pkg/reexec" + "github.com/go-check/check" +) + +func Test(t *testing.T) { + reexec.Init() // This is required for external graphdriver tests + + if !isLocalDaemon { + fmt.Println("INFO: Testing against a remote daemon") + } else { + fmt.Println("INFO: Testing against a local daemon") + } + + check.TestingT(t) +} + +func init() { + check.Suite(&DockerSuite{}) +} + +type DockerSuite struct { +} + +func (s *DockerSuite) TearDownTest(c *check.C) { + deleteAllContainers() + deleteAllImages() + deleteAllVolumes() + deleteAllNetworks() +} + +func init() { + check.Suite(&DockerRegistrySuite{ + ds: &DockerSuite{}, + }) +} + +type DockerRegistrySuite struct { + ds *DockerSuite + reg *testRegistryV2 + d *Daemon +} + +func (s *DockerRegistrySuite) SetUpTest(c *check.C) { + testRequires(c, DaemonIsLinux) + s.reg = setupRegistry(c) + s.d = NewDaemon(c) +} + +func (s *DockerRegistrySuite) TearDownTest(c *check.C) { + if s.reg != nil { + s.reg.Close() + } + if s.ds != nil { + s.ds.TearDownTest(c) + } + s.d.Stop() +} + +func init() { + check.Suite(&DockerDaemonSuite{ + ds: &DockerSuite{}, + }) +} + +type DockerDaemonSuite struct { + ds *DockerSuite + d *Daemon +} + +func (s *DockerDaemonSuite) SetUpTest(c *check.C) { + testRequires(c, DaemonIsLinux) + s.d = NewDaemon(c) +} + +func (s *DockerDaemonSuite) TearDownTest(c *check.C) { + testRequires(c, DaemonIsLinux) + s.d.Stop() + s.ds.TearDownTest(c) +} + +func init() { + check.Suite(&DockerTrustSuite{ + ds: &DockerSuite{}, + }) +} + +type DockerTrustSuite struct { + ds *DockerSuite + reg *testRegistryV2 + not *testNotary +} + +func (s *DockerTrustSuite) SetUpTest(c *check.C) { + s.reg = setupRegistry(c) + s.not = setupNotary(c) +} + +func (s *DockerTrustSuite) TearDownTest(c *check.C) { + s.reg.Close() + s.not.Close() + s.ds.TearDownTest(c) +} diff --git a/integration-cli/docker_api_attach_test.go b/integration-cli/docker_api_attach_test.go new file mode 100644 index 0000000000..d2ca4ba29d --- /dev/null +++ b/integration-cli/docker_api_attach_test.go @@ -0,0 +1,226 @@ +package main + +import ( + "bytes" + "io" + "net/http" + "net/http/httputil" + "strings" + "time" + + "github.com/go-check/check" + "golang.org/x/net/websocket" +) + +func (s *DockerSuite) TestGetContainersAttachWebsocket(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-dit", "busybox", "cat") + + rwc, err := sockConn(time.Duration(10 * time.Second)) + if err != nil { + c.Fatal(err) + } + + cleanedContainerID := strings.TrimSpace(out) + config, err := websocket.NewConfig( + "/containers/"+cleanedContainerID+"/attach/ws?stream=1&stdin=1&stdout=1&stderr=1", + "http://localhost", + ) + if err != nil { + c.Fatal(err) + } + + ws, err := websocket.NewClient(config, rwc) + if err != nil { + c.Fatal(err) + } + defer ws.Close() + + expected := []byte("hello") + actual := make([]byte, len(expected)) + + outChan := make(chan error) + go func() { + _, err := ws.Read(actual) + outChan <- err + close(outChan) + }() + + inChan := make(chan error) + go func() { + _, err := ws.Write(expected) + inChan <- err + close(inChan) + }() + + select { + case err := <-inChan: + if err != nil { + c.Fatal(err) + } + case <-time.After(5 * time.Second): + c.Fatal("Timeout writing to ws") + } + + select { + case err := <-outChan: + if err != nil { + c.Fatal(err) + } + case <-time.After(5 * time.Second): + c.Fatal("Timeout reading from ws") + } + + if !bytes.Equal(expected, actual) { + c.Fatal("Expected output on websocket to match input") + } +} + +// regression gh14320 +func (s *DockerSuite) TestPostContainersAttachContainerNotFound(c *check.C) { + status, body, err := sockRequest("POST", "/containers/doesnotexist/attach", nil) + c.Assert(status, check.Equals, http.StatusNotFound) + c.Assert(err, check.IsNil) + expected := "no such id: doesnotexist\n" + if !strings.Contains(string(body), expected) { + c.Fatalf("Expected response body to contain %q", expected) + } +} + +func (s *DockerSuite) TestGetContainersWsAttachContainerNotFound(c *check.C) { + status, body, err := sockRequest("GET", "/containers/doesnotexist/attach/ws", nil) + c.Assert(status, check.Equals, http.StatusNotFound) + c.Assert(err, check.IsNil) + expected := "no such id: doesnotexist\n" + if !strings.Contains(string(body), expected) { + c.Fatalf("Expected response body to contain %q", expected) + } +} + +func (s *DockerSuite) TestPostContainersAttach(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-dit", "busybox", "cat") + + r, w := io.Pipe() + defer r.Close() + defer w.Close() + + conn, err := sockConn(time.Duration(10 * time.Second)) + c.Assert(err, check.IsNil) + + containerID := strings.TrimSpace(out) + + req, err := http.NewRequest("POST", "/containers/"+containerID+"/attach?stream=1&stdin=1&stdout=1&stderr=1", bytes.NewReader([]byte{})) + c.Assert(err, check.IsNil) + + client := httputil.NewClientConn(conn, nil) + defer client.Close() + + // Do POST attach request + resp, err := client.Do(req) + c.Assert(resp.StatusCode, check.Equals, http.StatusOK) + // If we check the err, we get a ErrPersistEOF = &http.ProtocolError{ErrorString: "persistent connection closed"} + // This means that the remote requested this be the last request serviced, is this okay? + + // Test read and write to the attached container + expected := []byte("hello") + actual := make([]byte, len(expected)) + + outChan := make(chan error) + go func() { + _, err := r.Read(actual) + outChan <- err + close(outChan) + }() + + inChan := make(chan error) + go func() { + _, err := w.Write(expected) + inChan <- err + close(inChan) + }() + + select { + case err := <-inChan: + c.Assert(err, check.IsNil) + case <-time.After(5 * time.Second): + c.Fatal("Timeout writing to stdout") + } + + select { + case err := <-outChan: + c.Assert(err, check.IsNil) + case <-time.After(5 * time.Second): + c.Fatal("Timeout reading from stdin") + } + + if !bytes.Equal(expected, actual) { + c.Fatal("Expected output to match input") + } + + resp.Body.Close() +} + +func (s *DockerSuite) TestPostContainersAttachStderr(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-dit", "busybox", "/bin/sh", "-c", "cat >&2") + + r, w := io.Pipe() + defer r.Close() + defer w.Close() + + conn, err := sockConn(time.Duration(10 * time.Second)) + c.Assert(err, check.IsNil) + + containerID := strings.TrimSpace(out) + + req, err := http.NewRequest("POST", "/containers/"+containerID+"/attach?stream=1&stdin=1&stdout=1&stderr=1", bytes.NewReader([]byte{})) + c.Assert(err, check.IsNil) + + client := httputil.NewClientConn(conn, nil) + defer client.Close() + + // Do POST attach request + resp, err := client.Do(req) + c.Assert(resp.StatusCode, check.Equals, http.StatusOK) + // If we check the err, we get a ErrPersistEOF = &http.ProtocolError{ErrorString: "persistent connection closed"} + // This means that the remote requested this be the last request serviced, is this okay? + + // Test read and write to the attached container + expected := []byte("hello") + actual := make([]byte, len(expected)) + + outChan := make(chan error) + go func() { + _, err := r.Read(actual) + outChan <- err + close(outChan) + }() + + inChan := make(chan error) + go func() { + _, err := w.Write(expected) + inChan <- err + close(inChan) + }() + + select { + case err := <-inChan: + c.Assert(err, check.IsNil) + case <-time.After(5 * time.Second): + c.Fatal("Timeout writing to stdout") + } + + select { + case err := <-outChan: + c.Assert(err, check.IsNil) + case <-time.After(5 * time.Second): + c.Fatal("Timeout reading from stdin") + } + + if !bytes.Equal(expected, actual) { + c.Fatal("Expected output to match input") + } + + resp.Body.Close() +} diff --git a/integration-cli/docker_api_build_test.go b/integration-cli/docker_api_build_test.go new file mode 100644 index 0000000000..88f0631bcf --- /dev/null +++ b/integration-cli/docker_api_build_test.go @@ -0,0 +1,285 @@ +package main + +import ( + "archive/tar" + "bytes" + "net/http" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestBuildApiDockerfilePath(c *check.C) { + // Test to make sure we stop people from trying to leave the + // build context when specifying the path to the dockerfile + buffer := new(bytes.Buffer) + tw := tar.NewWriter(buffer) + defer tw.Close() + + dockerfile := []byte("FROM busybox") + if err := tw.WriteHeader(&tar.Header{ + Name: "Dockerfile", + Size: int64(len(dockerfile)), + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write(dockerfile); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + res, body, err := sockRequestRaw("POST", "/build?dockerfile=../Dockerfile", buffer, "application/x-tar") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + + out, err := readBody(body) + if err != nil { + c.Fatal(err) + } + + if !strings.Contains(string(out), "Forbidden path outside the build context") { + c.Fatalf("Didn't complain about leaving build context: %s", out) + } +} + +func (s *DockerSuite) TestBuildApiDockerFileRemote(c *check.C) { + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + server, err := fakeStorage(map[string]string{ + "testD": `FROM busybox +COPY * /tmp/ +RUN find / -name ba* +RUN find /tmp/`, + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + res, body, err := sockRequestRaw("POST", "/build?dockerfile=baz&remote="+server.URL()+"/testD", nil, "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + buf, err := readBody(body) + if err != nil { + c.Fatal(err) + } + + // Make sure Dockerfile exists. + // Make sure 'baz' doesn't exist ANYWHERE despite being mentioned in the URL + out := string(buf) + if !strings.Contains(out, "/tmp/Dockerfile") || + strings.Contains(out, "baz") { + c.Fatalf("Incorrect output: %s", out) + } +} + +func (s *DockerSuite) TestBuildApiRemoteTarballContext(c *check.C) { + testRequires(c, DaemonIsLinux) + buffer := new(bytes.Buffer) + tw := tar.NewWriter(buffer) + defer tw.Close() + + dockerfile := []byte("FROM busybox") + if err := tw.WriteHeader(&tar.Header{ + Name: "Dockerfile", + Size: int64(len(dockerfile)), + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write(dockerfile); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + server, err := fakeBinaryStorage(map[string]*bytes.Buffer{ + "testT.tar": buffer, + }) + c.Assert(err, check.IsNil) + + defer server.Close() + + res, b, err := sockRequestRaw("POST", "/build?remote="+server.URL()+"/testT.tar", nil, "application/tar") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + b.Close() +} + +func (s *DockerSuite) TestBuildApiRemoteTarballContextWithCustomDockerfile(c *check.C) { + testRequires(c, DaemonIsLinux) + buffer := new(bytes.Buffer) + tw := tar.NewWriter(buffer) + defer tw.Close() + + dockerfile := []byte(`FROM busybox +RUN echo 'wrong'`) + if err := tw.WriteHeader(&tar.Header{ + Name: "Dockerfile", + Size: int64(len(dockerfile)), + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write(dockerfile); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + + custom := []byte(`FROM busybox +RUN echo 'right' +`) + if err := tw.WriteHeader(&tar.Header{ + Name: "custom", + Size: int64(len(custom)), + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write(custom); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + server, err := fakeBinaryStorage(map[string]*bytes.Buffer{ + "testT.tar": buffer, + }) + c.Assert(err, check.IsNil) + + defer server.Close() + url := "/build?dockerfile=custom&remote=" + server.URL() + "/testT.tar" + res, body, err := sockRequestRaw("POST", url, nil, "application/tar") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + defer body.Close() + content, err := readBody(body) + c.Assert(err, check.IsNil) + + if strings.Contains(string(content), "wrong") { + c.Fatalf("Build used the wrong dockerfile.") + } +} + +func (s *DockerSuite) TestBuildApiLowerDockerfile(c *check.C) { + testRequires(c, DaemonIsLinux) + git, err := newFakeGit("repo", map[string]string{ + "dockerfile": `FROM busybox +RUN echo from dockerfile`, + }, false) + if err != nil { + c.Fatal(err) + } + defer git.Close() + + res, body, err := sockRequestRaw("POST", "/build?remote="+git.RepoURL, nil, "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + buf, err := readBody(body) + if err != nil { + c.Fatal(err) + } + + out := string(buf) + if !strings.Contains(out, "from dockerfile") { + c.Fatalf("Incorrect output: %s", out) + } +} + +func (s *DockerSuite) TestBuildApiBuildGitWithF(c *check.C) { + testRequires(c, DaemonIsLinux) + git, err := newFakeGit("repo", map[string]string{ + "baz": `FROM busybox +RUN echo from baz`, + "Dockerfile": `FROM busybox +RUN echo from Dockerfile`, + }, false) + if err != nil { + c.Fatal(err) + } + defer git.Close() + + // Make sure it tries to 'dockerfile' query param value + res, body, err := sockRequestRaw("POST", "/build?dockerfile=baz&remote="+git.RepoURL, nil, "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + buf, err := readBody(body) + if err != nil { + c.Fatal(err) + } + + out := string(buf) + if !strings.Contains(out, "from baz") { + c.Fatalf("Incorrect output: %s", out) + } +} + +func (s *DockerSuite) TestBuildApiDoubleDockerfile(c *check.C) { + testRequires(c, UnixCli) // dockerfile overwrites Dockerfile on Windows + git, err := newFakeGit("repo", map[string]string{ + "Dockerfile": `FROM busybox +RUN echo from Dockerfile`, + "dockerfile": `FROM busybox +RUN echo from dockerfile`, + }, false) + if err != nil { + c.Fatal(err) + } + defer git.Close() + + // Make sure it tries to 'dockerfile' query param value + res, body, err := sockRequestRaw("POST", "/build?remote="+git.RepoURL, nil, "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + buf, err := readBody(body) + if err != nil { + c.Fatal(err) + } + + out := string(buf) + if !strings.Contains(out, "from Dockerfile") { + c.Fatalf("Incorrect output: %s", out) + } +} + +func (s *DockerSuite) TestBuildApiDockerfileSymlink(c *check.C) { + // Test to make sure we stop people from trying to leave the + // build context when specifying a symlink as the path to the dockerfile + buffer := new(bytes.Buffer) + tw := tar.NewWriter(buffer) + defer tw.Close() + + if err := tw.WriteHeader(&tar.Header{ + Name: "Dockerfile", + Typeflag: tar.TypeSymlink, + Linkname: "/etc/passwd", + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + res, body, err := sockRequestRaw("POST", "/build", buffer, "application/x-tar") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + + out, err := readBody(body) + if err != nil { + c.Fatal(err) + } + + // The reason the error is "Cannot locate specified Dockerfile" is because + // in the builder, the symlink is resolved within the context, therefore + // Dockerfile -> /etc/passwd becomes etc/passwd from the context which is + // a nonexistent file. + if !strings.Contains(string(out), "Cannot locate specified Dockerfile: Dockerfile") { + c.Fatalf("Didn't complain about leaving build context: %s", out) + } +} diff --git a/integration-cli/docker_api_containers_test.go b/integration-cli/docker_api_containers_test.go new file mode 100644 index 0000000000..ae49803d1c --- /dev/null +++ b/integration-cli/docker_api_containers_test.go @@ -0,0 +1,1592 @@ +package main + +import ( + "archive/tar" + "bytes" + "encoding/json" + "fmt" + "io" + "net/http" + "net/http/httputil" + "net/url" + "os" + "strconv" + "strings" + "time" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/integration" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/runconfig" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestContainerApiGetAll(c *check.C) { + testRequires(c, DaemonIsLinux) + startCount, err := getContainerCount() + if err != nil { + c.Fatalf("Cannot query container count: %v", err) + } + + name := "getall" + dockerCmd(c, "run", "--name", name, "busybox", "true") + + status, body, err := sockRequest("GET", "/containers/json?all=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var inspectJSON []struct { + Names []string + } + if err = json.Unmarshal(body, &inspectJSON); err != nil { + c.Fatalf("unable to unmarshal response body: %v", err) + } + + if len(inspectJSON) != startCount+1 { + c.Fatalf("Expected %d container(s), %d found (started with: %d)", startCount+1, len(inspectJSON), startCount) + } + + if actual := inspectJSON[0].Names[0]; actual != "/"+name { + c.Fatalf("Container Name mismatch. Expected: %q, received: %q\n", "/"+name, actual) + } +} + +// regression test for empty json field being omitted #13691 +func (s *DockerSuite) TestContainerApiGetJSONNoFieldsOmitted(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "busybox", "true") + + status, body, err := sockRequest("GET", "/containers/json?all=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + // empty Labels field triggered this bug, make sense to check for everything + // cause even Ports for instance can trigger this bug + // better safe than sorry.. + fields := []string{ + "Id", + "Names", + "Image", + "Command", + "Created", + "Ports", + "Labels", + "Status", + } + + // decoding into types.Container do not work since it eventually unmarshal + // and empty field to an empty go map, so we just check for a string + for _, f := range fields { + if !strings.Contains(string(body), f) { + c.Fatalf("Field %s is missing and it shouldn't", f) + } + } +} + +type containerPs struct { + Names []string + Ports []map[string]interface{} +} + +// regression test for non-empty fields from #13901 +func (s *DockerSuite) TestContainerPsOmitFields(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "pstest" + port := 80 + dockerCmd(c, "run", "-d", "--name", name, "--expose", strconv.Itoa(port), "busybox", "top") + + status, body, err := sockRequest("GET", "/containers/json?all=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var resp []containerPs + err = json.Unmarshal(body, &resp) + c.Assert(err, check.IsNil) + + var foundContainer *containerPs + for _, container := range resp { + for _, testName := range container.Names { + if "/"+name == testName { + foundContainer = &container + break + } + } + } + + c.Assert(len(foundContainer.Ports), check.Equals, 1) + c.Assert(foundContainer.Ports[0]["PrivatePort"], check.Equals, float64(port)) + _, ok := foundContainer.Ports[0]["PublicPort"] + c.Assert(ok, check.Not(check.Equals), true) + _, ok = foundContainer.Ports[0]["IP"] + c.Assert(ok, check.Not(check.Equals), true) +} + +func (s *DockerSuite) TestContainerApiGetExport(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "exportcontainer" + dockerCmd(c, "run", "--name", name, "busybox", "touch", "/test") + + status, body, err := sockRequest("GET", "/containers/"+name+"/export", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + found := false + for tarReader := tar.NewReader(bytes.NewReader(body)); ; { + h, err := tarReader.Next() + if err != nil { + if err == io.EOF { + break + } + c.Fatal(err) + } + if h.Name == "test" { + found = true + break + } + } + + if !found { + c.Fatalf("The created test file has not been found in the exported image") + } +} + +func (s *DockerSuite) TestContainerApiGetChanges(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "changescontainer" + dockerCmd(c, "run", "--name", name, "busybox", "rm", "/etc/passwd") + + status, body, err := sockRequest("GET", "/containers/"+name+"/changes", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + changes := []struct { + Kind int + Path string + }{} + if err = json.Unmarshal(body, &changes); err != nil { + c.Fatalf("unable to unmarshal response body: %v", err) + } + + // Check the changelog for removal of /etc/passwd + success := false + for _, elem := range changes { + if elem.Path == "/etc/passwd" && elem.Kind == 2 { + success = true + } + } + if !success { + c.Fatalf("/etc/passwd has been removed but is not present in the diff") + } +} + +func (s *DockerSuite) TestContainerApiStartVolumeBinds(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testing" + config := map[string]interface{}{ + "Image": "busybox", + "Volumes": map[string]struct{}{"/tmp": {}}, + } + + status, _, err := sockRequest("POST", "/containers/create?name="+name, config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + bindPath := randomTmpDirPath("test", daemonPlatform) + config = map[string]interface{}{ + "Binds": []string{bindPath + ":/tmp"}, + } + status, _, err = sockRequest("POST", "/containers/"+name+"/start", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + pth, err := inspectMountSourceField(name, "/tmp") + if err != nil { + c.Fatal(err) + } + + if pth != bindPath { + c.Fatalf("expected volume host path to be %s, got %s", bindPath, pth) + } +} + +// Test for GH#10618 +func (s *DockerSuite) TestContainerApiStartDupVolumeBinds(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testdups" + config := map[string]interface{}{ + "Image": "busybox", + "Volumes": map[string]struct{}{"/tmp": {}}, + } + + status, _, err := sockRequest("POST", "/containers/create?name="+name, config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + bindPath1 := randomTmpDirPath("test1", daemonPlatform) + bindPath2 := randomTmpDirPath("test2", daemonPlatform) + + config = map[string]interface{}{ + "Binds": []string{bindPath1 + ":/tmp", bindPath2 + ":/tmp"}, + } + status, body, err := sockRequest("POST", "/containers/"+name+"/start", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + + if !strings.Contains(string(body), "Duplicate bind") { + c.Fatalf("Expected failure due to duplicate bind mounts to same path, instead got: %q with error: %v", string(body), err) + } +} + +func (s *DockerSuite) TestContainerApiStartVolumesFrom(c *check.C) { + testRequires(c, DaemonIsLinux) + volName := "voltst" + volPath := "/tmp" + + dockerCmd(c, "run", "-d", "--name", volName, "-v", volPath, "busybox") + + name := "TestContainerApiStartVolumesFrom" + config := map[string]interface{}{ + "Image": "busybox", + "Volumes": map[string]struct{}{volPath: {}}, + } + + status, _, err := sockRequest("POST", "/containers/create?name="+name, config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + config = map[string]interface{}{ + "VolumesFrom": []string{volName}, + } + status, _, err = sockRequest("POST", "/containers/"+name+"/start", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + pth, err := inspectMountSourceField(name, volPath) + if err != nil { + c.Fatal(err) + } + pth2, err := inspectMountSourceField(volName, volPath) + if err != nil { + c.Fatal(err) + } + + if pth != pth2 { + c.Fatalf("expected volume host path to be %s, got %s", pth, pth2) + } +} + +func (s *DockerSuite) TestGetContainerStats(c *check.C) { + testRequires(c, DaemonIsLinux) + var ( + name = "statscontainer" + ) + dockerCmd(c, "run", "-d", "--name", name, "busybox", "top") + + type b struct { + status int + body []byte + err error + } + bc := make(chan b, 1) + go func() { + status, body, err := sockRequest("GET", "/containers/"+name+"/stats", nil) + bc <- b{status, body, err} + }() + + // allow some time to stream the stats from the container + time.Sleep(4 * time.Second) + dockerCmd(c, "rm", "-f", name) + + // collect the results from the stats stream or timeout and fail + // if the stream was not disconnected. + select { + case <-time.After(2 * time.Second): + c.Fatal("stream was not closed after container was removed") + case sr := <-bc: + c.Assert(sr.err, check.IsNil) + c.Assert(sr.status, check.Equals, http.StatusOK) + + dec := json.NewDecoder(bytes.NewBuffer(sr.body)) + var s *types.Stats + // decode only one object from the stream + if err := dec.Decode(&s); err != nil { + c.Fatal(err) + } + } +} + +func (s *DockerSuite) TestGetContainerStatsRmRunning(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + + buf := &integration.ChannelBuffer{make(chan []byte, 1)} + defer buf.Close() + chErr := make(chan error) + go func() { + _, body, err := sockRequestRaw("GET", "/containers/"+id+"/stats?stream=1", nil, "application/json") + if err != nil { + chErr <- err + } + defer body.Close() + _, err = io.Copy(buf, body) + chErr <- err + }() + defer func() { + c.Assert(<-chErr, check.IsNil) + }() + + b := make([]byte, 32) + // make sure we've got some stats + _, err := buf.ReadTimeout(b, 2*time.Second) + c.Assert(err, check.IsNil) + + // Now remove without `-f` and make sure we are still pulling stats + _, _, err = dockerCmdWithError("rm", id) + c.Assert(err, check.Not(check.IsNil), check.Commentf("rm should have failed but didn't")) + _, err = buf.ReadTimeout(b, 2*time.Second) + c.Assert(err, check.IsNil) + dockerCmd(c, "rm", "-f", id) + + _, err = buf.ReadTimeout(b, 2*time.Second) + c.Assert(err, check.Not(check.IsNil)) +} + +// regression test for gh13421 +// previous test was just checking one stat entry so it didn't fail (stats with +// stream false always return one stat) +func (s *DockerSuite) TestGetContainerStatsStream(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "statscontainer" + dockerCmd(c, "run", "-d", "--name", name, "busybox", "top") + + type b struct { + status int + body []byte + err error + } + bc := make(chan b, 1) + go func() { + status, body, err := sockRequest("GET", "/containers/"+name+"/stats", nil) + bc <- b{status, body, err} + }() + + // allow some time to stream the stats from the container + time.Sleep(4 * time.Second) + dockerCmd(c, "rm", "-f", name) + + // collect the results from the stats stream or timeout and fail + // if the stream was not disconnected. + select { + case <-time.After(2 * time.Second): + c.Fatal("stream was not closed after container was removed") + case sr := <-bc: + c.Assert(sr.err, check.IsNil) + c.Assert(sr.status, check.Equals, http.StatusOK) + + s := string(sr.body) + // count occurrences of "read" of types.Stats + if l := strings.Count(s, "read"); l < 2 { + c.Fatalf("Expected more than one stat streamed, got %d", l) + } + } +} + +func (s *DockerSuite) TestGetContainerStatsNoStream(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "statscontainer" + dockerCmd(c, "run", "-d", "--name", name, "busybox", "top") + + type b struct { + status int + body []byte + err error + } + bc := make(chan b, 1) + go func() { + status, body, err := sockRequest("GET", "/containers/"+name+"/stats?stream=0", nil) + bc <- b{status, body, err} + }() + + // allow some time to stream the stats from the container + time.Sleep(4 * time.Second) + dockerCmd(c, "rm", "-f", name) + + // collect the results from the stats stream or timeout and fail + // if the stream was not disconnected. + select { + case <-time.After(2 * time.Second): + c.Fatal("stream was not closed after container was removed") + case sr := <-bc: + c.Assert(sr.err, check.IsNil) + c.Assert(sr.status, check.Equals, http.StatusOK) + + s := string(sr.body) + // count occurrences of "read" of types.Stats + if l := strings.Count(s, "read"); l != 1 { + c.Fatalf("Expected only one stat streamed, got %d", l) + } + } +} + +func (s *DockerSuite) TestGetStoppedContainerStats(c *check.C) { + testRequires(c, DaemonIsLinux) + // TODO: this test does nothing because we are c.Assert'ing in goroutine + var ( + name = "statscontainer" + ) + dockerCmd(c, "create", "--name", name, "busybox", "top") + + go func() { + // We'll never get return for GET stats from sockRequest as of now, + // just send request and see if panic or error would happen on daemon side. + status, _, err := sockRequest("GET", "/containers/"+name+"/stats", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + }() + + // allow some time to send request and let daemon deal with it + time.Sleep(1 * time.Second) +} + +// #9981 - Allow a docker created volume (ie, one in /var/lib/docker/volumes) to be used to overwrite (via passing in Binds on api start) an existing volume +func (s *DockerSuite) TestPostContainerBindNormalVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "create", "-v", "/foo", "--name=one", "busybox") + + fooDir, err := inspectMountSourceField("one", "/foo") + if err != nil { + c.Fatal(err) + } + + dockerCmd(c, "create", "-v", "/foo", "--name=two", "busybox") + + bindSpec := map[string][]string{"Binds": {fooDir + ":/foo"}} + status, _, err := sockRequest("POST", "/containers/two/start", bindSpec) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + fooDir2, err := inspectMountSourceField("two", "/foo") + if err != nil { + c.Fatal(err) + } + + if fooDir2 != fooDir { + c.Fatalf("expected volume path to be %s, got: %s", fooDir, fooDir2) + } +} + +func (s *DockerSuite) TestContainerApiPause(c *check.C) { + testRequires(c, DaemonIsLinux) + defer unpauseAllContainers() + out, _ := dockerCmd(c, "run", "-d", "busybox", "sleep", "30") + ContainerID := strings.TrimSpace(out) + + status, _, err := sockRequest("POST", "/containers/"+ContainerID+"/pause", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + pausedContainers, err := getSliceOfPausedContainers() + + if err != nil { + c.Fatalf("error thrown while checking if containers were paused: %v", err) + } + + if len(pausedContainers) != 1 || stringid.TruncateID(ContainerID) != pausedContainers[0] { + c.Fatalf("there should be one paused container and not %d", len(pausedContainers)) + } + + status, _, err = sockRequest("POST", "/containers/"+ContainerID+"/unpause", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + pausedContainers, err = getSliceOfPausedContainers() + + if err != nil { + c.Fatalf("error thrown while checking if containers were paused: %v", err) + } + + if pausedContainers != nil { + c.Fatalf("There should be no paused container.") + } +} + +func (s *DockerSuite) TestContainerApiTop(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "top") + id := strings.TrimSpace(string(out)) + c.Assert(waitRun(id), check.IsNil) + + type topResp struct { + Titles []string + Processes [][]string + } + var top topResp + status, b, err := sockRequest("GET", "/containers/"+id+"/top?ps_args=aux", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + if err := json.Unmarshal(b, &top); err != nil { + c.Fatal(err) + } + + if len(top.Titles) != 11 { + c.Fatalf("expected 11 titles, found %d: %v", len(top.Titles), top.Titles) + } + + if top.Titles[0] != "USER" || top.Titles[10] != "COMMAND" { + c.Fatalf("expected `USER` at `Titles[0]` and `COMMAND` at Titles[10]: %v", top.Titles) + } + if len(top.Processes) != 2 { + c.Fatalf("expected 2 processes, found %d: %v", len(top.Processes), top.Processes) + } + if top.Processes[0][10] != "/bin/sh -c top" { + c.Fatalf("expected `/bin/sh -c top`, found: %s", top.Processes[0][10]) + } + if top.Processes[1][10] != "top" { + c.Fatalf("expected `top`, found: %s", top.Processes[1][10]) + } +} + +func (s *DockerSuite) TestContainerApiCommit(c *check.C) { + testRequires(c, DaemonIsLinux) + cName := "testapicommit" + dockerCmd(c, "run", "--name="+cName, "busybox", "/bin/sh", "-c", "touch /test") + + name := "TestContainerApiCommit" + status, b, err := sockRequest("POST", "/commit?repo="+name+"&testtag=tag&container="+cName, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + type resp struct { + ID string + } + var img resp + if err := json.Unmarshal(b, &img); err != nil { + c.Fatal(err) + } + + cmd, err := inspectField(img.ID, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + if cmd != "{[/bin/sh -c touch /test]}" { + c.Fatalf("got wrong Cmd from commit: %q", cmd) + } + // sanity check, make sure the image is what we think it is + dockerCmd(c, "run", img.ID, "ls", "/test") +} + +func (s *DockerSuite) TestContainerApiCommitWithLabelInConfig(c *check.C) { + testRequires(c, DaemonIsLinux) + cName := "testapicommitwithconfig" + dockerCmd(c, "run", "--name="+cName, "busybox", "/bin/sh", "-c", "touch /test") + + config := map[string]interface{}{ + "Labels": map[string]string{"key1": "value1", "key2": "value2"}, + } + + name := "TestContainerApiCommitWithConfig" + status, b, err := sockRequest("POST", "/commit?repo="+name+"&container="+cName, config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + type resp struct { + ID string + } + var img resp + if err := json.Unmarshal(b, &img); err != nil { + c.Fatal(err) + } + + label1, err := inspectFieldMap(img.ID, "Config.Labels", "key1") + if err != nil { + c.Fatal(err) + } + c.Assert(label1, check.Equals, "value1") + + label2, err := inspectFieldMap(img.ID, "Config.Labels", "key2") + if err != nil { + c.Fatal(err) + } + c.Assert(label2, check.Equals, "value2") + + cmd, err := inspectField(img.ID, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + if cmd != "{[/bin/sh -c touch /test]}" { + c.Fatalf("got wrong Cmd from commit: %q", cmd) + } + + // sanity check, make sure the image is what we think it is + dockerCmd(c, "run", img.ID, "ls", "/test") +} + +func (s *DockerSuite) TestContainerApiBadPort(c *check.C) { + testRequires(c, DaemonIsLinux) + config := map[string]interface{}{ + "Image": "busybox", + "Cmd": []string{"/bin/sh", "-c", "echo test"}, + "PortBindings": map[string]interface{}{ + "8080/tcp": []map[string]interface{}{ + { + "HostIP": "", + "HostPort": "aa80", + }, + }, + }, + } + + jsonData := bytes.NewBuffer(nil) + json.NewEncoder(jsonData).Encode(config) + + status, b, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + + if strings.TrimSpace(string(b)) != `Invalid port specification: "aa80"` { + c.Fatalf("Incorrect error msg: %s", string(b)) + } +} + +func (s *DockerSuite) TestContainerApiCreate(c *check.C) { + testRequires(c, DaemonIsLinux) + config := map[string]interface{}{ + "Image": "busybox", + "Cmd": []string{"/bin/sh", "-c", "touch /test && ls /test"}, + } + + status, b, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + type createResp struct { + ID string + } + var container createResp + if err := json.Unmarshal(b, &container); err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "start", "-a", container.ID) + if strings.TrimSpace(out) != "/test" { + c.Fatalf("expected output `/test`, got %q", out) + } +} + +func (s *DockerSuite) TestContainerApiCreateEmptyConfig(c *check.C) { + config := map[string]interface{}{} + + status, b, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + + expected := "Config cannot be empty in order to create a container\n" + if body := string(b); body != expected { + c.Fatalf("Expected to get %q, got %q", expected, body) + } +} + +func (s *DockerSuite) TestContainerApiCreateWithHostName(c *check.C) { + testRequires(c, DaemonIsLinux) + hostName := "test-host" + config := map[string]interface{}{ + "Image": "busybox", + "Hostname": hostName, + } + + status, body, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + var container types.ContainerCreateResponse + if err := json.Unmarshal(body, &container); err != nil { + c.Fatal(err) + } + + status, body, err = sockRequest("GET", "/containers/"+container.ID+"/json", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var containerJSON types.ContainerJSON + if err := json.Unmarshal(body, &containerJSON); err != nil { + c.Fatal(err) + } + + if containerJSON.Config.Hostname != hostName { + c.Fatalf("Mismatched Hostname, Expected %s, Actual: %s ", hostName, containerJSON.Config.Hostname) + } +} + +func (s *DockerSuite) TestContainerApiCreateWithDomainName(c *check.C) { + testRequires(c, DaemonIsLinux) + domainName := "test-domain" + config := map[string]interface{}{ + "Image": "busybox", + "Domainname": domainName, + } + + status, body, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + var container types.ContainerCreateResponse + if err := json.Unmarshal(body, &container); err != nil { + c.Fatal(err) + } + + status, body, err = sockRequest("GET", "/containers/"+container.ID+"/json", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var containerJSON types.ContainerJSON + if err := json.Unmarshal(body, &containerJSON); err != nil { + c.Fatal(err) + } + + if containerJSON.Config.Domainname != domainName { + c.Fatalf("Mismatched Domainname, Expected %s, Actual: %s ", domainName, containerJSON.Config.Domainname) + } +} + +func (s *DockerSuite) TestContainerApiCreateNetworkMode(c *check.C) { + testRequires(c, DaemonIsLinux) + UtilCreateNetworkMode(c, "host") + UtilCreateNetworkMode(c, "bridge") + UtilCreateNetworkMode(c, "container:web1") +} + +func UtilCreateNetworkMode(c *check.C, networkMode string) { + config := map[string]interface{}{ + "Image": "busybox", + "HostConfig": map[string]interface{}{"NetworkMode": networkMode}, + } + + status, body, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + var container types.ContainerCreateResponse + if err := json.Unmarshal(body, &container); err != nil { + c.Fatal(err) + } + + status, body, err = sockRequest("GET", "/containers/"+container.ID+"/json", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var containerJSON types.ContainerJSON + if err := json.Unmarshal(body, &containerJSON); err != nil { + c.Fatal(err) + } + + if containerJSON.HostConfig.NetworkMode != runconfig.NetworkMode(networkMode) { + c.Fatalf("Mismatched NetworkMode, Expected %s, Actual: %s ", networkMode, containerJSON.HostConfig.NetworkMode) + } +} + +func (s *DockerSuite) TestContainerApiCreateWithCpuSharesCpuset(c *check.C) { + testRequires(c, DaemonIsLinux) + config := map[string]interface{}{ + "Image": "busybox", + "CpuShares": 512, + "CpusetCpus": "0,1", + } + + status, body, err := sockRequest("POST", "/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + var container types.ContainerCreateResponse + if err := json.Unmarshal(body, &container); err != nil { + c.Fatal(err) + } + + status, body, err = sockRequest("GET", "/containers/"+container.ID+"/json", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var containerJSON types.ContainerJSON + + c.Assert(json.Unmarshal(body, &containerJSON), check.IsNil) + + out, err := inspectField(containerJSON.ID, "HostConfig.CpuShares") + c.Assert(err, check.IsNil) + c.Assert(out, check.Equals, "512") + + outCpuset, errCpuset := inspectField(containerJSON.ID, "HostConfig.CpusetCpus") + c.Assert(errCpuset, check.IsNil, check.Commentf("Output: %s", outCpuset)) + c.Assert(outCpuset, check.Equals, "0,1") +} + +func (s *DockerSuite) TestContainerApiVerifyHeader(c *check.C) { + testRequires(c, DaemonIsLinux) + config := map[string]interface{}{ + "Image": "busybox", + } + + create := func(ct string) (*http.Response, io.ReadCloser, error) { + jsonData := bytes.NewBuffer(nil) + if err := json.NewEncoder(jsonData).Encode(config); err != nil { + c.Fatal(err) + } + return sockRequestRaw("POST", "/containers/create", jsonData, ct) + } + + // Try with no content-type + res, body, err := create("") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + body.Close() + + // Try with wrong content-type + res, body, err = create("application/xml") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + body.Close() + + // now application/json + res, body, err = create("application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusCreated) + body.Close() +} + +//Issue 14230. daemon should return 500 for invalid port syntax +func (s *DockerSuite) TestContainerApiInvalidPortSyntax(c *check.C) { + testRequires(c, DaemonIsLinux) + config := `{ + "Image": "busybox", + "HostConfig": { + "PortBindings": { + "19039;1230": [ + {} + ] + } + } + }` + + res, body, err := sockRequestRaw("POST", "/containers/create", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + + b, err := readBody(body) + if err != nil { + c.Fatal(err) + } + c.Assert(strings.Contains(string(b[:]), "Invalid port"), check.Equals, true) +} + +// Issue 7941 - test to make sure a "null" in JSON is just ignored. +// W/o this fix a null in JSON would be parsed into a string var as "null" +func (s *DockerSuite) TestContainerApiPostCreateNull(c *check.C) { + testRequires(c, DaemonIsLinux) + config := `{ + "Hostname":"", + "Domainname":"", + "Memory":0, + "MemorySwap":0, + "CpuShares":0, + "Cpuset":null, + "AttachStdin":true, + "AttachStdout":true, + "AttachStderr":true, + "ExposedPorts":{}, + "Tty":true, + "OpenStdin":true, + "StdinOnce":true, + "Env":[], + "Cmd":"ls", + "Image":"busybox", + "Volumes":{}, + "WorkingDir":"", + "Entrypoint":null, + "NetworkDisabled":false, + "OnBuild":null}` + + res, body, err := sockRequestRaw("POST", "/containers/create", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusCreated) + + b, err := readBody(body) + if err != nil { + c.Fatal(err) + } + type createResp struct { + ID string + } + var container createResp + if err := json.Unmarshal(b, &container); err != nil { + c.Fatal(err) + } + + out, err := inspectField(container.ID, "HostConfig.CpusetCpus") + if err != nil { + c.Fatal(err, out) + } + if out != "" { + c.Fatalf("expected empty string, got %q", out) + } + + outMemory, errMemory := inspectField(container.ID, "HostConfig.Memory") + c.Assert(outMemory, check.Equals, "0") + if errMemory != nil { + c.Fatal(errMemory, outMemory) + } + outMemorySwap, errMemorySwap := inspectField(container.ID, "HostConfig.MemorySwap") + c.Assert(outMemorySwap, check.Equals, "0") + if errMemorySwap != nil { + c.Fatal(errMemorySwap, outMemorySwap) + } +} + +func (s *DockerSuite) TestCreateWithTooLowMemoryLimit(c *check.C) { + testRequires(c, DaemonIsLinux) + config := `{ + "Image": "busybox", + "Cmd": "ls", + "OpenStdin": true, + "CpuShares": 100, + "Memory": 524287 + }` + + res, body, err := sockRequestRaw("POST", "/containers/create", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + b, err2 := readBody(body) + if err2 != nil { + c.Fatal(err2) + } + + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + c.Assert(strings.Contains(string(b), "Minimum memory limit allowed is 4MB"), check.Equals, true) +} + +func (s *DockerSuite) TestStartWithTooLowMemoryLimit(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "create", "busybox") + + containerID := strings.TrimSpace(out) + + config := `{ + "CpuShares": 100, + "Memory": 524287 + }` + + res, body, err := sockRequestRaw("POST", "/containers/"+containerID+"/start", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + b, err2 := readBody(body) + if err2 != nil { + c.Fatal(err2) + } + + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + c.Assert(strings.Contains(string(b), "Minimum memory limit allowed is 4MB"), check.Equals, true) +} + +func (s *DockerSuite) TestContainerApiRename(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--name", "TestContainerApiRename", "-d", "busybox", "sh") + + containerID := strings.TrimSpace(out) + newName := "TestContainerApiRenameNew" + statusCode, _, err := sockRequest("POST", "/containers/"+containerID+"/rename?name="+newName, nil) + c.Assert(err, check.IsNil) + // 204 No Content is expected, not 200 + c.Assert(statusCode, check.Equals, http.StatusNoContent) + + name, err := inspectField(containerID, "Name") + if name != "/"+newName { + c.Fatalf("Failed to rename container, expected %v, got %v. Container rename API failed", newName, name) + } +} + +func (s *DockerSuite) TestContainerApiKill(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-api-kill" + dockerCmd(c, "run", "-di", "--name", name, "busybox", "top") + + status, _, err := sockRequest("POST", "/containers/"+name+"/kill", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + state, err := inspectField(name, "State.Running") + if err != nil { + c.Fatal(err) + } + if state != "false" { + c.Fatalf("got wrong State from container %s: %q", name, state) + } +} + +func (s *DockerSuite) TestContainerApiRestart(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-api-restart" + dockerCmd(c, "run", "-di", "--name", name, "busybox", "top") + + status, _, err := sockRequest("POST", "/containers/"+name+"/restart?t=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + if err := waitInspect(name, "{{ .State.Restarting }} {{ .State.Running }}", "false true", 5*time.Second); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestContainerApiRestartNotimeoutParam(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-api-restart-no-timeout-param" + out, _ := dockerCmd(c, "run", "-di", "--name", name, "busybox", "top") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + status, _, err := sockRequest("POST", "/containers/"+name+"/restart", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + if err := waitInspect(name, "{{ .State.Restarting }} {{ .State.Running }}", "false true", 5*time.Second); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestContainerApiStart(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testing-start" + config := map[string]interface{}{ + "Image": "busybox", + "Cmd": []string{"/bin/sh", "-c", "/bin/top"}, + "OpenStdin": true, + } + + status, _, err := sockRequest("POST", "/containers/create?name="+name, config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + conf := make(map[string]interface{}) + status, _, err = sockRequest("POST", "/containers/"+name+"/start", conf) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + // second call to start should give 304 + status, _, err = sockRequest("POST", "/containers/"+name+"/start", conf) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotModified) +} + +func (s *DockerSuite) TestContainerApiStop(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-api-stop" + dockerCmd(c, "run", "-di", "--name", name, "busybox", "top") + + status, _, err := sockRequest("POST", "/containers/"+name+"/stop?t=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + if err := waitInspect(name, "{{ .State.Running }}", "false", 5*time.Second); err != nil { + c.Fatal(err) + } + + // second call to start should give 304 + status, _, err = sockRequest("POST", "/containers/"+name+"/stop?t=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotModified) +} + +func (s *DockerSuite) TestContainerApiWait(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-api-wait" + dockerCmd(c, "run", "--name", name, "busybox", "sleep", "5") + + status, body, err := sockRequest("POST", "/containers/"+name+"/wait", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + if err := waitInspect(name, "{{ .State.Running }}", "false", 5*time.Second); err != nil { + c.Fatal(err) + } + + var waitres types.ContainerWaitResponse + if err := json.Unmarshal(body, &waitres); err != nil { + c.Fatalf("unable to unmarshal response body: %v", err) + } + + if waitres.StatusCode != 0 { + c.Fatalf("Expected wait response StatusCode to be 0, got %d", waitres.StatusCode) + } +} + +func (s *DockerSuite) TestContainerApiCopy(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-container-api-copy" + dockerCmd(c, "run", "--name", name, "busybox", "touch", "/test.txt") + + postData := types.CopyConfig{ + Resource: "/test.txt", + } + + status, body, err := sockRequest("POST", "/containers/"+name+"/copy", postData) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + found := false + for tarReader := tar.NewReader(bytes.NewReader(body)); ; { + h, err := tarReader.Next() + if err != nil { + if err == io.EOF { + break + } + c.Fatal(err) + } + if h.Name == "test.txt" { + found = true + break + } + } + c.Assert(found, check.Equals, true) +} + +func (s *DockerSuite) TestContainerApiCopyResourcePathEmpty(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-container-api-copy-resource-empty" + dockerCmd(c, "run", "--name", name, "busybox", "touch", "/test.txt") + + postData := types.CopyConfig{ + Resource: "", + } + + status, body, err := sockRequest("POST", "/containers/"+name+"/copy", postData) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + c.Assert(string(body), check.Matches, "Path cannot be empty\n") +} + +func (s *DockerSuite) TestContainerApiCopyResourcePathNotFound(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-container-api-copy-resource-not-found" + dockerCmd(c, "run", "--name", name, "busybox") + + postData := types.CopyConfig{ + Resource: "/notexist", + } + + status, body, err := sockRequest("POST", "/containers/"+name+"/copy", postData) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + c.Assert(string(body), check.Matches, "Could not find the file /notexist in container "+name+"\n") +} + +func (s *DockerSuite) TestContainerApiCopyContainerNotFound(c *check.C) { + postData := types.CopyConfig{ + Resource: "/something", + } + + status, _, err := sockRequest("POST", "/containers/notexists/copy", postData) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) +} + +func (s *DockerSuite) TestContainerApiDelete(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + dockerCmd(c, "stop", id) + + status, _, err := sockRequest("DELETE", "/containers/"+id, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) +} + +func (s *DockerSuite) TestContainerApiDeleteNotExist(c *check.C) { + status, body, err := sockRequest("DELETE", "/containers/doesnotexist", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) + c.Assert(string(body), check.Matches, "no such id: doesnotexist\n") +} + +func (s *DockerSuite) TestContainerApiDeleteForce(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + status, _, err := sockRequest("DELETE", "/containers/"+id+"?force=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) +} + +func (s *DockerSuite) TestContainerApiDeleteRemoveLinks(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--name", "tlink1", "busybox", "top") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + out, _ = dockerCmd(c, "run", "--link", "tlink1:tlink1", "--name", "tlink2", "-d", "busybox", "top") + + id2 := strings.TrimSpace(out) + c.Assert(waitRun(id2), check.IsNil) + + links, err := inspectFieldJSON(id2, "HostConfig.Links") + c.Assert(err, check.IsNil) + + if links != "[\"/tlink1:/tlink2/tlink1\"]" { + c.Fatal("expected to have links between containers") + } + + status, _, err := sockRequest("DELETE", "/containers/tlink2/tlink1?link=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + linksPostRm, err := inspectFieldJSON(id2, "HostConfig.Links") + c.Assert(err, check.IsNil) + + if linksPostRm != "null" { + c.Fatal("call to api deleteContainer links should have removed the specified links") + } +} + +func (s *DockerSuite) TestContainerApiDeleteConflict(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + status, _, err := sockRequest("DELETE", "/containers/"+id, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusConflict) +} + +func (s *DockerSuite) TestContainerApiDeleteRemoveVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + out, _ := dockerCmd(c, "run", "-d", "-v", "/testvolume", "busybox", "top") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + source, err := inspectMountSourceField(id, "/testvolume") + _, err = os.Stat(source) + c.Assert(err, check.IsNil) + + status, _, err := sockRequest("DELETE", "/containers/"+id+"?v=1&force=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) + + if _, err := os.Stat(source); !os.IsNotExist(err) { + c.Fatalf("expected to get ErrNotExist error, got %v", err) + } +} + +// Regression test for https://github.com/docker/docker/issues/6231 +func (s *DockerSuite) TestContainersApiChunkedEncoding(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "create", "-v", "/foo", "busybox", "true") + id := strings.TrimSpace(out) + + conn, err := sockConn(time.Duration(10 * time.Second)) + if err != nil { + c.Fatal(err) + } + client := httputil.NewClientConn(conn, nil) + defer client.Close() + + bindCfg := strings.NewReader(`{"Binds": ["/tmp:/foo"]}`) + req, err := http.NewRequest("POST", "/containers/"+id+"/start", bindCfg) + if err != nil { + c.Fatal(err) + } + req.Header.Set("Content-Type", "application/json") + // This is a cheat to make the http request do chunked encoding + // Otherwise (just setting the Content-Encoding to chunked) net/http will overwrite + // https://golang.org/src/pkg/net/http/request.go?s=11980:12172 + req.ContentLength = -1 + + resp, err := client.Do(req) + if err != nil { + c.Fatalf("error starting container with chunked encoding: %v", err) + } + resp.Body.Close() + if resp.StatusCode != 204 { + c.Fatalf("expected status code 204, got %d", resp.StatusCode) + } + + out, err = inspectFieldJSON(id, "HostConfig.Binds") + if err != nil { + c.Fatal(err) + } + + var binds []string + if err := json.NewDecoder(strings.NewReader(out)).Decode(&binds); err != nil { + c.Fatal(err) + } + if len(binds) != 1 { + c.Fatalf("got unexpected binds: %v", binds) + } + + expected := "/tmp:/foo" + if binds[0] != expected { + c.Fatalf("got incorrect bind spec, wanted %s, got: %s", expected, binds[0]) + } +} + +func (s *DockerSuite) TestPostContainerStop(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + + containerID := strings.TrimSpace(out) + c.Assert(waitRun(containerID), check.IsNil) + + statusCode, _, err := sockRequest("POST", "/containers/"+containerID+"/stop", nil) + c.Assert(err, check.IsNil) + // 204 No Content is expected, not 200 + c.Assert(statusCode, check.Equals, http.StatusNoContent) + + if err := waitInspect(containerID, "{{ .State.Running }}", "false", 5*time.Second); err != nil { + c.Fatal(err) + } +} + +// #14170 +func (s *DockerSuite) TestPostContainersCreateWithStringOrSliceEntrypoint(c *check.C) { + testRequires(c, DaemonIsLinux) + config := struct { + Image string + Entrypoint string + Cmd []string + }{"busybox", "echo", []string{"hello", "world"}} + _, _, err := sockRequest("POST", "/containers/create?name=echotest", config) + c.Assert(err, check.IsNil) + out, _ := dockerCmd(c, "start", "-a", "echotest") + c.Assert(strings.TrimSpace(out), check.Equals, "hello world") + + config2 := struct { + Image string + Entrypoint []string + Cmd []string + }{"busybox", []string{"echo"}, []string{"hello", "world"}} + _, _, err = sockRequest("POST", "/containers/create?name=echotest2", config2) + c.Assert(err, check.IsNil) + out, _ = dockerCmd(c, "start", "-a", "echotest2") + c.Assert(strings.TrimSpace(out), check.Equals, "hello world") +} + +// #14170 +func (s *DockerSuite) TestPostContainersCreateWithStringOrSliceCmd(c *check.C) { + testRequires(c, DaemonIsLinux) + config := struct { + Image string + Entrypoint string + Cmd string + }{"busybox", "echo", "hello world"} + _, _, err := sockRequest("POST", "/containers/create?name=echotest", config) + c.Assert(err, check.IsNil) + out, _ := dockerCmd(c, "start", "-a", "echotest") + c.Assert(strings.TrimSpace(out), check.Equals, "hello world") + + config2 := struct { + Image string + Cmd []string + }{"busybox", []string{"echo", "hello", "world"}} + _, _, err = sockRequest("POST", "/containers/create?name=echotest2", config2) + c.Assert(err, check.IsNil) + out, _ = dockerCmd(c, "start", "-a", "echotest2") + c.Assert(strings.TrimSpace(out), check.Equals, "hello world") +} + +// regression #14318 +func (s *DockerSuite) TestPostContainersCreateWithStringOrSliceCapAddDrop(c *check.C) { + testRequires(c, DaemonIsLinux) + config := struct { + Image string + CapAdd string + CapDrop string + }{"busybox", "NET_ADMIN", "SYS_ADMIN"} + status, _, err := sockRequest("POST", "/containers/create?name=capaddtest0", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) + + config2 := struct { + Image string + CapAdd []string + CapDrop []string + }{"busybox", []string{"NET_ADMIN", "SYS_ADMIN"}, []string{"SETGID"}} + status, _, err = sockRequest("POST", "/containers/create?name=capaddtest1", config2) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) +} + +// #14640 +func (s *DockerSuite) TestPostContainersStartWithoutLinksInHostConfig(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-host-config-links" + dockerCmd(c, "create", "--name", name, "busybox", "top") + + hc, err := inspectFieldJSON(name, "HostConfig") + c.Assert(err, check.IsNil) + config := `{"HostConfig":` + hc + `}` + + res, b, err := sockRequestRaw("POST", "/containers/"+name+"/start", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusNoContent) + b.Close() +} + +// #14640 +func (s *DockerSuite) TestPostContainersStartWithLinksInHostConfig(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-host-config-links" + dockerCmd(c, "run", "--name", "foo", "-d", "busybox", "top") + dockerCmd(c, "create", "--name", name, "--link", "foo:bar", "busybox", "top") + + hc, err := inspectFieldJSON(name, "HostConfig") + c.Assert(err, check.IsNil) + config := `{"HostConfig":` + hc + `}` + + res, b, err := sockRequestRaw("POST", "/containers/"+name+"/start", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusNoContent) + b.Close() +} + +// #14640 +func (s *DockerSuite) TestPostContainersStartWithLinksInHostConfigIdLinked(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-host-config-links" + out, _ := dockerCmd(c, "run", "--name", "link0", "-d", "busybox", "top") + id := strings.TrimSpace(out) + dockerCmd(c, "create", "--name", name, "--link", id, "busybox", "top") + + hc, err := inspectFieldJSON(name, "HostConfig") + c.Assert(err, check.IsNil) + config := `{"HostConfig":` + hc + `}` + + res, b, err := sockRequestRaw("POST", "/containers/"+name+"/start", strings.NewReader(config), "application/json") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusNoContent) + b.Close() +} + +// #14915 +func (s *DockerSuite) TestContainersApiCreateNoHostConfig118(c *check.C) { + testRequires(c, DaemonIsLinux) + config := struct { + Image string + }{"busybox"} + status, _, err := sockRequest("POST", "/v1.18/containers/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated) +} + +// Ensure an error occurs when you have a container read-only rootfs but you +// extract an archive to a symlink in a writable volume which points to a +// directory outside of the volume. +func (s *DockerSuite) TestPutContainerArchiveErrSymlinkInVolumeToReadOnlyRootfs(c *check.C) { + // Requires local volume mount bind. + // --read-only + userns has remount issues + testRequires(c, SameHostDaemon, NotUserNamespace) + + testVol := getTestDir(c, "test-put-container-archive-err-symlink-in-volume-to-read-only-rootfs-") + defer os.RemoveAll(testVol) + + makeTestContentInDir(c, testVol) + + cID := makeTestContainer(c, testContainerOptions{ + readOnly: true, + volumes: defaultVolumes(testVol), // Our bind mount is at /vol2 + }) + defer deleteContainer(cID) + + // Attempt to extract to a symlink in the volume which points to a + // directory outside the volume. This should cause an error because the + // rootfs is read-only. + query := make(url.Values, 1) + query.Set("path", "/vol2/symlinkToAbsDir") + urlPath := fmt.Sprintf("/v1.20/containers/%s/archive?%s", cID, query.Encode()) + + statusCode, body, err := sockRequest("PUT", urlPath, nil) + c.Assert(err, check.IsNil) + + if !isCpCannotCopyReadOnly(fmt.Errorf(string(body))) { + c.Fatalf("expected ErrContainerRootfsReadonly error, but got %d: %s", statusCode, string(body)) + } +} + +func (s *DockerSuite) TestContainersApiGetContainersJSONEmpty(c *check.C) { + testRequires(c, DaemonIsLinux) + + status, body, err := sockRequest("GET", "/containers/json?all=1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + if string(body) != "[]\n" { + c.Fatalf("Expected empty response to be `[]`, got %q", string(body)) + } +} + +func (s *DockerSuite) TestPostContainersCreateWithWrongCpusetValues(c *check.C) { + testRequires(c, DaemonIsLinux) + + c1 := struct { + Image string + CpusetCpus string + }{"busybox", "1-42,,"} + name := "wrong-cpuset-cpus" + status, body, err := sockRequest("POST", "/containers/create?name="+name, c1) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + expected := "Invalid value 1-42,, for cpuset cpus.\n" + c.Assert(string(body), check.Equals, expected, check.Commentf("Expected output to contain %q, got %q", expected, string(body))) + + c2 := struct { + Image string + CpusetMems string + }{"busybox", "42-3,1--"} + name = "wrong-cpuset-mems" + status, body, err = sockRequest("POST", "/containers/create?name="+name, c2) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + expected = "Invalid value 42-3,1-- for cpuset mems.\n" + c.Assert(string(body), check.Equals, expected, check.Commentf("Expected output to contain %q, got %q", expected, string(body))) +} + +// #9981 - Allow a docker created volume (ie, one in /var/lib/docker/volumes) to be used to overwrite (via passing in Binds on api start) an existing volume +func TestPostContainerBindNormalVolume(t *testing.T) { + defer deleteAllContainers() + + out, _, err := runCommandWithOutput(exec.Command(dockerBinary, "create", "-v", "/foo", "--name=one", "busybox")) + if err != nil { + t.Fatal(err, out) + } + + fooDir, err := inspectFieldMap("one", "Volumes", "/foo") + if err != nil { + t.Fatal(err) + } + + out, _, err = runCommandWithOutput(exec.Command(dockerBinary, "create", "-v", "/foo", "--name=two", "busybox")) + if err != nil { + t.Fatal(err, out) + } + + bindSpec := map[string][]string{"Binds": {fooDir + ":/foo"}} + _, err = sockRequest("POST", "/containers/two/start", bindSpec) + if err != nil && !strings.Contains(err.Error(), "204 No Content") { + t.Fatal(err) + } + + fooDir2, err := inspectFieldMap("two", "Volumes", "/foo") + if err != nil { + t.Fatal(err) + } + + if fooDir2 != fooDir { + t.Fatal("expected volume path to be %s, got: %s", fooDir, fooDir2) + } + + logDone("container REST API - can use path from normal volume as bind-mount to overwrite another volume") +} diff --git a/integration-cli/docker_api_create_test.go b/integration-cli/docker_api_create_test.go new file mode 100644 index 0000000000..96e4dc3689 --- /dev/null +++ b/integration-cli/docker_api_create_test.go @@ -0,0 +1,38 @@ +package main + +import ( + "net/http" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestApiCreateWithNotExistImage(c *check.C) { + name := "test" + config := map[string]interface{}{ + "Image": "test456:v1", + "Volumes": map[string]struct{}{"/tmp": {}}, + } + + status, resp, err := sockRequest("POST", "/containers/create?name="+name, config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) + expected := "No such image: test456:v1" + if !strings.Contains(string(resp), expected) { + c.Fatalf("expected: %s, got: %s", expected, string(resp)) + } + + config2 := map[string]interface{}{ + "Image": "test456", + "Volumes": map[string]struct{}{"/tmp": {}}, + } + + status, resp, err = sockRequest("POST", "/containers/create?name="+name, config2) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) + expected = "No such image: test456:latest" + if !strings.Contains(string(resp), expected) { + c.Fatalf("expected: %s, got: %s", expected, string(resp)) + } + +} diff --git a/integration-cli/docker_api_events_test.go b/integration-cli/docker_api_events_test.go new file mode 100644 index 0000000000..8ae7bf737f --- /dev/null +++ b/integration-cli/docker_api_events_test.go @@ -0,0 +1,29 @@ +package main + +import ( + "net/http" + "time" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestEventsApiEmptyOutput(c *check.C) { + type apiResp struct { + resp *http.Response + err error + } + chResp := make(chan *apiResp) + go func() { + resp, body, err := sockRequestRaw("GET", "/events", nil, "") + body.Close() + chResp <- &apiResp{resp, err} + }() + + select { + case r := <-chResp: + c.Assert(r.err, check.IsNil) + c.Assert(r.resp.StatusCode, check.Equals, http.StatusOK) + case <-time.After(3 * time.Second): + c.Fatal("timeout waiting for events api to respond, should have responded immediately") + } +} diff --git a/integration-cli/docker_api_exec_resize_test.go b/integration-cli/docker_api_exec_resize_test.go new file mode 100644 index 0000000000..29fc266a04 --- /dev/null +++ b/integration-cli/docker_api_exec_resize_test.go @@ -0,0 +1,105 @@ +package main + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "net/http" + "strings" + "sync" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestExecResizeApiHeightWidthNoInt(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + endpoint := "/exec/" + cleanedContainerID + "/resize?h=foo&w=bar" + status, _, err := sockRequest("POST", endpoint, nil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + c.Assert(err, check.IsNil) +} + +// Part of #14845 +func (s *DockerSuite) TestExecResizeImmediatelyAfterExecStart(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver) + + name := "exec_resize_test" + dockerCmd(c, "run", "-d", "-i", "-t", "--name", name, "--restart", "always", "busybox", "/bin/sh") + + testExecResize := func() error { + data := map[string]interface{}{ + "AttachStdin": true, + "Cmd": []string{"/bin/sh"}, + } + uri := fmt.Sprintf("/containers/%s/exec", name) + status, body, err := sockRequest("POST", uri, data) + if err != nil { + return err + } + if status != http.StatusCreated { + return fmt.Errorf("POST %s is expected to return %d, got %d", uri, http.StatusCreated, status) + } + + out := map[string]string{} + err = json.Unmarshal(body, &out) + if err != nil { + return fmt.Errorf("ExecCreate returned invalid json. Error: %q", err.Error()) + } + + execID := out["Id"] + if len(execID) < 1 { + return fmt.Errorf("ExecCreate got invalid execID") + } + + payload := bytes.NewBufferString(`{"Tty":true}`) + conn, _, err := sockRequestHijack("POST", fmt.Sprintf("/exec/%s/start", execID), payload, "application/json") + if err != nil { + return fmt.Errorf("Failed to start the exec: %q", err.Error()) + } + defer conn.Close() + + _, rc, err := sockRequestRaw("POST", fmt.Sprintf("/exec/%s/resize?h=24&w=80", execID), nil, "text/plain") + // It's probably a panic of the daemon if io.ErrUnexpectedEOF is returned. + if err == io.ErrUnexpectedEOF { + return fmt.Errorf("The daemon might have crashed.") + } + + if err == nil { + rc.Close() + } + + // We only interested in the io.ErrUnexpectedEOF error, so we return nil otherwise. + return nil + } + + // The panic happens when daemon.ContainerExecStart is called but the + // container.Exec is not called. + // Because the panic is not 100% reproducible, we send the requests concurrently + // to increase the probability that the problem is triggered. + var ( + n = 10 + ch = make(chan error, n) + wg sync.WaitGroup + ) + for i := 0; i < n; i++ { + wg.Add(1) + go func() { + defer wg.Done() + if err := testExecResize(); err != nil { + ch <- err + } + }() + } + + wg.Wait() + select { + case err := <-ch: + c.Fatal(err.Error()) + default: + } +} diff --git a/integration-cli/docker_api_exec_test.go b/integration-cli/docker_api_exec_test.go new file mode 100644 index 0000000000..cecbd76f2f --- /dev/null +++ b/integration-cli/docker_api_exec_test.go @@ -0,0 +1,91 @@ +// +build !test_no_exec + +package main + +import ( + "bytes" + "encoding/json" + "fmt" + "net/http" + "strings" + + "github.com/go-check/check" +) + +// Regression test for #9414 +func (s *DockerSuite) TestExecApiCreateNoCmd(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "exec_test" + dockerCmd(c, "run", "-d", "-t", "--name", name, "busybox", "/bin/sh") + + status, body, err := sockRequest("POST", fmt.Sprintf("/containers/%s/exec", name), map[string]interface{}{"Cmd": nil}) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + + if !bytes.Contains(body, []byte("No exec command specified")) { + c.Fatalf("Expected message when creating exec command with no Cmd specified") + } +} + +func (s *DockerSuite) TestExecApiCreateNoValidContentType(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "exec_test" + dockerCmd(c, "run", "-d", "-t", "--name", name, "busybox", "/bin/sh") + + jsonData := bytes.NewBuffer(nil) + if err := json.NewEncoder(jsonData).Encode(map[string]interface{}{"Cmd": nil}); err != nil { + c.Fatalf("Can not encode data to json %s", err) + } + + res, body, err := sockRequestRaw("POST", fmt.Sprintf("/containers/%s/exec", name), jsonData, "text/plain") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusInternalServerError) + + b, err := readBody(body) + c.Assert(err, check.IsNil) + + if !bytes.Contains(b, []byte("Content-Type specified")) { + c.Fatalf("Expected message when creating exec command with invalid Content-Type specified") + } +} + +func (s *DockerSuite) TestExecAPIStart(c *check.C) { + dockerCmd(c, "run", "-d", "--name", "test", "busybox", "top") + + createExec := func() string { + _, b, err := sockRequest("POST", fmt.Sprintf("/containers/%s/exec", "test"), map[string]interface{}{"Cmd": []string{"true"}}) + c.Assert(err, check.IsNil, check.Commentf(string(b))) + + createResp := struct { + ID string `json:"Id"` + }{} + c.Assert(json.Unmarshal(b, &createResp), check.IsNil, check.Commentf(string(b))) + return createResp.ID + } + + startExec := func(id string, code int) { + resp, body, err := sockRequestRaw("POST", fmt.Sprintf("/exec/%s/start", id), strings.NewReader(`{"Detach": true}`), "application/json") + c.Assert(err, check.IsNil) + + b, err := readBody(body) + c.Assert(err, check.IsNil, check.Commentf(string(b))) + c.Assert(resp.StatusCode, check.Equals, code, check.Commentf(string(b))) + } + + startExec(createExec(), http.StatusOK) + + id := createExec() + dockerCmd(c, "stop", "test") + + startExec(id, http.StatusNotFound) + + dockerCmd(c, "start", "test") + startExec(id, http.StatusNotFound) + + // make sure exec is created before pausing + id = createExec() + dockerCmd(c, "pause", "test") + startExec(id, http.StatusConflict) + dockerCmd(c, "unpause", "test") + startExec(id, http.StatusOK) +} diff --git a/integration-cli/docker_api_images_test.go b/integration-cli/docker_api_images_test.go new file mode 100644 index 0000000000..249f01989a --- /dev/null +++ b/integration-cli/docker_api_images_test.go @@ -0,0 +1,137 @@ +package main + +import ( + "encoding/json" + "net/http" + "net/url" + "strings" + + "github.com/docker/docker/api/types" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestApiImagesFilter(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "utest:tag1" + name2 := "utest/docker:tag2" + name3 := "utest:5000/docker:tag3" + for _, n := range []string{name, name2, name3} { + dockerCmd(c, "tag", "busybox", n) + } + type image types.Image + getImages := func(filter string) []image { + v := url.Values{} + v.Set("filter", filter) + status, b, err := sockRequest("GET", "/images/json?"+v.Encode(), nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var images []image + if err := json.Unmarshal(b, &images); err != nil { + c.Fatal(err) + } + + return images + } + + errMsg := "incorrect number of matches returned" + if images := getImages("utest*/*"); len(images[0].RepoTags) != 2 { + c.Fatal(errMsg) + } + if images := getImages("utest"); len(images[0].RepoTags) != 1 { + c.Fatal(errMsg) + } + if images := getImages("utest*"); len(images[0].RepoTags) != 1 { + c.Fatal(errMsg) + } + if images := getImages("*5000*/*"); len(images[0].RepoTags) != 1 { + c.Fatal(errMsg) + } +} + +func (s *DockerSuite) TestApiImagesSaveAndLoad(c *check.C) { + testRequires(c, Network) + testRequires(c, DaemonIsLinux) + out, err := buildImage("saveandload", "FROM hello-world\nENV FOO bar", false) + if err != nil { + c.Fatal(err) + } + id := strings.TrimSpace(out) + + res, body, err := sockRequestRaw("GET", "/images/"+id+"/get", nil, "") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + defer body.Close() + + dockerCmd(c, "rmi", id) + + res, loadBody, err := sockRequestRaw("POST", "/images/load", body, "application/x-tar") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + + defer loadBody.Close() + + inspectOut, _ := dockerCmd(c, "inspect", "--format='{{ .Id }}'", id) + if strings.TrimSpace(string(inspectOut)) != id { + c.Fatal("load did not work properly") + } +} + +func (s *DockerSuite) TestApiImagesDelete(c *check.C) { + testRequires(c, Network) + testRequires(c, DaemonIsLinux) + name := "test-api-images-delete" + out, err := buildImage(name, "FROM hello-world\nENV FOO bar", false) + if err != nil { + c.Fatal(err) + } + id := strings.TrimSpace(out) + + dockerCmd(c, "tag", name, "test:tag1") + + status, _, err := sockRequest("DELETE", "/images/"+id, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusConflict) + + status, _, err = sockRequest("DELETE", "/images/test:noexist", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) //Status Codes:404 – no such image + + status, _, err = sockRequest("DELETE", "/images/test:tag1", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) +} + +func (s *DockerSuite) TestApiImagesHistory(c *check.C) { + testRequires(c, Network) + testRequires(c, DaemonIsLinux) + name := "test-api-images-history" + out, err := buildImage(name, "FROM hello-world\nENV FOO bar", false) + c.Assert(err, check.IsNil) + + id := strings.TrimSpace(out) + + status, body, err := sockRequest("GET", "/images/"+id+"/history", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var historydata []types.ImageHistory + if err = json.Unmarshal(body, &historydata); err != nil { + c.Fatalf("Error on unmarshal: %s", err) + } + + c.Assert(len(historydata), check.Not(check.Equals), 0) + c.Assert(historydata[0].Tags[0], check.Equals, "test-api-images-history:latest") +} + +// #14846 +func (s *DockerSuite) TestApiImagesSearchJSONContentType(c *check.C) { + testRequires(c, Network) + + res, b, err := sockRequestRaw("GET", "/images/search?term=test", nil, "application/json") + c.Assert(err, check.IsNil) + b.Close() + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + c.Assert(res.Header.Get("Content-Type"), check.Equals, "application/json") +} diff --git a/integration-cli/docker_api_info_test.go b/integration-cli/docker_api_info_test.go new file mode 100644 index 0000000000..54f5752796 --- /dev/null +++ b/integration-cli/docker_api_info_test.go @@ -0,0 +1,37 @@ +package main + +import ( + "net/http" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestInfoApi(c *check.C) { + endpoint := "/info" + + status, body, err := sockRequest("GET", endpoint, nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + // always shown fields + stringsToCheck := []string{ + "ID", + "Containers", + "Images", + "ExecutionDriver", + "LoggingDriver", + "OperatingSystem", + "NCPU", + "MemTotal", + "KernelVersion", + "Driver", + "ServerVersion"} + + out := string(body) + for _, linePrefix := range stringsToCheck { + if !strings.Contains(out, linePrefix) { + c.Errorf("couldn't find string %v in output", linePrefix) + } + } +} diff --git a/integration-cli/docker_api_inspect_test.go b/integration-cli/docker_api_inspect_test.go new file mode 100644 index 0000000000..8a2e0e3092 --- /dev/null +++ b/integration-cli/docker_api_inspect_test.go @@ -0,0 +1,184 @@ +package main + +import ( + "encoding/json" + "net/http" + "strings" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/api/types/versions/v1p20" + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/stringutils" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestInspectApiContainerResponse(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + keysBase := []string{"Id", "State", "Created", "Path", "Args", "Config", "Image", "NetworkSettings", + "ResolvConfPath", "HostnamePath", "HostsPath", "LogPath", "Name", "Driver", "ExecDriver", "MountLabel", "ProcessLabel", "GraphDriver"} + + cases := []struct { + version string + keys []string + }{ + {"v1.20", append(keysBase, "Mounts")}, + {"v1.19", append(keysBase, "Volumes", "VolumesRW")}, + } + + for _, cs := range cases { + body := getInspectBody(c, cs.version, cleanedContainerID) + + var inspectJSON map[string]interface{} + if err := json.Unmarshal(body, &inspectJSON); err != nil { + c.Fatalf("unable to unmarshal body for version %s: %v", cs.version, err) + } + + for _, key := range cs.keys { + if _, ok := inspectJSON[key]; !ok { + c.Fatalf("%s does not exist in response for version %s", key, cs.version) + } + } + + //Issue #6830: type not properly converted to JSON/back + if _, ok := inspectJSON["Path"].(bool); ok { + c.Fatalf("Path of `true` should not be converted to boolean `true` via JSON marshalling") + } + } +} + +func (s *DockerSuite) TestInspectApiContainerVolumeDriverLegacy(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + + cases := []string{"v1.19", "v1.20"} + for _, version := range cases { + body := getInspectBody(c, version, cleanedContainerID) + + var inspectJSON map[string]interface{} + if err := json.Unmarshal(body, &inspectJSON); err != nil { + c.Fatalf("unable to unmarshal body for version %s: %v", version, err) + } + + config, ok := inspectJSON["Config"] + if !ok { + c.Fatal("Unable to find 'Config'") + } + cfg := config.(map[string]interface{}) + if _, ok := cfg["VolumeDriver"]; !ok { + c.Fatalf("Api version %s expected to include VolumeDriver in 'Config'", version) + } + } +} + +func (s *DockerSuite) TestInspectApiContainerVolumeDriver(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + + body := getInspectBody(c, "v1.21", cleanedContainerID) + + var inspectJSON map[string]interface{} + if err := json.Unmarshal(body, &inspectJSON); err != nil { + c.Fatalf("unable to unmarshal body for version 1.21: %v", err) + } + + config, ok := inspectJSON["Config"] + if !ok { + c.Fatal("Unable to find 'Config'") + } + cfg := config.(map[string]interface{}) + if _, ok := cfg["VolumeDriver"]; ok { + c.Fatal("Api version 1.21 expected to not include VolumeDriver in 'Config'") + } + + config, ok = inspectJSON["HostConfig"] + if !ok { + c.Fatal("Unable to find 'HostConfig'") + } + cfg = config.(map[string]interface{}) + if _, ok := cfg["VolumeDriver"]; !ok { + c.Fatal("Api version 1.21 expected to include VolumeDriver in 'HostConfig'") + } +} + +func (s *DockerSuite) TestInspectApiImageResponse(c *check.C) { + dockerCmd(c, "tag", "busybox:latest", "busybox:mytag") + + endpoint := "/images/busybox/json" + status, body, err := sockRequest("GET", endpoint, nil) + + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var imageJSON types.ImageInspect + if err = json.Unmarshal(body, &imageJSON); err != nil { + c.Fatalf("unable to unmarshal body for latest version: %v", err) + } + + c.Assert(len(imageJSON.RepoTags), check.Equals, 2) + + c.Assert(stringutils.InSlice(imageJSON.RepoTags, "busybox:latest"), check.Equals, true) + c.Assert(stringutils.InSlice(imageJSON.RepoTags, "busybox:mytag"), check.Equals, true) +} + +// #17131, #17139, #17173 +func (s *DockerSuite) TestInspectApiEmptyFieldsInConfigPre121(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + + cases := []string{"v1.19", "v1.20"} + for _, version := range cases { + body := getInspectBody(c, version, cleanedContainerID) + + var inspectJSON map[string]interface{} + if err := json.Unmarshal(body, &inspectJSON); err != nil { + c.Fatalf("unable to unmarshal body for version %s: %v", version, err) + } + + config, ok := inspectJSON["Config"] + if !ok { + c.Fatal("Unable to find 'Config'") + } + cfg := config.(map[string]interface{}) + for _, f := range []string{"MacAddress", "NetworkDisabled", "ExposedPorts"} { + if _, ok := cfg[f]; !ok { + c.Fatalf("Api version %s expected to include %s in 'Config'", version, f) + } + } + } +} + +func (s *DockerSuite) TestInspectApiBridgeNetworkSettings120(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + body := getInspectBody(c, "v1.20", cleanedContainerID) + + var inspectJSON v1p20.ContainerJSON + err := json.Unmarshal(body, &inspectJSON) + c.Assert(err, checker.IsNil) + + settings := inspectJSON.NetworkSettings + c.Assert(settings.IPAddress, checker.Not(checker.HasLen), 0) +} + +func (s *DockerSuite) TestInspectApiBridgeNetworkSettings121(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + cleanedContainerID := strings.TrimSpace(out) + + body := getInspectBody(c, "v1.21", cleanedContainerID) + + var inspectJSON types.ContainerJSON + err := json.Unmarshal(body, &inspectJSON) + c.Assert(err, checker.IsNil) + + settings := inspectJSON.NetworkSettings + c.Assert(settings.IPAddress, checker.Not(checker.HasLen), 0) + c.Assert(settings.Networks["bridge"], checker.Not(checker.IsNil)) + c.Assert(settings.IPAddress, checker.Equals, settings.Networks["bridge"].IPAddress) +} diff --git a/integration-cli/docker_api_inspect_unix_test.go b/integration-cli/docker_api_inspect_unix_test.go new file mode 100644 index 0000000000..3120eb67c2 --- /dev/null +++ b/integration-cli/docker_api_inspect_unix_test.go @@ -0,0 +1,38 @@ +// +build !windows + +package main + +import ( + "encoding/json" + "fmt" + "net/http" + + "github.com/go-check/check" +) + +// #16665 +func (s *DockerSuite) TestInspectApiCpusetInConfigPre120(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, cgroupCpuset) + + name := "cpusetinconfig-pre120" + dockerCmd(c, "run", "--name", name, "--cpuset", "0-1", "busybox", "true") + + status, body, err := sockRequest("GET", fmt.Sprintf("/v1.19/containers/%s/json", name), nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + var inspectJSON map[string]interface{} + if err = json.Unmarshal(body, &inspectJSON); err != nil { + c.Fatalf("unable to unmarshal body for version 1.19: %v", err) + } + + config, ok := inspectJSON["Config"] + if !ok { + c.Fatal("Unable to find 'Config'") + } + cfg := config.(map[string]interface{}) + if _, ok := cfg["Cpuset"]; !ok { + c.Fatal("Api version 1.19 expected to include Cpuset in 'Config'") + } +} diff --git a/integration-cli/docker_api_logs_test.go b/integration-cli/docker_api_logs_test.go new file mode 100644 index 0000000000..26c59fed72 --- /dev/null +++ b/integration-cli/docker_api_logs_test.go @@ -0,0 +1,91 @@ +package main + +import ( + "bufio" + "bytes" + "fmt" + "net/http" + "strings" + "time" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestLogsApiWithStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "-t", "busybox", "/bin/sh", "-c", "while true; do echo hello; sleep 1; done") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + type logOut struct { + out string + res *http.Response + err error + } + chLog := make(chan logOut) + + go func() { + res, body, err := sockRequestRaw("GET", fmt.Sprintf("/containers/%s/logs?follow=1&stdout=1×tamps=1", id), nil, "") + if err != nil { + chLog <- logOut{"", nil, err} + return + } + defer body.Close() + out, err := bufio.NewReader(body).ReadString('\n') + if err != nil { + chLog <- logOut{"", nil, err} + return + } + chLog <- logOut{strings.TrimSpace(out), res, err} + }() + + select { + case l := <-chLog: + c.Assert(l.err, check.IsNil) + c.Assert(l.res.StatusCode, check.Equals, http.StatusOK) + if !strings.HasSuffix(l.out, "hello") { + c.Fatalf("expected log output to container 'hello', but it does not") + } + case <-time.After(2 * time.Second): + c.Fatal("timeout waiting for logs to exit") + } +} + +func (s *DockerSuite) TestLogsApiNoStdoutNorStderr(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "logs_test" + dockerCmd(c, "run", "-d", "-t", "--name", name, "busybox", "/bin/sh") + + status, body, err := sockRequest("GET", fmt.Sprintf("/containers/%s/logs", name), nil) + c.Assert(status, check.Equals, http.StatusBadRequest) + c.Assert(err, check.IsNil) + + expected := "Bad parameters: you must choose at least one stream" + if !bytes.Contains(body, []byte(expected)) { + c.Fatalf("Expected %s, got %s", expected, string(body[:])) + } +} + +// Regression test for #12704 +func (s *DockerSuite) TestLogsApiFollowEmptyOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "logs_test" + t0 := time.Now() + dockerCmd(c, "run", "-d", "-t", "--name", name, "busybox", "sleep", "10") + + _, body, err := sockRequestRaw("GET", fmt.Sprintf("/containers/%s/logs?follow=1&stdout=1&stderr=1&tail=all", name), bytes.NewBuffer(nil), "") + t1 := time.Now() + c.Assert(err, check.IsNil) + body.Close() + elapsed := t1.Sub(t0).Seconds() + if elapsed > 5.0 { + c.Fatalf("HTTP response was not immediate (elapsed %.1fs)", elapsed) + } +} + +func (s *DockerSuite) TestLogsAPIContainerNotFound(c *check.C) { + name := "nonExistentContainer" + resp, _, err := sockRequestRaw("GET", fmt.Sprintf("/containers/%s/logs?follow=1&stdout=1&stderr=1&tail=all", name), bytes.NewBuffer(nil), "") + c.Assert(err, check.IsNil) + c.Assert(resp.StatusCode, check.Equals, http.StatusNotFound) +} diff --git a/integration-cli/docker_api_network_test.go b/integration-cli/docker_api_network_test.go new file mode 100644 index 0000000000..abf569aecf --- /dev/null +++ b/integration-cli/docker_api_network_test.go @@ -0,0 +1,304 @@ +package main + +import ( + "encoding/json" + "fmt" + "net" + "net/http" + "net/url" + "strings" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/daemon/network" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestApiNetworkGetDefaults(c *check.C) { + // By default docker daemon creates 3 networks. check if they are present + defaults := []string{"bridge", "host", "none"} + for _, nn := range defaults { + c.Assert(isNetworkAvailable(c, nn), check.Equals, true) + } +} + +func (s *DockerSuite) TestApiNetworkCreateDelete(c *check.C) { + // Create a network + name := "testnetwork" + config := types.NetworkCreate{ + Name: name, + CheckDuplicate: true, + } + id := createNetwork(c, config, true) + c.Assert(isNetworkAvailable(c, name), check.Equals, true) + + // POST another network with same name and CheckDuplicate must fail + createNetwork(c, config, false) + + // delete the network and make sure it is deleted + deleteNetwork(c, id, true) + c.Assert(isNetworkAvailable(c, name), check.Equals, false) +} + +func (s *DockerSuite) TestApiNetworkFilter(c *check.C) { + nr := getNetworkResource(c, getNetworkIDByName(c, "bridge")) + c.Assert(nr.Name, check.Equals, "bridge") +} + +func (s *DockerSuite) TestApiNetworkInspect(c *check.C) { + // Inspect default bridge network + nr := getNetworkResource(c, "bridge") + c.Assert(nr.Name, check.Equals, "bridge") + + // run a container and attach it to the default bridge network + out, _ := dockerCmd(c, "run", "-d", "--name", "test", "busybox", "top") + containerID := strings.TrimSpace(out) + containerIP := findContainerIP(c, "test", "bridge") + + // inspect default bridge network again and make sure the container is connected + nr = getNetworkResource(c, nr.ID) + c.Assert(nr.Driver, check.Equals, "bridge") + c.Assert(nr.Scope, check.Equals, "local") + c.Assert(nr.IPAM.Driver, check.Equals, "default") + c.Assert(len(nr.Containers), check.Equals, 1) + c.Assert(nr.Containers[containerID], check.NotNil) + + ip, _, err := net.ParseCIDR(nr.Containers[containerID].IPv4Address) + c.Assert(err, check.IsNil) + c.Assert(ip.String(), check.Equals, containerIP) + + // IPAM configuration inspect + ipam := network.IPAM{ + Driver: "default", + Config: []network.IPAMConfig{{Subnet: "172.28.0.0/16", IPRange: "172.28.5.0/24", Gateway: "172.28.5.254"}}, + } + config := types.NetworkCreate{ + Name: "br0", + Driver: "bridge", + IPAM: ipam, + Options: map[string]string{"foo": "bar", "opts": "dopts"}, + } + id0 := createNetwork(c, config, true) + c.Assert(isNetworkAvailable(c, "br0"), check.Equals, true) + + nr = getNetworkResource(c, id0) + c.Assert(len(nr.IPAM.Config), check.Equals, 1) + c.Assert(nr.IPAM.Config[0].Subnet, check.Equals, "172.28.0.0/16") + c.Assert(nr.IPAM.Config[0].IPRange, check.Equals, "172.28.5.0/24") + c.Assert(nr.IPAM.Config[0].Gateway, check.Equals, "172.28.5.254") + // delete the network and make sure it is deleted + deleteNetwork(c, id0, true) + c.Assert(isNetworkAvailable(c, "br0"), check.Equals, false) +} + +func (s *DockerSuite) TestApiNetworkConnectDisconnect(c *check.C) { + // Create test network + name := "testnetwork" + config := types.NetworkCreate{ + Name: name, + } + id := createNetwork(c, config, true) + nr := getNetworkResource(c, id) + c.Assert(nr.Name, check.Equals, name) + c.Assert(nr.ID, check.Equals, id) + c.Assert(len(nr.Containers), check.Equals, 0) + + // run a container + out, _ := dockerCmd(c, "run", "-d", "--name", "test", "busybox", "top") + containerID := strings.TrimSpace(out) + + // connect the container to the test network + connectNetwork(c, nr.ID, containerID) + + // inspect the network to make sure container is connected + nr = getNetworkResource(c, nr.ID) + c.Assert(len(nr.Containers), check.Equals, 1) + c.Assert(nr.Containers[containerID], check.NotNil) + + // check if container IP matches network inspect + ip, _, err := net.ParseCIDR(nr.Containers[containerID].IPv4Address) + c.Assert(err, check.IsNil) + containerIP := findContainerIP(c, "test", "testnetwork") + c.Assert(ip.String(), check.Equals, containerIP) + + // disconnect container from the network + disconnectNetwork(c, nr.ID, containerID) + nr = getNetworkResource(c, nr.ID) + c.Assert(nr.Name, check.Equals, name) + c.Assert(len(nr.Containers), check.Equals, 0) + + // delete the network + deleteNetwork(c, nr.ID, true) +} + +func (s *DockerSuite) TestApiNetworkIpamMultipleBridgeNetworks(c *check.C) { + // test0 bridge network + ipam0 := network.IPAM{ + Driver: "default", + Config: []network.IPAMConfig{{Subnet: "192.178.0.0/16", IPRange: "192.178.128.0/17", Gateway: "192.178.138.100"}}, + } + config0 := types.NetworkCreate{ + Name: "test0", + Driver: "bridge", + IPAM: ipam0, + } + id0 := createNetwork(c, config0, true) + c.Assert(isNetworkAvailable(c, "test0"), check.Equals, true) + + ipam1 := network.IPAM{ + Driver: "default", + Config: []network.IPAMConfig{{Subnet: "192.178.128.0/17", Gateway: "192.178.128.1"}}, + } + // test1 bridge network overlaps with test0 + config1 := types.NetworkCreate{ + Name: "test1", + Driver: "bridge", + IPAM: ipam1, + } + createNetwork(c, config1, false) + c.Assert(isNetworkAvailable(c, "test1"), check.Equals, false) + + ipam2 := network.IPAM{ + Driver: "default", + Config: []network.IPAMConfig{{Subnet: "192.169.0.0/16", Gateway: "192.169.100.100"}}, + } + // test2 bridge network does not overlap + config2 := types.NetworkCreate{ + Name: "test2", + Driver: "bridge", + IPAM: ipam2, + } + createNetwork(c, config2, true) + c.Assert(isNetworkAvailable(c, "test2"), check.Equals, true) + + // remove test0 and retry to create test1 + deleteNetwork(c, id0, true) + createNetwork(c, config1, true) + c.Assert(isNetworkAvailable(c, "test1"), check.Equals, true) + + // for networks w/o ipam specified, docker will choose proper non-overlapping subnets + createNetwork(c, types.NetworkCreate{Name: "test3"}, true) + c.Assert(isNetworkAvailable(c, "test3"), check.Equals, true) + createNetwork(c, types.NetworkCreate{Name: "test4"}, true) + c.Assert(isNetworkAvailable(c, "test4"), check.Equals, true) + createNetwork(c, types.NetworkCreate{Name: "test5"}, true) + c.Assert(isNetworkAvailable(c, "test5"), check.Equals, true) + + for i := 1; i < 6; i++ { + deleteNetwork(c, fmt.Sprintf("test%d", i), true) + } +} + +func (s *DockerSuite) TestApiCreateDeletePredefinedNetworks(c *check.C) { + createDeletePredefinedNetwork(c, "bridge") + createDeletePredefinedNetwork(c, "none") + createDeletePredefinedNetwork(c, "host") +} + +func createDeletePredefinedNetwork(c *check.C, name string) { + // Create pre-defined network + config := types.NetworkCreate{ + Name: name, + CheckDuplicate: true, + } + shouldSucceed := false + createNetwork(c, config, shouldSucceed) + deleteNetwork(c, name, shouldSucceed) +} + +func isNetworkAvailable(c *check.C, name string) bool { + status, body, err := sockRequest("GET", "/networks", nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + nJSON := []types.NetworkResource{} + err = json.Unmarshal(body, &nJSON) + c.Assert(err, check.IsNil) + + for _, n := range nJSON { + if n.Name == name { + return true + } + } + return false +} + +func getNetworkIDByName(c *check.C, name string) string { + var ( + v = url.Values{} + filterArgs = filters.Args{} + ) + filterArgs["name"] = []string{name} + filterJSON, err := filters.ToParam(filterArgs) + c.Assert(err, check.IsNil) + v.Set("filters", filterJSON) + + status, body, err := sockRequest("GET", "/networks?"+v.Encode(), nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + nJSON := []types.NetworkResource{} + err = json.Unmarshal(body, &nJSON) + c.Assert(err, check.IsNil) + c.Assert(len(nJSON), check.Equals, 1) + + return nJSON[0].ID +} + +func getNetworkResource(c *check.C, id string) *types.NetworkResource { + _, obj, err := sockRequest("GET", "/networks/"+id, nil) + c.Assert(err, check.IsNil) + + nr := types.NetworkResource{} + err = json.Unmarshal(obj, &nr) + c.Assert(err, check.IsNil) + + return &nr +} + +func createNetwork(c *check.C, config types.NetworkCreate, shouldSucceed bool) string { + status, resp, err := sockRequest("POST", "/networks/create", config) + if !shouldSucceed { + c.Assert(status, check.Not(check.Equals), http.StatusCreated) + return "" + } + + c.Assert(status, check.Equals, http.StatusCreated) + c.Assert(err, check.IsNil) + + var nr types.NetworkCreateResponse + err = json.Unmarshal(resp, &nr) + c.Assert(err, check.IsNil) + + return nr.ID +} + +func connectNetwork(c *check.C, nid, cid string) { + config := types.NetworkConnect{ + Container: cid, + } + + status, _, err := sockRequest("POST", "/networks/"+nid+"/connect", config) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) +} + +func disconnectNetwork(c *check.C, nid, cid string) { + config := types.NetworkConnect{ + Container: cid, + } + + status, _, err := sockRequest("POST", "/networks/"+nid+"/disconnect", config) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) +} + +func deleteNetwork(c *check.C, id string, shouldSucceed bool) { + status, _, err := sockRequest("DELETE", "/networks/"+id, nil) + if !shouldSucceed { + c.Assert(status, check.Not(check.Equals), http.StatusOK) + return + } + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) +} diff --git a/integration-cli/docker_api_resize_test.go b/integration-cli/docker_api_resize_test.go new file mode 100644 index 0000000000..bd46dda9d8 --- /dev/null +++ b/integration-cli/docker_api_resize_test.go @@ -0,0 +1,48 @@ +package main + +import ( + "net/http" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestResizeApiResponse(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + endpoint := "/containers/" + cleanedContainerID + "/resize?h=40&w=40" + status, _, err := sockRequest("POST", endpoint, nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) +} + +func (s *DockerSuite) TestResizeApiHeightWidthNoInt(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + endpoint := "/containers/" + cleanedContainerID + "/resize?h=foo&w=bar" + status, _, err := sockRequest("POST", endpoint, nil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + c.Assert(err, check.IsNil) +} + +func (s *DockerSuite) TestResizeApiResponseWhenContainerNotStarted(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + cleanedContainerID := strings.TrimSpace(out) + + // make sure the exited container is not running + dockerCmd(c, "wait", cleanedContainerID) + + endpoint := "/containers/" + cleanedContainerID + "/resize?h=40&w=40" + status, body, err := sockRequest("POST", endpoint, nil) + c.Assert(status, check.Equals, http.StatusInternalServerError) + c.Assert(err, check.IsNil) + + if !strings.Contains(string(body), "Cannot resize container") && !strings.Contains(string(body), cleanedContainerID) { + c.Fatalf("resize should fail with message 'Cannot resize container' but instead received %s", string(body)) + } +} diff --git a/integration-cli/docker_api_stats_test.go b/integration-cli/docker_api_stats_test.go new file mode 100644 index 0000000000..d280c26d61 --- /dev/null +++ b/integration-cli/docker_api_stats_test.go @@ -0,0 +1,148 @@ +package main + +import ( + "encoding/json" + "fmt" + "net/http" + "os/exec" + "runtime" + "strconv" + "strings" + "time" + + "github.com/docker/docker/api/types" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestApiStatsNoStreamGetCpu(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "while true;do echo 'Hello'; usleep 100000; done") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + resp, body, err := sockRequestRaw("GET", fmt.Sprintf("/containers/%s/stats?stream=false", id), nil, "") + c.Assert(err, check.IsNil) + c.Assert(resp.ContentLength > 0, check.Equals, true, check.Commentf("should not use chunked encoding")) + c.Assert(resp.Header.Get("Content-Type"), check.Equals, "application/json") + + var v *types.Stats + err = json.NewDecoder(body).Decode(&v) + c.Assert(err, check.IsNil) + body.Close() + + var cpuPercent = 0.0 + cpuDelta := float64(v.CPUStats.CPUUsage.TotalUsage - v.PreCPUStats.CPUUsage.TotalUsage) + systemDelta := float64(v.CPUStats.SystemUsage - v.PreCPUStats.SystemUsage) + cpuPercent = (cpuDelta / systemDelta) * float64(len(v.CPUStats.CPUUsage.PercpuUsage)) * 100.0 + if cpuPercent == 0 { + c.Fatalf("docker stats with no-stream get cpu usage failed: was %v", cpuPercent) + } +} + +func (s *DockerSuite) TestApiStatsStoppedContainerInGoroutines(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "echo 1") + id := strings.TrimSpace(out) + + getGoRoutines := func() int { + _, body, err := sockRequestRaw("GET", fmt.Sprintf("/info"), nil, "") + c.Assert(err, check.IsNil) + info := types.Info{} + err = json.NewDecoder(body).Decode(&info) + c.Assert(err, check.IsNil) + body.Close() + return info.NGoroutines + } + + // When the HTTP connection is closed, the number of goroutines should not increase. + routines := getGoRoutines() + _, body, err := sockRequestRaw("GET", fmt.Sprintf("/containers/%s/stats", id), nil, "") + c.Assert(err, check.IsNil) + body.Close() + + t := time.After(30 * time.Second) + for { + select { + case <-t: + c.Assert(getGoRoutines() <= routines, check.Equals, true) + return + default: + if n := getGoRoutines(); n <= routines { + return + } + time.Sleep(200 * time.Millisecond) + } + } +} + +func (s *DockerSuite) TestApiStatsNetworkStats(c *check.C) { + testRequires(c, SameHostDaemon) + testRequires(c, DaemonIsLinux) + // Run container for 30 secs + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + // Retrieve the container address + contIP := findContainerIP(c, id, "bridge") + numPings := 10 + + var preRxPackets uint64 + var preTxPackets uint64 + var postRxPackets uint64 + var postTxPackets uint64 + + // Get the container networking stats before and after pinging the container + nwStatsPre := getNetworkStats(c, id) + for _, v := range nwStatsPre { + preRxPackets += v.RxPackets + preTxPackets += v.TxPackets + } + + countParam := "-c" + if runtime.GOOS == "windows" { + countParam = "-n" // Ping count parameter is -n on Windows + } + pingout, err := exec.Command("ping", contIP, countParam, strconv.Itoa(numPings)).Output() + pingouts := string(pingout[:]) + c.Assert(err, check.IsNil) + nwStatsPost := getNetworkStats(c, id) + for _, v := range nwStatsPost { + postRxPackets += v.RxPackets + postTxPackets += v.TxPackets + } + + // Verify the stats contain at least the expected number of packets (account for ARP) + expRxPkts := 1 + preRxPackets + uint64(numPings) + expTxPkts := 1 + preTxPackets + uint64(numPings) + c.Assert(postTxPackets >= expTxPkts, check.Equals, true, + check.Commentf("Reported less TxPackets than expected. Expected >= %d. Found %d. %s", expTxPkts, postTxPackets, pingouts)) + c.Assert(postRxPackets >= expRxPkts, check.Equals, true, + check.Commentf("Reported less Txbytes than expected. Expected >= %d. Found %d. %s", expRxPkts, postRxPackets, pingouts)) +} + +func getNetworkStats(c *check.C, id string) map[string]types.NetworkStats { + var st *types.StatsJSON + + _, body, err := sockRequestRaw("GET", fmt.Sprintf("/containers/%s/stats?stream=false", id), nil, "") + c.Assert(err, check.IsNil) + + err = json.NewDecoder(body).Decode(&st) + c.Assert(err, check.IsNil) + body.Close() + + return st.Networks +} + +func (s *DockerSuite) TestApiStatsContainerNotFound(c *check.C) { + testRequires(c, DaemonIsLinux) + + status, _, err := sockRequest("GET", "/containers/nonexistent/stats", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) + + status, _, err = sockRequest("GET", "/containers/nonexistent/stats?stream=0", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNotFound) +} diff --git a/integration-cli/docker_api_test.go b/integration-cli/docker_api_test.go new file mode 100644 index 0000000000..6cbf301955 --- /dev/null +++ b/integration-cli/docker_api_test.go @@ -0,0 +1,73 @@ +package main + +import ( + "net/http" + "net/http/httputil" + "strconv" + "strings" + "time" + + "github.com/docker/docker/api" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestApiOptionsRoute(c *check.C) { + status, _, err := sockRequest("OPTIONS", "/", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) +} + +func (s *DockerSuite) TestApiGetEnabledCors(c *check.C) { + res, body, err := sockRequestRaw("GET", "/version", nil, "") + c.Assert(err, check.IsNil) + c.Assert(res.StatusCode, check.Equals, http.StatusOK) + body.Close() + // TODO: @runcom incomplete tests, why old integration tests had this headers + // and here none of the headers below are in the response? + //c.Log(res.Header) + //c.Assert(res.Header.Get("Access-Control-Allow-Origin"), check.Equals, "*") + //c.Assert(res.Header.Get("Access-Control-Allow-Headers"), check.Equals, "Origin, X-Requested-With, Content-Type, Accept, X-Registry-Auth") +} + +func (s *DockerSuite) TestApiVersionStatusCode(c *check.C) { + conn, err := sockConn(time.Duration(10 * time.Second)) + c.Assert(err, check.IsNil) + + client := httputil.NewClientConn(conn, nil) + defer client.Close() + + req, err := http.NewRequest("GET", "/v999.0/version", nil) + c.Assert(err, check.IsNil) + req.Header.Set("User-Agent", "Docker-Client/999.0 (os)") + + res, err := client.Do(req) + c.Assert(res.StatusCode, check.Equals, http.StatusBadRequest) +} + +func (s *DockerSuite) TestApiClientVersionNewerThanServer(c *check.C) { + v := strings.Split(string(api.Version), ".") + vMinInt, err := strconv.Atoi(v[1]) + c.Assert(err, check.IsNil) + vMinInt++ + v[1] = strconv.Itoa(vMinInt) + version := strings.Join(v, ".") + + status, body, err := sockRequest("GET", "/v"+version+"/version", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusBadRequest) + c.Assert(len(string(body)), check.Not(check.Equals), 0) // Expected not empty body +} + +func (s *DockerSuite) TestApiClientVersionOldNotSupported(c *check.C) { + v := strings.Split(string(api.MinVersion), ".") + vMinInt, err := strconv.Atoi(v[1]) + c.Assert(err, check.IsNil) + vMinInt-- + v[1] = strconv.Itoa(vMinInt) + version := strings.Join(v, ".") + + status, body, err := sockRequest("GET", "/v"+version+"/version", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusBadRequest) + c.Assert(len(string(body)), check.Not(check.Equals), 0) // Expected not empty body +} diff --git a/integration-cli/docker_api_version_test.go b/integration-cli/docker_api_version_test.go new file mode 100644 index 0000000000..b756794c26 --- /dev/null +++ b/integration-cli/docker_api_version_test.go @@ -0,0 +1,25 @@ +package main + +import ( + "encoding/json" + "net/http" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/autogen/dockerversion" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestGetVersion(c *check.C) { + status, body, err := sockRequest("GET", "/version", nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + var v types.Version + if err := json.Unmarshal(body, &v); err != nil { + c.Fatal(err) + } + + if v.Version != dockerversion.VERSION { + c.Fatal("Version mismatch") + } +} diff --git a/integration-cli/docker_api_volumes_test.go b/integration-cli/docker_api_volumes_test.go new file mode 100644 index 0000000000..90ca8ec044 --- /dev/null +++ b/integration-cli/docker_api_volumes_test.go @@ -0,0 +1,89 @@ +package main + +import ( + "encoding/json" + "net/http" + "path" + + "github.com/docker/docker/api/types" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestVolumesApiList(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "-v", "/foo", "busybox") + + status, b, err := sockRequest("GET", "/volumes", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var volumes types.VolumesListResponse + c.Assert(json.Unmarshal(b, &volumes), check.IsNil) + + c.Assert(len(volumes.Volumes), check.Equals, 1, check.Commentf("\n%v", volumes.Volumes)) +} + +func (s *DockerSuite) TestVolumesApiCreate(c *check.C) { + testRequires(c, DaemonIsLinux) + config := types.VolumeCreateRequest{ + Name: "test", + } + status, b, err := sockRequest("POST", "/volumes/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated, check.Commentf(string(b))) + + var vol types.Volume + err = json.Unmarshal(b, &vol) + c.Assert(err, check.IsNil) + + c.Assert(path.Base(path.Dir(vol.Mountpoint)), check.Equals, config.Name) +} + +func (s *DockerSuite) TestVolumesApiRemove(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "-v", "/foo", "--name=test", "busybox") + + status, b, err := sockRequest("GET", "/volumes", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + + var volumes types.VolumesListResponse + c.Assert(json.Unmarshal(b, &volumes), check.IsNil) + c.Assert(len(volumes.Volumes), check.Equals, 1, check.Commentf("\n%v", volumes.Volumes)) + + v := volumes.Volumes[0] + status, _, err = sockRequest("DELETE", "/volumes/"+v.Name, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusConflict, check.Commentf("Should not be able to remove a volume that is in use")) + + dockerCmd(c, "rm", "-f", "test") + status, data, err := sockRequest("DELETE", "/volumes/"+v.Name, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent, check.Commentf(string(data))) + +} + +func (s *DockerSuite) TestVolumesApiInspect(c *check.C) { + testRequires(c, DaemonIsLinux) + config := types.VolumeCreateRequest{ + Name: "test", + } + status, b, err := sockRequest("POST", "/volumes/create", config) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusCreated, check.Commentf(string(b))) + + status, b, err = sockRequest("GET", "/volumes", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK, check.Commentf(string(b))) + + var volumes types.VolumesListResponse + c.Assert(json.Unmarshal(b, &volumes), check.IsNil) + c.Assert(len(volumes.Volumes), check.Equals, 1, check.Commentf("\n%v", volumes.Volumes)) + + var vol types.Volume + status, b, err = sockRequest("GET", "/volumes/"+config.Name, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK, check.Commentf(string(b))) + c.Assert(json.Unmarshal(b, &vol), check.IsNil) + c.Assert(vol.Name, check.Equals, config.Name) +} diff --git a/integration-cli/docker_cli_attach_test.go b/integration-cli/docker_cli_attach_test.go new file mode 100644 index 0000000000..c96b05c665 --- /dev/null +++ b/integration-cli/docker_cli_attach_test.go @@ -0,0 +1,177 @@ +package main + +import ( + "bufio" + "fmt" + "io" + "os/exec" + "strings" + "sync" + "time" + + "github.com/go-check/check" +) + +const attachWait = 5 * time.Second + +func (s *DockerSuite) TestAttachMultipleAndRestart(c *check.C) { + testRequires(c, DaemonIsLinux) + + endGroup := &sync.WaitGroup{} + startGroup := &sync.WaitGroup{} + endGroup.Add(3) + startGroup.Add(3) + + if err := waitForContainer("attacher", "-d", "busybox", "/bin/sh", "-c", "while true; do sleep 1; echo hello; done"); err != nil { + c.Fatal(err) + } + + startDone := make(chan struct{}) + endDone := make(chan struct{}) + + go func() { + endGroup.Wait() + close(endDone) + }() + + go func() { + startGroup.Wait() + close(startDone) + }() + + for i := 0; i < 3; i++ { + go func() { + cmd := exec.Command(dockerBinary, "attach", "attacher") + + defer func() { + cmd.Wait() + endGroup.Done() + }() + + out, err := cmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + + if err := cmd.Start(); err != nil { + c.Fatal(err) + } + + buf := make([]byte, 1024) + + if _, err := out.Read(buf); err != nil && err != io.EOF { + c.Fatal(err) + } + + startGroup.Done() + + if !strings.Contains(string(buf), "hello") { + c.Fatalf("unexpected output %s expected hello\n", string(buf)) + } + }() + } + + select { + case <-startDone: + case <-time.After(attachWait): + c.Fatalf("Attaches did not initialize properly") + } + + dockerCmd(c, "kill", "attacher") + + select { + case <-endDone: + case <-time.After(attachWait): + c.Fatalf("Attaches did not finish properly") + } + +} + +func (s *DockerSuite) TestAttachTtyWithoutStdin(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "-ti", "busybox") + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + defer func() { + cmd := exec.Command(dockerBinary, "kill", id) + if out, _, err := runCommandWithOutput(cmd); err != nil { + c.Fatalf("failed to kill container: %v (%v)", out, err) + } + }() + + done := make(chan error) + go func() { + defer close(done) + + cmd := exec.Command(dockerBinary, "attach", id) + if _, err := cmd.StdinPipe(); err != nil { + done <- err + return + } + + expected := "cannot enable tty mode" + if out, _, err := runCommandWithOutput(cmd); err == nil { + done <- fmt.Errorf("attach should have failed") + return + } else if !strings.Contains(out, expected) { + done <- fmt.Errorf("attach failed with error %q: expected %q", out, expected) + return + } + }() + + select { + case err := <-done: + c.Assert(err, check.IsNil) + case <-time.After(attachWait): + c.Fatal("attach is running but should have failed") + } +} + +func (s *DockerSuite) TestAttachDisconnect(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-di", "busybox", "/bin/cat") + id := strings.TrimSpace(out) + + cmd := exec.Command(dockerBinary, "attach", id) + stdin, err := cmd.StdinPipe() + if err != nil { + c.Fatal(err) + } + defer stdin.Close() + stdout, err := cmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + defer stdout.Close() + if err := cmd.Start(); err != nil { + c.Fatal(err) + } + defer cmd.Process.Kill() + + if _, err := stdin.Write([]byte("hello\n")); err != nil { + c.Fatal(err) + } + out, err = bufio.NewReader(stdout).ReadString('\n') + if err != nil { + c.Fatal(err) + } + if strings.TrimSpace(out) != "hello" { + c.Fatalf("expected 'hello', got %q", out) + } + + if err := stdin.Close(); err != nil { + c.Fatal(err) + } + + // Expect container to still be running after stdin is closed + running, err := inspectField(id, "State.Running") + if err != nil { + c.Fatal(err) + } + if running != "true" { + c.Fatal("expected container to still be running") + } + +} diff --git a/integration-cli/docker_cli_attach_unix_test.go b/integration-cli/docker_cli_attach_unix_test.go new file mode 100644 index 0000000000..64ac28bd72 --- /dev/null +++ b/integration-cli/docker_cli_attach_unix_test.go @@ -0,0 +1,270 @@ +// +build !windows + +package main + +import ( + "bufio" + "os/exec" + "strings" + "time" + + "github.com/docker/docker/pkg/stringid" + "github.com/go-check/check" + "github.com/kr/pty" +) + +// #9860 Make sure attach ends when container ends (with no errors) +func (s *DockerSuite) TestAttachClosedOnContainerStop(c *check.C) { + + out, _ := dockerCmd(c, "run", "-dti", "busybox", "/bin/sh", "-c", `trap 'exit 0' SIGTERM; while true; do sleep 1; done`) + + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + _, tty, err := pty.Open() + c.Assert(err, check.IsNil) + + attachCmd := exec.Command(dockerBinary, "attach", id) + attachCmd.Stdin = tty + attachCmd.Stdout = tty + attachCmd.Stderr = tty + err = attachCmd.Start() + c.Assert(err, check.IsNil) + + errChan := make(chan error) + go func() { + defer close(errChan) + // Container is wating for us to signal it to stop + dockerCmd(c, "stop", id) + // And wait for the attach command to end + errChan <- attachCmd.Wait() + }() + + // Wait for the docker to end (should be done by the + // stop command in the go routine) + dockerCmd(c, "wait", id) + + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(attachWait): + c.Fatal("timed out without attach returning") + } + +} + +func (s *DockerSuite) TestAttachAfterDetach(c *check.C) { + + name := "detachtest" + + cpty, tty, err := pty.Open() + if err != nil { + c.Fatalf("Could not open pty: %v", err) + } + cmd := exec.Command(dockerBinary, "run", "-ti", "--name", name, "busybox") + cmd.Stdin = tty + cmd.Stdout = tty + cmd.Stderr = tty + + errChan := make(chan error) + go func() { + errChan <- cmd.Run() + close(errChan) + }() + + c.Assert(waitRun(name), check.IsNil) + + cpty.Write([]byte{16}) + time.Sleep(100 * time.Millisecond) + cpty.Write([]byte{17}) + + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(5 * time.Second): + c.Fatal("timeout while detaching") + } + + cpty, tty, err = pty.Open() + if err != nil { + c.Fatalf("Could not open pty: %v", err) + } + + cmd = exec.Command(dockerBinary, "attach", name) + cmd.Stdin = tty + cmd.Stdout = tty + cmd.Stderr = tty + + if err := cmd.Start(); err != nil { + c.Fatal(err) + } + + bytes := make([]byte, 10) + var nBytes int + readErr := make(chan error, 1) + + go func() { + time.Sleep(500 * time.Millisecond) + cpty.Write([]byte("\n")) + time.Sleep(500 * time.Millisecond) + + nBytes, err = cpty.Read(bytes) + cpty.Close() + readErr <- err + }() + + select { + case err := <-readErr: + c.Assert(err, check.IsNil) + case <-time.After(2 * time.Second): + c.Fatal("timeout waiting for attach read") + } + + if err := cmd.Wait(); err != nil { + c.Fatal(err) + } + + if !strings.Contains(string(bytes[:nBytes]), "/ #") { + c.Fatalf("failed to get a new prompt. got %s", string(bytes[:nBytes])) + } + +} + +// TestAttachDetach checks that attach in tty mode can be detached using the long container ID +func (s *DockerSuite) TestAttachDetach(c *check.C) { + out, _ := dockerCmd(c, "run", "-itd", "busybox", "cat") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + cpty, tty, err := pty.Open() + if err != nil { + c.Fatal(err) + } + defer cpty.Close() + + cmd := exec.Command(dockerBinary, "attach", id) + cmd.Stdin = tty + stdout, err := cmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + defer stdout.Close() + if err := cmd.Start(); err != nil { + c.Fatal(err) + } + c.Assert(waitRun(id), check.IsNil) + + if _, err := cpty.Write([]byte("hello\n")); err != nil { + c.Fatal(err) + } + out, err = bufio.NewReader(stdout).ReadString('\n') + if err != nil { + c.Fatal(err) + } + if strings.TrimSpace(out) != "hello" { + c.Fatalf("expected 'hello', got %q", out) + } + + // escape sequence + if _, err := cpty.Write([]byte{16}); err != nil { + c.Fatal(err) + } + time.Sleep(100 * time.Millisecond) + if _, err := cpty.Write([]byte{17}); err != nil { + c.Fatal(err) + } + + ch := make(chan struct{}) + go func() { + cmd.Wait() + ch <- struct{}{} + }() + + running, err := inspectField(id, "State.Running") + if err != nil { + c.Fatal(err) + } + if running != "true" { + c.Fatal("expected container to still be running") + } + + go func() { + dockerCmd(c, "kill", id) + }() + + select { + case <-ch: + case <-time.After(10 * time.Millisecond): + c.Fatal("timed out waiting for container to exit") + } + +} + +// TestAttachDetachTruncatedID checks that attach in tty mode can be detached +func (s *DockerSuite) TestAttachDetachTruncatedID(c *check.C) { + out, _ := dockerCmd(c, "run", "-itd", "busybox", "cat") + id := stringid.TruncateID(strings.TrimSpace(out)) + c.Assert(waitRun(id), check.IsNil) + + cpty, tty, err := pty.Open() + if err != nil { + c.Fatal(err) + } + defer cpty.Close() + + cmd := exec.Command(dockerBinary, "attach", id) + cmd.Stdin = tty + stdout, err := cmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + defer stdout.Close() + if err := cmd.Start(); err != nil { + c.Fatal(err) + } + + if _, err := cpty.Write([]byte("hello\n")); err != nil { + c.Fatal(err) + } + out, err = bufio.NewReader(stdout).ReadString('\n') + if err != nil { + c.Fatal(err) + } + if strings.TrimSpace(out) != "hello" { + c.Fatalf("expected 'hello', got %q", out) + } + + // escape sequence + if _, err := cpty.Write([]byte{16}); err != nil { + c.Fatal(err) + } + time.Sleep(100 * time.Millisecond) + if _, err := cpty.Write([]byte{17}); err != nil { + c.Fatal(err) + } + + ch := make(chan struct{}) + go func() { + cmd.Wait() + ch <- struct{}{} + }() + + running, err := inspectField(id, "State.Running") + if err != nil { + c.Fatal(err) + } + if running != "true" { + c.Fatal("expected container to still be running") + } + + go func() { + dockerCmd(c, "kill", id) + }() + + select { + case <-ch: + case <-time.After(10 * time.Millisecond): + c.Fatal("timed out waiting for container to exit") + } + +} diff --git a/integration-cli/docker_cli_build_test.go b/integration-cli/docker_cli_build_test.go new file mode 100644 index 0000000000..c952ce62a0 --- /dev/null +++ b/integration-cli/docker_cli_build_test.go @@ -0,0 +1,6350 @@ +package main + +import ( + "archive/tar" + "bufio" + "bytes" + "encoding/json" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "reflect" + "regexp" + "runtime" + "strconv" + "strings" + "text/template" + "time" + + "github.com/docker/docker/builder/dockerfile/command" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/stringutils" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestBuildJSONEmptyRun(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildjsonemptyrun" + + _, err := buildImage( + name, + ` + FROM busybox + RUN [] + `, + true) + + if err != nil { + c.Fatal("error when dealing with a RUN statement with empty JSON array") + } + +} + +func (s *DockerSuite) TestBuildEmptyWhitespace(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildemptywhitespace" + + _, err := buildImage( + name, + ` + FROM busybox + COPY + quux \ + bar + `, + true) + + if err == nil { + c.Fatal("no error when dealing with a COPY statement with no content on the same line") + } + +} + +func (s *DockerSuite) TestBuildShCmdJSONEntrypoint(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildshcmdjsonentrypoint" + + _, err := buildImage( + name, + ` + FROM busybox + ENTRYPOINT ["/bin/echo"] + CMD echo test + `, + true) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--rm", name) + + if strings.TrimSpace(out) != "/bin/sh -c echo test" { + c.Fatalf("CMD did not contain /bin/sh -c : %s", out) + } + +} + +func (s *DockerSuite) TestBuildEnvironmentReplacementUser(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvironmentreplacement" + + _, err := buildImage(name, ` + FROM scratch + ENV user foo + USER ${user} + `, true) + if err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name, "Config.User") + if err != nil { + c.Fatal(err) + } + + if res != `"foo"` { + c.Fatal("User foo from environment not in Config.User on image") + } + +} + +func (s *DockerSuite) TestBuildEnvironmentReplacementVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvironmentreplacement" + + _, err := buildImage(name, ` + FROM scratch + ENV volume /quux + VOLUME ${volume} + `, true) + if err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name, "Config.Volumes") + if err != nil { + c.Fatal(err) + } + + var volumes map[string]interface{} + + if err := json.Unmarshal([]byte(res), &volumes); err != nil { + c.Fatal(err) + } + + if _, ok := volumes["/quux"]; !ok { + c.Fatal("Volume /quux from environment not in Config.Volumes on image") + } + +} + +func (s *DockerSuite) TestBuildEnvironmentReplacementExpose(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvironmentreplacement" + + _, err := buildImage(name, ` + FROM scratch + ENV port 80 + EXPOSE ${port} + `, true) + if err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name, "Config.ExposedPorts") + if err != nil { + c.Fatal(err) + } + + var exposedPorts map[string]interface{} + + if err := json.Unmarshal([]byte(res), &exposedPorts); err != nil { + c.Fatal(err) + } + + if _, ok := exposedPorts["80/tcp"]; !ok { + c.Fatal("Exposed port 80 from environment not in Config.ExposedPorts on image") + } + +} + +func (s *DockerSuite) TestBuildEnvironmentReplacementWorkdir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvironmentreplacement" + + _, err := buildImage(name, ` + FROM busybox + ENV MYWORKDIR /work + RUN mkdir ${MYWORKDIR} + WORKDIR ${MYWORKDIR} + `, true) + + if err != nil { + c.Fatal(err) + } + +} + +func (s *DockerSuite) TestBuildEnvironmentReplacementAddCopy(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvironmentreplacement" + + ctx, err := fakeContext(` + FROM scratch + ENV baz foo + ENV quux bar + ENV dot . + ENV fee fff + ENV gee ggg + + ADD ${baz} ${dot} + COPY ${quux} ${dot} + ADD ${zzz:-${fee}} ${dot} + COPY ${zzz:-${gee}} ${dot} + `, + map[string]string{ + "foo": "test1", + "bar": "test2", + "fff": "test3", + "ggg": "test4", + }) + + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + +} + +func (s *DockerSuite) TestBuildEnvironmentReplacementEnv(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvironmentreplacement" + + _, err := buildImage(name, + ` + FROM busybox + ENV foo zzz + ENV bar ${foo} + ENV abc1='$foo' + ENV env1=$foo env2=${foo} env3="$foo" env4="${foo}" + RUN [ "$abc1" = '$foo' ] && (echo "$abc1" | grep -q foo) + ENV abc2="\$foo" + RUN [ "$abc2" = '$foo' ] && (echo "$abc2" | grep -q foo) + ENV abc3 '$foo' + RUN [ "$abc3" = '$foo' ] && (echo "$abc3" | grep -q foo) + ENV abc4 "\$foo" + RUN [ "$abc4" = '$foo' ] && (echo "$abc4" | grep -q foo) + `, true) + + if err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name, "Config.Env") + if err != nil { + c.Fatal(err) + } + + envResult := []string{} + + if err = unmarshalJSON([]byte(res), &envResult); err != nil { + c.Fatal(err) + } + + found := false + envCount := 0 + + for _, env := range envResult { + parts := strings.SplitN(env, "=", 2) + if parts[0] == "bar" { + found = true + if parts[1] != "zzz" { + c.Fatalf("Could not find replaced var for env `bar`: got %q instead of `zzz`", parts[1]) + } + } else if strings.HasPrefix(parts[0], "env") { + envCount++ + if parts[1] != "zzz" { + c.Fatalf("%s should be 'foo' but instead its %q", parts[0], parts[1]) + } + } else if strings.HasPrefix(parts[0], "env") { + envCount++ + if parts[1] != "foo" { + c.Fatalf("%s should be 'foo' but instead its %q", parts[0], parts[1]) + } + } + } + + if !found { + c.Fatal("Never found the `bar` env variable") + } + + if envCount != 4 { + c.Fatalf("Didn't find all env vars - only saw %d\n%s", envCount, envResult) + } + +} + +func (s *DockerSuite) TestBuildHandleEscapes(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildhandleescapes" + + _, err := buildImage(name, + ` + FROM scratch + ENV FOO bar + VOLUME ${FOO} + `, true) + + if err != nil { + c.Fatal(err) + } + + var result map[string]map[string]struct{} + + res, err := inspectFieldJSON(name, "Config.Volumes") + if err != nil { + c.Fatal(err) + } + + if err = unmarshalJSON([]byte(res), &result); err != nil { + c.Fatal(err) + } + + if _, ok := result["bar"]; !ok { + c.Fatal("Could not find volume bar set from env foo in volumes table") + } + + deleteImages(name) + + _, err = buildImage(name, + ` + FROM scratch + ENV FOO bar + VOLUME \${FOO} + `, true) + + if err != nil { + c.Fatal(err) + } + + res, err = inspectFieldJSON(name, "Config.Volumes") + if err != nil { + c.Fatal(err) + } + + if err = unmarshalJSON([]byte(res), &result); err != nil { + c.Fatal(err) + } + + if _, ok := result["${FOO}"]; !ok { + c.Fatal("Could not find volume ${FOO} set from env foo in volumes table") + } + + deleteImages(name) + + // this test in particular provides *7* backslashes and expects 6 to come back. + // Like above, the first escape is swallowed and the rest are treated as + // literals, this one is just less obvious because of all the character noise. + + _, err = buildImage(name, + ` + FROM scratch + ENV FOO bar + VOLUME \\\\\\\${FOO} + `, true) + + if err != nil { + c.Fatal(err) + } + + res, err = inspectFieldJSON(name, "Config.Volumes") + if err != nil { + c.Fatal(err) + } + + if err = unmarshalJSON([]byte(res), &result); err != nil { + c.Fatal(err) + } + + if _, ok := result[`\\\${FOO}`]; !ok { + c.Fatal(`Could not find volume \\\${FOO} set from env foo in volumes table`, result) + } + +} + +func (s *DockerSuite) TestBuildOnBuildLowercase(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildlowercase" + name2 := "testbuildonbuildlowercase2" + + _, err := buildImage(name, + ` + FROM busybox + onbuild run echo quux + `, true) + + if err != nil { + c.Fatal(err) + } + + _, out, err := buildImageWithOut(name2, fmt.Sprintf(` + FROM %s + `, name), true) + + if err != nil { + c.Fatal(err) + } + + if !strings.Contains(out, "quux") { + c.Fatalf("Did not receive the expected echo text, got %s", out) + } + + if strings.Contains(out, "ONBUILD ONBUILD") { + c.Fatalf("Got an ONBUILD ONBUILD error with no error: got %s", out) + } + +} + +func (s *DockerSuite) TestBuildEnvEscapes(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvescapes" + _, err := buildImage(name, + ` + FROM busybox + ENV TEST foo + CMD echo \$ + `, + true) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "-t", name) + + if strings.TrimSpace(out) != "$" { + c.Fatalf("Env TEST was not overwritten with bar when foo was supplied to dockerfile: was %q", strings.TrimSpace(out)) + } + +} + +func (s *DockerSuite) TestBuildEnvOverwrite(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenvoverwrite" + + _, err := buildImage(name, + ` + FROM busybox + ENV TEST foo + CMD echo ${TEST} + `, + true) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "-e", "TEST=bar", "-t", name) + + if strings.TrimSpace(out) != "bar" { + c.Fatalf("Env TEST was not overwritten with bar when foo was supplied to dockerfile: was %q", strings.TrimSpace(out)) + } + +} + +func (s *DockerSuite) TestBuildOnBuildForbiddenMaintainerInSourceImage(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildforbiddenmaintainerinsourceimage" + + out, _ := dockerCmd(c, "create", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "commit", "--run", "{\"OnBuild\":[\"MAINTAINER docker.io\"]}", cleanedContainerID, "onbuild") + + _, err := buildImage(name, + `FROM onbuild`, + true) + if err != nil { + if !strings.Contains(err.Error(), "maintainer isn't allowed as an ONBUILD trigger") { + c.Fatalf("Wrong error %v, must be about MAINTAINER and ONBUILD in source image", err) + } + } else { + c.Fatal("Error must not be nil") + } + +} + +func (s *DockerSuite) TestBuildOnBuildForbiddenFromInSourceImage(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildforbiddenfrominsourceimage" + + out, _ := dockerCmd(c, "create", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "commit", "--run", "{\"OnBuild\":[\"FROM busybox\"]}", cleanedContainerID, "onbuild") + + _, err := buildImage(name, + `FROM onbuild`, + true) + if err != nil { + if !strings.Contains(err.Error(), "from isn't allowed as an ONBUILD trigger") { + c.Fatalf("Wrong error %v, must be about FROM and ONBUILD in source image", err) + } + } else { + c.Fatal("Error must not be nil") + } + +} + +func (s *DockerSuite) TestBuildOnBuildForbiddenChainedInSourceImage(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildforbiddenchainedinsourceimage" + + out, _ := dockerCmd(c, "create", "busybox", "true") + + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "commit", "--run", "{\"OnBuild\":[\"ONBUILD RUN ls\"]}", cleanedContainerID, "onbuild") + + _, err := buildImage(name, + `FROM onbuild`, + true) + if err != nil { + if !strings.Contains(err.Error(), "Chaining ONBUILD via `ONBUILD ONBUILD` isn't allowed") { + c.Fatalf("Wrong error %v, must be about chaining ONBUILD in source image", err) + } + } else { + c.Fatal("Error must not be nil") + } + +} + +func (s *DockerSuite) TestBuildOnBuildCmdEntrypointJSON(c *check.C) { + testRequires(c, DaemonIsLinux) + name1 := "onbuildcmd" + name2 := "onbuildgenerated" + + _, err := buildImage(name1, ` +FROM busybox +ONBUILD CMD ["hello world"] +ONBUILD ENTRYPOINT ["echo"] +ONBUILD RUN ["true"]`, + false) + + if err != nil { + c.Fatal(err) + } + + _, err = buildImage(name2, fmt.Sprintf(`FROM %s`, name1), false) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "-t", name2) + + if !regexp.MustCompile(`(?m)^hello world`).MatchString(out) { + c.Fatal("did not get echo output from onbuild", out) + } + +} + +func (s *DockerSuite) TestBuildOnBuildEntrypointJSON(c *check.C) { + testRequires(c, DaemonIsLinux) + name1 := "onbuildcmd" + name2 := "onbuildgenerated" + + _, err := buildImage(name1, ` +FROM busybox +ONBUILD ENTRYPOINT ["echo"]`, + false) + + if err != nil { + c.Fatal(err) + } + + _, err = buildImage(name2, fmt.Sprintf("FROM %s\nCMD [\"hello world\"]\n", name1), false) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "-t", name2) + + if !regexp.MustCompile(`(?m)^hello world`).MatchString(out) { + c.Fatal("got malformed output from onbuild", out) + } + +} + +func (s *DockerSuite) TestBuildCacheAdd(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildtwoimageswithadd" + server, err := fakeStorage(map[string]string{ + "robots.txt": "hello", + "index.html": "world", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + if _, err := buildImage(name, + fmt.Sprintf(`FROM scratch + ADD %s/robots.txt /`, server.URL()), + true); err != nil { + c.Fatal(err) + } + if err != nil { + c.Fatal(err) + } + deleteImages(name) + _, out, err := buildImageWithOut(name, + fmt.Sprintf(`FROM scratch + ADD %s/index.html /`, server.URL()), + true) + if err != nil { + c.Fatal(err) + } + if strings.Contains(out, "Using cache") { + c.Fatal("2nd build used cache on ADD, it shouldn't") + } + +} + +func (s *DockerSuite) TestBuildLastModified(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildlastmodified" + + server, err := fakeStorage(map[string]string{ + "file": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + var out, out2 string + + dFmt := `FROM busybox +ADD %s/file / +RUN ls -le /file` + + dockerfile := fmt.Sprintf(dFmt, server.URL()) + + if _, out, err = buildImageWithOut(name, dockerfile, false); err != nil { + c.Fatal(err) + } + + originMTime := regexp.MustCompile(`root.*/file.*\n`).FindString(out) + // Make sure our regexp is correct + if strings.Index(originMTime, "/file") < 0 { + c.Fatalf("Missing ls info on 'file':\n%s", out) + } + + // Build it again and make sure the mtime of the file didn't change. + // Wait a few seconds to make sure the time changed enough to notice + time.Sleep(2 * time.Second) + + if _, out2, err = buildImageWithOut(name, dockerfile, false); err != nil { + c.Fatal(err) + } + + newMTime := regexp.MustCompile(`root.*/file.*\n`).FindString(out2) + if newMTime != originMTime { + c.Fatalf("MTime changed:\nOrigin:%s\nNew:%s", originMTime, newMTime) + } + + // Now 'touch' the file and make sure the timestamp DID change this time + // Create a new fakeStorage instead of just using Add() to help windows + server, err = fakeStorage(map[string]string{ + "file": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + dockerfile = fmt.Sprintf(dFmt, server.URL()) + + if _, out2, err = buildImageWithOut(name, dockerfile, false); err != nil { + c.Fatal(err) + } + + newMTime = regexp.MustCompile(`root.*/file.*\n`).FindString(out2) + if newMTime == originMTime { + c.Fatalf("MTime didn't change:\nOrigin:%s\nNew:%s", originMTime, newMTime) + } + +} + +func (s *DockerSuite) TestBuildSixtySteps(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "foobuildsixtysteps" + ctx, err := fakeContext("FROM scratch\n"+strings.Repeat("ADD foo /\n", 60), + map[string]string{ + "foo": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddSingleFileToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddimg" + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio /exists +ADD test_file / +RUN [ $(ls -l /test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /test_file | awk '{print $1}') = '%s' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, expectedFileChmod), + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +// Issue #3960: "ADD src ." hangs +func (s *DockerSuite) TestBuildAddSingleFileToWorkdir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddsinglefiletoworkdir" + ctx, err := fakeContext(`FROM busybox +ADD test_file .`, + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + errChan := make(chan error) + go func() { + _, err := buildImageFromContext(name, ctx, true) + errChan <- err + close(errChan) + }() + select { + case <-time.After(5 * time.Second): + c.Fatal("Build with adding to workdir timed out") + case err := <-errChan: + c.Assert(err, check.IsNil) + } +} + +func (s *DockerSuite) TestBuildAddSingleFileToExistDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddsinglefiletoexistdir" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN mkdir /exists +RUN touch /exists/exists_file +RUN chown -R dockerio.dockerio /exists +ADD test_file /exists/ +RUN [ $(ls -l / | grep exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists/exists_file | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyAddMultipleFiles(c *check.C) { + testRequires(c, DaemonIsLinux) + server, err := fakeStorage(map[string]string{ + "robots.txt": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + name := "testcopymultiplefilestofile" + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN mkdir /exists +RUN touch /exists/exists_file +RUN chown -R dockerio.dockerio /exists +COPY test_file1 test_file2 /exists/ +ADD test_file3 test_file4 %s/robots.txt /exists/ +RUN [ $(ls -l / | grep exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/test_file1 | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists/test_file2 | awk '{print $3":"$4}') = 'root:root' ] + +RUN [ $(ls -l /exists/test_file3 | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists/test_file4 | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists/robots.txt | awk '{print $3":"$4}') = 'root:root' ] + +RUN [ $(ls -l /exists/exists_file | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +`, server.URL()), + map[string]string{ + "test_file1": "test1", + "test_file2": "test2", + "test_file3": "test3", + "test_file4": "test4", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddMultipleFilesToFile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddmultiplefilestofile" + ctx, err := fakeContext(`FROM scratch + ADD file1.txt file2.txt test + `, + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using ADD with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildJSONAddMultipleFilesToFile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testjsonaddmultiplefilestofile" + ctx, err := fakeContext(`FROM scratch + ADD ["file1.txt", "file2.txt", "test"] + `, + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using ADD with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildAddMultipleFilesToFileWild(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddmultiplefilestofilewild" + ctx, err := fakeContext(`FROM scratch + ADD file*.txt test + `, + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using ADD with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildJSONAddMultipleFilesToFileWild(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testjsonaddmultiplefilestofilewild" + ctx, err := fakeContext(`FROM scratch + ADD ["file*.txt", "test"] + `, + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using ADD with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildCopyMultipleFilesToFile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopymultiplefilestofile" + ctx, err := fakeContext(`FROM scratch + COPY file1.txt file2.txt test + `, + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using COPY with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildJSONCopyMultipleFilesToFile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testjsoncopymultiplefilestofile" + ctx, err := fakeContext(`FROM scratch + COPY ["file1.txt", "file2.txt", "test"] + `, + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using COPY with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildAddFileWithWhitespace(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddfilewithwhitespace" + ctx, err := fakeContext(`FROM busybox +RUN mkdir "/test dir" +RUN mkdir "/test_dir" +ADD [ "test file1", "/test_file1" ] +ADD [ "test_file2", "/test file2" ] +ADD [ "test file3", "/test file3" ] +ADD [ "test dir/test_file4", "/test_dir/test_file4" ] +ADD [ "test_dir/test_file5", "/test dir/test_file5" ] +ADD [ "test dir/test_file6", "/test dir/test_file6" ] +RUN [ $(cat "/test_file1") = 'test1' ] +RUN [ $(cat "/test file2") = 'test2' ] +RUN [ $(cat "/test file3") = 'test3' ] +RUN [ $(cat "/test_dir/test_file4") = 'test4' ] +RUN [ $(cat "/test dir/test_file5") = 'test5' ] +RUN [ $(cat "/test dir/test_file6") = 'test6' ]`, + map[string]string{ + "test file1": "test1", + "test_file2": "test2", + "test file3": "test3", + "test dir/test_file4": "test4", + "test_dir/test_file5": "test5", + "test dir/test_file6": "test6", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyFileWithWhitespace(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopyfilewithwhitespace" + ctx, err := fakeContext(`FROM busybox +RUN mkdir "/test dir" +RUN mkdir "/test_dir" +COPY [ "test file1", "/test_file1" ] +COPY [ "test_file2", "/test file2" ] +COPY [ "test file3", "/test file3" ] +COPY [ "test dir/test_file4", "/test_dir/test_file4" ] +COPY [ "test_dir/test_file5", "/test dir/test_file5" ] +COPY [ "test dir/test_file6", "/test dir/test_file6" ] +RUN [ $(cat "/test_file1") = 'test1' ] +RUN [ $(cat "/test file2") = 'test2' ] +RUN [ $(cat "/test file3") = 'test3' ] +RUN [ $(cat "/test_dir/test_file4") = 'test4' ] +RUN [ $(cat "/test dir/test_file5") = 'test5' ] +RUN [ $(cat "/test dir/test_file6") = 'test6' ]`, + map[string]string{ + "test file1": "test1", + "test_file2": "test2", + "test file3": "test3", + "test dir/test_file4": "test4", + "test_dir/test_file5": "test5", + "test dir/test_file6": "test6", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddMultipleFilesToFileWithWhitespace(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddmultiplefilestofilewithwhitespace" + ctx, err := fakeContext(`FROM busybox + ADD [ "test file1", "test file2", "test" ] + `, + map[string]string{ + "test file1": "test1", + "test file2": "test2", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using ADD with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildCopyMultipleFilesToFileWithWhitespace(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopymultiplefilestofilewithwhitespace" + ctx, err := fakeContext(`FROM busybox + COPY [ "test file1", "test file2", "test" ] + `, + map[string]string{ + "test file1": "test1", + "test file2": "test2", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "When using COPY with more than one source file, the destination must be a directory and end with a /" + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain %q) got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildCopyWildcard(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopywildcard" + server, err := fakeStorage(map[string]string{ + "robots.txt": "hello", + "index.html": "world", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox + COPY file*.txt /tmp/ + RUN ls /tmp/file1.txt /tmp/file2.txt + RUN mkdir /tmp1 + COPY dir* /tmp1/ + RUN ls /tmp1/dirt /tmp1/nested_file /tmp1/nested_dir/nest_nest_file + RUN mkdir /tmp2 + ADD dir/*dir %s/robots.txt /tmp2/ + RUN ls /tmp2/nest_nest_file /tmp2/robots.txt + `, server.URL()), + map[string]string{ + "file1.txt": "test1", + "file2.txt": "test2", + "dir/nested_file": "nested file", + "dir/nested_dir/nest_nest_file": "2 times nested", + "dirt": "dirty", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + + // Now make sure we use a cache the 2nd time + id2, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + + if id1 != id2 { + c.Fatal("didn't use the cache") + } + +} + +func (s *DockerSuite) TestBuildCopyWildcardNoFind(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopywildcardnofind" + ctx, err := fakeContext(`FROM busybox + COPY file*.txt /tmp/ + `, nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + _, err = buildImageFromContext(name, ctx, true) + if err == nil { + c.Fatal("should have failed to find a file") + } + if !strings.Contains(err.Error(), "No source files were specified") { + c.Fatalf("Wrong error %v, must be about no source files", err) + } + +} + +func (s *DockerSuite) TestBuildCopyWildcardInName(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopywildcardinname" + ctx, err := fakeContext(`FROM busybox + COPY *.txt /tmp/ + RUN [ "$(cat /tmp/\*.txt)" = 'hi there' ] + `, map[string]string{"*.txt": "hi there"}) + + if err != nil { + // Normally we would do c.Fatal(err) here but given that + // the odds of this failing are so rare, it must be because + // the OS we're running the client on doesn't support * in + // filenames (like windows). So, instead of failing the test + // just let it pass. Then we don't need to explicitly + // say which OSs this works on or not. + return + } + defer ctx.Close() + + _, err = buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatalf("should have built: %q", err) + } +} + +func (s *DockerSuite) TestBuildCopyWildcardCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopywildcardcache" + ctx, err := fakeContext(`FROM busybox + COPY file1.txt /tmp/`, + map[string]string{ + "file1.txt": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + + // Now make sure we use a cache the 2nd time even with wild cards. + // Use the same context so the file is the same and the checksum will match + ctx.Add("Dockerfile", `FROM busybox + COPY file*.txt /tmp/`) + + id2, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + + if id1 != id2 { + c.Fatal("didn't use the cache") + } + +} + +func (s *DockerSuite) TestBuildAddSingleFileToNonExistingDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddsinglefiletononexistingdir" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio /exists +ADD test_file /test_dir/ +RUN [ $(ls -l / | grep test_dir | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /test_dir/test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + +} + +func (s *DockerSuite) TestBuildAddDirContentToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testadddircontenttoroot" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio exists +ADD test_dir / +RUN [ $(ls -l /test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, + map[string]string{ + "test_dir/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddDirContentToExistingDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testadddircontenttoexistingdir" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN mkdir /exists +RUN touch /exists/exists_file +RUN chown -R dockerio.dockerio /exists +ADD test_dir/ /exists/ +RUN [ $(ls -l / | grep exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/exists_file | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/test_file | awk '{print $3":"$4}') = 'root:root' ]`, + map[string]string{ + "test_dir/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddWholeDirToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddwholedirtoroot" + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio exists +ADD test_dir /test_dir +RUN [ $(ls -l / | grep test_dir | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l / | grep test_dir | awk '{print $1}') = 'drwxr-xr-x' ] +RUN [ $(ls -l /test_dir/test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /test_dir/test_file | awk '{print $1}') = '%s' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, expectedFileChmod), + map[string]string{ + "test_dir/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +// Testing #5941 +func (s *DockerSuite) TestBuildAddEtcToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddetctoroot" + ctx, err := fakeContext(`FROM scratch +ADD . /`, + map[string]string{ + "etc/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +// Testing #9401 +func (s *DockerSuite) TestBuildAddPreservesFilesSpecialBits(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testaddpreservesfilesspecialbits" + ctx, err := fakeContext(`FROM busybox +ADD suidbin /usr/bin/suidbin +RUN chmod 4755 /usr/bin/suidbin +RUN [ $(ls -l /usr/bin/suidbin | awk '{print $1}') = '-rwsr-xr-x' ] +ADD ./data/ / +RUN [ $(ls -l /usr/bin/suidbin | awk '{print $1}') = '-rwsr-xr-x' ]`, + map[string]string{ + "suidbin": "suidbin", + "/data/usr/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopySingleFileToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopysinglefiletoroot" + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio /exists +COPY test_file / +RUN [ $(ls -l /test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /test_file | awk '{print $1}') = '%s' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, expectedFileChmod), + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +// Issue #3960: "ADD src ." hangs - adapted for COPY +func (s *DockerSuite) TestBuildCopySingleFileToWorkdir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopysinglefiletoworkdir" + ctx, err := fakeContext(`FROM busybox +COPY test_file .`, + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + errChan := make(chan error) + go func() { + _, err := buildImageFromContext(name, ctx, true) + errChan <- err + close(errChan) + }() + select { + case <-time.After(5 * time.Second): + c.Fatal("Build with adding to workdir timed out") + case err := <-errChan: + c.Assert(err, check.IsNil) + } +} + +func (s *DockerSuite) TestBuildCopySingleFileToExistDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopysinglefiletoexistdir" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN mkdir /exists +RUN touch /exists/exists_file +RUN chown -R dockerio.dockerio /exists +COPY test_file /exists/ +RUN [ $(ls -l / | grep exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists/exists_file | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopySingleFileToNonExistDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopysinglefiletononexistdir" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio /exists +COPY test_file /test_dir/ +RUN [ $(ls -l / | grep test_dir | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /test_dir/test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, + map[string]string{ + "test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyDirContentToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopydircontenttoroot" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio exists +COPY test_dir / +RUN [ $(ls -l /test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, + map[string]string{ + "test_dir/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyDirContentToExistDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopydircontenttoexistdir" + ctx, err := fakeContext(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN mkdir /exists +RUN touch /exists/exists_file +RUN chown -R dockerio.dockerio /exists +COPY test_dir/ /exists/ +RUN [ $(ls -l / | grep exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/exists_file | awk '{print $3":"$4}') = 'dockerio:dockerio' ] +RUN [ $(ls -l /exists/test_file | awk '{print $3":"$4}') = 'root:root' ]`, + map[string]string{ + "test_dir/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyWholeDirToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopywholedirtoroot" + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group +RUN touch /exists +RUN chown dockerio.dockerio exists +COPY test_dir /test_dir +RUN [ $(ls -l / | grep test_dir | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l / | grep test_dir | awk '{print $1}') = 'drwxr-xr-x' ] +RUN [ $(ls -l /test_dir/test_file | awk '{print $3":"$4}') = 'root:root' ] +RUN [ $(ls -l /test_dir/test_file | awk '{print $1}') = '%s' ] +RUN [ $(ls -l /exists | awk '{print $3":"$4}') = 'dockerio:dockerio' ]`, expectedFileChmod), + map[string]string{ + "test_dir/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyEtcToRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopyetctoroot" + ctx, err := fakeContext(`FROM scratch +COPY . /`, + map[string]string{ + "etc/test_file": "test1", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCopyDisallowRemote(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testcopydisallowremote" + _, out, err := buildImageWithOut(name, `FROM scratch +COPY https://index.docker.io/robots.txt /`, + true) + if err == nil || !strings.Contains(out, "Source can't be a URL for COPY") { + c.Fatalf("Error should be about disallowed remote source, got err: %s, out: %q", err, out) + } +} + +func (s *DockerSuite) TestBuildAddBadLinks(c *check.C) { + testRequires(c, DaemonIsLinux) + const ( + dockerfile = ` + FROM scratch + ADD links.tar / + ADD foo.txt /symlink/ + ` + targetFile = "foo.txt" + ) + var ( + name = "test-link-absolute" + ) + ctx, err := fakeContext(dockerfile, nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + tempDir, err := ioutil.TempDir("", "test-link-absolute-temp-") + if err != nil { + c.Fatalf("failed to create temporary directory: %s", tempDir) + } + defer os.RemoveAll(tempDir) + + var symlinkTarget string + if runtime.GOOS == "windows" { + var driveLetter string + if abs, err := filepath.Abs(tempDir); err != nil { + c.Fatal(err) + } else { + driveLetter = abs[:1] + } + tempDirWithoutDrive := tempDir[2:] + symlinkTarget = fmt.Sprintf(`%s:\..\..\..\..\..\..\..\..\..\..\..\..%s`, driveLetter, tempDirWithoutDrive) + } else { + symlinkTarget = fmt.Sprintf("/../../../../../../../../../../../..%s", tempDir) + } + + tarPath := filepath.Join(ctx.Dir, "links.tar") + nonExistingFile := filepath.Join(tempDir, targetFile) + fooPath := filepath.Join(ctx.Dir, targetFile) + + tarOut, err := os.Create(tarPath) + if err != nil { + c.Fatal(err) + } + + tarWriter := tar.NewWriter(tarOut) + + header := &tar.Header{ + Name: "symlink", + Typeflag: tar.TypeSymlink, + Linkname: symlinkTarget, + Mode: 0755, + Uid: 0, + Gid: 0, + } + + err = tarWriter.WriteHeader(header) + if err != nil { + c.Fatal(err) + } + + tarWriter.Close() + tarOut.Close() + + foo, err := os.Create(fooPath) + if err != nil { + c.Fatal(err) + } + defer foo.Close() + + if _, err := foo.WriteString("test"); err != nil { + c.Fatal(err) + } + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + + if _, err := os.Stat(nonExistingFile); err == nil || err != nil && !os.IsNotExist(err) { + c.Fatalf("%s shouldn't have been written and it shouldn't exist", nonExistingFile) + } + +} + +func (s *DockerSuite) TestBuildAddBadLinksVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + const ( + dockerfileTemplate = ` + FROM busybox + RUN ln -s /../../../../../../../../%s /x + VOLUME /x + ADD foo.txt /x/` + targetFile = "foo.txt" + ) + var ( + name = "test-link-absolute-volume" + dockerfile = "" + ) + + tempDir, err := ioutil.TempDir("", "test-link-absolute-volume-temp-") + if err != nil { + c.Fatalf("failed to create temporary directory: %s", tempDir) + } + defer os.RemoveAll(tempDir) + + dockerfile = fmt.Sprintf(dockerfileTemplate, tempDir) + nonExistingFile := filepath.Join(tempDir, targetFile) + + ctx, err := fakeContext(dockerfile, nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + fooPath := filepath.Join(ctx.Dir, targetFile) + + foo, err := os.Create(fooPath) + if err != nil { + c.Fatal(err) + } + defer foo.Close() + + if _, err := foo.WriteString("test"); err != nil { + c.Fatal(err) + } + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + + if _, err := os.Stat(nonExistingFile); err == nil || err != nil && !os.IsNotExist(err) { + c.Fatalf("%s shouldn't have been written and it shouldn't exist", nonExistingFile) + } + +} + +// Issue #5270 - ensure we throw a better error than "unexpected EOF" +// when we can't access files in the context. +func (s *DockerSuite) TestBuildWithInaccessibleFilesInContext(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, UnixCli) // test uses chown/chmod: not available on windows + + { + name := "testbuildinaccessiblefiles" + ctx, err := fakeContext("FROM scratch\nADD . /foo/", map[string]string{"fileWithoutReadAccess": "foo"}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + // This is used to ensure we detect inaccessible files early during build in the cli client + pathToFileWithoutReadAccess := filepath.Join(ctx.Dir, "fileWithoutReadAccess") + + if err = os.Chown(pathToFileWithoutReadAccess, 0, 0); err != nil { + c.Fatalf("failed to chown file to root: %s", err) + } + if err = os.Chmod(pathToFileWithoutReadAccess, 0700); err != nil { + c.Fatalf("failed to chmod file to 700: %s", err) + } + buildCmd := exec.Command("su", "unprivilegeduser", "-c", fmt.Sprintf("%s build -t %s .", dockerBinary, name)) + buildCmd.Dir = ctx.Dir + out, _, err := runCommandWithOutput(buildCmd) + if err == nil { + c.Fatalf("build should have failed: %s %s", err, out) + } + + // check if we've detected the failure before we started building + if !strings.Contains(out, "no permission to read from ") { + c.Fatalf("output should've contained the string: no permission to read from but contained: %s", out) + } + + if !strings.Contains(out, "Error checking context") { + c.Fatalf("output should've contained the string: Error checking context") + } + } + { + name := "testbuildinaccessibledirectory" + ctx, err := fakeContext("FROM scratch\nADD . /foo/", map[string]string{"directoryWeCantStat/bar": "foo"}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + // This is used to ensure we detect inaccessible directories early during build in the cli client + pathToDirectoryWithoutReadAccess := filepath.Join(ctx.Dir, "directoryWeCantStat") + pathToFileInDirectoryWithoutReadAccess := filepath.Join(pathToDirectoryWithoutReadAccess, "bar") + + if err = os.Chown(pathToDirectoryWithoutReadAccess, 0, 0); err != nil { + c.Fatalf("failed to chown directory to root: %s", err) + } + if err = os.Chmod(pathToDirectoryWithoutReadAccess, 0444); err != nil { + c.Fatalf("failed to chmod directory to 444: %s", err) + } + if err = os.Chmod(pathToFileInDirectoryWithoutReadAccess, 0700); err != nil { + c.Fatalf("failed to chmod file to 700: %s", err) + } + + buildCmd := exec.Command("su", "unprivilegeduser", "-c", fmt.Sprintf("%s build -t %s .", dockerBinary, name)) + buildCmd.Dir = ctx.Dir + out, _, err := runCommandWithOutput(buildCmd) + if err == nil { + c.Fatalf("build should have failed: %s %s", err, out) + } + + // check if we've detected the failure before we started building + if !strings.Contains(out, "can't stat") { + c.Fatalf("output should've contained the string: can't access %s", out) + } + + if !strings.Contains(out, "Error checking context") { + c.Fatalf("output should've contained the string: Error checking context\ngot:%s", out) + } + + } + { + name := "testlinksok" + ctx, err := fakeContext("FROM scratch\nADD . /foo/", nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + target := "../../../../../../../../../../../../../../../../../../../azA" + if err := os.Symlink(filepath.Join(ctx.Dir, "g"), target); err != nil { + c.Fatal(err) + } + defer os.Remove(target) + // This is used to ensure we don't follow links when checking if everything in the context is accessible + // This test doesn't require that we run commands as an unprivileged user + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + } + { + name := "testbuildignoredinaccessible" + ctx, err := fakeContext("FROM scratch\nADD . /foo/", + map[string]string{ + "directoryWeCantStat/bar": "foo", + ".dockerignore": "directoryWeCantStat", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + // This is used to ensure we don't try to add inaccessible files when they are ignored by a .dockerignore pattern + pathToDirectoryWithoutReadAccess := filepath.Join(ctx.Dir, "directoryWeCantStat") + pathToFileInDirectoryWithoutReadAccess := filepath.Join(pathToDirectoryWithoutReadAccess, "bar") + if err = os.Chown(pathToDirectoryWithoutReadAccess, 0, 0); err != nil { + c.Fatalf("failed to chown directory to root: %s", err) + } + if err = os.Chmod(pathToDirectoryWithoutReadAccess, 0444); err != nil { + c.Fatalf("failed to chmod directory to 755: %s", err) + } + if err = os.Chmod(pathToFileInDirectoryWithoutReadAccess, 0700); err != nil { + c.Fatalf("failed to chmod file to 444: %s", err) + } + + buildCmd := exec.Command("su", "unprivilegeduser", "-c", fmt.Sprintf("%s build -t %s .", dockerBinary, name)) + buildCmd.Dir = ctx.Dir + if out, _, err := runCommandWithOutput(buildCmd); err != nil { + c.Fatalf("build should have worked: %s %s", err, out) + } + + } +} + +func (s *DockerSuite) TestBuildForceRm(c *check.C) { + testRequires(c, DaemonIsLinux) + containerCountBefore, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + name := "testbuildforcerm" + ctx, err := fakeContext("FROM scratch\nRUN true\nRUN thiswillfail", nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + dockerCmdInDir(c, ctx.Dir, "build", "-t", name, "--force-rm", ".") + + containerCountAfter, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + if containerCountBefore != containerCountAfter { + c.Fatalf("--force-rm shouldn't have left containers behind") + } + +} + +// Test that an infinite sleep during a build is killed if the client disconnects. +// This test is fairly hairy because there are lots of ways to race. +// Strategy: +// * Monitor the output of docker events starting from before +// * Run a 1-year-long sleep from a docker build. +// * When docker events sees container start, close the "docker build" command +// * Wait for docker events to emit a dying event. +func (s *DockerSuite) TestBuildCancellationKillsSleep(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcancellation" + + // (Note: one year, will never finish) + ctx, err := fakeContext("FROM busybox\nRUN sleep 31536000", nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + finish := make(chan struct{}) + defer close(finish) + + eventStart := make(chan struct{}) + eventDie := make(chan struct{}) + containerID := make(chan string) + + startEpoch := daemonTime(c).Unix() + // Watch for events since epoch. + eventsCmd := exec.Command( + dockerBinary, "events", + "--since", strconv.FormatInt(startEpoch, 10)) + stdout, err := eventsCmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + if err := eventsCmd.Start(); err != nil { + c.Fatal(err) + } + defer eventsCmd.Process.Kill() + + // Goroutine responsible for watching start/die events from `docker events` + go func() { + cid := <-containerID + + matchStart := regexp.MustCompile(cid + `(.*) start$`) + matchDie := regexp.MustCompile(cid + `(.*) die$`) + + // + // Read lines of `docker events` looking for container start and stop. + // + scanner := bufio.NewScanner(stdout) + for scanner.Scan() { + switch { + case matchStart.MatchString(scanner.Text()): + close(eventStart) + case matchDie.MatchString(scanner.Text()): + close(eventDie) + } + } + }() + + buildCmd := exec.Command(dockerBinary, "build", "-t", name, ".") + buildCmd.Dir = ctx.Dir + + stdoutBuild, err := buildCmd.StdoutPipe() + if err := buildCmd.Start(); err != nil { + c.Fatalf("failed to run build: %s", err) + } + + matchCID := regexp.MustCompile("Running in ") + scanner := bufio.NewScanner(stdoutBuild) + for scanner.Scan() { + line := scanner.Text() + if ok := matchCID.MatchString(line); ok { + containerID <- line[len(line)-12:] + break + } + } + + select { + case <-time.After(5 * time.Second): + c.Fatal("failed to observe build container start in timely fashion") + case <-eventStart: + // Proceeds from here when we see the container fly past in the + // output of "docker events". + // Now we know the container is running. + } + + // Send a kill to the `docker build` command. + // Causes the underlying build to be cancelled due to socket close. + if err := buildCmd.Process.Kill(); err != nil { + c.Fatalf("error killing build command: %s", err) + } + + // Get the exit status of `docker build`, check it exited because killed. + if err := buildCmd.Wait(); err != nil && !isKilled(err) { + c.Fatalf("wait failed during build run: %T %s", err, err) + } + + select { + case <-time.After(5 * time.Second): + // If we don't get here in a timely fashion, it wasn't killed. + c.Fatal("container cancel did not succeed") + case <-eventDie: + // We saw the container shut down in the `docker events` stream, + // as expected. + } + +} + +func (s *DockerSuite) TestBuildRm(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildrm" + ctx, err := fakeContext("FROM scratch\nADD foo /\nADD foo /", map[string]string{"foo": "bar"}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + { + containerCountBefore, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "--rm", "-t", name, ".") + + if err != nil { + c.Fatal("failed to build the image", out) + } + + containerCountAfter, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + if containerCountBefore != containerCountAfter { + c.Fatalf("-rm shouldn't have left containers behind") + } + deleteImages(name) + } + + { + containerCountBefore, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "-t", name, ".") + + if err != nil { + c.Fatal("failed to build the image", out) + } + + containerCountAfter, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + if containerCountBefore != containerCountAfter { + c.Fatalf("--rm shouldn't have left containers behind") + } + deleteImages(name) + } + + { + containerCountBefore, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "--rm=false", "-t", name, ".") + + if err != nil { + c.Fatal("failed to build the image", out) + } + + containerCountAfter, err := getContainerCount() + if err != nil { + c.Fatalf("failed to get the container count: %s", err) + } + + if containerCountBefore == containerCountAfter { + c.Fatalf("--rm=false should have left containers behind") + } + deleteImages(name) + + } + +} + +func (s *DockerSuite) TestBuildWithVolumes(c *check.C) { + testRequires(c, DaemonIsLinux) + var ( + result map[string]map[string]struct{} + name = "testbuildvolumes" + emptyMap = make(map[string]struct{}) + expected = map[string]map[string]struct{}{ + "/test1": emptyMap, + "/test2": emptyMap, + "/test3": emptyMap, + "/test4": emptyMap, + "/test5": emptyMap, + "/test6": emptyMap, + "[/test7": emptyMap, + "/test8]": emptyMap, + } + ) + _, err := buildImage(name, + `FROM scratch + VOLUME /test1 + VOLUME /test2 + VOLUME /test3 /test4 + VOLUME ["/test5", "/test6"] + VOLUME [/test7 /test8] + `, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectFieldJSON(name, "Config.Volumes") + if err != nil { + c.Fatal(err) + } + + err = unmarshalJSON([]byte(res), &result) + if err != nil { + c.Fatal(err) + } + + equal := reflect.DeepEqual(&result, &expected) + + if !equal { + c.Fatalf("Volumes %s, expected %s", result, expected) + } + +} + +func (s *DockerSuite) TestBuildMaintainer(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildmaintainer" + expected := "dockerio" + _, err := buildImage(name, + `FROM scratch + MAINTAINER dockerio`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Author") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Maintainer %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildUser(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilduser" + expected := "dockerio" + _, err := buildImage(name, + `FROM busybox + RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd + USER dockerio + RUN [ $(whoami) = 'dockerio' ]`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.User") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("User %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildRelativeWorkdir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildrelativeworkdir" + expected := "/test2/test3" + _, err := buildImage(name, + `FROM busybox + RUN [ "$PWD" = '/' ] + WORKDIR test1 + RUN [ "$PWD" = '/test1' ] + WORKDIR /test2 + RUN [ "$PWD" = '/test2' ] + WORKDIR test3 + RUN [ "$PWD" = '/test2/test3' ]`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.WorkingDir") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Workdir %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildWorkdirWithEnvVariables(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildworkdirwithenvvariables" + expected := "/test1/test2" + _, err := buildImage(name, + `FROM busybox + ENV DIRPATH /test1 + ENV SUBDIRNAME test2 + WORKDIR $DIRPATH + WORKDIR $SUBDIRNAME/$MISSING_VAR`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.WorkingDir") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Workdir %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildRelativeCopy(c *check.C) { + // cat /test1/test2/foo gets permission denied for the user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildrelativecopy" + dockerfile := ` + FROM busybox + WORKDIR /test1 + WORKDIR test2 + RUN [ "$PWD" = '/test1/test2' ] + COPY foo ./ + RUN [ "$(cat /test1/test2/foo)" = 'hello' ] + ADD foo ./bar/baz + RUN [ "$(cat /test1/test2/bar/baz)" = 'hello' ] + COPY foo ./bar/baz2 + RUN [ "$(cat /test1/test2/bar/baz2)" = 'hello' ] + WORKDIR .. + COPY foo ./ + RUN [ "$(cat /test1/foo)" = 'hello' ] + COPY foo /test3/ + RUN [ "$(cat /test3/foo)" = 'hello' ] + WORKDIR /test4 + COPY . . + RUN [ "$(cat /test4/foo)" = 'hello' ] + WORKDIR /test5/test6 + COPY foo ../ + RUN [ "$(cat /test5/foo)" = 'hello' ] + ` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + _, err = buildImageFromContext(name, ctx, false) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildEnv(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildenv" + expected := "[PATH=/test:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin PORT=2375]" + _, err := buildImage(name, + `FROM busybox + ENV PATH /test:$PATH + ENV PORT 2375 + RUN [ $(env | grep PORT) = 'PORT=2375' ]`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Env") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Env %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildContextCleanup(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + name := "testbuildcontextcleanup" + entries, err := ioutil.ReadDir(filepath.Join(dockerBasePath, "tmp")) + if err != nil { + c.Fatalf("failed to list contents of tmp dir: %s", err) + } + _, err = buildImage(name, + `FROM scratch + ENTRYPOINT ["/bin/echo"]`, + true) + if err != nil { + c.Fatal(err) + } + entriesFinal, err := ioutil.ReadDir(filepath.Join(dockerBasePath, "tmp")) + if err != nil { + c.Fatalf("failed to list contents of tmp dir: %s", err) + } + if err = compareDirectoryEntries(entries, entriesFinal); err != nil { + c.Fatalf("context should have been deleted, but wasn't") + } + +} + +func (s *DockerSuite) TestBuildContextCleanupFailedBuild(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + name := "testbuildcontextcleanup" + entries, err := ioutil.ReadDir(filepath.Join(dockerBasePath, "tmp")) + if err != nil { + c.Fatalf("failed to list contents of tmp dir: %s", err) + } + _, err = buildImage(name, + `FROM scratch + RUN /non/existing/command`, + true) + if err == nil { + c.Fatalf("expected build to fail, but it didn't") + } + entriesFinal, err := ioutil.ReadDir(filepath.Join(dockerBasePath, "tmp")) + if err != nil { + c.Fatalf("failed to list contents of tmp dir: %s", err) + } + if err = compareDirectoryEntries(entries, entriesFinal); err != nil { + c.Fatalf("context should have been deleted, but wasn't") + } + +} + +func (s *DockerSuite) TestBuildCmd(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcmd" + expected := "{[/bin/echo Hello World]}" + _, err := buildImage(name, + `FROM scratch + CMD ["/bin/echo", "Hello World"]`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Cmd %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildExpose(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildexpose" + expected := "map[2375/tcp:{}]" + _, err := buildImage(name, + `FROM scratch + EXPOSE 2375`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.ExposedPorts") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Exposed ports %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildExposeMorePorts(c *check.C) { + testRequires(c, DaemonIsLinux) + // start building docker file with a large number of ports + portList := make([]string, 50) + line := make([]string, 100) + expectedPorts := make([]int, len(portList)*len(line)) + for i := 0; i < len(portList); i++ { + for j := 0; j < len(line); j++ { + p := i*len(line) + j + 1 + line[j] = strconv.Itoa(p) + expectedPorts[p-1] = p + } + if i == len(portList)-1 { + portList[i] = strings.Join(line, " ") + } else { + portList[i] = strings.Join(line, " ") + ` \` + } + } + + dockerfile := `FROM scratch + EXPOSE {{range .}} {{.}} + {{end}}` + tmpl := template.Must(template.New("dockerfile").Parse(dockerfile)) + buf := bytes.NewBuffer(nil) + tmpl.Execute(buf, portList) + + name := "testbuildexpose" + _, err := buildImage(name, buf.String(), true) + if err != nil { + c.Fatal(err) + } + + // check if all the ports are saved inside Config.ExposedPorts + res, err := inspectFieldJSON(name, "Config.ExposedPorts") + if err != nil { + c.Fatal(err) + } + var exposedPorts map[string]interface{} + if err := json.Unmarshal([]byte(res), &exposedPorts); err != nil { + c.Fatal(err) + } + + for _, p := range expectedPorts { + ep := fmt.Sprintf("%d/tcp", p) + if _, ok := exposedPorts[ep]; !ok { + c.Errorf("Port(%s) is not exposed", ep) + } else { + delete(exposedPorts, ep) + } + } + if len(exposedPorts) != 0 { + c.Errorf("Unexpected extra exposed ports %v", exposedPorts) + } +} + +func (s *DockerSuite) TestBuildExposeOrder(c *check.C) { + testRequires(c, DaemonIsLinux) + buildID := func(name, exposed string) string { + _, err := buildImage(name, fmt.Sprintf(`FROM scratch + EXPOSE %s`, exposed), true) + if err != nil { + c.Fatal(err) + } + id, err := inspectField(name, "Id") + if err != nil { + c.Fatal(err) + } + return id + } + + id1 := buildID("testbuildexpose1", "80 2375") + id2 := buildID("testbuildexpose2", "2375 80") + if id1 != id2 { + c.Errorf("EXPOSE should invalidate the cache only when ports actually changed") + } +} + +func (s *DockerSuite) TestBuildExposeUpperCaseProto(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildexposeuppercaseproto" + expected := "map[5678/udp:{}]" + _, err := buildImage(name, + `FROM scratch + EXPOSE 5678/UDP`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.ExposedPorts") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Exposed ports %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildEmptyEntrypointInheritance(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildentrypointinheritance" + name2 := "testbuildentrypointinheritance2" + + _, err := buildImage(name, + `FROM busybox + ENTRYPOINT ["/bin/echo"]`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Entrypoint") + if err != nil { + c.Fatal(err) + } + + expected := "{[/bin/echo]}" + if res != expected { + c.Fatalf("Entrypoint %s, expected %s", res, expected) + } + + _, err = buildImage(name2, + fmt.Sprintf(`FROM %s + ENTRYPOINT []`, name), + true) + if err != nil { + c.Fatal(err) + } + res, err = inspectField(name2, "Config.Entrypoint") + if err != nil { + c.Fatal(err) + } + + expected = "{[]}" + + if res != expected { + c.Fatalf("Entrypoint %s, expected %s", res, expected) + } + +} + +func (s *DockerSuite) TestBuildEmptyEntrypoint(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildentrypoint" + expected := "{[]}" + + _, err := buildImage(name, + `FROM busybox + ENTRYPOINT []`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Entrypoint") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Entrypoint %s, expected %s", res, expected) + } + +} + +func (s *DockerSuite) TestBuildEntrypoint(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildentrypoint" + expected := "{[/bin/echo]}" + _, err := buildImage(name, + `FROM scratch + ENTRYPOINT ["/bin/echo"]`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Entrypoint") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Entrypoint %s, expected %s", res, expected) + } + +} + +// #6445 ensure ONBUILD triggers aren't committed to grandchildren +func (s *DockerSuite) TestBuildOnBuildLimitedInheritence(c *check.C) { + testRequires(c, DaemonIsLinux) + var ( + out2, out3 string + ) + { + name1 := "testonbuildtrigger1" + dockerfile1 := ` + FROM busybox + RUN echo "GRANDPARENT" + ONBUILD RUN echo "ONBUILD PARENT" + ` + ctx, err := fakeContext(dockerfile1, nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out1, _, err := dockerCmdInDir(c, ctx.Dir, "build", "-t", name1, ".") + if err != nil { + c.Fatalf("build failed to complete: %s, %v", out1, err) + } + } + { + name2 := "testonbuildtrigger2" + dockerfile2 := ` + FROM testonbuildtrigger1 + ` + ctx, err := fakeContext(dockerfile2, nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out2, _, err = dockerCmdInDir(c, ctx.Dir, "build", "-t", name2, ".") + if err != nil { + c.Fatalf("build failed to complete: %s, %v", out2, err) + } + } + { + name3 := "testonbuildtrigger3" + dockerfile3 := ` + FROM testonbuildtrigger2 + ` + ctx, err := fakeContext(dockerfile3, nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out3, _, err = dockerCmdInDir(c, ctx.Dir, "build", "-t", name3, ".") + if err != nil { + c.Fatalf("build failed to complete: %s, %v", out3, err) + } + + } + + // ONBUILD should be run in second build. + if !strings.Contains(out2, "ONBUILD PARENT") { + c.Fatalf("ONBUILD instruction did not run in child of ONBUILD parent") + } + + // ONBUILD should *not* be run in third build. + if strings.Contains(out3, "ONBUILD PARENT") { + c.Fatalf("ONBUILD instruction ran in grandchild of ONBUILD parent") + } + +} + +func (s *DockerSuite) TestBuildWithCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildwithcache" + id1, err := buildImage(name, + `FROM scratch + MAINTAINER dockerio + EXPOSE 5432 + ENTRYPOINT ["/bin/echo"]`, + true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImage(name, + `FROM scratch + MAINTAINER dockerio + EXPOSE 5432 + ENTRYPOINT ["/bin/echo"]`, + true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but hasn't.") + } +} + +func (s *DockerSuite) TestBuildWithoutCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildwithoutcache" + name2 := "testbuildwithoutcache2" + id1, err := buildImage(name, + `FROM scratch + MAINTAINER dockerio + EXPOSE 5432 + ENTRYPOINT ["/bin/echo"]`, + true) + if err != nil { + c.Fatal(err) + } + + id2, err := buildImage(name2, + `FROM scratch + MAINTAINER dockerio + EXPOSE 5432 + ENTRYPOINT ["/bin/echo"]`, + false) + if err != nil { + c.Fatal(err) + } + if id1 == id2 { + c.Fatal("The cache should have been invalided but hasn't.") + } +} + +func (s *DockerSuite) TestBuildConditionalCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildconditionalcache" + + dockerfile := ` + FROM busybox + ADD foo /tmp/` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatalf("Error building #1: %s", err) + } + + if err := ctx.Add("foo", "bye"); err != nil { + c.Fatalf("Error modifying foo: %s", err) + } + + id2, err := buildImageFromContext(name, ctx, false) + if err != nil { + c.Fatalf("Error building #2: %s", err) + } + if id2 == id1 { + c.Fatal("Should not have used the cache") + } + + id3, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatalf("Error building #3: %s", err) + } + if id3 != id2 { + c.Fatal("Should have used the cache") + } +} + +func (s *DockerSuite) TestBuildAddLocalFileWithCache(c *check.C) { + // local files are not owned by the correct user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildaddlocalfilewithcache" + name2 := "testbuildaddlocalfilewithcache2" + dockerfile := ` + FROM busybox + MAINTAINER dockerio + ADD foo /usr/lib/bla/bar + RUN [ "$(cat /usr/lib/bla/bar)" = "hello" ]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but hasn't.") + } +} + +func (s *DockerSuite) TestBuildAddMultipleLocalFileWithCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddmultiplelocalfilewithcache" + name2 := "testbuildaddmultiplelocalfilewithcache2" + dockerfile := ` + FROM busybox + MAINTAINER dockerio + ADD foo Dockerfile /usr/lib/bla/ + RUN [ "$(cat /usr/lib/bla/foo)" = "hello" ]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but hasn't.") + } +} + +func (s *DockerSuite) TestBuildAddLocalFileWithoutCache(c *check.C) { + // local files are not owned by the correct user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildaddlocalfilewithoutcache" + name2 := "testbuildaddlocalfilewithoutcache2" + dockerfile := ` + FROM busybox + MAINTAINER dockerio + ADD foo /usr/lib/bla/bar + RUN [ "$(cat /usr/lib/bla/bar)" = "hello" ]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, false) + if err != nil { + c.Fatal(err) + } + if id1 == id2 { + c.Fatal("The cache should have been invalided but hasn't.") + } +} + +func (s *DockerSuite) TestBuildCopyDirButNotFile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcopydirbutnotfile" + name2 := "testbuildcopydirbutnotfile2" + dockerfile := ` + FROM scratch + COPY dir /tmp/` + ctx, err := fakeContext(dockerfile, map[string]string{ + "dir/foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + // Check that adding file with similar name doesn't mess with cache + if err := ctx.Add("dir_file", "hello2"); err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but wasn't") + } +} + +func (s *DockerSuite) TestBuildAddCurrentDirWithCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddcurrentdirwithcache" + name2 := name + "2" + name3 := name + "3" + name4 := name + "4" + dockerfile := ` + FROM scratch + MAINTAINER dockerio + ADD . /usr/lib/bla` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + // Check that adding file invalidate cache of "ADD ." + if err := ctx.Add("bar", "hello2"); err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, true) + if err != nil { + c.Fatal(err) + } + if id1 == id2 { + c.Fatal("The cache should have been invalided but hasn't.") + } + // Check that changing file invalidate cache of "ADD ." + if err := ctx.Add("foo", "hello1"); err != nil { + c.Fatal(err) + } + id3, err := buildImageFromContext(name3, ctx, true) + if err != nil { + c.Fatal(err) + } + if id2 == id3 { + c.Fatal("The cache should have been invalided but hasn't.") + } + // Check that changing file to same content with different mtime does not + // invalidate cache of "ADD ." + time.Sleep(1 * time.Second) // wait second because of mtime precision + if err := ctx.Add("foo", "hello1"); err != nil { + c.Fatal(err) + } + id4, err := buildImageFromContext(name4, ctx, true) + if err != nil { + c.Fatal(err) + } + if id3 != id4 { + c.Fatal("The cache should have been used but hasn't.") + } +} + +func (s *DockerSuite) TestBuildAddCurrentDirWithoutCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddcurrentdirwithoutcache" + name2 := "testbuildaddcurrentdirwithoutcache2" + dockerfile := ` + FROM scratch + MAINTAINER dockerio + ADD . /usr/lib/bla` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, false) + if err != nil { + c.Fatal(err) + } + if id1 == id2 { + c.Fatal("The cache should have been invalided but hasn't.") + } +} + +func (s *DockerSuite) TestBuildAddRemoteFileWithCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddremotefilewithcache" + server, err := fakeStorage(map[string]string{ + "baz": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + id1, err := buildImage(name, + fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD %s/baz /usr/lib/baz/quux`, server.URL()), + true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImage(name, + fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD %s/baz /usr/lib/baz/quux`, server.URL()), + true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but hasn't.") + } +} + +func (s *DockerSuite) TestBuildAddRemoteFileWithoutCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddremotefilewithoutcache" + name2 := "testbuildaddremotefilewithoutcache2" + server, err := fakeStorage(map[string]string{ + "baz": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + id1, err := buildImage(name, + fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD %s/baz /usr/lib/baz/quux`, server.URL()), + true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImage(name2, + fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD %s/baz /usr/lib/baz/quux`, server.URL()), + false) + if err != nil { + c.Fatal(err) + } + if id1 == id2 { + c.Fatal("The cache should have been invalided but hasn't.") + } +} + +func (s *DockerSuite) TestBuildAddRemoteFileMTime(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddremotefilemtime" + name2 := name + "2" + name3 := name + "3" + + files := map[string]string{"baz": "hello"} + server, err := fakeStorage(files) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + ctx, err := fakeContext(fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD %s/baz /usr/lib/baz/quux`, server.URL()), nil) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + + id2, err := buildImageFromContext(name2, ctx, true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but wasn't - #1") + } + + // Now create a different server with same contents (causes different mtime) + // The cache should still be used + + // allow some time for clock to pass as mtime precision is only 1s + time.Sleep(2 * time.Second) + + server2, err := fakeStorage(files) + if err != nil { + c.Fatal(err) + } + defer server2.Close() + + ctx2, err := fakeContext(fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD %s/baz /usr/lib/baz/quux`, server2.URL()), nil) + if err != nil { + c.Fatal(err) + } + defer ctx2.Close() + id3, err := buildImageFromContext(name3, ctx2, true) + if err != nil { + c.Fatal(err) + } + if id1 != id3 { + c.Fatal("The cache should have been used but wasn't") + } +} + +func (s *DockerSuite) TestBuildAddLocalAndRemoteFilesWithCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddlocalandremotefilewithcache" + server, err := fakeStorage(map[string]string{ + "baz": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + ctx, err := fakeContext(fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD foo /usr/lib/bla/bar + ADD %s/baz /usr/lib/baz/quux`, server.URL()), + map[string]string{ + "foo": "hello world", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + if id1 != id2 { + c.Fatal("The cache should have been used but hasn't.") + } +} + +func testContextTar(c *check.C, compression archive.Compression) { + testRequires(c, DaemonIsLinux) + ctx, err := fakeContext( + `FROM busybox +ADD foo /foo +CMD ["cat", "/foo"]`, + map[string]string{ + "foo": "bar", + }, + ) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + context, err := archive.Tar(ctx.Dir, compression) + if err != nil { + c.Fatalf("failed to build context tar: %v", err) + } + name := "contexttar" + buildCmd := exec.Command(dockerBinary, "build", "-t", name, "-") + buildCmd.Stdin = context + + if out, _, err := runCommandWithOutput(buildCmd); err != nil { + c.Fatalf("build failed to complete: %v %v", out, err) + } +} + +func (s *DockerSuite) TestBuildContextTarGzip(c *check.C) { + testContextTar(c, archive.Gzip) +} + +func (s *DockerSuite) TestBuildContextTarNoCompression(c *check.C) { + testContextTar(c, archive.Uncompressed) +} + +func (s *DockerSuite) TestBuildNoContext(c *check.C) { + testRequires(c, DaemonIsLinux) + buildCmd := exec.Command(dockerBinary, "build", "-t", "nocontext", "-") + buildCmd.Stdin = strings.NewReader("FROM busybox\nCMD echo ok\n") + + if out, _, err := runCommandWithOutput(buildCmd); err != nil { + c.Fatalf("build failed to complete: %v %v", out, err) + } + + if out, _ := dockerCmd(c, "run", "--rm", "nocontext"); out != "ok\n" { + c.Fatalf("run produced invalid output: %q, expected %q", out, "ok") + } +} + +// TODO: TestCaching +func (s *DockerSuite) TestBuildAddLocalAndRemoteFilesWithoutCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddlocalandremotefilewithoutcache" + name2 := "testbuildaddlocalandremotefilewithoutcache2" + server, err := fakeStorage(map[string]string{ + "baz": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + ctx, err := fakeContext(fmt.Sprintf(`FROM scratch + MAINTAINER dockerio + ADD foo /usr/lib/bla/bar + ADD %s/baz /usr/lib/baz/quux`, server.URL()), + map[string]string{ + "foo": "hello world", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + id1, err := buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } + id2, err := buildImageFromContext(name2, ctx, false) + if err != nil { + c.Fatal(err) + } + if id1 == id2 { + c.Fatal("The cache should have been invalided but hasn't.") + } +} + +func (s *DockerSuite) TestBuildWithVolumeOwnership(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildimg" + + _, err := buildImage(name, + `FROM busybox:latest + RUN mkdir /test && chown daemon:daemon /test && chmod 0600 /test + VOLUME /test`, + true) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--rm", "testbuildimg", "ls", "-la", "/test") + + if expected := "drw-------"; !strings.Contains(out, expected) { + c.Fatalf("expected %s received %s", expected, out) + } + + if expected := "daemon daemon"; !strings.Contains(out, expected) { + c.Fatalf("expected %s received %s", expected, out) + } + +} + +// testing #1405 - config.Cmd does not get cleaned up if +// utilizing cache +func (s *DockerSuite) TestBuildEntrypointRunCleanup(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcmdcleanup" + if _, err := buildImage(name, + `FROM busybox + RUN echo "hello"`, + true); err != nil { + c.Fatal(err) + } + + ctx, err := fakeContext(`FROM busybox + RUN echo "hello" + ADD foo /foo + ENTRYPOINT ["/bin/echo"]`, + map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + // Cmd must be cleaned up + if res != "" { + c.Fatalf("Cmd %s, expected nil", res) + } +} + +func (s *DockerSuite) TestBuildForbiddenContextPath(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildforbidpath" + ctx, err := fakeContext(`FROM scratch + ADD ../../ test/ + `, + map[string]string{ + "test.txt": "test1", + "other.txt": "other", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + expected := "Forbidden path outside the build context: ../../ " + if _, err := buildImageFromContext(name, ctx, true); err == nil || !strings.Contains(err.Error(), expected) { + c.Fatalf("Wrong error: (should contain \"%s\") got:\n%v", expected, err) + } + +} + +func (s *DockerSuite) TestBuildAddFileNotFound(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddnotfound" + ctx, err := fakeContext(`FROM scratch + ADD foo /usr/local/bar`, + map[string]string{"bar": "hello"}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err := buildImageFromContext(name, ctx, true); err != nil { + if !strings.Contains(err.Error(), "foo: no such file or directory") { + c.Fatalf("Wrong error %v, must be about missing foo file or directory", err) + } + } else { + c.Fatal("Error must not be nil") + } +} + +func (s *DockerSuite) TestBuildInheritance(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildinheritance" + + _, err := buildImage(name, + `FROM scratch + EXPOSE 2375`, + true) + if err != nil { + c.Fatal(err) + } + ports1, err := inspectField(name, "Config.ExposedPorts") + if err != nil { + c.Fatal(err) + } + + _, err = buildImage(name, + fmt.Sprintf(`FROM %s + ENTRYPOINT ["/bin/echo"]`, name), + true) + if err != nil { + c.Fatal(err) + } + + res, err := inspectField(name, "Config.Entrypoint") + if err != nil { + c.Fatal(err) + } + if expected := "{[/bin/echo]}"; res != expected { + c.Fatalf("Entrypoint %s, expected %s", res, expected) + } + ports2, err := inspectField(name, "Config.ExposedPorts") + if err != nil { + c.Fatal(err) + } + if ports1 != ports2 { + c.Fatalf("Ports must be same: %s != %s", ports1, ports2) + } +} + +func (s *DockerSuite) TestBuildFails(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildfails" + _, err := buildImage(name, + `FROM busybox + RUN sh -c "exit 23"`, + true) + if err != nil { + if !strings.Contains(err.Error(), "returned a non-zero code: 23") { + c.Fatalf("Wrong error %v, must be about non-zero code 23", err) + } + } else { + c.Fatal("Error must not be nil") + } +} + +func (s *DockerSuite) TestBuildFailsDockerfileEmpty(c *check.C) { + name := "testbuildfails" + _, err := buildImage(name, ``, true) + if err != nil { + if !strings.Contains(err.Error(), "The Dockerfile (Dockerfile) cannot be empty") { + c.Fatalf("Wrong error %v, must be about empty Dockerfile", err) + } + } else { + c.Fatal("Error must not be nil") + } +} + +func (s *DockerSuite) TestBuildOnBuild(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuild" + _, err := buildImage(name, + `FROM busybox + ONBUILD RUN touch foobar`, + true) + if err != nil { + c.Fatal(err) + } + _, err = buildImage(name, + fmt.Sprintf(`FROM %s + RUN [ -f foobar ]`, name), + true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildOnBuildForbiddenChained(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildforbiddenchained" + _, err := buildImage(name, + `FROM busybox + ONBUILD ONBUILD RUN touch foobar`, + true) + if err != nil { + if !strings.Contains(err.Error(), "Chaining ONBUILD via `ONBUILD ONBUILD` isn't allowed") { + c.Fatalf("Wrong error %v, must be about chaining ONBUILD", err) + } + } else { + c.Fatal("Error must not be nil") + } +} + +func (s *DockerSuite) TestBuildOnBuildForbiddenFrom(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildforbiddenfrom" + _, err := buildImage(name, + `FROM busybox + ONBUILD FROM scratch`, + true) + if err != nil { + if !strings.Contains(err.Error(), "FROM isn't allowed as an ONBUILD trigger") { + c.Fatalf("Wrong error %v, must be about FROM forbidden", err) + } + } else { + c.Fatal("Error must not be nil") + } +} + +func (s *DockerSuite) TestBuildOnBuildForbiddenMaintainer(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildforbiddenmaintainer" + _, err := buildImage(name, + `FROM busybox + ONBUILD MAINTAINER docker.io`, + true) + if err != nil { + if !strings.Contains(err.Error(), "MAINTAINER isn't allowed as an ONBUILD trigger") { + c.Fatalf("Wrong error %v, must be about MAINTAINER forbidden", err) + } + } else { + c.Fatal("Error must not be nil") + } +} + +// gh #2446 +func (s *DockerSuite) TestBuildAddToSymlinkDest(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddtosymlinkdest" + ctx, err := fakeContext(`FROM busybox + RUN mkdir /foo + RUN ln -s /foo /bar + ADD foo /bar/ + RUN [ -f /bar/foo ] + RUN [ -f /foo/foo ]`, + map[string]string{ + "foo": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildEscapeWhitespace(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildescaping" + + _, err := buildImage(name, ` + FROM busybox + MAINTAINER "Docker \ +IO " + `, true) + if err != nil { + c.Fatal(err) + } + + res, err := inspectField(name, "Author") + + if err != nil { + c.Fatal(err) + } + + if res != "\"Docker IO \"" { + c.Fatalf("Parsed string did not match the escaped string. Got: %q", res) + } + +} + +func (s *DockerSuite) TestBuildVerifyIntString(c *check.C) { + testRequires(c, DaemonIsLinux) + // Verify that strings that look like ints are still passed as strings + name := "testbuildstringing" + + _, err := buildImage(name, ` + FROM busybox + MAINTAINER 123 + `, true) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "inspect", name) + + if !strings.Contains(out, "\"123\"") { + c.Fatalf("Output does not contain the int as a string:\n%s", out) + } + +} + +func (s *DockerSuite) TestBuildDockerignore(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignore" + dockerfile := ` + FROM busybox + ADD . /bla + RUN [[ -f /bla/src/x.go ]] + RUN [[ -f /bla/Makefile ]] + RUN [[ ! -e /bla/src/_vendor ]] + RUN [[ ! -e /bla/.gitignore ]] + RUN [[ ! -e /bla/README.md ]] + RUN [[ ! -e /bla/dir/foo ]] + RUN [[ ! -e /bla/foo ]] + RUN [[ ! -e /bla/.git ]]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Makefile": "all:", + ".git/HEAD": "ref: foo", + "src/x.go": "package main", + "src/_vendor/v.go": "package main", + "dir/foo": "", + ".gitignore": "", + "README.md": "readme", + ".dockerignore": ` +.git +pkg +.gitignore +src/_vendor +*.md +dir`, + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildDockerignoreCleanPaths(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignorecleanpaths" + dockerfile := ` + FROM busybox + ADD . /tmp/ + RUN (! ls /tmp/foo) && (! ls /tmp/foo2) && (! ls /tmp/dir1/foo)` + ctx, err := fakeContext(dockerfile, map[string]string{ + "foo": "foo", + "foo2": "foo2", + "dir1/foo": "foo in dir1", + ".dockerignore": "./foo\ndir1//foo\n./dir1/../foo2", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildDockerignoreExceptions(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignoreexceptions" + dockerfile := ` + FROM busybox + ADD . /bla + RUN [[ -f /bla/src/x.go ]] + RUN [[ -f /bla/Makefile ]] + RUN [[ ! -e /bla/src/_vendor ]] + RUN [[ ! -e /bla/.gitignore ]] + RUN [[ ! -e /bla/README.md ]] + RUN [[ -e /bla/dir/dir/foo ]] + RUN [[ ! -e /bla/dir/foo1 ]] + RUN [[ -f /bla/dir/e ]] + RUN [[ -f /bla/dir/e-dir/foo ]] + RUN [[ ! -e /bla/foo ]] + RUN [[ ! -e /bla/.git ]]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Makefile": "all:", + ".git/HEAD": "ref: foo", + "src/x.go": "package main", + "src/_vendor/v.go": "package main", + "dir/foo": "", + "dir/foo1": "", + "dir/dir/f1": "", + "dir/dir/foo": "", + "dir/e": "", + "dir/e-dir/foo": "", + ".gitignore": "", + "README.md": "readme", + ".dockerignore": ` +.git +pkg +.gitignore +src/_vendor +*.md +dir +!dir/e* +!dir/dir/foo`, + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildDockerignoringDockerfile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignoredockerfile" + dockerfile := ` + FROM busybox + ADD . /tmp/ + RUN ! ls /tmp/Dockerfile + RUN ls /tmp/.dockerignore` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Dockerfile": dockerfile, + ".dockerignore": "Dockerfile\n", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't ignore Dockerfile correctly:%s", err) + } + + // now try it with ./Dockerfile + ctx.Add(".dockerignore", "./Dockerfile\n") + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't ignore ./Dockerfile correctly:%s", err) + } + +} + +func (s *DockerSuite) TestBuildDockerignoringRenamedDockerfile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignoredockerfile" + dockerfile := ` + FROM busybox + ADD . /tmp/ + RUN ls /tmp/Dockerfile + RUN ! ls /tmp/MyDockerfile + RUN ls /tmp/.dockerignore` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Dockerfile": "Should not use me", + "MyDockerfile": dockerfile, + ".dockerignore": "MyDockerfile\n", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't ignore MyDockerfile correctly:%s", err) + } + + // now try it with ./MyDockerfile + ctx.Add(".dockerignore", "./MyDockerfile\n") + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't ignore ./MyDockerfile correctly:%s", err) + } + +} + +func (s *DockerSuite) TestBuildDockerignoringDockerignore(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignoredockerignore" + dockerfile := ` + FROM busybox + ADD . /tmp/ + RUN ! ls /tmp/.dockerignore + RUN ls /tmp/Dockerfile` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Dockerfile": dockerfile, + ".dockerignore": ".dockerignore\n", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't ignore .dockerignore correctly:%s", err) + } +} + +func (s *DockerSuite) TestBuildDockerignoreTouchDockerfile(c *check.C) { + testRequires(c, DaemonIsLinux) + var id1 string + var id2 string + + name := "testbuilddockerignoretouchdockerfile" + dockerfile := ` + FROM busybox + ADD . /tmp/` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Dockerfile": dockerfile, + ".dockerignore": "Dockerfile\n", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if id1, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't build it correctly:%s", err) + } + + if id2, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't build it correctly:%s", err) + } + if id1 != id2 { + c.Fatalf("Didn't use the cache - 1") + } + + // Now make sure touching Dockerfile doesn't invalidate the cache + if err = ctx.Add("Dockerfile", dockerfile+"\n# hi"); err != nil { + c.Fatalf("Didn't add Dockerfile: %s", err) + } + if id2, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't build it correctly:%s", err) + } + if id1 != id2 { + c.Fatalf("Didn't use the cache - 2") + } + + // One more time but just 'touch' it instead of changing the content + if err = ctx.Add("Dockerfile", dockerfile+"\n# hi"); err != nil { + c.Fatalf("Didn't add Dockerfile: %s", err) + } + if id2, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("Didn't build it correctly:%s", err) + } + if id1 != id2 { + c.Fatalf("Didn't use the cache - 3") + } + +} + +func (s *DockerSuite) TestBuildDockerignoringWholeDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignorewholedir" + dockerfile := ` + FROM busybox + COPY . / + RUN [[ ! -e /.gitignore ]] + RUN [[ -f /Makefile ]]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Dockerfile": "FROM scratch", + "Makefile": "all:", + ".gitignore": "", + ".dockerignore": ".*\n", + }) + c.Assert(err, check.IsNil) + defer ctx.Close() + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + + c.Assert(ctx.Add(".dockerfile", "*"), check.IsNil) + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + + c.Assert(ctx.Add(".dockerfile", "."), check.IsNil) + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + + c.Assert(ctx.Add(".dockerfile", "?"), check.IsNil) + if _, err = buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildDockerignoringBadExclusion(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilddockerignorewholedir" + dockerfile := ` + FROM busybox + COPY . / + RUN [[ ! -e /.gitignore ]] + RUN [[ -f /Makefile ]]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "Dockerfile": "FROM scratch", + "Makefile": "all:", + ".gitignore": "", + ".dockerignore": "!\n", + }) + c.Assert(err, check.IsNil) + defer ctx.Close() + if _, err = buildImageFromContext(name, ctx, true); err == nil { + c.Fatalf("Build was supposed to fail but didn't") + } + + if err.Error() != "failed to build the image: Error checking context: 'Illegal exclusion pattern: !'.\n" { + c.Fatalf("Incorrect output, got:%q", err.Error()) + } +} + +func (s *DockerSuite) TestBuildLineBreak(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildlinebreak" + _, err := buildImage(name, + `FROM busybox +RUN sh -c 'echo root:testpass \ + > /tmp/passwd' +RUN mkdir -p /var/run/sshd +RUN [ "$(cat /tmp/passwd)" = "root:testpass" ] +RUN [ "$(ls -d /var/run/sshd)" = "/var/run/sshd" ]`, + true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildEOLInLine(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildeolinline" + _, err := buildImage(name, + `FROM busybox +RUN sh -c 'echo root:testpass > /tmp/passwd' +RUN echo "foo \n bar"; echo "baz" +RUN mkdir -p /var/run/sshd +RUN [ "$(cat /tmp/passwd)" = "root:testpass" ] +RUN [ "$(ls -d /var/run/sshd)" = "/var/run/sshd" ]`, + true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildCommentsShebangs(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcomments" + _, err := buildImage(name, + `FROM busybox +# This is an ordinary comment. +RUN { echo '#!/bin/sh'; echo 'echo hello world'; } > /hello.sh +RUN [ ! -x /hello.sh ] +# comment with line break \ +RUN chmod +x /hello.sh +RUN [ -x /hello.sh ] +RUN [ "$(cat /hello.sh)" = $'#!/bin/sh\necho hello world' ] +RUN [ "$(/hello.sh)" = "hello world" ]`, + true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildUsersAndGroups(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildusers" + _, err := buildImage(name, + `FROM busybox + +# Make sure our defaults work +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)" = '0:0/root:root' ] + +# TODO decide if "args.user = strconv.Itoa(syscall.Getuid())" is acceptable behavior for changeUser in sysvinit instead of "return nil" when "USER" isn't specified (so that we get the proper group list even if that is the empty list, even in the default case of not supplying an explicit USER to run as, which implies USER 0) +USER root +RUN [ "$(id -G):$(id -Gn)" = '0 10:root wheel' ] + +# Setup dockerio user and group +RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd +RUN echo 'dockerio:x:1001:' >> /etc/group + +# Make sure we can switch to our user and all the information is exactly as we expect it to be +USER dockerio +RUN id -G +RUN id -Gn +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001:dockerio' ] + +# Switch back to root and double check that worked exactly as we might expect it to +USER root +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '0:0/root:root/0 10:root wheel' ] + +# Add a "supplementary" group for our dockerio user +RUN echo 'supplementary:x:1002:dockerio' >> /etc/group + +# ... and then go verify that we get it like we expect +USER dockerio +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001 1002:dockerio supplementary' ] +USER 1001 +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001 1002:dockerio supplementary' ] + +# super test the new "user:group" syntax +USER dockerio:dockerio +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001:dockerio' ] +USER 1001:dockerio +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001:dockerio' ] +USER dockerio:1001 +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001:dockerio' ] +USER 1001:1001 +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1001/dockerio:dockerio/1001:dockerio' ] +USER dockerio:supplementary +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1002/dockerio:supplementary/1002:supplementary' ] +USER dockerio:1002 +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1002/dockerio:supplementary/1002:supplementary' ] +USER 1001:supplementary +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1002/dockerio:supplementary/1002:supplementary' ] +USER 1001:1002 +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1001:1002/dockerio:supplementary/1002:supplementary' ] + +# make sure unknown uid/gid still works properly +USER 1042:1043 +RUN [ "$(id -u):$(id -g)/$(id -un):$(id -gn)/$(id -G):$(id -Gn)" = '1042:1043/1042:1043/1043:1043' ]`, + true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildEnvUsage(c *check.C) { + // /docker/world/hello is not owned by the correct user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildenvusage" + dockerfile := `FROM busybox +ENV HOME /root +ENV PATH $HOME/bin:$PATH +ENV PATH /tmp:$PATH +RUN [ "$PATH" = "/tmp:$HOME/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ] +ENV FOO /foo/baz +ENV BAR /bar +ENV BAZ $BAR +ENV FOOPATH $PATH:$FOO +RUN [ "$BAR" = "$BAZ" ] +RUN [ "$FOOPATH" = "$PATH:/foo/baz" ] +ENV FROM hello/docker/world +ENV TO /docker/world/hello +ADD $FROM $TO +RUN [ "$(cat $TO)" = "hello" ] +ENV abc=def +ENV ghi=$abc +RUN [ "$ghi" = "def" ] +` + ctx, err := fakeContext(dockerfile, map[string]string{ + "hello/docker/world": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + _, err = buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildEnvUsage2(c *check.C) { + // /docker/world/hello is not owned by the correct user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildenvusage2" + dockerfile := `FROM busybox +ENV abc=def +RUN [ "$abc" = "def" ] +ENV def="hello world" +RUN [ "$def" = "hello world" ] +ENV def=hello\ world +RUN [ "$def" = "hello world" ] +ENV v1=abc v2="hi there" +RUN [ "$v1" = "abc" ] +RUN [ "$v2" = "hi there" ] +ENV v3='boogie nights' v4="with'quotes too" +RUN [ "$v3" = "boogie nights" ] +RUN [ "$v4" = "with'quotes too" ] +ENV abc=zzz FROM=hello/docker/world +ENV abc=zzz TO=/docker/world/hello +ADD $FROM $TO +RUN [ "$(cat $TO)" = "hello" ] +ENV abc "zzz" +RUN [ $abc = "zzz" ] +ENV abc 'yyy' +RUN [ $abc = 'yyy' ] +ENV abc= +RUN [ "$abc" = "" ] + +# use grep to make sure if the builder substitutes \$foo by mistake +# we don't get a false positive +ENV abc=\$foo +RUN [ "$abc" = "\$foo" ] && (echo "$abc" | grep foo) +ENV abc \$foo +RUN [ "$abc" = "\$foo" ] && (echo "$abc" | grep foo) + +ENV abc=\'foo\' +RUN [ "$abc" = "'foo'" ] +ENV abc=\"foo\" +RUN [ "$abc" = "\"foo\"" ] +ENV abc "foo" +RUN [ "$abc" = "foo" ] +ENV abc 'foo' +RUN [ "$abc" = 'foo' ] +ENV abc \'foo\' +RUN [ "$abc" = "'foo'" ] +ENV abc \"foo\" +RUN [ "$abc" = '"foo"' ] + +ENV abc=ABC +RUN [ "$abc" = "ABC" ] +ENV def=${abc:-DEF} +RUN [ "$def" = "ABC" ] +ENV def=${ccc:-DEF} +RUN [ "$def" = "DEF" ] +ENV def=${ccc:-${def}xx} +RUN [ "$def" = "DEFxx" ] +ENV def=${def:+ALT} +RUN [ "$def" = "ALT" ] +ENV def=${def:+${abc}:} +RUN [ "$def" = "ABC:" ] +ENV def=${ccc:-\$abc:} +RUN [ "$def" = '$abc:' ] +ENV def=${ccc:-\${abc}:} +RUN [ "$def" = '${abc:}' ] +ENV mypath=${mypath:+$mypath:}/home +RUN [ "$mypath" = '/home' ] +ENV mypath=${mypath:+$mypath:}/away +RUN [ "$mypath" = '/home:/away' ] + +ENV e1=bar +ENV e2=$e1 +ENV e3=$e11 +ENV e4=\$e1 +ENV e5=\$e11 +RUN [ "$e0,$e1,$e2,$e3,$e4,$e5" = ',bar,bar,,$e1,$e11' ] + +ENV ee1 bar +ENV ee2 $ee1 +ENV ee3 $ee11 +ENV ee4 \$ee1 +ENV ee5 \$ee11 +RUN [ "$ee1,$ee2,$ee3,$ee4,$ee5" = 'bar,bar,,$ee1,$ee11' ] + +ENV eee1="foo" +ENV eee2='foo' +ENV eee3 "foo" +ENV eee4 'foo' +RUN [ "$eee1,$eee2,$eee3,$eee4" = 'foo,foo,foo,foo' ] + +` + ctx, err := fakeContext(dockerfile, map[string]string{ + "hello/docker/world": "hello", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + _, err = buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddScript(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddscript" + dockerfile := ` +FROM busybox +ADD test /test +RUN ["chmod","+x","/test"] +RUN ["/test"] +RUN [ "$(cat /testfile)" = 'test!' ]` + ctx, err := fakeContext(dockerfile, map[string]string{ + "test": "#!/bin/sh\necho 'test!' > /testfile", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + _, err = buildImageFromContext(name, ctx, true) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestBuildAddTar(c *check.C) { + // /test/foo is not owned by the correct user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildaddtar" + + ctx := func() *FakeContext { + dockerfile := ` +FROM busybox +ADD test.tar / +RUN cat /test/foo | grep Hi +ADD test.tar /test.tar +RUN cat /test.tar/test/foo | grep Hi +ADD test.tar /unlikely-to-exist +RUN cat /unlikely-to-exist/test/foo | grep Hi +ADD test.tar /unlikely-to-exist-trailing-slash/ +RUN cat /unlikely-to-exist-trailing-slash/test/foo | grep Hi +RUN mkdir /existing-directory +ADD test.tar /existing-directory +RUN cat /existing-directory/test/foo | grep Hi +ADD test.tar /existing-directory-trailing-slash/ +RUN cat /existing-directory-trailing-slash/test/foo | grep Hi` + tmpDir, err := ioutil.TempDir("", "fake-context") + c.Assert(err, check.IsNil) + testTar, err := os.Create(filepath.Join(tmpDir, "test.tar")) + if err != nil { + c.Fatalf("failed to create test.tar archive: %v", err) + } + defer testTar.Close() + + tw := tar.NewWriter(testTar) + + if err := tw.WriteHeader(&tar.Header{ + Name: "test/foo", + Size: 2, + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write([]byte("Hi")); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + if err := ioutil.WriteFile(filepath.Join(tmpDir, "Dockerfile"), []byte(dockerfile), 0644); err != nil { + c.Fatalf("failed to open destination dockerfile: %v", err) + } + return fakeContextFromDir(tmpDir) + }() + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("build failed to complete for TestBuildAddTar: %v", err) + } + +} + +func (s *DockerSuite) TestBuildAddTarXz(c *check.C) { + // /test/foo is not owned by the correct user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildaddtarxz" + + ctx := func() *FakeContext { + dockerfile := ` + FROM busybox + ADD test.tar.xz / + RUN cat /test/foo | grep Hi` + tmpDir, err := ioutil.TempDir("", "fake-context") + c.Assert(err, check.IsNil) + testTar, err := os.Create(filepath.Join(tmpDir, "test.tar")) + if err != nil { + c.Fatalf("failed to create test.tar archive: %v", err) + } + defer testTar.Close() + + tw := tar.NewWriter(testTar) + + if err := tw.WriteHeader(&tar.Header{ + Name: "test/foo", + Size: 2, + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write([]byte("Hi")); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + xzCompressCmd := exec.Command("xz", "-k", "test.tar") + xzCompressCmd.Dir = tmpDir + out, _, err := runCommandWithOutput(xzCompressCmd) + if err != nil { + c.Fatal(err, out) + } + + if err := ioutil.WriteFile(filepath.Join(tmpDir, "Dockerfile"), []byte(dockerfile), 0644); err != nil { + c.Fatalf("failed to open destination dockerfile: %v", err) + } + return fakeContextFromDir(tmpDir) + }() + + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("build failed to complete for TestBuildAddTarXz: %v", err) + } + +} + +func (s *DockerSuite) TestBuildAddTarXzGz(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildaddtarxzgz" + + ctx := func() *FakeContext { + dockerfile := ` + FROM busybox + ADD test.tar.xz.gz / + RUN ls /test.tar.xz.gz` + tmpDir, err := ioutil.TempDir("", "fake-context") + c.Assert(err, check.IsNil) + testTar, err := os.Create(filepath.Join(tmpDir, "test.tar")) + if err != nil { + c.Fatalf("failed to create test.tar archive: %v", err) + } + defer testTar.Close() + + tw := tar.NewWriter(testTar) + + if err := tw.WriteHeader(&tar.Header{ + Name: "test/foo", + Size: 2, + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write([]byte("Hi")); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + xzCompressCmd := exec.Command("xz", "-k", "test.tar") + xzCompressCmd.Dir = tmpDir + out, _, err := runCommandWithOutput(xzCompressCmd) + if err != nil { + c.Fatal(err, out) + } + + gzipCompressCmd := exec.Command("gzip", "test.tar.xz") + gzipCompressCmd.Dir = tmpDir + out, _, err = runCommandWithOutput(gzipCompressCmd) + if err != nil { + c.Fatal(err, out) + } + + if err := ioutil.WriteFile(filepath.Join(tmpDir, "Dockerfile"), []byte(dockerfile), 0644); err != nil { + c.Fatalf("failed to open destination dockerfile: %v", err) + } + return fakeContextFromDir(tmpDir) + }() + + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatalf("build failed to complete for TestBuildAddTarXz: %v", err) + } + +} + +func (s *DockerSuite) TestBuildFromGIT(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildfromgit" + git, err := newFakeGit("repo", map[string]string{ + "Dockerfile": `FROM busybox + ADD first /first + RUN [ -f /first ] + MAINTAINER docker`, + "first": "test git data", + }, true) + if err != nil { + c.Fatal(err) + } + defer git.Close() + + _, err = buildImageFromPath(name, git.RepoURL, true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Author") + if err != nil { + c.Fatal(err) + } + if res != "docker" { + c.Fatalf("Maintainer should be docker, got %s", res) + } +} + +func (s *DockerSuite) TestBuildFromGITWithContext(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildfromgit" + git, err := newFakeGit("repo", map[string]string{ + "docker/Dockerfile": `FROM busybox + ADD first /first + RUN [ -f /first ] + MAINTAINER docker`, + "docker/first": "test git data", + }, true) + if err != nil { + c.Fatal(err) + } + defer git.Close() + + u := fmt.Sprintf("%s#master:docker", git.RepoURL) + _, err = buildImageFromPath(name, u, true) + if err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Author") + if err != nil { + c.Fatal(err) + } + if res != "docker" { + c.Fatalf("Maintainer should be docker, got %s", res) + } +} + +func (s *DockerSuite) TestBuildFromGITwithF(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildfromgitwithf" + git, err := newFakeGit("repo", map[string]string{ + "myApp/myDockerfile": `FROM busybox + RUN echo hi from Dockerfile`, + }, true) + if err != nil { + c.Fatal(err) + } + defer git.Close() + + out, _, err := dockerCmdWithError("build", "-t", name, "--no-cache", "-f", "myApp/myDockerfile", git.RepoURL) + if err != nil { + c.Fatalf("Error on build. Out: %s\nErr: %v", out, err) + } + + if !strings.Contains(out, "hi from Dockerfile") { + c.Fatalf("Missing expected output, got:\n%s", out) + } +} + +func (s *DockerSuite) TestBuildFromRemoteTarball(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildfromremotetarball" + + buffer := new(bytes.Buffer) + tw := tar.NewWriter(buffer) + defer tw.Close() + + dockerfile := []byte(`FROM busybox + MAINTAINER docker`) + if err := tw.WriteHeader(&tar.Header{ + Name: "Dockerfile", + Size: int64(len(dockerfile)), + }); err != nil { + c.Fatalf("failed to write tar file header: %v", err) + } + if _, err := tw.Write(dockerfile); err != nil { + c.Fatalf("failed to write tar file content: %v", err) + } + if err := tw.Close(); err != nil { + c.Fatalf("failed to close tar archive: %v", err) + } + + server, err := fakeBinaryStorage(map[string]*bytes.Buffer{ + "testT.tar": buffer, + }) + c.Assert(err, check.IsNil) + + defer server.Close() + + _, err = buildImageFromPath(name, server.URL()+"/testT.tar", true) + c.Assert(err, check.IsNil) + + res, err := inspectField(name, "Author") + c.Assert(err, check.IsNil) + + if res != "docker" { + c.Fatalf("Maintainer should be docker, got %s", res) + } +} + +func (s *DockerSuite) TestBuildCleanupCmdOnEntrypoint(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcmdcleanuponentrypoint" + if _, err := buildImage(name, + `FROM scratch + CMD ["test"] + ENTRYPOINT ["echo"]`, + true); err != nil { + c.Fatal(err) + } + if _, err := buildImage(name, + fmt.Sprintf(`FROM %s + ENTRYPOINT ["cat"]`, name), + true); err != nil { + c.Fatal(err) + } + res, err := inspectField(name, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + if res != "" { + c.Fatalf("Cmd %s, expected nil", res) + } + + res, err = inspectField(name, "Config.Entrypoint") + if err != nil { + c.Fatal(err) + } + if expected := "{[cat]}"; res != expected { + c.Fatalf("Entrypoint %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildClearCmd(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildclearcmd" + _, err := buildImage(name, + `From scratch + ENTRYPOINT ["/bin/bash"] + CMD []`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectFieldJSON(name, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + if res != "[]" { + c.Fatalf("Cmd %s, expected %s", res, "[]") + } +} + +func (s *DockerSuite) TestBuildEmptyCmd(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildemptycmd" + if _, err := buildImage(name, "FROM scratch\nMAINTAINER quux\n", true); err != nil { + c.Fatal(err) + } + res, err := inspectFieldJSON(name, "Config.Cmd") + if err != nil { + c.Fatal(err) + } + if res != "null" { + c.Fatalf("Cmd %s, expected %s", res, "null") + } +} + +func (s *DockerSuite) TestBuildOnBuildOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildonbuildparent" + if _, err := buildImage(name, "FROM busybox\nONBUILD RUN echo foo\n", true); err != nil { + c.Fatal(err) + } + + _, out, err := buildImageWithOut(name, "FROM "+name+"\nMAINTAINER quux\n", true) + if err != nil { + c.Fatal(err) + } + + if !strings.Contains(out, "# Executing 1 build trigger") { + c.Fatal("failed to find the build trigger output", out) + } +} + +func (s *DockerSuite) TestBuildInvalidTag(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "abcd:" + stringutils.GenerateRandomAlphaOnlyString(200) + _, out, err := buildImageWithOut(name, "FROM scratch\nMAINTAINER quux\n", true) + // if the error doesnt check for illegal tag name, or the image is built + // then this should fail + if !strings.Contains(out, "Illegal tag name") || strings.Contains(out, "Sending build context to Docker daemon") { + c.Fatalf("failed to stop before building. Error: %s, Output: %s", err, out) + } +} + +func (s *DockerSuite) TestBuildCmdShDashC(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcmdshc" + if _, err := buildImage(name, "FROM busybox\nCMD echo cmd\n", true); err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name, "Config.Cmd") + if err != nil { + c.Fatal(err, res) + } + + expected := `["/bin/sh","-c","echo cmd"]` + + if res != expected { + c.Fatalf("Expected value %s not in Config.Cmd: %s", expected, res) + } + +} + +func (s *DockerSuite) TestBuildCmdSpaces(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure that when we strcat arrays we take into account + // the arg separator to make sure ["echo","hi"] and ["echo hi"] don't + // look the same + name := "testbuildcmdspaces" + var id1 string + var id2 string + var err error + + if id1, err = buildImage(name, "FROM busybox\nCMD [\"echo hi\"]\n", true); err != nil { + c.Fatal(err) + } + + if id2, err = buildImage(name, "FROM busybox\nCMD [\"echo\", \"hi\"]\n", true); err != nil { + c.Fatal(err) + } + + if id1 == id2 { + c.Fatal("Should not have resulted in the same CMD") + } + + // Now do the same with ENTRYPOINT + if id1, err = buildImage(name, "FROM busybox\nENTRYPOINT [\"echo hi\"]\n", true); err != nil { + c.Fatal(err) + } + + if id2, err = buildImage(name, "FROM busybox\nENTRYPOINT [\"echo\", \"hi\"]\n", true); err != nil { + c.Fatal(err) + } + + if id1 == id2 { + c.Fatal("Should not have resulted in the same ENTRYPOINT") + } + +} + +func (s *DockerSuite) TestBuildCmdJSONNoShDashC(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildcmdjson" + if _, err := buildImage(name, "FROM busybox\nCMD [\"echo\", \"cmd\"]", true); err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name, "Config.Cmd") + if err != nil { + c.Fatal(err, res) + } + + expected := `["echo","cmd"]` + + if res != expected { + c.Fatalf("Expected value %s not in Config.Cmd: %s", expected, res) + } + +} + +func (s *DockerSuite) TestBuildErrorInvalidInstruction(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildignoreinvalidinstruction" + + out, _, err := buildImageWithOut(name, "FROM busybox\nfoo bar", true) + if err == nil { + c.Fatalf("Should have failed: %s", out) + } + +} + +func (s *DockerSuite) TestBuildEntrypointInheritance(c *check.C) { + testRequires(c, DaemonIsLinux) + + if _, err := buildImage("parent", ` + FROM busybox + ENTRYPOINT exit 130 + `, true); err != nil { + c.Fatal(err) + } + + if _, status, _ := dockerCmdWithError("run", "parent"); status != 130 { + c.Fatalf("expected exit code 130 but received %d", status) + } + + if _, err := buildImage("child", ` + FROM parent + ENTRYPOINT exit 5 + `, true); err != nil { + c.Fatal(err) + } + + if _, status, _ := dockerCmdWithError("run", "child"); status != 5 { + c.Fatalf("expected exit code 5 but received %d", status) + } + +} + +func (s *DockerSuite) TestBuildEntrypointInheritanceInspect(c *check.C) { + testRequires(c, DaemonIsLinux) + var ( + name = "testbuildepinherit" + name2 = "testbuildepinherit2" + expected = `["/bin/sh","-c","echo quux"]` + ) + + if _, err := buildImage(name, "FROM busybox\nENTRYPOINT /foo/bar", true); err != nil { + c.Fatal(err) + } + + if _, err := buildImage(name2, fmt.Sprintf("FROM %s\nENTRYPOINT echo quux", name), true); err != nil { + c.Fatal(err) + } + + res, err := inspectFieldJSON(name2, "Config.Entrypoint") + if err != nil { + c.Fatal(err, res) + } + + if res != expected { + c.Fatalf("Expected value %s not in Config.Entrypoint: %s", expected, res) + } + + out, _ := dockerCmd(c, "run", "-t", name2) + + expected = "quux" + + if strings.TrimSpace(out) != expected { + c.Fatalf("Expected output is %s, got %s", expected, out) + } + +} + +func (s *DockerSuite) TestBuildRunShEntrypoint(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildentrypoint" + _, err := buildImage(name, + `FROM busybox + ENTRYPOINT /bin/echo`, + true) + if err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "--rm", name) +} + +func (s *DockerSuite) TestBuildExoticShellInterpolation(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildexoticshellinterpolation" + + _, err := buildImage(name, ` + FROM busybox + + ENV SOME_VAR a.b.c + + RUN [ "$SOME_VAR" = 'a.b.c' ] + RUN [ "${SOME_VAR}" = 'a.b.c' ] + RUN [ "${SOME_VAR%.*}" = 'a.b' ] + RUN [ "${SOME_VAR%%.*}" = 'a' ] + RUN [ "${SOME_VAR#*.}" = 'b.c' ] + RUN [ "${SOME_VAR##*.}" = 'c' ] + RUN [ "${SOME_VAR/c/d}" = 'a.b.d' ] + RUN [ "${#SOME_VAR}" = '5' ] + + RUN [ "${SOME_UNSET_VAR:-$SOME_VAR}" = 'a.b.c' ] + RUN [ "${SOME_VAR:+Version: ${SOME_VAR}}" = 'Version: a.b.c' ] + RUN [ "${SOME_UNSET_VAR:+${SOME_VAR}}" = '' ] + RUN [ "${SOME_UNSET_VAR:-${SOME_VAR:-d.e.f}}" = 'a.b.c' ] + `, false) + if err != nil { + c.Fatal(err) + } + +} + +func (s *DockerSuite) TestBuildVerifySingleQuoteFails(c *check.C) { + testRequires(c, DaemonIsLinux) + // This testcase is supposed to generate an error because the + // JSON array we're passing in on the CMD uses single quotes instead + // of double quotes (per the JSON spec). This means we interpret it + // as a "string" insead of "JSON array" and pass it on to "sh -c" and + // it should barf on it. + name := "testbuildsinglequotefails" + + if _, err := buildImage(name, + `FROM busybox + CMD [ '/bin/sh', '-c', 'echo hi' ]`, + true); err != nil { + c.Fatal(err) + } + + if _, _, err := dockerCmdWithError("run", "--rm", name); err == nil { + c.Fatal("The image was not supposed to be able to run") + } + +} + +func (s *DockerSuite) TestBuildVerboseOut(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildverboseout" + + _, out, err := buildImageWithOut(name, + `FROM busybox +RUN echo 123`, + false) + + if err != nil { + c.Fatal(err) + } + if !strings.Contains(out, "\n123\n") { + c.Fatalf("Output should contain %q: %q", "123", out) + } + +} + +func (s *DockerSuite) TestBuildWithTabs(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildwithtabs" + _, err := buildImage(name, + "FROM busybox\nRUN echo\tone\t\ttwo", true) + if err != nil { + c.Fatal(err) + } + res, err := inspectFieldJSON(name, "ContainerConfig.Cmd") + if err != nil { + c.Fatal(err) + } + expected1 := `["/bin/sh","-c","echo\tone\t\ttwo"]` + expected2 := `["/bin/sh","-c","echo\u0009one\u0009\u0009two"]` // syntactically equivalent, and what Go 1.3 generates + if res != expected1 && res != expected2 { + c.Fatalf("Missing tabs.\nGot: %s\nExp: %s or %s", res, expected1, expected2) + } +} + +func (s *DockerSuite) TestBuildLabels(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildlabel" + expected := `{"License":"GPL","Vendor":"Acme"}` + _, err := buildImage(name, + `FROM busybox + LABEL Vendor=Acme + LABEL License GPL`, + true) + if err != nil { + c.Fatal(err) + } + res, err := inspectFieldJSON(name, "Config.Labels") + if err != nil { + c.Fatal(err) + } + if res != expected { + c.Fatalf("Labels %s, expected %s", res, expected) + } +} + +func (s *DockerSuite) TestBuildLabelsCache(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildlabelcache" + + id1, err := buildImage(name, + `FROM busybox + LABEL Vendor=Acme`, false) + if err != nil { + c.Fatalf("Build 1 should have worked: %v", err) + } + + id2, err := buildImage(name, + `FROM busybox + LABEL Vendor=Acme`, true) + if err != nil || id1 != id2 { + c.Fatalf("Build 2 should have worked & used cache(%s,%s): %v", id1, id2, err) + } + + id2, err = buildImage(name, + `FROM busybox + LABEL Vendor=Acme1`, true) + if err != nil || id1 == id2 { + c.Fatalf("Build 3 should have worked & NOT used cache(%s,%s): %v", id1, id2, err) + } + + id2, err = buildImage(name, + `FROM busybox + LABEL Vendor Acme`, true) // Note: " " and "=" should be same + if err != nil || id1 != id2 { + c.Fatalf("Build 4 should have worked & used cache(%s,%s): %v", id1, id2, err) + } + + // Now make sure the cache isn't used by mistake + id1, err = buildImage(name, + `FROM busybox + LABEL f1=b1 f2=b2`, false) + if err != nil { + c.Fatalf("Build 5 should have worked: %q", err) + } + + id2, err = buildImage(name, + `FROM busybox + LABEL f1="b1 f2=b2"`, true) + if err != nil || id1 == id2 { + c.Fatalf("Build 6 should have worked & NOT used the cache(%s,%s): %q", id1, id2, err) + } + +} + +func (s *DockerSuite) TestBuildStderr(c *check.C) { + testRequires(c, DaemonIsLinux) + // This test just makes sure that no non-error output goes + // to stderr + name := "testbuildstderr" + _, _, stderr, err := buildImageWithStdoutStderr(name, + "FROM busybox\nRUN echo one", true) + if err != nil { + c.Fatal(err) + } + + if runtime.GOOS == "windows" { + // stderr might contain a security warning on windows + lines := strings.Split(stderr, "\n") + for _, v := range lines { + if v != "" && !strings.Contains(v, "SECURITY WARNING:") { + c.Fatalf("Stderr contains unexpected output line: %q", v) + } + } + } else { + if stderr != "" { + c.Fatalf("Stderr should have been empty, instead its: %q", stderr) + } + } +} + +func (s *DockerSuite) TestBuildChownSingleFile(c *check.C) { + testRequires(c, UnixCli) // test uses chown: not available on windows + testRequires(c, DaemonIsLinux) + + name := "testbuildchownsinglefile" + + ctx, err := fakeContext(` +FROM busybox +COPY test / +RUN ls -l /test +RUN [ $(ls -l /test | awk '{print $3":"$4}') = 'root:root' ] +`, map[string]string{ + "test": "test", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if err := os.Chown(filepath.Join(ctx.Dir, "test"), 4242, 4242); err != nil { + c.Fatal(err) + } + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + +} + +func (s *DockerSuite) TestBuildSymlinkBreakout(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildsymlinkbreakout" + tmpdir, err := ioutil.TempDir("", name) + c.Assert(err, check.IsNil) + defer os.RemoveAll(tmpdir) + ctx := filepath.Join(tmpdir, "context") + if err := os.MkdirAll(ctx, 0755); err != nil { + c.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(ctx, "Dockerfile"), []byte(` + from busybox + add symlink.tar / + add inject /symlink/ + `), 0644); err != nil { + c.Fatal(err) + } + inject := filepath.Join(ctx, "inject") + if err := ioutil.WriteFile(inject, nil, 0644); err != nil { + c.Fatal(err) + } + f, err := os.Create(filepath.Join(ctx, "symlink.tar")) + if err != nil { + c.Fatal(err) + } + w := tar.NewWriter(f) + w.WriteHeader(&tar.Header{ + Name: "symlink2", + Typeflag: tar.TypeSymlink, + Linkname: "/../../../../../../../../../../../../../../", + Uid: os.Getuid(), + Gid: os.Getgid(), + }) + w.WriteHeader(&tar.Header{ + Name: "symlink", + Typeflag: tar.TypeSymlink, + Linkname: filepath.Join("symlink2", tmpdir), + Uid: os.Getuid(), + Gid: os.Getgid(), + }) + w.Close() + f.Close() + if _, err := buildImageFromContext(name, fakeContextFromDir(ctx), false); err != nil { + c.Fatal(err) + } + if _, err := os.Lstat(filepath.Join(tmpdir, "inject")); err == nil { + c.Fatal("symlink breakout - inject") + } else if !os.IsNotExist(err) { + c.Fatalf("unexpected error: %v", err) + } +} + +func (s *DockerSuite) TestBuildXZHost(c *check.C) { + // /usr/local/sbin/xz gets permission denied for the user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + name := "testbuildxzhost" + + ctx, err := fakeContext(` +FROM busybox +ADD xz /usr/local/sbin/ +RUN chmod 755 /usr/local/sbin/xz +ADD test.xz / +RUN [ ! -e /injected ]`, + map[string]string{ + "test.xz": "\xfd\x37\x7a\x58\x5a\x00\x00\x04\xe6\xd6\xb4\x46\x02\x00" + + "\x21\x01\x16\x00\x00\x00\x74\x2f\xe5\xa3\x01\x00\x3f\xfd" + + "\x37\x7a\x58\x5a\x00\x00\x04\xe6\xd6\xb4\x46\x02\x00\x21", + "xz": "#!/bin/sh\ntouch /injected", + }) + + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, true); err != nil { + c.Fatal(err) + } + +} + +func (s *DockerSuite) TestBuildVolumesRetainContents(c *check.C) { + // /foo/file gets permission denied for the user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + var ( + name = "testbuildvolumescontent" + expected = "some text" + ) + ctx, err := fakeContext(` +FROM busybox +COPY content /foo/file +VOLUME /foo +CMD cat /foo/file`, + map[string]string{ + "content": expected, + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(name, ctx, false); err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--rm", name) + if out != expected { + c.Fatalf("expected file contents for /foo/file to be %q but received %q", expected, out) + } + +} + +func (s *DockerSuite) TestBuildRenamedDockerfile(c *check.C) { + testRequires(c, DaemonIsLinux) + + ctx, err := fakeContext(`FROM busybox + RUN echo from Dockerfile`, + map[string]string{ + "Dockerfile": "FROM busybox\nRUN echo from Dockerfile", + "files/Dockerfile": "FROM busybox\nRUN echo from files/Dockerfile", + "files/dFile": "FROM busybox\nRUN echo from files/dFile", + "dFile": "FROM busybox\nRUN echo from dFile", + "files/dFile2": "FROM busybox\nRUN echo from files/dFile2", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "-t", "test1", ".") + if err != nil { + c.Fatalf("Failed to build: %s\n%s", out, err) + } + if !strings.Contains(out, "from Dockerfile") { + c.Fatalf("test1 should have used Dockerfile, output:%s", out) + } + + out, _, err = dockerCmdInDir(c, ctx.Dir, "build", "-f", filepath.Join("files", "Dockerfile"), "-t", "test2", ".") + if err != nil { + c.Fatal(err) + } + if !strings.Contains(out, "from files/Dockerfile") { + c.Fatalf("test2 should have used files/Dockerfile, output:%s", out) + } + + out, _, err = dockerCmdInDir(c, ctx.Dir, "build", fmt.Sprintf("--file=%s", filepath.Join("files", "dFile")), "-t", "test3", ".") + if err != nil { + c.Fatal(err) + } + if !strings.Contains(out, "from files/dFile") { + c.Fatalf("test3 should have used files/dFile, output:%s", out) + } + + out, _, err = dockerCmdInDir(c, ctx.Dir, "build", "--file=dFile", "-t", "test4", ".") + if err != nil { + c.Fatal(err) + } + if !strings.Contains(out, "from dFile") { + c.Fatalf("test4 should have used dFile, output:%s", out) + } + + dirWithNoDockerfile, err := ioutil.TempDir(os.TempDir(), "test5") + c.Assert(err, check.IsNil) + nonDockerfileFile := filepath.Join(dirWithNoDockerfile, "notDockerfile") + if _, err = os.Create(nonDockerfileFile); err != nil { + c.Fatal(err) + } + out, _, err = dockerCmdInDir(c, ctx.Dir, "build", fmt.Sprintf("--file=%s", nonDockerfileFile), "-t", "test5", ".") + + if err == nil { + c.Fatalf("test5 was supposed to fail to find passwd") + } + + if expected := fmt.Sprintf("The Dockerfile (%s) must be within the build context (.)", nonDockerfileFile); !strings.Contains(out, expected) { + c.Fatalf("wrong error messsage:%v\nexpected to contain=%v", out, expected) + } + + out, _, err = dockerCmdInDir(c, filepath.Join(ctx.Dir, "files"), "build", "-f", filepath.Join("..", "Dockerfile"), "-t", "test6", "..") + if err != nil { + c.Fatalf("test6 failed: %s", err) + } + if !strings.Contains(out, "from Dockerfile") { + c.Fatalf("test6 should have used root Dockerfile, output:%s", out) + } + + out, _, err = dockerCmdInDir(c, filepath.Join(ctx.Dir, "files"), "build", "-f", filepath.Join(ctx.Dir, "files", "Dockerfile"), "-t", "test7", "..") + if err != nil { + c.Fatalf("test7 failed: %s", err) + } + if !strings.Contains(out, "from files/Dockerfile") { + c.Fatalf("test7 should have used files Dockerfile, output:%s", out) + } + + out, _, err = dockerCmdInDir(c, filepath.Join(ctx.Dir, "files"), "build", "-f", filepath.Join("..", "Dockerfile"), "-t", "test8", ".") + if err == nil || !strings.Contains(out, "must be within the build context") { + c.Fatalf("test8 should have failed with Dockerfile out of context: %s", err) + } + + tmpDir := os.TempDir() + out, _, err = dockerCmdInDir(c, tmpDir, "build", "-t", "test9", ctx.Dir) + if err != nil { + c.Fatalf("test9 - failed: %s", err) + } + if !strings.Contains(out, "from Dockerfile") { + c.Fatalf("test9 should have used root Dockerfile, output:%s", out) + } + + out, _, err = dockerCmdInDir(c, filepath.Join(ctx.Dir, "files"), "build", "-f", "dFile2", "-t", "test10", ".") + if err != nil { + c.Fatalf("test10 should have worked: %s", err) + } + if !strings.Contains(out, "from files/dFile2") { + c.Fatalf("test10 should have used files/dFile2, output:%s", out) + } + +} + +func (s *DockerSuite) TestBuildFromMixedcaseDockerfile(c *check.C) { + testRequires(c, UnixCli) // Dockerfile overwrites dockerfile on windows + testRequires(c, DaemonIsLinux) + + ctx, err := fakeContext(`FROM busybox + RUN echo from dockerfile`, + map[string]string{ + "dockerfile": "FROM busybox\nRUN echo from dockerfile", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "-t", "test1", ".") + if err != nil { + c.Fatalf("Failed to build: %s\n%s", out, err) + } + + if !strings.Contains(out, "from dockerfile") { + c.Fatalf("Missing proper output: %s", out) + } + +} + +func (s *DockerSuite) TestBuildWithTwoDockerfiles(c *check.C) { + testRequires(c, UnixCli) // Dockerfile overwrites dockerfile on windows + testRequires(c, DaemonIsLinux) + + ctx, err := fakeContext(`FROM busybox +RUN echo from Dockerfile`, + map[string]string{ + "dockerfile": "FROM busybox\nRUN echo from dockerfile", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "-t", "test1", ".") + if err != nil { + c.Fatalf("Failed to build: %s\n%s", out, err) + } + + if !strings.Contains(out, "from Dockerfile") { + c.Fatalf("Missing proper output: %s", out) + } + +} + +func (s *DockerSuite) TestBuildFromURLWithF(c *check.C) { + testRequires(c, DaemonIsLinux) + + server, err := fakeStorage(map[string]string{"baz": `FROM busybox +RUN echo from baz +COPY * /tmp/ +RUN find /tmp/`}) + if err != nil { + c.Fatal(err) + } + defer server.Close() + + ctx, err := fakeContext(`FROM busybox +RUN echo from Dockerfile`, + map[string]string{}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + // Make sure that -f is ignored and that we don't use the Dockerfile + // that's in the current dir + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "-f", "baz", "-t", "test1", server.URL()+"/baz") + if err != nil { + c.Fatalf("Failed to build: %s\n%s", out, err) + } + + if !strings.Contains(out, "from baz") || + strings.Contains(out, "/tmp/baz") || + !strings.Contains(out, "/tmp/Dockerfile") { + c.Fatalf("Missing proper output: %s", out) + } + +} + +func (s *DockerSuite) TestBuildFromStdinWithF(c *check.C) { + testRequires(c, DaemonIsLinux) + ctx, err := fakeContext(`FROM busybox +RUN echo from Dockerfile`, + map[string]string{}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + // Make sure that -f is ignored and that we don't use the Dockerfile + // that's in the current dir + dockerCommand := exec.Command(dockerBinary, "build", "-f", "baz", "-t", "test1", "-") + dockerCommand.Dir = ctx.Dir + dockerCommand.Stdin = strings.NewReader(`FROM busybox +RUN echo from baz +COPY * /tmp/ +RUN find /tmp/`) + out, status, err := runCommandWithOutput(dockerCommand) + if err != nil || status != 0 { + c.Fatalf("Error building: %s", err) + } + + if !strings.Contains(out, "from baz") || + strings.Contains(out, "/tmp/baz") || + !strings.Contains(out, "/tmp/Dockerfile") { + c.Fatalf("Missing proper output: %s", out) + } + +} + +func (s *DockerSuite) TestBuildFromOfficialNames(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildfromofficial" + fromNames := []string{ + "busybox", + "docker.io/busybox", + "index.docker.io/busybox", + "library/busybox", + "docker.io/library/busybox", + "index.docker.io/library/busybox", + } + for idx, fromName := range fromNames { + imgName := fmt.Sprintf("%s%d", name, idx) + _, err := buildImage(imgName, "FROM "+fromName, true) + if err != nil { + c.Errorf("Build failed using FROM %s: %s", fromName, err) + } + deleteImages(imgName) + } +} + +func (s *DockerSuite) TestBuildDockerfileOutsideContext(c *check.C) { + testRequires(c, UnixCli) // uses os.Symlink: not implemented in windows at the time of writing (go-1.4.2) + testRequires(c, DaemonIsLinux) + + name := "testbuilddockerfileoutsidecontext" + tmpdir, err := ioutil.TempDir("", name) + c.Assert(err, check.IsNil) + defer os.RemoveAll(tmpdir) + ctx := filepath.Join(tmpdir, "context") + if err := os.MkdirAll(ctx, 0755); err != nil { + c.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(ctx, "Dockerfile"), []byte("FROM scratch\nENV X Y"), 0644); err != nil { + c.Fatal(err) + } + wd, err := os.Getwd() + if err != nil { + c.Fatal(err) + } + defer os.Chdir(wd) + if err := os.Chdir(ctx); err != nil { + c.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(tmpdir, "outsideDockerfile"), []byte("FROM scratch\nENV x y"), 0644); err != nil { + c.Fatal(err) + } + if err := os.Symlink(filepath.Join("..", "outsideDockerfile"), filepath.Join(ctx, "dockerfile1")); err != nil { + c.Fatal(err) + } + if err := os.Symlink(filepath.Join(tmpdir, "outsideDockerfile"), filepath.Join(ctx, "dockerfile2")); err != nil { + c.Fatal(err) + } + + for _, dockerfilePath := range []string{ + filepath.Join("..", "outsideDockerfile"), + filepath.Join(ctx, "dockerfile1"), + filepath.Join(ctx, "dockerfile2"), + } { + out, _, err := dockerCmdWithError("build", "-t", name, "--no-cache", "-f", dockerfilePath, ".") + if err == nil { + c.Fatalf("Expected error with %s. Out: %s", dockerfilePath, out) + } + if !strings.Contains(out, "must be within the build context") && !strings.Contains(out, "Cannot locate Dockerfile") { + c.Fatalf("Unexpected error with %s. Out: %s", dockerfilePath, out) + } + deleteImages(name) + } + + os.Chdir(tmpdir) + + // Path to Dockerfile should be resolved relative to working directory, not relative to context. + // There is a Dockerfile in the context, but since there is no Dockerfile in the current directory, the following should fail + out, _, err := dockerCmdWithError("build", "-t", name, "--no-cache", "-f", "Dockerfile", ctx) + if err == nil { + c.Fatalf("Expected error. Out: %s", out) + } +} + +func (s *DockerSuite) TestBuildSpaces(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure that leading/trailing spaces on a command + // doesn't change the error msg we get + var ( + err1 error + err2 error + ) + + name := "testspaces" + ctx, err := fakeContext("FROM busybox\nCOPY\n", + map[string]string{ + "Dockerfile": "FROM busybox\nCOPY\n", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err1 = buildImageFromContext(name, ctx, false); err1 == nil { + c.Fatal("Build 1 was supposed to fail, but didn't") + } + + ctx.Add("Dockerfile", "FROM busybox\nCOPY ") + if _, err2 = buildImageFromContext(name, ctx, false); err2 == nil { + c.Fatal("Build 2 was supposed to fail, but didn't") + } + + removeLogTimestamps := func(s string) string { + return regexp.MustCompile(`time="(.*?)"`).ReplaceAllString(s, `time=[TIMESTAMP]`) + } + + // Skip over the times + e1 := removeLogTimestamps(err1.Error()) + e2 := removeLogTimestamps(err2.Error()) + + // Ignore whitespace since that's what were verifying doesn't change stuff + if strings.Replace(e1, " ", "", -1) != strings.Replace(e2, " ", "", -1) { + c.Fatalf("Build 2's error wasn't the same as build 1's\n1:%s\n2:%s", err1, err2) + } + + ctx.Add("Dockerfile", "FROM busybox\n COPY") + if _, err2 = buildImageFromContext(name, ctx, false); err2 == nil { + c.Fatal("Build 3 was supposed to fail, but didn't") + } + + // Skip over the times + e1 = removeLogTimestamps(err1.Error()) + e2 = removeLogTimestamps(err2.Error()) + + // Ignore whitespace since that's what were verifying doesn't change stuff + if strings.Replace(e1, " ", "", -1) != strings.Replace(e2, " ", "", -1) { + c.Fatalf("Build 3's error wasn't the same as build 1's\n1:%s\n3:%s", err1, err2) + } + + ctx.Add("Dockerfile", "FROM busybox\n COPY ") + if _, err2 = buildImageFromContext(name, ctx, false); err2 == nil { + c.Fatal("Build 4 was supposed to fail, but didn't") + } + + // Skip over the times + e1 = removeLogTimestamps(err1.Error()) + e2 = removeLogTimestamps(err2.Error()) + + // Ignore whitespace since that's what were verifying doesn't change stuff + if strings.Replace(e1, " ", "", -1) != strings.Replace(e2, " ", "", -1) { + c.Fatalf("Build 4's error wasn't the same as build 1's\n1:%s\n4:%s", err1, err2) + } + +} + +func (s *DockerSuite) TestBuildSpacesWithQuotes(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure that spaces in quotes aren't lost + name := "testspacesquotes" + + dockerfile := `FROM busybox +RUN echo " \ + foo "` + + _, out, err := buildImageWithOut(name, dockerfile, false) + if err != nil { + c.Fatal("Build failed:", err) + } + + expecting := "\n foo \n" + if !strings.Contains(out, expecting) { + c.Fatalf("Bad output: %q expecting to contain %q", out, expecting) + } + +} + +// #4393 +func (s *DockerSuite) TestBuildVolumeFileExistsinContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + buildCmd := exec.Command(dockerBinary, "build", "-t", "docker-test-errcreatevolumewithfile", "-") + buildCmd.Stdin = strings.NewReader(` + FROM busybox + RUN touch /foo + VOLUME /foo + `) + + out, _, err := runCommandWithOutput(buildCmd) + if err == nil || !strings.Contains(out, "file exists") { + c.Fatalf("expected build to fail when file exists in container at requested volume path") + } + +} + +func (s *DockerSuite) TestBuildMissingArgs(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure that all Dockerfile commands (except the ones listed + // in skipCmds) will generate an error if no args are provided. + // Note: INSERT is deprecated so we exclude it because of that. + skipCmds := map[string]struct{}{ + "CMD": {}, + "RUN": {}, + "ENTRYPOINT": {}, + "INSERT": {}, + } + + for cmd := range command.Commands { + cmd = strings.ToUpper(cmd) + if _, ok := skipCmds[cmd]; ok { + continue + } + + var dockerfile string + if cmd == "FROM" { + dockerfile = cmd + } else { + // Add FROM to make sure we don't complain about it missing + dockerfile = "FROM busybox\n" + cmd + } + + ctx, err := fakeContext(dockerfile, map[string]string{}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + var out string + if out, err = buildImageFromContext("args", ctx, true); err == nil { + c.Fatalf("%s was supposed to fail. Out:%s", cmd, out) + } + if !strings.Contains(err.Error(), cmd+" requires") { + c.Fatalf("%s returned the wrong type of error:%s", cmd, err) + } + } + +} + +func (s *DockerSuite) TestBuildEmptyScratch(c *check.C) { + testRequires(c, DaemonIsLinux) + _, out, err := buildImageWithOut("sc", "FROM scratch", true) + if err == nil { + c.Fatalf("Build was supposed to fail") + } + if !strings.Contains(out, "No image was generated") { + c.Fatalf("Wrong error message: %v", out) + } +} + +func (s *DockerSuite) TestBuildDotDotFile(c *check.C) { + testRequires(c, DaemonIsLinux) + + ctx, err := fakeContext("FROM busybox\n", + map[string]string{ + "..gitme": "", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err = buildImageFromContext("sc", ctx, false); err != nil { + c.Fatalf("Build was supposed to work: %s", err) + } +} + +func (s *DockerSuite) TestBuildNotVerbose(c *check.C) { + testRequires(c, DaemonIsLinux) + ctx, err := fakeContext("FROM busybox\nENV abc=hi\nRUN echo $abc there", map[string]string{}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + // First do it w/verbose - baseline + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "--no-cache", "-t", "verbose", ".") + if err != nil { + c.Fatalf("failed to build the image w/o -q: %s, %v", out, err) + } + if !strings.Contains(out, "hi there") { + c.Fatalf("missing output:%s\n", out) + } + + // Now do it w/o verbose + out, _, err = dockerCmdInDir(c, ctx.Dir, "build", "--no-cache", "-q", "-t", "verbose", ".") + if err != nil { + c.Fatalf("failed to build the image w/ -q: %s, %v", out, err) + } + if strings.Contains(out, "hi there") { + c.Fatalf("Bad output, should not contain 'hi there':%s", out) + } + +} + +func (s *DockerSuite) TestBuildRUNoneJSON(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildrunonejson" + + ctx, err := fakeContext(`FROM hello-world:frozen +RUN [ "/hello" ]`, map[string]string{}) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + out, _, err := dockerCmdInDir(c, ctx.Dir, "build", "--no-cache", "-t", name, ".") + if err != nil { + c.Fatalf("failed to build the image: %s, %v", out, err) + } + + if !strings.Contains(out, "Hello from Docker") { + c.Fatalf("bad output: %s", out) + } + +} + +func (s *DockerSuite) TestBuildEmptyStringVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildemptystringvolume" + + _, err := buildImage(name, ` + FROM busybox + ENV foo="" + VOLUME $foo + `, false) + if err == nil { + c.Fatal("Should have failed to build") + } + +} + +func (s *DockerSuite) TestBuildContainerWithCgroupParent(c *check.C) { + testRequires(c, NativeExecDriver) + testRequires(c, SameHostDaemon) + testRequires(c, DaemonIsLinux) + + cgroupParent := "test" + data, err := ioutil.ReadFile("/proc/self/cgroup") + if err != nil { + c.Fatalf("failed to read '/proc/self/cgroup - %v", err) + } + selfCgroupPaths := parseCgroupPaths(string(data)) + _, found := selfCgroupPaths["memory"] + if !found { + c.Fatalf("unable to find self memory cgroup path. CgroupsPath: %v", selfCgroupPaths) + } + cmd := exec.Command(dockerBinary, "build", "--cgroup-parent", cgroupParent, "-") + cmd.Stdin = strings.NewReader(` +FROM busybox +RUN cat /proc/self/cgroup +`) + + out, _, err := runCommandWithOutput(cmd) + if err != nil { + c.Fatalf("unexpected failure when running container with --cgroup-parent option - %s\n%v", string(out), err) + } + m, err := regexp.MatchString(fmt.Sprintf("memory:.*/%s/.*", cgroupParent), out) + c.Assert(err, check.IsNil) + if !m { + c.Fatalf("There is no expected memory cgroup with parent /%s/: %s", cgroupParent, out) + } +} + +func (s *DockerSuite) TestBuildNoDupOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + // Check to make sure our build output prints the Dockerfile cmd + // property - there was a bug that caused it to be duplicated on the + // Step X line + name := "testbuildnodupoutput" + + _, out, err := buildImageWithOut(name, ` + FROM busybox + RUN env`, false) + if err != nil { + c.Fatalf("Build should have worked: %q", err) + } + + exp := "\nStep 2 : RUN env\n" + if !strings.Contains(out, exp) { + c.Fatalf("Bad output\nGot:%s\n\nExpected to contain:%s\n", out, exp) + } +} + +// GH15826 +func (s *DockerSuite) TestBuildStartsFromOne(c *check.C) { + testRequires(c, DaemonIsLinux) + // Explicit check to ensure that build starts from step 1 rather than 0 + name := "testbuildstartsfromone" + + _, out, err := buildImageWithOut(name, ` + FROM busybox`, false) + if err != nil { + c.Fatalf("Build should have worked: %q", err) + } + + exp := "\nStep 1 : FROM busybox\n" + if !strings.Contains(out, exp) { + c.Fatalf("Bad output\nGot:%s\n\nExpected to contain:%s\n", out, exp) + } +} + +func (s *DockerSuite) TestBuildBadCmdFlag(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildbadcmdflag" + + _, out, err := buildImageWithOut(name, ` + FROM busybox + MAINTAINER --boo joe@example.com`, false) + if err == nil { + c.Fatal("Build should have failed") + } + + exp := "\nUnknown flag: boo\n" + if !strings.Contains(out, exp) { + c.Fatalf("Bad output\nGot:%s\n\nExpected to contain:%s\n", out, exp) + } +} + +func (s *DockerSuite) TestBuildRUNErrMsg(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure the bad command is quoted with just "s and + // not as a Go []string + name := "testbuildbadrunerrmsg" + _, out, err := buildImageWithOut(name, ` + FROM busybox + RUN badEXE a1 \& a2 a3`, false) // tab between a2 and a3 + if err == nil { + c.Fatal("Should have failed to build") + } + + exp := `The command '/bin/sh -c badEXE a1 \& a2 a3' returned a non-zero code: 127` + if !strings.Contains(out, exp) { + c.Fatalf("RUN doesn't have the correct output:\nGot:%s\nExpected:%s", out, exp) + } +} + +func (s *DockerTrustSuite) TestTrustedBuild(c *check.C) { + repoName := s.setupTrustedImage(c, "trusted-build") + dockerFile := fmt.Sprintf(` + FROM %s + RUN [] + `, repoName) + + name := "testtrustedbuild" + + buildCmd := buildImageCmd(name, dockerFile, true) + s.trustedCmd(buildCmd) + out, _, err := runCommandWithOutput(buildCmd) + if err != nil { + c.Fatalf("Error running trusted build: %s\n%s", err, out) + } + + if !strings.Contains(out, fmt.Sprintf("FROM %s@sha", repoName[:len(repoName)-7])) { + c.Fatalf("Unexpected output on trusted build:\n%s", out) + } + + // We should also have a tag reference for the image. + if out, exitCode := dockerCmd(c, "inspect", repoName); exitCode != 0 { + c.Fatalf("unexpected exit code inspecting image %q: %d: %s", repoName, exitCode, out) + } + + // We should now be able to remove the tag reference. + if out, exitCode := dockerCmd(c, "rmi", repoName); exitCode != 0 { + c.Fatalf("unexpected exit code inspecting image %q: %d: %s", repoName, exitCode, out) + } +} + +func (s *DockerTrustSuite) TestTrustedBuildUntrustedTag(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/build-untrusted-tag:latest", privateRegistryURL) + dockerFile := fmt.Sprintf(` + FROM %s + RUN [] + `, repoName) + + name := "testtrustedbuilduntrustedtag" + + buildCmd := buildImageCmd(name, dockerFile, true) + s.trustedCmd(buildCmd) + out, _, err := runCommandWithOutput(buildCmd) + if err == nil { + c.Fatalf("Expected error on trusted build with untrusted tag: %s\n%s", err, out) + } + + if !strings.Contains(out, fmt.Sprintf("no trust data available")) { + c.Fatalf("Unexpected output on trusted build with untrusted tag:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestBuildContextDirIsSymlink(c *check.C) { + testRequires(c, DaemonIsLinux) + tempDir, err := ioutil.TempDir("", "test-build-dir-is-symlink-") + c.Assert(err, check.IsNil) + defer os.RemoveAll(tempDir) + + // Make a real context directory in this temp directory with a simple + // Dockerfile. + realContextDirname := filepath.Join(tempDir, "context") + if err := os.Mkdir(realContextDirname, os.FileMode(0755)); err != nil { + c.Fatal(err) + } + + if err = ioutil.WriteFile( + filepath.Join(realContextDirname, "Dockerfile"), + []byte(` + FROM busybox + RUN echo hello world + `), + os.FileMode(0644), + ); err != nil { + c.Fatal(err) + } + + // Make a symlink to the real context directory. + contextSymlinkName := filepath.Join(tempDir, "context_link") + if err := os.Symlink(realContextDirname, contextSymlinkName); err != nil { + c.Fatal(err) + } + + // Executing the build with the symlink as the specified context should + // *not* fail. + if out, exitStatus := dockerCmd(c, "build", contextSymlinkName); exitStatus != 0 { + c.Fatalf("build failed with exit status %d: %s", exitStatus, out) + } +} + +// Issue #15634: COPY fails when path starts with "null" +func (s *DockerSuite) TestBuildNullStringInAddCopyVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildnullstringinaddcopyvolume" + + ctx, err := fakeContext(` + FROM busybox + + ADD null / + COPY nullfile / + VOLUME nullvolume + `, + map[string]string{ + "null": "test1", + "nullfile": "test2", + }, + ) + c.Assert(err, check.IsNil) + defer ctx.Close() + + _, err = buildImageFromContext(name, ctx, true) + c.Assert(err, check.IsNil) +} + +func (s *DockerSuite) TestBuildStopSignal(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test_build_stop_signal" + _, err := buildImage(name, + `FROM busybox + STOPSIGNAL SIGKILL`, + true) + c.Assert(err, check.IsNil) + res, err := inspectFieldJSON(name, "Config.StopSignal") + c.Assert(err, check.IsNil) + + if res != `"SIGKILL"` { + c.Fatalf("Signal %s, expected SIGKILL", res) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArg(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + RUN echo $%s + CMD echo $%s`, envKey, envKey, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || !strings.Contains(out, envVal) { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envVal) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); out != "\n" { + c.Fatalf("run produced invalid output: %q, expected empty string", out) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgHistory(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + envDef := "bar1" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s=%s`, envKey, envDef) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || !strings.Contains(out, envVal) { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envVal) + } + + out, _ := dockerCmd(c, "history", "--no-trunc", imgName) + outputTabs := strings.Split(out, "\n")[1] + if !strings.Contains(outputTabs, envDef) { + c.Fatalf("failed to find arg default in image history output: %q expected: %q", outputTabs, envDef) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgCacheHit(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + RUN echo $%s`, envKey, envKey) + + origImgID := "" + var err error + if origImgID, err = buildImage(imgName, dockerfile, true, args...); err != nil { + c.Fatal(err) + } + + imgNameCache := "bldargtestcachehit" + if newImgID, err := buildImage(imgNameCache, dockerfile, true, args...); err != nil || newImgID != origImgID { + if err != nil { + c.Fatal(err) + } + c.Fatalf("build didn't use cache! expected image id: %q built image id: %q", origImgID, newImgID) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgCacheMissExtraArg(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + extraEnvKey := "foo1" + extraEnvVal := "bar1" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + ARG %s + RUN echo $%s`, envKey, extraEnvKey, envKey) + + origImgID := "" + var err error + if origImgID, err = buildImage(imgName, dockerfile, true, args...); err != nil { + c.Fatal(err) + } + + imgNameCache := "bldargtestcachemiss" + args = append(args, "--build-arg", fmt.Sprintf("%s=%s", extraEnvKey, extraEnvVal)) + if newImgID, err := buildImage(imgNameCache, dockerfile, true, args...); err != nil || newImgID == origImgID { + if err != nil { + c.Fatal(err) + } + c.Fatalf("build used cache, expected a miss!") + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgCacheMissSameArgDiffVal(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + newEnvVal := "bar1" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + RUN echo $%s`, envKey, envKey) + + origImgID := "" + var err error + if origImgID, err = buildImage(imgName, dockerfile, true, args...); err != nil { + c.Fatal(err) + } + + imgNameCache := "bldargtestcachemiss" + args = []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, newEnvVal), + } + if newImgID, err := buildImage(imgNameCache, dockerfile, true, args...); err != nil || newImgID == origImgID { + if err != nil { + c.Fatal(err) + } + c.Fatalf("build used cache, expected a miss!") + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgOverrideArgDefinedBeforeEnv(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + envValOveride := "barOverride" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + ENV %s %s + RUN echo $%s + CMD echo $%s + `, envKey, envKey, envValOveride, envKey, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || strings.Count(out, envValOveride) != 2 { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envValOveride) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); !strings.Contains(out, envValOveride) { + c.Fatalf("run produced invalid output: %q, expected %q", out, envValOveride) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgOverrideEnvDefinedBeforeArg(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + envValOveride := "barOverride" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + ENV %s %s + ARG %s + RUN echo $%s + CMD echo $%s + `, envKey, envValOveride, envKey, envKey, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || strings.Count(out, envValOveride) != 2 { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envValOveride) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); !strings.Contains(out, envValOveride) { + c.Fatalf("run produced invalid output: %q, expected %q", out, envValOveride) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgExpansion(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldvarstest" + + wdVar := "WDIR" + wdVal := "/tmp/" + addVar := "AFILE" + addVal := "addFile" + copyVar := "CFILE" + copyVal := "copyFile" + envVar := "foo" + envVal := "bar" + exposeVar := "EPORT" + exposeVal := "9999" + userVar := "USER" + userVal := "testUser" + volVar := "VOL" + volVal := "/testVol/" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", wdVar, wdVal), + "--build-arg", fmt.Sprintf("%s=%s", addVar, addVal), + "--build-arg", fmt.Sprintf("%s=%s", copyVar, copyVal), + "--build-arg", fmt.Sprintf("%s=%s", envVar, envVal), + "--build-arg", fmt.Sprintf("%s=%s", exposeVar, exposeVal), + "--build-arg", fmt.Sprintf("%s=%s", userVar, userVal), + "--build-arg", fmt.Sprintf("%s=%s", volVar, volVal), + } + ctx, err := fakeContext(fmt.Sprintf(`FROM busybox + ARG %s + WORKDIR ${%s} + ARG %s + ADD ${%s} testDir/ + ARG %s + COPY $%s testDir/ + ARG %s + ENV %s=${%s} + ARG %s + EXPOSE $%s + ARG %s + USER $%s + ARG %s + VOLUME ${%s}`, + wdVar, wdVar, addVar, addVar, copyVar, copyVar, envVar, envVar, + envVar, exposeVar, exposeVar, userVar, userVar, volVar, volVar), + map[string]string{ + addVal: "some stuff", + copyVal: "some stuff", + }) + if err != nil { + c.Fatal(err) + } + defer ctx.Close() + + if _, err := buildImageFromContext(imgName, ctx, true, args...); err != nil { + c.Fatal(err) + } + + var resMap map[string]interface{} + var resArr []string + res := "" + res, err = inspectField(imgName, "Config.WorkingDir") + if err != nil { + c.Fatal(err) + } + if res != wdVal { + c.Fatalf("Config.WorkingDir value mismatch. Expected: %s, got: %s", wdVal, res) + } + + err = inspectFieldAndMarshall(imgName, "Config.Env", &resArr) + if err != nil { + c.Fatal(err) + } + + found := false + for _, v := range resArr { + if fmt.Sprintf("%s=%s", envVar, envVal) == v { + found = true + break + } + } + if !found { + c.Fatalf("Config.Env value mismatch. Expected to exist: %s=%s, got: %v", + envVar, envVal, resArr) + } + + err = inspectFieldAndMarshall(imgName, "Config.ExposedPorts", &resMap) + if err != nil { + c.Fatal(err) + } + if _, ok := resMap[fmt.Sprintf("%s/tcp", exposeVal)]; !ok { + c.Fatalf("Config.ExposedPorts value mismatch. Expected exposed port: %s/tcp, got: %v", exposeVal, resMap) + } + + res, err = inspectField(imgName, "Config.User") + if err != nil { + c.Fatal(err) + } + if res != userVal { + c.Fatalf("Config.User value mismatch. Expected: %s, got: %s", userVal, res) + } + + err = inspectFieldAndMarshall(imgName, "Config.Volumes", &resMap) + if err != nil { + c.Fatal(err) + } + if _, ok := resMap[volVal]; !ok { + c.Fatalf("Config.Volumes value mismatch. Expected volume: %s, got: %v", volVal, resMap) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgExpansionOverride(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldvarstest" + envKey := "foo" + envVal := "bar" + envKey1 := "foo1" + envValOveride := "barOverride" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + ENV %s %s + ENV %s ${%s} + RUN echo $%s + CMD echo $%s`, envKey, envKey, envValOveride, envKey1, envKey, envKey1, envKey1) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || strings.Count(out, envValOveride) != 2 { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envValOveride) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); !strings.Contains(out, envValOveride) { + c.Fatalf("run produced invalid output: %q, expected %q", out, envValOveride) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgUntrustedDefinedAfterUse(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + RUN echo $%s + ARG %s + CMD echo $%s`, envKey, envKey, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || strings.Contains(out, envVal) { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("able to access environment variable in output: %q expected to be missing", out) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); out != "\n" { + c.Fatalf("run produced invalid output: %q, expected empty string", out) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgBuiltinArg(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "HTTP_PROXY" + envVal := "bar" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + RUN echo $%s + CMD echo $%s`, envKey, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || !strings.Contains(out, envVal) { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envVal) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); out != "\n" { + c.Fatalf("run produced invalid output: %q, expected empty string", out) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgDefaultOverride(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + envValOveride := "barOverride" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envValOveride), + } + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s=%s + ENV %s $%s + RUN echo $%s + CMD echo $%s`, envKey, envVal, envKey, envKey, envKey, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || strings.Count(out, envValOveride) != 1 { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("failed to access environment variable in output: %q expected: %q", out, envValOveride) + } + + containerName := "bldargCont" + if out, _ := dockerCmd(c, "run", "--name", containerName, imgName); !strings.Contains(out, envValOveride) { + c.Fatalf("run produced invalid output: %q, expected %q", out, envValOveride) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgMultiArgsSameLine(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envKey1 := "foo1" + args := []string{} + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s %s`, envKey, envKey1) + + errStr := "ARG requires exactly one argument definition" + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err == nil { + c.Fatalf("build succeeded, expected to fail. Output: %v", out) + } else if !strings.Contains(out, errStr) { + c.Fatalf("Unexpected error. output: %q, expected error: %q", out, errStr) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgUnconsumedArg(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envVal := "bar" + args := []string{ + "--build-arg", fmt.Sprintf("%s=%s", envKey, envVal), + } + dockerfile := fmt.Sprintf(`FROM busybox + RUN echo $%s + CMD echo $%s`, envKey, envKey) + + errStr := "One or more build-args" + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err == nil { + c.Fatalf("build succeeded, expected to fail. Output: %v", out) + } else if !strings.Contains(out, errStr) { + c.Fatalf("Unexpected error. output: %q, expected error: %q", out, errStr) + } + +} + +func (s *DockerSuite) TestBuildBuildTimeArgQuotedValVariants(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envKey1 := "foo1" + envKey2 := "foo2" + envKey3 := "foo3" + args := []string{} + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s="" + ARG %s='' + ARG %s="''" + ARG %s='""' + RUN [ "$%s" != "$%s" ] + RUN [ "$%s" != "$%s" ] + RUN [ "$%s" != "$%s" ] + RUN [ "$%s" != "$%s" ] + RUN [ "$%s" != "$%s" ]`, envKey, envKey1, envKey2, envKey3, + envKey, envKey2, envKey, envKey3, envKey1, envKey2, envKey1, envKey3, + envKey2, envKey3) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgEmptyValVariants(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + envKey1 := "foo1" + envKey2 := "foo2" + args := []string{} + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s= + ARG %s="" + ARG %s='' + RUN [ "$%s" == "$%s" ] + RUN [ "$%s" == "$%s" ] + RUN [ "$%s" == "$%s" ]`, envKey, envKey1, envKey2, envKey, envKey1, envKey1, envKey2, envKey, envKey2) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } +} + +func (s *DockerSuite) TestBuildBuildTimeArgDefintionWithNoEnvInjection(c *check.C) { + testRequires(c, DaemonIsLinux) + imgName := "bldargtest" + envKey := "foo" + args := []string{} + dockerfile := fmt.Sprintf(`FROM busybox + ARG %s + RUN env`, envKey) + + if _, out, err := buildImageWithOut(imgName, dockerfile, true, args...); err != nil || strings.Count(out, envKey) != 1 { + if err != nil { + c.Fatalf("build failed to complete: %q %q", out, err) + } + c.Fatalf("unexpected number of occurrences of the arg in output: %q expected: 1", out) + } +} + +func (s *DockerSuite) TestBuildNoNamedVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-v", "testname:/foo", "busybox", "sh", "-c", "touch /foo/oops") + + dockerFile := `FROM busybox + VOLUME testname:/foo + RUN ls /foo/oops + ` + _, err := buildImage("test", dockerFile, false) + c.Assert(err, check.NotNil, check.Commentf("image build should have failed")) +} + +// #17290 +func (s *DockerSuite) TestBuildCacheBrokenSymlink(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildbrokensymlink" + ctx, err := fakeContext(` + FROM busybox + COPY . ./`, + map[string]string{ + "foo": "bar", + }) + c.Assert(err, checker.IsNil) + defer ctx.Close() + + err = os.Symlink(filepath.Join(ctx.Dir, "nosuchfile"), filepath.Join(ctx.Dir, "asymlink")) + c.Assert(err, checker.IsNil) + + // warm up cache + _, err = buildImageFromContext(name, ctx, true) + c.Assert(err, checker.IsNil) + + // add new file to context, should invalidate cache + err = ioutil.WriteFile(filepath.Join(ctx.Dir, "newfile"), []byte("foo"), 0644) + c.Assert(err, checker.IsNil) + + _, out, err := buildImageFromContextWithOut(name, ctx, true) + c.Assert(err, checker.IsNil) + + c.Assert(out, checker.Not(checker.Contains), "Using cache") + +} + +func (s *DockerSuite) TestBuildFollowSymlinkToFile(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildbrokensymlink" + ctx, err := fakeContext(` + FROM busybox + COPY asymlink target`, + map[string]string{ + "foo": "bar", + }) + c.Assert(err, checker.IsNil) + defer ctx.Close() + + err = os.Symlink("foo", filepath.Join(ctx.Dir, "asymlink")) + c.Assert(err, checker.IsNil) + + id, err := buildImageFromContext(name, ctx, true) + c.Assert(err, checker.IsNil) + + out, _ := dockerCmd(c, "run", "--rm", id, "cat", "target") + c.Assert(out, checker.Matches, "bar") + + // change target file should invalidate cache + err = ioutil.WriteFile(filepath.Join(ctx.Dir, "foo"), []byte("baz"), 0644) + c.Assert(err, checker.IsNil) + + id, out, err = buildImageFromContextWithOut(name, ctx, true) + c.Assert(err, checker.IsNil) + c.Assert(out, checker.Not(checker.Contains), "Using cache") + + out, _ = dockerCmd(c, "run", "--rm", id, "cat", "target") + c.Assert(out, checker.Matches, "baz") +} + +func (s *DockerSuite) TestBuildFollowSymlinkToDir(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildbrokensymlink" + ctx, err := fakeContext(` + FROM busybox + COPY asymlink /`, + map[string]string{ + "foo/abc": "bar", + "foo/def": "baz", + }) + c.Assert(err, checker.IsNil) + defer ctx.Close() + + err = os.Symlink("foo", filepath.Join(ctx.Dir, "asymlink")) + c.Assert(err, checker.IsNil) + + id, err := buildImageFromContext(name, ctx, true) + c.Assert(err, checker.IsNil) + + out, _ := dockerCmd(c, "run", "--rm", id, "cat", "abc", "def") + c.Assert(out, checker.Matches, "barbaz") + + // change target file should invalidate cache + err = ioutil.WriteFile(filepath.Join(ctx.Dir, "foo/def"), []byte("bax"), 0644) + c.Assert(err, checker.IsNil) + + id, out, err = buildImageFromContextWithOut(name, ctx, true) + c.Assert(err, checker.IsNil) + c.Assert(out, checker.Not(checker.Contains), "Using cache") + + out, _ = dockerCmd(c, "run", "--rm", id, "cat", "abc", "def") + c.Assert(out, checker.Matches, "barbax") + +} + +// TestBuildSymlinkBasename tests that target file gets basename from symlink, +// not from the target file. +func (s *DockerSuite) TestBuildSymlinkBasename(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildbrokensymlink" + ctx, err := fakeContext(` + FROM busybox + COPY asymlink /`, + map[string]string{ + "foo": "bar", + }) + c.Assert(err, checker.IsNil) + defer ctx.Close() + + err = os.Symlink("foo", filepath.Join(ctx.Dir, "asymlink")) + c.Assert(err, checker.IsNil) + + id, err := buildImageFromContext(name, ctx, true) + c.Assert(err, checker.IsNil) + + out, _ := dockerCmd(c, "run", "--rm", id, "cat", "asymlink") + c.Assert(out, checker.Matches, "bar") + +} diff --git a/integration-cli/docker_cli_build_unix_test.go b/integration-cli/docker_cli_build_unix_test.go new file mode 100644 index 0000000000..fc7bd925a6 --- /dev/null +++ b/integration-cli/docker_cli_build_unix_test.go @@ -0,0 +1,72 @@ +// +build !windows + +package main + +import ( + "encoding/json" + "strings" + + "github.com/docker/docker/pkg/ulimit" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestBuildResourceConstraintsAreUsed(c *check.C) { + testRequires(c, cpuCfsQuota) + name := "testbuildresourceconstraints" + + ctx, err := fakeContext(` + FROM hello-world:frozen + RUN ["/hello"] + `, map[string]string{}) + if err != nil { + c.Fatal(err) + } + + dockerCmdInDir(c, ctx.Dir, "build", "--no-cache", "--rm=false", "--memory=64m", "--memory-swap=-1", "--cpuset-cpus=0", "--cpuset-mems=0", "--cpu-shares=100", "--cpu-quota=8000", "--ulimit", "nofile=42", "-t", name, ".") + + out, _ := dockerCmd(c, "ps", "-lq") + + cID := strings.TrimSpace(out) + + type hostConfig struct { + Memory int64 + MemorySwap int64 + CpusetCpus string + CpusetMems string + CPUShares int64 + CPUQuota int64 + Ulimits []*ulimit.Ulimit + } + + cfg, err := inspectFieldJSON(cID, "HostConfig") + if err != nil { + c.Fatal(err) + } + + var c1 hostConfig + if err := json.Unmarshal([]byte(cfg), &c1); err != nil { + c.Fatal(err, cfg) + } + if c1.Memory != 67108864 || c1.MemorySwap != -1 || c1.CpusetCpus != "0" || c1.CpusetMems != "0" || c1.CPUShares != 100 || c1.CPUQuota != 8000 || c1.Ulimits[0].Name != "nofile" || c1.Ulimits[0].Hard != 42 { + c.Fatalf("resource constraints not set properly:\nMemory: %d, MemSwap: %d, CpusetCpus: %s, CpusetMems: %s, CPUShares: %d, CPUQuota: %d, Ulimits: %s", + c1.Memory, c1.MemorySwap, c1.CpusetCpus, c1.CpusetMems, c1.CPUShares, c1.CPUQuota, c1.Ulimits[0]) + } + + // Make sure constraints aren't saved to image + dockerCmd(c, "run", "--name=test", name) + + cfg, err = inspectFieldJSON("test", "HostConfig") + if err != nil { + c.Fatal(err) + } + var c2 hostConfig + if err := json.Unmarshal([]byte(cfg), &c2); err != nil { + c.Fatal(err, cfg) + } + if c2.Memory == 67108864 || c2.MemorySwap == -1 || c2.CpusetCpus == "0" || c2.CpusetMems == "0" || c2.CPUShares == 100 || c2.CPUQuota == 8000 || c2.Ulimits != nil { + c.Fatalf("resource constraints leaked from build:\nMemory: %d, MemSwap: %d, CpusetCpus: %s, CpusetMems: %s, CPUShares: %d, CPUQuota: %d, Ulimits: %s", + c2.Memory, c2.MemorySwap, c2.CpusetCpus, c2.CpusetMems, c2.CPUShares, c2.CPUQuota, c2.Ulimits) + + } + +} diff --git a/integration-cli/docker_cli_by_digest_test.go b/integration-cli/docker_cli_by_digest_test.go new file mode 100644 index 0000000000..ad6e65bbc3 --- /dev/null +++ b/integration-cli/docker_cli_by_digest_test.go @@ -0,0 +1,564 @@ +package main + +import ( + "encoding/json" + "fmt" + "regexp" + "strings" + + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/utils" + "github.com/go-check/check" +) + +var ( + remoteRepoName = "dockercli/busybox-by-dgst" + repoName = fmt.Sprintf("%v/%s", privateRegistryURL, remoteRepoName) + pushDigestRegex = regexp.MustCompile("[\\S]+: digest: ([\\S]+) size: [0-9]+") + digestRegex = regexp.MustCompile("Digest: ([\\S]+)") +) + +func setupImage(c *check.C) (digest.Digest, error) { + return setupImageWithTag(c, "latest") +} + +func setupImageWithTag(c *check.C, tag string) (digest.Digest, error) { + containerName := "busyboxbydigest" + + dockerCmd(c, "run", "-d", "-e", "digest=1", "--name", containerName, "busybox") + + // tag the image to upload it to the private registry + repoAndTag := utils.ImageReference(repoName, tag) + if out, _, err := dockerCmdWithError("commit", containerName, repoAndTag); err != nil { + return "", fmt.Errorf("image tagging failed: %s, %v", out, err) + } + + // delete the container as we don't need it any more + if err := deleteContainer(containerName); err != nil { + return "", err + } + + // push the image + out, _, err := dockerCmdWithError("push", repoAndTag) + if err != nil { + return "", fmt.Errorf("pushing the image to the private registry has failed: %s, %v", out, err) + } + + // delete our local repo that we previously tagged + if rmiout, _, err := dockerCmdWithError("rmi", repoAndTag); err != nil { + return "", fmt.Errorf("error deleting images prior to real test: %s, %v", rmiout, err) + } + + matches := pushDigestRegex.FindStringSubmatch(out) + if len(matches) != 2 { + return "", fmt.Errorf("unable to parse digest from push output: %s", out) + } + pushDigest := matches[1] + + return digest.Digest(pushDigest), nil +} + +func (s *DockerRegistrySuite) TestPullByTagDisplaysDigest(c *check.C) { + testRequires(c, DaemonIsLinux) + pushDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + // pull from the registry using the tag + out, _ := dockerCmd(c, "pull", repoName) + + // the pull output includes "Digest: ", so find that + matches := digestRegex.FindStringSubmatch(out) + if len(matches) != 2 { + c.Fatalf("unable to parse digest from pull output: %s", out) + } + pullDigest := matches[1] + + // make sure the pushed and pull digests match + if pushDigest.String() != pullDigest { + c.Fatalf("push digest %q didn't match pull digest %q", pushDigest, pullDigest) + } +} + +func (s *DockerRegistrySuite) TestPullByDigest(c *check.C) { + testRequires(c, DaemonIsLinux) + pushDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + // pull from the registry using the @ reference + imageReference := fmt.Sprintf("%s@%s", repoName, pushDigest) + out, _ := dockerCmd(c, "pull", imageReference) + + // the pull output includes "Digest: ", so find that + matches := digestRegex.FindStringSubmatch(out) + if len(matches) != 2 { + c.Fatalf("unable to parse digest from pull output: %s", out) + } + pullDigest := matches[1] + + // make sure the pushed and pull digests match + if pushDigest.String() != pullDigest { + c.Fatalf("push digest %q didn't match pull digest %q", pushDigest, pullDigest) + } +} + +func (s *DockerRegistrySuite) TestPullByDigestNoFallback(c *check.C) { + testRequires(c, DaemonIsLinux) + // pull from the registry using the @ reference + imageReference := fmt.Sprintf("%s@sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff", repoName) + out, _, err := dockerCmdWithError("pull", imageReference) + if err == nil || !strings.Contains(out, "manifest unknown") { + c.Fatalf("expected non-zero exit status and correct error message when pulling non-existing image: %s", out) + } +} + +func (s *DockerRegistrySuite) TestCreateByDigest(c *check.C) { + pushDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + imageReference := fmt.Sprintf("%s@%s", repoName, pushDigest) + + containerName := "createByDigest" + out, _ := dockerCmd(c, "create", "--name", containerName, imageReference) + + res, err := inspectField(containerName, "Config.Image") + if err != nil { + c.Fatalf("failed to get Config.Image: %s, %v", out, err) + } + if res != imageReference { + c.Fatalf("unexpected Config.Image: %s (expected %s)", res, imageReference) + } +} + +func (s *DockerRegistrySuite) TestRunByDigest(c *check.C) { + pushDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + imageReference := fmt.Sprintf("%s@%s", repoName, pushDigest) + + containerName := "runByDigest" + out, _ := dockerCmd(c, "run", "--name", containerName, imageReference, "sh", "-c", "echo found=$digest") + + foundRegex := regexp.MustCompile("found=([^\n]+)") + matches := foundRegex.FindStringSubmatch(out) + if len(matches) != 2 { + c.Fatalf("error locating expected 'found=1' output: %s", out) + } + if matches[1] != "1" { + c.Fatalf("Expected %q, got %q", "1", matches[1]) + } + + res, err := inspectField(containerName, "Config.Image") + if err != nil { + c.Fatalf("failed to get Config.Image: %s, %v", out, err) + } + if res != imageReference { + c.Fatalf("unexpected Config.Image: %s (expected %s)", res, imageReference) + } +} + +func (s *DockerRegistrySuite) TestRemoveImageByDigest(c *check.C) { + digest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + imageReference := fmt.Sprintf("%s@%s", repoName, digest) + + // pull from the registry using the @ reference + dockerCmd(c, "pull", imageReference) + + // make sure inspect runs ok + if _, err := inspectField(imageReference, "Id"); err != nil { + c.Fatalf("failed to inspect image: %v", err) + } + + // do the delete + if err := deleteImages(imageReference); err != nil { + c.Fatalf("unexpected error deleting image: %v", err) + } + + // try to inspect again - it should error this time + if _, err := inspectField(imageReference, "Id"); err == nil { + c.Fatalf("unexpected nil err trying to inspect what should be a non-existent image") + } else if !strings.Contains(err.Error(), "No such image") { + c.Fatalf("expected 'No such image' output, got %v", err) + } +} + +func (s *DockerRegistrySuite) TestBuildByDigest(c *check.C) { + digest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + imageReference := fmt.Sprintf("%s@%s", repoName, digest) + + // pull from the registry using the @ reference + dockerCmd(c, "pull", imageReference) + + // get the image id + imageID, err := inspectField(imageReference, "Id") + if err != nil { + c.Fatalf("error getting image id: %v", err) + } + + // do the build + name := "buildbydigest" + _, err = buildImage(name, fmt.Sprintf( + `FROM %s + CMD ["/bin/echo", "Hello World"]`, imageReference), + true) + if err != nil { + c.Fatal(err) + } + + // get the build's image id + res, err := inspectField(name, "Config.Image") + if err != nil { + c.Fatal(err) + } + // make sure they match + if res != imageID { + c.Fatalf("Image %s, expected %s", res, imageID) + } +} + +func (s *DockerRegistrySuite) TestTagByDigest(c *check.C) { + digest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + imageReference := fmt.Sprintf("%s@%s", repoName, digest) + + // pull from the registry using the @ reference + dockerCmd(c, "pull", imageReference) + + // tag it + tag := "tagbydigest" + dockerCmd(c, "tag", imageReference, tag) + + expectedID, err := inspectField(imageReference, "Id") + if err != nil { + c.Fatalf("error getting original image id: %v", err) + } + + tagID, err := inspectField(tag, "Id") + if err != nil { + c.Fatalf("error getting tagged image id: %v", err) + } + + if tagID != expectedID { + c.Fatalf("expected image id %q, got %q", expectedID, tagID) + } +} + +func (s *DockerRegistrySuite) TestListImagesWithoutDigests(c *check.C) { + digest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + imageReference := fmt.Sprintf("%s@%s", repoName, digest) + + // pull from the registry using the @ reference + dockerCmd(c, "pull", imageReference) + + out, _ := dockerCmd(c, "images") + + if strings.Contains(out, "DIGEST") { + c.Fatalf("list output should not have contained DIGEST header: %s", out) + } + +} + +func (s *DockerRegistrySuite) TestListImagesWithDigests(c *check.C) { + + // setup image1 + digest1, err := setupImageWithTag(c, "tag1") + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + imageReference1 := fmt.Sprintf("%s@%s", repoName, digest1) + c.Logf("imageReference1 = %s", imageReference1) + + // pull image1 by digest + dockerCmd(c, "pull", imageReference1) + + // list images + out, _ := dockerCmd(c, "images", "--digests") + + // make sure repo shown, tag=, digest = $digest1 + re1 := regexp.MustCompile(`\s*` + repoName + `\s*\s*` + digest1.String() + `\s`) + if !re1.MatchString(out) { + c.Fatalf("expected %q: %s", re1.String(), out) + } + + // setup image2 + digest2, err := setupImageWithTag(c, "tag2") + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + imageReference2 := fmt.Sprintf("%s@%s", repoName, digest2) + c.Logf("imageReference2 = %s", imageReference2) + + // pull image1 by digest + dockerCmd(c, "pull", imageReference1) + + // pull image2 by digest + dockerCmd(c, "pull", imageReference2) + + // list images + out, _ = dockerCmd(c, "images", "--digests") + + // make sure repo shown, tag=, digest = $digest1 + if !re1.MatchString(out) { + c.Fatalf("expected %q: %s", re1.String(), out) + } + + // make sure repo shown, tag=, digest = $digest2 + re2 := regexp.MustCompile(`\s*` + repoName + `\s*\s*` + digest2.String() + `\s`) + if !re2.MatchString(out) { + c.Fatalf("expected %q: %s", re2.String(), out) + } + + // pull tag1 + dockerCmd(c, "pull", repoName+":tag1") + + // list images + out, _ = dockerCmd(c, "images", "--digests") + + // make sure image 1 has repo, tag, AND repo, , digest + reWithTag1 := regexp.MustCompile(`\s*` + repoName + `\s*tag1\s*\s`) + reWithDigest1 := regexp.MustCompile(`\s*` + repoName + `\s*\s*` + digest1.String() + `\s`) + if !reWithTag1.MatchString(out) { + c.Fatalf("expected %q: %s", reWithTag1.String(), out) + } + if !reWithDigest1.MatchString(out) { + c.Fatalf("expected %q: %s", reWithDigest1.String(), out) + } + // make sure image 2 has repo, , digest + if !re2.MatchString(out) { + c.Fatalf("expected %q: %s", re2.String(), out) + } + + // pull tag 2 + dockerCmd(c, "pull", repoName+":tag2") + + // list images + out, _ = dockerCmd(c, "images", "--digests") + + // make sure image 1 has repo, tag, digest + if !reWithTag1.MatchString(out) { + c.Fatalf("expected %q: %s", re1.String(), out) + } + + // make sure image 2 has repo, tag, digest + reWithTag2 := regexp.MustCompile(`\s*` + repoName + `\s*tag2\s*\s`) + reWithDigest2 := regexp.MustCompile(`\s*` + repoName + `\s*\s*` + digest2.String() + `\s`) + if !reWithTag2.MatchString(out) { + c.Fatalf("expected %q: %s", reWithTag2.String(), out) + } + if !reWithDigest2.MatchString(out) { + c.Fatalf("expected %q: %s", reWithDigest2.String(), out) + } + + // list images + out, _ = dockerCmd(c, "images", "--digests") + + // make sure image 1 has repo, tag, digest + if !reWithTag1.MatchString(out) { + c.Fatalf("expected %q: %s", re1.String(), out) + } + // make sure image 2 has repo, tag, digest + if !reWithTag2.MatchString(out) { + c.Fatalf("expected %q: %s", re2.String(), out) + } + // make sure busybox has tag, but not digest + busyboxRe := regexp.MustCompile(`\s*busybox\s*latest\s*\s`) + if !busyboxRe.MatchString(out) { + c.Fatalf("expected %q: %s", busyboxRe.String(), out) + } +} + +func (s *DockerRegistrySuite) TestInspectImageWithDigests(c *check.C) { + digest, err := setupImage(c) + c.Assert(err, check.IsNil, check.Commentf("error setting up image: %v", err)) + + imageReference := fmt.Sprintf("%s@%s", repoName, digest) + + // pull from the registry using the @ reference + dockerCmd(c, "pull", imageReference) + + out, _ := dockerCmd(c, "inspect", imageReference) + + var imageJSON []types.ImageInspect + if err = json.Unmarshal([]byte(out), &imageJSON); err != nil { + c.Fatalf("unable to unmarshal body for latest version: %v", err) + } + + c.Assert(len(imageJSON), check.Equals, 1) + c.Assert(len(imageJSON[0].RepoDigests), check.Equals, 1) + c.Assert(stringutils.InSlice(imageJSON[0].RepoDigests, imageReference), check.Equals, true) +} + +func (s *DockerRegistrySuite) TestPsListContainersFilterAncestorImageByDigest(c *check.C) { + digest, err := setupImage(c) + c.Assert(err, check.IsNil, check.Commentf("error setting up image: %v", err)) + + imageReference := fmt.Sprintf("%s@%s", repoName, digest) + + // pull from the registry using the @ reference + dockerCmd(c, "pull", imageReference) + + // build a image from it + imageName1 := "images_ps_filter_test" + _, err = buildImage(imageName1, fmt.Sprintf( + `FROM %s + LABEL match me 1`, imageReference), true) + c.Assert(err, check.IsNil) + + // run a container based on that + out, _ := dockerCmd(c, "run", "-d", imageReference, "echo", "hello") + expectedID := strings.TrimSpace(out) + + // run a container based on the a descendant of that too + out, _ = dockerCmd(c, "run", "-d", imageName1, "echo", "hello") + expectedID1 := strings.TrimSpace(out) + + expectedIDs := []string{expectedID, expectedID1} + + // Invalid imageReference + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", fmt.Sprintf("--filter=ancestor=busybox@%s", digest)) + if strings.TrimSpace(out) != "" { + c.Fatalf("Expected filter container for %s ancestor filter to be empty, got %v", fmt.Sprintf("busybox@%s", digest), strings.TrimSpace(out)) + } + + // Valid imageReference + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=ancestor="+imageReference) + checkPsAncestorFilterOutput(c, out, imageReference, expectedIDs) +} + +func (s *DockerRegistrySuite) TestDeleteImageByIDOnlyPulledByDigest(c *check.C) { + pushDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + // pull from the registry using the @ reference + imageReference := fmt.Sprintf("%s@%s", repoName, pushDigest) + dockerCmd(c, "pull", imageReference) + // just in case... + + imageID, err := inspectField(imageReference, "Id") + if err != nil { + c.Fatalf("error inspecting image id: %v", err) + } + + dockerCmd(c, "rmi", imageID) +} + +// TestPullFailsWithAlteredManifest tests that a `docker pull` fails when +// we have modified a manifest blob and its digest cannot be verified. +func (s *DockerRegistrySuite) TestPullFailsWithAlteredManifest(c *check.C) { + testRequires(c, DaemonIsLinux) + manifestDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + // Load the target manifest blob. + manifestBlob := s.reg.readBlobContents(c, manifestDigest) + + var imgManifest manifest.Manifest + if err := json.Unmarshal(manifestBlob, &imgManifest); err != nil { + c.Fatalf("unable to decode image manifest from blob: %s", err) + } + + // Add a malicious layer digest to the list of layers in the manifest. + imgManifest.FSLayers = append(imgManifest.FSLayers, manifest.FSLayer{ + BlobSum: digest.Digest("sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"), + }) + + // Move the existing data file aside, so that we can replace it with a + // malicious blob of data. NOTE: we defer the returned undo func. + undo := s.reg.tempMoveBlobData(c, manifestDigest) + defer undo() + + alteredManifestBlob, err := json.Marshal(imgManifest) + if err != nil { + c.Fatalf("unable to encode altered image manifest to JSON: %s", err) + } + + s.reg.writeBlobContents(c, manifestDigest, alteredManifestBlob) + + // Now try pulling that image by digest. We should get an error about + // digest verification for the manifest digest. + + // Pull from the registry using the @ reference. + imageReference := fmt.Sprintf("%s@%s", repoName, manifestDigest) + out, exitStatus, _ := dockerCmdWithError("pull", imageReference) + if exitStatus == 0 { + c.Fatalf("expected a non-zero exit status but got %d: %s", exitStatus, out) + } + + expectedErrorMsg := fmt.Sprintf("image verification failed for digest %s", manifestDigest) + if !strings.Contains(out, expectedErrorMsg) { + c.Fatalf("expected error message %q in output: %s", expectedErrorMsg, out) + } +} + +// TestPullFailsWithAlteredLayer tests that a `docker pull` fails when +// we have modified a layer blob and its digest cannot be verified. +func (s *DockerRegistrySuite) TestPullFailsWithAlteredLayer(c *check.C) { + testRequires(c, DaemonIsLinux) + manifestDigest, err := setupImage(c) + if err != nil { + c.Fatalf("error setting up image: %v", err) + } + + // Load the target manifest blob. + manifestBlob := s.reg.readBlobContents(c, manifestDigest) + + var imgManifest manifest.Manifest + if err := json.Unmarshal(manifestBlob, &imgManifest); err != nil { + c.Fatalf("unable to decode image manifest from blob: %s", err) + } + + // Next, get the digest of one of the layers from the manifest. + targetLayerDigest := imgManifest.FSLayers[0].BlobSum + + // Move the existing data file aside, so that we can replace it with a + // malicious blob of data. NOTE: we defer the returned undo func. + undo := s.reg.tempMoveBlobData(c, targetLayerDigest) + defer undo() + + // Now make a fake data blob in this directory. + s.reg.writeBlobContents(c, targetLayerDigest, []byte("This is not the data you are looking for.")) + + // Now try pulling that image by digest. We should get an error about + // digest verification for the target layer digest. + + // Pull from the registry using the @ reference. + imageReference := fmt.Sprintf("%s@%s", repoName, manifestDigest) + out, exitStatus, _ := dockerCmdWithError("pull", imageReference) + if exitStatus == 0 { + c.Fatalf("expected a zero exit status but got: %d", exitStatus) + } + + expectedErrorMsg := fmt.Sprintf("filesystem layer verification failed for digest %s", targetLayerDigest) + if !strings.Contains(out, expectedErrorMsg) { + c.Fatalf("expected error message %q in output: %s", expectedErrorMsg, out) + } +} diff --git a/integration-cli/docker_cli_commit_test.go b/integration-cli/docker_cli_commit_test.go new file mode 100644 index 0000000000..40b2d2b948 --- /dev/null +++ b/integration-cli/docker_cli_commit_test.go @@ -0,0 +1,219 @@ +package main + +import ( + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestCommitAfterContainerIsDone(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-i", "-a", "stdin", "busybox", "echo", "foo") + + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "commit", cleanedContainerID) + + cleanedImageID := strings.TrimSpace(out) + + dockerCmd(c, "inspect", cleanedImageID) +} + +func (s *DockerSuite) TestCommitWithoutPause(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-i", "-a", "stdin", "busybox", "echo", "foo") + + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "commit", "-p=false", cleanedContainerID) + + cleanedImageID := strings.TrimSpace(out) + + dockerCmd(c, "inspect", cleanedImageID) +} + +//test commit a paused container should not unpause it after commit +func (s *DockerSuite) TestCommitPausedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + defer unpauseAllContainers() + out, _ := dockerCmd(c, "run", "-i", "-d", "busybox") + + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "pause", cleanedContainerID) + + out, _ = dockerCmd(c, "commit", cleanedContainerID) + + out, err := inspectField(cleanedContainerID, "State.Paused") + c.Assert(err, check.IsNil) + if !strings.Contains(out, "true") { + c.Fatalf("commit should not unpause a paused container") + } +} + +func (s *DockerSuite) TestCommitNewFile(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "commiter", "busybox", "/bin/sh", "-c", "echo koye > /foo") + + imageID, _ := dockerCmd(c, "commit", "commiter") + imageID = strings.Trim(imageID, "\r\n") + + out, _ := dockerCmd(c, "run", imageID, "cat", "/foo") + + if actual := strings.Trim(out, "\r\n"); actual != "koye" { + c.Fatalf("expected output koye received %q", actual) + } + +} + +func (s *DockerSuite) TestCommitHardlink(c *check.C) { + testRequires(c, DaemonIsLinux) + firstOutput, _ := dockerCmd(c, "run", "-t", "--name", "hardlinks", "busybox", "sh", "-c", "touch file1 && ln file1 file2 && ls -di file1 file2") + + chunks := strings.Split(strings.TrimSpace(firstOutput), " ") + inode := chunks[0] + found := false + for _, chunk := range chunks[1:] { + if chunk == inode { + found = true + break + } + } + if !found { + c.Fatalf("Failed to create hardlink in a container. Expected to find %q in %q", inode, chunks[1:]) + } + + imageID, _ := dockerCmd(c, "commit", "hardlinks", "hardlinks") + imageID = strings.Trim(imageID, "\r\n") + + secondOutput, _ := dockerCmd(c, "run", "-t", "hardlinks", "ls", "-di", "file1", "file2") + + chunks = strings.Split(strings.TrimSpace(secondOutput), " ") + inode = chunks[0] + found = false + for _, chunk := range chunks[1:] { + if chunk == inode { + found = true + break + } + } + if !found { + c.Fatalf("Failed to create hardlink in a container. Expected to find %q in %q", inode, chunks[1:]) + } + +} + +func (s *DockerSuite) TestCommitTTY(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-t", "--name", "tty", "busybox", "/bin/ls") + + imageID, _ := dockerCmd(c, "commit", "tty", "ttytest") + imageID = strings.Trim(imageID, "\r\n") + + dockerCmd(c, "run", "ttytest", "/bin/ls") + +} + +func (s *DockerSuite) TestCommitWithHostBindMount(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "bind-commit", "-v", "/dev/null:/winning", "busybox", "true") + + imageID, _ := dockerCmd(c, "commit", "bind-commit", "bindtest") + imageID = strings.Trim(imageID, "\r\n") + + dockerCmd(c, "run", "bindtest", "true") + +} + +func (s *DockerSuite) TestCommitChange(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "test", "busybox", "true") + + imageID, _ := dockerCmd(c, "commit", + "--change", "EXPOSE 8080", + "--change", "ENV DEBUG true", + "--change", "ENV test 1", + "--change", "ENV PATH /foo", + "--change", "LABEL foo bar", + "--change", "CMD [\"/bin/sh\"]", + "--change", "WORKDIR /opt", + "--change", "ENTRYPOINT [\"/bin/sh\"]", + "--change", "USER testuser", + "--change", "VOLUME /var/lib/docker", + "--change", "ONBUILD /usr/local/bin/python-build --dir /app/src", + "test", "test-commit") + imageID = strings.Trim(imageID, "\r\n") + + expected := map[string]string{ + "Config.ExposedPorts": "map[8080/tcp:{}]", + "Config.Env": "[DEBUG=true test=1 PATH=/foo]", + "Config.Labels": "map[foo:bar]", + "Config.Cmd": "{[/bin/sh]}", + "Config.WorkingDir": "/opt", + "Config.Entrypoint": "{[/bin/sh]}", + "Config.User": "testuser", + "Config.Volumes": "map[/var/lib/docker:{}]", + "Config.OnBuild": "[/usr/local/bin/python-build --dir /app/src]", + } + + for conf, value := range expected { + res, err := inspectField(imageID, conf) + c.Assert(err, check.IsNil) + if res != value { + c.Errorf("%s('%s'), expected %s", conf, res, value) + } + } + +} + +// TODO: commit --run is deprecated, remove this once --run is removed +func (s *DockerSuite) TestCommitMergeConfigRun(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "commit-test" + out, _ := dockerCmd(c, "run", "-d", "-e=FOO=bar", "busybox", "/bin/sh", "-c", "echo testing > /tmp/foo") + id := strings.TrimSpace(out) + + dockerCmd(c, "commit", `--run={"Cmd": ["cat", "/tmp/foo"]}`, id, "commit-test") + + out, _ = dockerCmd(c, "run", "--name", name, "commit-test") + if strings.TrimSpace(out) != "testing" { + c.Fatal("run config in committed container was not merged") + } + + type cfg struct { + Env []string + Cmd []string + } + config1 := cfg{} + if err := inspectFieldAndMarshall(id, "Config", &config1); err != nil { + c.Fatal(err) + } + config2 := cfg{} + if err := inspectFieldAndMarshall(name, "Config", &config2); err != nil { + c.Fatal(err) + } + + // Env has at least PATH loaded as well here, so let's just grab the FOO one + var env1, env2 string + for _, e := range config1.Env { + if strings.HasPrefix(e, "FOO") { + env1 = e + break + } + } + for _, e := range config2.Env { + if strings.HasPrefix(e, "FOO") { + env2 = e + break + } + } + + if len(config1.Env) != len(config2.Env) || env1 != env2 && env2 != "" { + c.Fatalf("expected envs to match: %v - %v", config1.Env, config2.Env) + } + +} diff --git a/integration-cli/docker_cli_config_test.go b/integration-cli/docker_cli_config_test.go new file mode 100644 index 0000000000..908a8fde33 --- /dev/null +++ b/integration-cli/docker_cli_config_test.go @@ -0,0 +1,150 @@ +package main + +import ( + "io/ioutil" + "net/http" + "net/http/httptest" + "os" + "os/exec" + "path/filepath" + "runtime" + + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/pkg/homedir" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestConfigHttpHeader(c *check.C) { + testRequires(c, UnixCli) // Can't set/unset HOME on windows right now + // We either need a level of Go that supports Unsetenv (for cases + // when HOME/USERPROFILE isn't set), or we need to be able to use + // os/user but user.Current() only works if we aren't statically compiling + + var headers map[string][]string + + server := httptest.NewServer(http.HandlerFunc( + func(w http.ResponseWriter, r *http.Request) { + headers = r.Header + })) + defer server.Close() + + homeKey := homedir.Key() + homeVal := homedir.Get() + tmpDir, err := ioutil.TempDir("", "fake-home") + c.Assert(err, check.IsNil) + defer os.RemoveAll(tmpDir) + + dotDocker := filepath.Join(tmpDir, ".docker") + os.Mkdir(dotDocker, 0600) + tmpCfg := filepath.Join(dotDocker, "config.json") + + defer func() { os.Setenv(homeKey, homeVal) }() + os.Setenv(homeKey, tmpDir) + + data := `{ + "HttpHeaders": { "MyHeader": "MyValue" } + }` + + err = ioutil.WriteFile(tmpCfg, []byte(data), 0600) + if err != nil { + c.Fatalf("Err creating file(%s): %v", tmpCfg, err) + } + + cmd := exec.Command(dockerBinary, "-H="+server.URL[7:], "ps") + out, _, _ := runCommandWithOutput(cmd) + + if headers["User-Agent"] == nil { + c.Fatalf("Missing User-Agent: %q\nout:%v", headers, out) + } + + if headers["User-Agent"][0] != "Docker-Client/"+dockerversion.VERSION+" ("+runtime.GOOS+")" { + c.Fatalf("Badly formatted User-Agent: %q\nout:%v", headers, out) + } + + if headers["Myheader"] == nil || headers["Myheader"][0] != "MyValue" { + c.Fatalf("Missing/bad header: %q\nout:%v", headers, out) + } +} + +func (s *DockerSuite) TestConfigDir(c *check.C) { + cDir, err := ioutil.TempDir("", "fake-home") + c.Assert(err, check.IsNil) + defer os.RemoveAll(cDir) + + // First make sure pointing to empty dir doesn't generate an error + out, rc := dockerCmd(c, "--config", cDir, "ps") + + if rc != 0 { + c.Fatalf("ps1 didn't work:\nrc:%d\nout%s", rc, out) + } + + // Test with env var too + cmd := exec.Command(dockerBinary, "ps") + cmd.Env = append(os.Environ(), "DOCKER_CONFIG="+cDir) + out, rc, err = runCommandWithOutput(cmd) + + if rc != 0 || err != nil { + c.Fatalf("ps2 didn't work:\nrc:%d\nout%s\nerr:%v", rc, out, err) + } + + // Start a server so we can check to see if the config file was + // loaded properly + var headers map[string][]string + + server := httptest.NewServer(http.HandlerFunc( + func(w http.ResponseWriter, r *http.Request) { + headers = r.Header + })) + defer server.Close() + + // Create a dummy config file in our new config dir + data := `{ + "HttpHeaders": { "MyHeader": "MyValue" } + }` + + tmpCfg := filepath.Join(cDir, "config.json") + err = ioutil.WriteFile(tmpCfg, []byte(data), 0600) + if err != nil { + c.Fatalf("Err creating file(%s): %v", tmpCfg, err) + } + + cmd = exec.Command(dockerBinary, "--config", cDir, "-H="+server.URL[7:], "ps") + out, _, _ = runCommandWithOutput(cmd) + + if headers["Myheader"] == nil || headers["Myheader"][0] != "MyValue" { + c.Fatalf("ps3 - Missing header: %q\nout:%v", headers, out) + } + + // Reset headers and try again using env var this time + headers = map[string][]string{} + cmd = exec.Command(dockerBinary, "-H="+server.URL[7:], "ps") + cmd.Env = append(os.Environ(), "DOCKER_CONFIG="+cDir) + out, _, _ = runCommandWithOutput(cmd) + + if headers["Myheader"] == nil || headers["Myheader"][0] != "MyValue" { + c.Fatalf("ps4 - Missing header: %q\nout:%v", headers, out) + } + + // Reset headers and make sure flag overrides the env var + headers = map[string][]string{} + cmd = exec.Command(dockerBinary, "--config", cDir, "-H="+server.URL[7:], "ps") + cmd.Env = append(os.Environ(), "DOCKER_CONFIG=MissingDir") + out, _, _ = runCommandWithOutput(cmd) + + if headers["Myheader"] == nil || headers["Myheader"][0] != "MyValue" { + c.Fatalf("ps5 - Missing header: %q\nout:%v", headers, out) + } + + // Reset headers and make sure flag overrides the env var. + // Almost same as previous but make sure the "MissingDir" isn't + // ignore - we don't want to default back to the env var. + headers = map[string][]string{} + cmd = exec.Command(dockerBinary, "--config", "MissingDir", "-H="+server.URL[7:], "ps") + cmd.Env = append(os.Environ(), "DOCKER_CONFIG="+cDir) + out, _, _ = runCommandWithOutput(cmd) + + if headers["Myheader"] != nil { + c.Fatalf("ps6 - Headers are there but shouldn't be: %q\nout:%v", headers, out) + } + +} diff --git a/integration-cli/docker_cli_cp_from_container_test.go b/integration-cli/docker_cli_cp_from_container_test.go new file mode 100644 index 0000000000..2618384c87 --- /dev/null +++ b/integration-cli/docker_cli_cp_from_container_test.go @@ -0,0 +1,626 @@ +package main + +import ( + "os" + "path/filepath" + + "github.com/go-check/check" +) + +// docker cp CONTAINER:PATH LOCALPATH + +// Try all of the test cases from the archive package which implements the +// internals of `docker cp` and ensure that the behavior matches when actually +// copying to and from containers. + +// Basic assumptions about SRC and DST: +// 1. SRC must exist. +// 2. If SRC ends with a trailing separator, it must be a directory. +// 3. DST parent directory must exist. +// 4. If DST exists as a file, it must not end with a trailing separator. + +// First get these easy error cases out of the way. + +// Test for error when SRC does not exist. +func (s *DockerSuite) TestCpFromErrSrcNotExists(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-err-src-not-exists") + defer os.RemoveAll(tmpDir) + + err := runDockerCp(c, containerCpPath(cID, "file1"), tmpDir) + if err == nil { + c.Fatal("expected IsNotExist error, but got nil instead") + } + + if !isCpNotExist(err) { + c.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } +} + +// Test for error when SRC ends in a trailing +// path separator but it exists as a file. +func (s *DockerSuite) TestCpFromErrSrcNotDir(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-err-src-not-dir") + defer os.RemoveAll(tmpDir) + + err := runDockerCp(c, containerCpPathTrailingSep(cID, "file1"), tmpDir) + if err == nil { + c.Fatal("expected IsNotDir error, but got nil instead") + } + + if !isCpNotDir(err) { + c.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } +} + +// Test for error when SRC is a valid file or directory, +// bu the DST parent directory does not exist. +func (s *DockerSuite) TestCpFromErrDstParentNotExists(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-err-dst-parent-not-exists") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + // Try with a file source. + srcPath := containerCpPath(cID, "/file1") + dstPath := cpPath(tmpDir, "notExists", "file1") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected IsNotExist error, but got nil instead") + } + + if !isCpNotExist(err) { + c.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } + + // Try with a directory source. + srcPath = containerCpPath(cID, "/dir1") + + if err := runDockerCp(c, srcPath, dstPath); err == nil { + c.Fatal("expected IsNotExist error, but got nil instead") + } + + if !isCpNotExist(err) { + c.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } +} + +// Test for error when DST ends in a trailing +// path separator but exists as a file. +func (s *DockerSuite) TestCpFromErrDstNotDir(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-err-dst-not-dir") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + // Try with a file source. + srcPath := containerCpPath(cID, "/file1") + dstPath := cpPathTrailingSep(tmpDir, "file1") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected IsNotDir error, but got nil instead") + } + + if !isCpNotDir(err) { + c.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } + + // Try with a directory source. + srcPath = containerCpPath(cID, "/dir1") + + if err := runDockerCp(c, srcPath, dstPath); err == nil { + c.Fatal("expected IsNotDir error, but got nil instead") + } + + if !isCpNotDir(err) { + c.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } +} + +// Check that copying from a container to a local symlink copies to the symlink +// target and does not overwrite the local symlink itself. +func (s *DockerSuite) TestCpFromSymlinkDestination(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-err-dst-not-dir") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + // First, copy a file from the container to a symlink to a file. This + // should overwrite the symlink target contents with the source contents. + srcPath := containerCpPath(cID, "/file2") + dstPath := cpPath(tmpDir, "symlinkToFile1") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, dstPath, "file1"); err != nil { + c.Fatal(err) + } + + // The file should have the contents of "file2" now. + if err := fileContentEquals(c, cpPath(tmpDir, "file1"), "file2\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a file from the container to a symlink to a directory. This + // should copy the file into the symlink target directory. + dstPath = cpPath(tmpDir, "symlinkToDir1") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, dstPath, "dir1"); err != nil { + c.Fatal(err) + } + + // The file should have the contents of "file2" now. + if err := fileContentEquals(c, cpPath(tmpDir, "file2"), "file2\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a file from the container to a symlink to a file that does + // not exist (a broken symlink). This should create the target file with + // the contents of the source file. + dstPath = cpPath(tmpDir, "brokenSymlinkToFileX") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, dstPath, "fileX"); err != nil { + c.Fatal(err) + } + + // The file should have the contents of "file2" now. + if err := fileContentEquals(c, cpPath(tmpDir, "fileX"), "file2\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a directory from the container to a symlink to a local + // directory. This should copy the directory into the symlink target + // directory and not modify the symlink. + srcPath = containerCpPath(cID, "/dir2") + dstPath = cpPath(tmpDir, "symlinkToDir1") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, dstPath, "dir1"); err != nil { + c.Fatal(err) + } + + // The directory should now contain a copy of "dir2". + if err := fileContentEquals(c, cpPath(tmpDir, "dir1/dir2/file2-1"), "file2-1\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a directory from the container to a symlink to a local + // directory that does not exist (a broken symlink). This should create + // the target as a directory with the contents of the source directory. It + // should not modify the symlink. + dstPath = cpPath(tmpDir, "brokenSymlinkToDirX") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, dstPath, "dirX"); err != nil { + c.Fatal(err) + } + + // The "dirX" directory should now be a copy of "dir2". + if err := fileContentEquals(c, cpPath(tmpDir, "dirX/file2-1"), "file2-1\n"); err != nil { + c.Fatal(err) + } +} + +// Possibilities are reduced to the remaining 10 cases: +// +// case | srcIsDir | onlyDirContents | dstExists | dstIsDir | dstTrSep | action +// =================================================================================================== +// A | no | - | no | - | no | create file +// B | no | - | no | - | yes | error +// C | no | - | yes | no | - | overwrite file +// D | no | - | yes | yes | - | create file in dst dir +// E | yes | no | no | - | - | create dir, copy contents +// F | yes | no | yes | no | - | error +// G | yes | no | yes | yes | - | copy dir and contents +// H | yes | yes | no | - | - | create dir, copy contents +// I | yes | yes | yes | no | - | error +// J | yes | yes | yes | yes | - | copy dir contents +// + +// A. SRC specifies a file and DST (no trailing path separator) doesn't +// exist. This should create a file with the name DST and copy the +// contents of the source file into it. +func (s *DockerSuite) TestCpFromCaseA(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-a") + defer os.RemoveAll(tmpDir) + + srcPath := containerCpPath(cID, "/root/file1") + dstPath := cpPath(tmpDir, "itWorks.txt") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1\n"); err != nil { + c.Fatal(err) + } +} + +// B. SRC specifies a file and DST (with trailing path separator) doesn't +// exist. This should cause an error because the copy operation cannot +// create a directory when copying a single file. +func (s *DockerSuite) TestCpFromCaseB(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-b") + defer os.RemoveAll(tmpDir) + + srcPath := containerCpPath(cID, "/file1") + dstDir := cpPathTrailingSep(tmpDir, "testDir") + + err := runDockerCp(c, srcPath, dstDir) + if err == nil { + c.Fatal("expected DirNotExists error, but got nil instead") + } + + if !isCpDirNotExist(err) { + c.Fatalf("expected DirNotExists error, but got %T: %s", err, err) + } +} + +// C. SRC specifies a file and DST exists as a file. This should overwrite +// the file at DST with the contents of the source file. +func (s *DockerSuite) TestCpFromCaseC(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-c") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := containerCpPath(cID, "/root/file1") + dstPath := cpPath(tmpDir, "file2") + + // Ensure the local file starts with different content. + if err := fileContentEquals(c, dstPath, "file2\n"); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1\n"); err != nil { + c.Fatal(err) + } +} + +// D. SRC specifies a file and DST exists as a directory. This should place +// a copy of the source file inside it using the basename from SRC. Ensure +// this works whether DST has a trailing path separator or not. +func (s *DockerSuite) TestCpFromCaseD(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-d") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := containerCpPath(cID, "/file1") + dstDir := cpPath(tmpDir, "dir1") + dstPath := filepath.Join(dstDir, "file1") + + // Ensure that dstPath doesn't exist. + if _, err := os.Stat(dstPath); !os.IsNotExist(err) { + c.Fatalf("did not expect dstPath %q to exist", dstPath) + } + + if err := runDockerCp(c, srcPath, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err := os.RemoveAll(dstDir); err != nil { + c.Fatalf("unable to remove dstDir: %s", err) + } + + if err := os.MkdirAll(dstDir, os.FileMode(0755)); err != nil { + c.Fatalf("unable to make dstDir: %s", err) + } + + dstDir = cpPathTrailingSep(tmpDir, "dir1") + + if err := runDockerCp(c, srcPath, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1\n"); err != nil { + c.Fatal(err) + } +} + +// E. SRC specifies a directory and DST does not exist. This should create a +// directory at DST and copy the contents of the SRC directory into the DST +// directory. Ensure this works whether DST has a trailing path separator or +// not. +func (s *DockerSuite) TestCpFromCaseE(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-e") + defer os.RemoveAll(tmpDir) + + srcDir := containerCpPath(cID, "dir1") + dstDir := cpPath(tmpDir, "testDir") + dstPath := filepath.Join(dstDir, "file1-1") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err := os.RemoveAll(dstDir); err != nil { + c.Fatalf("unable to remove dstDir: %s", err) + } + + dstDir = cpPathTrailingSep(tmpDir, "testDir") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// F. SRC specifies a directory and DST exists as a file. This should cause an +// error as it is not possible to overwrite a file with a directory. +func (s *DockerSuite) TestCpFromCaseF(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-f") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := containerCpPath(cID, "/root/dir1") + dstFile := cpPath(tmpDir, "file1") + + err := runDockerCp(c, srcDir, dstFile) + if err == nil { + c.Fatal("expected ErrCannotCopyDir error, but got nil instead") + } + + if !isCpCannotCopyDir(err) { + c.Fatalf("expected ErrCannotCopyDir error, but got %T: %s", err, err) + } +} + +// G. SRC specifies a directory and DST exists as a directory. This should copy +// the SRC directory and all its contents to the DST directory. Ensure this +// works whether DST has a trailing path separator or not. +func (s *DockerSuite) TestCpFromCaseG(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-g") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := containerCpPath(cID, "/root/dir1") + dstDir := cpPath(tmpDir, "dir2") + resultDir := filepath.Join(dstDir, "dir1") + dstPath := filepath.Join(resultDir, "file1-1") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err := os.RemoveAll(dstDir); err != nil { + c.Fatalf("unable to remove dstDir: %s", err) + } + + if err := os.MkdirAll(dstDir, os.FileMode(0755)); err != nil { + c.Fatalf("unable to make dstDir: %s", err) + } + + dstDir = cpPathTrailingSep(tmpDir, "dir2") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// H. SRC specifies a directory's contents only and DST does not exist. This +// should create a directory at DST and copy the contents of the SRC +// directory (but not the directory itself) into the DST directory. Ensure +// this works whether DST has a trailing path separator or not. +func (s *DockerSuite) TestCpFromCaseH(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-h") + defer os.RemoveAll(tmpDir) + + srcDir := containerCpPathTrailingSep(cID, "dir1") + "." + dstDir := cpPath(tmpDir, "testDir") + dstPath := filepath.Join(dstDir, "file1-1") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err := os.RemoveAll(dstDir); err != nil { + c.Fatalf("unable to remove resultDir: %s", err) + } + + dstDir = cpPathTrailingSep(tmpDir, "testDir") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// I. SRC specifies a directory's contents only and DST exists as a file. This +// should cause an error as it is not possible to overwrite a file with a +// directory. +func (s *DockerSuite) TestCpFromCaseI(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-i") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := containerCpPathTrailingSep(cID, "/root/dir1") + "." + dstFile := cpPath(tmpDir, "file1") + + err := runDockerCp(c, srcDir, dstFile) + if err == nil { + c.Fatal("expected ErrCannotCopyDir error, but got nil instead") + } + + if !isCpCannotCopyDir(err) { + c.Fatalf("expected ErrCannotCopyDir error, but got %T: %s", err, err) + } +} + +// J. SRC specifies a directory's contents only and DST exists as a directory. +// This should copy the contents of the SRC directory (but not the directory +// itself) into the DST directory. Ensure this works whether DST has a +// trailing path separator or not. +func (s *DockerSuite) TestCpFromCaseJ(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-from-case-j") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := containerCpPathTrailingSep(cID, "/root/dir1") + "." + dstDir := cpPath(tmpDir, "dir2") + dstPath := filepath.Join(dstDir, "file1-1") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err := os.RemoveAll(dstDir); err != nil { + c.Fatalf("unable to remove dstDir: %s", err) + } + + if err := os.MkdirAll(dstDir, os.FileMode(0755)); err != nil { + c.Fatalf("unable to make dstDir: %s", err) + } + + dstDir = cpPathTrailingSep(tmpDir, "dir2") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := fileContentEquals(c, dstPath, "file1-1\n"); err != nil { + c.Fatal(err) + } +} diff --git a/integration-cli/docker_cli_cp_test.go b/integration-cli/docker_cli_cp_test.go new file mode 100644 index 0000000000..64be8e2388 --- /dev/null +++ b/integration-cli/docker_cli_cp_test.go @@ -0,0 +1,820 @@ +package main + +import ( + "bytes" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path" + "path/filepath" + "strings" + + "github.com/go-check/check" +) + +const ( + cpTestPathParent = "/some" + cpTestPath = "/some/path" + cpTestName = "test" + cpFullPath = "/some/path/test" + + cpContainerContents = "holla, i am the container" + cpHostContents = "hello, i am the host" +) + +// Ensure that an all-local path case returns an error. +func (s *DockerSuite) TestCpLocalOnly(c *check.C) { + err := runDockerCp(c, "foo", "bar") + if err == nil { + c.Fatal("expected failure, got success") + } + + if !strings.Contains(err.Error(), "must specify at least one container source") { + c.Fatalf("unexpected output: %s", err.Error()) + } +} + +// Test for #5656 +// Check that garbage paths don't escape the container's rootfs +func (s *DockerSuite) TestCpGarbagePath(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "mkdir -p '"+cpTestPath+"' && echo -n '"+cpContainerContents+"' > "+cpFullPath) + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + if err := os.MkdirAll(cpTestPath, os.ModeDir); err != nil { + c.Fatal(err) + } + + hostFile, err := os.Create(cpFullPath) + if err != nil { + c.Fatal(err) + } + defer hostFile.Close() + defer os.RemoveAll(cpTestPathParent) + + fmt.Fprintf(hostFile, "%s", cpHostContents) + + tmpdir, err := ioutil.TempDir("", "docker-integration") + if err != nil { + c.Fatal(err) + } + + tmpname := filepath.Join(tmpdir, cpTestName) + defer os.RemoveAll(tmpdir) + + path := path.Join("../../../../../../../../../../../../", cpFullPath) + + dockerCmd(c, "cp", cleanedContainerID+":"+path, tmpdir) + + file, _ := os.Open(tmpname) + defer file.Close() + + test, err := ioutil.ReadAll(file) + if err != nil { + c.Fatal(err) + } + + if string(test) == cpHostContents { + c.Errorf("output matched host file -- garbage path can escape container rootfs") + } + + if string(test) != cpContainerContents { + c.Errorf("output doesn't match the input for garbage path") + } + +} + +// Check that relative paths are relative to the container's rootfs +func (s *DockerSuite) TestCpRelativePath(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "mkdir -p '"+cpTestPath+"' && echo -n '"+cpContainerContents+"' > "+cpFullPath) + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + if err := os.MkdirAll(cpTestPath, os.ModeDir); err != nil { + c.Fatal(err) + } + + hostFile, err := os.Create(cpFullPath) + if err != nil { + c.Fatal(err) + } + defer hostFile.Close() + defer os.RemoveAll(cpTestPathParent) + + fmt.Fprintf(hostFile, "%s", cpHostContents) + + tmpdir, err := ioutil.TempDir("", "docker-integration") + + if err != nil { + c.Fatal(err) + } + + tmpname := filepath.Join(tmpdir, cpTestName) + defer os.RemoveAll(tmpdir) + + var relPath string + if path.IsAbs(cpFullPath) { + // normally this is `filepath.Rel("/", cpFullPath)` but we cannot + // get this unix-path manipulation on windows with filepath. + relPath = cpFullPath[1:] + } else { + c.Fatalf("path %s was assumed to be an absolute path", cpFullPath) + } + + dockerCmd(c, "cp", cleanedContainerID+":"+relPath, tmpdir) + + file, _ := os.Open(tmpname) + defer file.Close() + + test, err := ioutil.ReadAll(file) + if err != nil { + c.Fatal(err) + } + + if string(test) == cpHostContents { + c.Errorf("output matched host file -- relative path can escape container rootfs") + } + + if string(test) != cpContainerContents { + c.Errorf("output doesn't match the input for relative path") + } + +} + +// Check that absolute paths are relative to the container's rootfs +func (s *DockerSuite) TestCpAbsolutePath(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "mkdir -p '"+cpTestPath+"' && echo -n '"+cpContainerContents+"' > "+cpFullPath) + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + if err := os.MkdirAll(cpTestPath, os.ModeDir); err != nil { + c.Fatal(err) + } + + hostFile, err := os.Create(cpFullPath) + if err != nil { + c.Fatal(err) + } + defer hostFile.Close() + defer os.RemoveAll(cpTestPathParent) + + fmt.Fprintf(hostFile, "%s", cpHostContents) + + tmpdir, err := ioutil.TempDir("", "docker-integration") + + if err != nil { + c.Fatal(err) + } + + tmpname := filepath.Join(tmpdir, cpTestName) + defer os.RemoveAll(tmpdir) + + path := cpFullPath + + dockerCmd(c, "cp", cleanedContainerID+":"+path, tmpdir) + + file, _ := os.Open(tmpname) + defer file.Close() + + test, err := ioutil.ReadAll(file) + if err != nil { + c.Fatal(err) + } + + if string(test) == cpHostContents { + c.Errorf("output matched host file -- absolute path can escape container rootfs") + } + + if string(test) != cpContainerContents { + c.Errorf("output doesn't match the input for absolute path") + } + +} + +// Test for #5619 +// Check that absolute symlinks are still relative to the container's rootfs +func (s *DockerSuite) TestCpAbsoluteSymlink(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "mkdir -p '"+cpTestPath+"' && echo -n '"+cpContainerContents+"' > "+cpFullPath+" && ln -s "+cpFullPath+" container_path") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + if err := os.MkdirAll(cpTestPath, os.ModeDir); err != nil { + c.Fatal(err) + } + + hostFile, err := os.Create(cpFullPath) + if err != nil { + c.Fatal(err) + } + defer hostFile.Close() + defer os.RemoveAll(cpTestPathParent) + + fmt.Fprintf(hostFile, "%s", cpHostContents) + + tmpdir, err := ioutil.TempDir("", "docker-integration") + + if err != nil { + c.Fatal(err) + } + + tmpname := filepath.Join(tmpdir, "container_path") + defer os.RemoveAll(tmpdir) + + path := path.Join("/", "container_path") + + dockerCmd(c, "cp", cleanedContainerID+":"+path, tmpdir) + + // We should have copied a symlink *NOT* the file itself! + linkTarget, err := os.Readlink(tmpname) + if err != nil { + c.Fatal(err) + } + + if linkTarget != filepath.FromSlash(cpFullPath) { + c.Errorf("symlink target was %q, but expected: %q", linkTarget, cpFullPath) + } +} + +// Check that symlinks to a directory behave as expected when copying one from +// a container. +func (s *DockerSuite) TestCpFromSymlinkToDirectory(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "mkdir -p '"+cpTestPath+"' && echo -n '"+cpContainerContents+"' > "+cpFullPath+" && ln -s "+cpTestPathParent+" /dir_link") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + testDir, err := ioutil.TempDir("", "test-cp-from-symlink-to-dir-") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(testDir) + + // This copy command should copy the symlink, not the target, into the + // temporary directory. + dockerCmd(c, "cp", cleanedContainerID+":"+"/dir_link", testDir) + + expectedPath := filepath.Join(testDir, "dir_link") + linkTarget, err := os.Readlink(expectedPath) + if err != nil { + c.Fatalf("unable to read symlink at %q: %v", expectedPath, err) + } + + if linkTarget != filepath.FromSlash(cpTestPathParent) { + c.Errorf("symlink target was %q, but expected: %q", linkTarget, cpTestPathParent) + } + + os.Remove(expectedPath) + + // This copy command should resolve the symlink (note the trailing + // separator), copying the target into the temporary directory. + dockerCmd(c, "cp", cleanedContainerID+":"+"/dir_link/", testDir) + + // It *should not* have copied the directory using the target's name, but + // used the given name instead. + unexpectedPath := filepath.Join(testDir, cpTestPathParent) + if stat, err := os.Lstat(unexpectedPath); err == nil { + c.Fatalf("target name was copied: %q - %q", stat.Mode(), stat.Name()) + } + + // It *should* have copied the directory using the asked name "dir_link". + stat, err := os.Lstat(expectedPath) + if err != nil { + c.Fatalf("unable to stat resource at %q: %v", expectedPath, err) + } + + if !stat.IsDir() { + c.Errorf("should have copied a directory but got %q instead", stat.Mode()) + } +} + +// Check that symlinks to a directory behave as expected when copying one to a +// container. +func (s *DockerSuite) TestCpToSymlinkToDirectory(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) // Requires local volume mount bind. + + testVol, err := ioutil.TempDir("", "test-cp-to-symlink-to-dir-") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(testVol) + + // Create a test container with a local volume. We will test by copying + // to the volume path in the container which we can then verify locally. + out, exitCode := dockerCmd(c, "create", "-v", testVol+":/testVol", "busybox") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + // Create a temp directory to hold a test file nested in a direcotry. + testDir, err := ioutil.TempDir("", "test-cp-to-symlink-to-dir-") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(testDir) + + // This file will be at "/testDir/some/path/test" and will be copied into + // the test volume later. + hostTestFilename := filepath.Join(testDir, cpFullPath) + if err := os.MkdirAll(filepath.Dir(hostTestFilename), os.FileMode(0700)); err != nil { + c.Fatal(err) + } + if err := ioutil.WriteFile(hostTestFilename, []byte(cpHostContents), os.FileMode(0600)); err != nil { + c.Fatal(err) + } + + // Now create another temp directory to hold a symlink to the + // "/testDir/some" directory. + linkDir, err := ioutil.TempDir("", "test-cp-to-symlink-to-dir-") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(linkDir) + + // Then symlink "/linkDir/dir_link" to "/testdir/some". + linkTarget := filepath.Join(testDir, cpTestPathParent) + localLink := filepath.Join(linkDir, "dir_link") + if err := os.Symlink(linkTarget, localLink); err != nil { + c.Fatal(err) + } + + // Now copy that symlink into the test volume in the container. + dockerCmd(c, "cp", localLink, cleanedContainerID+":/testVol") + + // This copy command should have copied the symlink *not* the target. + expectedPath := filepath.Join(testVol, "dir_link") + actualLinkTarget, err := os.Readlink(expectedPath) + if err != nil { + c.Fatalf("unable to read symlink at %q: %v", expectedPath, err) + } + + if actualLinkTarget != linkTarget { + c.Errorf("symlink target was %q, but expected: %q", actualLinkTarget, linkTarget) + } + + // Good, now remove that copied link for the next test. + os.Remove(expectedPath) + + // This copy command should resolve the symlink (note the trailing + // separator), copying the target into the test volume directory in the + // container. + dockerCmd(c, "cp", localLink+"/", cleanedContainerID+":/testVol") + + // It *should not* have copied the directory using the target's name, but + // used the given name instead. + unexpectedPath := filepath.Join(testVol, cpTestPathParent) + if stat, err := os.Lstat(unexpectedPath); err == nil { + c.Fatalf("target name was copied: %q - %q", stat.Mode(), stat.Name()) + } + + // It *should* have copied the directory using the asked name "dir_link". + stat, err := os.Lstat(expectedPath) + if err != nil { + c.Fatalf("unable to stat resource at %q: %v", expectedPath, err) + } + + if !stat.IsDir() { + c.Errorf("should have copied a directory but got %q instead", stat.Mode()) + } + + // And this directory should contain the file copied from the host at the + // expected location: "/testVol/dir_link/path/test" + expectedFilepath := filepath.Join(testVol, "dir_link/path/test") + fileContents, err := ioutil.ReadFile(expectedFilepath) + if err != nil { + c.Fatal(err) + } + + if string(fileContents) != cpHostContents { + c.Fatalf("file contains %q but expected %q", string(fileContents), cpHostContents) + } +} + +// Test for #5619 +// Check that symlinks which are part of the resource path are still relative to the container's rootfs +func (s *DockerSuite) TestCpSymlinkComponent(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "mkdir -p '"+cpTestPath+"' && echo -n '"+cpContainerContents+"' > "+cpFullPath+" && ln -s "+cpTestPath+" container_path") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + if err := os.MkdirAll(cpTestPath, os.ModeDir); err != nil { + c.Fatal(err) + } + + hostFile, err := os.Create(cpFullPath) + if err != nil { + c.Fatal(err) + } + defer hostFile.Close() + defer os.RemoveAll(cpTestPathParent) + + fmt.Fprintf(hostFile, "%s", cpHostContents) + + tmpdir, err := ioutil.TempDir("", "docker-integration") + + if err != nil { + c.Fatal(err) + } + + tmpname := filepath.Join(tmpdir, cpTestName) + defer os.RemoveAll(tmpdir) + + path := path.Join("/", "container_path", cpTestName) + + dockerCmd(c, "cp", cleanedContainerID+":"+path, tmpdir) + + file, _ := os.Open(tmpname) + defer file.Close() + + test, err := ioutil.ReadAll(file) + if err != nil { + c.Fatal(err) + } + + if string(test) == cpHostContents { + c.Errorf("output matched host file -- symlink path component can escape container rootfs") + } + + if string(test) != cpContainerContents { + c.Errorf("output doesn't match the input for symlink path component") + } + +} + +// Check that cp with unprivileged user doesn't return any error +func (s *DockerSuite) TestCpUnprivilegedUser(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, UnixCli) // uses chmod/su: not available on windows + + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "touch "+cpTestName) + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + tmpdir, err := ioutil.TempDir("", "docker-integration") + if err != nil { + c.Fatal(err) + } + + defer os.RemoveAll(tmpdir) + + if err = os.Chmod(tmpdir, 0777); err != nil { + c.Fatal(err) + } + + path := cpTestName + + _, _, err = runCommandWithOutput(exec.Command("su", "unprivilegeduser", "-c", dockerBinary+" cp "+cleanedContainerID+":"+path+" "+tmpdir)) + if err != nil { + c.Fatalf("couldn't copy with unprivileged user: %s:%s %s", cleanedContainerID, path, err) + } + +} + +func (s *DockerSuite) TestCpSpecialFiles(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + outDir, err := ioutil.TempDir("", "cp-test-special-files") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(outDir) + + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "touch /foo") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + // Copy actual /etc/resolv.conf + dockerCmd(c, "cp", cleanedContainerID+":/etc/resolv.conf", outDir) + + expected, err := readContainerFile(cleanedContainerID, "resolv.conf") + actual, err := ioutil.ReadFile(outDir + "/resolv.conf") + + if !bytes.Equal(actual, expected) { + c.Fatalf("Expected copied file to be duplicate of the container resolvconf") + } + + // Copy actual /etc/hosts + dockerCmd(c, "cp", cleanedContainerID+":/etc/hosts", outDir) + + expected, err = readContainerFile(cleanedContainerID, "hosts") + actual, err = ioutil.ReadFile(outDir + "/hosts") + + if !bytes.Equal(actual, expected) { + c.Fatalf("Expected copied file to be duplicate of the container hosts") + } + + // Copy actual /etc/resolv.conf + dockerCmd(c, "cp", cleanedContainerID+":/etc/hostname", outDir) + + expected, err = readContainerFile(cleanedContainerID, "hostname") + actual, err = ioutil.ReadFile(outDir + "/hostname") + + if !bytes.Equal(actual, expected) { + c.Fatalf("Expected copied file to be duplicate of the container resolvconf") + } + +} + +func (s *DockerSuite) TestCpVolumePath(c *check.C) { + // stat /tmp/cp-test-volumepath851508420/test gets permission denied for the user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + tmpDir, err := ioutil.TempDir("", "cp-test-volumepath") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpDir) + outDir, err := ioutil.TempDir("", "cp-test-volumepath-out") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(outDir) + _, err = os.Create(tmpDir + "/test") + if err != nil { + c.Fatal(err) + } + + out, exitCode := dockerCmd(c, "run", "-d", "-v", "/foo", "-v", tmpDir+"/test:/test", "-v", tmpDir+":/baz", "busybox", "/bin/sh", "-c", "touch /foo/bar") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + // Copy actual volume path + dockerCmd(c, "cp", cleanedContainerID+":/foo", outDir) + + stat, err := os.Stat(outDir + "/foo") + if err != nil { + c.Fatal(err) + } + if !stat.IsDir() { + c.Fatal("expected copied content to be dir") + } + stat, err = os.Stat(outDir + "/foo/bar") + if err != nil { + c.Fatal(err) + } + if stat.IsDir() { + c.Fatal("Expected file `bar` to be a file") + } + + // Copy file nested in volume + dockerCmd(c, "cp", cleanedContainerID+":/foo/bar", outDir) + + stat, err = os.Stat(outDir + "/bar") + if err != nil { + c.Fatal(err) + } + if stat.IsDir() { + c.Fatal("Expected file `bar` to be a file") + } + + // Copy Bind-mounted dir + dockerCmd(c, "cp", cleanedContainerID+":/baz", outDir) + stat, err = os.Stat(outDir + "/baz") + if err != nil { + c.Fatal(err) + } + if !stat.IsDir() { + c.Fatal("Expected `baz` to be a dir") + } + + // Copy file nested in bind-mounted dir + dockerCmd(c, "cp", cleanedContainerID+":/baz/test", outDir) + fb, err := ioutil.ReadFile(outDir + "/baz/test") + if err != nil { + c.Fatal(err) + } + fb2, err := ioutil.ReadFile(tmpDir + "/test") + if err != nil { + c.Fatal(err) + } + if !bytes.Equal(fb, fb2) { + c.Fatalf("Expected copied file to be duplicate of bind-mounted file") + } + + // Copy bind-mounted file + dockerCmd(c, "cp", cleanedContainerID+":/test", outDir) + fb, err = ioutil.ReadFile(outDir + "/test") + if err != nil { + c.Fatal(err) + } + fb2, err = ioutil.ReadFile(tmpDir + "/test") + if err != nil { + c.Fatal(err) + } + if !bytes.Equal(fb, fb2) { + c.Fatalf("Expected copied file to be duplicate of bind-mounted file") + } + +} + +func (s *DockerSuite) TestCpToDot(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "echo lololol > /test") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + tmpdir, err := ioutil.TempDir("", "docker-integration") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpdir) + cwd, err := os.Getwd() + if err != nil { + c.Fatal(err) + } + defer os.Chdir(cwd) + if err := os.Chdir(tmpdir); err != nil { + c.Fatal(err) + } + dockerCmd(c, "cp", cleanedContainerID+":/test", ".") + content, err := ioutil.ReadFile("./test") + if string(content) != "lololol\n" { + c.Fatalf("Wrong content in copied file %q, should be %q", content, "lololol\n") + } +} + +func (s *DockerSuite) TestCpToStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "echo lololol > /test") + if exitCode != 0 { + c.Fatalf("failed to create a container:%s\n", out) + } + + cID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cID) + if strings.TrimSpace(out) != "0" { + c.Fatalf("failed to set up container:%s\n", out) + } + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "cp", cID+":/test", "-"), + exec.Command("tar", "-vtf", "-")) + + if err != nil { + c.Fatalf("Failed to run commands: %s", err) + } + + if !strings.Contains(out, "test") || !strings.Contains(out, "-rw") { + c.Fatalf("Missing file from tar TOC:\n%s", out) + } +} + +func (s *DockerSuite) TestCpNameHasColon(c *check.C) { + testRequires(c, SameHostDaemon) + + out, exitCode := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "echo lololol > /te:s:t") + if exitCode != 0 { + c.Fatal("failed to create a container", out) + } + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "wait", cleanedContainerID) + if strings.TrimSpace(out) != "0" { + c.Fatal("failed to set up container", out) + } + + tmpdir, err := ioutil.TempDir("", "docker-integration") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpdir) + dockerCmd(c, "cp", cleanedContainerID+":/te:s:t", tmpdir) + content, err := ioutil.ReadFile(tmpdir + "/te:s:t") + if string(content) != "lololol\n" { + c.Fatalf("Wrong content in copied file %q, should be %q", content, "lololol\n") + } +} + +func (s *DockerSuite) TestCopyAndRestart(c *check.C) { + testRequires(c, DaemonIsLinux) + expectedMsg := "hello" + out, _ := dockerCmd(c, "run", "-d", "busybox", "echo", expectedMsg) + id := strings.TrimSpace(string(out)) + + out, _ = dockerCmd(c, "wait", id) + + status := strings.TrimSpace(out) + if status != "0" { + c.Fatalf("container exited with status %s", status) + } + + tmpDir, err := ioutil.TempDir("", "test-docker-restart-after-copy-") + if err != nil { + c.Fatalf("unable to make temporary directory: %s", err) + } + defer os.RemoveAll(tmpDir) + + dockerCmd(c, "cp", fmt.Sprintf("%s:/etc/issue", id), tmpDir) + + out, _ = dockerCmd(c, "start", "-a", id) + + msg := strings.TrimSpace(out) + if msg != expectedMsg { + c.Fatalf("expected %q but got %q", expectedMsg, msg) + } +} + +func (s *DockerSuite) TestCopyCreatedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "create", "--name", "test_cp", "-v", "/test", "busybox") + + tmpDir, err := ioutil.TempDir("", "test") + if err != nil { + c.Fatalf("unable to make temporary directory: %s", err) + } + defer os.RemoveAll(tmpDir) + dockerCmd(c, "cp", "test_cp:/bin/sh", tmpDir) +} diff --git a/integration-cli/docker_cli_cp_to_container_test.go b/integration-cli/docker_cli_cp_to_container_test.go new file mode 100644 index 0000000000..39bac8511a --- /dev/null +++ b/integration-cli/docker_cli_cp_to_container_test.go @@ -0,0 +1,767 @@ +package main + +import ( + "os" + + "github.com/go-check/check" +) + +// docker cp LOCALPATH CONTAINER:PATH + +// Try all of the test cases from the archive package which implements the +// internals of `docker cp` and ensure that the behavior matches when actually +// copying to and from containers. + +// Basic assumptions about SRC and DST: +// 1. SRC must exist. +// 2. If SRC ends with a trailing separator, it must be a directory. +// 3. DST parent directory must exist. +// 4. If DST exists as a file, it must not end with a trailing separator. + +// First get these easy error cases out of the way. + +// Test for error when SRC does not exist. +func (s *DockerSuite) TestCpToErrSrcNotExists(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-err-src-not-exists") + defer os.RemoveAll(tmpDir) + + srcPath := cpPath(tmpDir, "file1") + dstPath := containerCpPath(cID, "file1") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected IsNotExist error, but got nil instead") + } + + if !isCpNotExist(err) { + c.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } +} + +// Test for error when SRC ends in a trailing +// path separator but it exists as a file. +func (s *DockerSuite) TestCpToErrSrcNotDir(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-err-src-not-dir") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := cpPathTrailingSep(tmpDir, "file1") + dstPath := containerCpPath(cID, "testDir") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected IsNotDir error, but got nil instead") + } + + if !isCpNotDir(err) { + c.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } +} + +// Test for error when SRC is a valid file or directory, +// bu the DST parent directory does not exist. +func (s *DockerSuite) TestCpToErrDstParentNotExists(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-err-dst-parent-not-exists") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + // Try with a file source. + srcPath := cpPath(tmpDir, "file1") + dstPath := containerCpPath(cID, "/notExists", "file1") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected IsNotExist error, but got nil instead") + } + + if !isCpNotExist(err) { + c.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } + + // Try with a directory source. + srcPath = cpPath(tmpDir, "dir1") + + if err := runDockerCp(c, srcPath, dstPath); err == nil { + c.Fatal("expected IsNotExist error, but got nil instead") + } + + if !isCpNotExist(err) { + c.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } +} + +// Test for error when DST ends in a trailing path separator but exists as a +// file. Also test that we cannot overwirite an existing directory with a +// non-directory and cannot overwrite an existing +func (s *DockerSuite) TestCpToErrDstNotDir(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{addContent: true}) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-err-dst-not-dir") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + // Try with a file source. + srcPath := cpPath(tmpDir, "dir1/file1-1") + dstPath := containerCpPathTrailingSep(cID, "file1") + + // The client should encounter an error trying to stat the destination + // and then be unable to copy since the destination is asserted to be a + // directory but does not exist. + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected DirNotExist error, but got nil instead") + } + + if !isCpDirNotExist(err) { + c.Fatalf("expected DirNotExist error, but got %T: %s", err, err) + } + + // Try with a directory source. + srcPath = cpPath(tmpDir, "dir1") + + // The client should encounter an error trying to stat the destination and + // then decide to extract to the parent directory instead with a rebased + // name in the source archive, but this directory would overwrite the + // existing file with the same name. + err = runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected CannotOverwriteNonDirWithDir error, but got nil instead") + } + + if !isCannotOverwriteNonDirWithDir(err) { + c.Fatalf("expected CannotOverwriteNonDirWithDir error, but got %T: %s", err, err) + } +} + +// Check that copying from a local path to a symlink in a container copies to +// the symlink target and does not overwrite the container symlink itself. +func (s *DockerSuite) TestCpToSymlinkDestination(c *check.C) { + // stat /tmp/test-cp-to-symlink-destination-262430901/vol3 gets permission denied for the user + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) // Requires local volume mount bind. + + testVol := getTestDir(c, "test-cp-to-symlink-destination-") + defer os.RemoveAll(testVol) + + makeTestContentInDir(c, testVol) + + cID := makeTestContainer(c, testContainerOptions{ + volumes: defaultVolumes(testVol), // Our bind mount is at /vol2 + }) + defer deleteContainer(cID) + + // First, copy a local file to a symlink to a file in the container. This + // should overwrite the symlink target contents with the source contents. + srcPath := cpPath(testVol, "file2") + dstPath := containerCpPath(cID, "/vol2/symlinkToFile1") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, cpPath(testVol, "symlinkToFile1"), "file1"); err != nil { + c.Fatal(err) + } + + // The file should have the contents of "file2" now. + if err := fileContentEquals(c, cpPath(testVol, "file1"), "file2\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a local file to a symlink to a directory in the container. + // This should copy the file into the symlink target directory. + dstPath = containerCpPath(cID, "/vol2/symlinkToDir1") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, cpPath(testVol, "symlinkToDir1"), "dir1"); err != nil { + c.Fatal(err) + } + + // The file should have the contents of "file2" now. + if err := fileContentEquals(c, cpPath(testVol, "file2"), "file2\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a file to a symlink to a file that does not exist (a broken + // symlink) in the container. This should create the target file with the + // contents of the source file. + dstPath = containerCpPath(cID, "/vol2/brokenSymlinkToFileX") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, cpPath(testVol, "brokenSymlinkToFileX"), "fileX"); err != nil { + c.Fatal(err) + } + + // The file should have the contents of "file2" now. + if err := fileContentEquals(c, cpPath(testVol, "fileX"), "file2\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a local directory to a symlink to a directory in the + // container. This should copy the directory into the symlink target + // directory and not modify the symlink. + srcPath = cpPath(testVol, "/dir2") + dstPath = containerCpPath(cID, "/vol2/symlinkToDir1") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, cpPath(testVol, "symlinkToDir1"), "dir1"); err != nil { + c.Fatal(err) + } + + // The directory should now contain a copy of "dir2". + if err := fileContentEquals(c, cpPath(testVol, "dir1/dir2/file2-1"), "file2-1\n"); err != nil { + c.Fatal(err) + } + + // Next, copy a local directory to a symlink to a local directory that does + // not exist (a broken symlink) in the container. This should create the + // target as a directory with the contents of the source directory. It + // should not modify the symlink. + dstPath = containerCpPath(cID, "/vol2/brokenSymlinkToDirX") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // The symlink should not have been modified. + if err := symlinkTargetEquals(c, cpPath(testVol, "brokenSymlinkToDirX"), "dirX"); err != nil { + c.Fatal(err) + } + + // The "dirX" directory should now be a copy of "dir2". + if err := fileContentEquals(c, cpPath(testVol, "dirX/file2-1"), "file2-1\n"); err != nil { + c.Fatal(err) + } +} + +// Possibilities are reduced to the remaining 10 cases: +// +// case | srcIsDir | onlyDirContents | dstExists | dstIsDir | dstTrSep | action +// =================================================================================================== +// A | no | - | no | - | no | create file +// B | no | - | no | - | yes | error +// C | no | - | yes | no | - | overwrite file +// D | no | - | yes | yes | - | create file in dst dir +// E | yes | no | no | - | - | create dir, copy contents +// F | yes | no | yes | no | - | error +// G | yes | no | yes | yes | - | copy dir and contents +// H | yes | yes | no | - | - | create dir, copy contents +// I | yes | yes | yes | no | - | error +// J | yes | yes | yes | yes | - | copy dir contents +// + +// A. SRC specifies a file and DST (no trailing path separator) doesn't +// exist. This should create a file with the name DST and copy the +// contents of the source file into it. +func (s *DockerSuite) TestCpToCaseA(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + workDir: "/root", command: makeCatFileCommand("itWorks.txt"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-a") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := cpPath(tmpDir, "file1") + dstPath := containerCpPath(cID, "/root/itWorks.txt") + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + if err := containerStartOutputEquals(c, cID, "file1\n"); err != nil { + c.Fatal(err) + } +} + +// B. SRC specifies a file and DST (with trailing path separator) doesn't +// exist. This should cause an error because the copy operation cannot +// create a directory when copying a single file. +func (s *DockerSuite) TestCpToCaseB(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + command: makeCatFileCommand("testDir/file1"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-b") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := cpPath(tmpDir, "file1") + dstDir := containerCpPathTrailingSep(cID, "testDir") + + err := runDockerCp(c, srcPath, dstDir) + if err == nil { + c.Fatal("expected DirNotExists error, but got nil instead") + } + + if !isCpDirNotExist(err) { + c.Fatalf("expected DirNotExists error, but got %T: %s", err, err) + } +} + +// C. SRC specifies a file and DST exists as a file. This should overwrite +// the file at DST with the contents of the source file. +func (s *DockerSuite) TestCpToCaseC(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + command: makeCatFileCommand("file2"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-c") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := cpPath(tmpDir, "file1") + dstPath := containerCpPath(cID, "/root/file2") + + // Ensure the container's file starts with the original content. + if err := containerStartOutputEquals(c, cID, "file2\n"); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcPath, dstPath); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1's contents. + if err := containerStartOutputEquals(c, cID, "file1\n"); err != nil { + c.Fatal(err) + } +} + +// D. SRC specifies a file and DST exists as a directory. This should place +// a copy of the source file inside it using the basename from SRC. Ensure +// this works whether DST has a trailing path separator or not. +func (s *DockerSuite) TestCpToCaseD(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, + command: makeCatFileCommand("/dir1/file1"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-d") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcPath := cpPath(tmpDir, "file1") + dstDir := containerCpPath(cID, "dir1") + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcPath, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1's contents. + if err := containerStartOutputEquals(c, cID, "file1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + // Make new destination container. + cID = makeTestContainer(c, testContainerOptions{ + addContent: true, + command: makeCatFileCommand("/dir1/file1"), + }) + defer deleteContainer(cID) + + dstDir = containerCpPathTrailingSep(cID, "dir1") + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcPath, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1's contents. + if err := containerStartOutputEquals(c, cID, "file1\n"); err != nil { + c.Fatal(err) + } +} + +// E. SRC specifies a directory and DST does not exist. This should create a +// directory at DST and copy the contents of the SRC directory into the DST +// directory. Ensure this works whether DST has a trailing path separator or +// not. +func (s *DockerSuite) TestCpToCaseE(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + command: makeCatFileCommand("/testDir/file1-1"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-e") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := cpPath(tmpDir, "dir1") + dstDir := containerCpPath(cID, "testDir") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + // Make new destination container. + cID = makeTestContainer(c, testContainerOptions{ + command: makeCatFileCommand("/testDir/file1-1"), + }) + defer deleteContainer(cID) + + dstDir = containerCpPathTrailingSep(cID, "testDir") + + err := runDockerCp(c, srcDir, dstDir) + if err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// F. SRC specifies a directory and DST exists as a file. This should cause an +// error as it is not possible to overwrite a file with a directory. +func (s *DockerSuite) TestCpToCaseF(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-f") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := cpPath(tmpDir, "dir1") + dstFile := containerCpPath(cID, "/root/file1") + + err := runDockerCp(c, srcDir, dstFile) + if err == nil { + c.Fatal("expected ErrCannotCopyDir error, but got nil instead") + } + + if !isCpCannotCopyDir(err) { + c.Fatalf("expected ErrCannotCopyDir error, but got %T: %s", err, err) + } +} + +// G. SRC specifies a directory and DST exists as a directory. This should copy +// the SRC directory and all its contents to the DST directory. Ensure this +// works whether DST has a trailing path separator or not. +func (s *DockerSuite) TestCpToCaseG(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + command: makeCatFileCommand("dir2/dir1/file1-1"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-g") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := cpPath(tmpDir, "dir1") + dstDir := containerCpPath(cID, "/root/dir2") + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + // Make new destination container. + cID = makeTestContainer(c, testContainerOptions{ + addContent: true, + command: makeCatFileCommand("/dir2/dir1/file1-1"), + }) + defer deleteContainer(cID) + + dstDir = containerCpPathTrailingSep(cID, "/dir2") + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// H. SRC specifies a directory's contents only and DST does not exist. This +// should create a directory at DST and copy the contents of the SRC +// directory (but not the directory itself) into the DST directory. Ensure +// this works whether DST has a trailing path separator or not. +func (s *DockerSuite) TestCpToCaseH(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + command: makeCatFileCommand("/testDir/file1-1"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-h") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := cpPathTrailingSep(tmpDir, "dir1") + "." + dstDir := containerCpPath(cID, "testDir") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + // Make new destination container. + cID = makeTestContainer(c, testContainerOptions{ + command: makeCatFileCommand("/testDir/file1-1"), + }) + defer deleteContainer(cID) + + dstDir = containerCpPathTrailingSep(cID, "testDir") + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// I. SRC specifies a directory's contents only and DST exists as a file. This +// should cause an error as it is not possible to overwrite a file with a +// directory. +func (s *DockerSuite) TestCpToCaseI(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-i") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := cpPathTrailingSep(tmpDir, "dir1") + "." + dstFile := containerCpPath(cID, "/root/file1") + + err := runDockerCp(c, srcDir, dstFile) + if err == nil { + c.Fatal("expected ErrCannotCopyDir error, but got nil instead") + } + + if !isCpCannotCopyDir(err) { + c.Fatalf("expected ErrCannotCopyDir error, but got %T: %s", err, err) + } +} + +// J. SRC specifies a directory's contents only and DST exists as a directory. +// This should copy the contents of the SRC directory (but not the directory +// itself) into the DST directory. Ensure this works whether DST has a +// trailing path separator or not. +func (s *DockerSuite) TestCpToCaseJ(c *check.C) { + testRequires(c, DaemonIsLinux) + cID := makeTestContainer(c, testContainerOptions{ + addContent: true, workDir: "/root", + command: makeCatFileCommand("/dir2/file1-1"), + }) + defer deleteContainer(cID) + + tmpDir := getTestDir(c, "test-cp-to-case-j") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + srcDir := cpPathTrailingSep(tmpDir, "dir1") + "." + dstDir := containerCpPath(cID, "/dir2") + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + // Make new destination container. + cID = makeTestContainer(c, testContainerOptions{ + command: makeCatFileCommand("/dir2/file1-1"), + }) + defer deleteContainer(cID) + + dstDir = containerCpPathTrailingSep(cID, "/dir2") + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } + + if err := runDockerCp(c, srcDir, dstDir); err != nil { + c.Fatalf("unexpected error %T: %s", err, err) + } + + // Should now contain file1-1's contents. + if err := containerStartOutputEquals(c, cID, "file1-1\n"); err != nil { + c.Fatal(err) + } +} + +// The `docker cp` command should also ensure that you cannot +// write to a container rootfs that is marked as read-only. +func (s *DockerSuite) TestCpToErrReadOnlyRootfs(c *check.C) { + // --read-only + userns has remount issues + testRequires(c, DaemonIsLinux, NotUserNamespace) + tmpDir := getTestDir(c, "test-cp-to-err-read-only-rootfs") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + cID := makeTestContainer(c, testContainerOptions{ + readOnly: true, workDir: "/root", + command: makeCatFileCommand("shouldNotExist"), + }) + defer deleteContainer(cID) + + srcPath := cpPath(tmpDir, "file1") + dstPath := containerCpPath(cID, "/root/shouldNotExist") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected ErrContainerRootfsReadonly error, but got nil instead") + } + + if !isCpCannotCopyReadOnly(err) { + c.Fatalf("expected ErrContainerRootfsReadonly error, but got %T: %s", err, err) + } + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } +} + +// The `docker cp` command should also ensure that you +// cannot write to a volume that is mounted as read-only. +func (s *DockerSuite) TestCpToErrReadOnlyVolume(c *check.C) { + // --read-only + userns has remount issues + testRequires(c, DaemonIsLinux, NotUserNamespace) + tmpDir := getTestDir(c, "test-cp-to-err-read-only-volume") + defer os.RemoveAll(tmpDir) + + makeTestContentInDir(c, tmpDir) + + cID := makeTestContainer(c, testContainerOptions{ + volumes: defaultVolumes(tmpDir), workDir: "/root", + command: makeCatFileCommand("/vol_ro/shouldNotExist"), + }) + defer deleteContainer(cID) + + srcPath := cpPath(tmpDir, "file1") + dstPath := containerCpPath(cID, "/vol_ro/shouldNotExist") + + err := runDockerCp(c, srcPath, dstPath) + if err == nil { + c.Fatal("expected ErrVolumeReadonly error, but got nil instead") + } + + if !isCpCannotCopyReadOnly(err) { + c.Fatalf("expected ErrVolumeReadonly error, but got %T: %s", err, err) + } + + // Ensure that dstPath doesn't exist. + if err := containerStartOutputEquals(c, cID, ""); err != nil { + c.Fatal(err) + } +} diff --git a/integration-cli/docker_cli_cp_utils.go b/integration-cli/docker_cli_cp_utils.go new file mode 100644 index 0000000000..4642922e00 --- /dev/null +++ b/integration-cli/docker_cli_cp_utils.go @@ -0,0 +1,316 @@ +package main + +import ( + "bytes" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "strings" + + "github.com/docker/docker/pkg/archive" + "github.com/go-check/check" +) + +type fileType uint32 + +const ( + ftRegular fileType = iota + ftDir + ftSymlink +) + +type fileData struct { + filetype fileType + path string + contents string +} + +func (fd fileData) creationCommand() string { + var command string + + switch fd.filetype { + case ftRegular: + // Don't overwrite the file if it already exists! + command = fmt.Sprintf("if [ ! -f %s ]; then echo %q > %s; fi", fd.path, fd.contents, fd.path) + case ftDir: + command = fmt.Sprintf("mkdir -p %s", fd.path) + case ftSymlink: + command = fmt.Sprintf("ln -fs %s %s", fd.contents, fd.path) + } + + return command +} + +func mkFilesCommand(fds []fileData) string { + commands := make([]string, len(fds)) + + for i, fd := range fds { + commands[i] = fd.creationCommand() + } + + return strings.Join(commands, " && ") +} + +var defaultFileData = []fileData{ + {ftRegular, "file1", "file1"}, + {ftRegular, "file2", "file2"}, + {ftRegular, "file3", "file3"}, + {ftRegular, "file4", "file4"}, + {ftRegular, "file5", "file5"}, + {ftRegular, "file6", "file6"}, + {ftRegular, "file7", "file7"}, + {ftDir, "dir1", ""}, + {ftRegular, "dir1/file1-1", "file1-1"}, + {ftRegular, "dir1/file1-2", "file1-2"}, + {ftDir, "dir2", ""}, + {ftRegular, "dir2/file2-1", "file2-1"}, + {ftRegular, "dir2/file2-2", "file2-2"}, + {ftDir, "dir3", ""}, + {ftRegular, "dir3/file3-1", "file3-1"}, + {ftRegular, "dir3/file3-2", "file3-2"}, + {ftDir, "dir4", ""}, + {ftRegular, "dir4/file3-1", "file4-1"}, + {ftRegular, "dir4/file3-2", "file4-2"}, + {ftDir, "dir5", ""}, + {ftSymlink, "symlinkToFile1", "file1"}, + {ftSymlink, "symlinkToDir1", "dir1"}, + {ftSymlink, "brokenSymlinkToFileX", "fileX"}, + {ftSymlink, "brokenSymlinkToDirX", "dirX"}, + {ftSymlink, "symlinkToAbsDir", "/root"}, +} + +func defaultMkContentCommand() string { + return mkFilesCommand(defaultFileData) +} + +func makeTestContentInDir(c *check.C, dir string) { + for _, fd := range defaultFileData { + path := filepath.Join(dir, filepath.FromSlash(fd.path)) + switch fd.filetype { + case ftRegular: + if err := ioutil.WriteFile(path, []byte(fd.contents+"\n"), os.FileMode(0666)); err != nil { + c.Fatal(err) + } + case ftDir: + if err := os.Mkdir(path, os.FileMode(0777)); err != nil { + c.Fatal(err) + } + case ftSymlink: + if err := os.Symlink(fd.contents, path); err != nil { + c.Fatal(err) + } + } + } +} + +type testContainerOptions struct { + addContent bool + readOnly bool + volumes []string + workDir string + command string +} + +func makeTestContainer(c *check.C, options testContainerOptions) (containerID string) { + if options.addContent { + mkContentCmd := defaultMkContentCommand() + if options.command == "" { + options.command = mkContentCmd + } else { + options.command = fmt.Sprintf("%s && %s", defaultMkContentCommand(), options.command) + } + } + + if options.command == "" { + options.command = "#(nop)" + } + + args := []string{"run", "-d"} + + for _, volume := range options.volumes { + args = append(args, "-v", volume) + } + + if options.workDir != "" { + args = append(args, "-w", options.workDir) + } + + if options.readOnly { + args = append(args, "--read-only") + } + + args = append(args, "busybox", "/bin/sh", "-c", options.command) + + out, status := dockerCmd(c, args...) + if status != 0 { + c.Fatalf("failed to run container, status %d: %s", status, out) + } + + containerID = strings.TrimSpace(out) + + out, status = dockerCmd(c, "wait", containerID) + if status != 0 { + c.Fatalf("failed to wait for test container container, status %d: %s", status, out) + } + + if exitCode := strings.TrimSpace(out); exitCode != "0" { + logs, status := dockerCmd(c, "logs", containerID) + if status != 0 { + logs = "UNABLE TO GET LOGS" + } + c.Fatalf("failed to make test container, exit code (%s): %s", exitCode, logs) + } + + return +} + +func makeCatFileCommand(path string) string { + return fmt.Sprintf("if [ -f %s ]; then cat %s; fi", path, path) +} + +func cpPath(pathElements ...string) string { + localizedPathElements := make([]string, len(pathElements)) + for i, path := range pathElements { + localizedPathElements[i] = filepath.FromSlash(path) + } + return strings.Join(localizedPathElements, string(filepath.Separator)) +} + +func cpPathTrailingSep(pathElements ...string) string { + return fmt.Sprintf("%s%c", cpPath(pathElements...), filepath.Separator) +} + +func containerCpPath(containerID string, pathElements ...string) string { + joined := strings.Join(pathElements, "/") + return fmt.Sprintf("%s:%s", containerID, joined) +} + +func containerCpPathTrailingSep(containerID string, pathElements ...string) string { + return fmt.Sprintf("%s/", containerCpPath(containerID, pathElements...)) +} + +func runDockerCp(c *check.C, src, dst string) (err error) { + c.Logf("running `docker cp %s %s`", src, dst) + + args := []string{"cp", src, dst} + + out, _, err := runCommandWithOutput(exec.Command(dockerBinary, args...)) + if err != nil { + err = fmt.Errorf("error executing `docker cp` command: %s: %s", err, out) + } + + return +} + +func startContainerGetOutput(c *check.C, cID string) (out string, err error) { + c.Logf("running `docker start -a %s`", cID) + + args := []string{"start", "-a", cID} + + out, _, err = runCommandWithOutput(exec.Command(dockerBinary, args...)) + if err != nil { + err = fmt.Errorf("error executing `docker start` command: %s: %s", err, out) + } + + return +} + +func getTestDir(c *check.C, label string) (tmpDir string) { + var err error + + if tmpDir, err = ioutil.TempDir("", label); err != nil { + c.Fatalf("unable to make temporary directory: %s", err) + } + + return +} + +func isCpNotExist(err error) bool { + return strings.Contains(err.Error(), "no such file or directory") || strings.Contains(err.Error(), "cannot find the file specified") +} + +func isCpDirNotExist(err error) bool { + return strings.Contains(err.Error(), archive.ErrDirNotExists.Error()) +} + +func isCpNotDir(err error) bool { + return strings.Contains(err.Error(), archive.ErrNotDirectory.Error()) || strings.Contains(err.Error(), "filename, directory name, or volume label syntax is incorrect") +} + +func isCpCannotCopyDir(err error) bool { + return strings.Contains(err.Error(), archive.ErrCannotCopyDir.Error()) +} + +func isCpCannotCopyReadOnly(err error) bool { + return strings.Contains(err.Error(), "marked read-only") +} + +func isCannotOverwriteNonDirWithDir(err error) bool { + return strings.Contains(err.Error(), "cannot overwrite non-directory") +} + +func fileContentEquals(c *check.C, filename, contents string) (err error) { + c.Logf("checking that file %q contains %q\n", filename, contents) + + fileBytes, err := ioutil.ReadFile(filename) + if err != nil { + return + } + + expectedBytes, err := ioutil.ReadAll(strings.NewReader(contents)) + if err != nil { + return + } + + if !bytes.Equal(fileBytes, expectedBytes) { + err = fmt.Errorf("file content not equal - expected %q, got %q", string(expectedBytes), string(fileBytes)) + } + + return +} + +func symlinkTargetEquals(c *check.C, symlink, expectedTarget string) (err error) { + c.Logf("checking that the symlink %q points to %q\n", symlink, expectedTarget) + + actualTarget, err := os.Readlink(symlink) + if err != nil { + return err + } + + if actualTarget != expectedTarget { + return fmt.Errorf("symlink target points to %q not %q", actualTarget, expectedTarget) + } + + return nil +} + +func containerStartOutputEquals(c *check.C, cID, contents string) (err error) { + c.Logf("checking that container %q start output contains %q\n", cID, contents) + + out, err := startContainerGetOutput(c, cID) + if err != nil { + return err + } + + if out != contents { + err = fmt.Errorf("output contents not equal - expected %q, got %q", contents, out) + } + + return +} + +func defaultVolumes(tmpDir string) []string { + if SameHostDaemon.Condition() { + return []string{ + "/vol1", + fmt.Sprintf("%s:/vol2", tmpDir), + fmt.Sprintf("%s:/vol3", filepath.Join(tmpDir, "vol3")), + fmt.Sprintf("%s:/vol_ro:ro", filepath.Join(tmpDir, "vol_ro")), + } + } + + // Can't bind-mount volumes with separate host daemon. + return []string{"/vol1", "/vol2", "/vol3", "/vol_ro:/vol_ro:ro"} +} diff --git a/integration-cli/docker_cli_create_test.go b/integration-cli/docker_cli_create_test.go new file mode 100644 index 0000000000..4cc6ef4245 --- /dev/null +++ b/integration-cli/docker_cli_create_test.go @@ -0,0 +1,472 @@ +package main + +import ( + "encoding/json" + "fmt" + "os" + "reflect" + "strings" + "time" + + "os/exec" + + "io/ioutil" + + "github.com/docker/docker/pkg/nat" + "github.com/go-check/check" +) + +// Make sure we can create a simple container with some args +func (s *DockerSuite) TestCreateArgs(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "create", "busybox", "command", "arg1", "arg2", "arg with space") + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "inspect", cleanedContainerID) + + containers := []struct { + ID string + Created time.Time + Path string + Args []string + Image string + }{} + if err := json.Unmarshal([]byte(out), &containers); err != nil { + c.Fatalf("Error inspecting the container: %s", err) + } + if len(containers) != 1 { + c.Fatalf("Unexpected container count. Expected 0, received: %d", len(containers)) + } + + cont := containers[0] + if cont.Path != "command" { + c.Fatalf("Unexpected container path. Expected command, received: %s", cont.Path) + } + + b := false + expected := []string{"arg1", "arg2", "arg with space"} + for i, arg := range expected { + if arg != cont.Args[i] { + b = true + break + } + } + if len(cont.Args) != len(expected) || b { + c.Fatalf("Unexpected args. Expected %v, received: %v", expected, cont.Args) + } + +} + +// Make sure we can set hostconfig options too +func (s *DockerSuite) TestCreateHostConfig(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "create", "-P", "busybox", "echo") + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "inspect", cleanedContainerID) + + containers := []struct { + HostConfig *struct { + PublishAllPorts bool + } + }{} + if err := json.Unmarshal([]byte(out), &containers); err != nil { + c.Fatalf("Error inspecting the container: %s", err) + } + if len(containers) != 1 { + c.Fatalf("Unexpected container count. Expected 0, received: %d", len(containers)) + } + + cont := containers[0] + if cont.HostConfig == nil { + c.Fatalf("Expected HostConfig, got none") + } + + if !cont.HostConfig.PublishAllPorts { + c.Fatalf("Expected PublishAllPorts, got false") + } + +} + +func (s *DockerSuite) TestCreateWithPortRange(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "create", "-p", "3300-3303:3300-3303/tcp", "busybox", "echo") + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "inspect", cleanedContainerID) + + containers := []struct { + HostConfig *struct { + PortBindings map[nat.Port][]nat.PortBinding + } + }{} + if err := json.Unmarshal([]byte(out), &containers); err != nil { + c.Fatalf("Error inspecting the container: %s", err) + } + if len(containers) != 1 { + c.Fatalf("Unexpected container count. Expected 0, received: %d", len(containers)) + } + + cont := containers[0] + if cont.HostConfig == nil { + c.Fatalf("Expected HostConfig, got none") + } + + if len(cont.HostConfig.PortBindings) != 4 { + c.Fatalf("Expected 4 ports bindings, got %d", len(cont.HostConfig.PortBindings)) + } + for k, v := range cont.HostConfig.PortBindings { + if len(v) != 1 { + c.Fatalf("Expected 1 ports binding, for the port %s but found %s", k, v) + } + if k.Port() != v[0].HostPort { + c.Fatalf("Expected host port %s to match published port %s", k.Port(), v[0].HostPort) + } + } + +} + +func (s *DockerSuite) TestCreateWithiLargePortRange(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "create", "-p", "1-65535:1-65535/tcp", "busybox", "echo") + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "inspect", cleanedContainerID) + + containers := []struct { + HostConfig *struct { + PortBindings map[nat.Port][]nat.PortBinding + } + }{} + if err := json.Unmarshal([]byte(out), &containers); err != nil { + c.Fatalf("Error inspecting the container: %s", err) + } + if len(containers) != 1 { + c.Fatalf("Unexpected container count. Expected 0, received: %d", len(containers)) + } + + cont := containers[0] + if cont.HostConfig == nil { + c.Fatalf("Expected HostConfig, got none") + } + + if len(cont.HostConfig.PortBindings) != 65535 { + c.Fatalf("Expected 65535 ports bindings, got %d", len(cont.HostConfig.PortBindings)) + } + for k, v := range cont.HostConfig.PortBindings { + if len(v) != 1 { + c.Fatalf("Expected 1 ports binding, for the port %s but found %s", k, v) + } + if k.Port() != v[0].HostPort { + c.Fatalf("Expected host port %s to match published port %s", k.Port(), v[0].HostPort) + } + } + +} + +// "test123" should be printed by docker create + start +func (s *DockerSuite) TestCreateEchoStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + + out, _ := dockerCmd(c, "create", "busybox", "echo", "test123") + + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "start", "-ai", cleanedContainerID) + + if out != "test123\n" { + c.Errorf("container should've printed 'test123', got %q", out) + } + +} + +func (s *DockerSuite) TestCreateVolumesCreated(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + name := "test_create_volume" + dockerCmd(c, "create", "--name", name, "-v", "/foo", "busybox") + + dir, err := inspectMountSourceField(name, "/foo") + if err != nil { + c.Fatalf("Error getting volume host path: %q", err) + } + + if _, err := os.Stat(dir); err != nil && os.IsNotExist(err) { + c.Fatalf("Volume was not created") + } + if err != nil { + c.Fatalf("Error statting volume host path: %q", err) + } + +} + +func (s *DockerSuite) TestCreateLabels(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test_create_labels" + expected := map[string]string{"k1": "v1", "k2": "v2"} + dockerCmd(c, "create", "--name", name, "-l", "k1=v1", "--label", "k2=v2", "busybox") + + actual := make(map[string]string) + err := inspectFieldAndMarshall(name, "Config.Labels", &actual) + if err != nil { + c.Fatal(err) + } + + if !reflect.DeepEqual(expected, actual) { + c.Fatalf("Expected %s got %s", expected, actual) + } +} + +func (s *DockerSuite) TestCreateLabelFromImage(c *check.C) { + testRequires(c, DaemonIsLinux) + imageName := "testcreatebuildlabel" + _, err := buildImage(imageName, + `FROM busybox + LABEL k1=v1 k2=v2`, + true) + if err != nil { + c.Fatal(err) + } + + name := "test_create_labels_from_image" + expected := map[string]string{"k2": "x", "k3": "v3", "k1": "v1"} + dockerCmd(c, "create", "--name", name, "-l", "k2=x", "--label", "k3=v3", imageName) + + actual := make(map[string]string) + err = inspectFieldAndMarshall(name, "Config.Labels", &actual) + if err != nil { + c.Fatal(err) + } + + if !reflect.DeepEqual(expected, actual) { + c.Fatalf("Expected %s got %s", expected, actual) + } +} + +func (s *DockerSuite) TestCreateHostnameWithNumber(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-h", "web.0", "busybox", "hostname") + if strings.TrimSpace(out) != "web.0" { + c.Fatalf("hostname not set, expected `web.0`, got: %s", out) + } +} + +func (s *DockerSuite) TestCreateRM(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure we can 'rm' a new container that is in + // "Created" state, and has ever been run. Test "rm -f" too. + + // create a container + out, _ := dockerCmd(c, "create", "busybox") + cID := strings.TrimSpace(out) + + dockerCmd(c, "rm", cID) + + // Now do it again so we can "rm -f" this time + out, _ = dockerCmd(c, "create", "busybox") + + cID = strings.TrimSpace(out) + dockerCmd(c, "rm", "-f", cID) +} + +func (s *DockerSuite) TestCreateModeIpcContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon, NotUserNamespace) + + out, _ := dockerCmd(c, "create", "busybox") + id := strings.TrimSpace(out) + + dockerCmd(c, "create", fmt.Sprintf("--ipc=container:%s", id), "busybox") +} + +func (s *DockerTrustSuite) TestTrustedCreate(c *check.C) { + repoName := s.setupTrustedImage(c, "trusted-create") + + // Try create + createCmd := exec.Command(dockerBinary, "create", repoName) + s.trustedCmd(createCmd) + out, _, err := runCommandWithOutput(createCmd) + if err != nil { + c.Fatalf("Error running trusted create: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try untrusted create to ensure we pushed the tag to the registry + createCmd = exec.Command(dockerBinary, "create", "--disable-content-trust=true", repoName) + s.trustedCmd(createCmd) + out, _, err = runCommandWithOutput(createCmd) + if err != nil { + c.Fatalf("Error running trusted create: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on trusted create with --disable-content-trust:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestUntrustedCreate(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + dockerCmd(c, "push", repoName) + dockerCmd(c, "rmi", repoName) + + // Try trusted create on untrusted tag + createCmd := exec.Command(dockerBinary, "create", repoName) + s.trustedCmd(createCmd) + out, _, err := runCommandWithOutput(createCmd) + if err == nil { + c.Fatalf("Error expected when running trusted create with:\n%s", out) + } + + if !strings.Contains(string(out), "no trust data available") { + c.Fatalf("Missing expected output on trusted create:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedIsolatedCreate(c *check.C) { + repoName := s.setupTrustedImage(c, "trusted-isolated-create") + + // Try create + createCmd := exec.Command(dockerBinary, "--config", "/tmp/docker-isolated-create", "create", repoName) + s.trustedCmd(createCmd) + out, _, err := runCommandWithOutput(createCmd) + if err != nil { + c.Fatalf("Error running trusted create: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) +} + +func (s *DockerTrustSuite) TestCreateWhenCertExpired(c *check.C) { + c.Skip("Currently changes system time, causing instability") + repoName := s.setupTrustedImage(c, "trusted-create-expired") + + // Certificates have 10 years of expiration + elevenYearsFromNow := time.Now().Add(time.Hour * 24 * 365 * 11) + + runAtDifferentDate(elevenYearsFromNow, func() { + // Try create + createCmd := exec.Command(dockerBinary, "create", repoName) + s.trustedCmd(createCmd) + out, _, err := runCommandWithOutput(createCmd) + if err == nil { + c.Fatalf("Error running trusted create in the distant future: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "could not validate the path to a trusted root") { + c.Fatalf("Missing expected output on trusted create in the distant future:\n%s", out) + } + }) + + runAtDifferentDate(elevenYearsFromNow, func() { + // Try create + createCmd := exec.Command(dockerBinary, "create", "--disable-content-trust", repoName) + s.trustedCmd(createCmd) + out, _, err := runCommandWithOutput(createCmd) + if err != nil { + c.Fatalf("Error running untrusted create in the distant future: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on untrusted create in the distant future:\n%s", out) + } + }) +} + +func (s *DockerTrustSuite) TestTrustedCreateFromBadTrustServer(c *check.C) { + repoName := fmt.Sprintf("%v/dockerclievilcreate/trusted:latest", privateRegistryURL) + evilLocalConfigDir, err := ioutil.TempDir("", "evil-local-config-dir") + if err != nil { + c.Fatalf("Failed to create local temp dir") + } + + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error creating trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try create + createCmd := exec.Command(dockerBinary, "create", repoName) + s.trustedCmd(createCmd) + out, _, err = runCommandWithOutput(createCmd) + if err != nil { + c.Fatalf("Error creating trusted create: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Kill the notary server, start a new "evil" one. + s.not.Close() + s.not, err = newTestNotary(c) + if err != nil { + c.Fatalf("Restarting notary server failed.") + } + + // In order to make an evil server, lets re-init a client (with a different trust dir) and push new data. + // tag an image and upload it to the private registry + dockerCmd(c, "--config", evilLocalConfigDir, "tag", "busybox", repoName) + + // Push up to the new server + pushCmd = exec.Command(dockerBinary, "--config", evilLocalConfigDir, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err = runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error creating trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // Now, try creating with the original client from this new trust server. This should fail. + createCmd = exec.Command(dockerBinary, "create", repoName) + s.trustedCmd(createCmd) + out, _, err = runCommandWithOutput(createCmd) + if err == nil { + c.Fatalf("Expected to fail on this create due to different remote data: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "failed to validate data with current trusted certificates") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } +} + +func (s *DockerSuite) TestCreateStopSignal(c *check.C) { + name := "test_create_stop_signal" + dockerCmd(c, "create", "--name", name, "--stop-signal", "9", "busybox") + + res, err := inspectFieldJSON(name, "Config.StopSignal") + c.Assert(err, check.IsNil) + + if res != `"9"` { + c.Fatalf("Expected 9, got %s", res) + } +} diff --git a/integration-cli/docker_cli_daemon_test.go b/integration-cli/docker_cli_daemon_test.go new file mode 100644 index 0000000000..f5ecada8c8 --- /dev/null +++ b/integration-cli/docker_cli_daemon_test.go @@ -0,0 +1,1852 @@ +// +build daemon,!windows + +package main + +import ( + "bytes" + "encoding/json" + "fmt" + "io/ioutil" + "net" + "os" + "os/exec" + "path/filepath" + "regexp" + "strconv" + "strings" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/libnetwork/iptables" + "github.com/docker/libtrust" + "github.com/go-check/check" +) + +func (s *DockerDaemonSuite) TestDaemonRestartWithRunningContainersPorts(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + if out, err := s.d.Cmd("run", "-d", "--name", "top1", "-p", "1234:80", "--restart", "always", "busybox:latest", "top"); err != nil { + c.Fatalf("Could not run top1: err=%v\n%s", err, out) + } + // --restart=no by default + if out, err := s.d.Cmd("run", "-d", "--name", "top2", "-p", "80", "busybox:latest", "top"); err != nil { + c.Fatalf("Could not run top2: err=%v\n%s", err, out) + } + + testRun := func(m map[string]bool, prefix string) { + var format string + for cont, shouldRun := range m { + out, err := s.d.Cmd("ps") + if err != nil { + c.Fatalf("Could not run ps: err=%v\n%q", err, out) + } + if shouldRun { + format = "%scontainer %q is not running" + } else { + format = "%scontainer %q is running" + } + if shouldRun != strings.Contains(out, cont) { + c.Fatalf(format, prefix, cont) + } + } + } + + testRun(map[string]bool{"top1": true, "top2": true}, "") + + if err := s.d.Restart(); err != nil { + c.Fatalf("Could not restart daemon: %v", err) + } + testRun(map[string]bool{"top1": true, "top2": false}, "After daemon restart: ") +} + +func (s *DockerDaemonSuite) TestDaemonRestartWithVolumesRefs(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + if out, err := s.d.Cmd("run", "-d", "--name", "volrestarttest1", "-v", "/foo", "busybox"); err != nil { + c.Fatal(err, out) + } + + if err := s.d.Restart(); err != nil { + c.Fatal(err) + } + + if _, err := s.d.Cmd("run", "-d", "--volumes-from", "volrestarttest1", "--name", "volrestarttest2", "busybox", "top"); err != nil { + c.Fatal(err) + } + + if out, err := s.d.Cmd("rm", "-fv", "volrestarttest2"); err != nil { + c.Fatal(err, out) + } + + out, err := s.d.Cmd("inspect", "-f", "{{json .Mounts}}", "volrestarttest1") + c.Assert(err, check.IsNil) + + if _, err := inspectMountPointJSON(out, "/foo"); err != nil { + c.Fatalf("Expected volume to exist: /foo, error: %v\n", err) + } +} + +// #11008 +func (s *DockerDaemonSuite) TestDaemonRestartUnlessStopped(c *check.C) { + err := s.d.StartWithBusybox() + c.Assert(err, check.IsNil) + + out, err := s.d.Cmd("run", "-d", "--name", "top1", "--restart", "always", "busybox:latest", "top") + c.Assert(err, check.IsNil, check.Commentf("run top1: %v", out)) + + out, err = s.d.Cmd("run", "-d", "--name", "top2", "--restart", "unless-stopped", "busybox:latest", "top") + c.Assert(err, check.IsNil, check.Commentf("run top2: %v", out)) + + testRun := func(m map[string]bool, prefix string) { + var format string + for name, shouldRun := range m { + out, err := s.d.Cmd("ps") + c.Assert(err, check.IsNil, check.Commentf("run ps: %v", out)) + if shouldRun { + format = "%scontainer %q is not running" + } else { + format = "%scontainer %q is running" + } + c.Assert(strings.Contains(out, name), check.Equals, shouldRun, check.Commentf(format, prefix, name)) + } + } + + // both running + testRun(map[string]bool{"top1": true, "top2": true}, "") + + out, err = s.d.Cmd("stop", "top1") + c.Assert(err, check.IsNil, check.Commentf(out)) + + out, err = s.d.Cmd("stop", "top2") + c.Assert(err, check.IsNil, check.Commentf(out)) + + // both stopped + testRun(map[string]bool{"top1": false, "top2": false}, "") + + err = s.d.Restart() + c.Assert(err, check.IsNil) + + // restart=always running + testRun(map[string]bool{"top1": true, "top2": false}, "After daemon restart: ") + + out, err = s.d.Cmd("start", "top2") + c.Assert(err, check.IsNil, check.Commentf("start top2: %v", out)) + + err = s.d.Restart() + c.Assert(err, check.IsNil) + + // both running + testRun(map[string]bool{"top1": true, "top2": true}, "After second daemon restart: ") + +} + +func (s *DockerDaemonSuite) TestDaemonStartIptablesFalse(c *check.C) { + if err := s.d.Start("--iptables=false"); err != nil { + c.Fatalf("we should have been able to start the daemon with passing iptables=false: %v", err) + } +} + +// Issue #8444: If docker0 bridge is modified (intentionally or unintentionally) and +// no longer has an IP associated, we should gracefully handle that case and associate +// an IP with it rather than fail daemon start +func (s *DockerDaemonSuite) TestDaemonStartBridgeWithoutIPAssociation(c *check.C) { + // rather than depending on brctl commands to verify docker0 is created and up + // let's start the daemon and stop it, and then make a modification to run the + // actual test + if err := s.d.Start(); err != nil { + c.Fatalf("Could not start daemon: %v", err) + } + if err := s.d.Stop(); err != nil { + c.Fatalf("Could not stop daemon: %v", err) + } + + // now we will remove the ip from docker0 and then try starting the daemon + ipCmd := exec.Command("ip", "addr", "flush", "dev", "docker0") + stdout, stderr, _, err := runCommandWithStdoutStderr(ipCmd) + if err != nil { + c.Fatalf("failed to remove docker0 IP association: %v, stdout: %q, stderr: %q", err, stdout, stderr) + } + + if err := s.d.Start(); err != nil { + warning := "**WARNING: Docker bridge network in bad state--delete docker0 bridge interface to fix" + c.Fatalf("Could not start daemon when docker0 has no IP address: %v\n%s", err, warning) + } +} + +func (s *DockerDaemonSuite) TestDaemonIptablesClean(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + if out, err := s.d.Cmd("run", "-d", "--name", "top", "-p", "80", "busybox:latest", "top"); err != nil { + c.Fatalf("Could not run top: %s, %v", out, err) + } + + // get output from iptables with container running + ipTablesSearchString := "tcp dpt:80" + ipTablesCmd := exec.Command("iptables", "-nvL") + out, _, err := runCommandWithOutput(ipTablesCmd) + if err != nil { + c.Fatalf("Could not run iptables -nvL: %s, %v", out, err) + } + + if !strings.Contains(out, ipTablesSearchString) { + c.Fatalf("iptables output should have contained %q, but was %q", ipTablesSearchString, out) + } + + if err := s.d.Stop(); err != nil { + c.Fatalf("Could not stop daemon: %v", err) + } + + // get output from iptables after restart + ipTablesCmd = exec.Command("iptables", "-nvL") + out, _, err = runCommandWithOutput(ipTablesCmd) + if err != nil { + c.Fatalf("Could not run iptables -nvL: %s, %v", out, err) + } + + if strings.Contains(out, ipTablesSearchString) { + c.Fatalf("iptables output should not have contained %q, but was %q", ipTablesSearchString, out) + } +} + +func (s *DockerDaemonSuite) TestDaemonIptablesCreate(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + if out, err := s.d.Cmd("run", "-d", "--name", "top", "--restart=always", "-p", "80", "busybox:latest", "top"); err != nil { + c.Fatalf("Could not run top: %s, %v", out, err) + } + + // get output from iptables with container running + ipTablesSearchString := "tcp dpt:80" + ipTablesCmd := exec.Command("iptables", "-nvL") + out, _, err := runCommandWithOutput(ipTablesCmd) + if err != nil { + c.Fatalf("Could not run iptables -nvL: %s, %v", out, err) + } + + if !strings.Contains(out, ipTablesSearchString) { + c.Fatalf("iptables output should have contained %q, but was %q", ipTablesSearchString, out) + } + + if err := s.d.Restart(); err != nil { + c.Fatalf("Could not restart daemon: %v", err) + } + + // make sure the container is not running + runningOut, err := s.d.Cmd("inspect", "--format='{{.State.Running}}'", "top") + if err != nil { + c.Fatalf("Could not inspect on container: %s, %v", out, err) + } + if strings.TrimSpace(runningOut) != "true" { + c.Fatalf("Container should have been restarted after daemon restart. Status running should have been true but was: %q", strings.TrimSpace(runningOut)) + } + + // get output from iptables after restart + ipTablesCmd = exec.Command("iptables", "-nvL") + out, _, err = runCommandWithOutput(ipTablesCmd) + if err != nil { + c.Fatalf("Could not run iptables -nvL: %s, %v", out, err) + } + + if !strings.Contains(out, ipTablesSearchString) { + c.Fatalf("iptables output after restart should have contained %q, but was %q", ipTablesSearchString, out) + } +} + +// TestDaemonIPv6Enabled checks that when the daemon is started with --ipv6=true that the docker0 bridge +// has the fe80::1 address and that a container is assigned a link-local address +func (s *DockerSuite) TestDaemonIPv6Enabled(c *check.C) { + testRequires(c, IPv6) + + if err := setupV6(); err != nil { + c.Fatal("Could not set up host for IPv6 tests") + } + + d := NewDaemon(c) + + if err := d.StartWithBusybox("--ipv6"); err != nil { + c.Fatal(err) + } + defer d.Stop() + + iface, err := net.InterfaceByName("docker0") + if err != nil { + c.Fatalf("Error getting docker0 interface: %v", err) + } + + addrs, err := iface.Addrs() + if err != nil { + c.Fatalf("Error getting addresses for docker0 interface: %v", err) + } + + var found bool + expected := "fe80::1/64" + + for i := range addrs { + if addrs[i].String() == expected { + found = true + } + } + + if !found { + c.Fatalf("Bridge does not have an IPv6 Address") + } + + if out, err := d.Cmd("run", "-itd", "--name=ipv6test", "busybox:latest"); err != nil { + c.Fatalf("Could not run container: %s, %v", out, err) + } + + out, err := d.Cmd("inspect", "--format", "'{{.NetworkSettings.Networks.bridge.LinkLocalIPv6Address}}'", "ipv6test") + out = strings.Trim(out, " \r\n'") + + if err != nil { + c.Fatalf("Error inspecting container: %s, %v", out, err) + } + + if ip := net.ParseIP(out); ip == nil { + c.Fatalf("Container should have a link-local IPv6 address") + } + + out, err = d.Cmd("inspect", "--format", "'{{.NetworkSettings.Networks.bridge.GlobalIPv6Address}}'", "ipv6test") + out = strings.Trim(out, " \r\n'") + + if err != nil { + c.Fatalf("Error inspecting container: %s, %v", out, err) + } + + if ip := net.ParseIP(out); ip != nil { + c.Fatalf("Container should not have a global IPv6 address: %v", out) + } + + if err := teardownV6(); err != nil { + c.Fatal("Could not perform teardown for IPv6 tests") + } + +} + +// TestDaemonIPv6FixedCIDR checks that when the daemon is started with --ipv6=true and a fixed CIDR +// that running containers are given a link-local and global IPv6 address +func (s *DockerSuite) TestDaemonIPv6FixedCIDR(c *check.C) { + testRequires(c, IPv6) + + if err := setupV6(); err != nil { + c.Fatal("Could not set up host for IPv6 tests") + } + + d := NewDaemon(c) + + if err := d.StartWithBusybox("--ipv6", "--fixed-cidr-v6='2001:db8:1::/64'"); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + defer d.Stop() + + if out, err := d.Cmd("run", "-itd", "--name=ipv6test", "busybox:latest"); err != nil { + c.Fatalf("Could not run container: %s, %v", out, err) + } + + out, err := d.Cmd("inspect", "--format", "'{{.NetworkSettings.Networks.bridge.LinkLocalIPv6Address}}'", "ipv6test") + out = strings.Trim(out, " \r\n'") + + if err != nil { + c.Fatalf("Error inspecting container: %s, %v", out, err) + } + + if ip := net.ParseIP(out); ip == nil { + c.Fatalf("Container should have a link-local IPv6 address") + } + + out, err = d.Cmd("inspect", "--format", "'{{.NetworkSettings.Networks.bridge.GlobalIPv6Address}}'", "ipv6test") + out = strings.Trim(out, " \r\n'") + + if err != nil { + c.Fatalf("Error inspecting container: %s, %v", out, err) + } + + if ip := net.ParseIP(out); ip == nil { + c.Fatalf("Container should have a global IPv6 address") + } + if err := teardownV6(); err != nil { + c.Fatal("Could not perform teardown for IPv6 tests") + } +} + +// TestDaemonIPv6FixedCIDRAndMac checks that when the daemon is started with ipv6 fixed CIDR +// the running containers are given a an IPv6 address derived from the MAC address and the ipv6 fixed CIDR +func (s *DockerSuite) TestDaemonIPv6FixedCIDRAndMac(c *check.C) { + err := setupV6() + c.Assert(err, checker.IsNil) + + d := NewDaemon(c) + + err = d.StartWithBusybox("--ipv6", "--fixed-cidr-v6='2001:db8:1::/64'") + c.Assert(err, checker.IsNil) + defer d.Stop() + + out, err := d.Cmd("run", "-itd", "--name=ipv6test", "--mac-address", "AA:BB:CC:DD:EE:FF", "busybox") + c.Assert(err, checker.IsNil) + + out, err = d.Cmd("inspect", "--format", "'{{.NetworkSettings.Networks.bridge.GlobalIPv6Address}}'", "ipv6test") + c.Assert(err, checker.IsNil) + c.Assert(strings.Trim(out, " \r\n'"), checker.Equals, "2001:db8:1::aabb:ccdd:eeff") + + err = teardownV6() + c.Assert(err, checker.IsNil) +} + +func (s *DockerDaemonSuite) TestDaemonLogLevelWrong(c *check.C) { + c.Assert(s.d.Start("--log-level=bogus"), check.NotNil, check.Commentf("Daemon shouldn't start with wrong log level")) +} + +func (s *DockerSuite) TestDaemonStartWithBackwardCompatibility(c *check.C) { + + var validCommandArgs = [][]string{ + {"--selinux-enabled", "-l", "info"}, + {"--insecure-registry", "daemon"}, + } + + var invalidCommandArgs = [][]string{ + {"--selinux-enabled", "--storage-opt"}, + {"-D", "-b"}, + {"--config", "/tmp"}, + } + + for _, args := range validCommandArgs { + d := NewDaemon(c) + d.Command = "--daemon" + if err := d.Start(args...); err != nil { + c.Fatalf("Daemon should have started successfully with --daemon %v: %v", args, err) + } + d.Stop() + } + + for _, args := range invalidCommandArgs { + d := NewDaemon(c) + if err := d.Start(args...); err == nil { + d.Stop() + c.Fatalf("Daemon should have failed to start with %v", args) + } + } +} + +func (s *DockerSuite) TestDaemonStartWithDaemonCommand(c *check.C) { + + type kind int + + const ( + common kind = iota + daemon + ) + + var flags = []map[kind][]string{ + {common: {"-l", "info"}, daemon: {"--selinux-enabled"}}, + {common: {"-D"}, daemon: {"--selinux-enabled", "-r"}}, + {common: {"-D"}, daemon: {"--restart"}}, + {common: {"--debug"}, daemon: {"--log-driver=json-file", "--log-opt=max-size=1k"}}, + } + + var invalidGlobalFlags = [][]string{ + //Invalid because you cannot pass daemon flags as global flags. + {"--selinux-enabled", "-l", "info"}, + {"-D", "-r"}, + {"--config", "/tmp"}, + } + + // `docker daemon -l info --selinux-enabled` + // should NOT error out + for _, f := range flags { + d := NewDaemon(c) + args := append(f[common], f[daemon]...) + if err := d.Start(args...); err != nil { + c.Fatalf("Daemon should have started successfully with %v: %v", args, err) + } + d.Stop() + } + + // `docker -l info daemon --selinux-enabled` + // should error out + for _, f := range flags { + d := NewDaemon(c) + d.GlobalFlags = f[common] + if err := d.Start(f[daemon]...); err == nil { + d.Stop() + c.Fatalf("Daemon should have failed to start with docker %v daemon %v", d.GlobalFlags, f[daemon]) + } + } + + for _, f := range invalidGlobalFlags { + cmd := exec.Command(dockerBinary, append(f, "daemon")...) + errch := make(chan error) + var err error + go func() { + errch <- cmd.Run() + }() + select { + case <-time.After(time.Second): + cmd.Process.Kill() + case err = <-errch: + } + if err == nil { + c.Fatalf("Daemon should have failed to start with docker %v daemon", f) + } + } +} + +func (s *DockerDaemonSuite) TestDaemonLogLevelDebug(c *check.C) { + if err := s.d.Start("--log-level=debug"); err != nil { + c.Fatal(err) + } + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + if !strings.Contains(string(content), `level=debug`) { + c.Fatalf(`Missing level="debug" in log file:\n%s`, string(content)) + } +} + +func (s *DockerDaemonSuite) TestDaemonLogLevelFatal(c *check.C) { + // we creating new daemons to create new logFile + if err := s.d.Start("--log-level=fatal"); err != nil { + c.Fatal(err) + } + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + if strings.Contains(string(content), `level=debug`) { + c.Fatalf(`Should not have level="debug" in log file:\n%s`, string(content)) + } +} + +func (s *DockerDaemonSuite) TestDaemonFlagD(c *check.C) { + if err := s.d.Start("-D"); err != nil { + c.Fatal(err) + } + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + if !strings.Contains(string(content), `level=debug`) { + c.Fatalf(`Should have level="debug" in log file using -D:\n%s`, string(content)) + } +} + +func (s *DockerDaemonSuite) TestDaemonFlagDebug(c *check.C) { + if err := s.d.Start("--debug"); err != nil { + c.Fatal(err) + } + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + if !strings.Contains(string(content), `level=debug`) { + c.Fatalf(`Should have level="debug" in log file using --debug:\n%s`, string(content)) + } +} + +func (s *DockerDaemonSuite) TestDaemonFlagDebugLogLevelFatal(c *check.C) { + if err := s.d.Start("--debug", "--log-level=fatal"); err != nil { + c.Fatal(err) + } + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + if !strings.Contains(string(content), `level=debug`) { + c.Fatalf(`Should have level="debug" in log file when using both --debug and --log-level=fatal:\n%s`, string(content)) + } +} + +func (s *DockerDaemonSuite) TestDaemonAllocatesListeningPort(c *check.C) { + listeningPorts := [][]string{ + {"0.0.0.0", "0.0.0.0", "5678"}, + {"127.0.0.1", "127.0.0.1", "1234"}, + {"localhost", "127.0.0.1", "1235"}, + } + + cmdArgs := make([]string, 0, len(listeningPorts)*2) + for _, hostDirective := range listeningPorts { + cmdArgs = append(cmdArgs, "--host", fmt.Sprintf("tcp://%s:%s", hostDirective[0], hostDirective[2])) + } + + if err := s.d.StartWithBusybox(cmdArgs...); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + for _, hostDirective := range listeningPorts { + output, err := s.d.Cmd("run", "-p", fmt.Sprintf("%s:%s:80", hostDirective[1], hostDirective[2]), "busybox", "true") + if err == nil { + c.Fatalf("Container should not start, expected port already allocated error: %q", output) + } else if !strings.Contains(output, "port is already allocated") { + c.Fatalf("Expected port is already allocated error: %q", output) + } + } +} + +func (s *DockerDaemonSuite) TestDaemonKeyGeneration(c *check.C) { + // TODO: skip or update for Windows daemon + os.Remove("/etc/docker/key.json") + if err := s.d.Start(); err != nil { + c.Fatalf("Could not start daemon: %v", err) + } + s.d.Stop() + + k, err := libtrust.LoadKeyFile("/etc/docker/key.json") + if err != nil { + c.Fatalf("Error opening key file") + } + kid := k.KeyID() + // Test Key ID is a valid fingerprint (e.g. QQXN:JY5W:TBXI:MK3X:GX6P:PD5D:F56N:NHCS:LVRZ:JA46:R24J:XEFF) + if len(kid) != 59 { + c.Fatalf("Bad key ID: %s", kid) + } +} + +func (s *DockerDaemonSuite) TestDaemonKeyMigration(c *check.C) { + // TODO: skip or update for Windows daemon + os.Remove("/etc/docker/key.json") + k1, err := libtrust.GenerateECP256PrivateKey() + if err != nil { + c.Fatalf("Error generating private key: %s", err) + } + if err := os.MkdirAll(filepath.Join(os.Getenv("HOME"), ".docker"), 0755); err != nil { + c.Fatalf("Error creating .docker directory: %s", err) + } + if err := libtrust.SaveKey(filepath.Join(os.Getenv("HOME"), ".docker", "key.json"), k1); err != nil { + c.Fatalf("Error saving private key: %s", err) + } + + if err := s.d.Start(); err != nil { + c.Fatalf("Could not start daemon: %v", err) + } + s.d.Stop() + + k2, err := libtrust.LoadKeyFile("/etc/docker/key.json") + if err != nil { + c.Fatalf("Error opening key file") + } + if k1.KeyID() != k2.KeyID() { + c.Fatalf("Key not migrated") + } +} + +// GH#11320 - verify that the daemon exits on failure properly +// Note that this explicitly tests the conflict of {-b,--bridge} and {--bip} options as the means +// to get a daemon init failure; no other tests for -b/--bip conflict are therefore required +func (s *DockerDaemonSuite) TestDaemonExitOnFailure(c *check.C) { + //attempt to start daemon with incorrect flags (we know -b and --bip conflict) + if err := s.d.Start("--bridge", "nosuchbridge", "--bip", "1.1.1.1"); err != nil { + //verify we got the right error + if !strings.Contains(err.Error(), "Daemon exited and never started") { + c.Fatalf("Expected daemon not to start, got %v", err) + } + // look in the log and make sure we got the message that daemon is shutting down + runCmd := exec.Command("grep", "Error starting daemon", s.d.LogfileName()) + if out, _, err := runCommandWithOutput(runCmd); err != nil { + c.Fatalf("Expected 'Error starting daemon' message; but doesn't exist in log: %q, err: %v", out, err) + } + } else { + //if we didn't get an error and the daemon is running, this is a failure + c.Fatal("Conflicting options should cause the daemon to error out with a failure") + } +} + +func (s *DockerDaemonSuite) TestDaemonBridgeExternal(c *check.C) { + d := s.d + err := d.Start("--bridge", "nosuchbridge") + c.Assert(err, check.NotNil, check.Commentf("--bridge option with an invalid bridge should cause the daemon to fail")) + defer d.Restart() + + bridgeName := "external-bridge" + bridgeIP := "192.169.1.1/24" + _, bridgeIPNet, _ := net.ParseCIDR(bridgeIP) + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + err = d.StartWithBusybox("--bridge", bridgeName) + c.Assert(err, check.IsNil) + + ipTablesSearchString := bridgeIPNet.String() + ipTablesCmd := exec.Command("iptables", "-t", "nat", "-nvL") + out, _, err = runCommandWithOutput(ipTablesCmd) + c.Assert(err, check.IsNil) + + c.Assert(strings.Contains(out, ipTablesSearchString), check.Equals, true, + check.Commentf("iptables output should have contained %q, but was %q", + ipTablesSearchString, out)) + + _, err = d.Cmd("run", "-d", "--name", "ExtContainer", "busybox", "top") + c.Assert(err, check.IsNil) + + containerIP := d.findContainerIP("ExtContainer") + ip := net.ParseIP(containerIP) + c.Assert(bridgeIPNet.Contains(ip), check.Equals, true, + check.Commentf("Container IP-Address must be in the same subnet range : %s", + containerIP)) +} + +func createInterface(c *check.C, ifType string, ifName string, ipNet string) (string, error) { + args := []string{"link", "add", "name", ifName, "type", ifType} + ipLinkCmd := exec.Command("ip", args...) + out, _, err := runCommandWithOutput(ipLinkCmd) + if err != nil { + return out, err + } + + ifCfgCmd := exec.Command("ifconfig", ifName, ipNet, "up") + out, _, err = runCommandWithOutput(ifCfgCmd) + return out, err +} + +func deleteInterface(c *check.C, ifName string) { + ifCmd := exec.Command("ip", "link", "delete", ifName) + out, _, err := runCommandWithOutput(ifCmd) + c.Assert(err, check.IsNil, check.Commentf(out)) + + flushCmd := exec.Command("iptables", "-t", "nat", "--flush") + out, _, err = runCommandWithOutput(flushCmd) + c.Assert(err, check.IsNil, check.Commentf(out)) + + flushCmd = exec.Command("iptables", "--flush") + out, _, err = runCommandWithOutput(flushCmd) + c.Assert(err, check.IsNil, check.Commentf(out)) +} + +func (s *DockerDaemonSuite) TestDaemonBridgeIP(c *check.C) { + // TestDaemonBridgeIP Steps + // 1. Delete the existing docker0 Bridge + // 2. Set --bip daemon configuration and start the new Docker Daemon + // 3. Check if the bip config has taken effect using ifconfig and iptables commands + // 4. Launch a Container and make sure the IP-Address is in the expected subnet + // 5. Delete the docker0 Bridge + // 6. Restart the Docker Daemon (via deferred action) + // This Restart takes care of bringing docker0 interface back to auto-assigned IP + + defaultNetworkBridge := "docker0" + deleteInterface(c, defaultNetworkBridge) + + d := s.d + + bridgeIP := "192.169.1.1/24" + ip, bridgeIPNet, _ := net.ParseCIDR(bridgeIP) + + err := d.StartWithBusybox("--bip", bridgeIP) + c.Assert(err, check.IsNil) + defer d.Restart() + + ifconfigSearchString := ip.String() + ifconfigCmd := exec.Command("ifconfig", defaultNetworkBridge) + out, _, _, err := runCommandWithStdoutStderr(ifconfigCmd) + c.Assert(err, check.IsNil) + + c.Assert(strings.Contains(out, ifconfigSearchString), check.Equals, true, + check.Commentf("ifconfig output should have contained %q, but was %q", + ifconfigSearchString, out)) + + ipTablesSearchString := bridgeIPNet.String() + ipTablesCmd := exec.Command("iptables", "-t", "nat", "-nvL") + out, _, err = runCommandWithOutput(ipTablesCmd) + c.Assert(err, check.IsNil) + + c.Assert(strings.Contains(out, ipTablesSearchString), check.Equals, true, + check.Commentf("iptables output should have contained %q, but was %q", + ipTablesSearchString, out)) + + out, err = d.Cmd("run", "-d", "--name", "test", "busybox", "top") + c.Assert(err, check.IsNil) + + containerIP := d.findContainerIP("test") + ip = net.ParseIP(containerIP) + c.Assert(bridgeIPNet.Contains(ip), check.Equals, true, + check.Commentf("Container IP-Address must be in the same subnet range : %s", + containerIP)) + deleteInterface(c, defaultNetworkBridge) +} + +func (s *DockerDaemonSuite) TestDaemonRestartWithBridgeIPChange(c *check.C) { + if err := s.d.Start(); err != nil { + c.Fatalf("Could not start daemon: %v", err) + } + defer s.d.Restart() + if err := s.d.Stop(); err != nil { + c.Fatalf("Could not stop daemon: %v", err) + } + + // now we will change the docker0's IP and then try starting the daemon + bridgeIP := "192.169.100.1/24" + _, bridgeIPNet, _ := net.ParseCIDR(bridgeIP) + + ipCmd := exec.Command("ifconfig", "docker0", bridgeIP) + stdout, stderr, _, err := runCommandWithStdoutStderr(ipCmd) + if err != nil { + c.Fatalf("failed to change docker0's IP association: %v, stdout: %q, stderr: %q", err, stdout, stderr) + } + + if err := s.d.Start("--bip", bridgeIP); err != nil { + c.Fatalf("Could not start daemon: %v", err) + } + + //check if the iptables contains new bridgeIP MASQUERADE rule + ipTablesSearchString := bridgeIPNet.String() + ipTablesCmd := exec.Command("iptables", "-t", "nat", "-nvL") + out, _, err := runCommandWithOutput(ipTablesCmd) + if err != nil { + c.Fatalf("Could not run iptables -nvL: %s, %v", out, err) + } + if !strings.Contains(out, ipTablesSearchString) { + c.Fatalf("iptables output should have contained new MASQUERADE rule with IP %q, but was %q", ipTablesSearchString, out) + } +} + +func (s *DockerDaemonSuite) TestDaemonBridgeFixedCidr(c *check.C) { + d := s.d + + bridgeName := "external-bridge" + bridgeIP := "192.169.1.1/24" + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + args := []string{"--bridge", bridgeName, "--fixed-cidr", "192.169.1.0/30"} + err = d.StartWithBusybox(args...) + c.Assert(err, check.IsNil) + defer d.Restart() + + for i := 0; i < 4; i++ { + cName := "Container" + strconv.Itoa(i) + out, err := d.Cmd("run", "-d", "--name", cName, "busybox", "top") + if err != nil { + c.Assert(strings.Contains(out, "no available IPv4 addresses"), check.Equals, true, + check.Commentf("Could not run a Container : %s %s", err.Error(), out)) + } + } +} + +func (s *DockerDaemonSuite) TestDaemonBridgeFixedCidr2(c *check.C) { + d := s.d + + bridgeName := "external-bridge" + bridgeIP := "10.2.2.1/16" + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + err = d.StartWithBusybox("--bip", bridgeIP, "--fixed-cidr", "10.2.2.0/24") + c.Assert(err, check.IsNil) + defer s.d.Restart() + + out, err = d.Cmd("run", "-d", "--name", "bb", "busybox", "top") + c.Assert(err, checker.IsNil, check.Commentf(out)) + defer d.Cmd("stop", "bb") + + out, err = d.Cmd("exec", "bb", "/bin/sh", "-c", "ifconfig eth0 | awk '/inet addr/{print substr($2,6)}'") + c.Assert(out, checker.Equals, "10.2.2.0\n") + + out, err = d.Cmd("run", "--rm", "busybox", "/bin/sh", "-c", "ifconfig eth0 | awk '/inet addr/{print substr($2,6)}'") + c.Assert(err, checker.IsNil, check.Commentf(out)) + c.Assert(out, checker.Equals, "10.2.2.2\n") +} + +func (s *DockerDaemonSuite) TestDaemonBridgeFixedCIDREqualBridgeNetwork(c *check.C) { + d := s.d + + bridgeName := "external-bridge" + bridgeIP := "172.27.42.1/16" + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + err = d.StartWithBusybox("--bridge", bridgeName, "--fixed-cidr", bridgeIP) + c.Assert(err, check.IsNil) + defer s.d.Restart() + + out, err = d.Cmd("run", "-d", "busybox", "top") + c.Assert(err, check.IsNil, check.Commentf(out)) + cid1 := strings.TrimSpace(out) + defer d.Cmd("stop", cid1) +} + +func (s *DockerDaemonSuite) TestDaemonDefaultGatewayIPv4Implicit(c *check.C) { + defaultNetworkBridge := "docker0" + deleteInterface(c, defaultNetworkBridge) + + d := s.d + + bridgeIP := "192.169.1.1" + bridgeIPNet := fmt.Sprintf("%s/24", bridgeIP) + + err := d.StartWithBusybox("--bip", bridgeIPNet) + c.Assert(err, check.IsNil) + defer d.Restart() + + expectedMessage := fmt.Sprintf("default via %s dev", bridgeIP) + out, err := d.Cmd("run", "busybox", "ip", "-4", "route", "list", "0/0") + c.Assert(strings.Contains(out, expectedMessage), check.Equals, true, + check.Commentf("Implicit default gateway should be bridge IP %s, but default route was '%s'", + bridgeIP, strings.TrimSpace(out))) + deleteInterface(c, defaultNetworkBridge) +} + +func (s *DockerDaemonSuite) TestDaemonDefaultGatewayIPv4Explicit(c *check.C) { + defaultNetworkBridge := "docker0" + deleteInterface(c, defaultNetworkBridge) + + d := s.d + + bridgeIP := "192.169.1.1" + bridgeIPNet := fmt.Sprintf("%s/24", bridgeIP) + gatewayIP := "192.169.1.254" + + err := d.StartWithBusybox("--bip", bridgeIPNet, "--default-gateway", gatewayIP) + c.Assert(err, check.IsNil) + defer d.Restart() + + expectedMessage := fmt.Sprintf("default via %s dev", gatewayIP) + out, err := d.Cmd("run", "busybox", "ip", "-4", "route", "list", "0/0") + c.Assert(strings.Contains(out, expectedMessage), check.Equals, true, + check.Commentf("Explicit default gateway should be %s, but default route was '%s'", + gatewayIP, strings.TrimSpace(out))) + deleteInterface(c, defaultNetworkBridge) +} + +func (s *DockerDaemonSuite) TestDaemonDefaultGatewayIPv4ExplicitOutsideContainerSubnet(c *check.C) { + defaultNetworkBridge := "docker0" + deleteInterface(c, defaultNetworkBridge) + + // Program a custom default gateway outside of the container subnet, daemon should accept it and start + err := s.d.StartWithBusybox("--bip", "172.16.0.10/16", "--fixed-cidr", "172.16.1.0/24", "--default-gateway", "172.16.0.254") + c.Assert(err, check.IsNil) + + deleteInterface(c, defaultNetworkBridge) + s.d.Restart() +} + +func (s *DockerDaemonSuite) TestDaemonDefaultNetworkInvalidClusterConfig(c *check.C) { + testRequires(c, SameHostDaemon) + + // Start daemon without docker0 bridge + defaultNetworkBridge := "docker0" + deleteInterface(c, defaultNetworkBridge) + + d := NewDaemon(c) + discoveryBackend := "consul://consuladdr:consulport/some/path" + err := d.Start(fmt.Sprintf("--cluster-store=%s", discoveryBackend)) + c.Assert(err, checker.IsNil) + + // Start daemon with docker0 bridge + ifconfigCmd := exec.Command("ifconfig", defaultNetworkBridge) + _, err = runCommand(ifconfigCmd) + c.Assert(err, check.IsNil) + + err = d.Restart(fmt.Sprintf("--cluster-store=%s", discoveryBackend)) + c.Assert(err, checker.IsNil) + + d.Stop() +} + +func (s *DockerDaemonSuite) TestDaemonIP(c *check.C) { + d := s.d + + ipStr := "192.170.1.1/24" + ip, _, _ := net.ParseCIDR(ipStr) + args := []string{"--ip", ip.String()} + err := d.StartWithBusybox(args...) + c.Assert(err, check.IsNil) + defer d.Restart() + + out, err := d.Cmd("run", "-d", "-p", "8000:8000", "busybox", "top") + c.Assert(err, check.NotNil, + check.Commentf("Running a container must fail with an invalid --ip option")) + c.Assert(strings.Contains(out, "Error starting userland proxy"), check.Equals, true) + + ifName := "dummy" + out, err = createInterface(c, "dummy", ifName, ipStr) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, ifName) + + _, err = d.Cmd("run", "-d", "-p", "8000:8000", "busybox", "top") + c.Assert(err, check.IsNil) + + ipTablesCmd := exec.Command("iptables", "-t", "nat", "-nvL") + out, _, err = runCommandWithOutput(ipTablesCmd) + c.Assert(err, check.IsNil) + + regex := fmt.Sprintf("DNAT.*%s.*dpt:8000", ip.String()) + matched, _ := regexp.MatchString(regex, out) + c.Assert(matched, check.Equals, true, + check.Commentf("iptables output should have contained %q, but was %q", regex, out)) +} + +func (s *DockerDaemonSuite) TestDaemonICCPing(c *check.C) { + d := s.d + + bridgeName := "external-bridge" + bridgeIP := "192.169.1.1/24" + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + args := []string{"--bridge", bridgeName, "--icc=false"} + err = d.StartWithBusybox(args...) + c.Assert(err, check.IsNil) + defer d.Restart() + + ipTablesCmd := exec.Command("iptables", "-nvL", "FORWARD") + out, _, err = runCommandWithOutput(ipTablesCmd) + c.Assert(err, check.IsNil) + + regex := fmt.Sprintf("DROP.*all.*%s.*%s", bridgeName, bridgeName) + matched, _ := regexp.MatchString(regex, out) + c.Assert(matched, check.Equals, true, + check.Commentf("iptables output should have contained %q, but was %q", regex, out)) + + // Pinging another container must fail with --icc=false + pingContainers(c, d, true) + + ipStr := "192.171.1.1/24" + ip, _, _ := net.ParseCIDR(ipStr) + ifName := "icc-dummy" + + createInterface(c, "dummy", ifName, ipStr) + + // But, Pinging external or a Host interface must succeed + pingCmd := fmt.Sprintf("ping -c 1 %s -W 1", ip.String()) + runArgs := []string{"--rm", "busybox", "sh", "-c", pingCmd} + _, err = d.Cmd("run", runArgs...) + c.Assert(err, check.IsNil) +} + +func (s *DockerDaemonSuite) TestDaemonICCLinkExpose(c *check.C) { + d := s.d + + bridgeName := "external-bridge" + bridgeIP := "192.169.1.1/24" + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + args := []string{"--bridge", bridgeName, "--icc=false"} + err = d.StartWithBusybox(args...) + c.Assert(err, check.IsNil) + defer d.Restart() + + ipTablesCmd := exec.Command("iptables", "-nvL", "FORWARD") + out, _, err = runCommandWithOutput(ipTablesCmd) + c.Assert(err, check.IsNil) + + regex := fmt.Sprintf("DROP.*all.*%s.*%s", bridgeName, bridgeName) + matched, _ := regexp.MatchString(regex, out) + c.Assert(matched, check.Equals, true, + check.Commentf("iptables output should have contained %q, but was %q", regex, out)) + + out, err = d.Cmd("run", "-d", "--expose", "4567", "--name", "icc1", "busybox", "nc", "-l", "-p", "4567") + c.Assert(err, check.IsNil, check.Commentf(out)) + + out, err = d.Cmd("run", "--link", "icc1:icc1", "busybox", "nc", "icc1", "4567") + c.Assert(err, check.IsNil, check.Commentf(out)) +} + +func (s *DockerDaemonSuite) TestDaemonLinksIpTablesRulesWhenLinkAndUnlink(c *check.C) { + bridgeName := "external-bridge" + bridgeIP := "192.169.1.1/24" + + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + err = s.d.StartWithBusybox("--bridge", bridgeName, "--icc=false") + c.Assert(err, check.IsNil) + defer s.d.Restart() + + _, err = s.d.Cmd("run", "-d", "--name", "child", "--publish", "8080:80", "busybox", "top") + c.Assert(err, check.IsNil) + _, err = s.d.Cmd("run", "-d", "--name", "parent", "--link", "child:http", "busybox", "top") + c.Assert(err, check.IsNil) + + childIP := s.d.findContainerIP("child") + parentIP := s.d.findContainerIP("parent") + + sourceRule := []string{"-i", bridgeName, "-o", bridgeName, "-p", "tcp", "-s", childIP, "--sport", "80", "-d", parentIP, "-j", "ACCEPT"} + destinationRule := []string{"-i", bridgeName, "-o", bridgeName, "-p", "tcp", "-s", parentIP, "--dport", "80", "-d", childIP, "-j", "ACCEPT"} + if !iptables.Exists("filter", "DOCKER", sourceRule...) || !iptables.Exists("filter", "DOCKER", destinationRule...) { + c.Fatal("Iptables rules not found") + } + + s.d.Cmd("rm", "--link", "parent/http") + if iptables.Exists("filter", "DOCKER", sourceRule...) || iptables.Exists("filter", "DOCKER", destinationRule...) { + c.Fatal("Iptables rules should be removed when unlink") + } + + s.d.Cmd("kill", "child") + s.d.Cmd("kill", "parent") +} + +func (s *DockerDaemonSuite) TestDaemonUlimitDefaults(c *check.C) { + testRequires(c, NativeExecDriver) + + if err := s.d.StartWithBusybox("--default-ulimit", "nofile=42:42", "--default-ulimit", "nproc=1024:1024"); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "--ulimit", "nproc=2048", "--name=test", "busybox", "/bin/sh", "-c", "echo $(ulimit -n); echo $(ulimit -p)") + if err != nil { + c.Fatal(out, err) + } + + outArr := strings.Split(out, "\n") + if len(outArr) < 2 { + c.Fatalf("got unexpected output: %s", out) + } + nofile := strings.TrimSpace(outArr[0]) + nproc := strings.TrimSpace(outArr[1]) + + if nofile != "42" { + c.Fatalf("expected `ulimit -n` to be `42`, got: %s", nofile) + } + if nproc != "2048" { + c.Fatalf("exepcted `ulimit -p` to be 2048, got: %s", nproc) + } + + // Now restart daemon with a new default + if err := s.d.Restart("--default-ulimit", "nofile=43"); err != nil { + c.Fatal(err) + } + + out, err = s.d.Cmd("start", "-a", "test") + if err != nil { + c.Fatal(err) + } + + outArr = strings.Split(out, "\n") + if len(outArr) < 2 { + c.Fatalf("got unexpected output: %s", out) + } + nofile = strings.TrimSpace(outArr[0]) + nproc = strings.TrimSpace(outArr[1]) + + if nofile != "43" { + c.Fatalf("expected `ulimit -n` to be `43`, got: %s", nofile) + } + if nproc != "2048" { + c.Fatalf("exepcted `ulimit -p` to be 2048, got: %s", nproc) + } +} + +// #11315 +func (s *DockerDaemonSuite) TestDaemonRestartRenameContainer(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + if out, err := s.d.Cmd("run", "--name=test", "busybox"); err != nil { + c.Fatal(err, out) + } + + if out, err := s.d.Cmd("rename", "test", "test2"); err != nil { + c.Fatal(err, out) + } + + if err := s.d.Restart(); err != nil { + c.Fatal(err) + } + + if out, err := s.d.Cmd("start", "test2"); err != nil { + c.Fatal(err, out) + } +} + +func (s *DockerDaemonSuite) TestDaemonLoggingDriverDefault(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "-d", "busybox", "echo", "testline") + if err != nil { + c.Fatal(out, err) + } + id := strings.TrimSpace(out) + + if out, err := s.d.Cmd("wait", id); err != nil { + c.Fatal(out, err) + } + logPath := filepath.Join(s.d.root, "containers", id, id+"-json.log") + + if _, err := os.Stat(logPath); err != nil { + c.Fatal(err) + } + f, err := os.Open(logPath) + if err != nil { + c.Fatal(err) + } + var res struct { + Log string `json:"log"` + Stream string `json:"stream"` + Time time.Time `json:"time"` + } + if err := json.NewDecoder(f).Decode(&res); err != nil { + c.Fatal(err) + } + if res.Log != "testline\n" { + c.Fatalf("Unexpected log line: %q, expected: %q", res.Log, "testline\n") + } + if res.Stream != "stdout" { + c.Fatalf("Unexpected stream: %q, expected: %q", res.Stream, "stdout") + } + if !time.Now().After(res.Time) { + c.Fatalf("Log time %v in future", res.Time) + } +} + +func (s *DockerDaemonSuite) TestDaemonLoggingDriverDefaultOverride(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "-d", "--log-driver=none", "busybox", "echo", "testline") + if err != nil { + c.Fatal(out, err) + } + id := strings.TrimSpace(out) + + if out, err := s.d.Cmd("wait", id); err != nil { + c.Fatal(out, err) + } + logPath := filepath.Join(s.d.root, "containers", id, id+"-json.log") + + if _, err := os.Stat(logPath); err == nil || !os.IsNotExist(err) { + c.Fatalf("%s shouldn't exits, error on Stat: %s", logPath, err) + } +} + +func (s *DockerDaemonSuite) TestDaemonLoggingDriverNone(c *check.C) { + if err := s.d.StartWithBusybox("--log-driver=none"); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "-d", "busybox", "echo", "testline") + if err != nil { + c.Fatal(out, err) + } + id := strings.TrimSpace(out) + if out, err := s.d.Cmd("wait", id); err != nil { + c.Fatal(out, err) + } + + logPath := filepath.Join(s.d.folder, "graph", "containers", id, id+"-json.log") + + if _, err := os.Stat(logPath); err == nil || !os.IsNotExist(err) { + c.Fatalf("%s shouldn't exits, error on Stat: %s", logPath, err) + } +} + +func (s *DockerDaemonSuite) TestDaemonLoggingDriverNoneOverride(c *check.C) { + if err := s.d.StartWithBusybox("--log-driver=none"); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "-d", "--log-driver=json-file", "busybox", "echo", "testline") + if err != nil { + c.Fatal(out, err) + } + id := strings.TrimSpace(out) + + if out, err := s.d.Cmd("wait", id); err != nil { + c.Fatal(out, err) + } + logPath := filepath.Join(s.d.root, "containers", id, id+"-json.log") + + if _, err := os.Stat(logPath); err != nil { + c.Fatal(err) + } + f, err := os.Open(logPath) + if err != nil { + c.Fatal(err) + } + var res struct { + Log string `json:"log"` + Stream string `json:"stream"` + Time time.Time `json:"time"` + } + if err := json.NewDecoder(f).Decode(&res); err != nil { + c.Fatal(err) + } + if res.Log != "testline\n" { + c.Fatalf("Unexpected log line: %q, expected: %q", res.Log, "testline\n") + } + if res.Stream != "stdout" { + c.Fatalf("Unexpected stream: %q, expected: %q", res.Stream, "stdout") + } + if !time.Now().After(res.Time) { + c.Fatalf("Log time %v in future", res.Time) + } +} + +func (s *DockerDaemonSuite) TestDaemonLoggingDriverNoneLogsError(c *check.C) { + if err := s.d.StartWithBusybox("--log-driver=none"); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "-d", "busybox", "echo", "testline") + if err != nil { + c.Fatal(out, err) + } + id := strings.TrimSpace(out) + out, err = s.d.Cmd("logs", id) + if err == nil { + c.Fatalf("Logs should fail with 'none' driver") + } + if !strings.Contains(out, `"logs" command is supported only for "json-file" and "journald" logging drivers (got: none)`) { + c.Fatalf("There should be an error about none not being a recognized log driver, got: %s", out) + } +} + +func (s *DockerDaemonSuite) TestDaemonDots(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + // Now create 4 containers + if _, err := s.d.Cmd("create", "busybox"); err != nil { + c.Fatalf("Error creating container: %q", err) + } + if _, err := s.d.Cmd("create", "busybox"); err != nil { + c.Fatalf("Error creating container: %q", err) + } + if _, err := s.d.Cmd("create", "busybox"); err != nil { + c.Fatalf("Error creating container: %q", err) + } + if _, err := s.d.Cmd("create", "busybox"); err != nil { + c.Fatalf("Error creating container: %q", err) + } + + s.d.Stop() + + s.d.Start("--log-level=debug") + s.d.Stop() + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + if strings.Contains(string(content), "....") { + c.Fatalf("Debug level should not have ....\n%s", string(content)) + } + + s.d.Start("--log-level=error") + s.d.Stop() + content, _ = ioutil.ReadFile(s.d.logFile.Name()) + if strings.Contains(string(content), "....") { + c.Fatalf("Error level should not have ....\n%s", string(content)) + } + + s.d.Start("--log-level=info") + s.d.Stop() + content, _ = ioutil.ReadFile(s.d.logFile.Name()) + if !strings.Contains(string(content), "....") { + c.Fatalf("Info level should have ....\n%s", string(content)) + } +} + +func (s *DockerDaemonSuite) TestDaemonUnixSockCleanedUp(c *check.C) { + dir, err := ioutil.TempDir("", "socket-cleanup-test") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(dir) + + sockPath := filepath.Join(dir, "docker.sock") + if err := s.d.Start("--host", "unix://"+sockPath); err != nil { + c.Fatal(err) + } + + if _, err := os.Stat(sockPath); err != nil { + c.Fatal("socket does not exist") + } + + if err := s.d.Stop(); err != nil { + c.Fatal(err) + } + + if _, err := os.Stat(sockPath); err == nil || !os.IsNotExist(err) { + c.Fatal("unix socket is not cleaned up") + } +} + +func (s *DockerDaemonSuite) TestDaemonWithWrongkey(c *check.C) { + type Config struct { + Crv string `json:"crv"` + D string `json:"d"` + Kid string `json:"kid"` + Kty string `json:"kty"` + X string `json:"x"` + Y string `json:"y"` + } + + os.Remove("/etc/docker/key.json") + if err := s.d.Start(); err != nil { + c.Fatalf("Failed to start daemon: %v", err) + } + + if err := s.d.Stop(); err != nil { + c.Fatalf("Could not stop daemon: %v", err) + } + + config := &Config{} + bytes, err := ioutil.ReadFile("/etc/docker/key.json") + if err != nil { + c.Fatalf("Error reading key.json file: %s", err) + } + + // byte[] to Data-Struct + if err := json.Unmarshal(bytes, &config); err != nil { + c.Fatalf("Error Unmarshal: %s", err) + } + + //replace config.Kid with the fake value + config.Kid = "VSAJ:FUYR:X3H2:B2VZ:KZ6U:CJD5:K7BX:ZXHY:UZXT:P4FT:MJWG:HRJ4" + + // NEW Data-Struct to byte[] + newBytes, err := json.Marshal(&config) + if err != nil { + c.Fatalf("Error Marshal: %s", err) + } + + // write back + if err := ioutil.WriteFile("/etc/docker/key.json", newBytes, 0400); err != nil { + c.Fatalf("Error ioutil.WriteFile: %s", err) + } + + defer os.Remove("/etc/docker/key.json") + + if err := s.d.Start(); err == nil { + c.Fatalf("It should not be successful to start daemon with wrong key: %v", err) + } + + content, _ := ioutil.ReadFile(s.d.logFile.Name()) + + if !strings.Contains(string(content), "Public Key ID does not match") { + c.Fatal("Missing KeyID message from daemon logs") + } +} + +func (s *DockerDaemonSuite) TestDaemonRestartKillWait(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + out, err := s.d.Cmd("run", "-id", "busybox", "/bin/cat") + if err != nil { + c.Fatalf("Could not run /bin/cat: err=%v\n%s", err, out) + } + containerID := strings.TrimSpace(out) + + if out, err := s.d.Cmd("kill", containerID); err != nil { + c.Fatalf("Could not kill %s: err=%v\n%s", containerID, err, out) + } + + if err := s.d.Restart(); err != nil { + c.Fatalf("Could not restart daemon: %v", err) + } + + errchan := make(chan error) + go func() { + if out, err := s.d.Cmd("wait", containerID); err != nil { + errchan <- fmt.Errorf("%v:\n%s", err, out) + } + close(errchan) + }() + + select { + case <-time.After(5 * time.Second): + c.Fatal("Waiting on a stopped (killed) container timed out") + case err := <-errchan: + if err != nil { + c.Fatal(err) + } + } +} + +// TestHttpsInfo connects via two-way authenticated HTTPS to the info endpoint +func (s *DockerDaemonSuite) TestHttpsInfo(c *check.C) { + const ( + testDaemonHTTPSAddr = "tcp://localhost:4271" + ) + + if err := s.d.Start("--tlsverify", "--tlscacert", "fixtures/https/ca.pem", "--tlscert", "fixtures/https/server-cert.pem", + "--tlskey", "fixtures/https/server-key.pem", "-H", testDaemonHTTPSAddr); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + daemonArgs := []string{"--host", testDaemonHTTPSAddr, "--tlsverify", "--tlscacert", "fixtures/https/ca.pem", "--tlscert", "fixtures/https/client-cert.pem", "--tlskey", "fixtures/https/client-key.pem"} + out, err := s.d.CmdWithArgs(daemonArgs, "info") + if err != nil { + c.Fatalf("Error Occurred: %s and output: %s", err, out) + } +} + +// TestTlsVerify verifies that --tlsverify=false turns on tls +func (s *DockerDaemonSuite) TestTlsVerify(c *check.C) { + out, err := exec.Command(dockerBinary, "daemon", "--tlsverify=false").CombinedOutput() + if err == nil || !strings.Contains(string(out), "Could not load X509 key pair") { + c.Fatalf("Daemon should not have started due to missing certs: %v\n%s", err, string(out)) + } +} + +// TestHttpsInfoRogueCert connects via two-way authenticated HTTPS to the info endpoint +// by using a rogue client certificate and checks that it fails with the expected error. +func (s *DockerDaemonSuite) TestHttpsInfoRogueCert(c *check.C) { + const ( + errBadCertificate = "remote error: bad certificate" + testDaemonHTTPSAddr = "tcp://localhost:4271" + ) + + if err := s.d.Start("--tlsverify", "--tlscacert", "fixtures/https/ca.pem", "--tlscert", "fixtures/https/server-cert.pem", + "--tlskey", "fixtures/https/server-key.pem", "-H", testDaemonHTTPSAddr); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + daemonArgs := []string{"--host", testDaemonHTTPSAddr, "--tlsverify", "--tlscacert", "fixtures/https/ca.pem", "--tlscert", "fixtures/https/client-rogue-cert.pem", "--tlskey", "fixtures/https/client-rogue-key.pem"} + out, err := s.d.CmdWithArgs(daemonArgs, "info") + if err == nil || !strings.Contains(out, errBadCertificate) { + c.Fatalf("Expected err: %s, got instead: %s and output: %s", errBadCertificate, err, out) + } +} + +// TestHttpsInfoRogueServerCert connects via two-way authenticated HTTPS to the info endpoint +// which provides a rogue server certificate and checks that it fails with the expected error +func (s *DockerDaemonSuite) TestHttpsInfoRogueServerCert(c *check.C) { + const ( + errCaUnknown = "x509: certificate signed by unknown authority" + testDaemonRogueHTTPSAddr = "tcp://localhost:4272" + ) + if err := s.d.Start("--tlsverify", "--tlscacert", "fixtures/https/ca.pem", "--tlscert", "fixtures/https/server-rogue-cert.pem", + "--tlskey", "fixtures/https/server-rogue-key.pem", "-H", testDaemonRogueHTTPSAddr); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + daemonArgs := []string{"--host", testDaemonRogueHTTPSAddr, "--tlsverify", "--tlscacert", "fixtures/https/ca.pem", "--tlscert", "fixtures/https/client-rogue-cert.pem", "--tlskey", "fixtures/https/client-rogue-key.pem"} + out, err := s.d.CmdWithArgs(daemonArgs, "info") + if err == nil || !strings.Contains(out, errCaUnknown) { + c.Fatalf("Expected err: %s, got instead: %s and output: %s", errCaUnknown, err, out) + } +} + +func pingContainers(c *check.C, d *Daemon, expectFailure bool) { + var dargs []string + if d != nil { + dargs = []string{"--host", d.sock()} + } + + args := append(dargs, "run", "-d", "--name", "container1", "busybox", "top") + dockerCmd(c, args...) + + args = append(dargs, "run", "--rm", "--link", "container1:alias1", "busybox", "sh", "-c") + pingCmd := "ping -c 1 %s -W 1" + args = append(args, fmt.Sprintf(pingCmd, "alias1")) + _, _, err := dockerCmdWithError(args...) + + if expectFailure { + c.Assert(err, check.NotNil) + } else { + c.Assert(err, check.IsNil) + } + + args = append(dargs, "rm", "-f", "container1") + dockerCmd(c, args...) +} + +func (s *DockerDaemonSuite) TestDaemonRestartWithSocketAsVolume(c *check.C) { + c.Assert(s.d.StartWithBusybox(), check.IsNil) + + socket := filepath.Join(s.d.folder, "docker.sock") + + out, err := s.d.Cmd("run", "-d", "--restart=always", "-v", socket+":/sock", "busybox") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + c.Assert(s.d.Restart(), check.IsNil) +} + +func (s *DockerDaemonSuite) TestCleanupMountsAfterCrash(c *check.C) { + c.Assert(s.d.StartWithBusybox(), check.IsNil) + + out, err := s.d.Cmd("run", "-d", "busybox", "top") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + id := strings.TrimSpace(out) + c.Assert(s.d.cmd.Process.Signal(os.Kill), check.IsNil) + c.Assert(s.d.Start(), check.IsNil) + mountOut, err := ioutil.ReadFile("/proc/self/mountinfo") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", mountOut)) + + comment := check.Commentf("%s is still mounted from older daemon start:\nDaemon root repository %s\n%s", id, s.d.folder, mountOut) + c.Assert(strings.Contains(string(mountOut), id), check.Equals, false, comment) +} + +func (s *DockerDaemonSuite) TestRunContainerWithBridgeNone(c *check.C) { + testRequires(c, NativeExecDriver, NotUserNamespace) + c.Assert(s.d.StartWithBusybox("-b", "none"), check.IsNil) + + out, err := s.d.Cmd("run", "--rm", "busybox", "ip", "l") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + c.Assert(strings.Contains(out, "eth0"), check.Equals, false, + check.Commentf("There shouldn't be eth0 in container in default(bridge) mode when bridge network is disabled: %s", out)) + + out, err = s.d.Cmd("run", "--rm", "--net=bridge", "busybox", "ip", "l") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + c.Assert(strings.Contains(out, "eth0"), check.Equals, false, + check.Commentf("There shouldn't be eth0 in container in bridge mode when bridge network is disabled: %s", out)) + cmd := exec.Command("ip", "l") + stdout := bytes.NewBuffer(nil) + cmd.Stdout = stdout + if err := cmd.Run(); err != nil { + c.Fatal("Failed to get host network interface") + } + out, err = s.d.Cmd("run", "--rm", "--net=host", "busybox", "ip", "l") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + c.Assert(out, check.Equals, fmt.Sprintf("%s", stdout), + check.Commentf("The network interfaces in container should be the same with host when --net=host when bridge network is disabled: %s", out)) +} + +func (s *DockerDaemonSuite) TestDaemonRestartWithContainerRunning(t *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + t.Fatal(err) + } + if out, err := s.d.Cmd("run", "-ti", "-d", "--name", "test", "busybox"); err != nil { + t.Fatal(out, err) + } + + if err := s.d.Restart(); err != nil { + t.Fatal(err) + } + // Container 'test' should be removed without error + if out, err := s.d.Cmd("rm", "test"); err != nil { + t.Fatal(out, err) + } +} + +func (s *DockerDaemonSuite) TestDaemonRestartCleanupNetns(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + out, err := s.d.Cmd("run", "--name", "netns", "-d", "busybox", "top") + if err != nil { + c.Fatal(out, err) + } + + // Get sandbox key via inspect + out, err = s.d.Cmd("inspect", "--format", "'{{.NetworkSettings.SandboxKey}}'", "netns") + if err != nil { + c.Fatalf("Error inspecting container: %s, %v", out, err) + } + fileName := strings.Trim(out, " \r\n'") + + if out, err := s.d.Cmd("stop", "netns"); err != nil { + c.Fatal(out, err) + } + + // Test if the file still exists + out, _, err = runCommandWithOutput(exec.Command("stat", "-c", "%n", fileName)) + out = strings.TrimSpace(out) + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + c.Assert(out, check.Equals, fileName, check.Commentf("Output: %s", out)) + + // Remove the container and restart the daemon + if out, err := s.d.Cmd("rm", "netns"); err != nil { + c.Fatal(out, err) + } + + if err := s.d.Restart(); err != nil { + c.Fatal(err) + } + + // Test again and see now the netns file does not exist + out, _, err = runCommandWithOutput(exec.Command("stat", "-c", "%n", fileName)) + out = strings.TrimSpace(out) + c.Assert(err, check.Not(check.IsNil), check.Commentf("Output: %s", out)) +} + +// tests regression detailed in #13964 where DOCKER_TLS_VERIFY env is ignored +func (s *DockerDaemonSuite) TestDaemonNoTlsCliTlsVerifyWithEnv(c *check.C) { + host := "tcp://localhost:4271" + c.Assert(s.d.Start("-H", host), check.IsNil) + cmd := exec.Command(dockerBinary, "-H", host, "info") + cmd.Env = []string{"DOCKER_TLS_VERIFY=1", "DOCKER_CERT_PATH=fixtures/https"} + out, _, err := runCommandWithOutput(cmd) + c.Assert(err, check.Not(check.IsNil), check.Commentf("%s", out)) + c.Assert(strings.Contains(out, "error occurred trying to connect"), check.Equals, true) + +} + +func setupV6() error { + // Hack to get the right IPv6 address on docker0, which has already been created + err := exec.Command("ip", "addr", "add", "fe80::1/64", "dev", "docker0").Run() + if err != nil { + return err + } + return nil +} + +func teardownV6() error { + err := exec.Command("ip", "addr", "del", "fe80::1/64", "dev", "docker0").Run() + if err != nil { + return err + } + return nil +} + +func (s *DockerDaemonSuite) TestDaemonRestartWithContainerWithRestartPolicyAlways(c *check.C) { + c.Assert(s.d.StartWithBusybox(), check.IsNil) + + out, err := s.d.Cmd("run", "-d", "--restart", "always", "busybox", "top") + c.Assert(err, check.IsNil) + id := strings.TrimSpace(out) + + _, err = s.d.Cmd("stop", id) + c.Assert(err, check.IsNil) + _, err = s.d.Cmd("wait", id) + c.Assert(err, check.IsNil) + + out, err = s.d.Cmd("ps", "-q") + c.Assert(err, check.IsNil) + c.Assert(out, check.Equals, "") + + c.Assert(s.d.Restart(), check.IsNil) + + out, err = s.d.Cmd("ps", "-q") + c.Assert(err, check.IsNil) + c.Assert(strings.TrimSpace(out), check.Equals, id[:12]) +} + +func (s *DockerDaemonSuite) TestDaemonWideLogConfig(c *check.C) { + if err := s.d.StartWithBusybox("--log-driver=json-file", "--log-opt=max-size=1k"); err != nil { + c.Fatal(err) + } + out, err := s.d.Cmd("run", "-d", "--name=logtest", "busybox", "top") + c.Assert(err, check.IsNil, check.Commentf("Output: %s, err: %v", out, err)) + out, err = s.d.Cmd("inspect", "-f", "{{ .HostConfig.LogConfig.Config }}", "logtest") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + cfg := strings.TrimSpace(out) + if cfg != "map[max-size:1k]" { + c.Fatalf("Unexpected log-opt: %s, expected map[max-size:1k]", cfg) + } +} + +func (s *DockerDaemonSuite) TestDaemonRestartWithPausedContainer(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + if out, err := s.d.Cmd("run", "-i", "-d", "--name", "test", "busybox", "top"); err != nil { + c.Fatal(err, out) + } + if out, err := s.d.Cmd("pause", "test"); err != nil { + c.Fatal(err, out) + } + if err := s.d.Restart(); err != nil { + c.Fatal(err) + } + + errchan := make(chan error) + go func() { + out, err := s.d.Cmd("start", "test") + if err != nil { + errchan <- fmt.Errorf("%v:\n%s", err, out) + } + name := strings.TrimSpace(out) + if name != "test" { + errchan <- fmt.Errorf("Paused container start error on docker daemon restart, expected 'test' but got '%s'", name) + } + close(errchan) + }() + + select { + case <-time.After(5 * time.Second): + c.Fatal("Waiting on start a container timed out") + case err := <-errchan: + if err != nil { + c.Fatal(err) + } + } +} + +func (s *DockerDaemonSuite) TestDaemonRestartRmVolumeInUse(c *check.C) { + c.Assert(s.d.StartWithBusybox(), check.IsNil) + + out, err := s.d.Cmd("create", "-v", "test:/foo", "busybox") + c.Assert(err, check.IsNil, check.Commentf(out)) + + c.Assert(s.d.Restart(), check.IsNil) + + out, err = s.d.Cmd("volume", "rm", "test") + c.Assert(err, check.Not(check.IsNil), check.Commentf("should not be able to remove in use volume after daemon restart")) + c.Assert(strings.Contains(out, "in use"), check.Equals, true) +} + +func (s *DockerDaemonSuite) TestDaemonRestartLocalVolumes(c *check.C) { + c.Assert(s.d.Start(), check.IsNil) + + _, err := s.d.Cmd("volume", "create", "--name", "test") + c.Assert(err, check.IsNil) + c.Assert(s.d.Restart(), check.IsNil) + + _, err = s.d.Cmd("volume", "inspect", "test") + c.Assert(err, check.IsNil) +} + +func (s *DockerDaemonSuite) TestDaemonCorruptedLogDriverAddress(c *check.C) { + for _, driver := range []string{ + "syslog", + "gelf", + } { + args := []string{"--log-driver=" + driver, "--log-opt", driver + "-address=corrupted:42"} + c.Assert(s.d.Start(args...), check.NotNil, check.Commentf(fmt.Sprintf("Expected daemon not to start with invalid %s-address provided", driver))) + expected := fmt.Sprintf("Failed to set log opts: %s-address should be in form proto://address", driver) + runCmd := exec.Command("grep", expected, s.d.LogfileName()) + if out, _, err := runCommandWithOutput(runCmd); err != nil { + c.Fatalf("Expected %q message; but doesn't exist in log: %q, err: %v", expected, out, err) + } + } +} + +func (s *DockerDaemonSuite) TestDaemonCorruptedFluentdAddress(c *check.C) { + c.Assert(s.d.Start("--log-driver=fluentd", "--log-opt", "fluentd-address=corrupted:c"), check.NotNil) + expected := "Failed to set log opts: invalid fluentd-address corrupted:c: " + runCmd := exec.Command("grep", expected, s.d.LogfileName()) + if out, _, err := runCommandWithOutput(runCmd); err != nil { + c.Fatalf("Expected %q message; but doesn't exist in log: %q, err: %v", expected, out, err) + } +} + +func (s *DockerDaemonSuite) TestDaemonStartWithoutHost(c *check.C) { + s.d.useDefaultHost = true + defer func() { + s.d.useDefaultHost = false + }() + c.Assert(s.d.Start(), check.IsNil) +} + +func (s *DockerDaemonSuite) TestDaemonStartWithDefalutTlsHost(c *check.C) { + s.d.useDefaultTLSHost = true + defer func() { + s.d.useDefaultTLSHost = false + }() + if err := s.d.Start( + "--tlsverify", + "--tlscacert", "fixtures/https/ca.pem", + "--tlscert", "fixtures/https/server-cert.pem", + "--tlskey", "fixtures/https/server-key.pem"); err != nil { + c.Fatalf("Could not start daemon: %v", err) + } + + // The client with --tlsverify should also use default host localhost:2376 + tmpHost := os.Getenv("DOCKER_HOST") + defer func() { + os.Setenv("DOCKER_HOST", tmpHost) + }() + + os.Setenv("DOCKER_HOST", "") + + out, _ := dockerCmd( + c, + "--tlsverify", + "--tlscacert", "fixtures/https/ca.pem", + "--tlscert", "fixtures/https/client-cert.pem", + "--tlskey", "fixtures/https/client-key.pem", + "version", + ) + if !strings.Contains(out, "Server") { + c.Fatalf("docker version should return information of server side") + } +} diff --git a/integration-cli/docker_cli_diff_test.go b/integration-cli/docker_cli_diff_test.go new file mode 100644 index 0000000000..42f1d89fb1 --- /dev/null +++ b/integration-cli/docker_cli_diff_test.go @@ -0,0 +1,92 @@ +package main + +import ( + "strings" + + "github.com/go-check/check" +) + +// ensure that an added file shows up in docker diff +func (s *DockerSuite) TestDiffFilenameShownInOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + containerCmd := `echo foo > /root/bar` + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", containerCmd) + + cleanCID := strings.TrimSpace(out) + out, _ = dockerCmd(c, "diff", cleanCID) + + found := false + for _, line := range strings.Split(out, "\n") { + if strings.Contains("A /root/bar", line) { + found = true + break + } + } + if !found { + c.Errorf("couldn't find the new file in docker diff's output: %v", out) + } +} + +// test to ensure GH #3840 doesn't occur any more +func (s *DockerSuite) TestDiffEnsureDockerinitFilesAreIgnored(c *check.C) { + testRequires(c, DaemonIsLinux) + // this is a list of files which shouldn't show up in `docker diff` + dockerinitFiles := []string{"/etc/resolv.conf", "/etc/hostname", "/etc/hosts", "/.dockerinit", "/.dockerenv"} + containerCount := 5 + + // we might not run into this problem from the first run, so start a few containers + for i := 0; i < containerCount; i++ { + containerCmd := `echo foo > /root/bar` + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", containerCmd) + + cleanCID := strings.TrimSpace(out) + out, _ = dockerCmd(c, "diff", cleanCID) + + for _, filename := range dockerinitFiles { + if strings.Contains(out, filename) { + c.Errorf("found file which should've been ignored %v in diff output", filename) + } + } + } +} + +func (s *DockerSuite) TestDiffEnsureOnlyKmsgAndPtmx(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "sleep", "0") + + cleanCID := strings.TrimSpace(out) + out, _ = dockerCmd(c, "diff", cleanCID) + + expected := map[string]bool{ + "C /dev": true, + "A /dev/full": true, // busybox + "C /dev/ptmx": true, // libcontainer + "A /dev/mqueue": true, // lxc + "A /dev/kmsg": true, // lxc + "A /dev/fd": true, + "A /dev/fuse": true, + "A /dev/ptmx": true, + "A /dev/null": true, + "A /dev/random": true, + "A /dev/stdout": true, + "A /dev/stderr": true, + "A /dev/tty1": true, + "A /dev/stdin": true, + "A /dev/tty": true, + "A /dev/urandom": true, + "A /dev/zero": true, + } + + for _, line := range strings.Split(out, "\n") { + if line != "" && !expected[line] { + c.Errorf("%q is shown in the diff but shouldn't", line) + } + } +} + +// https://github.com/docker/docker/pull/14381#discussion_r33859347 +func (s *DockerSuite) TestDiffEmptyArgClientError(c *check.C) { + out, _, err := dockerCmdWithError("diff", "") + c.Assert(err, check.NotNil) + c.Assert(strings.TrimSpace(out), check.Equals, "Container name cannot be empty") +} diff --git a/integration-cli/docker_cli_events_test.go b/integration-cli/docker_cli_events_test.go new file mode 100644 index 0000000000..8d700b38cd --- /dev/null +++ b/integration-cli/docker_cli_events_test.go @@ -0,0 +1,748 @@ +package main + +import ( + "bufio" + "fmt" + "io/ioutil" + "net/http" + "os" + "os/exec" + "regexp" + "strconv" + "strings" + "sync" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestEventsTimestampFormats(c *check.C) { + testRequires(c, DaemonIsLinux) + image := "busybox" + + // Start stopwatch, generate an event + time.Sleep(1 * time.Second) // so that we don't grab events from previous test occured in the same second + start := daemonTime(c) + dockerCmd(c, "tag", image, "timestamptest:1") + dockerCmd(c, "rmi", "timestamptest:1") + time.Sleep(1 * time.Second) // so that until > since + end := daemonTime(c) + + // List of available time formats to --since + unixTs := func(t time.Time) string { return fmt.Sprintf("%v", t.Unix()) } + rfc3339 := func(t time.Time) string { return t.Format(time.RFC3339) } + duration := func(t time.Time) string { return time.Now().Sub(t).String() } + + // --since=$start must contain only the 'untag' event + for _, f := range []func(time.Time) string{unixTs, rfc3339, duration} { + since, until := f(start), f(end) + out, _ := dockerCmd(c, "events", "--since="+since, "--until="+until) + events := strings.Split(strings.TrimSpace(out), "\n") + if len(events) != 2 { + c.Fatalf("unexpected events, was expecting only 2 events tag/untag (since=%s, until=%s) out=%s", since, until, out) + } + if !strings.Contains(out, "untag") { + c.Fatalf("expected 'untag' event not found (since=%s, until=%s) out=%s", since, until, out) + } + } + +} + +func (s *DockerSuite) TestEventsUntag(c *check.C) { + testRequires(c, DaemonIsLinux) + image := "busybox" + dockerCmd(c, "tag", image, "utest:tag1") + dockerCmd(c, "tag", image, "utest:tag2") + dockerCmd(c, "rmi", "utest:tag1") + dockerCmd(c, "rmi", "utest:tag2") + eventsCmd := exec.Command(dockerBinary, "events", "--since=1") + out, exitCode, _, err := runCommandWithOutputForDuration(eventsCmd, time.Duration(time.Millisecond*200)) + if exitCode != 0 || err != nil { + c.Fatalf("Failed to get events - exit code %d: %s", exitCode, err) + } + events := strings.Split(out, "\n") + nEvents := len(events) + // The last element after the split above will be an empty string, so we + // get the two elements before the last, which are the untags we're + // looking for. + for _, v := range events[nEvents-3 : nEvents-1] { + if !strings.Contains(v, "untag") { + c.Fatalf("event should be untag, not %#v", v) + } + } +} + +func (s *DockerSuite) TestEventsContainerFailStartDie(c *check.C) { + + out, _ := dockerCmd(c, "images", "-q") + image := strings.Split(out, "\n")[0] + if _, _, err := dockerCmdWithError("run", "--name", "testeventdie", image, "blerg"); err == nil { + c.Fatalf("Container run with command blerg should have failed, but it did not") + } + + out, _ = dockerCmd(c, "events", "--since=0", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + if len(events) <= 1 { + c.Fatalf("Missing expected event") + } + + startEvent := strings.Fields(events[len(events)-3]) + dieEvent := strings.Fields(events[len(events)-2]) + + if startEvent[len(startEvent)-1] != "start" { + c.Fatalf("event should be start, not %#v", startEvent) + } + if dieEvent[len(dieEvent)-1] != "die" { + c.Fatalf("event should be die, not %#v", dieEvent) + } + +} + +func (s *DockerSuite) TestEventsLimit(c *check.C) { + testRequires(c, DaemonIsLinux) + var waitGroup sync.WaitGroup + errChan := make(chan error, 17) + + args := []string{"run", "--rm", "busybox", "true"} + for i := 0; i < 17; i++ { + waitGroup.Add(1) + go func() { + defer waitGroup.Done() + errChan <- exec.Command(dockerBinary, args...).Run() + }() + } + + waitGroup.Wait() + close(errChan) + + for err := range errChan { + if err != nil { + c.Fatalf("%q failed with error: %v", strings.Join(args, " "), err) + } + } + + out, _ := dockerCmd(c, "events", "--since=0", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + nEvents := len(events) - 1 + if nEvents != 64 { + c.Fatalf("events should be limited to 64, but received %d", nEvents) + } +} + +func (s *DockerSuite) TestEventsContainerEvents(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--rm", "busybox", "true") + out, _ := dockerCmd(c, "events", "--since=0", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + events = events[:len(events)-1] + if len(events) < 5 { + c.Fatalf("Missing expected event") + } + createEvent := strings.Fields(events[len(events)-5]) + attachEvent := strings.Fields(events[len(events)-4]) + startEvent := strings.Fields(events[len(events)-3]) + dieEvent := strings.Fields(events[len(events)-2]) + destroyEvent := strings.Fields(events[len(events)-1]) + if createEvent[len(createEvent)-1] != "create" { + c.Fatalf("event should be create, not %#v", createEvent) + } + if attachEvent[len(attachEvent)-1] != "attach" { + c.Fatalf("event should be attach, not %#v", attachEvent) + } + if startEvent[len(startEvent)-1] != "start" { + c.Fatalf("event should be start, not %#v", startEvent) + } + if dieEvent[len(dieEvent)-1] != "die" { + c.Fatalf("event should be die, not %#v", dieEvent) + } + if destroyEvent[len(destroyEvent)-1] != "destroy" { + c.Fatalf("event should be destroy, not %#v", destroyEvent) + } + +} + +func (s *DockerSuite) TestEventsContainerEventsSinceUnixEpoch(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--rm", "busybox", "true") + timeBeginning := time.Unix(0, 0).Format(time.RFC3339Nano) + timeBeginning = strings.Replace(timeBeginning, "Z", ".000000000Z", -1) + out, _ := dockerCmd(c, "events", fmt.Sprintf("--since='%s'", timeBeginning), + fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + events = events[:len(events)-1] + if len(events) < 5 { + c.Fatalf("Missing expected event") + } + createEvent := strings.Fields(events[len(events)-5]) + attachEvent := strings.Fields(events[len(events)-4]) + startEvent := strings.Fields(events[len(events)-3]) + dieEvent := strings.Fields(events[len(events)-2]) + destroyEvent := strings.Fields(events[len(events)-1]) + if createEvent[len(createEvent)-1] != "create" { + c.Fatalf("event should be create, not %#v", createEvent) + } + if attachEvent[len(attachEvent)-1] != "attach" { + c.Fatalf("event should be attach, not %#v", attachEvent) + } + if startEvent[len(startEvent)-1] != "start" { + c.Fatalf("event should be start, not %#v", startEvent) + } + if dieEvent[len(dieEvent)-1] != "die" { + c.Fatalf("event should be die, not %#v", dieEvent) + } + if destroyEvent[len(destroyEvent)-1] != "destroy" { + c.Fatalf("event should be destroy, not %#v", destroyEvent) + } + +} + +func (s *DockerSuite) TestEventsImageUntagDelete(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testimageevents" + _, err := buildImage(name, + `FROM scratch + MAINTAINER "docker"`, + true) + if err != nil { + c.Fatal(err) + } + if err := deleteImages(name); err != nil { + c.Fatal(err) + } + out, _ := dockerCmd(c, "events", "--since=0", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + + events = events[:len(events)-1] + if len(events) < 2 { + c.Fatalf("Missing expected event") + } + untagEvent := strings.Fields(events[len(events)-2]) + deleteEvent := strings.Fields(events[len(events)-1]) + if untagEvent[len(untagEvent)-1] != "untag" { + c.Fatalf("untag should be untag, not %#v", untagEvent) + } + if deleteEvent[len(deleteEvent)-1] != "delete" { + c.Fatalf("delete should be delete, not %#v", deleteEvent) + } +} + +func (s *DockerSuite) TestEventsImageTag(c *check.C) { + testRequires(c, DaemonIsLinux) + time.Sleep(1 * time.Second) // because API has seconds granularity + since := daemonTime(c).Unix() + image := "testimageevents:tag" + dockerCmd(c, "tag", "busybox", image) + + out, _ := dockerCmd(c, "events", + fmt.Sprintf("--since=%d", since), + fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + + events := strings.Split(strings.TrimSpace(out), "\n") + if len(events) != 1 { + c.Fatalf("was expecting 1 event. out=%s", out) + } + event := strings.TrimSpace(events[0]) + expectedStr := image + ": tag" + + if !strings.HasSuffix(event, expectedStr) { + c.Fatalf("wrong event format. expected='%s' got=%s", expectedStr, event) + } + +} + +func (s *DockerSuite) TestEventsImagePull(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + testRequires(c, Network) + + dockerCmd(c, "pull", "hello-world") + + out, _ := dockerCmd(c, "events", + fmt.Sprintf("--since=%d", since), + fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + + events := strings.Split(strings.TrimSpace(out), "\n") + event := strings.TrimSpace(events[len(events)-1]) + + if !strings.HasSuffix(event, "hello-world:latest: pull") { + c.Fatalf("Missing pull event - got:%q", event) + } + +} + +func (s *DockerSuite) TestEventsImageImport(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + id := make(chan string) + eventImport := make(chan struct{}) + eventsCmd := exec.Command(dockerBinary, "events", "--since", strconv.FormatInt(since, 10)) + stdout, err := eventsCmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + if err := eventsCmd.Start(); err != nil { + c.Fatal(err) + } + defer eventsCmd.Process.Kill() + + go func() { + containerID := <-id + + matchImport := regexp.MustCompile(containerID + `: import$`) + scanner := bufio.NewScanner(stdout) + for scanner.Scan() { + if matchImport.MatchString(scanner.Text()) { + close(eventImport) + } + } + }() + + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + cleanedContainerID := strings.TrimSpace(out) + + out, _, err = runCommandPipelineWithOutput( + exec.Command(dockerBinary, "export", cleanedContainerID), + exec.Command(dockerBinary, "import", "-"), + ) + if err != nil { + c.Errorf("import failed with errors: %v, output: %q", err, out) + } + newContainerID := strings.TrimSpace(out) + id <- newContainerID + + select { + case <-time.After(5 * time.Second): + c.Fatal("failed to observe image import in timely fashion") + case <-eventImport: + // ignore, done + } +} + +func (s *DockerSuite) TestEventsFilters(c *check.C) { + testRequires(c, DaemonIsLinux) + parseEvents := func(out, match string) { + events := strings.Split(out, "\n") + events = events[:len(events)-1] + for _, event := range events { + eventFields := strings.Fields(event) + eventName := eventFields[len(eventFields)-1] + if ok, err := regexp.MatchString(match, eventName); err != nil || !ok { + c.Fatalf("event should match %s, got %#v, err: %v", match, eventFields, err) + } + } + } + + since := daemonTime(c).Unix() + dockerCmd(c, "run", "--rm", "busybox", "true") + dockerCmd(c, "run", "--rm", "busybox", "true") + out, _ := dockerCmd(c, "events", fmt.Sprintf("--since=%d", since), fmt.Sprintf("--until=%d", daemonTime(c).Unix()), "--filter", "event=die") + parseEvents(out, "die") + + out, _ = dockerCmd(c, "events", fmt.Sprintf("--since=%d", since), fmt.Sprintf("--until=%d", daemonTime(c).Unix()), "--filter", "event=die", "--filter", "event=start") + parseEvents(out, "((die)|(start))") + + // make sure we at least got 2 start events + count := strings.Count(out, "start") + if count < 2 { + c.Fatalf("should have had 2 start events but had %d, out: %s", count, out) + } + +} + +func (s *DockerSuite) TestEventsFilterImageName(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + out, _ := dockerCmd(c, "run", "--name", "container_1", "-d", "busybox:latest", "true") + container1 := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "--name", "container_2", "-d", "busybox", "true") + container2 := strings.TrimSpace(out) + + name := "busybox" + out, _ = dockerCmd(c, "events", fmt.Sprintf("--since=%d", since), fmt.Sprintf("--until=%d", daemonTime(c).Unix()), "--filter", fmt.Sprintf("image=%s", name)) + events := strings.Split(out, "\n") + events = events[:len(events)-1] + if len(events) == 0 { + c.Fatalf("Expected events but found none for the image busybox:latest") + } + count1 := 0 + count2 := 0 + + for _, e := range events { + if strings.Contains(e, container1) { + count1++ + } else if strings.Contains(e, container2) { + count2++ + } + } + if count1 == 0 || count2 == 0 { + c.Fatalf("Expected events from each container but got %d from %s and %d from %s", count1, container1, count2, container2) + } + +} + +func (s *DockerSuite) TestEventsFilterLabels(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + label := "io.docker.testing=foo" + + out, _ := dockerCmd(c, "run", "-d", "-l", label, "busybox:latest", "true") + container1 := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "-d", "busybox", "true") + container2 := strings.TrimSpace(out) + + out, _ = dockerCmd( + c, + "events", + fmt.Sprintf("--since=%d", since), + fmt.Sprintf("--until=%d", daemonTime(c).Unix()), + "--filter", fmt.Sprintf("label=%s", label)) + + events := strings.Split(strings.TrimSpace(out), "\n") + c.Assert(len(events), checker.Equals, 3) + + for _, e := range events { + c.Assert(e, checker.Contains, container1) + c.Assert(e, check.Not(checker.Contains), container2) + } +} + +func (s *DockerSuite) TestEventsFilterImageLabels(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + name := "labelfilterimage" + label := "io.docker.testing=image" + + // Build a test image. + _, err := buildImage(name, ` + FROM busybox:latest + LABEL io.docker.testing=image`, true) + if err != nil { + c.Fatalf("Couldn't create image: %q", err) + } + + dockerCmd(c, "tag", name, "labelfiltertest:tag1") + dockerCmd(c, "tag", name, "labelfiltertest:tag2") + dockerCmd(c, "tag", "busybox:latest", "labelfiltertest:tag3") + + out, _ := dockerCmd( + c, + "events", + fmt.Sprintf("--since=%d", since), + fmt.Sprintf("--until=%d", daemonTime(c).Unix()), + "--filter", fmt.Sprintf("label=%s", label)) + + events := strings.Split(strings.TrimSpace(out), "\n") + c.Assert(len(events), checker.Equals, 2, check.Commentf("Events == %s", events)) + for _, e := range events { + c.Assert(e, checker.Contains, "labelfiltertest") + } +} + +func (s *DockerSuite) TestEventsFilterContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + since := fmt.Sprintf("%d", daemonTime(c).Unix()) + nameID := make(map[string]string) + + for _, name := range []string{"container_1", "container_2"} { + dockerCmd(c, "run", "--name", name, "busybox", "true") + id, err := inspectField(name, "Id") + if err != nil { + c.Fatal(err) + } + nameID[name] = id + } + + until := fmt.Sprintf("%d", daemonTime(c).Unix()) + + checkEvents := func(id string, events []string) error { + if len(events) != 4 { // create, attach, start, die + return fmt.Errorf("expected 4 events, got %v", events) + } + for _, event := range events { + e := strings.Fields(event) + if len(e) < 3 { + return fmt.Errorf("got malformed event: %s", event) + } + + // Check the id + parsedID := strings.TrimSuffix(e[1], ":") + if parsedID != id { + return fmt.Errorf("expected event for container id %s: %s - parsed container id: %s", id, event, parsedID) + } + } + return nil + } + + for name, ID := range nameID { + // filter by names + out, _ := dockerCmd(c, "events", "--since", since, "--until", until, "--filter", "container="+name) + events := strings.Split(strings.TrimSuffix(out, "\n"), "\n") + if err := checkEvents(ID, events); err != nil { + c.Fatal(err) + } + + // filter by ID's + out, _ = dockerCmd(c, "events", "--since", since, "--until", until, "--filter", "container="+ID) + events = strings.Split(strings.TrimSuffix(out, "\n"), "\n") + if err := checkEvents(ID, events); err != nil { + c.Fatal(err) + } + } +} + +func (s *DockerSuite) TestEventsStreaming(c *check.C) { + testRequires(c, DaemonIsLinux) + start := daemonTime(c).Unix() + + id := make(chan string) + eventCreate := make(chan struct{}) + eventStart := make(chan struct{}) + eventDie := make(chan struct{}) + eventDestroy := make(chan struct{}) + + eventsCmd := exec.Command(dockerBinary, "events", "--since", strconv.FormatInt(start, 10)) + stdout, err := eventsCmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + if err := eventsCmd.Start(); err != nil { + c.Fatalf("failed to start 'docker events': %s", err) + } + defer eventsCmd.Process.Kill() + + go func() { + containerID := <-id + + matchCreate := regexp.MustCompile(containerID + `: \(from busybox:latest\) create$`) + matchStart := regexp.MustCompile(containerID + `: \(from busybox:latest\) start$`) + matchDie := regexp.MustCompile(containerID + `: \(from busybox:latest\) die$`) + matchDestroy := regexp.MustCompile(containerID + `: \(from busybox:latest\) destroy$`) + + scanner := bufio.NewScanner(stdout) + for scanner.Scan() { + switch { + case matchCreate.MatchString(scanner.Text()): + close(eventCreate) + case matchStart.MatchString(scanner.Text()): + close(eventStart) + case matchDie.MatchString(scanner.Text()): + close(eventDie) + case matchDestroy.MatchString(scanner.Text()): + close(eventDestroy) + } + } + }() + + out, _ := dockerCmd(c, "run", "-d", "busybox:latest", "true") + cleanedContainerID := strings.TrimSpace(out) + id <- cleanedContainerID + + select { + case <-time.After(5 * time.Second): + c.Fatal("failed to observe container create in timely fashion") + case <-eventCreate: + // ignore, done + } + + select { + case <-time.After(5 * time.Second): + c.Fatal("failed to observe container start in timely fashion") + case <-eventStart: + // ignore, done + } + + select { + case <-time.After(5 * time.Second): + c.Fatal("failed to observe container die in timely fashion") + case <-eventDie: + // ignore, done + } + + dockerCmd(c, "rm", cleanedContainerID) + + select { + case <-time.After(5 * time.Second): + c.Fatal("failed to observe container destroy in timely fashion") + case <-eventDestroy: + // ignore, done + } +} + +func (s *DockerSuite) TestEventsCommit(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cID := strings.TrimSpace(out) + c.Assert(waitRun(cID), check.IsNil) + + dockerCmd(c, "commit", "-m", "test", cID) + dockerCmd(c, "stop", cID) + + out, _ = dockerCmd(c, "events", "--since=0", "-f", "container="+cID, "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " commit\n") { + c.Fatalf("Missing 'commit' log event\n%s", out) + } +} + +func (s *DockerSuite) TestEventsCopy(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + // Build a test image. + id, err := buildImage("cpimg", ` + FROM busybox + RUN echo HI > /tmp/file`, true) + if err != nil { + c.Fatalf("Couldn't create image: %q", err) + } + + // Create an empty test file. + tempFile, err := ioutil.TempFile("", "test-events-copy-") + if err != nil { + c.Fatal(err) + } + defer os.Remove(tempFile.Name()) + + if err := tempFile.Close(); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "create", "--name=cptest", id) + + dockerCmd(c, "cp", "cptest:/tmp/file", tempFile.Name()) + + out, _ := dockerCmd(c, "events", "--since=0", "-f", "container=cptest", "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " archive-path\n") { + c.Fatalf("Missing 'archive-path' log event\n%s", out) + } + + dockerCmd(c, "cp", tempFile.Name(), "cptest:/tmp/filecopy") + + out, _ = dockerCmd(c, "events", "--since=0", "-f", "container=cptest", "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " extract-to-dir\n") { + c.Fatalf("Missing 'extract-to-dir' log event\n%s", out) + } +} + +func (s *DockerSuite) TestEventsResize(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cID := strings.TrimSpace(out) + c.Assert(waitRun(cID), check.IsNil) + + endpoint := "/containers/" + cID + "/resize?h=80&w=24" + status, _, err := sockRequest("POST", endpoint, nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + dockerCmd(c, "stop", cID) + + out, _ = dockerCmd(c, "events", "--since=0", "-f", "container="+cID, "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " resize\n") { + c.Fatalf("Missing 'resize' log event\n%s", out) + } +} + +func (s *DockerSuite) TestEventsAttach(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + out, _ := dockerCmd(c, "run", "-di", "busybox", "/bin/cat") + cID := strings.TrimSpace(out) + + cmd := exec.Command(dockerBinary, "attach", cID) + stdin, err := cmd.StdinPipe() + c.Assert(err, check.IsNil) + defer stdin.Close() + stdout, err := cmd.StdoutPipe() + c.Assert(err, check.IsNil) + defer stdout.Close() + c.Assert(cmd.Start(), check.IsNil) + defer cmd.Process.Kill() + + // Make sure we're done attaching by writing/reading some stuff + if _, err := stdin.Write([]byte("hello\n")); err != nil { + c.Fatal(err) + } + out, err = bufio.NewReader(stdout).ReadString('\n') + c.Assert(err, check.IsNil) + if strings.TrimSpace(out) != "hello" { + c.Fatalf("expected 'hello', got %q", out) + } + + c.Assert(stdin.Close(), check.IsNil) + + dockerCmd(c, "stop", cID) + + out, _ = dockerCmd(c, "events", "--since=0", "-f", "container="+cID, "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " attach\n") { + c.Fatalf("Missing 'attach' log event\n%s", out) + } +} + +func (s *DockerSuite) TestEventsRename(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + dockerCmd(c, "run", "--name", "oldName", "busybox", "true") + dockerCmd(c, "rename", "oldName", "newName") + + out, _ := dockerCmd(c, "events", "--since=0", "-f", "container=newName", "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " rename\n") { + c.Fatalf("Missing 'rename' log event\n%s", out) + } +} + +func (s *DockerSuite) TestEventsTop(c *check.C) { + testRequires(c, DaemonIsLinux) + since := daemonTime(c).Unix() + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cID := strings.TrimSpace(out) + c.Assert(waitRun(cID), check.IsNil) + + dockerCmd(c, "top", cID) + dockerCmd(c, "stop", cID) + + out, _ = dockerCmd(c, "events", "--since=0", "-f", "container="+cID, "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, " top\n") { + c.Fatalf("Missing 'top' log event\n%s", out) + } +} + +// #13753 +func (s *DockerSuite) TestEventsDefaultEmpty(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "busybox") + out, _ := dockerCmd(c, "events", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + c.Assert(strings.TrimSpace(out), check.Equals, "") +} + +// #14316 +func (s *DockerRegistrySuite) TestEventsImageFilterPush(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, Network) + since := daemonTime(c).Unix() + repoName := fmt.Sprintf("%v/dockercli/testf", privateRegistryURL) + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cID := strings.TrimSpace(out) + c.Assert(waitRun(cID), check.IsNil) + + dockerCmd(c, "commit", cID, repoName) + dockerCmd(c, "stop", cID) + dockerCmd(c, "push", repoName) + + out, _ = dockerCmd(c, "events", "--since=0", "-f", "image="+repoName, "-f", "event=push", "--until="+strconv.Itoa(int(since))) + if !strings.Contains(out, repoName+": push\n") { + c.Fatalf("Missing 'push' log event for image %s\n%s", repoName, out) + } +} diff --git a/integration-cli/docker_cli_events_unix_test.go b/integration-cli/docker_cli_events_unix_test.go new file mode 100644 index 0000000000..9115809b87 --- /dev/null +++ b/integration-cli/docker_cli_events_unix_test.go @@ -0,0 +1,153 @@ +// +build !windows + +package main + +import ( + "bufio" + "fmt" + "io/ioutil" + "os" + "os/exec" + "strings" + "time" + "unicode" + + "github.com/go-check/check" + "github.com/kr/pty" +) + +// #5979 +func (s *DockerSuite) TestEventsRedirectStdout(c *check.C) { + since := daemonTime(c).Unix() + dockerCmd(c, "run", "busybox", "true") + + file, err := ioutil.TempFile("", "") + if err != nil { + c.Fatalf("could not create temp file: %v", err) + } + defer os.Remove(file.Name()) + + command := fmt.Sprintf("%s events --since=%d --until=%d > %s", dockerBinary, since, daemonTime(c).Unix(), file.Name()) + _, tty, err := pty.Open() + if err != nil { + c.Fatalf("Could not open pty: %v", err) + } + cmd := exec.Command("sh", "-c", command) + cmd.Stdin = tty + cmd.Stdout = tty + cmd.Stderr = tty + if err := cmd.Run(); err != nil { + c.Fatalf("run err for command %q: %v", command, err) + } + + scanner := bufio.NewScanner(file) + for scanner.Scan() { + for _, ch := range scanner.Text() { + if unicode.IsControl(ch) { + c.Fatalf("found control character %v", []byte(string(ch))) + } + } + } + if err := scanner.Err(); err != nil { + c.Fatalf("Scan err for command %q: %v", command, err) + } + +} + +func (s *DockerSuite) TestEventsOOMDisableFalse(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver) + testRequires(c, oomControl) + + errChan := make(chan error) + go func() { + defer close(errChan) + out, exitCode, _ := dockerCmdWithError("run", "--name", "oomFalse", "-m", "10MB", "busybox", "sh", "-c", "x=a; while true; do x=$x$x$x$x; done") + if expected := 137; exitCode != expected { + errChan <- fmt.Errorf("wrong exit code for OOM container: expected %d, got %d (output: %q)", expected, exitCode, out) + } + }() + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(30 * time.Second): + c.Fatal("Timeout waiting for container to die on OOM") + } + + out, _ := dockerCmd(c, "events", "--since=0", "-f", "container=oomFalse", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(strings.TrimSuffix(out, "\n"), "\n") + if len(events) < 5 { + c.Fatalf("Missing expected event") + } + + createEvent := strings.Fields(events[len(events)-5]) + attachEvent := strings.Fields(events[len(events)-4]) + startEvent := strings.Fields(events[len(events)-3]) + oomEvent := strings.Fields(events[len(events)-2]) + dieEvent := strings.Fields(events[len(events)-1]) + if createEvent[len(createEvent)-1] != "create" { + c.Fatalf("event should be create, not %#v", createEvent) + } + if attachEvent[len(attachEvent)-1] != "attach" { + c.Fatalf("event should be attach, not %#v", attachEvent) + } + if startEvent[len(startEvent)-1] != "start" { + c.Fatalf("event should be start, not %#v", startEvent) + } + if oomEvent[len(oomEvent)-1] != "oom" { + c.Fatalf("event should be oom, not %#v", oomEvent) + } + if dieEvent[len(dieEvent)-1] != "die" { + c.Fatalf("event should be die, not %#v", dieEvent) + } +} + +func (s *DockerSuite) TestEventsOOMDisableTrue(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver) + testRequires(c, oomControl) + + errChan := make(chan error) + go func() { + defer close(errChan) + out, exitCode, _ := dockerCmdWithError("run", "--oom-kill-disable=true", "--name", "oomTrue", "-m", "10MB", "busybox", "sh", "-c", "x=a; while true; do x=$x$x$x$x; done") + if expected := 137; exitCode != expected { + errChan <- fmt.Errorf("wrong exit code for OOM container: expected %d, got %d (output: %q)", expected, exitCode, out) + } + }() + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(20 * time.Second): + defer dockerCmd(c, "kill", "oomTrue") + + out, _ := dockerCmd(c, "events", "--since=0", "-f", "container=oomTrue", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(strings.TrimSuffix(out, "\n"), "\n") + if len(events) < 4 { + c.Fatalf("Missing expected event") + } + + createEvent := strings.Fields(events[len(events)-4]) + attachEvent := strings.Fields(events[len(events)-3]) + startEvent := strings.Fields(events[len(events)-2]) + oomEvent := strings.Fields(events[len(events)-1]) + + if createEvent[len(createEvent)-1] != "create" { + c.Fatalf("event should be create, not %#v", createEvent) + } + if attachEvent[len(attachEvent)-1] != "attach" { + c.Fatalf("event should be attach, not %#v", attachEvent) + } + if startEvent[len(startEvent)-1] != "start" { + c.Fatalf("event should be start, not %#v", startEvent) + } + if oomEvent[len(oomEvent)-1] != "oom" { + c.Fatalf("event should be oom, not %#v", oomEvent) + } + + out, _ = dockerCmd(c, "inspect", "-f", "{{.State.Status}}", "oomTrue") + if strings.TrimSpace(out) != "running" { + c.Fatalf("container should be still running, not %v", out) + } + } +} diff --git a/integration-cli/docker_cli_exec_test.go b/integration-cli/docker_cli_exec_test.go new file mode 100644 index 0000000000..bb79384539 --- /dev/null +++ b/integration-cli/docker_cli_exec_test.go @@ -0,0 +1,627 @@ +// +build !test_no_exec + +package main + +import ( + "bufio" + "fmt" + "net/http" + "os" + "os/exec" + "path/filepath" + "reflect" + "sort" + "strings" + "sync" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestExec(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "testing", "busybox", "sh", "-c", "echo test > /tmp/file && top") + + out, _ := dockerCmd(c, "exec", "testing", "cat", "/tmp/file") + out = strings.Trim(out, "\r\n") + if out != "test" { + c.Errorf("container exec should've printed test but printed %q", out) + } + +} + +func (s *DockerSuite) TestExecInteractive(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "testing", "busybox", "sh", "-c", "echo test > /tmp/file && top") + + execCmd := exec.Command(dockerBinary, "exec", "-i", "testing", "sh") + stdin, err := execCmd.StdinPipe() + if err != nil { + c.Fatal(err) + } + stdout, err := execCmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + + if err := execCmd.Start(); err != nil { + c.Fatal(err) + } + if _, err := stdin.Write([]byte("cat /tmp/file\n")); err != nil { + c.Fatal(err) + } + + r := bufio.NewReader(stdout) + line, err := r.ReadString('\n') + if err != nil { + c.Fatal(err) + } + line = strings.TrimSpace(line) + if line != "test" { + c.Fatalf("Output should be 'test', got '%q'", line) + } + if err := stdin.Close(); err != nil { + c.Fatal(err) + } + errChan := make(chan error) + go func() { + errChan <- execCmd.Wait() + close(errChan) + }() + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(1 * time.Second): + c.Fatal("docker exec failed to exit on stdin close") + } + +} + +func (s *DockerSuite) TestExecAfterContainerRestart(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "restart", cleanedContainerID) + + out, _ = dockerCmd(c, "exec", cleanedContainerID, "echo", "hello") + outStr := strings.TrimSpace(out) + if outStr != "hello" { + c.Errorf("container should've printed hello, instead printed %q", outStr) + } +} + +func (s *DockerDaemonSuite) TestExecAfterDaemonRestart(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + if err := s.d.StartWithBusybox(); err != nil { + c.Fatalf("Could not start daemon with busybox: %v", err) + } + + if out, err := s.d.Cmd("run", "-d", "--name", "top", "-p", "80", "busybox:latest", "top"); err != nil { + c.Fatalf("Could not run top: err=%v\n%s", err, out) + } + + if err := s.d.Restart(); err != nil { + c.Fatalf("Could not restart daemon: %v", err) + } + + if out, err := s.d.Cmd("start", "top"); err != nil { + c.Fatalf("Could not start top after daemon restart: err=%v\n%s", err, out) + } + + out, err := s.d.Cmd("exec", "top", "echo", "hello") + if err != nil { + c.Fatalf("Could not exec on container top: err=%v\n%s", err, out) + } + + outStr := strings.TrimSpace(string(out)) + if outStr != "hello" { + c.Errorf("container should've printed hello, instead printed %q", outStr) + } +} + +// Regression test for #9155, #9044 +func (s *DockerSuite) TestExecEnv(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-e", "LALA=value1", "-e", "LALA=value2", + "-d", "--name", "testing", "busybox", "top") + + out, _ := dockerCmd(c, "exec", "testing", "env") + if strings.Contains(out, "LALA=value1") || + !strings.Contains(out, "LALA=value2") || + !strings.Contains(out, "HOME=/root") { + c.Errorf("exec env(%q), expect %q, %q", out, "LALA=value2", "HOME=/root") + } +} + +func (s *DockerSuite) TestExecExitStatus(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "top", "busybox", "top") + + // Test normal (non-detached) case first + cmd := exec.Command(dockerBinary, "exec", "top", "sh", "-c", "exit 23") + ec, _ := runCommand(cmd) + if ec != 23 { + c.Fatalf("Should have had an ExitCode of 23, not: %d", ec) + } +} + +func (s *DockerSuite) TestExecPausedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + defer unpauseAllContainers() + + out, _ := dockerCmd(c, "run", "-d", "--name", "testing", "busybox", "top") + ContainerID := strings.TrimSpace(out) + + dockerCmd(c, "pause", "testing") + out, _, err := dockerCmdWithError("exec", "-i", "-t", ContainerID, "echo", "hello") + if err == nil { + c.Fatal("container should fail to exec new command if it is paused") + } + + expected := ContainerID + " is paused, unpause the container before exec" + if !strings.Contains(out, expected) { + c.Fatal("container should not exec new command if it is paused") + } +} + +// regression test for #9476 +func (s *DockerSuite) TestExecTtyCloseStdin(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "-it", "--name", "exec_tty_stdin", "busybox") + + cmd := exec.Command(dockerBinary, "exec", "-i", "exec_tty_stdin", "cat") + stdinRw, err := cmd.StdinPipe() + if err != nil { + c.Fatal(err) + } + + stdinRw.Write([]byte("test")) + stdinRw.Close() + + if out, _, err := runCommandWithOutput(cmd); err != nil { + c.Fatal(out, err) + } + + out, _ := dockerCmd(c, "top", "exec_tty_stdin") + outArr := strings.Split(out, "\n") + if len(outArr) > 3 || strings.Contains(out, "nsenter-exec") { + c.Fatalf("exec process left running\n\t %s", out) + } +} + +func (s *DockerSuite) TestExecTtyWithoutStdin(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "-ti", "busybox") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + errChan := make(chan error) + go func() { + defer close(errChan) + + cmd := exec.Command(dockerBinary, "exec", "-ti", id, "true") + if _, err := cmd.StdinPipe(); err != nil { + errChan <- err + return + } + + expected := "cannot enable tty mode" + if out, _, err := runCommandWithOutput(cmd); err == nil { + errChan <- fmt.Errorf("exec should have failed") + return + } else if !strings.Contains(out, expected) { + errChan <- fmt.Errorf("exec failed with error %q: expected %q", out, expected) + return + } + }() + + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(3 * time.Second): + c.Fatal("exec is running but should have failed") + } +} + +func (s *DockerSuite) TestExecParseError(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "top", "busybox", "top") + + // Test normal (non-detached) case first + cmd := exec.Command(dockerBinary, "exec", "top") + if _, stderr, code, err := runCommandWithStdoutStderr(cmd); err == nil || !strings.Contains(stderr, "See '"+dockerBinary+" exec --help'") || code == 0 { + c.Fatalf("Should have thrown error & point to help: %s", stderr) + } +} + +func (s *DockerSuite) TestExecStopNotHanging(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "testing", "busybox", "top") + + if err := exec.Command(dockerBinary, "exec", "testing", "top").Start(); err != nil { + c.Fatal(err) + } + + type dstop struct { + out []byte + err error + } + + ch := make(chan dstop) + go func() { + out, err := exec.Command(dockerBinary, "stop", "testing").CombinedOutput() + ch <- dstop{out, err} + close(ch) + }() + select { + case <-time.After(3 * time.Second): + c.Fatal("Container stop timed out") + case s := <-ch: + c.Assert(s.err, check.IsNil) + } +} + +func (s *DockerSuite) TestExecCgroup(c *check.C) { + testRequires(c, NotUserNamespace) + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "testing", "busybox", "top") + + out, _ := dockerCmd(c, "exec", "testing", "cat", "/proc/1/cgroup") + containerCgroups := sort.StringSlice(strings.Split(out, "\n")) + + var wg sync.WaitGroup + var mu sync.Mutex + execCgroups := []sort.StringSlice{} + errChan := make(chan error) + // exec a few times concurrently to get consistent failure + for i := 0; i < 5; i++ { + wg.Add(1) + go func() { + out, _, err := dockerCmdWithError("exec", "testing", "cat", "/proc/self/cgroup") + if err != nil { + errChan <- err + return + } + cg := sort.StringSlice(strings.Split(out, "\n")) + + mu.Lock() + execCgroups = append(execCgroups, cg) + mu.Unlock() + wg.Done() + }() + } + wg.Wait() + close(errChan) + + for err := range errChan { + c.Assert(err, check.IsNil) + } + + for _, cg := range execCgroups { + if !reflect.DeepEqual(cg, containerCgroups) { + fmt.Println("exec cgroups:") + for _, name := range cg { + fmt.Printf(" %s\n", name) + } + + fmt.Println("container cgroups:") + for _, name := range containerCgroups { + fmt.Printf(" %s\n", name) + } + c.Fatal("cgroups mismatched") + } + } +} + +func (s *DockerSuite) TestInspectExecID(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSuffix(out, "\n") + + out, err := inspectField(id, "ExecIDs") + if err != nil { + c.Fatalf("failed to inspect container: %s, %v", out, err) + } + if out != "[]" { + c.Fatalf("ExecIDs should be empty, got: %s", out) + } + + // Start an exec, have it block waiting so we can do some checking + cmd := exec.Command(dockerBinary, "exec", id, "sh", "-c", + "while ! test -e /tmp/execid1; do sleep 1; done") + + if err = cmd.Start(); err != nil { + c.Fatalf("failed to start the exec cmd: %q", err) + } + + // Give the exec 10 chances/seconds to start then give up and stop the test + tries := 10 + for i := 0; i < tries; i++ { + // Since its still running we should see exec as part of the container + out, err = inspectField(id, "ExecIDs") + if err != nil { + c.Fatalf("failed to inspect container: %s, %v", out, err) + } + + out = strings.TrimSuffix(out, "\n") + if out != "[]" && out != "" { + break + } + if i+1 == tries { + c.Fatalf("ExecIDs should not be empty, got: %s", out) + } + time.Sleep(1 * time.Second) + } + + // Save execID for later + execID, err := inspectFilter(id, "index .ExecIDs 0") + if err != nil { + c.Fatalf("failed to get the exec id: %v", err) + } + + // End the exec by creating the missing file + err = exec.Command(dockerBinary, "exec", id, + "sh", "-c", "touch /tmp/execid1").Run() + + if err != nil { + c.Fatalf("failed to run the 2nd exec cmd: %q", err) + } + + // Wait for 1st exec to complete + cmd.Wait() + + // All execs for the container should be gone now + out, err = inspectField(id, "ExecIDs") + if err != nil { + c.Fatalf("failed to inspect container: %s, %v", out, err) + } + + out = strings.TrimSuffix(out, "\n") + if out != "[]" && out != "" { + c.Fatalf("ExecIDs should be empty, got: %s", out) + } + + // But we should still be able to query the execID + sc, body, err := sockRequest("GET", "/exec/"+execID+"/json", nil) + if sc != http.StatusOK { + c.Fatalf("received status != 200 OK: %d\n%s", sc, body) + } + + // Now delete the container and then an 'inspect' on the exec should + // result in a 404 (not 'container not running') + out, ec := dockerCmd(c, "rm", "-f", id) + if ec != 0 { + c.Fatalf("error removing container: %s", out) + } + sc, body, err = sockRequest("GET", "/exec/"+execID+"/json", nil) + if sc != http.StatusNotFound { + c.Fatalf("received status != 404: %d\n%s", sc, body) + } +} + +func (s *DockerSuite) TestLinksPingLinkedContainersOnRename(c *check.C) { + testRequires(c, DaemonIsLinux) + var out string + out, _ = dockerCmd(c, "run", "-d", "--name", "container1", "busybox", "top") + idA := strings.TrimSpace(out) + if idA == "" { + c.Fatal(out, "id should not be nil") + } + out, _ = dockerCmd(c, "run", "-d", "--link", "container1:alias1", "--name", "container2", "busybox", "top") + idB := strings.TrimSpace(out) + if idB == "" { + c.Fatal(out, "id should not be nil") + } + + dockerCmd(c, "exec", "container2", "ping", "-c", "1", "alias1", "-W", "1") + dockerCmd(c, "rename", "container1", "container_new") + dockerCmd(c, "exec", "container2", "ping", "-c", "1", "alias1", "-W", "1") +} + +func (s *DockerSuite) TestRunExecDir(c *check.C) { + testRequires(c, SameHostDaemon) + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + execDir := filepath.Join(execDriverPath, id) + stateFile := filepath.Join(execDir, "state.json") + + { + fi, err := os.Stat(execDir) + if err != nil { + c.Fatal(err) + } + if !fi.IsDir() { + c.Fatalf("%q must be a directory", execDir) + } + fi, err = os.Stat(stateFile) + if err != nil { + c.Fatal(err) + } + } + + dockerCmd(c, "stop", id) + { + _, err := os.Stat(execDir) + if err == nil { + c.Fatal(err) + } + if err == nil { + c.Fatalf("Exec directory %q exists for removed container!", execDir) + } + if !os.IsNotExist(err) { + c.Fatalf("Error should be about non-existing, got %s", err) + } + } + dockerCmd(c, "start", id) + { + fi, err := os.Stat(execDir) + if err != nil { + c.Fatal(err) + } + if !fi.IsDir() { + c.Fatalf("%q must be a directory", execDir) + } + fi, err = os.Stat(stateFile) + if err != nil { + c.Fatal(err) + } + } + dockerCmd(c, "rm", "-f", id) + { + _, err := os.Stat(execDir) + if err == nil { + c.Fatal(err) + } + if err == nil { + c.Fatalf("Exec directory %q is exists for removed container!", execDir) + } + if !os.IsNotExist(err) { + c.Fatalf("Error should be about non-existing, got %s", err) + } + } +} + +func (s *DockerSuite) TestRunMutableNetworkFiles(c *check.C) { + testRequires(c, SameHostDaemon) + + for _, fn := range []string{"resolv.conf", "hosts"} { + deleteAllContainers() + + content, err := runCommandAndReadContainerFile(fn, exec.Command(dockerBinary, "run", "-d", "--name", "c1", "busybox", "sh", "-c", fmt.Sprintf("echo success >/etc/%s && top", fn))) + if err != nil { + c.Fatal(err) + } + + if strings.TrimSpace(string(content)) != "success" { + c.Fatal("Content was not what was modified in the container", string(content)) + } + + out, _ := dockerCmd(c, "run", "-d", "--name", "c2", "busybox", "top") + contID := strings.TrimSpace(out) + netFilePath := containerStorageFile(contID, fn) + + f, err := os.OpenFile(netFilePath, os.O_WRONLY|os.O_SYNC|os.O_APPEND, 0644) + if err != nil { + c.Fatal(err) + } + + if _, err := f.Seek(0, 0); err != nil { + f.Close() + c.Fatal(err) + } + + if err := f.Truncate(0); err != nil { + f.Close() + c.Fatal(err) + } + + if _, err := f.Write([]byte("success2\n")); err != nil { + f.Close() + c.Fatal(err) + } + f.Close() + + res, _ := dockerCmd(c, "exec", contID, "cat", "/etc/"+fn) + if res != "success2\n" { + c.Fatalf("Expected content of %s: %q, got: %q", fn, "success2\n", res) + } + } +} + +func (s *DockerSuite) TestExecWithUser(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "parent", "busybox", "top") + + out, _ := dockerCmd(c, "exec", "-u", "1", "parent", "id") + if !strings.Contains(out, "uid=1(daemon) gid=1(daemon)") { + c.Fatalf("exec with user by id expected daemon user got %s", out) + } + + out, _ = dockerCmd(c, "exec", "-u", "root", "parent", "id") + if !strings.Contains(out, "uid=0(root) gid=0(root)") { + c.Fatalf("exec with user by root expected root user got %s", out) + } +} + +func (s *DockerSuite) TestExecWithPrivileged(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + // Start main loop which attempts mknod repeatedly + dockerCmd(c, "run", "-d", "--name", "parent", "--cap-drop=ALL", "busybox", "sh", "-c", `while (true); do if [ -e /exec_priv ]; then cat /exec_priv && mknod /tmp/sda b 8 0 && echo "Success"; else echo "Privileged exec has not run yet"; fi; usleep 10000; done`) + + // Check exec mknod doesn't work + cmd := exec.Command(dockerBinary, "exec", "parent", "sh", "-c", "mknod /tmp/sdb b 8 16") + out, _, err := runCommandWithOutput(cmd) + if err == nil || !strings.Contains(out, "Operation not permitted") { + c.Fatalf("exec mknod in --cap-drop=ALL container without --privileged should fail") + } + + // Check exec mknod does work with --privileged + cmd = exec.Command(dockerBinary, "exec", "--privileged", "parent", "sh", "-c", `echo "Running exec --privileged" > /exec_priv && mknod /tmp/sdb b 8 16 && usleep 50000 && echo "Finished exec --privileged" > /exec_priv && echo ok`) + out, _, err = runCommandWithOutput(cmd) + if err != nil { + c.Fatal(err, out) + } + + if actual := strings.TrimSpace(out); actual != "ok" { + c.Fatalf("exec mknod in --cap-drop=ALL container with --privileged failed: %v, output: %q", err, out) + } + + // Check subsequent unprivileged exec cannot mknod + cmd = exec.Command(dockerBinary, "exec", "parent", "sh", "-c", "mknod /tmp/sdc b 8 32") + out, _, err = runCommandWithOutput(cmd) + if err == nil || !strings.Contains(out, "Operation not permitted") { + c.Fatalf("repeating exec mknod in --cap-drop=ALL container after --privileged without --privileged should fail") + } + + // Confirm at no point was mknod allowed + logCmd := exec.Command(dockerBinary, "logs", "parent") + if out, _, err := runCommandWithOutput(logCmd); err != nil || strings.Contains(out, "Success") { + c.Fatal(out, err) + } + +} + +func (s *DockerSuite) TestExecWithImageUser(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuilduser" + _, err := buildImage(name, + `FROM busybox + RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd + USER dockerio`, + true) + if err != nil { + c.Fatalf("Could not build image %s: %v", name, err) + } + + dockerCmd(c, "run", "-d", "--name", "dockerioexec", name, "top") + + out, _ := dockerCmd(c, "exec", "dockerioexec", "whoami") + if !strings.Contains(out, "dockerio") { + c.Fatalf("exec with user by id expected dockerio user got %s", out) + } +} + +func (s *DockerSuite) TestExecOnReadonlyContainer(c *check.C) { + // --read-only + userns has remount issues + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "-d", "--read-only", "--name", "parent", "busybox", "top") + if _, status := dockerCmd(c, "exec", "parent", "true"); status != 0 { + c.Fatalf("exec into a read-only container failed with exit status %d", status) + } +} + +// #15750 +func (s *DockerSuite) TestExecStartFails(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "exec-15750" + dockerCmd(c, "run", "-d", "--name", name, "busybox", "top") + c.Assert(waitRun(name), check.IsNil) + + out, _, err := dockerCmdWithError("exec", name, "no-such-cmd") + c.Assert(err, check.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "executable file not found") +} diff --git a/integration-cli/docker_cli_exec_unix_test.go b/integration-cli/docker_cli_exec_unix_test.go new file mode 100644 index 0000000000..c635edd7d6 --- /dev/null +++ b/integration-cli/docker_cli_exec_unix_test.go @@ -0,0 +1,74 @@ +// +build !windows,!test_no_exec + +package main + +import ( + "bytes" + "io" + "os/exec" + "strings" + "time" + + "github.com/go-check/check" + "github.com/kr/pty" +) + +// regression test for #12546 +func (s *DockerSuite) TestExecInteractiveStdinClose(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-itd", "busybox", "/bin/cat") + contID := strings.TrimSpace(out) + + cmd := exec.Command(dockerBinary, "exec", "-i", contID, "echo", "-n", "hello") + p, err := pty.Start(cmd) + if err != nil { + c.Fatal(err) + } + + b := bytes.NewBuffer(nil) + go io.Copy(b, p) + + ch := make(chan error) + go func() { ch <- cmd.Wait() }() + + select { + case err := <-ch: + if err != nil { + c.Errorf("cmd finished with error %v", err) + } + if output := b.String(); strings.TrimSpace(output) != "hello" { + c.Fatalf("Unexpected output %s", output) + } + case <-time.After(1 * time.Second): + c.Fatal("timed out running docker exec") + } +} + +func (s *DockerSuite) TestExecTTY(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name=test", "busybox", "sh", "-c", "echo hello > /foo && top") + + cmd := exec.Command(dockerBinary, "exec", "-it", "test", "sh") + p, err := pty.Start(cmd) + c.Assert(err, check.IsNil) + defer p.Close() + + _, err = p.Write([]byte("cat /foo && exit\n")) + c.Assert(err, check.IsNil) + + chErr := make(chan error) + go func() { + chErr <- cmd.Wait() + }() + select { + case err := <-chErr: + c.Assert(err, check.IsNil) + case <-time.After(3 * time.Second): + c.Fatal("timeout waiting for exec to exit") + } + + buf := make([]byte, 256) + read, err := p.Read(buf) + c.Assert(err, check.IsNil) + c.Assert(bytes.Contains(buf, []byte("hello")), check.Equals, true, check.Commentf(string(buf[:read]))) +} diff --git a/integration-cli/docker_cli_experimental_test.go b/integration-cli/docker_cli_experimental_test.go new file mode 100644 index 0000000000..8cbb1bb3ff --- /dev/null +++ b/integration-cli/docker_cli_experimental_test.go @@ -0,0 +1,84 @@ +// +build experimental + +package main + +import ( + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "strconv" + "strings" + + "github.com/docker/docker/pkg/system" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestExperimentalVersion(c *check.C) { + out, _ := dockerCmd(c, "version") + for _, line := range strings.Split(out, "\n") { + if strings.HasPrefix(line, "Experimental (client):") || strings.HasPrefix(line, "Experimental (server):") { + c.Assert(line, check.Matches, "*true") + } + } + + out, _ = dockerCmd(c, "-v") + if !strings.Contains(out, ", experimental") { + c.Fatalf("docker version did not contain experimental: %s", out) + } +} + +// user namespaces test: run daemon with remapped root setting +// 1. validate uid/gid maps are set properly +// 2. verify that files created are owned by remapped root +func (s *DockerDaemonSuite) TestDaemonUserNamespaceRootSetting(c *check.C) { + testRequires(c, NativeExecDriver) + testRequires(c, SameHostDaemon) + + c.Assert(s.d.StartWithBusybox("--userns-remap", "default"), check.IsNil) + + tmpDir, err := ioutil.TempDir("", "userns") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpDir) + + // we need to find the uid and gid of the remapped root from the daemon's root dir info + uidgid := strings.Split(filepath.Base(s.d.root), ".") + c.Assert(len(uidgid), check.Equals, 2, check.Commentf("Should have gotten uid/gid strings from root dirname: %s", filepath.Base(s.d.root))) + uid, err := strconv.Atoi(uidgid[0]) + c.Assert(err, check.IsNil, check.Commentf("Can't parse uid: %v", err)) + gid, err := strconv.Atoi(uidgid[1]) + c.Assert(err, check.IsNil, check.Commentf("Can't parse gid: %v", err)) + + //writeable by the remapped root UID/GID pair + c.Assert(os.Chown(tmpDir, uid, gid), check.IsNil) + + out, err := s.d.Cmd("run", "-d", "--name", "userns", "-v", tmpDir+":/goofy", "busybox", "sh", "-c", "touch /goofy/testfile; top") + c.Assert(err, check.IsNil, check.Commentf("Output: %s", out)) + + pid, err := s.d.Cmd("inspect", "--format='{{.State.Pid}}'", "userns") + if err != nil { + c.Fatalf("Could not inspect running container: out: %q; err: %v", pid, err) + } + // check the uid and gid maps for the PID to ensure root is remapped + // (cmd = cat /proc//uid_map | grep -E '0\s+9999\s+1') + out, rc1, err := runCommandPipelineWithOutput( + exec.Command("cat", "/proc/"+strings.TrimSpace(pid)+"/uid_map"), + exec.Command("grep", "-E", fmt.Sprintf("0[[:space:]]+%d[[:space:]]+", uid))) + c.Assert(rc1, check.Equals, 0, check.Commentf("Didn't match uid_map: output: %s", out)) + + out, rc2, err := runCommandPipelineWithOutput( + exec.Command("cat", "/proc/"+strings.TrimSpace(pid)+"/gid_map"), + exec.Command("grep", "-E", fmt.Sprintf("0[[:space:]]+%d[[:space:]]+", gid))) + c.Assert(rc2, check.Equals, 0, check.Commentf("Didn't match gid_map: output: %s", out)) + + // check that the touched file is owned by remapped uid:gid + stat, err := system.Stat(filepath.Join(tmpDir, "testfile")) + if err != nil { + c.Fatal(err) + } + c.Assert(stat.UID(), check.Equals, uint32(uid), check.Commentf("Touched file not owned by remapped root UID")) + c.Assert(stat.GID(), check.Equals, uint32(gid), check.Commentf("Touched file not owned by remapped root GID")) +} diff --git a/integration-cli/docker_cli_export_import_test.go b/integration-cli/docker_cli_export_import_test.go new file mode 100644 index 0000000000..3199686be1 --- /dev/null +++ b/integration-cli/docker_cli_export_import_test.go @@ -0,0 +1,58 @@ +package main + +import ( + "os" + "os/exec" + "strings" + + "github.com/go-check/check" +) + +// export an image and try to import it into a new one +func (s *DockerSuite) TestExportContainerAndImportImage(c *check.C) { + testRequires(c, DaemonIsLinux) + containerID := "testexportcontainerandimportimage" + + dockerCmd(c, "run", "--name", containerID, "busybox", "true") + + out, _ := dockerCmd(c, "export", containerID) + + importCmd := exec.Command(dockerBinary, "import", "-", "repo/testexp:v1") + importCmd.Stdin = strings.NewReader(out) + out, _, err := runCommandWithOutput(importCmd) + if err != nil { + c.Fatalf("failed to import image: %s, %v", out, err) + } + + cleanedImageID := strings.TrimSpace(out) + if cleanedImageID == "" { + c.Fatalf("output should have been an image id, got: %s", out) + } +} + +// Used to test output flag in the export command +func (s *DockerSuite) TestExportContainerWithOutputAndImportImage(c *check.C) { + testRequires(c, DaemonIsLinux) + containerID := "testexportcontainerwithoutputandimportimage" + + dockerCmd(c, "run", "--name", containerID, "busybox", "true") + dockerCmd(c, "export", "--output=testexp.tar", containerID) + defer os.Remove("testexp.tar") + + out, _, err := runCommandWithOutput(exec.Command("cat", "testexp.tar")) + if err != nil { + c.Fatal(out, err) + } + + importCmd := exec.Command(dockerBinary, "import", "-", "repo/testexp:v1") + importCmd.Stdin = strings.NewReader(out) + out, _, err = runCommandWithOutput(importCmd) + if err != nil { + c.Fatalf("failed to import image: %s, %v", out, err) + } + + cleanedImageID := strings.TrimSpace(out) + if cleanedImageID == "" { + c.Fatalf("output should have been an image id, got: %s", out) + } +} diff --git a/integration-cli/docker_cli_external_graphdriver_unix_test.go b/integration-cli/docker_cli_external_graphdriver_unix_test.go new file mode 100644 index 0000000000..d8009181d0 --- /dev/null +++ b/integration-cli/docker_cli_external_graphdriver_unix_test.go @@ -0,0 +1,358 @@ +// +build experimental +// +build !windows + +package main + +import ( + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/http/httptest" + "os" + "strings" + + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/daemon/graphdriver/vfs" + "github.com/docker/docker/pkg/archive" + "github.com/go-check/check" +) + +func init() { + check.Suite(&DockerExternalGraphdriverSuite{ + ds: &DockerSuite{}, + }) +} + +type DockerExternalGraphdriverSuite struct { + server *httptest.Server + ds *DockerSuite + d *Daemon + ec *graphEventsCounter +} + +type graphEventsCounter struct { + activations int + creations int + removals int + gets int + puts int + stats int + cleanups int + exists int + init int + metadata int + diff int + applydiff int + changes int + diffsize int +} + +func (s *DockerExternalGraphdriverSuite) SetUpTest(c *check.C) { + s.d = NewDaemon(c) + s.ec = &graphEventsCounter{} +} + +func (s *DockerExternalGraphdriverSuite) TearDownTest(c *check.C) { + s.d.Stop() + s.ds.TearDownTest(c) +} + +func (s *DockerExternalGraphdriverSuite) SetUpSuite(c *check.C) { + mux := http.NewServeMux() + s.server = httptest.NewServer(mux) + + type graphDriverRequest struct { + ID string `json:",omitempty"` + Parent string `json:",omitempty"` + MountLabel string `json:",omitempty"` + } + + type graphDriverResponse struct { + Err error `json:",omitempty"` + Dir string `json:",omitempty"` + Exists bool `json:",omitempty"` + Status [][2]string `json:",omitempty"` + Metadata map[string]string `json:",omitempty"` + Changes []archive.Change `json:",omitempty"` + Size int64 `json:",omitempty"` + } + + respond := func(w http.ResponseWriter, data interface{}) { + w.Header().Set("Content-Type", "appplication/vnd.docker.plugins.v1+json") + switch t := data.(type) { + case error: + fmt.Fprintln(w, fmt.Sprintf(`{"Err": %q}`, t.Error())) + case string: + fmt.Fprintln(w, t) + default: + json.NewEncoder(w).Encode(&data) + } + } + + decReq := func(b io.ReadCloser, out interface{}, w http.ResponseWriter) error { + defer b.Close() + if err := json.NewDecoder(b).Decode(&out); err != nil { + http.Error(w, fmt.Sprintf("error decoding json: %s", err.Error()), 500) + } + return nil + } + + base, err := ioutil.TempDir("", "external-graph-test") + c.Assert(err, check.IsNil) + vfsProto, err := vfs.Init(base, []string{}, nil, nil) + if err != nil { + c.Fatalf("error initializing graph driver: %v", err) + } + driver := graphdriver.NewNaiveDiffDriver(vfsProto, nil, nil) + + mux.HandleFunc("/Plugin.Activate", func(w http.ResponseWriter, r *http.Request) { + s.ec.activations++ + respond(w, `{"Implements": ["GraphDriver"]}`) + }) + + mux.HandleFunc("/GraphDriver.Init", func(w http.ResponseWriter, r *http.Request) { + s.ec.init++ + respond(w, "{}") + }) + + mux.HandleFunc("/GraphDriver.Create", func(w http.ResponseWriter, r *http.Request) { + s.ec.creations++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + if err := driver.Create(req.ID, req.Parent); err != nil { + respond(w, err) + return + } + respond(w, "{}") + }) + + mux.HandleFunc("/GraphDriver.Remove", func(w http.ResponseWriter, r *http.Request) { + s.ec.removals++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + if err := driver.Remove(req.ID); err != nil { + respond(w, err) + return + } + respond(w, "{}") + }) + + mux.HandleFunc("/GraphDriver.Get", func(w http.ResponseWriter, r *http.Request) { + s.ec.gets++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + dir, err := driver.Get(req.ID, req.MountLabel) + if err != nil { + respond(w, err) + return + } + respond(w, &graphDriverResponse{Dir: dir}) + }) + + mux.HandleFunc("/GraphDriver.Put", func(w http.ResponseWriter, r *http.Request) { + s.ec.puts++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + if err := driver.Put(req.ID); err != nil { + respond(w, err) + return + } + respond(w, "{}") + }) + + mux.HandleFunc("/GraphDriver.Exists", func(w http.ResponseWriter, r *http.Request) { + s.ec.exists++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + respond(w, &graphDriverResponse{Exists: driver.Exists(req.ID)}) + }) + + mux.HandleFunc("/GraphDriver.Status", func(w http.ResponseWriter, r *http.Request) { + s.ec.stats++ + respond(w, &graphDriverResponse{Status: driver.Status()}) + }) + + mux.HandleFunc("/GraphDriver.Cleanup", func(w http.ResponseWriter, r *http.Request) { + s.ec.cleanups++ + err := driver.Cleanup() + if err != nil { + respond(w, err) + return + } + respond(w, `{}`) + }) + + mux.HandleFunc("/GraphDriver.GetMetadata", func(w http.ResponseWriter, r *http.Request) { + s.ec.metadata++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + data, err := driver.GetMetadata(req.ID) + if err != nil { + respond(w, err) + return + } + respond(w, &graphDriverResponse{Metadata: data}) + }) + + mux.HandleFunc("/GraphDriver.Diff", func(w http.ResponseWriter, r *http.Request) { + s.ec.diff++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + diff, err := driver.Diff(req.ID, req.Parent) + if err != nil { + respond(w, err) + return + } + io.Copy(w, diff) + }) + + mux.HandleFunc("/GraphDriver.Changes", func(w http.ResponseWriter, r *http.Request) { + s.ec.changes++ + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + changes, err := driver.Changes(req.ID, req.Parent) + if err != nil { + respond(w, err) + return + } + respond(w, &graphDriverResponse{Changes: changes}) + }) + + mux.HandleFunc("/GraphDriver.ApplyDiff", func(w http.ResponseWriter, r *http.Request) { + s.ec.applydiff++ + var diff archive.Reader = r.Body + defer r.Body.Close() + + id := r.URL.Query().Get("id") + parent := r.URL.Query().Get("parent") + + if id == "" { + http.Error(w, fmt.Sprintf("missing id"), 409) + } + + size, err := driver.ApplyDiff(id, parent, diff) + if err != nil { + respond(w, err) + return + } + respond(w, &graphDriverResponse{Size: size}) + }) + + mux.HandleFunc("/GraphDriver.DiffSize", func(w http.ResponseWriter, r *http.Request) { + s.ec.diffsize++ + + var req graphDriverRequest + if err := decReq(r.Body, &req, w); err != nil { + return + } + + size, err := driver.DiffSize(req.ID, req.Parent) + if err != nil { + respond(w, err) + return + } + respond(w, &graphDriverResponse{Size: size}) + }) + + if err := os.MkdirAll("/etc/docker/plugins", 0755); err != nil { + c.Fatal(err) + } + + if err := ioutil.WriteFile("/etc/docker/plugins/test-external-graph-driver.spec", []byte(s.server.URL), 0644); err != nil { + c.Fatal(err) + } +} + +func (s *DockerExternalGraphdriverSuite) TearDownSuite(c *check.C) { + s.server.Close() + + if err := os.RemoveAll("/etc/docker/plugins"); err != nil { + c.Fatal(err) + } +} + +func (s *DockerExternalGraphdriverSuite) TestExternalGraphDriver(c *check.C) { + if err := s.d.StartWithBusybox("-s", "test-external-graph-driver"); err != nil { + b, _ := ioutil.ReadFile(s.d.LogfileName()) + c.Assert(err, check.IsNil, check.Commentf("\n%s", string(b))) + } + + out, err := s.d.Cmd("run", "-d", "--name=graphtest", "busybox", "sh", "-c", "echo hello > /hello") + c.Assert(err, check.IsNil, check.Commentf(out)) + + err = s.d.Restart("-s", "test-external-graph-driver") + + out, err = s.d.Cmd("inspect", "--format='{{.GraphDriver.Name}}'", "graphtest") + c.Assert(err, check.IsNil, check.Commentf(out)) + c.Assert(strings.TrimSpace(out), check.Equals, "test-external-graph-driver") + + out, err = s.d.Cmd("diff", "graphtest") + c.Assert(err, check.IsNil, check.Commentf(out)) + c.Assert(strings.Contains(out, "A /hello"), check.Equals, true) + + out, err = s.d.Cmd("rm", "-f", "graphtest") + c.Assert(err, check.IsNil, check.Commentf(out)) + + out, err = s.d.Cmd("info") + c.Assert(err, check.IsNil, check.Commentf(out)) + + err = s.d.Stop() + c.Assert(err, check.IsNil) + + c.Assert(s.ec.activations, check.Equals, 2) + c.Assert(s.ec.init, check.Equals, 2) + c.Assert(s.ec.creations >= 1, check.Equals, true) + c.Assert(s.ec.removals >= 1, check.Equals, true) + c.Assert(s.ec.gets >= 1, check.Equals, true) + c.Assert(s.ec.puts >= 1, check.Equals, true) + c.Assert(s.ec.stats, check.Equals, 3) + c.Assert(s.ec.cleanups, check.Equals, 2) + c.Assert(s.ec.exists >= 1, check.Equals, true) + c.Assert(s.ec.applydiff >= 1, check.Equals, true) + c.Assert(s.ec.changes, check.Equals, 1) + c.Assert(s.ec.diffsize, check.Equals, 0) + c.Assert(s.ec.diff, check.Equals, 0) + c.Assert(s.ec.metadata, check.Equals, 1) +} + +func (s *DockerExternalGraphdriverSuite) TestExternalGraphDriverPull(c *check.C) { + testRequires(c, Network) + c.Assert(s.d.Start(), check.IsNil) + + out, err := s.d.Cmd("pull", "busybox:latest") + c.Assert(err, check.IsNil, check.Commentf(out)) + + out, err = s.d.Cmd("run", "-d", "busybox", "top") + c.Assert(err, check.IsNil, check.Commentf(out)) +} diff --git a/integration-cli/docker_cli_help_test.go b/integration-cli/docker_cli_help_test.go new file mode 100644 index 0000000000..325b28013b --- /dev/null +++ b/integration-cli/docker_cli_help_test.go @@ -0,0 +1,365 @@ +package main + +import ( + "os" + "os/exec" + "runtime" + "strings" + "unicode" + + "github.com/docker/docker/pkg/homedir" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestHelpTextVerify(c *check.C) { + testRequires(c, DaemonIsLinux) + // Make sure main help text fits within 80 chars and that + // on non-windows system we use ~ when possible (to shorten things). + // Test for HOME set to its default value and set to "/" on linux + // Yes on windows setting up an array and looping (right now) isn't + // necessary because we just have one value, but we'll need the + // array/loop on linux so we might as well set it up so that we can + // test any number of home dirs later on and all we need to do is + // modify the array - the rest of the testing infrastructure should work + homes := []string{homedir.Get()} + + // Non-Windows machines need to test for this special case of $HOME + if runtime.GOOS != "windows" { + homes = append(homes, "/") + } + + homeKey := homedir.Key() + baseEnvs := os.Environ() + + // Remove HOME env var from list so we can add a new value later. + for i, env := range baseEnvs { + if strings.HasPrefix(env, homeKey+"=") { + baseEnvs = append(baseEnvs[:i], baseEnvs[i+1:]...) + break + } + } + + for _, home := range homes { + // Dup baseEnvs and add our new HOME value + newEnvs := make([]string, len(baseEnvs)+1) + copy(newEnvs, baseEnvs) + newEnvs[len(newEnvs)-1] = homeKey + "=" + home + + scanForHome := runtime.GOOS != "windows" && home != "/" + + // Check main help text to make sure its not over 80 chars + helpCmd := exec.Command(dockerBinary, "help") + helpCmd.Env = newEnvs + out, ec, err := runCommandWithOutput(helpCmd) + if err != nil || ec != 0 { + c.Fatalf("docker help should have worked\nout:%s\nec:%d", out, ec) + } + lines := strings.Split(out, "\n") + for _, line := range lines { + if len(line) > 80 { + c.Fatalf("Line is too long(%d chars):\n%s", len(line), line) + } + + // All lines should not end with a space + if strings.HasSuffix(line, " ") { + c.Fatalf("Line should not end with a space: %s", line) + } + + if scanForHome && strings.Contains(line, `=`+home) { + c.Fatalf("Line should use '%q' instead of %q:\n%s", homedir.GetShortcutString(), home, line) + } + if runtime.GOOS != "windows" { + i := strings.Index(line, homedir.GetShortcutString()) + if i >= 0 && i != len(line)-1 && line[i+1] != '/' { + c.Fatalf("Main help should not have used home shortcut:\n%s", line) + } + } + } + + // Make sure each cmd's help text fits within 90 chars and that + // on non-windows system we use ~ when possible (to shorten things). + // Pull the list of commands from the "Commands:" section of docker help + helpCmd = exec.Command(dockerBinary, "help") + helpCmd.Env = newEnvs + out, ec, err = runCommandWithOutput(helpCmd) + if err != nil || ec != 0 { + c.Fatalf("docker help should have worked\nout:%s\nec:%d", out, ec) + } + i := strings.Index(out, "Commands:") + if i < 0 { + c.Fatalf("Missing 'Commands:' in:\n%s", out) + } + + cmds := []string{} + // Grab all chars starting at "Commands:" + helpOut := strings.Split(out[i:], "\n") + // First line is just "Commands:" + if isLocalDaemon { + // Replace first line with "daemon" command since it's not part of the list of commands. + helpOut[0] = " daemon" + } else { + // Skip first line + helpOut = helpOut[1:] + } + + // Create the list of commands we want to test + cmdsToTest := []string{} + for _, cmd := range helpOut { + // Stop on blank line or non-idented line + if cmd == "" || !unicode.IsSpace(rune(cmd[0])) { + break + } + + // Grab just the first word of each line + cmd = strings.Split(strings.TrimSpace(cmd), " ")[0] + cmds = append(cmds, cmd) // Saving count for later + + cmdsToTest = append(cmdsToTest, cmd) + } + + // Add some 'two word' commands - would be nice to automatically + // calculate this list - somehow + cmdsToTest = append(cmdsToTest, "volume create") + cmdsToTest = append(cmdsToTest, "volume inspect") + cmdsToTest = append(cmdsToTest, "volume ls") + cmdsToTest = append(cmdsToTest, "volume rm") + + for _, cmd := range cmdsToTest { + var stderr string + + args := strings.Split(cmd+" --help", " ") + + // Check the full usage text + helpCmd := exec.Command(dockerBinary, args...) + helpCmd.Env = newEnvs + out, stderr, ec, err = runCommandWithStdoutStderr(helpCmd) + if len(stderr) != 0 { + c.Fatalf("Error on %q help. non-empty stderr:%q", cmd, stderr) + } + if strings.HasSuffix(out, "\n\n") { + c.Fatalf("Should not have blank line on %q\nout:%q", cmd, out) + } + if !strings.Contains(out, "--help=false") { + c.Fatalf("Should show full usage on %q\nout:%q", cmd, out) + } + if err != nil || ec != 0 { + c.Fatalf("Error on %q help: %s\nexit code:%d", cmd, out, ec) + } + + // Check each line for lots of stuff + lines := strings.Split(out, "\n") + for _, line := range lines { + if len(line) > 90 { + c.Fatalf("Help for %q is too long(%d chars):\n%s", cmd, + len(line), line) + } + + if scanForHome && strings.Contains(line, `"`+home) { + c.Fatalf("Help for %q should use ~ instead of %q on:\n%s", + cmd, home, line) + } + i := strings.Index(line, "~") + if i >= 0 && i != len(line)-1 && line[i+1] != '/' { + c.Fatalf("Help for %q should not have used ~:\n%s", cmd, line) + } + + // If a line starts with 4 spaces then assume someone + // added a multi-line description for an option and we need + // to flag it + if strings.HasPrefix(line, " ") { + c.Fatalf("Help for %q should not have a multi-line option: %s", cmd, line) + } + + // Options should NOT end with a period + if strings.HasPrefix(line, " -") && strings.HasSuffix(line, ".") { + c.Fatalf("Help for %q should not end with a period: %s", cmd, line) + } + + // Options should NOT end with a space + if strings.HasSuffix(line, " ") { + c.Fatalf("Help for %q should not end with a space: %s", cmd, line) + } + + } + + // For each command make sure we generate an error + // if we give a bad arg + args = strings.Split(cmd+" --badArg", " ") + + dCmd := exec.Command(dockerBinary, args...) + out, stderr, ec, err = runCommandWithStdoutStderr(dCmd) + if len(out) != 0 || len(stderr) == 0 || ec == 0 || err == nil { + c.Fatalf("Bad results from 'docker %s --badArg'\nec:%d\nstdout:%s\nstderr:%s\nerr:%q", cmd, ec, out, stderr, err) + } + // Be really picky + if strings.HasSuffix(stderr, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker rm'\n%s", stderr) + } + + // Now make sure that each command will print a short-usage + // (not a full usage - meaning no opts section) if we + // are missing a required arg or pass in a bad arg + + // These commands will never print a short-usage so don't test + noShortUsage := map[string]string{ + "images": "", + "login": "", + "logout": "", + "network": "", + } + + if _, ok := noShortUsage[cmd]; !ok { + // For each command run it w/o any args. It will either return + // valid output or print a short-usage + var dCmd *exec.Cmd + var stdout, stderr string + var args []string + + // skipNoArgs are ones that we don't want to try w/o + // any args. Either because it'll hang the test or + // lead to incorrect test result (like false negative). + // Whatever the reason, skip trying to run w/o args and + // jump to trying with a bogus arg. + skipNoArgs := map[string]struct{}{ + "daemon": {}, + "events": {}, + "load": {}, + } + + ec = 0 + if _, ok := skipNoArgs[cmd]; !ok { + args = strings.Split(cmd, " ") + dCmd = exec.Command(dockerBinary, args...) + stdout, stderr, ec, err = runCommandWithStdoutStderr(dCmd) + } + + // If its ok w/o any args then try again with an arg + if ec == 0 { + args = strings.Split(cmd+" badArg", " ") + dCmd = exec.Command(dockerBinary, args...) + stdout, stderr, ec, err = runCommandWithStdoutStderr(dCmd) + } + + if len(stdout) != 0 || len(stderr) == 0 || ec == 0 || err == nil { + c.Fatalf("Bad output from %q\nstdout:%q\nstderr:%q\nec:%d\nerr:%q", args, stdout, stderr, ec, err) + } + // Should have just short usage + if !strings.Contains(stderr, "\nUsage:\t") { + c.Fatalf("Missing short usage on %q\nstderr:%q", args, stderr) + } + // But shouldn't have full usage + if strings.Contains(stderr, "--help=false") { + c.Fatalf("Should not have full usage on %q\nstderr:%q", args, stderr) + } + if strings.HasSuffix(stderr, "\n\n") { + c.Fatalf("Should not have a blank line on %q\nstderr:%q", args, stderr) + } + } + + } + + // Number of commands for standard release and experimental release + standard := 40 + experimental := 1 + expected := standard + experimental + if isLocalDaemon { + expected++ // for the daemon command + } + if len(cmds) > expected { + c.Fatalf("Wrong # of cmds(%d), it should be: %d\nThe list:\n%q", + len(cmds), expected, cmds) + } + } + +} + +func (s *DockerSuite) TestHelpExitCodesHelpOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + // Test to make sure the exit code and output (stdout vs stderr) of + // various good and bad cases are what we expect + + // docker : stdout=all, stderr=empty, rc=0 + cmd := exec.Command(dockerBinary) + stdout, stderr, ec, err := runCommandWithStdoutStderr(cmd) + if len(stdout) == 0 || len(stderr) != 0 || ec != 0 || err != nil { + c.Fatalf("Bad results from 'docker'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + // Be really pick + if strings.HasSuffix(stdout, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker'\n%s", stdout) + } + + // docker help: stdout=all, stderr=empty, rc=0 + cmd = exec.Command(dockerBinary, "help") + stdout, stderr, ec, err = runCommandWithStdoutStderr(cmd) + if len(stdout) == 0 || len(stderr) != 0 || ec != 0 || err != nil { + c.Fatalf("Bad results from 'docker help'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + // Be really pick + if strings.HasSuffix(stdout, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker help'\n%s", stdout) + } + + // docker --help: stdout=all, stderr=empty, rc=0 + cmd = exec.Command(dockerBinary, "--help") + stdout, stderr, ec, err = runCommandWithStdoutStderr(cmd) + if len(stdout) == 0 || len(stderr) != 0 || ec != 0 || err != nil { + c.Fatalf("Bad results from 'docker --help'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + // Be really pick + if strings.HasSuffix(stdout, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker --help'\n%s", stdout) + } + + // docker inspect busybox: stdout=all, stderr=empty, rc=0 + // Just making sure stderr is empty on valid cmd + cmd = exec.Command(dockerBinary, "inspect", "busybox") + stdout, stderr, ec, err = runCommandWithStdoutStderr(cmd) + if len(stdout) == 0 || len(stderr) != 0 || ec != 0 || err != nil { + c.Fatalf("Bad results from 'docker inspect busybox'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + // Be really pick + if strings.HasSuffix(stdout, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker inspect busyBox'\n%s", stdout) + } + + // docker rm: stdout=empty, stderr=all, rc!=0 + // testing the min arg error msg + cmd = exec.Command(dockerBinary, "rm") + stdout, stderr, ec, err = runCommandWithStdoutStderr(cmd) + if len(stdout) != 0 || len(stderr) == 0 || ec == 0 || err == nil { + c.Fatalf("Bad results from 'docker rm'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + // Should not contain full help text but should contain info about + // # of args and Usage line + if !strings.Contains(stderr, "requires a minimum") { + c.Fatalf("Missing # of args text from 'docker rm'\nstderr:%s", stderr) + } + + // docker rm NoSuchContainer: stdout=empty, stderr=all, rc=0 + // testing to make sure no blank line on error + cmd = exec.Command(dockerBinary, "rm", "NoSuchContainer") + stdout, stderr, ec, err = runCommandWithStdoutStderr(cmd) + if len(stdout) != 0 || len(stderr) == 0 || ec == 0 || err == nil { + c.Fatalf("Bad results from 'docker rm NoSuchContainer'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + // Be really picky + if strings.HasSuffix(stderr, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker rm'\n%s", stderr) + } + + // docker BadCmd: stdout=empty, stderr=all, rc=0 + cmd = exec.Command(dockerBinary, "BadCmd") + stdout, stderr, ec, err = runCommandWithStdoutStderr(cmd) + if len(stdout) != 0 || len(stderr) == 0 || ec == 0 || err == nil { + c.Fatalf("Bad results from 'docker BadCmd'\nec:%d\nstdout:%s\nstderr:%s\nerr:%v", ec, stdout, stderr, err) + } + if stderr != "docker: 'BadCmd' is not a docker command.\nSee 'docker --help'.\n" { + c.Fatalf("Unexcepted output for 'docker badCmd'\nstderr:%s", stderr) + } + // Be really picky + if strings.HasSuffix(stderr, "\n\n") { + c.Fatalf("Should not have a blank line at the end of 'docker rm'\n%s", stderr) + } + +} diff --git a/integration-cli/docker_cli_history_test.go b/integration-cli/docker_cli_history_test.go new file mode 100644 index 0000000000..ce9d902ed7 --- /dev/null +++ b/integration-cli/docker_cli_history_test.go @@ -0,0 +1,137 @@ +package main + +import ( + "fmt" + "regexp" + "strconv" + "strings" + + "github.com/go-check/check" +) + +// This is a heisen-test. Because the created timestamp of images and the behavior of +// sort is not predictable it doesn't always fail. +func (s *DockerSuite) TestBuildHistory(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testbuildhistory" + _, err := buildImage(name, `FROM busybox +RUN echo "A" +RUN echo "B" +RUN echo "C" +RUN echo "D" +RUN echo "E" +RUN echo "F" +RUN echo "G" +RUN echo "H" +RUN echo "I" +RUN echo "J" +RUN echo "K" +RUN echo "L" +RUN echo "M" +RUN echo "N" +RUN echo "O" +RUN echo "P" +RUN echo "Q" +RUN echo "R" +RUN echo "S" +RUN echo "T" +RUN echo "U" +RUN echo "V" +RUN echo "W" +RUN echo "X" +RUN echo "Y" +RUN echo "Z"`, + true) + + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "history", "testbuildhistory") + actualValues := strings.Split(out, "\n")[1:27] + expectedValues := [26]string{"Z", "Y", "X", "W", "V", "U", "T", "S", "R", "Q", "P", "O", "N", "M", "L", "K", "J", "I", "H", "G", "F", "E", "D", "C", "B", "A"} + + for i := 0; i < 26; i++ { + echoValue := fmt.Sprintf("echo \"%s\"", expectedValues[i]) + actualValue := actualValues[i] + + if !strings.Contains(actualValue, echoValue) { + c.Fatalf("Expected layer \"%s\", but was: %s", expectedValues[i], actualValue) + } + } + +} + +func (s *DockerSuite) TestHistoryExistentImage(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "history", "busybox") +} + +func (s *DockerSuite) TestHistoryNonExistentImage(c *check.C) { + _, _, err := dockerCmdWithError("history", "testHistoryNonExistentImage") + if err == nil { + c.Fatal("history on a non-existent image should fail.") + } +} + +func (s *DockerSuite) TestHistoryImageWithComment(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testhistoryimagewithcomment" + + // make a image through docker commit [ -m messages ] + + dockerCmd(c, "run", "--name", name, "busybox", "true") + dockerCmd(c, "wait", name) + + comment := "This_is_a_comment" + dockerCmd(c, "commit", "-m="+comment, name, name) + + // test docker history to check comment messages + + out, _ := dockerCmd(c, "history", name) + outputTabs := strings.Fields(strings.Split(out, "\n")[1]) + actualValue := outputTabs[len(outputTabs)-1] + + if !strings.Contains(actualValue, comment) { + c.Fatalf("Expected comments %q, but found %q", comment, actualValue) + } +} + +func (s *DockerSuite) TestHistoryHumanOptionFalse(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "history", "--human=false", "busybox") + lines := strings.Split(out, "\n") + sizeColumnRegex, _ := regexp.Compile("SIZE +") + indices := sizeColumnRegex.FindStringIndex(lines[0]) + startIndex := indices[0] + endIndex := indices[1] + for i := 1; i < len(lines)-1; i++ { + if endIndex > len(lines[i]) { + endIndex = len(lines[i]) + } + sizeString := lines[i][startIndex:endIndex] + if _, err := strconv.Atoi(strings.TrimSpace(sizeString)); err != nil { + c.Fatalf("The size '%s' was not an Integer", sizeString) + } + } +} + +func (s *DockerSuite) TestHistoryHumanOptionTrue(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "history", "--human=true", "busybox") + lines := strings.Split(out, "\n") + sizeColumnRegex, _ := regexp.Compile("SIZE +") + humanSizeRegex, _ := regexp.Compile("^\\d+.*B$") // Matches human sizes like 10 MB, 3.2 KB, etc + indices := sizeColumnRegex.FindStringIndex(lines[0]) + startIndex := indices[0] + endIndex := indices[1] + for i := 1; i < len(lines)-1; i++ { + if endIndex > len(lines[i]) { + endIndex = len(lines[i]) + } + sizeString := lines[i][startIndex:endIndex] + if matchSuccess := humanSizeRegex.MatchString(strings.TrimSpace(sizeString)); !matchSuccess { + c.Fatalf("The size '%s' was not in human format", sizeString) + } + } +} diff --git a/integration-cli/docker_cli_images_test.go b/integration-cli/docker_cli_images_test.go new file mode 100644 index 0000000000..27fbfb721f --- /dev/null +++ b/integration-cli/docker_cli_images_test.go @@ -0,0 +1,247 @@ +package main + +import ( + "fmt" + "reflect" + "sort" + "strings" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/stringid" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestImagesEnsureImageIsListed(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "images") + if !strings.Contains(out, "busybox") { + c.Fatal("images should've listed busybox") + } +} + +func (s *DockerSuite) TestImagesEnsureImageWithTagIsListed(c *check.C) { + testRequires(c, DaemonIsLinux) + _, err := buildImage("imagewithtag:v1", + `FROM scratch + MAINTAINER dockerio1`, true) + c.Assert(err, check.IsNil) + + _, err = buildImage("imagewithtag:v2", + `FROM scratch + MAINTAINER dockerio1`, true) + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "images", "imagewithtag:v1") + + if !strings.Contains(out, "imagewithtag") || !strings.Contains(out, "v1") || strings.Contains(out, "v2") { + c.Fatal("images should've listed imagewithtag:v1 and not imagewithtag:v2") + } + + out, _ = dockerCmd(c, "images", "imagewithtag") + + if !strings.Contains(out, "imagewithtag") || !strings.Contains(out, "v1") || !strings.Contains(out, "v2") { + c.Fatal("images should've listed imagewithtag:v1 and imagewithtag:v2") + } +} + +func (s *DockerSuite) TestImagesEnsureImageWithBadTagIsNotListed(c *check.C) { + out, _ := dockerCmd(c, "images", "busybox:nonexistent") + + if strings.Contains(out, "busybox") { + c.Fatal("images should not have listed busybox") + } +} + +func (s *DockerSuite) TestImagesOrderedByCreationDate(c *check.C) { + testRequires(c, DaemonIsLinux) + id1, err := buildImage("order:test_a", + `FROM scratch + MAINTAINER dockerio1`, true) + if err != nil { + c.Fatal(err) + } + time.Sleep(1 * time.Second) + id2, err := buildImage("order:test_c", + `FROM scratch + MAINTAINER dockerio2`, true) + if err != nil { + c.Fatal(err) + } + time.Sleep(1 * time.Second) + id3, err := buildImage("order:test_b", + `FROM scratch + MAINTAINER dockerio3`, true) + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "images", "-q", "--no-trunc") + imgs := strings.Split(out, "\n") + if imgs[0] != id3 { + c.Fatalf("First image must be %s, got %s", id3, imgs[0]) + } + if imgs[1] != id2 { + c.Fatalf("Second image must be %s, got %s", id2, imgs[1]) + } + if imgs[2] != id1 { + c.Fatalf("Third image must be %s, got %s", id1, imgs[2]) + } +} + +func (s *DockerSuite) TestImagesErrorWithInvalidFilterNameTest(c *check.C) { + out, _, err := dockerCmdWithError("images", "-f", "FOO=123") + if err == nil || !strings.Contains(out, "Invalid filter") { + c.Fatalf("error should occur when listing images with invalid filter name FOO, %s", out) + } +} + +func (s *DockerSuite) TestImagesFilterLabel(c *check.C) { + testRequires(c, DaemonIsLinux) + imageName1 := "images_filter_test1" + imageName2 := "images_filter_test2" + imageName3 := "images_filter_test3" + image1ID, err := buildImage(imageName1, + `FROM scratch + LABEL match me`, true) + c.Assert(err, check.IsNil) + + image2ID, err := buildImage(imageName2, + `FROM scratch + LABEL match="me too"`, true) + c.Assert(err, check.IsNil) + + image3ID, err := buildImage(imageName3, + `FROM scratch + LABEL nomatch me`, true) + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "images", "--no-trunc", "-q", "-f", "label=match") + out = strings.TrimSpace(out) + c.Assert(out, check.Matches, fmt.Sprintf("[\\s\\w]*%s[\\s\\w]*", image1ID)) + c.Assert(out, check.Matches, fmt.Sprintf("[\\s\\w]*%s[\\s\\w]*", image2ID)) + c.Assert(out, check.Not(check.Matches), fmt.Sprintf("[\\s\\w]*%s[\\s\\w]*", image3ID)) + + out, _ = dockerCmd(c, "images", "--no-trunc", "-q", "-f", "label=match=me too") + out = strings.TrimSpace(out) + c.Assert(out, check.Equals, image2ID) +} + +// Regression : #15659 +func (s *DockerSuite) TestImagesFilterLabelWithCommit(c *check.C) { + // Create a container + dockerCmd(c, "run", "--name", "bar", "busybox", "/bin/sh") + // Commit with labels "using changes" + out, _ := dockerCmd(c, "commit", "-c", "LABEL foo.version=1.0.0-1", "-c", "LABEL foo.name=bar", "-c", "LABEL foo.author=starlord", "bar", "bar:1.0.0-1") + imageID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "images", "--no-trunc", "-q", "-f", "label=foo.version=1.0.0-1") + out = strings.TrimSpace(out) + c.Assert(out, check.Equals, imageID) +} + +func (s *DockerSuite) TestImagesFilterSpaceTrimCase(c *check.C) { + testRequires(c, DaemonIsLinux) + imageName := "images_filter_test" + buildImage(imageName, + `FROM scratch + RUN touch /test/foo + RUN touch /test/bar + RUN touch /test/baz`, true) + + filters := []string{ + "dangling=true", + "Dangling=true", + " dangling=true", + "dangling=true ", + "dangling = true", + } + + imageListings := make([][]string, 5, 5) + for idx, filter := range filters { + out, _ := dockerCmd(c, "images", "-q", "-f", filter) + listing := strings.Split(out, "\n") + sort.Strings(listing) + imageListings[idx] = listing + } + + for idx, listing := range imageListings { + if idx < 4 && !reflect.DeepEqual(listing, imageListings[idx+1]) { + for idx, errListing := range imageListings { + fmt.Printf("out %d", idx) + for _, image := range errListing { + fmt.Print(image) + } + fmt.Print("") + } + c.Fatalf("All output must be the same") + } + } +} + +func (s *DockerSuite) TestImagesEnsureDanglingImageOnlyListedOnce(c *check.C) { + testRequires(c, DaemonIsLinux) + // create container 1 + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + containerID1 := strings.TrimSpace(out) + + // tag as foobox + out, _ = dockerCmd(c, "commit", containerID1, "foobox") + imageID := stringid.TruncateID(strings.TrimSpace(out)) + + // overwrite the tag, making the previous image dangling + dockerCmd(c, "tag", "-f", "busybox", "foobox") + + out, _ = dockerCmd(c, "images", "-q", "-f", "dangling=true") + if e, a := 1, strings.Count(out, imageID); e != a { + c.Fatalf("expected 1 dangling image, got %d: %s", a, out) + } +} + +func (s *DockerSuite) TestImagesWithIncorrectFilter(c *check.C) { + out, _, err := dockerCmdWithError("images", "-f", "dangling=invalid") + c.Assert(err, check.NotNil) + c.Assert(out, checker.Contains, "Invalid filter") +} + +func (s *DockerSuite) TestImagesEnsureOnlyHeadsImagesShown(c *check.C) { + testRequires(c, DaemonIsLinux) + + dockerfile := ` + FROM scratch + MAINTAINER docker + ENV foo bar` + + head, out, err := buildImageWithOut("scratch-image", dockerfile, false) + c.Assert(err, check.IsNil) + + // this is just the output of docker build + // we're interested in getting the image id of the MAINTAINER instruction + // and that's located at output, line 5, from 7 to end + split := strings.Split(out, "\n") + intermediate := strings.TrimSpace(split[5][7:]) + + out, _ = dockerCmd(c, "images") + if strings.Contains(out, intermediate) { + c.Fatalf("images shouldn't show non-heads images, got %s in %s", intermediate, out) + } + if !strings.Contains(out, head[:12]) { + c.Fatalf("images should contain final built images, want %s in out, got %s", head[:12], out) + } +} + +func (s *DockerSuite) TestImagesEnsureImagesFromScratchShown(c *check.C) { + testRequires(c, DaemonIsLinux) + + dockerfile := ` + FROM scratch + MAINTAINER docker` + + id, _, err := buildImageWithOut("scratch-image", dockerfile, false) + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "images") + if !strings.Contains(out, id[:12]) { + c.Fatalf("images should contain images built from scratch (e.g. %s), got %s", id[:12], out) + } +} diff --git a/integration-cli/docker_cli_import_test.go b/integration-cli/docker_cli_import_test.go new file mode 100644 index 0000000000..83746e2b61 --- /dev/null +++ b/integration-cli/docker_cli_import_test.go @@ -0,0 +1,128 @@ +package main + +import ( + "bufio" + "io/ioutil" + "os" + "os/exec" + "regexp" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestImportDisplay(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + cleanedContainerID := strings.TrimSpace(out) + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "export", cleanedContainerID), + exec.Command(dockerBinary, "import", "-"), + ) + if err != nil { + c.Errorf("import failed with errors: %v, output: %q", err, out) + } + + if n := strings.Count(out, "\n"); n != 1 { + c.Fatalf("display is messed up: %d '\\n' instead of 1:\n%s", n, out) + } + image := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "--rm", image, "true") + if out != "" { + c.Fatalf("command output should've been nothing, was %q", out) + } +} + +func (s *DockerSuite) TestImportBadURL(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("import", "http://nourl/bad") + if err == nil { + c.Fatal("import was supposed to fail but didn't") + } + if !strings.Contains(out, "dial tcp") { + c.Fatalf("expected an error msg but didn't get one:\n%s", out) + } +} + +func (s *DockerSuite) TestImportFile(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "test-import", "busybox", "true") + + temporaryFile, err := ioutil.TempFile("", "exportImportTest") + if err != nil { + c.Fatal("failed to create temporary file", "", err) + } + defer os.Remove(temporaryFile.Name()) + + runCmd := exec.Command(dockerBinary, "export", "test-import") + runCmd.Stdout = bufio.NewWriter(temporaryFile) + + _, err = runCommand(runCmd) + if err != nil { + c.Fatal("failed to export a container", err) + } + + out, _ := dockerCmd(c, "import", temporaryFile.Name()) + if n := strings.Count(out, "\n"); n != 1 { + c.Fatalf("display is messed up: %d '\\n' instead of 1:\n%s", n, out) + } + image := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "--rm", image, "true") + if out != "" { + c.Fatalf("command output should've been nothing, was %q", out) + } +} + +func (s *DockerSuite) TestImportFileWithMessage(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "test-import", "busybox", "true") + + temporaryFile, err := ioutil.TempFile("", "exportImportTest") + if err != nil { + c.Fatal("failed to create temporary file", "", err) + } + defer os.Remove(temporaryFile.Name()) + + runCmd := exec.Command(dockerBinary, "export", "test-import") + runCmd.Stdout = bufio.NewWriter(temporaryFile) + + _, err = runCommand(runCmd) + if err != nil { + c.Fatal("failed to export a container", err) + } + + message := "Testing commit message" + out, _ := dockerCmd(c, "import", "-m", message, temporaryFile.Name()) + if n := strings.Count(out, "\n"); n != 1 { + c.Fatalf("display is messed up: %d '\\n' instead of 1:\n%s", n, out) + } + image := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "history", image) + split := strings.Split(out, "\n") + + if len(split) != 3 { + c.Fatalf("expected 3 lines from image history, got %d", len(split)) + } + r := regexp.MustCompile("[\\s]{2,}") + split = r.Split(split[1], -1) + + if message != split[3] { + c.Fatalf("expected %s in commit message, got %s", message, split[3]) + } + + out, _ = dockerCmd(c, "run", "--rm", image, "true") + if out != "" { + c.Fatalf("command output should've been nothing, was %q", out) + } +} + +func (s *DockerSuite) TestImportFileNonExistentFile(c *check.C) { + _, exitCode, err := dockerCmdWithError("import", "example.com/myImage.tar") + if exitCode == 0 || err == nil { + c.Fatalf("import non-existing file must failed") + } +} diff --git a/integration-cli/docker_cli_info_test.go b/integration-cli/docker_cli_info_test.go new file mode 100644 index 0000000000..2e07590268 --- /dev/null +++ b/integration-cli/docker_cli_info_test.go @@ -0,0 +1,104 @@ +package main + +import ( + "fmt" + "net" + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/utils" + "github.com/go-check/check" +) + +// ensure docker info succeeds +func (s *DockerSuite) TestInfoEnsureSucceeds(c *check.C) { + out, _ := dockerCmd(c, "info") + + // always shown fields + stringsToCheck := []string{ + "ID:", + "Containers:", + "Images:", + "Execution Driver:", + "Logging Driver:", + "Operating System:", + "CPUs:", + "Total Memory:", + "Kernel Version:", + "Storage Driver:", + } + + if utils.ExperimentalBuild() { + stringsToCheck = append(stringsToCheck, "Experimental: true") + } + + for _, linePrefix := range stringsToCheck { + if !strings.Contains(out, linePrefix) { + c.Errorf("couldn't find string %v in output", linePrefix) + } + } +} + +// TestInfoDiscoveryBackend verifies that a daemon run with `--cluster-advertise` and +// `--cluster-store` properly show the backend's endpoint in info output. +func (s *DockerSuite) TestInfoDiscoveryBackend(c *check.C) { + testRequires(c, SameHostDaemon) + + d := NewDaemon(c) + discoveryBackend := "consul://consuladdr:consulport/some/path" + discoveryAdvertise := "1.1.1.1:2375" + err := d.Start(fmt.Sprintf("--cluster-store=%s", discoveryBackend), fmt.Sprintf("--cluster-advertise=%s", discoveryAdvertise)) + c.Assert(err, checker.IsNil) + defer d.Stop() + + out, err := d.Cmd("info") + c.Assert(err, checker.IsNil) + c.Assert(out, checker.Contains, fmt.Sprintf("Cluster store: %s\n", discoveryBackend)) + c.Assert(out, checker.Contains, fmt.Sprintf("Cluster advertise: %s\n", discoveryAdvertise)) +} + +// TestInfoDiscoveryInvalidAdvertise verifies that a daemon run with +// an invalid `--cluster-advertise` configuration +func (s *DockerSuite) TestInfoDiscoveryInvalidAdvertise(c *check.C) { + testRequires(c, SameHostDaemon) + + d := NewDaemon(c) + discoveryBackend := "consul://consuladdr:consulport/some/path" + + // --cluster-advertise with an invalid string is an error + err := d.Start(fmt.Sprintf("--cluster-store=%s", discoveryBackend), "--cluster-advertise=invalid") + c.Assert(err, checker.Not(checker.IsNil)) + + // --cluster-advertise without --cluster-store is also an error + err = d.Start("--cluster-advertise=1.1.1.1:2375") + c.Assert(err, checker.Not(checker.IsNil)) +} + +// TestInfoDiscoveryAdvertiseInterfaceName verifies that a daemon run with `--cluster-advertise` +// configured with interface name properly show the advertise ip-address in info output. +func (s *DockerSuite) TestInfoDiscoveryAdvertiseInterfaceName(c *check.C) { + testRequires(c, SameHostDaemon) + + d := NewDaemon(c) + discoveryBackend := "consul://consuladdr:consulport/some/path" + discoveryAdvertise := "eth0" + + err := d.Start(fmt.Sprintf("--cluster-store=%s", discoveryBackend), fmt.Sprintf("--cluster-advertise=%s:2375", discoveryAdvertise)) + c.Assert(err, checker.IsNil) + defer d.Stop() + + iface, err := net.InterfaceByName(discoveryAdvertise) + c.Assert(err, checker.IsNil) + addrs, err := iface.Addrs() + c.Assert(err, checker.IsNil) + if len(addrs) <= 0 { + c.Fatalf("addrs %v has to have at least one element", addrs) + } + ip, _, err := net.ParseCIDR(addrs[0].String()) + c.Assert(err, checker.IsNil) + + out, err := d.Cmd("info") + c.Assert(err, checker.IsNil) + c.Assert(out, checker.Contains, fmt.Sprintf("Cluster store: %s\n", discoveryBackend)) + c.Assert(out, checker.Contains, fmt.Sprintf("Cluster advertise: %s:2375\n", ip.String())) +} diff --git a/integration-cli/docker_cli_inspect_experimental_test.go b/integration-cli/docker_cli_inspect_experimental_test.go new file mode 100644 index 0000000000..058f300344 --- /dev/null +++ b/integration-cli/docker_cli_inspect_experimental_test.go @@ -0,0 +1,45 @@ +// +build experimental + +package main + +import ( + "github.com/docker/docker/api/types" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestInspectNamedMountPoint(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "test", "-v", "data:/data", "busybox", "cat") + + vol, err := inspectFieldJSON("test", "Mounts") + c.Assert(err, check.IsNil) + + var mp []types.MountPoint + err = unmarshalJSON([]byte(vol), &mp) + c.Assert(err, check.IsNil) + + if len(mp) != 1 { + c.Fatalf("Expected 1 mount point, was %v\n", len(mp)) + } + + m := mp[0] + if m.Name != "data" { + c.Fatalf("Expected name data, was %s\n", m.Name) + } + + if m.Driver != "local" { + c.Fatalf("Expected driver local, was %s\n", m.Driver) + } + + if m.Source == "" { + c.Fatalf("Expected source to not be empty") + } + + if m.RW != true { + c.Fatalf("Expected rw to be true") + } + + if m.Destination != "/data" { + c.Fatalf("Expected destination /data, was %s\n", m.Destination) + } +} diff --git a/integration-cli/docker_cli_inspect_test.go b/integration-cli/docker_cli_inspect_test.go new file mode 100644 index 0000000000..f722ae22cf --- /dev/null +++ b/integration-cli/docker_cli_inspect_test.go @@ -0,0 +1,399 @@ +package main + +import ( + "encoding/json" + "fmt" + "os/exec" + "strconv" + "strings" + "time" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/runconfig" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestInspectImage(c *check.C) { + testRequires(c, DaemonIsLinux) + imageTest := "emptyfs" + imageTestID := "511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158" + id, err := inspectField(imageTest, "Id") + c.Assert(err, check.IsNil) + + if id != imageTestID { + c.Fatalf("Expected id: %s for image: %s but received id: %s", imageTestID, imageTest, id) + } +} + +func (s *DockerSuite) TestInspectInt64(c *check.C) { + testRequires(c, DaemonIsLinux) + + dockerCmd(c, "run", "-d", "-m=300M", "--name", "inspectTest", "busybox", "true") + inspectOut, err := inspectField("inspectTest", "HostConfig.Memory") + c.Assert(err, check.IsNil) + + if inspectOut != "314572800" { + c.Fatalf("inspect got wrong value, got: %q, expected: 314572800", inspectOut) + } +} + +func (s *DockerSuite) TestInspectDefault(c *check.C) { + testRequires(c, DaemonIsLinux) + //Both the container and image are named busybox. docker inspect will fetch the container JSON. + //If the container JSON is not available, it will go for the image JSON. + + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "true") + dockerCmd(c, "inspect", "busybox") +} + +func (s *DockerSuite) TestInspectStatus(c *check.C) { + defer unpauseAllContainers() + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + out = strings.TrimSpace(out) + + inspectOut, err := inspectField(out, "State.Status") + c.Assert(err, check.IsNil) + if inspectOut != "running" { + c.Fatalf("inspect got wrong status, got: %q, expected: running", inspectOut) + } + + dockerCmd(c, "pause", out) + inspectOut, err = inspectField(out, "State.Status") + c.Assert(err, check.IsNil) + if inspectOut != "paused" { + c.Fatalf("inspect got wrong status, got: %q, expected: paused", inspectOut) + } + + dockerCmd(c, "unpause", out) + inspectOut, err = inspectField(out, "State.Status") + c.Assert(err, check.IsNil) + if inspectOut != "running" { + c.Fatalf("inspect got wrong status, got: %q, expected: running", inspectOut) + } + + dockerCmd(c, "stop", out) + inspectOut, err = inspectField(out, "State.Status") + c.Assert(err, check.IsNil) + if inspectOut != "exited" { + c.Fatalf("inspect got wrong status, got: %q, expected: exited", inspectOut) + } +} + +func (s *DockerSuite) TestInspectTypeFlagContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + //Both the container and image are named busybox. docker inspect will fetch container + //JSON State.Running field. If the field is true, it's a container. + + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "top") + + formatStr := "--format='{{.State.Running}}'" + out, exitCode, err := dockerCmdWithError("inspect", "--type=container", formatStr, "busybox") + if exitCode != 0 || err != nil { + c.Fatalf("failed to inspect container: %s, %v", out, err) + } + + if out != "true\n" { + c.Fatal("not a container JSON") + } +} + +func (s *DockerSuite) TestInspectTypeFlagWithNoContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + //Run this test on an image named busybox. docker inspect will try to fetch container + //JSON. Since there is no container named busybox and --type=container, docker inspect will + //not try to get the image JSON. It will throw an error. + + dockerCmd(c, "run", "-d", "busybox", "true") + + _, exitCode, err := dockerCmdWithError("inspect", "--type=container", "busybox") + if exitCode == 0 || err == nil { + c.Fatalf("docker inspect should have failed, as there is no container named busybox") + } +} + +func (s *DockerSuite) TestInspectTypeFlagWithImage(c *check.C) { + testRequires(c, DaemonIsLinux) + //Both the container and image are named busybox. docker inspect will fetch image + //JSON as --type=image. if there is no image with name busybox, docker inspect + //will throw an error. + + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "true") + + out, exitCode, err := dockerCmdWithError("inspect", "--type=image", "busybox") + if exitCode != 0 || err != nil { + c.Fatalf("failed to inspect image: %s, %v", out, err) + } + + if strings.Contains(out, "State") { + c.Fatal("not an image JSON") + } +} + +func (s *DockerSuite) TestInspectTypeFlagWithInvalidValue(c *check.C) { + testRequires(c, DaemonIsLinux) + //Both the container and image are named busybox. docker inspect will fail + //as --type=foobar is not a valid value for the flag. + + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "true") + + out, exitCode, err := dockerCmdWithError("inspect", "--type=foobar", "busybox") + if exitCode != 0 || err != nil { + if !strings.Contains(out, "not a valid value for --type") { + c.Fatalf("failed to inspect image: %s, %v", out, err) + } + } +} + +func (s *DockerSuite) TestInspectImageFilterInt(c *check.C) { + testRequires(c, DaemonIsLinux) + imageTest := "emptyfs" + out, err := inspectField(imageTest, "Size") + c.Assert(err, check.IsNil) + + size, err := strconv.Atoi(out) + if err != nil { + c.Fatalf("failed to inspect size of the image: %s, %v", out, err) + } + + //now see if the size turns out to be the same + formatStr := fmt.Sprintf("--format='{{eq .Size %d}}'", size) + out, exitCode, err := dockerCmdWithError("inspect", formatStr, imageTest) + if exitCode != 0 || err != nil { + c.Fatalf("failed to inspect image: %s, %v", out, err) + } + if result, err := strconv.ParseBool(strings.TrimSuffix(out, "\n")); err != nil || !result { + c.Fatalf("Expected size: %d for image: %s but received size: %s", size, imageTest, strings.TrimSuffix(out, "\n")) + } +} + +func (s *DockerSuite) TestInspectContainerFilterInt(c *check.C) { + testRequires(c, DaemonIsLinux) + runCmd := exec.Command(dockerBinary, "run", "-i", "-a", "stdin", "busybox", "cat") + runCmd.Stdin = strings.NewReader("blahblah") + out, _, _, err := runCommandWithStdoutStderr(runCmd) + if err != nil { + c.Fatalf("failed to run container: %v, output: %q", err, out) + } + + id := strings.TrimSpace(out) + + out, err = inspectField(id, "State.ExitCode") + c.Assert(err, check.IsNil) + + exitCode, err := strconv.Atoi(out) + if err != nil { + c.Fatalf("failed to inspect exitcode of the container: %s, %v", out, err) + } + + //now get the exit code to verify + formatStr := fmt.Sprintf("--format='{{eq .State.ExitCode %d}}'", exitCode) + out, _ = dockerCmd(c, "inspect", formatStr, id) + if result, err := strconv.ParseBool(strings.TrimSuffix(out, "\n")); err != nil || !result { + c.Fatalf("Expected exitcode: %d for container: %s", exitCode, id) + } +} + +func (s *DockerSuite) TestInspectImageGraphDriver(c *check.C) { + testRequires(c, DaemonIsLinux) + imageTest := "emptyfs" + name, err := inspectField(imageTest, "GraphDriver.Name") + c.Assert(err, check.IsNil) + + if name != "devicemapper" && name != "overlay" && name != "vfs" && name != "zfs" && name != "btrfs" && name != "aufs" { + c.Fatalf("%v is not a valid graph driver name", name) + } + + if name != "devicemapper" { + return + } + + deviceID, err := inspectField(imageTest, "GraphDriver.Data.DeviceId") + c.Assert(err, check.IsNil) + + _, err = strconv.Atoi(deviceID) + if err != nil { + c.Fatalf("failed to inspect DeviceId of the image: %s, %v", deviceID, err) + } + + deviceSize, err := inspectField(imageTest, "GraphDriver.Data.DeviceSize") + c.Assert(err, check.IsNil) + + _, err = strconv.ParseUint(deviceSize, 10, 64) + if err != nil { + c.Fatalf("failed to inspect DeviceSize of the image: %s, %v", deviceSize, err) + } +} + +func (s *DockerSuite) TestInspectContainerGraphDriver(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + out = strings.TrimSpace(out) + + name, err := inspectField(out, "GraphDriver.Name") + c.Assert(err, check.IsNil) + + if name != "devicemapper" && name != "overlay" && name != "vfs" && name != "zfs" && name != "btrfs" && name != "aufs" { + c.Fatalf("%v is not a valid graph driver name", name) + } + + if name != "devicemapper" { + return + } + + deviceID, err := inspectField(out, "GraphDriver.Data.DeviceId") + c.Assert(err, check.IsNil) + + _, err = strconv.Atoi(deviceID) + if err != nil { + c.Fatalf("failed to inspect DeviceId of the image: %s, %v", deviceID, err) + } + + deviceSize, err := inspectField(out, "GraphDriver.Data.DeviceSize") + c.Assert(err, check.IsNil) + + _, err = strconv.ParseUint(deviceSize, 10, 64) + if err != nil { + c.Fatalf("failed to inspect DeviceSize of the image: %s, %v", deviceSize, err) + } +} + +func (s *DockerSuite) TestInspectBindMountPoint(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "test", "-v", "/data:/data:ro,z", "busybox", "cat") + + vol, err := inspectFieldJSON("test", "Mounts") + c.Assert(err, check.IsNil) + + var mp []types.MountPoint + err = unmarshalJSON([]byte(vol), &mp) + c.Assert(err, check.IsNil) + + if len(mp) != 1 { + c.Fatalf("Expected 1 mount point, was %v\n", len(mp)) + } + + m := mp[0] + + if m.Name != "" { + c.Fatal("Expected name to be empty") + } + + if m.Driver != "" { + c.Fatal("Expected driver to be empty") + } + + if m.Source != "/data" { + c.Fatalf("Expected source /data, was %s\n", m.Source) + } + + if m.Destination != "/data" { + c.Fatalf("Expected destination /data, was %s\n", m.Destination) + } + + if m.Mode != "ro,z" { + c.Fatalf("Expected mode `ro,z`, was %s\n", m.Mode) + } + + if m.RW != false { + c.Fatalf("Expected rw to be false") + } +} + +// #14947 +func (s *DockerSuite) TestInspectTimesAsRFC3339Nano(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + id := strings.TrimSpace(out) + startedAt, err := inspectField(id, "State.StartedAt") + c.Assert(err, check.IsNil) + finishedAt, err := inspectField(id, "State.FinishedAt") + c.Assert(err, check.IsNil) + created, err := inspectField(id, "Created") + c.Assert(err, check.IsNil) + + _, err = time.Parse(time.RFC3339Nano, startedAt) + c.Assert(err, check.IsNil) + _, err = time.Parse(time.RFC3339Nano, finishedAt) + c.Assert(err, check.IsNil) + _, err = time.Parse(time.RFC3339Nano, created) + c.Assert(err, check.IsNil) + + created, err = inspectField("busybox", "Created") + c.Assert(err, check.IsNil) + + _, err = time.Parse(time.RFC3339Nano, created) + c.Assert(err, check.IsNil) +} + +// #15633 +func (s *DockerSuite) TestInspectLogConfigNoType(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "create", "--name=test", "--log-opt", "max-file=42", "busybox") + var logConfig runconfig.LogConfig + + out, err := inspectFieldJSON("test", "HostConfig.LogConfig") + c.Assert(err, check.IsNil) + + err = json.NewDecoder(strings.NewReader(out)).Decode(&logConfig) + c.Assert(err, check.IsNil) + + c.Assert(logConfig.Type, check.Equals, "json-file") + c.Assert(logConfig.Config["max-file"], check.Equals, "42", check.Commentf("%v", logConfig)) +} + +func (s *DockerSuite) TestInspectNoSizeFlagContainer(c *check.C) { + + //Both the container and image are named busybox. docker inspect will fetch container + //JSON SizeRw and SizeRootFs field. If there is no flag --size/-s, there are no size fields. + + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "top") + + formatStr := "--format='{{.SizeRw}},{{.SizeRootFs}}'" + out, _ := dockerCmd(c, "inspect", "--type=container", formatStr, "busybox") + c.Assert(strings.TrimSpace(out), check.Equals, ",", check.Commentf("Exepcted not to display size info: %s", out)) +} + +func (s *DockerSuite) TestInspectSizeFlagContainer(c *check.C) { + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "top") + + formatStr := "--format='{{.SizeRw}},{{.SizeRootFs}}'" + out, _ := dockerCmd(c, "inspect", "-s", "--type=container", formatStr, "busybox") + sz := strings.Split(out, ",") + + c.Assert(strings.TrimSpace(sz[0]), check.Not(check.Equals), "") + c.Assert(strings.TrimSpace(sz[1]), check.Not(check.Equals), "") +} + +func (s *DockerSuite) TestInspectSizeFlagImage(c *check.C) { + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "top") + + formatStr := "--format='{{.SizeRw}},{{.SizeRootFs}}'" + out, _, err := dockerCmdWithError("inspect", "-s", "--type=image", formatStr, "busybox") + + // Template error rather than + // This is a more correct behavior because images don't have sizes associated. + c.Assert(err, check.Not(check.IsNil)) + c.Assert(out, checker.Contains, "Template parsing error") +} + +func (s *DockerSuite) TestInspectTempateError(c *check.C) { + //Both the container and image are named busybox. docker inspect will fetch container + //JSON State.Running field. If the field is true, it's a container. + + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "top") + + out, _, err := dockerCmdWithError("inspect", "--type=container", "--format='Format container: {{.ThisDoesNotExist}}'", "busybox") + + c.Assert(err, check.Not(check.IsNil)) + c.Assert(out, checker.Contains, "Template parsing error") +} + +func (s *DockerSuite) TestInspectJSONFields(c *check.C) { + dockerCmd(c, "run", "--name=busybox", "-d", "busybox", "top") + out, _, err := dockerCmdWithError("inspect", "--type=container", "--format='{{.HostConfig.Dns}}'", "busybox") + + c.Assert(err, check.IsNil) + c.Assert(out, checker.Equals, "[]\n") +} diff --git a/integration-cli/docker_cli_kill_test.go b/integration-cli/docker_cli_kill_test.go new file mode 100644 index 0000000000..5632db71e8 --- /dev/null +++ b/integration-cli/docker_cli_kill_test.go @@ -0,0 +1,106 @@ +package main + +import ( + "fmt" + "net/http" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestKillContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + c.Assert(waitRun(cleanedContainerID), check.IsNil) + + dockerCmd(c, "kill", cleanedContainerID) + + out, _ = dockerCmd(c, "ps", "-q") + if strings.Contains(out, cleanedContainerID) { + c.Fatal("killed container is still running") + } +} + +func (s *DockerSuite) TestKillofStoppedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "stop", cleanedContainerID) + + _, _, err := dockerCmdWithError("kill", "-s", "30", cleanedContainerID) + c.Assert(err, check.Not(check.IsNil), check.Commentf("Container %s is not running", cleanedContainerID)) +} + +func (s *DockerSuite) TestKillDifferentUserContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-u", "daemon", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + c.Assert(waitRun(cleanedContainerID), check.IsNil) + + dockerCmd(c, "kill", cleanedContainerID) + + out, _ = dockerCmd(c, "ps", "-q") + if strings.Contains(out, cleanedContainerID) { + c.Fatal("killed container is still running") + } +} + +// regression test about correct signal parsing see #13665 +func (s *DockerSuite) TestKillWithSignal(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cid := strings.TrimSpace(out) + c.Assert(waitRun(cid), check.IsNil) + + dockerCmd(c, "kill", "-s", "SIGWINCH", cid) + + running, _ := inspectField(cid, "State.Running") + if running != "true" { + c.Fatal("Container should be in running state after SIGWINCH") + } +} + +func (s *DockerSuite) TestKillWithInvalidSignal(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + cid := strings.TrimSpace(out) + c.Assert(waitRun(cid), check.IsNil) + + out, _, err := dockerCmdWithError("kill", "-s", "0", cid) + c.Assert(err, check.NotNil) + if !strings.ContainsAny(out, "Invalid signal: 0") { + c.Fatal("Kill with an invalid signal didn't error out correctly") + } + + running, _ := inspectField(cid, "State.Running") + if running != "true" { + c.Fatal("Container should be in running state after an invalid signal") + } + + out, _ = dockerCmd(c, "run", "-d", "busybox", "top") + cid = strings.TrimSpace(out) + c.Assert(waitRun(cid), check.IsNil) + + out, _, err = dockerCmdWithError("kill", "-s", "SIG42", cid) + c.Assert(err, check.NotNil) + if !strings.ContainsAny(out, "Invalid signal: SIG42") { + c.Fatal("Kill with an invalid signal error out correctly") + } + + running, _ = inspectField(cid, "State.Running") + if running != "true" { + c.Fatal("Container should be in running state after an invalid signal") + } +} + +func (s *DockerSuite) TestKillStoppedContainerAPIPre120(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "docker-kill-test-api", "-d", "busybox", "top") + dockerCmd(c, "stop", "docker-kill-test-api") + + status, _, err := sockRequest("POST", fmt.Sprintf("/v1.19/containers/%s/kill", "docker-kill-test-api"), nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusNoContent) +} diff --git a/integration-cli/docker_cli_links_test.go b/integration-cli/docker_cli_links_test.go new file mode 100644 index 0000000000..e42062d168 --- /dev/null +++ b/integration-cli/docker_cli_links_test.go @@ -0,0 +1,250 @@ +package main + +import ( + "fmt" + "reflect" + "regexp" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestLinksPingUnlinkedContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + _, exitCode, err := dockerCmdWithError("run", "--rm", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") + + if exitCode == 0 { + c.Fatal("run ping did not fail") + } else if exitCode != 1 { + c.Fatalf("run ping failed with errors: %v", err) + } + +} + +// Test for appropriate error when calling --link with an invalid target container +func (s *DockerSuite) TestLinksInvalidContainerTarget(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--link", "bogus:alias", "busybox", "true") + + if err == nil { + c.Fatal("an invalid container target should produce an error") + } + if !strings.Contains(out, "Could not get container") { + c.Fatalf("error output expected 'Could not get container', but got %q instead; err: %v", out, err) + } + +} + +func (s *DockerSuite) TestLinksPingLinkedContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "container1", "--hostname", "fred", "busybox", "top") + dockerCmd(c, "run", "-d", "--name", "container2", "--hostname", "wilma", "busybox", "top") + + runArgs := []string{"run", "--rm", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "sh", "-c"} + pingCmd := "ping -c 1 %s -W 1 && ping -c 1 %s -W 1" + + // test ping by alias, ping by name, and ping by hostname + // 1. Ping by alias + dockerCmd(c, append(runArgs, fmt.Sprintf(pingCmd, "alias1", "alias2"))...) + // 2. Ping by container name + dockerCmd(c, append(runArgs, fmt.Sprintf(pingCmd, "container1", "container2"))...) + // 3. Ping by hostname + dockerCmd(c, append(runArgs, fmt.Sprintf(pingCmd, "fred", "wilma"))...) + +} + +func (s *DockerSuite) TestLinksPingLinkedContainersAfterRename(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--name", "container1", "busybox", "top") + idA := strings.TrimSpace(out) + out, _ = dockerCmd(c, "run", "-d", "--name", "container2", "busybox", "top") + idB := strings.TrimSpace(out) + dockerCmd(c, "rename", "container1", "container_new") + dockerCmd(c, "run", "--rm", "--link", "container_new:alias1", "--link", "container2:alias2", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") + dockerCmd(c, "kill", idA) + dockerCmd(c, "kill", idB) + +} + +func (s *DockerSuite) TestLinksInspectLinksStarted(c *check.C) { + testRequires(c, DaemonIsLinux) + var ( + expected = map[string]struct{}{"/container1:/testinspectlink/alias1": {}, "/container2:/testinspectlink/alias2": {}} + result []string + ) + dockerCmd(c, "run", "-d", "--name", "container1", "busybox", "top") + dockerCmd(c, "run", "-d", "--name", "container2", "busybox", "top") + dockerCmd(c, "run", "-d", "--name", "testinspectlink", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "top") + links, err := inspectFieldJSON("testinspectlink", "HostConfig.Links") + if err != nil { + c.Fatal(err) + } + + err = unmarshalJSON([]byte(links), &result) + if err != nil { + c.Fatal(err) + } + + output := convertSliceOfStringsToMap(result) + + equal := reflect.DeepEqual(output, expected) + + if !equal { + c.Fatalf("Links %s, expected %s", result, expected) + } +} + +func (s *DockerSuite) TestLinksInspectLinksStopped(c *check.C) { + testRequires(c, DaemonIsLinux) + var ( + expected = map[string]struct{}{"/container1:/testinspectlink/alias1": {}, "/container2:/testinspectlink/alias2": {}} + result []string + ) + dockerCmd(c, "run", "-d", "--name", "container1", "busybox", "top") + dockerCmd(c, "run", "-d", "--name", "container2", "busybox", "top") + dockerCmd(c, "run", "-d", "--name", "testinspectlink", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "true") + links, err := inspectFieldJSON("testinspectlink", "HostConfig.Links") + if err != nil { + c.Fatal(err) + } + + err = unmarshalJSON([]byte(links), &result) + if err != nil { + c.Fatal(err) + } + + output := convertSliceOfStringsToMap(result) + + equal := reflect.DeepEqual(output, expected) + + if !equal { + c.Fatalf("Links %s, but expected %s", result, expected) + } + +} + +func (s *DockerSuite) TestLinksNotStartedParentNotFail(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "create", "--name=first", "busybox", "top") + dockerCmd(c, "create", "--name=second", "--link=first:first", "busybox", "top") + dockerCmd(c, "start", "first") + +} + +func (s *DockerSuite) TestLinksHostsFilesInject(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon, ExecSupport) + + out, _ := dockerCmd(c, "run", "-itd", "--name", "one", "busybox", "top") + idOne := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "-itd", "--name", "two", "--link", "one:onetwo", "busybox", "top") + idTwo := strings.TrimSpace(out) + + c.Assert(waitRun(idTwo), check.IsNil) + + contentOne, err := readContainerFileWithExec(idOne, "/etc/hosts") + if err != nil { + c.Fatal(err, string(contentOne)) + } + + contentTwo, err := readContainerFileWithExec(idTwo, "/etc/hosts") + if err != nil { + c.Fatal(err, string(contentTwo)) + } + + if !strings.Contains(string(contentTwo), "onetwo") { + c.Fatal("Host is not present in updated hosts file", string(contentTwo)) + } + +} + +func (s *DockerSuite) TestLinksUpdateOnRestart(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon, ExecSupport) + dockerCmd(c, "run", "-d", "--name", "one", "busybox", "top") + out, _ := dockerCmd(c, "run", "-d", "--name", "two", "--link", "one:onetwo", "--link", "one:one", "busybox", "top") + id := strings.TrimSpace(string(out)) + + realIP, err := inspectField("one", "NetworkSettings.Networks.bridge.IPAddress") + if err != nil { + c.Fatal(err) + } + content, err := readContainerFileWithExec(id, "/etc/hosts") + if err != nil { + c.Fatal(err, string(content)) + } + getIP := func(hosts []byte, hostname string) string { + re := regexp.MustCompile(fmt.Sprintf(`(\S*)\t%s`, regexp.QuoteMeta(hostname))) + matches := re.FindSubmatch(hosts) + if matches == nil { + c.Fatalf("Hostname %s have no matches in hosts", hostname) + } + return string(matches[1]) + } + if ip := getIP(content, "one"); ip != realIP { + c.Fatalf("For 'one' alias expected IP: %s, got: %s", realIP, ip) + } + if ip := getIP(content, "onetwo"); ip != realIP { + c.Fatalf("For 'onetwo' alias expected IP: %s, got: %s", realIP, ip) + } + dockerCmd(c, "restart", "one") + realIP, err = inspectField("one", "NetworkSettings.Networks.bridge.IPAddress") + c.Assert(err, check.IsNil) + + content, err = readContainerFileWithExec(id, "/etc/hosts") + if err != nil { + c.Fatal(err, string(content)) + } + if ip := getIP(content, "one"); ip != realIP { + c.Fatalf("For 'one' alias expected IP: %s, got: %s", realIP, ip) + } + if ip := getIP(content, "onetwo"); ip != realIP { + c.Fatalf("For 'onetwo' alias expected IP: %s, got: %s", realIP, ip) + } +} + +func (s *DockerSuite) TestLinksEnvs(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "-e", "e1=", "-e", "e2=v2", "-e", "e3=v3=v3", "--name=first", "busybox", "top") + out, _ := dockerCmd(c, "run", "--name=second", "--link=first:first", "busybox", "env") + if !strings.Contains(out, "FIRST_ENV_e1=\n") || + !strings.Contains(out, "FIRST_ENV_e2=v2") || + !strings.Contains(out, "FIRST_ENV_e3=v3=v3") { + c.Fatalf("Incorrect output: %s", out) + } +} + +func (s *DockerSuite) TestLinkShortDefinition(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--name", "shortlinkdef", "busybox", "top") + + cid := strings.TrimSpace(out) + c.Assert(waitRun(cid), check.IsNil) + + out, _ = dockerCmd(c, "run", "-d", "--name", "link2", "--link", "shortlinkdef", "busybox", "top") + + cid2 := strings.TrimSpace(out) + c.Assert(waitRun(cid2), check.IsNil) + + links, err := inspectFieldJSON(cid2, "HostConfig.Links") + c.Assert(err, check.IsNil) + c.Assert(links, check.Equals, "[\"/shortlinkdef:/link2/shortlinkdef\"]") +} + +func (s *DockerSuite) TestLinksNetworkHostContainer(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "-d", "--net", "host", "--name", "host_container", "busybox", "top") + out, _, err := dockerCmdWithError("run", "--name", "should_fail", "--link", "host_container:tester", "busybox", "true") + if err == nil || !strings.Contains(out, "--net=host can't be used with links. This would result in undefined behavior") { + c.Fatalf("Running container linking to a container with --net host should have failed: %s", out) + } +} + +func (s *DockerSuite) TestLinksEtcHostsRegularFile(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--net=host", "busybox", "ls", "-la", "/etc/hosts") + if !strings.HasPrefix(out, "-") { + c.Errorf("/etc/hosts should be a regular file") + } +} diff --git a/integration-cli/docker_cli_links_unix_test.go b/integration-cli/docker_cli_links_unix_test.go new file mode 100644 index 0000000000..d27fde46a5 --- /dev/null +++ b/integration-cli/docker_cli_links_unix_test.go @@ -0,0 +1,27 @@ +// +build !windows + +package main + +import ( + "io/ioutil" + "os" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestLinksEtcHostsContentMatch(c *check.C) { + // In a _unix file as using Unix specific files, and must be on the + // same host as the daemon. + testRequires(c, SameHostDaemon, NotUserNamespace) + + out, _ := dockerCmd(c, "run", "--net=host", "busybox", "cat", "/etc/hosts") + hosts, err := ioutil.ReadFile("/etc/hosts") + if os.IsNotExist(err) { + c.Skip("/etc/hosts does not exist, skip this test") + } + + if out != string(hosts) { + c.Errorf("container: %s\n\nhost:%s", out, hosts) + } + +} diff --git a/integration-cli/docker_cli_login_test.go b/integration-cli/docker_cli_login_test.go new file mode 100644 index 0000000000..13d43404a1 --- /dev/null +++ b/integration-cli/docker_cli_login_test.go @@ -0,0 +1,21 @@ +package main + +import ( + "bytes" + "os/exec" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestLoginWithoutTTY(c *check.C) { + cmd := exec.Command(dockerBinary, "login") + + // Send to stdin so the process does not get the TTY + cmd.Stdin = bytes.NewBufferString("buffer test string \n") + + // run the command and block until it's done + err := cmd.Run() + c.Assert(err, checker.NotNil) //"Expected non nil err when loginning in & TTY not available" + +} diff --git a/integration-cli/docker_cli_logs_test.go b/integration-cli/docker_cli_logs_test.go new file mode 100644 index 0000000000..c7454fb2fd --- /dev/null +++ b/integration-cli/docker_cli_logs_test.go @@ -0,0 +1,383 @@ +package main + +import ( + "encoding/json" + "fmt" + "io" + "os/exec" + "regexp" + "strconv" + "strings" + "time" + + "github.com/docker/docker/pkg/timeutils" + "github.com/go-check/check" +) + +// This used to work, it test a log of PageSize-1 (gh#4851) +func (s *DockerSuite) TestLogsContainerSmallerThanPage(c *check.C) { + testRequires(c, DaemonIsLinux) + testLen := 32767 + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("for i in $(seq 1 %d); do echo -n =; done; echo", testLen)) + cleanedContainerID := strings.TrimSpace(out) + + dockerCmd(c, "wait", cleanedContainerID) + out, _ = dockerCmd(c, "logs", cleanedContainerID) + if len(out) != testLen+1 { + c.Fatalf("Expected log length of %d, received %d\n", testLen+1, len(out)) + } +} + +// Regression test: When going over the PageSize, it used to panic (gh#4851) +func (s *DockerSuite) TestLogsContainerBiggerThanPage(c *check.C) { + testRequires(c, DaemonIsLinux) + testLen := 32768 + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("for i in $(seq 1 %d); do echo -n =; done; echo", testLen)) + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", cleanedContainerID) + + if len(out) != testLen+1 { + c.Fatalf("Expected log length of %d, received %d\n", testLen+1, len(out)) + } +} + +// Regression test: When going much over the PageSize, it used to block (gh#4851) +func (s *DockerSuite) TestLogsContainerMuchBiggerThanPage(c *check.C) { + testRequires(c, DaemonIsLinux) + testLen := 33000 + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("for i in $(seq 1 %d); do echo -n =; done; echo", testLen)) + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", cleanedContainerID) + + if len(out) != testLen+1 { + c.Fatalf("Expected log length of %d, received %d\n", testLen+1, len(out)) + } +} + +func (s *DockerSuite) TestLogsTimestamps(c *check.C) { + testRequires(c, DaemonIsLinux) + testLen := 100 + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("for i in $(seq 1 %d); do echo =; done;", testLen)) + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", "-t", cleanedContainerID) + + lines := strings.Split(out, "\n") + + if len(lines) != testLen+1 { + c.Fatalf("Expected log %d lines, received %d\n", testLen+1, len(lines)) + } + + ts := regexp.MustCompile(`^.* `) + + for _, l := range lines { + if l != "" { + _, err := time.Parse(timeutils.RFC3339NanoFixed+" ", ts.FindString(l)) + if err != nil { + c.Fatalf("Failed to parse timestamp from %v: %v", l, err) + } + if l[29] != 'Z' { // ensure we have padded 0's + c.Fatalf("Timestamp isn't padded properly: %s", l) + } + } + } +} + +func (s *DockerSuite) TestLogsSeparateStderr(c *check.C) { + testRequires(c, DaemonIsLinux) + msg := "stderr_log" + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("echo %s 1>&2", msg)) + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + stdout, stderr, _ := dockerCmdWithStdoutStderr(c, "logs", cleanedContainerID) + + if stdout != "" { + c.Fatalf("Expected empty stdout stream, got %v", stdout) + } + + stderr = strings.TrimSpace(stderr) + if stderr != msg { + c.Fatalf("Expected %v in stderr stream, got %v", msg, stderr) + } +} + +func (s *DockerSuite) TestLogsStderrInStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + msg := "stderr_log" + out, _ := dockerCmd(c, "run", "-d", "-t", "busybox", "sh", "-c", fmt.Sprintf("echo %s 1>&2", msg)) + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + stdout, stderr, _ := dockerCmdWithStdoutStderr(c, "logs", cleanedContainerID) + if stderr != "" { + c.Fatalf("Expected empty stderr stream, got %v", stderr) + } + + stdout = strings.TrimSpace(stdout) + if stdout != msg { + c.Fatalf("Expected %v in stdout stream, got %v", msg, stdout) + } +} + +func (s *DockerSuite) TestLogsTail(c *check.C) { + testRequires(c, DaemonIsLinux) + testLen := 100 + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("for i in $(seq 1 %d); do echo =; done;", testLen)) + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", "--tail", "5", cleanedContainerID) + + lines := strings.Split(out, "\n") + + if len(lines) != 6 { + c.Fatalf("Expected log %d lines, received %d\n", 6, len(lines)) + } + out, _ = dockerCmd(c, "logs", "--tail", "all", cleanedContainerID) + + lines = strings.Split(out, "\n") + + if len(lines) != testLen+1 { + c.Fatalf("Expected log %d lines, received %d\n", testLen+1, len(lines)) + } + out, _, _ = dockerCmdWithStdoutStderr(c, "logs", "--tail", "random", cleanedContainerID) + + lines = strings.Split(out, "\n") + + if len(lines) != testLen+1 { + c.Fatalf("Expected log %d lines, received %d\n", testLen+1, len(lines)) + } +} + +func (s *DockerSuite) TestLogsFollowStopped(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "echo", "hello") + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + logsCmd := exec.Command(dockerBinary, "logs", "-f", cleanedContainerID) + if err := logsCmd.Start(); err != nil { + c.Fatal(err) + } + + errChan := make(chan error) + go func() { + errChan <- logsCmd.Wait() + close(errChan) + }() + + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(1 * time.Second): + c.Fatal("Following logs is hanged") + } +} + +func (s *DockerSuite) TestLogsSince(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "testlogssince" + out, _ := dockerCmd(c, "run", "--name="+name, "busybox", "/bin/sh", "-c", "for i in $(seq 1 3); do sleep 2; echo `date +%s` log$i; done") + + log2Line := strings.Split(strings.Split(out, "\n")[1], " ") + t, err := strconv.ParseInt(log2Line[0], 10, 64) // the timestamp log2 is written + c.Assert(err, check.IsNil) + since := t + 1 // add 1s so log1 & log2 doesn't show up + out, _ = dockerCmd(c, "logs", "-t", fmt.Sprintf("--since=%v", since), name) + + // Skip 2 seconds + unexpected := []string{"log1", "log2"} + for _, v := range unexpected { + if strings.Contains(out, v) { + c.Fatalf("unexpected log message returned=%v, since=%v\nout=%v", v, since, out) + } + } + // Test with default value specified and parameter omitted + expected := []string{"log1", "log2", "log3"} + for _, cmd := range []*exec.Cmd{ + exec.Command(dockerBinary, "logs", "-t", name), + exec.Command(dockerBinary, "logs", "-t", "--since=0", name), + } { + out, _, err = runCommandWithOutput(cmd) + if err != nil { + c.Fatalf("failed to log container: %s, %v", out, err) + } + for _, v := range expected { + if !strings.Contains(out, v) { + c.Fatalf("'%v' does not contain=%v\nout=%s", cmd.Args, v, out) + } + } + } +} + +func (s *DockerSuite) TestLogsSinceFutureFollow(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", `for i in $(seq 1 5); do date +%s; sleep 1; done`) + cleanedContainerID := strings.TrimSpace(out) + + now := daemonTime(c).Unix() + since := now + 2 + out, _ = dockerCmd(c, "logs", "-f", fmt.Sprintf("--since=%v", since), cleanedContainerID) + lines := strings.Split(strings.TrimSpace(out), "\n") + if len(lines) == 0 { + c.Fatal("got no log lines") + } + for _, v := range lines { + ts, err := strconv.ParseInt(v, 10, 64) + if err != nil { + c.Fatalf("cannot parse timestamp output from log: '%v'\nout=%s", v, out) + } + if ts < since { + c.Fatalf("earlier log found. since=%v logdate=%v", since, ts) + } + } +} + +// Regression test for #8832 +func (s *DockerSuite) TestLogsFollowSlowStdoutConsumer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", `usleep 200000;yes X | head -c 200000`) + + cleanedContainerID := strings.TrimSpace(out) + + stopSlowRead := make(chan bool) + + go func() { + exec.Command(dockerBinary, "wait", cleanedContainerID).Run() + stopSlowRead <- true + }() + + logCmd := exec.Command(dockerBinary, "logs", "-f", cleanedContainerID) + stdout, err := logCmd.StdoutPipe() + c.Assert(err, check.IsNil) + c.Assert(logCmd.Start(), check.IsNil) + + // First read slowly + bytes1, err := consumeWithSpeed(stdout, 10, 50*time.Millisecond, stopSlowRead) + c.Assert(err, check.IsNil) + + // After the container has finished we can continue reading fast + bytes2, err := consumeWithSpeed(stdout, 32*1024, 0, nil) + c.Assert(err, check.IsNil) + + actual := bytes1 + bytes2 + expected := 200000 + if actual != expected { + c.Fatalf("Invalid bytes read: %d, expected %d", actual, expected) + } + +} + +func (s *DockerSuite) TestLogsFollowGoroutinesWithStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "while true; do echo hello; sleep 2; done") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + type info struct { + NGoroutines int + } + getNGoroutines := func() int { + var i info + status, b, err := sockRequest("GET", "/info", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, 200) + c.Assert(json.Unmarshal(b, &i), check.IsNil) + return i.NGoroutines + } + + nroutines := getNGoroutines() + + cmd := exec.Command(dockerBinary, "logs", "-f", id) + r, w := io.Pipe() + cmd.Stdout = w + c.Assert(cmd.Start(), check.IsNil) + + // Make sure pipe is written to + chErr := make(chan error) + go func() { + b := make([]byte, 1) + _, err := r.Read(b) + chErr <- err + }() + c.Assert(<-chErr, check.IsNil) + c.Assert(cmd.Process.Kill(), check.IsNil) + + // NGoroutines is not updated right away, so we need to wait before failing + t := time.After(30 * time.Second) + for { + select { + case <-t: + if n := getNGoroutines(); n > nroutines { + c.Fatalf("leaked goroutines: expected less than or equal to %d, got: %d", nroutines, n) + } + default: + if n := getNGoroutines(); n <= nroutines { + return + } + time.Sleep(200 * time.Millisecond) + } + } +} + +func (s *DockerSuite) TestLogsFollowGoroutinesNoOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "while true; do sleep 2; done") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + type info struct { + NGoroutines int + } + getNGoroutines := func() int { + var i info + status, b, err := sockRequest("GET", "/info", nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, 200) + c.Assert(json.Unmarshal(b, &i), check.IsNil) + return i.NGoroutines + } + + nroutines := getNGoroutines() + + cmd := exec.Command(dockerBinary, "logs", "-f", id) + c.Assert(cmd.Start(), check.IsNil) + time.Sleep(200 * time.Millisecond) + c.Assert(cmd.Process.Kill(), check.IsNil) + + // NGoroutines is not updated right away, so we need to wait before failing + t := time.After(30 * time.Second) + for { + select { + case <-t: + if n := getNGoroutines(); n > nroutines { + c.Fatalf("leaked goroutines: expected less than or equal to %d, got: %d", nroutines, n) + } + default: + if n := getNGoroutines(); n <= nroutines { + return + } + time.Sleep(200 * time.Millisecond) + } + } +} + +func (s *DockerSuite) TestLogsCLIContainerNotFound(c *check.C) { + name := "testlogsnocontainer" + out, _, _ := dockerCmdWithError("logs", name) + message := fmt.Sprintf(".*no such id: %s.*\n", name) + c.Assert(out, check.Matches, message) +} diff --git a/integration-cli/docker_cli_nat_test.go b/integration-cli/docker_cli_nat_test.go new file mode 100644 index 0000000000..10c45a1335 --- /dev/null +++ b/integration-cli/docker_cli_nat_test.go @@ -0,0 +1,111 @@ +package main + +import ( + "fmt" + "io/ioutil" + "net" + "strings" + + "github.com/go-check/check" +) + +func startServerContainer(c *check.C, msg string, port int) string { + name := "server" + cmd := []string{ + "-d", + "-p", fmt.Sprintf("%d:%d", port, port), + "busybox", + "sh", "-c", fmt.Sprintf("echo %q | nc -lp %d", msg, port), + } + if err := waitForContainer(name, cmd...); err != nil { + c.Fatalf("Failed to launch server container: %v", err) + } + return name +} + +func getExternalAddress(c *check.C) net.IP { + iface, err := net.InterfaceByName("eth0") + if err != nil { + c.Skip(fmt.Sprintf("Test not running with `make test`. Interface eth0 not found: %v", err)) + } + + ifaceAddrs, err := iface.Addrs() + if err != nil || len(ifaceAddrs) == 0 { + c.Fatalf("Error retrieving addresses for eth0: %v (%d addresses)", err, len(ifaceAddrs)) + } + + ifaceIP, _, err := net.ParseCIDR(ifaceAddrs[0].String()) + if err != nil { + c.Fatalf("Error retrieving the up for eth0: %s", err) + } + + return ifaceIP +} + +func getContainerLogs(c *check.C, containerID string) string { + out, _ := dockerCmd(c, "logs", containerID) + return strings.Trim(out, "\r\n") +} + +func getContainerStatus(c *check.C, containerID string) string { + out, err := inspectField(containerID, "State.Running") + c.Assert(err, check.IsNil) + return out +} + +func (s *DockerSuite) TestNetworkNat(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon, NativeExecDriver) + msg := "it works" + startServerContainer(c, msg, 8080) + endpoint := getExternalAddress(c) + conn, err := net.Dial("tcp", fmt.Sprintf("%s:%d", endpoint.String(), 8080)) + if err != nil { + c.Fatalf("Failed to connect to container (%v)", err) + } + data, err := ioutil.ReadAll(conn) + conn.Close() + if err != nil { + c.Fatal(err) + } + final := strings.TrimRight(string(data), "\n") + if final != msg { + c.Fatalf("Expected message %q but received %q", msg, final) + } +} + +func (s *DockerSuite) TestNetworkLocalhostTCPNat(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon, NativeExecDriver) + var ( + msg = "hi yall" + ) + startServerContainer(c, msg, 8081) + conn, err := net.Dial("tcp", "localhost:8081") + if err != nil { + c.Fatalf("Failed to connect to container (%v)", err) + } + data, err := ioutil.ReadAll(conn) + conn.Close() + if err != nil { + c.Fatal(err) + } + final := strings.TrimRight(string(data), "\n") + if final != msg { + c.Fatalf("Expected message %q but received %q", msg, final) + } +} + +func (s *DockerSuite) TestNetworkLoopbackNat(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon, NativeExecDriver, NotUserNamespace) + msg := "it works" + startServerContainer(c, msg, 8080) + endpoint := getExternalAddress(c) + out, _ := dockerCmd(c, "run", "-t", "--net=container:server", "busybox", + "sh", "-c", fmt.Sprintf("stty raw && nc -w 5 %s 8080", endpoint.String())) + final := strings.TrimRight(string(out), "\n") + if final != msg { + c.Fatalf("Expected message %q but received %q", msg, final) + } +} diff --git a/integration-cli/docker_cli_netmode_test.go b/integration-cli/docker_cli_netmode_test.go new file mode 100644 index 0000000000..7540a730ff --- /dev/null +++ b/integration-cli/docker_cli_netmode_test.go @@ -0,0 +1,165 @@ +package main + +import ( + "os/exec" + "strings" + + "github.com/docker/docker/runconfig" + "github.com/go-check/check" +) + +// GH14530. Validates combinations of --net= with other options + +// stringCheckPS is how the output of PS starts in order to validate that +// the command executed in a container did really run PS correctly. +const stringCheckPS = "PID USER" + +// checkContains is a helper function that validates a command output did +// contain what was expected. +func checkContains(expected string, out string, c *check.C) { + if !strings.Contains(out, expected) { + c.Fatalf("Expected '%s', got '%s'", expected, out) + } +} + +func (s *DockerSuite) TestNetHostname(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + + var ( + out string + err error + runCmd *exec.Cmd + ) + + runCmd = exec.Command(dockerBinary, "run", "-h=name", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err != nil { + c.Fatalf(out, err) + } + checkContains(stringCheckPS, out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=host", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err != nil { + c.Fatalf(out, err) + } + checkContains(stringCheckPS, out, c) + + runCmd = exec.Command(dockerBinary, "run", "-h=name", "--net=bridge", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err != nil { + c.Fatalf(out, err) + } + checkContains(stringCheckPS, out, c) + + runCmd = exec.Command(dockerBinary, "run", "-h=name", "--net=none", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err != nil { + c.Fatalf(out, err) + } + checkContains(stringCheckPS, out, c) + + runCmd = exec.Command(dockerBinary, "run", "-h=name", "--net=host", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkHostname.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "-h=name", "--net=container:other", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err, c) + } + checkContains(runconfig.ErrConflictNetworkHostname.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err, c) + } + checkContains("--net: invalid net mode: invalid container format container:", out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=weird", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains("network weird not found", out, c) +} + +func (s *DockerSuite) TestConflictContainerNetworkAndLinks(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + var ( + out string + err error + runCmd *exec.Cmd + ) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "--link=zip:zap", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictContainerNetworkAndLinks.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=host", "--link=zip:zap", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictHostNetworkAndLinks.Error(), out, c) +} + +func (s *DockerSuite) TestConflictNetworkModeAndOptions(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + var ( + out string + err error + runCmd *exec.Cmd + ) + + runCmd = exec.Command(dockerBinary, "run", "--net=host", "--dns=8.8.8.8", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkAndDNS.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "--dns=8.8.8.8", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkAndDNS.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=host", "--add-host=name:8.8.8.8", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkHosts.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "--add-host=name:8.8.8.8", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkHosts.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=host", "--mac-address=92:d0:c6:0a:29:33", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictContainerNetworkAndMac.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "--mac-address=92:d0:c6:0a:29:33", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictContainerNetworkAndMac.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "-P", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkPublishPorts.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "-p", "8080", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkPublishPorts.Error(), out, c) + + runCmd = exec.Command(dockerBinary, "run", "--net=container:other", "--expose", "8000-9000", "busybox", "ps") + if out, _, err = runCommandWithOutput(runCmd); err == nil { + c.Fatalf(out, err) + } + checkContains(runconfig.ErrConflictNetworkExposePorts.Error(), out, c) +} diff --git a/integration-cli/docker_cli_network_unix_test.go b/integration-cli/docker_cli_network_unix_test.go new file mode 100644 index 0000000000..d0b90eae9f --- /dev/null +++ b/integration-cli/docker_cli_network_unix_test.go @@ -0,0 +1,790 @@ +// +build !windows + +package main + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "net" + "net/http" + "net/http/httptest" + "os" + "strings" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/api/types/versions/v1p20" + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/runconfig" + "github.com/docker/libnetwork/driverapi" + remoteapi "github.com/docker/libnetwork/drivers/remote/api" + "github.com/docker/libnetwork/ipamapi" + remoteipam "github.com/docker/libnetwork/ipams/remote/api" + "github.com/docker/libnetwork/netlabel" + "github.com/go-check/check" + "github.com/vishvananda/netlink" +) + +const dummyNetworkDriver = "dummy-network-driver" +const dummyIpamDriver = "dummy-ipam-driver" + +var remoteDriverNetworkRequest remoteapi.CreateNetworkRequest + +func init() { + check.Suite(&DockerNetworkSuite{ + ds: &DockerSuite{}, + }) +} + +type DockerNetworkSuite struct { + server *httptest.Server + ds *DockerSuite + d *Daemon +} + +func (s *DockerNetworkSuite) SetUpTest(c *check.C) { + s.d = NewDaemon(c) +} + +func (s *DockerNetworkSuite) TearDownTest(c *check.C) { + s.d.Stop() + s.ds.TearDownTest(c) +} + +func (s *DockerNetworkSuite) SetUpSuite(c *check.C) { + mux := http.NewServeMux() + s.server = httptest.NewServer(mux) + c.Assert(s.server, check.NotNil, check.Commentf("Failed to start a HTTP Server")) + + mux.HandleFunc("/Plugin.Activate", func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, `{"Implements": ["%s", "%s"]}`, driverapi.NetworkPluginEndpointType, ipamapi.PluginEndpointType) + }) + + // Network driver implementation + mux.HandleFunc(fmt.Sprintf("/%s.GetCapabilities", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, `{"Scope":"local"}`) + }) + + mux.HandleFunc(fmt.Sprintf("/%s.CreateNetwork", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + err := json.NewDecoder(r.Body).Decode(&remoteDriverNetworkRequest) + if err != nil { + http.Error(w, "Unable to decode JSON payload: "+err.Error(), http.StatusBadRequest) + return + } + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, "null") + }) + + mux.HandleFunc(fmt.Sprintf("/%s.DeleteNetwork", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, "null") + }) + + mux.HandleFunc(fmt.Sprintf("/%s.CreateEndpoint", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, `{"Interface":{"MacAddress":"a0:b1:c2:d3:e4:f5"}}`) + }) + + mux.HandleFunc(fmt.Sprintf("/%s.Join", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + + veth := &netlink.Veth{ + LinkAttrs: netlink.LinkAttrs{Name: "randomIfName", TxQLen: 0}, PeerName: "cnt0"} + if err := netlink.LinkAdd(veth); err != nil { + fmt.Fprintf(w, `{"Error":"failed to add veth pair: `+err.Error()+`"}`) + } else { + fmt.Fprintf(w, `{"InterfaceName":{ "SrcName":"cnt0", "DstPrefix":"veth"}}`) + } + }) + + mux.HandleFunc(fmt.Sprintf("/%s.Leave", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, "null") + }) + + mux.HandleFunc(fmt.Sprintf("/%s.DeleteEndpoint", driverapi.NetworkPluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + if link, err := netlink.LinkByName("cnt0"); err == nil { + netlink.LinkDel(link) + } + fmt.Fprintf(w, "null") + }) + + // Ipam Driver implementation + var ( + poolRequest remoteipam.RequestPoolRequest + poolReleaseReq remoteipam.ReleasePoolRequest + addressRequest remoteipam.RequestAddressRequest + addressReleaseReq remoteipam.ReleaseAddressRequest + lAS = "localAS" + gAS = "globalAS" + pool = "172.28.0.0/16" + poolID = lAS + "/" + pool + gw = "172.28.255.254/16" + ) + + mux.HandleFunc(fmt.Sprintf("/%s.GetDefaultAddressSpaces", ipamapi.PluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintf(w, `{"LocalDefaultAddressSpace":"`+lAS+`", "GlobalDefaultAddressSpace": "`+gAS+`"}`) + }) + + mux.HandleFunc(fmt.Sprintf("/%s.RequestPool", ipamapi.PluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + err := json.NewDecoder(r.Body).Decode(&poolRequest) + if err != nil { + http.Error(w, "Unable to decode JSON payload: "+err.Error(), http.StatusBadRequest) + return + } + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + if poolRequest.AddressSpace != lAS && poolRequest.AddressSpace != gAS { + fmt.Fprintf(w, `{"Error":"Unknown address space in pool request: `+poolRequest.AddressSpace+`"}`) + } else if poolRequest.Pool != "" && poolRequest.Pool != pool { + fmt.Fprintf(w, `{"Error":"Cannot handle explicit pool requests yet"}`) + } else { + fmt.Fprintf(w, `{"PoolID":"`+poolID+`", "Pool":"`+pool+`"}`) + } + }) + + mux.HandleFunc(fmt.Sprintf("/%s.RequestAddress", ipamapi.PluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + err := json.NewDecoder(r.Body).Decode(&addressRequest) + if err != nil { + http.Error(w, "Unable to decode JSON payload: "+err.Error(), http.StatusBadRequest) + return + } + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + // make sure libnetwork is now querying on the expected pool id + if addressRequest.PoolID != poolID { + fmt.Fprintf(w, `{"Error":"unknown pool id"}`) + } else if addressRequest.Address != "" { + fmt.Fprintf(w, `{"Error":"Cannot handle explicit address requests yet"}`) + } else { + fmt.Fprintf(w, `{"Address":"`+gw+`"}`) + } + }) + + mux.HandleFunc(fmt.Sprintf("/%s.ReleaseAddress", ipamapi.PluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + err := json.NewDecoder(r.Body).Decode(&addressReleaseReq) + if err != nil { + http.Error(w, "Unable to decode JSON payload: "+err.Error(), http.StatusBadRequest) + return + } + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + // make sure libnetwork is now asking to release the expected address fro mthe expected poolid + if addressRequest.PoolID != poolID { + fmt.Fprintf(w, `{"Error":"unknown pool id"}`) + } else if addressReleaseReq.Address != gw { + fmt.Fprintf(w, `{"Error":"unknown address"}`) + } else { + fmt.Fprintf(w, "null") + } + }) + + mux.HandleFunc(fmt.Sprintf("/%s.ReleasePool", ipamapi.PluginEndpointType), func(w http.ResponseWriter, r *http.Request) { + err := json.NewDecoder(r.Body).Decode(&poolReleaseReq) + if err != nil { + http.Error(w, "Unable to decode JSON payload: "+err.Error(), http.StatusBadRequest) + return + } + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + // make sure libnetwork is now asking to release the expected poolid + if addressRequest.PoolID != poolID { + fmt.Fprintf(w, `{"Error":"unknown pool id"}`) + } else { + fmt.Fprintf(w, "null") + } + }) + + err := os.MkdirAll("/etc/docker/plugins", 0755) + c.Assert(err, checker.IsNil) + + fileName := fmt.Sprintf("/etc/docker/plugins/%s.spec", dummyNetworkDriver) + err = ioutil.WriteFile(fileName, []byte(s.server.URL), 0644) + c.Assert(err, checker.IsNil) + + ipamFileName := fmt.Sprintf("/etc/docker/plugins/%s.spec", dummyIpamDriver) + err = ioutil.WriteFile(ipamFileName, []byte(s.server.URL), 0644) + c.Assert(err, checker.IsNil) +} + +func (s *DockerNetworkSuite) TearDownSuite(c *check.C) { + if s.server == nil { + return + } + + s.server.Close() + + err := os.RemoveAll("/etc/docker/plugins") + c.Assert(err, checker.IsNil) +} + +func assertNwIsAvailable(c *check.C, name string) { + if !isNwPresent(c, name) { + c.Fatalf("Network %s not found in network ls o/p", name) + } +} + +func assertNwNotAvailable(c *check.C, name string) { + if isNwPresent(c, name) { + c.Fatalf("Found network %s in network ls o/p", name) + } +} + +func isNwPresent(c *check.C, name string) bool { + out, _ := dockerCmd(c, "network", "ls") + lines := strings.Split(out, "\n") + for i := 1; i < len(lines)-1; i++ { + if strings.Contains(lines[i], name) { + return true + } + } + return false +} + +func getNwResource(c *check.C, name string) *types.NetworkResource { + out, _ := dockerCmd(c, "network", "inspect", name) + nr := []types.NetworkResource{} + err := json.Unmarshal([]byte(out), &nr) + c.Assert(err, check.IsNil) + return &nr[0] +} + +func (s *DockerNetworkSuite) TestDockerNetworkLsDefault(c *check.C) { + defaults := []string{"bridge", "host", "none"} + for _, nn := range defaults { + assertNwIsAvailable(c, nn) + } +} + +func (s *DockerNetworkSuite) TestDockerNetworkCreateDelete(c *check.C) { + dockerCmd(c, "network", "create", "test") + assertNwIsAvailable(c, "test") + + dockerCmd(c, "network", "rm", "test") + assertNwNotAvailable(c, "test") +} + +func (s *DockerSuite) TestDockerInspectMultipleNetwork(c *check.C) { + out, _ := dockerCmd(c, "network", "inspect", "host", "none") + networkResources := []types.NetworkResource{} + err := json.Unmarshal([]byte(out), &networkResources) + c.Assert(err, check.IsNil) + c.Assert(networkResources, checker.HasLen, 2) + + // Should print an error, return an exitCode 1 *but* should print the host network + out, exitCode, err := dockerCmdWithError("network", "inspect", "host", "nonexistent") + c.Assert(err, checker.NotNil) + c.Assert(exitCode, checker.Equals, 1) + c.Assert(out, checker.Contains, "Error: No such network: nonexistent") + networkResources = []types.NetworkResource{} + inspectOut := strings.SplitN(out, "\n", 2)[1] + err = json.Unmarshal([]byte(inspectOut), &networkResources) + c.Assert(networkResources, checker.HasLen, 1) + + // Should print an error and return an exitCode, nothing else + out, exitCode, err = dockerCmdWithError("network", "inspect", "nonexistent") + c.Assert(err, checker.NotNil) + c.Assert(exitCode, checker.Equals, 1) + c.Assert(out, checker.Contains, "Error: No such network: nonexistent") +} + +func (s *DockerNetworkSuite) TestDockerNetworkConnectDisconnect(c *check.C) { + dockerCmd(c, "network", "create", "test") + assertNwIsAvailable(c, "test") + nr := getNwResource(c, "test") + + c.Assert(nr.Name, checker.Equals, "test") + c.Assert(len(nr.Containers), checker.Equals, 0) + + // run a container + out, _ := dockerCmd(c, "run", "-d", "--name", "test", "busybox", "top") + c.Assert(waitRun("test"), check.IsNil) + containerID := strings.TrimSpace(out) + + // connect the container to the test network + dockerCmd(c, "network", "connect", "test", containerID) + + // inspect the network to make sure container is connected + nr = getNetworkResource(c, nr.ID) + c.Assert(len(nr.Containers), checker.Equals, 1) + c.Assert(nr.Containers[containerID], check.NotNil) + + // check if container IP matches network inspect + ip, _, err := net.ParseCIDR(nr.Containers[containerID].IPv4Address) + c.Assert(err, check.IsNil) + containerIP := findContainerIP(c, "test", "test") + c.Assert(ip.String(), checker.Equals, containerIP) + + // disconnect container from the network + dockerCmd(c, "network", "disconnect", "test", containerID) + nr = getNwResource(c, "test") + c.Assert(nr.Name, checker.Equals, "test") + c.Assert(len(nr.Containers), checker.Equals, 0) + + // check if network connect fails for inactive containers + dockerCmd(c, "stop", containerID) + _, _, err = dockerCmdWithError("network", "connect", "test", containerID) + c.Assert(err, check.NotNil) + + dockerCmd(c, "network", "rm", "test") + assertNwNotAvailable(c, "test") +} + +func (s *DockerNetworkSuite) TestDockerNetworkIpamMultipleNetworks(c *check.C) { + // test0 bridge network + dockerCmd(c, "network", "create", "--subnet=192.168.0.0/16", "test1") + assertNwIsAvailable(c, "test1") + + // test2 bridge network does not overlap + dockerCmd(c, "network", "create", "--subnet=192.169.0.0/16", "test2") + assertNwIsAvailable(c, "test2") + + // for networks w/o ipam specified, docker will choose proper non-overlapping subnets + dockerCmd(c, "network", "create", "test3") + assertNwIsAvailable(c, "test3") + dockerCmd(c, "network", "create", "test4") + assertNwIsAvailable(c, "test4") + dockerCmd(c, "network", "create", "test5") + assertNwIsAvailable(c, "test5") + + // test network with multiple subnets + // bridge network doesnt support multiple subnets. hence, use a dummy driver that supports + + dockerCmd(c, "network", "create", "-d", dummyNetworkDriver, "--subnet=192.168.0.0/16", "--subnet=192.170.0.0/16", "test6") + assertNwIsAvailable(c, "test6") + + // test network with multiple subnets with valid ipam combinations + // also check same subnet across networks when the driver supports it. + dockerCmd(c, "network", "create", "-d", dummyNetworkDriver, + "--subnet=192.168.0.0/16", "--subnet=192.170.0.0/16", + "--gateway=192.168.0.100", "--gateway=192.170.0.100", + "--ip-range=192.168.1.0/24", + "--aux-address", "a=192.168.1.5", "--aux-address", "b=192.168.1.6", + "--aux-address", "a=192.170.1.5", "--aux-address", "b=192.170.1.6", + "test7") + assertNwIsAvailable(c, "test7") + + // cleanup + for i := 1; i < 8; i++ { + dockerCmd(c, "network", "rm", fmt.Sprintf("test%d", i)) + } +} + +func (s *DockerNetworkSuite) TestDockerNetworkCustomIpam(c *check.C) { + // Create a bridge network using custom ipam driver + dockerCmd(c, "network", "create", "--ipam-driver", dummyIpamDriver, "br0") + assertNwIsAvailable(c, "br0") + + // Verify expected network ipam fields are there + nr := getNetworkResource(c, "br0") + c.Assert(nr.Driver, checker.Equals, "bridge") + c.Assert(nr.IPAM.Driver, checker.Equals, dummyIpamDriver) + + // remove network and exercise remote ipam driver + dockerCmd(c, "network", "rm", "br0") + assertNwNotAvailable(c, "br0") +} + +func (s *DockerNetworkSuite) TestDockerNetworkInspect(c *check.C) { + // if unspecified, network gateway will be selected from inside preferred pool + dockerCmd(c, "network", "create", "--driver=bridge", "--subnet=172.28.0.0/16", "--ip-range=172.28.5.0/24", "--gateway=172.28.5.254", "br0") + assertNwIsAvailable(c, "br0") + + nr := getNetworkResource(c, "br0") + c.Assert(nr.Driver, checker.Equals, "bridge") + c.Assert(nr.Scope, checker.Equals, "local") + c.Assert(nr.IPAM.Driver, checker.Equals, "default") + c.Assert(len(nr.IPAM.Config), checker.Equals, 1) + c.Assert(nr.IPAM.Config[0].Subnet, checker.Equals, "172.28.0.0/16") + c.Assert(nr.IPAM.Config[0].IPRange, checker.Equals, "172.28.5.0/24") + c.Assert(nr.IPAM.Config[0].Gateway, checker.Equals, "172.28.5.254") + dockerCmd(c, "network", "rm", "br0") +} + +func (s *DockerNetworkSuite) TestDockerNetworkIpamInvalidCombinations(c *check.C) { + // network with ip-range out of subnet range + _, _, err := dockerCmdWithError("network", "create", "--subnet=192.168.0.0/16", "--ip-range=192.170.0.0/16", "test") + c.Assert(err, check.NotNil) + + // network with multiple gateways for a single subnet + _, _, err = dockerCmdWithError("network", "create", "--subnet=192.168.0.0/16", "--gateway=192.168.0.1", "--gateway=192.168.0.2", "test") + c.Assert(err, check.NotNil) + + // Multiple overlaping subnets in the same network must fail + _, _, err = dockerCmdWithError("network", "create", "--subnet=192.168.0.0/16", "--subnet=192.168.1.0/16", "test") + c.Assert(err, check.NotNil) + + // overlapping subnets across networks must fail + // create a valid test0 network + dockerCmd(c, "network", "create", "--subnet=192.168.0.0/16", "test0") + assertNwIsAvailable(c, "test0") + // create an overlapping test1 network + _, _, err = dockerCmdWithError("network", "create", "--subnet=192.168.128.0/17", "test1") + c.Assert(err, check.NotNil) + dockerCmd(c, "network", "rm", "test0") +} + +func (s *DockerNetworkSuite) TestDockerNetworkDriverOptions(c *check.C) { + dockerCmd(c, "network", "create", "-d", dummyNetworkDriver, "-o", "opt1=drv1", "-o", "opt2=drv2", "testopt") + assertNwIsAvailable(c, "testopt") + gopts := remoteDriverNetworkRequest.Options[netlabel.GenericData] + c.Assert(gopts, checker.NotNil) + opts, ok := gopts.(map[string]interface{}) + c.Assert(ok, checker.Equals, true) + c.Assert(opts["opt1"], checker.Equals, "drv1") + c.Assert(opts["opt2"], checker.Equals, "drv2") + dockerCmd(c, "network", "rm", "testopt") + +} + +func (s *DockerDaemonSuite) TestDockerNetworkNoDiscoveryDefaultBridgeNetwork(c *check.C) { + // On default bridge network built-in service discovery should not happen + hostsFile := "/etc/hosts" + bridgeName := "external-bridge" + bridgeIP := "192.169.255.254/24" + out, err := createInterface(c, "bridge", bridgeName, bridgeIP) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer deleteInterface(c, bridgeName) + + err = s.d.StartWithBusybox("--bridge", bridgeName) + c.Assert(err, check.IsNil) + defer s.d.Restart() + + // run two containers and store first container's etc/hosts content + out, err = s.d.Cmd("run", "-d", "busybox", "top") + c.Assert(err, check.IsNil) + cid1 := strings.TrimSpace(out) + defer s.d.Cmd("stop", cid1) + + hosts, err := s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + + out, err = s.d.Cmd("run", "-d", "--name", "container2", "busybox", "top") + c.Assert(err, check.IsNil) + cid2 := strings.TrimSpace(out) + + // verify first container's etc/hosts file has not changed after spawning the second named container + hostsPost, err := s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts), checker.Equals, string(hostsPost), + check.Commentf("Unexpected %s change on second container creation", hostsFile)) + + // stop container 2 and verify first container's etc/hosts has not changed + _, err = s.d.Cmd("stop", cid2) + c.Assert(err, check.IsNil) + + hostsPost, err = s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts), checker.Equals, string(hostsPost), + check.Commentf("Unexpected %s change on second container creation", hostsFile)) + + // but discovery is on when connecting to non default bridge network + network := "anotherbridge" + out, err = s.d.Cmd("network", "create", network) + c.Assert(err, check.IsNil, check.Commentf(out)) + defer s.d.Cmd("network", "rm", network) + + out, err = s.d.Cmd("network", "connect", network, cid1) + c.Assert(err, check.IsNil, check.Commentf(out)) + + hosts, err = s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + + hostsPost, err = s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts), checker.Equals, string(hostsPost), + check.Commentf("Unexpected %s change on second network connection", hostsFile)) + + cName := "container3" + out, err = s.d.Cmd("run", "-d", "--net", network, "--name", cName, "busybox", "top") + c.Assert(err, check.IsNil, check.Commentf(out)) + cid3 := strings.TrimSpace(out) + defer s.d.Cmd("stop", cid3) + + // container1 etc/hosts file should contain an entry for the third container + hostsPost, err = s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hostsPost), checker.Contains, cName, + check.Commentf("Container 1 %s file does not contain entries for named container %q: %s", hostsFile, cName, string(hostsPost))) + + // on container3 disconnect, first container's etc/hosts should go back to original form + out, err = s.d.Cmd("network", "disconnect", network, cid3) + c.Assert(err, check.IsNil, check.Commentf(out)) + + hostsPost, err = s.d.Cmd("exec", cid1, "cat", hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts), checker.Equals, string(hostsPost), + check.Commentf("Unexpected %s content after disconnecting from second network", hostsFile)) +} + +func (s *DockerNetworkSuite) TestDockerNetworkAnonymousEndpoint(c *check.C) { + hostsFile := "/etc/hosts" + cstmBridgeNw := "custom-bridge-nw" + cstmBridgeNw1 := "custom-bridge-nw1" + + dockerCmd(c, "network", "create", "-d", "bridge", cstmBridgeNw) + assertNwIsAvailable(c, cstmBridgeNw) + + // run two anonymous containers and store their etc/hosts content + out, _ := dockerCmd(c, "run", "-d", "--net", cstmBridgeNw, "busybox", "top") + cid1 := strings.TrimSpace(out) + + hosts1, err := readContainerFileWithExec(cid1, hostsFile) + c.Assert(err, checker.IsNil) + + out, _ = dockerCmd(c, "run", "-d", "--net", cstmBridgeNw, "busybox", "top") + cid2 := strings.TrimSpace(out) + + hosts2, err := readContainerFileWithExec(cid2, hostsFile) + c.Assert(err, checker.IsNil) + + // verify first container etc/hosts file has not changed + hosts1post, err := readContainerFileWithExec(cid1, hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts1), checker.Equals, string(hosts1post), + check.Commentf("Unexpected %s change on anonymous container creation", hostsFile)) + + // Connect the 2nd container to a new network and verify the + // first container /etc/hosts file still hasn't changed. + dockerCmd(c, "network", "create", "-d", "bridge", cstmBridgeNw1) + assertNwIsAvailable(c, cstmBridgeNw1) + + dockerCmd(c, "network", "connect", cstmBridgeNw1, cid2) + + hosts2, err = readContainerFileWithExec(cid2, hostsFile) + c.Assert(err, checker.IsNil) + + hosts1post, err = readContainerFileWithExec(cid1, hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts1), checker.Equals, string(hosts1post), + check.Commentf("Unexpected %s change on container connect", hostsFile)) + + // start a named container + cName := "AnyName" + out, _ = dockerCmd(c, "run", "-d", "--net", cstmBridgeNw, "--name", cName, "busybox", "top") + cid3 := strings.TrimSpace(out) + + // verify etc/hosts file for first two containers contains the named container entry + hosts1post, err = readContainerFileWithExec(cid1, hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts1post), checker.Contains, cName, + check.Commentf("Container 1 %s file does not contain entries for named container %q: %s", hostsFile, cName, string(hosts1post))) + + hosts2post, err := readContainerFileWithExec(cid2, hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts2post), checker.Contains, cName, + check.Commentf("Container 2 %s file does not contain entries for named container %q: %s", hostsFile, cName, string(hosts2post))) + + // Stop named container and verify first two containers' etc/hosts entries are back to original + dockerCmd(c, "stop", cid3) + hosts1post, err = readContainerFileWithExec(cid1, hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts1), checker.Equals, string(hosts1post), + check.Commentf("Unexpected %s change on anonymous container creation", hostsFile)) + + hosts2post, err = readContainerFileWithExec(cid2, hostsFile) + c.Assert(err, checker.IsNil) + c.Assert(string(hosts2), checker.Equals, string(hosts2post), + check.Commentf("Unexpected %s change on anonymous container creation", hostsFile)) +} + +func (s *DockerNetworkSuite) TestDockerNetworkLinkOndefaultNetworkOnly(c *check.C) { + // Link feature must work only on default network, and not across networks + cnt1 := "container1" + cnt2 := "container2" + network := "anotherbridge" + + // Run first container on default network + dockerCmd(c, "run", "-d", "--name", cnt1, "busybox", "top") + + // Create another network and run the second container on it + dockerCmd(c, "network", "create", network) + assertNwIsAvailable(c, network) + dockerCmd(c, "run", "-d", "--net", network, "--name", cnt2, "busybox", "top") + + // Try launching a container on default network, linking to the first container. Must succeed + dockerCmd(c, "run", "-d", "--link", fmt.Sprintf("%s:%s", cnt1, cnt1), "busybox", "top") + + // Try launching a container on default network, linking to the second container. Must fail + _, _, err := dockerCmdWithError("run", "-d", "--link", fmt.Sprintf("%s:%s", cnt2, cnt2), "busybox", "top") + c.Assert(err, checker.NotNil) + + // Connect second container to default network. Now a container on default network can link to it + dockerCmd(c, "network", "connect", "bridge", cnt2) + dockerCmd(c, "run", "-d", "--link", fmt.Sprintf("%s:%s", cnt2, cnt2), "busybox", "top") +} + +func (s *DockerNetworkSuite) TestDockerNetworkOverlayPortMapping(c *check.C) { + // Verify exposed ports are present in ps output when running a container on + // a network managed by a driver which does not provide the default gateway + // for the container + nwn := "ov" + ctn := "bb" + port1 := 80 + port2 := 443 + expose1 := fmt.Sprintf("--expose=%d", port1) + expose2 := fmt.Sprintf("--expose=%d", port2) + + dockerCmd(c, "network", "create", "-d", dummyNetworkDriver, nwn) + assertNwIsAvailable(c, nwn) + + dockerCmd(c, "run", "-d", "--net", nwn, "--name", ctn, expose1, expose2, "busybox", "top") + + // Check docker ps o/p for last created container reports the unpublished ports + unpPort1 := fmt.Sprintf("%d/tcp", port1) + unpPort2 := fmt.Sprintf("%d/tcp", port2) + out, _ := dockerCmd(c, "ps", "-n=1") + // Missing unpublished ports in docker ps output + c.Assert(out, checker.Contains, unpPort1) + // Missing unpublished ports in docker ps output + c.Assert(out, checker.Contains, unpPort2) +} + +func (s *DockerNetworkSuite) TestDockerNetworkMacInspect(c *check.C) { + // Verify endpoint MAC address is correctly populated in container's network settings + nwn := "ov" + ctn := "bb" + + dockerCmd(c, "network", "create", "-d", dummyNetworkDriver, nwn) + assertNwIsAvailable(c, nwn) + + dockerCmd(c, "run", "-d", "--net", nwn, "--name", ctn, "busybox", "top") + + mac, err := inspectField(ctn, "NetworkSettings.Networks."+nwn+".MacAddress") + c.Assert(err, checker.IsNil) + c.Assert(mac, checker.Equals, "a0:b1:c2:d3:e4:f5") +} + +func (s *DockerSuite) TestInspectApiMultipeNetworks(c *check.C) { + dockerCmd(c, "network", "create", "mybridge1") + dockerCmd(c, "network", "create", "mybridge2") + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + + dockerCmd(c, "network", "connect", "mybridge1", id) + dockerCmd(c, "network", "connect", "mybridge2", id) + + body := getInspectBody(c, "v1.20", id) + var inspect120 v1p20.ContainerJSON + err := json.Unmarshal(body, &inspect120) + c.Assert(err, checker.IsNil) + + versionedIP := inspect120.NetworkSettings.IPAddress + + body = getInspectBody(c, "v1.21", id) + var inspect121 types.ContainerJSON + err = json.Unmarshal(body, &inspect121) + c.Assert(err, checker.IsNil) + c.Assert(inspect121.NetworkSettings.Networks, checker.HasLen, 3) + + bridge := inspect121.NetworkSettings.Networks["bridge"] + c.Assert(bridge.IPAddress, checker.Equals, versionedIP) + c.Assert(bridge.IPAddress, checker.Equals, inspect121.NetworkSettings.IPAddress) +} + +func connectContainerToNetworks(c *check.C, d *Daemon, cName string, nws []string) { + // Run a container on the default network + out, err := d.Cmd("run", "-d", "--name", cName, "busybox", "top") + c.Assert(err, checker.IsNil, check.Commentf(out)) + + // Attach the container to other three networks + for _, nw := range nws { + out, err = d.Cmd("network", "create", nw) + c.Assert(err, checker.IsNil, check.Commentf(out)) + out, err = d.Cmd("network", "connect", nw, cName) + c.Assert(err, checker.IsNil, check.Commentf(out)) + } +} + +func verifyContainerIsConnectedToNetworks(c *check.C, d *Daemon, cName string, nws []string) { + // Verify container is connected to all three networks + for _, nw := range nws { + out, err := d.Cmd("inspect", "-f", fmt.Sprintf("{{.NetworkSettings.Networks.%s}}", nw), cName) + c.Assert(err, checker.IsNil, check.Commentf(out)) + c.Assert(out, checker.Not(checker.Equals), "\n") + } +} + +func (s *DockerNetworkSuite) TestDockerNetworkMultipleNetworksGracefulDaemonRestart(c *check.C) { + cName := "bb" + nwList := []string{"nw1", "nw2", "nw3"} + + s.d.Start() + + connectContainerToNetworks(c, s.d, cName, nwList) + verifyContainerIsConnectedToNetworks(c, s.d, cName, nwList) + + // Reload daemon + s.d.Restart() + + _, err := s.d.Cmd("start", cName) + c.Assert(err, checker.IsNil) + + verifyContainerIsConnectedToNetworks(c, s.d, cName, nwList) +} + +func (s *DockerNetworkSuite) TestDockerNetworkMultipleNetworksUngracefulDaemonRestart(c *check.C) { + cName := "cc" + nwList := []string{"nw1", "nw2", "nw3"} + + s.d.Start() + + connectContainerToNetworks(c, s.d, cName, nwList) + verifyContainerIsConnectedToNetworks(c, s.d, cName, nwList) + + // Kill daemon and restart + if err := s.d.cmd.Process.Kill(); err != nil { + c.Fatal(err) + } + s.d.Restart() + + // Restart container + _, err := s.d.Cmd("start", cName) + c.Assert(err, checker.IsNil) + + verifyContainerIsConnectedToNetworks(c, s.d, cName, nwList) +} + +func (s *DockerNetworkSuite) TestDockerNetworkRunNetByID(c *check.C) { + out, _ := dockerCmd(c, "network", "create", "one") + dockerCmd(c, "run", "-d", "--net", strings.TrimSpace(out), "busybox", "top") +} + +func (s *DockerNetworkSuite) TestDockerNetworkConnectToHostFromOtherNetwork(c *check.C) { + dockerCmd(c, "run", "-d", "--name", "container1", "busybox", "top") + c.Assert(waitRun("container1"), check.IsNil) + dockerCmd(c, "network", "disconnect", "bridge", "container1") + out, _, err := dockerCmdWithError("network", "connect", "host", "container1") + c.Assert(err, checker.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, runconfig.ErrConflictHostNetwork.Error()) +} + +func (s *DockerNetworkSuite) TestDockerNetworkDisconnectFromHost(c *check.C) { + dockerCmd(c, "run", "-d", "--name", "container1", "--net=host", "busybox", "top") + c.Assert(waitRun("container1"), check.IsNil) + out, _, err := dockerCmdWithError("network", "disconnect", "host", "container1") + c.Assert(err, checker.NotNil, check.Commentf("Should err out disconnect from host")) + c.Assert(out, checker.Contains, runconfig.ErrConflictHostNetwork.Error()) +} + +func (s *DockerNetworkSuite) TestDockerNetworkConnectWithPortMapping(c *check.C) { + dockerCmd(c, "network", "create", "test1") + dockerCmd(c, "run", "-d", "--name", "c1", "-p", "5000:5000", "busybox", "top") + c.Assert(waitRun("c1"), check.IsNil) + dockerCmd(c, "network", "connect", "test1", "c1") +} + +func (s *DockerNetworkSuite) TestDockerNetworkConnectWithMac(c *check.C) { + macAddress := "02:42:ac:11:00:02" + dockerCmd(c, "network", "create", "mynetwork") + dockerCmd(c, "run", "--name=test", "-d", "--mac-address", macAddress, "busybox", "top") + c.Assert(waitRun("test"), check.IsNil) + mac1, err := inspectField("test", "NetworkSettings.Networks.bridge.MacAddress") + c.Assert(err, checker.IsNil) + c.Assert(strings.TrimSpace(mac1), checker.Equals, macAddress) + dockerCmd(c, "network", "connect", "mynetwork", "test") + mac2, err := inspectField("test", "NetworkSettings.Networks.mynetwork.MacAddress") + c.Assert(err, checker.IsNil) + c.Assert(strings.TrimSpace(mac2), checker.Not(checker.Equals), strings.TrimSpace(mac1)) +} diff --git a/integration-cli/docker_cli_pause_test.go b/integration-cli/docker_cli_pause_test.go new file mode 100644 index 0000000000..c7487ee03e --- /dev/null +++ b/integration-cli/docker_cli_pause_test.go @@ -0,0 +1,92 @@ +package main + +import ( + "fmt" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestPause(c *check.C) { + testRequires(c, DaemonIsLinux) + defer unpauseAllContainers() + + name := "testeventpause" + dockerCmd(c, "run", "-d", "--name", name, "busybox", "top") + + dockerCmd(c, "pause", name) + pausedContainers, err := getSliceOfPausedContainers() + if err != nil { + c.Fatalf("error thrown while checking if containers were paused: %v", err) + } + if len(pausedContainers) != 1 { + c.Fatalf("there should be one paused container and not %d", len(pausedContainers)) + } + + dockerCmd(c, "unpause", name) + + out, _ := dockerCmd(c, "events", "--since=0", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + if len(events) <= 1 { + c.Fatalf("Missing expected event") + } + + pauseEvent := strings.Fields(events[len(events)-3]) + unpauseEvent := strings.Fields(events[len(events)-2]) + + if pauseEvent[len(pauseEvent)-1] != "pause" { + c.Fatalf("event should be pause, not %#v", pauseEvent) + } + if unpauseEvent[len(unpauseEvent)-1] != "unpause" { + c.Fatalf("event should be unpause, not %#v", unpauseEvent) + } + +} + +func (s *DockerSuite) TestPauseMultipleContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + defer unpauseAllContainers() + + containers := []string{ + "testpausewithmorecontainers1", + "testpausewithmorecontainers2", + } + for _, name := range containers { + dockerCmd(c, "run", "-d", "--name", name, "busybox", "top") + } + dockerCmd(c, append([]string{"pause"}, containers...)...) + pausedContainers, err := getSliceOfPausedContainers() + if err != nil { + c.Fatalf("error thrown while checking if containers were paused: %v", err) + } + if len(pausedContainers) != len(containers) { + c.Fatalf("there should be %d paused container and not %d", len(containers), len(pausedContainers)) + } + + dockerCmd(c, append([]string{"unpause"}, containers...)...) + + out, _ := dockerCmd(c, "events", "--since=0", fmt.Sprintf("--until=%d", daemonTime(c).Unix())) + events := strings.Split(out, "\n") + if len(events) <= len(containers)*3-2 { + c.Fatalf("Missing expected event") + } + + pauseEvents := make([][]string, len(containers)) + unpauseEvents := make([][]string, len(containers)) + for i := range containers { + pauseEvents[i] = strings.Fields(events[len(events)-len(containers)*2-1+i]) + unpauseEvents[i] = strings.Fields(events[len(events)-len(containers)-1+i]) + } + + for _, pauseEvent := range pauseEvents { + if pauseEvent[len(pauseEvent)-1] != "pause" { + c.Fatalf("event should be pause, not %#v", pauseEvent) + } + } + for _, unpauseEvent := range unpauseEvents { + if unpauseEvent[len(unpauseEvent)-1] != "unpause" { + c.Fatalf("event should be unpause, not %#v", unpauseEvent) + } + } + +} diff --git a/integration-cli/docker_cli_port_test.go b/integration-cli/docker_cli_port_test.go new file mode 100644 index 0000000000..9736bc8625 --- /dev/null +++ b/integration-cli/docker_cli_port_test.go @@ -0,0 +1,297 @@ +package main + +import ( + "fmt" + "net" + "regexp" + "sort" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestPortList(c *check.C) { + testRequires(c, DaemonIsLinux) + // one port + out, _ := dockerCmd(c, "run", "-d", "-p", "9876:80", "busybox", "top") + firstID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", firstID, "80") + + if !assertPortList(c, out, []string{"0.0.0.0:9876"}) { + c.Error("Port list is not correct") + } + + out, _ = dockerCmd(c, "port", firstID) + + if !assertPortList(c, out, []string{"80/tcp -> 0.0.0.0:9876"}) { + c.Error("Port list is not correct") + } + dockerCmd(c, "rm", "-f", firstID) + + // three port + out, _ = dockerCmd(c, "run", "-d", + "-p", "9876:80", + "-p", "9877:81", + "-p", "9878:82", + "busybox", "top") + ID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", ID, "80") + + if !assertPortList(c, out, []string{"0.0.0.0:9876"}) { + c.Error("Port list is not correct") + } + + out, _ = dockerCmd(c, "port", ID) + + if !assertPortList(c, out, []string{ + "80/tcp -> 0.0.0.0:9876", + "81/tcp -> 0.0.0.0:9877", + "82/tcp -> 0.0.0.0:9878"}) { + c.Error("Port list is not correct") + } + dockerCmd(c, "rm", "-f", ID) + + // more and one port mapped to the same container port + out, _ = dockerCmd(c, "run", "-d", + "-p", "9876:80", + "-p", "9999:80", + "-p", "9877:81", + "-p", "9878:82", + "busybox", "top") + ID = strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", ID, "80") + + if !assertPortList(c, out, []string{"0.0.0.0:9876", "0.0.0.0:9999"}) { + c.Error("Port list is not correct") + } + + out, _ = dockerCmd(c, "port", ID) + + if !assertPortList(c, out, []string{ + "80/tcp -> 0.0.0.0:9876", + "80/tcp -> 0.0.0.0:9999", + "81/tcp -> 0.0.0.0:9877", + "82/tcp -> 0.0.0.0:9878"}) { + c.Error("Port list is not correct\n", out) + } + dockerCmd(c, "rm", "-f", ID) + + testRange := func() { + // host port ranges used + IDs := make([]string, 3) + for i := 0; i < 3; i++ { + out, _ = dockerCmd(c, "run", "-d", + "-p", "9090-9092:80", + "busybox", "top") + IDs[i] = strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", IDs[i]) + + if !assertPortList(c, out, []string{ + fmt.Sprintf("80/tcp -> 0.0.0.0:%d", 9090+i)}) { + c.Error("Port list is not correct\n", out) + } + } + + // test port range exhaustion + out, _, err := dockerCmdWithError("run", "-d", + "-p", "9090-9092:80", + "busybox", "top") + if err == nil { + c.Errorf("Exhausted port range did not return an error. Out: %s", out) + } + + for i := 0; i < 3; i++ { + dockerCmd(c, "rm", "-f", IDs[i]) + } + } + testRange() + // Verify we ran re-use port ranges after they are no longer in use. + testRange() + + // test invalid port ranges + for _, invalidRange := range []string{"9090-9089:80", "9090-:80", "-9090:80"} { + out, _, err := dockerCmdWithError("run", "-d", + "-p", invalidRange, + "busybox", "top") + if err == nil { + c.Errorf("Port range should have returned an error. Out: %s", out) + } + } + + // test host range:container range spec. + out, _ = dockerCmd(c, "run", "-d", + "-p", "9800-9803:80-83", + "busybox", "top") + ID = strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", ID) + + if !assertPortList(c, out, []string{ + "80/tcp -> 0.0.0.0:9800", + "81/tcp -> 0.0.0.0:9801", + "82/tcp -> 0.0.0.0:9802", + "83/tcp -> 0.0.0.0:9803"}) { + c.Error("Port list is not correct\n", out) + } + dockerCmd(c, "rm", "-f", ID) + + // test mixing protocols in same port range + out, _ = dockerCmd(c, "run", "-d", + "-p", "8000-8080:80", + "-p", "8000-8080:80/udp", + "busybox", "top") + ID = strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", ID) + + if !assertPortList(c, out, []string{ + "80/tcp -> 0.0.0.0:8000", + "80/udp -> 0.0.0.0:8000"}) { + c.Error("Port list is not correct\n", out) + } + dockerCmd(c, "rm", "-f", ID) +} + +func assertPortList(c *check.C, out string, expected []string) bool { + //lines := strings.Split(out, "\n") + lines := strings.Split(strings.Trim(out, "\n "), "\n") + if len(lines) != len(expected) { + c.Errorf("different size lists %s, %d, %d", out, len(lines), len(expected)) + return false + } + sort.Strings(lines) + sort.Strings(expected) + + for i := 0; i < len(expected); i++ { + if lines[i] != expected[i] { + c.Error("|" + lines[i] + "!=" + expected[i] + "|") + return false + } + } + + return true +} + +func stopRemoveContainer(id string, c *check.C) { + dockerCmd(c, "rm", "-f", id) +} + +func (s *DockerSuite) TestUnpublishedPortsInPsOutput(c *check.C) { + testRequires(c, DaemonIsLinux) + // Run busybox with command line expose (equivalent to EXPOSE in image's Dockerfile) for the following ports + port1 := 80 + port2 := 443 + expose1 := fmt.Sprintf("--expose=%d", port1) + expose2 := fmt.Sprintf("--expose=%d", port2) + dockerCmd(c, "run", "-d", expose1, expose2, "busybox", "sleep", "5") + + // Check docker ps o/p for last created container reports the unpublished ports + unpPort1 := fmt.Sprintf("%d/tcp", port1) + unpPort2 := fmt.Sprintf("%d/tcp", port2) + out, _ := dockerCmd(c, "ps", "-n=1") + if !strings.Contains(out, unpPort1) || !strings.Contains(out, unpPort2) { + c.Errorf("Missing unpublished ports(s) (%s, %s) in docker ps output: %s", unpPort1, unpPort2, out) + } + + // Run the container forcing to publish the exposed ports + dockerCmd(c, "run", "-d", "-P", expose1, expose2, "busybox", "sleep", "5") + + // Check docker ps o/p for last created container reports the exposed ports in the port bindings + expBndRegx1 := regexp.MustCompile(`0.0.0.0:\d\d\d\d\d->` + unpPort1) + expBndRegx2 := regexp.MustCompile(`0.0.0.0:\d\d\d\d\d->` + unpPort2) + out, _ = dockerCmd(c, "ps", "-n=1") + if !expBndRegx1.MatchString(out) || !expBndRegx2.MatchString(out) { + c.Errorf("Cannot find expected port binding ports(s) (0.0.0.0:xxxxx->%s, 0.0.0.0:xxxxx->%s) in docker ps output:\n%s", + unpPort1, unpPort2, out) + } + + // Run the container specifying explicit port bindings for the exposed ports + offset := 10000 + pFlag1 := fmt.Sprintf("%d:%d", offset+port1, port1) + pFlag2 := fmt.Sprintf("%d:%d", offset+port2, port2) + out, _ = dockerCmd(c, "run", "-d", "-p", pFlag1, "-p", pFlag2, expose1, expose2, "busybox", "sleep", "5") + id := strings.TrimSpace(out) + + // Check docker ps o/p for last created container reports the specified port mappings + expBnd1 := fmt.Sprintf("0.0.0.0:%d->%s", offset+port1, unpPort1) + expBnd2 := fmt.Sprintf("0.0.0.0:%d->%s", offset+port2, unpPort2) + out, _ = dockerCmd(c, "ps", "-n=1") + if !strings.Contains(out, expBnd1) || !strings.Contains(out, expBnd2) { + c.Errorf("Cannot find expected port binding(s) (%s, %s) in docker ps output: %s", expBnd1, expBnd2, out) + } + // Remove container now otherwise it will interfeer with next test + stopRemoveContainer(id, c) + + // Run the container with explicit port bindings and no exposed ports + out, _ = dockerCmd(c, "run", "-d", "-p", pFlag1, "-p", pFlag2, "busybox", "sleep", "5") + id = strings.TrimSpace(out) + + // Check docker ps o/p for last created container reports the specified port mappings + out, _ = dockerCmd(c, "ps", "-n=1") + if !strings.Contains(out, expBnd1) || !strings.Contains(out, expBnd2) { + c.Errorf("Cannot find expected port binding(s) (%s, %s) in docker ps output: %s", expBnd1, expBnd2, out) + } + // Remove container now otherwise it will interfeer with next test + stopRemoveContainer(id, c) + + // Run the container with one unpublished exposed port and one explicit port binding + dockerCmd(c, "run", "-d", expose1, "-p", pFlag2, "busybox", "sleep", "5") + + // Check docker ps o/p for last created container reports the specified unpublished port and port mapping + out, _ = dockerCmd(c, "ps", "-n=1") + if !strings.Contains(out, unpPort1) || !strings.Contains(out, expBnd2) { + c.Errorf("Missing unpublished ports or port binding (%s, %s) in docker ps output: %s", unpPort1, expBnd2, out) + } +} + +func (s *DockerSuite) TestPortHostBinding(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "-d", "-p", "9876:80", "busybox", + "nc", "-l", "-p", "80") + firstID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", firstID, "80") + + if !assertPortList(c, out, []string{"0.0.0.0:9876"}) { + c.Error("Port list is not correct") + } + + dockerCmd(c, "run", "--net=host", "busybox", + "nc", "localhost", "9876") + + dockerCmd(c, "rm", "-f", firstID) + + if _, _, err := dockerCmdWithError("run", "--net=host", "busybox", + "nc", "localhost", "9876"); err == nil { + c.Error("Port is still bound after the Container is removed") + } +} + +func (s *DockerSuite) TestPortExposeHostBinding(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "-d", "-P", "--expose", "80", "busybox", + "nc", "-l", "-p", "80") + firstID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "port", firstID, "80") + + _, exposedPort, err := net.SplitHostPort(out) + + if err != nil { + c.Fatal(out, err) + } + + dockerCmd(c, "run", "--net=host", "busybox", + "nc", "localhost", strings.TrimSpace(exposedPort)) + + dockerCmd(c, "rm", "-f", firstID) + + if _, _, err = dockerCmdWithError("run", "--net=host", "busybox", + "nc", "localhost", strings.TrimSpace(exposedPort)); err == nil { + c.Error("Port is still bound after the Container is removed") + } +} diff --git a/integration-cli/docker_cli_proxy_test.go b/integration-cli/docker_cli_proxy_test.go new file mode 100644 index 0000000000..e0b60fcc59 --- /dev/null +++ b/integration-cli/docker_cli_proxy_test.go @@ -0,0 +1,53 @@ +package main + +import ( + "net" + "os/exec" + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestCliProxyDisableProxyUnixSock(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) // test is valid when DOCKER_HOST=unix://.. + + cmd := exec.Command(dockerBinary, "info") + cmd.Env = appendBaseEnv([]string{"HTTP_PROXY=http://127.0.0.1:9999"}) + + out, _, err := runCommandWithOutput(cmd) + c.Assert(err, checker.IsNil, check.Commentf("%v", out)) + +} + +// Can't use localhost here since go has a special case to not use proxy if connecting to localhost +// See https://golang.org/pkg/net/http/#ProxyFromEnvironment +func (s *DockerDaemonSuite) TestCliProxyProxyTCPSock(c *check.C) { + testRequires(c, SameHostDaemon) + // get the IP to use to connect since we can't use localhost + addrs, err := net.InterfaceAddrs() + c.Assert(err, checker.IsNil) + var ip string + for _, addr := range addrs { + sAddr := addr.String() + if !strings.Contains(sAddr, "127.0.0.1") { + addrArr := strings.Split(sAddr, "/") + ip = addrArr[0] + break + } + } + + c.Assert(ip, checker.Not(checker.Equals), "") + + err = s.d.Start("-H", "tcp://"+ip+":2375") + c.Assert(err, checker.IsNil) + cmd := exec.Command(dockerBinary, "info") + cmd.Env = []string{"DOCKER_HOST=tcp://" + ip + ":2375", "HTTP_PROXY=127.0.0.1:9999"} + out, _, err := runCommandWithOutput(cmd) + c.Assert(err, checker.NotNil, check.Commentf("%v", out)) + // Test with no_proxy + cmd.Env = append(cmd.Env, "NO_PROXY="+ip) + out, _, err = runCommandWithOutput(exec.Command(dockerBinary, "info")) + c.Assert(err, checker.IsNil, check.Commentf("%v", out)) +} diff --git a/integration-cli/docker_cli_ps_test.go b/integration-cli/docker_cli_ps_test.go new file mode 100644 index 0000000000..5f467419b7 --- /dev/null +++ b/integration-cli/docker_cli_ps_test.go @@ -0,0 +1,751 @@ +package main + +import ( + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "reflect" + "strconv" + "strings" + "time" + + "github.com/go-check/check" + "sort" + + "github.com/docker/docker/pkg/stringid" +) + +func (s *DockerSuite) TestPsListContainersBase(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + firstID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "-d", "busybox", "top") + secondID := strings.TrimSpace(out) + + // not long running + out, _ = dockerCmd(c, "run", "-d", "busybox", "true") + thirdID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "run", "-d", "busybox", "top") + fourthID := strings.TrimSpace(out) + + // make sure the second is running + c.Assert(waitRun(secondID), check.IsNil) + + // make sure third one is not running + dockerCmd(c, "wait", thirdID) + + // make sure the forth is running + c.Assert(waitRun(fourthID), check.IsNil) + + // all + out, _ = dockerCmd(c, "ps", "-a") + if !assertContainerList(out, []string{fourthID, thirdID, secondID, firstID}) { + c.Errorf("ALL: Container list is not in the correct order: \n%s", out) + } + + // running + out, _ = dockerCmd(c, "ps") + if !assertContainerList(out, []string{fourthID, secondID, firstID}) { + c.Errorf("RUNNING: Container list is not in the correct order: \n%s", out) + } + + // from here all flag '-a' is ignored + + // limit + out, _ = dockerCmd(c, "ps", "-n=2", "-a") + expected := []string{fourthID, thirdID} + if !assertContainerList(out, expected) { + c.Errorf("LIMIT & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "-n=2") + if !assertContainerList(out, expected) { + c.Errorf("LIMIT: Container list is not in the correct order: \n%s", out) + } + + // since + out, _ = dockerCmd(c, "ps", "--since", firstID, "-a") + expected = []string{fourthID, thirdID, secondID} + if !assertContainerList(out, expected) { + c.Errorf("SINCE & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--since", firstID) + if !assertContainerList(out, expected) { + c.Errorf("SINCE: Container list is not in the correct order: \n%s", out) + } + + // before + out, _ = dockerCmd(c, "ps", "--before", thirdID, "-a") + expected = []string{secondID, firstID} + if !assertContainerList(out, expected) { + c.Errorf("BEFORE & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--before", thirdID) + if !assertContainerList(out, expected) { + c.Errorf("BEFORE: Container list is not in the correct order: \n%s", out) + } + + // since & before + out, _ = dockerCmd(c, "ps", "--since", firstID, "--before", fourthID, "-a") + expected = []string{thirdID, secondID} + if !assertContainerList(out, expected) { + c.Errorf("SINCE, BEFORE & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--since", firstID, "--before", fourthID) + if !assertContainerList(out, expected) { + c.Errorf("SINCE, BEFORE: Container list is not in the correct order: \n%s", out) + } + + // since & limit + out, _ = dockerCmd(c, "ps", "--since", firstID, "-n=2", "-a") + expected = []string{fourthID, thirdID} + + if !assertContainerList(out, expected) { + c.Errorf("SINCE, LIMIT & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--since", firstID, "-n=2") + if !assertContainerList(out, expected) { + c.Errorf("SINCE, LIMIT: Container list is not in the correct order: \n%s", out) + } + + // before & limit + out, _ = dockerCmd(c, "ps", "--before", fourthID, "-n=1", "-a") + expected = []string{thirdID} + if !assertContainerList(out, expected) { + c.Errorf("BEFORE, LIMIT & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--before", fourthID, "-n=1") + if !assertContainerList(out, expected) { + c.Errorf("BEFORE, LIMIT: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--since", firstID, "--before", fourthID, "-n=1", "-a") + expected = []string{thirdID} + if !assertContainerList(out, expected) { + c.Errorf("SINCE, BEFORE, LIMIT & ALL: Container list is not in the correct order: \n%s", out) + } + + out, _ = dockerCmd(c, "ps", "--since", firstID, "--before", fourthID, "-n=1") + if !assertContainerList(out, expected) { + c.Errorf("SINCE, BEFORE, LIMIT: Container list is not in the correct order: \n%s", out) + } + +} + +func assertContainerList(out string, expected []string) bool { + lines := strings.Split(strings.Trim(out, "\n "), "\n") + if len(lines)-1 != len(expected) { + return false + } + + containerIDIndex := strings.Index(lines[0], "CONTAINER ID") + for i := 0; i < len(expected); i++ { + foundID := lines[i+1][containerIDIndex : containerIDIndex+12] + if foundID != expected[i][:12] { + return false + } + } + + return true +} + +func (s *DockerSuite) TestPsListContainersSize(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "busybox", "echo", "hello") + + baseOut, _ := dockerCmd(c, "ps", "-s", "-n=1") + baseLines := strings.Split(strings.Trim(baseOut, "\n "), "\n") + baseSizeIndex := strings.Index(baseLines[0], "SIZE") + baseFoundsize := baseLines[1][baseSizeIndex:] + baseBytes, err := strconv.Atoi(strings.Split(baseFoundsize, " ")[0]) + if err != nil { + c.Fatal(err) + } + + name := "test_size" + out, _ := dockerCmd(c, "run", "--name", name, "busybox", "sh", "-c", "echo 1 > test") + id, err := getIDByName(name) + if err != nil { + c.Fatal(err) + } + + runCmd := exec.Command(dockerBinary, "ps", "-s", "-n=1") + + wait := make(chan struct{}) + go func() { + out, _, err = runCommandWithOutput(runCmd) + close(wait) + }() + select { + case <-wait: + case <-time.After(3 * time.Second): + c.Fatalf("Calling \"docker ps -s\" timed out!") + } + if err != nil { + c.Fatal(out, err) + } + lines := strings.Split(strings.Trim(out, "\n "), "\n") + if len(lines) != 2 { + c.Fatalf("Expected 2 lines for 'ps -s -n=1' output, got %d", len(lines)) + } + sizeIndex := strings.Index(lines[0], "SIZE") + idIndex := strings.Index(lines[0], "CONTAINER ID") + foundID := lines[1][idIndex : idIndex+12] + if foundID != id[:12] { + c.Fatalf("Expected id %s, got %s", id[:12], foundID) + } + expectedSize := fmt.Sprintf("%d B", (2 + baseBytes)) + foundSize := lines[1][sizeIndex:] + if !strings.Contains(foundSize, expectedSize) { + c.Fatalf("Expected size %q, got %q", expectedSize, foundSize) + } + +} + +func (s *DockerSuite) TestPsListContainersFilterStatus(c *check.C) { + testRequires(c, DaemonIsLinux) + // FIXME: this should test paused, but it makes things hang and its wonky + // this is because paused containers can't be controlled by signals + + // start exited container + out, _ := dockerCmd(c, "run", "-d", "busybox") + firstID := strings.TrimSpace(out) + + // make sure the exited cintainer is not running + dockerCmd(c, "wait", firstID) + + // start running container + out, _ = dockerCmd(c, "run", "-itd", "busybox") + secondID := strings.TrimSpace(out) + + // filter containers by exited + out, _ = dockerCmd(c, "ps", "-q", "--filter=status=exited") + containerOut := strings.TrimSpace(out) + if containerOut != firstID[:12] { + c.Fatalf("Expected id %s, got %s for exited filter, output: %q", firstID[:12], containerOut, out) + } + + out, _ = dockerCmd(c, "ps", "-a", "-q", "--filter=status=running") + containerOut = strings.TrimSpace(out) + if containerOut != secondID[:12] { + c.Fatalf("Expected id %s, got %s for running filter, output: %q", secondID[:12], containerOut, out) + } + + out, _, _ = dockerCmdWithTimeout(time.Second*60, "ps", "-a", "-q", "--filter=status=rubbish") + if !strings.Contains(out, "Unrecognised filter value for status") { + c.Fatalf("Expected error response due to invalid status filter output: %q", out) + } + +} + +func (s *DockerSuite) TestPsListContainersFilterID(c *check.C) { + testRequires(c, DaemonIsLinux) + // start container + out, _ := dockerCmd(c, "run", "-d", "busybox") + firstID := strings.TrimSpace(out) + + // start another container + dockerCmd(c, "run", "-d", "busybox", "top") + + // filter containers by id + out, _ = dockerCmd(c, "ps", "-a", "-q", "--filter=id="+firstID) + containerOut := strings.TrimSpace(out) + if containerOut != firstID[:12] { + c.Fatalf("Expected id %s, got %s for exited filter, output: %q", firstID[:12], containerOut, out) + } + +} + +func (s *DockerSuite) TestPsListContainersFilterName(c *check.C) { + testRequires(c, DaemonIsLinux) + // start container + out, _ := dockerCmd(c, "run", "-d", "--name=a_name_to_match", "busybox") + firstID := strings.TrimSpace(out) + + // start another container + dockerCmd(c, "run", "-d", "--name=b_name_to_match", "busybox", "top") + + // filter containers by name + out, _ = dockerCmd(c, "ps", "-a", "-q", "--filter=name=a_name_to_match") + containerOut := strings.TrimSpace(out) + if containerOut != firstID[:12] { + c.Fatalf("Expected id %s, got %s for exited filter, output: %q", firstID[:12], containerOut, out) + } + +} + +// Test for the ancestor filter for ps. +// There is also the same test but with image:tag@digest in docker_cli_by_digest_test.go +// +// What the test setups : +// - Create 2 image based on busybox using the same repository but different tags +// - Create an image based on the previous image (images_ps_filter_test2) +// - Run containers for each of those image (busybox, images_ps_filter_test1, images_ps_filter_test2) +// - Filter them out :P +func (s *DockerSuite) TestPsListContainersFilterAncestorImage(c *check.C) { + testRequires(c, DaemonIsLinux) + // Build images + imageName1 := "images_ps_filter_test1" + imageID1, err := buildImage(imageName1, + `FROM busybox + LABEL match me 1`, true) + c.Assert(err, check.IsNil) + + imageName1Tagged := "images_ps_filter_test1:tag" + imageID1Tagged, err := buildImage(imageName1Tagged, + `FROM busybox + LABEL match me 1 tagged`, true) + c.Assert(err, check.IsNil) + + imageName2 := "images_ps_filter_test2" + imageID2, err := buildImage(imageName2, + fmt.Sprintf(`FROM %s + LABEL match me 2`, imageName1), true) + c.Assert(err, check.IsNil) + + // start containers + out, _ := dockerCmd(c, "run", "-d", "busybox", "echo", "hello") + firstID := strings.TrimSpace(out) + + // start another container + out, _ = dockerCmd(c, "run", "-d", "busybox", "echo", "hello") + secondID := strings.TrimSpace(out) + + // start third container + out, _ = dockerCmd(c, "run", "-d", imageName1, "echo", "hello") + thirdID := strings.TrimSpace(out) + + // start fourth container + out, _ = dockerCmd(c, "run", "-d", imageName1Tagged, "echo", "hello") + fourthID := strings.TrimSpace(out) + + // start fifth container + out, _ = dockerCmd(c, "run", "-d", imageName2, "echo", "hello") + fifthID := strings.TrimSpace(out) + + var filterTestSuite = []struct { + filterName string + expectedIDs []string + }{ + // non existent stuff + {"nonexistent", []string{}}, + {"nonexistent:tag", []string{}}, + // image + {"busybox", []string{firstID, secondID, thirdID, fourthID, fifthID}}, + {imageName1, []string{thirdID, fifthID}}, + {imageName2, []string{fifthID}}, + // image:tag + {fmt.Sprintf("%s:latest", imageName1), []string{thirdID, fifthID}}, + {imageName1Tagged, []string{fourthID}}, + // short-id + {stringid.TruncateID(imageID1), []string{thirdID, fifthID}}, + {stringid.TruncateID(imageID2), []string{fifthID}}, + // full-id + {imageID1, []string{thirdID, fifthID}}, + {imageID1Tagged, []string{fourthID}}, + {imageID2, []string{fifthID}}, + } + + for _, filter := range filterTestSuite { + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=ancestor="+filter.filterName) + checkPsAncestorFilterOutput(c, out, filter.filterName, filter.expectedIDs) + } + + // Multiple ancestor filter + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=ancestor="+imageName2, "--filter=ancestor="+imageName1Tagged) + checkPsAncestorFilterOutput(c, out, imageName2+","+imageName1Tagged, []string{fourthID, fifthID}) +} + +func checkPsAncestorFilterOutput(c *check.C, out string, filterName string, expectedIDs []string) { + actualIDs := []string{} + if out != "" { + actualIDs = strings.Split(out[:len(out)-1], "\n") + } + sort.Strings(actualIDs) + sort.Strings(expectedIDs) + + if len(actualIDs) != len(expectedIDs) { + c.Fatalf("Expected filtered container(s) for %s ancestor filter to be %v:%v, got %v:%v", filterName, len(expectedIDs), expectedIDs, len(actualIDs), actualIDs) + } + if len(expectedIDs) > 0 { + same := true + for i := range expectedIDs { + if actualIDs[i] != expectedIDs[i] { + c.Logf("%s, %s", actualIDs[i], expectedIDs[i]) + same = false + break + } + } + if !same { + c.Fatalf("Expected filtered container(s) for %s ancestor filter to be %v, got %v", filterName, expectedIDs, actualIDs) + } + } +} + +func (s *DockerSuite) TestPsListContainersFilterLabel(c *check.C) { + testRequires(c, DaemonIsLinux) + // start container + out, _ := dockerCmd(c, "run", "-d", "-l", "match=me", "-l", "second=tag", "busybox") + firstID := strings.TrimSpace(out) + + // start another container + out, _ = dockerCmd(c, "run", "-d", "-l", "match=me too", "busybox") + secondID := strings.TrimSpace(out) + + // start third container + out, _ = dockerCmd(c, "run", "-d", "-l", "nomatch=me", "busybox") + thirdID := strings.TrimSpace(out) + + // filter containers by exact match + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=label=match=me") + containerOut := strings.TrimSpace(out) + if containerOut != firstID { + c.Fatalf("Expected id %s, got %s for exited filter, output: %q", firstID, containerOut, out) + } + + // filter containers by two labels + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=label=match=me", "--filter=label=second=tag") + containerOut = strings.TrimSpace(out) + if containerOut != firstID { + c.Fatalf("Expected id %s, got %s for exited filter, output: %q", firstID, containerOut, out) + } + + // filter containers by two labels, but expect not found because of AND behavior + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=label=match=me", "--filter=label=second=tag-no") + containerOut = strings.TrimSpace(out) + if containerOut != "" { + c.Fatalf("Expected nothing, got %s for exited filter, output: %q", containerOut, out) + } + + // filter containers by exact key + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=label=match") + containerOut = strings.TrimSpace(out) + if (!strings.Contains(containerOut, firstID) || !strings.Contains(containerOut, secondID)) || strings.Contains(containerOut, thirdID) { + c.Fatalf("Expected ids %s,%s, got %s for exited filter, output: %q", firstID, secondID, containerOut, out) + } +} + +func (s *DockerSuite) TestPsListContainersFilterExited(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "top", "busybox", "top") + + dockerCmd(c, "run", "--name", "zero1", "busybox", "true") + firstZero, err := getIDByName("zero1") + if err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "--name", "zero2", "busybox", "true") + secondZero, err := getIDByName("zero2") + if err != nil { + c.Fatal(err) + } + + if out, _, err := dockerCmdWithError("run", "--name", "nonzero1", "busybox", "false"); err == nil { + c.Fatal("Should fail.", out, err) + } + + firstNonZero, err := getIDByName("nonzero1") + if err != nil { + c.Fatal(err) + } + + if out, _, err := dockerCmdWithError("run", "--name", "nonzero2", "busybox", "false"); err == nil { + c.Fatal("Should fail.", out, err) + } + secondNonZero, err := getIDByName("nonzero2") + if err != nil { + c.Fatal(err) + } + + // filter containers by exited=0 + out, _ := dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=exited=0") + ids := strings.Split(strings.TrimSpace(out), "\n") + if len(ids) != 2 { + c.Fatalf("Should be 2 zero exited containers got %d: %s", len(ids), out) + } + if ids[0] != secondZero { + c.Fatalf("First in list should be %q, got %q", secondZero, ids[0]) + } + if ids[1] != firstZero { + c.Fatalf("Second in list should be %q, got %q", firstZero, ids[1]) + } + + out, _ = dockerCmd(c, "ps", "-a", "-q", "--no-trunc", "--filter=exited=1") + ids = strings.Split(strings.TrimSpace(out), "\n") + if len(ids) != 2 { + c.Fatalf("Should be 2 zero exited containers got %d", len(ids)) + } + if ids[0] != secondNonZero { + c.Fatalf("First in list should be %q, got %q", secondNonZero, ids[0]) + } + if ids[1] != firstNonZero { + c.Fatalf("Second in list should be %q, got %q", firstNonZero, ids[1]) + } + +} + +func (s *DockerSuite) TestPsRightTagName(c *check.C) { + testRequires(c, DaemonIsLinux) + tag := "asybox:shmatest" + dockerCmd(c, "tag", "busybox", tag) + + var id1 string + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id1 = strings.TrimSpace(string(out)) + + var id2 string + out, _ = dockerCmd(c, "run", "-d", tag, "top") + id2 = strings.TrimSpace(string(out)) + + var imageID string + out, _ = dockerCmd(c, "inspect", "-f", "{{.Id}}", "busybox") + imageID = strings.TrimSpace(string(out)) + + var id3 string + out, _ = dockerCmd(c, "run", "-d", imageID, "top") + id3 = strings.TrimSpace(string(out)) + + out, _ = dockerCmd(c, "ps", "--no-trunc") + lines := strings.Split(strings.TrimSpace(string(out)), "\n") + // skip header + lines = lines[1:] + if len(lines) != 3 { + c.Fatalf("There should be 3 running container, got %d", len(lines)) + } + for _, line := range lines { + f := strings.Fields(line) + switch f[0] { + case id1: + if f[1] != "busybox" { + c.Fatalf("Expected %s tag for id %s, got %s", "busybox", id1, f[1]) + } + case id2: + if f[1] != tag { + c.Fatalf("Expected %s tag for id %s, got %s", tag, id2, f[1]) + } + case id3: + if f[1] != imageID { + c.Fatalf("Expected %s imageID for id %s, got %s", tag, id3, f[1]) + } + default: + c.Fatalf("Unexpected id %s, expected %s and %s and %s", f[0], id1, id2, id3) + } + } +} + +func (s *DockerSuite) TestPsLinkedWithNoTrunc(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name=first", "-d", "busybox", "top") + dockerCmd(c, "run", "--name=second", "--link=first:first", "-d", "busybox", "top") + + out, _ := dockerCmd(c, "ps", "--no-trunc") + lines := strings.Split(strings.TrimSpace(string(out)), "\n") + // strip header + lines = lines[1:] + expected := []string{"second", "first,second/first"} + var names []string + for _, l := range lines { + fields := strings.Fields(l) + names = append(names, fields[len(fields)-1]) + } + if !reflect.DeepEqual(expected, names) { + c.Fatalf("Expected array: %v, got: %v", expected, names) + } +} + +func (s *DockerSuite) TestPsGroupPortRange(c *check.C) { + testRequires(c, DaemonIsLinux) + portRange := "3800-3900" + dockerCmd(c, "run", "-d", "--name", "porttest", "-p", portRange+":"+portRange, "busybox", "top") + + out, _ := dockerCmd(c, "ps") + + // check that the port range is in the output + if !strings.Contains(string(out), portRange) { + c.Fatalf("docker ps output should have had the port range %q: %s", portRange, string(out)) + } + +} + +func (s *DockerSuite) TestPsWithSize(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "sizetest", "busybox", "top") + + out, _ := dockerCmd(c, "ps", "--size") + if !strings.Contains(out, "virtual") { + c.Fatalf("docker ps with --size should show virtual size of container") + } +} + +func (s *DockerSuite) TestPsListContainersFilterCreated(c *check.C) { + testRequires(c, DaemonIsLinux) + // create a container + out, _ := dockerCmd(c, "create", "busybox") + cID := strings.TrimSpace(out) + shortCID := cID[:12] + + // Make sure it DOESN'T show up w/o a '-a' for normal 'ps' + out, _ = dockerCmd(c, "ps", "-q") + if strings.Contains(out, shortCID) { + c.Fatalf("Should have not seen '%s' in ps output:\n%s", shortCID, out) + } + + // Make sure it DOES show up as 'Created' for 'ps -a' + out, _ = dockerCmd(c, "ps", "-a") + + hits := 0 + for _, line := range strings.Split(out, "\n") { + if !strings.Contains(line, shortCID) { + continue + } + hits++ + if !strings.Contains(line, "Created") { + c.Fatalf("Missing 'Created' on '%s'", line) + } + } + + if hits != 1 { + c.Fatalf("Should have seen '%s' in ps -a output once:%d\n%s", shortCID, hits, out) + } + + // filter containers by 'create' - note, no -a needed + out, _ = dockerCmd(c, "ps", "-q", "-f", "status=created") + containerOut := strings.TrimSpace(out) + if !strings.HasPrefix(cID, containerOut) { + c.Fatalf("Expected id %s, got %s for filter, out: %s", cID, containerOut, out) + } +} + +func (s *DockerSuite) TestPsFormatMultiNames(c *check.C) { + testRequires(c, DaemonIsLinux) + //create 2 containers and link them + dockerCmd(c, "run", "--name=child", "-d", "busybox", "top") + dockerCmd(c, "run", "--name=parent", "--link=child:linkedone", "-d", "busybox", "top") + + //use the new format capabilities to only list the names and --no-trunc to get all names + out, _ := dockerCmd(c, "ps", "--format", "{{.Names}}", "--no-trunc") + lines := strings.Split(strings.TrimSpace(string(out)), "\n") + expected := []string{"parent", "child,parent/linkedone"} + var names []string + for _, l := range lines { + names = append(names, l) + } + if !reflect.DeepEqual(expected, names) { + c.Fatalf("Expected array with non-truncated names: %v, got: %v", expected, names) + } + + //now list without turning off truncation and make sure we only get the non-link names + out, _ = dockerCmd(c, "ps", "--format", "{{.Names}}") + lines = strings.Split(strings.TrimSpace(string(out)), "\n") + expected = []string{"parent", "child"} + var truncNames []string + for _, l := range lines { + truncNames = append(truncNames, l) + } + if !reflect.DeepEqual(expected, truncNames) { + c.Fatalf("Expected array with truncated names: %v, got: %v", expected, truncNames) + } + +} + +func (s *DockerSuite) TestPsFormatHeaders(c *check.C) { + testRequires(c, DaemonIsLinux) + // make sure no-container "docker ps" still prints the header row + out, _ := dockerCmd(c, "ps", "--format", "table {{.ID}}") + if out != "CONTAINER ID\n" { + c.Fatalf(`Expected 'CONTAINER ID\n', got %v`, out) + } + + // verify that "docker ps" with a container still prints the header row also + dockerCmd(c, "run", "--name=test", "-d", "busybox", "top") + out, _ = dockerCmd(c, "ps", "--format", "table {{.Names}}") + if out != "NAMES\ntest\n" { + c.Fatalf(`Expected 'NAMES\ntest\n', got %v`, out) + } +} + +func (s *DockerSuite) TestPsDefaultFormatAndQuiet(c *check.C) { + testRequires(c, DaemonIsLinux) + config := `{ + "psFormat": "{{ .ID }} default" +}` + d, err := ioutil.TempDir("", "integration-cli-") + c.Assert(err, check.IsNil) + defer os.RemoveAll(d) + + err = ioutil.WriteFile(filepath.Join(d, "config.json"), []byte(config), 0644) + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "run", "--name=test", "-d", "busybox", "top") + id := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "--config", d, "ps", "-q") + if !strings.HasPrefix(id, strings.TrimSpace(out)) { + c.Fatalf("Expected to print only the container id, got %v\n", out) + } +} + +// Test for GitHub issue #12595 +func (s *DockerSuite) TestPsImageIDAfterUpdate(c *check.C) { + testRequires(c, DaemonIsLinux) + + originalImageName := "busybox:TestPsImageIDAfterUpdate-original" + updatedImageName := "busybox:TestPsImageIDAfterUpdate-updated" + + runCmd := exec.Command(dockerBinary, "tag", "busybox:latest", originalImageName) + out, _, err := runCommandWithOutput(runCmd) + c.Assert(err, check.IsNil) + + originalImageID, err := getIDByName(originalImageName) + c.Assert(err, check.IsNil) + + runCmd = exec.Command(dockerBinary, "run", "-d", originalImageName, "top") + out, _, err = runCommandWithOutput(runCmd) + c.Assert(err, check.IsNil) + containerID := strings.TrimSpace(out) + + linesOut, err := exec.Command(dockerBinary, "ps", "--no-trunc").CombinedOutput() + c.Assert(err, check.IsNil) + + lines := strings.Split(strings.TrimSpace(string(linesOut)), "\n") + // skip header + lines = lines[1:] + c.Assert(len(lines), check.Equals, 1) + + for _, line := range lines { + f := strings.Fields(line) + c.Assert(f[1], check.Equals, originalImageName) + } + + runCmd = exec.Command(dockerBinary, "commit", containerID, updatedImageName) + out, _, err = runCommandWithOutput(runCmd) + c.Assert(err, check.IsNil) + + runCmd = exec.Command(dockerBinary, "tag", "-f", updatedImageName, originalImageName) + out, _, err = runCommandWithOutput(runCmd) + c.Assert(err, check.IsNil) + + linesOut, err = exec.Command(dockerBinary, "ps", "--no-trunc").CombinedOutput() + c.Assert(err, check.IsNil) + + lines = strings.Split(strings.TrimSpace(string(linesOut)), "\n") + // skip header + lines = lines[1:] + c.Assert(len(lines), check.Equals, 1) + + for _, line := range lines { + f := strings.Fields(line) + c.Assert(f[1], check.Equals, originalImageID) + } + +} diff --git a/integration-cli/docker_cli_pull_local_test.go b/integration-cli/docker_cli_pull_local_test.go new file mode 100644 index 0000000000..2d5374bef9 --- /dev/null +++ b/integration-cli/docker_cli_pull_local_test.go @@ -0,0 +1,161 @@ +package main + +import ( + "fmt" + "os/exec" + "strings" + + "github.com/go-check/check" +) + +// TestPullImageWithAliases pulls a specific image tag and verifies that any aliases (i.e., other +// tags for the same image) are not also pulled down. +// +// Ref: docker/docker#8141 +func (s *DockerRegistrySuite) TestPullImageWithAliases(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + + repos := []string{} + for _, tag := range []string{"recent", "fresh"} { + repos = append(repos, fmt.Sprintf("%v:%v", repoName, tag)) + } + + // Tag and push the same image multiple times. + for _, repo := range repos { + dockerCmd(c, "tag", "busybox", repo) + dockerCmd(c, "push", repo) + } + + // Clear local images store. + args := append([]string{"rmi"}, repos...) + dockerCmd(c, args...) + + // Pull a single tag and verify it doesn't bring down all aliases. + dockerCmd(c, "pull", repos[0]) + dockerCmd(c, "inspect", repos[0]) + for _, repo := range repos[1:] { + _, _, err := dockerCmdWithError("inspect", repo) + c.Assert(err, check.NotNil, check.Commentf("Image %v shouldn't have been pulled down", repo)) + } +} + +// TestConcurrentPullWholeRepo pulls the same repo concurrently. +func (s *DockerRegistrySuite) TestConcurrentPullWholeRepo(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + + repos := []string{} + for _, tag := range []string{"recent", "fresh", "todays"} { + repo := fmt.Sprintf("%v:%v", repoName, tag) + _, err := buildImage(repo, fmt.Sprintf(` + FROM busybox + ENTRYPOINT ["/bin/echo"] + ENV FOO foo + ENV BAR bar + CMD echo %s + `, repo), true) + c.Assert(err, check.IsNil) + dockerCmd(c, "push", repo) + repos = append(repos, repo) + } + + // Clear local images store. + args := append([]string{"rmi"}, repos...) + dockerCmd(c, args...) + + // Run multiple re-pulls concurrently + results := make(chan error) + numPulls := 3 + + for i := 0; i != numPulls; i++ { + go func() { + _, _, err := runCommandWithOutput(exec.Command(dockerBinary, "pull", "-a", repoName)) + results <- err + }() + } + + // These checks are separate from the loop above because the check + // package is not goroutine-safe. + for i := 0; i != numPulls; i++ { + err := <-results + c.Assert(err, check.IsNil, check.Commentf("concurrent pull failed with error: %v", err)) + } + + // Ensure all tags were pulled successfully + for _, repo := range repos { + dockerCmd(c, "inspect", repo) + out, _ := dockerCmd(c, "run", "--rm", repo) + c.Assert(strings.TrimSpace(out), check.Equals, "/bin/sh -c echo "+repo, check.Commentf("CMD did not contain /bin/sh -c echo %s: %s", repo, out)) + } +} + +// TestConcurrentFailingPull tries a concurrent pull that doesn't succeed. +func (s *DockerRegistrySuite) TestConcurrentFailingPull(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + + // Run multiple pulls concurrently + results := make(chan error) + numPulls := 3 + + for i := 0; i != numPulls; i++ { + go func() { + _, _, err := runCommandWithOutput(exec.Command(dockerBinary, "pull", repoName+":asdfasdf")) + results <- err + }() + } + + // These checks are separate from the loop above because the check + // package is not goroutine-safe. + for i := 0; i != numPulls; i++ { + err := <-results + c.Assert(err, check.NotNil, check.Commentf("expected pull to fail")) + } +} + +// TestConcurrentPullMultipleTags pulls multiple tags from the same repo +// concurrently. +func (s *DockerRegistrySuite) TestConcurrentPullMultipleTags(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + + repos := []string{} + for _, tag := range []string{"recent", "fresh", "todays"} { + repo := fmt.Sprintf("%v:%v", repoName, tag) + _, err := buildImage(repo, fmt.Sprintf(` + FROM busybox + ENTRYPOINT ["/bin/echo"] + ENV FOO foo + ENV BAR bar + CMD echo %s + `, repo), true) + c.Assert(err, check.IsNil) + dockerCmd(c, "push", repo) + repos = append(repos, repo) + } + + // Clear local images store. + args := append([]string{"rmi"}, repos...) + dockerCmd(c, args...) + + // Re-pull individual tags, in parallel + results := make(chan error) + + for _, repo := range repos { + go func(repo string) { + _, _, err := runCommandWithOutput(exec.Command(dockerBinary, "pull", repo)) + results <- err + }(repo) + } + + // These checks are separate from the loop above because the check + // package is not goroutine-safe. + for range repos { + err := <-results + c.Assert(err, check.IsNil, check.Commentf("concurrent pull failed with error: %v", err)) + } + + // Ensure all tags were pulled successfully + for _, repo := range repos { + dockerCmd(c, "inspect", repo) + out, _ := dockerCmd(c, "run", "--rm", repo) + c.Assert(strings.TrimSpace(out), check.Equals, "/bin/sh -c echo "+repo, check.Commentf("CMD did not contain /bin/sh -c echo %s; %s", repo, out)) + } +} diff --git a/integration-cli/docker_cli_pull_test.go b/integration-cli/docker_cli_pull_test.go new file mode 100644 index 0000000000..32b7105945 --- /dev/null +++ b/integration-cli/docker_cli_pull_test.go @@ -0,0 +1,607 @@ +package main + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "os" + "path/filepath" + "regexp" + "strings" + "time" + + "github.com/docker/distribution/digest" + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +// TestPullFromCentralRegistry pulls an image from the central registry and verifies that the client +// prints all expected output. +func (s *DockerHubPullSuite) TestPullFromCentralRegistry(c *check.C) { + testRequires(c, DaemonIsLinux) + out := s.Cmd(c, "pull", "hello-world") + defer deleteImages("hello-world") + + c.Assert(out, checker.Contains, "Using default tag: latest", check.Commentf("expected the 'latest' tag to be automatically assumed")) + c.Assert(out, checker.Contains, "Pulling from library/hello-world", check.Commentf("expected the 'library/' prefix to be automatically assumed")) + c.Assert(out, checker.Contains, "Downloaded newer image for hello-world:latest") + + matches := regexp.MustCompile(`Digest: (.+)\n`).FindAllStringSubmatch(out, -1) + c.Assert(len(matches), checker.Equals, 1, check.Commentf("expected exactly one image digest in the output")) + c.Assert(len(matches[0]), checker.Equals, 2, check.Commentf("unexpected number of submatches for the digest")) + _, err := digest.ParseDigest(matches[0][1]) + c.Check(err, checker.IsNil, check.Commentf("invalid digest %q in output", matches[0][1])) + + // We should have a single entry in images. + img := strings.TrimSpace(s.Cmd(c, "images")) + if splitImg := strings.Split(img, "\n"); len(splitImg) != 2 { + c.Fatalf("expected only two lines in the output of `docker images`, got %d", len(splitImg)) + } else if re := regexp.MustCompile(`^hello-world\s+latest`); !re.Match([]byte(splitImg[1])) { + c.Fatal("invalid output for `docker images` (expected image and tag name") + } +} + +// TestPullNonExistingImage pulls non-existing images from the central registry, with different +// combinations of implicit tag and library prefix. +func (s *DockerHubPullSuite) TestPullNonExistingImage(c *check.C) { + testRequires(c, DaemonIsLinux) + for _, e := range []struct { + Image string + Alias string + }{ + {"library/asdfasdf:foobar", "asdfasdf:foobar"}, + {"library/asdfasdf:foobar", "library/asdfasdf:foobar"}, + {"library/asdfasdf:latest", "asdfasdf"}, + {"library/asdfasdf:latest", "asdfasdf:latest"}, + {"library/asdfasdf:latest", "library/asdfasdf"}, + {"library/asdfasdf:latest", "library/asdfasdf:latest"}, + } { + out, err := s.CmdWithError("pull", e.Alias) + c.Assert(err, checker.NotNil, check.Commentf("expected non-zero exit status when pulling non-existing image: %s", out)) + c.Assert(out, checker.Contains, fmt.Sprintf("Error: image %s not found", e.Image), check.Commentf("expected image not found error messages")) + } +} + +// TestPullFromCentralRegistryImplicitRefParts pulls an image from the central registry and verifies +// that pulling the same image with different combinations of implicit elements of the the image +// reference (tag, repository, central registry url, ...) doesn't trigger a new pull nor leads to +// multiple images. +func (s *DockerHubPullSuite) TestPullFromCentralRegistryImplicitRefParts(c *check.C) { + testRequires(c, DaemonIsLinux) + s.Cmd(c, "pull", "hello-world") + defer deleteImages("hello-world") + + for _, i := range []string{ + "hello-world", + "hello-world:latest", + "library/hello-world", + "library/hello-world:latest", + "docker.io/library/hello-world", + "index.docker.io/library/hello-world", + } { + out := s.Cmd(c, "pull", i) + c.Assert(out, checker.Contains, "Image is up to date for hello-world:latest") + } + + // We should have a single entry in images. + img := strings.TrimSpace(s.Cmd(c, "images")) + if splitImg := strings.Split(img, "\n"); len(splitImg) != 2 { + c.Fatalf("expected only two lines in the output of `docker images`, got %d", len(splitImg)) + } else if re := regexp.MustCompile(`^hello-world\s+latest`); !re.Match([]byte(splitImg[1])) { + c.Fatal("invalid output for `docker images` (expected image and tag name") + } +} + +// TestPullScratchNotAllowed verifies that pulling 'scratch' is rejected. +func (s *DockerHubPullSuite) TestPullScratchNotAllowed(c *check.C) { + testRequires(c, DaemonIsLinux) + out, err := s.CmdWithError("pull", "scratch") + c.Assert(err, checker.NotNil, check.Commentf("expected pull of scratch to fail")) + c.Assert(out, checker.Contains, "'scratch' is a reserved name") + c.Assert(out, checker.Not(checker.Contains), "Pulling repository scratch") +} + +// TestPullAllTagsFromCentralRegistry pulls using `all-tags` for a given image and verifies that it +// results in more images than a naked pull. +func (s *DockerHubPullSuite) TestPullAllTagsFromCentralRegistry(c *check.C) { + testRequires(c, DaemonIsLinux) + s.Cmd(c, "pull", "busybox") + outImageCmd := s.Cmd(c, "images", "busybox") + splitOutImageCmd := strings.Split(strings.TrimSpace(outImageCmd), "\n") + c.Assert(splitOutImageCmd, checker.HasLen, 2, check.Commentf("expected a single entry in images\n%v", outImageCmd)) + + s.Cmd(c, "pull", "--all-tags=true", "busybox") + outImageAllTagCmd := s.Cmd(c, "images", "busybox") + if linesCount := strings.Count(outImageAllTagCmd, "\n"); linesCount <= 2 { + c.Fatalf("pulling all tags should provide more images, got %d", linesCount-1) + } + + // Verify that the line for 'busybox:latest' is left unchanged. + var latestLine string + for _, line := range strings.Split(outImageAllTagCmd, "\n") { + if strings.HasPrefix(line, "busybox") && strings.Contains(line, "latest") { + latestLine = line + break + } + } + c.Assert(latestLine, checker.Not(checker.Equals), "", check.Commentf("no entry for busybox:latest found after pulling all tags")) + splitLatest := strings.Fields(latestLine) + splitCurrent := strings.Fields(splitOutImageCmd[1]) + c.Assert(splitLatest, checker.DeepEquals, splitCurrent, check.Commentf("busybox:latest was changed after pulling all tags")) +} + +// TestPullClientDisconnect kills the client during a pull operation and verifies that the operation +// still succesfully completes on the daemon side. +// +// Ref: docker/docker#15589 +func (s *DockerHubPullSuite) TestPullClientDisconnect(c *check.C) { + testRequires(c, DaemonIsLinux) + repoName := "hello-world:latest" + + pullCmd := s.MakeCmd("pull", repoName) + stdout, err := pullCmd.StdoutPipe() + c.Assert(err, checker.IsNil) + err = pullCmd.Start() + c.Assert(err, checker.IsNil) + + // Cancel as soon as we get some output. + buf := make([]byte, 10) + _, err = stdout.Read(buf) + c.Assert(err, checker.IsNil) + + err = pullCmd.Process.Kill() + c.Assert(err, checker.IsNil) + + maxAttempts := 20 + for i := 0; ; i++ { + if _, err := s.CmdWithError("inspect", repoName); err == nil { + break + } + if i >= maxAttempts { + c.Fatal("timeout reached: image was not pulled after client disconnected") + } + time.Sleep(500 * time.Millisecond) + } +} + +type idAndParent struct { + ID string + Parent string +} + +func inspectImage(c *check.C, imageRef string) idAndParent { + out, _ := dockerCmd(c, "inspect", imageRef) + var inspectOutput []idAndParent + err := json.Unmarshal([]byte(out), &inspectOutput) + if err != nil { + c.Fatal(err) + } + + return inspectOutput[0] +} + +func imageID(c *check.C, imageRef string) string { + return inspectImage(c, imageRef).ID +} + +func imageParent(c *check.C, imageRef string) string { + return inspectImage(c, imageRef).Parent +} + +// TestPullMigration verifies that pulling an image based on layers +// that already exists locally will reuse those existing layers. +func (s *DockerRegistrySuite) TestPullMigration(c *check.C) { + repoName := privateRegistryURL + "/dockercli/migration" + + baseImage := repoName + ":base" + _, err := buildImage(baseImage, fmt.Sprintf(` + FROM scratch + ENV IMAGE base + CMD echo %s + `, baseImage), true) + if err != nil { + c.Fatal(err) + } + + baseIDBeforePush := imageID(c, baseImage) + baseParentBeforePush := imageParent(c, baseImage) + + derivedImage := repoName + ":derived" + _, err = buildImage(derivedImage, fmt.Sprintf(` + FROM %s + CMD echo %s + `, baseImage, derivedImage), true) + if err != nil { + c.Fatal(err) + } + + derivedIDBeforePush := imageID(c, derivedImage) + + dockerCmd(c, "push", derivedImage) + + // Remove derived image from the local store + dockerCmd(c, "rmi", derivedImage) + + // Repull + dockerCmd(c, "pull", derivedImage) + + // Check that the parent of this pulled image is the original base + // image + derivedIDAfterPull1 := imageID(c, derivedImage) + derivedParentAfterPull1 := imageParent(c, derivedImage) + + if derivedIDAfterPull1 == derivedIDBeforePush { + c.Fatal("image's ID should have changed on after deleting and pulling") + } + + if derivedParentAfterPull1 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull1, baseIDBeforePush) + } + + // Confirm that repushing and repulling does not change the computed ID + dockerCmd(c, "push", derivedImage) + dockerCmd(c, "rmi", derivedImage) + dockerCmd(c, "pull", derivedImage) + + derivedIDAfterPull2 := imageID(c, derivedImage) + derivedParentAfterPull2 := imageParent(c, derivedImage) + + if derivedIDAfterPull2 != derivedIDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a repush/repull") + } + + if derivedParentAfterPull2 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull2, baseIDBeforePush) + } + + // Remove everything, repull, and make sure everything uses computed IDs + dockerCmd(c, "rmi", baseImage, derivedImage) + dockerCmd(c, "pull", derivedImage) + + derivedIDAfterPull3 := imageID(c, derivedImage) + derivedParentAfterPull3 := imageParent(c, derivedImage) + derivedGrandparentAfterPull3 := imageParent(c, derivedParentAfterPull3) + + if derivedIDAfterPull3 != derivedIDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a second repull") + } + + if derivedParentAfterPull3 == baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) should not match base image's original ID (%s)", derivedParentAfterPull3, derivedIDBeforePush) + } + + if derivedGrandparentAfterPull3 == baseParentBeforePush { + c.Fatal("base image's parent ID should have been rewritten on pull") + } +} + +// TestPullMigrationRun verifies that pulling an image based on layers +// that already exists locally will result in an image that runs properly. +func (s *DockerRegistrySuite) TestPullMigrationRun(c *check.C) { + type idAndParent struct { + ID string + Parent string + } + + derivedImage := privateRegistryURL + "/dockercli/migration-run" + baseImage := "busybox" + + _, err := buildImage(derivedImage, fmt.Sprintf(` + FROM %s + RUN dd if=/dev/zero of=/file bs=1024 count=1024 + CMD echo %s + `, baseImage, derivedImage), true) + if err != nil { + c.Fatal(err) + } + + baseIDBeforePush := imageID(c, baseImage) + derivedIDBeforePush := imageID(c, derivedImage) + + dockerCmd(c, "push", derivedImage) + + // Remove derived image from the local store + dockerCmd(c, "rmi", derivedImage) + + // Repull + dockerCmd(c, "pull", derivedImage) + + // Check that this pulled image is based on the original base image + derivedIDAfterPull1 := imageID(c, derivedImage) + derivedParentAfterPull1 := imageParent(c, imageParent(c, derivedImage)) + + if derivedIDAfterPull1 == derivedIDBeforePush { + c.Fatal("image's ID should have changed on after deleting and pulling") + } + + if derivedParentAfterPull1 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull1, baseIDBeforePush) + } + + // Make sure the image runs correctly + out, _ := dockerCmd(c, "run", "--rm", derivedImage) + if strings.TrimSpace(out) != derivedImage { + c.Fatalf("expected %s; got %s", derivedImage, out) + } + + // Confirm that repushing and repulling does not change the computed ID + dockerCmd(c, "push", derivedImage) + dockerCmd(c, "rmi", derivedImage) + dockerCmd(c, "pull", derivedImage) + + derivedIDAfterPull2 := imageID(c, derivedImage) + derivedParentAfterPull2 := imageParent(c, imageParent(c, derivedImage)) + + if derivedIDAfterPull2 != derivedIDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a repush/repull") + } + + if derivedParentAfterPull2 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull2, baseIDBeforePush) + } + + // Make sure the image still runs + out, _ = dockerCmd(c, "run", "--rm", derivedImage) + if strings.TrimSpace(out) != derivedImage { + c.Fatalf("expected %s; got %s", derivedImage, out) + } +} + +// TestPullConflict provides coverage of the situation where a computed +// strongID conflicts with some unverifiable data in the graph. +func (s *DockerRegistrySuite) TestPullConflict(c *check.C) { + repoName := privateRegistryURL + "/dockercli/conflict" + + _, err := buildImage(repoName, ` + FROM scratch + ENV IMAGE conflict + CMD echo conflict + `, true) + if err != nil { + c.Fatal(err) + } + + dockerCmd(c, "push", repoName) + + // Pull to make it content-addressable + dockerCmd(c, "rmi", repoName) + dockerCmd(c, "pull", repoName) + + IDBeforeLoad := imageID(c, repoName) + + // Load/save to turn this into an unverified image with the same ID + tmpDir, err := ioutil.TempDir("", "conflict-save-output") + if err != nil { + c.Errorf("failed to create temporary directory: %s", err) + } + defer os.RemoveAll(tmpDir) + + tarFile := filepath.Join(tmpDir, "repo.tar") + + dockerCmd(c, "save", "-o", tarFile, repoName) + dockerCmd(c, "rmi", repoName) + dockerCmd(c, "load", "-i", tarFile) + + // Check that the the ID is the same after save/load. + IDAfterLoad := imageID(c, repoName) + + if IDAfterLoad != IDBeforeLoad { + c.Fatal("image's ID should be the same after save/load") + } + + // Repull + dockerCmd(c, "pull", repoName) + + // Check that the ID is now different because of the conflict. + IDAfterPull1 := imageID(c, repoName) + + // Expect the new ID to be SHA256(oldID) + expectedIDDigest, err := digest.FromBytes([]byte(IDBeforeLoad)) + if err != nil { + c.Fatalf("digest error: %v", err) + } + expectedID := expectedIDDigest.Hex() + if IDAfterPull1 != expectedID { + c.Fatalf("image's ID should have changed on pull to %s (got %s)", expectedID, IDAfterPull1) + } + + // A second pull should use the new ID again. + dockerCmd(c, "pull", repoName) + + IDAfterPull2 := imageID(c, repoName) + + if IDAfterPull2 != IDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a repull") + } +} + +/* + * REBASE NOTE: Migrate these tests +type idAndParent struct { + ID string + Parent string +} + +func inspectImage(c *check.C, imageRef string) idAndParent { + out, _ := dockerCmd(c, "inspect", imageRef) + var inspectOutput []idAndParent + err := json.Unmarshal([]byte(out), &inspectOutput) + if err != nil { + c.Fatal(err) + } + + return inspectOutput[0] +} + +func imageID(c *check.C, imageRef string) string { + return inspectImage(c, imageRef).ID +} + +func imageParent(c *check.C, imageRef string) string { + return inspectImage(c, imageRef).Parent +} + +// TestPullMigration verifies that pulling an image based on layers +// that already exists locally will reuse those existing layers. +func (s *DockerRegistrySuite) TestPullMigration(c *check.C) { + repoName := privateRegistryURL + "/dockercli/migration" + + baseImage := repoName + ":base" + _, err := buildImage(baseImage, fmt.Sprintf(` + FROM scratch + ENV IMAGE base + CMD echo %s + `, baseImage), true) + if err != nil { + c.Fatal(err) + } + + baseIDBeforePush := imageID(c, baseImage) + baseParentBeforePush := imageParent(c, baseImage) + + derivedImage := repoName + ":derived" + _, err = buildImage(derivedImage, fmt.Sprintf(` + FROM %s + CMD echo %s + `, baseImage, derivedImage), true) + if err != nil { + c.Fatal(err) + } + + derivedIDBeforePush := imageID(c, derivedImage) + + dockerCmd(c, "push", derivedImage) + + // Remove derived image from the local store + dockerCmd(c, "rmi", derivedImage) + + // Repull + dockerCmd(c, "pull", derivedImage) + + // Check that the parent of this pulled image is the original base + // image + derivedIDAfterPull1 := imageID(c, derivedImage) + derivedParentAfterPull1 := imageParent(c, derivedImage) + + if derivedIDAfterPull1 == derivedIDBeforePush { + c.Fatal("image's ID should have changed on after deleting and pulling") + } + + if derivedParentAfterPull1 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull1, baseIDBeforePush) + } + + // Confirm that repushing and repulling does not change the computed ID + dockerCmd(c, "push", derivedImage) + dockerCmd(c, "rmi", derivedImage) + dockerCmd(c, "pull", derivedImage) + + derivedIDAfterPull2 := imageID(c, derivedImage) + derivedParentAfterPull2 := imageParent(c, derivedImage) + + if derivedIDAfterPull2 != derivedIDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a repush/repull") + } + + if derivedParentAfterPull2 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull2, baseIDBeforePush) + } + + // Remove everything, repull, and make sure everything uses computed IDs + dockerCmd(c, "rmi", baseImage, derivedImage) + dockerCmd(c, "pull", derivedImage) + + derivedIDAfterPull3 := imageID(c, derivedImage) + derivedParentAfterPull3 := imageParent(c, derivedImage) + derivedGrandparentAfterPull3 := imageParent(c, derivedParentAfterPull3) + + if derivedIDAfterPull3 != derivedIDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a second repull") + } + + if derivedParentAfterPull3 == baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) should not match base image's original ID (%s)", derivedParentAfterPull3, derivedIDBeforePush) + } + + if derivedGrandparentAfterPull3 == baseParentBeforePush { + c.Fatal("base image's parent ID should have been rewritten on pull") + } +} + +// TestPullMigrationRun verifies that pulling an image based on layers +// that already exists locally will result in an image that runs properly. +func (s *DockerRegistrySuite) TestPullMigrationRun(c *check.C) { + type idAndParent struct { + ID string + Parent string + } + + // This test depends on a pulled busybox to work, since "load" uses + // incompatible IDs. + dockerCmd(c, "rmi", "busybox") + dockerCmd(c, "pull", "busybox") + + derivedImage := privateRegistryURL + "/dockercli/migration-run" + baseImage := "busybox" + + _, err := buildImage(derivedImage, fmt.Sprintf(` + FROM %s + RUN dd if=/dev/zero of=/file bs=1024 count=1024 + CMD echo %s + `, baseImage, derivedImage), true) + if err != nil { + c.Fatal(err) + } + + baseIDBeforePush := imageID(c, baseImage) + derivedIDBeforePush := imageID(c, derivedImage) + + dockerCmd(c, "push", derivedImage) + + // Remove derived image from the local store + dockerCmd(c, "rmi", derivedImage) + + // Repull + dockerCmd(c, "pull", derivedImage) + + // Check that this pulled image is based on the original base image + derivedIDAfterPull1 := imageID(c, derivedImage) + derivedParentAfterPull1 := imageParent(c, imageParent(c, derivedImage)) + + if derivedIDAfterPull1 == derivedIDBeforePush { + c.Fatal("image's ID should have changed on after deleting and pulling") + } + + if derivedParentAfterPull1 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull1, baseIDBeforePush) + } + + // Make sure the image runs correctly + out, _ := dockerCmd(c, "run", "--rm", derivedImage) + if strings.TrimSpace(out) != derivedImage { + c.Fatalf("expected %s; got %s", derivedImage, out) + } + + // Confirm that repushing and repulling does not change the computed ID + dockerCmd(c, "push", derivedImage) + dockerCmd(c, "rmi", derivedImage) + dockerCmd(c, "pull", derivedImage) + + derivedIDAfterPull2 := imageID(c, derivedImage) + derivedParentAfterPull2 := imageParent(c, imageParent(c, derivedImage)) + + if derivedIDAfterPull2 != derivedIDAfterPull1 { + c.Fatal("image's ID unexpectedly changed after a repush/repull") + } + + if derivedParentAfterPull2 != baseIDBeforePush { + c.Fatalf("pulled image's parent ID (%s) does not match base image's ID (%s)", derivedParentAfterPull2, baseIDBeforePush) + } + + // Make sure the image still runs + out, _ = dockerCmd(c, "run", "--rm", derivedImage) + if strings.TrimSpace(out) != derivedImage { + c.Fatalf("expected %s; got %s", derivedImage, out) + } +} +*/ diff --git a/integration-cli/docker_cli_pull_trusted_test.go b/integration-cli/docker_cli_pull_trusted_test.go new file mode 100644 index 0000000000..9e69a1ba97 --- /dev/null +++ b/integration-cli/docker_cli_pull_trusted_test.go @@ -0,0 +1,265 @@ +package main + +import ( + "fmt" + "io/ioutil" + "os/exec" + "strings" + "time" + + "github.com/go-check/check" +) + +func (s *DockerTrustSuite) TestTrustedPull(c *check.C) { + repoName := s.setupTrustedImage(c, "trusted-pull") + + // Try pull + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err := runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try untrusted pull to ensure we pushed the tag to the registry + pullCmd = exec.Command(dockerBinary, "pull", "--disable-content-trust=true", repoName) + s.trustedCmd(pullCmd) + out, _, err = runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on trusted pull with --disable-content-trust:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedIsolatedPull(c *check.C) { + repoName := s.setupTrustedImage(c, "trusted-isolated-pull") + + // Try pull (run from isolated directory without trust information) + pullCmd := exec.Command(dockerBinary, "--config", "/tmp/docker-isolated", "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err := runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) +} + +func (s *DockerTrustSuite) TestUntrustedPull(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + dockerCmd(c, "push", repoName) + dockerCmd(c, "rmi", repoName) + + // Try trusted pull on untrusted tag + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err := runCommandWithOutput(pullCmd) + if err == nil { + c.Fatalf("Error expected when running trusted pull with:\n%s", out) + } + + if !strings.Contains(string(out), "no trust data available") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestPullWhenCertExpired(c *check.C) { + c.Skip("Currently changes system time, causing instability") + repoName := s.setupTrustedImage(c, "trusted-cert-expired") + + // Certificates have 10 years of expiration + elevenYearsFromNow := time.Now().Add(time.Hour * 24 * 365 * 11) + + runAtDifferentDate(elevenYearsFromNow, func() { + // Try pull + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err := runCommandWithOutput(pullCmd) + if err == nil { + c.Fatalf("Error running trusted pull in the distant future: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "could not validate the path to a trusted root") { + c.Fatalf("Missing expected output on trusted pull in the distant future:\n%s", out) + } + }) + + runAtDifferentDate(elevenYearsFromNow, func() { + // Try pull + pullCmd := exec.Command(dockerBinary, "pull", "--disable-content-trust", repoName) + s.trustedCmd(pullCmd) + out, _, err := runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running untrusted pull in the distant future: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on untrusted pull in the distant future:\n%s", out) + } + }) +} + +func (s *DockerTrustSuite) TestTrustedPullFromBadTrustServer(c *check.C) { + repoName := fmt.Sprintf("%v/dockerclievilpull/trusted:latest", privateRegistryURL) + evilLocalConfigDir, err := ioutil.TempDir("", "evil-local-config-dir") + if err != nil { + c.Fatalf("Failed to create local temp dir") + } + + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try pull + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err = runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Kill the notary server, start a new "evil" one. + s.not.Close() + s.not, err = newTestNotary(c) + if err != nil { + c.Fatalf("Restarting notary server failed.") + } + + // In order to make an evil server, lets re-init a client (with a different trust dir) and push new data. + // tag an image and upload it to the private registry + dockerCmd(c, "--config", evilLocalConfigDir, "tag", "busybox", repoName) + + // Push up to the new server + pushCmd = exec.Command(dockerBinary, "--config", evilLocalConfigDir, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err = runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // Now, try pulling with the original client from this new trust server. This should fail. + pullCmd = exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err = runCommandWithOutput(pullCmd) + if err == nil { + c.Fatalf("Expected to fail on this pull due to different remote data: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "failed to validate data with current trusted certificates") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPullWithExpiredSnapshot(c *check.C) { + c.Skip("Currently changes system time, causing instability") + repoName := fmt.Sprintf("%v/dockercliexpiredtimestamppull/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + // Push with default passphrases + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Snapshots last for three years. This should be expired + fourYearsLater := time.Now().Add(time.Hour * 24 * 365 * 4) + + runAtDifferentDate(fourYearsLater, func() { + // Try pull + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err = runCommandWithOutput(pullCmd) + if err == nil { + c.Fatalf("Missing expected error running trusted pull with expired snapshots") + } + + if !strings.Contains(string(out), "repository out-of-date") { + c.Fatalf("Missing expected output on trusted pull with expired snapshot:\n%s", out) + } + }) +} + +func (s *DockerTrustSuite) TestTrustedOfflinePull(c *check.C) { + repoName := s.setupTrustedImage(c, "trusted-offline-pull") + + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmdWithServer(pullCmd, "https://invalidnotaryserver") + out, _, err := runCommandWithOutput(pullCmd) + if err == nil { + c.Fatalf("Expected error pulling with invalid notary server:\n%s", out) + } + + if !strings.Contains(string(out), "error contacting notary server") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } + + // Do valid trusted pull to warm cache + pullCmd = exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err = runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try pull again with invalid notary server, should use cache + pullCmd = exec.Command(dockerBinary, "pull", repoName) + s.trustedCmdWithServer(pullCmd, "https://invalidnotaryserver") + out, _, err = runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted pull:\n%s", out) + } +} diff --git a/integration-cli/docker_cli_push_test.go b/integration-cli/docker_cli_push_test.go new file mode 100644 index 0000000000..ef0164e95a --- /dev/null +++ b/integration-cli/docker_cli_push_test.go @@ -0,0 +1,449 @@ +package main + +import ( + "archive/tar" + "encoding/json" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "strings" + "time" + + "github.com/docker/docker/image" + "github.com/go-check/check" +) + +// Pushing an image to a private registry. +func (s *DockerRegistrySuite) TestPushBusyboxImage(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + // tag the image to upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + // push the image to the registry + dockerCmd(c, "push", repoName) +} + +// pushing an image without a prefix should throw an error +func (s *DockerSuite) TestPushUnprefixedRepo(c *check.C) { + if out, _, err := dockerCmdWithError("push", "busybox"); err == nil { + c.Fatalf("pushing an unprefixed repo didn't result in a non-zero exit status: %s", out) + } +} + +func (s *DockerRegistrySuite) TestPushUntagged(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + + expected := "Repository does not exist" + if out, _, err := dockerCmdWithError("push", repoName); err == nil { + c.Fatalf("pushing the image to the private registry should have failed: output %q", out) + } else if !strings.Contains(out, expected) { + c.Fatalf("pushing the image failed with an unexpected message: expected %q, got %q", expected, out) + } +} + +func (s *DockerRegistrySuite) TestPushBadTag(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox:latest", privateRegistryURL) + + expected := "does not exist" + + if out, _, err := dockerCmdWithError("push", repoName); err == nil { + c.Fatalf("pushing the image to the private registry should have failed: output %q", out) + } else if !strings.Contains(out, expected) { + c.Fatalf("pushing the image failed with an unexpected message: expected %q, got %q", expected, out) + } +} + +func (s *DockerRegistrySuite) TestPushMultipleTags(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/busybox", privateRegistryURL) + repoTag1 := fmt.Sprintf("%v/dockercli/busybox:t1", privateRegistryURL) + repoTag2 := fmt.Sprintf("%v/dockercli/busybox:t2", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoTag1) + + dockerCmd(c, "tag", "busybox", repoTag2) + + dockerCmd(c, "push", repoName) + + // Ensure layer list is equivalent for repoTag1 and repoTag2 + out1, _ := dockerCmd(c, "pull", repoTag1) + if strings.Contains(out1, "Tag t1 not found") { + c.Fatalf("Unable to pull pushed image: %s", out1) + } + imageAlreadyExists := ": Image already exists" + var out1Lines []string + for _, outputLine := range strings.Split(out1, "\n") { + if strings.Contains(outputLine, imageAlreadyExists) { + out1Lines = append(out1Lines, outputLine) + } + } + + out2, _ := dockerCmd(c, "pull", repoTag2) + if strings.Contains(out2, "Tag t2 not found") { + c.Fatalf("Unable to pull pushed image: %s", out1) + } + var out2Lines []string + for _, outputLine := range strings.Split(out2, "\n") { + if strings.Contains(outputLine, imageAlreadyExists) { + out1Lines = append(out1Lines, outputLine) + } + } + + if len(out1Lines) != len(out2Lines) { + c.Fatalf("Mismatched output length:\n%s\n%s", out1, out2) + } + + for i := range out1Lines { + if out1Lines[i] != out2Lines[i] { + c.Fatalf("Mismatched output line:\n%s\n%s", out1Lines[i], out2Lines[i]) + } + } +} + +// TestPushBadParentChain tries to push an image with a corrupted parent chain +// in the v1compatibility files, and makes sure the push process fixes it. +func (s *DockerRegistrySuite) TestPushBadParentChain(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/badparent", privateRegistryURL) + + id, err := buildImage(repoName, ` + FROM busybox + CMD echo "adding another layer" + `, true) + if err != nil { + c.Fatal(err) + } + + // Push to create v1compatibility file + dockerCmd(c, "push", repoName) + + // Corrupt the parent in the v1compatibility file from the top layer + filename := filepath.Join(dockerBasePath, "graph", id, "v1Compatibility") + + jsonBytes, err := ioutil.ReadFile(filename) + c.Assert(err, check.IsNil, check.Commentf("Could not read v1Compatibility file: %s", err)) + + var img image.Image + err = json.Unmarshal(jsonBytes, &img) + c.Assert(err, check.IsNil, check.Commentf("Could not unmarshal json: %s", err)) + + img.Parent = "1234123412341234123412341234123412341234123412341234123412341234" + + jsonBytes, err = json.Marshal(&img) + c.Assert(err, check.IsNil, check.Commentf("Could not marshal json: %s", err)) + + err = ioutil.WriteFile(filename, jsonBytes, 0600) + c.Assert(err, check.IsNil, check.Commentf("Could not write v1Compatibility file: %s", err)) + + dockerCmd(c, "push", repoName) + + // pull should succeed + dockerCmd(c, "pull", repoName) +} + +func (s *DockerRegistrySuite) TestPushEmptyLayer(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/emptylayer", privateRegistryURL) + emptyTarball, err := ioutil.TempFile("", "empty_tarball") + if err != nil { + c.Fatalf("Unable to create test file: %v", err) + } + tw := tar.NewWriter(emptyTarball) + err = tw.Close() + if err != nil { + c.Fatalf("Error creating empty tarball: %v", err) + } + freader, err := os.Open(emptyTarball.Name()) + if err != nil { + c.Fatalf("Could not open test tarball: %v", err) + } + + importCmd := exec.Command(dockerBinary, "import", "-", repoName) + importCmd.Stdin = freader + out, _, err := runCommandWithOutput(importCmd) + if err != nil { + c.Errorf("import failed with errors: %v, output: %q", err, out) + } + + // Now verify we can push it + if out, _, err := dockerCmdWithError("push", repoName); err != nil { + c.Fatalf("pushing the image to the private registry has failed: %s, %v", out, err) + } +} + +func (s *DockerTrustSuite) TestTrustedPush(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithEnvPasswords(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmdWithPassphrases(pushCmd, "12345678", "12345678") + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } +} + +// This test ensures backwards compatibility with old ENV variables. Should be +// deprecated by 1.10 +func (s *DockerTrustSuite) TestTrustedPushWithDeprecatedEnvPasswords(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusteddeprecated:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmdWithDeprecatedEnvPassphrases(pushCmd, "12345678", "12345678") + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithFaillingServer(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmdWithServer(pushCmd, "https://example.com:81/") + out, _, err := runCommandWithOutput(pushCmd) + if err == nil { + c.Fatalf("Missing error while running trusted push w/ no server") + } + + if !strings.Contains(string(out), "error contacting notary server") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithoutServerAndUntrusted(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", "--disable-content-trust", repoName) + s.trustedCmdWithServer(pushCmd, "https://example.com/") + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push with no server and --disable-content-trust failed: %s\n%s", err, out) + } + + if strings.Contains(string(out), "Error establishing connection to notary repository") { + c.Fatalf("Missing expected output on trusted push with --disable-content-trust:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithExistingTag(c *check.C) { + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + dockerCmd(c, "push", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push with existing tag:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithExistingSignedTag(c *check.C) { + repoName := fmt.Sprintf("%v/dockerclipushpush/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + // Do a trusted push + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push with existing tag:\n%s", out) + } + + // Do another trusted push + pushCmd = exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err = runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push with existing tag:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try pull to ensure the double push did not break our ability to pull + pullCmd := exec.Command(dockerBinary, "pull", repoName) + s.trustedCmd(pullCmd) + out, _, err = runCommandWithOutput(pullCmd) + if err != nil { + c.Fatalf("Error running trusted pull: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on trusted pull with --disable-content-trust:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithIncorrectPassphraseForNonRoot(c *check.C) { + repoName := fmt.Sprintf("%v/dockercliincorretpwd/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + // Push with default passphrases + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // Push with wrong passphrases + pushCmd = exec.Command(dockerBinary, "push", repoName) + s.trustedCmdWithPassphrases(pushCmd, "12345678", "87654321") + out, _, err = runCommandWithOutput(pushCmd) + if err == nil { + c.Fatalf("Error missing from trusted push with short targets passphrase: \n%s", out) + } + + if !strings.Contains(string(out), "password invalid, operation has failed") { + c.Fatalf("Missing expected output on trusted push with short targets/snapsnot passphrase:\n%s", out) + } +} + +// This test ensures backwards compatibility with old ENV variables. Should be +// deprecated by 1.10 +func (s *DockerTrustSuite) TestTrustedPushWithIncorrectDeprecatedPassphraseForNonRoot(c *check.C) { + repoName := fmt.Sprintf("%v/dockercliincorretdeprecatedpwd/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + // Push with default passphrases + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // Push with wrong passphrases + pushCmd = exec.Command(dockerBinary, "push", repoName) + s.trustedCmdWithDeprecatedEnvPassphrases(pushCmd, "12345678", "87654321") + out, _, err = runCommandWithOutput(pushCmd) + if err == nil { + c.Fatalf("Error missing from trusted push with short targets passphrase: \n%s", out) + } + + if !strings.Contains(string(out), "password invalid, operation has failed") { + c.Fatalf("Missing expected output on trusted push with short targets/snapsnot passphrase:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestTrustedPushWithExpiredSnapshot(c *check.C) { + c.Skip("Currently changes system time, causing instability") + repoName := fmt.Sprintf("%v/dockercliexpiredsnapshot/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + // Push with default passphrases + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // Snapshots last for three years. This should be expired + fourYearsLater := time.Now().Add(time.Hour * 24 * 365 * 4) + + runAtDifferentDate(fourYearsLater, func() { + // Push with wrong passphrases + pushCmd = exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err = runCommandWithOutput(pushCmd) + if err == nil { + c.Fatalf("Error missing from trusted push with expired snapshot: \n%s", out) + } + + if !strings.Contains(string(out), "repository out-of-date") { + c.Fatalf("Missing expected output on trusted push with expired snapshot:\n%s", out) + } + }) +} + +func (s *DockerTrustSuite) TestTrustedPushWithExpiredTimestamp(c *check.C) { + c.Skip("Currently changes system time, causing instability") + repoName := fmt.Sprintf("%v/dockercliexpiredtimestamppush/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + // Push with default passphrases + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("trusted push failed: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // The timestamps expire in two weeks. Lets check three + threeWeeksLater := time.Now().Add(time.Hour * 24 * 21) + + // Should succeed because the server transparently re-signs one + runAtDifferentDate(threeWeeksLater, func() { + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push with expired timestamp:\n%s", out) + } + }) +} diff --git a/integration-cli/docker_cli_rename_test.go b/integration-cli/docker_cli_rename_test.go new file mode 100644 index 0000000000..df0b26862d --- /dev/null +++ b/integration-cli/docker_cli_rename_test.go @@ -0,0 +1,96 @@ +package main + +import ( + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/stringid" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestRenameStoppedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--name", "first_name", "-d", "busybox", "sh") + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + name, err := inspectField(cleanedContainerID, "Name") + newName := "new_name" + stringid.GenerateNonCryptoID() + dockerCmd(c, "rename", "first_name", newName) + + name, err = inspectField(cleanedContainerID, "Name") + c.Assert(err, checker.IsNil, check.Commentf("Failed to rename container %s", name)) + c.Assert(name, checker.Equals, "/"+newName, check.Commentf("Failed to rename container %s", name)) + +} + +func (s *DockerSuite) TestRenameRunningContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--name", "first_name", "-d", "busybox", "sh") + + newName := "new_name" + stringid.GenerateNonCryptoID() + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "rename", "first_name", newName) + + name, err := inspectField(cleanedContainerID, "Name") + c.Assert(err, checker.IsNil, check.Commentf("Failed to rename container %s", name)) + c.Assert(name, checker.Equals, "/"+newName, check.Commentf("Failed to rename container %s", name)) +} + +func (s *DockerSuite) TestRenameRunningContainerAndReuse(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--name", "first_name", "-d", "busybox", "top") + c.Assert(waitRun("first_name"), check.IsNil) + + newName := "new_name" + ContainerID := strings.TrimSpace(out) + dockerCmd(c, "rename", "first_name", newName) + + name, err := inspectField(ContainerID, "Name") + c.Assert(err, checker.IsNil, check.Commentf("Failed to rename container %s", name)) + c.Assert(name, checker.Equals, "/"+newName, check.Commentf("Failed to rename container")) + + out, _ = dockerCmd(c, "run", "--name", "first_name", "-d", "busybox", "top") + c.Assert(waitRun("first_name"), check.IsNil) + newContainerID := strings.TrimSpace(out) + name, err = inspectField(newContainerID, "Name") + c.Assert(err, checker.IsNil, check.Commentf("Failed to reuse container name")) + c.Assert(name, checker.Equals, "/first_name", check.Commentf("Failed to reuse container name")) +} + +func (s *DockerSuite) TestRenameCheckNames(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "first_name", "-d", "busybox", "sh") + + newName := "new_name" + stringid.GenerateNonCryptoID() + dockerCmd(c, "rename", "first_name", newName) + + name, err := inspectField(newName, "Name") + c.Assert(err, checker.IsNil, check.Commentf("Failed to rename container %s", name)) + c.Assert(name, checker.Equals, "/"+newName, check.Commentf("Failed to rename container %s", name)) + + name, err = inspectField("first_name", "Name") + c.Assert(err, checker.NotNil, check.Commentf(name)) + c.Assert(err.Error(), checker.Contains, "No such image or container: first_name") +} + +func (s *DockerSuite) TestRenameInvalidName(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "myname", "-d", "busybox", "top") + + out, _, err := dockerCmdWithError("rename", "myname", "new:invalid") + c.Assert(err, checker.NotNil, check.Commentf("Renaming container to invalid name should have failed: %s", out)) + c.Assert(out, checker.Contains, "Invalid container name", check.Commentf("%v", err)) + + out, _, err = dockerCmdWithError("rename", "myname", "") + c.Assert(err, checker.NotNil, check.Commentf("Renaming container to invalid name should have failed: %s", out)) + c.Assert(out, checker.Contains, "may be empty", check.Commentf("%v", err)) + + out, _, err = dockerCmdWithError("rename", "", "newname") + c.Assert(err, checker.NotNil, check.Commentf("Renaming container with empty name should have failed: %s", out)) + c.Assert(out, checker.Contains, "may be empty", check.Commentf("%v", err)) + + out, _ = dockerCmd(c, "ps", "-a") + c.Assert(out, checker.Contains, "myname", check.Commentf("Output of docker ps should have included 'myname': %s", out)) +} diff --git a/integration-cli/docker_cli_restart_test.go b/integration-cli/docker_cli_restart_test.go new file mode 100644 index 0000000000..da38056d68 --- /dev/null +++ b/integration-cli/docker_cli_restart_test.go @@ -0,0 +1,150 @@ +package main + +import ( + "strings" + "time" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestRestartStoppedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "echo", "foobar") + + cleanedContainerID := strings.TrimSpace(out) + dockerCmd(c, "wait", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", cleanedContainerID) + if out != "foobar\n" { + c.Errorf("container should've printed 'foobar'") + } + + dockerCmd(c, "restart", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", cleanedContainerID) + if out != "foobar\nfoobar\n" { + c.Errorf("container should've printed 'foobar' twice, got %v", out) + } +} + +func (s *DockerSuite) TestRestartRunningContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", "echo foobar && sleep 30 && echo 'should not print this'") + + cleanedContainerID := strings.TrimSpace(out) + + c.Assert(waitRun(cleanedContainerID), check.IsNil) + + out, _ = dockerCmd(c, "logs", cleanedContainerID) + if out != "foobar\n" { + c.Errorf("container should've printed 'foobar'") + } + + dockerCmd(c, "restart", "-t", "1", cleanedContainerID) + + out, _ = dockerCmd(c, "logs", cleanedContainerID) + + c.Assert(waitRun(cleanedContainerID), check.IsNil) + + if out != "foobar\nfoobar\n" { + c.Errorf("container should've printed 'foobar' twice") + } +} + +// Test that restarting a container with a volume does not create a new volume on restart. Regression test for #819. +func (s *DockerSuite) TestRestartWithVolumes(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "-v", "/test", "busybox", "top") + + cleanedContainerID := strings.TrimSpace(out) + out, _ = dockerCmd(c, "inspect", "--format", "{{ len .Mounts }}", cleanedContainerID) + + if out = strings.Trim(out, " \n\r"); out != "1" { + c.Errorf("expect 1 volume received %s", out) + } + + source, err := inspectMountSourceField(cleanedContainerID, "/test") + c.Assert(err, check.IsNil) + + dockerCmd(c, "restart", cleanedContainerID) + + out, _ = dockerCmd(c, "inspect", "--format", "{{ len .Mounts }}", cleanedContainerID) + if out = strings.Trim(out, " \n\r"); out != "1" { + c.Errorf("expect 1 volume after restart received %s", out) + } + + sourceAfterRestart, err := inspectMountSourceField(cleanedContainerID, "/test") + c.Assert(err, check.IsNil) + + if source != sourceAfterRestart { + c.Errorf("expected volume path: %s Actual path: %s", source, sourceAfterRestart) + } +} + +func (s *DockerSuite) TestRestartPolicyNO(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--restart=no", "busybox", "false") + + id := strings.TrimSpace(string(out)) + name, err := inspectField(id, "HostConfig.RestartPolicy.Name") + c.Assert(err, check.IsNil) + if name != "no" { + c.Fatalf("Container restart policy name is %s, expected %s", name, "no") + } +} + +func (s *DockerSuite) TestRestartPolicyAlways(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--restart=always", "busybox", "false") + + id := strings.TrimSpace(string(out)) + name, err := inspectField(id, "HostConfig.RestartPolicy.Name") + c.Assert(err, check.IsNil) + if name != "always" { + c.Fatalf("Container restart policy name is %s, expected %s", name, "always") + } + + MaximumRetryCount, err := inspectField(id, "HostConfig.RestartPolicy.MaximumRetryCount") + c.Assert(err, check.IsNil) + + // MaximumRetryCount=0 if the restart policy is always + if MaximumRetryCount != "0" { + c.Fatalf("Container Maximum Retry Count is %s, expected %s", MaximumRetryCount, "0") + } +} + +func (s *DockerSuite) TestRestartPolicyOnFailure(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--restart=on-failure:1", "busybox", "false") + + id := strings.TrimSpace(string(out)) + name, err := inspectField(id, "HostConfig.RestartPolicy.Name") + c.Assert(err, check.IsNil) + if name != "on-failure" { + c.Fatalf("Container restart policy name is %s, expected %s", name, "on-failure") + } + +} + +// a good container with --restart=on-failure:3 +// MaximumRetryCount!=0; RestartCount=0 +func (s *DockerSuite) TestContainerRestartwithGoodContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--restart=on-failure:3", "busybox", "true") + + id := strings.TrimSpace(string(out)) + if err := waitInspect(id, "{{ .State.Restarting }} {{ .State.Running }}", "false false", 5*time.Second); err != nil { + c.Fatal(err) + } + count, err := inspectField(id, "RestartCount") + c.Assert(err, check.IsNil) + if count != "0" { + c.Fatalf("Container was restarted %s times, expected %d", count, 0) + } + MaximumRetryCount, err := inspectField(id, "HostConfig.RestartPolicy.MaximumRetryCount") + c.Assert(err, check.IsNil) + if MaximumRetryCount != "3" { + c.Fatalf("Container Maximum Retry Count is %s, expected %s", MaximumRetryCount, "3") + } + +} diff --git a/integration-cli/docker_cli_rm_test.go b/integration-cli/docker_cli_rm_test.go new file mode 100644 index 0000000000..0bfdc05356 --- /dev/null +++ b/integration-cli/docker_cli_rm_test.go @@ -0,0 +1,95 @@ +package main + +import ( + "os" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestRmContainerWithRemovedVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + testRequires(c, SameHostDaemon) + + dockerCmd(c, "run", "--name", "losemyvolumes", "-v", "/tmp/testing:/test", "busybox", "true") + + if err := os.Remove("/tmp/testing"); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "rm", "-v", "losemyvolumes") +} + +func (s *DockerSuite) TestRmContainerWithVolume(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "foo", "-v", "/srv", "busybox", "true") + + dockerCmd(c, "rm", "-v", "foo") +} + +func (s *DockerSuite) TestRmRunningContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + createRunningContainer(c, "foo") + + if _, _, err := dockerCmdWithError("rm", "foo"); err == nil { + c.Fatalf("Expected error, can't rm a running container") + } +} + +func (s *DockerSuite) TestRmForceRemoveRunningContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + createRunningContainer(c, "foo") + + // Stop then remove with -s + dockerCmd(c, "rm", "-f", "foo") +} + +func (s *DockerSuite) TestRmContainerOrphaning(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerfile1 := `FROM busybox:latest + ENTRYPOINT ["/bin/true"]` + img := "test-container-orphaning" + dockerfile2 := `FROM busybox:latest + ENTRYPOINT ["/bin/true"] + MAINTAINER Integration Tests` + + // build first dockerfile + img1, err := buildImage(img, dockerfile1, true) + if err != nil { + c.Fatalf("Could not build image %s: %v", img, err) + } + // run container on first image + if out, _, err := dockerCmdWithError("run", img); err != nil { + c.Fatalf("Could not run image %s: %v: %s", img, err, out) + } + + // rebuild dockerfile with a small addition at the end + if _, err := buildImage(img, dockerfile2, true); err != nil { + c.Fatalf("Could not rebuild image %s: %v", img, err) + } + // try to remove the image, should error out. + if out, _, err := dockerCmdWithError("rmi", img); err == nil { + c.Fatalf("Expected to error out removing the image, but succeeded: %s", out) + } + + // check if we deleted the first image + out, _, err := dockerCmdWithError("images", "-q", "--no-trunc") + if err != nil { + c.Fatalf("%v: %s", err, out) + } + if !strings.Contains(out, img1) { + c.Fatalf("Orphaned container (could not find %q in docker images): %s", img1, out) + } +} + +func (s *DockerSuite) TestRmInvalidContainer(c *check.C) { + if out, _, err := dockerCmdWithError("rm", "unknown"); err == nil { + c.Fatal("Expected error on rm unknown container, got none") + } else if !strings.Contains(out, "failed to remove containers") { + c.Fatalf("Expected output to contain 'failed to remove containers', got %q", out) + } +} + +func createRunningContainer(c *check.C, name string) { + dockerCmd(c, "run", "-dt", "--name", name, "busybox", "top") +} diff --git a/integration-cli/docker_cli_rmi_test.go b/integration-cli/docker_cli_rmi_test.go new file mode 100644 index 0000000000..1f5a5e46c7 --- /dev/null +++ b/integration-cli/docker_cli_rmi_test.go @@ -0,0 +1,399 @@ +package main + +import ( + "fmt" + "os/exec" + "strings" + + "github.com/go-check/check" +) + +func (s *DockerSuite) TestRmiWithContainerFails(c *check.C) { + testRequires(c, DaemonIsLinux) + errSubstr := "is using it" + + // create a container + out, _, err := dockerCmdWithError("run", "-d", "busybox", "true") + if err != nil { + c.Fatalf("failed to create a container: %s, %v", out, err) + } + + cleanedContainerID := strings.TrimSpace(out) + + // try to delete the image + out, _, err = dockerCmdWithError("rmi", "busybox") + if err == nil { + c.Fatalf("Container %q is using image, should not be able to rmi: %q", cleanedContainerID, out) + } + if !strings.Contains(out, errSubstr) { + c.Fatalf("Container %q is using image, error message should contain %q: %v", cleanedContainerID, errSubstr, out) + } + + // make sure it didn't delete the busybox name + images, _ := dockerCmd(c, "images") + if !strings.Contains(images, "busybox") { + c.Fatalf("The name 'busybox' should not have been removed from images: %q", images) + } +} + +func (s *DockerSuite) TestRmiTag(c *check.C) { + testRequires(c, DaemonIsLinux) + imagesBefore, _ := dockerCmd(c, "images", "-a") + dockerCmd(c, "tag", "busybox", "utest:tag1") + dockerCmd(c, "tag", "busybox", "utest/docker:tag2") + dockerCmd(c, "tag", "busybox", "utest:5000/docker:tag3") + { + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Count(imagesAfter, "\n") != strings.Count(imagesBefore, "\n")+3 { + c.Fatalf("before: %q\n\nafter: %q\n", imagesBefore, imagesAfter) + } + } + dockerCmd(c, "rmi", "utest/docker:tag2") + { + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Count(imagesAfter, "\n") != strings.Count(imagesBefore, "\n")+2 { + c.Fatalf("before: %q\n\nafter: %q\n", imagesBefore, imagesAfter) + } + + } + dockerCmd(c, "rmi", "utest:5000/docker:tag3") + { + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Count(imagesAfter, "\n") != strings.Count(imagesBefore, "\n")+1 { + c.Fatalf("before: %q\n\nafter: %q\n", imagesBefore, imagesAfter) + } + + } + dockerCmd(c, "rmi", "utest:tag1") + { + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Count(imagesAfter, "\n") != strings.Count(imagesBefore, "\n")+0 { + c.Fatalf("before: %q\n\nafter: %q\n", imagesBefore, imagesAfter) + } + + } +} + +func (s *DockerSuite) TestRmiImgIDMultipleTag(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "-d", "busybox", "/bin/sh", "-c", "mkdir '/busybox-one'") + if err != nil { + c.Fatalf("failed to create a container:%s, %v", out, err) + } + + containerID := strings.TrimSpace(out) + out, _, err = dockerCmdWithError("commit", containerID, "busybox-one") + if err != nil { + c.Fatalf("failed to commit a new busybox-one:%s, %v", out, err) + } + + imagesBefore, _ := dockerCmd(c, "images", "-a") + dockerCmd(c, "tag", "busybox-one", "busybox-one:tag1") + dockerCmd(c, "tag", "busybox-one", "busybox-one:tag2") + + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Count(imagesAfter, "\n") != strings.Count(imagesBefore, "\n")+2 { + c.Fatalf("tag busybox to create 2 more images with same imageID; docker images shows: %q\n", imagesAfter) + } + + imgID, err := inspectField("busybox-one:tag1", "Id") + c.Assert(err, check.IsNil) + + // run a container with the image + out, _, err = dockerCmdWithError("run", "-d", "busybox-one", "top") + if err != nil { + c.Fatalf("failed to create a container:%s, %v", out, err) + } + + containerID = strings.TrimSpace(out) + + // first checkout without force it fails + out, _, err = dockerCmdWithError("rmi", imgID) + expected := fmt.Sprintf("conflict: unable to delete %s (cannot be forced) - image is being used by running container %s", imgID[:12], containerID[:12]) + if err == nil || !strings.Contains(out, expected) { + c.Fatalf("rmi tagged in multiple repos should have failed without force: %s, %v, expected: %s", out, err, expected) + } + + dockerCmd(c, "stop", containerID) + dockerCmd(c, "rmi", "-f", imgID) + + imagesAfter, _ = dockerCmd(c, "images", "-a") + if strings.Contains(imagesAfter, imgID[:12]) { + c.Fatalf("rmi -f %s failed, image still exists: %q\n\n", imgID, imagesAfter) + } +} + +func (s *DockerSuite) TestRmiImgIDForce(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "-d", "busybox", "/bin/sh", "-c", "mkdir '/busybox-test'") + if err != nil { + c.Fatalf("failed to create a container:%s, %v", out, err) + } + + containerID := strings.TrimSpace(out) + out, _, err = dockerCmdWithError("commit", containerID, "busybox-test") + if err != nil { + c.Fatalf("failed to commit a new busybox-test:%s, %v", out, err) + } + + imagesBefore, _ := dockerCmd(c, "images", "-a") + dockerCmd(c, "tag", "busybox-test", "utest:tag1") + dockerCmd(c, "tag", "busybox-test", "utest:tag2") + dockerCmd(c, "tag", "busybox-test", "utest/docker:tag3") + dockerCmd(c, "tag", "busybox-test", "utest:5000/docker:tag4") + { + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Count(imagesAfter, "\n") != strings.Count(imagesBefore, "\n")+4 { + c.Fatalf("tag busybox to create 4 more images with same imageID; docker images shows: %q\n", imagesAfter) + } + } + imgID, err := inspectField("busybox-test", "Id") + c.Assert(err, check.IsNil) + + // first checkout without force it fails + out, _, err = dockerCmdWithError("rmi", imgID) + if err == nil || !strings.Contains(out, "(must be forced) - image is referenced in one or more repositories") { + c.Fatalf("rmi tagged in multiple repos should have failed without force:%s, %v", out, err) + } + + dockerCmd(c, "rmi", "-f", imgID) + { + imagesAfter, _ := dockerCmd(c, "images", "-a") + if strings.Contains(imagesAfter, imgID[:12]) { + c.Fatalf("rmi -f %s failed, image still exists: %q\n\n", imgID, imagesAfter) + } + } +} + +// See https://github.com/docker/docker/issues/14116 +func (s *DockerSuite) TestRmiImageIDForceWithRunningContainersAndMultipleTags(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerfile := "FROM busybox\nRUN echo test 14116\n" + imgID, err := buildImage("test-14116", dockerfile, false) + c.Assert(err, check.IsNil) + + newTag := "newtag" + dockerCmd(c, "tag", imgID, newTag) + dockerCmd(c, "run", "-d", imgID, "top") + + out, _, err := dockerCmdWithError("rmi", "-f", imgID) + if err == nil || !strings.Contains(out, "(cannot be forced) - image is being used by running container") { + c.Log(out) + c.Fatalf("rmi -f should not delete image with running containers") + } +} + +func (s *DockerSuite) TestRmiTagWithExistingContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + container := "test-delete-tag" + newtag := "busybox:newtag" + bb := "busybox:latest" + if out, _, err := dockerCmdWithError("tag", bb, newtag); err != nil { + c.Fatalf("Could not tag busybox: %v: %s", err, out) + } + if out, _, err := dockerCmdWithError("run", "--name", container, bb, "/bin/true"); err != nil { + c.Fatalf("Could not run busybox: %v: %s", err, out) + } + out, _, err := dockerCmdWithError("rmi", newtag) + if err != nil { + c.Fatalf("Could not remove tag %s: %v: %s", newtag, err, out) + } + if d := strings.Count(out, "Untagged: "); d != 1 { + c.Fatalf("Expected 1 untagged entry got %d: %q", d, out) + } +} + +func (s *DockerSuite) TestRmiForceWithExistingContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + image := "busybox-clone" + + cmd := exec.Command(dockerBinary, "build", "--no-cache", "-t", image, "-") + cmd.Stdin = strings.NewReader(`FROM busybox +MAINTAINER foo`) + + if out, _, err := runCommandWithOutput(cmd); err != nil { + c.Fatalf("Could not build %s: %s, %v", image, out, err) + } + + if out, _, err := dockerCmdWithError("run", "--name", "test-force-rmi", image, "/bin/true"); err != nil { + c.Fatalf("Could not run container: %s, %v", out, err) + } + + if out, _, err := dockerCmdWithError("rmi", "-f", image); err != nil { + c.Fatalf("Could not remove image %s: %s, %v", image, out, err) + } +} + +func (s *DockerSuite) TestRmiWithMultipleRepositories(c *check.C) { + testRequires(c, DaemonIsLinux) + newRepo := "127.0.0.1:5000/busybox" + oldRepo := "busybox" + newTag := "busybox:test" + out, _, err := dockerCmdWithError("tag", oldRepo, newRepo) + if err != nil { + c.Fatalf("Could not tag busybox: %v: %s", err, out) + } + + out, _, err = dockerCmdWithError("run", "--name", "test", oldRepo, "touch", "/home/abcd") + if err != nil { + c.Fatalf("failed to run container: %v, output: %s", err, out) + } + + out, _, err = dockerCmdWithError("commit", "test", newTag) + if err != nil { + c.Fatalf("failed to commit container: %v, output: %s", err, out) + } + + out, _, err = dockerCmdWithError("rmi", newTag) + if err != nil { + c.Fatalf("failed to remove image: %v, output: %s", err, out) + } + if !strings.Contains(out, "Untagged: "+newTag) { + c.Fatalf("Could not remove image %s: %s, %v", newTag, out, err) + } +} + +func (s *DockerSuite) TestRmiForceWithMultipleRepositories(c *check.C) { + testRequires(c, DaemonIsLinux) + imageName := "rmiimage" + tag1 := imageName + ":tag1" + tag2 := imageName + ":tag2" + + _, err := buildImage(tag1, + `FROM scratch + MAINTAINER "docker"`, + true) + if err != nil { + c.Fatal(err) + } + + dockerCmd(c, "tag", tag1, tag2) + + out, _ := dockerCmd(c, "rmi", "-f", tag2) + if !strings.Contains(out, "Untagged: "+tag2) { + c.Fatalf("should contain Untagged: %s", tag2) + } + if strings.Contains(out, "Untagged: "+tag1) { + c.Fatalf("should not contain Untagged: %s", tag1) + } + + // Check built image still exists + images, _ := dockerCmd(c, "images", "-a") + if !strings.Contains(images, imageName) { + c.Fatalf("Built image missing %q; Images: %q", imageName, images) + } +} + +func (s *DockerSuite) TestRmiBlank(c *check.C) { + testRequires(c, DaemonIsLinux) + // try to delete a blank image name + out, _, err := dockerCmdWithError("rmi", "") + if err == nil { + c.Fatal("Should have failed to delete '' image") + } + if strings.Contains(out, "no such id") { + c.Fatalf("Wrong error message generated: %s", out) + } + if !strings.Contains(out, "image name cannot be blank") { + c.Fatalf("Expected error message not generated: %s", out) + } + + out, _, err = dockerCmdWithError("rmi", " ") + if err == nil { + c.Fatal("Should have failed to delete '' image") + } + if !strings.Contains(out, "no such id") { + c.Fatalf("Expected error message not generated: %s", out) + } +} + +func (s *DockerSuite) TestRmiContainerImageNotFound(c *check.C) { + testRequires(c, DaemonIsLinux) + // Build 2 images for testing. + imageNames := []string{"test1", "test2"} + imageIds := make([]string, 2) + for i, name := range imageNames { + dockerfile := fmt.Sprintf("FROM busybox\nMAINTAINER %s\nRUN echo %s\n", name, name) + id, err := buildImage(name, dockerfile, false) + c.Assert(err, check.IsNil) + imageIds[i] = id + } + + // Create a long-running container. + dockerCmd(c, "run", "-d", imageNames[0], "top") + + // Create a stopped container, and then force remove its image. + dockerCmd(c, "run", imageNames[1], "true") + dockerCmd(c, "rmi", "-f", imageIds[1]) + + // Try to remove the image of the running container and see if it fails as expected. + out, _, err := dockerCmdWithError("rmi", "-f", imageIds[0]) + if err == nil || !strings.Contains(out, "image is being used by running container") { + c.Log(out) + c.Fatal("The image of the running container should not be removed.") + } +} + +// #13422 +func (s *DockerSuite) TestRmiUntagHistoryLayer(c *check.C) { + testRequires(c, DaemonIsLinux) + image := "tmp1" + // Build a image for testing. + dockerfile := `FROM busybox +MAINTAINER foo +RUN echo 0 #layer0 +RUN echo 1 #layer1 +RUN echo 2 #layer2 +` + _, err := buildImage(image, dockerfile, false) + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "history", "-q", image) + ids := strings.Split(out, "\n") + idToTag := ids[2] + + // Tag layer0 to "tmp2". + newTag := "tmp2" + dockerCmd(c, "tag", idToTag, newTag) + // Create a container based on "tmp1". + dockerCmd(c, "run", "-d", image, "true") + + // See if the "tmp2" can be untagged. + out, _ = dockerCmd(c, "rmi", newTag) + if d := strings.Count(out, "Untagged: "); d != 1 { + c.Log(out) + c.Fatalf("Expected 1 untagged entry got %d: %q", d, out) + } + + // Now let's add the tag again and create a container based on it. + dockerCmd(c, "tag", idToTag, newTag) + out, _ = dockerCmd(c, "run", "-d", newTag, "true") + cid := strings.TrimSpace(out) + + // At this point we have 2 containers, one based on layer2 and another based on layer0. + // Try to untag "tmp2" without the -f flag. + out, _, err = dockerCmdWithError("rmi", newTag) + if err == nil || !strings.Contains(out, cid[:12]) || !strings.Contains(out, "(must force)") { + c.Log(out) + c.Fatalf("%q should not be untagged without the -f flag", newTag) + } + + // Add the -f flag and test again. + out, _ = dockerCmd(c, "rmi", "-f", newTag) + if !strings.Contains(out, fmt.Sprintf("Untagged: %s:latest", newTag)) { + c.Log(out) + c.Fatalf("%q should be allowed to untag with the -f flag", newTag) + } +} + +func (*DockerSuite) TestRmiParentImageFail(c *check.C) { + testRequires(c, DaemonIsLinux) + + parent, err := inspectField("busybox", "Parent") + c.Assert(err, check.IsNil) + out, _, err := dockerCmdWithError("rmi", parent) + c.Assert(err, check.NotNil) + if !strings.Contains(out, "image has dependent child images") { + c.Fatalf("rmi should have failed because it's a parent image, got %s", out) + } +} diff --git a/integration-cli/docker_cli_run_test.go b/integration-cli/docker_cli_run_test.go new file mode 100644 index 0000000000..cec86a4cf9 --- /dev/null +++ b/integration-cli/docker_cli_run_test.go @@ -0,0 +1,3706 @@ +package main + +import ( + "bufio" + "bytes" + "fmt" + "io/ioutil" + "net" + "os" + "os/exec" + "path" + "path/filepath" + "reflect" + "regexp" + "sort" + "strconv" + "strings" + "sync" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/runconfig" + "github.com/docker/libnetwork/resolvconf" + "github.com/go-check/check" +) + +// "test123" should be printed by docker run +func (s *DockerSuite) TestRunEchoStdout(c *check.C) { + out, _ := dockerCmd(c, "run", "busybox", "echo", "test123") + if out != "test123\n" { + c.Fatalf("container should've printed 'test123', got '%s'", out) + } +} + +// "test" should be printed +func (s *DockerSuite) TestRunEchoNamedContainer(c *check.C) { + out, _ := dockerCmd(c, "run", "--name", "testfoonamedcontainer", "busybox", "echo", "test") + if out != "test\n" { + c.Errorf("container should've printed 'test'") + } +} + +// docker run should not leak file descriptors. This test relies on Unix +// specific functionality and cannot run on Windows. +func (s *DockerSuite) TestRunLeakyFileDescriptors(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "busybox", "ls", "-C", "/proc/self/fd") + + // normally, we should only get 0, 1, and 2, but 3 gets created by "ls" when it does "opendir" on the "fd" directory + if out != "0 1 2 3\n" { + c.Errorf("container should've printed '0 1 2 3', not: %s", out) + } +} + +// it should be possible to lookup Google DNS +// this will fail when Internet access is unavailable +func (s *DockerSuite) TestRunLookupGoogleDns(c *check.C) { + testRequires(c, Network) + image := DefaultImage + if daemonPlatform == "windows" { + // nslookup isn't present in Windows busybox. Is built-in. + image = WindowsBaseImage + } + dockerCmd(c, "run", image, "nslookup", "google.com") +} + +// the exit code should be 0 +// some versions of lxc might make this test fail +func (s *DockerSuite) TestRunExitCodeZero(c *check.C) { + dockerCmd(c, "run", "busybox", "true") +} + +// the exit code should be 1 +// some versions of lxc might make this test fail +func (s *DockerSuite) TestRunExitCodeOne(c *check.C) { + _, exitCode, err := dockerCmdWithError("run", "busybox", "false") + if err != nil && !strings.Contains("exit status 1", fmt.Sprintf("%s", err)) { + c.Fatal(err) + } + if exitCode != 1 { + c.Errorf("container should've exited with exit code 1. Got %d", exitCode) + } +} + +// it should be possible to pipe in data via stdin to a process running in a container +// some versions of lxc might make this test fail +func (s *DockerSuite) TestRunStdinPipe(c *check.C) { + // TODO Windows: This needs some work to make compatible. + testRequires(c, DaemonIsLinux) + runCmd := exec.Command(dockerBinary, "run", "-i", "-a", "stdin", "busybox", "cat") + runCmd.Stdin = strings.NewReader("blahblah") + out, _, _, err := runCommandWithStdoutStderr(runCmd) + if err != nil { + c.Fatalf("failed to run container: %v, output: %q", err, out) + } + + out = strings.TrimSpace(out) + dockerCmd(c, "wait", out) + + logsOut, _ := dockerCmd(c, "logs", out) + + containerLogs := strings.TrimSpace(logsOut) + if containerLogs != "blahblah" { + c.Errorf("logs didn't print the container's logs %s", containerLogs) + } + + dockerCmd(c, "rm", out) +} + +// the container's ID should be printed when starting a container in detached mode +func (s *DockerSuite) TestRunDetachedContainerIDPrinting(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "true") + + out = strings.TrimSpace(out) + dockerCmd(c, "wait", out) + + rmOut, _ := dockerCmd(c, "rm", out) + + rmOut = strings.TrimSpace(rmOut) + if rmOut != out { + c.Errorf("rm didn't print the container ID %s %s", out, rmOut) + } +} + +// the working directory should be set correctly +func (s *DockerSuite) TestRunWorkingDirectory(c *check.C) { + // TODO Windows: There's a Windows bug stopping this from working. + testRequires(c, DaemonIsLinux) + dir := "/root" + image := "busybox" + if daemonPlatform == "windows" { + dir = `/windows` + image = WindowsBaseImage + } + + // First with -w + out, _ := dockerCmd(c, "run", "-w", dir, image, "pwd") + out = strings.TrimSpace(out) + if out != dir { + c.Errorf("-w failed to set working directory") + } + + // Then with --workdir + out, _ = dockerCmd(c, "run", "--workdir", dir, image, "pwd") + out = strings.TrimSpace(out) + if out != dir { + c.Errorf("--workdir failed to set working directory") + } +} + +// pinging Google's DNS resolver should fail when we disable the networking +func (s *DockerSuite) TestRunWithoutNetworking(c *check.C) { + count := "-c" + image := "busybox" + if daemonPlatform == "windows" { + count = "-n" + image = WindowsBaseImage + } + + // First using the long form --net + out, exitCode, err := dockerCmdWithError("run", "--net=none", image, "ping", count, "1", "8.8.8.8") + if err != nil && exitCode != 1 { + c.Fatal(out, err) + } + if exitCode != 1 { + c.Errorf("--net=none should've disabled the network; the container shouldn't have been able to ping 8.8.8.8") + } + + // And then with the short form -n + out, exitCode, err = dockerCmdWithError("run", "-n=false", image, "ping", count, "1", "8.8.8.8") + if err != nil && exitCode != 1 { + c.Fatal(out, err) + } + if exitCode != 1 { + c.Errorf("-n=false should've disabled the network; the container shouldn't have been able to ping 8.8.8.8") + } +} + +//test --link use container name to link target +func (s *DockerSuite) TestRunLinksContainerWithContainerName(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as the networking + // settings are not populated back yet on inspect. + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-i", "-t", "-d", "--name", "parent", "busybox") + + ip, err := inspectField("parent", "NetworkSettings.Networks.bridge.IPAddress") + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "run", "--link", "parent:test", "busybox", "/bin/cat", "/etc/hosts") + if !strings.Contains(out, ip+" test") { + c.Fatalf("use a container name to link target failed") + } +} + +//test --link use container id to link target +func (s *DockerSuite) TestRunLinksContainerWithContainerId(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as the networking + // settings are not populated back yet on inspect. + testRequires(c, DaemonIsLinux) + cID, _ := dockerCmd(c, "run", "-i", "-t", "-d", "busybox") + + cID = strings.TrimSpace(cID) + ip, err := inspectField(cID, "NetworkSettings.Networks.bridge.IPAddress") + c.Assert(err, check.IsNil) + + out, _ := dockerCmd(c, "run", "--link", cID+":test", "busybox", "/bin/cat", "/etc/hosts") + if !strings.Contains(out, ip+" test") { + c.Fatalf("use a container id to link target failed") + } +} + +// Issue 9677. +func (s *DockerSuite) TestRunWithDaemonFlags(c *check.C) { + out, _, err := dockerCmdWithError("--exec-opt", "foo=bar", "run", "-i", "-t", "busybox", "true") + if err != nil { + if !strings.Contains(out, "must follow the 'docker daemon' command") && // daemon + !strings.Contains(out, "flag provided but not defined: --exec-opt") { // no daemon (client-only) + c.Fatal(err, out) + } + } +} + +// Regression test for #4979 +func (s *DockerSuite) TestRunWithVolumesFromExited(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + out, exitCode := dockerCmd(c, "run", "--name", "test-data", "--volume", "/some/dir", "busybox", "touch", "/some/dir/file") + if exitCode != 0 { + c.Fatal("1", out, exitCode) + } + + out, exitCode = dockerCmd(c, "run", "--volumes-from", "test-data", "busybox", "cat", "/some/dir/file") + if exitCode != 0 { + c.Fatal("2", out, exitCode) + } +} + +// Volume path is a symlink which also exists on the host, and the host side is a file not a dir +// But the volume call is just a normal volume, not a bind mount +func (s *DockerSuite) TestRunCreateVolumesInSymlinkDir(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux, SameHostDaemon, NativeExecDriver) + name := "test-volume-symlink" + + dir, err := ioutil.TempDir("", name) + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(dir) + + f, err := os.OpenFile(filepath.Join(dir, "test"), os.O_CREATE, 0700) + if err != nil { + c.Fatal(err) + } + f.Close() + + dockerFile := fmt.Sprintf("FROM busybox\nRUN mkdir -p %s\nRUN ln -s %s /test", dir, dir) + if _, err := buildImage(name, dockerFile, false); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "-v", "/test/test", name) +} + +func (s *DockerSuite) TestRunVolumesMountedAsReadonly(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + if _, code, err := dockerCmdWithError("run", "-v", "/test:/test:ro", "busybox", "touch", "/test/somefile"); err == nil || code == 0 { + c.Fatalf("run should fail because volume is ro: exit code %d", code) + } +} + +func (s *DockerSuite) TestRunVolumesFromInReadonlyMode(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "parent", "-v", "/test", "busybox", "true") + + if _, code, err := dockerCmdWithError("run", "--volumes-from", "parent:ro", "busybox", "touch", "/test/file"); err == nil || code == 0 { + c.Fatalf("run should fail because volume is ro: exit code %d", code) + } +} + +// Regression test for #1201 +func (s *DockerSuite) TestRunVolumesFromInReadWriteMode(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "parent", "-v", "/test", "busybox", "true") + dockerCmd(c, "run", "--volumes-from", "parent:rw", "busybox", "touch", "/test/file") + + if out, _, err := dockerCmdWithError("run", "--volumes-from", "parent:bar", "busybox", "touch", "/test/file"); err == nil || !strings.Contains(out, "invalid mode for volumes-from: bar") { + c.Fatalf("running --volumes-from foo:bar should have failed with invalid mount mode: %q", out) + } + + dockerCmd(c, "run", "--volumes-from", "parent", "busybox", "touch", "/test/file") +} + +func (s *DockerSuite) TestVolumesFromGetsProperMode(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "parent", "-v", "/test:/test:ro", "busybox", "true") + + // Expect this "rw" mode to be be ignored since the inherited volume is "ro" + if _, _, err := dockerCmdWithError("run", "--volumes-from", "parent:rw", "busybox", "touch", "/test/file"); err == nil { + c.Fatal("Expected volumes-from to inherit read-only volume even when passing in `rw`") + } + + dockerCmd(c, "run", "--name", "parent2", "-v", "/test:/test:ro", "busybox", "true") + + // Expect this to be read-only since both are "ro" + if _, _, err := dockerCmdWithError("run", "--volumes-from", "parent2:ro", "busybox", "touch", "/test/file"); err == nil { + c.Fatal("Expected volumes-from to inherit read-only volume even when passing in `ro`") + } +} + +// Test for GH#10618 +func (s *DockerSuite) TestRunNoDupVolumes(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + mountstr1 := randomTmpDirPath("test1", daemonPlatform) + ":/someplace" + mountstr2 := randomTmpDirPath("test2", daemonPlatform) + ":/someplace" + + if out, _, err := dockerCmdWithError("run", "-v", mountstr1, "-v", mountstr2, "busybox", "true"); err == nil { + c.Fatal("Expected error about duplicate volume definitions") + } else { + if !strings.Contains(out, "Duplicate bind mount") { + c.Fatalf("Expected 'duplicate volume' error, got %v", err) + } + } +} + +// Test for #1351 +func (s *DockerSuite) TestRunApplyVolumesFromBeforeVolumes(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "parent", "-v", "/test", "busybox", "touch", "/test/foo") + dockerCmd(c, "run", "--volumes-from", "parent", "-v", "/test", "busybox", "cat", "/test/foo") +} + +func (s *DockerSuite) TestRunMultipleVolumesFrom(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "parent1", "-v", "/test", "busybox", "touch", "/test/foo") + dockerCmd(c, "run", "--name", "parent2", "-v", "/other", "busybox", "touch", "/other/bar") + dockerCmd(c, "run", "--volumes-from", "parent1", "--volumes-from", "parent2", "busybox", "sh", "-c", "cat /test/foo && cat /other/bar") +} + +// this tests verifies the ID format for the container +func (s *DockerSuite) TestRunVerifyContainerID(c *check.C) { + out, exit, err := dockerCmdWithError("run", "-d", "busybox", "true") + if err != nil { + c.Fatal(err) + } + if exit != 0 { + c.Fatalf("expected exit code 0 received %d", exit) + } + + match, err := regexp.MatchString("^[0-9a-f]{64}$", strings.TrimSuffix(out, "\n")) + if err != nil { + c.Fatal(err) + } + if !match { + c.Fatalf("Invalid container ID: %s", out) + } +} + +// Test that creating a container with a volume doesn't crash. Regression test for #995. +func (s *DockerSuite) TestRunCreateVolume(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-v", "/var/lib/data", "busybox", "true") +} + +// Test that creating a volume with a symlink in its path works correctly. Test for #5152. +// Note that this bug happens only with symlinks with a target that starts with '/'. +func (s *DockerSuite) TestRunCreateVolumeWithSymlink(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + image := "docker-test-createvolumewithsymlink" + + buildCmd := exec.Command(dockerBinary, "build", "-t", image, "-") + buildCmd.Stdin = strings.NewReader(`FROM busybox + RUN ln -s home /bar`) + buildCmd.Dir = workingDirectory + err := buildCmd.Run() + if err != nil { + c.Fatalf("could not build '%s': %v", image, err) + } + + _, exitCode, err := dockerCmdWithError("run", "-v", "/bar/foo", "--name", "test-createvolumewithsymlink", image, "sh", "-c", "mount | grep -q /home/foo") + if err != nil || exitCode != 0 { + c.Fatalf("[run] err: %v, exitcode: %d", err, exitCode) + } + + volPath, err := inspectMountSourceField("test-createvolumewithsymlink", "/bar/foo") + if err != nil { + c.Fatalf("[inspect] err: %v", err) + } + + _, exitCode, err = dockerCmdWithError("rm", "-v", "test-createvolumewithsymlink") + if err != nil || exitCode != 0 { + c.Fatalf("[rm] err: %v, exitcode: %d", err, exitCode) + } + + _, err = os.Stat(volPath) + if !os.IsNotExist(err) { + c.Fatalf("[open] (expecting 'file does not exist' error) err: %v, volPath: %s", err, volPath) + } +} + +// Tests that a volume path that has a symlink exists in a container mounting it with `--volumes-from`. +func (s *DockerSuite) TestRunVolumesFromSymlinkPath(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support volumes + testRequires(c, DaemonIsLinux) + name := "docker-test-volumesfromsymlinkpath" + + buildCmd := exec.Command(dockerBinary, "build", "-t", name, "-") + buildCmd.Stdin = strings.NewReader(`FROM busybox + RUN ln -s home /foo + VOLUME ["/foo/bar"]`) + buildCmd.Dir = workingDirectory + err := buildCmd.Run() + if err != nil { + c.Fatalf("could not build 'docker-test-volumesfromsymlinkpath': %v", err) + } + + _, exitCode, err := dockerCmdWithError("run", "--name", "test-volumesfromsymlinkpath", name) + if err != nil || exitCode != 0 { + c.Fatalf("[run] (volume) err: %v, exitcode: %d", err, exitCode) + } + + _, exitCode, err = dockerCmdWithError("run", "--volumes-from", "test-volumesfromsymlinkpath", "busybox", "sh", "-c", "ls /foo | grep -q bar") + if err != nil || exitCode != 0 { + c.Fatalf("[run] err: %v, exitcode: %d", err, exitCode) + } +} + +func (s *DockerSuite) TestRunExitCode(c *check.C) { + var ( + exit int + err error + ) + + _, exit, err = dockerCmdWithError("run", "busybox", "/bin/sh", "-c", "exit 72") + + if err == nil { + c.Fatal("should not have a non nil error") + } + if exit != 72 { + c.Fatalf("expected exit code 72 received %d", exit) + } +} + +func (s *DockerSuite) TestRunUserDefaults(c *check.C) { + expected := "uid=0(root) gid=0(root)" + if daemonPlatform == "windows" { + expected = "uid=1000(SYSTEM) gid=1000(SYSTEM)" + } + out, _ := dockerCmd(c, "run", "busybox", "id") + if !strings.Contains(out, expected) { + c.Fatalf("expected '%s' got %s", expected, out) + } +} + +func (s *DockerSuite) TestRunUserByName(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support the use of -u + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-u", "root", "busybox", "id") + if !strings.Contains(out, "uid=0(root) gid=0(root)") { + c.Fatalf("expected root user got %s", out) + } +} + +func (s *DockerSuite) TestRunUserByID(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support the use of -u + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-u", "1", "busybox", "id") + if !strings.Contains(out, "uid=1(daemon) gid=1(daemon)") { + c.Fatalf("expected daemon user got %s", out) + } +} + +func (s *DockerSuite) TestRunUserByIDBig(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support the use of -u + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "-u", "2147483648", "busybox", "id") + if err == nil { + c.Fatal("No error, but must be.", out) + } + if !strings.Contains(out, "Uids and gids must be in range") { + c.Fatalf("expected error about uids range, got %s", out) + } +} + +func (s *DockerSuite) TestRunUserByIDNegative(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support the use of -u + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "-u", "-1", "busybox", "id") + if err == nil { + c.Fatal("No error, but must be.", out) + } + if !strings.Contains(out, "Uids and gids must be in range") { + c.Fatalf("expected error about uids range, got %s", out) + } +} + +func (s *DockerSuite) TestRunUserByIDZero(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support the use of -u + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "-u", "0", "busybox", "id") + if err != nil { + c.Fatal(err, out) + } + if !strings.Contains(out, "uid=0(root) gid=0(root) groups=10(wheel)") { + c.Fatalf("expected daemon user got %s", out) + } +} + +func (s *DockerSuite) TestRunUserNotFound(c *check.C) { + // TODO Windows: This test cannot run on a Windows daemon as Windows does + // not support the use of -u + testRequires(c, DaemonIsLinux) + _, _, err := dockerCmdWithError("run", "-u", "notme", "busybox", "id") + if err == nil { + c.Fatal("unknown user should cause container to fail") + } +} + +func (s *DockerSuite) TestRunTwoConcurrentContainers(c *check.C) { + sleepTime := "2" + if daemonPlatform == "windows" { + sleepTime = "5" // Make more reliable on Windows + } + group := sync.WaitGroup{} + group.Add(2) + + errChan := make(chan error, 2) + for i := 0; i < 2; i++ { + go func() { + defer group.Done() + _, _, err := dockerCmdWithError("run", "busybox", "sleep", sleepTime) + errChan <- err + }() + } + + group.Wait() + close(errChan) + + for err := range errChan { + c.Assert(err, check.IsNil) + } +} + +func (s *DockerSuite) TestRunEnvironment(c *check.C) { + // TODO Windows: Environment handling is different between Linux and + // Windows and this test relies currently on lxc and unix functionality. + testRequires(c, DaemonIsLinux) + cmd := exec.Command(dockerBinary, "run", "-h", "testing", "-e=FALSE=true", "-e=TRUE", "-e=TRICKY", "-e=HOME=", "busybox", "env") + cmd.Env = append(os.Environ(), + "TRUE=false", + "TRICKY=tri\ncky\n", + ) + + out, _, err := runCommandWithOutput(cmd) + if err != nil { + c.Fatal(err, out) + } + + actualEnvLxc := strings.Split(strings.TrimSpace(out), "\n") + actualEnv := []string{} + for i := range actualEnvLxc { + if actualEnvLxc[i] != "container=lxc" { + actualEnv = append(actualEnv, actualEnvLxc[i]) + } + } + sort.Strings(actualEnv) + + goodEnv := []string{ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", + "HOSTNAME=testing", + "FALSE=true", + "TRUE=false", + "TRICKY=tri", + "cky", + "", + "HOME=/root", + } + sort.Strings(goodEnv) + if len(goodEnv) != len(actualEnv) { + c.Fatalf("Wrong environment: should be %d variables, not: %q\n", len(goodEnv), strings.Join(actualEnv, ", ")) + } + for i := range goodEnv { + if actualEnv[i] != goodEnv[i] { + c.Fatalf("Wrong environment variable: should be %s, not %s", goodEnv[i], actualEnv[i]) + } + } +} + +func (s *DockerSuite) TestRunEnvironmentErase(c *check.C) { + // TODO Windows: Environment handling is different between Linux and + // Windows and this test relies currently on lxc and unix functionality. + testRequires(c, DaemonIsLinux) + + // Test to make sure that when we use -e on env vars that are + // not set in our local env that they're removed (if present) in + // the container + + cmd := exec.Command(dockerBinary, "run", "-e", "FOO", "-e", "HOSTNAME", "busybox", "env") + cmd.Env = appendBaseEnv([]string{}) + + out, _, err := runCommandWithOutput(cmd) + if err != nil { + c.Fatal(err, out) + } + + actualEnvLxc := strings.Split(strings.TrimSpace(out), "\n") + actualEnv := []string{} + for i := range actualEnvLxc { + if actualEnvLxc[i] != "container=lxc" { + actualEnv = append(actualEnv, actualEnvLxc[i]) + } + } + sort.Strings(actualEnv) + + goodEnv := []string{ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", + "HOME=/root", + } + sort.Strings(goodEnv) + if len(goodEnv) != len(actualEnv) { + c.Fatalf("Wrong environment: should be %d variables, not: %q\n", len(goodEnv), strings.Join(actualEnv, ", ")) + } + for i := range goodEnv { + if actualEnv[i] != goodEnv[i] { + c.Fatalf("Wrong environment variable: should be %s, not %s", goodEnv[i], actualEnv[i]) + } + } +} + +func (s *DockerSuite) TestRunEnvironmentOverride(c *check.C) { + // TODO Windows: Environment handling is different between Linux and + // Windows and this test relies currently on lxc and unix functionality. + testRequires(c, DaemonIsLinux) + + // Test to make sure that when we use -e on env vars that are + // already in the env that we're overriding them + + cmd := exec.Command(dockerBinary, "run", "-e", "HOSTNAME", "-e", "HOME=/root2", "busybox", "env") + cmd.Env = appendBaseEnv([]string{"HOSTNAME=bar"}) + + out, _, err := runCommandWithOutput(cmd) + if err != nil { + c.Fatal(err, out) + } + + actualEnvLxc := strings.Split(strings.TrimSpace(out), "\n") + actualEnv := []string{} + for i := range actualEnvLxc { + if actualEnvLxc[i] != "container=lxc" { + actualEnv = append(actualEnv, actualEnvLxc[i]) + } + } + sort.Strings(actualEnv) + + goodEnv := []string{ + "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", + "HOME=/root2", + "HOSTNAME=bar", + } + sort.Strings(goodEnv) + if len(goodEnv) != len(actualEnv) { + c.Fatalf("Wrong environment: should be %d variables, not: %q\n", len(goodEnv), strings.Join(actualEnv, ", ")) + } + for i := range goodEnv { + if actualEnv[i] != goodEnv[i] { + c.Fatalf("Wrong environment variable: should be %s, not %s", goodEnv[i], actualEnv[i]) + } + } +} + +func (s *DockerSuite) TestRunContainerNetwork(c *check.C) { + if daemonPlatform == "windows" { + // Windows busybox does not have ping. Use built in ping instead. + dockerCmd(c, "run", WindowsBaseImage, "ping", "-n", "1", "127.0.0.1") + } else { + dockerCmd(c, "run", "busybox", "ping", "-c", "1", "127.0.0.1") + } +} + +func (s *DockerSuite) TestRunNetHostNotAllowedWithLinks(c *check.C) { + // TODO Windows: This is Linux specific as --link is not supported and + // this will be deprecated in favour of container networking model. + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "--name", "linked", "busybox", "true") + + _, _, err := dockerCmdWithError("run", "--net=host", "--link", "linked:linked", "busybox", "true") + if err == nil { + c.Fatal("Expected error") + } +} + +// #7851 hostname outside container shows FQDN, inside only shortname +// For testing purposes it is not required to set host's hostname directly +// and use "--net=host" (as the original issue submitter did), as the same +// codepath is executed with "docker run -h ". Both were manually +// tested, but this testcase takes the simpler path of using "run -h .." +func (s *DockerSuite) TestRunFullHostnameSet(c *check.C) { + // TODO Windows: -h is not yet functional. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-h", "foo.bar.baz", "busybox", "hostname") + if actual := strings.Trim(out, "\r\n"); actual != "foo.bar.baz" { + c.Fatalf("expected hostname 'foo.bar.baz', received %s", actual) + } +} + +func (s *DockerSuite) TestRunPrivilegedCanMknod(c *check.C) { + // Not applicable for Windows as Windows daemon does not support + // the concept of --privileged, and mknod is a Unix concept. + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--privileged", "busybox", "sh", "-c", "mknod /tmp/sda b 8 0 && echo ok") + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunUnprivilegedCanMknod(c *check.C) { + // Not applicable for Windows as Windows daemon does not support + // the concept of --privileged, and mknod is a Unix concept. + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "busybox", "sh", "-c", "mknod /tmp/sda b 8 0 && echo ok") + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapDropInvalid(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-drop + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--cap-drop=CHPASS", "busybox", "ls") + if err == nil { + c.Fatal(err, out) + } +} + +func (s *DockerSuite) TestRunCapDropCannotMknod(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-drop or mknod + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--cap-drop=MKNOD", "busybox", "sh", "-c", "mknod /tmp/sda b 8 0 && echo ok") + + if err == nil { + c.Fatal(err, out) + } + if actual := strings.Trim(out, "\r\n"); actual == "ok" { + c.Fatalf("expected output not ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapDropCannotMknodLowerCase(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-drop or mknod + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--cap-drop=mknod", "busybox", "sh", "-c", "mknod /tmp/sda b 8 0 && echo ok") + + if err == nil { + c.Fatal(err, out) + } + if actual := strings.Trim(out, "\r\n"); actual == "ok" { + c.Fatalf("expected output not ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapDropALLCannotMknod(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-drop or mknod + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--cap-drop=ALL", "--cap-add=SETGID", "busybox", "sh", "-c", "mknod /tmp/sda b 8 0 && echo ok") + if err == nil { + c.Fatal(err, out) + } + if actual := strings.Trim(out, "\r\n"); actual == "ok" { + c.Fatalf("expected output not ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapDropALLAddMknodCanMknod(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-drop or mknod + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--cap-drop=ALL", "--cap-add=MKNOD", "--cap-add=SETGID", "busybox", "sh", "-c", "mknod /tmp/sda b 8 0 && echo ok") + + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapAddInvalid(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-add + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--cap-add=CHPASS", "busybox", "ls") + if err == nil { + c.Fatal(err, out) + } +} + +func (s *DockerSuite) TestRunCapAddCanDownInterface(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-add + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--cap-add=NET_ADMIN", "busybox", "sh", "-c", "ip link set eth0 down && echo ok") + + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapAddALLCanDownInterface(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-add + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--cap-add=ALL", "busybox", "sh", "-c", "ip link set eth0 down && echo ok") + + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunCapAddALLDropNetAdminCanDownInterface(c *check.C) { + // Not applicable for Windows as there is no concept of --cap-add + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "--cap-add=ALL", "--cap-drop=NET_ADMIN", "busybox", "sh", "-c", "ip link set eth0 down && echo ok") + if err == nil { + c.Fatal(err, out) + } + if actual := strings.Trim(out, "\r\n"); actual == "ok" { + c.Fatalf("expected output not ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunGroupAdd(c *check.C) { + // Not applicable for Windows as there is no concept of --group-add + testRequires(c, DaemonIsLinux, NativeExecDriver) + out, _ := dockerCmd(c, "run", "--group-add=audio", "--group-add=dbus", "--group-add=777", "busybox", "sh", "-c", "id") + + groupsList := "uid=0(root) gid=0(root) groups=10(wheel),29(audio),81(dbus),777" + if actual := strings.Trim(out, "\r\n"); actual != groupsList { + c.Fatalf("expected output %s received %s", groupsList, actual) + } +} + +func (s *DockerSuite) TestRunPrivilegedCanMount(c *check.C) { + // Not applicable for Windows as there is no concept of --privileged + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--privileged", "busybox", "sh", "-c", "mount -t tmpfs none /tmp && echo ok") + + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunUnprivilegedCannotMount(c *check.C) { + // Not applicable for Windows as there is no concept of unprivileged + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "busybox", "sh", "-c", "mount -t tmpfs none /tmp && echo ok") + + if err == nil { + c.Fatal(err, out) + } + if actual := strings.Trim(out, "\r\n"); actual == "ok" { + c.Fatalf("expected output not ok received %s", actual) + } +} + +func (s *DockerSuite) TestRunSysNotWritableInNonPrivilegedContainers(c *check.C) { + // Not applicable for Windows as there is no concept of unprivileged + testRequires(c, DaemonIsLinux) + if _, code, err := dockerCmdWithError("run", "busybox", "touch", "/sys/kernel/profiling"); err == nil || code == 0 { + c.Fatal("sys should not be writable in a non privileged container") + } +} + +func (s *DockerSuite) TestRunSysWritableInPrivilegedContainers(c *check.C) { + // Not applicable for Windows as there is no concept of unprivileged + testRequires(c, DaemonIsLinux, NotUserNamespace) + if _, code, err := dockerCmdWithError("run", "--privileged", "busybox", "touch", "/sys/kernel/profiling"); err != nil || code != 0 { + c.Fatalf("sys should be writable in privileged container") + } +} + +func (s *DockerSuite) TestRunProcNotWritableInNonPrivilegedContainers(c *check.C) { + // Not applicable for Windows as there is no concept of unprivileged + testRequires(c, DaemonIsLinux) + if _, code, err := dockerCmdWithError("run", "busybox", "touch", "/proc/sysrq-trigger"); err == nil || code == 0 { + c.Fatal("proc should not be writable in a non privileged container") + } +} + +func (s *DockerSuite) TestRunProcWritableInPrivilegedContainers(c *check.C) { + // Not applicable for Windows as there is no concept of --privileged + testRequires(c, DaemonIsLinux, NotUserNamespace) + if _, code := dockerCmd(c, "run", "--privileged", "busybox", "touch", "/proc/sysrq-trigger"); code != 0 { + c.Fatalf("proc should be writable in privileged container") + } +} + +func (s *DockerSuite) TestRunDeviceNumbers(c *check.C) { + // Not applicable on Windows as /dev/ is a Unix specific concept + // TODO: NotUserNamespace could be removed here if "root" "root" is replaced w user + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "busybox", "sh", "-c", "ls -l /dev/null") + deviceLineFields := strings.Fields(out) + deviceLineFields[6] = "" + deviceLineFields[7] = "" + deviceLineFields[8] = "" + expected := []string{"crw-rw-rw-", "1", "root", "root", "1,", "3", "", "", "", "/dev/null"} + + if !(reflect.DeepEqual(deviceLineFields, expected)) { + c.Fatalf("expected output\ncrw-rw-rw- 1 root root 1, 3 May 24 13:29 /dev/null\n received\n %s\n", out) + } +} + +func (s *DockerSuite) TestRunThatCharacterDevicesActLikeCharacterDevices(c *check.C) { + // Not applicable on Windows as /dev/ is a Unix specific concept + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "busybox", "sh", "-c", "dd if=/dev/zero of=/zero bs=1k count=5 2> /dev/null ; du -h /zero") + if actual := strings.Trim(out, "\r\n"); actual[0] == '0' { + c.Fatalf("expected a new file called /zero to be create that is greater than 0 bytes long, but du says: %s", actual) + } +} + +func (s *DockerSuite) TestRunUnprivilegedWithChroot(c *check.C) { + // Not applicable on Windows as it does not support chroot + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "busybox", "chroot", "/", "true") +} + +func (s *DockerSuite) TestRunAddingOptionalDevices(c *check.C) { + // Not applicable on Windows as Windows does not support --device + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--device", "/dev/zero:/dev/nulo", "busybox", "sh", "-c", "ls /dev/nulo") + if actual := strings.Trim(out, "\r\n"); actual != "/dev/nulo" { + c.Fatalf("expected output /dev/nulo, received %s", actual) + } +} + +func (s *DockerSuite) TestRunAddingOptionalDevicesNoSrc(c *check.C) { + // Not applicable on Windows as Windows does not support --device + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--device", "/dev/zero:rw", "busybox", "sh", "-c", "ls /dev/zero") + if actual := strings.Trim(out, "\r\n"); actual != "/dev/zero" { + c.Fatalf("expected output /dev/zero, received %s", actual) + } +} + +func (s *DockerSuite) TestRunAddingOptionalDevicesInvalidMode(c *check.C) { + // Not applicable on Windows as Windows does not support --device + testRequires(c, DaemonIsLinux, NotUserNamespace) + _, _, err := dockerCmdWithError("run", "--device", "/dev/zero:ro", "busybox", "sh", "-c", "ls /dev/zero") + if err == nil { + c.Fatalf("run container with device mode ro should fail") + } +} + +func (s *DockerSuite) TestRunModeHostname(c *check.C) { + // Not applicable on Windows as Windows does not support -h + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + out, _ := dockerCmd(c, "run", "-h=testhostname", "busybox", "cat", "/etc/hostname") + + if actual := strings.Trim(out, "\r\n"); actual != "testhostname" { + c.Fatalf("expected 'testhostname', but says: %q", actual) + } + + out, _ = dockerCmd(c, "run", "--net=host", "busybox", "cat", "/etc/hostname") + + hostname, err := os.Hostname() + if err != nil { + c.Fatal(err) + } + if actual := strings.Trim(out, "\r\n"); actual != hostname { + c.Fatalf("expected %q, but says: %q", hostname, actual) + } +} + +func (s *DockerSuite) TestRunRootWorkdir(c *check.C) { + out, _ := dockerCmd(c, "run", "--workdir", "/", "busybox", "pwd") + expected := "/\n" + if daemonPlatform == "windows" { + expected = "C:" + expected + } + if out != expected { + c.Fatalf("pwd returned %q (expected %s)", s, expected) + } +} + +func (s *DockerSuite) TestRunAllowBindMountingRoot(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-v", "/:/host", "busybox", "ls", "/host") +} + +func (s *DockerSuite) TestRunDisallowBindMountingRootToRoot(c *check.C) { + // Not applicable on Windows as Windows does not support volumes + testRequires(c, DaemonIsLinux) + out, _, err := dockerCmdWithError("run", "-v", "/:/", "busybox", "ls", "/host") + if err == nil { + c.Fatal(out, err) + } +} + +// Verify that a container gets default DNS when only localhost resolvers exist +func (s *DockerSuite) TestRunDnsDefaultOptions(c *check.C) { + // Not applicable on Windows as this is testing Unix specific functionality + testRequires(c, SameHostDaemon, DaemonIsLinux) + + // preserve original resolv.conf for restoring after test + origResolvConf, err := ioutil.ReadFile("/etc/resolv.conf") + if os.IsNotExist(err) { + c.Fatalf("/etc/resolv.conf does not exist") + } + // defer restored original conf + defer func() { + if err := ioutil.WriteFile("/etc/resolv.conf", origResolvConf, 0644); err != nil { + c.Fatal(err) + } + }() + + // test 3 cases: standard IPv4 localhost, commented out localhost, and IPv6 localhost + // 2 are removed from the file at container start, and the 3rd (commented out) one is ignored by + // GetNameservers(), leading to a replacement of nameservers with the default set + tmpResolvConf := []byte("nameserver 127.0.0.1\n#nameserver 127.0.2.1\nnameserver ::1") + if err := ioutil.WriteFile("/etc/resolv.conf", tmpResolvConf, 0644); err != nil { + c.Fatal(err) + } + + actual, _ := dockerCmd(c, "run", "busybox", "cat", "/etc/resolv.conf") + // check that the actual defaults are appended to the commented out + // localhost resolver (which should be preserved) + // NOTE: if we ever change the defaults from google dns, this will break + expected := "#nameserver 127.0.2.1\n\nnameserver 8.8.8.8\nnameserver 8.8.4.4\n" + if actual != expected { + c.Fatalf("expected resolv.conf be: %q, but was: %q", expected, actual) + } +} + +func (s *DockerSuite) TestRunDnsOptions(c *check.C) { + // Not applicable on Windows as Windows does not support --dns*, or + // the Unix-specific functionality of resolv.conf. + testRequires(c, DaemonIsLinux) + out, stderr, _ := dockerCmdWithStdoutStderr(c, "run", "--dns=127.0.0.1", "--dns-search=mydomain", "--dns-opt=ndots:9", "busybox", "cat", "/etc/resolv.conf") + + // The client will get a warning on stderr when setting DNS to a localhost address; verify this: + if !strings.Contains(stderr, "Localhost DNS setting") { + c.Fatalf("Expected warning on stderr about localhost resolver, but got %q", stderr) + } + + actual := strings.Replace(strings.Trim(out, "\r\n"), "\n", " ", -1) + if actual != "search mydomain nameserver 127.0.0.1 options ndots:9" { + c.Fatalf("expected 'search mydomain nameserver 127.0.0.1 options ndots:9', but says: %q", actual) + } + + out, stderr, _ = dockerCmdWithStdoutStderr(c, "run", "--dns=127.0.0.1", "--dns-search=.", "--dns-opt=ndots:3", "busybox", "cat", "/etc/resolv.conf") + + actual = strings.Replace(strings.Trim(strings.Trim(out, "\r\n"), " "), "\n", " ", -1) + if actual != "nameserver 127.0.0.1 options ndots:3" { + c.Fatalf("expected 'nameserver 127.0.0.1 options ndots:3', but says: %q", actual) + } +} + +func (s *DockerSuite) TestRunDnsRepeatOptions(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _, _ := dockerCmdWithStdoutStderr(c, "run", "--dns=1.1.1.1", "--dns=2.2.2.2", "--dns-search=mydomain", "--dns-search=mydomain2", "--dns-opt=ndots:9", "--dns-opt=timeout:3", "busybox", "cat", "/etc/resolv.conf") + + actual := strings.Replace(strings.Trim(out, "\r\n"), "\n", " ", -1) + if actual != "search mydomain mydomain2 nameserver 1.1.1.1 nameserver 2.2.2.2 options ndots:9 timeout:3" { + c.Fatalf("expected 'search mydomain mydomain2 nameserver 1.1.1.1 nameserver 2.2.2.2 options ndots:9 timeout:3', but says: %q", actual) + } +} + +func (s *DockerSuite) TestRunDnsOptionsBasedOnHostResolvConf(c *check.C) { + // Not applicable on Windows as testing Unix specific functionality + testRequires(c, SameHostDaemon, DaemonIsLinux) + + origResolvConf, err := ioutil.ReadFile("/etc/resolv.conf") + if os.IsNotExist(err) { + c.Fatalf("/etc/resolv.conf does not exist") + } + + hostNamservers := resolvconf.GetNameservers(origResolvConf) + hostSearch := resolvconf.GetSearchDomains(origResolvConf) + + var out string + out, _ = dockerCmd(c, "run", "--dns=127.0.0.1", "busybox", "cat", "/etc/resolv.conf") + + if actualNameservers := resolvconf.GetNameservers([]byte(out)); string(actualNameservers[0]) != "127.0.0.1" { + c.Fatalf("expected '127.0.0.1', but says: %q", string(actualNameservers[0])) + } + + actualSearch := resolvconf.GetSearchDomains([]byte(out)) + if len(actualSearch) != len(hostSearch) { + c.Fatalf("expected %q search domain(s), but it has: %q", len(hostSearch), len(actualSearch)) + } + for i := range actualSearch { + if actualSearch[i] != hostSearch[i] { + c.Fatalf("expected %q domain, but says: %q", actualSearch[i], hostSearch[i]) + } + } + + out, _ = dockerCmd(c, "run", "--dns-search=mydomain", "busybox", "cat", "/etc/resolv.conf") + + actualNameservers := resolvconf.GetNameservers([]byte(out)) + if len(actualNameservers) != len(hostNamservers) { + c.Fatalf("expected %q nameserver(s), but it has: %q", len(hostNamservers), len(actualNameservers)) + } + for i := range actualNameservers { + if actualNameservers[i] != hostNamservers[i] { + c.Fatalf("expected %q nameserver, but says: %q", actualNameservers[i], hostNamservers[i]) + } + } + + if actualSearch = resolvconf.GetSearchDomains([]byte(out)); string(actualSearch[0]) != "mydomain" { + c.Fatalf("expected 'mydomain', but says: %q", string(actualSearch[0])) + } + + // test with file + tmpResolvConf := []byte("search example.com\nnameserver 12.34.56.78\nnameserver 127.0.0.1") + if err := ioutil.WriteFile("/etc/resolv.conf", tmpResolvConf, 0644); err != nil { + c.Fatal(err) + } + // put the old resolvconf back + defer func() { + if err := ioutil.WriteFile("/etc/resolv.conf", origResolvConf, 0644); err != nil { + c.Fatal(err) + } + }() + + resolvConf, err := ioutil.ReadFile("/etc/resolv.conf") + if os.IsNotExist(err) { + c.Fatalf("/etc/resolv.conf does not exist") + } + + hostNamservers = resolvconf.GetNameservers(resolvConf) + hostSearch = resolvconf.GetSearchDomains(resolvConf) + + out, _ = dockerCmd(c, "run", "busybox", "cat", "/etc/resolv.conf") + if actualNameservers = resolvconf.GetNameservers([]byte(out)); string(actualNameservers[0]) != "12.34.56.78" || len(actualNameservers) != 1 { + c.Fatalf("expected '12.34.56.78', but has: %v", actualNameservers) + } + + actualSearch = resolvconf.GetSearchDomains([]byte(out)) + if len(actualSearch) != len(hostSearch) { + c.Fatalf("expected %q search domain(s), but it has: %q", len(hostSearch), len(actualSearch)) + } + for i := range actualSearch { + if actualSearch[i] != hostSearch[i] { + c.Fatalf("expected %q domain, but says: %q", actualSearch[i], hostSearch[i]) + } + } +} + +// Test to see if a non-root user can resolve a DNS name and reach out to it. Also +// check if the container resolv.conf file has at least 0644 perm. +func (s *DockerSuite) TestRunNonRootUserResolvName(c *check.C) { + // Not applicable on Windows as Windows does not support --user + testRequires(c, SameHostDaemon, Network, DaemonIsLinux) + + dockerCmd(c, "run", "--name=testperm", "--user=default", "busybox", "ping", "-c", "1", "apt.dockerproject.org") + + cID, err := getIDByName("testperm") + if err != nil { + c.Fatal(err) + } + + fmode := (os.FileMode)(0644) + finfo, err := os.Stat(containerStorageFile(cID, "resolv.conf")) + if err != nil { + c.Fatal(err) + } + + if (finfo.Mode() & fmode) != fmode { + c.Fatalf("Expected container resolv.conf mode to be at least %s, instead got %s", fmode.String(), finfo.Mode().String()) + } +} + +// Test if container resolv.conf gets updated the next time it restarts +// if host /etc/resolv.conf has changed. This only applies if the container +// uses the host's /etc/resolv.conf and does not have any dns options provided. +func (s *DockerSuite) TestRunResolvconfUpdate(c *check.C) { + // Not applicable on Windows as testing unix specific functionality + testRequires(c, SameHostDaemon, DaemonIsLinux, NativeExecDriver) + + tmpResolvConf := []byte("search pommesfrites.fr\nnameserver 12.34.56.78\n") + tmpLocalhostResolvConf := []byte("nameserver 127.0.0.1") + + //take a copy of resolv.conf for restoring after test completes + resolvConfSystem, err := ioutil.ReadFile("/etc/resolv.conf") + if err != nil { + c.Fatal(err) + } + + // This test case is meant to test monitoring resolv.conf when it is + // a regular file not a bind mounc. So we unmount resolv.conf and replace + // it with a file containing the original settings. + cmd := exec.Command("umount", "/etc/resolv.conf") + if _, err = runCommand(cmd); err != nil { + c.Fatal(err) + } + + //cleanup + defer func() { + if err := ioutil.WriteFile("/etc/resolv.conf", resolvConfSystem, 0644); err != nil { + c.Fatal(err) + } + }() + + //1. test that a restarting container gets an updated resolv.conf + dockerCmd(c, "run", "--name='first'", "busybox", "true") + containerID1, err := getIDByName("first") + if err != nil { + c.Fatal(err) + } + + // replace resolv.conf with our temporary copy + bytesResolvConf := []byte(tmpResolvConf) + if err := ioutil.WriteFile("/etc/resolv.conf", bytesResolvConf, 0644); err != nil { + c.Fatal(err) + } + + // start the container again to pickup changes + dockerCmd(c, "start", "first") + + // check for update in container + containerResolv, err := readContainerFile(containerID1, "resolv.conf") + if err != nil { + c.Fatal(err) + } + if !bytes.Equal(containerResolv, bytesResolvConf) { + c.Fatalf("Restarted container does not have updated resolv.conf; expected %q, got %q", tmpResolvConf, string(containerResolv)) + } + + /* //make a change to resolv.conf (in this case replacing our tmp copy with orig copy) + if err := ioutil.WriteFile("/etc/resolv.conf", resolvConfSystem, 0644); err != nil { + c.Fatal(err) + } */ + //2. test that a restarting container does not receive resolv.conf updates + // if it modified the container copy of the starting point resolv.conf + dockerCmd(c, "run", "--name='second'", "busybox", "sh", "-c", "echo 'search mylittlepony.com' >>/etc/resolv.conf") + containerID2, err := getIDByName("second") + if err != nil { + c.Fatal(err) + } + + //make a change to resolv.conf (in this case replacing our tmp copy with orig copy) + if err := ioutil.WriteFile("/etc/resolv.conf", resolvConfSystem, 0644); err != nil { + c.Fatal(err) + } + + // start the container again + dockerCmd(c, "start", "second") + + // check for update in container + containerResolv, err = readContainerFile(containerID2, "resolv.conf") + if err != nil { + c.Fatal(err) + } + + if bytes.Equal(containerResolv, resolvConfSystem) { + c.Fatalf("Restarting a container after container updated resolv.conf should not pick up host changes; expected %q, got %q", string(containerResolv), string(resolvConfSystem)) + } + + //3. test that a running container's resolv.conf is not modified while running + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + runningContainerID := strings.TrimSpace(out) + + // replace resolv.conf + if err := ioutil.WriteFile("/etc/resolv.conf", bytesResolvConf, 0644); err != nil { + c.Fatal(err) + } + + // check for update in container + containerResolv, err = readContainerFile(runningContainerID, "resolv.conf") + if err != nil { + c.Fatal(err) + } + + if bytes.Equal(containerResolv, bytesResolvConf) { + c.Fatalf("Running container should not have updated resolv.conf; expected %q, got %q", string(resolvConfSystem), string(containerResolv)) + } + + //4. test that a running container's resolv.conf is updated upon restart + // (the above container is still running..) + dockerCmd(c, "restart", runningContainerID) + + // check for update in container + containerResolv, err = readContainerFile(runningContainerID, "resolv.conf") + if err != nil { + c.Fatal(err) + } + if !bytes.Equal(containerResolv, bytesResolvConf) { + c.Fatalf("Restarted container should have updated resolv.conf; expected %q, got %q", string(bytesResolvConf), string(containerResolv)) + } + + //5. test that additions of a localhost resolver are cleaned from + // host resolv.conf before updating container's resolv.conf copies + + // replace resolv.conf with a localhost-only nameserver copy + bytesResolvConf = []byte(tmpLocalhostResolvConf) + if err = ioutil.WriteFile("/etc/resolv.conf", bytesResolvConf, 0644); err != nil { + c.Fatal(err) + } + + // start the container again to pickup changes + dockerCmd(c, "start", "first") + + // our first exited container ID should have been updated, but with default DNS + // after the cleanup of resolv.conf found only a localhost nameserver: + containerResolv, err = readContainerFile(containerID1, "resolv.conf") + if err != nil { + c.Fatal(err) + } + + expected := "\nnameserver 8.8.8.8\nnameserver 8.8.4.4\n" + if !bytes.Equal(containerResolv, []byte(expected)) { + c.Fatalf("Container does not have cleaned/replaced DNS in resolv.conf; expected %q, got %q", expected, string(containerResolv)) + } + + //6. Test that replacing (as opposed to modifying) resolv.conf triggers an update + // of containers' resolv.conf. + + // Restore the original resolv.conf + if err := ioutil.WriteFile("/etc/resolv.conf", resolvConfSystem, 0644); err != nil { + c.Fatal(err) + } + + // Run the container so it picks up the old settings + dockerCmd(c, "run", "--name='third'", "busybox", "true") + containerID3, err := getIDByName("third") + if err != nil { + c.Fatal(err) + } + + // Create a modified resolv.conf.aside and override resolv.conf with it + bytesResolvConf = []byte(tmpResolvConf) + if err := ioutil.WriteFile("/etc/resolv.conf.aside", bytesResolvConf, 0644); err != nil { + c.Fatal(err) + } + + err = os.Rename("/etc/resolv.conf.aside", "/etc/resolv.conf") + if err != nil { + c.Fatal(err) + } + + // start the container again to pickup changes + dockerCmd(c, "start", "third") + + // check for update in container + containerResolv, err = readContainerFile(containerID3, "resolv.conf") + if err != nil { + c.Fatal(err) + } + if !bytes.Equal(containerResolv, bytesResolvConf) { + c.Fatalf("Stopped container does not have updated resolv.conf; expected\n%q\n got\n%q", tmpResolvConf, string(containerResolv)) + } + + //cleanup, restore original resolv.conf happens in defer func() +} + +func (s *DockerSuite) TestRunAddHost(c *check.C) { + // Not applicable on Windows as it does not support --add-host + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--add-host=extra:86.75.30.9", "busybox", "grep", "extra", "/etc/hosts") + + actual := strings.Trim(out, "\r\n") + if actual != "86.75.30.9\textra" { + c.Fatalf("expected '86.75.30.9\textra', but says: %q", actual) + } +} + +// Regression test for #6983 +func (s *DockerSuite) TestRunAttachStdErrOnlyTTYMode(c *check.C) { + _, exitCode := dockerCmd(c, "run", "-t", "-a", "stderr", "busybox", "true") + if exitCode != 0 { + c.Fatalf("Container should have exited with error code 0") + } +} + +// Regression test for #6983 +func (s *DockerSuite) TestRunAttachStdOutOnlyTTYMode(c *check.C) { + _, exitCode := dockerCmd(c, "run", "-t", "-a", "stdout", "busybox", "true") + if exitCode != 0 { + c.Fatalf("Container should have exited with error code 0") + } +} + +// Regression test for #6983 +func (s *DockerSuite) TestRunAttachStdOutAndErrTTYMode(c *check.C) { + _, exitCode := dockerCmd(c, "run", "-t", "-a", "stdout", "-a", "stderr", "busybox", "true") + if exitCode != 0 { + c.Fatalf("Container should have exited with error code 0") + } +} + +// Test for #10388 - this will run the same test as TestRunAttachStdOutAndErrTTYMode +// but using --attach instead of -a to make sure we read the flag correctly +func (s *DockerSuite) TestRunAttachWithDetach(c *check.C) { + cmd := exec.Command(dockerBinary, "run", "-d", "--attach", "stdout", "busybox", "true") + _, stderr, _, err := runCommandWithStdoutStderr(cmd) + if err == nil { + c.Fatal("Container should have exited with error code different than 0") + } else if !strings.Contains(stderr, "Conflicting options: -a and -d") { + c.Fatal("Should have been returned an error with conflicting options -a and -d") + } +} + +func (s *DockerSuite) TestRunState(c *check.C) { + // TODO Windows: This needs some rework as Windows busybox does not support top + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + + id := strings.TrimSpace(out) + state, err := inspectField(id, "State.Running") + c.Assert(err, check.IsNil) + if state != "true" { + c.Fatal("Container state is 'not running'") + } + pid1, err := inspectField(id, "State.Pid") + c.Assert(err, check.IsNil) + if pid1 == "0" { + c.Fatal("Container state Pid 0") + } + + dockerCmd(c, "stop", id) + state, err = inspectField(id, "State.Running") + c.Assert(err, check.IsNil) + if state != "false" { + c.Fatal("Container state is 'running'") + } + pid2, err := inspectField(id, "State.Pid") + c.Assert(err, check.IsNil) + if pid2 == pid1 { + c.Fatalf("Container state Pid %s, but expected %s", pid2, pid1) + } + + dockerCmd(c, "start", id) + state, err = inspectField(id, "State.Running") + c.Assert(err, check.IsNil) + if state != "true" { + c.Fatal("Container state is 'not running'") + } + pid3, err := inspectField(id, "State.Pid") + c.Assert(err, check.IsNil) + if pid3 == pid1 { + c.Fatalf("Container state Pid %s, but expected %s", pid2, pid1) + } +} + +// Test for #1737 +func (s *DockerSuite) TestRunCopyVolumeUidGid(c *check.C) { + // Not applicable on Windows as it does not support volumes, uid or gid + testRequires(c, DaemonIsLinux) + name := "testrunvolumesuidgid" + _, err := buildImage(name, + `FROM busybox + RUN echo 'dockerio:x:1001:1001::/bin:/bin/false' >> /etc/passwd + RUN echo 'dockerio:x:1001:' >> /etc/group + RUN mkdir -p /hello && touch /hello/test && chown dockerio.dockerio /hello`, + true) + if err != nil { + c.Fatal(err) + } + + // Test that the uid and gid is copied from the image to the volume + out, _ := dockerCmd(c, "run", "--rm", "-v", "/hello", name, "sh", "-c", "ls -l / | grep hello | awk '{print $3\":\"$4}'") + out = strings.TrimSpace(out) + if out != "dockerio:dockerio" { + c.Fatalf("Wrong /hello ownership: %s, expected dockerio:dockerio", out) + } +} + +// Test for #1582 +func (s *DockerSuite) TestRunCopyVolumeContent(c *check.C) { + // Not applicable on Windows as it does not support volumes + testRequires(c, DaemonIsLinux) + name := "testruncopyvolumecontent" + _, err := buildImage(name, + `FROM busybox + RUN mkdir -p /hello/local && echo hello > /hello/local/world`, + true) + if err != nil { + c.Fatal(err) + } + + // Test that the content is copied from the image to the volume + out, _ := dockerCmd(c, "run", "--rm", "-v", "/hello", name, "find", "/hello") + if !(strings.Contains(out, "/hello/local/world") && strings.Contains(out, "/hello/local")) { + c.Fatal("Container failed to transfer content to volume") + } +} + +func (s *DockerSuite) TestRunCleanupCmdOnEntrypoint(c *check.C) { + name := "testrunmdcleanuponentrypoint" + if _, err := buildImage(name, + `FROM busybox + ENTRYPOINT ["echo"] + CMD ["testingpoint"]`, + true); err != nil { + c.Fatal(err) + } + + out, exit := dockerCmd(c, "run", "--entrypoint", "whoami", name) + if exit != 0 { + c.Fatalf("expected exit code 0 received %d, out: %q", exit, out) + } + out = strings.TrimSpace(out) + expected := "root" + if daemonPlatform == "windows" { + expected = `nt authority\system` + } + if out != expected { + c.Fatalf("Expected output %s, got %q", expected, out) + } +} + +// TestRunWorkdirExistsAndIsFile checks that if 'docker run -w' with existing file can be detected +func (s *DockerSuite) TestRunWorkdirExistsAndIsFile(c *check.C) { + existingFile := "/bin/cat" + expected := "Cannot mkdir: /bin/cat is not a directory" + if daemonPlatform == "windows" { + existingFile = `\windows\system32\ntdll.dll` + expected = "The directory name is invalid" + } + + out, exit, err := dockerCmdWithError("run", "-w", existingFile, "busybox") + if !(err != nil && exit == 1 && strings.Contains(out, expected)) { + c.Fatalf("Docker must complains about making dir, but we got out: %s, exit: %d, err: %s", out, exit, err) + } +} + +func (s *DockerSuite) TestRunExitOnStdinClose(c *check.C) { + name := "testrunexitonstdinclose" + + meow := "/bin/cat" + delay := 1 + if daemonPlatform == "windows" { + meow = "cat" + delay = 5 + } + runCmd := exec.Command(dockerBinary, "run", "--name", name, "-i", "busybox", meow) + + stdin, err := runCmd.StdinPipe() + if err != nil { + c.Fatal(err) + } + stdout, err := runCmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + + if err := runCmd.Start(); err != nil { + c.Fatal(err) + } + if _, err := stdin.Write([]byte("hello\n")); err != nil { + c.Fatal(err) + } + + r := bufio.NewReader(stdout) + line, err := r.ReadString('\n') + if err != nil { + c.Fatal(err) + } + line = strings.TrimSpace(line) + if line != "hello" { + c.Fatalf("Output should be 'hello', got '%q'", line) + } + if err := stdin.Close(); err != nil { + c.Fatal(err) + } + finish := make(chan error) + go func() { + finish <- runCmd.Wait() + close(finish) + }() + select { + case err := <-finish: + c.Assert(err, check.IsNil) + case <-time.After(time.Duration(delay) * time.Second): + c.Fatal("docker run failed to exit on stdin close") + } + state, err := inspectField(name, "State.Running") + c.Assert(err, check.IsNil) + + if state != "false" { + c.Fatal("Container must be stopped after stdin closing") + } +} + +// Test for #2267 +func (s *DockerSuite) TestRunWriteHostsFileAndNotCommit(c *check.C) { + // Cannot run on Windows as Windows does not support diff. + testRequires(c, DaemonIsLinux) + name := "writehosts" + out, _ := dockerCmd(c, "run", "--name", name, "busybox", "sh", "-c", "echo test2267 >> /etc/hosts && cat /etc/hosts") + if !strings.Contains(out, "test2267") { + c.Fatal("/etc/hosts should contain 'test2267'") + } + + out, _ = dockerCmd(c, "diff", name) + if len(strings.Trim(out, "\r\n")) != 0 && !eqToBaseDiff(out, c) { + c.Fatal("diff should be empty") + } +} + +func eqToBaseDiff(out string, c *check.C) bool { + out1, _ := dockerCmd(c, "run", "-d", "busybox", "echo", "hello") + cID := strings.TrimSpace(out1) + + baseDiff, _ := dockerCmd(c, "diff", cID) + baseArr := strings.Split(baseDiff, "\n") + sort.Strings(baseArr) + outArr := strings.Split(out, "\n") + sort.Strings(outArr) + return sliceEq(baseArr, outArr) +} + +func sliceEq(a, b []string) bool { + if len(a) != len(b) { + return false + } + + for i := range a { + if a[i] != b[i] { + return false + } + } + + return true +} + +// Test for #2267 +func (s *DockerSuite) TestRunWriteHostnameFileAndNotCommit(c *check.C) { + // Cannot run on Windows as Windows does not support diff. + testRequires(c, DaemonIsLinux) + name := "writehostname" + out, _ := dockerCmd(c, "run", "--name", name, "busybox", "sh", "-c", "echo test2267 >> /etc/hostname && cat /etc/hostname") + if !strings.Contains(out, "test2267") { + c.Fatal("/etc/hostname should contain 'test2267'") + } + + out, _ = dockerCmd(c, "diff", name) + if len(strings.Trim(out, "\r\n")) != 0 && !eqToBaseDiff(out, c) { + c.Fatal("diff should be empty") + } +} + +// Test for #2267 +func (s *DockerSuite) TestRunWriteResolvFileAndNotCommit(c *check.C) { + // Cannot run on Windows as Windows does not support diff. + testRequires(c, DaemonIsLinux) + name := "writeresolv" + out, _ := dockerCmd(c, "run", "--name", name, "busybox", "sh", "-c", "echo test2267 >> /etc/resolv.conf && cat /etc/resolv.conf") + if !strings.Contains(out, "test2267") { + c.Fatal("/etc/resolv.conf should contain 'test2267'") + } + + out, _ = dockerCmd(c, "diff", name) + if len(strings.Trim(out, "\r\n")) != 0 && !eqToBaseDiff(out, c) { + c.Fatal("diff should be empty") + } +} + +func (s *DockerSuite) TestRunWithBadDevice(c *check.C) { + // Cannot run on Windows as Windows does not support --device + testRequires(c, DaemonIsLinux) + name := "baddevice" + out, _, err := dockerCmdWithError("run", "--name", name, "--device", "/etc", "busybox", "true") + + if err == nil { + c.Fatal("Run should fail with bad device") + } + expected := `"/etc": not a device node` + if !strings.Contains(out, expected) { + c.Fatalf("Output should contain %q, actual out: %q", expected, out) + } +} + +func (s *DockerSuite) TestRunEntrypoint(c *check.C) { + name := "entrypoint" + + // Note Windows does not have an echo.exe built in. + var out, expected string + if daemonPlatform == "windows" { + out, _ = dockerCmd(c, "run", "--name", name, "--entrypoint", "cmd /s /c echo", "busybox", "foobar") + expected = "foobar\r\n" + } else { + out, _ = dockerCmd(c, "run", "--name", name, "--entrypoint", "/bin/echo", "busybox", "-n", "foobar") + expected = "foobar" + } + + if out != expected { + c.Fatalf("Output should be %q, actual out: %q", expected, out) + } +} + +func (s *DockerSuite) TestRunBindMounts(c *check.C) { + // /tmp gets permission denied + testRequires(c, NotUserNamespace) + // Cannot run on Windows as Windows does not support volumes + testRequires(c, DaemonIsLinux, SameHostDaemon) + + tmpDir, err := ioutil.TempDir("", "docker-test-container") + if err != nil { + c.Fatal(err) + } + + defer os.RemoveAll(tmpDir) + writeFile(path.Join(tmpDir, "touch-me"), "", c) + + // Test reading from a read-only bind mount + out, _ := dockerCmd(c, "run", "-v", fmt.Sprintf("%s:/tmp:ro", tmpDir), "busybox", "ls", "/tmp") + if !strings.Contains(out, "touch-me") { + c.Fatal("Container failed to read from bind mount") + } + + // test writing to bind mount + dockerCmd(c, "run", "-v", fmt.Sprintf("%s:/tmp:rw", tmpDir), "busybox", "touch", "/tmp/holla") + + readFile(path.Join(tmpDir, "holla"), c) // Will fail if the file doesn't exist + + // test mounting to an illegal destination directory + _, _, err = dockerCmdWithError("run", "-v", fmt.Sprintf("%s:.", tmpDir), "busybox", "ls", ".") + if err == nil { + c.Fatal("Container bind mounted illegal directory") + } + + // test mount a file + dockerCmd(c, "run", "-v", fmt.Sprintf("%s/holla:/tmp/holla:rw", tmpDir), "busybox", "sh", "-c", "echo -n 'yotta' > /tmp/holla") + content := readFile(path.Join(tmpDir, "holla"), c) // Will fail if the file doesn't exist + expected := "yotta" + if content != expected { + c.Fatalf("Output should be %q, actual out: %q", expected, content) + } +} + +// Ensure that CIDFile gets deleted if it's empty +// Perform this test by making `docker run` fail +func (s *DockerSuite) TestRunCidFileCleanupIfEmpty(c *check.C) { + tmpDir, err := ioutil.TempDir("", "TestRunCidFile") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpDir) + tmpCidFile := path.Join(tmpDir, "cid") + + image := "emptyfs" + if daemonPlatform == "windows" { + // Windows can't support an emptyfs image. Just use the regular Windows image + image = WindowsBaseImage + } + out, _, err := dockerCmdWithError("run", "--cidfile", tmpCidFile, image) + if err == nil { + c.Fatalf("Run without command must fail. out=%s", out) + } else if !strings.Contains(out, "No command specified") { + c.Fatalf("Run without command failed with wrong output. out=%s\nerr=%v", out, err) + } + + if _, err := os.Stat(tmpCidFile); err == nil { + c.Fatalf("empty CIDFile %q should've been deleted", tmpCidFile) + } +} + +// #2098 - Docker cidFiles only contain short version of the containerId +//sudo docker run --cidfile /tmp/docker_tesc.cid ubuntu echo "test" +// TestRunCidFile tests that run --cidfile returns the longid +func (s *DockerSuite) TestRunCidFileCheckIDLength(c *check.C) { + tmpDir, err := ioutil.TempDir("", "TestRunCidFile") + if err != nil { + c.Fatal(err) + } + tmpCidFile := path.Join(tmpDir, "cid") + defer os.RemoveAll(tmpDir) + + out, _ := dockerCmd(c, "run", "-d", "--cidfile", tmpCidFile, "busybox", "true") + + id := strings.TrimSpace(out) + buffer, err := ioutil.ReadFile(tmpCidFile) + if err != nil { + c.Fatal(err) + } + cid := string(buffer) + if len(cid) != 64 { + c.Fatalf("--cidfile should be a long id, not %q", id) + } + if cid != id { + c.Fatalf("cid must be equal to %s, got %s", id, cid) + } +} + +func (s *DockerSuite) TestRunSetMacAddress(c *check.C) { + // TODO Windows. Test modified to be theoretically Windows compatible, + // but the version of busybox being used on Windows doesn't handle + // sh -c ipconfig -all (or /all). It ignores the *all bit. This could + // be a bug in busybox. + testRequires(c, DaemonIsLinux) + mac := "12:34:56:78:9a:bc" + + var out string + if daemonPlatform == "windows" { + out, _ = dockerCmd(c, "run", "-i", "--rm", fmt.Sprintf("--mac-address=%s", mac), "busybox", "sh", "-c", "ipconfig /all | grep 'Physical Address' | awk '{print $12}'") + } else { + out, _ = dockerCmd(c, "run", "-i", "--rm", fmt.Sprintf("--mac-address=%s", mac), "busybox", "/bin/sh", "-c", "ip link show eth0 | tail -1 | awk '{print $2}'") + } + + actualMac := strings.TrimSpace(out) + if actualMac != mac { + c.Fatalf("Set MAC address with --mac-address failed. The container has an incorrect MAC address: %q, expected: %q", actualMac, mac) + } +} + +func (s *DockerSuite) TestRunInspectMacAddress(c *check.C) { + // TODO Windows. Network settings are not propagated back to inspect. + testRequires(c, DaemonIsLinux) + mac := "12:34:56:78:9a:bc" + out, _ := dockerCmd(c, "run", "-d", "--mac-address="+mac, "busybox", "top") + + id := strings.TrimSpace(out) + inspectedMac, err := inspectField(id, "NetworkSettings.Networks.bridge.MacAddress") + c.Assert(err, check.IsNil) + if inspectedMac != mac { + c.Fatalf("docker inspect outputs wrong MAC address: %q, should be: %q", inspectedMac, mac) + } +} + +// test docker run use a invalid mac address +func (s *DockerSuite) TestRunWithInvalidMacAddress(c *check.C) { + out, _, err := dockerCmdWithError("run", "--mac-address", "92:d0:c6:0a:29", "busybox") + //use a invalid mac address should with a error out + if err == nil || !strings.Contains(out, "is not a valid mac address") { + c.Fatalf("run with an invalid --mac-address should with error out") + } +} + +func (s *DockerSuite) TestRunDeallocatePortOnMissingIptablesRule(c *check.C) { + // TODO Windows. Network settings are not propagated back to inspect. + testRequires(c, SameHostDaemon, DaemonIsLinux) + + out, _ := dockerCmd(c, "run", "-d", "-p", "23:23", "busybox", "top") + + id := strings.TrimSpace(out) + ip, err := inspectField(id, "NetworkSettings.Networks.bridge.IPAddress") + c.Assert(err, check.IsNil) + iptCmd := exec.Command("iptables", "-D", "DOCKER", "-d", fmt.Sprintf("%s/32", ip), + "!", "-i", "docker0", "-o", "docker0", "-p", "tcp", "-m", "tcp", "--dport", "23", "-j", "ACCEPT") + out, _, err = runCommandWithOutput(iptCmd) + if err != nil { + c.Fatal(err, out) + } + if err := deleteContainer(id); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "-d", "-p", "23:23", "busybox", "top") +} + +func (s *DockerSuite) TestRunPortInUse(c *check.C) { + // TODO Windows. The duplicate NAT message returned by Windows will be + // changing as is currently completely undecipherable. Does need modifying + // to run sh rather than top though as top isn't in Windows busybox. + testRequires(c, SameHostDaemon, DaemonIsLinux) + + port := "1234" + dockerCmd(c, "run", "-d", "-p", port+":80", "busybox", "top") + + out, _, err := dockerCmdWithError("run", "-d", "-p", port+":80", "busybox", "top") + if err == nil { + c.Fatalf("Binding on used port must fail") + } + if !strings.Contains(out, "port is already allocated") { + c.Fatalf("Out must be about \"port is already allocated\", got %s", out) + } +} + +// https://github.com/docker/docker/issues/12148 +func (s *DockerSuite) TestRunAllocatePortInReservedRange(c *check.C) { + // TODO Windows. -P is not yet supported + testRequires(c, DaemonIsLinux) + // allocate a dynamic port to get the most recent + out, _ := dockerCmd(c, "run", "-d", "-P", "-p", "80", "busybox", "top") + + id := strings.TrimSpace(out) + out, _ = dockerCmd(c, "port", id, "80") + + strPort := strings.Split(strings.TrimSpace(out), ":")[1] + port, err := strconv.ParseInt(strPort, 10, 64) + if err != nil { + c.Fatalf("invalid port, got: %s, error: %s", strPort, err) + } + + // allocate a static port and a dynamic port together, with static port + // takes the next recent port in dynamic port range. + dockerCmd(c, "run", "-d", "-P", "-p", "80", "-p", fmt.Sprintf("%d:8080", port+1), "busybox", "top") +} + +// Regression test for #7792 +func (s *DockerSuite) TestRunMountOrdering(c *check.C) { + // tmp gets permission denied + testRequires(c, NotUserNamespace) + // Not applicable on Windows as Windows does not support volumes + testRequires(c, SameHostDaemon, DaemonIsLinux) + + tmpDir, err := ioutil.TempDir("", "docker_nested_mount_test") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpDir) + + tmpDir2, err := ioutil.TempDir("", "docker_nested_mount_test2") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpDir2) + + // Create a temporary tmpfs mounc. + fooDir := filepath.Join(tmpDir, "foo") + if err := os.MkdirAll(filepath.Join(tmpDir, "foo"), 0755); err != nil { + c.Fatalf("failed to mkdir at %s - %s", fooDir, err) + } + + if err := ioutil.WriteFile(fmt.Sprintf("%s/touch-me", fooDir), []byte{}, 0644); err != nil { + c.Fatal(err) + } + + if err := ioutil.WriteFile(fmt.Sprintf("%s/touch-me", tmpDir), []byte{}, 0644); err != nil { + c.Fatal(err) + } + + if err := ioutil.WriteFile(fmt.Sprintf("%s/touch-me", tmpDir2), []byte{}, 0644); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", + "-v", fmt.Sprintf("%s:/tmp", tmpDir), + "-v", fmt.Sprintf("%s:/tmp/foo", fooDir), + "-v", fmt.Sprintf("%s:/tmp/tmp2", tmpDir2), + "-v", fmt.Sprintf("%s:/tmp/tmp2/foo", fooDir), + "busybox:latest", "sh", "-c", + "ls /tmp/touch-me && ls /tmp/foo/touch-me && ls /tmp/tmp2/touch-me && ls /tmp/tmp2/foo/touch-me") +} + +// Regression test for https://github.com/docker/docker/issues/8259 +func (s *DockerSuite) TestRunReuseBindVolumeThatIsSymlink(c *check.C) { + // /tmp gets permission denied + testRequires(c, NotUserNamespace) + // Not applicable on Windows as Windows does not support volumes + testRequires(c, SameHostDaemon, DaemonIsLinux) + + tmpDir, err := ioutil.TempDir(os.TempDir(), "testlink") + if err != nil { + c.Fatal(err) + } + defer os.RemoveAll(tmpDir) + + linkPath := os.TempDir() + "/testlink2" + if err := os.Symlink(tmpDir, linkPath); err != nil { + c.Fatal(err) + } + defer os.RemoveAll(linkPath) + + // Create first container + dockerCmd(c, "run", "-v", fmt.Sprintf("%s:/tmp/test", linkPath), "busybox", "ls", "-lh", "/tmp/test") + + // Create second container with same symlinked path + // This will fail if the referenced issue is hit with a "Volume exists" error + dockerCmd(c, "run", "-v", fmt.Sprintf("%s:/tmp/test", linkPath), "busybox", "ls", "-lh", "/tmp/test") +} + +//GH#10604: Test an "/etc" volume doesn't overlay special bind mounts in container +func (s *DockerSuite) TestRunCreateVolumeEtc(c *check.C) { + // Not applicable on Windows as Windows does not support volumes + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--dns=127.0.0.1", "-v", "/etc", "busybox", "cat", "/etc/resolv.conf") + if !strings.Contains(out, "nameserver 127.0.0.1") { + c.Fatal("/etc volume mount hides /etc/resolv.conf") + } + + out, _ = dockerCmd(c, "run", "-h=test123", "-v", "/etc", "busybox", "cat", "/etc/hostname") + if !strings.Contains(out, "test123") { + c.Fatal("/etc volume mount hides /etc/hostname") + } + + out, _ = dockerCmd(c, "run", "--add-host=test:192.168.0.1", "-v", "/etc", "busybox", "cat", "/etc/hosts") + out = strings.Replace(out, "\n", " ", -1) + if !strings.Contains(out, "192.168.0.1\ttest") || !strings.Contains(out, "127.0.0.1\tlocalhost") { + c.Fatal("/etc volume mount hides /etc/hosts") + } +} + +func (s *DockerSuite) TestVolumesNoCopyData(c *check.C) { + // Not applicable on Windows as Windows does not support volumes + testRequires(c, DaemonIsLinux) + if _, err := buildImage("dataimage", + `FROM busybox + RUN mkdir -p /foo + RUN touch /foo/bar`, + true); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "--name", "test", "-v", "/foo", "busybox") + + if out, _, err := dockerCmdWithError("run", "--volumes-from", "test", "dataimage", "ls", "-lh", "/foo/bar"); err == nil || !strings.Contains(out, "No such file or directory") { + c.Fatalf("Data was copied on volumes-from but shouldn't be:\n%q", out) + } + + tmpDir := randomTmpDirPath("docker_test_bind_mount_copy_data", daemonPlatform) + if out, _, err := dockerCmdWithError("run", "-v", tmpDir+":/foo", "dataimage", "ls", "-lh", "/foo/bar"); err == nil || !strings.Contains(out, "No such file or directory") { + c.Fatalf("Data was copied on bind-mount but shouldn't be:\n%q", out) + } +} + +func (s *DockerSuite) TestRunNoOutputFromPullInStdout(c *check.C) { + // just run with unknown image + cmd := exec.Command(dockerBinary, "run", "asdfsg") + stdout := bytes.NewBuffer(nil) + cmd.Stdout = stdout + if err := cmd.Run(); err == nil { + c.Fatal("Run with unknown image should fail") + } + if stdout.Len() != 0 { + c.Fatalf("Stdout contains output from pull: %s", stdout) + } +} + +func (s *DockerSuite) TestRunVolumesCleanPaths(c *check.C) { + // Not applicable on Windows as Windows does not support volumes + testRequires(c, DaemonIsLinux) + if _, err := buildImage("run_volumes_clean_paths", + `FROM busybox + VOLUME /foo/`, + true); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "-v", "/foo", "-v", "/bar/", "--name", "dark_helmet", "run_volumes_clean_paths") + + out, err := inspectMountSourceField("dark_helmet", "/foo/") + if err != errMountNotFound { + c.Fatalf("Found unexpected volume entry for '/foo/' in volumes\n%q", out) + } + + out, err = inspectMountSourceField("dark_helmet", "/foo") + c.Assert(err, check.IsNil) + if !strings.Contains(out, volumesConfigPath) { + c.Fatalf("Volume was not defined for /foo\n%q", out) + } + + out, err = inspectMountSourceField("dark_helmet", "/bar/") + if err != errMountNotFound { + c.Fatalf("Found unexpected volume entry for '/bar/' in volumes\n%q", out) + } + + out, err = inspectMountSourceField("dark_helmet", "/bar") + c.Assert(err, check.IsNil) + if !strings.Contains(out, volumesConfigPath) { + c.Fatalf("Volume was not defined for /bar\n%q", out) + } +} + +// Regression test for #3631 +func (s *DockerSuite) TestRunSlowStdoutConsumer(c *check.C) { + // TODO Windows: This should be able to run on Windows if can find an + // alternate to /dev/zero and /dev/stdout. + testRequires(c, DaemonIsLinux) + cont := exec.Command(dockerBinary, "run", "--rm", "busybox", "/bin/sh", "-c", "dd if=/dev/zero of=/dev/stdout bs=1024 count=2000 | catv") + + stdout, err := cont.StdoutPipe() + if err != nil { + c.Fatal(err) + } + + if err := cont.Start(); err != nil { + c.Fatal(err) + } + n, err := consumeWithSpeed(stdout, 10000, 5*time.Millisecond, nil) + if err != nil { + c.Fatal(err) + } + + expected := 2 * 1024 * 2000 + if n != expected { + c.Fatalf("Expected %d, got %d", expected, n) + } +} + +func (s *DockerSuite) TestRunAllowPortRangeThroughExpose(c *check.C) { + // TODO Windows: -P is not currently supported. Also network + // settings are not propagated back. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--expose", "3000-3003", "-P", "busybox", "top") + + id := strings.TrimSpace(out) + portstr, err := inspectFieldJSON(id, "NetworkSettings.Ports") + c.Assert(err, check.IsNil) + var ports nat.PortMap + if err = unmarshalJSON([]byte(portstr), &ports); err != nil { + c.Fatal(err) + } + for port, binding := range ports { + portnum, _ := strconv.Atoi(strings.Split(string(port), "/")[0]) + if portnum < 3000 || portnum > 3003 { + c.Fatalf("Port %d is out of range ", portnum) + } + if binding == nil || len(binding) != 1 || len(binding[0].HostPort) == 0 { + c.Fatalf("Port is not mapped for the port %s", port) + } + } +} + +// test docker run expose a invalid port +func (s *DockerSuite) TestRunExposePort(c *check.C) { + out, _, err := dockerCmdWithError("run", "--expose", "80000", "busybox") + //expose a invalid port should with a error out + if err == nil || !strings.Contains(out, "Invalid range format for --expose") { + c.Fatalf("run --expose a invalid port should with error out") + } +} + +func (s *DockerSuite) TestRunUnknownCommand(c *check.C) { + if daemonPlatform != "windows" { + testRequires(c, NativeExecDriver) + } + out, _, _ := dockerCmdWithStdoutStderr(c, "create", "busybox", "/bin/nada") + + cID := strings.TrimSpace(out) + _, _, err := dockerCmdWithError("start", cID) + + // Windows and Linux are different here by architectural design. Linux will + // fail to start the container, so an error is expected. Windows will + // successfully start the container, and once started attempt to execute + // the command which will fail. + if daemonPlatform == "windows" { + // Wait for it to exit. + waitExited(cID, 30*time.Second) + c.Assert(err, check.IsNil) + } else { + c.Assert(err, check.NotNil) + } + + rc, err := inspectField(cID, "State.ExitCode") + c.Assert(err, check.IsNil) + if rc == "0" { + c.Fatalf("ExitCode(%v) cannot be 0", rc) + } +} + +func (s *DockerSuite) TestRunModeIpcHost(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + hostIpc, err := os.Readlink("/proc/1/ns/ipc") + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--ipc=host", "busybox", "readlink", "/proc/self/ns/ipc") + out = strings.Trim(out, "\n") + if hostIpc != out { + c.Fatalf("IPC different with --ipc=host %s != %s\n", hostIpc, out) + } + + out, _ = dockerCmd(c, "run", "busybox", "readlink", "/proc/self/ns/ipc") + out = strings.Trim(out, "\n") + if hostIpc == out { + c.Fatalf("IPC should be different without --ipc=host %s == %s\n", hostIpc, out) + } +} + +func (s *DockerSuite) TestRunModeIpcContainer(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", "echo -n test > /dev/shm/test && top") + + id := strings.TrimSpace(out) + state, err := inspectField(id, "State.Running") + c.Assert(err, check.IsNil) + if state != "true" { + c.Fatal("Container state is 'not running'") + } + pid1, err := inspectField(id, "State.Pid") + c.Assert(err, check.IsNil) + + parentContainerIpc, err := os.Readlink(fmt.Sprintf("/proc/%s/ns/ipc", pid1)) + if err != nil { + c.Fatal(err) + } + + out, _ = dockerCmd(c, "run", fmt.Sprintf("--ipc=container:%s", id), "busybox", "readlink", "/proc/self/ns/ipc") + out = strings.Trim(out, "\n") + if parentContainerIpc != out { + c.Fatalf("IPC different with --ipc=container:%s %s != %s\n", id, parentContainerIpc, out) + } + + catOutput, _ := dockerCmd(c, "run", fmt.Sprintf("--ipc=container:%s", id), "busybox", "cat", "/dev/shm/test") + if catOutput != "test" { + c.Fatalf("Output of /dev/shm/test expected test but found: %s", catOutput) + } +} + +func (s *DockerSuite) TestRunModeIpcContainerNotExists(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _, err := dockerCmdWithError("run", "-d", "--ipc", "container:abcd1234", "busybox", "top") + if !strings.Contains(out, "abcd1234") || err == nil { + c.Fatalf("run IPC from a non exists container should with correct error out") + } +} + +func (s *DockerSuite) TestRunModeIpcContainerNotRunning(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + out, _ := dockerCmd(c, "create", "busybox") + + id := strings.TrimSpace(out) + out, _, err := dockerCmdWithError("run", fmt.Sprintf("--ipc=container:%s", id), "busybox") + if err == nil { + c.Fatalf("Run container with ipc mode container should fail with non running container: %s\n%s", out, err) + } +} + +func (s *DockerSuite) TestRunMountShmMqueueFromHost(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux) + + dockerCmd(c, "run", "-d", "--name", "shmfromhost", "-v", "/dev/shm:/dev/shm", "busybox", "sh", "-c", "echo -n test > /dev/shm/test && top") + volPath, err := inspectMountSourceField("shmfromhost", "/dev/shm") + c.Assert(err, check.IsNil) + if volPath != "/dev/shm" { + c.Fatalf("volumePath should have been /dev/shm, was %s", volPath) + } + + out, _ := dockerCmd(c, "run", "--name", "ipchost", "--ipc", "host", "busybox", "cat", "/dev/shm/test") + if out != "test" { + c.Fatalf("Output of /dev/shm/test expected test but found: %s", out) + } +} + +func (s *DockerSuite) TestContainerNetworkMode(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + pid1, err := inspectField(id, "State.Pid") + c.Assert(err, check.IsNil) + + parentContainerNet, err := os.Readlink(fmt.Sprintf("/proc/%s/ns/net", pid1)) + if err != nil { + c.Fatal(err) + } + + out, _ = dockerCmd(c, "run", fmt.Sprintf("--net=container:%s", id), "busybox", "readlink", "/proc/self/ns/net") + out = strings.Trim(out, "\n") + if parentContainerNet != out { + c.Fatalf("NET different with --net=container:%s %s != %s\n", id, parentContainerNet, out) + } +} + +func (s *DockerSuite) TestRunModePidHost(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, NativeExecDriver, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + hostPid, err := os.Readlink("/proc/1/ns/pid") + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--pid=host", "busybox", "readlink", "/proc/self/ns/pid") + out = strings.Trim(out, "\n") + if hostPid != out { + c.Fatalf("PID different with --pid=host %s != %s\n", hostPid, out) + } + + out, _ = dockerCmd(c, "run", "busybox", "readlink", "/proc/self/ns/pid") + out = strings.Trim(out, "\n") + if hostPid == out { + c.Fatalf("PID should be different without --pid=host %s == %s\n", hostPid, out) + } +} + +func (s *DockerSuite) TestRunModeUTSHost(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, NativeExecDriver, SameHostDaemon, DaemonIsLinux) + + hostUTS, err := os.Readlink("/proc/1/ns/uts") + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--uts=host", "busybox", "readlink", "/proc/self/ns/uts") + out = strings.Trim(out, "\n") + if hostUTS != out { + c.Fatalf("UTS different with --uts=host %s != %s\n", hostUTS, out) + } + + out, _ = dockerCmd(c, "run", "busybox", "readlink", "/proc/self/ns/uts") + out = strings.Trim(out, "\n") + if hostUTS == out { + c.Fatalf("UTS should be different without --uts=host %s == %s\n", hostUTS, out) + } +} + +func (s *DockerSuite) TestRunTLSverify(c *check.C) { + if out, code, err := dockerCmdWithError("ps"); err != nil || code != 0 { + c.Fatalf("Should have worked: %v:\n%v", err, out) + } + + // Regardless of whether we specify true or false we need to + // test to make sure tls is turned on if --tlsverify is specified at all + out, code, err := dockerCmdWithError("--tlsverify=false", "ps") + if err == nil || code == 0 || !strings.Contains(out, "trying to connect") { + c.Fatalf("Should have failed: \net:%v\nout:%v\nerr:%v", code, out, err) + } + + out, code, err = dockerCmdWithError("--tlsverify=true", "ps") + if err == nil || code == 0 || !strings.Contains(out, "cert") { + c.Fatalf("Should have failed: \net:%v\nout:%v\nerr:%v", code, out, err) + } +} + +func (s *DockerSuite) TestRunPortFromDockerRangeInUse(c *check.C) { + // TODO Windows. Once moved to libnetwork/CNM, this may be able to be + // re-instated. + testRequires(c, DaemonIsLinux) + // first find allocator current position + out, _ := dockerCmd(c, "run", "-d", "-p", ":80", "busybox", "top") + + id := strings.TrimSpace(out) + out, _ = dockerCmd(c, "port", id) + + out = strings.TrimSpace(out) + if out == "" { + c.Fatal("docker port command output is empty") + } + out = strings.Split(out, ":")[1] + lastPort, err := strconv.Atoi(out) + if err != nil { + c.Fatal(err) + } + port := lastPort + 1 + l, err := net.Listen("tcp", ":"+strconv.Itoa(port)) + if err != nil { + c.Fatal(err) + } + defer l.Close() + + out, _ = dockerCmd(c, "run", "-d", "-p", ":80", "busybox", "top") + + id = strings.TrimSpace(out) + dockerCmd(c, "port", id) +} + +func (s *DockerSuite) TestRunTtyWithPipe(c *check.C) { + errChan := make(chan error) + go func() { + defer close(errChan) + + cmd := exec.Command(dockerBinary, "run", "-ti", "busybox", "true") + if _, err := cmd.StdinPipe(); err != nil { + errChan <- err + return + } + + expected := "cannot enable tty mode" + if out, _, err := runCommandWithOutput(cmd); err == nil { + errChan <- fmt.Errorf("run should have failed") + return + } else if !strings.Contains(out, expected) { + errChan <- fmt.Errorf("run failed with error %q: expected %q", out, expected) + return + } + }() + + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(6 * time.Second): + c.Fatal("container is running but should have failed") + } +} + +func (s *DockerSuite) TestRunNonLocalMacAddress(c *check.C) { + addr := "00:16:3E:08:00:50" + cmd := "ifconfig" + image := "busybox" + expected := addr + + if daemonPlatform == "windows" { + cmd = "ipconfig /all" + image = WindowsBaseImage + expected = strings.Replace(addr, ":", "-", -1) + + } + + if out, _ := dockerCmd(c, "run", "--mac-address", addr, image, cmd); !strings.Contains(out, expected) { + c.Fatalf("Output should have contained %q: %s", expected, out) + } +} + +func (s *DockerSuite) TestRunNetHost(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + hostNet, err := os.Readlink("/proc/1/ns/net") + if err != nil { + c.Fatal(err) + } + + out, _ := dockerCmd(c, "run", "--net=host", "busybox", "readlink", "/proc/self/ns/net") + out = strings.Trim(out, "\n") + if hostNet != out { + c.Fatalf("Net namespace different with --net=host %s != %s\n", hostNet, out) + } + + out, _ = dockerCmd(c, "run", "busybox", "readlink", "/proc/self/ns/net") + out = strings.Trim(out, "\n") + if hostNet == out { + c.Fatalf("Net namespace should be different without --net=host %s == %s\n", hostNet, out) + } +} + +func (s *DockerSuite) TestRunNetHostTwiceSameName(c *check.C) { + // TODO Windows. As Windows networking evolves and converges towards + // CNM, this test may be possible to enable on Windows. + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + dockerCmd(c, "run", "--rm", "--name=thost", "--net=host", "busybox", "true") + dockerCmd(c, "run", "--rm", "--name=thost", "--net=host", "busybox", "true") +} + +func (s *DockerSuite) TestRunNetContainerWhichHost(c *check.C) { + // Not applicable on Windows as uses Unix-specific capabilities + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + hostNet, err := os.Readlink("/proc/1/ns/net") + if err != nil { + c.Fatal(err) + } + + dockerCmd(c, "run", "-d", "--net=host", "--name=test", "busybox", "top") + + out, _ := dockerCmd(c, "run", "--net=container:test", "busybox", "readlink", "/proc/self/ns/net") + out = strings.Trim(out, "\n") + if hostNet != out { + c.Fatalf("Container should have host network namespace") + } +} + +func (s *DockerSuite) TestRunAllowPortRangeThroughPublish(c *check.C) { + // TODO Windows. This may be possible to enable in the future. However, + // Windows does not currently support --expose, or populate the network + // settings seen through inspect. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--expose", "3000-3003", "-p", "3000-3003", "busybox", "top") + + id := strings.TrimSpace(out) + portstr, err := inspectFieldJSON(id, "NetworkSettings.Ports") + c.Assert(err, check.IsNil) + + var ports nat.PortMap + err = unmarshalJSON([]byte(portstr), &ports) + for port, binding := range ports { + portnum, _ := strconv.Atoi(strings.Split(string(port), "/")[0]) + if portnum < 3000 || portnum > 3003 { + c.Fatalf("Port %d is out of range ", portnum) + } + if binding == nil || len(binding) != 1 || len(binding[0].HostPort) == 0 { + c.Fatal("Port is not mapped for the port "+port, out) + } + } +} + +func (s *DockerSuite) TestRunSetDefaultRestartPolicy(c *check.C) { + dockerCmd(c, "run", "-d", "--name", "test", "busybox", "sleep", "30") + out, err := inspectField("test", "HostConfig.RestartPolicy.Name") + c.Assert(err, check.IsNil) + if out != "no" { + c.Fatalf("Set default restart policy failed") + } +} + +func (s *DockerSuite) TestRunRestartMaxRetries(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "--restart=on-failure:3", "busybox", "false") + timeout := 10 * time.Second + if daemonPlatform == "windows" { + timeout = 45 * time.Second + } + + id := strings.TrimSpace(string(out)) + if err := waitInspect(id, "{{ .State.Restarting }} {{ .State.Running }}", "false false", timeout); err != nil { + c.Fatal(err) + } + + count, err := inspectField(id, "RestartCount") + c.Assert(err, check.IsNil) + if count != "3" { + c.Fatalf("Container was restarted %s times, expected %d", count, 3) + } + + MaximumRetryCount, err := inspectField(id, "HostConfig.RestartPolicy.MaximumRetryCount") + c.Assert(err, check.IsNil) + if MaximumRetryCount != "3" { + c.Fatalf("Container Maximum Retry Count is %s, expected %s", MaximumRetryCount, "3") + } +} + +func (s *DockerSuite) TestRunContainerWithWritableRootfs(c *check.C) { + dockerCmd(c, "run", "--rm", "busybox", "touch", "/file") +} + +func (s *DockerSuite) TestRunContainerWithReadonlyRootfs(c *check.C) { + // Not applicable on Windows which does not support --read-only + testRequires(c, NativeExecDriver, DaemonIsLinux) + + for _, f := range []string{"/file", "/etc/hosts", "/etc/resolv.conf", "/etc/hostname", "/sys/kernel", "/dev/.dont.touch.me"} { + testReadOnlyFile(f, c) + } +} + +func (s *DockerSuite) TestPermissionsPtsReadonlyRootfs(c *check.C) { + // Not applicable on Windows due to use of Unix specific functionality, plus + // the use of --read-only which is not supported. + // --read-only + userns has remount issues + testRequires(c, DaemonIsLinux, NativeExecDriver, NotUserNamespace) + + // Ensure we have not broken writing /dev/pts + out, status := dockerCmd(c, "run", "--read-only", "--rm", "busybox", "mount") + if status != 0 { + c.Fatal("Could not obtain mounts when checking /dev/pts mntpnt.") + } + expected := "type devpts (rw," + if !strings.Contains(string(out), expected) { + c.Fatalf("expected output to contain %s but contains %s", expected, out) + } +} + +func testReadOnlyFile(filename string, c *check.C) { + // Not applicable on Windows which does not support --read-only + testRequires(c, NativeExecDriver, DaemonIsLinux, NotUserNamespace) + + out, _, err := dockerCmdWithError("run", "--read-only", "--rm", "busybox", "touch", filename) + if err == nil { + c.Fatal("expected container to error on run with read only error") + } + expected := "Read-only file system" + if !strings.Contains(string(out), expected) { + c.Fatalf("expected output from failure to contain %s but contains %s", expected, out) + } + + out, _, err = dockerCmdWithError("run", "--read-only", "--privileged", "--rm", "busybox", "touch", filename) + if err == nil { + c.Fatal("expected container to error on run with read only error") + } + expected = "Read-only file system" + if !strings.Contains(string(out), expected) { + c.Fatalf("expected output from failure to contain %s but contains %s", expected, out) + } +} + +func (s *DockerSuite) TestRunContainerWithReadonlyEtcHostsAndLinkedContainer(c *check.C) { + // Not applicable on Windows which does not support --link + // --read-only + userns has remount issues + testRequires(c, NativeExecDriver, DaemonIsLinux, NotUserNamespace) + + dockerCmd(c, "run", "-d", "--name", "test-etc-hosts-ro-linked", "busybox", "top") + + out, _ := dockerCmd(c, "run", "--read-only", "--link", "test-etc-hosts-ro-linked:testlinked", "busybox", "cat", "/etc/hosts") + if !strings.Contains(string(out), "testlinked") { + c.Fatal("Expected /etc/hosts to be updated even if --read-only enabled") + } +} + +func (s *DockerSuite) TestRunContainerWithReadonlyRootfsWithDnsFlag(c *check.C) { + // Not applicable on Windows which does not support either --read-only or --dns. + // --read-only + userns has remount issues + testRequires(c, NativeExecDriver, DaemonIsLinux, NotUserNamespace) + + out, _ := dockerCmd(c, "run", "--read-only", "--dns", "1.1.1.1", "busybox", "/bin/cat", "/etc/resolv.conf") + if !strings.Contains(string(out), "1.1.1.1") { + c.Fatal("Expected /etc/resolv.conf to be updated even if --read-only enabled and --dns flag used") + } +} + +func (s *DockerSuite) TestRunContainerWithReadonlyRootfsWithAddHostFlag(c *check.C) { + // Not applicable on Windows which does not support --read-only + // --read-only + userns has remount issues + testRequires(c, NativeExecDriver, DaemonIsLinux, NotUserNamespace) + + out, _ := dockerCmd(c, "run", "--read-only", "--add-host", "testreadonly:127.0.0.1", "busybox", "/bin/cat", "/etc/hosts") + if !strings.Contains(string(out), "testreadonly") { + c.Fatal("Expected /etc/hosts to be updated even if --read-only enabled and --add-host flag used") + } +} + +func (s *DockerSuite) TestRunVolumesFromRestartAfterRemoved(c *check.C) { + // TODO Windows. Not applicable on Windows which does not support volumes. + // This may be possible to add in the future. + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "voltest", "-v", "/foo", "busybox") + dockerCmd(c, "run", "-d", "--name", "restarter", "--volumes-from", "voltest", "busybox", "top") + + // Remove the main volume container and restart the consuming container + dockerCmd(c, "rm", "-f", "voltest") + + // This should not fail since the volumes-from were already applied + dockerCmd(c, "restart", "restarter") +} + +// run container with --rm should remove container if exit code != 0 +func (s *DockerSuite) TestRunContainerWithRmFlagExitCodeNotEqualToZero(c *check.C) { + name := "flowers" + out, _, err := dockerCmdWithError("run", "--name", name, "--rm", "busybox", "ls", "/notexists") + if err == nil { + c.Fatal("Expected docker run to fail", out, err) + } + + out, err = getAllContainers() + if err != nil { + c.Fatal(out, err) + } + + if out != "" { + c.Fatal("Expected not to have containers", out) + } +} + +func (s *DockerSuite) TestRunContainerWithRmFlagCannotStartContainer(c *check.C) { + name := "sparkles" + out, _, err := dockerCmdWithError("run", "--name", name, "--rm", "busybox", "commandNotFound") + if err == nil { + c.Fatal("Expected docker run to fail", out, err) + } + + out, err = getAllContainers() + if err != nil { + c.Fatal(out, err) + } + + if out != "" { + c.Fatal("Expected not to have containers", out) + } +} + +func (s *DockerSuite) TestRunPidHostWithChildIsKillable(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, NotUserNamespace) + name := "ibuildthecloud" + dockerCmd(c, "run", "-d", "--pid=host", "--name", name, "busybox", "sh", "-c", "sleep 30; echo hi") + + c.Assert(waitRun(name), check.IsNil) + + errchan := make(chan error) + go func() { + if out, _, err := dockerCmdWithError("kill", name); err != nil { + errchan <- fmt.Errorf("%v:\n%s", err, out) + } + close(errchan) + }() + select { + case err := <-errchan: + c.Assert(err, check.IsNil) + case <-time.After(5 * time.Second): + c.Fatal("Kill container timed out") + } +} + +func (s *DockerSuite) TestRunWithTooSmallMemoryLimit(c *check.C) { + // TODO Windows. This may be possible to enable once Windows supports + // memory limits on containers + testRequires(c, DaemonIsLinux) + // this memory limit is 1 byte less than the min, which is 4MB + // https://github.com/docker/docker/blob/v1.5.0/daemon/create.go#L22 + out, _, err := dockerCmdWithError("run", "-m", "4194303", "busybox") + if err == nil || !strings.Contains(out, "Minimum memory limit allowed is 4MB") { + c.Fatalf("expected run to fail when using too low a memory limit: %q", out) + } +} + +func (s *DockerSuite) TestRunWriteToProcAsound(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux) + _, code, err := dockerCmdWithError("run", "busybox", "sh", "-c", "echo 111 >> /proc/asound/version") + if err == nil || code == 0 { + c.Fatal("standard container should not be able to write to /proc/asound") + } +} + +func (s *DockerSuite) TestRunReadProcTimer(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, NativeExecDriver, DaemonIsLinux) + out, code, err := dockerCmdWithError("run", "busybox", "cat", "/proc/timer_stats") + if code != 0 { + return + } + if err != nil { + c.Fatal(err) + } + if strings.Trim(out, "\n ") != "" { + c.Fatalf("expected to receive no output from /proc/timer_stats but received %q", out) + } +} + +func (s *DockerSuite) TestRunReadProcLatency(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, NativeExecDriver, DaemonIsLinux) + // some kernels don't have this configured so skip the test if this file is not found + // on the host running the tests. + if _, err := os.Stat("/proc/latency_stats"); err != nil { + c.Skip("kernel doesnt have latency_stats configured") + return + } + out, code, err := dockerCmdWithError("run", "busybox", "cat", "/proc/latency_stats") + if code != 0 { + return + } + if err != nil { + c.Fatal(err) + } + if strings.Trim(out, "\n ") != "" { + c.Fatalf("expected to receive no output from /proc/latency_stats but received %q", out) + } +} + +func (s *DockerSuite) TestRunReadFilteredProc(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, Apparmor, DaemonIsLinux, NotUserNamespace) + + testReadPaths := []string{ + "/proc/latency_stats", + "/proc/timer_stats", + "/proc/kcore", + } + for i, filePath := range testReadPaths { + name := fmt.Sprintf("procsieve-%d", i) + shellCmd := fmt.Sprintf("exec 3<%s", filePath) + + out, exitCode, err := dockerCmdWithError("run", "--privileged", "--security-opt", "apparmor:docker-default", "--name", name, "busybox", "sh", "-c", shellCmd) + if exitCode != 0 { + return + } + if err != nil { + c.Fatalf("Open FD for read should have failed with permission denied, got: %s, %v", out, err) + } + } +} + +func (s *DockerSuite) TestMountIntoProc(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver) + _, code, err := dockerCmdWithError("run", "-v", "/proc//sys", "busybox", "true") + if err == nil || code == 0 { + c.Fatal("container should not be able to mount into /proc") + } +} + +func (s *DockerSuite) TestMountIntoSys(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver, NotUserNamespace) + dockerCmd(c, "run", "-v", "/sys/fs/cgroup", "busybox", "true") +} + +func (s *DockerSuite) TestRunUnshareProc(c *check.C) { + c.Skip("unstable test: is apparmor in a container reliable?") + + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, Apparmor, NativeExecDriver, DaemonIsLinux) + + name := "acidburn" + if out, _, err := dockerCmdWithError("run", "--name", name, "jess/unshare", "unshare", "-p", "-m", "-f", "-r", "--mount-proc=/proc", "mount"); err == nil || !strings.Contains(out, "Permission denied") { + c.Fatalf("unshare should have failed with permission denied, got: %s, %v", out, err) + } + + name = "cereal" + if out, _, err := dockerCmdWithError("run", "--name", name, "jess/unshare", "unshare", "-p", "-m", "-f", "-r", "mount", "-t", "proc", "none", "/proc"); err == nil || !strings.Contains(out, "Permission denied") { + c.Fatalf("unshare should have failed with permission denied, got: %s, %v", out, err) + } + + /* Ensure still fails if running privileged with the default policy */ + name = "crashoverride" + if out, _, err := dockerCmdWithError("run", "--privileged", "--security-opt", "apparmor:docker-default", "--name", name, "jess/unshare", "unshare", "-p", "-m", "-f", "-r", "mount", "-t", "proc", "none", "/proc"); err == nil || !strings.Contains(out, "Permission denied") { + c.Fatalf("unshare should have failed with permission denied, got: %s, %v", out, err) + } +} + +func (s *DockerSuite) TestRunPublishPort(c *check.C) { + // TODO Windows: This may be possible once Windows moves to libnetwork and CNM + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "test", "--expose", "8080", "busybox", "top") + out, _ := dockerCmd(c, "port", "test") + out = strings.Trim(out, "\r\n") + if out != "" { + c.Fatalf("run without --publish-all should not publish port, out should be nil, but got: %s", out) + } +} + +// Issue #10184. +func (s *DockerSuite) TestDevicePermissions(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver) + const permissions = "crw-rw-rw-" + out, status := dockerCmd(c, "run", "--device", "/dev/fuse:/dev/fuse:mrw", "busybox:latest", "ls", "-l", "/dev/fuse") + if status != 0 { + c.Fatalf("expected status 0, got %d", status) + } + if !strings.HasPrefix(out, permissions) { + c.Fatalf("output should begin with %q, got %q", permissions, out) + } +} + +func (s *DockerSuite) TestRunCapAddCHOWN(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux) + testRequires(c, NativeExecDriver) + out, _ := dockerCmd(c, "run", "--cap-drop=ALL", "--cap-add=CHOWN", "busybox", "sh", "-c", "adduser -D -H newuser && chown newuser /home && echo ok") + + if actual := strings.Trim(out, "\r\n"); actual != "ok" { + c.Fatalf("expected output ok received %s", actual) + } +} + +// https://github.com/docker/docker/pull/14498 +func (s *DockerSuite) TestVolumeFromMixedRWOptions(c *check.C) { + // Not applicable on Windows as volumes are not supported on Winodws + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name", "parent", "-v", "/test", "busybox", "true") + dockerCmd(c, "run", "--volumes-from", "parent:ro", "--name", "test-volumes-1", "busybox", "true") + dockerCmd(c, "run", "--volumes-from", "parent:rw", "--name", "test-volumes-2", "busybox", "true") + + mRO, err := inspectMountPoint("test-volumes-1", "/test") + c.Assert(err, check.IsNil) + if mRO.RW { + c.Fatalf("Expected RO volume was RW") + } + + mRW, err := inspectMountPoint("test-volumes-2", "/test") + c.Assert(err, check.IsNil) + if !mRW.RW { + c.Fatalf("Expected RW volume was RO") + } +} + +func (s *DockerSuite) TestRunWriteFilteredProc(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, Apparmor, NativeExecDriver, DaemonIsLinux, NotUserNamespace) + + testWritePaths := []string{ + /* modprobe and core_pattern should both be denied by generic + * policy of denials for /proc/sys/kernel. These files have been + * picked to be checked as they are particularly sensitive to writes */ + "/proc/sys/kernel/modprobe", + "/proc/sys/kernel/core_pattern", + "/proc/sysrq-trigger", + "/proc/kcore", + } + for i, filePath := range testWritePaths { + name := fmt.Sprintf("writeprocsieve-%d", i) + + shellCmd := fmt.Sprintf("exec 3>%s", filePath) + out, code, err := dockerCmdWithError("run", "--privileged", "--security-opt", "apparmor:docker-default", "--name", name, "busybox", "sh", "-c", shellCmd) + if code != 0 { + return + } + if err != nil { + c.Fatalf("Open FD for write should have failed with permission denied, got: %s, %v", out, err) + } + } +} + +func (s *DockerSuite) TestRunNetworkFilesBindMount(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, SameHostDaemon, DaemonIsLinux) + + expected := "test123" + + filename := createTmpFile(c, expected) + defer os.Remove(filename) + + nwfiles := []string{"/etc/resolv.conf", "/etc/hosts", "/etc/hostname"} + + for i := range nwfiles { + actual, _ := dockerCmd(c, "run", "-v", filename+":"+nwfiles[i], "busybox", "cat", nwfiles[i]) + if actual != expected { + c.Fatalf("expected %s be: %q, but was: %q", nwfiles[i], expected, actual) + } + } +} + +func (s *DockerSuite) TestRunNetworkFilesBindMountRO(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, SameHostDaemon, DaemonIsLinux) + + filename := createTmpFile(c, "test123") + defer os.Remove(filename) + + nwfiles := []string{"/etc/resolv.conf", "/etc/hosts", "/etc/hostname"} + + for i := range nwfiles { + _, exitCode, err := dockerCmdWithError("run", "-v", filename+":"+nwfiles[i]+":ro", "busybox", "touch", nwfiles[i]) + if err == nil || exitCode == 0 { + c.Fatalf("run should fail because bind mount of %s is ro: exit code %d", nwfiles[i], exitCode) + } + } +} + +func (s *DockerSuite) TestRunNetworkFilesBindMountROFilesystem(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + // --read-only + userns has remount issues + testRequires(c, SameHostDaemon, DaemonIsLinux, NotUserNamespace) + + filename := createTmpFile(c, "test123") + defer os.Remove(filename) + + nwfiles := []string{"/etc/resolv.conf", "/etc/hosts", "/etc/hostname"} + + for i := range nwfiles { + _, exitCode := dockerCmd(c, "run", "-v", filename+":"+nwfiles[i], "--read-only", "busybox", "touch", nwfiles[i]) + if exitCode != 0 { + c.Fatalf("run should not fail because %s is mounted writable on read-only root filesystem: exit code %d", nwfiles[i], exitCode) + } + } + + for i := range nwfiles { + _, exitCode, err := dockerCmdWithError("run", "-v", filename+":"+nwfiles[i]+":ro", "--read-only", "busybox", "touch", nwfiles[i]) + if err == nil || exitCode == 0 { + c.Fatalf("run should fail because %s is mounted read-only on read-only root filesystem: exit code %d", nwfiles[i], exitCode) + } + } +} + +func (s *DockerTrustSuite) TestTrustedRun(c *check.C) { + // Windows does not support this functionality + testRequires(c, DaemonIsLinux) + repoName := s.setupTrustedImage(c, "trusted-run") + + // Try run + runCmd := exec.Command(dockerBinary, "run", repoName) + s.trustedCmd(runCmd) + out, _, err := runCommandWithOutput(runCmd) + if err != nil { + c.Fatalf("Error running trusted run: %s\n%s\n", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try untrusted run to ensure we pushed the tag to the registry + runCmd = exec.Command(dockerBinary, "run", "--disable-content-trust=true", repoName) + s.trustedCmd(runCmd) + out, _, err = runCommandWithOutput(runCmd) + if err != nil { + c.Fatalf("Error running trusted run: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on trusted run with --disable-content-trust:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestUntrustedRun(c *check.C) { + // Windows does not support this functionality + testRequires(c, DaemonIsLinux) + repoName := fmt.Sprintf("%v/dockercli/trusted:latest", privateRegistryURL) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + dockerCmd(c, "push", repoName) + dockerCmd(c, "rmi", repoName) + + // Try trusted run on untrusted tag + runCmd := exec.Command(dockerBinary, "run", repoName) + s.trustedCmd(runCmd) + out, _, err := runCommandWithOutput(runCmd) + if err == nil { + c.Fatalf("Error expected when running trusted run with:\n%s", out) + } + + if !strings.Contains(string(out), "no trust data available") { + c.Fatalf("Missing expected output on trusted run:\n%s", out) + } +} + +func (s *DockerTrustSuite) TestRunWhenCertExpired(c *check.C) { + // Windows does not support this functionality + testRequires(c, DaemonIsLinux) + c.Skip("Currently changes system time, causing instability") + repoName := s.setupTrustedImage(c, "trusted-run-expired") + + // Certificates have 10 years of expiration + elevenYearsFromNow := time.Now().Add(time.Hour * 24 * 365 * 11) + + runAtDifferentDate(elevenYearsFromNow, func() { + // Try run + runCmd := exec.Command(dockerBinary, "run", repoName) + s.trustedCmd(runCmd) + out, _, err := runCommandWithOutput(runCmd) + if err == nil { + c.Fatalf("Error running trusted run in the distant future: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "could not validate the path to a trusted root") { + c.Fatalf("Missing expected output on trusted run in the distant future:\n%s", out) + } + }) + + runAtDifferentDate(elevenYearsFromNow, func() { + // Try run + runCmd := exec.Command(dockerBinary, "run", "--disable-content-trust", repoName) + s.trustedCmd(runCmd) + out, _, err := runCommandWithOutput(runCmd) + if err != nil { + c.Fatalf("Error running untrusted run in the distant future: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Status: Downloaded") { + c.Fatalf("Missing expected output on untrusted run in the distant future:\n%s", out) + } + }) +} + +func (s *DockerTrustSuite) TestTrustedRunFromBadTrustServer(c *check.C) { + // Windows does not support this functionality + testRequires(c, DaemonIsLinux) + repoName := fmt.Sprintf("%v/dockerclievilrun/trusted:latest", privateRegistryURL) + evilLocalConfigDir, err := ioutil.TempDir("", "evil-local-config-dir") + if err != nil { + c.Fatalf("Failed to create local temp dir") + } + + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Try run + runCmd := exec.Command(dockerBinary, "run", repoName) + s.trustedCmd(runCmd) + out, _, err = runCommandWithOutput(runCmd) + if err != nil { + c.Fatalf("Error running trusted run: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "Tagging") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + dockerCmd(c, "rmi", repoName) + + // Kill the notary server, start a new "evil" one. + s.not.Close() + s.not, err = newTestNotary(c) + if err != nil { + c.Fatalf("Restarting notary server failed.") + } + + // In order to make an evil server, lets re-init a client (with a different trust dir) and push new data. + // tag an image and upload it to the private registry + dockerCmd(c, "--config", evilLocalConfigDir, "tag", "busybox", repoName) + + // Push up to the new server + pushCmd = exec.Command(dockerBinary, "--config", evilLocalConfigDir, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err = runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + // Now, try running with the original client from this new trust server. This should fail. + runCmd = exec.Command(dockerBinary, "run", repoName) + s.trustedCmd(runCmd) + out, _, err = runCommandWithOutput(runCmd) + if err == nil { + c.Fatalf("Expected to fail on this run due to different remote data: %s\n%s", err, out) + } + + if !strings.Contains(string(out), "failed to validate data with current trusted certificates") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } +} + +func (s *DockerSuite) TestPtraceContainerProcsFromHost(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, SameHostDaemon) + + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), check.IsNil) + pid1, err := inspectField(id, "State.Pid") + c.Assert(err, check.IsNil) + + _, err = os.Readlink(fmt.Sprintf("/proc/%s/ns/net", pid1)) + if err != nil { + c.Fatal(err) + } +} + +func (s *DockerSuite) TestAppArmorDeniesPtrace(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, SameHostDaemon, NativeExecDriver, Apparmor, DaemonIsLinux, NotGCCGO) + + // Run through 'sh' so we are NOT pid 1. Pid 1 may be able to trace + // itself, but pid>1 should not be able to trace pid1. + _, exitCode, _ := dockerCmdWithError("run", "busybox", "sh", "-c", "readlink /proc/1/ns/net") + if exitCode == 0 { + c.Fatal("ptrace was not successfully restricted by AppArmor") + } +} + +func (s *DockerSuite) TestAppArmorTraceSelf(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, SameHostDaemon, Apparmor) + + _, exitCode, _ := dockerCmdWithError("run", "busybox", "readlink", "/proc/1/ns/net") + if exitCode != 0 { + c.Fatal("ptrace of self failed.") + } +} + +func (s *DockerSuite) TestAppArmorDeniesChmodProc(c *check.C) { + c.Skip("Test is failing, and what it tests is unclear") + + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, SameHostDaemon, NativeExecDriver, Apparmor, DaemonIsLinux) + _, exitCode, _ := dockerCmdWithError("run", "busybox", "chmod", "744", "/proc/cpuinfo") + if exitCode == 0 { + // If our test failed, attempt to repair the host system... + _, exitCode, _ := dockerCmdWithError("run", "busybox", "chmod", "444", "/proc/cpuinfo") + if exitCode == 0 { + c.Fatal("AppArmor was unsuccessful in prohibiting chmod of /proc/* files.") + } + } +} + +func (s *DockerSuite) TestRunCapAddSYSTIME(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, NativeExecDriver) + + dockerCmd(c, "run", "--cap-drop=ALL", "--cap-add=SYS_TIME", "busybox", "sh", "-c", "grep ^CapEff /proc/self/status | sed 's/^CapEff:\t//' | grep ^0000000002000000$") +} + +// run create container failed should clean up the container +func (s *DockerSuite) TestRunCreateContainerFailedCleanUp(c *check.C) { + // TODO Windows. This may be possible to enable once link is supported + testRequires(c, DaemonIsLinux) + name := "unique_name" + _, _, err := dockerCmdWithError("run", "--name", name, "--link", "nothing:nothing", "busybox") + c.Assert(err, check.NotNil, check.Commentf("Expected docker run to fail!")) + + containerID, err := inspectField(name, "Id") + c.Assert(containerID, check.Equals, "", check.Commentf("Expected not to have this container: %s!", containerID)) +} + +func (s *DockerSuite) TestRunNamedVolume(c *check.C) { + // TODO Windows: This may be possible to modify once Windows supports volumes + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "--name=test", "-v", "testing:/foo", "busybox", "sh", "-c", "echo hello > /foo/bar") + + out, _ := dockerCmd(c, "run", "--volumes-from", "test", "busybox", "sh", "-c", "cat /foo/bar") + c.Assert(strings.TrimSpace(out), check.Equals, "hello") + + out, _ = dockerCmd(c, "run", "-v", "testing:/foo", "busybox", "sh", "-c", "cat /foo/bar") + c.Assert(strings.TrimSpace(out), check.Equals, "hello") +} + +func (s *DockerSuite) TestRunWithUlimits(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, NativeExecDriver) + + out, _ := dockerCmd(c, "run", "--name=testulimits", "--ulimit", "nofile=42", "busybox", "/bin/sh", "-c", "ulimit -n") + ul := strings.TrimSpace(out) + if ul != "42" { + c.Fatalf("expected `ulimit -n` to be 42, got %s", ul) + } +} + +func (s *DockerSuite) TestRunContainerWithCgroupParent(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, NativeExecDriver) + + cgroupParent := "test" + name := "cgroup-test" + + out, _, err := dockerCmdWithError("run", "--cgroup-parent", cgroupParent, "--name", name, "busybox", "cat", "/proc/self/cgroup") + if err != nil { + c.Fatalf("unexpected failure when running container with --cgroup-parent option - %s\n%v", string(out), err) + } + cgroupPaths := parseCgroupPaths(string(out)) + if len(cgroupPaths) == 0 { + c.Fatalf("unexpected output - %q", string(out)) + } + id, err := getIDByName(name) + c.Assert(err, check.IsNil) + expectedCgroup := path.Join(cgroupParent, id) + found := false + for _, path := range cgroupPaths { + if strings.HasSuffix(path, expectedCgroup) { + found = true + break + } + } + if !found { + c.Fatalf("unexpected cgroup paths. Expected at least one cgroup path to have suffix %q. Cgroup Paths: %v", expectedCgroup, cgroupPaths) + } +} + +func (s *DockerSuite) TestRunContainerWithCgroupParentAbsPath(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + testRequires(c, DaemonIsLinux, NativeExecDriver) + + cgroupParent := "/cgroup-parent/test" + name := "cgroup-test" + out, _, err := dockerCmdWithError("run", "--cgroup-parent", cgroupParent, "--name", name, "busybox", "cat", "/proc/self/cgroup") + if err != nil { + c.Fatalf("unexpected failure when running container with --cgroup-parent option - %s\n%v", string(out), err) + } + cgroupPaths := parseCgroupPaths(string(out)) + if len(cgroupPaths) == 0 { + c.Fatalf("unexpected output - %q", string(out)) + } + id, err := getIDByName(name) + c.Assert(err, check.IsNil) + expectedCgroup := path.Join(cgroupParent, id) + found := false + for _, path := range cgroupPaths { + if strings.HasSuffix(path, expectedCgroup) { + found = true + break + } + } + if !found { + c.Fatalf("unexpected cgroup paths. Expected at least one cgroup path to have suffix %q. Cgroup Paths: %v", expectedCgroup, cgroupPaths) + } +} + +func (s *DockerSuite) TestRunContainerWithCgroupMountRO(c *check.C) { + // Not applicable on Windows as uses Unix specific functionality + // --read-only + userns has remount issues + testRequires(c, DaemonIsLinux, NativeExecDriver, NotUserNamespace) + + filename := "/sys/fs/cgroup/devices/test123" + out, _, err := dockerCmdWithError("run", "busybox", "touch", filename) + if err == nil { + c.Fatal("expected cgroup mount point to be read-only, touch file should fail") + } + expected := "Read-only file system" + if !strings.Contains(out, expected) { + c.Fatalf("expected output from failure to contain %s but contains %s", expected, out) + } +} + +func (s *DockerSuite) TestRunContainerNetworkModeToSelf(c *check.C) { + // Not applicable on Windows which does not support --net=container + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _, err := dockerCmdWithError("run", "--name=me", "--net=container:me", "busybox", "true") + if err == nil || !strings.Contains(out, "cannot join own network") { + c.Fatalf("using container net mode to self should result in an error\nerr: %q\nout: %s", err, out) + } +} + +func (s *DockerSuite) TestRunContainerNetModeWithDnsMacHosts(c *check.C) { + // Not applicable on Windows which does not support --net=container + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _, err := dockerCmdWithError("run", "-d", "--name", "parent", "busybox", "top") + if err != nil { + c.Fatalf("failed to run container: %v, output: %q", err, out) + } + + out, _, err = dockerCmdWithError("run", "--dns", "1.2.3.4", "--net=container:parent", "busybox") + if err == nil || !strings.Contains(out, "Conflicting options: --dns and the network mode") { + c.Fatalf("run --net=container with --dns should error out") + } + + out, _, err = dockerCmdWithError("run", "--mac-address", "92:d0:c6:0a:29:33", "--net=container:parent", "busybox") + if err == nil || !strings.Contains(out, "--mac-address and the network mode") { + c.Fatalf("run --net=container with --mac-address should error out") + } + + out, _, err = dockerCmdWithError("run", "--add-host", "test:192.168.2.109", "--net=container:parent", "busybox") + if err == nil || !strings.Contains(out, "--add-host and the network mode") { + c.Fatalf("run --net=container with --add-host should error out") + } +} + +func (s *DockerSuite) TestRunContainerNetModeWithExposePort(c *check.C) { + // Not applicable on Windows which does not support --net=container + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "-d", "--name", "parent", "busybox", "top") + + out, _, err := dockerCmdWithError("run", "-p", "5000:5000", "--net=container:parent", "busybox") + if err == nil || !strings.Contains(out, "Conflicting options: -p, -P, --publish-all, --publish and the network mode (--net)") { + c.Fatalf("run --net=container with -p should error out") + } + + out, _, err = dockerCmdWithError("run", "-P", "--net=container:parent", "busybox") + if err == nil || !strings.Contains(out, "Conflicting options: -p, -P, --publish-all, --publish and the network mode (--net)") { + c.Fatalf("run --net=container with -P should error out") + } + + out, _, err = dockerCmdWithError("run", "--expose", "5000", "--net=container:parent", "busybox") + if err == nil || !strings.Contains(out, "Conflicting options: --expose and the network mode (--expose)") { + c.Fatalf("run --net=container with --expose should error out") + } +} + +func (s *DockerSuite) TestRunLinkToContainerNetMode(c *check.C) { + // Not applicable on Windows which does not support --net=container or --link + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "--name", "test", "-d", "busybox", "top") + dockerCmd(c, "run", "--name", "parent", "-d", "--net=container:test", "busybox", "top") + dockerCmd(c, "run", "-d", "--link=parent:parent", "busybox", "top") + dockerCmd(c, "run", "--name", "child", "-d", "--net=container:parent", "busybox", "top") + dockerCmd(c, "run", "-d", "--link=child:child", "busybox", "top") +} + +func (s *DockerSuite) TestRunLoopbackOnlyExistsWhenNetworkingDisabled(c *check.C) { + // TODO Windows: This may be possible to convert. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "--net=none", "busybox", "ip", "-o", "-4", "a", "show", "up") + + var ( + count = 0 + parts = strings.Split(out, "\n") + ) + + for _, l := range parts { + if l != "" { + count++ + } + } + + if count != 1 { + c.Fatalf("Wrong interface count in container %d", count) + } + + if !strings.HasPrefix(out, "1: lo") { + c.Fatalf("Wrong interface in test container: expected [1: lo], got %s", out) + } +} + +// Issue #4681 +func (s *DockerSuite) TestRunLoopbackWhenNetworkDisabled(c *check.C) { + if daemonPlatform == "windows" { + dockerCmd(c, "run", "--net=none", WindowsBaseImage, "ping", "-n", "1", "127.0.0.1") + } else { + dockerCmd(c, "run", "--net=none", "busybox", "ping", "-c", "1", "127.0.0.1") + } +} + +func (s *DockerSuite) TestRunModeNetContainerHostname(c *check.C) { + // Windows does not support --net=container + testRequires(c, DaemonIsLinux, ExecSupport, NotUserNamespace) + + dockerCmd(c, "run", "-i", "-d", "--name", "parent", "busybox", "top") + out, _ := dockerCmd(c, "exec", "parent", "cat", "/etc/hostname") + out1, _ := dockerCmd(c, "run", "--net=container:parent", "busybox", "cat", "/etc/hostname") + + if out1 != out { + c.Fatal("containers with shared net namespace should have same hostname") + } +} + +func (s *DockerSuite) TestRunNetworkNotInitializedNoneMode(c *check.C) { + // TODO Windows: Network settings are not currently propagated. This may + // be resolved in the future with the move to libnetwork and CNM. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "--net=none", "busybox", "top") + id := strings.TrimSpace(out) + res, err := inspectField(id, "NetworkSettings.Networks.none.IPAddress") + c.Assert(err, check.IsNil) + if res != "" { + c.Fatalf("For 'none' mode network must not be initialized, but container got IP: %s", res) + } +} + +func (s *DockerSuite) TestTwoContainersInNetHost(c *check.C) { + // Not applicable as Windows does not support --net=host + testRequires(c, DaemonIsLinux, NotUserNamespace, NotUserNamespace) + dockerCmd(c, "run", "-d", "--net=host", "--name=first", "busybox", "top") + dockerCmd(c, "run", "-d", "--net=host", "--name=second", "busybox", "top") + dockerCmd(c, "stop", "first") + dockerCmd(c, "stop", "second") +} + +func (s *DockerSuite) TestContainersInUserDefinedNetwork(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork") + dockerCmd(c, "run", "-d", "--net=testnetwork", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + dockerCmd(c, "run", "-t", "--net=testnetwork", "--name=second", "busybox", "ping", "-c", "1", "first") +} + +func (s *DockerSuite) TestContainersInMultipleNetworks(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace, NativeExecDriver) + // Create 2 networks using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork2") + // Run and connect containers to testnetwork1 + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=second", "busybox", "top") + c.Assert(waitRun("second"), check.IsNil) + // Check connectivity between containers in testnetwork2 + dockerCmd(c, "exec", "first", "ping", "-c", "1", "second.testnetwork1") + // Connect containers to testnetwork2 + dockerCmd(c, "network", "connect", "testnetwork2", "first") + dockerCmd(c, "network", "connect", "testnetwork2", "second") + // Check connectivity between containers + dockerCmd(c, "exec", "second", "ping", "-c", "1", "first.testnetwork2") +} + +func (s *DockerSuite) TestContainersNetworkIsolation(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace, NativeExecDriver) + // Create 2 networks using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork2") + // Run 1 container in testnetwork1 and another in testnetwork2 + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + dockerCmd(c, "run", "-d", "--net=testnetwork2", "--name=second", "busybox", "top") + c.Assert(waitRun("second"), check.IsNil) + + // Check Isolation between containers : ping must fail + _, _, err := dockerCmdWithError("exec", "first", "ping", "-c", "1", "second") + c.Assert(err, check.NotNil) + // Connect first container to testnetwork2 + dockerCmd(c, "network", "connect", "testnetwork2", "first") + // ping must succeed now + _, _, err = dockerCmdWithError("exec", "first", "ping", "-c", "1", "second") + c.Assert(err, check.IsNil) + + // Disconnect first container from testnetwork2 + dockerCmd(c, "network", "disconnect", "testnetwork2", "first") + // ping must fail again + _, _, err = dockerCmdWithError("exec", "first", "ping", "-c", "1", "second") + c.Assert(err, check.NotNil) +} + +func (s *DockerSuite) TestNetworkRmWithActiveContainers(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + // Create 2 networks using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + // Run and connect containers to testnetwork1 + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=second", "busybox", "top") + c.Assert(waitRun("second"), check.IsNil) + // Network delete with active containers must fail + _, _, err := dockerCmdWithError("network", "rm", "testnetwork1") + c.Assert(err, check.NotNil) + + dockerCmd(c, "stop", "first") + _, _, err = dockerCmdWithError("network", "rm", "testnetwork1") + c.Assert(err, check.NotNil) +} + +func (s *DockerSuite) TestContainerRestartInMultipleNetworks(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace, NativeExecDriver) + // Create 2 networks using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork2") + + // Run and connect containers to testnetwork1 + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=second", "busybox", "top") + c.Assert(waitRun("second"), check.IsNil) + // Check connectivity between containers in testnetwork2 + dockerCmd(c, "exec", "first", "ping", "-c", "1", "second.testnetwork1") + // Connect containers to testnetwork2 + dockerCmd(c, "network", "connect", "testnetwork2", "first") + dockerCmd(c, "network", "connect", "testnetwork2", "second") + // Check connectivity between containers + dockerCmd(c, "exec", "second", "ping", "-c", "1", "first.testnetwork2") + + // Stop second container and test ping failures on both networks + dockerCmd(c, "stop", "second") + _, _, err := dockerCmdWithError("exec", "first", "ping", "-c", "1", "second.testnetwork1") + c.Assert(err, check.NotNil) + _, _, err = dockerCmdWithError("exec", "first", "ping", "-c", "1", "second.testnetwork2") + c.Assert(err, check.NotNil) + + // Start second container and connectivity must be restored on both networks + dockerCmd(c, "start", "second") + dockerCmd(c, "exec", "first", "ping", "-c", "1", "second.testnetwork1") + dockerCmd(c, "exec", "second", "ping", "-c", "1", "first.testnetwork2") +} + +func (s *DockerSuite) TestContainerWithConflictingHostNetworks(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + // Run a container with --net=host + dockerCmd(c, "run", "-d", "--net=host", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + + // Create a network using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + + // Connecting to the user defined network must fail + _, _, err := dockerCmdWithError("network", "connect", "testnetwork1", "first") + c.Assert(err, check.NotNil) +} + +func (s *DockerSuite) TestContainerWithConflictingSharedNetwork(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "-d", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + // Run second container in first container's network namespace + dockerCmd(c, "run", "-d", "--net=container:first", "--name=second", "busybox", "top") + c.Assert(waitRun("second"), check.IsNil) + + // Create a network using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + + // Connecting to the user defined network must fail + out, _, err := dockerCmdWithError("network", "connect", "testnetwork1", "second") + c.Assert(err, check.NotNil) + c.Assert(out, checker.Contains, runconfig.ErrConflictSharedNetwork.Error()) +} + +func (s *DockerSuite) TestContainerWithConflictingNoneNetwork(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + dockerCmd(c, "run", "-d", "--net=none", "--name=first", "busybox", "top") + c.Assert(waitRun("first"), check.IsNil) + + // Create a network using bridge driver + dockerCmd(c, "network", "create", "-d", "bridge", "testnetwork1") + + // Connecting to the user defined network must fail + out, _, err := dockerCmdWithError("network", "connect", "testnetwork1", "first") + c.Assert(err, check.NotNil) + c.Assert(out, checker.Contains, runconfig.ErrConflictNoNetwork.Error()) + + // create a container connected to testnetwork1 + dockerCmd(c, "run", "-d", "--net=testnetwork1", "--name=second", "busybox", "top") + c.Assert(waitRun("second"), check.IsNil) + + // Connect second container to none network. it must fail as well + _, _, err = dockerCmdWithError("network", "connect", "none", "second") + c.Assert(err, check.NotNil) +} + +// #11957 - stdin with no tty does not exit if stdin is not closed even though container exited +func (s *DockerSuite) TestRunStdinBlockedAfterContainerExit(c *check.C) { + cmd := exec.Command(dockerBinary, "run", "-i", "--name=test", "busybox", "true") + in, err := cmd.StdinPipe() + c.Assert(err, check.IsNil) + defer in.Close() + c.Assert(cmd.Start(), check.IsNil) + + waitChan := make(chan error) + go func() { + waitChan <- cmd.Wait() + }() + + select { + case err := <-waitChan: + c.Assert(err, check.IsNil) + case <-time.After(30 * time.Second): + c.Fatal("timeout waiting for command to exit") + } +} + +func (s *DockerSuite) TestRunWrongCpusetCpusFlagValue(c *check.C) { + out, _, err := dockerCmdWithError("run", "--cpuset-cpus", "1-10,11--", "busybox", "true") + c.Assert(err, check.NotNil) + expected := "Error response from daemon: Invalid value 1-10,11-- for cpuset cpus.\n" + c.Assert(out, check.Equals, expected, check.Commentf("Expected output to contain %q, got %q", expected, out)) +} + +func (s *DockerSuite) TestRunWrongCpusetMemsFlagValue(c *check.C) { + out, _, err := dockerCmdWithError("run", "--cpuset-mems", "1-42--", "busybox", "true") + c.Assert(err, check.NotNil) + expected := "Error response from daemon: Invalid value 1-42-- for cpuset mems.\n" + c.Assert(out, check.Equals, expected, check.Commentf("Expected output to contain %q, got %q", expected, out)) +} + +func TestRunPidHostWithChildIsKillable(t *testing.T) { + defer deleteAllContainers() + name := "ibuildthecloud" + if out, err := exec.Command(dockerBinary, "run", "-d", "--pid=host", "--name", name, "busybox", "sh", "-c", "sleep 30; echo hi").CombinedOutput(); err != nil { + t.Fatal(err, out) + } + time.Sleep(1 * time.Second) + errchan := make(chan error) + go func() { + if out, err := exec.Command(dockerBinary, "kill", name).CombinedOutput(); err != nil { + errchan <- fmt.Errorf("%v:\n%s", err, out) + } + close(errchan) + }() + select { + case err := <-errchan: + if err != nil { + t.Fatal(err) + } + case <-time.After(5 * time.Second): + t.Fatal("Kill container timed out") + } + logDone("run - can kill container with pid-host and some childs of pid 1") +} + +func TestRunWithTooSmallMemoryLimit(t *testing.T) { + defer deleteAllContainers() + // this memory limit is 1 byte less than the min, which is 4MB + // https://github.com/docker/docker/blob/v1.5.0/daemon/create.go#L22 + out, _, err := runCommandWithOutput(exec.Command(dockerBinary, "run", "-m", "4194303", "busybox")) + if err == nil || !strings.Contains(out, "Minimum memory limit allowed is 4MB") { + t.Fatalf("expected run to fail when using too low a memory limit: %q", out) + } + + logDone("run - can't set too low memory limit") +} + +func TestRunWriteToProcAsound(t *testing.T) { + defer deleteAllContainers() + code, err := runCommand(exec.Command(dockerBinary, "run", "busybox", "sh", "-c", "echo 111 >> /proc/asound/version")) + if err == nil || code == 0 { + t.Fatal("standard container should not be able to write to /proc/asound") + } + logDone("run - ro write to /proc/asound") +} + +func TestRunReadProcTimer(t *testing.T) { + defer deleteAllContainers() + out, code, err := runCommandWithOutput(exec.Command(dockerBinary, "run", "busybox", "cat", "/proc/timer_stats")) + if err != nil || code != 0 { + t.Fatal(err) + } + if strings.Trim(out, "\n ") != "" { + t.Fatalf("expected to receive no output from /proc/timer_stats but received %q", out) + } + logDone("run - read /proc/timer_stats") +} + +func TestRunReadProcLatency(t *testing.T) { + // some kernels don't have this configured so skip the test if this file is not found + // on the host running the tests. + if _, err := os.Stat("/proc/latency_stats"); err != nil { + t.Skip() + return + } + defer deleteAllContainers() + out, code, err := runCommandWithOutput(exec.Command(dockerBinary, "run", "busybox", "cat", "/proc/latency_stats")) + if err != nil || code != 0 { + t.Fatal(err) + } + if strings.Trim(out, "\n ") != "" { + t.Fatalf("expected to receive no output from /proc/latency_stats but received %q", out) + } + logDone("run - read /proc/latency_stats") +} + +func TestMountIntoProc(t *testing.T) { + defer deleteAllContainers() + code, err := runCommand(exec.Command(dockerBinary, "run", "-v", "/proc//sys", "busybox", "true")) + if err == nil || code == 0 { + t.Fatal("container should not be able to mount into /proc") + } + logDone("run - mount into proc") +} + +func TestMountIntoSys(t *testing.T) { + defer deleteAllContainers() + _, err := runCommand(exec.Command(dockerBinary, "run", "-v", "/sys/fs/cgroup", "busybox", "true")) + if err != nil { + t.Fatal("container should be able to mount into /sys") + } + logDone("run - mount into sys") +} diff --git a/integration-cli/docker_cli_run_unix_test.go b/integration-cli/docker_cli_run_unix_test.go new file mode 100644 index 0000000000..694890271c --- /dev/null +++ b/integration-cli/docker_cli_run_unix_test.go @@ -0,0 +1,457 @@ +// +build !windows + +package main + +import ( + "bufio" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "strconv" + "strings" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/mount" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/sysinfo" + "github.com/docker/docker/pkg/units" + "github.com/go-check/check" + "github.com/kr/pty" +) + +// #6509 +func (s *DockerSuite) TestRunRedirectStdout(c *check.C) { + checkRedirect := func(command string) { + _, tty, err := pty.Open() + if err != nil { + c.Fatalf("Could not open pty: %v", err) + } + cmd := exec.Command("sh", "-c", command) + cmd.Stdin = tty + cmd.Stdout = tty + cmd.Stderr = tty + if err := cmd.Start(); err != nil { + c.Fatalf("start err: %v", err) + } + ch := make(chan error) + go func() { + ch <- cmd.Wait() + close(ch) + }() + + select { + case <-time.After(10 * time.Second): + c.Fatal("command timeout") + case err := <-ch: + if err != nil { + c.Fatalf("wait err=%v", err) + } + } + } + + checkRedirect(dockerBinary + " run -i busybox cat /etc/passwd | grep -q root") + checkRedirect(dockerBinary + " run busybox cat /etc/passwd | grep -q root") +} + +// Test recursive bind mount works by default +func (s *DockerSuite) TestRunWithVolumesIsRecursive(c *check.C) { + // /tmp gets permission denied + testRequires(c, NotUserNamespace) + tmpDir, err := ioutil.TempDir("", "docker_recursive_mount_test") + if err != nil { + c.Fatal(err) + } + + defer os.RemoveAll(tmpDir) + + // Create a temporary tmpfs mount. + tmpfsDir := filepath.Join(tmpDir, "tmpfs") + if err := os.MkdirAll(tmpfsDir, 0777); err != nil { + c.Fatalf("failed to mkdir at %s - %s", tmpfsDir, err) + } + if err := mount.Mount("tmpfs", tmpfsDir, "tmpfs", ""); err != nil { + c.Fatalf("failed to create a tmpfs mount at %s - %s", tmpfsDir, err) + } + + f, err := ioutil.TempFile(tmpfsDir, "touch-me") + if err != nil { + c.Fatal(err) + } + defer f.Close() + + runCmd := exec.Command(dockerBinary, "run", "--name", "test-data", "--volume", fmt.Sprintf("%s:/tmp:ro", tmpDir), "busybox:latest", "ls", "/tmp/tmpfs") + out, stderr, exitCode, err := runCommandWithStdoutStderr(runCmd) + if err != nil && exitCode != 0 { + c.Fatal(out, stderr, err) + } + if !strings.Contains(out, filepath.Base(f.Name())) { + c.Fatal("Recursive bind mount test failed. Expected file not found") + } +} + +func (s *DockerSuite) TestRunDeviceDirectory(c *check.C) { + testRequires(c, NativeExecDriver, NotUserNamespace) + if _, err := os.Stat("/dev/snd"); err != nil { + c.Skip("Host does not have /dev/snd") + } + + out, _ := dockerCmd(c, "run", "--device", "/dev/snd:/dev/snd", "busybox", "sh", "-c", "ls /dev/snd/") + if actual := strings.Trim(out, "\r\n"); !strings.Contains(out, "timer") { + c.Fatalf("expected output /dev/snd/timer, received %s", actual) + } + + out, _ = dockerCmd(c, "run", "--device", "/dev/snd:/dev/othersnd", "busybox", "sh", "-c", "ls /dev/othersnd/") + if actual := strings.Trim(out, "\r\n"); !strings.Contains(out, "seq") { + c.Fatalf("expected output /dev/othersnd/seq, received %s", actual) + } +} + +// TestRunDetach checks attaching and detaching with the escape sequence. +func (s *DockerSuite) TestRunAttachDetach(c *check.C) { + name := "attach-detach" + cmd := exec.Command(dockerBinary, "run", "--name", name, "-it", "busybox", "cat") + stdout, err := cmd.StdoutPipe() + if err != nil { + c.Fatal(err) + } + cpty, tty, err := pty.Open() + if err != nil { + c.Fatal(err) + } + defer cpty.Close() + cmd.Stdin = tty + if err := cmd.Start(); err != nil { + c.Fatal(err) + } + c.Assert(waitRun(name), check.IsNil) + + if _, err := cpty.Write([]byte("hello\n")); err != nil { + c.Fatal(err) + } + + out, err := bufio.NewReader(stdout).ReadString('\n') + if err != nil { + c.Fatal(err) + } + if strings.TrimSpace(out) != "hello" { + c.Fatalf("expected 'hello', got %q", out) + } + + // escape sequence + if _, err := cpty.Write([]byte{16}); err != nil { + c.Fatal(err) + } + time.Sleep(100 * time.Millisecond) + if _, err := cpty.Write([]byte{17}); err != nil { + c.Fatal(err) + } + + ch := make(chan struct{}) + go func() { + cmd.Wait() + ch <- struct{}{} + }() + + running, err := inspectField(name, "State.Running") + if err != nil { + c.Fatal(err) + } + if running != "true" { + c.Fatal("expected container to still be running") + } + + go func() { + exec.Command(dockerBinary, "kill", name).Run() + }() + + select { + case <-ch: + case <-time.After(10 * time.Millisecond): + c.Fatal("timed out waiting for container to exit") + } +} + +// "test" should be printed +func (s *DockerSuite) TestRunEchoStdoutWithCPUQuota(c *check.C) { + testRequires(c, cpuCfsQuota) + + out, _, err := dockerCmdWithError("run", "--cpu-quota", "8000", "--name", "test", "busybox", "echo", "test") + if err != nil { + c.Fatalf("failed to run container: %v, output: %q", err, out) + } + out = strings.TrimSpace(out) + if out != "test" { + c.Errorf("container should've printed 'test'") + } + + out, err = inspectField("test", "HostConfig.CpuQuota") + c.Assert(err, check.IsNil) + + if out != "8000" { + c.Fatalf("setting the CPU CFS quota failed") + } +} + +func (s *DockerSuite) TestRunWithCpuPeriod(c *check.C) { + testRequires(c, cpuCfsPeriod) + + if _, _, err := dockerCmdWithError("run", "--cpu-period", "50000", "--name", "test", "busybox", "true"); err != nil { + c.Fatalf("failed to run container: %v", err) + } + + out, err := inspectField("test", "HostConfig.CpuPeriod") + c.Assert(err, check.IsNil) + if out != "50000" { + c.Fatalf("setting the CPU CFS period failed") + } +} + +func (s *DockerSuite) TestRunWithKernelMemory(c *check.C) { + testRequires(c, kernelMemorySupport) + + dockerCmd(c, "run", "--kernel-memory", "50M", "--name", "test1", "busybox", "true") + + out, err := inspectField("test1", "HostConfig.KernelMemory") + c.Assert(err, check.IsNil) + c.Assert(out, check.Equals, "52428800") + + out, _, err = dockerCmdWithError("run", "--kernel-memory", "-16m", "--name", "test2", "busybox", "echo", "test") + expected := "invalid size" + c.Assert(err, check.NotNil) + c.Assert(out, checker.Contains, expected) +} + +// "test" should be printed +func (s *DockerSuite) TestRunEchoStdoutWitCPUShares(c *check.C) { + testRequires(c, cpuShare) + out, _ := dockerCmd(c, "run", "--cpu-shares", "1000", "busybox", "echo", "test") + if out != "test\n" { + c.Errorf("container should've printed 'test', got %q instead", out) + } +} + +// "test" should be printed +func (s *DockerSuite) TestRunEchoStdoutWithCPUSharesAndMemoryLimit(c *check.C) { + testRequires(c, cpuShare) + testRequires(c, memoryLimitSupport) + out, _, _ := dockerCmdWithStdoutStderr(c, "run", "--cpu-shares", "1000", "-m", "16m", "busybox", "echo", "test") + if out != "test\n" { + c.Errorf("container should've printed 'test', got %q instead", out) + } +} + +func (s *DockerSuite) TestRunWithCpuset(c *check.C) { + testRequires(c, cgroupCpuset) + if _, code := dockerCmd(c, "run", "--cpuset", "0", "busybox", "true"); code != 0 { + c.Fatalf("container should run successfully with cpuset of 0") + } +} + +func (s *DockerSuite) TestRunWithCpusetCpus(c *check.C) { + testRequires(c, cgroupCpuset) + if _, code := dockerCmd(c, "run", "--cpuset-cpus", "0", "busybox", "true"); code != 0 { + c.Fatalf("container should run successfully with cpuset-cpus of 0") + } +} + +func (s *DockerSuite) TestRunWithCpusetMems(c *check.C) { + testRequires(c, cgroupCpuset) + if _, code := dockerCmd(c, "run", "--cpuset-mems", "0", "busybox", "true"); code != 0 { + c.Fatalf("container should run successfully with cpuset-mems of 0") + } +} + +func (s *DockerSuite) TestRunWithBlkioWeight(c *check.C) { + testRequires(c, blkioWeight) + if _, code := dockerCmd(c, "run", "--blkio-weight", "300", "busybox", "true"); code != 0 { + c.Fatalf("container should run successfully with blkio-weight of 300") + } +} + +func (s *DockerSuite) TestRunWithBlkioInvalidWeight(c *check.C) { + testRequires(c, blkioWeight) + if _, _, err := dockerCmdWithError("run", "--blkio-weight", "5", "busybox", "true"); err == nil { + c.Fatalf("run with invalid blkio-weight should failed") + } +} + +func (s *DockerSuite) TestRunOOMExitCode(c *check.C) { + testRequires(c, oomControl) + errChan := make(chan error) + go func() { + defer close(errChan) + //changing memory to 40MB from 4MB due to an issue with GCCGO that test fails to start the container. + out, exitCode, _ := dockerCmdWithError("run", "-m", "40MB", "busybox", "sh", "-c", "x=a; while true; do x=$x$x$x$x; done") + if expected := 137; exitCode != expected { + errChan <- fmt.Errorf("wrong exit code for OOM container: expected %d, got %d (output: %q)", expected, exitCode, out) + } + }() + + select { + case err := <-errChan: + c.Assert(err, check.IsNil) + case <-time.After(30 * time.Second): + c.Fatal("Timeout waiting for container to die on OOM") + } +} + +// "test" should be printed +func (s *DockerSuite) TestRunEchoStdoutWithMemoryLimit(c *check.C) { + testRequires(c, memoryLimitSupport) + out, _, _ := dockerCmdWithStdoutStderr(c, "run", "-m", "16m", "busybox", "echo", "test") + out = strings.Trim(out, "\r\n") + + if expected := "test"; out != expected { + c.Fatalf("container should've printed %q but printed %q", expected, out) + } +} + +// TestRunWithoutMemoryswapLimit sets memory limit and disables swap +// memory limit, this means the processes in the container can use +// 16M memory and as much swap memory as they need (if the host +// supports swap memory). +func (s *DockerSuite) TestRunWithoutMemoryswapLimit(c *check.C) { + testRequires(c, NativeExecDriver) + testRequires(c, memoryLimitSupport) + testRequires(c, swapMemorySupport) + dockerCmd(c, "run", "-m", "16m", "--memory-swap", "-1", "busybox", "true") +} + +func (s *DockerSuite) TestRunWithSwappiness(c *check.C) { + testRequires(c, memorySwappinessSupport) + dockerCmd(c, "run", "--memory-swappiness", "0", "busybox", "true") +} + +func (s *DockerSuite) TestRunWithSwappinessInvalid(c *check.C) { + testRequires(c, memorySwappinessSupport) + out, _, err := dockerCmdWithError("run", "--memory-swappiness", "101", "busybox", "true") + c.Assert(err, check.NotNil) + expected := "Valid memory swappiness range is 0-100" + c.Assert(out, checker.Contains, expected, check.Commentf("Expected output to contain %q, not %q", out, expected)) + + out, _, err = dockerCmdWithError("run", "--memory-swappiness", "-10", "busybox", "true") + c.Assert(err, check.NotNil) + c.Assert(out, checker.Contains, expected, check.Commentf("Expected output to contain %q, not %q", out, expected)) +} + +func (s *DockerSuite) TestRunWithMemoryReservation(c *check.C) { + testRequires(c, memoryReservationSupport) + dockerCmd(c, "run", "--memory-reservation", "200M", "busybox", "true") +} + +func (s *DockerSuite) TestRunWithMemoryReservationInvalid(c *check.C) { + testRequires(c, memoryLimitSupport) + testRequires(c, memoryReservationSupport) + out, _, err := dockerCmdWithError("run", "-m", "500M", "--memory-reservation", "800M", "busybox", "true") + c.Assert(err, check.NotNil) + expected := "Minimum memory limit should be larger than memory reservation limit" + if !strings.Contains(strings.TrimSpace(out), expected) { + c.Fatalf("run container should fail with invalid memory reservation, output: %q", out) + } +} + +func (s *DockerSuite) TestStopContainerSignal(c *check.C) { + out, _ := dockerCmd(c, "run", "--stop-signal", "SIGUSR1", "-d", "busybox", "/bin/sh", "-c", `trap 'echo "exit trapped"; exit 0' USR1; while true; do sleep 1; done`) + containerID := strings.TrimSpace(out) + + if err := waitRun(containerID); err != nil { + c.Fatal(err) + } + + dockerCmd(c, "stop", containerID) + out, _ = dockerCmd(c, "logs", containerID) + + if !strings.Contains(out, "exit trapped") { + c.Fatalf("Expected `exit trapped` in the log, got %v", out) + } +} + +func (s *DockerSuite) TestRunSwapLessThanMemoryLimit(c *check.C) { + testRequires(c, memoryLimitSupport) + testRequires(c, swapMemorySupport) + out, _, err := dockerCmdWithError("run", "-m", "16m", "--memory-swap", "15m", "busybox", "echo", "test") + expected := "Minimum memoryswap limit should be larger than memory limit" + c.Assert(err, check.NotNil) + + if !strings.Contains(out, expected) { + c.Fatalf("Expected output to contain %q, not %q", out, expected) + } +} + +func (s *DockerSuite) TestRunInvalidCpusetCpusFlagValue(c *check.C) { + testRequires(c, cgroupCpuset) + + sysInfo := sysinfo.New(true) + cpus, err := parsers.ParseUintList(sysInfo.Cpus) + c.Assert(err, check.IsNil) + var invalid int + for i := 0; i <= len(cpus)+1; i++ { + if !cpus[i] { + invalid = i + break + } + } + out, _, err := dockerCmdWithError("run", "--cpuset-cpus", strconv.Itoa(invalid), "busybox", "true") + c.Assert(err, check.NotNil) + expected := fmt.Sprintf("Error response from daemon: Requested CPUs are not available - requested %s, available: %s.\n", strconv.Itoa(invalid), sysInfo.Cpus) + c.Assert(out, check.Equals, expected, check.Commentf("Expected output to contain %q, got %q", expected, out)) +} + +func (s *DockerSuite) TestRunInvalidCpusetMemsFlagValue(c *check.C) { + testRequires(c, cgroupCpuset) + + sysInfo := sysinfo.New(true) + mems, err := parsers.ParseUintList(sysInfo.Mems) + c.Assert(err, check.IsNil) + var invalid int + for i := 0; i <= len(mems)+1; i++ { + if !mems[i] { + invalid = i + break + } + } + out, _, err := dockerCmdWithError("run", "--cpuset-mems", strconv.Itoa(invalid), "busybox", "true") + c.Assert(err, check.NotNil) + expected := fmt.Sprintf("Error response from daemon: Requested memory nodes are not available - requested %s, available: %s.\n", strconv.Itoa(invalid), sysInfo.Mems) + c.Assert(out, check.Equals, expected, check.Commentf("Expected output to contain %q, got %q", expected, out)) +} + +func (s *DockerSuite) TestRunInvalidCPUShares(c *check.C) { + testRequires(c, cpuShare, NativeExecDriver) + out, _, err := dockerCmdWithError("run", "--cpu-shares", "1", "busybox", "echo", "test") + c.Assert(err, check.NotNil, check.Commentf(out)) + expected := "The minimum allowed cpu-shares is 2" + c.Assert(out, checker.Contains, expected) + + out, _, err = dockerCmdWithError("run", "--cpu-shares", "-1", "busybox", "echo", "test") + c.Assert(err, check.NotNil, check.Commentf(out)) + expected = "shares: invalid argument" + c.Assert(out, checker.Contains, expected) + + out, _, err = dockerCmdWithError("run", "--cpu-shares", "99999999", "busybox", "echo", "test") + c.Assert(err, check.NotNil, check.Commentf(out)) + expected = "The maximum allowed cpu-shares is" + c.Assert(out, checker.Contains, expected) +} + +func (s *DockerSuite) TestRunWithCorrectMemorySwapOnLXC(c *check.C) { + testRequires(c, memoryLimitSupport) + testRequires(c, swapMemorySupport) + testRequires(c, SameHostDaemon) + + out, _ := dockerCmd(c, "run", "-d", "-m", "16m", "--memory-swap", "64m", "busybox", "top") + if _, err := os.Stat("/sys/fs/cgroup/memory/lxc"); err != nil { + c.Skip("Excecution driver must be LXC for this test") + } + id := strings.TrimSpace(out) + memorySwap, err := ioutil.ReadFile(fmt.Sprintf("/sys/fs/cgroup/memory/lxc/%s/memory.memsw.limit_in_bytes", id)) + c.Assert(err, check.IsNil) + cgSwap, err := strconv.ParseInt(strings.TrimSpace(string(memorySwap)), 10, 64) + c.Assert(err, check.IsNil) + swap, err := units.RAMInBytes("64m") + c.Assert(err, check.IsNil) + c.Assert(cgSwap, check.Equals, swap) +} diff --git a/integration-cli/docker_cli_save_load_test.go b/integration-cli/docker_cli_save_load_test.go new file mode 100644 index 0000000000..822724e943 --- /dev/null +++ b/integration-cli/docker_cli_save_load_test.go @@ -0,0 +1,395 @@ +package main + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "reflect" + "strings" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +// save a repo using gz compression and try to load it using stdout +func (s *DockerSuite) TestSaveXzAndLoadRepoStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-save-xz-and-load-repo-stdout" + dockerCmd(c, "run", "--name", name, "busybox", "true") + + repoName := "foobar-save-load-test-xz-gz" + out, _ := dockerCmd(c, "commit", name, repoName) + + dockerCmd(c, "inspect", repoName) + + repoTarball, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", repoName), + exec.Command("xz", "-c"), + exec.Command("gzip", "-c")) + c.Assert(err, checker.IsNil, check.Commentf("failed to save repo: %v %v", out, err)) + deleteImages(repoName) + + loadCmd := exec.Command(dockerBinary, "load") + loadCmd.Stdin = strings.NewReader(repoTarball) + out, _, err = runCommandWithOutput(loadCmd) + c.Assert(err, checker.NotNil, check.Commentf("expected error, but succeeded with no error and output: %v", out)) + + after, _, err := dockerCmdWithError("inspect", repoName) + c.Assert(err, checker.NotNil, check.Commentf("the repo should not exist: %v", after)) +} + +// save a repo using xz+gz compression and try to load it using stdout +func (s *DockerSuite) TestSaveXzGzAndLoadRepoStdout(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-save-xz-gz-and-load-repo-stdout" + dockerCmd(c, "run", "--name", name, "busybox", "true") + + repoName := "foobar-save-load-test-xz-gz" + dockerCmd(c, "commit", name, repoName) + + dockerCmd(c, "inspect", repoName) + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", repoName), + exec.Command("xz", "-c"), + exec.Command("gzip", "-c")) + c.Assert(err, checker.IsNil, check.Commentf("failed to save repo: %v %v", out, err)) + + deleteImages(repoName) + + loadCmd := exec.Command(dockerBinary, "load") + loadCmd.Stdin = strings.NewReader(out) + out, _, err = runCommandWithOutput(loadCmd) + c.Assert(err, checker.NotNil, check.Commentf("expected error, but succeeded with no error and output: %v", out)) + + after, _, err := dockerCmdWithError("inspect", repoName) + c.Assert(err, checker.NotNil, check.Commentf("the repo should not exist: %v", after)) +} + +func (s *DockerSuite) TestSaveSingleTag(c *check.C) { + testRequires(c, DaemonIsLinux) + repoName := "foobar-save-single-tag-test" + dockerCmd(c, "tag", "busybox:latest", fmt.Sprintf("%v:latest", repoName)) + + out, _ := dockerCmd(c, "images", "-q", "--no-trunc", repoName) + cleanedImageID := strings.TrimSpace(out) + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", fmt.Sprintf("%v:latest", repoName)), + exec.Command("tar", "t"), + exec.Command("grep", "-E", fmt.Sprintf("(^repositories$|%v)", cleanedImageID))) + c.Assert(err, checker.IsNil, check.Commentf("failed to save repo with image ID and 'repositories' file: %s, %v", out, err)) +} + +func (s *DockerSuite) TestSaveCheckTimes(c *check.C) { + repoName := "busybox:latest" + out, _ := dockerCmd(c, "inspect", repoName) + data := []struct { + ID string + Created time.Time + }{} + err := json.Unmarshal([]byte(out), &data) + c.Assert(err, checker.IsNil, check.Commentf("failed to marshal from %q: err %v", repoName, err)) + c.Assert(len(data), checker.Not(checker.Equals), 0, check.Commentf("failed to marshal the data from %q", repoName)) + tarTvTimeFormat := "2006-01-02 15:04" + out, _, err = runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", repoName), + exec.Command("tar", "tv"), + exec.Command("grep", "-E", fmt.Sprintf("%s %s", data[0].Created.Format(tarTvTimeFormat), data[0].ID))) + c.Assert(err, checker.IsNil, check.Commentf("failed to save repo with image ID and 'repositories' file: %s, %v", out, err)) +} + +func (s *DockerSuite) TestSaveImageId(c *check.C) { + testRequires(c, DaemonIsLinux) + repoName := "foobar-save-image-id-test" + dockerCmd(c, "tag", "emptyfs:latest", fmt.Sprintf("%v:latest", repoName)) + + out, _ := dockerCmd(c, "images", "-q", "--no-trunc", repoName) + cleanedLongImageID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "images", "-q", repoName) + cleanedShortImageID := strings.TrimSpace(out) + + // Make sure IDs are not empty + c.Assert(cleanedLongImageID, checker.Not(check.Equals), "", check.Commentf("Id should not be empty.")) + c.Assert(cleanedShortImageID, checker.Not(check.Equals), "", check.Commentf("Id should not be empty.")) + + saveCmd := exec.Command(dockerBinary, "save", cleanedShortImageID) + tarCmd := exec.Command("tar", "t") + + var err error + tarCmd.Stdin, err = saveCmd.StdoutPipe() + c.Assert(err, checker.IsNil, check.Commentf("cannot set stdout pipe for tar: %v", err)) + grepCmd := exec.Command("grep", cleanedLongImageID) + grepCmd.Stdin, err = tarCmd.StdoutPipe() + c.Assert(err, checker.IsNil, check.Commentf("cannot set stdout pipe for grep: %v", err)) + + c.Assert(tarCmd.Start(), checker.IsNil, check.Commentf("tar failed with error: %v", err)) + c.Assert(saveCmd.Start(), checker.IsNil, check.Commentf("docker save failed with error: %v", err)) + defer saveCmd.Wait() + defer tarCmd.Wait() + + out, _, err = runCommandWithOutput(grepCmd) + + c.Assert(err, checker.IsNil, check.Commentf("failed to save repo with image ID: %s, %v", out, err)) +} + +// save a repo and try to load it using flags +func (s *DockerSuite) TestSaveAndLoadRepoFlags(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "test-save-and-load-repo-flags" + dockerCmd(c, "run", "--name", name, "busybox", "true") + + repoName := "foobar-save-load-test" + + deleteImages(repoName) + dockerCmd(c, "commit", name, repoName) + + before, _ := dockerCmd(c, "inspect", repoName) + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", repoName), + exec.Command(dockerBinary, "load")) + c.Assert(err, checker.IsNil, check.Commentf("failed to save and load repo: %s, %v", out, err)) + + after, _ := dockerCmd(c, "inspect", repoName) + c.Assert(before, checker.Equals, after, check.Commentf("inspect is not the same after a save / load")) +} + +func (s *DockerSuite) TestSaveMultipleNames(c *check.C) { + testRequires(c, DaemonIsLinux) + repoName := "foobar-save-multi-name-test" + + // Make one image + dockerCmd(c, "tag", "emptyfs:latest", fmt.Sprintf("%v-one:latest", repoName)) + + // Make two images + dockerCmd(c, "tag", "emptyfs:latest", fmt.Sprintf("%v-two:latest", repoName)) + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", fmt.Sprintf("%v-one", repoName), fmt.Sprintf("%v-two:latest", repoName)), + exec.Command("tar", "xO", "repositories"), + exec.Command("grep", "-q", "-E", "(-one|-two)"), + ) + c.Assert(err, checker.IsNil, check.Commentf("failed to save multiple repos: %s, %v", out, err)) +} + +func (s *DockerSuite) TestSaveRepoWithMultipleImages(c *check.C) { + testRequires(c, DaemonIsLinux) + makeImage := func(from string, tag string) string { + var ( + out string + ) + out, _ = dockerCmd(c, "run", "-d", from, "true") + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "commit", cleanedContainerID, tag) + imageID := strings.TrimSpace(out) + return imageID + } + + repoName := "foobar-save-multi-images-test" + tagFoo := repoName + ":foo" + tagBar := repoName + ":bar" + + idFoo := makeImage("busybox:latest", tagFoo) + idBar := makeImage("busybox:latest", tagBar) + + deleteImages(repoName) + + // create the archive + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", repoName), + exec.Command("tar", "t"), + exec.Command("grep", "VERSION"), + exec.Command("cut", "-d", "/", "-f1")) + c.Assert(err, checker.IsNil, check.Commentf("failed to save multiple images: %s, %v", out, err)) + actual := strings.Split(strings.TrimSpace(out), "\n") + + // make the list of expected layers + out, _ = dockerCmd(c, "history", "-q", "--no-trunc", "busybox:latest") + expected := append(strings.Split(strings.TrimSpace(out), "\n"), idFoo, idBar) + + sort.Strings(actual) + sort.Strings(expected) + c.Assert(actual, checker.DeepEquals, expected, check.Commentf("archive does not contains the right layers: got %v, expected %v", actual, expected)) +} + +// Issue #6722 #5892 ensure directories are included in changes +func (s *DockerSuite) TestSaveDirectoryPermissions(c *check.C) { + testRequires(c, DaemonIsLinux) + layerEntries := []string{"opt/", "opt/a/", "opt/a/b/", "opt/a/b/c"} + layerEntriesAUFS := []string{"./", ".wh..wh.aufs", ".wh..wh.orph/", ".wh..wh.plnk/", "opt/", "opt/a/", "opt/a/b/", "opt/a/b/c"} + + name := "save-directory-permissions" + tmpDir, err := ioutil.TempDir("", "save-layers-with-directories") + c.Assert(err, checker.IsNil, check.Commentf("failed to create temporary directory: %s", err)) + extractionDirectory := filepath.Join(tmpDir, "image-extraction-dir") + os.Mkdir(extractionDirectory, 0777) + + defer os.RemoveAll(tmpDir) + _, err = buildImage(name, + `FROM busybox + RUN adduser -D user && mkdir -p /opt/a/b && chown -R user:user /opt/a + RUN touch /opt/a/b/c && chown user:user /opt/a/b/c`, + true) + c.Assert(err, checker.IsNil, check.Commentf("%v", err)) + + out, _, err := runCommandPipelineWithOutput( + exec.Command(dockerBinary, "save", name), + exec.Command("tar", "-xf", "-", "-C", extractionDirectory), + ) + c.Assert(err, checker.IsNil, check.Commentf("failed to save and extract image: %s", out)) + + dirs, err := ioutil.ReadDir(extractionDirectory) + c.Assert(err, checker.IsNil, check.Commentf("failed to get a listing of the layer directories: %s", err)) + + found := false + for _, entry := range dirs { + var entriesSansDev []string + if entry.IsDir() { + layerPath := filepath.Join(extractionDirectory, entry.Name(), "layer.tar") + + f, err := os.Open(layerPath) + c.Assert(err, checker.IsNil, check.Commentf("failed to open %s: %s", layerPath, err)) + + entries, err := listTar(f) + for _, e := range entries { + if !strings.Contains(e, "dev/") { + entriesSansDev = append(entriesSansDev, e) + } + } + c.Assert(err, checker.IsNil, check.Commentf("encountered error while listing tar entries: %s", err)) + + if reflect.DeepEqual(entriesSansDev, layerEntries) || reflect.DeepEqual(entriesSansDev, layerEntriesAUFS) { + found = true + break + } + } + } + + c.Assert(found, checker.Equals, true, check.Commentf("failed to find the layer with the right content listing")) + +} + +/* + * REBASE NOTE: migrate this test +// TestSaveAndLoadContentAddressable does a repeated save/load and checks that +// the ID changes the first time (because of content addressability), but +// doesn't change with another save/load (again, because of content +// addressability). +func (s *DockerSuite) TestSaveAndLoadContentAddressable(c *check.C) { + baseImage := "ca-save-load-test-base" + derivedImage := "ca-save-load-test-derived" + + _, err := buildImage(baseImage, fmt.Sprintf(` + FROM busybox + ENV FOO bar + CMD echo %s + `, baseImage), true) + if err != nil { + c.Fatal(err) + } + + baseIDBeforeSave, err := inspectField(baseImage, "Id") + c.Assert(err, check.IsNil) + baseParentBeforeSave, err := inspectField(baseImage, "Parent") + c.Assert(err, check.IsNil) + + _, err = buildImage(derivedImage, fmt.Sprintf(` + FROM %s + CMD echo %s + `, baseImage, derivedImage), true) + if err != nil { + c.Fatal(err) + } + + derivedIDBeforeSave, err := inspectField(derivedImage, "Id") + c.Assert(err, check.IsNil) + derivedParentBeforeSave, err := inspectField(derivedImage, "Parent") + c.Assert(err, check.IsNil) + + tmpDir, err := ioutil.TempDir("", "contentaddressable") + if err != nil { + c.Errorf("failed to create temporary directory: %s", err) + } + defer os.RemoveAll(tmpDir) + baseTar := filepath.Join(tmpDir, "base.tar") + derivedTar := filepath.Join(tmpDir, "derived.tar") + dockerCmd(c, "save", "--output", baseTar, baseImage) + dockerCmd(c, "save", "--output", derivedTar, derivedImage) + + // Delete images and reload + dockerCmd(c, "rmi", baseImage) + dockerCmd(c, "rmi", derivedImage) + + dockerCmd(c, "load", "--input", baseTar) + dockerCmd(c, "load", "--input", derivedTar) + + baseIDAfterLoad, err := inspectField(baseImage, "Id") + c.Assert(err, check.IsNil) + baseParentAfterLoad, err := inspectField(baseImage, "Parent") + c.Assert(err, check.IsNil) + derivedIDAfterLoad, err := inspectField(derivedImage, "Id") + c.Assert(err, check.IsNil) + derivedParentAfterLoad, err := inspectField(derivedImage, "Parent") + c.Assert(err, check.IsNil) + + // New IDs must be digests + _, err = digest.ParseDigest(baseIDAfterLoad) + c.Assert(err, check.IsNil) + _, err = digest.ParseDigest(baseParentAfterLoad) + c.Assert(err, check.IsNil) + _, err = digest.ParseDigest(derivedIDAfterLoad) + c.Assert(err, check.IsNil) + _, err = digest.ParseDigest(derivedParentAfterLoad) + c.Assert(err, check.IsNil) + + // They must NOT match the old IDs + c.Assert(baseIDAfterLoad, check.Not(check.Equals), baseIDBeforeSave) + c.Assert(baseParentAfterLoad, check.Not(check.Equals), baseParentBeforeSave) + c.Assert(derivedIDAfterLoad, check.Not(check.Equals), derivedIDBeforeSave) + c.Assert(derivedParentAfterLoad, check.Not(check.Equals), derivedParentBeforeSave) + + // Derived image parent should match base image ID + if derivedParentAfterLoad != baseIDAfterLoad { + c.Fatal("loaded derived image did not use already-loaded base image as parent") + } + + tmpDir2, err := ioutil.TempDir("", "contentaddressable2") + if err != nil { + c.Errorf("failed to create temporary directory: %s", err) + } + defer os.RemoveAll(tmpDir2) + baseTar = filepath.Join(tmpDir2, "base.tar") + derivedTar = filepath.Join(tmpDir2, "derived.tar") + dockerCmd(c, "save", "--output", baseTar, baseImage) + dockerCmd(c, "save", "--output", derivedTar, derivedImage) + + // Delete images and reload + dockerCmd(c, "rmi", baseImage) + dockerCmd(c, "rmi", derivedImage) + + dockerCmd(c, "load", "--input", baseTar) + dockerCmd(c, "load", "--input", derivedTar) + + baseIDAfterLoad2, err := inspectField(baseImage, "Id") + c.Assert(err, check.IsNil) + baseParentAfterLoad2, err := inspectField(baseImage, "Parent") + c.Assert(err, check.IsNil) + derivedIDAfterLoad2, err := inspectField(derivedImage, "Id") + c.Assert(err, check.IsNil) + derivedParentAfterLoad2, err := inspectField(derivedImage, "Parent") + c.Assert(err, check.IsNil) + + // New IDs must match IDs from first load + c.Assert(baseIDAfterLoad2, check.Equals, baseIDAfterLoad) + c.Assert(baseParentAfterLoad2, check.Equals, baseParentAfterLoad) + c.Assert(derivedIDAfterLoad2, check.Equals, derivedIDAfterLoad) + c.Assert(derivedParentAfterLoad2, check.Equals, derivedParentAfterLoad) +} +*/ diff --git a/integration-cli/docker_cli_save_load_unix_test.go b/integration-cli/docker_cli_save_load_unix_test.go new file mode 100644 index 0000000000..185c1a7162 --- /dev/null +++ b/integration-cli/docker_cli_save_load_unix_test.go @@ -0,0 +1,66 @@ +// +build !windows + +package main + +import ( + "io/ioutil" + "os" + "os/exec" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" + "github.com/kr/pty" +) + +// save a repo and try to load it using stdout +func (s *DockerSuite) TestSaveAndLoadRepoStdout(c *check.C) { + name := "test-save-and-load-repo-stdout" + dockerCmd(c, "run", "--name", name, "busybox", "true") + + repoName := "foobar-save-load-test" + out, _ := dockerCmd(c, "commit", name, repoName) + + before, _ := dockerCmd(c, "inspect", repoName) + + tmpFile, err := ioutil.TempFile("", "foobar-save-load-test.tar") + c.Assert(err, check.IsNil) + defer os.Remove(tmpFile.Name()) + + saveCmd := exec.Command(dockerBinary, "save", repoName) + saveCmd.Stdout = tmpFile + + _, err = runCommand(saveCmd) + c.Assert(err, check.IsNil) + + tmpFile, err = os.Open(tmpFile.Name()) + c.Assert(err, check.IsNil) + + deleteImages(repoName) + + loadCmd := exec.Command(dockerBinary, "load") + loadCmd.Stdin = tmpFile + + out, _, err = runCommandWithOutput(loadCmd) + c.Assert(err, check.IsNil, check.Commentf(out)) + + after, _ := dockerCmd(c, "inspect", repoName) + + c.Assert(before, check.Equals, after) //inspect is not the same after a save / load + + deleteImages(repoName) + + pty, tty, err := pty.Open() + c.Assert(err, check.IsNil) + cmd := exec.Command(dockerBinary, "save", repoName) + cmd.Stdin = tty + cmd.Stdout = tty + cmd.Stderr = tty + c.Assert(cmd.Start(), check.IsNil) + c.Assert(cmd.Wait(), check.NotNil) //did not break writing to a TTY + + buf := make([]byte, 1024) + + n, err := pty.Read(buf) + c.Assert(err, check.IsNil) //could not read tty output + c.Assert(string(buf[:n]), checker.Contains, "Cowardly refusing", check.Commentf("help output is not being yielded", out)) +} diff --git a/integration-cli/docker_cli_search_test.go b/integration-cli/docker_cli_search_test.go new file mode 100644 index 0000000000..dfab81044a --- /dev/null +++ b/integration-cli/docker_cli_search_test.go @@ -0,0 +1,55 @@ +package main + +import ( + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +// search for repos named "registry" on the central registry +func (s *DockerSuite) TestSearchOnCentralRegistry(c *check.C) { + testRequires(c, Network, DaemonIsLinux) + + out, _ := dockerCmd(c, "search", "busybox") + c.Assert(out, checker.Contains, "Busybox base image.", check.Commentf("couldn't find any repository named (or containing) 'Busybox base image.'")) +} + +func (s *DockerSuite) TestSearchStarsOptionWithWrongParameter(c *check.C) { + out, _, err := dockerCmdWithError("search", "--stars=a", "busybox") + c.Assert(err, check.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "invalid value", check.Commentf("couldn't find the invalid value warning")) + + out, _, err = dockerCmdWithError("search", "-s=-1", "busybox") + c.Assert(err, check.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "invalid value", check.Commentf("couldn't find the invalid value warning")) +} + +func (s *DockerSuite) TestSearchCmdOptions(c *check.C) { + testRequires(c, Network) + + out, _ := dockerCmd(c, "search", "--help") + c.Assert(out, checker.Contains, "Usage:\tdocker search [OPTIONS] TERM") + + outSearchCmd, _ := dockerCmd(c, "search", "busybox") + outSearchCmdNotrunc, _ := dockerCmd(c, "search", "--no-trunc=true", "busybox") + c.Assert(len(outSearchCmd) > len(outSearchCmdNotrunc), check.Equals, false, check.Commentf("The no-trunc option can't take effect.")) + + outSearchCmdautomated, _ := dockerCmd(c, "search", "--automated=true", "busybox") //The busybox is a busybox base image, not an AUTOMATED image. + outSearchCmdautomatedSlice := strings.Split(outSearchCmdautomated, "\n") + for i := range outSearchCmdautomatedSlice { + c.Assert(strings.HasPrefix(outSearchCmdautomatedSlice[i], "busybox "), check.Equals, false, check.Commentf("The busybox is not an AUTOMATED image: %s", out)) + } + + outSearchCmdStars, _ := dockerCmd(c, "search", "-s=2", "busybox") + c.Assert(strings.Count(outSearchCmdStars, "[OK]") > strings.Count(outSearchCmd, "[OK]"), check.Equals, false, check.Commentf("The quantity of images with stars should be less than that of all images: %s", outSearchCmdStars)) + + dockerCmd(c, "search", "--stars=2", "--automated=true", "--no-trunc=true", "busybox") +} + +// search for repos which start with "ubuntu-" on the central registry +func (s *DockerSuite) TestSearchOnCentralRegistryWithDash(c *check.C) { + testRequires(c, Network, DaemonIsLinux) + + dockerCmd(c, "search", "ubuntu-") +} diff --git a/integration-cli/docker_cli_start_test.go b/integration-cli/docker_cli_start_test.go new file mode 100644 index 0000000000..dca2bd1be4 --- /dev/null +++ b/integration-cli/docker_cli_start_test.go @@ -0,0 +1,230 @@ +package main + +import ( + "fmt" + "strings" + "time" + + "github.com/go-check/check" +) + +// Regression test for https://github.com/docker/docker/issues/7843 +func (s *DockerSuite) TestStartAttachReturnsOnError(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "run", "-d", "--name", "test", "busybox") + dockerCmd(c, "wait", "test") + + // Expect this to fail because the above container is stopped, this is what we want + if _, _, err := dockerCmdWithError("run", "-d", "--name", "test2", "--link", "test:test", "busybox"); err == nil { + c.Fatal("Expected error but got none") + } + + ch := make(chan error) + go func() { + // Attempt to start attached to the container that won't start + // This should return an error immediately since the container can't be started + if _, _, err := dockerCmdWithError("start", "-a", "test2"); err == nil { + ch <- fmt.Errorf("Expected error but got none") + } + close(ch) + }() + + select { + case err := <-ch: + c.Assert(err, check.IsNil) + case <-time.After(time.Second): + c.Fatalf("Attach did not exit properly") + } +} + +// gh#8555: Exit code should be passed through when using start -a +func (s *DockerSuite) TestStartAttachCorrectExitCode(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _, _ := dockerCmdWithStdoutStderr(c, "run", "-d", "busybox", "sh", "-c", "sleep 2; exit 1") + out = strings.TrimSpace(out) + + // make sure the container has exited before trying the "start -a" + dockerCmd(c, "wait", out) + + startOut, exitCode, err := dockerCmdWithError("start", "-a", out) + if err != nil && !strings.Contains("exit status 1", fmt.Sprintf("%s", err)) { + c.Fatalf("start command failed unexpectedly with error: %v, output: %q", err, startOut) + } + if exitCode != 1 { + c.Fatalf("start -a did not respond with proper exit code: expected 1, got %d", exitCode) + } + +} + +func (s *DockerSuite) TestStartAttachSilent(c *check.C) { + testRequires(c, DaemonIsLinux) + name := "teststartattachcorrectexitcode" + dockerCmd(c, "run", "--name", name, "busybox", "echo", "test") + + // make sure the container has exited before trying the "start -a" + dockerCmd(c, "wait", name) + + startOut, _ := dockerCmd(c, "start", "-a", name) + if expected := "test\n"; startOut != expected { + c.Fatalf("start -a produced unexpected output: expected %q, got %q", expected, startOut) + } +} + +func (s *DockerSuite) TestStartRecordError(c *check.C) { + testRequires(c, DaemonIsLinux) + // when container runs successfully, we should not have state.Error + dockerCmd(c, "run", "-d", "-p", "9999:9999", "--name", "test", "busybox", "top") + stateErr, err := inspectField("test", "State.Error") + c.Assert(err, check.IsNil) + if stateErr != "" { + c.Fatalf("Expected to not have state error but got state.Error(%q)", stateErr) + } + + // Expect this to fail and records error because of ports conflict + out, _, err := dockerCmdWithError("run", "-d", "--name", "test2", "-p", "9999:9999", "busybox", "top") + if err == nil { + c.Fatalf("Expected error but got none, output %q", out) + } + + stateErr, err = inspectField("test2", "State.Error") + c.Assert(err, check.IsNil) + expected := "port is already allocated" + if stateErr == "" || !strings.Contains(stateErr, expected) { + c.Fatalf("State.Error(%q) does not include %q", stateErr, expected) + } + + // Expect the conflict to be resolved when we stop the initial container + dockerCmd(c, "stop", "test") + dockerCmd(c, "start", "test2") + stateErr, err = inspectField("test2", "State.Error") + c.Assert(err, check.IsNil) + if stateErr != "" { + c.Fatalf("Expected to not have state error but got state.Error(%q)", stateErr) + } +} + +func (s *DockerSuite) TestStartPausedContainer(c *check.C) { + testRequires(c, DaemonIsLinux) + defer unpauseAllContainers() + + dockerCmd(c, "run", "-d", "--name", "testing", "busybox", "top") + + dockerCmd(c, "pause", "testing") + + if out, _, err := dockerCmdWithError("start", "testing"); err == nil || !strings.Contains(out, "Cannot start a paused container, try unpause instead.") { + c.Fatalf("an error should have been shown that you cannot start paused container: %s\n%v", out, err) + } +} + +func (s *DockerSuite) TestStartMultipleContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + // run a container named 'parent' and create two container link to `parent` + dockerCmd(c, "run", "-d", "--name", "parent", "busybox", "top") + + for _, container := range []string{"child_first", "child_second"} { + dockerCmd(c, "create", "--name", container, "--link", "parent:parent", "busybox", "top") + } + + // stop 'parent' container + dockerCmd(c, "stop", "parent") + + out, err := inspectField("parent", "State.Running") + c.Assert(err, check.IsNil) + if out != "false" { + c.Fatal("Container should be stopped") + } + + // start all the three containers, container `child_first` start first which should be failed + // container 'parent' start second and then start container 'child_second' + out, _, err = dockerCmdWithError("start", "child_first", "parent", "child_second") + if !strings.Contains(out, "Cannot start container child_first") || err == nil { + c.Fatal("Expected error but got none") + } + + for container, expected := range map[string]string{"parent": "true", "child_first": "false", "child_second": "true"} { + out, err := inspectField(container, "State.Running") + c.Assert(err, check.IsNil) + if out != expected { + c.Fatal("Container running state wrong") + } + + } +} + +func (s *DockerSuite) TestStartAttachMultipleContainers(c *check.C) { + testRequires(c, DaemonIsLinux) + // run multiple containers to test + for _, container := range []string{"test1", "test2", "test3"} { + dockerCmd(c, "run", "-d", "--name", container, "busybox", "top") + } + + // stop all the containers + for _, container := range []string{"test1", "test2", "test3"} { + dockerCmd(c, "stop", container) + } + + // test start and attach multiple containers at once, expected error + for _, option := range []string{"-a", "-i", "-ai"} { + out, _, err := dockerCmdWithError("start", option, "test1", "test2", "test3") + if !strings.Contains(out, "You cannot start and attach multiple containers at once.") || err == nil { + c.Fatal("Expected error but got none") + } + } + + // confirm the state of all the containers be stopped + for container, expected := range map[string]string{"test1": "false", "test2": "false", "test3": "false"} { + out, err := inspectField(container, "State.Running") + if err != nil { + c.Fatal(out, err) + } + if out != expected { + c.Fatal("Container running state wrong") + } + } +} + +func TestStartAttachMultipleContainers(t *testing.T) { + + var cmd *exec.Cmd + + defer deleteAllContainers() + // run multiple containers to test + for _, container := range []string{"test1", "test2", "test3"} { + cmd = exec.Command(dockerBinary, "run", "-d", "--name", container, "busybox", "top") + if out, _, err := runCommandWithOutput(cmd); err != nil { + t.Fatal(out, err) + } + } + + // stop all the containers + for _, container := range []string{"test1", "test2", "test3"} { + cmd = exec.Command(dockerBinary, "stop", container) + if out, _, err := runCommandWithOutput(cmd); err != nil { + t.Fatal(out, err) + } + } + + // test start and attach multiple containers at once, expected error + for _, option := range []string{"-a", "-i", "-ai"} { + cmd = exec.Command(dockerBinary, "start", option, "test1", "test2", "test3") + out, _, err := runCommandWithOutput(cmd) + if !strings.Contains(out, "You cannot start and attach multiple containers at once.") || err == nil { + t.Fatal("Expected error but got none") + } + } + + // confirm the state of all the containers be stopped + for container, expected := range map[string]string{"test1": "false", "test2": "false", "test3": "false"} { + cmd = exec.Command(dockerBinary, "inspect", "-f", "{{.State.Running}}", container) + out, _, err := runCommandWithOutput(cmd) + if err != nil { + t.Fatal(out, err) + } + out = strings.Trim(out, "\r\n") + if out != expected { + t.Fatal("Container running state wrong") + } + } + + logDone("start - error on start and attach multiple containers at once") +} diff --git a/integration-cli/docker_cli_start_volume_driver_unix_test.go b/integration-cli/docker_cli_start_volume_driver_unix_test.go new file mode 100644 index 0000000000..dc24627055 --- /dev/null +++ b/integration-cli/docker_cli_start_volume_driver_unix_test.go @@ -0,0 +1,364 @@ +// +build !windows + +package main + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "net/http" + "net/http/httptest" + "os" + "os/exec" + "path/filepath" + "strings" + "time" + + "github.com/go-check/check" +) + +func init() { + check.Suite(&DockerExternalVolumeSuite{ + ds: &DockerSuite{}, + }) +} + +type eventCounter struct { + activations int + creations int + removals int + mounts int + unmounts int + paths int +} + +type DockerExternalVolumeSuite struct { + server *httptest.Server + ds *DockerSuite + d *Daemon + ec *eventCounter +} + +func (s *DockerExternalVolumeSuite) SetUpTest(c *check.C) { + s.d = NewDaemon(c) + s.ec = &eventCounter{} +} + +func (s *DockerExternalVolumeSuite) TearDownTest(c *check.C) { + s.d.Stop() + s.ds.TearDownTest(c) +} + +func (s *DockerExternalVolumeSuite) SetUpSuite(c *check.C) { + mux := http.NewServeMux() + s.server = httptest.NewServer(mux) + + type pluginRequest struct { + name string + } + + mux.HandleFunc("/Plugin.Activate", func(w http.ResponseWriter, r *http.Request) { + s.ec.activations++ + + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintln(w, `{"Implements": ["VolumeDriver"]}`) + }) + + mux.HandleFunc("/VolumeDriver.Create", func(w http.ResponseWriter, r *http.Request) { + s.ec.creations++ + + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintln(w, `{}`) + }) + + mux.HandleFunc("/VolumeDriver.Remove", func(w http.ResponseWriter, r *http.Request) { + s.ec.removals++ + + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintln(w, `{}`) + }) + + mux.HandleFunc("/VolumeDriver.Path", func(w http.ResponseWriter, r *http.Request) { + s.ec.paths++ + + var pr pluginRequest + if err := json.NewDecoder(r.Body).Decode(&pr); err != nil { + http.Error(w, err.Error(), 500) + } + + p := hostVolumePath(pr.name) + + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintln(w, fmt.Sprintf("{\"Mountpoint\": \"%s\"}", p)) + }) + + mux.HandleFunc("/VolumeDriver.Mount", func(w http.ResponseWriter, r *http.Request) { + s.ec.mounts++ + + var pr pluginRequest + if err := json.NewDecoder(r.Body).Decode(&pr); err != nil { + http.Error(w, err.Error(), 500) + } + + p := hostVolumePath(pr.name) + if err := os.MkdirAll(p, 0755); err != nil { + http.Error(w, err.Error(), 500) + } + + if err := ioutil.WriteFile(filepath.Join(p, "test"), []byte(s.server.URL), 0644); err != nil { + http.Error(w, err.Error(), 500) + } + + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintln(w, fmt.Sprintf("{\"Mountpoint\": \"%s\"}", p)) + }) + + mux.HandleFunc("/VolumeDriver.Unmount", func(w http.ResponseWriter, r *http.Request) { + s.ec.unmounts++ + + var pr pluginRequest + if err := json.NewDecoder(r.Body).Decode(&pr); err != nil { + http.Error(w, err.Error(), 500) + } + + w.Header().Set("Content-Type", "application/vnd.docker.plugins.v1+json") + fmt.Fprintln(w, `{}`) + }) + + if err := os.MkdirAll("/etc/docker/plugins", 0755); err != nil { + c.Fatal(err) + } + + if err := ioutil.WriteFile("/etc/docker/plugins/test-external-volume-driver.spec", []byte(s.server.URL), 0644); err != nil { + c.Fatal(err) + } +} + +func (s *DockerExternalVolumeSuite) TearDownSuite(c *check.C) { + s.server.Close() + + if err := os.RemoveAll("/etc/docker/plugins"); err != nil { + c.Fatal(err) + } +} + +func (s *DockerExternalVolumeSuite) TestStartExternalNamedVolumeDriver(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "--rm", "--name", "test-data", "-v", "external-volume-test:/tmp/external-volume-test", "--volume-driver", "test-external-volume-driver", "busybox:latest", "cat", "/tmp/external-volume-test/test") + if err != nil { + c.Fatal(out, err) + } + + if !strings.Contains(out, s.server.URL) { + c.Fatalf("External volume mount failed. Output: %s\n", out) + } + + p := hostVolumePath("external-volume-test") + _, err = os.Lstat(p) + if err == nil { + c.Fatalf("Expected error checking volume path in host: %s\n", p) + } + + if !os.IsNotExist(err) { + c.Fatalf("Expected volume path in host to not exist: %s, %v\n", p, err) + } + + c.Assert(s.ec.activations, check.Equals, 1) + c.Assert(s.ec.creations, check.Equals, 1) + c.Assert(s.ec.removals, check.Equals, 1) + c.Assert(s.ec.mounts, check.Equals, 1) + c.Assert(s.ec.unmounts, check.Equals, 1) +} + +func (s *DockerExternalVolumeSuite) TestStartExternalVolumeUnnamedDriver(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "--rm", "--name", "test-data", "-v", "/tmp/external-volume-test", "--volume-driver", "test-external-volume-driver", "busybox:latest", "cat", "/tmp/external-volume-test/test") + if err != nil { + c.Fatal(err) + } + + if !strings.Contains(out, s.server.URL) { + c.Fatalf("External volume mount failed. Output: %s\n", out) + } + + c.Assert(s.ec.activations, check.Equals, 1) + c.Assert(s.ec.creations, check.Equals, 1) + c.Assert(s.ec.removals, check.Equals, 1) + c.Assert(s.ec.mounts, check.Equals, 1) + c.Assert(s.ec.unmounts, check.Equals, 1) +} + +func (s DockerExternalVolumeSuite) TestStartExternalVolumeDriverVolumesFrom(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + out, err := s.d.Cmd("run", "-d", "--name", "vol-test1", "-v", "/foo", "--volume-driver", "test-external-volume-driver", "busybox:latest") + c.Assert(err, check.IsNil, check.Commentf(out)) + + out, err = s.d.Cmd("run", "--rm", "--volumes-from", "vol-test1", "--name", "vol-test2", "busybox", "ls", "/tmp") + c.Assert(err, check.IsNil, check.Commentf(out)) + + out, err = s.d.Cmd("rm", "-fv", "vol-test1") + c.Assert(err, check.IsNil, check.Commentf(out)) + + c.Assert(s.ec.activations, check.Equals, 1) + c.Assert(s.ec.creations, check.Equals, 1) + c.Assert(s.ec.removals, check.Equals, 1) + c.Assert(s.ec.mounts, check.Equals, 2) + c.Assert(s.ec.unmounts, check.Equals, 2) +} + +func (s DockerExternalVolumeSuite) TestStartExternalVolumeDriverDeleteContainer(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + if out, err := s.d.Cmd("run", "-d", "--name", "vol-test1", "-v", "/foo", "--volume-driver", "test-external-volume-driver", "busybox:latest"); err != nil { + c.Fatal(out, err) + } + + if out, err := s.d.Cmd("rm", "-fv", "vol-test1"); err != nil { + c.Fatal(out, err) + } + + c.Assert(s.ec.activations, check.Equals, 1) + c.Assert(s.ec.creations, check.Equals, 1) + c.Assert(s.ec.removals, check.Equals, 1) + c.Assert(s.ec.mounts, check.Equals, 1) + c.Assert(s.ec.unmounts, check.Equals, 1) +} + +func hostVolumePath(name string) string { + return fmt.Sprintf("/var/lib/docker/volumes/%s", name) +} + +func (s *DockerExternalVolumeSuite) TestStartExternalNamedVolumeDriverCheckBindLocalVolume(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + expected := s.server.URL + + dockerfile := fmt.Sprintf(`FROM busybox:latest + RUN mkdir /nobindthenlocalvol + RUN echo %s > /nobindthenlocalvol/test + VOLUME ["/nobindthenlocalvol"]`, expected) + + img := "test-checkbindlocalvolume" + + _, err := buildImageWithOutInDamon(s.d.sock(), img, dockerfile, true) + c.Assert(err, check.IsNil) + + out, err := s.d.Cmd("run", "--rm", "--name", "test-data-nobind", "-v", "external-volume-test:/tmp/external-volume-test", "--volume-driver", "test-external-volume-driver", img, "cat", "/nobindthenlocalvol/test") + c.Assert(err, check.IsNil) + + if !strings.Contains(out, expected) { + c.Fatalf("External volume mount failed. Output: %s\n", out) + } + + c.Assert(s.ec.activations, check.Equals, 1) + c.Assert(s.ec.creations, check.Equals, 1) + c.Assert(s.ec.removals, check.Equals, 1) + c.Assert(s.ec.mounts, check.Equals, 1) + c.Assert(s.ec.unmounts, check.Equals, 1) +} + +// Make sure a request to use a down driver doesn't block other requests +func (s *DockerExternalVolumeSuite) TestStartExternalVolumeDriverLookupNotBlocked(c *check.C) { + specPath := "/etc/docker/plugins/down-driver.spec" + err := ioutil.WriteFile("/etc/docker/plugins/down-driver.spec", []byte("tcp://127.0.0.7:9999"), 0644) + c.Assert(err, check.IsNil) + defer os.RemoveAll(specPath) + + chCmd1 := make(chan struct{}) + chCmd2 := make(chan error) + cmd1 := exec.Command(dockerBinary, "volume", "create", "-d", "down-driver") + cmd2 := exec.Command(dockerBinary, "volume", "create") + + c.Assert(cmd1.Start(), check.IsNil) + defer cmd1.Process.Kill() + time.Sleep(100 * time.Millisecond) // ensure API has been called + c.Assert(cmd2.Start(), check.IsNil) + + go func() { + cmd1.Wait() + close(chCmd1) + }() + go func() { + chCmd2 <- cmd2.Wait() + }() + + select { + case <-chCmd1: + cmd2.Process.Kill() + c.Fatalf("volume create with down driver finished unexpectedly") + case err := <-chCmd2: + c.Assert(err, check.IsNil, check.Commentf("error creating volume")) + case <-time.After(5 * time.Second): + c.Fatal("volume creates are blocked by previous create requests when previous driver is down") + cmd2.Process.Kill() + } +} + +func (s *DockerExternalVolumeSuite) TestStartExternalVolumeDriverRetryNotImmediatelyExists(c *check.C) { + if err := s.d.StartWithBusybox(); err != nil { + c.Fatal(err) + } + + specPath := "/etc/docker/plugins/test-external-volume-driver-retry.spec" + os.RemoveAll(specPath) + defer os.RemoveAll(specPath) + + errchan := make(chan error) + go func() { + if out, err := s.d.Cmd("run", "--rm", "--name", "test-data-retry", "-v", "external-volume-test:/tmp/external-volume-test", "--volume-driver", "test-external-volume-driver-retry", "busybox:latest"); err != nil { + errchan <- fmt.Errorf("%v:\n%s", err, out) + } + close(errchan) + }() + go func() { + // wait for a retry to occur, then create spec to allow plugin to register + time.Sleep(2000 * time.Millisecond) + if err := ioutil.WriteFile(specPath, []byte(s.server.URL), 0644); err != nil { + c.Fatal(err) + } + }() + + select { + case err := <-errchan: + if err != nil { + c.Fatal(err) + } + case <-time.After(8 * time.Second): + c.Fatal("volume creates fail when plugin not immediately available") + } + + c.Assert(s.ec.activations, check.Equals, 1) + c.Assert(s.ec.creations, check.Equals, 1) + c.Assert(s.ec.removals, check.Equals, 1) + c.Assert(s.ec.mounts, check.Equals, 1) + c.Assert(s.ec.unmounts, check.Equals, 1) +} + +func (s *DockerExternalVolumeSuite) TestStartExternalVolumeDriverBindExternalVolume(c *check.C) { + dockerCmd(c, "volume", "create", "-d", "test-external-volume-driver", "--name", "foo") + dockerCmd(c, "run", "-d", "--name", "testing", "-v", "foo:/bar", "busybox", "top") + + var mounts []struct { + Name string + Driver string + } + out, err := inspectFieldJSON("testing", "Mounts") + c.Assert(err, check.IsNil) + c.Assert(json.NewDecoder(strings.NewReader(out)).Decode(&mounts), check.IsNil) + c.Assert(len(mounts), check.Equals, 1, check.Commentf(out)) + c.Assert(mounts[0].Name, check.Equals, "foo") + c.Assert(mounts[0].Driver, check.Equals, "test-external-volume-driver") +} diff --git a/integration-cli/docker_cli_stats_test.go b/integration-cli/docker_cli_stats_test.go new file mode 100644 index 0000000000..eb8cb07356 --- /dev/null +++ b/integration-cli/docker_cli_stats_test.go @@ -0,0 +1,50 @@ +package main + +import ( + "os/exec" + "strings" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestStatsNoStream(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "top") + id := strings.TrimSpace(out) + c.Assert(waitRun(id), checker.IsNil) + + statsCmd := exec.Command(dockerBinary, "stats", "--no-stream", id) + type output struct { + out []byte + err error + } + + ch := make(chan output) + go func() { + out, err := statsCmd.Output() + ch <- output{out, err} + }() + + select { + case outerr := <-ch: + c.Assert(outerr.err, checker.IsNil, check.Commentf("Error running stats: %v", outerr.err)) + c.Assert(string(outerr.out), checker.Contains, id) //running container wasn't present in output + case <-time.After(3 * time.Second): + statsCmd.Process.Kill() + c.Fatalf("stats did not return immediately when not streaming") + } +} + +func (s *DockerSuite) TestStatsContainerNotFound(c *check.C) { + testRequires(c, DaemonIsLinux) + + out, _, err := dockerCmdWithError("stats", "notfound") + c.Assert(err, checker.NotNil) + c.Assert(out, checker.Contains, "no such id: notfound", check.Commentf("Expected to fail on not found container stats, got %q instead", out)) + + out, _, err = dockerCmdWithError("stats", "--no-stream", "notfound") + c.Assert(err, checker.NotNil) + c.Assert(out, checker.Contains, "no such id: notfound", check.Commentf("Expected to fail on not found container stats with --no-stream, got %q instead", out)) +} diff --git a/integration-cli/docker_cli_tag_test.go b/integration-cli/docker_cli_tag_test.go new file mode 100644 index 0000000000..a3e1e0a2e8 --- /dev/null +++ b/integration-cli/docker_cli_tag_test.go @@ -0,0 +1,173 @@ +package main + +import ( + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/pkg/stringutils" + "github.com/go-check/check" +) + +// tagging a named image in a new unprefixed repo should work +func (s *DockerSuite) TestTagUnprefixedRepoByName(c *check.C) { + testRequires(c, DaemonIsLinux) + if err := pullImageIfNotExist("busybox:latest"); err != nil { + c.Fatal("couldn't find the busybox:latest image locally and failed to pull it") + } + + dockerCmd(c, "tag", "busybox:latest", "testfoobarbaz") +} + +// tagging an image by ID in a new unprefixed repo should work +func (s *DockerSuite) TestTagUnprefixedRepoByID(c *check.C) { + testRequires(c, DaemonIsLinux) + imageID, err := inspectField("busybox", "Id") + c.Assert(err, check.IsNil) + dockerCmd(c, "tag", imageID, "testfoobarbaz") +} + +// ensure we don't allow the use of invalid repository names; these tag operations should fail +func (s *DockerSuite) TestTagInvalidUnprefixedRepo(c *check.C) { + invalidRepos := []string{"fo$z$", "Foo@3cc", "Foo$3", "Foo*3", "Fo^3", "Foo!3", "F)xcz(", "fo%asd"} + + for _, repo := range invalidRepos { + out, _, err := dockerCmdWithError("tag", "busybox", repo) + c.Assert(err, checker.NotNil, check.Commentf("tag busybox %v should have failed : %v", repo, out)) + } +} + +// ensure we don't allow the use of invalid tags; these tag operations should fail +func (s *DockerSuite) TestTagInvalidPrefixedRepo(c *check.C) { + longTag := stringutils.GenerateRandomAlphaOnlyString(121) + + invalidTags := []string{"repo:fo$z$", "repo:Foo@3cc", "repo:Foo$3", "repo:Foo*3", "repo:Fo^3", "repo:Foo!3", "repo:%goodbye", "repo:#hashtagit", "repo:F)xcz(", "repo:-foo", "repo:..", longTag} + + for _, repotag := range invalidTags { + out, _, err := dockerCmdWithError("tag", "busybox", repotag) + c.Assert(err, checker.NotNil, check.Commentf("tag busybox %v should have failed : %v", repotag, out)) + } +} + +// ensure we allow the use of valid tags +func (s *DockerSuite) TestTagValidPrefixedRepo(c *check.C) { + testRequires(c, DaemonIsLinux) + if err := pullImageIfNotExist("busybox:latest"); err != nil { + c.Fatal("couldn't find the busybox:latest image locally and failed to pull it") + } + + validRepos := []string{"fooo/bar", "fooaa/test", "foooo:t"} + + for _, repo := range validRepos { + _, _, err := dockerCmdWithError("tag", "busybox:latest", repo) + if err != nil { + c.Errorf("tag busybox %v should have worked: %s", repo, err) + continue + } + deleteImages(repo) + } +} + +// tag an image with an existed tag name without -f option should fail +func (s *DockerSuite) TestTagExistedNameWithoutForce(c *check.C) { + testRequires(c, DaemonIsLinux) + if err := pullImageIfNotExist("busybox:latest"); err != nil { + c.Fatal("couldn't find the busybox:latest image locally and failed to pull it") + } + + dockerCmd(c, "tag", "busybox:latest", "busybox:test") + out, _, err := dockerCmdWithError("tag", "busybox:latest", "busybox:test") + + c.Assert(err, checker.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "Conflict: Tag busybox:test is already set to image", check.Commentf("tag busybox busybox:test should have failed,because busybox:test is existed")) +} + +// tag an image with an existed tag name with -f option should work +func (s *DockerSuite) TestTagExistedNameWithForce(c *check.C) { + testRequires(c, DaemonIsLinux) + if err := pullImageIfNotExist("busybox:latest"); err != nil { + c.Fatal("couldn't find the busybox:latest image locally and failed to pull it") + } + + dockerCmd(c, "tag", "busybox:latest", "busybox:test") + dockerCmd(c, "tag", "-f", "busybox:latest", "busybox:test") +} + +func (s *DockerSuite) TestTagWithPrefixHyphen(c *check.C) { + testRequires(c, DaemonIsLinux) + if err := pullImageIfNotExist("busybox:latest"); err != nil { + c.Fatal("couldn't find the busybox:latest image locally and failed to pull it") + } + + // test repository name begin with '-' + out, _, err := dockerCmdWithError("tag", "busybox:latest", "-busybox:test") + c.Assert(err, checker.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "repository name component must match", check.Commentf("tag a name begin with '-' should failed")) + + // test namespace name begin with '-' + out, _, err = dockerCmdWithError("tag", "busybox:latest", "-test/busybox:test") + c.Assert(err, checker.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "repository name component must match", check.Commentf("tag a name begin with '-' should failed")) + + // test index name begin with '-' + out, _, err = dockerCmdWithError("tag", "busybox:latest", "-index:5000/busybox:test") + c.Assert(err, checker.NotNil, check.Commentf(out)) + c.Assert(out, checker.Contains, "Invalid index name (-index:5000). Cannot begin or end with a hyphen", check.Commentf("tag a name begin with '-' should failed")) +} + +// ensure tagging using official names works +// ensure all tags result in the same name +func (s *DockerSuite) TestTagOfficialNames(c *check.C) { + testRequires(c, DaemonIsLinux) + names := []string{ + "docker.io/busybox", + "index.docker.io/busybox", + "library/busybox", + "docker.io/library/busybox", + "index.docker.io/library/busybox", + } + + for _, name := range names { + out, exitCode, err := dockerCmdWithError("tag", "-f", "busybox:latest", name+":latest") + if err != nil || exitCode != 0 { + c.Errorf("tag busybox %v should have worked: %s, %s", name, err, out) + continue + } + + // ensure we don't have multiple tag names. + out, _, err = dockerCmdWithError("images") + if err != nil { + c.Errorf("listing images failed with errors: %v, %s", err, out) + } else if strings.Contains(out, name) { + c.Errorf("images should not have listed '%s'", name) + deleteImages(name + ":latest") + } + } + + for _, name := range names { + _, exitCode, err := dockerCmdWithError("tag", "-f", name+":latest", "fooo/bar:latest") + if err != nil || exitCode != 0 { + c.Errorf("tag %v fooo/bar should have worked: %s", name, err) + continue + } + deleteImages("fooo/bar:latest") + } +} + +// ensure tags can not match digests +func (s *DockerSuite) TestTagMatchesDigest(c *check.C) { + testRequires(c, DaemonIsLinux) + if err := pullImageIfNotExist("busybox:latest"); err != nil { + c.Fatal("couldn't find the busybox:latest image locally and failed to pull it") + } + digest := "busybox@sha256:abcdef76720241213f5303bda7704ec4c2ef75613173910a56fb1b6e20251507" + // test setting tag fails + _, _, err := dockerCmdWithError("tag", "-f", "busybox:latest", digest) + if err == nil { + c.Fatal("digest tag a name should have failed") + } + // check that no new image matches the digest + _, _, err = dockerCmdWithError("inspect", digest) + if err == nil { + c.Fatal("inspecting by digest should have failed") + } +} diff --git a/integration-cli/docker_cli_top_test.go b/integration-cli/docker_cli_top_test.go new file mode 100644 index 0000000000..e0865b9212 --- /dev/null +++ b/integration-cli/docker_cli_top_test.go @@ -0,0 +1,43 @@ +package main + +import ( + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestTopMultipleArgs(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-i", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + out, _ = dockerCmd(c, "top", cleanedContainerID, "-o", "pid") + c.Assert(out, checker.Contains, "PID", check.Commentf("did not see PID after top -o pid: %s", out)) +} + +func (s *DockerSuite) TestTopNonPrivileged(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-i", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + out1, _ := dockerCmd(c, "top", cleanedContainerID) + out2, _ := dockerCmd(c, "top", cleanedContainerID) + dockerCmd(c, "kill", cleanedContainerID) + + c.Assert(out1, checker.Contains, "top", check.Commentf("top should've listed `top` in the process list, but failed the first time")) + c.Assert(out2, checker.Contains, "top", check.Commentf("top should've listed `top` in the process list, but failed the second time")) +} + +func (s *DockerSuite) TestTopPrivileged(c *check.C) { + testRequires(c, DaemonIsLinux, NotUserNamespace) + out, _ := dockerCmd(c, "run", "--privileged", "-i", "-d", "busybox", "top") + cleanedContainerID := strings.TrimSpace(out) + + out1, _ := dockerCmd(c, "top", cleanedContainerID) + out2, _ := dockerCmd(c, "top", cleanedContainerID) + dockerCmd(c, "kill", cleanedContainerID) + + c.Assert(out1, checker.Contains, "top", check.Commentf("top should've listed `top` in the process list, but failed the first time")) + c.Assert(out2, checker.Contains, "top", check.Commentf("top should've listed `top` in the process list, but failed the second time")) +} diff --git a/integration-cli/docker_cli_v2_only.go b/integration-cli/docker_cli_v2_only.go new file mode 100644 index 0000000000..aa3d6a2278 --- /dev/null +++ b/integration-cli/docker_cli_v2_only.go @@ -0,0 +1,148 @@ +package main + +import ( + "fmt" + "io/ioutil" + "net/http" + "os" + + "github.com/go-check/check" +) + +func makefile(contents string) (string, func(), error) { + cleanup := func() { + + } + + f, err := ioutil.TempFile(".", "tmp") + if err != nil { + return "", cleanup, err + } + err = ioutil.WriteFile(f.Name(), []byte(contents), os.ModePerm) + if err != nil { + return "", cleanup, err + } + + cleanup = func() { + err := os.Remove(f.Name()) + if err != nil { + fmt.Println("Error removing tmpfile") + } + } + return f.Name(), cleanup, nil + +} + +// TestV2Only ensures that a daemon in v2-only mode does not +// attempt to contact any v1 registry endpoints. +func (s *DockerRegistrySuite) TestV2Only(c *check.C) { + reg, err := newTestRegistry(c) + if err != nil { + c.Fatal(err.Error()) + } + + reg.registerHandler("/v2/", func(w http.ResponseWriter, r *http.Request) { + w.WriteHeader(404) + }) + + reg.registerHandler("/v1/.*", func(w http.ResponseWriter, r *http.Request) { + c.Fatal("V1 registry contacted") + }) + + repoName := fmt.Sprintf("%s/busybox", reg.hostport) + + err = s.d.Start("--insecure-registry", reg.hostport, "--disable-legacy-registry=true") + if err != nil { + c.Fatalf("Error starting daemon: %s", err.Error()) + } + + dockerfileName, cleanup, err := makefile(fmt.Sprintf("FROM %s/busybox", reg.hostport)) + if err != nil { + c.Fatalf("Unable to create test dockerfile") + } + defer cleanup() + + s.d.Cmd("build", "--file", dockerfileName, ".") + + s.d.Cmd("run", repoName) + s.d.Cmd("login", "-u", "richard", "-p", "testtest", "-e", "testuser@testdomain.com", reg.hostport) + s.d.Cmd("tag", "busybox", repoName) + s.d.Cmd("push", repoName) + s.d.Cmd("pull", repoName) +} + +// TestV1 starts a daemon in 'normal' mode +// and ensure v1 endpoints are hit for the following operations: +// login, push, pull, build & run +func (s *DockerRegistrySuite) TestV1(c *check.C) { + reg, err := newTestRegistry(c) + if err != nil { + c.Fatal(err.Error()) + } + + v2Pings := 0 + reg.registerHandler("/v2/", func(w http.ResponseWriter, r *http.Request) { + v2Pings++ + // V2 ping 404 causes fallback to v1 + w.WriteHeader(404) + }) + + v1Pings := 0 + reg.registerHandler("/v1/_ping", func(w http.ResponseWriter, r *http.Request) { + v1Pings++ + }) + + v1Logins := 0 + reg.registerHandler("/v1/users/", func(w http.ResponseWriter, r *http.Request) { + v1Logins++ + }) + + v1Repo := 0 + reg.registerHandler("/v1/repositories/busybox/", func(w http.ResponseWriter, r *http.Request) { + v1Repo++ + }) + + reg.registerHandler("/v1/repositories/busybox/images", func(w http.ResponseWriter, r *http.Request) { + v1Repo++ + }) + + err = s.d.Start("--insecure-registry", reg.hostport, "--disable-legacy-registry=false") + if err != nil { + c.Fatalf("Error starting daemon: %s", err.Error()) + } + + dockerfileName, cleanup, err := makefile(fmt.Sprintf("FROM %s/busybox", reg.hostport)) + if err != nil { + c.Fatalf("Unable to create test dockerfile") + } + defer cleanup() + + s.d.Cmd("build", "--file", dockerfileName, ".") + if v1Repo == 0 { + c.Errorf("Expected v1 repository access after build") + } + + repoName := fmt.Sprintf("%s/busybox", reg.hostport) + s.d.Cmd("run", repoName) + if v1Repo == 1 { + c.Errorf("Expected v1 repository access after run") + } + + s.d.Cmd("login", "-u", "richard", "-p", "testtest", "-e", "testuser@testdomain.com", reg.hostport) + if v1Logins == 0 { + c.Errorf("Expected v1 login attempt") + } + + s.d.Cmd("tag", "busybox", repoName) + s.d.Cmd("push", repoName) + + if v1Repo != 2 || v1Pings != 1 { + c.Error("Not all endpoints contacted after push", v1Repo, v1Pings) + } + + s.d.Cmd("pull", repoName) + if v1Repo != 3 { + c.Errorf("Expected v1 repository access after pull") + } + +} diff --git a/integration-cli/docker_cli_version_test.go b/integration-cli/docker_cli_version_test.go new file mode 100644 index 0000000000..1d8fe120b6 --- /dev/null +++ b/integration-cli/docker_cli_version_test.go @@ -0,0 +1,63 @@ +package main + +import ( + "strings" + + "github.com/go-check/check" +) + +// ensure docker version works +func (s *DockerSuite) TestVersionEnsureSucceeds(c *check.C) { + out, _ := dockerCmd(c, "version") + stringsToCheck := map[string]int{ + "Client:": 1, + "Server:": 1, + " Version:": 2, + " API version:": 2, + " Go version:": 2, + " Git commit:": 2, + " OS/Arch:": 2, + " Built:": 2, + } + + for k, v := range stringsToCheck { + if strings.Count(out, k) != v { + c.Errorf("%v expected %d instances found %d", k, v, strings.Count(out, k)) + } + } +} + +// ensure the Windows daemon return the correct platform string +func (s *DockerSuite) TestVersionPlatform_w(c *check.C) { + testRequires(c, DaemonIsWindows) + testVersionPlatform(c, "windows/amd64") +} + +// ensure the Linux daemon return the correct platform string +func (s *DockerSuite) TestVersionPlatform_l(c *check.C) { + testRequires(c, DaemonIsLinux) + testVersionPlatform(c, "linux/amd64") +} + +func testVersionPlatform(c *check.C, platform string) { + out, _ := dockerCmd(c, "version") + expected := "OS/Arch: " + platform + + split := strings.Split(out, "\n") + if len(split) < 14 { // To avoid invalid indexing in loop below + c.Errorf("got %d lines from version", len(split)) + } + + // Verify the second 'OS/Arch' matches the platform. Experimental has + // more lines of output than 'regular' + bFound := false + for i := 14; i < len(split); i++ { + if strings.Contains(split[i], expected) { + bFound = true + break + } + } + if !bFound { + c.Errorf("Could not find server '%s' in '%s'", expected, out) + } +} diff --git a/integration-cli/docker_cli_volume_test.go b/integration-cli/docker_cli_volume_test.go new file mode 100644 index 0000000000..a0c70693d5 --- /dev/null +++ b/integration-cli/docker_cli_volume_test.go @@ -0,0 +1,161 @@ +package main + +import ( + "os/exec" + "strings" + + derr "github.com/docker/docker/errors" + "github.com/docker/docker/pkg/integration/checker" + "github.com/docker/docker/volume" + "github.com/go-check/check" +) + +func (s *DockerSuite) TestVolumeCliCreate(c *check.C) { + testRequires(c, DaemonIsLinux) + dockerCmd(c, "volume", "create") + + _, err := runCommand(exec.Command(dockerBinary, "volume", "create", "-d", "nosuchdriver")) + c.Assert(err, check.Not(check.IsNil)) + + out, _ := dockerCmd(c, "volume", "create", "--name=test") + name := strings.TrimSpace(out) + c.Assert(name, check.Equals, "test") +} + +func (s *DockerSuite) TestVolumeCliCreateOptionConflict(c *check.C) { + dockerCmd(c, "volume", "create", "--name=test") + out, _, err := dockerCmdWithError("volume", "create", "--name", "test", "--driver", "nosuchdriver") + c.Assert(err, check.NotNil, check.Commentf("volume create exception name already in use with another driver")) + stderr := derr.ErrorVolumeNameTaken.WithArgs("test", volume.DefaultDriverName).Error() + c.Assert(strings.Contains(out, strings.TrimPrefix(stderr, "volume name taken: ")), check.Equals, true) + + out, _ = dockerCmd(c, "volume", "inspect", "--format='{{ .Driver }}'", "test") + _, _, err = dockerCmdWithError("volume", "create", "--name", "test", "--driver", strings.TrimSpace(out)) + c.Assert(err, check.IsNil) +} + +func (s *DockerSuite) TestVolumeCliInspect(c *check.C) { + testRequires(c, DaemonIsLinux) + c.Assert( + exec.Command(dockerBinary, "volume", "inspect", "doesntexist").Run(), + check.Not(check.IsNil), + check.Commentf("volume inspect should error on non-existant volume"), + ) + + out, _ := dockerCmd(c, "volume", "create") + name := strings.TrimSpace(out) + out, _ = dockerCmd(c, "volume", "inspect", "--format='{{ .Name }}'", name) + c.Assert(strings.TrimSpace(out), check.Equals, name) + + dockerCmd(c, "volume", "create", "--name", "test") + out, _ = dockerCmd(c, "volume", "inspect", "--format='{{ .Name }}'", "test") + c.Assert(strings.TrimSpace(out), check.Equals, "test") +} + +func (s *DockerSuite) TestVolumeCliLs(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "volume", "create") + id := strings.TrimSpace(out) + + dockerCmd(c, "volume", "create", "--name", "test") + dockerCmd(c, "run", "-v", "/foo", "busybox", "ls", "/") + + out, _ = dockerCmd(c, "volume", "ls") + outArr := strings.Split(strings.TrimSpace(out), "\n") + c.Assert(len(outArr), check.Equals, 4, check.Commentf("\n%s", out)) + + // Since there is no guarentee of ordering of volumes, we just make sure the names are in the output + c.Assert(strings.Contains(out, id+"\n"), check.Equals, true) + c.Assert(strings.Contains(out, "test\n"), check.Equals, true) +} + +func (s *DockerSuite) TestVolumeCliLsFilterDangling(c *check.C) { + testRequires(c, DaemonIsLinux) + + dockerCmd(c, "volume", "create", "--name", "testnotinuse1") + dockerCmd(c, "volume", "create", "--name", "testisinuse1") + dockerCmd(c, "volume", "create", "--name", "testisinuse2") + + // Make sure both "created" (but not started), and started + // containers are included in reference counting + dockerCmd(c, "run", "--name", "volume-test1", "-v", "testisinuse1:/foo", "busybox", "true") + dockerCmd(c, "create", "--name", "volume-test2", "-v", "testisinuse2:/foo", "busybox", "true") + + out, _ := dockerCmd(c, "volume", "ls") + + // No filter, all volumes should show + c.Assert(out, checker.Contains, "testnotinuse1\n", check.Commentf("expected volume 'testnotinuse1' in output")) + c.Assert(out, checker.Contains, "testisinuse1\n", check.Commentf("expected volume 'testisinuse1' in output")) + c.Assert(out, checker.Contains, "testisinuse2\n", check.Commentf("expected volume 'testisinuse2' in output")) + + out, _ = dockerCmd(c, "volume", "ls", "--filter", "dangling=false") + + // Same as above, but expicitly disabling dangling + c.Assert(out, checker.Contains, "testnotinuse1\n", check.Commentf("expected volume 'testnotinuse1' in output")) + c.Assert(out, checker.Contains, "testisinuse1\n", check.Commentf("expected volume 'testisinuse1' in output")) + c.Assert(out, checker.Contains, "testisinuse2\n", check.Commentf("expected volume 'testisinuse2' in output")) + + out, _ = dockerCmd(c, "volume", "ls", "--filter", "dangling=true") + + // Filter "dangling" volumes; ony "dangling" (unused) volumes should be in the output + c.Assert(out, checker.Contains, "testnotinuse1\n", check.Commentf("expected volume 'testnotinuse1' in output")) + c.Assert(out, check.Not(checker.Contains), "testisinuse1\n", check.Commentf("volume 'testisinuse1' in output, but not expected")) + c.Assert(out, check.Not(checker.Contains), "testisinuse2\n", check.Commentf("volume 'testisinuse2' in output, but not expected")) +} + +func (s *DockerSuite) TestVolumeCliRm(c *check.C) { + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "volume", "create") + id := strings.TrimSpace(out) + + dockerCmd(c, "volume", "create", "--name", "test") + dockerCmd(c, "volume", "rm", id) + dockerCmd(c, "volume", "rm", "test") + + out, _ = dockerCmd(c, "volume", "ls") + outArr := strings.Split(strings.TrimSpace(out), "\n") + c.Assert(len(outArr), check.Equals, 1, check.Commentf("%s\n", out)) + + volumeID := "testing" + dockerCmd(c, "run", "-v", volumeID+":/foo", "--name=test", "busybox", "sh", "-c", "echo hello > /foo/bar") + out, _, err := runCommandWithOutput(exec.Command(dockerBinary, "volume", "rm", "testing")) + c.Assert( + err, + check.Not(check.IsNil), + check.Commentf("Should not be able to remove volume that is in use by a container\n%s", out)) + + out, _ = dockerCmd(c, "run", "--volumes-from=test", "--name=test2", "busybox", "sh", "-c", "cat /foo/bar") + c.Assert(strings.TrimSpace(out), check.Equals, "hello") + dockerCmd(c, "rm", "-fv", "test2") + dockerCmd(c, "volume", "inspect", volumeID) + dockerCmd(c, "rm", "-f", "test") + + out, _ = dockerCmd(c, "run", "--name=test2", "-v", volumeID+":/foo", "busybox", "sh", "-c", "cat /foo/bar") + c.Assert(strings.TrimSpace(out), check.Equals, "hello", check.Commentf("volume data was removed")) + dockerCmd(c, "rm", "test2") + + dockerCmd(c, "volume", "rm", volumeID) + c.Assert( + exec.Command("volume", "rm", "doesntexist").Run(), + check.Not(check.IsNil), + check.Commentf("volume rm should fail with non-existant volume"), + ) +} + +func (s *DockerSuite) TestVolumeCliNoArgs(c *check.C) { + out, _ := dockerCmd(c, "volume") + // no args should produce the cmd usage output + usage := "Usage: docker volume [OPTIONS] [COMMAND]" + c.Assert(out, checker.Contains, usage) + + // invalid arg should error and show the command usage on stderr + _, stderr, _, err := runCommandWithStdoutStderr(exec.Command(dockerBinary, "volume", "somearg")) + c.Assert(err, check.NotNil, check.Commentf(stderr)) + c.Assert(stderr, checker.Contains, usage) + + // invalid flag should error and show the flag error and cmd usage + _, stderr, _, err = runCommandWithStdoutStderr(exec.Command(dockerBinary, "volume", "--no-such-flag")) + c.Assert(err, check.NotNil, check.Commentf(stderr)) + c.Assert(stderr, checker.Contains, usage) + c.Assert(stderr, checker.Contains, "flag provided but not defined: --no-such-flag") +} diff --git a/integration-cli/docker_cli_wait_test.go b/integration-cli/docker_cli_wait_test.go new file mode 100644 index 0000000000..299339756f --- /dev/null +++ b/integration-cli/docker_cli_wait_test.go @@ -0,0 +1,95 @@ +package main + +import ( + "bytes" + "os/exec" + "strings" + "time" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +// non-blocking wait with 0 exit code +func (s *DockerSuite) TestWaitNonBlockedExitZero(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", "true") + containerID := strings.TrimSpace(out) + + err := waitInspect(containerID, "{{.State.Running}}", "false", 30*time.Second) + c.Assert(err, checker.IsNil) //Container should have stopped by now + + out, _ = dockerCmd(c, "wait", containerID) + c.Assert(strings.TrimSpace(out), checker.Equals, "0", check.Commentf("failed to set up container, %v", out)) + +} + +// blocking wait with 0 exit code +func (s *DockerSuite) TestWaitBlockedExitZero(c *check.C) { + // Windows busybox does not support trap in this way, not sleep with sub-second + // granularity. It will always exit 0x40010004. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "trap 'exit 0' TERM; while true; do usleep 10; done") + containerID := strings.TrimSpace(out) + + c.Assert(waitRun(containerID), checker.IsNil) + + chWait := make(chan string) + go func() { + out, _, _ := runCommandWithOutput(exec.Command(dockerBinary, "wait", containerID)) + chWait <- out + }() + + time.Sleep(100 * time.Millisecond) + dockerCmd(c, "stop", containerID) + + select { + case status := <-chWait: + c.Assert(strings.TrimSpace(status), checker.Equals, "0", check.Commentf("expected exit 0, got %s", status)) + case <-time.After(2 * time.Second): + c.Fatal("timeout waiting for `docker wait` to exit") + } + +} + +// non-blocking wait with random exit code +func (s *DockerSuite) TestWaitNonBlockedExitRandom(c *check.C) { + out, _ := dockerCmd(c, "run", "-d", "busybox", "sh", "-c", "exit 99") + containerID := strings.TrimSpace(out) + + err := waitInspect(containerID, "{{.State.Running}}", "false", 30*time.Second) + c.Assert(err, checker.IsNil) //Container should have stopped by now + out, _ = dockerCmd(c, "wait", containerID) + c.Assert(strings.TrimSpace(out), checker.Equals, "99", check.Commentf("failed to set up container, %v", out)) + +} + +// blocking wait with random exit code +func (s *DockerSuite) TestWaitBlockedExitRandom(c *check.C) { + // Cannot run on Windows as trap in Windows busybox does not support trap in this way. + testRequires(c, DaemonIsLinux) + out, _ := dockerCmd(c, "run", "-d", "busybox", "/bin/sh", "-c", "trap 'exit 99' TERM; while true; do usleep 10; done") + containerID := strings.TrimSpace(out) + c.Assert(waitRun(containerID), checker.IsNil) + + chWait := make(chan error) + waitCmd := exec.Command(dockerBinary, "wait", containerID) + waitCmdOut := bytes.NewBuffer(nil) + waitCmd.Stdout = waitCmdOut + c.Assert(waitCmd.Start(), checker.IsNil) + go func() { + chWait <- waitCmd.Wait() + }() + + dockerCmd(c, "stop", containerID) + + select { + case err := <-chWait: + c.Assert(err, checker.IsNil) + status, err := waitCmdOut.ReadString('\n') + c.Assert(err, checker.IsNil) + c.Assert(strings.TrimSpace(status), checker.Equals, "99", check.Commentf("expected exit 99, got %s", status)) + case <-time.After(2 * time.Second): + waitCmd.Process.Kill() + c.Fatal("timeout waiting for `docker wait` to exit") + } +} diff --git a/integration-cli/docker_hub_pull_suite_test.go b/integration-cli/docker_hub_pull_suite_test.go new file mode 100644 index 0000000000..6aa93469f3 --- /dev/null +++ b/integration-cli/docker_hub_pull_suite_test.go @@ -0,0 +1,90 @@ +package main + +import ( + "os/exec" + "runtime" + "strings" + + "github.com/docker/docker/pkg/integration/checker" + "github.com/go-check/check" +) + +func init() { + // FIXME. Temporarily turning this off for Windows as GH16039 was breaking + // Windows to Linux CI @icecrime + if runtime.GOOS != "windows" { + check.Suite(newDockerHubPullSuite()) + } +} + +// DockerHubPullSuite provides a isolated daemon that doesn't have all the +// images that are baked into our 'global' test environment daemon (e.g., +// busybox, httpserver, ...). +// +// We use it for push/pull tests where we want to start fresh, and measure the +// relative impact of each individual operation. As part of this suite, all +// images are removed after each test. +type DockerHubPullSuite struct { + d *Daemon + ds *DockerSuite +} + +// newDockerHubPullSuite returns a new instance of a DockerHubPullSuite. +func newDockerHubPullSuite() *DockerHubPullSuite { + return &DockerHubPullSuite{ + ds: &DockerSuite{}, + } +} + +// SetUpSuite starts the suite daemon. +func (s *DockerHubPullSuite) SetUpSuite(c *check.C) { + testRequires(c, DaemonIsLinux) + s.d = NewDaemon(c) + err := s.d.Start() + c.Assert(err, checker.IsNil, check.Commentf("starting push/pull test daemon: %v", err)) +} + +// TearDownSuite stops the suite daemon. +func (s *DockerHubPullSuite) TearDownSuite(c *check.C) { + if s.d != nil { + err := s.d.Stop() + c.Assert(err, checker.IsNil, check.Commentf("stopping push/pull test daemon: %v", err)) + } +} + +// SetUpTest declares that all tests of this suite require network. +func (s *DockerHubPullSuite) SetUpTest(c *check.C) { + testRequires(c, Network) +} + +// TearDownTest removes all images from the suite daemon. +func (s *DockerHubPullSuite) TearDownTest(c *check.C) { + out := s.Cmd(c, "images", "-aq") + images := strings.Split(out, "\n") + images = append([]string{"-f"}, images...) + s.d.Cmd("rmi", images...) + s.ds.TearDownTest(c) +} + +// Cmd executes a command against the suite daemon and returns the combined +// output. The function fails the test when the command returns an error. +func (s *DockerHubPullSuite) Cmd(c *check.C, name string, arg ...string) string { + out, err := s.CmdWithError(name, arg...) + c.Assert(err, checker.IsNil, check.Commentf("%q failed with errors: %s, %v", strings.Join(arg, " "), out, err)) + return out +} + +// CmdWithError executes a command against the suite daemon and returns the +// combined output as well as any error. +func (s *DockerHubPullSuite) CmdWithError(name string, arg ...string) (string, error) { + c := s.MakeCmd(name, arg...) + b, err := c.CombinedOutput() + return string(b), err +} + +// MakeCmd returns a exec.Cmd command to run against the suite daemon. +func (s *DockerHubPullSuite) MakeCmd(name string, arg ...string) *exec.Cmd { + args := []string{"--host", s.d.sock(), name} + args = append(args, arg...) + return exec.Command(dockerBinary, args...) +} diff --git a/integration-cli/docker_test_vars.go b/integration-cli/docker_test_vars.go new file mode 100644 index 0000000000..38d3fdff93 --- /dev/null +++ b/integration-cli/docker_test_vars.go @@ -0,0 +1,115 @@ +package main + +import ( + "encoding/json" + "fmt" + "os" + "os/exec" + + "github.com/docker/docker/pkg/reexec" +) + +var ( + // the docker binary to use + dockerBinary = "docker" + + // the private registry image to use for tests involving the registry + registryImageName = "registry" + + // the private registry to use for tests + privateRegistryURL = "127.0.0.1:5000" + + runtimePath = "/var/run/docker" + execDriverPath = runtimePath + "/execdriver/native" + + runtimePath = "/var/run/docker" + execDriverPath = runtimePath + "/execdriver/native" + + workingDirectory string + + // isLocalDaemon is true if the daemon under test is on the same + // host as the CLI. + isLocalDaemon bool + + // daemonPlatform is held globally so that tests can make intelligent + // decisions on how to configure themselves according to the platform + // of the daemon. This is initialised in docker_utils by sending + // a version call to the daemon and examining the response header. + daemonPlatform string + + // daemonDefaultImage is the name of the default image to use when running + // tests. This is platform dependent. + daemonDefaultImage string + + // For a local daemon on Linux, these values will be used for testing + // user namespace support as the standard graph path(s) will be + // appended with the root remapped uid.gid prefix + dockerBasePath string + volumesConfigPath string + containerStoragePath string +) + +const ( + // WindowsBaseImage is the name of the base image for Windows testing + WindowsBaseImage = "windowsservercore" + + // DefaultImage is the name of the base image for the majority of tests that + // are run across suites + DefaultImage = "busybox" +) + +func init() { + reexec.Init() + if dockerBin := os.Getenv("DOCKER_BINARY"); dockerBin != "" { + dockerBinary = dockerBin + } + var err error + dockerBinary, err = exec.LookPath(dockerBinary) + if err != nil { + fmt.Printf("ERROR: couldn't resolve full path to the Docker binary (%v)", err) + os.Exit(1) + } + if registryImage := os.Getenv("REGISTRY_IMAGE"); registryImage != "" { + registryImageName = registryImage + } + if registry := os.Getenv("REGISTRY_URL"); registry != "" { + privateRegistryURL = registry + } + workingDirectory, _ = os.Getwd() + + // Deterministically working out the environment in which CI is running + // to evaluate whether the daemon is local or remote is not possible through + // a build tag. + // + // For example Windows CI under Jenkins test the 64-bit + // Windows binary build with the daemon build tag, but calls a remote + // Linux daemon. + // + // We can't just say if Windows then assume the daemon is local as at + // some point, we will be testing the Windows CLI against a Windows daemon. + // + // Similarly, it will be perfectly valid to also run CLI tests from + // a Linux CLI (built with the daemon tag) against a Windows daemon. + if len(os.Getenv("DOCKER_REMOTE_DAEMON")) > 0 { + isLocalDaemon = false + } else { + isLocalDaemon = true + } + + // This is only used for a tests with local daemon true (Linux-only today) + // default is "/var/lib/docker", but we'll try and ask the + // /info endpoint for the specific root dir + dockerBasePath = "/var/lib/docker" + type Info struct { + DockerRootDir string + } + var i Info + status, b, err := sockRequest("GET", "/info", nil) + if err == nil && status == 200 { + if err = json.Unmarshal(b, &i); err == nil { + dockerBasePath = i.DockerRootDir + } + } + volumesConfigPath = dockerBasePath + "/volumes" + containerStoragePath = dockerBasePath + "/containers" +} diff --git a/integration-cli/docker_utils.go b/integration-cli/docker_utils.go new file mode 100644 index 0000000000..8ec2d8112a --- /dev/null +++ b/integration-cli/docker_utils.go @@ -0,0 +1,1614 @@ +package main + +import ( + "bufio" + "bytes" + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "net" + "net/http" + "net/http/httptest" + "net/http/httputil" + "net/url" + "os" + "os/exec" + "path" + "path/filepath" + "strconv" + "strings" + "time" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/opts" + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/integration" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/sockets" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/tlsconfig" + "github.com/go-check/check" +) + +// Daemon represents a Docker daemon for the testing framework. +type Daemon struct { + // Defaults to "daemon" + // Useful to set to --daemon or -d for checking backwards compatibility + Command string + GlobalFlags []string + + id string + c *check.C + logFile *os.File + folder string + root string + stdin io.WriteCloser + stdout, stderr io.ReadCloser + cmd *exec.Cmd + storageDriver string + execDriver string + wait chan error + userlandProxy bool + useDefaultHost bool + useDefaultTLSHost bool +} + +type clientConfig struct { + transport *http.Transport + scheme string + addr string +} + +// NewDaemon returns a Daemon instance to be used for testing. +// This will create a directory such as d123456789 in the folder specified by $DEST. +// The daemon will not automatically start. +func NewDaemon(c *check.C) *Daemon { + dest := os.Getenv("DEST") + if dest == "" { + c.Fatal("Please set the DEST environment variable") + } + + id := fmt.Sprintf("d%d", time.Now().UnixNano()%100000000) + dir := filepath.Join(dest, id) + daemonFolder, err := filepath.Abs(dir) + if err != nil { + c.Fatalf("Could not make %q an absolute path: %v", dir, err) + } + daemonRoot := filepath.Join(daemonFolder, "root") + + if err := os.MkdirAll(daemonRoot, 0755); err != nil { + c.Fatalf("Could not create daemon root %q: %v", dir, err) + } + + userlandProxy := true + if env := os.Getenv("DOCKER_USERLANDPROXY"); env != "" { + if val, err := strconv.ParseBool(env); err != nil { + userlandProxy = val + } + } + + return &Daemon{ + Command: "daemon", + id: id, + c: c, + folder: daemonFolder, + root: daemonRoot, + storageDriver: os.Getenv("DOCKER_GRAPHDRIVER"), + execDriver: os.Getenv("DOCKER_EXECDRIVER"), + userlandProxy: userlandProxy, + } +} + +func (d *Daemon) getClientConfig() (*clientConfig, error) { + var ( + transport *http.Transport + scheme string + addr string + proto string + ) + if d.useDefaultTLSHost { + option := &tlsconfig.Options{ + CAFile: "fixtures/https/ca.pem", + CertFile: "fixtures/https/client-cert.pem", + KeyFile: "fixtures/https/client-key.pem", + } + tlsConfig, err := tlsconfig.Client(*option) + if err != nil { + return nil, err + } + transport = &http.Transport{ + TLSClientConfig: tlsConfig, + } + addr = fmt.Sprintf("%s:%d", opts.DefaultHTTPHost, opts.DefaultTLSHTTPPort) + scheme = "https" + proto = "tcp" + } else if d.useDefaultHost { + addr = opts.DefaultUnixSocket + proto = "unix" + scheme = "http" + transport = &http.Transport{} + } else { + addr = filepath.Join(d.folder, "docker.sock") + proto = "unix" + scheme = "http" + transport = &http.Transport{} + } + + sockets.ConfigureTCPTransport(transport, proto, addr) + + return &clientConfig{ + transport: transport, + scheme: scheme, + addr: addr, + }, nil +} + +// Start will start the daemon and return once it is ready to receive requests. +// You can specify additional daemon flags. +func (d *Daemon) Start(arg ...string) error { + dockerBinary, err := exec.LookPath(dockerBinary) + if err != nil { + d.c.Fatalf("[%s] could not find docker binary in $PATH: %v", d.id, err) + } + + args := append(d.GlobalFlags, + d.Command, + "--graph", d.root, + "--pidfile", fmt.Sprintf("%s/docker.pid", d.folder), + fmt.Sprintf("--userland-proxy=%t", d.userlandProxy), + ) + if !(d.useDefaultHost || d.useDefaultTLSHost) { + args = append(args, []string{"--host", d.sock()}...) + } + if root := os.Getenv("DOCKER_REMAP_ROOT"); root != "" { + args = append(args, []string{"--userns-remap", root}...) + } + + // If we don't explicitly set the log-level or debug flag(-D) then + // turn on debug mode + foundIt := false + for _, a := range arg { + if strings.Contains(a, "--log-level") || strings.Contains(a, "-D") || strings.Contains(a, "--debug") { + foundIt = true + } + } + if !foundIt { + args = append(args, "--debug") + } + + if d.storageDriver != "" { + args = append(args, "--storage-driver", d.storageDriver) + } + if d.execDriver != "" { + args = append(args, "--exec-driver", d.execDriver) + } + + args = append(args, arg...) + d.cmd = exec.Command(dockerBinary, args...) + + d.logFile, err = os.OpenFile(filepath.Join(d.folder, "docker.log"), os.O_RDWR|os.O_CREATE|os.O_APPEND, 0600) + if err != nil { + d.c.Fatalf("[%s] Could not create %s/docker.log: %v", d.id, d.folder, err) + } + + d.cmd.Stdout = d.logFile + d.cmd.Stderr = d.logFile + + if err := d.cmd.Start(); err != nil { + return fmt.Errorf("[%s] could not start daemon container: %v", d.id, err) + } + + wait := make(chan error) + + go func() { + wait <- d.cmd.Wait() + d.c.Logf("[%s] exiting daemon", d.id) + close(wait) + }() + + d.wait = wait + + tick := time.Tick(500 * time.Millisecond) + // make sure daemon is ready to receive requests + startTime := time.Now().Unix() + for { + d.c.Logf("[%s] waiting for daemon to start", d.id) + if time.Now().Unix()-startTime > 5 { + // After 5 seconds, give up + return fmt.Errorf("[%s] Daemon exited and never started", d.id) + } + select { + case <-time.After(2 * time.Second): + return fmt.Errorf("[%s] timeout: daemon does not respond", d.id) + case <-tick: + clientConfig, err := d.getClientConfig() + if err != nil { + return err + } + + client := &http.Client{ + Transport: clientConfig.transport, + } + + req, err := http.NewRequest("GET", "/_ping", nil) + if err != nil { + d.c.Fatalf("[%s] could not create new request: %v", d.id, err) + } + req.URL.Host = clientConfig.addr + req.URL.Scheme = clientConfig.scheme + resp, err := client.Do(req) + if err != nil { + continue + } + if resp.StatusCode != http.StatusOK { + d.c.Logf("[%s] received status != 200 OK: %s", d.id, resp.Status) + } + d.c.Logf("[%s] daemon started", d.id) + d.root, err = d.queryRootDir() + if err != nil { + return fmt.Errorf("[%s] error querying daemon for root directory: %v", d.id, err) + } + return nil + } + } +} + +// StartWithBusybox will first start the daemon with Daemon.Start() +// then save the busybox image from the main daemon and load it into this Daemon instance. +func (d *Daemon) StartWithBusybox(arg ...string) error { + if err := d.Start(arg...); err != nil { + return err + } + bb := filepath.Join(d.folder, "busybox.tar") + if _, err := os.Stat(bb); err != nil { + if !os.IsNotExist(err) { + return fmt.Errorf("unexpected error on busybox.tar stat: %v", err) + } + // saving busybox image from main daemon + if err := exec.Command(dockerBinary, "save", "--output", bb, "busybox:latest").Run(); err != nil { + return fmt.Errorf("could not save busybox image: %v", err) + } + } + // loading busybox image to this daemon + if _, err := d.Cmd("load", "--input", bb); err != nil { + return fmt.Errorf("could not load busybox image: %v", err) + } + if err := os.Remove(bb); err != nil { + d.c.Logf("Could not remove %s: %v", bb, err) + } + return nil +} + +// Stop will send a SIGINT every second and wait for the daemon to stop. +// If it timeouts, a SIGKILL is sent. +// Stop will not delete the daemon directory. If a purged daemon is needed, +// instantiate a new one with NewDaemon. +func (d *Daemon) Stop() error { + if d.cmd == nil || d.wait == nil { + return errors.New("daemon not started") + } + + defer func() { + d.logFile.Close() + d.cmd = nil + }() + + i := 1 + tick := time.Tick(time.Second) + + if err := d.cmd.Process.Signal(os.Interrupt); err != nil { + return fmt.Errorf("could not send signal: %v", err) + } +out1: + for { + select { + case err := <-d.wait: + return err + case <-time.After(15 * time.Second): + // time for stopping jobs and run onShutdown hooks + d.c.Log("timeout") + break out1 + } + } + +out2: + for { + select { + case err := <-d.wait: + return err + case <-tick: + i++ + if i > 4 { + d.c.Logf("tried to interrupt daemon for %d times, now try to kill it", i) + break out2 + } + d.c.Logf("Attempt #%d: daemon is still running with pid %d", i, d.cmd.Process.Pid) + if err := d.cmd.Process.Signal(os.Interrupt); err != nil { + return fmt.Errorf("could not send signal: %v", err) + } + } + } + + if err := d.cmd.Process.Kill(); err != nil { + d.c.Logf("Could not kill daemon: %v", err) + return err + } + + return nil +} + +// Restart will restart the daemon by first stopping it and then starting it. +func (d *Daemon) Restart(arg ...string) error { + d.Stop() + return d.Start(arg...) +} + +func (d *Daemon) queryRootDir() (string, error) { + // update daemon root by asking /info endpoint (to support user + // namespaced daemon with root remapped uid.gid directory) + clientConfig, err := d.getClientConfig() + if err != nil { + return "", err + } + + client := &http.Client{ + Transport: clientConfig.transport, + } + + req, err := http.NewRequest("GET", "/info", nil) + if err != nil { + return "", err + } + req.Header.Set("Content-Type", "application/json") + req.URL.Host = clientConfig.addr + req.URL.Scheme = clientConfig.scheme + + resp, err := client.Do(req) + if err != nil { + return "", err + } + body := ioutils.NewReadCloserWrapper(resp.Body, func() error { + return resp.Body.Close() + }) + + type Info struct { + DockerRootDir string + } + var b []byte + var i Info + b, err = readBody(body) + if err == nil && resp.StatusCode == 200 { + // read the docker root dir + if err = json.Unmarshal(b, &i); err == nil { + return i.DockerRootDir, nil + } + } + return "", err +} + +func (d *Daemon) sock() string { + return fmt.Sprintf("unix://%s/docker.sock", d.folder) +} + +// Cmd will execute a docker CLI command against this Daemon. +// Example: d.Cmd("version") will run docker -H unix://path/to/unix.sock version +func (d *Daemon) Cmd(name string, arg ...string) (string, error) { + args := []string{"--host", d.sock(), name} + args = append(args, arg...) + c := exec.Command(dockerBinary, args...) + b, err := c.CombinedOutput() + return string(b), err +} + +// CmdWithArgs will execute a docker CLI command against a daemon with the +// given additional arguments +func (d *Daemon) CmdWithArgs(daemonArgs []string, name string, arg ...string) (string, error) { + args := append(daemonArgs, name) + args = append(args, arg...) + c := exec.Command(dockerBinary, args...) + b, err := c.CombinedOutput() + return string(b), err +} + +// LogfileName returns the path the the daemon's log file +func (d *Daemon) LogfileName() string { + return d.logFile.Name() +} + +func daemonHost() string { + daemonURLStr := "unix://" + opts.DefaultUnixSocket + if daemonHostVar := os.Getenv("DOCKER_HOST"); daemonHostVar != "" { + daemonURLStr = daemonHostVar + } + return daemonURLStr +} + +func sockConn(timeout time.Duration) (net.Conn, error) { + daemon := daemonHost() + daemonURL, err := url.Parse(daemon) + if err != nil { + return nil, fmt.Errorf("could not parse url %q: %v", daemon, err) + } + + var c net.Conn + switch daemonURL.Scheme { + case "unix": + return net.DialTimeout(daemonURL.Scheme, daemonURL.Path, timeout) + case "tcp": + return net.DialTimeout(daemonURL.Scheme, daemonURL.Host, timeout) + default: + return c, fmt.Errorf("unknown scheme %v (%s)", daemonURL.Scheme, daemon) + } +} + +func sockRequest(method, endpoint string, data interface{}) (int, []byte, error) { + jsonData := bytes.NewBuffer(nil) + if err := json.NewEncoder(jsonData).Encode(data); err != nil { + return -1, nil, err + } + + res, body, err := sockRequestRaw(method, endpoint, jsonData, "application/json") + if err != nil { + return -1, nil, err + } + b, err := readBody(body) + return res.StatusCode, b, err +} + +func sockRequestRaw(method, endpoint string, data io.Reader, ct string) (*http.Response, io.ReadCloser, error) { + req, client, err := newRequestClient(method, endpoint, data, ct) + if err != nil { + return nil, nil, err + } + + resp, err := client.Do(req) + if err != nil { + client.Close() + return nil, nil, err + } + body := ioutils.NewReadCloserWrapper(resp.Body, func() error { + defer resp.Body.Close() + return client.Close() + }) + + return resp, body, nil +} + +func sockRequestHijack(method, endpoint string, data io.Reader, ct string) (net.Conn, *bufio.Reader, error) { + req, client, err := newRequestClient(method, endpoint, data, ct) + if err != nil { + return nil, nil, err + } + + client.Do(req) + conn, br := client.Hijack() + return conn, br, nil +} + +func newRequestClient(method, endpoint string, data io.Reader, ct string) (*http.Request, *httputil.ClientConn, error) { + c, err := sockConn(time.Duration(10 * time.Second)) + if err != nil { + return nil, nil, fmt.Errorf("could not dial docker daemon: %v", err) + } + + client := httputil.NewClientConn(c, nil) + + req, err := http.NewRequest(method, endpoint, data) + if err != nil { + client.Close() + return nil, nil, fmt.Errorf("could not create new request: %v", err) + } + + if ct != "" { + req.Header.Set("Content-Type", ct) + } + return req, client, nil +} + +func readBody(b io.ReadCloser) ([]byte, error) { + defer b.Close() + return ioutil.ReadAll(b) +} + +func deleteContainer(container string) error { + container = strings.TrimSpace(strings.Replace(container, "\n", " ", -1)) + rmArgs := strings.Split(fmt.Sprintf("rm -fv %v", container), " ") + exitCode, err := runCommand(exec.Command(dockerBinary, rmArgs...)) + // set error manually if not set + if exitCode != 0 && err == nil { + err = fmt.Errorf("failed to remove container: `docker rm` exit is non-zero") + } + + return err +} + +func getAllContainers() (string, error) { + getContainersCmd := exec.Command(dockerBinary, "ps", "-q", "-a") + out, exitCode, err := runCommandWithOutput(getContainersCmd) + if exitCode != 0 && err == nil { + err = fmt.Errorf("failed to get a list of containers: %v\n", out) + } + + return out, err +} + +func deleteAllContainers() error { + containers, err := getAllContainers() + if err != nil { + fmt.Println(containers) + return err + } + + if err = deleteContainer(containers); err != nil { + return err + } + return nil +} + +func deleteAllNetworks() error { + networks, err := getAllNetworks() + if err != nil { + return err + } + var errors []string + for _, n := range networks { + if n.Name != "bridge" { + status, b, err := sockRequest("DELETE", "/networks/"+n.Name, nil) + if err != nil { + errors = append(errors, err.Error()) + continue + } + if status != http.StatusNoContent { + errors = append(errors, fmt.Sprintf("error deleting network %s: %s", n.Name, string(b))) + } + } + } + if len(errors) > 0 { + return fmt.Errorf(strings.Join(errors, "\n")) + } + return nil +} + +func getAllNetworks() ([]types.NetworkResource, error) { + var networks []types.NetworkResource + _, b, err := sockRequest("GET", "/networks", nil) + if err != nil { + return nil, err + } + if err := json.Unmarshal(b, &networks); err != nil { + return nil, err + } + return networks, nil +} + +func deleteAllVolumes() error { + volumes, err := getAllVolumes() + if err != nil { + return err + } + var errors []string + for _, v := range volumes { + status, b, err := sockRequest("DELETE", "/volumes/"+v.Name, nil) + if err != nil { + errors = append(errors, err.Error()) + continue + } + if status != http.StatusNoContent { + errors = append(errors, fmt.Sprintf("error deleting volume %s: %s", v.Name, string(b))) + } + } + if len(errors) > 0 { + return fmt.Errorf(strings.Join(errors, "\n")) + } + return nil +} + +func getAllVolumes() ([]*types.Volume, error) { + var volumes types.VolumesListResponse + _, b, err := sockRequest("GET", "/volumes", nil) + if err != nil { + return nil, err + } + if err := json.Unmarshal(b, &volumes); err != nil { + return nil, err + } + return volumes.Volumes, nil +} + +var protectedImages = map[string]struct{}{} + +func init() { + out, err := exec.Command(dockerBinary, "images").CombinedOutput() + if err != nil { + panic(err) + } + lines := strings.Split(string(out), "\n")[1:] + for _, l := range lines { + if l == "" { + continue + } + fields := strings.Fields(l) + imgTag := fields[0] + ":" + fields[1] + // just for case if we have dangling images in tested daemon + if imgTag != ":" { + protectedImages[imgTag] = struct{}{} + } + } + + // Obtain the daemon platform so that it can be used by tests to make + // intelligent decisions about how to configure themselves, and validate + // that the target platform is valid. + res, _, err := sockRequestRaw("GET", "/version", nil, "application/json") + if err != nil || res == nil || (res != nil && res.StatusCode != http.StatusOK) { + panic(fmt.Errorf("Init failed to get version: %v. Res=%v", err.Error(), res)) + } + svrHeader, _ := httputils.ParseServerHeader(res.Header.Get("Server")) + daemonPlatform = svrHeader.OS + if daemonPlatform != "linux" && daemonPlatform != "windows" { + panic("Cannot run tests against platform: " + daemonPlatform) + } +} + +func deleteAllImages() error { + out, err := exec.Command(dockerBinary, "images").CombinedOutput() + if err != nil { + return err + } + lines := strings.Split(string(out), "\n")[1:] + var imgs []string + for _, l := range lines { + if l == "" { + continue + } + fields := strings.Fields(l) + imgTag := fields[0] + ":" + fields[1] + if _, ok := protectedImages[imgTag]; !ok { + if fields[0] == "" { + imgs = append(imgs, fields[2]) + continue + } + imgs = append(imgs, imgTag) + } + } + if len(imgs) == 0 { + return nil + } + args := append([]string{"rmi", "-f"}, imgs...) + if err := exec.Command(dockerBinary, args...).Run(); err != nil { + return err + } + return nil +} + +func getPausedContainers() (string, error) { + getPausedContainersCmd := exec.Command(dockerBinary, "ps", "-f", "status=paused", "-q", "-a") + out, exitCode, err := runCommandWithOutput(getPausedContainersCmd) + if exitCode != 0 && err == nil { + err = fmt.Errorf("failed to get a list of paused containers: %v\n", out) + } + + return out, err +} + +func getSliceOfPausedContainers() ([]string, error) { + out, err := getPausedContainers() + if err == nil { + if len(out) == 0 { + return nil, err + } + slice := strings.Split(strings.TrimSpace(out), "\n") + return slice, err + } + return []string{out}, err +} + +func unpauseContainer(container string) error { + unpauseCmd := exec.Command(dockerBinary, "unpause", container) + exitCode, err := runCommand(unpauseCmd) + if exitCode != 0 && err == nil { + err = fmt.Errorf("failed to unpause container") + } + + return nil +} + +func unpauseAllContainers() error { + containers, err := getPausedContainers() + if err != nil { + fmt.Println(containers) + return err + } + + containers = strings.Replace(containers, "\n", " ", -1) + containers = strings.Trim(containers, " ") + containerList := strings.Split(containers, " ") + + for _, value := range containerList { + if err = unpauseContainer(value); err != nil { + return err + } + } + + return nil +} + +func deleteImages(images ...string) error { + args := []string{"rmi", "-f"} + args = append(args, images...) + rmiCmd := exec.Command(dockerBinary, args...) + exitCode, err := runCommand(rmiCmd) + // set error manually if not set + if exitCode != 0 && err == nil { + err = fmt.Errorf("failed to remove image: `docker rmi` exit is non-zero") + } + return err +} + +func imageExists(image string) error { + inspectCmd := exec.Command(dockerBinary, "inspect", image) + exitCode, err := runCommand(inspectCmd) + if exitCode != 0 && err == nil { + err = fmt.Errorf("couldn't find image %q", image) + } + return err +} + +func pullImageIfNotExist(image string) error { + if err := imageExists(image); err != nil { + pullCmd := exec.Command(dockerBinary, "pull", image) + _, exitCode, err := runCommandWithOutput(pullCmd) + + if err != nil || exitCode != 0 { + return fmt.Errorf("image %q wasn't found locally and it couldn't be pulled: %s", image, err) + } + } + return nil +} + +func dockerCmdWithError(args ...string) (string, int, error) { + return integration.DockerCmdWithError(dockerBinary, args...) +} + +func dockerCmdWithStdoutStderr(c *check.C, args ...string) (string, string, int) { + return integration.DockerCmdWithStdoutStderr(dockerBinary, c, args...) +} + +func dockerCmd(c *check.C, args ...string) (string, int) { + return integration.DockerCmd(dockerBinary, c, args...) +} + +// execute a docker command with a timeout +func dockerCmdWithTimeout(timeout time.Duration, args ...string) (string, int, error) { + return integration.DockerCmdWithTimeout(dockerBinary, timeout, args...) +} + +// execute a docker command in a directory +func dockerCmdInDir(c *check.C, path string, args ...string) (string, int, error) { + return integration.DockerCmdInDir(dockerBinary, path, args...) +} + +// execute a docker command in a directory with a timeout +func dockerCmdInDirWithTimeout(timeout time.Duration, path string, args ...string) (string, int, error) { + return integration.DockerCmdInDirWithTimeout(dockerBinary, timeout, path, args...) +} + +func findContainerIP(c *check.C, id string, network string) string { + out, _ := dockerCmd(c, "inspect", fmt.Sprintf("--format='{{ .NetworkSettings.Networks.%s.IPAddress }}'", network), id) + return strings.Trim(out, " \r\n'") +} + +func (d *Daemon) findContainerIP(id string) string { + out, err := d.Cmd("inspect", fmt.Sprintf("--format='{{ .NetworkSettings.Networks.bridge.IPAddress }}'"), id) + if err != nil { + d.c.Log(err) + } + return strings.Trim(out, " \r\n'") +} + +func getContainerCount() (int, error) { + const containers = "Containers:" + + cmd := exec.Command(dockerBinary, "info") + out, _, err := runCommandWithOutput(cmd) + if err != nil { + return 0, err + } + + lines := strings.Split(out, "\n") + for _, line := range lines { + if strings.Contains(line, containers) { + output := strings.TrimSpace(line) + output = strings.TrimLeft(output, containers) + output = strings.Trim(output, " ") + containerCount, err := strconv.Atoi(output) + if err != nil { + return 0, err + } + return containerCount, nil + } + } + return 0, fmt.Errorf("couldn't find the Container count in the output") +} + +// FakeContext creates directories that can be used as a build context +type FakeContext struct { + Dir string +} + +// Add a file at a path, creating directories where necessary +func (f *FakeContext) Add(file, content string) error { + return f.addFile(file, []byte(content)) +} + +func (f *FakeContext) addFile(file string, content []byte) error { + filepath := path.Join(f.Dir, file) + dirpath := path.Dir(filepath) + if dirpath != "." { + if err := os.MkdirAll(dirpath, 0755); err != nil { + return err + } + } + return ioutil.WriteFile(filepath, content, 0644) + +} + +// Delete a file at a path +func (f *FakeContext) Delete(file string) error { + filepath := path.Join(f.Dir, file) + return os.RemoveAll(filepath) +} + +// Close deletes the context +func (f *FakeContext) Close() error { + return os.RemoveAll(f.Dir) +} + +func fakeContextFromNewTempDir() (*FakeContext, error) { + tmp, err := ioutil.TempDir("", "fake-context") + if err != nil { + return nil, err + } + if err := os.Chmod(tmp, 0755); err != nil { + return nil, err + } + return fakeContextFromDir(tmp), nil +} + +func fakeContextFromDir(dir string) *FakeContext { + return &FakeContext{dir} +} + +func fakeContextWithFiles(files map[string]string) (*FakeContext, error) { + ctx, err := fakeContextFromNewTempDir() + if err != nil { + return nil, err + } + for file, content := range files { + if err := ctx.Add(file, content); err != nil { + ctx.Close() + return nil, err + } + } + return ctx, nil +} + +func fakeContextAddDockerfile(ctx *FakeContext, dockerfile string) error { + if err := ctx.Add("Dockerfile", dockerfile); err != nil { + ctx.Close() + return err + } + return nil +} + +func fakeContext(dockerfile string, files map[string]string) (*FakeContext, error) { + ctx, err := fakeContextWithFiles(files) + if err != nil { + return nil, err + } + if err := fakeContextAddDockerfile(ctx, dockerfile); err != nil { + return nil, err + } + return ctx, nil +} + +// FakeStorage is a static file server. It might be running locally or remotely +// on test host. +type FakeStorage interface { + Close() error + URL() string + CtxDir() string +} + +func fakeBinaryStorage(archives map[string]*bytes.Buffer) (FakeStorage, error) { + ctx, err := fakeContextFromNewTempDir() + if err != nil { + return nil, err + } + for name, content := range archives { + if err := ctx.addFile(name, content.Bytes()); err != nil { + return nil, err + } + } + return fakeStorageWithContext(ctx) +} + +// fakeStorage returns either a local or remote (at daemon machine) file server +func fakeStorage(files map[string]string) (FakeStorage, error) { + ctx, err := fakeContextWithFiles(files) + if err != nil { + return nil, err + } + return fakeStorageWithContext(ctx) +} + +// fakeStorageWithContext returns either a local or remote (at daemon machine) file server +func fakeStorageWithContext(ctx *FakeContext) (FakeStorage, error) { + if isLocalDaemon { + return newLocalFakeStorage(ctx) + } + return newRemoteFileServer(ctx) +} + +// localFileStorage is a file storage on the running machine +type localFileStorage struct { + *FakeContext + *httptest.Server +} + +func (s *localFileStorage) URL() string { + return s.Server.URL +} + +func (s *localFileStorage) CtxDir() string { + return s.FakeContext.Dir +} + +func (s *localFileStorage) Close() error { + defer s.Server.Close() + return s.FakeContext.Close() +} + +func newLocalFakeStorage(ctx *FakeContext) (*localFileStorage, error) { + handler := http.FileServer(http.Dir(ctx.Dir)) + server := httptest.NewServer(handler) + return &localFileStorage{ + FakeContext: ctx, + Server: server, + }, nil +} + +// remoteFileServer is a containerized static file server started on the remote +// testing machine to be used in URL-accepting docker build functionality. +type remoteFileServer struct { + host string // hostname/port web server is listening to on docker host e.g. 0.0.0.0:43712 + container string + image string + ctx *FakeContext +} + +func (f *remoteFileServer) URL() string { + u := url.URL{ + Scheme: "http", + Host: f.host} + return u.String() +} + +func (f *remoteFileServer) CtxDir() string { + return f.ctx.Dir +} + +func (f *remoteFileServer) Close() error { + defer func() { + if f.ctx != nil { + f.ctx.Close() + } + if f.image != "" { + deleteImages(f.image) + } + }() + if f.container == "" { + return nil + } + return deleteContainer(f.container) +} + +func newRemoteFileServer(ctx *FakeContext) (*remoteFileServer, error) { + var ( + image = fmt.Sprintf("fileserver-img-%s", strings.ToLower(stringutils.GenerateRandomAlphaOnlyString(10))) + container = fmt.Sprintf("fileserver-cnt-%s", strings.ToLower(stringutils.GenerateRandomAlphaOnlyString(10))) + ) + + // Build the image + if err := fakeContextAddDockerfile(ctx, `FROM httpserver +COPY . /static`); err != nil { + return nil, fmt.Errorf("Cannot add Dockerfile to context: %v", err) + } + if _, err := buildImageFromContext(image, ctx, false); err != nil { + return nil, fmt.Errorf("failed building file storage container image: %v", err) + } + + // Start the container + runCmd := exec.Command(dockerBinary, "run", "-d", "-P", "--name", container, image) + if out, ec, err := runCommandWithOutput(runCmd); err != nil { + return nil, fmt.Errorf("failed to start file storage container. ec=%v\nout=%s\nerr=%v", ec, out, err) + } + + // Find out the system assigned port + out, _, err := runCommandWithOutput(exec.Command(dockerBinary, "port", container, "80/tcp")) + if err != nil { + return nil, fmt.Errorf("failed to find container port: err=%v\nout=%s", err, out) + } + + fileserverHostPort := strings.Trim(out, "\n") + _, port, err := net.SplitHostPort(fileserverHostPort) + if err != nil { + return nil, fmt.Errorf("unable to parse file server host:port: %v", err) + } + + dockerHostURL, err := url.Parse(daemonHost()) + if err != nil { + return nil, fmt.Errorf("unable to parse daemon host URL: %v", err) + } + + host, _, err := net.SplitHostPort(dockerHostURL.Host) + if err != nil { + return nil, fmt.Errorf("unable to parse docker daemon host:port: %v", err) + } + + return &remoteFileServer{ + container: container, + image: image, + host: fmt.Sprintf("%s:%s", host, port), + ctx: ctx}, nil +} + +func inspectFieldAndMarshall(name, field string, output interface{}) error { + str, err := inspectFieldJSON(name, field) + if err != nil { + return err + } + + return json.Unmarshal([]byte(str), output) +} + +func inspectFilter(name, filter string) (string, error) { + format := fmt.Sprintf("{{%s}}", filter) + inspectCmd := exec.Command(dockerBinary, "inspect", "-f", format, name) + out, exitCode, err := runCommandWithOutput(inspectCmd) + if err != nil || exitCode != 0 { + return "", fmt.Errorf("failed to inspect container %s: %s", name, out) + } + return strings.TrimSpace(out), nil +} + +func inspectField(name, field string) (string, error) { + return inspectFilter(name, fmt.Sprintf(".%s", field)) +} + +func inspectFieldJSON(name, field string) (string, error) { + return inspectFilter(name, fmt.Sprintf("json .%s", field)) +} + +func inspectFieldMap(name, path, field string) (string, error) { + return inspectFilter(name, fmt.Sprintf("index .%s %q", path, field)) +} + +func inspectMountSourceField(name, destination string) (string, error) { + m, err := inspectMountPoint(name, destination) + if err != nil { + return "", err + } + return m.Source, nil +} + +func inspectMountPoint(name, destination string) (types.MountPoint, error) { + out, err := inspectFieldJSON(name, "Mounts") + if err != nil { + return types.MountPoint{}, err + } + + return inspectMountPointJSON(out, destination) +} + +var errMountNotFound = errors.New("mount point not found") + +func inspectMountPointJSON(j, destination string) (types.MountPoint, error) { + var mp []types.MountPoint + if err := unmarshalJSON([]byte(j), &mp); err != nil { + return types.MountPoint{}, err + } + + var m *types.MountPoint + for _, c := range mp { + if c.Destination == destination { + m = &c + break + } + } + + if m == nil { + return types.MountPoint{}, errMountNotFound + } + + return *m, nil +} + +func getIDByName(name string) (string, error) { + return inspectField(name, "Id") +} + +// getContainerState returns the exit code of the container +// and true if it's running +// the exit code should be ignored if it's running +func getContainerState(c *check.C, id string) (int, bool, error) { + var ( + exitStatus int + running bool + ) + out, exitCode := dockerCmd(c, "inspect", "--format={{.State.Running}} {{.State.ExitCode}}", id) + if exitCode != 0 { + return 0, false, fmt.Errorf("%q doesn't exist: %s", id, out) + } + + out = strings.Trim(out, "\n") + splitOutput := strings.Split(out, " ") + if len(splitOutput) != 2 { + return 0, false, fmt.Errorf("failed to get container state: output is broken") + } + if splitOutput[0] == "true" { + running = true + } + if n, err := strconv.Atoi(splitOutput[1]); err == nil { + exitStatus = n + } else { + return 0, false, fmt.Errorf("failed to get container state: couldn't parse integer") + } + + return exitStatus, running, nil +} + +func buildImageCmd(name, dockerfile string, useCache bool, buildFlags ...string) *exec.Cmd { + args := []string{"-D", "build", "-t", name} + if !useCache { + args = append(args, "--no-cache") + } + args = append(args, buildFlags...) + args = append(args, "-") + buildCmd := exec.Command(dockerBinary, args...) + buildCmd.Stdin = strings.NewReader(dockerfile) + return buildCmd + +} + +func buildImageWithOut(name, dockerfile string, useCache bool, buildFlags ...string) (string, string, error) { + buildCmd := buildImageCmd(name, dockerfile, useCache, buildFlags...) + out, exitCode, err := runCommandWithOutput(buildCmd) + if err != nil || exitCode != 0 { + return "", out, fmt.Errorf("failed to build the image: %s", out) + } + id, err := getIDByName(name) + if err != nil { + return "", out, err + } + return id, out, nil +} + +func buildImageWithStdoutStderr(name, dockerfile string, useCache bool, buildFlags ...string) (string, string, string, error) { + buildCmd := buildImageCmd(name, dockerfile, useCache, buildFlags...) + stdout, stderr, exitCode, err := runCommandWithStdoutStderr(buildCmd) + if err != nil || exitCode != 0 { + return "", stdout, stderr, fmt.Errorf("failed to build the image: %s", stdout) + } + id, err := getIDByName(name) + if err != nil { + return "", stdout, stderr, err + } + return id, stdout, stderr, nil +} + +func buildImage(name, dockerfile string, useCache bool, buildFlags ...string) (string, error) { + id, _, err := buildImageWithOut(name, dockerfile, useCache, buildFlags...) + return id, err +} + +func buildImageFromContext(name string, ctx *FakeContext, useCache bool, buildFlags ...string) (string, error) { + id, _, err := buildImageFromContextWithOut(name, ctx, useCache, buildFlags...) + if err != nil { + return "", err + } + return id, nil +} + +func buildImageFromContextWithOut(name string, ctx *FakeContext, useCache bool, buildFlags ...string) (string, string, error) { + args := []string{"build", "-t", name} + if !useCache { + args = append(args, "--no-cache") + } + args = append(args, buildFlags...) + args = append(args, ".") + buildCmd := exec.Command(dockerBinary, args...) + buildCmd.Dir = ctx.Dir + out, exitCode, err := runCommandWithOutput(buildCmd) + if err != nil || exitCode != 0 { + return "", "", fmt.Errorf("failed to build the image: %s", out) + } + id, err := getIDByName(name) + if err != nil { + return "", "", err + } + return id, out, nil +} + +func buildImageFromPath(name, path string, useCache bool, buildFlags ...string) (string, error) { + args := []string{"build", "-t", name} + if !useCache { + args = append(args, "--no-cache") + } + args = append(args, buildFlags...) + args = append(args, path) + buildCmd := exec.Command(dockerBinary, args...) + out, exitCode, err := runCommandWithOutput(buildCmd) + if err != nil || exitCode != 0 { + return "", fmt.Errorf("failed to build the image: %s", out) + } + return getIDByName(name) +} + +type gitServer interface { + URL() string + Close() error +} + +type localGitServer struct { + *httptest.Server +} + +func (r *localGitServer) Close() error { + r.Server.Close() + return nil +} + +func (r *localGitServer) URL() string { + return r.Server.URL +} + +type fakeGit struct { + root string + server gitServer + RepoURL string +} + +func (g *fakeGit) Close() { + g.server.Close() + os.RemoveAll(g.root) +} + +func newFakeGit(name string, files map[string]string, enforceLocalServer bool) (*fakeGit, error) { + ctx, err := fakeContextWithFiles(files) + if err != nil { + return nil, err + } + defer ctx.Close() + curdir, err := os.Getwd() + if err != nil { + return nil, err + } + defer os.Chdir(curdir) + + if output, err := exec.Command("git", "init", ctx.Dir).CombinedOutput(); err != nil { + return nil, fmt.Errorf("error trying to init repo: %s (%s)", err, output) + } + err = os.Chdir(ctx.Dir) + if err != nil { + return nil, err + } + if output, err := exec.Command("git", "config", "user.name", "Fake User").CombinedOutput(); err != nil { + return nil, fmt.Errorf("error trying to set 'user.name': %s (%s)", err, output) + } + if output, err := exec.Command("git", "config", "user.email", "fake.user@example.com").CombinedOutput(); err != nil { + return nil, fmt.Errorf("error trying to set 'user.email': %s (%s)", err, output) + } + if output, err := exec.Command("git", "add", "*").CombinedOutput(); err != nil { + return nil, fmt.Errorf("error trying to add files to repo: %s (%s)", err, output) + } + if output, err := exec.Command("git", "commit", "-a", "-m", "Initial commit").CombinedOutput(); err != nil { + return nil, fmt.Errorf("error trying to commit to repo: %s (%s)", err, output) + } + + root, err := ioutil.TempDir("", "docker-test-git-repo") + if err != nil { + return nil, err + } + repoPath := filepath.Join(root, name+".git") + if output, err := exec.Command("git", "clone", "--bare", ctx.Dir, repoPath).CombinedOutput(); err != nil { + os.RemoveAll(root) + return nil, fmt.Errorf("error trying to clone --bare: %s (%s)", err, output) + } + err = os.Chdir(repoPath) + if err != nil { + os.RemoveAll(root) + return nil, err + } + if output, err := exec.Command("git", "update-server-info").CombinedOutput(); err != nil { + os.RemoveAll(root) + return nil, fmt.Errorf("error trying to git update-server-info: %s (%s)", err, output) + } + err = os.Chdir(curdir) + if err != nil { + os.RemoveAll(root) + return nil, err + } + + var server gitServer + if !enforceLocalServer { + // use fakeStorage server, which might be local or remote (at test daemon) + server, err = fakeStorageWithContext(fakeContextFromDir(root)) + if err != nil { + return nil, fmt.Errorf("cannot start fake storage: %v", err) + } + } else { + // always start a local http server on CLI test machin + httpServer := httptest.NewServer(http.FileServer(http.Dir(root))) + server = &localGitServer{httpServer} + } + return &fakeGit{ + root: root, + server: server, + RepoURL: fmt.Sprintf("%s/%s.git", server.URL(), name), + }, nil +} + +// Write `content` to the file at path `dst`, creating it if necessary, +// as well as any missing directories. +// The file is truncated if it already exists. +// Call c.Fatal() at the first error. +func writeFile(dst, content string, c *check.C) { + // Create subdirectories if necessary + if err := os.MkdirAll(path.Dir(dst), 0700); err != nil { + c.Fatal(err) + } + f, err := os.OpenFile(dst, os.O_CREATE|os.O_RDWR|os.O_TRUNC, 0700) + if err != nil { + c.Fatal(err) + } + defer f.Close() + // Write content (truncate if it exists) + if _, err := io.Copy(f, strings.NewReader(content)); err != nil { + c.Fatal(err) + } +} + +// Return the contents of file at path `src`. +// Call c.Fatal() at the first error (including if the file doesn't exist) +func readFile(src string, c *check.C) (content string) { + data, err := ioutil.ReadFile(src) + if err != nil { + c.Fatal(err) + } + + return string(data) +} + +func containerStorageFile(containerID, basename string) string { + return filepath.Join(containerStoragePath, containerID, basename) +} + +// docker commands that use this function must be run with the '-d' switch. +func runCommandAndReadContainerFile(filename string, cmd *exec.Cmd) ([]byte, error) { + out, _, err := runCommandWithOutput(cmd) + if err != nil { + return nil, fmt.Errorf("%v: %q", err, out) + } + + contID := strings.TrimSpace(out) + + if err := waitRun(contID); err != nil { + return nil, fmt.Errorf("%v: %q", contID, err) + } + + return readContainerFile(contID, filename) +} + +func readContainerFile(containerID, filename string) ([]byte, error) { + f, err := os.Open(containerStorageFile(containerID, filename)) + if err != nil { + return nil, err + } + defer f.Close() + + content, err := ioutil.ReadAll(f) + if err != nil { + return nil, err + } + + return content, nil +} + +func readContainerFileWithExec(containerID, filename string) ([]byte, error) { + out, _, err := runCommandWithOutput(exec.Command(dockerBinary, "exec", containerID, "cat", filename)) + return []byte(out), err +} + +// daemonTime provides the current time on the daemon host +func daemonTime(c *check.C) time.Time { + if isLocalDaemon { + return time.Now() + } + + status, body, err := sockRequest("GET", "/info", nil) + c.Assert(status, check.Equals, http.StatusOK) + c.Assert(err, check.IsNil) + + type infoJSON struct { + SystemTime string + } + var info infoJSON + if err = json.Unmarshal(body, &info); err != nil { + c.Fatalf("unable to unmarshal /info response: %v", err) + } + + dt, err := time.Parse(time.RFC3339Nano, info.SystemTime) + if err != nil { + c.Fatal(err) + } + return dt +} + +func setupRegistry(c *check.C) *testRegistryV2 { + testRequires(c, RegistryHosting) + reg, err := newTestRegistryV2(c) + if err != nil { + c.Fatal(err) + } + + // Wait for registry to be ready to serve requests. + for i := 0; i != 5; i++ { + if err = reg.Ping(); err == nil { + break + } + time.Sleep(100 * time.Millisecond) + } + + if err != nil { + c.Fatal("Timeout waiting for test registry to become available") + } + return reg +} + +func setupNotary(c *check.C) *testNotary { + testRequires(c, NotaryHosting) + ts, err := newTestNotary(c) + if err != nil { + c.Fatal(err) + } + + return ts +} + +// appendBaseEnv appends the minimum set of environment variables to exec the +// docker cli binary for testing with correct configuration to the given env +// list. +func appendBaseEnv(env []string) []string { + preserveList := []string{ + // preserve remote test host + "DOCKER_HOST", + + // windows: requires preserving SystemRoot, otherwise dial tcp fails + // with "GetAddrInfoW: A non-recoverable error occurred during a database lookup." + "SystemRoot", + } + + for _, key := range preserveList { + if val := os.Getenv(key); val != "" { + env = append(env, fmt.Sprintf("%s=%s", key, val)) + } + } + return env +} + +func createTmpFile(c *check.C, content string) string { + f, err := ioutil.TempFile("", "testfile") + c.Assert(err, check.IsNil) + + filename := f.Name() + + err = ioutil.WriteFile(filename, []byte(content), 0644) + c.Assert(err, check.IsNil) + + return filename +} + +func buildImageWithOutInDamon(socket string, name, dockerfile string, useCache bool) (string, error) { + args := []string{"--host", socket} + buildCmd := buildImageCmdArgs(args, name, dockerfile, useCache) + out, exitCode, err := runCommandWithOutput(buildCmd) + if err != nil || exitCode != 0 { + return out, fmt.Errorf("failed to build the image: %s, error: %v", out, err) + } + return out, nil +} + +func buildImageCmdArgs(args []string, name, dockerfile string, useCache bool) *exec.Cmd { + args = append(args, []string{"-D", "build", "-t", name}...) + if !useCache { + args = append(args, "--no-cache") + } + args = append(args, "-") + buildCmd := exec.Command(dockerBinary, args...) + buildCmd.Stdin = strings.NewReader(dockerfile) + return buildCmd + +} + +func waitForContainer(contID string, args ...string) error { + args = append([]string{"run", "--name", contID}, args...) + cmd := exec.Command(dockerBinary, args...) + if _, err := runCommand(cmd); err != nil { + return err + } + + if err := waitRun(contID); err != nil { + return err + } + + return nil +} + +// waitRun will wait for the specified container to be running, maximum 5 seconds. +func waitRun(contID string) error { + return waitInspect(contID, "{{.State.Running}}", "true", 5*time.Second) +} + +// waitExited will wait for the specified container to state exit, subject +// to a maximum time limit in seconds supplied by the caller +func waitExited(contID string, duration time.Duration) error { + return waitInspect(contID, "{{.State.Status}}", "exited", duration) +} + +// waitInspect will wait for the specified container to have the specified string +// in the inspect output. It will wait until the specified timeout (in seconds) +// is reached. +func waitInspect(name, expr, expected string, timeout time.Duration) error { + after := time.After(timeout) + + for { + cmd := exec.Command(dockerBinary, "inspect", "-f", expr, name) + out, _, err := runCommandWithOutput(cmd) + if err != nil { + if !strings.Contains(out, "No such") { + return fmt.Errorf("error executing docker inspect: %v\n%s", err, out) + } + select { + case <-after: + return err + default: + time.Sleep(10 * time.Millisecond) + continue + } + } + + out = strings.TrimSpace(out) + if out == expected { + break + } + + select { + case <-after: + return fmt.Errorf("condition \"%q == %q\" not true in time", out, expected) + default: + } + + time.Sleep(100 * time.Millisecond) + } + return nil +} + +func getInspectBody(c *check.C, version, id string) []byte { + endpoint := fmt.Sprintf("/%s/containers/%s/json", version, id) + status, body, err := sockRequest("GET", endpoint, nil) + c.Assert(err, check.IsNil) + c.Assert(status, check.Equals, http.StatusOK) + return body +} diff --git a/integration-cli/fixtures/https/ca.pem b/integration-cli/fixtures/https/ca.pem new file mode 100644 index 0000000000..6825d6d1bd --- /dev/null +++ b/integration-cli/fixtures/https/ca.pem @@ -0,0 +1,23 @@ +-----BEGIN CERTIFICATE----- +MIID0TCCAzqgAwIBAgIJAP2r7GqEJwSnMA0GCSqGSIb3DQEBBQUAMIGiMQswCQYD +VQQGEwJVUzELMAkGA1UECBMCQ0ExFTATBgNVBAcTDFNhbkZyYW5jaXNjbzEVMBMG +A1UEChMMRm9ydC1GdW5zdG9uMREwDwYDVQQLEwhjaGFuZ2VtZTERMA8GA1UEAxMI +Y2hhbmdlbWUxETAPBgNVBCkTCGNoYW5nZW1lMR8wHQYJKoZIhvcNAQkBFhBtYWls +QGhvc3QuZG9tYWluMB4XDTEzMTIwMzE2NTYzMFoXDTIzMTIwMTE2NTYzMFowgaIx +CzAJBgNVBAYTAlVTMQswCQYDVQQIEwJDQTEVMBMGA1UEBxMMU2FuRnJhbmNpc2Nv +MRUwEwYDVQQKEwxGb3J0LUZ1bnN0b24xETAPBgNVBAsTCGNoYW5nZW1lMREwDwYD +VQQDEwhjaGFuZ2VtZTERMA8GA1UEKRMIY2hhbmdlbWUxHzAdBgkqhkiG9w0BCQEW +EG1haWxAaG9zdC5kb21haW4wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBALAn +0xDw+5y7ZptQacq66pUhRu82JP2WU6IDgo5QUtNU6/CX5PwQATe/OnYTZQFbksxp +AU9boG0FCkgxfsgPYXEuZxVEGKI2fxfKHOZZI8mrkWmj6eWU/0cvCjGVc9rTITP5 +sNQvg+hORyVDdNp2IdsbMJayiB3AQYMFx3vSDOMTAgMBAAGjggELMIIBBzAdBgNV +HQ4EFgQUZu7DFz09q0QBa2+ymRm9qgK1NPswgdcGA1UdIwSBzzCBzIAUZu7DFz09 +q0QBa2+ymRm9qgK1NPuhgaikgaUwgaIxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJD +QTEVMBMGA1UEBxMMU2FuRnJhbmNpc2NvMRUwEwYDVQQKEwxGb3J0LUZ1bnN0b24x +ETAPBgNVBAsTCGNoYW5nZW1lMREwDwYDVQQDEwhjaGFuZ2VtZTERMA8GA1UEKRMI +Y2hhbmdlbWUxHzAdBgkqhkiG9w0BCQEWEG1haWxAaG9zdC5kb21haW6CCQD9q+xq +hCcEpzAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBQUAA4GBAF8fJKKM+/oOdnNi +zEd0M1+PmZOyqvjYQn/2ZR8UHH6Imgc/OPQKZXf0bVE1Txc/DaUNn9Isd1SuCuaE +ic3vAIYYU7PmgeNN6vwec48V96T7jr+GAi6AVMhQEc2hHCfVtx11Xx+x6aHDZzJt +Zxtf5lL6KSO9Y+EFwM+rju6hm5hW +-----END CERTIFICATE----- diff --git a/integration-cli/fixtures/https/client-cert.pem b/integration-cli/fixtures/https/client-cert.pem new file mode 100644 index 0000000000..c05ed47c2c --- /dev/null +++ b/integration-cli/fixtures/https/client-cert.pem @@ -0,0 +1,73 @@ +Certificate: + Data: + Version: 3 (0x2) + Serial Number: 3 (0x3) + Signature Algorithm: sha1WithRSAEncryption + Issuer: C=US, ST=CA, L=SanFrancisco, O=Fort-Funston, OU=changeme, CN=changeme/name=changeme/emailAddress=mail@host.domain + Validity + Not Before: Dec 4 14:17:54 2013 GMT + Not After : Dec 2 14:17:54 2023 GMT + Subject: C=US, ST=CA, L=SanFrancisco, O=Fort-Funston, OU=changeme, CN=client/name=changeme/emailAddress=mail@host.domain + Subject Public Key Info: + Public Key Algorithm: rsaEncryption + Public-Key: (1024 bit) + Modulus: + 00:ca:c9:05:d0:09:4e:3e:a4:fc:d5:14:f4:a5:e8: + 34:d3:6b:51:e3:f3:62:ea:a1:f0:e8:ed:c4:2a:bc: + f0:4f:ca:07:df:e3:88:fa:f4:21:99:35:0e:3d:ea: + b0:86:e7:c4:d2:8a:83:2b:42:b8:ec:a3:99:62:70: + 81:46:cc:fc:a5:1d:d2:63:e8:eb:07:25:9a:e2:25: + 6d:11:56:f2:1a:51:a1:b6:3e:1c:57:32:e9:7b:2c: + aa:1b:cc:97:2d:89:2d:b1:c9:5e:35:28:4d:7c:fa: + 65:31:3e:f7:70:dd:6e:0b:3c:58:af:a8:2e:24:c0: + 7e:4e:78:7d:0a:9e:8f:42:43 + Exponent: 65537 (0x10001) + X509v3 extensions: + X509v3 Basic Constraints: + CA:FALSE + Netscape Comment: + Easy-RSA Generated Certificate + X509v3 Subject Key Identifier: + DE:42:EF:2D:98:A3:6C:A8:AA:E0:8C:71:2C:9D:64:23:A9:E2:7E:81 + X509v3 Authority Key Identifier: + keyid:66:EE:C3:17:3D:3D:AB:44:01:6B:6F:B2:99:19:BD:AA:02:B5:34:FB + DirName:/C=US/ST=CA/L=SanFrancisco/O=Fort-Funston/OU=changeme/CN=changeme/name=changeme/emailAddress=mail@host.domain + serial:FD:AB:EC:6A:84:27:04:A7 + + X509v3 Extended Key Usage: + TLS Web Client Authentication + X509v3 Key Usage: + Digital Signature + Signature Algorithm: sha1WithRSAEncryption + 1c:44:26:ea:e1:66:25:cb:e4:8e:57:1c:f6:b9:17:22:62:40: + 12:90:8f:3b:b2:61:7a:54:94:8f:b1:20:0b:bf:a3:51:e3:fa: + 1c:a1:be:92:3a:d0:76:44:c0:57:83:ab:6a:e4:1a:45:49:a4: + af:39:0d:60:32:fc:3a:be:d7:fb:5d:99:7a:1f:87:e7:d5:ab: + 84:a2:5e:90:d8:bf:fa:89:6d:32:26:02:5e:31:35:68:7f:31: + f5:6b:51:46:bc:af:70:ed:5a:09:7d:ec:b2:48:4f:fe:c5:2f: + 56:04:ad:f6:c1:d2:2a:e4:6a:c4:87:fe:08:35:c5:38:cb:5e: + 4a:c4 +-----BEGIN CERTIFICATE----- +MIIEFTCCA36gAwIBAgIBAzANBgkqhkiG9w0BAQUFADCBojELMAkGA1UEBhMCVVMx +CzAJBgNVBAgTAkNBMRUwEwYDVQQHEwxTYW5GcmFuY2lzY28xFTATBgNVBAoTDEZv +cnQtRnVuc3RvbjERMA8GA1UECxMIY2hhbmdlbWUxETAPBgNVBAMTCGNoYW5nZW1l +MREwDwYDVQQpEwhjaGFuZ2VtZTEfMB0GCSqGSIb3DQEJARYQbWFpbEBob3N0LmRv +bWFpbjAeFw0xMzEyMDQxNDE3NTRaFw0yMzEyMDIxNDE3NTRaMIGgMQswCQYDVQQG +EwJVUzELMAkGA1UECBMCQ0ExFTATBgNVBAcTDFNhbkZyYW5jaXNjbzEVMBMGA1UE +ChMMRm9ydC1GdW5zdG9uMREwDwYDVQQLEwhjaGFuZ2VtZTEPMA0GA1UEAxMGY2xp +ZW50MREwDwYDVQQpEwhjaGFuZ2VtZTEfMB0GCSqGSIb3DQEJARYQbWFpbEBob3N0 +LmRvbWFpbjCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAyskF0AlOPqT81RT0 +peg002tR4/Ni6qHw6O3EKrzwT8oH3+OI+vQhmTUOPeqwhufE0oqDK0K47KOZYnCB +Rsz8pR3SY+jrByWa4iVtEVbyGlGhtj4cVzLpeyyqG8yXLYktscleNShNfPplMT73 +cN1uCzxYr6guJMB+Tnh9Cp6PQkMCAwEAAaOCAVkwggFVMAkGA1UdEwQCMAAwLQYJ +YIZIAYb4QgENBCAWHkVhc3ktUlNBIEdlbmVyYXRlZCBDZXJ0aWZpY2F0ZTAdBgNV +HQ4EFgQU3kLvLZijbKiq4IxxLJ1kI6nifoEwgdcGA1UdIwSBzzCBzIAUZu7DFz09 +q0QBa2+ymRm9qgK1NPuhgaikgaUwgaIxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJD +QTEVMBMGA1UEBxMMU2FuRnJhbmNpc2NvMRUwEwYDVQQKEwxGb3J0LUZ1bnN0b24x +ETAPBgNVBAsTCGNoYW5nZW1lMREwDwYDVQQDEwhjaGFuZ2VtZTERMA8GA1UEKRMI +Y2hhbmdlbWUxHzAdBgkqhkiG9w0BCQEWEG1haWxAaG9zdC5kb21haW6CCQD9q+xq +hCcEpzATBgNVHSUEDDAKBggrBgEFBQcDAjALBgNVHQ8EBAMCB4AwDQYJKoZIhvcN +AQEFBQADgYEAHEQm6uFmJcvkjlcc9rkXImJAEpCPO7JhelSUj7EgC7+jUeP6HKG+ +kjrQdkTAV4OrauQaRUmkrzkNYDL8Or7X+12Zeh+H59WrhKJekNi/+oltMiYCXjE1 +aH8x9WtRRryvcO1aCX3sskhP/sUvVgSt9sHSKuRqxIf+CDXFOMteSsQ= +-----END CERTIFICATE----- diff --git a/integration-cli/fixtures/https/client-key.pem b/integration-cli/fixtures/https/client-key.pem new file mode 100644 index 0000000000..b5c15f8dc7 --- /dev/null +++ b/integration-cli/fixtures/https/client-key.pem @@ -0,0 +1,16 @@ +-----BEGIN PRIVATE KEY----- +MIICdQIBADANBgkqhkiG9w0BAQEFAASCAl8wggJbAgEAAoGBAMrJBdAJTj6k/NUU +9KXoNNNrUePzYuqh8OjtxCq88E/KB9/jiPr0IZk1Dj3qsIbnxNKKgytCuOyjmWJw +gUbM/KUd0mPo6wclmuIlbRFW8hpRobY+HFcy6XssqhvMly2JLbHJXjUoTXz6ZTE+ +93Ddbgs8WK+oLiTAfk54fQqej0JDAgMBAAECgYBOFEzKp2qbMEexe9ofL2N3rDDh +xkrl8OijpzkLA6i78BxMFn4dsnZlWUpciMrjhsYAExkiRRSS+QMMJimAq1jzQqc3 +FAQV2XGYwkd0cUn7iZGvfNnEPysjsfyYQM+m+sT0ATj4BZjVShC6kkSjTdm1leLN +OSvcHdcu3Xxg9ufF0QJBAPYdnNt5sIndt2WECePuRVi+uF4mlxTobFY0fjn26yhC +4RsnhhD3Vldygo9gvnkwrAZYaALGSPBewes2InxvjA8CQQDS7erKiNXpwoqz5XiU +SVEsIIVTdWzBjGbIqMOu/hUwM5FK4j6JTBks0aTGMyh0YV9L1EzM0X79J29JahCe +iQKNAkBKNMOGqTpBV0hko1sYDk96YobUXG5RL4L6uvkUIQ7mJMQam+AgXXL7Ctuy +v0iu4a38e8tgisiTMP7nHHtpaXihAkAOiN54/lzfMsykANgCP9scE1GcoqbP34Dl +qttxH4kOPT9xzY1JoLjLYdbc4YGUI3GRpBt2sajygNkmUey7P+2xAkBBsVCZFvTw +qHvOpPS2kX5ml5xoc/QAHK9N7kR+X7XFYx82RTVSqJEK4lPb+aEWn+CjiIewO4Q5 +ksDFuNxAzbhl +-----END PRIVATE KEY----- diff --git a/integration-cli/fixtures/https/client-rogue-cert.pem b/integration-cli/fixtures/https/client-rogue-cert.pem new file mode 100644 index 0000000000..21ae4bd579 --- /dev/null +++ b/integration-cli/fixtures/https/client-rogue-cert.pem @@ -0,0 +1,73 @@ +Certificate: + Data: + Version: 3 (0x2) + Serial Number: 2 (0x2) + Signature Algorithm: sha1WithRSAEncryption + Issuer: C=US, ST=CA, L=SanFrancisco, O=Evil Inc, OU=changeme, CN=changeme/name=changeme/emailAddress=mail@host.domain + Validity + Not Before: Feb 24 17:54:59 2014 GMT + Not After : Feb 22 17:54:59 2024 GMT + Subject: C=US, ST=CA, L=SanFrancisco, O=Fort-Funston, OU=changeme, CN=client/name=changeme/emailAddress=mail@host.domain + Subject Public Key Info: + Public Key Algorithm: rsaEncryption + Public-Key: (1024 bit) + Modulus: + 00:e8:e2:2c:b8:d4:db:89:50:4f:47:1e:68:db:f7: + e4:cc:47:41:63:75:03:37:50:7a:a8:4d:27:36:d5: + 15:01:08:b6:cf:56:f7:56:6d:3d:f9:e2:8d:1a:5d: + bf:a0:24:5e:07:55:8e:d0:dc:f1:fa:19:87:1d:d6: + b6:58:82:2e:ba:69:6d:e9:d9:c8:16:0d:1d:59:7f: + f4:8e:58:10:01:3d:21:14:16:3c:ec:cd:8c:b7:0e: + e6:7b:77:b4:f9:90:a5:17:01:bb:84:c6:b2:12:87: + 70:eb:9f:6d:4f:d0:68:8b:96:c0:e7:0b:51:b4:9d: + 1d:7b:6c:7b:be:89:6b:88:8b + Exponent: 65537 (0x10001) + X509v3 extensions: + X509v3 Basic Constraints: + CA:FALSE + Netscape Comment: + Easy-RSA Generated Certificate + X509v3 Subject Key Identifier: + 9E:F8:49:D0:A2:76:30:5C:AB:2B:8A:B5:8D:C6:45:1F:A7:F8:CF:85 + X509v3 Authority Key Identifier: + keyid:DC:A5:F1:76:DB:4E:CD:8E:EF:B1:23:56:1D:92:80:99:74:3B:EA:6F + DirName:/C=US/ST=CA/L=SanFrancisco/O=Evil Inc/OU=changeme/CN=changeme/name=changeme/emailAddress=mail@host.domain + serial:E7:21:1E:18:41:1B:96:83 + + X509v3 Extended Key Usage: + TLS Web Client Authentication + X509v3 Key Usage: + Digital Signature + Signature Algorithm: sha1WithRSAEncryption + 48:76:c0:18:fa:0a:ee:4e:1a:ec:02:9d:d4:83:ca:94:54:a1: + 3f:51:2f:3e:4b:95:c3:42:9b:71:a0:4b:d9:af:47:23:b9:1c: + fb:85:ba:76:e2:09:cb:65:bb:d2:7d:44:3d:4b:67:ba:80:83: + be:a8:ed:c4:b9:ea:1a:1b:c7:59:3b:d9:5c:0d:46:d8:c9:92: + cb:10:c5:f2:1a:38:a4:aa:07:2c:e3:84:16:79:c7:95:09:e3: + 01:d2:15:a2:77:0b:8b:bf:94:04:e9:7f:c0:cd:e6:2e:64:cd: + 1e:a3:32:ec:11:cc:62:ce:c7:4e:cd:ad:48:5c:b1:b8:e9:76: + b3:f9 +-----BEGIN CERTIFICATE----- +MIIEDTCCA3agAwIBAgIBAjANBgkqhkiG9w0BAQUFADCBnjELMAkGA1UEBhMCVVMx +CzAJBgNVBAgTAkNBMRUwEwYDVQQHEwxTYW5GcmFuY2lzY28xETAPBgNVBAoTCEV2 +aWwgSW5jMREwDwYDVQQLEwhjaGFuZ2VtZTERMA8GA1UEAxMIY2hhbmdlbWUxETAP +BgNVBCkTCGNoYW5nZW1lMR8wHQYJKoZIhvcNAQkBFhBtYWlsQGhvc3QuZG9tYWlu +MB4XDTE0MDIyNDE3NTQ1OVoXDTI0MDIyMjE3NTQ1OVowgaAxCzAJBgNVBAYTAlVT +MQswCQYDVQQIEwJDQTEVMBMGA1UEBxMMU2FuRnJhbmNpc2NvMRUwEwYDVQQKEwxG +b3J0LUZ1bnN0b24xETAPBgNVBAsTCGNoYW5nZW1lMQ8wDQYDVQQDEwZjbGllbnQx +ETAPBgNVBCkTCGNoYW5nZW1lMR8wHQYJKoZIhvcNAQkBFhBtYWlsQGhvc3QuZG9t +YWluMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDo4iy41NuJUE9HHmjb9+TM +R0FjdQM3UHqoTSc21RUBCLbPVvdWbT354o0aXb+gJF4HVY7Q3PH6GYcd1rZYgi66 +aW3p2cgWDR1Zf/SOWBABPSEUFjzszYy3DuZ7d7T5kKUXAbuExrISh3Drn21P0GiL +lsDnC1G0nR17bHu+iWuIiwIDAQABo4IBVTCCAVEwCQYDVR0TBAIwADAtBglghkgB +hvhCAQ0EIBYeRWFzeS1SU0EgR2VuZXJhdGVkIENlcnRpZmljYXRlMB0GA1UdDgQW +BBSe+EnQonYwXKsrirWNxkUfp/jPhTCB0wYDVR0jBIHLMIHIgBTcpfF2207Nju+x +I1YdkoCZdDvqb6GBpKSBoTCBnjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMRUw +EwYDVQQHEwxTYW5GcmFuY2lzY28xETAPBgNVBAoTCEV2aWwgSW5jMREwDwYDVQQL +EwhjaGFuZ2VtZTERMA8GA1UEAxMIY2hhbmdlbWUxETAPBgNVBCkTCGNoYW5nZW1l +MR8wHQYJKoZIhvcNAQkBFhBtYWlsQGhvc3QuZG9tYWluggkA5yEeGEEbloMwEwYD +VR0lBAwwCgYIKwYBBQUHAwIwCwYDVR0PBAQDAgeAMA0GCSqGSIb3DQEBBQUAA4GB +AEh2wBj6Cu5OGuwCndSDypRUoT9RLz5LlcNCm3GgS9mvRyO5HPuFunbiCctlu9J9 +RD1LZ7qAg76o7cS56hobx1k72VwNRtjJkssQxfIaOKSqByzjhBZ5x5UJ4wHSFaJ3 +C4u/lATpf8DN5i5kzR6jMuwRzGLOx07NrUhcsbjpdrP5 +-----END CERTIFICATE----- diff --git a/integration-cli/fixtures/https/client-rogue-key.pem b/integration-cli/fixtures/https/client-rogue-key.pem new file mode 100644 index 0000000000..53c122ab70 --- /dev/null +++ b/integration-cli/fixtures/https/client-rogue-key.pem @@ -0,0 +1,16 @@ +-----BEGIN PRIVATE KEY----- +MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBAOjiLLjU24lQT0ce +aNv35MxHQWN1AzdQeqhNJzbVFQEIts9W91ZtPfnijRpdv6AkXgdVjtDc8foZhx3W +tliCLrppbenZyBYNHVl/9I5YEAE9IRQWPOzNjLcO5nt3tPmQpRcBu4TGshKHcOuf +bU/QaIuWwOcLUbSdHXtse76Ja4iLAgMBAAECgYADs+TmI2xCKKa6CL++D5jxrohZ +nnionnz0xBVFh+nHlG3jqgxQsXf0yydXLfpn/2wHTdLxezHVuiYt0UYg7iD0CglW ++IjcgMebzyjLeYqYOE5llPlMvhp2HoEMYJNb+7bRrZ1WCITbu+Su0w1cgA7Cs+Ej +VlfvGzN+qqnDThRUYQJBAPY0sMWZJKly8QhUmUvmcXdPczzSOf6Mm7gc5LR6wzxd +vW7syuqk50qjqVqFpN81vCV7GoDxRUWbTM9ftf7JGFkCQQDyJc/1RMygE2o+enU1 +6UBxJyclXITEYtDn8aoEpLNc7RakP1WoPUKjZOnjkcoKcIkFNkSPeCfQujrb5f3F +MkuDAkByAI/hzzmkpK5rFxEsjfX4Mve/L/DepyjrpaVY1IdWimlO1aJX6CeY7hNa +8QsYt/74s/nfvtg+lNyKIV1aLq9xAkB+WSSNgfyTeg3x08vc+Xxajmdqoz/TiQwg +OoTQL3A3iK5LvZBgXLasszcnOycFE3srcQmNItEDpGiZ3QPxJTEpAkEA45EE9NMJ +SA7EGWSFlbz4f4u4oBeiDiJRJbGGfAyVxZlpCWUjPpg9+swsWoFEOjnGYaChAMk5 +nrOdMf15T6QF7Q== +-----END PRIVATE KEY----- diff --git a/integration-cli/fixtures/https/server-cert.pem b/integration-cli/fixtures/https/server-cert.pem new file mode 100644 index 0000000000..08abfd1a3b --- /dev/null +++ b/integration-cli/fixtures/https/server-cert.pem @@ -0,0 +1,76 @@ +Certificate: + Data: + Version: 3 (0x2) + Serial Number: 4 (0x4) + Signature Algorithm: sha1WithRSAEncryption + Issuer: C=US, ST=CA, L=SanFrancisco, O=Fort-Funston, OU=changeme, CN=changeme/name=changeme/emailAddress=mail@host.domain + Validity + Not Before: Dec 4 15:01:20 2013 GMT + Not After : Dec 2 15:01:20 2023 GMT + Subject: C=US, ST=CA, L=SanFrancisco, O=Fort-Funston, OU=changeme, CN=*/name=changeme/emailAddress=mail@host.domain + Subject Public Key Info: + Public Key Algorithm: rsaEncryption + Public-Key: (1024 bit) + Modulus: + 00:c1:ff:7d:30:6f:64:4a:b1:92:b1:71:d1:c1:74: + e2:1d:db:2d:11:24:e1:00:d4:00:ae:6f:c8:9e:ae: + 67:b3:4a:bd:f7:e6:9e:57:6d:19:4c:3c:23:94:2d: + 3d:d6:63:84:d8:fa:76:2b:38:12:c1:ed:20:9d:32: + e0:e8:c2:bf:9a:77:70:04:3f:7f:ca:8c:2c:82:d6: + 3d:25:5c:02:1a:4f:64:93:03:dd:9c:42:97:5e:09: + 49:af:f0:c2:e1:30:08:0e:21:46:95:d1:13:59:c0: + c8:76:be:94:0d:8b:43:67:21:33:b2:08:60:9d:76: + a8:05:32:1e:f9:95:09:14:75 + Exponent: 65537 (0x10001) + X509v3 extensions: + X509v3 Basic Constraints: + CA:FALSE + Netscape Cert Type: + SSL Server + Netscape Comment: + Easy-RSA Generated Server Certificate + X509v3 Subject Key Identifier: + 14:02:FD:FD:DD:13:38:E0:71:EA:D1:BE:C0:0E:89:1A:2D:B6:19:06 + X509v3 Authority Key Identifier: + keyid:66:EE:C3:17:3D:3D:AB:44:01:6B:6F:B2:99:19:BD:AA:02:B5:34:FB + DirName:/C=US/ST=CA/L=SanFrancisco/O=Fort-Funston/OU=changeme/CN=changeme/name=changeme/emailAddress=mail@host.domain + serial:FD:AB:EC:6A:84:27:04:A7 + + X509v3 Extended Key Usage: + TLS Web Server Authentication + X509v3 Key Usage: + Digital Signature, Key Encipherment + Signature Algorithm: sha1WithRSAEncryption + 40:0f:10:39:c4:b7:0f:0d:2f:bf:d2:16:cc:8e:d3:9a:fb:8b: + ce:4b:7b:0d:48:77:ce:f1:fe:d5:8f:ea:b1:71:ed:49:1d:9f: + 23:3a:16:d4:70:7c:c5:29:bf:e4:90:34:d0:f0:00:24:f4:e4: + df:2c:c3:83:01:66:61:c9:a8:ab:29:e7:98:6d:27:89:4a:76: + c9:2e:19:8e:fe:6e:d5:f8:99:11:0e:97:67:4b:34:e3:1e:e3: + 9f:35:00:a5:32:f9:b5:2c:f2:e0:c5:2e:cc:81:bd:18:dd:5c: + 12:c8:6b:fa:0c:17:74:30:55:f6:6e:20:9a:6c:1e:09:b4:0c: + 15:42 +-----BEGIN CERTIFICATE----- +MIIEKjCCA5OgAwIBAgIBBDANBgkqhkiG9w0BAQUFADCBojELMAkGA1UEBhMCVVMx +CzAJBgNVBAgTAkNBMRUwEwYDVQQHEwxTYW5GcmFuY2lzY28xFTATBgNVBAoTDEZv +cnQtRnVuc3RvbjERMA8GA1UECxMIY2hhbmdlbWUxETAPBgNVBAMTCGNoYW5nZW1l +MREwDwYDVQQpEwhjaGFuZ2VtZTEfMB0GCSqGSIb3DQEJARYQbWFpbEBob3N0LmRv +bWFpbjAeFw0xMzEyMDQxNTAxMjBaFw0yMzEyMDIxNTAxMjBaMIGbMQswCQYDVQQG +EwJVUzELMAkGA1UECBMCQ0ExFTATBgNVBAcTDFNhbkZyYW5jaXNjbzEVMBMGA1UE +ChMMRm9ydC1GdW5zdG9uMREwDwYDVQQLEwhjaGFuZ2VtZTEKMAgGA1UEAxQBKjER +MA8GA1UEKRMIY2hhbmdlbWUxHzAdBgkqhkiG9w0BCQEWEG1haWxAaG9zdC5kb21h +aW4wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMH/fTBvZEqxkrFx0cF04h3b +LREk4QDUAK5vyJ6uZ7NKvffmnldtGUw8I5QtPdZjhNj6dis4EsHtIJ0y4OjCv5p3 +cAQ/f8qMLILWPSVcAhpPZJMD3ZxCl14JSa/wwuEwCA4hRpXRE1nAyHa+lA2LQ2ch +M7IIYJ12qAUyHvmVCRR1AgMBAAGjggFzMIIBbzAJBgNVHRMEAjAAMBEGCWCGSAGG ++EIBAQQEAwIGQDA0BglghkgBhvhCAQ0EJxYlRWFzeS1SU0EgR2VuZXJhdGVkIFNl +cnZlciBDZXJ0aWZpY2F0ZTAdBgNVHQ4EFgQUFAL9/d0TOOBx6tG+wA6JGi22GQYw +gdcGA1UdIwSBzzCBzIAUZu7DFz09q0QBa2+ymRm9qgK1NPuhgaikgaUwgaIxCzAJ +BgNVBAYTAlVTMQswCQYDVQQIEwJDQTEVMBMGA1UEBxMMU2FuRnJhbmNpc2NvMRUw +EwYDVQQKEwxGb3J0LUZ1bnN0b24xETAPBgNVBAsTCGNoYW5nZW1lMREwDwYDVQQD +EwhjaGFuZ2VtZTERMA8GA1UEKRMIY2hhbmdlbWUxHzAdBgkqhkiG9w0BCQEWEG1h +aWxAaG9zdC5kb21haW6CCQD9q+xqhCcEpzATBgNVHSUEDDAKBggrBgEFBQcDATAL +BgNVHQ8EBAMCBaAwDQYJKoZIhvcNAQEFBQADgYEAQA8QOcS3Dw0vv9IWzI7TmvuL +zkt7DUh3zvH+1Y/qsXHtSR2fIzoW1HB8xSm/5JA00PAAJPTk3yzDgwFmYcmoqynn +mG0niUp2yS4Zjv5u1fiZEQ6XZ0s04x7jnzUApTL5tSzy4MUuzIG9GN1cEshr+gwX +dDBV9m4gmmweCbQMFUI= +-----END CERTIFICATE----- diff --git a/integration-cli/fixtures/https/server-key.pem b/integration-cli/fixtures/https/server-key.pem new file mode 100644 index 0000000000..c269320ef0 --- /dev/null +++ b/integration-cli/fixtures/https/server-key.pem @@ -0,0 +1,16 @@ +-----BEGIN PRIVATE KEY----- +MIICeAIBADANBgkqhkiG9w0BAQEFAASCAmIwggJeAgEAAoGBAMH/fTBvZEqxkrFx +0cF04h3bLREk4QDUAK5vyJ6uZ7NKvffmnldtGUw8I5QtPdZjhNj6dis4EsHtIJ0y +4OjCv5p3cAQ/f8qMLILWPSVcAhpPZJMD3ZxCl14JSa/wwuEwCA4hRpXRE1nAyHa+ +lA2LQ2chM7IIYJ12qAUyHvmVCRR1AgMBAAECgYAmwckb9RUfSwyYgLm8IYLPHiuJ +wkllZfVg5Bo7gXJcQnFjZmJ56uTj8xvUjZlODIHM63TSO5ibv6kFXtXKCqZGd2M+ +wGbhZ0f+2GvKcwMmJERnIQjuoNaYSQLT0tM0VB9Iz0rJlZC+tzPZ+5pPqEumRdsS +IzWNXfF42AhcbwAQYQJBAPVXtMYIJc9EZsz86ZcQiMPWUpCX5vnRmtwL8kKyR8D5 +4KfYeiowyFffSRMMcclwNHq7TgSXN+nIXM9WyzyzwikCQQDKbNA28AgZp9aT54HP +WnbeE2pmt+uk/zl/BtxJSoK6H+69Jec+lf7EgL7HgOWYRSNot4uQWu8IhsHLTiUq ++0FtAkEAqwlRxRy4/x24bP+D+QRV0/D97j93joFJbE4Hved7jlSlAV4xDGilwlyv +HNB4Iu5OJ6Gcaibhm+FKkmD3noHSwQJBAIpu3fokLzX0bS+bDFBU6qO3HXX/47xj ++tsfQvkwZrSI8AkU6c8IX0HdVhsz0FBRQAT2ORDQz1XCarfxykNZrwUCQQCGCBIc +BBCWzhHlswlGidWJg3HqqO6hPPClEr3B5G87oCsdeYwiO23XT6rUnoJXfJHp6oCW +5nCwDu5ZTP+khltg +-----END PRIVATE KEY----- diff --git a/integration-cli/fixtures/https/server-rogue-cert.pem b/integration-cli/fixtures/https/server-rogue-cert.pem new file mode 100644 index 0000000000..28feba6656 --- /dev/null +++ b/integration-cli/fixtures/https/server-rogue-cert.pem @@ -0,0 +1,76 @@ +Certificate: + Data: + Version: 3 (0x2) + Serial Number: 3 (0x3) + Signature Algorithm: sha1WithRSAEncryption + Issuer: C=US, ST=CA, L=SanFrancisco, O=Evil Inc, OU=changeme, CN=changeme/name=changeme/emailAddress=mail@host.domain + Validity + Not Before: Feb 28 18:49:31 2014 GMT + Not After : Feb 26 18:49:31 2024 GMT + Subject: C=US, ST=CA, L=SanFrancisco, O=Fort-Funston, OU=changeme, CN=localhost/name=changeme/emailAddress=mail@host.domain + Subject Public Key Info: + Public Key Algorithm: rsaEncryption + Public-Key: (1024 bit) + Modulus: + 00:d1:08:58:24:60:a1:69:65:4b:76:46:8f:88:75: + 7c:49:3a:d8:03:cc:5b:58:c5:d1:bb:e5:f9:54:b9: + 75:65:df:7e:bb:fb:54:d4:b2:e9:6f:58:a2:a4:84: + 43:94:77:24:81:38:36:36:f0:66:65:26:e5:5b:2a: + 14:1c:a9:ae:57:7f:75:00:23:14:4b:61:58:e4:82: + aa:15:97:94:bd:50:35:0d:5d:18:18:ed:10:6a:bb: + d3:64:5a:eb:36:98:5b:58:a7:fe:67:48:c1:6c:3f: + 51:2f:02:65:96:54:77:9b:34:f9:a7:d2:63:54:6a: + 9e:02:5c:be:65:98:a4:b4:b5 + Exponent: 65537 (0x10001) + X509v3 extensions: + X509v3 Basic Constraints: + CA:FALSE + Netscape Cert Type: + SSL Server + Netscape Comment: + Easy-RSA Generated Server Certificate + X509v3 Subject Key Identifier: + 1F:E0:57:CA:CB:76:C9:C4:86:B9:EA:69:17:C0:F3:51:CE:95:40:EC + X509v3 Authority Key Identifier: + keyid:DC:A5:F1:76:DB:4E:CD:8E:EF:B1:23:56:1D:92:80:99:74:3B:EA:6F + DirName:/C=US/ST=CA/L=SanFrancisco/O=Evil Inc/OU=changeme/CN=changeme/name=changeme/emailAddress=mail@host.domain + serial:E7:21:1E:18:41:1B:96:83 + + X509v3 Extended Key Usage: + TLS Web Server Authentication + X509v3 Key Usage: + Digital Signature, Key Encipherment + Signature Algorithm: sha1WithRSAEncryption + 04:93:0e:28:01:94:18:f0:8c:7c:d3:0c:ad:e9:b7:46:b1:30: + 65:ed:68:7c:8c:91:cd:1a:86:66:87:4a:4f:c0:97:bc:f7:85: + 4b:38:79:31:b2:65:88:b1:76:16:9e:80:93:38:f4:b9:eb:65: + 00:6d:bb:89:e0:a1:bf:95:5e:80:13:8e:01:73:d3:f1:08:73: + 85:a5:33:75:0b:42:8a:a3:07:09:35:ef:d7:c6:58:eb:60:a3: + 06:89:a0:53:99:e2:aa:41:90:e0:1a:d2:12:4b:48:7d:c3:9c: + ad:bd:0e:5e:5f:f7:09:0c:5d:7c:86:24:dd:92:d5:b3:14:06: + c7:9f +-----BEGIN CERTIFICATE----- +MIIEKjCCA5OgAwIBAgIBAzANBgkqhkiG9w0BAQUFADCBnjELMAkGA1UEBhMCVVMx +CzAJBgNVBAgTAkNBMRUwEwYDVQQHEwxTYW5GcmFuY2lzY28xETAPBgNVBAoTCEV2 +aWwgSW5jMREwDwYDVQQLEwhjaGFuZ2VtZTERMA8GA1UEAxMIY2hhbmdlbWUxETAP +BgNVBCkTCGNoYW5nZW1lMR8wHQYJKoZIhvcNAQkBFhBtYWlsQGhvc3QuZG9tYWlu +MB4XDTE0MDIyODE4NDkzMVoXDTI0MDIyNjE4NDkzMVowgaMxCzAJBgNVBAYTAlVT +MQswCQYDVQQIEwJDQTEVMBMGA1UEBxMMU2FuRnJhbmNpc2NvMRUwEwYDVQQKEwxG +b3J0LUZ1bnN0b24xETAPBgNVBAsTCGNoYW5nZW1lMRIwEAYDVQQDEwlsb2NhbGhv +c3QxETAPBgNVBCkTCGNoYW5nZW1lMR8wHQYJKoZIhvcNAQkBFhBtYWlsQGhvc3Qu +ZG9tYWluMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDRCFgkYKFpZUt2Ro+I +dXxJOtgDzFtYxdG75flUuXVl3367+1TUsulvWKKkhEOUdySBODY28GZlJuVbKhQc +qa5Xf3UAIxRLYVjkgqoVl5S9UDUNXRgY7RBqu9NkWus2mFtYp/5nSMFsP1EvAmWW +VHebNPmn0mNUap4CXL5lmKS0tQIDAQABo4IBbzCCAWswCQYDVR0TBAIwADARBglg +hkgBhvhCAQEEBAMCBkAwNAYJYIZIAYb4QgENBCcWJUVhc3ktUlNBIEdlbmVyYXRl +ZCBTZXJ2ZXIgQ2VydGlmaWNhdGUwHQYDVR0OBBYEFB/gV8rLdsnEhrnqaRfA81HO +lUDsMIHTBgNVHSMEgcswgciAFNyl8XbbTs2O77EjVh2SgJl0O+pvoYGkpIGhMIGe +MQswCQYDVQQGEwJVUzELMAkGA1UECBMCQ0ExFTATBgNVBAcTDFNhbkZyYW5jaXNj +bzERMA8GA1UEChMIRXZpbCBJbmMxETAPBgNVBAsTCGNoYW5nZW1lMREwDwYDVQQD +EwhjaGFuZ2VtZTERMA8GA1UEKRMIY2hhbmdlbWUxHzAdBgkqhkiG9w0BCQEWEG1h +aWxAaG9zdC5kb21haW6CCQDnIR4YQRuWgzATBgNVHSUEDDAKBggrBgEFBQcDATAL +BgNVHQ8EBAMCBaAwDQYJKoZIhvcNAQEFBQADgYEABJMOKAGUGPCMfNMMrem3RrEw +Ze1ofIyRzRqGZodKT8CXvPeFSzh5MbJliLF2Fp6Akzj0uetlAG27ieChv5VegBOO +AXPT8QhzhaUzdQtCiqMHCTXv18ZY62CjBomgU5niqkGQ4BrSEktIfcOcrb0OXl/3 +CQxdfIYk3ZLVsxQGx58= +-----END CERTIFICATE----- diff --git a/integration-cli/fixtures/https/server-rogue-key.pem b/integration-cli/fixtures/https/server-rogue-key.pem new file mode 100644 index 0000000000..10f7c65001 --- /dev/null +++ b/integration-cli/fixtures/https/server-rogue-key.pem @@ -0,0 +1,16 @@ +-----BEGIN PRIVATE KEY----- +MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBANEIWCRgoWllS3ZG +j4h1fEk62APMW1jF0bvl+VS5dWXffrv7VNSy6W9YoqSEQ5R3JIE4NjbwZmUm5Vsq +FByprld/dQAjFEthWOSCqhWXlL1QNQ1dGBjtEGq702Ra6zaYW1in/mdIwWw/US8C +ZZZUd5s0+afSY1RqngJcvmWYpLS1AgMBAAECgYAJXh9dGfuB1qlIFqduDR3RxlJR +8UGSu+LHUeoXkuwg8aAjWoMVuSLe+5DmYIsKx0AajmNXmPRtyg1zRXJ7SltmubJ8 +6qQVDsRk6biMdkpkl6a9Gk2av40psD9/VPGxagEoop7IKYhf3AeKPvPiwVB2qFrl +1aYMZm0aMR55pgRajQJBAOk8IsJDf0beooDZXVdv/oe4hcbM9fxO8Cn3qzoGImqD +37LL+PCzDP7AEV3fk43SsZDeSk+LDX+h0o9nPyhzHasCQQDlb3aDgcQY9NaGLUWO +moOCB3148eBVcAwCocu+OSkf7sbQdvXxgThBOrZl11wwRIMQqh99c2yeUwj+tELl +3VcfAkBZTiNpCvtDIaBLge9RuZpWUXs3wec2cutWxnSTxSGMc25GQf/R+l0xdk2w +ChmvpktDUzpU9sN2aXn8WuY+EMX9AkEApbLpUbKPUELLB958RLA819TW/lkZXjrs +wZ3eSoR3ufM1rOqtVvyvBxUDE+wETWu9iHSFB5Ir2PA5J9JCGkbPmwJAFI1ndfBj +iuyU93nFX0p+JE2wVHKx4dMzKCearNKiJh/lGDtUq3REGgamTNUnG8RAITUbxFs+ +Z1hrIq8xYl2LOQ== +-----END PRIVATE KEY----- diff --git a/integration-cli/fixtures/notary/localhost.cert b/integration-cli/fixtures/notary/localhost.cert new file mode 100644 index 0000000000..d1233a1b06 --- /dev/null +++ b/integration-cli/fixtures/notary/localhost.cert @@ -0,0 +1,19 @@ +-----BEGIN CERTIFICATE----- +MIIDCTCCAfOgAwIBAgIQTOoFF+ypXwgdXnXHuCTvYDALBgkqhkiG9w0BAQswJjER +MA8GA1UEChMIUXVpY2tUTFMxETAPBgNVBAMTCFF1aWNrVExTMB4XDTE1MDcxNzE5 +NDg1M1oXDTE4MDcwMTE5NDg1M1owJzERMA8GA1UEChMIUXVpY2tUTFMxEjAQBgNV +BAMTCWxvY2FsaG9zdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMDO +qvTBAi0ApXLfe90ApJkdkRGwF838Qzt1UFSxomu5fHRV6l3FjX5XCVHiFQ4w3ROh +dMOu9NahfGLJv9VvWU2MV3YoY9Y7lIXpKwnK1v064wuls4nPh13BUWKQKofcY/e2 +qaSPd6/qmSRc/kJUvOI9jZMSX6ZRPu9K4PCqm2CivlbLq9UYuo1AbRGfuqHRvTxg +mQG7WQCzGSvSjuSg5qX3TEh0HckTczJG9ODULNRWNE7ld0W4sfv4VF8R7Uc/G7LO +8QwLCZ9TIl3gYMPCrhUL3Q6z9Jnn1SQS4mhDnPi6ugRYO1X8k3jjdxV9C2sXwUvN +OZI1rLEWl9TJNA7ZXtMCAwEAAaM2MDQwDgYDVR0PAQH/BAQDAgCgMAwGA1UdEwEB +/wQCMAAwFAYDVR0RBA0wC4IJbG9jYWxob3N0MAsGCSqGSIb3DQEBCwOCAQEAH6iq +kM2+UMukGDLEQKHHiauioWJlHDlLXv76bJiNfjSz94B/2XOQMb9PT04//tnGUyPK +K8Dx7RoxSodU6T5VRiz/A36mLOvt2t3bcL/1nHf9sAOHcexGtnCbQbW91V7RKfIL +sjiLNFDkQ9VfVNY+ynQptZoyH1sy07+dplfkIiPzRs5WuVAnEGsX3r6BrhgUITzi +g1B4kpmGZIohP4m6ZEBY5xuo/NQ0+GhjAENQMU38GpuoMyFS0i0dGcbx8weqnI/B +Er/qa0+GE/rBnWY8TiRow8dzpneSFQnUZpJ4EwD9IoOIDHo7k2Nbz2P50HMiCXZf +4RqzctVssRlrRVnO5w== +-----END CERTIFICATE----- diff --git a/integration-cli/fixtures/notary/localhost.key b/integration-cli/fixtures/notary/localhost.key new file mode 100644 index 0000000000..d7778359a3 --- /dev/null +++ b/integration-cli/fixtures/notary/localhost.key @@ -0,0 +1,27 @@ +-----BEGIN RSA PRIVATE KEY----- +MIIEogIBAAKCAQEAwM6q9MECLQClct973QCkmR2REbAXzfxDO3VQVLGia7l8dFXq +XcWNflcJUeIVDjDdE6F0w6701qF8Ysm/1W9ZTYxXdihj1juUhekrCcrW/TrjC6Wz +ic+HXcFRYpAqh9xj97appI93r+qZJFz+QlS84j2NkxJfplE+70rg8KqbYKK+Vsur +1Ri6jUBtEZ+6odG9PGCZAbtZALMZK9KO5KDmpfdMSHQdyRNzMkb04NQs1FY0TuV3 +Rbix+/hUXxHtRz8bss7xDAsJn1MiXeBgw8KuFQvdDrP0mefVJBLiaEOc+Lq6BFg7 +VfyTeON3FX0LaxfBS805kjWssRaX1Mk0Dtle0wIDAQABAoIBAHbuhNHZROhRn70O +Ui9vOBki/dt1ThnH5AkHQngb4t6kWjrAzILvW2p1cdBKr0ZDqftz+rzCbVD/5+Rg +Iq8bsnB9g23lWEBMHD/GJsAxmRA3hNooamk11IBmwTcVSsbnkdq5mEdkICYphjHC +Ey0DbEf6RBxWlx3WvAWLoNmTw6iFaOCH8IyLavPpe7kLbZc219oNUw2qjCnCXCZE +/NuViADHJBPN8r7g1gmyclJmTumdUK6oHgXEMMPe43vhReGcgcReK9QZjnTcIXPM +4oJOraw+BtoZXVvvIPnC+5ntoLFOzjIzM0kaveReZbdgffqF4zy2vRfCHhWssanc +7a0xR4ECgYEA3Xuvcqy5Xw+v/jVCO0VZj++Z7apA78dY4tWsPx5/0DUTTziTlXkC +ADduEbwX6HgZ/iLvA9j4C3Z4mO8qByby/6UoBU8NEe+PQt6fT7S+dKSP4uy5ZxVM +i5opkEyrJsMbve9Jrlj4bk5CICsydrZ+SBFHnpNGjbduGQick5LORWECgYEA3trt +gepteDGiUYmnnBgjbYtcD11RvpKC8Z/QwGnzN5vk4eBu8r7DkMcLN+SiHjAovlJo +r5j3EbF8sla1zBf/yySdQZFqUGcwtw7MaAKCLdhQl5WsViNMIx6p2OJapu0dzbv2 +KTXrnoRCafcH92k0dUX1ahE9eyc8KX6VhbWwXLMCgYATGCCuEDoC+gVAMzM8jOQF +xrBMjwr+IP+GvskUv/pg5tJ9V/FRR5dmkWDJ4p9lCUWkZTqZ6FCqHFKVTLkg2LjG +VWS34HLOAwskxrCRXJG22KEW/TWWr31j46yFpjZzJwrzOvftMfpo+BI3V8IH/f+x +EtxLzYKdoRy6x8VH67YgwQKBgHor2vjV45142FuK83AHa6SqOZXSuvWWrGJ6Ep7p +doSN2jRaLXi2S9AaznOdy6JxFGUCGJHrcccpXgsGrjNtFLXxJKTFa1sYtwQkALsk +ZOltJQF09D1krGC0driHntrUMvqOiKye+sS0DRS6cIuaCUAhUiELwoC5SaoV0zKy +IDUxAoGAOK8Xq+3/sqe79vTpw25RXl+nkAmOAeKjqf3Kh6jbnBhr81rmefyKXB9a +uj0b980tzUnliwA5cCOsyxfN2vASvMnJxFE721QZI04arlcPFHcFqCtmNnUYTcLp +0hgn/yLZptcoxpy+eTBu3eNsxz1Bu/Tx/198+2Wr3MbtGpLNIcA= +-----END RSA PRIVATE KEY----- diff --git a/integration-cli/registry.go b/integration-cli/registry.go new file mode 100644 index 0000000000..35e1b4eb9f --- /dev/null +++ b/integration-cli/registry.go @@ -0,0 +1,120 @@ +package main + +import ( + "fmt" + "io/ioutil" + "net/http" + "os" + "os/exec" + "path/filepath" + + "github.com/docker/distribution/digest" + "github.com/go-check/check" +) + +const v2binary = "registry-v2" + +type testRegistryV2 struct { + cmd *exec.Cmd + dir string +} + +func newTestRegistryV2(c *check.C) (*testRegistryV2, error) { + template := `version: 0.1 +loglevel: debug +storage: + filesystem: + rootdirectory: %s +http: + addr: %s` + tmp, err := ioutil.TempDir("", "registry-test-") + if err != nil { + return nil, err + } + confPath := filepath.Join(tmp, "config.yaml") + config, err := os.Create(confPath) + if err != nil { + return nil, err + } + if _, err := fmt.Fprintf(config, template, tmp, privateRegistryURL); err != nil { + os.RemoveAll(tmp) + return nil, err + } + + cmd := exec.Command(v2binary, confPath) + if err := cmd.Start(); err != nil { + os.RemoveAll(tmp) + if os.IsNotExist(err) { + c.Skip(err.Error()) + } + return nil, err + } + return &testRegistryV2{ + cmd: cmd, + dir: tmp, + }, nil +} + +func (t *testRegistryV2) Ping() error { + // We always ping through HTTP for our test registry. + resp, err := http.Get(fmt.Sprintf("http://%s/v2/", privateRegistryURL)) + if err != nil { + return err + } + if resp.StatusCode != 200 { + return fmt.Errorf("registry ping replied with an unexpected status code %d", resp.StatusCode) + } + return nil +} + +func (t *testRegistryV2) Close() { + t.cmd.Process.Kill() + os.RemoveAll(t.dir) +} + +func (t *testRegistryV2) getBlobFilename(blobDigest digest.Digest) string { + // Split the digest into it's algorithm and hex components. + dgstAlg, dgstHex := blobDigest.Algorithm(), blobDigest.Hex() + + // The path to the target blob data looks something like: + // baseDir + "docker/registry/v2/blobs/sha256/a3/a3ed...46d4/data" + return fmt.Sprintf("%s/docker/registry/v2/blobs/%s/%s/%s/data", t.dir, dgstAlg, dgstHex[:2], dgstHex) +} + +func (t *testRegistryV2) readBlobContents(c *check.C, blobDigest digest.Digest) []byte { + // Load the target manifest blob. + manifestBlob, err := ioutil.ReadFile(t.getBlobFilename(blobDigest)) + if err != nil { + c.Fatalf("unable to read blob: %s", err) + } + + return manifestBlob +} + +func (t *testRegistryV2) writeBlobContents(c *check.C, blobDigest digest.Digest, data []byte) { + if err := ioutil.WriteFile(t.getBlobFilename(blobDigest), data, os.FileMode(0644)); err != nil { + c.Fatalf("unable to write malicious data blob: %s", err) + } +} + +func (t *testRegistryV2) tempMoveBlobData(c *check.C, blobDigest digest.Digest) (undo func()) { + tempFile, err := ioutil.TempFile("", "registry-temp-blob-") + if err != nil { + c.Fatalf("unable to get temporary blob file: %s", err) + } + tempFile.Close() + + blobFilename := t.getBlobFilename(blobDigest) + + // Move the existing data file aside, so that we can replace it with a + // another blob of data. + if err := os.Rename(blobFilename, tempFile.Name()); err != nil { + os.Remove(tempFile.Name()) + c.Fatalf("unable to move data blob: %s", err) + } + + return func() { + os.Rename(tempFile.Name(), blobFilename) + os.Remove(tempFile.Name()) + } +} diff --git a/integration-cli/registry_mock.go b/integration-cli/registry_mock.go new file mode 100644 index 0000000000..e5fb64c184 --- /dev/null +++ b/integration-cli/registry_mock.go @@ -0,0 +1,56 @@ +package main + +import ( + "net/http" + "net/http/httptest" + "regexp" + "strings" + "sync" + + "github.com/go-check/check" +) + +type handlerFunc func(w http.ResponseWriter, r *http.Request) + +type testRegistry struct { + server *httptest.Server + hostport string + handlers map[string]handlerFunc + mu sync.Mutex +} + +func (tr *testRegistry) registerHandler(path string, h handlerFunc) { + tr.mu.Lock() + defer tr.mu.Unlock() + tr.handlers[path] = h +} + +func newTestRegistry(c *check.C) (*testRegistry, error) { + testReg := &testRegistry{handlers: make(map[string]handlerFunc)} + + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + url := r.URL.String() + + var matched bool + var err error + for re, function := range testReg.handlers { + matched, err = regexp.MatchString(re, url) + if err != nil { + c.Fatalf("Error with handler regexp") + return + } + if matched { + function(w, r) + break + } + } + + if !matched { + c.Fatal("Unable to match", url, "with regexp") + } + })) + + testReg.server = ts + testReg.hostport = strings.Replace(ts.URL, "http://", "", 1) + return testReg, nil +} diff --git a/integration-cli/requirements.go b/integration-cli/requirements.go new file mode 100644 index 0000000000..7248bc679b --- /dev/null +++ b/integration-cli/requirements.go @@ -0,0 +1,171 @@ +package main + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "log" + "net/http" + "os" + "os/exec" + "strings" + "time" + + "github.com/go-check/check" +) + +type testCondition func() bool + +type testRequirement struct { + Condition testCondition + SkipMessage string +} + +// List test requirements +var ( + daemonExecDriver string + + DaemonIsWindows = testRequirement{ + func() bool { return daemonPlatform == "windows" }, + "Test requires a Windows daemon", + } + DaemonIsLinux = testRequirement{ + func() bool { return daemonPlatform == "linux" }, + "Test requires a Linux daemon", + } + SameHostDaemon = testRequirement{ + func() bool { return isLocalDaemon }, + "Test requires docker daemon to runs on the same machine as CLI", + } + UnixCli = testRequirement{ + func() bool { return isUnixCli }, + "Test requires posix utilities or functionality to run.", + } + ExecSupport = testRequirement{ + func() bool { return supportsExec }, + "Test requires 'docker exec' capabilities on the tested daemon.", + } + Network = testRequirement{ + func() bool { + // Set a timeout on the GET at 15s + var timeout = time.Duration(15 * time.Second) + var url = "https://hub.docker.com" + + client := http.Client{ + Timeout: timeout, + } + + resp, err := client.Get(url) + if err != nil && strings.Contains(err.Error(), "use of closed network connection") { + panic(fmt.Sprintf("Timeout for GET request on %s", url)) + } + if resp != nil { + resp.Body.Close() + } + return err == nil + }, + "Test requires network availability, environment variable set to none to run in a non-network enabled mode.", + } + Apparmor = testRequirement{ + func() bool { + buf, err := ioutil.ReadFile("/sys/module/apparmor/parameters/enabled") + return err == nil && len(buf) > 1 && buf[0] == 'Y' + }, + "Test requires apparmor is enabled.", + } + RegistryHosting = testRequirement{ + func() bool { + // for now registry binary is built only if we're running inside + // container through `make test`. Figure that out by testing if + // registry binary is in PATH. + _, err := exec.LookPath(v2binary) + return err == nil + }, + fmt.Sprintf("Test requires an environment that can host %s in the same host", v2binary), + } + NotaryHosting = testRequirement{ + func() bool { + // for now notary binary is built only if we're running inside + // container through `make test`. Figure that out by testing if + // notary-server binary is in PATH. + _, err := exec.LookPath(notaryBinary) + return err == nil + }, + fmt.Sprintf("Test requires an environment that can host %s in the same host", notaryBinary), + } + NativeExecDriver = testRequirement{ + func() bool { + if daemonExecDriver == "" { + // get daemon info + status, body, err := sockRequest("GET", "/info", nil) + if err != nil || status != http.StatusOK { + log.Fatalf("sockRequest failed for /info: %v", err) + } + + type infoJSON struct { + ExecutionDriver string + } + var info infoJSON + if err = json.Unmarshal(body, &info); err != nil { + log.Fatalf("unable to unmarshal body: %v", err) + } + + daemonExecDriver = info.ExecutionDriver + } + + return strings.HasPrefix(daemonExecDriver, "native") + }, + "Test requires the native (libcontainer) exec driver.", + } + NotOverlay = testRequirement{ + func() bool { + cmd := exec.Command("grep", "^overlay / overlay", "/proc/mounts") + if err := cmd.Run(); err != nil { + return true + } + return false + }, + "Test requires underlying root filesystem not be backed by overlay.", + } + IPv6 = testRequirement{ + func() bool { + cmd := exec.Command("test", "-f", "/proc/net/if_inet6") + + if err := cmd.Run(); err != nil { + return true + } + return false + }, + "Test requires support for IPv6", + } + NotGCCGO = testRequirement{ + func() bool { + out, err := exec.Command("go", "version").Output() + if err != nil && strings.Contains(string(out), "gccgo") { + return true + } + return false + }, + "Test requires native Golang compiler instead of GCCGO", + } + NotUserNamespace = testRequirement{ + func() bool { + root := os.Getenv("DOCKER_REMAP_ROOT") + if root != "" { + return false + } + return true + }, + "Test cannot be run when remapping root", + } +) + +// testRequires checks if the environment satisfies the requirements +// for the test to run or skips the tests. +func testRequires(c *check.C, requirements ...testRequirement) { + for _, r := range requirements { + if !r.Condition() { + c.Skip(r.SkipMessage) + } + } +} diff --git a/integration-cli/requirements_unix.go b/integration-cli/requirements_unix.go new file mode 100644 index 0000000000..72c396f3a7 --- /dev/null +++ b/integration-cli/requirements_unix.go @@ -0,0 +1,82 @@ +// +build !windows + +package main + +import ( + "github.com/docker/docker/pkg/sysinfo" +) + +var ( + // SysInfo stores information about which features a kernel supports. + SysInfo *sysinfo.SysInfo + cpuCfsPeriod = testRequirement{ + func() bool { + return SysInfo.CPUCfsPeriod + }, + "Test requires an environment that supports cgroup cfs period.", + } + cpuCfsQuota = testRequirement{ + func() bool { + return SysInfo.CPUCfsQuota + }, + "Test requires an environment that supports cgroup cfs quota.", + } + cpuShare = testRequirement{ + func() bool { + return SysInfo.CPUShares + }, + "Test requires an environment that supports cgroup cpu shares.", + } + oomControl = testRequirement{ + func() bool { + return SysInfo.OomKillDisable + }, + "Test requires Oom control enabled.", + } + kernelMemorySupport = testRequirement{ + func() bool { + return SysInfo.KernelMemory + }, + "Test requires an environment that supports cgroup kernel memory.", + } + memoryLimitSupport = testRequirement{ + func() bool { + return SysInfo.MemoryLimit + }, + "Test requires an environment that supports cgroup memory limit.", + } + memoryReservationSupport = testRequirement{ + func() bool { + return SysInfo.MemoryReservation + }, + "Test requires an environment that supports cgroup memory reservation.", + } + swapMemorySupport = testRequirement{ + func() bool { + return SysInfo.SwapLimit + }, + "Test requires an environment that supports cgroup swap memory limit.", + } + memorySwappinessSupport = testRequirement{ + func() bool { + return SysInfo.MemorySwappiness + }, + "Test requires an environment that supports cgroup memory swappiness.", + } + blkioWeight = testRequirement{ + func() bool { + return SysInfo.BlkioWeight + }, + "Test requires an environment that supports blkio weight.", + } + cgroupCpuset = testRequirement{ + func() bool { + return SysInfo.Cpuset + }, + "Test requires an environment that supports cgroup cpuset.", + } +) + +func init() { + SysInfo = sysinfo.New(true) +} diff --git a/integration-cli/test_vars_exec.go b/integration-cli/test_vars_exec.go new file mode 100644 index 0000000000..7633b346ba --- /dev/null +++ b/integration-cli/test_vars_exec.go @@ -0,0 +1,8 @@ +// +build !test_no_exec + +package main + +const ( + // indicates docker daemon tested supports 'docker exec' + supportsExec = true +) diff --git a/integration-cli/test_vars_noexec.go b/integration-cli/test_vars_noexec.go new file mode 100644 index 0000000000..0845090524 --- /dev/null +++ b/integration-cli/test_vars_noexec.go @@ -0,0 +1,8 @@ +// +build test_no_exec + +package main + +const ( + // indicates docker daemon tested supports 'docker exec' + supportsExec = false +) diff --git a/integration-cli/test_vars_unix.go b/integration-cli/test_vars_unix.go new file mode 100644 index 0000000000..1ab8a5ca48 --- /dev/null +++ b/integration-cli/test_vars_unix.go @@ -0,0 +1,10 @@ +// +build !windows + +package main + +const ( + // identifies if test suite is running on a unix platform + isUnixCli = true + + expectedFileChmod = "-rw-r--r--" +) diff --git a/integration-cli/test_vars_windows.go b/integration-cli/test_vars_windows.go new file mode 100644 index 0000000000..f81ac53cc3 --- /dev/null +++ b/integration-cli/test_vars_windows.go @@ -0,0 +1,11 @@ +// +build windows + +package main + +const ( + // identifies if test suite is running on a unix platform + isUnixCli = false + + // this is the expected file permission set on windows: gh#11395 + expectedFileChmod = "-rwxr-xr-x" +) diff --git a/integration-cli/trust_server.go b/integration-cli/trust_server.go new file mode 100644 index 0000000000..363adb4572 --- /dev/null +++ b/integration-cli/trust_server.go @@ -0,0 +1,177 @@ +package main + +import ( + "fmt" + "io/ioutil" + "net" + "net/http" + "os" + "os/exec" + "path/filepath" + "strings" + "time" + + "github.com/docker/docker/pkg/tlsconfig" + "github.com/go-check/check" +) + +var notaryBinary = "notary-server" + +type testNotary struct { + cmd *exec.Cmd + dir string +} + +const notaryHost = "localhost:4443" +const notaryURL = "https://" + notaryHost + +func newTestNotary(c *check.C) (*testNotary, error) { + template := `{ + "server": { + "addr": "%s", + "tls_key_file": "fixtures/notary/localhost.key", + "tls_cert_file": "fixtures/notary/localhost.cert" + }, + "trust_service": { + "type": "local", + "hostname": "", + "port": "", + "key_algorithm": "ed25519" + }, + "logging": { + "level": 5 + } +}` + tmp, err := ioutil.TempDir("", "notary-test-") + if err != nil { + return nil, err + } + confPath := filepath.Join(tmp, "config.json") + config, err := os.Create(confPath) + if err != nil { + return nil, err + } + if _, err := fmt.Fprintf(config, template, notaryHost); err != nil { + os.RemoveAll(tmp) + return nil, err + } + + cmd := exec.Command(notaryBinary, "-config", confPath) + if err := cmd.Start(); err != nil { + os.RemoveAll(tmp) + if os.IsNotExist(err) { + c.Skip(err.Error()) + } + return nil, err + } + + testNotary := &testNotary{ + cmd: cmd, + dir: tmp, + } + + // Wait for notary to be ready to serve requests. + for i := 1; i <= 5; i++ { + if err = testNotary.Ping(); err == nil { + break + } + time.Sleep(10 * time.Millisecond * time.Duration(i*i)) + } + + if err != nil { + c.Fatalf("Timeout waiting for test notary to become available: %s", err) + } + + return testNotary, nil +} + +func (t *testNotary) Ping() error { + tlsConfig := tlsconfig.ClientDefault + tlsConfig.InsecureSkipVerify = true + client := http.Client{ + Transport: &http.Transport{ + Proxy: http.ProxyFromEnvironment, + Dial: (&net.Dialer{ + Timeout: 30 * time.Second, + KeepAlive: 30 * time.Second, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, + TLSClientConfig: &tlsConfig, + }, + } + resp, err := client.Get(fmt.Sprintf("%s/v2/", notaryURL)) + if err != nil { + return err + } + if resp.StatusCode != 200 { + return fmt.Errorf("notary ping replied with an unexpected status code %d", resp.StatusCode) + } + return nil +} + +func (t *testNotary) Close() { + t.cmd.Process.Kill() + os.RemoveAll(t.dir) +} + +func (s *DockerTrustSuite) trustedCmd(cmd *exec.Cmd) { + pwd := "12345678" + trustCmdEnv(cmd, notaryURL, pwd, pwd) +} + +func (s *DockerTrustSuite) trustedCmdWithServer(cmd *exec.Cmd, server string) { + pwd := "12345678" + trustCmdEnv(cmd, server, pwd, pwd) +} + +func (s *DockerTrustSuite) trustedCmdWithPassphrases(cmd *exec.Cmd, rootPwd, repositoryPwd string) { + trustCmdEnv(cmd, notaryURL, rootPwd, repositoryPwd) +} + +func (s *DockerTrustSuite) trustedCmdWithDeprecatedEnvPassphrases(cmd *exec.Cmd, offlinePwd, taggingPwd string) { + trustCmdDeprecatedEnv(cmd, notaryURL, offlinePwd, taggingPwd) +} + +func trustCmdEnv(cmd *exec.Cmd, server, rootPwd, repositoryPwd string) { + env := []string{ + "DOCKER_CONTENT_TRUST=1", + fmt.Sprintf("DOCKER_CONTENT_TRUST_SERVER=%s", server), + fmt.Sprintf("DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE=%s", rootPwd), + fmt.Sprintf("DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE=%s", repositoryPwd), + } + cmd.Env = append(os.Environ(), env...) +} + +// Helper method to test the old env variables OFFLINE and TAGGING that will +// be deprecated by 1.10 +func trustCmdDeprecatedEnv(cmd *exec.Cmd, server, offlinePwd, taggingPwd string) { + env := []string{ + "DOCKER_CONTENT_TRUST=1", + fmt.Sprintf("DOCKER_CONTENT_TRUST_SERVER=%s", server), + fmt.Sprintf("DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE=%s", offlinePwd), + fmt.Sprintf("DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE=%s", taggingPwd), + } + cmd.Env = append(os.Environ(), env...) +} + +func (s *DockerTrustSuite) setupTrustedImage(c *check.C, name string) string { + repoName := fmt.Sprintf("%v/dockercli/%s:latest", privateRegistryURL, name) + // tag the image and upload it to the private registry + dockerCmd(c, "tag", "busybox", repoName) + + pushCmd := exec.Command(dockerBinary, "push", repoName) + s.trustedCmd(pushCmd) + out, _, err := runCommandWithOutput(pushCmd) + if err != nil { + c.Fatalf("Error running trusted push: %s\n%s", err, out) + } + if !strings.Contains(string(out), "Signing and pushing trust metadata") { + c.Fatalf("Missing expected output on trusted push:\n%s", out) + } + + if out, status := dockerCmd(c, "rmi", repoName); status != 0 { + c.Fatalf("Error removing image %q\n%s", repoName, out) + } + + return repoName +} diff --git a/integration-cli/utils.go b/integration-cli/utils.go new file mode 100644 index 0000000000..b24cce3f16 --- /dev/null +++ b/integration-cli/utils.go @@ -0,0 +1,78 @@ +package main + +import ( + "io" + "os" + "os/exec" + "time" + + "github.com/docker/docker/pkg/integration" +) + +func getExitCode(err error) (int, error) { + return integration.GetExitCode(err) +} + +func processExitCode(err error) (exitCode int) { + return integration.ProcessExitCode(err) +} + +func isKilled(err error) bool { + return integration.IsKilled(err) +} + +func runCommandWithOutput(cmd *exec.Cmd) (output string, exitCode int, err error) { + return integration.RunCommandWithOutput(cmd) +} + +func runCommandWithStdoutStderr(cmd *exec.Cmd) (stdout string, stderr string, exitCode int, err error) { + return integration.RunCommandWithStdoutStderr(cmd) +} + +func runCommandWithOutputForDuration(cmd *exec.Cmd, duration time.Duration) (output string, exitCode int, timedOut bool, err error) { + return integration.RunCommandWithOutputForDuration(cmd, duration) +} + +func runCommandWithOutputAndTimeout(cmd *exec.Cmd, timeout time.Duration) (output string, exitCode int, err error) { + return integration.RunCommandWithOutputAndTimeout(cmd, timeout) +} + +func runCommand(cmd *exec.Cmd) (exitCode int, err error) { + return integration.RunCommand(cmd) +} + +func runCommandPipelineWithOutput(cmds ...*exec.Cmd) (output string, exitCode int, err error) { + return integration.RunCommandPipelineWithOutput(cmds...) +} + +func unmarshalJSON(data []byte, result interface{}) error { + return integration.UnmarshalJSON(data, result) +} + +func convertSliceOfStringsToMap(input []string) map[string]struct{} { + return integration.ConvertSliceOfStringsToMap(input) +} + +func compareDirectoryEntries(e1 []os.FileInfo, e2 []os.FileInfo) error { + return integration.CompareDirectoryEntries(e1, e2) +} + +func listTar(f io.Reader) ([]string, error) { + return integration.ListTar(f) +} + +func randomTmpDirPath(s string, platform string) string { + return integration.RandomTmpDirPath(s, platform) +} + +func consumeWithSpeed(reader io.Reader, chunkSize int, interval time.Duration, stop chan bool) (n int, err error) { + return integration.ConsumeWithSpeed(reader, chunkSize, interval, stop) +} + +func parseCgroupPaths(procCgroupData string) map[string]string { + return integration.ParseCgroupPaths(procCgroupData) +} + +func runAtDifferentDate(date time.Time, block func()) { + integration.RunAtDifferentDate(date, block) +} diff --git a/man/Dockerfile b/man/Dockerfile new file mode 100644 index 0000000000..af2319524b --- /dev/null +++ b/man/Dockerfile @@ -0,0 +1,7 @@ +FROM golang:1.4 +RUN mkdir -p /go/src/github.com/cpuguy83 +RUN mkdir -p /go/src/github.com/cpuguy83 \ + && git clone -b v1.0.3 https://github.com/cpuguy83/go-md2man.git /go/src/github.com/cpuguy83/go-md2man \ + && cd /go/src/github.com/cpuguy83/go-md2man \ + && go get -v ./... +CMD ["/go/bin/go-md2man", "--help"] diff --git a/man/Dockerfile.5.md b/man/Dockerfile.5.md new file mode 100644 index 0000000000..c5e5bea518 --- /dev/null +++ b/man/Dockerfile.5.md @@ -0,0 +1,469 @@ +% DOCKERFILE(5) Docker User Manuals +% Zac Dover +% May 2014 +# NAME + +Dockerfile - automate the steps of creating a Docker image + +# INTRODUCTION + +The **Dockerfile** is a configuration file that automates the steps of creating +a Docker image. It is similar to a Makefile. Docker reads instructions from the +**Dockerfile** to automate the steps otherwise performed manually to create an +image. To build an image, create a file called **Dockerfile**. + +The **Dockerfile** describes the steps taken to assemble the image. When the +**Dockerfile** has been created, call the `docker build` command, using the +path of directory that contains **Dockerfile** as the argument. + +# SYNOPSIS + +INSTRUCTION arguments + +For example: + + FROM image + +# DESCRIPTION + +A Dockerfile is a file that automates the steps of creating a Docker image. +A Dockerfile is similar to a Makefile. + +# USAGE + + docker build . + + -- Runs the steps and commits them, building a final image. + The path to the source repository defines where to find the context of the + build. The build is run by the Docker daemon, not the CLI. The whole + context must be transferred to the daemon. The Docker CLI reports + `"Sending build context to Docker daemon"` when the context is sent to the + daemon. + + ``` + docker build -t repository/tag . + ``` + + -- specifies a repository and tag at which to save the new image if the build + succeeds. The Docker daemon runs the steps one-by-one, committing the result + to a new image if necessary, before finally outputting the ID of the new + image. The Docker daemon automatically cleans up the context it is given. + + Docker re-uses intermediate images whenever possible. This significantly + accelerates the *docker build* process. + +# FORMAT + + `FROM image` + + `FROM image:tag` + + `FROM image@digest` + + -- The **FROM** instruction sets the base image for subsequent instructions. A + valid Dockerfile must have **FROM** as its first instruction. The image can be any + valid image. It is easy to start by pulling an image from the public + repositories. + + -- **FROM** must be the first non-comment instruction in Dockerfile. + + -- **FROM** may appear multiple times within a single Dockerfile in order to create + multiple images. Make a note of the last image ID output by the commit before + each new **FROM** command. + + -- If no tag is given to the **FROM** instruction, Docker applies the + `latest` tag. If the used tag does not exist, an error is returned. + + -- If no digest is given to the **FROM** instruction, Docker applies the + `latest` tag. If the used tag does not exist, an error is returned. + +**MAINTAINER** + -- **MAINTAINER** sets the Author field for the generated images. + Useful for providing users with an email or url for support. + +**RUN** + -- **RUN** has two forms: + + ``` + # the command is run in a shell - /bin/sh -c + RUN + + # Executable form + RUN ["executable", "param1", "param2"] + ``` + + + -- The **RUN** instruction executes any commands in a new layer on top of the current + image and commits the results. The committed image is used for the next step in + Dockerfile. + + -- Layering **RUN** instructions and generating commits conforms to the core + concepts of Docker where commits are cheap and containers can be created from + any point in the history of an image. This is similar to source control. The + exec form makes it possible to avoid shell string munging. The exec form makes + it possible to **RUN** commands using a base image that does not contain `/bin/sh`. + + Note that the exec form is parsed as a JSON array, which means that you must + use double-quotes (") around words not single-quotes ('). + +**CMD** + -- **CMD** has three forms: + + ``` + # Executable form + CMD ["executable", "param1", "param2"]` + + # Provide default arguments to ENTRYPOINT + CMD ["param1", "param2"]` + + # the command is run in a shell - /bin/sh -c + CMD command param1 param2 + ``` + + -- There should be only one **CMD** in a Dockerfile. If more than one **CMD** is listed, only + the last **CMD** takes effect. + The main purpose of a **CMD** is to provide defaults for an executing container. + These defaults may include an executable, or they can omit the executable. If + they omit the executable, an **ENTRYPOINT** must be specified. + When used in the shell or exec formats, the **CMD** instruction sets the command to + be executed when running the image. + If you use the shell form of the **CMD**, the `` executes in `/bin/sh -c`: + + Note that the exec form is parsed as a JSON array, which means that you must + use double-quotes (") around words not single-quotes ('). + + ``` + FROM ubuntu + CMD echo "This is a test." | wc - + ``` + + -- If you run **command** without a shell, then you must express the command as a + JSON array and give the full path to the executable. This array form is the + preferred form of **CMD**. All additional parameters must be individually expressed + as strings in the array: + + ``` + FROM ubuntu + CMD ["/usr/bin/wc","--help"] + ``` + + -- To make the container run the same executable every time, use **ENTRYPOINT** in + combination with **CMD**. + If the user specifies arguments to `docker run`, the specified commands + override the default in **CMD**. + Do not confuse **RUN** with **CMD**. **RUN** runs a command and commits the result. + **CMD** executes nothing at build time, but specifies the intended command for + the image. + +**LABEL** + -- `LABEL [=] [[=] ...]`or + ``` + LABEL [ ] + LABEL [ ] + ... + ``` + The **LABEL** instruction adds metadata to an image. A **LABEL** is a + key-value pair. To include spaces within a **LABEL** value, use quotes and + backslashes as you would in command-line parsing. + + ``` + LABEL com.example.vendor="ACME Incorporated" + or + LABEL com.example.vendor "ACME Incorporated" + ``` + + An image can have more than one label. To specify multiple labels, separate + each key-value pair by a space. + + Labels are additive including `LABEL`s in `FROM` images. As the system + encounters and then applies a new label, new `key`s override any previous + labels with identical keys. + + To display an image's labels, use the `docker inspect` command. + +**EXPOSE** + -- `EXPOSE [...]` + The **EXPOSE** instruction informs Docker that the container listens on the + specified network ports at runtime. Docker uses this information to + interconnect containers using links and to set up port redirection on the host + system. + +**ENV** + -- `ENV ` + The **ENV** instruction sets the environment variable to + the value ``. This value is passed to all future + **RUN**, **ENTRYPOINT**, and **CMD** instructions. This is + functionally equivalent to prefixing the command with `=`. The + environment variables that are set with **ENV** persist when a container is run + from the resulting image. Use `docker inspect` to inspect these values, and + change them using `docker run --env =`. + + Note that setting "`ENV DEBIAN_FRONTEND noninteractive`" may cause + unintended consequences, because it will persist when the container is run + interactively, as with the following command: `docker run -t -i image bash` + +**ADD** + -- **ADD** has two forms: + + ``` + ADD + + # Required for paths with whitespace + ADD ["",... ""] + ``` + + The **ADD** instruction copies new files, directories + or remote file URLs to the filesystem of the container at path ``. + Multiple `` resources may be specified but if they are files or directories + then they must be relative to the source directory that is being built + (the context of the build). The `` is the absolute path, or path relative + to **WORKDIR**, into which the source is copied inside the target container. + If the `` argument is a local file in a recognized compression format + (tar, gzip, bzip2, etc) then it is unpacked at the specified `` in the + container's filesystem. Note that only local compressed files will be unpacked, + i.e., the URL download and archive unpacking features cannot be used together. + All new directories are created with mode 0755 and with the uid and gid of **0**. + +**COPY** + -- **COPY** has two forms: + + ``` + COPY + + # Required for paths with whitespace + COPY ["",... ""] + ``` + + The **COPY** instruction copies new files from `` and + adds them to the filesystem of the container at path . The `` must be + the path to a file or directory relative to the source directory that is + being built (the context of the build) or a remote file URL. The `` is an + absolute path, or a path relative to **WORKDIR**, into which the source will + be copied inside the target container. If you **COPY** an archive file it will + land in the container exactly as it appears in the build context without any + attempt to unpack it. All new files and directories are created with mode **0755** + and with the uid and gid of **0**. + +**ENTRYPOINT** + -- **ENTRYPOINT** has two forms: + + ``` + # executable form + ENTRYPOINT ["executable", "param1", "param2"]` + + # run command in a shell - /bin/sh -c + ENTRYPOINT command param1 param2 + ``` + + -- An **ENTRYPOINT** helps you configure a + container that can be run as an executable. When you specify an **ENTRYPOINT**, + the whole container runs as if it was only that executable. The **ENTRYPOINT** + instruction adds an entry command that is not overwritten when arguments are + passed to docker run. This is different from the behavior of **CMD**. This allows + arguments to be passed to the entrypoint, for instance `docker run -d` + passes the -d argument to the **ENTRYPOINT**. Specify parameters either in the + **ENTRYPOINT** JSON array (as in the preferred exec form above), or by using a **CMD** + statement. Parameters in the **ENTRYPOINT** are not overwritten by the docker run + arguments. Parameters specified via **CMD** are overwritten by docker run + arguments. Specify a plain string for the **ENTRYPOINT**, and it will execute in + `/bin/sh -c`, like a **CMD** instruction: + + ``` + FROM ubuntu + ENTRYPOINT wc -l - + ``` + + This means that the Dockerfile's image always takes stdin as input (that's + what "-" means), and prints the number of lines (that's what "-l" means). To + make this optional but default, use a **CMD**: + + ``` + FROM ubuntu + CMD ["-l", "-"] + ENTRYPOINT ["/usr/bin/wc"] + ``` + +**VOLUME** + -- `VOLUME ["/data"]` + The **VOLUME** instruction creates a mount point with the specified name and marks + it as holding externally-mounted volumes from the native host or from other + containers. + +**USER** + -- `USER daemon` + Sets the username or UID used for running subsequent commands. + + The **USER** instruction can optionally be used to set the group or GID. The + followings examples are all valid: + USER [user | user:group | uid | uid:gid | user:gid | uid:group ] + + Until the **USER** instruction is set, instructions will be run as root. The USER + instruction can be used any number of times in a Dockerfile, and will only affect + subsequent commands. + +**WORKDIR** + -- `WORKDIR /path/to/workdir` + The **WORKDIR** instruction sets the working directory for the **RUN**, **CMD**, + **ENTRYPOINT**, **COPY** and **ADD** Dockerfile commands that follow it. It can + be used multiple times in a single Dockerfile. Relative paths are defined + relative to the path of the previous **WORKDIR** instruction. For example: + + ``` + WORKDIR /a + WORKDIR b + WORKDIR c + RUN pwd + ``` + + In the above example, the output of the **pwd** command is **a/b/c**. + +**ARG** + -- ARG [=] + + The `ARG` instruction defines a variable that users can pass at build-time to + the builder with the `docker build` command using the `--build-arg + =` flag. If a user specifies a build argument that was not + defined in the Dockerfile, the build outputs an error. + + ``` + One or more build-args were not consumed, failing build. + ``` + + The Dockerfile author can define a single variable by specifying `ARG` once or many + variables by specifying `ARG` more than once. For example, a valid Dockerfile: + + ``` + FROM busybox + ARG user1 + ARG buildno + ... + ``` + + A Dockerfile author may optionally specify a default value for an `ARG` instruction: + + ``` + FROM busybox + ARG user1=someuser + ARG buildno=1 + ... + ``` + + If an `ARG` value has a default and if there is no value passed at build-time, the + builder uses the default. + + An `ARG` variable definition comes into effect from the line on which it is + defined in the `Dockerfile` not from the argument's use on the command-line or + elsewhere. For example, consider this Dockerfile: + + ``` + 1 FROM busybox + 2 USER ${user:-some_user} + 3 ARG user + 4 USER $user + ... + ``` + A user builds this file by calling: + + ``` + $ docker build --build-arg user=what_user Dockerfile + ``` + + The `USER` at line 2 evaluates to `some_user` as the `user` variable is defined on the + subsequent line 3. The `USER` at line 4 evaluates to `what_user` as `user` is + defined and the `what_user` value was passed on the command line. Prior to its definition by an + `ARG` instruction, any use of a variable results in an empty string. + + > **Note:** It is not recommended to use build-time variables for + > passing secrets like github keys, user credentials etc. + + You can use an `ARG` or an `ENV` instruction to specify variables that are + available to the `RUN` instruction. Environment variables defined using the + `ENV` instruction always override an `ARG` instruction of the same name. Consider + this Dockerfile with an `ENV` and `ARG` instruction. + + ``` + 1 FROM ubuntu + 2 ARG CONT_IMG_VER + 3 ENV CONT_IMG_VER v1.0.0 + 4 RUN echo $CONT_IMG_VER + ``` + Then, assume this image is built with this command: + + ``` + $ docker build --build-arg CONT_IMG_VER=v2.0.1 Dockerfile + ``` + + In this case, the `RUN` instruction uses `v1.0.0` instead of the `ARG` setting + passed by the user:`v2.0.1` This behavior is similar to a shell + script where a locally scoped variable overrides the variables passed as + arguments or inherited from environment, from its point of definition. + + Using the example above but a different `ENV` specification you can create more + useful interactions between `ARG` and `ENV` instructions: + + ``` + 1 FROM ubuntu + 2 ARG CONT_IMG_VER + 3 ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0} + 4 RUN echo $CONT_IMG_VER + ``` + + Unlike an `ARG` instruction, `ENV` values are always persisted in the built + image. Consider a docker build without the --build-arg flag: + + ``` + $ docker build Dockerfile + ``` + + Using this Dockerfile example, `CONT_IMG_VER` is still persisted in the image but + its value would be `v1.0.0` as it is the default set in line 3 by the `ENV` instruction. + + The variable expansion technique in this example allows you to pass arguments + from the command line and persist them in the final image by leveraging the + `ENV` instruction. Variable expansion is only supported for [a limited set of + Dockerfile instructions.](#environment-replacement) + + Docker has a set of predefined `ARG` variables that you can use without a + corresponding `ARG` instruction in the Dockerfile. + + * `HTTP_PROXY` + * `http_proxy` + * `HTTPS_PROXY` + * `https_proxy` + * `FTP_PROXY` + * `ftp_proxy` + * `NO_PROXY` + * `no_proxy` + + To use these, simply pass them on the command line using the `--build-arg + =` flag. + +**ONBUILD** + -- `ONBUILD [INSTRUCTION]` + The **ONBUILD** instruction adds a trigger instruction to an image. The + trigger is executed at a later time, when the image is used as the base for + another build. Docker executes the trigger in the context of the downstream + build, as if the trigger existed immediately after the **FROM** instruction in + the downstream Dockerfile. + + You can register any build instruction as a trigger. A trigger is useful if + you are defining an image to use as a base for building other images. For + example, if you are defining an application build environment or a daemon that + is customized with a user-specific configuration. + + Consider an image intended as a reusable python application builder. It must + add application source code to a particular directory, and might need a build + script called after that. You can't just call **ADD** and **RUN** now, because + you don't yet have access to the application source code, and it is different + for each application build. + + -- Providing application developers with a boilerplate Dockerfile to copy-paste + into their application is inefficient, error-prone, and + difficult to update because it mixes with application-specific code. + The solution is to use **ONBUILD** to register instructions in advance, to + run later, during the next build stage. + +# HISTORY +*May 2014, Compiled by Zac Dover (zdover at redhat dot com) based on docker.com Dockerfile documentation. +*Feb 2015, updated by Brian Goff (cpuguy83@gmail.com) for readability +*Sept 2015, updated by Sally O'Malley (somalley@redhat.com) diff --git a/man/README.md b/man/README.md new file mode 100644 index 0000000000..922bc3cc74 --- /dev/null +++ b/man/README.md @@ -0,0 +1,33 @@ +Docker Documentation +==================== + +This directory contains the Docker user manual in the Markdown format. +Do *not* edit the man pages in the man1 directory. Instead, amend the +Markdown (*.md) files. + +# Generating man pages from the Markdown files + +The recommended approach for generating the man pages is via a Docker +container using the supplied `Dockerfile` to create an image with the correct +environment. This uses `go-md2man`, a pure Go Markdown to man page generator. + +## Building the md2man image + +There is a `Dockerfile` provided in the `/man` directory of your +'docker/docker' fork. + +Using this `Dockerfile`, create a Docker image tagged `docker/md2man`: + + docker build -t docker/md2man . + +## Utilizing the image + +From within the `/man` directory run the following command: + + docker run -v $(pwd):/man -w /man -i docker/md2man ./md2man-all.sh + +The `md2man` Docker container will process the Markdown files and generate +the man pages inside the `/man/man1` directory of your fork using +Docker volumes. For more information on Docker volumes see the man page for +`docker run` and also look at the article [Sharing Directories via Volumes] +(https://docs.docker.com/use/working_with_volumes/). diff --git a/man/docker-attach.1.md b/man/docker-attach.1.md new file mode 100644 index 0000000000..96fb3756a3 --- /dev/null +++ b/man/docker-attach.1.md @@ -0,0 +1,70 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-attach - Attach to a running container + +# SYNOPSIS +**docker attach** +[**--help**] +[**--no-stdin**[=*false*]] +[**--sig-proxy**[=*true*]] +CONTAINER + +# DESCRIPTION +The **docker attach** command allows you to attach to a running container using +the container's ID or name, either to view its ongoing output or to control it +interactively. You can attach to the same contained process multiple times +simultaneously, screen sharing style, or quickly view the progress of your +detached process. + +You can detach from the container (and leave it running) with `CTRL-p CTRL-q` +(for a quiet exit) or `CTRL-c` which will send a `SIGKILL` to the container. +When you are attached to a container, and exit its main process, the process's +exit code will be returned to the client. + +It is forbidden to redirect the standard input of a `docker attach` command while +attaching to a tty-enabled container (i.e.: launched with `-t`). + +# OPTIONS +**--help** + Print usage statement + +**--no-stdin**=*true*|*false* + Do not attach STDIN. The default is *false*. + +**--sig-proxy**=*true*|*false* + Proxy all received signals to the process (non-TTY mode only). SIGCHLD, SIGKILL, and SIGSTOP are not proxied. The default is *true*. + +# EXAMPLES + +## Attaching to a container + +In this example the top command is run inside a container, from an image called +fedora, in detached mode. The ID from the container is passed into the **docker +attach** command: + + # ID=$(sudo docker run -d fedora /usr/bin/top -b) + # sudo docker attach $ID + top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355560k used, 18012k free, 27872k buffers + Swap: 786428k total, 0k used, 786428k free, 221740k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17200 1116 912 R 0 0.3 0:00.03 top + + top - 02:05:55 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.0%us, 0.2%sy, 0.0%ni, 99.8%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355244k used, 18328k free, 27872k buffers + Swap: 786428k total, 0k used, 786428k free, 221776k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-build.1.md b/man/docker-build.1.md new file mode 100644 index 0000000000..876d6fa9bb --- /dev/null +++ b/man/docker-build.1.md @@ -0,0 +1,270 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-build - Build a new image from the source code at PATH + +# SYNOPSIS +**docker build** +[**--build-arg**[=*[]*]] +[**--cpu-shares**[=*0*]] +[**--cgroup-parent**[=*CGROUP-PARENT*]] +[**--help**] +[**-f**|**--file**[=*PATH/Dockerfile*]] +[**--force-rm**[=*false*]] +[**--no-cache**[=*false*]] +[**--pull**[=*false*]] +[**-q**|**--quiet**[=*false*]] +[**--rm**[=*true*]] +[**-t**|**--tag**[=*TAG*]] +[**-m**|**--memory**[=*MEMORY*]] +[**--memory-swap**[=*MEMORY-SWAP*]] +[**--cpu-period**[=*0*]] +[**--cpu-quota**[=*0*]] +[**--cpuset-cpus**[=*CPUSET-CPUS*]] +[**--cpuset-mems**[=*CPUSET-MEMS*]] +[**--ulimit**[=*[]*]] +PATH | URL | - + +# DESCRIPTION +This will read the Dockerfile from the directory specified in **PATH**. +It also sends any other files and directories found in the current +directory to the Docker daemon. The contents of this directory would +be used by **ADD** commands found within the Dockerfile. + +Warning, this will send a lot of data to the Docker daemon depending +on the contents of the current directory. The build is run by the Docker +daemon, not by the CLI, so the whole context must be transferred to the daemon. +The Docker CLI reports "Sending build context to Docker daemon" when the context is sent to +the daemon. + +When the URL to a tarball archive or to a single Dockerfile is given, no context is sent from +the client to the Docker daemon. In this case, the Dockerfile at the root of the archive and +the rest of the archive will get used as the context of the build. When a Git repository is +set as the **URL**, the repository is cloned locally and then sent as the context. + +# OPTIONS +**-f**, **--file**=*PATH/Dockerfile* + Path to the Dockerfile to use. If the path is a relative path and you are + building from a local directory, then the path must be relative to that + directory. If you are building from a remote URL pointing to either a + tarball or a Git repository, then the path must be relative to the root of + the remote context. In all cases, the file must be within the build context. + The default is *Dockerfile*. + +**--build-arg**=*variable* + name and value of a **buildarg**. + + For example, if you want to pass a value for `http_proxy`, use + `--build-arg=http_proxy="http://some.proxy.url"` + + Users pass these values at build-time. Docker uses the `buildargs` as the + environment context for command(s) run via the Dockerfile's `RUN` instruction + or for variable expansion in other Dockerfile instructions. This is not meant + for passing secret values. [Read more about the buildargs instruction](/reference/builder/#arg) + +**--force-rm**=*true*|*false* + Always remove intermediate containers, even after unsuccessful builds. The default is *false*. + +**--no-cache**=*true*|*false* + Do not use cache when building the image. The default is *false*. + +**--help** + Print usage statement + +**--pull**=*true*|*false* + Always attempt to pull a newer version of the image. The default is *false*. + +**-q**, **--quiet**=*true*|*false* + Suppress the verbose output generated by the containers. The default is *false*. + +**--rm**=*true*|*false* + Remove intermediate containers after a successful build. The default is *true*. + +**-t**, **--tag**="" + Repository name (and optionally a tag) to be applied to the resulting image in case of success + +**-m**, **--memory**=*MEMORY* + Memory limit + +**--memory-swap**=*MEMORY-SWAP* + Total memory (memory + swap), '-1' to disable swap. + +**--cpu-shares**=*0* + CPU shares (relative weight). + + By default, all containers get the same proportion of CPU cycles. + CPU shares is a 'relative weight', relative to the default setting of 1024. + This default value is defined here: + ``` + cat /sys/fs/cgroup/cpu/cpu.shares + 1024 + ``` + You can change this proportion by adjusting the container's CPU share + weighting relative to the weighting of all other running containers. + + To modify the proportion from the default of 1024, use the **--cpu-shares** + flag to set the weighting to 2 or higher. + + Container CPU share Flag + {C0} 60% of CPU --cpu-shares=614 (614 is 60% of 1024) + {C1} 40% of CPU --cpu-shares=410 (410 is 40% of 1024) + + The proportion is only applied when CPU-intensive processes are running. + When tasks in one container are idle, the other containers can use the + left-over CPU time. The actual amount of CPU time used varies depending on + the number of containers running on the system. + + For example, consider three containers, where one has **--cpu-shares=1024** and + two others have **--cpu-shares=512**. When processes in all three + containers attempt to use 100% of CPU, the first container would receive + 50% of the total CPU time. If you add a fourth container with **--cpu-shares=1024**, + the first container only gets 33% of the CPU. The remaining containers + receive 16.5%, 16.5% and 33% of the CPU. + + + Container CPU share Flag CPU time + {C0} 100% --cpu-shares=1024 33% + {C1} 50% --cpu-shares=512 16.5% + {C2} 50% --cpu-shares=512 16.5% + {C4} 100% --cpu-shares=1024 33% + + + On a multi-core system, the shares of CPU time are distributed across the CPU + cores. Even if a container is limited to less than 100% of CPU time, it can + use 100% of each individual CPU core. + + For example, consider a system with more than three cores. If you start one + container **{C0}** with **--cpu-shares=512** running one process, and another container + **{C1}** with **--cpu-shares=1024** running two processes, this can result in the following + division of CPU shares: + + PID container CPU CPU share + 100 {C0} 0 100% of CPU0 + 101 {C1} 1 100% of CPU1 + 102 {C1} 2 100% of CPU2 + +**--cpu-period**=*0* + Limit the CPU CFS (Completely Fair Scheduler) period. + + Limit the container's CPU usage. This flag causes the kernel to restrict the + container's CPU usage to the period you specify. + +**--cpu-quota**=*0* + Limit the CPU CFS (Completely Fair Scheduler) quota. + + By default, containers run with the full CPU resource. This flag causes the +kernel to restrict the container's CPU usage to the quota you specify. + +**--cpuset-cpus**=*CPUSET-CPUS* + CPUs in which to allow execution (0-3, 0,1). + +**--cpuset-mems**=*CPUSET-MEMS* + Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on + NUMA systems. + + For example, if you have four memory nodes on your system (0-3), use `--cpuset-mems=0,1` +to ensure the processes in your Docker container only use memory from the first +two memory nodes. + +**--cgroup-parent**=*CGROUP-PARENT* + Path to `cgroups` under which the container's `cgroup` are created. + + If the path is not absolute, the path is considered relative to the `cgroups` path of the init process. +Cgroups are created if they do not already exist. + +**--ulimit**=[] + Ulimit options + + For more information about `ulimit` see [Setting ulimits in a +container](https://docs.docker.com/reference/commandline/run/#setting-ulimits-in-a-container) + +# EXAMPLES + +## Building an image using a Dockerfile located inside the current directory + +Docker images can be built using the build command and a Dockerfile: + + docker build . + +During the build process Docker creates intermediate images. In order to +keep them, you must explicitly set `--rm=false`. + + docker build --rm=false . + +A good practice is to make a sub-directory with a related name and create +the Dockerfile in that directory. For example, a directory called mongo may +contain a Dockerfile to create a Docker MongoDB image. Likewise, another +directory called httpd may be used to store Dockerfiles for Apache web +server images. + +It is also a good practice to add the files required for the image to the +sub-directory. These files will then be specified with the `COPY` or `ADD` +instructions in the `Dockerfile`. + +Note: If you include a tar file (a good practice), then Docker will +automatically extract the contents of the tar file specified within the `ADD` +instruction into the specified target. + +## Building an image and naming that image + +A good practice is to give a name to the image you are building. Note that +only a-z0-9-_. should be used for consistency. There are no hard rules here but it is best to give the names consideration. + +The **-t**/**--tag** flag is used to rename an image. Here are some examples: + +Though it is not a good practice, image names can be arbitrary: + + docker build -t myimage . + +A better approach is to provide a fully qualified and meaningful repository, +name, and tag (where the tag in this context means the qualifier after +the ":"). In this example we build a JBoss image for the Fedora repository +and give it the version 1.0: + + docker build -t fedora/jboss:1.0 . + +The next example is for the "whenry" user repository and uses Fedora and +JBoss and gives it the version 2.1 : + + docker build -t whenry/fedora-jboss:v2.1 . + +If you do not provide a version tag then Docker will assign `latest`: + + docker build -t whenry/fedora-jboss . + +When you list the images, the image above will have the tag `latest`. + +So renaming an image is arbitrary but consideration should be given to +a useful convention that makes sense for consumers and should also take +into account Docker community conventions. + + +## Building an image using a URL + +This will clone the specified GitHub repository from the URL and use it +as context. The Dockerfile at the root of the repository is used as +Dockerfile. This only works if the GitHub repository is a dedicated +repository. + + docker build github.com/scollier/purpletest + +Note: You can set an arbitrary Git repository via the `git://` schema. + +## Building an image using a URL to a tarball'ed context + +This will send the URL itself to the Docker daemon. The daemon will fetch the +tarball archive, decompress it and use its contents as the build context. The +Dockerfile at the root of the archive and the rest of the archive will get used +as the context of the build. If you pass an **-f PATH/Dockerfile** option as well, +the system will look for that file inside the contents of the tarball. + + docker build -f dev/Dockerfile https://10.10.10.1/docker/context.tar.gz + +Note: supported compression formats are 'xz', 'bzip2', 'gzip' and 'identity' (no compression). + +# HISTORY +March 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +June 2015, updated by Sally O'Malley diff --git a/man/docker-commit.1.md b/man/docker-commit.1.md new file mode 100644 index 0000000000..5912d3636d --- /dev/null +++ b/man/docker-commit.1.md @@ -0,0 +1,70 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-commit - Create a new image from a container's changes + +# SYNOPSIS +**docker commit** +[**-a**|**--author**[=*AUTHOR*]] +[**-c**|**--change**[=\[*DOCKERFILE INSTRUCTIONS*\]]] +[**--help**] +[**-m**|**--message**[=*MESSAGE*]] +[**-p**|**--pause**[=*true*]] +CONTAINER [REPOSITORY[:TAG]] + +# DESCRIPTION +Create a new image from an existing container specified by name or +container ID. The new image will contain the contents of the +container filesystem, *excluding* any data volumes. + +While the `docker commit` command is a convenient way of extending an +existing image, you should prefer the use of a Dockerfile and `docker +build` for generating images that you intend to share with other +people. + +# OPTIONS +**-a**, **--author**="" + Author (e.g., "John Hannibal Smith ") + +**-c** , **--change**=[] + Apply specified Dockerfile instructions while committing the image + Supported Dockerfile instructions: `CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`LABEL`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR` + +**--help** + Print usage statement + +**-m**, **--message**="" + Commit message + +**-p**, **--pause**=*true*|*false* + Pause container during commit. The default is *true*. + +# EXAMPLES + +## Creating a new image from an existing container +An existing Fedora based container has had Apache installed while running +in interactive mode with the bash shell. Apache is also running. To +create a new image run `docker ps` to find the container's ID and then run: + + # docker commit -m="Added Apache to Fedora base image" \ + -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20 + +Note that only a-z0-9-_. are allowed when naming images from an +existing container. + +## Apply specified Dockerfile instructions while committing the image +If an existing container was created without the DEBUG environment +variable set to "true", you can create a new image based on that +container by first getting the container's ID with `docker ps` and +then running: + + # docker commit -c="ENV DEBUG true" 98bd7fc99854 debug-image + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and in +June 2014, updated by Sven Dowideit +July 2014, updated by Sven Dowideit +Oct 2014, updated by Daniel, Dao Quang Minh +June 2015, updated by Sally O'Malley diff --git a/man/docker-cp.1.md b/man/docker-cp.1.md new file mode 100644 index 0000000000..7b56957579 --- /dev/null +++ b/man/docker-cp.1.md @@ -0,0 +1,151 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-cp - Copy files/folders between a container and the local filesystem. + +# SYNOPSIS +**docker cp** +[**--help**] +CONTAINER:PATH LOCALPATH|- +LOCALPATH|- CONTAINER:PATH + +# DESCRIPTION + +In the first synopsis form, the `docker cp` utility copies the contents of +`PATH` from the filesystem of `CONTAINER` to the `LOCALPATH` (or stream as +a tar archive to `STDOUT` if `-` is specified). + +In the second synopsis form, the contents of `LOCALPATH` (or a tar archive +streamed from `STDIN` if `-` is specified) are copied from the local machine to +`PATH` in the filesystem of `CONTAINER`. + +You can copy to or from either a running or stopped container. The `PATH` can +be a file or directory. The `docker cp` command assumes all `CONTAINER:PATH` +values are relative to the `/` (root) directory of the container. This means +supplying the initial forward slash is optional; The command sees +`compassionate_darwin:/tmp/foo/myfile.txt` and +`compassionate_darwin:tmp/foo/myfile.txt` as identical. If a `LOCALPATH` value +is not absolute, is it considered relative to the current working directory. + +Behavior is similar to the common Unix utility `cp -a` in that directories are +copied recursively with permissions preserved if possible. Ownership is set to +the user and primary group on the receiving end of the transfer. For example, +files copied to a container will be created with `UID:GID` of the root user. +Files copied to the local machine will be created with the `UID:GID` of the +user which invoked the `docker cp` command. + +Assuming a path separator of `/`, a first argument of `SRC_PATH` and second +argument of `DST_PATH`, the behavior is as follows: + +- `SRC_PATH` specifies a file + - `DST_PATH` does not exist + - the file is saved to a file created at `DST_PATH` + - `DST_PATH` does not exist and ends with `/` + - Error condition: the destination directory must exist. + - `DST_PATH` exists and is a file + - the destination is overwritten with the contents of the source file + - `DST_PATH` exists and is a directory + - the file is copied into this directory using the basename from + `SRC_PATH` +- `SRC_PATH` specifies a directory + - `DST_PATH` does not exist + - `DST_PATH` is created as a directory and the *contents* of the source + directory are copied into this directory + - `DST_PATH` exists and is a file + - Error condition: cannot copy a directory to a file + - `DST_PATH` exists and is a directory + - `SRC_PATH` does not end with `/.` + - the source directory is copied into this directory + - `SRC_PATH` does end with `/.` + - the *content* of the source directory is copied into this + directory + +The command requires `SRC_PATH` and `DST_PATH` to exist according to the above +rules. If `SRC_PATH` is local and is a symbolic link, the symbolic link, not +the target, is copied. + +A colon (`:`) is used as a delimiter between `CONTAINER` and `PATH`, but `:` +could also be in a valid `LOCALPATH`, like `file:name.txt`. This ambiguity is +resolved by requiring a `LOCALPATH` with a `:` to be made explicit with a +relative or absolute path, for example: + + `/path/to/file:name.txt` or `./file:name.txt` + +It is not possible to copy certain system files such as resources under +`/proc`, `/sys`, `/dev`, and mounts created by the user in the container. + +Using `-` as the first argument in place of a `LOCALPATH` will stream the +contents of `STDIN` as a tar archive which will be extracted to the `PATH` in +the filesystem of the destination container. In this case, `PATH` must specify +a directory. + +Using `-` as the second argument in place of a `LOCALPATH` will stream the +contents of the resource from the source container as a tar archive to +`STDOUT`. + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES + +Suppose a container has finished producing some output as a file it saves +to somewhere in its filesystem. This could be the output of a build job or +some other computation. You can copy these outputs from the container to a +location on your local host. + +If you want to copy the `/tmp/foo` directory from a container to the +existing `/tmp` directory on your host. If you run `docker cp` in your `~` +(home) directory on the local host: + + $ docker cp compassionate_darwin:tmp/foo /tmp + +Docker creates a `/tmp/foo` directory on your host. Alternatively, you can omit +the leading slash in the command. If you execute this command from your home +directory: + + $ docker cp compassionate_darwin:tmp/foo tmp + +If `~/tmp` does not exist, Docker will create it and copy the contents of +`/tmp/foo` from the container into this new directory. If `~/tmp` already +exists as a directory, then Docker will copy the contents of `/tmp/foo` from +the container into a directory at `~/tmp/foo`. + +When copying a single file to an existing `LOCALPATH`, the `docker cp` command +will either overwrite the contents of `LOCALPATH` if it is a file or place it +into `LOCALPATH` if it is a directory, overwriting an existing file of the same +name if one exists. For example, this command: + + $ docker cp sharp_ptolemy:/tmp/foo/myfile.txt /test + +If `/test` does not exist on the local machine, it will be created as a file +with the contents of `/tmp/foo/myfile.txt` from the container. If `/test` +exists as a file, it will be overwritten. Lastly, if `/tmp` exists as a +directory, the file will be copied to `/test/myfile.txt`. + +Next, suppose you want to copy a file or folder into a container. For example, +this could be a configuration file or some other input to a long running +computation that you would like to place into a created container before it +starts. This is useful because it does not require the configuration file or +other input to exist in the container image. + +If you have a file, `config.yml`, in the current directory on your local host +and wish to copy it to an existing directory at `/etc/my-app.d` in a container, +this command can be used: + + $ docker cp config.yml myappcontainer:/etc/my-app.d + +If you have several files in a local directory `/config` which you need to copy +to a directory `/etc/my-app.d` in a container: + + $ docker cp /config/. myappcontainer:/etc/my-app.d + +The above command will copy the contents of the local `/config` directory into +the directory `/etc/my-app.d` in the container. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +May 2015, updated by Josh Hawn diff --git a/man/docker-create.1.md b/man/docker-create.1.md new file mode 100644 index 0000000000..ecea12c5f8 --- /dev/null +++ b/man/docker-create.1.md @@ -0,0 +1,287 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-create - Create a new container + +# SYNOPSIS +**docker create** +[**-a**|**--attach**[=*[]*]] +[**--add-host**[=*[]*]] +[**--blkio-weight**[=*[BLKIO-WEIGHT]*]] +[**--cpu-shares**[=*0*]] +[**--cap-add**[=*[]*]] +[**--cap-drop**[=*[]*]] +[**--cgroup-parent**[=*CGROUP-PATH*]] +[**--cidfile**[=*CIDFILE*]] +[**--cpu-period**[=*0*]] +[**--cpu-quota**[=*0*]] +[**--cpuset-cpus**[=*CPUSET-CPUS*]] +[**--cpuset-mems**[=*CPUSET-MEMS*]] +[**--device**[=*[]*]] +[**--dns**[=*[]*]] +[**--dns-search**[=*[]*]] +[**--dns-opt**[=*[]*]] +[**-e**|**--env**[=*[]*]] +[**--entrypoint**[=*ENTRYPOINT*]] +[**--env-file**[=*[]*]] +[**--expose**[=*[]*]] +[**--group-add**[=*[]*]] +[**-h**|**--hostname**[=*HOSTNAME*]] +[**--help**] +[**-i**|**--interactive**[=*false*]] +[**--ipc**[=*IPC*]] +[**--kernel-memory**[=*KERNEL-MEMORY*]] +[**-l**|**--label**[=*[]*]] +[**--label-file**[=*[]*]] +[**--link**[=*[]*]] +[**--log-driver**[=*[]*]] +[**--log-opt**[=*[]*]] +[**--lxc-conf**[=*[]*]] +[**-m**|**--memory**[=*MEMORY*]] +[**--mac-address**[=*MAC-ADDRESS*]] +[**--memory-reservation**[=*MEMORY-RESERVATION*]] +[**--memory-swap**[=*MEMORY-SWAP*]] +[**--memory-swappiness**[=*MEMORY-SWAPPINESS*]] +[**--name**[=*NAME*]] +[**--net**[=*"bridge"*]] +[**--oom-kill-disable**[=*false*]] +[**-P**|**--publish-all**[=*false*]] +[**-p**|**--publish**[=*[]*]] +[**--pid**[=*[]*]] +[**--privileged**[=*false*]] +[**--read-only**[=*false*]] +[**--restart**[=*RESTART*]] +[**--security-opt**[=*[]*]] +[**--stop-signal**[=*SIGNAL*]] +[**-t**|**--tty**[=*false*]] +[**-u**|**--user**[=*USER*]] +[**--ulimit**[=*[]*]] +[**--uts**[=*[]*]] +[**-v**|**--volume**[=*[]*]] +[**--volumes-from**[=*[]*]] +[**-w**|**--workdir**[=*WORKDIR*]] +IMAGE [COMMAND] [ARG...] + +# DESCRIPTION + +Creates a writeable container layer over the specified image and prepares it for +running the specified command. The container ID is then printed to STDOUT. This +is similar to **docker run -d** except the container is never started. You can +then use the **docker start ** command to start the container at +any point. + +The initial status of the container created with **docker create** is 'created'. + +# OPTIONS +**-a**, **--attach**=[] + Attach to STDIN, STDOUT or STDERR. + +**--add-host**=[] + Add a custom host-to-IP mapping (host:ip) + +**--blkio-weight**=0 + Block IO weight (relative weight) accepts a weight value between 10 and 1000. + +**--cpu-shares**=0 + CPU shares (relative weight) + +**--cap-add**=[] + Add Linux capabilities + +**--cap-drop**=[] + Drop Linux capabilities + +**--cgroup-parent**="" + Path to cgroups under which the cgroup for the container will be created. If the path is not absolute, the path is considered to be relative to the cgroups path of the init process. Cgroups will be created if they do not already exist. + +**--cidfile**="" + Write the container ID to the file + +**--cpu-period**=0 + Limit the CPU CFS (Completely Fair Scheduler) period + +**--cpuset-cpus**="" + CPUs in which to allow execution (0-3, 0,1) + +**--cpuset-mems**="" + Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems. + + If you have four memory nodes on your system (0-3), use `--cpuset-mems=0,1` +then processes in your Docker container will only use memory from the first +two memory nodes. + +**--cpu-quota**=0 + Limit the CPU CFS (Completely Fair Scheduler) quota + +**--device**=[] + Add a host device to the container (e.g. --device=/dev/sdc:/dev/xvdc:rwm) + +**--dns**=[] + Set custom DNS servers + +**--dns-opt**=[] + Set custom DNS options + +**--dns-search**=[] + Set custom DNS search domains (Use --dns-search=. if you don't wish to set the search domain) + +**-e**, **--env**=[] + Set environment variables + +**--entrypoint**="" + Overwrite the default ENTRYPOINT of the image + +**--env-file**=[] + Read in a line-delimited file of environment variables + +**--expose**=[] + Expose a port or a range of ports (e.g. --expose=3300-3310) from the container without publishing it to your host + +**--group-add**=[] + Add additional groups to run as + +**-h**, **--hostname**="" + Container host name + +**--help** + Print usage statement + +**-i**, **--interactive**=*true*|*false* + Keep STDIN open even if not attached. The default is *false*. + +**--ipc**="" + Default is to create a private IPC namespace (POSIX SysV IPC) for the container + 'container:': reuses another container shared memory, semaphores and message queues + 'host': use the host shared memory,semaphores and message queues inside the container. Note: the host mode gives the container full access to local shared memory and is therefore considered insecure. + +**--kernel-memory**="" + Kernel memory limit (format: `[]`, where unit = b, k, m or g) + + Constrains the kernel memory available to a container. If a limit of 0 +is specified (not using `--kernel-memory`), the container's kernel memory +is not limited. If you specify a limit, it may be rounded up to a multiple +of the operating system's page size and the value can be very large, +millions of trillions. + +**-l**, **--label**=[] + Adds metadata to a container (e.g., --label=com.example.key=value) + +**--label-file**=[] + Read labels from a file. Delimit each label with an EOL. + +**--link**=[] + Add link to another container in the form of :alias or just + in which case the alias will match the name. + +**--log-driver**="|*json-file*|*syslog*|*journald*|*gelf*|*fluentd*|*awslogs*|*none*" + Logging driver for container. Default is defined by daemon `--log-driver` flag. + **Warning**: the `docker logs` command works only for the `json-file` and + `journald` logging drivers. + +**--log-opt**=[] + Logging driver specific options. + +**--lxc-conf**=[] + (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" + +**-m**, **--memory**="" + Memory limit (format: [], where unit = b, k, m or g) + + Allows you to constrain the memory available to a container. If the host +supports swap memory, then the **-m** memory setting can be larger than physical +RAM. If a limit of 0 is specified (not using **-m**), the container's memory is +not limited. The actual limit may be rounded up to a multiple of the operating +system's page size (the value would be very large, that's millions of trillions). + +**--mac-address**="" + Container MAC address (e.g. 92:d0:c6:0a:29:33) + +**--memory-reservation**="" + Memory soft limit (format: [], where unit = b, k, m or g) + + After setting memory reservation, when the system detects memory contention +or low memory, containers are forced to restrict their consumption to their +reservation. So you should always set the value below **--memory**, otherwise the +hard limit will take precedence. By default, memory reservation will be the same +as memory limit. + +**--memory-swap**="" + Total memory limit (memory + swap) + + Set `-1` to disable swap (format: [], where unit = b, k, m or g). +This value should always larger than **-m**, so you should always use this with **-m**. + +**--memory-swappiness**="" + Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. + +**--name**="" + Assign a name to the container + +**--net**="bridge" + Set the Network mode for the container + 'bridge': creates a new network stack for the container on the docker bridge + 'none': no networking for this container + 'container:': reuses another container network stack + 'host': use the host network stack inside the container. Note: the host mode gives the container full access to local system services such as D-bus and is therefore considered insecure. + +**--oom-kill-disable**=*true*|*false* + Whether to disable OOM Killer for the container or not. + +**-P**, **--publish-all**=*true*|*false* + Publish all exposed ports to random ports on the host interfaces. The default is *false*. + +**-p**, **--publish**=[] + Publish a container's port, or a range of ports, to the host + format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort | containerPort + Both hostPort and containerPort can be specified as a range of ports. + When specifying ranges for both, the number of container ports in the range must match the number of host ports in the range. (e.g., `-p 1234-1236:1234-1236/tcp`) + (use 'docker port' to see the actual mapping) + +**--pid**=host + Set the PID mode for the container + **host**: use the host's PID namespace inside the container. + Note: the host mode gives the container full access to local PID and is therefore considered insecure. + +**--privileged**=*true*|*false* + Give extended privileges to this container. The default is *false*. + +**--read-only**=*true*|*false* + Mount the container's root filesystem as read only. + +**--restart**="no" + Restart policy to apply when a container exits (no, on-failure[:max-retry], always, unless-stopped). + +**--security-opt**=[] + Security Options + +**--stop-signal**=SIGTERM + Signal to stop a container. Default is SIGTERM. + +**-t**, **--tty**=*true*|*false* + Allocate a pseudo-TTY. The default is *false*. + +**-u**, **--user**="" + Username or UID + +**--ulimit**=[] + Ulimit options + +**--uts**=host + Set the UTS mode for the container + **host**: use the host's UTS namespace inside the container. + Note: the host mode gives the container access to changing the host's hostname and is therefore considered insecure. + +**-v**, **--volume**=[] + Bind mount a volume (e.g., from the host: -v /host:/container, from Docker: -v /container) + +**--volumes-from**=[] + Mount volumes from the specified container(s) + +**-w**, **--workdir**="" + Working directory inside the container + +# HISTORY +August 2014, updated by Sven Dowideit +September 2014, updated by Sven Dowideit +November 2014, updated by Sven Dowideit diff --git a/man/docker-daemon.8.md b/man/docker-daemon.8.md new file mode 100644 index 0000000000..b85a9a76fa --- /dev/null +++ b/man/docker-daemon.8.md @@ -0,0 +1,466 @@ +% DOCKER(1) Docker User Manuals +% Shishir Mahajan +% SEPTEMBER 2015 +# NAME +docker-daemon - Enable daemon mode + +# SYNOPSIS +**docker daemon** +[**--api-cors-header**=[=*API-CORS-HEADER*]] +[**-b**|**--bridge**[=*BRIDGE*]] +[**--bip**[=*BIP*]] +[**--cluster-store**[=*[]*]] +[**--cluster-advertise**[=*[]*]] +[**--cluster-store-opt**[=*map[]*]] +[**-D**|**--debug**[=*false*]] +[**--default-gateway**[=*DEFAULT-GATEWAY*]] +[**--default-gateway-v6**[=*DEFAULT-GATEWAY-V6*]] +[**--default-ulimit**[=*[]*]] +[**--disable-legacy-registry**[=*false*]] +[**--dns**[=*[]*]] +[**--dns-opt**[=*[]*]] +[**--dns-search**[=*[]*]] +[**-e**|**--exec-driver**[=*native*]] +[**--exec-opt**[=*[]*]] +[**--exec-root**[=*/var/run/docker*]] +[**--fixed-cidr**[=*FIXED-CIDR*]] +[**--fixed-cidr-v6**[=*FIXED-CIDR-V6*]] +[**-G**|**--group**[=*docker*]] +[**-g**|**--graph**[=*/var/lib/docker*]] +[**-H**|**--host**[=*[]*]] +[**--help**] +[**--icc**[=*true*]] +[**--insecure-registry**[=*[]*]] +[**--ip**[=*0.0.0.0*]] +[**--ip-forward**[=*true*]] +[**--ip-masq**[=*true*]] +[**--iptables**[=*true*]] +[**--ipv6**[=*false*]] +[**-l**|**--log-level**[=*info*]] +[**--label**[=*[]*]] +[**--log-driver**[=*json-file*]] +[**--log-opt**[=*map[]*]] +[**--mtu**[=*0*]] +[**-p**|**--pidfile**[=*/var/run/docker.pid*]] +[**--registry-mirror**[=*[]*]] +[**-s**|**--storage-driver**[=*STORAGE-DRIVER*]] +[**--selinux-enabled**[=*false*]] +[**--storage-opt**[=*[]*]] +[**--tls**[=*false*]] +[**--tlscacert**[=*~/.docker/ca.pem*]] +[**--tlscert**[=*~/.docker/cert.pem*]] +[**--tlskey**[=*~/.docker/key.pem*]] +[**--tlsverify**[=*false*]] +[**--userland-proxy**[=*true*]] + +# DESCRIPTION +**docker** has two distinct functions. It is used for starting the Docker +daemon and to run the CLI (i.e., to command the daemon to manage images, +containers etc.) So **docker** is both a server, as a daemon, and a client +to the daemon, through the CLI. + +To run the Docker daemon you can specify **docker daemon**. +You can check the daemon options using **docker daemon --help**. +Daemon options should be specified after the **daemon** keyword in the following +format. + +**docker daemon [OPTIONS]** + +# OPTIONS + +**--api-cors-header**="" + Set CORS headers in the remote API. Default is cors disabled. Give urls like "http://foo, http://bar, ...". Give "*" to allow all. + +**-b**, **--bridge**="" + Attach containers to a pre\-existing network bridge; use 'none' to disable container networking + +**--bip**="" + Use the provided CIDR notation address for the dynamically created bridge (docker0); Mutually exclusive of \-b + +**--cluster-store**="" + URL of the distributed storage backend + +**--cluster-advertise**="" + Specifies the 'host:port' or `interface:port` combination that this particular + daemon instance should use when advertising itself to the cluster. The daemon + is reached through this value. + +**--cluster-store-opt**="" + Specifies options for the Key/Value store. + +**-D**, **--debug**=*true*|*false* + Enable debug mode. Default is false. + +**--default-gateway**="" + IPv4 address of the container default gateway; this address must be part of the bridge subnet (which is defined by \-b or \--bip) + +**--default-gateway-v6**="" + IPv6 address of the container default gateway + +**--default-ulimit**=[] + Set default ulimits for containers. + +**--disable-legacy-registry**=*true*|*false* + Do not contact legacy registries + +**--dns**="" + Force Docker to use specific DNS servers + +**--dns-opt**="" + DNS options to use. + +**--dns-search**=[] + DNS search domains to use. + +**-e**, **--exec-driver**="" + Force Docker to use specific exec driver. Default is `native`. + +**--exec-opt**=[] + Set exec driver options. See EXEC DRIVER OPTIONS. + +**--exec-root**="" + Path to use as the root of the Docker exec driver. Default is `/var/run/docker`. + +**--fixed-cidr**="" + IPv4 subnet for fixed IPs (e.g., 10.20.0.0/16); this subnet must be nested in the bridge subnet (which is defined by \-b or \-\-bip) + +**--fixed-cidr-v6**="" + IPv6 subnet for global IPv6 addresses (e.g., 2a00:1450::/64) + +**-G**, **--group**="" + Group to assign the unix socket specified by -H when running in daemon mode. + use '' (the empty string) to disable setting of a group. Default is `docker`. + +**-g**, **--graph**="" + Path to use as the root of the Docker runtime. Default is `/var/lib/docker`. + +**-H**, **--host**=[unix:///var/run/docker.sock]: tcp://[host:port] to bind or +unix://[/path/to/socket] to use. + The socket(s) to bind to in daemon mode specified using one or more + tcp://host:port, unix:///path/to/socket, fd://* or fd://socketfd. + +**--help** + Print usage statement + +**--icc**=*true*|*false* + Allow unrestricted inter\-container and Docker daemon host communication. If disabled, containers can still be linked together using the **--link** option (see **docker-run(1)**). Default is true. + +**--insecure-registry**=[] + Enable insecure registry communication, i.e., enable un-encrypted and/or untrusted communication. + + List of insecure registries can contain an element with CIDR notation to specify a whole subnet. Insecure registries accept HTTP and/or accept HTTPS with certificates from unknown CAs. + + Enabling `--insecure-registry` is useful when running a local registry. However, because its use creates security vulnerabilities it should ONLY be enabled for testing purposes. For increased security, users should add their CA to their system's list of trusted CAs instead of using `--insecure-registry`. + +**--ip**="" + Default IP address to use when binding container ports. Default is `0.0.0.0`. + +**--ip-forward**=*true*|*false* + Enables IP forwarding on the Docker host. The default is `true`. This flag interacts with the IP forwarding setting on your host system's kernel. If your system has IP forwarding disabled, this setting enables it. If your system has IP forwarding enabled, setting this flag to `--ip-forward=false` has no effect. + + This setting will also enable IPv6 forwarding if you have both `--ip-forward=true` and `--fixed-cidr-v6` set. Note that this may reject Router Advertisements and interfere with the host's existing IPv6 configuration. For more information, please consult the documentation about "Advanced Networking - IPv6". + +**--ip-masq**=*true*|*false* + Enable IP masquerading for bridge's IP range. Default is true. + +**--iptables**=*true*|*false* + Enable Docker's addition of iptables rules. Default is true. + +**--ipv6**=*true*|*false* + Enable IPv6 support. Default is false. Docker will create an IPv6-enabled bridge with address fe80::1 which will allow you to create IPv6-enabled containers. Use together with `--fixed-cidr-v6` to provide globally routable IPv6 addresses. IPv6 forwarding will be enabled if not used with `--ip-forward=false`. This may collide with your host's current IPv6 settings. For more information please consult the documentation about "Advanced Networking - IPv6". + +**-l**, **--log-level**="*debug*|*info*|*warn*|*error*|*fatal*"" + Set the logging level. Default is `info`. + +**--label**="[]" + Set key=value labels to the daemon (displayed in `docker info`) + +**--log-driver**="*json-file*|*syslog*|*journald*|*gelf*|*fluentd*|*awslogs*|*none*" + Default driver for container logs. Default is `json-file`. + **Warning**: `docker logs` command works only for `json-file` logging driver. + +**--log-opt**=[] + Logging driver specific options. + +**--mtu**=VALUE + Set the containers network mtu. Default is `0`. + +**-p**, **--pidfile**="" + Path to use for daemon PID file. Default is `/var/run/docker.pid` + +**--registry-mirror**=:// + Prepend a registry mirror to be used for image pulls. May be specified multiple times. + +**-s**, **--storage-driver**="" + Force the Docker runtime to use a specific storage driver. + +**--selinux-enabled**=*true*|*false* + Enable selinux support. Default is false. SELinux does not presently support the BTRFS storage driver. + +**--storage-opt**=[] + Set storage driver options. See STORAGE DRIVER OPTIONS. + +**--tls**=*true*|*false* + Use TLS; implied by --tlsverify. Default is false. + +**--tlscacert**=~/.docker/ca.pem + Trust certs signed only by this CA. + +**--tlscert**=~/.docker/cert.pem + Path to TLS certificate file. + +**--tlskey**=~/.docker/key.pem + Path to TLS key file. + +**--tlsverify**=*true*|*false* + Use TLS and verify the remote (daemon: verify client, client: verify daemon). + Default is false. + +**--userland-proxy**=*true*|*false* + Rely on a userland proxy implementation for inter-container and outside-to-container loopback communications. Default is true. + +# STORAGE DRIVER OPTIONS + +Docker uses storage backends (known as "graphdrivers" in the Docker +internals) to create writable containers from images. Many of these +backends use operating system level technologies and can be +configured. + +Specify options to the storage backend with **--storage-opt** flags. The only +backend that currently takes options is *devicemapper*. Therefore use these +flags with **-s=**devicemapper. + +Specifically for devicemapper, the default is a "loopback" model which +requires no pre-configuration, but is extremely inefficient. Do not +use it in production. + +To make the best use of Docker with the devicemapper backend, you must +have a recent version of LVM. Use `lvm` to create a thin pool; for +more information see `man lvmthin`. Then, use `--storage-opt +dm.thinpooldev` to tell the Docker engine to use that pool for +allocating images and container snapshots. + +Here is the list of *devicemapper* options: + +#### dm.thinpooldev + +Specifies a custom block storage device to use for the thin pool. + +If using a block device for device mapper storage, it is best to use +`lvm` to create and manage the thin-pool volume. This volume is then +handed to Docker to create snapshot volumes needed for images and +containers. + +Managing the thin-pool outside of Docker makes for the most feature-rich method +of having Docker utilize device mapper thin provisioning as the backing storage +for Docker's containers. The highlights of the LVM-based thin-pool management +feature include: automatic or interactive thin-pool resize support, dynamically +changing thin-pool features, automatic thinp metadata checking when lvm activates +the thin-pool, etc. + +Example use: `docker daemon --storage-opt dm.thinpooldev=/dev/mapper/thin-pool` + +#### dm.basesize + +Specifies the size to use when creating the base device, which limits +the size of images and containers. The default value is 100G. Note, +thin devices are inherently "sparse", so a 100G device which is mostly +empty doesn't use 100 GB of space on the pool. However, the filesystem +will use more space for base images the larger the device +is. + +This value affects the system-wide "base" empty filesystem that may already +be initialized and inherited by pulled images. Typically, a change to this +value requires additional steps to take effect: + + $ sudo service docker stop + $ sudo rm -rf /var/lib/docker + $ sudo service docker start + +Example use: `docker daemon --storage-opt dm.basesize=20G` + +#### dm.fs + +Specifies the filesystem type to use for the base device. The +supported options are `ext4` and `xfs`. The default is `ext4`. + +Example use: `docker daemon --storage-opt dm.fs=xfs` + +#### dm.mkfsarg + +Specifies extra mkfs arguments to be used when creating the base device. + +Example use: `docker daemon --storage-opt "dm.mkfsarg=-O ^has_journal"` + +#### dm.mountopt + +Specifies extra mount options used when mounting the thin devices. + +Example use: `docker daemon --storage-opt dm.mountopt=nodiscard` + +#### dm.use_deferred_removal + +Enables use of deferred device removal if `libdm` and the kernel driver +support the mechanism. + +Deferred device removal means that if device is busy when devices are +being removed/deactivated, then a deferred removal is scheduled on +device. And devices automatically go away when last user of the device +exits. + +For example, when a container exits, its associated thin device is removed. If +that device has leaked into some other mount namespace and can't be removed, +the container exit still succeeds and this option causes the system to schedule +the device for deferred removal. It does not wait in a loop trying to remove a busy +device. + +Example use: `docker daemon --storage-opt dm.use_deferred_removal=true` + +#### dm.use_deferred_deletion + +Enables use of deferred device deletion for thin pool devices. By default, +thin pool device deletion is synchronous. Before a container is deleted, the +Docker daemon removes any associated devices. If the storage driver can not +remove a device, the container deletion fails and daemon returns. + +`Error deleting container: Error response from daemon: Cannot destroy container` + +To avoid this failure, enable both deferred device deletion and deferred +device removal on the daemon. + +`docker daemon --storage-opt dm.use_deferred_deletion=true --storage-opt dm.use_deferred_removal=true` + +With these two options enabled, if a device is busy when the driver is +deleting a container, the driver marks the device as deleted. Later, when the +device isn't in use, the driver deletes it. + +In general it should be safe to enable this option by default. It will help +when unintentional leaking of mount point happens across multiple mount +namespaces. + +#### dm.loopdatasize + +**Note**: This option configures devicemapper loopback, which should not be used in production. + +Specifies the size to use when creating the loopback file for the +"data" device which is used for the thin pool. The default size is +100G. The file is sparse, so it will not initially take up +this much space. + +Example use: `docker daemon --storage-opt dm.loopdatasize=200G` + +#### dm.loopmetadatasize + +**Note**: This option configures devicemapper loopback, which should not be used in production. + +Specifies the size to use when creating the loopback file for the +"metadata" device which is used for the thin pool. The default size +is 2G. The file is sparse, so it will not initially take up +this much space. + +Example use: `docker daemon --storage-opt dm.loopmetadatasize=4G` + +#### dm.datadev + +(Deprecated, use `dm.thinpooldev`) + +Specifies a custom blockdevice to use for data for a +Docker-managed thin pool. It is better to use `dm.thinpooldev` - see +the documentation for it above for discussion of the advantages. + +#### dm.metadatadev + +(Deprecated, use `dm.thinpooldev`) + +Specifies a custom blockdevice to use for metadata for a +Docker-managed thin pool. See `dm.datadev` for why this is +deprecated. + +#### dm.blocksize + +Specifies a custom blocksize to use for the thin pool. The default +blocksize is 64K. + +Example use: `docker daemon --storage-opt dm.blocksize=512K` + +#### dm.blkdiscard + +Enables or disables the use of `blkdiscard` when removing devicemapper +devices. This is disabled by default due to the additional latency, +but as a special case with loopback devices it will be enabled, in +order to re-sparsify the loopback file on image/container removal. + +Disabling this on loopback can lead to *much* faster container removal +times, but it also prevents the space used in `/var/lib/docker` directory +from being returned to the system for other use when containers are +removed. + +Example use: `docker daemon --storage-opt dm.blkdiscard=false` + +#### dm.override_udev_sync_check + +By default, the devicemapper backend attempts to synchronize with the +`udev` device manager for the Linux kernel. This option allows +disabling that synchronization, to continue even though the +configuration may be buggy. + +To view the `udev` sync support of a Docker daemon that is using the +`devicemapper` driver, run: + + $ docker info + [...] + Udev Sync Supported: true + [...] + +When `udev` sync support is `true`, then `devicemapper` and `udev` can +coordinate the activation and deactivation of devices for containers. + +When `udev` sync support is `false`, a race condition occurs between +the `devicemapper` and `udev` during create and cleanup. The race +condition results in errors and failures. (For information on these +failures, see +[docker#4036](https://github.com/docker/docker/issues/4036)) + +To allow the `docker` daemon to start, regardless of whether `udev` sync is +`false`, set `dm.override_udev_sync_check` to true: + + $ docker daemon --storage-opt dm.override_udev_sync_check=true + +When this value is `true`, the driver continues and simply warns you +the errors are happening. + +**Note**: The ideal is to pursue a `docker` daemon and environment +that does support synchronizing with `udev`. For further discussion on +this topic, see +[docker#4036](https://github.com/docker/docker/issues/4036). +Otherwise, set this flag for migrating existing Docker daemons to a +daemon with a supported environment. + +# CLUSTER STORE OPTIONS + +The daemon uses libkv to advertise +the node within the cluster. Some Key/Value backends support mutual +TLS, and the client TLS settings used by the daemon can be configured +using the **--cluster-store-opt** flag, specifying the paths to PEM encoded +files. + +#### kv.cacertfile + +Specifies the path to a local file with PEM encoded CA certificates to trust + +#### kv.certfile + +Specifies the path to a local file with a PEM encoded certificate. This +certificate is used as the client cert for communication with the +Key/Value store. + +#### kv.keyfile + +Specifies the path to a local file with a PEM encoded private key. This +private key is used as the client key for communication with the +Key/Value store. + + +# HISTORY +Sept 2015, Originally compiled by Shishir Mahajan +based on docker.com source material and internal work. diff --git a/man/docker-diff.1.md b/man/docker-diff.1.md new file mode 100644 index 0000000000..6c6c502533 --- /dev/null +++ b/man/docker-diff.1.md @@ -0,0 +1,49 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-diff - Inspect changes on a container's filesystem + +# SYNOPSIS +**docker diff** +[**--help**] +CONTAINER + +# DESCRIPTION +Inspect changes on a container's filesystem. You can use the full or +shortened container ID or the container name set using +**docker run --name** option. + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES +Inspect the changes to on a nginx container: + + # docker diff 1fdfd1f54c1b + C /dev + C /dev/console + C /dev/core + C /dev/stdout + C /dev/fd + C /dev/ptmx + C /dev/stderr + C /dev/stdin + C /run + A /run/nginx.pid + C /var/lib/nginx/tmp + A /var/lib/nginx/tmp/client_body + A /var/lib/nginx/tmp/fastcgi + A /var/lib/nginx/tmp/proxy + A /var/lib/nginx/tmp/scgi + A /var/lib/nginx/tmp/uwsgi + C /var/log/nginx + A /var/log/nginx/access.log + A /var/log/nginx/error.log + + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-events.1.md b/man/docker-events.1.md new file mode 100644 index 0000000000..87d921cdaa --- /dev/null +++ b/man/docker-events.1.md @@ -0,0 +1,86 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-events - Get real time events from the server + +# SYNOPSIS +**docker events** +[**--help**] +[**-f**|**--filter**[=*[]*]] +[**--since**[=*SINCE*]] +[**--until**[=*UNTIL*]] + + +# DESCRIPTION +Get event information from the Docker daemon. Information can include historical +information and real-time information. + +Docker containers will report the following events: + + attach, commit, copy, create, destroy, die, exec_create, exec_start, export, kill, oom, pause, rename, resize, restart, start, stop, top, unpause + +and Docker images will report: + + delete, import, pull, push, tag, untag + +# OPTIONS +**--help** + Print usage statement + +**-f**, **--filter**=[] + Provide filter values (i.e., 'event=stop') + +**--since**="" + Show all events created since timestamp + +**--until**="" + Stream events until this timestamp + +You can specify `--since` and `--until` parameters as an RFC 3339 date, +a UNIX timestamp, or a Go duration string (e.g. `1m30s`, `3h`). Docker computes +the date relative to the client machine’s time. + +# EXAMPLES + +## Listening for Docker events + +After running docker events a container 786d698004576 is started and stopped +(The container name has been shortened in the output below): + + # docker events + 2015-01-28T20:21:31.000000000-08:00 59211849bc10: (from whenry/testimage:latest) start + 2015-01-28T20:21:31.000000000-08:00 59211849bc10: (from whenry/testimage:latest) die + 2015-01-28T20:21:32.000000000-08:00 59211849bc10: (from whenry/testimage:latest) stop + +## Listening for events since a given date +Again the output container IDs have been shortened for the purposes of this document: + + # docker events --since '2015-01-28' + 2015-01-28T20:25:38.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) create + 2015-01-28T20:25:38.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start + 2015-01-28T20:25:39.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) create + 2015-01-28T20:25:39.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start + 2015-01-28T20:25:40.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) die + 2015-01-28T20:25:42.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) stop + 2015-01-28T20:25:45.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start + 2015-01-28T20:25:45.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) die + 2015-01-28T20:25:46.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) stop + +The following example outputs all events that were generated in the last 3 minutes, +relative to the current time on the client machine: + + # docker events --since '3m' + 2015-05-12T11:51:30.999999999Z07:00 4386fb97867d: (from ubuntu-1:14.04) die + 2015-05-12T15:52:12.999999999Z07:00 4 4386fb97867d: (from ubuntu-1:14.04) stop + 2015-05-12T15:53:45.999999999Z07:00 7805c1d35632: (from redis:2.8) die + 2015-05-12T15:54:03.999999999Z07:00 7805c1d35632: (from redis:2.8) stop + +If you do not provide the --since option, the command returns only new and/or +live events. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +June 2015, updated by Brian Goff diff --git a/man/docker-exec.1.md b/man/docker-exec.1.md new file mode 100644 index 0000000000..5cfdb5434b --- /dev/null +++ b/man/docker-exec.1.md @@ -0,0 +1,60 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-exec - Run a command in a running container + +# SYNOPSIS +**docker exec** +[**-d**|**--detach**[=*false*]] +[**--help**] +[**-i**|**--interactive**[=*false*]] +[**--privileged**[=*false*]] +[**-t**|**--tty**[=*false*]] +[**-u**|**--user**[=*USER*]] +CONTAINER COMMAND [ARG...] + +# DESCRIPTION + +Run a process in a running container. + +The command started using `docker exec` will only run while the container's primary +process (`PID 1`) is running, and will not be restarted if the container is restarted. + +If the container is paused, then the `docker exec` command will wait until the +container is unpaused, and then run + +# OPTIONS +**-d**, **--detach**=*true*|*false* + Detached mode: run command in the background. The default is *false*. + +**--help** + Print usage statement + +**-i**, **--interactive**=*true*|*false* + Keep STDIN open even if not attached. The default is *false*. + +**--privileged**=*true*|*false* + Give the process extended [Linux capabilities](http://man7.org/linux/man-pages/man7/capabilities.7.html) +when running in a container. The default is *false*. + + Without this flag, the process run by `docker exec` in a running container has +the same capabilities as the container, which may be limited. Set +`--privileged` to give all capabilities to the process. + +**-t**, **--tty**=*true*|*false* + Allocate a pseudo-TTY. The default is *false*. + +**-u**, **--user**="" + Sets the username or UID used and optionally the groupname or GID for the specified command. + + The followings examples are all valid: + --user [user | user:group | uid | uid:gid | user:gid | uid:group ] + + Without this argument the command will be run as root in the container. + +The **-t** option is incompatible with a redirection of the docker client +standard input. + +# HISTORY +November 2014, updated by Sven Dowideit diff --git a/man/docker-export.1.md b/man/docker-export.1.md new file mode 100644 index 0000000000..3d59e4788e --- /dev/null +++ b/man/docker-export.1.md @@ -0,0 +1,46 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-export - Export the contents of a container's filesystem as a tar archive + +# SYNOPSIS +**docker export** +[**--help**] +[**-o**|**--output**[=*""*]] +CONTAINER + +# DESCRIPTION +Export the contents of a container's filesystem using the full or shortened +container ID or container name. The output is exported to STDOUT and can be +redirected to a tar file. + +Stream to a file instead of STDOUT by using **-o**. + +# OPTIONS +**--help** + Print usage statement + +**-o**, **--output**="" + Write to a file, instead of STDOUT + +# EXAMPLES +Export the contents of the container called angry_bell to a tar file +called angry_bell.tar: + + # docker export angry_bell > angry_bell.tar + # docker export --output=angry_bell-latest.tar angry_bell + # ls -sh angry_bell.tar + 321M angry_bell.tar + # ls -sh angry_bell-latest.tar + 321M angry_bell-latest.tar + +# See also +**docker-import(1)** to create an empty filesystem image +and import the contents of the tarball into it, then optionally tag it. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +January 2015, updated by Joseph Kern (josephakern at gmail dot com) diff --git a/man/docker-history.1.md b/man/docker-history.1.md new file mode 100644 index 0000000000..247d6503ee --- /dev/null +++ b/man/docker-history.1.md @@ -0,0 +1,52 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-history - Show the history of an image + +# SYNOPSIS +**docker history** +[**--help**] +[**-H**|**--human**[=*true*]] +[**--no-trunc**[=*false*]] +[**-q**|**--quiet**[=*false*]] +IMAGE + +# DESCRIPTION + +Show the history of when and how an image was created. + +# OPTIONS +**--help** + Print usage statement + +**-H**, **--human**=*true*|*false* + Print sizes and dates in human readable format. The default is *true*. + +**--no-trunc**=*true*|*false* + Don't truncate output. The default is *false*. + +**-q**, **--quiet**=*true*|*false* + Only show numeric IDs. The default is *false*. + +# EXAMPLES + $ docker history fedora + IMAGE CREATED CREATED BY SIZE COMMENT + 105182bb5e8b 5 days ago /bin/sh -c #(nop) ADD file:71356d2ad59aa3119d 372.7 MB + 73bd853d2ea5 13 days ago /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar 0 B + 511136ea3c5a 10 months ago 0 B Imported from - + +## Display comments in the image history +The `docker commit` command has a **-m** flag for adding comments to the image. These comments will be displayed in the image history. + + $ sudo docker history docker:scm + IMAGE CREATED CREATED BY SIZE COMMENT + 2ac9d1098bf1 3 months ago /bin/bash 241.4 MB Added Apache to Fedora base image + 88b42ffd1f7c 5 months ago /bin/sh -c #(nop) ADD file:1fd8d7f9f6557cafc7 373.7 MB + c69cab00d6ef 5 months ago /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar 0 B + 511136ea3c5a 19 months ago 0 B Imported from - + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-images.1.md b/man/docker-images.1.md new file mode 100644 index 0000000000..de4fee05c9 --- /dev/null +++ b/man/docker-images.1.md @@ -0,0 +1,100 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-images - List images + +# SYNOPSIS +**docker images** +[**--help**] +[**-a**|**--all**[=*false*]] +[**--digests**[=*false*]] +[**-f**|**--filter**[=*[]*]] +[**--no-trunc**[=*false*]] +[**-q**|**--quiet**[=*false*]] +[REPOSITORY[:TAG]] + +# DESCRIPTION +This command lists the images stored in the local Docker repository. + +By default, intermediate images, used during builds, are not listed. Some of the +output, e.g., image ID, is truncated, for space reasons. However the truncated +image ID, and often the first few characters, are enough to be used in other +Docker commands that use the image ID. The output includes repository, tag, image +ID, date created and the virtual size. + +The title REPOSITORY for the first title may seem confusing. It is essentially +the image name. However, because you can tag a specific image, and multiple tags +(image instances) can be associated with a single name, the name is really a +repository for all tagged images of the same name. For example consider an image +called fedora. It may be tagged with 18, 19, or 20, etc. to manage different +versions. + +# OPTIONS +**-a**, **--all**=*true*|*false* + Show all images (by default filter out the intermediate image layers). The default is *false*. + +**--digests**=*true*|*false* + Show image digests. The default is *false*. + +**-f**, **--filter**=[] + Filters the output. The dangling=true filter finds unused images. While label=com.foo=amd64 filters for images with a com.foo value of amd64. The label=com.foo filter finds images with the label com.foo of any value. + +**--help** + Print usage statement + +**--no-trunc**=*true*|*false* + Don't truncate output. The default is *false*. + +**-q**, **--quiet**=*true*|*false* + Only show numeric IDs. The default is *false*. + +# EXAMPLES + +## Listing the images + +To list the images in a local repository (not the registry) run: + + docker images + +The list will contain the image repository name, a tag for the image, and an +image ID, when it was created and its virtual size. Columns: REPOSITORY, TAG, +IMAGE ID, CREATED, and VIRTUAL SIZE. + +The `docker images` command takes an optional `[REPOSITORY[:TAG]]` argument +that restricts the list to images that match the argument. If you specify +`REPOSITORY`but no `TAG`, the `docker images` command lists all images in the +given repository. + + docker images java + +The `[REPOSITORY[:TAG]]` value must be an "exact match". This means that, for example, +`docker images jav` does not match the image `java`. + +If both `REPOSITORY` and `TAG` are provided, only images matching that +repository and tag are listed. To find all local images in the "java" +repository with tag "8" you can use: + + docker images java:8 + +To get a verbose list of images which contains all the intermediate images +used in builds use **-a**: + + docker images -a + +Previously, the docker images command supported the --tree and --dot arguments, +which displayed different visualizations of the image data. Docker core removed +this functionality in the 1.7 version. If you liked this functionality, you can +still find it in the third-party dockviz tool: https://github.com/justone/dockviz. + +## Listing only the shortened image IDs + +Listing just the shortened image IDs. This can be useful for some automated +tools. + + docker images -q + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-import.1.md b/man/docker-import.1.md new file mode 100644 index 0000000000..0509dd0d67 --- /dev/null +++ b/man/docker-import.1.md @@ -0,0 +1,72 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-import - Create an empty filesystem image and import the contents of the tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then optionally tag it. + +# SYNOPSIS +**docker import** +[**-c**|**--change**[=*[]*]] +[**-m**|**--message**[=*MESSAGE*]] +[**--help**] +file|URL|**-**[REPOSITORY[:TAG]] + +# OPTIONS +**-c**, **--change**=[] + Apply specified Dockerfile instructions while importing the image + Supported Dockerfile instructions: `CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR` + +**--help** + Print usage statement + +**-m**, **--message**="" + Set commit message for imported image + +# DESCRIPTION +Create a new filesystem image from the contents of a tarball (`.tar`, +`.tar.gz`, `.tgz`, `.bzip`, `.tar.xz`, `.txz`) into it, then optionally tag it. + + +# EXAMPLES + +## Import from a remote location + + # docker import http://example.com/exampleimage.tgz example/imagerepo + +## Import from a local file + +Import to docker via pipe and stdin: + + # cat exampleimage.tgz | docker import - example/imagelocal + +Import with a commit message + + # cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new + +Import to a Docker image from a local file. + + # docker import /path/to/exampleimage.tgz + + +## Import from a local file and tag + +Import to docker via pipe and stdin: + + # cat exampleimageV2.tgz | docker import - example/imagelocal:V-2.0 + +## Import from a local directory + + # tar -c . | docker import - exampleimagedir + +## Apply specified Dockerfile instructions while importing the image +This example sets the docker image ENV variable DEBUG to true by default. + + # tar -c . | docker import -c="ENV DEBUG true" - exampleimagedir + +# See also +**docker-export(1)** to export the contents of a filesystem as a tar archive to STDOUT. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-info.1.md b/man/docker-info.1.md new file mode 100644 index 0000000000..f67a4fb00c --- /dev/null +++ b/man/docker-info.1.md @@ -0,0 +1,50 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-info - Display system-wide information + +# SYNOPSIS +**docker info** +[**--help**] + + +# DESCRIPTION +This command displays system wide information regarding the Docker installation. +Information displayed includes the number of containers and images, pool name, +data file, metadata file, data space used, total data space, metadata space used +, total metadata space, execution driver, and the kernel version. + +The data file is where the images are stored and the metadata file is where the +meta data regarding those images are stored. When run for the first time Docker +allocates a certain amount of data space and meta data space from the space +available on the volume where `/var/lib/docker` is mounted. + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES + +## Display Docker system information + +Here is a sample output: + + # docker info + Containers: 14 + Images: 52 + Server Version: 1.9.0 + Storage Driver: aufs + Root Dir: /var/lib/docker/aufs + Dirs: 80 + Execution Driver: native-0.2 + Logging Driver: json-file + Kernel Version: 3.13.0-24-generic + Operating System: Ubuntu 14.04 LTS + CPUs: 1 + Total Memory: 2 GiB + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-inspect.1.md b/man/docker-inspect.1.md new file mode 100644 index 0000000000..34dd04a93a --- /dev/null +++ b/man/docker-inspect.1.md @@ -0,0 +1,308 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-inspect - Return low-level information on a container or image + +# SYNOPSIS +**docker inspect** +[**--help**] +[**-f**|**--format**[=*FORMAT*]] +[**-s**|**--size**[=*false*]] +[**--type**=*container*|*image*] +CONTAINER|IMAGE [CONTAINER|IMAGE...] + +# DESCRIPTION + +This displays all the information available in Docker for a given +container or image. By default, this will render all results in a JSON +array. If a format is specified, the given template will be executed for +each result. + +# OPTIONS +**--help** + Print usage statement + +**-f**, **--format**="" + Format the output using the given Go template. + +**-s**, **--size**=false + Display total file sizes if the type is container. + +**--type**=*container*|*image* + Return JSON for specified type, permissible values are "image" or "container" + +# EXAMPLES + +Get information about an image when image name conflicts with the container name, +e.g. both image and container are named rhel7: + + $ docker inspect --type=image rhel7 + [ + { + "Id": "fe01a428b9d9de35d29531e9994157978e8c48fa693e1bf1d221dffbbb67b170", + "Parent": "10acc31def5d6f249b548e01e8ffbaccfd61af0240c17315a7ad393d022c5ca2", + .... + } + ] + +## Getting information on a container + +To get information on a container use its ID or instance name: + + $ docker inspect d2cc496561d6 + [{ + "Id": "d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47", + "Created": "2015-06-08T16:18:02.505155285Z", + "Path": "bash", + "Args": [], + "State": { + "Running": false, + "Paused": false, + "Restarting": false, + "OOMKilled": false, + "Dead": false, + "Pid": 0, + "ExitCode": 0, + "Error": "", + "StartedAt": "2015-06-08T16:18:03.643865954Z", + "FinishedAt": "2015-06-08T16:57:06.448552862Z" + }, + "Image": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4", + "NetworkSettings": { + "Bridge": "", + "EndpointID": "", + "Gateway": "", + "GlobalIPv6Address": "", + "GlobalIPv6PrefixLen": 0, + "HairpinMode": false, + "IPAddress": "", + "IPPrefixLen": 0, + "IPv6Gateway": "", + "LinkLocalIPv6Address": "", + "LinkLocalIPv6PrefixLen": 0, + "MacAddress": "", + "NetworkID": "", + "Ports": null, + "SandboxKey": "", + "SecondaryIPAddresses": null, + "SecondaryIPv6Addresses": null + }, + "ResolvConfPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/resolv.conf", + "HostnamePath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hostname", + "HostsPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hosts", + "LogPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47-json.log", + "Name": "/adoring_wozniak", + "RestartCount": 0, + "Driver": "devicemapper", + "ExecDriver": "native-0.2", + "MountLabel": "", + "ProcessLabel": "", + "Mounts": [ + { + "Source": "/data", + "Destination": "/data", + "Mode": "ro,Z", + "RW": false + } + ], + "AppArmorProfile": "", + "ExecIDs": null, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 0, + "CpuPeriod": 0, + "CpusetCpus": "", + "CpusetMems": "", + "CpuQuota": 0, + "BlkioWeight": 0, + "OomKillDisable": false, + "Privileged": false, + "PortBindings": {}, + "Links": null, + "PublishAllPorts": false, + "Dns": null, + "DnsSearch": null, + "DnsOptions": null, + "ExtraHosts": null, + "VolumesFrom": null, + "Devices": [], + "NetworkMode": "bridge", + "IpcMode": "", + "PidMode": "", + "UTSMode": "", + "CapAdd": null, + "CapDrop": null, + "RestartPolicy": { + "Name": "no", + "MaximumRetryCount": 0 + }, + "SecurityOpt": null, + "ReadonlyRootfs": false, + "Ulimits": null, + "LogConfig": { + "Type": "json-file", + "Config": {} + }, + "CgroupParent": "" + }, + "GraphDriver": { + "Name": "devicemapper", + "Data": { + "DeviceId": "5", + "DeviceName": "docker-253:1-2763198-d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47", + "DeviceSize": "171798691840" + } + }, + "Config": { + "Hostname": "d2cc496561d6", + "Domainname": "", + "User": "", + "AttachStdin": true, + "AttachStdout": true, + "AttachStderr": true, + "ExposedPorts": null, + "Tty": true, + "OpenStdin": true, + "StdinOnce": true, + "Env": null, + "Cmd": [ + "bash" + ], + "Image": "fedora", + "Volumes": null, + "VolumeDriver": "", + "WorkingDir": "", + "Entrypoint": null, + "NetworkDisabled": false, + "MacAddress": "", + "OnBuild": null, + "Labels": {}, + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 0, + "Cpuset": "", + "StopSignal": "SIGTERM" + } + } + ] +## Getting the IP address of a container instance + +To get the IP address of a container use: + + $ docker inspect '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' d2cc496561d6 + 172.17.0.2 + +## Listing all port bindings + +One can loop over arrays and maps in the results to produce simple text +output: + + $ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} \ + {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' d2cc496561d6 + 80/tcp -> 80 + +You can get more information about how to write a Go template from: +https://golang.org/pkg/text/template/. + +## Getting size information on an container + + $ docker inspect -s d2cc496561d6 + [ + { + .... + "SizeRw": 0, + "SizeRootFs": 972, + .... + } + ] + +## Getting information on an image + +Use an image's ID or name (e.g., repository/name[:tag]) to get information +about the image: + + $ docker inspect ded7cd95e059 + [{ + "Id": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4", + "Parent": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731", + "Comment": "", + "Created": "2015-05-27T16:58:22.937503085Z", + "Container": "76cf7f67d83a7a047454b33007d03e32a8f474ad332c3a03c94537edd22b312b", + "ContainerConfig": { + "Hostname": "76cf7f67d83a", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "ExposedPorts": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "/bin/sh", + "-c", + "#(nop) ADD file:4be46382bcf2b095fcb9fe8334206b584eff60bb3fad8178cbd97697fcb2ea83 in /" + ], + "Image": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731", + "Volumes": null, + "VolumeDriver": "", + "WorkingDir": "", + "Entrypoint": null, + "NetworkDisabled": false, + "MacAddress": "", + "OnBuild": null, + "Labels": {} + }, + "DockerVersion": "1.6.0", + "Author": "Lokesh Mandvekar \u003clsm5@fedoraproject.org\u003e", + "Config": { + "Hostname": "76cf7f67d83a", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": false, + "AttachStderr": false, + "ExposedPorts": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": null, + "Image": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731", + "Volumes": null, + "VolumeDriver": "", + "WorkingDir": "", + "Entrypoint": null, + "NetworkDisabled": false, + "MacAddress": "", + "OnBuild": null, + "Labels": {} + }, + "Architecture": "amd64", + "Os": "linux", + "Size": 186507296, + "VirtualSize": 186507296, + "GraphDriver": { + "Name": "devicemapper", + "Data": { + "DeviceId": "3", + "DeviceName": "docker-253:1-2763198-ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4", + "DeviceSize": "171798691840" + } + } + } + ] + +# HISTORY +April 2014, originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +April 2015, updated by Qiang Huang +October 2015, updated by Sally O'Malley diff --git a/man/docker-kill.1.md b/man/docker-kill.1.md new file mode 100644 index 0000000000..cfab3f8e42 --- /dev/null +++ b/man/docker-kill.1.md @@ -0,0 +1,28 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-kill - Kill a running container using SIGKILL or a specified signal + +# SYNOPSIS +**docker kill** +[**--help**] +[**-s**|**--signal**[=*"KILL"*]] +CONTAINER [CONTAINER...] + +# DESCRIPTION + +The main process inside each container specified will be sent SIGKILL, + or any signal specified with option --signal. + +# OPTIONS +**--help** + Print usage statement + +**-s**, **--signal**="KILL" + Signal to send to the container + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) + based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-load.1.md b/man/docker-load.1.md new file mode 100644 index 0000000000..508ab6bbb9 --- /dev/null +++ b/man/docker-load.1.md @@ -0,0 +1,46 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-load - Load an image from a tar archive or STDIN + +# SYNOPSIS +**docker load** +[**--help**] +[**-i**|**--input**[=*INPUT*]] + + +# DESCRIPTION + +Loads a tarred repository from a file or the standard input stream. +Restores both images and tags. + +# OPTIONS +**--help** + Print usage statement + +**-i**, **--input**="" + Read from a tar archive file, instead of STDIN. The tarball may be compressed with gzip, bzip, or xz. + +# EXAMPLES + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + busybox latest 769b9341d937 7 weeks ago 2.489 MB + $ docker load --input fedora.tar + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + busybox latest 769b9341d937 7 weeks ago 2.489 MB + fedora rawhide 0d20aec6529d 7 weeks ago 387 MB + fedora 20 58394af37342 7 weeks ago 385.5 MB + fedora heisenbug 58394af37342 7 weeks ago 385.5 MB + fedora latest 58394af37342 7 weeks ago 385.5 MB + +# See also +**docker-save(1)** to save an image(s) to a tar archive (streamed to STDOUT by default). + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +July 2015 update by Mary Anthony diff --git a/man/docker-login.1.md b/man/docker-login.1.md new file mode 100644 index 0000000000..b87e2c1591 --- /dev/null +++ b/man/docker-login.1.md @@ -0,0 +1,51 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-login - Register or log in to a Docker registry. + +# SYNOPSIS +**docker login** +[**-e**|**--email**[=*EMAIL*]] +[**--help**] +[**-p**|**--password**[=*PASSWORD*]] +[**-u**|**--username**[=*USERNAME*]] +[SERVER] + +# DESCRIPTION +Register or log in to a Docker Registry located on the specified +`SERVER`. You can specify a URL or a `hostname` for the `SERVER` value. If you +do not specify a `SERVER`, the command uses Docker's public registry located at +`https://registry-1.docker.io/` by default. To get a username/password for Docker's public registry, create an account on Docker Hub. + +You can log into any public or private repository for which you have +credentials. When you log in, the command stores encoded credentials in +`$HOME/.docker/config.json` on Linux or `%USERPROFILE%/.docker/config.json` on Windows. + +# OPTIONS +**-e**, **--email**="" + Email + +**--help** + Print usage statement + +**-p**, **--password**="" + Password + +**-u**, **--username**="" + Username + +# EXAMPLES + +## Login to a registry on your localhost + + # docker login localhost:8080 + +# See also +**docker-logout(1)** to log out from a Docker registry. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +April 2015, updated by Mary Anthony for v2 diff --git a/man/docker-logout.1.md b/man/docker-logout.1.md new file mode 100644 index 0000000000..d116986798 --- /dev/null +++ b/man/docker-logout.1.md @@ -0,0 +1,32 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-logout - Log out from a Docker registry. + +# SYNOPSIS +**docker logout** +[SERVER] + +# DESCRIPTION +Log out of a Docker Registry located on the specified `SERVER`. You can +specify a URL or a `hostname` for the `SERVER` value. If you do not specify a +`SERVER`, the command attempts to log you out of Docker's public registry +located at `https://registry-1.docker.io/` by default. + +# OPTIONS +There are no available options. + +# EXAMPLES + +## Log out from a registry on your localhost + + # docker logout localhost:8080 + +# See also +**docker-login(1)** to register or log in to a Docker registry server. + +# HISTORY +June 2014, Originally compiled by Daniel, Dao Quang Minh (daniel at nitrous dot io) +July 2014, updated by Sven Dowideit +April 2015, updated by Mary Anthony for v2 diff --git a/man/docker-logs.1.md b/man/docker-logs.1.md new file mode 100644 index 0000000000..2925c35009 --- /dev/null +++ b/man/docker-logs.1.md @@ -0,0 +1,56 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-logs - Fetch the logs of a container + +# SYNOPSIS +**docker logs** +[**-f**|**--follow**[=*false*]] +[**--help**] +[**--since**[=*SINCE*]] +[**-t**|**--timestamps**[=*false*]] +[**--tail**[=*"all"*]] +CONTAINER + +# DESCRIPTION +The **docker logs** command batch-retrieves whatever logs are present for +a container at the time of execution. This does not guarantee execution +order when combined with a docker run (i.e., your run may not have generated +any logs at the time you execute docker logs). + +The **docker logs --follow** command combines commands **docker logs** and +**docker attach**. It will first return all logs from the beginning and +then continue streaming new output from the container’s stdout and stderr. + +**Warning**: This command works only for the **json-file** or **journald** +logging drivers. + +# OPTIONS +**--help** + Print usage statement + +**-f**, **--follow**=*true*|*false* + Follow log output. The default is *false*. + +**--since**="" + Show logs since timestamp + +**-t**, **--timestamps**=*true*|*false* + Show timestamps. The default is *false*. + +**--tail**="all" + Output the specified number of lines at the end of logs (defaults to all logs) + +The `--since` option shows only the container logs generated after +a given date. You can specify the date as an RFC 3339 date, a UNIX +timestamp, or a Go duration string (e.g. `1m30s`, `3h`). Docker computes +the date relative to the client machine’s time. You can combine +the `--since` option with either or both of the `--follow` or `--tail` options. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +July 2014, updated by Sven Dowideit +April 2015, updated by Ahmet Alp Balkan diff --git a/man/docker-network-connect.1.md b/man/docker-network-connect.1.md new file mode 100644 index 0000000000..7dc23eb313 --- /dev/null +++ b/man/docker-network-connect.1.md @@ -0,0 +1,55 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCT 2015 +# NAME +docker-network-connect - connect a container to a network + +# SYNOPSIS +**docker network connect NAME CONTAINER** + +[**--help**] + +# DESCRIPTION + +Connects a running container to a network. You can connect a container by name +or by ID. Once connected, the container can communicate with other containers in +the same network. + +```bash +$ docker network connect multi-host-network container1 +``` + +You can also use the `docker run --net=` option to start a container and immediately connect it to a network. + +```bash +$ docker run -itd --net=multi-host-network busybox +``` + +You can pause, restart, and stop containers that are connected to a network. +Paused containers remain connected and a revealed by a `network inspect`. When +the container is stopped, it does not appear on the network until you restart +it. The container's IP address is not guaranteed to remain the same when a +stopped container rejoins the network. + +To verify the container is connected, use the `docker network inspect` command. Use `docker network disconnect` to remove a container from the network. + +Once connected in network, containers can communicate using only another +container's IP address or name. For `overlay` networks or custom plugins that +support multi-host connectivity, containers connected to the same multi-host +network but launched from different Engines can also communicate in this way. + +You can connect a container to one or more networks. The networks need not be the same type. For example, you can connect a single container bridge and overlay networks. + + +# OPTIONS +**NAME** + Specify network driver name + +**CONTAINER** + Specify container name + +**--help** + Print usage statement + +# HISTORY +OCT 2015, created by Mary Anthony diff --git a/man/docker-network-create.1.md b/man/docker-network-create.1.md new file mode 100644 index 0000000000..308f2d6bfc --- /dev/null +++ b/man/docker-network-create.1.md @@ -0,0 +1,149 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCT 2015 +# NAME +docker-network-create - create a new network + +# SYNOPSIS +**docker network create** + +**--aux-address=map[]** +**-d** | **--driver=DRIVER** +**--gateway=[]** +**--help=false** +**--ip-range=[]** +**--ipam-driver=default** +**-o** | **--opt=map[]** +**--subnet=[]** + +# DESCRIPTION + +Creates a new network. The `DRIVER` accepts `bridge` or `overlay` which are the +built-in network drivers. If you have installed a third party or your own custom +network driver you can specify that `DRIVER` here also. If you don't specify the +`--driver` option, the command automatically creates a `bridge` network for you. +When you install Docker Engine it creates a `bridge` network automatically. This +network corresponds to the `docker0` bridge that Engine has traditionally relied +on. When launch a new container with `docker run` it automatically connects to +this bridge network. You cannot remove this default bridge network but you can +create new ones using the `network create` command. + +```bash +$ docker network create -d bridge my-bridge-network +``` + +Bridge networks are isolated networks on a single Engine installation. If you +want to create a network that spans multiple Docker hosts each running an +Engine, you must create an `overlay` network. Unlike `bridge` networks overlay +networks require some pre-existing conditions before you can create one. These +conditions are: + +* Access to a key-value store. Engine supports Consul, Etcd, and Zookeeper (Distributed store) key-value stores. +* A cluster of hosts with connectivity to the key-value store. +* A properly configured Engine `daemon` on each host in the cluster. + +The `docker daemon` options that support the `overlay` network are: + +* `--cluster-store` +* `--cluster-store-opt` +* `--cluster-advertise` + +To read more about these options and how to configure them, see ["*Get started +with multi-host +network*"](https://www.docker.com/engine/userguide/networking/get-started-overlay.md). + +It is also a good idea, though not required, that you install Docker Swarm on to +manage the cluster that makes up your network. Swarm provides sophisticated +discovery and server management that can assist your implementation. + +Once you have prepared the `overlay` network prerequisites you simply choose a +Docker host in the cluster and issue the following to create the network: + +```bash +$ docker network create -d overlay my-multihost-network +``` + +Network names must be unique. The Docker daemon attempts to identify naming +conflicts but this is not guaranteed. It is the user's responsibility to avoid +name conflicts. + +## Connect containers + +When you start a container use the `--net` flag to connect it to a network. +This adds the `busybox` container to the `mynet` network. + +```bash +$ docker run -itd --net=mynet busybox +``` + +If you want to add a container to a network after the container is already +running use the `docker network connect` subcommand. + +You can connect multiple containers to the same network. Once connected, the +containers can communicate using only another container's IP address or name. +For `overlay` networks or custom plugins that support multi-host connectivity, +containers connected to the same multi-host network but launched from different +Engines can also communicate in this way. + +You can disconnect a container from a network using the `docker network +disconnect` command. + +## Specifying advanced options + +When you create a network, Engine creates a non-overlapping subnetwork for the +network by default. This subnetwork is not a subdivision of an existing network. +It is purely for ip-addressing purposes. You can override this default and +specify subnetwork values directly using the the `--subnet` option. On a +`bridge` network you can only create a single subnet: + +```bash +docker network create -d --subnet=192.168.0.0/16 +``` +Additionally, you also specify the `--gateway` `--ip-range` and `--aux-address` options. + +```bash +network create --driver=bridge --subnet=172.28.0.0/16 --ip-range=172.28.5.0/24 --gateway=172.28.5.254 br0 +``` + +If you omit the `--gateway` flag the Engine selects one for you from inside a +preferred pool. For `overlay` networks and for network driver plugins that +support it you can create multiple subnetworks. + +```bash +docker network create -d overlay + --subnet=192.168.0.0/16 --subnet=192.170.0.0/16 + --gateway=192.168.0.100 --gateway=192.170.0.100 + --ip-range=192.168.1.0/24 + --aux-address a=192.168.1.5 --aux-address b=192.168.1.6 + --aux-address a=192.170.1.5 --aux-address b=192.170.1.6 + my-multihost-newtork +``` +Be sure that your subnetworks do not overlap. If they do, the network create fails and Engine returns an error. + +# OPTIONS +**--aux-address=map[]** + Auxiliary ipv4 or ipv6 addresses used by network driver + +**-d** | **--driver=DRIVER** + Driver to manage the Network bridge or overlay. The default is bridge. + +**--gateway=[] ** + ipv4 or ipv6 Gateway for the master subnet + +**--help=false ** + Print usage + +**--ip-range=[] ** + Allocate container ip from a sub-range + +**--ipam-driver=default ** + IP Address Management Driver + +**-o | --opt=map[]** + Set custom network plugin options + +**--subnet=[]** + Subnet in CIDR format that represents a network segment + +# HISTORY +OCT 2015, created by Mary Anthony diff --git a/man/docker-network-disconnect.1.md b/man/docker-network-disconnect.1.md new file mode 100644 index 0000000000..6cbc441195 --- /dev/null +++ b/man/docker-network-disconnect.1.md @@ -0,0 +1,32 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCT 2015 +# NAME +docker-network-disconnect - disconnect a container from a network + +# SYNOPSIS +**docker network disconnect NETWORK CONTAINER** + +[**--help**] + +# DESCRIPTION + +Disconnects a container from a network. The container must be running to disconnect it from the network. + +```bash + $ docker network disconnect multi-host-network container1 +``` + + +# OPTIONS +**NETWORK** + Specify network name + +**CONTAINER** + Specify container name + +**--help** + Print usage statement + +# HISTORY +OCT 2015, created by Mary Anthony diff --git a/man/docker-network-inspect.1.md b/man/docker-network-inspect.1.md new file mode 100644 index 0000000000..3b128223c6 --- /dev/null +++ b/man/docker-network-inspect.1.md @@ -0,0 +1,58 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCT 2015 +# NAME +docker-network-inspect - inspect a network + +# SYNOPSIS +**docker network inspect NETWORK [NETWORK...]** + +[**--help**] + +# DESCRIPTION + +Returns information about one or more networks. By default, this command renders all results in a JSON object. For example, if you connect two containers to a network: + +```bash +$ sudo docker run -itd --name=container1 busybox +f2870c98fd504370fb86e59f32cd0753b1ac9b69b7d80566ffc7192a82b3ed27 + +$ sudo docker run -itd --name=container2 busybox +bda12f8922785d1f160be70736f26c1e331ab8aaf8ed8d56728508f2e2fd4727 +``` + +The `network inspect` command shows the containers, by id, in its results. + +```bash +$ sudo docker network inspect bridge +[ + { + "name": "bridge", + "id": "7fca4eb8c647e57e9d46c32714271e0c3f8bf8d17d346629e2820547b2d90039", + "driver": "bridge", + "containers": { + "bda12f8922785d1f160be70736f26c1e331ab8aaf8ed8d56728508f2e2fd4727": { + "endpoint": "e0ac95934f803d7e36384a2029b8d1eeb56cb88727aa2e8b7edfeebaa6dfd758", + "mac_address": "02:42:ac:11:00:03", + "ipv4_address": "172.17.0.3/16", + "ipv6_address": "" + }, + "f2870c98fd504370fb86e59f32cd0753b1ac9b69b7d80566ffc7192a82b3ed27": { + "endpoint": "31de280881d2a774345bbfb1594159ade4ae4024ebfb1320cb74a30225f6a8ae", + "mac_address": "02:42:ac:11:00:02", + "ipv4_address": "172.17.0.2/16", + "ipv6_address": "" + } + } + } +] +``` + + +# OPTIONS + +**--help** + Print usage statement + +# HISTORY +OCT 2015, created by Mary Anthony diff --git a/man/docker-network-ls.1.md b/man/docker-network-ls.1.md new file mode 100644 index 0000000000..5dd2ad4804 --- /dev/null +++ b/man/docker-network-ls.1.md @@ -0,0 +1,51 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCT 2015 +# NAME +docker-network-ls - list networks + +# SYNOPSIS +**docker network ls** + +[**--no-trunc**] +[**-q** | **--quiet**] +[**--help**] + +# DESCRIPTION + +Lists all the networks the Engine `daemon` knows about. This includes the +networks that span across multiple hosts in a cluster, for example: + +```bash + $ sudo docker network ls + NETWORK ID NAME DRIVER + 7fca4eb8c647 bridge bridge + 9f904ee27bf5 none null + cf03ee007fb4 host host + 78b03ee04fc4 multi-host overlay +``` + +Use the `--no-trunc` option to display the full network id: + +```bash +docker network ls --no-trunc +NETWORK ID NAME DRIVER +18a2866682b85619a026c81b98a5e375bd33e1b0936a26cc497c283d27bae9b3 none null +c288470c46f6c8949c5f7e5099b5b7947b07eabe8d9a27d79a9cbf111adcbf47 host host +7b369448dccbf865d397c8d2be0cda7cf7edc6b0945f77d2529912ae917a0185 bridge bridge +95e74588f40db048e86320c6526440c504650a1ff3e9f7d60a497c4d2163e5bd foo bridge +``` + +# OPTIONS + +[**--no-trunc**] + Do not truncate the output + +[**-q** | **--quiet**] + Only display numeric IDs + +**--help** + Print usage statement + +# HISTORY +OCT 2015, created by Mary Anthony diff --git a/man/docker-network-rm.1.md b/man/docker-network-rm.1.md new file mode 100644 index 0000000000..d5c4515f67 --- /dev/null +++ b/man/docker-network-rm.1.md @@ -0,0 +1,29 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCT 2015 +# NAME +docker-network-rm - remove a new network + +# SYNOPSIS +**docker network rm NETWORK** + +[**--help**] + +# DESCRIPTION + +Removes a network by name or identifier. To remove a network, you must first disconnect any containers connected to it. + +``` + $ docker network rm my-network +``` + + +# OPTIONS +**NETWORK** + Specify network name + +**--help** + Print usage statement + +# HISTORY +OCT 2015, created by Mary Anthony diff --git a/man/docker-pause.1.md b/man/docker-pause.1.md new file mode 100644 index 0000000000..5d2267af62 --- /dev/null +++ b/man/docker-pause.1.md @@ -0,0 +1,30 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-pause - Pause all processes within a container + +# SYNOPSIS +**docker pause** +CONTAINER [CONTAINER...] + +# DESCRIPTION + +The `docker pause` command uses the cgroups freezer to suspend all processes in +a container. Traditionally when suspending a process the `SIGSTOP` signal is +used, which is observable by the process being suspended. With the cgroups freezer +the process is unaware, and unable to capture, that it is being suspended, +and subsequently resumed. + +See the [cgroups freezer documentation] +(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for +further details. + +# OPTIONS +There are no available options. + +# See also +**docker-unpause(1)** to unpause all processes within a container. + +# HISTORY +June 2014, updated by Sven Dowideit diff --git a/man/docker-port.1.md b/man/docker-port.1.md new file mode 100644 index 0000000000..83e9cf93b6 --- /dev/null +++ b/man/docker-port.1.md @@ -0,0 +1,47 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-port - List port mappings for the CONTAINER, or lookup the public-facing port that is NAT-ed to the PRIVATE_PORT + +# SYNOPSIS +**docker port** +[**--help**] +CONTAINER [PRIVATE_PORT[/PROTO]] + +# DESCRIPTION +List port mappings for the CONTAINER, or lookup the public-facing port that is NAT-ed to the PRIVATE_PORT + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES + + # docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + b650456536c7 busybox:latest top 54 minutes ago Up 54 minutes 0.0.0.0:1234->9876/tcp, 0.0.0.0:4321->7890/tcp test + +## Find out all the ports mapped + + # docker port test + 7890/tcp -> 0.0.0.0:4321 + 9876/tcp -> 0.0.0.0:1234 + +## Find out a specific mapping + + # docker port test 7890/tcp + 0.0.0.0:4321 + + # docker port test 7890 + 0.0.0.0:4321 + +## An example showing error for non-existent mapping + + # docker port test 7890/udp + 2014/06/24 11:53:36 Error: No public port '7890/udp' published for test + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +June 2014, updated by Sven Dowideit +November 2014, updated by Sven Dowideit diff --git a/man/docker-ps.1.md b/man/docker-ps.1.md new file mode 100644 index 0000000000..3f3e0a3908 --- /dev/null +++ b/man/docker-ps.1.md @@ -0,0 +1,133 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% FEBRUARY 2015 +# NAME +docker-ps - List containers + +# SYNOPSIS +**docker ps** +[**-a**|**--all**[=*false*]] +[**--before**[=*BEFORE*]] +[**-f**|**--filter**[=*[]*]] +[**--format**=*"TEMPLATE"*] +[**--help**] +[**-l**|**--latest**[=*false*]] +[**-n**[=*-1*]] +[**--no-trunc**[=*false*]] +[**-q**|**--quiet**[=*false*]] +[**-s**|**--size**[=*false*]] +[**--since**[=*SINCE*]] + +# DESCRIPTION + +List the containers in the local repository. By default this shows only +the running containers. + +# OPTIONS +**-a**, **--all**=*true*|*false* + Show all containers. Only running containers are shown by default. The default is *false*. + +**--before**="" + Show only containers created before Id or Name, including non-running containers. + +**-f**, **--filter**=[] + Provide filter values. Valid filters: + exited= - containers with exit code of + label= or label== + status=(created|restarting|running|paused|exited) + name= - container's name + id= - container's ID + ancestor=([:tag]||) - filters containers that were + created from the given image or a descendant. + +**--format**=*"TEMPLATE"* + Pretty-print containers using a Go template. + Valid placeholders: + .ID - Container ID + .Image - Image ID + .Command - Quoted command + .CreatedAt - Time when the container was created. + .RunningFor - Elapsed time since the container was started. + .Ports - Exposed ports. + .Status - Container status. + .Size - Container disk size. + .Labels - All labels asigned to the container. + .Label - Value of a specific label for this container. For example `{{.Label "com.docker.swarm.cpu"}}` + +**--help** + Print usage statement + +**-l**, **--latest**=*true*|*false* + Show only the latest created container, include non-running ones. The default is *false*. + +**-n**=-1 + Show n last created containers, include non-running ones. + +**--no-trunc**=*true*|*false* + Don't truncate output. The default is *false*. + +**-q**, **--quiet**=*true*|*false* + Only display numeric IDs. The default is *false*. + +**-s**, **--size**=*true*|*false* + Display total file sizes. The default is *false*. + +**--since**="" + Show only containers created since Id or Name, include non-running ones. + +# EXAMPLES +# Display all containers, including non-running + + # docker ps -a + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + a87ecb4f327c fedora:20 /bin/sh -c #(nop) MA 20 minutes ago Exit 0 desperate_brattain + 01946d9d34d8 vpavlin/rhel7:latest /bin/sh -c #(nop) MA 33 minutes ago Exit 0 thirsty_bell + c1d3b0166030 acffc0358b9e /bin/sh -c yum -y up 2 weeks ago Exit 1 determined_torvalds + 41d50ecd2f57 fedora:20 /bin/sh -c #(nop) MA 2 weeks ago Exit 0 drunk_pike + +# Display only IDs of all containers, including non-running + + # docker ps -a -q + a87ecb4f327c + 01946d9d34d8 + c1d3b0166030 + 41d50ecd2f57 + +# Display only IDs of all containers that have the name `determined_torvalds` + + # docker ps -a -q --filter=name=determined_torvalds + c1d3b0166030 + +# Display containers with their commands + + # docker ps --format "{{.ID}}: {{.Command}}" + a87ecb4f327c: /bin/sh -c #(nop) MA + 01946d9d34d8: /bin/sh -c #(nop) MA + c1d3b0166030: /bin/sh -c yum -y up + 41d50ecd2f57: /bin/sh -c #(nop) MA + +# Display containers with their labels in a table + + # docker ps --format "table {{.ID}}\t{{.Labels}}" + CONTAINER ID LABELS + a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd + 01946d9d34d8 + c1d3b0166030 com.docker.swarm.node=debian,com.docker.swarm.cpu=6 + 41d50ecd2f57 com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd + +# Display containers with their node label in a table + + # docker ps --format 'table {{.ID}}\t{{(.Label "com.docker.swarm.node")}}' + CONTAINER ID NODE + a87ecb4f327c ubuntu + 01946d9d34d8 + c1d3b0166030 debian + 41d50ecd2f57 fedora + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +August 2014, updated by Sven Dowideit +November 2014, updated by Sven Dowideit +February 2015, updated by André Martins diff --git a/man/docker-pull.1.md b/man/docker-pull.1.md new file mode 100644 index 0000000000..c4359fbdad --- /dev/null +++ b/man/docker-pull.1.md @@ -0,0 +1,91 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-pull - Pull an image or a repository from a registry + +# SYNOPSIS +**docker pull** +[**-a**|**--all-tags**[=*false*]] +[**--help**] +NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG] + +# DESCRIPTION + +This command pulls down an image or a repository from a registry. If +there is more than one image for a repository (e.g., fedora) then all +images for that repository name can be pulled down including any tags +(see the option **-a** or **--all-tags**). + +If you do not specify a `REGISTRY_HOST`, the command uses Docker's public +registry located at `registry-1.docker.io` by default. + +# OPTIONS +**-a**, **--all-tags**=*true*|*false* + Download all tagged images in the repository. The default is *false*. + +**--help** + Print usage statement + +# EXAMPLE + +## Pull a repository with multiple images with the -a|--all-tags option set to true. +Note that if the image is previously downloaded then the status would be +`Status: Image is up to date for fedora`. + + $ docker pull --all-tags fedora + Pulling repository fedora + ad57ef8d78d7: Download complete + 105182bb5e8b: Download complete + 511136ea3c5a: Download complete + 73bd853d2ea5: Download complete + + Status: Downloaded newer image for fedora + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + fedora rawhide ad57ef8d78d7 5 days ago 359.3 MB + fedora 20 105182bb5e8b 5 days ago 372.7 MB + fedora heisenbug 105182bb5e8b 5 days ago 372.7 MB + fedora latest 105182bb5e8b 5 days ago 372.7 MB + +## Pull a repository with the -a|--all-tags option set to false (this is the default). + + $ docker pull debian + Using default tag: latest + latest: Pulling from library/debian + 2c49f83e0b13: Pull complete + 4a5e6db8c069: Pull complete + + Status: Downloaded newer image for debian:latest + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + debian latest 4a5e6db8c069 5 days ago 125.1 MB + + +## Pull an image, manually specifying path to Docker's public registry and tag +Note that if the image is previously downloaded then the status would be +`Status: Image is up to date for registry.hub.docker.com/fedora:20` + + $ docker pull registry.hub.docker.com/fedora:20 + Pulling repository fedora + 3f2fed40e4b0: Download complete + 511136ea3c5a: Download complete + fd241224e9cf: Download complete + + Status: Downloaded newer image for registry.hub.docker.com/fedora:20 + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + fedora 20 3f2fed40e4b0 4 days ago 372.7 MB + + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +August 2014, updated by Sven Dowideit +April 2015, updated by John Willis +April 2015, updated by Mary Anthony for v2 +September 2015, updated by Sally O'Malley diff --git a/man/docker-push.1.md b/man/docker-push.1.md new file mode 100644 index 0000000000..cf4bc255f1 --- /dev/null +++ b/man/docker-push.1.md @@ -0,0 +1,52 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-push - Push an image or a repository to a registry + +# SYNOPSIS +**docker push** +[**--help**] +NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG] + +# DESCRIPTION + +This command pushes an image or a repository to a registry. If you do not +specify a `REGISTRY_HOST`, the command uses Docker's public registry located at +`registry-1.docker.io` by default. + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES + +# Pushing a new image to a registry + +First save the new image by finding the container ID (using **docker ps**) +and then committing it to a new image name. Note that only a-z0-9-_. are +allowed when naming images: + + # docker commit c16378f943fe rhel-httpd + +Now, push the image to the registry using the image ID. In this example the +registry is on host named `registry-host` and listening on port `5000`. To do +this, tag the image with the host name or IP address, and the port of the +registry: + + # docker tag rhel-httpd registry-host:5000/myadmin/rhel-httpd + # docker push registry-host:5000/myadmin/rhel-httpd + +Check that this worked by running: + + # docker images + +You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd` +listed. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +April 2015, updated by Mary Anthony for v2 +June 2015, updated by Sally O'Malley diff --git a/man/docker-rename.1.md b/man/docker-rename.1.md new file mode 100644 index 0000000000..aa19a03ae7 --- /dev/null +++ b/man/docker-rename.1.md @@ -0,0 +1,15 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% OCTOBER 2014 +# NAME +docker-rename - Rename a container + +# SYNOPSIS +**docker rename** +OLD_NAME NEW_NAME + +# OPTIONS +There are no available options. + +# DESCRIPTION +Rename a container. Container may be running, paused or stopped. diff --git a/man/docker-restart.1.md b/man/docker-restart.1.md new file mode 100644 index 0000000000..9f60bc5434 --- /dev/null +++ b/man/docker-restart.1.md @@ -0,0 +1,26 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-restart - Restart a container + +# SYNOPSIS +**docker restart** +[**--help**] +[**-t**|**--time**[=*10*]] +CONTAINER [CONTAINER...] + +# DESCRIPTION +Restart each container listed. + +# OPTIONS +**--help** + Print usage statement + +**-t**, **--time**=10 + Number of seconds to try to stop for before killing the container. Once killed it will then be restarted. Default is 10 seconds. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-rm.1.md b/man/docker-rm.1.md new file mode 100644 index 0000000000..af73b804c9 --- /dev/null +++ b/man/docker-rm.1.md @@ -0,0 +1,56 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-rm - Remove one or more containers + +# SYNOPSIS +**docker rm** +[**-f**|**--force**[=*false*]] +[**-l**|**--link**[=*false*]] +[**-v**|**--volumes**[=*false*]] +CONTAINER [CONTAINER...] + +# DESCRIPTION + +**docker rm** will remove one or more containers from the host node. The +container name or ID can be used. This does not remove images. You cannot +remove a running container unless you use the **-f** option. To see all +containers on a host use the **docker ps -a** command. + +# OPTIONS +**--help** + Print usage statement + +**-f**, **--force**=*true*|*false* + Force the removal of a running container (uses SIGKILL). The default is *false*. + +**-l**, **--link**=*true*|*false* + Remove the specified link and not the underlying container. The default is *false*. + +**-v**, **--volumes**=*true*|*false* + Remove the volumes associated with the container. The default is *false*. + +# EXAMPLES + +## Removing a container using its ID + +To remove a container using its ID, find either from a **docker ps -a** +command, or use the ID returned from the **docker run** command, or retrieve +it from a file used to store it using the **docker run --cidfile**: + + docker rm abebf7571666 + +## Removing a container using the container name + +The name of the container can be found using the **docker ps -a** +command. The use that name as follows: + + docker rm hopeful_morse + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +July 2014, updated by Sven Dowideit +August 2014, updated by Sven Dowideit diff --git a/man/docker-rmi.1.md b/man/docker-rmi.1.md new file mode 100644 index 0000000000..01dc64f52a --- /dev/null +++ b/man/docker-rmi.1.md @@ -0,0 +1,42 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-rmi - Remove one or more images + +# SYNOPSIS +**docker rmi** +[**-f**|**--force**[=*false*]] +[**--help**] +[**--no-prune**[=*false*]] +IMAGE [IMAGE...] + +# DESCRIPTION + +Removes one or more images from the host node. This does not remove images from +a registry. You cannot remove an image of a running container unless you use the +**-f** option. To see all images on a host use the **docker images** command. + +# OPTIONS +**-f**, **--force**=*true*|*false* + Force removal of the image. The default is *false*. + +**--help** + Print usage statement + +**--no-prune**=*true*|*false* + Do not delete untagged parents. The default is *false*. + +# EXAMPLES + +## Removing an image + +Here is an example of removing an image: + + docker rmi fedora/httpd + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +April 2015, updated by Mary Anthony for v2 diff --git a/man/docker-run.1.md b/man/docker-run.1.md new file mode 100644 index 0000000000..0a12682920 --- /dev/null +++ b/man/docker-run.1.md @@ -0,0 +1,734 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-run - Run a command in a new container + +# SYNOPSIS +**docker run** +[**-a**|**--attach**[=*[]*]] +[**--add-host**[=*[]*]] +[**--blkio-weight**[=*[BLKIO-WEIGHT]*]] +[**--cpu-shares**[=*0*]] +[**--cap-add**[=*[]*]] +[**--cap-drop**[=*[]*]] +[**--cgroup-parent**[=*CGROUP-PATH*]] +[**--cidfile**[=*CIDFILE*]] +[**--cpu-period**[=*0*]] +[**--cpu-quota**[=*0*]] +[**--cpuset-cpus**[=*CPUSET-CPUS*]] +[**--cpuset-mems**[=*CPUSET-MEMS*]] +[**-d**|**--detach**[=*false*]] +[**--device**[=*[]*]] +[**--dns**[=*[]*]] +[**--dns-opt**[=*[]*]] +[**--dns-search**[=*[]*]] +[**-e**|**--env**[=*[]*]] +[**--entrypoint**[=*ENTRYPOINT*]] +[**--env-file**[=*[]*]] +[**--expose**[=*[]*]] +[**--group-add**[=*[]*]] +[**-h**|**--hostname**[=*HOSTNAME*]] +[**--help**] +[**-i**|**--interactive**[=*false*]] +[**--ipc**[=*IPC*]] +[**--kernel-memory**[=*KERNEL-MEMORY*]] +[**-l**|**--label**[=*[]*]] +[**--label-file**[=*[]*]] +[**--link**[=*[]*]] +[**--log-driver**[=*[]*]] +[**--log-opt**[=*[]*]] +[**--lxc-conf**[=*[]*]] +[**-m**|**--memory**[=*MEMORY*]] +[**--mac-address**[=*MAC-ADDRESS*]] +[**--memory-reservation**[=*MEMORY-RESERVATION*]] +[**--memory-swap**[=*MEMORY-SWAP*]] +[**--memory-swappiness**[=*MEMORY-SWAPPINESS*]] +[**--name**[=*NAME*]] +[**--net**[=*"bridge"*]] +[**--oom-kill-disable**[=*false*]] +[**-P**|**--publish-all**[=*false*]] +[**-p**|**--publish**[=*[]*]] +[**--pid**[=*[]*]] +[**--privileged**[=*false*]] +[**--read-only**[=*false*]] +[**--restart**[=*RESTART*]] +[**--rm**[=*false*]] +[**--security-opt**[=*[]*]] +[**--stop-signal**[=*SIGNAL*]] +[**--sig-proxy**[=*true*]] +[**-t**|**--tty**[=*false*]] +[**-u**|**--user**[=*USER*]] +[**-v**|**--volume**[=*[]*]] +[**--ulimit**[=*[]*]] +[**--uts**[=*[]*]] +[**--volumes-from**[=*[]*]] +[**-w**|**--workdir**[=*WORKDIR*]] +IMAGE [COMMAND] [ARG...] + +# DESCRIPTION + +Run a process in a new container. **docker run** starts a process with its own +file system, its own networking, and its own isolated process tree. The IMAGE +which starts the process may define defaults related to the process that will be +run in the container, the networking to expose, and more, but **docker run** +gives final control to the operator or administrator who starts the container +from the image. For that reason **docker run** has more options than any other +Docker command. + +If the IMAGE is not already loaded then **docker run** will pull the IMAGE, and +all image dependencies, from the repository in the same way running **docker +pull** IMAGE, before it starts the container from that image. + +# OPTIONS +**-a**, **--attach**=[] + Attach to STDIN, STDOUT or STDERR. + + In foreground mode (the default when **-d** +is not specified), **docker run** can start the process in the container +and attach the console to the process’s standard input, output, and standard +error. It can even pretend to be a TTY (this is what most commandline +executables expect) and pass along signals. The **-a** option can be set for +each of stdin, stdout, and stderr. + +**--add-host**=[] + Add a custom host-to-IP mapping (host:ip) + + Add a line to /etc/hosts. The format is hostname:ip. The **--add-host** +option can be set multiple times. + +**--blkio-weight**=0 + Block IO weight (relative weight) accepts a weight value between 10 and 1000. + +**--cpu-shares**=0 + CPU shares (relative weight) + + By default, all containers get the same proportion of CPU cycles. This proportion +can be modified by changing the container's CPU share weighting relative +to the weighting of all other running containers. + +To modify the proportion from the default of 1024, use the **--cpu-shares** +flag to set the weighting to 2 or higher. + +The proportion will only apply when CPU-intensive processes are running. +When tasks in one container are idle, other containers can use the +left-over CPU time. The actual amount of CPU time will vary depending on +the number of containers running on the system. + +For example, consider three containers, one has a cpu-share of 1024 and +two others have a cpu-share setting of 512. When processes in all three +containers attempt to use 100% of CPU, the first container would receive +50% of the total CPU time. If you add a fourth container with a cpu-share +of 1024, the first container only gets 33% of the CPU. The remaining containers +receive 16.5%, 16.5% and 33% of the CPU. + +On a multi-core system, the shares of CPU time are distributed over all CPU +cores. Even if a container is limited to less than 100% of CPU time, it can +use 100% of each individual CPU core. + +For example, consider a system with more than three cores. If you start one +container **{C0}** with **-c=512** running one process, and another container +**{C1}** with **-c=1024** running two processes, this can result in the following +division of CPU shares: + + PID container CPU CPU share + 100 {C0} 0 100% of CPU0 + 101 {C1} 1 100% of CPU1 + 102 {C1} 2 100% of CPU2 + +**--cap-add**=[] + Add Linux capabilities + +**--cap-drop**=[] + Drop Linux capabilities + +**--cgroup-parent**="" + Path to cgroups under which the cgroup for the container will be created. If the path is not absolute, the path is considered to be relative to the cgroups path of the init process. Cgroups will be created if they do not already exist. + +**--cidfile**="" + Write the container ID to the file + +**--cpu-period**=0 + Limit the CPU CFS (Completely Fair Scheduler) period + + Limit the container's CPU usage. This flag tell the kernel to restrict the container's CPU usage to the period you specify. + +**--cpuset-cpus**="" + CPUs in which to allow execution (0-3, 0,1) + +**--cpuset-mems**="" + Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems. + + If you have four memory nodes on your system (0-3), use `--cpuset-mems=0,1` +then processes in your Docker container will only use memory from the first +two memory nodes. + +**--cpu-quota**=0 + Limit the CPU CFS (Completely Fair Scheduler) quota + + Limit the container's CPU usage. By default, containers run with the full +CPU resource. This flag tell the kernel to restrict the container's CPU usage +to the quota you specify. + +**-d**, **--detach**=*true*|*false* + Detached mode: run the container in the background and print the new container ID. The default is *false*. + + At any time you can run **docker ps** in +the other shell to view a list of the running containers. You can reattach to a +detached container with **docker attach**. If you choose to run a container in +the detached mode, then you cannot use the **-rm** option. + + When attached in the tty mode, you can detach from a running container without +stopping the process by pressing the keys CTRL-P CTRL-Q. + +**--device**=[] + Add a host device to the container (e.g. --device=/dev/sdc:/dev/xvdc:rwm) + +**--dns-search**=[] + Set custom DNS search domains (Use --dns-search=. if you don't wish to set the search domain) + +**--dns-opt**=[] + Set custom DNS options + +**--dns**=[] + Set custom DNS servers + + This option can be used to override the DNS +configuration passed to the container. Typically this is necessary when the +host DNS configuration is invalid for the container (e.g., 127.0.0.1). When this +is the case the **--dns** flags is necessary for every run. + +**-e**, **--env**=[] + Set environment variables + + This option allows you to specify arbitrary +environment variables that are available for the process that will be launched +inside of the container. + +**--entrypoint**="" + Overwrite the default ENTRYPOINT of the image + + This option allows you to overwrite the default entrypoint of the image that +is set in the Dockerfile. The ENTRYPOINT of an image is similar to a COMMAND +because it specifies what executable to run when the container starts, but it is +(purposely) more difficult to override. The ENTRYPOINT gives a container its +default nature or behavior, so that when you set an ENTRYPOINT you can run the +container as if it were that binary, complete with default options, and you can +pass in more options via the COMMAND. But, sometimes an operator may want to run +something else inside the container, so you can override the default ENTRYPOINT +at runtime by using a **--entrypoint** and a string to specify the new +ENTRYPOINT. + +**--env-file**=[] + Read in a line delimited file of environment variables + +**--expose**=[] + Expose a port, or a range of ports (e.g. --expose=3300-3310) informs Docker +that the container listens on the specified network ports at runtime. Docker +uses this information to interconnect containers using links and to set up port +redirection on the host system. + +**--group-add**=[] + Add additional groups to run as + +**-h**, **--hostname**="" + Container host name + + Sets the container host name that is available inside the container. + +**--help** + Print usage statement + +**-i**, **--interactive**=*true*|*false* + Keep STDIN open even if not attached. The default is *false*. + + When set to true, keep stdin open even if not attached. The default is false. + +**--ipc**="" + Default is to create a private IPC namespace (POSIX SysV IPC) for the container + 'container:': reuses another container shared memory, semaphores and message queues + 'host': use the host shared memory,semaphores and message queues inside the container. Note: the host mode gives the container full access to local shared memory and is therefore considered insecure. + +**-l**, **--label**=[] + Set metadata on the container (e.g., --label com.example.key=value) + +**--kernel-memory**="" + Kernel memory limit (format: `[]`, where unit = b, k, m or g) + + Constrains the kernel memory available to a container. If a limit of 0 +is specified (not using `--kernel-memory`), the container's kernel memory +is not limited. If you specify a limit, it may be rounded up to a multiple +of the operating system's page size and the value can be very large, +millions of trillions. + +**--label-file**=[] + Read in a line delimited file of labels + +**--link**=[] + Add link to another container in the form of :alias or just +in which case the alias will match the name + + If the operator +uses **--link** when starting the new client container, then the client +container can access the exposed port via a private networking interface. Docker +will set some environment variables in the client container to help indicate +which interface and port to use. + +**--lxc-conf**=[] + (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" + +**--log-driver**="|*json-file*|*syslog*|*journald*|*gelf*|*fluentd*|*awslogs*|*none*" + Logging driver for container. Default is defined by daemon `--log-driver` flag. + **Warning**: the `docker logs` command works only for the `json-file` and + `journald` logging drivers. + +**--log-opt**=[] + Logging driver specific options. + +**-m**, **--memory**="" + Memory limit (format: [], where unit = b, k, m or g) + + Allows you to constrain the memory available to a container. If the host +supports swap memory, then the **-m** memory setting can be larger than physical +RAM. If a limit of 0 is specified (not using **-m**), the container's memory is +not limited. The actual limit may be rounded up to a multiple of the operating +system's page size (the value would be very large, that's millions of trillions). + +**--memory-reservation**="" + Memory soft limit (format: [], where unit = b, k, m or g) + + After setting memory reservation, when the system detects memory contention +or low memory, containers are forced to restrict their consumption to their +reservation. So you should always set the value below **--memory**, otherwise the +hard limit will take precedence. By default, memory reservation will be the same +as memory limit. + +**--memory-swap**="" + Total memory limit (memory + swap) + + Set `-1` to disable swap (format: [], where unit = b, k, m or g). +This value should always larger than **-m**, so you should always use this with **-m**. + +**--mac-address**="" + Container MAC address (e.g. 92:d0:c6:0a:29:33) + + Remember that the MAC address in an Ethernet network must be unique. +The IPv6 link-local address will be based on the device's MAC address +according to RFC4862. + +**--name**="" + Assign a name to the container + + The operator can identify a container in three ways: + UUID long identifier (“f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778”) + UUID short identifier (“f78375b1c487”) + Name (“jonah”) + + The UUID identifiers come from the Docker daemon, and if a name is not assigned +to the container with **--name** then the daemon will also generate a random +string name. The name is useful when defining links (see **--link**) (or any +other place you need to identify a container). This works for both background +and foreground Docker containers. + +**--net**="bridge" + Set the Network mode for the container + 'bridge': creates a new network stack for the container on the docker bridge + 'none': no networking for this container + 'container:': reuses another container network stack + 'host': use the host network stack inside the container. Note: the host mode gives the container full access to local system services such as D-bus and is therefore considered insecure. + +**--oom-kill-disable**=*true*|*false* + Whether to disable OOM Killer for the container or not. + +**-P**, **--publish-all**=*true*|*false* + Publish all exposed ports to random ports on the host interfaces. The default is *false*. + + When set to true publish all exposed ports to the host interfaces. The +default is false. If the operator uses -P (or -p) then Docker will make the +exposed port accessible on the host and the ports will be available to any +client that can reach the host. When using -P, Docker will bind any exposed +port to a random port on the host within an *ephemeral port range* defined by +`/proc/sys/net/ipv4/ip_local_port_range`. To find the mapping between the host +ports and the exposed ports, use `docker port`. + +**-p**, **--publish**=[] + Publish a container's port, or range of ports, to the host. + + Format: `ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort | containerPort` +Both hostPort and containerPort can be specified as a range of ports. +When specifying ranges for both, the number of container ports in the range must match the number of host ports in the range. +(e.g., `docker run -p 1234-1236:1222-1224 --name thisWorks -t busybox` +but not `docker run -p 1230-1236:1230-1240 --name RangeContainerPortsBiggerThanRangeHostPorts -t busybox`) +With ip: `docker run -p 127.0.0.1:$HOSTPORT:$CONTAINERPORT --name CONTAINER -t someimage` +Use `docker port` to see the actual mapping: `docker port CONTAINER $CONTAINERPORT` + +**--pid**=host + Set the PID mode for the container + **host**: use the host's PID namespace inside the container. + Note: the host mode gives the container full access to local PID and is therefore considered insecure. + +**--uts**=host + Set the UTS mode for the container + **host**: use the host's UTS namespace inside the container. + Note: the host mode gives the container access to changing the host's hostname and is therefore considered insecure. + +**--privileged**=*true*|*false* + Give extended privileges to this container. The default is *false*. + + By default, Docker containers are +“unprivileged” (=false) and cannot, for example, run a Docker daemon inside the +Docker container. This is because by default a container is not allowed to +access any devices. A “privileged” container is given access to all devices. + + When the operator executes **docker run --privileged**, Docker will enable access +to all devices on the host as well as set some configuration in AppArmor to +allow the container nearly all the same access to the host as processes running +outside of a container on the host. + +**--read-only**=*true*|*false* + Mount the container's root filesystem as read only. + + By default a container will have its root filesystem writable allowing processes +to write files anywhere. By specifying the `--read-only` flag the container will have +its root filesystem mounted as read only prohibiting any writes. + +**--restart**="no" + Restart policy to apply when a container exits (no, on-failure[:max-retry], always, unless-stopped). + +**--rm**=*true*|*false* + Automatically remove the container when it exits (incompatible with -d). The default is *false*. + +**--security-opt**=[] + Security Options + + "label:user:USER" : Set the label user for the container + "label:role:ROLE" : Set the label role for the container + "label:type:TYPE" : Set the label type for the container + "label:level:LEVEL" : Set the label level for the container + "label:disable" : Turn off label confinement for the container + +**--stop-signal**=SIGTERM + Signal to stop a container. Default is SIGTERM. + +**--sig-proxy**=*true*|*false* + Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied. The default is *true*. + +**--memory-swappiness**="" + Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. + +**-t**, **--tty**=*true*|*false* + Allocate a pseudo-TTY. The default is *false*. + + When set to true Docker can allocate a pseudo-tty and attach to the standard +input of any container. This can be used, for example, to run a throwaway +interactive shell. The default is value is false. + +The **-t** option is incompatible with a redirection of the docker client +standard input. + +**-u**, **--user**="" + Sets the username or UID used and optionally the groupname or GID for the specified command. + + The followings examples are all valid: + --user [user | user:group | uid | uid:gid | user:gid | uid:group ] + + Without this argument the command will be run as root in the container. + +""--ulimit""=[] + Ulimit options + +**-v**, **--volume**=[] Create a bind mount + (format: `[host-dir:]container-dir[:]`, where suffix options +are comma delimited and selected from [rw|ro] and [z|Z].) + + (e.g., using -v /host-dir:/container-dir, bind mounts /host-dir in the +host to /container-dir in the Docker container) + + If 'host-dir' is missing, then docker automatically creates the new volume +on the host. **This auto-creation of the host path has been deprecated in +Release: v1.9.** + + The **-v** option can be used one or +more times to add one or more mounts to a container. These mounts can then be +used in other containers using the **--volumes-from** option. + + The volume may be optionally suffixed with :ro or :rw to mount the volumes in +read-only or read-write mode, respectively. By default, the volumes are mounted +read-write. See examples. + +Labeling systems like SELinux require that proper labels are placed on volume +content mounted into a container. Without a label, the security system might +prevent the processes running inside the container from using the content. By +default, Docker does not change the labels set by the OS. + +To change a label in the container context, you can add either of two suffixes +`:z` or `:Z` to the volume mount. These suffixes tell Docker to relabel file +objects on the shared volumes. The `z` option tells Docker that two containers +share the volume content. As a result, Docker labels the content with a shared +content label. Shared volume labels allow all containers to read/write content. +The `Z` option tells Docker to label the content with a private unshared label. +Only the current container can use a private volume. + +The `container-dir` must always be an absolute path such as `/src/docs`. +The `host-dir` can either be an absolute path or a `name` value. If you +supply an absolute path for the `host-dir`, Docker bind-mounts to the path +you specify. If you supply a `name`, Docker creates a named volume by that `name`. + +A `name` value must start with start with an alphanumeric character, +followed by `a-z0-9`, `_` (underscore), `.` (period) or `-` (hyphen). +An absolute path starts with a `/` (forward slash). + +For example, you can specify either `/foo` or `foo` for a `host-dir` value. +If you supply the `/foo` value, Docker creates a bind-mount. If you supply +the `foo` specification, Docker creates a named volume. + +**--volumes-from**=[] + Mount volumes from the specified container(s) + + Mounts already mounted volumes from a source container onto another + container. You must supply the source's container-id. To share + a volume, use the **--volumes-from** option when running + the target container. You can share volumes even if the source container + is not running. + + By default, Docker mounts the volumes in the same mode (read-write or + read-only) as it is mounted in the source container. Optionally, you + can change this by suffixing the container-id with either the `:ro` or + `:rw ` keyword. + + If the location of the volume from the source container overlaps with + data residing on a target container, then the volume hides + that data on the target. + +**-w**, **--workdir**="" + Working directory inside the container + + The default working directory for +running binaries within a container is the root directory (/). The developer can +set a different default with the Dockerfile WORKDIR instruction. The operator +can override the working directory by using the **-w** option. + +# EXAMPLES + +## Exposing log messages from the container to the host's log + +If you want messages that are logged in your container to show up in the host's +syslog/journal then you should bind mount the /dev/log directory as follows. + + # docker run -v /dev/log:/dev/log -i -t fedora /bin/bash + +From inside the container you can test this by sending a message to the log. + + (bash)# logger "Hello from my container" + +Then exit and check the journal. + + # exit + + # journalctl -b | grep Hello + +This should list the message sent to logger. + +## Attaching to one or more from STDIN, STDOUT, STDERR + +If you do not specify -a then Docker will attach everything (stdin,stdout,stderr) +. You can specify to which of the three standard streams (stdin, stdout, stderr) +you’d like to connect instead, as in: + + # docker run -a stdin -a stdout -i -t fedora /bin/bash + +## Sharing IPC between containers + +Using shm_server.c available here: https://www.cs.cf.ac.uk/Dave/C/node27.html + +Testing `--ipc=host` mode: + +Host shows a shared memory segment with 7 pids attached, happens to be from httpd: + +``` + $ sudo ipcs -m + + ------ Shared Memory Segments -------- + key shmid owner perms bytes nattch status + 0x01128e25 0 root 600 1000 7 +``` + +Now run a regular container, and it correctly does NOT see the shared memory segment from the host: + +``` + $ docker run -it shm ipcs -m + + ------ Shared Memory Segments -------- + key shmid owner perms bytes nattch status +``` + +Run a container with the new `--ipc=host` option, and it now sees the shared memory segment from the host httpd: + + ``` + $ docker run -it --ipc=host shm ipcs -m + + ------ Shared Memory Segments -------- + key shmid owner perms bytes nattch status + 0x01128e25 0 root 600 1000 7 +``` +Testing `--ipc=container:CONTAINERID` mode: + +Start a container with a program to create a shared memory segment: +``` + $ docker run -it shm bash + $ sudo shm/shm_server & + $ sudo ipcs -m + + ------ Shared Memory Segments -------- + key shmid owner perms bytes nattch status + 0x0000162e 0 root 666 27 1 +``` +Create a 2nd container correctly shows no shared memory segment from 1st container: +``` + $ docker run shm ipcs -m + + ------ Shared Memory Segments -------- + key shmid owner perms bytes nattch status +``` + +Create a 3rd container using the new --ipc=container:CONTAINERID option, now it shows the shared memory segment from the first: + +``` + $ docker run -it --ipc=container:ed735b2264ac shm ipcs -m + $ sudo ipcs -m + + ------ Shared Memory Segments -------- + key shmid owner perms bytes nattch status + 0x0000162e 0 root 666 27 1 +``` + +## Linking Containers + +The link feature allows multiple containers to communicate with each other. For +example, a container whose Dockerfile has exposed port 80 can be run and named +as follows: + + # docker run --name=link-test -d -i -t fedora/httpd + +A second container, in this case called linker, can communicate with the httpd +container, named link-test, by running with the **--link=:** + + # docker run -t -i --link=link-test:lt --name=linker fedora /bin/bash + +Now the container linker is linked to container link-test with the alias lt. +Running the **env** command in the linker container shows environment variables + with the LT (alias) context (**LT_**) + + # env + HOSTNAME=668231cb0978 + TERM=xterm + LT_PORT_80_TCP=tcp://172.17.0.3:80 + LT_PORT_80_TCP_PORT=80 + LT_PORT_80_TCP_PROTO=tcp + LT_PORT=tcp://172.17.0.3:80 + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + PWD=/ + LT_NAME=/linker/lt + SHLVL=1 + HOME=/ + LT_PORT_80_TCP_ADDR=172.17.0.3 + _=/usr/bin/env + +When linking two containers Docker will use the exposed ports of the container +to create a secure tunnel for the parent to access. + +If a container is connected to the default bridge network and `linked` +with other containers, then the container's `/etc/hosts` file is updated +with the linked container's name. + +> **Note** Since Docker may live update the container’s `/etc/hosts` file, there +may be situations when processes inside the container can end up reading an +empty or incomplete `/etc/hosts` file. In most cases, retrying the read again +should fix the problem. + + +## Mapping Ports for External Usage + +The exposed port of an application can be mapped to a host port using the **-p** +flag. For example, a httpd port 80 can be mapped to the host port 8080 using the +following: + + # docker run -p 8080:80 -d -i -t fedora/httpd + +## Creating and Mounting a Data Volume Container + +Many applications require the sharing of persistent data across several +containers. Docker allows you to create a Data Volume Container that other +containers can mount from. For example, create a named container that contains +directories /var/volume1 and /tmp/volume2. The image will need to contain these +directories so a couple of RUN mkdir instructions might be required for you +fedora-data image: + + # docker run --name=data -v /var/volume1 -v /tmp/volume2 -i -t fedora-data true + # docker run --volumes-from=data --name=fedora-container1 -i -t fedora bash + +Multiple --volumes-from parameters will bring together multiple data volumes from +multiple containers. And it's possible to mount the volumes that came from the +DATA container in yet another container via the fedora-container1 intermediary +container, allowing to abstract the actual data source from users of that data: + + # docker run --volumes-from=fedora-container1 --name=fedora-container2 -i -t fedora bash + +## Mounting External Volumes + +To mount a host directory as a container volume, specify the absolute path to +the directory and the absolute path for the container directory separated by a +colon: + + # docker run -v /var/db:/data1 -i -t fedora bash + +When using SELinux, be aware that the host has no knowledge of container SELinux +policy. Therefore, in the above example, if SELinux policy is enforced, the +`/var/db` directory is not writable to the container. A "Permission Denied" +message will occur and an avc: message in the host's syslog. + + +To work around this, at time of writing this man page, the following command +needs to be run in order for the proper SELinux policy type label to be attached +to the host directory: + + # chcon -Rt svirt_sandbox_file_t /var/db + + +Now, writing to the /data1 volume in the container will be allowed and the +changes will also be reflected on the host in /var/db. + +## Using alternative security labeling + +You can override the default labeling scheme for each container by specifying +the `--security-opt` flag. For example, you can specify the MCS/MLS level, a +requirement for MLS systems. Specifying the level in the following command +allows you to share the same content between containers. + + # docker run --security-opt label:level:s0:c100,c200 -i -t fedora bash + +An MLS example might be: + + # docker run --security-opt label:level:TopSecret -i -t rhel7 bash + +To disable the security labeling for this container versus running with the +`--permissive` flag, use the following command: + + # docker run --security-opt label:disable -i -t fedora bash + +If you want a tighter security policy on the processes within a container, +you can specify an alternate type for the container. You could run a container +that is only allowed to listen on Apache ports by executing the following +command: + + # docker run --security-opt label:type:svirt_apache_t -i -t centos bash + +Note: + +You would have to write policy defining a `svirt_apache_t` type. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +July 2014, updated by Sven Dowideit diff --git a/man/docker-save.1.md b/man/docker-save.1.md new file mode 100644 index 0000000000..5f336ffd34 --- /dev/null +++ b/man/docker-save.1.md @@ -0,0 +1,45 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-save - Save an image(s) to a tar archive (streamed to STDOUT by default) + +# SYNOPSIS +**docker save** +[**--help**] +[**-o**|**--output**[=*OUTPUT*]] +IMAGE [IMAGE...] + +# DESCRIPTION +Produces a tarred repository to the standard output stream. Contains all +parent layers, and all tags + versions, or specified repo:tag. + +Stream to a file instead of STDOUT by using **-o**. + +# OPTIONS +**--help** + Print usage statement + +**-o**, **--output**="" + Write to a file, instead of STDOUT + +# EXAMPLES + +Save all fedora repository images to a fedora-all.tar and save the latest +fedora image to a fedora-latest.tar: + + $ docker save fedora > fedora-all.tar + $ docker save --output=fedora-latest.tar fedora:latest + $ ls -sh fedora-all.tar + 721M fedora-all.tar + $ ls -sh fedora-latest.tar + 367M fedora-latest.tar + +# See also +**docker-load(1)** to load an image from a tar archive on STDIN. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +November 2014, updated by Sven Dowideit diff --git a/man/docker-search.1.md b/man/docker-search.1.md new file mode 100644 index 0000000000..a199f80db7 --- /dev/null +++ b/man/docker-search.1.md @@ -0,0 +1,65 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-search - Search the Docker Hub for images + +# SYNOPSIS +**docker search** +[**--automated**[=*false*]] +[**--help**] +[**--no-trunc**[=*false*]] +[**-s**|**--stars**[=*0*]] +TERM + +# DESCRIPTION + +Search Docker Hub for images that match the specified `TERM`. The table +of images returned displays the name, description (truncated by default), number +of stars awarded, whether the image is official, and whether it is automated. + +*Note* - Search queries will only return up to 25 results + +# OPTIONS +**--automated**=*true*|*false* + Only show automated builds. The default is *false*. + +**--help** + Print usage statement + +**--no-trunc**=*true*|*false* + Don't truncate output. The default is *false*. + +**-s**, **--stars**=X + Only displays with at least X stars. The default is zero. + +# EXAMPLES + +## Search Docker Hub for ranked images + +Search a registry for the term 'fedora' and only display those images +ranked 3 or higher: + + $ docker search -s 3 fedora + NAME DESCRIPTION STARS OFFICIAL AUTOMATED + mattdm/fedora A basic Fedora image corresponding roughly... 50 + fedora (Semi) Official Fedora base image. 38 + mattdm/fedora-small A small Fedora image on which to build. Co... 8 + goldmann/wildfly A WildFly application server running on a ... 3 [OK] + +## Search Docker Hub for automated images + +Search Docker Hub for the term 'fedora' and only display automated images +ranked 1 or higher: + + $ docker search --automated -s 1 fedora + NAME DESCRIPTION STARS OFFICIAL AUTOMATED + goldmann/wildfly A WildFly application server running on a ... 3 [OK] + tutum/fedora-20 Fedora 20 image with SSH access. For the r... 1 [OK] + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +April 2015, updated by Mary Anthony for v2 + diff --git a/man/docker-start.1.md b/man/docker-start.1.md new file mode 100644 index 0000000000..2e1191b095 --- /dev/null +++ b/man/docker-start.1.md @@ -0,0 +1,34 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-start - Start one or more containers + +# SYNOPSIS +**docker start** +[**-a**|**--attach**[=*false*]] +[**--help**] +[**-i**|**--interactive**[=*false*]] +CONTAINER [CONTAINER...] + +# DESCRIPTION + +Start one or more containers. + +# OPTIONS +**-a**, **--attach**=*true*|*false* + Attach container's STDOUT and STDERR and forward all signals to the process. The default is *false*. + +**--help** + Print usage statement + +**-i**, **--interactive**=*true*|*false* + Attach container's STDIN. The default is *false*. + +# See also +**docker-stop(1)** to stop a container. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-stats.1.md b/man/docker-stats.1.md new file mode 100644 index 0000000000..6bfa59e40f --- /dev/null +++ b/man/docker-stats.1.md @@ -0,0 +1,31 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-stats - Display a live stream of one or more containers' resource usage statistics + +# SYNOPSIS +**docker stats** +[**--help**] +[**--no-stream**[=*false*]] +CONTAINER [CONTAINER...] + +# DESCRIPTION + +Display a live stream of one or more containers' resource usage statistics + +# OPTIONS +**--help** + Print usage statement + +**--no-stream**="false" + Disable streaming stats and only pull the first result + +# EXAMPLES + +Run **docker stats** with multiple containers. + + $ docker stats redis1 redis2 + CONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O + redis1 0.07% 796 KB / 64 MB 1.21% 788 B / 648 B 3.568 MB / 512 KB + redis2 0.07% 2.746 MB / 64 MB 4.29% 1.266 KB / 648 B 12.4 MB / 0 B diff --git a/man/docker-stop.1.md b/man/docker-stop.1.md new file mode 100644 index 0000000000..c4daffa3bb --- /dev/null +++ b/man/docker-stop.1.md @@ -0,0 +1,30 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-stop - Stop a container by sending SIGTERM and then SIGKILL after a grace period + +# SYNOPSIS +**docker stop** +[**--help**] +[**-t**|**--time**[=*10*]] +CONTAINER [CONTAINER...] + +# DESCRIPTION +Stop a container (Send SIGTERM, and then SIGKILL after + grace period) + +# OPTIONS +**--help** + Print usage statement + +**-t**, **--time**=10 + Number of seconds to wait for the container to stop before killing it. Default is 10 seconds. + +#See also +**docker-start(1)** to restart a stopped container. + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker-tag.1.md b/man/docker-tag.1.md new file mode 100644 index 0000000000..ed4bffadb6 --- /dev/null +++ b/man/docker-tag.1.md @@ -0,0 +1,65 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-tag - Tag an image into a repository + +# SYNOPSIS +**docker tag** +[**-f**|**--force**[=*false*]] +[**--help**] +IMAGE[:TAG] [REGISTRY_HOST/][USERNAME/]NAME[:TAG] + +# DESCRIPTION +Assigns a new alias to an image in a registry. An alias refers to the +entire image name including the optional `TAG` after the ':'. + +If you do not specify a `REGISTRY_HOST`, the command uses Docker's public +registry located at `registry-1.docker.io` by default. + +# "OPTIONS" +**-f**, **--force**=*true*|*false* + When set to true, force the alias. The default is *false*. + +**--help** + Print usage statement. + +**REGISTRY_HOST** + The hostname of the registry if required. This may also include the port +separated by a ':' + +**USERNAME** + The username or other qualifying identifier for the image. + +**NAME** + The image name. + +**TAG** + The tag you are assigning to the image. Though this is arbitrary it is +recommended to be used for a version to distinguish images with the same name. +Also, for consistency tags should only include a-z0-9-_. . +Note that here TAG is a part of the overall name or "tag". + +# EXAMPLES + +## Giving an image a new alias + +Here is an example of aliasing an image (e.g., 0e5574283393) as "httpd" and +tagging it into the "fedora" repository with "version1.0": + + docker tag 0e5574283393 fedora/httpd:version1.0 + +## Tagging an image for a private repository + +To push an image to a private registry and not the central Docker +registry you must tag it with the registry hostname and port (if needed). + + docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0 + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +July 2014, updated by Sven Dowideit +April 2015, updated by Mary Anthony for v2 +June 2015, updated by Sally O'Malley diff --git a/man/docker-top.1.md b/man/docker-top.1.md new file mode 100644 index 0000000000..9828d98be5 --- /dev/null +++ b/man/docker-top.1.md @@ -0,0 +1,34 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-top - Display the running processes of a container + +# SYNOPSIS +**docker top** +[**--help**] +CONTAINER [ps OPTIONS] + +# DESCRIPTION + +Display the running process of the container. ps-OPTION can be any of the + options you would pass to a Linux ps command. + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES + +Run **docker top** with the ps option of -x: + + $ docker top 8601afda2b -x + PID TTY STAT TIME COMMAND + 16623 ? Ss 0:00 sleep 99999 + + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit +June 2015, updated by Ma Shimiao diff --git a/man/docker-unpause.1.md b/man/docker-unpause.1.md new file mode 100644 index 0000000000..466e1bb1a3 --- /dev/null +++ b/man/docker-unpause.1.md @@ -0,0 +1,27 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-unpause - Unpause all processes within a container + +# SYNOPSIS +**docker unpause** +CONTAINER [CONTAINER...] + +# DESCRIPTION + +The `docker unpause` command uses the cgroups freezer to un-suspend all +processes in a container. + +See the [cgroups freezer documentation] +(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for +further details. + +# OPTIONS +There are no available options. + +# See also +**docker-pause(1)** to pause all processes within a container. + +# HISTORY +June 2014, updated by Sven Dowideit diff --git a/man/docker-version.1.md b/man/docker-version.1.md new file mode 100644 index 0000000000..04ae3464f8 --- /dev/null +++ b/man/docker-version.1.md @@ -0,0 +1,62 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2015 +# NAME +docker-version - Show the Docker version information. + +# SYNOPSIS +**docker version** +[**--help**] +[**-f**|**--format**[=*FORMAT*]] + +# DESCRIPTION +This command displays version information for both the Docker client and +daemon. + +# OPTIONS +**--help** + Print usage statement + +**-f**, **--format**="" + Format the output using the given go template. + +# EXAMPLES + +## Display Docker version information + +The default output: + + $ docker version + Client: + Version: 1.8.0 + API version: 1.20 + Go version: go1.4.2 + Git commit: f5bae0a + Built: Tue Jun 23 17:56:00 UTC 2015 + OS/Arch: linux/amd64 + + Server: + Version: 1.8.0 + API version: 1.20 + Go version: go1.4.2 + Git commit: f5bae0a + Built: Tue Jun 23 17:56:00 UTC 2015 + OS/Arch: linux/amd64 + +Get server version: + + $ docker version --format '{{.Server.Version}}' + 1.8.0 + +Dump raw data: + +To view all available fields, you can use the format `{{json .}}`. + + $ docker version --format '{{json .}}' + {"Client":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"},"ServerOK":true,"Server":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","KernelVersion":"3.13.2-gentoo","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"}} + + +# HISTORY +June 2014, updated by Sven Dowideit +June 2015, updated by John Howard +June 2015, updated by Patrick Hemmer diff --git a/man/docker-volume-inspect.1.md b/man/docker-volume-inspect.1.md new file mode 100644 index 0000000000..6097e96e13 --- /dev/null +++ b/man/docker-volume-inspect.1.md @@ -0,0 +1,29 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JULY 2015 +# NAME +docker-volume-inspect - Get low-level information about a volume + +# SYNOPSIS +**docker volume inspect** +[**-f**|**--format**[=*FORMAT*]] +[**--help**] +VOLUME [VOLUME...] + +# DESCRIPTION + +Returns information about one or more volumes. By default, this command renders all results +in a JSON array. You can specify an alternate format to execute a given template +is executed for each result. Go's +http://golang.org/pkg/text/template/ package describes all the details of the +format. + +# OPTIONS +**-f**, **--format**="" + Format the output using the given go template. + +**--help** + Print usage statement + +# HISTORY +July 2015, created by Brian Goff diff --git a/man/docker-volume-ls.1.md b/man/docker-volume-ls.1.md new file mode 100644 index 0000000000..dd79cae8a6 --- /dev/null +++ b/man/docker-volume-ls.1.md @@ -0,0 +1,30 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JULY 2015 +# NAME +docker-volume-ls - List all volumes + +# SYNOPSIS +**docker volume ls** +[**-f**|**--filter**[=*FILTER*]] +[**--help**] +[**-q**|**--quiet**[=*true*|*false*]] + +# DESCRIPTION + +Lists all the volumes Docker knows about. You can filter using the `-f` or `--filter` flag. The filtering format is a `key=value` pair. To specify more than one filter, pass multiple flags (for example, `--filter "foo=bar" --filter "bif=baz"`) + +There is a single supported filter `dangling=value` which takes a boolean of `true` or `false`. + +# OPTIONS +**-f**, **--filter**="" + Provide filter values (i.e. 'dangling=true') + +**--help** + Print usage statement + +**-q**, **--quiet**=false + Only display volume names + +# HISTORY +July 2015, created by Brian Goff diff --git a/man/docker-volume-rm.1.md b/man/docker-volume-rm.1.md new file mode 100644 index 0000000000..876700d4d4 --- /dev/null +++ b/man/docker-volume-rm.1.md @@ -0,0 +1,26 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JULY 2015 +# NAME +docker-volume-rm - Remove a volume + +# SYNOPSIS +**docker volume rm** +[**--help**] +VOLUME [VOLUME...] + +# DESCRIPTION + +Removes one or more volumes. You cannot remove a volume that is in use by a container. + + ``` + $ docker volume rm hello + hello + ``` + +# OPTIONS +**--help** + Print usage statement + +# HISTORY +July 2015, created by Brian Goff diff --git a/man/docker-wait.1.md b/man/docker-wait.1.md new file mode 100644 index 0000000000..5f07bacc0e --- /dev/null +++ b/man/docker-wait.1.md @@ -0,0 +1,30 @@ +% DOCKER(1) Docker User Manuals +% Docker Community +% JUNE 2014 +# NAME +docker-wait - Block until a container stops, then print its exit code. + +# SYNOPSIS +**docker wait** +[**--help**] +CONTAINER [CONTAINER...] + +# DESCRIPTION + +Block until a container stops, then print its exit code. + +# OPTIONS +**--help** + Print usage statement + +# EXAMPLES + + $ docker run -d fedora sleep 99 + 079b83f558a2bc52ecad6b2a5de13622d584e6bb1aea058c11b36511e85e7622 + $ docker wait 079b83f558a2bc + 0 + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) +based on docker.com source material and internal work. +June 2014, updated by Sven Dowideit diff --git a/man/docker.1.md b/man/docker.1.md new file mode 100644 index 0000000000..18df3b5cf2 --- /dev/null +++ b/man/docker.1.md @@ -0,0 +1,245 @@ +% DOCKER(1) Docker User Manuals +% William Henry +% APRIL 2014 +# NAME +docker \- Docker image and container command line interface + +# SYNOPSIS +**docker** [OPTIONS] COMMAND [arg...] + +**docker** daemon [ --help | ... ] + +**docker** [ --help | -v | --version ] + +# DESCRIPTION +**docker** has two distinct functions. It is used for starting the Docker +daemon and to run the CLI (i.e., to command the daemon to manage images, +containers etc.) So **docker** is both a server, as a daemon, and a client +to the daemon, through the CLI. + +To run the Docker daemon you can specify **docker daemon**. +You can view the daemon options using **docker daemon --help**. +To see the man page for the daemon, run **man docker daemon**. + +The Docker CLI has over 30 commands. The commands are listed below and each has +its own man page which explain usage and arguments. + +To see the man page for a command run **man docker **. + +# OPTIONS +**--help** + Print usage statement + +**--config**="" + Specifies the location of the Docker client configuration files. The default is '~/.docker'. + +**-D**, **--debug**=*true*|*false* + Enable debug mode. Default is false. + +**-H**, **--host**=[unix:///var/run/docker.sock]: tcp://[host]:[port][path] to bind or +unix://[/path/to/socket] to use. + The socket(s) to bind to in daemon mode specified using one or more + tcp://host:port/path, unix:///path/to/socket, fd://* or fd://socketfd. + If the tcp port is not specified, then it will default to either `2375` when + `--tls` is off, or `2376` when `--tls` is on, or `--tlsverify` is specified. + +**-l**, **--log-level**="*debug*|*info*|*warn*|*error*|*fatal*"" + Set the logging level. Default is `info`. + +**--tls**=*true*|*false* + Use TLS; implied by --tlsverify. Default is false. + +**--tlscacert**=~/.docker/ca.pem + Trust certs signed only by this CA. + +**--tlscert**=~/.docker/cert.pem + Path to TLS certificate file. + +**--tlskey**=~/.docker/key.pem + Path to TLS key file. + +**--tlsverify**=*true*|*false* + Use TLS and verify the remote (daemon: verify client, client: verify daemon). + Default is false. + +**-v**, **--version**=*true*|*false* + Print version information and quit. Default is false. + +# COMMANDS +**attach** + Attach to a running container + See **docker-attach(1)** for full documentation on the **attach** command. + +**build** + Build an image from a Dockerfile + See **docker-build(1)** for full documentation on the **build** command. + +**commit** + Create a new image from a container's changes + See **docker-commit(1)** for full documentation on the **commit** command. + +**cp** + Copy files/folders between a container and the local filesystem + See **docker-cp(1)** for full documentation on the **cp** command. + +**create** + Create a new container + See **docker-create(1)** for full documentation on the **create** command. + +**diff** + Inspect changes on a container's filesystem + See **docker-diff(1)** for full documentation on the **diff** command. + +**events** + Get real time events from the server + See **docker-events(1)** for full documentation on the **events** command. + +**exec** + Run a command in a running container + See **docker-exec(1)** for full documentation on the **exec** command. + +**export** + Stream the contents of a container as a tar archive + See **docker-export(1)** for full documentation on the **export** command. + +**history** + Show the history of an image + See **docker-history(1)** for full documentation on the **history** command. + +**images** + List images + See **docker-images(1)** for full documentation on the **images** command. + +**import** + Create a new filesystem image from the contents of a tarball + See **docker-import(1)** for full documentation on the **import** command. + +**info** + Display system-wide information + See **docker-info(1)** for full documentation on the **info** command. + +**inspect** + Return low-level information on a container or image + See **docker-inspect(1)** for full documentation on the **inspect** command. + +**kill** + Kill a running container (which includes the wrapper process and everything +inside it) + See **docker-kill(1)** for full documentation on the **kill** command. + +**load** + Load an image from a tar archive + See **docker-load(1)** for full documentation on the **load** command. + +**login** + Register or login to a Docker Registry + See **docker-login(1)** for full documentation on the **login** command. + +**logout** + Log the user out of a Docker Registry + See **docker-logout(1)** for full documentation on the **logout** command. + +**logs** + Fetch the logs of a container + See **docker-logs(1)** for full documentation on the **logs** command. + +**pause** + Pause all processes within a container + See **docker-pause(1)** for full documentation on the **pause** command. + +**port** + Lookup the public-facing port which is NAT-ed to PRIVATE_PORT + See **docker-port(1)** for full documentation on the **port** command. + +**ps** + List containers + See **docker-ps(1)** for full documentation on the **ps** command. + +**pull** + Pull an image or a repository from a Docker Registry + See **docker-pull(1)** for full documentation on the **pull** command. + +**push** + Push an image or a repository to a Docker Registry + See **docker-push(1)** for full documentation on the **push** command. + +**rename** + Rename a container. + See **docker-rename(1)** for full documentation on the **rename** command. + +**restart** + Restart a container + See **docker-restart(1)** for full documentation on the **restart** command. + +**rm** + Remove one or more containers + See **docker-rm(1)** for full documentation on the **rm** command. + +**rmi** + Remove one or more images + See **docker-rmi(1)** for full documentation on the **rmi** command. + +**run** + Run a command in a new container + See **docker-run(1)** for full documentation on the **run** command. + +**save** + Save an image to a tar archive + See **docker-save(1)** for full documentation on the **save** command. + +**search** + Search for an image in the Docker index + See **docker-search(1)** for full documentation on the **search** command. + +**start** + Start a container + See **docker-start(1)** for full documentation on the **start** command. + +**stats** + Display a live stream of one or more containers' resource usage statistics + See **docker-stats(1)** for full documentation on the **stats** command. + +**stop** + Stop a container + See **docker-stop(1)** for full documentation on the **stop** command. + +**tag** + Tag an image into a repository + See **docker-tag(1)** for full documentation on the **tag** command. + +**top** + Lookup the running processes of a container + See **docker-top(1)** for full documentation on the **top** command. + +**unpause** + Unpause all processes within a container + See **docker-unpause(1)** for full documentation on the **unpause** command. + +**version** + Show the Docker version information + See **docker-version(1)** for full documentation on the **version** command. + +**wait** + Block until a container stops, then print its exit code + See **docker-wait(1)** for full documentation on the **wait** command. + +# EXEC DRIVER OPTIONS + +Use the **--exec-opt** flags to specify options to the exec-driver. The only +driver that accepts this flag is the *native* (libcontainer) driver. As a +result, you must also specify **-s=**native for this option to have effect. The +following is the only *native* option: + +#### native.cgroupdriver +Specifies the management of the container's `cgroups`. You can specify +`cgroupfs` or `systemd`. If you specify `systemd` and it is not available, the +system uses `cgroupfs`. + +#### Client +For specific client examples please see the man page for the specific Docker +command. For example: + + man docker-run + +# HISTORY +April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. diff --git a/man/md2man-all.sh b/man/md2man-all.sh new file mode 100755 index 0000000000..97c65c93bc --- /dev/null +++ b/man/md2man-all.sh @@ -0,0 +1,22 @@ +#!/bin/bash +set -e + +# get into this script's directory +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")" + +[ "$1" = '-q' ] || { + set -x + pwd +} + +for FILE in *.md; do + base="$(basename "$FILE")" + name="${base%.md}" + num="${name##*.}" + if [ -z "$num" -o "$name" = "$num" ]; then + # skip files that aren't of the format xxxx.N.md (like README.md) + continue + fi + mkdir -p "./man${num}" + go-md2man -in "$FILE" -out "./man${num}/${name}" +done diff --git a/opts/envfile.go b/opts/envfile.go new file mode 100644 index 0000000000..ba8b4f2016 --- /dev/null +++ b/opts/envfile.go @@ -0,0 +1,67 @@ +package opts + +import ( + "bufio" + "fmt" + "os" + "strings" +) + +// ParseEnvFile reads a file with environment variables enumerated by lines +// +// ``Environment variable names used by the utilities in the Shell and +// Utilities volume of IEEE Std 1003.1-2001 consist solely of uppercase +// letters, digits, and the '_' (underscore) from the characters defined in +// Portable Character Set and do not begin with a digit. *But*, other +// characters may be permitted by an implementation; applications shall +// tolerate the presence of such names.'' +// -- http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html +// +// As of #16585, it's up to application inside docker to validate or not +// environment variables, that's why we just strip leading whitespace and +// nothing more. +func ParseEnvFile(filename string) ([]string, error) { + fh, err := os.Open(filename) + if err != nil { + return []string{}, err + } + defer fh.Close() + + lines := []string{} + scanner := bufio.NewScanner(fh) + for scanner.Scan() { + // trim the line from all leading whitespace first + line := strings.TrimLeft(scanner.Text(), whiteSpaces) + // line is not empty, and not starting with '#' + if len(line) > 0 && !strings.HasPrefix(line, "#") { + data := strings.SplitN(line, "=", 2) + + // trim the front of a variable, but nothing else + variable := strings.TrimLeft(data[0], whiteSpaces) + if strings.ContainsAny(variable, whiteSpaces) { + return []string{}, ErrBadEnvVariable{fmt.Sprintf("variable '%s' has white spaces", variable)} + } + + if len(data) > 1 { + + // pass the value through, no trimming + lines = append(lines, fmt.Sprintf("%s=%s", variable, data[1])) + } else { + // if only a pass-through variable is given, clean it up. + lines = append(lines, fmt.Sprintf("%s=%s", strings.TrimSpace(line), os.Getenv(line))) + } + } + } + return lines, scanner.Err() +} + +var whiteSpaces = " \t" + +// ErrBadEnvVariable typed error for bad environment variable +type ErrBadEnvVariable struct { + msg string +} + +func (e ErrBadEnvVariable) Error() string { + return fmt.Sprintf("poorly formatted environment: %s", e.msg) +} diff --git a/opts/envfile_test.go b/opts/envfile_test.go new file mode 100644 index 0000000000..a172267b5b --- /dev/null +++ b/opts/envfile_test.go @@ -0,0 +1,142 @@ +package opts + +import ( + "bufio" + "fmt" + "io/ioutil" + "os" + "reflect" + "strings" + "testing" +) + +func tmpFileWithContent(content string, t *testing.T) string { + tmpFile, err := ioutil.TempFile("", "envfile-test") + if err != nil { + t.Fatal(err) + } + defer tmpFile.Close() + + tmpFile.WriteString(content) + return tmpFile.Name() +} + +// Test ParseEnvFile for a file with a few well formatted lines +func TestParseEnvFileGoodFile(t *testing.T) { + content := `foo=bar + baz=quux +# comment + +_foobar=foobaz +with.dots=working +and_underscore=working too +` + // Adding a newline + a line with pure whitespace. + // This is being done like this instead of the block above + // because it's common for editors to trim trailing whitespace + // from lines, which becomes annoying since that's the + // exact thing we need to test. + content += "\n \t " + tmpFile := tmpFileWithContent(content, t) + defer os.Remove(tmpFile) + + lines, err := ParseEnvFile(tmpFile) + if err != nil { + t.Fatal(err) + } + + expectedLines := []string{ + "foo=bar", + "baz=quux", + "_foobar=foobaz", + "with.dots=working", + "and_underscore=working too", + } + + if !reflect.DeepEqual(lines, expectedLines) { + t.Fatal("lines not equal to expected_lines") + } +} + +// Test ParseEnvFile for an empty file +func TestParseEnvFileEmptyFile(t *testing.T) { + tmpFile := tmpFileWithContent("", t) + defer os.Remove(tmpFile) + + lines, err := ParseEnvFile(tmpFile) + if err != nil { + t.Fatal(err) + } + + if len(lines) != 0 { + t.Fatal("lines not empty; expected empty") + } +} + +// Test ParseEnvFile for a non existent file +func TestParseEnvFileNonExistentFile(t *testing.T) { + _, err := ParseEnvFile("foo_bar_baz") + if err == nil { + t.Fatal("ParseEnvFile succeeded; expected failure") + } + if _, ok := err.(*os.PathError); !ok { + t.Fatalf("Expected a PathError, got [%v]", err) + } +} + +// Test ParseEnvFile for a badly formatted file +func TestParseEnvFileBadlyFormattedFile(t *testing.T) { + content := `foo=bar + f =quux +` + + tmpFile := tmpFileWithContent(content, t) + defer os.Remove(tmpFile) + + _, err := ParseEnvFile(tmpFile) + if err == nil { + t.Fatalf("Expected a ErrBadEnvVariable, got nothing") + } + if _, ok := err.(ErrBadEnvVariable); !ok { + t.Fatalf("Expected a ErrBadEnvVariable, got [%v]", err) + } + expectedMessage := "poorly formatted environment: variable 'f ' has white spaces" + if err.Error() != expectedMessage { + t.Fatalf("Expected [%v], got [%v]", expectedMessage, err.Error()) + } +} + +// Test ParseEnvFile for a file with a line exeeding bufio.MaxScanTokenSize +func TestParseEnvFileLineTooLongFile(t *testing.T) { + content := strings.Repeat("a", bufio.MaxScanTokenSize+42) + content = fmt.Sprint("foo=", content) + + tmpFile := tmpFileWithContent(content, t) + defer os.Remove(tmpFile) + + _, err := ParseEnvFile(tmpFile) + if err == nil { + t.Fatal("ParseEnvFile succeeded; expected failure") + } +} + +// ParseEnvFile with a random file, pass through +func TestParseEnvFileRandomFile(t *testing.T) { + content := `first line +another invalid line` + tmpFile := tmpFileWithContent(content, t) + defer os.Remove(tmpFile) + + _, err := ParseEnvFile(tmpFile) + + if err == nil { + t.Fatalf("Expected a ErrBadEnvVariable, got nothing") + } + if _, ok := err.(ErrBadEnvVariable); !ok { + t.Fatalf("Expected a ErrBadEnvvariable, got [%v]", err) + } + expectedMessage := "poorly formatted environment: variable 'first line' has white spaces" + if err.Error() != expectedMessage { + t.Fatalf("Expected [%v], got [%v]", expectedMessage, err.Error()) + } +} diff --git a/opts/hosts_unix.go b/opts/hosts_unix.go new file mode 100644 index 0000000000..611407a9d9 --- /dev/null +++ b/opts/hosts_unix.go @@ -0,0 +1,8 @@ +// +build !windows + +package opts + +import "fmt" + +// DefaultHost constant defines the default host string used by docker on other hosts than Windows +var DefaultHost = fmt.Sprintf("unix://%s", DefaultUnixSocket) diff --git a/opts/hosts_windows.go b/opts/hosts_windows.go new file mode 100644 index 0000000000..ec52e9a70a --- /dev/null +++ b/opts/hosts_windows.go @@ -0,0 +1,6 @@ +// +build windows + +package opts + +// DefaultHost constant defines the default host string used by docker on Windows +var DefaultHost = DefaultTCPHost diff --git a/opts/ip.go b/opts/ip.go new file mode 100644 index 0000000000..d787b56ca6 --- /dev/null +++ b/opts/ip.go @@ -0,0 +1,42 @@ +package opts + +import ( + "fmt" + "net" +) + +// IPOpt holds an IP. It is used to store values from CLI flags. +type IPOpt struct { + *net.IP +} + +// NewIPOpt creates a new IPOpt from a reference net.IP and a +// string representation of an IP. If the string is not a valid +// IP it will fallback to the specified reference. +func NewIPOpt(ref *net.IP, defaultVal string) *IPOpt { + o := &IPOpt{ + IP: ref, + } + o.Set(defaultVal) + return o +} + +// Set sets an IPv4 or IPv6 address from a given string. If the given +// string is not parsable as an IP address it returns an error. +func (o *IPOpt) Set(val string) error { + ip := net.ParseIP(val) + if ip == nil { + return fmt.Errorf("%s is not an ip address", val) + } + *o.IP = ip + return nil +} + +// String returns the IP address stored in the IPOpt. If stored IP is a +// nil pointer, it returns an empty string. +func (o *IPOpt) String() string { + if *o.IP == nil { + return "" + } + return o.IP.String() +} diff --git a/opts/ip_test.go b/opts/ip_test.go new file mode 100644 index 0000000000..1027d84a05 --- /dev/null +++ b/opts/ip_test.go @@ -0,0 +1,54 @@ +package opts + +import ( + "net" + "testing" +) + +func TestIpOptString(t *testing.T) { + addresses := []string{"", "0.0.0.0"} + var ip net.IP + + for _, address := range addresses { + stringAddress := NewIPOpt(&ip, address).String() + if stringAddress != address { + t.Fatalf("IpOpt string should be `%s`, not `%s`", address, stringAddress) + } + } +} + +func TestNewIpOptInvalidDefaultVal(t *testing.T) { + ip := net.IPv4(127, 0, 0, 1) + defaultVal := "Not an ip" + + ipOpt := NewIPOpt(&ip, defaultVal) + + expected := "127.0.0.1" + if ipOpt.String() != expected { + t.Fatalf("Expected [%v], got [%v]", expected, ipOpt.String()) + } +} + +func TestNewIpOptValidDefaultVal(t *testing.T) { + ip := net.IPv4(127, 0, 0, 1) + defaultVal := "192.168.1.1" + + ipOpt := NewIPOpt(&ip, defaultVal) + + expected := "192.168.1.1" + if ipOpt.String() != expected { + t.Fatalf("Expected [%v], got [%v]", expected, ipOpt.String()) + } +} + +func TestIpOptSetInvalidVal(t *testing.T) { + ip := net.IPv4(127, 0, 0, 1) + ipOpt := &IPOpt{IP: &ip} + + invalidIP := "invalid ip" + expectedError := "invalid ip is not an ip address" + err := ipOpt.Set(invalidIP) + if err == nil || err.Error() != expectedError { + t.Fatalf("Expected an Error with [%v], got [%v]", expectedError, err.Error()) + } +} diff --git a/opts/opts.go b/opts/opts.go new file mode 100644 index 0000000000..b47cc4b2f6 --- /dev/null +++ b/opts/opts.go @@ -0,0 +1,381 @@ +package opts + +import ( + "fmt" + "net" + "os" + "path" + "regexp" + "strings" + + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/volume" +) + +var ( + alphaRegexp = regexp.MustCompile(`[a-zA-Z]`) + domainRegexp = regexp.MustCompile(`^(:?(:?[a-zA-Z0-9]|(:?[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9]))(:?\.(:?[a-zA-Z0-9]|(:?[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])))*)\.?\s*$`) + // DefaultHTTPHost Default HTTP Host used if only port is provided to -H flag e.g. docker daemon -H tcp://:8080 + DefaultHTTPHost = "localhost" + + // DefaultHTTPPort Default HTTP Port used if only the protocol is provided to -H flag e.g. docker daemon -H tcp:// + // TODO Windows. DefaultHTTPPort is only used on Windows if a -H parameter + // is not supplied. A better longer term solution would be to use a named + // pipe as the default on the Windows daemon. + // These are the IANA registered port numbers for use with Docker + // see http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=docker + DefaultHTTPPort = 2375 // Default HTTP Port + // DefaultTLSHTTPPort Default HTTP Port used when TLS enabled + DefaultTLSHTTPPort = 2376 // Default TLS encrypted HTTP Port + // DefaultUnixSocket Path for the unix socket. + // Docker daemon by default always listens on the default unix socket + DefaultUnixSocket = "/var/run/docker.sock" + // DefaultTCPHost constant defines the default host string used by docker on Windows + DefaultTCPHost = fmt.Sprintf("tcp://%s:%d", DefaultHTTPHost, DefaultHTTPPort) + // DefaultTLSHost constant defines the default host string used by docker for TLS sockets + DefaultTLSHost = fmt.Sprintf("tcp://%s:%d", DefaultHTTPHost, DefaultTLSHTTPPort) +) + +// ListOpts holds a list of values and a validation function. +type ListOpts struct { + values *[]string + validator ValidatorFctType +} + +// NewListOpts creates a new ListOpts with the specified validator. +func NewListOpts(validator ValidatorFctType) ListOpts { + var values []string + return *NewListOptsRef(&values, validator) +} + +// NewListOptsRef creates a new ListOpts with the specified values and validator. +func NewListOptsRef(values *[]string, validator ValidatorFctType) *ListOpts { + return &ListOpts{ + values: values, + validator: validator, + } +} + +func (opts *ListOpts) String() string { + return fmt.Sprintf("%v", []string((*opts.values))) +} + +// Set validates if needed the input value and add it to the +// internal slice. +func (opts *ListOpts) Set(value string) error { + if opts.validator != nil { + v, err := opts.validator(value) + if err != nil { + return err + } + value = v + } + (*opts.values) = append((*opts.values), value) + return nil +} + +// Delete removes the specified element from the slice. +func (opts *ListOpts) Delete(key string) { + for i, k := range *opts.values { + if k == key { + (*opts.values) = append((*opts.values)[:i], (*opts.values)[i+1:]...) + return + } + } +} + +// GetMap returns the content of values in a map in order to avoid +// duplicates. +// FIXME: can we remove this? +func (opts *ListOpts) GetMap() map[string]struct{} { + ret := make(map[string]struct{}) + for _, k := range *opts.values { + ret[k] = struct{}{} + } + return ret +} + +// GetAll returns the values of slice. +// FIXME: Can we remove this? +func (opts *ListOpts) GetAll() []string { + return (*opts.values) +} + +// GetAllOrEmpty returns the values of the slice +// or an empty slice when there are no values. +func (opts *ListOpts) GetAllOrEmpty() []string { + v := *opts.values + if v == nil { + return make([]string, 0) + } + return v +} + +// Get checks the existence of the specified key. +func (opts *ListOpts) Get(key string) bool { + for _, k := range *opts.values { + if k == key { + return true + } + } + return false +} + +// Len returns the amount of element in the slice. +func (opts *ListOpts) Len() int { + return len((*opts.values)) +} + +//MapOpts holds a map of values and a validation function. +type MapOpts struct { + values map[string]string + validator ValidatorFctType +} + +// Set validates if needed the input value and add it to the +// internal map, by splitting on '='. +func (opts *MapOpts) Set(value string) error { + if opts.validator != nil { + v, err := opts.validator(value) + if err != nil { + return err + } + value = v + } + vals := strings.SplitN(value, "=", 2) + if len(vals) == 1 { + (opts.values)[vals[0]] = "" + } else { + (opts.values)[vals[0]] = vals[1] + } + return nil +} + +// GetAll returns the values of MapOpts as a map. +func (opts *MapOpts) GetAll() map[string]string { + return opts.values +} + +func (opts *MapOpts) String() string { + return fmt.Sprintf("%v", map[string]string((opts.values))) +} + +// NewMapOpts creates a new MapOpts with the specified map of values and a validator. +func NewMapOpts(values map[string]string, validator ValidatorFctType) *MapOpts { + if values == nil { + values = make(map[string]string) + } + return &MapOpts{ + values: values, + validator: validator, + } +} + +// ValidatorFctType defines a validator function that returns a validated string and/or an error. +type ValidatorFctType func(val string) (string, error) + +// ValidatorFctListType defines a validator function that returns a validated list of string and/or an error +type ValidatorFctListType func(val string) ([]string, error) + +// ValidateAttach validates that the specified string is a valid attach option. +func ValidateAttach(val string) (string, error) { + s := strings.ToLower(val) + for _, str := range []string{"stdin", "stdout", "stderr"} { + if s == str { + return s, nil + } + } + return val, fmt.Errorf("valid streams are STDIN, STDOUT and STDERR") +} + +// ValidateLink validates that the specified string has a valid link format (containerName:alias). +func ValidateLink(val string) (string, error) { + if _, _, err := parsers.ParseLink(val); err != nil { + return val, err + } + return val, nil +} + +// ValidDeviceMode checks if the mode for device is valid or not. +// Valid mode is a composition of r (read), w (write), and m (mknod). +func ValidDeviceMode(mode string) bool { + var legalDeviceMode = map[rune]bool{ + 'r': true, + 'w': true, + 'm': true, + } + if mode == "" { + return false + } + for _, c := range mode { + if !legalDeviceMode[c] { + return false + } + legalDeviceMode[c] = false + } + return true +} + +// ValidateDevice validates a path for devices +// It will make sure 'val' is in the form: +// [host-dir:]container-path[:mode] +// It also validates the device mode. +func ValidateDevice(val string) (string, error) { + return validatePath(val, ValidDeviceMode) +} + +// ValidatePath validates a path for volumes +// It will make sure 'val' is in the form: +// [host-dir:]container-path[:rw|ro] +// It also validates the mount mode. +func ValidatePath(val string) (string, error) { + return validatePath(val, volume.ValidMountMode) +} + +func validatePath(val string, validator func(string) bool) (string, error) { + var containerPath string + var mode string + + if strings.Count(val, ":") > 2 { + return val, fmt.Errorf("bad format for path: %s", val) + } + + split := strings.SplitN(val, ":", 3) + if split[0] == "" { + return val, fmt.Errorf("bad format for path: %s", val) + } + switch len(split) { + case 1: + containerPath = split[0] + val = path.Clean(containerPath) + case 2: + if isValid := validator(split[1]); isValid { + containerPath = split[0] + mode = split[1] + val = fmt.Sprintf("%s:%s", path.Clean(containerPath), mode) + } else { + containerPath = split[1] + val = fmt.Sprintf("%s:%s", split[0], path.Clean(containerPath)) + } + case 3: + containerPath = split[1] + mode = split[2] + if isValid := validator(split[2]); !isValid { + return val, fmt.Errorf("bad mode specified: %s", mode) + } + val = fmt.Sprintf("%s:%s:%s", split[0], containerPath, mode) + } + + if !path.IsAbs(containerPath) { + return val, fmt.Errorf("%s is not an absolute path", containerPath) + } + return val, nil +} + +// ValidateEnv validates an environment variable and returns it. +// If no value is specified, it returns the current value using os.Getenv. +// +// As on ParseEnvFile and related to #16585, environment variable names +// are not validate what so ever, it's up to application inside docker +// to validate them or not. +func ValidateEnv(val string) (string, error) { + arr := strings.Split(val, "=") + if len(arr) > 1 { + return val, nil + } + if !doesEnvExist(val) { + return val, nil + } + return fmt.Sprintf("%s=%s", val, os.Getenv(val)), nil +} + +// ValidateIPAddress validates an Ip address. +func ValidateIPAddress(val string) (string, error) { + var ip = net.ParseIP(strings.TrimSpace(val)) + if ip != nil { + return ip.String(), nil + } + return "", fmt.Errorf("%s is not an ip address", val) +} + +// ValidateMACAddress validates a MAC address. +func ValidateMACAddress(val string) (string, error) { + _, err := net.ParseMAC(strings.TrimSpace(val)) + if err != nil { + return "", err + } + return val, nil +} + +// ValidateDNSSearch validates domain for resolvconf search configuration. +// A zero length domain is represented by a dot (.). +func ValidateDNSSearch(val string) (string, error) { + if val = strings.Trim(val, " "); val == "." { + return val, nil + } + return validateDomain(val) +} + +func validateDomain(val string) (string, error) { + if alphaRegexp.FindString(val) == "" { + return "", fmt.Errorf("%s is not a valid domain", val) + } + ns := domainRegexp.FindSubmatch([]byte(val)) + if len(ns) > 0 && len(ns[1]) < 255 { + return string(ns[1]), nil + } + return "", fmt.Errorf("%s is not a valid domain", val) +} + +// ValidateExtraHost validates that the specified string is a valid extrahost and returns it. +// ExtraHost are in the form of name:ip where the ip has to be a valid ip (ipv4 or ipv6). +func ValidateExtraHost(val string) (string, error) { + // allow for IPv6 addresses in extra hosts by only splitting on first ":" + arr := strings.SplitN(val, ":", 2) + if len(arr) != 2 || len(arr[0]) == 0 { + return "", fmt.Errorf("bad format for add-host: %q", val) + } + if _, err := ValidateIPAddress(arr[1]); err != nil { + return "", fmt.Errorf("invalid IP address in add-host: %q", arr[1]) + } + return val, nil +} + +// ValidateLabel validates that the specified string is a valid label, and returns it. +// Labels are in the form on key=value. +func ValidateLabel(val string) (string, error) { + if strings.Count(val, "=") < 1 { + return "", fmt.Errorf("bad attribute format: %s", val) + } + return val, nil +} + +// ValidateHost validates that the specified string is a valid host and returns it. +func ValidateHost(val string) (string, error) { + _, err := parsers.ParseDockerDaemonHost(DefaultTCPHost, DefaultTLSHost, DefaultUnixSocket, "", val) + if err != nil { + return val, err + } + // Note: unlike most flag validators, we don't return the mutated value here + // we need to know what the user entered later (using ParseHost) to adjust for tls + return val, nil +} + +// ParseHost and set defaults for a Daemon host string +func ParseHost(defaultHost, val string) (string, error) { + host, err := parsers.ParseDockerDaemonHost(DefaultTCPHost, DefaultTLSHost, DefaultUnixSocket, defaultHost, val) + if err != nil { + return val, err + } + return host, nil +} + +func doesEnvExist(name string) bool { + for _, entry := range os.Environ() { + parts := strings.SplitN(entry, "=", 2) + if parts[0] == name { + return true + } + } + return false +} diff --git a/opts/opts_test.go b/opts/opts_test.go new file mode 100644 index 0000000000..baf5f53362 --- /dev/null +++ b/opts/opts_test.go @@ -0,0 +1,479 @@ +package opts + +import ( + "fmt" + "os" + "runtime" + "strings" + "testing" +) + +func TestValidateIPAddress(t *testing.T) { + if ret, err := ValidateIPAddress(`1.2.3.4`); err != nil || ret == "" { + t.Fatalf("ValidateIPAddress(`1.2.3.4`) got %s %s", ret, err) + } + + if ret, err := ValidateIPAddress(`127.0.0.1`); err != nil || ret == "" { + t.Fatalf("ValidateIPAddress(`127.0.0.1`) got %s %s", ret, err) + } + + if ret, err := ValidateIPAddress(`::1`); err != nil || ret == "" { + t.Fatalf("ValidateIPAddress(`::1`) got %s %s", ret, err) + } + + if ret, err := ValidateIPAddress(`127`); err == nil || ret != "" { + t.Fatalf("ValidateIPAddress(`127`) got %s %s", ret, err) + } + + if ret, err := ValidateIPAddress(`random invalid string`); err == nil || ret != "" { + t.Fatalf("ValidateIPAddress(`random invalid string`) got %s %s", ret, err) + } + +} + +func TestMapOpts(t *testing.T) { + tmpMap := make(map[string]string) + o := NewMapOpts(tmpMap, logOptsValidator) + o.Set("max-size=1") + if o.String() != "map[max-size:1]" { + t.Errorf("%s != [map[max-size:1]", o.String()) + } + + o.Set("max-file=2") + if len(tmpMap) != 2 { + t.Errorf("map length %d != 2", len(tmpMap)) + } + + if tmpMap["max-file"] != "2" { + t.Errorf("max-file = %s != 2", tmpMap["max-file"]) + } + + if tmpMap["max-size"] != "1" { + t.Errorf("max-size = %s != 1", tmpMap["max-size"]) + } + if o.Set("dummy-val=3") == nil { + t.Errorf("validator is not being called") + } +} + +func TestValidateMACAddress(t *testing.T) { + if _, err := ValidateMACAddress(`92:d0:c6:0a:29:33`); err != nil { + t.Fatalf("ValidateMACAddress(`92:d0:c6:0a:29:33`) got %s", err) + } + + if _, err := ValidateMACAddress(`92:d0:c6:0a:33`); err == nil { + t.Fatalf("ValidateMACAddress(`92:d0:c6:0a:33`) succeeded; expected failure on invalid MAC") + } + + if _, err := ValidateMACAddress(`random invalid string`); err == nil { + t.Fatalf("ValidateMACAddress(`random invalid string`) succeeded; expected failure on invalid MAC") + } +} + +func TestListOptsWithoutValidator(t *testing.T) { + o := NewListOpts(nil) + o.Set("foo") + if o.String() != "[foo]" { + t.Errorf("%s != [foo]", o.String()) + } + o.Set("bar") + if o.Len() != 2 { + t.Errorf("%d != 2", o.Len()) + } + o.Set("bar") + if o.Len() != 3 { + t.Errorf("%d != 3", o.Len()) + } + if !o.Get("bar") { + t.Error("o.Get(\"bar\") == false") + } + if o.Get("baz") { + t.Error("o.Get(\"baz\") == true") + } + o.Delete("foo") + if o.String() != "[bar bar]" { + t.Errorf("%s != [bar bar]", o.String()) + } + listOpts := o.GetAll() + if len(listOpts) != 2 || listOpts[0] != "bar" || listOpts[1] != "bar" { + t.Errorf("Expected [[bar bar]], got [%v]", listOpts) + } + mapListOpts := o.GetMap() + if len(mapListOpts) != 1 { + t.Errorf("Expected [map[bar:{}]], got [%v]", mapListOpts) + } + +} + +func TestListOptsWithValidator(t *testing.T) { + // Re-using logOptsvalidator (used by MapOpts) + o := NewListOpts(logOptsValidator) + o.Set("foo") + if o.String() != "[]" { + t.Errorf("%s != []", o.String()) + } + o.Set("foo=bar") + if o.String() != "[]" { + t.Errorf("%s != []", o.String()) + } + o.Set("max-file=2") + if o.Len() != 1 { + t.Errorf("%d != 1", o.Len()) + } + if !o.Get("max-file=2") { + t.Error("o.Get(\"max-file=2\") == false") + } + if o.Get("baz") { + t.Error("o.Get(\"baz\") == true") + } + o.Delete("max-file=2") + if o.String() != "[]" { + t.Errorf("%s != []", o.String()) + } +} + +func TestValidateDNSSearch(t *testing.T) { + valid := []string{ + `.`, + `a`, + `a.`, + `1.foo`, + `17.foo`, + `foo.bar`, + `foo.bar.baz`, + `foo.bar.`, + `foo.bar.baz`, + `foo1.bar2`, + `foo1.bar2.baz`, + `1foo.2bar.`, + `1foo.2bar.baz`, + `foo-1.bar-2`, + `foo-1.bar-2.baz`, + `foo-1.bar-2.`, + `foo-1.bar-2.baz`, + `1-foo.2-bar`, + `1-foo.2-bar.baz`, + `1-foo.2-bar.`, + `1-foo.2-bar.baz`, + } + + invalid := []string{ + ``, + ` `, + ` `, + `17`, + `17.`, + `.17`, + `17-.`, + `17-.foo`, + `.foo`, + `foo-.bar`, + `-foo.bar`, + `foo.bar-`, + `foo.bar-.baz`, + `foo.-bar`, + `foo.-bar.baz`, + `foo.bar.baz.this.should.fail.on.long.name.beause.it.is.longer.thanisshouldbethis.should.fail.on.long.name.beause.it.is.longer.thanisshouldbethis.should.fail.on.long.name.beause.it.is.longer.thanisshouldbethis.should.fail.on.long.name.beause.it.is.longer.thanisshouldbe`, + } + + for _, domain := range valid { + if ret, err := ValidateDNSSearch(domain); err != nil || ret == "" { + t.Fatalf("ValidateDNSSearch(`"+domain+"`) got %s %s", ret, err) + } + } + + for _, domain := range invalid { + if ret, err := ValidateDNSSearch(domain); err == nil || ret != "" { + t.Fatalf("ValidateDNSSearch(`"+domain+"`) got %s %s", ret, err) + } + } +} + +func TestValidateExtraHosts(t *testing.T) { + valid := []string{ + `myhost:192.168.0.1`, + `thathost:10.0.2.1`, + `anipv6host:2003:ab34:e::1`, + `ipv6local:::1`, + } + + invalid := map[string]string{ + `myhost:192.notanipaddress.1`: `invalid IP`, + `thathost-nosemicolon10.0.0.1`: `bad format`, + `anipv6host:::::1`: `invalid IP`, + `ipv6local:::0::`: `invalid IP`, + } + + for _, extrahost := range valid { + if _, err := ValidateExtraHost(extrahost); err != nil { + t.Fatalf("ValidateExtraHost(`"+extrahost+"`) should succeed: error %v", err) + } + } + + for extraHost, expectedError := range invalid { + if _, err := ValidateExtraHost(extraHost); err == nil { + t.Fatalf("ValidateExtraHost(`%q`) should have failed validation", extraHost) + } else { + if !strings.Contains(err.Error(), expectedError) { + t.Fatalf("ValidateExtraHost(`%q`) error should contain %q", extraHost, expectedError) + } + } + } +} + +func TestValidateAttach(t *testing.T) { + valid := []string{ + "stdin", + "stdout", + "stderr", + "STDIN", + "STDOUT", + "STDERR", + } + if _, err := ValidateAttach("invalid"); err == nil { + t.Fatalf("Expected error with [valid streams are STDIN, STDOUT and STDERR], got nothing") + } + + for _, attach := range valid { + value, err := ValidateAttach(attach) + if err != nil { + t.Fatal(err) + } + if value != strings.ToLower(attach) { + t.Fatalf("Expected [%v], got [%v]", attach, value) + } + } +} + +func TestValidateLink(t *testing.T) { + valid := []string{ + "name", + "dcdfbe62ecd0:alias", + "7a67485460b7642516a4ad82ecefe7f57d0c4916f530561b71a50a3f9c4e33da", + "angry_torvalds:linus", + } + invalid := map[string]string{ + "": "empty string specified for links", + "too:much:of:it": "bad format for links: too:much:of:it", + } + + for _, link := range valid { + if _, err := ValidateLink(link); err != nil { + t.Fatalf("ValidateLink(`%q`) should succeed: error %q", link, err) + } + } + + for link, expectedError := range invalid { + if _, err := ValidateLink(link); err == nil { + t.Fatalf("ValidateLink(`%q`) should have failed validation", link) + } else { + if !strings.Contains(err.Error(), expectedError) { + t.Fatalf("ValidateLink(`%q`) error should contain %q", link, expectedError) + } + } + } +} + +func TestValidatePath(t *testing.T) { + valid := []string{ + "/home", + "/home:/home", + "/home:/something/else", + "/with space", + "/home:/with space", + "relative:/absolute-path", + "hostPath:/containerPath:ro", + "/hostPath:/containerPath:rw", + "/rw:/ro", + "/path:rw", + "/path:ro", + "/rw:rw", + } + invalid := map[string]string{ + "": "bad format for path: ", + "./": "./ is not an absolute path", + "../": "../ is not an absolute path", + "/:../": "../ is not an absolute path", + "/:path": "path is not an absolute path", + ":": "bad format for path: :", + "/tmp:": " is not an absolute path", + ":test": "bad format for path: :test", + ":/test": "bad format for path: :/test", + "tmp:": " is not an absolute path", + ":test:": "bad format for path: :test:", + "::": "bad format for path: ::", + ":::": "bad format for path: :::", + "/tmp:::": "bad format for path: /tmp:::", + ":/tmp::": "bad format for path: :/tmp::", + "path:ro": "path is not an absolute path", + "/path:/path:sw": "bad mode specified: sw", + "/path:/path:rwz": "bad mode specified: rwz", + } + + for _, path := range valid { + if _, err := ValidatePath(path); err != nil { + t.Fatalf("ValidatePath(`%q`) should succeed: error %q", path, err) + } + } + + for path, expectedError := range invalid { + if _, err := ValidatePath(path); err == nil { + t.Fatalf("ValidatePath(`%q`) should have failed validation", path) + } else { + if err.Error() != expectedError { + t.Fatalf("ValidatePath(`%q`) error should contain %q, got %q", path, expectedError, err.Error()) + } + } + } +} +func TestValidateDevice(t *testing.T) { + valid := []string{ + "/home", + "/home:/home", + "/home:/something/else", + "/with space", + "/home:/with space", + "relative:/absolute-path", + "hostPath:/containerPath:r", + "/hostPath:/containerPath:rw", + "/hostPath:/containerPath:mrw", + } + invalid := map[string]string{ + "": "bad format for path: ", + "./": "./ is not an absolute path", + "../": "../ is not an absolute path", + "/:../": "../ is not an absolute path", + "/:path": "path is not an absolute path", + ":": "bad format for path: :", + "/tmp:": " is not an absolute path", + ":test": "bad format for path: :test", + ":/test": "bad format for path: :/test", + "tmp:": " is not an absolute path", + ":test:": "bad format for path: :test:", + "::": "bad format for path: ::", + ":::": "bad format for path: :::", + "/tmp:::": "bad format for path: /tmp:::", + ":/tmp::": "bad format for path: :/tmp::", + "path:ro": "ro is not an absolute path", + "path:rr": "rr is not an absolute path", + "a:/b:ro": "bad mode specified: ro", + "a:/b:rr": "bad mode specified: rr", + } + + for _, path := range valid { + if _, err := ValidateDevice(path); err != nil { + t.Fatalf("ValidateDevice(`%q`) should succeed: error %q", path, err) + } + } + + for path, expectedError := range invalid { + if _, err := ValidateDevice(path); err == nil { + t.Fatalf("ValidateDevice(`%q`) should have failed validation", path) + } else { + if err.Error() != expectedError { + t.Fatalf("ValidateDevice(`%q`) error should contain %q, got %q", path, expectedError, err.Error()) + } + } + } +} + +func TestValidateEnv(t *testing.T) { + valids := map[string]string{ + "a": "a", + "something": "something", + "_=a": "_=a", + "env1=value1": "env1=value1", + "_env1=value1": "_env1=value1", + "env2=value2=value3": "env2=value2=value3", + "env3=abc!qwe": "env3=abc!qwe", + "env_4=value 4": "env_4=value 4", + "PATH": fmt.Sprintf("PATH=%v", os.Getenv("PATH")), + "PATH=something": "PATH=something", + "asd!qwe": "asd!qwe", + "1asd": "1asd", + "123": "123", + "some space": "some space", + " some space before": " some space before", + "some space after ": "some space after ", + } + for value, expected := range valids { + actual, err := ValidateEnv(value) + if err != nil { + t.Fatal(err) + } + if actual != expected { + t.Fatalf("Expected [%v], got [%v]", expected, actual) + } + } +} + +func TestValidateLabel(t *testing.T) { + if _, err := ValidateLabel("label"); err == nil || err.Error() != "bad attribute format: label" { + t.Fatalf("Expected an error [bad attribute format: label], go %v", err) + } + if actual, err := ValidateLabel("key1=value1"); err != nil || actual != "key1=value1" { + t.Fatalf("Expected [key1=value1], got [%v,%v]", actual, err) + } + // Validate it's working with more than one = + if actual, err := ValidateLabel("key1=value1=value2"); err != nil { + t.Fatalf("Expected [key1=value1=value2], got [%v,%v]", actual, err) + } + // Validate it's working with one more + if actual, err := ValidateLabel("key1=value1=value2=value3"); err != nil { + t.Fatalf("Expected [key1=value1=value2=value2], got [%v,%v]", actual, err) + } +} + +func TestParseHost(t *testing.T) { + invalid := map[string]string{ + "anything": "Invalid bind address format: anything", + "something with spaces": "Invalid bind address format: something with spaces", + "://": "Invalid bind address format: ://", + "unknown://": "Invalid bind address format: unknown://", + "tcp://:port": "Invalid bind address format: :port", + "tcp://invalid": "Invalid bind address format: invalid", + "tcp://invalid:port": "Invalid bind address format: invalid:port", + } + const defaultHTTPHost = "tcp://127.0.0.1:2375" + var defaultHOST = "unix:///var/run/docker.sock" + + if runtime.GOOS == "windows" { + defaultHOST = defaultHTTPHost + } + valid := map[string]string{ + "": defaultHOST, + "fd://": "fd://", + "fd://something": "fd://something", + "tcp://host:": "tcp://host:2375", + "tcp://": "tcp://localhost:2375", + "tcp://:2375": "tcp://localhost:2375", // default ip address + "tcp://:2376": "tcp://localhost:2376", // default ip address + "tcp://0.0.0.0:8080": "tcp://0.0.0.0:8080", + "tcp://192.168.0.0:12000": "tcp://192.168.0.0:12000", + "tcp://192.168:8080": "tcp://192.168:8080", + "tcp://0.0.0.0:1234567890": "tcp://0.0.0.0:1234567890", // yeah it's valid :P + "tcp://docker.com:2375": "tcp://docker.com:2375", + "unix://": "unix:///var/run/docker.sock", // default unix:// value + "unix://path/to/socket": "unix://path/to/socket", + } + + for value, errorMessage := range invalid { + if _, err := ParseHost(defaultHTTPHost, value); err == nil || err.Error() != errorMessage { + t.Fatalf("Expected an error for %v with [%v], got [%v]", value, errorMessage, err) + } + } + for value, expected := range valid { + if actual, err := ParseHost(defaultHTTPHost, value); err != nil || actual != expected { + t.Fatalf("Expected for %v [%v], got [%v, %v]", value, expected, actual, err) + } + } +} + +func logOptsValidator(val string) (string, error) { + allowedKeys := map[string]string{"max-size": "1", "max-file": "2"} + vals := strings.Split(val, "=") + if allowedKeys[vals[0]] != "" { + return val, nil + } + return "", fmt.Errorf("invalid key %s", vals[0]) +} diff --git a/opts/ulimit.go b/opts/ulimit.go new file mode 100644 index 0000000000..b41f475bd5 --- /dev/null +++ b/opts/ulimit.go @@ -0,0 +1,52 @@ +package opts + +import ( + "fmt" + + "github.com/docker/docker/pkg/ulimit" +) + +// UlimitOpt defines a map of Ulimits +type UlimitOpt struct { + values *map[string]*ulimit.Ulimit +} + +// NewUlimitOpt creates a new UlimitOpt +func NewUlimitOpt(ref *map[string]*ulimit.Ulimit) *UlimitOpt { + if ref == nil { + ref = &map[string]*ulimit.Ulimit{} + } + return &UlimitOpt{ref} +} + +// Set validates a Ulimit and sets its name as a key in UlimitOpt +func (o *UlimitOpt) Set(val string) error { + l, err := ulimit.Parse(val) + if err != nil { + return err + } + + (*o.values)[l.Name] = l + + return nil +} + +// String returns Ulimit values as a string. +func (o *UlimitOpt) String() string { + var out []string + for _, v := range *o.values { + out = append(out, v.String()) + } + + return fmt.Sprintf("%v", out) +} + +// GetList returns a slice of pointers to Ulimits. +func (o *UlimitOpt) GetList() []*ulimit.Ulimit { + var ulimits []*ulimit.Ulimit + for _, v := range *o.values { + ulimits = append(ulimits, v) + } + + return ulimits +} diff --git a/opts/ulimit_test.go b/opts/ulimit_test.go new file mode 100644 index 0000000000..3845d1ec18 --- /dev/null +++ b/opts/ulimit_test.go @@ -0,0 +1,42 @@ +package opts + +import ( + "testing" + + "github.com/docker/docker/pkg/ulimit" +) + +func TestUlimitOpt(t *testing.T) { + ulimitMap := map[string]*ulimit.Ulimit{ + "nofile": {"nofile", 1024, 512}, + } + + ulimitOpt := NewUlimitOpt(&ulimitMap) + + expected := "[nofile=512:1024]" + if ulimitOpt.String() != expected { + t.Fatalf("Expected %v, got %v", expected, ulimitOpt) + } + + // Valid ulimit append to opts + if err := ulimitOpt.Set("core=1024:1024"); err != nil { + t.Fatal(err) + } + + // Invalid ulimit type returns an error and do not append to opts + if err := ulimitOpt.Set("notavalidtype=1024:1024"); err == nil { + t.Fatalf("Expected error on invalid ulimit type") + } + expected = "[nofile=512:1024 core=1024:1024]" + expected2 := "[core=1024:1024 nofile=512:1024]" + result := ulimitOpt.String() + if result != expected && result != expected2 { + t.Fatalf("Expected %v or %v, got %v", expected, expected2, ulimitOpt) + } + + // And test GetList + ulimits := ulimitOpt.GetList() + if len(ulimits) != 2 { + t.Fatalf("Expected a ulimit list of 2, got %v", ulimits) + } +} diff --git a/pkg/README.md b/pkg/README.md new file mode 100644 index 0000000000..c4b78a8ad8 --- /dev/null +++ b/pkg/README.md @@ -0,0 +1,11 @@ +pkg/ is a collection of utility packages used by the Docker project without being specific to its internals. + +Utility packages are kept separate from the docker core codebase to keep it as small and concise as possible. +If some utilities grow larger and their APIs stabilize, they may be moved to their own repository under the +Docker organization, to facilitate re-use by other projects. However that is not the priority. + +The directory `pkg` is named after the same directory in the camlistore project. Since Brad is a core +Go maintainer, we thought it made sense to copy his methods for organizing Go code :) Thanks Brad! + +Because utility packages are small and neatly separated from the rest of the codebase, they are a good +place to start for aspiring maintainers and contributors. Get in touch if you want to help maintain them! diff --git a/pkg/ansiescape/split.go b/pkg/ansiescape/split.go new file mode 100644 index 0000000000..b097b25f87 --- /dev/null +++ b/pkg/ansiescape/split.go @@ -0,0 +1,89 @@ +package ansiescape + +import "bytes" + +// dropCR drops a leading or terminal \r from the data. +func dropCR(data []byte) []byte { + if len(data) > 0 && data[len(data)-1] == '\r' { + data = data[0 : len(data)-1] + } + if len(data) > 0 && data[0] == '\r' { + data = data[1:] + } + return data +} + +// escapeSequenceLength calculates the length of an ANSI escape sequence +// If there is not enough characters to match a sequence, -1 is returned, +// if there is no valid sequence 0 is returned, otherwise the number +// of bytes in the sequence is returned. Only returns length for +// line moving sequences. +func escapeSequenceLength(data []byte) int { + next := 0 + if len(data) <= next { + return -1 + } + if data[next] != '[' { + return 0 + } + for { + next = next + 1 + if len(data) <= next { + return -1 + } + if (data[next] > '9' || data[next] < '0') && data[next] != ';' { + break + } + } + if len(data) <= next { + return -1 + } + // Only match line moving codes + switch data[next] { + case 'A', 'B', 'E', 'F', 'H', 'h': + return next + 1 + } + + return 0 +} + +// ScanANSILines is a scanner function which splits the +// input based on ANSI escape codes and new lines. +func ScanANSILines(data []byte, atEOF bool) (advance int, token []byte, err error) { + if atEOF && len(data) == 0 { + return 0, nil, nil + } + + // Look for line moving escape sequence + if i := bytes.IndexByte(data, '\x1b'); i >= 0 { + last := 0 + for i >= 0 { + last = last + i + + // get length of ANSI escape sequence + sl := escapeSequenceLength(data[last+1:]) + if sl == -1 { + return 0, nil, nil + } + if sl == 0 { + // If no relevant sequence was found, skip + last = last + 1 + i = bytes.IndexByte(data[last:], '\x1b') + continue + } + + return last + 1 + sl, dropCR(data[0:(last)]), nil + } + } + if i := bytes.IndexByte(data, '\n'); i >= 0 { + // No escape sequence, check for new line + return i + 1, dropCR(data[0:i]), nil + } + + // If we're at EOF, we have a final, non-terminated line. Return it. + if atEOF { + return len(data), dropCR(data), nil + } + // Request more data. + return 0, nil, nil +} diff --git a/pkg/ansiescape/split_test.go b/pkg/ansiescape/split_test.go new file mode 100644 index 0000000000..ecb24b9398 --- /dev/null +++ b/pkg/ansiescape/split_test.go @@ -0,0 +1,53 @@ +package ansiescape + +import ( + "bufio" + "strings" + "testing" +) + +func TestSplit(t *testing.T) { + lines := []string{ + "test line 1", + "another test line", + "some test line", + "line with non-cursor moving sequence \x1b[1T", // Scroll Down + "line with \x1b[31;1mcolor\x1b[0m then reset", // "color" in Bold Red + "cursor forward \x1b[1C and backward \x1b[1D", + "invalid sequence \x1babcd", + "", + "after empty", + } + splitSequences := []string{ + "\x1b[1A", // Cursor up + "\x1b[1B", // Cursor down + "\x1b[1E", // Cursor next line + "\x1b[1F", // Cursor previous line + "\x1b[1;1H", // Move cursor to position + "\x1b[1;1h", // Move cursor to position + "\n", + "\r\n", + "\n\r", + "\x1b[1A\r", + "\r\x1b[1A", + } + + for _, sequence := range splitSequences { + scanner := bufio.NewScanner(strings.NewReader(strings.Join(lines, sequence))) + scanner.Split(ScanANSILines) + i := 0 + for scanner.Scan() { + if i >= len(lines) { + t.Fatalf("Too many scanned lines") + } + scanned := scanner.Text() + if scanned != lines[i] { + t.Fatalf("Wrong line scanned with sequence %q\n\tExpected: %q\n\tActual: %q", sequence, lines[i], scanned) + } + i++ + } + if i < len(lines) { + t.Errorf("Wrong number of lines for sequence %q: %d, expected %d", sequence, i, len(lines)) + } + } +} diff --git a/pkg/archive/README.md b/pkg/archive/README.md new file mode 100644 index 0000000000..7307d9694f --- /dev/null +++ b/pkg/archive/README.md @@ -0,0 +1 @@ +This code provides helper functions for dealing with archive files. diff --git a/pkg/archive/archive.go b/pkg/archive/archive.go new file mode 100644 index 0000000000..4fa8cee53a --- /dev/null +++ b/pkg/archive/archive.go @@ -0,0 +1,1016 @@ +package archive + +import ( + "archive/tar" + "bufio" + "bytes" + "compress/bzip2" + "compress/gzip" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "runtime" + "strings" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/pools" + "github.com/docker/docker/pkg/promise" + "github.com/docker/docker/pkg/system" +) + +type ( + // Archive is a type of io.ReadCloser which has two interfaces Read and Closer. + Archive io.ReadCloser + // Reader is a type of io.Reader. + Reader io.Reader + // Compression is the state represtents if compressed or not. + Compression int + // TarChownOptions wraps the chown options UID and GID. + TarChownOptions struct { + UID, GID int + } + // TarOptions wraps the tar options. + TarOptions struct { + IncludeFiles []string + ExcludePatterns []string + Compression Compression + NoLchown bool + UIDMaps []idtools.IDMap + GIDMaps []idtools.IDMap + ChownOpts *TarChownOptions + IncludeSourceDir bool + // When unpacking, specifies whether overwriting a directory with a + // non-directory is allowed and vice versa. + NoOverwriteDirNonDir bool + // For each include when creating an archive, the included name will be + // replaced with the matching name from this map. + RebaseNames map[string]string + } + + // Archiver allows the reuse of most utility functions of this package + // with a pluggable Untar function. Also, to facilitate the passing of + // specific id mappings for untar, an archiver can be created with maps + // which will then be passed to Untar operations + Archiver struct { + Untar func(io.Reader, string, *TarOptions) error + UIDMaps []idtools.IDMap + GIDMaps []idtools.IDMap + } + + // breakoutError is used to differentiate errors related to breaking out + // When testing archive breakout in the unit tests, this error is expected + // in order for the test to pass. + breakoutError error +) + +var ( + // ErrNotImplemented is the error message of function not implemented. + ErrNotImplemented = errors.New("Function not implemented") + defaultArchiver = &Archiver{Untar: Untar, UIDMaps: nil, GIDMaps: nil} +) + +const ( + // Uncompressed represents the uncompressed. + Uncompressed Compression = iota + // Bzip2 is bzip2 compression algorithm. + Bzip2 + // Gzip is gzip compression algorithm. + Gzip + // Xz is xz compression algorithm. + Xz +) + +// IsArchive checks if it is a archive by the header. +func IsArchive(header []byte) bool { + compression := DetectCompression(header) + if compression != Uncompressed { + return true + } + r := tar.NewReader(bytes.NewBuffer(header)) + _, err := r.Next() + return err == nil +} + +// DetectCompression detects the compression algorithm of the source. +func DetectCompression(source []byte) Compression { + for compression, m := range map[Compression][]byte{ + Bzip2: {0x42, 0x5A, 0x68}, + Gzip: {0x1F, 0x8B, 0x08}, + Xz: {0xFD, 0x37, 0x7A, 0x58, 0x5A, 0x00}, + } { + if len(source) < len(m) { + logrus.Debugf("Len too short") + continue + } + if bytes.Compare(m, source[:len(m)]) == 0 { + return compression + } + } + return Uncompressed +} + +func xzDecompress(archive io.Reader) (io.ReadCloser, <-chan struct{}, error) { + args := []string{"xz", "-d", "-c", "-q"} + + return cmdStream(exec.Command(args[0], args[1:]...), archive) +} + +// DecompressStream decompress the archive and returns a ReaderCloser with the decompressed archive. +func DecompressStream(archive io.Reader) (io.ReadCloser, error) { + p := pools.BufioReader32KPool + buf := p.Get(archive) + bs, err := buf.Peek(10) + if err != nil { + return nil, err + } + + compression := DetectCompression(bs) + switch compression { + case Uncompressed: + readBufWrapper := p.NewReadCloserWrapper(buf, buf) + return readBufWrapper, nil + case Gzip: + gzReader, err := gzip.NewReader(buf) + if err != nil { + return nil, err + } + readBufWrapper := p.NewReadCloserWrapper(buf, gzReader) + return readBufWrapper, nil + case Bzip2: + bz2Reader := bzip2.NewReader(buf) + readBufWrapper := p.NewReadCloserWrapper(buf, bz2Reader) + return readBufWrapper, nil + case Xz: + xzReader, chdone, err := xzDecompress(buf) + if err != nil { + return nil, err + } + readBufWrapper := p.NewReadCloserWrapper(buf, xzReader) + return ioutils.NewReadCloserWrapper(readBufWrapper, func() error { + <-chdone + return readBufWrapper.Close() + }), nil + default: + return nil, fmt.Errorf("Unsupported compression format %s", (&compression).Extension()) + } +} + +// CompressStream compresses the dest with specified compression algorithm. +func CompressStream(dest io.WriteCloser, compression Compression) (io.WriteCloser, error) { + p := pools.BufioWriter32KPool + buf := p.Get(dest) + switch compression { + case Uncompressed: + writeBufWrapper := p.NewWriteCloserWrapper(buf, buf) + return writeBufWrapper, nil + case Gzip: + gzWriter := gzip.NewWriter(dest) + writeBufWrapper := p.NewWriteCloserWrapper(buf, gzWriter) + return writeBufWrapper, nil + case Bzip2, Xz: + // archive/bzip2 does not support writing, and there is no xz support at all + // However, this is not a problem as docker only currently generates gzipped tars + return nil, fmt.Errorf("Unsupported compression format %s", (&compression).Extension()) + default: + return nil, fmt.Errorf("Unsupported compression format %s", (&compression).Extension()) + } +} + +// Extension returns the extension of a file that uses the specified compression algorithm. +func (compression *Compression) Extension() string { + switch *compression { + case Uncompressed: + return "tar" + case Bzip2: + return "tar.bz2" + case Gzip: + return "tar.gz" + case Xz: + return "tar.xz" + } + return "" +} + +type tarAppender struct { + TarWriter *tar.Writer + Buffer *bufio.Writer + + // for hardlink mapping + SeenFiles map[uint64]string + UIDMaps []idtools.IDMap + GIDMaps []idtools.IDMap +} + +// canonicalTarName provides a platform-independent and consistent posix-style +//path for files and directories to be archived regardless of the platform. +func canonicalTarName(name string, isDir bool) (string, error) { + name, err := CanonicalTarNameForPath(name) + if err != nil { + return "", err + } + + // suffix with '/' for directories + if isDir && !strings.HasSuffix(name, "/") { + name += "/" + } + return name, nil +} + +func (ta *tarAppender) addTarFile(path, name string) error { + fi, err := os.Lstat(path) + if err != nil { + return err + } + + link := "" + if fi.Mode()&os.ModeSymlink != 0 { + if link, err = os.Readlink(path); err != nil { + return err + } + } + + hdr, err := tar.FileInfoHeader(fi, link) + if err != nil { + return err + } + hdr.Mode = int64(chmodTarEntry(os.FileMode(hdr.Mode))) + + name, err = canonicalTarName(name, fi.IsDir()) + if err != nil { + return fmt.Errorf("tar: cannot canonicalize path: %v", err) + } + hdr.Name = name + + nlink, inode, err := setHeaderForSpecialDevice(hdr, ta, name, fi.Sys()) + if err != nil { + return err + } + + // if it's a regular file and has more than 1 link, + // it's hardlinked, so set the type flag accordingly + if fi.Mode().IsRegular() && nlink > 1 { + // a link should have a name that it links too + // and that linked name should be first in the tar archive + if oldpath, ok := ta.SeenFiles[inode]; ok { + hdr.Typeflag = tar.TypeLink + hdr.Linkname = oldpath + hdr.Size = 0 // This Must be here for the writer math to add up! + } else { + ta.SeenFiles[inode] = name + } + } + + capability, _ := system.Lgetxattr(path, "security.capability") + if capability != nil { + hdr.Xattrs = make(map[string]string) + hdr.Xattrs["security.capability"] = string(capability) + } + + //handle re-mapping container ID mappings back to host ID mappings before + //writing tar headers/files + if ta.UIDMaps != nil || ta.GIDMaps != nil { + uid, gid, err := getFileUIDGID(fi.Sys()) + if err != nil { + return err + } + xUID, err := idtools.ToContainer(uid, ta.UIDMaps) + if err != nil { + return err + } + xGID, err := idtools.ToContainer(gid, ta.GIDMaps) + if err != nil { + return err + } + hdr.Uid = xUID + hdr.Gid = xGID + } + + if err := ta.TarWriter.WriteHeader(hdr); err != nil { + return err + } + + if hdr.Typeflag == tar.TypeReg { + file, err := os.Open(path) + if err != nil { + return err + } + + ta.Buffer.Reset(ta.TarWriter) + defer ta.Buffer.Reset(nil) + _, err = io.Copy(ta.Buffer, file) + file.Close() + if err != nil { + return err + } + err = ta.Buffer.Flush() + if err != nil { + return err + } + } + + return nil +} + +func createTarFile(path, extractDir string, hdr *tar.Header, reader io.Reader, Lchown bool, chownOpts *TarChownOptions) error { + // hdr.Mode is in linux format, which we can use for sycalls, + // but for os.Foo() calls we need the mode converted to os.FileMode, + // so use hdrInfo.Mode() (they differ for e.g. setuid bits) + hdrInfo := hdr.FileInfo() + + switch hdr.Typeflag { + case tar.TypeDir: + // Create directory unless it exists as a directory already. + // In that case we just want to merge the two + if fi, err := os.Lstat(path); !(err == nil && fi.IsDir()) { + if err := os.Mkdir(path, hdrInfo.Mode()); err != nil { + return err + } + } + + case tar.TypeReg, tar.TypeRegA: + // Source is regular file + file, err := os.OpenFile(path, os.O_CREATE|os.O_WRONLY, hdrInfo.Mode()) + if err != nil { + return err + } + if _, err := io.Copy(file, reader); err != nil { + file.Close() + return err + } + file.Close() + + case tar.TypeBlock, tar.TypeChar, tar.TypeFifo: + // Handle this is an OS-specific way + if err := handleTarTypeBlockCharFifo(hdr, path); err != nil { + return err + } + + case tar.TypeLink: + targetPath := filepath.Join(extractDir, hdr.Linkname) + // check for hardlink breakout + if !strings.HasPrefix(targetPath, extractDir) { + return breakoutError(fmt.Errorf("invalid hardlink %q -> %q", targetPath, hdr.Linkname)) + } + if err := os.Link(targetPath, path); err != nil { + return err + } + + case tar.TypeSymlink: + // path -> hdr.Linkname = targetPath + // e.g. /extractDir/path/to/symlink -> ../2/file = /extractDir/path/2/file + targetPath := filepath.Join(filepath.Dir(path), hdr.Linkname) + + // the reason we don't need to check symlinks in the path (with FollowSymlinkInScope) is because + // that symlink would first have to be created, which would be caught earlier, at this very check: + if !strings.HasPrefix(targetPath, extractDir) { + return breakoutError(fmt.Errorf("invalid symlink %q -> %q", path, hdr.Linkname)) + } + if err := os.Symlink(hdr.Linkname, path); err != nil { + return err + } + + case tar.TypeXGlobalHeader: + logrus.Debugf("PAX Global Extended Headers found and ignored") + return nil + + default: + return fmt.Errorf("Unhandled tar header type %d\n", hdr.Typeflag) + } + + // Lchown is not supported on Windows. + if Lchown && runtime.GOOS != "windows" { + if chownOpts == nil { + chownOpts = &TarChownOptions{UID: hdr.Uid, GID: hdr.Gid} + } + if err := os.Lchown(path, chownOpts.UID, chownOpts.GID); err != nil { + return err + } + } + + for key, value := range hdr.Xattrs { + if err := system.Lsetxattr(path, key, []byte(value), 0); err != nil { + return err + } + } + + // There is no LChmod, so ignore mode for symlink. Also, this + // must happen after chown, as that can modify the file mode + if err := handleLChmod(hdr, path, hdrInfo); err != nil { + return err + } + + // system.Chtimes doesn't support a NOFOLLOW flag atm + if hdr.Typeflag == tar.TypeLink { + if fi, err := os.Lstat(hdr.Linkname); err == nil && (fi.Mode()&os.ModeSymlink == 0) { + if err := system.Chtimes(path, hdr.AccessTime, hdr.ModTime); err != nil { + return err + } + } + } else if hdr.Typeflag != tar.TypeSymlink { + if err := system.Chtimes(path, hdr.AccessTime, hdr.ModTime); err != nil { + return err + } + } else { + ts := []syscall.Timespec{timeToTimespec(hdr.AccessTime), timeToTimespec(hdr.ModTime)} + if err := system.LUtimesNano(path, ts); err != nil && err != system.ErrNotSupportedPlatform { + return err + } + } + return nil +} + +// Tar creates an archive from the directory at `path`, and returns it as a +// stream of bytes. +func Tar(path string, compression Compression) (io.ReadCloser, error) { + return TarWithOptions(path, &TarOptions{Compression: compression}) +} + +// TarWithOptions creates an archive from the directory at `path`, only including files whose relative +// paths are included in `options.IncludeFiles` (if non-nil) or not in `options.ExcludePatterns`. +func TarWithOptions(srcPath string, options *TarOptions) (io.ReadCloser, error) { + + // Fix the source path to work with long path names. This is a no-op + // on platforms other than Windows. + srcPath = fixVolumePathPrefix(srcPath) + + patterns, patDirs, exceptions, err := fileutils.CleanPatterns(options.ExcludePatterns) + + if err != nil { + return nil, err + } + + pipeReader, pipeWriter := io.Pipe() + + compressWriter, err := CompressStream(pipeWriter, options.Compression) + if err != nil { + return nil, err + } + + go func() { + ta := &tarAppender{ + TarWriter: tar.NewWriter(compressWriter), + Buffer: pools.BufioWriter32KPool.Get(nil), + SeenFiles: make(map[uint64]string), + UIDMaps: options.UIDMaps, + GIDMaps: options.GIDMaps, + } + + defer func() { + // Make sure to check the error on Close. + if err := ta.TarWriter.Close(); err != nil { + logrus.Debugf("Can't close tar writer: %s", err) + } + if err := compressWriter.Close(); err != nil { + logrus.Debugf("Can't close compress writer: %s", err) + } + if err := pipeWriter.Close(); err != nil { + logrus.Debugf("Can't close pipe writer: %s", err) + } + }() + + // this buffer is needed for the duration of this piped stream + defer pools.BufioWriter32KPool.Put(ta.Buffer) + + // In general we log errors here but ignore them because + // during e.g. a diff operation the container can continue + // mutating the filesystem and we can see transient errors + // from this + + stat, err := os.Lstat(srcPath) + if err != nil { + return + } + + if !stat.IsDir() { + // We can't later join a non-dir with any includes because the + // 'walk' will error if "file/." is stat-ed and "file" is not a + // directory. So, we must split the source path and use the + // basename as the include. + if len(options.IncludeFiles) > 0 { + logrus.Warn("Tar: Can't archive a file with includes") + } + + dir, base := SplitPathDirEntry(srcPath) + srcPath = dir + options.IncludeFiles = []string{base} + } + + if len(options.IncludeFiles) == 0 { + options.IncludeFiles = []string{"."} + } + + seen := make(map[string]bool) + + for _, include := range options.IncludeFiles { + rebaseName := options.RebaseNames[include] + + walkRoot := getWalkRoot(srcPath, include) + filepath.Walk(walkRoot, func(filePath string, f os.FileInfo, err error) error { + if err != nil { + logrus.Debugf("Tar: Can't stat file %s to tar: %s", srcPath, err) + return nil + } + + relFilePath, err := filepath.Rel(srcPath, filePath) + if err != nil || (!options.IncludeSourceDir && relFilePath == "." && f.IsDir()) { + // Error getting relative path OR we are looking + // at the source directory path. Skip in both situations. + return nil + } + + if options.IncludeSourceDir && include == "." && relFilePath != "." { + relFilePath = strings.Join([]string{".", relFilePath}, string(filepath.Separator)) + } + + skip := false + + // If "include" is an exact match for the current file + // then even if there's an "excludePatterns" pattern that + // matches it, don't skip it. IOW, assume an explicit 'include' + // is asking for that file no matter what - which is true + // for some files, like .dockerignore and Dockerfile (sometimes) + if include != relFilePath { + skip, err = fileutils.OptimizedMatches(relFilePath, patterns, patDirs) + if err != nil { + logrus.Debugf("Error matching %s: %v", relFilePath, err) + return err + } + } + + if skip { + if !exceptions && f.IsDir() { + return filepath.SkipDir + } + return nil + } + + if seen[relFilePath] { + return nil + } + seen[relFilePath] = true + + // Rename the base resource. + if rebaseName != "" { + var replacement string + if rebaseName != string(filepath.Separator) { + // Special case the root directory to replace with an + // empty string instead so that we don't end up with + // double slashes in the paths. + replacement = rebaseName + } + + relFilePath = strings.Replace(relFilePath, include, replacement, 1) + } + + if err := ta.addTarFile(filePath, relFilePath); err != nil { + logrus.Debugf("Can't add file %s to tar: %s", filePath, err) + } + return nil + }) + } + }() + + return pipeReader, nil +} + +// Unpack unpacks the decompressedArchive to dest with options. +func Unpack(decompressedArchive io.Reader, dest string, options *TarOptions) error { + tr := tar.NewReader(decompressedArchive) + trBuf := pools.BufioReader32KPool.Get(nil) + defer pools.BufioReader32KPool.Put(trBuf) + + var dirs []*tar.Header + remappedRootUID, remappedRootGID, err := idtools.GetRootUIDGID(options.UIDMaps, options.GIDMaps) + if err != nil { + return err + } + + // Iterate through the files in the archive. +loop: + for { + hdr, err := tr.Next() + if err == io.EOF { + // end of tar archive + break + } + if err != nil { + return err + } + + // Normalize name, for safety and for a simple is-root check + // This keeps "../" as-is, but normalizes "/../" to "/". Or Windows: + // This keeps "..\" as-is, but normalizes "\..\" to "\". + hdr.Name = filepath.Clean(hdr.Name) + + for _, exclude := range options.ExcludePatterns { + if strings.HasPrefix(hdr.Name, exclude) { + continue loop + } + } + + // After calling filepath.Clean(hdr.Name) above, hdr.Name will now be in + // the filepath format for the OS on which the daemon is running. Hence + // the check for a slash-suffix MUST be done in an OS-agnostic way. + if !strings.HasSuffix(hdr.Name, string(os.PathSeparator)) { + // Not the root directory, ensure that the parent directory exists + parent := filepath.Dir(hdr.Name) + parentPath := filepath.Join(dest, parent) + if _, err := os.Lstat(parentPath); err != nil && os.IsNotExist(err) { + err = system.MkdirAll(parentPath, 0777) + if err != nil { + return err + } + } + } + + path := filepath.Join(dest, hdr.Name) + rel, err := filepath.Rel(dest, path) + if err != nil { + return err + } + if strings.HasPrefix(rel, ".."+string(os.PathSeparator)) { + return breakoutError(fmt.Errorf("%q is outside of %q", hdr.Name, dest)) + } + + // If path exits we almost always just want to remove and replace it + // The only exception is when it is a directory *and* the file from + // the layer is also a directory. Then we want to merge them (i.e. + // just apply the metadata from the layer). + if fi, err := os.Lstat(path); err == nil { + if options.NoOverwriteDirNonDir && fi.IsDir() && hdr.Typeflag != tar.TypeDir { + // If NoOverwriteDirNonDir is true then we cannot replace + // an existing directory with a non-directory from the archive. + return fmt.Errorf("cannot overwrite directory %q with non-directory %q", path, dest) + } + + if options.NoOverwriteDirNonDir && !fi.IsDir() && hdr.Typeflag == tar.TypeDir { + // If NoOverwriteDirNonDir is true then we cannot replace + // an existing non-directory with a directory from the archive. + return fmt.Errorf("cannot overwrite non-directory %q with directory %q", path, dest) + } + + if fi.IsDir() && hdr.Name == "." { + continue + } + + if !(fi.IsDir() && hdr.Typeflag == tar.TypeDir) { + if err := os.RemoveAll(path); err != nil { + return err + } + } + } + trBuf.Reset(tr) + + // if the options contain a uid & gid maps, convert header uid/gid + // entries using the maps such that lchown sets the proper mapped + // uid/gid after writing the file. We only perform this mapping if + // the file isn't already owned by the remapped root UID or GID, as + // that specific uid/gid has no mapping from container -> host, and + // those files already have the proper ownership for inside the + // container. + if hdr.Uid != remappedRootUID { + xUID, err := idtools.ToHost(hdr.Uid, options.UIDMaps) + if err != nil { + return err + } + hdr.Uid = xUID + } + if hdr.Gid != remappedRootGID { + xGID, err := idtools.ToHost(hdr.Gid, options.GIDMaps) + if err != nil { + return err + } + hdr.Gid = xGID + } + + if err := createTarFile(path, dest, hdr, trBuf, !options.NoLchown, options.ChownOpts); err != nil { + return err + } + + // Directory mtimes must be handled at the end to avoid further + // file creation in them to modify the directory mtime + if hdr.Typeflag == tar.TypeDir { + dirs = append(dirs, hdr) + } + } + + for _, hdr := range dirs { + path := filepath.Join(dest, hdr.Name) + + if err := system.Chtimes(path, hdr.AccessTime, hdr.ModTime); err != nil { + return err + } + } + return nil +} + +// Untar reads a stream of bytes from `archive`, parses it as a tar archive, +// and unpacks it into the directory at `dest`. +// The archive may be compressed with one of the following algorithms: +// identity (uncompressed), gzip, bzip2, xz. +// FIXME: specify behavior when target path exists vs. doesn't exist. +func Untar(tarArchive io.Reader, dest string, options *TarOptions) error { + return untarHandler(tarArchive, dest, options, true) +} + +// UntarUncompressed reads a stream of bytes from `archive`, parses it as a tar archive, +// and unpacks it into the directory at `dest`. +// The archive must be an uncompressed stream. +func UntarUncompressed(tarArchive io.Reader, dest string, options *TarOptions) error { + return untarHandler(tarArchive, dest, options, false) +} + +// Handler for teasing out the automatic decompression +func untarHandler(tarArchive io.Reader, dest string, options *TarOptions, decompress bool) error { + if tarArchive == nil { + return fmt.Errorf("Empty archive") + } + dest = filepath.Clean(dest) + if options == nil { + options = &TarOptions{} + } + if options.ExcludePatterns == nil { + options.ExcludePatterns = []string{} + } + + r := tarArchive + if decompress { + decompressedArchive, err := DecompressStream(tarArchive) + if err != nil { + return err + } + defer decompressedArchive.Close() + r = decompressedArchive + } + + return Unpack(r, dest, options) +} + +// TarUntar is a convenience function which calls Tar and Untar, with the output of one piped into the other. +// If either Tar or Untar fails, TarUntar aborts and returns the error. +func (archiver *Archiver) TarUntar(src, dst string) error { + logrus.Debugf("TarUntar(%s %s)", src, dst) + archive, err := TarWithOptions(src, &TarOptions{Compression: Uncompressed}) + if err != nil { + return err + } + defer archive.Close() + + var options *TarOptions + if archiver.UIDMaps != nil || archiver.GIDMaps != nil { + options = &TarOptions{ + UIDMaps: archiver.UIDMaps, + GIDMaps: archiver.GIDMaps, + } + } + return archiver.Untar(archive, dst, options) +} + +// TarUntar is a convenience function which calls Tar and Untar, with the output of one piped into the other. +// If either Tar or Untar fails, TarUntar aborts and returns the error. +func TarUntar(src, dst string) error { + return defaultArchiver.TarUntar(src, dst) +} + +// UntarPath untar a file from path to a destination, src is the source tar file path. +func (archiver *Archiver) UntarPath(src, dst string) error { + archive, err := os.Open(src) + if err != nil { + return err + } + defer archive.Close() + var options *TarOptions + if archiver.UIDMaps != nil || archiver.GIDMaps != nil { + options = &TarOptions{ + UIDMaps: archiver.UIDMaps, + GIDMaps: archiver.GIDMaps, + } + } + if err := archiver.Untar(archive, dst, options); err != nil { + return err + } + return nil +} + +// UntarPath is a convenience function which looks for an archive +// at filesystem path `src`, and unpacks it at `dst`. +func UntarPath(src, dst string) error { + return defaultArchiver.UntarPath(src, dst) +} + +// CopyWithTar creates a tar archive of filesystem path `src`, and +// unpacks it at filesystem path `dst`. +// The archive is streamed directly with fixed buffering and no +// intermediary disk IO. +func (archiver *Archiver) CopyWithTar(src, dst string) error { + srcSt, err := os.Stat(src) + if err != nil { + return err + } + if !srcSt.IsDir() { + return archiver.CopyFileWithTar(src, dst) + } + // Create dst, copy src's content into it + logrus.Debugf("Creating dest directory: %s", dst) + if err := system.MkdirAll(dst, 0755); err != nil { + return err + } + logrus.Debugf("Calling TarUntar(%s, %s)", src, dst) + return archiver.TarUntar(src, dst) +} + +// CopyWithTar creates a tar archive of filesystem path `src`, and +// unpacks it at filesystem path `dst`. +// The archive is streamed directly with fixed buffering and no +// intermediary disk IO. +func CopyWithTar(src, dst string) error { + return defaultArchiver.CopyWithTar(src, dst) +} + +// CopyFileWithTar emulates the behavior of the 'cp' command-line +// for a single file. It copies a regular file from path `src` to +// path `dst`, and preserves all its metadata. +func (archiver *Archiver) CopyFileWithTar(src, dst string) (err error) { + logrus.Debugf("CopyFileWithTar(%s, %s)", src, dst) + srcSt, err := os.Stat(src) + if err != nil { + return err + } + + if srcSt.IsDir() { + return fmt.Errorf("Can't copy a directory") + } + + // Clean up the trailing slash. This must be done in an operating + // system specific manner. + if dst[len(dst)-1] == os.PathSeparator { + dst = filepath.Join(dst, filepath.Base(src)) + } + // Create the holding directory if necessary + if err := system.MkdirAll(filepath.Dir(dst), 0700); err != nil { + return err + } + + r, w := io.Pipe() + errC := promise.Go(func() error { + defer w.Close() + + srcF, err := os.Open(src) + if err != nil { + return err + } + defer srcF.Close() + + hdr, err := tar.FileInfoHeader(srcSt, "") + if err != nil { + return err + } + hdr.Name = filepath.Base(dst) + hdr.Mode = int64(chmodTarEntry(os.FileMode(hdr.Mode))) + + remappedRootUID, remappedRootGID, err := idtools.GetRootUIDGID(archiver.UIDMaps, archiver.GIDMaps) + if err != nil { + return err + } + + // only perform mapping if the file being copied isn't already owned by the + // uid or gid of the remapped root in the container + if remappedRootUID != hdr.Uid { + xUID, err := idtools.ToHost(hdr.Uid, archiver.UIDMaps) + if err != nil { + return err + } + hdr.Uid = xUID + } + if remappedRootGID != hdr.Gid { + xGID, err := idtools.ToHost(hdr.Gid, archiver.GIDMaps) + if err != nil { + return err + } + hdr.Gid = xGID + } + + tw := tar.NewWriter(w) + defer tw.Close() + if err := tw.WriteHeader(hdr); err != nil { + return err + } + if _, err := io.Copy(tw, srcF); err != nil { + return err + } + return nil + }) + defer func() { + if er := <-errC; err != nil { + err = er + } + }() + + err = archiver.Untar(r, filepath.Dir(dst), nil) + if err != nil { + r.CloseWithError(err) + } + return err +} + +// CopyFileWithTar emulates the behavior of the 'cp' command-line +// for a single file. It copies a regular file from path `src` to +// path `dst`, and preserves all its metadata. +// +// Destination handling is in an operating specific manner depending +// where the daemon is running. If `dst` ends with a trailing slash +// the final destination path will be `dst/base(src)` (Linux) or +// `dst\base(src)` (Windows). +func CopyFileWithTar(src, dst string) (err error) { + return defaultArchiver.CopyFileWithTar(src, dst) +} + +// cmdStream executes a command, and returns its stdout as a stream. +// If the command fails to run or doesn't complete successfully, an error +// will be returned, including anything written on stderr. +func cmdStream(cmd *exec.Cmd, input io.Reader) (io.ReadCloser, <-chan struct{}, error) { + chdone := make(chan struct{}) + cmd.Stdin = input + pipeR, pipeW := io.Pipe() + cmd.Stdout = pipeW + var errBuf bytes.Buffer + cmd.Stderr = &errBuf + + // Run the command and return the pipe + if err := cmd.Start(); err != nil { + return nil, nil, err + } + + // Copy stdout to the returned pipe + go func() { + if err := cmd.Wait(); err != nil { + pipeW.CloseWithError(fmt.Errorf("%s: %s", err, errBuf.String())) + } else { + pipeW.Close() + } + close(chdone) + }() + + return pipeR, chdone, nil +} + +// NewTempArchive reads the content of src into a temporary file, and returns the contents +// of that file as an archive. The archive can only be read once - as soon as reading completes, +// the file will be deleted. +func NewTempArchive(src Archive, dir string) (*TempArchive, error) { + f, err := ioutil.TempFile(dir, "") + if err != nil { + return nil, err + } + if _, err := io.Copy(f, src); err != nil { + return nil, err + } + if _, err := f.Seek(0, 0); err != nil { + return nil, err + } + st, err := f.Stat() + if err != nil { + return nil, err + } + size := st.Size() + return &TempArchive{File: f, Size: size}, nil +} + +// TempArchive is a temporary archive. The archive can only be read once - as soon as reading completes, +// the file will be deleted. +type TempArchive struct { + *os.File + Size int64 // Pre-computed from Stat().Size() as a convenience + read int64 + closed bool +} + +// Close closes the underlying file if it's still open, or does a no-op +// to allow callers to try to close the TempArchive multiple times safely. +func (archive *TempArchive) Close() error { + if archive.closed { + return nil + } + + archive.closed = true + + return archive.File.Close() +} + +func (archive *TempArchive) Read(data []byte) (int, error) { + n, err := archive.File.Read(data) + archive.read += int64(n) + if err != nil || archive.read == archive.Size { + archive.Close() + os.Remove(archive.File.Name()) + } + return n, err +} diff --git a/pkg/archive/archive_test.go b/pkg/archive/archive_test.go new file mode 100644 index 0000000000..6c54c02d18 --- /dev/null +++ b/pkg/archive/archive_test.go @@ -0,0 +1,1204 @@ +package archive + +import ( + "archive/tar" + "bytes" + "fmt" + "io" + "io/ioutil" + "os" + "os/exec" + "path" + "path/filepath" + "strings" + "syscall" + "testing" + "time" + + "github.com/docker/docker/pkg/system" +) + +func TestIsArchiveNilHeader(t *testing.T) { + out := IsArchive(nil) + if out { + t.Fatalf("isArchive should return false as nil is not a valid archive header") + } +} + +func TestIsArchiveInvalidHeader(t *testing.T) { + header := []byte{0x00, 0x01, 0x02} + out := IsArchive(header) + if out { + t.Fatalf("isArchive should return false as %s is not a valid archive header", header) + } +} + +func TestIsArchiveBzip2(t *testing.T) { + header := []byte{0x42, 0x5A, 0x68} + out := IsArchive(header) + if !out { + t.Fatalf("isArchive should return true as %s is a bz2 header", header) + } +} + +func TestIsArchive7zip(t *testing.T) { + header := []byte{0x50, 0x4b, 0x03, 0x04} + out := IsArchive(header) + if out { + t.Fatalf("isArchive should return false as %s is a 7z header and it is not supported", header) + } +} + +func TestDecompressStreamGzip(t *testing.T) { + cmd := exec.Command("/bin/sh", "-c", "touch /tmp/archive && gzip -f /tmp/archive") + output, err := cmd.CombinedOutput() + if err != nil { + t.Fatalf("Fail to create an archive file for test : %s.", output) + } + archive, err := os.Open("/tmp/archive.gz") + _, err = DecompressStream(archive) + if err != nil { + t.Fatalf("Failed to decompress a gzip file.") + } +} + +func TestDecompressStreamBzip2(t *testing.T) { + cmd := exec.Command("/bin/sh", "-c", "touch /tmp/archive && bzip2 -f /tmp/archive") + output, err := cmd.CombinedOutput() + if err != nil { + t.Fatalf("Fail to create an archive file for test : %s.", output) + } + archive, err := os.Open("/tmp/archive.bz2") + _, err = DecompressStream(archive) + if err != nil { + t.Fatalf("Failed to decompress a bzip2 file.") + } +} + +func TestDecompressStreamXz(t *testing.T) { + cmd := exec.Command("/bin/sh", "-c", "touch /tmp/archive && xz -f /tmp/archive") + output, err := cmd.CombinedOutput() + if err != nil { + t.Fatalf("Fail to create an archive file for test : %s.", output) + } + archive, err := os.Open("/tmp/archive.xz") + _, err = DecompressStream(archive) + if err != nil { + t.Fatalf("Failed to decompress a xz file.") + } +} + +func TestCompressStreamXzUnsuported(t *testing.T) { + dest, err := os.Create("/tmp/dest") + if err != nil { + t.Fatalf("Fail to create the destination file") + } + _, err = CompressStream(dest, Xz) + if err == nil { + t.Fatalf("Should fail as xz is unsupported for compression format.") + } +} + +func TestCompressStreamBzip2Unsupported(t *testing.T) { + dest, err := os.Create("/tmp/dest") + if err != nil { + t.Fatalf("Fail to create the destination file") + } + _, err = CompressStream(dest, Xz) + if err == nil { + t.Fatalf("Should fail as xz is unsupported for compression format.") + } +} + +func TestCompressStreamInvalid(t *testing.T) { + dest, err := os.Create("/tmp/dest") + if err != nil { + t.Fatalf("Fail to create the destination file") + } + _, err = CompressStream(dest, -1) + if err == nil { + t.Fatalf("Should fail as xz is unsupported for compression format.") + } +} + +func TestExtensionInvalid(t *testing.T) { + compression := Compression(-1) + output := compression.Extension() + if output != "" { + t.Fatalf("The extension of an invalid compression should be an empty string.") + } +} + +func TestExtensionUncompressed(t *testing.T) { + compression := Uncompressed + output := compression.Extension() + if output != "tar" { + t.Fatalf("The extension of a uncompressed archive should be 'tar'.") + } +} +func TestExtensionBzip2(t *testing.T) { + compression := Bzip2 + output := compression.Extension() + if output != "tar.bz2" { + t.Fatalf("The extension of a bzip2 archive should be 'tar.bz2'") + } +} +func TestExtensionGzip(t *testing.T) { + compression := Gzip + output := compression.Extension() + if output != "tar.gz" { + t.Fatalf("The extension of a bzip2 archive should be 'tar.gz'") + } +} +func TestExtensionXz(t *testing.T) { + compression := Xz + output := compression.Extension() + if output != "tar.xz" { + t.Fatalf("The extension of a bzip2 archive should be 'tar.xz'") + } +} + +func TestCmdStreamLargeStderr(t *testing.T) { + cmd := exec.Command("/bin/sh", "-c", "dd if=/dev/zero bs=1k count=1000 of=/dev/stderr; echo hello") + out, _, err := cmdStream(cmd, nil) + if err != nil { + t.Fatalf("Failed to start command: %s", err) + } + errCh := make(chan error) + go func() { + _, err := io.Copy(ioutil.Discard, out) + errCh <- err + }() + select { + case err := <-errCh: + if err != nil { + t.Fatalf("Command should not have failed (err=%.100s...)", err) + } + case <-time.After(5 * time.Second): + t.Fatalf("Command did not complete in 5 seconds; probable deadlock") + } +} + +func TestCmdStreamBad(t *testing.T) { + badCmd := exec.Command("/bin/sh", "-c", "echo hello; echo >&2 error couldn\\'t reverse the phase pulser; exit 1") + out, _, err := cmdStream(badCmd, nil) + if err != nil { + t.Fatalf("Failed to start command: %s", err) + } + if output, err := ioutil.ReadAll(out); err == nil { + t.Fatalf("Command should have failed") + } else if err.Error() != "exit status 1: error couldn't reverse the phase pulser\n" { + t.Fatalf("Wrong error value (%s)", err) + } else if s := string(output); s != "hello\n" { + t.Fatalf("Command output should be '%s', not '%s'", "hello\\n", output) + } +} + +func TestCmdStreamGood(t *testing.T) { + cmd := exec.Command("/bin/sh", "-c", "echo hello; exit 0") + out, _, err := cmdStream(cmd, nil) + if err != nil { + t.Fatal(err) + } + if output, err := ioutil.ReadAll(out); err != nil { + t.Fatalf("Command should not have failed (err=%s)", err) + } else if s := string(output); s != "hello\n" { + t.Fatalf("Command output should be '%s', not '%s'", "hello\\n", output) + } +} + +func TestUntarPathWithInvalidDest(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tempFolder) + invalidDestFolder := path.Join(tempFolder, "invalidDest") + // Create a src file + srcFile := path.Join(tempFolder, "src") + _, err = os.Create(srcFile) + if err != nil { + t.Fatalf("Fail to create the source file") + } + err = UntarPath(srcFile, invalidDestFolder) + if err == nil { + t.Fatalf("UntarPath with invalid destination path should throw an error.") + } +} + +func TestUntarPathWithInvalidSrc(t *testing.T) { + dest, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatalf("Fail to create the destination file") + } + defer os.RemoveAll(dest) + err = UntarPath("/invalid/path", dest) + if err == nil { + t.Fatalf("UntarPath with invalid src path should throw an error.") + } +} + +func TestUntarPath(t *testing.T) { + tmpFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpFolder) + srcFile := path.Join(tmpFolder, "src") + tarFile := path.Join(tmpFolder, "src.tar") + os.Create(path.Join(tmpFolder, "src")) + cmd := exec.Command("/bin/sh", "-c", "tar cf "+tarFile+" "+srcFile) + _, err = cmd.CombinedOutput() + if err != nil { + t.Fatal(err) + } + destFolder := path.Join(tmpFolder, "dest") + err = os.MkdirAll(destFolder, 0740) + if err != nil { + t.Fatalf("Fail to create the destination file") + } + err = UntarPath(tarFile, destFolder) + if err != nil { + t.Fatalf("UntarPath shouldn't throw an error, %s.", err) + } + expectedFile := path.Join(destFolder, srcFile) + _, err = os.Stat(expectedFile) + if err != nil { + t.Fatalf("Destination folder should contain the source file but did not.") + } +} + +// Do the same test as above but with the destination as file, it should fail +func TestUntarPathWithDestinationFile(t *testing.T) { + tmpFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpFolder) + srcFile := path.Join(tmpFolder, "src") + tarFile := path.Join(tmpFolder, "src.tar") + os.Create(path.Join(tmpFolder, "src")) + cmd := exec.Command("/bin/sh", "-c", "tar cf "+tarFile+" "+srcFile) + _, err = cmd.CombinedOutput() + if err != nil { + t.Fatal(err) + } + destFile := path.Join(tmpFolder, "dest") + _, err = os.Create(destFile) + if err != nil { + t.Fatalf("Fail to create the destination file") + } + err = UntarPath(tarFile, destFile) + if err == nil { + t.Fatalf("UntarPath should throw an error if the destination if a file") + } +} + +// Do the same test as above but with the destination folder already exists +// and the destination file is a directory +// It's working, see https://github.com/docker/docker/issues/10040 +func TestUntarPathWithDestinationSrcFileAsFolder(t *testing.T) { + tmpFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpFolder) + srcFile := path.Join(tmpFolder, "src") + tarFile := path.Join(tmpFolder, "src.tar") + os.Create(srcFile) + cmd := exec.Command("/bin/sh", "-c", "tar cf "+tarFile+" "+srcFile) + _, err = cmd.CombinedOutput() + if err != nil { + t.Fatal(err) + } + destFolder := path.Join(tmpFolder, "dest") + err = os.MkdirAll(destFolder, 0740) + if err != nil { + t.Fatalf("Fail to create the destination folder") + } + // Let's create a folder that will has the same path as the extracted file (from tar) + destSrcFileAsFolder := path.Join(destFolder, srcFile) + err = os.MkdirAll(destSrcFileAsFolder, 0740) + if err != nil { + t.Fatal(err) + } + err = UntarPath(tarFile, destFolder) + if err != nil { + t.Fatalf("UntarPath should throw not throw an error if the extracted file already exists and is a folder") + } +} + +func TestCopyWithTarInvalidSrc(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(nil) + } + destFolder := path.Join(tempFolder, "dest") + invalidSrc := path.Join(tempFolder, "doesnotexists") + err = os.MkdirAll(destFolder, 0740) + if err != nil { + t.Fatal(err) + } + err = CopyWithTar(invalidSrc, destFolder) + if err == nil { + t.Fatalf("archiver.CopyWithTar with invalid src path should throw an error.") + } +} + +func TestCopyWithTarInexistentDestWillCreateIt(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(nil) + } + srcFolder := path.Join(tempFolder, "src") + inexistentDestFolder := path.Join(tempFolder, "doesnotexists") + err = os.MkdirAll(srcFolder, 0740) + if err != nil { + t.Fatal(err) + } + err = CopyWithTar(srcFolder, inexistentDestFolder) + if err != nil { + t.Fatalf("CopyWithTar with an inexistent folder shouldn't fail.") + } + _, err = os.Stat(inexistentDestFolder) + if err != nil { + t.Fatalf("CopyWithTar with an inexistent folder should create it.") + } +} + +// Test CopyWithTar with a file as src +func TestCopyWithTarSrcFile(t *testing.T) { + folder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(folder) + dest := path.Join(folder, "dest") + srcFolder := path.Join(folder, "src") + src := path.Join(folder, path.Join("src", "src")) + err = os.MkdirAll(srcFolder, 0740) + if err != nil { + t.Fatal(err) + } + err = os.MkdirAll(dest, 0740) + if err != nil { + t.Fatal(err) + } + ioutil.WriteFile(src, []byte("content"), 0777) + err = CopyWithTar(src, dest) + if err != nil { + t.Fatalf("archiver.CopyWithTar shouldn't throw an error, %s.", err) + } + _, err = os.Stat(dest) + // FIXME Check the content + if err != nil { + t.Fatalf("Destination file should be the same as the source.") + } +} + +// Test CopyWithTar with a folder as src +func TestCopyWithTarSrcFolder(t *testing.T) { + folder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(folder) + dest := path.Join(folder, "dest") + src := path.Join(folder, path.Join("src", "folder")) + err = os.MkdirAll(src, 0740) + if err != nil { + t.Fatal(err) + } + err = os.MkdirAll(dest, 0740) + if err != nil { + t.Fatal(err) + } + ioutil.WriteFile(path.Join(src, "file"), []byte("content"), 0777) + err = CopyWithTar(src, dest) + if err != nil { + t.Fatalf("archiver.CopyWithTar shouldn't throw an error, %s.", err) + } + _, err = os.Stat(dest) + // FIXME Check the content (the file inside) + if err != nil { + t.Fatalf("Destination folder should contain the source file but did not.") + } +} + +func TestCopyFileWithTarInvalidSrc(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tempFolder) + destFolder := path.Join(tempFolder, "dest") + err = os.MkdirAll(destFolder, 0740) + if err != nil { + t.Fatal(err) + } + invalidFile := path.Join(tempFolder, "doesnotexists") + err = CopyFileWithTar(invalidFile, destFolder) + if err == nil { + t.Fatalf("archiver.CopyWithTar with invalid src path should throw an error.") + } +} + +func TestCopyFileWithTarInexistentDestWillCreateIt(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(nil) + } + defer os.RemoveAll(tempFolder) + srcFile := path.Join(tempFolder, "src") + inexistentDestFolder := path.Join(tempFolder, "doesnotexists") + _, err = os.Create(srcFile) + if err != nil { + t.Fatal(err) + } + err = CopyFileWithTar(srcFile, inexistentDestFolder) + if err != nil { + t.Fatalf("CopyWithTar with an inexistent folder shouldn't fail.") + } + _, err = os.Stat(inexistentDestFolder) + if err != nil { + t.Fatalf("CopyWithTar with an inexistent folder should create it.") + } + // FIXME Test the src file and content +} + +func TestCopyFileWithTarSrcFolder(t *testing.T) { + folder, err := ioutil.TempDir("", "docker-archive-copyfilewithtar-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(folder) + dest := path.Join(folder, "dest") + src := path.Join(folder, "srcfolder") + err = os.MkdirAll(src, 0740) + if err != nil { + t.Fatal(err) + } + err = os.MkdirAll(dest, 0740) + if err != nil { + t.Fatal(err) + } + err = CopyFileWithTar(src, dest) + if err == nil { + t.Fatalf("CopyFileWithTar should throw an error with a folder.") + } +} + +func TestCopyFileWithTarSrcFile(t *testing.T) { + folder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(folder) + dest := path.Join(folder, "dest") + srcFolder := path.Join(folder, "src") + src := path.Join(folder, path.Join("src", "src")) + err = os.MkdirAll(srcFolder, 0740) + if err != nil { + t.Fatal(err) + } + err = os.MkdirAll(dest, 0740) + if err != nil { + t.Fatal(err) + } + ioutil.WriteFile(src, []byte("content"), 0777) + err = CopyWithTar(src, dest+"/") + if err != nil { + t.Fatalf("archiver.CopyFileWithTar shouldn't throw an error, %s.", err) + } + _, err = os.Stat(dest) + if err != nil { + t.Fatalf("Destination folder should contain the source file but did not.") + } +} + +func TestTarFiles(t *testing.T) { + // try without hardlinks + if err := checkNoChanges(1000, false); err != nil { + t.Fatal(err) + } + // try with hardlinks + if err := checkNoChanges(1000, true); err != nil { + t.Fatal(err) + } +} + +func checkNoChanges(fileNum int, hardlinks bool) error { + srcDir, err := ioutil.TempDir("", "docker-test-srcDir") + if err != nil { + return err + } + defer os.RemoveAll(srcDir) + + destDir, err := ioutil.TempDir("", "docker-test-destDir") + if err != nil { + return err + } + defer os.RemoveAll(destDir) + + _, err = prepareUntarSourceDirectory(fileNum, srcDir, hardlinks) + if err != nil { + return err + } + + err = TarUntar(srcDir, destDir) + if err != nil { + return err + } + + changes, err := ChangesDirs(destDir, srcDir) + if err != nil { + return err + } + if len(changes) > 0 { + return fmt.Errorf("with %d files and %v hardlinks: expected 0 changes, got %d", fileNum, hardlinks, len(changes)) + } + return nil +} + +func tarUntar(t *testing.T, origin string, options *TarOptions) ([]Change, error) { + archive, err := TarWithOptions(origin, options) + if err != nil { + t.Fatal(err) + } + defer archive.Close() + + buf := make([]byte, 10) + if _, err := archive.Read(buf); err != nil { + return nil, err + } + wrap := io.MultiReader(bytes.NewReader(buf), archive) + + detectedCompression := DetectCompression(buf) + compression := options.Compression + if detectedCompression.Extension() != compression.Extension() { + return nil, fmt.Errorf("Wrong compression detected. Actual compression: %s, found %s", compression.Extension(), detectedCompression.Extension()) + } + + tmp, err := ioutil.TempDir("", "docker-test-untar") + if err != nil { + return nil, err + } + defer os.RemoveAll(tmp) + if err := Untar(wrap, tmp, nil); err != nil { + return nil, err + } + if _, err := os.Stat(tmp); err != nil { + return nil, err + } + + return ChangesDirs(origin, tmp) +} + +func TestTarUntar(t *testing.T) { + origin, err := ioutil.TempDir("", "docker-test-untar-origin") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(origin) + if err := ioutil.WriteFile(path.Join(origin, "1"), []byte("hello world"), 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(origin, "2"), []byte("welcome!"), 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(origin, "3"), []byte("will be ignored"), 0700); err != nil { + t.Fatal(err) + } + + for _, c := range []Compression{ + Uncompressed, + Gzip, + } { + changes, err := tarUntar(t, origin, &TarOptions{ + Compression: c, + ExcludePatterns: []string{"3"}, + }) + + if err != nil { + t.Fatalf("Error tar/untar for compression %s: %s", c.Extension(), err) + } + + if len(changes) != 1 || changes[0].Path != "/3" { + t.Fatalf("Unexpected differences after tarUntar: %v", changes) + } + } +} + +func TestTarUntarWithXattr(t *testing.T) { + origin, err := ioutil.TempDir("", "docker-test-untar-origin") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(origin) + if err := ioutil.WriteFile(path.Join(origin, "1"), []byte("hello world"), 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(origin, "2"), []byte("welcome!"), 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(origin, "3"), []byte("will be ignored"), 0700); err != nil { + t.Fatal(err) + } + if err := system.Lsetxattr(path.Join(origin, "2"), "security.capability", []byte{0x00}, 0); err != nil { + t.Fatal(err) + } + + for _, c := range []Compression{ + Uncompressed, + Gzip, + } { + changes, err := tarUntar(t, origin, &TarOptions{ + Compression: c, + ExcludePatterns: []string{"3"}, + }) + + if err != nil { + t.Fatalf("Error tar/untar for compression %s: %s", c.Extension(), err) + } + + if len(changes) != 1 || changes[0].Path != "/3" { + t.Fatalf("Unexpected differences after tarUntar: %v", changes) + } + capability, _ := system.Lgetxattr(path.Join(origin, "2"), "security.capability") + if capability == nil && capability[0] != 0x00 { + t.Fatalf("Untar should have kept the 'security.capability' xattr.") + } + } +} + +func TestTarWithOptions(t *testing.T) { + origin, err := ioutil.TempDir("", "docker-test-untar-origin") + if err != nil { + t.Fatal(err) + } + if _, err := ioutil.TempDir(origin, "folder"); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(origin) + if err := ioutil.WriteFile(path.Join(origin, "1"), []byte("hello world"), 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(origin, "2"), []byte("welcome!"), 0700); err != nil { + t.Fatal(err) + } + + cases := []struct { + opts *TarOptions + numChanges int + }{ + {&TarOptions{IncludeFiles: []string{"1"}}, 2}, + {&TarOptions{ExcludePatterns: []string{"2"}}, 1}, + {&TarOptions{ExcludePatterns: []string{"1", "folder*"}}, 2}, + {&TarOptions{IncludeFiles: []string{"1", "1"}}, 2}, + {&TarOptions{IncludeFiles: []string{"1"}, RebaseNames: map[string]string{"1": "test"}}, 4}, + } + for _, testCase := range cases { + changes, err := tarUntar(t, origin, testCase.opts) + if err != nil { + t.Fatalf("Error tar/untar when testing inclusion/exclusion: %s", err) + } + if len(changes) != testCase.numChanges { + t.Errorf("Expected %d changes, got %d for %+v:", + testCase.numChanges, len(changes), testCase.opts) + } + } +} + +// Some tar archives such as http://haproxy.1wt.eu/download/1.5/src/devel/haproxy-1.5-dev21.tar.gz +// use PAX Global Extended Headers. +// Failing prevents the archives from being uncompressed during ADD +func TestTypeXGlobalHeaderDoesNotFail(t *testing.T) { + hdr := tar.Header{Typeflag: tar.TypeXGlobalHeader} + tmpDir, err := ioutil.TempDir("", "docker-test-archive-pax-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpDir) + err = createTarFile(filepath.Join(tmpDir, "pax_global_header"), tmpDir, &hdr, nil, true, nil) + if err != nil { + t.Fatal(err) + } +} + +// Some tar have both GNU specific (huge uid) and Ustar specific (long name) things. +// Not supposed to happen (should use PAX instead of Ustar for long name) but it does and it should still work. +func TestUntarUstarGnuConflict(t *testing.T) { + f, err := os.Open("testdata/broken.tar") + if err != nil { + t.Fatal(err) + } + found := false + tr := tar.NewReader(f) + // Iterate through the files in the archive. + for { + hdr, err := tr.Next() + if err == io.EOF { + // end of tar archive + break + } + if err != nil { + t.Fatal(err) + } + if hdr.Name == "root/.cpanm/work/1395823785.24209/Plack-1.0030/blib/man3/Plack::Middleware::LighttpdScriptNameFix.3pm" { + found = true + break + } + } + if !found { + t.Fatalf("%s not found in the archive", "root/.cpanm/work/1395823785.24209/Plack-1.0030/blib/man3/Plack::Middleware::LighttpdScriptNameFix.3pm") + } +} + +func TestTarWithBlockCharFifo(t *testing.T) { + origin, err := ioutil.TempDir("", "docker-test-tar-hardlink") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(origin) + if err := ioutil.WriteFile(path.Join(origin, "1"), []byte("hello world"), 0700); err != nil { + t.Fatal(err) + } + if err := system.Mknod(path.Join(origin, "2"), syscall.S_IFBLK, int(system.Mkdev(int64(12), int64(5)))); err != nil { + t.Fatal(err) + } + if err := system.Mknod(path.Join(origin, "3"), syscall.S_IFCHR, int(system.Mkdev(int64(12), int64(5)))); err != nil { + t.Fatal(err) + } + if err := system.Mknod(path.Join(origin, "4"), syscall.S_IFIFO, int(system.Mkdev(int64(12), int64(5)))); err != nil { + t.Fatal(err) + } + + dest, err := ioutil.TempDir("", "docker-test-tar-hardlink-dest") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(dest) + + // we'll do this in two steps to separate failure + fh, err := Tar(origin, Uncompressed) + if err != nil { + t.Fatal(err) + } + + // ensure we can read the whole thing with no error, before writing back out + buf, err := ioutil.ReadAll(fh) + if err != nil { + t.Fatal(err) + } + + bRdr := bytes.NewReader(buf) + err = Untar(bRdr, dest, &TarOptions{Compression: Uncompressed}) + if err != nil { + t.Fatal(err) + } + + changes, err := ChangesDirs(origin, dest) + if err != nil { + t.Fatal(err) + } + if len(changes) > 0 { + t.Fatalf("Tar with special device (block, char, fifo) should keep them (recreate them when untar) : %v", changes) + } +} + +func TestTarWithHardLink(t *testing.T) { + origin, err := ioutil.TempDir("", "docker-test-tar-hardlink") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(origin) + if err := ioutil.WriteFile(path.Join(origin, "1"), []byte("hello world"), 0700); err != nil { + t.Fatal(err) + } + if err := os.Link(path.Join(origin, "1"), path.Join(origin, "2")); err != nil { + t.Fatal(err) + } + + var i1, i2 uint64 + if i1, err = getNlink(path.Join(origin, "1")); err != nil { + t.Fatal(err) + } + // sanity check that we can hardlink + if i1 != 2 { + t.Skipf("skipping since hardlinks don't work here; expected 2 links, got %d", i1) + } + + dest, err := ioutil.TempDir("", "docker-test-tar-hardlink-dest") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(dest) + + // we'll do this in two steps to separate failure + fh, err := Tar(origin, Uncompressed) + if err != nil { + t.Fatal(err) + } + + // ensure we can read the whole thing with no error, before writing back out + buf, err := ioutil.ReadAll(fh) + if err != nil { + t.Fatal(err) + } + + bRdr := bytes.NewReader(buf) + err = Untar(bRdr, dest, &TarOptions{Compression: Uncompressed}) + if err != nil { + t.Fatal(err) + } + + if i1, err = getInode(path.Join(dest, "1")); err != nil { + t.Fatal(err) + } + if i2, err = getInode(path.Join(dest, "2")); err != nil { + t.Fatal(err) + } + + if i1 != i2 { + t.Errorf("expected matching inodes, but got %d and %d", i1, i2) + } +} + +func getNlink(path string) (uint64, error) { + stat, err := os.Stat(path) + if err != nil { + return 0, err + } + statT, ok := stat.Sys().(*syscall.Stat_t) + if !ok { + return 0, fmt.Errorf("expected type *syscall.Stat_t, got %t", stat.Sys()) + } + // We need this conversion on ARM64 + return uint64(statT.Nlink), nil +} + +func getInode(path string) (uint64, error) { + stat, err := os.Stat(path) + if err != nil { + return 0, err + } + statT, ok := stat.Sys().(*syscall.Stat_t) + if !ok { + return 0, fmt.Errorf("expected type *syscall.Stat_t, got %t", stat.Sys()) + } + return statT.Ino, nil +} + +func prepareUntarSourceDirectory(numberOfFiles int, targetPath string, makeLinks bool) (int, error) { + fileData := []byte("fooo") + for n := 0; n < numberOfFiles; n++ { + fileName := fmt.Sprintf("file-%d", n) + if err := ioutil.WriteFile(path.Join(targetPath, fileName), fileData, 0700); err != nil { + return 0, err + } + if makeLinks { + if err := os.Link(path.Join(targetPath, fileName), path.Join(targetPath, fileName+"-link")); err != nil { + return 0, err + } + } + } + totalSize := numberOfFiles * len(fileData) + return totalSize, nil +} + +func BenchmarkTarUntar(b *testing.B) { + origin, err := ioutil.TempDir("", "docker-test-untar-origin") + if err != nil { + b.Fatal(err) + } + tempDir, err := ioutil.TempDir("", "docker-test-untar-destination") + if err != nil { + b.Fatal(err) + } + target := path.Join(tempDir, "dest") + n, err := prepareUntarSourceDirectory(100, origin, false) + if err != nil { + b.Fatal(err) + } + defer os.RemoveAll(origin) + defer os.RemoveAll(tempDir) + + b.ResetTimer() + b.SetBytes(int64(n)) + for n := 0; n < b.N; n++ { + err := TarUntar(origin, target) + if err != nil { + b.Fatal(err) + } + os.RemoveAll(target) + } +} + +func BenchmarkTarUntarWithLinks(b *testing.B) { + origin, err := ioutil.TempDir("", "docker-test-untar-origin") + if err != nil { + b.Fatal(err) + } + tempDir, err := ioutil.TempDir("", "docker-test-untar-destination") + if err != nil { + b.Fatal(err) + } + target := path.Join(tempDir, "dest") + n, err := prepareUntarSourceDirectory(100, origin, true) + if err != nil { + b.Fatal(err) + } + defer os.RemoveAll(origin) + defer os.RemoveAll(tempDir) + + b.ResetTimer() + b.SetBytes(int64(n)) + for n := 0; n < b.N; n++ { + err := TarUntar(origin, target) + if err != nil { + b.Fatal(err) + } + os.RemoveAll(target) + } +} + +func TestUntarInvalidFilenames(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { + { + Name: "../victim/dotdot", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { + { + // Note the leading slash + Name: "/../victim/slash-dotdot", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("untar", "docker-TestUntarInvalidFilenames", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestUntarHardlinkToSymlink(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { + { + Name: "symlink1", + Typeflag: tar.TypeSymlink, + Linkname: "regfile", + Mode: 0644, + }, + { + Name: "symlink2", + Typeflag: tar.TypeLink, + Linkname: "symlink1", + Mode: 0644, + }, + { + Name: "regfile", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("untar", "docker-TestUntarHardlinkToSymlink", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestUntarInvalidHardlink(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { // try reading victim/hello (../) + { + Name: "dotdot", + Typeflag: tar.TypeLink, + Linkname: "../victim/hello", + Mode: 0644, + }, + }, + { // try reading victim/hello (/../) + { + Name: "slash-dotdot", + Typeflag: tar.TypeLink, + // Note the leading slash + Linkname: "/../victim/hello", + Mode: 0644, + }, + }, + { // try writing victim/file + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim/file", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { // try reading victim/hello (hardlink, symlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "symlink", + Typeflag: tar.TypeSymlink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // Try reading victim/hello (hardlink, hardlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "hardlink", + Typeflag: tar.TypeLink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // Try removing victim directory (hardlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("untar", "docker-TestUntarInvalidHardlink", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestUntarInvalidSymlink(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { // try reading victim/hello (../) + { + Name: "dotdot", + Typeflag: tar.TypeSymlink, + Linkname: "../victim/hello", + Mode: 0644, + }, + }, + { // try reading victim/hello (/../) + { + Name: "slash-dotdot", + Typeflag: tar.TypeSymlink, + // Note the leading slash + Linkname: "/../victim/hello", + Mode: 0644, + }, + }, + { // try writing victim/file + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim/file", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { // try reading victim/hello (symlink, symlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "symlink", + Typeflag: tar.TypeSymlink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // try reading victim/hello (symlink, hardlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "hardlink", + Typeflag: tar.TypeLink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // try removing victim directory (symlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { // try writing to victim/newdir/newfile with a symlink in the path + { + // this header needs to be before the next one, or else there is an error + Name: "dir/loophole", + Typeflag: tar.TypeSymlink, + Linkname: "../../victim", + Mode: 0755, + }, + { + Name: "dir/loophole/newdir/newfile", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("untar", "docker-TestUntarInvalidSymlink", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestTempArchiveCloseMultipleTimes(t *testing.T) { + reader := ioutil.NopCloser(strings.NewReader("hello")) + tempArchive, err := NewTempArchive(reader, "") + buf := make([]byte, 10) + n, err := tempArchive.Read(buf) + if n != 5 { + t.Fatalf("Expected to read 5 bytes. Read %d instead", n) + } + for i := 0; i < 3; i++ { + if err = tempArchive.Close(); err != nil { + t.Fatalf("i=%d. Unexpected error closing temp archive: %v", i, err) + } + } +} diff --git a/pkg/archive/archive_unix.go b/pkg/archive/archive_unix.go new file mode 100644 index 0000000000..51372d52c3 --- /dev/null +++ b/pkg/archive/archive_unix.go @@ -0,0 +1,113 @@ +// +build !windows + +package archive + +import ( + "archive/tar" + "errors" + "os" + "path/filepath" + "syscall" + + "github.com/docker/docker/pkg/system" +) + +// fixVolumePathPrefix does platform specific processing to ensure that if +// the path being passed in is not in a volume path format, convert it to one. +func fixVolumePathPrefix(srcPath string) string { + return srcPath +} + +// getWalkRoot calculates the root path when performing a TarWithOptions. +// We use a seperate function as this is platform specific. On Linux, we +// can't use filepath.Join(srcPath,include) because this will clean away +// a trailing "." or "/" which may be important. +func getWalkRoot(srcPath string, include string) string { + return srcPath + string(filepath.Separator) + include +} + +// CanonicalTarNameForPath returns platform-specific filepath +// to canonical posix-style path for tar archival. p is relative +// path. +func CanonicalTarNameForPath(p string) (string, error) { + return p, nil // already unix-style +} + +// chmodTarEntry is used to adjust the file permissions used in tar header based +// on the platform the archival is done. + +func chmodTarEntry(perm os.FileMode) os.FileMode { + return perm // noop for unix as golang APIs provide perm bits correctly +} + +func setHeaderForSpecialDevice(hdr *tar.Header, ta *tarAppender, name string, stat interface{}) (nlink uint32, inode uint64, err error) { + s, ok := stat.(*syscall.Stat_t) + + if !ok { + err = errors.New("cannot convert stat value to syscall.Stat_t") + return + } + + nlink = uint32(s.Nlink) + inode = uint64(s.Ino) + + // Currently go does not fill in the major/minors + if s.Mode&syscall.S_IFBLK != 0 || + s.Mode&syscall.S_IFCHR != 0 { + hdr.Devmajor = int64(major(uint64(s.Rdev))) + hdr.Devminor = int64(minor(uint64(s.Rdev))) + } + + return +} + +func getFileUIDGID(stat interface{}) (int, int, error) { + s, ok := stat.(*syscall.Stat_t) + + if !ok { + return -1, -1, errors.New("cannot convert stat value to syscall.Stat_t") + } + return int(s.Uid), int(s.Gid), nil +} + +func major(device uint64) uint64 { + return (device >> 8) & 0xfff +} + +func minor(device uint64) uint64 { + return (device & 0xff) | ((device >> 12) & 0xfff00) +} + +// handleTarTypeBlockCharFifo is an OS-specific helper function used by +// createTarFile to handle the following types of header: Block; Char; Fifo +func handleTarTypeBlockCharFifo(hdr *tar.Header, path string) error { + mode := uint32(hdr.Mode & 07777) + switch hdr.Typeflag { + case tar.TypeBlock: + mode |= syscall.S_IFBLK + case tar.TypeChar: + mode |= syscall.S_IFCHR + case tar.TypeFifo: + mode |= syscall.S_IFIFO + } + + if err := system.Mknod(path, mode, int(system.Mkdev(hdr.Devmajor, hdr.Devminor))); err != nil { + return err + } + return nil +} + +func handleLChmod(hdr *tar.Header, path string, hdrInfo os.FileInfo) error { + if hdr.Typeflag == tar.TypeLink { + if fi, err := os.Lstat(hdr.Linkname); err == nil && (fi.Mode()&os.ModeSymlink == 0) { + if err := os.Chmod(path, hdrInfo.Mode()); err != nil { + return err + } + } + } else if hdr.Typeflag != tar.TypeSymlink { + if err := os.Chmod(path, hdrInfo.Mode()); err != nil { + return err + } + } + return nil +} diff --git a/pkg/archive/archive_unix_test.go b/pkg/archive/archive_unix_test.go new file mode 100644 index 0000000000..18f45c480f --- /dev/null +++ b/pkg/archive/archive_unix_test.go @@ -0,0 +1,60 @@ +// +build !windows + +package archive + +import ( + "os" + "testing" +) + +func TestCanonicalTarNameForPath(t *testing.T) { + cases := []struct{ in, expected string }{ + {"foo", "foo"}, + {"foo/bar", "foo/bar"}, + {"foo/dir/", "foo/dir/"}, + } + for _, v := range cases { + if out, err := CanonicalTarNameForPath(v.in); err != nil { + t.Fatalf("cannot get canonical name for path: %s: %v", v.in, err) + } else if out != v.expected { + t.Fatalf("wrong canonical tar name. expected:%s got:%s", v.expected, out) + } + } +} + +func TestCanonicalTarName(t *testing.T) { + cases := []struct { + in string + isDir bool + expected string + }{ + {"foo", false, "foo"}, + {"foo", true, "foo/"}, + {"foo/bar", false, "foo/bar"}, + {"foo/bar", true, "foo/bar/"}, + } + for _, v := range cases { + if out, err := canonicalTarName(v.in, v.isDir); err != nil { + t.Fatalf("cannot get canonical name for path: %s: %v", v.in, err) + } else if out != v.expected { + t.Fatalf("wrong canonical tar name. expected:%s got:%s", v.expected, out) + } + } +} + +func TestChmodTarEntry(t *testing.T) { + cases := []struct { + in, expected os.FileMode + }{ + {0000, 0000}, + {0777, 0777}, + {0644, 0644}, + {0755, 0755}, + {0444, 0444}, + } + for _, v := range cases { + if out := chmodTarEntry(v.in); out != v.expected { + t.Fatalf("wrong chmod. expected:%v got:%v", v.expected, out) + } + } +} diff --git a/pkg/archive/archive_windows.go b/pkg/archive/archive_windows.go new file mode 100644 index 0000000000..f5cc997b90 --- /dev/null +++ b/pkg/archive/archive_windows.go @@ -0,0 +1,70 @@ +// +build windows + +package archive + +import ( + "archive/tar" + "fmt" + "os" + "path/filepath" + "strings" + + "github.com/docker/docker/pkg/longpath" +) + +// fixVolumePathPrefix does platform specific processing to ensure that if +// the path being passed in is not in a volume path format, convert it to one. +func fixVolumePathPrefix(srcPath string) string { + return longpath.AddPrefix(srcPath) +} + +// getWalkRoot calculates the root path when performing a TarWithOptions. +// We use a seperate function as this is platform specific. +func getWalkRoot(srcPath string, include string) string { + return filepath.Join(srcPath, include) +} + +// CanonicalTarNameForPath returns platform-specific filepath +// to canonical posix-style path for tar archival. p is relative +// path. +func CanonicalTarNameForPath(p string) (string, error) { + // windows: convert windows style relative path with backslashes + // into forward slashes. Since windows does not allow '/' or '\' + // in file names, it is mostly safe to replace however we must + // check just in case + if strings.Contains(p, "/") { + return "", fmt.Errorf("Windows path contains forward slash: %s", p) + } + return strings.Replace(p, string(os.PathSeparator), "/", -1), nil + +} + +// chmodTarEntry is used to adjust the file permissions used in tar header based +// on the platform the archival is done. +func chmodTarEntry(perm os.FileMode) os.FileMode { + perm &= 0755 + // Add the x bit: make everything +x from windows + perm |= 0111 + + return perm +} + +func setHeaderForSpecialDevice(hdr *tar.Header, ta *tarAppender, name string, stat interface{}) (nlink uint32, inode uint64, err error) { + // do nothing. no notion of Rdev, Inode, Nlink in stat on Windows + return +} + +// handleTarTypeBlockCharFifo is an OS-specific helper function used by +// createTarFile to handle the following types of header: Block; Char; Fifo +func handleTarTypeBlockCharFifo(hdr *tar.Header, path string) error { + return nil +} + +func handleLChmod(hdr *tar.Header, path string, hdrInfo os.FileInfo) error { + return nil +} + +func getFileUIDGID(stat interface{}) (int, int, error) { + // no notion of file ownership mapping yet on Windows + return 0, 0, nil +} diff --git a/pkg/archive/archive_windows_test.go b/pkg/archive/archive_windows_test.go new file mode 100644 index 0000000000..b7abc40223 --- /dev/null +++ b/pkg/archive/archive_windows_test.go @@ -0,0 +1,87 @@ +// +build windows + +package archive + +import ( + "io/ioutil" + "os" + "path/filepath" + "testing" +) + +func TestCopyFileWithInvalidDest(t *testing.T) { + folder, err := ioutil.TempDir("", "docker-archive-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(folder) + dest := "c:dest" + srcFolder := filepath.Join(folder, "src") + src := filepath.Join(folder, "src", "src") + err = os.MkdirAll(srcFolder, 0740) + if err != nil { + t.Fatal(err) + } + ioutil.WriteFile(src, []byte("content"), 0777) + err = CopyWithTar(src, dest) + if err == nil { + t.Fatalf("archiver.CopyWithTar should throw an error on invalid dest.") + } +} + +func TestCanonicalTarNameForPath(t *testing.T) { + cases := []struct { + in, expected string + shouldFail bool + }{ + {"foo", "foo", false}, + {"foo/bar", "___", true}, // unix-styled windows path must fail + {`foo\bar`, "foo/bar", false}, + } + for _, v := range cases { + if out, err := CanonicalTarNameForPath(v.in); err != nil && !v.shouldFail { + t.Fatalf("cannot get canonical name for path: %s: %v", v.in, err) + } else if v.shouldFail && err == nil { + t.Fatalf("canonical path call should have failed with error. in=%s out=%s", v.in, out) + } else if !v.shouldFail && out != v.expected { + t.Fatalf("wrong canonical tar name. expected:%s got:%s", v.expected, out) + } + } +} + +func TestCanonicalTarName(t *testing.T) { + cases := []struct { + in string + isDir bool + expected string + }{ + {"foo", false, "foo"}, + {"foo", true, "foo/"}, + {`foo\bar`, false, "foo/bar"}, + {`foo\bar`, true, "foo/bar/"}, + } + for _, v := range cases { + if out, err := canonicalTarName(v.in, v.isDir); err != nil { + t.Fatalf("cannot get canonical name for path: %s: %v", v.in, err) + } else if out != v.expected { + t.Fatalf("wrong canonical tar name. expected:%s got:%s", v.expected, out) + } + } +} + +func TestChmodTarEntry(t *testing.T) { + cases := []struct { + in, expected os.FileMode + }{ + {0000, 0111}, + {0777, 0755}, + {0644, 0755}, + {0755, 0755}, + {0444, 0555}, + } + for _, v := range cases { + if out := chmodTarEntry(v.in); out != v.expected { + t.Fatalf("wrong chmod. expected:%v got:%v", v.expected, out) + } + } +} diff --git a/pkg/archive/changes.go b/pkg/archive/changes.go new file mode 100644 index 0000000000..e3003dbd82 --- /dev/null +++ b/pkg/archive/changes.go @@ -0,0 +1,397 @@ +package archive + +import ( + "archive/tar" + "bytes" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "sort" + "strings" + "syscall" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/pools" + "github.com/docker/docker/pkg/system" +) + +// ChangeType represents the change type. +type ChangeType int + +const ( + // ChangeModify represents the modify operation. + ChangeModify = iota + // ChangeAdd represents the add operation. + ChangeAdd + // ChangeDelete represents the delete operation. + ChangeDelete +) + +// Change represents a change, it wraps the change type and path. +// It describes changes of the files in the path respect to the +// parent layers. The change could be modify, add, delete. +// This is used for layer diff. +type Change struct { + Path string + Kind ChangeType +} + +func (change *Change) String() string { + var kind string + switch change.Kind { + case ChangeModify: + kind = "C" + case ChangeAdd: + kind = "A" + case ChangeDelete: + kind = "D" + } + return fmt.Sprintf("%s %s", kind, change.Path) +} + +// for sort.Sort +type changesByPath []Change + +func (c changesByPath) Less(i, j int) bool { return c[i].Path < c[j].Path } +func (c changesByPath) Len() int { return len(c) } +func (c changesByPath) Swap(i, j int) { c[j], c[i] = c[i], c[j] } + +// Gnu tar and the go tar writer don't have sub-second mtime +// precision, which is problematic when we apply changes via tar +// files, we handle this by comparing for exact times, *or* same +// second count and either a or b having exactly 0 nanoseconds +func sameFsTime(a, b time.Time) bool { + return a == b || + (a.Unix() == b.Unix() && + (a.Nanosecond() == 0 || b.Nanosecond() == 0)) +} + +func sameFsTimeSpec(a, b syscall.Timespec) bool { + return a.Sec == b.Sec && + (a.Nsec == b.Nsec || a.Nsec == 0 || b.Nsec == 0) +} + +// Changes walks the path rw and determines changes for the files in the path, +// with respect to the parent layers +func Changes(layers []string, rw string) ([]Change, error) { + var ( + changes []Change + changedDirs = make(map[string]struct{}) + ) + + err := filepath.Walk(rw, func(path string, f os.FileInfo, err error) error { + if err != nil { + return err + } + + // Rebase path + path, err = filepath.Rel(rw, path) + if err != nil { + return err + } + + // As this runs on the daemon side, file paths are OS specific. + path = filepath.Join(string(os.PathSeparator), path) + + // Skip root + if path == string(os.PathSeparator) { + return nil + } + + // Skip AUFS metadata + if matched, err := filepath.Match(string(os.PathSeparator)+WhiteoutMetaPrefix+"*", path); err != nil || matched { + return err + } + + change := Change{ + Path: path, + } + + // Find out what kind of modification happened + file := filepath.Base(path) + // If there is a whiteout, then the file was removed + if strings.HasPrefix(file, WhiteoutPrefix) { + originalFile := file[len(WhiteoutPrefix):] + change.Path = filepath.Join(filepath.Dir(path), originalFile) + change.Kind = ChangeDelete + } else { + // Otherwise, the file was added + change.Kind = ChangeAdd + + // ...Unless it already existed in a top layer, in which case, it's a modification + for _, layer := range layers { + stat, err := os.Stat(filepath.Join(layer, path)) + if err != nil && !os.IsNotExist(err) { + return err + } + if err == nil { + // The file existed in the top layer, so that's a modification + + // However, if it's a directory, maybe it wasn't actually modified. + // If you modify /foo/bar/baz, then /foo will be part of the changed files only because it's the parent of bar + if stat.IsDir() && f.IsDir() { + if f.Size() == stat.Size() && f.Mode() == stat.Mode() && sameFsTime(f.ModTime(), stat.ModTime()) { + // Both directories are the same, don't record the change + return nil + } + } + change.Kind = ChangeModify + break + } + } + } + + // If /foo/bar/file.txt is modified, then /foo/bar must be part of the changed files. + // This block is here to ensure the change is recorded even if the + // modify time, mode and size of the parent directoriy in the rw and ro layers are all equal. + // Check https://github.com/docker/docker/pull/13590 for details. + if f.IsDir() { + changedDirs[path] = struct{}{} + } + if change.Kind == ChangeAdd || change.Kind == ChangeDelete { + parent := filepath.Dir(path) + if _, ok := changedDirs[parent]; !ok && parent != "/" { + changes = append(changes, Change{Path: parent, Kind: ChangeModify}) + changedDirs[parent] = struct{}{} + } + } + + // Record change + changes = append(changes, change) + return nil + }) + if err != nil && !os.IsNotExist(err) { + return nil, err + } + return changes, nil +} + +// FileInfo describes the information of a file. +type FileInfo struct { + parent *FileInfo + name string + stat *system.StatT + children map[string]*FileInfo + capability []byte + added bool +} + +// LookUp looks up the file information of a file. +func (info *FileInfo) LookUp(path string) *FileInfo { + // As this runs on the daemon side, file paths are OS specific. + parent := info + if path == string(os.PathSeparator) { + return info + } + + pathElements := strings.Split(path, string(os.PathSeparator)) + for _, elem := range pathElements { + if elem != "" { + child := parent.children[elem] + if child == nil { + return nil + } + parent = child + } + } + return parent +} + +func (info *FileInfo) path() string { + if info.parent == nil { + // As this runs on the daemon side, file paths are OS specific. + return string(os.PathSeparator) + } + return filepath.Join(info.parent.path(), info.name) +} + +func (info *FileInfo) addChanges(oldInfo *FileInfo, changes *[]Change) { + + sizeAtEntry := len(*changes) + + if oldInfo == nil { + // add + change := Change{ + Path: info.path(), + Kind: ChangeAdd, + } + *changes = append(*changes, change) + info.added = true + } + + // We make a copy so we can modify it to detect additions + // also, we only recurse on the old dir if the new info is a directory + // otherwise any previous delete/change is considered recursive + oldChildren := make(map[string]*FileInfo) + if oldInfo != nil && info.isDir() { + for k, v := range oldInfo.children { + oldChildren[k] = v + } + } + + for name, newChild := range info.children { + oldChild, _ := oldChildren[name] + if oldChild != nil { + // change? + oldStat := oldChild.stat + newStat := newChild.stat + // Note: We can't compare inode or ctime or blocksize here, because these change + // when copying a file into a container. However, that is not generally a problem + // because any content change will change mtime, and any status change should + // be visible when actually comparing the stat fields. The only time this + // breaks down is if some code intentionally hides a change by setting + // back mtime + if statDifferent(oldStat, newStat) || + bytes.Compare(oldChild.capability, newChild.capability) != 0 { + change := Change{ + Path: newChild.path(), + Kind: ChangeModify, + } + *changes = append(*changes, change) + newChild.added = true + } + + // Remove from copy so we can detect deletions + delete(oldChildren, name) + } + + newChild.addChanges(oldChild, changes) + } + for _, oldChild := range oldChildren { + // delete + change := Change{ + Path: oldChild.path(), + Kind: ChangeDelete, + } + *changes = append(*changes, change) + } + + // If there were changes inside this directory, we need to add it, even if the directory + // itself wasn't changed. This is needed to properly save and restore filesystem permissions. + // As this runs on the daemon side, file paths are OS specific. + if len(*changes) > sizeAtEntry && info.isDir() && !info.added && info.path() != string(os.PathSeparator) { + change := Change{ + Path: info.path(), + Kind: ChangeModify, + } + // Let's insert the directory entry before the recently added entries located inside this dir + *changes = append(*changes, change) // just to resize the slice, will be overwritten + copy((*changes)[sizeAtEntry+1:], (*changes)[sizeAtEntry:]) + (*changes)[sizeAtEntry] = change + } + +} + +// Changes add changes to file information. +func (info *FileInfo) Changes(oldInfo *FileInfo) []Change { + var changes []Change + + info.addChanges(oldInfo, &changes) + + return changes +} + +func newRootFileInfo() *FileInfo { + // As this runs on the daemon side, file paths are OS specific. + root := &FileInfo{ + name: string(os.PathSeparator), + children: make(map[string]*FileInfo), + } + return root +} + +// ChangesDirs compares two directories and generates an array of Change objects describing the changes. +// If oldDir is "", then all files in newDir will be Add-Changes. +func ChangesDirs(newDir, oldDir string) ([]Change, error) { + var ( + oldRoot, newRoot *FileInfo + ) + if oldDir == "" { + emptyDir, err := ioutil.TempDir("", "empty") + if err != nil { + return nil, err + } + defer os.Remove(emptyDir) + oldDir = emptyDir + } + oldRoot, newRoot, err := collectFileInfoForChanges(oldDir, newDir) + if err != nil { + return nil, err + } + + return newRoot.Changes(oldRoot), nil +} + +// ChangesSize calculates the size in bytes of the provided changes, based on newDir. +func ChangesSize(newDir string, changes []Change) int64 { + var size int64 + for _, change := range changes { + if change.Kind == ChangeModify || change.Kind == ChangeAdd { + file := filepath.Join(newDir, change.Path) + fileInfo, _ := os.Lstat(file) + if fileInfo != nil && !fileInfo.IsDir() { + size += fileInfo.Size() + } + } + } + return size +} + +// ExportChanges produces an Archive from the provided changes, relative to dir. +func ExportChanges(dir string, changes []Change, uidMaps, gidMaps []idtools.IDMap) (Archive, error) { + reader, writer := io.Pipe() + go func() { + ta := &tarAppender{ + TarWriter: tar.NewWriter(writer), + Buffer: pools.BufioWriter32KPool.Get(nil), + SeenFiles: make(map[uint64]string), + UIDMaps: uidMaps, + GIDMaps: gidMaps, + } + // this buffer is needed for the duration of this piped stream + defer pools.BufioWriter32KPool.Put(ta.Buffer) + + sort.Sort(changesByPath(changes)) + + // In general we log errors here but ignore them because + // during e.g. a diff operation the container can continue + // mutating the filesystem and we can see transient errors + // from this + for _, change := range changes { + if change.Kind == ChangeDelete { + whiteOutDir := filepath.Dir(change.Path) + whiteOutBase := filepath.Base(change.Path) + whiteOut := filepath.Join(whiteOutDir, WhiteoutPrefix+whiteOutBase) + timestamp := time.Now() + hdr := &tar.Header{ + Name: whiteOut[1:], + Size: 0, + ModTime: timestamp, + AccessTime: timestamp, + ChangeTime: timestamp, + } + if err := ta.TarWriter.WriteHeader(hdr); err != nil { + logrus.Debugf("Can't write whiteout header: %s", err) + } + } else { + path := filepath.Join(dir, change.Path) + if err := ta.addTarFile(path, change.Path[1:]); err != nil { + logrus.Debugf("Can't add file %s to tar: %s", path, err) + } + } + } + + // Make sure to check the error on Close. + if err := ta.TarWriter.Close(); err != nil { + logrus.Debugf("Can't close layer: %s", err) + } + if err := writer.Close(); err != nil { + logrus.Debugf("failed close Changes writer: %s", err) + } + }() + return reader, nil +} diff --git a/pkg/archive/changes_linux.go b/pkg/archive/changes_linux.go new file mode 100644 index 0000000000..dee8b7c604 --- /dev/null +++ b/pkg/archive/changes_linux.go @@ -0,0 +1,285 @@ +package archive + +import ( + "bytes" + "fmt" + "os" + "path/filepath" + "sort" + "syscall" + "unsafe" + + "github.com/docker/docker/pkg/system" +) + +// walker is used to implement collectFileInfoForChanges on linux. Where this +// method in general returns the entire contents of two directory trees, we +// optimize some FS calls out on linux. In particular, we take advantage of the +// fact that getdents(2) returns the inode of each file in the directory being +// walked, which, when walking two trees in parallel to generate a list of +// changes, can be used to prune subtrees without ever having to lstat(2) them +// directly. Eliminating stat calls in this way can save up to seconds on large +// images. +type walker struct { + dir1 string + dir2 string + root1 *FileInfo + root2 *FileInfo +} + +// collectFileInfoForChanges returns a complete representation of the trees +// rooted at dir1 and dir2, with one important exception: any subtree or +// leaf where the inode and device numbers are an exact match between dir1 +// and dir2 will be pruned from the results. This method is *only* to be used +// to generating a list of changes between the two directories, as it does not +// reflect the full contents. +func collectFileInfoForChanges(dir1, dir2 string) (*FileInfo, *FileInfo, error) { + w := &walker{ + dir1: dir1, + dir2: dir2, + root1: newRootFileInfo(), + root2: newRootFileInfo(), + } + + i1, err := os.Lstat(w.dir1) + if err != nil { + return nil, nil, err + } + i2, err := os.Lstat(w.dir2) + if err != nil { + return nil, nil, err + } + + if err := w.walk("/", i1, i2); err != nil { + return nil, nil, err + } + + return w.root1, w.root2, nil +} + +// Given a FileInfo, its path info, and a reference to the root of the tree +// being constructed, register this file with the tree. +func walkchunk(path string, fi os.FileInfo, dir string, root *FileInfo) error { + if fi == nil { + return nil + } + parent := root.LookUp(filepath.Dir(path)) + if parent == nil { + return fmt.Errorf("collectFileInfoForChanges: Unexpectedly no parent for %s", path) + } + info := &FileInfo{ + name: filepath.Base(path), + children: make(map[string]*FileInfo), + parent: parent, + } + cpath := filepath.Join(dir, path) + stat, err := system.FromStatT(fi.Sys().(*syscall.Stat_t)) + if err != nil { + return err + } + info.stat = stat + info.capability, _ = system.Lgetxattr(cpath, "security.capability") // lgetxattr(2): fs access + parent.children[info.name] = info + return nil +} + +// Walk a subtree rooted at the same path in both trees being iterated. For +// example, /docker/overlay/1234/a/b/c/d and /docker/overlay/8888/a/b/c/d +func (w *walker) walk(path string, i1, i2 os.FileInfo) (err error) { + // Register these nodes with the return trees, unless we're still at the + // (already-created) roots: + if path != "/" { + if err := walkchunk(path, i1, w.dir1, w.root1); err != nil { + return err + } + if err := walkchunk(path, i2, w.dir2, w.root2); err != nil { + return err + } + } + + is1Dir := i1 != nil && i1.IsDir() + is2Dir := i2 != nil && i2.IsDir() + + sameDevice := false + if i1 != nil && i2 != nil { + si1 := i1.Sys().(*syscall.Stat_t) + si2 := i2.Sys().(*syscall.Stat_t) + if si1.Dev == si2.Dev { + sameDevice = true + } + } + + // If these files are both non-existent, or leaves (non-dirs), we are done. + if !is1Dir && !is2Dir { + return nil + } + + // Fetch the names of all the files contained in both directories being walked: + var names1, names2 []nameIno + if is1Dir { + names1, err = readdirnames(filepath.Join(w.dir1, path)) // getdents(2): fs access + if err != nil { + return err + } + } + if is2Dir { + names2, err = readdirnames(filepath.Join(w.dir2, path)) // getdents(2): fs access + if err != nil { + return err + } + } + + // We have lists of the files contained in both parallel directories, sorted + // in the same order. Walk them in parallel, generating a unique merged list + // of all items present in either or both directories. + var names []string + ix1 := 0 + ix2 := 0 + + for { + if ix1 >= len(names1) { + break + } + if ix2 >= len(names2) { + break + } + + ni1 := names1[ix1] + ni2 := names2[ix2] + + switch bytes.Compare([]byte(ni1.name), []byte(ni2.name)) { + case -1: // ni1 < ni2 -- advance ni1 + // we will not encounter ni1 in names2 + names = append(names, ni1.name) + ix1++ + case 0: // ni1 == ni2 + if ni1.ino != ni2.ino || !sameDevice { + names = append(names, ni1.name) + } + ix1++ + ix2++ + case 1: // ni1 > ni2 -- advance ni2 + // we will not encounter ni2 in names1 + names = append(names, ni2.name) + ix2++ + } + } + for ix1 < len(names1) { + names = append(names, names1[ix1].name) + ix1++ + } + for ix2 < len(names2) { + names = append(names, names2[ix2].name) + ix2++ + } + + // For each of the names present in either or both of the directories being + // iterated, stat the name under each root, and recurse the pair of them: + for _, name := range names { + fname := filepath.Join(path, name) + var cInfo1, cInfo2 os.FileInfo + if is1Dir { + cInfo1, err = os.Lstat(filepath.Join(w.dir1, fname)) // lstat(2): fs access + if err != nil && !os.IsNotExist(err) { + return err + } + } + if is2Dir { + cInfo2, err = os.Lstat(filepath.Join(w.dir2, fname)) // lstat(2): fs access + if err != nil && !os.IsNotExist(err) { + return err + } + } + if err = w.walk(fname, cInfo1, cInfo2); err != nil { + return err + } + } + return nil +} + +// {name,inode} pairs used to support the early-pruning logic of the walker type +type nameIno struct { + name string + ino uint64 +} + +type nameInoSlice []nameIno + +func (s nameInoSlice) Len() int { return len(s) } +func (s nameInoSlice) Swap(i, j int) { s[i], s[j] = s[j], s[i] } +func (s nameInoSlice) Less(i, j int) bool { return s[i].name < s[j].name } + +// readdirnames is a hacked-apart version of the Go stdlib code, exposing inode +// numbers further up the stack when reading directory contents. Unlike +// os.Readdirnames, which returns a list of filenames, this function returns a +// list of {filename,inode} pairs. +func readdirnames(dirname string) (names []nameIno, err error) { + var ( + size = 100 + buf = make([]byte, 4096) + nbuf int + bufp int + nb int + ) + + f, err := os.Open(dirname) + if err != nil { + return nil, err + } + defer f.Close() + + names = make([]nameIno, 0, size) // Empty with room to grow. + for { + // Refill the buffer if necessary + if bufp >= nbuf { + bufp = 0 + nbuf, err = syscall.ReadDirent(int(f.Fd()), buf) // getdents on linux + if nbuf < 0 { + nbuf = 0 + } + if err != nil { + return nil, os.NewSyscallError("readdirent", err) + } + if nbuf <= 0 { + break // EOF + } + } + + // Drain the buffer + nb, names = parseDirent(buf[bufp:nbuf], names) + bufp += nb + } + + sl := nameInoSlice(names) + sort.Sort(sl) + return sl, nil +} + +// parseDirent is a minor modification of syscall.ParseDirent (linux version) +// which returns {name,inode} pairs instead of just names. +func parseDirent(buf []byte, names []nameIno) (consumed int, newnames []nameIno) { + origlen := len(buf) + for len(buf) > 0 { + dirent := (*syscall.Dirent)(unsafe.Pointer(&buf[0])) + buf = buf[dirent.Reclen:] + if dirent.Ino == 0 { // File absent in directory. + continue + } + bytes := (*[10000]byte)(unsafe.Pointer(&dirent.Name[0])) + var name = string(bytes[0:clen(bytes[:])]) + if name == "." || name == ".." { // Useless names + continue + } + names = append(names, nameIno{name, dirent.Ino}) + } + return origlen - len(buf), names +} + +func clen(n []byte) int { + for i := 0; i < len(n); i++ { + if n[i] == 0 { + return i + } + } + return len(n) +} diff --git a/pkg/archive/changes_other.go b/pkg/archive/changes_other.go new file mode 100644 index 0000000000..da70ed37c4 --- /dev/null +++ b/pkg/archive/changes_other.go @@ -0,0 +1,97 @@ +// +build !linux + +package archive + +import ( + "fmt" + "os" + "path/filepath" + "runtime" + "strings" + + "github.com/docker/docker/pkg/system" +) + +func collectFileInfoForChanges(oldDir, newDir string) (*FileInfo, *FileInfo, error) { + var ( + oldRoot, newRoot *FileInfo + err1, err2 error + errs = make(chan error, 2) + ) + go func() { + oldRoot, err1 = collectFileInfo(oldDir) + errs <- err1 + }() + go func() { + newRoot, err2 = collectFileInfo(newDir) + errs <- err2 + }() + + // block until both routines have returned + for i := 0; i < 2; i++ { + if err := <-errs; err != nil { + return nil, nil, err + } + } + + return oldRoot, newRoot, nil +} + +func collectFileInfo(sourceDir string) (*FileInfo, error) { + root := newRootFileInfo() + + err := filepath.Walk(sourceDir, func(path string, f os.FileInfo, err error) error { + if err != nil { + return err + } + + // Rebase path + relPath, err := filepath.Rel(sourceDir, path) + if err != nil { + return err + } + + // As this runs on the daemon side, file paths are OS specific. + relPath = filepath.Join(string(os.PathSeparator), relPath) + + // See https://github.com/golang/go/issues/9168 - bug in filepath.Join. + // Temporary workaround. If the returned path starts with two backslashes, + // trim it down to a single backslash. Only relevant on Windows. + if runtime.GOOS == "windows" { + if strings.HasPrefix(relPath, `\\`) { + relPath = relPath[1:] + } + } + + if relPath == string(os.PathSeparator) { + return nil + } + + parent := root.LookUp(filepath.Dir(relPath)) + if parent == nil { + return fmt.Errorf("collectFileInfo: Unexpectedly no parent for %s", relPath) + } + + info := &FileInfo{ + name: filepath.Base(relPath), + children: make(map[string]*FileInfo), + parent: parent, + } + + s, err := system.Lstat(path) + if err != nil { + return err + } + info.stat = s + + info.capability, _ = system.Lgetxattr(path, "security.capability") + + parent.children[info.name] = info + + return nil + }) + if err != nil { + return nil, err + } + return root, nil +} diff --git a/pkg/archive/changes_posix_test.go b/pkg/archive/changes_posix_test.go new file mode 100644 index 0000000000..5a3282b5a8 --- /dev/null +++ b/pkg/archive/changes_posix_test.go @@ -0,0 +1,127 @@ +package archive + +import ( + "archive/tar" + "fmt" + "io" + "io/ioutil" + "os" + "path" + "sort" + "testing" +) + +func TestHardLinkOrder(t *testing.T) { + names := []string{"file1.txt", "file2.txt", "file3.txt"} + msg := []byte("Hey y'all") + + // Create dir + src, err := ioutil.TempDir("", "docker-hardlink-test-src-") + if err != nil { + t.Fatal(err) + } + //defer os.RemoveAll(src) + for _, name := range names { + func() { + fh, err := os.Create(path.Join(src, name)) + if err != nil { + t.Fatal(err) + } + defer fh.Close() + if _, err = fh.Write(msg); err != nil { + t.Fatal(err) + } + }() + } + // Create dest, with changes that includes hardlinks + dest, err := ioutil.TempDir("", "docker-hardlink-test-dest-") + if err != nil { + t.Fatal(err) + } + os.RemoveAll(dest) // we just want the name, at first + if err := copyDir(src, dest); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(dest) + for _, name := range names { + for i := 0; i < 5; i++ { + if err := os.Link(path.Join(dest, name), path.Join(dest, fmt.Sprintf("%s.link%d", name, i))); err != nil { + t.Fatal(err) + } + } + } + + // get changes + changes, err := ChangesDirs(dest, src) + if err != nil { + t.Fatal(err) + } + + // sort + sort.Sort(changesByPath(changes)) + + // ExportChanges + ar, err := ExportChanges(dest, changes, nil, nil) + if err != nil { + t.Fatal(err) + } + hdrs, err := walkHeaders(ar) + if err != nil { + t.Fatal(err) + } + + // reverse sort + sort.Sort(sort.Reverse(changesByPath(changes))) + // ExportChanges + arRev, err := ExportChanges(dest, changes, nil, nil) + if err != nil { + t.Fatal(err) + } + hdrsRev, err := walkHeaders(arRev) + if err != nil { + t.Fatal(err) + } + + // line up the two sets + sort.Sort(tarHeaders(hdrs)) + sort.Sort(tarHeaders(hdrsRev)) + + // compare Size and LinkName + for i := range hdrs { + if hdrs[i].Name != hdrsRev[i].Name { + t.Errorf("headers - expected name %q; but got %q", hdrs[i].Name, hdrsRev[i].Name) + } + if hdrs[i].Size != hdrsRev[i].Size { + t.Errorf("headers - %q expected size %d; but got %d", hdrs[i].Name, hdrs[i].Size, hdrsRev[i].Size) + } + if hdrs[i].Typeflag != hdrsRev[i].Typeflag { + t.Errorf("headers - %q expected type %d; but got %d", hdrs[i].Name, hdrs[i].Typeflag, hdrsRev[i].Typeflag) + } + if hdrs[i].Linkname != hdrsRev[i].Linkname { + t.Errorf("headers - %q expected linkname %q; but got %q", hdrs[i].Name, hdrs[i].Linkname, hdrsRev[i].Linkname) + } + } + +} + +type tarHeaders []tar.Header + +func (th tarHeaders) Len() int { return len(th) } +func (th tarHeaders) Swap(i, j int) { th[j], th[i] = th[i], th[j] } +func (th tarHeaders) Less(i, j int) bool { return th[i].Name < th[j].Name } + +func walkHeaders(r io.Reader) ([]tar.Header, error) { + t := tar.NewReader(r) + headers := []tar.Header{} + for { + hdr, err := t.Next() + if err != nil { + if err == io.EOF { + break + } + return headers, err + } + headers = append(headers, *hdr) + } + return headers, nil +} diff --git a/pkg/archive/changes_test.go b/pkg/archive/changes_test.go new file mode 100644 index 0000000000..afbb0b9757 --- /dev/null +++ b/pkg/archive/changes_test.go @@ -0,0 +1,495 @@ +package archive + +import ( + "io/ioutil" + "os" + "os/exec" + "path" + "sort" + "testing" + "time" +) + +func max(x, y int) int { + if x >= y { + return x + } + return y +} + +func copyDir(src, dst string) error { + cmd := exec.Command("cp", "-a", src, dst) + if err := cmd.Run(); err != nil { + return err + } + return nil +} + +type FileType uint32 + +const ( + Regular FileType = iota + Dir + Symlink +) + +type FileData struct { + filetype FileType + path string + contents string + permissions os.FileMode +} + +func createSampleDir(t *testing.T, root string) { + files := []FileData{ + {Regular, "file1", "file1\n", 0600}, + {Regular, "file2", "file2\n", 0666}, + {Regular, "file3", "file3\n", 0404}, + {Regular, "file4", "file4\n", 0600}, + {Regular, "file5", "file5\n", 0600}, + {Regular, "file6", "file6\n", 0600}, + {Regular, "file7", "file7\n", 0600}, + {Dir, "dir1", "", 0740}, + {Regular, "dir1/file1-1", "file1-1\n", 01444}, + {Regular, "dir1/file1-2", "file1-2\n", 0666}, + {Dir, "dir2", "", 0700}, + {Regular, "dir2/file2-1", "file2-1\n", 0666}, + {Regular, "dir2/file2-2", "file2-2\n", 0666}, + {Dir, "dir3", "", 0700}, + {Regular, "dir3/file3-1", "file3-1\n", 0666}, + {Regular, "dir3/file3-2", "file3-2\n", 0666}, + {Dir, "dir4", "", 0700}, + {Regular, "dir4/file3-1", "file4-1\n", 0666}, + {Regular, "dir4/file3-2", "file4-2\n", 0666}, + {Symlink, "symlink1", "target1", 0666}, + {Symlink, "symlink2", "target2", 0666}, + } + + now := time.Now() + for _, info := range files { + p := path.Join(root, info.path) + if info.filetype == Dir { + if err := os.MkdirAll(p, info.permissions); err != nil { + t.Fatal(err) + } + } else if info.filetype == Regular { + if err := ioutil.WriteFile(p, []byte(info.contents), info.permissions); err != nil { + t.Fatal(err) + } + } else if info.filetype == Symlink { + if err := os.Symlink(info.contents, p); err != nil { + t.Fatal(err) + } + } + + if info.filetype != Symlink { + // Set a consistent ctime, atime for all files and dirs + if err := os.Chtimes(p, now, now); err != nil { + t.Fatal(err) + } + } + } +} + +func TestChangeString(t *testing.T) { + modifiyChange := Change{"change", ChangeModify} + toString := modifiyChange.String() + if toString != "C change" { + t.Fatalf("String() of a change with ChangeModifiy Kind should have been %s but was %s", "C change", toString) + } + addChange := Change{"change", ChangeAdd} + toString = addChange.String() + if toString != "A change" { + t.Fatalf("String() of a change with ChangeAdd Kind should have been %s but was %s", "A change", toString) + } + deleteChange := Change{"change", ChangeDelete} + toString = deleteChange.String() + if toString != "D change" { + t.Fatalf("String() of a change with ChangeDelete Kind should have been %s but was %s", "D change", toString) + } +} + +func TestChangesWithNoChanges(t *testing.T) { + rwLayer, err := ioutil.TempDir("", "docker-changes-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(rwLayer) + layer, err := ioutil.TempDir("", "docker-changes-test-layer") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(layer) + createSampleDir(t, layer) + changes, err := Changes([]string{layer}, rwLayer) + if err != nil { + t.Fatal(err) + } + if len(changes) != 0 { + t.Fatalf("Changes with no difference should have detect no changes, but detected %d", len(changes)) + } +} + +func TestChangesWithChanges(t *testing.T) { + // Mock the readonly layer + layer, err := ioutil.TempDir("", "docker-changes-test-layer") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(layer) + createSampleDir(t, layer) + os.MkdirAll(path.Join(layer, "dir1/subfolder"), 0740) + + // Mock the RW layer + rwLayer, err := ioutil.TempDir("", "docker-changes-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(rwLayer) + + // Create a folder in RW layer + dir1 := path.Join(rwLayer, "dir1") + os.MkdirAll(dir1, 0740) + deletedFile := path.Join(dir1, ".wh.file1-2") + ioutil.WriteFile(deletedFile, []byte{}, 0600) + modifiedFile := path.Join(dir1, "file1-1") + ioutil.WriteFile(modifiedFile, []byte{0x00}, 01444) + // Let's add a subfolder for a newFile + subfolder := path.Join(dir1, "subfolder") + os.MkdirAll(subfolder, 0740) + newFile := path.Join(subfolder, "newFile") + ioutil.WriteFile(newFile, []byte{}, 0740) + + changes, err := Changes([]string{layer}, rwLayer) + if err != nil { + t.Fatal(err) + } + + expectedChanges := []Change{ + {"/dir1", ChangeModify}, + {"/dir1/file1-1", ChangeModify}, + {"/dir1/file1-2", ChangeDelete}, + {"/dir1/subfolder", ChangeModify}, + {"/dir1/subfolder/newFile", ChangeAdd}, + } + checkChanges(expectedChanges, changes, t) +} + +// See https://github.com/docker/docker/pull/13590 +func TestChangesWithChangesGH13590(t *testing.T) { + baseLayer, err := ioutil.TempDir("", "docker-changes-test.") + defer os.RemoveAll(baseLayer) + + dir3 := path.Join(baseLayer, "dir1/dir2/dir3") + os.MkdirAll(dir3, 07400) + + file := path.Join(dir3, "file.txt") + ioutil.WriteFile(file, []byte("hello"), 0666) + + layer, err := ioutil.TempDir("", "docker-changes-test2.") + defer os.RemoveAll(layer) + + // Test creating a new file + if err := copyDir(baseLayer+"/dir1", layer+"/"); err != nil { + t.Fatalf("Cmd failed: %q", err) + } + + os.Remove(path.Join(layer, "dir1/dir2/dir3/file.txt")) + file = path.Join(layer, "dir1/dir2/dir3/file1.txt") + ioutil.WriteFile(file, []byte("bye"), 0666) + + changes, err := Changes([]string{baseLayer}, layer) + if err != nil { + t.Fatal(err) + } + + expectedChanges := []Change{ + {"/dir1/dir2/dir3", ChangeModify}, + {"/dir1/dir2/dir3/file1.txt", ChangeAdd}, + } + checkChanges(expectedChanges, changes, t) + + // Now test changing a file + layer, err = ioutil.TempDir("", "docker-changes-test3.") + defer os.RemoveAll(layer) + + if err := copyDir(baseLayer+"/dir1", layer+"/"); err != nil { + t.Fatalf("Cmd failed: %q", err) + } + + file = path.Join(layer, "dir1/dir2/dir3/file.txt") + ioutil.WriteFile(file, []byte("bye"), 0666) + + changes, err = Changes([]string{baseLayer}, layer) + if err != nil { + t.Fatal(err) + } + + expectedChanges = []Change{ + {"/dir1/dir2/dir3/file.txt", ChangeModify}, + } + checkChanges(expectedChanges, changes, t) +} + +// Create an directory, copy it, make sure we report no changes between the two +func TestChangesDirsEmpty(t *testing.T) { + src, err := ioutil.TempDir("", "docker-changes-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(src) + createSampleDir(t, src) + dst := src + "-copy" + if err := copyDir(src, dst); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(dst) + changes, err := ChangesDirs(dst, src) + if err != nil { + t.Fatal(err) + } + + if len(changes) != 0 { + t.Fatalf("Reported changes for identical dirs: %v", changes) + } + os.RemoveAll(src) + os.RemoveAll(dst) +} + +func mutateSampleDir(t *testing.T, root string) { + // Remove a regular file + if err := os.RemoveAll(path.Join(root, "file1")); err != nil { + t.Fatal(err) + } + + // Remove a directory + if err := os.RemoveAll(path.Join(root, "dir1")); err != nil { + t.Fatal(err) + } + + // Remove a symlink + if err := os.RemoveAll(path.Join(root, "symlink1")); err != nil { + t.Fatal(err) + } + + // Rewrite a file + if err := ioutil.WriteFile(path.Join(root, "file2"), []byte("fileNN\n"), 0777); err != nil { + t.Fatal(err) + } + + // Replace a file + if err := os.RemoveAll(path.Join(root, "file3")); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(root, "file3"), []byte("fileMM\n"), 0404); err != nil { + t.Fatal(err) + } + + // Touch file + if err := os.Chtimes(path.Join(root, "file4"), time.Now().Add(time.Second), time.Now().Add(time.Second)); err != nil { + t.Fatal(err) + } + + // Replace file with dir + if err := os.RemoveAll(path.Join(root, "file5")); err != nil { + t.Fatal(err) + } + if err := os.MkdirAll(path.Join(root, "file5"), 0666); err != nil { + t.Fatal(err) + } + + // Create new file + if err := ioutil.WriteFile(path.Join(root, "filenew"), []byte("filenew\n"), 0777); err != nil { + t.Fatal(err) + } + + // Create new dir + if err := os.MkdirAll(path.Join(root, "dirnew"), 0766); err != nil { + t.Fatal(err) + } + + // Create a new symlink + if err := os.Symlink("targetnew", path.Join(root, "symlinknew")); err != nil { + t.Fatal(err) + } + + // Change a symlink + if err := os.RemoveAll(path.Join(root, "symlink2")); err != nil { + t.Fatal(err) + } + if err := os.Symlink("target2change", path.Join(root, "symlink2")); err != nil { + t.Fatal(err) + } + + // Replace dir with file + if err := os.RemoveAll(path.Join(root, "dir2")); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(path.Join(root, "dir2"), []byte("dir2\n"), 0777); err != nil { + t.Fatal(err) + } + + // Touch dir + if err := os.Chtimes(path.Join(root, "dir3"), time.Now().Add(time.Second), time.Now().Add(time.Second)); err != nil { + t.Fatal(err) + } +} + +func TestChangesDirsMutated(t *testing.T) { + src, err := ioutil.TempDir("", "docker-changes-test") + if err != nil { + t.Fatal(err) + } + createSampleDir(t, src) + dst := src + "-copy" + if err := copyDir(src, dst); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(src) + defer os.RemoveAll(dst) + + mutateSampleDir(t, dst) + + changes, err := ChangesDirs(dst, src) + if err != nil { + t.Fatal(err) + } + + sort.Sort(changesByPath(changes)) + + expectedChanges := []Change{ + {"/dir1", ChangeDelete}, + {"/dir2", ChangeModify}, + {"/dirnew", ChangeAdd}, + {"/file1", ChangeDelete}, + {"/file2", ChangeModify}, + {"/file3", ChangeModify}, + {"/file4", ChangeModify}, + {"/file5", ChangeModify}, + {"/filenew", ChangeAdd}, + {"/symlink1", ChangeDelete}, + {"/symlink2", ChangeModify}, + {"/symlinknew", ChangeAdd}, + } + + for i := 0; i < max(len(changes), len(expectedChanges)); i++ { + if i >= len(expectedChanges) { + t.Fatalf("unexpected change %s\n", changes[i].String()) + } + if i >= len(changes) { + t.Fatalf("no change for expected change %s\n", expectedChanges[i].String()) + } + if changes[i].Path == expectedChanges[i].Path { + if changes[i] != expectedChanges[i] { + t.Fatalf("Wrong change for %s, expected %s, got %s\n", changes[i].Path, changes[i].String(), expectedChanges[i].String()) + } + } else if changes[i].Path < expectedChanges[i].Path { + t.Fatalf("unexpected change %s\n", changes[i].String()) + } else { + t.Fatalf("no change for expected change %s != %s\n", expectedChanges[i].String(), changes[i].String()) + } + } +} + +func TestApplyLayer(t *testing.T) { + src, err := ioutil.TempDir("", "docker-changes-test") + if err != nil { + t.Fatal(err) + } + createSampleDir(t, src) + defer os.RemoveAll(src) + dst := src + "-copy" + if err := copyDir(src, dst); err != nil { + t.Fatal(err) + } + mutateSampleDir(t, dst) + defer os.RemoveAll(dst) + + changes, err := ChangesDirs(dst, src) + if err != nil { + t.Fatal(err) + } + + layer, err := ExportChanges(dst, changes, nil, nil) + if err != nil { + t.Fatal(err) + } + + layerCopy, err := NewTempArchive(layer, "") + if err != nil { + t.Fatal(err) + } + + if _, err := ApplyLayer(src, layerCopy); err != nil { + t.Fatal(err) + } + + changes2, err := ChangesDirs(src, dst) + if err != nil { + t.Fatal(err) + } + + if len(changes2) != 0 { + t.Fatalf("Unexpected differences after reapplying mutation: %v", changes2) + } +} + +func TestChangesSizeWithNoChanges(t *testing.T) { + size := ChangesSize("/tmp", nil) + if size != 0 { + t.Fatalf("ChangesSizes with no changes should be 0, was %d", size) + } +} + +func TestChangesSizeWithOnlyDeleteChanges(t *testing.T) { + changes := []Change{ + {Path: "deletedPath", Kind: ChangeDelete}, + } + size := ChangesSize("/tmp", changes) + if size != 0 { + t.Fatalf("ChangesSizes with only delete changes should be 0, was %d", size) + } +} + +func TestChangesSize(t *testing.T) { + parentPath, err := ioutil.TempDir("", "docker-changes-test") + defer os.RemoveAll(parentPath) + addition := path.Join(parentPath, "addition") + if err := ioutil.WriteFile(addition, []byte{0x01, 0x01, 0x01}, 0744); err != nil { + t.Fatal(err) + } + modification := path.Join(parentPath, "modification") + if err = ioutil.WriteFile(modification, []byte{0x01, 0x01, 0x01}, 0744); err != nil { + t.Fatal(err) + } + changes := []Change{ + {Path: "addition", Kind: ChangeAdd}, + {Path: "modification", Kind: ChangeModify}, + } + size := ChangesSize(parentPath, changes) + if size != 6 { + t.Fatalf("ChangesSizes with only delete changes should be 0, was %d", size) + } +} + +func checkChanges(expectedChanges, changes []Change, t *testing.T) { + sort.Sort(changesByPath(expectedChanges)) + sort.Sort(changesByPath(changes)) + for i := 0; i < max(len(changes), len(expectedChanges)); i++ { + if i >= len(expectedChanges) { + t.Fatalf("unexpected change %s\n", changes[i].String()) + } + if i >= len(changes) { + t.Fatalf("no change for expected change %s\n", expectedChanges[i].String()) + } + if changes[i].Path == expectedChanges[i].Path { + if changes[i] != expectedChanges[i] { + t.Fatalf("Wrong change for %s, expected %s, got %s\n", changes[i].Path, changes[i].String(), expectedChanges[i].String()) + } + } else if changes[i].Path < expectedChanges[i].Path { + t.Fatalf("unexpected change %s\n", changes[i].String()) + } else { + t.Fatalf("no change for expected change %s != %s\n", expectedChanges[i].String(), changes[i].String()) + } + } +} diff --git a/pkg/archive/changes_unix.go b/pkg/archive/changes_unix.go new file mode 100644 index 0000000000..05f109afac --- /dev/null +++ b/pkg/archive/changes_unix.go @@ -0,0 +1,27 @@ +// +build !windows + +package archive + +import ( + "syscall" + + "github.com/docker/docker/pkg/system" +) + +func statDifferent(oldStat *system.StatT, newStat *system.StatT) bool { + // Don't look at size for dirs, its not a good measure of change + if oldStat.Mode() != newStat.Mode() || + oldStat.UID() != newStat.UID() || + oldStat.GID() != newStat.GID() || + oldStat.Rdev() != newStat.Rdev() || + // Don't look at size for dirs, its not a good measure of change + (oldStat.Mode()&syscall.S_IFDIR != syscall.S_IFDIR && + (!sameFsTimeSpec(oldStat.Mtim(), newStat.Mtim()) || (oldStat.Size() != newStat.Size()))) { + return true + } + return false +} + +func (info *FileInfo) isDir() bool { + return info.parent == nil || info.stat.Mode()&syscall.S_IFDIR != 0 +} diff --git a/pkg/archive/changes_windows.go b/pkg/archive/changes_windows.go new file mode 100644 index 0000000000..135db369e5 --- /dev/null +++ b/pkg/archive/changes_windows.go @@ -0,0 +1,20 @@ +package archive + +import ( + "github.com/docker/docker/pkg/system" +) + +func statDifferent(oldStat *system.StatT, newStat *system.StatT) bool { + + // Don't look at size for dirs, its not a good measure of change + if oldStat.ModTime() != newStat.ModTime() || + oldStat.Mode() != newStat.Mode() || + oldStat.Size() != newStat.Size() && !oldStat.IsDir() { + return true + } + return false +} + +func (info *FileInfo) isDir() bool { + return info.parent == nil || info.stat.IsDir() +} diff --git a/pkg/archive/copy.go b/pkg/archive/copy.go new file mode 100644 index 0000000000..ecfd0a9c69 --- /dev/null +++ b/pkg/archive/copy.go @@ -0,0 +1,407 @@ +package archive + +import ( + "archive/tar" + "errors" + "io" + "io/ioutil" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/system" +) + +// Errors used or returned by this file. +var ( + ErrNotDirectory = errors.New("not a directory") + ErrDirNotExists = errors.New("no such directory") + ErrCannotCopyDir = errors.New("cannot copy directory") + ErrInvalidCopySource = errors.New("invalid copy source content") +) + +// PreserveTrailingDotOrSeparator returns the given cleaned path (after +// processing using any utility functions from the path or filepath stdlib +// packages) and appends a trailing `/.` or `/` if its corresponding original +// path (from before being processed by utility functions from the path or +// filepath stdlib packages) ends with a trailing `/.` or `/`. If the cleaned +// path already ends in a `.` path segment, then another is not added. If the +// clean path already ends in a path separator, then another is not added. +func PreserveTrailingDotOrSeparator(cleanedPath, originalPath string) string { + // Ensure paths are in platform semantics + cleanedPath = normalizePath(cleanedPath) + originalPath = normalizePath(originalPath) + + if !specifiesCurrentDir(cleanedPath) && specifiesCurrentDir(originalPath) { + if !hasTrailingPathSeparator(cleanedPath) { + // Add a separator if it doesn't already end with one (a cleaned + // path would only end in a separator if it is the root). + cleanedPath += string(filepath.Separator) + } + cleanedPath += "." + } + + if !hasTrailingPathSeparator(cleanedPath) && hasTrailingPathSeparator(originalPath) { + cleanedPath += string(filepath.Separator) + } + + return cleanedPath +} + +// assertsDirectory returns whether the given path is +// asserted to be a directory, i.e., the path ends with +// a trailing '/' or `/.`, assuming a path separator of `/`. +func assertsDirectory(path string) bool { + return hasTrailingPathSeparator(path) || specifiesCurrentDir(path) +} + +// hasTrailingPathSeparator returns whether the given +// path ends with the system's path separator character. +func hasTrailingPathSeparator(path string) bool { + return len(path) > 0 && os.IsPathSeparator(path[len(path)-1]) +} + +// specifiesCurrentDir returns whether the given path specifies +// a "current directory", i.e., the last path segment is `.`. +func specifiesCurrentDir(path string) bool { + return filepath.Base(path) == "." +} + +// SplitPathDirEntry splits the given path between its directory name and its +// basename by first cleaning the path but preserves a trailing "." if the +// original path specified the current directory. +func SplitPathDirEntry(path string) (dir, base string) { + cleanedPath := filepath.Clean(normalizePath(path)) + + if specifiesCurrentDir(path) { + cleanedPath += string(filepath.Separator) + "." + } + + return filepath.Dir(cleanedPath), filepath.Base(cleanedPath) +} + +// TarResource archives the resource described by the given CopyInfo to a Tar +// archive. A non-nil error is returned if sourcePath does not exist or is +// asserted to be a directory but exists as another type of file. +// +// This function acts as a convenient wrapper around TarWithOptions, which +// requires a directory as the source path. TarResource accepts either a +// directory or a file path and correctly sets the Tar options. +func TarResource(sourceInfo CopyInfo) (content Archive, err error) { + return TarResourceRebase(sourceInfo.Path, sourceInfo.RebaseName) +} + +// TarResourceRebase is like TarResource but renames the first path element of +// items in the resulting tar archive to match the given rebaseName if not "". +func TarResourceRebase(sourcePath, rebaseName string) (content Archive, err error) { + sourcePath = normalizePath(sourcePath) + if _, err = os.Lstat(sourcePath); err != nil { + // Catches the case where the source does not exist or is not a + // directory if asserted to be a directory, as this also causes an + // error. + return + } + + // Separate the source path between it's directory and + // the entry in that directory which we are archiving. + sourceDir, sourceBase := SplitPathDirEntry(sourcePath) + + filter := []string{sourceBase} + + logrus.Debugf("copying %q from %q", sourceBase, sourceDir) + + return TarWithOptions(sourceDir, &TarOptions{ + Compression: Uncompressed, + IncludeFiles: filter, + IncludeSourceDir: true, + RebaseNames: map[string]string{ + sourceBase: rebaseName, + }, + }) +} + +// CopyInfo holds basic info about the source +// or destination path of a copy operation. +type CopyInfo struct { + Path string + Exists bool + IsDir bool + RebaseName string +} + +// CopyInfoSourcePath stats the given path to create a CopyInfo +// struct representing that resource for the source of an archive copy +// operation. The given path should be an absolute local path. A source path +// has all symlinks evaluated that appear before the last path separator ("/" +// on Unix). As it is to be a copy source, the path must exist. +func CopyInfoSourcePath(path string) (CopyInfo, error) { + // Split the given path into its Directory and Base components. We will + // evaluate symlinks in the directory component then append the base. + path = normalizePath(path) + dirPath, basePath := filepath.Split(path) + + resolvedDirPath, err := filepath.EvalSymlinks(dirPath) + if err != nil { + return CopyInfo{}, err + } + + // resolvedDirPath will have been cleaned (no trailing path separators) so + // we can manually join it with the base path element. + resolvedPath := resolvedDirPath + string(filepath.Separator) + basePath + + var rebaseName string + if hasTrailingPathSeparator(path) && filepath.Base(path) != filepath.Base(resolvedPath) { + // In the case where the path had a trailing separator and a symlink + // evaluation has changed the last path component, we will need to + // rebase the name in the archive that is being copied to match the + // originally requested name. + rebaseName = filepath.Base(path) + } + + stat, err := os.Lstat(resolvedPath) + if err != nil { + return CopyInfo{}, err + } + + return CopyInfo{ + Path: resolvedPath, + Exists: true, + IsDir: stat.IsDir(), + RebaseName: rebaseName, + }, nil +} + +// CopyInfoDestinationPath stats the given path to create a CopyInfo +// struct representing that resource for the destination of an archive copy +// operation. The given path should be an absolute local path. +func CopyInfoDestinationPath(path string) (info CopyInfo, err error) { + maxSymlinkIter := 10 // filepath.EvalSymlinks uses 255, but 10 already seems like a lot. + path = normalizePath(path) + originalPath := path + + stat, err := os.Lstat(path) + + if err == nil && stat.Mode()&os.ModeSymlink == 0 { + // The path exists and is not a symlink. + return CopyInfo{ + Path: path, + Exists: true, + IsDir: stat.IsDir(), + }, nil + } + + // While the path is a symlink. + for n := 0; err == nil && stat.Mode()&os.ModeSymlink != 0; n++ { + if n > maxSymlinkIter { + // Don't follow symlinks more than this arbitrary number of times. + return CopyInfo{}, errors.New("too many symlinks in " + originalPath) + } + + // The path is a symbolic link. We need to evaluate it so that the + // destination of the copy operation is the link target and not the + // link itself. This is notably different than CopyInfoSourcePath which + // only evaluates symlinks before the last appearing path separator. + // Also note that it is okay if the last path element is a broken + // symlink as the copy operation should create the target. + var linkTarget string + + linkTarget, err = os.Readlink(path) + if err != nil { + return CopyInfo{}, err + } + + if !system.IsAbs(linkTarget) { + // Join with the parent directory. + dstParent, _ := SplitPathDirEntry(path) + linkTarget = filepath.Join(dstParent, linkTarget) + } + + path = linkTarget + stat, err = os.Lstat(path) + } + + if err != nil { + // It's okay if the destination path doesn't exist. We can still + // continue the copy operation if the parent directory exists. + if !os.IsNotExist(err) { + return CopyInfo{}, err + } + + // Ensure destination parent dir exists. + dstParent, _ := SplitPathDirEntry(path) + + parentDirStat, err := os.Lstat(dstParent) + if err != nil { + return CopyInfo{}, err + } + if !parentDirStat.IsDir() { + return CopyInfo{}, ErrNotDirectory + } + + return CopyInfo{Path: path}, nil + } + + // The path exists after resolving symlinks. + return CopyInfo{ + Path: path, + Exists: true, + IsDir: stat.IsDir(), + }, nil +} + +// PrepareArchiveCopy prepares the given srcContent archive, which should +// contain the archived resource described by srcInfo, to the destination +// described by dstInfo. Returns the possibly modified content archive along +// with the path to the destination directory which it should be extracted to. +func PrepareArchiveCopy(srcContent Reader, srcInfo, dstInfo CopyInfo) (dstDir string, content Archive, err error) { + // Ensure in platform semantics + srcInfo.Path = normalizePath(srcInfo.Path) + dstInfo.Path = normalizePath(dstInfo.Path) + + // Separate the destination path between its directory and base + // components in case the source archive contents need to be rebased. + dstDir, dstBase := SplitPathDirEntry(dstInfo.Path) + _, srcBase := SplitPathDirEntry(srcInfo.Path) + + switch { + case dstInfo.Exists && dstInfo.IsDir: + // The destination exists as a directory. No alteration + // to srcContent is needed as its contents can be + // simply extracted to the destination directory. + return dstInfo.Path, ioutil.NopCloser(srcContent), nil + case dstInfo.Exists && srcInfo.IsDir: + // The destination exists as some type of file and the source + // content is a directory. This is an error condition since + // you cannot copy a directory to an existing file location. + return "", nil, ErrCannotCopyDir + case dstInfo.Exists: + // The destination exists as some type of file and the source content + // is also a file. The source content entry will have to be renamed to + // have a basename which matches the destination path's basename. + return dstDir, rebaseArchiveEntries(srcContent, srcBase, dstBase), nil + case srcInfo.IsDir: + // The destination does not exist and the source content is an archive + // of a directory. The archive should be extracted to the parent of + // the destination path instead, and when it is, the directory that is + // created as a result should take the name of the destination path. + // The source content entries will have to be renamed to have a + // basename which matches the destination path's basename. + return dstDir, rebaseArchiveEntries(srcContent, srcBase, dstBase), nil + case assertsDirectory(dstInfo.Path): + // The destination does not exist and is asserted to be created as a + // directory, but the source content is not a directory. This is an + // error condition since you cannot create a directory from a file + // source. + return "", nil, ErrDirNotExists + default: + // The last remaining case is when the destination does not exist, is + // not asserted to be a directory, and the source content is not an + // archive of a directory. It this case, the destination file will need + // to be created when the archive is extracted and the source content + // entry will have to be renamed to have a basename which matches the + // destination path's basename. + return dstDir, rebaseArchiveEntries(srcContent, srcBase, dstBase), nil + } + +} + +// rebaseArchiveEntries rewrites the given srcContent archive replacing +// an occurrence of oldBase with newBase at the beginning of entry names. +func rebaseArchiveEntries(srcContent Reader, oldBase, newBase string) Archive { + if oldBase == string(os.PathSeparator) { + // If oldBase specifies the root directory, use an empty string as + // oldBase instead so that newBase doesn't replace the path separator + // that all paths will start with. + oldBase = "" + } + + rebased, w := io.Pipe() + + go func() { + srcTar := tar.NewReader(srcContent) + rebasedTar := tar.NewWriter(w) + + for { + hdr, err := srcTar.Next() + if err == io.EOF { + // Signals end of archive. + rebasedTar.Close() + w.Close() + return + } + if err != nil { + w.CloseWithError(err) + return + } + + hdr.Name = strings.Replace(hdr.Name, oldBase, newBase, 1) + + if err = rebasedTar.WriteHeader(hdr); err != nil { + w.CloseWithError(err) + return + } + + if _, err = io.Copy(rebasedTar, srcTar); err != nil { + w.CloseWithError(err) + return + } + } + }() + + return rebased +} + +// CopyResource performs an archive copy from the given source path to the +// given destination path. The source path MUST exist and the destination +// path's parent directory must exist. +func CopyResource(srcPath, dstPath string) error { + var ( + srcInfo CopyInfo + err error + ) + + // Ensure in platform semantics + srcPath = normalizePath(srcPath) + dstPath = normalizePath(dstPath) + + // Clean the source and destination paths. + srcPath = PreserveTrailingDotOrSeparator(filepath.Clean(srcPath), srcPath) + dstPath = PreserveTrailingDotOrSeparator(filepath.Clean(dstPath), dstPath) + + if srcInfo, err = CopyInfoSourcePath(srcPath); err != nil { + return err + } + + content, err := TarResource(srcInfo) + if err != nil { + return err + } + defer content.Close() + + return CopyTo(content, srcInfo, dstPath) +} + +// CopyTo handles extracting the given content whose +// entries should be sourced from srcInfo to dstPath. +func CopyTo(content Reader, srcInfo CopyInfo, dstPath string) error { + // The destination path need not exist, but CopyInfoDestinationPath will + // ensure that at least the parent directory exists. + dstInfo, err := CopyInfoDestinationPath(normalizePath(dstPath)) + if err != nil { + return err + } + + dstDir, copyArchive, err := PrepareArchiveCopy(content, srcInfo, dstInfo) + if err != nil { + return err + } + defer copyArchive.Close() + + options := &TarOptions{ + NoLchown: true, + NoOverwriteDirNonDir: true, + } + + return Untar(copyArchive, dstDir, options) +} diff --git a/pkg/archive/copy_test.go b/pkg/archive/copy_test.go new file mode 100644 index 0000000000..25f1811a96 --- /dev/null +++ b/pkg/archive/copy_test.go @@ -0,0 +1,625 @@ +package archive + +import ( + "bytes" + "crypto/sha256" + "encoding/hex" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "strings" + "testing" +) + +func removeAllPaths(paths ...string) { + for _, path := range paths { + os.RemoveAll(path) + } +} + +func getTestTempDirs(t *testing.T) (tmpDirA, tmpDirB string) { + var err error + + if tmpDirA, err = ioutil.TempDir("", "archive-copy-test"); err != nil { + t.Fatal(err) + } + + if tmpDirB, err = ioutil.TempDir("", "archive-copy-test"); err != nil { + t.Fatal(err) + } + + return +} + +func isNotDir(err error) bool { + return strings.Contains(err.Error(), "not a directory") +} + +func joinTrailingSep(pathElements ...string) string { + joined := filepath.Join(pathElements...) + + return fmt.Sprintf("%s%c", joined, filepath.Separator) +} + +func fileContentsEqual(t *testing.T, filenameA, filenameB string) (err error) { + t.Logf("checking for equal file contents: %q and %q\n", filenameA, filenameB) + + fileA, err := os.Open(filenameA) + if err != nil { + return + } + defer fileA.Close() + + fileB, err := os.Open(filenameB) + if err != nil { + return + } + defer fileB.Close() + + hasher := sha256.New() + + if _, err = io.Copy(hasher, fileA); err != nil { + return + } + + hashA := hasher.Sum(nil) + hasher.Reset() + + if _, err = io.Copy(hasher, fileB); err != nil { + return + } + + hashB := hasher.Sum(nil) + + if !bytes.Equal(hashA, hashB) { + err = fmt.Errorf("file content hashes not equal - expected %s, got %s", hex.EncodeToString(hashA), hex.EncodeToString(hashB)) + } + + return +} + +func dirContentsEqual(t *testing.T, newDir, oldDir string) (err error) { + t.Logf("checking for equal directory contents: %q and %q\n", newDir, oldDir) + + var changes []Change + + if changes, err = ChangesDirs(newDir, oldDir); err != nil { + return + } + + if len(changes) != 0 { + err = fmt.Errorf("expected no changes between directories, but got: %v", changes) + } + + return +} + +func logDirContents(t *testing.T, dirPath string) { + logWalkedPaths := filepath.WalkFunc(func(path string, info os.FileInfo, err error) error { + if err != nil { + t.Errorf("stat error for path %q: %s", path, err) + return nil + } + + if info.IsDir() { + path = joinTrailingSep(path) + } + + t.Logf("\t%s", path) + + return nil + }) + + t.Logf("logging directory contents: %q", dirPath) + + if err := filepath.Walk(dirPath, logWalkedPaths); err != nil { + t.Fatal(err) + } +} + +func testCopyHelper(t *testing.T, srcPath, dstPath string) (err error) { + t.Logf("copying from %q to %q", srcPath, dstPath) + + return CopyResource(srcPath, dstPath) +} + +// Basic assumptions about SRC and DST: +// 1. SRC must exist. +// 2. If SRC ends with a trailing separator, it must be a directory. +// 3. DST parent directory must exist. +// 4. If DST exists as a file, it must not end with a trailing separator. + +// First get these easy error cases out of the way. + +// Test for error when SRC does not exist. +func TestCopyErrSrcNotExists(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + if _, err := CopyInfoSourcePath(filepath.Join(tmpDirA, "file1")); !os.IsNotExist(err) { + t.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } +} + +// Test for error when SRC ends in a trailing +// path separator but it exists as a file. +func TestCopyErrSrcNotDir(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A with some sample files and directories. + createSampleDir(t, tmpDirA) + + if _, err := CopyInfoSourcePath(joinTrailingSep(tmpDirA, "file1")); !isNotDir(err) { + t.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } +} + +// Test for error when SRC is a valid file or directory, +// but the DST parent directory does not exist. +func TestCopyErrDstParentNotExists(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A with some sample files and directories. + createSampleDir(t, tmpDirA) + + srcInfo := CopyInfo{Path: filepath.Join(tmpDirA, "file1"), Exists: true, IsDir: false} + + // Try with a file source. + content, err := TarResource(srcInfo) + if err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + defer content.Close() + + // Copy to a file whose parent does not exist. + if err = CopyTo(content, srcInfo, filepath.Join(tmpDirB, "fakeParentDir", "file1")); err == nil { + t.Fatal("expected IsNotExist error, but got nil instead") + } + + if !os.IsNotExist(err) { + t.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } + + // Try with a directory source. + srcInfo = CopyInfo{Path: filepath.Join(tmpDirA, "dir1"), Exists: true, IsDir: true} + + content, err = TarResource(srcInfo) + if err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + defer content.Close() + + // Copy to a directory whose parent does not exist. + if err = CopyTo(content, srcInfo, joinTrailingSep(tmpDirB, "fakeParentDir", "fakeDstDir")); err == nil { + t.Fatal("expected IsNotExist error, but got nil instead") + } + + if !os.IsNotExist(err) { + t.Fatalf("expected IsNotExist error, but got %T: %s", err, err) + } +} + +// Test for error when DST ends in a trailing +// path separator but exists as a file. +func TestCopyErrDstNotDir(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + // Try with a file source. + srcInfo := CopyInfo{Path: filepath.Join(tmpDirA, "file1"), Exists: true, IsDir: false} + + content, err := TarResource(srcInfo) + if err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + defer content.Close() + + if err = CopyTo(content, srcInfo, joinTrailingSep(tmpDirB, "file1")); err == nil { + t.Fatal("expected IsNotDir error, but got nil instead") + } + + if !isNotDir(err) { + t.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } + + // Try with a directory source. + srcInfo = CopyInfo{Path: filepath.Join(tmpDirA, "dir1"), Exists: true, IsDir: true} + + content, err = TarResource(srcInfo) + if err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + defer content.Close() + + if err = CopyTo(content, srcInfo, joinTrailingSep(tmpDirB, "file1")); err == nil { + t.Fatal("expected IsNotDir error, but got nil instead") + } + + if !isNotDir(err) { + t.Fatalf("expected IsNotDir error, but got %T: %s", err, err) + } +} + +// Possibilities are reduced to the remaining 10 cases: +// +// case | srcIsDir | onlyDirContents | dstExists | dstIsDir | dstTrSep | action +// =================================================================================================== +// A | no | - | no | - | no | create file +// B | no | - | no | - | yes | error +// C | no | - | yes | no | - | overwrite file +// D | no | - | yes | yes | - | create file in dst dir +// E | yes | no | no | - | - | create dir, copy contents +// F | yes | no | yes | no | - | error +// G | yes | no | yes | yes | - | copy dir and contents +// H | yes | yes | no | - | - | create dir, copy contents +// I | yes | yes | yes | no | - | error +// J | yes | yes | yes | yes | - | copy dir contents +// + +// A. SRC specifies a file and DST (no trailing path separator) doesn't +// exist. This should create a file with the name DST and copy the +// contents of the source file into it. +func TestCopyCaseA(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A with some sample files and directories. + createSampleDir(t, tmpDirA) + + srcPath := filepath.Join(tmpDirA, "file1") + dstPath := filepath.Join(tmpDirB, "itWorks.txt") + + var err error + + if err = testCopyHelper(t, srcPath, dstPath); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = fileContentsEqual(t, srcPath, dstPath); err != nil { + t.Fatal(err) + } +} + +// B. SRC specifies a file and DST (with trailing path separator) doesn't +// exist. This should cause an error because the copy operation cannot +// create a directory when copying a single file. +func TestCopyCaseB(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A with some sample files and directories. + createSampleDir(t, tmpDirA) + + srcPath := filepath.Join(tmpDirA, "file1") + dstDir := joinTrailingSep(tmpDirB, "testDir") + + var err error + + if err = testCopyHelper(t, srcPath, dstDir); err == nil { + t.Fatal("expected ErrDirNotExists error, but got nil instead") + } + + if err != ErrDirNotExists { + t.Fatalf("expected ErrDirNotExists error, but got %T: %s", err, err) + } +} + +// C. SRC specifies a file and DST exists as a file. This should overwrite +// the file at DST with the contents of the source file. +func TestCopyCaseC(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + srcPath := filepath.Join(tmpDirA, "file1") + dstPath := filepath.Join(tmpDirB, "file2") + + var err error + + // Ensure they start out different. + if err = fileContentsEqual(t, srcPath, dstPath); err == nil { + t.Fatal("expected different file contents") + } + + if err = testCopyHelper(t, srcPath, dstPath); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = fileContentsEqual(t, srcPath, dstPath); err != nil { + t.Fatal(err) + } +} + +// D. SRC specifies a file and DST exists as a directory. This should place +// a copy of the source file inside it using the basename from SRC. Ensure +// this works whether DST has a trailing path separator or not. +func TestCopyCaseD(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + srcPath := filepath.Join(tmpDirA, "file1") + dstDir := filepath.Join(tmpDirB, "dir1") + dstPath := filepath.Join(dstDir, "file1") + + var err error + + // Ensure that dstPath doesn't exist. + if _, err = os.Stat(dstPath); !os.IsNotExist(err) { + t.Fatalf("did not expect dstPath %q to exist", dstPath) + } + + if err = testCopyHelper(t, srcPath, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = fileContentsEqual(t, srcPath, dstPath); err != nil { + t.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err = os.RemoveAll(dstDir); err != nil { + t.Fatalf("unable to remove dstDir: %s", err) + } + + if err = os.MkdirAll(dstDir, os.FileMode(0755)); err != nil { + t.Fatalf("unable to make dstDir: %s", err) + } + + dstDir = joinTrailingSep(tmpDirB, "dir1") + + if err = testCopyHelper(t, srcPath, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = fileContentsEqual(t, srcPath, dstPath); err != nil { + t.Fatal(err) + } +} + +// E. SRC specifies a directory and DST does not exist. This should create a +// directory at DST and copy the contents of the SRC directory into the DST +// directory. Ensure this works whether DST has a trailing path separator or +// not. +func TestCopyCaseE(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A with some sample files and directories. + createSampleDir(t, tmpDirA) + + srcDir := filepath.Join(tmpDirA, "dir1") + dstDir := filepath.Join(tmpDirB, "testDir") + + var err error + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, dstDir, srcDir); err != nil { + t.Log("dir contents not equal") + logDirContents(t, tmpDirA) + logDirContents(t, tmpDirB) + t.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err = os.RemoveAll(dstDir); err != nil { + t.Fatalf("unable to remove dstDir: %s", err) + } + + dstDir = joinTrailingSep(tmpDirB, "testDir") + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, dstDir, srcDir); err != nil { + t.Fatal(err) + } +} + +// F. SRC specifies a directory and DST exists as a file. This should cause an +// error as it is not possible to overwrite a file with a directory. +func TestCopyCaseF(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + srcDir := filepath.Join(tmpDirA, "dir1") + dstFile := filepath.Join(tmpDirB, "file1") + + var err error + + if err = testCopyHelper(t, srcDir, dstFile); err == nil { + t.Fatal("expected ErrCannotCopyDir error, but got nil instead") + } + + if err != ErrCannotCopyDir { + t.Fatalf("expected ErrCannotCopyDir error, but got %T: %s", err, err) + } +} + +// G. SRC specifies a directory and DST exists as a directory. This should copy +// the SRC directory and all its contents to the DST directory. Ensure this +// works whether DST has a trailing path separator or not. +func TestCopyCaseG(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + srcDir := filepath.Join(tmpDirA, "dir1") + dstDir := filepath.Join(tmpDirB, "dir2") + resultDir := filepath.Join(dstDir, "dir1") + + var err error + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, resultDir, srcDir); err != nil { + t.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err = os.RemoveAll(dstDir); err != nil { + t.Fatalf("unable to remove dstDir: %s", err) + } + + if err = os.MkdirAll(dstDir, os.FileMode(0755)); err != nil { + t.Fatalf("unable to make dstDir: %s", err) + } + + dstDir = joinTrailingSep(tmpDirB, "dir2") + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, resultDir, srcDir); err != nil { + t.Fatal(err) + } +} + +// H. SRC specifies a directory's contents only and DST does not exist. This +// should create a directory at DST and copy the contents of the SRC +// directory (but not the directory itself) into the DST directory. Ensure +// this works whether DST has a trailing path separator or not. +func TestCopyCaseH(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A with some sample files and directories. + createSampleDir(t, tmpDirA) + + srcDir := joinTrailingSep(tmpDirA, "dir1") + "." + dstDir := filepath.Join(tmpDirB, "testDir") + + var err error + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, dstDir, srcDir); err != nil { + t.Log("dir contents not equal") + logDirContents(t, tmpDirA) + logDirContents(t, tmpDirB) + t.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err = os.RemoveAll(dstDir); err != nil { + t.Fatalf("unable to remove dstDir: %s", err) + } + + dstDir = joinTrailingSep(tmpDirB, "testDir") + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, dstDir, srcDir); err != nil { + t.Log("dir contents not equal") + logDirContents(t, tmpDirA) + logDirContents(t, tmpDirB) + t.Fatal(err) + } +} + +// I. SRC specifies a directory's contents only and DST exists as a file. This +// should cause an error as it is not possible to overwrite a file with a +// directory. +func TestCopyCaseI(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + srcDir := joinTrailingSep(tmpDirA, "dir1") + "." + dstFile := filepath.Join(tmpDirB, "file1") + + var err error + + if err = testCopyHelper(t, srcDir, dstFile); err == nil { + t.Fatal("expected ErrCannotCopyDir error, but got nil instead") + } + + if err != ErrCannotCopyDir { + t.Fatalf("expected ErrCannotCopyDir error, but got %T: %s", err, err) + } +} + +// J. SRC specifies a directory's contents only and DST exists as a directory. +// This should copy the contents of the SRC directory (but not the directory +// itself) into the DST directory. Ensure this works whether DST has a +// trailing path separator or not. +func TestCopyCaseJ(t *testing.T) { + tmpDirA, tmpDirB := getTestTempDirs(t) + defer removeAllPaths(tmpDirA, tmpDirB) + + // Load A and B with some sample files and directories. + createSampleDir(t, tmpDirA) + createSampleDir(t, tmpDirB) + + srcDir := joinTrailingSep(tmpDirA, "dir1") + "." + dstDir := filepath.Join(tmpDirB, "dir5") + + var err error + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, dstDir, srcDir); err != nil { + t.Fatal(err) + } + + // Now try again but using a trailing path separator for dstDir. + + if err = os.RemoveAll(dstDir); err != nil { + t.Fatalf("unable to remove dstDir: %s", err) + } + + if err = os.MkdirAll(dstDir, os.FileMode(0755)); err != nil { + t.Fatalf("unable to make dstDir: %s", err) + } + + dstDir = joinTrailingSep(tmpDirB, "dir5") + + if err = testCopyHelper(t, srcDir, dstDir); err != nil { + t.Fatalf("unexpected error %T: %s", err, err) + } + + if err = dirContentsEqual(t, dstDir, srcDir); err != nil { + t.Fatal(err) + } +} diff --git a/pkg/archive/copy_unix.go b/pkg/archive/copy_unix.go new file mode 100644 index 0000000000..e305b5e4af --- /dev/null +++ b/pkg/archive/copy_unix.go @@ -0,0 +1,11 @@ +// +build !windows + +package archive + +import ( + "path/filepath" +) + +func normalizePath(path string) string { + return filepath.ToSlash(path) +} diff --git a/pkg/archive/copy_windows.go b/pkg/archive/copy_windows.go new file mode 100644 index 0000000000..2b775b45c4 --- /dev/null +++ b/pkg/archive/copy_windows.go @@ -0,0 +1,9 @@ +package archive + +import ( + "path/filepath" +) + +func normalizePath(path string) string { + return filepath.FromSlash(path) +} diff --git a/pkg/archive/diff.go b/pkg/archive/diff.go new file mode 100644 index 0000000000..1b08ad33ab --- /dev/null +++ b/pkg/archive/diff.go @@ -0,0 +1,279 @@ +package archive + +import ( + "archive/tar" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "runtime" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/pools" + "github.com/docker/docker/pkg/system" +) + +// UnpackLayer unpack `layer` to a `dest`. The stream `layer` can be +// compressed or uncompressed. +// Returns the size in bytes of the contents of the layer. +func UnpackLayer(dest string, layer Reader, options *TarOptions) (size int64, err error) { + tr := tar.NewReader(layer) + trBuf := pools.BufioReader32KPool.Get(tr) + defer pools.BufioReader32KPool.Put(trBuf) + + var dirs []*tar.Header + unpackedPaths := make(map[string]struct{}) + + if options == nil { + options = &TarOptions{} + } + if options.ExcludePatterns == nil { + options.ExcludePatterns = []string{} + } + remappedRootUID, remappedRootGID, err := idtools.GetRootUIDGID(options.UIDMaps, options.GIDMaps) + if err != nil { + return 0, err + } + + aufsTempdir := "" + aufsHardlinks := make(map[string]*tar.Header) + + if options == nil { + options = &TarOptions{} + } + // Iterate through the files in the archive. + for { + hdr, err := tr.Next() + if err == io.EOF { + // end of tar archive + break + } + if err != nil { + return 0, err + } + + size += hdr.Size + + // Normalize name, for safety and for a simple is-root check + hdr.Name = filepath.Clean(hdr.Name) + + // Windows does not support filenames with colons in them. Ignore + // these files. This is not a problem though (although it might + // appear that it is). Let's suppose a client is running docker pull. + // The daemon it points to is Windows. Would it make sense for the + // client to be doing a docker pull Ubuntu for example (which has files + // with colons in the name under /usr/share/man/man3)? No, absolutely + // not as it would really only make sense that they were pulling a + // Windows image. However, for development, it is necessary to be able + // to pull Linux images which are in the repository. + // + // TODO Windows. Once the registry is aware of what images are Windows- + // specific or Linux-specific, this warning should be changed to an error + // to cater for the situation where someone does manage to upload a Linux + // image but have it tagged as Windows inadvertently. + if runtime.GOOS == "windows" { + if strings.Contains(hdr.Name, ":") { + logrus.Warnf("Windows: Ignoring %s (is this a Linux image?)", hdr.Name) + continue + } + } + + // Note as these operations are platform specific, so must the slash be. + if !strings.HasSuffix(hdr.Name, string(os.PathSeparator)) { + // Not the root directory, ensure that the parent directory exists. + // This happened in some tests where an image had a tarfile without any + // parent directories. + parent := filepath.Dir(hdr.Name) + parentPath := filepath.Join(dest, parent) + + if _, err := os.Lstat(parentPath); err != nil && os.IsNotExist(err) { + err = system.MkdirAll(parentPath, 0600) + if err != nil { + return 0, err + } + } + } + + // Skip AUFS metadata dirs + if strings.HasPrefix(hdr.Name, WhiteoutMetaPrefix) { + // Regular files inside /.wh..wh.plnk can be used as hardlink targets + // We don't want this directory, but we need the files in them so that + // such hardlinks can be resolved. + if strings.HasPrefix(hdr.Name, WhiteoutLinkDir) && hdr.Typeflag == tar.TypeReg { + basename := filepath.Base(hdr.Name) + aufsHardlinks[basename] = hdr + if aufsTempdir == "" { + if aufsTempdir, err = ioutil.TempDir("", "dockerplnk"); err != nil { + return 0, err + } + defer os.RemoveAll(aufsTempdir) + } + if err := createTarFile(filepath.Join(aufsTempdir, basename), dest, hdr, tr, true, nil); err != nil { + return 0, err + } + } + + if hdr.Name != WhiteoutOpaqueDir { + continue + } + } + path := filepath.Join(dest, hdr.Name) + rel, err := filepath.Rel(dest, path) + if err != nil { + return 0, err + } + + // Note as these operations are platform specific, so must the slash be. + if strings.HasPrefix(rel, ".."+string(os.PathSeparator)) { + return 0, breakoutError(fmt.Errorf("%q is outside of %q", hdr.Name, dest)) + } + base := filepath.Base(path) + + if strings.HasPrefix(base, WhiteoutPrefix) { + dir := filepath.Dir(path) + if base == WhiteoutOpaqueDir { + _, err := os.Lstat(dir) + if err != nil { + return 0, err + } + err = filepath.Walk(dir, func(path string, info os.FileInfo, err error) error { + if err != nil { + if os.IsNotExist(err) { + err = nil // parent was deleted + } + return err + } + if path == dir { + return nil + } + if _, exists := unpackedPaths[path]; !exists { + err := os.RemoveAll(path) + return err + } + return nil + }) + if err != nil { + return 0, err + } + } else { + originalBase := base[len(WhiteoutPrefix):] + originalPath := filepath.Join(dir, originalBase) + if err := os.RemoveAll(originalPath); err != nil { + return 0, err + } + } + } else { + // If path exits we almost always just want to remove and replace it. + // The only exception is when it is a directory *and* the file from + // the layer is also a directory. Then we want to merge them (i.e. + // just apply the metadata from the layer). + if fi, err := os.Lstat(path); err == nil { + if !(fi.IsDir() && hdr.Typeflag == tar.TypeDir) { + if err := os.RemoveAll(path); err != nil { + return 0, err + } + } + } + + trBuf.Reset(tr) + srcData := io.Reader(trBuf) + srcHdr := hdr + + // Hard links into /.wh..wh.plnk don't work, as we don't extract that directory, so + // we manually retarget these into the temporary files we extracted them into + if hdr.Typeflag == tar.TypeLink && strings.HasPrefix(filepath.Clean(hdr.Linkname), WhiteoutLinkDir) { + linkBasename := filepath.Base(hdr.Linkname) + srcHdr = aufsHardlinks[linkBasename] + if srcHdr == nil { + return 0, fmt.Errorf("Invalid aufs hardlink") + } + tmpFile, err := os.Open(filepath.Join(aufsTempdir, linkBasename)) + if err != nil { + return 0, err + } + defer tmpFile.Close() + srcData = tmpFile + } + + // if the options contain a uid & gid maps, convert header uid/gid + // entries using the maps such that lchown sets the proper mapped + // uid/gid after writing the file. We only perform this mapping if + // the file isn't already owned by the remapped root UID or GID, as + // that specific uid/gid has no mapping from container -> host, and + // those files already have the proper ownership for inside the + // container. + if srcHdr.Uid != remappedRootUID { + xUID, err := idtools.ToHost(srcHdr.Uid, options.UIDMaps) + if err != nil { + return 0, err + } + srcHdr.Uid = xUID + } + if srcHdr.Gid != remappedRootGID { + xGID, err := idtools.ToHost(srcHdr.Gid, options.GIDMaps) + if err != nil { + return 0, err + } + srcHdr.Gid = xGID + } + if err := createTarFile(path, dest, srcHdr, srcData, true, nil); err != nil { + return 0, err + } + + // Directory mtimes must be handled at the end to avoid further + // file creation in them to modify the directory mtime + if hdr.Typeflag == tar.TypeDir { + dirs = append(dirs, hdr) + } + unpackedPaths[path] = struct{}{} + } + } + + for _, hdr := range dirs { + path := filepath.Join(dest, hdr.Name) + if err := system.Chtimes(path, hdr.AccessTime, hdr.ModTime); err != nil { + return 0, err + } + } + + return size, nil +} + +// ApplyLayer parses a diff in the standard layer format from `layer`, +// and applies it to the directory `dest`. The stream `layer` can be +// compressed or uncompressed. +// Returns the size in bytes of the contents of the layer. +func ApplyLayer(dest string, layer Reader) (int64, error) { + return applyLayerHandler(dest, layer, &TarOptions{}, true) +} + +// ApplyUncompressedLayer parses a diff in the standard layer format from +// `layer`, and applies it to the directory `dest`. The stream `layer` +// can only be uncompressed. +// Returns the size in bytes of the contents of the layer. +func ApplyUncompressedLayer(dest string, layer Reader, options *TarOptions) (int64, error) { + return applyLayerHandler(dest, layer, options, false) +} + +// do the bulk load of ApplyLayer, but allow for not calling DecompressStream +func applyLayerHandler(dest string, layer Reader, options *TarOptions, decompress bool) (int64, error) { + dest = filepath.Clean(dest) + + // We need to be able to set any perms + oldmask, err := system.Umask(0) + if err != nil { + return 0, err + } + defer system.Umask(oldmask) // ignore err, ErrNotSupportedPlatform + + if decompress { + layer, err = DecompressStream(layer) + if err != nil { + return 0, err + } + } + return UnpackLayer(dest, layer, options) +} diff --git a/pkg/archive/diff_test.go b/pkg/archive/diff_test.go new file mode 100644 index 0000000000..2b29992db5 --- /dev/null +++ b/pkg/archive/diff_test.go @@ -0,0 +1,370 @@ +package archive + +import ( + "archive/tar" + "io" + "io/ioutil" + "os" + "path/filepath" + "reflect" + "testing" + + "github.com/docker/docker/pkg/ioutils" +) + +func TestApplyLayerInvalidFilenames(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { + { + Name: "../victim/dotdot", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { + { + // Note the leading slash + Name: "/../victim/slash-dotdot", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("applylayer", "docker-TestApplyLayerInvalidFilenames", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestApplyLayerInvalidHardlink(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { // try reading victim/hello (../) + { + Name: "dotdot", + Typeflag: tar.TypeLink, + Linkname: "../victim/hello", + Mode: 0644, + }, + }, + { // try reading victim/hello (/../) + { + Name: "slash-dotdot", + Typeflag: tar.TypeLink, + // Note the leading slash + Linkname: "/../victim/hello", + Mode: 0644, + }, + }, + { // try writing victim/file + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim/file", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { // try reading victim/hello (hardlink, symlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "symlink", + Typeflag: tar.TypeSymlink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // Try reading victim/hello (hardlink, hardlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "hardlink", + Typeflag: tar.TypeLink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // Try removing victim directory (hardlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeLink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("applylayer", "docker-TestApplyLayerInvalidHardlink", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestApplyLayerInvalidSymlink(t *testing.T) { + for i, headers := range [][]*tar.Header{ + { // try reading victim/hello (../) + { + Name: "dotdot", + Typeflag: tar.TypeSymlink, + Linkname: "../victim/hello", + Mode: 0644, + }, + }, + { // try reading victim/hello (/../) + { + Name: "slash-dotdot", + Typeflag: tar.TypeSymlink, + // Note the leading slash + Linkname: "/../victim/hello", + Mode: 0644, + }, + }, + { // try writing victim/file + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim/file", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + { // try reading victim/hello (symlink, symlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "symlink", + Typeflag: tar.TypeSymlink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // try reading victim/hello (symlink, hardlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "hardlink", + Typeflag: tar.TypeLink, + Linkname: "loophole-victim/hello", + Mode: 0644, + }, + }, + { // try removing victim directory (symlink) + { + Name: "loophole-victim", + Typeflag: tar.TypeSymlink, + Linkname: "../victim", + Mode: 0755, + }, + { + Name: "loophole-victim", + Typeflag: tar.TypeReg, + Mode: 0644, + }, + }, + } { + if err := testBreakout("applylayer", "docker-TestApplyLayerInvalidSymlink", headers); err != nil { + t.Fatalf("i=%d. %v", i, err) + } + } +} + +func TestApplyLayerWhiteouts(t *testing.T) { + wd, err := ioutil.TempDir("", "graphdriver-test-whiteouts") + if err != nil { + return + } + defer os.RemoveAll(wd) + + base := []string{ + ".baz", + "bar/", + "bar/bax", + "bar/bay/", + "baz", + "foo/", + "foo/.abc", + "foo/.bcd/", + "foo/.bcd/a", + "foo/cde/", + "foo/cde/def", + "foo/cde/efg", + "foo/fgh", + "foobar", + } + + type tcase struct { + change, expected []string + } + + tcases := []tcase{ + { + base, + base, + }, + { + []string{ + ".bay", + ".wh.baz", + "foo/", + "foo/.bce", + "foo/.wh..wh..opq", + "foo/cde/", + "foo/cde/efg", + }, + []string{ + ".bay", + ".baz", + "bar/", + "bar/bax", + "bar/bay/", + "foo/", + "foo/.bce", + "foo/cde/", + "foo/cde/efg", + "foobar", + }, + }, + { + []string{ + ".bay", + ".wh..baz", + ".wh.foobar", + "foo/", + "foo/.abc", + "foo/.wh.cde", + "bar/", + }, + []string{ + ".bay", + "bar/", + "bar/bax", + "bar/bay/", + "foo/", + "foo/.abc", + "foo/.bce", + }, + }, + { + []string{ + ".abc", + ".wh..wh..opq", + "foobar", + }, + []string{ + ".abc", + "foobar", + }, + }, + } + + for i, tc := range tcases { + l, err := makeTestLayer(tc.change) + if err != nil { + t.Fatal(err) + } + + _, err = UnpackLayer(wd, l, nil) + if err != nil { + t.Fatal(err) + } + err = l.Close() + if err != nil { + t.Fatal(err) + } + + paths, err := readDirContents(wd) + if err != nil { + t.Fatal(err) + } + + if !reflect.DeepEqual(tc.expected, paths) { + t.Fatalf("invalid files for layer %d: expected %q, got %q", i, tc.expected, paths) + } + } + +} + +func makeTestLayer(paths []string) (rc io.ReadCloser, err error) { + tmpDir, err := ioutil.TempDir("", "graphdriver-test-mklayer") + if err != nil { + return + } + defer func() { + if err != nil { + os.RemoveAll(tmpDir) + } + }() + for _, p := range paths { + if p[len(p)-1] == filepath.Separator { + if err = os.MkdirAll(filepath.Join(tmpDir, p), 0700); err != nil { + return + } + } else { + if err = ioutil.WriteFile(filepath.Join(tmpDir, p), nil, 0600); err != nil { + return + } + } + } + archive, err := Tar(tmpDir, Uncompressed) + if err != nil { + return + } + return ioutils.NewReadCloserWrapper(archive, func() error { + err := archive.Close() + os.RemoveAll(tmpDir) + return err + }), nil +} + +func readDirContents(root string) ([]string, error) { + var files []string + err := filepath.Walk(root, func(path string, info os.FileInfo, err error) error { + if err != nil { + return err + } + if path == root { + return nil + } + rel, err := filepath.Rel(root, path) + if err != nil { + return err + } + if info.IsDir() { + rel = rel + "/" + } + files = append(files, rel) + return nil + }) + if err != nil { + return nil, err + } + return files, nil +} diff --git a/pkg/archive/example_changes.go b/pkg/archive/example_changes.go new file mode 100644 index 0000000000..cedd46a408 --- /dev/null +++ b/pkg/archive/example_changes.go @@ -0,0 +1,97 @@ +// +build ignore + +// Simple tool to create an archive stream from an old and new directory +// +// By default it will stream the comparison of two temporary directories with junk files +package main + +import ( + "flag" + "fmt" + "io" + "io/ioutil" + "os" + "path" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/archive" +) + +var ( + flDebug = flag.Bool("D", false, "debugging output") + flNewDir = flag.String("newdir", "", "") + flOldDir = flag.String("olddir", "", "") + log = logrus.New() +) + +func main() { + flag.Usage = func() { + fmt.Println("Produce a tar from comparing two directory paths. By default a demo tar is created of around 200 files (including hardlinks)") + fmt.Printf("%s [OPTIONS]\n", os.Args[0]) + flag.PrintDefaults() + } + flag.Parse() + log.Out = os.Stderr + if (len(os.Getenv("DEBUG")) > 0) || *flDebug { + logrus.SetLevel(logrus.DebugLevel) + } + var newDir, oldDir string + + if len(*flNewDir) == 0 { + var err error + newDir, err = ioutil.TempDir("", "docker-test-newDir") + if err != nil { + log.Fatal(err) + } + defer os.RemoveAll(newDir) + if _, err := prepareUntarSourceDirectory(100, newDir, true); err != nil { + log.Fatal(err) + } + } else { + newDir = *flNewDir + } + + if len(*flOldDir) == 0 { + oldDir, err := ioutil.TempDir("", "docker-test-oldDir") + if err != nil { + log.Fatal(err) + } + defer os.RemoveAll(oldDir) + } else { + oldDir = *flOldDir + } + + changes, err := archive.ChangesDirs(newDir, oldDir) + if err != nil { + log.Fatal(err) + } + + a, err := archive.ExportChanges(newDir, changes) + if err != nil { + log.Fatal(err) + } + defer a.Close() + + i, err := io.Copy(os.Stdout, a) + if err != nil && err != io.EOF { + log.Fatal(err) + } + fmt.Fprintf(os.Stderr, "wrote archive of %d bytes", i) +} + +func prepareUntarSourceDirectory(numberOfFiles int, targetPath string, makeLinks bool) (int, error) { + fileData := []byte("fooo") + for n := 0; n < numberOfFiles; n++ { + fileName := fmt.Sprintf("file-%d", n) + if err := ioutil.WriteFile(path.Join(targetPath, fileName), fileData, 0700); err != nil { + return 0, err + } + if makeLinks { + if err := os.Link(path.Join(targetPath, fileName), path.Join(targetPath, fileName+"-link")); err != nil { + return 0, err + } + } + } + totalSize := numberOfFiles * len(fileData) + return totalSize, nil +} diff --git a/pkg/archive/testdata/broken.tar b/pkg/archive/testdata/broken.tar new file mode 100644 index 0000000000000000000000000000000000000000..8f10ea6b87d3eb4fed572349dfe87695603b10a5 GIT binary patch literal 13824 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 literal 0 HcmV?d00001 diff --git a/pkg/archive/time_linux.go b/pkg/archive/time_linux.go new file mode 100644 index 0000000000..3448569b1e --- /dev/null +++ b/pkg/archive/time_linux.go @@ -0,0 +1,16 @@ +package archive + +import ( + "syscall" + "time" +) + +func timeToTimespec(time time.Time) (ts syscall.Timespec) { + if time.IsZero() { + // Return UTIME_OMIT special value + ts.Sec = 0 + ts.Nsec = ((1 << 30) - 2) + return + } + return syscall.NsecToTimespec(time.UnixNano()) +} diff --git a/pkg/archive/time_unsupported.go b/pkg/archive/time_unsupported.go new file mode 100644 index 0000000000..e85aac0540 --- /dev/null +++ b/pkg/archive/time_unsupported.go @@ -0,0 +1,16 @@ +// +build !linux + +package archive + +import ( + "syscall" + "time" +) + +func timeToTimespec(time time.Time) (ts syscall.Timespec) { + nsec := int64(0) + if !time.IsZero() { + nsec = time.UnixNano() + } + return syscall.NsecToTimespec(nsec) +} diff --git a/pkg/archive/utils_test.go b/pkg/archive/utils_test.go new file mode 100644 index 0000000000..98719032f3 --- /dev/null +++ b/pkg/archive/utils_test.go @@ -0,0 +1,166 @@ +package archive + +import ( + "archive/tar" + "bytes" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "time" +) + +var testUntarFns = map[string]func(string, io.Reader) error{ + "untar": func(dest string, r io.Reader) error { + return Untar(r, dest, nil) + }, + "applylayer": func(dest string, r io.Reader) error { + _, err := ApplyLayer(dest, Reader(r)) + return err + }, +} + +// testBreakout is a helper function that, within the provided `tmpdir` directory, +// creates a `victim` folder with a generated `hello` file in it. +// `untar` extracts to a directory named `dest`, the tar file created from `headers`. +// +// Here are the tested scenarios: +// - removed `victim` folder (write) +// - removed files from `victim` folder (write) +// - new files in `victim` folder (write) +// - modified files in `victim` folder (write) +// - file in `dest` with same content as `victim/hello` (read) +// +// When using testBreakout make sure you cover one of the scenarios listed above. +func testBreakout(untarFn string, tmpdir string, headers []*tar.Header) error { + tmpdir, err := ioutil.TempDir("", tmpdir) + if err != nil { + return err + } + defer os.RemoveAll(tmpdir) + + dest := filepath.Join(tmpdir, "dest") + if err := os.Mkdir(dest, 0755); err != nil { + return err + } + + victim := filepath.Join(tmpdir, "victim") + if err := os.Mkdir(victim, 0755); err != nil { + return err + } + hello := filepath.Join(victim, "hello") + helloData, err := time.Now().MarshalText() + if err != nil { + return err + } + if err := ioutil.WriteFile(hello, helloData, 0644); err != nil { + return err + } + helloStat, err := os.Stat(hello) + if err != nil { + return err + } + + reader, writer := io.Pipe() + go func() { + t := tar.NewWriter(writer) + for _, hdr := range headers { + t.WriteHeader(hdr) + } + t.Close() + }() + + untar := testUntarFns[untarFn] + if untar == nil { + return fmt.Errorf("could not find untar function %q in testUntarFns", untarFn) + } + if err := untar(dest, reader); err != nil { + if _, ok := err.(breakoutError); !ok { + // If untar returns an error unrelated to an archive breakout, + // then consider this an unexpected error and abort. + return err + } + // Here, untar detected the breakout. + // Let's move on verifying that indeed there was no breakout. + fmt.Printf("breakoutError: %v\n", err) + } + + // Check victim folder + f, err := os.Open(victim) + if err != nil { + // codepath taken if victim folder was removed + return fmt.Errorf("archive breakout: error reading %q: %v", victim, err) + } + defer f.Close() + + // Check contents of victim folder + // + // We are only interested in getting 2 files from the victim folder, because if all is well + // we expect only one result, the `hello` file. If there is a second result, it cannot + // hold the same name `hello` and we assume that a new file got created in the victim folder. + // That is enough to detect an archive breakout. + names, err := f.Readdirnames(2) + if err != nil { + // codepath taken if victim is not a folder + return fmt.Errorf("archive breakout: error reading directory content of %q: %v", victim, err) + } + for _, name := range names { + if name != "hello" { + // codepath taken if new file was created in victim folder + return fmt.Errorf("archive breakout: new file %q", name) + } + } + + // Check victim/hello + f, err = os.Open(hello) + if err != nil { + // codepath taken if read permissions were removed + return fmt.Errorf("archive breakout: could not lstat %q: %v", hello, err) + } + defer f.Close() + b, err := ioutil.ReadAll(f) + if err != nil { + return err + } + fi, err := f.Stat() + if err != nil { + return err + } + if helloStat.IsDir() != fi.IsDir() || + // TODO: cannot check for fi.ModTime() change + helloStat.Mode() != fi.Mode() || + helloStat.Size() != fi.Size() || + !bytes.Equal(helloData, b) { + // codepath taken if hello has been modified + return fmt.Errorf("archive breakout: file %q has been modified. Contents: expected=%q, got=%q. FileInfo: expected=%#v, got=%#v", hello, helloData, b, helloStat, fi) + } + + // Check that nothing in dest/ has the same content as victim/hello. + // Since victim/hello was generated with time.Now(), it is safe to assume + // that any file whose content matches exactly victim/hello, managed somehow + // to access victim/hello. + return filepath.Walk(dest, func(path string, info os.FileInfo, err error) error { + if info.IsDir() { + if err != nil { + // skip directory if error + return filepath.SkipDir + } + // enter directory + return nil + } + if err != nil { + // skip file if error + return nil + } + b, err := ioutil.ReadFile(path) + if err != nil { + // Houston, we have a problem. Aborting (space)walk. + return err + } + if bytes.Equal(helloData, b) { + return fmt.Errorf("archive breakout: file %q has been accessed via %q", hello, path) + } + return nil + }) +} diff --git a/pkg/archive/whiteouts.go b/pkg/archive/whiteouts.go new file mode 100644 index 0000000000..3d9c313213 --- /dev/null +++ b/pkg/archive/whiteouts.go @@ -0,0 +1,23 @@ +package archive + +// Whiteouts are files with a special meaning for the layered filesystem. +// Docker uses AUFS whiteout files inside exported archives. In other +// filesystems these files are generated/handled on tar creation/extraction. + +// WhiteoutPrefix prefix means file is a whiteout. If this is followed by a +// filename this means that file has been removed from the base layer. +const WhiteoutPrefix = ".wh." + +// WhiteoutMetaPrefix prefix means whiteout has a special meaning and is not +// for remoing an actaul file. Normally these files are excluded from exported +// archives. +const WhiteoutMetaPrefix = WhiteoutPrefix + WhiteoutPrefix + +// WhiteoutLinkDir is a directory AUFS uses for storing hardlink links to other +// layers. Normally these should not go into exported archives and all changed +// hardlinks should be copied to the top layer. +const WhiteoutLinkDir = WhiteoutMetaPrefix + "plnk" + +// WhiteoutOpaqueDir file means directory has been made opaque - meaning +// readdir calls to this directory do not follow to lower layers. +const WhiteoutOpaqueDir = WhiteoutMetaPrefix + ".opq" diff --git a/pkg/archive/wrap.go b/pkg/archive/wrap.go new file mode 100644 index 0000000000..dfb335c0b6 --- /dev/null +++ b/pkg/archive/wrap.go @@ -0,0 +1,59 @@ +package archive + +import ( + "archive/tar" + "bytes" + "io/ioutil" +) + +// Generate generates a new archive from the content provided +// as input. +// +// `files` is a sequence of path/content pairs. A new file is +// added to the archive for each pair. +// If the last pair is incomplete, the file is created with an +// empty content. For example: +// +// Generate("foo.txt", "hello world", "emptyfile") +// +// The above call will return an archive with 2 files: +// * ./foo.txt with content "hello world" +// * ./empty with empty content +// +// FIXME: stream content instead of buffering +// FIXME: specify permissions and other archive metadata +func Generate(input ...string) (Archive, error) { + files := parseStringPairs(input...) + buf := new(bytes.Buffer) + tw := tar.NewWriter(buf) + for _, file := range files { + name, content := file[0], file[1] + hdr := &tar.Header{ + Name: name, + Size: int64(len(content)), + } + if err := tw.WriteHeader(hdr); err != nil { + return nil, err + } + if _, err := tw.Write([]byte(content)); err != nil { + return nil, err + } + } + if err := tw.Close(); err != nil { + return nil, err + } + return ioutil.NopCloser(buf), nil +} + +func parseStringPairs(input ...string) (output [][2]string) { + output = make([][2]string, 0, len(input)/2+1) + for i := 0; i < len(input); i += 2 { + var pair [2]string + pair[0] = input[i] + if i+1 < len(input) { + pair[1] = input[i+1] + } + output = append(output, pair) + } + return +} diff --git a/pkg/archive/wrap_test.go b/pkg/archive/wrap_test.go new file mode 100644 index 0000000000..46ab36697a --- /dev/null +++ b/pkg/archive/wrap_test.go @@ -0,0 +1,98 @@ +package archive + +import ( + "archive/tar" + "bytes" + "io" + "testing" +) + +func TestGenerateEmptyFile(t *testing.T) { + archive, err := Generate("emptyFile") + if err != nil { + t.Fatal(err) + } + if archive == nil { + t.Fatal("The generated archive should not be nil.") + } + + expectedFiles := [][]string{ + {"emptyFile", ""}, + } + + tr := tar.NewReader(archive) + actualFiles := make([][]string, 0, 10) + i := 0 + for { + hdr, err := tr.Next() + if err == io.EOF { + break + } + if err != nil { + t.Fatal(err) + } + buf := new(bytes.Buffer) + buf.ReadFrom(tr) + content := buf.String() + actualFiles = append(actualFiles, []string{hdr.Name, content}) + i++ + } + if len(actualFiles) != len(expectedFiles) { + t.Fatalf("Number of expected file %d, got %d.", len(expectedFiles), len(actualFiles)) + } + for i := 0; i < len(expectedFiles); i++ { + actual := actualFiles[i] + expected := expectedFiles[i] + if actual[0] != expected[0] { + t.Fatalf("Expected name '%s', Actual name '%s'", expected[0], actual[0]) + } + if actual[1] != expected[1] { + t.Fatalf("Expected content '%s', Actual content '%s'", expected[1], actual[1]) + } + } +} + +func TestGenerateWithContent(t *testing.T) { + archive, err := Generate("file", "content") + if err != nil { + t.Fatal(err) + } + if archive == nil { + t.Fatal("The generated archive should not be nil.") + } + + expectedFiles := [][]string{ + {"file", "content"}, + } + + tr := tar.NewReader(archive) + actualFiles := make([][]string, 0, 10) + i := 0 + for { + hdr, err := tr.Next() + if err == io.EOF { + break + } + if err != nil { + t.Fatal(err) + } + buf := new(bytes.Buffer) + buf.ReadFrom(tr) + content := buf.String() + actualFiles = append(actualFiles, []string{hdr.Name, content}) + i++ + } + if len(actualFiles) != len(expectedFiles) { + t.Fatalf("Number of expected file %d, got %d.", len(expectedFiles), len(actualFiles)) + } + for i := 0; i < len(expectedFiles); i++ { + actual := actualFiles[i] + expected := expectedFiles[i] + if actual[0] != expected[0] { + t.Fatalf("Expected name '%s', Actual name '%s'", expected[0], actual[0]) + } + if actual[1] != expected[1] { + t.Fatalf("Expected content '%s', Actual content '%s'", expected[1], actual[1]) + } + } +} diff --git a/pkg/broadcaster/buffered.go b/pkg/broadcaster/buffered.go new file mode 100644 index 0000000000..57f5f97862 --- /dev/null +++ b/pkg/broadcaster/buffered.go @@ -0,0 +1,167 @@ +package broadcaster + +import ( + "errors" + "io" + "sync" +) + +// Buffered keeps track of one or more observers watching the progress +// of an operation. For example, if multiple clients are trying to pull an +// image, they share a Buffered struct for the download operation. +type Buffered struct { + sync.Mutex + // c is a channel that observers block on, waiting for the operation + // to finish. + c chan struct{} + // cond is a condition variable used to wake up observers when there's + // new data available. + cond *sync.Cond + // history is a buffer of the progress output so far, so a new observer + // can catch up. The history is stored as a slice of separate byte + // slices, so that if the writer is a WriteFlusher, the flushes will + // happen in the right places. + history [][]byte + // wg is a WaitGroup used to wait for all writes to finish on Close + wg sync.WaitGroup + // result is the argument passed to the first call of Close, and + // returned to callers of Wait + result error +} + +// NewBuffered returns an initialized Buffered structure. +func NewBuffered() *Buffered { + b := &Buffered{ + c: make(chan struct{}), + } + b.cond = sync.NewCond(b) + return b +} + +// closed returns true if and only if the broadcaster has been closed +func (broadcaster *Buffered) closed() bool { + select { + case <-broadcaster.c: + return true + default: + return false + } +} + +// receiveWrites runs as a goroutine so that writes don't block the Write +// function. It writes the new data in broadcaster.history each time there's +// activity on the broadcaster.cond condition variable. +func (broadcaster *Buffered) receiveWrites(observer io.Writer) { + n := 0 + + broadcaster.Lock() + + // The condition variable wait is at the end of this loop, so that the + // first iteration will write the history so far. + for { + newData := broadcaster.history[n:] + // Make a copy of newData so we can release the lock + sendData := make([][]byte, len(newData), len(newData)) + copy(sendData, newData) + broadcaster.Unlock() + + for len(sendData) > 0 { + _, err := observer.Write(sendData[0]) + if err != nil { + broadcaster.wg.Done() + return + } + n++ + sendData = sendData[1:] + } + + broadcaster.Lock() + + // If we are behind, we need to catch up instead of waiting + // or handling a closure. + if len(broadcaster.history) != n { + continue + } + + // detect closure of the broadcast writer + if broadcaster.closed() { + broadcaster.Unlock() + broadcaster.wg.Done() + return + } + + broadcaster.cond.Wait() + + // Mutex is still locked as the loop continues + } +} + +// Write adds data to the history buffer, and also writes it to all current +// observers. +func (broadcaster *Buffered) Write(p []byte) (n int, err error) { + broadcaster.Lock() + defer broadcaster.Unlock() + + // Is the broadcaster closed? If so, the write should fail. + if broadcaster.closed() { + return 0, errors.New("attempted write to a closed broadcaster.Buffered") + } + + // Add message in p to the history slice + newEntry := make([]byte, len(p), len(p)) + copy(newEntry, p) + broadcaster.history = append(broadcaster.history, newEntry) + + broadcaster.cond.Broadcast() + + return len(p), nil +} + +// Add adds an observer to the broadcaster. The new observer receives the +// data from the history buffer, and also all subsequent data. +func (broadcaster *Buffered) Add(w io.Writer) error { + // The lock is acquired here so that Add can't race with Close + broadcaster.Lock() + defer broadcaster.Unlock() + + if broadcaster.closed() { + return errors.New("attempted to add observer to a closed broadcaster.Buffered") + } + + broadcaster.wg.Add(1) + go broadcaster.receiveWrites(w) + + return nil +} + +// CloseWithError signals to all observers that the operation has finished. Its +// argument is a result that should be returned to waiters blocking on Wait. +func (broadcaster *Buffered) CloseWithError(result error) { + broadcaster.Lock() + if broadcaster.closed() { + broadcaster.Unlock() + return + } + broadcaster.result = result + close(broadcaster.c) + broadcaster.cond.Broadcast() + broadcaster.Unlock() + + // Don't return until all writers have caught up. + broadcaster.wg.Wait() +} + +// Close signals to all observers that the operation has finished. It causes +// all calls to Wait to return nil. +func (broadcaster *Buffered) Close() { + broadcaster.CloseWithError(nil) +} + +// Wait blocks until the operation is marked as completed by the Close method, +// and all writer goroutines have completed. It returns the argument that was +// passed to Close. +func (broadcaster *Buffered) Wait() error { + <-broadcaster.c + broadcaster.wg.Wait() + return broadcaster.result +} diff --git a/pkg/broadcaster/unbuffered.go b/pkg/broadcaster/unbuffered.go new file mode 100644 index 0000000000..784d65d6fe --- /dev/null +++ b/pkg/broadcaster/unbuffered.go @@ -0,0 +1,49 @@ +package broadcaster + +import ( + "io" + "sync" +) + +// Unbuffered accumulates multiple io.WriteCloser by stream. +type Unbuffered struct { + mu sync.Mutex + writers []io.WriteCloser +} + +// Add adds new io.WriteCloser. +func (w *Unbuffered) Add(writer io.WriteCloser) { + w.mu.Lock() + w.writers = append(w.writers, writer) + w.mu.Unlock() +} + +// Write writes bytes to all writers. Failed writers will be evicted during +// this call. +func (w *Unbuffered) Write(p []byte) (n int, err error) { + w.mu.Lock() + var evict []int + for i, sw := range w.writers { + if n, err := sw.Write(p); err != nil || n != len(p) { + // On error, evict the writer + evict = append(evict, i) + } + } + for n, i := range evict { + w.writers = append(w.writers[:i-n], w.writers[i-n+1:]...) + } + w.mu.Unlock() + return len(p), nil +} + +// Clean closes and removes all writers. Last non-eol-terminated part of data +// will be saved. +func (w *Unbuffered) Clean() error { + w.mu.Lock() + for _, sw := range w.writers { + sw.Close() + } + w.writers = nil + w.mu.Unlock() + return nil +} diff --git a/pkg/broadcaster/unbuffered_test.go b/pkg/broadcaster/unbuffered_test.go new file mode 100644 index 0000000000..9f8e72bc0f --- /dev/null +++ b/pkg/broadcaster/unbuffered_test.go @@ -0,0 +1,162 @@ +package broadcaster + +import ( + "bytes" + "errors" + "strings" + + "testing" +) + +type dummyWriter struct { + buffer bytes.Buffer + failOnWrite bool +} + +func (dw *dummyWriter) Write(p []byte) (n int, err error) { + if dw.failOnWrite { + return 0, errors.New("Fake fail") + } + return dw.buffer.Write(p) +} + +func (dw *dummyWriter) String() string { + return dw.buffer.String() +} + +func (dw *dummyWriter) Close() error { + return nil +} + +func TestUnbuffered(t *testing.T) { + writer := new(Unbuffered) + + // Test 1: Both bufferA and bufferB should contain "foo" + bufferA := &dummyWriter{} + writer.Add(bufferA) + bufferB := &dummyWriter{} + writer.Add(bufferB) + writer.Write([]byte("foo")) + + if bufferA.String() != "foo" { + t.Errorf("Buffer contains %v", bufferA.String()) + } + + if bufferB.String() != "foo" { + t.Errorf("Buffer contains %v", bufferB.String()) + } + + // Test2: bufferA and bufferB should contain "foobar", + // while bufferC should only contain "bar" + bufferC := &dummyWriter{} + writer.Add(bufferC) + writer.Write([]byte("bar")) + + if bufferA.String() != "foobar" { + t.Errorf("Buffer contains %v", bufferA.String()) + } + + if bufferB.String() != "foobar" { + t.Errorf("Buffer contains %v", bufferB.String()) + } + + if bufferC.String() != "bar" { + t.Errorf("Buffer contains %v", bufferC.String()) + } + + // Test3: Test eviction on failure + bufferA.failOnWrite = true + writer.Write([]byte("fail")) + if bufferA.String() != "foobar" { + t.Errorf("Buffer contains %v", bufferA.String()) + } + if bufferC.String() != "barfail" { + t.Errorf("Buffer contains %v", bufferC.String()) + } + // Even though we reset the flag, no more writes should go in there + bufferA.failOnWrite = false + writer.Write([]byte("test")) + if bufferA.String() != "foobar" { + t.Errorf("Buffer contains %v", bufferA.String()) + } + if bufferC.String() != "barfailtest" { + t.Errorf("Buffer contains %v", bufferC.String()) + } + + // Test4: Test eviction on multiple simultaneous failures + bufferB.failOnWrite = true + bufferC.failOnWrite = true + bufferD := &dummyWriter{} + writer.Add(bufferD) + writer.Write([]byte("yo")) + writer.Write([]byte("ink")) + if strings.Contains(bufferB.String(), "yoink") { + t.Errorf("bufferB received write. contents: %q", bufferB) + } + if strings.Contains(bufferC.String(), "yoink") { + t.Errorf("bufferC received write. contents: %q", bufferC) + } + if g, w := bufferD.String(), "yoink"; g != w { + t.Errorf("bufferD = %q, want %q", g, w) + } + + writer.Clean() +} + +type devNullCloser int + +func (d devNullCloser) Close() error { + return nil +} + +func (d devNullCloser) Write(buf []byte) (int, error) { + return len(buf), nil +} + +// This test checks for races. It is only useful when run with the race detector. +func TestRaceUnbuffered(t *testing.T) { + writer := new(Unbuffered) + c := make(chan bool) + go func() { + writer.Add(devNullCloser(0)) + c <- true + }() + writer.Write([]byte("hello")) + <-c +} + +func BenchmarkUnbuffered(b *testing.B) { + writer := new(Unbuffered) + setUpWriter := func() { + for i := 0; i < 100; i++ { + writer.Add(devNullCloser(0)) + writer.Add(devNullCloser(0)) + writer.Add(devNullCloser(0)) + } + } + testLine := "Line that thinks that it is log line from docker" + var buf bytes.Buffer + for i := 0; i < 100; i++ { + buf.Write([]byte(testLine + "\n")) + } + // line without eol + buf.Write([]byte(testLine)) + testText := buf.Bytes() + b.SetBytes(int64(5 * len(testText))) + b.ResetTimer() + for i := 0; i < b.N; i++ { + b.StopTimer() + setUpWriter() + b.StartTimer() + + for j := 0; j < 5; j++ { + if _, err := writer.Write(testText); err != nil { + b.Fatal(err) + } + } + + b.StopTimer() + writer.Clean() + b.StartTimer() + } +} diff --git a/pkg/chrootarchive/archive.go b/pkg/chrootarchive/archive.go new file mode 100644 index 0000000000..8e8e15977f --- /dev/null +++ b/pkg/chrootarchive/archive.go @@ -0,0 +1,92 @@ +package chrootarchive + +import ( + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/system" +) + +var chrootArchiver = &archive.Archiver{Untar: Untar} + +// Untar reads a stream of bytes from `archive`, parses it as a tar archive, +// and unpacks it into the directory at `dest`. +// The archive may be compressed with one of the following algorithms: +// identity (uncompressed), gzip, bzip2, xz. +func Untar(tarArchive io.Reader, dest string, options *archive.TarOptions) error { + return untarHandler(tarArchive, dest, options, true) +} + +// UntarUncompressed reads a stream of bytes from `archive`, parses it as a tar archive, +// and unpacks it into the directory at `dest`. +// The archive must be an uncompressed stream. +func UntarUncompressed(tarArchive io.Reader, dest string, options *archive.TarOptions) error { + return untarHandler(tarArchive, dest, options, false) +} + +// Handler for teasing out the automatic decompression +func untarHandler(tarArchive io.Reader, dest string, options *archive.TarOptions, decompress bool) error { + + if tarArchive == nil { + return fmt.Errorf("Empty archive") + } + if options == nil { + options = &archive.TarOptions{} + } + if options.ExcludePatterns == nil { + options.ExcludePatterns = []string{} + } + + dest = filepath.Clean(dest) + if _, err := os.Stat(dest); os.IsNotExist(err) { + if err := system.MkdirAll(dest, 0777); err != nil { + return err + } + } + + r := ioutil.NopCloser(tarArchive) + if decompress { + decompressedArchive, err := archive.DecompressStream(tarArchive) + if err != nil { + return err + } + defer decompressedArchive.Close() + r = decompressedArchive + } + + return invokeUnpack(r, dest, options) +} + +// TarUntar is a convenience function which calls Tar and Untar, with the output of one piped into the other. +// If either Tar or Untar fails, TarUntar aborts and returns the error. +func TarUntar(src, dst string) error { + return chrootArchiver.TarUntar(src, dst) +} + +// CopyWithTar creates a tar archive of filesystem path `src`, and +// unpacks it at filesystem path `dst`. +// The archive is streamed directly with fixed buffering and no +// intermediary disk IO. +func CopyWithTar(src, dst string) error { + return chrootArchiver.CopyWithTar(src, dst) +} + +// CopyFileWithTar emulates the behavior of the 'cp' command-line +// for a single file. It copies a regular file from path `src` to +// path `dst`, and preserves all its metadata. +// +// If `dst` ends with a trailing slash '/' ('\' on Windows), the final +// destination path will be `dst/base(src)` or `dst\base(src)` +func CopyFileWithTar(src, dst string) (err error) { + return chrootArchiver.CopyFileWithTar(src, dst) +} + +// UntarPath is a convenience function which looks for an archive +// at filesystem path `src`, and unpacks it at `dst`. +func UntarPath(src, dst string) error { + return chrootArchiver.UntarPath(src, dst) +} diff --git a/pkg/chrootarchive/archive_test.go b/pkg/chrootarchive/archive_test.go new file mode 100644 index 0000000000..1d6c2b9220 --- /dev/null +++ b/pkg/chrootarchive/archive_test.go @@ -0,0 +1,381 @@ +package chrootarchive + +import ( + "bytes" + "fmt" + "hash/crc32" + "io" + "io/ioutil" + "os" + "path/filepath" + "strings" + "testing" + "time" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/reexec" + "github.com/docker/docker/pkg/system" +) + +func init() { + reexec.Init() +} + +func TestChrootTarUntar(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootTarUntar") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(src, "toto"), []byte("hello toto"), 0644); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(src, "lolo"), []byte("hello lolo"), 0644); err != nil { + t.Fatal(err) + } + stream, err := archive.Tar(src, archive.Uncompressed) + if err != nil { + t.Fatal(err) + } + dest := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(dest, 0700); err != nil { + t.Fatal(err) + } + if err := Untar(stream, dest, &archive.TarOptions{ExcludePatterns: []string{"lolo"}}); err != nil { + t.Fatal(err) + } +} + +// gh#10426: Verify the fix for having a huge excludes list (like on `docker load` with large # of +// local images) +func TestChrootUntarWithHugeExcludesList(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootUntarHugeExcludes") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(src, "toto"), []byte("hello toto"), 0644); err != nil { + t.Fatal(err) + } + stream, err := archive.Tar(src, archive.Uncompressed) + if err != nil { + t.Fatal(err) + } + dest := filepath.Join(tmpdir, "dest") + if err := system.MkdirAll(dest, 0700); err != nil { + t.Fatal(err) + } + options := &archive.TarOptions{} + //65534 entries of 64-byte strings ~= 4MB of environment space which should overflow + //on most systems when passed via environment or command line arguments + excludes := make([]string, 65534, 65534) + for i := 0; i < 65534; i++ { + excludes[i] = strings.Repeat(string(i), 64) + } + options.ExcludePatterns = excludes + if err := Untar(stream, dest, options); err != nil { + t.Fatal(err) + } +} + +func TestChrootUntarEmptyArchive(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootUntarEmptyArchive") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + if err := Untar(nil, tmpdir, nil); err == nil { + t.Fatal("expected error on empty archive") + } +} + +func prepareSourceDirectory(numberOfFiles int, targetPath string, makeSymLinks bool) (int, error) { + fileData := []byte("fooo") + for n := 0; n < numberOfFiles; n++ { + fileName := fmt.Sprintf("file-%d", n) + if err := ioutil.WriteFile(filepath.Join(targetPath, fileName), fileData, 0700); err != nil { + return 0, err + } + if makeSymLinks { + if err := os.Symlink(filepath.Join(targetPath, fileName), filepath.Join(targetPath, fileName+"-link")); err != nil { + return 0, err + } + } + } + totalSize := numberOfFiles * len(fileData) + return totalSize, nil +} + +func getHash(filename string) (uint32, error) { + stream, err := ioutil.ReadFile(filename) + if err != nil { + return 0, err + } + hash := crc32.NewIEEE() + hash.Write(stream) + return hash.Sum32(), nil +} + +func compareDirectories(src string, dest string) error { + changes, err := archive.ChangesDirs(dest, src) + if err != nil { + return err + } + if len(changes) > 0 { + return fmt.Errorf("Unexpected differences after untar: %v", changes) + } + return nil +} + +func compareFiles(src string, dest string) error { + srcHash, err := getHash(src) + if err != nil { + return err + } + destHash, err := getHash(dest) + if err != nil { + return err + } + if srcHash != destHash { + return fmt.Errorf("%s is different from %s", src, dest) + } + return nil +} + +func TestChrootTarUntarWithSymlink(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootTarUntarWithSymlink") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if _, err := prepareSourceDirectory(10, src, true); err != nil { + t.Fatal(err) + } + dest := filepath.Join(tmpdir, "dest") + if err := TarUntar(src, dest); err != nil { + t.Fatal(err) + } + if err := compareDirectories(src, dest); err != nil { + t.Fatal(err) + } +} + +func TestChrootCopyWithTar(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootCopyWithTar") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if _, err := prepareSourceDirectory(10, src, true); err != nil { + t.Fatal(err) + } + + // Copy directory + dest := filepath.Join(tmpdir, "dest") + if err := CopyWithTar(src, dest); err != nil { + t.Fatal(err) + } + if err := compareDirectories(src, dest); err != nil { + t.Fatal(err) + } + + // Copy file + srcfile := filepath.Join(src, "file-1") + dest = filepath.Join(tmpdir, "destFile") + destfile := filepath.Join(dest, "file-1") + if err := CopyWithTar(srcfile, destfile); err != nil { + t.Fatal(err) + } + if err := compareFiles(srcfile, destfile); err != nil { + t.Fatal(err) + } + + // Copy symbolic link + srcLinkfile := filepath.Join(src, "file-1-link") + dest = filepath.Join(tmpdir, "destSymlink") + destLinkfile := filepath.Join(dest, "file-1-link") + if err := CopyWithTar(srcLinkfile, destLinkfile); err != nil { + t.Fatal(err) + } + if err := compareFiles(srcLinkfile, destLinkfile); err != nil { + t.Fatal(err) + } +} + +func TestChrootCopyFileWithTar(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootCopyFileWithTar") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if _, err := prepareSourceDirectory(10, src, true); err != nil { + t.Fatal(err) + } + + // Copy directory + dest := filepath.Join(tmpdir, "dest") + if err := CopyFileWithTar(src, dest); err == nil { + t.Fatal("Expected error on copying directory") + } + + // Copy file + srcfile := filepath.Join(src, "file-1") + dest = filepath.Join(tmpdir, "destFile") + destfile := filepath.Join(dest, "file-1") + if err := CopyFileWithTar(srcfile, destfile); err != nil { + t.Fatal(err) + } + if err := compareFiles(srcfile, destfile); err != nil { + t.Fatal(err) + } + + // Copy symbolic link + srcLinkfile := filepath.Join(src, "file-1-link") + dest = filepath.Join(tmpdir, "destSymlink") + destLinkfile := filepath.Join(dest, "file-1-link") + if err := CopyFileWithTar(srcLinkfile, destLinkfile); err != nil { + t.Fatal(err) + } + if err := compareFiles(srcLinkfile, destLinkfile); err != nil { + t.Fatal(err) + } +} + +func TestChrootUntarPath(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootUntarPath") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if _, err := prepareSourceDirectory(10, src, true); err != nil { + t.Fatal(err) + } + dest := filepath.Join(tmpdir, "dest") + // Untar a directory + if err := UntarPath(src, dest); err == nil { + t.Fatal("Expected error on untaring a directory") + } + + // Untar a tar file + stream, err := archive.Tar(src, archive.Uncompressed) + if err != nil { + t.Fatal(err) + } + buf := new(bytes.Buffer) + buf.ReadFrom(stream) + tarfile := filepath.Join(tmpdir, "src.tar") + if err := ioutil.WriteFile(tarfile, buf.Bytes(), 0644); err != nil { + t.Fatal(err) + } + if err := UntarPath(tarfile, dest); err != nil { + t.Fatal(err) + } + if err := compareDirectories(src, dest); err != nil { + t.Fatal(err) + } +} + +type slowEmptyTarReader struct { + size int + offset int + chunkSize int +} + +// Read is a slow reader of an empty tar (like the output of "tar c --files-from /dev/null") +func (s *slowEmptyTarReader) Read(p []byte) (int, error) { + time.Sleep(100 * time.Millisecond) + count := s.chunkSize + if len(p) < s.chunkSize { + count = len(p) + } + for i := 0; i < count; i++ { + p[i] = 0 + } + s.offset += count + if s.offset > s.size { + return count, io.EOF + } + return count, nil +} + +func TestChrootUntarEmptyArchiveFromSlowReader(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootUntarEmptyArchiveFromSlowReader") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + dest := filepath.Join(tmpdir, "dest") + if err := system.MkdirAll(dest, 0700); err != nil { + t.Fatal(err) + } + stream := &slowEmptyTarReader{size: 10240, chunkSize: 1024} + if err := Untar(stream, dest, nil); err != nil { + t.Fatal(err) + } +} + +func TestChrootApplyEmptyArchiveFromSlowReader(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootApplyEmptyArchiveFromSlowReader") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + dest := filepath.Join(tmpdir, "dest") + if err := system.MkdirAll(dest, 0700); err != nil { + t.Fatal(err) + } + stream := &slowEmptyTarReader{size: 10240, chunkSize: 1024} + if _, err := ApplyLayer(dest, stream); err != nil { + t.Fatal(err) + } +} + +func TestChrootApplyDotDotFile(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "docker-TestChrootApplyDotDotFile") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + src := filepath.Join(tmpdir, "src") + if err := system.MkdirAll(src, 0700); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(filepath.Join(src, "..gitme"), []byte(""), 0644); err != nil { + t.Fatal(err) + } + stream, err := archive.Tar(src, archive.Uncompressed) + if err != nil { + t.Fatal(err) + } + dest := filepath.Join(tmpdir, "dest") + if err := system.MkdirAll(dest, 0700); err != nil { + t.Fatal(err) + } + if _, err := ApplyLayer(dest, stream); err != nil { + t.Fatal(err) + } +} diff --git a/pkg/chrootarchive/archive_unix.go b/pkg/chrootarchive/archive_unix.go new file mode 100644 index 0000000000..51a43f67d3 --- /dev/null +++ b/pkg/chrootarchive/archive_unix.go @@ -0,0 +1,91 @@ +// +build !windows + +package chrootarchive + +import ( + "bytes" + "encoding/json" + "flag" + "fmt" + "io" + "io/ioutil" + "os" + "runtime" + "syscall" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/reexec" +) + +func chroot(path string) error { + if err := syscall.Chroot(path); err != nil { + return err + } + return syscall.Chdir("/") +} + +// untar is the entry-point for docker-untar on re-exec. This is not used on +// Windows as it does not support chroot, hence no point sandboxing through +// chroot and rexec. +func untar() { + runtime.LockOSThread() + flag.Parse() + + var options *archive.TarOptions + + //read the options from the pipe "ExtraFiles" + if err := json.NewDecoder(os.NewFile(3, "options")).Decode(&options); err != nil { + fatal(err) + } + + if err := chroot(flag.Arg(0)); err != nil { + fatal(err) + } + + if err := archive.Unpack(os.Stdin, "/", options); err != nil { + fatal(err) + } + // fully consume stdin in case it is zero padded + flush(os.Stdin) + os.Exit(0) +} + +func invokeUnpack(decompressedArchive io.Reader, dest string, options *archive.TarOptions) error { + + // We can't pass a potentially large exclude list directly via cmd line + // because we easily overrun the kernel's max argument/environment size + // when the full image list is passed (e.g. when this is used by + // `docker load`). We will marshall the options via a pipe to the + // child + r, w, err := os.Pipe() + if err != nil { + return fmt.Errorf("Untar pipe failure: %v", err) + } + + cmd := reexec.Command("docker-untar", dest) + cmd.Stdin = decompressedArchive + + cmd.ExtraFiles = append(cmd.ExtraFiles, r) + output := bytes.NewBuffer(nil) + cmd.Stdout = output + cmd.Stderr = output + + if err := cmd.Start(); err != nil { + return fmt.Errorf("Untar error on re-exec cmd: %v", err) + } + //write the options to the pipe for the untar exec to read + if err := json.NewEncoder(w).Encode(options); err != nil { + return fmt.Errorf("Untar json encode to pipe failed: %v", err) + } + w.Close() + + if err := cmd.Wait(); err != nil { + // when `xz -d -c -q | docker-untar ...` failed on docker-untar side, + // we need to exhaust `xz`'s output, otherwise the `xz` side will be + // pending on write pipe forever + io.Copy(ioutil.Discard, decompressedArchive) + + return fmt.Errorf("Untar re-exec error: %v: output: %s", err, output) + } + return nil +} diff --git a/pkg/chrootarchive/archive_windows.go b/pkg/chrootarchive/archive_windows.go new file mode 100644 index 0000000000..0a500ed5c2 --- /dev/null +++ b/pkg/chrootarchive/archive_windows.go @@ -0,0 +1,22 @@ +package chrootarchive + +import ( + "io" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/longpath" +) + +// chroot is not supported by Windows +func chroot(path string) error { + return nil +} + +func invokeUnpack(decompressedArchive io.ReadCloser, + dest string, + options *archive.TarOptions) error { + // Windows is different to Linux here because Windows does not support + // chroot. Hence there is no point sandboxing a chrooted process to + // do the unpack. We call inline instead within the daemon process. + return archive.Unpack(decompressedArchive, longpath.AddPrefix(dest), options) +} diff --git a/pkg/chrootarchive/diff.go b/pkg/chrootarchive/diff.go new file mode 100644 index 0000000000..94131a6eb8 --- /dev/null +++ b/pkg/chrootarchive/diff.go @@ -0,0 +1,19 @@ +package chrootarchive + +import "github.com/docker/docker/pkg/archive" + +// ApplyLayer parses a diff in the standard layer format from `layer`, +// and applies it to the directory `dest`. The stream `layer` can only be +// uncompressed. +// Returns the size in bytes of the contents of the layer. +func ApplyLayer(dest string, layer archive.Reader) (size int64, err error) { + return applyLayerHandler(dest, layer, &archive.TarOptions{}, true) +} + +// ApplyUncompressedLayer parses a diff in the standard layer format from +// `layer`, and applies it to the directory `dest`. The stream `layer` +// can only be uncompressed. +// Returns the size in bytes of the contents of the layer. +func ApplyUncompressedLayer(dest string, layer archive.Reader, options *archive.TarOptions) (int64, error) { + return applyLayerHandler(dest, layer, options, false) +} diff --git a/pkg/chrootarchive/diff_unix.go b/pkg/chrootarchive/diff_unix.go new file mode 100644 index 0000000000..4196dd4b1a --- /dev/null +++ b/pkg/chrootarchive/diff_unix.go @@ -0,0 +1,118 @@ +//+build !windows + +package chrootarchive + +import ( + "bytes" + "encoding/json" + "flag" + "fmt" + "io/ioutil" + "os" + "path/filepath" + "runtime" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/reexec" + "github.com/docker/docker/pkg/system" +) + +type applyLayerResponse struct { + LayerSize int64 `json:"layerSize"` +} + +// applyLayer is the entry-point for docker-applylayer on re-exec. This is not +// used on Windows as it does not support chroot, hence no point sandboxing +// through chroot and rexec. +func applyLayer() { + + var ( + tmpDir = "" + err error + options *archive.TarOptions + ) + runtime.LockOSThread() + flag.Parse() + + if err := chroot(flag.Arg(0)); err != nil { + fatal(err) + } + + // We need to be able to set any perms + oldmask, err := system.Umask(0) + defer system.Umask(oldmask) + if err != nil { + fatal(err) + } + + if err := json.Unmarshal([]byte(os.Getenv("OPT")), &options); err != nil { + fatal(err) + } + + if tmpDir, err = ioutil.TempDir("/", "temp-docker-extract"); err != nil { + fatal(err) + } + + os.Setenv("TMPDIR", tmpDir) + size, err := archive.UnpackLayer("/", os.Stdin, options) + os.RemoveAll(tmpDir) + if err != nil { + fatal(err) + } + + encoder := json.NewEncoder(os.Stdout) + if err := encoder.Encode(applyLayerResponse{size}); err != nil { + fatal(fmt.Errorf("unable to encode layerSize JSON: %s", err)) + } + + flush(os.Stdout) + flush(os.Stdin) + os.Exit(0) +} + +// applyLayerHandler parses a diff in the standard layer format from `layer`, and +// applies it to the directory `dest`. Returns the size in bytes of the +// contents of the layer. +func applyLayerHandler(dest string, layer archive.Reader, options *archive.TarOptions, decompress bool) (size int64, err error) { + dest = filepath.Clean(dest) + if decompress { + decompressed, err := archive.DecompressStream(layer) + if err != nil { + return 0, err + } + defer decompressed.Close() + + layer = decompressed + } + if options == nil { + options = &archive.TarOptions{} + } + if options.ExcludePatterns == nil { + options.ExcludePatterns = []string{} + } + + data, err := json.Marshal(options) + if err != nil { + return 0, fmt.Errorf("ApplyLayer json encode: %v", err) + } + + cmd := reexec.Command("docker-applyLayer", dest) + cmd.Stdin = layer + cmd.Env = append(cmd.Env, fmt.Sprintf("OPT=%s", data)) + + outBuf, errBuf := new(bytes.Buffer), new(bytes.Buffer) + cmd.Stdout, cmd.Stderr = outBuf, errBuf + + if err = cmd.Run(); err != nil { + return 0, fmt.Errorf("ApplyLayer %s stdout: %s stderr: %s", err, outBuf, errBuf) + } + + // Stdout should be a valid JSON struct representing an applyLayerResponse. + response := applyLayerResponse{} + decoder := json.NewDecoder(outBuf) + if err = decoder.Decode(&response); err != nil { + return 0, fmt.Errorf("unable to decode ApplyLayer JSON response: %s", err) + } + + return response.LayerSize, nil +} diff --git a/pkg/chrootarchive/diff_windows.go b/pkg/chrootarchive/diff_windows.go new file mode 100644 index 0000000000..8e1830cb83 --- /dev/null +++ b/pkg/chrootarchive/diff_windows.go @@ -0,0 +1,44 @@ +package chrootarchive + +import ( + "fmt" + "io/ioutil" + "os" + "path/filepath" + + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/longpath" +) + +// applyLayerHandler parses a diff in the standard layer format from `layer`, and +// applies it to the directory `dest`. Returns the size in bytes of the +// contents of the layer. +func applyLayerHandler(dest string, layer archive.Reader, options *archive.TarOptions, decompress bool) (size int64, err error) { + dest = filepath.Clean(dest) + + // Ensure it is a Windows-style volume path + dest = longpath.AddPrefix(dest) + + if decompress { + decompressed, err := archive.DecompressStream(layer) + if err != nil { + return 0, err + } + defer decompressed.Close() + + layer = decompressed + } + + tmpDir, err := ioutil.TempDir(os.Getenv("temp"), "temp-docker-extract") + if err != nil { + return 0, fmt.Errorf("ApplyLayer failed to create temp-docker-extract under %s. %s", dest, err) + } + + s, err := archive.UnpackLayer(dest, layer, nil) + os.RemoveAll(tmpDir) + if err != nil { + return 0, fmt.Errorf("ApplyLayer %s failed UnpackLayer to %s", err, dest) + } + + return s, nil +} diff --git a/pkg/chrootarchive/init_unix.go b/pkg/chrootarchive/init_unix.go new file mode 100644 index 0000000000..49fcacce90 --- /dev/null +++ b/pkg/chrootarchive/init_unix.go @@ -0,0 +1,28 @@ +// +build !windows + +package chrootarchive + +import ( + "fmt" + "io" + "io/ioutil" + "os" + + "github.com/docker/docker/pkg/reexec" +) + +func init() { + reexec.Register("docker-applyLayer", applyLayer) + reexec.Register("docker-untar", untar) +} + +func fatal(err error) { + fmt.Fprint(os.Stderr, err) + os.Exit(1) +} + +// flush consumes all the bytes from the reader discarding +// any errors +func flush(r io.Reader) { + io.Copy(ioutil.Discard, r) +} diff --git a/pkg/chrootarchive/init_windows.go b/pkg/chrootarchive/init_windows.go new file mode 100644 index 0000000000..fa17c9bf83 --- /dev/null +++ b/pkg/chrootarchive/init_windows.go @@ -0,0 +1,4 @@ +package chrootarchive + +func init() { +} diff --git a/pkg/devicemapper/attach_loopback.go b/pkg/devicemapper/attach_loopback.go new file mode 100644 index 0000000000..6670bd4667 --- /dev/null +++ b/pkg/devicemapper/attach_loopback.go @@ -0,0 +1,129 @@ +// +build linux + +package devicemapper + +import ( + "fmt" + "os" + "syscall" + + "github.com/Sirupsen/logrus" +) + +func stringToLoopName(src string) [LoNameSize]uint8 { + var dst [LoNameSize]uint8 + copy(dst[:], src[:]) + return dst +} + +func getNextFreeLoopbackIndex() (int, error) { + f, err := os.OpenFile("/dev/loop-control", os.O_RDONLY, 0644) + if err != nil { + return 0, err + } + defer f.Close() + + index, err := ioctlLoopCtlGetFree(f.Fd()) + if index < 0 { + index = 0 + } + return index, err +} + +func openNextAvailableLoopback(index int, sparseFile *os.File) (loopFile *os.File, err error) { + // Start looking for a free /dev/loop + for { + target := fmt.Sprintf("/dev/loop%d", index) + index++ + + fi, err := os.Stat(target) + if err != nil { + if os.IsNotExist(err) { + logrus.Errorf("There are no more loopback devices available.") + } + return nil, ErrAttachLoopbackDevice + } + + if fi.Mode()&os.ModeDevice != os.ModeDevice { + logrus.Errorf("Loopback device %s is not a block device.", target) + continue + } + + // OpenFile adds O_CLOEXEC + loopFile, err = os.OpenFile(target, os.O_RDWR, 0644) + if err != nil { + logrus.Errorf("Error opening loopback device: %s", err) + return nil, ErrAttachLoopbackDevice + } + + // Try to attach to the loop file + if err := ioctlLoopSetFd(loopFile.Fd(), sparseFile.Fd()); err != nil { + loopFile.Close() + + // If the error is EBUSY, then try the next loopback + if err != syscall.EBUSY { + logrus.Errorf("Cannot set up loopback device %s: %s", target, err) + return nil, ErrAttachLoopbackDevice + } + + // Otherwise, we keep going with the loop + continue + } + // In case of success, we finished. Break the loop. + break + } + + // This can't happen, but let's be sure + if loopFile == nil { + logrus.Errorf("Unreachable code reached! Error attaching %s to a loopback device.", sparseFile.Name()) + return nil, ErrAttachLoopbackDevice + } + + return loopFile, nil +} + +// AttachLoopDevice attaches the given sparse file to the next +// available loopback device. It returns an opened *os.File. +func AttachLoopDevice(sparseName string) (loop *os.File, err error) { + + // Try to retrieve the next available loopback device via syscall. + // If it fails, we discard error and start loopking for a + // loopback from index 0. + startIndex, err := getNextFreeLoopbackIndex() + if err != nil { + logrus.Debugf("Error retrieving the next available loopback: %s", err) + } + + // OpenFile adds O_CLOEXEC + sparseFile, err := os.OpenFile(sparseName, os.O_RDWR, 0644) + if err != nil { + logrus.Errorf("Error opening sparse file %s: %s", sparseName, err) + return nil, ErrAttachLoopbackDevice + } + defer sparseFile.Close() + + loopFile, err := openNextAvailableLoopback(startIndex, sparseFile) + if err != nil { + return nil, err + } + + // Set the status of the loopback device + loopInfo := &loopInfo64{ + loFileName: stringToLoopName(loopFile.Name()), + loOffset: 0, + loFlags: LoFlagsAutoClear, + } + + if err := ioctlLoopSetStatus64(loopFile.Fd(), loopInfo); err != nil { + logrus.Errorf("Cannot set up loopback device info: %s", err) + + // If the call failed, then free the loopback device + if err := ioctlLoopClrFd(loopFile.Fd()); err != nil { + logrus.Errorf("Error while cleaning up the loopback device") + } + loopFile.Close() + return nil, ErrAttachLoopbackDevice + } + + return loopFile, nil +} diff --git a/pkg/devicemapper/devmapper.go b/pkg/devicemapper/devmapper.go new file mode 100644 index 0000000000..136dd6bbd0 --- /dev/null +++ b/pkg/devicemapper/devmapper.go @@ -0,0 +1,862 @@ +// +build linux + +package devicemapper + +import ( + "errors" + "fmt" + "os" + "runtime" + "syscall" + "unsafe" + + "github.com/Sirupsen/logrus" +) + +// DevmapperLogger defines methods for logging with devicemapper. +type DevmapperLogger interface { + DMLog(level int, file string, line int, dmError int, message string) +} + +const ( + deviceCreate TaskType = iota + deviceReload + deviceRemove + deviceRemoveAll + deviceSuspend + deviceResume + deviceInfo + deviceDeps + deviceRename + deviceVersion + deviceStatus + deviceTable + deviceWaitevent + deviceList + deviceClear + deviceMknodes + deviceListVersions + deviceTargetMsg + deviceSetGeometry +) + +const ( + addNodeOnResume AddNodeType = iota + addNodeOnCreate +) + +// List of errors returned when using devicemapper. +var ( + ErrTaskRun = errors.New("dm_task_run failed") + ErrTaskSetName = errors.New("dm_task_set_name failed") + ErrTaskSetMessage = errors.New("dm_task_set_message failed") + ErrTaskSetAddNode = errors.New("dm_task_set_add_node failed") + ErrTaskSetRo = errors.New("dm_task_set_ro failed") + ErrTaskAddTarget = errors.New("dm_task_add_target failed") + ErrTaskSetSector = errors.New("dm_task_set_sector failed") + ErrTaskGetDeps = errors.New("dm_task_get_deps failed") + ErrTaskGetInfo = errors.New("dm_task_get_info failed") + ErrTaskGetDriverVersion = errors.New("dm_task_get_driver_version failed") + ErrTaskDeferredRemove = errors.New("dm_task_deferred_remove failed") + ErrTaskSetCookie = errors.New("dm_task_set_cookie failed") + ErrNilCookie = errors.New("cookie ptr can't be nil") + ErrAttachLoopbackDevice = errors.New("loopback mounting failed") + ErrGetBlockSize = errors.New("Can't get block size") + ErrUdevWait = errors.New("wait on udev cookie failed") + ErrSetDevDir = errors.New("dm_set_dev_dir failed") + ErrGetLibraryVersion = errors.New("dm_get_library_version failed") + ErrCreateRemoveTask = errors.New("Can't create task of type deviceRemove") + ErrRunRemoveDevice = errors.New("running RemoveDevice failed") + ErrInvalidAddNode = errors.New("Invalid AddNode type") + ErrGetLoopbackBackingFile = errors.New("Unable to get loopback backing file") + ErrLoopbackSetCapacity = errors.New("Unable set loopback capacity") + ErrBusy = errors.New("Device is Busy") + ErrDeviceIDExists = errors.New("Device Id Exists") + ErrEnxio = errors.New("No such device or address") +) + +var ( + dmSawBusy bool + dmSawExist bool + dmSawEnxio bool // No Such Device or Address +) + +type ( + // Task represents a devicemapper task (like lvcreate, etc.) ; a task is needed for each ioctl + // command to execute. + Task struct { + unmanaged *cdmTask + } + // Deps represents dependents (layer) of a device. + Deps struct { + Count uint32 + Filler uint32 + Device []uint64 + } + // Info represents information about a device. + Info struct { + Exists int + Suspended int + LiveTable int + InactiveTable int + OpenCount int32 + EventNr uint32 + Major uint32 + Minor uint32 + ReadOnly int + TargetCount int32 + DeferredRemove int + } + // TaskType represents a type of task + TaskType int + // AddNodeType represents a type of node to be added + AddNodeType int +) + +// DeviceIDExists returns whether error conveys the information about device Id already +// exist or not. This will be true if device creation or snap creation +// operation fails if device or snap device already exists in pool. +// Current implementation is little crude as it scans the error string +// for exact pattern match. Replacing it with more robust implementation +// is desirable. +func DeviceIDExists(err error) bool { + return fmt.Sprint(err) == fmt.Sprint(ErrDeviceIDExists) +} + +func (t *Task) destroy() { + if t != nil { + DmTaskDestroy(t.unmanaged) + runtime.SetFinalizer(t, nil) + } +} + +// TaskCreateNamed is a convenience function for TaskCreate when a name +// will be set on the task as well +func TaskCreateNamed(t TaskType, name string) (*Task, error) { + task := TaskCreate(t) + if task == nil { + return nil, fmt.Errorf("Can't create task of type %d", int(t)) + } + if err := task.setName(name); err != nil { + return nil, fmt.Errorf("Can't set task name %s", name) + } + return task, nil +} + +// TaskCreate initializes a devicemapper task of tasktype +func TaskCreate(tasktype TaskType) *Task { + Ctask := DmTaskCreate(int(tasktype)) + if Ctask == nil { + return nil + } + task := &Task{unmanaged: Ctask} + runtime.SetFinalizer(task, (*Task).destroy) + return task +} + +func (t *Task) run() error { + if res := DmTaskRun(t.unmanaged); res != 1 { + return ErrTaskRun + } + return nil +} + +func (t *Task) setName(name string) error { + if res := DmTaskSetName(t.unmanaged, name); res != 1 { + return ErrTaskSetName + } + return nil +} + +func (t *Task) setMessage(message string) error { + if res := DmTaskSetMessage(t.unmanaged, message); res != 1 { + return ErrTaskSetMessage + } + return nil +} + +func (t *Task) setSector(sector uint64) error { + if res := DmTaskSetSector(t.unmanaged, sector); res != 1 { + return ErrTaskSetSector + } + return nil +} + +func (t *Task) setCookie(cookie *uint, flags uint16) error { + if cookie == nil { + return ErrNilCookie + } + if res := DmTaskSetCookie(t.unmanaged, cookie, flags); res != 1 { + return ErrTaskSetCookie + } + return nil +} + +func (t *Task) setAddNode(addNode AddNodeType) error { + if addNode != addNodeOnResume && addNode != addNodeOnCreate { + return ErrInvalidAddNode + } + if res := DmTaskSetAddNode(t.unmanaged, addNode); res != 1 { + return ErrTaskSetAddNode + } + return nil +} + +func (t *Task) setRo() error { + if res := DmTaskSetRo(t.unmanaged); res != 1 { + return ErrTaskSetRo + } + return nil +} + +func (t *Task) addTarget(start, size uint64, ttype, params string) error { + if res := DmTaskAddTarget(t.unmanaged, start, size, + ttype, params); res != 1 { + return ErrTaskAddTarget + } + return nil +} + +func (t *Task) getDeps() (*Deps, error) { + var deps *Deps + if deps = DmTaskGetDeps(t.unmanaged); deps == nil { + return nil, ErrTaskGetDeps + } + return deps, nil +} + +func (t *Task) getInfo() (*Info, error) { + info := &Info{} + if res := DmTaskGetInfo(t.unmanaged, info); res != 1 { + return nil, ErrTaskGetInfo + } + return info, nil +} + +func (t *Task) getInfoWithDeferred() (*Info, error) { + info := &Info{} + if res := DmTaskGetInfoWithDeferred(t.unmanaged, info); res != 1 { + return nil, ErrTaskGetInfo + } + return info, nil +} + +func (t *Task) getDriverVersion() (string, error) { + res := DmTaskGetDriverVersion(t.unmanaged) + if res == "" { + return "", ErrTaskGetDriverVersion + } + return res, nil +} + +func (t *Task) getNextTarget(next unsafe.Pointer) (nextPtr unsafe.Pointer, start uint64, + length uint64, targetType string, params string) { + + return DmGetNextTarget(t.unmanaged, next, &start, &length, + &targetType, ¶ms), + start, length, targetType, params +} + +func getLoopbackBackingFile(file *os.File) (uint64, uint64, error) { + loopInfo, err := ioctlLoopGetStatus64(file.Fd()) + if err != nil { + logrus.Errorf("Error get loopback backing file: %s", err) + return 0, 0, ErrGetLoopbackBackingFile + } + return loopInfo.loDevice, loopInfo.loInode, nil +} + +// LoopbackSetCapacity reloads the size for the loopback device. +func LoopbackSetCapacity(file *os.File) error { + if err := ioctlLoopSetCapacity(file.Fd(), 0); err != nil { + logrus.Errorf("Error loopbackSetCapacity: %s", err) + return ErrLoopbackSetCapacity + } + return nil +} + +// FindLoopDeviceFor returns a loopback device file for the specified file which +// is backing file of a loop back device. +func FindLoopDeviceFor(file *os.File) *os.File { + stat, err := file.Stat() + if err != nil { + return nil + } + targetInode := stat.Sys().(*syscall.Stat_t).Ino + targetDevice := stat.Sys().(*syscall.Stat_t).Dev + + for i := 0; true; i++ { + path := fmt.Sprintf("/dev/loop%d", i) + + file, err := os.OpenFile(path, os.O_RDWR, 0) + if err != nil { + if os.IsNotExist(err) { + return nil + } + + // Ignore all errors until the first not-exist + // we want to continue looking for the file + continue + } + + dev, inode, err := getLoopbackBackingFile(file) + if err == nil && dev == targetDevice && inode == targetInode { + return file + } + file.Close() + } + + return nil +} + +// UdevWait waits for any processes that are waiting for udev to complete the specified cookie. +func UdevWait(cookie *uint) error { + if res := DmUdevWait(*cookie); res != 1 { + logrus.Debugf("Failed to wait on udev cookie %d", *cookie) + return ErrUdevWait + } + return nil +} + +// LogInitVerbose is an interface to initialize the verbose logger for the device mapper library. +func LogInitVerbose(level int) { + DmLogInitVerbose(level) +} + +var dmLogger DevmapperLogger + +// LogInit initializes the logger for the device mapper library. +func LogInit(logger DevmapperLogger) { + dmLogger = logger + LogWithErrnoInit() +} + +// SetDevDir sets the dev folder for the device mapper library (usually /dev). +func SetDevDir(dir string) error { + if res := DmSetDevDir(dir); res != 1 { + logrus.Debugf("Error dm_set_dev_dir") + return ErrSetDevDir + } + return nil +} + +// GetLibraryVersion returns the device mapper library version. +func GetLibraryVersion() (string, error) { + var version string + if res := DmGetLibraryVersion(&version); res != 1 { + return "", ErrGetLibraryVersion + } + return version, nil +} + +// UdevSyncSupported returns whether device-mapper is able to sync with udev +// +// This is essential otherwise race conditions can arise where both udev and +// device-mapper attempt to create and destroy devices. +func UdevSyncSupported() bool { + return DmUdevGetSyncSupport() != 0 +} + +// UdevSetSyncSupport allows setting whether the udev sync should be enabled. +// The return bool indicates the state of whether the sync is enabled. +func UdevSetSyncSupport(enable bool) bool { + if enable { + DmUdevSetSyncSupport(1) + } else { + DmUdevSetSyncSupport(0) + } + + return UdevSyncSupported() +} + +// CookieSupported returns whether the version of device-mapper supports the +// use of cookie's in the tasks. +// This is largely a lower level call that other functions use. +func CookieSupported() bool { + return DmCookieSupported() != 0 +} + +// RemoveDevice is a useful helper for cleaning up a device. +func RemoveDevice(name string) error { + task, err := TaskCreateNamed(deviceRemove, name) + if task == nil { + return err + } + + var cookie uint + if err := task.setCookie(&cookie, 0); err != nil { + return fmt.Errorf("Can not set cookie: %s", err) + } + defer UdevWait(&cookie) + + dmSawBusy = false // reset before the task is run + if err = task.run(); err != nil { + if dmSawBusy { + return ErrBusy + } + return fmt.Errorf("Error running RemoveDevice %s", err) + } + + return nil +} + +// RemoveDeviceDeferred is a useful helper for cleaning up a device, but deferred. +func RemoveDeviceDeferred(name string) error { + logrus.Debugf("[devmapper] RemoveDeviceDeferred START(%s)", name) + defer logrus.Debugf("[devmapper] RemoveDeviceDeferred END(%s)", name) + task, err := TaskCreateNamed(deviceRemove, name) + if task == nil { + return err + } + + if err := DmTaskDeferredRemove(task.unmanaged); err != 1 { + return ErrTaskDeferredRemove + } + + if err = task.run(); err != nil { + return fmt.Errorf("Error running RemoveDeviceDeferred %s", err) + } + + return nil +} + +// CancelDeferredRemove cancels a deferred remove for a device. +func CancelDeferredRemove(deviceName string) error { + task, err := TaskCreateNamed(deviceTargetMsg, deviceName) + if task == nil { + return err + } + + if err := task.setSector(0); err != nil { + return fmt.Errorf("Can't set sector %s", err) + } + + if err := task.setMessage(fmt.Sprintf("@cancel_deferred_remove")); err != nil { + return fmt.Errorf("Can't set message %s", err) + } + + dmSawBusy = false + dmSawEnxio = false + if err := task.run(); err != nil { + // A device might be being deleted already + if dmSawBusy { + return ErrBusy + } else if dmSawEnxio { + return ErrEnxio + } + return fmt.Errorf("Error running CancelDeferredRemove %s", err) + + } + return nil +} + +// GetBlockDeviceSize returns the size of a block device identified by the specified file. +func GetBlockDeviceSize(file *os.File) (uint64, error) { + size, err := ioctlBlkGetSize64(file.Fd()) + if err != nil { + logrus.Errorf("Error getblockdevicesize: %s", err) + return 0, ErrGetBlockSize + } + return uint64(size), nil +} + +// BlockDeviceDiscard runs discard for the given path. +// This is used as a workaround for the kernel not discarding block so +// on the thin pool when we remove a thinp device, so we do it +// manually +func BlockDeviceDiscard(path string) error { + file, err := os.OpenFile(path, os.O_RDWR, 0) + if err != nil { + return err + } + defer file.Close() + + size, err := GetBlockDeviceSize(file) + if err != nil { + return err + } + + if err := ioctlBlkDiscard(file.Fd(), 0, size); err != nil { + return err + } + + // Without this sometimes the remove of the device that happens after + // discard fails with EBUSY. + syscall.Sync() + + return nil +} + +// CreatePool is the programmatic example of "dmsetup create". +// It creates a device with the specified poolName, data and metadata file and block size. +func CreatePool(poolName string, dataFile, metadataFile *os.File, poolBlockSize uint32) error { + task, err := TaskCreateNamed(deviceCreate, poolName) + if task == nil { + return err + } + + size, err := GetBlockDeviceSize(dataFile) + if err != nil { + return fmt.Errorf("Can't get data size %s", err) + } + + params := fmt.Sprintf("%s %s %d 32768 1 skip_block_zeroing", metadataFile.Name(), dataFile.Name(), poolBlockSize) + if err := task.addTarget(0, size/512, "thin-pool", params); err != nil { + return fmt.Errorf("Can't add target %s", err) + } + + var cookie uint + var flags uint16 + flags = DmUdevDisableSubsystemRulesFlag | DmUdevDisableDiskRulesFlag | DmUdevDisableOtherRulesFlag + if err := task.setCookie(&cookie, flags); err != nil { + return fmt.Errorf("Can't set cookie %s", err) + } + defer UdevWait(&cookie) + + if err := task.run(); err != nil { + return fmt.Errorf("Error running deviceCreate (CreatePool) %s", err) + } + + return nil +} + +// ReloadPool is the programmatic example of "dmsetup reload". +// It reloads the table with the specified poolName, data and metadata file and block size. +func ReloadPool(poolName string, dataFile, metadataFile *os.File, poolBlockSize uint32) error { + task, err := TaskCreateNamed(deviceReload, poolName) + if task == nil { + return err + } + + size, err := GetBlockDeviceSize(dataFile) + if err != nil { + return fmt.Errorf("Can't get data size %s", err) + } + + params := fmt.Sprintf("%s %s %d 32768 1 skip_block_zeroing", metadataFile.Name(), dataFile.Name(), poolBlockSize) + if err := task.addTarget(0, size/512, "thin-pool", params); err != nil { + return fmt.Errorf("Can't add target %s", err) + } + + if err := task.run(); err != nil { + return fmt.Errorf("Error running deviceCreate %s", err) + } + + return nil +} + +// GetDeps is the programmatic example of "dmsetup deps". +// It outputs a list of devices referenced by the live table for the specified device. +func GetDeps(name string) (*Deps, error) { + task, err := TaskCreateNamed(deviceDeps, name) + if task == nil { + return nil, err + } + if err := task.run(); err != nil { + return nil, err + } + return task.getDeps() +} + +// GetInfo is the programmatic example of "dmsetup info". +// It outputs some brief information about the device. +func GetInfo(name string) (*Info, error) { + task, err := TaskCreateNamed(deviceInfo, name) + if task == nil { + return nil, err + } + if err := task.run(); err != nil { + return nil, err + } + return task.getInfo() +} + +// GetInfoWithDeferred is the programmatic example of "dmsetup info", but deferred. +// It outputs some brief information about the device. +func GetInfoWithDeferred(name string) (*Info, error) { + task, err := TaskCreateNamed(deviceInfo, name) + if task == nil { + return nil, err + } + if err := task.run(); err != nil { + return nil, err + } + return task.getInfoWithDeferred() +} + +// GetDriverVersion is the programmatic example of "dmsetup version". +// It outputs version information of the driver. +func GetDriverVersion() (string, error) { + task := TaskCreate(deviceVersion) + if task == nil { + return "", fmt.Errorf("Can't create deviceVersion task") + } + if err := task.run(); err != nil { + return "", err + } + return task.getDriverVersion() +} + +// GetStatus is the programmatic example of "dmsetup status". +// It outputs status information for the specified device name. +func GetStatus(name string) (uint64, uint64, string, string, error) { + task, err := TaskCreateNamed(deviceStatus, name) + if task == nil { + logrus.Debugf("GetStatus: Error TaskCreateNamed: %s", err) + return 0, 0, "", "", err + } + if err := task.run(); err != nil { + logrus.Debugf("GetStatus: Error Run: %s", err) + return 0, 0, "", "", err + } + + devinfo, err := task.getInfo() + if err != nil { + logrus.Debugf("GetStatus: Error GetInfo: %s", err) + return 0, 0, "", "", err + } + if devinfo.Exists == 0 { + logrus.Debugf("GetStatus: Non existing device %s", name) + return 0, 0, "", "", fmt.Errorf("Non existing device %s", name) + } + + _, start, length, targetType, params := task.getNextTarget(unsafe.Pointer(nil)) + return start, length, targetType, params, nil +} + +// GetTable is the programmatic example for "dmsetup table". +// It outputs the current table for the specified device name. +func GetTable(name string) (uint64, uint64, string, string, error) { + task, err := TaskCreateNamed(deviceTable, name) + if task == nil { + logrus.Debugf("GetTable: Error TaskCreateNamed: %s", err) + return 0, 0, "", "", err + } + if err := task.run(); err != nil { + logrus.Debugf("GetTable: Error Run: %s", err) + return 0, 0, "", "", err + } + + devinfo, err := task.getInfo() + if err != nil { + logrus.Debugf("GetTable: Error GetInfo: %s", err) + return 0, 0, "", "", err + } + if devinfo.Exists == 0 { + logrus.Debugf("GetTable: Non existing device %s", name) + return 0, 0, "", "", fmt.Errorf("Non existing device %s", name) + } + + _, start, length, targetType, params := task.getNextTarget(unsafe.Pointer(nil)) + return start, length, targetType, params, nil +} + +// SetTransactionID sets a transaction id for the specified device name. +func SetTransactionID(poolName string, oldID uint64, newID uint64) error { + task, err := TaskCreateNamed(deviceTargetMsg, poolName) + if task == nil { + return err + } + + if err := task.setSector(0); err != nil { + return fmt.Errorf("Can't set sector %s", err) + } + + if err := task.setMessage(fmt.Sprintf("set_transaction_id %d %d", oldID, newID)); err != nil { + return fmt.Errorf("Can't set message %s", err) + } + + if err := task.run(); err != nil { + return fmt.Errorf("Error running SetTransactionID %s", err) + } + return nil +} + +// SuspendDevice is the programmatic example of "dmsetup suspend". +// It suspends the specified device. +func SuspendDevice(name string) error { + task, err := TaskCreateNamed(deviceSuspend, name) + if task == nil { + return err + } + if err := task.run(); err != nil { + return fmt.Errorf("Error running deviceSuspend %s", err) + } + return nil +} + +// ResumeDevice is the programmatic example of "dmsetup resume". +// It un-suspends the specified device. +func ResumeDevice(name string) error { + task, err := TaskCreateNamed(deviceResume, name) + if task == nil { + return err + } + + var cookie uint + if err := task.setCookie(&cookie, 0); err != nil { + return fmt.Errorf("Can't set cookie %s", err) + } + defer UdevWait(&cookie) + + if err := task.run(); err != nil { + return fmt.Errorf("Error running deviceResume %s", err) + } + + return nil +} + +// CreateDevice creates a device with the specified poolName with the specified device id. +func CreateDevice(poolName string, deviceID int) error { + logrus.Debugf("[devmapper] CreateDevice(poolName=%v, deviceID=%v)", poolName, deviceID) + task, err := TaskCreateNamed(deviceTargetMsg, poolName) + if task == nil { + return err + } + + if err := task.setSector(0); err != nil { + return fmt.Errorf("Can't set sector %s", err) + } + + if err := task.setMessage(fmt.Sprintf("create_thin %d", deviceID)); err != nil { + return fmt.Errorf("Can't set message %s", err) + } + + dmSawExist = false // reset before the task is run + if err := task.run(); err != nil { + // Caller wants to know about ErrDeviceIDExists so that it can try with a different device id. + if dmSawExist { + return ErrDeviceIDExists + } + + return fmt.Errorf("Error running CreateDevice %s", err) + + } + return nil +} + +// DeleteDevice deletes a device with the specified poolName with the specified device id. +func DeleteDevice(poolName string, deviceID int) error { + task, err := TaskCreateNamed(deviceTargetMsg, poolName) + if task == nil { + return err + } + + if err := task.setSector(0); err != nil { + return fmt.Errorf("Can't set sector %s", err) + } + + if err := task.setMessage(fmt.Sprintf("delete %d", deviceID)); err != nil { + return fmt.Errorf("Can't set message %s", err) + } + + dmSawBusy = false + if err := task.run(); err != nil { + if dmSawBusy { + return ErrBusy + } + return fmt.Errorf("Error running DeleteDevice %s", err) + } + return nil +} + +// ActivateDevice activates the device identified by the specified +// poolName, name and deviceID with the specified size. +func ActivateDevice(poolName string, name string, deviceID int, size uint64) error { + return activateDevice(poolName, name, deviceID, size, "") +} + +// ActivateDeviceWithExternal activates the device identified by the specified +// poolName, name and deviceID with the specified size. +func ActivateDeviceWithExternal(poolName string, name string, deviceID int, size uint64, external string) error { + return activateDevice(poolName, name, deviceID, size, external) +} + +func activateDevice(poolName string, name string, deviceID int, size uint64, external string) error { + task, err := TaskCreateNamed(deviceCreate, name) + if task == nil { + return err + } + + var params string + if len(external) > 0 { + params = fmt.Sprintf("%s %d %s", poolName, deviceID, external) + } else { + params = fmt.Sprintf("%s %d", poolName, deviceID) + } + if err := task.addTarget(0, size/512, "thin", params); err != nil { + return fmt.Errorf("Can't add target %s", err) + } + if err := task.setAddNode(addNodeOnCreate); err != nil { + return fmt.Errorf("Can't add node %s", err) + } + + var cookie uint + if err := task.setCookie(&cookie, 0); err != nil { + return fmt.Errorf("Can't set cookie %s", err) + } + + defer UdevWait(&cookie) + + if err := task.run(); err != nil { + return fmt.Errorf("Error running deviceCreate (ActivateDevice) %s", err) + } + + return nil +} + +// CreateSnapDevice creates a snapshot based on the device identified by the baseName and baseDeviceId, +func CreateSnapDevice(poolName string, deviceID int, baseName string, baseDeviceID int) error { + devinfo, _ := GetInfo(baseName) + doSuspend := devinfo != nil && devinfo.Exists != 0 + + if doSuspend { + if err := SuspendDevice(baseName); err != nil { + return err + } + } + + task, err := TaskCreateNamed(deviceTargetMsg, poolName) + if task == nil { + if doSuspend { + ResumeDevice(baseName) + } + return err + } + + if err := task.setSector(0); err != nil { + if doSuspend { + ResumeDevice(baseName) + } + return fmt.Errorf("Can't set sector %s", err) + } + + if err := task.setMessage(fmt.Sprintf("create_snap %d %d", deviceID, baseDeviceID)); err != nil { + if doSuspend { + ResumeDevice(baseName) + } + return fmt.Errorf("Can't set message %s", err) + } + + dmSawExist = false // reset before the task is run + if err := task.run(); err != nil { + if doSuspend { + ResumeDevice(baseName) + } + // Caller wants to know about ErrDeviceIDExists so that it can try with a different device id. + if dmSawExist { + return ErrDeviceIDExists + } + + return fmt.Errorf("Error running deviceCreate (createSnapDevice) %s", err) + + } + + if doSuspend { + if err := ResumeDevice(baseName); err != nil { + return err + } + } + + return nil +} diff --git a/pkg/devicemapper/devmapper_log.go b/pkg/devicemapper/devmapper_log.go new file mode 100644 index 0000000000..8477e36fec --- /dev/null +++ b/pkg/devicemapper/devmapper_log.go @@ -0,0 +1,35 @@ +// +build linux + +package devicemapper + +import "C" + +import ( + "strings" +) + +// Due to the way cgo works this has to be in a separate file, as devmapper.go has +// definitions in the cgo block, which is incompatible with using "//export" + +// DevmapperLogCallback exports the devmapper log callback for cgo. +//export DevmapperLogCallback +func DevmapperLogCallback(level C.int, file *C.char, line C.int, dmErrnoOrClass C.int, message *C.char) { + msg := C.GoString(message) + if level < 7 { + if strings.Contains(msg, "busy") { + dmSawBusy = true + } + + if strings.Contains(msg, "File exists") { + dmSawExist = true + } + + if strings.Contains(msg, "No such device or address") { + dmSawEnxio = true + } + } + + if dmLogger != nil { + dmLogger.DMLog(int(level), C.GoString(file), int(line), int(dmErrnoOrClass), msg) + } +} diff --git a/pkg/devicemapper/devmapper_wrapper.go b/pkg/devicemapper/devmapper_wrapper.go new file mode 100644 index 0000000000..a99c32952f --- /dev/null +++ b/pkg/devicemapper/devmapper_wrapper.go @@ -0,0 +1,293 @@ +// +build linux + +package devicemapper + +/* +#cgo LDFLAGS: -L. -ldevmapper +#include +#include // FIXME: present only for defines, maybe we can remove it? +#include // FIXME: present only for BLKGETSIZE64, maybe we can remove it? + +#ifndef LOOP_CTL_GET_FREE + #define LOOP_CTL_GET_FREE 0x4C82 +#endif + +#ifndef LO_FLAGS_PARTSCAN + #define LO_FLAGS_PARTSCAN 8 +#endif + +// FIXME: Can't we find a way to do the logging in pure Go? +extern void DevmapperLogCallback(int level, char *file, int line, int dm_errno_or_class, char *str); + +static void log_cb(int level, const char *file, int line, int dm_errno_or_class, const char *f, ...) +{ + char buffer[256]; + va_list ap; + + va_start(ap, f); + vsnprintf(buffer, 256, f, ap); + va_end(ap); + + DevmapperLogCallback(level, (char *)file, line, dm_errno_or_class, buffer); +} + +static void log_with_errno_init() +{ + dm_log_with_errno_init(log_cb); +} +*/ +import "C" + +import ( + "reflect" + "unsafe" +) + +type ( + cdmTask C.struct_dm_task + + cLoopInfo64 C.struct_loop_info64 + loopInfo64 struct { + loDevice uint64 /* ioctl r/o */ + loInode uint64 /* ioctl r/o */ + loRdevice uint64 /* ioctl r/o */ + loOffset uint64 + loSizelimit uint64 /* bytes, 0 == max available */ + loNumber uint32 /* ioctl r/o */ + loEncryptType uint32 + loEncryptKeySize uint32 /* ioctl w/o */ + loFlags uint32 /* ioctl r/o */ + loFileName [LoNameSize]uint8 + loCryptName [LoNameSize]uint8 + loEncryptKey [LoKeySize]uint8 /* ioctl w/o */ + loInit [2]uint64 + } +) + +// IOCTL consts +const ( + BlkGetSize64 = C.BLKGETSIZE64 + BlkDiscard = C.BLKDISCARD + + LoopSetFd = C.LOOP_SET_FD + LoopCtlGetFree = C.LOOP_CTL_GET_FREE + LoopGetStatus64 = C.LOOP_GET_STATUS64 + LoopSetStatus64 = C.LOOP_SET_STATUS64 + LoopClrFd = C.LOOP_CLR_FD + LoopSetCapacity = C.LOOP_SET_CAPACITY +) + +// LOOP consts. +const ( + LoFlagsAutoClear = C.LO_FLAGS_AUTOCLEAR + LoFlagsReadOnly = C.LO_FLAGS_READ_ONLY + LoFlagsPartScan = C.LO_FLAGS_PARTSCAN + LoKeySize = C.LO_KEY_SIZE + LoNameSize = C.LO_NAME_SIZE +) + +// Devicemapper cookie flags. +const ( + DmUdevDisableSubsystemRulesFlag = C.DM_UDEV_DISABLE_SUBSYSTEM_RULES_FLAG + DmUdevDisableDiskRulesFlag = C.DM_UDEV_DISABLE_DISK_RULES_FLAG + DmUdevDisableOtherRulesFlag = C.DM_UDEV_DISABLE_OTHER_RULES_FLAG + DmUdevDisableLibraryFallback = C.DM_UDEV_DISABLE_LIBRARY_FALLBACK +) + +// DeviceMapper mapped functions. +var ( + DmGetLibraryVersion = dmGetLibraryVersionFct + DmGetNextTarget = dmGetNextTargetFct + DmLogInitVerbose = dmLogInitVerboseFct + DmSetDevDir = dmSetDevDirFct + DmTaskAddTarget = dmTaskAddTargetFct + DmTaskCreate = dmTaskCreateFct + DmTaskDestroy = dmTaskDestroyFct + DmTaskGetDeps = dmTaskGetDepsFct + DmTaskGetInfo = dmTaskGetInfoFct + DmTaskGetDriverVersion = dmTaskGetDriverVersionFct + DmTaskRun = dmTaskRunFct + DmTaskSetAddNode = dmTaskSetAddNodeFct + DmTaskSetCookie = dmTaskSetCookieFct + DmTaskSetMessage = dmTaskSetMessageFct + DmTaskSetName = dmTaskSetNameFct + DmTaskSetRo = dmTaskSetRoFct + DmTaskSetSector = dmTaskSetSectorFct + DmUdevWait = dmUdevWaitFct + DmUdevSetSyncSupport = dmUdevSetSyncSupportFct + DmUdevGetSyncSupport = dmUdevGetSyncSupportFct + DmCookieSupported = dmCookieSupportedFct + LogWithErrnoInit = logWithErrnoInitFct + DmTaskDeferredRemove = dmTaskDeferredRemoveFct + DmTaskGetInfoWithDeferred = dmTaskGetInfoWithDeferredFct +) + +func free(p *C.char) { + C.free(unsafe.Pointer(p)) +} + +func dmTaskDestroyFct(task *cdmTask) { + C.dm_task_destroy((*C.struct_dm_task)(task)) +} + +func dmTaskCreateFct(taskType int) *cdmTask { + return (*cdmTask)(C.dm_task_create(C.int(taskType))) +} + +func dmTaskRunFct(task *cdmTask) int { + ret, _ := C.dm_task_run((*C.struct_dm_task)(task)) + return int(ret) +} + +func dmTaskSetNameFct(task *cdmTask, name string) int { + Cname := C.CString(name) + defer free(Cname) + + return int(C.dm_task_set_name((*C.struct_dm_task)(task), Cname)) +} + +func dmTaskSetMessageFct(task *cdmTask, message string) int { + Cmessage := C.CString(message) + defer free(Cmessage) + + return int(C.dm_task_set_message((*C.struct_dm_task)(task), Cmessage)) +} + +func dmTaskSetSectorFct(task *cdmTask, sector uint64) int { + return int(C.dm_task_set_sector((*C.struct_dm_task)(task), C.uint64_t(sector))) +} + +func dmTaskSetCookieFct(task *cdmTask, cookie *uint, flags uint16) int { + cCookie := C.uint32_t(*cookie) + defer func() { + *cookie = uint(cCookie) + }() + return int(C.dm_task_set_cookie((*C.struct_dm_task)(task), &cCookie, C.uint16_t(flags))) +} + +func dmTaskSetAddNodeFct(task *cdmTask, addNode AddNodeType) int { + return int(C.dm_task_set_add_node((*C.struct_dm_task)(task), C.dm_add_node_t(addNode))) +} + +func dmTaskSetRoFct(task *cdmTask) int { + return int(C.dm_task_set_ro((*C.struct_dm_task)(task))) +} + +func dmTaskAddTargetFct(task *cdmTask, + start, size uint64, ttype, params string) int { + + Cttype := C.CString(ttype) + defer free(Cttype) + + Cparams := C.CString(params) + defer free(Cparams) + + return int(C.dm_task_add_target((*C.struct_dm_task)(task), C.uint64_t(start), C.uint64_t(size), Cttype, Cparams)) +} + +func dmTaskGetDepsFct(task *cdmTask) *Deps { + Cdeps := C.dm_task_get_deps((*C.struct_dm_task)(task)) + if Cdeps == nil { + return nil + } + + // golang issue: https://github.com/golang/go/issues/11925 + hdr := reflect.SliceHeader{ + Data: uintptr(unsafe.Pointer(uintptr(unsafe.Pointer(Cdeps)) + unsafe.Sizeof(*Cdeps))), + Len: int(Cdeps.count), + Cap: int(Cdeps.count), + } + devices := *(*[]C.uint64_t)(unsafe.Pointer(&hdr)) + + deps := &Deps{ + Count: uint32(Cdeps.count), + Filler: uint32(Cdeps.filler), + } + for _, device := range devices { + deps.Device = append(deps.Device, uint64(device)) + } + return deps +} + +func dmTaskGetInfoFct(task *cdmTask, info *Info) int { + Cinfo := C.struct_dm_info{} + defer func() { + info.Exists = int(Cinfo.exists) + info.Suspended = int(Cinfo.suspended) + info.LiveTable = int(Cinfo.live_table) + info.InactiveTable = int(Cinfo.inactive_table) + info.OpenCount = int32(Cinfo.open_count) + info.EventNr = uint32(Cinfo.event_nr) + info.Major = uint32(Cinfo.major) + info.Minor = uint32(Cinfo.minor) + info.ReadOnly = int(Cinfo.read_only) + info.TargetCount = int32(Cinfo.target_count) + }() + return int(C.dm_task_get_info((*C.struct_dm_task)(task), &Cinfo)) +} + +func dmTaskGetDriverVersionFct(task *cdmTask) string { + buffer := C.malloc(128) + defer C.free(buffer) + res := C.dm_task_get_driver_version((*C.struct_dm_task)(task), (*C.char)(buffer), 128) + if res == 0 { + return "" + } + return C.GoString((*C.char)(buffer)) +} + +func dmGetNextTargetFct(task *cdmTask, next unsafe.Pointer, start, length *uint64, target, params *string) unsafe.Pointer { + var ( + Cstart, Clength C.uint64_t + CtargetType, Cparams *C.char + ) + defer func() { + *start = uint64(Cstart) + *length = uint64(Clength) + *target = C.GoString(CtargetType) + *params = C.GoString(Cparams) + }() + + nextp := C.dm_get_next_target((*C.struct_dm_task)(task), next, &Cstart, &Clength, &CtargetType, &Cparams) + return nextp +} + +func dmUdevSetSyncSupportFct(syncWithUdev int) { + (C.dm_udev_set_sync_support(C.int(syncWithUdev))) +} + +func dmUdevGetSyncSupportFct() int { + return int(C.dm_udev_get_sync_support()) +} + +func dmUdevWaitFct(cookie uint) int { + return int(C.dm_udev_wait(C.uint32_t(cookie))) +} + +func dmCookieSupportedFct() int { + return int(C.dm_cookie_supported()) +} + +func dmLogInitVerboseFct(level int) { + C.dm_log_init_verbose(C.int(level)) +} + +func logWithErrnoInitFct() { + C.log_with_errno_init() +} + +func dmSetDevDirFct(dir string) int { + Cdir := C.CString(dir) + defer free(Cdir) + + return int(C.dm_set_dev_dir(Cdir)) +} + +func dmGetLibraryVersionFct(version *string) int { + buffer := C.CString(string(make([]byte, 128))) + defer free(buffer) + defer func() { + *version = C.GoString(buffer) + }() + return int(C.dm_get_library_version(buffer, 128)) +} diff --git a/pkg/devicemapper/devmapper_wrapper_deferred_remove.go b/pkg/devicemapper/devmapper_wrapper_deferred_remove.go new file mode 100644 index 0000000000..40ab199e4b --- /dev/null +++ b/pkg/devicemapper/devmapper_wrapper_deferred_remove.go @@ -0,0 +1,34 @@ +// +build linux,!libdm_no_deferred_remove + +package devicemapper + +/* +#cgo LDFLAGS: -L. -ldevmapper +#include +*/ +import "C" + +// LibraryDeferredRemovalsupport is supported when statically linked. +const LibraryDeferredRemovalSupport = true + +func dmTaskDeferredRemoveFct(task *cdmTask) int { + return int(C.dm_task_deferred_remove((*C.struct_dm_task)(task))) +} + +func dmTaskGetInfoWithDeferredFct(task *cdmTask, info *Info) int { + Cinfo := C.struct_dm_info{} + defer func() { + info.Exists = int(Cinfo.exists) + info.Suspended = int(Cinfo.suspended) + info.LiveTable = int(Cinfo.live_table) + info.InactiveTable = int(Cinfo.inactive_table) + info.OpenCount = int32(Cinfo.open_count) + info.EventNr = uint32(Cinfo.event_nr) + info.Major = uint32(Cinfo.major) + info.Minor = uint32(Cinfo.minor) + info.ReadOnly = int(Cinfo.read_only) + info.TargetCount = int32(Cinfo.target_count) + info.DeferredRemove = int(Cinfo.deferred_remove) + }() + return int(C.dm_task_get_info((*C.struct_dm_task)(task), &Cinfo)) +} diff --git a/pkg/devicemapper/devmapper_wrapper_no_deferred_remove.go b/pkg/devicemapper/devmapper_wrapper_no_deferred_remove.go new file mode 100644 index 0000000000..4a6665de86 --- /dev/null +++ b/pkg/devicemapper/devmapper_wrapper_no_deferred_remove.go @@ -0,0 +1,15 @@ +// +build linux,libdm_no_deferred_remove + +package devicemapper + +// LibraryDeferredRemovalsupport is not supported when statically linked. +const LibraryDeferredRemovalSupport = false + +func dmTaskDeferredRemoveFct(task *cdmTask) int { + // Error. Nobody should be calling it. + return -1 +} + +func dmTaskGetInfoWithDeferredFct(task *cdmTask, info *Info) int { + return -1 +} diff --git a/pkg/devicemapper/ioctl.go b/pkg/devicemapper/ioctl.go new file mode 100644 index 0000000000..1ccc16c410 --- /dev/null +++ b/pkg/devicemapper/ioctl.go @@ -0,0 +1,72 @@ +// +build linux + +package devicemapper + +import ( + "syscall" + "unsafe" +) + +func ioctlLoopCtlGetFree(fd uintptr) (int, error) { + index, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, LoopCtlGetFree, 0) + if err != 0 { + return 0, err + } + return int(index), nil +} + +func ioctlLoopSetFd(loopFd, sparseFd uintptr) error { + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, loopFd, LoopSetFd, sparseFd); err != 0 { + return err + } + return nil +} + +func ioctlLoopSetStatus64(loopFd uintptr, loopInfo *loopInfo64) error { + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, loopFd, LoopSetStatus64, uintptr(unsafe.Pointer(loopInfo))); err != 0 { + return err + } + return nil +} + +func ioctlLoopClrFd(loopFd uintptr) error { + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, loopFd, LoopClrFd, 0); err != 0 { + return err + } + return nil +} + +func ioctlLoopGetStatus64(loopFd uintptr) (*loopInfo64, error) { + loopInfo := &loopInfo64{} + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, loopFd, LoopGetStatus64, uintptr(unsafe.Pointer(loopInfo))); err != 0 { + return nil, err + } + return loopInfo, nil +} + +func ioctlLoopSetCapacity(loopFd uintptr, value int) error { + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, loopFd, LoopSetCapacity, uintptr(value)); err != 0 { + return err + } + return nil +} + +func ioctlBlkGetSize64(fd uintptr) (int64, error) { + var size int64 + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, BlkGetSize64, uintptr(unsafe.Pointer(&size))); err != 0 { + return 0, err + } + return size, nil +} + +func ioctlBlkDiscard(fd uintptr, offset, length uint64) error { + var r [2]uint64 + r[0] = offset + r[1] = length + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, BlkDiscard, uintptr(unsafe.Pointer(&r[0]))); err != 0 { + return err + } + return nil +} diff --git a/pkg/devicemapper/log.go b/pkg/devicemapper/log.go new file mode 100644 index 0000000000..cee5e54549 --- /dev/null +++ b/pkg/devicemapper/log.go @@ -0,0 +1,11 @@ +package devicemapper + +// definitions from lvm2 lib/log/log.h +const ( + LogLevelFatal = 2 + iota // _LOG_FATAL + LogLevelErr // _LOG_ERR + LogLevelWarn // _LOG_WARN + LogLevelNotice // _LOG_NOTICE + LogLevelInfo // _LOG_INFO + LogLevelDebug // _LOG_DEBUG +) diff --git a/pkg/directory/directory.go b/pkg/directory/directory.go new file mode 100644 index 0000000000..1715ef45d9 --- /dev/null +++ b/pkg/directory/directory.go @@ -0,0 +1,26 @@ +package directory + +import ( + "io/ioutil" + "os" + "path/filepath" +) + +// MoveToSubdir moves all contents of a directory to a subdirectory underneath the original path +func MoveToSubdir(oldpath, subdir string) error { + + infos, err := ioutil.ReadDir(oldpath) + if err != nil { + return err + } + for _, info := range infos { + if info.Name() != subdir { + oldName := filepath.Join(oldpath, info.Name()) + newName := filepath.Join(oldpath, subdir, info.Name()) + if err := os.Rename(oldName, newName); err != nil { + return err + } + } + } + return nil +} diff --git a/pkg/directory/directory_test.go b/pkg/directory/directory_test.go new file mode 100644 index 0000000000..1b196b105b --- /dev/null +++ b/pkg/directory/directory_test.go @@ -0,0 +1,182 @@ +package directory + +import ( + "io/ioutil" + "os" + "path/filepath" + "reflect" + "sort" + "testing" +) + +// Size of an empty directory should be 0 +func TestSizeEmpty(t *testing.T) { + var dir string + var err error + if dir, err = ioutil.TempDir(os.TempDir(), "testSizeEmptyDirectory"); err != nil { + t.Fatalf("failed to create directory: %s", err) + } + + var size int64 + if size, _ = Size(dir); size != 0 { + t.Fatalf("empty directory has size: %d", size) + } +} + +// Size of a directory with one empty file should be 0 +func TestSizeEmptyFile(t *testing.T) { + var dir string + var err error + if dir, err = ioutil.TempDir(os.TempDir(), "testSizeEmptyFile"); err != nil { + t.Fatalf("failed to create directory: %s", err) + } + + var file *os.File + if file, err = ioutil.TempFile(dir, "file"); err != nil { + t.Fatalf("failed to create file: %s", err) + } + + var size int64 + if size, _ = Size(file.Name()); size != 0 { + t.Fatalf("directory with one file has size: %d", size) + } +} + +// Size of a directory with one 5-byte file should be 5 +func TestSizeNonemptyFile(t *testing.T) { + var dir string + var err error + if dir, err = ioutil.TempDir(os.TempDir(), "testSizeNonemptyFile"); err != nil { + t.Fatalf("failed to create directory: %s", err) + } + + var file *os.File + if file, err = ioutil.TempFile(dir, "file"); err != nil { + t.Fatalf("failed to create file: %s", err) + } + + d := []byte{97, 98, 99, 100, 101} + file.Write(d) + + var size int64 + if size, _ = Size(file.Name()); size != 5 { + t.Fatalf("directory with one 5-byte file has size: %d", size) + } +} + +// Size of a directory with one empty directory should be 0 +func TestSizeNestedDirectoryEmpty(t *testing.T) { + var dir string + var err error + if dir, err = ioutil.TempDir(os.TempDir(), "testSizeNestedDirectoryEmpty"); err != nil { + t.Fatalf("failed to create directory: %s", err) + } + if dir, err = ioutil.TempDir(dir, "nested"); err != nil { + t.Fatalf("failed to create nested directory: %s", err) + } + + var size int64 + if size, _ = Size(dir); size != 0 { + t.Fatalf("directory with one empty directory has size: %d", size) + } +} + +// Test directory with 1 file and 1 empty directory +func TestSizeFileAndNestedDirectoryEmpty(t *testing.T) { + var dir string + var err error + if dir, err = ioutil.TempDir(os.TempDir(), "testSizeFileAndNestedDirectoryEmpty"); err != nil { + t.Fatalf("failed to create directory: %s", err) + } + if dir, err = ioutil.TempDir(dir, "nested"); err != nil { + t.Fatalf("failed to create nested directory: %s", err) + } + + var file *os.File + if file, err = ioutil.TempFile(dir, "file"); err != nil { + t.Fatalf("failed to create file: %s", err) + } + + d := []byte{100, 111, 99, 107, 101, 114} + file.Write(d) + + var size int64 + if size, _ = Size(dir); size != 6 { + t.Fatalf("directory with 6-byte file and empty directory has size: %d", size) + } +} + +// Test directory with 1 file and 1 non-empty directory +func TestSizeFileAndNestedDirectoryNonempty(t *testing.T) { + var dir, dirNested string + var err error + if dir, err = ioutil.TempDir(os.TempDir(), "TestSizeFileAndNestedDirectoryNonempty"); err != nil { + t.Fatalf("failed to create directory: %s", err) + } + if dirNested, err = ioutil.TempDir(dir, "nested"); err != nil { + t.Fatalf("failed to create nested directory: %s", err) + } + + var file *os.File + if file, err = ioutil.TempFile(dir, "file"); err != nil { + t.Fatalf("failed to create file: %s", err) + } + + data := []byte{100, 111, 99, 107, 101, 114} + file.Write(data) + + var nestedFile *os.File + if nestedFile, err = ioutil.TempFile(dirNested, "file"); err != nil { + t.Fatalf("failed to create file in nested directory: %s", err) + } + + nestedData := []byte{100, 111, 99, 107, 101, 114} + nestedFile.Write(nestedData) + + var size int64 + if size, _ = Size(dir); size != 12 { + t.Fatalf("directory with 6-byte file and nested directory with 6-byte file has size: %d", size) + } +} + +// Test migration of directory to a subdir underneath itself +func TestMoveToSubdir(t *testing.T) { + var outerDir, subDir string + var err error + + if outerDir, err = ioutil.TempDir(os.TempDir(), "TestMoveToSubdir"); err != nil { + t.Fatalf("failed to create directory: %v", err) + } + + if subDir, err = ioutil.TempDir(outerDir, "testSub"); err != nil { + t.Fatalf("failed to create subdirectory: %v", err) + } + + // write 4 temp files in the outer dir to get moved + filesList := []string{"a", "b", "c", "d"} + for _, fName := range filesList { + if file, err := os.Create(filepath.Join(outerDir, fName)); err != nil { + t.Fatalf("couldn't create temp file %q: %v", fName, err) + } else { + file.WriteString(fName) + file.Close() + } + } + + if err = MoveToSubdir(outerDir, filepath.Base(subDir)); err != nil { + t.Fatalf("Error during migration of content to subdirectory: %v", err) + } + // validate that the files were moved to the subdirectory + infos, err := ioutil.ReadDir(subDir) + if len(infos) != 4 { + t.Fatalf("Should be four files in the subdir after the migration: actual length: %d", len(infos)) + } + var results []string + for _, info := range infos { + results = append(results, info.Name()) + } + sort.Sort(sort.StringSlice(results)) + if !reflect.DeepEqual(filesList, results) { + t.Fatalf("Results after migration do not equal list of files: expected: %v, got: %v", filesList, results) + } +} diff --git a/pkg/directory/directory_unix.go b/pkg/directory/directory_unix.go new file mode 100644 index 0000000000..dbebdd3c2c --- /dev/null +++ b/pkg/directory/directory_unix.go @@ -0,0 +1,39 @@ +// +build linux freebsd + +package directory + +import ( + "os" + "path/filepath" + "syscall" +) + +// Size walks a directory tree and returns its total size in bytes. +func Size(dir string) (size int64, err error) { + data := make(map[uint64]struct{}) + err = filepath.Walk(dir, func(d string, fileInfo os.FileInfo, e error) error { + // Ignore directory sizes + if fileInfo == nil { + return nil + } + + s := fileInfo.Size() + if fileInfo.IsDir() || s == 0 { + return nil + } + + // Check inode to handle hard links correctly + inode := fileInfo.Sys().(*syscall.Stat_t).Ino + // inode is not a uint64 on all platforms. Cast it to avoid issues. + if _, exists := data[uint64(inode)]; exists { + return nil + } + // inode is not a uint64 on all platforms. Cast it to avoid issues. + data[uint64(inode)] = struct{}{} + + size += s + + return nil + }) + return +} diff --git a/pkg/directory/directory_windows.go b/pkg/directory/directory_windows.go new file mode 100644 index 0000000000..6d41777391 --- /dev/null +++ b/pkg/directory/directory_windows.go @@ -0,0 +1,35 @@ +// +build windows + +package directory + +import ( + "os" + "path/filepath" + + "github.com/docker/docker/pkg/longpath" +) + +// Size walks a directory tree and returns its total size in bytes. +func Size(dir string) (size int64, err error) { + fixedPath, err := filepath.Abs(dir) + if err != nil { + return + } + fixedPath = longpath.AddPrefix(fixedPath) + err = filepath.Walk(dir, func(d string, fileInfo os.FileInfo, e error) error { + // Ignore directory sizes + if fileInfo == nil { + return nil + } + + s := fileInfo.Size() + if fileInfo.IsDir() || s == 0 { + return nil + } + + size += s + + return nil + }) + return +} diff --git a/pkg/discovery/README.md b/pkg/discovery/README.md new file mode 100644 index 0000000000..39777c2171 --- /dev/null +++ b/pkg/discovery/README.md @@ -0,0 +1,41 @@ +--- +page_title: Docker discovery +page_description: discovery +page_keywords: docker, clustering, discovery +--- + +# Discovery + +Docker comes with multiple Discovery backends. + +## Backends + +### Using etcd + +Point your Docker Engine instances to a common etcd instance. You can specify +the address Docker uses to advertise the node using the `--cluster-advertise` +flag. + +```bash +$ docker daemon -H= --cluster-advertise= --cluster-store etcd://,/ +``` + +### Using consul + +Point your Docker Engine instances to a common Consul instance. You can specify +the address Docker uses to advertise the node using the `--cluster-advertise` +flag. + +```bash +$ docker daemon -H= --cluster-advertise= --cluster-store consul:/// +``` + +### Using zookeeper + +Point your Docker Engine instances to a common Zookeeper instance. You can specify +the address Docker uses to advertise the node using the `--cluster-advertise` +flag. + +```bash +$ docker daemon -H= --cluster-advertise= --cluster-store zk://,/ +``` diff --git a/pkg/discovery/backends.go b/pkg/discovery/backends.go new file mode 100644 index 0000000000..875a26c442 --- /dev/null +++ b/pkg/discovery/backends.go @@ -0,0 +1,111 @@ +package discovery + +import ( + "fmt" + "net" + "strings" + "time" + + log "github.com/Sirupsen/logrus" +) + +var ( + // Backends is a global map of discovery backends indexed by their + // associated scheme. + backends map[string]Backend +) + +func init() { + backends = make(map[string]Backend) +} + +// Register makes a discovery backend available by the provided scheme. +// If Register is called twice with the same scheme an error is returned. +func Register(scheme string, d Backend) error { + if _, exists := backends[scheme]; exists { + return fmt.Errorf("scheme already registered %s", scheme) + } + log.WithField("name", scheme).Debug("Registering discovery service") + backends[scheme] = d + return nil +} + +func parse(rawurl string) (string, string) { + parts := strings.SplitN(rawurl, "://", 2) + + // nodes:port,node2:port => nodes://node1:port,node2:port + if len(parts) == 1 { + return "nodes", parts[0] + } + return parts[0], parts[1] +} + +// ParseAdvertise parses the --cluster-advertise daemon config which accepts +// : or : +func ParseAdvertise(store, advertise string) (string, error) { + var ( + iface *net.Interface + addrs []net.Addr + err error + ) + + addr, port, err := net.SplitHostPort(advertise) + + if err != nil { + return "", fmt.Errorf("invalid --cluster-advertise configuration: %s: %v", advertise, err) + } + + ip := net.ParseIP(addr) + // If it is a valid ip-address, use it as is + if ip != nil { + return advertise, nil + } + + // If advertise is a valid interface name, get the valid ipv4 address and use it to advertise + ifaceName := addr + iface, err = net.InterfaceByName(ifaceName) + if err != nil { + return "", fmt.Errorf("invalid cluster advertise IP address or interface name (%s) : %v", advertise, err) + } + + addrs, err = iface.Addrs() + if err != nil { + return "", fmt.Errorf("unable to get advertise IP address from interface (%s) : %v", advertise, err) + } + + if addrs == nil || len(addrs) == 0 { + return "", fmt.Errorf("no available advertise IP address in interface (%s)", advertise) + } + + addr = "" + for _, a := range addrs { + ip, _, err := net.ParseCIDR(a.String()) + if err != nil { + return "", fmt.Errorf("error deriving advertise ip-address in interface (%s) : %v", advertise, err) + } + if ip.To4() == nil || ip.IsLoopback() { + continue + } + addr = ip.String() + break + } + if addr == "" { + return "", fmt.Errorf("couldnt find a valid ip-address in interface %s", advertise) + } + + addr = fmt.Sprintf("%s:%s", addr, port) + return addr, nil +} + +// New returns a new Discovery given a URL, heartbeat and ttl settings. +// Returns an error if the URL scheme is not supported. +func New(rawurl string, heartbeat time.Duration, ttl time.Duration, clusterOpts map[string]string) (Backend, error) { + scheme, uri := parse(rawurl) + if backend, exists := backends[scheme]; exists { + log.WithFields(log.Fields{"name": scheme, "uri": uri}).Debug("Initializing discovery service") + err := backend.Initialize(uri, heartbeat, ttl, clusterOpts) + return backend, err + } + + return nil, ErrNotSupported +} diff --git a/pkg/discovery/discovery.go b/pkg/discovery/discovery.go new file mode 100644 index 0000000000..ca7f587458 --- /dev/null +++ b/pkg/discovery/discovery.go @@ -0,0 +1,35 @@ +package discovery + +import ( + "errors" + "time" +) + +var ( + // ErrNotSupported is returned when a discovery service is not supported. + ErrNotSupported = errors.New("discovery service not supported") + + // ErrNotImplemented is returned when discovery feature is not implemented + // by discovery backend. + ErrNotImplemented = errors.New("not implemented in this discovery service") +) + +// Watcher provides watching over a cluster for nodes joining and leaving. +type Watcher interface { + // Watch the discovery for entry changes. + // Returns a channel that will receive changes or an error. + // Providing a non-nil stopCh can be used to stop watching. + Watch(stopCh <-chan struct{}) (<-chan Entries, <-chan error) +} + +// Backend is implemented by discovery backends which manage cluster entries. +type Backend interface { + // Watcher must be provided by every backend. + Watcher + + // Initialize the discovery with URIs, a heartbeat, a ttl and optional settings. + Initialize(string, time.Duration, time.Duration, map[string]string) error + + // Register to the discovery. + Register(string) error +} diff --git a/pkg/discovery/discovery_test.go b/pkg/discovery/discovery_test.go new file mode 100644 index 0000000000..ed0964dc14 --- /dev/null +++ b/pkg/discovery/discovery_test.go @@ -0,0 +1,131 @@ +package discovery + +import ( + "testing" + + "github.com/go-check/check" +) + +// Hook up gocheck into the "go test" runner. +func Test(t *testing.T) { check.TestingT(t) } + +type DiscoverySuite struct{} + +var _ = check.Suite(&DiscoverySuite{}) + +func (s *DiscoverySuite) TestNewEntry(c *check.C) { + entry, err := NewEntry("127.0.0.1:2375") + c.Assert(err, check.IsNil) + c.Assert(entry.Equals(&Entry{Host: "127.0.0.1", Port: "2375"}), check.Equals, true) + c.Assert(entry.String(), check.Equals, "127.0.0.1:2375") + + _, err = NewEntry("127.0.0.1") + c.Assert(err, check.NotNil) +} + +func (s *DiscoverySuite) TestParse(c *check.C) { + scheme, uri := parse("127.0.0.1:2375") + c.Assert(scheme, check.Equals, "nodes") + c.Assert(uri, check.Equals, "127.0.0.1:2375") + + scheme, uri = parse("localhost:2375") + c.Assert(scheme, check.Equals, "nodes") + c.Assert(uri, check.Equals, "localhost:2375") + + scheme, uri = parse("scheme://127.0.0.1:2375") + c.Assert(scheme, check.Equals, "scheme") + c.Assert(uri, check.Equals, "127.0.0.1:2375") + + scheme, uri = parse("scheme://localhost:2375") + c.Assert(scheme, check.Equals, "scheme") + c.Assert(uri, check.Equals, "localhost:2375") + + scheme, uri = parse("") + c.Assert(scheme, check.Equals, "nodes") + c.Assert(uri, check.Equals, "") +} + +func (s *DiscoverySuite) TestCreateEntries(c *check.C) { + entries, err := CreateEntries(nil) + c.Assert(entries, check.DeepEquals, Entries{}) + c.Assert(err, check.IsNil) + + entries, err = CreateEntries([]string{"127.0.0.1:2375", "127.0.0.2:2375", ""}) + c.Assert(err, check.IsNil) + expected := Entries{ + &Entry{Host: "127.0.0.1", Port: "2375"}, + &Entry{Host: "127.0.0.2", Port: "2375"}, + } + c.Assert(entries.Equals(expected), check.Equals, true) + + _, err = CreateEntries([]string{"127.0.0.1", "127.0.0.2"}) + c.Assert(err, check.NotNil) +} + +func (s *DiscoverySuite) TestContainsEntry(c *check.C) { + entries, err := CreateEntries([]string{"127.0.0.1:2375", "127.0.0.2:2375", ""}) + c.Assert(err, check.IsNil) + c.Assert(entries.Contains(&Entry{Host: "127.0.0.1", Port: "2375"}), check.Equals, true) + c.Assert(entries.Contains(&Entry{Host: "127.0.0.3", Port: "2375"}), check.Equals, false) +} + +func (s *DiscoverySuite) TestEntriesEquality(c *check.C) { + entries := Entries{ + &Entry{Host: "127.0.0.1", Port: "2375"}, + &Entry{Host: "127.0.0.2", Port: "2375"}, + } + + // Same + c.Assert(entries.Equals(Entries{ + &Entry{Host: "127.0.0.1", Port: "2375"}, + &Entry{Host: "127.0.0.2", Port: "2375"}, + }), check. + Equals, true) + + // Different size + c.Assert(entries.Equals(Entries{ + &Entry{Host: "127.0.0.1", Port: "2375"}, + &Entry{Host: "127.0.0.2", Port: "2375"}, + &Entry{Host: "127.0.0.3", Port: "2375"}, + }), check. + Equals, false) + + // Different content + c.Assert(entries.Equals(Entries{ + &Entry{Host: "127.0.0.1", Port: "2375"}, + &Entry{Host: "127.0.0.42", Port: "2375"}, + }), check. + Equals, false) + +} + +func (s *DiscoverySuite) TestEntriesDiff(c *check.C) { + entry1 := &Entry{Host: "1.1.1.1", Port: "1111"} + entry2 := &Entry{Host: "2.2.2.2", Port: "2222"} + entry3 := &Entry{Host: "3.3.3.3", Port: "3333"} + entries := Entries{entry1, entry2} + + // No diff + added, removed := entries.Diff(Entries{entry2, entry1}) + c.Assert(added, check.HasLen, 0) + c.Assert(removed, check.HasLen, 0) + + // Add + added, removed = entries.Diff(Entries{entry2, entry3, entry1}) + c.Assert(added, check.HasLen, 1) + c.Assert(added.Contains(entry3), check.Equals, true) + c.Assert(removed, check.HasLen, 0) + + // Remove + added, removed = entries.Diff(Entries{entry2}) + c.Assert(added, check.HasLen, 0) + c.Assert(removed, check.HasLen, 1) + c.Assert(removed.Contains(entry1), check.Equals, true) + + // Add and remove + added, removed = entries.Diff(Entries{entry1, entry3}) + c.Assert(added, check.HasLen, 1) + c.Assert(added.Contains(entry3), check.Equals, true) + c.Assert(removed, check.HasLen, 1) + c.Assert(removed.Contains(entry2), check.Equals, true) +} diff --git a/pkg/discovery/entry.go b/pkg/discovery/entry.go new file mode 100644 index 0000000000..e9cee26ee1 --- /dev/null +++ b/pkg/discovery/entry.go @@ -0,0 +1,97 @@ +package discovery + +import ( + "fmt" + "net" +) + +// NewEntry creates a new entry. +func NewEntry(url string) (*Entry, error) { + host, port, err := net.SplitHostPort(url) + if err != nil { + return nil, err + } + return &Entry{host, port}, nil +} + +// An Entry represents a host. +type Entry struct { + Host string + Port string +} + +// Equals returns true if cmp contains the same data. +func (e *Entry) Equals(cmp *Entry) bool { + return e.Host == cmp.Host && e.Port == cmp.Port +} + +// String returns the string form of an entry. +func (e *Entry) String() string { + return fmt.Sprintf("%s:%s", e.Host, e.Port) +} + +// Entries is a list of *Entry with some helpers. +type Entries []*Entry + +// Equals returns true if cmp contains the same data. +func (e Entries) Equals(cmp Entries) bool { + // Check if the file has really changed. + if len(e) != len(cmp) { + return false + } + for i := range e { + if !e[i].Equals(cmp[i]) { + return false + } + } + return true +} + +// Contains returns true if the Entries contain a given Entry. +func (e Entries) Contains(entry *Entry) bool { + for _, curr := range e { + if curr.Equals(entry) { + return true + } + } + return false +} + +// Diff compares two entries and returns the added and removed entries. +func (e Entries) Diff(cmp Entries) (Entries, Entries) { + added := Entries{} + for _, entry := range cmp { + if !e.Contains(entry) { + added = append(added, entry) + } + } + + removed := Entries{} + for _, entry := range e { + if !cmp.Contains(entry) { + removed = append(removed, entry) + } + } + + return added, removed +} + +// CreateEntries returns an array of entries based on the given addresses. +func CreateEntries(addrs []string) (Entries, error) { + entries := Entries{} + if addrs == nil { + return entries, nil + } + + for _, addr := range addrs { + if len(addr) == 0 { + continue + } + entry, err := NewEntry(addr) + if err != nil { + return nil, err + } + entries = append(entries, entry) + } + return entries, nil +} diff --git a/pkg/discovery/file/file.go b/pkg/discovery/file/file.go new file mode 100644 index 0000000000..b4f870b864 --- /dev/null +++ b/pkg/discovery/file/file.go @@ -0,0 +1,109 @@ +package file + +import ( + "fmt" + "io/ioutil" + "strings" + "time" + + "github.com/docker/docker/pkg/discovery" +) + +// Discovery is exported +type Discovery struct { + heartbeat time.Duration + path string +} + +func init() { + Init() +} + +// Init is exported +func Init() { + discovery.Register("file", &Discovery{}) +} + +// Initialize is exported +func (s *Discovery) Initialize(path string, heartbeat time.Duration, ttl time.Duration, _ map[string]string) error { + s.path = path + s.heartbeat = heartbeat + return nil +} + +func parseFileContent(content []byte) []string { + var result []string + for _, line := range strings.Split(strings.TrimSpace(string(content)), "\n") { + line = strings.TrimSpace(line) + // Ignoring line starts with # + if strings.HasPrefix(line, "#") { + continue + } + // Inlined # comment also ignored. + if strings.Contains(line, "#") { + line = line[0:strings.Index(line, "#")] + // Trim additional spaces caused by above stripping. + line = strings.TrimSpace(line) + } + for _, ip := range discovery.Generate(line) { + result = append(result, ip) + } + } + return result +} + +func (s *Discovery) fetch() (discovery.Entries, error) { + fileContent, err := ioutil.ReadFile(s.path) + if err != nil { + return nil, fmt.Errorf("failed to read '%s': %v", s.path, err) + } + return discovery.CreateEntries(parseFileContent(fileContent)) +} + +// Watch is exported +func (s *Discovery) Watch(stopCh <-chan struct{}) (<-chan discovery.Entries, <-chan error) { + ch := make(chan discovery.Entries) + errCh := make(chan error) + ticker := time.NewTicker(s.heartbeat) + + go func() { + defer close(errCh) + defer close(ch) + + // Send the initial entries if available. + currentEntries, err := s.fetch() + if err != nil { + errCh <- err + } else { + ch <- currentEntries + } + + // Periodically send updates. + for { + select { + case <-ticker.C: + newEntries, err := s.fetch() + if err != nil { + errCh <- err + continue + } + + // Check if the file has really changed. + if !newEntries.Equals(currentEntries) { + ch <- newEntries + } + currentEntries = newEntries + case <-stopCh: + ticker.Stop() + return + } + } + }() + + return ch, errCh +} + +// Register is exported +func (s *Discovery) Register(addr string) error { + return discovery.ErrNotImplemented +} diff --git a/pkg/discovery/file/file_test.go b/pkg/discovery/file/file_test.go new file mode 100644 index 0000000000..667f00ba0d --- /dev/null +++ b/pkg/discovery/file/file_test.go @@ -0,0 +1,114 @@ +package file + +import ( + "io/ioutil" + "os" + "testing" + + "github.com/docker/docker/pkg/discovery" + + "github.com/go-check/check" +) + +// Hook up gocheck into the "go test" runner. +func Test(t *testing.T) { check.TestingT(t) } + +type DiscoverySuite struct{} + +var _ = check.Suite(&DiscoverySuite{}) + +func (s *DiscoverySuite) TestInitialize(c *check.C) { + d := &Discovery{} + d.Initialize("/path/to/file", 1000, 0, nil) + c.Assert(d.path, check.Equals, "/path/to/file") +} + +func (s *DiscoverySuite) TestNew(c *check.C) { + d, err := discovery.New("file:///path/to/file", 0, 0, nil) + c.Assert(err, check.IsNil) + c.Assert(d.(*Discovery).path, check.Equals, "/path/to/file") +} + +func (s *DiscoverySuite) TestContent(c *check.C) { + data := ` +1.1.1.[1:2]:1111 +2.2.2.[2:4]:2222 +` + ips := parseFileContent([]byte(data)) + c.Assert(ips, check.HasLen, 5) + c.Assert(ips[0], check.Equals, "1.1.1.1:1111") + c.Assert(ips[1], check.Equals, "1.1.1.2:1111") + c.Assert(ips[2], check.Equals, "2.2.2.2:2222") + c.Assert(ips[3], check.Equals, "2.2.2.3:2222") + c.Assert(ips[4], check.Equals, "2.2.2.4:2222") +} + +func (s *DiscoverySuite) TestRegister(c *check.C) { + discovery := &Discovery{path: "/path/to/file"} + c.Assert(discovery.Register("0.0.0.0"), check.NotNil) +} + +func (s *DiscoverySuite) TestParsingContentsWithComments(c *check.C) { + data := ` +### test ### +1.1.1.1:1111 # inline comment +# 2.2.2.2:2222 + ### empty line with comment + 3.3.3.3:3333 +### test ### +` + ips := parseFileContent([]byte(data)) + c.Assert(ips, check.HasLen, 2) + c.Assert("1.1.1.1:1111", check.Equals, ips[0]) + c.Assert("3.3.3.3:3333", check.Equals, ips[1]) +} + +func (s *DiscoverySuite) TestWatch(c *check.C) { + data := ` +1.1.1.1:1111 +2.2.2.2:2222 +` + expected := discovery.Entries{ + &discovery.Entry{Host: "1.1.1.1", Port: "1111"}, + &discovery.Entry{Host: "2.2.2.2", Port: "2222"}, + } + + // Create a temporary file and remove it. + tmp, err := ioutil.TempFile(os.TempDir(), "discovery-file-test") + c.Assert(err, check.IsNil) + c.Assert(tmp.Close(), check.IsNil) + c.Assert(os.Remove(tmp.Name()), check.IsNil) + + // Set up file discovery. + d := &Discovery{} + d.Initialize(tmp.Name(), 1000, 0, nil) + stopCh := make(chan struct{}) + ch, errCh := d.Watch(stopCh) + + // Make sure it fires errors since the file doesn't exist. + c.Assert(<-errCh, check.NotNil) + // We have to drain the error channel otherwise Watch will get stuck. + go func() { + for range errCh { + } + }() + + // Write the file and make sure we get the expected value back. + c.Assert(ioutil.WriteFile(tmp.Name(), []byte(data), 0600), check.IsNil) + c.Assert(<-ch, check.DeepEquals, expected) + + // Add a new entry and look it up. + expected = append(expected, &discovery.Entry{Host: "3.3.3.3", Port: "3333"}) + f, err := os.OpenFile(tmp.Name(), os.O_APPEND|os.O_WRONLY, 0600) + c.Assert(err, check.IsNil) + c.Assert(f, check.NotNil) + _, err = f.WriteString("\n3.3.3.3:3333\n") + c.Assert(err, check.IsNil) + f.Close() + c.Assert(<-ch, check.DeepEquals, expected) + + // Stop and make sure it closes all channels. + close(stopCh) + c.Assert(<-ch, check.IsNil) + c.Assert(<-errCh, check.IsNil) +} diff --git a/pkg/discovery/generator.go b/pkg/discovery/generator.go new file mode 100644 index 0000000000..d22298298f --- /dev/null +++ b/pkg/discovery/generator.go @@ -0,0 +1,35 @@ +package discovery + +import ( + "fmt" + "regexp" + "strconv" +) + +// Generate takes care of IP generation +func Generate(pattern string) []string { + re, _ := regexp.Compile(`\[(.+):(.+)\]`) + submatch := re.FindStringSubmatch(pattern) + if submatch == nil { + return []string{pattern} + } + + from, err := strconv.Atoi(submatch[1]) + if err != nil { + return []string{pattern} + } + to, err := strconv.Atoi(submatch[2]) + if err != nil { + return []string{pattern} + } + + template := re.ReplaceAllString(pattern, "%d") + + var result []string + for val := from; val <= to; val++ { + entry := fmt.Sprintf(template, val) + result = append(result, entry) + } + + return result +} diff --git a/pkg/discovery/generator_test.go b/pkg/discovery/generator_test.go new file mode 100644 index 0000000000..6281c46665 --- /dev/null +++ b/pkg/discovery/generator_test.go @@ -0,0 +1,53 @@ +package discovery + +import ( + "github.com/go-check/check" +) + +func (s *DiscoverySuite) TestGeneratorNotGenerate(c *check.C) { + ips := Generate("127.0.0.1") + c.Assert(len(ips), check.Equals, 1) + c.Assert(ips[0], check.Equals, "127.0.0.1") +} + +func (s *DiscoverySuite) TestGeneratorWithPortNotGenerate(c *check.C) { + ips := Generate("127.0.0.1:8080") + c.Assert(len(ips), check.Equals, 1) + c.Assert(ips[0], check.Equals, "127.0.0.1:8080") +} + +func (s *DiscoverySuite) TestGeneratorMatchFailedNotGenerate(c *check.C) { + ips := Generate("127.0.0.[1]") + c.Assert(len(ips), check.Equals, 1) + c.Assert(ips[0], check.Equals, "127.0.0.[1]") +} + +func (s *DiscoverySuite) TestGeneratorWithPort(c *check.C) { + ips := Generate("127.0.0.[1:11]:2375") + c.Assert(len(ips), check.Equals, 11) + c.Assert(ips[0], check.Equals, "127.0.0.1:2375") + c.Assert(ips[1], check.Equals, "127.0.0.2:2375") + c.Assert(ips[2], check.Equals, "127.0.0.3:2375") + c.Assert(ips[3], check.Equals, "127.0.0.4:2375") + c.Assert(ips[4], check.Equals, "127.0.0.5:2375") + c.Assert(ips[5], check.Equals, "127.0.0.6:2375") + c.Assert(ips[6], check.Equals, "127.0.0.7:2375") + c.Assert(ips[7], check.Equals, "127.0.0.8:2375") + c.Assert(ips[8], check.Equals, "127.0.0.9:2375") + c.Assert(ips[9], check.Equals, "127.0.0.10:2375") + c.Assert(ips[10], check.Equals, "127.0.0.11:2375") +} + +func (s *DiscoverySuite) TestGenerateWithMalformedInputAtRangeStart(c *check.C) { + malformedInput := "127.0.0.[x:11]:2375" + ips := Generate(malformedInput) + c.Assert(len(ips), check.Equals, 1) + c.Assert(ips[0], check.Equals, malformedInput) +} + +func (s *DiscoverySuite) TestGenerateWithMalformedInputAtRangeEnd(c *check.C) { + malformedInput := "127.0.0.[1:x]:2375" + ips := Generate(malformedInput) + c.Assert(len(ips), check.Equals, 1) + c.Assert(ips[0], check.Equals, malformedInput) +} diff --git a/pkg/discovery/kv/kv.go b/pkg/discovery/kv/kv.go new file mode 100644 index 0000000000..186bf5758e --- /dev/null +++ b/pkg/discovery/kv/kv.go @@ -0,0 +1,174 @@ +package kv + +import ( + "fmt" + "path" + "strings" + "time" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/discovery" + "github.com/docker/docker/pkg/tlsconfig" + "github.com/docker/libkv" + "github.com/docker/libkv/store" + "github.com/docker/libkv/store/consul" + "github.com/docker/libkv/store/etcd" + "github.com/docker/libkv/store/zookeeper" +) + +const ( + discoveryPath = "docker/nodes" +) + +// Discovery is exported +type Discovery struct { + backend store.Backend + store store.Store + heartbeat time.Duration + ttl time.Duration + prefix string + path string +} + +func init() { + Init() +} + +// Init is exported +func Init() { + // Register to libkv + zookeeper.Register() + consul.Register() + etcd.Register() + + // Register to internal discovery service + discovery.Register("zk", &Discovery{backend: store.ZK}) + discovery.Register("consul", &Discovery{backend: store.CONSUL}) + discovery.Register("etcd", &Discovery{backend: store.ETCD}) +} + +// Initialize is exported +func (s *Discovery) Initialize(uris string, heartbeat time.Duration, ttl time.Duration, clusterOpts map[string]string) error { + var ( + parts = strings.SplitN(uris, "/", 2) + addrs = strings.Split(parts[0], ",") + err error + ) + + // A custom prefix to the path can be optionally used. + if len(parts) == 2 { + s.prefix = parts[1] + } + + s.heartbeat = heartbeat + s.ttl = ttl + s.path = path.Join(s.prefix, discoveryPath) + + var config *store.Config + if clusterOpts["kv.cacertfile"] != "" && clusterOpts["kv.certfile"] != "" && clusterOpts["kv.keyfile"] != "" { + log.Info("Initializing discovery with TLS") + tlsConfig, err := tlsconfig.Client(tlsconfig.Options{ + CAFile: clusterOpts["kv.cacertfile"], + CertFile: clusterOpts["kv.certfile"], + KeyFile: clusterOpts["kv.keyfile"], + }) + if err != nil { + return err + } + config = &store.Config{ + // Set ClientTLS to trigger https (bug in libkv/etcd) + ClientTLS: &store.ClientTLSConfig{ + CACertFile: clusterOpts["kv.cacertfile"], + CertFile: clusterOpts["kv.certfile"], + KeyFile: clusterOpts["kv.keyfile"], + }, + // The actual TLS config that will be used + TLS: tlsConfig, + } + } else { + log.Info("Initializing discovery without TLS") + } + + // Creates a new store, will ignore options given + // if not supported by the chosen store + s.store, err = libkv.NewStore(s.backend, addrs, config) + return err +} + +// Watch the store until either there's a store error or we receive a stop request. +// Returns false if we shouldn't attempt watching the store anymore (stop request received). +func (s *Discovery) watchOnce(stopCh <-chan struct{}, watchCh <-chan []*store.KVPair, discoveryCh chan discovery.Entries, errCh chan error) bool { + for { + select { + case pairs := <-watchCh: + if pairs == nil { + return true + } + + log.WithField("discovery", s.backend).Debugf("Watch triggered with %d nodes", len(pairs)) + + // Convert `KVPair` into `discovery.Entry`. + addrs := make([]string, len(pairs)) + for _, pair := range pairs { + addrs = append(addrs, string(pair.Value)) + } + + entries, err := discovery.CreateEntries(addrs) + if err != nil { + errCh <- err + } else { + discoveryCh <- entries + } + case <-stopCh: + // We were requested to stop watching. + return false + } + } +} + +// Watch is exported +func (s *Discovery) Watch(stopCh <-chan struct{}) (<-chan discovery.Entries, <-chan error) { + ch := make(chan discovery.Entries) + errCh := make(chan error) + + go func() { + defer close(ch) + defer close(errCh) + + // Forever: Create a store watch, watch until we get an error and then try again. + // Will only stop if we receive a stopCh request. + for { + // Set up a watch. + watchCh, err := s.store.WatchTree(s.path, stopCh) + if err != nil { + errCh <- err + } else { + if !s.watchOnce(stopCh, watchCh, ch, errCh) { + return + } + } + + // If we get here it means the store watch channel was closed. This + // is unexpected so let's retry later. + errCh <- fmt.Errorf("Unexpected watch error") + time.Sleep(s.heartbeat) + } + }() + return ch, errCh +} + +// Register is exported +func (s *Discovery) Register(addr string) error { + opts := &store.WriteOptions{TTL: s.ttl} + return s.store.Put(path.Join(s.path, addr), []byte(addr), opts) +} + +// Store returns the underlying store used by KV discovery. +func (s *Discovery) Store() store.Store { + return s.store +} + +// Prefix returns the store prefix +func (s *Discovery) Prefix() string { + return s.prefix +} diff --git a/pkg/discovery/kv/kv_test.go b/pkg/discovery/kv/kv_test.go new file mode 100644 index 0000000000..2475e3304d --- /dev/null +++ b/pkg/discovery/kv/kv_test.go @@ -0,0 +1,324 @@ +package kv + +import ( + "errors" + "io/ioutil" + "os" + "path" + "testing" + "time" + + "github.com/docker/docker/pkg/discovery" + "github.com/docker/libkv" + "github.com/docker/libkv/store" + + "github.com/go-check/check" +) + +// Hook up gocheck into the "go test" runner. +func Test(t *testing.T) { check.TestingT(t) } + +type DiscoverySuite struct{} + +var _ = check.Suite(&DiscoverySuite{}) + +func (ds *DiscoverySuite) TestInitialize(c *check.C) { + storeMock := &FakeStore{ + Endpoints: []string{"127.0.0.1"}, + } + d := &Discovery{backend: store.CONSUL} + d.Initialize("127.0.0.1", 0, 0, nil) + d.store = storeMock + + s := d.store.(*FakeStore) + c.Assert(s.Endpoints, check.HasLen, 1) + c.Assert(s.Endpoints[0], check.Equals, "127.0.0.1") + c.Assert(d.path, check.Equals, discoveryPath) + + storeMock = &FakeStore{ + Endpoints: []string{"127.0.0.1:1234"}, + } + d = &Discovery{backend: store.CONSUL} + d.Initialize("127.0.0.1:1234/path", 0, 0, nil) + d.store = storeMock + + s = d.store.(*FakeStore) + c.Assert(s.Endpoints, check.HasLen, 1) + c.Assert(s.Endpoints[0], check.Equals, "127.0.0.1:1234") + c.Assert(d.path, check.Equals, "path/"+discoveryPath) + + storeMock = &FakeStore{ + Endpoints: []string{"127.0.0.1:1234", "127.0.0.2:1234", "127.0.0.3:1234"}, + } + d = &Discovery{backend: store.CONSUL} + d.Initialize("127.0.0.1:1234,127.0.0.2:1234,127.0.0.3:1234/path", 0, 0, nil) + d.store = storeMock + + s = d.store.(*FakeStore) + c.Assert(s.Endpoints, check.HasLen, 3) + c.Assert(s.Endpoints[0], check.Equals, "127.0.0.1:1234") + c.Assert(s.Endpoints[1], check.Equals, "127.0.0.2:1234") + c.Assert(s.Endpoints[2], check.Equals, "127.0.0.3:1234") + + c.Assert(d.path, check.Equals, "path/"+discoveryPath) +} + +// Extremely limited mock store so we can test initialization +type Mock struct { + // Endpoints passed to InitializeMock + Endpoints []string + + // Options passed to InitializeMock + Options *store.Config +} + +func NewMock(endpoints []string, options *store.Config) (store.Store, error) { + s := &Mock{} + s.Endpoints = endpoints + s.Options = options + return s, nil +} +func (s *Mock) Put(key string, value []byte, opts *store.WriteOptions) error { + return errors.New("Put not supported") +} +func (s *Mock) Get(key string) (*store.KVPair, error) { + return nil, errors.New("Get not supported") +} +func (s *Mock) Delete(key string) error { + return errors.New("Delete not supported") +} + +// Exists mock +func (s *Mock) Exists(key string) (bool, error) { + return false, errors.New("Exists not supported") +} + +// Watch mock +func (s *Mock) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + return nil, errors.New("Watch not supported") +} + +// WatchTree mock +func (s *Mock) WatchTree(prefix string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + return nil, errors.New("WatchTree not supported") +} + +// NewLock mock +func (s *Mock) NewLock(key string, options *store.LockOptions) (store.Locker, error) { + return nil, errors.New("NewLock not supported") +} + +// List mock +func (s *Mock) List(prefix string) ([]*store.KVPair, error) { + return nil, errors.New("List not supported") +} + +// DeleteTree mock +func (s *Mock) DeleteTree(prefix string) error { + return errors.New("DeleteTree not supported") +} + +// AtomicPut mock +func (s *Mock) AtomicPut(key string, value []byte, previous *store.KVPair, opts *store.WriteOptions) (bool, *store.KVPair, error) { + return false, nil, errors.New("AtomicPut not supported") +} + +// AtomicDelete mock +func (s *Mock) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + return false, errors.New("AtomicDelete not supported") +} + +// Close mock +func (s *Mock) Close() { + return +} + +func (ds *DiscoverySuite) TestInitializeWithCerts(c *check.C) { + cert := `-----BEGIN CERTIFICATE----- +MIIDCDCCAfKgAwIBAgIICifG7YeiQOEwCwYJKoZIhvcNAQELMBIxEDAOBgNVBAMT +B1Rlc3QgQ0EwHhcNMTUxMDAxMjMwMDAwWhcNMjAwOTI5MjMwMDAwWjASMRAwDgYD +VQQDEwdUZXN0IENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1wRC +O+flnLTK5ImjTurNRHwSejuqGbc4CAvpB0hS+z0QlSs4+zE9h80aC4hz+6caRpds ++J908Q+RvAittMHbpc7VjbZP72G6fiXk7yPPl6C10HhRSoSi3nY+B7F2E8cuz14q +V2e+ejhWhSrBb/keyXpcyjoW1BOAAJ2TIclRRkICSCZrpXUyXxAvzXfpFXo1RhSb +UywN11pfiCQzDUN7sPww9UzFHuAHZHoyfTr27XnJYVUerVYrCPq8vqfn//01qz55 +Xs0hvzGdlTFXhuabFtQnKFH5SNwo/fcznhB7rePOwHojxOpXTBepUCIJLbtNnWFT +V44t9gh5IqIWtoBReQIDAQABo2YwZDAOBgNVHQ8BAf8EBAMCAAYwEgYDVR0TAQH/ +BAgwBgEB/wIBAjAdBgNVHQ4EFgQUZKUI8IIjIww7X/6hvwggQK4bD24wHwYDVR0j +BBgwFoAUZKUI8IIjIww7X/6hvwggQK4bD24wCwYJKoZIhvcNAQELA4IBAQDES2cz +7sCQfDCxCIWH7X8kpi/JWExzUyQEJ0rBzN1m3/x8ySRxtXyGekimBqQwQdFqlwMI +xzAQKkh3ue8tNSzRbwqMSyH14N1KrSxYS9e9szJHfUasoTpQGPmDmGIoRJuq1h6M +ej5x1SCJ7GWCR6xEXKUIE9OftXm9TdFzWa7Ja3OHz/mXteii8VXDuZ5ACq6EE5bY +8sP4gcICfJ5fTrpTlk9FIqEWWQrCGa5wk95PGEj+GJpNogjXQ97wVoo/Y3p1brEn +t5zjN9PAq4H1fuCMdNNA+p1DHNwd+ELTxcMAnb2ajwHvV6lKPXutrTFc4umJToBX +FpTxDmJHEV4bzUzh +-----END CERTIFICATE----- +` + key := `-----BEGIN RSA PRIVATE KEY----- +MIIEpQIBAAKCAQEA1wRCO+flnLTK5ImjTurNRHwSejuqGbc4CAvpB0hS+z0QlSs4 ++zE9h80aC4hz+6caRpds+J908Q+RvAittMHbpc7VjbZP72G6fiXk7yPPl6C10HhR +SoSi3nY+B7F2E8cuz14qV2e+ejhWhSrBb/keyXpcyjoW1BOAAJ2TIclRRkICSCZr +pXUyXxAvzXfpFXo1RhSbUywN11pfiCQzDUN7sPww9UzFHuAHZHoyfTr27XnJYVUe +rVYrCPq8vqfn//01qz55Xs0hvzGdlTFXhuabFtQnKFH5SNwo/fcznhB7rePOwHoj +xOpXTBepUCIJLbtNnWFTV44t9gh5IqIWtoBReQIDAQABAoIBAHSWipORGp/uKFXj +i/mut776x8ofsAxhnLBARQr93ID+i49W8H7EJGkOfaDjTICYC1dbpGrri61qk8sx +qX7p3v/5NzKwOIfEpirgwVIqSNYe/ncbxnhxkx6tXtUtFKmEx40JskvSpSYAhmmO +1XSx0E/PWaEN/nLgX/f1eWJIlxlQkk3QeqL+FGbCXI48DEtlJ9+MzMu4pAwZTpj5 +5qtXo5JJ0jRGfJVPAOznRsYqv864AhMdMIWguzk6EGnbaCWwPcfcn+h9a5LMdony +MDHfBS7bb5tkF3+AfnVY3IBMVx7YlsD9eAyajlgiKu4zLbwTRHjXgShy+4Oussz0 +ugNGnkECgYEA/hi+McrZC8C4gg6XqK8+9joD8tnyDZDz88BQB7CZqABUSwvjDqlP +L8hcwo/lzvjBNYGkqaFPUICGWKjeCtd8pPS2DCVXxDQX4aHF1vUur0uYNncJiV3N +XQz4Iemsa6wnKf6M67b5vMXICw7dw0HZCdIHD1hnhdtDz0uVpeevLZ8CgYEA2KCT +Y43lorjrbCgMqtlefkr3GJA9dey+hTzCiWEOOqn9RqGoEGUday0sKhiLofOgmN2B +LEukpKIey8s+Q/cb6lReajDVPDsMweX8i7hz3Wa4Ugp4Xa5BpHqu8qIAE2JUZ7bU +t88aQAYE58pUF+/Lq1QzAQdrjjzQBx6SrBxieecCgYEAvukoPZEC8mmiN1VvbTX+ +QFHmlZha3QaDxChB+QUe7bMRojEUL/fVnzkTOLuVFqSfxevaI/km9n0ac5KtAchV +xjp2bTnBb5EUQFqjopYktWA+xO07JRJtMfSEmjZPbbay1kKC7rdTfBm961EIHaRj +xZUf6M+rOE8964oGrdgdLlECgYEA046GQmx6fh7/82FtdZDRQp9tj3SWQUtSiQZc +qhO59Lq8mjUXz+MgBuJXxkiwXRpzlbaFB0Bca1fUoYw8o915SrDYf/Zu2OKGQ/qa +V81sgiVmDuEgycR7YOlbX6OsVUHrUlpwhY3hgfMe6UtkMvhBvHF/WhroBEIJm1pV +PXZ/CbMCgYEApNWVktFBjOaYfY6SNn4iSts1jgsQbbpglg3kT7PLKjCAhI6lNsbk +dyT7ut01PL6RaW4SeQWtrJIVQaM6vF3pprMKqlc5XihOGAmVqH7rQx9rtQB5TicL +BFrwkQE4HQtQBV60hYQUzzlSk44VFDz+jxIEtacRHaomDRh2FtOTz+I= +-----END RSA PRIVATE KEY----- +` + certFile, err := ioutil.TempFile("", "cert") + c.Assert(err, check.IsNil) + defer os.Remove(certFile.Name()) + certFile.Write([]byte(cert)) + certFile.Close() + keyFile, err := ioutil.TempFile("", "key") + c.Assert(err, check.IsNil) + defer os.Remove(keyFile.Name()) + keyFile.Write([]byte(key)) + keyFile.Close() + + libkv.AddStore("mock", NewMock) + d := &Discovery{backend: "mock"} + err = d.Initialize("127.0.0.3:1234", 0, 0, map[string]string{ + "kv.cacertfile": certFile.Name(), + "kv.certfile": certFile.Name(), + "kv.keyfile": keyFile.Name(), + }) + c.Assert(err, check.IsNil) + s := d.store.(*Mock) + c.Assert(s.Options.TLS, check.NotNil) + c.Assert(s.Options.TLS.RootCAs, check.NotNil) + c.Assert(s.Options.TLS.Certificates, check.HasLen, 1) +} + +func (ds *DiscoverySuite) TestWatch(c *check.C) { + mockCh := make(chan []*store.KVPair) + + storeMock := &FakeStore{ + Endpoints: []string{"127.0.0.1:1234"}, + mockKVChan: mockCh, + } + + d := &Discovery{backend: store.CONSUL} + d.Initialize("127.0.0.1:1234/path", 0, 0, nil) + d.store = storeMock + + expected := discovery.Entries{ + &discovery.Entry{Host: "1.1.1.1", Port: "1111"}, + &discovery.Entry{Host: "2.2.2.2", Port: "2222"}, + } + kvs := []*store.KVPair{ + {Key: path.Join("path", discoveryPath, "1.1.1.1"), Value: []byte("1.1.1.1:1111")}, + {Key: path.Join("path", discoveryPath, "2.2.2.2"), Value: []byte("2.2.2.2:2222")}, + } + + stopCh := make(chan struct{}) + ch, errCh := d.Watch(stopCh) + + // It should fire an error since the first WatchTree call failed. + c.Assert(<-errCh, check.ErrorMatches, "test error") + // We have to drain the error channel otherwise Watch will get stuck. + go func() { + for range errCh { + } + }() + + // Push the entries into the store channel and make sure discovery emits. + mockCh <- kvs + c.Assert(<-ch, check.DeepEquals, expected) + + // Add a new entry. + expected = append(expected, &discovery.Entry{Host: "3.3.3.3", Port: "3333"}) + kvs = append(kvs, &store.KVPair{Key: path.Join("path", discoveryPath, "3.3.3.3"), Value: []byte("3.3.3.3:3333")}) + mockCh <- kvs + c.Assert(<-ch, check.DeepEquals, expected) + + close(mockCh) + // Give it enough time to call WatchTree. + time.Sleep(3) + + // Stop and make sure it closes all channels. + close(stopCh) + c.Assert(<-ch, check.IsNil) + c.Assert(<-errCh, check.IsNil) +} + +// FakeStore implements store.Store methods. It mocks all store +// function in a simple, naive way. +type FakeStore struct { + Endpoints []string + Options *store.Config + mockKVChan <-chan []*store.KVPair + + watchTreeCallCount int +} + +func (s *FakeStore) Put(key string, value []byte, options *store.WriteOptions) error { + return nil +} + +func (s *FakeStore) Get(key string) (*store.KVPair, error) { + return nil, nil +} + +func (s *FakeStore) Delete(key string) error { + return nil +} + +func (s *FakeStore) Exists(key string) (bool, error) { + return true, nil +} + +func (s *FakeStore) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + return nil, nil +} + +// WatchTree will fail the first time, and return the mockKVchan afterwards. +// This is the behaviour we need for testing.. If we need 'moar', should update this. +func (s *FakeStore) WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + if s.watchTreeCallCount == 0 { + s.watchTreeCallCount = 1 + return nil, errors.New("test error") + } + // First calls error + return s.mockKVChan, nil +} + +func (s *FakeStore) NewLock(key string, options *store.LockOptions) (store.Locker, error) { + return nil, nil +} + +func (s *FakeStore) List(directory string) ([]*store.KVPair, error) { + return []*store.KVPair{}, nil +} + +func (s *FakeStore) DeleteTree(directory string) error { + return nil +} + +func (s *FakeStore) AtomicPut(key string, value []byte, previous *store.KVPair, options *store.WriteOptions) (bool, *store.KVPair, error) { + return true, nil, nil +} + +func (s *FakeStore) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + return true, nil +} + +func (s *FakeStore) Close() { +} diff --git a/pkg/discovery/nodes/nodes.go b/pkg/discovery/nodes/nodes.go new file mode 100644 index 0000000000..c0e3c07b22 --- /dev/null +++ b/pkg/discovery/nodes/nodes.go @@ -0,0 +1,54 @@ +package nodes + +import ( + "fmt" + "strings" + "time" + + "github.com/docker/docker/pkg/discovery" +) + +// Discovery is exported +type Discovery struct { + entries discovery.Entries +} + +func init() { + Init() +} + +// Init is exported +func Init() { + discovery.Register("nodes", &Discovery{}) +} + +// Initialize is exported +func (s *Discovery) Initialize(uris string, _ time.Duration, _ time.Duration, _ map[string]string) error { + for _, input := range strings.Split(uris, ",") { + for _, ip := range discovery.Generate(input) { + entry, err := discovery.NewEntry(ip) + if err != nil { + return fmt.Errorf("%s, please check you are using the correct discovery (missing token:// ?)", err.Error()) + } + s.entries = append(s.entries, entry) + } + } + + return nil +} + +// Watch is exported +func (s *Discovery) Watch(stopCh <-chan struct{}) (<-chan discovery.Entries, <-chan error) { + ch := make(chan discovery.Entries) + go func() { + defer close(ch) + ch <- s.entries + <-stopCh + }() + return ch, nil +} + +// Register is exported +func (s *Discovery) Register(addr string) error { + return discovery.ErrNotImplemented +} diff --git a/pkg/discovery/nodes/nodes_test.go b/pkg/discovery/nodes/nodes_test.go new file mode 100644 index 0000000000..e26568cf54 --- /dev/null +++ b/pkg/discovery/nodes/nodes_test.go @@ -0,0 +1,51 @@ +package nodes + +import ( + "testing" + + "github.com/docker/docker/pkg/discovery" + + "github.com/go-check/check" +) + +// Hook up gocheck into the "go test" runner. +func Test(t *testing.T) { check.TestingT(t) } + +type DiscoverySuite struct{} + +var _ = check.Suite(&DiscoverySuite{}) + +func (s *DiscoverySuite) TestInitialize(c *check.C) { + d := &Discovery{} + d.Initialize("1.1.1.1:1111,2.2.2.2:2222", 0, 0, nil) + c.Assert(len(d.entries), check.Equals, 2) + c.Assert(d.entries[0].String(), check.Equals, "1.1.1.1:1111") + c.Assert(d.entries[1].String(), check.Equals, "2.2.2.2:2222") +} + +func (s *DiscoverySuite) TestInitializeWithPattern(c *check.C) { + d := &Discovery{} + d.Initialize("1.1.1.[1:2]:1111,2.2.2.[2:4]:2222", 0, 0, nil) + c.Assert(len(d.entries), check.Equals, 5) + c.Assert(d.entries[0].String(), check.Equals, "1.1.1.1:1111") + c.Assert(d.entries[1].String(), check.Equals, "1.1.1.2:1111") + c.Assert(d.entries[2].String(), check.Equals, "2.2.2.2:2222") + c.Assert(d.entries[3].String(), check.Equals, "2.2.2.3:2222") + c.Assert(d.entries[4].String(), check.Equals, "2.2.2.4:2222") +} + +func (s *DiscoverySuite) TestWatch(c *check.C) { + d := &Discovery{} + d.Initialize("1.1.1.1:1111,2.2.2.2:2222", 0, 0, nil) + expected := discovery.Entries{ + &discovery.Entry{Host: "1.1.1.1", Port: "1111"}, + &discovery.Entry{Host: "2.2.2.2", Port: "2222"}, + } + ch, _ := d.Watch(nil) + c.Assert(expected.Equals(<-ch), check.Equals, true) +} + +func (s *DiscoverySuite) TestRegister(c *check.C) { + d := &Discovery{} + c.Assert(d.Register("0.0.0.0"), check.NotNil) +} diff --git a/pkg/fileutils/fileutils.go b/pkg/fileutils/fileutils.go new file mode 100644 index 0000000000..08b9840c31 --- /dev/null +++ b/pkg/fileutils/fileutils.go @@ -0,0 +1,184 @@ +package fileutils + +import ( + "errors" + "fmt" + "io" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" +) + +// exclusion return true if the specified pattern is an exclusion +func exclusion(pattern string) bool { + return pattern[0] == '!' +} + +// empty return true if the specified pattern is empty +func empty(pattern string) bool { + return pattern == "" +} + +// CleanPatterns takes a slice of patterns returns a new +// slice of patterns cleaned with filepath.Clean, stripped +// of any empty patterns and lets the caller know whether the +// slice contains any exception patterns (prefixed with !). +func CleanPatterns(patterns []string) ([]string, [][]string, bool, error) { + // Loop over exclusion patterns and: + // 1. Clean them up. + // 2. Indicate whether we are dealing with any exception rules. + // 3. Error if we see a single exclusion marker on it's own (!). + cleanedPatterns := []string{} + patternDirs := [][]string{} + exceptions := false + for _, pattern := range patterns { + // Eliminate leading and trailing whitespace. + pattern = strings.TrimSpace(pattern) + if empty(pattern) { + continue + } + if exclusion(pattern) { + if len(pattern) == 1 { + return nil, nil, false, errors.New("Illegal exclusion pattern: !") + } + exceptions = true + } + pattern = filepath.Clean(pattern) + cleanedPatterns = append(cleanedPatterns, pattern) + if exclusion(pattern) { + pattern = pattern[1:] + } + patternDirs = append(patternDirs, strings.Split(pattern, "/")) + } + + return cleanedPatterns, patternDirs, exceptions, nil +} + +// Matches returns true if file matches any of the patterns +// and isn't excluded by any of the subsequent patterns. +func Matches(file string, patterns []string) (bool, error) { + file = filepath.Clean(file) + + if file == "." { + // Don't let them exclude everything, kind of silly. + return false, nil + } + + patterns, patDirs, _, err := CleanPatterns(patterns) + if err != nil { + return false, err + } + + return OptimizedMatches(file, patterns, patDirs) +} + +// OptimizedMatches is basically the same as fileutils.Matches() but optimized for archive.go. +// It will assume that the inputs have been preprocessed and therefore the function +// doen't need to do as much error checking and clean-up. This was done to avoid +// repeating these steps on each file being checked during the archive process. +// The more generic fileutils.Matches() can't make these assumptions. +func OptimizedMatches(file string, patterns []string, patDirs [][]string) (bool, error) { + matched := false + parentPath := filepath.Dir(file) + parentPathDirs := strings.Split(parentPath, "/") + + for i, pattern := range patterns { + negative := false + + if exclusion(pattern) { + negative = true + pattern = pattern[1:] + } + + match, err := filepath.Match(pattern, file) + if err != nil { + return false, err + } + + if !match && parentPath != "." { + // Check to see if the pattern matches one of our parent dirs. + if len(patDirs[i]) <= len(parentPathDirs) { + match, _ = filepath.Match(strings.Join(patDirs[i], "/"), + strings.Join(parentPathDirs[:len(patDirs[i])], "/")) + } + } + + if match { + matched = !negative + } + } + + if matched { + logrus.Debugf("Skipping excluded path: %s", file) + } + + return matched, nil +} + +// CopyFile copies from src to dst until either EOF is reached +// on src or an error occurs. It verifies src exists and remove +// the dst if it exists. +func CopyFile(src, dst string) (int64, error) { + cleanSrc := filepath.Clean(src) + cleanDst := filepath.Clean(dst) + if cleanSrc == cleanDst { + return 0, nil + } + sf, err := os.Open(cleanSrc) + if err != nil { + return 0, err + } + defer sf.Close() + if err := os.Remove(cleanDst); err != nil && !os.IsNotExist(err) { + return 0, err + } + df, err := os.Create(cleanDst) + if err != nil { + return 0, err + } + defer df.Close() + return io.Copy(df, sf) +} + +// ReadSymlinkedDirectory returns the target directory of a symlink. +// The target of the symbolic link may not be a file. +func ReadSymlinkedDirectory(path string) (string, error) { + var realPath string + var err error + if realPath, err = filepath.Abs(path); err != nil { + return "", fmt.Errorf("unable to get absolute path for %s: %s", path, err) + } + if realPath, err = filepath.EvalSymlinks(realPath); err != nil { + return "", fmt.Errorf("failed to canonicalise path for %s: %s", path, err) + } + realPathInfo, err := os.Stat(realPath) + if err != nil { + return "", fmt.Errorf("failed to stat target '%s' of '%s': %s", realPath, path, err) + } + if !realPathInfo.Mode().IsDir() { + return "", fmt.Errorf("canonical path points to a file '%s'", realPath) + } + return realPath, nil +} + +// CreateIfNotExists creates a file or a directory only if it does not already exist. +func CreateIfNotExists(path string, isDir bool) error { + if _, err := os.Stat(path); err != nil { + if os.IsNotExist(err) { + if isDir { + return os.MkdirAll(path, 0755) + } + if err := os.MkdirAll(filepath.Dir(path), 0755); err != nil { + return err + } + f, err := os.OpenFile(path, os.O_CREATE, 0755) + if err != nil { + return err + } + f.Close() + } + } + return nil +} diff --git a/pkg/fileutils/fileutils_test.go b/pkg/fileutils/fileutils_test.go new file mode 100644 index 0000000000..b544ffbf2e --- /dev/null +++ b/pkg/fileutils/fileutils_test.go @@ -0,0 +1,402 @@ +package fileutils + +import ( + "io/ioutil" + "os" + "path" + "path/filepath" + "testing" +) + +// CopyFile with invalid src +func TestCopyFileWithInvalidSrc(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + defer os.RemoveAll(tempFolder) + if err != nil { + t.Fatal(err) + } + bytes, err := CopyFile("/invalid/file/path", path.Join(tempFolder, "dest")) + if err == nil { + t.Fatal("Should have fail to copy an invalid src file") + } + if bytes != 0 { + t.Fatal("Should have written 0 bytes") + } + +} + +// CopyFile with invalid dest +func TestCopyFileWithInvalidDest(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + defer os.RemoveAll(tempFolder) + if err != nil { + t.Fatal(err) + } + src := path.Join(tempFolder, "file") + err = ioutil.WriteFile(src, []byte("content"), 0740) + if err != nil { + t.Fatal(err) + } + bytes, err := CopyFile(src, path.Join(tempFolder, "/invalid/dest/path")) + if err == nil { + t.Fatal("Should have fail to copy an invalid src file") + } + if bytes != 0 { + t.Fatal("Should have written 0 bytes") + } + +} + +// CopyFile with same src and dest +func TestCopyFileWithSameSrcAndDest(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + defer os.RemoveAll(tempFolder) + if err != nil { + t.Fatal(err) + } + file := path.Join(tempFolder, "file") + err = ioutil.WriteFile(file, []byte("content"), 0740) + if err != nil { + t.Fatal(err) + } + bytes, err := CopyFile(file, file) + if err != nil { + t.Fatal(err) + } + if bytes != 0 { + t.Fatal("Should have written 0 bytes as it is the same file.") + } +} + +// CopyFile with same src and dest but path is different and not clean +func TestCopyFileWithSameSrcAndDestWithPathNameDifferent(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + defer os.RemoveAll(tempFolder) + if err != nil { + t.Fatal(err) + } + testFolder := path.Join(tempFolder, "test") + err = os.MkdirAll(testFolder, 0740) + if err != nil { + t.Fatal(err) + } + file := path.Join(testFolder, "file") + sameFile := testFolder + "/../test/file" + err = ioutil.WriteFile(file, []byte("content"), 0740) + if err != nil { + t.Fatal(err) + } + bytes, err := CopyFile(file, sameFile) + if err != nil { + t.Fatal(err) + } + if bytes != 0 { + t.Fatal("Should have written 0 bytes as it is the same file.") + } +} + +func TestCopyFile(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + defer os.RemoveAll(tempFolder) + if err != nil { + t.Fatal(err) + } + src := path.Join(tempFolder, "src") + dest := path.Join(tempFolder, "dest") + ioutil.WriteFile(src, []byte("content"), 0777) + ioutil.WriteFile(dest, []byte("destContent"), 0777) + bytes, err := CopyFile(src, dest) + if err != nil { + t.Fatal(err) + } + if bytes != 7 { + t.Fatalf("Should have written %d bytes but wrote %d", 7, bytes) + } + actual, err := ioutil.ReadFile(dest) + if err != nil { + t.Fatal(err) + } + if string(actual) != "content" { + t.Fatalf("Dest content was '%s', expected '%s'", string(actual), "content") + } +} + +// Reading a symlink to a directory must return the directory +func TestReadSymlinkedDirectoryExistingDirectory(t *testing.T) { + var err error + if err = os.Mkdir("/tmp/testReadSymlinkToExistingDirectory", 0777); err != nil { + t.Errorf("failed to create directory: %s", err) + } + + if err = os.Symlink("/tmp/testReadSymlinkToExistingDirectory", "/tmp/dirLinkTest"); err != nil { + t.Errorf("failed to create symlink: %s", err) + } + + var path string + if path, err = ReadSymlinkedDirectory("/tmp/dirLinkTest"); err != nil { + t.Fatalf("failed to read symlink to directory: %s", err) + } + + if path != "/tmp/testReadSymlinkToExistingDirectory" { + t.Fatalf("symlink returned unexpected directory: %s", path) + } + + if err = os.Remove("/tmp/testReadSymlinkToExistingDirectory"); err != nil { + t.Errorf("failed to remove temporary directory: %s", err) + } + + if err = os.Remove("/tmp/dirLinkTest"); err != nil { + t.Errorf("failed to remove symlink: %s", err) + } +} + +// Reading a non-existing symlink must fail +func TestReadSymlinkedDirectoryNonExistingSymlink(t *testing.T) { + var path string + var err error + if path, err = ReadSymlinkedDirectory("/tmp/test/foo/Non/ExistingPath"); err == nil { + t.Fatalf("error expected for non-existing symlink") + } + + if path != "" { + t.Fatalf("expected empty path, but '%s' was returned", path) + } +} + +// Reading a symlink to a file must fail +func TestReadSymlinkedDirectoryToFile(t *testing.T) { + var err error + var file *os.File + + if file, err = os.Create("/tmp/testReadSymlinkToFile"); err != nil { + t.Fatalf("failed to create file: %s", err) + } + + file.Close() + + if err = os.Symlink("/tmp/testReadSymlinkToFile", "/tmp/fileLinkTest"); err != nil { + t.Errorf("failed to create symlink: %s", err) + } + + var path string + if path, err = ReadSymlinkedDirectory("/tmp/fileLinkTest"); err == nil { + t.Fatalf("ReadSymlinkedDirectory on a symlink to a file should've failed") + } + + if path != "" { + t.Fatalf("path should've been empty: %s", path) + } + + if err = os.Remove("/tmp/testReadSymlinkToFile"); err != nil { + t.Errorf("failed to remove file: %s", err) + } + + if err = os.Remove("/tmp/fileLinkTest"); err != nil { + t.Errorf("failed to remove symlink: %s", err) + } +} + +func TestWildcardMatches(t *testing.T) { + match, _ := Matches("fileutils.go", []string{"*"}) + if match != true { + t.Errorf("failed to get a wildcard match, got %v", match) + } +} + +// A simple pattern match should return true. +func TestPatternMatches(t *testing.T) { + match, _ := Matches("fileutils.go", []string{"*.go"}) + if match != true { + t.Errorf("failed to get a match, got %v", match) + } +} + +// An exclusion followed by an inclusion should return true. +func TestExclusionPatternMatchesPatternBefore(t *testing.T) { + match, _ := Matches("fileutils.go", []string{"!fileutils.go", "*.go"}) + if match != true { + t.Errorf("failed to get true match on exclusion pattern, got %v", match) + } +} + +// A folder pattern followed by an exception should return false. +func TestPatternMatchesFolderExclusions(t *testing.T) { + match, _ := Matches("docs/README.md", []string{"docs", "!docs/README.md"}) + if match != false { + t.Errorf("failed to get a false match on exclusion pattern, got %v", match) + } +} + +// A folder pattern followed by an exception should return false. +func TestPatternMatchesFolderWithSlashExclusions(t *testing.T) { + match, _ := Matches("docs/README.md", []string{"docs/", "!docs/README.md"}) + if match != false { + t.Errorf("failed to get a false match on exclusion pattern, got %v", match) + } +} + +// A folder pattern followed by an exception should return false. +func TestPatternMatchesFolderWildcardExclusions(t *testing.T) { + match, _ := Matches("docs/README.md", []string{"docs/*", "!docs/README.md"}) + if match != false { + t.Errorf("failed to get a false match on exclusion pattern, got %v", match) + } +} + +// A pattern followed by an exclusion should return false. +func TestExclusionPatternMatchesPatternAfter(t *testing.T) { + match, _ := Matches("fileutils.go", []string{"*.go", "!fileutils.go"}) + if match != false { + t.Errorf("failed to get false match on exclusion pattern, got %v", match) + } +} + +// A filename evaluating to . should return false. +func TestExclusionPatternMatchesWholeDirectory(t *testing.T) { + match, _ := Matches(".", []string{"*.go"}) + if match != false { + t.Errorf("failed to get false match on ., got %v", match) + } +} + +// A single ! pattern should return an error. +func TestSingleExclamationError(t *testing.T) { + _, err := Matches("fileutils.go", []string{"!"}) + if err == nil { + t.Errorf("failed to get an error for a single exclamation point, got %v", err) + } +} + +// A string preceded with a ! should return true from Exclusion. +func TestExclusion(t *testing.T) { + exclusion := exclusion("!") + if !exclusion { + t.Errorf("failed to get true for a single !, got %v", exclusion) + } +} + +// Matches with no patterns +func TestMatchesWithNoPatterns(t *testing.T) { + matches, err := Matches("/any/path/there", []string{}) + if err != nil { + t.Fatal(err) + } + if matches { + t.Fatalf("Should not have match anything") + } +} + +// Matches with malformed patterns +func TestMatchesWithMalformedPatterns(t *testing.T) { + matches, err := Matches("/any/path/there", []string{"["}) + if err == nil { + t.Fatal("Should have failed because of a malformed syntax in the pattern") + } + if matches { + t.Fatalf("Should not have match anything") + } +} + +// An empty string should return true from Empty. +func TestEmpty(t *testing.T) { + empty := empty("") + if !empty { + t.Errorf("failed to get true for an empty string, got %v", empty) + } +} + +func TestCleanPatterns(t *testing.T) { + cleaned, _, _, _ := CleanPatterns([]string{"docs", "config"}) + if len(cleaned) != 2 { + t.Errorf("expected 2 element slice, got %v", len(cleaned)) + } +} + +func TestCleanPatternsStripEmptyPatterns(t *testing.T) { + cleaned, _, _, _ := CleanPatterns([]string{"docs", "config", ""}) + if len(cleaned) != 2 { + t.Errorf("expected 2 element slice, got %v", len(cleaned)) + } +} + +func TestCleanPatternsExceptionFlag(t *testing.T) { + _, _, exceptions, _ := CleanPatterns([]string{"docs", "!docs/README.md"}) + if !exceptions { + t.Errorf("expected exceptions to be true, got %v", exceptions) + } +} + +func TestCleanPatternsLeadingSpaceTrimmed(t *testing.T) { + _, _, exceptions, _ := CleanPatterns([]string{"docs", " !docs/README.md"}) + if !exceptions { + t.Errorf("expected exceptions to be true, got %v", exceptions) + } +} + +func TestCleanPatternsTrailingSpaceTrimmed(t *testing.T) { + _, _, exceptions, _ := CleanPatterns([]string{"docs", "!docs/README.md "}) + if !exceptions { + t.Errorf("expected exceptions to be true, got %v", exceptions) + } +} + +func TestCleanPatternsErrorSingleException(t *testing.T) { + _, _, _, err := CleanPatterns([]string{"!"}) + if err == nil { + t.Errorf("expected error on single exclamation point, got %v", err) + } +} + +func TestCleanPatternsFolderSplit(t *testing.T) { + _, dirs, _, _ := CleanPatterns([]string{"docs/config/CONFIG.md"}) + if dirs[0][0] != "docs" { + t.Errorf("expected first element in dirs slice to be docs, got %v", dirs[0][1]) + } + if dirs[0][1] != "config" { + t.Errorf("expected first element in dirs slice to be config, got %v", dirs[0][1]) + } +} + +func TestCreateIfNotExistsDir(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tempFolder) + + folderToCreate := filepath.Join(tempFolder, "tocreate") + + if err := CreateIfNotExists(folderToCreate, true); err != nil { + t.Fatal(err) + } + fileinfo, err := os.Stat(folderToCreate) + if err != nil { + t.Fatalf("Should have create a folder, got %v", err) + } + + if !fileinfo.IsDir() { + t.Fatalf("Should have been a dir, seems it's not") + } +} + +func TestCreateIfNotExistsFile(t *testing.T) { + tempFolder, err := ioutil.TempDir("", "docker-fileutils-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tempFolder) + + fileToCreate := filepath.Join(tempFolder, "file/to/create") + + if err := CreateIfNotExists(fileToCreate, false); err != nil { + t.Fatal(err) + } + fileinfo, err := os.Stat(fileToCreate) + if err != nil { + t.Fatalf("Should have create a file, got %v", err) + } + + if fileinfo.IsDir() { + t.Fatalf("Should have been a file, seems it's not") + } +} diff --git a/pkg/fileutils/fileutils_unix.go b/pkg/fileutils/fileutils_unix.go new file mode 100644 index 0000000000..d5c3abf568 --- /dev/null +++ b/pkg/fileutils/fileutils_unix.go @@ -0,0 +1,22 @@ +// +build linux freebsd + +package fileutils + +import ( + "fmt" + "io/ioutil" + "os" + + "github.com/Sirupsen/logrus" +) + +// GetTotalUsedFds Returns the number of used File Descriptors by +// reading it via /proc filesystem. +func GetTotalUsedFds() int { + if fds, err := ioutil.ReadDir(fmt.Sprintf("/proc/%d/fd", os.Getpid())); err != nil { + logrus.Errorf("Error opening /proc/%d/fd: %s", os.Getpid(), err) + } else { + return len(fds) + } + return -1 +} diff --git a/pkg/fileutils/fileutils_windows.go b/pkg/fileutils/fileutils_windows.go new file mode 100644 index 0000000000..5ec21cace5 --- /dev/null +++ b/pkg/fileutils/fileutils_windows.go @@ -0,0 +1,7 @@ +package fileutils + +// GetTotalUsedFds Returns the number of used File Descriptors. Not supported +// on Windows. +func GetTotalUsedFds() int { + return -1 +} diff --git a/pkg/graphdb/conn_sqlite3.go b/pkg/graphdb/conn_sqlite3.go new file mode 100644 index 0000000000..dbcf44c256 --- /dev/null +++ b/pkg/graphdb/conn_sqlite3.go @@ -0,0 +1,15 @@ +// +build cgo + +package graphdb + +import "database/sql" + +// NewSqliteConn opens a connection to a sqlite +// database. +func NewSqliteConn(root string) (*Database, error) { + conn, err := sql.Open("sqlite3", root) + if err != nil { + return nil, err + } + return NewDatabase(conn) +} diff --git a/pkg/graphdb/conn_sqlite3_unix.go b/pkg/graphdb/conn_sqlite3_unix.go new file mode 100644 index 0000000000..f932fff286 --- /dev/null +++ b/pkg/graphdb/conn_sqlite3_unix.go @@ -0,0 +1,7 @@ +// +build cgo,!windows + +package graphdb + +import ( + _ "github.com/mattn/go-sqlite3" // registers sqlite +) diff --git a/pkg/graphdb/conn_sqlite3_windows.go b/pkg/graphdb/conn_sqlite3_windows.go new file mode 100644 index 0000000000..52590303d4 --- /dev/null +++ b/pkg/graphdb/conn_sqlite3_windows.go @@ -0,0 +1,7 @@ +// +build cgo,windows + +package graphdb + +import ( + _ "github.com/mattn/go-sqlite3" // registers sqlite +) diff --git a/pkg/graphdb/conn_unsupported.go b/pkg/graphdb/conn_unsupported.go new file mode 100644 index 0000000000..cf977050da --- /dev/null +++ b/pkg/graphdb/conn_unsupported.go @@ -0,0 +1,8 @@ +// +build !cgo + +package graphdb + +// NewSqliteConn return a new sqlite connection. +func NewSqliteConn(root string) (*Database, error) { + panic("Not implemented") +} diff --git a/pkg/graphdb/graphdb.go b/pkg/graphdb/graphdb.go new file mode 100644 index 0000000000..eca433fa85 --- /dev/null +++ b/pkg/graphdb/graphdb.go @@ -0,0 +1,551 @@ +package graphdb + +import ( + "database/sql" + "fmt" + "path" + "strings" + "sync" +) + +const ( + createEntityTable = ` + CREATE TABLE IF NOT EXISTS entity ( + id text NOT NULL PRIMARY KEY + );` + + createEdgeTable = ` + CREATE TABLE IF NOT EXISTS edge ( + "entity_id" text NOT NULL, + "parent_id" text NULL, + "name" text NOT NULL, + CONSTRAINT "parent_fk" FOREIGN KEY ("parent_id") REFERENCES "entity" ("id"), + CONSTRAINT "entity_fk" FOREIGN KEY ("entity_id") REFERENCES "entity" ("id") + ); + ` + + createEdgeIndices = ` + CREATE UNIQUE INDEX IF NOT EXISTS "name_parent_ix" ON "edge" (parent_id, name); + ` +) + +// Entity with a unique id. +type Entity struct { + id string +} + +// An Edge connects two entities together. +type Edge struct { + EntityID string + Name string + ParentID string +} + +// Entities stores the list of entities. +type Entities map[string]*Entity + +// Edges stores the relationships between entities. +type Edges []*Edge + +// WalkFunc is a function invoked to process an individual entity. +type WalkFunc func(fullPath string, entity *Entity) error + +// Database is a graph database for storing entities and their relationships. +type Database struct { + conn *sql.DB + mux sync.RWMutex +} + +// IsNonUniqueNameError processes the error to check if it's caused by +// a constraint violation. +// This is necessary because the error isn't the same across various +// sqlite versions. +func IsNonUniqueNameError(err error) bool { + str := err.Error() + // sqlite 3.7.17-1ubuntu1 returns: + // Set failure: Abort due to constraint violation: columns parent_id, name are not unique + if strings.HasSuffix(str, "name are not unique") { + return true + } + // sqlite-3.8.3-1.fc20 returns: + // Set failure: Abort due to constraint violation: UNIQUE constraint failed: edge.parent_id, edge.name + if strings.Contains(str, "UNIQUE constraint failed") && strings.Contains(str, "edge.name") { + return true + } + // sqlite-3.6.20-1.el6 returns: + // Set failure: Abort due to constraint violation: constraint failed + if strings.HasSuffix(str, "constraint failed") { + return true + } + return false +} + +// NewDatabase creates a new graph database initialized with a root entity. +func NewDatabase(conn *sql.DB) (*Database, error) { + if conn == nil { + return nil, fmt.Errorf("Database connection cannot be nil") + } + db := &Database{conn: conn} + + // Create root entities + tx, err := conn.Begin() + if err != nil { + return nil, err + } + + if _, err := tx.Exec(createEntityTable); err != nil { + return nil, err + } + if _, err := tx.Exec(createEdgeTable); err != nil { + return nil, err + } + if _, err := tx.Exec(createEdgeIndices); err != nil { + return nil, err + } + + if _, err := tx.Exec("DELETE FROM entity where id = ?", "0"); err != nil { + tx.Rollback() + return nil, err + } + + if _, err := tx.Exec("INSERT INTO entity (id) VALUES (?);", "0"); err != nil { + tx.Rollback() + return nil, err + } + + if _, err := tx.Exec("DELETE FROM edge where entity_id=? and name=?", "0", "/"); err != nil { + tx.Rollback() + return nil, err + } + + if _, err := tx.Exec("INSERT INTO edge (entity_id, name) VALUES(?,?);", "0", "/"); err != nil { + tx.Rollback() + return nil, err + } + + if err := tx.Commit(); err != nil { + return nil, err + } + + return db, nil +} + +// Close the underlying connection to the database. +func (db *Database) Close() error { + return db.conn.Close() +} + +// Set the entity id for a given path. +func (db *Database) Set(fullPath, id string) (*Entity, error) { + db.mux.Lock() + defer db.mux.Unlock() + + tx, err := db.conn.Begin() + if err != nil { + return nil, err + } + + var entityID string + if err := tx.QueryRow("SELECT id FROM entity WHERE id = ?;", id).Scan(&entityID); err != nil { + if err == sql.ErrNoRows { + if _, err := tx.Exec("INSERT INTO entity (id) VALUES(?);", id); err != nil { + tx.Rollback() + return nil, err + } + } else { + tx.Rollback() + return nil, err + } + } + e := &Entity{id} + + parentPath, name := splitPath(fullPath) + if err := db.setEdge(parentPath, name, e, tx); err != nil { + tx.Rollback() + return nil, err + } + + if err := tx.Commit(); err != nil { + return nil, err + } + return e, nil +} + +// Exists returns true if a name already exists in the database. +func (db *Database) Exists(name string) bool { + db.mux.RLock() + defer db.mux.RUnlock() + + e, err := db.get(name) + if err != nil { + return false + } + return e != nil +} + +func (db *Database) setEdge(parentPath, name string, e *Entity, tx *sql.Tx) error { + parent, err := db.get(parentPath) + if err != nil { + return err + } + if parent.id == e.id { + return fmt.Errorf("Cannot set self as child") + } + + if _, err := tx.Exec("INSERT INTO edge (parent_id, name, entity_id) VALUES (?,?,?);", parent.id, name, e.id); err != nil { + return err + } + return nil +} + +// RootEntity returns the root "/" entity for the database. +func (db *Database) RootEntity() *Entity { + return &Entity{ + id: "0", + } +} + +// Get returns the entity for a given path. +func (db *Database) Get(name string) *Entity { + db.mux.RLock() + defer db.mux.RUnlock() + + e, err := db.get(name) + if err != nil { + return nil + } + return e +} + +func (db *Database) get(name string) (*Entity, error) { + e := db.RootEntity() + // We always know the root name so return it if + // it is requested + if name == "/" { + return e, nil + } + + parts := split(name) + for i := 1; i < len(parts); i++ { + p := parts[i] + if p == "" { + continue + } + + next := db.child(e, p) + if next == nil { + return nil, fmt.Errorf("Cannot find child for %s", name) + } + e = next + } + return e, nil + +} + +// List all entities by from the name. +// The key will be the full path of the entity. +func (db *Database) List(name string, depth int) Entities { + db.mux.RLock() + defer db.mux.RUnlock() + + out := Entities{} + e, err := db.get(name) + if err != nil { + return out + } + + children, err := db.children(e, name, depth, nil) + if err != nil { + return out + } + + for _, c := range children { + out[c.FullPath] = c.Entity + } + return out +} + +// Walk through the child graph of an entity, calling walkFunc for each child entity. +// It is safe for walkFunc to call graph functions. +func (db *Database) Walk(name string, walkFunc WalkFunc, depth int) error { + children, err := db.Children(name, depth) + if err != nil { + return err + } + + // Note: the database lock must not be held while calling walkFunc + for _, c := range children { + if err := walkFunc(c.FullPath, c.Entity); err != nil { + return err + } + } + return nil +} + +// Children returns the children of the specified entity. +func (db *Database) Children(name string, depth int) ([]WalkMeta, error) { + db.mux.RLock() + defer db.mux.RUnlock() + + e, err := db.get(name) + if err != nil { + return nil, err + } + + return db.children(e, name, depth, nil) +} + +// Parents returns the parents of a specified entity. +func (db *Database) Parents(name string) ([]string, error) { + db.mux.RLock() + defer db.mux.RUnlock() + + e, err := db.get(name) + if err != nil { + return nil, err + } + return db.parents(e) +} + +// Refs returns the reference count for a specified id. +func (db *Database) Refs(id string) int { + db.mux.RLock() + defer db.mux.RUnlock() + + var count int + if err := db.conn.QueryRow("SELECT COUNT(*) FROM edge WHERE entity_id = ?;", id).Scan(&count); err != nil { + return 0 + } + return count +} + +// RefPaths returns all the id's path references. +func (db *Database) RefPaths(id string) Edges { + db.mux.RLock() + defer db.mux.RUnlock() + + refs := Edges{} + + rows, err := db.conn.Query("SELECT name, parent_id FROM edge WHERE entity_id = ?;", id) + if err != nil { + return refs + } + defer rows.Close() + + for rows.Next() { + var name string + var parentID string + if err := rows.Scan(&name, &parentID); err != nil { + return refs + } + refs = append(refs, &Edge{ + EntityID: id, + Name: name, + ParentID: parentID, + }) + } + return refs +} + +// Delete the reference to an entity at a given path. +func (db *Database) Delete(name string) error { + db.mux.Lock() + defer db.mux.Unlock() + + if name == "/" { + return fmt.Errorf("Cannot delete root entity") + } + + parentPath, n := splitPath(name) + parent, err := db.get(parentPath) + if err != nil { + return err + } + + if _, err := db.conn.Exec("DELETE FROM edge WHERE parent_id = ? AND name = ?;", parent.id, n); err != nil { + return err + } + return nil +} + +// Purge removes the entity with the specified id +// Walk the graph to make sure all references to the entity +// are removed and return the number of references removed +func (db *Database) Purge(id string) (int, error) { + db.mux.Lock() + defer db.mux.Unlock() + + tx, err := db.conn.Begin() + if err != nil { + return -1, err + } + + // Delete all edges + rows, err := tx.Exec("DELETE FROM edge WHERE entity_id = ?;", id) + if err != nil { + tx.Rollback() + return -1, err + } + changes, err := rows.RowsAffected() + if err != nil { + return -1, err + } + + // Clear who's using this id as parent + refs, err := tx.Exec("DELETE FROM edge WHERE parent_id = ?;", id) + if err != nil { + tx.Rollback() + return -1, err + } + refsCount, err := refs.RowsAffected() + if err != nil { + return -1, err + } + + // Delete entity + if _, err := tx.Exec("DELETE FROM entity where id = ?;", id); err != nil { + tx.Rollback() + return -1, err + } + + if err := tx.Commit(); err != nil { + return -1, err + } + + return int(changes + refsCount), nil +} + +// Rename an edge for a given path +func (db *Database) Rename(currentName, newName string) error { + db.mux.Lock() + defer db.mux.Unlock() + + parentPath, name := splitPath(currentName) + newParentPath, newEdgeName := splitPath(newName) + + if parentPath != newParentPath { + return fmt.Errorf("Cannot rename when root paths do not match %s != %s", parentPath, newParentPath) + } + + parent, err := db.get(parentPath) + if err != nil { + return err + } + + rows, err := db.conn.Exec("UPDATE edge SET name = ? WHERE parent_id = ? AND name = ?;", newEdgeName, parent.id, name) + if err != nil { + return err + } + i, err := rows.RowsAffected() + if err != nil { + return err + } + if i == 0 { + return fmt.Errorf("Cannot locate edge for %s %s", parent.id, name) + } + return nil +} + +// WalkMeta stores the walk metadata. +type WalkMeta struct { + Parent *Entity + Entity *Entity + FullPath string + Edge *Edge +} + +func (db *Database) children(e *Entity, name string, depth int, entities []WalkMeta) ([]WalkMeta, error) { + if e == nil { + return entities, nil + } + + rows, err := db.conn.Query("SELECT entity_id, name FROM edge where parent_id = ?;", e.id) + if err != nil { + return nil, err + } + defer rows.Close() + + for rows.Next() { + var entityID, entityName string + if err := rows.Scan(&entityID, &entityName); err != nil { + return nil, err + } + child := &Entity{entityID} + edge := &Edge{ + ParentID: e.id, + Name: entityName, + EntityID: child.id, + } + + meta := WalkMeta{ + Parent: e, + Entity: child, + FullPath: path.Join(name, edge.Name), + Edge: edge, + } + + entities = append(entities, meta) + + if depth != 0 { + nDepth := depth + if depth != -1 { + nDepth-- + } + entities, err = db.children(child, meta.FullPath, nDepth, entities) + if err != nil { + return nil, err + } + } + } + + return entities, nil +} + +func (db *Database) parents(e *Entity) (parents []string, err error) { + if e == nil { + return parents, nil + } + + rows, err := db.conn.Query("SELECT parent_id FROM edge where entity_id = ?;", e.id) + if err != nil { + return nil, err + } + defer rows.Close() + + for rows.Next() { + var parentID string + if err := rows.Scan(&parentID); err != nil { + return nil, err + } + parents = append(parents, parentID) + } + + return parents, nil +} + +// Return the entity based on the parent path and name. +func (db *Database) child(parent *Entity, name string) *Entity { + var id string + if err := db.conn.QueryRow("SELECT entity_id FROM edge WHERE parent_id = ? AND name = ?;", parent.id, name).Scan(&id); err != nil { + return nil + } + return &Entity{id} +} + +// ID returns the id used to reference this entity. +func (e *Entity) ID() string { + return e.id +} + +// Paths returns the paths sorted by depth. +func (e Entities) Paths() []string { + out := make([]string, len(e)) + var i int + for k := range e { + out[i] = k + i++ + } + sortByDepth(out) + + return out +} diff --git a/pkg/graphdb/graphdb_test.go b/pkg/graphdb/graphdb_test.go new file mode 100644 index 0000000000..9a8930bcd8 --- /dev/null +++ b/pkg/graphdb/graphdb_test.go @@ -0,0 +1,657 @@ +package graphdb + +import ( + "database/sql" + "fmt" + "os" + "path" + "strconv" + "testing" + + _ "github.com/mattn/go-sqlite3" +) + +func newTestDb(t *testing.T) (*Database, string) { + p := path.Join(os.TempDir(), "sqlite.db") + conn, err := sql.Open("sqlite3", p) + db, err := NewDatabase(conn) + if err != nil { + t.Fatal(err) + } + return db, p +} + +func destroyTestDb(dbPath string) { + os.Remove(dbPath) +} + +func TestNewDatabase(t *testing.T) { + db, dbpath := newTestDb(t) + if db == nil { + t.Fatal("Database should not be nil") + } + db.Close() + defer destroyTestDb(dbpath) +} + +func TestCreateRootEntity(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + root := db.RootEntity() + if root == nil { + t.Fatal("Root entity should not be nil") + } +} + +func TestGetRootEntity(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + e := db.Get("/") + if e == nil { + t.Fatal("Entity should not be nil") + } + if e.ID() != "0" { + t.Fatalf("Entity id should be 0, got %s", e.ID()) + } +} + +func TestSetEntityWithDifferentName(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/test", "1") + if _, err := db.Set("/other", "1"); err != nil { + t.Fatal(err) + } +} + +func TestSetDuplicateEntity(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + if _, err := db.Set("/foo", "42"); err != nil { + t.Fatal(err) + } + if _, err := db.Set("/foo", "43"); err == nil { + t.Fatalf("Creating an entry with a duplicate path did not cause an error") + } +} + +func TestCreateChild(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + child, err := db.Set("/db", "1") + if err != nil { + t.Fatal(err) + } + if child == nil { + t.Fatal("Child should not be nil") + } + if child.ID() != "1" { + t.Fail() + } +} + +func TestParents(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + for i := 1; i < 6; i++ { + a := strconv.Itoa(i) + if _, err := db.Set("/"+a, a); err != nil { + t.Fatal(err) + } + } + + for i := 6; i < 11; i++ { + a := strconv.Itoa(i) + p := strconv.Itoa(i - 5) + + key := fmt.Sprintf("/%s/%s", p, a) + + if _, err := db.Set(key, a); err != nil { + t.Fatal(err) + } + + parents, err := db.Parents(key) + if err != nil { + t.Fatal(err) + } + + if len(parents) != 1 { + t.Fatalf("Expected 1 entry for %s got %d", key, len(parents)) + } + + if parents[0] != p { + t.Fatalf("ID %s received, %s expected", parents[0], p) + } + } +} + +func TestChildren(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + str := "/" + for i := 1; i < 6; i++ { + a := strconv.Itoa(i) + if _, err := db.Set(str+a, a); err != nil { + t.Fatal(err) + } + + str = str + a + "/" + } + + str = "/" + for i := 10; i < 30; i++ { // 20 entities + a := strconv.Itoa(i) + if _, err := db.Set(str+a, a); err != nil { + t.Fatal(err) + } + + str = str + a + "/" + } + entries, err := db.Children("/", 5) + if err != nil { + t.Fatal(err) + } + + if len(entries) != 11 { + t.Fatalf("Expect 11 entries for / got %d", len(entries)) + } + + entries, err = db.Children("/", 20) + if err != nil { + t.Fatal(err) + } + + if len(entries) != 25 { + t.Fatalf("Expect 25 entries for / got %d", len(entries)) + } +} + +func TestListAllRootChildren(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + for i := 1; i < 6; i++ { + a := strconv.Itoa(i) + if _, err := db.Set("/"+a, a); err != nil { + t.Fatal(err) + } + } + entries := db.List("/", -1) + if len(entries) != 5 { + t.Fatalf("Expect 5 entries for / got %d", len(entries)) + } +} + +func TestListAllSubChildren(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + _, err := db.Set("/webapp", "1") + if err != nil { + t.Fatal(err) + } + child2, err := db.Set("/db", "2") + if err != nil { + t.Fatal(err) + } + child4, err := db.Set("/logs", "4") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/db/logs", child4.ID()); err != nil { + t.Fatal(err) + } + + child3, err := db.Set("/sentry", "3") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/sentry", child3.ID()); err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/db", child2.ID()); err != nil { + t.Fatal(err) + } + + entries := db.List("/webapp", 1) + if len(entries) != 3 { + t.Fatalf("Expect 3 entries for / got %d", len(entries)) + } + + entries = db.List("/webapp", 0) + if len(entries) != 2 { + t.Fatalf("Expect 2 entries for / got %d", len(entries)) + } +} + +func TestAddSelfAsChild(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + child, err := db.Set("/test", "1") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/test/other", child.ID()); err == nil { + t.Fatal("Error should not be nil") + } +} + +func TestAddChildToNonExistentRoot(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + if _, err := db.Set("/myapp", "1"); err != nil { + t.Fatal(err) + } + + if _, err := db.Set("/myapp/proxy/db", "2"); err == nil { + t.Fatal("Error should not be nil") + } +} + +func TestWalkAll(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + _, err := db.Set("/webapp", "1") + if err != nil { + t.Fatal(err) + } + child2, err := db.Set("/db", "2") + if err != nil { + t.Fatal(err) + } + child4, err := db.Set("/db/logs", "4") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/logs", child4.ID()); err != nil { + t.Fatal(err) + } + + child3, err := db.Set("/sentry", "3") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/sentry", child3.ID()); err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/db", child2.ID()); err != nil { + t.Fatal(err) + } + + child5, err := db.Set("/gograph", "5") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/same-ref-diff-name", child5.ID()); err != nil { + t.Fatal(err) + } + + if err := db.Walk("/", func(p string, e *Entity) error { + t.Logf("Path: %s Entity: %s", p, e.ID()) + return nil + }, -1); err != nil { + t.Fatal(err) + } +} + +func TestGetEntityByPath(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + _, err := db.Set("/webapp", "1") + if err != nil { + t.Fatal(err) + } + child2, err := db.Set("/db", "2") + if err != nil { + t.Fatal(err) + } + child4, err := db.Set("/logs", "4") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/db/logs", child4.ID()); err != nil { + t.Fatal(err) + } + + child3, err := db.Set("/sentry", "3") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/sentry", child3.ID()); err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/db", child2.ID()); err != nil { + t.Fatal(err) + } + + child5, err := db.Set("/gograph", "5") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/same-ref-diff-name", child5.ID()); err != nil { + t.Fatal(err) + } + + entity := db.Get("/webapp/db/logs") + if entity == nil { + t.Fatal("Entity should not be nil") + } + if entity.ID() != "4" { + t.Fatalf("Expected to get entity with id 4, got %s", entity.ID()) + } +} + +func TestEnitiesPaths(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + _, err := db.Set("/webapp", "1") + if err != nil { + t.Fatal(err) + } + child2, err := db.Set("/db", "2") + if err != nil { + t.Fatal(err) + } + child4, err := db.Set("/logs", "4") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/db/logs", child4.ID()); err != nil { + t.Fatal(err) + } + + child3, err := db.Set("/sentry", "3") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/sentry", child3.ID()); err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/db", child2.ID()); err != nil { + t.Fatal(err) + } + + child5, err := db.Set("/gograph", "5") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/same-ref-diff-name", child5.ID()); err != nil { + t.Fatal(err) + } + + out := db.List("/", -1) + for _, p := range out.Paths() { + t.Log(p) + } +} + +func TestDeleteRootEntity(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + if err := db.Delete("/"); err == nil { + t.Fatal("Error should not be nil") + } +} + +func TestDeleteEntity(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + _, err := db.Set("/webapp", "1") + if err != nil { + t.Fatal(err) + } + child2, err := db.Set("/db", "2") + if err != nil { + t.Fatal(err) + } + child4, err := db.Set("/logs", "4") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/db/logs", child4.ID()); err != nil { + t.Fatal(err) + } + + child3, err := db.Set("/sentry", "3") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/sentry", child3.ID()); err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/db", child2.ID()); err != nil { + t.Fatal(err) + } + + child5, err := db.Set("/gograph", "5") + if err != nil { + t.Fatal(err) + } + if _, err := db.Set("/webapp/same-ref-diff-name", child5.ID()); err != nil { + t.Fatal(err) + } + + if err := db.Delete("/webapp/sentry"); err != nil { + t.Fatal(err) + } + entity := db.Get("/webapp/sentry") + if entity != nil { + t.Fatal("Entity /webapp/sentry should be nil") + } +} + +func TestCountRefs(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/webapp", "1") + + if db.Refs("1") != 1 { + t.Fatal("Expect reference count to be 1") + } + + db.Set("/db", "2") + db.Set("/webapp/db", "2") + if db.Refs("2") != 2 { + t.Fatal("Expect reference count to be 2") + } +} + +func TestPurgeId(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/webapp", "1") + + if c := db.Refs("1"); c != 1 { + t.Fatalf("Expect reference count to be 1, got %d", c) + } + + db.Set("/db", "2") + db.Set("/webapp/db", "2") + + count, err := db.Purge("2") + if err != nil { + t.Fatal(err) + } + if count != 2 { + t.Fatalf("Expected 2 references to be removed, got %d", count) + } +} + +// Regression test https://github.com/docker/docker/issues/12334 +func TestPurgeIdRefPaths(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/webapp", "1") + db.Set("/db", "2") + + db.Set("/db/webapp", "1") + + if c := db.Refs("1"); c != 2 { + t.Fatalf("Expected 2 reference for webapp, got %d", c) + } + if c := db.Refs("2"); c != 1 { + t.Fatalf("Expected 1 reference for db, got %d", c) + } + + if rp := db.RefPaths("2"); len(rp) != 1 { + t.Fatalf("Expected 1 reference path for db, got %d", len(rp)) + } + + count, err := db.Purge("2") + if err != nil { + t.Fatal(err) + } + + if count != 2 { + t.Fatalf("Expected 2 rows to be removed, got %d", count) + } + + if c := db.Refs("2"); c != 0 { + t.Fatalf("Expected 0 reference for db, got %d", c) + } + if c := db.Refs("1"); c != 1 { + t.Fatalf("Expected 1 reference for webapp, got %d", c) + } +} + +func TestRename(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/webapp", "1") + + if db.Refs("1") != 1 { + t.Fatal("Expect reference count to be 1") + } + + db.Set("/db", "2") + db.Set("/webapp/db", "2") + + if db.Get("/webapp/db") == nil { + t.Fatal("Cannot find entity at path /webapp/db") + } + + if err := db.Rename("/webapp/db", "/webapp/newdb"); err != nil { + t.Fatal(err) + } + if db.Get("/webapp/db") != nil { + t.Fatal("Entity should not exist at /webapp/db") + } + if db.Get("/webapp/newdb") == nil { + t.Fatal("Cannot find entity at path /webapp/newdb") + } + +} + +func TestCreateMultipleNames(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/db", "1") + if _, err := db.Set("/myapp", "1"); err != nil { + t.Fatal(err) + } + + db.Walk("/", func(p string, e *Entity) error { + t.Logf("%s\n", p) + return nil + }, -1) +} + +func TestRefPaths(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/webapp", "1") + + db.Set("/db", "2") + db.Set("/webapp/db", "2") + + refs := db.RefPaths("2") + if len(refs) != 2 { + t.Fatalf("Expected reference count to be 2, got %d", len(refs)) + } +} + +func TestExistsTrue(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/testing", "1") + + if !db.Exists("/testing") { + t.Fatalf("/tesing should exist") + } +} + +func TestExistsFalse(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/toerhe", "1") + + if db.Exists("/testing") { + t.Fatalf("/tesing should not exist") + } + +} + +func TestGetNameWithTrailingSlash(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + db.Set("/todo", "1") + + e := db.Get("/todo/") + if e == nil { + t.Fatalf("Entity should not be nil") + } +} + +func TestConcurrentWrites(t *testing.T) { + db, dbpath := newTestDb(t) + defer destroyTestDb(dbpath) + + errs := make(chan error, 2) + + save := func(name string, id string) { + if _, err := db.Set(fmt.Sprintf("/%s", name), id); err != nil { + errs <- err + } + errs <- nil + } + purge := func(id string) { + if _, err := db.Purge(id); err != nil { + errs <- err + } + errs <- nil + } + + save("/1", "1") + + go purge("1") + go save("/2", "2") + + any := false + for i := 0; i < 2; i++ { + if err := <-errs; err != nil { + any = true + t.Log(err) + } + } + if any { + t.Fail() + } +} diff --git a/pkg/graphdb/sort.go b/pkg/graphdb/sort.go new file mode 100644 index 0000000000..c07df077d8 --- /dev/null +++ b/pkg/graphdb/sort.go @@ -0,0 +1,27 @@ +package graphdb + +import "sort" + +type pathSorter struct { + paths []string + by func(i, j string) bool +} + +func sortByDepth(paths []string) { + s := &pathSorter{paths, func(i, j string) bool { + return PathDepth(i) > PathDepth(j) + }} + sort.Sort(s) +} + +func (s *pathSorter) Len() int { + return len(s.paths) +} + +func (s *pathSorter) Swap(i, j int) { + s.paths[i], s.paths[j] = s.paths[j], s.paths[i] +} + +func (s *pathSorter) Less(i, j int) bool { + return s.by(s.paths[i], s.paths[j]) +} diff --git a/pkg/graphdb/sort_test.go b/pkg/graphdb/sort_test.go new file mode 100644 index 0000000000..ddf2266f60 --- /dev/null +++ b/pkg/graphdb/sort_test.go @@ -0,0 +1,29 @@ +package graphdb + +import ( + "testing" +) + +func TestSort(t *testing.T) { + paths := []string{ + "/", + "/myreallylongname", + "/app/db", + } + + sortByDepth(paths) + + if len(paths) != 3 { + t.Fatalf("Expected 3 parts got %d", len(paths)) + } + + if paths[0] != "/app/db" { + t.Fatalf("Expected /app/db got %s", paths[0]) + } + if paths[1] != "/myreallylongname" { + t.Fatalf("Expected /myreallylongname got %s", paths[1]) + } + if paths[2] != "/" { + t.Fatalf("Expected / got %s", paths[2]) + } +} diff --git a/pkg/graphdb/utils.go b/pkg/graphdb/utils.go new file mode 100644 index 0000000000..9edd79c35e --- /dev/null +++ b/pkg/graphdb/utils.go @@ -0,0 +1,32 @@ +package graphdb + +import ( + "path" + "strings" +) + +// Split p on / +func split(p string) []string { + return strings.Split(p, "/") +} + +// PathDepth returns the depth or number of / in a given path +func PathDepth(p string) int { + parts := split(p) + if len(parts) == 2 && parts[1] == "" { + return 1 + } + return len(parts) +} + +func splitPath(p string) (parent, name string) { + if p[0] != '/' { + p = "/" + p + } + parent, name = path.Split(p) + l := len(parent) + if parent[l-1] == '/' { + parent = parent[:l-1] + } + return +} diff --git a/pkg/homedir/homedir.go b/pkg/homedir/homedir.go new file mode 100644 index 0000000000..8154e83f0c --- /dev/null +++ b/pkg/homedir/homedir.go @@ -0,0 +1,39 @@ +package homedir + +import ( + "os" + "runtime" + + "github.com/opencontainers/runc/libcontainer/user" +) + +// Key returns the env var name for the user's home dir based on +// the platform being run on +func Key() string { + if runtime.GOOS == "windows" { + return "USERPROFILE" + } + return "HOME" +} + +// Get returns the home directory of the current user with the help of +// environment variables depending on the target operating system. +// Returned path should be used with "path/filepath" to form new paths. +func Get() string { + home := os.Getenv(Key()) + if home == "" && runtime.GOOS != "windows" { + if u, err := user.CurrentUser(); err == nil { + return u.Home + } + } + return home +} + +// GetShortcutString returns the string that is shortcut to user's home directory +// in the native shell of the platform running on. +func GetShortcutString() string { + if runtime.GOOS == "windows" { + return "%USERPROFILE%" // be careful while using in format functions + } + return "~" +} diff --git a/pkg/homedir/homedir_test.go b/pkg/homedir/homedir_test.go new file mode 100644 index 0000000000..7a95cb2bd7 --- /dev/null +++ b/pkg/homedir/homedir_test.go @@ -0,0 +1,24 @@ +package homedir + +import ( + "path/filepath" + "testing" +) + +func TestGet(t *testing.T) { + home := Get() + if home == "" { + t.Fatal("returned home directory is empty") + } + + if !filepath.IsAbs(home) { + t.Fatalf("returned path is not absolute: %s", home) + } +} + +func TestGetShortcutString(t *testing.T) { + shortcut := GetShortcutString() + if shortcut == "" { + t.Fatal("returned shortcut string is empty") + } +} diff --git a/pkg/httputils/httputils.go b/pkg/httputils/httputils.go new file mode 100644 index 0000000000..d7dc43877d --- /dev/null +++ b/pkg/httputils/httputils.go @@ -0,0 +1,56 @@ +package httputils + +import ( + "errors" + "fmt" + "net/http" + "regexp" + "strings" + + "github.com/docker/docker/pkg/jsonmessage" +) + +var ( + headerRegexp = regexp.MustCompile(`^(?:(.+)/(.+?))\((.+)\).*$`) + errInvalidHeader = errors.New("Bad header, should be in format `docker/version (platform)`") +) + +// Download requests a given URL and returns an io.Reader. +func Download(url string) (resp *http.Response, err error) { + if resp, err = http.Get(url); err != nil { + return nil, err + } + if resp.StatusCode >= 400 { + return nil, fmt.Errorf("Got HTTP status code >= 400: %s", resp.Status) + } + return resp, nil +} + +// NewHTTPRequestError returns a JSON response error. +func NewHTTPRequestError(msg string, res *http.Response) error { + return &jsonmessage.JSONError{ + Message: msg, + Code: res.StatusCode, + } +} + +// ServerHeader contains the server information. +type ServerHeader struct { + App string // docker + Ver string // 1.8.0-dev + OS string // windows or linux +} + +// ParseServerHeader extracts pieces from an HTTP server header +// which is in the format "docker/version (os)" eg docker/1.8.0-dev (windows). +func ParseServerHeader(hdr string) (*ServerHeader, error) { + matches := headerRegexp.FindStringSubmatch(hdr) + if len(matches) != 4 { + return nil, errInvalidHeader + } + return &ServerHeader{ + App: strings.TrimSpace(matches[1]), + Ver: strings.TrimSpace(matches[2]), + OS: strings.TrimSpace(matches[3]), + }, nil +} diff --git a/pkg/httputils/httputils_test.go b/pkg/httputils/httputils_test.go new file mode 100644 index 0000000000..d35d082156 --- /dev/null +++ b/pkg/httputils/httputils_test.go @@ -0,0 +1,115 @@ +package httputils + +import ( + "fmt" + "io/ioutil" + "net/http" + "net/http/httptest" + "strings" + "testing" +) + +func TestDownload(t *testing.T) { + expected := "Hello, docker !" + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintf(w, expected) + })) + defer ts.Close() + response, err := Download(ts.URL) + if err != nil { + t.Fatal(err) + } + + actual, err := ioutil.ReadAll(response.Body) + response.Body.Close() + + if err != nil || string(actual) != expected { + t.Fatalf("Expected the response %q, got err:%v, response:%v, actual:%s", expected, err, response, string(actual)) + } +} + +func TestDownload400Errors(t *testing.T) { + expectedError := "Got HTTP status code >= 400: 403 Forbidden" + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + // 403 + http.Error(w, "something failed (forbidden)", http.StatusForbidden) + })) + defer ts.Close() + // Expected status code = 403 + if _, err := Download(ts.URL); err == nil || err.Error() != expectedError { + t.Fatalf("Expected the the error %q, got %v", expectedError, err) + } +} + +func TestDownloadOtherErrors(t *testing.T) { + if _, err := Download("I'm not an url.."); err == nil || !strings.Contains(err.Error(), "unsupported protocol scheme") { + t.Fatalf("Expected an error with 'unsupported protocol scheme', got %v", err) + } +} + +func TestNewHTTPRequestError(t *testing.T) { + errorMessage := "Some error message" + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + // 403 + http.Error(w, errorMessage, http.StatusForbidden) + })) + defer ts.Close() + httpResponse, err := http.Get(ts.URL) + if err != nil { + t.Fatal(err) + } + if err := NewHTTPRequestError(errorMessage, httpResponse); err.Error() != errorMessage { + t.Fatalf("Expected err to be %q, got %v", errorMessage, err) + } +} + +func TestParseServerHeader(t *testing.T) { + inputs := map[string][]string{ + "bad header": {"error"}, + "(bad header)": {"error"}, + "(without/spaces)": {"error"}, + "(header/with spaces)": {"error"}, + "foo/bar (baz)": {"foo", "bar", "baz"}, + "foo/bar": {"error"}, + "foo": {"error"}, + "foo/bar (baz space)": {"foo", "bar", "baz space"}, + " f f / b b ( b s ) ": {"f f", "b b", "b s"}, + "foo/bar (baz) ignore": {"foo", "bar", "baz"}, + "foo/bar ()": {"error"}, + "foo/bar()": {"error"}, + "foo/bar(baz)": {"foo", "bar", "baz"}, + "foo/bar/zzz(baz)": {"foo/bar", "zzz", "baz"}, + "foo/bar(baz/abc)": {"foo", "bar", "baz/abc"}, + "foo/bar(baz (abc))": {"foo", "bar", "baz (abc)"}, + } + + for header, values := range inputs { + serverHeader, err := ParseServerHeader(header) + if err != nil { + if err != errInvalidHeader { + t.Fatalf("Failed to parse %q, and got some unexpected error: %q", header, err) + } + if values[0] == "error" { + continue + } + t.Fatalf("Header %q failed to parse when it shouldn't have", header) + } + if values[0] == "error" { + t.Fatalf("Header %q parsed ok when it should have failed(%q).", header, serverHeader) + } + + if serverHeader.App != values[0] { + t.Fatalf("Expected serverHeader.App for %q to equal %q, got %q", header, values[0], serverHeader.App) + } + + if serverHeader.Ver != values[1] { + t.Fatalf("Expected serverHeader.Ver for %q to equal %q, got %q", header, values[1], serverHeader.Ver) + } + + if serverHeader.OS != values[2] { + t.Fatalf("Expected serverHeader.OS for %q to equal %q, got %q", header, values[2], serverHeader.OS) + } + + } + +} diff --git a/pkg/httputils/mimetype.go b/pkg/httputils/mimetype.go new file mode 100644 index 0000000000..d5cf34e4f2 --- /dev/null +++ b/pkg/httputils/mimetype.go @@ -0,0 +1,30 @@ +package httputils + +import ( + "mime" + "net/http" +) + +// MimeTypes stores the MIME content type. +var MimeTypes = struct { + TextPlain string + Tar string + OctetStream string +}{"text/plain", "application/tar", "application/octet-stream"} + +// DetectContentType returns a best guess representation of the MIME +// content type for the bytes at c. The value detected by +// http.DetectContentType is guaranteed not be nil, defaulting to +// application/octet-stream when a better guess cannot be made. The +// result of this detection is then run through mime.ParseMediaType() +// which separates the actual MIME string from any parameters. +func DetectContentType(c []byte) (string, map[string]string, error) { + + ct := http.DetectContentType(c) + contentType, args, err := mime.ParseMediaType(ct) + if err != nil { + return "", nil, err + } + + return contentType, args, nil +} diff --git a/pkg/httputils/mimetype_test.go b/pkg/httputils/mimetype_test.go new file mode 100644 index 0000000000..9de433ee8c --- /dev/null +++ b/pkg/httputils/mimetype_test.go @@ -0,0 +1,13 @@ +package httputils + +import ( + "testing" +) + +func TestDetectContentType(t *testing.T) { + input := []byte("That is just a plain text") + + if contentType, _, err := DetectContentType(input); err != nil || contentType != "text/plain" { + t.Errorf("TestDetectContentType failed") + } +} diff --git a/pkg/httputils/resumablerequestreader.go b/pkg/httputils/resumablerequestreader.go new file mode 100644 index 0000000000..bebc8608cd --- /dev/null +++ b/pkg/httputils/resumablerequestreader.go @@ -0,0 +1,95 @@ +package httputils + +import ( + "fmt" + "io" + "net/http" + "time" + + "github.com/Sirupsen/logrus" +) + +type resumableRequestReader struct { + client *http.Client + request *http.Request + lastRange int64 + totalSize int64 + currentResponse *http.Response + failures uint32 + maxFailures uint32 +} + +// ResumableRequestReader makes it possible to resume reading a request's body transparently +// maxfail is the number of times we retry to make requests again (not resumes) +// totalsize is the total length of the body; auto detect if not provided +func ResumableRequestReader(c *http.Client, r *http.Request, maxfail uint32, totalsize int64) io.ReadCloser { + return &resumableRequestReader{client: c, request: r, maxFailures: maxfail, totalSize: totalsize} +} + +// ResumableRequestReaderWithInitialResponse makes it possible to resume +// reading the body of an already initiated request. +func ResumableRequestReaderWithInitialResponse(c *http.Client, r *http.Request, maxfail uint32, totalsize int64, initialResponse *http.Response) io.ReadCloser { + return &resumableRequestReader{client: c, request: r, maxFailures: maxfail, totalSize: totalsize, currentResponse: initialResponse} +} + +func (r *resumableRequestReader) Read(p []byte) (n int, err error) { + if r.client == nil || r.request == nil { + return 0, fmt.Errorf("client and request can't be nil\n") + } + isFreshRequest := false + if r.lastRange != 0 && r.currentResponse == nil { + readRange := fmt.Sprintf("bytes=%d-%d", r.lastRange, r.totalSize) + r.request.Header.Set("Range", readRange) + time.Sleep(5 * time.Second) + } + if r.currentResponse == nil { + r.currentResponse, err = r.client.Do(r.request) + isFreshRequest = true + } + if err != nil && r.failures+1 != r.maxFailures { + r.cleanUpResponse() + r.failures++ + time.Sleep(5 * time.Duration(r.failures) * time.Second) + return 0, nil + } else if err != nil { + r.cleanUpResponse() + return 0, err + } + if r.currentResponse.StatusCode == 416 && r.lastRange == r.totalSize && r.currentResponse.ContentLength == 0 { + r.cleanUpResponse() + return 0, io.EOF + } else if r.currentResponse.StatusCode != 206 && r.lastRange != 0 && isFreshRequest { + r.cleanUpResponse() + return 0, fmt.Errorf("the server doesn't support byte ranges") + } + if r.totalSize == 0 { + r.totalSize = r.currentResponse.ContentLength + } else if r.totalSize <= 0 { + r.cleanUpResponse() + return 0, fmt.Errorf("failed to auto detect content length") + } + n, err = r.currentResponse.Body.Read(p) + r.lastRange += int64(n) + if err != nil { + r.cleanUpResponse() + } + if err != nil && err != io.EOF { + logrus.Infof("encountered error during pull and clearing it before resume: %s", err) + err = nil + } + return n, err +} + +func (r *resumableRequestReader) Close() error { + r.cleanUpResponse() + r.client = nil + r.request = nil + return nil +} + +func (r *resumableRequestReader) cleanUpResponse() { + if r.currentResponse != nil { + r.currentResponse.Body.Close() + r.currentResponse = nil + } +} diff --git a/pkg/httputils/resumablerequestreader_test.go b/pkg/httputils/resumablerequestreader_test.go new file mode 100644 index 0000000000..e9d0578306 --- /dev/null +++ b/pkg/httputils/resumablerequestreader_test.go @@ -0,0 +1,307 @@ +package httputils + +import ( + "fmt" + "io" + "io/ioutil" + "net/http" + "net/http/httptest" + "strings" + "testing" +) + +func TestResumableRequestHeaderSimpleErrors(t *testing.T) { + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintln(w, "Hello, world !") + })) + defer ts.Close() + + client := &http.Client{} + + var req *http.Request + req, err := http.NewRequest("GET", ts.URL, nil) + if err != nil { + t.Fatal(err) + } + + expectedError := "client and request can't be nil\n" + resreq := &resumableRequestReader{} + _, err = resreq.Read([]byte{}) + if err == nil || err.Error() != expectedError { + t.Fatalf("Expected an error with '%s', got %v.", expectedError, err) + } + + resreq = &resumableRequestReader{ + client: client, + request: req, + totalSize: -1, + } + expectedError = "failed to auto detect content length" + _, err = resreq.Read([]byte{}) + if err == nil || err.Error() != expectedError { + t.Fatalf("Expected an error with '%s', got %v.", expectedError, err) + } + +} + +// Not too much failures, bails out after some wait +func TestResumableRequestHeaderNotTooMuchFailures(t *testing.T) { + client := &http.Client{} + + var badReq *http.Request + badReq, err := http.NewRequest("GET", "I'm not an url", nil) + if err != nil { + t.Fatal(err) + } + + resreq := &resumableRequestReader{ + client: client, + request: badReq, + failures: 0, + maxFailures: 2, + } + read, err := resreq.Read([]byte{}) + if err != nil || read != 0 { + t.Fatalf("Expected no error and no byte read, got err:%v, read:%v.", err, read) + } +} + +// Too much failures, returns the error +func TestResumableRequestHeaderTooMuchFailures(t *testing.T) { + client := &http.Client{} + + var badReq *http.Request + badReq, err := http.NewRequest("GET", "I'm not an url", nil) + if err != nil { + t.Fatal(err) + } + + resreq := &resumableRequestReader{ + client: client, + request: badReq, + failures: 0, + maxFailures: 1, + } + defer resreq.Close() + + expectedError := `Get I%27m%20not%20an%20url: unsupported protocol scheme ""` + read, err := resreq.Read([]byte{}) + if err == nil || err.Error() != expectedError || read != 0 { + t.Fatalf("Expected the error '%s', got err:%v, read:%v.", expectedError, err, read) + } +} + +type errorReaderCloser struct{} + +func (errorReaderCloser) Close() error { return nil } + +func (errorReaderCloser) Read(p []byte) (n int, err error) { + return 0, fmt.Errorf("A error occured") +} + +// If a an unknown error is encountered, return 0, nil and log it +func TestResumableRequestReaderWithReadError(t *testing.T) { + var req *http.Request + req, err := http.NewRequest("GET", "", nil) + if err != nil { + t.Fatal(err) + } + + client := &http.Client{} + + response := &http.Response{ + Status: "500 Internal Server", + StatusCode: 500, + ContentLength: 0, + Close: true, + Body: errorReaderCloser{}, + } + + resreq := &resumableRequestReader{ + client: client, + request: req, + currentResponse: response, + lastRange: 1, + totalSize: 1, + } + defer resreq.Close() + + buf := make([]byte, 1) + read, err := resreq.Read(buf) + if err != nil { + t.Fatal(err) + } + + if read != 0 { + t.Fatalf("Expected to have read nothing, but read %v", read) + } +} + +func TestResumableRequestReaderWithEOFWith416Response(t *testing.T) { + var req *http.Request + req, err := http.NewRequest("GET", "", nil) + if err != nil { + t.Fatal(err) + } + + client := &http.Client{} + + response := &http.Response{ + Status: "416 Requested Range Not Satisfiable", + StatusCode: 416, + ContentLength: 0, + Close: true, + Body: ioutil.NopCloser(strings.NewReader("")), + } + + resreq := &resumableRequestReader{ + client: client, + request: req, + currentResponse: response, + lastRange: 1, + totalSize: 1, + } + defer resreq.Close() + + buf := make([]byte, 1) + _, err = resreq.Read(buf) + if err == nil || err != io.EOF { + t.Fatalf("Expected an io.EOF error, got %v", err) + } +} + +func TestResumableRequestReaderWithServerDoesntSupportByteRanges(t *testing.T) { + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.Header.Get("Range") == "" { + t.Fatalf("Expected a Range HTTP header, got nothing") + } + })) + defer ts.Close() + + var req *http.Request + req, err := http.NewRequest("GET", ts.URL, nil) + if err != nil { + t.Fatal(err) + } + + client := &http.Client{} + + resreq := &resumableRequestReader{ + client: client, + request: req, + lastRange: 1, + } + defer resreq.Close() + + buf := make([]byte, 2) + _, err = resreq.Read(buf) + if err == nil || err.Error() != "the server doesn't support byte ranges" { + t.Fatalf("Expected an error 'the server doesn't support byte ranges', got %v", err) + } +} + +func TestResumableRequestReaderWithZeroTotalSize(t *testing.T) { + + srvtxt := "some response text data" + + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintln(w, srvtxt) + })) + defer ts.Close() + + var req *http.Request + req, err := http.NewRequest("GET", ts.URL, nil) + if err != nil { + t.Fatal(err) + } + + client := &http.Client{} + retries := uint32(5) + + resreq := ResumableRequestReader(client, req, retries, 0) + defer resreq.Close() + + data, err := ioutil.ReadAll(resreq) + if err != nil { + t.Fatal(err) + } + + resstr := strings.TrimSuffix(string(data), "\n") + + if resstr != srvtxt { + t.Errorf("resstr != srvtxt") + } +} + +func TestResumableRequestReader(t *testing.T) { + + srvtxt := "some response text data" + + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintln(w, srvtxt) + })) + defer ts.Close() + + var req *http.Request + req, err := http.NewRequest("GET", ts.URL, nil) + if err != nil { + t.Fatal(err) + } + + client := &http.Client{} + retries := uint32(5) + imgSize := int64(len(srvtxt)) + + resreq := ResumableRequestReader(client, req, retries, imgSize) + defer resreq.Close() + + data, err := ioutil.ReadAll(resreq) + if err != nil { + t.Fatal(err) + } + + resstr := strings.TrimSuffix(string(data), "\n") + + if resstr != srvtxt { + t.Errorf("resstr != srvtxt") + } +} + +func TestResumableRequestReaderWithInitialResponse(t *testing.T) { + + srvtxt := "some response text data" + + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintln(w, srvtxt) + })) + defer ts.Close() + + var req *http.Request + req, err := http.NewRequest("GET", ts.URL, nil) + if err != nil { + t.Fatal(err) + } + + client := &http.Client{} + retries := uint32(5) + imgSize := int64(len(srvtxt)) + + res, err := client.Do(req) + if err != nil { + t.Fatal(err) + } + + resreq := ResumableRequestReaderWithInitialResponse(client, req, retries, imgSize, res) + defer resreq.Close() + + data, err := ioutil.ReadAll(resreq) + if err != nil { + t.Fatal(err) + } + + resstr := strings.TrimSuffix(string(data), "\n") + + if resstr != srvtxt { + t.Errorf("resstr != srvtxt") + } +} diff --git a/pkg/idtools/idtools.go b/pkg/idtools/idtools.go new file mode 100644 index 0000000000..f6671403e3 --- /dev/null +++ b/pkg/idtools/idtools.go @@ -0,0 +1,188 @@ +package idtools + +import ( + "bufio" + "fmt" + "os" + "sort" + "strconv" + "strings" +) + +// IDMap contains a single entry for user namespace range remapping. An array +// of IDMap entries represents the structure that will be provided to the Linux +// kernel for creating a user namespace. +type IDMap struct { + ContainerID int `json:"container_id"` + HostID int `json:"host_id"` + Size int `json:"size"` +} + +type subIDRange struct { + Start int + Length int +} + +type ranges []subIDRange + +func (e ranges) Len() int { return len(e) } +func (e ranges) Swap(i, j int) { e[i], e[j] = e[j], e[i] } +func (e ranges) Less(i, j int) bool { return e[i].Start < e[j].Start } + +const ( + subuidFileName string = "/etc/subuid" + subgidFileName string = "/etc/subgid" +) + +// MkdirAllAs creates a directory (include any along the path) and then modifies +// ownership to the requested uid/gid. If the directory already exists, this +// function will still change ownership to the requested uid/gid pair. +func MkdirAllAs(path string, mode os.FileMode, ownerUID, ownerGID int) error { + return mkdirAs(path, mode, ownerUID, ownerGID, true) +} + +// MkdirAs creates a directory and then modifies ownership to the requested uid/gid. +// If the directory already exists, this function still changes ownership +func MkdirAs(path string, mode os.FileMode, ownerUID, ownerGID int) error { + return mkdirAs(path, mode, ownerUID, ownerGID, false) +} + +// GetRootUIDGID retrieves the remapped root uid/gid pair from the set of maps. +// If the maps are empty, then the root uid/gid will default to "real" 0/0 +func GetRootUIDGID(uidMap, gidMap []IDMap) (int, int, error) { + var uid, gid int + + if uidMap != nil { + xUID, err := ToHost(0, uidMap) + if err != nil { + return -1, -1, err + } + uid = xUID + } + if gidMap != nil { + xGID, err := ToHost(0, gidMap) + if err != nil { + return -1, -1, err + } + gid = xGID + } + return uid, gid, nil +} + +// ToContainer takes an id mapping, and uses it to translate a +// host ID to the remapped ID. If no map is provided, then the translation +// assumes a 1-to-1 mapping and returns the passed in id +func ToContainer(hostID int, idMap []IDMap) (int, error) { + if idMap == nil { + return hostID, nil + } + for _, m := range idMap { + if (hostID >= m.HostID) && (hostID <= (m.HostID + m.Size - 1)) { + contID := m.ContainerID + (hostID - m.HostID) + return contID, nil + } + } + return -1, fmt.Errorf("Host ID %d cannot be mapped to a container ID", hostID) +} + +// ToHost takes an id mapping and a remapped ID, and translates the +// ID to the mapped host ID. If no map is provided, then the translation +// assumes a 1-to-1 mapping and returns the passed in id # +func ToHost(contID int, idMap []IDMap) (int, error) { + if idMap == nil { + return contID, nil + } + for _, m := range idMap { + if (contID >= m.ContainerID) && (contID <= (m.ContainerID + m.Size - 1)) { + hostID := m.HostID + (contID - m.ContainerID) + return hostID, nil + } + } + return -1, fmt.Errorf("Container ID %d cannot be mapped to a host ID", contID) +} + +// CreateIDMappings takes a requested user and group name and +// using the data from /etc/sub{uid,gid} ranges, creates the +// proper uid and gid remapping ranges for that user/group pair +func CreateIDMappings(username, groupname string) ([]IDMap, []IDMap, error) { + subuidRanges, err := parseSubuid(username) + if err != nil { + return nil, nil, err + } + subgidRanges, err := parseSubgid(groupname) + if err != nil { + return nil, nil, err + } + if len(subuidRanges) == 0 { + return nil, nil, fmt.Errorf("No subuid ranges found for user %q", username) + } + if len(subgidRanges) == 0 { + return nil, nil, fmt.Errorf("No subgid ranges found for group %q", groupname) + } + + return createIDMap(subuidRanges), createIDMap(subgidRanges), nil +} + +func createIDMap(subidRanges ranges) []IDMap { + idMap := []IDMap{} + + // sort the ranges by lowest ID first + sort.Sort(subidRanges) + containerID := 0 + for _, idrange := range subidRanges { + idMap = append(idMap, IDMap{ + ContainerID: containerID, + HostID: idrange.Start, + Size: idrange.Length, + }) + containerID = containerID + idrange.Length + } + return idMap +} + +func parseSubuid(username string) (ranges, error) { + return parseSubidFile(subuidFileName, username) +} + +func parseSubgid(username string) (ranges, error) { + return parseSubidFile(subgidFileName, username) +} + +func parseSubidFile(path, username string) (ranges, error) { + var rangeList ranges + + subidFile, err := os.Open(path) + if err != nil { + return rangeList, err + } + defer subidFile.Close() + + s := bufio.NewScanner(subidFile) + for s.Scan() { + if err := s.Err(); err != nil { + return rangeList, err + } + + text := strings.TrimSpace(s.Text()) + if text == "" { + continue + } + parts := strings.Split(text, ":") + if len(parts) != 3 { + return rangeList, fmt.Errorf("Cannot parse subuid/gid information: Format not correct for %s file", path) + } + if parts[0] == username { + // return the first entry for a user; ignores potential for multiple ranges per user + startid, err := strconv.Atoi(parts[1]) + if err != nil { + return rangeList, fmt.Errorf("String to int conversion failed during subuid/gid parsing of %s: %v", path, err) + } + length, err := strconv.Atoi(parts[2]) + if err != nil { + return rangeList, fmt.Errorf("String to int conversion failed during subuid/gid parsing of %s: %v", path, err) + } + rangeList = append(rangeList, subIDRange{startid, length}) + } + } + return rangeList, nil +} diff --git a/pkg/idtools/usergroupadd_linux.go b/pkg/idtools/usergroupadd_linux.go new file mode 100644 index 0000000000..c65fc33687 --- /dev/null +++ b/pkg/idtools/usergroupadd_linux.go @@ -0,0 +1,175 @@ +package idtools + +import ( + "fmt" + "os" + "os/exec" + "path/filepath" + "strings" + "syscall" + + "github.com/docker/docker/pkg/system" +) + +// add a user and/or group to Linux /etc/passwd, /etc/group using standard +// Linux distribution commands: +// adduser --uid --shell /bin/login --no-create-home --disabled-login --ingroup +// useradd -M -u -s /bin/nologin -N -g +// addgroup --gid +// groupadd -g + +const baseUID int = 10000 +const baseGID int = 10000 +const idMAX int = 65534 + +var ( + userCommand string + groupCommand string + + cmdTemplates = map[string]string{ + "adduser": "--uid %d --shell /bin/false --no-create-home --disabled-login --ingroup %s %s", + "useradd": "-M -u %d -s /bin/false -N -g %s %s", + "addgroup": "--gid %d %s", + "groupadd": "-g %d %s", + } +) + +func init() { + // set up which commands are used for adding users/groups dependent on distro + if _, err := resolveBinary("adduser"); err == nil { + userCommand = "adduser" + } else if _, err := resolveBinary("useradd"); err == nil { + userCommand = "useradd" + } + if _, err := resolveBinary("addgroup"); err == nil { + groupCommand = "addgroup" + } else if _, err := resolveBinary("groupadd"); err == nil { + groupCommand = "groupadd" + } +} + +func resolveBinary(binname string) (string, error) { + binaryPath, err := exec.LookPath(binname) + if err != nil { + return "", err + } + resolvedPath, err := filepath.EvalSymlinks(binaryPath) + if err != nil { + return "", err + } + //only return no error if the final resolved binary basename + //matches what was searched for + if filepath.Base(resolvedPath) == binname { + return resolvedPath, nil + } + return "", fmt.Errorf("Binary %q does not resolve to a binary of that name in $PATH (%q)", binname, resolvedPath) +} + +// AddNamespaceRangesUser takes a name and finds an unused uid, gid pair +// and calls the appropriate helper function to add the group and then +// the user to the group in /etc/group and /etc/passwd respectively. +// This new user's /etc/sub{uid,gid} ranges will be used for user namespace +// mapping ranges in containers. +func AddNamespaceRangesUser(name string) (int, int, error) { + // Find unused uid, gid pair + uid, err := findUnusedUID(baseUID) + if err != nil { + return -1, -1, fmt.Errorf("Unable to find unused UID: %v", err) + } + gid, err := findUnusedGID(baseGID) + if err != nil { + return -1, -1, fmt.Errorf("Unable to find unused GID: %v", err) + } + + // First add the group that we will use + if err := addGroup(name, gid); err != nil { + return -1, -1, fmt.Errorf("Error adding group %q: %v", name, err) + } + // Add the user as a member of the group + if err := addUser(name, uid, name); err != nil { + return -1, -1, fmt.Errorf("Error adding user %q: %v", name, err) + } + return uid, gid, nil +} + +func addUser(userName string, uid int, groupName string) error { + + if userCommand == "" { + return fmt.Errorf("Cannot add user; no useradd/adduser binary found") + } + args := fmt.Sprintf(cmdTemplates[userCommand], uid, groupName, userName) + return execAddCmd(userCommand, args) +} + +func addGroup(groupName string, gid int) error { + + if groupCommand == "" { + return fmt.Errorf("Cannot add group; no groupadd/addgroup binary found") + } + args := fmt.Sprintf(cmdTemplates[groupCommand], gid, groupName) + // only error out if the error isn't that the group already exists + // if the group exists then our needs are already met + if err := execAddCmd(groupCommand, args); err != nil && !strings.Contains(err.Error(), "already exists") { + return err + } + return nil +} + +func execAddCmd(cmd, args string) error { + execCmd := exec.Command(cmd, strings.Split(args, " ")...) + out, err := execCmd.CombinedOutput() + if err != nil { + return fmt.Errorf("Failed to add user/group with error: %v; output: %q", err, string(out)) + } + return nil +} + +func findUnusedUID(startUID int) (int, error) { + return findUnused("passwd", startUID) +} + +func findUnusedGID(startGID int) (int, error) { + return findUnused("group", startGID) +} + +func findUnused(file string, id int) (int, error) { + for { + cmdStr := fmt.Sprintf("cat /etc/%s | cut -d: -f3 | grep '^%d$'", file, id) + cmd := exec.Command("sh", "-c", cmdStr) + if err := cmd.Run(); err != nil { + // if a non-zero return code occurs, then we know the ID was not found + // and is usable + if exiterr, ok := err.(*exec.ExitError); ok { + // The program has exited with an exit code != 0 + if status, ok := exiterr.Sys().(syscall.WaitStatus); ok { + if status.ExitStatus() == 1 { + //no match, we can use this ID + return id, nil + } + } + } + return -1, fmt.Errorf("Error looking in /etc/%s for unused ID: %v", file, err) + } + id++ + if id > idMAX { + return -1, fmt.Errorf("Maximum id in %q reached with finding unused numeric ID", file) + } + } +} + +func mkdirAs(path string, mode os.FileMode, ownerUID, ownerGID int, mkAll bool) error { + if mkAll { + if err := system.MkdirAll(path, mode); err != nil && !os.IsExist(err) { + return err + } + } else { + if err := os.Mkdir(path, mode); err != nil && !os.IsExist(err) { + return err + } + } + // even if it existed, we will chown to change ownership as requested + if err := os.Chown(path, ownerUID, ownerGID); err != nil { + return err + } + return nil +} diff --git a/pkg/idtools/usergroupadd_unsupported.go b/pkg/idtools/usergroupadd_unsupported.go new file mode 100644 index 0000000000..2ec21fd675 --- /dev/null +++ b/pkg/idtools/usergroupadd_unsupported.go @@ -0,0 +1,26 @@ +// +build !linux + +package idtools + +import ( + "fmt" + "os" + + "github.com/docker/docker/pkg/system" +) + +// AddNamespaceRangesUser takes a name and finds an unused uid, gid pair +// and calls the appropriate helper function to add the group and then +// the user to the group in /etc/group and /etc/passwd respectively. +func AddNamespaceRangesUser(name string) (int, int, error) { + return -1, -1, fmt.Errorf("No support for adding users or groups on this OS") +} + +// Platforms such as Windows do not support the UID/GID concept. So make this +// just a wrapper around system.MkdirAll. +func mkdirAs(path string, mode os.FileMode, ownerUID, ownerGID int, mkAll bool) error { + if err := system.MkdirAll(path, mode); err != nil && !os.IsExist(err) { + return err + } + return nil +} diff --git a/pkg/integration/checker/checker.go b/pkg/integration/checker/checker.go new file mode 100644 index 0000000000..45915c80f8 --- /dev/null +++ b/pkg/integration/checker/checker.go @@ -0,0 +1,59 @@ +// Package checker provide Docker specific implementations of the go-check.Checker interface. +package checker + +import ( + "fmt" + "strings" + + "github.com/go-check/check" +) + +// As a commodity, we bring all check.Checker variables into the current namespace to avoid having +// to think about check.X versus checker.X. +var ( + DeepEquals = check.DeepEquals + Equals = check.Equals + ErrorMatches = check.ErrorMatches + FitsTypeOf = check.FitsTypeOf + HasLen = check.HasLen + Implements = check.Implements + IsNil = check.IsNil + Matches = check.Matches + Not = check.Not + NotNil = check.NotNil + PanicMatches = check.PanicMatches + Panics = check.Panics +) + +// Contains checker verifies that string value contains a substring. +var Contains check.Checker = &containsChecker{ + &check.CheckerInfo{ + Name: "Contains", + Params: []string{"value", "substring"}, + }, +} + +type containsChecker struct { + *check.CheckerInfo +} + +func (checker *containsChecker) Check(params []interface{}, names []string) (bool, string) { + return contains(params[0], params[1]) +} + +func contains(value, substring interface{}) (bool, string) { + substringStr, ok := substring.(string) + if !ok { + return false, "Substring must be a string" + } + valueStr, valueIsStr := value.(string) + if !valueIsStr { + if valueWithStr, valueHasStr := value.(fmt.Stringer); valueHasStr { + valueStr, valueIsStr = valueWithStr.String(), true + } + } + if valueIsStr { + return strings.Contains(valueStr, substringStr), "" + } + return false, "Obtained value is not a string and has no .String()" +} diff --git a/pkg/integration/checker/checker_test.go b/pkg/integration/checker/checker_test.go new file mode 100644 index 0000000000..b8145faf9a --- /dev/null +++ b/pkg/integration/checker/checker_test.go @@ -0,0 +1,57 @@ +package checker + +import ( + "reflect" + "testing" + + "github.com/go-check/check" +) + +func Test(t *testing.T) { + check.TestingT(t) +} + +func init() { + check.Suite(&CheckersS{}) +} + +type CheckersS struct{} + +var _ = check.Suite(&CheckersS{}) + +func testInfo(c *check.C, checker check.Checker, name string, paramNames []string) { + info := checker.Info() + if info.Name != name { + c.Fatalf("Got name %s, expected %s", info.Name, name) + } + if !reflect.DeepEqual(info.Params, paramNames) { + c.Fatalf("Got param names %#v, expected %#v", info.Params, paramNames) + } +} + +func testCheck(c *check.C, checker check.Checker, expectedResult bool, expectedError string, params ...interface{}) ([]interface{}, []string) { + info := checker.Info() + if len(params) != len(info.Params) { + c.Fatalf("unexpected param count in test; expected %d got %d", len(info.Params), len(params)) + } + names := append([]string{}, info.Params...) + result, error := checker.Check(params, names) + if result != expectedResult || error != expectedError { + c.Fatalf("%s.Check(%#v) returned (%#v, %#v) rather than (%#v, %#v)", + info.Name, params, result, error, expectedResult, expectedError) + } + return params, names +} + +func (s *CheckersS) TestContains(c *check.C) { + testInfo(c, Contains, "Contains", []string{"value", "substring"}) + + testCheck(c, Contains, true, "", "abcd", "bc") + testCheck(c, Contains, false, "", "abcd", "efg") + testCheck(c, Contains, false, "", "", "bc") + testCheck(c, Contains, true, "", "abcd", "") + testCheck(c, Contains, true, "", "", "") + + testCheck(c, Contains, false, "Obtained value is not a string and has no .String()", 12, "1") + testCheck(c, Contains, false, "Substring must be a string", "", 1) +} diff --git a/pkg/integration/dockerCmd_utils.go b/pkg/integration/dockerCmd_utils.go new file mode 100644 index 0000000000..c6b51e699f --- /dev/null +++ b/pkg/integration/dockerCmd_utils.go @@ -0,0 +1,71 @@ +package integration + +import ( + "fmt" + "os/exec" + "strings" + "time" + + "github.com/go-check/check" +) + +var execCommand = exec.Command + +// DockerCmdWithError executes a docker command that is supposed to fail and returns +// the output, the exit code and the error. +func DockerCmdWithError(dockerBinary string, args ...string) (string, int, error) { + return RunCommandWithOutput(execCommand(dockerBinary, args...)) +} + +// DockerCmdWithStdoutStderr executes a docker command and returns the content of the +// stdout, stderr and the exit code. If a check.C is passed, it will fail and stop tests +// if the error is not nil. +func DockerCmdWithStdoutStderr(dockerBinary string, c *check.C, args ...string) (string, string, int) { + stdout, stderr, status, err := RunCommandWithStdoutStderr(execCommand(dockerBinary, args...)) + if c != nil { + c.Assert(err, check.IsNil, check.Commentf("%q failed with errors: %s, %v", strings.Join(args, " "), stderr, err)) + } + return stdout, stderr, status +} + +// DockerCmd executes a docker command and returns the output and the exit code. If the +// command returns an error, it will fail and stop the tests. +func DockerCmd(dockerBinary string, c *check.C, args ...string) (string, int) { + out, status, err := RunCommandWithOutput(execCommand(dockerBinary, args...)) + c.Assert(err, check.IsNil, check.Commentf("%q failed with errors: %s, %v", strings.Join(args, " "), out, err)) + return out, status +} + +// DockerCmdWithTimeout executes a docker command with a timeout, and returns the output, +// the exit code and the error (if any). +func DockerCmdWithTimeout(dockerBinary string, timeout time.Duration, args ...string) (string, int, error) { + out, status, err := RunCommandWithOutputAndTimeout(execCommand(dockerBinary, args...), timeout) + if err != nil { + return out, status, fmt.Errorf("%q failed with errors: %v : %q", strings.Join(args, " "), err, out) + } + return out, status, err +} + +// DockerCmdInDir executes a docker command in a directory and returns the output, the +// exit code and the error (if any). +func DockerCmdInDir(dockerBinary string, path string, args ...string) (string, int, error) { + dockerCommand := execCommand(dockerBinary, args...) + dockerCommand.Dir = path + out, status, err := RunCommandWithOutput(dockerCommand) + if err != nil { + return out, status, fmt.Errorf("%q failed with errors: %v : %q", strings.Join(args, " "), err, out) + } + return out, status, err +} + +// DockerCmdInDirWithTimeout executes a docker command in a directory with a timeout and +// returns the output, the exit code and the error (if any). +func DockerCmdInDirWithTimeout(dockerBinary string, timeout time.Duration, path string, args ...string) (string, int, error) { + dockerCommand := execCommand(dockerBinary, args...) + dockerCommand.Dir = path + out, status, err := RunCommandWithOutputAndTimeout(dockerCommand, timeout) + if err != nil { + return out, status, fmt.Errorf("%q failed with errors: %v : %q", strings.Join(args, " "), err, out) + } + return out, status, err +} diff --git a/pkg/integration/dockerCmd_utils_test.go b/pkg/integration/dockerCmd_utils_test.go new file mode 100644 index 0000000000..fd492709e3 --- /dev/null +++ b/pkg/integration/dockerCmd_utils_test.go @@ -0,0 +1,405 @@ +package integration + +import ( + "fmt" + "os" + "os/exec" + "testing" + + "io/ioutil" + "strings" + "time" + + "github.com/go-check/check" +) + +const dockerBinary = "docker" + +// Setup go-check for this test +func Test(t *testing.T) { + check.TestingT(t) +} + +func init() { + check.Suite(&DockerCmdSuite{}) +} + +type DockerCmdSuite struct{} + +// Fake the exec.Command to use our mock. +func (s *DockerCmdSuite) SetUpTest(c *check.C) { + execCommand = fakeExecCommand +} + +// And bring it back to normal after the test. +func (s *DockerCmdSuite) TearDownTest(c *check.C) { + execCommand = exec.Command +} + +// DockerCmdWithError tests + +func (s *DockerCmdSuite) TestDockerCmdWithError(c *check.C) { + cmds := []struct { + binary string + args []string + expectedOut string + expectedExitCode int + expectedError error + }{ + { + "doesnotexists", + []string{}, + "Command doesnotexists not found.", + 1, + fmt.Errorf("exit status 1"), + }, + { + dockerBinary, + []string{"an", "error"}, + "an error has occurred", + 1, + fmt.Errorf("exit status 1"), + }, + { + dockerBinary, + []string{"an", "exitCode", "127"}, + "an error has occurred with exitCode 127", + 127, + fmt.Errorf("exit status 127"), + }, + { + dockerBinary, + []string{"run", "-ti", "ubuntu", "echo", "hello"}, + "hello", + 0, + nil, + }, + } + for _, cmd := range cmds { + out, exitCode, error := DockerCmdWithError(cmd.binary, cmd.args...) + c.Assert(out, check.Equals, cmd.expectedOut, check.Commentf("Expected output %q for arguments %v, got %q", cmd.expectedOut, cmd.args, out)) + c.Assert(exitCode, check.Equals, cmd.expectedExitCode, check.Commentf("Expected exitCode %q for arguments %v, got %q", cmd.expectedExitCode, cmd.args, exitCode)) + if cmd.expectedError != nil { + c.Assert(error, check.NotNil, check.Commentf("Expected an error %q, got nothing", cmd.expectedError)) + c.Assert(error.Error(), check.Equals, cmd.expectedError.Error(), check.Commentf("Expected error %q for arguments %v, got %q", cmd.expectedError.Error(), cmd.args, error.Error())) + } else { + c.Assert(error, check.IsNil, check.Commentf("Expected no error, got %v", error)) + } + } +} + +// DockerCmdWithStdoutStderr tests + +type dockerCmdWithStdoutStderrErrorSuite struct{} + +func (s *dockerCmdWithStdoutStderrErrorSuite) Test(c *check.C) { + // Should fail, the test too + DockerCmdWithStdoutStderr(dockerBinary, c, "an", "error") +} + +type dockerCmdWithStdoutStderrSuccessSuite struct{} + +func (s *dockerCmdWithStdoutStderrSuccessSuite) Test(c *check.C) { + stdout, stderr, exitCode := DockerCmdWithStdoutStderr(dockerBinary, c, "run", "-ti", "ubuntu", "echo", "hello") + c.Assert(stdout, check.Equals, "hello") + c.Assert(stderr, check.Equals, "") + c.Assert(exitCode, check.Equals, 0) + +} + +func (s *DockerCmdSuite) TestDockerCmdWithStdoutStderrError(c *check.C) { + // Run error suite, should fail. + output := String{} + result := check.Run(&dockerCmdWithStdoutStderrErrorSuite{}, &check.RunConf{Output: &output}) + c.Check(result.Succeeded, check.Equals, 0) + c.Check(result.Failed, check.Equals, 1) +} + +func (s *DockerCmdSuite) TestDockerCmdWithStdoutStderrSuccess(c *check.C) { + // Run error suite, should fail. + output := String{} + result := check.Run(&dockerCmdWithStdoutStderrSuccessSuite{}, &check.RunConf{Output: &output}) + c.Check(result.Succeeded, check.Equals, 1) + c.Check(result.Failed, check.Equals, 0) +} + +// DockerCmd tests + +type dockerCmdErrorSuite struct{} + +func (s *dockerCmdErrorSuite) Test(c *check.C) { + // Should fail, the test too + DockerCmd(dockerBinary, c, "an", "error") +} + +type dockerCmdSuccessSuite struct{} + +func (s *dockerCmdSuccessSuite) Test(c *check.C) { + stdout, exitCode := DockerCmd(dockerBinary, c, "run", "-ti", "ubuntu", "echo", "hello") + c.Assert(stdout, check.Equals, "hello") + c.Assert(exitCode, check.Equals, 0) + +} + +func (s *DockerCmdSuite) TestDockerCmdError(c *check.C) { + // Run error suite, should fail. + output := String{} + result := check.Run(&dockerCmdErrorSuite{}, &check.RunConf{Output: &output}) + c.Check(result.Succeeded, check.Equals, 0) + c.Check(result.Failed, check.Equals, 1) +} + +func (s *DockerCmdSuite) TestDockerCmdSuccess(c *check.C) { + // Run error suite, should fail. + output := String{} + result := check.Run(&dockerCmdSuccessSuite{}, &check.RunConf{Output: &output}) + c.Check(result.Succeeded, check.Equals, 1) + c.Check(result.Failed, check.Equals, 0) +} + +// DockerCmdWithTimeout tests + +func (s *DockerCmdSuite) TestDockerCmdWithTimeout(c *check.C) { + cmds := []struct { + binary string + args []string + timeout time.Duration + expectedOut string + expectedExitCode int + expectedError error + }{ + { + "doesnotexists", + []string{}, + 100 * time.Millisecond, + `Command doesnotexists not found.`, + 1, + fmt.Errorf(`"" failed with errors: exit status 1 : "Command doesnotexists not found."`), + }, + { + dockerBinary, + []string{"an", "error"}, + 100 * time.Millisecond, + `an error has occurred`, + 1, + fmt.Errorf(`"an error" failed with errors: exit status 1 : "an error has occurred"`), + }, + { + dockerBinary, + []string{"a", "command", "that", "times", "out"}, + 5 * time.Millisecond, + "", + 0, + fmt.Errorf(`"a command that times out" failed with errors: command timed out : ""`), + }, + { + dockerBinary, + []string{"run", "-ti", "ubuntu", "echo", "hello"}, + 100 * time.Millisecond, + "hello", + 0, + nil, + }, + } + for _, cmd := range cmds { + out, exitCode, error := DockerCmdWithTimeout(cmd.binary, cmd.timeout, cmd.args...) + c.Assert(out, check.Equals, cmd.expectedOut, check.Commentf("Expected output %q for arguments %v, got %q", cmd.expectedOut, cmd.args, out)) + c.Assert(exitCode, check.Equals, cmd.expectedExitCode, check.Commentf("Expected exitCode %q for arguments %v, got %q", cmd.expectedExitCode, cmd.args, exitCode)) + if cmd.expectedError != nil { + c.Assert(error, check.NotNil, check.Commentf("Expected an error %q, got nothing", cmd.expectedError)) + c.Assert(error.Error(), check.Equals, cmd.expectedError.Error(), check.Commentf("Expected error %q for arguments %v, got %q", cmd.expectedError.Error(), cmd.args, error.Error())) + } else { + c.Assert(error, check.IsNil, check.Commentf("Expected no error, got %v", error)) + } + } +} + +// DockerCmdInDir tests + +func (s *DockerCmdSuite) TestDockerCmdInDir(c *check.C) { + tempFolder, err := ioutil.TempDir("", "test-docker-cmd-in-dir") + c.Assert(err, check.IsNil) + + cmds := []struct { + binary string + args []string + expectedOut string + expectedExitCode int + expectedError error + }{ + { + "doesnotexists", + []string{}, + `Command doesnotexists not found.`, + 1, + fmt.Errorf(`"dir:%s" failed with errors: exit status 1 : "Command doesnotexists not found."`, tempFolder), + }, + { + dockerBinary, + []string{"an", "error"}, + `an error has occurred`, + 1, + fmt.Errorf(`"dir:%s an error" failed with errors: exit status 1 : "an error has occurred"`, tempFolder), + }, + { + dockerBinary, + []string{"run", "-ti", "ubuntu", "echo", "hello"}, + "hello", + 0, + nil, + }, + } + for _, cmd := range cmds { + // We prepend the arguments with dir:thefolder.. the fake command will check + // that the current workdir is the same as the one we are passing. + args := append([]string{"dir:" + tempFolder}, cmd.args...) + out, exitCode, error := DockerCmdInDir(cmd.binary, tempFolder, args...) + c.Assert(out, check.Equals, cmd.expectedOut, check.Commentf("Expected output %q for arguments %v, got %q", cmd.expectedOut, cmd.args, out)) + c.Assert(exitCode, check.Equals, cmd.expectedExitCode, check.Commentf("Expected exitCode %q for arguments %v, got %q", cmd.expectedExitCode, cmd.args, exitCode)) + if cmd.expectedError != nil { + c.Assert(error, check.NotNil, check.Commentf("Expected an error %q, got nothing", cmd.expectedError)) + c.Assert(error.Error(), check.Equals, cmd.expectedError.Error(), check.Commentf("Expected error %q for arguments %v, got %q", cmd.expectedError.Error(), cmd.args, error.Error())) + } else { + c.Assert(error, check.IsNil, check.Commentf("Expected no error, got %v", error)) + } + } +} + +// DockerCmdInDirWithTimeout tests + +func (s *DockerCmdSuite) TestDockerCmdInDirWithTimeout(c *check.C) { + tempFolder, err := ioutil.TempDir("", "test-docker-cmd-in-dir") + c.Assert(err, check.IsNil) + + cmds := []struct { + binary string + args []string + timeout time.Duration + expectedOut string + expectedExitCode int + expectedError error + }{ + { + "doesnotexists", + []string{}, + 100 * time.Millisecond, + `Command doesnotexists not found.`, + 1, + fmt.Errorf(`"dir:%s" failed with errors: exit status 1 : "Command doesnotexists not found."`, tempFolder), + }, + { + dockerBinary, + []string{"an", "error"}, + 100 * time.Millisecond, + `an error has occurred`, + 1, + fmt.Errorf(`"dir:%s an error" failed with errors: exit status 1 : "an error has occurred"`, tempFolder), + }, + { + dockerBinary, + []string{"a", "command", "that", "times", "out"}, + 5 * time.Millisecond, + "", + 0, + fmt.Errorf(`"dir:%s a command that times out" failed with errors: command timed out : ""`, tempFolder), + }, + { + dockerBinary, + []string{"run", "-ti", "ubuntu", "echo", "hello"}, + 100 * time.Millisecond, + "hello", + 0, + nil, + }, + } + for _, cmd := range cmds { + // We prepend the arguments with dir:thefolder.. the fake command will check + // that the current workdir is the same as the one we are passing. + args := append([]string{"dir:" + tempFolder}, cmd.args...) + out, exitCode, error := DockerCmdInDirWithTimeout(cmd.binary, cmd.timeout, tempFolder, args...) + c.Assert(out, check.Equals, cmd.expectedOut, check.Commentf("Expected output %q for arguments %v, got %q", cmd.expectedOut, cmd.args, out)) + c.Assert(exitCode, check.Equals, cmd.expectedExitCode, check.Commentf("Expected exitCode %q for arguments %v, got %q", cmd.expectedExitCode, cmd.args, exitCode)) + if cmd.expectedError != nil { + c.Assert(error, check.NotNil, check.Commentf("Expected an error %q, got nothing", cmd.expectedError)) + c.Assert(error.Error(), check.Equals, cmd.expectedError.Error(), check.Commentf("Expected error %q for arguments %v, got %q", cmd.expectedError.Error(), cmd.args, error.Error())) + } else { + c.Assert(error, check.IsNil, check.Commentf("Expected no error, got %v", error)) + } + } +} + +// Helpers :) + +// Type implementing the io.Writer interface for analyzing output. +type String struct { + value string +} + +// The only function required by the io.Writer interface. Will append +// written data to the String.value string. +func (s *String) Write(p []byte) (n int, err error) { + s.value += string(p) + return len(p), nil +} + +// Helper function that mock the exec.Command call (and call the test binary) +func fakeExecCommand(command string, args ...string) *exec.Cmd { + cs := []string{"-test.run=TestHelperProcess", "--", command} + cs = append(cs, args...) + cmd := exec.Command(os.Args[0], cs...) + cmd.Env = []string{"GO_WANT_HELPER_PROCESS=1"} + return cmd +} + +func TestHelperProcess(t *testing.T) { + if os.Getenv("GO_WANT_HELPER_PROCESS") != "1" { + return + } + args := os.Args + + // Previous arguments are tests stuff, that looks like : + // /tmp/go-build970079519/…/_test/integration.test -test.run=TestHelperProcess -- + cmd, args := args[3], args[4:] + // Handle the case where args[0] is dir:... + if len(args) > 0 && strings.HasPrefix(args[0], "dir:") { + expectedCwd := args[0][4:] + if len(args) > 1 { + args = args[1:] + } + cwd, err := os.Getwd() + if err != nil { + fmt.Fprintf(os.Stderr, "Failed to get workingdir: %v", err) + os.Exit(1) + } + // This checks that the given path is the same as the currend working dire + if expectedCwd != cwd { + fmt.Fprintf(os.Stderr, "Current workdir should be %q, but is %q", expectedCwd, cwd) + } + } + switch cmd { + case dockerBinary: + argsStr := strings.Join(args, " ") + switch argsStr { + case "an exitCode 127": + fmt.Fprintf(os.Stderr, "an error has occurred with exitCode 127") + os.Exit(127) + case "an error": + fmt.Fprintf(os.Stderr, "an error has occurred") + os.Exit(1) + case "a command that times out": + time.Sleep(10 * time.Millisecond) + fmt.Fprintf(os.Stdout, "too long, should be killed") + // A random exit code (that should never happened in tests) + os.Exit(7) + case "run -ti ubuntu echo hello": + fmt.Fprintf(os.Stdout, "hello") + default: + fmt.Fprintf(os.Stdout, "no arguments") + } + default: + fmt.Fprintf(os.Stderr, "Command %s not found.", cmd) + os.Exit(1) + } + // some code here to check arguments perhaps? + os.Exit(0) +} diff --git a/pkg/integration/utils.go b/pkg/integration/utils.go new file mode 100644 index 0000000000..6fe1c0afe6 --- /dev/null +++ b/pkg/integration/utils.go @@ -0,0 +1,348 @@ +package integration + +import ( + "archive/tar" + "bytes" + "encoding/json" + "errors" + "fmt" + "io" + "os" + "os/exec" + "path/filepath" + "reflect" + "strings" + "syscall" + "time" + + "github.com/docker/docker/pkg/stringutils" +) + +// GetExitCode returns the ExitStatus of the specified error if its type is +// exec.ExitError, returns 0 and an error otherwise. +func GetExitCode(err error) (int, error) { + exitCode := 0 + if exiterr, ok := err.(*exec.ExitError); ok { + if procExit, ok := exiterr.Sys().(syscall.WaitStatus); ok { + return procExit.ExitStatus(), nil + } + } + return exitCode, fmt.Errorf("failed to get exit code") +} + +// ProcessExitCode process the specified error and returns the exit status code +// if the error was of type exec.ExitError, returns nothing otherwise. +func ProcessExitCode(err error) (exitCode int) { + if err != nil { + var exiterr error + if exitCode, exiterr = GetExitCode(err); exiterr != nil { + // TODO: Fix this so we check the error's text. + // we've failed to retrieve exit code, so we set it to 127 + exitCode = 127 + } + } + return +} + +// IsKilled process the specified error and returns whether the process was killed or not. +func IsKilled(err error) bool { + if exitErr, ok := err.(*exec.ExitError); ok { + status, ok := exitErr.Sys().(syscall.WaitStatus) + if !ok { + return false + } + // status.ExitStatus() is required on Windows because it does not + // implement Signal() nor Signaled(). Just check it had a bad exit + // status could mean it was killed (and in tests we do kill) + return (status.Signaled() && status.Signal() == os.Kill) || status.ExitStatus() != 0 + } + return false +} + +// RunCommandWithOutput runs the specified command and returns the combined output (stdout/stderr) +// with the exitCode different from 0 and the error if something bad happened +func RunCommandWithOutput(cmd *exec.Cmd) (output string, exitCode int, err error) { + exitCode = 0 + out, err := cmd.CombinedOutput() + exitCode = ProcessExitCode(err) + output = string(out) + return +} + +// RunCommandWithStdoutStderr runs the specified command and returns stdout and stderr separately +// with the exitCode different from 0 and the error if something bad happened +func RunCommandWithStdoutStderr(cmd *exec.Cmd) (stdout string, stderr string, exitCode int, err error) { + var ( + stderrBuffer, stdoutBuffer bytes.Buffer + ) + exitCode = 0 + cmd.Stderr = &stderrBuffer + cmd.Stdout = &stdoutBuffer + err = cmd.Run() + exitCode = ProcessExitCode(err) + + stdout = stdoutBuffer.String() + stderr = stderrBuffer.String() + return +} + +// RunCommandWithOutputForDuration runs the specified command "timeboxed" by the specified duration. +// If the process is still running when the timebox is finished, the process will be killed and . +// It will returns the output with the exitCode different from 0 and the error if something bad happened +// and a boolean whether it has been killed or not. +func RunCommandWithOutputForDuration(cmd *exec.Cmd, duration time.Duration) (output string, exitCode int, timedOut bool, err error) { + var outputBuffer bytes.Buffer + if cmd.Stdout != nil { + err = errors.New("cmd.Stdout already set") + return + } + cmd.Stdout = &outputBuffer + + if cmd.Stderr != nil { + err = errors.New("cmd.Stderr already set") + return + } + cmd.Stderr = &outputBuffer + + done := make(chan error) + + // Start the command in the main thread.. + err = cmd.Start() + if err != nil { + err = fmt.Errorf("Fail to start command %v : %v", cmd, err) + } + + go func() { + // And wait for it to exit in the goroutine :) + exitErr := cmd.Wait() + exitCode = ProcessExitCode(exitErr) + done <- exitErr + }() + + select { + case <-time.After(duration): + killErr := cmd.Process.Kill() + if killErr != nil { + fmt.Printf("failed to kill (pid=%d): %v\n", cmd.Process.Pid, killErr) + } + timedOut = true + break + case err = <-done: + break + } + output = outputBuffer.String() + return +} + +var errCmdTimeout = fmt.Errorf("command timed out") + +// RunCommandWithOutputAndTimeout runs the specified command "timeboxed" by the specified duration. +// It returns the output with the exitCode different from 0 and the error if something bad happened or +// if the process timed out (and has been killed). +func RunCommandWithOutputAndTimeout(cmd *exec.Cmd, timeout time.Duration) (output string, exitCode int, err error) { + var timedOut bool + output, exitCode, timedOut, err = RunCommandWithOutputForDuration(cmd, timeout) + if timedOut { + err = errCmdTimeout + } + return +} + +// RunCommand runs the specified command and returns the exitCode different from 0 +// and the error if something bad happened. +func RunCommand(cmd *exec.Cmd) (exitCode int, err error) { + exitCode = 0 + err = cmd.Run() + exitCode = ProcessExitCode(err) + return +} + +// RunCommandPipelineWithOutput runs the array of commands with the output +// of each pipelined with the following (like cmd1 | cmd2 | cmd3 would do). +// It returns the final output, the exitCode different from 0 and the error +// if something bad happened. +func RunCommandPipelineWithOutput(cmds ...*exec.Cmd) (output string, exitCode int, err error) { + if len(cmds) < 2 { + return "", 0, errors.New("pipeline does not have multiple cmds") + } + + // connect stdin of each cmd to stdout pipe of previous cmd + for i, cmd := range cmds { + if i > 0 { + prevCmd := cmds[i-1] + cmd.Stdin, err = prevCmd.StdoutPipe() + + if err != nil { + return "", 0, fmt.Errorf("cannot set stdout pipe for %s: %v", cmd.Path, err) + } + } + } + + // start all cmds except the last + for _, cmd := range cmds[:len(cmds)-1] { + if err = cmd.Start(); err != nil { + return "", 0, fmt.Errorf("starting %s failed with error: %v", cmd.Path, err) + } + } + + defer func() { + // wait all cmds except the last to release their resources + for _, cmd := range cmds[:len(cmds)-1] { + cmd.Wait() + } + }() + + // wait on last cmd + return RunCommandWithOutput(cmds[len(cmds)-1]) +} + +// UnmarshalJSON deserialize a JSON in the given interface. +func UnmarshalJSON(data []byte, result interface{}) error { + if err := json.Unmarshal(data, result); err != nil { + return err + } + + return nil +} + +// ConvertSliceOfStringsToMap converts a slices of string in a map +// with the strings as key and an empty string as values. +func ConvertSliceOfStringsToMap(input []string) map[string]struct{} { + output := make(map[string]struct{}) + for _, v := range input { + output[v] = struct{}{} + } + return output +} + +// CompareDirectoryEntries compares two sets of FileInfo (usually taken from a directory) +// and returns an error if different. +func CompareDirectoryEntries(e1 []os.FileInfo, e2 []os.FileInfo) error { + var ( + e1Entries = make(map[string]struct{}) + e2Entries = make(map[string]struct{}) + ) + for _, e := range e1 { + e1Entries[e.Name()] = struct{}{} + } + for _, e := range e2 { + e2Entries[e.Name()] = struct{}{} + } + if !reflect.DeepEqual(e1Entries, e2Entries) { + return fmt.Errorf("entries differ") + } + return nil +} + +// ListTar lists the entries of a tar. +func ListTar(f io.Reader) ([]string, error) { + tr := tar.NewReader(f) + var entries []string + + for { + th, err := tr.Next() + if err == io.EOF { + // end of tar archive + return entries, nil + } + if err != nil { + return entries, err + } + entries = append(entries, th.Name) + } +} + +// RandomTmpDirPath provides a temporary path with rand string appended. +// does not create or checks if it exists. +func RandomTmpDirPath(s string, platform string) string { + tmp := "/tmp" + if platform == "windows" { + tmp = os.Getenv("TEMP") + } + path := filepath.Join(tmp, fmt.Sprintf("%s.%s", s, stringutils.GenerateRandomAlphaOnlyString(10))) + if platform == "windows" { + return filepath.FromSlash(path) // Using \ + } + return filepath.ToSlash(path) // Using / +} + +// ConsumeWithSpeed reads chunkSize bytes from reader after every interval. +// Returns total read bytes. +func ConsumeWithSpeed(reader io.Reader, chunkSize int, interval time.Duration, stop chan bool) (n int, err error) { + buffer := make([]byte, chunkSize) + for { + select { + case <-stop: + return + default: + var readBytes int + readBytes, err = reader.Read(buffer) + n += readBytes + if err != nil { + if err == io.EOF { + err = nil + } + return + } + time.Sleep(interval) + } + } +} + +// ParseCgroupPaths arses 'procCgroupData', which is output of '/proc//cgroup', and returns +// a map which cgroup name as key and path as value. +func ParseCgroupPaths(procCgroupData string) map[string]string { + cgroupPaths := map[string]string{} + for _, line := range strings.Split(procCgroupData, "\n") { + parts := strings.Split(line, ":") + if len(parts) != 3 { + continue + } + cgroupPaths[parts[1]] = parts[2] + } + return cgroupPaths +} + +// ChannelBuffer holds a chan of byte array that can be populate in a goroutine. +type ChannelBuffer struct { + C chan []byte +} + +// Write implements Writer. +func (c *ChannelBuffer) Write(b []byte) (int, error) { + c.C <- b + return len(b), nil +} + +// Close closes the go channel. +func (c *ChannelBuffer) Close() error { + close(c.C) + return nil +} + +// ReadTimeout reads the content of the channel in the specified byte array with +// the specified duration as timeout. +func (c *ChannelBuffer) ReadTimeout(p []byte, n time.Duration) (int, error) { + select { + case b := <-c.C: + return copy(p[0:], b), nil + case <-time.After(n): + return -1, fmt.Errorf("timeout reading from channel") + } +} + +// RunAtDifferentDate runs the specifed function with the given time. +// It changes the date of the system, which can led to weird behaviors. +func RunAtDifferentDate(date time.Time, block func()) { + // Layout for date. MMDDhhmmYYYY + const timeLayout = "010203042006" + // Ensure we bring time back to now + now := time.Now().Format(timeLayout) + dateReset := exec.Command("date", now) + defer RunCommand(dateReset) + + dateChange := exec.Command("date", date.Format(timeLayout)) + RunCommand(dateChange) + block() + return +} diff --git a/pkg/integration/utils_test.go b/pkg/integration/utils_test.go new file mode 100644 index 0000000000..7c5df4e90a --- /dev/null +++ b/pkg/integration/utils_test.go @@ -0,0 +1,492 @@ +package integration + +import ( + "io" + "io/ioutil" + "os" + "os/exec" + "path" + "runtime" + "strings" + "testing" + "time" +) + +func TestIsKilledFalseWithNonKilledProcess(t *testing.T) { + lsCmd := exec.Command("ls") + lsCmd.Start() + // Wait for it to finish + err := lsCmd.Wait() + if IsKilled(err) { + t.Fatalf("Expected the ls command to not be killed, was.") + } +} + +func TestIsKilledTrueWithKilledProcess(t *testing.T) { + longCmd := exec.Command("top") + // Start a command + longCmd.Start() + // Capture the error when *dying* + done := make(chan error, 1) + go func() { + done <- longCmd.Wait() + }() + // Then kill it + longCmd.Process.Kill() + // Get the error + err := <-done + if !IsKilled(err) { + t.Fatalf("Expected the command to be killed, was not.") + } +} + +func TestRunCommandWithOutput(t *testing.T) { + echoHelloWorldCmd := exec.Command("echo", "hello", "world") + out, exitCode, err := RunCommandWithOutput(echoHelloWorldCmd) + expected := "hello world\n" + if out != expected || exitCode != 0 || err != nil { + t.Fatalf("Expected command to output %s, got %s, %v with exitCode %v", expected, out, err, exitCode) + } +} + +func TestRunCommandWithOutputError(t *testing.T) { + cmd := exec.Command("doesnotexists") + out, exitCode, err := RunCommandWithOutput(cmd) + expectedError := `exec: "doesnotexists": executable file not found in $PATH` + if out != "" || exitCode != 127 || err == nil || err.Error() != expectedError { + t.Fatalf("Expected command to output %s, got %s, %v with exitCode %v", expectedError, out, err, exitCode) + } + + wrongLsCmd := exec.Command("ls", "-z") + expected := `ls: invalid option -- 'z' +Try 'ls --help' for more information. +` + out, exitCode, err = RunCommandWithOutput(wrongLsCmd) + + if out != expected || exitCode != 2 || err == nil || err.Error() != "exit status 2" { + t.Fatalf("Expected command to output %s, got out:%s, err:%v with exitCode %v", expected, out, err, exitCode) + } +} + +func TestRunCommandWithStdoutStderr(t *testing.T) { + echoHelloWorldCmd := exec.Command("echo", "hello", "world") + stdout, stderr, exitCode, err := RunCommandWithStdoutStderr(echoHelloWorldCmd) + expected := "hello world\n" + if stdout != expected || stderr != "" || exitCode != 0 || err != nil { + t.Fatalf("Expected command to output %s, got stdout:%s, stderr:%s, err:%v with exitCode %v", expected, stdout, stderr, err, exitCode) + } +} + +func TestRunCommandWithStdoutStderrError(t *testing.T) { + cmd := exec.Command("doesnotexists") + stdout, stderr, exitCode, err := RunCommandWithStdoutStderr(cmd) + expectedError := `exec: "doesnotexists": executable file not found in $PATH` + if stdout != "" || stderr != "" || exitCode != 127 || err == nil || err.Error() != expectedError { + t.Fatalf("Expected command to output out:%s, stderr:%s, got stdout:%s, stderr:%s, err:%v with exitCode %v", "", "", stdout, stderr, err, exitCode) + } + + wrongLsCmd := exec.Command("ls", "-z") + expected := `ls: invalid option -- 'z' +Try 'ls --help' for more information. +` + + stdout, stderr, exitCode, err = RunCommandWithStdoutStderr(wrongLsCmd) + if stdout != "" && stderr != expected || exitCode != 2 || err == nil || err.Error() != "exit status 2" { + t.Fatalf("Expected command to output out:%s, stderr:%s, got stdout:%s, stderr:%s, err:%v with exitCode %v", "", expectedError, stdout, stderr, err, exitCode) + } +} + +func TestRunCommandWithOutputForDurationFinished(t *testing.T) { + cmd := exec.Command("ls") + out, exitCode, timedOut, err := RunCommandWithOutputForDuration(cmd, 50*time.Millisecond) + if out == "" || exitCode != 0 || timedOut || err != nil { + t.Fatalf("Expected the command to run for less 50 milliseconds and thus not time out, but did not : out:[%s], exitCode:[%d], timedOut:[%v], err:[%v]", out, exitCode, timedOut, err) + } +} + +func TestRunCommandWithOutputForDurationKilled(t *testing.T) { + cmd := exec.Command("sh", "-c", "while true ; do echo 1 ; sleep .1 ; done") + out, exitCode, timedOut, err := RunCommandWithOutputForDuration(cmd, 500*time.Millisecond) + ones := strings.Split(out, "\n") + if len(ones) != 6 || exitCode != 0 || !timedOut || err != nil { + t.Fatalf("Expected the command to run for 500 milliseconds (and thus print six lines (five with 1, one empty) and time out, but did not : out:[%s], exitCode:%d, timedOut:%v, err:%v", out, exitCode, timedOut, err) + } +} + +func TestRunCommandWithOutputForDurationErrors(t *testing.T) { + cmd := exec.Command("ls") + cmd.Stdout = os.Stdout + if _, _, _, err := RunCommandWithOutputForDuration(cmd, 1*time.Millisecond); err == nil || err.Error() != "cmd.Stdout already set" { + t.Fatalf("Expected an error as cmd.Stdout was already set, did not (err:%s).", err) + } + cmd = exec.Command("ls") + cmd.Stderr = os.Stderr + if _, _, _, err := RunCommandWithOutputForDuration(cmd, 1*time.Millisecond); err == nil || err.Error() != "cmd.Stderr already set" { + t.Fatalf("Expected an error as cmd.Stderr was already set, did not (err:%s).", err) + } +} + +func TestRunCommandWithOutputAndTimeoutFinished(t *testing.T) { + cmd := exec.Command("ls") + out, exitCode, err := RunCommandWithOutputAndTimeout(cmd, 50*time.Millisecond) + if out == "" || exitCode != 0 || err != nil { + t.Fatalf("Expected the command to run for less 50 milliseconds and thus not time out, but did not : out:[%s], exitCode:[%d], err:[%v]", out, exitCode, err) + } +} + +func TestRunCommandWithOutputAndTimeoutKilled(t *testing.T) { + cmd := exec.Command("sh", "-c", "while true ; do echo 1 ; sleep .1 ; done") + out, exitCode, err := RunCommandWithOutputAndTimeout(cmd, 500*time.Millisecond) + ones := strings.Split(out, "\n") + if len(ones) != 6 || exitCode != 0 || err == nil || err.Error() != "command timed out" { + t.Fatalf("Expected the command to run for 500 milliseconds (and thus print six lines (five with 1, one empty) and time out with an error 'command timed out', but did not : out:[%s], exitCode:%d, err:%v", out, exitCode, err) + } +} + +func TestRunCommandWithOutputAndTimeoutErrors(t *testing.T) { + cmd := exec.Command("ls") + cmd.Stdout = os.Stdout + if _, _, err := RunCommandWithOutputAndTimeout(cmd, 1*time.Millisecond); err == nil || err.Error() != "cmd.Stdout already set" { + t.Fatalf("Expected an error as cmd.Stdout was already set, did not (err:%s).", err) + } + cmd = exec.Command("ls") + cmd.Stderr = os.Stderr + if _, _, err := RunCommandWithOutputAndTimeout(cmd, 1*time.Millisecond); err == nil || err.Error() != "cmd.Stderr already set" { + t.Fatalf("Expected an error as cmd.Stderr was already set, did not (err:%s).", err) + } +} + +func TestRunCommand(t *testing.T) { + lsCmd := exec.Command("ls") + exitCode, err := RunCommand(lsCmd) + if exitCode != 0 || err != nil { + t.Fatalf("Expected runCommand to run the command successfully, got: exitCode:%d, err:%v", exitCode, err) + } + + var expectedError string + + exitCode, err = RunCommand(exec.Command("doesnotexists")) + expectedError = `exec: "doesnotexists": executable file not found in $PATH` + if exitCode != 127 || err == nil || err.Error() != expectedError { + t.Fatalf("Expected runCommand to run the command successfully, got: exitCode:%d, err:%v", exitCode, err) + } + wrongLsCmd := exec.Command("ls", "-z") + expected := 2 + expectedError = `exit status 2` + exitCode, err = RunCommand(wrongLsCmd) + if exitCode != expected || err == nil || err.Error() != expectedError { + t.Fatalf("Expected runCommand to run the command successfully, got: exitCode:%d, err:%v", exitCode, err) + } +} + +func TestRunCommandPipelineWithOutputWithNotEnoughCmds(t *testing.T) { + _, _, err := RunCommandPipelineWithOutput(exec.Command("ls")) + expectedError := "pipeline does not have multiple cmds" + if err == nil || err.Error() != expectedError { + t.Fatalf("Expected an error with %s, got err:%s", expectedError, err) + } +} + +func TestRunCommandPipelineWithOutputErrors(t *testing.T) { + cmd1 := exec.Command("ls") + cmd1.Stdout = os.Stdout + cmd2 := exec.Command("anything really") + _, _, err := RunCommandPipelineWithOutput(cmd1, cmd2) + if err == nil || err.Error() != "cannot set stdout pipe for anything really: exec: Stdout already set" { + t.Fatalf("Expected an error, got %v", err) + } + + cmdWithError := exec.Command("doesnotexists") + cmdCat := exec.Command("cat") + _, _, err = RunCommandPipelineWithOutput(cmdWithError, cmdCat) + if err == nil || err.Error() != `starting doesnotexists failed with error: exec: "doesnotexists": executable file not found in $PATH` { + t.Fatalf("Expected an error, got %v", err) + } +} + +func TestRunCommandPipelineWithOutput(t *testing.T) { + cmds := []*exec.Cmd{ + // Print 2 characters + exec.Command("echo", "-n", "11"), + // Count the number or char from stdin (previous command) + exec.Command("wc", "-m"), + } + out, exitCode, err := RunCommandPipelineWithOutput(cmds...) + expectedOutput := "2\n" + if out != expectedOutput || exitCode != 0 || err != nil { + t.Fatalf("Expected %s for commands %v, got out:%s, exitCode:%d, err:%v", expectedOutput, cmds, out, exitCode, err) + } +} + +// Simple simple test as it is just a passthrough for json.Unmarshal +func TestUnmarshalJSON(t *testing.T) { + emptyResult := struct{}{} + if err := UnmarshalJSON([]byte(""), &emptyResult); err == nil { + t.Fatalf("Expected an error, got nothing") + } + result := struct{ Name string }{} + if err := UnmarshalJSON([]byte(`{"name": "name"}`), &result); err != nil { + t.Fatal(err) + } + if result.Name != "name" { + t.Fatalf("Expected result.name to be 'name', was '%s'", result.Name) + } +} + +func TestConvertSliceOfStringsToMap(t *testing.T) { + input := []string{"a", "b"} + actual := ConvertSliceOfStringsToMap(input) + for _, key := range input { + if _, ok := actual[key]; !ok { + t.Fatalf("Expected output to contains key %s, did not: %v", key, actual) + } + } +} + +func TestCompareDirectoryEntries(t *testing.T) { + tmpFolder, err := ioutil.TempDir("", "integration-cli-utils-compare-directories") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpFolder) + + file1 := path.Join(tmpFolder, "file1") + file2 := path.Join(tmpFolder, "file2") + os.Create(file1) + os.Create(file2) + + fi1, err := os.Stat(file1) + if err != nil { + t.Fatal(err) + } + fi1bis, err := os.Stat(file1) + if err != nil { + t.Fatal(err) + } + fi2, err := os.Stat(file2) + if err != nil { + t.Fatal(err) + } + + cases := []struct { + e1 []os.FileInfo + e2 []os.FileInfo + shouldError bool + }{ + // Empty directories + { + []os.FileInfo{}, + []os.FileInfo{}, + false, + }, + // Same FileInfos + { + []os.FileInfo{fi1}, + []os.FileInfo{fi1}, + false, + }, + // Different FileInfos but same names + { + []os.FileInfo{fi1}, + []os.FileInfo{fi1bis}, + false, + }, + // Different FileInfos, different names + { + []os.FileInfo{fi1}, + []os.FileInfo{fi2}, + true, + }, + } + for _, elt := range cases { + err := CompareDirectoryEntries(elt.e1, elt.e2) + if elt.shouldError && err == nil { + t.Fatalf("Should have return an error, did not with %v and %v", elt.e1, elt.e2) + } + if !elt.shouldError && err != nil { + t.Fatalf("Should have not returned an error, but did : %v with %v and %v", err, elt.e1, elt.e2) + } + } +} + +// FIXME make an "unhappy path" test for ListTar without "panicing" :-) +func TestListTar(t *testing.T) { + tmpFolder, err := ioutil.TempDir("", "integration-cli-utils-list-tar") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpFolder) + + // Let's create a Tar file + srcFile := path.Join(tmpFolder, "src") + tarFile := path.Join(tmpFolder, "src.tar") + os.Create(srcFile) + cmd := exec.Command("/bin/sh", "-c", "tar cf "+tarFile+" "+srcFile) + _, err = cmd.CombinedOutput() + if err != nil { + t.Fatal(err) + } + + reader, err := os.Open(tarFile) + if err != nil { + t.Fatal(err) + } + defer reader.Close() + + entries, err := ListTar(reader) + if err != nil { + t.Fatal(err) + } + if len(entries) != 1 && entries[0] != "src" { + t.Fatalf("Expected a tar file with 1 entry (%s), got %v", srcFile, entries) + } +} + +func TestRandomTmpDirPath(t *testing.T) { + path := RandomTmpDirPath("something", runtime.GOOS) + + prefix := "/tmp/something" + if runtime.GOOS == "windows" { + prefix = os.Getenv("TEMP") + `\something` + } + expectedSize := len(prefix) + 11 + + if !strings.HasPrefix(path, prefix) { + t.Fatalf("Expected generated path to have '%s' as prefix, got %s'", prefix, path) + } + if len(path) != expectedSize { + t.Fatalf("Expected generated path to be %d, got %d", expectedSize, len(path)) + } +} + +func TestConsumeWithSpeed(t *testing.T) { + reader := strings.NewReader("1234567890") + chunksize := 2 + + bytes1, err := ConsumeWithSpeed(reader, chunksize, 1*time.Millisecond, nil) + if err != nil { + t.Fatal(err) + } + + if bytes1 != 10 { + t.Fatalf("Expected to have read 10 bytes, got %d", bytes1) + } + +} + +func TestConsumeWithSpeedWithStop(t *testing.T) { + reader := strings.NewReader("1234567890") + chunksize := 2 + + stopIt := make(chan bool) + + go func() { + time.Sleep(1 * time.Millisecond) + stopIt <- true + }() + + bytes1, err := ConsumeWithSpeed(reader, chunksize, 2*time.Millisecond, stopIt) + if err != nil { + t.Fatal(err) + } + + if bytes1 != 2 { + t.Fatalf("Expected to have read 2 bytes, got %d", bytes1) + } + +} + +func TestParseCgroupPathsEmpty(t *testing.T) { + cgroupMap := ParseCgroupPaths("") + if len(cgroupMap) != 0 { + t.Fatalf("Expected an empty map, got %v", cgroupMap) + } + cgroupMap = ParseCgroupPaths("\n") + if len(cgroupMap) != 0 { + t.Fatalf("Expected an empty map, got %v", cgroupMap) + } + cgroupMap = ParseCgroupPaths("something:else\nagain:here") + if len(cgroupMap) != 0 { + t.Fatalf("Expected an empty map, got %v", cgroupMap) + } +} + +func TestParseCgroupPaths(t *testing.T) { + cgroupMap := ParseCgroupPaths("2:memory:/a\n1:cpuset:/b") + if len(cgroupMap) != 2 { + t.Fatalf("Expected a map with 2 entries, got %v", cgroupMap) + } + if value, ok := cgroupMap["memory"]; !ok || value != "/a" { + t.Fatalf("Expected cgroupMap to contains an entry for 'memory' with value '/a', got %v", cgroupMap) + } + if value, ok := cgroupMap["cpuset"]; !ok || value != "/b" { + t.Fatalf("Expected cgroupMap to contains an entry for 'cpuset' with value '/b', got %v", cgroupMap) + } +} + +func TestChannelBufferTimeout(t *testing.T) { + expected := "11" + + buf := &ChannelBuffer{make(chan []byte, 1)} + defer buf.Close() + + go func() { + time.Sleep(100 * time.Millisecond) + io.Copy(buf, strings.NewReader(expected)) + }() + + // Wait long enough + b := make([]byte, 2) + _, err := buf.ReadTimeout(b, 50*time.Millisecond) + if err == nil && err.Error() != "timeout reading from channel" { + t.Fatalf("Expected an error, got %s", err) + } + + // Wait for the end :) + time.Sleep(150 * time.Millisecond) +} + +func TestChannelBuffer(t *testing.T) { + expected := "11" + + buf := &ChannelBuffer{make(chan []byte, 1)} + defer buf.Close() + + go func() { + time.Sleep(100 * time.Millisecond) + io.Copy(buf, strings.NewReader(expected)) + }() + + // Wait long enough + b := make([]byte, 2) + _, err := buf.ReadTimeout(b, 200*time.Millisecond) + if err != nil { + t.Fatal(err) + } + + if string(b) != expected { + t.Fatalf("Expected '%s', got '%s'", expected, string(b)) + } +} + +// FIXME doesn't work +// func TestRunAtDifferentDate(t *testing.T) { +// var date string + +// // Layout for date. MMDDhhmmYYYY +// const timeLayout = "20060102" +// expectedDate := "20100201" +// theDate, err := time.Parse(timeLayout, expectedDate) +// if err != nil { +// t.Fatal(err) +// } + +// RunAtDifferentDate(theDate, func() { +// cmd := exec.Command("date", "+%Y%M%d") +// out, err := cmd.Output() +// if err != nil { +// t.Fatal(err) +// } +// date = string(out) +// }) +// } diff --git a/pkg/ioutils/bytespipe.go b/pkg/ioutils/bytespipe.go new file mode 100644 index 0000000000..932e1d1bcc --- /dev/null +++ b/pkg/ioutils/bytespipe.go @@ -0,0 +1,89 @@ +package ioutils + +const maxCap = 1e6 + +// BytesPipe is io.ReadWriter which works similarly to pipe(queue). +// All written data could be read only once. Also BytesPipe is allocating +// and releasing new byte slices to adjust to current needs, so there won't be +// overgrown buffer after high load peak. +// BytesPipe isn't goroutine-safe, caller must synchronize it if needed. +type BytesPipe struct { + buf [][]byte // slice of byte-slices of buffered data + lastRead int // index in the first slice to a read point + bufLen int // length of data buffered over the slices +} + +// NewBytesPipe creates new BytesPipe, initialized by specified slice. +// If buf is nil, then it will be initialized with slice which cap is 64. +// buf will be adjusted in a way that len(buf) == 0, cap(buf) == cap(buf). +func NewBytesPipe(buf []byte) *BytesPipe { + if cap(buf) == 0 { + buf = make([]byte, 0, 64) + } + return &BytesPipe{ + buf: [][]byte{buf[:0]}, + } +} + +// Write writes p to BytesPipe. +// It can allocate new []byte slices in a process of writing. +func (bp *BytesPipe) Write(p []byte) (n int, err error) { + for { + // write data to the last buffer + b := bp.buf[len(bp.buf)-1] + // copy data to the current empty allocated area + n := copy(b[len(b):cap(b)], p) + // increment buffered data length + bp.bufLen += n + // include written data in last buffer + bp.buf[len(bp.buf)-1] = b[:len(b)+n] + + // if there was enough room to write all then break + if len(p) == n { + break + } + + // more data: write to the next slice + p = p[n:] + // allocate slice that has twice the size of the last unless maximum reached + nextCap := 2 * cap(bp.buf[len(bp.buf)-1]) + if maxCap < nextCap { + nextCap = maxCap + } + // add new byte slice to the buffers slice and continue writing + bp.buf = append(bp.buf, make([]byte, 0, nextCap)) + } + return +} + +func (bp *BytesPipe) len() int { + return bp.bufLen - bp.lastRead +} + +// Read reads bytes from BytesPipe. +// Data could be read only once. +func (bp *BytesPipe) Read(p []byte) (n int, err error) { + for { + read := copy(p, bp.buf[0][bp.lastRead:]) + n += read + bp.lastRead += read + if bp.len() == 0 { + // we have read everything. reset to the beginning. + bp.lastRead = 0 + bp.bufLen -= len(bp.buf[0]) + bp.buf[0] = bp.buf[0][:0] + break + } + // break if everything was read + if len(p) == read { + break + } + // more buffered data and more asked. read from next slice. + p = p[read:] + bp.lastRead = 0 + bp.bufLen -= len(bp.buf[0]) + bp.buf[0] = nil // throw away old slice + bp.buf = bp.buf[1:] // switch to next + } + return +} diff --git a/pkg/ioutils/bytespipe_test.go b/pkg/ioutils/bytespipe_test.go new file mode 100644 index 0000000000..62b1a186fe --- /dev/null +++ b/pkg/ioutils/bytespipe_test.go @@ -0,0 +1,141 @@ +package ioutils + +import ( + "crypto/sha1" + "encoding/hex" + "testing" +) + +func TestBytesPipeRead(t *testing.T) { + buf := NewBytesPipe(nil) + buf.Write([]byte("12")) + buf.Write([]byte("34")) + buf.Write([]byte("56")) + buf.Write([]byte("78")) + buf.Write([]byte("90")) + rd := make([]byte, 4) + n, err := buf.Read(rd) + if err != nil { + t.Fatal(err) + } + if n != 4 { + t.Fatalf("Wrong number of bytes read: %d, should be %d", n, 4) + } + if string(rd) != "1234" { + t.Fatalf("Read %s, but must be %s", rd, "1234") + } + n, err = buf.Read(rd) + if err != nil { + t.Fatal(err) + } + if n != 4 { + t.Fatalf("Wrong number of bytes read: %d, should be %d", n, 4) + } + if string(rd) != "5678" { + t.Fatalf("Read %s, but must be %s", rd, "5679") + } + n, err = buf.Read(rd) + if err != nil { + t.Fatal(err) + } + if n != 2 { + t.Fatalf("Wrong number of bytes read: %d, should be %d", n, 2) + } + if string(rd[:n]) != "90" { + t.Fatalf("Read %s, but must be %s", rd, "90") + } +} + +func TestBytesPipeWrite(t *testing.T) { + buf := NewBytesPipe(nil) + buf.Write([]byte("12")) + buf.Write([]byte("34")) + buf.Write([]byte("56")) + buf.Write([]byte("78")) + buf.Write([]byte("90")) + if string(buf.buf[0]) != "1234567890" { + t.Fatalf("Buffer %s, must be %s", buf.buf, "1234567890") + } +} + +// Write and read in different speeds/chunk sizes and check valid data is read. +func TestBytesPipeWriteRandomChunks(t *testing.T) { + cases := []struct{ iterations, writesPerLoop, readsPerLoop int }{ + {100, 10, 1}, + {1000, 10, 5}, + {1000, 100, 0}, + {1000, 5, 6}, + {10000, 50, 25}, + } + + testMessage := []byte("this is a random string for testing") + // random slice sizes to read and write + writeChunks := []int{25, 35, 15, 20} + readChunks := []int{5, 45, 20, 25} + + for _, c := range cases { + // first pass: write directly to hash + hash := sha1.New() + for i := 0; i < c.iterations*c.writesPerLoop; i++ { + if _, err := hash.Write(testMessage[:writeChunks[i%len(writeChunks)]]); err != nil { + t.Fatal(err) + } + } + expected := hex.EncodeToString(hash.Sum(nil)) + + // write/read through buffer + buf := NewBytesPipe(nil) + hash.Reset() + for i := 0; i < c.iterations; i++ { + for w := 0; w < c.writesPerLoop; w++ { + buf.Write(testMessage[:writeChunks[(i*c.writesPerLoop+w)%len(writeChunks)]]) + } + for r := 0; r < c.readsPerLoop; r++ { + p := make([]byte, readChunks[(i*c.readsPerLoop+r)%len(readChunks)]) + n, _ := buf.Read(p) + hash.Write(p[:n]) + } + } + // read rest of the data from buffer + for i := 0; ; i++ { + p := make([]byte, readChunks[(c.iterations*c.readsPerLoop+i)%len(readChunks)]) + n, _ := buf.Read(p) + if n == 0 { + break + } + hash.Write(p[:n]) + } + actual := hex.EncodeToString(hash.Sum(nil)) + + if expected != actual { + t.Fatalf("BytesPipe returned invalid data. Expected checksum %v, got %v", expected, actual) + } + + } +} + +func BenchmarkBytesPipeWrite(b *testing.B) { + for i := 0; i < b.N; i++ { + buf := NewBytesPipe(nil) + for j := 0; j < 1000; j++ { + buf.Write([]byte("pretty short line, because why not?")) + } + } +} + +func BenchmarkBytesPipeRead(b *testing.B) { + rd := make([]byte, 1024) + for i := 0; i < b.N; i++ { + b.StopTimer() + buf := NewBytesPipe(nil) + for j := 0; j < 1000; j++ { + buf.Write(make([]byte, 1024)) + } + b.StartTimer() + for j := 0; j < 1000; j++ { + if n, _ := buf.Read(rd); n != 1024 { + b.Fatalf("Wrong number of bytes: %d", n) + } + } + } +} diff --git a/pkg/ioutils/fmt.go b/pkg/ioutils/fmt.go new file mode 100644 index 0000000000..0b04b0ba3e --- /dev/null +++ b/pkg/ioutils/fmt.go @@ -0,0 +1,22 @@ +package ioutils + +import ( + "fmt" + "io" +) + +// FprintfIfNotEmpty prints the string value if it's not empty +func FprintfIfNotEmpty(w io.Writer, format, value string) (int, error) { + if value != "" { + return fmt.Fprintf(w, format, value) + } + return 0, nil +} + +// FprintfIfTrue prints the boolean value if it's true +func FprintfIfTrue(w io.Writer, format string, ok bool) (int, error) { + if ok { + return fmt.Fprintf(w, format, ok) + } + return 0, nil +} diff --git a/pkg/ioutils/fmt_test.go b/pkg/ioutils/fmt_test.go new file mode 100644 index 0000000000..8968863296 --- /dev/null +++ b/pkg/ioutils/fmt_test.go @@ -0,0 +1,17 @@ +package ioutils + +import "testing" + +func TestFprintfIfNotEmpty(t *testing.T) { + wc := NewWriteCounter(&NopWriter{}) + n, _ := FprintfIfNotEmpty(wc, "foo%s", "") + + if wc.Count != 0 || n != 0 { + t.Errorf("Wrong count: %v vs. %v vs. 0", wc.Count, n) + } + + n, _ = FprintfIfNotEmpty(wc, "foo%s", "bar") + if wc.Count != 6 || n != 6 { + t.Errorf("Wrong count: %v vs. %v vs. 6", wc.Count, n) + } +} diff --git a/pkg/ioutils/multireader.go b/pkg/ioutils/multireader.go new file mode 100644 index 0000000000..0d2d76b479 --- /dev/null +++ b/pkg/ioutils/multireader.go @@ -0,0 +1,226 @@ +package ioutils + +import ( + "bytes" + "fmt" + "io" + "os" +) + +type pos struct { + idx int + offset int64 +} + +type multiReadSeeker struct { + readers []io.ReadSeeker + pos *pos + posIdx map[io.ReadSeeker]int +} + +func (r *multiReadSeeker) Seek(offset int64, whence int) (int64, error) { + var tmpOffset int64 + switch whence { + case os.SEEK_SET: + for i, rdr := range r.readers { + // get size of the current reader + s, err := rdr.Seek(0, os.SEEK_END) + if err != nil { + return -1, err + } + + if offset > tmpOffset+s { + if i == len(r.readers)-1 { + rdrOffset := s + (offset - tmpOffset) + if _, err := rdr.Seek(rdrOffset, os.SEEK_SET); err != nil { + return -1, err + } + r.pos = &pos{i, rdrOffset} + return offset, nil + } + + tmpOffset += s + continue + } + + rdrOffset := offset - tmpOffset + idx := i + + rdr.Seek(rdrOffset, os.SEEK_SET) + // make sure all following readers are at 0 + for _, rdr := range r.readers[i+1:] { + rdr.Seek(0, os.SEEK_SET) + } + + if rdrOffset == s && i != len(r.readers)-1 { + idx++ + rdrOffset = 0 + } + r.pos = &pos{idx, rdrOffset} + return offset, nil + } + case os.SEEK_END: + for _, rdr := range r.readers { + s, err := rdr.Seek(0, os.SEEK_END) + if err != nil { + return -1, err + } + tmpOffset += s + } + r.Seek(tmpOffset+offset, os.SEEK_SET) + return tmpOffset + offset, nil + case os.SEEK_CUR: + if r.pos == nil { + return r.Seek(offset, os.SEEK_SET) + } + // Just return the current offset + if offset == 0 { + return r.getCurOffset() + } + + curOffset, err := r.getCurOffset() + if err != nil { + return -1, err + } + rdr, rdrOffset, err := r.getReaderForOffset(curOffset + offset) + if err != nil { + return -1, err + } + + r.pos = &pos{r.posIdx[rdr], rdrOffset} + return curOffset + offset, nil + default: + return -1, fmt.Errorf("Invalid whence: %d", whence) + } + + return -1, fmt.Errorf("Error seeking for whence: %d, offset: %d", whence, offset) +} + +func (r *multiReadSeeker) getReaderForOffset(offset int64) (io.ReadSeeker, int64, error) { + var rdr io.ReadSeeker + var rdrOffset int64 + + for i, rdr := range r.readers { + offsetTo, err := r.getOffsetToReader(rdr) + if err != nil { + return nil, -1, err + } + if offsetTo > offset { + rdr = r.readers[i-1] + rdrOffset = offsetTo - offset + break + } + + if rdr == r.readers[len(r.readers)-1] { + rdrOffset = offsetTo + offset + break + } + } + + return rdr, rdrOffset, nil +} + +func (r *multiReadSeeker) getCurOffset() (int64, error) { + var totalSize int64 + for _, rdr := range r.readers[:r.pos.idx+1] { + if r.posIdx[rdr] == r.pos.idx { + totalSize += r.pos.offset + break + } + + size, err := getReadSeekerSize(rdr) + if err != nil { + return -1, fmt.Errorf("error getting seeker size: %v", err) + } + totalSize += size + } + return totalSize, nil +} + +func (r *multiReadSeeker) getOffsetToReader(rdr io.ReadSeeker) (int64, error) { + var offset int64 + for _, r := range r.readers { + if r == rdr { + break + } + + size, err := getReadSeekerSize(rdr) + if err != nil { + return -1, err + } + offset += size + } + return offset, nil +} + +func (r *multiReadSeeker) Read(b []byte) (int, error) { + if r.pos == nil { + r.pos = &pos{0, 0} + } + + bCap := int64(cap(b)) + buf := bytes.NewBuffer(nil) + var rdr io.ReadSeeker + + for _, rdr = range r.readers[r.pos.idx:] { + readBytes, err := io.CopyN(buf, rdr, bCap) + if err != nil && err != io.EOF { + return -1, err + } + bCap -= readBytes + + if bCap == 0 { + break + } + } + + rdrPos, err := rdr.Seek(0, os.SEEK_CUR) + if err != nil { + return -1, err + } + r.pos = &pos{r.posIdx[rdr], rdrPos} + return buf.Read(b) +} + +func getReadSeekerSize(rdr io.ReadSeeker) (int64, error) { + // save the current position + pos, err := rdr.Seek(0, os.SEEK_CUR) + if err != nil { + return -1, err + } + + // get the size + size, err := rdr.Seek(0, os.SEEK_END) + if err != nil { + return -1, err + } + + // reset the position + if _, err := rdr.Seek(pos, os.SEEK_SET); err != nil { + return -1, err + } + return size, nil +} + +// MultiReadSeeker returns a ReadSeeker that's the logical concatenation of the provided +// input readseekers. After calling this method the initial position is set to the +// beginning of the first ReadSeeker. At the end of a ReadSeeker, Read always advances +// to the beginning of the next ReadSeeker and returns EOF at the end of the last ReadSeeker. +// Seek can be used over the sum of lengths of all readseekers. +// +// When a MultiReadSeeker is used, no Read and Seek operations should be made on +// its ReadSeeker components. Also, users should make no assumption on the state +// of individual readseekers while the MultiReadSeeker is used. +func MultiReadSeeker(readers ...io.ReadSeeker) io.ReadSeeker { + if len(readers) == 1 { + return readers[0] + } + idx := make(map[io.ReadSeeker]int) + for i, rdr := range readers { + idx[rdr] = i + } + return &multiReadSeeker{ + readers: readers, + posIdx: idx, + } +} diff --git a/pkg/ioutils/multireader_test.go b/pkg/ioutils/multireader_test.go new file mode 100644 index 0000000000..de495b56da --- /dev/null +++ b/pkg/ioutils/multireader_test.go @@ -0,0 +1,149 @@ +package ioutils + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "os" + "strings" + "testing" +) + +func TestMultiReadSeekerReadAll(t *testing.T) { + str := "hello world" + s1 := strings.NewReader(str + " 1") + s2 := strings.NewReader(str + " 2") + s3 := strings.NewReader(str + " 3") + mr := MultiReadSeeker(s1, s2, s3) + + expectedSize := int64(s1.Len() + s2.Len() + s3.Len()) + + b, err := ioutil.ReadAll(mr) + if err != nil { + t.Fatal(err) + } + + expected := "hello world 1hello world 2hello world 3" + if string(b) != expected { + t.Fatalf("ReadAll failed, got: %q, expected %q", string(b), expected) + } + + size, err := mr.Seek(0, os.SEEK_END) + if err != nil { + t.Fatal(err) + } + if size != expectedSize { + t.Fatalf("reader size does not match, got %d, expected %d", size, expectedSize) + } + + // Reset the position and read again + pos, err := mr.Seek(0, os.SEEK_SET) + if err != nil { + t.Fatal(err) + } + if pos != 0 { + t.Fatalf("expected position to be set to 0, got %d", pos) + } + + b, err = ioutil.ReadAll(mr) + if err != nil { + t.Fatal(err) + } + + if string(b) != expected { + t.Fatalf("ReadAll failed, got: %q, expected %q", string(b), expected) + } +} + +func TestMultiReadSeekerReadEach(t *testing.T) { + str := "hello world" + s1 := strings.NewReader(str + " 1") + s2 := strings.NewReader(str + " 2") + s3 := strings.NewReader(str + " 3") + mr := MultiReadSeeker(s1, s2, s3) + + var totalBytes int64 + for i, s := range []*strings.Reader{s1, s2, s3} { + sLen := int64(s.Len()) + buf := make([]byte, s.Len()) + expected := []byte(fmt.Sprintf("%s %d", str, i+1)) + + if _, err := mr.Read(buf); err != nil && err != io.EOF { + t.Fatal(err) + } + + if !bytes.Equal(buf, expected) { + t.Fatalf("expected %q to be %q", string(buf), string(expected)) + } + + pos, err := mr.Seek(0, os.SEEK_CUR) + if err != nil { + t.Fatalf("iteration: %d, error: %v", i+1, err) + } + + // check that the total bytes read is the current position of the seeker + totalBytes += sLen + if pos != totalBytes { + t.Fatalf("expected current position to be: %d, got: %d, iteration: %d", totalBytes, pos, i+1) + } + + // This tests not only that SEEK_SET and SEEK_CUR give the same values, but that the next iteration is in the expected position as well + newPos, err := mr.Seek(pos, os.SEEK_SET) + if err != nil { + t.Fatal(err) + } + if newPos != pos { + t.Fatalf("expected to get same position when calling SEEK_SET with value from SEEK_CUR, cur: %d, set: %d", pos, newPos) + } + } +} + +func TestMultiReadSeekerReadSpanningChunks(t *testing.T) { + str := "hello world" + s1 := strings.NewReader(str + " 1") + s2 := strings.NewReader(str + " 2") + s3 := strings.NewReader(str + " 3") + mr := MultiReadSeeker(s1, s2, s3) + + buf := make([]byte, s1.Len()+3) + _, err := mr.Read(buf) + if err != nil { + t.Fatal(err) + } + + // expected is the contents of s1 + 3 bytes from s2, ie, the `hel` at the end of this string + expected := "hello world 1hel" + if string(buf) != expected { + t.Fatalf("expected %s to be %s", string(buf), expected) + } +} + +func TestMultiReadSeekerNegativeSeek(t *testing.T) { + str := "hello world" + s1 := strings.NewReader(str + " 1") + s2 := strings.NewReader(str + " 2") + s3 := strings.NewReader(str + " 3") + mr := MultiReadSeeker(s1, s2, s3) + + s1Len := s1.Len() + s2Len := s2.Len() + s3Len := s3.Len() + + s, err := mr.Seek(int64(-1*s3.Len()), os.SEEK_END) + if err != nil { + t.Fatal(err) + } + if s != int64(s1Len+s2Len) { + t.Fatalf("expected %d to be %d", s, s1.Len()+s2.Len()) + } + + buf := make([]byte, s3Len) + if _, err := mr.Read(buf); err != nil && err != io.EOF { + t.Fatal(err) + } + expected := fmt.Sprintf("%s %d", str, 3) + if string(buf) != fmt.Sprintf("%s %d", str, 3) { + t.Fatalf("expected %q to be %q", string(buf), expected) + } +} diff --git a/pkg/ioutils/readers.go b/pkg/ioutils/readers.go new file mode 100644 index 0000000000..e6ff040cfa --- /dev/null +++ b/pkg/ioutils/readers.go @@ -0,0 +1,252 @@ +package ioutils + +import ( + "crypto/sha256" + "encoding/hex" + "io" + "math/big" + "sync" + "time" +) + +type readCloserWrapper struct { + io.Reader + closer func() error +} + +func (r *readCloserWrapper) Close() error { + return r.closer() +} + +// NewReadCloserWrapper returns a new io.ReadCloser. +func NewReadCloserWrapper(r io.Reader, closer func() error) io.ReadCloser { + return &readCloserWrapper{ + Reader: r, + closer: closer, + } +} + +type readerErrWrapper struct { + reader io.Reader + closer func() +} + +func (r *readerErrWrapper) Read(p []byte) (int, error) { + n, err := r.reader.Read(p) + if err != nil { + r.closer() + } + return n, err +} + +// NewReaderErrWrapper returns a new io.Reader. +func NewReaderErrWrapper(r io.Reader, closer func()) io.Reader { + return &readerErrWrapper{ + reader: r, + closer: closer, + } +} + +// bufReader allows the underlying reader to continue to produce +// output by pre-emptively reading from the wrapped reader. +// This is achieved by buffering this data in bufReader's +// expanding buffer. +type bufReader struct { + sync.Mutex + buf io.ReadWriter + reader io.Reader + err error + wait sync.Cond + drainBuf []byte +} + +// NewBufReader returns a new bufReader. +func NewBufReader(r io.Reader) io.ReadCloser { + reader := &bufReader{ + buf: NewBytesPipe(nil), + reader: r, + drainBuf: make([]byte, 1024), + } + reader.wait.L = &reader.Mutex + go reader.drain() + return reader +} + +// NewBufReaderWithDrainbufAndBuffer returns a BufReader with drainBuffer and buffer. +func NewBufReaderWithDrainbufAndBuffer(r io.Reader, drainBuffer []byte, buffer io.ReadWriter) io.ReadCloser { + reader := &bufReader{ + buf: buffer, + drainBuf: drainBuffer, + reader: r, + } + reader.wait.L = &reader.Mutex + go reader.drain() + return reader +} + +func (r *bufReader) drain() { + var ( + duration time.Duration + lastReset time.Time + now time.Time + reset bool + bufLen int64 + dataSinceReset int64 + maxBufLen int64 + reuseBufLen int64 + reuseCount int64 + ) + reuseBufLen = int64(len(r.reuseBuf)) + lastReset = time.Now() + for { + //Call to scheduler is made to yield from this goroutine. + //This avoids goroutine looping here when n=0,err=nil, fixes code hangs when run with GCC Go. + callSchedulerIfNecessary() + n, err := r.reader.Read(r.drainBuf) + dataSinceReset += int64(n) + r.Lock() + bufLen = int64(r.buf.Len()) + if bufLen > maxBufLen { + maxBufLen = bufLen + } + + // Avoid unbounded growth of the buffer over time. + // This has been discovered to be the only non-intrusive + // solution to the unbounded growth of the buffer. + // Alternative solutions such as compression, multiple + // buffers, channels and other similar pieces of code + // were reducing throughput, overall Docker performance + // or simply crashed Docker. + // This solution releases the buffer when specific + // conditions are met to avoid the continuous resizing + // of the buffer for long lived containers. + // + // Move data to the front of the buffer if it's + // smaller than what reuseBuf can store + if bufLen > 0 && reuseBufLen >= bufLen { + n, _ := r.buf.Read(r.reuseBuf) + r.buf.Write(r.reuseBuf[0:n]) + // Take action if the buffer has been reused too many + // times and if there's data in the buffer. + // The timeout is also used as means to avoid doing + // these operations more often or less often than + // required. + // The various conditions try to detect heavy activity + // in the buffer which might be indicators of heavy + // growth of the buffer. + } else if reuseCount >= r.maxReuse && bufLen > 0 { + now = time.Now() + duration = now.Sub(lastReset) + timeoutReached := duration >= r.resetTimeout + + // The timeout has been reached and the + // buffered data couldn't be moved to the front + // of the buffer, so the buffer gets reset. + if timeoutReached && bufLen > reuseBufLen { + reset = true + } + // The amount of buffered data is too high now, + // reset the buffer. + if timeoutReached && maxBufLen >= r.bufLenResetThreshold { + reset = true + } + // Reset the buffer if a certain amount of + // data has gone through the buffer since the + // last reset. + if timeoutReached && dataSinceReset >= r.maxReadDataReset { + reset = true + } + // The buffered data is moved to a fresh buffer, + // swap the old buffer with the new one and + // reset all counters. + if reset { + newbuf := &bytes.Buffer{} + newbuf.ReadFrom(r.buf) + r.buf = newbuf + lastReset = now + reset = false + dataSinceReset = 0 + maxBufLen = 0 + reuseCount = 0 + } + } + if err != nil { + r.err = err + } else { + if n == 0 { + // nothing written, no need to signal + r.Unlock() + continue + } + r.buf.Write(r.drainBuf[:n]) + } + reuseCount++ + r.wait.Signal() + r.Unlock() + if err != nil { + break + } + } +} + +func (r *bufReader) Read(p []byte) (n int, err error) { + r.Lock() + defer r.Unlock() + for { + n, err = r.buf.Read(p) + if n > 0 { + return n, err + } + if r.err != nil { + return 0, r.err + } + r.wait.Wait() + } +} + +// Close closes the bufReader +func (r *bufReader) Close() error { + closer, ok := r.reader.(io.ReadCloser) + if !ok { + return nil + } + return closer.Close() +} + +// HashData returns the sha256 sum of src. +func HashData(src io.Reader) (string, error) { + h := sha256.New() + if _, err := io.Copy(h, src); err != nil { + return "", err + } + return "sha256:" + hex.EncodeToString(h.Sum(nil)), nil +} + +// OnEOFReader wraps a io.ReadCloser and a function +// the function will run at the end of file or close the file. +type OnEOFReader struct { + Rc io.ReadCloser + Fn func() +} + +func (r *OnEOFReader) Read(p []byte) (n int, err error) { + n, err = r.Rc.Read(p) + if err == io.EOF { + r.runFunc() + } + return +} + +// Close closes the file and run the function. +func (r *OnEOFReader) Close() error { + err := r.Rc.Close() + r.runFunc() + return err +} + +func (r *OnEOFReader) runFunc() { + if fn := r.Fn; fn != nil { + fn() + r.Fn = nil + } +} diff --git a/pkg/ioutils/readers_test.go b/pkg/ioutils/readers_test.go new file mode 100644 index 0000000000..5c26a2a147 --- /dev/null +++ b/pkg/ioutils/readers_test.go @@ -0,0 +1,224 @@ +package ioutils + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "strings" + "testing" + "time" +) + +// Implement io.Reader +type errorReader struct{} + +func (r *errorReader) Read(p []byte) (int, error) { + return 0, fmt.Errorf("Error reader always fail.") +} + +func TestReadCloserWrapperClose(t *testing.T) { + reader := strings.NewReader("A string reader") + wrapper := NewReadCloserWrapper(reader, func() error { + return fmt.Errorf("This will be called when closing") + }) + err := wrapper.Close() + if err == nil || !strings.Contains(err.Error(), "This will be called when closing") { + t.Fatalf("readCloserWrapper should have call the anonymous func and thus, fail.") + } +} + +func TestReaderErrWrapperReadOnError(t *testing.T) { + called := false + reader := &errorReader{} + wrapper := NewReaderErrWrapper(reader, func() { + called = true + }) + _, err := wrapper.Read([]byte{}) + if err == nil || !strings.Contains(err.Error(), "Error reader always fail.") { + t.Fatalf("readErrWrapper should returned an error") + } + if !called { + t.Fatalf("readErrWrapper should have call the anonymous function on failure") + } +} + +func TestReaderErrWrapperRead(t *testing.T) { + reader := strings.NewReader("a string reader.") + wrapper := NewReaderErrWrapper(reader, func() { + t.Fatalf("readErrWrapper should not have called the anonymous function") + }) + // Read 20 byte (should be ok with the string above) + num, err := wrapper.Read(make([]byte, 20)) + if err != nil { + t.Fatal(err) + } + if num != 16 { + t.Fatalf("readerErrWrapper should have read 16 byte, but read %d", num) + } +} + +func TestNewBufReaderWithDrainbufAndBuffer(t *testing.T) { + reader, writer := io.Pipe() + + drainBuffer := make([]byte, 1024) + buffer := NewBytesPipe(nil) + bufreader := NewBufReaderWithDrainbufAndBuffer(reader, drainBuffer, buffer) + + // Write everything down to a Pipe + // Usually, a pipe should block but because of the buffered reader, + // the writes will go through + done := make(chan bool) + go func() { + writer.Write([]byte("hello world")) + writer.Close() + done <- true + }() + + // Drain the reader *after* everything has been written, just to verify + // it is indeed buffering + select { + case <-done: + case <-time.After(1 * time.Second): + t.Fatal("timeout") + } + + output, err := ioutil.ReadAll(bufreader) + if err != nil { + t.Fatal(err) + } + if !bytes.Equal(output, []byte("hello world")) { + t.Error(string(output)) + } +} + +func TestBufReader(t *testing.T) { + reader, writer := io.Pipe() + bufreader := NewBufReader(reader) + + // Write everything down to a Pipe + // Usually, a pipe should block but because of the buffered reader, + // the writes will go through + done := make(chan bool) + go func() { + writer.Write([]byte("hello world")) + writer.Close() + done <- true + }() + + // Drain the reader *after* everything has been written, just to verify + // it is indeed buffering + <-done + output, err := ioutil.ReadAll(bufreader) + if err != nil { + t.Fatal(err) + } + if !bytes.Equal(output, []byte("hello world")) { + t.Error(string(output)) + } +} + +func TestBufReaderCloseWithNonReaderCloser(t *testing.T) { + reader := strings.NewReader("buffer") + bufreader := NewBufReader(reader) + + if err := bufreader.Close(); err != nil { + t.Fatal(err) + } + +} + +// implements io.ReadCloser +type simpleReaderCloser struct { + err error +} + +func (r *simpleReaderCloser) Read(p []byte) (n int, err error) { + return 0, r.err +} + +func (r *simpleReaderCloser) Close() error { + r.err = io.EOF + return nil +} + +func TestBufReaderCloseWithReaderCloser(t *testing.T) { + reader := &simpleReaderCloser{} + bufreader := NewBufReader(reader) + + err := bufreader.Close() + if err != nil { + t.Fatal(err) + } + +} + +func TestHashData(t *testing.T) { + reader := strings.NewReader("hash-me") + actual, err := HashData(reader) + if err != nil { + t.Fatal(err) + } + expected := "sha256:4d11186aed035cc624d553e10db358492c84a7cd6b9670d92123c144930450aa" + if actual != expected { + t.Fatalf("Expecting %s, got %s", expected, actual) + } +} + +type repeatedReader struct { + readCount int + maxReads int + data []byte +} + +func newRepeatedReader(max int, data []byte) *repeatedReader { + return &repeatedReader{0, max, data} +} + +func (r *repeatedReader) Read(p []byte) (int, error) { + if r.readCount >= r.maxReads { + return 0, io.EOF + } + r.readCount++ + n := copy(p, r.data) + return n, nil +} + +func testWithData(data []byte, reads int) { + reader := newRepeatedReader(reads, data) + bufReader := NewBufReader(reader) + io.Copy(ioutil.Discard, bufReader) +} + +func Benchmark1M10BytesReads(b *testing.B) { + reads := 1000000 + readSize := int64(10) + data := make([]byte, readSize) + b.SetBytes(readSize * int64(reads)) + b.ResetTimer() + for i := 0; i < b.N; i++ { + testWithData(data, reads) + } +} + +func Benchmark1M1024BytesReads(b *testing.B) { + reads := 1000000 + readSize := int64(1024) + data := make([]byte, readSize) + b.SetBytes(readSize * int64(reads)) + b.ResetTimer() + for i := 0; i < b.N; i++ { + testWithData(data, reads) + } +} + +func Benchmark10k32KBytesReads(b *testing.B) { + reads := 10000 + readSize := int64(32 * 1024) + data := make([]byte, readSize) + b.SetBytes(readSize * int64(reads)) + b.ResetTimer() + for i := 0; i < b.N; i++ { + testWithData(data, reads) + } +} diff --git a/pkg/ioutils/scheduler.go b/pkg/ioutils/scheduler.go new file mode 100644 index 0000000000..3c88f29e35 --- /dev/null +++ b/pkg/ioutils/scheduler.go @@ -0,0 +1,6 @@ +// +build !gccgo + +package ioutils + +func callSchedulerIfNecessary() { +} diff --git a/pkg/ioutils/scheduler_gccgo.go b/pkg/ioutils/scheduler_gccgo.go new file mode 100644 index 0000000000..c11d02b947 --- /dev/null +++ b/pkg/ioutils/scheduler_gccgo.go @@ -0,0 +1,13 @@ +// +build gccgo + +package ioutils + +import ( + "runtime" +) + +func callSchedulerIfNecessary() { + //allow or force Go scheduler to switch context, without explicitly + //forcing this will make it hang when using gccgo implementation + runtime.Gosched() +} diff --git a/pkg/ioutils/temp_unix.go b/pkg/ioutils/temp_unix.go new file mode 100644 index 0000000000..1539ad21b5 --- /dev/null +++ b/pkg/ioutils/temp_unix.go @@ -0,0 +1,10 @@ +// +build !windows + +package ioutils + +import "io/ioutil" + +// TempDir on Unix systems is equivalent to ioutil.TempDir. +func TempDir(dir, prefix string) (string, error) { + return ioutil.TempDir(dir, prefix) +} diff --git a/pkg/ioutils/temp_windows.go b/pkg/ioutils/temp_windows.go new file mode 100644 index 0000000000..c258e5fdd8 --- /dev/null +++ b/pkg/ioutils/temp_windows.go @@ -0,0 +1,18 @@ +// +build windows + +package ioutils + +import ( + "io/ioutil" + + "github.com/docker/docker/pkg/longpath" +) + +// TempDir is the equivalent of ioutil.TempDir, except that the result is in Windows longpath format. +func TempDir(dir, prefix string) (string, error) { + tempDir, err := ioutil.TempDir(dir, prefix) + if err != nil { + return "", err + } + return longpath.AddPrefix(tempDir), nil +} diff --git a/pkg/ioutils/writeflusher.go b/pkg/ioutils/writeflusher.go new file mode 100644 index 0000000000..2b35a26662 --- /dev/null +++ b/pkg/ioutils/writeflusher.go @@ -0,0 +1,92 @@ +package ioutils + +import ( + "errors" + "io" + "net/http" + "sync" +) + +// WriteFlusher wraps the Write and Flush operation ensuring that every write +// is a flush. In addition, the Close method can be called to intercept +// Read/Write calls if the targets lifecycle has already ended. +type WriteFlusher struct { + mu sync.Mutex + w io.Writer + flusher http.Flusher + flushed bool + closed error + + // TODO(stevvooe): Use channel for closed instead, remove mutex. Using a + // channel will allow one to properly order the operations. +} + +var errWriteFlusherClosed = errors.New("writeflusher: closed") + +func (wf *WriteFlusher) Write(b []byte) (n int, err error) { + wf.mu.Lock() + defer wf.mu.Unlock() + if wf.closed != nil { + return 0, wf.closed + } + + n, err = wf.w.Write(b) + wf.flush() // every write is a flush. + return n, err +} + +// Flush the stream immediately. +func (wf *WriteFlusher) Flush() { + wf.mu.Lock() + defer wf.mu.Unlock() + + wf.flush() +} + +// flush the stream immediately without taking a lock. Used internally. +func (wf *WriteFlusher) flush() { + if wf.closed != nil { + return + } + + wf.flushed = true + wf.flusher.Flush() +} + +// Flushed returns the state of flushed. +// If it's flushed, return true, or else it return false. +func (wf *WriteFlusher) Flushed() bool { + // BUG(stevvooe): Remove this method. Its use is inherently racy. Seems to + // be used to detect whether or a response code has been issued or not. + // Another hook should be used instead. + wf.mu.Lock() + defer wf.mu.Unlock() + + return wf.flushed +} + +// Close closes the write flusher, disallowing any further writes to the +// target. After the flusher is closed, all calls to write or flush will +// result in an error. +func (wf *WriteFlusher) Close() error { + wf.mu.Lock() + defer wf.mu.Unlock() + + if wf.closed != nil { + return wf.closed + } + + wf.closed = errWriteFlusherClosed + return nil +} + +// NewWriteFlusher returns a new WriteFlusher. +func NewWriteFlusher(w io.Writer) *WriteFlusher { + var flusher http.Flusher + if f, ok := w.(http.Flusher); ok { + flusher = f + } else { + flusher = &NopFlusher{} + } + return &WriteFlusher{w: w, flusher: flusher} +} diff --git a/pkg/ioutils/writers.go b/pkg/ioutils/writers.go new file mode 100644 index 0000000000..7a3249f3a0 --- /dev/null +++ b/pkg/ioutils/writers.go @@ -0,0 +1,66 @@ +package ioutils + +import "io" + +// NopWriter represents a type which write operation is nop. +type NopWriter struct{} + +func (*NopWriter) Write(buf []byte) (int, error) { + return len(buf), nil +} + +type nopWriteCloser struct { + io.Writer +} + +func (w *nopWriteCloser) Close() error { return nil } + +// NopWriteCloser returns a nopWriteCloser. +func NopWriteCloser(w io.Writer) io.WriteCloser { + return &nopWriteCloser{w} +} + +// NopFlusher represents a type which flush opetatin is nop. +type NopFlusher struct{} + +// Flush is a nop operation. +func (f *NopFlusher) Flush() {} + +type writeCloserWrapper struct { + io.Writer + closer func() error +} + +func (r *writeCloserWrapper) Close() error { + return r.closer() +} + +// NewWriteCloserWrapper returns a new io.WriteCloser. +func NewWriteCloserWrapper(r io.Writer, closer func() error) io.WriteCloser { + return &writeCloserWrapper{ + Writer: r, + closer: closer, + } +} + +// WriteCounter wraps a concrete io.Writer and hold a count of the number +// of bytes written to the writer during a "session". +// This can be convenient when write return is masked +// (e.g., json.Encoder.Encode()) +type WriteCounter struct { + Count int64 + Writer io.Writer +} + +// NewWriteCounter returns a new WriteCounter. +func NewWriteCounter(w io.Writer) *WriteCounter { + return &WriteCounter{ + Writer: w, + } +} + +func (wc *WriteCounter) Write(p []byte) (count int, err error) { + count, err = wc.Writer.Write(p) + wc.Count += int64(count) + return +} diff --git a/pkg/ioutils/writers_test.go b/pkg/ioutils/writers_test.go new file mode 100644 index 0000000000..564b1cd4f5 --- /dev/null +++ b/pkg/ioutils/writers_test.go @@ -0,0 +1,65 @@ +package ioutils + +import ( + "bytes" + "strings" + "testing" +) + +func TestWriteCloserWrapperClose(t *testing.T) { + called := false + writer := bytes.NewBuffer([]byte{}) + wrapper := NewWriteCloserWrapper(writer, func() error { + called = true + return nil + }) + if err := wrapper.Close(); err != nil { + t.Fatal(err) + } + if !called { + t.Fatalf("writeCloserWrapper should have call the anonymous function.") + } +} + +func TestNopWriteCloser(t *testing.T) { + writer := bytes.NewBuffer([]byte{}) + wrapper := NopWriteCloser(writer) + if err := wrapper.Close(); err != nil { + t.Fatal("NopWriteCloser always return nil on Close.") + } + +} + +func TestNopWriter(t *testing.T) { + nw := &NopWriter{} + l, err := nw.Write([]byte{'c'}) + if err != nil { + t.Fatal(err) + } + if l != 1 { + t.Fatalf("Expected 1 got %d", l) + } +} + +func TestWriteCounter(t *testing.T) { + dummy1 := "This is a dummy string." + dummy2 := "This is another dummy string." + totalLength := int64(len(dummy1) + len(dummy2)) + + reader1 := strings.NewReader(dummy1) + reader2 := strings.NewReader(dummy2) + + var buffer bytes.Buffer + wc := NewWriteCounter(&buffer) + + reader1.WriteTo(wc) + reader2.WriteTo(wc) + + if wc.Count != totalLength { + t.Errorf("Wrong count: %d vs. %d", wc.Count, totalLength) + } + + if buffer.String() != dummy1+dummy2 { + t.Error("Wrong message written") + } +} diff --git a/pkg/jsonlog/jsonlog.go b/pkg/jsonlog/jsonlog.go new file mode 100644 index 0000000000..9a717698ea --- /dev/null +++ b/pkg/jsonlog/jsonlog.go @@ -0,0 +1,40 @@ +package jsonlog + +import ( + "encoding/json" + "fmt" + "time" +) + +// JSONLog represents a log message, typically a single entry from a given log stream. +// JSONLogs can be easily serialized to and from JSON and support custom formatting. +type JSONLog struct { + // Log is the log message + Log string `json:"log,omitempty"` + // Stream is the log source + Stream string `json:"stream,omitempty"` + // Created is the created timestamp of log + Created time.Time `json:"time"` +} + +// Format returns the log formatted according to format +// If format is nil, returns the log message +// If format is json, returns the log marshalled in json format +// By defalut, returns the log with the log time formatted according to format. +func (jl *JSONLog) Format(format string) (string, error) { + if format == "" { + return jl.Log, nil + } + if format == "json" { + m, err := json.Marshal(jl) + return string(m), err + } + return fmt.Sprintf("%s %s", jl.Created.Format(format), jl.Log), nil +} + +// Reset resets the log to nil. +func (jl *JSONLog) Reset() { + jl.Log = "" + jl.Stream = "" + jl.Created = time.Time{} +} diff --git a/pkg/jsonlog/jsonlog_marshalling.go b/pkg/jsonlog/jsonlog_marshalling.go new file mode 100644 index 0000000000..6dcb69d470 --- /dev/null +++ b/pkg/jsonlog/jsonlog_marshalling.go @@ -0,0 +1,184 @@ +// This code was initially generated by ffjson +// This code was generated via the following steps: +// $ go get -u github.com/pquerna/ffjson +// $ make BIND_DIR=. shell +// $ ffjson pkg/jsonlog/jsonlog.go +// $ mv pkg/jsonglog/jsonlog_ffjson.go pkg/jsonlog/jsonlog_marshalling.go +// +// It has been modified to improve the performance of time marshalling to JSON +// and to clean it up. +// Should this code need to be regenerated when the JSONLog struct is changed, +// the relevant changes which have been made are: +// import ( +// "bytes" +//- +// "unicode/utf8" +//+ +//+ "github.com/docker/docker/pkg/timeutils" +// ) +// +// func (mj *JSONLog) MarshalJSON() ([]byte, error) { +//@@ -20,13 +16,13 @@ func (mj *JSONLog) MarshalJSON() ([]byte, error) { +// } +// return buf.Bytes(), nil +// } +//+ +// func (mj *JSONLog) MarshalJSONBuf(buf *bytes.Buffer) error { +//- var err error +//- var obj []byte +//- var first bool = true +//- _ = obj +//- _ = err +//- _ = first +//+ var ( +//+ err error +//+ timestamp string +//+ first bool = true +//+ ) +// buf.WriteString(`{`) +// if len(mj.Log) != 0 { +// if first == true { +//@@ -52,11 +48,11 @@ func (mj *JSONLog) MarshalJSONBuf(buf *bytes.Buffer) error { +// buf.WriteString(`,`) +// } +// buf.WriteString(`"time":`) +//- obj, err = mj.Created.MarshalJSON() +//+ timestamp, err = timeutils.FastMarshalJSON(mj.Created) +// if err != nil { +// return err +// } +//- buf.Write(obj) +//+ buf.WriteString(timestamp) +// buf.WriteString(`}`) +// return nil +// } +// @@ -81,9 +81,10 @@ func (mj *JSONLog) MarshalJSONBuf(buf *bytes.Buffer) error { +// if len(mj.Log) != 0 { +// - if first == true { +// - first = false +// - } else { +// - buf.WriteString(`,`) +// - } +// + first = false +// buf.WriteString(`"log":`) +// ffjsonWriteJSONString(buf, mj.Log) +// } + +package jsonlog + +import ( + "bytes" + "unicode/utf8" + + "github.com/docker/docker/pkg/timeutils" +) + +// MarshalJSON marshals the JSONLog. +func (mj *JSONLog) MarshalJSON() ([]byte, error) { + var buf bytes.Buffer + buf.Grow(1024) + if err := mj.MarshalJSONBuf(&buf); err != nil { + return nil, err + } + return buf.Bytes(), nil +} + +// MarshalJSONBuf marshals the JSONLog and stores the result to a bytes.Buffer. +func (mj *JSONLog) MarshalJSONBuf(buf *bytes.Buffer) error { + var ( + err error + timestamp string + first = true + ) + buf.WriteString(`{`) + if len(mj.Log) != 0 { + first = false + buf.WriteString(`"log":`) + ffjsonWriteJSONString(buf, mj.Log) + } + if len(mj.Stream) != 0 { + if first == true { + first = false + } else { + buf.WriteString(`,`) + } + buf.WriteString(`"stream":`) + ffjsonWriteJSONString(buf, mj.Stream) + } + if first == true { + first = false + } else { + buf.WriteString(`,`) + } + buf.WriteString(`"time":`) + timestamp, err = timeutils.FastMarshalJSON(mj.Created) + if err != nil { + return err + } + buf.WriteString(timestamp) + buf.WriteString(`}`) + return nil +} + +func ffjsonWriteJSONString(buf *bytes.Buffer, s string) { + const hex = "0123456789abcdef" + + buf.WriteByte('"') + start := 0 + for i := 0; i < len(s); { + if b := s[i]; b < utf8.RuneSelf { + if 0x20 <= b && b != '\\' && b != '"' && b != '<' && b != '>' && b != '&' { + i++ + continue + } + if start < i { + buf.WriteString(s[start:i]) + } + switch b { + case '\\', '"': + buf.WriteByte('\\') + buf.WriteByte(b) + case '\n': + buf.WriteByte('\\') + buf.WriteByte('n') + case '\r': + buf.WriteByte('\\') + buf.WriteByte('r') + default: + + buf.WriteString(`\u00`) + buf.WriteByte(hex[b>>4]) + buf.WriteByte(hex[b&0xF]) + } + i++ + start = i + continue + } + c, size := utf8.DecodeRuneInString(s[i:]) + if c == utf8.RuneError && size == 1 { + if start < i { + buf.WriteString(s[start:i]) + } + buf.WriteString(`\ufffd`) + i += size + start = i + continue + } + + if c == '\u2028' || c == '\u2029' { + if start < i { + buf.WriteString(s[start:i]) + } + buf.WriteString(`\u202`) + buf.WriteByte(hex[c&0xF]) + i += size + start = i + continue + } + i += size + } + if start < len(s) { + buf.WriteString(s[start:]) + } + buf.WriteByte('"') +} diff --git a/pkg/jsonlog/jsonlog_marshalling_test.go b/pkg/jsonlog/jsonlog_marshalling_test.go new file mode 100644 index 0000000000..5e455685ab --- /dev/null +++ b/pkg/jsonlog/jsonlog_marshalling_test.go @@ -0,0 +1,34 @@ +package jsonlog + +import ( + "regexp" + "testing" +) + +func TestJSONLogMarshalJSON(t *testing.T) { + logs := map[JSONLog]string{ + JSONLog{Log: `"A log line with \\"`}: `^{\"log\":\"\\\"A log line with \\\\\\\\\\\"\",\"time\":\".{20,}\"}$`, + JSONLog{Log: "A log line"}: `^{\"log\":\"A log line\",\"time\":\".{20,}\"}$`, + JSONLog{Log: "A log line with \r"}: `^{\"log\":\"A log line with \\r\",\"time\":\".{20,}\"}$`, + JSONLog{Log: "A log line with & < >"}: `^{\"log\":\"A log line with \\u0026 \\u003c \\u003e\",\"time\":\".{20,}\"}$`, + JSONLog{Log: "A log line with utf8 : 🚀 ψ ω β"}: `^{\"log\":\"A log line with utf8 : 🚀 ψ ω β\",\"time\":\".{20,}\"}$`, + JSONLog{Stream: "stdout"}: `^{\"stream\":\"stdout\",\"time\":\".{20,}\"}$`, + JSONLog{}: `^{\"time\":\".{20,}\"}$`, + // These ones are a little weird + JSONLog{Log: "\u2028 \u2029"}: `^{\"log\":\"\\u2028 \\u2029\",\"time\":\".{20,}\"}$`, + JSONLog{Log: string([]byte{0xaF})}: `^{\"log\":\"\\ufffd\",\"time\":\".{20,}\"}$`, + JSONLog{Log: string([]byte{0x7F})}: `^{\"log\":\"\x7f\",\"time\":\".{20,}\"}$`, + } + for jsonLog, expression := range logs { + data, err := jsonLog.MarshalJSON() + if err != nil { + t.Fatal(err) + } + res := string(data) + t.Logf("Result of WriteLog: %q", res) + logRe := regexp.MustCompile(expression) + if !logRe.MatchString(res) { + t.Fatalf("Log line not in expected format [%v]: %q", expression, res) + } + } +} diff --git a/pkg/jsonlog/jsonlogbytes.go b/pkg/jsonlog/jsonlogbytes.go new file mode 100644 index 0000000000..ff7aaf16e3 --- /dev/null +++ b/pkg/jsonlog/jsonlogbytes.go @@ -0,0 +1,124 @@ +package jsonlog + +import ( + "bytes" + "encoding/json" + "unicode/utf8" +) + +// JSONLogs is based on JSONLog. +// It allows marshalling JSONLog from Log as []byte +// and an already marshalled Created timestamp. +type JSONLogs struct { + Log []byte `json:"log,omitempty"` + Stream string `json:"stream,omitempty"` + Created string `json:"time"` + + // json-encoded bytes + RawAttrs json.RawMessage `json:"attrs,omitempty"` +} + +// MarshalJSONBuf is based on the same method from JSONLog +// It has been modified to take into account the necessary changes. +func (mj *JSONLogs) MarshalJSONBuf(buf *bytes.Buffer) error { + var first = true + + buf.WriteString(`{`) + if len(mj.Log) != 0 { + first = false + buf.WriteString(`"log":`) + ffjsonWriteJSONBytesAsString(buf, mj.Log) + } + if len(mj.Stream) != 0 { + if first == true { + first = false + } else { + buf.WriteString(`,`) + } + buf.WriteString(`"stream":`) + ffjsonWriteJSONString(buf, mj.Stream) + } + if len(mj.RawAttrs) > 0 { + if first == true { + first = false + } else { + buf.WriteString(`,`) + } + buf.WriteString(`"attrs":`) + buf.Write(mj.RawAttrs) + } + if first == true { + first = false + } else { + buf.WriteString(`,`) + } + buf.WriteString(`"time":`) + buf.WriteString(mj.Created) + buf.WriteString(`}`) + return nil +} + +// This is based on ffjsonWriteJSONBytesAsString. It has been changed +// to accept a string passed as a slice of bytes. +func ffjsonWriteJSONBytesAsString(buf *bytes.Buffer, s []byte) { + const hex = "0123456789abcdef" + + buf.WriteByte('"') + start := 0 + for i := 0; i < len(s); { + if b := s[i]; b < utf8.RuneSelf { + if 0x20 <= b && b != '\\' && b != '"' && b != '<' && b != '>' && b != '&' { + i++ + continue + } + if start < i { + buf.Write(s[start:i]) + } + switch b { + case '\\', '"': + buf.WriteByte('\\') + buf.WriteByte(b) + case '\n': + buf.WriteByte('\\') + buf.WriteByte('n') + case '\r': + buf.WriteByte('\\') + buf.WriteByte('r') + default: + + buf.WriteString(`\u00`) + buf.WriteByte(hex[b>>4]) + buf.WriteByte(hex[b&0xF]) + } + i++ + start = i + continue + } + c, size := utf8.DecodeRune(s[i:]) + if c == utf8.RuneError && size == 1 { + if start < i { + buf.Write(s[start:i]) + } + buf.WriteString(`\ufffd`) + i += size + start = i + continue + } + + if c == '\u2028' || c == '\u2029' { + if start < i { + buf.Write(s[start:i]) + } + buf.WriteString(`\u202`) + buf.WriteByte(hex[c&0xF]) + i += size + start = i + continue + } + i += size + } + if start < len(s) { + buf.Write(s[start:]) + } + buf.WriteByte('"') +} diff --git a/pkg/jsonlog/jsonlogbytes_test.go b/pkg/jsonlog/jsonlogbytes_test.go new file mode 100644 index 0000000000..6d6ad21583 --- /dev/null +++ b/pkg/jsonlog/jsonlogbytes_test.go @@ -0,0 +1,39 @@ +package jsonlog + +import ( + "bytes" + "regexp" + "testing" +) + +func TestJSONLogsMarshalJSONBuf(t *testing.T) { + logs := map[*JSONLogs]string{ + &JSONLogs{Log: []byte(`"A log line with \\"`)}: `^{\"log\":\"\\\"A log line with \\\\\\\\\\\"\",\"time\":}$`, + &JSONLogs{Log: []byte("A log line")}: `^{\"log\":\"A log line\",\"time\":}$`, + &JSONLogs{Log: []byte("A log line with \r")}: `^{\"log\":\"A log line with \\r\",\"time\":}$`, + &JSONLogs{Log: []byte("A log line with & < >")}: `^{\"log\":\"A log line with \\u0026 \\u003c \\u003e\",\"time\":}$`, + &JSONLogs{Log: []byte("A log line with utf8 : 🚀 ψ ω β")}: `^{\"log\":\"A log line with utf8 : 🚀 ψ ω β\",\"time\":}$`, + &JSONLogs{Stream: "stdout"}: `^{\"stream\":\"stdout\",\"time\":}$`, + &JSONLogs{Stream: "stdout", Log: []byte("A log line")}: `^{\"log\":\"A log line\",\"stream\":\"stdout\",\"time\":}$`, + &JSONLogs{Created: "time"}: `^{\"time\":time}$`, + &JSONLogs{}: `^{\"time\":}$`, + // These ones are a little weird + &JSONLogs{Log: []byte("\u2028 \u2029")}: `^{\"log\":\"\\u2028 \\u2029\",\"time\":}$`, + &JSONLogs{Log: []byte{0xaF}}: `^{\"log\":\"\\ufffd\",\"time\":}$`, + &JSONLogs{Log: []byte{0x7F}}: `^{\"log\":\"\x7f\",\"time\":}$`, + // with raw attributes + &JSONLogs{Log: []byte("A log line"), RawAttrs: []byte(`{"hello":"world","value":1234}`)}: `^{\"log\":\"A log line\",\"attrs\":{\"hello\":\"world\",\"value\":1234},\"time\":}$`, + } + for jsonLog, expression := range logs { + var buf bytes.Buffer + if err := jsonLog.MarshalJSONBuf(&buf); err != nil { + t.Fatal(err) + } + res := buf.String() + t.Logf("Result of WriteLog: %q", res) + logRe := regexp.MustCompile(expression) + if !logRe.MatchString(res) { + t.Fatalf("Log line not in expected format [%v]: %q", expression, res) + } + } +} diff --git a/pkg/jsonmessage/jsonmessage.go b/pkg/jsonmessage/jsonmessage.go new file mode 100644 index 0000000000..451c6a9fd2 --- /dev/null +++ b/pkg/jsonmessage/jsonmessage.go @@ -0,0 +1,196 @@ +package jsonmessage + +import ( + "encoding/json" + "fmt" + "io" + "strings" + "time" + + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/pkg/timeutils" + "github.com/docker/docker/pkg/units" +) + +// JSONError wraps a concrete Code and Message, `Code` is +// is a integer error code, `Message` is the error message. +type JSONError struct { + Code int `json:"code,omitempty"` + Message string `json:"message,omitempty"` +} + +func (e *JSONError) Error() string { + return e.Message +} + +// JSONProgress describes a Progress. terminalFd is the fd of the current terminal, +// Start is the initial value for the operation. Current is the current status and +// value of the progress made towards Total. Total is the end value describing when +// we made 100% progress for an operation. +type JSONProgress struct { + terminalFd uintptr + Current int64 `json:"current,omitempty"` + Total int64 `json:"total,omitempty"` + Start int64 `json:"start,omitempty"` +} + +func (p *JSONProgress) String() string { + var ( + width = 200 + pbBox string + numbersBox string + timeLeftBox string + ) + + ws, err := term.GetWinsize(p.terminalFd) + if err == nil { + width = int(ws.Width) + } + + if p.Current <= 0 && p.Total <= 0 { + return "" + } + current := units.HumanSize(float64(p.Current)) + if p.Total <= 0 { + return fmt.Sprintf("%8v", current) + } + total := units.HumanSize(float64(p.Total)) + percentage := int(float64(p.Current)/float64(p.Total)*100) / 2 + if percentage > 50 { + percentage = 50 + } + if width > 110 { + // this number can't be negetive gh#7136 + numSpaces := 0 + if 50-percentage > 0 { + numSpaces = 50 - percentage + } + pbBox = fmt.Sprintf("[%s>%s] ", strings.Repeat("=", percentage), strings.Repeat(" ", numSpaces)) + } + + numbersBox = fmt.Sprintf("%8v/%v", current, total) + + if p.Current > p.Total { + // remove total display if the reported current is wonky. + numbersBox = fmt.Sprintf("%8v", current) + } + + if p.Current > 0 && p.Start > 0 && percentage < 50 { + fromStart := time.Now().UTC().Sub(time.Unix(p.Start, 0)) + perEntry := fromStart / time.Duration(p.Current) + left := time.Duration(p.Total-p.Current) * perEntry + left = (left / time.Second) * time.Second + + if width > 50 { + timeLeftBox = " " + left.String() + } + } + return pbBox + numbersBox + timeLeftBox +} + +// JSONMessage defines a message struct. It describes +// the created time, where it from, status, ID of the +// message. It's used for docker events. +type JSONMessage struct { + Stream string `json:"stream,omitempty"` + Status string `json:"status,omitempty"` + Progress *JSONProgress `json:"progressDetail,omitempty"` + ProgressMessage string `json:"progress,omitempty"` //deprecated + ID string `json:"id,omitempty"` + From string `json:"from,omitempty"` + Time int64 `json:"time,omitempty"` + TimeNano int64 `json:"timeNano,omitempty"` + Error *JSONError `json:"errorDetail,omitempty"` + ErrorMessage string `json:"error,omitempty"` //deprecated +} + +// Display displays the JSONMessage to `out`. `isTerminal` describes if `out` +// is a terminal. If this is the case, it will erase the entire current line +// when dislaying the progressbar. +func (jm *JSONMessage) Display(out io.Writer, isTerminal bool) error { + if jm.Error != nil { + if jm.Error.Code == 401 { + return fmt.Errorf("Authentication is required.") + } + return jm.Error + } + var endl string + if isTerminal && jm.Stream == "" && jm.Progress != nil { + // [2K = erase entire current line + fmt.Fprintf(out, "%c[2K\r", 27) + endl = "\r" + } else if jm.Progress != nil && jm.Progress.String() != "" { //disable progressbar in non-terminal + return nil + } + if jm.TimeNano != 0 { + fmt.Fprintf(out, "%s ", time.Unix(0, jm.TimeNano).Format(timeutils.RFC3339NanoFixed)) + } else if jm.Time != 0 { + fmt.Fprintf(out, "%s ", time.Unix(jm.Time, 0).Format(timeutils.RFC3339NanoFixed)) + } + if jm.ID != "" { + fmt.Fprintf(out, "%s: ", jm.ID) + } + if jm.From != "" { + fmt.Fprintf(out, "(from %s) ", jm.From) + } + if jm.Progress != nil && isTerminal { + fmt.Fprintf(out, "%s %s%s", jm.Status, jm.Progress.String(), endl) + } else if jm.ProgressMessage != "" { //deprecated + fmt.Fprintf(out, "%s %s%s", jm.Status, jm.ProgressMessage, endl) + } else if jm.Stream != "" { + fmt.Fprintf(out, "%s%s", jm.Stream, endl) + } else { + fmt.Fprintf(out, "%s%s\n", jm.Status, endl) + } + return nil +} + +// DisplayJSONMessagesStream displays a json message stream from `in` to `out`, `isTerminal` +// describes if `out` is a terminal. If this is the case, it will print `\n` at the end of +// each line and move the cursor while displaying. +func DisplayJSONMessagesStream(in io.Reader, out io.Writer, terminalFd uintptr, isTerminal bool) error { + var ( + dec = json.NewDecoder(in) + ids = make(map[string]int) + diff = 0 + ) + for { + var jm JSONMessage + if err := dec.Decode(&jm); err != nil { + if err == io.EOF { + break + } + return err + } + + if jm.Progress != nil { + jm.Progress.terminalFd = terminalFd + } + if jm.ID != "" && (jm.Progress != nil || jm.ProgressMessage != "") { + line, ok := ids[jm.ID] + if !ok { + line = len(ids) + ids[jm.ID] = line + if isTerminal { + fmt.Fprintf(out, "\n") + } + diff = 0 + } else { + diff = len(ids) - line + } + if jm.ID != "" && isTerminal { + // [{diff}A = move cursor up diff rows + fmt.Fprintf(out, "%c[%dA", 27, diff) + } + } + err := jm.Display(out, isTerminal) + if jm.ID != "" && isTerminal { + // [{diff}B = move cursor down diff rows + fmt.Fprintf(out, "%c[%dB", 27, diff) + } + if err != nil { + return err + } + } + return nil +} diff --git a/pkg/jsonmessage/jsonmessage_test.go b/pkg/jsonmessage/jsonmessage_test.go new file mode 100644 index 0000000000..7f46a8f63e --- /dev/null +++ b/pkg/jsonmessage/jsonmessage_test.go @@ -0,0 +1,231 @@ +package jsonmessage + +import ( + "bytes" + "fmt" + "strings" + "testing" + "time" + + "github.com/docker/docker/pkg/term" + "github.com/docker/docker/pkg/timeutils" +) + +func TestError(t *testing.T) { + je := JSONError{404, "Not found"} + if je.Error() != "Not found" { + t.Fatalf("Expected 'Not found' got '%s'", je.Error()) + } +} + +func TestProgress(t *testing.T) { + jp := JSONProgress{} + if jp.String() != "" { + t.Fatalf("Expected empty string, got '%s'", jp.String()) + } + + expected := " 1 B" + jp2 := JSONProgress{Current: 1} + if jp2.String() != expected { + t.Fatalf("Expected %q, got %q", expected, jp2.String()) + } + + expectedStart := "[==========> ] 20 B/100 B" + jp3 := JSONProgress{Current: 20, Total: 100, Start: time.Now().Unix()} + // Just look at the start of the string + // (the remaining time is really hard to test -_-) + if jp3.String()[:len(expectedStart)] != expectedStart { + t.Fatalf("Expected to start with %q, got %q", expectedStart, jp3.String()) + } + + expected = "[=========================> ] 50 B/100 B" + jp4 := JSONProgress{Current: 50, Total: 100} + if jp4.String() != expected { + t.Fatalf("Expected %q, got %q", expected, jp4.String()) + } + + // this number can't be negative gh#7136 + expected = "[==================================================>] 50 B" + jp5 := JSONProgress{Current: 50, Total: 40} + if jp5.String() != expected { + t.Fatalf("Expected %q, got %q", expected, jp5.String()) + } +} + +func TestJSONMessageDisplay(t *testing.T) { + now := time.Now() + messages := map[JSONMessage][]string{ + // Empty + JSONMessage{}: {"\n", "\n"}, + // Status + JSONMessage{ + Status: "status", + }: { + "status\n", + "status\n", + }, + // General + JSONMessage{ + Time: now.Unix(), + ID: "ID", + From: "From", + Status: "status", + }: { + fmt.Sprintf("%v ID: (from From) status\n", time.Unix(now.Unix(), 0).Format(timeutils.RFC3339NanoFixed)), + fmt.Sprintf("%v ID: (from From) status\n", time.Unix(now.Unix(), 0).Format(timeutils.RFC3339NanoFixed)), + }, + // General, with nano precision time + JSONMessage{ + TimeNano: now.UnixNano(), + ID: "ID", + From: "From", + Status: "status", + }: { + fmt.Sprintf("%v ID: (from From) status\n", time.Unix(0, now.UnixNano()).Format(timeutils.RFC3339NanoFixed)), + fmt.Sprintf("%v ID: (from From) status\n", time.Unix(0, now.UnixNano()).Format(timeutils.RFC3339NanoFixed)), + }, + // General, with both times Nano is preferred + JSONMessage{ + Time: now.Unix(), + TimeNano: now.UnixNano(), + ID: "ID", + From: "From", + Status: "status", + }: { + fmt.Sprintf("%v ID: (from From) status\n", time.Unix(0, now.UnixNano()).Format(timeutils.RFC3339NanoFixed)), + fmt.Sprintf("%v ID: (from From) status\n", time.Unix(0, now.UnixNano()).Format(timeutils.RFC3339NanoFixed)), + }, + // Stream over status + JSONMessage{ + Status: "status", + Stream: "stream", + }: { + "stream", + "stream", + }, + // With progress message + JSONMessage{ + Status: "status", + ProgressMessage: "progressMessage", + }: { + "status progressMessage", + "status progressMessage", + }, + // With progress, stream empty + JSONMessage{ + Status: "status", + Stream: "", + Progress: &JSONProgress{Current: 1}, + }: { + "", + fmt.Sprintf("%c[2K\rstatus 1 B\r", 27), + }, + } + + // The tests :) + for jsonMessage, expectedMessages := range messages { + // Without terminal + data := bytes.NewBuffer([]byte{}) + if err := jsonMessage.Display(data, false); err != nil { + t.Fatal(err) + } + if data.String() != expectedMessages[0] { + t.Fatalf("Expected [%v], got [%v]", expectedMessages[0], data.String()) + } + // With terminal + data = bytes.NewBuffer([]byte{}) + if err := jsonMessage.Display(data, true); err != nil { + t.Fatal(err) + } + if data.String() != expectedMessages[1] { + t.Fatalf("Expected [%v], got [%v]", expectedMessages[1], data.String()) + } + } +} + +// Test JSONMessage with an Error. It will return an error with the text as error, not the meaning of the HTTP code. +func TestJSONMessageDisplayWithJSONError(t *testing.T) { + data := bytes.NewBuffer([]byte{}) + jsonMessage := JSONMessage{Error: &JSONError{404, "Can't find it"}} + + err := jsonMessage.Display(data, true) + if err == nil || err.Error() != "Can't find it" { + t.Fatalf("Expected a JSONError 404, got [%v]", err) + } + + jsonMessage = JSONMessage{Error: &JSONError{401, "Anything"}} + err = jsonMessage.Display(data, true) + if err == nil || err.Error() != "Authentication is required." { + t.Fatalf("Expected an error [Authentication is required.], got [%v]", err) + } +} + +func TestDisplayJSONMessagesStreamInvalidJSON(t *testing.T) { + var ( + inFd uintptr + ) + data := bytes.NewBuffer([]byte{}) + reader := strings.NewReader("This is not a 'valid' JSON []") + inFd, _ = term.GetFdInfo(reader) + + if err := DisplayJSONMessagesStream(reader, data, inFd, false); err == nil && err.Error()[:17] != "invalid character" { + t.Fatalf("Should have thrown an error (invalid character in ..), got [%v]", err) + } +} + +func TestDisplayJSONMessagesStream(t *testing.T) { + var ( + inFd uintptr + ) + + messages := map[string][]string{ + // empty string + "": { + "", + ""}, + // Without progress & ID + "{ \"status\": \"status\" }": { + "status\n", + "status\n", + }, + // Without progress, with ID + "{ \"id\": \"ID\",\"status\": \"status\" }": { + "ID: status\n", + fmt.Sprintf("ID: status\n%c[%dB", 27, 0), + }, + // With progress + "{ \"id\": \"ID\", \"status\": \"status\", \"progress\": \"ProgressMessage\" }": { + "ID: status ProgressMessage", + fmt.Sprintf("\n%c[%dAID: status ProgressMessage%c[%dB", 27, 0, 27, 0), + }, + // With progressDetail + "{ \"id\": \"ID\", \"status\": \"status\", \"progressDetail\": { \"Current\": 1} }": { + "", // progressbar is disabled in non-terminal + fmt.Sprintf("\n%c[%dA%c[2K\rID: status 1 B\r%c[%dB", 27, 0, 27, 27, 0), + }, + } + for jsonMessage, expectedMessages := range messages { + data := bytes.NewBuffer([]byte{}) + reader := strings.NewReader(jsonMessage) + inFd, _ = term.GetFdInfo(reader) + + // Without terminal + if err := DisplayJSONMessagesStream(reader, data, inFd, false); err != nil { + t.Fatal(err) + } + if data.String() != expectedMessages[0] { + t.Fatalf("Expected an [%v], got [%v]", expectedMessages[0], data.String()) + } + + // With terminal + data = bytes.NewBuffer([]byte{}) + reader = strings.NewReader(jsonMessage) + if err := DisplayJSONMessagesStream(reader, data, inFd, true); err != nil { + t.Fatal(err) + } + if data.String() != expectedMessages[1] { + t.Fatalf("Expected an [%v], got [%v]", expectedMessages[1], data.String()) + } + } + +} diff --git a/pkg/listenbuffer/README.md b/pkg/listenbuffer/README.md new file mode 100644 index 0000000000..2273509817 --- /dev/null +++ b/pkg/listenbuffer/README.md @@ -0,0 +1,27 @@ +# listenbuffer + +listenbuffer uses the kernel's listening backlog functionality to queue +connections, allowing applications to start listening immediately and handle +connections later. This is signaled by closing the activation channel passed to +the constructor. + +The maximum amount of queued connections depends on the configuration of your +kernel (typically called SOMAXXCON) and cannot be configured in Go with the +net package. See `src/net/sock_platform.go` in the Go tree or consult your +kernel's manual. + + activator := make(chan struct{}) + buffer, err := NewListenBuffer("tcp", "localhost:4000", activator) + if err != nil { + panic(err) + } + + // will block until activator has been closed or is sent an event + client, err := buffer.Accept() + +Somewhere else in your application once it's been booted: + + close(activator) + +`buffer.Accept()` will return the first client in the kernel listening queue, or +continue to block until a client connects or an error occurs. diff --git a/pkg/listenbuffer/buffer.go b/pkg/listenbuffer/buffer.go new file mode 100644 index 0000000000..aa47471c40 --- /dev/null +++ b/pkg/listenbuffer/buffer.go @@ -0,0 +1,76 @@ +/* +Package listenbuffer uses the kernel's listening backlog functionality to queue +connections, allowing applications to start listening immediately and handle +connections later. This is signaled by closing the activation channel passed to +the constructor. + +The maximum amount of queued connections depends on the configuration of your +kernel (typically called SOMAXXCON) and cannot be configured in Go with the +net package. See `src/net/sock_platform.go` in the Go tree or consult your +kernel's manual. + + activator := make(chan struct{}) + buffer, err := NewListenBuffer("tcp", "localhost:4000", activator) + if err != nil { + panic(err) + } + + // will block until activator has been closed or is sent an event + client, err := buffer.Accept() + +Somewhere else in your application once it's been booted: + + close(activator) + +`buffer.Accept()` will return the first client in the kernel listening queue, or +continue to block until a client connects or an error occurs. +*/ +package listenbuffer + +import "net" + +// NewListenBuffer returns a net.Listener listening on addr with the protocol +// passed. The channel passed is used to activate the listenbuffer when the +// caller is ready to accept connections. +func NewListenBuffer(proto, addr string, activate <-chan struct{}) (net.Listener, error) { + wrapped, err := net.Listen(proto, addr) + if err != nil { + return nil, err + } + + return &defaultListener{ + wrapped: wrapped, + activate: activate, + }, nil +} + +// defaultListener is the buffered wrapper around the net.Listener +type defaultListener struct { + wrapped net.Listener // The net.Listener wrapped by listenbuffer + ready bool // Whether the listenbuffer has been activated + activate <-chan struct{} // Channel to control activation of the listenbuffer +} + +// Close closes the wrapped socket. +func (l *defaultListener) Close() error { + return l.wrapped.Close() +} + +// Addr returns the listening address of the wrapped socket. +func (l *defaultListener) Addr() net.Addr { + return l.wrapped.Addr() +} + +// Accept returns a client connection on the wrapped socket if the listen buffer +// has been activated. To active the listenbuffer the activation channel passed +// to NewListenBuffer must have been closed or sent an event. +func (l *defaultListener) Accept() (net.Conn, error) { + // if the listen has been told it is ready then we can go ahead and + // start returning connections + if l.ready { + return l.wrapped.Accept() + } + <-l.activate + l.ready = true + return l.Accept() +} diff --git a/pkg/listenbuffer/listen_buffer_test.go b/pkg/listenbuffer/listen_buffer_test.go new file mode 100644 index 0000000000..6ffd2f7984 --- /dev/null +++ b/pkg/listenbuffer/listen_buffer_test.go @@ -0,0 +1,41 @@ +package listenbuffer + +import ( + "io/ioutil" + "net" + "testing" +) + +func TestListenBufferAllowsAcceptingWhenActivated(t *testing.T) { + lock := make(chan struct{}) + buffer, err := NewListenBuffer("tcp", "", lock) + if err != nil { + t.Fatal("Unable to create listen buffer: ", err) + } + + go func() { + conn, err := net.Dial("tcp", buffer.Addr().String()) + if err != nil { + t.Fatal("Client failed to establish connection to server: ", err) + } + + conn.Write([]byte("ping")) + conn.Close() + }() + + close(lock) + + client, err := buffer.Accept() + if err != nil { + t.Fatal("Failed to accept client: ", err) + } + + response, err := ioutil.ReadAll(client) + if err != nil { + t.Fatal("Failed to read from client: ", err) + } + + if string(response) != "ping" { + t.Fatal("Expected to receive ping from client, received: ", string(response)) + } +} diff --git a/pkg/longpath/longpath.go b/pkg/longpath/longpath.go new file mode 100644 index 0000000000..9b15bfff4c --- /dev/null +++ b/pkg/longpath/longpath.go @@ -0,0 +1,26 @@ +// longpath introduces some constants and helper functions for handling long paths +// in Windows, which are expected to be prepended with `\\?\` and followed by either +// a drive letter, a UNC server\share, or a volume identifier. + +package longpath + +import ( + "strings" +) + +// Prefix is the longpath prefix for Windows file paths. +const Prefix = `\\?\` + +// AddPrefix will add the Windows long path prefix to the path provided if +// it does not already have it. +func AddPrefix(path string) string { + if !strings.HasPrefix(path, Prefix) { + if strings.HasPrefix(path, `\\`) { + // This is a UNC path, so we need to add 'UNC' to the path as well. + path = Prefix + `UNC` + path[1:] + } else { + path = Prefix + path + } + } + return path +} diff --git a/pkg/longpath/longpath_test.go b/pkg/longpath/longpath_test.go new file mode 100644 index 0000000000..01865eff09 --- /dev/null +++ b/pkg/longpath/longpath_test.go @@ -0,0 +1,22 @@ +package longpath + +import ( + "strings" + "testing" +) + +func TestStandardLongPath(t *testing.T) { + c := `C:\simple\path` + longC := AddPrefix(c) + if !strings.EqualFold(longC, `\\?\C:\simple\path`) { + t.Errorf("Wrong long path returned. Original = %s ; Long = %s", c, longC) + } +} + +func TestUNCLongPath(t *testing.T) { + c := `\\server\share\path` + longC := AddPrefix(c) + if !strings.EqualFold(longC, `\\?\UNC\server\share\path`) { + t.Errorf("Wrong UNC long path returned. Original = %s ; Long = %s", c, longC) + } +} diff --git a/pkg/mflag/LICENSE b/pkg/mflag/LICENSE new file mode 100644 index 0000000000..ac74d8f049 --- /dev/null +++ b/pkg/mflag/LICENSE @@ -0,0 +1,27 @@ +Copyright (c) 2014-2015 The Docker & Go Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/pkg/mflag/README.md b/pkg/mflag/README.md new file mode 100644 index 0000000000..da00efa336 --- /dev/null +++ b/pkg/mflag/README.md @@ -0,0 +1,40 @@ +Package mflag (aka multiple-flag) implements command-line flag parsing. +It's an **hacky** fork of the [official golang package](http://golang.org/pkg/flag/) + +It adds: + +* both short and long flag version +`./example -s red` `./example --string blue` + +* multiple names for the same option +``` +$>./example -h +Usage of example: + -s, --string="": a simple string +``` + +___ +It is very flexible on purpose, so you can do things like: +``` +$>./example -h +Usage of example: + -s, -string, --string="": a simple string +``` + +Or: +``` +$>./example -h +Usage of example: + -oldflag, --newflag="": a simple string +``` + +You can also hide some flags from the usage, so if we want only `--newflag`: +``` +$>./example -h +Usage of example: + --newflag="": a simple string +$>./example -oldflag str +str +``` + +See [example.go](example/example.go) for more details. diff --git a/pkg/mflag/example/example.go b/pkg/mflag/example/example.go new file mode 100644 index 0000000000..2e766dd1e5 --- /dev/null +++ b/pkg/mflag/example/example.go @@ -0,0 +1,36 @@ +package main + +import ( + "fmt" + + flag "github.com/docker/docker/pkg/mflag" +) + +var ( + i int + str string + b, b2, h bool +) + +func init() { + flag.Bool([]string{"#hp", "#-halp"}, false, "display the halp") + flag.BoolVar(&b, []string{"b", "#bal", "#bol", "-bal"}, false, "a simple bool") + flag.BoolVar(&b, []string{"g", "#gil"}, false, "a simple bool") + flag.BoolVar(&b2, []string{"#-bool"}, false, "a simple bool") + flag.IntVar(&i, []string{"-integer", "-number"}, -1, "a simple integer") + flag.StringVar(&str, []string{"s", "#hidden", "-string"}, "", "a simple string") //-s -hidden and --string will work, but -hidden won't be in the usage + flag.BoolVar(&h, []string{"h", "#help", "-help"}, false, "display the help") + flag.StringVar(&str, []string{"mode"}, "mode1", "set the mode\nmode1: use the mode1\nmode2: use the mode2\nmode3: use the mode3") + flag.Parse() +} +func main() { + if h { + flag.PrintDefaults() + } else { + fmt.Printf("s/#hidden/-string: %s\n", str) + fmt.Printf("b: %t\n", b) + fmt.Printf("-bool: %t\n", b2) + fmt.Printf("s/#hidden/-string(via lookup): %s\n", flag.Lookup("s").Value.String()) + fmt.Printf("ARGS: %v\n", flag.Args()) + } +} diff --git a/pkg/mflag/flag.go b/pkg/mflag/flag.go new file mode 100644 index 0000000000..afab4c9c60 --- /dev/null +++ b/pkg/mflag/flag.go @@ -0,0 +1,1245 @@ +// Copyright 2014-2015 The Docker & Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Package mflag implements command-line flag parsing. +// +// Usage: +// +// Define flags using flag.String(), Bool(), Int(), etc. +// +// This declares an integer flag, -f or --flagname, stored in the pointer ip, with type *int. +// import "flag /github.com/docker/docker/pkg/mflag" +// var ip = flag.Int([]string{"f", "-flagname"}, 1234, "help message for flagname") +// If you like, you can bind the flag to a variable using the Var() functions. +// var flagvar int +// func init() { +// // -flaghidden will work, but will be hidden from the usage +// flag.IntVar(&flagvar, []string{"f", "#flaghidden", "-flagname"}, 1234, "help message for flagname") +// } +// Or you can create custom flags that satisfy the Value interface (with +// pointer receivers) and couple them to flag parsing by +// flag.Var(&flagVal, []string{"name"}, "help message for flagname") +// For such flags, the default value is just the initial value of the variable. +// +// You can also add "deprecated" flags, they are still usable, but are not shown +// in the usage and will display a warning when you try to use them. `#` before +// an option means this option is deprecated, if there is an following option +// without `#` ahead, then that's the replacement, if not, it will just be removed: +// var ip = flag.Int([]string{"#f", "#flagname", "-flagname"}, 1234, "help message for flagname") +// this will display: `Warning: '-f' is deprecated, it will be replaced by '--flagname' soon. See usage.` or +// this will display: `Warning: '-flagname' is deprecated, it will be replaced by '--flagname' soon. See usage.` +// var ip = flag.Int([]string{"f", "#flagname"}, 1234, "help message for flagname") +// will display: `Warning: '-flagname' is deprecated, it will be removed soon. See usage.` +// so you can only use `-f`. +// +// You can also group one letter flags, bif you declare +// var v = flag.Bool([]string{"v", "-verbose"}, false, "help message for verbose") +// var s = flag.Bool([]string{"s", "-slow"}, false, "help message for slow") +// you will be able to use the -vs or -sv +// +// After all flags are defined, call +// flag.Parse() +// to parse the command line into the defined flags. +// +// Flags may then be used directly. If you're using the flags themselves, +// they are all pointers; if you bind to variables, they're values. +// fmt.Println("ip has value ", *ip) +// fmt.Println("flagvar has value ", flagvar) +// +// After parsing, the arguments after the flag are available as the +// slice flag.Args() or individually as flag.Arg(i). +// The arguments are indexed from 0 through flag.NArg()-1. +// +// Command line flag syntax: +// -flag +// -flag=x +// -flag="x" +// -flag='x' +// -flag x // non-boolean flags only +// One or two minus signs may be used; they are equivalent. +// The last form is not permitted for boolean flags because the +// meaning of the command +// cmd -x * +// will change if there is a file called 0, false, etc. You must +// use the -flag=false form to turn off a boolean flag. +// +// Flag parsing stops just before the first non-flag argument +// ("-" is a non-flag argument) or after the terminator "--". +// +// Integer flags accept 1234, 0664, 0x1234 and may be negative. +// Boolean flags may be 1, 0, t, f, true, false, TRUE, FALSE, True, False. +// Duration flags accept any input valid for time.ParseDuration. +// +// The default set of command-line flags is controlled by +// top-level functions. The FlagSet type allows one to define +// independent sets of flags, such as to implement subcommands +// in a command-line interface. The methods of FlagSet are +// analogous to the top-level functions for the command-line +// flag set. + +package mflag + +import ( + "errors" + "fmt" + "io" + "os" + "runtime" + "sort" + "strconv" + "strings" + "text/tabwriter" + "time" + + "github.com/docker/docker/pkg/homedir" +) + +// ErrHelp is the error returned if the flag -help is invoked but no such flag is defined. +var ErrHelp = errors.New("flag: help requested") + +// ErrRetry is the error returned if you need to try letter by letter +var ErrRetry = errors.New("flag: retry") + +// -- bool Value +type boolValue bool + +func newBoolValue(val bool, p *bool) *boolValue { + *p = val + return (*boolValue)(p) +} + +func (b *boolValue) Set(s string) error { + v, err := strconv.ParseBool(s) + *b = boolValue(v) + return err +} + +func (b *boolValue) Get() interface{} { return bool(*b) } + +func (b *boolValue) String() string { return fmt.Sprintf("%v", *b) } + +func (b *boolValue) IsBoolFlag() bool { return true } + +// optional interface to indicate boolean flags that can be +// supplied without "=value" text +type boolFlag interface { + Value + IsBoolFlag() bool +} + +// -- int Value +type intValue int + +func newIntValue(val int, p *int) *intValue { + *p = val + return (*intValue)(p) +} + +func (i *intValue) Set(s string) error { + v, err := strconv.ParseInt(s, 0, 64) + *i = intValue(v) + return err +} + +func (i *intValue) Get() interface{} { return int(*i) } + +func (i *intValue) String() string { return fmt.Sprintf("%v", *i) } + +// -- int64 Value +type int64Value int64 + +func newInt64Value(val int64, p *int64) *int64Value { + *p = val + return (*int64Value)(p) +} + +func (i *int64Value) Set(s string) error { + v, err := strconv.ParseInt(s, 0, 64) + *i = int64Value(v) + return err +} + +func (i *int64Value) Get() interface{} { return int64(*i) } + +func (i *int64Value) String() string { return fmt.Sprintf("%v", *i) } + +// -- uint Value +type uintValue uint + +func newUintValue(val uint, p *uint) *uintValue { + *p = val + return (*uintValue)(p) +} + +func (i *uintValue) Set(s string) error { + v, err := strconv.ParseUint(s, 0, 64) + *i = uintValue(v) + return err +} + +func (i *uintValue) Get() interface{} { return uint(*i) } + +func (i *uintValue) String() string { return fmt.Sprintf("%v", *i) } + +// -- uint64 Value +type uint64Value uint64 + +func newUint64Value(val uint64, p *uint64) *uint64Value { + *p = val + return (*uint64Value)(p) +} + +func (i *uint64Value) Set(s string) error { + v, err := strconv.ParseUint(s, 0, 64) + *i = uint64Value(v) + return err +} + +func (i *uint64Value) Get() interface{} { return uint64(*i) } + +func (i *uint64Value) String() string { return fmt.Sprintf("%v", *i) } + +// -- uint16 Value +type uint16Value uint16 + +func newUint16Value(val uint16, p *uint16) *uint16Value { + *p = val + return (*uint16Value)(p) +} + +func (i *uint16Value) Set(s string) error { + v, err := strconv.ParseUint(s, 0, 16) + *i = uint16Value(v) + return err +} + +func (i *uint16Value) Get() interface{} { return uint16(*i) } + +func (i *uint16Value) String() string { return fmt.Sprintf("%v", *i) } + +// -- string Value +type stringValue string + +func newStringValue(val string, p *string) *stringValue { + *p = val + return (*stringValue)(p) +} + +func (s *stringValue) Set(val string) error { + *s = stringValue(val) + return nil +} + +func (s *stringValue) Get() interface{} { return string(*s) } + +func (s *stringValue) String() string { return fmt.Sprintf("%s", *s) } + +// -- float64 Value +type float64Value float64 + +func newFloat64Value(val float64, p *float64) *float64Value { + *p = val + return (*float64Value)(p) +} + +func (f *float64Value) Set(s string) error { + v, err := strconv.ParseFloat(s, 64) + *f = float64Value(v) + return err +} + +func (f *float64Value) Get() interface{} { return float64(*f) } + +func (f *float64Value) String() string { return fmt.Sprintf("%v", *f) } + +// -- time.Duration Value +type durationValue time.Duration + +func newDurationValue(val time.Duration, p *time.Duration) *durationValue { + *p = val + return (*durationValue)(p) +} + +func (d *durationValue) Set(s string) error { + v, err := time.ParseDuration(s) + *d = durationValue(v) + return err +} + +func (d *durationValue) Get() interface{} { return time.Duration(*d) } + +func (d *durationValue) String() string { return (*time.Duration)(d).String() } + +// Value is the interface to the dynamic value stored in a flag. +// (The default value is represented as a string.) +// +// If a Value has an IsBoolFlag() bool method returning true, +// the command-line parser makes -name equivalent to -name=true +// rather than using the next command-line argument. +type Value interface { + String() string + Set(string) error +} + +// Getter is an interface that allows the contents of a Value to be retrieved. +// It wraps the Value interface, rather than being part of it, because it +// appeared after Go 1 and its compatibility rules. All Value types provided +// by this package satisfy the Getter interface. +type Getter interface { + Value + Get() interface{} +} + +// ErrorHandling defines how to handle flag parsing errors. +type ErrorHandling int + +// ErrorHandling strategies available when a flag parsing error occurs +const ( + ContinueOnError ErrorHandling = iota + ExitOnError + PanicOnError +) + +// A FlagSet represents a set of defined flags. The zero value of a FlagSet +// has no name and has ContinueOnError error handling. +type FlagSet struct { + // Usage is the function called when an error occurs while parsing flags. + // The field is a function (not a method) that may be changed to point to + // a custom error handler. + Usage func() + ShortUsage func() + + name string + parsed bool + actual map[string]*Flag + formal map[string]*Flag + args []string // arguments after flags + errorHandling ErrorHandling + output io.Writer // nil means stderr; use Out() accessor + nArgRequirements []nArgRequirement +} + +// A Flag represents the state of a flag. +type Flag struct { + Names []string // name as it appears on command line + Usage string // help message + Value Value // value as set + DefValue string // default value (as text); for usage message +} + +type flagSlice []string + +func (p flagSlice) Len() int { return len(p) } +func (p flagSlice) Less(i, j int) bool { + pi, pj := strings.TrimPrefix(p[i], "-"), strings.TrimPrefix(p[j], "-") + lpi, lpj := strings.ToLower(pi), strings.ToLower(pj) + if lpi != lpj { + return lpi < lpj + } + return pi < pj +} +func (p flagSlice) Swap(i, j int) { p[i], p[j] = p[j], p[i] } + +// sortFlags returns the flags as a slice in lexicographical sorted order. +func sortFlags(flags map[string]*Flag) []*Flag { + var list flagSlice + + // The sorted list is based on the first name, when flag map might use the other names. + nameMap := make(map[string]string) + + for n, f := range flags { + fName := strings.TrimPrefix(f.Names[0], "#") + nameMap[fName] = n + if len(f.Names) == 1 { + list = append(list, fName) + continue + } + + found := false + for _, name := range list { + if name == fName { + found = true + break + } + } + if !found { + list = append(list, fName) + } + } + sort.Sort(list) + result := make([]*Flag, len(list)) + for i, name := range list { + result[i] = flags[nameMap[name]] + } + return result +} + +// Name returns the name of the FlagSet. +func (fs *FlagSet) Name() string { + return fs.name +} + +// Out returns the destination for usage and error messages. +func (fs *FlagSet) Out() io.Writer { + if fs.output == nil { + return os.Stderr + } + return fs.output +} + +// SetOutput sets the destination for usage and error messages. +// If output is nil, os.Stderr is used. +func (fs *FlagSet) SetOutput(output io.Writer) { + fs.output = output +} + +// VisitAll visits the flags in lexicographical order, calling fn for each. +// It visits all flags, even those not set. +func (fs *FlagSet) VisitAll(fn func(*Flag)) { + for _, flag := range sortFlags(fs.formal) { + fn(flag) + } +} + +// VisitAll visits the command-line flags in lexicographical order, calling +// fn for each. It visits all flags, even those not set. +func VisitAll(fn func(*Flag)) { + CommandLine.VisitAll(fn) +} + +// Visit visits the flags in lexicographical order, calling fn for each. +// It visits only those flags that have been set. +func (fs *FlagSet) Visit(fn func(*Flag)) { + for _, flag := range sortFlags(fs.actual) { + fn(flag) + } +} + +// Visit visits the command-line flags in lexicographical order, calling fn +// for each. It visits only those flags that have been set. +func Visit(fn func(*Flag)) { + CommandLine.Visit(fn) +} + +// Lookup returns the Flag structure of the named flag, returning nil if none exists. +func (fs *FlagSet) Lookup(name string) *Flag { + return fs.formal[name] +} + +// IsSet indicates whether the specified flag is set in the given FlagSet +func (fs *FlagSet) IsSet(name string) bool { + return fs.actual[name] != nil +} + +// Lookup returns the Flag structure of the named command-line flag, +// returning nil if none exists. +func Lookup(name string) *Flag { + return CommandLine.formal[name] +} + +// IsSet indicates whether the specified flag was specified at all on the cmd line. +func IsSet(name string) bool { + return CommandLine.IsSet(name) +} + +type nArgRequirementType int + +// Indicator used to pass to BadArgs function +const ( + Exact nArgRequirementType = iota + Max + Min +) + +type nArgRequirement struct { + Type nArgRequirementType + N int +} + +// Require adds a requirement about the number of arguments for the FlagSet. +// The first parameter can be Exact, Max, or Min to respectively specify the exact, +// the maximum, or the minimal number of arguments required. +// The actual check is done in FlagSet.CheckArgs(). +func (fs *FlagSet) Require(nArgRequirementType nArgRequirementType, nArg int) { + fs.nArgRequirements = append(fs.nArgRequirements, nArgRequirement{nArgRequirementType, nArg}) +} + +// CheckArgs uses the requirements set by FlagSet.Require() to validate +// the number of arguments. If the requirements are not met, +// an error message string is returned. +func (fs *FlagSet) CheckArgs() (message string) { + for _, req := range fs.nArgRequirements { + var arguments string + if req.N == 1 { + arguments = "1 argument" + } else { + arguments = fmt.Sprintf("%d arguments", req.N) + } + + str := func(kind string) string { + return fmt.Sprintf("%q requires %s%s", fs.name, kind, arguments) + } + + switch req.Type { + case Exact: + if fs.NArg() != req.N { + return str("") + } + case Max: + if fs.NArg() > req.N { + return str("a maximum of ") + } + case Min: + if fs.NArg() < req.N { + return str("a minimum of ") + } + } + } + return "" +} + +// Set sets the value of the named flag. +func (fs *FlagSet) Set(name, value string) error { + flag, ok := fs.formal[name] + if !ok { + return fmt.Errorf("no such flag -%v", name) + } + if err := flag.Value.Set(value); err != nil { + return err + } + if fs.actual == nil { + fs.actual = make(map[string]*Flag) + } + fs.actual[name] = flag + return nil +} + +// Set sets the value of the named command-line flag. +func Set(name, value string) error { + return CommandLine.Set(name, value) +} + +// PrintDefaults prints, to standard error unless configured +// otherwise, the default values of all defined flags in the set. +func (fs *FlagSet) PrintDefaults() { + writer := tabwriter.NewWriter(fs.Out(), 20, 1, 3, ' ', 0) + home := homedir.Get() + + // Don't substitute when HOME is / + if runtime.GOOS != "windows" && home == "/" { + home = "" + } + + // Add a blank line between cmd description and list of options + if fs.FlagCount() > 0 { + fmt.Fprintln(writer, "") + } + + fs.VisitAll(func(flag *Flag) { + format := " -%s=%s" + names := []string{} + for _, name := range flag.Names { + if name[0] != '#' { + names = append(names, name) + } + } + if len(names) > 0 && len(flag.Usage) > 0 { + val := flag.DefValue + + if home != "" && strings.HasPrefix(val, home) { + val = homedir.GetShortcutString() + val[len(home):] + } + + fmt.Fprintf(writer, format, strings.Join(names, ", -"), val) + for i, line := range strings.Split(flag.Usage, "\n") { + if i != 0 { + line = " " + line + } + fmt.Fprintln(writer, "\t", line) + } + } + }) + writer.Flush() +} + +// PrintDefaults prints to standard error the default values of all defined command-line flags. +func PrintDefaults() { + CommandLine.PrintDefaults() +} + +// defaultUsage is the default function to print a usage message. +func defaultUsage(fs *FlagSet) { + if fs.name == "" { + fmt.Fprintf(fs.Out(), "Usage:\n") + } else { + fmt.Fprintf(fs.Out(), "Usage of %s:\n", fs.name) + } + fs.PrintDefaults() +} + +// NOTE: Usage is not just defaultUsage(CommandLine) +// because it serves (via godoc flag Usage) as the example +// for how to write your own usage function. + +// Usage prints to standard error a usage message documenting all defined command-line flags. +// The function is a variable that may be changed to point to a custom function. +var Usage = func() { + fmt.Fprintf(CommandLine.Out(), "Usage of %s:\n", os.Args[0]) + PrintDefaults() +} + +// Usage prints to standard error a usage message documenting the standard command layout +// The function is a variable that may be changed to point to a custom function. +var ShortUsage = func() { + fmt.Fprintf(CommandLine.output, "Usage of %s:\n", os.Args[0]) +} + +// FlagCount returns the number of flags that have been defined. +func (fs *FlagSet) FlagCount() int { return len(sortFlags(fs.formal)) } + +// FlagCountUndeprecated returns the number of undeprecated flags that have been defined. +func (fs *FlagSet) FlagCountUndeprecated() int { + count := 0 + for _, flag := range sortFlags(fs.formal) { + for _, name := range flag.Names { + if name[0] != '#' { + count++ + break + } + } + } + return count +} + +// NFlag returns the number of flags that have been set. +func (fs *FlagSet) NFlag() int { return len(fs.actual) } + +// NFlag returns the number of command-line flags that have been set. +func NFlag() int { return len(CommandLine.actual) } + +// Arg returns the i'th argument. Arg(0) is the first remaining argument +// after flags have been processed. +func (fs *FlagSet) Arg(i int) string { + if i < 0 || i >= len(fs.args) { + return "" + } + return fs.args[i] +} + +// Arg returns the i'th command-line argument. Arg(0) is the first remaining argument +// after flags have been processed. +func Arg(i int) string { + return CommandLine.Arg(i) +} + +// NArg is the number of arguments remaining after flags have been processed. +func (fs *FlagSet) NArg() int { return len(fs.args) } + +// NArg is the number of arguments remaining after flags have been processed. +func NArg() int { return len(CommandLine.args) } + +// Args returns the non-flag arguments. +func (fs *FlagSet) Args() []string { return fs.args } + +// Args returns the non-flag command-line arguments. +func Args() []string { return CommandLine.args } + +// BoolVar defines a bool flag with specified name, default value, and usage string. +// The argument p points to a bool variable in which to store the value of the flag. +func (fs *FlagSet) BoolVar(p *bool, names []string, value bool, usage string) { + fs.Var(newBoolValue(value, p), names, usage) +} + +// BoolVar defines a bool flag with specified name, default value, and usage string. +// The argument p points to a bool variable in which to store the value of the flag. +func BoolVar(p *bool, names []string, value bool, usage string) { + CommandLine.Var(newBoolValue(value, p), names, usage) +} + +// Bool defines a bool flag with specified name, default value, and usage string. +// The return value is the address of a bool variable that stores the value of the flag. +func (fs *FlagSet) Bool(names []string, value bool, usage string) *bool { + p := new(bool) + fs.BoolVar(p, names, value, usage) + return p +} + +// Bool defines a bool flag with specified name, default value, and usage string. +// The return value is the address of a bool variable that stores the value of the flag. +func Bool(names []string, value bool, usage string) *bool { + return CommandLine.Bool(names, value, usage) +} + +// IntVar defines an int flag with specified name, default value, and usage string. +// The argument p points to an int variable in which to store the value of the flag. +func (fs *FlagSet) IntVar(p *int, names []string, value int, usage string) { + fs.Var(newIntValue(value, p), names, usage) +} + +// IntVar defines an int flag with specified name, default value, and usage string. +// The argument p points to an int variable in which to store the value of the flag. +func IntVar(p *int, names []string, value int, usage string) { + CommandLine.Var(newIntValue(value, p), names, usage) +} + +// Int defines an int flag with specified name, default value, and usage string. +// The return value is the address of an int variable that stores the value of the flag. +func (fs *FlagSet) Int(names []string, value int, usage string) *int { + p := new(int) + fs.IntVar(p, names, value, usage) + return p +} + +// Int defines an int flag with specified name, default value, and usage string. +// The return value is the address of an int variable that stores the value of the flag. +func Int(names []string, value int, usage string) *int { + return CommandLine.Int(names, value, usage) +} + +// Int64Var defines an int64 flag with specified name, default value, and usage string. +// The argument p points to an int64 variable in which to store the value of the flag. +func (fs *FlagSet) Int64Var(p *int64, names []string, value int64, usage string) { + fs.Var(newInt64Value(value, p), names, usage) +} + +// Int64Var defines an int64 flag with specified name, default value, and usage string. +// The argument p points to an int64 variable in which to store the value of the flag. +func Int64Var(p *int64, names []string, value int64, usage string) { + CommandLine.Var(newInt64Value(value, p), names, usage) +} + +// Int64 defines an int64 flag with specified name, default value, and usage string. +// The return value is the address of an int64 variable that stores the value of the flag. +func (fs *FlagSet) Int64(names []string, value int64, usage string) *int64 { + p := new(int64) + fs.Int64Var(p, names, value, usage) + return p +} + +// Int64 defines an int64 flag with specified name, default value, and usage string. +// The return value is the address of an int64 variable that stores the value of the flag. +func Int64(names []string, value int64, usage string) *int64 { + return CommandLine.Int64(names, value, usage) +} + +// UintVar defines a uint flag with specified name, default value, and usage string. +// The argument p points to a uint variable in which to store the value of the flag. +func (fs *FlagSet) UintVar(p *uint, names []string, value uint, usage string) { + fs.Var(newUintValue(value, p), names, usage) +} + +// UintVar defines a uint flag with specified name, default value, and usage string. +// The argument p points to a uint variable in which to store the value of the flag. +func UintVar(p *uint, names []string, value uint, usage string) { + CommandLine.Var(newUintValue(value, p), names, usage) +} + +// Uint defines a uint flag with specified name, default value, and usage string. +// The return value is the address of a uint variable that stores the value of the flag. +func (fs *FlagSet) Uint(names []string, value uint, usage string) *uint { + p := new(uint) + fs.UintVar(p, names, value, usage) + return p +} + +// Uint defines a uint flag with specified name, default value, and usage string. +// The return value is the address of a uint variable that stores the value of the flag. +func Uint(names []string, value uint, usage string) *uint { + return CommandLine.Uint(names, value, usage) +} + +// Uint64Var defines a uint64 flag with specified name, default value, and usage string. +// The argument p points to a uint64 variable in which to store the value of the flag. +func (fs *FlagSet) Uint64Var(p *uint64, names []string, value uint64, usage string) { + fs.Var(newUint64Value(value, p), names, usage) +} + +// Uint64Var defines a uint64 flag with specified name, default value, and usage string. +// The argument p points to a uint64 variable in which to store the value of the flag. +func Uint64Var(p *uint64, names []string, value uint64, usage string) { + CommandLine.Var(newUint64Value(value, p), names, usage) +} + +// Uint64 defines a uint64 flag with specified name, default value, and usage string. +// The return value is the address of a uint64 variable that stores the value of the flag. +func (fs *FlagSet) Uint64(names []string, value uint64, usage string) *uint64 { + p := new(uint64) + fs.Uint64Var(p, names, value, usage) + return p +} + +// Uint64 defines a uint64 flag with specified name, default value, and usage string. +// The return value is the address of a uint64 variable that stores the value of the flag. +func Uint64(names []string, value uint64, usage string) *uint64 { + return CommandLine.Uint64(names, value, usage) +} + +// Uint16Var defines a uint16 flag with specified name, default value, and usage string. +// The argument p points to a uint16 variable in which to store the value of the flag. +func (fs *FlagSet) Uint16Var(p *uint16, names []string, value uint16, usage string) { + fs.Var(newUint16Value(value, p), names, usage) +} + +// Uint16Var defines a uint16 flag with specified name, default value, and usage string. +// The argument p points to a uint16 variable in which to store the value of the flag. +func Uint16Var(p *uint16, names []string, value uint16, usage string) { + CommandLine.Var(newUint16Value(value, p), names, usage) +} + +// Uint16 defines a uint16 flag with specified name, default value, and usage string. +// The return value is the address of a uint16 variable that stores the value of the flag. +func (fs *FlagSet) Uint16(names []string, value uint16, usage string) *uint16 { + p := new(uint16) + fs.Uint16Var(p, names, value, usage) + return p +} + +// Uint16 defines a uint16 flag with specified name, default value, and usage string. +// The return value is the address of a uint16 variable that stores the value of the flag. +func Uint16(names []string, value uint16, usage string) *uint16 { + return CommandLine.Uint16(names, value, usage) +} + +// StringVar defines a string flag with specified name, default value, and usage string. +// The argument p points to a string variable in which to store the value of the flag. +func (fs *FlagSet) StringVar(p *string, names []string, value string, usage string) { + fs.Var(newStringValue(value, p), names, usage) +} + +// StringVar defines a string flag with specified name, default value, and usage string. +// The argument p points to a string variable in which to store the value of the flag. +func StringVar(p *string, names []string, value string, usage string) { + CommandLine.Var(newStringValue(value, p), names, usage) +} + +// String defines a string flag with specified name, default value, and usage string. +// The return value is the address of a string variable that stores the value of the flag. +func (fs *FlagSet) String(names []string, value string, usage string) *string { + p := new(string) + fs.StringVar(p, names, value, usage) + return p +} + +// String defines a string flag with specified name, default value, and usage string. +// The return value is the address of a string variable that stores the value of the flag. +func String(names []string, value string, usage string) *string { + return CommandLine.String(names, value, usage) +} + +// Float64Var defines a float64 flag with specified name, default value, and usage string. +// The argument p points to a float64 variable in which to store the value of the flag. +func (fs *FlagSet) Float64Var(p *float64, names []string, value float64, usage string) { + fs.Var(newFloat64Value(value, p), names, usage) +} + +// Float64Var defines a float64 flag with specified name, default value, and usage string. +// The argument p points to a float64 variable in which to store the value of the flag. +func Float64Var(p *float64, names []string, value float64, usage string) { + CommandLine.Var(newFloat64Value(value, p), names, usage) +} + +// Float64 defines a float64 flag with specified name, default value, and usage string. +// The return value is the address of a float64 variable that stores the value of the flag. +func (fs *FlagSet) Float64(names []string, value float64, usage string) *float64 { + p := new(float64) + fs.Float64Var(p, names, value, usage) + return p +} + +// Float64 defines a float64 flag with specified name, default value, and usage string. +// The return value is the address of a float64 variable that stores the value of the flag. +func Float64(names []string, value float64, usage string) *float64 { + return CommandLine.Float64(names, value, usage) +} + +// DurationVar defines a time.Duration flag with specified name, default value, and usage string. +// The argument p points to a time.Duration variable in which to store the value of the flag. +func (fs *FlagSet) DurationVar(p *time.Duration, names []string, value time.Duration, usage string) { + fs.Var(newDurationValue(value, p), names, usage) +} + +// DurationVar defines a time.Duration flag with specified name, default value, and usage string. +// The argument p points to a time.Duration variable in which to store the value of the flag. +func DurationVar(p *time.Duration, names []string, value time.Duration, usage string) { + CommandLine.Var(newDurationValue(value, p), names, usage) +} + +// Duration defines a time.Duration flag with specified name, default value, and usage string. +// The return value is the address of a time.Duration variable that stores the value of the flag. +func (fs *FlagSet) Duration(names []string, value time.Duration, usage string) *time.Duration { + p := new(time.Duration) + fs.DurationVar(p, names, value, usage) + return p +} + +// Duration defines a time.Duration flag with specified name, default value, and usage string. +// The return value is the address of a time.Duration variable that stores the value of the flag. +func Duration(names []string, value time.Duration, usage string) *time.Duration { + return CommandLine.Duration(names, value, usage) +} + +// Var defines a flag with the specified name and usage string. The type and +// value of the flag are represented by the first argument, of type Value, which +// typically holds a user-defined implementation of Value. For instance, the +// caller could create a flag that turns a comma-separated string into a slice +// of strings by giving the slice the methods of Value; in particular, Set would +// decompose the comma-separated string into the slice. +func (fs *FlagSet) Var(value Value, names []string, usage string) { + // Remember the default value as a string; it won't change. + flag := &Flag{names, usage, value, value.String()} + for _, name := range names { + name = strings.TrimPrefix(name, "#") + _, alreadythere := fs.formal[name] + if alreadythere { + var msg string + if fs.name == "" { + msg = fmt.Sprintf("flag redefined: %s", name) + } else { + msg = fmt.Sprintf("%s flag redefined: %s", fs.name, name) + } + fmt.Fprintln(fs.Out(), msg) + panic(msg) // Happens only if flags are declared with identical names + } + if fs.formal == nil { + fs.formal = make(map[string]*Flag) + } + fs.formal[name] = flag + } +} + +// Var defines a flag with the specified name and usage string. The type and +// value of the flag are represented by the first argument, of type Value, which +// typically holds a user-defined implementation of Value. For instance, the +// caller could create a flag that turns a comma-separated string into a slice +// of strings by giving the slice the methods of Value; in particular, Set would +// decompose the comma-separated string into the slice. +func Var(value Value, names []string, usage string) { + CommandLine.Var(value, names, usage) +} + +// failf prints to standard error a formatted error and usage message and +// returns the error. +func (fs *FlagSet) failf(format string, a ...interface{}) error { + err := fmt.Errorf(format, a...) + fmt.Fprintln(fs.Out(), err) + if os.Args[0] == fs.name { + fmt.Fprintf(fs.Out(), "See '%s --help'.\n", os.Args[0]) + } else { + fmt.Fprintf(fs.Out(), "See '%s %s --help'.\n", os.Args[0], fs.name) + } + return err +} + +// usage calls the Usage method for the flag set, or the usage function if +// the flag set is CommandLine. +func (fs *FlagSet) usage() { + if fs == CommandLine { + Usage() + } else if fs.Usage == nil { + defaultUsage(fs) + } else { + fs.Usage() + } +} + +func trimQuotes(str string) string { + if len(str) == 0 { + return str + } + type quote struct { + start, end byte + } + + // All valid quote types. + quotes := []quote{ + // Double quotes + { + start: '"', + end: '"', + }, + + // Single quotes + { + start: '\'', + end: '\'', + }, + } + + for _, quote := range quotes { + // Only strip if outermost match. + if str[0] == quote.start && str[len(str)-1] == quote.end { + str = str[1 : len(str)-1] + break + } + } + + return str +} + +// parseOne parses one flag. It reports whether a flag was seen. +func (fs *FlagSet) parseOne() (bool, string, error) { + if len(fs.args) == 0 { + return false, "", nil + } + s := fs.args[0] + if len(s) == 0 || s[0] != '-' || len(s) == 1 { + return false, "", nil + } + if s[1] == '-' && len(s) == 2 { // "--" terminates the flags + fs.args = fs.args[1:] + return false, "", nil + } + name := s[1:] + if len(name) == 0 || name[0] == '=' { + return false, "", fs.failf("bad flag syntax: %s", s) + } + + // it's a flag. does it have an argument? + fs.args = fs.args[1:] + hasValue := false + value := "" + if i := strings.Index(name, "="); i != -1 { + value = trimQuotes(name[i+1:]) + hasValue = true + name = name[:i] + } + + m := fs.formal + flag, alreadythere := m[name] // BUG + if !alreadythere { + if name == "-help" || name == "help" || name == "h" { // special case for nice help message. + fs.usage() + return false, "", ErrHelp + } + if len(name) > 0 && name[0] == '-' { + return false, "", fs.failf("flag provided but not defined: -%s", name) + } + return false, name, ErrRetry + } + if fv, ok := flag.Value.(boolFlag); ok && fv.IsBoolFlag() { // special case: doesn't need an arg + if hasValue { + if err := fv.Set(value); err != nil { + return false, "", fs.failf("invalid boolean value %q for -%s: %v", value, name, err) + } + } else { + fv.Set("true") + } + } else { + // It must have a value, which might be the next argument. + if !hasValue && len(fs.args) > 0 { + // value is the next arg + hasValue = true + value, fs.args = fs.args[0], fs.args[1:] + } + if !hasValue { + return false, "", fs.failf("flag needs an argument: -%s", name) + } + if err := flag.Value.Set(value); err != nil { + return false, "", fs.failf("invalid value %q for flag -%s: %v", value, name, err) + } + } + if fs.actual == nil { + fs.actual = make(map[string]*Flag) + } + fs.actual[name] = flag + for i, n := range flag.Names { + if n == fmt.Sprintf("#%s", name) { + replacement := "" + for j := i; j < len(flag.Names); j++ { + if flag.Names[j][0] != '#' { + replacement = flag.Names[j] + break + } + } + if replacement != "" { + fmt.Fprintf(fs.Out(), "Warning: '-%s' is deprecated, it will be replaced by '-%s' soon. See usage.\n", name, replacement) + } else { + fmt.Fprintf(fs.Out(), "Warning: '-%s' is deprecated, it will be removed soon. See usage.\n", name) + } + } + } + return true, "", nil +} + +// Parse parses flag definitions from the argument list, which should not +// include the command name. Must be called after all flags in the FlagSet +// are defined and before flags are accessed by the program. +// The return value will be ErrHelp if -help was set but not defined. +func (fs *FlagSet) Parse(arguments []string) error { + fs.parsed = true + fs.args = arguments + for { + seen, name, err := fs.parseOne() + if seen { + continue + } + if err == nil { + break + } + if err == ErrRetry { + if len(name) > 1 { + err = nil + for _, letter := range strings.Split(name, "") { + fs.args = append([]string{"-" + letter}, fs.args...) + seen2, _, err2 := fs.parseOne() + if seen2 { + continue + } + if err2 != nil { + err = fs.failf("flag provided but not defined: -%s", name) + break + } + } + if err == nil { + continue + } + } else { + err = fs.failf("flag provided but not defined: -%s", name) + } + } + switch fs.errorHandling { + case ContinueOnError: + return err + case ExitOnError: + os.Exit(2) + case PanicOnError: + panic(err) + } + } + return nil +} + +// ParseFlags is a utility function that adds a help flag if withHelp is true, +// calls fs.Parse(args) and prints a relevant error message if there are +// incorrect number of arguments. It returns error only if error handling is +// set to ContinueOnError and parsing fails. If error handling is set to +// ExitOnError, it's safe to ignore the return value. +func (fs *FlagSet) ParseFlags(args []string, withHelp bool) error { + var help *bool + if withHelp { + help = fs.Bool([]string{"#help", "-help"}, false, "Print usage") + } + if err := fs.Parse(args); err != nil { + return err + } + if help != nil && *help { + fs.SetOutput(os.Stdout) + fs.Usage() + os.Exit(0) + } + if str := fs.CheckArgs(); str != "" { + fs.SetOutput(os.Stderr) + fs.ReportError(str, withHelp) + fs.ShortUsage() + os.Exit(1) + } + return nil +} + +// ReportError is a utility method that prints a user-friendly message +// containing the error that occurred during parsing and a suggestion to get help +func (fs *FlagSet) ReportError(str string, withHelp bool) { + if withHelp { + if os.Args[0] == fs.Name() { + str += ".\nSee '" + os.Args[0] + " --help'" + } else { + str += ".\nSee '" + os.Args[0] + " " + fs.Name() + " --help'" + } + } + fmt.Fprintf(fs.Out(), "docker: %s.\n", str) +} + +// Parsed reports whether fs.Parse has been called. +func (fs *FlagSet) Parsed() bool { + return fs.parsed +} + +// Parse parses the command-line flags from os.Args[1:]. Must be called +// after all flags are defined and before flags are accessed by the program. +func Parse() { + // Ignore errors; CommandLine is set for ExitOnError. + CommandLine.Parse(os.Args[1:]) +} + +// Parsed returns true if the command-line flags have been parsed. +func Parsed() bool { + return CommandLine.Parsed() +} + +// CommandLine is the default set of command-line flags, parsed from os.Args. +// The top-level functions such as BoolVar, Arg, and on are wrappers for the +// methods of CommandLine. +var CommandLine = NewFlagSet(os.Args[0], ExitOnError) + +// NewFlagSet returns a new, empty flag set with the specified name and +// error handling property. +func NewFlagSet(name string, errorHandling ErrorHandling) *FlagSet { + f := &FlagSet{ + name: name, + errorHandling: errorHandling, + } + return f +} + +// Init sets the name and error handling property for a flag set. +// By default, the zero FlagSet uses an empty name and the +// ContinueOnError error handling policy. +func (fs *FlagSet) Init(name string, errorHandling ErrorHandling) { + fs.name = name + fs.errorHandling = errorHandling +} + +type mergeVal struct { + Value + key string + fset *FlagSet +} + +func (v mergeVal) Set(s string) error { + return v.fset.Set(v.key, s) +} + +func (v mergeVal) IsBoolFlag() bool { + if b, ok := v.Value.(boolFlag); ok { + return b.IsBoolFlag() + } + return false +} + +// Merge is an helper function that merges n FlagSets into a single dest FlagSet +// In case of name collision between the flagsets it will apply +// the destination FlagSet's errorHandling behaviour. +func Merge(dest *FlagSet, flagsets ...*FlagSet) error { + for _, fset := range flagsets { + for k, f := range fset.formal { + if _, ok := dest.formal[k]; ok { + var err error + if fset.name == "" { + err = fmt.Errorf("flag redefined: %s", k) + } else { + err = fmt.Errorf("%s flag redefined: %s", fset.name, k) + } + fmt.Fprintln(fset.Out(), err.Error()) + // Happens only if flags are declared with identical names + switch dest.errorHandling { + case ContinueOnError: + return err + case ExitOnError: + os.Exit(2) + case PanicOnError: + panic(err) + } + } + newF := *f + newF.Value = mergeVal{f.Value, k, fset} + dest.formal[k] = &newF + } + } + return nil +} + +// IsEmpty reports if the FlagSet is actually empty. +func (fs *FlagSet) IsEmpty() bool { + return len(fs.actual) == 0 +} diff --git a/pkg/mflag/flag_test.go b/pkg/mflag/flag_test.go new file mode 100644 index 0000000000..85f32c8aa4 --- /dev/null +++ b/pkg/mflag/flag_test.go @@ -0,0 +1,516 @@ +// Copyright 2014-2015 The Docker & Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package mflag + +import ( + "bytes" + "fmt" + "os" + "sort" + "strings" + "testing" + "time" +) + +// ResetForTesting clears all flag state and sets the usage function as directed. +// After calling ResetForTesting, parse errors in flag handling will not +// exit the program. +func ResetForTesting(usage func()) { + CommandLine = NewFlagSet(os.Args[0], ContinueOnError) + Usage = usage +} +func boolString(s string) string { + if s == "0" { + return "false" + } + return "true" +} + +func TestEverything(t *testing.T) { + ResetForTesting(nil) + Bool([]string{"test_bool"}, false, "bool value") + Int([]string{"test_int"}, 0, "int value") + Int64([]string{"test_int64"}, 0, "int64 value") + Uint([]string{"test_uint"}, 0, "uint value") + Uint64([]string{"test_uint64"}, 0, "uint64 value") + String([]string{"test_string"}, "0", "string value") + Float64([]string{"test_float64"}, 0, "float64 value") + Duration([]string{"test_duration"}, 0, "time.Duration value") + + m := make(map[string]*Flag) + desired := "0" + visitor := func(f *Flag) { + for _, name := range f.Names { + if len(name) > 5 && name[0:5] == "test_" { + m[name] = f + ok := false + switch { + case f.Value.String() == desired: + ok = true + case name == "test_bool" && f.Value.String() == boolString(desired): + ok = true + case name == "test_duration" && f.Value.String() == desired+"s": + ok = true + } + if !ok { + t.Error("Visit: bad value", f.Value.String(), "for", name) + } + } + } + } + VisitAll(visitor) + if len(m) != 8 { + t.Error("VisitAll misses some flags") + for k, v := range m { + t.Log(k, *v) + } + } + m = make(map[string]*Flag) + Visit(visitor) + if len(m) != 0 { + t.Errorf("Visit sees unset flags") + for k, v := range m { + t.Log(k, *v) + } + } + // Now set all flags + Set("test_bool", "true") + Set("test_int", "1") + Set("test_int64", "1") + Set("test_uint", "1") + Set("test_uint64", "1") + Set("test_string", "1") + Set("test_float64", "1") + Set("test_duration", "1s") + desired = "1" + Visit(visitor) + if len(m) != 8 { + t.Error("Visit fails after set") + for k, v := range m { + t.Log(k, *v) + } + } + // Now test they're visited in sort order. + var flagNames []string + Visit(func(f *Flag) { + for _, name := range f.Names { + flagNames = append(flagNames, name) + } + }) + if !sort.StringsAreSorted(flagNames) { + t.Errorf("flag names not sorted: %v", flagNames) + } +} + +func TestGet(t *testing.T) { + ResetForTesting(nil) + Bool([]string{"test_bool"}, true, "bool value") + Int([]string{"test_int"}, 1, "int value") + Int64([]string{"test_int64"}, 2, "int64 value") + Uint([]string{"test_uint"}, 3, "uint value") + Uint64([]string{"test_uint64"}, 4, "uint64 value") + String([]string{"test_string"}, "5", "string value") + Float64([]string{"test_float64"}, 6, "float64 value") + Duration([]string{"test_duration"}, 7, "time.Duration value") + + visitor := func(f *Flag) { + for _, name := range f.Names { + if len(name) > 5 && name[0:5] == "test_" { + g, ok := f.Value.(Getter) + if !ok { + t.Errorf("Visit: value does not satisfy Getter: %T", f.Value) + return + } + switch name { + case "test_bool": + ok = g.Get() == true + case "test_int": + ok = g.Get() == int(1) + case "test_int64": + ok = g.Get() == int64(2) + case "test_uint": + ok = g.Get() == uint(3) + case "test_uint64": + ok = g.Get() == uint64(4) + case "test_string": + ok = g.Get() == "5" + case "test_float64": + ok = g.Get() == float64(6) + case "test_duration": + ok = g.Get() == time.Duration(7) + } + if !ok { + t.Errorf("Visit: bad value %T(%v) for %s", g.Get(), g.Get(), name) + } + } + } + } + VisitAll(visitor) +} + +func testParse(f *FlagSet, t *testing.T) { + if f.Parsed() { + t.Error("f.Parse() = true before Parse") + } + boolFlag := f.Bool([]string{"bool"}, false, "bool value") + bool2Flag := f.Bool([]string{"bool2"}, false, "bool2 value") + f.Bool([]string{"bool3"}, false, "bool3 value") + bool4Flag := f.Bool([]string{"bool4"}, false, "bool4 value") + intFlag := f.Int([]string{"-int"}, 0, "int value") + int64Flag := f.Int64([]string{"-int64"}, 0, "int64 value") + uintFlag := f.Uint([]string{"uint"}, 0, "uint value") + uint64Flag := f.Uint64([]string{"-uint64"}, 0, "uint64 value") + stringFlag := f.String([]string{"string"}, "0", "string value") + f.String([]string{"string2"}, "0", "string2 value") + singleQuoteFlag := f.String([]string{"squote"}, "", "single quoted value") + doubleQuoteFlag := f.String([]string{"dquote"}, "", "double quoted value") + mixedQuoteFlag := f.String([]string{"mquote"}, "", "mixed quoted value") + mixed2QuoteFlag := f.String([]string{"mquote2"}, "", "mixed2 quoted value") + nestedQuoteFlag := f.String([]string{"nquote"}, "", "nested quoted value") + nested2QuoteFlag := f.String([]string{"nquote2"}, "", "nested2 quoted value") + float64Flag := f.Float64([]string{"float64"}, 0, "float64 value") + durationFlag := f.Duration([]string{"duration"}, 5*time.Second, "time.Duration value") + extra := "one-extra-argument" + args := []string{ + "-bool", + "-bool2=true", + "-bool4=false", + "--int", "22", + "--int64", "0x23", + "-uint", "24", + "--uint64", "25", + "-string", "hello", + "-squote='single'", + `-dquote="double"`, + `-mquote='mixed"`, + `-mquote2="mixed2'`, + `-nquote="'single nested'"`, + `-nquote2='"double nested"'`, + "-float64", "2718e28", + "-duration", "2m", + extra, + } + if err := f.Parse(args); err != nil { + t.Fatal(err) + } + if !f.Parsed() { + t.Error("f.Parse() = false after Parse") + } + if *boolFlag != true { + t.Error("bool flag should be true, is ", *boolFlag) + } + if *bool2Flag != true { + t.Error("bool2 flag should be true, is ", *bool2Flag) + } + if !f.IsSet("bool2") { + t.Error("bool2 should be marked as set") + } + if f.IsSet("bool3") { + t.Error("bool3 should not be marked as set") + } + if !f.IsSet("bool4") { + t.Error("bool4 should be marked as set") + } + if *bool4Flag != false { + t.Error("bool4 flag should be false, is ", *bool4Flag) + } + if *intFlag != 22 { + t.Error("int flag should be 22, is ", *intFlag) + } + if *int64Flag != 0x23 { + t.Error("int64 flag should be 0x23, is ", *int64Flag) + } + if *uintFlag != 24 { + t.Error("uint flag should be 24, is ", *uintFlag) + } + if *uint64Flag != 25 { + t.Error("uint64 flag should be 25, is ", *uint64Flag) + } + if *stringFlag != "hello" { + t.Error("string flag should be `hello`, is ", *stringFlag) + } + if !f.IsSet("string") { + t.Error("string flag should be marked as set") + } + if f.IsSet("string2") { + t.Error("string2 flag should not be marked as set") + } + if *singleQuoteFlag != "single" { + t.Error("single quote string flag should be `single`, is ", *singleQuoteFlag) + } + if *doubleQuoteFlag != "double" { + t.Error("double quote string flag should be `double`, is ", *doubleQuoteFlag) + } + if *mixedQuoteFlag != `'mixed"` { + t.Error("mixed quote string flag should be `'mixed\"`, is ", *mixedQuoteFlag) + } + if *mixed2QuoteFlag != `"mixed2'` { + t.Error("mixed2 quote string flag should be `\"mixed2'`, is ", *mixed2QuoteFlag) + } + if *nestedQuoteFlag != "'single nested'" { + t.Error("nested quote string flag should be `'single nested'`, is ", *nestedQuoteFlag) + } + if *nested2QuoteFlag != `"double nested"` { + t.Error("double quote string flag should be `\"double nested\"`, is ", *nested2QuoteFlag) + } + if *float64Flag != 2718e28 { + t.Error("float64 flag should be 2718e28, is ", *float64Flag) + } + if *durationFlag != 2*time.Minute { + t.Error("duration flag should be 2m, is ", *durationFlag) + } + if len(f.Args()) != 1 { + t.Error("expected one argument, got", len(f.Args())) + } else if f.Args()[0] != extra { + t.Errorf("expected argument %q got %q", extra, f.Args()[0]) + } +} + +func testPanic(f *FlagSet, t *testing.T) { + f.Int([]string{"-int"}, 0, "int value") + if f.Parsed() { + t.Error("f.Parse() = true before Parse") + } + args := []string{ + "-int", "21", + } + f.Parse(args) +} + +func TestParsePanic(t *testing.T) { + ResetForTesting(func() {}) + testPanic(CommandLine, t) +} + +func TestParse(t *testing.T) { + ResetForTesting(func() { t.Error("bad parse") }) + testParse(CommandLine, t) +} + +func TestFlagSetParse(t *testing.T) { + testParse(NewFlagSet("test", ContinueOnError), t) +} + +// Declare a user-defined flag type. +type flagVar []string + +func (f *flagVar) String() string { + return fmt.Sprint([]string(*f)) +} + +func (f *flagVar) Set(value string) error { + *f = append(*f, value) + return nil +} + +func TestUserDefined(t *testing.T) { + var flags FlagSet + flags.Init("test", ContinueOnError) + var v flagVar + flags.Var(&v, []string{"v"}, "usage") + if err := flags.Parse([]string{"-v", "1", "-v", "2", "-v=3"}); err != nil { + t.Error(err) + } + if len(v) != 3 { + t.Fatal("expected 3 args; got ", len(v)) + } + expect := "[1 2 3]" + if v.String() != expect { + t.Errorf("expected value %q got %q", expect, v.String()) + } +} + +// Declare a user-defined boolean flag type. +type boolFlagVar struct { + count int +} + +func (b *boolFlagVar) String() string { + return fmt.Sprintf("%d", b.count) +} + +func (b *boolFlagVar) Set(value string) error { + if value == "true" { + b.count++ + } + return nil +} + +func (b *boolFlagVar) IsBoolFlag() bool { + return b.count < 4 +} + +func TestUserDefinedBool(t *testing.T) { + var flags FlagSet + flags.Init("test", ContinueOnError) + var b boolFlagVar + var err error + flags.Var(&b, []string{"b"}, "usage") + if err = flags.Parse([]string{"-b", "-b", "-b", "-b=true", "-b=false", "-b", "barg", "-b"}); err != nil { + if b.count < 4 { + t.Error(err) + } + } + + if b.count != 4 { + t.Errorf("want: %d; got: %d", 4, b.count) + } + + if err == nil { + t.Error("expected error; got none") + } +} + +func TestSetOutput(t *testing.T) { + var flags FlagSet + var buf bytes.Buffer + flags.SetOutput(&buf) + flags.Init("test", ContinueOnError) + flags.Parse([]string{"-unknown"}) + if out := buf.String(); !strings.Contains(out, "-unknown") { + t.Logf("expected output mentioning unknown; got %q", out) + } +} + +// This tests that one can reset the flags. This still works but not well, and is +// superseded by FlagSet. +func TestChangingArgs(t *testing.T) { + ResetForTesting(func() { t.Fatal("bad parse") }) + oldArgs := os.Args + defer func() { os.Args = oldArgs }() + os.Args = []string{"cmd", "-before", "subcmd", "-after", "args"} + before := Bool([]string{"before"}, false, "") + if err := CommandLine.Parse(os.Args[1:]); err != nil { + t.Fatal(err) + } + cmd := Arg(0) + os.Args = Args() + after := Bool([]string{"after"}, false, "") + Parse() + args := Args() + + if !*before || cmd != "subcmd" || !*after || len(args) != 1 || args[0] != "args" { + t.Fatalf("expected true subcmd true [args] got %v %v %v %v", *before, cmd, *after, args) + } +} + +// Test that -help invokes the usage message and returns ErrHelp. +func TestHelp(t *testing.T) { + var helpCalled = false + fs := NewFlagSet("help test", ContinueOnError) + fs.Usage = func() { helpCalled = true } + var flag bool + fs.BoolVar(&flag, []string{"flag"}, false, "regular flag") + // Regular flag invocation should work + err := fs.Parse([]string{"-flag=true"}) + if err != nil { + t.Fatal("expected no error; got ", err) + } + if !flag { + t.Error("flag was not set by -flag") + } + if helpCalled { + t.Error("help called for regular flag") + helpCalled = false // reset for next test + } + // Help flag should work as expected. + err = fs.Parse([]string{"-help"}) + if err == nil { + t.Fatal("error expected") + } + if err != ErrHelp { + t.Fatal("expected ErrHelp; got ", err) + } + if !helpCalled { + t.Fatal("help was not called") + } + // If we define a help flag, that should override. + var help bool + fs.BoolVar(&help, []string{"help"}, false, "help flag") + helpCalled = false + err = fs.Parse([]string{"-help"}) + if err != nil { + t.Fatal("expected no error for defined -help; got ", err) + } + if helpCalled { + t.Fatal("help was called; should not have been for defined help flag") + } +} + +// Test the flag count functions. +func TestFlagCounts(t *testing.T) { + fs := NewFlagSet("help test", ContinueOnError) + var flag bool + fs.BoolVar(&flag, []string{"flag1"}, false, "regular flag") + fs.BoolVar(&flag, []string{"#deprecated1"}, false, "regular flag") + fs.BoolVar(&flag, []string{"f", "flag2"}, false, "regular flag") + fs.BoolVar(&flag, []string{"#d", "#deprecated2"}, false, "regular flag") + fs.BoolVar(&flag, []string{"flag3"}, false, "regular flag") + fs.BoolVar(&flag, []string{"g", "#flag4", "-flag4"}, false, "regular flag") + + if fs.FlagCount() != 6 { + t.Fatal("FlagCount wrong. ", fs.FlagCount()) + } + if fs.FlagCountUndeprecated() != 4 { + t.Fatal("FlagCountUndeprecated wrong. ", fs.FlagCountUndeprecated()) + } + if fs.NFlag() != 0 { + t.Fatal("NFlag wrong. ", fs.NFlag()) + } + err := fs.Parse([]string{"-fd", "-g", "-flag4"}) + if err != nil { + t.Fatal("expected no error for defined -help; got ", err) + } + if fs.NFlag() != 4 { + t.Fatal("NFlag wrong. ", fs.NFlag()) + } +} + +// Show up bug in sortFlags +func TestSortFlags(t *testing.T) { + fs := NewFlagSet("help TestSortFlags", ContinueOnError) + + var err error + + var b bool + fs.BoolVar(&b, []string{"b", "-banana"}, false, "usage") + + err = fs.Parse([]string{"--banana=true"}) + if err != nil { + t.Fatal("expected no error; got ", err) + } + + count := 0 + + fs.VisitAll(func(flag *Flag) { + count++ + if flag == nil { + t.Fatal("VisitAll should not return a nil flag") + } + }) + flagcount := fs.FlagCount() + if flagcount != count { + t.Fatalf("FlagCount (%d) != number (%d) of elements visited", flagcount, count) + } + // Make sure its idempotent + if flagcount != fs.FlagCount() { + t.Fatalf("FlagCount (%d) != fs.FlagCount() (%d) of elements visited", flagcount, fs.FlagCount()) + } + + count = 0 + fs.Visit(func(flag *Flag) { + count++ + if flag == nil { + t.Fatal("Visit should not return a nil flag") + } + }) + nflag := fs.NFlag() + if nflag != count { + t.Fatalf("NFlag (%d) != number (%d) of elements visited", nflag, count) + } + if nflag != fs.NFlag() { + t.Fatalf("NFlag (%d) != fs.NFlag() (%d) of elements visited", nflag, fs.NFlag()) + } +} diff --git a/pkg/mount/flags.go b/pkg/mount/flags.go new file mode 100644 index 0000000000..17dbd7a64c --- /dev/null +++ b/pkg/mount/flags.go @@ -0,0 +1,69 @@ +package mount + +import ( + "strings" +) + +// Parse fstab type mount options into mount() flags +// and device specific data +func parseOptions(options string) (int, string) { + var ( + flag int + data []string + ) + + flags := map[string]struct { + clear bool + flag int + }{ + "defaults": {false, 0}, + "ro": {false, RDONLY}, + "rw": {true, RDONLY}, + "suid": {true, NOSUID}, + "nosuid": {false, NOSUID}, + "dev": {true, NODEV}, + "nodev": {false, NODEV}, + "exec": {true, NOEXEC}, + "noexec": {false, NOEXEC}, + "sync": {false, SYNCHRONOUS}, + "async": {true, SYNCHRONOUS}, + "dirsync": {false, DIRSYNC}, + "remount": {false, REMOUNT}, + "mand": {false, MANDLOCK}, + "nomand": {true, MANDLOCK}, + "atime": {true, NOATIME}, + "noatime": {false, NOATIME}, + "diratime": {true, NODIRATIME}, + "nodiratime": {false, NODIRATIME}, + "bind": {false, BIND}, + "rbind": {false, RBIND}, + "unbindable": {false, UNBINDABLE}, + "runbindable": {false, RUNBINDABLE}, + "private": {false, PRIVATE}, + "rprivate": {false, RPRIVATE}, + "shared": {false, SHARED}, + "rshared": {false, RSHARED}, + "slave": {false, SLAVE}, + "rslave": {false, RSLAVE}, + "relatime": {false, RELATIME}, + "norelatime": {true, RELATIME}, + "strictatime": {false, STRICTATIME}, + "nostrictatime": {true, STRICTATIME}, + } + + for _, o := range strings.Split(options, ",") { + // If the option does not exist in the flags table or the flag + // is not supported on the platform, + // then it is a data value for a specific fs type + if f, exists := flags[o]; exists && f.flag != 0 { + if f.clear { + flag &= ^f.flag + } else { + flag |= f.flag + } + } else { + data = append(data, o) + } + } + return flag, strings.Join(data, ",") +} diff --git a/pkg/mount/flags_freebsd.go b/pkg/mount/flags_freebsd.go new file mode 100644 index 0000000000..f166cb2f77 --- /dev/null +++ b/pkg/mount/flags_freebsd.go @@ -0,0 +1,48 @@ +// +build freebsd,cgo + +package mount + +/* +#include +*/ +import "C" + +const ( + // RDONLY will mount the filesystem as read-only. + RDONLY = C.MNT_RDONLY + + // NOSUID will not allow set-user-identifier or set-group-identifier bits to + // take effect. + NOSUID = C.MNT_NOSUID + + // NOEXEC will not allow execution of any binaries on the mounted file system. + NOEXEC = C.MNT_NOEXEC + + // SYNCHRONOUS will allow any I/O to the file system to be done synchronously. + SYNCHRONOUS = C.MNT_SYNCHRONOUS + + // NOATIME will not update the file access time when reading from a file. + NOATIME = C.MNT_NOATIME +) + +// These flags are unsupported. +const ( + BIND = 0 + DIRSYNC = 0 + MANDLOCK = 0 + NODEV = 0 + NODIRATIME = 0 + UNBINDABLE = 0 + RUNBINDABLE = 0 + PRIVATE = 0 + RPRIVATE = 0 + SHARED = 0 + RSHARED = 0 + SLAVE = 0 + RSLAVE = 0 + RBIND = 0 + RELATIVE = 0 + RELATIME = 0 + REMOUNT = 0 + STRICTATIME = 0 +) diff --git a/pkg/mount/flags_linux.go b/pkg/mount/flags_linux.go new file mode 100644 index 0000000000..2f9f5c58ee --- /dev/null +++ b/pkg/mount/flags_linux.go @@ -0,0 +1,85 @@ +package mount + +import ( + "syscall" +) + +const ( + // RDONLY will mount the file system read-only. + RDONLY = syscall.MS_RDONLY + + // NOSUID will not allow set-user-identifier or set-group-identifier bits to + // take effect. + NOSUID = syscall.MS_NOSUID + + // NODEV will not interpret character or block special devices on the file + // system. + NODEV = syscall.MS_NODEV + + // NOEXEC will not allow execution of any binaries on the mounted file system. + NOEXEC = syscall.MS_NOEXEC + + // SYNCHRONOUS will allow I/O to the file system to be done synchronously. + SYNCHRONOUS = syscall.MS_SYNCHRONOUS + + // DIRSYNC will force all directory updates within the file system to be done + // synchronously. This affects the following system calls: creat, link, + // unlink, symlink, mkdir, rmdir, mknod and rename. + DIRSYNC = syscall.MS_DIRSYNC + + // REMOUNT will attempt to remount an already-mounted file system. This is + // commonly used to change the mount flags for a file system, especially to + // make a readonly file system writeable. It does not change device or mount + // point. + REMOUNT = syscall.MS_REMOUNT + + // MANDLOCK will force mandatory locks on a filesystem. + MANDLOCK = syscall.MS_MANDLOCK + + // NOATIME will not update the file access time when reading from a file. + NOATIME = syscall.MS_NOATIME + + // NODIRATIME will not update the directory access time. + NODIRATIME = syscall.MS_NODIRATIME + + // BIND remounts a subtree somewhere else. + BIND = syscall.MS_BIND + + // RBIND remounts a subtree and all possible submounts somewhere else. + RBIND = syscall.MS_BIND | syscall.MS_REC + + // UNBINDABLE creates a mount which cannot be cloned through a bind operation. + UNBINDABLE = syscall.MS_UNBINDABLE + + // RUNBINDABLE marks the entire mount tree as UNBINDABLE. + RUNBINDABLE = syscall.MS_UNBINDABLE | syscall.MS_REC + + // PRIVATE creates a mount which carries no propagation abilities. + PRIVATE = syscall.MS_PRIVATE + + // RPRIVATE marks the entire mount tree as PRIVATE. + RPRIVATE = syscall.MS_PRIVATE | syscall.MS_REC + + // SLAVE creates a mount which receives propagation from its master, but not + // vice versa. + SLAVE = syscall.MS_SLAVE + + // RSLAVE marks the entire mount tree as SLAVE. + RSLAVE = syscall.MS_SLAVE | syscall.MS_REC + + // SHARED creates a mount which provides the ability to create mirrors of + // that mount such that mounts and unmounts within any of the mirrors + // propagate to the other mirrors. + SHARED = syscall.MS_SHARED + + // RSHARED marks the entire mount tree as SHARED. + RSHARED = syscall.MS_SHARED | syscall.MS_REC + + // RELATIME updates inode access times relative to modify or change time. + RELATIME = syscall.MS_RELATIME + + // STRICTATIME allows to explicitly request full atime updates. This makes + // it possible for the kernel to default to relatime or noatime but still + // allow userspace to override it. + STRICTATIME = syscall.MS_STRICTATIME +) diff --git a/pkg/mount/flags_unsupported.go b/pkg/mount/flags_unsupported.go new file mode 100644 index 0000000000..a90d3d1151 --- /dev/null +++ b/pkg/mount/flags_unsupported.go @@ -0,0 +1,30 @@ +// +build !linux,!freebsd freebsd,!cgo + +package mount + +// These flags are unsupported. +const ( + BIND = 0 + DIRSYNC = 0 + MANDLOCK = 0 + NOATIME = 0 + NODEV = 0 + NODIRATIME = 0 + NOEXEC = 0 + NOSUID = 0 + UNBINDABLE = 0 + RUNBINDABLE = 0 + PRIVATE = 0 + RPRIVATE = 0 + SHARED = 0 + RSHARED = 0 + SLAVE = 0 + RSLAVE = 0 + RBIND = 0 + RELATIME = 0 + RELATIVE = 0 + REMOUNT = 0 + STRICTATIME = 0 + SYNCHRONOUS = 0 + RDONLY = 0 +) diff --git a/pkg/mount/mount.go b/pkg/mount/mount.go new file mode 100644 index 0000000000..ed7216e5c0 --- /dev/null +++ b/pkg/mount/mount.go @@ -0,0 +1,74 @@ +package mount + +import ( + "time" +) + +// GetMounts retrieves a list of mounts for the current running process. +func GetMounts() ([]*Info, error) { + return parseMountTable() +} + +// Mounted looks at /proc/self/mountinfo to determine of the specified +// mountpoint has been mounted +func Mounted(mountpoint string) (bool, error) { + entries, err := parseMountTable() + if err != nil { + return false, err + } + + // Search the table for the mountpoint + for _, e := range entries { + if e.Mountpoint == mountpoint { + return true, nil + } + } + return false, nil +} + +// Mount will mount filesystem according to the specified configuration, on the +// condition that the target path is *not* already mounted. Options must be +// specified like the mount or fstab unix commands: "opt1=val1,opt2=val2". See +// flags.go for supported option flags. +func Mount(device, target, mType, options string) error { + flag, _ := parseOptions(options) + if flag&REMOUNT != REMOUNT { + if mounted, err := Mounted(target); err != nil || mounted { + return err + } + } + return ForceMount(device, target, mType, options) +} + +// ForceMount will mount a filesystem according to the specified configuration, +// *regardless* if the target path is not already mounted. Options must be +// specified like the mount or fstab unix commands: "opt1=val1,opt2=val2". See +// flags.go for supported option flags. +func ForceMount(device, target, mType, options string) error { + flag, data := parseOptions(options) + if err := mount(device, target, mType, uintptr(flag), data); err != nil { + return err + } + return nil +} + +// Unmount will unmount the target filesystem, so long as it is mounted. +func Unmount(target string) error { + if mounted, err := Mounted(target); err != nil || !mounted { + return err + } + return ForceUnmount(target) +} + +// ForceUnmount will force an unmount of the target filesystem, regardless if +// it is mounted or not. +func ForceUnmount(target string) (err error) { + // Simple retry logic for unmount + for i := 0; i < 10; i++ { + if err = unmount(target, 0); err == nil { + return nil + } + time.Sleep(100 * time.Millisecond) + } + return +} diff --git a/pkg/mount/mount_test.go b/pkg/mount/mount_test.go new file mode 100644 index 0000000000..5c7f1b86a0 --- /dev/null +++ b/pkg/mount/mount_test.go @@ -0,0 +1,137 @@ +package mount + +import ( + "os" + "path" + "testing" +) + +func TestMountOptionsParsing(t *testing.T) { + options := "noatime,ro,size=10k" + + flag, data := parseOptions(options) + + if data != "size=10k" { + t.Fatalf("Expected size=10 got %s", data) + } + + expectedFlag := NOATIME | RDONLY + + if flag != expectedFlag { + t.Fatalf("Expected %d got %d", expectedFlag, flag) + } +} + +func TestMounted(t *testing.T) { + tmp := path.Join(os.TempDir(), "mount-tests") + if err := os.MkdirAll(tmp, 0777); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + var ( + sourceDir = path.Join(tmp, "source") + targetDir = path.Join(tmp, "target") + sourcePath = path.Join(sourceDir, "file.txt") + targetPath = path.Join(targetDir, "file.txt") + ) + + os.Mkdir(sourceDir, 0777) + os.Mkdir(targetDir, 0777) + + f, err := os.Create(sourcePath) + if err != nil { + t.Fatal(err) + } + f.WriteString("hello") + f.Close() + + f, err = os.Create(targetPath) + if err != nil { + t.Fatal(err) + } + f.Close() + + if err := Mount(sourceDir, targetDir, "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + mounted, err := Mounted(targetDir) + if err != nil { + t.Fatal(err) + } + if !mounted { + t.Fatalf("Expected %s to be mounted", targetDir) + } + if _, err := os.Stat(targetDir); err != nil { + t.Fatal(err) + } +} + +func TestMountReadonly(t *testing.T) { + tmp := path.Join(os.TempDir(), "mount-tests") + if err := os.MkdirAll(tmp, 0777); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + var ( + sourceDir = path.Join(tmp, "source") + targetDir = path.Join(tmp, "target") + sourcePath = path.Join(sourceDir, "file.txt") + targetPath = path.Join(targetDir, "file.txt") + ) + + os.Mkdir(sourceDir, 0777) + os.Mkdir(targetDir, 0777) + + f, err := os.Create(sourcePath) + if err != nil { + t.Fatal(err) + } + f.WriteString("hello") + f.Close() + + f, err = os.Create(targetPath) + if err != nil { + t.Fatal(err) + } + f.Close() + + if err := Mount(sourceDir, targetDir, "none", "bind,ro"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + f, err = os.OpenFile(targetPath, os.O_RDWR, 0777) + if err == nil { + t.Fatal("Should not be able to open a ro file as rw") + } +} + +func TestGetMounts(t *testing.T) { + mounts, err := GetMounts() + if err != nil { + t.Fatal(err) + } + + root := false + for _, entry := range mounts { + if entry.Mountpoint == "/" { + root = true + } + } + + if !root { + t.Fatal("/ should be mounted at least") + } +} diff --git a/pkg/mount/mounter_freebsd.go b/pkg/mount/mounter_freebsd.go new file mode 100644 index 0000000000..bb870e6f59 --- /dev/null +++ b/pkg/mount/mounter_freebsd.go @@ -0,0 +1,59 @@ +package mount + +/* +#include +#include +#include +#include +#include +#include +*/ +import "C" + +import ( + "fmt" + "strings" + "syscall" + "unsafe" +) + +func allocateIOVecs(options []string) []C.struct_iovec { + out := make([]C.struct_iovec, len(options)) + for i, option := range options { + out[i].iov_base = unsafe.Pointer(C.CString(option)) + out[i].iov_len = C.size_t(len(option) + 1) + } + return out +} + +func mount(device, target, mType string, flag uintptr, data string) error { + isNullFS := false + + xs := strings.Split(data, ",") + for _, x := range xs { + if x == "bind" { + isNullFS = true + } + } + + options := []string{"fspath", target} + if isNullFS { + options = append(options, "fstype", "nullfs", "target", device) + } else { + options = append(options, "fstype", mType, "from", device) + } + rawOptions := allocateIOVecs(options) + for _, rawOption := range rawOptions { + defer C.free(rawOption.iov_base) + } + + if errno := C.nmount(&rawOptions[0], C.uint(len(options)), C.int(flag)); errno != 0 { + reason := C.GoString(C.strerror(*C.__error())) + return fmt.Errorf("Failed to call nmount: %s", reason) + } + return nil +} + +func unmount(target string, flag int) error { + return syscall.Unmount(target, flag) +} diff --git a/pkg/mount/mounter_linux.go b/pkg/mount/mounter_linux.go new file mode 100644 index 0000000000..dd4280c777 --- /dev/null +++ b/pkg/mount/mounter_linux.go @@ -0,0 +1,21 @@ +package mount + +import ( + "syscall" +) + +func mount(device, target, mType string, flag uintptr, data string) error { + if err := syscall.Mount(device, target, mType, flag, data); err != nil { + return err + } + + // If we have a bind mount or remount, remount... + if flag&syscall.MS_BIND == syscall.MS_BIND && flag&syscall.MS_RDONLY == syscall.MS_RDONLY { + return syscall.Mount(device, target, mType, flag|syscall.MS_REMOUNT, data) + } + return nil +} + +func unmount(target string, flag int) error { + return syscall.Unmount(target, flag) +} diff --git a/pkg/mount/mounter_unsupported.go b/pkg/mount/mounter_unsupported.go new file mode 100644 index 0000000000..eb93365eb7 --- /dev/null +++ b/pkg/mount/mounter_unsupported.go @@ -0,0 +1,11 @@ +// +build !linux,!freebsd freebsd,!cgo + +package mount + +func mount(device, target, mType string, flag uintptr, data string) error { + panic("Not implemented") +} + +func unmount(target string, flag int) error { + panic("Not implemented") +} diff --git a/pkg/mount/mountinfo.go b/pkg/mount/mountinfo.go new file mode 100644 index 0000000000..e3fc3535e9 --- /dev/null +++ b/pkg/mount/mountinfo.go @@ -0,0 +1,40 @@ +package mount + +// Info reveals information about a particular mounted filesystem. This +// struct is populated from the content in the /proc//mountinfo file. +type Info struct { + // ID is a unique identifier of the mount (may be reused after umount). + ID int + + // Parent indicates the ID of the mount parent (or of self for the top of the + // mount tree). + Parent int + + // Major indicates one half of the device ID which identifies the device class. + Major int + + // Minor indicates one half of the device ID which identifies a specific + // instance of device. + Minor int + + // Root of the mount within the filesystem. + Root string + + // Mountpoint indicates the mount point relative to the process's root. + Mountpoint string + + // Opts represents mount-specific options. + Opts string + + // Optional represents optional fields. + Optional string + + // Fstype indicates the type of filesystem, such as EXT3. + Fstype string + + // Source indicates filesystem specific information or "none". + Source string + + // VfsOpts represents per super block options. + VfsOpts string +} diff --git a/pkg/mount/mountinfo_freebsd.go b/pkg/mount/mountinfo_freebsd.go new file mode 100644 index 0000000000..4f32edcd90 --- /dev/null +++ b/pkg/mount/mountinfo_freebsd.go @@ -0,0 +1,41 @@ +package mount + +/* +#include +#include +#include +*/ +import "C" + +import ( + "fmt" + "reflect" + "unsafe" +) + +// Parse /proc/self/mountinfo because comparing Dev and ino does not work from +// bind mounts. +func parseMountTable() ([]*Info, error) { + var rawEntries *C.struct_statfs + + count := int(C.getmntinfo(&rawEntries, C.MNT_WAIT)) + if count == 0 { + return nil, fmt.Errorf("Failed to call getmntinfo") + } + + var entries []C.struct_statfs + header := (*reflect.SliceHeader)(unsafe.Pointer(&entries)) + header.Cap = count + header.Len = count + header.Data = uintptr(unsafe.Pointer(rawEntries)) + + var out []*Info + for _, entry := range entries { + var mountinfo Info + mountinfo.Mountpoint = C.GoString(&entry.f_mntonname[0]) + mountinfo.Source = C.GoString(&entry.f_mntfromname[0]) + mountinfo.Fstype = C.GoString(&entry.f_fstypename[0]) + out = append(out, &mountinfo) + } + return out, nil +} diff --git a/pkg/mount/mountinfo_linux.go b/pkg/mount/mountinfo_linux.go new file mode 100644 index 0000000000..be69fee1d7 --- /dev/null +++ b/pkg/mount/mountinfo_linux.go @@ -0,0 +1,95 @@ +// +build linux + +package mount + +import ( + "bufio" + "fmt" + "io" + "os" + "strings" +) + +const ( + /* 36 35 98:0 /mnt1 /mnt2 rw,noatime master:1 - ext3 /dev/root rw,errors=continue + (1)(2)(3) (4) (5) (6) (7) (8) (9) (10) (11) + + (1) mount ID: unique identifier of the mount (may be reused after umount) + (2) parent ID: ID of parent (or of self for the top of the mount tree) + (3) major:minor: value of st_dev for files on filesystem + (4) root: root of the mount within the filesystem + (5) mount point: mount point relative to the process's root + (6) mount options: per mount options + (7) optional fields: zero or more fields of the form "tag[:value]" + (8) separator: marks the end of the optional fields + (9) filesystem type: name of filesystem of the form "type[.subtype]" + (10) mount source: filesystem specific information or "none" + (11) super options: per super block options*/ + mountinfoFormat = "%d %d %d:%d %s %s %s %s" +) + +// Parse /proc/self/mountinfo because comparing Dev and ino does not work from +// bind mounts +func parseMountTable() ([]*Info, error) { + f, err := os.Open("/proc/self/mountinfo") + if err != nil { + return nil, err + } + defer f.Close() + + return parseInfoFile(f) +} + +func parseInfoFile(r io.Reader) ([]*Info, error) { + var ( + s = bufio.NewScanner(r) + out = []*Info{} + ) + + for s.Scan() { + if err := s.Err(); err != nil { + return nil, err + } + + var ( + p = &Info{} + text = s.Text() + optionalFields string + ) + + if _, err := fmt.Sscanf(text, mountinfoFormat, + &p.ID, &p.Parent, &p.Major, &p.Minor, + &p.Root, &p.Mountpoint, &p.Opts, &optionalFields); err != nil { + return nil, fmt.Errorf("Scanning '%s' failed: %s", text, err) + } + // Safe as mountinfo encodes mountpoints with spaces as \040. + index := strings.Index(text, " - ") + postSeparatorFields := strings.Fields(text[index+3:]) + if len(postSeparatorFields) < 3 { + return nil, fmt.Errorf("Error found less than 3 fields post '-' in %q", text) + } + + if optionalFields != "-" { + p.Optional = optionalFields + } + + p.Fstype = postSeparatorFields[0] + p.Source = postSeparatorFields[1] + p.VfsOpts = strings.Join(postSeparatorFields[2:], " ") + out = append(out, p) + } + return out, nil +} + +// PidMountInfo collects the mounts for a specific process ID. If the process +// ID is unknown, it is better to use `GetMounts` which will inspect +// "/proc/self/mountinfo" instead. +func PidMountInfo(pid int) ([]*Info, error) { + f, err := os.Open(fmt.Sprintf("/proc/%d/mountinfo", pid)) + if err != nil { + return nil, err + } + defer f.Close() + + return parseInfoFile(f) +} diff --git a/pkg/mount/mountinfo_linux_test.go b/pkg/mount/mountinfo_linux_test.go new file mode 100644 index 0000000000..812d12e826 --- /dev/null +++ b/pkg/mount/mountinfo_linux_test.go @@ -0,0 +1,477 @@ +// +build linux + +package mount + +import ( + "bytes" + "testing" +) + +const ( + fedoraMountinfo = `15 35 0:3 / /proc rw,nosuid,nodev,noexec,relatime shared:5 - proc proc rw + 16 35 0:14 / /sys rw,nosuid,nodev,noexec,relatime shared:6 - sysfs sysfs rw,seclabel + 17 35 0:5 / /dev rw,nosuid shared:2 - devtmpfs devtmpfs rw,seclabel,size=8056484k,nr_inodes=2014121,mode=755 + 18 16 0:15 / /sys/kernel/security rw,nosuid,nodev,noexec,relatime shared:7 - securityfs securityfs rw + 19 16 0:13 / /sys/fs/selinux rw,relatime shared:8 - selinuxfs selinuxfs rw + 20 17 0:16 / /dev/shm rw,nosuid,nodev shared:3 - tmpfs tmpfs rw,seclabel + 21 17 0:10 / /dev/pts rw,nosuid,noexec,relatime shared:4 - devpts devpts rw,seclabel,gid=5,mode=620,ptmxmode=000 + 22 35 0:17 / /run rw,nosuid,nodev shared:21 - tmpfs tmpfs rw,seclabel,mode=755 + 23 16 0:18 / /sys/fs/cgroup rw,nosuid,nodev,noexec shared:9 - tmpfs tmpfs rw,seclabel,mode=755 + 24 23 0:19 / /sys/fs/cgroup/systemd rw,nosuid,nodev,noexec,relatime shared:10 - cgroup cgroup rw,xattr,release_agent=/usr/lib/systemd/systemd-cgroups-agent,name=systemd + 25 16 0:20 / /sys/fs/pstore rw,nosuid,nodev,noexec,relatime shared:20 - pstore pstore rw + 26 23 0:21 / /sys/fs/cgroup/cpuset rw,nosuid,nodev,noexec,relatime shared:11 - cgroup cgroup rw,cpuset,clone_children + 27 23 0:22 / /sys/fs/cgroup/cpu,cpuacct rw,nosuid,nodev,noexec,relatime shared:12 - cgroup cgroup rw,cpuacct,cpu,clone_children + 28 23 0:23 / /sys/fs/cgroup/memory rw,nosuid,nodev,noexec,relatime shared:13 - cgroup cgroup rw,memory,clone_children + 29 23 0:24 / /sys/fs/cgroup/devices rw,nosuid,nodev,noexec,relatime shared:14 - cgroup cgroup rw,devices,clone_children + 30 23 0:25 / /sys/fs/cgroup/freezer rw,nosuid,nodev,noexec,relatime shared:15 - cgroup cgroup rw,freezer,clone_children + 31 23 0:26 / /sys/fs/cgroup/net_cls rw,nosuid,nodev,noexec,relatime shared:16 - cgroup cgroup rw,net_cls,clone_children + 32 23 0:27 / /sys/fs/cgroup/blkio rw,nosuid,nodev,noexec,relatime shared:17 - cgroup cgroup rw,blkio,clone_children + 33 23 0:28 / /sys/fs/cgroup/perf_event rw,nosuid,nodev,noexec,relatime shared:18 - cgroup cgroup rw,perf_event,clone_children + 34 23 0:29 / /sys/fs/cgroup/hugetlb rw,nosuid,nodev,noexec,relatime shared:19 - cgroup cgroup rw,hugetlb,clone_children + 35 1 253:2 / / rw,relatime shared:1 - ext4 /dev/mapper/ssd-root--f20 rw,seclabel,data=ordered + 36 15 0:30 / /proc/sys/fs/binfmt_misc rw,relatime shared:22 - autofs systemd-1 rw,fd=38,pgrp=1,timeout=300,minproto=5,maxproto=5,direct + 37 17 0:12 / /dev/mqueue rw,relatime shared:23 - mqueue mqueue rw,seclabel + 38 35 0:31 / /tmp rw shared:24 - tmpfs tmpfs rw,seclabel + 39 17 0:32 / /dev/hugepages rw,relatime shared:25 - hugetlbfs hugetlbfs rw,seclabel + 40 16 0:7 / /sys/kernel/debug rw,relatime shared:26 - debugfs debugfs rw + 41 16 0:33 / /sys/kernel/config rw,relatime shared:27 - configfs configfs rw + 42 35 0:34 / /var/lib/nfs/rpc_pipefs rw,relatime shared:28 - rpc_pipefs sunrpc rw + 43 15 0:35 / /proc/fs/nfsd rw,relatime shared:29 - nfsd sunrpc rw + 45 35 8:17 / /boot rw,relatime shared:30 - ext4 /dev/sdb1 rw,seclabel,data=ordered + 46 35 253:4 / /home rw,relatime shared:31 - ext4 /dev/mapper/ssd-home rw,seclabel,data=ordered + 47 35 253:5 / /var/lib/libvirt/images rw,noatime,nodiratime shared:32 - ext4 /dev/mapper/ssd-virt rw,seclabel,discard,data=ordered + 48 35 253:12 / /mnt/old rw,relatime shared:33 - ext4 /dev/mapper/HelpDeskRHEL6-FedoraRoot rw,seclabel,data=ordered + 121 22 0:36 / /run/user/1000/gvfs rw,nosuid,nodev,relatime shared:104 - fuse.gvfsd-fuse gvfsd-fuse rw,user_id=1000,group_id=1000 + 124 16 0:37 / /sys/fs/fuse/connections rw,relatime shared:107 - fusectl fusectl rw + 165 38 253:3 / /tmp/mnt rw,relatime shared:147 - ext4 /dev/mapper/ssd-root rw,seclabel,data=ordered + 167 35 253:15 / /var/lib/docker/devicemapper/mnt/aae4076022f0e2b80a2afbf8fc6df450c52080191fcef7fb679a73e6f073e5c2 rw,relatime shared:149 - ext4 /dev/mapper/docker-253:2-425882-aae4076022f0e2b80a2afbf8fc6df450c52080191fcef7fb679a73e6f073e5c2 rw,seclabel,discard,stripe=16,data=ordered + 171 35 253:16 / /var/lib/docker/devicemapper/mnt/c71be651f114db95180e472f7871b74fa597ee70a58ccc35cb87139ddea15373 rw,relatime shared:153 - ext4 /dev/mapper/docker-253:2-425882-c71be651f114db95180e472f7871b74fa597ee70a58ccc35cb87139ddea15373 rw,seclabel,discard,stripe=16,data=ordered + 175 35 253:17 / /var/lib/docker/devicemapper/mnt/1bac6ab72862d2d5626560df6197cf12036b82e258c53d981fa29adce6f06c3c rw,relatime shared:157 - ext4 /dev/mapper/docker-253:2-425882-1bac6ab72862d2d5626560df6197cf12036b82e258c53d981fa29adce6f06c3c rw,seclabel,discard,stripe=16,data=ordered + 179 35 253:18 / /var/lib/docker/devicemapper/mnt/d710a357d77158e80d5b2c55710ae07c94e76d34d21ee7bae65ce5418f739b09 rw,relatime shared:161 - ext4 /dev/mapper/docker-253:2-425882-d710a357d77158e80d5b2c55710ae07c94e76d34d21ee7bae65ce5418f739b09 rw,seclabel,discard,stripe=16,data=ordered + 183 35 253:19 / /var/lib/docker/devicemapper/mnt/6479f52366114d5f518db6837254baab48fab39f2ac38d5099250e9a6ceae6c7 rw,relatime shared:165 - ext4 /dev/mapper/docker-253:2-425882-6479f52366114d5f518db6837254baab48fab39f2ac38d5099250e9a6ceae6c7 rw,seclabel,discard,stripe=16,data=ordered + 187 35 253:20 / /var/lib/docker/devicemapper/mnt/8d9df91c4cca5aef49eeb2725292aab324646f723a7feab56be34c2ad08268e1 rw,relatime shared:169 - ext4 /dev/mapper/docker-253:2-425882-8d9df91c4cca5aef49eeb2725292aab324646f723a7feab56be34c2ad08268e1 rw,seclabel,discard,stripe=16,data=ordered + 191 35 253:21 / /var/lib/docker/devicemapper/mnt/c8240b768603d32e920d365dc9d1dc2a6af46cd23e7ae819947f969e1b4ec661 rw,relatime shared:173 - ext4 /dev/mapper/docker-253:2-425882-c8240b768603d32e920d365dc9d1dc2a6af46cd23e7ae819947f969e1b4ec661 rw,seclabel,discard,stripe=16,data=ordered + 195 35 253:22 / /var/lib/docker/devicemapper/mnt/2eb3a01278380bbf3ed12d86ac629eaa70a4351301ee307a5cabe7b5f3b1615f rw,relatime shared:177 - ext4 /dev/mapper/docker-253:2-425882-2eb3a01278380bbf3ed12d86ac629eaa70a4351301ee307a5cabe7b5f3b1615f rw,seclabel,discard,stripe=16,data=ordered + 199 35 253:23 / /var/lib/docker/devicemapper/mnt/37a17fb7c9d9b80821235d5f2662879bd3483915f245f9b49cdaa0e38779b70b rw,relatime shared:181 - ext4 /dev/mapper/docker-253:2-425882-37a17fb7c9d9b80821235d5f2662879bd3483915f245f9b49cdaa0e38779b70b rw,seclabel,discard,stripe=16,data=ordered + 203 35 253:24 / /var/lib/docker/devicemapper/mnt/aea459ae930bf1de913e2f29428fd80ee678a1e962d4080019d9f9774331ee2b rw,relatime shared:185 - ext4 /dev/mapper/docker-253:2-425882-aea459ae930bf1de913e2f29428fd80ee678a1e962d4080019d9f9774331ee2b rw,seclabel,discard,stripe=16,data=ordered + 207 35 253:25 / /var/lib/docker/devicemapper/mnt/928ead0bc06c454bd9f269e8585aeae0a6bd697f46dc8754c2a91309bc810882 rw,relatime shared:189 - ext4 /dev/mapper/docker-253:2-425882-928ead0bc06c454bd9f269e8585aeae0a6bd697f46dc8754c2a91309bc810882 rw,seclabel,discard,stripe=16,data=ordered + 211 35 253:26 / /var/lib/docker/devicemapper/mnt/0f284d18481d671644706e7a7244cbcf63d590d634cc882cb8721821929d0420 rw,relatime shared:193 - ext4 /dev/mapper/docker-253:2-425882-0f284d18481d671644706e7a7244cbcf63d590d634cc882cb8721821929d0420 rw,seclabel,discard,stripe=16,data=ordered + 215 35 253:27 / /var/lib/docker/devicemapper/mnt/d9dd16722ab34c38db2733e23f69e8f4803ce59658250dd63e98adff95d04919 rw,relatime shared:197 - ext4 /dev/mapper/docker-253:2-425882-d9dd16722ab34c38db2733e23f69e8f4803ce59658250dd63e98adff95d04919 rw,seclabel,discard,stripe=16,data=ordered + 219 35 253:28 / /var/lib/docker/devicemapper/mnt/bc4500479f18c2c08c21ad5282e5f826a016a386177d9874c2764751c031d634 rw,relatime shared:201 - ext4 /dev/mapper/docker-253:2-425882-bc4500479f18c2c08c21ad5282e5f826a016a386177d9874c2764751c031d634 rw,seclabel,discard,stripe=16,data=ordered + 223 35 253:29 / /var/lib/docker/devicemapper/mnt/7770c8b24eb3d5cc159a065910076938910d307ab2f5d94e1dc3b24c06ee2c8a rw,relatime shared:205 - ext4 /dev/mapper/docker-253:2-425882-7770c8b24eb3d5cc159a065910076938910d307ab2f5d94e1dc3b24c06ee2c8a rw,seclabel,discard,stripe=16,data=ordered + 227 35 253:30 / /var/lib/docker/devicemapper/mnt/c280cd3d0bf0aa36b478b292279671624cceafc1a67eaa920fa1082601297adf rw,relatime shared:209 - ext4 /dev/mapper/docker-253:2-425882-c280cd3d0bf0aa36b478b292279671624cceafc1a67eaa920fa1082601297adf rw,seclabel,discard,stripe=16,data=ordered + 231 35 253:31 / /var/lib/docker/devicemapper/mnt/8b59a7d9340279f09fea67fd6ad89ddef711e9e7050eb647984f8b5ef006335f rw,relatime shared:213 - ext4 /dev/mapper/docker-253:2-425882-8b59a7d9340279f09fea67fd6ad89ddef711e9e7050eb647984f8b5ef006335f rw,seclabel,discard,stripe=16,data=ordered + 235 35 253:32 / /var/lib/docker/devicemapper/mnt/1a28059f29eda821578b1bb27a60cc71f76f846a551abefabce6efd0146dce9f rw,relatime shared:217 - ext4 /dev/mapper/docker-253:2-425882-1a28059f29eda821578b1bb27a60cc71f76f846a551abefabce6efd0146dce9f rw,seclabel,discard,stripe=16,data=ordered + 239 35 253:33 / /var/lib/docker/devicemapper/mnt/e9aa60c60128cad1 rw,relatime shared:221 - ext4 /dev/mapper/docker-253:2-425882-e9aa60c60128cad1 rw,seclabel,discard,stripe=16,data=ordered + 243 35 253:34 / /var/lib/docker/devicemapper/mnt/5fec11304b6f4713fea7b6ccdcc1adc0a1966187f590fe25a8227428a8df275d-init rw,relatime shared:225 - ext4 /dev/mapper/docker-253:2-425882-5fec11304b6f4713fea7b6ccdcc1adc0a1966187f590fe25a8227428a8df275d-init rw,seclabel,discard,stripe=16,data=ordered + 247 35 253:35 / /var/lib/docker/devicemapper/mnt/5fec11304b6f4713fea7b6ccdcc1adc0a1966187f590fe25a8227428a8df275d rw,relatime shared:229 - ext4 /dev/mapper/docker-253:2-425882-5fec11304b6f4713fea7b6ccdcc1adc0a1966187f590fe25a8227428a8df275d rw,seclabel,discard,stripe=16,data=ordered + 31 21 0:23 / /DATA/foo_bla_bla rw,relatime - cifs //foo/BLA\040BLA\040BLA/ rw,sec=ntlm,cache=loose,unc=\\foo\BLA BLA BLA,username=my_login,domain=mydomain.com,uid=12345678,forceuid,gid=12345678,forcegid,addr=10.1.30.10,file_mode=0755,dir_mode=0755,nounix,rsize=61440,wsize=65536,actimeo=1` + + ubuntuMountInfo = `15 20 0:14 / /sys rw,nosuid,nodev,noexec,relatime - sysfs sysfs rw +16 20 0:3 / /proc rw,nosuid,nodev,noexec,relatime - proc proc rw +17 20 0:5 / /dev rw,relatime - devtmpfs udev rw,size=1015140k,nr_inodes=253785,mode=755 +18 17 0:11 / /dev/pts rw,nosuid,noexec,relatime - devpts devpts rw,gid=5,mode=620,ptmxmode=000 +19 20 0:15 / /run rw,nosuid,noexec,relatime - tmpfs tmpfs rw,size=205044k,mode=755 +20 1 253:0 / / rw,relatime - ext4 /dev/disk/by-label/DOROOT rw,errors=remount-ro,data=ordered +21 15 0:16 / /sys/fs/cgroup rw,relatime - tmpfs none rw,size=4k,mode=755 +22 15 0:17 / /sys/fs/fuse/connections rw,relatime - fusectl none rw +23 15 0:6 / /sys/kernel/debug rw,relatime - debugfs none rw +24 15 0:10 / /sys/kernel/security rw,relatime - securityfs none rw +25 19 0:18 / /run/lock rw,nosuid,nodev,noexec,relatime - tmpfs none rw,size=5120k +26 21 0:19 / /sys/fs/cgroup/cpuset rw,relatime - cgroup cgroup rw,cpuset,clone_children +27 19 0:20 / /run/shm rw,nosuid,nodev,relatime - tmpfs none rw +28 21 0:21 / /sys/fs/cgroup/cpu rw,relatime - cgroup cgroup rw,cpu +29 19 0:22 / /run/user rw,nosuid,nodev,noexec,relatime - tmpfs none rw,size=102400k,mode=755 +30 15 0:23 / /sys/fs/pstore rw,relatime - pstore none rw +31 21 0:24 / /sys/fs/cgroup/cpuacct rw,relatime - cgroup cgroup rw,cpuacct +32 21 0:25 / /sys/fs/cgroup/memory rw,relatime - cgroup cgroup rw,memory +33 21 0:26 / /sys/fs/cgroup/devices rw,relatime - cgroup cgroup rw,devices +34 21 0:27 / /sys/fs/cgroup/freezer rw,relatime - cgroup cgroup rw,freezer +35 21 0:28 / /sys/fs/cgroup/blkio rw,relatime - cgroup cgroup rw,blkio +36 21 0:29 / /sys/fs/cgroup/perf_event rw,relatime - cgroup cgroup rw,perf_event +37 21 0:30 / /sys/fs/cgroup/hugetlb rw,relatime - cgroup cgroup rw,hugetlb +38 21 0:31 / /sys/fs/cgroup/systemd rw,nosuid,nodev,noexec,relatime - cgroup systemd rw,name=systemd +39 20 0:32 / /var/lib/docker/aufs/mnt/b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc rw,relatime - aufs none rw,si=caafa54fdc06525 +40 20 0:33 / /var/lib/docker/aufs/mnt/2eed44ac7ce7c75af04f088ed6cb4ce9d164801e91d78c6db65d7ef6d572bba8-init rw,relatime - aufs none rw,si=caafa54f882b525 +41 20 0:34 / /var/lib/docker/aufs/mnt/2eed44ac7ce7c75af04f088ed6cb4ce9d164801e91d78c6db65d7ef6d572bba8 rw,relatime - aufs none rw,si=caafa54f8829525 +42 20 0:35 / /var/lib/docker/aufs/mnt/16f4d7e96dd612903f425bfe856762f291ff2e36a8ecd55a2209b7d7cd81c30b rw,relatime - aufs none rw,si=caafa54f882d525 +43 20 0:36 / /var/lib/docker/aufs/mnt/63ca08b75d7438a9469a5954e003f48ffede73541f6286ce1cb4d7dd4811da7e-init rw,relatime - aufs none rw,si=caafa54f882f525 +44 20 0:37 / /var/lib/docker/aufs/mnt/63ca08b75d7438a9469a5954e003f48ffede73541f6286ce1cb4d7dd4811da7e rw,relatime - aufs none rw,si=caafa54f88ba525 +45 20 0:38 / /var/lib/docker/aufs/mnt/283f35a910233c756409313be71ecd8fcfef0df57108b8d740b61b3e88860452 rw,relatime - aufs none rw,si=caafa54f88b8525 +46 20 0:39 / /var/lib/docker/aufs/mnt/2c6c7253d4090faa3886871fb21bd660609daeb0206588c0602007f7d0f254b1-init rw,relatime - aufs none rw,si=caafa54f88be525 +47 20 0:40 / /var/lib/docker/aufs/mnt/2c6c7253d4090faa3886871fb21bd660609daeb0206588c0602007f7d0f254b1 rw,relatime - aufs none rw,si=caafa54f882c525 +48 20 0:41 / /var/lib/docker/aufs/mnt/de2b538c97d6366cc80e8658547c923ea1d042f85580df379846f36a4df7049d rw,relatime - aufs none rw,si=caafa54f85bb525 +49 20 0:42 / /var/lib/docker/aufs/mnt/94a3d8ed7c27e5b0aa71eba46c736bfb2742afda038e74f2dd6035fb28415b49-init rw,relatime - aufs none rw,si=caafa54fdc00525 +50 20 0:43 / /var/lib/docker/aufs/mnt/94a3d8ed7c27e5b0aa71eba46c736bfb2742afda038e74f2dd6035fb28415b49 rw,relatime - aufs none rw,si=caafa54fbaec525 +51 20 0:44 / /var/lib/docker/aufs/mnt/6ac1cace985c9fc9bea32234de8b36dba49bdd5e29a2972b327ff939d78a6274 rw,relatime - aufs none rw,si=caafa54f8e1a525 +52 20 0:45 / /var/lib/docker/aufs/mnt/dff147033e3a0ef061e1de1ad34256b523d4a8c1fa6bba71a0ab538e8628ff0b-init rw,relatime - aufs none rw,si=caafa54f8e1d525 +53 20 0:46 / /var/lib/docker/aufs/mnt/dff147033e3a0ef061e1de1ad34256b523d4a8c1fa6bba71a0ab538e8628ff0b rw,relatime - aufs none rw,si=caafa54f8e1b525 +54 20 0:47 / /var/lib/docker/aufs/mnt/cabb117d997f0f93519185aea58389a9762770b7496ed0b74a3e4a083fa45902 rw,relatime - aufs none rw,si=caafa54f810a525 +55 20 0:48 / /var/lib/docker/aufs/mnt/e1c8a94ffaa9d532bbbdc6ef771ce8a6c2c06757806ecaf8b68e9108fec65f33-init rw,relatime - aufs none rw,si=caafa54f8529525 +56 20 0:49 / /var/lib/docker/aufs/mnt/e1c8a94ffaa9d532bbbdc6ef771ce8a6c2c06757806ecaf8b68e9108fec65f33 rw,relatime - aufs none rw,si=caafa54f852f525 +57 20 0:50 / /var/lib/docker/aufs/mnt/16a1526fa445b84ce84f89506d219e87fa488a814063baf045d88b02f21166b3 rw,relatime - aufs none rw,si=caafa54f9e1d525 +58 20 0:51 / /var/lib/docker/aufs/mnt/57b9c92e1e368fa7dbe5079f7462e917777829caae732828b003c355fe49da9f-init rw,relatime - aufs none rw,si=caafa54f854d525 +59 20 0:52 / /var/lib/docker/aufs/mnt/57b9c92e1e368fa7dbe5079f7462e917777829caae732828b003c355fe49da9f rw,relatime - aufs none rw,si=caafa54f854e525 +60 20 0:53 / /var/lib/docker/aufs/mnt/e370c3e286bea027917baa0e4d251262681a472a87056e880dfd0513516dffd9 rw,relatime - aufs none rw,si=caafa54f840a525 +61 20 0:54 / /var/lib/docker/aufs/mnt/6b00d3b4f32b41997ec07412b5e18204f82fbe643e7122251cdeb3582abd424e-init rw,relatime - aufs none rw,si=caafa54f8408525 +62 20 0:55 / /var/lib/docker/aufs/mnt/6b00d3b4f32b41997ec07412b5e18204f82fbe643e7122251cdeb3582abd424e rw,relatime - aufs none rw,si=caafa54f8409525 +63 20 0:56 / /var/lib/docker/aufs/mnt/abd0b5ea5d355a67f911475e271924a5388ee60c27185fcd60d095afc4a09dc7 rw,relatime - aufs none rw,si=caafa54f9eb1525 +64 20 0:57 / /var/lib/docker/aufs/mnt/336222effc3f7b89867bb39ff7792ae5412c35c749f127c29159d046b6feedd2-init rw,relatime - aufs none rw,si=caafa54f85bf525 +65 20 0:58 / /var/lib/docker/aufs/mnt/336222effc3f7b89867bb39ff7792ae5412c35c749f127c29159d046b6feedd2 rw,relatime - aufs none rw,si=caafa54f85b8525 +66 20 0:59 / /var/lib/docker/aufs/mnt/912e1bf28b80a09644503924a8a1a4fb8ed10b808ca847bda27a369919aa52fa rw,relatime - aufs none rw,si=caafa54fbaea525 +67 20 0:60 / /var/lib/docker/aufs/mnt/386f722875013b4a875118367abc783fc6617a3cb7cf08b2b4dcf550b4b9c576-init rw,relatime - aufs none rw,si=caafa54f8472525 +68 20 0:61 / /var/lib/docker/aufs/mnt/386f722875013b4a875118367abc783fc6617a3cb7cf08b2b4dcf550b4b9c576 rw,relatime - aufs none rw,si=caafa54f8474525 +69 20 0:62 / /var/lib/docker/aufs/mnt/5aaebb79ef3097dfca377889aeb61a0c9d5e3795117d2b08d0751473c671dfb2 rw,relatime - aufs none rw,si=caafa54f8c5e525 +70 20 0:63 / /var/lib/docker/aufs/mnt/5ba3e493279d01277d583600b81c7c079e691b73c3a2bdea8e4b12a35a418be2-init rw,relatime - aufs none rw,si=caafa54f8c3b525 +71 20 0:64 / /var/lib/docker/aufs/mnt/5ba3e493279d01277d583600b81c7c079e691b73c3a2bdea8e4b12a35a418be2 rw,relatime - aufs none rw,si=caafa54f8c3d525 +72 20 0:65 / /var/lib/docker/aufs/mnt/2777f0763da4de93f8bebbe1595cc77f739806a158657b033eca06f827b6028a rw,relatime - aufs none rw,si=caafa54f8c3e525 +73 20 0:66 / /var/lib/docker/aufs/mnt/5d7445562acf73c6f0ae34c3dd0921d7457de1ba92a587d9e06a44fa209eeb3e-init rw,relatime - aufs none rw,si=caafa54f8c39525 +74 20 0:67 / /var/lib/docker/aufs/mnt/5d7445562acf73c6f0ae34c3dd0921d7457de1ba92a587d9e06a44fa209eeb3e rw,relatime - aufs none rw,si=caafa54f854f525 +75 20 0:68 / /var/lib/docker/aufs/mnt/06400b526ec18b66639c96efc41a84f4ae0b117cb28dafd56be420651b4084a0 rw,relatime - aufs none rw,si=caafa54f840b525 +76 20 0:69 / /var/lib/docker/aufs/mnt/e051d45ec42d8e3e1cc57bb39871a40de486dc123522e9c067fbf2ca6a357785-init rw,relatime - aufs none rw,si=caafa54fdddf525 +77 20 0:70 / /var/lib/docker/aufs/mnt/e051d45ec42d8e3e1cc57bb39871a40de486dc123522e9c067fbf2ca6a357785 rw,relatime - aufs none rw,si=caafa54f854b525 +78 20 0:71 / /var/lib/docker/aufs/mnt/1ff414fa93fd61ec81b0ab7b365a841ff6545accae03cceac702833aaeaf718f rw,relatime - aufs none rw,si=caafa54f8d85525 +79 20 0:72 / /var/lib/docker/aufs/mnt/c661b2f871dd5360e46a2aebf8f970f6d39a2ff64e06979aa0361227c88128b8-init rw,relatime - aufs none rw,si=caafa54f8da3525 +80 20 0:73 / /var/lib/docker/aufs/mnt/c661b2f871dd5360e46a2aebf8f970f6d39a2ff64e06979aa0361227c88128b8 rw,relatime - aufs none rw,si=caafa54f8da2525 +81 20 0:74 / /var/lib/docker/aufs/mnt/b68b1d4fe4d30016c552398e78b379a39f651661d8e1fa5f2460c24a5e723420 rw,relatime - aufs none rw,si=caafa54f8d81525 +82 20 0:75 / /var/lib/docker/aufs/mnt/c5c5979c936cd0153a4c626fa9d69ce4fce7d924cc74fa68b025d2f585031739-init rw,relatime - aufs none rw,si=caafa54f8da1525 +83 20 0:76 / /var/lib/docker/aufs/mnt/c5c5979c936cd0153a4c626fa9d69ce4fce7d924cc74fa68b025d2f585031739 rw,relatime - aufs none rw,si=caafa54f8da0525 +84 20 0:77 / /var/lib/docker/aufs/mnt/53e10b0329afc0e0d3322d31efaed4064139dc7027fe6ae445cffd7104bcc94f rw,relatime - aufs none rw,si=caafa54f8c35525 +85 20 0:78 / /var/lib/docker/aufs/mnt/3bfafd09ff2603e2165efacc2215c1f51afabba6c42d04a68cc2df0e8cc31494-init rw,relatime - aufs none rw,si=caafa54f8db8525 +86 20 0:79 / /var/lib/docker/aufs/mnt/3bfafd09ff2603e2165efacc2215c1f51afabba6c42d04a68cc2df0e8cc31494 rw,relatime - aufs none rw,si=caafa54f8dba525 +87 20 0:80 / /var/lib/docker/aufs/mnt/90fdd2c03eeaf65311f88f4200e18aef6d2772482712d9aea01cd793c64781b5 rw,relatime - aufs none rw,si=caafa54f8315525 +88 20 0:81 / /var/lib/docker/aufs/mnt/7bdf2591c06c154ceb23f5e74b1d03b18fbf6fe96e35fbf539b82d446922442f-init rw,relatime - aufs none rw,si=caafa54f8fc6525 +89 20 0:82 / /var/lib/docker/aufs/mnt/7bdf2591c06c154ceb23f5e74b1d03b18fbf6fe96e35fbf539b82d446922442f rw,relatime - aufs none rw,si=caafa54f8468525 +90 20 0:83 / /var/lib/docker/aufs/mnt/8cf9a993f50f3305abad3da268c0fc44ff78a1e7bba595ef9de963497496c3f9 rw,relatime - aufs none rw,si=caafa54f8c59525 +91 20 0:84 / /var/lib/docker/aufs/mnt/ecc896fd74b21840a8d35e8316b92a08b1b9c83d722a12acff847e9f0ff17173-init rw,relatime - aufs none rw,si=caafa54f846a525 +92 20 0:85 / /var/lib/docker/aufs/mnt/ecc896fd74b21840a8d35e8316b92a08b1b9c83d722a12acff847e9f0ff17173 rw,relatime - aufs none rw,si=caafa54f846b525 +93 20 0:86 / /var/lib/docker/aufs/mnt/d8c8288ec920439a48b5796bab5883ee47a019240da65e8d8f33400c31bac5df rw,relatime - aufs none rw,si=caafa54f8dbf525 +94 20 0:87 / /var/lib/docker/aufs/mnt/ecba66710bcd03199b9398e46c005cd6b68d0266ec81dc8b722a29cc417997c6-init rw,relatime - aufs none rw,si=caafa54f810f525 +95 20 0:88 / /var/lib/docker/aufs/mnt/ecba66710bcd03199b9398e46c005cd6b68d0266ec81dc8b722a29cc417997c6 rw,relatime - aufs none rw,si=caafa54fbae9525 +96 20 0:89 / /var/lib/docker/aufs/mnt/befc1c67600df449dddbe796c0d06da7caff1d2bbff64cde1f0ba82d224996b5 rw,relatime - aufs none rw,si=caafa54f8dab525 +97 20 0:90 / /var/lib/docker/aufs/mnt/c9f470e73d2742629cdc4084a1b2c1a8302914f2aa0d0ec4542371df9a050562-init rw,relatime - aufs none rw,si=caafa54fdc02525 +98 20 0:91 / /var/lib/docker/aufs/mnt/c9f470e73d2742629cdc4084a1b2c1a8302914f2aa0d0ec4542371df9a050562 rw,relatime - aufs none rw,si=caafa54f9eb0525 +99 20 0:92 / /var/lib/docker/aufs/mnt/2a31f10029f04ff9d4381167a9b739609853d7220d55a56cb654779a700ee246 rw,relatime - aufs none rw,si=caafa54f8c37525 +100 20 0:93 / /var/lib/docker/aufs/mnt/8c4261b8e3e4b21ebba60389bd64b6261217e7e6b9fd09e201d5a7f6760f6927-init rw,relatime - aufs none rw,si=caafa54fd173525 +101 20 0:94 / /var/lib/docker/aufs/mnt/8c4261b8e3e4b21ebba60389bd64b6261217e7e6b9fd09e201d5a7f6760f6927 rw,relatime - aufs none rw,si=caafa54f8108525 +102 20 0:95 / /var/lib/docker/aufs/mnt/eaa0f57403a3dc685268f91df3fbcd7a8423cee50e1a9ee5c3e1688d9d676bb4 rw,relatime - aufs none rw,si=caafa54f852d525 +103 20 0:96 / /var/lib/docker/aufs/mnt/9cfe69a2cbffd9bfc7f396d4754f6fe5cc457ef417b277797be3762dfe955a6b-init rw,relatime - aufs none rw,si=caafa54f8d80525 +104 20 0:97 / /var/lib/docker/aufs/mnt/9cfe69a2cbffd9bfc7f396d4754f6fe5cc457ef417b277797be3762dfe955a6b rw,relatime - aufs none rw,si=caafa54f8fc3525 +105 20 0:98 / /var/lib/docker/aufs/mnt/d1b322ae17613c6adee84e709641a9244ac56675244a89a64dc0075075fcbb83 rw,relatime - aufs none rw,si=caafa54f8c58525 +106 20 0:99 / /var/lib/docker/aufs/mnt/d46c2a8e9da7e91ab34fd9c192851c246a4e770a46720bda09e55c7554b9dbbd-init rw,relatime - aufs none rw,si=caafa54f8c63525 +107 20 0:100 / /var/lib/docker/aufs/mnt/d46c2a8e9da7e91ab34fd9c192851c246a4e770a46720bda09e55c7554b9dbbd rw,relatime - aufs none rw,si=caafa54f8c67525 +108 20 0:101 / /var/lib/docker/aufs/mnt/bc9d2a264158f83a617a069bf17cbbf2a2ba453db7d3951d9dc63cc1558b1c2b rw,relatime - aufs none rw,si=caafa54f8dbe525 +109 20 0:102 / /var/lib/docker/aufs/mnt/9e6abb8d72bbeb4d5cf24b96018528015ba830ce42b4859965bd482cbd034e99-init rw,relatime - aufs none rw,si=caafa54f9e0d525 +110 20 0:103 / /var/lib/docker/aufs/mnt/9e6abb8d72bbeb4d5cf24b96018528015ba830ce42b4859965bd482cbd034e99 rw,relatime - aufs none rw,si=caafa54f9e1b525 +111 20 0:104 / /var/lib/docker/aufs/mnt/d4dca7b02569c732e740071e1c654d4ad282de5c41edb619af1f0aafa618be26 rw,relatime - aufs none rw,si=caafa54f8dae525 +112 20 0:105 / /var/lib/docker/aufs/mnt/fea63da40fa1c5ffbad430dde0bc64a8fc2edab09a051fff55b673c40a08f6b7-init rw,relatime - aufs none rw,si=caafa54f8c5c525 +113 20 0:106 / /var/lib/docker/aufs/mnt/fea63da40fa1c5ffbad430dde0bc64a8fc2edab09a051fff55b673c40a08f6b7 rw,relatime - aufs none rw,si=caafa54fd172525 +114 20 0:107 / /var/lib/docker/aufs/mnt/e60c57499c0b198a6734f77f660cdbbd950a5b78aa23f470ca4f0cfcc376abef rw,relatime - aufs none rw,si=caafa54909c4525 +115 20 0:108 / /var/lib/docker/aufs/mnt/099c78e7ccd9c8717471bb1bbfff838c0a9913321ba2f214fbeaf92c678e5b35-init rw,relatime - aufs none rw,si=caafa54909c3525 +116 20 0:109 / /var/lib/docker/aufs/mnt/099c78e7ccd9c8717471bb1bbfff838c0a9913321ba2f214fbeaf92c678e5b35 rw,relatime - aufs none rw,si=caafa54909c7525 +117 20 0:110 / /var/lib/docker/aufs/mnt/2997be666d58b9e71469759bcb8bd9608dad0e533a1a7570a896919ba3388825 rw,relatime - aufs none rw,si=caafa54f8557525 +118 20 0:111 / /var/lib/docker/aufs/mnt/730694eff438ef20569df38dfb38a920969d7ff2170cc9aa7cb32a7ed8147a93-init rw,relatime - aufs none rw,si=caafa54c6e88525 +119 20 0:112 / /var/lib/docker/aufs/mnt/730694eff438ef20569df38dfb38a920969d7ff2170cc9aa7cb32a7ed8147a93 rw,relatime - aufs none rw,si=caafa54c6e8e525 +120 20 0:113 / /var/lib/docker/aufs/mnt/a672a1e2f2f051f6e19ed1dfbe80860a2d774174c49f7c476695f5dd1d5b2f67 rw,relatime - aufs none rw,si=caafa54c6e15525 +121 20 0:114 / /var/lib/docker/aufs/mnt/aba3570e17859f76cf29d282d0d150659c6bd80780fdc52a465ba05245c2a420-init rw,relatime - aufs none rw,si=caafa54f8dad525 +122 20 0:115 / /var/lib/docker/aufs/mnt/aba3570e17859f76cf29d282d0d150659c6bd80780fdc52a465ba05245c2a420 rw,relatime - aufs none rw,si=caafa54f8d84525 +123 20 0:116 / /var/lib/docker/aufs/mnt/2abc86007aca46fb4a817a033e2a05ccacae40b78ea4b03f8ea616b9ada40e2e rw,relatime - aufs none rw,si=caafa54c6e8b525 +124 20 0:117 / /var/lib/docker/aufs/mnt/36352f27f7878e648367a135bd1ec3ed497adcb8ac13577ee892a0bd921d2374-init rw,relatime - aufs none rw,si=caafa54c6e8d525 +125 20 0:118 / /var/lib/docker/aufs/mnt/36352f27f7878e648367a135bd1ec3ed497adcb8ac13577ee892a0bd921d2374 rw,relatime - aufs none rw,si=caafa54f8c34525 +126 20 0:119 / /var/lib/docker/aufs/mnt/2f95ca1a629cea8363b829faa727dd52896d5561f2c96ddee4f697ea2fc872c2 rw,relatime - aufs none rw,si=caafa54c6e8a525 +127 20 0:120 / /var/lib/docker/aufs/mnt/f108c8291654f179ef143a3e07de2b5a34adbc0b28194a0ab17742b6db9a7fb2-init rw,relatime - aufs none rw,si=caafa54f8e19525 +128 20 0:121 / /var/lib/docker/aufs/mnt/f108c8291654f179ef143a3e07de2b5a34adbc0b28194a0ab17742b6db9a7fb2 rw,relatime - aufs none rw,si=caafa54fa8c6525 +129 20 0:122 / /var/lib/docker/aufs/mnt/c1d04dfdf8cccb3676d5a91e84e9b0781ce40623d127d038bcfbe4c761b27401 rw,relatime - aufs none rw,si=caafa54f8c30525 +130 20 0:123 / /var/lib/docker/aufs/mnt/3f4898ffd0e1239aeebf1d1412590cdb7254207fa3883663e2c40cf772e5f05a-init rw,relatime - aufs none rw,si=caafa54c6e1a525 +131 20 0:124 / /var/lib/docker/aufs/mnt/3f4898ffd0e1239aeebf1d1412590cdb7254207fa3883663e2c40cf772e5f05a rw,relatime - aufs none rw,si=caafa54c6e1c525 +132 20 0:125 / /var/lib/docker/aufs/mnt/5ae3b6fccb1539fc02d420e86f3e9637bef5b711fed2ca31a2f426c8f5deddbf rw,relatime - aufs none rw,si=caafa54c4fea525 +133 20 0:126 / /var/lib/docker/aufs/mnt/310bfaf80d57020f2e73b06aeffb0b9b0ca2f54895f88bf5e4d1529ccac58fe0-init rw,relatime - aufs none rw,si=caafa54c6e1e525 +134 20 0:127 / /var/lib/docker/aufs/mnt/310bfaf80d57020f2e73b06aeffb0b9b0ca2f54895f88bf5e4d1529ccac58fe0 rw,relatime - aufs none rw,si=caafa54fa8c0525 +135 20 0:128 / /var/lib/docker/aufs/mnt/f382bd5aaccaf2d04a59089ac7cb12ec87efd769fd0c14d623358fbfd2a3f896 rw,relatime - aufs none rw,si=caafa54c4fec525 +136 20 0:129 / /var/lib/docker/aufs/mnt/50d45e9bb2d779bc6362824085564c7578c231af5ae3b3da116acf7e17d00735-init rw,relatime - aufs none rw,si=caafa54c4fef525 +137 20 0:130 / /var/lib/docker/aufs/mnt/50d45e9bb2d779bc6362824085564c7578c231af5ae3b3da116acf7e17d00735 rw,relatime - aufs none rw,si=caafa54c4feb525 +138 20 0:131 / /var/lib/docker/aufs/mnt/a9c5ee0854dc083b6bf62b7eb1e5291aefbb10702289a446471ce73aba0d5d7d rw,relatime - aufs none rw,si=caafa54909c6525 +139 20 0:134 / /var/lib/docker/aufs/mnt/03a613e7bd5078819d1fd92df4e671c0127559a5e0b5a885cc8d5616875162f0-init rw,relatime - aufs none rw,si=caafa54804fe525 +140 20 0:135 / /var/lib/docker/aufs/mnt/03a613e7bd5078819d1fd92df4e671c0127559a5e0b5a885cc8d5616875162f0 rw,relatime - aufs none rw,si=caafa54804fa525 +141 20 0:136 / /var/lib/docker/aufs/mnt/7ec3277e5c04c907051caf9c9c35889f5fcd6463e5485971b25404566830bb70 rw,relatime - aufs none rw,si=caafa54804f9525 +142 20 0:139 / /var/lib/docker/aufs/mnt/26b5b5d71d79a5b2bfcf8bc4b2280ee829f261eb886745dd90997ed410f7e8b8-init rw,relatime - aufs none rw,si=caafa54c6ef6525 +143 20 0:140 / /var/lib/docker/aufs/mnt/26b5b5d71d79a5b2bfcf8bc4b2280ee829f261eb886745dd90997ed410f7e8b8 rw,relatime - aufs none rw,si=caafa54c6ef5525 +144 20 0:356 / /var/lib/docker/aufs/mnt/e6ecde9e2c18cd3c75f424c67b6d89685cfee0fc67abf2cb6bdc0867eb998026 rw,relatime - aufs none rw,si=caafa548068e525` + + gentooMountinfo = `15 1 8:6 / / rw,noatime,nodiratime - ext4 /dev/sda6 rw,data=ordered +16 15 0:3 / /proc rw,nosuid,nodev,noexec,relatime - proc proc rw +17 15 0:14 / /run rw,nosuid,nodev,relatime - tmpfs tmpfs rw,size=3292172k,mode=755 +18 15 0:5 / /dev rw,nosuid,relatime - devtmpfs udev rw,size=10240k,nr_inodes=4106451,mode=755 +19 18 0:12 / /dev/mqueue rw,nosuid,nodev,noexec,relatime - mqueue mqueue rw +20 18 0:10 / /dev/pts rw,nosuid,noexec,relatime - devpts devpts rw,gid=5,mode=620,ptmxmode=000 +21 18 0:15 / /dev/shm rw,nosuid,nodev,noexec,relatime - tmpfs shm rw +22 15 0:16 / /sys rw,nosuid,nodev,noexec,relatime - sysfs sysfs rw +23 22 0:7 / /sys/kernel/debug rw,nosuid,nodev,noexec,relatime - debugfs debugfs rw +24 22 0:17 / /sys/fs/cgroup rw,nosuid,nodev,noexec,relatime - tmpfs cgroup_root rw,size=10240k,mode=755 +25 24 0:18 / /sys/fs/cgroup/openrc rw,nosuid,nodev,noexec,relatime - cgroup openrc rw,release_agent=/lib64/rc/sh/cgroup-release-agent.sh,name=openrc +26 24 0:19 / /sys/fs/cgroup/cpuset rw,nosuid,nodev,noexec,relatime - cgroup cpuset rw,cpuset,clone_children +27 24 0:20 / /sys/fs/cgroup/cpu rw,nosuid,nodev,noexec,relatime - cgroup cpu rw,cpu,clone_children +28 24 0:21 / /sys/fs/cgroup/cpuacct rw,nosuid,nodev,noexec,relatime - cgroup cpuacct rw,cpuacct,clone_children +29 24 0:22 / /sys/fs/cgroup/memory rw,nosuid,nodev,noexec,relatime - cgroup memory rw,memory,clone_children +30 24 0:23 / /sys/fs/cgroup/devices rw,nosuid,nodev,noexec,relatime - cgroup devices rw,devices,clone_children +31 24 0:24 / /sys/fs/cgroup/freezer rw,nosuid,nodev,noexec,relatime - cgroup freezer rw,freezer,clone_children +32 24 0:25 / /sys/fs/cgroup/blkio rw,nosuid,nodev,noexec,relatime - cgroup blkio rw,blkio,clone_children +33 15 8:1 / /boot rw,noatime,nodiratime - vfat /dev/sda1 rw,fmask=0022,dmask=0022,codepage=437,iocharset=iso8859-1,shortname=mixed,errors=remount-ro +34 15 8:18 / /mnt/xfs rw,noatime,nodiratime - xfs /dev/sdb2 rw,attr2,inode64,noquota +35 15 0:26 / /tmp rw,relatime - tmpfs tmpfs rw +36 16 0:27 / /proc/sys/fs/binfmt_misc rw,nosuid,nodev,noexec,relatime - binfmt_misc binfmt_misc rw +42 15 0:33 / /var/lib/nfs/rpc_pipefs rw,relatime - rpc_pipefs rpc_pipefs rw +43 16 0:34 / /proc/fs/nfsd rw,nosuid,nodev,noexec,relatime - nfsd nfsd rw +44 15 0:35 / /home/tianon/.gvfs rw,nosuid,nodev,relatime - fuse.gvfs-fuse-daemon gvfs-fuse-daemon rw,user_id=1000,group_id=1000 +68 15 0:3336 / /var/lib/docker/aufs/mnt/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd rw,relatime - aufs none rw,si=9b4a7640128db39c +85 68 8:6 /var/lib/docker/init/dockerinit-0.7.2-dev//deleted /var/lib/docker/aufs/mnt/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/.dockerinit rw,noatime,nodiratime - ext4 /dev/sda6 rw,data=ordered +86 68 8:6 /var/lib/docker/containers/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/config.env /var/lib/docker/aufs/mnt/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/.dockerenv rw,noatime,nodiratime - ext4 /dev/sda6 rw,data=ordered +87 68 8:6 /etc/resolv.conf /var/lib/docker/aufs/mnt/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/etc/resolv.conf rw,noatime,nodiratime - ext4 /dev/sda6 rw,data=ordered +88 68 8:6 /var/lib/docker/containers/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/hostname /var/lib/docker/aufs/mnt/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/etc/hostname rw,noatime,nodiratime - ext4 /dev/sda6 rw,data=ordered +89 68 8:6 /var/lib/docker/containers/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/hosts /var/lib/docker/aufs/mnt/3597a1a6d6298c1decc339ebb90aad6f7d6ba2e15af3131b1f85e7ee4787a0cd/etc/hosts rw,noatime,nodiratime - ext4 /dev/sda6 rw,data=ordered +38 15 0:3384 / /var/lib/docker/aufs/mnt/0292005a9292401bb5197657f2b682d97d8edcb3b72b5e390d2a680139985b55 rw,relatime - aufs none rw,si=9b4a7642b584939c +39 15 0:3385 / /var/lib/docker/aufs/mnt/59db98c889de5f71b70cfb82c40cbe47b64332f0f56042a2987a9e5df6e5e3aa rw,relatime - aufs none rw,si=9b4a7642b584e39c +40 15 0:3386 / /var/lib/docker/aufs/mnt/0545f0f2b6548eb9601d08f35a08f5a0a385407d36027a28f58e06e9f61e0278 rw,relatime - aufs none rw,si=9b4a7642b584b39c +41 15 0:3387 / /var/lib/docker/aufs/mnt/d882cfa16d1aa8fe0331a36e79be3d80b151e49f24fc39a39c3fed1735d5feb5 rw,relatime - aufs none rw,si=9b4a76453040039c +45 15 0:3388 / /var/lib/docker/aufs/mnt/055ca3befcb1626e74f5344b3398724ff05c0de0e20021683d04305c9e70a3f6 rw,relatime - aufs none rw,si=9b4a76453040739c +46 15 0:3389 / /var/lib/docker/aufs/mnt/b899e4567a351745d4285e7f1c18fdece75d877deb3041981cd290be348b7aa6 rw,relatime - aufs none rw,si=9b4a7647def4039c +47 15 0:3390 / /var/lib/docker/aufs/mnt/067ca040292c58954c5129f953219accfae0d40faca26b4d05e76ca76a998f16 rw,relatime - aufs none rw,si=9b4a7647def4239c +48 15 0:3391 / /var/lib/docker/aufs/mnt/8c995e7cb6e5082742daeea720e340b021d288d25d92e0412c03d200df308a11 rw,relatime - aufs none rw,si=9b4a764479c1639c +49 15 0:3392 / /var/lib/docker/aufs/mnt/07cc54dfae5b45300efdacdd53cc72c01b9044956a86ce7bff42d087e426096d rw,relatime - aufs none rw,si=9b4a764479c1739c +50 15 0:3393 / /var/lib/docker/aufs/mnt/0a9c95cf4c589c05b06baa79150b0cc1d8e7102759fe3ce4afaabb8247ca4f85 rw,relatime - aufs none rw,si=9b4a7644059c839c +51 15 0:3394 / /var/lib/docker/aufs/mnt/468fa98cececcf4e226e8370f18f4f848d63faf287fb8321a07f73086441a3a0 rw,relatime - aufs none rw,si=9b4a7644059ca39c +52 15 0:3395 / /var/lib/docker/aufs/mnt/0b826192231c5ce066fffb5beff4397337b5fc19a377aa7c6282c7c0ce7f111f rw,relatime - aufs none rw,si=9b4a764479c1339c +53 15 0:3396 / /var/lib/docker/aufs/mnt/93b8ba1b772fbe79709b909c43ea4b2c30d712e53548f467db1ffdc7a384f196 rw,relatime - aufs none rw,si=9b4a7640798a739c +54 15 0:3397 / /var/lib/docker/aufs/mnt/0c0d0acfb506859b12ef18cdfef9ebed0b43a611482403564224bde9149d373c rw,relatime - aufs none rw,si=9b4a7640798a039c +55 15 0:3398 / /var/lib/docker/aufs/mnt/33648c39ab6c7c74af0243d6d6a81b052e9e25ad1e04b19892eb2dde013e358b rw,relatime - aufs none rw,si=9b4a7644b439b39c +56 15 0:3399 / /var/lib/docker/aufs/mnt/0c12bea97a1c958a3c739fb148536c1c89351d48e885ecda8f0499b5cc44407e rw,relatime - aufs none rw,si=9b4a7640798a239c +57 15 0:3400 / /var/lib/docker/aufs/mnt/ed443988ce125f172d7512e84a4de2627405990fd767a16adefa8ce700c19ce8 rw,relatime - aufs none rw,si=9b4a7644c8ed339c +59 15 0:3402 / /var/lib/docker/aufs/mnt/f61612c324ff3c924d3f7a82fb00a0f8d8f73c248c41897061949e9f5ab7e3b1 rw,relatime - aufs none rw,si=9b4a76442810c39c +60 15 0:3403 / /var/lib/docker/aufs/mnt/0f1ee55c6c4e25027b80de8e64b8b6fb542b3b41aa0caab9261da75752e22bfd rw,relatime - aufs none rw,si=9b4a76442810e39c +61 15 0:3404 / /var/lib/docker/aufs/mnt/956f6cc4af5785cb3ee6963dcbca668219437d9b28f513290b1453ac64a34f97 rw,relatime - aufs none rw,si=9b4a7644303ec39c +62 15 0:3405 / /var/lib/docker/aufs/mnt/1099769158c4b4773e2569e38024e8717e400f87a002c41d8cf47cb81b051ba6 rw,relatime - aufs none rw,si=9b4a7644303ee39c +63 15 0:3406 / /var/lib/docker/aufs/mnt/11890ceb98d4442595b676085cd7b21550ab85c5df841e0fba997ff54e3d522d rw,relatime - aufs none rw,si=9b4a7644303ed39c +64 15 0:3407 / /var/lib/docker/aufs/mnt/acdb90dc378e8ed2420b43a6d291f1c789a081cd1904018780cc038fcd7aae53 rw,relatime - aufs none rw,si=9b4a76434be2139c +65 15 0:3408 / /var/lib/docker/aufs/mnt/120e716f19d4714fbe63cc1ed246204f2c1106eefebc6537ba2587d7e7711959 rw,relatime - aufs none rw,si=9b4a76434be2339c +66 15 0:3409 / /var/lib/docker/aufs/mnt/b197b7fffb61d89e0ba1c40de9a9fc0d912e778b3c1bd828cf981ff37c1963bc rw,relatime - aufs none rw,si=9b4a76434be2039c +70 15 0:3412 / /var/lib/docker/aufs/mnt/1434b69d2e1bb18a9f0b96b9cdac30132b2688f5d1379f68a39a5e120c2f93eb rw,relatime - aufs none rw,si=9b4a76434be2639c +71 15 0:3413 / /var/lib/docker/aufs/mnt/16006e83caf33ab5eb0cd6afc92ea2ee8edeff897496b0bb3ec3a75b767374b3 rw,relatime - aufs none rw,si=9b4a7644d790439c +72 15 0:3414 / /var/lib/docker/aufs/mnt/55bfa5f44e94d27f91f79ba901b118b15098449165c87abf1b53ffff147ff164 rw,relatime - aufs none rw,si=9b4a7644d790239c +73 15 0:3415 / /var/lib/docker/aufs/mnt/1912b97a07ab21ccd98a2a27bc779bf3cf364a3138afa3c3e6f7f169a3c3eab5 rw,relatime - aufs none rw,si=9b4a76441822739c +76 15 0:3418 / /var/lib/docker/aufs/mnt/1a7c3292e8879bd91ffd9282e954f643b1db5683093574c248ff14a9609f2f56 rw,relatime - aufs none rw,si=9b4a76438cb7239c +77 15 0:3419 / /var/lib/docker/aufs/mnt/bb1faaf0d076ddba82c2318305a85f490dafa4e8a8640a8db8ed657c439120cc rw,relatime - aufs none rw,si=9b4a76438cb7339c +78 15 0:3420 / /var/lib/docker/aufs/mnt/1ab869f21d2241a73ac840c7f988490313f909ac642eba71d092204fec66dd7c rw,relatime - aufs none rw,si=9b4a76438cb7639c +79 15 0:3421 / /var/lib/docker/aufs/mnt/fd7245b2cfe3890fa5f5b452260e4edf9e7fb7746532ed9d83f7a0d7dbaa610e rw,relatime - aufs none rw,si=9b4a7644bdc0139c +80 15 0:3422 / /var/lib/docker/aufs/mnt/1e5686c5301f26b9b3cd24e322c608913465cc6c5d0dcd7c5e498d1314747d61 rw,relatime - aufs none rw,si=9b4a7644bdc0639c +81 15 0:3423 / /var/lib/docker/aufs/mnt/52edf6ee6e40bfec1e9301a4d4a92ab83d144e2ae4ce5099e99df6138cb844bf rw,relatime - aufs none rw,si=9b4a7644bdc0239c +82 15 0:3424 / /var/lib/docker/aufs/mnt/1ea10fb7085d28cda4904657dff0454e52598d28e1d77e4f2965bbc3666e808f rw,relatime - aufs none rw,si=9b4a76438cb7139c +83 15 0:3425 / /var/lib/docker/aufs/mnt/9c03e98c3593946dbd4087f8d83f9ca262f4a2efdc952ce60690838b9ba6c526 rw,relatime - aufs none rw,si=9b4a76443020639c +84 15 0:3426 / /var/lib/docker/aufs/mnt/220a2344d67437602c6d2cee9a98c46be13f82c2a8063919dd2fad52bf2fb7dd rw,relatime - aufs none rw,si=9b4a76434bff339c +94 15 0:3427 / /var/lib/docker/aufs/mnt/3b32876c5b200312c50baa476ff342248e88c8ea96e6a1032cd53a88738a1cf2 rw,relatime - aufs none rw,si=9b4a76434bff139c +95 15 0:3428 / /var/lib/docker/aufs/mnt/23ee2b8b0d4ae8db6f6d1e168e2c6f79f8a18f953b09f65e0d22cc1e67a3a6fa rw,relatime - aufs none rw,si=9b4a7646c305c39c +96 15 0:3429 / /var/lib/docker/aufs/mnt/e86e6daa70b61b57945fa178222615f3c3d6bcef12c9f28e9f8623d44dc2d429 rw,relatime - aufs none rw,si=9b4a7646c305f39c +97 15 0:3430 / /var/lib/docker/aufs/mnt/2413d07623e80860bb2e9e306fbdee699afd07525785c025c591231e864aa162 rw,relatime - aufs none rw,si=9b4a76434bff039c +98 15 0:3431 / /var/lib/docker/aufs/mnt/adfd622eb22340fc80b429e5564b125668e260bf9068096c46dd59f1386a4b7d rw,relatime - aufs none rw,si=9b4a7646a7a1039c +102 15 0:3435 / /var/lib/docker/aufs/mnt/27cd92e7a91d02e2d6b44d16679a00fb6d169b19b88822891084e7fd1a84882d rw,relatime - aufs none rw,si=9b4a7646f25ec39c +103 15 0:3436 / /var/lib/docker/aufs/mnt/27dfdaf94cfbf45055c748293c37dd68d9140240bff4c646cb09216015914a88 rw,relatime - aufs none rw,si=9b4a7646732f939c +104 15 0:3437 / /var/lib/docker/aufs/mnt/5ed7524aff68dfbf0fc601cbaeac01bab14391850a973dabf3653282a627920f rw,relatime - aufs none rw,si=9b4a7646732f839c +105 15 0:3438 / /var/lib/docker/aufs/mnt/2a0d4767e536beb5785b60e071e3ac8e5e812613ab143a9627bee77d0c9ab062 rw,relatime - aufs none rw,si=9b4a7646732fe39c +106 15 0:3439 / /var/lib/docker/aufs/mnt/dea3fc045d9f4ae51ba952450b948a822cf85c39411489ca5224f6d9a8d02bad rw,relatime - aufs none rw,si=9b4a764012ad839c +107 15 0:3440 / /var/lib/docker/aufs/mnt/2d140a787160798da60cb67c21b1210054ad4dafecdcf832f015995b9aa99cfd rw,relatime - aufs none rw,si=9b4a764012add39c +108 15 0:3441 / /var/lib/docker/aufs/mnt/cb190b2a8e984475914430fbad2382e0d20b9b659f8ef83ae8d170cc672e519c rw,relatime - aufs none rw,si=9b4a76454d9c239c +109 15 0:3442 / /var/lib/docker/aufs/mnt/2f4a012d5a7ffd90256a6e9aa479054b3dddbc3c6a343f26dafbf3196890223b rw,relatime - aufs none rw,si=9b4a76454d9c439c +110 15 0:3443 / /var/lib/docker/aufs/mnt/63cc77904b80c4ffbf49cb974c5d8733dc52ad7640d3ae87554b325d7312d87f rw,relatime - aufs none rw,si=9b4a76454d9c339c +111 15 0:3444 / /var/lib/docker/aufs/mnt/30333e872c451482ea2d235ff2192e875bd234006b238ae2bdde3b91a86d7522 rw,relatime - aufs none rw,si=9b4a76422cebf39c +112 15 0:3445 / /var/lib/docker/aufs/mnt/6c54fc1125da3925cae65b5c9a98f3be55b0a2c2666082e5094a4ba71beb5bff rw,relatime - aufs none rw,si=9b4a7646dd5a439c +113 15 0:3446 / /var/lib/docker/aufs/mnt/3087d48cb01cda9d0a83a9ca301e6ea40e8593d18c4921be4794c91a420ab9a3 rw,relatime - aufs none rw,si=9b4a7646dd5a739c +114 15 0:3447 / /var/lib/docker/aufs/mnt/cc2607462a8f55b179a749b144c3fdbb50678e1a4f3065ea04e283e9b1f1d8e2 rw,relatime - aufs none rw,si=9b4a7646dd5a239c +117 15 0:3450 / /var/lib/docker/aufs/mnt/310c5e8392b29e8658a22e08d96d63936633b7e2c38e8d220047928b00a03d24 rw,relatime - aufs none rw,si=9b4a7647932d739c +118 15 0:3451 / /var/lib/docker/aufs/mnt/38a1f0029406ba9c3b6058f2f406d8a1d23c855046cf355c91d87d446fcc1460 rw,relatime - aufs none rw,si=9b4a76445abc939c +119 15 0:3452 / /var/lib/docker/aufs/mnt/42e109ab7914ae997a11ccd860fd18e4d488c50c044c3240423ce15774b8b62e rw,relatime - aufs none rw,si=9b4a76445abca39c +120 15 0:3453 / /var/lib/docker/aufs/mnt/365d832af0402d052b389c1e9c0d353b48487533d20cd4351df8e24ec4e4f9d8 rw,relatime - aufs none rw,si=9b4a7644066aa39c +121 15 0:3454 / /var/lib/docker/aufs/mnt/d3fa8a24d695b6cda9b64f96188f701963d28bef0473343f8b212df1a2cf1d2b rw,relatime - aufs none rw,si=9b4a7644066af39c +122 15 0:3455 / /var/lib/docker/aufs/mnt/37d4f491919abc49a15d0c7a7cc8383f087573525d7d288accd14f0b4af9eae0 rw,relatime - aufs none rw,si=9b4a7644066ad39c +123 15 0:3456 / /var/lib/docker/aufs/mnt/93902707fe12cbdd0068ce73f2baad4b3a299189b1b19cb5f8a2025e106ae3f5 rw,relatime - aufs none rw,si=9b4a76444445f39c +126 15 0:3459 / /var/lib/docker/aufs/mnt/3b49291670a625b9bbb329ffba99bf7fa7abff80cefef040f8b89e2b3aad4f9f rw,relatime - aufs none rw,si=9b4a7640798a339c +127 15 0:3460 / /var/lib/docker/aufs/mnt/8d9c7b943cc8f854f4d0d4ec19f7c16c13b0cc4f67a41472a072648610cecb59 rw,relatime - aufs none rw,si=9b4a76427383039c +128 15 0:3461 / /var/lib/docker/aufs/mnt/3b6c90036526c376307df71d49c9f5fce334c01b926faa6a78186842de74beac rw,relatime - aufs none rw,si=9b4a7644badd439c +130 15 0:3463 / /var/lib/docker/aufs/mnt/7b24158eeddfb5d31b7e932e406ea4899fd728344335ff8e0765e89ddeb351dd rw,relatime - aufs none rw,si=9b4a7644badd539c +131 15 0:3464 / /var/lib/docker/aufs/mnt/3ead6dd5773765c74850cf6c769f21fe65c29d622ffa712664f9f5b80364ce27 rw,relatime - aufs none rw,si=9b4a7642f469939c +132 15 0:3465 / /var/lib/docker/aufs/mnt/3f825573b29547744a37b65597a9d6d15a8350be4429b7038d126a4c9a8e178f rw,relatime - aufs none rw,si=9b4a7642f469c39c +133 15 0:3466 / /var/lib/docker/aufs/mnt/f67aaaeb3681e5dcb99a41f847087370bd1c206680cb8c7b6a9819fd6c97a331 rw,relatime - aufs none rw,si=9b4a7647cc25939c +134 15 0:3467 / /var/lib/docker/aufs/mnt/41afe6cfb3c1fc2280b869db07699da88552786e28793f0bc048a265c01bd942 rw,relatime - aufs none rw,si=9b4a7647cc25c39c +135 15 0:3468 / /var/lib/docker/aufs/mnt/b8092ea59da34a40b120e8718c3ae9fa8436996edc4fc50e4b99c72dfd81e1af rw,relatime - aufs none rw,si=9b4a76445abc439c +136 15 0:3469 / /var/lib/docker/aufs/mnt/42c69d2cc179e2684458bb8596a9da6dad182c08eae9b74d5f0e615b399f75a5 rw,relatime - aufs none rw,si=9b4a76455ddbe39c +137 15 0:3470 / /var/lib/docker/aufs/mnt/ea0871954acd2d62a211ac60e05969622044d4c74597870c4f818fbb0c56b09b rw,relatime - aufs none rw,si=9b4a76455ddbf39c +138 15 0:3471 / /var/lib/docker/aufs/mnt/4307906b275ab3fc971786b3841ae3217ac85b6756ddeb7ad4ba09cd044c2597 rw,relatime - aufs none rw,si=9b4a76455ddb839c +139 15 0:3472 / /var/lib/docker/aufs/mnt/4390b872928c53500a5035634f3421622ed6299dc1472b631fc45de9f56dc180 rw,relatime - aufs none rw,si=9b4a76402f2fd39c +140 15 0:3473 / /var/lib/docker/aufs/mnt/6bb41e78863b85e4aa7da89455314855c8c3bda64e52a583bab15dc1fa2e80c2 rw,relatime - aufs none rw,si=9b4a76402f2fa39c +141 15 0:3474 / /var/lib/docker/aufs/mnt/4444f583c2a79c66608f4673a32c9c812154f027045fbd558c2d69920c53f835 rw,relatime - aufs none rw,si=9b4a764479dbd39c +142 15 0:3475 / /var/lib/docker/aufs/mnt/6f11883af4a05ea362e0c54df89058da4859f977efd07b6f539e1f55c1d2a668 rw,relatime - aufs none rw,si=9b4a76402f30b39c +143 15 0:3476 / /var/lib/docker/aufs/mnt/453490dd32e7c2e9ef906f995d8fb3c2753923d1a5e0ba3fd3296e2e4dc238e7 rw,relatime - aufs none rw,si=9b4a76402f30c39c +144 15 0:3477 / /var/lib/docker/aufs/mnt/45e5945735ee102b5e891c91650c57ec4b52bb53017d68f02d50ea8a6e230610 rw,relatime - aufs none rw,si=9b4a76423260739c +147 15 0:3480 / /var/lib/docker/aufs/mnt/4727a64a5553a1125f315b96bed10d3073d6988225a292cce732617c925b56ab rw,relatime - aufs none rw,si=9b4a76443030339c +150 15 0:3483 / /var/lib/docker/aufs/mnt/4e348b5187b9a567059306afc72d42e0ec5c893b0d4abd547526d5f9b6fb4590 rw,relatime - aufs none rw,si=9b4a7644f5d8c39c +151 15 0:3484 / /var/lib/docker/aufs/mnt/4efc616bfbc3f906718b052da22e4335f8e9f91ee9b15866ed3a8029645189ef rw,relatime - aufs none rw,si=9b4a7644f5d8939c +152 15 0:3485 / /var/lib/docker/aufs/mnt/83e730ae9754d5adb853b64735472d98dfa17136b8812ac9cfcd1eba7f4e7d2d rw,relatime - aufs none rw,si=9b4a76469aa7139c +153 15 0:3486 / /var/lib/docker/aufs/mnt/4fc5ba8a5b333be2b7eefacccb626772eeec0ae8a6975112b56c9fb36c0d342f rw,relatime - aufs none rw,si=9b4a7640128dc39c +154 15 0:3487 / /var/lib/docker/aufs/mnt/50200d5edff5dfe8d1ef3c78b0bbd709793ac6e936aa16d74ff66f7ea577b6f9 rw,relatime - aufs none rw,si=9b4a7640128da39c +155 15 0:3488 / /var/lib/docker/aufs/mnt/51e5e51604361448f0b9777f38329f414bc5ba9cf238f26d465ff479bd574b61 rw,relatime - aufs none rw,si=9b4a76444f68939c +156 15 0:3489 / /var/lib/docker/aufs/mnt/52a142149aa98bba83df8766bbb1c629a97b9799944ead90dd206c4bdf0b8385 rw,relatime - aufs none rw,si=9b4a76444f68b39c +157 15 0:3490 / /var/lib/docker/aufs/mnt/52dd21a94a00f58a1ed489312fcfffb91578089c76c5650364476f1d5de031bc rw,relatime - aufs none rw,si=9b4a76444f68f39c +158 15 0:3491 / /var/lib/docker/aufs/mnt/ee562415ddaad353ed22c88d0ca768a0c74bfba6333b6e25c46849ee22d990da rw,relatime - aufs none rw,si=9b4a7640128d839c +159 15 0:3492 / /var/lib/docker/aufs/mnt/db47a9e87173f7554f550c8a01891de79cf12acdd32e01f95c1a527a08bdfb2c rw,relatime - aufs none rw,si=9b4a764405a1d39c +160 15 0:3493 / /var/lib/docker/aufs/mnt/55e827bf6d44d930ec0b827c98356eb8b68c3301e2d60d1429aa72e05b4c17df rw,relatime - aufs none rw,si=9b4a764405a1a39c +162 15 0:3495 / /var/lib/docker/aufs/mnt/578dc4e0a87fc37ec081ca098430499a59639c09f6f12a8f48de29828a091aa6 rw,relatime - aufs none rw,si=9b4a76406d7d439c +163 15 0:3496 / /var/lib/docker/aufs/mnt/728cc1cb04fa4bc6f7bf7a90980beda6d8fc0beb71630874c0747b994efb0798 rw,relatime - aufs none rw,si=9b4a76444f20e39c +164 15 0:3497 / /var/lib/docker/aufs/mnt/5850cc4bd9b55aea46c7ad598f1785117607974084ea643580f58ce3222e683a rw,relatime - aufs none rw,si=9b4a7644a824239c +165 15 0:3498 / /var/lib/docker/aufs/mnt/89443b3f766d5a37bc8b84e29da8b84e6a3ea8486d3cf154e2aae1816516e4a8 rw,relatime - aufs none rw,si=9b4a7644a824139c +166 15 0:3499 / /var/lib/docker/aufs/mnt/f5ae8fd5a41a337907d16515bc3162525154b59c32314c695ecd092c3b47943d rw,relatime - aufs none rw,si=9b4a7644a824439c +167 15 0:3500 / /var/lib/docker/aufs/mnt/5a430854f2a03a9e5f7cbc9f3fb46a8ebca526a5b3f435236d8295e5998798f5 rw,relatime - aufs none rw,si=9b4a7647fc82439c +168 15 0:3501 / /var/lib/docker/aufs/mnt/eda16901ae4cead35070c39845cbf1e10bd6b8cb0ffa7879ae2d8a186e460f91 rw,relatime - aufs none rw,si=9b4a76441e0df39c +169 15 0:3502 / /var/lib/docker/aufs/mnt/5a593721430c2a51b119ff86a7e06ea2b37e3b4131f8f1344d402b61b0c8d868 rw,relatime - aufs none rw,si=9b4a764248bad39c +170 15 0:3503 / /var/lib/docker/aufs/mnt/d662ad0a30fbfa902e0962108685b9330597e1ee2abb16dc9462eb5a67fdd23f rw,relatime - aufs none rw,si=9b4a764248bae39c +171 15 0:3504 / /var/lib/docker/aufs/mnt/5bc9de5c79812843fb36eee96bef1ddba812407861f572e33242f4ee10da2c15 rw,relatime - aufs none rw,si=9b4a764248ba839c +172 15 0:3505 / /var/lib/docker/aufs/mnt/5e763de8e9b0f7d58d2e12a341e029ab4efb3b99788b175090d8209e971156c1 rw,relatime - aufs none rw,si=9b4a764248baa39c +173 15 0:3506 / /var/lib/docker/aufs/mnt/b4431dc2739936f1df6387e337f5a0c99cf051900c896bd7fd46a870ce61c873 rw,relatime - aufs none rw,si=9b4a76401263539c +174 15 0:3507 / /var/lib/docker/aufs/mnt/5f37830e5a02561ab8c67ea3113137ba69f67a60e41c05cb0e7a0edaa1925b24 rw,relatime - aufs none rw,si=9b4a76401263639c +184 15 0:3508 / /var/lib/docker/aufs/mnt/62ea10b957e6533538a4633a1e1d678502f50ddcdd354b2ca275c54dd7a7793a rw,relatime - aufs none rw,si=9b4a76401263039c +187 15 0:3509 / /var/lib/docker/aufs/mnt/d56ee9d44195fe390e042fda75ec15af5132adb6d5c69468fa8792f4e54a6953 rw,relatime - aufs none rw,si=9b4a76401263239c +188 15 0:3510 / /var/lib/docker/aufs/mnt/6a300930673174549c2b62f36c933f0332a20735978c007c805a301f897146c5 rw,relatime - aufs none rw,si=9b4a76455d4c539c +189 15 0:3511 / /var/lib/docker/aufs/mnt/64496c45c84d348c24d410015456d101601c30cab4d1998c395591caf7e57a70 rw,relatime - aufs none rw,si=9b4a76455d4c639c +190 15 0:3512 / /var/lib/docker/aufs/mnt/65a6a645883fe97a7422cd5e71ebe0bc17c8e6302a5361edf52e89747387e908 rw,relatime - aufs none rw,si=9b4a76455d4c039c +191 15 0:3513 / /var/lib/docker/aufs/mnt/672be40695f7b6e13b0a3ed9fc996c73727dede3481f58155950fcfad57ed616 rw,relatime - aufs none rw,si=9b4a76455d4c239c +192 15 0:3514 / /var/lib/docker/aufs/mnt/d42438acb2bfb2169e1c0d8e917fc824f7c85d336dadb0b0af36dfe0f001b3ba rw,relatime - aufs none rw,si=9b4a7642bfded39c +193 15 0:3515 / /var/lib/docker/aufs/mnt/b48a54abf26d01cb2ddd908b1ed6034d17397c1341bf0eb2b251a3e5b79be854 rw,relatime - aufs none rw,si=9b4a7642bfdee39c +194 15 0:3516 / /var/lib/docker/aufs/mnt/76f27134491f052bfb87f59092126e53ef875d6851990e59195a9da16a9412f8 rw,relatime - aufs none rw,si=9b4a7642bfde839c +195 15 0:3517 / /var/lib/docker/aufs/mnt/6bd626a5462b4f8a8e1cc7d10351326dca97a59b2758e5ea549a4f6350ce8a90 rw,relatime - aufs none rw,si=9b4a7642bfdea39c +196 15 0:3518 / /var/lib/docker/aufs/mnt/f1fe3549dbd6f5ca615e9139d9b53f0c83a3b825565df37628eacc13e70cbd6d rw,relatime - aufs none rw,si=9b4a7642bfdf539c +197 15 0:3519 / /var/lib/docker/aufs/mnt/6d0458c8426a9e93d58d0625737e6122e725c9408488ed9e3e649a9984e15c34 rw,relatime - aufs none rw,si=9b4a7642bfdf639c +198 15 0:3520 / /var/lib/docker/aufs/mnt/6e4c97db83aa82145c9cf2bafc20d500c0b5389643b689e3ae84188c270a48c5 rw,relatime - aufs none rw,si=9b4a7642bfdf039c +199 15 0:3521 / /var/lib/docker/aufs/mnt/eb94d6498f2c5969eaa9fa11ac2934f1ab90ef88e2d002258dca08e5ba74ea27 rw,relatime - aufs none rw,si=9b4a7642bfdf239c +200 15 0:3522 / /var/lib/docker/aufs/mnt/fe3f88f0c511608a2eec5f13a98703aa16e55dbf930309723d8a37101f539fe1 rw,relatime - aufs none rw,si=9b4a7642bfc3539c +201 15 0:3523 / /var/lib/docker/aufs/mnt/6f40c229fb9cad85fabf4b64a2640a5403ec03fe5ac1a57d0609fb8b606b9c83 rw,relatime - aufs none rw,si=9b4a7642bfc3639c +202 15 0:3524 / /var/lib/docker/aufs/mnt/7513e9131f7a8acf58ff15248237feb767c78732ca46e159f4d791e6ef031dbc rw,relatime - aufs none rw,si=9b4a7642bfc3039c +203 15 0:3525 / /var/lib/docker/aufs/mnt/79f48b00aa713cdf809c6bb7c7cb911b66e9a8076c81d6c9d2504139984ea2da rw,relatime - aufs none rw,si=9b4a7642bfc3239c +204 15 0:3526 / /var/lib/docker/aufs/mnt/c3680418350d11358f0a96c676bc5aa74fa00a7c89e629ef5909d3557b060300 rw,relatime - aufs none rw,si=9b4a7642f47cd39c +205 15 0:3527 / /var/lib/docker/aufs/mnt/7a1744dd350d7fcc0cccb6f1757ca4cbe5453f203a5888b0f1014d96ad5a5ef9 rw,relatime - aufs none rw,si=9b4a7642f47ce39c +206 15 0:3528 / /var/lib/docker/aufs/mnt/7fa99662db046be9f03c33c35251afda9ccdc0085636bbba1d90592cec3ff68d rw,relatime - aufs none rw,si=9b4a7642f47c839c +207 15 0:3529 / /var/lib/docker/aufs/mnt/f815021ef20da9c9b056bd1d52d8aaf6e2c0c19f11122fc793eb2b04eb995e35 rw,relatime - aufs none rw,si=9b4a7642f47ca39c +208 15 0:3530 / /var/lib/docker/aufs/mnt/801086ae3110192d601dfcebdba2db92e86ce6b6a9dba6678ea04488e4513669 rw,relatime - aufs none rw,si=9b4a7642dc6dd39c +209 15 0:3531 / /var/lib/docker/aufs/mnt/822ba7db69f21daddda87c01cfbfbf73013fc03a879daf96d16cdde6f9b1fbd6 rw,relatime - aufs none rw,si=9b4a7642dc6de39c +210 15 0:3532 / /var/lib/docker/aufs/mnt/834227c1a950fef8cae3827489129d0dd220541e60c6b731caaa765bf2e6a199 rw,relatime - aufs none rw,si=9b4a7642dc6d839c +211 15 0:3533 / /var/lib/docker/aufs/mnt/83dccbc385299bd1c7cf19326e791b33a544eea7b4cdfb6db70ea94eed4389fb rw,relatime - aufs none rw,si=9b4a7642dc6da39c +212 15 0:3534 / /var/lib/docker/aufs/mnt/f1b8e6f0e7c8928b5dcdab944db89306ebcae3e0b32f9ff40d2daa8329f21600 rw,relatime - aufs none rw,si=9b4a7645a126039c +213 15 0:3535 / /var/lib/docker/aufs/mnt/970efb262c7a020c2404cbcc5b3259efba0d110a786079faeef05bc2952abf3a rw,relatime - aufs none rw,si=9b4a7644c8ed139c +214 15 0:3536 / /var/lib/docker/aufs/mnt/84b6d73af7450f3117a77e15a5ca1255871fea6182cd8e8a7be6bc744be18c2c rw,relatime - aufs none rw,si=9b4a76406559139c +215 15 0:3537 / /var/lib/docker/aufs/mnt/88be2716e026bc681b5e63fe7942068773efbd0b6e901ca7ba441412006a96b6 rw,relatime - aufs none rw,si=9b4a76406559339c +216 15 0:3538 / /var/lib/docker/aufs/mnt/c81939aa166ce50cd8bca5cfbbcc420a78e0318dd5cd7c755209b9166a00a752 rw,relatime - aufs none rw,si=9b4a76406559239c +217 15 0:3539 / /var/lib/docker/aufs/mnt/e0f241645d64b7dc5ff6a8414087cca226be08fb54ce987d1d1f6350c57083aa rw,relatime - aufs none rw,si=9b4a7647cfc0f39c +218 15 0:3540 / /var/lib/docker/aufs/mnt/e10e2bf75234ed51d8a6a4bb39e465404fecbe318e54400d3879cdb2b0679c78 rw,relatime - aufs none rw,si=9b4a7647cfc0939c +219 15 0:3541 / /var/lib/docker/aufs/mnt/8f71d74c8cfc3228b82564aa9f09b2e576cff0083ddfb6aa5cb350346063f080 rw,relatime - aufs none rw,si=9b4a7647cfc0a39c +220 15 0:3542 / /var/lib/docker/aufs/mnt/9159f1eba2aef7f5205cc18d015cda7f5933cd29bba3b1b8aed5ccb5824c69ee rw,relatime - aufs none rw,si=9b4a76468cedd39c +221 15 0:3543 / /var/lib/docker/aufs/mnt/932cad71e652e048e500d9fbb5b8ea4fc9a269d42a3134ce527ceef42a2be56b rw,relatime - aufs none rw,si=9b4a76468cede39c +222 15 0:3544 / /var/lib/docker/aufs/mnt/bf1e1b5f529e8943cc0144ee86dbaaa37885c1ddffcef29537e0078ee7dd316a rw,relatime - aufs none rw,si=9b4a76468ced839c +223 15 0:3545 / /var/lib/docker/aufs/mnt/949d93ecf3322e09f858ce81d5f4b434068ec44ff84c375de03104f7b45ee955 rw,relatime - aufs none rw,si=9b4a76468ceda39c +224 15 0:3546 / /var/lib/docker/aufs/mnt/d65c6087f92dc2a3841b5251d2fe9ca07d4c6e5b021597692479740816e4e2a1 rw,relatime - aufs none rw,si=9b4a7645a126239c +225 15 0:3547 / /var/lib/docker/aufs/mnt/98a0153119d0651c193d053d254f6e16a68345a141baa80c87ae487e9d33f290 rw,relatime - aufs none rw,si=9b4a7640787cf39c +226 15 0:3548 / /var/lib/docker/aufs/mnt/99daf7fe5847c017392f6e59aa9706b3dfdd9e6d1ba11dae0f7fffde0a60b5e5 rw,relatime - aufs none rw,si=9b4a7640787c839c +227 15 0:3549 / /var/lib/docker/aufs/mnt/9ad1f2fe8a5599d4e10c5a6effa7f03d932d4e92ee13149031a372087a359079 rw,relatime - aufs none rw,si=9b4a7640787ca39c +228 15 0:3550 / /var/lib/docker/aufs/mnt/c26d64494da782ddac26f8370d86ac93e7c1666d88a7b99110fc86b35ea6a85d rw,relatime - aufs none rw,si=9b4a7642fc6b539c +229 15 0:3551 / /var/lib/docker/aufs/mnt/a49e4a8275133c230ec640997f35f172312eb0ea5bd2bbe10abf34aae98f30eb rw,relatime - aufs none rw,si=9b4a7642fc6b639c +230 15 0:3552 / /var/lib/docker/aufs/mnt/b5e2740c867ed843025f49d84e8d769de9e8e6039b3c8cb0735b5bf358994bc7 rw,relatime - aufs none rw,si=9b4a7642fc6b039c +231 15 0:3553 / /var/lib/docker/aufs/mnt/a826fdcf3a7039b30570054579b65763db605a314275d7aef31b872c13311b4b rw,relatime - aufs none rw,si=9b4a7642fc6b239c +232 15 0:3554 / /var/lib/docker/aufs/mnt/addf3025babf5e43b5a3f4a0da7ad863dda3c01fb8365c58fd8d28bb61dc11bc rw,relatime - aufs none rw,si=9b4a76407871d39c +233 15 0:3555 / /var/lib/docker/aufs/mnt/c5b6c6813ab3e5ebdc6d22cb2a3d3106a62095f2c298be52b07a3b0fa20ff690 rw,relatime - aufs none rw,si=9b4a76407871e39c +234 15 0:3556 / /var/lib/docker/aufs/mnt/af0609eaaf64e2392060cb46f5a9f3d681a219bb4c651d4f015bf573fbe6c4cf rw,relatime - aufs none rw,si=9b4a76407871839c +235 15 0:3557 / /var/lib/docker/aufs/mnt/e7f20e3c37ecad39cd90a97cd3549466d0d106ce4f0a930b8495442634fa4a1f rw,relatime - aufs none rw,si=9b4a76407871a39c +237 15 0:3559 / /var/lib/docker/aufs/mnt/b57a53d440ffd0c1295804fa68cdde35d2fed5409484627e71b9c37e4249fd5c rw,relatime - aufs none rw,si=9b4a76444445a39c +238 15 0:3560 / /var/lib/docker/aufs/mnt/b5e7d7b8f35e47efbba3d80c5d722f5e7bd43e54c824e54b4a4b351714d36d42 rw,relatime - aufs none rw,si=9b4a7647932d439c +239 15 0:3561 / /var/lib/docker/aufs/mnt/f1b136def157e9465640658f277f3347de593c6ae76412a2e79f7002f091cae2 rw,relatime - aufs none rw,si=9b4a76445abcd39c +240 15 0:3562 / /var/lib/docker/aufs/mnt/b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc rw,relatime - aufs none rw,si=9b4a7644403b339c +241 15 0:3563 / /var/lib/docker/aufs/mnt/b89b140cdbc95063761864e0a23346207fa27ee4c5c63a1ae85c9069a9d9cf1d rw,relatime - aufs none rw,si=9b4a7644aa19739c +242 15 0:3564 / /var/lib/docker/aufs/mnt/bc6a69ed51c07f5228f6b4f161c892e6a949c0e7e86a9c3432049d4c0e5cd298 rw,relatime - aufs none rw,si=9b4a7644aa19139c +243 15 0:3565 / /var/lib/docker/aufs/mnt/be4e2ba3f136933e239f7cf3d136f484fb9004f1fbdfee24a62a2c7b0ab30670 rw,relatime - aufs none rw,si=9b4a7644aa19339c +244 15 0:3566 / /var/lib/docker/aufs/mnt/e04ca1a4a5171e30d20f0c92f90a50b8b6f8600af5459c4b4fb25e42e864dfe1 rw,relatime - aufs none rw,si=9b4a7647932d139c +245 15 0:3567 / /var/lib/docker/aufs/mnt/be61576b31db893129aaffcd3dcb5ce35e49c4b71b30c392a78609a45c7323d8 rw,relatime - aufs none rw,si=9b4a7642d85f739c +246 15 0:3568 / /var/lib/docker/aufs/mnt/dda42c191e56becf672327658ab84fcb563322db3764b91c2fefe4aaef04c624 rw,relatime - aufs none rw,si=9b4a7642d85f139c +247 15 0:3569 / /var/lib/docker/aufs/mnt/c0a7995053330f3d88969247a2e72b07e2dd692133f5668a4a35ea3905561072 rw,relatime - aufs none rw,si=9b4a7642d85f339c +249 15 0:3571 / /var/lib/docker/aufs/mnt/c3594b2e5f08c59ff5ed338a1ba1eceeeb1f7fc5d180068338110c00b1eb8502 rw,relatime - aufs none rw,si=9b4a7642738c739c +250 15 0:3572 / /var/lib/docker/aufs/mnt/c58dce03a0ab0a7588393880379dc3bce9f96ec08ed3f99cf1555260ff0031e8 rw,relatime - aufs none rw,si=9b4a7642738c139c +251 15 0:3573 / /var/lib/docker/aufs/mnt/c73e9f1d109c9d14cb36e1c7489df85649be3911116d76c2fd3648ec8fd94e23 rw,relatime - aufs none rw,si=9b4a7642738c339c +252 15 0:3574 / /var/lib/docker/aufs/mnt/c9eef28c344877cd68aa09e543c0710ab2b305a0ff96dbb859bfa7808c3e8d01 rw,relatime - aufs none rw,si=9b4a7642d85f439c +253 15 0:3575 / /var/lib/docker/aufs/mnt/feb67148f548d70cb7484f2aaad2a86051cd6867a561741a2f13b552457d666e rw,relatime - aufs none rw,si=9b4a76468c55739c +254 15 0:3576 / /var/lib/docker/aufs/mnt/cdf1f96c36d35a96041a896bf398ec0f7dc3b0fb0643612a0f4b6ff96e04e1bb rw,relatime - aufs none rw,si=9b4a76468c55139c +255 15 0:3577 / /var/lib/docker/aufs/mnt/ec6e505872353268451ac4bc034c1df00f3bae4a3ea2261c6e48f7bd5417c1b3 rw,relatime - aufs none rw,si=9b4a76468c55339c +256 15 0:3578 / /var/lib/docker/aufs/mnt/d6dc8aca64efd90e0bc10274001882d0efb310d42ccbf5712b99b169053b8b1a rw,relatime - aufs none rw,si=9b4a7642738c439c +257 15 0:3579 / /var/lib/docker/aufs/mnt/d712594e2ff6eaeb895bfd150d694bd1305fb927e7a186b2dab7df2ea95f8f81 rw,relatime - aufs none rw,si=9b4a76401268f39c +259 15 0:3581 / /var/lib/docker/aufs/mnt/dbfa1174cd78cde2d7410eae442af0b416c4a0e6f87ed4ff1e9f169a0029abc0 rw,relatime - aufs none rw,si=9b4a76401268b39c +260 15 0:3582 / /var/lib/docker/aufs/mnt/e883f5a82316d7856fbe93ee8c0af5a920b7079619dd95c4ffd88bbd309d28dd rw,relatime - aufs none rw,si=9b4a76468c55439c +261 15 0:3583 / /var/lib/docker/aufs/mnt/fdec3eff581c4fc2b09f87befa2fa021f3f2d373bea636a87f1fb5b367d6347a rw,relatime - aufs none rw,si=9b4a7644aa1af39c +262 15 0:3584 / /var/lib/docker/aufs/mnt/ef764e26712184653067ecf7afea18a80854c41331ca0f0ef03e1bacf90a6ffc rw,relatime - aufs none rw,si=9b4a7644aa1a939c +263 15 0:3585 / /var/lib/docker/aufs/mnt/f3176b40c41fce8ce6942936359a2001a6f1b5c1bb40ee224186db0789ec2f76 rw,relatime - aufs none rw,si=9b4a7644aa1ab39c +264 15 0:3586 / /var/lib/docker/aufs/mnt/f5daf06785d3565c6dd18ea7d953d9a8b9606107781e63270fe0514508736e6a rw,relatime - aufs none rw,si=9b4a76401268c39c +58 15 0:3587 / /var/lib/docker/aufs/mnt/cde8c40f6524b7361af4f5ad05bb857dc9ee247c20852ba666195c0739e3a2b8-init rw,relatime - aufs none rw,si=9b4a76444445839c +67 15 0:3588 / /var/lib/docker/aufs/mnt/cde8c40f6524b7361af4f5ad05bb857dc9ee247c20852ba666195c0739e3a2b8 rw,relatime - aufs none rw,si=9b4a7644badd339c +265 15 0:3610 / /var/lib/docker/aufs/mnt/e812472cd2c8c4748d1ef71fac4e77e50d661b9349abe66ce3e23511ed44f414 rw,relatime - aufs none rw,si=9b4a76427937d39c +270 15 0:3615 / /var/lib/docker/aufs/mnt/997636e7c5c9d0d1376a217e295c14c205350b62bc12052804fb5f90abe6f183 rw,relatime - aufs none rw,si=9b4a76406540739c +273 15 0:3618 / /var/lib/docker/aufs/mnt/d5794d080417b6e52e69227c3873e0e4c1ff0d5a845ebe3860ec2f89a47a2a1e rw,relatime - aufs none rw,si=9b4a76454814039c +278 15 0:3623 / /var/lib/docker/aufs/mnt/586bdd48baced671bb19bc4d294ec325f26c55545ae267db426424f157d59c48 rw,relatime - aufs none rw,si=9b4a7644b439f39c +281 15 0:3626 / /var/lib/docker/aufs/mnt/69739d022f89f8586908bbd5edbbdd95ea5256356f177f9ffcc6ef9c0ea752d2 rw,relatime - aufs none rw,si=9b4a7644a0f1b39c +286 15 0:3631 / /var/lib/docker/aufs/mnt/ff28c27d5f894363993622de26d5dd352dba072f219e4691d6498c19bbbc15a9 rw,relatime - aufs none rw,si=9b4a7642265b339c +289 15 0:3634 / /var/lib/docker/aufs/mnt/aa128fe0e64fdede333aa48fd9de39530c91a9244a0f0649a3c411c61e372daa rw,relatime - aufs none rw,si=9b4a764012ada39c +99 15 8:33 / /media/REMOVE\040ME rw,nosuid,nodev,relatime - fuseblk /dev/sdc1 rw,user_id=0,group_id=0,allow_other,blksize=4096` +) + +func TestParseFedoraMountinfo(t *testing.T) { + r := bytes.NewBuffer([]byte(fedoraMountinfo)) + _, err := parseInfoFile(r) + if err != nil { + t.Fatal(err) + } +} + +func TestParseUbuntuMountinfo(t *testing.T) { + r := bytes.NewBuffer([]byte(ubuntuMountInfo)) + _, err := parseInfoFile(r) + if err != nil { + t.Fatal(err) + } +} + +func TestParseGentooMountinfo(t *testing.T) { + r := bytes.NewBuffer([]byte(gentooMountinfo)) + _, err := parseInfoFile(r) + if err != nil { + t.Fatal(err) + } +} + +func TestParseFedoraMountinfoFields(t *testing.T) { + r := bytes.NewBuffer([]byte(fedoraMountinfo)) + infos, err := parseInfoFile(r) + if err != nil { + t.Fatal(err) + } + expectedLength := 58 + if len(infos) != expectedLength { + t.Fatalf("Expected %d entries, got %d", expectedLength, len(infos)) + } + mi := Info{ + ID: 15, + Parent: 35, + Major: 0, + Minor: 3, + Root: "/", + Mountpoint: "/proc", + Opts: "rw,nosuid,nodev,noexec,relatime", + Optional: "shared:5", + Fstype: "proc", + Source: "proc", + VfsOpts: "rw", + } + + if *infos[0] != mi { + t.Fatalf("expected %#v, got %#v", mi, infos[0]) + } +} diff --git a/pkg/mount/mountinfo_unsupported.go b/pkg/mount/mountinfo_unsupported.go new file mode 100644 index 0000000000..8245f01d42 --- /dev/null +++ b/pkg/mount/mountinfo_unsupported.go @@ -0,0 +1,12 @@ +// +build !linux,!freebsd freebsd,!cgo + +package mount + +import ( + "fmt" + "runtime" +) + +func parseMountTable() ([]*Info, error) { + return nil, fmt.Errorf("mount.parseMountTable is not implemented on %s/%s", runtime.GOOS, runtime.GOARCH) +} diff --git a/pkg/mount/sharedsubtree_linux.go b/pkg/mount/sharedsubtree_linux.go new file mode 100644 index 0000000000..47303bbcb6 --- /dev/null +++ b/pkg/mount/sharedsubtree_linux.go @@ -0,0 +1,70 @@ +// +build linux + +package mount + +// MakeShared ensures a mounted filesystem has the SHARED mount option enabled. +// See the supported options in flags.go for further reference. +func MakeShared(mountPoint string) error { + return ensureMountedAs(mountPoint, "shared") +} + +// MakeRShared ensures a mounted filesystem has the RSHARED mount option enabled. +// See the supported options in flags.go for further reference. +func MakeRShared(mountPoint string) error { + return ensureMountedAs(mountPoint, "rshared") +} + +// MakePrivate ensures a mounted filesystem has the PRIVATE mount option enabled. +// See the supported options in flags.go for further reference. +func MakePrivate(mountPoint string) error { + return ensureMountedAs(mountPoint, "private") +} + +// MakeRPrivate ensures a mounted filesystem has the RPRIVATE mount option +// enabled. See the supported options in flags.go for further reference. +func MakeRPrivate(mountPoint string) error { + return ensureMountedAs(mountPoint, "rprivate") +} + +// MakeSlave ensures a mounted filesystem has the SLAVE mount option enabled. +// See the supported options in flags.go for further reference. +func MakeSlave(mountPoint string) error { + return ensureMountedAs(mountPoint, "slave") +} + +// MakeRSlave ensures a mounted filesystem has the RSLAVE mount option enabled. +// See the supported options in flags.go for further reference. +func MakeRSlave(mountPoint string) error { + return ensureMountedAs(mountPoint, "rslave") +} + +// MakeUnbindable ensures a mounted filesystem has the UNBINDABLE mount option +// enabled. See the supported options in flags.go for further reference. +func MakeUnbindable(mountPoint string) error { + return ensureMountedAs(mountPoint, "unbindable") +} + +// MakeRUnbindable ensures a mounted filesystem has the RUNBINDABLE mount +// option enabled. See the supported options in flags.go for further reference. +func MakeRUnbindable(mountPoint string) error { + return ensureMountedAs(mountPoint, "runbindable") +} + +func ensureMountedAs(mountPoint, options string) error { + mounted, err := Mounted(mountPoint) + if err != nil { + return err + } + + if !mounted { + if err := Mount(mountPoint, mountPoint, "none", "bind,rw"); err != nil { + return err + } + } + mounted, err = Mounted(mountPoint) + if err != nil { + return err + } + + return ForceMount("", mountPoint, "none", options) +} diff --git a/pkg/mount/sharedsubtree_linux_test.go b/pkg/mount/sharedsubtree_linux_test.go new file mode 100644 index 0000000000..4a8d22f02f --- /dev/null +++ b/pkg/mount/sharedsubtree_linux_test.go @@ -0,0 +1,331 @@ +// +build linux + +package mount + +import ( + "os" + "path" + "syscall" + "testing" +) + +// nothing is propagated in or out +func TestSubtreePrivate(t *testing.T) { + tmp := path.Join(os.TempDir(), "mount-tests") + if err := os.MkdirAll(tmp, 0777); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + var ( + sourceDir = path.Join(tmp, "source") + targetDir = path.Join(tmp, "target") + outside1Dir = path.Join(tmp, "outside1") + outside2Dir = path.Join(tmp, "outside2") + + outside1Path = path.Join(outside1Dir, "file.txt") + outside2Path = path.Join(outside2Dir, "file.txt") + outside1CheckPath = path.Join(targetDir, "a", "file.txt") + outside2CheckPath = path.Join(sourceDir, "b", "file.txt") + ) + if err := os.MkdirAll(path.Join(sourceDir, "a"), 0777); err != nil { + t.Fatal(err) + } + if err := os.MkdirAll(path.Join(sourceDir, "b"), 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(targetDir, 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(outside1Dir, 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(outside2Dir, 0777); err != nil { + t.Fatal(err) + } + + if err := createFile(outside1Path); err != nil { + t.Fatal(err) + } + if err := createFile(outside2Path); err != nil { + t.Fatal(err) + } + + // mount the shared directory to a target + if err := Mount(sourceDir, targetDir, "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + // next, make the target private + if err := MakePrivate(targetDir); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + // mount in an outside path to a mounted path inside the _source_ + if err := Mount(outside1Dir, path.Join(sourceDir, "a"), "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(path.Join(sourceDir, "a")); err != nil { + t.Fatal(err) + } + }() + + // check that this file _does_not_ show in the _target_ + if _, err := os.Stat(outside1CheckPath); err != nil && !os.IsNotExist(err) { + t.Fatal(err) + } else if err == nil { + t.Fatalf("%q should not be visible, but is", outside1CheckPath) + } + + // next mount outside2Dir into the _target_ + if err := Mount(outside2Dir, path.Join(targetDir, "b"), "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(path.Join(targetDir, "b")); err != nil { + t.Fatal(err) + } + }() + + // check that this file _does_not_ show in the _source_ + if _, err := os.Stat(outside2CheckPath); err != nil && !os.IsNotExist(err) { + t.Fatal(err) + } else if err == nil { + t.Fatalf("%q should not be visible, but is", outside2CheckPath) + } +} + +// Testing that when a target is a shared mount, +// then child mounts propagate to the source +func TestSubtreeShared(t *testing.T) { + tmp := path.Join(os.TempDir(), "mount-tests") + if err := os.MkdirAll(tmp, 0777); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + var ( + sourceDir = path.Join(tmp, "source") + targetDir = path.Join(tmp, "target") + outsideDir = path.Join(tmp, "outside") + + outsidePath = path.Join(outsideDir, "file.txt") + sourceCheckPath = path.Join(sourceDir, "a", "file.txt") + ) + + if err := os.MkdirAll(path.Join(sourceDir, "a"), 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(targetDir, 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(outsideDir, 0777); err != nil { + t.Fatal(err) + } + + if err := createFile(outsidePath); err != nil { + t.Fatal(err) + } + + // mount the source as shared + if err := MakeShared(sourceDir); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(sourceDir); err != nil { + t.Fatal(err) + } + }() + + // mount the shared directory to a target + if err := Mount(sourceDir, targetDir, "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + // mount in an outside path to a mounted path inside the target + if err := Mount(outsideDir, path.Join(targetDir, "a"), "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(path.Join(targetDir, "a")); err != nil { + t.Fatal(err) + } + }() + + // NOW, check that the file from the outside directory is avaible in the source directory + if _, err := os.Stat(sourceCheckPath); err != nil { + t.Fatal(err) + } +} + +// testing that mounts to a shared source show up in the slave target, +// and that mounts into a slave target do _not_ show up in the shared source +func TestSubtreeSharedSlave(t *testing.T) { + tmp := path.Join(os.TempDir(), "mount-tests") + if err := os.MkdirAll(tmp, 0777); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + var ( + sourceDir = path.Join(tmp, "source") + targetDir = path.Join(tmp, "target") + outside1Dir = path.Join(tmp, "outside1") + outside2Dir = path.Join(tmp, "outside2") + + outside1Path = path.Join(outside1Dir, "file.txt") + outside2Path = path.Join(outside2Dir, "file.txt") + outside1CheckPath = path.Join(targetDir, "a", "file.txt") + outside2CheckPath = path.Join(sourceDir, "b", "file.txt") + ) + if err := os.MkdirAll(path.Join(sourceDir, "a"), 0777); err != nil { + t.Fatal(err) + } + if err := os.MkdirAll(path.Join(sourceDir, "b"), 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(targetDir, 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(outside1Dir, 0777); err != nil { + t.Fatal(err) + } + if err := os.Mkdir(outside2Dir, 0777); err != nil { + t.Fatal(err) + } + + if err := createFile(outside1Path); err != nil { + t.Fatal(err) + } + if err := createFile(outside2Path); err != nil { + t.Fatal(err) + } + + // mount the source as shared + if err := MakeShared(sourceDir); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(sourceDir); err != nil { + t.Fatal(err) + } + }() + + // mount the shared directory to a target + if err := Mount(sourceDir, targetDir, "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + // next, make the target slave + if err := MakeSlave(targetDir); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() + + // mount in an outside path to a mounted path inside the _source_ + if err := Mount(outside1Dir, path.Join(sourceDir, "a"), "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(path.Join(sourceDir, "a")); err != nil { + t.Fatal(err) + } + }() + + // check that this file _does_ show in the _target_ + if _, err := os.Stat(outside1CheckPath); err != nil { + t.Fatal(err) + } + + // next mount outside2Dir into the _target_ + if err := Mount(outside2Dir, path.Join(targetDir, "b"), "none", "bind,rw"); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(path.Join(targetDir, "b")); err != nil { + t.Fatal(err) + } + }() + + // check that this file _does_not_ show in the _source_ + if _, err := os.Stat(outside2CheckPath); err != nil && !os.IsNotExist(err) { + t.Fatal(err) + } else if err == nil { + t.Fatalf("%q should not be visible, but is", outside2CheckPath) + } +} + +func TestSubtreeUnbindable(t *testing.T) { + tmp := path.Join(os.TempDir(), "mount-tests") + if err := os.MkdirAll(tmp, 0777); err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + + var ( + sourceDir = path.Join(tmp, "source") + targetDir = path.Join(tmp, "target") + ) + if err := os.MkdirAll(sourceDir, 0777); err != nil { + t.Fatal(err) + } + if err := os.MkdirAll(targetDir, 0777); err != nil { + t.Fatal(err) + } + + // next, make the source unbindable + if err := MakeUnbindable(sourceDir); err != nil { + t.Fatal(err) + } + defer func() { + if err := Unmount(sourceDir); err != nil { + t.Fatal(err) + } + }() + + // then attempt to mount it to target. It should fail + if err := Mount(sourceDir, targetDir, "none", "bind,rw"); err != nil && err != syscall.EINVAL { + t.Fatal(err) + } else if err == nil { + t.Fatalf("%q should not have been bindable", sourceDir) + } + defer func() { + if err := Unmount(targetDir); err != nil { + t.Fatal(err) + } + }() +} + +func createFile(path string) error { + f, err := os.Create(path) + if err != nil { + return err + } + f.WriteString("hello world!") + return f.Close() +} diff --git a/pkg/namesgenerator/cmd/names-generator/main.go b/pkg/namesgenerator/cmd/names-generator/main.go new file mode 100644 index 0000000000..18a939b70b --- /dev/null +++ b/pkg/namesgenerator/cmd/names-generator/main.go @@ -0,0 +1,11 @@ +package main + +import ( + "fmt" + + "github.com/docker/docker/pkg/namesgenerator" +) + +func main() { + fmt.Println(namesgenerator.GetRandomName(0)) +} diff --git a/pkg/namesgenerator/names-generator.go b/pkg/namesgenerator/names-generator.go new file mode 100644 index 0000000000..b44de8f630 --- /dev/null +++ b/pkg/namesgenerator/names-generator.go @@ -0,0 +1,492 @@ +package namesgenerator + +import ( + "fmt" + + "github.com/docker/docker/pkg/random" +) + +var ( + left = [...]string{ + "admiring", + "adoring", + "agitated", + "amazing", + "angry", + "awesome", + "backstabbing", + "berserk", + "big", + "boring", + "clever", + "cocky", + "compassionate", + "condescending", + "cranky", + "desperate", + "determined", + "distracted", + "dreamy", + "drunk", + "ecstatic", + "elated", + "elegant", + "evil", + "fervent", + "focused", + "furious", + "gigantic", + "gloomy", + "goofy", + "grave", + "happy", + "high", + "hopeful", + "hungry", + "insane", + "jolly", + "jovial", + "kickass", + "lonely", + "loving", + "mad", + "modest", + "naughty", + "nostalgic", + "pensive", + "prickly", + "reverent", + "romantic", + "sad", + "serene", + "sharp", + "sick", + "silly", + "sleepy", + "small", + "stoic", + "stupefied", + "suspicious", + "tender", + "thirsty", + "tiny", + "trusting", + } + + // Docker, starting from 0.7.x, generates names from notable scientists and hackers. + // Please, for any amazing man that you add to the list, consider adding an equally amazing woman to it, and vice versa. + right = [...]string{ + // Muhammad ibn Jābir al-Ḥarrānī al-Battānī was a founding father of astronomy. https://en.wikipedia.org/wiki/Mu%E1%B8%A5ammad_ibn_J%C4%81bir_al-%E1%B8%A4arr%C4%81n%C4%AB_al-Batt%C4%81n%C4%AB + "albattani", + + // Frances E. Allen, became the first female IBM Fellow in 1989. In 2006, she became the first female recipient of the ACM's Turing Award. https://en.wikipedia.org/wiki/Frances_E._Allen + "allen", + + // June Almeida - Scottish virologist who took the first pictures of the rubella virus - https://en.wikipedia.org/wiki/June_Almeida + "almeida", + + // Archimedes was a physicist, engineer and mathematician who invented too many things to list them here. https://en.wikipedia.org/wiki/Archimedes + "archimedes", + + // Maria Ardinghelli - Italian translator, mathematician and physicist - https://en.wikipedia.org/wiki/Maria_Ardinghelli + "ardinghelli", + + // Aryabhata - Ancient Indian mathematician-astronomer during 476-550 CE https://en.wikipedia.org/wiki/Aryabhata + "aryabhata", + + // Wanda Austin - Wanda Austin is the President and CEO of The Aerospace Corporation, a leading architect for the US security space programs. https://en.wikipedia.org/wiki/Wanda_Austin + "austin", + + // Charles Babbage invented the concept of a programmable computer. https://en.wikipedia.org/wiki/Charles_Babbage. + "babbage", + + // Stefan Banach - Polish mathematician, was one of the founders of modern functional analysis. https://en.wikipedia.org/wiki/Stefan_Banach + "banach", + + // John Bardeen co-invented the transistor - https://en.wikipedia.org/wiki/John_Bardeen + "bardeen", + + // Jean Bartik, born Betty Jean Jennings, was one of the original programmers for the ENIAC computer. https://en.wikipedia.org/wiki/Jean_Bartik + "bartik", + + // Alexander Graham Bell - an eminent Scottish-born scientist, inventor, engineer and innovator who is credited with inventing the first practical telephone - https://en.wikipedia.org/wiki/Alexander_Graham_Bell + "bell", + + // Homi J Bhabha - was an Indian nuclear physicist, founding director, and professor of physics at the Tata Institute of Fundamental Research. Colloquially known as "father of Indian nuclear programme"- https://en.wikipedia.org/wiki/Homi_J._Bhabha + "bhabha", + + // Bhaskara II - Ancient Indian mathematician-astronomer whose work on calculus predates Newton and Leibniz by over half a millennium - https://en.wikipedia.org/wiki/Bh%C4%81skara_II#Calculus + "bhaskara", + + // Elizabeth Blackwell - American doctor and first American woman to receive a medical degree - https://en.wikipedia.org/wiki/Elizabeth_Blackwell + "blackwell", + + // Niels Bohr is the father of quantum theory. https://en.wikipedia.org/wiki/Niels_Bohr. + "bohr", + + // Kathleen Booth, she's credited with writing the first assembly language. https://en.wikipedia.org/wiki/Kathleen_Booth + "booth", + + // Anita Borg - Anita Borg was the founding director of the Institute for Women and Technology (IWT). https://en.wikipedia.org/wiki/Anita_Borg + "borg", + + // Satyendra Nath Bose - He provided the foundation for Bose–Einstein statistics and the theory of the Bose–Einstein condensate. - https://en.wikipedia.org/wiki/Satyendra_Nath_Bose + "bose", + + // Evelyn Boyd Granville - She was one of the first African-American woman to receive a Ph.D. in mathematics; she earned it in 1949 from Yale University. https://en.wikipedia.org/wiki/Evelyn_Boyd_Granville + "boyd", + + // Brahmagupta - Ancient Indian mathematician during 598-670 CE who gave rules to compute with zero - https://en.wikipedia.org/wiki/Brahmagupta#Zero + "brahmagupta", + + // Walter Houser Brattain co-invented the transistor - https://en.wikipedia.org/wiki/Walter_Houser_Brattain + "brattain", + + // Emmett Brown invented time travel. https://en.wikipedia.org/wiki/Emmett_Brown (thanks Brian Goff) + "brown", + + // Rachel Carson - American marine biologist and conservationist, her book Silent Spring and other writings are credited with advancing the global environmental movement. https://en.wikipedia.org/wiki/Rachel_Carson + "carson", + + // Subrahmanyan Chandrasekhar - Astrophysicist known for his mathematical theory on different stages and evolution in structures of the stars. He has won nobel prize for physics - https://en.wikipedia.org/wiki/Subrahmanyan_Chandrasekhar + "chandrasekhar", + + // Jane Colden - American botanist widely considered the first female American botanist - https://en.wikipedia.org/wiki/Jane_Colden + "colden", + + // Gerty Theresa Cori - American biochemist who became the third woman—and first American woman—to win a Nobel Prize in science, and the first woman to be awarded the Nobel Prize in Physiology or Medicine. Cori was born in Prague. https://en.wikipedia.org/wiki/Gerty_Cori + "cori", + + // Seymour Roger Cray was an American electrical engineer and supercomputer architect who designed a series of computers that were the fastest in the world for decades. https://en.wikipedia.org/wiki/Seymour_Cray + "cray", + + // Marie Curie discovered radioactivity. https://en.wikipedia.org/wiki/Marie_Curie. + "curie", + + // Charles Darwin established the principles of natural evolution. https://en.wikipedia.org/wiki/Charles_Darwin. + "darwin", + + // Leonardo Da Vinci invented too many things to list here. https://en.wikipedia.org/wiki/Leonardo_da_Vinci. + "davinci", + + // Edsger Wybe Dijkstra was a Dutch computer scientist and mathematical scientist. https://en.wikipedia.org/wiki/Edsger_W._Dijkstra. + "dijkstra", + + // Donna Dubinsky - played an integral role in the development of personal digital assistants (PDAs) serving as CEO of Palm, Inc. and co-founding Handspring. https://en.wikipedia.org/wiki/Donna_Dubinsky + "dubinsky", + + // Annie Easley - She was a leading member of the team which developed software for the Centaur rocket stage and one of the first African-Americans in her field. https://en.wikipedia.org/wiki/Annie_Easley + "easley", + + // Albert Einstein invented the general theory of relativity. https://en.wikipedia.org/wiki/Albert_Einstein + "einstein", + + // Gertrude Elion - American biochemist, pharmacologist and the 1988 recipient of the Nobel Prize in Medicine - https://en.wikipedia.org/wiki/Gertrude_Elion + "elion", + + // Douglas Engelbart gave the mother of all demos: https://en.wikipedia.org/wiki/Douglas_Engelbart + "engelbart", + + // Euclid invented geometry. https://en.wikipedia.org/wiki/Euclid + "euclid", + + // Pierre de Fermat pioneered several aspects of modern mathematics. https://en.wikipedia.org/wiki/Pierre_de_Fermat + "fermat", + + // Enrico Fermi invented the first nuclear reactor. https://en.wikipedia.org/wiki/Enrico_Fermi. + "fermi", + + // Richard Feynman was a key contributor to quantum mechanics and particle physics. https://en.wikipedia.org/wiki/Richard_Feynman + "feynman", + + // Benjamin Franklin is famous for his experiments in electricity and the invention of the lightning rod. + "franklin", + + // Galileo was a founding father of modern astronomy, and faced politics and obscurantism to establish scientific truth. https://en.wikipedia.org/wiki/Galileo_Galilei + "galileo", + + // William Henry "Bill" Gates III is an American business magnate, philanthropist, investor, computer programmer, and inventor. https://en.wikipedia.org/wiki/Bill_Gates + "gates", + + // Adele Goldberg, was one of the designers and developers of the Smalltalk language. https://en.wikipedia.org/wiki/Adele_Goldberg_(computer_scientist) + "goldberg", + + // Adele Goldstine, born Adele Katz, wrote the complete technical description for the first electronic digital computer, ENIAC. https://en.wikipedia.org/wiki/Adele_Goldstine + "goldstine", + + // Jane Goodall - British primatologist, ethologist, and anthropologist who is considered to be the world's foremost expert on chimpanzees - https://en.wikipedia.org/wiki/Jane_Goodall + "goodall", + + // Margaret Hamilton - Director of the Software Engineering Division of the MIT Instrumentation Laboratory, which developed on-board flight software for the Apollo space program. https://en.wikipedia.org/wiki/Margaret_Hamilton_(scientist) + "hamilton", + + // Stephen Hawking pioneered the field of cosmology by combining general relativity and quantum mechanics. https://en.wikipedia.org/wiki/Stephen_Hawking + "hawking", + + // Werner Heisenberg was a founding father of quantum mechanics. https://en.wikipedia.org/wiki/Werner_Heisenberg + "heisenberg", + + // Dorothy Hodgkin was a British biochemist, credited with the development of protein crystallography. She was awarded the Nobel Prize in Chemistry in 1964. https://en.wikipedia.org/wiki/Dorothy_Hodgkin + "hodgkin", + + // Erna Schneider Hoover revolutionized modern communication by inventing a computerized telephon switching method. https://en.wikipedia.org/wiki/Erna_Schneider_Hoover + "hoover", + + // Grace Hopper developed the first compiler for a computer programming language and is credited with popularizing the term "debugging" for fixing computer glitches. https://en.wikipedia.org/wiki/Grace_Hopper + "hopper", + + // Frances Hugle, she was an American scientist, engineer, and inventor who contributed to the understanding of semiconductors, integrated circuitry, and the unique electrical principles of microscopic materials. https://en.wikipedia.org/wiki/Frances_Hugle + "hugle", + + // Hypatia - Greek Alexandrine Neoplatonist philosopher in Egypt who was one of the earliest mothers of mathematics - https://en.wikipedia.org/wiki/Hypatia + "hypatia", + + // Yeong-Sil Jang was a Korean scientist and astronomer during the Joseon Dynasty; he invented the first metal printing press and water gauge. https://en.wikipedia.org/wiki/Jang_Yeong-sil + "jang", + + // Betty Jennings - one of the original programmers of the ENIAC. https://en.wikipedia.org/wiki/ENIAC - https://en.wikipedia.org/wiki/Jean_Bartik + "jennings", + + // Mary Lou Jepsen, was the founder and chief technology officer of One Laptop Per Child (OLPC), and the founder of Pixel Qi. https://en.wikipedia.org/wiki/Mary_Lou_Jepsen + "jepsen", + + // Irène Joliot-Curie - French scientist who was awarded the Nobel Prize for Chemistry in 1935. Daughter of Marie and Pierre Curie. https://en.wikipedia.org/wiki/Ir%C3%A8ne_Joliot-Curie + "joliot", + + // Karen Spärck Jones came up with the concept of inverse document frequency, which is used in most search engines today. https://en.wikipedia.org/wiki/Karen_Sp%C3%A4rck_Jones + "jones", + + // A. P. J. Abdul Kalam - is an Indian scientist aka Missile Man of India for his work on the development of ballistic missile and launch vehicle technology - https://en.wikipedia.org/wiki/A._P._J._Abdul_Kalam + "kalam", + + // Susan Kare, created the icons and many of the interface elements for the original Apple Macintosh in the 1980s, and was an original employee of NeXT, working as the Creative Director. https://en.wikipedia.org/wiki/Susan_Kare + "kare", + + // Mary Kenneth Keller, Sister Mary Kenneth Keller became the first American woman to earn a PhD in Computer Science in 1965. https://en.wikipedia.org/wiki/Mary_Kenneth_Keller + "keller", + + // Har Gobind Khorana - Indian-American biochemist who shared the 1968 Nobel Prize for Physiology - https://en.wikipedia.org/wiki/Har_Gobind_Khorana + "khorana", + + // Jack Kilby invented silicone integrated circuits and gave Silicon Valley its name. - https://en.wikipedia.org/wiki/Jack_Kilby + "kilby", + + // Maria Kirch - German astronomer and first woman to discover a comet - https://en.wikipedia.org/wiki/Maria_Margarethe_Kirch + "kirch", + + // Donald Knuth - American computer scientist, author of "The Art of Computer Programming" and creator of the TeX typesetting system. https://en.wikipedia.org/wiki/Donald_Knuth + "knuth", + + // Sophie Kowalevski - Russian mathematician responsible for important original contributions to analysis, differential equations and mechanics - https://en.wikipedia.org/wiki/Sofia_Kovalevskaya + "kowalevski", + + // Marie-Jeanne de Lalande - French astronomer, mathematician and cataloguer of stars - https://en.wikipedia.org/wiki/Marie-Jeanne_de_Lalande + "lalande", + + // Hedy Lamarr - Actress and inventor. The principles of her work are now incorporated into modern Wi-Fi, CDMA and Bluetooth technology. https://en.wikipedia.org/wiki/Hedy_Lamarr + "lamarr", + + // Mary Leakey - British paleoanthropologist who discovered the first fossilized Proconsul skull - https://en.wikipedia.org/wiki/Mary_Leakey + "leakey", + + // Henrietta Swan Leavitt - she was an American astronomer who discovered the relation between the luminosity and the period of Cepheid variable stars. https://en.wikipedia.org/wiki/Henrietta_Swan_Leavitt + "leavitt", + + // Ruth Lichterman - one of the original programmers of the ENIAC. https://en.wikipedia.org/wiki/ENIAC - https://en.wikipedia.org/wiki/Ruth_Teitelbaum + "lichterman", + + // Barbara Liskov - co-developed the Liskov substitution principle. Liskov was also the winner of the Turing Prize in 2008. - https://en.wikipedia.org/wiki/Barbara_Liskov + "liskov", + + // Ada Lovelace invented the first algorithm. https://en.wikipedia.org/wiki/Ada_Lovelace (thanks James Turnbull) + "lovelace", + + // Auguste and Louis Lumière - the first filmmakers in history - https://en.wikipedia.org/wiki/Auguste_and_Louis_Lumi%C3%A8re + "lumiere", + + // Mahavira - Ancient Indian mathematician during 9th century AD who discovered basic algebraic identities - https://en.wikipedia.org/wiki/Mah%C4%81v%C4%ABra_(mathematician) + "mahavira", + + // Maria Mayer - American theoretical physicist and Nobel laureate in Physics for proposing the nuclear shell model of the atomic nucleus - https://en.wikipedia.org/wiki/Maria_Mayer + "mayer", + + // John McCarthy invented LISP: https://en.wikipedia.org/wiki/John_McCarthy_(computer_scientist) + "mccarthy", + + // Barbara McClintock - a distinguished American cytogeneticist, 1983 Nobel Laureate in Physiology or Medicine for discovering transposons. https://en.wikipedia.org/wiki/Barbara_McClintock + "mcclintock", + + // Malcolm McLean invented the modern shipping container: https://en.wikipedia.org/wiki/Malcom_McLean + "mclean", + + // Kay McNulty - one of the original programmers of the ENIAC. https://en.wikipedia.org/wiki/ENIAC - https://en.wikipedia.org/wiki/Kathleen_Antonelli + "mcnulty", + + // Lise Meitner - Austrian/Swedish physicist who was involved in the discovery of nuclear fission. The element meitnerium is named after her - https://en.wikipedia.org/wiki/Lise_Meitner + "meitner", + + // Carla Meninsky, was the game designer and programmer for Atari 2600 games Dodge 'Em and Warlords. https://en.wikipedia.org/wiki/Carla_Meninsky + "meninsky", + + // Johanna Mestorf - German prehistoric archaeologist and first female museum director in Germany - https://en.wikipedia.org/wiki/Johanna_Mestorf + "mestorf", + + // Lise Meitner was an Austrian physicist who worked on radioactivity and nuclear physics. She played a major role in the discovery of nuclear fission. https://en.wikipedia.org/wiki/Lise_Meitner + "mietner", + + // Maryam Mirzakhani - an Iranian mathematician and the first woman to win the Fields Medal. https://en.wikipedia.org/wiki/Maryam_Mirzakhani + "mirzakhani", + + // Samuel Morse - contributed to the invention of a single-wire telegraph system based on European telegraphs and was a co-developer of the Morse code - https://en.wikipedia.org/wiki/Samuel_Morse + "morse", + + // Isaac Newton invented classic mechanics and modern optics. https://en.wikipedia.org/wiki/Isaac_Newton + "newton", + + // Alfred Nobel - a Swedish chemist, engineer, innovator, and armaments manufacturer (inventor of dynamite) - https://en.wikipedia.org/wiki/Alfred_Nobel + "nobel", + + // Poppy Northcutt. Poppy Northcutt was the first woman to work as part of NASA’s Mission Control. http://www.businessinsider.com/poppy-northcutt-helped-apollo-astronauts-2014-12?op=1 + "northcutt", + + // Robert Noyce invented silicone integrated circuits and gave Silicon Valley its name. - https://en.wikipedia.org/wiki/Robert_Noyce + "noyce", + + // Panini - Ancient Indian linguist and grammarian from 4th century CE who worked on the world's first formal system - https://en.wikipedia.org/wiki/P%C4%81%E1%B9%87ini#Comparison_with_modern_formal_systems + "panini", + + // Ambroise Pare invented modern surgery. https://en.wikipedia.org/wiki/Ambroise_Par%C3%A9 + "pare", + + // Louis Pasteur discovered vaccination, fermentation and pasteurization. https://en.wikipedia.org/wiki/Louis_Pasteur. + "pasteur", + + // Cecilia Payne-Gaposchkin was an astronomer and astrophysicist who, in 1925, proposed in her Ph.D. thesis an explanation for the composition of stars in terms of the relative abundances of hydrogen and helium. https://en.wikipedia.org/wiki/Cecilia_Payne-Gaposchkin + "payne", + + // Radia Perlman is a software designer and network engineer and most famous for her invention of the spanning-tree protocol (STP). https://en.wikipedia.org/wiki/Radia_Perlman + "perlman", + + // Rob Pike was a key contributor to Unix, Plan 9, the X graphic system, utf-8, and the Go programming language. https://en.wikipedia.org/wiki/Rob_Pike + "pike", + + // Henri Poincaré made fundamental contributions in several fields of mathematics. https://en.wikipedia.org/wiki/Henri_Poincar%C3%A9 + "poincare", + + // Laura Poitras is a director and producer whose work, made possible by open source crypto tools, advances the causes of truth and freedom of information by reporting disclosures by whistleblowers such as Edward Snowden. https://en.wikipedia.org/wiki/Laura_Poitras + "poitras", + + // Claudius Ptolemy - a Greco-Egyptian writer of Alexandria, known as a mathematician, astronomer, geographer, astrologer, and poet of a single epigram in the Greek Anthology - https://en.wikipedia.org/wiki/Ptolemy + "ptolemy", + + // C. V. Raman - Indian physicist who won the Nobel Prize in 1930 for proposing the Raman effect. - https://en.wikipedia.org/wiki/C._V._Raman + "raman", + + // Srinivasa Ramanujan - Indian mathematician and autodidact who made extraordinary contributions to mathematical analysis, number theory, infinite series, and continued fractions. - https://en.wikipedia.org/wiki/Srinivasa_Ramanujan + "ramanujan", + + // Sally Kristen Ride was an American physicist and astronaut. She was the first American woman in space, and the youngest American astronaut. https://en.wikipedia.org/wiki/Sally_Ride + "ride", + + // Dennis Ritchie - co-creator of UNIX and the C programming language. - https://en.wikipedia.org/wiki/Dennis_Ritchie + "ritchie", + + // Wilhelm Conrad Röntgen - German physicist who was awarded the first Nobel Prize in Physics in 1901 for the discovery of X-rays (Röntgen rays). https://en.wikipedia.org/wiki/Wilhelm_R%C3%B6ntgen + "roentgen", + + // Rosalind Franklin - British biophysicist and X-ray crystallographer whose research was critical to the understanding of DNA - https://en.wikipedia.org/wiki/Rosalind_Franklin + "rosalind", + + // Meghnad Saha - Indian astrophysicist best known for his development of the Saha equation, used to describe chemical and physical conditions in stars - https://en.wikipedia.org/wiki/Meghnad_Saha + "saha", + + // Jean E. Sammet developed FORMAC, the first widely used computer language for symbolic manipulation of mathematical formulas. https://en.wikipedia.org/wiki/Jean_E._Sammet + "sammet", + + // Carol Shaw - Originally an Atari employee, Carol Shaw is said to be the first female video game designer. https://en.wikipedia.org/wiki/Carol_Shaw_(video_game_designer) + "shaw", + + // William Shockley co-invented the transistor - https://en.wikipedia.org/wiki/William_Shockley + "shockley", + + // Françoise Barré-Sinoussi - French virologist and Nobel Prize Laureate in Physiology or Medicine; her work was fundamental in identifying HIV as the cause of AIDS. https://en.wikipedia.org/wiki/Fran%C3%A7oise_Barr%C3%A9-Sinoussi + "sinoussi", + + // Betty Snyder - one of the original programmers of the ENIAC. https://en.wikipedia.org/wiki/ENIAC - https://en.wikipedia.org/wiki/Betty_Holberton + "snyder", + + // Frances Spence - one of the original programmers of the ENIAC. https://en.wikipedia.org/wiki/ENIAC - https://en.wikipedia.org/wiki/Frances_Spence + "spence", + + // Richard Matthew Stallman - the founder of the Free Software movement, the GNU project, the Free Software Foundation, and the League for Programming Freedom. He also invented the concept of copyleft to protect the ideals of this movement, and enshrined this concept in the widely-used GPL (General Public License) for software. https://en.wikiquote.org/wiki/Richard_Stallman + "stallman", + + // Janese Swanson (with others) developed the first of the Carmen Sandiego games. She went on to found Girl Tech. https://en.wikipedia.org/wiki/Janese_Swanson + "swanson", + + // Aaron Swartz was influential in creating RSS, Markdown, Creative Commons, Reddit, and much of the internet as we know it today. He was devoted to freedom of information on the web. https://en.wikiquote.org/wiki/Aaron_Swartz + "swartz", + + // Bertha Swirles was a theoretical physicist who made a number of contributions to early quantum theory. https://en.wikipedia.org/wiki/Bertha_Swirles + "swirles", + + // Nikola Tesla invented the AC electric system and every gadget ever used by a James Bond villain. https://en.wikipedia.org/wiki/Nikola_Tesla + "tesla", + + // Ken Thompson - co-creator of UNIX and the C programming language - https://en.wikipedia.org/wiki/Ken_Thompson + "thompson", + + // Linus Torvalds invented Linux and Git. https://en.wikipedia.org/wiki/Linus_Torvalds + "torvalds", + + // Alan Turing was a founding father of computer science. https://en.wikipedia.org/wiki/Alan_Turing. + "turing", + + // Varahamihira - Ancient Indian mathematician who discovered trigonometric formulae during 505-587 CE - https://en.wikipedia.org/wiki/Var%C4%81hamihira#Contributions + "varahamihira", + + // Sir Mokshagundam Visvesvaraya - is a notable Indian engineer. He is a recipient of the Indian Republic's highest honour, the Bharat Ratna, in 1955. On his birthday, 15 September is celebrated as Engineer's Day in India in his memory - https://en.wikipedia.org/wiki/Visvesvaraya + "visvesvaraya", + + // Marlyn Wescoff - one of the original programmers of the ENIAC. https://en.wikipedia.org/wiki/ENIAC - https://en.wikipedia.org/wiki/Marlyn_Meltzer + "wescoff", + + // Roberta Williams, did pioneering work in graphical adventure games for personal computers, particularly the King's Quest series. https://en.wikipedia.org/wiki/Roberta_Williams + "williams", + + // Sophie Wilson designed the first Acorn Micro-Computer and the instruction set for ARM processors. https://en.wikipedia.org/wiki/Sophie_Wilson + "wilson", + + // Jeannette Wing - co-developed the Liskov substitution principle. - https://en.wikipedia.org/wiki/Jeannette_Wing + "wing", + + // Steve Wozniak invented the Apple I and Apple II. https://en.wikipedia.org/wiki/Steve_Wozniak + "wozniak", + + // The Wright brothers, Orville and Wilbur - credited with inventing and building the world's first successful airplane and making the first controlled, powered and sustained heavier-than-air human flight - https://en.wikipedia.org/wiki/Wright_brothers + "wright", + + // Rosalyn Sussman Yalow - Rosalyn Sussman Yalow was an American medical physicist, and a co-winner of the 1977 Nobel Prize in Physiology or Medicine for development of the radioimmunoassay technique. https://en.wikipedia.org/wiki/Rosalyn_Sussman_Yalow + "yalow", + + // Ada Yonath - an Israeli crystallographer, the first woman from the Middle East to win a Nobel prize in the sciences. https://en.wikipedia.org/wiki/Ada_Yonath + "yonath", + } +) + +// GetRandomName generates a random name from the list of adjectives and surnames in this package +// formatted as "adjective_surname". For example 'focused_turing'. If retry is non-zero, a random +// integer between 0 and 10 will be added to the end of the name, e.g `focused_turing3` +func GetRandomName(retry int) string { + rnd := random.Rand +begin: + name := fmt.Sprintf("%s_%s", left[rnd.Intn(len(left))], right[rnd.Intn(len(right))]) + if name == "boring_wozniak" /* Steve Wozniak is not boring */ { + goto begin + } + + if retry > 0 { + name = fmt.Sprintf("%s%d", name, rnd.Intn(10)) + } + return name +} diff --git a/pkg/namesgenerator/names-generator_test.go b/pkg/namesgenerator/names-generator_test.go new file mode 100644 index 0000000000..f7dae2766c --- /dev/null +++ b/pkg/namesgenerator/names-generator_test.go @@ -0,0 +1,45 @@ +package namesgenerator + +import ( + "strings" + "testing" +) + +// Make sure the generated names are awesome +func TestGenerateAwesomeNames(t *testing.T) { + name := GetRandomName(0) + if !isAwesome(name) { + t.Fatalf("Generated name '%s' is not awesome.", name) + } +} + +func TestNameFormat(t *testing.T) { + name := GetRandomName(0) + if !strings.Contains(name, "_") { + t.Fatalf("Generated name does not contain an underscore") + } + if strings.ContainsAny(name, "0123456789") { + t.Fatalf("Generated name contains numbers!") + } +} + +func TestNameRetries(t *testing.T) { + name := GetRandomName(1) + if !strings.Contains(name, "_") { + t.Fatalf("Generated name does not contain an underscore") + } + if !strings.ContainsAny(name, "0123456789") { + t.Fatalf("Generated name doesn't contain a number") + } + +} + +// To be awesome, a container name must involve cool inventors, be easy to remember, +// be at least mildly funny, and always be politically correct for enterprise adoption. +func isAwesome(name string) bool { + coolInventorNames := true + easyToRemember := true + mildlyFunnyOnOccasion := true + politicallyCorrect := true + return coolInventorNames && easyToRemember && mildlyFunnyOnOccasion && politicallyCorrect +} diff --git a/pkg/nat/nat.go b/pkg/nat/nat.go new file mode 100644 index 0000000000..6595feb055 --- /dev/null +++ b/pkg/nat/nat.go @@ -0,0 +1,227 @@ +package nat + +// nat is a convenience package for docker's manipulation of strings describing +// network ports. + +import ( + "fmt" + "net" + "strconv" + "strings" + + "github.com/docker/docker/pkg/parsers" +) + +const ( + // portSpecTemplate is the expected format for port specifications + portSpecTemplate = "ip:hostPort:containerPort" +) + +// PortBinding represents a binding between a Host IP address and a Host Port +type PortBinding struct { + // HostIP is the host IP Address + HostIP string `json:"HostIp"` + // HostPort is the host port number + HostPort string +} + +// PortMap is a collection of PortBinding indexed by Port +type PortMap map[Port][]PortBinding + +// PortSet is a collection of structs indexed by Port +type PortSet map[Port]struct{} + +// Port is a string containing port number and protocol in the format "80/tcp" +type Port string + +// NewPort creates a new instance of a Port given a protocol and port number or port range +func NewPort(proto, port string) (Port, error) { + // Check for parsing issues on "port" now so we can avoid having + // to check it later on. + + portStartInt, portEndInt, err := ParsePortRange(port) + if err != nil { + return "", err + } + + if portStartInt == portEndInt { + return Port(fmt.Sprintf("%d/%s", portStartInt, proto)), nil + } + return Port(fmt.Sprintf("%d-%d/%s", portStartInt, portEndInt, proto)), nil +} + +// ParsePort parses the port number string and returns an int +func ParsePort(rawPort string) (int, error) { + if len(rawPort) == 0 { + return 0, nil + } + port, err := strconv.ParseUint(rawPort, 10, 16) + if err != nil { + return 0, err + } + return int(port), nil +} + +// ParsePortRange parses the port range string and returns start/end ints +func ParsePortRange(rawPort string) (int, int, error) { + if len(rawPort) == 0 { + return 0, 0, nil + } + start, end, err := parsers.ParsePortRange(rawPort) + if err != nil { + return 0, 0, err + } + return int(start), int(end), nil +} + +// Proto returns the protocol of a Port +func (p Port) Proto() string { + proto, _ := SplitProtoPort(string(p)) + return proto +} + +// Port returns the port number of a Port +func (p Port) Port() string { + _, port := SplitProtoPort(string(p)) + return port +} + +// Int returns the port number of a Port as an int +func (p Port) Int() int { + portStr := p.Port() + if len(portStr) == 0 { + return 0 + } + + // We don't need to check for an error because we're going to + // assume that any error would have been found, and reported, in NewPort() + port, _ := strconv.ParseUint(portStr, 10, 16) + return int(port) +} + +// Range returns the start/end port numbers of a Port range as ints +func (p Port) Range() (int, int, error) { + return ParsePortRange(p.Port()) +} + +// SplitProtoPort splits a port in the format of proto/port +func SplitProtoPort(rawPort string) (string, string) { + parts := strings.Split(rawPort, "/") + l := len(parts) + if len(rawPort) == 0 || l == 0 || len(parts[0]) == 0 { + return "", "" + } + if l == 1 { + return "tcp", rawPort + } + if len(parts[1]) == 0 { + return "tcp", parts[0] + } + return parts[1], parts[0] +} + +func validateProto(proto string) bool { + for _, availableProto := range []string{"tcp", "udp"} { + if availableProto == proto { + return true + } + } + return false +} + +// ParsePortSpecs receives port specs in the format of ip:public:private/proto and parses +// these in to the internal types +func ParsePortSpecs(ports []string) (map[Port]struct{}, map[Port][]PortBinding, error) { + var ( + exposedPorts = make(map[Port]struct{}, len(ports)) + bindings = make(map[Port][]PortBinding) + ) + + for _, rawPort := range ports { + proto := "tcp" + + if i := strings.LastIndex(rawPort, "/"); i != -1 { + proto = rawPort[i+1:] + rawPort = rawPort[:i] + } + if !strings.Contains(rawPort, ":") { + rawPort = fmt.Sprintf("::%s", rawPort) + } else if len(strings.Split(rawPort, ":")) == 2 { + rawPort = fmt.Sprintf(":%s", rawPort) + } + + parts, err := parsers.PartParser(portSpecTemplate, rawPort) + if err != nil { + return nil, nil, err + } + + var ( + containerPort = parts["containerPort"] + rawIP = parts["ip"] + hostPort = parts["hostPort"] + ) + + if rawIP != "" && net.ParseIP(rawIP) == nil { + return nil, nil, fmt.Errorf("Invalid ip address: %s", rawIP) + } + if containerPort == "" { + return nil, nil, fmt.Errorf("No port specified: %s", rawPort) + } + + startPort, endPort, err := parsers.ParsePortRange(containerPort) + if err != nil { + return nil, nil, fmt.Errorf("Invalid containerPort: %s", containerPort) + } + + var startHostPort, endHostPort uint64 = 0, 0 + if len(hostPort) > 0 { + startHostPort, endHostPort, err = parsers.ParsePortRange(hostPort) + if err != nil { + return nil, nil, fmt.Errorf("Invalid hostPort: %s", hostPort) + } + } + + if hostPort != "" && (endPort-startPort) != (endHostPort-startHostPort) { + // Allow host port range iff containerPort is not a range. + // In this case, use the host port range as the dynamic + // host port range to allocate into. + if endPort != startPort { + return nil, nil, fmt.Errorf("Invalid ranges specified for container and host Ports: %s and %s", containerPort, hostPort) + } + } + + if !validateProto(strings.ToLower(proto)) { + return nil, nil, fmt.Errorf("Invalid proto: %s", proto) + } + + for i := uint64(0); i <= (endPort - startPort); i++ { + containerPort = strconv.FormatUint(startPort+i, 10) + if len(hostPort) > 0 { + hostPort = strconv.FormatUint(startHostPort+i, 10) + } + // Set hostPort to a range only if there is a single container port + // and a dynamic host port. + if startPort == endPort && startHostPort != endHostPort { + hostPort = fmt.Sprintf("%s-%s", hostPort, strconv.FormatUint(endHostPort, 10)) + } + port, err := NewPort(strings.ToLower(proto), containerPort) + if err != nil { + return nil, nil, err + } + if _, exists := exposedPorts[port]; !exists { + exposedPorts[port] = struct{}{} + } + + binding := PortBinding{ + HostIP: rawIP, + HostPort: hostPort, + } + bslice, exists := bindings[port] + if !exists { + bslice = []PortBinding{} + } + bindings[port] = append(bslice, binding) + } + } + return exposedPorts, bindings, nil +} diff --git a/pkg/nat/nat_test.go b/pkg/nat/nat_test.go new file mode 100644 index 0000000000..2c71142bad --- /dev/null +++ b/pkg/nat/nat_test.go @@ -0,0 +1,525 @@ +package nat + +import ( + "testing" +) + +func TestParsePort(t *testing.T) { + var ( + p int + err error + ) + + p, err = ParsePort("1234") + + if err != nil || p != 1234 { + t.Fatal("Parsing '1234' did not succeed") + } + + // FIXME currently this is a valid port. I don't think it should be. + // I'm leaving this test commented out until we make a decision. + // - erikh + + /* + p, err = ParsePort("0123") + + if err != nil { + t.Fatal("Successfully parsed port '0123' to '123'") + } + */ + + p, err = ParsePort("asdf") + + if err == nil || p != 0 { + t.Fatal("Parsing port 'asdf' succeeded") + } + + p, err = ParsePort("1asdf") + + if err == nil || p != 0 { + t.Fatal("Parsing port '1asdf' succeeded") + } +} + +func TestParsePortRange(t *testing.T) { + var ( + begin int + end int + err error + ) + + type TestRange struct { + Range string + Begin int + End int + } + validRanges := []TestRange{ + {"1234", 1234, 1234}, + {"1234-1234", 1234, 1234}, + {"1234-1235", 1234, 1235}, + {"8000-9000", 8000, 9000}, + {"0", 0, 0}, + {"0-0", 0, 0}, + } + + for _, r := range validRanges { + begin, end, err = ParsePortRange(r.Range) + + if err != nil || begin != r.Begin { + t.Fatalf("Parsing port range '%s' did not succeed. Expected begin %d, got %d", r.Range, r.Begin, begin) + } + if err != nil || end != r.End { + t.Fatalf("Parsing port range '%s' did not succeed. Expected end %d, got %d", r.Range, r.End, end) + } + } + + invalidRanges := []string{ + "asdf", + "1asdf", + "9000-8000", + "9000-", + "-8000", + "-8000-", + } + + for _, r := range invalidRanges { + begin, end, err = ParsePortRange(r) + + if err == nil || begin != 0 || end != 0 { + t.Fatalf("Parsing port range '%s' succeeded", r) + } + } +} + +func TestPort(t *testing.T) { + p, err := NewPort("tcp", "1234") + + if err != nil { + t.Fatalf("tcp, 1234 had a parsing issue: %v", err) + } + + if string(p) != "1234/tcp" { + t.Fatal("tcp, 1234 did not result in the string 1234/tcp") + } + + if p.Proto() != "tcp" { + t.Fatal("protocol was not tcp") + } + + if p.Port() != "1234" { + t.Fatal("port string value was not 1234") + } + + if p.Int() != 1234 { + t.Fatal("port int value was not 1234") + } + + p, err = NewPort("tcp", "asd1234") + if err == nil { + t.Fatal("tcp, asd1234 was supposed to fail") + } + + p, err = NewPort("tcp", "1234-1230") + if err == nil { + t.Fatal("tcp, 1234-1230 was supposed to fail") + } + + p, err = NewPort("tcp", "1234-1242") + if err != nil { + t.Fatalf("tcp, 1234-1242 had a parsing issue: %v", err) + } + + if string(p) != "1234-1242/tcp" { + t.Fatal("tcp, 1234-1242 did not result in the string 1234-1242/tcp") + } +} + +func TestSplitProtoPort(t *testing.T) { + var ( + proto string + port string + ) + + proto, port = SplitProtoPort("1234/tcp") + + if proto != "tcp" || port != "1234" { + t.Fatal("Could not split 1234/tcp properly") + } + + proto, port = SplitProtoPort("") + + if proto != "" || port != "" { + t.Fatal("parsing an empty string yielded surprising results", proto, port) + } + + proto, port = SplitProtoPort("1234") + + if proto != "tcp" || port != "1234" { + t.Fatal("tcp is not the default protocol for portspec '1234'", proto, port) + } + + proto, port = SplitProtoPort("1234/") + + if proto != "tcp" || port != "1234" { + t.Fatal("parsing '1234/' yielded:" + port + "/" + proto) + } + + proto, port = SplitProtoPort("/tcp") + + if proto != "" || port != "" { + t.Fatal("parsing '/tcp' yielded:" + port + "/" + proto) + } +} + +func TestParsePortSpecs(t *testing.T) { + var ( + portMap map[Port]struct{} + bindingMap map[Port][]PortBinding + err error + ) + + portMap, bindingMap, err = ParsePortSpecs([]string{"1234/tcp", "2345/udp"}) + + if err != nil { + t.Fatalf("Error while processing ParsePortSpecs: %s", err) + } + + if _, ok := portMap[Port("1234/tcp")]; !ok { + t.Fatal("1234/tcp was not parsed properly") + } + + if _, ok := portMap[Port("2345/udp")]; !ok { + t.Fatal("2345/udp was not parsed properly") + } + + for portspec, bindings := range bindingMap { + if len(bindings) != 1 { + t.Fatalf("%s should have exactly one binding", portspec) + } + + if bindings[0].HostIP != "" { + t.Fatalf("HostIP should not be set for %s", portspec) + } + + if bindings[0].HostPort != "" { + t.Fatalf("HostPort should not be set for %s", portspec) + } + } + + portMap, bindingMap, err = ParsePortSpecs([]string{"1234:1234/tcp", "2345:2345/udp"}) + + if err != nil { + t.Fatalf("Error while processing ParsePortSpecs: %s", err) + } + + if _, ok := portMap[Port("1234/tcp")]; !ok { + t.Fatal("1234/tcp was not parsed properly") + } + + if _, ok := portMap[Port("2345/udp")]; !ok { + t.Fatal("2345/udp was not parsed properly") + } + + for portspec, bindings := range bindingMap { + _, port := SplitProtoPort(string(portspec)) + + if len(bindings) != 1 { + t.Fatalf("%s should have exactly one binding", portspec) + } + + if bindings[0].HostIP != "" { + t.Fatalf("HostIP should not be set for %s", portspec) + } + + if bindings[0].HostPort != port { + t.Fatalf("HostPort should be %s for %s", port, portspec) + } + } + + portMap, bindingMap, err = ParsePortSpecs([]string{"0.0.0.0:1234:1234/tcp", "0.0.0.0:2345:2345/udp"}) + + if err != nil { + t.Fatalf("Error while processing ParsePortSpecs: %s", err) + } + + if _, ok := portMap[Port("1234/tcp")]; !ok { + t.Fatal("1234/tcp was not parsed properly") + } + + if _, ok := portMap[Port("2345/udp")]; !ok { + t.Fatal("2345/udp was not parsed properly") + } + + for portspec, bindings := range bindingMap { + _, port := SplitProtoPort(string(portspec)) + + if len(bindings) != 1 { + t.Fatalf("%s should have exactly one binding", portspec) + } + + if bindings[0].HostIP != "0.0.0.0" { + t.Fatalf("HostIP is not 0.0.0.0 for %s", portspec) + } + + if bindings[0].HostPort != port { + t.Fatalf("HostPort should be %s for %s", port, portspec) + } + } + + _, _, err = ParsePortSpecs([]string{"localhost:1234:1234/tcp"}) + + if err == nil { + t.Fatal("Received no error while trying to parse a hostname instead of ip") + } +} + +func TestParsePortSpecsWithRange(t *testing.T) { + var ( + portMap map[Port]struct{} + bindingMap map[Port][]PortBinding + err error + ) + + portMap, bindingMap, err = ParsePortSpecs([]string{"1234-1236/tcp", "2345-2347/udp"}) + + if err != nil { + t.Fatalf("Error while processing ParsePortSpecs: %s", err) + } + + if _, ok := portMap[Port("1235/tcp")]; !ok { + t.Fatal("1234/tcp was not parsed properly") + } + + if _, ok := portMap[Port("2346/udp")]; !ok { + t.Fatal("2345/udp was not parsed properly") + } + + for portspec, bindings := range bindingMap { + if len(bindings) != 1 { + t.Fatalf("%s should have exactly one binding", portspec) + } + + if bindings[0].HostIP != "" { + t.Fatalf("HostIP should not be set for %s", portspec) + } + + if bindings[0].HostPort != "" { + t.Fatalf("HostPort should not be set for %s", portspec) + } + } + + portMap, bindingMap, err = ParsePortSpecs([]string{"1234-1236:1234-1236/tcp", "2345-2347:2345-2347/udp"}) + + if err != nil { + t.Fatalf("Error while processing ParsePortSpecs: %s", err) + } + + if _, ok := portMap[Port("1235/tcp")]; !ok { + t.Fatal("1234/tcp was not parsed properly") + } + + if _, ok := portMap[Port("2346/udp")]; !ok { + t.Fatal("2345/udp was not parsed properly") + } + + for portspec, bindings := range bindingMap { + _, port := SplitProtoPort(string(portspec)) + if len(bindings) != 1 { + t.Fatalf("%s should have exactly one binding", portspec) + } + + if bindings[0].HostIP != "" { + t.Fatalf("HostIP should not be set for %s", portspec) + } + + if bindings[0].HostPort != port { + t.Fatalf("HostPort should be %s for %s", port, portspec) + } + } + + portMap, bindingMap, err = ParsePortSpecs([]string{"0.0.0.0:1234-1236:1234-1236/tcp", "0.0.0.0:2345-2347:2345-2347/udp"}) + + if err != nil { + t.Fatalf("Error while processing ParsePortSpecs: %s", err) + } + + if _, ok := portMap[Port("1235/tcp")]; !ok { + t.Fatal("1234/tcp was not parsed properly") + } + + if _, ok := portMap[Port("2346/udp")]; !ok { + t.Fatal("2345/udp was not parsed properly") + } + + for portspec, bindings := range bindingMap { + _, port := SplitProtoPort(string(portspec)) + if len(bindings) != 1 || bindings[0].HostIP != "0.0.0.0" || bindings[0].HostPort != port { + t.Fatalf("Expect single binding to port %s but found %s", port, bindings) + } + } + + _, _, err = ParsePortSpecs([]string{"localhost:1234-1236:1234-1236/tcp"}) + + if err == nil { + t.Fatal("Received no error while trying to parse a hostname instead of ip") + } +} + +func TestParseNetworkOptsPrivateOnly(t *testing.T) { + ports, bindings, err := ParsePortSpecs([]string{"192.168.1.100::80"}) + if err != nil { + t.Fatal(err) + } + if len(ports) != 1 { + t.Logf("Expected 1 got %d", len(ports)) + t.FailNow() + } + if len(bindings) != 1 { + t.Logf("Expected 1 got %d", len(bindings)) + t.FailNow() + } + for k := range ports { + if k.Proto() != "tcp" { + t.Logf("Expected tcp got %s", k.Proto()) + t.Fail() + } + if k.Port() != "80" { + t.Logf("Expected 80 got %s", k.Port()) + t.Fail() + } + b, exists := bindings[k] + if !exists { + t.Log("Binding does not exist") + t.FailNow() + } + if len(b) != 1 { + t.Logf("Expected 1 got %d", len(b)) + t.FailNow() + } + s := b[0] + if s.HostPort != "" { + t.Logf("Expected \"\" got %s", s.HostPort) + t.Fail() + } + if s.HostIP != "192.168.1.100" { + t.Fail() + } + } +} + +func TestParseNetworkOptsPublic(t *testing.T) { + ports, bindings, err := ParsePortSpecs([]string{"192.168.1.100:8080:80"}) + if err != nil { + t.Fatal(err) + } + if len(ports) != 1 { + t.Logf("Expected 1 got %d", len(ports)) + t.FailNow() + } + if len(bindings) != 1 { + t.Logf("Expected 1 got %d", len(bindings)) + t.FailNow() + } + for k := range ports { + if k.Proto() != "tcp" { + t.Logf("Expected tcp got %s", k.Proto()) + t.Fail() + } + if k.Port() != "80" { + t.Logf("Expected 80 got %s", k.Port()) + t.Fail() + } + b, exists := bindings[k] + if !exists { + t.Log("Binding does not exist") + t.FailNow() + } + if len(b) != 1 { + t.Logf("Expected 1 got %d", len(b)) + t.FailNow() + } + s := b[0] + if s.HostPort != "8080" { + t.Logf("Expected 8080 got %s", s.HostPort) + t.Fail() + } + if s.HostIP != "192.168.1.100" { + t.Fail() + } + } +} + +func TestParseNetworkOptsPublicNoPort(t *testing.T) { + ports, bindings, err := ParsePortSpecs([]string{"192.168.1.100"}) + + if err == nil { + t.Logf("Expected error Invalid containerPort") + t.Fail() + } + if ports != nil { + t.Logf("Expected nil got %s", ports) + t.Fail() + } + if bindings != nil { + t.Logf("Expected nil got %s", bindings) + t.Fail() + } +} + +func TestParseNetworkOptsNegativePorts(t *testing.T) { + ports, bindings, err := ParsePortSpecs([]string{"192.168.1.100:-1:-1"}) + + if err == nil { + t.Fail() + } + if len(ports) != 0 { + t.Logf("Expected nil got %d", len(ports)) + t.Fail() + } + if len(bindings) != 0 { + t.Logf("Expected 0 got %d", len(bindings)) + t.Fail() + } +} + +func TestParseNetworkOptsUdp(t *testing.T) { + ports, bindings, err := ParsePortSpecs([]string{"192.168.1.100::6000/udp"}) + if err != nil { + t.Fatal(err) + } + if len(ports) != 1 { + t.Logf("Expected 1 got %d", len(ports)) + t.FailNow() + } + if len(bindings) != 1 { + t.Logf("Expected 1 got %d", len(bindings)) + t.FailNow() + } + for k := range ports { + if k.Proto() != "udp" { + t.Logf("Expected udp got %s", k.Proto()) + t.Fail() + } + if k.Port() != "6000" { + t.Logf("Expected 6000 got %s", k.Port()) + t.Fail() + } + b, exists := bindings[k] + if !exists { + t.Log("Binding does not exist") + t.FailNow() + } + if len(b) != 1 { + t.Logf("Expected 1 got %d", len(b)) + t.FailNow() + } + s := b[0] + if s.HostPort != "" { + t.Logf("Expected \"\" got %s", s.HostPort) + t.Fail() + } + if s.HostIP != "192.168.1.100" { + t.Fail() + } + } +} diff --git a/pkg/nat/sort.go b/pkg/nat/sort.go new file mode 100644 index 0000000000..1eb0fedda5 --- /dev/null +++ b/pkg/nat/sort.go @@ -0,0 +1,98 @@ +package nat + +import ( + "sort" + "strings" + + "github.com/docker/docker/pkg/parsers" +) + +type portSorter struct { + ports []Port + by func(i, j Port) bool +} + +func (s *portSorter) Len() int { + return len(s.ports) +} + +func (s *portSorter) Swap(i, j int) { + s.ports[i], s.ports[j] = s.ports[j], s.ports[i] +} + +func (s *portSorter) Less(i, j int) bool { + ip := s.ports[i] + jp := s.ports[j] + + return s.by(ip, jp) +} + +// Sort sorts a list of ports using the provided predicate +// This function should compare `i` and `j`, returning true if `i` is +// considered to be less than `j` +func Sort(ports []Port, predicate func(i, j Port) bool) { + s := &portSorter{ports, predicate} + sort.Sort(s) +} + +type portMapEntry struct { + port Port + binding PortBinding +} + +type portMapSorter []portMapEntry + +func (s portMapSorter) Len() int { return len(s) } +func (s portMapSorter) Swap(i, j int) { s[i], s[j] = s[j], s[i] } + +// sort the port so that the order is: +// 1. port with larger specified bindings +// 2. larger port +// 3. port with tcp protocol +func (s portMapSorter) Less(i, j int) bool { + pi, pj := s[i].port, s[j].port + hpi, hpj := toInt(s[i].binding.HostPort), toInt(s[j].binding.HostPort) + return hpi > hpj || pi.Int() > pj.Int() || (pi.Int() == pj.Int() && strings.ToLower(pi.Proto()) == "tcp") +} + +// SortPortMap sorts the list of ports and their respected mapping. The ports +// will explicit HostPort will be placed first. +func SortPortMap(ports []Port, bindings PortMap) { + s := portMapSorter{} + for _, p := range ports { + if binding, ok := bindings[p]; ok { + for _, b := range binding { + s = append(s, portMapEntry{port: p, binding: b}) + } + bindings[p] = []PortBinding{} + } else { + s = append(s, portMapEntry{port: p}) + } + } + + sort.Sort(s) + var ( + i int + pm = make(map[Port]struct{}) + ) + // reorder ports + for _, entry := range s { + if _, ok := pm[entry.port]; !ok { + ports[i] = entry.port + pm[entry.port] = struct{}{} + i++ + } + // reorder bindings for this port + if _, ok := bindings[entry.port]; ok { + bindings[entry.port] = append(bindings[entry.port], entry.binding) + } + } +} + +func toInt(s string) uint64 { + i, _, err := parsers.ParsePortRange(s) + if err != nil { + i = 0 + } + return i +} diff --git a/pkg/nat/sort_test.go b/pkg/nat/sort_test.go new file mode 100644 index 0000000000..88ed911156 --- /dev/null +++ b/pkg/nat/sort_test.go @@ -0,0 +1,85 @@ +package nat + +import ( + "fmt" + "reflect" + "testing" +) + +func TestSortUniquePorts(t *testing.T) { + ports := []Port{ + Port("6379/tcp"), + Port("22/tcp"), + } + + Sort(ports, func(ip, jp Port) bool { + return ip.Int() < jp.Int() || (ip.Int() == jp.Int() && ip.Proto() == "tcp") + }) + + first := ports[0] + if fmt.Sprint(first) != "22/tcp" { + t.Log(fmt.Sprint(first)) + t.Fail() + } +} + +func TestSortSamePortWithDifferentProto(t *testing.T) { + ports := []Port{ + Port("8888/tcp"), + Port("8888/udp"), + Port("6379/tcp"), + Port("6379/udp"), + } + + Sort(ports, func(ip, jp Port) bool { + return ip.Int() < jp.Int() || (ip.Int() == jp.Int() && ip.Proto() == "tcp") + }) + + first := ports[0] + if fmt.Sprint(first) != "6379/tcp" { + t.Fail() + } +} + +func TestSortPortMap(t *testing.T) { + ports := []Port{ + Port("22/tcp"), + Port("22/udp"), + Port("8000/tcp"), + Port("6379/tcp"), + Port("9999/tcp"), + } + + portMap := PortMap{ + Port("22/tcp"): []PortBinding{ + {}, + }, + Port("8000/tcp"): []PortBinding{ + {}, + }, + Port("6379/tcp"): []PortBinding{ + {}, + {HostIP: "0.0.0.0", HostPort: "32749"}, + }, + Port("9999/tcp"): []PortBinding{ + {HostIP: "0.0.0.0", HostPort: "40000"}, + }, + } + + SortPortMap(ports, portMap) + if !reflect.DeepEqual(ports, []Port{ + Port("9999/tcp"), + Port("6379/tcp"), + Port("8000/tcp"), + Port("22/tcp"), + Port("22/udp"), + }) { + t.Errorf("failed to prioritize port with explicit mappings, got %v", ports) + } + if pm := portMap[Port("6379/tcp")]; !reflect.DeepEqual(pm, []PortBinding{ + {HostIP: "0.0.0.0", HostPort: "32749"}, + {}, + }) { + t.Errorf("failed to prioritize bindings with explicit mappings, got %v", pm) + } +} diff --git a/pkg/parsers/filters/parse.go b/pkg/parsers/filters/parse.go new file mode 100644 index 0000000000..6c394f1607 --- /dev/null +++ b/pkg/parsers/filters/parse.go @@ -0,0 +1,134 @@ +// Package filters provides helper function to parse and handle command line +// filter, used for example in docker ps or docker images commands. +package filters + +import ( + "encoding/json" + "errors" + "regexp" + "strings" +) + +// Args stores filter arguments as map key:{array of values}. +// It contains a aggregation of the list of arguments (which are in the form +// of -f 'key=value') based on the key, and store values for the same key +// in an slice. +// e.g given -f 'label=label1=1' -f 'label=label2=2' -f 'image.name=ubuntu' +// the args will be {'label': {'label1=1','label2=2'}, 'image.name', {'ubuntu'}} +type Args map[string][]string + +// ParseFlag parses the argument to the filter flag. Like +// +// `docker ps -f 'created=today' -f 'image.name=ubuntu*'` +// +// If prev map is provided, then it is appended to, and returned. By default a new +// map is created. +func ParseFlag(arg string, prev Args) (Args, error) { + filters := prev + if prev == nil { + filters = Args{} + } + if len(arg) == 0 { + return filters, nil + } + + if !strings.Contains(arg, "=") { + return filters, ErrBadFormat + } + + f := strings.SplitN(arg, "=", 2) + name := strings.ToLower(strings.TrimSpace(f[0])) + value := strings.TrimSpace(f[1]) + filters[name] = append(filters[name], value) + + return filters, nil +} + +// ErrBadFormat is an error returned in case of bad format for a filter. +var ErrBadFormat = errors.New("bad format of filter (expected name=value)") + +// ToParam packs the Args into an string for easy transport from client to server. +func ToParam(a Args) (string, error) { + // this way we don't URL encode {}, just empty space + if len(a) == 0 { + return "", nil + } + + buf, err := json.Marshal(a) + if err != nil { + return "", err + } + return string(buf), nil +} + +// FromParam unpacks the filter Args. +func FromParam(p string) (Args, error) { + args := Args{} + if len(p) == 0 { + return args, nil + } + if err := json.NewDecoder(strings.NewReader(p)).Decode(&args); err != nil { + return nil, err + } + return args, nil +} + +// MatchKVList returns true if the values for the specified field maches the ones +// from the sources. +// e.g. given Args are {'label': {'label1=1','label2=1'}, 'image.name', {'ubuntu'}}, +// field is 'label' and sources are {'label':{'label1=1','label2=2','label3=3'}} +// it returns true. +func (filters Args) MatchKVList(field string, sources map[string]string) bool { + fieldValues := filters[field] + + //do not filter if there is no filter set or cannot determine filter + if len(fieldValues) == 0 { + return true + } + + if sources == nil || len(sources) == 0 { + return false + } + +outer: + for _, name2match := range fieldValues { + testKV := strings.SplitN(name2match, "=", 2) + + for k, v := range sources { + if len(testKV) == 1 { + if k == testKV[0] { + continue outer + } + } else if k == testKV[0] && v == testKV[1] { + continue outer + } + } + + return false + } + + return true +} + +// Match returns true if the values for the specified field matches the source string +// e.g. given Args are {'label': {'label1=1','label2=1'}, 'image.name', {'ubuntu'}}, +// field is 'image.name' and source is 'ubuntu' +// it returns true. +func (filters Args) Match(field, source string) bool { + fieldValues := filters[field] + + //do not filter if there is no filter set or cannot determine filter + if len(fieldValues) == 0 { + return true + } + for _, name2match := range fieldValues { + match, err := regexp.MatchString(name2match, source) + if err != nil { + continue + } + if match { + return true + } + } + return false +} diff --git a/pkg/parsers/filters/parse_test.go b/pkg/parsers/filters/parse_test.go new file mode 100644 index 0000000000..eb9fcef90f --- /dev/null +++ b/pkg/parsers/filters/parse_test.go @@ -0,0 +1,218 @@ +package filters + +import ( + "sort" + "testing" +) + +func TestParseArgs(t *testing.T) { + // equivalent of `docker ps -f 'created=today' -f 'image.name=ubuntu*' -f 'image.name=*untu'` + flagArgs := []string{ + "created=today", + "image.name=ubuntu*", + "image.name=*untu", + } + var ( + args = Args{} + err error + ) + for i := range flagArgs { + args, err = ParseFlag(flagArgs[i], args) + if err != nil { + t.Errorf("failed to parse %s: %s", flagArgs[i], err) + } + } + if len(args["created"]) != 1 { + t.Errorf("failed to set this arg") + } + if len(args["image.name"]) != 2 { + t.Errorf("the args should have collapsed") + } +} + +func TestParseArgsEdgeCase(t *testing.T) { + var filters Args + args, err := ParseFlag("", filters) + if err != nil { + t.Fatal(err) + } + if args == nil || len(args) != 0 { + t.Fatalf("Expected an empty Args (map), got %v", args) + } + if args, err = ParseFlag("anything", args); err == nil || err != ErrBadFormat { + t.Fatalf("Expected ErrBadFormat, got %v", err) + } +} + +func TestToParam(t *testing.T) { + a := Args{ + "created": []string{"today"}, + "image.name": []string{"ubuntu*", "*untu"}, + } + + _, err := ToParam(a) + if err != nil { + t.Errorf("failed to marshal the filters: %s", err) + } +} + +func TestFromParam(t *testing.T) { + invalids := []string{ + "anything", + "['a','list']", + "{'key': 'value'}", + `{"key": "value"}`, + } + valids := map[string]Args{ + `{"key": ["value"]}`: { + "key": {"value"}, + }, + `{"key": ["value1", "value2"]}`: { + "key": {"value1", "value2"}, + }, + `{"key1": ["value1"], "key2": ["value2"]}`: { + "key1": {"value1"}, + "key2": {"value2"}, + }, + } + for _, invalid := range invalids { + if _, err := FromParam(invalid); err == nil { + t.Fatalf("Expected an error with %v, got nothing", invalid) + } + } + for json, expectedArgs := range valids { + args, err := FromParam(json) + if err != nil { + t.Fatal(err) + } + if len(args) != len(expectedArgs) { + t.Fatalf("Expected %v, go %v", expectedArgs, args) + } + for key, expectedValues := range expectedArgs { + values := args[key] + sort.Strings(values) + sort.Strings(expectedValues) + if len(values) != len(expectedValues) { + t.Fatalf("Expected %v, go %v", expectedArgs, args) + } + for index, expectedValue := range expectedValues { + if values[index] != expectedValue { + t.Fatalf("Expected %v, go %v", expectedArgs, args) + } + } + } + } +} + +func TestEmpty(t *testing.T) { + a := Args{} + v, err := ToParam(a) + if err != nil { + t.Errorf("failed to marshal the filters: %s", err) + } + v1, err := FromParam(v) + if err != nil { + t.Errorf("%s", err) + } + if len(a) != len(v1) { + t.Errorf("these should both be empty sets") + } +} + +func TestArgsMatchKVList(t *testing.T) { + // empty sources + args := Args{ + "created": []string{"today"}, + } + if args.MatchKVList("created", map[string]string{}) { + t.Fatalf("Expected false for (%v,created), got true", args) + } + // Not empty sources + sources := map[string]string{ + "key1": "value1", + "key2": "value2", + "key3": "value3", + } + matches := map[*Args]string{ + &Args{}: "field", + &Args{ + "created": []string{"today"}, + "labels": []string{"key1"}, + }: "labels", + &Args{ + "created": []string{"today"}, + "labels": []string{"key1=value1"}, + }: "labels", + } + differs := map[*Args]string{ + &Args{ + "created": []string{"today"}, + }: "created", + &Args{ + "created": []string{"today"}, + "labels": []string{"key4"}, + }: "labels", + &Args{ + "created": []string{"today"}, + "labels": []string{"key1=value3"}, + }: "labels", + } + for args, field := range matches { + if args.MatchKVList(field, sources) != true { + t.Fatalf("Expected true for %v on %v, got false", sources, args) + } + } + for args, field := range differs { + if args.MatchKVList(field, sources) != false { + t.Fatalf("Expected false for %v on %v, got true", sources, args) + } + } +} + +func TestArgsMatch(t *testing.T) { + source := "today" + matches := map[*Args]string{ + &Args{}: "field", + &Args{ + "created": []string{"today"}, + "labels": []string{"key1"}, + }: "today", + &Args{ + "created": []string{"to*"}, + }: "created", + &Args{ + "created": []string{"to(.*)"}, + }: "created", + &Args{ + "created": []string{"tod"}, + }: "created", + &Args{ + "created": []string{"anything", "to*"}, + }: "created", + } + differs := map[*Args]string{ + &Args{ + "created": []string{"tomorrow"}, + }: "created", + &Args{ + "created": []string{"to(day"}, + }: "created", + &Args{ + "created": []string{"tom(.*)"}, + }: "created", + &Args{ + "created": []string{"today1"}, + "labels": []string{"today"}, + }: "created", + } + for args, field := range matches { + if args.Match(field, source) != true { + t.Fatalf("Expected true for %v on %v, got false", source, args) + } + } + for args, field := range differs { + if args.Match(field, source) != false { + t.Fatalf("Expected false for %v on %v, got true", source, args) + } + } +} diff --git a/pkg/parsers/kernel/kernel.go b/pkg/parsers/kernel/kernel.go new file mode 100644 index 0000000000..a21ba137e3 --- /dev/null +++ b/pkg/parsers/kernel/kernel.go @@ -0,0 +1,100 @@ +// +build !windows + +// Package kernel provides helper function to get, parse and compare kernel +// versions for different platforms. +package kernel + +import ( + "bytes" + "errors" + "fmt" +) + +// VersionInfo holds information about the kernel. +type VersionInfo struct { + Kernel int // Version of the kernel (e.g. 4.1.2-generic -> 4) + Major int // Major part of the kernel version (e.g. 4.1.2-generic -> 1) + Minor int // Minor part of the kernel version (e.g. 4.1.2-generic -> 2) + Flavor string // Flavor of the kernel version (e.g. 4.1.2-generic -> generic) +} + +func (k *VersionInfo) String() string { + return fmt.Sprintf("%d.%d.%d%s", k.Kernel, k.Major, k.Minor, k.Flavor) +} + +// CompareKernelVersion compares two kernel.VersionInfo structs. +// Returns -1 if a < b, 0 if a == b, 1 it a > b +func CompareKernelVersion(a, b VersionInfo) int { + if a.Kernel < b.Kernel { + return -1 + } else if a.Kernel > b.Kernel { + return 1 + } + + if a.Major < b.Major { + return -1 + } else if a.Major > b.Major { + return 1 + } + + if a.Minor < b.Minor { + return -1 + } else if a.Minor > b.Minor { + return 1 + } + + return 0 +} + +// GetKernelVersion gets the current kernel version. +func GetKernelVersion() (*VersionInfo, error) { + var ( + err error + ) + + uts, err := uname() + if err != nil { + return nil, err + } + + release := make([]byte, len(uts.Release)) + + i := 0 + for _, c := range uts.Release { + release[i] = byte(c) + i++ + } + + // Remove the \x00 from the release for Atoi to parse correctly + release = release[:bytes.IndexByte(release, 0)] + + return ParseRelease(string(release)) +} + +// ParseRelease parses a string and creates a VersionInfo based on it. +func ParseRelease(release string) (*VersionInfo, error) { + var ( + kernel, major, minor, parsed int + flavor, partial string + ) + + // Ignore error from Sscanf to allow an empty flavor. Instead, just + // make sure we got all the version numbers. + parsed, _ = fmt.Sscanf(release, "%d.%d%s", &kernel, &major, &partial) + if parsed < 2 { + return nil, errors.New("Can't parse kernel version " + release) + } + + // sometimes we have 3.12.25-gentoo, but sometimes we just have 3.12-1-amd64 + parsed, _ = fmt.Sscanf(partial, ".%d%s", &minor, &flavor) + if parsed < 1 { + flavor = partial + } + + return &VersionInfo{ + Kernel: kernel, + Major: major, + Minor: minor, + Flavor: flavor, + }, nil +} diff --git a/pkg/parsers/kernel/kernel_test.go b/pkg/parsers/kernel/kernel_test.go new file mode 100644 index 0000000000..6a2c246802 --- /dev/null +++ b/pkg/parsers/kernel/kernel_test.go @@ -0,0 +1,92 @@ +package kernel + +import ( + "fmt" + "testing" +) + +func assertParseRelease(t *testing.T, release string, b *VersionInfo, result int) { + var ( + a *VersionInfo + ) + a, _ = ParseRelease(release) + + if r := CompareKernelVersion(*a, *b); r != result { + t.Fatalf("Unexpected kernel version comparison result for (%v,%v). Found %d, expected %d", release, b, r, result) + } + if a.Flavor != b.Flavor { + t.Fatalf("Unexpected parsed kernel flavor. Found %s, expected %s", a.Flavor, b.Flavor) + } +} + +func TestParseRelease(t *testing.T) { + assertParseRelease(t, "3.8.0", &VersionInfo{Kernel: 3, Major: 8, Minor: 0}, 0) + assertParseRelease(t, "3.4.54.longterm-1", &VersionInfo{Kernel: 3, Major: 4, Minor: 54, Flavor: ".longterm-1"}, 0) + assertParseRelease(t, "3.4.54.longterm-1", &VersionInfo{Kernel: 3, Major: 4, Minor: 54, Flavor: ".longterm-1"}, 0) + assertParseRelease(t, "3.8.0-19-generic", &VersionInfo{Kernel: 3, Major: 8, Minor: 0, Flavor: "-19-generic"}, 0) + assertParseRelease(t, "3.12.8tag", &VersionInfo{Kernel: 3, Major: 12, Minor: 8, Flavor: "tag"}, 0) + assertParseRelease(t, "3.12-1-amd64", &VersionInfo{Kernel: 3, Major: 12, Minor: 0, Flavor: "-1-amd64"}, 0) + assertParseRelease(t, "3.8.0", &VersionInfo{Kernel: 4, Major: 8, Minor: 0}, -1) + // Errors + invalids := []string{ + "3", + "a", + "a.a", + "a.a.a-a", + } + for _, invalid := range invalids { + expectedMessage := fmt.Sprintf("Can't parse kernel version %v", invalid) + if _, err := ParseRelease(invalid); err == nil || err.Error() != expectedMessage { + + } + } +} + +func assertKernelVersion(t *testing.T, a, b VersionInfo, result int) { + if r := CompareKernelVersion(a, b); r != result { + t.Fatalf("Unexpected kernel version comparison result. Found %d, expected %d", r, result) + } +} + +func TestCompareKernelVersion(t *testing.T) { + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + 0) + assertKernelVersion(t, + VersionInfo{Kernel: 2, Major: 6, Minor: 0}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + -1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + VersionInfo{Kernel: 2, Major: 6, Minor: 0}, + 1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + 0) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 5}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + 1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 0, Minor: 20}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + -1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 7, Minor: 20}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + -1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 20}, + VersionInfo{Kernel: 3, Major: 7, Minor: 0}, + 1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 20}, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + 1) + assertKernelVersion(t, + VersionInfo{Kernel: 3, Major: 8, Minor: 0}, + VersionInfo{Kernel: 3, Major: 8, Minor: 20}, + -1) +} diff --git a/pkg/parsers/kernel/kernel_windows.go b/pkg/parsers/kernel/kernel_windows.go new file mode 100644 index 0000000000..85ca250c9f --- /dev/null +++ b/pkg/parsers/kernel/kernel_windows.go @@ -0,0 +1,67 @@ +package kernel + +import ( + "fmt" + "syscall" + "unsafe" +) + +// VersionInfo holds information about the kernel. +type VersionInfo struct { + kvi string // Version of the kernel (e.g. 6.1.7601.17592 -> 6) + major int // Major part of the kernel version (e.g. 6.1.7601.17592 -> 1) + minor int // Minor part of the kernel version (e.g. 6.1.7601.17592 -> 7601) + build int // Build number of the kernel version (e.g. 6.1.7601.17592 -> 17592) +} + +func (k *VersionInfo) String() string { + return fmt.Sprintf("%d.%d %d (%s)", k.major, k.minor, k.build, k.kvi) +} + +// GetKernelVersion gets the current kernel version. +func GetKernelVersion() (*VersionInfo, error) { + + var ( + h syscall.Handle + dwVersion uint32 + err error + ) + + KVI := &VersionInfo{"Unknown", 0, 0, 0} + + if err = syscall.RegOpenKeyEx(syscall.HKEY_LOCAL_MACHINE, + syscall.StringToUTF16Ptr(`SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\`), + 0, + syscall.KEY_READ, + &h); err != nil { + return KVI, err + } + defer syscall.RegCloseKey(h) + + var buf [1 << 10]uint16 + var typ uint32 + n := uint32(len(buf) * 2) // api expects array of bytes, not uint16 + + if err = syscall.RegQueryValueEx(h, + syscall.StringToUTF16Ptr("BuildLabEx"), + nil, + &typ, + (*byte)(unsafe.Pointer(&buf[0])), + &n); err != nil { + return KVI, err + } + + KVI.kvi = syscall.UTF16ToString(buf[:]) + + // Important - docker.exe MUST be manifested for this API to return + // the correct information. + if dwVersion, err = syscall.GetVersion(); err != nil { + return KVI, err + } + + KVI.major = int(dwVersion & 0xFF) + KVI.minor = int((dwVersion & 0XFF00) >> 8) + KVI.build = int((dwVersion & 0xFFFF0000) >> 16) + + return KVI, nil +} diff --git a/pkg/parsers/kernel/uname_linux.go b/pkg/parsers/kernel/uname_linux.go new file mode 100644 index 0000000000..7d12fcbd9d --- /dev/null +++ b/pkg/parsers/kernel/uname_linux.go @@ -0,0 +1,19 @@ +package kernel + +import ( + "syscall" +) + +// Utsname represents the system name structure. +// It is passthgrouh for syscall.Utsname in order to make it portable with +// other platforms where it is not available. +type Utsname syscall.Utsname + +func uname() (*syscall.Utsname, error) { + uts := &syscall.Utsname{} + + if err := syscall.Uname(uts); err != nil { + return nil, err + } + return uts, nil +} diff --git a/pkg/parsers/kernel/uname_unsupported.go b/pkg/parsers/kernel/uname_unsupported.go new file mode 100644 index 0000000000..79c66b3228 --- /dev/null +++ b/pkg/parsers/kernel/uname_unsupported.go @@ -0,0 +1,18 @@ +// +build !linux + +package kernel + +import ( + "errors" +) + +// Utsname represents the system name structure. +// It is defined here to make it portable as it is available on linux but not +// on windows. +type Utsname struct { + Release [65]byte +} + +func uname() (*Utsname, error) { + return nil, errors.New("Kernel version detection is available only on linux") +} diff --git a/pkg/parsers/operatingsystem/operatingsystem_freebsd.go b/pkg/parsers/operatingsystem/operatingsystem_freebsd.go new file mode 100644 index 0000000000..0589cf2ae3 --- /dev/null +++ b/pkg/parsers/operatingsystem/operatingsystem_freebsd.go @@ -0,0 +1,18 @@ +package operatingsystem + +import ( + "errors" +) + +// GetOperatingSystem gets the name of the current operating system. +func GetOperatingSystem() (string, error) { + // TODO: Implement OS detection + return "", errors.New("Cannot detect OS version") +} + +// IsContainerized returns true if we are running inside a container. +// No-op on FreeBSD, always returns false. +func IsContainerized() (bool, error) { + // TODO: Implement jail detection + return false, errors.New("Cannot detect if we are in container") +} diff --git a/pkg/parsers/operatingsystem/operatingsystem_linux.go b/pkg/parsers/operatingsystem/operatingsystem_linux.go new file mode 100644 index 0000000000..ca8ea8f052 --- /dev/null +++ b/pkg/parsers/operatingsystem/operatingsystem_linux.go @@ -0,0 +1,44 @@ +// Package operatingsystem provides helper function to get the operating system +// name for different platforms. +package operatingsystem + +import ( + "bytes" + "errors" + "io/ioutil" +) + +var ( + // file to use to detect if the daemon is running in a container + proc1Cgroup = "/proc/1/cgroup" + + // file to check to determine Operating System + etcOsRelease = "/etc/os-release" +) + +// GetOperatingSystem gets the name of the current operating system. +func GetOperatingSystem() (string, error) { + b, err := ioutil.ReadFile(etcOsRelease) + if err != nil { + return "", err + } + if i := bytes.Index(b, []byte("PRETTY_NAME")); i >= 0 { + b = b[i+13:] + return string(b[:bytes.IndexByte(b, '"')]), nil + } + return "", errors.New("PRETTY_NAME not found") +} + +// IsContainerized returns true if we are running inside a container. +func IsContainerized() (bool, error) { + b, err := ioutil.ReadFile(proc1Cgroup) + if err != nil { + return false, err + } + for _, line := range bytes.Split(b, []byte{'\n'}) { + if len(line) > 0 && !bytes.HasSuffix(line, []byte{'/'}) { + return true, nil + } + } + return false, nil +} diff --git a/pkg/parsers/operatingsystem/operatingsystem_test.go b/pkg/parsers/operatingsystem/operatingsystem_test.go new file mode 100644 index 0000000000..b7d54cbb1c --- /dev/null +++ b/pkg/parsers/operatingsystem/operatingsystem_test.go @@ -0,0 +1,124 @@ +package operatingsystem + +import ( + "io/ioutil" + "os" + "path/filepath" + "testing" +) + +func TestGetOperatingSystem(t *testing.T) { + var ( + backup = etcOsRelease + ubuntuTrusty = []byte(`NAME="Ubuntu" +VERSION="14.04, Trusty Tahr" +ID=ubuntu +ID_LIKE=debian +PRETTY_NAME="Ubuntu 14.04 LTS" +VERSION_ID="14.04" +HOME_URL="http://www.ubuntu.com/" +SUPPORT_URL="http://help.ubuntu.com/" +BUG_REPORT_URL="http://bugs.launchpad.net/ubuntu/"`) + gentoo = []byte(`NAME=Gentoo +ID=gentoo +PRETTY_NAME="Gentoo/Linux" +ANSI_COLOR="1;32" +HOME_URL="http://www.gentoo.org/" +SUPPORT_URL="http://www.gentoo.org/main/en/support.xml" +BUG_REPORT_URL="https://bugs.gentoo.org/" +`) + noPrettyName = []byte(`NAME="Ubuntu" +VERSION="14.04, Trusty Tahr" +ID=ubuntu +ID_LIKE=debian +VERSION_ID="14.04" +HOME_URL="http://www.ubuntu.com/" +SUPPORT_URL="http://help.ubuntu.com/" +BUG_REPORT_URL="http://bugs.launchpad.net/ubuntu/"`) + ) + + dir := os.TempDir() + etcOsRelease = filepath.Join(dir, "etcOsRelease") + + defer func() { + os.Remove(etcOsRelease) + etcOsRelease = backup + }() + + for expect, osRelease := range map[string][]byte{ + "Ubuntu 14.04 LTS": ubuntuTrusty, + "Gentoo/Linux": gentoo, + "": noPrettyName, + } { + if err := ioutil.WriteFile(etcOsRelease, osRelease, 0600); err != nil { + t.Fatalf("failed to write to %s: %v", etcOsRelease, err) + } + s, err := GetOperatingSystem() + if s != expect { + if expect == "" { + t.Fatalf("Expected error 'PRETTY_NAME not found', but got %v", err) + } else { + t.Fatalf("Expected '%s', but got '%s'. Err=%v", expect, s, err) + } + } + } +} + +func TestIsContainerized(t *testing.T) { + var ( + backup = proc1Cgroup + nonContainerizedProc1Cgroup = []byte(`14:name=systemd:/ +13:hugetlb:/ +12:net_prio:/ +11:perf_event:/ +10:bfqio:/ +9:blkio:/ +8:net_cls:/ +7:freezer:/ +6:devices:/ +5:memory:/ +4:cpuacct:/ +3:cpu:/ +2:cpuset:/ +`) + containerizedProc1Cgroup = []byte(`9:perf_event:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +8:blkio:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +7:net_cls:/ +6:freezer:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +5:devices:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +4:memory:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +3:cpuacct:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +2:cpu:/docker/3cef1b53c50b0fa357d994f8a1a8cd783c76bbf4f5dd08b226e38a8bd331338d +1:cpuset:/`) + ) + + dir := os.TempDir() + proc1Cgroup = filepath.Join(dir, "proc1Cgroup") + + defer func() { + os.Remove(proc1Cgroup) + proc1Cgroup = backup + }() + + if err := ioutil.WriteFile(proc1Cgroup, nonContainerizedProc1Cgroup, 0600); err != nil { + t.Fatalf("failed to write to %s: %v", proc1Cgroup, err) + } + inContainer, err := IsContainerized() + if err != nil { + t.Fatal(err) + } + if inContainer { + t.Fatal("Wrongly assuming containerized") + } + + if err := ioutil.WriteFile(proc1Cgroup, containerizedProc1Cgroup, 0600); err != nil { + t.Fatalf("failed to write to %s: %v", proc1Cgroup, err) + } + inContainer, err = IsContainerized() + if err != nil { + t.Fatal(err) + } + if !inContainer { + t.Fatal("Wrongly assuming non-containerized") + } +} diff --git a/pkg/parsers/operatingsystem/operatingsystem_windows.go b/pkg/parsers/operatingsystem/operatingsystem_windows.go new file mode 100644 index 0000000000..3c86b6af9c --- /dev/null +++ b/pkg/parsers/operatingsystem/operatingsystem_windows.go @@ -0,0 +1,49 @@ +package operatingsystem + +import ( + "syscall" + "unsafe" +) + +// See https://code.google.com/p/go/source/browse/src/pkg/mime/type_windows.go?r=d14520ac25bf6940785aabb71f5be453a286f58c +// for a similar sample + +// GetOperatingSystem gets the name of the current operating system. +func GetOperatingSystem() (string, error) { + + var h syscall.Handle + + // Default return value + ret := "Unknown Operating System" + + if err := syscall.RegOpenKeyEx(syscall.HKEY_LOCAL_MACHINE, + syscall.StringToUTF16Ptr(`SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\`), + 0, + syscall.KEY_READ, + &h); err != nil { + return ret, err + } + defer syscall.RegCloseKey(h) + + var buf [1 << 10]uint16 + var typ uint32 + n := uint32(len(buf) * 2) // api expects array of bytes, not uint16 + + if err := syscall.RegQueryValueEx(h, + syscall.StringToUTF16Ptr("ProductName"), + nil, + &typ, + (*byte)(unsafe.Pointer(&buf[0])), + &n); err != nil { + return ret, err + } + ret = syscall.UTF16ToString(buf[:]) + + return ret, nil +} + +// IsContainerized returns true if we are running inside a container. +// No-op on Windows, always returns false. +func IsContainerized() (bool, error) { + return false, nil +} diff --git a/pkg/parsers/parsers.go b/pkg/parsers/parsers.go new file mode 100644 index 0000000000..37cc30e198 --- /dev/null +++ b/pkg/parsers/parsers.go @@ -0,0 +1,258 @@ +// Package parsers provides helper functions to parse and validate different type +// of string. It can be hosts, unix addresses, tcp addresses, filters, kernel +// operating system versions. +package parsers + +import ( + "fmt" + "net/url" + "path" + "runtime" + "strconv" + "strings" + + "github.com/docker/distribution/digest" +) + +// ParseDockerDaemonHost parses the specified address and returns an address that will be used as the host. +// Depending of the address specified, will use the defaultTCPAddr or defaultUnixAddr +// defaultUnixAddr must be a absolute file path (no `unix://` prefix) +// defaultTCPAddr must be the full `tcp://host:port` form +func ParseDockerDaemonHost(defaultTCPAddr, defaultTLSHost, defaultUnixAddr, defaultAddr, addr string) (string, error) { + addr = strings.TrimSpace(addr) + if addr == "" { + if defaultAddr == defaultTLSHost { + return defaultTLSHost, nil + } + if runtime.GOOS != "windows" { + return fmt.Sprintf("unix://%s", defaultUnixAddr), nil + } + return defaultTCPAddr, nil + } + addrParts := strings.Split(addr, "://") + if len(addrParts) == 1 { + addrParts = []string{"tcp", addrParts[0]} + } + + switch addrParts[0] { + case "tcp": + return ParseTCPAddr(addrParts[1], defaultTCPAddr) + case "unix": + return ParseUnixAddr(addrParts[1], defaultUnixAddr) + case "fd": + return addr, nil + default: + return "", fmt.Errorf("Invalid bind address format: %s", addr) + } +} + +// ParseUnixAddr parses and validates that the specified address is a valid UNIX +// socket address. It returns a formatted UNIX socket address, either using the +// address parsed from addr, or the contents of defaultAddr if addr is a blank +// string. +func ParseUnixAddr(addr string, defaultAddr string) (string, error) { + addr = strings.TrimPrefix(addr, "unix://") + if strings.Contains(addr, "://") { + return "", fmt.Errorf("Invalid proto, expected unix: %s", addr) + } + if addr == "" { + addr = defaultAddr + } + return fmt.Sprintf("unix://%s", addr), nil +} + +// ParseTCPAddr parses and validates that the specified address is a valid TCP +// address. It returns a formatted TCP address, either using the address parsed +// from tryAddr, or the contents of defaultAddr if tryAddr is a blank string. +// tryAddr is expected to have already been Trim()'d +// defaultAddr must be in the full `tcp://host:port` form +func ParseTCPAddr(tryAddr string, defaultAddr string) (string, error) { + if tryAddr == "" || tryAddr == "tcp://" { + return defaultAddr, nil + } + addr := strings.TrimPrefix(tryAddr, "tcp://") + if strings.Contains(addr, "://") || addr == "" { + return "", fmt.Errorf("Invalid proto, expected tcp: %s", tryAddr) + } + + u, err := url.Parse("tcp://" + addr) + if err != nil { + return "", err + } + hostParts := strings.Split(u.Host, ":") + if len(hostParts) != 2 { + return "", fmt.Errorf("Invalid bind address format: %s", tryAddr) + } + defaults := strings.Split(defaultAddr, ":") + if len(defaults) != 3 { + return "", fmt.Errorf("Invalid defaults address format: %s", defaultAddr) + } + + host := hostParts[0] + if host == "" { + host = strings.TrimPrefix(defaults[1], "//") + } + if hostParts[1] == "" { + hostParts[1] = defaults[2] + } + p, err := strconv.Atoi(hostParts[1]) + if err != nil && p == 0 { + return "", fmt.Errorf("Invalid bind address format: %s", tryAddr) + } + return fmt.Sprintf("tcp://%s:%d%s", host, p, u.Path), nil +} + +// ParseRepositoryTag gets a repos name and returns the right reposName + tag|digest +// The tag can be confusing because of a port in a repository name. +// Ex: localhost.localdomain:5000/samalba/hipache:latest +// Digest ex: localhost:5000/foo/bar@sha256:bc8813ea7b3603864987522f02a76101c17ad122e1c46d790efc0fca78ca7bfb +func ParseRepositoryTag(repos string) (string, string) { + n := strings.Index(repos, "@") + if n >= 0 { + parts := strings.Split(repos, "@") + return parts[0], parts[1] + } + // detect digests from tags + if _, err := digest.ParseDigest(repos); err == nil { + return repos, "" + } + + n = strings.LastIndex(repos, ":") + if n < 0 { + return repos, "" + } + if tag := repos[n+1:]; !strings.Contains(tag, "/") { + return repos[:n], tag + } + return repos, "" +} + +// PartParser parses and validates the specified string (data) using the specified template +// e.g. ip:public:private -> 192.168.0.1:80:8000 +func PartParser(template, data string) (map[string]string, error) { + // ip:public:private + var ( + templateParts = strings.Split(template, ":") + parts = strings.Split(data, ":") + out = make(map[string]string, len(templateParts)) + ) + if len(parts) != len(templateParts) { + return nil, fmt.Errorf("Invalid format to parse. %s should match template %s", data, template) + } + + for i, t := range templateParts { + value := "" + if len(parts) > i { + value = parts[i] + } + out[t] = value + } + return out, nil +} + +// ParseKeyValueOpt parses and validates the specified string as a key/value pair (key=value) +func ParseKeyValueOpt(opt string) (string, string, error) { + parts := strings.SplitN(opt, "=", 2) + if len(parts) != 2 { + return "", "", fmt.Errorf("Unable to parse key/value option: %s", opt) + } + return strings.TrimSpace(parts[0]), strings.TrimSpace(parts[1]), nil +} + +// ParsePortRange parses and validates the specified string as a port-range (8000-9000) +func ParsePortRange(ports string) (uint64, uint64, error) { + if ports == "" { + return 0, 0, fmt.Errorf("Empty string specified for ports.") + } + if !strings.Contains(ports, "-") { + start, err := strconv.ParseUint(ports, 10, 16) + end := start + return start, end, err + } + + parts := strings.Split(ports, "-") + start, err := strconv.ParseUint(parts[0], 10, 16) + if err != nil { + return 0, 0, err + } + end, err := strconv.ParseUint(parts[1], 10, 16) + if err != nil { + return 0, 0, err + } + if end < start { + return 0, 0, fmt.Errorf("Invalid range specified for the Port: %s", ports) + } + return start, end, nil +} + +// ParseLink parses and validates the specified string as a link format (name:alias) +func ParseLink(val string) (string, string, error) { + if val == "" { + return "", "", fmt.Errorf("empty string specified for links") + } + arr := strings.Split(val, ":") + if len(arr) > 2 { + return "", "", fmt.Errorf("bad format for links: %s", val) + } + if len(arr) == 1 { + return val, val, nil + } + // This is kept because we can actually get an HostConfig with links + // from an already created container and the format is not `foo:bar` + // but `/foo:/c1/bar` + if strings.HasPrefix(arr[0], "/") { + _, alias := path.Split(arr[1]) + return arr[0][1:], alias, nil + } + return arr[0], arr[1], nil +} + +// ParseUintList parses and validates the specified string as the value +// found in some cgroup file (e.g. `cpuset.cpus`, `cpuset.mems`), which could be +// one of the formats below. Note that duplicates are actually allowed in the +// input string. It returns a `map[int]bool` with available elements from `val` +// set to `true`. +// Supported formats: +// 7 +// 1-6 +// 0,3-4,7,8-10 +// 0-0,0,1-7 +// 03,1-3 <- this is gonna get parsed as [1,2,3] +// 3,2,1 +// 0-2,3,1 +func ParseUintList(val string) (map[int]bool, error) { + if val == "" { + return map[int]bool{}, nil + } + + availableInts := make(map[int]bool) + split := strings.Split(val, ",") + errInvalidFormat := fmt.Errorf("invalid format: %s", val) + + for _, r := range split { + if !strings.Contains(r, "-") { + v, err := strconv.Atoi(r) + if err != nil { + return nil, errInvalidFormat + } + availableInts[v] = true + } else { + split := strings.SplitN(r, "-", 2) + min, err := strconv.Atoi(split[0]) + if err != nil { + return nil, errInvalidFormat + } + max, err := strconv.Atoi(split[1]) + if err != nil { + return nil, errInvalidFormat + } + if max < min { + return nil, errInvalidFormat + } + for i := min; i <= max; i++ { + availableInts[i] = true + } + } + } + return availableInts, nil +} diff --git a/pkg/parsers/parsers_test.go b/pkg/parsers/parsers_test.go new file mode 100644 index 0000000000..f32569a0f3 --- /dev/null +++ b/pkg/parsers/parsers_test.go @@ -0,0 +1,282 @@ +package parsers + +import ( + "reflect" + "runtime" + "strings" + "testing" +) + +func TestParseDockerDaemonHost(t *testing.T) { + var ( + defaultHTTPHost = "tcp://localhost:2375" + defaultHTTPSHost = "tcp://localhost:2376" + defaultUnix = "/var/run/docker.sock" + defaultHOST = "unix:///var/run/docker.sock" + ) + if runtime.GOOS == "windows" { + defaultHOST = defaultHTTPHost + } + invalids := map[string]string{ + "0.0.0.0": "Invalid bind address format: 0.0.0.0", + "tcp:a.b.c.d": "Invalid bind address format: tcp:a.b.c.d", + "tcp:a.b.c.d/path": "Invalid bind address format: tcp:a.b.c.d/path", + "udp://127.0.0.1": "Invalid bind address format: udp://127.0.0.1", + "udp://127.0.0.1:2375": "Invalid bind address format: udp://127.0.0.1:2375", + "tcp://unix:///run/docker.sock": "Invalid bind address format: unix", + "tcp": "Invalid bind address format: tcp", + "unix": "Invalid bind address format: unix", + "fd": "Invalid bind address format: fd", + } + valids := map[string]string{ + "0.0.0.1:": "tcp://0.0.0.1:2375", + "0.0.0.1:5555": "tcp://0.0.0.1:5555", + "0.0.0.1:5555/path": "tcp://0.0.0.1:5555/path", + ":6666": "tcp://localhost:6666", + ":6666/path": "tcp://localhost:6666/path", + "": defaultHOST, + " ": defaultHOST, + " ": defaultHOST, + "tcp://": defaultHTTPHost, + "tcp://:7777": "tcp://localhost:7777", + "tcp://:7777/path": "tcp://localhost:7777/path", + " tcp://:7777/path ": "tcp://localhost:7777/path", + "unix:///run/docker.sock": "unix:///run/docker.sock", + "unix://": "unix:///var/run/docker.sock", + "fd://": "fd://", + "fd://something": "fd://something", + "localhost:": "tcp://localhost:2375", + "localhost:5555": "tcp://localhost:5555", + "localhost:5555/path": "tcp://localhost:5555/path", + } + for invalidAddr, expectedError := range invalids { + if addr, err := ParseDockerDaemonHost(defaultHTTPHost, defaultHTTPSHost, defaultUnix, "", invalidAddr); err == nil || err.Error() != expectedError { + t.Errorf("tcp %v address expected error %v return, got %s and addr %v", invalidAddr, expectedError, err, addr) + } + } + for validAddr, expectedAddr := range valids { + if addr, err := ParseDockerDaemonHost(defaultHTTPHost, defaultHTTPSHost, defaultUnix, "", validAddr); err != nil || addr != expectedAddr { + t.Errorf("%v -> expected %v, got (%v) addr (%v)", validAddr, expectedAddr, err, addr) + } + } +} + +func TestParseTCP(t *testing.T) { + var ( + defaultHTTPHost = "tcp://127.0.0.1:2376" + ) + invalids := map[string]string{ + "0.0.0.0": "Invalid bind address format: 0.0.0.0", + "tcp:a.b.c.d": "Invalid bind address format: tcp:a.b.c.d", + "tcp:a.b.c.d/path": "Invalid bind address format: tcp:a.b.c.d/path", + "udp://127.0.0.1": "Invalid proto, expected tcp: udp://127.0.0.1", + "udp://127.0.0.1:2375": "Invalid proto, expected tcp: udp://127.0.0.1:2375", + } + valids := map[string]string{ + "": defaultHTTPHost, + "tcp://": defaultHTTPHost, + "0.0.0.1:": "tcp://0.0.0.1:2376", + "0.0.0.1:5555": "tcp://0.0.0.1:5555", + "0.0.0.1:5555/path": "tcp://0.0.0.1:5555/path", + ":6666": "tcp://127.0.0.1:6666", + ":6666/path": "tcp://127.0.0.1:6666/path", + "tcp://:7777": "tcp://127.0.0.1:7777", + "tcp://:7777/path": "tcp://127.0.0.1:7777/path", + } + for invalidAddr, expectedError := range invalids { + if addr, err := ParseTCPAddr(invalidAddr, defaultHTTPHost); err == nil || err.Error() != expectedError { + t.Errorf("tcp %v address expected error %v return, got %s and addr %v", invalidAddr, expectedError, err, addr) + } + } + for validAddr, expectedAddr := range valids { + if addr, err := ParseTCPAddr(validAddr, defaultHTTPHost); err != nil || addr != expectedAddr { + t.Errorf("%v -> expected %v, got %v and addr %v", validAddr, expectedAddr, err, addr) + } + } +} + +func TestParseInvalidUnixAddrInvalid(t *testing.T) { + if _, err := ParseUnixAddr("tcp://127.0.0.1", "unix:///var/run/docker.sock"); err == nil || err.Error() != "Invalid proto, expected unix: tcp://127.0.0.1" { + t.Fatalf("Expected an error, got %v", err) + } + if _, err := ParseUnixAddr("unix://tcp://127.0.0.1", "/var/run/docker.sock"); err == nil || err.Error() != "Invalid proto, expected unix: tcp://127.0.0.1" { + t.Fatalf("Expected an error, got %v", err) + } + if v, err := ParseUnixAddr("", "/var/run/docker.sock"); err != nil || v != "unix:///var/run/docker.sock" { + t.Fatalf("Expected an %v, got %v", v, "unix:///var/run/docker.sock") + } +} + +func TestParseRepositoryTag(t *testing.T) { + if repo, tag := ParseRepositoryTag("root"); repo != "root" || tag != "" { + t.Errorf("Expected repo: '%s' and tag: '%s', got '%s' and '%s'", "root", "", repo, tag) + } + if repo, tag := ParseRepositoryTag("root:tag"); repo != "root" || tag != "tag" { + t.Errorf("Expected repo: '%s' and tag: '%s', got '%s' and '%s'", "root", "tag", repo, tag) + } + if repo, digest := ParseRepositoryTag("root@sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"); repo != "root" || digest != "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" { + t.Errorf("Expected repo: '%s' and digest: '%s', got '%s' and '%s'", "root", "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", repo, digest) + } + if repo, tag := ParseRepositoryTag("user/repo"); repo != "user/repo" || tag != "" { + t.Errorf("Expected repo: '%s' and tag: '%s', got '%s' and '%s'", "user/repo", "", repo, tag) + } + if repo, tag := ParseRepositoryTag("user/repo:tag"); repo != "user/repo" || tag != "tag" { + t.Errorf("Expected repo: '%s' and tag: '%s', got '%s' and '%s'", "user/repo", "tag", repo, tag) + } + if repo, digest := ParseRepositoryTag("user/repo@sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"); repo != "user/repo" || digest != "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" { + t.Errorf("Expected repo: '%s' and digest: '%s', got '%s' and '%s'", "user/repo", "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", repo, digest) + } + if repo, tag := ParseRepositoryTag("url:5000/repo"); repo != "url:5000/repo" || tag != "" { + t.Errorf("Expected repo: '%s' and tag: '%s', got '%s' and '%s'", "url:5000/repo", "", repo, tag) + } + if repo, tag := ParseRepositoryTag("url:5000/repo:tag"); repo != "url:5000/repo" || tag != "tag" { + t.Errorf("Expected repo: '%s' and tag: '%s', got '%s' and '%s'", "url:5000/repo", "tag", repo, tag) + } + if repo, digest := ParseRepositoryTag("url:5000/repo@sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"); repo != "url:5000/repo" || digest != "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" { + t.Errorf("Expected repo: '%s' and digest: '%s', got '%s' and '%s'", "url:5000/repo", "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", repo, digest) + } +} + +func TestParseKeyValueOpt(t *testing.T) { + invalids := map[string]string{ + "": "Unable to parse key/value option: ", + "key": "Unable to parse key/value option: key", + } + for invalid, expectedError := range invalids { + if _, _, err := ParseKeyValueOpt(invalid); err == nil || err.Error() != expectedError { + t.Fatalf("Expected error %v for %v, got %v", expectedError, invalid, err) + } + } + valids := map[string][]string{ + "key=value": {"key", "value"}, + " key = value ": {"key", "value"}, + "key=value1=value2": {"key", "value1=value2"}, + " key = value1 = value2 ": {"key", "value1 = value2"}, + } + for valid, expectedKeyValue := range valids { + key, value, err := ParseKeyValueOpt(valid) + if err != nil { + t.Fatal(err) + } + if key != expectedKeyValue[0] || value != expectedKeyValue[1] { + t.Fatalf("Expected {%v: %v} got {%v: %v}", expectedKeyValue[0], expectedKeyValue[1], key, value) + } + } +} + +func TestParsePortRange(t *testing.T) { + if start, end, err := ParsePortRange("8000-8080"); err != nil || start != 8000 || end != 8080 { + t.Fatalf("Error: %s or Expecting {start,end} values {8000,8080} but found {%d,%d}.", err, start, end) + } +} + +func TestParsePortRangeEmpty(t *testing.T) { + if _, _, err := ParsePortRange(""); err == nil || err.Error() != "Empty string specified for ports." { + t.Fatalf("Expected error 'Empty string specified for ports.', got %v", err) + } +} + +func TestParsePortRangeWithNoRange(t *testing.T) { + start, end, err := ParsePortRange("8080") + if err != nil { + t.Fatal(err) + } + if start != 8080 || end != 8080 { + t.Fatalf("Expected start and end to be the same and equal to 8080, but were %v and %v", start, end) + } +} + +func TestParsePortRangeIncorrectRange(t *testing.T) { + if _, _, err := ParsePortRange("9000-8080"); err == nil || !strings.Contains(err.Error(), "Invalid range specified for the Port") { + t.Fatalf("Expecting error 'Invalid range specified for the Port' but received %s.", err) + } +} + +func TestParsePortRangeIncorrectEndRange(t *testing.T) { + if _, _, err := ParsePortRange("8000-a"); err == nil || !strings.Contains(err.Error(), "invalid syntax") { + t.Fatalf("Expecting error 'Invalid range specified for the Port' but received %s.", err) + } + + if _, _, err := ParsePortRange("8000-30a"); err == nil || !strings.Contains(err.Error(), "invalid syntax") { + t.Fatalf("Expecting error 'Invalid range specified for the Port' but received %s.", err) + } +} + +func TestParsePortRangeIncorrectStartRange(t *testing.T) { + if _, _, err := ParsePortRange("a-8000"); err == nil || !strings.Contains(err.Error(), "invalid syntax") { + t.Fatalf("Expecting error 'Invalid range specified for the Port' but received %s.", err) + } + + if _, _, err := ParsePortRange("30a-8000"); err == nil || !strings.Contains(err.Error(), "invalid syntax") { + t.Fatalf("Expecting error 'Invalid range specified for the Port' but received %s.", err) + } +} + +func TestParseLink(t *testing.T) { + name, alias, err := ParseLink("name:alias") + if err != nil { + t.Fatalf("Expected not to error out on a valid name:alias format but got: %v", err) + } + if name != "name" { + t.Fatalf("Link name should have been name, got %s instead", name) + } + if alias != "alias" { + t.Fatalf("Link alias should have been alias, got %s instead", alias) + } + // short format definition + name, alias, err = ParseLink("name") + if err != nil { + t.Fatalf("Expected not to error out on a valid name only format but got: %v", err) + } + if name != "name" { + t.Fatalf("Link name should have been name, got %s instead", name) + } + if alias != "name" { + t.Fatalf("Link alias should have been name, got %s instead", alias) + } + // empty string link definition is not allowed + if _, _, err := ParseLink(""); err == nil || !strings.Contains(err.Error(), "empty string specified for links") { + t.Fatalf("Expected error 'empty string specified for links' but got: %v", err) + } + // more than two colons are not allowed + if _, _, err := ParseLink("link:alias:wrong"); err == nil || !strings.Contains(err.Error(), "bad format for links: link:alias:wrong") { + t.Fatalf("Expected error 'bad format for links: link:alias:wrong' but got: %v", err) + } +} + +func TestParseUintList(t *testing.T) { + valids := map[string]map[int]bool{ + "": {}, + "7": {7: true}, + "1-6": {1: true, 2: true, 3: true, 4: true, 5: true, 6: true}, + "0-7": {0: true, 1: true, 2: true, 3: true, 4: true, 5: true, 6: true, 7: true}, + "0,3-4,7,8-10": {0: true, 3: true, 4: true, 7: true, 8: true, 9: true, 10: true}, + "0-0,0,1-4": {0: true, 1: true, 2: true, 3: true, 4: true}, + "03,1-3": {1: true, 2: true, 3: true}, + "3,2,1": {1: true, 2: true, 3: true}, + "0-2,3,1": {0: true, 1: true, 2: true, 3: true}, + } + for k, v := range valids { + out, err := ParseUintList(k) + if err != nil { + t.Fatalf("Expected not to fail, got %v", err) + } + if !reflect.DeepEqual(out, v) { + t.Fatalf("Expected %v, got %v", v, out) + } + } + + invalids := []string{ + "this", + "1--", + "1-10,,10", + "10-1", + "-1", + "-1,0", + } + for _, v := range invalids { + if out, err := ParseUintList(v); err == nil { + t.Fatalf("Expected failure with %s but got %v", v, out) + } + } +} diff --git a/pkg/pidfile/pidfile.go b/pkg/pidfile/pidfile.go new file mode 100644 index 0000000000..db3535b014 --- /dev/null +++ b/pkg/pidfile/pidfile.go @@ -0,0 +1,48 @@ +// Package pidfile provides structure and helper functions to create and remove +// PID file. A PID file is usually a file used to store the process ID of a +// running process. +package pidfile + +import ( + "fmt" + "io/ioutil" + "os" + "path/filepath" + "strconv" +) + +// PIDFile is a file used to store the process ID of a running process. +type PIDFile struct { + path string +} + +func checkPIDFileAlreadyExists(path string) error { + if pidString, err := ioutil.ReadFile(path); err == nil { + if pid, err := strconv.Atoi(string(pidString)); err == nil { + if _, err := os.Stat(filepath.Join("/proc", string(pid))); err == nil { + return fmt.Errorf("pid file found, ensure docker is not running or delete %s", path) + } + } + } + return nil +} + +// New creates a PIDfile using the specified path. +func New(path string) (*PIDFile, error) { + if err := checkPIDFileAlreadyExists(path); err != nil { + return nil, err + } + if err := ioutil.WriteFile(path, []byte(fmt.Sprintf("%d", os.Getpid())), 0644); err != nil { + return nil, err + } + + return &PIDFile{path: path}, nil +} + +// Remove removes the PIDFile. +func (file PIDFile) Remove() error { + if err := os.Remove(file.path); err != nil { + return err + } + return nil +} diff --git a/pkg/pidfile/pidfile_test.go b/pkg/pidfile/pidfile_test.go new file mode 100644 index 0000000000..d5ef87083b --- /dev/null +++ b/pkg/pidfile/pidfile_test.go @@ -0,0 +1,32 @@ +package pidfile + +import ( + "io/ioutil" + "os" + "path/filepath" + "testing" +) + +func TestNewAndRemove(t *testing.T) { + dir, err := ioutil.TempDir(os.TempDir(), "test-pidfile") + if err != nil { + t.Fatal("Could not create test directory") + } + + file, err := New(filepath.Join(dir, "testfile")) + if err != nil { + t.Fatal("Could not create test file", err) + } + + if err := file.Remove(); err != nil { + t.Fatal("Could not delete created test file") + } +} + +func TestRemoveInvalidPath(t *testing.T) { + file := PIDFile{path: filepath.Join("foo", "bar")} + + if err := file.Remove(); err == nil { + t.Fatal("Non-existing file doesn't give an error on delete") + } +} diff --git a/pkg/plugins/client.go b/pkg/plugins/client.go new file mode 100644 index 0000000000..b64f0d6da2 --- /dev/null +++ b/pkg/plugins/client.go @@ -0,0 +1,154 @@ +package plugins + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net/http" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/sockets" + "github.com/docker/docker/pkg/tlsconfig" +) + +const ( + versionMimetype = "application/vnd.docker.plugins.v1.1+json" + defaultTimeOut = 30 +) + +type remoteError struct { + method string + err string +} + +func (e *remoteError) Error() string { + return fmt.Sprintf("Plugin Error: %s, %s", e.err, e.method) +} + +// NewClient creates a new plugin client (http). +func NewClient(addr string, tlsConfig tlsconfig.Options) (*Client, error) { + tr := &http.Transport{} + + c, err := tlsconfig.Client(tlsConfig) + if err != nil { + return nil, err + } + tr.TLSClientConfig = c + + protoAndAddr := strings.Split(addr, "://") + sockets.ConfigureTCPTransport(tr, protoAndAddr[0], protoAndAddr[1]) + + scheme := protoAndAddr[0] + if scheme != "https" { + scheme = "http" + } + return &Client{&http.Client{Transport: tr}, scheme, protoAndAddr[1]}, nil +} + +// Client represents a plugin client. +type Client struct { + http *http.Client // http client to use + scheme string // scheme protocol of the plugin + addr string // http address of the plugin +} + +// Call calls the specified method with the specified arguments for the plugin. +// It will retry for 30 seconds if a failure occurs when calling. +func (c *Client) Call(serviceMethod string, args interface{}, ret interface{}) error { + var buf bytes.Buffer + if err := json.NewEncoder(&buf).Encode(args); err != nil { + return err + } + body, err := c.callWithRetry(serviceMethod, &buf, true) + if err != nil { + return err + } + defer body.Close() + if err := json.NewDecoder(body).Decode(&ret); err != nil { + logrus.Errorf("%s: error reading plugin resp: %v", serviceMethod, err) + return err + } + return nil +} + +// Stream calls the specified method with the specified arguments for the plugin and returns the response body +func (c *Client) Stream(serviceMethod string, args interface{}) (io.ReadCloser, error) { + var buf bytes.Buffer + if err := json.NewEncoder(&buf).Encode(args); err != nil { + return nil, err + } + return c.callWithRetry(serviceMethod, &buf, true) +} + +// SendFile calls the specified method, and passes through the IO stream +func (c *Client) SendFile(serviceMethod string, data io.Reader, ret interface{}) error { + body, err := c.callWithRetry(serviceMethod, data, true) + if err != nil { + return err + } + if err := json.NewDecoder(body).Decode(&ret); err != nil { + logrus.Errorf("%s: error reading plugin resp: %v", serviceMethod, err) + return err + } + return nil +} + +func (c *Client) callWithRetry(serviceMethod string, data io.Reader, retry bool) (io.ReadCloser, error) { + req, err := http.NewRequest("POST", "/"+serviceMethod, data) + if err != nil { + return nil, err + } + req.Header.Add("Accept", versionMimetype) + req.URL.Scheme = c.scheme + req.URL.Host = c.addr + + var retries int + start := time.Now() + + for { + resp, err := c.http.Do(req) + if err != nil { + if !retry { + return nil, err + } + + timeOff := backoff(retries) + if abort(start, timeOff) { + return nil, err + } + retries++ + logrus.Warnf("Unable to connect to plugin: %s, retrying in %v", c.addr, timeOff) + time.Sleep(timeOff) + continue + } + + if resp.StatusCode != http.StatusOK { + remoteErr, err := ioutil.ReadAll(resp.Body) + if err != nil { + return nil, &remoteError{err.Error(), serviceMethod} + } + return nil, &remoteError{string(remoteErr), serviceMethod} + } + return resp.Body, nil + } +} + +func backoff(retries int) time.Duration { + b, max := 1, defaultTimeOut + for b < max && retries > 0 { + b *= 2 + retries-- + } + if b > max { + b = max + } + return time.Duration(b) * time.Second +} + +func abort(start time.Time, timeOff time.Duration) bool { + return timeOff+time.Since(start) >= time.Duration(defaultTimeOut)*time.Second +} diff --git a/pkg/plugins/client_test.go b/pkg/plugins/client_test.go new file mode 100644 index 0000000000..4fed491787 --- /dev/null +++ b/pkg/plugins/client_test.go @@ -0,0 +1,123 @@ +package plugins + +import ( + "io" + "net/http" + "net/http/httptest" + "reflect" + "testing" + "time" + + "github.com/docker/docker/pkg/tlsconfig" +) + +var ( + mux *http.ServeMux + server *httptest.Server +) + +func setupRemotePluginServer() string { + mux = http.NewServeMux() + server = httptest.NewServer(mux) + return server.URL +} + +func teardownRemotePluginServer() { + if server != nil { + server.Close() + } +} + +func TestFailedConnection(t *testing.T) { + c, _ := NewClient("tcp://127.0.0.1:1", tlsconfig.Options{InsecureSkipVerify: true}) + _, err := c.callWithRetry("Service.Method", nil, false) + if err == nil { + t.Fatal("Unexpected successful connection") + } +} + +func TestEchoInputOutput(t *testing.T) { + addr := setupRemotePluginServer() + defer teardownRemotePluginServer() + + m := Manifest{[]string{"VolumeDriver", "NetworkDriver"}} + + mux.HandleFunc("/Test.Echo", func(w http.ResponseWriter, r *http.Request) { + if r.Method != "POST" { + t.Fatalf("Expected POST, got %s\n", r.Method) + } + + header := w.Header() + header.Set("Content-Type", versionMimetype) + + io.Copy(w, r.Body) + }) + + c, _ := NewClient(addr, tlsconfig.Options{InsecureSkipVerify: true}) + var output Manifest + err := c.Call("Test.Echo", m, &output) + if err != nil { + t.Fatal(err) + } + + if !reflect.DeepEqual(output, m) { + t.Fatalf("Expected %v, was %v\n", m, output) + } +} + +func TestBackoff(t *testing.T) { + cases := []struct { + retries int + expTimeOff time.Duration + }{ + {0, time.Duration(1)}, + {1, time.Duration(2)}, + {2, time.Duration(4)}, + {4, time.Duration(16)}, + {6, time.Duration(30)}, + {10, time.Duration(30)}, + } + + for _, c := range cases { + s := c.expTimeOff * time.Second + if d := backoff(c.retries); d != s { + t.Fatalf("Retry %v, expected %v, was %v\n", c.retries, s, d) + } + } +} + +func TestAbortRetry(t *testing.T) { + cases := []struct { + timeOff time.Duration + expAbort bool + }{ + {time.Duration(1), false}, + {time.Duration(2), false}, + {time.Duration(10), false}, + {time.Duration(30), true}, + {time.Duration(40), true}, + } + + for _, c := range cases { + s := c.timeOff * time.Second + if a := abort(time.Now(), s); a != c.expAbort { + t.Fatalf("Duration %v, expected %v, was %v\n", c.timeOff, s, a) + } + } +} + +func TestClientScheme(t *testing.T) { + cases := map[string]string{ + "tcp://127.0.0.1:8080": "http", + "unix:///usr/local/plugins/foo": "http", + "http://127.0.0.1:8080": "http", + "https://127.0.0.1:8080": "https", + } + + for addr, scheme := range cases { + c, _ := NewClient(addr, tlsconfig.Options{InsecureSkipVerify: true}) + if c.scheme != scheme { + t.Fatalf("URL scheme mismatch, expected %s, got %s", scheme, c.scheme) + } + } +} diff --git a/pkg/plugins/discovery.go b/pkg/plugins/discovery.go new file mode 100644 index 0000000000..7bd470db08 --- /dev/null +++ b/pkg/plugins/discovery.go @@ -0,0 +1,106 @@ +package plugins + +import ( + "encoding/json" + "errors" + "fmt" + "io/ioutil" + "net/url" + "os" + "path/filepath" + "strings" +) + +var ( + // ErrNotFound plugin not found + ErrNotFound = errors.New("Plugin not found") + socketsPath = "/run/docker/plugins" + specsPaths = []string{"/etc/docker/plugins", "/usr/lib/docker/plugins"} +) + +// Registry defines behavior of a registry of plugins. +type Registry interface { + // Plugins lists all plugins. + Plugins() ([]*Plugin, error) + // Plugin returns the plugin registered with the given name (or returns an error). + Plugin(name string) (*Plugin, error) +} + +// LocalRegistry defines a registry that is local (using unix socket). +type LocalRegistry struct{} + +func newLocalRegistry() LocalRegistry { + return LocalRegistry{} +} + +// Plugin returns the plugin registered with the given name (or returns an error). +func (l *LocalRegistry) Plugin(name string) (*Plugin, error) { + socketpaths := pluginPaths(socketsPath, name, ".sock") + + for _, p := range socketpaths { + if fi, err := os.Stat(p); err == nil && fi.Mode()&os.ModeSocket != 0 { + return newLocalPlugin(name, "unix://"+p), nil + } + } + + var txtspecpaths []string + for _, p := range specsPaths { + txtspecpaths = append(txtspecpaths, pluginPaths(p, name, ".spec")...) + txtspecpaths = append(txtspecpaths, pluginPaths(p, name, ".json")...) + } + + for _, p := range txtspecpaths { + if _, err := os.Stat(p); err == nil { + if strings.HasSuffix(p, ".json") { + return readPluginJSONInfo(name, p) + } + return readPluginInfo(name, p) + } + } + return nil, ErrNotFound +} + +func readPluginInfo(name, path string) (*Plugin, error) { + content, err := ioutil.ReadFile(path) + if err != nil { + return nil, err + } + addr := strings.TrimSpace(string(content)) + + u, err := url.Parse(addr) + if err != nil { + return nil, err + } + + if len(u.Scheme) == 0 { + return nil, fmt.Errorf("Unknown protocol") + } + + return newLocalPlugin(name, addr), nil +} + +func readPluginJSONInfo(name, path string) (*Plugin, error) { + f, err := os.Open(path) + if err != nil { + return nil, err + } + defer f.Close() + + var p Plugin + if err := json.NewDecoder(f).Decode(&p); err != nil { + return nil, err + } + p.Name = name + if len(p.TLSConfig.CAFile) == 0 { + p.TLSConfig.InsecureSkipVerify = true + } + + return &p, nil +} + +func pluginPaths(base, name, ext string) []string { + return []string{ + filepath.Join(base, name+ext), + filepath.Join(base, name, name+ext), + } +} diff --git a/pkg/plugins/discovery_test.go b/pkg/plugins/discovery_test.go new file mode 100644 index 0000000000..5610fe1e9f --- /dev/null +++ b/pkg/plugins/discovery_test.go @@ -0,0 +1,169 @@ +package plugins + +import ( + "fmt" + "io/ioutil" + "net" + "os" + "path/filepath" + "reflect" + "testing" +) + +func setup(t *testing.T) (string, func()) { + tmpdir, err := ioutil.TempDir("", "docker-test") + if err != nil { + t.Fatal(err) + } + backup := socketsPath + socketsPath = tmpdir + specsPaths = []string{tmpdir} + + return tmpdir, func() { + socketsPath = backup + os.RemoveAll(tmpdir) + } +} + +func TestLocalSocket(t *testing.T) { + tmpdir, unregister := setup(t) + defer unregister() + + cases := []string{ + filepath.Join(tmpdir, "echo.sock"), + filepath.Join(tmpdir, "echo", "echo.sock"), + } + + for _, c := range cases { + if err := os.MkdirAll(filepath.Dir(c), 0755); err != nil { + t.Fatal(err) + } + + l, err := net.Listen("unix", c) + if err != nil { + t.Fatal(err) + } + + r := newLocalRegistry() + p, err := r.Plugin("echo") + if err != nil { + t.Fatal(err) + } + + pp, err := r.Plugin("echo") + if err != nil { + t.Fatal(err) + } + if !reflect.DeepEqual(p, pp) { + t.Fatalf("Expected %v, was %v\n", p, pp) + } + + if p.Name != "echo" { + t.Fatalf("Expected plugin `echo`, got %s\n", p.Name) + } + + addr := fmt.Sprintf("unix://%s", c) + if p.Addr != addr { + t.Fatalf("Expected plugin addr `%s`, got %s\n", addr, p.Addr) + } + if p.TLSConfig.InsecureSkipVerify != true { + t.Fatalf("Expected TLS verification to be skipped") + } + l.Close() + } +} + +func TestFileSpecPlugin(t *testing.T) { + tmpdir, unregister := setup(t) + defer unregister() + + cases := []struct { + path string + name string + addr string + fail bool + }{ + {filepath.Join(tmpdir, "echo.spec"), "echo", "unix://var/lib/docker/plugins/echo.sock", false}, + {filepath.Join(tmpdir, "echo", "echo.spec"), "echo", "unix://var/lib/docker/plugins/echo.sock", false}, + {filepath.Join(tmpdir, "foo.spec"), "foo", "tcp://localhost:8080", false}, + {filepath.Join(tmpdir, "foo", "foo.spec"), "foo", "tcp://localhost:8080", false}, + {filepath.Join(tmpdir, "bar.spec"), "bar", "localhost:8080", true}, // unknown transport + } + + for _, c := range cases { + if err := os.MkdirAll(filepath.Dir(c.path), 0755); err != nil { + t.Fatal(err) + } + if err := ioutil.WriteFile(c.path, []byte(c.addr), 0644); err != nil { + t.Fatal(err) + } + + r := newLocalRegistry() + p, err := r.Plugin(c.name) + if c.fail && err == nil { + continue + } + + if err != nil { + t.Fatal(err) + } + + if p.Name != c.name { + t.Fatalf("Expected plugin `%s`, got %s\n", c.name, p.Name) + } + + if p.Addr != c.addr { + t.Fatalf("Expected plugin addr `%s`, got %s\n", c.addr, p.Addr) + } + + if p.TLSConfig.InsecureSkipVerify != true { + t.Fatalf("Expected TLS verification to be skipped") + } + } +} + +func TestFileJSONSpecPlugin(t *testing.T) { + tmpdir, unregister := setup(t) + defer unregister() + + p := filepath.Join(tmpdir, "example.json") + spec := `{ + "Name": "plugin-example", + "Addr": "https://example.com/docker/plugin", + "TLSConfig": { + "CAFile": "/usr/shared/docker/certs/example-ca.pem", + "CertFile": "/usr/shared/docker/certs/example-cert.pem", + "KeyFile": "/usr/shared/docker/certs/example-key.pem" + } +}` + + if err := ioutil.WriteFile(p, []byte(spec), 0644); err != nil { + t.Fatal(err) + } + + r := newLocalRegistry() + plugin, err := r.Plugin("example") + if err != nil { + t.Fatal(err) + } + + if plugin.Name != "example" { + t.Fatalf("Expected plugin `plugin-example`, got %s\n", plugin.Name) + } + + if plugin.Addr != "https://example.com/docker/plugin" { + t.Fatalf("Expected plugin addr `https://example.com/docker/plugin`, got %s\n", plugin.Addr) + } + + if plugin.TLSConfig.CAFile != "/usr/shared/docker/certs/example-ca.pem" { + t.Fatalf("Expected plugin CA `/usr/shared/docker/certs/example-ca.pem`, got %s\n", plugin.TLSConfig.CAFile) + } + + if plugin.TLSConfig.CertFile != "/usr/shared/docker/certs/example-cert.pem" { + t.Fatalf("Expected plugin Certificate `/usr/shared/docker/certs/example-cert.pem`, got %s\n", plugin.TLSConfig.CertFile) + } + + if plugin.TLSConfig.KeyFile != "/usr/shared/docker/certs/example-key.pem" { + t.Fatalf("Expected plugin Key `/usr/shared/docker/certs/example-key.pem`, got %s\n", plugin.TLSConfig.KeyFile) + } +} diff --git a/pkg/plugins/pluginrpc-gen/README.md b/pkg/plugins/pluginrpc-gen/README.md new file mode 100644 index 0000000000..98720b2127 --- /dev/null +++ b/pkg/plugins/pluginrpc-gen/README.md @@ -0,0 +1,68 @@ +Plugin RPC Generator +==================== + +Generates go code from a Go interface definition for proxying between the plugin +API and the subsystem being extended. + +## Usage + +Given an interface definition: + +```go +type volumeDriver interface { + Create(name string, opts opts) (err error) + Remove(name string) (err error) + Path(name string) (mountpoint string, err error) + Mount(name string) (mountpoint string, err error) + Unmount(name string) (err error) +} +``` + +**Note**: All function options and return values must be named in the definition. + +Run the generator: + +```bash +$ pluginrpc-gen --type volumeDriver --name VolumeDriver -i volumes/drivers/extpoint.go -o volumes/drivers/proxy.go +``` + +Where: +- `--type` is the name of the interface to use +- `--name` is the subsystem that the plugin "Implements" +- `-i` is the input file containing the interface definition +- `-o` is the output file where the the generated code should go + +**Note**: The generated code will use the same package name as the one defined in the input file + +Optionally, you can skip functions on the interface that should not be +implemented in the generated proxy code by passing in the function name to `--skip`. +This flag can be specified multiple times. + +You can also add build tags that should be prepended to the generated code by +supplying `--tag`. This flag can be specified multiple times. + +## Known issues + +The parser can currently only handle types which are not specifically a map or +a slice. +You can, however, create a type that uses a map or a slice internally, for instance: + +```go +type opts map[string]string +``` + +This `opts` type will work, whreas using a `map[string]string` directly will not. + +## go-generate + +You can also use this with go-generate, which is pretty awesome. +To do so, place the code at the top of the file which contains the interface +definition (i.e., the input file): + +```go +//go:generate pluginrpc-gen -i $GOFILE -o proxy.go -type volumeDriver -name VolumeDriver +``` + +Then cd to the package dir and run `go generate` + +**Note**: the `pluginrpc-gen` binary must be within your `$PATH` diff --git a/pkg/plugins/pluginrpc-gen/fixtures/foo.go b/pkg/plugins/pluginrpc-gen/fixtures/foo.go new file mode 100644 index 0000000000..fcb2b6231d --- /dev/null +++ b/pkg/plugins/pluginrpc-gen/fixtures/foo.go @@ -0,0 +1,41 @@ +package foo + +type wobble struct { + Some string + Val string + Inception *wobble +} + +// Fooer is an empty interface used for tests. +type Fooer interface{} + +// Fooer2 is an interface used for tests. +type Fooer2 interface { + Foo() +} + +// Fooer3 is an interface used for tests. +type Fooer3 interface { + Foo() + Bar(a string) + Baz(a string) (err error) + Qux(a, b string) (val string, err error) + Wobble() (w *wobble) + Wiggle() (w wobble) +} + +// Fooer4 is an interface used for tests. +type Fooer4 interface { + Foo() error +} + +// Bar is an interface used for tests. +type Bar interface { + Boo(a string, b string) (s string, err error) +} + +// Fooer5 is an interface used for tests. +type Fooer5 interface { + Foo() + Bar +} diff --git a/pkg/plugins/pluginrpc-gen/main.go b/pkg/plugins/pluginrpc-gen/main.go new file mode 100644 index 0000000000..772984ce3a --- /dev/null +++ b/pkg/plugins/pluginrpc-gen/main.go @@ -0,0 +1,91 @@ +package main + +import ( + "bytes" + "flag" + "fmt" + "go/format" + "io/ioutil" + "os" + "unicode" + "unicode/utf8" +) + +type stringSet struct { + values map[string]struct{} +} + +func (s stringSet) String() string { + return "" +} + +func (s stringSet) Set(value string) error { + s.values[value] = struct{}{} + return nil +} +func (s stringSet) GetValues() map[string]struct{} { + return s.values +} + +var ( + typeName = flag.String("type", "", "interface type to generate plugin rpc proxy for") + rpcName = flag.String("name", *typeName, "RPC name, set if different from type") + inputFile = flag.String("i", "", "input file path") + outputFile = flag.String("o", *inputFile+"_proxy.go", "output file path") + + skipFuncs map[string]struct{} + flSkipFuncs = stringSet{make(map[string]struct{})} + + flBuildTags = stringSet{make(map[string]struct{})} +) + +func errorOut(msg string, err error) { + if err == nil { + return + } + fmt.Fprintf(os.Stderr, "%s: %v\n", msg, err) + os.Exit(1) +} + +func checkFlags() error { + if *outputFile == "" { + return fmt.Errorf("missing required flag `-o`") + } + if *inputFile == "" { + return fmt.Errorf("missing required flag `-i`") + } + return nil +} + +func main() { + flag.Var(flSkipFuncs, "skip", "skip parsing for function") + flag.Var(flBuildTags, "tag", "build tags to add to generated files") + flag.Parse() + skipFuncs = flSkipFuncs.GetValues() + + errorOut("error", checkFlags()) + + pkg, err := Parse(*inputFile, *typeName) + errorOut(fmt.Sprintf("error parsing requested type %s", *typeName), err) + + var analysis = struct { + InterfaceType string + RPCName string + BuildTags map[string]struct{} + *ParsedPkg + }{toLower(*typeName), *rpcName, flBuildTags.GetValues(), pkg} + var buf bytes.Buffer + + errorOut("parser error", generatedTempl.Execute(&buf, analysis)) + src, err := format.Source(buf.Bytes()) + errorOut("error formating generated source", err) + errorOut("error writing file", ioutil.WriteFile(*outputFile, src, 0644)) +} + +func toLower(s string) string { + if s == "" { + return "" + } + r, n := utf8.DecodeRuneInString(s) + return string(unicode.ToLower(r)) + s[n:] +} diff --git a/pkg/plugins/pluginrpc-gen/parser.go b/pkg/plugins/pluginrpc-gen/parser.go new file mode 100644 index 0000000000..3adeb4905c --- /dev/null +++ b/pkg/plugins/pluginrpc-gen/parser.go @@ -0,0 +1,163 @@ +package main + +import ( + "errors" + "fmt" + "go/ast" + "go/parser" + "go/token" + "reflect" +) + +var errBadReturn = errors.New("found return arg with no name: all args must be named") + +type errUnexpectedType struct { + expected string + actual interface{} +} + +func (e errUnexpectedType) Error() string { + return fmt.Sprintf("got wrong type expecting %s, got: %v", e.expected, reflect.TypeOf(e.actual)) +} + +// ParsedPkg holds information about a package that has been parsed, +// its name and the list of functions. +type ParsedPkg struct { + Name string + Functions []function +} + +type function struct { + Name string + Args []arg + Returns []arg + Doc string +} + +type arg struct { + Name string + ArgType string +} + +func (a *arg) String() string { + return a.Name + " " + a.ArgType +} + +// Parse parses the given file for an interface definition with the given name. +func Parse(filePath string, objName string) (*ParsedPkg, error) { + fs := token.NewFileSet() + pkg, err := parser.ParseFile(fs, filePath, nil, parser.AllErrors) + if err != nil { + return nil, err + } + p := &ParsedPkg{} + p.Name = pkg.Name.Name + obj, exists := pkg.Scope.Objects[objName] + if !exists { + return nil, fmt.Errorf("could not find object %s in %s", objName, filePath) + } + if obj.Kind != ast.Typ { + return nil, fmt.Errorf("exected type, got %s", obj.Kind) + } + spec, ok := obj.Decl.(*ast.TypeSpec) + if !ok { + return nil, errUnexpectedType{"*ast.TypeSpec", obj.Decl} + } + iface, ok := spec.Type.(*ast.InterfaceType) + if !ok { + return nil, errUnexpectedType{"*ast.InterfaceType", spec.Type} + } + + p.Functions, err = parseInterface(iface) + if err != nil { + return nil, err + } + + return p, nil +} + +func parseInterface(iface *ast.InterfaceType) ([]function, error) { + var functions []function + for _, field := range iface.Methods.List { + switch f := field.Type.(type) { + case *ast.FuncType: + method, err := parseFunc(field) + if err != nil { + return nil, err + } + if method == nil { + continue + } + functions = append(functions, *method) + case *ast.Ident: + spec, ok := f.Obj.Decl.(*ast.TypeSpec) + if !ok { + return nil, errUnexpectedType{"*ast.TypeSpec", f.Obj.Decl} + } + iface, ok := spec.Type.(*ast.InterfaceType) + if !ok { + return nil, errUnexpectedType{"*ast.TypeSpec", spec.Type} + } + funcs, err := parseInterface(iface) + if err != nil { + fmt.Println(err) + continue + } + functions = append(functions, funcs...) + default: + return nil, errUnexpectedType{"*astFuncType or *ast.Ident", f} + } + } + return functions, nil +} + +func parseFunc(field *ast.Field) (*function, error) { + f := field.Type.(*ast.FuncType) + method := &function{Name: field.Names[0].Name} + if _, exists := skipFuncs[method.Name]; exists { + fmt.Println("skipping:", method.Name) + return nil, nil + } + if f.Params != nil { + args, err := parseArgs(f.Params.List) + if err != nil { + return nil, err + } + method.Args = args + } + if f.Results != nil { + returns, err := parseArgs(f.Results.List) + if err != nil { + return nil, fmt.Errorf("error parsing function returns for %q: %v", method.Name, err) + } + method.Returns = returns + } + return method, nil +} + +func parseArgs(fields []*ast.Field) ([]arg, error) { + var args []arg + for _, f := range fields { + if len(f.Names) == 0 { + return nil, errBadReturn + } + for _, name := range f.Names { + var typeName string + switch argType := f.Type.(type) { + case *ast.Ident: + typeName = argType.Name + case *ast.StarExpr: + i, ok := argType.X.(*ast.Ident) + if !ok { + return nil, errUnexpectedType{"*ast.Ident", f.Type} + } + typeName = "*" + i.Name + default: + return nil, errUnexpectedType{"*ast.Ident or *ast.StarExpr", f.Type} + } + + args = append(args, arg{name.Name, typeName}) + } + } + return args, nil +} diff --git a/pkg/plugins/pluginrpc-gen/parser_test.go b/pkg/plugins/pluginrpc-gen/parser_test.go new file mode 100644 index 0000000000..5a7579cfa8 --- /dev/null +++ b/pkg/plugins/pluginrpc-gen/parser_test.go @@ -0,0 +1,168 @@ +package main + +import ( + "fmt" + "path/filepath" + "runtime" + "strings" + "testing" +) + +const testFixture = "fixtures/foo.go" + +func TestParseEmptyInterface(t *testing.T) { + pkg, err := Parse(testFixture, "Fooer") + if err != nil { + t.Fatal(err) + } + + assertName(t, "foo", pkg.Name) + assertNum(t, 0, len(pkg.Functions)) +} + +func TestParseNonInterfaceType(t *testing.T) { + _, err := Parse(testFixture, "wobble") + if _, ok := err.(errUnexpectedType); !ok { + t.Fatal("expected type error when parsing non-interface type") + } +} + +func TestParseWithOneFunction(t *testing.T) { + pkg, err := Parse(testFixture, "Fooer2") + if err != nil { + t.Fatal(err) + } + + assertName(t, "foo", pkg.Name) + assertNum(t, 1, len(pkg.Functions)) + assertName(t, "Foo", pkg.Functions[0].Name) + assertNum(t, 0, len(pkg.Functions[0].Args)) + assertNum(t, 0, len(pkg.Functions[0].Returns)) +} + +func TestParseWithMultipleFuncs(t *testing.T) { + pkg, err := Parse(testFixture, "Fooer3") + if err != nil { + t.Fatal(err) + } + + assertName(t, "foo", pkg.Name) + assertNum(t, 6, len(pkg.Functions)) + + f := pkg.Functions[0] + assertName(t, "Foo", f.Name) + assertNum(t, 0, len(f.Args)) + assertNum(t, 0, len(f.Returns)) + + f = pkg.Functions[1] + assertName(t, "Bar", f.Name) + assertNum(t, 1, len(f.Args)) + assertNum(t, 0, len(f.Returns)) + arg := f.Args[0] + assertName(t, "a", arg.Name) + assertName(t, "string", arg.ArgType) + + f = pkg.Functions[2] + assertName(t, "Baz", f.Name) + assertNum(t, 1, len(f.Args)) + assertNum(t, 1, len(f.Returns)) + arg = f.Args[0] + assertName(t, "a", arg.Name) + assertName(t, "string", arg.ArgType) + arg = f.Returns[0] + assertName(t, "err", arg.Name) + assertName(t, "error", arg.ArgType) + + f = pkg.Functions[3] + assertName(t, "Qux", f.Name) + assertNum(t, 2, len(f.Args)) + assertNum(t, 2, len(f.Returns)) + arg = f.Args[0] + assertName(t, "a", f.Args[0].Name) + assertName(t, "string", f.Args[0].ArgType) + arg = f.Args[1] + assertName(t, "b", arg.Name) + assertName(t, "string", arg.ArgType) + arg = f.Returns[0] + assertName(t, "val", arg.Name) + assertName(t, "string", arg.ArgType) + arg = f.Returns[1] + assertName(t, "err", arg.Name) + assertName(t, "error", arg.ArgType) + + f = pkg.Functions[4] + assertName(t, "Wobble", f.Name) + assertNum(t, 0, len(f.Args)) + assertNum(t, 1, len(f.Returns)) + arg = f.Returns[0] + assertName(t, "w", arg.Name) + assertName(t, "*wobble", arg.ArgType) + + f = pkg.Functions[5] + assertName(t, "Wiggle", f.Name) + assertNum(t, 0, len(f.Args)) + assertNum(t, 1, len(f.Returns)) + arg = f.Returns[0] + assertName(t, "w", arg.Name) + assertName(t, "wobble", arg.ArgType) +} + +func TestParseWithUnamedReturn(t *testing.T) { + _, err := Parse(testFixture, "Fooer4") + if !strings.HasSuffix(err.Error(), errBadReturn.Error()) { + t.Fatalf("expected ErrBadReturn, got %v", err) + } +} + +func TestEmbeddedInterface(t *testing.T) { + pkg, err := Parse(testFixture, "Fooer5") + if err != nil { + t.Fatal(err) + } + + assertName(t, "foo", pkg.Name) + assertNum(t, 2, len(pkg.Functions)) + + f := pkg.Functions[0] + assertName(t, "Foo", f.Name) + assertNum(t, 0, len(f.Args)) + assertNum(t, 0, len(f.Returns)) + + f = pkg.Functions[1] + assertName(t, "Boo", f.Name) + assertNum(t, 2, len(f.Args)) + assertNum(t, 2, len(f.Returns)) + + arg := f.Args[0] + assertName(t, "a", arg.Name) + assertName(t, "string", arg.ArgType) + + arg = f.Args[1] + assertName(t, "b", arg.Name) + assertName(t, "string", arg.ArgType) + + arg = f.Returns[0] + assertName(t, "s", arg.Name) + assertName(t, "string", arg.ArgType) + + arg = f.Returns[1] + assertName(t, "err", arg.Name) + assertName(t, "error", arg.ArgType) +} + +func assertName(t *testing.T, expected, actual string) { + if expected != actual { + fatalOut(t, fmt.Sprintf("expected name to be `%s`, got: %s", expected, actual)) + } +} + +func assertNum(t *testing.T, expected, actual int) { + if expected != actual { + fatalOut(t, fmt.Sprintf("expected number to be %d, got: %d", expected, actual)) + } +} + +func fatalOut(t *testing.T, msg string) { + _, file, ln, _ := runtime.Caller(2) + t.Fatalf("%s:%d: %s", filepath.Base(file), ln, msg) +} diff --git a/pkg/plugins/pluginrpc-gen/template.go b/pkg/plugins/pluginrpc-gen/template.go new file mode 100644 index 0000000000..704030cf0f --- /dev/null +++ b/pkg/plugins/pluginrpc-gen/template.go @@ -0,0 +1,97 @@ +package main + +import ( + "strings" + "text/template" +) + +func printArgs(args []arg) string { + var argStr []string + for _, arg := range args { + argStr = append(argStr, arg.String()) + } + return strings.Join(argStr, ", ") +} + +func marshalType(t string) string { + switch t { + case "error": + // convert error types to plain strings to ensure the values are encoded/decoded properly + return "string" + default: + return t + } +} + +func isErr(t string) bool { + switch t { + case "error": + return true + default: + return false + } +} + +// Need to use this helper due to issues with go-vet +func buildTag(s string) string { + return "+build " + s +} + +var templFuncs = template.FuncMap{ + "printArgs": printArgs, + "marshalType": marshalType, + "isErr": isErr, + "lower": strings.ToLower, + "title": strings.Title, + "tag": buildTag, +} + +var generatedTempl = template.Must(template.New("rpc_cient").Funcs(templFuncs).Parse(` +// generated code - DO NOT EDIT +{{ range $k, $v := .BuildTags }} + // {{ tag $k }} {{ end }} + +package {{ .Name }} + +import "errors" + +type client interface{ + Call(string, interface{}, interface{}) error +} + +type {{ .InterfaceType }}Proxy struct { + client +} + +{{ range .Functions }} + type {{ $.InterfaceType }}Proxy{{ .Name }}Request struct{ + {{ range .Args }} + {{ title .Name }} {{ .ArgType }} {{ end }} + } + + type {{ $.InterfaceType }}Proxy{{ .Name }}Response struct{ + {{ range .Returns }} + {{ title .Name }} {{ marshalType .ArgType }} {{ end }} + } + + func (pp *{{ $.InterfaceType }}Proxy) {{ .Name }}({{ printArgs .Args }}) ({{ printArgs .Returns }}) { + var( + req {{ $.InterfaceType }}Proxy{{ .Name }}Request + ret {{ $.InterfaceType }}Proxy{{ .Name }}Response + ) + {{ range .Args }} + req.{{ title .Name }} = {{ lower .Name }} {{ end }} + if err = pp.Call("{{ $.RPCName }}.{{ .Name }}", req, &ret); err != nil { + return + } + {{ range $r := .Returns }} + {{ if isErr .ArgType }} + if ret.{{ title .Name }} != "" { + {{ lower .Name }} = errors.New(ret.{{ title .Name }}) + } {{ end }} + {{ if isErr .ArgType | not }} {{ lower .Name }} = ret.{{ title .Name }} {{ end }} {{ end }} + + return + } +{{ end }} +`)) diff --git a/pkg/plugins/plugins.go b/pkg/plugins/plugins.go new file mode 100644 index 0000000000..f9e22d651f --- /dev/null +++ b/pkg/plugins/plugins.go @@ -0,0 +1,182 @@ +// Package plugins provides structures and helper functions to manage Docker +// plugins. +// +// Docker discovers plugins by looking for them in the plugin directory whenever +// a user or container tries to use one by name. UNIX domain socket files must +// be located under /run/docker/plugins, whereas spec files can be located +// either under /etc/docker/plugins or /usr/lib/docker/plugins. This is handled +// by the Registry interface, which lets you list all plugins or get a plugin by +// its name if it exists. +// +// The plugins need to implement an HTTP server and bind this to the UNIX socket +// or the address specified in the spec files. +// A handshake is send at /Plugin.Activate, and plugins are expected to return +// a Manifest with a list of of Docker subsystems which this plugin implements. +// +// In order to use a plugins, you can use the ``Get`` with the name of the +// plugin and the subsystem it implements. +// +// plugin, err := plugins.Get("example", "VolumeDriver") +// if err != nil { +// return fmt.Errorf("Error looking up volume plugin example: %v", err) +// } +package plugins + +import ( + "errors" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/tlsconfig" +) + +var ( + // ErrNotImplements is returned if the plugin does not implement the requested driver. + ErrNotImplements = errors.New("Plugin does not implement the requested driver") +) + +type plugins struct { + sync.Mutex + plugins map[string]*Plugin +} + +var ( + storage = plugins{plugins: make(map[string]*Plugin)} + extpointHandlers = make(map[string]func(string, *Client)) +) + +// Manifest lists what a plugin implements. +type Manifest struct { + // List of subsystem the plugin implements. + Implements []string +} + +// Plugin is the definition of a docker plugin. +type Plugin struct { + // Name of the plugin + Name string `json:"-"` + // Address of the plugin + Addr string + // TLS configuration of the plugin + TLSConfig tlsconfig.Options + // Client attached to the plugin + Client *Client `json:"-"` + // Manifest of the plugin (see above) + Manifest *Manifest `json:"-"` + + activatErr error + activateOnce sync.Once +} + +func newLocalPlugin(name, addr string) *Plugin { + return &Plugin{ + Name: name, + Addr: addr, + TLSConfig: tlsconfig.Options{InsecureSkipVerify: true}, + } +} + +func (p *Plugin) activate() error { + p.activateOnce.Do(func() { + p.activatErr = p.activateWithLock() + }) + return p.activatErr +} + +func (p *Plugin) activateWithLock() error { + c, err := NewClient(p.Addr, p.TLSConfig) + if err != nil { + return err + } + p.Client = c + + m := new(Manifest) + if err = p.Client.Call("Plugin.Activate", nil, m); err != nil { + return err + } + + logrus.Debugf("%s's manifest: %v", p.Name, m) + p.Manifest = m + + for _, iface := range m.Implements { + handler, handled := extpointHandlers[iface] + if !handled { + continue + } + handler(p.Name, p.Client) + } + return nil +} + +func load(name string) (*Plugin, error) { + return loadWithRetry(name, true) +} + +func loadWithRetry(name string, retry bool) (*Plugin, error) { + registry := newLocalRegistry() + start := time.Now() + + var retries int + for { + pl, err := registry.Plugin(name) + if err != nil { + if !retry { + return nil, err + } + + timeOff := backoff(retries) + if abort(start, timeOff) { + return nil, err + } + retries++ + logrus.Warnf("Unable to locate plugin: %s, retrying in %v", name, timeOff) + time.Sleep(timeOff) + continue + } + + storage.Lock() + storage.plugins[name] = pl + storage.Unlock() + + err = pl.activate() + + if err != nil { + storage.Lock() + delete(storage.plugins, name) + storage.Unlock() + } + + return pl, err + } +} + +func get(name string) (*Plugin, error) { + storage.Lock() + pl, ok := storage.plugins[name] + storage.Unlock() + if ok { + return pl, pl.activate() + } + return load(name) +} + +// Get returns the plugin given the specified name and requested implementation. +func Get(name, imp string) (*Plugin, error) { + pl, err := get(name) + if err != nil { + return nil, err + } + for _, driver := range pl.Manifest.Implements { + logrus.Debugf("%s implements: %s", name, driver) + if driver == imp { + return pl, nil + } + } + return nil, ErrNotImplements +} + +// Handle adds the specified function to the extpointHandlers. +func Handle(iface string, fn func(string, *Client)) { + extpointHandlers[iface] = fn +} diff --git a/pkg/pools/pools.go b/pkg/pools/pools.go new file mode 100644 index 0000000000..76e84f9d7c --- /dev/null +++ b/pkg/pools/pools.go @@ -0,0 +1,119 @@ +// Package pools provides a collection of pools which provide various +// data types with buffers. These can be used to lower the number of +// memory allocations and reuse buffers. +// +// New pools should be added to this package to allow them to be +// shared across packages. +// +// Utility functions which operate on pools should be added to this +// package to allow them to be reused. +package pools + +import ( + "bufio" + "io" + "sync" + + "github.com/docker/docker/pkg/ioutils" +) + +var ( + // BufioReader32KPool is a pool which returns bufio.Reader with a 32K buffer. + BufioReader32KPool *BufioReaderPool + // BufioWriter32KPool is a pool which returns bufio.Writer with a 32K buffer. + BufioWriter32KPool *BufioWriterPool +) + +const buffer32K = 32 * 1024 + +// BufioReaderPool is a bufio reader that uses sync.Pool. +type BufioReaderPool struct { + pool sync.Pool +} + +func init() { + BufioReader32KPool = newBufioReaderPoolWithSize(buffer32K) + BufioWriter32KPool = newBufioWriterPoolWithSize(buffer32K) +} + +// newBufioReaderPoolWithSize is unexported because new pools should be +// added here to be shared where required. +func newBufioReaderPoolWithSize(size int) *BufioReaderPool { + pool := sync.Pool{ + New: func() interface{} { return bufio.NewReaderSize(nil, size) }, + } + return &BufioReaderPool{pool: pool} +} + +// Get returns a bufio.Reader which reads from r. The buffer size is that of the pool. +func (bufPool *BufioReaderPool) Get(r io.Reader) *bufio.Reader { + buf := bufPool.pool.Get().(*bufio.Reader) + buf.Reset(r) + return buf +} + +// Put puts the bufio.Reader back into the pool. +func (bufPool *BufioReaderPool) Put(b *bufio.Reader) { + b.Reset(nil) + bufPool.pool.Put(b) +} + +// Copy is a convenience wrapper which uses a buffer to avoid allocation in io.Copy. +func Copy(dst io.Writer, src io.Reader) (written int64, err error) { + buf := BufioReader32KPool.Get(src) + written, err = io.Copy(dst, buf) + BufioReader32KPool.Put(buf) + return +} + +// NewReadCloserWrapper returns a wrapper which puts the bufio.Reader back +// into the pool and closes the reader if it's an io.ReadCloser. +func (bufPool *BufioReaderPool) NewReadCloserWrapper(buf *bufio.Reader, r io.Reader) io.ReadCloser { + return ioutils.NewReadCloserWrapper(r, func() error { + if readCloser, ok := r.(io.ReadCloser); ok { + readCloser.Close() + } + bufPool.Put(buf) + return nil + }) +} + +// BufioWriterPool is a bufio writer that uses sync.Pool. +type BufioWriterPool struct { + pool sync.Pool +} + +// newBufioWriterPoolWithSize is unexported because new pools should be +// added here to be shared where required. +func newBufioWriterPoolWithSize(size int) *BufioWriterPool { + pool := sync.Pool{ + New: func() interface{} { return bufio.NewWriterSize(nil, size) }, + } + return &BufioWriterPool{pool: pool} +} + +// Get returns a bufio.Writer which writes to w. The buffer size is that of the pool. +func (bufPool *BufioWriterPool) Get(w io.Writer) *bufio.Writer { + buf := bufPool.pool.Get().(*bufio.Writer) + buf.Reset(w) + return buf +} + +// Put puts the bufio.Writer back into the pool. +func (bufPool *BufioWriterPool) Put(b *bufio.Writer) { + b.Reset(nil) + bufPool.pool.Put(b) +} + +// NewWriteCloserWrapper returns a wrapper which puts the bufio.Writer back +// into the pool and closes the writer if it's an io.Writecloser. +func (bufPool *BufioWriterPool) NewWriteCloserWrapper(buf *bufio.Writer, w io.Writer) io.WriteCloser { + return ioutils.NewWriteCloserWrapper(w, func() error { + buf.Flush() + if writeCloser, ok := w.(io.WriteCloser); ok { + writeCloser.Close() + } + bufPool.Put(buf) + return nil + }) +} diff --git a/pkg/pools/pools_test.go b/pkg/pools/pools_test.go new file mode 100644 index 0000000000..78689800b4 --- /dev/null +++ b/pkg/pools/pools_test.go @@ -0,0 +1,162 @@ +package pools + +import ( + "bufio" + "bytes" + "io" + "strings" + "testing" +) + +func TestBufioReaderPoolGetWithNoReaderShouldCreateOne(t *testing.T) { + reader := BufioReader32KPool.Get(nil) + if reader == nil { + t.Fatalf("BufioReaderPool should have create a bufio.Reader but did not.") + } +} + +func TestBufioReaderPoolPutAndGet(t *testing.T) { + sr := bufio.NewReader(strings.NewReader("foobar")) + reader := BufioReader32KPool.Get(sr) + if reader == nil { + t.Fatalf("BufioReaderPool should not return a nil reader.") + } + // verify the first 3 byte + buf1 := make([]byte, 3) + _, err := reader.Read(buf1) + if err != nil { + t.Fatal(err) + } + if actual := string(buf1); actual != "foo" { + t.Fatalf("The first letter should have been 'foo' but was %v", actual) + } + BufioReader32KPool.Put(reader) + // Try to read the next 3 bytes + _, err = sr.Read(make([]byte, 3)) + if err == nil || err != io.EOF { + t.Fatalf("The buffer should have been empty, issue an EOF error.") + } +} + +type simpleReaderCloser struct { + io.Reader + closed bool +} + +func (r *simpleReaderCloser) Close() error { + r.closed = true + return nil +} + +func TestNewReadCloserWrapperWithAReadCloser(t *testing.T) { + br := bufio.NewReader(strings.NewReader("")) + sr := &simpleReaderCloser{ + Reader: strings.NewReader("foobar"), + closed: false, + } + reader := BufioReader32KPool.NewReadCloserWrapper(br, sr) + if reader == nil { + t.Fatalf("NewReadCloserWrapper should not return a nil reader.") + } + // Verify the content of reader + buf := make([]byte, 3) + _, err := reader.Read(buf) + if err != nil { + t.Fatal(err) + } + if actual := string(buf); actual != "foo" { + t.Fatalf("The first 3 letter should have been 'foo' but were %v", actual) + } + reader.Close() + // Read 3 more bytes "bar" + _, err = reader.Read(buf) + if err != nil { + t.Fatal(err) + } + if actual := string(buf); actual != "bar" { + t.Fatalf("The first 3 letter should have been 'bar' but were %v", actual) + } + if !sr.closed { + t.Fatalf("The ReaderCloser should have been closed, it is not.") + } +} + +func TestBufioWriterPoolGetWithNoReaderShouldCreateOne(t *testing.T) { + writer := BufioWriter32KPool.Get(nil) + if writer == nil { + t.Fatalf("BufioWriterPool should have create a bufio.Writer but did not.") + } +} + +func TestBufioWriterPoolPutAndGet(t *testing.T) { + buf := new(bytes.Buffer) + bw := bufio.NewWriter(buf) + writer := BufioWriter32KPool.Get(bw) + if writer == nil { + t.Fatalf("BufioReaderPool should not return a nil writer.") + } + written, err := writer.Write([]byte("foobar")) + if err != nil { + t.Fatal(err) + } + if written != 6 { + t.Fatalf("Should have written 6 bytes, but wrote %v bytes", written) + } + // Make sure we Flush all the way ? + writer.Flush() + bw.Flush() + if len(buf.Bytes()) != 6 { + t.Fatalf("The buffer should contain 6 bytes ('foobar') but contains %v ('%v')", buf.Bytes(), string(buf.Bytes())) + } + // Reset the buffer + buf.Reset() + BufioWriter32KPool.Put(writer) + // Try to write something + written, err = writer.Write([]byte("barfoo")) + if err != nil { + t.Fatal(err) + } + // If we now try to flush it, it should panic (the writer is nil) + // recover it + defer func() { + if r := recover(); r == nil { + t.Fatal("Trying to flush the writter should have 'paniced', did not.") + } + }() + writer.Flush() +} + +type simpleWriterCloser struct { + io.Writer + closed bool +} + +func (r *simpleWriterCloser) Close() error { + r.closed = true + return nil +} + +func TestNewWriteCloserWrapperWithAWriteCloser(t *testing.T) { + buf := new(bytes.Buffer) + bw := bufio.NewWriter(buf) + sw := &simpleWriterCloser{ + Writer: new(bytes.Buffer), + closed: false, + } + bw.Flush() + writer := BufioWriter32KPool.NewWriteCloserWrapper(bw, sw) + if writer == nil { + t.Fatalf("BufioReaderPool should not return a nil writer.") + } + written, err := writer.Write([]byte("foobar")) + if err != nil { + t.Fatal(err) + } + if written != 6 { + t.Fatalf("Should have written 6 bytes, but wrote %v bytes", written) + } + writer.Close() + if !sw.closed { + t.Fatalf("The ReaderCloser should have been closed, it is not.") + } +} diff --git a/pkg/progressreader/progressreader.go b/pkg/progressreader/progressreader.go new file mode 100644 index 0000000000..f48442b591 --- /dev/null +++ b/pkg/progressreader/progressreader.go @@ -0,0 +1,68 @@ +// Package progressreader provides a Reader with a progress bar that can be +// printed out using the streamformatter package. +package progressreader + +import ( + "io" + + "github.com/docker/docker/pkg/jsonmessage" + "github.com/docker/docker/pkg/streamformatter" +) + +// Config contains the configuration for a Reader with progress bar. +type Config struct { + In io.ReadCloser // Stream to read from + Out io.Writer // Where to send progress bar to + Formatter *streamformatter.StreamFormatter + Size int64 + Current int64 + LastUpdate int64 + NewLines bool + ID string + Action string +} + +// New creates a new Config. +func New(newReader Config) *Config { + return &newReader +} + +func (config *Config) Read(p []byte) (n int, err error) { + read, err := config.In.Read(p) + config.Current += int64(read) + updateEvery := int64(1024 * 512) //512kB + if config.Size > 0 { + // Update progress for every 1% read if 1% < 512kB + if increment := int64(0.01 * float64(config.Size)); increment < updateEvery { + updateEvery = increment + } + } + if config.Current-config.LastUpdate > updateEvery || err != nil { + updateProgress(config) + config.LastUpdate = config.Current + } + + if err != nil && read == 0 { + updateProgress(config) + if config.NewLines { + config.Out.Write(config.Formatter.FormatStatus("", "")) + } + } + return read, err +} + +// Close closes the reader (Config). +func (config *Config) Close() error { + if config.Current < config.Size { + //print a full progress bar when closing prematurely + config.Current = config.Size + updateProgress(config) + } + return config.In.Close() +} + +func updateProgress(config *Config) { + progress := jsonmessage.JSONProgress{Current: config.Current, Total: config.Size} + fmtMessage := config.Formatter.FormatProgress(config.ID, config.Action, &progress) + config.Out.Write(fmtMessage) +} diff --git a/pkg/progressreader/progressreader_test.go b/pkg/progressreader/progressreader_test.go new file mode 100644 index 0000000000..21d9b0f057 --- /dev/null +++ b/pkg/progressreader/progressreader_test.go @@ -0,0 +1,94 @@ +package progressreader + +import ( + "bufio" + "bytes" + "io" + "io/ioutil" + "testing" + + "github.com/docker/docker/pkg/streamformatter" +) + +func TestOutputOnPrematureClose(t *testing.T) { + var outBuf bytes.Buffer + content := []byte("TESTING") + reader := ioutil.NopCloser(bytes.NewReader(content)) + writer := bufio.NewWriter(&outBuf) + + prCfg := Config{ + In: reader, + Out: writer, + Formatter: streamformatter.NewStreamFormatter(), + Size: int64(len(content)), + NewLines: true, + ID: "Test", + Action: "Read", + } + pr := New(prCfg) + + part := make([]byte, 4, 4) + _, err := io.ReadFull(pr, part) + if err != nil { + pr.Close() + t.Fatal(err) + } + + if err := writer.Flush(); err != nil { + pr.Close() + t.Fatal(err) + } + + tlen := outBuf.Len() + pr.Close() + if err := writer.Flush(); err != nil { + t.Fatal(err) + } + + if outBuf.Len() == tlen { + t.Fatalf("Expected some output when closing prematurely") + } +} + +func TestCompleteSilently(t *testing.T) { + var outBuf bytes.Buffer + content := []byte("TESTING") + reader := ioutil.NopCloser(bytes.NewReader(content)) + writer := bufio.NewWriter(&outBuf) + + prCfg := Config{ + In: reader, + Out: writer, + Formatter: streamformatter.NewStreamFormatter(), + Size: int64(len(content)), + NewLines: true, + ID: "Test", + Action: "Read", + } + pr := New(prCfg) + + out, err := ioutil.ReadAll(pr) + if err != nil { + pr.Close() + t.Fatal(err) + } + if string(out) != "TESTING" { + pr.Close() + t.Fatalf("Unexpected output %q from reader", string(out)) + } + + if err := writer.Flush(); err != nil { + pr.Close() + t.Fatal(err) + } + + tlen := outBuf.Len() + pr.Close() + if err := writer.Flush(); err != nil { + t.Fatal(err) + } + + if outBuf.Len() > tlen { + t.Fatalf("Should have closed silently when read is complete") + } +} diff --git a/pkg/promise/promise.go b/pkg/promise/promise.go new file mode 100644 index 0000000000..dd52b9082f --- /dev/null +++ b/pkg/promise/promise.go @@ -0,0 +1,11 @@ +package promise + +// Go is a basic promise implementation: it wraps calls a function in a goroutine, +// and returns a channel which will later return the function's return value. +func Go(f func() error) chan error { + ch := make(chan error, 1) + go func() { + ch <- f() + }() + return ch +} diff --git a/pkg/proxy/network_proxy_test.go b/pkg/proxy/network_proxy_test.go new file mode 100644 index 0000000000..9e382567c5 --- /dev/null +++ b/pkg/proxy/network_proxy_test.go @@ -0,0 +1,216 @@ +package proxy + +import ( + "bytes" + "fmt" + "io" + "net" + "strings" + "testing" + "time" +) + +var testBuf = []byte("Buffalo buffalo Buffalo buffalo buffalo buffalo Buffalo buffalo") +var testBufSize = len(testBuf) + +type EchoServer interface { + Run() + Close() + LocalAddr() net.Addr +} + +type TCPEchoServer struct { + listener net.Listener + testCtx *testing.T +} + +type UDPEchoServer struct { + conn net.PacketConn + testCtx *testing.T +} + +func NewEchoServer(t *testing.T, proto, address string) EchoServer { + var server EchoServer + if strings.HasPrefix(proto, "tcp") { + listener, err := net.Listen(proto, address) + if err != nil { + t.Fatal(err) + } + server = &TCPEchoServer{listener: listener, testCtx: t} + } else { + socket, err := net.ListenPacket(proto, address) + if err != nil { + t.Fatal(err) + } + server = &UDPEchoServer{conn: socket, testCtx: t} + } + return server +} + +func (server *TCPEchoServer) Run() { + go func() { + for { + client, err := server.listener.Accept() + if err != nil { + return + } + go func(client net.Conn) { + if _, err := io.Copy(client, client); err != nil { + server.testCtx.Logf("can't echo to the client: %v\n", err.Error()) + } + client.Close() + }(client) + } + }() +} + +func (server *TCPEchoServer) LocalAddr() net.Addr { return server.listener.Addr() } +func (server *TCPEchoServer) Close() { server.listener.Addr() } + +func (server *UDPEchoServer) Run() { + go func() { + readBuf := make([]byte, 1024) + for { + read, from, err := server.conn.ReadFrom(readBuf) + if err != nil { + return + } + for i := 0; i != read; { + written, err := server.conn.WriteTo(readBuf[i:read], from) + if err != nil { + break + } + i += written + } + } + }() +} + +func (server *UDPEchoServer) LocalAddr() net.Addr { return server.conn.LocalAddr() } +func (server *UDPEchoServer) Close() { server.conn.Close() } + +func testProxyAt(t *testing.T, proto string, proxy Proxy, addr string) { + defer proxy.Close() + go proxy.Run() + client, err := net.Dial(proto, addr) + if err != nil { + t.Fatalf("Can't connect to the proxy: %v", err) + } + defer client.Close() + client.SetDeadline(time.Now().Add(10 * time.Second)) + if _, err = client.Write(testBuf); err != nil { + t.Fatal(err) + } + recvBuf := make([]byte, testBufSize) + if _, err = client.Read(recvBuf); err != nil { + t.Fatal(err) + } + if !bytes.Equal(testBuf, recvBuf) { + t.Fatal(fmt.Errorf("Expected [%v] but got [%v]", testBuf, recvBuf)) + } +} + +func testProxy(t *testing.T, proto string, proxy Proxy) { + testProxyAt(t, proto, proxy, proxy.FrontendAddr().String()) +} + +func TestTCP4Proxy(t *testing.T) { + backend := NewEchoServer(t, "tcp", "127.0.0.1:0") + defer backend.Close() + backend.Run() + frontendAddr := &net.TCPAddr{IP: net.IPv4(127, 0, 0, 1), Port: 0} + proxy, err := NewProxy(frontendAddr, backend.LocalAddr()) + if err != nil { + t.Fatal(err) + } + testProxy(t, "tcp", proxy) +} + +func TestTCP6Proxy(t *testing.T) { + backend := NewEchoServer(t, "tcp", "[::1]:0") + defer backend.Close() + backend.Run() + frontendAddr := &net.TCPAddr{IP: net.IPv6loopback, Port: 0} + proxy, err := NewProxy(frontendAddr, backend.LocalAddr()) + if err != nil { + t.Fatal(err) + } + testProxy(t, "tcp", proxy) +} + +func TestTCPDualStackProxy(t *testing.T) { + // If I understand `godoc -src net favoriteAddrFamily` (used by the + // net.Listen* functions) correctly this should work, but it doesn't. + t.Skip("No support for dual stack yet") + backend := NewEchoServer(t, "tcp", "[::1]:0") + defer backend.Close() + backend.Run() + frontendAddr := &net.TCPAddr{IP: net.IPv6loopback, Port: 0} + proxy, err := NewProxy(frontendAddr, backend.LocalAddr()) + if err != nil { + t.Fatal(err) + } + ipv4ProxyAddr := &net.TCPAddr{ + IP: net.IPv4(127, 0, 0, 1), + Port: proxy.FrontendAddr().(*net.TCPAddr).Port, + } + testProxyAt(t, "tcp", proxy, ipv4ProxyAddr.String()) +} + +func TestUDP4Proxy(t *testing.T) { + backend := NewEchoServer(t, "udp", "127.0.0.1:0") + defer backend.Close() + backend.Run() + frontendAddr := &net.UDPAddr{IP: net.IPv4(127, 0, 0, 1), Port: 0} + proxy, err := NewProxy(frontendAddr, backend.LocalAddr()) + if err != nil { + t.Fatal(err) + } + testProxy(t, "udp", proxy) +} + +func TestUDP6Proxy(t *testing.T) { + backend := NewEchoServer(t, "udp", "[::1]:0") + defer backend.Close() + backend.Run() + frontendAddr := &net.UDPAddr{IP: net.IPv6loopback, Port: 0} + proxy, err := NewProxy(frontendAddr, backend.LocalAddr()) + if err != nil { + t.Fatal(err) + } + testProxy(t, "udp", proxy) +} + +func TestUDPWriteError(t *testing.T) { + frontendAddr := &net.UDPAddr{IP: net.IPv4(127, 0, 0, 1), Port: 0} + // Hopefully, this port will be free: */ + backendAddr := &net.UDPAddr{IP: net.IPv4(127, 0, 0, 1), Port: 25587} + proxy, err := NewProxy(frontendAddr, backendAddr) + if err != nil { + t.Fatal(err) + } + defer proxy.Close() + go proxy.Run() + client, err := net.Dial("udp", "127.0.0.1:25587") + if err != nil { + t.Fatalf("Can't connect to the proxy: %v", err) + } + defer client.Close() + // Make sure the proxy doesn't stop when there is no actual backend: + client.Write(testBuf) + client.Write(testBuf) + backend := NewEchoServer(t, "udp", "127.0.0.1:25587") + defer backend.Close() + backend.Run() + client.SetDeadline(time.Now().Add(10 * time.Second)) + if _, err = client.Write(testBuf); err != nil { + t.Fatal(err) + } + recvBuf := make([]byte, testBufSize) + if _, err = client.Read(recvBuf); err != nil { + t.Fatal(err) + } + if !bytes.Equal(testBuf, recvBuf) { + t.Fatal(fmt.Errorf("Expected [%v] but got [%v]", testBuf, recvBuf)) + } +} diff --git a/pkg/proxy/proxy.go b/pkg/proxy/proxy.go new file mode 100644 index 0000000000..4e24e5f6a8 --- /dev/null +++ b/pkg/proxy/proxy.go @@ -0,0 +1,37 @@ +// Package proxy provides a network Proxy interface and implementations for TCP +// and UDP. +package proxy + +import ( + "fmt" + "net" +) + +// Proxy defines the behavior of a proxy. It forwards traffic back and forth +// between two endpoints : the frontend and the backend. +// It can be used to do software port-mapping between two addresses. +// e.g. forward all traffic between the frontend (host) 127.0.0.1:3000 +// to the backend (container) at 172.17.42.108:4000. +type Proxy interface { + // Run starts forwarding traffic back and forth between the front + // and back-end addresses. + Run() + // Close stops forwarding traffic and close both ends of the Proxy. + Close() + // FrontendAddr returns the address on which the proxy is listening. + FrontendAddr() net.Addr + // BackendAddr returns the proxied address. + BackendAddr() net.Addr +} + +// NewProxy creates a Proxy according to the specified frontendAddr and backendAddr. +func NewProxy(frontendAddr, backendAddr net.Addr) (Proxy, error) { + switch frontendAddr.(type) { + case *net.UDPAddr: + return NewUDPProxy(frontendAddr.(*net.UDPAddr), backendAddr.(*net.UDPAddr)) + case *net.TCPAddr: + return NewTCPProxy(frontendAddr.(*net.TCPAddr), backendAddr.(*net.TCPAddr)) + default: + panic(fmt.Errorf("Unsupported protocol")) + } +} diff --git a/pkg/proxy/stub_proxy.go b/pkg/proxy/stub_proxy.go new file mode 100644 index 0000000000..571749e467 --- /dev/null +++ b/pkg/proxy/stub_proxy.go @@ -0,0 +1,31 @@ +package proxy + +import ( + "net" +) + +// StubProxy is a proxy that is a stub (does nothing). +type StubProxy struct { + frontendAddr net.Addr + backendAddr net.Addr +} + +// Run does nothing. +func (p *StubProxy) Run() {} + +// Close does nothing. +func (p *StubProxy) Close() {} + +// FrontendAddr returns the frontend address. +func (p *StubProxy) FrontendAddr() net.Addr { return p.frontendAddr } + +// BackendAddr returns the backend address. +func (p *StubProxy) BackendAddr() net.Addr { return p.backendAddr } + +// NewStubProxy creates a new StubProxy +func NewStubProxy(frontendAddr, backendAddr net.Addr) (Proxy, error) { + return &StubProxy{ + frontendAddr: frontendAddr, + backendAddr: backendAddr, + }, nil +} diff --git a/pkg/proxy/tcp_proxy.go b/pkg/proxy/tcp_proxy.go new file mode 100644 index 0000000000..3cd742af76 --- /dev/null +++ b/pkg/proxy/tcp_proxy.go @@ -0,0 +1,99 @@ +package proxy + +import ( + "io" + "net" + "syscall" + + "github.com/Sirupsen/logrus" +) + +// TCPProxy is a proxy for TCP connections. It implements the Proxy interface to +// handle TCP traffic forwarding between the frontend and backend addresses. +type TCPProxy struct { + listener *net.TCPListener + frontendAddr *net.TCPAddr + backendAddr *net.TCPAddr +} + +// NewTCPProxy creates a new TCPProxy. +func NewTCPProxy(frontendAddr, backendAddr *net.TCPAddr) (*TCPProxy, error) { + listener, err := net.ListenTCP("tcp", frontendAddr) + if err != nil { + return nil, err + } + // If the port in frontendAddr was 0 then ListenTCP will have a picked + // a port to listen on, hence the call to Addr to get that actual port: + return &TCPProxy{ + listener: listener, + frontendAddr: listener.Addr().(*net.TCPAddr), + backendAddr: backendAddr, + }, nil +} + +func (proxy *TCPProxy) clientLoop(client *net.TCPConn, quit chan bool) { + backend, err := net.DialTCP("tcp", nil, proxy.backendAddr) + if err != nil { + logrus.Printf("Can't forward traffic to backend tcp/%v: %s\n", proxy.backendAddr, err) + client.Close() + return + } + + event := make(chan int64) + var broker = func(to, from *net.TCPConn) { + written, err := io.Copy(to, from) + if err != nil { + // If the socket we are writing to is shutdown with + // SHUT_WR, forward it to the other end of the pipe: + if err, ok := err.(*net.OpError); ok && err.Err == syscall.EPIPE { + from.CloseWrite() + } + } + to.CloseRead() + event <- written + } + + go broker(client, backend) + go broker(backend, client) + + var transferred int64 + for i := 0; i < 2; i++ { + select { + case written := <-event: + transferred += written + case <-quit: + // Interrupt the two brokers and "join" them. + client.Close() + backend.Close() + for ; i < 2; i++ { + transferred += <-event + } + return + } + } + client.Close() + backend.Close() +} + +// Run starts forwarding the traffic using TCP. +func (proxy *TCPProxy) Run() { + quit := make(chan bool) + defer close(quit) + for { + client, err := proxy.listener.Accept() + if err != nil { + logrus.Printf("Stopping proxy on tcp/%v for tcp/%v (%s)", proxy.frontendAddr, proxy.backendAddr, err) + return + } + go proxy.clientLoop(client.(*net.TCPConn), quit) + } +} + +// Close stops forwarding the traffic. +func (proxy *TCPProxy) Close() { proxy.listener.Close() } + +// FrontendAddr returns the TCP address on which the proxy is listening. +func (proxy *TCPProxy) FrontendAddr() net.Addr { return proxy.frontendAddr } + +// BackendAddr returns the TCP proxied address. +func (proxy *TCPProxy) BackendAddr() net.Addr { return proxy.backendAddr } diff --git a/pkg/proxy/udp_proxy.go b/pkg/proxy/udp_proxy.go new file mode 100644 index 0000000000..b8375c374f --- /dev/null +++ b/pkg/proxy/udp_proxy.go @@ -0,0 +1,169 @@ +package proxy + +import ( + "encoding/binary" + "net" + "strings" + "sync" + "syscall" + "time" + + "github.com/Sirupsen/logrus" +) + +const ( + // UDPConnTrackTimeout is the timeout used for UDP connection tracking + UDPConnTrackTimeout = 90 * time.Second + // UDPBufSize is the buffer size for the UDP proxy + UDPBufSize = 65507 +) + +// A net.Addr where the IP is split into two fields so you can use it as a key +// in a map: +type connTrackKey struct { + IPHigh uint64 + IPLow uint64 + Port int +} + +func newConnTrackKey(addr *net.UDPAddr) *connTrackKey { + if len(addr.IP) == net.IPv4len { + return &connTrackKey{ + IPHigh: 0, + IPLow: uint64(binary.BigEndian.Uint32(addr.IP)), + Port: addr.Port, + } + } + return &connTrackKey{ + IPHigh: binary.BigEndian.Uint64(addr.IP[:8]), + IPLow: binary.BigEndian.Uint64(addr.IP[8:]), + Port: addr.Port, + } +} + +type connTrackMap map[connTrackKey]*net.UDPConn + +// UDPProxy is proxy for which handles UDP datagrams. It implements the Proxy +// interface to handle UDP traffic forwarding between the frontend and backend +// addresses. +type UDPProxy struct { + listener *net.UDPConn + frontendAddr *net.UDPAddr + backendAddr *net.UDPAddr + connTrackTable connTrackMap + connTrackLock sync.Mutex +} + +// NewUDPProxy creates a new UDPProxy. +func NewUDPProxy(frontendAddr, backendAddr *net.UDPAddr) (*UDPProxy, error) { + listener, err := net.ListenUDP("udp", frontendAddr) + if err != nil { + return nil, err + } + return &UDPProxy{ + listener: listener, + frontendAddr: listener.LocalAddr().(*net.UDPAddr), + backendAddr: backendAddr, + connTrackTable: make(connTrackMap), + }, nil +} + +func (proxy *UDPProxy) replyLoop(proxyConn *net.UDPConn, clientAddr *net.UDPAddr, clientKey *connTrackKey) { + defer func() { + proxy.connTrackLock.Lock() + delete(proxy.connTrackTable, *clientKey) + proxy.connTrackLock.Unlock() + proxyConn.Close() + }() + + readBuf := make([]byte, UDPBufSize) + for { + proxyConn.SetReadDeadline(time.Now().Add(UDPConnTrackTimeout)) + again: + read, err := proxyConn.Read(readBuf) + if err != nil { + if err, ok := err.(*net.OpError); ok && err.Err == syscall.ECONNREFUSED { + // This will happen if the last write failed + // (e.g: nothing is actually listening on the + // proxied port on the container), ignore it + // and continue until UDPConnTrackTimeout + // expires: + goto again + } + return + } + for i := 0; i != read; { + written, err := proxy.listener.WriteToUDP(readBuf[i:read], clientAddr) + if err != nil { + return + } + i += written + } + } +} + +// Run starts forwarding the traffic using UDP. +func (proxy *UDPProxy) Run() { + readBuf := make([]byte, UDPBufSize) + for { + read, from, err := proxy.listener.ReadFromUDP(readBuf) + if err != nil { + // NOTE: Apparently ReadFrom doesn't return + // ECONNREFUSED like Read do (see comment in + // UDPProxy.replyLoop) + if !isClosedError(err) { + logrus.Printf("Stopping proxy on udp/%v for udp/%v (%s)", proxy.frontendAddr, proxy.backendAddr, err) + } + break + } + + fromKey := newConnTrackKey(from) + proxy.connTrackLock.Lock() + proxyConn, hit := proxy.connTrackTable[*fromKey] + if !hit { + proxyConn, err = net.DialUDP("udp", nil, proxy.backendAddr) + if err != nil { + logrus.Printf("Can't proxy a datagram to udp/%s: %s\n", proxy.backendAddr, err) + proxy.connTrackLock.Unlock() + continue + } + proxy.connTrackTable[*fromKey] = proxyConn + go proxy.replyLoop(proxyConn, from, fromKey) + } + proxy.connTrackLock.Unlock() + for i := 0; i != read; { + written, err := proxyConn.Write(readBuf[i:read]) + if err != nil { + logrus.Printf("Can't proxy a datagram to udp/%s: %s\n", proxy.backendAddr, err) + break + } + i += written + } + } +} + +// Close stops forwarding the traffic. +func (proxy *UDPProxy) Close() { + proxy.listener.Close() + proxy.connTrackLock.Lock() + defer proxy.connTrackLock.Unlock() + for _, conn := range proxy.connTrackTable { + conn.Close() + } +} + +// FrontendAddr returns the UDP address on which the proxy is listening. +func (proxy *UDPProxy) FrontendAddr() net.Addr { return proxy.frontendAddr } + +// BackendAddr returns the proxied UDP address. +func (proxy *UDPProxy) BackendAddr() net.Addr { return proxy.backendAddr } + +func isClosedError(err error) bool { + /* This comparison is ugly, but unfortunately, net.go doesn't export errClosing. + * See: + * http://golang.org/src/pkg/net/net.go + * https://code.google.com/p/go/issues/detail?id=4337 + * https://groups.google.com/forum/#!msg/golang-nuts/0_aaCvBmOcM/SptmDyX1XJMJ + */ + return strings.HasSuffix(err.Error(), "use of closed network connection") +} diff --git a/pkg/pubsub/publisher.go b/pkg/pubsub/publisher.go new file mode 100644 index 0000000000..ab457cfba9 --- /dev/null +++ b/pkg/pubsub/publisher.go @@ -0,0 +1,84 @@ +package pubsub + +import ( + "sync" + "time" +) + +// NewPublisher creates a new pub/sub publisher to broadcast messages. +// The duration is used as the send timeout as to not block the publisher publishing +// messages to other clients if one client is slow or unresponsive. +// The buffer is used when creating new channels for subscribers. +func NewPublisher(publishTimeout time.Duration, buffer int) *Publisher { + return &Publisher{ + buffer: buffer, + timeout: publishTimeout, + subscribers: make(map[subscriber]struct{}), + } +} + +type subscriber chan interface{} + +// Publisher is basic pub/sub structure. Allows to send events and subscribe +// to them. Can be safely used from multiple goroutines. +type Publisher struct { + m sync.RWMutex + buffer int + timeout time.Duration + subscribers map[subscriber]struct{} +} + +// Len returns the number of subscribers for the publisher +func (p *Publisher) Len() int { + p.m.RLock() + i := len(p.subscribers) + p.m.RUnlock() + return i +} + +// Subscribe adds a new subscriber to the publisher returning the channel. +func (p *Publisher) Subscribe() chan interface{} { + ch := make(chan interface{}, p.buffer) + p.m.Lock() + p.subscribers[ch] = struct{}{} + p.m.Unlock() + return ch +} + +// Evict removes the specified subscriber from receiving any more messages. +func (p *Publisher) Evict(sub chan interface{}) { + p.m.Lock() + delete(p.subscribers, sub) + close(sub) + p.m.Unlock() +} + +// Publish sends the data in v to all subscribers currently registered with the publisher. +func (p *Publisher) Publish(v interface{}) { + p.m.RLock() + for sub := range p.subscribers { + // send under a select as to not block if the receiver is unavailable + if p.timeout > 0 { + select { + case sub <- v: + case <-time.After(p.timeout): + } + continue + } + select { + case sub <- v: + default: + } + } + p.m.RUnlock() +} + +// Close closes the channels to all subscribers registered with the publisher. +func (p *Publisher) Close() { + p.m.Lock() + for sub := range p.subscribers { + delete(p.subscribers, sub) + close(sub) + } + p.m.Unlock() +} diff --git a/pkg/pubsub/publisher_test.go b/pkg/pubsub/publisher_test.go new file mode 100644 index 0000000000..d6b0a1d59a --- /dev/null +++ b/pkg/pubsub/publisher_test.go @@ -0,0 +1,142 @@ +package pubsub + +import ( + "fmt" + "testing" + "time" +) + +func TestSendToOneSub(t *testing.T) { + p := NewPublisher(100*time.Millisecond, 10) + c := p.Subscribe() + + p.Publish("hi") + + msg := <-c + if msg.(string) != "hi" { + t.Fatalf("expected message hi but received %v", msg) + } +} + +func TestSendToMultipleSubs(t *testing.T) { + p := NewPublisher(100*time.Millisecond, 10) + subs := []chan interface{}{} + subs = append(subs, p.Subscribe(), p.Subscribe(), p.Subscribe()) + + p.Publish("hi") + + for _, c := range subs { + msg := <-c + if msg.(string) != "hi" { + t.Fatalf("expected message hi but received %v", msg) + } + } +} + +func TestEvictOneSub(t *testing.T) { + p := NewPublisher(100*time.Millisecond, 10) + s1 := p.Subscribe() + s2 := p.Subscribe() + + p.Evict(s1) + p.Publish("hi") + if _, ok := <-s1; ok { + t.Fatal("expected s1 to not receive the published message") + } + + msg := <-s2 + if msg.(string) != "hi" { + t.Fatalf("expected message hi but received %v", msg) + } +} + +func TestClosePublisher(t *testing.T) { + p := NewPublisher(100*time.Millisecond, 10) + subs := []chan interface{}{} + subs = append(subs, p.Subscribe(), p.Subscribe(), p.Subscribe()) + p.Close() + + for _, c := range subs { + if _, ok := <-c; ok { + t.Fatal("expected all subscriber channels to be closed") + } + } +} + +const sampleText = "test" + +type testSubscriber struct { + dataCh chan interface{} + ch chan error +} + +func (s *testSubscriber) Wait() error { + return <-s.ch +} + +func newTestSubscriber(p *Publisher) *testSubscriber { + ts := &testSubscriber{ + dataCh: p.Subscribe(), + ch: make(chan error), + } + go func() { + for data := range ts.dataCh { + s, ok := data.(string) + if !ok { + ts.ch <- fmt.Errorf("Unexpected type %T", data) + break + } + if s != sampleText { + ts.ch <- fmt.Errorf("Unexpected text %s", s) + break + } + } + close(ts.ch) + }() + return ts +} + +// for testing with -race +func TestPubSubRace(t *testing.T) { + p := NewPublisher(0, 1024) + var subs [](*testSubscriber) + for j := 0; j < 50; j++ { + subs = append(subs, newTestSubscriber(p)) + } + for j := 0; j < 1000; j++ { + p.Publish(sampleText) + } + time.AfterFunc(1*time.Second, func() { + for _, s := range subs { + p.Evict(s.dataCh) + } + }) + for _, s := range subs { + s.Wait() + } +} + +func BenchmarkPubSub(b *testing.B) { + for i := 0; i < b.N; i++ { + b.StopTimer() + p := NewPublisher(0, 1024) + var subs [](*testSubscriber) + for j := 0; j < 50; j++ { + subs = append(subs, newTestSubscriber(p)) + } + b.StartTimer() + for j := 0; j < 1000; j++ { + p.Publish(sampleText) + } + time.AfterFunc(1*time.Second, func() { + for _, s := range subs { + p.Evict(s.dataCh) + } + }) + for _, s := range subs { + if err := s.Wait(); err != nil { + b.Fatal(err) + } + } + } +} diff --git a/pkg/random/random.go b/pkg/random/random.go new file mode 100644 index 0000000000..e560aff111 --- /dev/null +++ b/pkg/random/random.go @@ -0,0 +1,71 @@ +package random + +import ( + cryptorand "crypto/rand" + "io" + "math" + "math/big" + "math/rand" + "sync" + "time" +) + +// Rand is a global *rand.Rand instance, which initilized with NewSource() source. +var Rand = rand.New(NewSource()) + +// Reader is a global, shared instance of a pseudorandom bytes generator. +// It doesn't consume entropy. +var Reader io.Reader = &reader{rnd: Rand} + +// copypaste from standard math/rand +type lockedSource struct { + lk sync.Mutex + src rand.Source +} + +func (r *lockedSource) Int63() (n int64) { + r.lk.Lock() + n = r.src.Int63() + r.lk.Unlock() + return +} + +func (r *lockedSource) Seed(seed int64) { + r.lk.Lock() + r.src.Seed(seed) + r.lk.Unlock() +} + +// NewSource returns math/rand.Source safe for concurrent use and initialized +// with current unix-nano timestamp +func NewSource() rand.Source { + var seed int64 + if cryptoseed, err := cryptorand.Int(cryptorand.Reader, big.NewInt(math.MaxInt64)); err != nil { + // This should not happen, but worst-case fallback to time-based seed. + seed = time.Now().UnixNano() + } else { + seed = cryptoseed.Int64() + } + return &lockedSource{ + src: rand.NewSource(seed), + } +} + +type reader struct { + rnd *rand.Rand +} + +func (r *reader) Read(b []byte) (int, error) { + i := 0 + for { + val := r.rnd.Int63() + for val > 0 { + b[i] = byte(val) + i++ + if i == len(b) { + return i, nil + } + val >>= 8 + } + } +} diff --git a/pkg/random/random_test.go b/pkg/random/random_test.go new file mode 100644 index 0000000000..cf405f78cb --- /dev/null +++ b/pkg/random/random_test.go @@ -0,0 +1,22 @@ +package random + +import ( + "math/rand" + "sync" + "testing" +) + +// for go test -v -race +func TestConcurrency(t *testing.T) { + rnd := rand.New(NewSource()) + var wg sync.WaitGroup + + for i := 0; i < 10; i++ { + wg.Add(1) + go func() { + rnd.Int63() + wg.Done() + }() + } + wg.Wait() +} diff --git a/pkg/reexec/README.md b/pkg/reexec/README.md new file mode 100644 index 0000000000..45592ce85a --- /dev/null +++ b/pkg/reexec/README.md @@ -0,0 +1,5 @@ +## reexec + +The `reexec` package facilitates the busybox style reexec of the docker binary that we require because +of the forking limitations of using Go. Handlers can be registered with a name and the argv 0 of +the exec of the binary will be used to find and execute custom init paths. diff --git a/pkg/reexec/command_freebsd.go b/pkg/reexec/command_freebsd.go new file mode 100644 index 0000000000..c7f797a5fa --- /dev/null +++ b/pkg/reexec/command_freebsd.go @@ -0,0 +1,23 @@ +// +build freebsd + +package reexec + +import ( + "os/exec" +) + +// Self returns the path to the current process's binary. +// Uses os.Args[0]. +func Self() string { + return naiveSelf() +} + +// Command returns *exec.Cmd which have Path as current binary. +// For example if current binary is "docker" at "/usr/bin/", then cmd.Path will +// be set to "/usr/bin/docker". +func Command(args ...string) *exec.Cmd { + return &exec.Cmd{ + Path: Self(), + Args: args, + } +} diff --git a/pkg/reexec/command_linux.go b/pkg/reexec/command_linux.go new file mode 100644 index 0000000000..3c3a73a9d5 --- /dev/null +++ b/pkg/reexec/command_linux.go @@ -0,0 +1,28 @@ +// +build linux + +package reexec + +import ( + "os/exec" + "syscall" +) + +// Self returns the path to the current process's binary. +// Returns "/proc/self/exe". +func Self() string { + return "/proc/self/exe" +} + +// Command returns *exec.Cmd which have Path as current binary. Also it setting +// SysProcAttr.Pdeathsig to SIGTERM. +// This will use the in-memory version (/proc/self/exe) of the current binary, +// it is thus safe to delete or replace the on-disk binary (os.Args[0]). +func Command(args ...string) *exec.Cmd { + return &exec.Cmd{ + Path: Self(), + Args: args, + SysProcAttr: &syscall.SysProcAttr{ + Pdeathsig: syscall.SIGTERM, + }, + } +} diff --git a/pkg/reexec/command_unsupported.go b/pkg/reexec/command_unsupported.go new file mode 100644 index 0000000000..ad4ea38ebb --- /dev/null +++ b/pkg/reexec/command_unsupported.go @@ -0,0 +1,12 @@ +// +build !linux,!windows,!freebsd + +package reexec + +import ( + "os/exec" +) + +// Command is unsupported on operating systems apart from Linux and Windows. +func Command(args ...string) *exec.Cmd { + return nil +} diff --git a/pkg/reexec/command_windows.go b/pkg/reexec/command_windows.go new file mode 100644 index 0000000000..8d65e0ae1a --- /dev/null +++ b/pkg/reexec/command_windows.go @@ -0,0 +1,23 @@ +// +build windows + +package reexec + +import ( + "os/exec" +) + +// Self returns the path to the current process's binary. +// Uses os.Args[0]. +func Self() string { + return naiveSelf() +} + +// Command returns *exec.Cmd which have Path as current binary. +// For example if current binary is "docker.exe" at "C:\", then cmd.Path will +// be set to "C:\docker.exe". +func Command(args ...string) *exec.Cmd { + return &exec.Cmd{ + Path: Self(), + Args: args, + } +} diff --git a/pkg/reexec/reexec.go b/pkg/reexec/reexec.go new file mode 100644 index 0000000000..20491e05d6 --- /dev/null +++ b/pkg/reexec/reexec.go @@ -0,0 +1,47 @@ +package reexec + +import ( + "fmt" + "os" + "os/exec" + "path/filepath" +) + +var registeredInitializers = make(map[string]func()) + +// Register adds an initialization func under the specified name +func Register(name string, initializer func()) { + if _, exists := registeredInitializers[name]; exists { + panic(fmt.Sprintf("reexec func already registred under name %q", name)) + } + + registeredInitializers[name] = initializer +} + +// Init is called as the first part of the exec process and returns true if an +// initialization function was called. +func Init() bool { + initializer, exists := registeredInitializers[os.Args[0]] + if exists { + initializer() + + return true + } + return false +} + +func naiveSelf() string { + name := os.Args[0] + if filepath.Base(name) == name { + if lp, err := exec.LookPath(name); err == nil { + return lp + } + } + // handle conversion of relative paths to absolute + if absName, err := filepath.Abs(name); err == nil { + return absName + } + // if we coudn't get absolute name, return original + // (NOTE: Go only errors on Abs() if os.Getwd fails) + return name +} diff --git a/pkg/signal/README.md b/pkg/signal/README.md new file mode 100644 index 0000000000..2b237a5942 --- /dev/null +++ b/pkg/signal/README.md @@ -0,0 +1 @@ +This package provides helper functions for dealing with signals across various operating systems \ No newline at end of file diff --git a/pkg/signal/signal.go b/pkg/signal/signal.go new file mode 100644 index 0000000000..106fe20d74 --- /dev/null +++ b/pkg/signal/signal.go @@ -0,0 +1,44 @@ +// Package signal provides helper functions for dealing with signals across +// various operating systems. +package signal + +import ( + "fmt" + "os" + "os/signal" + "strconv" + "strings" + "syscall" +) + +// CatchAll catches all signals and relays them to the specified channel. +func CatchAll(sigc chan os.Signal) { + handledSigs := []os.Signal{} + for _, s := range SignalMap { + handledSigs = append(handledSigs, s) + } + signal.Notify(sigc, handledSigs...) +} + +// StopCatch stops catching the signals and closes the specified channel. +func StopCatch(sigc chan os.Signal) { + signal.Stop(sigc) + close(sigc) +} + +// ParseSignal translates a string to a valid syscall signal. +// It returns an error if the signal map doesn't include the given signal. +func ParseSignal(rawSignal string) (syscall.Signal, error) { + s, err := strconv.Atoi(rawSignal) + if err == nil { + if s == 0 { + return -1, fmt.Errorf("Invalid signal: %s", rawSignal) + } + return syscall.Signal(s), nil + } + signal, ok := SignalMap[strings.TrimPrefix(strings.ToUpper(rawSignal), "SIG")] + if !ok { + return -1, fmt.Errorf("Invalid signal: %s", rawSignal) + } + return signal, nil +} diff --git a/pkg/signal/signal_darwin.go b/pkg/signal/signal_darwin.go new file mode 100644 index 0000000000..946de87e94 --- /dev/null +++ b/pkg/signal/signal_darwin.go @@ -0,0 +1,41 @@ +package signal + +import ( + "syscall" +) + +// SignalMap is a map of Darwin signals. +var SignalMap = map[string]syscall.Signal{ + "ABRT": syscall.SIGABRT, + "ALRM": syscall.SIGALRM, + "BUG": syscall.SIGBUS, + "CHLD": syscall.SIGCHLD, + "CONT": syscall.SIGCONT, + "EMT": syscall.SIGEMT, + "FPE": syscall.SIGFPE, + "HUP": syscall.SIGHUP, + "ILL": syscall.SIGILL, + "INFO": syscall.SIGINFO, + "INT": syscall.SIGINT, + "IO": syscall.SIGIO, + "IOT": syscall.SIGIOT, + "KILL": syscall.SIGKILL, + "PIPE": syscall.SIGPIPE, + "PROF": syscall.SIGPROF, + "QUIT": syscall.SIGQUIT, + "SEGV": syscall.SIGSEGV, + "STOP": syscall.SIGSTOP, + "SYS": syscall.SIGSYS, + "TERM": syscall.SIGTERM, + "TRAP": syscall.SIGTRAP, + "TSTP": syscall.SIGTSTP, + "TTIN": syscall.SIGTTIN, + "TTOU": syscall.SIGTTOU, + "URG": syscall.SIGURG, + "USR1": syscall.SIGUSR1, + "USR2": syscall.SIGUSR2, + "VTALRM": syscall.SIGVTALRM, + "WINCH": syscall.SIGWINCH, + "XCPU": syscall.SIGXCPU, + "XFSZ": syscall.SIGXFSZ, +} diff --git a/pkg/signal/signal_freebsd.go b/pkg/signal/signal_freebsd.go new file mode 100644 index 0000000000..6b9569bb75 --- /dev/null +++ b/pkg/signal/signal_freebsd.go @@ -0,0 +1,43 @@ +package signal + +import ( + "syscall" +) + +// SignalMap is a map of FreeBSD signals. +var SignalMap = map[string]syscall.Signal{ + "ABRT": syscall.SIGABRT, + "ALRM": syscall.SIGALRM, + "BUF": syscall.SIGBUS, + "CHLD": syscall.SIGCHLD, + "CONT": syscall.SIGCONT, + "EMT": syscall.SIGEMT, + "FPE": syscall.SIGFPE, + "HUP": syscall.SIGHUP, + "ILL": syscall.SIGILL, + "INFO": syscall.SIGINFO, + "INT": syscall.SIGINT, + "IO": syscall.SIGIO, + "IOT": syscall.SIGIOT, + "KILL": syscall.SIGKILL, + "LWP": syscall.SIGLWP, + "PIPE": syscall.SIGPIPE, + "PROF": syscall.SIGPROF, + "QUIT": syscall.SIGQUIT, + "SEGV": syscall.SIGSEGV, + "STOP": syscall.SIGSTOP, + "SYS": syscall.SIGSYS, + "TERM": syscall.SIGTERM, + "THR": syscall.SIGTHR, + "TRAP": syscall.SIGTRAP, + "TSTP": syscall.SIGTSTP, + "TTIN": syscall.SIGTTIN, + "TTOU": syscall.SIGTTOU, + "URG": syscall.SIGURG, + "USR1": syscall.SIGUSR1, + "USR2": syscall.SIGUSR2, + "VTALRM": syscall.SIGVTALRM, + "WINCH": syscall.SIGWINCH, + "XCPU": syscall.SIGXCPU, + "XFSZ": syscall.SIGXFSZ, +} diff --git a/pkg/signal/signal_linux.go b/pkg/signal/signal_linux.go new file mode 100644 index 0000000000..1ecc3294ff --- /dev/null +++ b/pkg/signal/signal_linux.go @@ -0,0 +1,44 @@ +package signal + +import ( + "syscall" +) + +// SignalMap is a map of Linux signals. +var SignalMap = map[string]syscall.Signal{ + "ABRT": syscall.SIGABRT, + "ALRM": syscall.SIGALRM, + "BUS": syscall.SIGBUS, + "CHLD": syscall.SIGCHLD, + "CLD": syscall.SIGCLD, + "CONT": syscall.SIGCONT, + "FPE": syscall.SIGFPE, + "HUP": syscall.SIGHUP, + "ILL": syscall.SIGILL, + "INT": syscall.SIGINT, + "IO": syscall.SIGIO, + "IOT": syscall.SIGIOT, + "KILL": syscall.SIGKILL, + "PIPE": syscall.SIGPIPE, + "POLL": syscall.SIGPOLL, + "PROF": syscall.SIGPROF, + "PWR": syscall.SIGPWR, + "QUIT": syscall.SIGQUIT, + "SEGV": syscall.SIGSEGV, + "STKFLT": syscall.SIGSTKFLT, + "STOP": syscall.SIGSTOP, + "SYS": syscall.SIGSYS, + "TERM": syscall.SIGTERM, + "TRAP": syscall.SIGTRAP, + "TSTP": syscall.SIGTSTP, + "TTIN": syscall.SIGTTIN, + "TTOU": syscall.SIGTTOU, + "UNUSED": syscall.SIGUNUSED, + "URG": syscall.SIGURG, + "USR1": syscall.SIGUSR1, + "USR2": syscall.SIGUSR2, + "VTALRM": syscall.SIGVTALRM, + "WINCH": syscall.SIGWINCH, + "XCPU": syscall.SIGXCPU, + "XFSZ": syscall.SIGXFSZ, +} diff --git a/pkg/signal/signal_unix.go b/pkg/signal/signal_unix.go new file mode 100644 index 0000000000..d4fea931d1 --- /dev/null +++ b/pkg/signal/signal_unix.go @@ -0,0 +1,19 @@ +// +build !windows + +package signal + +import ( + "syscall" +) + +// Signals used in api/client (no windows equivalent, use +// invalid signals so they don't get handled) + +const ( + // SIGCHLD is a signal sent to a process when a child process terminates, is interrupted, or resumes after being interrupted. + SIGCHLD = syscall.SIGCHLD + // SIGWINCH is a signal sent to a process when its controlling terminal changes its size + SIGWINCH = syscall.SIGWINCH + // DefaultStopSignal is the syscall signal used to stop a container in unix systems. + DefaultStopSignal = "SIGTERM" +) diff --git a/pkg/signal/signal_unsupported.go b/pkg/signal/signal_unsupported.go new file mode 100644 index 0000000000..161ba27397 --- /dev/null +++ b/pkg/signal/signal_unsupported.go @@ -0,0 +1,10 @@ +// +build !linux,!darwin,!freebsd,!windows + +package signal + +import ( + "syscall" +) + +// SignalMap is an empty map of signals for unsupported platform. +var SignalMap = map[string]syscall.Signal{} diff --git a/pkg/signal/signal_windows.go b/pkg/signal/signal_windows.go new file mode 100644 index 0000000000..c80a951c50 --- /dev/null +++ b/pkg/signal/signal_windows.go @@ -0,0 +1,27 @@ +// +build windows + +package signal + +import ( + "syscall" +) + +// Signals used in api/client (no windows equivalent, use +// invalid signals so they don't get handled) +const ( + SIGCHLD = syscall.Signal(0xff) + SIGWINCH = syscall.Signal(0xff) + // DefaultStopSignal is the syscall signal used to stop a container in windows systems. + DefaultStopSignal = "15" +) + +// SignalMap is a map of "supported" signals. As per the comment in GOLang's +// ztypes_windows.go: "More invented values for signals". Windows doesn't +// really support signals in any way, shape or form that Unix does. +// +// We have these so that docker kill can be used to gracefully (TERM) and +// forcibly (KILL) terminate a container on Windows. +var SignalMap = map[string]syscall.Signal{ + "KILL": syscall.SIGKILL, + "TERM": syscall.SIGTERM, +} diff --git a/pkg/signal/trap.go b/pkg/signal/trap.go new file mode 100644 index 0000000000..2cf5ccf0d2 --- /dev/null +++ b/pkg/signal/trap.go @@ -0,0 +1,74 @@ +package signal + +import ( + "os" + gosignal "os/signal" + "runtime" + "sync/atomic" + "syscall" + + "github.com/Sirupsen/logrus" +) + +// Trap sets up a simplified signal "trap", appropriate for common +// behavior expected from a vanilla unix command-line tool in general +// (and the Docker engine in particular). +// +// * If SIGINT or SIGTERM are received, `cleanup` is called, then the process is terminated. +// * If SIGINT or SIGTERM are received 3 times before cleanup is complete, then cleanup is +// skipped and the process is terminated immediately (allows force quit of stuck daemon) +// * A SIGQUIT always causes an exit without cleanup, with a goroutine dump preceding exit. +// +func Trap(cleanup func()) { + c := make(chan os.Signal, 1) + // we will handle INT, TERM, QUIT here + signals := []os.Signal{os.Interrupt, syscall.SIGTERM, syscall.SIGQUIT} + gosignal.Notify(c, signals...) + go func() { + interruptCount := uint32(0) + for sig := range c { + go func(sig os.Signal) { + logrus.Infof("Processing signal '%v'", sig) + switch sig { + case os.Interrupt, syscall.SIGTERM: + if atomic.LoadUint32(&interruptCount) < 3 { + // Initiate the cleanup only once + if atomic.AddUint32(&interruptCount, 1) == 1 { + // Call the provided cleanup handler + cleanup() + os.Exit(0) + } else { + return + } + } else { + // 3 SIGTERM/INT signals received; force exit without cleanup + logrus.Infof("Forcing docker daemon shutdown without cleanup; 3 interrupts received") + } + case syscall.SIGQUIT: + DumpStacks() + logrus.Infof("Forcing docker daemon shutdown without cleanup on SIGQUIT") + } + //for the SIGINT/TERM, and SIGQUIT non-clean shutdown case, exit with 128 + signal # + os.Exit(128 + int(sig.(syscall.Signal))) + }(sig) + } + }() +} + +// DumpStacks dumps the runtime stack. +func DumpStacks() { + var ( + buf []byte + stackSize int + ) + bufferLen := 16384 + for stackSize == len(buf) { + buf = make([]byte, bufferLen) + stackSize = runtime.Stack(buf, true) + bufferLen *= 2 + } + buf = buf[:stackSize] + // Note that if the daemon is started with a less-verbose log-level than "info" (the default), the goroutine + // traces won't show up in the log. + logrus.Infof("=== BEGIN goroutine stack dump ===\n%s\n=== END goroutine stack dump ===", buf) +} diff --git a/pkg/sockets/README.md b/pkg/sockets/README.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/pkg/sockets/tcp_socket.go b/pkg/sockets/tcp_socket.go new file mode 100644 index 0000000000..9f8319dc33 --- /dev/null +++ b/pkg/sockets/tcp_socket.go @@ -0,0 +1,48 @@ +// Package sockets provides helper functions to create and configure Unix or TCP +// sockets. +package sockets + +import ( + "crypto/tls" + "net" + "net/http" + "time" + + "github.com/docker/docker/pkg/listenbuffer" +) + +// NewTCPSocket creates a TCP socket listener with the specified address and +// and the specified tls configuration. If TLSConfig is set, will encapsulate the +// TCP listener inside a TLS one. +// The channel passed is used to activate the listenbuffer when the caller is ready +// to accept connections. +func NewTCPSocket(addr string, tlsConfig *tls.Config, activate <-chan struct{}) (net.Listener, error) { + l, err := listenbuffer.NewListenBuffer("tcp", addr, activate) + if err != nil { + return nil, err + } + if tlsConfig != nil { + tlsConfig.NextProtos = []string{"http/1.1"} + l = tls.NewListener(l, tlsConfig) + } + return l, nil +} + +// ConfigureTCPTransport configures the specified Transport according to the +// specified proto and addr. +// If the proto is unix (using a unix socket to communicate) the compression +// is disabled. +func ConfigureTCPTransport(tr *http.Transport, proto, addr string) { + // Why 32? See https://github.com/docker/docker/pull/8035. + timeout := 32 * time.Second + if proto == "unix" { + // No need for compression in local communications. + tr.DisableCompression = true + tr.Dial = func(_, _ string) (net.Conn, error) { + return net.DialTimeout(proto, addr, timeout) + } + } else { + tr.Proxy = http.ProxyFromEnvironment + tr.Dial = (&net.Dialer{Timeout: timeout}).Dial + } +} diff --git a/pkg/sockets/unix_socket.go b/pkg/sockets/unix_socket.go new file mode 100644 index 0000000000..a69c28b041 --- /dev/null +++ b/pkg/sockets/unix_socket.go @@ -0,0 +1,83 @@ +// +build linux freebsd + +package sockets + +import ( + "fmt" + "net" + "os" + "strconv" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/listenbuffer" + "github.com/opencontainers/runc/libcontainer/user" +) + +// NewUnixSocket creates a unix socket with the specified path and group. +// The channel passed is used to activate the listenbuffer when the caller is ready +// to accept connections. +func NewUnixSocket(path, group string, activate <-chan struct{}) (net.Listener, error) { + if err := syscall.Unlink(path); err != nil && !os.IsNotExist(err) { + return nil, err + } + mask := syscall.Umask(0777) + defer syscall.Umask(mask) + l, err := listenbuffer.NewListenBuffer("unix", path, activate) + if err != nil { + return nil, err + } + if err := setSocketGroup(path, group); err != nil { + l.Close() + return nil, err + } + if err := os.Chmod(path, 0660); err != nil { + l.Close() + return nil, err + } + return l, nil +} + +func setSocketGroup(path, group string) error { + if group == "" { + return nil + } + if err := changeGroup(path, group); err != nil { + if group != "docker" { + return err + } + logrus.Debugf("Warning: could not change group %s to docker: %v", path, err) + } + return nil +} + +func changeGroup(path string, nameOrGid string) error { + gid, err := lookupGidByName(nameOrGid) + if err != nil { + return err + } + logrus.Debugf("%s group found. gid: %d", nameOrGid, gid) + return os.Chown(path, 0, gid) +} + +func lookupGidByName(nameOrGid string) (int, error) { + groupFile, err := user.GetGroupPath() + if err != nil { + return -1, err + } + groups, err := user.ParseGroupFileFilter(groupFile, func(g user.Group) bool { + return g.Name == nameOrGid || strconv.Itoa(g.Gid) == nameOrGid + }) + if err != nil { + return -1, err + } + if groups != nil && len(groups) > 0 { + return groups[0].Gid, nil + } + gid, err := strconv.Atoi(nameOrGid) + if err == nil { + logrus.Warnf("Could not find GID %d", gid) + return gid, nil + } + return -1, fmt.Errorf("Group %s not found", nameOrGid) +} diff --git a/pkg/stdcopy/stdcopy.go b/pkg/stdcopy/stdcopy.go new file mode 100644 index 0000000000..9be01841a9 --- /dev/null +++ b/pkg/stdcopy/stdcopy.go @@ -0,0 +1,175 @@ +package stdcopy + +import ( + "encoding/binary" + "errors" + "io" + + "github.com/Sirupsen/logrus" +) + +const ( + stdWriterPrefixLen = 8 + stdWriterFdIndex = 0 + stdWriterSizeIndex = 4 + + startingBufLen = 32*1024 + stdWriterPrefixLen + 1 +) + +// StdType prefixes type and length to standard stream. +type StdType [stdWriterPrefixLen]byte + +var ( + // Stdin represents standard input stream type. + Stdin = StdType{0: 0} + // Stdout represents standard output stream type. + Stdout = StdType{0: 1} + // Stderr represents standard error steam type. + Stderr = StdType{0: 2} +) + +// StdWriter is wrapper of io.Writer with extra customized info. +type StdWriter struct { + io.Writer + prefix StdType + sizeBuf []byte +} + +func (w *StdWriter) Write(buf []byte) (n int, err error) { + var n1, n2 int + if w == nil || w.Writer == nil { + return 0, errors.New("Writer not instantiated") + } + binary.BigEndian.PutUint32(w.prefix[4:], uint32(len(buf))) + n1, err = w.Writer.Write(w.prefix[:]) + if err != nil { + n = n1 - stdWriterPrefixLen + } else { + n2, err = w.Writer.Write(buf) + n = n1 + n2 - stdWriterPrefixLen + } + if n < 0 { + n = 0 + } + return +} + +// NewStdWriter instantiates a new Writer. +// Everything written to it will be encapsulated using a custom format, +// and written to the underlying `w` stream. +// This allows multiple write streams (e.g. stdout and stderr) to be muxed into a single connection. +// `t` indicates the id of the stream to encapsulate. +// It can be stdcopy.Stdin, stdcopy.Stdout, stdcopy.Stderr. +func NewStdWriter(w io.Writer, t StdType) *StdWriter { + return &StdWriter{ + Writer: w, + prefix: t, + sizeBuf: make([]byte, 4), + } +} + +var errInvalidStdHeader = errors.New("Unrecognized input header") + +// StdCopy is a modified version of io.Copy. +// +// StdCopy will demultiplex `src`, assuming that it contains two streams, +// previously multiplexed together using a StdWriter instance. +// As it reads from `src`, StdCopy will write to `dstout` and `dsterr`. +// +// StdCopy will read until it hits EOF on `src`. It will then return a nil error. +// In other words: if `err` is non nil, it indicates a real underlying error. +// +// `written` will hold the total number of bytes written to `dstout` and `dsterr`. +func StdCopy(dstout, dsterr io.Writer, src io.Reader) (written int64, err error) { + var ( + buf = make([]byte, startingBufLen) + bufLen = len(buf) + nr, nw int + er, ew error + out io.Writer + frameSize int + ) + + for { + // Make sure we have at least a full header + for nr < stdWriterPrefixLen { + var nr2 int + nr2, er = src.Read(buf[nr:]) + nr += nr2 + if er == io.EOF { + if nr < stdWriterPrefixLen { + logrus.Debugf("Corrupted prefix: %v", buf[:nr]) + return written, nil + } + break + } + if er != nil { + logrus.Debugf("Error reading header: %s", er) + return 0, er + } + } + + // Check the first byte to know where to write + switch buf[stdWriterFdIndex] { + case 0: + fallthrough + case 1: + // Write on stdout + out = dstout + case 2: + // Write on stderr + out = dsterr + default: + logrus.Debugf("Error selecting output fd: (%d)", buf[stdWriterFdIndex]) + return 0, errInvalidStdHeader + } + + // Retrieve the size of the frame + frameSize = int(binary.BigEndian.Uint32(buf[stdWriterSizeIndex : stdWriterSizeIndex+4])) + logrus.Debugf("framesize: %d", frameSize) + + // Check if the buffer is big enough to read the frame. + // Extend it if necessary. + if frameSize+stdWriterPrefixLen > bufLen { + logrus.Debugf("Extending buffer cap by %d (was %d)", frameSize+stdWriterPrefixLen-bufLen+1, len(buf)) + buf = append(buf, make([]byte, frameSize+stdWriterPrefixLen-bufLen+1)...) + bufLen = len(buf) + } + + // While the amount of bytes read is less than the size of the frame + header, we keep reading + for nr < frameSize+stdWriterPrefixLen { + var nr2 int + nr2, er = src.Read(buf[nr:]) + nr += nr2 + if er == io.EOF { + if nr < frameSize+stdWriterPrefixLen { + logrus.Debugf("Corrupted frame: %v", buf[stdWriterPrefixLen:nr]) + return written, nil + } + break + } + if er != nil { + logrus.Debugf("Error reading frame: %s", er) + return 0, er + } + } + + // Write the retrieved frame (without header) + nw, ew = out.Write(buf[stdWriterPrefixLen : frameSize+stdWriterPrefixLen]) + if ew != nil { + logrus.Debugf("Error writing frame: %s", ew) + return 0, ew + } + // If the frame has not been fully written: error + if nw != frameSize { + logrus.Debugf("Error Short Write: (%d on %d)", nw, frameSize) + return 0, io.ErrShortWrite + } + written += int64(nw) + + // Move the rest of the buffer to the beginning + copy(buf, buf[frameSize+stdWriterPrefixLen:]) + // Move the index + nr -= frameSize + stdWriterPrefixLen + } +} diff --git a/pkg/stdcopy/stdcopy_test.go b/pkg/stdcopy/stdcopy_test.go new file mode 100644 index 0000000000..88d88d41e6 --- /dev/null +++ b/pkg/stdcopy/stdcopy_test.go @@ -0,0 +1,261 @@ +package stdcopy + +import ( + "bytes" + "errors" + "io" + "io/ioutil" + "strings" + "testing" +) + +func TestNewStdWriter(t *testing.T) { + writer := NewStdWriter(ioutil.Discard, Stdout) + if writer == nil { + t.Fatalf("NewStdWriter with an invalid StdType should not return nil.") + } +} + +func TestWriteWithUnitializedStdWriter(t *testing.T) { + writer := StdWriter{ + Writer: nil, + prefix: Stdout, + sizeBuf: make([]byte, 4), + } + n, err := writer.Write([]byte("Something here")) + if n != 0 || err == nil { + t.Fatalf("Should fail when given an uncomplete or uninitialized StdWriter") + } +} + +func TestWriteWithNilBytes(t *testing.T) { + writer := NewStdWriter(ioutil.Discard, Stdout) + n, err := writer.Write(nil) + if err != nil { + t.Fatalf("Shouldn't have fail when given no data") + } + if n > 0 { + t.Fatalf("Write should have written 0 byte, but has written %d", n) + } +} + +func TestWrite(t *testing.T) { + writer := NewStdWriter(ioutil.Discard, Stdout) + data := []byte("Test StdWrite.Write") + n, err := writer.Write(data) + if err != nil { + t.Fatalf("Error while writing with StdWrite") + } + if n != len(data) { + t.Fatalf("Write should have written %d byte but wrote %d.", len(data), n) + } +} + +type errWriter struct { + n int + err error +} + +func (f *errWriter) Write(buf []byte) (int, error) { + return f.n, f.err +} + +func TestWriteWithWriterError(t *testing.T) { + expectedError := errors.New("expected") + expectedReturnedBytes := 10 + writer := NewStdWriter(&errWriter{ + n: stdWriterPrefixLen + expectedReturnedBytes, + err: expectedError}, Stdout) + data := []byte("This won't get written, sigh") + n, err := writer.Write(data) + if err != expectedError { + t.Fatalf("Didn't get expected error.") + } + if n != expectedReturnedBytes { + t.Fatalf("Didn't get expected writen bytes %d, got %d.", + expectedReturnedBytes, n) + } +} + +func TestWriteDoesNotReturnNegativeWrittenBytes(t *testing.T) { + writer := NewStdWriter(&errWriter{n: -1}, Stdout) + data := []byte("This won't get written, sigh") + actual, _ := writer.Write(data) + if actual != 0 { + t.Fatalf("Expected returned written bytes equal to 0, got %d", actual) + } +} + +func getSrcBuffer(stdOutBytes, stdErrBytes []byte) (buffer *bytes.Buffer, err error) { + buffer = new(bytes.Buffer) + dstOut := NewStdWriter(buffer, Stdout) + _, err = dstOut.Write(stdOutBytes) + if err != nil { + return + } + dstErr := NewStdWriter(buffer, Stderr) + _, err = dstErr.Write(stdErrBytes) + return +} + +func TestStdCopyWriteAndRead(t *testing.T) { + stdOutBytes := []byte(strings.Repeat("o", startingBufLen)) + stdErrBytes := []byte(strings.Repeat("e", startingBufLen)) + buffer, err := getSrcBuffer(stdOutBytes, stdErrBytes) + if err != nil { + t.Fatal(err) + } + written, err := StdCopy(ioutil.Discard, ioutil.Discard, buffer) + if err != nil { + t.Fatal(err) + } + expectedTotalWritten := len(stdOutBytes) + len(stdErrBytes) + if written != int64(expectedTotalWritten) { + t.Fatalf("Expected to have total of %d bytes written, got %d", expectedTotalWritten, written) + } +} + +type customReader struct { + n int + err error + totalCalls int + correctCalls int + src *bytes.Buffer +} + +func (f *customReader) Read(buf []byte) (int, error) { + f.totalCalls++ + if f.totalCalls <= f.correctCalls { + return f.src.Read(buf) + } + return f.n, f.err +} + +func TestStdCopyReturnsErrorReadingHeader(t *testing.T) { + expectedError := errors.New("error") + reader := &customReader{ + err: expectedError} + written, err := StdCopy(ioutil.Discard, ioutil.Discard, reader) + if written != 0 { + t.Fatalf("Expected 0 bytes read, got %d", written) + } + if err != expectedError { + t.Fatalf("Didn't get expected error") + } +} + +func TestStdCopyReturnsErrorReadingFrame(t *testing.T) { + expectedError := errors.New("error") + stdOutBytes := []byte(strings.Repeat("o", startingBufLen)) + stdErrBytes := []byte(strings.Repeat("e", startingBufLen)) + buffer, err := getSrcBuffer(stdOutBytes, stdErrBytes) + if err != nil { + t.Fatal(err) + } + reader := &customReader{ + correctCalls: 1, + n: stdWriterPrefixLen + 1, + err: expectedError, + src: buffer} + written, err := StdCopy(ioutil.Discard, ioutil.Discard, reader) + if written != 0 { + t.Fatalf("Expected 0 bytes read, got %d", written) + } + if err != expectedError { + t.Fatalf("Didn't get expected error") + } +} + +func TestStdCopyDetectsCorruptedFrame(t *testing.T) { + stdOutBytes := []byte(strings.Repeat("o", startingBufLen)) + stdErrBytes := []byte(strings.Repeat("e", startingBufLen)) + buffer, err := getSrcBuffer(stdOutBytes, stdErrBytes) + if err != nil { + t.Fatal(err) + } + reader := &customReader{ + correctCalls: 1, + n: stdWriterPrefixLen + 1, + err: io.EOF, + src: buffer} + written, err := StdCopy(ioutil.Discard, ioutil.Discard, reader) + if written != startingBufLen { + t.Fatalf("Expected 0 bytes read, got %d", written) + } + if err != nil { + t.Fatal("Didn't get nil error") + } +} + +func TestStdCopyWithInvalidInputHeader(t *testing.T) { + dstOut := NewStdWriter(ioutil.Discard, Stdout) + dstErr := NewStdWriter(ioutil.Discard, Stderr) + src := strings.NewReader("Invalid input") + _, err := StdCopy(dstOut, dstErr, src) + if err == nil { + t.Fatal("StdCopy with invalid input header should fail.") + } +} + +func TestStdCopyWithCorruptedPrefix(t *testing.T) { + data := []byte{0x01, 0x02, 0x03} + src := bytes.NewReader(data) + written, err := StdCopy(nil, nil, src) + if err != nil { + t.Fatalf("StdCopy should not return an error with corrupted prefix.") + } + if written != 0 { + t.Fatalf("StdCopy should have written 0, but has written %d", written) + } +} + +func TestStdCopyReturnsWriteErrors(t *testing.T) { + stdOutBytes := []byte(strings.Repeat("o", startingBufLen)) + stdErrBytes := []byte(strings.Repeat("e", startingBufLen)) + buffer, err := getSrcBuffer(stdOutBytes, stdErrBytes) + if err != nil { + t.Fatal(err) + } + expectedError := errors.New("expected") + + dstOut := &errWriter{err: expectedError} + + written, err := StdCopy(dstOut, ioutil.Discard, buffer) + if written != 0 { + t.Fatalf("StdCopy should have written 0, but has written %d", written) + } + if err != expectedError { + t.Fatalf("Didn't get expected error, got %v", err) + } +} + +func TestStdCopyDetectsNotFullyWrittenFrames(t *testing.T) { + stdOutBytes := []byte(strings.Repeat("o", startingBufLen)) + stdErrBytes := []byte(strings.Repeat("e", startingBufLen)) + buffer, err := getSrcBuffer(stdOutBytes, stdErrBytes) + if err != nil { + t.Fatal(err) + } + dstOut := &errWriter{n: startingBufLen - 10} + + written, err := StdCopy(dstOut, ioutil.Discard, buffer) + if written != 0 { + t.Fatalf("StdCopy should have return 0 written bytes, but returned %d", written) + } + if err != io.ErrShortWrite { + t.Fatalf("Didn't get expected io.ErrShortWrite error") + } +} + +func BenchmarkWrite(b *testing.B) { + w := NewStdWriter(ioutil.Discard, Stdout) + data := []byte("Test line for testing stdwriter performance\n") + data = bytes.Repeat(data, 100) + b.SetBytes(int64(len(data))) + b.ResetTimer() + for i := 0; i < b.N; i++ { + if _, err := w.Write(data); err != nil { + b.Fatal(err) + } + } +} diff --git a/pkg/streamformatter/streamformatter.go b/pkg/streamformatter/streamformatter.go new file mode 100644 index 0000000000..7b7ad12405 --- /dev/null +++ b/pkg/streamformatter/streamformatter.go @@ -0,0 +1,123 @@ +// Package streamformatter provides helper functions to format a stream. +package streamformatter + +import ( + "encoding/json" + "fmt" + "io" + + "github.com/docker/docker/pkg/jsonmessage" +) + +// StreamFormatter formats a stream, optionally using JSON. +type StreamFormatter struct { + json bool +} + +// NewStreamFormatter returns a simple StreamFormatter +func NewStreamFormatter() *StreamFormatter { + return &StreamFormatter{} +} + +// NewJSONStreamFormatter returns a StreamFormatter configured to stream json +func NewJSONStreamFormatter() *StreamFormatter { + return &StreamFormatter{true} +} + +const streamNewline = "\r\n" + +var streamNewlineBytes = []byte(streamNewline) + +// FormatStream formats the specified stream. +func (sf *StreamFormatter) FormatStream(str string) []byte { + if sf.json { + b, err := json.Marshal(&jsonmessage.JSONMessage{Stream: str}) + if err != nil { + return sf.FormatError(err) + } + return append(b, streamNewlineBytes...) + } + return []byte(str + "\r") +} + +// FormatStatus formats the specified objects according to the specified format (and id). +func (sf *StreamFormatter) FormatStatus(id, format string, a ...interface{}) []byte { + str := fmt.Sprintf(format, a...) + if sf.json { + b, err := json.Marshal(&jsonmessage.JSONMessage{ID: id, Status: str}) + if err != nil { + return sf.FormatError(err) + } + return append(b, streamNewlineBytes...) + } + return []byte(str + streamNewline) +} + +// FormatError formats the specifed error. +func (sf *StreamFormatter) FormatError(err error) []byte { + if sf.json { + jsonError, ok := err.(*jsonmessage.JSONError) + if !ok { + jsonError = &jsonmessage.JSONError{Message: err.Error()} + } + if b, err := json.Marshal(&jsonmessage.JSONMessage{Error: jsonError, ErrorMessage: err.Error()}); err == nil { + return append(b, streamNewlineBytes...) + } + return []byte("{\"error\":\"format error\"}" + streamNewline) + } + return []byte("Error: " + err.Error() + streamNewline) +} + +// FormatProgress formats the progress information for a specified action. +func (sf *StreamFormatter) FormatProgress(id, action string, progress *jsonmessage.JSONProgress) []byte { + if progress == nil { + progress = &jsonmessage.JSONProgress{} + } + if sf.json { + b, err := json.Marshal(&jsonmessage.JSONMessage{ + Status: action, + ProgressMessage: progress.String(), + Progress: progress, + ID: id, + }) + if err != nil { + return nil + } + return b + } + endl := "\r" + if progress.String() == "" { + endl += "\n" + } + return []byte(action + " " + progress.String() + endl) +} + +// StdoutFormatter is a streamFormatter that writes to the standard output. +type StdoutFormatter struct { + io.Writer + *StreamFormatter +} + +func (sf *StdoutFormatter) Write(buf []byte) (int, error) { + formattedBuf := sf.StreamFormatter.FormatStream(string(buf)) + n, err := sf.Writer.Write(formattedBuf) + if n != len(formattedBuf) { + return n, io.ErrShortWrite + } + return len(buf), err +} + +// StderrFormatter is a streamFormatter that writes to the standard error. +type StderrFormatter struct { + io.Writer + *StreamFormatter +} + +func (sf *StderrFormatter) Write(buf []byte) (int, error) { + formattedBuf := sf.StreamFormatter.FormatStream("\033[91m" + string(buf) + "\033[0m") + n, err := sf.Writer.Write(formattedBuf) + if n != len(formattedBuf) { + return n, io.ErrShortWrite + } + return len(buf), err +} diff --git a/pkg/streamformatter/streamformatter_test.go b/pkg/streamformatter/streamformatter_test.go new file mode 100644 index 0000000000..acf81bef68 --- /dev/null +++ b/pkg/streamformatter/streamformatter_test.go @@ -0,0 +1,93 @@ +package streamformatter + +import ( + "encoding/json" + "errors" + "reflect" + "testing" + + "github.com/docker/docker/pkg/jsonmessage" +) + +func TestFormatStream(t *testing.T) { + sf := NewStreamFormatter() + res := sf.FormatStream("stream") + if string(res) != "stream"+"\r" { + t.Fatalf("%q", res) + } +} + +func TestFormatJSONStatus(t *testing.T) { + sf := NewStreamFormatter() + res := sf.FormatStatus("ID", "%s%d", "a", 1) + if string(res) != "a1\r\n" { + t.Fatalf("%q", res) + } +} + +func TestFormatSimpleError(t *testing.T) { + sf := NewStreamFormatter() + res := sf.FormatError(errors.New("Error for formatter")) + if string(res) != "Error: Error for formatter\r\n" { + t.Fatalf("%q", res) + } +} + +func TestJSONFormatStream(t *testing.T) { + sf := NewJSONStreamFormatter() + res := sf.FormatStream("stream") + if string(res) != `{"stream":"stream"}`+"\r\n" { + t.Fatalf("%q", res) + } +} + +func TestJSONFormatStatus(t *testing.T) { + sf := NewJSONStreamFormatter() + res := sf.FormatStatus("ID", "%s%d", "a", 1) + if string(res) != `{"status":"a1","id":"ID"}`+"\r\n" { + t.Fatalf("%q", res) + } +} + +func TestJSONFormatSimpleError(t *testing.T) { + sf := NewJSONStreamFormatter() + res := sf.FormatError(errors.New("Error for formatter")) + if string(res) != `{"errorDetail":{"message":"Error for formatter"},"error":"Error for formatter"}`+"\r\n" { + t.Fatalf("%q", res) + } +} + +func TestJSONFormatJSONError(t *testing.T) { + sf := NewJSONStreamFormatter() + err := &jsonmessage.JSONError{Code: 50, Message: "Json error"} + res := sf.FormatError(err) + if string(res) != `{"errorDetail":{"code":50,"message":"Json error"},"error":"Json error"}`+"\r\n" { + t.Fatalf("%q", res) + } +} + +func TestJSONFormatProgress(t *testing.T) { + sf := NewJSONStreamFormatter() + progress := &jsonmessage.JSONProgress{ + Current: 15, + Total: 30, + Start: 1, + } + res := sf.FormatProgress("id", "action", progress) + msg := &jsonmessage.JSONMessage{} + if err := json.Unmarshal(res, msg); err != nil { + t.Fatal(err) + } + if msg.ID != "id" { + t.Fatalf("ID must be 'id', got: %s", msg.ID) + } + if msg.Status != "action" { + t.Fatalf("Status must be 'action', got: %s", msg.Status) + } + if msg.ProgressMessage != progress.String() { + t.Fatalf("ProgressMessage must be %s, got: %s", progress.String(), msg.ProgressMessage) + } + if !reflect.DeepEqual(msg.Progress, progress) { + t.Fatal("Original progress not equals progress from FormatProgress") + } +} diff --git a/pkg/stringid/README.md b/pkg/stringid/README.md new file mode 100644 index 0000000000..37a5098fd9 --- /dev/null +++ b/pkg/stringid/README.md @@ -0,0 +1 @@ +This package provides helper functions for dealing with string identifiers diff --git a/pkg/stringid/stringid.go b/pkg/stringid/stringid.go new file mode 100644 index 0000000000..ab1f9d4749 --- /dev/null +++ b/pkg/stringid/stringid.go @@ -0,0 +1,67 @@ +// Package stringid provides helper functions for dealing with string identifiers +package stringid + +import ( + "crypto/rand" + "encoding/hex" + "io" + "regexp" + "strconv" + + "github.com/docker/docker/pkg/random" +) + +const shortLen = 12 + +var validShortID = regexp.MustCompile("^[a-z0-9]{12}$") + +// IsShortID determines if an arbitrary string *looks like* a short ID. +func IsShortID(id string) bool { + return validShortID.MatchString(id) +} + +// TruncateID returns a shorthand version of a string identifier for convenience. +// A collision with other shorthands is very unlikely, but possible. +// In case of a collision a lookup with TruncIndex.Get() will fail, and the caller +// will need to use a langer prefix, or the full-length Id. +func TruncateID(id string) string { + trimTo := shortLen + if len(id) < shortLen { + trimTo = len(id) + } + return id[:trimTo] +} + +func generateID(crypto bool) string { + b := make([]byte, 32) + var r io.Reader = random.Reader + if crypto { + r = rand.Reader + } + for { + if _, err := io.ReadFull(r, b); err != nil { + panic(err) // This shouldn't happen + } + id := hex.EncodeToString(b) + // if we try to parse the truncated for as an int and we don't have + // an error then the value is all numberic and causes issues when + // used as a hostname. ref #3869 + if _, err := strconv.ParseInt(TruncateID(id), 10, 64); err == nil { + continue + } + return id + } +} + +// GenerateRandomID returns an unique id. +func GenerateRandomID() string { + return generateID(true) + +} + +// GenerateNonCryptoID generates unique id without using cryptographically +// secure sources of random. +// It helps you to save entropy. +func GenerateNonCryptoID() string { + return generateID(false) +} diff --git a/pkg/stringid/stringid_test.go b/pkg/stringid/stringid_test.go new file mode 100644 index 0000000000..bcb1365495 --- /dev/null +++ b/pkg/stringid/stringid_test.go @@ -0,0 +1,56 @@ +package stringid + +import ( + "strings" + "testing" +) + +func TestGenerateRandomID(t *testing.T) { + id := GenerateRandomID() + + if len(id) != 64 { + t.Fatalf("Id returned is incorrect: %s", id) + } +} + +func TestShortenId(t *testing.T) { + id := GenerateRandomID() + truncID := TruncateID(id) + if len(truncID) != 12 { + t.Fatalf("Id returned is incorrect: truncate on %s returned %s", id, truncID) + } +} + +func TestShortenIdEmpty(t *testing.T) { + id := "" + truncID := TruncateID(id) + if len(truncID) > len(id) { + t.Fatalf("Id returned is incorrect: truncate on %s returned %s", id, truncID) + } +} + +func TestShortenIdInvalid(t *testing.T) { + id := "1234" + truncID := TruncateID(id) + if len(truncID) != len(id) { + t.Fatalf("Id returned is incorrect: truncate on %s returned %s", id, truncID) + } +} + +func TestIsShortIDNonHex(t *testing.T) { + id := "some non-hex value" + if IsShortID(id) { + t.Fatalf("%s is not a short ID", id) + } +} + +func TestIsShortIDNotCorrectSize(t *testing.T) { + id := strings.Repeat("a", shortLen+1) + if IsShortID(id) { + t.Fatalf("%s is not a short ID", id) + } + id = strings.Repeat("a", shortLen-1) + if IsShortID(id) { + t.Fatalf("%s is not a short ID", id) + } +} diff --git a/pkg/stringutils/README.md b/pkg/stringutils/README.md new file mode 100644 index 0000000000..b3e454573c --- /dev/null +++ b/pkg/stringutils/README.md @@ -0,0 +1 @@ +This package provides helper functions for dealing with strings diff --git a/pkg/stringutils/stringutils.go b/pkg/stringutils/stringutils.go new file mode 100644 index 0000000000..41a0d2eb3a --- /dev/null +++ b/pkg/stringutils/stringutils.go @@ -0,0 +1,87 @@ +// Package stringutils provides helper functions for dealing with strings. +package stringutils + +import ( + "bytes" + "math/rand" + "strings" + + "github.com/docker/docker/pkg/random" +) + +// GenerateRandomAlphaOnlyString generates an alphabetical random string with length n. +func GenerateRandomAlphaOnlyString(n int) string { + // make a really long string + letters := []byte("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ") + b := make([]byte, n) + for i := range b { + b[i] = letters[random.Rand.Intn(len(letters))] + } + return string(b) +} + +// GenerateRandomASCIIString generates an ASCII random stirng with length n. +func GenerateRandomASCIIString(n int) string { + chars := "abcdefghijklmnopqrstuvwxyz" + + "ABCDEFGHIJKLMNOPQRSTUVWXYZ" + + "~!@#$%^&*()-_+={}[]\\|<,>.?/\"';:` " + res := make([]byte, n) + for i := 0; i < n; i++ { + res[i] = chars[rand.Intn(len(chars))] + } + return string(res) +} + +// Truncate truncates a string to maxlen. +func Truncate(s string, maxlen int) string { + if len(s) <= maxlen { + return s + } + return s[:maxlen] +} + +// InSlice tests whether a string is contained in a slice of strings or not. +// Comparison is case insensitive +func InSlice(slice []string, s string) bool { + for _, ss := range slice { + if strings.ToLower(s) == strings.ToLower(ss) { + return true + } + } + return false +} + +func quote(word string, buf *bytes.Buffer) { + // Bail out early for "simple" strings + if word != "" && !strings.ContainsAny(word, "\\'\"`${[|&;<>()~*?! \t\n") { + buf.WriteString(word) + return + } + + buf.WriteString("'") + + for i := 0; i < len(word); i++ { + b := word[i] + if b == '\'' { + // Replace literal ' with a close ', a \', and a open ' + buf.WriteString("'\\''") + } else { + buf.WriteByte(b) + } + } + + buf.WriteString("'") +} + +// ShellQuoteArguments takes a list of strings and escapes them so they will be +// handled right when passed as arguments to an program via a shell +func ShellQuoteArguments(args []string) string { + var buf bytes.Buffer + for i, arg := range args { + if i != 0 { + buf.WriteByte(' ') + } + quote(arg, &buf) + } + return buf.String() +} diff --git a/pkg/stringutils/stringutils_test.go b/pkg/stringutils/stringutils_test.go new file mode 100644 index 0000000000..fec59450bc --- /dev/null +++ b/pkg/stringutils/stringutils_test.go @@ -0,0 +1,105 @@ +package stringutils + +import "testing" + +func testLengthHelper(generator func(int) string, t *testing.T) { + expectedLength := 20 + s := generator(expectedLength) + if len(s) != expectedLength { + t.Fatalf("Length of %s was %d but expected length %d", s, len(s), expectedLength) + } +} + +func testUniquenessHelper(generator func(int) string, t *testing.T) { + repeats := 25 + set := make(map[string]struct{}, repeats) + for i := 0; i < repeats; i = i + 1 { + str := generator(64) + if len(str) != 64 { + t.Fatalf("Id returned is incorrect: %s", str) + } + if _, ok := set[str]; ok { + t.Fatalf("Random number is repeated") + } + set[str] = struct{}{} + } +} + +func isASCII(s string) bool { + for _, c := range s { + if c > 127 { + return false + } + } + return true +} + +func TestGenerateRandomAlphaOnlyStringLength(t *testing.T) { + testLengthHelper(GenerateRandomAlphaOnlyString, t) +} + +func TestGenerateRandomAlphaOnlyStringUniqueness(t *testing.T) { + testUniquenessHelper(GenerateRandomAlphaOnlyString, t) +} + +func TestGenerateRandomAsciiStringLength(t *testing.T) { + testLengthHelper(GenerateRandomASCIIString, t) +} + +func TestGenerateRandomAsciiStringUniqueness(t *testing.T) { + testUniquenessHelper(GenerateRandomASCIIString, t) +} + +func TestGenerateRandomAsciiStringIsAscii(t *testing.T) { + str := GenerateRandomASCIIString(64) + if !isASCII(str) { + t.Fatalf("%s contained non-ascii characters", str) + } +} + +func TestTruncate(t *testing.T) { + str := "teststring" + newstr := Truncate(str, 4) + if newstr != "test" { + t.Fatalf("Expected test, got %s", newstr) + } + newstr = Truncate(str, 20) + if newstr != "teststring" { + t.Fatalf("Expected teststring, got %s", newstr) + } +} + +func TestInSlice(t *testing.T) { + slice := []string{"test", "in", "slice"} + + test := InSlice(slice, "test") + if !test { + t.Fatalf("Expected string test to be in slice") + } + test = InSlice(slice, "SLICE") + if !test { + t.Fatalf("Expected string SLICE to be in slice") + } + test = InSlice(slice, "notinslice") + if test { + t.Fatalf("Expected string notinslice not to be in slice") + } +} + +func TestShellQuoteArgumentsEmpty(t *testing.T) { + actual := ShellQuoteArguments([]string{}) + expected := "" + if actual != expected { + t.Fatalf("Expected an empty string") + } +} + +func TestShellQuoteArguments(t *testing.T) { + simpleString := "simpleString" + complexString := "This is a 'more' complex $tring with some special char *" + actual := ShellQuoteArguments([]string{simpleString, complexString}) + expected := "simpleString 'This is a '\\''more'\\'' complex $tring with some special char *'" + if actual != expected { + t.Fatalf("Expected \"%v\", got \"%v\"", expected, actual) + } +} diff --git a/pkg/stringutils/strslice.go b/pkg/stringutils/strslice.go new file mode 100644 index 0000000000..4055754026 --- /dev/null +++ b/pkg/stringutils/strslice.go @@ -0,0 +1,71 @@ +package stringutils + +import ( + "encoding/json" + "strings" +) + +// StrSlice representes a string or an array of strings. +// We need to override the json decoder to accept both options. +type StrSlice struct { + parts []string +} + +// MarshalJSON Marshals (or serializes) the StrSlice into the json format. +// This method is needed to implement json.Marshaller. +func (e *StrSlice) MarshalJSON() ([]byte, error) { + if e == nil { + return []byte{}, nil + } + return json.Marshal(e.Slice()) +} + +// UnmarshalJSON decodes the byte slice whether it's a string or an array of strings. +// This method is needed to implement json.Unmarshaler. +func (e *StrSlice) UnmarshalJSON(b []byte) error { + if len(b) == 0 { + return nil + } + + p := make([]string, 0, 1) + if err := json.Unmarshal(b, &p); err != nil { + var s string + if err := json.Unmarshal(b, &s); err != nil { + return err + } + p = append(p, s) + } + + e.parts = p + return nil +} + +// Len returns the number of parts of the StrSlice. +func (e *StrSlice) Len() int { + if e == nil { + return 0 + } + return len(e.parts) +} + +// Slice gets the parts of the StrSlice as a Slice of string. +func (e *StrSlice) Slice() []string { + if e == nil { + return nil + } + return e.parts +} + +// ToString gets space separated string of all the parts. +func (e *StrSlice) ToString() string { + s := e.Slice() + if s == nil { + return "" + } + return strings.Join(s, " ") +} + +// NewStrSlice creates an StrSlice based on the specified parts (as strings). +func NewStrSlice(parts ...string) *StrSlice { + return &StrSlice{parts} +} diff --git a/pkg/stringutils/strslice_test.go b/pkg/stringutils/strslice_test.go new file mode 100644 index 0000000000..a587784eb9 --- /dev/null +++ b/pkg/stringutils/strslice_test.go @@ -0,0 +1,135 @@ +package stringutils + +import ( + "encoding/json" + "reflect" + "testing" +) + +func TestStrSliceMarshalJSON(t *testing.T) { + strss := map[*StrSlice]string{ + nil: "", + &StrSlice{}: "null", + &StrSlice{[]string{"/bin/sh", "-c", "echo"}}: `["/bin/sh","-c","echo"]`, + } + + for strs, expected := range strss { + data, err := strs.MarshalJSON() + if err != nil { + t.Fatal(err) + } + if string(data) != expected { + t.Fatalf("Expected %v, got %v", expected, string(data)) + } + } +} + +func TestStrSliceUnmarshalJSON(t *testing.T) { + parts := map[string][]string{ + "": {"default", "values"}, + "[]": {}, + `["/bin/sh","-c","echo"]`: {"/bin/sh", "-c", "echo"}, + } + for json, expectedParts := range parts { + strs := &StrSlice{ + []string{"default", "values"}, + } + if err := strs.UnmarshalJSON([]byte(json)); err != nil { + t.Fatal(err) + } + + actualParts := strs.Slice() + if len(actualParts) != len(expectedParts) { + t.Fatalf("Expected %v parts, got %v (%v)", len(expectedParts), len(actualParts), expectedParts) + } + for index, part := range actualParts { + if part != expectedParts[index] { + t.Fatalf("Expected %v, got %v", expectedParts, actualParts) + break + } + } + } +} + +func TestStrSliceUnmarshalString(t *testing.T) { + var e *StrSlice + echo, err := json.Marshal("echo") + if err != nil { + t.Fatal(err) + } + if err := json.Unmarshal(echo, &e); err != nil { + t.Fatal(err) + } + + slice := e.Slice() + if len(slice) != 1 { + t.Fatalf("expected 1 element after unmarshal: %q", slice) + } + + if slice[0] != "echo" { + t.Fatalf("expected `echo`, got: %q", slice[0]) + } +} + +func TestStrSliceUnmarshalSlice(t *testing.T) { + var e *StrSlice + echo, err := json.Marshal([]string{"echo"}) + if err != nil { + t.Fatal(err) + } + if err := json.Unmarshal(echo, &e); err != nil { + t.Fatal(err) + } + + slice := e.Slice() + if len(slice) != 1 { + t.Fatalf("expected 1 element after unmarshal: %q", slice) + } + + if slice[0] != "echo" { + t.Fatalf("expected `echo`, got: %q", slice[0]) + } +} + +func TestStrSliceToString(t *testing.T) { + slices := map[*StrSlice]string{ + NewStrSlice(""): "", + NewStrSlice("one"): "one", + NewStrSlice("one", "two"): "one two", + } + for s, expected := range slices { + toString := s.ToString() + if toString != expected { + t.Fatalf("Expected %v, got %v", expected, toString) + } + } +} + +func TestStrSliceLen(t *testing.T) { + var emptyStrSlice *StrSlice + slices := map[*StrSlice]int{ + NewStrSlice(""): 1, + NewStrSlice("one"): 1, + NewStrSlice("one", "two"): 2, + emptyStrSlice: 0, + } + for s, expected := range slices { + if s.Len() != expected { + t.Fatalf("Expected %d, got %d", s.Len(), expected) + } + } +} + +func TestStrSliceSlice(t *testing.T) { + var emptyStrSlice *StrSlice + slices := map[*StrSlice][]string{ + NewStrSlice("one"): {"one"}, + NewStrSlice("one", "two"): {"one", "two"}, + emptyStrSlice: nil, + } + for s, expected := range slices { + if !reflect.DeepEqual(s.Slice(), expected) { + t.Fatalf("Expected %v, got %v", s.Slice(), expected) + } + } +} diff --git a/pkg/symlink/LICENSE.APACHE b/pkg/symlink/LICENSE.APACHE new file mode 100644 index 0000000000..9e4bd4dbee --- /dev/null +++ b/pkg/symlink/LICENSE.APACHE @@ -0,0 +1,191 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + Copyright 2014-2015 Docker, Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/pkg/symlink/LICENSE.BSD b/pkg/symlink/LICENSE.BSD new file mode 100644 index 0000000000..ac74d8f049 --- /dev/null +++ b/pkg/symlink/LICENSE.BSD @@ -0,0 +1,27 @@ +Copyright (c) 2014-2015 The Docker & Go Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/pkg/symlink/README.md b/pkg/symlink/README.md new file mode 100644 index 0000000000..8dba54fd08 --- /dev/null +++ b/pkg/symlink/README.md @@ -0,0 +1,6 @@ +Package symlink implements EvalSymlinksInScope which is an extension of filepath.EvalSymlinks, +as well as a Windows long-path aware version of filepath.EvalSymlinks +from the [Go standard library](https://golang.org/pkg/path/filepath). + +The code from filepath.EvalSymlinks has been adapted in fs.go. +Please read the LICENSE.BSD file that governs fs.go and LICENSE.APACHE for fs_test.go. diff --git a/pkg/symlink/fs.go b/pkg/symlink/fs.go new file mode 100644 index 0000000000..dcf707f426 --- /dev/null +++ b/pkg/symlink/fs.go @@ -0,0 +1,143 @@ +// Copyright 2012 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE.BSD file. + +// This code is a modified version of path/filepath/symlink.go from the Go standard library. + +package symlink + +import ( + "bytes" + "errors" + "os" + "path/filepath" + "strings" + + "github.com/docker/docker/pkg/system" +) + +// FollowSymlinkInScope is a wrapper around evalSymlinksInScope that returns an +// absolute path. This function handles paths in a platform-agnostic manner. +func FollowSymlinkInScope(path, root string) (string, error) { + path, err := filepath.Abs(filepath.FromSlash(path)) + if err != nil { + return "", err + } + root, err = filepath.Abs(filepath.FromSlash(root)) + if err != nil { + return "", err + } + return evalSymlinksInScope(path, root) +} + +// evalSymlinksInScope will evaluate symlinks in `path` within a scope `root` and return +// a result guaranteed to be contained within the scope `root`, at the time of the call. +// Symlinks in `root` are not evaluated and left as-is. +// Errors encountered while attempting to evaluate symlinks in path will be returned. +// Non-existing paths are valid and do not constitute an error. +// `path` has to contain `root` as a prefix, or else an error will be returned. +// Trying to break out from `root` does not constitute an error. +// +// Example: +// If /foo/bar -> /outside, +// FollowSymlinkInScope("/foo/bar", "/foo") == "/foo/outside" instead of "/oustide" +// +// IMPORTANT: it is the caller's responsibility to call evalSymlinksInScope *after* relevant symlinks +// are created and not to create subsequently, additional symlinks that could potentially make a +// previously-safe path, unsafe. Example: if /foo/bar does not exist, evalSymlinksInScope("/foo/bar", "/foo") +// would return "/foo/bar". If one makes /foo/bar a symlink to /baz subsequently, then "/foo/bar" should +// no longer be considered safely contained in "/foo". +func evalSymlinksInScope(path, root string) (string, error) { + root = filepath.Clean(root) + if path == root { + return path, nil + } + if !strings.HasPrefix(path, root) { + return "", errors.New("evalSymlinksInScope: " + path + " is not in " + root) + } + const maxIter = 255 + originalPath := path + // given root of "/a" and path of "/a/b/../../c" we want path to be "/b/../../c" + path = path[len(root):] + if root == string(filepath.Separator) { + path = string(filepath.Separator) + path + } + if !strings.HasPrefix(path, string(filepath.Separator)) { + return "", errors.New("evalSymlinksInScope: " + path + " is not in " + root) + } + path = filepath.Clean(path) + // consume path by taking each frontmost path element, + // expanding it if it's a symlink, and appending it to b + var b bytes.Buffer + // b here will always be considered to be the "current absolute path inside + // root" when we append paths to it, we also append a slash and use + // filepath.Clean after the loop to trim the trailing slash + for n := 0; path != ""; n++ { + if n > maxIter { + return "", errors.New("evalSymlinksInScope: too many links in " + originalPath) + } + + // find next path component, p + i := strings.IndexRune(path, filepath.Separator) + var p string + if i == -1 { + p, path = path, "" + } else { + p, path = path[:i], path[i+1:] + } + + if p == "" { + continue + } + + // this takes a b.String() like "b/../" and a p like "c" and turns it + // into "/b/../c" which then gets filepath.Cleaned into "/c" and then + // root gets prepended and we Clean again (to remove any trailing slash + // if the first Clean gave us just "/") + cleanP := filepath.Clean(string(filepath.Separator) + b.String() + p) + if cleanP == string(filepath.Separator) { + // never Lstat "/" itself + b.Reset() + continue + } + fullP := filepath.Clean(root + cleanP) + + fi, err := os.Lstat(fullP) + if os.IsNotExist(err) { + // if p does not exist, accept it + b.WriteString(p) + b.WriteRune(filepath.Separator) + continue + } + if err != nil { + return "", err + } + if fi.Mode()&os.ModeSymlink == 0 { + b.WriteString(p + string(filepath.Separator)) + continue + } + + // it's a symlink, put it at the front of path + dest, err := os.Readlink(fullP) + if err != nil { + return "", err + } + if system.IsAbs(dest) { + b.Reset() + } + path = dest + string(filepath.Separator) + path + } + + // see note above on "fullP := ..." for why this is double-cleaned and + // what's happening here + return filepath.Clean(root + filepath.Clean(string(filepath.Separator)+b.String())), nil +} + +// EvalSymlinks returns the path name after the evaluation of any symbolic +// links. +// If path is relative the result will be relative to the current directory, +// unless one of the components is an absolute symbolic link. +// This version has been updated to support long paths prepended with `\\?\`. +func EvalSymlinks(path string) (string, error) { + return evalSymlinks(path) +} diff --git a/pkg/symlink/fs_test.go b/pkg/symlink/fs_test.go new file mode 100644 index 0000000000..89209484a3 --- /dev/null +++ b/pkg/symlink/fs_test.go @@ -0,0 +1,402 @@ +// Licensed under the Apache License, Version 2.0; See LICENSE.APACHE + +package symlink + +import ( + "fmt" + "io/ioutil" + "os" + "path/filepath" + "testing" +) + +type dirOrLink struct { + path string + target string +} + +func makeFs(tmpdir string, fs []dirOrLink) error { + for _, s := range fs { + s.path = filepath.Join(tmpdir, s.path) + if s.target == "" { + os.MkdirAll(s.path, 0755) + continue + } + if err := os.MkdirAll(filepath.Dir(s.path), 0755); err != nil { + return err + } + if err := os.Symlink(s.target, s.path); err != nil && !os.IsExist(err) { + return err + } + } + return nil +} + +func testSymlink(tmpdir, path, expected, scope string) error { + rewrite, err := FollowSymlinkInScope(filepath.Join(tmpdir, path), filepath.Join(tmpdir, scope)) + if err != nil { + return err + } + expected, err = filepath.Abs(filepath.Join(tmpdir, expected)) + if err != nil { + return err + } + if expected != rewrite { + return fmt.Errorf("Expected %q got %q", expected, rewrite) + } + return nil +} + +func TestFollowSymlinkAbsolute(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkAbsolute") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + if err := makeFs(tmpdir, []dirOrLink{{path: "testdata/fs/a/d", target: "/b"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "testdata/fs/a/d/c/data", "testdata/b/c/data", "testdata"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkRelativePath(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkRelativePath") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + if err := makeFs(tmpdir, []dirOrLink{{path: "testdata/fs/i", target: "a"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "testdata/fs/i", "testdata/fs/a", "testdata"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkSkipSymlinksOutsideScope(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkSkipSymlinksOutsideScope") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + if err := makeFs(tmpdir, []dirOrLink{ + {path: "linkdir", target: "realdir"}, + {path: "linkdir/foo/bar"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "linkdir/foo/bar", "linkdir/foo/bar", "linkdir/foo"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkInvalidScopePathPair(t *testing.T) { + if _, err := FollowSymlinkInScope("toto", "testdata"); err == nil { + t.Fatal("expected an error") + } +} + +func TestFollowSymlinkLastLink(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkLastLink") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + if err := makeFs(tmpdir, []dirOrLink{{path: "testdata/fs/a/d", target: "/b"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "testdata/fs/a/d", "testdata/b", "testdata"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkRelativeLinkChangeScope(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkRelativeLinkChangeScope") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + if err := makeFs(tmpdir, []dirOrLink{{path: "testdata/fs/a/e", target: "../b"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "testdata/fs/a/e/c/data", "testdata/fs/b/c/data", "testdata"); err != nil { + t.Fatal(err) + } + // avoid letting allowing symlink e lead us to ../b + // normalize to the "testdata/fs/a" + if err := testSymlink(tmpdir, "testdata/fs/a/e", "testdata/fs/a/b", "testdata/fs/a"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkDeepRelativeLinkChangeScope(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkDeepRelativeLinkChangeScope") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{{path: "testdata/fs/a/f", target: "../../../../test"}}); err != nil { + t.Fatal(err) + } + // avoid letting symlink f lead us out of the "testdata" scope + // we don't normalize because symlink f is in scope and there is no + // information leak + if err := testSymlink(tmpdir, "testdata/fs/a/f", "testdata/test", "testdata"); err != nil { + t.Fatal(err) + } + // avoid letting symlink f lead us out of the "testdata/fs" scope + // we don't normalize because symlink f is in scope and there is no + // information leak + if err := testSymlink(tmpdir, "testdata/fs/a/f", "testdata/fs/test", "testdata/fs"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkRelativeLinkChain(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkRelativeLinkChain") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + // avoid letting symlink g (pointed at by symlink h) take out of scope + // TODO: we should probably normalize to scope here because ../[....]/root + // is out of scope and we leak information + if err := makeFs(tmpdir, []dirOrLink{ + {path: "testdata/fs/b/h", target: "../g"}, + {path: "testdata/fs/g", target: "../../../../../../../../../../../../root"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "testdata/fs/b/h", "testdata/root", "testdata"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkBreakoutPath(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkBreakoutPath") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + // avoid letting symlink -> ../directory/file escape from scope + // normalize to "testdata/fs/j" + if err := makeFs(tmpdir, []dirOrLink{{path: "testdata/fs/j/k", target: "../i/a"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "testdata/fs/j/k", "testdata/fs/j/i/a", "testdata/fs/j"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkToRoot(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkToRoot") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + // make sure we don't allow escaping to / + // normalize to dir + if err := makeFs(tmpdir, []dirOrLink{{path: "foo", target: "/"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "foo", "", ""); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkSlashDotdot(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkSlashDotdot") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + tmpdir = filepath.Join(tmpdir, "dir", "subdir") + + // make sure we don't allow escaping to / + // normalize to dir + if err := makeFs(tmpdir, []dirOrLink{{path: "foo", target: "/../../"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "foo", "", ""); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkDotdot(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkDotdot") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + tmpdir = filepath.Join(tmpdir, "dir", "subdir") + + // make sure we stay in scope without leaking information + // this also checks for escaping to / + // normalize to dir + if err := makeFs(tmpdir, []dirOrLink{{path: "foo", target: "../../"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "foo", "", ""); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkRelativePath2(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkRelativePath2") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{{path: "bar/foo", target: "baz/target"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "bar/foo", "bar/baz/target", ""); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkScopeLink(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkScopeLink") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{ + {path: "root2"}, + {path: "root", target: "root2"}, + {path: "root2/foo", target: "../bar"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "root/foo", "root/bar", "root"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkRootScope(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkRootScope") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + expected, err := filepath.EvalSymlinks(tmpdir) + if err != nil { + t.Fatal(err) + } + rewrite, err := FollowSymlinkInScope(tmpdir, "/") + if err != nil { + t.Fatal(err) + } + if rewrite != expected { + t.Fatalf("expected %q got %q", expected, rewrite) + } +} + +func TestFollowSymlinkEmpty(t *testing.T) { + res, err := FollowSymlinkInScope("", "") + if err != nil { + t.Fatal(err) + } + wd, err := os.Getwd() + if err != nil { + t.Fatal(err) + } + if res != wd { + t.Fatalf("expected %q got %q", wd, res) + } +} + +func TestFollowSymlinkCircular(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkCircular") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{{path: "root/foo", target: "foo"}}); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "root/foo", "", "root"); err == nil { + t.Fatal("expected an error for foo -> foo") + } + + if err := makeFs(tmpdir, []dirOrLink{ + {path: "root/bar", target: "baz"}, + {path: "root/baz", target: "../bak"}, + {path: "root/bak", target: "/bar"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "root/foo", "", "root"); err == nil { + t.Fatal("expected an error for bar -> baz -> bak -> bar") + } +} + +func TestFollowSymlinkComplexChainWithTargetPathsContainingLinks(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkComplexChainWithTargetPathsContainingLinks") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{ + {path: "root2"}, + {path: "root", target: "root2"}, + {path: "root/a", target: "r/s"}, + {path: "root/r", target: "../root/t"}, + {path: "root/root/t/s/b", target: "/../u"}, + {path: "root/u/c", target: "."}, + {path: "root/u/x/y", target: "../v"}, + {path: "root/u/v", target: "/../w"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "root/a/b/c/x/y/z", "root/w/z", "root"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkBreakoutNonExistent(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkBreakoutNonExistent") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{ + {path: "root/slash", target: "/"}, + {path: "root/sym", target: "/idontexist/../slash"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "root/sym/file", "root/file", "root"); err != nil { + t.Fatal(err) + } +} + +func TestFollowSymlinkNoLexicalCleaning(t *testing.T) { + tmpdir, err := ioutil.TempDir("", "TestFollowSymlinkNoLexicalCleaning") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpdir) + + if err := makeFs(tmpdir, []dirOrLink{ + {path: "root/sym", target: "/foo/bar"}, + {path: "root/hello", target: "/sym/../baz"}, + }); err != nil { + t.Fatal(err) + } + if err := testSymlink(tmpdir, "root/hello", "root/foo/baz", "root"); err != nil { + t.Fatal(err) + } +} diff --git a/pkg/symlink/fs_unix.go b/pkg/symlink/fs_unix.go new file mode 100644 index 0000000000..818004f26c --- /dev/null +++ b/pkg/symlink/fs_unix.go @@ -0,0 +1,11 @@ +// +build !windows + +package symlink + +import ( + "path/filepath" +) + +func evalSymlinks(path string) (string, error) { + return filepath.EvalSymlinks(path) +} diff --git a/pkg/symlink/fs_windows.go b/pkg/symlink/fs_windows.go new file mode 100644 index 0000000000..29bd456886 --- /dev/null +++ b/pkg/symlink/fs_windows.go @@ -0,0 +1,156 @@ +package symlink + +import ( + "bytes" + "errors" + "os" + "path/filepath" + "strings" + "syscall" + + "github.com/docker/docker/pkg/longpath" +) + +func toShort(path string) (string, error) { + p, err := syscall.UTF16FromString(path) + if err != nil { + return "", err + } + b := p // GetShortPathName says we can reuse buffer + n, err := syscall.GetShortPathName(&p[0], &b[0], uint32(len(b))) + if err != nil { + return "", err + } + if n > uint32(len(b)) { + b = make([]uint16, n) + n, err = syscall.GetShortPathName(&p[0], &b[0], uint32(len(b))) + if err != nil { + return "", err + } + } + return syscall.UTF16ToString(b), nil +} + +func toLong(path string) (string, error) { + p, err := syscall.UTF16FromString(path) + if err != nil { + return "", err + } + b := p // GetLongPathName says we can reuse buffer + n, err := syscall.GetLongPathName(&p[0], &b[0], uint32(len(b))) + if err != nil { + return "", err + } + if n > uint32(len(b)) { + b = make([]uint16, n) + n, err = syscall.GetLongPathName(&p[0], &b[0], uint32(len(b))) + if err != nil { + return "", err + } + } + b = b[:n] + return syscall.UTF16ToString(b), nil +} + +func evalSymlinks(path string) (string, error) { + path, err := walkSymlinks(path) + if err != nil { + return "", err + } + + p, err := toShort(path) + if err != nil { + return "", err + } + p, err = toLong(p) + if err != nil { + return "", err + } + // syscall.GetLongPathName does not change the case of the drive letter, + // but the result of EvalSymlinks must be unique, so we have + // EvalSymlinks(`c:\a`) == EvalSymlinks(`C:\a`). + // Make drive letter upper case. + if len(p) >= 2 && p[1] == ':' && 'a' <= p[0] && p[0] <= 'z' { + p = string(p[0]+'A'-'a') + p[1:] + } else if len(p) >= 6 && p[5] == ':' && 'a' <= p[4] && p[4] <= 'z' { + p = p[:3] + string(p[4]+'A'-'a') + p[5:] + } + return filepath.Clean(p), nil +} + +const utf8RuneSelf = 0x80 + +func walkSymlinks(path string) (string, error) { + const maxIter = 255 + originalPath := path + // consume path by taking each frontmost path element, + // expanding it if it's a symlink, and appending it to b + var b bytes.Buffer + for n := 0; path != ""; n++ { + if n > maxIter { + return "", errors.New("EvalSymlinks: too many links in " + originalPath) + } + + // A path beginnging with `\\?\` represents the root, so automatically + // skip that part and begin processing the next segment. + if strings.HasPrefix(path, longpath.Prefix) { + b.WriteString(longpath.Prefix) + path = path[4:] + continue + } + + // find next path component, p + var i = -1 + for j, c := range path { + if c < utf8RuneSelf && os.IsPathSeparator(uint8(c)) { + i = j + break + } + } + var p string + if i == -1 { + p, path = path, "" + } else { + p, path = path[:i], path[i+1:] + } + + if p == "" { + if b.Len() == 0 { + // must be absolute path + b.WriteRune(filepath.Separator) + } + continue + } + + // If this is the first segment after the long path prefix, accept the + // current segment as a volume root or UNC share and move on to the next. + if b.String() == longpath.Prefix { + b.WriteString(p) + b.WriteRune(filepath.Separator) + continue + } + + fi, err := os.Lstat(b.String() + p) + if err != nil { + return "", err + } + if fi.Mode()&os.ModeSymlink == 0 { + b.WriteString(p) + if path != "" || (b.Len() == 2 && len(p) == 2 && p[1] == ':') { + b.WriteRune(filepath.Separator) + } + continue + } + + // it's a symlink, put it at the front of path + dest, err := os.Readlink(b.String() + p) + if err != nil { + return "", err + } + if filepath.IsAbs(dest) || os.IsPathSeparator(dest[0]) { + b.Reset() + } + path = dest + string(filepath.Separator) + path + } + return filepath.Clean(b.String()), nil +} diff --git a/pkg/sysinfo/README.md b/pkg/sysinfo/README.md new file mode 100644 index 0000000000..c1530cef0d --- /dev/null +++ b/pkg/sysinfo/README.md @@ -0,0 +1 @@ +SysInfo stores information about which features a kernel supports. diff --git a/pkg/sysinfo/sysinfo.go b/pkg/sysinfo/sysinfo.go new file mode 100644 index 0000000000..851d176e4d --- /dev/null +++ b/pkg/sysinfo/sysinfo.go @@ -0,0 +1,105 @@ +package sysinfo + +import "github.com/docker/docker/pkg/parsers" + +// SysInfo stores information about which features a kernel supports. +// TODO Windows: Factor out platform specific capabilities. +type SysInfo struct { + // Whether the kernel supports AppArmor or not + AppArmor bool + + cgroupMemInfo + cgroupCPUInfo + cgroupBlkioInfo + cgroupCpusetInfo + + // Whether IPv4 forwarding is supported or not, if this was disabled, networking will not work + IPv4ForwardingDisabled bool + + // Whether bridge-nf-call-iptables is supported or not + BridgeNfCallIptablesDisabled bool + + // Whether bridge-nf-call-ip6tables is supported or not + BridgeNfCallIP6tablesDisabled bool + + // Whether the cgroup has the mountpoint of "devices" or not + CgroupDevicesEnabled bool +} + +type cgroupMemInfo struct { + // Whether memory limit is supported or not + MemoryLimit bool + + // Whether swap limit is supported or not + SwapLimit bool + + // Whether soft limit is supported or not + MemoryReservation bool + + // Whether OOM killer disalbe is supported or not + OomKillDisable bool + + // Whether memory swappiness is supported or not + MemorySwappiness bool + + // Whether kernel memory limit is supported or not + KernelMemory bool +} + +type cgroupCPUInfo struct { + // Whether CPU shares is supported or not + CPUShares bool + + // Whether CPU CFS(Completely Fair Scheduler) period is supported or not + CPUCfsPeriod bool + + // Whether CPU CFS(Completely Fair Scheduler) quota is supported or not + CPUCfsQuota bool +} + +type cgroupBlkioInfo struct { + // Whether Block IO weight is supported or not + BlkioWeight bool +} + +type cgroupCpusetInfo struct { + // Whether Cpuset is supported or not + Cpuset bool + + // Available Cpuset's cpus + Cpus string + + // Available Cpuset's memory nodes + Mems string +} + +// IsCpusetCpusAvailable returns `true` if the provided string set is contained +// in cgroup's cpuset.cpus set, `false` otherwise. +// If error is not nil a parsing error occurred. +func (c cgroupCpusetInfo) IsCpusetCpusAvailable(provided string) (bool, error) { + return isCpusetListAvailable(provided, c.Cpus) +} + +// IsCpusetMemsAvailable returns `true` if the provided string set is contained +// in cgroup's cpuset.mems set, `false` otherwise. +// If error is not nil a parsing error occurred. +func (c cgroupCpusetInfo) IsCpusetMemsAvailable(provided string) (bool, error) { + return isCpusetListAvailable(provided, c.Mems) +} + +func isCpusetListAvailable(provided, available string) (bool, error) { + parsedProvided, err := parsers.ParseUintList(provided) + if err != nil { + return false, err + } + parsedAvailable, err := parsers.ParseUintList(available) + if err != nil { + return false, err + } + for k := range parsedProvided { + if !parsedAvailable[k] { + return false, nil + } + } + return true, nil +} diff --git a/pkg/sysinfo/sysinfo_freebsd.go b/pkg/sysinfo/sysinfo_freebsd.go new file mode 100644 index 0000000000..22ae0d95a9 --- /dev/null +++ b/pkg/sysinfo/sysinfo_freebsd.go @@ -0,0 +1,7 @@ +package sysinfo + +// New returns an empty SysInfo for freebsd for now. +func New(quiet bool) *SysInfo { + sysInfo := &SysInfo{} + return sysInfo +} diff --git a/pkg/sysinfo/sysinfo_linux.go b/pkg/sysinfo/sysinfo_linux.go new file mode 100644 index 0000000000..0ef3fbd858 --- /dev/null +++ b/pkg/sysinfo/sysinfo_linux.go @@ -0,0 +1,165 @@ +package sysinfo + +import ( + "io/ioutil" + "os" + "path" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/opencontainers/runc/libcontainer/cgroups" +) + +// New returns a new SysInfo, using the filesystem to detect which features +// the kernel supports. If `quiet` is `false` warnings are printed in logs +// whenever an error occurs or misconfigurations are present. +func New(quiet bool) *SysInfo { + sysInfo := &SysInfo{} + sysInfo.cgroupMemInfo = checkCgroupMem(quiet) + sysInfo.cgroupCPUInfo = checkCgroupCPU(quiet) + sysInfo.cgroupBlkioInfo = checkCgroupBlkioInfo(quiet) + sysInfo.cgroupCpusetInfo = checkCgroupCpusetInfo(quiet) + + _, err := cgroups.FindCgroupMountpoint("devices") + sysInfo.CgroupDevicesEnabled = err == nil + + sysInfo.IPv4ForwardingDisabled = !readProcBool("/proc/sys/net/ipv4/ip_forward") + sysInfo.BridgeNfCallIptablesDisabled = !readProcBool("/proc/sys/net/bridge/bridge-nf-call-iptables") + sysInfo.BridgeNfCallIP6tablesDisabled = !readProcBool("/proc/sys/net/bridge/bridge-nf-call-ip6tables") + + // Check if AppArmor is supported. + if _, err := os.Stat("/sys/kernel/security/apparmor"); !os.IsNotExist(err) { + sysInfo.AppArmor = true + } + + return sysInfo +} + +// checkCgroupMem reads the memory information from the memory cgroup mount point. +func checkCgroupMem(quiet bool) cgroupMemInfo { + mountPoint, err := cgroups.FindCgroupMountpoint("memory") + if err != nil { + if !quiet { + logrus.Warnf("Your kernel does not support cgroup memory limit: %v", err) + } + return cgroupMemInfo{} + } + + swapLimit := cgroupEnabled(mountPoint, "memory.memsw.limit_in_bytes") + if !quiet && !swapLimit { + logrus.Warn("Your kernel does not support swap memory limit.") + } + memoryReservation := cgroupEnabled(mountPoint, "memory.soft_limit_in_bytes") + if !quiet && !memoryReservation { + logrus.Warn("Your kernel does not support memory reservation.") + } + oomKillDisable := cgroupEnabled(mountPoint, "memory.oom_control") + if !quiet && !oomKillDisable { + logrus.Warnf("Your kernel does not support oom control.") + } + memorySwappiness := cgroupEnabled(mountPoint, "memory.swappiness") + if !quiet && !memorySwappiness { + logrus.Warnf("Your kernel does not support memory swappiness.") + } + kernelMemory := cgroupEnabled(mountPoint, "memory.kmem.limit_in_bytes") + if !quiet && !kernelMemory { + logrus.Warnf("Your kernel does not support kernel memory limit.") + } + + return cgroupMemInfo{ + MemoryLimit: true, + SwapLimit: swapLimit, + MemoryReservation: memoryReservation, + OomKillDisable: oomKillDisable, + MemorySwappiness: memorySwappiness, + KernelMemory: kernelMemory, + } +} + +// checkCgroupCPU reads the cpu information from the cpu cgroup mount point. +func checkCgroupCPU(quiet bool) cgroupCPUInfo { + mountPoint, err := cgroups.FindCgroupMountpoint("cpu") + if err != nil { + if !quiet { + logrus.Warn(err) + } + return cgroupCPUInfo{} + } + + cpuShares := cgroupEnabled(mountPoint, "cpu.shares") + if !quiet && !cpuShares { + logrus.Warn("Your kernel does not support cgroup cpu shares") + } + + cpuCfsPeriod := cgroupEnabled(mountPoint, "cpu.cfs_period_us") + if !quiet && !cpuCfsPeriod { + logrus.Warn("Your kernel does not support cgroup cfs period") + } + + cpuCfsQuota := cgroupEnabled(mountPoint, "cpu.cfs_quota_us") + if !quiet && !cpuCfsQuota { + logrus.Warn("Your kernel does not support cgroup cfs quotas") + } + return cgroupCPUInfo{ + CPUShares: cpuShares, + CPUCfsPeriod: cpuCfsPeriod, + CPUCfsQuota: cpuCfsQuota, + } +} + +// checkCgroupBlkioInfo reads the blkio information from the blkio cgroup mount point. +func checkCgroupBlkioInfo(quiet bool) cgroupBlkioInfo { + mountPoint, err := cgroups.FindCgroupMountpoint("blkio") + if err != nil { + if !quiet { + logrus.Warn(err) + } + return cgroupBlkioInfo{} + } + + w := cgroupEnabled(mountPoint, "blkio.weight") + if !quiet && !w { + logrus.Warn("Your kernel does not support cgroup blkio weight") + } + return cgroupBlkioInfo{BlkioWeight: w} +} + +// checkCgroupCpusetInfo reads the cpuset information from the cpuset cgroup mount point. +func checkCgroupCpusetInfo(quiet bool) cgroupCpusetInfo { + mountPoint, err := cgroups.FindCgroupMountpoint("cpuset") + if err != nil { + if !quiet { + logrus.Warn(err) + } + return cgroupCpusetInfo{} + } + + cpus, err := ioutil.ReadFile(path.Join(mountPoint, "cpuset.cpus")) + if err != nil { + return cgroupCpusetInfo{} + } + + mems, err := ioutil.ReadFile(path.Join(mountPoint, "cpuset.mems")) + if err != nil { + return cgroupCpusetInfo{} + } + + return cgroupCpusetInfo{ + Cpuset: true, + Cpus: strings.TrimSpace(string(cpus)), + Mems: strings.TrimSpace(string(mems)), + } +} + +func cgroupEnabled(mountPoint, name string) bool { + _, err := os.Stat(path.Join(mountPoint, name)) + return err == nil +} + +func readProcBool(path string) bool { + val, err := ioutil.ReadFile(path) + if err != nil { + return false + } + return strings.TrimSpace(string(val)) == "1" +} diff --git a/pkg/sysinfo/sysinfo_linux_test.go b/pkg/sysinfo/sysinfo_linux_test.go new file mode 100644 index 0000000000..fae0fdffbb --- /dev/null +++ b/pkg/sysinfo/sysinfo_linux_test.go @@ -0,0 +1,58 @@ +package sysinfo + +import ( + "io/ioutil" + "os" + "path" + "path/filepath" + "testing" +) + +func TestReadProcBool(t *testing.T) { + tmpDir, err := ioutil.TempDir("", "test-sysinfo-proc") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpDir) + + procFile := filepath.Join(tmpDir, "read-proc-bool") + if err := ioutil.WriteFile(procFile, []byte("1"), 644); err != nil { + t.Fatal(err) + } + + if !readProcBool(procFile) { + t.Fatal("expected proc bool to be true, got false") + } + + if err := ioutil.WriteFile(procFile, []byte("0"), 644); err != nil { + t.Fatal(err) + } + if readProcBool(procFile) { + t.Fatal("expected proc bool to be false, got false") + } + + if readProcBool(path.Join(tmpDir, "no-exist")) { + t.Fatal("should be false for non-existent entry") + } + +} + +func TestCgroupEnabled(t *testing.T) { + cgroupDir, err := ioutil.TempDir("", "cgroup-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(cgroupDir) + + if cgroupEnabled(cgroupDir, "test") { + t.Fatal("cgroupEnabled should be false") + } + + if err := ioutil.WriteFile(path.Join(cgroupDir, "test"), []byte{}, 644); err != nil { + t.Fatal(err) + } + + if !cgroupEnabled(cgroupDir, "test") { + t.Fatal("cgroupEnabled should be true") + } +} diff --git a/pkg/sysinfo/sysinfo_test.go b/pkg/sysinfo/sysinfo_test.go new file mode 100644 index 0000000000..b61fbcf541 --- /dev/null +++ b/pkg/sysinfo/sysinfo_test.go @@ -0,0 +1,26 @@ +package sysinfo + +import "testing" + +func TestIsCpusetListAvailable(t *testing.T) { + cases := []struct { + provided string + available string + res bool + err bool + }{ + {"1", "0-4", true, false}, + {"01,3", "0-4", true, false}, + {"", "0-7", true, false}, + {"1--42", "0-7", false, true}, + {"1-42", "00-1,8,,9", false, true}, + {"1,41-42", "43,45", false, false}, + {"0-3", "", false, false}, + } + for _, c := range cases { + r, err := isCpusetListAvailable(c.provided, c.available) + if (c.err && err == nil) && r != c.res { + t.Fatalf("Expected pair: %v, %v for %s, %s. Got %v, %v instead", c.res, c.err, c.provided, c.available, (c.err && err == nil), r) + } + } +} diff --git a/pkg/sysinfo/sysinfo_windows.go b/pkg/sysinfo/sysinfo_windows.go new file mode 100644 index 0000000000..8889318c39 --- /dev/null +++ b/pkg/sysinfo/sysinfo_windows.go @@ -0,0 +1,7 @@ +package sysinfo + +// New returns an empty SysInfo for windows for now. +func New(quiet bool) *SysInfo { + sysInfo := &SysInfo{} + return sysInfo +} diff --git a/pkg/system/chtimes.go b/pkg/system/chtimes.go new file mode 100644 index 0000000000..31ed9ff100 --- /dev/null +++ b/pkg/system/chtimes.go @@ -0,0 +1,31 @@ +package system + +import ( + "os" + "time" +) + +// Chtimes changes the access time and modified time of a file at the given path +func Chtimes(name string, atime time.Time, mtime time.Time) error { + unixMinTime := time.Unix(0, 0) + // The max Unix time is 33 bits set + unixMaxTime := unixMinTime.Add((1<<33 - 1) * time.Second) + + // If the modified time is prior to the Unix Epoch, or after the + // end of Unix Time, os.Chtimes has undefined behavior + // default to Unix Epoch in this case, just in case + + if atime.Before(unixMinTime) || atime.After(unixMaxTime) { + atime = unixMinTime + } + + if mtime.Before(unixMinTime) || mtime.After(unixMaxTime) { + mtime = unixMinTime + } + + if err := os.Chtimes(name, atime, mtime); err != nil { + return err + } + + return nil +} diff --git a/pkg/system/chtimes_test.go b/pkg/system/chtimes_test.go new file mode 100644 index 0000000000..f65a4b8073 --- /dev/null +++ b/pkg/system/chtimes_test.go @@ -0,0 +1,120 @@ +package system + +import ( + "io/ioutil" + "os" + "path/filepath" + "testing" + "time" +) + +// prepareTempFile creates a temporary file in a temporary directory. +func prepareTempFile(t *testing.T) (string, string) { + dir, err := ioutil.TempDir("", "docker-system-test") + if err != nil { + t.Fatal(err) + } + + file := filepath.Join(dir, "exist") + if err := ioutil.WriteFile(file, []byte("hello"), 0644); err != nil { + t.Fatal(err) + } + return file, dir +} + +// TestChtimes tests Chtimes on a tempfile. Test only mTime, because aTime is OS dependent +func TestChtimes(t *testing.T) { + file, dir := prepareTempFile(t) + defer os.RemoveAll(dir) + + beforeUnixEpochTime := time.Unix(0, 0).Add(-100 * time.Second) + unixEpochTime := time.Unix(0, 0) + afterUnixEpochTime := time.Unix(100, 0) + // The max Unix time is 33 bits set + unixMaxTime := unixEpochTime.Add((1<<33 - 1) * time.Second) + afterUnixMaxTime := unixMaxTime.Add(100 * time.Second) + + // Test both aTime and mTime set to Unix Epoch + Chtimes(file, unixEpochTime, unixEpochTime) + + f, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, f.ModTime()) + } + + // Test aTime before Unix Epoch and mTime set to Unix Epoch + Chtimes(file, beforeUnixEpochTime, unixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, f.ModTime()) + } + + // Test aTime set to Unix Epoch and mTime before Unix Epoch + Chtimes(file, unixEpochTime, beforeUnixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, f.ModTime()) + } + + // Test both aTime and mTime set to after Unix Epoch (valid time) + Chtimes(file, afterUnixEpochTime, afterUnixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != afterUnixEpochTime { + t.Fatalf("Expected: %s, got: %s", afterUnixEpochTime, f.ModTime()) + } + + // Test both aTime and mTime set to Unix max time + Chtimes(file, unixMaxTime, unixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != unixMaxTime { + t.Fatalf("Expected: %s, got: %s", unixMaxTime, f.ModTime()) + } + + // Test aTime after Unix max time and mTime set to Unix max time + Chtimes(file, afterUnixMaxTime, unixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != unixMaxTime { + t.Fatalf("Expected: %s, got: %s", unixMaxTime, f.ModTime()) + } + + // Test aTime set to Unix Epoch and mTime before Unix Epoch + Chtimes(file, unixMaxTime, afterUnixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + if f.ModTime() != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, f.ModTime()) + } +} diff --git a/pkg/system/chtimes_unix_test.go b/pkg/system/chtimes_unix_test.go new file mode 100644 index 0000000000..6998bbef5d --- /dev/null +++ b/pkg/system/chtimes_unix_test.go @@ -0,0 +1,121 @@ +// +build linux freebsd + +package system + +import ( + "os" + "syscall" + "testing" + "time" +) + +// TestChtimes tests Chtimes access time on a tempfile on Linux +func TestChtimesLinux(t *testing.T) { + file, dir := prepareTempFile(t) + defer os.RemoveAll(dir) + + beforeUnixEpochTime := time.Unix(0, 0).Add(-100 * time.Second) + unixEpochTime := time.Unix(0, 0) + afterUnixEpochTime := time.Unix(100, 0) + // The max Unix time is 33 bits set + unixMaxTime := unixEpochTime.Add((1<<33 - 1) * time.Second) + afterUnixMaxTime := unixMaxTime.Add(100 * time.Second) + + // Test both aTime and mTime set to Unix Epoch + Chtimes(file, unixEpochTime, unixEpochTime) + + f, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat := f.Sys().(*syscall.Stat_t) + aTime := time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test aTime before Unix Epoch and mTime set to Unix Epoch + Chtimes(file, beforeUnixEpochTime, unixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat = f.Sys().(*syscall.Stat_t) + aTime = time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test aTime set to Unix Epoch and mTime before Unix Epoch + Chtimes(file, unixEpochTime, beforeUnixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat = f.Sys().(*syscall.Stat_t) + aTime = time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test both aTime and mTime set to after Unix Epoch (valid time) + Chtimes(file, afterUnixEpochTime, afterUnixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat = f.Sys().(*syscall.Stat_t) + aTime = time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != afterUnixEpochTime { + t.Fatalf("Expected: %s, got: %s", afterUnixEpochTime, aTime) + } + + // Test both aTime and mTime set to Unix max time + Chtimes(file, unixMaxTime, unixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat = f.Sys().(*syscall.Stat_t) + aTime = time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != unixMaxTime { + t.Fatalf("Expected: %s, got: %s", unixMaxTime, aTime) + } + + // Test aTime after Unix max time and mTime set to Unix max time + Chtimes(file, afterUnixMaxTime, unixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat = f.Sys().(*syscall.Stat_t) + aTime = time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test aTime set to Unix Epoch and mTime before Unix Epoch + Chtimes(file, unixMaxTime, afterUnixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + stat = f.Sys().(*syscall.Stat_t) + aTime = time.Unix(int64(stat.Atim.Sec), int64(stat.Atim.Nsec)) + if aTime != unixMaxTime { + t.Fatalf("Expected: %s, got: %s", unixMaxTime, aTime) + } +} diff --git a/pkg/system/chtimes_windows_test.go b/pkg/system/chtimes_windows_test.go new file mode 100644 index 0000000000..f09c402847 --- /dev/null +++ b/pkg/system/chtimes_windows_test.go @@ -0,0 +1,114 @@ +// +build windows + +package system + +import ( + "os" + "syscall" + "testing" + "time" +) + +// TestChtimes tests Chtimes access time on a tempfile on Windows +func TestChtimesWindows(t *testing.T) { + file, dir := prepareTempFile(t) + defer os.RemoveAll(dir) + + beforeUnixEpochTime := time.Unix(0, 0).Add(-100 * time.Second) + unixEpochTime := time.Unix(0, 0) + afterUnixEpochTime := time.Unix(100, 0) + // The max Unix time is 33 bits set + unixMaxTime := unixEpochTime.Add((1<<33 - 1) * time.Second) + afterUnixMaxTime := unixMaxTime.Add(100 * time.Second) + + // Test both aTime and mTime set to Unix Epoch + Chtimes(file, unixEpochTime, unixEpochTime) + + f, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime := time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test aTime before Unix Epoch and mTime set to Unix Epoch + Chtimes(file, beforeUnixEpochTime, unixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime = time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test aTime set to Unix Epoch and mTime before Unix Epoch + Chtimes(file, unixEpochTime, beforeUnixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime = time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test both aTime and mTime set to after Unix Epoch (valid time) + Chtimes(file, afterUnixEpochTime, afterUnixEpochTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime = time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != afterUnixEpochTime { + t.Fatalf("Expected: %s, got: %s", afterUnixEpochTime, aTime) + } + + // Test both aTime and mTime set to Unix max time + Chtimes(file, unixMaxTime, unixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime = time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != unixMaxTime { + t.Fatalf("Expected: %s, got: %s", unixMaxTime, aTime) + } + + // Test aTime after Unix max time and mTime set to Unix max time + Chtimes(file, afterUnixMaxTime, unixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime = time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != unixEpochTime { + t.Fatalf("Expected: %s, got: %s", unixEpochTime, aTime) + } + + // Test aTime set to Unix Epoch and mTime before Unix Epoch + Chtimes(file, unixMaxTime, afterUnixMaxTime) + + f, err = os.Stat(file) + if err != nil { + t.Fatal(err) + } + + aTime = time.Unix(0, f.Sys().(*syscall.Win32FileAttributeData).LastAccessTime.Nanoseconds()) + if aTime != unixMaxTime { + t.Fatalf("Expected: %s, got: %s", unixMaxTime, aTime) + } +} diff --git a/pkg/system/errors.go b/pkg/system/errors.go new file mode 100644 index 0000000000..288318985e --- /dev/null +++ b/pkg/system/errors.go @@ -0,0 +1,10 @@ +package system + +import ( + "errors" +) + +var ( + // ErrNotSupportedPlatform means the platform is not supported. + ErrNotSupportedPlatform = errors.New("platform and architecture is not supported") +) diff --git a/pkg/system/events_windows.go b/pkg/system/events_windows.go new file mode 100644 index 0000000000..04e2de7871 --- /dev/null +++ b/pkg/system/events_windows.go @@ -0,0 +1,83 @@ +package system + +// This file implements syscalls for Win32 events which are not implemented +// in golang. + +import ( + "syscall" + "unsafe" +) + +var ( + procCreateEvent = modkernel32.NewProc("CreateEventW") + procOpenEvent = modkernel32.NewProc("OpenEventW") + procSetEvent = modkernel32.NewProc("SetEvent") + procResetEvent = modkernel32.NewProc("ResetEvent") + procPulseEvent = modkernel32.NewProc("PulseEvent") +) + +// CreateEvent implements win32 CreateEventW func in golang. It will create an event object. +func CreateEvent(eventAttributes *syscall.SecurityAttributes, manualReset bool, initialState bool, name string) (handle syscall.Handle, err error) { + namep, _ := syscall.UTF16PtrFromString(name) + var _p1 uint32 + if manualReset { + _p1 = 1 + } + var _p2 uint32 + if initialState { + _p2 = 1 + } + r0, _, e1 := procCreateEvent.Call(uintptr(unsafe.Pointer(eventAttributes)), uintptr(_p1), uintptr(_p2), uintptr(unsafe.Pointer(namep))) + use(unsafe.Pointer(namep)) + handle = syscall.Handle(r0) + if handle == syscall.InvalidHandle { + err = e1 + } + return +} + +// OpenEvent implements win32 OpenEventW func in golang. It opens an event object. +func OpenEvent(desiredAccess uint32, inheritHandle bool, name string) (handle syscall.Handle, err error) { + namep, _ := syscall.UTF16PtrFromString(name) + var _p1 uint32 + if inheritHandle { + _p1 = 1 + } + r0, _, e1 := procOpenEvent.Call(uintptr(desiredAccess), uintptr(_p1), uintptr(unsafe.Pointer(namep))) + use(unsafe.Pointer(namep)) + handle = syscall.Handle(r0) + if handle == syscall.InvalidHandle { + err = e1 + } + return +} + +// SetEvent implements win32 SetEvent func in golang. +func SetEvent(handle syscall.Handle) (err error) { + return setResetPulse(handle, procSetEvent) +} + +// ResetEvent implements win32 ResetEvent func in golang. +func ResetEvent(handle syscall.Handle) (err error) { + return setResetPulse(handle, procResetEvent) +} + +// PulseEvent implements win32 PulseEvent func in golang. +func PulseEvent(handle syscall.Handle) (err error) { + return setResetPulse(handle, procPulseEvent) +} + +func setResetPulse(handle syscall.Handle, proc *syscall.LazyProc) (err error) { + r0, _, _ := proc.Call(uintptr(handle)) + if r0 != 0 { + err = syscall.Errno(r0) + } + return +} + +var temp unsafe.Pointer + +// use ensures a variable is kept alive without the GC freeing while still needed +func use(p unsafe.Pointer) { + temp = p +} diff --git a/pkg/system/filesys.go b/pkg/system/filesys.go new file mode 100644 index 0000000000..c14feb8496 --- /dev/null +++ b/pkg/system/filesys.go @@ -0,0 +1,19 @@ +// +build !windows + +package system + +import ( + "os" + "path/filepath" +) + +// MkdirAll creates a directory named path along with any necessary parents, +// with permission specified by attribute perm for all dir created. +func MkdirAll(path string, perm os.FileMode) error { + return os.MkdirAll(path, perm) +} + +// IsAbs is a platform-specific wrapper for filepath.IsAbs. +func IsAbs(path string) bool { + return filepath.IsAbs(path) +} diff --git a/pkg/system/filesys_windows.go b/pkg/system/filesys_windows.go new file mode 100644 index 0000000000..16823d5517 --- /dev/null +++ b/pkg/system/filesys_windows.go @@ -0,0 +1,82 @@ +// +build windows + +package system + +import ( + "os" + "path/filepath" + "regexp" + "strings" + "syscall" +) + +// MkdirAll implementation that is volume path aware for Windows. +func MkdirAll(path string, perm os.FileMode) error { + if re := regexp.MustCompile(`^\\\\\?\\Volume{[a-z0-9-]+}$`); re.MatchString(path) { + return nil + } + + // The rest of this method is copied from os.MkdirAll and should be kept + // as-is to ensure compatibility. + + // Fast path: if we can tell whether path is a directory or file, stop with success or error. + dir, err := os.Stat(path) + if err == nil { + if dir.IsDir() { + return nil + } + return &os.PathError{ + Op: "mkdir", + Path: path, + Err: syscall.ENOTDIR, + } + } + + // Slow path: make sure parent exists and then call Mkdir for path. + i := len(path) + for i > 0 && os.IsPathSeparator(path[i-1]) { // Skip trailing path separator. + i-- + } + + j := i + for j > 0 && !os.IsPathSeparator(path[j-1]) { // Scan backward over element. + j-- + } + + if j > 1 { + // Create parent + err = MkdirAll(path[0:j-1], perm) + if err != nil { + return err + } + } + + // Parent now exists; invoke Mkdir and use its result. + err = os.Mkdir(path, perm) + if err != nil { + // Handle arguments like "foo/." by + // double-checking that directory doesn't exist. + dir, err1 := os.Lstat(path) + if err1 == nil && dir.IsDir() { + return nil + } + return err + } + return nil +} + +// IsAbs is a platform-specific wrapper for filepath.IsAbs. On Windows, +// golang filepath.IsAbs does not consider a path \windows\system32 as absolute +// as it doesn't start with a drive-letter/colon combination. However, in +// docker we need to verify things such as WORKDIR /windows/system32 in +// a Dockerfile (which gets translated to \windows\system32 when being processed +// by the daemon. This SHOULD be treated as absolute from a docker processing +// perspective. +func IsAbs(path string) bool { + if !filepath.IsAbs(path) { + if !strings.HasPrefix(path, string(os.PathSeparator)) { + return false + } + } + return true +} diff --git a/pkg/system/lstat.go b/pkg/system/lstat.go new file mode 100644 index 0000000000..bd23c4d50b --- /dev/null +++ b/pkg/system/lstat.go @@ -0,0 +1,19 @@ +// +build !windows + +package system + +import ( + "syscall" +) + +// Lstat takes a path to a file and returns +// a system.StatT type pertaining to that file. +// +// Throws an error if the file does not exist +func Lstat(path string) (*StatT, error) { + s := &syscall.Stat_t{} + if err := syscall.Lstat(path, s); err != nil { + return nil, err + } + return fromStatT(s) +} diff --git a/pkg/system/lstat_unix_test.go b/pkg/system/lstat_unix_test.go new file mode 100644 index 0000000000..062cf53bfe --- /dev/null +++ b/pkg/system/lstat_unix_test.go @@ -0,0 +1,30 @@ +// +build linux freebsd + +package system + +import ( + "os" + "testing" +) + +// TestLstat tests Lstat for existing and non existing files +func TestLstat(t *testing.T) { + file, invalid, _, dir := prepareFiles(t) + defer os.RemoveAll(dir) + + statFile, err := Lstat(file) + if err != nil { + t.Fatal(err) + } + if statFile == nil { + t.Fatal("returned empty stat for existing file") + } + + statInvalid, err := Lstat(invalid) + if err == nil { + t.Fatal("did not return error for non-existing file") + } + if statInvalid != nil { + t.Fatal("returned non-nil stat for non-existing file") + } +} diff --git a/pkg/system/lstat_windows.go b/pkg/system/lstat_windows.go new file mode 100644 index 0000000000..49e87eb40b --- /dev/null +++ b/pkg/system/lstat_windows.go @@ -0,0 +1,25 @@ +// +build windows + +package system + +import ( + "os" +) + +// Lstat calls os.Lstat to get a fileinfo interface back. +// This is then copied into our own locally defined structure. +// Note the Linux version uses fromStatT to do the copy back, +// but that not strictly necessary when already in an OS specific module. +func Lstat(path string) (*StatT, error) { + fi, err := os.Lstat(path) + if err != nil { + return nil, err + } + + return &StatT{ + name: fi.Name(), + size: fi.Size(), + mode: fi.Mode(), + modTime: fi.ModTime(), + isDir: fi.IsDir()}, nil +} diff --git a/pkg/system/meminfo.go b/pkg/system/meminfo.go new file mode 100644 index 0000000000..3b6e947e67 --- /dev/null +++ b/pkg/system/meminfo.go @@ -0,0 +1,17 @@ +package system + +// MemInfo contains memory statistics of the host system. +type MemInfo struct { + // Total usable RAM (i.e. physical RAM minus a few reserved bits and the + // kernel binary code). + MemTotal int64 + + // Amount of free memory. + MemFree int64 + + // Total amount of swap space available. + SwapTotal int64 + + // Amount of swap space that is currently unused. + SwapFree int64 +} diff --git a/pkg/system/meminfo_linux.go b/pkg/system/meminfo_linux.go new file mode 100644 index 0000000000..a07bb17cbc --- /dev/null +++ b/pkg/system/meminfo_linux.go @@ -0,0 +1,66 @@ +package system + +import ( + "bufio" + "io" + "os" + "strconv" + "strings" + + "github.com/docker/docker/pkg/units" +) + +// ReadMemInfo retrieves memory statistics of the host system and returns a +// MemInfo type. +func ReadMemInfo() (*MemInfo, error) { + file, err := os.Open("/proc/meminfo") + if err != nil { + return nil, err + } + defer file.Close() + return parseMemInfo(file) +} + +// parseMemInfo parses the /proc/meminfo file into +// a MemInfo object given a io.Reader to the file. +// +// Throws error if there are problems reading from the file +func parseMemInfo(reader io.Reader) (*MemInfo, error) { + meminfo := &MemInfo{} + scanner := bufio.NewScanner(reader) + for scanner.Scan() { + // Expected format: ["MemTotal:", "1234", "kB"] + parts := strings.Fields(scanner.Text()) + + // Sanity checks: Skip malformed entries. + if len(parts) < 3 || parts[2] != "kB" { + continue + } + + // Convert to bytes. + size, err := strconv.Atoi(parts[1]) + if err != nil { + continue + } + bytes := int64(size) * units.KiB + + switch parts[0] { + case "MemTotal:": + meminfo.MemTotal = bytes + case "MemFree:": + meminfo.MemFree = bytes + case "SwapTotal:": + meminfo.SwapTotal = bytes + case "SwapFree:": + meminfo.SwapFree = bytes + } + + } + + // Handle errors that may have occurred during the reading of the file. + if err := scanner.Err(); err != nil { + return nil, err + } + + return meminfo, nil +} diff --git a/pkg/system/meminfo_unix_test.go b/pkg/system/meminfo_unix_test.go new file mode 100644 index 0000000000..c8fec6298a --- /dev/null +++ b/pkg/system/meminfo_unix_test.go @@ -0,0 +1,40 @@ +// +build linux freebsd + +package system + +import ( + "strings" + "testing" + + "github.com/docker/docker/pkg/units" +) + +// TestMemInfo tests parseMemInfo with a static meminfo string +func TestMemInfo(t *testing.T) { + const input = ` + MemTotal: 1 kB + MemFree: 2 kB + SwapTotal: 3 kB + SwapFree: 4 kB + Malformed1: + Malformed2: 1 + Malformed3: 2 MB + Malformed4: X kB + ` + meminfo, err := parseMemInfo(strings.NewReader(input)) + if err != nil { + t.Fatal(err) + } + if meminfo.MemTotal != 1*units.KiB { + t.Fatalf("Unexpected MemTotal: %d", meminfo.MemTotal) + } + if meminfo.MemFree != 2*units.KiB { + t.Fatalf("Unexpected MemFree: %d", meminfo.MemFree) + } + if meminfo.SwapTotal != 3*units.KiB { + t.Fatalf("Unexpected SwapTotal: %d", meminfo.SwapTotal) + } + if meminfo.SwapFree != 4*units.KiB { + t.Fatalf("Unexpected SwapFree: %d", meminfo.SwapFree) + } +} diff --git a/pkg/system/meminfo_unsupported.go b/pkg/system/meminfo_unsupported.go new file mode 100644 index 0000000000..82ddd30c1b --- /dev/null +++ b/pkg/system/meminfo_unsupported.go @@ -0,0 +1,8 @@ +// +build !linux,!windows + +package system + +// ReadMemInfo is not supported on platforms other than linux and windows. +func ReadMemInfo() (*MemInfo, error) { + return nil, ErrNotSupportedPlatform +} diff --git a/pkg/system/meminfo_windows.go b/pkg/system/meminfo_windows.go new file mode 100644 index 0000000000..d46642598c --- /dev/null +++ b/pkg/system/meminfo_windows.go @@ -0,0 +1,44 @@ +package system + +import ( + "syscall" + "unsafe" +) + +var ( + modkernel32 = syscall.NewLazyDLL("kernel32.dll") + + procGlobalMemoryStatusEx = modkernel32.NewProc("GlobalMemoryStatusEx") +) + +// https://msdn.microsoft.com/en-us/library/windows/desktop/aa366589(v=vs.85).aspx +// https://msdn.microsoft.com/en-us/library/windows/desktop/aa366770(v=vs.85).aspx +type memorystatusex struct { + dwLength uint32 + dwMemoryLoad uint32 + ullTotalPhys uint64 + ullAvailPhys uint64 + ullTotalPageFile uint64 + ullAvailPageFile uint64 + ullTotalVirtual uint64 + ullAvailVirtual uint64 + ullAvailExtendedVirtual uint64 +} + +// ReadMemInfo retrieves memory statistics of the host system and returns a +// MemInfo type. +func ReadMemInfo() (*MemInfo, error) { + msi := &memorystatusex{ + dwLength: 64, + } + r1, _, _ := procGlobalMemoryStatusEx.Call(uintptr(unsafe.Pointer(msi))) + if r1 == 0 { + return &MemInfo{}, nil + } + return &MemInfo{ + MemTotal: int64(msi.ullTotalPhys), + MemFree: int64(msi.ullAvailPhys), + SwapTotal: int64(msi.ullTotalPageFile), + SwapFree: int64(msi.ullAvailPageFile), + }, nil +} diff --git a/pkg/system/mknod.go b/pkg/system/mknod.go new file mode 100644 index 0000000000..73958182b4 --- /dev/null +++ b/pkg/system/mknod.go @@ -0,0 +1,22 @@ +// +build !windows + +package system + +import ( + "syscall" +) + +// Mknod creates a filesystem node (file, device special file or named pipe) named path +// with attributes specified by mode and dev. +func Mknod(path string, mode uint32, dev int) error { + return syscall.Mknod(path, mode, dev) +} + +// Mkdev is used to build the value of linux devices (in /dev/) which specifies major +// and minor number of the newly created device special file. +// Linux device nodes are a bit weird due to backwards compat with 16 bit device nodes. +// They are, from low to high: the lower 8 bits of the minor, then 12 bits of the major, +// then the top 12 bits of the minor. +func Mkdev(major int64, minor int64) uint32 { + return uint32(((minor & 0xfff00) << 12) | ((major & 0xfff) << 8) | (minor & 0xff)) +} diff --git a/pkg/system/mknod_windows.go b/pkg/system/mknod_windows.go new file mode 100644 index 0000000000..2e863c0215 --- /dev/null +++ b/pkg/system/mknod_windows.go @@ -0,0 +1,13 @@ +// +build windows + +package system + +// Mknod is not implemented on Windows. +func Mknod(path string, mode uint32, dev int) error { + return ErrNotSupportedPlatform +} + +// Mkdev is not implemented on Windows. +func Mkdev(major int64, minor int64) uint32 { + panic("Mkdev not implemented on Windows.") +} diff --git a/pkg/system/stat.go b/pkg/system/stat.go new file mode 100644 index 0000000000..087034c5ec --- /dev/null +++ b/pkg/system/stat.go @@ -0,0 +1,53 @@ +// +build !windows + +package system + +import ( + "syscall" +) + +// StatT type contains status of a file. It contains metadata +// like permission, owner, group, size, etc about a file. +type StatT struct { + mode uint32 + uid uint32 + gid uint32 + rdev uint64 + size int64 + mtim syscall.Timespec +} + +// Mode returns file's permission mode. +func (s StatT) Mode() uint32 { + return s.mode +} + +// UID returns file's user id of owner. +func (s StatT) UID() uint32 { + return s.uid +} + +// GID returns file's group id of owner. +func (s StatT) GID() uint32 { + return s.gid +} + +// Rdev returns file's device ID (if it's special file). +func (s StatT) Rdev() uint64 { + return s.rdev +} + +// Size returns file's size. +func (s StatT) Size() int64 { + return s.size +} + +// Mtim returns file's last modification time. +func (s StatT) Mtim() syscall.Timespec { + return s.mtim +} + +// GetLastModification returns file's last modification time. +func (s StatT) GetLastModification() syscall.Timespec { + return s.Mtim() +} diff --git a/pkg/system/stat_freebsd.go b/pkg/system/stat_freebsd.go new file mode 100644 index 0000000000..d0fb6f1519 --- /dev/null +++ b/pkg/system/stat_freebsd.go @@ -0,0 +1,27 @@ +package system + +import ( + "syscall" +) + +// fromStatT converts a syscall.Stat_t type to a system.Stat_t type +func fromStatT(s *syscall.Stat_t) (*StatT, error) { + return &StatT{size: s.Size, + mode: uint32(s.Mode), + uid: s.Uid, + gid: s.Gid, + rdev: uint64(s.Rdev), + mtim: s.Mtimespec}, nil +} + +// Stat takes a path to a file and returns +// a system.Stat_t type pertaining to that file. +// +// Throws an error if the file does not exist +func Stat(path string) (*StatT, error) { + s := &syscall.Stat_t{} + if err := syscall.Stat(path, s); err != nil { + return nil, err + } + return fromStatT(s) +} diff --git a/pkg/system/stat_linux.go b/pkg/system/stat_linux.go new file mode 100644 index 0000000000..8b1eded138 --- /dev/null +++ b/pkg/system/stat_linux.go @@ -0,0 +1,33 @@ +package system + +import ( + "syscall" +) + +// fromStatT converts a syscall.Stat_t type to a system.Stat_t type +func fromStatT(s *syscall.Stat_t) (*StatT, error) { + return &StatT{size: s.Size, + mode: s.Mode, + uid: s.Uid, + gid: s.Gid, + rdev: s.Rdev, + mtim: s.Mtim}, nil +} + +// FromStatT exists only on linux, and loads a system.StatT from a +// syscal.Stat_t. +func FromStatT(s *syscall.Stat_t) (*StatT, error) { + return fromStatT(s) +} + +// Stat takes a path to a file and returns +// a system.StatT type pertaining to that file. +// +// Throws an error if the file does not exist +func Stat(path string) (*StatT, error) { + s := &syscall.Stat_t{} + if err := syscall.Stat(path, s); err != nil { + return nil, err + } + return fromStatT(s) +} diff --git a/pkg/system/stat_unix_test.go b/pkg/system/stat_unix_test.go new file mode 100644 index 0000000000..dee8d30a19 --- /dev/null +++ b/pkg/system/stat_unix_test.go @@ -0,0 +1,39 @@ +// +build linux freebsd + +package system + +import ( + "os" + "syscall" + "testing" +) + +// TestFromStatT tests fromStatT for a tempfile +func TestFromStatT(t *testing.T) { + file, _, _, dir := prepareFiles(t) + defer os.RemoveAll(dir) + + stat := &syscall.Stat_t{} + err := syscall.Lstat(file, stat) + + s, err := fromStatT(stat) + if err != nil { + t.Fatal(err) + } + + if stat.Mode != s.Mode() { + t.Fatal("got invalid mode") + } + if stat.Uid != s.UID() { + t.Fatal("got invalid uid") + } + if stat.Gid != s.GID() { + t.Fatal("got invalid gid") + } + if stat.Rdev != s.Rdev() { + t.Fatal("got invalid rdev") + } + if stat.Mtim != s.Mtim() { + t.Fatal("got invalid mtim") + } +} diff --git a/pkg/system/stat_unsupported.go b/pkg/system/stat_unsupported.go new file mode 100644 index 0000000000..381ea82116 --- /dev/null +++ b/pkg/system/stat_unsupported.go @@ -0,0 +1,17 @@ +// +build !linux,!windows,!freebsd + +package system + +import ( + "syscall" +) + +// fromStatT creates a system.StatT type from a syscall.Stat_t type +func fromStatT(s *syscall.Stat_t) (*StatT, error) { + return &StatT{size: s.Size, + mode: uint32(s.Mode), + uid: s.Uid, + gid: s.Gid, + rdev: uint64(s.Rdev), + mtim: s.Mtimespec}, nil +} diff --git a/pkg/system/stat_windows.go b/pkg/system/stat_windows.go new file mode 100644 index 0000000000..39490c625c --- /dev/null +++ b/pkg/system/stat_windows.go @@ -0,0 +1,43 @@ +// +build windows + +package system + +import ( + "os" + "time" +) + +// StatT type contains status of a file. It contains metadata +// like name, permission, size, etc about a file. +type StatT struct { + name string + size int64 + mode os.FileMode + modTime time.Time + isDir bool +} + +// Name returns file's name. +func (s StatT) Name() string { + return s.name +} + +// Size returns file's size. +func (s StatT) Size() int64 { + return s.size +} + +// Mode returns file's permission mode. +func (s StatT) Mode() os.FileMode { + return s.mode +} + +// ModTime returns file's last modification time. +func (s StatT) ModTime() time.Time { + return s.modTime +} + +// IsDir returns whether file is actually a directory. +func (s StatT) IsDir() bool { + return s.isDir +} diff --git a/pkg/system/umask.go b/pkg/system/umask.go new file mode 100644 index 0000000000..c670fcd758 --- /dev/null +++ b/pkg/system/umask.go @@ -0,0 +1,13 @@ +// +build !windows + +package system + +import ( + "syscall" +) + +// Umask sets current process's file mode creation mask to newmask +// and return oldmask. +func Umask(newmask int) (oldmask int, err error) { + return syscall.Umask(newmask), nil +} diff --git a/pkg/system/umask_windows.go b/pkg/system/umask_windows.go new file mode 100644 index 0000000000..13f1de1769 --- /dev/null +++ b/pkg/system/umask_windows.go @@ -0,0 +1,9 @@ +// +build windows + +package system + +// Umask is not supported on the windows platform. +func Umask(newmask int) (oldmask int, err error) { + // should not be called on cli code path + return 0, ErrNotSupportedPlatform +} diff --git a/pkg/system/utimes_darwin.go b/pkg/system/utimes_darwin.go new file mode 100644 index 0000000000..0a16197544 --- /dev/null +++ b/pkg/system/utimes_darwin.go @@ -0,0 +1,8 @@ +package system + +import "syscall" + +// LUtimesNano is not supported by darwin platform. +func LUtimesNano(path string, ts []syscall.Timespec) error { + return ErrNotSupportedPlatform +} diff --git a/pkg/system/utimes_freebsd.go b/pkg/system/utimes_freebsd.go new file mode 100644 index 0000000000..e2eac3b553 --- /dev/null +++ b/pkg/system/utimes_freebsd.go @@ -0,0 +1,22 @@ +package system + +import ( + "syscall" + "unsafe" +) + +// LUtimesNano is used to change access and modification time of the specified path. +// It's used for symbol link file because syscall.UtimesNano doesn't support a NOFOLLOW flag atm. +func LUtimesNano(path string, ts []syscall.Timespec) error { + var _path *byte + _path, err := syscall.BytePtrFromString(path) + if err != nil { + return err + } + + if _, _, err := syscall.Syscall(syscall.SYS_LUTIMES, uintptr(unsafe.Pointer(_path)), uintptr(unsafe.Pointer(&ts[0])), 0); err != 0 && err != syscall.ENOSYS { + return err + } + + return nil +} diff --git a/pkg/system/utimes_linux.go b/pkg/system/utimes_linux.go new file mode 100644 index 0000000000..007bfa8c03 --- /dev/null +++ b/pkg/system/utimes_linux.go @@ -0,0 +1,26 @@ +package system + +import ( + "syscall" + "unsafe" +) + +// LUtimesNano is used to change access and modification time of the speficied path. +// It's used for symbol link file because syscall.UtimesNano doesn't support a NOFOLLOW flag atm. +func LUtimesNano(path string, ts []syscall.Timespec) error { + // These are not currently available in syscall + atFdCwd := -100 + atSymLinkNoFollow := 0x100 + + var _path *byte + _path, err := syscall.BytePtrFromString(path) + if err != nil { + return err + } + + if _, _, err := syscall.Syscall6(syscall.SYS_UTIMENSAT, uintptr(atFdCwd), uintptr(unsafe.Pointer(_path)), uintptr(unsafe.Pointer(&ts[0])), uintptr(atSymLinkNoFollow), 0, 0); err != 0 && err != syscall.ENOSYS { + return err + } + + return nil +} diff --git a/pkg/system/utimes_unix_test.go b/pkg/system/utimes_unix_test.go new file mode 100644 index 0000000000..1ee0d099f9 --- /dev/null +++ b/pkg/system/utimes_unix_test.go @@ -0,0 +1,68 @@ +// +build linux freebsd + +package system + +import ( + "io/ioutil" + "os" + "path/filepath" + "syscall" + "testing" +) + +// prepareFiles creates files for testing in the temp directory +func prepareFiles(t *testing.T) (string, string, string, string) { + dir, err := ioutil.TempDir("", "docker-system-test") + if err != nil { + t.Fatal(err) + } + + file := filepath.Join(dir, "exist") + if err := ioutil.WriteFile(file, []byte("hello"), 0644); err != nil { + t.Fatal(err) + } + + invalid := filepath.Join(dir, "doesnt-exist") + + symlink := filepath.Join(dir, "symlink") + if err := os.Symlink(file, symlink); err != nil { + t.Fatal(err) + } + + return file, invalid, symlink, dir +} + +func TestLUtimesNano(t *testing.T) { + file, invalid, symlink, dir := prepareFiles(t) + defer os.RemoveAll(dir) + + before, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + + ts := []syscall.Timespec{{0, 0}, {0, 0}} + if err := LUtimesNano(symlink, ts); err != nil { + t.Fatal(err) + } + + symlinkInfo, err := os.Lstat(symlink) + if err != nil { + t.Fatal(err) + } + if before.ModTime().Unix() == symlinkInfo.ModTime().Unix() { + t.Fatal("The modification time of the symlink should be different") + } + + fileInfo, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + if before.ModTime().Unix() != fileInfo.ModTime().Unix() { + t.Fatal("The modification time of the file should be same") + } + + if err := LUtimesNano(invalid, ts); err == nil { + t.Fatal("Doesn't return an error on a non-existing file") + } +} diff --git a/pkg/system/utimes_unsupported.go b/pkg/system/utimes_unsupported.go new file mode 100644 index 0000000000..50c3a04364 --- /dev/null +++ b/pkg/system/utimes_unsupported.go @@ -0,0 +1,10 @@ +// +build !linux,!freebsd,!darwin + +package system + +import "syscall" + +// LUtimesNano is not supported on platforms other than linux, freebsd and darwin. +func LUtimesNano(path string, ts []syscall.Timespec) error { + return ErrNotSupportedPlatform +} diff --git a/pkg/system/xattrs_linux.go b/pkg/system/xattrs_linux.go new file mode 100644 index 0000000000..d2e2c05799 --- /dev/null +++ b/pkg/system/xattrs_linux.go @@ -0,0 +1,63 @@ +package system + +import ( + "syscall" + "unsafe" +) + +// Lgetxattr retrieves the value of the extended attribute identified by attr +// and associated with the given path in the file system. +// It will returns a nil slice and nil error if the xattr is not set. +func Lgetxattr(path string, attr string) ([]byte, error) { + pathBytes, err := syscall.BytePtrFromString(path) + if err != nil { + return nil, err + } + attrBytes, err := syscall.BytePtrFromString(attr) + if err != nil { + return nil, err + } + + dest := make([]byte, 128) + destBytes := unsafe.Pointer(&dest[0]) + sz, _, errno := syscall.Syscall6(syscall.SYS_LGETXATTR, uintptr(unsafe.Pointer(pathBytes)), uintptr(unsafe.Pointer(attrBytes)), uintptr(destBytes), uintptr(len(dest)), 0, 0) + if errno == syscall.ENODATA { + return nil, nil + } + if errno == syscall.ERANGE { + dest = make([]byte, sz) + destBytes := unsafe.Pointer(&dest[0]) + sz, _, errno = syscall.Syscall6(syscall.SYS_LGETXATTR, uintptr(unsafe.Pointer(pathBytes)), uintptr(unsafe.Pointer(attrBytes)), uintptr(destBytes), uintptr(len(dest)), 0, 0) + } + if errno != 0 { + return nil, errno + } + + return dest[:sz], nil +} + +var _zero uintptr + +// Lsetxattr sets the value of the extended attribute identified by attr +// and associated with the given path in the file system. +func Lsetxattr(path string, attr string, data []byte, flags int) error { + pathBytes, err := syscall.BytePtrFromString(path) + if err != nil { + return err + } + attrBytes, err := syscall.BytePtrFromString(attr) + if err != nil { + return err + } + var dataBytes unsafe.Pointer + if len(data) > 0 { + dataBytes = unsafe.Pointer(&data[0]) + } else { + dataBytes = unsafe.Pointer(&_zero) + } + _, _, errno := syscall.Syscall6(syscall.SYS_LSETXATTR, uintptr(unsafe.Pointer(pathBytes)), uintptr(unsafe.Pointer(attrBytes)), uintptr(dataBytes), uintptr(len(data)), uintptr(flags), 0) + if errno != 0 { + return errno + } + return nil +} diff --git a/pkg/system/xattrs_unsupported.go b/pkg/system/xattrs_unsupported.go new file mode 100644 index 0000000000..0114f2227c --- /dev/null +++ b/pkg/system/xattrs_unsupported.go @@ -0,0 +1,13 @@ +// +build !linux + +package system + +// Lgetxattr is not supported on platforms other than linux. +func Lgetxattr(path string, attr string) ([]byte, error) { + return nil, ErrNotSupportedPlatform +} + +// Lsetxattr is not supported on platforms other than linux. +func Lsetxattr(path string, attr string, data []byte, flags int) error { + return ErrNotSupportedPlatform +} diff --git a/pkg/tailfile/tailfile.go b/pkg/tailfile/tailfile.go new file mode 100644 index 0000000000..d580584d61 --- /dev/null +++ b/pkg/tailfile/tailfile.go @@ -0,0 +1,66 @@ +// Package tailfile provides helper functions to read the nth lines of any +// ReadSeeker. +package tailfile + +import ( + "bytes" + "errors" + "io" + "os" +) + +const blockSize = 1024 + +var eol = []byte("\n") + +// ErrNonPositiveLinesNumber is an error returned if the lines number was negative. +var ErrNonPositiveLinesNumber = errors.New("The number of lines to extract from the file must be positive") + +//TailFile returns last n lines of reader f (could be a fil). +func TailFile(f io.ReadSeeker, n int) ([][]byte, error) { + if n <= 0 { + return nil, ErrNonPositiveLinesNumber + } + size, err := f.Seek(0, os.SEEK_END) + if err != nil { + return nil, err + } + block := -1 + var data []byte + var cnt int + for { + var b []byte + step := int64(block * blockSize) + left := size + step // how many bytes to beginning + if left < 0 { + if _, err := f.Seek(0, os.SEEK_SET); err != nil { + return nil, err + } + b = make([]byte, blockSize+left) + if _, err := f.Read(b); err != nil { + return nil, err + } + data = append(b, data...) + break + } else { + b = make([]byte, blockSize) + if _, err := f.Seek(step, os.SEEK_END); err != nil { + return nil, err + } + if _, err := f.Read(b); err != nil { + return nil, err + } + data = append(b, data...) + } + cnt += bytes.Count(b, eol) + if cnt > n { + break + } + block-- + } + lines := bytes.Split(data, eol) + if n < len(lines) { + return lines[len(lines)-n-1 : len(lines)-1], nil + } + return lines[:len(lines)-1], nil +} diff --git a/pkg/tailfile/tailfile_test.go b/pkg/tailfile/tailfile_test.go new file mode 100644 index 0000000000..31217c036c --- /dev/null +++ b/pkg/tailfile/tailfile_test.go @@ -0,0 +1,148 @@ +package tailfile + +import ( + "io/ioutil" + "os" + "testing" +) + +func TestTailFile(t *testing.T) { + f, err := ioutil.TempFile("", "tail-test") + if err != nil { + t.Fatal(err) + } + defer f.Close() + defer os.RemoveAll(f.Name()) + testFile := []byte(`first line +second line +third line +fourth line +fifth line +next first line +next second line +next third line +next fourth line +next fifth line +last first line +next first line +next second line +next third line +next fourth line +next fifth line +next first line +next second line +next third line +next fourth line +next fifth line +last second line +last third line +last fourth line +last fifth line +truncated line`) + if _, err := f.Write(testFile); err != nil { + t.Fatal(err) + } + if _, err := f.Seek(0, os.SEEK_SET); err != nil { + t.Fatal(err) + } + expected := []string{"last fourth line", "last fifth line"} + res, err := TailFile(f, 2) + if err != nil { + t.Fatal(err) + } + for i, l := range res { + t.Logf("%s", l) + if expected[i] != string(l) { + t.Fatalf("Expected line %s, got %s", expected[i], l) + } + } +} + +func TestTailFileManyLines(t *testing.T) { + f, err := ioutil.TempFile("", "tail-test") + if err != nil { + t.Fatal(err) + } + defer f.Close() + defer os.RemoveAll(f.Name()) + testFile := []byte(`first line +second line +truncated line`) + if _, err := f.Write(testFile); err != nil { + t.Fatal(err) + } + if _, err := f.Seek(0, os.SEEK_SET); err != nil { + t.Fatal(err) + } + expected := []string{"first line", "second line"} + res, err := TailFile(f, 10000) + if err != nil { + t.Fatal(err) + } + for i, l := range res { + t.Logf("%s", l) + if expected[i] != string(l) { + t.Fatalf("Expected line %s, got %s", expected[i], l) + } + } +} + +func TestTailEmptyFile(t *testing.T) { + f, err := ioutil.TempFile("", "tail-test") + if err != nil { + t.Fatal(err) + } + defer f.Close() + defer os.RemoveAll(f.Name()) + res, err := TailFile(f, 10000) + if err != nil { + t.Fatal(err) + } + if len(res) != 0 { + t.Fatal("Must be empty slice from empty file") + } +} + +func TestTailNegativeN(t *testing.T) { + f, err := ioutil.TempFile("", "tail-test") + if err != nil { + t.Fatal(err) + } + defer f.Close() + defer os.RemoveAll(f.Name()) + testFile := []byte(`first line +second line +truncated line`) + if _, err := f.Write(testFile); err != nil { + t.Fatal(err) + } + if _, err := f.Seek(0, os.SEEK_SET); err != nil { + t.Fatal(err) + } + if _, err := TailFile(f, -1); err != ErrNonPositiveLinesNumber { + t.Fatalf("Expected ErrNonPositiveLinesNumber, got %s", err) + } + if _, err := TailFile(f, 0); err != ErrNonPositiveLinesNumber { + t.Fatalf("Expected ErrNonPositiveLinesNumber, got %s", err) + } +} + +func BenchmarkTail(b *testing.B) { + f, err := ioutil.TempFile("", "tail-test") + if err != nil { + b.Fatal(err) + } + defer f.Close() + defer os.RemoveAll(f.Name()) + for i := 0; i < 10000; i++ { + if _, err := f.Write([]byte("tailfile pretty interesting line\n")); err != nil { + b.Fatal(err) + } + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + if _, err := TailFile(f, 1000); err != nil { + b.Fatal(err) + } + } +} diff --git a/pkg/tarsum/builder_context.go b/pkg/tarsum/builder_context.go new file mode 100644 index 0000000000..b42983e984 --- /dev/null +++ b/pkg/tarsum/builder_context.go @@ -0,0 +1,21 @@ +package tarsum + +// BuilderContext is an interface extending TarSum by adding the Remove method. +// In general there was concern about adding this method to TarSum itself +// so instead it is being added just to "BuilderContext" which will then +// only be used during the .dockerignore file processing +// - see builder/evaluator.go +type BuilderContext interface { + TarSum + Remove(string) +} + +func (bc *tarSum) Remove(filename string) { + for i, fis := range bc.sums { + if fis.Name() == filename { + bc.sums = append(bc.sums[:i], bc.sums[i+1:]...) + // Note, we don't just return because there could be + // more than one with this name + } + } +} diff --git a/pkg/tarsum/builder_context_test.go b/pkg/tarsum/builder_context_test.go new file mode 100644 index 0000000000..719f72895d --- /dev/null +++ b/pkg/tarsum/builder_context_test.go @@ -0,0 +1,63 @@ +package tarsum + +import ( + "io" + "io/ioutil" + "os" + "testing" +) + +// Try to remove tarsum (in the BuilderContext) that do not exists, won't change a thing +func TestTarSumRemoveNonExistent(t *testing.T) { + filename := "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar" + reader, err := os.Open(filename) + if err != nil { + t.Fatal(err) + } + ts, err := NewTarSum(reader, false, Version0) + if err != nil { + t.Fatal(err) + } + + // Read and discard bytes so that it populates sums + _, err = io.Copy(ioutil.Discard, ts) + if err != nil { + t.Errorf("failed to read from %s: %s", filename, err) + } + + expected := len(ts.GetSums()) + + ts.(BuilderContext).Remove("") + ts.(BuilderContext).Remove("Anything") + + if len(ts.GetSums()) != expected { + t.Fatalf("Expected %v sums, go %v.", expected, ts.GetSums()) + } +} + +// Remove a tarsum (in the BuilderContext) +func TestTarSumRemove(t *testing.T) { + filename := "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar" + reader, err := os.Open(filename) + if err != nil { + t.Fatal(err) + } + ts, err := NewTarSum(reader, false, Version0) + if err != nil { + t.Fatal(err) + } + + // Read and discard bytes so that it populates sums + _, err = io.Copy(ioutil.Discard, ts) + if err != nil { + t.Errorf("failed to read from %s: %s", filename, err) + } + + expected := len(ts.GetSums()) - 1 + + ts.(BuilderContext).Remove("etc/sudoers") + + if len(ts.GetSums()) != expected { + t.Fatalf("Expected %v sums, go %v.", expected, len(ts.GetSums())) + } +} diff --git a/pkg/tarsum/fileinfosums.go b/pkg/tarsum/fileinfosums.go new file mode 100644 index 0000000000..7c2161c246 --- /dev/null +++ b/pkg/tarsum/fileinfosums.go @@ -0,0 +1,126 @@ +package tarsum + +import "sort" + +// FileInfoSumInterface provides an interface for accessing file checksum +// information within a tar file. This info is accessed through interface +// so the actual name and sum cannot be medled with. +type FileInfoSumInterface interface { + // File name + Name() string + // Checksum of this particular file and its headers + Sum() string + // Position of file in the tar + Pos() int64 +} + +type fileInfoSum struct { + name string + sum string + pos int64 +} + +func (fis fileInfoSum) Name() string { + return fis.name +} +func (fis fileInfoSum) Sum() string { + return fis.sum +} +func (fis fileInfoSum) Pos() int64 { + return fis.pos +} + +// FileInfoSums provides a list of FileInfoSumInterfaces. +type FileInfoSums []FileInfoSumInterface + +// GetFile returns the first FileInfoSumInterface with a matching name. +func (fis FileInfoSums) GetFile(name string) FileInfoSumInterface { + for i := range fis { + if fis[i].Name() == name { + return fis[i] + } + } + return nil +} + +// GetAllFile returns a FileInfoSums with all matching names. +func (fis FileInfoSums) GetAllFile(name string) FileInfoSums { + f := FileInfoSums{} + for i := range fis { + if fis[i].Name() == name { + f = append(f, fis[i]) + } + } + return f +} + +// GetDuplicatePaths returns a FileInfoSums with all duplicated paths. +func (fis FileInfoSums) GetDuplicatePaths() (dups FileInfoSums) { + seen := make(map[string]int, len(fis)) // allocate earl. no need to grow this map. + for i := range fis { + f := fis[i] + if _, ok := seen[f.Name()]; ok { + dups = append(dups, f) + } else { + seen[f.Name()] = 0 + } + } + return dups +} + +// Len returns the size of the FileInfoSums. +func (fis FileInfoSums) Len() int { return len(fis) } + +// Swap swaps two FileInfoSum values if a FileInfoSums list. +func (fis FileInfoSums) Swap(i, j int) { fis[i], fis[j] = fis[j], fis[i] } + +// SortByPos sorts FileInfoSums content by position. +func (fis FileInfoSums) SortByPos() { + sort.Sort(byPos{fis}) +} + +// SortByNames sorts FileInfoSums content by name. +func (fis FileInfoSums) SortByNames() { + sort.Sort(byName{fis}) +} + +// SortBySums sorts FileInfoSums content by sums. +func (fis FileInfoSums) SortBySums() { + dups := fis.GetDuplicatePaths() + if len(dups) > 0 { + sort.Sort(bySum{fis, dups}) + } else { + sort.Sort(bySum{fis, nil}) + } +} + +// byName is a sort.Sort helper for sorting by file names. +// If names are the same, order them by their appearance in the tar archive +type byName struct{ FileInfoSums } + +func (bn byName) Less(i, j int) bool { + if bn.FileInfoSums[i].Name() == bn.FileInfoSums[j].Name() { + return bn.FileInfoSums[i].Pos() < bn.FileInfoSums[j].Pos() + } + return bn.FileInfoSums[i].Name() < bn.FileInfoSums[j].Name() +} + +// bySum is a sort.Sort helper for sorting by the sums of all the fileinfos in the tar archive +type bySum struct { + FileInfoSums + dups FileInfoSums +} + +func (bs bySum) Less(i, j int) bool { + if bs.dups != nil && bs.FileInfoSums[i].Name() == bs.FileInfoSums[j].Name() { + return bs.FileInfoSums[i].Pos() < bs.FileInfoSums[j].Pos() + } + return bs.FileInfoSums[i].Sum() < bs.FileInfoSums[j].Sum() +} + +// byPos is a sort.Sort helper for sorting by the sums of all the fileinfos by their original order +type byPos struct{ FileInfoSums } + +func (bp byPos) Less(i, j int) bool { + return bp.FileInfoSums[i].Pos() < bp.FileInfoSums[j].Pos() +} diff --git a/pkg/tarsum/fileinfosums_test.go b/pkg/tarsum/fileinfosums_test.go new file mode 100644 index 0000000000..bb700d8bde --- /dev/null +++ b/pkg/tarsum/fileinfosums_test.go @@ -0,0 +1,62 @@ +package tarsum + +import "testing" + +func newFileInfoSums() FileInfoSums { + return FileInfoSums{ + fileInfoSum{name: "file3", sum: "2abcdef1234567890", pos: 2}, + fileInfoSum{name: "dup1", sum: "deadbeef1", pos: 5}, + fileInfoSum{name: "file1", sum: "0abcdef1234567890", pos: 0}, + fileInfoSum{name: "file4", sum: "3abcdef1234567890", pos: 3}, + fileInfoSum{name: "dup1", sum: "deadbeef0", pos: 4}, + fileInfoSum{name: "file2", sum: "1abcdef1234567890", pos: 1}, + } +} + +func TestSortFileInfoSums(t *testing.T) { + dups := newFileInfoSums().GetAllFile("dup1") + if len(dups) != 2 { + t.Errorf("expected length 2, got %d", len(dups)) + } + dups.SortByNames() + if dups[0].Pos() != 4 { + t.Errorf("sorted dups should be ordered by position. Expected 4, got %d", dups[0].Pos()) + } + + fis := newFileInfoSums() + expected := "0abcdef1234567890" + fis.SortBySums() + got := fis[0].Sum() + if got != expected { + t.Errorf("Expected %q, got %q", expected, got) + } + + fis = newFileInfoSums() + expected = "dup1" + fis.SortByNames() + gotFis := fis[0] + if gotFis.Name() != expected { + t.Errorf("Expected %q, got %q", expected, gotFis.Name()) + } + // since a duplicate is first, ensure it is ordered first by position too + if gotFis.Pos() != 4 { + t.Errorf("Expected %d, got %d", 4, gotFis.Pos()) + } + + fis = newFileInfoSums() + fis.SortByPos() + if fis[0].Pos() != 0 { + t.Errorf("sorted fileInfoSums by Pos should order them by position.") + } + + fis = newFileInfoSums() + expected = "deadbeef1" + gotFileInfoSum := fis.GetFile("dup1") + if gotFileInfoSum.Sum() != expected { + t.Errorf("Expected %q, got %q", expected, gotFileInfoSum) + } + if fis.GetFile("noPresent") != nil { + t.Errorf("Should have return nil if name not found.") + } + +} diff --git a/pkg/tarsum/tarsum.go b/pkg/tarsum/tarsum.go new file mode 100644 index 0000000000..d2df58c7f3 --- /dev/null +++ b/pkg/tarsum/tarsum.go @@ -0,0 +1,294 @@ +// Package tarsum provides algorithms to perform checksum calculation on +// filesystem layers. +// +// The transportation of filesystems, regarding Docker, is done with tar(1) +// archives. There are a variety of tar serialization formats [2], and a key +// concern here is ensuring a repeatable checksum given a set of inputs from a +// generic tar archive. Types of transportation include distribution to and from a +// registry endpoint, saving and loading through commands or Docker daemon APIs, +// transferring the build context from client to Docker daemon, and committing the +// filesystem of a container to become an image. +// +// As tar archives are used for transit, but not preserved in many situations, the +// focus of the algorithm is to ensure the integrity of the preserved filesystem, +// while maintaining a deterministic accountability. This includes neither +// constraining the ordering or manipulation of the files during the creation or +// unpacking of the archive, nor include additional metadata state about the file +// system attributes. +package tarsum + +import ( + "archive/tar" + "bytes" + "compress/gzip" + "crypto" + "crypto/sha256" + "encoding/hex" + "errors" + "fmt" + "hash" + "io" + "strings" +) + +const ( + buf8K = 8 * 1024 + buf16K = 16 * 1024 + buf32K = 32 * 1024 +) + +// NewTarSum creates a new interface for calculating a fixed time checksum of a +// tar archive. +// +// This is used for calculating checksums of layers of an image, in some cases +// including the byte payload of the image's json metadata as well, and for +// calculating the checksums for buildcache. +func NewTarSum(r io.Reader, dc bool, v Version) (TarSum, error) { + return NewTarSumHash(r, dc, v, DefaultTHash) +} + +// NewTarSumHash creates a new TarSum, providing a THash to use rather than +// the DefaultTHash. +func NewTarSumHash(r io.Reader, dc bool, v Version, tHash THash) (TarSum, error) { + headerSelector, err := getTarHeaderSelector(v) + if err != nil { + return nil, err + } + ts := &tarSum{Reader: r, DisableCompression: dc, tarSumVersion: v, headerSelector: headerSelector, tHash: tHash} + err = ts.initTarSum() + return ts, err +} + +// NewTarSumForLabel creates a new TarSum using the provided TarSum version+hash label. +func NewTarSumForLabel(r io.Reader, disableCompression bool, label string) (TarSum, error) { + parts := strings.SplitN(label, "+", 2) + if len(parts) != 2 { + return nil, errors.New("tarsum label string should be of the form: {tarsum_version}+{hash_name}") + } + + versionName, hashName := parts[0], parts[1] + + version, ok := tarSumVersionsByName[versionName] + if !ok { + return nil, fmt.Errorf("unknown TarSum version name: %q", versionName) + } + + hashConfig, ok := standardHashConfigs[hashName] + if !ok { + return nil, fmt.Errorf("unknown TarSum hash name: %q", hashName) + } + + tHash := NewTHash(hashConfig.name, hashConfig.hash.New) + + return NewTarSumHash(r, disableCompression, version, tHash) +} + +// TarSum is the generic interface for calculating fixed time +// checksums of a tar archive. +type TarSum interface { + io.Reader + GetSums() FileInfoSums + Sum([]byte) string + Version() Version + Hash() THash +} + +// tarSum struct is the structure for a Version0 checksum calculation. +type tarSum struct { + io.Reader + tarR *tar.Reader + tarW *tar.Writer + writer writeCloseFlusher + bufTar *bytes.Buffer + bufWriter *bytes.Buffer + bufData []byte + h hash.Hash + tHash THash + sums FileInfoSums + fileCounter int64 + currentFile string + finished bool + first bool + DisableCompression bool // false by default. When false, the output gzip compressed. + tarSumVersion Version // this field is not exported so it can not be mutated during use + headerSelector tarHeaderSelector // handles selecting and ordering headers for files in the archive +} + +func (ts tarSum) Hash() THash { + return ts.tHash +} + +func (ts tarSum) Version() Version { + return ts.tarSumVersion +} + +// THash provides a hash.Hash type generator and its name. +type THash interface { + Hash() hash.Hash + Name() string +} + +// NewTHash is a convenience method for creating a THash. +func NewTHash(name string, h func() hash.Hash) THash { + return simpleTHash{n: name, h: h} +} + +type tHashConfig struct { + name string + hash crypto.Hash +} + +var ( + // NOTE: DO NOT include MD5 or SHA1, which are considered insecure. + standardHashConfigs = map[string]tHashConfig{ + "sha256": {name: "sha256", hash: crypto.SHA256}, + "sha512": {name: "sha512", hash: crypto.SHA512}, + } +) + +// TarSum default is "sha256" +var DefaultTHash = NewTHash("sha256", sha256.New) + +type simpleTHash struct { + n string + h func() hash.Hash +} + +func (sth simpleTHash) Name() string { return sth.n } +func (sth simpleTHash) Hash() hash.Hash { return sth.h() } + +func (ts *tarSum) encodeHeader(h *tar.Header) error { + for _, elem := range ts.headerSelector.selectHeaders(h) { + if _, err := ts.h.Write([]byte(elem[0] + elem[1])); err != nil { + return err + } + } + return nil +} + +func (ts *tarSum) initTarSum() error { + ts.bufTar = bytes.NewBuffer([]byte{}) + ts.bufWriter = bytes.NewBuffer([]byte{}) + ts.tarR = tar.NewReader(ts.Reader) + ts.tarW = tar.NewWriter(ts.bufTar) + if !ts.DisableCompression { + ts.writer = gzip.NewWriter(ts.bufWriter) + } else { + ts.writer = &nopCloseFlusher{Writer: ts.bufWriter} + } + if ts.tHash == nil { + ts.tHash = DefaultTHash + } + ts.h = ts.tHash.Hash() + ts.h.Reset() + ts.first = true + ts.sums = FileInfoSums{} + return nil +} + +func (ts *tarSum) Read(buf []byte) (int, error) { + if ts.finished { + return ts.bufWriter.Read(buf) + } + if len(ts.bufData) < len(buf) { + switch { + case len(buf) <= buf8K: + ts.bufData = make([]byte, buf8K) + case len(buf) <= buf16K: + ts.bufData = make([]byte, buf16K) + case len(buf) <= buf32K: + ts.bufData = make([]byte, buf32K) + default: + ts.bufData = make([]byte, len(buf)) + } + } + buf2 := ts.bufData[:len(buf)] + + n, err := ts.tarR.Read(buf2) + if err != nil { + if err == io.EOF { + if _, err := ts.h.Write(buf2[:n]); err != nil { + return 0, err + } + if !ts.first { + ts.sums = append(ts.sums, fileInfoSum{name: ts.currentFile, sum: hex.EncodeToString(ts.h.Sum(nil)), pos: ts.fileCounter}) + ts.fileCounter++ + ts.h.Reset() + } else { + ts.first = false + } + + currentHeader, err := ts.tarR.Next() + if err != nil { + if err == io.EOF { + if err := ts.tarW.Close(); err != nil { + return 0, err + } + if _, err := io.Copy(ts.writer, ts.bufTar); err != nil { + return 0, err + } + if err := ts.writer.Close(); err != nil { + return 0, err + } + ts.finished = true + return n, nil + } + return n, err + } + ts.currentFile = strings.TrimSuffix(strings.TrimPrefix(currentHeader.Name, "./"), "/") + if err := ts.encodeHeader(currentHeader); err != nil { + return 0, err + } + if err := ts.tarW.WriteHeader(currentHeader); err != nil { + return 0, err + } + if _, err := ts.tarW.Write(buf2[:n]); err != nil { + return 0, err + } + ts.tarW.Flush() + if _, err := io.Copy(ts.writer, ts.bufTar); err != nil { + return 0, err + } + ts.writer.Flush() + + return ts.bufWriter.Read(buf) + } + return n, err + } + + // Filling the hash buffer + if _, err = ts.h.Write(buf2[:n]); err != nil { + return 0, err + } + + // Filling the tar writter + if _, err = ts.tarW.Write(buf2[:n]); err != nil { + return 0, err + } + ts.tarW.Flush() + + // Filling the output writer + if _, err = io.Copy(ts.writer, ts.bufTar); err != nil { + return 0, err + } + ts.writer.Flush() + + return ts.bufWriter.Read(buf) +} + +func (ts *tarSum) Sum(extra []byte) string { + ts.sums.SortBySums() + h := ts.tHash.Hash() + if extra != nil { + h.Write(extra) + } + for _, fis := range ts.sums { + h.Write([]byte(fis.Sum())) + } + checksum := ts.Version().String() + "+" + ts.tHash.Name() + ":" + hex.EncodeToString(h.Sum(nil)) + return checksum +} + +func (ts *tarSum) GetSums() FileInfoSums { + return ts.sums +} diff --git a/pkg/tarsum/tarsum_spec.md b/pkg/tarsum/tarsum_spec.md new file mode 100644 index 0000000000..77927ee707 --- /dev/null +++ b/pkg/tarsum/tarsum_spec.md @@ -0,0 +1,230 @@ +page_title: TarSum checksum specification +page_description: Documentation for algorithms used in the TarSum checksum calculation +page_keywords: docker, checksum, validation, tarsum + +# TarSum Checksum Specification + +## Abstract + +This document describes the algorithms used in performing the TarSum checksum +calculation on filesystem layers, the need for this method over existing +methods, and the versioning of this calculation. + +## Warning + +This checksum algorithm is for best-effort comparison of file trees with fuzzy logic. + +This is _not_ a cryptographic attestation, and should not be considered secure. + +## Introduction + +The transportation of filesystems, regarding Docker, is done with tar(1) +archives. There are a variety of tar serialization formats [2], and a key +concern here is ensuring a repeatable checksum given a set of inputs from a +generic tar archive. Types of transportation include distribution to and from a +registry endpoint, saving and loading through commands or Docker daemon APIs, +transferring the build context from client to Docker daemon, and committing the +filesystem of a container to become an image. + +As tar archives are used for transit, but not preserved in many situations, the +focus of the algorithm is to ensure the integrity of the preserved filesystem, +while maintaining a deterministic accountability. This includes neither +constraining the ordering or manipulation of the files during the creation or +unpacking of the archive, nor include additional metadata state about the file +system attributes. + +## Intended Audience + +This document is outlining the methods used for consistent checksum calculation +for filesystems transported via tar archives. + +Auditing these methodologies is an open and iterative process. This document +should accommodate the review of source code. Ultimately, this document should +be the starting point of further refinements to the algorithm and its future +versions. + +## Concept + +The checksum mechanism must ensure the integrity and assurance of the +filesystem payload. + +## Checksum Algorithm Profile + +A checksum mechanism must define the following operations and attributes: + +* Associated hashing cipher - used to checksum each file payload and attribute + information. +* Checksum list - each file of the filesystem archive has its checksum + calculated from the payload and attributes of the file. The final checksum is + calculated from this list, with specific ordering. +* Version - as the algorithm adapts to requirements, there are behaviors of the + algorithm to manage by versioning. +* Archive being calculated - the tar archive having its checksum calculated + +## Elements of TarSum checksum + +The calculated sum output is a text string. The elements included in the output +of the calculated sum comprise the information needed for validation of the sum +(TarSum version and hashing cipher used) and the expected checksum in hexadecimal +form. + +There are two delimiters used: +* '+' separates TarSum version from hashing cipher +* ':' separates calculation mechanics from expected hash + +Example: + +``` + "tarsum.v1+sha256:220a60ecd4a3c32c282622a625a54db9ba0ff55b5ba9c29c7064a2bc358b6a3e" + | | \ | + | | \ | + |_version_|_cipher__|__ | + | \ | + |_calculation_mechanics_|______________________expected_sum_______________________| +``` + +## Versioning + +Versioning was introduced [0] to accommodate differences in calculation needed, +and ability to maintain reverse compatibility. + +The general algorithm will be describe further in the 'Calculation'. + +### Version0 + +This is the initial version of TarSum. + +Its element in the TarSum checksum string is `tarsum`. + +### Version1 + +Its element in the TarSum checksum is `tarsum.v1`. + +The notable changes in this version: +* Exclusion of file `mtime` from the file information headers, in each file + checksum calculation +* Inclusion of extended attributes (`xattrs`. Also seen as `SCHILY.xattr.` prefixed Pax + tar file info headers) keys and values in each file checksum calculation + +### VersionDev + +*Do not use unless validating refinements to the checksum algorithm* + +Its element in the TarSum checksum is `tarsum.dev`. + +This is a floating place holder for a next version and grounds for testing +changes. The methods used for calculation are subject to change without notice, +and this version is for testing and not for production use. + +## Ciphers + +The official default and standard hashing cipher used in the calculation mechanic +is `sha256`. This refers to SHA256 hash algorithm as defined in FIPS 180-4. + +Though the TarSum algorithm itself is not exclusively bound to the single +hashing cipher `sha256`, support for alternate hashing ciphers was later added +[1]. Use cases for alternate cipher could include future-proofing TarSum +checksum format and using faster cipher hashes for tar filesystem checksums. + +## Calculation + +### Requirement + +As mentioned earlier, the calculation is such that it takes into consideration +the lifecycle of the tar archive. In that the tar archive is not an immutable, +permanent artifact. Otherwise options like relying on a known hashing cipher +checksum of the archive itself would be reliable enough. The tar archive of the +filesystem is used as a transportation medium for Docker images, and the +archive is discarded once its contents are extracted. Therefore, for consistent +validation items such as order of files in the tar archive and time stamps are +subject to change once an image is received. + +### Process + +The method is typically iterative due to reading tar info headers from the +archive stream, though this is not a strict requirement. + +#### Files + +Each file in the tar archive have their contents (headers and body) checksummed +individually using the designated associated hashing cipher. The ordered +headers of the file are written to the checksum calculation first, and then the +payload of the file body. + +The resulting checksum of the file is appended to the list of file sums. The +sum is encoded as a string of the hexadecimal digest. Additionally, the file +name and position in the archive is kept as reference for special ordering. + +#### Headers + +The following headers are read, in this +order ( and the corresponding representation of its value): +* 'name' - string +* 'mode' - string of the base10 integer +* 'uid' - string of the integer +* 'gid' - string of the integer +* 'size' - string of the integer +* 'mtime' (_Version0 only_) - string of integer of the seconds since 1970-01-01 00:00:00 UTC +* 'typeflag' - string of the char +* 'linkname' - string +* 'uname' - string +* 'gname' - string +* 'devmajor' - string of the integer +* 'devminor' - string of the integer + +For >= Version1, the extended attribute headers ("SCHILY.xattr." prefixed pax +headers) included after the above list. These xattrs key/values are first +sorted by the keys. + +#### Header Format + +The ordered headers are written to the hash in the format of + + "{.key}{.value}" + +with no newline. + +#### Body + +After the order headers of the file have been added to the checksum for the +file, the body of the file is written to the hash. + +#### List of file sums + +The list of file sums is sorted by the string of the hexadecimal digest. + +If there are two files in the tar with matching paths, the order of occurrence +for that path is reflected for the sums of the corresponding file header and +body. + +#### Final Checksum + +Begin with a fresh or initial state of the associated hash cipher. If there is +additional payload to include in the TarSum calculation for the archive, it is +written first. Then each checksum from the ordered list of file sums is written +to the hash. + +The resulting digest is formatted per the Elements of TarSum checksum, +including the TarSum version, the associated hash cipher and the hexadecimal +encoded checksum digest. + +## Security Considerations + +The initial version of TarSum has undergone one update that could invalidate +handcrafted tar archives. The tar archive format supports appending of files +with same names as prior files in the archive. The latter file will clobber the +prior file of the same path. Due to this the algorithm now accounts for files +with matching paths, and orders the list of file sums accordingly [3]. + +## Footnotes + +* [0] Versioning https://github.com/docker/docker/commit/747f89cd327db9d50251b17797c4d825162226d0 +* [1] Alternate ciphers https://github.com/docker/docker/commit/4e9925d780665149b8bc940d5ba242ada1973c4e +* [2] Tar http://en.wikipedia.org/wiki/Tar_%28computing%29 +* [3] Name collision https://github.com/docker/docker/commit/c5e6362c53cbbc09ddbabd5a7323e04438b57d31 + +## Acknowledgements + +Joffrey F (shin-) and Guillaume J. Charmes (creack) on the initial work of the +TarSum calculation. + diff --git a/pkg/tarsum/tarsum_test.go b/pkg/tarsum/tarsum_test.go new file mode 100644 index 0000000000..8962666052 --- /dev/null +++ b/pkg/tarsum/tarsum_test.go @@ -0,0 +1,648 @@ +package tarsum + +import ( + "archive/tar" + "bytes" + "compress/gzip" + "crypto/md5" + "crypto/rand" + "crypto/sha1" + "crypto/sha256" + "crypto/sha512" + "encoding/hex" + "fmt" + "io" + "io/ioutil" + "os" + "strings" + "testing" +) + +type testLayer struct { + filename string + options *sizedOptions + jsonfile string + gzip bool + tarsum string + version Version + hash THash +} + +var testLayers = []testLayer{ + { + filename: "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar", + jsonfile: "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json", + version: Version0, + tarsum: "tarsum+sha256:4095cc12fa5fdb1ab2760377e1cd0c4ecdd3e61b4f9b82319d96fcea6c9a41c6"}, + { + filename: "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar", + jsonfile: "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json", + version: VersionDev, + tarsum: "tarsum.dev+sha256:db56e35eec6ce65ba1588c20ba6b1ea23743b59e81fb6b7f358ccbde5580345c"}, + { + filename: "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar", + jsonfile: "testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json", + gzip: true, + tarsum: "tarsum+sha256:4095cc12fa5fdb1ab2760377e1cd0c4ecdd3e61b4f9b82319d96fcea6c9a41c6"}, + { + // Tests existing version of TarSum when xattrs are present + filename: "testdata/xattr/layer.tar", + jsonfile: "testdata/xattr/json", + version: Version0, + tarsum: "tarsum+sha256:07e304a8dbcb215b37649fde1a699f8aeea47e60815707f1cdf4d55d25ff6ab4"}, + { + // Tests next version of TarSum when xattrs are present + filename: "testdata/xattr/layer.tar", + jsonfile: "testdata/xattr/json", + version: VersionDev, + tarsum: "tarsum.dev+sha256:6c58917892d77b3b357b0f9ad1e28e1f4ae4de3a8006bd3beb8beda214d8fd16"}, + { + filename: "testdata/511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158/layer.tar", + jsonfile: "testdata/511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158/json", + tarsum: "tarsum+sha256:c66bd5ec9f87b8f4c6135ca37684618f486a3dd1d113b138d0a177bfa39c2571"}, + { + options: &sizedOptions{1, 1024 * 1024, false, false}, // a 1mb file (in memory) + tarsum: "tarsum+sha256:8bf12d7e67c51ee2e8306cba569398b1b9f419969521a12ffb9d8875e8836738"}, + { + // this tar has two files with the same path + filename: "testdata/collision/collision-0.tar", + tarsum: "tarsum+sha256:08653904a68d3ab5c59e65ef58c49c1581caa3c34744f8d354b3f575ea04424a"}, + { + // this tar has the same two files (with the same path), but reversed order. ensuring is has different hash than above + filename: "testdata/collision/collision-1.tar", + tarsum: "tarsum+sha256:b51c13fbefe158b5ce420d2b930eef54c5cd55c50a2ee4abdddea8fa9f081e0d"}, + { + // this tar has newer of collider-0.tar, ensuring is has different hash + filename: "testdata/collision/collision-2.tar", + tarsum: "tarsum+sha256:381547080919bb82691e995508ae20ed33ce0f6948d41cafbeb70ce20c73ee8e"}, + { + // this tar has newer of collider-1.tar, ensuring is has different hash + filename: "testdata/collision/collision-3.tar", + tarsum: "tarsum+sha256:f886e431c08143164a676805205979cd8fa535dfcef714db5515650eea5a7c0f"}, + { + options: &sizedOptions{1, 1024 * 1024, false, false}, // a 1mb file (in memory) + tarsum: "tarsum+md5:0d7529ec7a8360155b48134b8e599f53", + hash: md5THash, + }, + { + options: &sizedOptions{1, 1024 * 1024, false, false}, // a 1mb file (in memory) + tarsum: "tarsum+sha1:f1fee39c5925807ff75ef1925e7a23be444ba4df", + hash: sha1Hash, + }, + { + options: &sizedOptions{1, 1024 * 1024, false, false}, // a 1mb file (in memory) + tarsum: "tarsum+sha224:6319390c0b061d639085d8748b14cd55f697cf9313805218b21cf61c", + hash: sha224Hash, + }, + { + options: &sizedOptions{1, 1024 * 1024, false, false}, // a 1mb file (in memory) + tarsum: "tarsum+sha384:a578ce3ce29a2ae03b8ed7c26f47d0f75b4fc849557c62454be4b5ffd66ba021e713b48ce71e947b43aab57afd5a7636", + hash: sha384Hash, + }, + { + options: &sizedOptions{1, 1024 * 1024, false, false}, // a 1mb file (in memory) + tarsum: "tarsum+sha512:e9bfb90ca5a4dfc93c46ee061a5cf9837de6d2fdf82544d6460d3147290aecfabf7b5e415b9b6e72db9b8941f149d5d69fb17a394cbfaf2eac523bd9eae21855", + hash: sha512Hash, + }, +} + +type sizedOptions struct { + num int64 + size int64 + isRand bool + realFile bool +} + +// make a tar: +// * num is the number of files the tar should have +// * size is the bytes per file +// * isRand is whether the contents of the files should be a random chunk (otherwise it's all zeros) +// * realFile will write to a TempFile, instead of an in memory buffer +func sizedTar(opts sizedOptions) io.Reader { + var ( + fh io.ReadWriter + err error + ) + if opts.realFile { + fh, err = ioutil.TempFile("", "tarsum") + if err != nil { + return nil + } + } else { + fh = bytes.NewBuffer([]byte{}) + } + tarW := tar.NewWriter(fh) + defer tarW.Close() + for i := int64(0); i < opts.num; i++ { + err := tarW.WriteHeader(&tar.Header{ + Name: fmt.Sprintf("/testdata%d", i), + Mode: 0755, + Uid: 0, + Gid: 0, + Size: opts.size, + }) + if err != nil { + return nil + } + var rBuf []byte + if opts.isRand { + rBuf = make([]byte, 8) + _, err = rand.Read(rBuf) + if err != nil { + return nil + } + } else { + rBuf = []byte{0, 0, 0, 0, 0, 0, 0, 0} + } + + for i := int64(0); i < opts.size/int64(8); i++ { + tarW.Write(rBuf) + } + } + return fh +} + +func emptyTarSum(gzip bool) (TarSum, error) { + reader, writer := io.Pipe() + tarWriter := tar.NewWriter(writer) + + // Immediately close tarWriter and write-end of the + // Pipe in a separate goroutine so we don't block. + go func() { + tarWriter.Close() + writer.Close() + }() + + return NewTarSum(reader, !gzip, Version0) +} + +// Test errors on NewTarsumForLabel +func TestNewTarSumForLabelInvalid(t *testing.T) { + reader := strings.NewReader("") + + if _, err := NewTarSumForLabel(reader, true, "invalidlabel"); err == nil { + t.Fatalf("Expected an error, got nothing.") + } + + if _, err := NewTarSumForLabel(reader, true, "invalid+sha256"); err == nil { + t.Fatalf("Expected an error, got nothing.") + } + if _, err := NewTarSumForLabel(reader, true, "tarsum.v1+invalid"); err == nil { + t.Fatalf("Expected an error, got nothing.") + } +} + +func TestNewTarSumForLabel(t *testing.T) { + + layer := testLayers[0] + + reader, err := os.Open(layer.filename) + if err != nil { + t.Fatal(err) + } + label := strings.Split(layer.tarsum, ":")[0] + ts, err := NewTarSumForLabel(reader, false, label) + if err != nil { + t.Fatal(err) + } + + // Make sure it actually worked by reading a little bit of it + nbByteToRead := 8 * 1024 + dBuf := make([]byte, nbByteToRead) + _, err = ts.Read(dBuf) + if err != nil { + t.Errorf("failed to read %vKB from %s: %s", nbByteToRead, layer.filename, err) + } +} + +// TestEmptyTar tests that tarsum does not fail to read an empty tar +// and correctly returns the hex digest of an empty hash. +func TestEmptyTar(t *testing.T) { + // Test without gzip. + ts, err := emptyTarSum(false) + if err != nil { + t.Fatal(err) + } + + zeroBlock := make([]byte, 1024) + buf := new(bytes.Buffer) + + n, err := io.Copy(buf, ts) + if err != nil { + t.Fatal(err) + } + + if n != int64(len(zeroBlock)) || !bytes.Equal(buf.Bytes(), zeroBlock) { + t.Fatalf("tarSum did not write the correct number of zeroed bytes: %d", n) + } + + expectedSum := ts.Version().String() + "+sha256:" + hex.EncodeToString(sha256.New().Sum(nil)) + resultSum := ts.Sum(nil) + + if resultSum != expectedSum { + t.Fatalf("expected [%s] but got [%s]", expectedSum, resultSum) + } + + // Test with gzip. + ts, err = emptyTarSum(true) + if err != nil { + t.Fatal(err) + } + buf.Reset() + + n, err = io.Copy(buf, ts) + if err != nil { + t.Fatal(err) + } + + bufgz := new(bytes.Buffer) + gz := gzip.NewWriter(bufgz) + n, err = io.Copy(gz, bytes.NewBuffer(zeroBlock)) + gz.Close() + gzBytes := bufgz.Bytes() + + if n != int64(len(zeroBlock)) || !bytes.Equal(buf.Bytes(), gzBytes) { + t.Fatalf("tarSum did not write the correct number of gzipped-zeroed bytes: %d", n) + } + + resultSum = ts.Sum(nil) + + if resultSum != expectedSum { + t.Fatalf("expected [%s] but got [%s]", expectedSum, resultSum) + } + + // Test without ever actually writing anything. + if ts, err = NewTarSum(bytes.NewReader([]byte{}), true, Version0); err != nil { + t.Fatal(err) + } + + resultSum = ts.Sum(nil) + + if resultSum != expectedSum { + t.Fatalf("expected [%s] but got [%s]", expectedSum, resultSum) + } +} + +var ( + md5THash = NewTHash("md5", md5.New) + sha1Hash = NewTHash("sha1", sha1.New) + sha224Hash = NewTHash("sha224", sha256.New224) + sha384Hash = NewTHash("sha384", sha512.New384) + sha512Hash = NewTHash("sha512", sha512.New) +) + +// Test all the build-in read size : buf8K, buf16K, buf32K and more +func TestTarSumsReadSize(t *testing.T) { + // Test always on the same layer (that is big enough) + layer := testLayers[0] + + for i := 0; i < 5; i++ { + + reader, err := os.Open(layer.filename) + if err != nil { + t.Fatal(err) + } + ts, err := NewTarSum(reader, false, layer.version) + if err != nil { + t.Fatal(err) + } + + // Read and discard bytes so that it populates sums + nbByteToRead := (i + 1) * 8 * 1024 + dBuf := make([]byte, nbByteToRead) + _, err = ts.Read(dBuf) + if err != nil { + t.Errorf("failed to read %vKB from %s: %s", nbByteToRead, layer.filename, err) + continue + } + } +} + +func TestTarSums(t *testing.T) { + for _, layer := range testLayers { + var ( + fh io.Reader + err error + ) + if len(layer.filename) > 0 { + fh, err = os.Open(layer.filename) + if err != nil { + t.Errorf("failed to open %s: %s", layer.filename, err) + continue + } + } else if layer.options != nil { + fh = sizedTar(*layer.options) + } else { + // What else is there to test? + t.Errorf("what to do with %#v", layer) + continue + } + if file, ok := fh.(*os.File); ok { + defer file.Close() + } + + var ts TarSum + if layer.hash == nil { + // double negatives! + ts, err = NewTarSum(fh, !layer.gzip, layer.version) + } else { + ts, err = NewTarSumHash(fh, !layer.gzip, layer.version, layer.hash) + } + if err != nil { + t.Errorf("%q :: %q", err, layer.filename) + continue + } + + // Read variable number of bytes to test dynamic buffer + dBuf := make([]byte, 1) + _, err = ts.Read(dBuf) + if err != nil { + t.Errorf("failed to read 1B from %s: %s", layer.filename, err) + continue + } + dBuf = make([]byte, 16*1024) + _, err = ts.Read(dBuf) + if err != nil { + t.Errorf("failed to read 16KB from %s: %s", layer.filename, err) + continue + } + + // Read and discard remaining bytes + _, err = io.Copy(ioutil.Discard, ts) + if err != nil { + t.Errorf("failed to copy from %s: %s", layer.filename, err) + continue + } + var gotSum string + if len(layer.jsonfile) > 0 { + jfh, err := os.Open(layer.jsonfile) + if err != nil { + t.Errorf("failed to open %s: %s", layer.jsonfile, err) + continue + } + buf, err := ioutil.ReadAll(jfh) + if err != nil { + t.Errorf("failed to readAll %s: %s", layer.jsonfile, err) + continue + } + gotSum = ts.Sum(buf) + } else { + gotSum = ts.Sum(nil) + } + + if layer.tarsum != gotSum { + t.Errorf("expecting [%s], but got [%s]", layer.tarsum, gotSum) + } + var expectedHashName string + if layer.hash != nil { + expectedHashName = layer.hash.Name() + } else { + expectedHashName = DefaultTHash.Name() + } + if expectedHashName != ts.Hash().Name() { + t.Errorf("expecting hash [%v], but got [%s]", expectedHashName, ts.Hash().Name()) + } + } +} + +func TestIteration(t *testing.T) { + headerTests := []struct { + expectedSum string // TODO(vbatts) it would be nice to get individual sums of each + version Version + hdr *tar.Header + data []byte + }{ + { + "tarsum+sha256:626c4a2e9a467d65c33ae81f7f3dedd4de8ccaee72af73223c4bc4718cbc7bbd", + Version0, + &tar.Header{ + Name: "file.txt", + Size: 0, + Typeflag: tar.TypeReg, + Devminor: 0, + Devmajor: 0, + }, + []byte(""), + }, + { + "tarsum.dev+sha256:6ffd43a1573a9913325b4918e124ee982a99c0f3cba90fc032a65f5e20bdd465", + VersionDev, + &tar.Header{ + Name: "file.txt", + Size: 0, + Typeflag: tar.TypeReg, + Devminor: 0, + Devmajor: 0, + }, + []byte(""), + }, + { + "tarsum.dev+sha256:b38166c059e11fb77bef30bf16fba7584446e80fcc156ff46d47e36c5305d8ef", + VersionDev, + &tar.Header{ + Name: "another.txt", + Uid: 1000, + Gid: 1000, + Uname: "slartibartfast", + Gname: "users", + Size: 4, + Typeflag: tar.TypeReg, + Devminor: 0, + Devmajor: 0, + }, + []byte("test"), + }, + { + "tarsum.dev+sha256:4cc2e71ac5d31833ab2be9b4f7842a14ce595ec96a37af4ed08f87bc374228cd", + VersionDev, + &tar.Header{ + Name: "xattrs.txt", + Uid: 1000, + Gid: 1000, + Uname: "slartibartfast", + Gname: "users", + Size: 4, + Typeflag: tar.TypeReg, + Xattrs: map[string]string{ + "user.key1": "value1", + "user.key2": "value2", + }, + }, + []byte("test"), + }, + { + "tarsum.dev+sha256:65f4284fa32c0d4112dd93c3637697805866415b570587e4fd266af241503760", + VersionDev, + &tar.Header{ + Name: "xattrs.txt", + Uid: 1000, + Gid: 1000, + Uname: "slartibartfast", + Gname: "users", + Size: 4, + Typeflag: tar.TypeReg, + Xattrs: map[string]string{ + "user.KEY1": "value1", // adding different case to ensure different sum + "user.key2": "value2", + }, + }, + []byte("test"), + }, + { + "tarsum+sha256:c12bb6f1303a9ddbf4576c52da74973c00d14c109bcfa76b708d5da1154a07fa", + Version0, + &tar.Header{ + Name: "xattrs.txt", + Uid: 1000, + Gid: 1000, + Uname: "slartibartfast", + Gname: "users", + Size: 4, + Typeflag: tar.TypeReg, + Xattrs: map[string]string{ + "user.NOT": "CALCULATED", + }, + }, + []byte("test"), + }, + } + for _, htest := range headerTests { + s, err := renderSumForHeader(htest.version, htest.hdr, htest.data) + if err != nil { + t.Fatal(err) + } + + if s != htest.expectedSum { + t.Errorf("expected sum: %q, got: %q", htest.expectedSum, s) + } + } + +} + +func renderSumForHeader(v Version, h *tar.Header, data []byte) (string, error) { + buf := bytes.NewBuffer(nil) + // first build our test tar + tw := tar.NewWriter(buf) + if err := tw.WriteHeader(h); err != nil { + return "", err + } + if _, err := tw.Write(data); err != nil { + return "", err + } + tw.Close() + + ts, err := NewTarSum(buf, true, v) + if err != nil { + return "", err + } + tr := tar.NewReader(ts) + for { + hdr, err := tr.Next() + if hdr == nil || err == io.EOF { + // Signals the end of the archive. + break + } + if err != nil { + return "", err + } + if _, err = io.Copy(ioutil.Discard, tr); err != nil { + return "", err + } + } + return ts.Sum(nil), nil +} + +func Benchmark9kTar(b *testing.B) { + buf := bytes.NewBuffer([]byte{}) + fh, err := os.Open("testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar") + if err != nil { + b.Error(err) + return + } + n, err := io.Copy(buf, fh) + fh.Close() + + reader := bytes.NewReader(buf.Bytes()) + + b.SetBytes(n) + b.ResetTimer() + for i := 0; i < b.N; i++ { + reader.Seek(0, 0) + ts, err := NewTarSum(reader, true, Version0) + if err != nil { + b.Error(err) + return + } + io.Copy(ioutil.Discard, ts) + ts.Sum(nil) + } +} + +func Benchmark9kTarGzip(b *testing.B) { + buf := bytes.NewBuffer([]byte{}) + fh, err := os.Open("testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar") + if err != nil { + b.Error(err) + return + } + n, err := io.Copy(buf, fh) + fh.Close() + + reader := bytes.NewReader(buf.Bytes()) + + b.SetBytes(n) + b.ResetTimer() + for i := 0; i < b.N; i++ { + reader.Seek(0, 0) + ts, err := NewTarSum(reader, false, Version0) + if err != nil { + b.Error(err) + return + } + io.Copy(ioutil.Discard, ts) + ts.Sum(nil) + } +} + +// this is a single big file in the tar archive +func Benchmark1mbSingleFileTar(b *testing.B) { + benchmarkTar(b, sizedOptions{1, 1024 * 1024, true, true}, false) +} + +// this is a single big file in the tar archive +func Benchmark1mbSingleFileTarGzip(b *testing.B) { + benchmarkTar(b, sizedOptions{1, 1024 * 1024, true, true}, true) +} + +// this is 1024 1k files in the tar archive +func Benchmark1kFilesTar(b *testing.B) { + benchmarkTar(b, sizedOptions{1024, 1024, true, true}, false) +} + +// this is 1024 1k files in the tar archive +func Benchmark1kFilesTarGzip(b *testing.B) { + benchmarkTar(b, sizedOptions{1024, 1024, true, true}, true) +} + +func benchmarkTar(b *testing.B, opts sizedOptions, isGzip bool) { + var fh *os.File + tarReader := sizedTar(opts) + if br, ok := tarReader.(*os.File); ok { + fh = br + } + defer os.Remove(fh.Name()) + defer fh.Close() + + b.SetBytes(opts.size * opts.num) + b.ResetTimer() + for i := 0; i < b.N; i++ { + ts, err := NewTarSum(fh, !isGzip, Version0) + if err != nil { + b.Error(err) + return + } + io.Copy(ioutil.Discard, ts) + ts.Sum(nil) + fh.Seek(0, 0) + } +} diff --git a/pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json b/pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json new file mode 100644 index 0000000000..48e2af349c --- /dev/null +++ b/pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/json @@ -0,0 +1 @@ +{"id":"46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457","parent":"def3f9165934325dfd027c86530b2ea49bb57a0963eb1336b3a0415ff6fd56de","created":"2014-04-07T02:45:52.610504484Z","container":"e0f07f8d72cae171a3dcc35859960e7e956e0628bce6fedc4122bf55b2c287c7","container_config":{"Hostname":"88807319f25e","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"ExposedPorts":null,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":["HOME=/","PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"],"Cmd":["/bin/sh","-c","sed -ri 's/^(%wheel.*)(ALL)$/\\1NOPASSWD: \\2/' /etc/sudoers"],"Image":"def3f9165934325dfd027c86530b2ea49bb57a0963eb1336b3a0415ff6fd56de","Volumes":null,"WorkingDir":"","Entrypoint":null,"NetworkDisabled":false,"OnBuild":[]},"docker_version":"0.9.1-dev","config":{"Hostname":"88807319f25e","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"ExposedPorts":null,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":["HOME=/","PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"],"Cmd":null,"Image":"def3f9165934325dfd027c86530b2ea49bb57a0963eb1336b3a0415ff6fd56de","Volumes":null,"WorkingDir":"","Entrypoint":null,"NetworkDisabled":false,"OnBuild":[]},"architecture":"amd64","os":"linux","Size":3425} \ No newline at end of file diff --git a/pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar b/pkg/tarsum/testdata/46af0962ab5afeb5ce6740d4d91652e69206fc991fd5328c1a94d364ad00e457/layer.tar new file mode 100644 index 0000000000000000000000000000000000000000..dfd5c204aea77673f13fdd2f81cb4af1c155c00c GIT binary patch literal 9216 zcmeHMYfsx)8s=;H6|bl&iYAZ?p-5<1$(y*vYHk~c?XX{vu}|fzRr1|&zyvK1! zQq)nWWVPA}63Myvy*}^F5Qtg*V8=g=M!Ru&adFTnf40B*^q|=~Z#CM@#>M%EgGRH_ zXtfULV#j(J_Jz`34wZgZ*0ym!%kRHL9{_(p&BZRoHJYu)<>loz?$!PU{9Bjp<^i?p zS)Tg!r=9Az$G@(0Ao6^75%A;qpMSV)ukcqQn%1X5y|oh!_xLmZX`y%GUBmQG;D6af z{a@yPg@1D=8t(B&ZtcXgE2ck=f9pf*x&ANlU$J}L#UB59rsJ=#>(otde**vZ1?PXJ z)y|dMh8z!Kfh=;zN!B|J)*y8)L$Hbq5c2K_rK=l{{8R8czxwV#$Odd zDsuJ8oS)h8`+U3IsNVOszdy8F?XCC!X1jHMK)Xr!XT8koFP{Hz-;!IxPhJ$Ib48h# zYv~t}ms6n-7Nk?ki-cxgF4IDhpT@D51d2R$2x=V)%F|Svhif#KI>gHaB|@O7JU(A% zo>KEP56(cuboN&-&LROexgfmf&txD1^0c9NNVQI5N~dNwm64!nnnQFH317=JF`{vu zi^$WUtCWHQq4Y!Yy@W{oRoV29sUd<=@!~sJ;!ok8>_qYfz|Ch12+9P6$8i`#qvqS zhsLT-8QL!zwhRx(aXaYF&PwD5LLOm%T#Ds>) z{YV0A>qPL*aFLnz9*nfyl@!I3_Ss=Y=MKNEA zG8|$lPj#9`#(W1sgCgK@f)P?2A)0uPB8Gf6TLITOAl@|29e$jAvBox=W-QCrr59N% zKg$7Xy=69F7QR_X7D_-i2hs*J)6%&RIBr9LDPPP_-? z-X`DPuwzY(j+Gk=rWL_Msfvvp-prW$3W(MwPPgEZO^EI!{*XIAuLp zlpj9k85vO{{2kR4hD{4c;~{+QmhNVfq;xeepJc>QQ@QJfEkdQVBbPJuiA~nsv9l~O zrN&UpxC9i`6;rQ>v?7%WUrr@(gXOs4JE=IN=}4(?RS=2GEd9-ogTEiuP>Fqyb6;vM ziV-Q;Z|ZT?Vz^rPk?`^}6a`cC_=9V1=*>jc&y0jq{h|=m&BK+Jpv}ea1?sKVi^Gj` zk<9K*;4?gK^?Jl6-g0L4kQcX>OZUHi{>Odi#u~f!gnqSdCpW{f zGr2q31WO6O$i;nz9#NH-D^8Rv6Xcv%XFkhmyBsZ;8k2ftd;fPtN1v+`G zPRv~5E)wm1y}~(Py9GwK;`;9K2C_2#(Rc=qFBTa z>?ZUNHvSmq9G9)M%0u+CW!J=jv1~Clz-avUIImk%<&=a9uI;2EY~~stiCKTsh|Oow<5; z$eY1%WV!B_?iFikc)C2TV46YQucl=WfmM#jY|_4sK>Njf)j#u#Y{x@V_A!c2o<`D? zX*2YQ4A)U054Qh4y3hVk?0?5^Us~rh*TViU9vl!r009ILKmY**5I_I{1Q0*~0R#|0 Y009ILKmY**5I_I{1Q0*~fqxTt0{2EK)Bpeg literal 0 HcmV?d00001 diff --git a/pkg/tarsum/testdata/collision/collision-2.tar b/pkg/tarsum/testdata/collision/collision-2.tar new file mode 100644 index 0000000000000000000000000000000000000000..7b5c04a9644808851fcccab5c3c240bf342abd93 GIT binary patch literal 10240 zcmeIuF%E+;425COJw=XS2L~?Dp<74P5hRe1I+e8NZ(w35>V(Abzr};)_<@(2e`|Ha`Z>GG~@_KYd${~ON w0tg_000IagfB*srAbVE5xzPBd+@To)G|2840byWhU|?oqf;;~Mb02E{2kHRk de~R-YhD)#rjPU%AB}7JrMnhmU1V%^*0091(G-Ch& literal 0 HcmV?d00001 diff --git a/pkg/tarsum/versioning.go b/pkg/tarsum/versioning.go new file mode 100644 index 0000000000..2882286854 --- /dev/null +++ b/pkg/tarsum/versioning.go @@ -0,0 +1,150 @@ +package tarsum + +import ( + "archive/tar" + "errors" + "sort" + "strconv" + "strings" +) + +// Version is used for versioning of the TarSum algorithm +// based on the prefix of the hash used +// i.e. "tarsum+sha256:e58fcf7418d4390dec8e8fb69d88c06ec07039d651fedd3aa72af9972e7d046b" +type Version int + +// Prefix of "tarsum" +const ( + Version0 Version = iota + Version1 + // VersionDev this constant will be either the latest or an unsettled next-version of the TarSum calculation + VersionDev +) + +// VersionLabelForChecksum returns the label for the given tarsum +// checksum, i.e., everything before the first `+` character in +// the string or an empty string if no label separator is found. +func VersionLabelForChecksum(checksum string) string { + // Checksums are in the form: {versionLabel}+{hashID}:{hex} + sepIndex := strings.Index(checksum, "+") + if sepIndex < 0 { + return "" + } + return checksum[:sepIndex] +} + +// GetVersions gets a list of all known tarsum versions. +func GetVersions() []Version { + v := []Version{} + for k := range tarSumVersions { + v = append(v, k) + } + return v +} + +var ( + tarSumVersions = map[Version]string{ + Version0: "tarsum", + Version1: "tarsum.v1", + VersionDev: "tarsum.dev", + } + tarSumVersionsByName = map[string]Version{ + "tarsum": Version0, + "tarsum.v1": Version1, + "tarsum.dev": VersionDev, + } +) + +func (tsv Version) String() string { + return tarSumVersions[tsv] +} + +// GetVersionFromTarsum returns the Version from the provided string. +func GetVersionFromTarsum(tarsum string) (Version, error) { + tsv := tarsum + if strings.Contains(tarsum, "+") { + tsv = strings.SplitN(tarsum, "+", 2)[0] + } + for v, s := range tarSumVersions { + if s == tsv { + return v, nil + } + } + return -1, ErrNotVersion +} + +// Errors that may be returned by functions in this package +var ( + ErrNotVersion = errors.New("string does not include a TarSum Version") + ErrVersionNotImplemented = errors.New("TarSum Version is not yet implemented") +) + +// tarHeaderSelector is the interface which different versions +// of tarsum should use for selecting and ordering tar headers +// for each item in the archive. +type tarHeaderSelector interface { + selectHeaders(h *tar.Header) (orderedHeaders [][2]string) +} + +type tarHeaderSelectFunc func(h *tar.Header) (orderedHeaders [][2]string) + +func (f tarHeaderSelectFunc) selectHeaders(h *tar.Header) (orderedHeaders [][2]string) { + return f(h) +} + +func v0TarHeaderSelect(h *tar.Header) (orderedHeaders [][2]string) { + return [][2]string{ + {"name", h.Name}, + {"mode", strconv.FormatInt(h.Mode, 10)}, + {"uid", strconv.Itoa(h.Uid)}, + {"gid", strconv.Itoa(h.Gid)}, + {"size", strconv.FormatInt(h.Size, 10)}, + {"mtime", strconv.FormatInt(h.ModTime.UTC().Unix(), 10)}, + {"typeflag", string([]byte{h.Typeflag})}, + {"linkname", h.Linkname}, + {"uname", h.Uname}, + {"gname", h.Gname}, + {"devmajor", strconv.FormatInt(h.Devmajor, 10)}, + {"devminor", strconv.FormatInt(h.Devminor, 10)}, + } +} + +func v1TarHeaderSelect(h *tar.Header) (orderedHeaders [][2]string) { + // Get extended attributes. + xAttrKeys := make([]string, len(h.Xattrs)) + for k := range h.Xattrs { + xAttrKeys = append(xAttrKeys, k) + } + sort.Strings(xAttrKeys) + + // Make the slice with enough capacity to hold the 11 basic headers + // we want from the v0 selector plus however many xattrs we have. + orderedHeaders = make([][2]string, 0, 11+len(xAttrKeys)) + + // Copy all headers from v0 excluding the 'mtime' header (the 5th element). + v0headers := v0TarHeaderSelect(h) + orderedHeaders = append(orderedHeaders, v0headers[0:5]...) + orderedHeaders = append(orderedHeaders, v0headers[6:]...) + + // Finally, append the sorted xattrs. + for _, k := range xAttrKeys { + orderedHeaders = append(orderedHeaders, [2]string{k, h.Xattrs[k]}) + } + + return +} + +var registeredHeaderSelectors = map[Version]tarHeaderSelectFunc{ + Version0: v0TarHeaderSelect, + Version1: v1TarHeaderSelect, + VersionDev: v1TarHeaderSelect, +} + +func getTarHeaderSelector(v Version) (tarHeaderSelector, error) { + headerSelector, ok := registeredHeaderSelectors[v] + if !ok { + return nil, ErrVersionNotImplemented + } + + return headerSelector, nil +} diff --git a/pkg/tarsum/versioning_test.go b/pkg/tarsum/versioning_test.go new file mode 100644 index 0000000000..88e0a5783c --- /dev/null +++ b/pkg/tarsum/versioning_test.go @@ -0,0 +1,98 @@ +package tarsum + +import ( + "testing" +) + +func TestVersionLabelForChecksum(t *testing.T) { + version := VersionLabelForChecksum("tarsum+sha256:deadbeef") + if version != "tarsum" { + t.Fatalf("Version should have been 'tarsum', was %v", version) + } + version = VersionLabelForChecksum("tarsum.v1+sha256:deadbeef") + if version != "tarsum.v1" { + t.Fatalf("Version should have been 'tarsum.v1', was %v", version) + } + version = VersionLabelForChecksum("something+somethingelse") + if version != "something" { + t.Fatalf("Version should have been 'something', was %v", version) + } + version = VersionLabelForChecksum("invalidChecksum") + if version != "" { + t.Fatalf("Version should have been empty, was %v", version) + } +} + +func TestVersion(t *testing.T) { + expected := "tarsum" + var v Version + if v.String() != expected { + t.Errorf("expected %q, got %q", expected, v.String()) + } + + expected = "tarsum.v1" + v = 1 + if v.String() != expected { + t.Errorf("expected %q, got %q", expected, v.String()) + } + + expected = "tarsum.dev" + v = 2 + if v.String() != expected { + t.Errorf("expected %q, got %q", expected, v.String()) + } +} + +func TestGetVersion(t *testing.T) { + testSet := []struct { + Str string + Expected Version + }{ + {"tarsum+sha256:e58fcf7418d4390dec8e8fb69d88c06ec07039d651fedd3aa72af9972e7d046b", Version0}, + {"tarsum+sha256", Version0}, + {"tarsum", Version0}, + {"tarsum.dev", VersionDev}, + {"tarsum.dev+sha256:deadbeef", VersionDev}, + } + + for _, ts := range testSet { + v, err := GetVersionFromTarsum(ts.Str) + if err != nil { + t.Fatalf("%q : %s", err, ts.Str) + } + if v != ts.Expected { + t.Errorf("expected %d (%q), got %d (%q)", ts.Expected, ts.Expected, v, v) + } + } + + // test one that does not exist, to ensure it errors + str := "weak+md5:abcdeabcde" + _, err := GetVersionFromTarsum(str) + if err != ErrNotVersion { + t.Fatalf("%q : %s", err, str) + } +} + +func TestGetVersions(t *testing.T) { + expected := []Version{ + Version0, + Version1, + VersionDev, + } + versions := GetVersions() + if len(versions) != len(expected) { + t.Fatalf("Expected %v versions, got %v", len(expected), len(versions)) + } + if !containsVersion(versions, expected[0]) || !containsVersion(versions, expected[1]) || !containsVersion(versions, expected[2]) { + t.Fatalf("Expected [%v], got [%v]", expected, versions) + } +} + +func containsVersion(versions []Version, version Version) bool { + for _, v := range versions { + if v == version { + return true + } + } + return false +} diff --git a/pkg/tarsum/writercloser.go b/pkg/tarsum/writercloser.go new file mode 100644 index 0000000000..9727ecde3e --- /dev/null +++ b/pkg/tarsum/writercloser.go @@ -0,0 +1,22 @@ +package tarsum + +import ( + "io" +) + +type writeCloseFlusher interface { + io.WriteCloser + Flush() error +} + +type nopCloseFlusher struct { + io.Writer +} + +func (n *nopCloseFlusher) Close() error { + return nil +} + +func (n *nopCloseFlusher) Flush() error { + return nil +} diff --git a/pkg/term/tc_linux_cgo.go b/pkg/term/tc_linux_cgo.go new file mode 100644 index 0000000000..1005084fd2 --- /dev/null +++ b/pkg/term/tc_linux_cgo.go @@ -0,0 +1,51 @@ +// +build linux,cgo + +package term + +import ( + "syscall" + "unsafe" +) + +// #include +import "C" + +// Termios is the Unix API for terminal I/O. +// It is passthgrouh for syscall.Termios in order to make it portable with +// other platforms where it is not available or handled differently. +type Termios syscall.Termios + +// MakeRaw put the terminal connected to the given file descriptor into raw +// mode and returns the previous state of the terminal so that it can be +// restored. +func MakeRaw(fd uintptr) (*State, error) { + var oldState State + if err := tcget(fd, &oldState.termios); err != 0 { + return nil, err + } + + newState := oldState.termios + + C.cfmakeraw((*C.struct_termios)(unsafe.Pointer(&newState))) + newState.Oflag = newState.Oflag | C.OPOST + if err := tcset(fd, &newState); err != 0 { + return nil, err + } + return &oldState, nil +} + +func tcget(fd uintptr, p *Termios) syscall.Errno { + ret, err := C.tcgetattr(C.int(fd), (*C.struct_termios)(unsafe.Pointer(p))) + if ret != 0 { + return err.(syscall.Errno) + } + return 0 +} + +func tcset(fd uintptr, p *Termios) syscall.Errno { + ret, err := C.tcsetattr(C.int(fd), C.TCSANOW, (*C.struct_termios)(unsafe.Pointer(p))) + if ret != 0 { + return err.(syscall.Errno) + } + return 0 +} diff --git a/pkg/term/tc_other.go b/pkg/term/tc_other.go new file mode 100644 index 0000000000..266039bac3 --- /dev/null +++ b/pkg/term/tc_other.go @@ -0,0 +1,19 @@ +// +build !windows +// +build !linux !cgo + +package term + +import ( + "syscall" + "unsafe" +) + +func tcget(fd uintptr, p *Termios) syscall.Errno { + _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(getTermios), uintptr(unsafe.Pointer(p))) + return err +} + +func tcset(fd uintptr, p *Termios) syscall.Errno { + _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, setTermios, uintptr(unsafe.Pointer(p))) + return err +} diff --git a/pkg/term/term.go b/pkg/term/term.go new file mode 100644 index 0000000000..7912ae43e3 --- /dev/null +++ b/pkg/term/term.go @@ -0,0 +1,132 @@ +// +build !windows + +// Package term provides provides structures and helper functions to work with +// terminal (state, sizes). +package term + +import ( + "errors" + "io" + "os" + "os/signal" + "syscall" + "unsafe" +) + +var ( + // ErrInvalidState is returned if the state of the terminal is invalid. + ErrInvalidState = errors.New("Invalid terminal state") +) + +// State represents the state of the terminal. +type State struct { + termios Termios +} + +// Winsize represents the size of the terminal window. +type Winsize struct { + Height uint16 + Width uint16 + x uint16 + y uint16 +} + +// StdStreams returns the standard streams (stdin, stdout, stedrr). +func StdStreams() (stdIn io.ReadCloser, stdOut, stdErr io.Writer) { + return os.Stdin, os.Stdout, os.Stderr +} + +// GetFdInfo returns the file descriptor for an os.File and indicates whether the file represents a terminal. +func GetFdInfo(in interface{}) (uintptr, bool) { + var inFd uintptr + var isTerminalIn bool + if file, ok := in.(*os.File); ok { + inFd = file.Fd() + isTerminalIn = IsTerminal(inFd) + } + return inFd, isTerminalIn +} + +// GetWinsize returns the window size based on the specified file descriptor. +func GetWinsize(fd uintptr) (*Winsize, error) { + ws := &Winsize{} + _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(syscall.TIOCGWINSZ), uintptr(unsafe.Pointer(ws))) + // Skipp errno = 0 + if err == 0 { + return ws, nil + } + return ws, err +} + +// SetWinsize tries to set the specified window size for the specified file descriptor. +func SetWinsize(fd uintptr, ws *Winsize) error { + _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(syscall.TIOCSWINSZ), uintptr(unsafe.Pointer(ws))) + // Skipp errno = 0 + if err == 0 { + return nil + } + return err +} + +// IsTerminal returns true if the given file descriptor is a terminal. +func IsTerminal(fd uintptr) bool { + var termios Termios + return tcget(fd, &termios) == 0 +} + +// RestoreTerminal restores the terminal connected to the given file descriptor +// to a previous state. +func RestoreTerminal(fd uintptr, state *State) error { + if state == nil { + return ErrInvalidState + } + if err := tcset(fd, &state.termios); err != 0 { + return err + } + return nil +} + +// SaveState saves the state of the terminal connected to the given file descriptor. +func SaveState(fd uintptr) (*State, error) { + var oldState State + if err := tcget(fd, &oldState.termios); err != 0 { + return nil, err + } + + return &oldState, nil +} + +// DisableEcho applies the specified state to the terminal connected to the file +// descriptor, with echo disabled. +func DisableEcho(fd uintptr, state *State) error { + newState := state.termios + newState.Lflag &^= syscall.ECHO + + if err := tcset(fd, &newState); err != 0 { + return err + } + handleInterrupt(fd, state) + return nil +} + +// SetRawTerminal puts the terminal connected to the given file descriptor into +// raw mode and returns the previous state. +func SetRawTerminal(fd uintptr) (*State, error) { + oldState, err := MakeRaw(fd) + if err != nil { + return nil, err + } + handleInterrupt(fd, oldState) + return oldState, err +} + +func handleInterrupt(fd uintptr, state *State) { + sigchan := make(chan os.Signal, 1) + signal.Notify(sigchan, os.Interrupt) + + go func() { + _ = <-sigchan + RestoreTerminal(fd, state) + os.Exit(0) + }() +} diff --git a/pkg/term/term_windows.go b/pkg/term/term_windows.go new file mode 100644 index 0000000000..da9295eec6 --- /dev/null +++ b/pkg/term/term_windows.go @@ -0,0 +1,205 @@ +// +build windows + +package term + +import ( + "fmt" + "io" + "os" + "os/signal" + + "github.com/Azure/go-ansiterm/winterm" + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/term/windows" +) + +// State holds the console mode for the terminal. +type State struct { + mode uint32 +} + +// Winsize is used for window size. +type Winsize struct { + Height uint16 + Width uint16 + x uint16 + y uint16 +} + +// StdStreams returns the standard streams (stdin, stdout, stedrr). +func StdStreams() (stdIn io.ReadCloser, stdOut, stdErr io.Writer) { + switch { + case os.Getenv("ConEmuANSI") == "ON": + // The ConEmu shell emulates ANSI well by default. + return os.Stdin, os.Stdout, os.Stderr + case os.Getenv("MSYSTEM") != "": + // MSYS (mingw) does not emulate ANSI well. + return windows.ConsoleStreams() + default: + return windows.ConsoleStreams() + } +} + +// GetFdInfo returns the file descriptor for an os.File and indicates whether the file represents a terminal. +func GetFdInfo(in interface{}) (uintptr, bool) { + return windows.GetHandleInfo(in) +} + +// GetWinsize returns the window size based on the specified file descriptor. +func GetWinsize(fd uintptr) (*Winsize, error) { + + info, err := winterm.GetConsoleScreenBufferInfo(fd) + if err != nil { + return nil, err + } + + winsize := &Winsize{ + Width: uint16(info.Window.Right - info.Window.Left + 1), + Height: uint16(info.Window.Bottom - info.Window.Top + 1), + x: 0, + y: 0} + + // Note: GetWinsize is called frequently -- uncomment only for excessive details + // logrus.Debugf("[windows] GetWinsize: Console(%v)", info.String()) + // logrus.Debugf("[windows] GetWinsize: Width(%v), Height(%v), x(%v), y(%v)", winsize.Width, winsize.Height, winsize.x, winsize.y) + return winsize, nil +} + +// SetWinsize tries to set the specified window size for the specified file descriptor. +func SetWinsize(fd uintptr, ws *Winsize) error { + + // Ensure the requested dimensions are no larger than the maximum window size + info, err := winterm.GetConsoleScreenBufferInfo(fd) + if err != nil { + return err + } + + if ws.Width == 0 || ws.Height == 0 || ws.Width > uint16(info.MaximumWindowSize.X) || ws.Height > uint16(info.MaximumWindowSize.Y) { + return fmt.Errorf("Illegal window size: (%v,%v) -- Maximum allow: (%v,%v)", + ws.Width, ws.Height, info.MaximumWindowSize.X, info.MaximumWindowSize.Y) + } + + // Narrow the sizes to that used by Windows + width := winterm.SHORT(ws.Width) + height := winterm.SHORT(ws.Height) + + // Set the dimensions while ensuring they remain within the bounds of the backing console buffer + // -- Shrinking will always succeed. Growing may push the edges past the buffer boundary. When that occurs, + // shift the upper left just enough to keep the new window within the buffer. + rect := info.Window + if width < rect.Right-rect.Left+1 { + rect.Right = rect.Left + width - 1 + } else if width > rect.Right-rect.Left+1 { + rect.Right = rect.Left + width - 1 + if rect.Right >= info.Size.X { + rect.Left = info.Size.X - width + rect.Right = info.Size.X - 1 + } + } + + if height < rect.Bottom-rect.Top+1 { + rect.Bottom = rect.Top + height - 1 + } else if height > rect.Bottom-rect.Top+1 { + rect.Bottom = rect.Top + height - 1 + if rect.Bottom >= info.Size.Y { + rect.Top = info.Size.Y - height + rect.Bottom = info.Size.Y - 1 + } + } + logrus.Debugf("[windows] SetWinsize: Requested((%v,%v)) Actual(%v)", ws.Width, ws.Height, rect) + + return winterm.SetConsoleWindowInfo(fd, true, rect) +} + +// IsTerminal returns true if the given file descriptor is a terminal. +func IsTerminal(fd uintptr) bool { + return windows.IsConsole(fd) +} + +// RestoreTerminal restores the terminal connected to the given file descriptor +// to a previous state. +func RestoreTerminal(fd uintptr, state *State) error { + return winterm.SetConsoleMode(fd, state.mode) +} + +// SaveState saves the state of the terminal connected to the given file descriptor. +func SaveState(fd uintptr) (*State, error) { + mode, e := winterm.GetConsoleMode(fd) + if e != nil { + return nil, e + } + return &State{mode}, nil +} + +// DisableEcho disables echo for the terminal connected to the given file descriptor. +// -- See https://msdn.microsoft.com/en-us/library/windows/desktop/ms683462(v=vs.85).aspx +func DisableEcho(fd uintptr, state *State) error { + mode := state.mode + mode &^= winterm.ENABLE_ECHO_INPUT + mode |= winterm.ENABLE_PROCESSED_INPUT | winterm.ENABLE_LINE_INPUT + + err := winterm.SetConsoleMode(fd, mode) + if err != nil { + return err + } + + // Register an interrupt handler to catch and restore prior state + restoreAtInterrupt(fd, state) + return nil +} + +// SetRawTerminal puts the terminal connected to the given file descriptor into raw +// mode and returns the previous state. +func SetRawTerminal(fd uintptr) (*State, error) { + state, err := MakeRaw(fd) + if err != nil { + return nil, err + } + + // Register an interrupt handler to catch and restore prior state + restoreAtInterrupt(fd, state) + return state, err +} + +// MakeRaw puts the terminal (Windows Console) connected to the given file descriptor into raw +// mode and returns the previous state of the terminal so that it can be restored. +func MakeRaw(fd uintptr) (*State, error) { + state, err := SaveState(fd) + if err != nil { + return nil, err + } + + // See + // -- https://msdn.microsoft.com/en-us/library/windows/desktop/ms686033(v=vs.85).aspx + // -- https://msdn.microsoft.com/en-us/library/windows/desktop/ms683462(v=vs.85).aspx + mode := state.mode + + // Disable these modes + mode &^= winterm.ENABLE_ECHO_INPUT + mode &^= winterm.ENABLE_LINE_INPUT + mode &^= winterm.ENABLE_MOUSE_INPUT + mode &^= winterm.ENABLE_WINDOW_INPUT + mode &^= winterm.ENABLE_PROCESSED_INPUT + + // Enable these modes + mode |= winterm.ENABLE_EXTENDED_FLAGS + mode |= winterm.ENABLE_INSERT_MODE + mode |= winterm.ENABLE_QUICK_EDIT_MODE + + err = winterm.SetConsoleMode(fd, mode) + if err != nil { + return nil, err + } + return state, nil +} + +func restoreAtInterrupt(fd uintptr, state *State) { + sigchan := make(chan os.Signal, 1) + signal.Notify(sigchan, os.Interrupt) + + go func() { + _ = <-sigchan + RestoreTerminal(fd, state) + os.Exit(0) + }() +} diff --git a/pkg/term/termios_darwin.go b/pkg/term/termios_darwin.go new file mode 100644 index 0000000000..480db900ac --- /dev/null +++ b/pkg/term/termios_darwin.go @@ -0,0 +1,69 @@ +package term + +import ( + "syscall" + "unsafe" +) + +const ( + getTermios = syscall.TIOCGETA + setTermios = syscall.TIOCSETA +) + +// Termios magic numbers, passthrough to the ones defined in syscall. +const ( + IGNBRK = syscall.IGNBRK + PARMRK = syscall.PARMRK + INLCR = syscall.INLCR + IGNCR = syscall.IGNCR + ECHONL = syscall.ECHONL + CSIZE = syscall.CSIZE + ICRNL = syscall.ICRNL + ISTRIP = syscall.ISTRIP + PARENB = syscall.PARENB + ECHO = syscall.ECHO + ICANON = syscall.ICANON + ISIG = syscall.ISIG + IXON = syscall.IXON + BRKINT = syscall.BRKINT + INPCK = syscall.INPCK + OPOST = syscall.OPOST + CS8 = syscall.CS8 + IEXTEN = syscall.IEXTEN +) + +// Termios is the Unix API for terminal I/O. +type Termios struct { + Iflag uint64 + Oflag uint64 + Cflag uint64 + Lflag uint64 + Cc [20]byte + Ispeed uint64 + Ospeed uint64 +} + +// MakeRaw put the terminal connected to the given file descriptor into raw +// mode and returns the previous state of the terminal so that it can be +// restored. +func MakeRaw(fd uintptr) (*State, error) { + var oldState State + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(getTermios), uintptr(unsafe.Pointer(&oldState.termios))); err != 0 { + return nil, err + } + + newState := oldState.termios + newState.Iflag &^= (IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL | IXON) + newState.Oflag &^= OPOST + newState.Lflag &^= (ECHO | ECHONL | ICANON | ISIG | IEXTEN) + newState.Cflag &^= (CSIZE | PARENB) + newState.Cflag |= CS8 + newState.Cc[syscall.VMIN] = 1 + newState.Cc[syscall.VTIME] = 0 + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(setTermios), uintptr(unsafe.Pointer(&newState))); err != 0 { + return nil, err + } + + return &oldState, nil +} diff --git a/pkg/term/termios_freebsd.go b/pkg/term/termios_freebsd.go new file mode 100644 index 0000000000..ed843ad69c --- /dev/null +++ b/pkg/term/termios_freebsd.go @@ -0,0 +1,69 @@ +package term + +import ( + "syscall" + "unsafe" +) + +const ( + getTermios = syscall.TIOCGETA + setTermios = syscall.TIOCSETA +) + +// Termios magic numbers, passthrough to the ones defined in syscall. +const ( + IGNBRK = syscall.IGNBRK + PARMRK = syscall.PARMRK + INLCR = syscall.INLCR + IGNCR = syscall.IGNCR + ECHONL = syscall.ECHONL + CSIZE = syscall.CSIZE + ICRNL = syscall.ICRNL + ISTRIP = syscall.ISTRIP + PARENB = syscall.PARENB + ECHO = syscall.ECHO + ICANON = syscall.ICANON + ISIG = syscall.ISIG + IXON = syscall.IXON + BRKINT = syscall.BRKINT + INPCK = syscall.INPCK + OPOST = syscall.OPOST + CS8 = syscall.CS8 + IEXTEN = syscall.IEXTEN +) + +// Termios is the Unix API for terminal I/O. +type Termios struct { + Iflag uint32 + Oflag uint32 + Cflag uint32 + Lflag uint32 + Cc [20]byte + Ispeed uint32 + Ospeed uint32 +} + +// MakeRaw put the terminal connected to the given file descriptor into raw +// mode and returns the previous state of the terminal so that it can be +// restored. +func MakeRaw(fd uintptr) (*State, error) { + var oldState State + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(getTermios), uintptr(unsafe.Pointer(&oldState.termios))); err != 0 { + return nil, err + } + + newState := oldState.termios + newState.Iflag &^= (IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL | IXON) + newState.Oflag &^= OPOST + newState.Lflag &^= (ECHO | ECHONL | ICANON | ISIG | IEXTEN) + newState.Cflag &^= (CSIZE | PARENB) + newState.Cflag |= CS8 + newState.Cc[syscall.VMIN] = 1 + newState.Cc[syscall.VTIME] = 0 + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, uintptr(setTermios), uintptr(unsafe.Pointer(&newState))); err != 0 { + return nil, err + } + + return &oldState, nil +} diff --git a/pkg/term/termios_linux.go b/pkg/term/termios_linux.go new file mode 100644 index 0000000000..22921b6aef --- /dev/null +++ b/pkg/term/termios_linux.go @@ -0,0 +1,47 @@ +// +build !cgo + +package term + +import ( + "syscall" + "unsafe" +) + +const ( + getTermios = syscall.TCGETS + setTermios = syscall.TCSETS +) + +// Termios is the Unix API for terminal I/O. +type Termios struct { + Iflag uint32 + Oflag uint32 + Cflag uint32 + Lflag uint32 + Cc [20]byte + Ispeed uint32 + Ospeed uint32 +} + +// MakeRaw put the terminal connected to the given file descriptor into raw +// mode and returns the previous state of the terminal so that it can be +// restored. +func MakeRaw(fd uintptr) (*State, error) { + var oldState State + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, getTermios, uintptr(unsafe.Pointer(&oldState.termios))); err != 0 { + return nil, err + } + + newState := oldState.termios + + newState.Iflag &^= (syscall.IGNBRK | syscall.BRKINT | syscall.PARMRK | syscall.ISTRIP | syscall.INLCR | syscall.IGNCR | syscall.ICRNL | syscall.IXON) + newState.Oflag &^= syscall.OPOST + newState.Lflag &^= (syscall.ECHO | syscall.ECHONL | syscall.ICANON | syscall.ISIG | syscall.IEXTEN) + newState.Cflag &^= (syscall.CSIZE | syscall.PARENB) + newState.Cflag |= syscall.CS8 + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, fd, setTermios, uintptr(unsafe.Pointer(&newState))); err != 0 { + return nil, err + } + return &oldState, nil +} diff --git a/pkg/term/windows/ansi_reader.go b/pkg/term/windows/ansi_reader.go new file mode 100644 index 0000000000..bb47e120ab --- /dev/null +++ b/pkg/term/windows/ansi_reader.go @@ -0,0 +1,256 @@ +// +build windows + +package windows + +import ( + "bytes" + "errors" + "fmt" + "os" + "strings" + "unsafe" + + ansiterm "github.com/Azure/go-ansiterm" + "github.com/Azure/go-ansiterm/winterm" +) + +// ansiReader wraps a standard input file (e.g., os.Stdin) providing ANSI sequence translation. +type ansiReader struct { + file *os.File + fd uintptr + buffer []byte + cbBuffer int + command []byte + // TODO(azlinux): Remove this and hard-code the string -- it is not going to change + escapeSequence []byte +} + +func newAnsiReader(nFile int) *ansiReader { + file, fd := winterm.GetStdFile(nFile) + return &ansiReader{ + file: file, + fd: fd, + command: make([]byte, 0, ansiterm.ANSI_MAX_CMD_LENGTH), + escapeSequence: []byte(ansiterm.KEY_ESC_CSI), + buffer: make([]byte, 0), + } +} + +// Close closes the wrapped file. +func (ar *ansiReader) Close() (err error) { + return ar.file.Close() +} + +// Fd returns the file descriptor of the wrapped file. +func (ar *ansiReader) Fd() uintptr { + return ar.fd +} + +// Read reads up to len(p) bytes of translated input events into p. +func (ar *ansiReader) Read(p []byte) (int, error) { + if len(p) == 0 { + return 0, nil + } + + // Previously read bytes exist, read as much as we can and return + if len(ar.buffer) > 0 { + logger.Debugf("Reading previously cached bytes") + + originalLength := len(ar.buffer) + copiedLength := copy(p, ar.buffer) + + if copiedLength == originalLength { + ar.buffer = make([]byte, 0, len(p)) + } else { + ar.buffer = ar.buffer[copiedLength:] + } + + logger.Debugf("Read from cache p[%d]: % x", copiedLength, p) + return copiedLength, nil + } + + // Read and translate key events + events, err := readInputEvents(ar.fd, len(p)) + if err != nil { + return 0, err + } else if len(events) == 0 { + logger.Debug("No input events detected") + return 0, nil + } + + keyBytes := translateKeyEvents(events, ar.escapeSequence) + + // Save excess bytes and right-size keyBytes + if len(keyBytes) > len(p) { + logger.Debugf("Received %d keyBytes, only room for %d bytes", len(keyBytes), len(p)) + ar.buffer = keyBytes[len(p):] + keyBytes = keyBytes[:len(p)] + } else if len(keyBytes) == 0 { + logger.Debug("No key bytes returned from the translator") + return 0, nil + } + + copiedLength := copy(p, keyBytes) + if copiedLength != len(keyBytes) { + return 0, errors.New("Unexpected copy length encountered.") + } + + logger.Debugf("Read p[%d]: % x", copiedLength, p) + logger.Debugf("Read keyBytes[%d]: % x", copiedLength, keyBytes) + return copiedLength, nil +} + +// readInputEvents polls until at least one event is available. +func readInputEvents(fd uintptr, maxBytes int) ([]winterm.INPUT_RECORD, error) { + // Determine the maximum number of records to retrieve + // -- Cast around the type system to obtain the size of a single INPUT_RECORD. + // unsafe.Sizeof requires an expression vs. a type-reference; the casting + // tricks the type system into believing it has such an expression. + recordSize := int(unsafe.Sizeof(*((*winterm.INPUT_RECORD)(unsafe.Pointer(&maxBytes))))) + countRecords := maxBytes / recordSize + if countRecords > ansiterm.MAX_INPUT_EVENTS { + countRecords = ansiterm.MAX_INPUT_EVENTS + } + logger.Debugf("[windows] readInputEvents: Reading %v records (buffer size %v, record size %v)", countRecords, maxBytes, recordSize) + + // Wait for and read input events + events := make([]winterm.INPUT_RECORD, countRecords) + nEvents := uint32(0) + eventsExist, err := winterm.WaitForSingleObject(fd, winterm.WAIT_INFINITE) + if err != nil { + return nil, err + } + + if eventsExist { + err = winterm.ReadConsoleInput(fd, events, &nEvents) + if err != nil { + return nil, err + } + } + + // Return a slice restricted to the number of returned records + logger.Debugf("[windows] readInputEvents: Read %v events", nEvents) + return events[:nEvents], nil +} + +// KeyEvent Translation Helpers + +var arrowKeyMapPrefix = map[winterm.WORD]string{ + winterm.VK_UP: "%s%sA", + winterm.VK_DOWN: "%s%sB", + winterm.VK_RIGHT: "%s%sC", + winterm.VK_LEFT: "%s%sD", +} + +var keyMapPrefix = map[winterm.WORD]string{ + winterm.VK_UP: "\x1B[%sA", + winterm.VK_DOWN: "\x1B[%sB", + winterm.VK_RIGHT: "\x1B[%sC", + winterm.VK_LEFT: "\x1B[%sD", + winterm.VK_HOME: "\x1B[1%s~", // showkey shows ^[[1 + winterm.VK_END: "\x1B[4%s~", // showkey shows ^[[4 + winterm.VK_INSERT: "\x1B[2%s~", + winterm.VK_DELETE: "\x1B[3%s~", + winterm.VK_PRIOR: "\x1B[5%s~", + winterm.VK_NEXT: "\x1B[6%s~", + winterm.VK_F1: "", + winterm.VK_F2: "", + winterm.VK_F3: "\x1B[13%s~", + winterm.VK_F4: "\x1B[14%s~", + winterm.VK_F5: "\x1B[15%s~", + winterm.VK_F6: "\x1B[17%s~", + winterm.VK_F7: "\x1B[18%s~", + winterm.VK_F8: "\x1B[19%s~", + winterm.VK_F9: "\x1B[20%s~", + winterm.VK_F10: "\x1B[21%s~", + winterm.VK_F11: "\x1B[23%s~", + winterm.VK_F12: "\x1B[24%s~", +} + +// translateKeyEvents converts the input events into the appropriate ANSI string. +func translateKeyEvents(events []winterm.INPUT_RECORD, escapeSequence []byte) []byte { + var buffer bytes.Buffer + for _, event := range events { + if event.EventType == winterm.KEY_EVENT && event.KeyEvent.KeyDown != 0 { + buffer.WriteString(keyToString(&event.KeyEvent, escapeSequence)) + } + } + + return buffer.Bytes() +} + +// keyToString maps the given input event record to the corresponding string. +func keyToString(keyEvent *winterm.KEY_EVENT_RECORD, escapeSequence []byte) string { + if keyEvent.UnicodeChar == 0 { + return formatVirtualKey(keyEvent.VirtualKeyCode, keyEvent.ControlKeyState, escapeSequence) + } + + _, alt, control := getControlKeys(keyEvent.ControlKeyState) + if control { + // TODO(azlinux): Implement following control sequences + // -D Signals the end of input from the keyboard; also exits current shell. + // -H Deletes the first character to the left of the cursor. Also called the ERASE key. + // -Q Restarts printing after it has been stopped with -s. + // -S Suspends printing on the screen (does not stop the program). + // -U Deletes all characters on the current line. Also called the KILL key. + // -E Quits current command and creates a core + + } + + // +Key generates ESC N Key + if !control && alt { + return ansiterm.KEY_ESC_N + strings.ToLower(string(keyEvent.UnicodeChar)) + } + + return string(keyEvent.UnicodeChar) +} + +// formatVirtualKey converts a virtual key (e.g., up arrow) into the appropriate ANSI string. +func formatVirtualKey(key winterm.WORD, controlState winterm.DWORD, escapeSequence []byte) string { + shift, alt, control := getControlKeys(controlState) + modifier := getControlKeysModifier(shift, alt, control) + + if format, ok := arrowKeyMapPrefix[key]; ok { + return fmt.Sprintf(format, escapeSequence, modifier) + } + + if format, ok := keyMapPrefix[key]; ok { + return fmt.Sprintf(format, modifier) + } + + return "" +} + +// getControlKeys extracts the shift, alt, and ctrl key states. +func getControlKeys(controlState winterm.DWORD) (shift, alt, control bool) { + shift = 0 != (controlState & winterm.SHIFT_PRESSED) + alt = 0 != (controlState & (winterm.LEFT_ALT_PRESSED | winterm.RIGHT_ALT_PRESSED)) + control = 0 != (controlState & (winterm.LEFT_CTRL_PRESSED | winterm.RIGHT_CTRL_PRESSED)) + return shift, alt, control +} + +// getControlKeysModifier returns the ANSI modifier for the given combination of control keys. +func getControlKeysModifier(shift, alt, control bool) string { + if shift && alt && control { + return ansiterm.KEY_CONTROL_PARAM_8 + } + if alt && control { + return ansiterm.KEY_CONTROL_PARAM_7 + } + if shift && control { + return ansiterm.KEY_CONTROL_PARAM_6 + } + if control { + return ansiterm.KEY_CONTROL_PARAM_5 + } + if shift && alt { + return ansiterm.KEY_CONTROL_PARAM_4 + } + if alt { + return ansiterm.KEY_CONTROL_PARAM_3 + } + if shift { + return ansiterm.KEY_CONTROL_PARAM_2 + } + return "" +} diff --git a/pkg/term/windows/ansi_writer.go b/pkg/term/windows/ansi_writer.go new file mode 100644 index 0000000000..9f3232c093 --- /dev/null +++ b/pkg/term/windows/ansi_writer.go @@ -0,0 +1,76 @@ +// +build windows + +package windows + +import ( + "io/ioutil" + "os" + + ansiterm "github.com/Azure/go-ansiterm" + "github.com/Azure/go-ansiterm/winterm" + "github.com/Sirupsen/logrus" +) + +var logger *logrus.Logger + +// ansiWriter wraps a standard output file (e.g., os.Stdout) providing ANSI sequence translation. +type ansiWriter struct { + file *os.File + fd uintptr + infoReset *winterm.CONSOLE_SCREEN_BUFFER_INFO + command []byte + escapeSequence []byte + inAnsiSequence bool + parser *ansiterm.AnsiParser +} + +func newAnsiWriter(nFile int) *ansiWriter { + logFile := ioutil.Discard + + if isDebugEnv := os.Getenv(ansiterm.LogEnv); isDebugEnv == "1" { + logFile, _ = os.Create("ansiReaderWriter.log") + } + + logger = &logrus.Logger{ + Out: logFile, + Formatter: new(logrus.TextFormatter), + Level: logrus.DebugLevel, + } + + file, fd := winterm.GetStdFile(nFile) + info, err := winterm.GetConsoleScreenBufferInfo(fd) + if err != nil { + return nil + } + + parser := ansiterm.CreateParser("Ground", winterm.CreateWinEventHandler(fd, file)) + logger.Infof("newAnsiWriter: parser %p", parser) + + aw := &ansiWriter{ + file: file, + fd: fd, + infoReset: info, + command: make([]byte, 0, ansiterm.ANSI_MAX_CMD_LENGTH), + escapeSequence: []byte(ansiterm.KEY_ESC_CSI), + parser: parser, + } + + logger.Infof("newAnsiWriter: aw.parser %p", aw.parser) + logger.Infof("newAnsiWriter: %v", aw) + return aw +} + +func (aw *ansiWriter) Fd() uintptr { + return aw.fd +} + +// Write writes len(p) bytes from p to the underlying data stream. +func (aw *ansiWriter) Write(p []byte) (total int, err error) { + if len(p) == 0 { + return 0, nil + } + + logger.Infof("Write: % x", p) + logger.Infof("Write: %s", string(p)) + return aw.parser.Parse(p) +} diff --git a/pkg/term/windows/console.go b/pkg/term/windows/console.go new file mode 100644 index 0000000000..3711d9883c --- /dev/null +++ b/pkg/term/windows/console.go @@ -0,0 +1,61 @@ +// +build windows + +package windows + +import ( + "io" + "os" + "syscall" + + "github.com/Azure/go-ansiterm/winterm" +) + +// ConsoleStreams returns a wrapped version for each standard stream referencing a console, +// that handles ANSI character sequences. +func ConsoleStreams() (stdIn io.ReadCloser, stdOut, stdErr io.Writer) { + if IsConsole(os.Stdin.Fd()) { + stdIn = newAnsiReader(syscall.STD_INPUT_HANDLE) + } else { + stdIn = os.Stdin + } + + if IsConsole(os.Stdout.Fd()) { + stdOut = newAnsiWriter(syscall.STD_OUTPUT_HANDLE) + } else { + stdOut = os.Stdout + } + + if IsConsole(os.Stderr.Fd()) { + stdErr = newAnsiWriter(syscall.STD_ERROR_HANDLE) + } else { + stdErr = os.Stderr + } + + return stdIn, stdOut, stdErr +} + +// GetHandleInfo returns file descriptor and bool indicating whether the file is a console. +func GetHandleInfo(in interface{}) (uintptr, bool) { + switch t := in.(type) { + case *ansiReader: + return t.Fd(), true + case *ansiWriter: + return t.Fd(), true + } + + var inFd uintptr + var isTerminal bool + + if file, ok := in.(*os.File); ok { + inFd = file.Fd() + isTerminal = IsConsole(inFd) + } + return inFd, isTerminal +} + +// IsConsole returns true if the given file descriptor is a Windows Console. +// The code assumes that GetConsoleMode will return an error for file descriptors that are not a console. +func IsConsole(fd uintptr) bool { + _, e := winterm.GetConsoleMode(fd) + return e == nil +} diff --git a/pkg/term/windows/windows.go b/pkg/term/windows/windows.go new file mode 100644 index 0000000000..bf4c7b5025 --- /dev/null +++ b/pkg/term/windows/windows.go @@ -0,0 +1,5 @@ +// These files implement ANSI-aware input and output streams for use by the Docker Windows client. +// When asked for the set of standard streams (e.g., stdin, stdout, stderr), the code will create +// and return pseudo-streams that convert ANSI sequences to / from Windows Console API calls. + +package windows diff --git a/pkg/term/windows/windows_test.go b/pkg/term/windows/windows_test.go new file mode 100644 index 0000000000..52aeab54ec --- /dev/null +++ b/pkg/term/windows/windows_test.go @@ -0,0 +1,3 @@ +// This file is necessary to pass the Docker tests. + +package windows diff --git a/pkg/timeoutconn/timeoutconn.go b/pkg/timeoutconn/timeoutconn.go new file mode 100644 index 0000000000..6487e3b9d6 --- /dev/null +++ b/pkg/timeoutconn/timeoutconn.go @@ -0,0 +1,28 @@ +// Package timeoutconn provides overridden net.Conn that supports deadline (timeout). +package timeoutconn + +import ( + "net" + "time" +) + +// New creates a net.Conn with a timeout for every Read operation. +func New(netConn net.Conn, timeout time.Duration) net.Conn { + return &conn{netConn, timeout} +} + +// A net.Conn that sets a deadline for every Read operation. +// FIXME was documented the deadline was on Write operation too but not implement +type conn struct { + net.Conn + timeout time.Duration +} + +func (c *conn) Read(b []byte) (int, error) { + if c.timeout > 0 { + if err := c.Conn.SetReadDeadline(time.Now().Add(c.timeout)); err != nil { + return 0, err + } + } + return c.Conn.Read(b) +} diff --git a/pkg/timeoutconn/timeoutconn_test.go b/pkg/timeoutconn/timeoutconn_test.go new file mode 100644 index 0000000000..46d6477cce --- /dev/null +++ b/pkg/timeoutconn/timeoutconn_test.go @@ -0,0 +1,33 @@ +package timeoutconn + +import ( + "bufio" + "fmt" + "net" + "net/http" + "net/http/httptest" + "testing" + "time" +) + +func TestRead(t *testing.T) { + ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintln(w, "hello") + })) + defer ts.Close() + conn, err := net.Dial("tcp", ts.URL[7:]) + if err != nil { + t.Fatalf("failed to create connection to %q: %v", ts.URL, err) + } + tconn := New(conn, 1*time.Second) + + if _, err = bufio.NewReader(tconn).ReadString('\n'); err == nil { + t.Fatalf("expected timeout error, got none") + } + if _, err := fmt.Fprintf(tconn, "GET / HTTP/1.0\r\n\r\n"); err != nil { + t.Errorf("unexpected error: %v", err) + } + if _, err = bufio.NewReader(tconn).ReadString('\n'); err != nil { + t.Errorf("unexpected error: %v", err) + } +} diff --git a/pkg/timeutils/json.go b/pkg/timeutils/json.go new file mode 100644 index 0000000000..ea19daad51 --- /dev/null +++ b/pkg/timeutils/json.go @@ -0,0 +1,27 @@ +// Package timeutils provides helper functions to parse and print time (time.Time). +package timeutils + +import ( + "errors" + "time" +) + +const ( + // RFC3339NanoFixed is our own version of RFC339Nano because we want one + // that pads the nano seconds part with zeros to ensure + // the timestamps are aligned in the logs. + RFC3339NanoFixed = "2006-01-02T15:04:05.000000000Z07:00" + // JSONFormat is the format used by FastMarshalJSON + JSONFormat = `"` + time.RFC3339Nano + `"` +) + +// FastMarshalJSON avoids one of the extra allocations that +// time.MarshalJSON is making. +func FastMarshalJSON(t time.Time) (string, error) { + if y := t.Year(); y < 0 || y >= 10000 { + // RFC 3339 is clear that years are 4 digits exactly. + // See golang.org/issue/4556#c15 for more discussion. + return "", errors.New("time.MarshalJSON: year outside of range [0,9999]") + } + return t.Format(JSONFormat), nil +} diff --git a/pkg/timeutils/json_test.go b/pkg/timeutils/json_test.go new file mode 100644 index 0000000000..1ff3331797 --- /dev/null +++ b/pkg/timeutils/json_test.go @@ -0,0 +1,47 @@ +package timeutils + +import ( + "testing" + "time" +) + +// Testing to ensure 'year' fields is between 0 and 9999 +func TestFastMarshalJSONWithInvalidDate(t *testing.T) { + aTime := time.Date(-1, 1, 1, 0, 0, 0, 0, time.Local) + json, err := FastMarshalJSON(aTime) + if err == nil { + t.Fatalf("FastMarshalJSON should throw an error, but was '%v'", json) + } + anotherTime := time.Date(10000, 1, 1, 0, 0, 0, 0, time.Local) + json, err = FastMarshalJSON(anotherTime) + if err == nil { + t.Fatalf("FastMarshalJSON should throw an error, but was '%v'", json) + } + +} + +func TestFastMarshalJSON(t *testing.T) { + aTime := time.Date(2015, 5, 29, 11, 1, 2, 3, time.UTC) + json, err := FastMarshalJSON(aTime) + if err != nil { + t.Fatal(err) + } + expected := "\"2015-05-29T11:01:02.000000003Z\"" + if json != expected { + t.Fatalf("Expected %v, got %v", expected, json) + } + + location, err := time.LoadLocation("Europe/Paris") + if err != nil { + t.Fatal(err) + } + aTime = time.Date(2015, 5, 29, 11, 1, 2, 3, location) + json, err = FastMarshalJSON(aTime) + if err != nil { + t.Fatal(err) + } + expected = "\"2015-05-29T11:01:02.000000003+02:00\"" + if json != expected { + t.Fatalf("Expected %v, got %v", expected, json) + } +} diff --git a/pkg/timeutils/utils.go b/pkg/timeutils/utils.go new file mode 100644 index 0000000000..8437f12472 --- /dev/null +++ b/pkg/timeutils/utils.go @@ -0,0 +1,36 @@ +package timeutils + +import ( + "strconv" + "strings" + "time" +) + +// GetTimestamp tries to parse given string as golang duration, +// then RFC3339 time and finally as a Unix timestamp. If +// any of these were successful, it returns a Unix timestamp +// as string otherwise returns the given value back. +// In case of duration input, the returned timestamp is computed +// as the given reference time minus the amount of the duration. +func GetTimestamp(value string, reference time.Time) string { + if d, err := time.ParseDuration(value); value != "0" && err == nil { + return strconv.FormatInt(reference.Add(-d).Unix(), 10) + } + + var format string + if strings.Contains(value, ".") { + format = time.RFC3339Nano + } else { + format = time.RFC3339 + } + + loc := time.FixedZone(time.Now().Zone()) + if len(value) < len(format) { + format = format[:len(value)] + } + t, err := time.ParseInLocation(format, value, loc) + if err != nil { + return value + } + return strconv.FormatInt(t.Unix(), 10) +} diff --git a/pkg/timeutils/utils_test.go b/pkg/timeutils/utils_test.go new file mode 100644 index 0000000000..f71dcb5310 --- /dev/null +++ b/pkg/timeutils/utils_test.go @@ -0,0 +1,44 @@ +package timeutils + +import ( + "fmt" + "testing" + "time" +) + +func TestGetTimestamp(t *testing.T) { + now := time.Now() + cases := []struct{ in, expected string }{ + {"0", "-62167305600"}, // 0 gets parsed year 0 + + // Partial RFC3339 strings get parsed with second precision + {"2006-01-02T15:04:05.999999999+07:00", "1136189045"}, + {"2006-01-02T15:04:05.999999999Z", "1136214245"}, + {"2006-01-02T15:04:05.999999999", "1136214245"}, + {"2006-01-02T15:04:05", "1136214245"}, + {"2006-01-02T15:04", "1136214240"}, + {"2006-01-02T15", "1136214000"}, + {"2006-01-02T", "1136160000"}, + {"2006-01-02", "1136160000"}, + {"2006", "1136073600"}, + {"2015-05-13T20:39:09Z", "1431549549"}, + + // unix timestamps returned as is + {"1136073600", "1136073600"}, + + // Durations + {"1m", fmt.Sprintf("%d", now.Add(-1*time.Minute).Unix())}, + {"1.5h", fmt.Sprintf("%d", now.Add(-90*time.Minute).Unix())}, + {"1h30m", fmt.Sprintf("%d", now.Add(-90*time.Minute).Unix())}, + + // String fallback + {"invalid", "invalid"}, + } + + for _, c := range cases { + o := GetTimestamp(c.in, now) + if o != c.expected { + t.Fatalf("wrong value for '%s'. expected:'%s' got:'%s'", c.in, c.expected, o) + } + } +} diff --git a/pkg/tlsconfig/config.go b/pkg/tlsconfig/config.go new file mode 100644 index 0000000000..9f7f336947 --- /dev/null +++ b/pkg/tlsconfig/config.go @@ -0,0 +1,132 @@ +// Package tlsconfig provides primitives to retrieve secure-enough TLS configurations for both clients and servers. +// +// As a reminder from https://golang.org/pkg/crypto/tls/#Config: +// A Config structure is used to configure a TLS client or server. After one has been passed to a TLS function it must not be modified. +// A Config may be reused; the tls package will also not modify it. +package tlsconfig + +import ( + "crypto/tls" + "crypto/x509" + "fmt" + "io/ioutil" + "os" + + "github.com/Sirupsen/logrus" +) + +// Options represents the information needed to create client and server TLS configurations. +type Options struct { + CAFile string + + // If either CertFile or KeyFile is empty, Client() will not load them + // preventing the client from authenticating to the server. + // However, Server() requires them and will error out if they are empty. + CertFile string + KeyFile string + + // client-only option + InsecureSkipVerify bool + // server-only option + ClientAuth tls.ClientAuthType +} + +// Extra (server-side) accepted CBC cipher suites - will phase out in the future +var acceptedCBCCiphers = []uint16{ + tls.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, + tls.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, + tls.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, + tls.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, + tls.TLS_RSA_WITH_AES_256_CBC_SHA, + tls.TLS_RSA_WITH_AES_128_CBC_SHA, +} + +// Client TLS cipher suites (dropping CBC ciphers for client preferred suite set) +var clientCipherSuites = []uint16{ + tls.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, + tls.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, +} + +// For use by code which already has a crypto/tls options struct but wants to +// use a commonly accepted set of TLS cipher suites, with known weak algorithms removed +var DefaultServerAcceptedCiphers = append(clientCipherSuites, acceptedCBCCiphers...) + +// ServerDefault is a secure-enough TLS configuration for the server TLS configuration. +var ServerDefault = tls.Config{ + // Avoid fallback to SSL protocols < TLS1.0 + MinVersion: tls.VersionTLS10, + PreferServerCipherSuites: true, + CipherSuites: DefaultServerAcceptedCiphers, +} + +// ClientDefault is a secure-enough TLS configuration for the client TLS configuration. +var ClientDefault = tls.Config{ + // Prefer TLS1.2 as the client minimum + MinVersion: tls.VersionTLS12, + CipherSuites: clientCipherSuites, +} + +// certPool returns an X.509 certificate pool from `caFile`, the certificate file. +func certPool(caFile string) (*x509.CertPool, error) { + // If we should verify the server, we need to load a trusted ca + certPool := x509.NewCertPool() + pem, err := ioutil.ReadFile(caFile) + if err != nil { + return nil, fmt.Errorf("Could not read CA certificate %q: %v", caFile, err) + } + if !certPool.AppendCertsFromPEM(pem) { + return nil, fmt.Errorf("failed to append certificates from PEM file: %q", caFile) + } + s := certPool.Subjects() + subjects := make([]string, len(s)) + for i, subject := range s { + subjects[i] = string(subject) + } + logrus.Debugf("Trusting certs with subjects: %v", subjects) + return certPool, nil +} + +// Client returns a TLS configuration meant to be used by a client. +func Client(options Options) (*tls.Config, error) { + tlsConfig := ClientDefault + tlsConfig.InsecureSkipVerify = options.InsecureSkipVerify + if !options.InsecureSkipVerify { + CAs, err := certPool(options.CAFile) + if err != nil { + return nil, err + } + tlsConfig.RootCAs = CAs + } + + if options.CertFile != "" && options.KeyFile != "" { + tlsCert, err := tls.LoadX509KeyPair(options.CertFile, options.KeyFile) + if err != nil { + return nil, fmt.Errorf("Could not load X509 key pair: %v. Make sure the key is not encrypted", err) + } + tlsConfig.Certificates = []tls.Certificate{tlsCert} + } + + return &tlsConfig, nil +} + +// Server returns a TLS configuration meant to be used by a server. +func Server(options Options) (*tls.Config, error) { + tlsConfig := ServerDefault + tlsConfig.ClientAuth = options.ClientAuth + tlsCert, err := tls.LoadX509KeyPair(options.CertFile, options.KeyFile) + if err != nil { + if os.IsNotExist(err) { + return nil, fmt.Errorf("Could not load X509 key pair (cert: %q, key: %q): %v", options.CertFile, options.KeyFile, err) + } + return nil, fmt.Errorf("Error reading X509 key pair (cert: %q, key: %q): %v. Make sure the key is not encrypted.", options.CertFile, options.KeyFile, err) + } + tlsConfig.Certificates = []tls.Certificate{tlsCert} + if options.ClientAuth >= tls.VerifyClientCertIfGiven { + CAs, err := certPool(options.CAFile) + if err != nil { + return nil, err + } + tlsConfig.ClientCAs = CAs + } + return &tlsConfig, nil +} diff --git a/pkg/truncindex/truncindex.go b/pkg/truncindex/truncindex.go new file mode 100644 index 0000000000..9c08c90d79 --- /dev/null +++ b/pkg/truncindex/truncindex.go @@ -0,0 +1,128 @@ +// Package truncindex provides a general 'index tree', used by Docker +// in order to be able to reference containers by only a few unambiguous +// characters of their id. +package truncindex + +import ( + "errors" + "fmt" + "strings" + "sync" + + "github.com/tchap/go-patricia/patricia" +) + +var ( + // ErrEmptyPrefix is an error returned if the prefix was empty. + ErrEmptyPrefix = errors.New("Prefix can't be empty") + + // ErrAmbiguousPrefix is returned if the prefix was ambiguous + // (multiple ids for the prefix). + ErrAmbiguousPrefix = errors.New("Multiple IDs found with provided prefix") + + // ErrIllegalChar is returned when a space is in the ID + ErrIllegalChar = errors.New("illegal character: ' '") +) + +// TruncIndex allows the retrieval of string identifiers by any of their unique prefixes. +// This is used to retrieve image and container IDs by more convenient shorthand prefixes. +type TruncIndex struct { + sync.RWMutex + trie *patricia.Trie + ids map[string]struct{} +} + +// NewTruncIndex creates a new TruncIndex and initializes with a list of IDs. +func NewTruncIndex(ids []string) (idx *TruncIndex) { + idx = &TruncIndex{ + ids: make(map[string]struct{}), + + // Change patricia max prefix per node length, + // because our len(ID) always 64 + trie: patricia.NewTrie(patricia.MaxPrefixPerNode(64)), + } + for _, id := range ids { + idx.addID(id) + } + return +} + +func (idx *TruncIndex) addID(id string) error { + if strings.Contains(id, " ") { + return ErrIllegalChar + } + if id == "" { + return ErrEmptyPrefix + } + if _, exists := idx.ids[id]; exists { + return fmt.Errorf("id already exists: '%s'", id) + } + idx.ids[id] = struct{}{} + if inserted := idx.trie.Insert(patricia.Prefix(id), struct{}{}); !inserted { + return fmt.Errorf("failed to insert id: %s", id) + } + return nil +} + +// Add adds a new ID to the TruncIndex. +func (idx *TruncIndex) Add(id string) error { + idx.Lock() + defer idx.Unlock() + if err := idx.addID(id); err != nil { + return err + } + return nil +} + +// Delete removes an ID from the TruncIndex. If there are multiple IDs +// with the given prefix, an error is thrown. +func (idx *TruncIndex) Delete(id string) error { + idx.Lock() + defer idx.Unlock() + if _, exists := idx.ids[id]; !exists || id == "" { + return fmt.Errorf("no such id: '%s'", id) + } + delete(idx.ids, id) + if deleted := idx.trie.Delete(patricia.Prefix(id)); !deleted { + return fmt.Errorf("no such id: '%s'", id) + } + return nil +} + +// Get retrieves an ID from the TruncIndex. If there are multiple IDs +// with the given prefix, an error is thrown. +func (idx *TruncIndex) Get(s string) (string, error) { + if s == "" { + return "", ErrEmptyPrefix + } + var ( + id string + ) + subTreeVisitFunc := func(prefix patricia.Prefix, item patricia.Item) error { + if id != "" { + // we haven't found the ID if there are two or more IDs + id = "" + return ErrAmbiguousPrefix + } + id = string(prefix) + return nil + } + + idx.RLock() + defer idx.RUnlock() + if err := idx.trie.VisitSubtree(patricia.Prefix(s), subTreeVisitFunc); err != nil { + return "", err + } + if id != "" { + return id, nil + } + return "", fmt.Errorf("no such id: %s", s) +} + +// Iterate iterates over all stored IDs, and passes each of them to the given handler. +func (idx *TruncIndex) Iterate(handler func(id string)) { + idx.trie.Visit(func(prefix patricia.Prefix, item patricia.Item) error { + handler(string(prefix)) + return nil + }) +} diff --git a/pkg/truncindex/truncindex_test.go b/pkg/truncindex/truncindex_test.go new file mode 100644 index 0000000000..8197baf7d4 --- /dev/null +++ b/pkg/truncindex/truncindex_test.go @@ -0,0 +1,429 @@ +package truncindex + +import ( + "math/rand" + "testing" + + "github.com/docker/docker/pkg/stringid" +) + +// Test the behavior of TruncIndex, an index for querying IDs from a non-conflicting prefix. +func TestTruncIndex(t *testing.T) { + ids := []string{} + index := NewTruncIndex(ids) + // Get on an empty index + if _, err := index.Get("foobar"); err == nil { + t.Fatal("Get on an empty index should return an error") + } + + // Spaces should be illegal in an id + if err := index.Add("I have a space"); err == nil { + t.Fatalf("Adding an id with ' ' should return an error") + } + + id := "99b36c2c326ccc11e726eee6ee78a0baf166ef96" + // Add an id + if err := index.Add(id); err != nil { + t.Fatal(err) + } + + // Add an empty id (should fail) + if err := index.Add(""); err == nil { + t.Fatalf("Adding an empty id should return an error") + } + + // Get a non-existing id + assertIndexGet(t, index, "abracadabra", "", true) + // Get an empty id + assertIndexGet(t, index, "", "", true) + // Get the exact id + assertIndexGet(t, index, id, id, false) + // The first letter should match + assertIndexGet(t, index, id[:1], id, false) + // The first half should match + assertIndexGet(t, index, id[:len(id)/2], id, false) + // The second half should NOT match + assertIndexGet(t, index, id[len(id)/2:], "", true) + + id2 := id[:6] + "blabla" + // Add an id + if err := index.Add(id2); err != nil { + t.Fatal(err) + } + // Both exact IDs should work + assertIndexGet(t, index, id, id, false) + assertIndexGet(t, index, id2, id2, false) + + // 6 characters or less should conflict + assertIndexGet(t, index, id[:6], "", true) + assertIndexGet(t, index, id[:4], "", true) + assertIndexGet(t, index, id[:1], "", true) + + // An ambiguous id prefix should return an error + if _, err := index.Get(id[:4]); err == nil { + t.Fatal("An ambiguous id prefix should return an error") + } + + // 7 characters should NOT conflict + assertIndexGet(t, index, id[:7], id, false) + assertIndexGet(t, index, id2[:7], id2, false) + + // Deleting a non-existing id should return an error + if err := index.Delete("non-existing"); err == nil { + t.Fatalf("Deleting a non-existing id should return an error") + } + + // Deleting an empty id should return an error + if err := index.Delete(""); err == nil { + t.Fatal("Deleting an empty id should return an error") + } + + // Deleting id2 should remove conflicts + if err := index.Delete(id2); err != nil { + t.Fatal(err) + } + // id2 should no longer work + assertIndexGet(t, index, id2, "", true) + assertIndexGet(t, index, id2[:7], "", true) + assertIndexGet(t, index, id2[:11], "", true) + + // conflicts between id and id2 should be gone + assertIndexGet(t, index, id[:6], id, false) + assertIndexGet(t, index, id[:4], id, false) + assertIndexGet(t, index, id[:1], id, false) + + // non-conflicting substrings should still not conflict + assertIndexGet(t, index, id[:7], id, false) + assertIndexGet(t, index, id[:15], id, false) + assertIndexGet(t, index, id, id, false) + + assertIndexIterate(t) +} + +func assertIndexIterate(t *testing.T) { + ids := []string{ + "19b36c2c326ccc11e726eee6ee78a0baf166ef96", + "28b36c2c326ccc11e726eee6ee78a0baf166ef96", + "37b36c2c326ccc11e726eee6ee78a0baf166ef96", + "46b36c2c326ccc11e726eee6ee78a0baf166ef96", + } + + index := NewTruncIndex(ids) + + index.Iterate(func(targetId string) { + for _, id := range ids { + if targetId == id { + return + } + } + + t.Fatalf("An unknown ID '%s'", targetId) + }) +} + +func assertIndexGet(t *testing.T, index *TruncIndex, input, expectedResult string, expectError bool) { + if result, err := index.Get(input); err != nil && !expectError { + t.Fatalf("Unexpected error getting '%s': %s", input, err) + } else if err == nil && expectError { + t.Fatalf("Getting '%s' should return an error, not '%s'", input, result) + } else if result != expectedResult { + t.Fatalf("Getting '%s' returned '%s' instead of '%s'", input, result, expectedResult) + } +} + +func BenchmarkTruncIndexAdd100(b *testing.B) { + var testSet []string + for i := 0; i < 100; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + } +} + +func BenchmarkTruncIndexAdd250(b *testing.B) { + var testSet []string + for i := 0; i < 250; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + } +} + +func BenchmarkTruncIndexAdd500(b *testing.B) { + var testSet []string + for i := 0; i < 500; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + } +} + +func BenchmarkTruncIndexGet100(b *testing.B) { + var testSet []string + var testKeys []string + for i := 0; i < 100; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + l := rand.Intn(12) + 12 + testKeys = append(testKeys, id[:l]) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + for _, id := range testKeys { + if res, err := index.Get(id); err != nil { + b.Fatal(res, err) + } + } + } +} + +func BenchmarkTruncIndexGet250(b *testing.B) { + var testSet []string + var testKeys []string + for i := 0; i < 250; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + l := rand.Intn(12) + 12 + testKeys = append(testKeys, id[:l]) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + for _, id := range testKeys { + if res, err := index.Get(id); err != nil { + b.Fatal(res, err) + } + } + } +} + +func BenchmarkTruncIndexGet500(b *testing.B) { + var testSet []string + var testKeys []string + for i := 0; i < 500; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + l := rand.Intn(12) + 12 + testKeys = append(testKeys, id[:l]) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + for _, id := range testKeys { + if res, err := index.Get(id); err != nil { + b.Fatal(res, err) + } + } + } +} + +func BenchmarkTruncIndexDelete100(b *testing.B) { + var testSet []string + for i := 0; i < 100; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + b.StopTimer() + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + b.StartTimer() + for _, id := range testSet { + if err := index.Delete(id); err != nil { + b.Fatal(err) + } + } + } +} + +func BenchmarkTruncIndexDelete250(b *testing.B) { + var testSet []string + for i := 0; i < 250; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + b.StopTimer() + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + b.StartTimer() + for _, id := range testSet { + if err := index.Delete(id); err != nil { + b.Fatal(err) + } + } + } +} + +func BenchmarkTruncIndexDelete500(b *testing.B) { + var testSet []string + for i := 0; i < 500; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + b.StopTimer() + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + b.StartTimer() + for _, id := range testSet { + if err := index.Delete(id); err != nil { + b.Fatal(err) + } + } + } +} + +func BenchmarkTruncIndexNew100(b *testing.B) { + var testSet []string + for i := 0; i < 100; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + NewTruncIndex(testSet) + } +} + +func BenchmarkTruncIndexNew250(b *testing.B) { + var testSet []string + for i := 0; i < 250; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + NewTruncIndex(testSet) + } +} + +func BenchmarkTruncIndexNew500(b *testing.B) { + var testSet []string + for i := 0; i < 500; i++ { + testSet = append(testSet, stringid.GenerateNonCryptoID()) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + NewTruncIndex(testSet) + } +} + +func BenchmarkTruncIndexAddGet100(b *testing.B) { + var testSet []string + var testKeys []string + for i := 0; i < 500; i++ { + id := stringid.GenerateNonCryptoID() + testSet = append(testSet, id) + l := rand.Intn(12) + 12 + testKeys = append(testKeys, id[:l]) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + for _, id := range testKeys { + if res, err := index.Get(id); err != nil { + b.Fatal(res, err) + } + } + } +} + +func BenchmarkTruncIndexAddGet250(b *testing.B) { + var testSet []string + var testKeys []string + for i := 0; i < 500; i++ { + id := stringid.GenerateNonCryptoID() + testSet = append(testSet, id) + l := rand.Intn(12) + 12 + testKeys = append(testKeys, id[:l]) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + for _, id := range testKeys { + if res, err := index.Get(id); err != nil { + b.Fatal(res, err) + } + } + } +} + +func BenchmarkTruncIndexAddGet500(b *testing.B) { + var testSet []string + var testKeys []string + for i := 0; i < 500; i++ { + id := stringid.GenerateNonCryptoID() + testSet = append(testSet, id) + l := rand.Intn(12) + 12 + testKeys = append(testKeys, id[:l]) + } + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range testSet { + if err := index.Add(id); err != nil { + b.Fatal(err) + } + } + for _, id := range testKeys { + if res, err := index.Get(id); err != nil { + b.Fatal(res, err) + } + } + } +} diff --git a/pkg/ulimit/ulimit.go b/pkg/ulimit/ulimit.go new file mode 100644 index 0000000000..8fb0d804de --- /dev/null +++ b/pkg/ulimit/ulimit.go @@ -0,0 +1,111 @@ +// Package ulimit provides structure and helper function to parse and represent +// resource limits (Rlimit and Ulimit, its human friendly version). +package ulimit + +import ( + "fmt" + "strconv" + "strings" +) + +// Ulimit is a human friendly version of Rlimit. +type Ulimit struct { + Name string + Hard int64 + Soft int64 +} + +// Rlimit specifies the resource limits, such as max open files. +type Rlimit struct { + Type int `json:"type,omitempty"` + Hard uint64 `json:"hard,omitempty"` + Soft uint64 `json:"soft,omitempty"` +} + +const ( + // magic numbers for making the syscall + // some of these are defined in the syscall package, but not all. + // Also since Windows client doesn't get access to the syscall package, need to + // define these here + rlimitAs = 9 + rlimitCore = 4 + rlimitCPU = 0 + rlimitData = 2 + rlimitFsize = 1 + rlimitLocks = 10 + rlimitMemlock = 8 + rlimitMsgqueue = 12 + rlimitNice = 13 + rlimitNofile = 7 + rlimitNproc = 6 + rlimitRss = 5 + rlimitRtprio = 14 + rlimitRttime = 15 + rlimitSigpending = 11 + rlimitStack = 3 +) + +var ulimitNameMapping = map[string]int{ + //"as": rlimitAs, // Disabled since this doesn't seem usable with the way Docker inits a container. + "core": rlimitCore, + "cpu": rlimitCPU, + "data": rlimitData, + "fsize": rlimitFsize, + "locks": rlimitLocks, + "memlock": rlimitMemlock, + "msgqueue": rlimitMsgqueue, + "nice": rlimitNice, + "nofile": rlimitNofile, + "nproc": rlimitNproc, + "rss": rlimitRss, + "rtprio": rlimitRtprio, + "rttime": rlimitRttime, + "sigpending": rlimitSigpending, + "stack": rlimitStack, +} + +// Parse parses and returns a Ulimit from the specified string. +func Parse(val string) (*Ulimit, error) { + parts := strings.SplitN(val, "=", 2) + if len(parts) != 2 { + return nil, fmt.Errorf("invalid ulimit argument: %s", val) + } + + if _, exists := ulimitNameMapping[parts[0]]; !exists { + return nil, fmt.Errorf("invalid ulimit type: %s", parts[0]) + } + + limitVals := strings.SplitN(parts[1], ":", 2) + if len(limitVals) > 2 { + return nil, fmt.Errorf("too many limit value arguments - %s, can only have up to two, `soft[:hard]`", parts[1]) + } + + soft, err := strconv.ParseInt(limitVals[0], 10, 64) + if err != nil { + return nil, err + } + + hard := soft // in case no hard was set + if len(limitVals) == 2 { + hard, err = strconv.ParseInt(limitVals[1], 10, 64) + } + if soft > hard { + return nil, fmt.Errorf("ulimit soft limit must be less than or equal to hard limit: %d > %d", soft, hard) + } + + return &Ulimit{Name: parts[0], Soft: soft, Hard: hard}, nil +} + +// GetRlimit returns the RLimit corresponding to Ulimit. +func (u *Ulimit) GetRlimit() (*Rlimit, error) { + t, exists := ulimitNameMapping[u.Name] + if !exists { + return nil, fmt.Errorf("invalid ulimit name %s", u.Name) + } + + return &Rlimit{Type: t, Soft: uint64(u.Soft), Hard: uint64(u.Hard)}, nil +} + +func (u *Ulimit) String() string { + return fmt.Sprintf("%s=%d:%d", u.Name, u.Soft, u.Hard) +} diff --git a/pkg/ulimit/ulimit_test.go b/pkg/ulimit/ulimit_test.go new file mode 100644 index 0000000000..1e8c881f51 --- /dev/null +++ b/pkg/ulimit/ulimit_test.go @@ -0,0 +1,55 @@ +package ulimit + +import "testing" + +func TestParseValid(t *testing.T) { + u1 := &Ulimit{"nofile", 1024, 512} + if u2, _ := Parse("nofile=512:1024"); *u1 != *u2 { + t.Fatalf("expected %q, but got %q", u1, u2) + } +} + +func TestParseInvalidLimitType(t *testing.T) { + if _, err := Parse("notarealtype=1024:1024"); err == nil { + t.Fatalf("expected error on invalid ulimit type") + } +} + +func TestParseBadFormat(t *testing.T) { + if _, err := Parse("nofile:1024:1024"); err == nil { + t.Fatal("expected error on bad syntax") + } + + if _, err := Parse("nofile"); err == nil { + t.Fatal("expected error on bad syntax") + } + + if _, err := Parse("nofile="); err == nil { + t.Fatal("expected error on bad syntax") + } + if _, err := Parse("nofile=:"); err == nil { + t.Fatal("expected error on bad syntax") + } + if _, err := Parse("nofile=:1024"); err == nil { + t.Fatal("expected error on bad syntax") + } +} + +func TestParseHardLessThanSoft(t *testing.T) { + if _, err := Parse("nofile:1024:1"); err == nil { + t.Fatal("expected error on hard limit less than soft limit") + } +} + +func TestParseInvalidValueType(t *testing.T) { + if _, err := Parse("nofile:asdf"); err == nil { + t.Fatal("expected error on bad value type") + } +} + +func TestStringOutput(t *testing.T) { + u := &Ulimit{"nofile", 1024, 512} + if s := u.String(); s != "nofile=512:1024" { + t.Fatal("expected String to return nofile=512:1024, but got", s) + } +} diff --git a/pkg/units/duration.go b/pkg/units/duration.go new file mode 100644 index 0000000000..c219a8a968 --- /dev/null +++ b/pkg/units/duration.go @@ -0,0 +1,33 @@ +// Package units provides helper function to parse and print size and time units +// in human-readable format. +package units + +import ( + "fmt" + "time" +) + +// HumanDuration returns a human-readable approximation of a duration +// (eg. "About a minute", "4 hours ago", etc.). +func HumanDuration(d time.Duration) string { + if seconds := int(d.Seconds()); seconds < 1 { + return "Less than a second" + } else if seconds < 60 { + return fmt.Sprintf("%d seconds", seconds) + } else if minutes := int(d.Minutes()); minutes == 1 { + return "About a minute" + } else if minutes < 60 { + return fmt.Sprintf("%d minutes", minutes) + } else if hours := int(d.Hours()); hours == 1 { + return "About an hour" + } else if hours < 48 { + return fmt.Sprintf("%d hours", hours) + } else if hours < 24*7*2 { + return fmt.Sprintf("%d days", hours/24) + } else if hours < 24*30*3 { + return fmt.Sprintf("%d weeks", hours/24/7) + } else if hours < 24*365*2 { + return fmt.Sprintf("%d months", hours/24/30) + } + return fmt.Sprintf("%d years", int(d.Hours())/24/365) +} diff --git a/pkg/units/duration_test.go b/pkg/units/duration_test.go new file mode 100644 index 0000000000..fcfb6b7bbd --- /dev/null +++ b/pkg/units/duration_test.go @@ -0,0 +1,46 @@ +package units + +import ( + "testing" + "time" +) + +func TestHumanDuration(t *testing.T) { + // Useful duration abstractions + day := 24 * time.Hour + week := 7 * day + month := 30 * day + year := 365 * day + + assertEquals(t, "Less than a second", HumanDuration(450*time.Millisecond)) + assertEquals(t, "47 seconds", HumanDuration(47*time.Second)) + assertEquals(t, "About a minute", HumanDuration(1*time.Minute)) + assertEquals(t, "3 minutes", HumanDuration(3*time.Minute)) + assertEquals(t, "35 minutes", HumanDuration(35*time.Minute)) + assertEquals(t, "35 minutes", HumanDuration(35*time.Minute+40*time.Second)) + assertEquals(t, "About an hour", HumanDuration(1*time.Hour)) + assertEquals(t, "About an hour", HumanDuration(1*time.Hour+45*time.Minute)) + assertEquals(t, "3 hours", HumanDuration(3*time.Hour)) + assertEquals(t, "3 hours", HumanDuration(3*time.Hour+59*time.Minute)) + assertEquals(t, "4 hours", HumanDuration(3*time.Hour+60*time.Minute)) + assertEquals(t, "24 hours", HumanDuration(24*time.Hour)) + assertEquals(t, "36 hours", HumanDuration(1*day+12*time.Hour)) + assertEquals(t, "2 days", HumanDuration(2*day)) + assertEquals(t, "7 days", HumanDuration(7*day)) + assertEquals(t, "13 days", HumanDuration(13*day+5*time.Hour)) + assertEquals(t, "2 weeks", HumanDuration(2*week)) + assertEquals(t, "2 weeks", HumanDuration(2*week+4*day)) + assertEquals(t, "3 weeks", HumanDuration(3*week)) + assertEquals(t, "4 weeks", HumanDuration(4*week)) + assertEquals(t, "4 weeks", HumanDuration(4*week+3*day)) + assertEquals(t, "4 weeks", HumanDuration(1*month)) + assertEquals(t, "6 weeks", HumanDuration(1*month+2*week)) + assertEquals(t, "8 weeks", HumanDuration(2*month)) + assertEquals(t, "3 months", HumanDuration(3*month+1*week)) + assertEquals(t, "5 months", HumanDuration(5*month+2*week)) + assertEquals(t, "13 months", HumanDuration(13*month)) + assertEquals(t, "23 months", HumanDuration(23*month)) + assertEquals(t, "24 months", HumanDuration(24*month)) + assertEquals(t, "2 years", HumanDuration(24*month+2*week)) + assertEquals(t, "3 years", HumanDuration(3*year+2*month)) +} diff --git a/pkg/units/size.go b/pkg/units/size.go new file mode 100644 index 0000000000..3b59daff31 --- /dev/null +++ b/pkg/units/size.go @@ -0,0 +1,95 @@ +package units + +import ( + "fmt" + "regexp" + "strconv" + "strings" +) + +// See: http://en.wikipedia.org/wiki/Binary_prefix +const ( + // Decimal + + KB = 1000 + MB = 1000 * KB + GB = 1000 * MB + TB = 1000 * GB + PB = 1000 * TB + + // Binary + + KiB = 1024 + MiB = 1024 * KiB + GiB = 1024 * MiB + TiB = 1024 * GiB + PiB = 1024 * TiB +) + +type unitMap map[string]int64 + +var ( + decimalMap = unitMap{"k": KB, "m": MB, "g": GB, "t": TB, "p": PB} + binaryMap = unitMap{"k": KiB, "m": MiB, "g": GiB, "t": TiB, "p": PiB} + sizeRegex = regexp.MustCompile(`^(\d+)([kKmMgGtTpP])?[bB]?$`) +) + +var decimapAbbrs = []string{"B", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"} +var binaryAbbrs = []string{"B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"} + +// CustomSize returns a human-readable approximation of a size +// using custom format. +func CustomSize(format string, size float64, base float64, _map []string) string { + i := 0 + for size >= base { + size = size / base + i++ + } + return fmt.Sprintf(format, size, _map[i]) +} + +// HumanSize returns a human-readable approximation of a size +// capped at 4 valid numbers (eg. "2.746 MB", "796 KB"). +func HumanSize(size float64) string { + return CustomSize("%.4g %s", size, 1000.0, decimapAbbrs) +} + +// BytesSize returns a human-readable size in bytes, kibibytes, +// mebibytes, gibibytes, or tebibytes (eg. "44kiB", "17MiB"). +func BytesSize(size float64) string { + return CustomSize("%.4g %s", size, 1024.0, binaryAbbrs) +} + +// FromHumanSize returns an integer from a human-readable specification of a +// size using SI standard (eg. "44kB", "17MB"). +func FromHumanSize(size string) (int64, error) { + return parseSize(size, decimalMap) +} + +// RAMInBytes parses a human-readable string representing an amount of RAM +// in bytes, kibibytes, mebibytes, gibibytes, or tebibytes and +// returns the number of bytes, or -1 if the string is unparseable. +// Units are case-insensitive, and the 'b' suffix is optional. +func RAMInBytes(size string) (int64, error) { + return parseSize(size, binaryMap) +} + +// Parses the human-readable size string into the amount it represents. +func parseSize(sizeStr string, uMap unitMap) (int64, error) { + matches := sizeRegex.FindStringSubmatch(sizeStr) + if len(matches) != 3 { + return -1, fmt.Errorf("invalid size: '%s'", sizeStr) + } + + size, err := strconv.ParseInt(matches[1], 10, 0) + if err != nil { + return -1, err + } + + unitPrefix := strings.ToLower(matches[2]) + if mul, ok := uMap[unitPrefix]; ok { + size *= mul + } + + return size, nil +} diff --git a/pkg/units/size_test.go b/pkg/units/size_test.go new file mode 100644 index 0000000000..67c3b81e6b --- /dev/null +++ b/pkg/units/size_test.go @@ -0,0 +1,108 @@ +package units + +import ( + "reflect" + "runtime" + "strings" + "testing" +) + +func TestBytesSize(t *testing.T) { + assertEquals(t, "1 KiB", BytesSize(1024)) + assertEquals(t, "1 MiB", BytesSize(1024*1024)) + assertEquals(t, "1 MiB", BytesSize(1048576)) + assertEquals(t, "2 MiB", BytesSize(2*MiB)) + assertEquals(t, "3.42 GiB", BytesSize(3.42*GiB)) + assertEquals(t, "5.372 TiB", BytesSize(5.372*TiB)) + assertEquals(t, "2.22 PiB", BytesSize(2.22*PiB)) +} + +func TestHumanSize(t *testing.T) { + assertEquals(t, "1 kB", HumanSize(1000)) + assertEquals(t, "1.024 kB", HumanSize(1024)) + assertEquals(t, "1 MB", HumanSize(1000000)) + assertEquals(t, "1.049 MB", HumanSize(1048576)) + assertEquals(t, "2 MB", HumanSize(2*MB)) + assertEquals(t, "3.42 GB", HumanSize(float64(3.42*GB))) + assertEquals(t, "5.372 TB", HumanSize(float64(5.372*TB))) + assertEquals(t, "2.22 PB", HumanSize(float64(2.22*PB))) +} + +func TestFromHumanSize(t *testing.T) { + assertSuccessEquals(t, 32, FromHumanSize, "32") + assertSuccessEquals(t, 32, FromHumanSize, "32b") + assertSuccessEquals(t, 32, FromHumanSize, "32B") + assertSuccessEquals(t, 32*KB, FromHumanSize, "32k") + assertSuccessEquals(t, 32*KB, FromHumanSize, "32K") + assertSuccessEquals(t, 32*KB, FromHumanSize, "32kb") + assertSuccessEquals(t, 32*KB, FromHumanSize, "32Kb") + assertSuccessEquals(t, 32*MB, FromHumanSize, "32Mb") + assertSuccessEquals(t, 32*GB, FromHumanSize, "32Gb") + assertSuccessEquals(t, 32*TB, FromHumanSize, "32Tb") + assertSuccessEquals(t, 32*PB, FromHumanSize, "32Pb") + + assertError(t, FromHumanSize, "") + assertError(t, FromHumanSize, "hello") + assertError(t, FromHumanSize, "-32") + assertError(t, FromHumanSize, "32.3") + assertError(t, FromHumanSize, " 32 ") + assertError(t, FromHumanSize, "32.3Kb") + assertError(t, FromHumanSize, "32 mb") + assertError(t, FromHumanSize, "32m b") + assertError(t, FromHumanSize, "32bm") +} + +func TestRAMInBytes(t *testing.T) { + assertSuccessEquals(t, 32, RAMInBytes, "32") + assertSuccessEquals(t, 32, RAMInBytes, "32b") + assertSuccessEquals(t, 32, RAMInBytes, "32B") + assertSuccessEquals(t, 32*KiB, RAMInBytes, "32k") + assertSuccessEquals(t, 32*KiB, RAMInBytes, "32K") + assertSuccessEquals(t, 32*KiB, RAMInBytes, "32kb") + assertSuccessEquals(t, 32*KiB, RAMInBytes, "32Kb") + assertSuccessEquals(t, 32*MiB, RAMInBytes, "32Mb") + assertSuccessEquals(t, 32*GiB, RAMInBytes, "32Gb") + assertSuccessEquals(t, 32*TiB, RAMInBytes, "32Tb") + assertSuccessEquals(t, 32*PiB, RAMInBytes, "32Pb") + assertSuccessEquals(t, 32*PiB, RAMInBytes, "32PB") + assertSuccessEquals(t, 32*PiB, RAMInBytes, "32P") + + assertError(t, RAMInBytes, "") + assertError(t, RAMInBytes, "hello") + assertError(t, RAMInBytes, "-32") + assertError(t, RAMInBytes, "32.3") + assertError(t, RAMInBytes, " 32 ") + assertError(t, RAMInBytes, "32.3Kb") + assertError(t, RAMInBytes, "32 mb") + assertError(t, RAMInBytes, "32m b") + assertError(t, RAMInBytes, "32bm") +} + +func assertEquals(t *testing.T, expected, actual interface{}) { + if expected != actual { + t.Errorf("Expected '%v' but got '%v'", expected, actual) + } +} + +// func that maps to the parse function signatures as testing abstraction +type parseFn func(string) (int64, error) + +// Define 'String()' for pretty-print +func (fn parseFn) String() string { + fnName := runtime.FuncForPC(reflect.ValueOf(fn).Pointer()).Name() + return fnName[strings.LastIndex(fnName, ".")+1:] +} + +func assertSuccessEquals(t *testing.T, expected int64, fn parseFn, arg string) { + res, err := fn(arg) + if err != nil || res != expected { + t.Errorf("%s(\"%s\") -> expected '%d' but got '%d' with error '%v'", fn, arg, expected, res, err) + } +} + +func assertError(t *testing.T, fn parseFn, arg string) { + res, err := fn(arg) + if err == nil && res != -1 { + t.Errorf("%s(\"%s\") -> expected error but got '%d'", fn, arg, res) + } +} diff --git a/pkg/urlutil/urlutil.go b/pkg/urlutil/urlutil.go new file mode 100644 index 0000000000..f7094b1fef --- /dev/null +++ b/pkg/urlutil/urlutil.go @@ -0,0 +1,50 @@ +// Package urlutil provides helper function to check urls kind. +// It supports http urls, git urls and transport url (tcp://, …) +package urlutil + +import ( + "regexp" + "strings" +) + +var ( + validPrefixes = map[string][]string{ + "url": {"http://", "https://"}, + "git": {"git://", "github.com/", "git@"}, + "transport": {"tcp://", "udp://", "unix://"}, + } + urlPathWithFragmentSuffix = regexp.MustCompile(".git(?:#.+)?$") +) + +// IsURL returns true if the provided str is an HTTP(S) URL. +func IsURL(str string) bool { + return checkURL(str, "url") +} + +// IsGitURL returns true if the provided str is a git repository URL. +func IsGitURL(str string) bool { + if IsURL(str) && urlPathWithFragmentSuffix.MatchString(str) { + return true + } + return checkURL(str, "git") +} + +// IsGitTransport returns true if the provided str is a git transport by inspecting +// the prefix of the string for known protocols used in git. +func IsGitTransport(str string) bool { + return IsURL(str) || strings.HasPrefix(str, "git://") || strings.HasPrefix(str, "git@") +} + +// IsTransportURL returns true if the provided str is a transport (tcp, udp, unix) URL. +func IsTransportURL(str string) bool { + return checkURL(str, "transport") +} + +func checkURL(str, kind string) bool { + for _, prefix := range validPrefixes[kind] { + if strings.HasPrefix(str, prefix) { + return true + } + } + return false +} diff --git a/pkg/urlutil/urlutil_test.go b/pkg/urlutil/urlutil_test.go new file mode 100644 index 0000000000..bb89d8b5fd --- /dev/null +++ b/pkg/urlutil/urlutil_test.go @@ -0,0 +1,55 @@ +package urlutil + +import "testing" + +var ( + gitUrls = []string{ + "git://github.com/docker/docker", + "git@github.com:docker/docker.git", + "git@bitbucket.org:atlassianlabs/atlassian-docker.git", + "https://github.com/docker/docker.git", + "http://github.com/docker/docker.git", + "http://github.com/docker/docker.git#branch", + "http://github.com/docker/docker.git#:dir", + } + incompleteGitUrls = []string{ + "github.com/docker/docker", + } + invalidGitUrls = []string{ + "http://github.com/docker/docker.git:#branch", + } +) + +func TestValidGitTransport(t *testing.T) { + for _, url := range gitUrls { + if IsGitTransport(url) == false { + t.Fatalf("%q should be detected as valid Git prefix", url) + } + } + + for _, url := range incompleteGitUrls { + if IsGitTransport(url) == true { + t.Fatalf("%q should not be detected as valid Git prefix", url) + } + } +} + +func TestIsGIT(t *testing.T) { + for _, url := range gitUrls { + if IsGitURL(url) == false { + t.Fatalf("%q should be detected as valid Git url", url) + } + } + + for _, url := range incompleteGitUrls { + if IsGitURL(url) == false { + t.Fatalf("%q should be detected as valid Git url", url) + } + } + + for _, url := range invalidGitUrls { + if IsGitURL(url) == true { + t.Fatalf("%q should not be detected as valid Git prefix", url) + } + } +} diff --git a/pkg/useragent/README.md b/pkg/useragent/README.md new file mode 100644 index 0000000000..d9cb367d10 --- /dev/null +++ b/pkg/useragent/README.md @@ -0,0 +1 @@ +This package provides helper functions to pack version information into a single User-Agent header. diff --git a/pkg/useragent/useragent.go b/pkg/useragent/useragent.go new file mode 100644 index 0000000000..a410974835 --- /dev/null +++ b/pkg/useragent/useragent.go @@ -0,0 +1,55 @@ +// Package useragent provides helper functions to pack +// version information into a single User-Agent header. +package useragent + +import ( + "strings" +) + +// VersionInfo is used to model UserAgent versions. +type VersionInfo struct { + Name string + Version string +} + +func (vi *VersionInfo) isValid() bool { + const stopChars = " \t\r\n/" + name := vi.Name + vers := vi.Version + if len(name) == 0 || strings.ContainsAny(name, stopChars) { + return false + } + if len(vers) == 0 || strings.ContainsAny(vers, stopChars) { + return false + } + return true +} + +// AppendVersions converts versions to a string and appends the string to the string base. +// +// Each VersionInfo will be converted to a string in the format of +// "product/version", where the "product" is get from the name field, while +// version is get from the version field. Several pieces of verson information +// will be concatinated and separated by space. +// +// Example: +// AppendVersions("base", VersionInfo{"foo", "1.0"}, VersionInfo{"bar", "2.0"}) +// results in "base foo/1.0 bar/2.0". +func AppendVersions(base string, versions ...VersionInfo) string { + if len(versions) == 0 { + return base + } + + verstrs := make([]string, 0, 1+len(versions)) + if len(base) > 0 { + verstrs = append(verstrs, base) + } + + for _, v := range versions { + if !v.isValid() { + continue + } + verstrs = append(verstrs, v.Name+"/"+v.Version) + } + return strings.Join(verstrs, " ") +} diff --git a/pkg/useragent/useragent_test.go b/pkg/useragent/useragent_test.go new file mode 100644 index 0000000000..0ad7243a6d --- /dev/null +++ b/pkg/useragent/useragent_test.go @@ -0,0 +1,31 @@ +package useragent + +import "testing" + +func TestVersionInfo(t *testing.T) { + vi := VersionInfo{"foo", "bar"} + if !vi.isValid() { + t.Fatalf("VersionInfo should be valid") + } + vi = VersionInfo{"", "bar"} + if vi.isValid() { + t.Fatalf("Expected VersionInfo to be invalid") + } + vi = VersionInfo{"foo", ""} + if vi.isValid() { + t.Fatalf("Expected VersionInfo to be invalid") + } +} + +func TestAppendVersions(t *testing.T) { + vis := []VersionInfo{ + {"foo", "1.0"}, + {"bar", "0.1"}, + {"pi", "3.1.4"}, + } + v := AppendVersions("base", vis...) + expect := "base foo/1.0 bar/0.1 pi/3.1.4" + if v != expect { + t.Fatalf("expected %q, got %q", expect, v) + } +} diff --git a/pkg/version/version.go b/pkg/version/version.go new file mode 100644 index 0000000000..bd5ec7a835 --- /dev/null +++ b/pkg/version/version.go @@ -0,0 +1,63 @@ +package version + +import ( + "strconv" + "strings" +) + +// Version provides utility methods for comparing versions. +type Version string + +func (v Version) compareTo(other Version) int { + var ( + currTab = strings.Split(string(v), ".") + otherTab = strings.Split(string(other), ".") + ) + + max := len(currTab) + if len(otherTab) > max { + max = len(otherTab) + } + for i := 0; i < max; i++ { + var currInt, otherInt int + + if len(currTab) > i { + currInt, _ = strconv.Atoi(currTab[i]) + } + if len(otherTab) > i { + otherInt, _ = strconv.Atoi(otherTab[i]) + } + if currInt > otherInt { + return 1 + } + if otherInt > currInt { + return -1 + } + } + return 0 +} + +// LessThan checks if a version is less than another +func (v Version) LessThan(other Version) bool { + return v.compareTo(other) == -1 +} + +// LessThanOrEqualTo checks if a version is less than or equal to another +func (v Version) LessThanOrEqualTo(other Version) bool { + return v.compareTo(other) <= 0 +} + +// GreaterThan checks if a version is greater than another +func (v Version) GreaterThan(other Version) bool { + return v.compareTo(other) == 1 +} + +// GreaterThanOrEqualTo checks if a version is greater than or equal to another +func (v Version) GreaterThanOrEqualTo(other Version) bool { + return v.compareTo(other) >= 0 +} + +// Equal checks if a version is equal to another +func (v Version) Equal(other Version) bool { + return v.compareTo(other) == 0 +} diff --git a/pkg/version/version_test.go b/pkg/version/version_test.go new file mode 100644 index 0000000000..c02ec40fcb --- /dev/null +++ b/pkg/version/version_test.go @@ -0,0 +1,27 @@ +package version + +import ( + "testing" +) + +func assertVersion(t *testing.T, a, b string, result int) { + if r := Version(a).compareTo(Version(b)); r != result { + t.Fatalf("Unexpected version comparison result. Found %d, expected %d", r, result) + } +} + +func TestCompareVersion(t *testing.T) { + assertVersion(t, "1.12", "1.12", 0) + assertVersion(t, "1.0.0", "1", 0) + assertVersion(t, "1", "1.0.0", 0) + assertVersion(t, "1.05.00.0156", "1.0.221.9289", 1) + assertVersion(t, "1", "1.0.1", -1) + assertVersion(t, "1.0.1", "1", 1) + assertVersion(t, "1.0.1", "1.0.2", -1) + assertVersion(t, "1.0.2", "1.0.3", -1) + assertVersion(t, "1.0.3", "1.1", -1) + assertVersion(t, "1.1", "1.1.1", -1) + assertVersion(t, "1.1.1", "1.1.2", -1) + assertVersion(t, "1.1.2", "1.2", -1) + +} diff --git a/project/BRANCHES-AND-TAGS.md b/project/BRANCHES-AND-TAGS.md new file mode 100644 index 0000000000..1c6f232524 --- /dev/null +++ b/project/BRANCHES-AND-TAGS.md @@ -0,0 +1,35 @@ +Branches and tags +================= + +Note: details of the release process for the Engine are documented in the +[RELEASE-CHECKLIST](https://github.com/docker/docker/blob/master/project/RELEASE-CHECKLIST.md). + +# Branches + +The docker/docker repository should normally have only three living branches at all time, including +the regular `master` branch: + +## `docs` branch + +The `docs` branch supports documentation updates between product releases. This branch allow us to +decouple documentation releases from product releases. + +## `release` branch + +The `release` branch contains the last _released_ version of the code for the project. + +The `release` branch is only updated at each public release of the project. The mechanism for this +is that the release is materialized by a pull request against the `release` branch which lives for +the duration of the code freeze period. When this pull request is merged, the `release` branch gets +updated, and its new state is tagged accordingly. + +# Tags + +Any public release of a compiled binary, with the logical exception of nightly builds, should have +a corresponding tag in the repository. + +The general format of a tag is `vX.Y.Z[-suffix[N]]`: + +- All of `X`, `Y`, `Z` must be specified (example: `v1.0.0`) +- First release candidate for version `1.8.0` should be tagged `v1.8.0-rc1` +- Second alpha release of a product should be tagged `v1.0.0-alpha1` diff --git a/project/CONTRIBUTORS.md b/project/CONTRIBUTORS.md new file mode 120000 index 0000000000..44fcc63439 --- /dev/null +++ b/project/CONTRIBUTORS.md @@ -0,0 +1 @@ +../CONTRIBUTING.md \ No newline at end of file diff --git a/project/GOVERNANCE.md b/project/GOVERNANCE.md new file mode 100644 index 0000000000..6ae7baf743 --- /dev/null +++ b/project/GOVERNANCE.md @@ -0,0 +1,17 @@ +# Docker Governance Advisory Board Meetings + +In the spirit of openness, Docker created a Governance Advisory Board, and committed to make all materials and notes from the meetings of this group public. +All output from the meetings should be considered proposals only, and are subject to the review and approval of the community and the project leadership. + +The materials from the first Docker Governance Advisory Board meeting, held on October 28, 2014, are available at +[Google Docs Folder](https://goo.gl/Alfj8r) + +These include: + +* First Meeting Notes +* DGAB Charter +* Presentation 1: Introductory Presentation, including State of The Project +* Presentation 2: Overall Contribution Structure/Docker Project Core Proposal +* Presentation 3: Long Term Roadmap/Statement of Direction + + diff --git a/project/IRC-ADMINISTRATION.md b/project/IRC-ADMINISTRATION.md new file mode 100644 index 0000000000..824a14bd51 --- /dev/null +++ b/project/IRC-ADMINISTRATION.md @@ -0,0 +1,37 @@ +# Freenode IRC Administration Guidelines and Tips + +This is not meant to be a general "Here's how to IRC" document, so if you're +looking for that, check Google instead. ♥ + +If you've been charged with helping maintain one of Docker's now many IRC +channels, this might turn out to be useful. If there's information that you +wish you'd known about how a particular channel is organized, you should add +deets here! :) + +## `ChanServ` + +Most channel maintenance happens by talking to Freenode's `ChanServ` bot. For +example, `/msg ChanServ ACCESS LIST` will show you a list of everyone +with "access" privileges for a particular channel. + +A similar command is used to give someone a particular access level. For +example, to add a new maintainer to the `#docker-maintainers` access list so +that they can contribute to the discussions (after they've been merged +appropriately in a `MAINTAINERS` file, of course), one would use `/msg ChanServ +ACCESS #docker-maintainers ADD maintainer`. + +To setup a new channel with a similar `maintainer` access template, use a +command like `/msg ChanServ TEMPLATE maintainer +AV` (`+A` for letting +them view the `ACCESS LIST`, `+V` for auto-voice; see `/msg ChanServ HELP FLAGS` +for more details). + +## Troubleshooting + +The most common cause of not-getting-auto-`+v` woes is people not being +`IDENTIFY`ed with `NickServ` (or their current nickname not being `GROUP`ed with +their main nickname) -- often manifested by `ChanServ` responding to an `ACCESS +ADD` request with something like `xyz is not registered.`. + +This is easily fixed by doing `/msg NickServ IDENTIFY OldNick SecretPassword` +followed by `/msg NickServ GROUP` to group the two nicknames together. See +`/msg NickServ HELP GROUP` for more information. diff --git a/project/ISSUE-TRIAGE.md b/project/ISSUE-TRIAGE.md new file mode 100644 index 0000000000..d02b2ee1f6 --- /dev/null +++ b/project/ISSUE-TRIAGE.md @@ -0,0 +1,92 @@ +Triaging of issues +------------------ + +Triage provides an important way to contribute to an open source project. Triage helps ensure issues resolve quickly by: + +- Describing the issue's intent and purpose is conveyed precisely. This is necessary because it can be difficult for an issue to explain how an end user experiences an problem and what actions they took. +- Giving a contributor the information they need before they commit to resolving an issue. +- Lowering the issue count by preventing duplicate issues. +- Streamlining the development process by preventing duplicate discussions. + +If you don't have time to code, consider helping with triage. The community will thank you for saving them time by spending some of yours. + +### 1. Ensure the issue contains basic information + +Before triaging an issue very far, make sure that the issue's author provided the standard issue information. This will help you make an educated recommendation on how this to categorize the issue. Standard information that *must* be included in most issues are things such as: + +- the output of `docker version` +- the output of `docker info` +- the output of `uname -a` +- a reproducible case if this is a bug, Dockerfiles FTW +- host distribution and version ( ubuntu 14.04, RHEL, fedora 21 ) +- page URL if this is a docs issue or the name of a man page + +Depending on the issue, you might not feel all this information is needed. Use your best judgement. If you cannot triage an issue using what its author provided, explain kindly to the author that they must provide the above information to clarify the problem. + +If the author provides the standard information but you are still unable to triage the issue, request additional information. Do this kindly and politely because you are asking for more of the author's time. + +If the author does not respond requested information within the timespan of a week, close the issue with a kind note stating that the author can request for the issue to be +reopened when the necessary information is provided. + +### 2. Classify the Issue + +An issue can have multiple of the following labels. + +#### Issue kind + +| Kind | Description | +|------------------|---------------------------------------------------------------------------------------------------------------------------------| +| kind/bug | Bugs are bugs. The cause may or may not be known at triage time so debugging should be taken account into the time estimate. | +| kind/docs | Writing documentation, man pages, articles, blogs, or other significant word-driven task. | +| kind/enhancement | Enhancement are not bugs or new features but can drastically improve usability or performance of a project component. | +| kind/feature | Functionality or other elements that the project does not currently support. Features are new and shinny. | +| kind/question | Contains a user or contributor question requiring a response. | + +#### Functional area + +| Area | +|---------------------------| +| area/api | +| area/builder | +| area/cli | +| area/kernel | +| area/runtime | +| area/storage | +| area/storage/aufs | +| area/storage/btrfs | +| area/storage/devicemapper | +| area/storage/overlay | +| area/storage/zfs | + +#### Experience level + +Experience level is a way for a contributor to find an issue based on their +skill set. Experience types are applied to the issue or pull request using +labels. + +| Level | Experience level guideline | +|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| exp/beginner | New to Docker, and possibly Golang, and is looking to help while learning the basics. | +| exp/intermediate | Comfortable with golang and understands the core concepts of Docker and looking to dive deeper into the project. | +| exp/expert | Proficient with Docker and Golang and has been following, and active in, the community to understand the rationale behind design decisions and where the project is headed. | + +As the table states, these labels are meant as guidelines. You might have +written a whole plugin for Docker in a personal project and never contributed to +Docker. With that kind of experience, you could take on an exp/expert level task. + +### 3. Prioritizing issue + +When attached to a specific milestone, an issue can be attributed one of the +following labels to indicate their degree of priority (from more urgent to less +urgent). + +| Priority | Description | +|-------------|-----------------------------------------------------------------------------------------------------------------------------------| +| priority/P0 | Urgent: Security, critical bugs, blocking issues. P0 basically means drop everything you are doing until this issue is addressed. | +| priority/P1 | Important: P1 issues are a top priority and a must-have for the next release. | +| priority/P2 | Normal priority: default priority applied. | +| priority/P3 | Best effort: those are nice to have / minor issues. | + +And that's it. That should be all the information required for a new or existing contributor to come in an resolve an issue. + diff --git a/project/PACKAGERS.md b/project/PACKAGERS.md new file mode 100644 index 0000000000..bb5d49a930 --- /dev/null +++ b/project/PACKAGERS.md @@ -0,0 +1,331 @@ +# Dear Packager, + +If you are looking to make Docker available on your favorite software +distribution, this document is for you. It summarizes the requirements for +building and running the Docker client and the Docker daemon. + +## Getting Started + +We want to help you package Docker successfully. Before doing any packaging, a +good first step is to introduce yourself on the [docker-dev mailing +list](https://groups.google.com/d/forum/docker-dev), explain what you're trying +to achieve, and tell us how we can help. Don't worry, we don't bite! There might +even be someone already working on packaging for the same distro! + +You can also join the IRC channel - #docker and #docker-dev on Freenode are both +active and friendly. + +We like to refer to Tianon ("@tianon" on GitHub and "tianon" on IRC) as our +"Packagers Relations", since he's always working to make sure our packagers have +a good, healthy upstream to work with (both in our communication and in our +build scripts). If you're having any kind of trouble, feel free to ping him +directly. He also likes to keep track of what distributions we have packagers +for, so feel free to reach out to him even just to say "Hi!" + +## Package Name + +If possible, your package should be called "docker". If that name is already +taken, a second choice is "docker-engine". Another possible choice is "docker.io". + +## Official Build vs Distro Build + +The Docker project maintains its own build and release toolchain. It is pretty +neat and entirely based on Docker (surprise!). This toolchain is the canonical +way to build Docker. We encourage you to give it a try, and if the circumstances +allow you to use it, we recommend that you do. + +You might not be able to use the official build toolchain - usually because your +distribution has a toolchain and packaging policy of its own. We get it! Your +house, your rules. The rest of this document should give you the information you +need to package Docker your way, without denaturing it in the process. + +## Build Dependencies + +To build Docker, you will need the following: + +* A recent version of Git and Mercurial +* Go version 1.4 or later +* A clean checkout of the source added to a valid [Go + workspace](https://golang.org/doc/code.html#Workspaces) under the path + *src/github.com/docker/docker* (unless you plan to use `AUTO_GOPATH`, + explained in more detail below) + +To build the Docker daemon, you will additionally need: + +* An amd64/x86_64 machine running Linux +* SQLite version 3.7.9 or later +* libdevmapper version 1.02.68-cvs (2012-01-26) or later from lvm2 version + 2.02.89 or later +* btrfs-progs version 3.16.1 or later (unless using an older version is + absolutely necessary, in which case 3.8 is the minimum) + +Be sure to also check out Docker's Dockerfile for the most up-to-date list of +these build-time dependencies. + +### Go Dependencies + +All Go dependencies are vendored under "./vendor". They are used by the official +build, so the source of truth for the current version of each dependency is +whatever is in "./vendor". + +To use the vendored dependencies, simply make sure the path to "./vendor" is +included in `GOPATH` (or use `AUTO_GOPATH`, as explained below). + +If you would rather (or must, due to distro policy) package these dependencies +yourself, take a look at "./hack/vendor.sh" for an easy-to-parse list of the +exact version for each. + +NOTE: if you're not able to package the exact version (to the exact commit) of a +given dependency, please get in touch so we can remediate! Who knows what +discrepancies can be caused by even the slightest deviation. We promise to do +our best to make everybody happy. + +## Stripping Binaries + +Please, please, please do not strip any compiled binaries. This is really +important. + +In our own testing, stripping the resulting binaries sometimes results in a +binary that appears to work, but more often causes random panics, segfaults, and +other issues. Even if the binary appears to work, please don't strip. + +See the following quotes from Dave Cheney, which explain this position better +from the upstream Golang perspective. + +### [go issue #5855, comment #3](https://code.google.com/p/go/issues/detail?id=5855#c3) + +> Super super important: Do not strip go binaries or archives. It isn't tested, +> often breaks, and doesn't work. + +### [launchpad golang issue #1200255, comment #8](https://bugs.launchpad.net/ubuntu/+source/golang/+bug/1200255/comments/8) + +> To quote myself: "Please do not strip Go binaries, it is not supported, not +> tested, is often broken, and doesn't do what you want" +> +> To unpack that a bit +> +> * not supported, as in, we don't support it, and recommend against it when +> asked +> * not tested, we don't test stripped binaries as part of the build CI process +> * is often broken, stripping a go binary will produce anywhere from no, to +> subtle, to outright execution failure, see above + +### [launchpad golang issue #1200255, comment #13](https://bugs.launchpad.net/ubuntu/+source/golang/+bug/1200255/comments/13) + +> To clarify my previous statements. +> +> * I do not disagree with the debian policy, it is there for a good reason +> * Having said that, it stripping Go binaries doesn't work, and nobody is +> looking at making it work, so there is that. +> +> Thanks for patching the build formula. + +## Building Docker + +Please use our build script ("./hack/make.sh") for all your compilation of +Docker. If there's something you need that it isn't doing, or something it could +be doing to make your life as a packager easier, please get in touch with Tianon +and help us rectify the situation. Chances are good that other packagers have +probably run into the same problems and a fix might already be in the works, but +none of us will know for sure unless you harass Tianon about it. :) + +All the commands listed within this section should be run with the Docker source +checkout as the current working directory. + +### `AUTO_GOPATH` + +If you'd rather not be bothered with the hassles that setting up `GOPATH` +appropriately can be, and prefer to just get a "build that works", you should +add something similar to this to whatever script or process you're using to +build Docker: + +```bash +export AUTO_GOPATH=1 +``` + +This will cause the build scripts to set up a reasonable `GOPATH` that +automatically and properly includes both docker/docker from the local +directory, and the local "./vendor" directory as necessary. + +### `DOCKER_BUILDTAGS` + +If you're building a binary that may need to be used on platforms that include +AppArmor, you will need to set `DOCKER_BUILDTAGS` as follows: +```bash +export DOCKER_BUILDTAGS='apparmor' +``` + +If you're building a binary that may need to be used on platforms that include +SELinux, you will need to use the `selinux` build tag: +```bash +export DOCKER_BUILDTAGS='selinux' +``` + +There are build tags for disabling graphdrivers as well. By default, support +for all graphdrivers are built in. + +To disable btrfs: +```bash +export DOCKER_BUILDTAGS='exclude_graphdriver_btrfs' +``` + +To disable devicemapper: +```bash +export DOCKER_BUILDTAGS='exclude_graphdriver_devicemapper' +``` + +To disable aufs: +```bash +export DOCKER_BUILDTAGS='exclude_graphdriver_aufs' +``` + +NOTE: if you need to set more than one build tag, space separate them: +```bash +export DOCKER_BUILDTAGS='apparmor selinux exclude_graphdriver_aufs' +``` + +### Static Daemon + +If it is feasible within the constraints of your distribution, you should +seriously consider packaging Docker as a single static binary. A good comparison +is Busybox, which is often packaged statically as a feature to enable mass +portability. Because of the unique way Docker operates, being similarly static +is a "feature". + +To build a static Docker daemon binary, run the following command (first +ensuring that all the necessary libraries are available in static form for +linking - see the "Build Dependencies" section above, and the relevant lines +within Docker's own Dockerfile that set up our official build environment): + +```bash +./hack/make.sh binary +``` + +This will create a static binary under +"./bundles/$VERSION/binary/docker-$VERSION", where "$VERSION" is the contents of +the file "./VERSION". This binary is usually installed somewhere like +"/usr/bin/docker". + +### Dynamic Daemon / Client-only Binary + +If you are only interested in a Docker client binary, set `DOCKER_CLIENTONLY` to a non-empty value using something similar to the following: (which will prevent the extra step of compiling dockerinit) + +```bash +export DOCKER_CLIENTONLY=1 +``` + +If you need to (due to distro policy, distro library availability, or for other +reasons) create a dynamically compiled daemon binary, or if you are only +interested in creating a client binary for Docker, use something similar to the +following: + +```bash +./hack/make.sh dynbinary +``` + +This will create "./bundles/$VERSION/dynbinary/docker-$VERSION", which for +client-only builds is the important file to grab and install as appropriate. + +For daemon builds, you will also need to grab and install +"./bundles/$VERSION/dynbinary/dockerinit-$VERSION", which is created from the +minimal set of Docker's codebase that _must_ be compiled statically (and is thus +a pure static binary). The acceptable locations Docker will search for this file +are as follows (in order): + +* as "dockerinit" in the same directory as the daemon binary (ie, if docker is + installed at "/usr/bin/docker", then "/usr/bin/dockerinit" will be the first + place this file is searched for) +* "/usr/libexec/docker/dockerinit" or "/usr/local/libexec/docker/dockerinit" + ([FHS 3.0 Draft](https://www.linuxbase.org/betaspecs/fhs/fhs.html#usrlibexec)) +* "/usr/lib/docker/dockerinit" or "/usr/local/lib/docker/dockerinit" ([FHS + 2.3](https://refspecs.linuxfoundation.org/FHS_2.3/fhs-2.3.html#USRLIBLIBRARIESFORPROGRAMMINGANDPA)) + +If (and please, only if) one of the paths above is insufficient due to distro +policy or similar issues, you may use the `DOCKER_INITPATH` environment variable +at compile-time as follows to set a different path for Docker to search: + +```bash +export DOCKER_INITPATH=/usr/lib/docker.io/dockerinit +``` + +If you find yourself needing this, please don't hesitate to reach out to Tianon +to see if it would be reasonable or helpful to add more paths to Docker's list, +especially if there's a relevant standard worth referencing (such as the FHS). + +Also, it goes without saying, but for the purposes of the daemon please consider +these two binaries ("docker" and "dockerinit") as if they were a single unit. +Mixing and matching can cause undesired consequences, and will fail to run +properly. + +## System Dependencies + +### Runtime Dependencies + +To function properly, the Docker daemon needs the following software to be +installed and available at runtime: + +* iptables version 1.4 or later +* procps (or similar provider of a "ps" executable) +* e2fsprogs version 1.4.12 or later (in use: mkfs.ext4, tune2fs) +* xfsprogs (in use: mkfs.xfs) +* XZ Utils version 4.9 or later +* a [properly + mounted](https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount) + cgroupfs hierarchy (having a single, all-encompassing "cgroup" mount point + [is](https://github.com/docker/docker/issues/2683) + [not](https://github.com/docker/docker/issues/3485) + [sufficient](https://github.com/docker/docker/issues/4568)) + +Additionally, the Docker client needs the following software to be installed and +available at runtime: + +* Git version 1.7 or later + +### Kernel Requirements + +The Docker daemon has very specific kernel requirements. Most pre-packaged +kernels already include the necessary options enabled. If you are building your +own kernel, you will either need to discover the options necessary via trial and +error, or check out the [Gentoo +ebuild](https://github.com/tianon/docker-overlay/blob/master/app-emulation/docker/docker-9999.ebuild), +in which a list is maintained (and if there are any issues or discrepancies in +that list, please contact Tianon so they can be rectified). + +Note that in client mode, there are no specific kernel requirements, and that +the client will even run on alternative platforms such as Mac OS X / Darwin. + +### Optional Dependencies + +Some of Docker's features are activated by using optional command-line flags or +by having support for them in the kernel or userspace. A few examples include: + +* LXC execution driver (requires version 1.0.7 or later of lxc and the lxc-libs) +* AUFS graph driver (requires AUFS patches/support enabled in the kernel, and at + least the "auplink" utility from aufs-tools) +* BTRFS graph driver (requires BTRFS support enabled in the kernel) +* ZFS graph driver (requires userspace zfs-utils and a corresponding kernel module) + +## Daemon Init Script + +Docker expects to run as a daemon at machine startup. Your package will need to +include a script for your distro's process supervisor of choice. Be sure to +check out the "contrib/init" folder in case a suitable init script already +exists (and if one does not, contact Tianon about whether it might be +appropriate for your distro's init script to live there too!). + +In general, Docker should be run as root, similar to the following: + +```bash +docker daemon +``` + +Generally, a `DOCKER_OPTS` variable of some kind is available for adding more +flags (such as changing the graph driver to use BTRFS, switching the location of +"/var/lib/docker", etc). + +## Communicate + +As a final note, please do feel free to reach out to Tianon at any time for +pretty much anything. He really does love hearing from our packagers and wants +to make sure we're not being a "hostile upstream". As should be a given, we +appreciate the work our packagers do to make sure we have broad distribution! diff --git a/project/PRINCIPLES.md b/project/PRINCIPLES.md new file mode 100644 index 0000000000..53f03018ec --- /dev/null +++ b/project/PRINCIPLES.md @@ -0,0 +1,19 @@ +# Docker principles + +In the design and development of Docker we try to follow these principles: + +(Work in progress) + +* Don't try to replace every tool. Instead, be an ingredient to improve them. +* Less code is better. +* Fewer components are better. Do you really need to add one more class? +* 50 lines of straightforward, readable code is better than 10 lines of magic that nobody can understand. +* Don't do later what you can do now. "//FIXME: refactor" is not acceptable in new code. +* When hesitating between 2 options, choose the one that is easier to reverse. +* No is temporary, Yes is forever. If you're not sure about a new feature, say no. You can change your mind later. +* Containers must be portable to the greatest possible number of machines. Be suspicious of any change which makes machines less interchangeable. +* The less moving parts in a container, the better. +* Don't merge it unless you document it. +* Don't document it unless you can keep it up-to-date. +* Don't merge it unless you test it! +* Everyone's problem is slightly different. Focus on the part that is the same for everyone, and solve that. diff --git a/project/README.md b/project/README.md new file mode 100644 index 0000000000..3ed68cf297 --- /dev/null +++ b/project/README.md @@ -0,0 +1,24 @@ +# Hacking on Docker + +The `project/` directory holds information and tools for everyone involved in the process of creating and +distributing Docker, specifically: + +## Guides + +If you're a *contributor* or aspiring contributor, you should read [CONTRIBUTORS.md](../CONTRIBUTING.md). + +If you're a *maintainer* or aspiring maintainer, you should read [MAINTAINERS](../MAINTAINERS). + +If you're a *packager* or aspiring packager, you should read [PACKAGERS.md](./PACKAGERS.md). + +If you're a maintainer in charge of a *release*, you should read [RELEASE-CHECKLIST.md](./RELEASE-CHECKLIST.md). + +## Roadmap + +A high-level roadmap is available at [ROADMAP.md](../ROADMAP.md). + + +## Build tools + +[hack/make.sh](../hack/make.sh) is the primary build tool for docker. It is used for compiling the official binary, +running the test suite, and pushing releases. diff --git a/project/RELEASE-CHECKLIST.md b/project/RELEASE-CHECKLIST.md new file mode 100644 index 0000000000..814ac56050 --- /dev/null +++ b/project/RELEASE-CHECKLIST.md @@ -0,0 +1,415 @@ +# Release Checklist +## A maintainer's guide to releasing Docker + +So you're in charge of a Docker release? Cool. Here's what to do. + +If your experience deviates from this document, please document the changes +to keep it up-to-date. + +It is important to note that this document assumes that the git remote in your +repository that corresponds to "https://github.com/docker/docker" is named +"origin". If yours is not (for example, if you've chosen to name it "upstream" +or something similar instead), be sure to adjust the listed snippets for your +local environment accordingly. If you are not sure what your upstream remote is +named, use a command like `git remote -v` to find out. + +If you don't have an upstream remote, you can add one easily using something +like: + +```bash +export GITHUBUSER="YOUR_GITHUB_USER" +git remote add origin https://github.com/docker/docker.git +git remote add $GITHUBUSER git@github.com:$GITHUBUSER/docker.git +``` + +### 1. Pull from master and create a release branch + +All releases version numbers will be of the form: vX.Y.Z where X is the major +version number, Y is the minor version number and Z is the patch release version number. + +#### Major releases + +The release branch name is just vX.Y because it's going to be the basis for all .Z releases. + +```bash +export BASE=vX.Y +export VERSION=vX.Y.Z +git fetch origin +git checkout --track origin/master +git checkout -b release/$BASE +``` + +This new branch is going to be the base for the release. We need to push it to origin so we +can track the cherry-picked changes and the version bump: + +```bash +git push origin release/$BASE +``` + +When you have the major release branch in origin, we need to create the bump fork branch +that we'll push to our fork: + +```bash +git checkout -b bump_$VERSION +``` + +#### Patch releases + +If we have the release branch in origin, we can create the forked bump branch from it directly: + +```bash +export VERSION=vX.Y.Z +export PATCH=vX.Y.Z+1 +git fetch origin +git checkout --track origin/release/$BASE +git checkout -b bump_$PATCH +``` + +We cherry-pick only the commits we want into the bump branch: + +```bash +# get the commits ids we want to cherry-pick +git log +# cherry-pick the commits starting from the oldest one, without including merge commits +git cherry-pick +git cherry-pick +... +``` + +### 2. Bump the API version on master + +We don't want to stop contributions to master just because we are releasing. At +the same time, now that the release branch exists, we don't want API changes to +go to the now frozen API version. + +Create a new entry in `docs/reference/api/` by copying the latest and +bumping the version number (in both the file's name and content), and submit +this in a PR against master. + +### 3. Update CHANGELOG.md + +You can run this command for reference with git 2.0: + +```bash +git fetch --tags +LAST_VERSION=$(git tag -l --sort=-version:refname "v*" | grep -E 'v[0-9\.]+$' | head -1) +git log --stat $LAST_VERSION..bump_$VERSION +``` + +If you don't have git 2.0 but have a sort command that supports `-V`: +```bash +git fetch --tags +LAST_VERSION=$(git tag -l | grep -E 'v[0-9\.]+$' | sort -rV | head -1) +git log --stat $LAST_VERSION..bump_$VERSION +``` + +If releasing a major version (X or Y increased in vX.Y.Z), simply listing notable user-facing features is sufficient. +```markdown +#### Notable features since +* New docker command to do something useful +* Remote API change (deprecating old version) +* Performance improvements in some usecases +* ... +``` + +For minor releases (only Z increases in vX.Y.Z), provide a list of user-facing changes. +Each change should be listed under a category heading formatted as `#### CATEGORY`. + +`CATEGORY` should describe which part of the project is affected. + Valid categories are: + * Builder + * Documentation + * Hack + * Packaging + * Remote API + * Runtime + * Other (please use this category sparingly) + +Each change should be formatted as `BULLET DESCRIPTION`, given: + +* BULLET: either `-`, `+` or `*`, to indicate a bugfix, new feature or + upgrade, respectively. + +* DESCRIPTION: a concise description of the change that is relevant to the + end-user, using the present tense. Changes should be described in terms + of how they affect the user, for example "Add new feature X which allows Y", + "Fix bug which caused X", "Increase performance of Y". + +EXAMPLES: + +```markdown +## 0.3.6 (1995-12-25) + +#### Builder + ++ 'docker build -t FOO .' applies the tag FOO to the newly built image + +#### Remote API + +- Fix a bug in the optional unix socket transport + +#### Runtime + +* Improve detection of kernel version +``` + +If you need a list of contributors between the last major release and the +current bump branch, use something like: +```bash +git log --format='%aN <%aE>' v0.7.0...bump_v0.8.0 | sort -uf +``` +Obviously, you'll need to adjust version numbers as necessary. If you just need +a count, add a simple `| wc -l`. + +### 4. Change the contents of the VERSION file + +Before the big thing, you'll want to make successive release candidates and get +people to test. The release candidate number `N` should be part of the version: + +```bash +export RC_VERSION=${VERSION}-rcN +echo ${RC_VERSION#v} > VERSION +``` + +### 5. Test the docs + +Make sure that your tree includes documentation for any modified or +new features, syntax or semantic changes. + +To test locally: + +```bash +make docs +``` + +To make a shared test at https://beta-docs.docker.io: + +(You will need the `awsconfig` file added to the `docs/` dir) + +```bash +make AWS_S3_BUCKET=beta-docs.docker.io BUILD_ROOT=yes docs-release +``` + +### 6. Commit and create a pull request to the "release" branch + +```bash +git add VERSION CHANGELOG.md +git commit -m "Bump version to $VERSION" +git push $GITHUBUSER bump_$VERSION +echo "https://github.com/$GITHUBUSER/docker/compare/docker:release/$BASE...$GITHUBUSER:bump_$VERSION?expand=1" +``` + +That last command will give you the proper link to visit to ensure that you +open the PR against the "release" branch instead of accidentally against +"master" (like so many brave souls before you already have). + +### 7. Publish release candidate binaries + +To run this you will need access to the release credentials. Get them from the +Core maintainers. + +Replace "..." with the respective credentials: + +```bash +docker build -t docker . + +docker run \ + -e AWS_S3_BUCKET=test.docker.com \ + -e AWS_ACCESS_KEY="..." \ + -e AWS_SECRET_KEY="..." \ + -e GPG_PASSPHRASE="..." \ + -i -t --privileged \ + docker \ + hack/release.sh +``` + +It will run the test suite, build the binaries and packages, and upload to the +specified bucket, so this is a good time to verify that you're running against +**test**.docker.com. + +After the binaries and packages are uploaded to test.docker.com, make sure +they get tested in both Ubuntu and Debian for any obvious installation +issues or runtime issues. + +If everything looks good, it's time to create a git tag for this candidate: + +```bash +git tag -a $RC_VERSION -m $RC_VERSION bump_$VERSION +git push origin $RC_VERSION +``` + +Announcing on multiple medias is the best way to get some help testing! An easy +way to get some useful links for sharing: + +```bash +echo "Ubuntu/Debian: https://test.docker.com/ubuntu or curl -sSL https://test.docker.com/ | sh" +echo "Linux 64bit binary: https://test.docker.com/builds/Linux/x86_64/docker-${VERSION#v}" +echo "Darwin/OSX 64bit client binary: https://test.docker.com/builds/Darwin/x86_64/docker-${VERSION#v}" +echo "Darwin/OSX 32bit client binary: https://test.docker.com/builds/Darwin/i386/docker-${VERSION#v}" +echo "Linux 64bit tgz: https://test.docker.com/builds/Linux/x86_64/docker-${VERSION#v}.tgz" +``` + +We recommend announcing the release candidate on: + +- IRC on #docker, #docker-dev, #docker-maintainers +- In a comment on the pull request to notify subscribed people on GitHub +- The [docker-dev](https://groups.google.com/forum/#!forum/docker-dev) group +- The [docker-maintainers](https://groups.google.com/a/dockerproject.org/forum/#!forum/maintainers) group +- Any social media that can bring some attention to the release candidate + +### 8. Iterate on successive release candidates + +Spend several days along with the community explicitly investing time and +resources to try and break Docker in every possible way, documenting any +findings pertinent to the release. This time should be spent testing and +finding ways in which the release might have caused various features or upgrade +environments to have issues, not coding. During this time, the release is in +code freeze, and any additional code changes will be pushed out to the next +release. + +It should include various levels of breaking Docker, beyond just using Docker +by the book. + +Any issues found may still remain issues for this release, but they should be +documented and give appropriate warnings. + +During this phase, the `bump_$VERSION` branch will keep evolving as you will +produce new release candidates. The frequency of new candidates is up to the +release manager: use your best judgement taking into account the severity of +reported issues, testers availability, and time to scheduled release date. + +Each time you'll want to produce a new release candidate, you will start by +adding commits to the branch, usually by cherry-picking from master: + +```bash +git cherry-pick -x -m0 +``` + +You want your "bump commit" (the one that updates the CHANGELOG and VERSION +files) to remain on top, so you'll have to `git rebase -i` to bring it back up. + +Now that your bump commit is back on top, you will need to update the CHANGELOG +file (if appropriate for this particular release candidate), and update the +VERSION file to increment the RC number: + +```bash +export RC_VERSION=$VERSION-rcN +echo $RC_VERSION > VERSION +``` + +You can now amend your last commit and update the bump branch: + +```bash +git commit --amend +git push -f $GITHUBUSER bump_$VERSION +``` + +Repeat step 6 to tag the code, publish new binaries, announce availability, and +get help testing. + +### 9. Finalize the bump branch + +When you're happy with the quality of a release candidate, you can move on and +create the real thing. + +You will first have to amend the "bump commit" to drop the release candidate +suffix in the VERSION file: + +```bash +echo $VERSION > VERSION +git add VERSION +git commit --amend +``` + +You will then repeat step 6 to publish the binaries to test + +### 10. Get 2 other maintainers to validate the pull request + +### 11. Publish final binaries + +Once they're tested and reasonably believed to be working, run against +get.docker.com: + +```bash +docker run \ + -e AWS_S3_BUCKET=get.docker.com \ + -e AWS_ACCESS_KEY="..." \ + -e AWS_SECRET_KEY="..." \ + -e GPG_PASSPHRASE="..." \ + -i -t --privileged \ + docker \ + hack/release.sh +``` + +### 12. Apply tag and create release + +It's very important that we don't make the tag until after the official +release is uploaded to get.docker.com! + +```bash +git tag -a $VERSION -m $VERSION bump_$VERSION +git push origin $VERSION +``` + +Once the tag is pushed, go to GitHub and create a [new release](https://github.com/docker/docker/releases/new). +If the tag is for an RC make sure you check `This is a pre-release` at the bottom of the form. + +Select the tag that you just pushed as the version and paste the changelog in the description of the release. +You can see examples in this two links: + +https://github.com/docker/docker/releases/tag/v1.8.0 +https://github.com/docker/docker/releases/tag/v1.8.0-rc3 + +### 13. Go to github to merge the `bump_$VERSION` branch into release + +Don't forget to push that pretty blue button to delete the leftover +branch afterwards! + +### 14. Update the docs branch + +You will need to point the docs branch to the newly created release tag: + +```bash +git checkout origin/docs +git reset --hard origin/$VERSION +git push -f origin docs +``` + +The docs will appear on https://docs.docker.com/ (though there may be cached +versions, so its worth checking http://docs.docker.com.s3-website-us-east-1.amazonaws.com/). +For more information about documentation releases, see `docs/README.md`. + +Note that the new docs will not appear live on the site until the cache (a complex, +distributed CDN system) is flushed. The `make docs-release` command will do this +_if_ the `DISTRIBUTION_ID` is set correctly - this will take at least 15 minutes to run +and you can check its progress with the CDN Cloudfront Chrome addon. + +### 15. Create a new pull request to merge your bump commit back into master + +```bash +git checkout master +git fetch +git reset --hard origin/master +git cherry-pick $VERSION +git push $GITHUBUSER merge_release_$VERSION +echo "https://github.com/$GITHUBUSER/docker/compare/docker:master...$GITHUBUSER:merge_release_$VERSION?expand=1" +``` + +Again, get two maintainers to validate, then merge, then push that pretty +blue button to delete your branch. + +### 16. Update the VERSION files + +Now that version X.Y.Z is out, time to start working on the next! Update the +content of the `VERSION` file to be the next minor (incrementing Y) and add the +`-dev` suffix. For example, after 1.5.0 release, the `VERSION` file gets +updated to `1.6.0-dev` (as in "1.6.0 in the making"). + +### 17. Rejoice and Evangelize! + +Congratulations! You're done. + +Go forth and announce the glad tidings of the new release in `#docker`, +`#docker-dev`, on the [dev mailing list](https://groups.google.com/forum/#!forum/docker-dev), +the [announce mailing list](https://groups.google.com/forum/#!forum/docker-announce), +and on Twitter! diff --git a/project/RELEASE-PROCESS.md b/project/RELEASE-PROCESS.md new file mode 100644 index 0000000000..d764e9d007 --- /dev/null +++ b/project/RELEASE-PROCESS.md @@ -0,0 +1,78 @@ +# Docker Release Process + +This document describes how the Docker project is released. The Docker project +release process targets the Engine, Compose, Kitematic, Machine, Swarm, +Distribution, Notary and their underlying dependencies (libnetwork, libkv, +etc...). + +Step-by-step technical details of the process are described in +[RELEASE-CHECKLIST.md](https://github.com/docker/docker/blob/master/project/RELEASE-CHECKLIST.md). + +## Release cycle + +The Docker project follows a **time-based release cycle** and ships every nine +weeks. A release cycle starts the same day the previous release cycle ends. + +The first six weeks of the cycle are dedicated to development and review. During +this phase, new features and bugfixes submitted to any of the projects are +**eligible** to be shipped as part of the next release. No changeset submitted +during this period is however guaranteed to be merged for the current release +cycle. + +## The freeze period + +Six weeks after the beginning of the cycle, the codebase is officially frozen +and the codebase reaches a state close to the final release. A Release Candidate +(RC) gets created at the same time. The freeze period is used to find bugs and +get feedback on the state of the RC before the release. + +During this freeze period, while the `master` branch will continue its normal +development cycle, no new features are accepted into the RC. As bugs are fixed +in `master` the release owner will selectively 'cherry-pick' critical ones to +be included into the RC. As the RC changes, new ones are made available for the +community to test and review. + +This period lasts for three weeks. + +## How to maximize chances of being merged before the freeze date? + +First of all, there is never a guarantee that a specific changeset is going to +be merged. However there are different actions to follow to maximize the chances +for a changeset to be merged: + +- The team gives priority to review the PRs aligned with the Roadmap (usually +defined by a ROADMAP.md file at the root of the repository). +- The earlier a PR is opened, the more time the maintainers have to review. For +example, if a PR is opened the day before the freeze date, it’s very unlikely +that it will be merged for the release. +- Constant communication with the maintainers (mailing-list, IRC, Github issues, +etc.) allows to get early feedback on the design before getting into the +implementation, which usually reduces the time needed to discuss a changeset. +- If the code is commented, fully tested and by extension follows every single +rules defined by the [CONTRIBUTING guide]( +https://github.com/docker/docker/blob/master/CONTRIBUTING.md), this will help +the maintainers by speeding up the review. + +## The release + +At the end of the freeze (nine weeks after the start of the cycle), all the +projects are released together. + +``` + Codebase Release +Start of is frozen (end of the +the Cycle (7th week) 9th week) ++---------------------------------------+---------------------+ +| | | +| Development phase | Freeze phase | +| | | ++---------------------------------------+---------------------+ + 6 weeks 3 weeks +<---------------------------------------><--------------------> +``` + +## Exceptions + +If a critical issue is found at the end of the freeze period and more time is +needed to address it, the release will be pushed back. When a release gets +pushed back, the next release cycle gets delayed as well. diff --git a/project/REVIEWING.md b/project/REVIEWING.md new file mode 100644 index 0000000000..5a1872252d --- /dev/null +++ b/project/REVIEWING.md @@ -0,0 +1,193 @@ +Pull request reviewing process +============================== + +# Labels + +Labels are carefully picked to optimize for: + + - Readability: maintainers must immediately know the state of a PR + - Filtering simplicity: different labels represent many different aspects of + the reviewing work, and can even be targeted at different maintainers groups. + +A pull request should only be attributed labels documented in this section: other labels that may +exist on the repository should apply to issues. + +## DCO labels + + * `dco/no`: automatically set by a bot when one of the commits lacks proper signature + +## Status labels + + * `status/0-triage` + * `status/1-design-review` + * `status/2-code-review` + * `status/3-docs-review` + * `status/4-ready-to-merge` + +Special status labels: + + * `status/needs-attention`: calls for a collective discussion during a review session + +## Specialty group labels + +Those labels are used to raise awareness of a particular specialty group, either because we need +help in reviewing the PR, or because of the potential impact of the PR on their work: + + * `group/distribution` + * `group/networking` + * `group/security` + * `group/windows` + +## Impact labels (apply to merged pull requests) + + * `impact/api` + * `impact/changelog` + * `impact/cli` + * `impact/dockerfile` + * `impact/deprecation` + +# Workflow + +An opened pull request can be in 1 of 5 distinct states, for each of which there is a corresponding +label that needs to be applied. + +## Triage - `status/0-triage` + +Maintainers are expected to triage new incoming pull requests by removing the `status/0-triage` +label and adding the correct labels (e.g. `status/1-design-review`) before any other interaction +with the PR. The starting label may potentially skip some steps depending on the kind of pull +request: use your best judgement. + +Maintainers should perform an initial, high-level, overview of the pull request before moving it to +the next appropriate stage: + + - Has DCO + - Contains sufficient justification (e.g., usecases) for the proposed change + - References the Github issue it fixes (if any) in the commit or the first Github comment + +Possible transitions from this state: + + * Close: e.g., unresponsive contributor without DCO + * `status/1-design-review`: general case + * `status/2-code-review`: e.g. trivial bugfix + * `status/3-docs-review`: non-proposal documentation-only change + +## Design review - `status/1-design-review` + +Maintainers are expected to comment on the design of the pull request. Review of documentation is +expected only in the context of design validation, not for stylistic changes. + +Ideally, documentation should reflect the expected behavior of the code. No code review should +take place in this step. + +There are no strict rules on the way a design is validated: we usually aim for a consensus, +although a single maintainer approval is often sufficient for obviously reasonable changes. In +general, strong disagreement expressed by any of the maintainers should not be taken lightly. + +Once design is approved, a maintainer should make sure to remove this label and add the next one. + +Possible transitions from this state: + + * Close: design rejected + * `status/2-code-review`: general case + * `status/3-docs-review`: proposals with only documentation changes + +## Code review - `status/2-code-review` + +Maintainers are expected to review the code and ensure that it is good quality and in accordance +with the documentation in the PR. + +New testcases are expected to be added. Ideally, those testcases should fail when the new code is +absent, and pass when present. The testcases should strive to test as many variants, code paths, as +possible to ensure maximum coverage. + +Changes to code must be reviewed and approved (LGTM'd) by a minimum of two code maintainers. When +the author of a PR is a maintainer, he still needs the approval of two other maintainers. + +Once code is approved according to the rules of the subsystem, a maintainer should make sure to +remove this label and add the next one. If documentation is absent but expected, maintainers should +ask for documentation and move to status `status/3-docs-review` for docs maintainer to follow. + +Possible transitions from this state: + + * Close + * `status/1-design-review`: new design concerns are raised + * `status/3-docs-review`: general case + * `status/4-ready-to-merge`: change not impacting documentation + +## Docs review - `status/3-docs-review` + +Maintainers are expected to review the documentation in its bigger context, ensuring consistency, +completeness, validity, and breadth of coverage across all existing and new documentation. + +They should ask for any editorial change that makes the documentation more consistent and easier to +understand. + +Changes and additions to docs must be reviewed and approved (LGTM'd) by a minimum of two docs +sub-project maintainers. If the docs change originates with a docs maintainer, only one additional +LGTM is required (since we assume a docs maintainer approves of their own PR). + +Once documentation is approved (see below), a maintainer should make sure to remove this label and +add the next one. + +Possible transitions from this state: + + * Close + * `status/1-design-review`: new design concerns are raised + * `status/2-code-review`: requires more code changes + * `status/4-ready-to-merge`: general case + +## Merge - `status/4-ready-to-merge` + +Maintainers are expected to merge this pull request as soon as possible. They can ask for a rebase +or carry the pull request themselves. + +Possible transitions from this state: + + * Merge: general case + * Close: carry PR + +After merging a pull request, the maintainer should consider applying one or multiple impact labels +to ease future classification: + + * `impact/api` signifies the patch impacted the remote API + * `impact/changelog` signifies the change is significant enough to make it in the changelog + * `impact/cli` signifies the patch impacted a CLI command + * `impact/dockerfile` signifies the patch impacted the Dockerfile syntax + * `impact/deprecation` signifies the patch participates in deprecating an existing feature + +## Close + +If a pull request is closed it is expected that sufficient justification will be provided. In +particular, if there are alternative ways of achieving the same net result then those needs to be +spelled out. If the pull request is trying to solve a use case that is not one that we (as a +community) want to support then a justification for why should be provided. + +The number of maintainers it takes to decide and close a PR is deliberately left unspecified. We +assume that the group of maintainers is bound by mutual trust and respect, and that opposition from +any single maintainer should be taken into consideration. Similarly, we expect maintainers to +justify their reasoning and to accept debating. + +# Escalation process + +Despite the previously described reviewing process, some PR might not show any progress for various +reasons: + + - No strong opinion for or against the proposed patch + - Debates about the proper way to solve the problem at hand + - Lack of consensus + - ... + +All these will eventually lead to stalled PR, where no apparent progress is made across several +weeks, or even months. + +Maintainers should use their best judgement and apply the `status/needs-attention` label. It must +be used sparingly, as each PR with such label will be discussed by a group of maintainers during a +review session. The goal of that session is to agree on one of the following outcomes for the PR: + + * Close, explaining the rationale for not pursuing further + * Continue, either by pushing the PR further in the workflow, or by deciding to carry the patch + (ideally, a maintainer should be immediately assigned to make sure that the PR keeps continued + attention) + * Escalate to Solomon by formulating a few specific questions on which his answers will allow + maintainers to decide. diff --git a/project/TOOLS.md b/project/TOOLS.md new file mode 100644 index 0000000000..6e19606ed1 --- /dev/null +++ b/project/TOOLS.md @@ -0,0 +1,74 @@ +# Tools + +This page describes the tools we use and infrastructure that is in place for +the Docker project. + +### CI + +The Docker project uses [Jenkins](https://jenkins.dockerproject.org/) as our +continuous integration server. Each Pull Request to Docker is tested by running the +equivalent of `make all`. We chose Jenkins because we can host it ourselves and +we run Docker in Docker to test. + +#### Leeroy + +Leeroy is a Go application which integrates Jenkins with +GitHub pull requests. Leeroy uses +[GitHub hooks](https://developer.github.com/v3/repos/hooks/) +to listen for pull request notifications and starts jobs on your Jenkins +server. Using the Jenkins [notification plugin][jnp], Leeroy updates the +pull request using GitHub's +[status API](https://developer.github.com/v3/repos/statuses/) +with pending, success, failure, or error statuses. + +The leeroy repository is maintained at +[github.com/docker/leeroy](https://github.com/docker/leeroy). + +#### GordonTheTurtle IRC Bot + +The GordonTheTurtle IRC Bot lives in the +[#docker-maintainers](https://botbot.me/freenode/docker-maintainers/) channel +on Freenode. He is built in Go and is based off the project at +[github.com/fabioxgn/go-bot](https://github.com/fabioxgn/go-bot). + +His main command is `!rebuild`, which rebuilds a given Pull Request for a repository. +This command works by integrating with Leroy. He has a few other commands too, such +as `!gif` or `!godoc`, but we are always looking for more fun commands to add. + +The gordon-bot repository is maintained at +[github.com/jfrazelle/gordon-bot](https://github.com/jfrazelle/gordon-bot) + +### NSQ + +We use [NSQ](https://github.com/bitly/nsq) for various aspects of the project +infrastucture. + +#### Hooks + +The hooks project, +[github.com/crosbymichael/hooks](https://github.com/crosbymichael/hooks), +is a small Go application that manages web hooks from github, hub.docker.com, or +other third party services. + +It can be used for listening to github webhooks & pushing them to a queue, +archiving hooks to rethinkdb for processing, and broadcasting hooks to various +jobs. + +#### Docker Master Binaries + +One of the things queued from the Hooks are the building of the Master +Binaries. This happens on every push to the master branch of Docker. The +repository for this is maintained at +[github.com/jfrazelle/docker-bb](https://github.com/jfrazelle/docker-bb). + +#### Docker Master Docs + +The master build of the docs gets queued from the Hooks as well. They are built +using [github.com/jfrazelle/nsqexec](https://github.com/jfrazelle/nsqexec). + +#### Patch Parser Bot + +The bot, also named GordonTheTurtle, that labels and comments on Pull Requests +listens on Hooks as well. He is capable of knowing if a Pull Request needs to +be signed, or gofmt'd, as well as rebased. The repository for this is maintained at +[github.com/jfrazelle/gh-patch-parser](https://github.com/jfrazelle/gh-patch-parser). diff --git a/project/make/validate-toml b/project/make/validate-toml new file mode 100644 index 0000000000..46ece77980 --- /dev/null +++ b/project/make/validate-toml @@ -0,0 +1,30 @@ +#!/bin/bash + +source "$(dirname "$BASH_SOURCE")/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- 'MAINTAINERS' || true) ) +unset IFS + +badFiles=() +for f in "${files[@]}"; do + # we use "git show" here to validate that what's committed is formatted + if [ "$(git show "$VALIDATE_HEAD:$f" | tomlv)" ]; then + badFiles+=( "$f" ) + fi +done + +if [ ${#badFiles[@]} -eq 0 ]; then + echo 'Congratulations! All toml source files have valid syntax.' +else + { + echo "These files are not valid toml:" + for f in "${badFiles[@]}"; do + echo " - $f" + done + echo + echo 'Please reformat the above files as valid toml' + echo + } >&2 + false +fi diff --git a/registry/auth.go b/registry/auth.go new file mode 100644 index 0000000000..243772214f --- /dev/null +++ b/registry/auth.go @@ -0,0 +1,255 @@ +package registry + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "net/http" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/cliconfig" +) + +// Login tries to register/login to the registry server. +func Login(authConfig *cliconfig.AuthConfig, registryEndpoint *Endpoint) (string, error) { + // Separates the v2 registry login logic from the v1 logic. + if registryEndpoint.Version == APIVersion2 { + return loginV2(authConfig, registryEndpoint, "" /* scope */) + } + return loginV1(authConfig, registryEndpoint) +} + +// loginV1 tries to register/login to the v1 registry server. +func loginV1(authConfig *cliconfig.AuthConfig, registryEndpoint *Endpoint) (string, error) { + var ( + status string + reqBody []byte + err error + reqStatusCode = 0 + serverAddress = authConfig.ServerAddress + ) + + logrus.Debugf("attempting v1 login to registry endpoint %s", registryEndpoint) + + if serverAddress == "" { + return "", fmt.Errorf("Server Error: Server Address not set.") + } + + loginAgainstOfficialIndex := serverAddress == IndexServer + + // to avoid sending the server address to the server it should be removed before being marshalled + authCopy := *authConfig + authCopy.ServerAddress = "" + + jsonBody, err := json.Marshal(authCopy) + if err != nil { + return "", fmt.Errorf("Config Error: %s", err) + } + + // using `bytes.NewReader(jsonBody)` here causes the server to respond with a 411 status. + b := strings.NewReader(string(jsonBody)) + req1, err := registryEndpoint.client.Post(serverAddress+"users/", "application/json; charset=utf-8", b) + if err != nil { + return "", fmt.Errorf("Server Error: %s", err) + } + reqStatusCode = req1.StatusCode + defer req1.Body.Close() + reqBody, err = ioutil.ReadAll(req1.Body) + if err != nil { + return "", fmt.Errorf("Server Error: [%#v] %s", reqStatusCode, err) + } + + if reqStatusCode == 201 { + if loginAgainstOfficialIndex { + status = "Account created. Please use the confirmation link we sent" + + " to your e-mail to activate it." + } else { + // *TODO: Use registry configuration to determine what this says, if anything? + status = "Account created. Please see the documentation of the registry " + serverAddress + " for instructions how to activate it." + } + } else if reqStatusCode == 400 { + if string(reqBody) == "\"Username or email already exists\"" { + req, err := http.NewRequest("GET", serverAddress+"users/", nil) + req.SetBasicAuth(authConfig.Username, authConfig.Password) + resp, err := registryEndpoint.client.Do(req) + if err != nil { + return "", err + } + defer resp.Body.Close() + body, err := ioutil.ReadAll(resp.Body) + if err != nil { + return "", err + } + if resp.StatusCode == 200 { + return "Login Succeeded", nil + } else if resp.StatusCode == 401 { + return "", fmt.Errorf("Wrong login/password, please try again") + } else if resp.StatusCode == 403 { + if loginAgainstOfficialIndex { + return "", fmt.Errorf("Login: Account is not Active. Please check your e-mail for a confirmation link.") + } + // *TODO: Use registry configuration to determine what this says, if anything? + return "", fmt.Errorf("Login: Account is not Active. Please see the documentation of the registry %s for instructions how to activate it.", serverAddress) + } else if resp.StatusCode == 500 { // Issue #14326 + logrus.Errorf("%s returned status code %d. Response Body :\n%s", req.URL.String(), resp.StatusCode, body) + return "", fmt.Errorf("Internal Server Error") + } + return "", fmt.Errorf("Login: %s (Code: %d; Headers: %s)", body, resp.StatusCode, resp.Header) + } + return "", fmt.Errorf("Registration: %s", reqBody) + + } else if reqStatusCode == 401 { + // This case would happen with private registries where /v1/users is + // protected, so people can use `docker login` as an auth check. + req, err := http.NewRequest("GET", serverAddress+"users/", nil) + req.SetBasicAuth(authConfig.Username, authConfig.Password) + resp, err := registryEndpoint.client.Do(req) + if err != nil { + return "", err + } + defer resp.Body.Close() + body, err := ioutil.ReadAll(resp.Body) + if err != nil { + return "", err + } + if resp.StatusCode == 200 { + return "Login Succeeded", nil + } else if resp.StatusCode == 401 { + return "", fmt.Errorf("Wrong login/password, please try again") + } else { + return "", fmt.Errorf("Login: %s (Code: %d; Headers: %s)", body, + resp.StatusCode, resp.Header) + } + } else { + return "", fmt.Errorf("Unexpected status code [%d] : %s", reqStatusCode, reqBody) + } + return status, nil +} + +// loginV2 tries to login to the v2 registry server. The given registry endpoint has been +// pinged or setup with a list of authorization challenges. Each of these challenges are +// tried until one of them succeeds. Currently supported challenge schemes are: +// HTTP Basic Authorization +// Token Authorization with a separate token issuing server +// NOTE: the v2 logic does not attempt to create a user account if one doesn't exist. For +// now, users should create their account through other means like directly from a web page +// served by the v2 registry service provider. Whether this will be supported in the future +// is to be determined. +func loginV2(authConfig *cliconfig.AuthConfig, registryEndpoint *Endpoint, scope string) (string, error) { + logrus.Debugf("attempting v2 login to registry endpoint %s", registryEndpoint) + var ( + err error + allErrors []error + client = registryEndpoint.HTTPClient() + ) + + for _, challenge := range registryEndpoint.AuthChallenges { + params := make(map[string]string, len(challenge.Parameters)+1) + for k, v := range challenge.Parameters { + params[k] = v + } + params["scope"] = scope + logrus.Debugf("trying %q auth challenge with params %v", challenge.Scheme, params) + + switch strings.ToLower(challenge.Scheme) { + case "basic": + err = tryV2BasicAuthLogin(authConfig, params, registryEndpoint) + case "bearer": + err = tryV2TokenAuthLogin(authConfig, params, registryEndpoint) + default: + // Unsupported challenge types are explicitly skipped. + err = fmt.Errorf("unsupported auth scheme: %q", challenge.Scheme) + } + + if err == nil { + return "Login Succeeded", nil + } + + logrus.Debugf("error trying auth challenge %q: %s", challenge.Scheme, err) + + allErrors = append(allErrors, err) + } + + return "", fmt.Errorf("no successful auth challenge for %s - errors: %s", registryEndpoint, allErrors) +} + +func tryV2BasicAuthLogin(authConfig *cliconfig.AuthConfig, params map[string]string, registryEndpoint *Endpoint) error { + req, err := http.NewRequest("GET", registryEndpoint.Path(""), nil) + if err != nil { + return err + } + + req.SetBasicAuth(authConfig.Username, authConfig.Password) + + resp, err := registryEndpoint.client.Do(req) + if err != nil { + return err + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return fmt.Errorf("basic auth attempt to %s realm %q failed with status: %d %s", registryEndpoint, params["realm"], resp.StatusCode, http.StatusText(resp.StatusCode)) + } + + return nil +} + +func tryV2TokenAuthLogin(authConfig *cliconfig.AuthConfig, params map[string]string, registryEndpoint *Endpoint) error { + token, err := getToken(authConfig.Username, authConfig.Password, params, registryEndpoint) + if err != nil { + return err + } + + req, err := http.NewRequest("GET", registryEndpoint.Path(""), nil) + if err != nil { + return err + } + + req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", token)) + + resp, err := registryEndpoint.client.Do(req) + if err != nil { + return err + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return fmt.Errorf("token auth attempt to %s realm %q failed with status: %d %s", registryEndpoint, params["realm"], resp.StatusCode, http.StatusText(resp.StatusCode)) + } + + return nil +} + +// ResolveAuthConfig matches an auth configuration to a server address or a URL +func ResolveAuthConfig(config *cliconfig.ConfigFile, index *IndexInfo) cliconfig.AuthConfig { + configKey := index.GetAuthConfigKey() + // First try the happy case + if c, found := config.AuthConfigs[configKey]; found || index.Official { + return c + } + + convertToHostname := func(url string) string { + stripped := url + if strings.HasPrefix(url, "http://") { + stripped = strings.Replace(url, "http://", "", 1) + } else if strings.HasPrefix(url, "https://") { + stripped = strings.Replace(url, "https://", "", 1) + } + + nameParts := strings.SplitN(stripped, "/", 2) + + return nameParts[0] + } + + // Maybe they have a legacy config file, we will iterate the keys converting + // them to the new format and testing + for registry, ac := range config.AuthConfigs { + if configKey == convertToHostname(registry) { + return ac + } + } + + // When all else fails, return an empty auth config + return cliconfig.AuthConfig{} +} diff --git a/registry/auth_test.go b/registry/auth_test.go new file mode 100644 index 0000000000..a8e3da016b --- /dev/null +++ b/registry/auth_test.go @@ -0,0 +1,173 @@ +package registry + +import ( + "io/ioutil" + "os" + "path/filepath" + "testing" + + "github.com/docker/docker/cliconfig" +) + +func TestEncodeAuth(t *testing.T) { + newAuthConfig := &cliconfig.AuthConfig{Username: "ken", Password: "test", Email: "test@example.com"} + authStr := cliconfig.EncodeAuth(newAuthConfig) + decAuthConfig := &cliconfig.AuthConfig{} + var err error + decAuthConfig.Username, decAuthConfig.Password, err = cliconfig.DecodeAuth(authStr) + if err != nil { + t.Fatal(err) + } + if newAuthConfig.Username != decAuthConfig.Username { + t.Fatal("Encode Username doesn't match decoded Username") + } + if newAuthConfig.Password != decAuthConfig.Password { + t.Fatal("Encode Password doesn't match decoded Password") + } + if authStr != "a2VuOnRlc3Q=" { + t.Fatal("AuthString encoding isn't correct.") + } +} + +func setupTempConfigFile() (*cliconfig.ConfigFile, error) { + root, err := ioutil.TempDir("", "docker-test-auth") + if err != nil { + return nil, err + } + root = filepath.Join(root, cliconfig.ConfigFileName) + configFile := cliconfig.NewConfigFile(root) + + for _, registry := range []string{"testIndex", IndexServer} { + configFile.AuthConfigs[registry] = cliconfig.AuthConfig{ + Username: "docker-user", + Password: "docker-pass", + Email: "docker@docker.io", + } + } + + return configFile, nil +} + +func TestSameAuthDataPostSave(t *testing.T) { + configFile, err := setupTempConfigFile() + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(configFile.Filename()) + + err = configFile.Save() + if err != nil { + t.Fatal(err) + } + + authConfig := configFile.AuthConfigs["testIndex"] + if authConfig.Username != "docker-user" { + t.Fail() + } + if authConfig.Password != "docker-pass" { + t.Fail() + } + if authConfig.Email != "docker@docker.io" { + t.Fail() + } + if authConfig.Auth != "" { + t.Fail() + } +} + +func TestResolveAuthConfigIndexServer(t *testing.T) { + configFile, err := setupTempConfigFile() + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(configFile.Filename()) + + indexConfig := configFile.AuthConfigs[IndexServer] + + officialIndex := &IndexInfo{ + Official: true, + } + privateIndex := &IndexInfo{ + Official: false, + } + + resolved := ResolveAuthConfig(configFile, officialIndex) + assertEqual(t, resolved, indexConfig, "Expected ResolveAuthConfig to return IndexServer") + + resolved = ResolveAuthConfig(configFile, privateIndex) + assertNotEqual(t, resolved, indexConfig, "Expected ResolveAuthConfig to not return IndexServer") +} + +func TestResolveAuthConfigFullURL(t *testing.T) { + configFile, err := setupTempConfigFile() + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(configFile.Filename()) + + registryAuth := cliconfig.AuthConfig{ + Username: "foo-user", + Password: "foo-pass", + Email: "foo@example.com", + } + localAuth := cliconfig.AuthConfig{ + Username: "bar-user", + Password: "bar-pass", + Email: "bar@example.com", + } + officialAuth := cliconfig.AuthConfig{ + Username: "baz-user", + Password: "baz-pass", + Email: "baz@example.com", + } + configFile.AuthConfigs[IndexServer] = officialAuth + + expectedAuths := map[string]cliconfig.AuthConfig{ + "registry.example.com": registryAuth, + "localhost:8000": localAuth, + "registry.com": localAuth, + } + + validRegistries := map[string][]string{ + "registry.example.com": { + "https://registry.example.com/v1/", + "http://registry.example.com/v1/", + "registry.example.com", + "registry.example.com/v1/", + }, + "localhost:8000": { + "https://localhost:8000/v1/", + "http://localhost:8000/v1/", + "localhost:8000", + "localhost:8000/v1/", + }, + "registry.com": { + "https://registry.com/v1/", + "http://registry.com/v1/", + "registry.com", + "registry.com/v1/", + }, + } + + for configKey, registries := range validRegistries { + configured, ok := expectedAuths[configKey] + if !ok || configured.Email == "" { + t.Fail() + } + index := &IndexInfo{ + Name: configKey, + } + for _, registry := range registries { + configFile.AuthConfigs[registry] = configured + resolved := ResolveAuthConfig(configFile, index) + if resolved.Email != configured.Email { + t.Errorf("%s -> %q != %q\n", registry, resolved.Email, configured.Email) + } + delete(configFile.AuthConfigs, registry) + resolved = ResolveAuthConfig(configFile, index) + if resolved.Email == configured.Email { + t.Errorf("%s -> %q == %q\n", registry, resolved.Email, configured.Email) + } + } + } +} diff --git a/registry/authchallenge.go b/registry/authchallenge.go new file mode 100644 index 0000000000..e300d82a05 --- /dev/null +++ b/registry/authchallenge.go @@ -0,0 +1,150 @@ +package registry + +import ( + "net/http" + "strings" +) + +// Octet types from RFC 2616. +type octetType byte + +// AuthorizationChallenge carries information +// from a WWW-Authenticate response header. +type AuthorizationChallenge struct { + Scheme string + Parameters map[string]string +} + +var octetTypes [256]octetType + +const ( + isToken octetType = 1 << iota + isSpace +) + +func init() { + // OCTET = + // CHAR = + // CTL = + // CR = + // LF = + // SP = + // HT = + // <"> = + // CRLF = CR LF + // LWS = [CRLF] 1*( SP | HT ) + // TEXT = + // separators = "(" | ")" | "<" | ">" | "@" | "," | ";" | ":" | "\" | <"> + // | "/" | "[" | "]" | "?" | "=" | "{" | "}" | SP | HT + // token = 1* + // qdtext = > + + for c := 0; c < 256; c++ { + var t octetType + isCtl := c <= 31 || c == 127 + isChar := 0 <= c && c <= 127 + isSeparator := strings.IndexRune(" \t\"(),/:;<=>?@[]\\{}", rune(c)) >= 0 + if strings.IndexRune(" \t\r\n", rune(c)) >= 0 { + t |= isSpace + } + if isChar && !isCtl && !isSeparator { + t |= isToken + } + octetTypes[c] = t + } +} + +func parseAuthHeader(header http.Header) []*AuthorizationChallenge { + var challenges []*AuthorizationChallenge + for _, h := range header[http.CanonicalHeaderKey("WWW-Authenticate")] { + v, p := parseValueAndParams(h) + if v != "" { + challenges = append(challenges, &AuthorizationChallenge{Scheme: v, Parameters: p}) + } + } + return challenges +} + +func parseValueAndParams(header string) (value string, params map[string]string) { + params = make(map[string]string) + value, s := expectToken(header) + if value == "" { + return + } + value = strings.ToLower(value) + s = "," + skipSpace(s) + for strings.HasPrefix(s, ",") { + var pkey string + pkey, s = expectToken(skipSpace(s[1:])) + if pkey == "" { + return + } + if !strings.HasPrefix(s, "=") { + return + } + var pvalue string + pvalue, s = expectTokenOrQuoted(s[1:]) + if pvalue == "" { + return + } + pkey = strings.ToLower(pkey) + params[pkey] = pvalue + s = skipSpace(s) + } + return +} + +func skipSpace(s string) (rest string) { + i := 0 + for ; i < len(s); i++ { + if octetTypes[s[i]]&isSpace == 0 { + break + } + } + return s[i:] +} + +func expectToken(s string) (token, rest string) { + i := 0 + for ; i < len(s); i++ { + if octetTypes[s[i]]&isToken == 0 { + break + } + } + return s[:i], s[i:] +} + +func expectTokenOrQuoted(s string) (value string, rest string) { + if !strings.HasPrefix(s, "\"") { + return expectToken(s) + } + s = s[1:] + for i := 0; i < len(s); i++ { + switch s[i] { + case '"': + return s[:i], s[i+1:] + case '\\': + p := make([]byte, len(s)-1) + j := copy(p, s[:i]) + escape := true + for i = i + i; i < len(s); i++ { + b := s[i] + switch { + case escape: + escape = false + p[j] = b + j++ + case b == '\\': + escape = true + case b == '"': + return string(p[:j]), s[i+1:] + default: + p[j] = b + j++ + } + } + return "", "" + } + } + return "", "" +} diff --git a/registry/config.go b/registry/config.go new file mode 100644 index 0000000000..2fee4400b9 --- /dev/null +++ b/registry/config.go @@ -0,0 +1,416 @@ +package registry + +import ( + "encoding/json" + "errors" + "fmt" + "net" + "net/url" + "strings" + + "github.com/docker/distribution/registry/api/v2" + "github.com/docker/docker/image" + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" +) + +// Options holds command line options. +type Options struct { + Mirrors opts.ListOpts + InsecureRegistries opts.ListOpts +} + +const ( + // DefaultNamespace is the default namespace + DefaultNamespace = "docker.io" + // DefaultRegistryVersionHeader is the name of the default HTTP header + // that carries Registry version info + DefaultRegistryVersionHeader = "Docker-Distribution-Api-Version" + + // IndexServer is the v1 registry server used for user auth + account creation + IndexServer = DefaultV1Registry + "/v1/" + // IndexName is the name of the index + IndexName = "docker.io" + + // NotaryServer is the endpoint serving the Notary trust server + NotaryServer = "https://notary.docker.io" + + // IndexServer = "https://registry-stage.hub.docker.com/v1/" +) + +var ( + // ErrInvalidRepositoryName is an error returned if the repository name did + // not have the correct form + ErrInvalidRepositoryName = errors.New("Invalid repository name (ex: \"registry.domain.tld/myrepos\")") + + emptyServiceConfig = NewServiceConfig(nil) + + // V2Only controls access to legacy registries. If it is set to true via the + // command line flag the daemon will not attempt to contact v1 legacy registries + V2Only = false +) + +// InstallFlags adds command-line options to the top-level flag parser for +// the current process. +func (options *Options) InstallFlags(cmd *flag.FlagSet, usageFn func(string) string) { + options.Mirrors = opts.NewListOpts(ValidateMirror) + cmd.Var(&options.Mirrors, []string{"-registry-mirror"}, usageFn("Preferred Docker registry mirror")) + options.InsecureRegistries = opts.NewListOpts(ValidateIndexName) + cmd.Var(&options.InsecureRegistries, []string{"-insecure-registry"}, usageFn("Enable insecure registry communication")) + cmd.BoolVar(&V2Only, []string{"-disable-legacy-registry"}, false, "Do not contact legacy registries") +} + +type netIPNet net.IPNet + +func (ipnet *netIPNet) MarshalJSON() ([]byte, error) { + return json.Marshal((*net.IPNet)(ipnet).String()) +} + +func (ipnet *netIPNet) UnmarshalJSON(b []byte) (err error) { + var ipnetStr string + if err = json.Unmarshal(b, &ipnetStr); err == nil { + var cidr *net.IPNet + if _, cidr, err = net.ParseCIDR(ipnetStr); err == nil { + *ipnet = netIPNet(*cidr) + } + } + return +} + +// ServiceConfig stores daemon registry services configuration. +type ServiceConfig struct { + InsecureRegistryCIDRs []*netIPNet `json:"InsecureRegistryCIDRs"` + IndexConfigs map[string]*IndexInfo `json:"IndexConfigs"` + Mirrors []string +} + +// NewServiceConfig returns a new instance of ServiceConfig +func NewServiceConfig(options *Options) *ServiceConfig { + if options == nil { + options = &Options{ + Mirrors: opts.NewListOpts(nil), + InsecureRegistries: opts.NewListOpts(nil), + } + } + + // Localhost is by default considered as an insecure registry + // This is a stop-gap for people who are running a private registry on localhost (especially on Boot2docker). + // + // TODO: should we deprecate this once it is easier for people to set up a TLS registry or change + // daemon flags on boot2docker? + options.InsecureRegistries.Set("127.0.0.0/8") + + config := &ServiceConfig{ + InsecureRegistryCIDRs: make([]*netIPNet, 0), + IndexConfigs: make(map[string]*IndexInfo, 0), + // Hack: Bypass setting the mirrors to IndexConfigs since they are going away + // and Mirrors are only for the official registry anyways. + Mirrors: options.Mirrors.GetAll(), + } + // Split --insecure-registry into CIDR and registry-specific settings. + for _, r := range options.InsecureRegistries.GetAll() { + // Check if CIDR was passed to --insecure-registry + _, ipnet, err := net.ParseCIDR(r) + if err == nil { + // Valid CIDR. + config.InsecureRegistryCIDRs = append(config.InsecureRegistryCIDRs, (*netIPNet)(ipnet)) + } else { + // Assume `host:port` if not CIDR. + config.IndexConfigs[r] = &IndexInfo{ + Name: r, + Mirrors: make([]string, 0), + Secure: false, + Official: false, + } + } + } + + // Configure public registry. + config.IndexConfigs[IndexName] = &IndexInfo{ + Name: IndexName, + Mirrors: config.Mirrors, + Secure: true, + Official: true, + } + + return config +} + +// isSecureIndex returns false if the provided indexName is part of the list of insecure registries +// Insecure registries accept HTTP and/or accept HTTPS with certificates from unknown CAs. +// +// The list of insecure registries can contain an element with CIDR notation to specify a whole subnet. +// If the subnet contains one of the IPs of the registry specified by indexName, the latter is considered +// insecure. +// +// indexName should be a URL.Host (`host:port` or `host`) where the `host` part can be either a domain name +// or an IP address. If it is a domain name, then it will be resolved in order to check if the IP is contained +// in a subnet. If the resolving is not successful, isSecureIndex will only try to match hostname to any element +// of insecureRegistries. +func (config *ServiceConfig) isSecureIndex(indexName string) bool { + // Check for configured index, first. This is needed in case isSecureIndex + // is called from anything besides NewIndexInfo, in order to honor per-index configurations. + if index, ok := config.IndexConfigs[indexName]; ok { + return index.Secure + } + + host, _, err := net.SplitHostPort(indexName) + if err != nil { + // assume indexName is of the form `host` without the port and go on. + host = indexName + } + + addrs, err := lookupIP(host) + if err != nil { + ip := net.ParseIP(host) + if ip != nil { + addrs = []net.IP{ip} + } + + // if ip == nil, then `host` is neither an IP nor it could be looked up, + // either because the index is unreachable, or because the index is behind an HTTP proxy. + // So, len(addrs) == 0 and we're not aborting. + } + + // Try CIDR notation only if addrs has any elements, i.e. if `host`'s IP could be determined. + for _, addr := range addrs { + for _, ipnet := range config.InsecureRegistryCIDRs { + // check if the addr falls in the subnet + if (*net.IPNet)(ipnet).Contains(addr) { + return false + } + } + } + + return true +} + +// ValidateMirror validates an HTTP(S) registry mirror +func ValidateMirror(val string) (string, error) { + uri, err := url.Parse(val) + if err != nil { + return "", fmt.Errorf("%s is not a valid URI", val) + } + + if uri.Scheme != "http" && uri.Scheme != "https" { + return "", fmt.Errorf("Unsupported scheme %s", uri.Scheme) + } + + if uri.Path != "" || uri.RawQuery != "" || uri.Fragment != "" { + return "", fmt.Errorf("Unsupported path/query/fragment at end of the URI") + } + + return fmt.Sprintf("%s://%s/", uri.Scheme, uri.Host), nil +} + +// ValidateIndexName validates an index name. +func ValidateIndexName(val string) (string, error) { + // 'index.docker.io' => 'docker.io' + if val == "index."+IndexName { + val = IndexName + } + if strings.HasPrefix(val, "-") || strings.HasSuffix(val, "-") { + return "", fmt.Errorf("Invalid index name (%s). Cannot begin or end with a hyphen.", val) + } + // *TODO: Check if valid hostname[:port]/ip[:port]? + return val, nil +} + +func validateRemoteName(remoteName string) error { + + if !strings.Contains(remoteName, "/") { + + // the repository name must not be a valid image ID + if err := image.ValidateID(remoteName); err == nil { + return fmt.Errorf("Invalid repository name (%s), cannot specify 64-byte hexadecimal strings", remoteName) + } + } + + return v2.ValidateRepositoryName(remoteName) +} + +func validateNoSchema(reposName string) error { + if strings.Contains(reposName, "://") { + // It cannot contain a scheme! + return ErrInvalidRepositoryName + } + return nil +} + +// ValidateRepositoryName validates a repository name +func ValidateRepositoryName(reposName string) error { + _, _, err := loadRepositoryName(reposName, true) + return err +} + +// loadRepositoryName returns the repo name splitted into index name +// and remote repo name. It returns an error if the name is not valid. +func loadRepositoryName(reposName string, checkRemoteName bool) (string, string, error) { + if err := validateNoSchema(reposName); err != nil { + return "", "", err + } + indexName, remoteName := splitReposName(reposName) + + var err error + if indexName, err = ValidateIndexName(indexName); err != nil { + return "", "", err + } + if checkRemoteName { + if err = validateRemoteName(remoteName); err != nil { + return "", "", err + } + } + return indexName, remoteName, nil +} + +// NewIndexInfo returns IndexInfo configuration from indexName +func (config *ServiceConfig) NewIndexInfo(indexName string) (*IndexInfo, error) { + var err error + indexName, err = ValidateIndexName(indexName) + if err != nil { + return nil, err + } + + // Return any configured index info, first. + if index, ok := config.IndexConfigs[indexName]; ok { + return index, nil + } + + // Construct a non-configured index info. + index := &IndexInfo{ + Name: indexName, + Mirrors: make([]string, 0), + Official: false, + } + index.Secure = config.isSecureIndex(indexName) + return index, nil +} + +// GetAuthConfigKey special-cases using the full index address of the official +// index as the AuthConfig key, and uses the (host)name[:port] for private indexes. +func (index *IndexInfo) GetAuthConfigKey() string { + if index.Official { + return IndexServer + } + return index.Name +} + +// splitReposName breaks a reposName into an index name and remote name +func splitReposName(reposName string) (string, string) { + nameParts := strings.SplitN(reposName, "/", 2) + var indexName, remoteName string + if len(nameParts) == 1 || (!strings.Contains(nameParts[0], ".") && + !strings.Contains(nameParts[0], ":") && nameParts[0] != "localhost") { + // This is a Docker Index repos (ex: samalba/hipache or ubuntu) + // 'docker.io' + indexName = IndexName + remoteName = reposName + } else { + indexName = nameParts[0] + remoteName = nameParts[1] + } + return indexName, remoteName +} + +// NewRepositoryInfo validates and breaks down a repository name into a RepositoryInfo +func (config *ServiceConfig) NewRepositoryInfo(reposName string, bySearch bool) (*RepositoryInfo, error) { + indexName, remoteName, err := loadRepositoryName(reposName, !bySearch) + if err != nil { + return nil, err + } + + repoInfo := &RepositoryInfo{ + RemoteName: remoteName, + } + + repoInfo.Index, err = config.NewIndexInfo(indexName) + if err != nil { + return nil, err + } + + if repoInfo.Index.Official { + normalizedName := normalizeLibraryRepoName(repoInfo.RemoteName) + + repoInfo.LocalName = normalizedName + repoInfo.RemoteName = normalizedName + // If the normalized name does not contain a '/' (e.g. "foo") + // then it is an official repo. + if strings.IndexRune(normalizedName, '/') == -1 { + repoInfo.Official = true + // Fix up remote name for official repos. + repoInfo.RemoteName = "library/" + normalizedName + } + + repoInfo.CanonicalName = "docker.io/" + repoInfo.RemoteName + } else { + repoInfo.LocalName = localNameFromRemote(repoInfo.Index.Name, repoInfo.RemoteName) + repoInfo.CanonicalName = repoInfo.LocalName + + } + + return repoInfo, nil +} + +// GetSearchTerm special-cases using local name for official index, and +// remote name for private indexes. +func (repoInfo *RepositoryInfo) GetSearchTerm() string { + if repoInfo.Index.Official { + return repoInfo.LocalName + } + return repoInfo.RemoteName +} + +// ParseRepositoryInfo performs the breakdown of a repository name into a RepositoryInfo, but +// lacks registry configuration. +func ParseRepositoryInfo(reposName string) (*RepositoryInfo, error) { + return emptyServiceConfig.NewRepositoryInfo(reposName, false) +} + +// ParseIndexInfo will use repository name to get back an indexInfo. +func ParseIndexInfo(reposName string) (*IndexInfo, error) { + indexName, _ := splitReposName(reposName) + + indexInfo, err := emptyServiceConfig.NewIndexInfo(indexName) + if err != nil { + return nil, err + } + return indexInfo, nil +} + +// NormalizeLocalName transforms a repository name into a normalize LocalName +// Passes through the name without transformation on error (image id, etc) +// It does not use the repository info because we don't want to load +// the repository index and do request over the network. +func NormalizeLocalName(name string) string { + indexName, remoteName, err := loadRepositoryName(name, true) + if err != nil { + return name + } + + var officialIndex bool + // Return any configured index info, first. + if index, ok := emptyServiceConfig.IndexConfigs[indexName]; ok { + officialIndex = index.Official + } + + if officialIndex { + return normalizeLibraryRepoName(remoteName) + } + return localNameFromRemote(indexName, remoteName) +} + +// normalizeLibraryRepoName removes the library prefix from +// the repository name for official repos. +func normalizeLibraryRepoName(name string) string { + if strings.HasPrefix(name, "library/") { + // If pull "library/foo", it's stored locally under "foo" + name = strings.SplitN(name, "/", 2)[1] + } + return name +} + +// localNameFromRemote combines the index name and the repo remote name +// to generate a repo local name. +func localNameFromRemote(indexName, remoteName string) string { + return indexName + "/" + remoteName +} diff --git a/registry/config_test.go b/registry/config_test.go new file mode 100644 index 0000000000..25578a7f2b --- /dev/null +++ b/registry/config_test.go @@ -0,0 +1,49 @@ +package registry + +import ( + "testing" +) + +func TestValidateMirror(t *testing.T) { + valid := []string{ + "http://mirror-1.com", + "https://mirror-1.com", + "http://localhost", + "https://localhost", + "http://localhost:5000", + "https://localhost:5000", + "http://127.0.0.1", + "https://127.0.0.1", + "http://127.0.0.1:5000", + "https://127.0.0.1:5000", + } + + invalid := []string{ + "!invalid!://%as%", + "ftp://mirror-1.com", + "http://mirror-1.com/", + "http://mirror-1.com/?q=foo", + "http://mirror-1.com/v1/", + "http://mirror-1.com/v1/?q=foo", + "http://mirror-1.com/v1/?q=foo#frag", + "http://mirror-1.com?q=foo", + "https://mirror-1.com#frag", + "https://mirror-1.com/", + "https://mirror-1.com/#frag", + "https://mirror-1.com/v1/", + "https://mirror-1.com/v1/#", + "https://mirror-1.com?q", + } + + for _, address := range valid { + if ret, err := ValidateMirror(address); err != nil || ret == "" { + t.Errorf("ValidateMirror(`"+address+"`) got %s %s", ret, err) + } + } + + for _, address := range invalid { + if ret, err := ValidateMirror(address); err == nil || ret != "" { + t.Errorf("ValidateMirror(`"+address+"`) got %s %s", ret, err) + } + } +} diff --git a/registry/config_unix.go b/registry/config_unix.go new file mode 100644 index 0000000000..32f167d08b --- /dev/null +++ b/registry/config_unix.go @@ -0,0 +1,22 @@ +// +build !windows + +package registry + +const ( + // DefaultV1Registry is the URI of the default v1 registry + DefaultV1Registry = "https://index.docker.io" + + // DefaultV2Registry is the URI of the default v2 registry + DefaultV2Registry = "https://registry-1.docker.io" + + // CertsDir is the directory where certificates are stored + CertsDir = "/etc/docker/certs.d" +) + +// cleanPath is used to ensure that a directory name is valid on the target +// platform. It will be passed in something *similar* to a URL such as +// https:/index.docker.io/v1. Not all platforms support directory names +// which contain those characters (such as : on Windows) +func cleanPath(s string) string { + return s +} diff --git a/registry/config_windows.go b/registry/config_windows.go new file mode 100644 index 0000000000..d01b2618af --- /dev/null +++ b/registry/config_windows.go @@ -0,0 +1,30 @@ +package registry + +import ( + "os" + "path/filepath" + "strings" +) + +const ( + // DefaultV1Registry is the URI of the default v1 registry + DefaultV1Registry = "https://registry-win-tp3.docker.io" + + // DefaultV2Registry is the URI of the default (official) v2 registry. + // This is the windows-specific endpoint. + // + // Currently it is a TEMPORARY link that allows Microsoft to continue + // development of Docker Engine for Windows. + DefaultV2Registry = "https://registry-win-tp3.docker.io" +) + +// CertsDir is the directory where certificates are stored +var CertsDir = os.Getenv("programdata") + `\docker\certs.d` + +// cleanPath is used to ensure that a directory name is valid on the target +// platform. It will be passed in something *similar* to a URL such as +// https:\index.docker.io\v1. Not all platforms support directory names +// which contain those characters (such as : on Windows) +func cleanPath(s string) string { + return filepath.FromSlash(strings.Replace(s, ":", "", -1)) +} diff --git a/registry/endpoint.go b/registry/endpoint.go new file mode 100644 index 0000000000..1b2df02813 --- /dev/null +++ b/registry/endpoint.go @@ -0,0 +1,293 @@ +package registry + +import ( + "crypto/tls" + "encoding/json" + "fmt" + "io/ioutil" + "net" + "net/http" + "net/url" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/registry/api/v2" + "github.com/docker/distribution/registry/client/transport" +) + +// for mocking in unit tests +var lookupIP = net.LookupIP + +// scans string for api version in the URL path. returns the trimmed address, if version found, string and API version. +func scanForAPIVersion(address string) (string, APIVersion) { + var ( + chunks []string + apiVersionStr string + ) + + if strings.HasSuffix(address, "/") { + address = address[:len(address)-1] + } + + chunks = strings.Split(address, "/") + apiVersionStr = chunks[len(chunks)-1] + + for k, v := range apiVersions { + if apiVersionStr == v { + address = strings.Join(chunks[:len(chunks)-1], "/") + return address, k + } + } + + return address, APIVersionUnknown +} + +// NewEndpoint parses the given address to return a registry endpoint. v can be used to +// specify a specific endpoint version +func NewEndpoint(index *IndexInfo, metaHeaders http.Header, v APIVersion) (*Endpoint, error) { + tlsConfig, err := newTLSConfig(index.Name, index.Secure) + if err != nil { + return nil, err + } + endpoint, err := newEndpoint(index.GetAuthConfigKey(), tlsConfig, metaHeaders) + if err != nil { + return nil, err + } + if v != APIVersionUnknown { + endpoint.Version = v + } + if err := validateEndpoint(endpoint); err != nil { + return nil, err + } + + return endpoint, nil +} + +func validateEndpoint(endpoint *Endpoint) error { + logrus.Debugf("pinging registry endpoint %s", endpoint) + + // Try HTTPS ping to registry + endpoint.URL.Scheme = "https" + if _, err := endpoint.Ping(); err != nil { + if endpoint.IsSecure { + // If registry is secure and HTTPS failed, show user the error and tell them about `--insecure-registry` + // in case that's what they need. DO NOT accept unknown CA certificates, and DO NOT fallback to HTTP. + return fmt.Errorf("invalid registry endpoint %s: %v. If this private registry supports only HTTP or HTTPS with an unknown CA certificate, please add `--insecure-registry %s` to the daemon's arguments. In the case of HTTPS, if you have access to the registry's CA certificate, no need for the flag; simply place the CA certificate at /etc/docker/certs.d/%s/ca.crt", endpoint, err, endpoint.URL.Host, endpoint.URL.Host) + } + + // If registry is insecure and HTTPS failed, fallback to HTTP. + logrus.Debugf("Error from registry %q marked as insecure: %v. Insecurely falling back to HTTP", endpoint, err) + endpoint.URL.Scheme = "http" + + var err2 error + if _, err2 = endpoint.Ping(); err2 == nil { + return nil + } + + return fmt.Errorf("invalid registry endpoint %q. HTTPS attempt: %v. HTTP attempt: %v", endpoint, err, err2) + } + + return nil +} + +func newEndpoint(address string, tlsConfig *tls.Config, metaHeaders http.Header) (*Endpoint, error) { + var ( + endpoint = new(Endpoint) + trimmedAddress string + err error + ) + + if !strings.HasPrefix(address, "http") { + address = "https://" + address + } + + endpoint.IsSecure = (tlsConfig == nil || !tlsConfig.InsecureSkipVerify) + + trimmedAddress, endpoint.Version = scanForAPIVersion(address) + + if endpoint.URL, err = url.Parse(trimmedAddress); err != nil { + return nil, err + } + + // TODO(tiborvass): make sure a ConnectTimeout transport is used + tr := NewTransport(tlsConfig) + endpoint.client = HTTPClient(transport.NewTransport(tr, DockerHeaders(metaHeaders)...)) + return endpoint, nil +} + +// Endpoint stores basic information about a registry endpoint. +type Endpoint struct { + client *http.Client + URL *url.URL + Version APIVersion + IsSecure bool + AuthChallenges []*AuthorizationChallenge + URLBuilder *v2.URLBuilder +} + +// Get the formated URL for the root of this registry Endpoint +func (e *Endpoint) String() string { + return fmt.Sprintf("%s/v%d/", e.URL, e.Version) +} + +// VersionString returns a formatted string of this +// endpoint address using the given API Version. +func (e *Endpoint) VersionString(version APIVersion) string { + return fmt.Sprintf("%s/v%d/", e.URL, version) +} + +// Path returns a formatted string for the URL +// of this endpoint with the given path appended. +func (e *Endpoint) Path(path string) string { + return fmt.Sprintf("%s/v%d/%s", e.URL, e.Version, path) +} + +// Ping pings the remote endpoint with v2 and v1 pings to determine the API +// version. It returns a PingResult containing the discovered version. The +// PingResult also indicates whether the registry is standalone or not. +func (e *Endpoint) Ping() (PingResult, error) { + // The ping logic to use is determined by the registry endpoint version. + switch e.Version { + case APIVersion1: + return e.pingV1() + case APIVersion2: + return e.pingV2() + } + + // APIVersionUnknown + // We should try v2 first... + e.Version = APIVersion2 + regInfo, errV2 := e.pingV2() + if errV2 == nil { + return regInfo, nil + } + + // ... then fallback to v1. + e.Version = APIVersion1 + regInfo, errV1 := e.pingV1() + if errV1 == nil { + return regInfo, nil + } + + e.Version = APIVersionUnknown + return PingResult{}, fmt.Errorf("unable to ping registry endpoint %s\nv2 ping attempt failed with error: %s\n v1 ping attempt failed with error: %s", e, errV2, errV1) +} + +func (e *Endpoint) pingV1() (PingResult, error) { + logrus.Debugf("attempting v1 ping for registry endpoint %s", e) + + if e.String() == IndexServer { + // Skip the check, we know this one is valid + // (and we never want to fallback to http in case of error) + return PingResult{Standalone: false}, nil + } + + req, err := http.NewRequest("GET", e.Path("_ping"), nil) + if err != nil { + return PingResult{Standalone: false}, err + } + + resp, err := e.client.Do(req) + if err != nil { + return PingResult{Standalone: false}, err + } + + defer resp.Body.Close() + + jsonString, err := ioutil.ReadAll(resp.Body) + if err != nil { + return PingResult{Standalone: false}, fmt.Errorf("error while reading the http response: %s", err) + } + + // If the header is absent, we assume true for compatibility with earlier + // versions of the registry. default to true + info := PingResult{ + Standalone: true, + } + if err := json.Unmarshal(jsonString, &info); err != nil { + logrus.Debugf("Error unmarshalling the _ping PingResult: %s", err) + // don't stop here. Just assume sane defaults + } + if hdr := resp.Header.Get("X-Docker-Registry-Version"); hdr != "" { + logrus.Debugf("Registry version header: '%s'", hdr) + info.Version = hdr + } + logrus.Debugf("PingResult.Version: %q", info.Version) + + standalone := resp.Header.Get("X-Docker-Registry-Standalone") + logrus.Debugf("Registry standalone header: '%s'", standalone) + // Accepted values are "true" (case-insensitive) and "1". + if strings.EqualFold(standalone, "true") || standalone == "1" { + info.Standalone = true + } else if len(standalone) > 0 { + // there is a header set, and it is not "true" or "1", so assume fails + info.Standalone = false + } + logrus.Debugf("PingResult.Standalone: %t", info.Standalone) + return info, nil +} + +func (e *Endpoint) pingV2() (PingResult, error) { + logrus.Debugf("attempting v2 ping for registry endpoint %s", e) + + req, err := http.NewRequest("GET", e.Path(""), nil) + if err != nil { + return PingResult{}, err + } + + resp, err := e.client.Do(req) + if err != nil { + return PingResult{}, err + } + defer resp.Body.Close() + + // The endpoint may have multiple supported versions. + // Ensure it supports the v2 Registry API. + var supportsV2 bool + +HeaderLoop: + for _, supportedVersions := range resp.Header[http.CanonicalHeaderKey("Docker-Distribution-API-Version")] { + for _, versionName := range strings.Fields(supportedVersions) { + if versionName == "registry/2.0" { + supportsV2 = true + break HeaderLoop + } + } + } + + if !supportsV2 { + return PingResult{}, fmt.Errorf("%s does not appear to be a v2 registry endpoint", e) + } + + if resp.StatusCode == http.StatusOK { + // It would seem that no authentication/authorization is required. + // So we don't need to parse/add any authorization schemes. + return PingResult{Standalone: true}, nil + } + + if resp.StatusCode == http.StatusUnauthorized { + // Parse the WWW-Authenticate Header and store the challenges + // on this endpoint object. + e.AuthChallenges = parseAuthHeader(resp.Header) + return PingResult{}, nil + } + + return PingResult{}, fmt.Errorf("v2 registry endpoint returned status %d: %q", resp.StatusCode, http.StatusText(resp.StatusCode)) +} + +func (e *Endpoint) HTTPClient() *http.Client { + tlsConfig := tls.Config{ + MinVersion: tls.VersionTLS10, + } + if !e.IsSecure { + tlsConfig.InsecureSkipVerify = true + } + return &http.Client{ + Transport: &http.Transport{ + DisableKeepAlives: true, + Proxy: http.ProxyFromEnvironment, + TLSClientConfig: &tlsConfig, + }, + CheckRedirect: AddRequiredHeadersToRedirectedRequests, + } +} diff --git a/registry/endpoint_test.go b/registry/endpoint_test.go new file mode 100644 index 0000000000..ee301dbd88 --- /dev/null +++ b/registry/endpoint_test.go @@ -0,0 +1,93 @@ +package registry + +import ( + "net/http" + "net/http/httptest" + "net/url" + "testing" +) + +func TestEndpointParse(t *testing.T) { + testData := []struct { + str string + expected string + }{ + {IndexServer, IndexServer}, + {"http://0.0.0.0:5000/v1/", "http://0.0.0.0:5000/v1/"}, + {"http://0.0.0.0:5000/v2/", "http://0.0.0.0:5000/v2/"}, + {"http://0.0.0.0:5000", "http://0.0.0.0:5000/v0/"}, + {"0.0.0.0:5000", "https://0.0.0.0:5000/v0/"}, + } + for _, td := range testData { + e, err := newEndpoint(td.str, nil, nil) + if err != nil { + t.Errorf("%q: %s", td.str, err) + } + if e == nil { + t.Logf("something's fishy, endpoint for %q is nil", td.str) + continue + } + if e.String() != td.expected { + t.Errorf("expected %q, got %q", td.expected, e.String()) + } + } +} + +// Ensure that a registry endpoint that responds with a 401 only is determined +// to be a v1 registry unless it includes a valid v2 API header. +func TestValidateEndpointAmbiguousAPIVersion(t *testing.T) { + requireBasicAuthHandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Add("WWW-Authenticate", `Basic realm="localhost"`) + w.WriteHeader(http.StatusUnauthorized) + }) + + requireBasicAuthHandlerV2 := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + // This mock server supports v2.0, v2.1, v42.0, and v100.0 + w.Header().Add("Docker-Distribution-API-Version", "registry/100.0 registry/42.0") + w.Header().Add("Docker-Distribution-API-Version", "registry/2.0 registry/2.1") + requireBasicAuthHandler.ServeHTTP(w, r) + }) + + // Make a test server which should validate as a v1 server. + testServer := httptest.NewServer(requireBasicAuthHandler) + defer testServer.Close() + + testServerURL, err := url.Parse(testServer.URL) + if err != nil { + t.Fatal(err) + } + + testEndpoint := Endpoint{ + URL: testServerURL, + Version: APIVersionUnknown, + client: HTTPClient(NewTransport(nil)), + } + + if err = validateEndpoint(&testEndpoint); err != nil { + t.Fatal(err) + } + + if testEndpoint.Version != APIVersion1 { + t.Fatalf("expected endpoint to validate to %d, got %d", APIVersion1, testEndpoint.Version) + } + + // Make a test server which should validate as a v2 server. + testServer = httptest.NewServer(requireBasicAuthHandlerV2) + defer testServer.Close() + + testServerURL, err = url.Parse(testServer.URL) + if err != nil { + t.Fatal(err) + } + + testEndpoint.URL = testServerURL + testEndpoint.Version = APIVersionUnknown + + if err = validateEndpoint(&testEndpoint); err != nil { + t.Fatal(err) + } + + if testEndpoint.Version != APIVersion2 { + t.Fatalf("expected endpoint to validate to %d, got %d", APIVersion2, testEndpoint.Version) + } +} diff --git a/registry/reference.go b/registry/reference.go new file mode 100644 index 0000000000..e15f83eeeb --- /dev/null +++ b/registry/reference.go @@ -0,0 +1,68 @@ +package registry + +import ( + "strings" + + "github.com/docker/distribution/digest" +) + +// Reference represents a tag or digest within a repository +type Reference interface { + // HasDigest returns whether the reference has a verifiable + // content addressable reference which may be considered secure. + HasDigest() bool + + // ImageName returns an image name for the given repository + ImageName(string) string + + // Returns a string representation of the reference + String() string +} + +type tagReference struct { + tag string +} + +func (tr tagReference) HasDigest() bool { + return false +} + +func (tr tagReference) ImageName(repo string) string { + return repo + ":" + tr.tag +} + +func (tr tagReference) String() string { + return tr.tag +} + +type digestReference struct { + digest digest.Digest +} + +func (dr digestReference) HasDigest() bool { + return true +} + +func (dr digestReference) ImageName(repo string) string { + return repo + "@" + dr.String() +} + +func (dr digestReference) String() string { + return dr.digest.String() +} + +// ParseReference parses a reference into either a digest or tag reference +func ParseReference(ref string) Reference { + if strings.Contains(ref, ":") { + dgst, err := digest.ParseDigest(ref) + if err == nil { + return digestReference{digest: dgst} + } + } + return tagReference{tag: ref} +} + +// DigestReference creates a digest reference using a digest +func DigestReference(dgst digest.Digest) Reference { + return digestReference{digest: dgst} +} diff --git a/registry/registry.go b/registry/registry.go new file mode 100644 index 0000000000..389bd959df --- /dev/null +++ b/registry/registry.go @@ -0,0 +1,249 @@ +// Package registry contains client primitives to interact with a remote Docker registry. +package registry + +import ( + "crypto/tls" + "crypto/x509" + "errors" + "fmt" + "io/ioutil" + "net" + "net/http" + "os" + "path/filepath" + "runtime" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/registry/api/errcode" + "github.com/docker/distribution/registry/api/v2" + "github.com/docker/distribution/registry/client" + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/pkg/parsers/kernel" + "github.com/docker/docker/pkg/tlsconfig" + "github.com/docker/docker/pkg/useragent" +) + +var ( + // ErrAlreadyExists is an error returned if an image being pushed + // already exists on the remote side + ErrAlreadyExists = errors.New("Image already exists") + errLoginRequired = errors.New("Authentication is required.") +) + +// dockerUserAgent is the User-Agent the Docker client uses to identify itself. +// It is populated on init(), comprising version information of different components. +var dockerUserAgent string + +func init() { + httpVersion := make([]useragent.VersionInfo, 0, 6) + httpVersion = append(httpVersion, useragent.VersionInfo{"docker", dockerversion.VERSION}) + httpVersion = append(httpVersion, useragent.VersionInfo{"go", runtime.Version()}) + httpVersion = append(httpVersion, useragent.VersionInfo{"git-commit", dockerversion.GITCOMMIT}) + if kernelVersion, err := kernel.GetKernelVersion(); err == nil { + httpVersion = append(httpVersion, useragent.VersionInfo{"kernel", kernelVersion.String()}) + } + httpVersion = append(httpVersion, useragent.VersionInfo{"os", runtime.GOOS}) + httpVersion = append(httpVersion, useragent.VersionInfo{"arch", runtime.GOARCH}) + + dockerUserAgent = useragent.AppendVersions("", httpVersion...) + + if runtime.GOOS != "linux" { + V2Only = true + } +} + +func newTLSConfig(hostname string, isSecure bool) (*tls.Config, error) { + // PreferredServerCipherSuites should have no effect + tlsConfig := tlsconfig.ServerDefault + + tlsConfig.InsecureSkipVerify = !isSecure + + if isSecure { + hostDir := filepath.Join(CertsDir, cleanPath(hostname)) + logrus.Debugf("hostDir: %s", hostDir) + if err := ReadCertsDirectory(&tlsConfig, hostDir); err != nil { + return nil, err + } + } + + return &tlsConfig, nil +} + +func hasFile(files []os.FileInfo, name string) bool { + for _, f := range files { + if f.Name() == name { + return true + } + } + return false +} + +// ReadCertsDirectory reads the directory for TLS certificates +// including roots and certificate pairs and updates the +// provided TLS configuration. +func ReadCertsDirectory(tlsConfig *tls.Config, directory string) error { + fs, err := ioutil.ReadDir(directory) + if err != nil && !os.IsNotExist(err) { + return err + } + + for _, f := range fs { + if strings.HasSuffix(f.Name(), ".crt") { + if tlsConfig.RootCAs == nil { + // TODO(dmcgowan): Copy system pool + tlsConfig.RootCAs = x509.NewCertPool() + } + logrus.Debugf("crt: %s", filepath.Join(directory, f.Name())) + data, err := ioutil.ReadFile(filepath.Join(directory, f.Name())) + if err != nil { + return err + } + tlsConfig.RootCAs.AppendCertsFromPEM(data) + } + if strings.HasSuffix(f.Name(), ".cert") { + certName := f.Name() + keyName := certName[:len(certName)-5] + ".key" + logrus.Debugf("cert: %s", filepath.Join(directory, f.Name())) + if !hasFile(fs, keyName) { + return fmt.Errorf("Missing key %s for certificate %s", keyName, certName) + } + cert, err := tls.LoadX509KeyPair(filepath.Join(directory, certName), filepath.Join(directory, keyName)) + if err != nil { + return err + } + tlsConfig.Certificates = append(tlsConfig.Certificates, cert) + } + if strings.HasSuffix(f.Name(), ".key") { + keyName := f.Name() + certName := keyName[:len(keyName)-4] + ".cert" + logrus.Debugf("key: %s", filepath.Join(directory, f.Name())) + if !hasFile(fs, certName) { + return fmt.Errorf("Missing certificate %s for key %s", certName, keyName) + } + } + } + + return nil +} + +// DockerHeaders returns request modifiers that ensure requests have +// the User-Agent header set to dockerUserAgent and that metaHeaders +// are added. +func DockerHeaders(metaHeaders http.Header) []transport.RequestModifier { + modifiers := []transport.RequestModifier{ + transport.NewHeaderRequestModifier(http.Header{"User-Agent": []string{dockerUserAgent}}), + } + if metaHeaders != nil { + modifiers = append(modifiers, transport.NewHeaderRequestModifier(metaHeaders)) + } + return modifiers +} + +// HTTPClient returns a HTTP client structure which uses the given transport +// and contains the necessary headers for redirected requests +func HTTPClient(transport http.RoundTripper) *http.Client { + return &http.Client{ + Transport: transport, + CheckRedirect: addRequiredHeadersToRedirectedRequests, + } +} + +func trustedLocation(req *http.Request) bool { + var ( + trusteds = []string{"docker.com", "docker.io"} + hostname = strings.SplitN(req.Host, ":", 2)[0] + ) + if req.URL.Scheme != "https" { + return false + } + + for _, trusted := range trusteds { + if hostname == trusted || strings.HasSuffix(hostname, "."+trusted) { + return true + } + } + return false +} + +// addRequiredHeadersToRedirectedRequests adds the necessary redirection headers +// for redirected requests +func addRequiredHeadersToRedirectedRequests(req *http.Request, via []*http.Request) error { + if via != nil && via[0] != nil { + if trustedLocation(req) && trustedLocation(via[0]) { + req.Header = via[0].Header + return nil + } + for k, v := range via[0].Header { + if k != "Authorization" { + for _, vv := range v { + req.Header.Add(k, vv) + } + } + } + } + return nil +} + +func shouldV2Fallback(err errcode.Error) bool { + logrus.Debugf("v2 error: %T %v", err, err) + switch err.Code { + case v2.ErrorCodeUnauthorized, v2.ErrorCodeManifestUnknown: + return true + } + return false +} + +// ErrNoSupport is an error type used for errors indicating that an operation +// is not supported. It encapsulates a more specific error. +type ErrNoSupport struct{ Err error } + +func (e ErrNoSupport) Error() string { + if e.Err == nil { + return "not supported" + } + return e.Err.Error() +} + +// ContinueOnError returns true if we should fallback to the next endpoint +// as a result of this error. +func ContinueOnError(err error) bool { + switch v := err.(type) { + case errcode.Errors: + return ContinueOnError(v[0]) + case ErrNoSupport: + return ContinueOnError(v.Err) + case errcode.Error: + return shouldV2Fallback(v) + case *client.UnexpectedHTTPResponseError: + return true + } + // let's be nice and fallback if the error is a completely + // unexpected one. + // If new errors have to be handled in some way, please + // add them to the switch above. + return true +} + +// NewTransport returns a new HTTP transport. If tlsConfig is nil, it uses the +// default TLS configuration. +func NewTransport(tlsConfig *tls.Config) *http.Transport { + if tlsConfig == nil { + var cfg = tlsconfig.ServerDefault + tlsConfig = &cfg + } + return &http.Transport{ + Proxy: http.ProxyFromEnvironment, + Dial: (&net.Dialer{ + Timeout: 30 * time.Second, + KeepAlive: 30 * time.Second, + DualStack: true, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, + TLSClientConfig: tlsConfig, + // TODO(dmcgowan): Call close idle connections when complete and use keep alive + DisableKeepAlives: true, + } +} diff --git a/registry/registry_mock_test.go b/registry/registry_mock_test.go new file mode 100644 index 0000000000..fb19e577dd --- /dev/null +++ b/registry/registry_mock_test.go @@ -0,0 +1,476 @@ +package registry + +import ( + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "net" + "net/http" + "net/http/httptest" + "net/url" + "strconv" + "strings" + "testing" + "time" + + "github.com/docker/docker/opts" + "github.com/gorilla/mux" + + "github.com/Sirupsen/logrus" +) + +var ( + testHTTPServer *httptest.Server + testHTTPSServer *httptest.Server + testLayers = map[string]map[string]string{ + "77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20": { + "json": `{"id":"77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20", + "comment":"test base image","created":"2013-03-23T12:53:11.10432-07:00", + "container_config":{"Hostname":"","User":"","Memory":0,"MemorySwap":0, + "CpuShares":0,"AttachStdin":false,"AttachStdout":false,"AttachStderr":false, + "Tty":false,"OpenStdin":false,"StdinOnce":false, + "Env":null,"Cmd":null,"Dns":null,"Image":"","Volumes":null, + "VolumesFrom":"","Entrypoint":null},"Size":424242}`, + "checksum_simple": "sha256:1ac330d56e05eef6d438586545ceff7550d3bdcb6b19961f12c5ba714ee1bb37", + "checksum_tarsum": "tarsum+sha256:4409a0685741ca86d38df878ed6f8cbba4c99de5dc73cd71aef04be3bb70be7c", + "ancestry": `["77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20"]`, + "layer": string([]byte{ + 0x1f, 0x8b, 0x08, 0x08, 0x0e, 0xb0, 0xee, 0x51, 0x02, 0x03, 0x6c, 0x61, 0x79, 0x65, + 0x72, 0x2e, 0x74, 0x61, 0x72, 0x00, 0xed, 0xd2, 0x31, 0x0e, 0xc2, 0x30, 0x0c, 0x05, + 0x50, 0xcf, 0x9c, 0xc2, 0x27, 0x48, 0xed, 0x38, 0x4e, 0xce, 0x13, 0x44, 0x2b, 0x66, + 0x62, 0x24, 0x8e, 0x4f, 0xa0, 0x15, 0x63, 0xb6, 0x20, 0x21, 0xfc, 0x96, 0xbf, 0x78, + 0xb0, 0xf5, 0x1d, 0x16, 0x98, 0x8e, 0x88, 0x8a, 0x2a, 0xbe, 0x33, 0xef, 0x49, 0x31, + 0xed, 0x79, 0x40, 0x8e, 0x5c, 0x44, 0x85, 0x88, 0x33, 0x12, 0x73, 0x2c, 0x02, 0xa8, + 0xf0, 0x05, 0xf7, 0x66, 0xf5, 0xd6, 0x57, 0x69, 0xd7, 0x7a, 0x19, 0xcd, 0xf5, 0xb1, + 0x6d, 0x1b, 0x1f, 0xf9, 0xba, 0xe3, 0x93, 0x3f, 0x22, 0x2c, 0xb6, 0x36, 0x0b, 0xf6, + 0xb0, 0xa9, 0xfd, 0xe7, 0x94, 0x46, 0xfd, 0xeb, 0xd1, 0x7f, 0x2c, 0xc4, 0xd2, 0xfb, + 0x97, 0xfe, 0x02, 0x80, 0xe4, 0xfd, 0x4f, 0x77, 0xae, 0x6d, 0x3d, 0x81, 0x73, 0xce, + 0xb9, 0x7f, 0xf3, 0x04, 0x41, 0xc1, 0xab, 0xc6, 0x00, 0x0a, 0x00, 0x00, + }), + }, + "42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d": { + "json": `{"id":"42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d", + "parent":"77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20", + "comment":"test base image","created":"2013-03-23T12:55:11.10432-07:00", + "container_config":{"Hostname":"","User":"","Memory":0,"MemorySwap":0, + "CpuShares":0,"AttachStdin":false,"AttachStdout":false,"AttachStderr":false, + "Tty":false,"OpenStdin":false,"StdinOnce":false, + "Env":null,"Cmd":null,"Dns":null,"Image":"","Volumes":null, + "VolumesFrom":"","Entrypoint":null},"Size":424242}`, + "checksum_simple": "sha256:bea7bf2e4bacd479344b737328db47b18880d09096e6674165533aa994f5e9f2", + "checksum_tarsum": "tarsum+sha256:68fdb56fb364f074eec2c9b3f85ca175329c4dcabc4a6a452b7272aa613a07a2", + "ancestry": `["42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d", + "77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20"]`, + "layer": string([]byte{ + 0x1f, 0x8b, 0x08, 0x08, 0xbd, 0xb3, 0xee, 0x51, 0x02, 0x03, 0x6c, 0x61, 0x79, 0x65, + 0x72, 0x2e, 0x74, 0x61, 0x72, 0x00, 0xed, 0xd1, 0x31, 0x0e, 0xc2, 0x30, 0x0c, 0x05, + 0x50, 0xcf, 0x9c, 0xc2, 0x27, 0x48, 0x9d, 0x38, 0x8e, 0xcf, 0x53, 0x51, 0xaa, 0x56, + 0xea, 0x44, 0x82, 0xc4, 0xf1, 0x09, 0xb4, 0xea, 0x98, 0x2d, 0x48, 0x08, 0xbf, 0xe5, + 0x2f, 0x1e, 0xfc, 0xf5, 0xdd, 0x00, 0xdd, 0x11, 0x91, 0x8a, 0xe0, 0x27, 0xd3, 0x9e, + 0x14, 0xe2, 0x9e, 0x07, 0xf4, 0xc1, 0x2b, 0x0b, 0xfb, 0xa4, 0x82, 0xe4, 0x3d, 0x93, + 0x02, 0x0a, 0x7c, 0xc1, 0x23, 0x97, 0xf1, 0x5e, 0x5f, 0xc9, 0xcb, 0x38, 0xb5, 0xee, + 0xea, 0xd9, 0x3c, 0xb7, 0x4b, 0xbe, 0x7b, 0x9c, 0xf9, 0x23, 0xdc, 0x50, 0x6e, 0xb9, + 0xb8, 0xf2, 0x2c, 0x5d, 0xf7, 0x4f, 0x31, 0xb6, 0xf6, 0x4f, 0xc7, 0xfe, 0x41, 0x55, + 0x63, 0xdd, 0x9f, 0x89, 0x09, 0x90, 0x6c, 0xff, 0xee, 0xae, 0xcb, 0xba, 0x4d, 0x17, + 0x30, 0xc6, 0x18, 0xf3, 0x67, 0x5e, 0xc1, 0xed, 0x21, 0x5d, 0x00, 0x0a, 0x00, 0x00, + }), + }, + } + testRepositories = map[string]map[string]string{ + "foo42/bar": { + "latest": "42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d", + "test": "42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d", + }, + } + mockHosts = map[string][]net.IP{ + "": {net.ParseIP("0.0.0.0")}, + "localhost": {net.ParseIP("127.0.0.1"), net.ParseIP("::1")}, + "example.com": {net.ParseIP("42.42.42.42")}, + "other.com": {net.ParseIP("43.43.43.43")}, + } +) + +func init() { + r := mux.NewRouter() + + // /v1/ + r.HandleFunc("/v1/_ping", handlerGetPing).Methods("GET") + r.HandleFunc("/v1/images/{image_id:[^/]+}/{action:json|layer|ancestry}", handlerGetImage).Methods("GET") + r.HandleFunc("/v1/images/{image_id:[^/]+}/{action:json|layer|checksum}", handlerPutImage).Methods("PUT") + r.HandleFunc("/v1/repositories/{repository:.+}/tags", handlerGetDeleteTags).Methods("GET", "DELETE") + r.HandleFunc("/v1/repositories/{repository:.+}/tags/{tag:.+}", handlerGetTag).Methods("GET") + r.HandleFunc("/v1/repositories/{repository:.+}/tags/{tag:.+}", handlerPutTag).Methods("PUT") + r.HandleFunc("/v1/users{null:.*}", handlerUsers).Methods("GET", "POST", "PUT") + r.HandleFunc("/v1/repositories/{repository:.+}{action:/images|/}", handlerImages).Methods("GET", "PUT", "DELETE") + r.HandleFunc("/v1/repositories/{repository:.+}/auth", handlerAuth).Methods("PUT") + r.HandleFunc("/v1/search", handlerSearch).Methods("GET") + + // /v2/ + r.HandleFunc("/v2/version", handlerGetPing).Methods("GET") + + testHTTPServer = httptest.NewServer(handlerAccessLog(r)) + testHTTPSServer = httptest.NewTLSServer(handlerAccessLog(r)) + + // override net.LookupIP + lookupIP = func(host string) ([]net.IP, error) { + if host == "127.0.0.1" { + // I believe in future Go versions this will fail, so let's fix it later + return net.LookupIP(host) + } + for h, addrs := range mockHosts { + if host == h { + return addrs, nil + } + for _, addr := range addrs { + if addr.String() == host { + return []net.IP{addr}, nil + } + } + } + return nil, errors.New("lookup: no such host") + } +} + +func handlerAccessLog(handler http.Handler) http.Handler { + logHandler := func(w http.ResponseWriter, r *http.Request) { + logrus.Debugf("%s \"%s %s\"", r.RemoteAddr, r.Method, r.URL) + handler.ServeHTTP(w, r) + } + return http.HandlerFunc(logHandler) +} + +func makeURL(req string) string { + return testHTTPServer.URL + req +} + +func makeHTTPSURL(req string) string { + return testHTTPSServer.URL + req +} + +func makeIndex(req string) *IndexInfo { + index := &IndexInfo{ + Name: makeURL(req), + } + return index +} + +func makeHTTPSIndex(req string) *IndexInfo { + index := &IndexInfo{ + Name: makeHTTPSURL(req), + } + return index +} + +func makePublicIndex() *IndexInfo { + index := &IndexInfo{ + Name: IndexServer, + Secure: true, + Official: true, + } + return index +} + +func makeServiceConfig(mirrors []string, insecureRegistries []string) *ServiceConfig { + options := &Options{ + Mirrors: opts.NewListOpts(nil), + InsecureRegistries: opts.NewListOpts(nil), + } + if mirrors != nil { + for _, mirror := range mirrors { + options.Mirrors.Set(mirror) + } + } + if insecureRegistries != nil { + for _, insecureRegistries := range insecureRegistries { + options.InsecureRegistries.Set(insecureRegistries) + } + } + + return NewServiceConfig(options) +} + +func writeHeaders(w http.ResponseWriter) { + h := w.Header() + h.Add("Server", "docker-tests/mock") + h.Add("Expires", "-1") + h.Add("Content-Type", "application/json") + h.Add("Pragma", "no-cache") + h.Add("Cache-Control", "no-cache") + h.Add("X-Docker-Registry-Version", "0.0.0") + h.Add("X-Docker-Registry-Config", "mock") +} + +func writeResponse(w http.ResponseWriter, message interface{}, code int) { + writeHeaders(w) + w.WriteHeader(code) + body, err := json.Marshal(message) + if err != nil { + io.WriteString(w, err.Error()) + return + } + w.Write(body) +} + +func readJSON(r *http.Request, dest interface{}) error { + body, err := ioutil.ReadAll(r.Body) + if err != nil { + return err + } + return json.Unmarshal(body, dest) +} + +func apiError(w http.ResponseWriter, message string, code int) { + body := map[string]string{ + "error": message, + } + writeResponse(w, body, code) +} + +func assertEqual(t *testing.T, a interface{}, b interface{}, message string) { + if a == b { + return + } + if len(message) == 0 { + message = fmt.Sprintf("%v != %v", a, b) + } + t.Fatal(message) +} + +func assertNotEqual(t *testing.T, a interface{}, b interface{}, message string) { + if a != b { + return + } + if len(message) == 0 { + message = fmt.Sprintf("%v == %v", a, b) + } + t.Fatal(message) +} + +// Similar to assertEqual, but does not stop test +func checkEqual(t *testing.T, a interface{}, b interface{}, messagePrefix string) { + if a == b { + return + } + message := fmt.Sprintf("%v != %v", a, b) + if len(messagePrefix) != 0 { + message = messagePrefix + ": " + message + } + t.Error(message) +} + +// Similar to assertNotEqual, but does not stop test +func checkNotEqual(t *testing.T, a interface{}, b interface{}, messagePrefix string) { + if a != b { + return + } + message := fmt.Sprintf("%v == %v", a, b) + if len(messagePrefix) != 0 { + message = messagePrefix + ": " + message + } + t.Error(message) +} + +func requiresAuth(w http.ResponseWriter, r *http.Request) bool { + writeCookie := func() { + value := fmt.Sprintf("FAKE-SESSION-%d", time.Now().UnixNano()) + cookie := &http.Cookie{Name: "session", Value: value, MaxAge: 3600} + http.SetCookie(w, cookie) + //FIXME(sam): this should be sent only on Index routes + value = fmt.Sprintf("FAKE-TOKEN-%d", time.Now().UnixNano()) + w.Header().Add("X-Docker-Token", value) + } + if len(r.Cookies()) > 0 { + writeCookie() + return true + } + if len(r.Header.Get("Authorization")) > 0 { + writeCookie() + return true + } + w.Header().Add("WWW-Authenticate", "token") + apiError(w, "Wrong auth", 401) + return false +} + +func handlerGetPing(w http.ResponseWriter, r *http.Request) { + writeResponse(w, true, 200) +} + +func handlerGetImage(w http.ResponseWriter, r *http.Request) { + if !requiresAuth(w, r) { + return + } + vars := mux.Vars(r) + layer, exists := testLayers[vars["image_id"]] + if !exists { + http.NotFound(w, r) + return + } + writeHeaders(w) + layerSize := len(layer["layer"]) + w.Header().Add("X-Docker-Size", strconv.Itoa(layerSize)) + io.WriteString(w, layer[vars["action"]]) +} + +func handlerPutImage(w http.ResponseWriter, r *http.Request) { + if !requiresAuth(w, r) { + return + } + vars := mux.Vars(r) + imageID := vars["image_id"] + action := vars["action"] + layer, exists := testLayers[imageID] + if !exists { + if action != "json" { + http.NotFound(w, r) + return + } + layer = make(map[string]string) + testLayers[imageID] = layer + } + if checksum := r.Header.Get("X-Docker-Checksum"); checksum != "" { + if checksum != layer["checksum_simple"] && checksum != layer["checksum_tarsum"] { + apiError(w, "Wrong checksum", 400) + return + } + } + body, err := ioutil.ReadAll(r.Body) + if err != nil { + apiError(w, fmt.Sprintf("Error: %s", err), 500) + return + } + layer[action] = string(body) + writeResponse(w, true, 200) +} + +func handlerGetDeleteTags(w http.ResponseWriter, r *http.Request) { + if !requiresAuth(w, r) { + return + } + repositoryName := mux.Vars(r)["repository"] + repositoryName = NormalizeLocalName(repositoryName) + tags, exists := testRepositories[repositoryName] + if !exists { + apiError(w, "Repository not found", 404) + return + } + if r.Method == "DELETE" { + delete(testRepositories, repositoryName) + writeResponse(w, true, 200) + return + } + writeResponse(w, tags, 200) +} + +func handlerGetTag(w http.ResponseWriter, r *http.Request) { + if !requiresAuth(w, r) { + return + } + vars := mux.Vars(r) + repositoryName := vars["repository"] + repositoryName = NormalizeLocalName(repositoryName) + tagName := vars["tag"] + tags, exists := testRepositories[repositoryName] + if !exists { + apiError(w, "Repository not found", 404) + return + } + tag, exists := tags[tagName] + if !exists { + apiError(w, "Tag not found", 404) + return + } + writeResponse(w, tag, 200) +} + +func handlerPutTag(w http.ResponseWriter, r *http.Request) { + if !requiresAuth(w, r) { + return + } + vars := mux.Vars(r) + repositoryName := vars["repository"] + repositoryName = NormalizeLocalName(repositoryName) + tagName := vars["tag"] + tags, exists := testRepositories[repositoryName] + if !exists { + tags := make(map[string]string) + testRepositories[repositoryName] = tags + } + tagValue := "" + readJSON(r, tagValue) + tags[tagName] = tagValue + writeResponse(w, true, 200) +} + +func handlerUsers(w http.ResponseWriter, r *http.Request) { + code := 200 + if r.Method == "POST" { + code = 201 + } else if r.Method == "PUT" { + code = 204 + } + writeResponse(w, "", code) +} + +func handlerImages(w http.ResponseWriter, r *http.Request) { + u, _ := url.Parse(testHTTPServer.URL) + w.Header().Add("X-Docker-Endpoints", fmt.Sprintf("%s , %s ", u.Host, "test.example.com")) + w.Header().Add("X-Docker-Token", fmt.Sprintf("FAKE-SESSION-%d", time.Now().UnixNano())) + if r.Method == "PUT" { + if strings.HasSuffix(r.URL.Path, "images") { + writeResponse(w, "", 204) + return + } + writeResponse(w, "", 200) + return + } + if r.Method == "DELETE" { + writeResponse(w, "", 204) + return + } + images := []map[string]string{} + for imageID, layer := range testLayers { + image := make(map[string]string) + image["id"] = imageID + image["checksum"] = layer["checksum_tarsum"] + image["Tag"] = "latest" + images = append(images, image) + } + writeResponse(w, images, 200) +} + +func handlerAuth(w http.ResponseWriter, r *http.Request) { + writeResponse(w, "OK", 200) +} + +func handlerSearch(w http.ResponseWriter, r *http.Request) { + result := &SearchResults{ + Query: "fakequery", + NumResults: 1, + Results: []SearchResult{{Name: "fakeimage", StarCount: 42}}, + } + writeResponse(w, result, 200) +} + +func TestPing(t *testing.T) { + res, err := http.Get(makeURL("/v1/_ping")) + if err != nil { + t.Fatal(err) + } + assertEqual(t, res.StatusCode, 200, "") + assertEqual(t, res.Header.Get("X-Docker-Registry-Config"), "mock", + "This is not a Mocked Registry") +} + +/* Uncomment this to test Mocked Registry locally with curl + * WARNING: Don't push on the repos uncommented, it'll block the tests + * +func TestWait(t *testing.T) { + logrus.Println("Test HTTP server ready and waiting:", testHTTPServer.URL) + c := make(chan int) + <-c +} + +//*/ diff --git a/registry/registry_test.go b/registry/registry_test.go new file mode 100644 index 0000000000..5b36210a67 --- /dev/null +++ b/registry/registry_test.go @@ -0,0 +1,953 @@ +package registry + +import ( + "fmt" + "net/http" + "net/http/httputil" + "net/url" + "strings" + "testing" + + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/docker/cliconfig" +) + +var ( + token = []string{"fake-token"} +) + +const ( + imageID = "42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d" + REPO = "foo42/bar" +) + +func spawnTestRegistrySession(t *testing.T) *Session { + authConfig := &cliconfig.AuthConfig{} + endpoint, err := NewEndpoint(makeIndex("/v1/"), nil, APIVersionUnknown) + if err != nil { + t.Fatal(err) + } + var tr http.RoundTripper = debugTransport{NewTransport(nil), t.Log} + tr = transport.NewTransport(AuthTransport(tr, authConfig, false), DockerHeaders(nil)...) + client := HTTPClient(tr) + r, err := NewSession(client, authConfig, endpoint) + if err != nil { + t.Fatal(err) + } + // In a normal scenario for the v1 registry, the client should send a `X-Docker-Token: true` + // header while authenticating, in order to retrieve a token that can be later used to + // perform authenticated actions. + // + // The mock v1 registry does not support that, (TODO(tiborvass): support it), instead, + // it will consider authenticated any request with the header `X-Docker-Token: fake-token`. + // + // Because we know that the client's transport is an `*authTransport` we simply cast it, + // in order to set the internal cached token to the fake token, and thus send that fake token + // upon every subsequent requests. + r.client.Transport.(*authTransport).token = token + return r +} + +func TestPingRegistryEndpoint(t *testing.T) { + testPing := func(index *IndexInfo, expectedStandalone bool, assertMessage string) { + ep, err := NewEndpoint(index, nil, APIVersionUnknown) + if err != nil { + t.Fatal(err) + } + regInfo, err := ep.Ping() + if err != nil { + t.Fatal(err) + } + + assertEqual(t, regInfo.Standalone, expectedStandalone, assertMessage) + } + + testPing(makeIndex("/v1/"), true, "Expected standalone to be true (default)") + testPing(makeHTTPSIndex("/v1/"), true, "Expected standalone to be true (default)") + testPing(makePublicIndex(), false, "Expected standalone to be false for public index") +} + +func TestEndpoint(t *testing.T) { + // Simple wrapper to fail test if err != nil + expandEndpoint := func(index *IndexInfo) *Endpoint { + endpoint, err := NewEndpoint(index, nil, APIVersionUnknown) + if err != nil { + t.Fatal(err) + } + return endpoint + } + + assertInsecureIndex := func(index *IndexInfo) { + index.Secure = true + _, err := NewEndpoint(index, nil, APIVersionUnknown) + assertNotEqual(t, err, nil, index.Name+": Expected error for insecure index") + assertEqual(t, strings.Contains(err.Error(), "insecure-registry"), true, index.Name+": Expected insecure-registry error for insecure index") + index.Secure = false + } + + assertSecureIndex := func(index *IndexInfo) { + index.Secure = true + _, err := NewEndpoint(index, nil, APIVersionUnknown) + assertNotEqual(t, err, nil, index.Name+": Expected cert error for secure index") + assertEqual(t, strings.Contains(err.Error(), "certificate signed by unknown authority"), true, index.Name+": Expected cert error for secure index") + index.Secure = false + } + + index := &IndexInfo{} + index.Name = makeURL("/v1/") + endpoint := expandEndpoint(index) + assertEqual(t, endpoint.String(), index.Name, "Expected endpoint to be "+index.Name) + if endpoint.Version != APIVersion1 { + t.Fatal("Expected endpoint to be v1") + } + assertInsecureIndex(index) + + index.Name = makeURL("") + endpoint = expandEndpoint(index) + assertEqual(t, endpoint.String(), index.Name+"/v1/", index.Name+": Expected endpoint to be "+index.Name+"/v1/") + if endpoint.Version != APIVersion1 { + t.Fatal("Expected endpoint to be v1") + } + assertInsecureIndex(index) + + httpURL := makeURL("") + index.Name = strings.SplitN(httpURL, "://", 2)[1] + endpoint = expandEndpoint(index) + assertEqual(t, endpoint.String(), httpURL+"/v1/", index.Name+": Expected endpoint to be "+httpURL+"/v1/") + if endpoint.Version != APIVersion1 { + t.Fatal("Expected endpoint to be v1") + } + assertInsecureIndex(index) + + index.Name = makeHTTPSURL("/v1/") + endpoint = expandEndpoint(index) + assertEqual(t, endpoint.String(), index.Name, "Expected endpoint to be "+index.Name) + if endpoint.Version != APIVersion1 { + t.Fatal("Expected endpoint to be v1") + } + assertSecureIndex(index) + + index.Name = makeHTTPSURL("") + endpoint = expandEndpoint(index) + assertEqual(t, endpoint.String(), index.Name+"/v1/", index.Name+": Expected endpoint to be "+index.Name+"/v1/") + if endpoint.Version != APIVersion1 { + t.Fatal("Expected endpoint to be v1") + } + assertSecureIndex(index) + + httpsURL := makeHTTPSURL("") + index.Name = strings.SplitN(httpsURL, "://", 2)[1] + endpoint = expandEndpoint(index) + assertEqual(t, endpoint.String(), httpsURL+"/v1/", index.Name+": Expected endpoint to be "+httpsURL+"/v1/") + if endpoint.Version != APIVersion1 { + t.Fatal("Expected endpoint to be v1") + } + assertSecureIndex(index) + + badEndpoints := []string{ + "http://127.0.0.1/v1/", + "https://127.0.0.1/v1/", + "http://127.0.0.1", + "https://127.0.0.1", + "127.0.0.1", + } + for _, address := range badEndpoints { + index.Name = address + _, err := NewEndpoint(index, nil, APIVersionUnknown) + checkNotEqual(t, err, nil, "Expected error while expanding bad endpoint") + } +} + +func TestGetRemoteHistory(t *testing.T) { + r := spawnTestRegistrySession(t) + hist, err := r.GetRemoteHistory(imageID, makeURL("/v1/")) + if err != nil { + t.Fatal(err) + } + assertEqual(t, len(hist), 2, "Expected 2 images in history") + assertEqual(t, hist[0], imageID, "Expected "+imageID+"as first ancestry") + assertEqual(t, hist[1], "77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20", + "Unexpected second ancestry") +} + +func TestLookupRemoteImage(t *testing.T) { + r := spawnTestRegistrySession(t) + err := r.LookupRemoteImage(imageID, makeURL("/v1/")) + assertEqual(t, err, nil, "Expected error of remote lookup to nil") + if err := r.LookupRemoteImage("abcdef", makeURL("/v1/")); err == nil { + t.Fatal("Expected error of remote lookup to not nil") + } +} + +func TestGetRemoteImageJSON(t *testing.T) { + r := spawnTestRegistrySession(t) + json, size, err := r.GetRemoteImageJSON(imageID, makeURL("/v1/")) + if err != nil { + t.Fatal(err) + } + assertEqual(t, size, int64(154), "Expected size 154") + if len(json) <= 0 { + t.Fatal("Expected non-empty json") + } + + _, _, err = r.GetRemoteImageJSON("abcdef", makeURL("/v1/")) + if err == nil { + t.Fatal("Expected image not found error") + } +} + +func TestGetRemoteImageLayer(t *testing.T) { + r := spawnTestRegistrySession(t) + data, err := r.GetRemoteImageLayer(imageID, makeURL("/v1/"), 0) + if err != nil { + t.Fatal(err) + } + if data == nil { + t.Fatal("Expected non-nil data result") + } + + _, err = r.GetRemoteImageLayer("abcdef", makeURL("/v1/"), 0) + if err == nil { + t.Fatal("Expected image not found error") + } +} + +func TestGetRemoteTag(t *testing.T) { + r := spawnTestRegistrySession(t) + tag, err := r.GetRemoteTag([]string{makeURL("/v1/")}, REPO, "test") + if err != nil { + t.Fatal(err) + } + assertEqual(t, tag, imageID, "Expected tag test to map to "+imageID) + + _, err = r.GetRemoteTag([]string{makeURL("/v1/")}, "foo42/baz", "foo") + if err != ErrRepoNotFound { + t.Fatal("Expected ErrRepoNotFound error when fetching tag for bogus repo") + } +} + +func TestGetRemoteTags(t *testing.T) { + r := spawnTestRegistrySession(t) + tags, err := r.GetRemoteTags([]string{makeURL("/v1/")}, REPO) + if err != nil { + t.Fatal(err) + } + assertEqual(t, len(tags), 2, "Expected two tags") + assertEqual(t, tags["latest"], imageID, "Expected tag latest to map to "+imageID) + assertEqual(t, tags["test"], imageID, "Expected tag test to map to "+imageID) + + _, err = r.GetRemoteTags([]string{makeURL("/v1/")}, "foo42/baz") + if err != ErrRepoNotFound { + t.Fatal("Expected ErrRepoNotFound error when fetching tags for bogus repo") + } +} + +func TestGetRepositoryData(t *testing.T) { + r := spawnTestRegistrySession(t) + parsedURL, err := url.Parse(makeURL("/v1/")) + if err != nil { + t.Fatal(err) + } + host := "http://" + parsedURL.Host + "/v1/" + data, err := r.GetRepositoryData("foo42/bar") + if err != nil { + t.Fatal(err) + } + assertEqual(t, len(data.ImgList), 2, "Expected 2 images in ImgList") + assertEqual(t, len(data.Endpoints), 2, + fmt.Sprintf("Expected 2 endpoints in Endpoints, found %d instead", len(data.Endpoints))) + assertEqual(t, data.Endpoints[0], host, + fmt.Sprintf("Expected first endpoint to be %s but found %s instead", host, data.Endpoints[0])) + assertEqual(t, data.Endpoints[1], "http://test.example.com/v1/", + fmt.Sprintf("Expected first endpoint to be http://test.example.com/v1/ but found %s instead", data.Endpoints[1])) + +} + +func TestPushImageJSONRegistry(t *testing.T) { + r := spawnTestRegistrySession(t) + imgData := &ImgData{ + ID: "77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20", + Checksum: "sha256:1ac330d56e05eef6d438586545ceff7550d3bdcb6b19961f12c5ba714ee1bb37", + } + + err := r.PushImageJSONRegistry(imgData, []byte{0x42, 0xdf, 0x0}, makeURL("/v1/")) + if err != nil { + t.Fatal(err) + } +} + +func TestPushImageLayerRegistry(t *testing.T) { + r := spawnTestRegistrySession(t) + layer := strings.NewReader("") + _, _, err := r.PushImageLayerRegistry(imageID, layer, makeURL("/v1/"), []byte{}) + if err != nil { + t.Fatal(err) + } +} + +func TestValidateRepositoryName(t *testing.T) { + validRepoNames := []string{ + "docker/docker", + "library/debian", + "debian", + "docker.io/docker/docker", + "docker.io/library/debian", + "docker.io/debian", + "index.docker.io/docker/docker", + "index.docker.io/library/debian", + "index.docker.io/debian", + "127.0.0.1:5000/docker/docker", + "127.0.0.1:5000/library/debian", + "127.0.0.1:5000/debian", + "thisisthesongthatneverendsitgoesonandonandonthisisthesongthatnev", + } + invalidRepoNames := []string{ + "https://github.com/docker/docker", + "docker/Docker", + "-docker", + "-docker/docker", + "-docker.io/docker/docker", + "docker///docker", + "docker.io/docker/Docker", + "docker.io/docker///docker", + "1a3f5e7d9c1b3a5f7e9d1c3b5a7f9e1d3c5b7a9f1e3d5d7c9b1a3f5e7d9c1b3a", + "docker.io/1a3f5e7d9c1b3a5f7e9d1c3b5a7f9e1d3c5b7a9f1e3d5d7c9b1a3f5e7d9c1b3a", + } + + for _, name := range invalidRepoNames { + err := ValidateRepositoryName(name) + assertNotEqual(t, err, nil, "Expected invalid repo name: "+name) + } + + for _, name := range validRepoNames { + err := ValidateRepositoryName(name) + assertEqual(t, err, nil, "Expected valid repo name: "+name) + } + + err := ValidateRepositoryName(invalidRepoNames[0]) + assertEqual(t, err, ErrInvalidRepositoryName, "Expected ErrInvalidRepositoryName: "+invalidRepoNames[0]) +} + +func TestParseRepositoryInfo(t *testing.T) { + expectedRepoInfos := map[string]RepositoryInfo{ + "fooo/bar": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "fooo/bar", + LocalName: "fooo/bar", + CanonicalName: "docker.io/fooo/bar", + Official: false, + }, + "library/ubuntu": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "library/ubuntu", + LocalName: "ubuntu", + CanonicalName: "docker.io/library/ubuntu", + Official: true, + }, + "nonlibrary/ubuntu": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "nonlibrary/ubuntu", + LocalName: "nonlibrary/ubuntu", + CanonicalName: "docker.io/nonlibrary/ubuntu", + Official: false, + }, + "ubuntu": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "library/ubuntu", + LocalName: "ubuntu", + CanonicalName: "docker.io/library/ubuntu", + Official: true, + }, + "other/library": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "other/library", + LocalName: "other/library", + CanonicalName: "docker.io/other/library", + Official: false, + }, + "127.0.0.1:8000/private/moonbase": { + Index: &IndexInfo{ + Name: "127.0.0.1:8000", + Official: false, + }, + RemoteName: "private/moonbase", + LocalName: "127.0.0.1:8000/private/moonbase", + CanonicalName: "127.0.0.1:8000/private/moonbase", + Official: false, + }, + "127.0.0.1:8000/privatebase": { + Index: &IndexInfo{ + Name: "127.0.0.1:8000", + Official: false, + }, + RemoteName: "privatebase", + LocalName: "127.0.0.1:8000/privatebase", + CanonicalName: "127.0.0.1:8000/privatebase", + Official: false, + }, + "localhost:8000/private/moonbase": { + Index: &IndexInfo{ + Name: "localhost:8000", + Official: false, + }, + RemoteName: "private/moonbase", + LocalName: "localhost:8000/private/moonbase", + CanonicalName: "localhost:8000/private/moonbase", + Official: false, + }, + "localhost:8000/privatebase": { + Index: &IndexInfo{ + Name: "localhost:8000", + Official: false, + }, + RemoteName: "privatebase", + LocalName: "localhost:8000/privatebase", + CanonicalName: "localhost:8000/privatebase", + Official: false, + }, + "example.com/private/moonbase": { + Index: &IndexInfo{ + Name: "example.com", + Official: false, + }, + RemoteName: "private/moonbase", + LocalName: "example.com/private/moonbase", + CanonicalName: "example.com/private/moonbase", + Official: false, + }, + "example.com/privatebase": { + Index: &IndexInfo{ + Name: "example.com", + Official: false, + }, + RemoteName: "privatebase", + LocalName: "example.com/privatebase", + CanonicalName: "example.com/privatebase", + Official: false, + }, + "example.com:8000/private/moonbase": { + Index: &IndexInfo{ + Name: "example.com:8000", + Official: false, + }, + RemoteName: "private/moonbase", + LocalName: "example.com:8000/private/moonbase", + CanonicalName: "example.com:8000/private/moonbase", + Official: false, + }, + "example.com:8000/privatebase": { + Index: &IndexInfo{ + Name: "example.com:8000", + Official: false, + }, + RemoteName: "privatebase", + LocalName: "example.com:8000/privatebase", + CanonicalName: "example.com:8000/privatebase", + Official: false, + }, + "localhost/private/moonbase": { + Index: &IndexInfo{ + Name: "localhost", + Official: false, + }, + RemoteName: "private/moonbase", + LocalName: "localhost/private/moonbase", + CanonicalName: "localhost/private/moonbase", + Official: false, + }, + "localhost/privatebase": { + Index: &IndexInfo{ + Name: "localhost", + Official: false, + }, + RemoteName: "privatebase", + LocalName: "localhost/privatebase", + CanonicalName: "localhost/privatebase", + Official: false, + }, + IndexName + "/public/moonbase": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "public/moonbase", + LocalName: "public/moonbase", + CanonicalName: "docker.io/public/moonbase", + Official: false, + }, + "index." + IndexName + "/public/moonbase": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "public/moonbase", + LocalName: "public/moonbase", + CanonicalName: "docker.io/public/moonbase", + Official: false, + }, + "ubuntu-12.04-base": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "library/ubuntu-12.04-base", + LocalName: "ubuntu-12.04-base", + CanonicalName: "docker.io/library/ubuntu-12.04-base", + Official: true, + }, + IndexName + "/ubuntu-12.04-base": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "library/ubuntu-12.04-base", + LocalName: "ubuntu-12.04-base", + CanonicalName: "docker.io/library/ubuntu-12.04-base", + Official: true, + }, + "index." + IndexName + "/ubuntu-12.04-base": { + Index: &IndexInfo{ + Name: IndexName, + Official: true, + }, + RemoteName: "library/ubuntu-12.04-base", + LocalName: "ubuntu-12.04-base", + CanonicalName: "docker.io/library/ubuntu-12.04-base", + Official: true, + }, + } + + for reposName, expectedRepoInfo := range expectedRepoInfos { + repoInfo, err := ParseRepositoryInfo(reposName) + if err != nil { + t.Error(err) + } else { + checkEqual(t, repoInfo.Index.Name, expectedRepoInfo.Index.Name, reposName) + checkEqual(t, repoInfo.RemoteName, expectedRepoInfo.RemoteName, reposName) + checkEqual(t, repoInfo.LocalName, expectedRepoInfo.LocalName, reposName) + checkEqual(t, repoInfo.CanonicalName, expectedRepoInfo.CanonicalName, reposName) + checkEqual(t, repoInfo.Index.Official, expectedRepoInfo.Index.Official, reposName) + checkEqual(t, repoInfo.Official, expectedRepoInfo.Official, reposName) + } + } +} + +func TestNewIndexInfo(t *testing.T) { + testIndexInfo := func(config *ServiceConfig, expectedIndexInfos map[string]*IndexInfo) { + for indexName, expectedIndexInfo := range expectedIndexInfos { + index, err := config.NewIndexInfo(indexName) + if err != nil { + t.Fatal(err) + } else { + checkEqual(t, index.Name, expectedIndexInfo.Name, indexName+" name") + checkEqual(t, index.Official, expectedIndexInfo.Official, indexName+" is official") + checkEqual(t, index.Secure, expectedIndexInfo.Secure, indexName+" is secure") + checkEqual(t, len(index.Mirrors), len(expectedIndexInfo.Mirrors), indexName+" mirrors") + } + } + } + + config := NewServiceConfig(nil) + noMirrors := []string{} + expectedIndexInfos := map[string]*IndexInfo{ + IndexName: { + Name: IndexName, + Official: true, + Secure: true, + Mirrors: noMirrors, + }, + "index." + IndexName: { + Name: IndexName, + Official: true, + Secure: true, + Mirrors: noMirrors, + }, + "example.com": { + Name: "example.com", + Official: false, + Secure: true, + Mirrors: noMirrors, + }, + "127.0.0.1:5000": { + Name: "127.0.0.1:5000", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + } + testIndexInfo(config, expectedIndexInfos) + + publicMirrors := []string{"http://mirror1.local", "http://mirror2.local"} + config = makeServiceConfig(publicMirrors, []string{"example.com"}) + + expectedIndexInfos = map[string]*IndexInfo{ + IndexName: { + Name: IndexName, + Official: true, + Secure: true, + Mirrors: publicMirrors, + }, + "index." + IndexName: { + Name: IndexName, + Official: true, + Secure: true, + Mirrors: publicMirrors, + }, + "example.com": { + Name: "example.com", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "example.com:5000": { + Name: "example.com:5000", + Official: false, + Secure: true, + Mirrors: noMirrors, + }, + "127.0.0.1": { + Name: "127.0.0.1", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "127.0.0.1:5000": { + Name: "127.0.0.1:5000", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "other.com": { + Name: "other.com", + Official: false, + Secure: true, + Mirrors: noMirrors, + }, + } + testIndexInfo(config, expectedIndexInfos) + + config = makeServiceConfig(nil, []string{"42.42.0.0/16"}) + expectedIndexInfos = map[string]*IndexInfo{ + "example.com": { + Name: "example.com", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "example.com:5000": { + Name: "example.com:5000", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "127.0.0.1": { + Name: "127.0.0.1", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "127.0.0.1:5000": { + Name: "127.0.0.1:5000", + Official: false, + Secure: false, + Mirrors: noMirrors, + }, + "other.com": { + Name: "other.com", + Official: false, + Secure: true, + Mirrors: noMirrors, + }, + } + testIndexInfo(config, expectedIndexInfos) +} + +func TestMirrorEndpointLookup(t *testing.T) { + containsMirror := func(endpoints []APIEndpoint) bool { + for _, pe := range endpoints { + if pe.URL == "my.mirror" { + return true + } + } + return false + } + s := Service{Config: makeServiceConfig([]string{"my.mirror"}, nil)} + imageName := IndexName + "/test/image" + + pushAPIEndpoints, err := s.LookupPushEndpoints(imageName) + if err != nil { + t.Fatal(err) + } + if containsMirror(pushAPIEndpoints) { + t.Fatal("Push endpoint should not contain mirror") + } + + pullAPIEndpoints, err := s.LookupPullEndpoints(imageName) + if err != nil { + t.Fatal(err) + } + if !containsMirror(pullAPIEndpoints) { + t.Fatal("Pull endpoint should contain mirror") + } +} + +func TestPushRegistryTag(t *testing.T) { + r := spawnTestRegistrySession(t) + err := r.PushRegistryTag("foo42/bar", imageID, "stable", makeURL("/v1/")) + if err != nil { + t.Fatal(err) + } +} + +func TestPushImageJSONIndex(t *testing.T) { + r := spawnTestRegistrySession(t) + imgData := []*ImgData{ + { + ID: "77dbf71da1d00e3fbddc480176eac8994025630c6590d11cfc8fe1209c2a1d20", + Checksum: "sha256:1ac330d56e05eef6d438586545ceff7550d3bdcb6b19961f12c5ba714ee1bb37", + }, + { + ID: "42d718c941f5c532ac049bf0b0ab53f0062f09a03afd4aa4a02c098e46032b9d", + Checksum: "sha256:bea7bf2e4bacd479344b737328db47b18880d09096e6674165533aa994f5e9f2", + }, + } + repoData, err := r.PushImageJSONIndex("foo42/bar", imgData, false, nil) + if err != nil { + t.Fatal(err) + } + if repoData == nil { + t.Fatal("Expected RepositoryData object") + } + repoData, err = r.PushImageJSONIndex("foo42/bar", imgData, true, []string{r.indexEndpoint.String()}) + if err != nil { + t.Fatal(err) + } + if repoData == nil { + t.Fatal("Expected RepositoryData object") + } +} + +func TestSearchRepositories(t *testing.T) { + r := spawnTestRegistrySession(t) + results, err := r.SearchRepositories("fakequery") + if err != nil { + t.Fatal(err) + } + if results == nil { + t.Fatal("Expected non-nil SearchResults object") + } + assertEqual(t, results.NumResults, 1, "Expected 1 search results") + assertEqual(t, results.Query, "fakequery", "Expected 'fakequery' as query") + assertEqual(t, results.Results[0].StarCount, 42, "Expected 'fakeimage' to have 42 stars") +} + +func TestValidRemoteName(t *testing.T) { + validRepositoryNames := []string{ + // Sanity check. + "docker/docker", + + // Allow 64-character non-hexadecimal names (hexadecimal names are forbidden). + "thisisthesongthatneverendsitgoesonandonandonthisisthesongthatnev", + + // Allow embedded hyphens. + "docker-rules/docker", + + // Allow multiple hyphens as well. + "docker---rules/docker", + + //Username doc and image name docker being tested. + "doc/docker", + + // single character names are now allowed. + "d/docker", + "jess/t", + } + for _, repositoryName := range validRepositoryNames { + if err := validateRemoteName(repositoryName); err != nil { + t.Errorf("Repository name should be valid: %v. Error: %v", repositoryName, err) + } + } + + invalidRepositoryNames := []string{ + // Disallow capital letters. + "docker/Docker", + + // Only allow one slash. + "docker///docker", + + // Disallow 64-character hexadecimal. + "1a3f5e7d9c1b3a5f7e9d1c3b5a7f9e1d3c5b7a9f1e3d5d7c9b1a3f5e7d9c1b3a", + + // Disallow leading and trailing hyphens in namespace. + "-docker/docker", + "docker-/docker", + "-docker-/docker", + + // Don't allow underscores everywhere (as opposed to hyphens). + "____/____", + + "_docker/_docker", + + // Disallow consecutive underscores and periods. + "dock__er/docker", + "dock..er/docker", + "dock_.er/docker", + "dock-.er/docker", + + // No repository. + "docker/", + + //namespace too long + "this_is_not_a_valid_namespace_because_its_lenth_is_greater_than_255_this_is_not_a_valid_namespace_because_its_lenth_is_greater_than_255_this_is_not_a_valid_namespace_because_its_lenth_is_greater_than_255_this_is_not_a_valid_namespace_because_its_lenth_is_greater_than_255/docker", + } + for _, repositoryName := range invalidRepositoryNames { + if err := validateRemoteName(repositoryName); err == nil { + t.Errorf("Repository name should be invalid: %v", repositoryName) + } + } +} + +func TestTrustedLocation(t *testing.T) { + for _, url := range []string{"http://example.com", "https://example.com:7777", "http://docker.io", "http://test.docker.com", "https://fakedocker.com"} { + req, _ := http.NewRequest("GET", url, nil) + if trustedLocation(req) == true { + t.Fatalf("'%s' shouldn't be detected as a trusted location", url) + } + } + + for _, url := range []string{"https://docker.io", "https://test.docker.com:80"} { + req, _ := http.NewRequest("GET", url, nil) + if trustedLocation(req) == false { + t.Fatalf("'%s' should be detected as a trusted location", url) + } + } +} + +func TestAddRequiredHeadersToRedirectedRequests(t *testing.T) { + for _, urls := range [][]string{ + {"http://docker.io", "https://docker.com"}, + {"https://foo.docker.io:7777", "http://bar.docker.com"}, + {"https://foo.docker.io", "https://example.com"}, + } { + reqFrom, _ := http.NewRequest("GET", urls[0], nil) + reqFrom.Header.Add("Content-Type", "application/json") + reqFrom.Header.Add("Authorization", "super_secret") + reqTo, _ := http.NewRequest("GET", urls[1], nil) + + addRequiredHeadersToRedirectedRequests(reqTo, []*http.Request{reqFrom}) + + if len(reqTo.Header) != 1 { + t.Fatalf("Expected 1 headers, got %d", len(reqTo.Header)) + } + + if reqTo.Header.Get("Content-Type") != "application/json" { + t.Fatal("'Content-Type' should be 'application/json'") + } + + if reqTo.Header.Get("Authorization") != "" { + t.Fatal("'Authorization' should be empty") + } + } + + for _, urls := range [][]string{ + {"https://docker.io", "https://docker.com"}, + {"https://foo.docker.io:7777", "https://bar.docker.com"}, + } { + reqFrom, _ := http.NewRequest("GET", urls[0], nil) + reqFrom.Header.Add("Content-Type", "application/json") + reqFrom.Header.Add("Authorization", "super_secret") + reqTo, _ := http.NewRequest("GET", urls[1], nil) + + addRequiredHeadersToRedirectedRequests(reqTo, []*http.Request{reqFrom}) + + if len(reqTo.Header) != 2 { + t.Fatalf("Expected 2 headers, got %d", len(reqTo.Header)) + } + + if reqTo.Header.Get("Content-Type") != "application/json" { + t.Fatal("'Content-Type' should be 'application/json'") + } + + if reqTo.Header.Get("Authorization") != "super_secret" { + t.Fatal("'Authorization' should be 'super_secret'") + } + } +} + +func TestIsSecureIndex(t *testing.T) { + tests := []struct { + addr string + insecureRegistries []string + expected bool + }{ + {IndexName, nil, true}, + {"example.com", []string{}, true}, + {"example.com", []string{"example.com"}, false}, + {"localhost", []string{"localhost:5000"}, false}, + {"localhost:5000", []string{"localhost:5000"}, false}, + {"localhost", []string{"example.com"}, false}, + {"127.0.0.1:5000", []string{"127.0.0.1:5000"}, false}, + {"localhost", nil, false}, + {"localhost:5000", nil, false}, + {"127.0.0.1", nil, false}, + {"localhost", []string{"example.com"}, false}, + {"127.0.0.1", []string{"example.com"}, false}, + {"example.com", nil, true}, + {"example.com", []string{"example.com"}, false}, + {"127.0.0.1", []string{"example.com"}, false}, + {"127.0.0.1:5000", []string{"example.com"}, false}, + {"example.com:5000", []string{"42.42.0.0/16"}, false}, + {"example.com", []string{"42.42.0.0/16"}, false}, + {"example.com:5000", []string{"42.42.42.42/8"}, false}, + {"127.0.0.1:5000", []string{"127.0.0.0/8"}, false}, + {"42.42.42.42:5000", []string{"42.1.1.1/8"}, false}, + {"invalid.domain.com", []string{"42.42.0.0/16"}, true}, + {"invalid.domain.com", []string{"invalid.domain.com"}, false}, + {"invalid.domain.com:5000", []string{"invalid.domain.com"}, true}, + {"invalid.domain.com:5000", []string{"invalid.domain.com:5000"}, false}, + } + for _, tt := range tests { + config := makeServiceConfig(nil, tt.insecureRegistries) + if sec := config.isSecureIndex(tt.addr); sec != tt.expected { + t.Errorf("isSecureIndex failed for %q %v, expected %v got %v", tt.addr, tt.insecureRegistries, tt.expected, sec) + } + } +} + +type debugTransport struct { + http.RoundTripper + log func(...interface{}) +} + +func (tr debugTransport) RoundTrip(req *http.Request) (*http.Response, error) { + dump, err := httputil.DumpRequestOut(req, false) + if err != nil { + tr.log("could not dump request") + } + tr.log(string(dump)) + resp, err := tr.RoundTripper.RoundTrip(req) + if err != nil { + return nil, err + } + dump, err = httputil.DumpResponse(resp, false) + if err != nil { + tr.log("could not dump response") + } + tr.log(string(dump)) + return resp, err +} diff --git a/registry/service.go b/registry/service.go new file mode 100644 index 0000000000..6ac930d6e3 --- /dev/null +++ b/registry/service.go @@ -0,0 +1,162 @@ +package registry + +import ( + "crypto/tls" + "net/http" + "net/url" + + "github.com/docker/distribution/registry/client/auth" + "github.com/docker/docker/cliconfig" +) + +// Service is a registry service. It tracks configuration data such as a list +// of mirrors. +type Service struct { + Config *ServiceConfig +} + +// NewService returns a new instance of Service ready to be +// installed into an engine. +func NewService(options *Options) *Service { + return &Service{ + Config: NewServiceConfig(options), + } +} + +// Auth contacts the public registry with the provided credentials, +// and returns OK if authentication was successful. +// It can be used to verify the validity of a client's credentials. +func (s *Service) Auth(authConfig *cliconfig.AuthConfig) (string, error) { + addr := authConfig.ServerAddress + if addr == "" { + // Use the official registry address if not specified. + addr = IndexServer + } + index, err := s.ResolveIndex(addr) + if err != nil { + return "", err + } + + endpointVersion := APIVersion(APIVersionUnknown) + if V2Only { + // Override the endpoint to only attempt a v2 ping + endpointVersion = APIVersion2 + } + + endpoint, err := NewEndpoint(index, nil, endpointVersion) + if err != nil { + return "", err + } + authConfig.ServerAddress = endpoint.String() + return Login(authConfig, endpoint) +} + +// Search queries the public registry for images matching the specified +// search terms, and returns the results. +func (s *Service) Search(term string, authConfig *cliconfig.AuthConfig, headers map[string][]string) (*SearchResults, error) { + + repoInfo, err := s.ResolveRepositoryBySearch(term) + if err != nil { + return nil, err + } + + // *TODO: Search multiple indexes. + endpoint, err := NewEndpoint(repoInfo.Index, http.Header(headers), APIVersionUnknown) + if err != nil { + return nil, err + } + + r, err := NewSession(endpoint.client, authConfig, endpoint) + if err != nil { + return nil, err + } + return r.SearchRepositories(repoInfo.GetSearchTerm()) +} + +// ResolveRepository splits a repository name into its components +// and configuration of the associated registry. +func (s *Service) ResolveRepository(name string) (*RepositoryInfo, error) { + return s.Config.NewRepositoryInfo(name, false) +} + +// ResolveRepositoryBySearch splits a repository name into its components +// and configuration of the associated registry. +func (s *Service) ResolveRepositoryBySearch(name string) (*RepositoryInfo, error) { + return s.Config.NewRepositoryInfo(name, true) +} + +// ResolveIndex takes indexName and returns index info +func (s *Service) ResolveIndex(name string) (*IndexInfo, error) { + return s.Config.NewIndexInfo(name) +} + +// APIEndpoint represents a remote API endpoint +type APIEndpoint struct { + Mirror bool + URL string + Version APIVersion + Official bool + TrimHostname bool + TLSConfig *tls.Config + VersionHeader string + Versions []auth.APIVersion +} + +// ToV1Endpoint returns a V1 API endpoint based on the APIEndpoint +func (e APIEndpoint) ToV1Endpoint(metaHeaders http.Header) (*Endpoint, error) { + return newEndpoint(e.URL, e.TLSConfig, metaHeaders) +} + +// TLSConfig constructs a client TLS configuration based on server defaults +func (s *Service) TLSConfig(hostname string) (*tls.Config, error) { + return newTLSConfig(hostname, s.Config.isSecureIndex(hostname)) +} + +func (s *Service) tlsConfigForMirror(mirror string) (*tls.Config, error) { + mirrorURL, err := url.Parse(mirror) + if err != nil { + return nil, err + } + return s.TLSConfig(mirrorURL.Host) +} + +// LookupPullEndpoints creates an list of endpoints to try to pull from, in order of preference. +// It gives preference to v2 endpoints over v1, mirrors over the actual +// registry, and HTTPS over plain HTTP. +func (s *Service) LookupPullEndpoints(repoName string) (endpoints []APIEndpoint, err error) { + return s.lookupEndpoints(repoName) +} + +// LookupPushEndpoints creates an list of endpoints to try to push to, in order of preference. +// It gives preference to v2 endpoints over v1, and HTTPS over plain HTTP. +// Mirrors are not included. +func (s *Service) LookupPushEndpoints(repoName string) (endpoints []APIEndpoint, err error) { + allEndpoints, err := s.lookupEndpoints(repoName) + if err == nil { + for _, endpoint := range allEndpoints { + if !endpoint.Mirror { + endpoints = append(endpoints, endpoint) + } + } + } + return endpoints, err +} + +func (s *Service) lookupEndpoints(repoName string) (endpoints []APIEndpoint, err error) { + endpoints, err = s.lookupV2Endpoints(repoName) + if err != nil { + return nil, err + } + + if V2Only { + return endpoints, nil + } + + legacyEndpoints, err := s.lookupV1Endpoints(repoName) + if err != nil { + return nil, err + } + endpoints = append(endpoints, legacyEndpoints...) + + return endpoints, nil +} diff --git a/registry/service_v1.go b/registry/service_v1.go new file mode 100644 index 0000000000..ddb78ee60a --- /dev/null +++ b/registry/service_v1.go @@ -0,0 +1,54 @@ +package registry + +import ( + "fmt" + "strings" + + "github.com/docker/docker/pkg/tlsconfig" +) + +func (s *Service) lookupV1Endpoints(repoName string) (endpoints []APIEndpoint, err error) { + var cfg = tlsconfig.ServerDefault + tlsConfig := &cfg + if strings.HasPrefix(repoName, DefaultNamespace+"/") { + endpoints = append(endpoints, APIEndpoint{ + URL: DefaultV1Registry, + Version: APIVersion1, + Official: true, + TrimHostname: true, + TLSConfig: tlsConfig, + }) + return endpoints, nil + } + + slashIndex := strings.IndexRune(repoName, '/') + if slashIndex <= 0 { + return nil, fmt.Errorf("invalid repo name: missing '/': %s", repoName) + } + hostname := repoName[:slashIndex] + + tlsConfig, err = s.TLSConfig(hostname) + if err != nil { + return nil, err + } + + endpoints = []APIEndpoint{ + { + URL: "https://" + hostname, + Version: APIVersion1, + TrimHostname: true, + TLSConfig: tlsConfig, + }, + } + + if tlsConfig.InsecureSkipVerify { + endpoints = append(endpoints, APIEndpoint{ // or this + URL: "http://" + hostname, + Version: APIVersion1, + TrimHostname: true, + // used to check if supposed to be secure via InsecureSkipVerify + TLSConfig: tlsConfig, + }) + } + return endpoints, nil +} diff --git a/registry/service_v2.go b/registry/service_v2.go new file mode 100644 index 0000000000..70d5fd710e --- /dev/null +++ b/registry/service_v2.go @@ -0,0 +1,83 @@ +package registry + +import ( + "fmt" + "strings" + + "github.com/docker/distribution/registry/client/auth" + "github.com/docker/docker/pkg/tlsconfig" +) + +func (s *Service) lookupV2Endpoints(repoName string) (endpoints []APIEndpoint, err error) { + var cfg = tlsconfig.ServerDefault + tlsConfig := &cfg + if strings.HasPrefix(repoName, DefaultNamespace+"/") { + // v2 mirrors + for _, mirror := range s.Config.Mirrors { + mirrorTLSConfig, err := s.tlsConfigForMirror(mirror) + if err != nil { + return nil, err + } + endpoints = append(endpoints, APIEndpoint{ + URL: mirror, + // guess mirrors are v2 + Version: APIVersion2, + Mirror: true, + TrimHostname: true, + TLSConfig: mirrorTLSConfig, + }) + } + // v2 registry + endpoints = append(endpoints, APIEndpoint{ + URL: DefaultV2Registry, + Version: APIVersion2, + Official: true, + TrimHostname: true, + TLSConfig: tlsConfig, + }) + + return endpoints, nil + } + + slashIndex := strings.IndexRune(repoName, '/') + if slashIndex <= 0 { + return nil, fmt.Errorf("invalid repo name: missing '/': %s", repoName) + } + hostname := repoName[:slashIndex] + + tlsConfig, err = s.TLSConfig(hostname) + if err != nil { + return nil, err + } + + v2Versions := []auth.APIVersion{ + { + Type: "registry", + Version: "2.0", + }, + } + endpoints = []APIEndpoint{ + { + URL: "https://" + hostname, + Version: APIVersion2, + TrimHostname: true, + TLSConfig: tlsConfig, + VersionHeader: DefaultRegistryVersionHeader, + Versions: v2Versions, + }, + } + + if tlsConfig.InsecureSkipVerify { + endpoints = append(endpoints, APIEndpoint{ + URL: "http://" + hostname, + Version: APIVersion2, + TrimHostname: true, + // used to check if supposed to be secure via InsecureSkipVerify + TLSConfig: tlsConfig, + VersionHeader: DefaultRegistryVersionHeader, + Versions: v2Versions, + }) + } + + return endpoints, nil +} diff --git a/registry/session.go b/registry/session.go new file mode 100644 index 0000000000..2a20d32190 --- /dev/null +++ b/registry/session.go @@ -0,0 +1,761 @@ +package registry + +import ( + "bytes" + "crypto/sha256" + "errors" + "sync" + // this is required for some certificates + _ "crypto/sha512" + "encoding/hex" + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/http/cookiejar" + "net/url" + "strconv" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/tarsum" + "github.com/docker/docker/utils" +) + +var ( + // ErrRepoNotFound is returned if the repository didn't exist on the + // remote side + ErrRepoNotFound = errors.New("Repository not found") +) + +// A Session is used to communicate with a V1 registry +type Session struct { + indexEndpoint *Endpoint + client *http.Client + // TODO(tiborvass): remove authConfig + authConfig *cliconfig.AuthConfig + id string +} + +type authTransport struct { + http.RoundTripper + *cliconfig.AuthConfig + + alwaysSetBasicAuth bool + token []string + + mu sync.Mutex // guards modReq + modReq map[*http.Request]*http.Request // original -> modified +} + +// AuthTransport handles the auth layer when communicating with a v1 registry (private or official) +// +// For private v1 registries, set alwaysSetBasicAuth to true. +// +// For the official v1 registry, if there isn't already an Authorization header in the request, +// but there is an X-Docker-Token header set to true, then Basic Auth will be used to set the Authorization header. +// After sending the request with the provided base http.RoundTripper, if an X-Docker-Token header, representing +// a token, is present in the response, then it gets cached and sent in the Authorization header of all subsequent +// requests. +// +// If the server sends a token without the client having requested it, it is ignored. +// +// This RoundTripper also has a CancelRequest method important for correct timeout handling. +func AuthTransport(base http.RoundTripper, authConfig *cliconfig.AuthConfig, alwaysSetBasicAuth bool) http.RoundTripper { + if base == nil { + base = http.DefaultTransport + } + return &authTransport{ + RoundTripper: base, + AuthConfig: authConfig, + alwaysSetBasicAuth: alwaysSetBasicAuth, + modReq: make(map[*http.Request]*http.Request), + } +} + +// cloneRequest returns a clone of the provided *http.Request. +// The clone is a shallow copy of the struct and its Header map. +func cloneRequest(r *http.Request) *http.Request { + // shallow copy of the struct + r2 := new(http.Request) + *r2 = *r + // deep copy of the Header + r2.Header = make(http.Header, len(r.Header)) + for k, s := range r.Header { + r2.Header[k] = append([]string(nil), s...) + } + + return r2 +} + +// RoundTrip changes a HTTP request's headers to add the necessary +// authentication-related headers +func (tr *authTransport) RoundTrip(orig *http.Request) (*http.Response, error) { + // Authorization should not be set on 302 redirect for untrusted locations. + // This logic mirrors the behavior in addRequiredHeadersToRedirectedRequests. + // As the authorization logic is currently implemented in RoundTrip, + // a 302 redirect is detected by looking at the Referer header as go http package adds said header. + // This is safe as Docker doesn't set Referer in other scenarios. + if orig.Header.Get("Referer") != "" && !trustedLocation(orig) { + return tr.RoundTripper.RoundTrip(orig) + } + + req := cloneRequest(orig) + tr.mu.Lock() + tr.modReq[orig] = req + tr.mu.Unlock() + + if tr.alwaysSetBasicAuth { + if tr.AuthConfig == nil { + return nil, errors.New("unexpected error: empty auth config") + } + req.SetBasicAuth(tr.Username, tr.Password) + return tr.RoundTripper.RoundTrip(req) + } + + // Don't override + if req.Header.Get("Authorization") == "" { + if req.Header.Get("X-Docker-Token") == "true" && tr.AuthConfig != nil && len(tr.Username) > 0 { + req.SetBasicAuth(tr.Username, tr.Password) + } else if len(tr.token) > 0 { + req.Header.Set("Authorization", "Token "+strings.Join(tr.token, ",")) + } + } + resp, err := tr.RoundTripper.RoundTrip(req) + if err != nil { + delete(tr.modReq, orig) + return nil, err + } + if len(resp.Header["X-Docker-Token"]) > 0 { + tr.token = resp.Header["X-Docker-Token"] + } + resp.Body = &ioutils.OnEOFReader{ + Rc: resp.Body, + Fn: func() { + tr.mu.Lock() + delete(tr.modReq, orig) + tr.mu.Unlock() + }, + } + return resp, nil +} + +// CancelRequest cancels an in-flight request by closing its connection. +func (tr *authTransport) CancelRequest(req *http.Request) { + type canceler interface { + CancelRequest(*http.Request) + } + if cr, ok := tr.RoundTripper.(canceler); ok { + tr.mu.Lock() + modReq := tr.modReq[req] + delete(tr.modReq, req) + tr.mu.Unlock() + cr.CancelRequest(modReq) + } +} + +// NewSession creates a new session +// TODO(tiborvass): remove authConfig param once registry client v2 is vendored +func NewSession(client *http.Client, authConfig *cliconfig.AuthConfig, endpoint *Endpoint) (r *Session, err error) { + r = &Session{ + authConfig: authConfig, + client: client, + indexEndpoint: endpoint, + id: stringid.GenerateRandomID(), + } + + var alwaysSetBasicAuth bool + + // If we're working with a standalone private registry over HTTPS, send Basic Auth headers + // alongside all our requests. + if endpoint.VersionString(1) != IndexServer && endpoint.URL.Scheme == "https" { + info, err := endpoint.Ping() + if err != nil { + return nil, err + } + if info.Standalone && authConfig != nil { + logrus.Debugf("Endpoint %s is eligible for private registry. Enabling decorator.", endpoint.String()) + alwaysSetBasicAuth = true + } + } + + // Annotate the transport unconditionally so that v2 can + // properly fallback on v1 when an image is not found. + client.Transport = AuthTransport(client.Transport, authConfig, alwaysSetBasicAuth) + + jar, err := cookiejar.New(nil) + if err != nil { + return nil, errors.New("cookiejar.New is not supposed to return an error") + } + client.Jar = jar + + return r, nil +} + +// ID returns this registry session's ID. +func (r *Session) ID() string { + return r.id +} + +// GetRemoteHistory retrieves the history of a given image from the registry. +// It returns a list of the parent's JSON files (including the requested image). +func (r *Session) GetRemoteHistory(imgID, registry string) ([]string, error) { + res, err := r.client.Get(registry + "images/" + imgID + "/ancestry") + if err != nil { + return nil, err + } + defer res.Body.Close() + if res.StatusCode != 200 { + if res.StatusCode == 401 { + return nil, errLoginRequired + } + return nil, httputils.NewHTTPRequestError(fmt.Sprintf("Server error: %d trying to fetch remote history for %s", res.StatusCode, imgID), res) + } + + var history []string + if err := json.NewDecoder(res.Body).Decode(&history); err != nil { + return nil, fmt.Errorf("Error while reading the http response: %v", err) + } + + logrus.Debugf("Ancestry: %v", history) + return history, nil +} + +// LookupRemoteImage checks if an image exists in the registry +func (r *Session) LookupRemoteImage(imgID, registry string) error { + res, err := r.client.Get(registry + "images/" + imgID + "/json") + if err != nil { + return err + } + res.Body.Close() + if res.StatusCode != 200 { + return httputils.NewHTTPRequestError(fmt.Sprintf("HTTP code %d", res.StatusCode), res) + } + return nil +} + +// GetRemoteImageJSON retrieves an image's JSON metadata from the registry. +func (r *Session) GetRemoteImageJSON(imgID, registry string) ([]byte, int64, error) { + res, err := r.client.Get(registry + "images/" + imgID + "/json") + if err != nil { + return nil, -1, fmt.Errorf("Failed to download json: %s", err) + } + defer res.Body.Close() + if res.StatusCode != 200 { + return nil, -1, httputils.NewHTTPRequestError(fmt.Sprintf("HTTP code %d", res.StatusCode), res) + } + // if the size header is not present, then set it to '-1' + imageSize := int64(-1) + if hdr := res.Header.Get("X-Docker-Size"); hdr != "" { + imageSize, err = strconv.ParseInt(hdr, 10, 64) + if err != nil { + return nil, -1, err + } + } + + jsonString, err := ioutil.ReadAll(res.Body) + if err != nil { + return nil, -1, fmt.Errorf("Failed to parse downloaded json: %v (%s)", err, jsonString) + } + return jsonString, imageSize, nil +} + +// GetRemoteImageLayer retrieves an image layer from the registry +func (r *Session) GetRemoteImageLayer(imgID, registry string, imgSize int64) (io.ReadCloser, error) { + var ( + retries = 5 + statusCode = 0 + res *http.Response + err error + imageURL = fmt.Sprintf("%simages/%s/layer", registry, imgID) + ) + + req, err := http.NewRequest("GET", imageURL, nil) + if err != nil { + return nil, fmt.Errorf("Error while getting from the server: %v", err) + } + // TODO(tiborvass): why are we doing retries at this level? + // These retries should be generic to both v1 and v2 + for i := 1; i <= retries; i++ { + statusCode = 0 + res, err = r.client.Do(req) + if err == nil { + break + } + logrus.Debugf("Error contacting registry %s: %v", registry, err) + if res != nil { + if res.Body != nil { + res.Body.Close() + } + statusCode = res.StatusCode + } + if i == retries { + return nil, fmt.Errorf("Server error: Status %d while fetching image layer (%s)", + statusCode, imgID) + } + time.Sleep(time.Duration(i) * 5 * time.Second) + } + + if res.StatusCode != 200 { + res.Body.Close() + return nil, fmt.Errorf("Server error: Status %d while fetching image layer (%s)", + res.StatusCode, imgID) + } + + if res.Header.Get("Accept-Ranges") == "bytes" && imgSize > 0 { + logrus.Debugf("server supports resume") + return httputils.ResumableRequestReaderWithInitialResponse(r.client, req, 5, imgSize, res), nil + } + logrus.Debugf("server doesn't support resume") + return res.Body, nil +} + +// GetRemoteTag retrieves the tag named in the askedTag argument from the given +// repository. It queries each of the registries supplied in the registries +// argument, and returns data from the first one that answers the query +// successfully. +func (r *Session) GetRemoteTag(registries []string, repository string, askedTag string) (string, error) { + if strings.Count(repository, "/") == 0 { + // This will be removed once the registry supports auto-resolution on + // the "library" namespace + repository = "library/" + repository + } + for _, host := range registries { + endpoint := fmt.Sprintf("%srepositories/%s/tags/%s", host, repository, askedTag) + res, err := r.client.Get(endpoint) + if err != nil { + return "", err + } + + logrus.Debugf("Got status code %d from %s", res.StatusCode, endpoint) + defer res.Body.Close() + + if res.StatusCode == 404 { + return "", ErrRepoNotFound + } + if res.StatusCode != 200 { + continue + } + + var tagID string + if err := json.NewDecoder(res.Body).Decode(&tagID); err != nil { + return "", err + } + return tagID, nil + } + return "", fmt.Errorf("Could not reach any registry endpoint") +} + +// GetRemoteTags retrieves all tags from the given repository. It queries each +// of the registries supplied in the registries argument, and returns data from +// the first one that answers the query successfully. It returns a map with +// tag names as the keys and image IDs as the values. +func (r *Session) GetRemoteTags(registries []string, repository string) (map[string]string, error) { + if strings.Count(repository, "/") == 0 { + // This will be removed once the registry supports auto-resolution on + // the "library" namespace + repository = "library/" + repository + } + for _, host := range registries { + endpoint := fmt.Sprintf("%srepositories/%s/tags", host, repository) + res, err := r.client.Get(endpoint) + if err != nil { + return nil, err + } + + logrus.Debugf("Got status code %d from %s", res.StatusCode, endpoint) + defer res.Body.Close() + + if res.StatusCode == 404 { + return nil, ErrRepoNotFound + } + if res.StatusCode != 200 { + continue + } + + result := make(map[string]string) + if err := json.NewDecoder(res.Body).Decode(&result); err != nil { + return nil, err + } + return result, nil + } + return nil, fmt.Errorf("Could not reach any registry endpoint") +} + +func buildEndpointsList(headers []string, indexEp string) ([]string, error) { + var endpoints []string + parsedURL, err := url.Parse(indexEp) + if err != nil { + return nil, err + } + var urlScheme = parsedURL.Scheme + // The registry's URL scheme has to match the Index' + for _, ep := range headers { + epList := strings.Split(ep, ",") + for _, epListElement := range epList { + endpoints = append( + endpoints, + fmt.Sprintf("%s://%s/v1/", urlScheme, strings.TrimSpace(epListElement))) + } + } + return endpoints, nil +} + +// GetRepositoryData returns lists of images and endpoints for the repository +func (r *Session) GetRepositoryData(remote string) (*RepositoryData, error) { + repositoryTarget := fmt.Sprintf("%srepositories/%s/images", r.indexEndpoint.VersionString(1), remote) + + logrus.Debugf("[registry] Calling GET %s", repositoryTarget) + + req, err := http.NewRequest("GET", repositoryTarget, nil) + if err != nil { + return nil, err + } + // this will set basic auth in r.client.Transport and send cached X-Docker-Token headers for all subsequent requests + req.Header.Set("X-Docker-Token", "true") + res, err := r.client.Do(req) + if err != nil { + // check if the error is because of i/o timeout + // and return a non-obtuse error message for users + // "Get https://index.docker.io/v1/repositories/library/busybox/images: i/o timeout" + // was a top search on the docker user forum + if utils.IsTimeout(err) { + return nil, fmt.Errorf("Network timed out while trying to connect to %s. You may want to check your internet connection or if you are behind a proxy.", repositoryTarget) + } + return nil, fmt.Errorf("Error while pulling image: %v", err) + } + defer res.Body.Close() + if res.StatusCode == 401 { + return nil, errLoginRequired + } + // TODO: Right now we're ignoring checksums in the response body. + // In the future, we need to use them to check image validity. + if res.StatusCode == 404 { + return nil, httputils.NewHTTPRequestError(fmt.Sprintf("HTTP code: %d", res.StatusCode), res) + } else if res.StatusCode != 200 { + errBody, err := ioutil.ReadAll(res.Body) + if err != nil { + logrus.Debugf("Error reading response body: %s", err) + } + return nil, httputils.NewHTTPRequestError(fmt.Sprintf("Error: Status %d trying to pull repository %s: %q", res.StatusCode, remote, errBody), res) + } + + var endpoints []string + if res.Header.Get("X-Docker-Endpoints") != "" { + endpoints, err = buildEndpointsList(res.Header["X-Docker-Endpoints"], r.indexEndpoint.VersionString(1)) + if err != nil { + return nil, err + } + } else { + // Assume the endpoint is on the same host + endpoints = append(endpoints, fmt.Sprintf("%s://%s/v1/", r.indexEndpoint.URL.Scheme, req.URL.Host)) + } + + remoteChecksums := []*ImgData{} + if err := json.NewDecoder(res.Body).Decode(&remoteChecksums); err != nil { + return nil, err + } + + // Forge a better object from the retrieved data + imgsData := make(map[string]*ImgData, len(remoteChecksums)) + for _, elem := range remoteChecksums { + imgsData[elem.ID] = elem + } + + return &RepositoryData{ + ImgList: imgsData, + Endpoints: endpoints, + }, nil +} + +// PushImageChecksumRegistry uploads checksums for an image +func (r *Session) PushImageChecksumRegistry(imgData *ImgData, registry string) error { + u := registry + "images/" + imgData.ID + "/checksum" + + logrus.Debugf("[registry] Calling PUT %s", u) + + req, err := http.NewRequest("PUT", u, nil) + if err != nil { + return err + } + req.Header.Set("X-Docker-Checksum", imgData.Checksum) + req.Header.Set("X-Docker-Checksum-Payload", imgData.ChecksumPayload) + + res, err := r.client.Do(req) + if err != nil { + return fmt.Errorf("Failed to upload metadata: %v", err) + } + defer res.Body.Close() + if len(res.Cookies()) > 0 { + r.client.Jar.SetCookies(req.URL, res.Cookies()) + } + if res.StatusCode != 200 { + errBody, err := ioutil.ReadAll(res.Body) + if err != nil { + return fmt.Errorf("HTTP code %d while uploading metadata and error when trying to parse response body: %s", res.StatusCode, err) + } + var jsonBody map[string]string + if err := json.Unmarshal(errBody, &jsonBody); err != nil { + errBody = []byte(err.Error()) + } else if jsonBody["error"] == "Image already exists" { + return ErrAlreadyExists + } + return fmt.Errorf("HTTP code %d while uploading metadata: %q", res.StatusCode, errBody) + } + return nil +} + +// PushImageJSONRegistry pushes JSON metadata for a local image to the registry +func (r *Session) PushImageJSONRegistry(imgData *ImgData, jsonRaw []byte, registry string) error { + + u := registry + "images/" + imgData.ID + "/json" + + logrus.Debugf("[registry] Calling PUT %s", u) + + req, err := http.NewRequest("PUT", u, bytes.NewReader(jsonRaw)) + if err != nil { + return err + } + req.Header.Add("Content-type", "application/json") + + res, err := r.client.Do(req) + if err != nil { + return fmt.Errorf("Failed to upload metadata: %s", err) + } + defer res.Body.Close() + if res.StatusCode == 401 && strings.HasPrefix(registry, "http://") { + return httputils.NewHTTPRequestError("HTTP code 401, Docker will not send auth headers over HTTP.", res) + } + if res.StatusCode != 200 { + errBody, err := ioutil.ReadAll(res.Body) + if err != nil { + return httputils.NewHTTPRequestError(fmt.Sprintf("HTTP code %d while uploading metadata and error when trying to parse response body: %s", res.StatusCode, err), res) + } + var jsonBody map[string]string + if err := json.Unmarshal(errBody, &jsonBody); err != nil { + errBody = []byte(err.Error()) + } else if jsonBody["error"] == "Image already exists" { + return ErrAlreadyExists + } + return httputils.NewHTTPRequestError(fmt.Sprintf("HTTP code %d while uploading metadata: %q", res.StatusCode, errBody), res) + } + return nil +} + +// PushImageLayerRegistry sends the checksum of an image layer to the registry +func (r *Session) PushImageLayerRegistry(imgID string, layer io.Reader, registry string, jsonRaw []byte) (checksum string, checksumPayload string, err error) { + u := registry + "images/" + imgID + "/layer" + + logrus.Debugf("[registry] Calling PUT %s", u) + + tarsumLayer, err := tarsum.NewTarSum(layer, false, tarsum.Version0) + if err != nil { + return "", "", err + } + h := sha256.New() + h.Write(jsonRaw) + h.Write([]byte{'\n'}) + checksumLayer := io.TeeReader(tarsumLayer, h) + + req, err := http.NewRequest("PUT", u, checksumLayer) + if err != nil { + return "", "", err + } + req.Header.Add("Content-Type", "application/octet-stream") + req.ContentLength = -1 + req.TransferEncoding = []string{"chunked"} + res, err := r.client.Do(req) + if err != nil { + return "", "", fmt.Errorf("Failed to upload layer: %v", err) + } + if rc, ok := layer.(io.Closer); ok { + if err := rc.Close(); err != nil { + return "", "", err + } + } + defer res.Body.Close() + + if res.StatusCode != 200 { + errBody, err := ioutil.ReadAll(res.Body) + if err != nil { + return "", "", httputils.NewHTTPRequestError(fmt.Sprintf("HTTP code %d while uploading metadata and error when trying to parse response body: %s", res.StatusCode, err), res) + } + return "", "", httputils.NewHTTPRequestError(fmt.Sprintf("Received HTTP code %d while uploading layer: %q", res.StatusCode, errBody), res) + } + + checksumPayload = "sha256:" + hex.EncodeToString(h.Sum(nil)) + return tarsumLayer.Sum(jsonRaw), checksumPayload, nil +} + +// PushRegistryTag pushes a tag on the registry. +// Remote has the format '/ +func (r *Session) PushRegistryTag(remote, revision, tag, registry string) error { + // "jsonify" the string + revision = "\"" + revision + "\"" + path := fmt.Sprintf("repositories/%s/tags/%s", remote, tag) + + req, err := http.NewRequest("PUT", registry+path, strings.NewReader(revision)) + if err != nil { + return err + } + req.Header.Add("Content-type", "application/json") + req.ContentLength = int64(len(revision)) + res, err := r.client.Do(req) + if err != nil { + return err + } + res.Body.Close() + if res.StatusCode != 200 && res.StatusCode != 201 { + return httputils.NewHTTPRequestError(fmt.Sprintf("Internal server error: %d trying to push tag %s on %s", res.StatusCode, tag, remote), res) + } + return nil +} + +// PushImageJSONIndex uploads an image list to the repository +func (r *Session) PushImageJSONIndex(remote string, imgList []*ImgData, validate bool, regs []string) (*RepositoryData, error) { + cleanImgList := []*ImgData{} + if validate { + for _, elem := range imgList { + if elem.Checksum != "" { + cleanImgList = append(cleanImgList, elem) + } + } + } else { + cleanImgList = imgList + } + + imgListJSON, err := json.Marshal(cleanImgList) + if err != nil { + return nil, err + } + var suffix string + if validate { + suffix = "images" + } + u := fmt.Sprintf("%srepositories/%s/%s", r.indexEndpoint.VersionString(1), remote, suffix) + logrus.Debugf("[registry] PUT %s", u) + logrus.Debugf("Image list pushed to index:\n%s", imgListJSON) + headers := map[string][]string{ + "Content-type": {"application/json"}, + // this will set basic auth in r.client.Transport and send cached X-Docker-Token headers for all subsequent requests + "X-Docker-Token": {"true"}, + } + if validate { + headers["X-Docker-Endpoints"] = regs + } + + // Redirect if necessary + var res *http.Response + for { + if res, err = r.putImageRequest(u, headers, imgListJSON); err != nil { + return nil, err + } + if !shouldRedirect(res) { + break + } + res.Body.Close() + u = res.Header.Get("Location") + logrus.Debugf("Redirected to %s", u) + } + defer res.Body.Close() + + if res.StatusCode == 401 { + return nil, errLoginRequired + } + + var tokens, endpoints []string + if !validate { + if res.StatusCode != 200 && res.StatusCode != 201 { + errBody, err := ioutil.ReadAll(res.Body) + if err != nil { + logrus.Debugf("Error reading response body: %s", err) + } + return nil, httputils.NewHTTPRequestError(fmt.Sprintf("Error: Status %d trying to push repository %s: %q", res.StatusCode, remote, errBody), res) + } + tokens = res.Header["X-Docker-Token"] + logrus.Debugf("Auth token: %v", tokens) + + if res.Header.Get("X-Docker-Endpoints") == "" { + return nil, fmt.Errorf("Index response didn't contain any endpoints") + } + endpoints, err = buildEndpointsList(res.Header["X-Docker-Endpoints"], r.indexEndpoint.VersionString(1)) + if err != nil { + return nil, err + } + } else { + if res.StatusCode != 204 { + errBody, err := ioutil.ReadAll(res.Body) + if err != nil { + logrus.Debugf("Error reading response body: %s", err) + } + return nil, httputils.NewHTTPRequestError(fmt.Sprintf("Error: Status %d trying to push checksums %s: %q", res.StatusCode, remote, errBody), res) + } + } + + return &RepositoryData{ + Endpoints: endpoints, + }, nil +} + +func (r *Session) putImageRequest(u string, headers map[string][]string, body []byte) (*http.Response, error) { + req, err := http.NewRequest("PUT", u, bytes.NewReader(body)) + if err != nil { + return nil, err + } + req.ContentLength = int64(len(body)) + for k, v := range headers { + req.Header[k] = v + } + response, err := r.client.Do(req) + if err != nil { + return nil, err + } + return response, nil +} + +func shouldRedirect(response *http.Response) bool { + return response.StatusCode >= 300 && response.StatusCode < 400 +} + +// SearchRepositories performs a search against the remote repository +func (r *Session) SearchRepositories(term string) (*SearchResults, error) { + logrus.Debugf("Index server: %s", r.indexEndpoint) + u := r.indexEndpoint.VersionString(1) + "search?q=" + url.QueryEscape(term) + + req, err := http.NewRequest("GET", u, nil) + if err != nil { + return nil, fmt.Errorf("Error while getting from the server: %v", err) + } + // Have the AuthTransport send authentication, when logged in. + req.Header.Set("X-Docker-Token", "true") + res, err := r.client.Do(req) + if err != nil { + return nil, err + } + defer res.Body.Close() + if res.StatusCode != 200 { + return nil, httputils.NewHTTPRequestError(fmt.Sprintf("Unexpected status code %d", res.StatusCode), res) + } + result := new(SearchResults) + return result, json.NewDecoder(res.Body).Decode(result) +} + +// GetAuthConfig returns the authentication settings for a session +// TODO(tiborvass): remove this once registry client v2 is vendored +func (r *Session) GetAuthConfig(withPasswd bool) *cliconfig.AuthConfig { + password := "" + if withPasswd { + password = r.authConfig.Password + } + return &cliconfig.AuthConfig{ + Username: r.authConfig.Username, + Password: password, + Email: r.authConfig.Email, + } +} diff --git a/registry/token.go b/registry/token.go new file mode 100644 index 0000000000..d91bd45505 --- /dev/null +++ b/registry/token.go @@ -0,0 +1,81 @@ +package registry + +import ( + "encoding/json" + "errors" + "fmt" + "net/http" + "net/url" + "strings" +) + +type tokenResponse struct { + Token string `json:"token"` +} + +func getToken(username, password string, params map[string]string, registryEndpoint *Endpoint) (string, error) { + realm, ok := params["realm"] + if !ok { + return "", errors.New("no realm specified for token auth challenge") + } + + realmURL, err := url.Parse(realm) + if err != nil { + return "", fmt.Errorf("invalid token auth challenge realm: %s", err) + } + + if realmURL.Scheme == "" { + if registryEndpoint.IsSecure { + realmURL.Scheme = "https" + } else { + realmURL.Scheme = "http" + } + } + + req, err := http.NewRequest("GET", realmURL.String(), nil) + if err != nil { + return "", err + } + + reqParams := req.URL.Query() + service := params["service"] + scope := params["scope"] + + if service != "" { + reqParams.Add("service", service) + } + + for _, scopeField := range strings.Fields(scope) { + reqParams.Add("scope", scopeField) + } + + if username != "" { + reqParams.Add("account", username) + req.SetBasicAuth(username, password) + } + + req.URL.RawQuery = reqParams.Encode() + + resp, err := registryEndpoint.client.Do(req) + if err != nil { + return "", err + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return "", fmt.Errorf("token auth attempt for registry %s: %s request failed with status: %d %s", registryEndpoint, req.URL, resp.StatusCode, http.StatusText(resp.StatusCode)) + } + + decoder := json.NewDecoder(resp.Body) + + tr := new(tokenResponse) + if err = decoder.Decode(tr); err != nil { + return "", fmt.Errorf("unable to decode token response: %s", err) + } + + if tr.Token == "" { + return "", errors.New("authorization server did not include a token in the response") + } + + return tr.Token, nil +} diff --git a/registry/types.go b/registry/types.go new file mode 100644 index 0000000000..09b9d57134 --- /dev/null +++ b/registry/types.go @@ -0,0 +1,140 @@ +package registry + +// SearchResult describes a search result returned from a registry +type SearchResult struct { + // StarCount indicates the number of stars this repository has + StarCount int `json:"star_count"` + // IsOfficial indicates whether the result is an official repository or not + IsOfficial bool `json:"is_official"` + // Name is the name of the repository + Name string `json:"name"` + // IsOfficial indicates whether the result is trusted + IsTrusted bool `json:"is_trusted"` + // IsAutomated indicates whether the result is automated + IsAutomated bool `json:"is_automated"` + // Description is a textual description of the repository + Description string `json:"description"` +} + +// SearchResults lists a collection search results returned from a registry +type SearchResults struct { + // Query contains the query string that generated the search results + Query string `json:"query"` + // NumResults indicates the number of results the query returned + NumResults int `json:"num_results"` + // Results is a slice containing the acutal results for the search + Results []SearchResult `json:"results"` +} + +// RepositoryData tracks the image list, list of endpoints, and list of tokens +// for a repository +type RepositoryData struct { + // ImgList is a list of images in the repository + ImgList map[string]*ImgData + // Endpoints is a list of endpoints returned in X-Docker-Endpoints + Endpoints []string + // Tokens is currently unused (remove it?) + Tokens []string +} + +// ImgData is used to transfer image checksums to and from the registry +type ImgData struct { + // ID is an opaque string that identifies the image + ID string `json:"id"` + Checksum string `json:"checksum,omitempty"` + ChecksumPayload string `json:"-"` + Tag string `json:",omitempty"` +} + +// PingResult contains the information returned when pinging a registry. It +// indicates the registry's version and whether the registry claims to be a +// standalone registry. +type PingResult struct { + // Version is the registry version supplied by the registry in a HTTP + // header + Version string `json:"version"` + // Standalone is set to true if the registry indicates it is a + // standalone registry in the X-Docker-Registry-Standalone + // header + Standalone bool `json:"standalone"` +} + +// APIVersion is an integral representation of an API version (presently +// either 1 or 2) +type APIVersion int + +func (av APIVersion) String() string { + return apiVersions[av] +} + +var apiVersions = map[APIVersion]string{ + 1: "v1", + 2: "v2", +} + +// API Version identifiers. +const ( + APIVersionUnknown = iota + APIVersion1 + APIVersion2 +) + +// IndexInfo contains information about a registry +// +// RepositoryInfo Examples: +// { +// "Index" : { +// "Name" : "docker.io", +// "Mirrors" : ["https://registry-2.docker.io/v1/", "https://registry-3.docker.io/v1/"], +// "Secure" : true, +// "Official" : true, +// }, +// "RemoteName" : "library/debian", +// "LocalName" : "debian", +// "CanonicalName" : "docker.io/debian" +// "Official" : true, +// } +// +// { +// "Index" : { +// "Name" : "127.0.0.1:5000", +// "Mirrors" : [], +// "Secure" : false, +// "Official" : false, +// }, +// "RemoteName" : "user/repo", +// "LocalName" : "127.0.0.1:5000/user/repo", +// "CanonicalName" : "127.0.0.1:5000/user/repo", +// "Official" : false, +// } +type IndexInfo struct { + // Name is the name of the registry, such as "docker.io" + Name string + // Mirrors is a list of mirrors, expressed as URIs + Mirrors []string + // Secure is set to false if the registry is part of the list of + // insecure registries. Insecure registries accept HTTP and/or accept + // HTTPS with certificates from unknown CAs. + Secure bool + // Official indicates whether this is an official registry + Official bool +} + +// RepositoryInfo describes a repository +type RepositoryInfo struct { + // Index points to registry information + Index *IndexInfo + // RemoteName is the remote name of the repository, such as + // "library/ubuntu-12.04-base" + RemoteName string + // LocalName is the local name of the repository, such as + // "ubuntu-12.04-base" + LocalName string + // CanonicalName is the canonical name of the repository, such as + // "docker.io/library/ubuntu-12.04-base" + CanonicalName string + // Official indicates whether the repository is considered official. + // If the registry is official, and the normalized name does not + // contain a '/' (e.g. "foo"), then it is considered an official repo. + Official bool +} diff --git a/runconfig/compare.go b/runconfig/compare.go new file mode 100644 index 0000000000..ebb8ead6c1 --- /dev/null +++ b/runconfig/compare.go @@ -0,0 +1,63 @@ +package runconfig + +// Compare two Config struct. Do not compare the "Image" nor "Hostname" fields +// If OpenStdin is set, then it differs +func Compare(a, b *Config) bool { + if a == nil || b == nil || + a.OpenStdin || b.OpenStdin { + return false + } + if a.AttachStdout != b.AttachStdout || + a.AttachStderr != b.AttachStderr || + a.User != b.User || + a.OpenStdin != b.OpenStdin || + a.Tty != b.Tty { + return false + } + + if a.Cmd.Len() != b.Cmd.Len() || + len(a.Env) != len(b.Env) || + len(a.Labels) != len(b.Labels) || + len(a.ExposedPorts) != len(b.ExposedPorts) || + a.Entrypoint.Len() != b.Entrypoint.Len() || + len(a.Volumes) != len(b.Volumes) { + return false + } + + aCmd := a.Cmd.Slice() + bCmd := b.Cmd.Slice() + for i := 0; i < len(aCmd); i++ { + if aCmd[i] != bCmd[i] { + return false + } + } + for i := 0; i < len(a.Env); i++ { + if a.Env[i] != b.Env[i] { + return false + } + } + for k, v := range a.Labels { + if v != b.Labels[k] { + return false + } + } + for k := range a.ExposedPorts { + if _, exists := b.ExposedPorts[k]; !exists { + return false + } + } + + aEntrypoint := a.Entrypoint.Slice() + bEntrypoint := b.Entrypoint.Slice() + for i := 0; i < len(aEntrypoint); i++ { + if aEntrypoint[i] != bEntrypoint[i] { + return false + } + } + for key := range a.Volumes { + if _, exists := b.Volumes[key]; !exists { + return false + } + } + return true +} diff --git a/runconfig/compare_test.go b/runconfig/compare_test.go new file mode 100644 index 0000000000..1a5c6c6ca0 --- /dev/null +++ b/runconfig/compare_test.go @@ -0,0 +1,125 @@ +package runconfig + +import ( + "testing" + + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/stringutils" +) + +// Just to make life easier +func newPortNoError(proto, port string) nat.Port { + p, _ := nat.NewPort(proto, port) + return p +} + +func TestCompare(t *testing.T) { + ports1 := make(nat.PortSet) + ports1[newPortNoError("tcp", "1111")] = struct{}{} + ports1[newPortNoError("tcp", "2222")] = struct{}{} + ports2 := make(nat.PortSet) + ports2[newPortNoError("tcp", "3333")] = struct{}{} + ports2[newPortNoError("tcp", "4444")] = struct{}{} + ports3 := make(nat.PortSet) + ports3[newPortNoError("tcp", "1111")] = struct{}{} + ports3[newPortNoError("tcp", "2222")] = struct{}{} + ports3[newPortNoError("tcp", "5555")] = struct{}{} + volumes1 := make(map[string]struct{}) + volumes1["/test1"] = struct{}{} + volumes2 := make(map[string]struct{}) + volumes2["/test2"] = struct{}{} + volumes3 := make(map[string]struct{}) + volumes3["/test1"] = struct{}{} + volumes3["/test3"] = struct{}{} + envs1 := []string{"ENV1=value1", "ENV2=value2"} + envs2 := []string{"ENV1=value1", "ENV3=value3"} + entrypoint1 := stringutils.NewStrSlice("/bin/sh", "-c") + entrypoint2 := stringutils.NewStrSlice("/bin/sh", "-d") + entrypoint3 := stringutils.NewStrSlice("/bin/sh", "-c", "echo") + cmd1 := stringutils.NewStrSlice("/bin/sh", "-c") + cmd2 := stringutils.NewStrSlice("/bin/sh", "-d") + cmd3 := stringutils.NewStrSlice("/bin/sh", "-c", "echo") + labels1 := map[string]string{"LABEL1": "value1", "LABEL2": "value2"} + labels2 := map[string]string{"LABEL1": "value1", "LABEL2": "value3"} + labels3 := map[string]string{"LABEL1": "value1", "LABEL2": "value2", "LABEL3": "value3"} + + sameConfigs := map[*Config]*Config{ + // Empty config + &Config{}: {}, + // Does not compare hostname, domainname & image + &Config{ + Hostname: "host1", + Domainname: "domain1", + Image: "image1", + User: "user", + }: { + Hostname: "host2", + Domainname: "domain2", + Image: "image2", + User: "user", + }, + // only OpenStdin + &Config{OpenStdin: false}: {OpenStdin: false}, + // only env + &Config{Env: envs1}: {Env: envs1}, + // only cmd + &Config{Cmd: cmd1}: {Cmd: cmd1}, + // only labels + &Config{Labels: labels1}: {Labels: labels1}, + // only exposedPorts + &Config{ExposedPorts: ports1}: {ExposedPorts: ports1}, + // only entrypoints + &Config{Entrypoint: entrypoint1}: {Entrypoint: entrypoint1}, + // only volumes + &Config{Volumes: volumes1}: {Volumes: volumes1}, + } + differentConfigs := map[*Config]*Config{ + nil: nil, + &Config{ + Hostname: "host1", + Domainname: "domain1", + Image: "image1", + User: "user1", + }: { + Hostname: "host1", + Domainname: "domain1", + Image: "image1", + User: "user2", + }, + // only OpenStdin + &Config{OpenStdin: false}: {OpenStdin: true}, + &Config{OpenStdin: true}: {OpenStdin: false}, + // only env + &Config{Env: envs1}: {Env: envs2}, + // only cmd + &Config{Cmd: cmd1}: {Cmd: cmd2}, + // not the same number of parts + &Config{Cmd: cmd1}: {Cmd: cmd3}, + // only labels + &Config{Labels: labels1}: {Labels: labels2}, + // not the same number of labels + &Config{Labels: labels1}: {Labels: labels3}, + // only exposedPorts + &Config{ExposedPorts: ports1}: {ExposedPorts: ports2}, + // not the same number of ports + &Config{ExposedPorts: ports1}: {ExposedPorts: ports3}, + // only entrypoints + &Config{Entrypoint: entrypoint1}: {Entrypoint: entrypoint2}, + // not the same number of parts + &Config{Entrypoint: entrypoint1}: {Entrypoint: entrypoint3}, + // only volumes + &Config{Volumes: volumes1}: {Volumes: volumes2}, + // not the same number of labels + &Config{Volumes: volumes1}: {Volumes: volumes3}, + } + for config1, config2 := range sameConfigs { + if !Compare(config1, config2) { + t.Fatalf("Compare should be true for [%v] and [%v]", config1, config2) + } + } + for config1, config2 := range differentConfigs { + if Compare(config1, config2) { + t.Fatalf("Compare should be false for [%v] and [%v]", config1, config2) + } + } +} diff --git a/runconfig/config.go b/runconfig/config.go new file mode 100644 index 0000000000..08f146d1b9 --- /dev/null +++ b/runconfig/config.go @@ -0,0 +1,63 @@ +package runconfig + +import ( + "encoding/json" + "io" + + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/stringutils" +) + +// Config contains the configuration data about a container. +// It should hold only portable information about the container. +// Here, "portable" means "independent from the host we are running on". +// Non-portable information *should* appear in HostConfig. +// All fields added to this struct must be marked `omitempty` to keep getting +// predictable hashes from the old `v1Compatibility` configuration. +type Config struct { + Hostname string // Hostname + Domainname string // Domainname + User string // User that will run the command(s) inside the container + AttachStdin bool // Attach the standard input, makes possible user interaction + AttachStdout bool // Attach the standard output + AttachStderr bool // Attach the standard error + ExposedPorts map[nat.Port]struct{} `json:",omitempty"` // List of exposed ports + PublishService string `json:",omitempty"` // Name of the network service exposed by the container + Tty bool // Attach standard streams to a tty, including stdin if it is not closed. + OpenStdin bool // Open stdin + StdinOnce bool // If true, close stdin after the 1 attached client disconnects. + Env []string // List of environment variable to set in the container + Cmd *stringutils.StrSlice // Command to run when starting the container + Image string // Name of the image as it was passed by the operator (eg. could be symbolic) + Volumes map[string]struct{} // List of volumes (mounts) used for the container + WorkingDir string // Current directory (PWD) in the command will be launched + Entrypoint *stringutils.StrSlice // Entrypoint to run when starting the container + NetworkDisabled bool `json:",omitempty"` // Is network disabled + MacAddress string `json:",omitempty"` // Mac Address of the container + OnBuild []string // ONBUILD metadata that were defined on the image Dockerfile + Labels map[string]string // List of labels set to this container + StopSignal string `json:",omitempty"` // Signal to stop a container +} + +// DecodeContainerConfig decodes a json encoded config into a ContainerConfigWrapper +// struct and returns both a Config and an HostConfig struct +// Be aware this function is not checking whether the resulted structs are nil, +// it's your business to do so +func DecodeContainerConfig(src io.Reader) (*Config, *HostConfig, error) { + decoder := json.NewDecoder(src) + + var w ContainerConfigWrapper + if err := decoder.Decode(&w); err != nil { + return nil, nil, err + } + + hc := w.getHostConfig() + + // Certain parameters need daemon-side validation that cannot be done + // on the client, as only the daemon knows what is valid for the platform. + if err := ValidateNetMode(w.Config, hc); err != nil { + return nil, nil, err + } + + return w.Config, hc, nil +} diff --git a/runconfig/config_test.go b/runconfig/config_test.go new file mode 100644 index 0000000000..66def67446 --- /dev/null +++ b/runconfig/config_test.go @@ -0,0 +1,45 @@ +package runconfig + +import ( + "bytes" + "fmt" + "io/ioutil" + "testing" + + "github.com/docker/docker/pkg/stringutils" +) + +func TestDecodeContainerConfig(t *testing.T) { + fixtures := []struct { + file string + entrypoint *stringutils.StrSlice + }{ + {"fixtures/container_config_1_14.json", stringutils.NewStrSlice()}, + {"fixtures/container_config_1_17.json", stringutils.NewStrSlice("bash")}, + {"fixtures/container_config_1_19.json", stringutils.NewStrSlice("bash")}, + } + + for _, f := range fixtures { + b, err := ioutil.ReadFile(f.file) + if err != nil { + t.Fatal(err) + } + + c, h, err := DecodeContainerConfig(bytes.NewReader(b)) + if err != nil { + t.Fatal(fmt.Errorf("Error parsing %s: %v", f, err)) + } + + if c.Image != "ubuntu" { + t.Fatalf("Expected ubuntu image, found %s\n", c.Image) + } + + if c.Entrypoint.Len() != f.entrypoint.Len() { + t.Fatalf("Expected %v, found %v\n", f.entrypoint, c.Entrypoint) + } + + if h.Memory != 1000 { + t.Fatalf("Expected memory to be 1000, found %d\n", h.Memory) + } + } +} diff --git a/runconfig/config_unix.go b/runconfig/config_unix.go new file mode 100644 index 0000000000..63bd0a2f7a --- /dev/null +++ b/runconfig/config_unix.go @@ -0,0 +1,53 @@ +// +build !windows + +package runconfig + +// ContainerConfigWrapper is a Config wrapper that hold the container Config (portable) +// and the corresponding HostConfig (non-portable). +type ContainerConfigWrapper struct { + *Config + InnerHostConfig *HostConfig `json:"HostConfig,omitempty"` + Cpuset string `json:",omitempty"` // Deprecated. Exported for backwards compatibility. + *HostConfig // Deprecated. Exported to read attributes from json that are not in the inner host config structure. +} + +// getHostConfig gets the HostConfig of the Config. +// It's mostly there to handle Deprecated fields of the ContainerConfigWrapper +func (w *ContainerConfigWrapper) getHostConfig() *HostConfig { + hc := w.HostConfig + + if hc == nil && w.InnerHostConfig != nil { + hc = w.InnerHostConfig + } else if w.InnerHostConfig != nil { + if hc.Memory != 0 && w.InnerHostConfig.Memory == 0 { + w.InnerHostConfig.Memory = hc.Memory + } + if hc.MemorySwap != 0 && w.InnerHostConfig.MemorySwap == 0 { + w.InnerHostConfig.MemorySwap = hc.MemorySwap + } + if hc.CPUShares != 0 && w.InnerHostConfig.CPUShares == 0 { + w.InnerHostConfig.CPUShares = hc.CPUShares + } + if hc.CpusetCpus != "" && w.InnerHostConfig.CpusetCpus == "" { + w.InnerHostConfig.CpusetCpus = hc.CpusetCpus + } + + if hc.VolumeDriver != "" && w.InnerHostConfig.VolumeDriver == "" { + w.InnerHostConfig.VolumeDriver = hc.VolumeDriver + } + + hc = w.InnerHostConfig + } + + if hc != nil { + if w.Cpuset != "" && hc.CpusetCpus == "" { + hc.CpusetCpus = w.Cpuset + } + } + + // Make sure NetworkMode has an acceptable value. We do this to ensure + // backwards compatible API behaviour. + hc = SetDefaultNetModeIfBlank(hc) + + return hc +} diff --git a/runconfig/config_windows.go b/runconfig/config_windows.go new file mode 100644 index 0000000000..2ab8e19a27 --- /dev/null +++ b/runconfig/config_windows.go @@ -0,0 +1,13 @@ +package runconfig + +// ContainerConfigWrapper is a Config wrapper that hold the container Config (portable) +// and the corresponding HostConfig (non-portable). +type ContainerConfigWrapper struct { + *Config + HostConfig *HostConfig `json:"HostConfig,omitempty"` +} + +// getHostConfig gets the HostConfig of the Config. +func (w *ContainerConfigWrapper) getHostConfig() *HostConfig { + return w.HostConfig +} diff --git a/runconfig/exec.go b/runconfig/exec.go new file mode 100644 index 0000000000..6fe28ea338 --- /dev/null +++ b/runconfig/exec.go @@ -0,0 +1,62 @@ +package runconfig + +import ( + flag "github.com/docker/docker/pkg/mflag" +) + +// ExecConfig is a small subset of the Config struct that hold the configuration +// for the exec feature of docker. +type ExecConfig struct { + User string // User that will run the command + Privileged bool // Is the container in privileged mode + Tty bool // Attach standard streams to a tty. + Container string // Name of the container (to execute in) + AttachStdin bool // Attach the standard input, makes possible user interaction + AttachStderr bool // Attach the standard output + AttachStdout bool // Attach the standard error + Detach bool // Execute in detach mode + Cmd []string // Execution commands and args +} + +// ParseExec parses the specified args for the specified command and generates +// an ExecConfig from it. +// If the minimal number of specified args is not right or if specified args are +// not valid, it will return an error. +func ParseExec(cmd *flag.FlagSet, args []string) (*ExecConfig, error) { + var ( + flStdin = cmd.Bool([]string{"i", "-interactive"}, false, "Keep STDIN open even if not attached") + flTty = cmd.Bool([]string{"t", "-tty"}, false, "Allocate a pseudo-TTY") + flDetach = cmd.Bool([]string{"d", "-detach"}, false, "Detached mode: run command in the background") + flUser = cmd.String([]string{"u", "-user"}, "", "Username or UID (format: [:])") + flPrivileged = cmd.Bool([]string{"-privileged"}, false, "Give extended privileges to the command") + execCmd []string + container string + ) + cmd.Require(flag.Min, 2) + if err := cmd.ParseFlags(args, true); err != nil { + return nil, err + } + container = cmd.Arg(0) + parsedArgs := cmd.Args() + execCmd = parsedArgs[1:] + + execConfig := &ExecConfig{ + User: *flUser, + Privileged: *flPrivileged, + Tty: *flTty, + Cmd: execCmd, + Container: container, + Detach: *flDetach, + } + + // If -d is not set, attach to everything by default + if !*flDetach { + execConfig.AttachStdout = true + execConfig.AttachStderr = true + if *flStdin { + execConfig.AttachStdin = true + } + } + + return execConfig, nil +} diff --git a/runconfig/exec_test.go b/runconfig/exec_test.go new file mode 100644 index 0000000000..a4b7ea9bac --- /dev/null +++ b/runconfig/exec_test.go @@ -0,0 +1,129 @@ +package runconfig + +import ( + "fmt" + "io/ioutil" + "testing" + + flag "github.com/docker/docker/pkg/mflag" +) + +type arguments struct { + args []string +} + +func TestParseExec(t *testing.T) { + invalids := map[*arguments]error{ + &arguments{[]string{"-unknown"}}: fmt.Errorf("flag provided but not defined: -unknown"), + &arguments{[]string{"-u"}}: fmt.Errorf("flag needs an argument: -u"), + &arguments{[]string{"--user"}}: fmt.Errorf("flag needs an argument: --user"), + } + valids := map[*arguments]*ExecConfig{ + &arguments{ + []string{"container", "command"}, + }: { + Container: "container", + Cmd: []string{"command"}, + AttachStdout: true, + AttachStderr: true, + }, + &arguments{ + []string{"container", "command1", "command2"}, + }: { + Container: "container", + Cmd: []string{"command1", "command2"}, + AttachStdout: true, + AttachStderr: true, + }, + &arguments{ + []string{"-i", "-t", "-u", "uid", "container", "command"}, + }: { + User: "uid", + AttachStdin: true, + AttachStdout: true, + AttachStderr: true, + Tty: true, + Container: "container", + Cmd: []string{"command"}, + }, + &arguments{ + []string{"-d", "container", "command"}, + }: { + AttachStdin: false, + AttachStdout: false, + AttachStderr: false, + Detach: true, + Container: "container", + Cmd: []string{"command"}, + }, + &arguments{ + []string{"-t", "-i", "-d", "container", "command"}, + }: { + AttachStdin: false, + AttachStdout: false, + AttachStderr: false, + Detach: true, + Tty: true, + Container: "container", + Cmd: []string{"command"}, + }, + } + for invalid, expectedError := range invalids { + cmd := flag.NewFlagSet("exec", flag.ContinueOnError) + cmd.ShortUsage = func() {} + cmd.SetOutput(ioutil.Discard) + _, err := ParseExec(cmd, invalid.args) + if err == nil || err.Error() != expectedError.Error() { + t.Fatalf("Expected an error [%v] for %v, got %v", expectedError, invalid, err) + } + + } + for valid, expectedExecConfig := range valids { + cmd := flag.NewFlagSet("exec", flag.ContinueOnError) + cmd.ShortUsage = func() {} + cmd.SetOutput(ioutil.Discard) + execConfig, err := ParseExec(cmd, valid.args) + if err != nil { + t.Fatal(err) + } + if !compareExecConfig(expectedExecConfig, execConfig) { + t.Fatalf("Expected [%v] for %v, got [%v]", expectedExecConfig, valid, execConfig) + } + } +} + +func compareExecConfig(config1 *ExecConfig, config2 *ExecConfig) bool { + if config1.AttachStderr != config2.AttachStderr { + return false + } + if config1.AttachStdin != config2.AttachStdin { + return false + } + if config1.AttachStdout != config2.AttachStdout { + return false + } + if config1.Container != config2.Container { + return false + } + if config1.Detach != config2.Detach { + return false + } + if config1.Privileged != config2.Privileged { + return false + } + if config1.Tty != config2.Tty { + return false + } + if config1.User != config2.User { + return false + } + if len(config1.Cmd) != len(config2.Cmd) { + return false + } + for index, value := range config1.Cmd { + if value != config2.Cmd[index] { + return false + } + } + return true +} diff --git a/runconfig/fixtures/container_config_1_14.json b/runconfig/fixtures/container_config_1_14.json new file mode 100644 index 0000000000..b08334c095 --- /dev/null +++ b/runconfig/fixtures/container_config_1_14.json @@ -0,0 +1,30 @@ +{ + "Hostname":"", + "Domainname": "", + "User":"", + "Memory": 1000, + "MemorySwap":0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "bash" + ], + "Image":"ubuntu", + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "NetworkDisabled": false, + "ExposedPorts":{ + "22/tcp": {} + }, + "RestartPolicy": { "Name": "always" } +} diff --git a/runconfig/fixtures/container_config_1_17.json b/runconfig/fixtures/container_config_1_17.json new file mode 100644 index 0000000000..0d780877b4 --- /dev/null +++ b/runconfig/fixtures/container_config_1_17.json @@ -0,0 +1,50 @@ +{ + "Hostname": "", + "Domainname": "", + "User": "", + "Memory": 1000, + "MemorySwap": 0, + "CpuShares": 512, + "Cpuset": "0,1", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "bash", + "Image": "ubuntu", + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "SecurityOpt": [""], + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "DnsOptions": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [] + } +} diff --git a/runconfig/fixtures/container_config_1_19.json b/runconfig/fixtures/container_config_1_19.json new file mode 100644 index 0000000000..de49cf3242 --- /dev/null +++ b/runconfig/fixtures/container_config_1_19.json @@ -0,0 +1,58 @@ +{ + "Hostname": "", + "Domainname": "", + "User": "", + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Entrypoint": "bash", + "Image": "ubuntu", + "Labels": { + "com.example.vendor": "Acme", + "com.example.license": "GPL", + "com.example.version": "1.0" + }, + "Volumes": { + "/tmp": {} + }, + "WorkingDir": "", + "NetworkDisabled": false, + "MacAddress": "12:34:56:78:9a:bc", + "ExposedPorts": { + "22/tcp": {} + }, + "HostConfig": { + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "Memory": 1000, + "MemorySwap": 0, + "CpuShares": 512, + "CpusetCpus": "0,1", + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "DnsOptions": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "Ulimits": [{}], + "LogConfig": { "Type": "json-file", "Config": {} }, + "SecurityOpt": [""], + "CgroupParent": "" + } +} diff --git a/runconfig/fixtures/container_hostconfig_1_14.json b/runconfig/fixtures/container_hostconfig_1_14.json new file mode 100644 index 0000000000..c72ac91cab --- /dev/null +++ b/runconfig/fixtures/container_hostconfig_1_14.json @@ -0,0 +1,18 @@ +{ + "Binds": ["/tmp:/tmp"], + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": ["/name:alias"], + "PublishAllPorts": false, + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"] +} diff --git a/runconfig/fixtures/container_hostconfig_1_19.json b/runconfig/fixtures/container_hostconfig_1_19.json new file mode 100644 index 0000000000..5ca8aa7e19 --- /dev/null +++ b/runconfig/fixtures/container_hostconfig_1_19.json @@ -0,0 +1,30 @@ +{ + "Binds": ["/tmp:/tmp"], + "Links": ["redis3:redis"], + "LxcConf": {"lxc.utsname":"docker"}, + "Memory": 0, + "MemorySwap": 0, + "CpuShares": 512, + "CpuPeriod": 100000, + "CpusetCpus": "0,1", + "CpusetMems": "0,1", + "BlkioWeight": 300, + "OomKillDisable": false, + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts": false, + "Privileged": false, + "ReadonlyRootfs": false, + "Dns": ["8.8.8.8"], + "DnsSearch": [""], + "ExtraHosts": null, + "VolumesFrom": ["parent", "other:ro"], + "CapAdd": ["NET_ADMIN"], + "CapDrop": ["MKNOD"], + "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, + "NetworkMode": "bridge", + "Devices": [], + "Ulimits": [{}], + "LogConfig": { "Type": "json-file", "Config": {} }, + "SecurityOpt": [""], + "CgroupParent": "" +} diff --git a/runconfig/fixtures/valid.env b/runconfig/fixtures/valid.env new file mode 100644 index 0000000000..3afbdc81c2 --- /dev/null +++ b/runconfig/fixtures/valid.env @@ -0,0 +1 @@ +ENV1=value1 diff --git a/runconfig/fixtures/valid.label b/runconfig/fixtures/valid.label new file mode 100644 index 0000000000..b4208bdf8f --- /dev/null +++ b/runconfig/fixtures/valid.label @@ -0,0 +1 @@ +LABEL1=value1 diff --git a/runconfig/hostconfig.go b/runconfig/hostconfig.go new file mode 100644 index 0000000000..7a7b8f3b37 --- /dev/null +++ b/runconfig/hostconfig.go @@ -0,0 +1,284 @@ +package runconfig + +import ( + "encoding/json" + "io" + "strings" + + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/ulimit" +) + +// KeyValuePair is a structure that hold a value for a key. +type KeyValuePair struct { + Key string + Value string +} + +// NetworkMode represents the container network stack. +type NetworkMode string + +// IpcMode represents the container ipc stack. +type IpcMode string + +// IsPrivate indicates whether the container uses it's private ipc stack. +func (n IpcMode) IsPrivate() bool { + return !(n.IsHost() || n.IsContainer()) +} + +// IsHost indicates whether the container uses the host's ipc stack. +func (n IpcMode) IsHost() bool { + return n == "host" +} + +// IsContainer indicates whether the container uses a container's ipc stack. +func (n IpcMode) IsContainer() bool { + parts := strings.SplitN(string(n), ":", 2) + return len(parts) > 1 && parts[0] == "container" +} + +// Valid indicates whether the ipc stack is valid. +func (n IpcMode) Valid() bool { + parts := strings.Split(string(n), ":") + switch mode := parts[0]; mode { + case "", "host": + case "container": + if len(parts) != 2 || parts[1] == "" { + return false + } + default: + return false + } + return true +} + +// Container returns the name of the container ipc stack is going to be used. +func (n IpcMode) Container() string { + parts := strings.SplitN(string(n), ":", 2) + if len(parts) > 1 { + return parts[1] + } + return "" +} + +// UTSMode represents the UTS namespace of the container. +type UTSMode string + +// IsPrivate indicates whether the container uses it's private UTS namespace. +func (n UTSMode) IsPrivate() bool { + return !(n.IsHost()) +} + +// IsHost indicates whether the container uses the host's UTS namespace. +func (n UTSMode) IsHost() bool { + return n == "host" +} + +// Valid indicates whether the UTS namespace is valid. +func (n UTSMode) Valid() bool { + parts := strings.Split(string(n), ":") + switch mode := parts[0]; mode { + case "", "host": + default: + return false + } + return true +} + +// PidMode represents the pid stack of the container. +type PidMode string + +// IsPrivate indicates whether the container uses it's private pid stack. +func (n PidMode) IsPrivate() bool { + return !(n.IsHost()) +} + +// IsHost indicates whether the container uses the host's pid stack. +func (n PidMode) IsHost() bool { + return n == "host" +} + +// Valid indicates whether the pid stack is valid. +func (n PidMode) Valid() bool { + parts := strings.Split(string(n), ":") + switch mode := parts[0]; mode { + case "", "host": + default: + return false + } + return true +} + +// DeviceMapping represents the device mapping between the host and the container. +type DeviceMapping struct { + PathOnHost string + PathInContainer string + CgroupPermissions string +} + +// RestartPolicy represents the restart policies of the container. +type RestartPolicy struct { + Name string + MaximumRetryCount int +} + +// IsNone indicates whether the container has the "no" restart policy. +// This means the container will not automatically restart when exiting. +func (rp *RestartPolicy) IsNone() bool { + return rp.Name == "no" +} + +// IsAlways indicates whether the container has the "always" restart policy. +// This means the container will automatically restart regardless of the exit status. +func (rp *RestartPolicy) IsAlways() bool { + return rp.Name == "always" +} + +// IsOnFailure indicates whether the container has the "on-failure" restart policy. +// This means the contain will automatically restart of exiting with a non-zero exit status. +func (rp *RestartPolicy) IsOnFailure() bool { + return rp.Name == "on-failure" +} + +// IsUnlessStopped indicates whether the container has the +// "unless-stopped" restart policy. This means the container will +// automatically restart unless user has put it to stopped state. +func (rp *RestartPolicy) IsUnlessStopped() bool { + return rp.Name == "unless-stopped" +} + +// LogConfig represents the logging configuration of the container. +type LogConfig struct { + Type string + Config map[string]string +} + +// LxcConfig represents the specific LXC configuration of the container. +type LxcConfig struct { + values []KeyValuePair +} + +// MarshalJSON marshals (or serializes) the LxcConfig into JSON. +func (c *LxcConfig) MarshalJSON() ([]byte, error) { + if c == nil { + return []byte{}, nil + } + return json.Marshal(c.Slice()) +} + +// UnmarshalJSON unmarshals (or deserializes) the specified byte slices from JSON to +// a LxcConfig. +func (c *LxcConfig) UnmarshalJSON(b []byte) error { + if len(b) == 0 { + return nil + } + + var kv []KeyValuePair + if err := json.Unmarshal(b, &kv); err != nil { + var h map[string]string + if err := json.Unmarshal(b, &h); err != nil { + return err + } + for k, v := range h { + kv = append(kv, KeyValuePair{k, v}) + } + } + c.values = kv + + return nil +} + +// Len returns the number of specific lxc configuration. +func (c *LxcConfig) Len() int { + if c == nil { + return 0 + } + return len(c.values) +} + +// Slice returns the specific lxc configuration into a slice of KeyValuePair. +func (c *LxcConfig) Slice() []KeyValuePair { + if c == nil { + return nil + } + return c.values +} + +// NewLxcConfig creates a LxcConfig from the specified slice of KeyValuePair. +func NewLxcConfig(values []KeyValuePair) *LxcConfig { + return &LxcConfig{values} +} + +// HostConfig the non-portable Config structure of a container. +// Here, "non-portable" means "dependent of the host we are running on". +// Portable information *should* appear in Config. +type HostConfig struct { + Binds []string // List of volume bindings for this container + ContainerIDFile string // File (path) where the containerId is written + LxcConf *LxcConfig // Additional lxc configuration + Memory int64 // Memory limit (in bytes) + MemoryReservation int64 // Memory soft limit (in bytes) + MemorySwap int64 // Total memory usage (memory + swap); set `-1` to disable swap + KernelMemory int64 // Kernel memory limit (in bytes) + CPUShares int64 `json:"CpuShares"` // CPU shares (relative weight vs. other containers) + CPUPeriod int64 `json:"CpuPeriod"` // CPU CFS (Completely Fair Scheduler) period + CpusetCpus string // CpusetCpus 0-2, 0,1 + CpusetMems string // CpusetMems 0-2, 0,1 + CPUQuota int64 `json:"CpuQuota"` // CPU CFS (Completely Fair Scheduler) quota + BlkioWeight uint16 // Block IO weight (relative weight vs. other containers) + OomKillDisable bool // Whether to disable OOM Killer or not + MemorySwappiness *int64 // Tuning container memory swappiness behaviour + Privileged bool // Is the container in privileged mode + PortBindings nat.PortMap // Port mapping between the exposed port (container) and the host + Links []string // List of links (in the name:alias form) + PublishAllPorts bool // Should docker publish all exposed port for the container + DNS []string `json:"Dns"` // List of DNS server to lookup + DNSOptions []string `json:"DnsOptions"` // List of DNSOption to look for + DNSSearch []string `json:"DnsSearch"` // List of DNSSearch to look for + ExtraHosts []string // List of extra hosts + VolumesFrom []string // List of volumes to take from other container + Devices []DeviceMapping // List of devices to map inside the container + NetworkMode NetworkMode // Network namespace to use for the container + IpcMode IpcMode // IPC namespace to use for the container + PidMode PidMode // PID namespace to use for the container + UTSMode UTSMode // UTS namespace to use for the container + CapAdd *stringutils.StrSlice // List of kernel capabilities to add to the container + CapDrop *stringutils.StrSlice // List of kernel capabilities to remove from the container + GroupAdd []string // List of additional groups that the container process will run as + RestartPolicy RestartPolicy // Restart policy to be used for the container + SecurityOpt []string // List of string values to customize labels for MLS systems, such as SELinux. + ReadonlyRootfs bool // Is the container root filesystem in read-only + Ulimits []*ulimit.Ulimit // List of ulimits to be set in the container + LogConfig LogConfig // Configuration of the logs for this container + CgroupParent string // Parent cgroup. + ConsoleSize [2]int // Initial console size on Windows + VolumeDriver string // Name of the volume driver used to mount volumes +} + +// DecodeHostConfig creates a HostConfig based on the specified Reader. +// It assumes the content of the reader will be JSON, and decodes it. +func DecodeHostConfig(src io.Reader) (*HostConfig, error) { + decoder := json.NewDecoder(src) + + var w ContainerConfigWrapper + if err := decoder.Decode(&w); err != nil { + return nil, err + } + + hc := w.getHostConfig() + return hc, nil +} + +// SetDefaultNetModeIfBlank changes the NetworkMode in a HostConfig structure +// to default if it is not populated. This ensures backwards compatibility after +// the validation of the network mode was moved from the docker CLI to the +// docker daemon. +func SetDefaultNetModeIfBlank(hc *HostConfig) *HostConfig { + if hc != nil { + if hc.NetworkMode == NetworkMode("") { + hc.NetworkMode = NetworkMode("default") + } + } + return hc +} diff --git a/runconfig/hostconfig_test.go b/runconfig/hostconfig_test.go new file mode 100644 index 0000000000..806f4a8a54 --- /dev/null +++ b/runconfig/hostconfig_test.go @@ -0,0 +1,268 @@ +// +build !windows + +package runconfig + +import ( + "bytes" + "fmt" + "io/ioutil" + "testing" +) + +// TODO Windows: This will need addressing for a Windows daemon. +func TestNetworkModeTest(t *testing.T) { + networkModes := map[NetworkMode][]bool{ + // private, bridge, host, container, none, default + "": {true, false, false, false, false, false}, + "something:weird": {true, false, false, false, false, false}, + "bridge": {true, true, false, false, false, false}, + DefaultDaemonNetworkMode(): {true, true, false, false, false, false}, + "host": {false, false, true, false, false, false}, + "container:name": {false, false, false, true, false, false}, + "none": {true, false, false, false, true, false}, + "default": {true, false, false, false, false, true}, + } + networkModeNames := map[NetworkMode]string{ + "": "", + "something:weird": "something:weird", + "bridge": "bridge", + DefaultDaemonNetworkMode(): "bridge", + "host": "host", + "container:name": "container", + "none": "none", + "default": "default", + } + for networkMode, state := range networkModes { + if networkMode.IsPrivate() != state[0] { + t.Fatalf("NetworkMode.IsPrivate for %v should have been %v but was %v", networkMode, state[0], networkMode.IsPrivate()) + } + if networkMode.IsBridge() != state[1] { + t.Fatalf("NetworkMode.IsBridge for %v should have been %v but was %v", networkMode, state[1], networkMode.IsBridge()) + } + if networkMode.IsHost() != state[2] { + t.Fatalf("NetworkMode.IsHost for %v should have been %v but was %v", networkMode, state[2], networkMode.IsHost()) + } + if networkMode.IsContainer() != state[3] { + t.Fatalf("NetworkMode.IsContainer for %v should have been %v but was %v", networkMode, state[3], networkMode.IsContainer()) + } + if networkMode.IsNone() != state[4] { + t.Fatalf("NetworkMode.IsNone for %v should have been %v but was %v", networkMode, state[4], networkMode.IsNone()) + } + if networkMode.IsDefault() != state[5] { + t.Fatalf("NetworkMode.IsDefault for %v should have been %v but was %v", networkMode, state[5], networkMode.IsDefault()) + } + if networkMode.NetworkName() != networkModeNames[networkMode] { + t.Fatalf("Expected name %v, got %v", networkModeNames[networkMode], networkMode.NetworkName()) + } + } +} + +func TestIpcModeTest(t *testing.T) { + ipcModes := map[IpcMode][]bool{ + // private, host, container, valid + "": {true, false, false, true}, + "something:weird": {true, false, false, false}, + ":weird": {true, false, false, true}, + "host": {false, true, false, true}, + "container:name": {false, false, true, true}, + "container:name:something": {false, false, true, false}, + "container:": {false, false, true, false}, + } + for ipcMode, state := range ipcModes { + if ipcMode.IsPrivate() != state[0] { + t.Fatalf("IpcMode.IsPrivate for %v should have been %v but was %v", ipcMode, state[0], ipcMode.IsPrivate()) + } + if ipcMode.IsHost() != state[1] { + t.Fatalf("IpcMode.IsHost for %v should have been %v but was %v", ipcMode, state[1], ipcMode.IsHost()) + } + if ipcMode.IsContainer() != state[2] { + t.Fatalf("IpcMode.IsContainer for %v should have been %v but was %v", ipcMode, state[2], ipcMode.IsContainer()) + } + if ipcMode.Valid() != state[3] { + t.Fatalf("IpcMode.Valid for %v should have been %v but was %v", ipcMode, state[3], ipcMode.Valid()) + } + } + containerIpcModes := map[IpcMode]string{ + "": "", + "something": "", + "something:weird": "weird", + "container": "", + "container:": "", + "container:name": "name", + "container:name1:name2": "name1:name2", + } + for ipcMode, container := range containerIpcModes { + if ipcMode.Container() != container { + t.Fatalf("Expected %v for %v but was %v", container, ipcMode, ipcMode.Container()) + } + } +} + +func TestUTSModeTest(t *testing.T) { + utsModes := map[UTSMode][]bool{ + // private, host, valid + "": {true, false, true}, + "something:weird": {true, false, false}, + "host": {false, true, true}, + "host:name": {true, false, true}, + } + for utsMode, state := range utsModes { + if utsMode.IsPrivate() != state[0] { + t.Fatalf("UtsMode.IsPrivate for %v should have been %v but was %v", utsMode, state[0], utsMode.IsPrivate()) + } + if utsMode.IsHost() != state[1] { + t.Fatalf("UtsMode.IsHost for %v should have been %v but was %v", utsMode, state[1], utsMode.IsHost()) + } + if utsMode.Valid() != state[2] { + t.Fatalf("UtsMode.Valid for %v should have been %v but was %v", utsMode, state[2], utsMode.Valid()) + } + } +} + +func TestPidModeTest(t *testing.T) { + pidModes := map[PidMode][]bool{ + // private, host, valid + "": {true, false, true}, + "something:weird": {true, false, false}, + "host": {false, true, true}, + "host:name": {true, false, true}, + } + for pidMode, state := range pidModes { + if pidMode.IsPrivate() != state[0] { + t.Fatalf("PidMode.IsPrivate for %v should have been %v but was %v", pidMode, state[0], pidMode.IsPrivate()) + } + if pidMode.IsHost() != state[1] { + t.Fatalf("PidMode.IsHost for %v should have been %v but was %v", pidMode, state[1], pidMode.IsHost()) + } + if pidMode.Valid() != state[2] { + t.Fatalf("PidMode.Valid for %v should have been %v but was %v", pidMode, state[2], pidMode.Valid()) + } + } +} + +func TestRestartPolicy(t *testing.T) { + restartPolicies := map[RestartPolicy][]bool{ + // none, always, failure + RestartPolicy{}: {false, false, false}, + RestartPolicy{"something", 0}: {false, false, false}, + RestartPolicy{"no", 0}: {true, false, false}, + RestartPolicy{"always", 0}: {false, true, false}, + RestartPolicy{"on-failure", 0}: {false, false, true}, + } + for restartPolicy, state := range restartPolicies { + if restartPolicy.IsNone() != state[0] { + t.Fatalf("RestartPolicy.IsNone for %v should have been %v but was %v", restartPolicy, state[0], restartPolicy.IsNone()) + } + if restartPolicy.IsAlways() != state[1] { + t.Fatalf("RestartPolicy.IsAlways for %v should have been %v but was %v", restartPolicy, state[1], restartPolicy.IsAlways()) + } + if restartPolicy.IsOnFailure() != state[2] { + t.Fatalf("RestartPolicy.IsOnFailure for %v should have been %v but was %v", restartPolicy, state[2], restartPolicy.IsOnFailure()) + } + } +} + +func TestLxcConfigMarshalJSON(t *testing.T) { + lxcConfigs := map[*LxcConfig]string{ + nil: "", + &LxcConfig{}: "null", + &LxcConfig{ + []KeyValuePair{{"key1", "value1"}}, + }: `[{"Key":"key1","Value":"value1"}]`, + } + + for lxcconfig, expected := range lxcConfigs { + data, err := lxcconfig.MarshalJSON() + if err != nil { + t.Fatal(err) + } + if string(data) != expected { + t.Fatalf("Expected %v, got %v", expected, string(data)) + } + } +} + +func TestLxcConfigUnmarshalJSON(t *testing.T) { + keyvaluePairs := map[string][]KeyValuePair{ + "": {{"key1", "value1"}}, + "[]": {}, + `[{"Key":"key2","Value":"value2"}]`: {{"key2", "value2"}}, + } + for json, expectedParts := range keyvaluePairs { + lxcConfig := &LxcConfig{ + []KeyValuePair{{"key1", "value1"}}, + } + if err := lxcConfig.UnmarshalJSON([]byte(json)); err != nil { + t.Fatal(err) + } + + actualParts := lxcConfig.Slice() + if len(actualParts) != len(expectedParts) { + t.Fatalf("Expected %v keyvaluePairs, got %v (%v)", len(expectedParts), len(actualParts), expectedParts) + } + for index, part := range actualParts { + if part != expectedParts[index] { + t.Fatalf("Expected %v, got %v", expectedParts, actualParts) + break + } + } + } +} + +func TestMergeConfigs(t *testing.T) { + expectedHostname := "hostname" + expectedContainerIDFile := "containerIdFile" + config := &Config{ + Hostname: expectedHostname, + } + hostConfig := &HostConfig{ + ContainerIDFile: expectedContainerIDFile, + } + containerConfigWrapper := MergeConfigs(config, hostConfig) + if containerConfigWrapper.Config.Hostname != expectedHostname { + t.Fatalf("containerConfigWrapper config hostname expected %v got %v", expectedHostname, containerConfigWrapper.Config.Hostname) + } + if containerConfigWrapper.InnerHostConfig.ContainerIDFile != expectedContainerIDFile { + t.Fatalf("containerConfigWrapper hostconfig containerIdfile expected %v got %v", expectedContainerIDFile, containerConfigWrapper.InnerHostConfig.ContainerIDFile) + } + if containerConfigWrapper.Cpuset != "" { + t.Fatalf("Expected empty Cpuset, got %v", containerConfigWrapper.Cpuset) + } +} + +func TestDecodeHostConfig(t *testing.T) { + fixtures := []struct { + file string + }{ + {"fixtures/container_hostconfig_1_14.json"}, + {"fixtures/container_hostconfig_1_19.json"}, + } + + for _, f := range fixtures { + b, err := ioutil.ReadFile(f.file) + if err != nil { + t.Fatal(err) + } + + c, err := DecodeHostConfig(bytes.NewReader(b)) + if err != nil { + t.Fatal(fmt.Errorf("Error parsing %s: %v", f, err)) + } + + if c.Privileged != false { + t.Fatalf("Expected privileged false, found %v\n", c.Privileged) + } + + if l := len(c.Binds); l != 1 { + t.Fatalf("Expected 1 bind, found %d\n", l) + } + + if c.CapAdd.Len() != 1 && c.CapAdd.Slice()[0] != "NET_ADMIN" { + t.Fatalf("Expected CapAdd NET_ADMIN, got %v", c.CapAdd) + } + + if c.CapDrop.Len() != 1 && c.CapDrop.Slice()[0] != "NET_ADMIN" { + t.Fatalf("Expected CapDrop MKNOD, got %v", c.CapDrop) + } + } +} diff --git a/runconfig/hostconfig_unix.go b/runconfig/hostconfig_unix.go new file mode 100644 index 0000000000..fd0b988eb8 --- /dev/null +++ b/runconfig/hostconfig_unix.go @@ -0,0 +1,91 @@ +// +build !windows + +package runconfig + +import ( + "strings" +) + +// IsPrivate indicates whether container uses it's private network stack. +func (n NetworkMode) IsPrivate() bool { + return !(n.IsHost() || n.IsContainer()) +} + +// IsDefault indicates whether container uses the default network stack. +func (n NetworkMode) IsDefault() bool { + return n == "default" +} + +// DefaultDaemonNetworkMode returns the default network stack the daemon should +// use. +func DefaultDaemonNetworkMode() NetworkMode { + return NetworkMode("bridge") +} + +// NetworkName returns the name of the network stack. +func (n NetworkMode) NetworkName() string { + if n.IsBridge() { + return "bridge" + } else if n.IsHost() { + return "host" + } else if n.IsContainer() { + return "container" + } else if n.IsNone() { + return "none" + } else if n.IsDefault() { + return "default" + } else if n.IsUserDefined() { + return n.UserDefined() + } + return "" +} + +// IsBridge indicates whether container uses the bridge network stack +func (n NetworkMode) IsBridge() bool { + return n == "bridge" +} + +// IsHost indicates whether container uses the host network stack. +func (n NetworkMode) IsHost() bool { + return n == "host" +} + +// IsContainer indicates whether container uses a container network stack. +func (n NetworkMode) IsContainer() bool { + parts := strings.SplitN(string(n), ":", 2) + return len(parts) > 1 && parts[0] == "container" +} + +// IsNone indicates whether container isn't using a network stack. +func (n NetworkMode) IsNone() bool { + return n == "none" +} + +// IsUserDefined indicates user-created network +func (n NetworkMode) IsUserDefined() bool { + return !n.IsDefault() && !n.IsBridge() && !n.IsHost() && !n.IsNone() && !n.IsContainer() +} + +// IsPreDefinedNetwork indicates if a network is predefined by the daemon +func IsPreDefinedNetwork(network string) bool { + n := NetworkMode(network) + return n.IsBridge() || n.IsHost() || n.IsNone() +} + +//UserDefined indicates user-created network +func (n NetworkMode) UserDefined() string { + if n.IsUserDefined() { + return string(n) + } + return "" +} + +// MergeConfigs merges the specified container Config and HostConfig. +// It creates a ContainerConfigWrapper. +func MergeConfigs(config *Config, hostConfig *HostConfig) *ContainerConfigWrapper { + return &ContainerConfigWrapper{ + config, + hostConfig, + "", nil, + } +} diff --git a/runconfig/hostconfig_windows.go b/runconfig/hostconfig_windows.go new file mode 100644 index 0000000000..d21e082280 --- /dev/null +++ b/runconfig/hostconfig_windows.go @@ -0,0 +1,34 @@ +package runconfig + +// IsDefault indicates whether container uses the default network stack. +func (n NetworkMode) IsDefault() bool { + return n == "default" +} + +// DefaultDaemonNetworkMode returns the default network stack the daemon should +// use. +func DefaultDaemonNetworkMode() NetworkMode { + return NetworkMode("default") +} + +// NetworkName returns the name of the network stack. +func (n NetworkMode) NetworkName() string { + if n.IsDefault() { + return "default" + } + return "" +} + +// MergeConfigs merges the specified container Config and HostConfig. +// It creates a ContainerConfigWrapper. +func MergeConfigs(config *Config, hostConfig *HostConfig) *ContainerConfigWrapper { + return &ContainerConfigWrapper{ + config, + hostConfig, + } +} + +// IsPreDefinedNetwork indicates if a network is predefined by the daemon +func IsPreDefinedNetwork(network string) bool { + return false +} diff --git a/runconfig/merge.go b/runconfig/merge.go new file mode 100644 index 0000000000..0106c7ea11 --- /dev/null +++ b/runconfig/merge.go @@ -0,0 +1,80 @@ +package runconfig + +import ( + "strings" + + "github.com/docker/docker/pkg/nat" +) + +// Merge merges two Config, the image container configuration (defaults values), +// and the user container configuration, either passed by the API or generated +// by the cli. +// It will mutate the specified user configuration (userConf) with the image +// configuration where the user configuration is incomplete. +func Merge(userConf, imageConf *Config) error { + if userConf.User == "" { + userConf.User = imageConf.User + } + if len(userConf.ExposedPorts) == 0 { + userConf.ExposedPorts = imageConf.ExposedPorts + } else if imageConf.ExposedPorts != nil { + if userConf.ExposedPorts == nil { + userConf.ExposedPorts = make(nat.PortSet) + } + for port := range imageConf.ExposedPorts { + if _, exists := userConf.ExposedPorts[port]; !exists { + userConf.ExposedPorts[port] = struct{}{} + } + } + } + + if len(userConf.Env) == 0 { + userConf.Env = imageConf.Env + } else { + for _, imageEnv := range imageConf.Env { + found := false + imageEnvKey := strings.Split(imageEnv, "=")[0] + for _, userEnv := range userConf.Env { + userEnvKey := strings.Split(userEnv, "=")[0] + if imageEnvKey == userEnvKey { + found = true + break + } + } + if !found { + userConf.Env = append(userConf.Env, imageEnv) + } + } + } + + if userConf.Labels == nil { + userConf.Labels = map[string]string{} + } + if imageConf.Labels != nil { + for l := range userConf.Labels { + imageConf.Labels[l] = userConf.Labels[l] + } + userConf.Labels = imageConf.Labels + } + + if userConf.Entrypoint.Len() == 0 { + if userConf.Cmd.Len() == 0 { + userConf.Cmd = imageConf.Cmd + } + + if userConf.Entrypoint == nil { + userConf.Entrypoint = imageConf.Entrypoint + } + } + if userConf.WorkingDir == "" { + userConf.WorkingDir = imageConf.WorkingDir + } + if len(userConf.Volumes) == 0 { + userConf.Volumes = imageConf.Volumes + } else { + for k, v := range imageConf.Volumes { + userConf.Volumes[k] = v + } + } + return nil +} diff --git a/runconfig/merge_test.go b/runconfig/merge_test.go new file mode 100644 index 0000000000..6237ee9df0 --- /dev/null +++ b/runconfig/merge_test.go @@ -0,0 +1,83 @@ +package runconfig + +import ( + "testing" + + "github.com/docker/docker/pkg/nat" +) + +func TestMerge(t *testing.T) { + volumesImage := make(map[string]struct{}) + volumesImage["/test1"] = struct{}{} + volumesImage["/test2"] = struct{}{} + portsImage := make(nat.PortSet) + portsImage[newPortNoError("tcp", "1111")] = struct{}{} + portsImage[newPortNoError("tcp", "2222")] = struct{}{} + configImage := &Config{ + ExposedPorts: portsImage, + Env: []string{"VAR1=1", "VAR2=2"}, + Volumes: volumesImage, + } + + portsUser := make(nat.PortSet) + portsUser[newPortNoError("tcp", "2222")] = struct{}{} + portsUser[newPortNoError("tcp", "3333")] = struct{}{} + volumesUser := make(map[string]struct{}) + volumesUser["/test3"] = struct{}{} + configUser := &Config{ + ExposedPorts: portsUser, + Env: []string{"VAR2=3", "VAR3=3"}, + Volumes: volumesUser, + } + + if err := Merge(configUser, configImage); err != nil { + t.Error(err) + } + + if len(configUser.ExposedPorts) != 3 { + t.Fatalf("Expected 3 ExposedPorts, 1111, 2222 and 3333, found %d", len(configUser.ExposedPorts)) + } + for portSpecs := range configUser.ExposedPorts { + if portSpecs.Port() != "1111" && portSpecs.Port() != "2222" && portSpecs.Port() != "3333" { + t.Fatalf("Expected 1111 or 2222 or 3333, found %s", portSpecs) + } + } + if len(configUser.Env) != 3 { + t.Fatalf("Expected 3 env var, VAR1=1, VAR2=3 and VAR3=3, found %d", len(configUser.Env)) + } + for _, env := range configUser.Env { + if env != "VAR1=1" && env != "VAR2=3" && env != "VAR3=3" { + t.Fatalf("Expected VAR1=1 or VAR2=3 or VAR3=3, found %s", env) + } + } + + if len(configUser.Volumes) != 3 { + t.Fatalf("Expected 3 volumes, /test1, /test2 and /test3, found %d", len(configUser.Volumes)) + } + for v := range configUser.Volumes { + if v != "/test1" && v != "/test2" && v != "/test3" { + t.Fatalf("Expected /test1 or /test2 or /test3, found %s", v) + } + } + + ports, _, err := nat.ParsePortSpecs([]string{"0000"}) + if err != nil { + t.Error(err) + } + configImage2 := &Config{ + ExposedPorts: ports, + } + + if err := Merge(configUser, configImage2); err != nil { + t.Error(err) + } + + if len(configUser.ExposedPorts) != 4 { + t.Fatalf("Expected 4 ExposedPorts, 0000, 1111, 2222 and 3333, found %d", len(configUser.ExposedPorts)) + } + for portSpecs := range configUser.ExposedPorts { + if portSpecs.Port() != "0" && portSpecs.Port() != "1111" && portSpecs.Port() != "2222" && portSpecs.Port() != "3333" { + t.Fatalf("Expected %q or %q or %q or %q, found %s", 0, 1111, 2222, 3333, portSpecs) + } + } +} diff --git a/runconfig/parse.go b/runconfig/parse.go new file mode 100644 index 0000000000..d0b73c75bf --- /dev/null +++ b/runconfig/parse.go @@ -0,0 +1,524 @@ +package runconfig + +import ( + "fmt" + "strconv" + "strings" + + "github.com/docker/docker/opts" + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/signal" + "github.com/docker/docker/pkg/stringutils" + "github.com/docker/docker/pkg/units" +) + +var ( + // ErrConflictContainerNetworkAndLinks conflict between --net=container and links + ErrConflictContainerNetworkAndLinks = fmt.Errorf("Conflicting options: --net=container can't be used with links. This would result in undefined behavior") + // ErrConflictUserDefinedNetworkAndLinks conflict between --net= and links + ErrConflictUserDefinedNetworkAndLinks = fmt.Errorf("Conflicting options: --net= can't be used with links. This would result in undefined behavior") + // ErrConflictSharedNetwork conflict between private and other networks + ErrConflictSharedNetwork = fmt.Errorf("Container sharing network namespace with another container or host cannot be connected to any other network") + // ErrConflictHostNetwork conflict from being disconnected from host network or connected to host network. + ErrConflictHostNetwork = fmt.Errorf("Container cannot be disconnected from host network or connected to host network") + // ErrConflictNoNetwork conflict between private and other networks + ErrConflictNoNetwork = fmt.Errorf("Container cannot be connected to multiple networks with one of the networks in --none mode") + // ErrConflictNetworkAndDNS conflict between --dns and the network mode + ErrConflictNetworkAndDNS = fmt.Errorf("Conflicting options: --dns and the network mode (--net)") + // ErrConflictNetworkHostname conflict between the hostname and the network mode + ErrConflictNetworkHostname = fmt.Errorf("Conflicting options: -h and the network mode (--net)") + // ErrConflictHostNetworkAndLinks conflict between --net=host and links + ErrConflictHostNetworkAndLinks = fmt.Errorf("Conflicting options: --net=host can't be used with links. This would result in undefined behavior") + // ErrConflictContainerNetworkAndMac conflict between the mac address and the network mode + ErrConflictContainerNetworkAndMac = fmt.Errorf("Conflicting options: --mac-address and the network mode (--net)") + // ErrConflictNetworkHosts conflict between add-host and the network mode + ErrConflictNetworkHosts = fmt.Errorf("Conflicting options: --add-host and the network mode (--net)") + // ErrConflictNetworkPublishPorts conflict between the pulbish options and the network mode + ErrConflictNetworkPublishPorts = fmt.Errorf("Conflicting options: -p, -P, --publish-all, --publish and the network mode (--net)") + // ErrConflictNetworkExposePorts conflict between the expose option and the network mode + ErrConflictNetworkExposePorts = fmt.Errorf("Conflicting options: --expose and the network mode (--expose)") +) + +// Parse parses the specified args for the specified command and generates a Config, +// a HostConfig and returns them with the specified command. +// If the specified args are not valid, it will return an error. +func Parse(cmd *flag.FlagSet, args []string) (*Config, *HostConfig, *flag.FlagSet, error) { + var ( + // FIXME: use utils.ListOpts for attach and volumes? + flAttach = opts.NewListOpts(opts.ValidateAttach) + flVolumes = opts.NewListOpts(opts.ValidatePath) + flLinks = opts.NewListOpts(opts.ValidateLink) + flEnv = opts.NewListOpts(opts.ValidateEnv) + flLabels = opts.NewListOpts(opts.ValidateEnv) + flDevices = opts.NewListOpts(opts.ValidateDevice) + + flUlimits = opts.NewUlimitOpt(nil) + + flPublish = opts.NewListOpts(nil) + flExpose = opts.NewListOpts(nil) + flDNS = opts.NewListOpts(opts.ValidateIPAddress) + flDNSSearch = opts.NewListOpts(opts.ValidateDNSSearch) + flDNSOptions = opts.NewListOpts(nil) + flExtraHosts = opts.NewListOpts(opts.ValidateExtraHost) + flVolumesFrom = opts.NewListOpts(nil) + flLxcOpts = opts.NewListOpts(nil) + flEnvFile = opts.NewListOpts(nil) + flCapAdd = opts.NewListOpts(nil) + flCapDrop = opts.NewListOpts(nil) + flGroupAdd = opts.NewListOpts(nil) + flSecurityOpt = opts.NewListOpts(nil) + flLabelsFile = opts.NewListOpts(nil) + flLoggingOpts = opts.NewListOpts(nil) + + flNetwork = cmd.Bool([]string{"#n", "#-networking"}, true, "Enable networking for this container") + flPrivileged = cmd.Bool([]string{"#privileged", "-privileged"}, false, "Give extended privileges to this container") + flPidMode = cmd.String([]string{"-pid"}, "", "PID namespace to use") + flUTSMode = cmd.String([]string{"-uts"}, "", "UTS namespace to use") + flPublishAll = cmd.Bool([]string{"P", "-publish-all"}, false, "Publish all exposed ports to random ports") + flStdin = cmd.Bool([]string{"i", "-interactive"}, false, "Keep STDIN open even if not attached") + flTty = cmd.Bool([]string{"t", "-tty"}, false, "Allocate a pseudo-TTY") + flOomKillDisable = cmd.Bool([]string{"-oom-kill-disable"}, false, "Disable OOM Killer") + flContainerIDFile = cmd.String([]string{"#cidfile", "-cidfile"}, "", "Write the container ID to the file") + flEntrypoint = cmd.String([]string{"#entrypoint", "-entrypoint"}, "", "Overwrite the default ENTRYPOINT of the image") + flHostname = cmd.String([]string{"h", "-hostname"}, "", "Container host name") + flMemoryString = cmd.String([]string{"m", "-memory"}, "", "Memory limit") + flMemoryReservation = cmd.String([]string{"-memory-reservation"}, "", "Memory soft limit") + flMemorySwap = cmd.String([]string{"-memory-swap"}, "", "Total memory (memory + swap), '-1' to disable swap") + flKernelMemory = cmd.String([]string{"-kernel-memory"}, "", "Kernel memory limit") + flUser = cmd.String([]string{"u", "-user"}, "", "Username or UID (format: [:])") + flWorkingDir = cmd.String([]string{"w", "-workdir"}, "", "Working directory inside the container") + flCPUShares = cmd.Int64([]string{"#c", "-cpu-shares"}, 0, "CPU shares (relative weight)") + flCPUPeriod = cmd.Int64([]string{"-cpu-period"}, 0, "Limit CPU CFS (Completely Fair Scheduler) period") + flCPUQuota = cmd.Int64([]string{"-cpu-quota"}, 0, "Limit CPU CFS (Completely Fair Scheduler) quota") + flCpusetCpus = cmd.String([]string{"#-cpuset", "-cpuset-cpus"}, "", "CPUs in which to allow execution (0-3, 0,1)") + flCpusetMems = cmd.String([]string{"-cpuset-mems"}, "", "MEMs in which to allow execution (0-3, 0,1)") + flBlkioWeight = cmd.Uint16([]string{"-blkio-weight"}, 0, "Block IO (relative weight), between 10 and 1000") + flSwappiness = cmd.Int64([]string{"-memory-swappiness"}, -1, "Tuning container memory swappiness (0 to 100)") + flNetMode = cmd.String([]string{"-net"}, "default", "Set the Network for the container") + flMacAddress = cmd.String([]string{"-mac-address"}, "", "Container MAC address (e.g. 92:d0:c6:0a:29:33)") + flIpcMode = cmd.String([]string{"-ipc"}, "", "IPC namespace to use") + flRestartPolicy = cmd.String([]string{"-restart"}, "no", "Restart policy to apply when a container exits") + flReadonlyRootfs = cmd.Bool([]string{"-read-only"}, false, "Mount the container's root filesystem as read only") + flLoggingDriver = cmd.String([]string{"-log-driver"}, "", "Logging driver for container") + flCgroupParent = cmd.String([]string{"-cgroup-parent"}, "", "Optional parent cgroup for the container") + flVolumeDriver = cmd.String([]string{"-volume-driver"}, "", "Optional volume driver for the container") + flStopSignal = cmd.String([]string{"-stop-signal"}, signal.DefaultStopSignal, fmt.Sprintf("Signal to stop a container, %v by default", signal.DefaultStopSignal)) + ) + + cmd.Var(&flAttach, []string{"a", "-attach"}, "Attach to STDIN, STDOUT or STDERR") + cmd.Var(&flVolumes, []string{"v", "-volume"}, "Bind mount a volume") + cmd.Var(&flLinks, []string{"#link", "-link"}, "Add link to another container") + cmd.Var(&flDevices, []string{"-device"}, "Add a host device to the container") + cmd.Var(&flLabels, []string{"l", "-label"}, "Set meta data on a container") + cmd.Var(&flLabelsFile, []string{"-label-file"}, "Read in a line delimited file of labels") + cmd.Var(&flEnv, []string{"e", "-env"}, "Set environment variables") + cmd.Var(&flEnvFile, []string{"-env-file"}, "Read in a file of environment variables") + cmd.Var(&flPublish, []string{"p", "-publish"}, "Publish a container's port(s) to the host") + cmd.Var(&flExpose, []string{"#expose", "-expose"}, "Expose a port or a range of ports") + cmd.Var(&flDNS, []string{"#dns", "-dns"}, "Set custom DNS servers") + cmd.Var(&flDNSSearch, []string{"-dns-search"}, "Set custom DNS search domains") + cmd.Var(&flDNSOptions, []string{"-dns-opt"}, "Set DNS options") + cmd.Var(&flExtraHosts, []string{"-add-host"}, "Add a custom host-to-IP mapping (host:ip)") + cmd.Var(&flVolumesFrom, []string{"#volumes-from", "-volumes-from"}, "Mount volumes from the specified container(s)") + cmd.Var(&flLxcOpts, []string{"#lxc-conf", "-lxc-conf"}, "Add custom lxc options") + cmd.Var(&flCapAdd, []string{"-cap-add"}, "Add Linux capabilities") + cmd.Var(&flCapDrop, []string{"-cap-drop"}, "Drop Linux capabilities") + cmd.Var(&flGroupAdd, []string{"-group-add"}, "Add additional groups to join") + cmd.Var(&flSecurityOpt, []string{"-security-opt"}, "Security Options") + cmd.Var(flUlimits, []string{"-ulimit"}, "Ulimit options") + cmd.Var(&flLoggingOpts, []string{"-log-opt"}, "Log driver options") + + cmd.Require(flag.Min, 1) + + if err := cmd.ParseFlags(args, true); err != nil { + return nil, nil, cmd, err + } + + var ( + attachStdin = flAttach.Get("stdin") + attachStdout = flAttach.Get("stdout") + attachStderr = flAttach.Get("stderr") + ) + + // Validate the input mac address + if *flMacAddress != "" { + if _, err := opts.ValidateMACAddress(*flMacAddress); err != nil { + return nil, nil, cmd, fmt.Errorf("%s is not a valid mac address", *flMacAddress) + } + } + if *flStdin { + attachStdin = true + } + // If -a is not set attach to the output stdio + if flAttach.Len() == 0 { + attachStdout = true + attachStderr = true + } + + var err error + + var flMemory int64 + if *flMemoryString != "" { + flMemory, err = units.RAMInBytes(*flMemoryString) + if err != nil { + return nil, nil, cmd, err + } + } + + var MemoryReservation int64 + if *flMemoryReservation != "" { + MemoryReservation, err = units.RAMInBytes(*flMemoryReservation) + if err != nil { + return nil, nil, cmd, err + } + } + + var memorySwap int64 + if *flMemorySwap != "" { + if *flMemorySwap == "-1" { + memorySwap = -1 + } else { + memorySwap, err = units.RAMInBytes(*flMemorySwap) + if err != nil { + return nil, nil, cmd, err + } + } + } + + var KernelMemory int64 + if *flKernelMemory != "" { + KernelMemory, err = units.RAMInBytes(*flKernelMemory) + if err != nil { + return nil, nil, cmd, err + } + } + + swappiness := *flSwappiness + if swappiness != -1 && (swappiness < 0 || swappiness > 100) { + return nil, nil, cmd, fmt.Errorf("Invalid value: %d. Valid memory swappiness range is 0-100", swappiness) + } + + var binds []string + // add any bind targets to the list of container volumes + for bind := range flVolumes.GetMap() { + if arr := strings.Split(bind, ":"); len(arr) > 1 { + if arr[1] == "/" { + return nil, nil, cmd, fmt.Errorf("Invalid bind mount: destination can't be '/'") + } + // after creating the bind mount we want to delete it from the flVolumes values because + // we do not want bind mounts being committed to image configs + binds = append(binds, bind) + flVolumes.Delete(bind) + } else if bind == "/" { + return nil, nil, cmd, fmt.Errorf("Invalid volume: path can't be '/'") + } + } + + var ( + parsedArgs = cmd.Args() + runCmd *stringutils.StrSlice + entrypoint *stringutils.StrSlice + image = cmd.Arg(0) + ) + if len(parsedArgs) > 1 { + runCmd = stringutils.NewStrSlice(parsedArgs[1:]...) + } + if *flEntrypoint != "" { + entrypoint = stringutils.NewStrSlice(*flEntrypoint) + } + + lc, err := parseKeyValueOpts(flLxcOpts) + if err != nil { + return nil, nil, cmd, err + } + lxcConf := NewLxcConfig(lc) + + var ( + domainname string + hostname = *flHostname + parts = strings.SplitN(hostname, ".", 2) + ) + if len(parts) > 1 { + hostname = parts[0] + domainname = parts[1] + } + + ports, portBindings, err := nat.ParsePortSpecs(flPublish.GetAll()) + if err != nil { + return nil, nil, cmd, err + } + + // Merge in exposed ports to the map of published ports + for _, e := range flExpose.GetAll() { + if strings.Contains(e, ":") { + return nil, nil, cmd, fmt.Errorf("Invalid port format for --expose: %s", e) + } + //support two formats for expose, original format /[] or /[] + proto, port := nat.SplitProtoPort(e) + //parse the start and end port and create a sequence of ports to expose + //if expose a port, the start and end port are the same + start, end, err := parsers.ParsePortRange(port) + if err != nil { + return nil, nil, cmd, fmt.Errorf("Invalid range format for --expose: %s, error: %s", e, err) + } + for i := start; i <= end; i++ { + p, err := nat.NewPort(proto, strconv.FormatUint(i, 10)) + if err != nil { + return nil, nil, cmd, err + } + if _, exists := ports[p]; !exists { + ports[p] = struct{}{} + } + } + } + + // parse device mappings + deviceMappings := []DeviceMapping{} + for _, device := range flDevices.GetAll() { + deviceMapping, err := ParseDevice(device) + if err != nil { + return nil, nil, cmd, err + } + deviceMappings = append(deviceMappings, deviceMapping) + } + + // collect all the environment variables for the container + envVariables, err := readKVStrings(flEnvFile.GetAll(), flEnv.GetAll()) + if err != nil { + return nil, nil, cmd, err + } + + // collect all the labels for the container + labels, err := readKVStrings(flLabelsFile.GetAll(), flLabels.GetAll()) + if err != nil { + return nil, nil, cmd, err + } + + ipcMode := IpcMode(*flIpcMode) + if !ipcMode.Valid() { + return nil, nil, cmd, fmt.Errorf("--ipc: invalid IPC mode") + } + + pidMode := PidMode(*flPidMode) + if !pidMode.Valid() { + return nil, nil, cmd, fmt.Errorf("--pid: invalid PID mode") + } + + utsMode := UTSMode(*flUTSMode) + if !utsMode.Valid() { + return nil, nil, cmd, fmt.Errorf("--uts: invalid UTS mode") + } + + restartPolicy, err := ParseRestartPolicy(*flRestartPolicy) + if err != nil { + return nil, nil, cmd, err + } + + loggingOpts, err := parseLoggingOpts(*flLoggingDriver, flLoggingOpts.GetAll()) + if err != nil { + return nil, nil, cmd, err + } + + config := &Config{ + Hostname: hostname, + Domainname: domainname, + ExposedPorts: ports, + User: *flUser, + Tty: *flTty, + NetworkDisabled: !*flNetwork, + OpenStdin: *flStdin, + AttachStdin: attachStdin, + AttachStdout: attachStdout, + AttachStderr: attachStderr, + Env: envVariables, + Cmd: runCmd, + Image: image, + Volumes: flVolumes.GetMap(), + MacAddress: *flMacAddress, + Entrypoint: entrypoint, + WorkingDir: *flWorkingDir, + Labels: ConvertKVStringsToMap(labels), + StopSignal: *flStopSignal, + } + + hostConfig := &HostConfig{ + Binds: binds, + ContainerIDFile: *flContainerIDFile, + LxcConf: lxcConf, + Memory: flMemory, + MemoryReservation: MemoryReservation, + MemorySwap: memorySwap, + KernelMemory: KernelMemory, + CPUShares: *flCPUShares, + CPUPeriod: *flCPUPeriod, + CpusetCpus: *flCpusetCpus, + CpusetMems: *flCpusetMems, + CPUQuota: *flCPUQuota, + BlkioWeight: *flBlkioWeight, + OomKillDisable: *flOomKillDisable, + MemorySwappiness: flSwappiness, + Privileged: *flPrivileged, + PortBindings: portBindings, + Links: flLinks.GetAll(), + PublishAllPorts: *flPublishAll, + // Make sure the dns fields are never nil. + // New containers don't ever have those fields nil, + // but pre created containers can still have those nil values. + // See https://github.com/docker/docker/pull/17779 + // for a more detailed explanation on why we don't want that. + DNS: flDNS.GetAllOrEmpty(), + DNSSearch: flDNSSearch.GetAllOrEmpty(), + DNSOptions: flDNSOptions.GetAllOrEmpty(), + ExtraHosts: flExtraHosts.GetAll(), + VolumesFrom: flVolumesFrom.GetAll(), + NetworkMode: NetworkMode(*flNetMode), + IpcMode: ipcMode, + PidMode: pidMode, + UTSMode: utsMode, + Devices: deviceMappings, + CapAdd: stringutils.NewStrSlice(flCapAdd.GetAll()...), + CapDrop: stringutils.NewStrSlice(flCapDrop.GetAll()...), + GroupAdd: flGroupAdd.GetAll(), + RestartPolicy: restartPolicy, + SecurityOpt: flSecurityOpt.GetAll(), + ReadonlyRootfs: *flReadonlyRootfs, + Ulimits: flUlimits.GetList(), + LogConfig: LogConfig{Type: *flLoggingDriver, Config: loggingOpts}, + CgroupParent: *flCgroupParent, + VolumeDriver: *flVolumeDriver, + } + + // When allocating stdin in attached mode, close stdin at client disconnect + if config.OpenStdin && config.AttachStdin { + config.StdinOnce = true + } + return config, hostConfig, cmd, nil +} + +// reads a file of line terminated key=value pairs and override that with override parameter +func readKVStrings(files []string, override []string) ([]string, error) { + envVariables := []string{} + for _, ef := range files { + parsedVars, err := opts.ParseEnvFile(ef) + if err != nil { + return nil, err + } + envVariables = append(envVariables, parsedVars...) + } + // parse the '-e' and '--env' after, to allow override + envVariables = append(envVariables, override...) + + return envVariables, nil +} + +// ConvertKVStringsToMap converts ["key=value"] to {"key":"value"} +func ConvertKVStringsToMap(values []string) map[string]string { + result := make(map[string]string, len(values)) + for _, value := range values { + kv := strings.SplitN(value, "=", 2) + if len(kv) == 1 { + result[kv[0]] = "" + } else { + result[kv[0]] = kv[1] + } + } + + return result +} + +func parseLoggingOpts(loggingDriver string, loggingOpts []string) (map[string]string, error) { + loggingOptsMap := ConvertKVStringsToMap(loggingOpts) + if loggingDriver == "none" && len(loggingOpts) > 0 { + return map[string]string{}, fmt.Errorf("Invalid logging opts for driver %s", loggingDriver) + } + return loggingOptsMap, nil +} + +// ParseRestartPolicy returns the parsed policy or an error indicating what is incorrect +func ParseRestartPolicy(policy string) (RestartPolicy, error) { + p := RestartPolicy{} + + if policy == "" { + return p, nil + } + + var ( + parts = strings.Split(policy, ":") + name = parts[0] + ) + + p.Name = name + switch name { + case "always", "unless-stopped": + if len(parts) > 1 { + return p, fmt.Errorf("maximum restart count not valid with restart policy of \"%s\"", name) + } + case "no": + // do nothing + case "on-failure": + if len(parts) > 2 { + return p, fmt.Errorf("restart count format is not valid, usage: 'on-failure:N' or 'on-failure'") + } + if len(parts) == 2 { + count, err := strconv.Atoi(parts[1]) + if err != nil { + return p, err + } + + p.MaximumRetryCount = count + } + default: + return p, fmt.Errorf("invalid restart policy %s", name) + } + + return p, nil +} + +func parseKeyValueOpts(opts opts.ListOpts) ([]KeyValuePair, error) { + out := make([]KeyValuePair, opts.Len()) + for i, o := range opts.GetAll() { + k, v, err := parsers.ParseKeyValueOpt(o) + if err != nil { + return nil, err + } + out[i] = KeyValuePair{Key: k, Value: v} + } + return out, nil +} + +// ParseDevice parses a device mapping string to a DeviceMapping struct +func ParseDevice(device string) (DeviceMapping, error) { + src := "" + dst := "" + permissions := "rwm" + arr := strings.Split(device, ":") + switch len(arr) { + case 3: + permissions = arr[2] + fallthrough + case 2: + if opts.ValidDeviceMode(arr[1]) { + permissions = arr[1] + } else { + dst = arr[1] + } + fallthrough + case 1: + src = arr[0] + default: + return DeviceMapping{}, fmt.Errorf("Invalid device specification: %s", device) + } + + if dst == "" { + dst = src + } + + deviceMapping := DeviceMapping{ + PathOnHost: src, + PathInContainer: dst, + CgroupPermissions: permissions, + } + return deviceMapping, nil +} diff --git a/runconfig/parse_test.go b/runconfig/parse_test.go new file mode 100644 index 0000000000..4cae1c7c69 --- /dev/null +++ b/runconfig/parse_test.go @@ -0,0 +1,492 @@ +package runconfig + +import ( + "fmt" + "io/ioutil" + "strings" + "testing" + + flag "github.com/docker/docker/pkg/mflag" + "github.com/docker/docker/pkg/nat" + "github.com/docker/docker/pkg/parsers" +) + +func parseRun(args []string) (*Config, *HostConfig, *flag.FlagSet, error) { + cmd := flag.NewFlagSet("run", flag.ContinueOnError) + cmd.SetOutput(ioutil.Discard) + cmd.Usage = nil + return Parse(cmd, args) +} + +func parse(t *testing.T, args string) (*Config, *HostConfig, error) { + config, hostConfig, _, err := parseRun(strings.Split(args+" ubuntu bash", " ")) + return config, hostConfig, err +} + +func mustParse(t *testing.T, args string) (*Config, *HostConfig) { + config, hostConfig, err := parse(t, args) + if err != nil { + t.Fatal(err) + } + return config, hostConfig +} + +// check if (a == c && b == d) || (a == d && b == c) +// because maps are randomized +func compareRandomizedStrings(a, b, c, d string) error { + if a == c && b == d { + return nil + } + if a == d && b == c { + return nil + } + return fmt.Errorf("strings don't match") +} +func TestParseRunLinks(t *testing.T) { + if _, hostConfig := mustParse(t, "--link a:b"); len(hostConfig.Links) == 0 || hostConfig.Links[0] != "a:b" { + t.Fatalf("Error parsing links. Expected []string{\"a:b\"}, received: %v", hostConfig.Links) + } + if _, hostConfig := mustParse(t, "--link a:b --link c:d"); len(hostConfig.Links) < 2 || hostConfig.Links[0] != "a:b" || hostConfig.Links[1] != "c:d" { + t.Fatalf("Error parsing links. Expected []string{\"a:b\", \"c:d\"}, received: %v", hostConfig.Links) + } + if _, hostConfig := mustParse(t, ""); len(hostConfig.Links) != 0 { + t.Fatalf("Error parsing links. No link expected, received: %v", hostConfig.Links) + } +} + +func TestParseRunAttach(t *testing.T) { + if config, _ := mustParse(t, "-a stdin"); !config.AttachStdin || config.AttachStdout || config.AttachStderr { + t.Fatalf("Error parsing attach flags. Expect only Stdin enabled. Received: in: %v, out: %v, err: %v", config.AttachStdin, config.AttachStdout, config.AttachStderr) + } + if config, _ := mustParse(t, "-a stdin -a stdout"); !config.AttachStdin || !config.AttachStdout || config.AttachStderr { + t.Fatalf("Error parsing attach flags. Expect only Stdin and Stdout enabled. Received: in: %v, out: %v, err: %v", config.AttachStdin, config.AttachStdout, config.AttachStderr) + } + if config, _ := mustParse(t, "-a stdin -a stdout -a stderr"); !config.AttachStdin || !config.AttachStdout || !config.AttachStderr { + t.Fatalf("Error parsing attach flags. Expect all attach enabled. Received: in: %v, out: %v, err: %v", config.AttachStdin, config.AttachStdout, config.AttachStderr) + } + if config, _ := mustParse(t, ""); config.AttachStdin || !config.AttachStdout || !config.AttachStderr { + t.Fatalf("Error parsing attach flags. Expect Stdin disabled. Received: in: %v, out: %v, err: %v", config.AttachStdin, config.AttachStdout, config.AttachStderr) + } + if config, _ := mustParse(t, "-i"); !config.AttachStdin || !config.AttachStdout || !config.AttachStderr { + t.Fatalf("Error parsing attach flags. Expect Stdin enabled. Received: in: %v, out: %v, err: %v", config.AttachStdin, config.AttachStdout, config.AttachStderr) + } + + if _, _, err := parse(t, "-a"); err == nil { + t.Fatalf("Error parsing attach flags, `-a` should be an error but is not") + } + if _, _, err := parse(t, "-a invalid"); err == nil { + t.Fatalf("Error parsing attach flags, `-a invalid` should be an error but is not") + } + if _, _, err := parse(t, "-a invalid -a stdout"); err == nil { + t.Fatalf("Error parsing attach flags, `-a stdout -a invalid` should be an error but is not") + } + if _, _, err := parse(t, "-a stdout -a stderr -d"); err == nil { + t.Fatalf("Error parsing attach flags, `-a stdout -a stderr -d` should be an error but is not") + } + if _, _, err := parse(t, "-a stdin -d"); err == nil { + t.Fatalf("Error parsing attach flags, `-a stdin -d` should be an error but is not") + } + if _, _, err := parse(t, "-a stdout -d"); err == nil { + t.Fatalf("Error parsing attach flags, `-a stdout -d` should be an error but is not") + } + if _, _, err := parse(t, "-a stderr -d"); err == nil { + t.Fatalf("Error parsing attach flags, `-a stderr -d` should be an error but is not") + } + if _, _, err := parse(t, "-d --rm"); err == nil { + t.Fatalf("Error parsing attach flags, `-d --rm` should be an error but is not") + } +} + +func TestParseRunVolumes(t *testing.T) { + if config, hostConfig := mustParse(t, "-v /tmp"); hostConfig.Binds != nil { + t.Fatalf("Error parsing volume flags, `-v /tmp` should not mount-bind anything. Received %v", hostConfig.Binds) + } else if _, exists := config.Volumes["/tmp"]; !exists { + t.Fatalf("Error parsing volume flags, `-v /tmp` is missing from volumes. Received %v", config.Volumes) + } + + if config, hostConfig := mustParse(t, "-v /tmp -v /var"); hostConfig.Binds != nil { + t.Fatalf("Error parsing volume flags, `-v /tmp -v /var` should not mount-bind anything. Received %v", hostConfig.Binds) + } else if _, exists := config.Volumes["/tmp"]; !exists { + t.Fatalf("Error parsing volume flags, `-v /tmp` is missing from volumes. Received %v", config.Volumes) + } else if _, exists := config.Volumes["/var"]; !exists { + t.Fatalf("Error parsing volume flags, `-v /var` is missing from volumes. Received %v", config.Volumes) + } + + if _, hostConfig := mustParse(t, "-v /hostTmp:/containerTmp"); hostConfig.Binds == nil || hostConfig.Binds[0] != "/hostTmp:/containerTmp" { + t.Fatalf("Error parsing volume flags, `-v /hostTmp:/containerTmp` should mount-bind /hostTmp into /containerTmp. Received %v", hostConfig.Binds) + } + + if _, hostConfig := mustParse(t, "-v /hostTmp:/containerTmp -v /hostVar:/containerVar"); hostConfig.Binds == nil || compareRandomizedStrings(hostConfig.Binds[0], hostConfig.Binds[1], "/hostTmp:/containerTmp", "/hostVar:/containerVar") != nil { + t.Fatalf("Error parsing volume flags, `-v /hostTmp:/containerTmp -v /hostVar:/containerVar` should mount-bind /hostTmp into /containerTmp and /hostVar into /hostContainer. Received %v", hostConfig.Binds) + } + + if _, hostConfig := mustParse(t, "-v /hostTmp:/containerTmp:ro -v /hostVar:/containerVar:rw"); hostConfig.Binds == nil || compareRandomizedStrings(hostConfig.Binds[0], hostConfig.Binds[1], "/hostTmp:/containerTmp:ro", "/hostVar:/containerVar:rw") != nil { + t.Fatalf("Error parsing volume flags, `-v /hostTmp:/containerTmp:ro -v /hostVar:/containerVar:rw` should mount-bind /hostTmp into /containerTmp and /hostVar into /hostContainer. Received %v", hostConfig.Binds) + } + + if _, hostConfig := mustParse(t, "-v /containerTmp:ro -v /containerVar:rw"); hostConfig.Binds == nil || compareRandomizedStrings(hostConfig.Binds[0], hostConfig.Binds[1], "/containerTmp:ro", "/containerVar:rw") != nil { + t.Fatalf("Error parsing volume flags, `-v /containerTmp:ro -v /containerVar:rw` should mount-bind /containerTmp into /ro and /containerVar into /rw. Received %v", hostConfig.Binds) + } + + if _, hostConfig := mustParse(t, "-v /hostTmp:/containerTmp:ro,Z -v /hostVar:/containerVar:rw,Z"); hostConfig.Binds == nil || compareRandomizedStrings(hostConfig.Binds[0], hostConfig.Binds[1], "/hostTmp:/containerTmp:ro,Z", "/hostVar:/containerVar:rw,Z") != nil { + t.Fatalf("Error parsing volume flags, `-v /hostTmp:/containerTmp:ro,Z -v /hostVar:/containerVar:rw,Z` should mount-bind /hostTmp into /containerTmp and /hostVar into /hostContainer. Received %v", hostConfig.Binds) + } + + if _, hostConfig := mustParse(t, "-v /hostTmp:/containerTmp:Z -v /hostVar:/containerVar:z"); hostConfig.Binds == nil || compareRandomizedStrings(hostConfig.Binds[0], hostConfig.Binds[1], "/hostTmp:/containerTmp:Z", "/hostVar:/containerVar:z") != nil { + t.Fatalf("Error parsing volume flags, `-v /hostTmp:/containerTmp:Z -v /hostVar:/containerVar:z` should mount-bind /hostTmp into /containerTmp and /hostVar into /hostContainer. Received %v", hostConfig.Binds) + } + + if config, hostConfig := mustParse(t, "-v /hostTmp:/containerTmp -v /containerVar"); hostConfig.Binds == nil || len(hostConfig.Binds) > 1 || hostConfig.Binds[0] != "/hostTmp:/containerTmp" { + t.Fatalf("Error parsing volume flags, `-v /hostTmp:/containerTmp -v /containerVar` should mount-bind only /hostTmp into /containerTmp. Received %v", hostConfig.Binds) + } else if _, exists := config.Volumes["/containerVar"]; !exists { + t.Fatalf("Error parsing volume flags, `-v /containerVar` is missing from volumes. Received %v", config.Volumes) + } + + if config, hostConfig := mustParse(t, ""); hostConfig.Binds != nil { + t.Fatalf("Error parsing volume flags, without volume, nothing should be mount-binded. Received %v", hostConfig.Binds) + } else if len(config.Volumes) != 0 { + t.Fatalf("Error parsing volume flags, without volume, no volume should be present. Received %v", config.Volumes) + } + + if _, _, err := parse(t, "-v /"); err == nil { + t.Fatalf("Expected error, but got none") + } + + if _, _, err := parse(t, "-v /:/"); err == nil { + t.Fatalf("Error parsing volume flags, `-v /:/` should fail but didn't") + } + if _, _, err := parse(t, "-v"); err == nil { + t.Fatalf("Error parsing volume flags, `-v` should fail but didn't") + } + if _, _, err := parse(t, "-v /tmp:"); err == nil { + t.Fatalf("Error parsing volume flags, `-v /tmp:` should fail but didn't") + } + if _, _, err := parse(t, "-v /tmp::"); err == nil { + t.Fatalf("Error parsing volume flags, `-v /tmp::` should fail but didn't") + } + if _, _, err := parse(t, "-v :"); err == nil { + t.Fatalf("Error parsing volume flags, `-v :` should fail but didn't") + } + if _, _, err := parse(t, "-v ::"); err == nil { + t.Fatalf("Error parsing volume flags, `-v ::` should fail but didn't") + } + if _, _, err := parse(t, "-v /tmp:/tmp:/tmp:/tmp"); err == nil { + t.Fatalf("Error parsing volume flags, `-v /tmp:/tmp:/tmp:/tmp` should fail but didn't") + } +} + +func TestParseLxcConfOpt(t *testing.T) { + opts := []string{"lxc.utsname=docker", "lxc.utsname = docker "} + + for _, o := range opts { + k, v, err := parsers.ParseKeyValueOpt(o) + if err != nil { + t.FailNow() + } + if k != "lxc.utsname" { + t.Fail() + } + if v != "docker" { + t.Fail() + } + } + + // With parseRun too + _, hostconfig, _, err := parseRun([]string{"lxc.utsname=docker", "lxc.utsname = docker ", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + for _, lxcConf := range hostconfig.LxcConf.Slice() { + if lxcConf.Key != "lxc.utsname" || lxcConf.Value != "docker" { + t.Fail() + } + } + +} + +// Simple parse with MacAddress validatation +func TestParseWithMacAddress(t *testing.T) { + invalidMacAddress := "--mac-address=invalidMacAddress" + validMacAddress := "--mac-address=92:d0:c6:0a:29:33" + if _, _, _, err := parseRun([]string{invalidMacAddress, "img", "cmd"}); err != nil && err.Error() != "invalidMacAddress is not a valid mac address" { + t.Fatalf("Expected an error with %v mac-address, got %v", invalidMacAddress, err) + } + if config, _ := mustParse(t, validMacAddress); config.MacAddress != "92:d0:c6:0a:29:33" { + t.Fatalf("Expected the config to have '92:d0:c6:0a:29:33' as MacAddress, got '%v'", config.MacAddress) + } +} + +func TestParseWithMemory(t *testing.T) { + invalidMemory := "--memory=invalid" + validMemory := "--memory=1G" + if _, _, _, err := parseRun([]string{invalidMemory, "img", "cmd"}); err != nil && err.Error() != "invalid size: 'invalid'" { + t.Fatalf("Expected an error with '%v' Memory, got '%v'", invalidMemory, err) + } + if _, hostconfig := mustParse(t, validMemory); hostconfig.Memory != 1073741824 { + t.Fatalf("Expected the config to have '1G' as Memory, got '%v'", hostconfig.Memory) + } +} + +func TestParseWithMemorySwap(t *testing.T) { + invalidMemory := "--memory-swap=invalid" + validMemory := "--memory-swap=1G" + anotherValidMemory := "--memory-swap=-1" + if _, _, _, err := parseRun([]string{invalidMemory, "img", "cmd"}); err == nil || err.Error() != "invalid size: 'invalid'" { + t.Fatalf("Expected an error with '%v' MemorySwap, got '%v'", invalidMemory, err) + } + if _, hostconfig := mustParse(t, validMemory); hostconfig.MemorySwap != 1073741824 { + t.Fatalf("Expected the config to have '1073741824' as MemorySwap, got '%v'", hostconfig.MemorySwap) + } + if _, hostconfig := mustParse(t, anotherValidMemory); hostconfig.MemorySwap != -1 { + t.Fatalf("Expected the config to have '-1' as MemorySwap, got '%v'", hostconfig.MemorySwap) + } +} + +func TestParseHostname(t *testing.T) { + hostname := "--hostname=hostname" + hostnameWithDomain := "--hostname=hostname.domainname" + hostnameWithDomainTld := "--hostname=hostname.domainname.tld" + if config, _ := mustParse(t, hostname); config.Hostname != "hostname" && config.Domainname != "" { + t.Fatalf("Expected the config to have 'hostname' as hostname, got '%v'", config.Hostname) + } + if config, _ := mustParse(t, hostnameWithDomain); config.Hostname != "hostname" && config.Domainname != "domainname" { + t.Fatalf("Expected the config to have 'hostname' as hostname, got '%v'", config.Hostname) + } + if config, _ := mustParse(t, hostnameWithDomainTld); config.Hostname != "hostname" && config.Domainname != "domainname.tld" { + t.Fatalf("Expected the config to have 'hostname' as hostname, got '%v'", config.Hostname) + } +} + +func TestParseWithExpose(t *testing.T) { + invalids := map[string]string{ + ":": "Invalid port format for --expose: :", + "8080:9090": "Invalid port format for --expose: 8080:9090", + "/tcp": "Invalid range format for --expose: /tcp, error: Empty string specified for ports.", + "/udp": "Invalid range format for --expose: /udp, error: Empty string specified for ports.", + "NaN/tcp": `Invalid range format for --expose: NaN/tcp, error: strconv.ParseUint: parsing "NaN": invalid syntax`, + "NaN-NaN/tcp": `Invalid range format for --expose: NaN-NaN/tcp, error: strconv.ParseUint: parsing "NaN": invalid syntax`, + "8080-NaN/tcp": `Invalid range format for --expose: 8080-NaN/tcp, error: strconv.ParseUint: parsing "NaN": invalid syntax`, + "1234567890-8080/tcp": `Invalid range format for --expose: 1234567890-8080/tcp, error: strconv.ParseUint: parsing "1234567890": value out of range`, + } + valids := map[string][]nat.Port{ + "8080/tcp": {"8080/tcp"}, + "8080/udp": {"8080/udp"}, + "8080/ncp": {"8080/ncp"}, + "8080-8080/udp": {"8080/udp"}, + "8080-8082/tcp": {"8080/tcp", "8081/tcp", "8082/tcp"}, + } + for expose, expectedError := range invalids { + if _, _, _, err := parseRun([]string{fmt.Sprintf("--expose=%v", expose), "img", "cmd"}); err == nil || err.Error() != expectedError { + t.Fatalf("Expected error '%v' with '--expose=%v', got '%v'", expectedError, expose, err) + } + } + for expose, exposedPorts := range valids { + config, _, _, err := parseRun([]string{fmt.Sprintf("--expose=%v", expose), "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(config.ExposedPorts) != len(exposedPorts) { + t.Fatalf("Expected %v exposed port, got %v", len(exposedPorts), len(config.ExposedPorts)) + } + for _, port := range exposedPorts { + if _, ok := config.ExposedPorts[port]; !ok { + t.Fatalf("Expected %v, got %v", exposedPorts, config.ExposedPorts) + } + } + } + // Merge with actual published port + config, _, _, err := parseRun([]string{"--publish=80", "--expose=80-81/tcp", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(config.ExposedPorts) != 2 { + t.Fatalf("Expected 2 exposed ports, got %v", config.ExposedPorts) + } + ports := []nat.Port{"80/tcp", "81/tcp"} + for _, port := range ports { + if _, ok := config.ExposedPorts[port]; !ok { + t.Fatalf("Expected %v, got %v", ports, config.ExposedPorts) + } + } +} + +func TestParseDevice(t *testing.T) { + valids := map[string]DeviceMapping{ + "/dev/snd": { + PathOnHost: "/dev/snd", + PathInContainer: "/dev/snd", + CgroupPermissions: "rwm", + }, + "/dev/snd:rw": { + PathOnHost: "/dev/snd", + PathInContainer: "/dev/snd", + CgroupPermissions: "rw", + }, + "/dev/snd:/something": { + PathOnHost: "/dev/snd", + PathInContainer: "/something", + CgroupPermissions: "rwm", + }, + "/dev/snd:/something:rw": { + PathOnHost: "/dev/snd", + PathInContainer: "/something", + CgroupPermissions: "rw", + }, + } + for device, deviceMapping := range valids { + _, hostconfig, _, err := parseRun([]string{fmt.Sprintf("--device=%v", device), "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(hostconfig.Devices) != 1 { + t.Fatalf("Expected 1 devices, got %v", hostconfig.Devices) + } + if hostconfig.Devices[0] != deviceMapping { + t.Fatalf("Expected %v, got %v", deviceMapping, hostconfig.Devices) + } + } + +} + +func TestParseModes(t *testing.T) { + // ipc ko + if _, _, _, err := parseRun([]string{"--ipc=container:", "img", "cmd"}); err == nil || err.Error() != "--ipc: invalid IPC mode" { + t.Fatalf("Expected an error with message '--ipc: invalid IPC mode', got %v", err) + } + // ipc ok + _, hostconfig, _, err := parseRun([]string{"--ipc=host", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if !hostconfig.IpcMode.Valid() { + t.Fatalf("Expected a valid IpcMode, got %v", hostconfig.IpcMode) + } + // pid ko + if _, _, _, err := parseRun([]string{"--pid=container:", "img", "cmd"}); err == nil || err.Error() != "--pid: invalid PID mode" { + t.Fatalf("Expected an error with message '--pid: invalid PID mode', got %v", err) + } + // pid ok + _, hostconfig, _, err = parseRun([]string{"--pid=host", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if !hostconfig.PidMode.Valid() { + t.Fatalf("Expected a valid PidMode, got %v", hostconfig.PidMode) + } + // uts ko + if _, _, _, err := parseRun([]string{"--uts=container:", "img", "cmd"}); err == nil || err.Error() != "--uts: invalid UTS mode" { + t.Fatalf("Expected an error with message '--uts: invalid UTS mode', got %v", err) + } + // uts ok + _, hostconfig, _, err = parseRun([]string{"--uts=host", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if !hostconfig.UTSMode.Valid() { + t.Fatalf("Expected a valid UTSMode, got %v", hostconfig.UTSMode) + } +} + +func TestParseRestartPolicy(t *testing.T) { + invalids := map[string]string{ + "something": "invalid restart policy something", + "always:2": "maximum restart count not valid with restart policy of \"always\"", + "always:2:3": "maximum restart count not valid with restart policy of \"always\"", + "on-failure:invalid": `strconv.ParseInt: parsing "invalid": invalid syntax`, + "on-failure:2:5": "restart count format is not valid, usage: 'on-failure:N' or 'on-failure'", + } + valids := map[string]RestartPolicy{ + "": {}, + "always": { + Name: "always", + MaximumRetryCount: 0, + }, + "on-failure:1": { + Name: "on-failure", + MaximumRetryCount: 1, + }, + } + for restart, expectedError := range invalids { + if _, _, _, err := parseRun([]string{fmt.Sprintf("--restart=%s", restart), "img", "cmd"}); err == nil || err.Error() != expectedError { + t.Fatalf("Expected an error with message '%v' for %v, got %v", expectedError, restart, err) + } + } + for restart, expected := range valids { + _, hostconfig, _, err := parseRun([]string{fmt.Sprintf("--restart=%v", restart), "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if hostconfig.RestartPolicy != expected { + t.Fatalf("Expected %v, got %v", expected, hostconfig.RestartPolicy) + } + } +} + +func TestParseLoggingOpts(t *testing.T) { + // logging opts ko + if _, _, _, err := parseRun([]string{"--log-driver=none", "--log-opt=anything", "img", "cmd"}); err == nil || err.Error() != "Invalid logging opts for driver none" { + t.Fatalf("Expected an error with message 'Invalid logging opts for driver none', got %v", err) + } + // logging opts ok + _, hostconfig, _, err := parseRun([]string{"--log-driver=syslog", "--log-opt=something", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if hostconfig.LogConfig.Type != "syslog" || len(hostconfig.LogConfig.Config) != 1 { + t.Fatalf("Expected a 'syslog' LogConfig with one config, got %v", hostconfig.RestartPolicy) + } +} + +func TestParseEnvfileVariables(t *testing.T) { + // env ko + if _, _, _, err := parseRun([]string{"--env-file=nonexistent", "img", "cmd"}); err == nil || err.Error() != "open nonexistent: no such file or directory" { + t.Fatalf("Expected an error with message 'open nonexistent: no such file or directory', got %v", err) + } + // env ok + config, _, _, err := parseRun([]string{"--env-file=fixtures/valid.env", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(config.Env) != 1 || config.Env[0] != "ENV1=value1" { + t.Fatalf("Expected a a config with [ENV1=value1], got %v", config.Env) + } + config, _, _, err = parseRun([]string{"--env-file=fixtures/valid.env", "--env=ENV2=value2", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(config.Env) != 2 || config.Env[0] != "ENV1=value1" || config.Env[1] != "ENV2=value2" { + t.Fatalf("Expected a a config with [ENV1=value1 ENV2=value2], got %v", config.Env) + } +} + +func TestParseLabelfileVariables(t *testing.T) { + // label ko + if _, _, _, err := parseRun([]string{"--label-file=nonexistent", "img", "cmd"}); err == nil || err.Error() != "open nonexistent: no such file or directory" { + t.Fatalf("Expected an error with message 'open nonexistent: no such file or directory', got %v", err) + } + // label ok + config, _, _, err := parseRun([]string{"--label-file=fixtures/valid.label", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(config.Labels) != 1 || config.Labels["LABEL1"] != "value1" { + t.Fatalf("Expected a a config with [LABEL1:value1], got %v", config.Labels) + } + config, _, _, err = parseRun([]string{"--label-file=fixtures/valid.label", "--label=LABEL2=value2", "img", "cmd"}) + if err != nil { + t.Fatal(err) + } + if len(config.Labels) != 2 || config.Labels["LABEL1"] != "value1" || config.Labels["LABEL2"] != "value2" { + t.Fatalf("Expected a a config with [LABEL1:value1 LABEL2:value2], got %v", config.Labels) + } +} + +func TestParseEntryPoint(t *testing.T) { + config, _, _, err := parseRun([]string{"--entrypoint=anything", "cmd", "img"}) + if err != nil { + t.Fatal(err) + } + if config.Entrypoint.Len() != 1 && config.Entrypoint.Slice()[0] != "anything" { + t.Fatalf("Expected entrypoint 'anything', got %v", config.Entrypoint) + } +} diff --git a/runconfig/parse_unix.go b/runconfig/parse_unix.go new file mode 100644 index 0000000000..fc1aa16d04 --- /dev/null +++ b/runconfig/parse_unix.go @@ -0,0 +1,60 @@ +// +build !windows + +package runconfig + +import ( + "fmt" + "strings" +) + +// ValidateNetMode ensures that the various combinations of requested +// network settings are valid. +func ValidateNetMode(c *Config, hc *HostConfig) error { + // We may not be passed a host config, such as in the case of docker commit + if hc == nil { + return nil + } + parts := strings.Split(string(hc.NetworkMode), ":") + if parts[0] == "container" { + if len(parts) < 2 || parts[1] == "" { + return fmt.Errorf("--net: invalid net mode: invalid container format container:") + } + } + + if (hc.NetworkMode.IsHost() || hc.NetworkMode.IsContainer()) && c.Hostname != "" { + return ErrConflictNetworkHostname + } + + if hc.NetworkMode.IsHost() && len(hc.Links) > 0 { + return ErrConflictHostNetworkAndLinks + } + + if hc.NetworkMode.IsContainer() && len(hc.Links) > 0 { + return ErrConflictContainerNetworkAndLinks + } + + if hc.NetworkMode.IsUserDefined() && len(hc.Links) > 0 { + return ErrConflictUserDefinedNetworkAndLinks + } + + if (hc.NetworkMode.IsHost() || hc.NetworkMode.IsContainer()) && len(hc.DNS) > 0 { + return ErrConflictNetworkAndDNS + } + + if (hc.NetworkMode.IsContainer() || hc.NetworkMode.IsHost()) && len(hc.ExtraHosts) > 0 { + return ErrConflictNetworkHosts + } + + if (hc.NetworkMode.IsContainer() || hc.NetworkMode.IsHost()) && c.MacAddress != "" { + return ErrConflictContainerNetworkAndMac + } + + if hc.NetworkMode.IsContainer() && (len(hc.PortBindings) > 0 || hc.PublishAllPorts == true) { + return ErrConflictNetworkPublishPorts + } + + if hc.NetworkMode.IsContainer() && len(c.ExposedPorts) > 0 { + return ErrConflictNetworkExposePorts + } + return nil +} diff --git a/runconfig/parse_windows.go b/runconfig/parse_windows.go new file mode 100644 index 0000000000..01e39c7f85 --- /dev/null +++ b/runconfig/parse_windows.go @@ -0,0 +1,22 @@ +package runconfig + +import ( + "fmt" + "strings" +) + +// ValidateNetMode ensures that the various combinations of requested +// network settings are valid. +func ValidateNetMode(c *Config, hc *HostConfig) error { + // We may not be passed a host config, such as in the case of docker commit + if hc == nil { + return nil + } + parts := strings.Split(string(hc.NetworkMode), ":") + switch mode := parts[0]; mode { + case "default", "none": + default: + return fmt.Errorf("invalid --net: %s", hc.NetworkMode) + } + return nil +} diff --git a/utils/experimental.go b/utils/experimental.go new file mode 100644 index 0000000000..ceed0cb3ff --- /dev/null +++ b/utils/experimental.go @@ -0,0 +1,9 @@ +// +build experimental + +package utils + +// ExperimentalBuild is a stub which always returns true for +// builds that include the "experimental" build tag +func ExperimentalBuild() bool { + return true +} diff --git a/utils/git.go b/utils/git.go new file mode 100644 index 0000000000..4d0bb16417 --- /dev/null +++ b/utils/git.go @@ -0,0 +1,100 @@ +package utils + +import ( + "fmt" + "io/ioutil" + "net/http" + "net/url" + "os" + "os/exec" + "path/filepath" + "strings" + + "github.com/docker/docker/pkg/symlink" + "github.com/docker/docker/pkg/urlutil" +) + +// GitClone clones a repository into a newly created directory which +// will be under "docker-build-git" +func GitClone(remoteURL string) (string, error) { + if !urlutil.IsGitTransport(remoteURL) { + remoteURL = "https://" + remoteURL + } + root, err := ioutil.TempDir("", "docker-build-git") + if err != nil { + return "", err + } + + u, err := url.Parse(remoteURL) + if err != nil { + return "", err + } + + fragment := u.Fragment + clone := cloneArgs(u, root) + + if output, err := git(clone...); err != nil { + return "", fmt.Errorf("Error trying to use git: %s (%s)", err, output) + } + + return checkoutGit(fragment, root) +} + +func cloneArgs(remoteURL *url.URL, root string) []string { + args := []string{"clone", "--recursive"} + shallow := len(remoteURL.Fragment) == 0 + + if shallow && strings.HasPrefix(remoteURL.Scheme, "http") { + res, err := http.Head(fmt.Sprintf("%s/info/refs?service=git-upload-pack", remoteURL)) + if err != nil || res.Header.Get("Content-Type") != "application/x-git-upload-pack-advertisement" { + shallow = false + } + } + + if shallow { + args = append(args, "--depth", "1") + } + + if remoteURL.Fragment != "" { + remoteURL.Fragment = "" + } + + return append(args, remoteURL.String(), root) +} + +func checkoutGit(fragment, root string) (string, error) { + refAndDir := strings.SplitN(fragment, ":", 2) + + if len(refAndDir[0]) != 0 { + if output, err := gitWithinDir(root, "checkout", refAndDir[0]); err != nil { + return "", fmt.Errorf("Error trying to use git: %s (%s)", err, output) + } + } + + if len(refAndDir) > 1 && len(refAndDir[1]) != 0 { + newCtx, err := symlink.FollowSymlinkInScope(filepath.Join(root, refAndDir[1]), root) + if err != nil { + return "", fmt.Errorf("Error setting git context, %q not within git root: %s", refAndDir[1], err) + } + + fi, err := os.Stat(newCtx) + if err != nil { + return "", err + } + if !fi.IsDir() { + return "", fmt.Errorf("Error setting git context, not a directory: %s", newCtx) + } + root = newCtx + } + + return root, nil +} + +func gitWithinDir(dir string, args ...string) ([]byte, error) { + a := []string{"--work-tree", dir, "--git-dir", filepath.Join(dir, ".git")} + return git(append(a, args...)...) +} + +func git(args ...string) ([]byte, error) { + return exec.Command("git", args...).CombinedOutput() +} diff --git a/utils/git_test.go b/utils/git_test.go new file mode 100644 index 0000000000..e9eb595630 --- /dev/null +++ b/utils/git_test.go @@ -0,0 +1,186 @@ +package utils + +import ( + "fmt" + "io/ioutil" + "net/http" + "net/http/httptest" + "net/url" + "os" + "path/filepath" + "reflect" + "testing" +) + +func TestCloneArgsSmartHttp(t *testing.T) { + mux := http.NewServeMux() + server := httptest.NewServer(mux) + serverURL, _ := url.Parse(server.URL) + + serverURL.Path = "/repo.git" + gitURL := serverURL.String() + + mux.HandleFunc("/repo.git/info/refs", func(w http.ResponseWriter, r *http.Request) { + q := r.URL.Query().Get("service") + w.Header().Set("Content-Type", fmt.Sprintf("application/x-%s-advertisement", q)) + }) + + args := cloneArgs(serverURL, "/tmp") + exp := []string{"clone", "--recursive", "--depth", "1", gitURL, "/tmp"} + if !reflect.DeepEqual(args, exp) { + t.Fatalf("Expected %v, got %v", exp, args) + } +} + +func TestCloneArgsDumbHttp(t *testing.T) { + mux := http.NewServeMux() + server := httptest.NewServer(mux) + serverURL, _ := url.Parse(server.URL) + + serverURL.Path = "/repo.git" + gitURL := serverURL.String() + + mux.HandleFunc("/repo.git/info/refs", func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Content-Type", "text/plain") + }) + + args := cloneArgs(serverURL, "/tmp") + exp := []string{"clone", "--recursive", gitURL, "/tmp"} + if !reflect.DeepEqual(args, exp) { + t.Fatalf("Expected %v, got %v", exp, args) + } +} + +func TestCloneArgsGit(t *testing.T) { + u, _ := url.Parse("git://github.com/docker/docker") + args := cloneArgs(u, "/tmp") + exp := []string{"clone", "--recursive", "--depth", "1", "git://github.com/docker/docker", "/tmp"} + if !reflect.DeepEqual(args, exp) { + t.Fatalf("Expected %v, got %v", exp, args) + } +} + +func TestCloneArgsStripFragment(t *testing.T) { + u, _ := url.Parse("git://github.com/docker/docker#test") + args := cloneArgs(u, "/tmp") + exp := []string{"clone", "--recursive", "git://github.com/docker/docker", "/tmp"} + if !reflect.DeepEqual(args, exp) { + t.Fatalf("Expected %v, got %v", exp, args) + } +} + +func TestCheckoutGit(t *testing.T) { + root, err := ioutil.TempDir("", "docker-build-git-checkout") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(root) + + gitDir := filepath.Join(root, "repo") + _, err = git("init", gitDir) + if err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "config", "user.email", "test@docker.com"); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "config", "user.name", "Docker test"); err != nil { + t.Fatal(err) + } + + if err = ioutil.WriteFile(filepath.Join(gitDir, "Dockerfile"), []byte("FROM scratch"), 0644); err != nil { + t.Fatal(err) + } + + subDir := filepath.Join(gitDir, "subdir") + if err = os.Mkdir(subDir, 0755); err != nil { + t.Fatal(err) + } + + if err = ioutil.WriteFile(filepath.Join(subDir, "Dockerfile"), []byte("FROM scratch\nEXPOSE 5000"), 0644); err != nil { + t.Fatal(err) + } + + if err = os.Symlink("../subdir", filepath.Join(gitDir, "parentlink")); err != nil { + t.Fatal(err) + } + + if err = os.Symlink("/subdir", filepath.Join(gitDir, "absolutelink")); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "add", "-A"); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "commit", "-am", "First commit"); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "checkout", "-b", "test"); err != nil { + t.Fatal(err) + } + + if err = ioutil.WriteFile(filepath.Join(gitDir, "Dockerfile"), []byte("FROM scratch\nEXPOSE 3000"), 0644); err != nil { + t.Fatal(err) + } + + if err = ioutil.WriteFile(filepath.Join(subDir, "Dockerfile"), []byte("FROM busybox\nEXPOSE 5000"), 0644); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "add", "-A"); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "commit", "-am", "Branch commit"); err != nil { + t.Fatal(err) + } + + if _, err = gitWithinDir(gitDir, "checkout", "master"); err != nil { + t.Fatal(err) + } + + cases := []struct { + frag string + exp string + fail bool + }{ + {"", "FROM scratch", false}, + {"master", "FROM scratch", false}, + {":subdir", "FROM scratch\nEXPOSE 5000", false}, + {":nosubdir", "", true}, // missing directory error + {":Dockerfile", "", true}, // not a directory error + {"master:nosubdir", "", true}, + {"master:subdir", "FROM scratch\nEXPOSE 5000", false}, + {"master:parentlink", "FROM scratch\nEXPOSE 5000", false}, + {"master:absolutelink", "FROM scratch\nEXPOSE 5000", false}, + {"master:../subdir", "", true}, + {"test", "FROM scratch\nEXPOSE 3000", false}, + {"test:", "FROM scratch\nEXPOSE 3000", false}, + {"test:subdir", "FROM busybox\nEXPOSE 5000", false}, + } + + for _, c := range cases { + r, err := checkoutGit(c.frag, gitDir) + + fail := err != nil + if fail != c.fail { + t.Fatalf("Expected %v failure, error was %v\n", c.fail, err) + } + if c.fail { + continue + } + + b, err := ioutil.ReadFile(filepath.Join(r, "Dockerfile")) + if err != nil { + t.Fatal(err) + } + + if string(b) != c.exp { + t.Fatalf("Expected %v, was %v\n", c.exp, string(b)) + } + } +} diff --git a/utils/names.go b/utils/names.go new file mode 100644 index 0000000000..e09e569b15 --- /dev/null +++ b/utils/names.go @@ -0,0 +1,9 @@ +package utils + +import "regexp" + +// RestrictedNameChars collects the characters allowed to represent a name, normally used to validate container and volume names. +const RestrictedNameChars = `[a-zA-Z0-9][a-zA-Z0-9_.-]` + +// RestrictedNamePattern is a regular expression to validate names against the collection of restricted characters. +var RestrictedNamePattern = regexp.MustCompile(`^/?` + RestrictedNameChars + `+$`) diff --git a/utils/stubs.go b/utils/stubs.go new file mode 100644 index 0000000000..8a496d392f --- /dev/null +++ b/utils/stubs.go @@ -0,0 +1,9 @@ +// +build !experimental + +package utils + +// ExperimentalBuild is a stub which always returns false for +// builds that do not include the "experimental" build tag +func ExperimentalBuild() bool { + return false +} diff --git a/utils/timeout.go b/utils/timeout.go new file mode 100644 index 0000000000..85d2665c60 --- /dev/null +++ b/utils/timeout.go @@ -0,0 +1,21 @@ +package utils + +import ( + "net" + "net/url" +) + +// IsTimeout takes an error returned from (generally) the http package and determines if it is a timeout error. +func IsTimeout(err error) bool { + switch e := err.(type) { + case net.Error: + return e.Timeout() + case *url.Error: + if t, ok := e.Err.(net.Error); ok { + return t.Timeout() + } + return false + default: + return false + } +} diff --git a/utils/utils.go b/utils/utils.go new file mode 100644 index 0000000000..a17ab9dcea --- /dev/null +++ b/utils/utils.go @@ -0,0 +1,306 @@ +package utils + +import ( + "bufio" + "crypto/sha1" + "encoding/hex" + "fmt" + "io" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "runtime" + "strings" + + "github.com/docker/distribution/registry/api/errcode" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/fileutils" + "github.com/docker/docker/pkg/stringid" +) + +// SelfPath figures out the absolute path of our own binary (if it's still around). +func SelfPath() string { + path, err := exec.LookPath(os.Args[0]) + if err != nil { + if os.IsNotExist(err) { + return "" + } + if execErr, ok := err.(*exec.Error); ok && os.IsNotExist(execErr.Err) { + return "" + } + panic(err) + } + path, err = filepath.Abs(path) + if err != nil { + if os.IsNotExist(err) { + return "" + } + panic(err) + } + return path +} + +func dockerInitSha1(target string) string { + f, err := os.Open(target) + if err != nil { + return "" + } + defer f.Close() + h := sha1.New() + _, err = io.Copy(h, f) + if err != nil { + return "" + } + return hex.EncodeToString(h.Sum(nil)) +} + +func isValidDockerInitPath(target string, selfPath string) bool { // target and selfPath should be absolute (InitPath and SelfPath already do this) + if target == "" { + return false + } + if dockerversion.IAMSTATIC == "true" { + if selfPath == "" { + return false + } + if target == selfPath { + return true + } + targetFileInfo, err := os.Lstat(target) + if err != nil { + return false + } + selfPathFileInfo, err := os.Lstat(selfPath) + if err != nil { + return false + } + return os.SameFile(targetFileInfo, selfPathFileInfo) + } + return dockerversion.INITSHA1 != "" && dockerInitSha1(target) == dockerversion.INITSHA1 +} + +// DockerInitPath figures out the path of our dockerinit (which may be SelfPath()) +func DockerInitPath(localCopy string) string { + selfPath := SelfPath() + if isValidDockerInitPath(selfPath, selfPath) { + // if we're valid, don't bother checking anything else + return selfPath + } + var possibleInits = []string{ + localCopy, + dockerversion.INITPATH, + filepath.Join(filepath.Dir(selfPath), "dockerinit"), + + // FHS 3.0 Draft: "/usr/libexec includes internal binaries that are not intended to be executed directly by users or shell scripts. Applications may use a single subdirectory under /usr/libexec." + // https://www.linuxbase.org/betaspecs/fhs/fhs.html#usrlibexec + "/usr/libexec/docker/dockerinit", + "/usr/local/libexec/docker/dockerinit", + + // FHS 2.3: "/usr/lib includes object files, libraries, and internal binaries that are not intended to be executed directly by users or shell scripts." + // https://refspecs.linuxfoundation.org/FHS_2.3/fhs-2.3.html#USRLIBLIBRARIESFORPROGRAMMINGANDPA + "/usr/lib/docker/dockerinit", + "/usr/local/lib/docker/dockerinit", + } + for _, dockerInit := range possibleInits { + if dockerInit == "" { + continue + } + path, err := exec.LookPath(dockerInit) + if err == nil { + path, err = filepath.Abs(path) + if err != nil { + // LookPath already validated that this file exists and is executable (following symlinks), so how could Abs fail? + panic(err) + } + if isValidDockerInitPath(path, selfPath) { + return path + } + } + } + return "" +} + +var globalTestID string + +// TestDirectory creates a new temporary directory and returns its path. +// The contents of directory at path `templateDir` is copied into the +// new directory. +func TestDirectory(templateDir string) (dir string, err error) { + if globalTestID == "" { + globalTestID = stringid.GenerateNonCryptoID()[:4] + } + prefix := fmt.Sprintf("docker-test%s-%s-", globalTestID, GetCallerName(2)) + if prefix == "" { + prefix = "docker-test-" + } + dir, err = ioutil.TempDir("", prefix) + if err = os.Remove(dir); err != nil { + return + } + if templateDir != "" { + if err = archive.CopyWithTar(templateDir, dir); err != nil { + return + } + } + return +} + +// GetCallerName introspects the call stack and returns the name of the +// function `depth` levels down in the stack. +func GetCallerName(depth int) string { + // Use the caller function name as a prefix. + // This helps trace temp directories back to their test. + pc, _, _, _ := runtime.Caller(depth + 1) + callerLongName := runtime.FuncForPC(pc).Name() + parts := strings.Split(callerLongName, ".") + callerShortName := parts[len(parts)-1] + return callerShortName +} + +// ReplaceOrAppendEnvValues returns the defaults with the overrides either +// replaced by env key or appended to the list +func ReplaceOrAppendEnvValues(defaults, overrides []string) []string { + cache := make(map[string]int, len(defaults)) + for i, e := range defaults { + parts := strings.SplitN(e, "=", 2) + cache[parts[0]] = i + } + + for _, value := range overrides { + // Values w/o = means they want this env to be removed/unset. + if !strings.Contains(value, "=") { + if i, exists := cache[value]; exists { + defaults[i] = "" // Used to indicate it should be removed + } + continue + } + + // Just do a normal set/update + parts := strings.SplitN(value, "=", 2) + if i, exists := cache[parts[0]]; exists { + defaults[i] = value + } else { + defaults = append(defaults, value) + } + } + + // Now remove all entries that we want to "unset" + for i := 0; i < len(defaults); i++ { + if defaults[i] == "" { + defaults = append(defaults[:i], defaults[i+1:]...) + i-- + } + } + + return defaults +} + +// ValidateContextDirectory checks if all the contents of the directory +// can be read and returns an error if some files can't be read +// symlinks which point to non-existing files don't trigger an error +func ValidateContextDirectory(srcPath string, excludes []string) error { + contextRoot, err := getContextRoot(srcPath) + if err != nil { + return err + } + return filepath.Walk(contextRoot, func(filePath string, f os.FileInfo, err error) error { + // skip this directory/file if it's not in the path, it won't get added to the context + if relFilePath, err := filepath.Rel(contextRoot, filePath); err != nil { + return err + } else if skip, err := fileutils.Matches(relFilePath, excludes); err != nil { + return err + } else if skip { + if f.IsDir() { + return filepath.SkipDir + } + return nil + } + + if err != nil { + if os.IsPermission(err) { + return fmt.Errorf("can't stat '%s'", filePath) + } + if os.IsNotExist(err) { + return nil + } + return err + } + + // skip checking if symlinks point to non-existing files, such symlinks can be useful + // also skip named pipes, because they hanging on open + if f.Mode()&(os.ModeSymlink|os.ModeNamedPipe) != 0 { + return nil + } + + if !f.IsDir() { + currentFile, err := os.Open(filePath) + if err != nil && os.IsPermission(err) { + return fmt.Errorf("no permission to read from '%s'", filePath) + } + currentFile.Close() + } + return nil + }) +} + +// ReadDockerIgnore reads a .dockerignore file and returns the list of file patterns +// to ignore. Note this will trim whitespace from each line as well +// as use GO's "clean" func to get the shortest/cleanest path for each. +func ReadDockerIgnore(reader io.ReadCloser) ([]string, error) { + if reader == nil { + return nil, nil + } + defer reader.Close() + scanner := bufio.NewScanner(reader) + var excludes []string + + for scanner.Scan() { + pattern := strings.TrimSpace(scanner.Text()) + if pattern == "" { + continue + } + pattern = filepath.Clean(pattern) + excludes = append(excludes, pattern) + } + if err := scanner.Err(); err != nil { + return nil, fmt.Errorf("Error reading .dockerignore: %v", err) + } + return excludes, nil +} + +// ImageReference combines `repo` and `ref` and returns a string representing +// the combination. If `ref` is a digest (meaning it's of the form +// :, the returned string is @. Otherwise, +// ref is assumed to be a tag, and the returned string is :. +func ImageReference(repo, ref string) string { + if DigestReference(ref) { + return repo + "@" + ref + } + return repo + ":" + ref +} + +// DigestReference returns true if ref is a digest reference; i.e. if it +// is of the form :. +func DigestReference(ref string) bool { + return strings.Contains(ref, ":") +} + +// GetErrorMessage returns the human readable message associated with +// the passed-in error. In some cases the default Error() func returns +// something that is less than useful so based on its types this func +// will go and get a better piece of text. +func GetErrorMessage(err error) string { + switch err.(type) { + case errcode.Error: + e, _ := err.(errcode.Error) + return e.Message + + case errcode.ErrorCode: + ec, _ := err.(errcode.ErrorCode) + return ec.Message() + + default: + return err.Error() + } +} diff --git a/utils/utils_test.go b/utils/utils_test.go new file mode 100644 index 0000000000..9acb8017a6 --- /dev/null +++ b/utils/utils_test.go @@ -0,0 +1,103 @@ +package utils + +import ( + "fmt" + "io/ioutil" + "os" + "path/filepath" + "testing" +) + +func TestReplaceAndAppendEnvVars(t *testing.T) { + var ( + d = []string{"HOME=/"} + o = []string{"HOME=/root", "TERM=xterm"} + ) + + env := ReplaceOrAppendEnvValues(d, o) + if len(env) != 2 { + t.Fatalf("expected len of 2 got %d", len(env)) + } + if env[0] != "HOME=/root" { + t.Fatalf("expected HOME=/root got '%s'", env[0]) + } + if env[1] != "TERM=xterm" { + t.Fatalf("expected TERM=xterm got '%s'", env[1]) + } +} + +func TestImageReference(t *testing.T) { + tests := []struct { + repo string + ref string + expected string + }{ + {"repo", "tag", "repo:tag"}, + {"repo", "sha256:c100b11b25d0cacd52c14e0e7bf525e1a4c0e6aec8827ae007055545909d1a64", "repo@sha256:c100b11b25d0cacd52c14e0e7bf525e1a4c0e6aec8827ae007055545909d1a64"}, + } + + for i, test := range tests { + actual := ImageReference(test.repo, test.ref) + if test.expected != actual { + t.Errorf("%d: expected %q, got %q", i, test.expected, actual) + } + } +} + +func TestDigestReference(t *testing.T) { + input := "sha256:c100b11b25d0cacd52c14e0e7bf525e1a4c0e6aec8827ae007055545909d1a64" + if !DigestReference(input) { + t.Errorf("Expected DigestReference=true for input %q", input) + } + + input = "latest" + if DigestReference(input) { + t.Errorf("Unexpected DigestReference=true for input %q", input) + } +} + +func TestReadDockerIgnore(t *testing.T) { + tmpDir, err := ioutil.TempDir("", "dockerignore-test") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmpDir) + + di, err := ReadDockerIgnore(nil) + if err != nil { + t.Fatalf("Expected not to have error, got %v", err) + } + + if diLen := len(di); diLen != 0 { + t.Fatalf("Expected to have zero dockerignore entry, got %d", diLen) + } + + diName := filepath.Join(tmpDir, ".dockerignore") + content := fmt.Sprintf("test1\n/test2\n/a/file/here\n\nlastfile") + err = ioutil.WriteFile(diName, []byte(content), 0777) + if err != nil { + t.Fatal(err) + } + + diFd, err := os.Open(diName) + if err != nil { + t.Fatal(err) + } + di, err = ReadDockerIgnore(diFd) + if err != nil { + t.Fatal(err) + } + + if di[0] != "test1" { + t.Fatalf("First element is not test1") + } + if di[1] != "/test2" { + t.Fatalf("Second element is not /test2") + } + if di[2] != "/a/file/here" { + t.Fatalf("Third element is not /a/file/here") + } + if di[3] != "lastfile" { + t.Fatalf("Fourth element is not lastfile") + } +} diff --git a/utils/utils_unix.go b/utils/utils_unix.go new file mode 100644 index 0000000000..86bfb770f9 --- /dev/null +++ b/utils/utils_unix.go @@ -0,0 +1,11 @@ +// +build !windows + +package utils + +import ( + "path/filepath" +) + +func getContextRoot(srcPath string) (string, error) { + return filepath.Join(srcPath, "."), nil +} diff --git a/utils/utils_windows.go b/utils/utils_windows.go new file mode 100644 index 0000000000..80b58bd99a --- /dev/null +++ b/utils/utils_windows.go @@ -0,0 +1,17 @@ +// +build windows + +package utils + +import ( + "path/filepath" + + "github.com/docker/docker/pkg/longpath" +) + +func getContextRoot(srcPath string) (string, error) { + cr, err := filepath.Abs(srcPath) + if err != nil { + return "", err + } + return longpath.AddPrefix(cr), nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/LICENSE b/vendor/src/github.com/Azure/go-ansiterm/LICENSE new file mode 100644 index 0000000000..e3d9a64d1d --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2015 Microsoft Corporation + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/vendor/src/github.com/Azure/go-ansiterm/README.md b/vendor/src/github.com/Azure/go-ansiterm/README.md new file mode 100644 index 0000000000..e25e382101 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/README.md @@ -0,0 +1,9 @@ +# go-ansiterm + +This is a cross platform Ansi Terminal Emulation library. It reads a stream of Ansi characters and produces the appropriate function calls. The results of the function calls are platform dependent. + +For example the parser might receive "ESC, [, A" as a stream of three characters. This is the code for Cursor Up (http://www.vt100.net/docs/vt510-rm/CUU). The parser then calls the cursor up function (CUU()) on an event handler. The event handler determines what platform specific work must be done to cause the cursor to move up one position. + +The parser (parser.go) is a partial implementation of this state machine (http://vt100.net/emu/vt500_parser.png). There are also two event handler implementations, one for tests (test_event_handler.go) to validate that the expected events are being produced and called, the other is a Windows implementation (winterm/win_event_handler.go). + +See parser_test.go for examples exercising the state machine and generating appropriate function calls. diff --git a/vendor/src/github.com/Azure/go-ansiterm/constants.go b/vendor/src/github.com/Azure/go-ansiterm/constants.go new file mode 100644 index 0000000000..ebfce8a8d3 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/constants.go @@ -0,0 +1,188 @@ +package ansiterm + +const LogEnv = "DEBUG_TERMINAL" + +// ANSI constants +// References: +// -- http://www.ecma-international.org/publications/standards/Ecma-048.htm +// -- http://man7.org/linux/man-pages/man4/console_codes.4.html +// -- http://manpages.ubuntu.com/manpages/intrepid/man4/console_codes.4.html +// -- http://en.wikipedia.org/wiki/ANSI_escape_code +// -- http://vt100.net/emu/dec_ansi_parser +// -- http://vt100.net/emu/vt500_parser.svg +// -- http://invisible-island.net/xterm/ctlseqs/ctlseqs.html +// -- http://www.inwap.com/pdp10/ansicode.txt +const ( + // ECMA-48 Set Graphics Rendition + // Note: + // -- Constants leading with an underscore (e.g., _ANSI_xxx) are unsupported or reserved + // -- Fonts could possibly be supported via SetCurrentConsoleFontEx + // -- Windows does not expose the per-window cursor (i.e., caret) blink times + ANSI_SGR_RESET = 0 + ANSI_SGR_BOLD = 1 + ANSI_SGR_DIM = 2 + _ANSI_SGR_ITALIC = 3 + ANSI_SGR_UNDERLINE = 4 + _ANSI_SGR_BLINKSLOW = 5 + _ANSI_SGR_BLINKFAST = 6 + ANSI_SGR_REVERSE = 7 + _ANSI_SGR_INVISIBLE = 8 + _ANSI_SGR_LINETHROUGH = 9 + _ANSI_SGR_FONT_00 = 10 + _ANSI_SGR_FONT_01 = 11 + _ANSI_SGR_FONT_02 = 12 + _ANSI_SGR_FONT_03 = 13 + _ANSI_SGR_FONT_04 = 14 + _ANSI_SGR_FONT_05 = 15 + _ANSI_SGR_FONT_06 = 16 + _ANSI_SGR_FONT_07 = 17 + _ANSI_SGR_FONT_08 = 18 + _ANSI_SGR_FONT_09 = 19 + _ANSI_SGR_FONT_10 = 20 + _ANSI_SGR_DOUBLEUNDERLINE = 21 + ANSI_SGR_BOLD_DIM_OFF = 22 + _ANSI_SGR_ITALIC_OFF = 23 + ANSI_SGR_UNDERLINE_OFF = 24 + _ANSI_SGR_BLINK_OFF = 25 + _ANSI_SGR_RESERVED_00 = 26 + ANSI_SGR_REVERSE_OFF = 27 + _ANSI_SGR_INVISIBLE_OFF = 28 + _ANSI_SGR_LINETHROUGH_OFF = 29 + ANSI_SGR_FOREGROUND_BLACK = 30 + ANSI_SGR_FOREGROUND_RED = 31 + ANSI_SGR_FOREGROUND_GREEN = 32 + ANSI_SGR_FOREGROUND_YELLOW = 33 + ANSI_SGR_FOREGROUND_BLUE = 34 + ANSI_SGR_FOREGROUND_MAGENTA = 35 + ANSI_SGR_FOREGROUND_CYAN = 36 + ANSI_SGR_FOREGROUND_WHITE = 37 + _ANSI_SGR_RESERVED_01 = 38 + ANSI_SGR_FOREGROUND_DEFAULT = 39 + ANSI_SGR_BACKGROUND_BLACK = 40 + ANSI_SGR_BACKGROUND_RED = 41 + ANSI_SGR_BACKGROUND_GREEN = 42 + ANSI_SGR_BACKGROUND_YELLOW = 43 + ANSI_SGR_BACKGROUND_BLUE = 44 + ANSI_SGR_BACKGROUND_MAGENTA = 45 + ANSI_SGR_BACKGROUND_CYAN = 46 + ANSI_SGR_BACKGROUND_WHITE = 47 + _ANSI_SGR_RESERVED_02 = 48 + ANSI_SGR_BACKGROUND_DEFAULT = 49 + // 50 - 65: Unsupported + + ANSI_MAX_CMD_LENGTH = 4096 + + MAX_INPUT_EVENTS = 128 + DEFAULT_WIDTH = 80 + DEFAULT_HEIGHT = 24 + + ANSI_BEL = 0x07 + ANSI_BACKSPACE = 0x08 + ANSI_TAB = 0x09 + ANSI_LINE_FEED = 0x0A + ANSI_VERTICAL_TAB = 0x0B + ANSI_FORM_FEED = 0x0C + ANSI_CARRIAGE_RETURN = 0x0D + ANSI_ESCAPE_PRIMARY = 0x1B + ANSI_ESCAPE_SECONDARY = 0x5B + ANSI_OSC_STRING_ENTRY = 0x5D + ANSI_COMMAND_FIRST = 0x40 + ANSI_COMMAND_LAST = 0x7E + DCS_ENTRY = 0x90 + CSI_ENTRY = 0x9B + OSC_STRING = 0x9D + ANSI_PARAMETER_SEP = ";" + ANSI_CMD_G0 = '(' + ANSI_CMD_G1 = ')' + ANSI_CMD_G2 = '*' + ANSI_CMD_G3 = '+' + ANSI_CMD_DECPNM = '>' + ANSI_CMD_DECPAM = '=' + ANSI_CMD_OSC = ']' + ANSI_CMD_STR_TERM = '\\' + + KEY_CONTROL_PARAM_2 = ";2" + KEY_CONTROL_PARAM_3 = ";3" + KEY_CONTROL_PARAM_4 = ";4" + KEY_CONTROL_PARAM_5 = ";5" + KEY_CONTROL_PARAM_6 = ";6" + KEY_CONTROL_PARAM_7 = ";7" + KEY_CONTROL_PARAM_8 = ";8" + KEY_ESC_CSI = "\x1B[" + KEY_ESC_N = "\x1BN" + KEY_ESC_O = "\x1BO" + + FILL_CHARACTER = ' ' +) + +func getByteRange(start byte, end byte) []byte { + bytes := make([]byte, 0, 32) + for i := start; i <= end; i++ { + bytes = append(bytes, byte(i)) + } + + return bytes +} + +var ToGroundBytes = getToGroundBytes() +var Executors = getExecuteBytes() + +// SPACE 20+A0 hex Always and everywhere a blank space +// Intermediate 20-2F hex !"#$%&'()*+,-./ +var Intermeds = getByteRange(0x20, 0x2F) + +// Parameters 30-3F hex 0123456789:;<=>? +// CSI Parameters 30-39, 3B hex 0123456789; +var CsiParams = getByteRange(0x30, 0x3F) + +var CsiCollectables = append(getByteRange(0x30, 0x39), getByteRange(0x3B, 0x3F)...) + +// Uppercase 40-5F hex @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ +var UpperCase = getByteRange(0x40, 0x5F) + +// Lowercase 60-7E hex `abcdefghijlkmnopqrstuvwxyz{|}~ +var LowerCase = getByteRange(0x60, 0x7E) + +// Alphabetics 40-7E hex (all of upper and lower case) +var Alphabetics = append(UpperCase, LowerCase...) + +var Printables = getByteRange(0x20, 0x7F) + +var EscapeIntermediateToGroundBytes = getByteRange(0x30, 0x7E) +var EscapeToGroundBytes = getEscapeToGroundBytes() + +// See http://www.vt100.net/emu/vt500_parser.png for description of the complex +// byte ranges below + +func getEscapeToGroundBytes() []byte { + escapeToGroundBytes := getByteRange(0x30, 0x4F) + escapeToGroundBytes = append(escapeToGroundBytes, getByteRange(0x51, 0x57)...) + escapeToGroundBytes = append(escapeToGroundBytes, 0x59) + escapeToGroundBytes = append(escapeToGroundBytes, 0x5A) + escapeToGroundBytes = append(escapeToGroundBytes, 0x5C) + escapeToGroundBytes = append(escapeToGroundBytes, getByteRange(0x60, 0x7E)...) + return escapeToGroundBytes +} + +func getExecuteBytes() []byte { + executeBytes := getByteRange(0x00, 0x17) + executeBytes = append(executeBytes, 0x19) + executeBytes = append(executeBytes, getByteRange(0x1C, 0x1F)...) + return executeBytes +} + +func getToGroundBytes() []byte { + groundBytes := []byte{0x18} + groundBytes = append(groundBytes, 0x1A) + groundBytes = append(groundBytes, getByteRange(0x80, 0x8F)...) + groundBytes = append(groundBytes, getByteRange(0x91, 0x97)...) + groundBytes = append(groundBytes, 0x99) + groundBytes = append(groundBytes, 0x9A) + groundBytes = append(groundBytes, 0x9C) + return groundBytes +} + +// Delete 7F hex Always and everywhere ignored +// C1 Control 80-9F hex 32 additional control characters +// G1 Displayable A1-FE hex 94 additional displayable characters +// Special A0+FF hex Same as SPACE and DELETE diff --git a/vendor/src/github.com/Azure/go-ansiterm/context.go b/vendor/src/github.com/Azure/go-ansiterm/context.go new file mode 100644 index 0000000000..d55cc2aec7 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/context.go @@ -0,0 +1,7 @@ +package ansiterm + +type AnsiContext struct { + currentChar byte + paramBuffer []byte + interBuffer []byte +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/csi_entry_state.go b/vendor/src/github.com/Azure/go-ansiterm/csi_entry_state.go new file mode 100644 index 0000000000..9fd4bd28e2 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/csi_entry_state.go @@ -0,0 +1,49 @@ +package ansiterm + +type CsiEntryState struct { + BaseState +} + +func (csiState CsiEntryState) Handle(b byte) (s State, e error) { + logger.Infof("CsiEntry::Handle %#x", b) + + nextState, err := csiState.BaseState.Handle(b) + if nextState != nil || err != nil { + return nextState, err + } + + switch { + case sliceContains(Alphabetics, b): + return csiState.parser.Ground, nil + case sliceContains(CsiCollectables, b): + return csiState.parser.CsiParam, nil + case sliceContains(Executors, b): + return csiState, csiState.parser.execute() + } + + return csiState, nil +} + +func (csiState CsiEntryState) Transition(s State) error { + logger.Infof("CsiEntry::Transition %s --> %s", csiState.Name(), s.Name()) + csiState.BaseState.Transition(s) + + switch s { + case csiState.parser.Ground: + return csiState.parser.csiDispatch() + case csiState.parser.CsiParam: + switch { + case sliceContains(CsiParams, csiState.parser.context.currentChar): + csiState.parser.collectParam() + case sliceContains(Intermeds, csiState.parser.context.currentChar): + csiState.parser.collectInter() + } + } + + return nil +} + +func (csiState CsiEntryState) Enter() error { + csiState.parser.clear() + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/csi_param_state.go b/vendor/src/github.com/Azure/go-ansiterm/csi_param_state.go new file mode 100644 index 0000000000..27807dd35b --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/csi_param_state.go @@ -0,0 +1,38 @@ +package ansiterm + +type CsiParamState struct { + BaseState +} + +func (csiState CsiParamState) Handle(b byte) (s State, e error) { + logger.Infof("CsiParam::Handle %#x", b) + + nextState, err := csiState.BaseState.Handle(b) + if nextState != nil || err != nil { + return nextState, err + } + + switch { + case sliceContains(Alphabetics, b): + return csiState.parser.Ground, nil + case sliceContains(CsiCollectables, b): + csiState.parser.collectParam() + return csiState, nil + case sliceContains(Executors, b): + return csiState, csiState.parser.execute() + } + + return csiState, nil +} + +func (csiState CsiParamState) Transition(s State) error { + logger.Infof("CsiParam::Transition %s --> %s", csiState.Name(), s.Name()) + csiState.BaseState.Transition(s) + + switch s { + case csiState.parser.Ground: + return csiState.parser.csiDispatch() + } + + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/escape_intermediate_state.go b/vendor/src/github.com/Azure/go-ansiterm/escape_intermediate_state.go new file mode 100644 index 0000000000..b14e0ce977 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/escape_intermediate_state.go @@ -0,0 +1,36 @@ +package ansiterm + +type EscapeIntermediateState struct { + BaseState +} + +func (escState EscapeIntermediateState) Handle(b byte) (s State, e error) { + logger.Infof("EscapeIntermediateState::Handle %#x", b) + nextState, err := escState.BaseState.Handle(b) + if nextState != nil || err != nil { + return nextState, err + } + + switch { + case sliceContains(Intermeds, b): + return escState, escState.parser.collectInter() + case sliceContains(Executors, b): + return escState, escState.parser.execute() + case sliceContains(EscapeIntermediateToGroundBytes, b): + return escState.parser.Ground, nil + } + + return escState, nil +} + +func (escState EscapeIntermediateState) Transition(s State) error { + logger.Infof("EscapeIntermediateState::Transition %s --> %s", escState.Name(), s.Name()) + escState.BaseState.Transition(s) + + switch s { + case escState.parser.Ground: + return escState.parser.escDispatch() + } + + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/escape_state.go b/vendor/src/github.com/Azure/go-ansiterm/escape_state.go new file mode 100644 index 0000000000..232dd8e0d1 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/escape_state.go @@ -0,0 +1,47 @@ +package ansiterm + +type EscapeState struct { + BaseState +} + +func (escState EscapeState) Handle(b byte) (s State, e error) { + logger.Infof("EscapeState::Handle %#x", b) + nextState, err := escState.BaseState.Handle(b) + if nextState != nil || err != nil { + return nextState, err + } + + switch { + case b == ANSI_ESCAPE_SECONDARY: + return escState.parser.CsiEntry, nil + case b == ANSI_OSC_STRING_ENTRY: + return escState.parser.OscString, nil + case sliceContains(Executors, b): + return escState, escState.parser.execute() + case sliceContains(EscapeToGroundBytes, b): + return escState.parser.Ground, nil + case sliceContains(Intermeds, b): + return escState.parser.EscapeIntermediate, nil + } + + return escState, nil +} + +func (escState EscapeState) Transition(s State) error { + logger.Infof("Escape::Transition %s --> %s", escState.Name(), s.Name()) + escState.BaseState.Transition(s) + + switch s { + case escState.parser.Ground: + return escState.parser.escDispatch() + case escState.parser.EscapeIntermediate: + return escState.parser.collectInter() + } + + return nil +} + +func (escState EscapeState) Enter() error { + escState.parser.clear() + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/event_handler.go b/vendor/src/github.com/Azure/go-ansiterm/event_handler.go new file mode 100644 index 0000000000..98087b38c2 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/event_handler.go @@ -0,0 +1,90 @@ +package ansiterm + +type AnsiEventHandler interface { + // Print + Print(b byte) error + + // Execute C0 commands + Execute(b byte) error + + // CUrsor Up + CUU(int) error + + // CUrsor Down + CUD(int) error + + // CUrsor Forward + CUF(int) error + + // CUrsor Backward + CUB(int) error + + // Cursor to Next Line + CNL(int) error + + // Cursor to Previous Line + CPL(int) error + + // Cursor Horizontal position Absolute + CHA(int) error + + // Vertical line Position Absolute + VPA(int) error + + // CUrsor Position + CUP(int, int) error + + // Horizontal and Vertical Position (depends on PUM) + HVP(int, int) error + + // Text Cursor Enable Mode + DECTCEM(bool) error + + // Origin Mode + DECOM(bool) error + + // 132 Column Mode + DECCOLM(bool) error + + // Erase in Display + ED(int) error + + // Erase in Line + EL(int) error + + // Insert Line + IL(int) error + + // Delete Line + DL(int) error + + // Insert Character + ICH(int) error + + // Delete Character + DCH(int) error + + // Set Graphics Rendition + SGR([]int) error + + // Pan Down + SU(int) error + + // Pan Up + SD(int) error + + // Device Attributes + DA([]string) error + + // Set Top and Bottom Margins + DECSTBM(int, int) error + + // Index + IND() error + + // Reverse Index + RI() error + + // Flush updates from previous commands + Flush() error +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/ground_state.go b/vendor/src/github.com/Azure/go-ansiterm/ground_state.go new file mode 100644 index 0000000000..d600e3e4ae --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/ground_state.go @@ -0,0 +1,24 @@ +package ansiterm + +type GroundState struct { + BaseState +} + +func (gs GroundState) Handle(b byte) (s State, e error) { + gs.parser.context.currentChar = b + + nextState, err := gs.BaseState.Handle(b) + if nextState != nil || err != nil { + return nextState, err + } + + switch { + case sliceContains(Printables, b): + return gs, gs.parser.print() + + case sliceContains(Executors, b): + return gs, gs.parser.execute() + } + + return gs, nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/osc_string_state.go b/vendor/src/github.com/Azure/go-ansiterm/osc_string_state.go new file mode 100644 index 0000000000..4490e3cdf6 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/osc_string_state.go @@ -0,0 +1,31 @@ +package ansiterm + +type OscStringState struct { + BaseState +} + +func (oscState OscStringState) Handle(b byte) (s State, e error) { + logger.Infof("OscString::Handle %#x", b) + nextState, err := oscState.BaseState.Handle(b) + if nextState != nil || err != nil { + return nextState, err + } + + switch { + case isOscStringTerminator(b): + return oscState.parser.Ground, nil + } + + return oscState, nil +} + +// See below for OSC string terminators for linux +// http://man7.org/linux/man-pages/man4/console_codes.4.html +func isOscStringTerminator(b byte) bool { + + if b == ANSI_BEL || b == 0x5C { + return true + } + + return false +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/parser.go b/vendor/src/github.com/Azure/go-ansiterm/parser.go new file mode 100644 index 0000000000..ef5e0ad199 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/parser.go @@ -0,0 +1,137 @@ +package ansiterm + +import ( + "errors" + "fmt" + "io/ioutil" + "os" + + "github.com/Sirupsen/logrus" +) + +var logger *logrus.Logger + +type AnsiParser struct { + currState State + eventHandler AnsiEventHandler + context *AnsiContext + CsiEntry State + CsiParam State + DcsEntry State + Escape State + EscapeIntermediate State + Error State + Ground State + OscString State + stateMap []State +} + +func CreateParser(initialState string, evtHandler AnsiEventHandler) *AnsiParser { + logFile := ioutil.Discard + + if isDebugEnv := os.Getenv(LogEnv); isDebugEnv == "1" { + logFile, _ = os.Create("ansiParser.log") + } + + logger = &logrus.Logger{ + Out: logFile, + Formatter: new(logrus.TextFormatter), + Level: logrus.InfoLevel, + } + + parser := &AnsiParser{ + eventHandler: evtHandler, + context: &AnsiContext{}, + } + + parser.CsiEntry = CsiEntryState{BaseState{name: "CsiEntry", parser: parser}} + parser.CsiParam = CsiParamState{BaseState{name: "CsiParam", parser: parser}} + parser.DcsEntry = DcsEntryState{BaseState{name: "DcsEntry", parser: parser}} + parser.Escape = EscapeState{BaseState{name: "Escape", parser: parser}} + parser.EscapeIntermediate = EscapeIntermediateState{BaseState{name: "EscapeIntermediate", parser: parser}} + parser.Error = ErrorState{BaseState{name: "Error", parser: parser}} + parser.Ground = GroundState{BaseState{name: "Ground", parser: parser}} + parser.OscString = OscStringState{BaseState{name: "OscString", parser: parser}} + + parser.stateMap = []State{ + parser.CsiEntry, + parser.CsiParam, + parser.DcsEntry, + parser.Escape, + parser.EscapeIntermediate, + parser.Error, + parser.Ground, + parser.OscString, + } + + parser.currState = getState(initialState, parser.stateMap) + + logger.Infof("CreateParser: parser %p", parser) + return parser +} + +func getState(name string, states []State) State { + for _, el := range states { + if el.Name() == name { + return el + } + } + + return nil +} + +func (ap *AnsiParser) Parse(bytes []byte) (int, error) { + for i, b := range bytes { + if err := ap.handle(b); err != nil { + return i, err + } + } + + return len(bytes), ap.eventHandler.Flush() +} + +func (ap *AnsiParser) handle(b byte) error { + ap.context.currentChar = b + newState, err := ap.currState.Handle(b) + if err != nil { + return err + } + + if newState == nil { + logger.Warning("newState is nil") + return errors.New(fmt.Sprintf("New state of 'nil' is invalid.")) + } + + if newState != ap.currState { + if err := ap.changeState(newState); err != nil { + return err + } + } + + return nil +} + +func (ap *AnsiParser) changeState(newState State) error { + logger.Infof("ChangeState %s --> %s", ap.currState.Name(), newState.Name()) + + // Exit old state + if err := ap.currState.Exit(); err != nil { + logger.Infof("Exit state '%s' failed with : '%v'", ap.currState.Name(), err) + return err + } + + // Perform transition action + if err := ap.currState.Transition(newState); err != nil { + logger.Infof("Transition from '%s' to '%s' failed with: '%v'", ap.currState.Name(), newState.Name, err) + return err + } + + // Enter new state + if err := newState.Enter(); err != nil { + logger.Infof("Enter state '%s' failed with: '%v'", newState.Name(), err) + return err + } + + ap.currState = newState + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/parser_action_helpers.go b/vendor/src/github.com/Azure/go-ansiterm/parser_action_helpers.go new file mode 100644 index 0000000000..438802097d --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/parser_action_helpers.go @@ -0,0 +1,103 @@ +package ansiterm + +import ( + "strconv" +) + +func parseParams(bytes []byte) ([]string, error) { + paramBuff := make([]byte, 0, 0) + params := []string{} + + for _, v := range bytes { + if v == ';' { + if len(paramBuff) > 0 { + // Completed parameter, append it to the list + s := string(paramBuff) + params = append(params, s) + paramBuff = make([]byte, 0, 0) + } + } else { + paramBuff = append(paramBuff, v) + } + } + + // Last parameter may not be terminated with ';' + if len(paramBuff) > 0 { + s := string(paramBuff) + params = append(params, s) + } + + logger.Infof("Parsed params: %v with length: %d", params, len(params)) + return params, nil +} + +func parseCmd(context AnsiContext) (string, error) { + return string(context.currentChar), nil +} + +func getInt(params []string, dflt int) int { + i := getInts(params, 1, dflt)[0] + logger.Infof("getInt: %v", i) + return i +} + +func getInts(params []string, minCount int, dflt int) []int { + ints := []int{} + + for _, v := range params { + i, _ := strconv.Atoi(v) + // Zero is mapped to the default value in VT100. + if i == 0 { + i = dflt + } + ints = append(ints, i) + } + + if len(ints) < minCount { + remaining := minCount - len(ints) + for i := 0; i < remaining; i++ { + ints = append(ints, dflt) + } + } + + logger.Infof("getInts: %v", ints) + + return ints +} + +func (ap *AnsiParser) modeDispatch(param string, set bool) error { + switch param { + case "?3": + return ap.eventHandler.DECCOLM(set) + case "?6": + return ap.eventHandler.DECOM(set) + case "?25": + return ap.eventHandler.DECTCEM(set) + } + return nil +} + +func (ap *AnsiParser) hDispatch(params []string) error { + if len(params) == 1 { + return ap.modeDispatch(params[0], true) + } + + return nil +} + +func (ap *AnsiParser) lDispatch(params []string) error { + if len(params) == 1 { + return ap.modeDispatch(params[0], false) + } + + return nil +} + +func getEraseParam(params []string) int { + param := getInt(params, 0) + if param < 0 || 3 < param { + param = 0 + } + + return param +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/parser_actions.go b/vendor/src/github.com/Azure/go-ansiterm/parser_actions.go new file mode 100644 index 0000000000..260e6aae3c --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/parser_actions.go @@ -0,0 +1,122 @@ +package ansiterm + +import ( + "fmt" +) + +func (ap *AnsiParser) collectParam() error { + currChar := ap.context.currentChar + logger.Infof("collectParam %#x", currChar) + ap.context.paramBuffer = append(ap.context.paramBuffer, currChar) + return nil +} + +func (ap *AnsiParser) collectInter() error { + currChar := ap.context.currentChar + logger.Infof("collectInter %#x", currChar) + ap.context.paramBuffer = append(ap.context.interBuffer, currChar) + return nil +} + +func (ap *AnsiParser) escDispatch() error { + cmd, _ := parseCmd(*ap.context) + intermeds := ap.context.interBuffer + logger.Infof("escDispatch currentChar: %#x", ap.context.currentChar) + logger.Infof("escDispatch: %v(%v)", cmd, intermeds) + + switch cmd { + case "D": // IND + return ap.eventHandler.IND() + case "E": // NEL, equivalent to CRLF + err := ap.eventHandler.Execute(ANSI_CARRIAGE_RETURN) + if err == nil { + err = ap.eventHandler.Execute(ANSI_LINE_FEED) + } + return err + case "M": // RI + return ap.eventHandler.RI() + } + + return nil +} + +func (ap *AnsiParser) csiDispatch() error { + cmd, _ := parseCmd(*ap.context) + params, _ := parseParams(ap.context.paramBuffer) + + logger.Infof("csiDispatch: %v(%v)", cmd, params) + + switch cmd { + case "@": + return ap.eventHandler.ICH(getInt(params, 1)) + case "A": + return ap.eventHandler.CUU(getInt(params, 1)) + case "B": + return ap.eventHandler.CUD(getInt(params, 1)) + case "C": + return ap.eventHandler.CUF(getInt(params, 1)) + case "D": + return ap.eventHandler.CUB(getInt(params, 1)) + case "E": + return ap.eventHandler.CNL(getInt(params, 1)) + case "F": + return ap.eventHandler.CPL(getInt(params, 1)) + case "G": + return ap.eventHandler.CHA(getInt(params, 1)) + case "H": + ints := getInts(params, 2, 1) + x, y := ints[0], ints[1] + return ap.eventHandler.CUP(x, y) + case "J": + param := getEraseParam(params) + return ap.eventHandler.ED(param) + case "K": + param := getEraseParam(params) + return ap.eventHandler.EL(param) + case "L": + return ap.eventHandler.IL(getInt(params, 1)) + case "M": + return ap.eventHandler.DL(getInt(params, 1)) + case "P": + return ap.eventHandler.DCH(getInt(params, 1)) + case "S": + return ap.eventHandler.SU(getInt(params, 1)) + case "T": + return ap.eventHandler.SD(getInt(params, 1)) + case "c": + return ap.eventHandler.DA(params) + case "d": + return ap.eventHandler.VPA(getInt(params, 1)) + case "f": + ints := getInts(params, 2, 1) + x, y := ints[0], ints[1] + return ap.eventHandler.HVP(x, y) + case "h": + return ap.hDispatch(params) + case "l": + return ap.lDispatch(params) + case "m": + return ap.eventHandler.SGR(getInts(params, 1, 0)) + case "r": + ints := getInts(params, 2, 1) + top, bottom := ints[0], ints[1] + return ap.eventHandler.DECSTBM(top, bottom) + default: + logger.Errorf(fmt.Sprintf("Unsupported CSI command: '%s', with full context: %v", cmd, ap.context)) + return nil + } + +} + +func (ap *AnsiParser) print() error { + return ap.eventHandler.Print(ap.context.currentChar) +} + +func (ap *AnsiParser) clear() error { + ap.context = &AnsiContext{} + return nil +} + +func (ap *AnsiParser) execute() error { + return ap.eventHandler.Execute(ap.context.currentChar) +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/parser_test_helpers.go b/vendor/src/github.com/Azure/go-ansiterm/parser_test_helpers.go new file mode 100644 index 0000000000..562f215d34 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/parser_test_helpers.go @@ -0,0 +1,114 @@ +package ansiterm + +import ( + "fmt" + "testing" +) + +func getStateNames() []string { + parser, _ := createTestParser("Ground") + + stateNames := []string{} + for _, state := range parser.stateMap { + stateNames = append(stateNames, state.Name()) + } + + return stateNames +} + +func stateTransitionHelper(t *testing.T, start string, end string, bytes []byte) { + for _, b := range bytes { + bytes := []byte{byte(b)} + parser, _ := createTestParser(start) + parser.Parse(bytes) + validateState(t, parser.currState, end) + } +} + +func anyToXHelper(t *testing.T, bytes []byte, expectedState string) { + for _, s := range getStateNames() { + stateTransitionHelper(t, s, expectedState, bytes) + } +} + +func funcCallParamHelper(t *testing.T, bytes []byte, start string, expected string, expectedCalls []string) { + parser, evtHandler := createTestParser(start) + parser.Parse(bytes) + validateState(t, parser.currState, expected) + validateFuncCalls(t, evtHandler.FunctionCalls, expectedCalls) +} + +func parseParamsHelper(t *testing.T, bytes []byte, expectedParams []string) { + params, err := parseParams(bytes) + + if err != nil { + t.Errorf("Parameter parse error: %v", err) + return + } + + if len(params) != len(expectedParams) { + t.Errorf("Parsed parameters: %v", params) + t.Errorf("Expected parameters: %v", expectedParams) + t.Errorf("Parameter length failure: %d != %d", len(params), len(expectedParams)) + return + } + + for i, v := range expectedParams { + if v != params[i] { + t.Errorf("Parsed parameters: %v", params) + t.Errorf("Expected parameters: %v", expectedParams) + t.Errorf("Parameter parse failure: %s != %s at position %d", v, params[i], i) + } + } +} + +func cursorSingleParamHelper(t *testing.T, command byte, funcName string) { + funcCallParamHelper(t, []byte{command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) + funcCallParamHelper(t, []byte{'0', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) + funcCallParamHelper(t, []byte{'2', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2])", funcName)}) + funcCallParamHelper(t, []byte{'2', '3', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([23])", funcName)}) + funcCallParamHelper(t, []byte{'2', ';', '3', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2])", funcName)}) + funcCallParamHelper(t, []byte{'2', ';', '3', ';', '4', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2])", funcName)}) +} + +func cursorTwoParamHelper(t *testing.T, command byte, funcName string) { + funcCallParamHelper(t, []byte{command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1 1])", funcName)}) + funcCallParamHelper(t, []byte{'0', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1 1])", funcName)}) + funcCallParamHelper(t, []byte{'2', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2 1])", funcName)}) + funcCallParamHelper(t, []byte{'2', '3', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([23 1])", funcName)}) + funcCallParamHelper(t, []byte{'2', ';', '3', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2 3])", funcName)}) + funcCallParamHelper(t, []byte{'2', ';', '3', ';', '4', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2 3])", funcName)}) +} + +func eraseHelper(t *testing.T, command byte, funcName string) { + funcCallParamHelper(t, []byte{command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([0])", funcName)}) + funcCallParamHelper(t, []byte{'0', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([0])", funcName)}) + funcCallParamHelper(t, []byte{'1', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) + funcCallParamHelper(t, []byte{'2', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([2])", funcName)}) + funcCallParamHelper(t, []byte{'3', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([3])", funcName)}) + funcCallParamHelper(t, []byte{'4', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([0])", funcName)}) + funcCallParamHelper(t, []byte{'1', ';', '2', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) +} + +func scrollHelper(t *testing.T, command byte, funcName string) { + funcCallParamHelper(t, []byte{command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) + funcCallParamHelper(t, []byte{'0', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) + funcCallParamHelper(t, []byte{'1', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([1])", funcName)}) + funcCallParamHelper(t, []byte{'5', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([5])", funcName)}) + funcCallParamHelper(t, []byte{'4', ';', '6', command}, "CsiEntry", "Ground", []string{fmt.Sprintf("%s([4])", funcName)}) +} + +func clearOnStateChangeHelper(t *testing.T, start string, end string, bytes []byte) { + p, _ := createTestParser(start) + fillContext(p.context) + p.Parse(bytes) + validateState(t, p.currState, end) + validateEmptyContext(t, p.context) +} + +func c0Helper(t *testing.T, bytes []byte, expectedState string, expectedCalls []string) { + parser, evtHandler := createTestParser("Ground") + parser.Parse(bytes) + validateState(t, parser.currState, expectedState) + validateFuncCalls(t, evtHandler.FunctionCalls, expectedCalls) +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/parser_test_utilities.go b/vendor/src/github.com/Azure/go-ansiterm/parser_test_utilities.go new file mode 100644 index 0000000000..51d1d49bf0 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/parser_test_utilities.go @@ -0,0 +1,66 @@ +package ansiterm + +import ( + "testing" +) + +func createTestParser(s string) (*AnsiParser, *TestAnsiEventHandler) { + evtHandler := CreateTestAnsiEventHandler() + parser := CreateParser(s, evtHandler) + + return parser, evtHandler +} + +func validateState(t *testing.T, actualState State, expectedStateName string) { + actualName := "Nil" + + if actualState != nil { + actualName = actualState.Name() + } + + if actualName != expectedStateName { + t.Errorf("Invalid State: '%s' != '%s'", actualName, expectedStateName) + } +} + +func validateFuncCalls(t *testing.T, actualCalls []string, expectedCalls []string) { + actualCount := len(actualCalls) + expectedCount := len(expectedCalls) + + if actualCount != expectedCount { + t.Errorf("Actual calls: %v", actualCalls) + t.Errorf("Expected calls: %v", expectedCalls) + t.Errorf("Call count error: %d != %d", actualCount, expectedCount) + return + } + + for i, v := range actualCalls { + if v != expectedCalls[i] { + t.Errorf("Actual calls: %v", actualCalls) + t.Errorf("Expected calls: %v", expectedCalls) + t.Errorf("Mismatched calls: %s != %s with lengths %d and %d", v, expectedCalls[i], len(v), len(expectedCalls[i])) + } + } +} + +func fillContext(context *AnsiContext) { + context.currentChar = 'A' + context.paramBuffer = []byte{'C', 'D', 'E'} + context.interBuffer = []byte{'F', 'G', 'H'} +} + +func validateEmptyContext(t *testing.T, context *AnsiContext) { + var expectedCurrChar byte = 0x0 + if context.currentChar != expectedCurrChar { + t.Errorf("Currentchar mismatch '%#x' != '%#x'", context.currentChar, expectedCurrChar) + } + + if len(context.paramBuffer) != 0 { + t.Errorf("Non-empty parameter buffer: %v", context.paramBuffer) + } + + if len(context.paramBuffer) != 0 { + t.Errorf("Non-empty intermediate buffer: %v", context.interBuffer) + } + +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/states.go b/vendor/src/github.com/Azure/go-ansiterm/states.go new file mode 100644 index 0000000000..0cbdcb3c83 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/states.go @@ -0,0 +1,71 @@ +package ansiterm + +type StateId int + +type State interface { + Enter() error + Exit() error + Handle(byte) (State, error) + Name() string + Transition(State) error +} + +type BaseState struct { + name string + parser *AnsiParser +} + +func (base BaseState) Enter() error { + return nil +} + +func (base BaseState) Exit() error { + return nil +} + +func (base BaseState) Handle(b byte) (s State, e error) { + + switch { + case b == CSI_ENTRY: + return base.parser.CsiEntry, nil + case b == DCS_ENTRY: + return base.parser.DcsEntry, nil + case b == ANSI_ESCAPE_PRIMARY: + return base.parser.Escape, nil + case b == OSC_STRING: + return base.parser.OscString, nil + case sliceContains(ToGroundBytes, b): + return base.parser.Ground, nil + } + + return nil, nil +} + +func (base BaseState) Name() string { + return base.name +} + +func (base BaseState) Transition(s State) error { + if s == base.parser.Ground { + execBytes := []byte{0x18} + execBytes = append(execBytes, 0x1A) + execBytes = append(execBytes, getByteRange(0x80, 0x8F)...) + execBytes = append(execBytes, getByteRange(0x91, 0x97)...) + execBytes = append(execBytes, 0x99) + execBytes = append(execBytes, 0x9A) + + if sliceContains(execBytes, base.parser.context.currentChar) { + return base.parser.execute() + } + } + + return nil +} + +type DcsEntryState struct { + BaseState +} + +type ErrorState struct { + BaseState +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/test_event_handler.go b/vendor/src/github.com/Azure/go-ansiterm/test_event_handler.go new file mode 100644 index 0000000000..60f9f30b98 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/test_event_handler.go @@ -0,0 +1,173 @@ +package ansiterm + +import ( + "fmt" + "strconv" +) + +type TestAnsiEventHandler struct { + FunctionCalls []string +} + +func CreateTestAnsiEventHandler() *TestAnsiEventHandler { + evtHandler := TestAnsiEventHandler{} + evtHandler.FunctionCalls = make([]string, 0) + return &evtHandler +} + +func (h *TestAnsiEventHandler) recordCall(call string, params []string) { + s := fmt.Sprintf("%s(%v)", call, params) + h.FunctionCalls = append(h.FunctionCalls, s) +} + +func (h *TestAnsiEventHandler) Print(b byte) error { + h.recordCall("Print", []string{string(b)}) + return nil +} + +func (h *TestAnsiEventHandler) Execute(b byte) error { + h.recordCall("Execute", []string{string(b)}) + return nil +} + +func (h *TestAnsiEventHandler) CUU(param int) error { + h.recordCall("CUU", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CUD(param int) error { + h.recordCall("CUD", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CUF(param int) error { + h.recordCall("CUF", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CUB(param int) error { + h.recordCall("CUB", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CNL(param int) error { + h.recordCall("CNL", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CPL(param int) error { + h.recordCall("CPL", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CHA(param int) error { + h.recordCall("CHA", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) VPA(param int) error { + h.recordCall("VPA", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) CUP(x int, y int) error { + xS, yS := strconv.Itoa(x), strconv.Itoa(y) + h.recordCall("CUP", []string{xS, yS}) + return nil +} + +func (h *TestAnsiEventHandler) HVP(x int, y int) error { + xS, yS := strconv.Itoa(x), strconv.Itoa(y) + h.recordCall("HVP", []string{xS, yS}) + return nil +} + +func (h *TestAnsiEventHandler) DECTCEM(visible bool) error { + h.recordCall("DECTCEM", []string{strconv.FormatBool(visible)}) + return nil +} + +func (h *TestAnsiEventHandler) DECOM(visible bool) error { + h.recordCall("DECOM", []string{strconv.FormatBool(visible)}) + return nil +} + +func (h *TestAnsiEventHandler) DECCOLM(use132 bool) error { + h.recordCall("DECOLM", []string{strconv.FormatBool(use132)}) + return nil +} + +func (h *TestAnsiEventHandler) ED(param int) error { + h.recordCall("ED", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) EL(param int) error { + h.recordCall("EL", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) IL(param int) error { + h.recordCall("IL", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) DL(param int) error { + h.recordCall("DL", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) ICH(param int) error { + h.recordCall("ICH", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) DCH(param int) error { + h.recordCall("DCH", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) SGR(params []int) error { + strings := []string{} + for _, v := range params { + strings = append(strings, strconv.Itoa(v)) + } + + h.recordCall("SGR", strings) + return nil +} + +func (h *TestAnsiEventHandler) SU(param int) error { + h.recordCall("SU", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) SD(param int) error { + h.recordCall("SD", []string{strconv.Itoa(param)}) + return nil +} + +func (h *TestAnsiEventHandler) DA(params []string) error { + h.recordCall("DA", params) + return nil +} + +func (h *TestAnsiEventHandler) DECSTBM(top int, bottom int) error { + topS, bottomS := strconv.Itoa(top), strconv.Itoa(bottom) + h.recordCall("DECSTBM", []string{topS, bottomS}) + return nil +} + +func (h *TestAnsiEventHandler) RI() error { + h.recordCall("RI", nil) + return nil +} + +func (h *TestAnsiEventHandler) IND() error { + h.recordCall("IND", nil) + return nil +} + +func (h *TestAnsiEventHandler) Flush() error { + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/utilities.go b/vendor/src/github.com/Azure/go-ansiterm/utilities.go new file mode 100644 index 0000000000..392114493a --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/utilities.go @@ -0,0 +1,21 @@ +package ansiterm + +import ( + "strconv" +) + +func sliceContains(bytes []byte, b byte) bool { + for _, v := range bytes { + if v == b { + return true + } + } + + return false +} + +func convertBytesToInteger(bytes []byte) int { + s := string(bytes) + i, _ := strconv.Atoi(s) + return i +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/ansi.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/ansi.go new file mode 100644 index 0000000000..78fe92fe65 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/ansi.go @@ -0,0 +1,182 @@ +// +build windows + +package winterm + +import ( + "fmt" + "os" + "strconv" + "strings" + "syscall" + + . "github.com/Azure/go-ansiterm" +) + +// Windows keyboard constants +// See https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx. +const ( + VK_PRIOR = 0x21 // PAGE UP key + VK_NEXT = 0x22 // PAGE DOWN key + VK_END = 0x23 // END key + VK_HOME = 0x24 // HOME key + VK_LEFT = 0x25 // LEFT ARROW key + VK_UP = 0x26 // UP ARROW key + VK_RIGHT = 0x27 // RIGHT ARROW key + VK_DOWN = 0x28 // DOWN ARROW key + VK_SELECT = 0x29 // SELECT key + VK_PRINT = 0x2A // PRINT key + VK_EXECUTE = 0x2B // EXECUTE key + VK_SNAPSHOT = 0x2C // PRINT SCREEN key + VK_INSERT = 0x2D // INS key + VK_DELETE = 0x2E // DEL key + VK_HELP = 0x2F // HELP key + VK_F1 = 0x70 // F1 key + VK_F2 = 0x71 // F2 key + VK_F3 = 0x72 // F3 key + VK_F4 = 0x73 // F4 key + VK_F5 = 0x74 // F5 key + VK_F6 = 0x75 // F6 key + VK_F7 = 0x76 // F7 key + VK_F8 = 0x77 // F8 key + VK_F9 = 0x78 // F9 key + VK_F10 = 0x79 // F10 key + VK_F11 = 0x7A // F11 key + VK_F12 = 0x7B // F12 key + + RIGHT_ALT_PRESSED = 0x0001 + LEFT_ALT_PRESSED = 0x0002 + RIGHT_CTRL_PRESSED = 0x0004 + LEFT_CTRL_PRESSED = 0x0008 + SHIFT_PRESSED = 0x0010 + NUMLOCK_ON = 0x0020 + SCROLLLOCK_ON = 0x0040 + CAPSLOCK_ON = 0x0080 + ENHANCED_KEY = 0x0100 +) + +type ansiCommand struct { + CommandBytes []byte + Command string + Parameters []string + IsSpecial bool +} + +func newAnsiCommand(command []byte) *ansiCommand { + + if isCharacterSelectionCmdChar(command[1]) { + // Is Character Set Selection commands + return &ansiCommand{ + CommandBytes: command, + Command: string(command), + IsSpecial: true, + } + } + + // last char is command character + lastCharIndex := len(command) - 1 + + ac := &ansiCommand{ + CommandBytes: command, + Command: string(command[lastCharIndex]), + IsSpecial: false, + } + + // more than a single escape + if lastCharIndex != 0 { + start := 1 + // skip if double char escape sequence + if command[0] == ANSI_ESCAPE_PRIMARY && command[1] == ANSI_ESCAPE_SECONDARY { + start++ + } + // convert this to GetNextParam method + ac.Parameters = strings.Split(string(command[start:lastCharIndex]), ANSI_PARAMETER_SEP) + } + + return ac +} + +func (ac *ansiCommand) paramAsSHORT(index int, defaultValue SHORT) SHORT { + if index < 0 || index >= len(ac.Parameters) { + return defaultValue + } + + param, err := strconv.ParseInt(ac.Parameters[index], 10, 16) + if err != nil { + return defaultValue + } + + return SHORT(param) +} + +func (ac *ansiCommand) String() string { + return fmt.Sprintf("0x%v \"%v\" (\"%v\")", + bytesToHex(ac.CommandBytes), + ac.Command, + strings.Join(ac.Parameters, "\",\"")) +} + +// isAnsiCommandChar returns true if the passed byte falls within the range of ANSI commands. +// See http://manpages.ubuntu.com/manpages/intrepid/man4/console_codes.4.html. +func isAnsiCommandChar(b byte) bool { + switch { + case ANSI_COMMAND_FIRST <= b && b <= ANSI_COMMAND_LAST && b != ANSI_ESCAPE_SECONDARY: + return true + case b == ANSI_CMD_G1 || b == ANSI_CMD_OSC || b == ANSI_CMD_DECPAM || b == ANSI_CMD_DECPNM: + // non-CSI escape sequence terminator + return true + case b == ANSI_CMD_STR_TERM || b == ANSI_BEL: + // String escape sequence terminator + return true + } + return false +} + +func isXtermOscSequence(command []byte, current byte) bool { + return (len(command) >= 2 && command[0] == ANSI_ESCAPE_PRIMARY && command[1] == ANSI_CMD_OSC && current != ANSI_BEL) +} + +func isCharacterSelectionCmdChar(b byte) bool { + return (b == ANSI_CMD_G0 || b == ANSI_CMD_G1 || b == ANSI_CMD_G2 || b == ANSI_CMD_G3) +} + +// bytesToHex converts a slice of bytes to a human-readable string. +func bytesToHex(b []byte) string { + hex := make([]string, len(b)) + for i, ch := range b { + hex[i] = fmt.Sprintf("%X", ch) + } + return strings.Join(hex, "") +} + +// ensureInRange adjusts the passed value, if necessary, to ensure it is within +// the passed min / max range. +func ensureInRange(n SHORT, min SHORT, max SHORT) SHORT { + if n < min { + return min + } else if n > max { + return max + } else { + return n + } +} + +func GetStdFile(nFile int) (*os.File, uintptr) { + var file *os.File + switch nFile { + case syscall.STD_INPUT_HANDLE: + file = os.Stdin + case syscall.STD_OUTPUT_HANDLE: + file = os.Stdout + case syscall.STD_ERROR_HANDLE: + file = os.Stderr + default: + panic(fmt.Errorf("Invalid standard handle identifier: %v", nFile)) + } + + fd, err := syscall.GetStdHandle(nFile) + if err != nil { + panic(fmt.Errorf("Invalid standard handle indentifier: %v -- %v", nFile, err)) + } + + return file, uintptr(fd) +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/api.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/api.go new file mode 100644 index 0000000000..1f2f3853cc --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/api.go @@ -0,0 +1,329 @@ +// +build windows + +package winterm + +import ( + "fmt" + "syscall" + "unsafe" +) + +//=========================================================================================================== +// IMPORTANT NOTE: +// +// The methods below make extensive use of the "unsafe" package to obtain the required pointers. +// Beginning in Go 1.3, the garbage collector may release local variables (e.g., incoming arguments, stack +// variables) the pointers reference *before* the API completes. +// +// As a result, in those cases, the code must hint that the variables remain in active by invoking the +// dummy method "use" (see below). Newer versions of Go are planned to change the mechanism to no longer +// require unsafe pointers. +// +// If you add or modify methods, ENSURE protection of local variables through the "use" builtin to inform +// the garbage collector the variables remain in use if: +// +// -- The value is not a pointer (e.g., int32, struct) +// -- The value is not referenced by the method after passing the pointer to Windows +// +// See http://golang.org/doc/go1.3. +//=========================================================================================================== + +var ( + kernel32DLL = syscall.NewLazyDLL("kernel32.dll") + + getConsoleCursorInfoProc = kernel32DLL.NewProc("GetConsoleCursorInfo") + setConsoleCursorInfoProc = kernel32DLL.NewProc("SetConsoleCursorInfo") + setConsoleCursorPositionProc = kernel32DLL.NewProc("SetConsoleCursorPosition") + setConsoleModeProc = kernel32DLL.NewProc("SetConsoleMode") + getConsoleScreenBufferInfoProc = kernel32DLL.NewProc("GetConsoleScreenBufferInfo") + setConsoleScreenBufferSizeProc = kernel32DLL.NewProc("SetConsoleScreenBufferSize") + scrollConsoleScreenBufferProc = kernel32DLL.NewProc("ScrollConsoleScreenBufferA") + setConsoleTextAttributeProc = kernel32DLL.NewProc("SetConsoleTextAttribute") + setConsoleWindowInfoProc = kernel32DLL.NewProc("SetConsoleWindowInfo") + writeConsoleOutputProc = kernel32DLL.NewProc("WriteConsoleOutputW") + readConsoleInputProc = kernel32DLL.NewProc("ReadConsoleInputW") + waitForSingleObjectProc = kernel32DLL.NewProc("WaitForSingleObject") +) + +// Windows Console constants +const ( + // Console modes + // See https://msdn.microsoft.com/en-us/library/windows/desktop/ms686033(v=vs.85).aspx. + ENABLE_PROCESSED_INPUT = 0x0001 + ENABLE_LINE_INPUT = 0x0002 + ENABLE_ECHO_INPUT = 0x0004 + ENABLE_WINDOW_INPUT = 0x0008 + ENABLE_MOUSE_INPUT = 0x0010 + ENABLE_INSERT_MODE = 0x0020 + ENABLE_QUICK_EDIT_MODE = 0x0040 + ENABLE_EXTENDED_FLAGS = 0x0080 + + ENABLE_PROCESSED_OUTPUT = 0x0001 + ENABLE_WRAP_AT_EOL_OUTPUT = 0x0002 + + // Character attributes + // Note: + // -- The attributes are combined to produce various colors (e.g., Blue + Green will create Cyan). + // Clearing all foreground or background colors results in black; setting all creates white. + // See https://msdn.microsoft.com/en-us/library/windows/desktop/ms682088(v=vs.85).aspx#_win32_character_attributes. + FOREGROUND_BLUE WORD = 0x0001 + FOREGROUND_GREEN WORD = 0x0002 + FOREGROUND_RED WORD = 0x0004 + FOREGROUND_INTENSITY WORD = 0x0008 + FOREGROUND_MASK WORD = 0x000F + + BACKGROUND_BLUE WORD = 0x0010 + BACKGROUND_GREEN WORD = 0x0020 + BACKGROUND_RED WORD = 0x0040 + BACKGROUND_INTENSITY WORD = 0x0080 + BACKGROUND_MASK WORD = 0x00F0 + + COMMON_LVB_MASK WORD = 0xFF00 + COMMON_LVB_REVERSE_VIDEO WORD = 0x4000 + COMMON_LVB_UNDERSCORE WORD = 0x8000 + + // Input event types + // See https://msdn.microsoft.com/en-us/library/windows/desktop/ms683499(v=vs.85).aspx. + KEY_EVENT = 0x0001 + MOUSE_EVENT = 0x0002 + WINDOW_BUFFER_SIZE_EVENT = 0x0004 + MENU_EVENT = 0x0008 + FOCUS_EVENT = 0x0010 + + // WaitForSingleObject return codes + WAIT_ABANDONED = 0x00000080 + WAIT_FAILED = 0xFFFFFFFF + WAIT_SIGNALED = 0x0000000 + WAIT_TIMEOUT = 0x00000102 + + // WaitForSingleObject wait duration + WAIT_INFINITE = 0xFFFFFFFF + WAIT_ONE_SECOND = 1000 + WAIT_HALF_SECOND = 500 + WAIT_QUARTER_SECOND = 250 +) + +// Windows API Console types +// -- See https://msdn.microsoft.com/en-us/library/windows/desktop/aa383751(v=vs.85).aspx for core types (e.g., SHORT) +// -- See https://msdn.microsoft.com/en-us/library/windows/desktop/ms682101(v=vs.85).aspx for Console specific types (e.g., COORD) +// -- See https://msdn.microsoft.com/en-us/library/aa296569(v=vs.60).aspx for comments on alignment +type ( + SHORT int16 + BOOL int32 + WORD uint16 + WCHAR uint16 + DWORD uint32 + + CHAR_INFO struct { + UnicodeChar WCHAR + Attributes WORD + } + + CONSOLE_CURSOR_INFO struct { + Size DWORD + Visible BOOL + } + + CONSOLE_SCREEN_BUFFER_INFO struct { + Size COORD + CursorPosition COORD + Attributes WORD + Window SMALL_RECT + MaximumWindowSize COORD + } + + COORD struct { + X SHORT + Y SHORT + } + + SMALL_RECT struct { + Left SHORT + Top SHORT + Right SHORT + Bottom SHORT + } + + // INPUT_RECORD is a C/C++ union of which KEY_EVENT_RECORD is one case, it is also the largest + // See https://msdn.microsoft.com/en-us/library/windows/desktop/ms683499(v=vs.85).aspx. + INPUT_RECORD struct { + EventType WORD + KeyEvent KEY_EVENT_RECORD + } + + KEY_EVENT_RECORD struct { + KeyDown BOOL + RepeatCount WORD + VirtualKeyCode WORD + VirtualScanCode WORD + UnicodeChar WCHAR + ControlKeyState DWORD + } + + WINDOW_BUFFER_SIZE struct { + Size COORD + } +) + +// boolToBOOL converts a Go bool into a Windows BOOL. +func boolToBOOL(f bool) BOOL { + if f { + return BOOL(1) + } else { + return BOOL(0) + } +} + +// GetConsoleCursorInfo retrieves information about the size and visiblity of the console cursor. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms683163(v=vs.85).aspx. +func GetConsoleCursorInfo(handle uintptr, cursorInfo *CONSOLE_CURSOR_INFO) error { + r1, r2, err := getConsoleCursorInfoProc.Call(handle, uintptr(unsafe.Pointer(cursorInfo)), 0) + return checkError(r1, r2, err) +} + +// SetConsoleCursorInfo sets the size and visiblity of the console cursor. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms686019(v=vs.85).aspx. +func SetConsoleCursorInfo(handle uintptr, cursorInfo *CONSOLE_CURSOR_INFO) error { + r1, r2, err := setConsoleCursorInfoProc.Call(handle, uintptr(unsafe.Pointer(cursorInfo)), 0) + return checkError(r1, r2, err) +} + +// SetConsoleCursorPosition location of the console cursor. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms686025(v=vs.85).aspx. +func SetConsoleCursorPosition(handle uintptr, coord COORD) error { + r1, r2, err := setConsoleCursorPositionProc.Call(handle, coordToPointer(coord)) + use(coord) + return checkError(r1, r2, err) +} + +// GetConsoleMode gets the console mode for given file descriptor +// See http://msdn.microsoft.com/en-us/library/windows/desktop/ms683167(v=vs.85).aspx. +func GetConsoleMode(handle uintptr) (mode uint32, err error) { + err = syscall.GetConsoleMode(syscall.Handle(handle), &mode) + return mode, err +} + +// SetConsoleMode sets the console mode for given file descriptor +// See http://msdn.microsoft.com/en-us/library/windows/desktop/ms686033(v=vs.85).aspx. +func SetConsoleMode(handle uintptr, mode uint32) error { + r1, r2, err := setConsoleModeProc.Call(handle, uintptr(mode), 0) + use(mode) + return checkError(r1, r2, err) +} + +// GetConsoleScreenBufferInfo retrieves information about the specified console screen buffer. +// See http://msdn.microsoft.com/en-us/library/windows/desktop/ms683171(v=vs.85).aspx. +func GetConsoleScreenBufferInfo(handle uintptr) (*CONSOLE_SCREEN_BUFFER_INFO, error) { + info := CONSOLE_SCREEN_BUFFER_INFO{} + err := checkError(getConsoleScreenBufferInfoProc.Call(handle, uintptr(unsafe.Pointer(&info)), 0)) + if err != nil { + return nil, err + } + return &info, nil +} + +func ScrollConsoleScreenBuffer(handle uintptr, scrollRect SMALL_RECT, clipRect SMALL_RECT, destOrigin COORD, char CHAR_INFO) error { + r1, r2, err := scrollConsoleScreenBufferProc.Call(handle, uintptr(unsafe.Pointer(&scrollRect)), uintptr(unsafe.Pointer(&clipRect)), coordToPointer(destOrigin), uintptr(unsafe.Pointer(&char))) + use(scrollRect) + use(clipRect) + use(destOrigin) + use(char) + return checkError(r1, r2, err) +} + +// SetConsoleScreenBufferSize sets the size of the console screen buffer. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms686044(v=vs.85).aspx. +func SetConsoleScreenBufferSize(handle uintptr, coord COORD) error { + r1, r2, err := setConsoleScreenBufferSizeProc.Call(handle, coordToPointer(coord)) + use(coord) + return checkError(r1, r2, err) +} + +// SetConsoleTextAttribute sets the attributes of characters written to the +// console screen buffer by the WriteFile or WriteConsole function. +// See http://msdn.microsoft.com/en-us/library/windows/desktop/ms686047(v=vs.85).aspx. +func SetConsoleTextAttribute(handle uintptr, attribute WORD) error { + r1, r2, err := setConsoleTextAttributeProc.Call(handle, uintptr(attribute), 0) + use(attribute) + return checkError(r1, r2, err) +} + +// SetConsoleWindowInfo sets the size and position of the console screen buffer's window. +// Note that the size and location must be within and no larger than the backing console screen buffer. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms686125(v=vs.85).aspx. +func SetConsoleWindowInfo(handle uintptr, isAbsolute bool, rect SMALL_RECT) error { + r1, r2, err := setConsoleWindowInfoProc.Call(handle, uintptr(boolToBOOL(isAbsolute)), uintptr(unsafe.Pointer(&rect))) + use(isAbsolute) + use(rect) + return checkError(r1, r2, err) +} + +// WriteConsoleOutput writes the CHAR_INFOs from the provided buffer to the active console buffer. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms687404(v=vs.85).aspx. +func WriteConsoleOutput(handle uintptr, buffer []CHAR_INFO, bufferSize COORD, bufferCoord COORD, writeRegion *SMALL_RECT) error { + r1, r2, err := writeConsoleOutputProc.Call(handle, uintptr(unsafe.Pointer(&buffer[0])), coordToPointer(bufferSize), coordToPointer(bufferCoord), uintptr(unsafe.Pointer(writeRegion))) + use(buffer) + use(bufferSize) + use(bufferCoord) + return checkError(r1, r2, err) +} + +// ReadConsoleInput reads (and removes) data from the console input buffer. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms684961(v=vs.85).aspx. +func ReadConsoleInput(handle uintptr, buffer []INPUT_RECORD, count *uint32) error { + r1, r2, err := readConsoleInputProc.Call(handle, uintptr(unsafe.Pointer(&buffer[0])), uintptr(len(buffer)), uintptr(unsafe.Pointer(count))) + use(buffer) + return checkError(r1, r2, err) +} + +// WaitForSingleObject waits for the passed handle to be signaled. +// It returns true if the handle was signaled; false otherwise. +// See https://msdn.microsoft.com/en-us/library/windows/desktop/ms687032(v=vs.85).aspx. +func WaitForSingleObject(handle uintptr, msWait uint32) (bool, error) { + r1, _, err := waitForSingleObjectProc.Call(handle, uintptr(DWORD(msWait))) + switch r1 { + case WAIT_ABANDONED, WAIT_TIMEOUT: + return false, nil + case WAIT_SIGNALED: + return true, nil + } + use(msWait) + return false, err +} + +// String helpers +func (info CONSOLE_SCREEN_BUFFER_INFO) String() string { + return fmt.Sprintf("Size(%v) Cursor(%v) Window(%v) Max(%v)", info.Size, info.CursorPosition, info.Window, info.MaximumWindowSize) +} + +func (coord COORD) String() string { + return fmt.Sprintf("%v,%v", coord.X, coord.Y) +} + +func (rect SMALL_RECT) String() string { + return fmt.Sprintf("(%v,%v),(%v,%v)", rect.Left, rect.Top, rect.Right, rect.Bottom) +} + +// checkError evaluates the results of a Windows API call and returns the error if it failed. +func checkError(r1, r2 uintptr, err error) error { + // Windows APIs return non-zero to indicate success + if r1 != 0 { + return nil + } + + // Return the error if provided, otherwise default to EINVAL + if err != nil { + return err + } + return syscall.EINVAL +} + +// coordToPointer converts a COORD into a uintptr (by fooling the type system). +func coordToPointer(c COORD) uintptr { + // Note: This code assumes the two SHORTs are correctly laid out; the "cast" to DWORD is just to get a pointer to pass. + return uintptr(*((*DWORD)(unsafe.Pointer(&c)))) +} + +// use is a no-op, but the compiler cannot see that it is. +// Calling use(p) ensures that p is kept live until that point. +func use(p interface{}) {} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/attr_translation.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/attr_translation.go new file mode 100644 index 0000000000..94665db6fb --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/attr_translation.go @@ -0,0 +1,102 @@ +// +build windows + +package winterm + +import ( + . "github.com/Azure/go-ansiterm" +) + +const ( + FOREGROUND_COLOR_MASK = FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE + BACKGROUND_COLOR_MASK = BACKGROUND_RED | BACKGROUND_GREEN | BACKGROUND_BLUE +) + +// collectAnsiIntoWindowsAttributes modifies the passed Windows text mode flags to reflect the +// request represented by the passed ANSI mode. +func collectAnsiIntoWindowsAttributes(windowsMode WORD, inverted bool, baseMode WORD, ansiMode SHORT) (WORD, bool) { + switch ansiMode { + + // Mode styles + case ANSI_SGR_BOLD: + windowsMode = windowsMode | FOREGROUND_INTENSITY + + case ANSI_SGR_DIM, ANSI_SGR_BOLD_DIM_OFF: + windowsMode &^= FOREGROUND_INTENSITY + + case ANSI_SGR_UNDERLINE: + windowsMode = windowsMode | COMMON_LVB_UNDERSCORE + + case ANSI_SGR_REVERSE: + inverted = true + + case ANSI_SGR_REVERSE_OFF: + inverted = false + + case ANSI_SGR_UNDERLINE_OFF: + windowsMode &^= COMMON_LVB_UNDERSCORE + + // Foreground colors + case ANSI_SGR_FOREGROUND_DEFAULT: + windowsMode = (windowsMode &^ FOREGROUND_MASK) | (baseMode & FOREGROUND_MASK) + + case ANSI_SGR_FOREGROUND_BLACK: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) + + case ANSI_SGR_FOREGROUND_RED: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_RED + + case ANSI_SGR_FOREGROUND_GREEN: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_GREEN + + case ANSI_SGR_FOREGROUND_YELLOW: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_RED | FOREGROUND_GREEN + + case ANSI_SGR_FOREGROUND_BLUE: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_BLUE + + case ANSI_SGR_FOREGROUND_MAGENTA: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_RED | FOREGROUND_BLUE + + case ANSI_SGR_FOREGROUND_CYAN: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_GREEN | FOREGROUND_BLUE + + case ANSI_SGR_FOREGROUND_WHITE: + windowsMode = (windowsMode &^ FOREGROUND_COLOR_MASK) | FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE + + // Background colors + case ANSI_SGR_BACKGROUND_DEFAULT: + // Black with no intensity + windowsMode = (windowsMode &^ BACKGROUND_MASK) | (baseMode & BACKGROUND_MASK) + + case ANSI_SGR_BACKGROUND_BLACK: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) + + case ANSI_SGR_BACKGROUND_RED: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_RED + + case ANSI_SGR_BACKGROUND_GREEN: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_GREEN + + case ANSI_SGR_BACKGROUND_YELLOW: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_RED | BACKGROUND_GREEN + + case ANSI_SGR_BACKGROUND_BLUE: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_BLUE + + case ANSI_SGR_BACKGROUND_MAGENTA: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_RED | BACKGROUND_BLUE + + case ANSI_SGR_BACKGROUND_CYAN: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_GREEN | BACKGROUND_BLUE + + case ANSI_SGR_BACKGROUND_WHITE: + windowsMode = (windowsMode &^ BACKGROUND_COLOR_MASK) | BACKGROUND_RED | BACKGROUND_GREEN | BACKGROUND_BLUE + } + + return windowsMode, inverted +} + +// invertAttributes inverts the foreground and background colors of a Windows attributes value +func invertAttributes(windowsMode WORD) WORD { + return (COMMON_LVB_MASK & windowsMode) | ((FOREGROUND_MASK & windowsMode) << 4) | ((BACKGROUND_MASK & windowsMode) >> 4) +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/cursor_helpers.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/cursor_helpers.go new file mode 100644 index 0000000000..e4b1c255a4 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/cursor_helpers.go @@ -0,0 +1,101 @@ +// +build windows + +package winterm + +const ( + Horizontal = iota + Vertical +) + +func (h *WindowsAnsiEventHandler) getCursorWindow(info *CONSOLE_SCREEN_BUFFER_INFO) SMALL_RECT { + if h.originMode { + sr := h.effectiveSr(info.Window) + return SMALL_RECT{ + Top: sr.top, + Bottom: sr.bottom, + Left: 0, + Right: info.Size.X - 1, + } + } else { + return SMALL_RECT{ + Top: info.Window.Top, + Bottom: info.Window.Bottom, + Left: 0, + Right: info.Size.X - 1, + } + } +} + +// setCursorPosition sets the cursor to the specified position, bounded to the screen size +func (h *WindowsAnsiEventHandler) setCursorPosition(position COORD, window SMALL_RECT) error { + position.X = ensureInRange(position.X, window.Left, window.Right) + position.Y = ensureInRange(position.Y, window.Top, window.Bottom) + err := SetConsoleCursorPosition(h.fd, position) + if err != nil { + return err + } + logger.Infof("Cursor position set: (%d, %d)", position.X, position.Y) + return err +} + +func (h *WindowsAnsiEventHandler) moveCursorVertical(param int) error { + return h.moveCursor(Vertical, param) +} + +func (h *WindowsAnsiEventHandler) moveCursorHorizontal(param int) error { + return h.moveCursor(Horizontal, param) +} + +func (h *WindowsAnsiEventHandler) moveCursor(moveMode int, param int) error { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + position := info.CursorPosition + switch moveMode { + case Horizontal: + position.X += SHORT(param) + case Vertical: + position.Y += SHORT(param) + } + + if err = h.setCursorPosition(position, h.getCursorWindow(info)); err != nil { + return err + } + + return nil +} + +func (h *WindowsAnsiEventHandler) moveCursorLine(param int) error { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + position := info.CursorPosition + position.X = 0 + position.Y += SHORT(param) + + if err = h.setCursorPosition(position, h.getCursorWindow(info)); err != nil { + return err + } + + return nil +} + +func (h *WindowsAnsiEventHandler) moveCursorColumn(param int) error { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + position := info.CursorPosition + position.X = SHORT(param) - 1 + + if err = h.setCursorPosition(position, h.getCursorWindow(info)); err != nil { + return err + } + + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/erase_helpers.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/erase_helpers.go new file mode 100644 index 0000000000..f02a5b261b --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/erase_helpers.go @@ -0,0 +1,86 @@ +// +build windows + +package winterm + +import ( + . "github.com/Azure/go-ansiterm" +) + +func (h *WindowsAnsiEventHandler) clearRange(attributes WORD, fromCoord COORD, toCoord COORD) error { + // Ignore an invalid (negative area) request + if toCoord.Y < fromCoord.Y { + return nil + } + + var err error + + var coordStart = COORD{} + var coordEnd = COORD{} + + xCurrent, yCurrent := fromCoord.X, fromCoord.Y + xEnd, yEnd := toCoord.X, toCoord.Y + + // Clear any partial initial line + if xCurrent > 0 { + coordStart.X, coordStart.Y = xCurrent, yCurrent + coordEnd.X, coordEnd.Y = xEnd, yCurrent + + err = h.clearRect(attributes, coordStart, coordEnd) + if err != nil { + return err + } + + xCurrent = 0 + yCurrent += 1 + } + + // Clear intervening rectangular section + if yCurrent < yEnd { + coordStart.X, coordStart.Y = xCurrent, yCurrent + coordEnd.X, coordEnd.Y = xEnd, yEnd-1 + + err = h.clearRect(attributes, coordStart, coordEnd) + if err != nil { + return err + } + + xCurrent = 0 + yCurrent = yEnd + } + + // Clear remaining partial ending line + coordStart.X, coordStart.Y = xCurrent, yCurrent + coordEnd.X, coordEnd.Y = xEnd, yEnd + + err = h.clearRect(attributes, coordStart, coordEnd) + if err != nil { + return err + } + + return nil +} + +func (h *WindowsAnsiEventHandler) clearRect(attributes WORD, fromCoord COORD, toCoord COORD) error { + region := SMALL_RECT{Top: fromCoord.Y, Left: fromCoord.X, Bottom: toCoord.Y, Right: toCoord.X} + width := toCoord.X - fromCoord.X + 1 + height := toCoord.Y - fromCoord.Y + 1 + size := uint32(width) * uint32(height) + + if size <= 0 { + return nil + } + + buffer := make([]CHAR_INFO, size) + + char := CHAR_INFO{WCHAR(FILL_CHARACTER), attributes} + for i := 0; i < int(size); i++ { + buffer[i] = char + } + + err := WriteConsoleOutput(h.fd, buffer, COORD{X: width, Y: height}, COORD{X: 0, Y: 0}, ®ion) + if err != nil { + return err + } + + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/scroll_helper.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/scroll_helper.go new file mode 100644 index 0000000000..ed1998245c --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/scroll_helper.go @@ -0,0 +1,118 @@ +// +build windows + +package winterm + +// effectiveSr gets the current effective scroll region in buffer coordinates +func (h *WindowsAnsiEventHandler) effectiveSr(window SMALL_RECT) scrollRegion { + top := AddInRange(window.Top, h.sr.top, window.Top, window.Bottom) + bottom := AddInRange(window.Top, h.sr.bottom, window.Top, window.Bottom) + if top >= bottom { + top = window.Top + bottom = window.Bottom + } + return scrollRegion{top: top, bottom: bottom} +} + +func (h *WindowsAnsiEventHandler) scrollUp(param int) error { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + sr := h.effectiveSr(info.Window) + return h.scroll(param, sr, info) +} + +func (h *WindowsAnsiEventHandler) scrollDown(param int) error { + return h.scrollUp(-param) +} + +func (h *WindowsAnsiEventHandler) deleteLines(param int) error { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + start := info.CursorPosition.Y + sr := h.effectiveSr(info.Window) + // Lines cannot be inserted or deleted outside the scrolling region. + if start >= sr.top && start <= sr.bottom { + sr.top = start + return h.scroll(param, sr, info) + } else { + return nil + } +} + +func (h *WindowsAnsiEventHandler) insertLines(param int) error { + return h.deleteLines(-param) +} + +// scroll scrolls the provided scroll region by param lines. The scroll region is in buffer coordinates. +func (h *WindowsAnsiEventHandler) scroll(param int, sr scrollRegion, info *CONSOLE_SCREEN_BUFFER_INFO) error { + logger.Infof("scroll: scrollTop: %d, scrollBottom: %d", sr.top, sr.bottom) + logger.Infof("scroll: windowTop: %d, windowBottom: %d", info.Window.Top, info.Window.Bottom) + + // Copy from and clip to the scroll region (full buffer width) + scrollRect := SMALL_RECT{ + Top: sr.top, + Bottom: sr.bottom, + Left: 0, + Right: info.Size.X - 1, + } + + // Origin to which area should be copied + destOrigin := COORD{ + X: 0, + Y: sr.top - SHORT(param), + } + + char := CHAR_INFO{ + UnicodeChar: ' ', + Attributes: h.attributes, + } + + if err := ScrollConsoleScreenBuffer(h.fd, scrollRect, scrollRect, destOrigin, char); err != nil { + return err + } + return nil +} + +func (h *WindowsAnsiEventHandler) deleteCharacters(param int) error { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + return h.scrollLine(param, info.CursorPosition, info) +} + +func (h *WindowsAnsiEventHandler) insertCharacters(param int) error { + return h.deleteCharacters(-param) +} + +// scrollLine scrolls a line horizontally starting at the provided position by a number of columns. +func (h *WindowsAnsiEventHandler) scrollLine(columns int, position COORD, info *CONSOLE_SCREEN_BUFFER_INFO) error { + // Copy from and clip to the scroll region (full buffer width) + scrollRect := SMALL_RECT{ + Top: position.Y, + Bottom: position.Y, + Left: position.X, + Right: info.Size.X - 1, + } + + // Origin to which area should be copied + destOrigin := COORD{ + X: position.X - SHORT(columns), + Y: position.Y, + } + + char := CHAR_INFO{ + UnicodeChar: ' ', + Attributes: h.attributes, + } + + if err := ScrollConsoleScreenBuffer(h.fd, scrollRect, scrollRect, destOrigin, char); err != nil { + return err + } + return nil +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/utilities.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/utilities.go new file mode 100644 index 0000000000..2f963ff132 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/utilities.go @@ -0,0 +1,9 @@ +// +build windows + +package winterm + +// AddInRange increments a value by the passed quantity while ensuring the values +// always remain within the supplied min / max range. +func AddInRange(n SHORT, increment SHORT, min SHORT, max SHORT) SHORT { + return ensureInRange(n+increment, min, max) +} diff --git a/vendor/src/github.com/Azure/go-ansiterm/winterm/win_event_handler.go b/vendor/src/github.com/Azure/go-ansiterm/winterm/win_event_handler.go new file mode 100644 index 0000000000..2d492b32e4 --- /dev/null +++ b/vendor/src/github.com/Azure/go-ansiterm/winterm/win_event_handler.go @@ -0,0 +1,725 @@ +// +build windows + +package winterm + +import ( + "bytes" + "io/ioutil" + "os" + "strconv" + + . "github.com/Azure/go-ansiterm" + "github.com/Sirupsen/logrus" +) + +var logger *logrus.Logger + +type WindowsAnsiEventHandler struct { + fd uintptr + file *os.File + infoReset *CONSOLE_SCREEN_BUFFER_INFO + sr scrollRegion + buffer bytes.Buffer + attributes WORD + inverted bool + wrapNext bool + drewMarginByte bool + originMode bool + marginByte byte + curInfo *CONSOLE_SCREEN_BUFFER_INFO + curPos COORD +} + +func CreateWinEventHandler(fd uintptr, file *os.File) AnsiEventHandler { + logFile := ioutil.Discard + + if isDebugEnv := os.Getenv(LogEnv); isDebugEnv == "1" { + logFile, _ = os.Create("winEventHandler.log") + } + + logger = &logrus.Logger{ + Out: logFile, + Formatter: new(logrus.TextFormatter), + Level: logrus.DebugLevel, + } + + infoReset, err := GetConsoleScreenBufferInfo(fd) + if err != nil { + return nil + } + + return &WindowsAnsiEventHandler{ + fd: fd, + file: file, + infoReset: infoReset, + attributes: infoReset.Attributes, + } +} + +type scrollRegion struct { + top SHORT + bottom SHORT +} + +// simulateLF simulates a LF or CR+LF by scrolling if necessary to handle the +// current cursor position and scroll region settings, in which case it returns +// true. If no special handling is necessary, then it does nothing and returns +// false. +// +// In the false case, the caller should ensure that a carriage return +// and line feed are inserted or that the text is otherwise wrapped. +func (h *WindowsAnsiEventHandler) simulateLF(includeCR bool) (bool, error) { + if h.wrapNext { + if err := h.Flush(); err != nil { + return false, err + } + h.clearWrap() + } + pos, info, err := h.getCurrentInfo() + if err != nil { + return false, err + } + sr := h.effectiveSr(info.Window) + if pos.Y == sr.bottom { + // Scrolling is necessary. Let Windows automatically scroll if the scrolling region + // is the full window. + if sr.top == info.Window.Top && sr.bottom == info.Window.Bottom { + if includeCR { + pos.X = 0 + h.updatePos(pos) + } + return false, nil + } else { + // A custom scroll region is active. Scroll the window manually to simulate + // the LF. + if err := h.Flush(); err != nil { + return false, err + } + logger.Info("Simulating LF inside scroll region") + if err := h.scrollUp(1); err != nil { + return false, err + } + if includeCR { + pos.X = 0 + if err := SetConsoleCursorPosition(h.fd, pos); err != nil { + return false, err + } + } + return true, nil + } + } else if pos.Y < info.Window.Bottom { + // Let Windows handle the LF. + pos.Y++ + if includeCR { + pos.X = 0 + } + h.updatePos(pos) + return false, nil + } else { + // The cursor is at the bottom of the screen but outside the scroll + // region. Skip the LF. + logger.Info("Simulating LF outside scroll region") + if includeCR { + if err := h.Flush(); err != nil { + return false, err + } + pos.X = 0 + if err := SetConsoleCursorPosition(h.fd, pos); err != nil { + return false, err + } + } + return true, nil + } +} + +// executeLF executes a LF without a CR. +func (h *WindowsAnsiEventHandler) executeLF() error { + handled, err := h.simulateLF(false) + if err != nil { + return err + } + if !handled { + // Windows LF will reset the cursor column position. Write the LF + // and restore the cursor position. + pos, _, err := h.getCurrentInfo() + if err != nil { + return err + } + h.buffer.WriteByte(ANSI_LINE_FEED) + if pos.X != 0 { + if err := h.Flush(); err != nil { + return err + } + logger.Info("Resetting cursor position for LF without CR") + if err := SetConsoleCursorPosition(h.fd, pos); err != nil { + return err + } + } + } + return nil +} + +func (h *WindowsAnsiEventHandler) Print(b byte) error { + if h.wrapNext { + h.buffer.WriteByte(h.marginByte) + h.clearWrap() + if _, err := h.simulateLF(true); err != nil { + return err + } + } + pos, info, err := h.getCurrentInfo() + if err != nil { + return err + } + if pos.X == info.Size.X-1 { + h.wrapNext = true + h.marginByte = b + } else { + pos.X++ + h.updatePos(pos) + h.buffer.WriteByte(b) + } + return nil +} + +func (h *WindowsAnsiEventHandler) Execute(b byte) error { + switch b { + case ANSI_TAB: + logger.Info("Execute(TAB)") + // Move to the next tab stop, but preserve auto-wrap if already set. + if !h.wrapNext { + pos, info, err := h.getCurrentInfo() + if err != nil { + return err + } + pos.X = (pos.X + 8) - pos.X%8 + if pos.X >= info.Size.X { + pos.X = info.Size.X - 1 + } + if err := h.Flush(); err != nil { + return err + } + if err := SetConsoleCursorPosition(h.fd, pos); err != nil { + return err + } + } + return nil + + case ANSI_BEL: + h.buffer.WriteByte(ANSI_BEL) + return nil + + case ANSI_BACKSPACE: + if h.wrapNext { + if err := h.Flush(); err != nil { + return err + } + h.clearWrap() + } + pos, _, err := h.getCurrentInfo() + if err != nil { + return err + } + if pos.X > 0 { + pos.X-- + h.updatePos(pos) + h.buffer.WriteByte(ANSI_BACKSPACE) + } + return nil + + case ANSI_VERTICAL_TAB, ANSI_FORM_FEED: + // Treat as true LF. + return h.executeLF() + + case ANSI_LINE_FEED: + // Simulate a CR and LF for now since there is no way in go-ansiterm + // to tell if the LF should include CR (and more things break when it's + // missing than when it's incorrectly added). + handled, err := h.simulateLF(true) + if handled || err != nil { + return err + } + return h.buffer.WriteByte(ANSI_LINE_FEED) + + case ANSI_CARRIAGE_RETURN: + if h.wrapNext { + if err := h.Flush(); err != nil { + return err + } + h.clearWrap() + } + pos, _, err := h.getCurrentInfo() + if err != nil { + return err + } + if pos.X != 0 { + pos.X = 0 + h.updatePos(pos) + h.buffer.WriteByte(ANSI_CARRIAGE_RETURN) + } + return nil + + default: + return nil + } +} + +func (h *WindowsAnsiEventHandler) CUU(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CUU: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorVertical(-param) +} + +func (h *WindowsAnsiEventHandler) CUD(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CUD: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorVertical(param) +} + +func (h *WindowsAnsiEventHandler) CUF(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CUF: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorHorizontal(param) +} + +func (h *WindowsAnsiEventHandler) CUB(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CUB: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorHorizontal(-param) +} + +func (h *WindowsAnsiEventHandler) CNL(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CNL: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorLine(param) +} + +func (h *WindowsAnsiEventHandler) CPL(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CPL: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorLine(-param) +} + +func (h *WindowsAnsiEventHandler) CHA(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CHA: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.moveCursorColumn(param) +} + +func (h *WindowsAnsiEventHandler) VPA(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("VPA: [[%d]]", param) + h.clearWrap() + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + window := h.getCursorWindow(info) + position := info.CursorPosition + position.Y = window.Top + SHORT(param) - 1 + return h.setCursorPosition(position, window) +} + +func (h *WindowsAnsiEventHandler) CUP(row int, col int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("CUP: [[%d %d]]", row, col) + h.clearWrap() + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + window := h.getCursorWindow(info) + position := COORD{window.Left + SHORT(col) - 1, window.Top + SHORT(row) - 1} + return h.setCursorPosition(position, window) +} + +func (h *WindowsAnsiEventHandler) HVP(row int, col int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("HVP: [[%d %d]]", row, col) + h.clearWrap() + return h.CUP(row, col) +} + +func (h *WindowsAnsiEventHandler) DECTCEM(visible bool) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("DECTCEM: [%v]", []string{strconv.FormatBool(visible)}) + h.clearWrap() + return nil +} + +func (h *WindowsAnsiEventHandler) DECOM(enable bool) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("DECOM: [%v]", []string{strconv.FormatBool(enable)}) + h.clearWrap() + h.originMode = enable + return h.CUP(1, 1) +} + +func (h *WindowsAnsiEventHandler) DECCOLM(use132 bool) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("DECCOLM: [%v]", []string{strconv.FormatBool(use132)}) + h.clearWrap() + if err := h.ED(2); err != nil { + return err + } + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + targetWidth := SHORT(80) + if use132 { + targetWidth = 132 + } + if info.Size.X < targetWidth { + if err := SetConsoleScreenBufferSize(h.fd, COORD{targetWidth, info.Size.Y}); err != nil { + logger.Info("set buffer failed:", err) + return err + } + } + window := info.Window + window.Left = 0 + window.Right = targetWidth - 1 + if err := SetConsoleWindowInfo(h.fd, true, window); err != nil { + logger.Info("set window failed:", err) + return err + } + if info.Size.X > targetWidth { + if err := SetConsoleScreenBufferSize(h.fd, COORD{targetWidth, info.Size.Y}); err != nil { + logger.Info("set buffer failed:", err) + return err + } + } + return SetConsoleCursorPosition(h.fd, COORD{0, 0}) +} + +func (h *WindowsAnsiEventHandler) ED(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("ED: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + + // [J -- Erases from the cursor to the end of the screen, including the cursor position. + // [1J -- Erases from the beginning of the screen to the cursor, including the cursor position. + // [2J -- Erases the complete display. The cursor does not move. + // Notes: + // -- Clearing the entire buffer, versus just the Window, works best for Windows Consoles + + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + var start COORD + var end COORD + + switch param { + case 0: + start = info.CursorPosition + end = COORD{info.Size.X - 1, info.Size.Y - 1} + + case 1: + start = COORD{0, 0} + end = info.CursorPosition + + case 2: + start = COORD{0, 0} + end = COORD{info.Size.X - 1, info.Size.Y - 1} + } + + err = h.clearRange(h.attributes, start, end) + if err != nil { + return err + } + + // If the whole buffer was cleared, move the window to the top while preserving + // the window-relative cursor position. + if param == 2 { + pos := info.CursorPosition + window := info.Window + pos.Y -= window.Top + window.Bottom -= window.Top + window.Top = 0 + if err := SetConsoleCursorPosition(h.fd, pos); err != nil { + return err + } + if err := SetConsoleWindowInfo(h.fd, true, window); err != nil { + return err + } + } + + return nil +} + +func (h *WindowsAnsiEventHandler) EL(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("EL: [%v]", strconv.Itoa(param)) + h.clearWrap() + + // [K -- Erases from the cursor to the end of the line, including the cursor position. + // [1K -- Erases from the beginning of the line to the cursor, including the cursor position. + // [2K -- Erases the complete line. + + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + var start COORD + var end COORD + + switch param { + case 0: + start = info.CursorPosition + end = COORD{info.Size.X, info.CursorPosition.Y} + + case 1: + start = COORD{0, info.CursorPosition.Y} + end = info.CursorPosition + + case 2: + start = COORD{0, info.CursorPosition.Y} + end = COORD{info.Size.X, info.CursorPosition.Y} + } + + err = h.clearRange(h.attributes, start, end) + if err != nil { + return err + } + + return nil +} + +func (h *WindowsAnsiEventHandler) IL(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("IL: [%v]", strconv.Itoa(param)) + h.clearWrap() + return h.insertLines(param) +} + +func (h *WindowsAnsiEventHandler) DL(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("DL: [%v]", strconv.Itoa(param)) + h.clearWrap() + return h.deleteLines(param) +} + +func (h *WindowsAnsiEventHandler) ICH(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("ICH: [%v]", strconv.Itoa(param)) + h.clearWrap() + return h.insertCharacters(param) +} + +func (h *WindowsAnsiEventHandler) DCH(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("DCH: [%v]", strconv.Itoa(param)) + h.clearWrap() + return h.deleteCharacters(param) +} + +func (h *WindowsAnsiEventHandler) SGR(params []int) error { + if err := h.Flush(); err != nil { + return err + } + strings := []string{} + for _, v := range params { + strings = append(strings, strconv.Itoa(v)) + } + + logger.Infof("SGR: [%v]", strings) + + if len(params) <= 0 { + h.attributes = h.infoReset.Attributes + h.inverted = false + } else { + for _, attr := range params { + + if attr == ANSI_SGR_RESET { + h.attributes = h.infoReset.Attributes + h.inverted = false + continue + } + + h.attributes, h.inverted = collectAnsiIntoWindowsAttributes(h.attributes, h.inverted, h.infoReset.Attributes, SHORT(attr)) + } + } + + attributes := h.attributes + if h.inverted { + attributes = invertAttributes(attributes) + } + err := SetConsoleTextAttribute(h.fd, attributes) + if err != nil { + return err + } + + return nil +} + +func (h *WindowsAnsiEventHandler) SU(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("SU: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.scrollUp(param) +} + +func (h *WindowsAnsiEventHandler) SD(param int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("SD: [%v]", []string{strconv.Itoa(param)}) + h.clearWrap() + return h.scrollDown(param) +} + +func (h *WindowsAnsiEventHandler) DA(params []string) error { + logger.Infof("DA: [%v]", params) + // DA cannot be implemented because it must send data on the VT100 input stream, + // which is not available to go-ansiterm. + return nil +} + +func (h *WindowsAnsiEventHandler) DECSTBM(top int, bottom int) error { + if err := h.Flush(); err != nil { + return err + } + logger.Infof("DECSTBM: [%d, %d]", top, bottom) + + // Windows is 0 indexed, Linux is 1 indexed + h.sr.top = SHORT(top - 1) + h.sr.bottom = SHORT(bottom - 1) + + // This command also moves the cursor to the origin. + h.clearWrap() + return h.CUP(1, 1) +} + +func (h *WindowsAnsiEventHandler) RI() error { + if err := h.Flush(); err != nil { + return err + } + logger.Info("RI: []") + h.clearWrap() + + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + sr := h.effectiveSr(info.Window) + if info.CursorPosition.Y == sr.top { + return h.scrollDown(1) + } else { + return h.moveCursorVertical(-1) + } +} + +func (h *WindowsAnsiEventHandler) IND() error { + logger.Info("IND: []") + return h.executeLF() +} + +func (h *WindowsAnsiEventHandler) Flush() error { + h.curInfo = nil + if h.buffer.Len() > 0 { + logger.Infof("Flush: [%s]", h.buffer.Bytes()) + if _, err := h.buffer.WriteTo(h.file); err != nil { + return err + } + } + + if h.wrapNext && !h.drewMarginByte { + logger.Infof("Flush: drawing margin byte '%c'", h.marginByte) + + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return err + } + + charInfo := []CHAR_INFO{{UnicodeChar: WCHAR(h.marginByte), Attributes: info.Attributes}} + size := COORD{1, 1} + position := COORD{0, 0} + region := SMALL_RECT{Left: info.CursorPosition.X, Top: info.CursorPosition.Y, Right: info.CursorPosition.X, Bottom: info.CursorPosition.Y} + if err := WriteConsoleOutput(h.fd, charInfo, size, position, ®ion); err != nil { + return err + } + h.drewMarginByte = true + } + return nil +} + +// cacheConsoleInfo ensures that the current console screen information has been queried +// since the last call to Flush(). It must be called before accessing h.curInfo or h.curPos. +func (h *WindowsAnsiEventHandler) getCurrentInfo() (COORD, *CONSOLE_SCREEN_BUFFER_INFO, error) { + if h.curInfo == nil { + info, err := GetConsoleScreenBufferInfo(h.fd) + if err != nil { + return COORD{}, nil, err + } + h.curInfo = info + h.curPos = info.CursorPosition + } + return h.curPos, h.curInfo, nil +} + +func (h *WindowsAnsiEventHandler) updatePos(pos COORD) { + if h.curInfo == nil { + panic("failed to call getCurrentInfo before calling updatePos") + } + h.curPos = pos +} + +// clearWrap clears the state where the cursor is in the margin +// waiting for the next character before wrapping the line. This must +// be done before most operations that act on the cursor. +func (h *WindowsAnsiEventHandler) clearWrap() { + h.wrapNext = false + h.drewMarginByte = false +} diff --git a/vendor/src/github.com/BurntSushi/toml/.gitignore b/vendor/src/github.com/BurntSushi/toml/.gitignore new file mode 100644 index 0000000000..0cd3800377 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/.gitignore @@ -0,0 +1,5 @@ +TAGS +tags +.*.swp +tomlcheck/tomlcheck +toml.test diff --git a/vendor/src/github.com/BurntSushi/toml/.travis.yml b/vendor/src/github.com/BurntSushi/toml/.travis.yml new file mode 100644 index 0000000000..43caf6d021 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/.travis.yml @@ -0,0 +1,12 @@ +language: go +go: + - 1.1 + - 1.2 + - tip +install: + - go install ./... + - go get github.com/BurntSushi/toml-test +script: + - export PATH="$PATH:$HOME/gopath/bin" + - make test + diff --git a/vendor/src/github.com/BurntSushi/toml/COMPATIBLE b/vendor/src/github.com/BurntSushi/toml/COMPATIBLE new file mode 100644 index 0000000000..21e0938cae --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/COMPATIBLE @@ -0,0 +1,3 @@ +Compatible with TOML version +[v0.2.0](https://github.com/mojombo/toml/blob/master/versions/toml-v0.2.0.md) + diff --git a/vendor/src/github.com/BurntSushi/toml/COPYING b/vendor/src/github.com/BurntSushi/toml/COPYING new file mode 100644 index 0000000000..5a8e332545 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/COPYING @@ -0,0 +1,14 @@ + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + Version 2, December 2004 + + Copyright (C) 2004 Sam Hocevar + + Everyone is permitted to copy and distribute verbatim or modified + copies of this license document, and changing it is allowed as long + as the name is changed. + + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. You just DO WHAT THE FUCK YOU WANT TO. + diff --git a/vendor/src/github.com/BurntSushi/toml/Makefile b/vendor/src/github.com/BurntSushi/toml/Makefile new file mode 100644 index 0000000000..3600848d33 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/Makefile @@ -0,0 +1,19 @@ +install: + go install ./... + +test: install + go test -v + toml-test toml-test-decoder + toml-test -encoder toml-test-encoder + +fmt: + gofmt -w *.go */*.go + colcheck *.go */*.go + +tags: + find ./ -name '*.go' -print0 | xargs -0 gotags > TAGS + +push: + git push origin master + git push github master + diff --git a/vendor/src/github.com/BurntSushi/toml/README.md b/vendor/src/github.com/BurntSushi/toml/README.md new file mode 100644 index 0000000000..e861c0ca7b --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/README.md @@ -0,0 +1,220 @@ +## TOML parser and encoder for Go with reflection + +TOML stands for Tom's Obvious, Minimal Language. This Go package provides a +reflection interface similar to Go's standard library `json` and `xml` +packages. This package also supports the `encoding.TextUnmarshaler` and +`encoding.TextMarshaler` interfaces so that you can define custom data +representations. (There is an example of this below.) + +Spec: https://github.com/mojombo/toml + +Compatible with TOML version +[v0.2.0](https://github.com/mojombo/toml/blob/master/versions/toml-v0.2.0.md) + +Documentation: http://godoc.org/github.com/BurntSushi/toml + +Installation: + +```bash +go get github.com/BurntSushi/toml +``` + +Try the toml validator: + +```bash +go get github.com/BurntSushi/toml/cmd/tomlv +tomlv some-toml-file.toml +``` + +[![Build status](https://api.travis-ci.org/BurntSushi/toml.png)](https://travis-ci.org/BurntSushi/toml) + + +### Testing + +This package passes all tests in +[toml-test](https://github.com/BurntSushi/toml-test) for both the decoder +and the encoder. + +### Examples + +This package works similarly to how the Go standard library handles `XML` +and `JSON`. Namely, data is loaded into Go values via reflection. + +For the simplest example, consider some TOML file as just a list of keys +and values: + +```toml +Age = 25 +Cats = [ "Cauchy", "Plato" ] +Pi = 3.14 +Perfection = [ 6, 28, 496, 8128 ] +DOB = 1987-07-05T05:45:00Z +``` + +Which could be defined in Go as: + +```go +type Config struct { + Age int + Cats []string + Pi float64 + Perfection []int + DOB time.Time // requires `import time` +} +``` + +And then decoded with: + +```go +var conf Config +if _, err := toml.Decode(tomlData, &conf); err != nil { + // handle error +} +``` + +You can also use struct tags if your struct field name doesn't map to a TOML +key value directly: + +```toml +some_key_NAME = "wat" +``` + +```go +type TOML struct { + ObscureKey string `toml:"some_key_NAME"` +} +``` + +### Using the `encoding.TextUnmarshaler` interface + +Here's an example that automatically parses duration strings into +`time.Duration` values: + +```toml +[[song]] +name = "Thunder Road" +duration = "4m49s" + +[[song]] +name = "Stairway to Heaven" +duration = "8m03s" +``` + +Which can be decoded with: + +```go +type song struct { + Name string + Duration duration +} +type songs struct { + Song []song +} +var favorites songs +if _, err := toml.Decode(blob, &favorites); err != nil { + log.Fatal(err) +} + +for _, s := range favorites.Song { + fmt.Printf("%s (%s)\n", s.Name, s.Duration) +} +``` + +And you'll also need a `duration` type that satisfies the +`encoding.TextUnmarshaler` interface: + +```go +type duration struct { + time.Duration +} + +func (d *duration) UnmarshalText(text []byte) error { + var err error + d.Duration, err = time.ParseDuration(string(text)) + return err +} +``` + +### More complex usage + +Here's an example of how to load the example from the official spec page: + +```toml +# This is a TOML document. Boom. + +title = "TOML Example" + +[owner] +name = "Tom Preston-Werner" +organization = "GitHub" +bio = "GitHub Cofounder & CEO\nLikes tater tots and beer." +dob = 1979-05-27T07:32:00Z # First class dates? Why not? + +[database] +server = "192.168.1.1" +ports = [ 8001, 8001, 8002 ] +connection_max = 5000 +enabled = true + +[servers] + + # You can indent as you please. Tabs or spaces. TOML don't care. + [servers.alpha] + ip = "10.0.0.1" + dc = "eqdc10" + + [servers.beta] + ip = "10.0.0.2" + dc = "eqdc10" + +[clients] +data = [ ["gamma", "delta"], [1, 2] ] # just an update to make sure parsers support it + +# Line breaks are OK when inside arrays +hosts = [ + "alpha", + "omega" +] +``` + +And the corresponding Go types are: + +```go +type tomlConfig struct { + Title string + Owner ownerInfo + DB database `toml:"database"` + Servers map[string]server + Clients clients +} + +type ownerInfo struct { + Name string + Org string `toml:"organization"` + Bio string + DOB time.Time +} + +type database struct { + Server string + Ports []int + ConnMax int `toml:"connection_max"` + Enabled bool +} + +type server struct { + IP string + DC string +} + +type clients struct { + Data [][]interface{} + Hosts []string +} +``` + +Note that a case insensitive match will be tried if an exact match can't be +found. + +A working example of the above can be found in `_examples/example.{go,toml}`. + diff --git a/vendor/src/github.com/BurntSushi/toml/cmd/toml-test-decoder/COPYING b/vendor/src/github.com/BurntSushi/toml/cmd/toml-test-decoder/COPYING new file mode 100644 index 0000000000..5a8e332545 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/cmd/toml-test-decoder/COPYING @@ -0,0 +1,14 @@ + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + Version 2, December 2004 + + Copyright (C) 2004 Sam Hocevar + + Everyone is permitted to copy and distribute verbatim or modified + copies of this license document, and changing it is allowed as long + as the name is changed. + + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. You just DO WHAT THE FUCK YOU WANT TO. + diff --git a/vendor/src/github.com/BurntSushi/toml/cmd/toml-test-encoder/COPYING b/vendor/src/github.com/BurntSushi/toml/cmd/toml-test-encoder/COPYING new file mode 100644 index 0000000000..5a8e332545 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/cmd/toml-test-encoder/COPYING @@ -0,0 +1,14 @@ + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + Version 2, December 2004 + + Copyright (C) 2004 Sam Hocevar + + Everyone is permitted to copy and distribute verbatim or modified + copies of this license document, and changing it is allowed as long + as the name is changed. + + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. You just DO WHAT THE FUCK YOU WANT TO. + diff --git a/vendor/src/github.com/BurntSushi/toml/cmd/tomlv/COPYING b/vendor/src/github.com/BurntSushi/toml/cmd/tomlv/COPYING new file mode 100644 index 0000000000..5a8e332545 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/cmd/tomlv/COPYING @@ -0,0 +1,14 @@ + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + Version 2, December 2004 + + Copyright (C) 2004 Sam Hocevar + + Everyone is permitted to copy and distribute verbatim or modified + copies of this license document, and changing it is allowed as long + as the name is changed. + + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. You just DO WHAT THE FUCK YOU WANT TO. + diff --git a/vendor/src/github.com/BurntSushi/toml/decode.go b/vendor/src/github.com/BurntSushi/toml/decode.go new file mode 100644 index 0000000000..6c7d398b89 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/decode.go @@ -0,0 +1,492 @@ +package toml + +import ( + "fmt" + "io" + "io/ioutil" + "math" + "reflect" + "strings" + "time" +) + +var e = fmt.Errorf + +// Unmarshaler is the interface implemented by objects that can unmarshal a +// TOML description of themselves. +type Unmarshaler interface { + UnmarshalTOML(interface{}) error +} + +// Unmarshal decodes the contents of `p` in TOML format into a pointer `v`. +func Unmarshal(p []byte, v interface{}) error { + _, err := Decode(string(p), v) + return err +} + +// Primitive is a TOML value that hasn't been decoded into a Go value. +// When using the various `Decode*` functions, the type `Primitive` may +// be given to any value, and its decoding will be delayed. +// +// A `Primitive` value can be decoded using the `PrimitiveDecode` function. +// +// The underlying representation of a `Primitive` value is subject to change. +// Do not rely on it. +// +// N.B. Primitive values are still parsed, so using them will only avoid +// the overhead of reflection. They can be useful when you don't know the +// exact type of TOML data until run time. +type Primitive struct { + undecoded interface{} + context Key +} + +// DEPRECATED! +// +// Use MetaData.PrimitiveDecode instead. +func PrimitiveDecode(primValue Primitive, v interface{}) error { + md := MetaData{decoded: make(map[string]bool)} + return md.unify(primValue.undecoded, rvalue(v)) +} + +// PrimitiveDecode is just like the other `Decode*` functions, except it +// decodes a TOML value that has already been parsed. Valid primitive values +// can *only* be obtained from values filled by the decoder functions, +// including this method. (i.e., `v` may contain more `Primitive` +// values.) +// +// Meta data for primitive values is included in the meta data returned by +// the `Decode*` functions with one exception: keys returned by the Undecoded +// method will only reflect keys that were decoded. Namely, any keys hidden +// behind a Primitive will be considered undecoded. Executing this method will +// update the undecoded keys in the meta data. (See the example.) +func (md *MetaData) PrimitiveDecode(primValue Primitive, v interface{}) error { + md.context = primValue.context + defer func() { md.context = nil }() + return md.unify(primValue.undecoded, rvalue(v)) +} + +// Decode will decode the contents of `data` in TOML format into a pointer +// `v`. +// +// TOML hashes correspond to Go structs or maps. (Dealer's choice. They can be +// used interchangeably.) +// +// TOML arrays of tables correspond to either a slice of structs or a slice +// of maps. +// +// TOML datetimes correspond to Go `time.Time` values. +// +// All other TOML types (float, string, int, bool and array) correspond +// to the obvious Go types. +// +// An exception to the above rules is if a type implements the +// encoding.TextUnmarshaler interface. In this case, any primitive TOML value +// (floats, strings, integers, booleans and datetimes) will be converted to +// a byte string and given to the value's UnmarshalText method. See the +// Unmarshaler example for a demonstration with time duration strings. +// +// Key mapping +// +// TOML keys can map to either keys in a Go map or field names in a Go +// struct. The special `toml` struct tag may be used to map TOML keys to +// struct fields that don't match the key name exactly. (See the example.) +// A case insensitive match to struct names will be tried if an exact match +// can't be found. +// +// The mapping between TOML values and Go values is loose. That is, there +// may exist TOML values that cannot be placed into your representation, and +// there may be parts of your representation that do not correspond to +// TOML values. This loose mapping can be made stricter by using the IsDefined +// and/or Undecoded methods on the MetaData returned. +// +// This decoder will not handle cyclic types. If a cyclic type is passed, +// `Decode` will not terminate. +func Decode(data string, v interface{}) (MetaData, error) { + p, err := parse(data) + if err != nil { + return MetaData{}, err + } + md := MetaData{ + p.mapping, p.types, p.ordered, + make(map[string]bool, len(p.ordered)), nil, + } + return md, md.unify(p.mapping, rvalue(v)) +} + +// DecodeFile is just like Decode, except it will automatically read the +// contents of the file at `fpath` and decode it for you. +func DecodeFile(fpath string, v interface{}) (MetaData, error) { + bs, err := ioutil.ReadFile(fpath) + if err != nil { + return MetaData{}, err + } + return Decode(string(bs), v) +} + +// DecodeReader is just like Decode, except it will consume all bytes +// from the reader and decode it for you. +func DecodeReader(r io.Reader, v interface{}) (MetaData, error) { + bs, err := ioutil.ReadAll(r) + if err != nil { + return MetaData{}, err + } + return Decode(string(bs), v) +} + +// unify performs a sort of type unification based on the structure of `rv`, +// which is the client representation. +// +// Any type mismatch produces an error. Finding a type that we don't know +// how to handle produces an unsupported type error. +func (md *MetaData) unify(data interface{}, rv reflect.Value) error { + + // Special case. Look for a `Primitive` value. + if rv.Type() == reflect.TypeOf((*Primitive)(nil)).Elem() { + // Save the undecoded data and the key context into the primitive + // value. + context := make(Key, len(md.context)) + copy(context, md.context) + rv.Set(reflect.ValueOf(Primitive{ + undecoded: data, + context: context, + })) + return nil + } + + // Special case. Unmarshaler Interface support. + if rv.CanAddr() { + if v, ok := rv.Addr().Interface().(Unmarshaler); ok { + return v.UnmarshalTOML(data) + } + } + + // Special case. Handle time.Time values specifically. + // TODO: Remove this code when we decide to drop support for Go 1.1. + // This isn't necessary in Go 1.2 because time.Time satisfies the encoding + // interfaces. + if rv.Type().AssignableTo(rvalue(time.Time{}).Type()) { + return md.unifyDatetime(data, rv) + } + + // Special case. Look for a value satisfying the TextUnmarshaler interface. + if v, ok := rv.Interface().(TextUnmarshaler); ok { + return md.unifyText(data, v) + } + // BUG(burntsushi) + // The behavior here is incorrect whenever a Go type satisfies the + // encoding.TextUnmarshaler interface but also corresponds to a TOML + // hash or array. In particular, the unmarshaler should only be applied + // to primitive TOML values. But at this point, it will be applied to + // all kinds of values and produce an incorrect error whenever those values + // are hashes or arrays (including arrays of tables). + + k := rv.Kind() + + // laziness + if k >= reflect.Int && k <= reflect.Uint64 { + return md.unifyInt(data, rv) + } + switch k { + case reflect.Ptr: + elem := reflect.New(rv.Type().Elem()) + err := md.unify(data, reflect.Indirect(elem)) + if err != nil { + return err + } + rv.Set(elem) + return nil + case reflect.Struct: + return md.unifyStruct(data, rv) + case reflect.Map: + return md.unifyMap(data, rv) + case reflect.Array: + return md.unifyArray(data, rv) + case reflect.Slice: + return md.unifySlice(data, rv) + case reflect.String: + return md.unifyString(data, rv) + case reflect.Bool: + return md.unifyBool(data, rv) + case reflect.Interface: + // we only support empty interfaces. + if rv.NumMethod() > 0 { + return e("Unsupported type '%s'.", rv.Kind()) + } + return md.unifyAnything(data, rv) + case reflect.Float32: + fallthrough + case reflect.Float64: + return md.unifyFloat64(data, rv) + } + return e("Unsupported type '%s'.", rv.Kind()) +} + +func (md *MetaData) unifyStruct(mapping interface{}, rv reflect.Value) error { + tmap, ok := mapping.(map[string]interface{}) + if !ok { + return mismatch(rv, "map", mapping) + } + + for key, datum := range tmap { + var f *field + fields := cachedTypeFields(rv.Type()) + for i := range fields { + ff := &fields[i] + if ff.name == key { + f = ff + break + } + if f == nil && strings.EqualFold(ff.name, key) { + f = ff + } + } + if f != nil { + subv := rv + for _, i := range f.index { + subv = indirect(subv.Field(i)) + } + if isUnifiable(subv) { + md.decoded[md.context.add(key).String()] = true + md.context = append(md.context, key) + if err := md.unify(datum, subv); err != nil { + return e("Type mismatch for '%s.%s': %s", + rv.Type().String(), f.name, err) + } + md.context = md.context[0 : len(md.context)-1] + } else if f.name != "" { + // Bad user! No soup for you! + return e("Field '%s.%s' is unexported, and therefore cannot "+ + "be loaded with reflection.", rv.Type().String(), f.name) + } + } + } + return nil +} + +func (md *MetaData) unifyMap(mapping interface{}, rv reflect.Value) error { + tmap, ok := mapping.(map[string]interface{}) + if !ok { + return badtype("map", mapping) + } + if rv.IsNil() { + rv.Set(reflect.MakeMap(rv.Type())) + } + for k, v := range tmap { + md.decoded[md.context.add(k).String()] = true + md.context = append(md.context, k) + + rvkey := indirect(reflect.New(rv.Type().Key())) + rvval := reflect.Indirect(reflect.New(rv.Type().Elem())) + if err := md.unify(v, rvval); err != nil { + return err + } + md.context = md.context[0 : len(md.context)-1] + + rvkey.SetString(k) + rv.SetMapIndex(rvkey, rvval) + } + return nil +} + +func (md *MetaData) unifyArray(data interface{}, rv reflect.Value) error { + datav := reflect.ValueOf(data) + if datav.Kind() != reflect.Slice { + return badtype("slice", data) + } + sliceLen := datav.Len() + if sliceLen != rv.Len() { + return e("expected array length %d; got TOML array of length %d", + rv.Len(), sliceLen) + } + return md.unifySliceArray(datav, rv) +} + +func (md *MetaData) unifySlice(data interface{}, rv reflect.Value) error { + datav := reflect.ValueOf(data) + if datav.Kind() != reflect.Slice { + return badtype("slice", data) + } + sliceLen := datav.Len() + if rv.IsNil() { + rv.Set(reflect.MakeSlice(rv.Type(), sliceLen, sliceLen)) + } + return md.unifySliceArray(datav, rv) +} + +func (md *MetaData) unifySliceArray(data, rv reflect.Value) error { + sliceLen := data.Len() + for i := 0; i < sliceLen; i++ { + v := data.Index(i).Interface() + sliceval := indirect(rv.Index(i)) + if err := md.unify(v, sliceval); err != nil { + return err + } + } + return nil +} + +func (md *MetaData) unifyDatetime(data interface{}, rv reflect.Value) error { + if _, ok := data.(time.Time); ok { + rv.Set(reflect.ValueOf(data)) + return nil + } + return badtype("time.Time", data) +} + +func (md *MetaData) unifyString(data interface{}, rv reflect.Value) error { + if s, ok := data.(string); ok { + rv.SetString(s) + return nil + } + return badtype("string", data) +} + +func (md *MetaData) unifyFloat64(data interface{}, rv reflect.Value) error { + if num, ok := data.(float64); ok { + switch rv.Kind() { + case reflect.Float32: + fallthrough + case reflect.Float64: + rv.SetFloat(num) + default: + panic("bug") + } + return nil + } + return badtype("float", data) +} + +func (md *MetaData) unifyInt(data interface{}, rv reflect.Value) error { + if num, ok := data.(int64); ok { + if rv.Kind() >= reflect.Int && rv.Kind() <= reflect.Int64 { + switch rv.Kind() { + case reflect.Int, reflect.Int64: + // No bounds checking necessary. + case reflect.Int8: + if num < math.MinInt8 || num > math.MaxInt8 { + return e("Value '%d' is out of range for int8.", num) + } + case reflect.Int16: + if num < math.MinInt16 || num > math.MaxInt16 { + return e("Value '%d' is out of range for int16.", num) + } + case reflect.Int32: + if num < math.MinInt32 || num > math.MaxInt32 { + return e("Value '%d' is out of range for int32.", num) + } + } + rv.SetInt(num) + } else if rv.Kind() >= reflect.Uint && rv.Kind() <= reflect.Uint64 { + unum := uint64(num) + switch rv.Kind() { + case reflect.Uint, reflect.Uint64: + // No bounds checking necessary. + case reflect.Uint8: + if num < 0 || unum > math.MaxUint8 { + return e("Value '%d' is out of range for uint8.", num) + } + case reflect.Uint16: + if num < 0 || unum > math.MaxUint16 { + return e("Value '%d' is out of range for uint16.", num) + } + case reflect.Uint32: + if num < 0 || unum > math.MaxUint32 { + return e("Value '%d' is out of range for uint32.", num) + } + } + rv.SetUint(unum) + } else { + panic("unreachable") + } + return nil + } + return badtype("integer", data) +} + +func (md *MetaData) unifyBool(data interface{}, rv reflect.Value) error { + if b, ok := data.(bool); ok { + rv.SetBool(b) + return nil + } + return badtype("boolean", data) +} + +func (md *MetaData) unifyAnything(data interface{}, rv reflect.Value) error { + rv.Set(reflect.ValueOf(data)) + return nil +} + +func (md *MetaData) unifyText(data interface{}, v TextUnmarshaler) error { + var s string + switch sdata := data.(type) { + case TextMarshaler: + text, err := sdata.MarshalText() + if err != nil { + return err + } + s = string(text) + case fmt.Stringer: + s = sdata.String() + case string: + s = sdata + case bool: + s = fmt.Sprintf("%v", sdata) + case int64: + s = fmt.Sprintf("%d", sdata) + case float64: + s = fmt.Sprintf("%f", sdata) + default: + return badtype("primitive (string-like)", data) + } + if err := v.UnmarshalText([]byte(s)); err != nil { + return err + } + return nil +} + +// rvalue returns a reflect.Value of `v`. All pointers are resolved. +func rvalue(v interface{}) reflect.Value { + return indirect(reflect.ValueOf(v)) +} + +// indirect returns the value pointed to by a pointer. +// Pointers are followed until the value is not a pointer. +// New values are allocated for each nil pointer. +// +// An exception to this rule is if the value satisfies an interface of +// interest to us (like encoding.TextUnmarshaler). +func indirect(v reflect.Value) reflect.Value { + if v.Kind() != reflect.Ptr { + if v.CanAddr() { + pv := v.Addr() + if _, ok := pv.Interface().(TextUnmarshaler); ok { + return pv + } + } + return v + } + if v.IsNil() { + v.Set(reflect.New(v.Type().Elem())) + } + return indirect(reflect.Indirect(v)) +} + +func isUnifiable(rv reflect.Value) bool { + if rv.CanSet() { + return true + } + if _, ok := rv.Interface().(TextUnmarshaler); ok { + return true + } + return false +} + +func badtype(expected string, data interface{}) error { + return e("Expected %s but found '%T'.", expected, data) +} + +func mismatch(user reflect.Value, expected string, data interface{}) error { + return e("Type mismatch for %s. Expected %s but found '%T'.", + user.Type().String(), expected, data) +} diff --git a/vendor/src/github.com/BurntSushi/toml/decode_meta.go b/vendor/src/github.com/BurntSushi/toml/decode_meta.go new file mode 100644 index 0000000000..ef6f545fa1 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/decode_meta.go @@ -0,0 +1,122 @@ +package toml + +import "strings" + +// MetaData allows access to meta information about TOML data that may not +// be inferrable via reflection. In particular, whether a key has been defined +// and the TOML type of a key. +type MetaData struct { + mapping map[string]interface{} + types map[string]tomlType + keys []Key + decoded map[string]bool + context Key // Used only during decoding. +} + +// IsDefined returns true if the key given exists in the TOML data. The key +// should be specified hierarchially. e.g., +// +// // access the TOML key 'a.b.c' +// IsDefined("a", "b", "c") +// +// IsDefined will return false if an empty key given. Keys are case sensitive. +func (md *MetaData) IsDefined(key ...string) bool { + if len(key) == 0 { + return false + } + + var hash map[string]interface{} + var ok bool + var hashOrVal interface{} = md.mapping + for _, k := range key { + if hash, ok = hashOrVal.(map[string]interface{}); !ok { + return false + } + if hashOrVal, ok = hash[k]; !ok { + return false + } + } + return true +} + +// Type returns a string representation of the type of the key specified. +// +// Type will return the empty string if given an empty key or a key that +// does not exist. Keys are case sensitive. +func (md *MetaData) Type(key ...string) string { + fullkey := strings.Join(key, ".") + if typ, ok := md.types[fullkey]; ok { + return typ.typeString() + } + return "" +} + +// Key is the type of any TOML key, including key groups. Use (MetaData).Keys +// to get values of this type. +type Key []string + +func (k Key) String() string { + return strings.Join(k, ".") +} + +func (k Key) maybeQuotedAll() string { + var ss []string + for i := range k { + ss = append(ss, k.maybeQuoted(i)) + } + return strings.Join(ss, ".") +} + +func (k Key) maybeQuoted(i int) string { + quote := false + for _, c := range k[i] { + if !isBareKeyChar(c) { + quote = true + break + } + } + if quote { + return "\"" + strings.Replace(k[i], "\"", "\\\"", -1) + "\"" + } else { + return k[i] + } +} + +func (k Key) add(piece string) Key { + newKey := make(Key, len(k)+1) + copy(newKey, k) + newKey[len(k)] = piece + return newKey +} + +// Keys returns a slice of every key in the TOML data, including key groups. +// Each key is itself a slice, where the first element is the top of the +// hierarchy and the last is the most specific. +// +// The list will have the same order as the keys appeared in the TOML data. +// +// All keys returned are non-empty. +func (md *MetaData) Keys() []Key { + return md.keys +} + +// Undecoded returns all keys that have not been decoded in the order in which +// they appear in the original TOML document. +// +// This includes keys that haven't been decoded because of a Primitive value. +// Once the Primitive value is decoded, the keys will be considered decoded. +// +// Also note that decoding into an empty interface will result in no decoding, +// and so no keys will be considered decoded. +// +// In this sense, the Undecoded keys correspond to keys in the TOML document +// that do not have a concrete type in your representation. +func (md *MetaData) Undecoded() []Key { + undecoded := make([]Key, 0, len(md.keys)) + for _, key := range md.keys { + if !md.decoded[key.String()] { + undecoded = append(undecoded, key) + } + } + return undecoded +} diff --git a/vendor/src/github.com/BurntSushi/toml/doc.go b/vendor/src/github.com/BurntSushi/toml/doc.go new file mode 100644 index 0000000000..fe26800041 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/doc.go @@ -0,0 +1,27 @@ +/* +Package toml provides facilities for decoding and encoding TOML configuration +files via reflection. There is also support for delaying decoding with +the Primitive type, and querying the set of keys in a TOML document with the +MetaData type. + +The specification implemented: https://github.com/mojombo/toml + +The sub-command github.com/BurntSushi/toml/cmd/tomlv can be used to verify +whether a file is a valid TOML document. It can also be used to print the +type of each key in a TOML document. + +Testing + +There are two important types of tests used for this package. The first is +contained inside '*_test.go' files and uses the standard Go unit testing +framework. These tests are primarily devoted to holistically testing the +decoder and encoder. + +The second type of testing is used to verify the implementation's adherence +to the TOML specification. These tests have been factored into their own +project: https://github.com/BurntSushi/toml-test + +The reason the tests are in a separate project is so that they can be used by +any implementation of TOML. Namely, it is language agnostic. +*/ +package toml diff --git a/vendor/src/github.com/BurntSushi/toml/encode.go b/vendor/src/github.com/BurntSushi/toml/encode.go new file mode 100644 index 0000000000..64e8c47e13 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/encode.go @@ -0,0 +1,496 @@ +package toml + +import ( + "bufio" + "errors" + "fmt" + "io" + "reflect" + "sort" + "strconv" + "strings" + "time" +) + +type tomlEncodeError struct{ error } + +var ( + errArrayMixedElementTypes = errors.New( + "can't encode array with mixed element types") + errArrayNilElement = errors.New( + "can't encode array with nil element") + errNonString = errors.New( + "can't encode a map with non-string key type") + errAnonNonStruct = errors.New( + "can't encode an anonymous field that is not a struct") + errArrayNoTable = errors.New( + "TOML array element can't contain a table") + errNoKey = errors.New( + "top-level values must be a Go map or struct") + errAnything = errors.New("") // used in testing +) + +var quotedReplacer = strings.NewReplacer( + "\t", "\\t", + "\n", "\\n", + "\r", "\\r", + "\"", "\\\"", + "\\", "\\\\", +) + +// Encoder controls the encoding of Go values to a TOML document to some +// io.Writer. +// +// The indentation level can be controlled with the Indent field. +type Encoder struct { + // A single indentation level. By default it is two spaces. + Indent string + + // hasWritten is whether we have written any output to w yet. + hasWritten bool + w *bufio.Writer +} + +// NewEncoder returns a TOML encoder that encodes Go values to the io.Writer +// given. By default, a single indentation level is 2 spaces. +func NewEncoder(w io.Writer) *Encoder { + return &Encoder{ + w: bufio.NewWriter(w), + Indent: " ", + } +} + +// Encode writes a TOML representation of the Go value to the underlying +// io.Writer. If the value given cannot be encoded to a valid TOML document, +// then an error is returned. +// +// The mapping between Go values and TOML values should be precisely the same +// as for the Decode* functions. Similarly, the TextMarshaler interface is +// supported by encoding the resulting bytes as strings. (If you want to write +// arbitrary binary data then you will need to use something like base64 since +// TOML does not have any binary types.) +// +// When encoding TOML hashes (i.e., Go maps or structs), keys without any +// sub-hashes are encoded first. +// +// If a Go map is encoded, then its keys are sorted alphabetically for +// deterministic output. More control over this behavior may be provided if +// there is demand for it. +// +// Encoding Go values without a corresponding TOML representation---like map +// types with non-string keys---will cause an error to be returned. Similarly +// for mixed arrays/slices, arrays/slices with nil elements, embedded +// non-struct types and nested slices containing maps or structs. +// (e.g., [][]map[string]string is not allowed but []map[string]string is OK +// and so is []map[string][]string.) +func (enc *Encoder) Encode(v interface{}) error { + rv := eindirect(reflect.ValueOf(v)) + if err := enc.safeEncode(Key([]string{}), rv); err != nil { + return err + } + return enc.w.Flush() +} + +func (enc *Encoder) safeEncode(key Key, rv reflect.Value) (err error) { + defer func() { + if r := recover(); r != nil { + if terr, ok := r.(tomlEncodeError); ok { + err = terr.error + return + } + panic(r) + } + }() + enc.encode(key, rv) + return nil +} + +func (enc *Encoder) encode(key Key, rv reflect.Value) { + // Special case. Time needs to be in ISO8601 format. + // Special case. If we can marshal the type to text, then we used that. + // Basically, this prevents the encoder for handling these types as + // generic structs (or whatever the underlying type of a TextMarshaler is). + switch rv.Interface().(type) { + case time.Time, TextMarshaler: + enc.keyEqElement(key, rv) + return + } + + k := rv.Kind() + switch k { + case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, + reflect.Int64, + reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, + reflect.Uint64, + reflect.Float32, reflect.Float64, reflect.String, reflect.Bool: + enc.keyEqElement(key, rv) + case reflect.Array, reflect.Slice: + if typeEqual(tomlArrayHash, tomlTypeOfGo(rv)) { + enc.eArrayOfTables(key, rv) + } else { + enc.keyEqElement(key, rv) + } + case reflect.Interface: + if rv.IsNil() { + return + } + enc.encode(key, rv.Elem()) + case reflect.Map: + if rv.IsNil() { + return + } + enc.eTable(key, rv) + case reflect.Ptr: + if rv.IsNil() { + return + } + enc.encode(key, rv.Elem()) + case reflect.Struct: + enc.eTable(key, rv) + default: + panic(e("Unsupported type for key '%s': %s", key, k)) + } +} + +// eElement encodes any value that can be an array element (primitives and +// arrays). +func (enc *Encoder) eElement(rv reflect.Value) { + switch v := rv.Interface().(type) { + case time.Time: + // Special case time.Time as a primitive. Has to come before + // TextMarshaler below because time.Time implements + // encoding.TextMarshaler, but we need to always use UTC. + enc.wf(v.In(time.FixedZone("UTC", 0)).Format("2006-01-02T15:04:05Z")) + return + case TextMarshaler: + // Special case. Use text marshaler if it's available for this value. + if s, err := v.MarshalText(); err != nil { + encPanic(err) + } else { + enc.writeQuoted(string(s)) + } + return + } + switch rv.Kind() { + case reflect.Bool: + enc.wf(strconv.FormatBool(rv.Bool())) + case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, + reflect.Int64: + enc.wf(strconv.FormatInt(rv.Int(), 10)) + case reflect.Uint, reflect.Uint8, reflect.Uint16, + reflect.Uint32, reflect.Uint64: + enc.wf(strconv.FormatUint(rv.Uint(), 10)) + case reflect.Float32: + enc.wf(floatAddDecimal(strconv.FormatFloat(rv.Float(), 'f', -1, 32))) + case reflect.Float64: + enc.wf(floatAddDecimal(strconv.FormatFloat(rv.Float(), 'f', -1, 64))) + case reflect.Array, reflect.Slice: + enc.eArrayOrSliceElement(rv) + case reflect.Interface: + enc.eElement(rv.Elem()) + case reflect.String: + enc.writeQuoted(rv.String()) + default: + panic(e("Unexpected primitive type: %s", rv.Kind())) + } +} + +// By the TOML spec, all floats must have a decimal with at least one +// number on either side. +func floatAddDecimal(fstr string) string { + if !strings.Contains(fstr, ".") { + return fstr + ".0" + } + return fstr +} + +func (enc *Encoder) writeQuoted(s string) { + enc.wf("\"%s\"", quotedReplacer.Replace(s)) +} + +func (enc *Encoder) eArrayOrSliceElement(rv reflect.Value) { + length := rv.Len() + enc.wf("[") + for i := 0; i < length; i++ { + elem := rv.Index(i) + enc.eElement(elem) + if i != length-1 { + enc.wf(", ") + } + } + enc.wf("]") +} + +func (enc *Encoder) eArrayOfTables(key Key, rv reflect.Value) { + if len(key) == 0 { + encPanic(errNoKey) + } + for i := 0; i < rv.Len(); i++ { + trv := rv.Index(i) + if isNil(trv) { + continue + } + panicIfInvalidKey(key) + enc.newline() + enc.wf("%s[[%s]]", enc.indentStr(key), key.maybeQuotedAll()) + enc.newline() + enc.eMapOrStruct(key, trv) + } +} + +func (enc *Encoder) eTable(key Key, rv reflect.Value) { + panicIfInvalidKey(key) + if len(key) == 1 { + // Output an extra new line between top-level tables. + // (The newline isn't written if nothing else has been written though.) + enc.newline() + } + if len(key) > 0 { + enc.wf("%s[%s]", enc.indentStr(key), key.maybeQuotedAll()) + enc.newline() + } + enc.eMapOrStruct(key, rv) +} + +func (enc *Encoder) eMapOrStruct(key Key, rv reflect.Value) { + switch rv := eindirect(rv); rv.Kind() { + case reflect.Map: + enc.eMap(key, rv) + case reflect.Struct: + enc.eStruct(key, rv) + default: + panic("eTable: unhandled reflect.Value Kind: " + rv.Kind().String()) + } +} + +func (enc *Encoder) eMap(key Key, rv reflect.Value) { + rt := rv.Type() + if rt.Key().Kind() != reflect.String { + encPanic(errNonString) + } + + // Sort keys so that we have deterministic output. And write keys directly + // underneath this key first, before writing sub-structs or sub-maps. + var mapKeysDirect, mapKeysSub []string + for _, mapKey := range rv.MapKeys() { + k := mapKey.String() + if typeIsHash(tomlTypeOfGo(rv.MapIndex(mapKey))) { + mapKeysSub = append(mapKeysSub, k) + } else { + mapKeysDirect = append(mapKeysDirect, k) + } + } + + var writeMapKeys = func(mapKeys []string) { + sort.Strings(mapKeys) + for _, mapKey := range mapKeys { + mrv := rv.MapIndex(reflect.ValueOf(mapKey)) + if isNil(mrv) { + // Don't write anything for nil fields. + continue + } + enc.encode(key.add(mapKey), mrv) + } + } + writeMapKeys(mapKeysDirect) + writeMapKeys(mapKeysSub) +} + +func (enc *Encoder) eStruct(key Key, rv reflect.Value) { + // Write keys for fields directly under this key first, because if we write + // a field that creates a new table, then all keys under it will be in that + // table (not the one we're writing here). + rt := rv.Type() + var fieldsDirect, fieldsSub [][]int + var addFields func(rt reflect.Type, rv reflect.Value, start []int) + addFields = func(rt reflect.Type, rv reflect.Value, start []int) { + for i := 0; i < rt.NumField(); i++ { + f := rt.Field(i) + // skip unexporded fields + if f.PkgPath != "" { + continue + } + frv := rv.Field(i) + if f.Anonymous { + frv := eindirect(frv) + t := frv.Type() + if t.Kind() != reflect.Struct { + encPanic(errAnonNonStruct) + } + addFields(t, frv, f.Index) + } else if typeIsHash(tomlTypeOfGo(frv)) { + fieldsSub = append(fieldsSub, append(start, f.Index...)) + } else { + fieldsDirect = append(fieldsDirect, append(start, f.Index...)) + } + } + } + addFields(rt, rv, nil) + + var writeFields = func(fields [][]int) { + for _, fieldIndex := range fields { + sft := rt.FieldByIndex(fieldIndex) + sf := rv.FieldByIndex(fieldIndex) + if isNil(sf) { + // Don't write anything for nil fields. + continue + } + + keyName := sft.Tag.Get("toml") + if keyName == "-" { + continue + } + if keyName == "" { + keyName = sft.Name + } + enc.encode(key.add(keyName), sf) + } + } + writeFields(fieldsDirect) + writeFields(fieldsSub) +} + +// tomlTypeName returns the TOML type name of the Go value's type. It is +// used to determine whether the types of array elements are mixed (which is +// forbidden). If the Go value is nil, then it is illegal for it to be an array +// element, and valueIsNil is returned as true. + +// Returns the TOML type of a Go value. The type may be `nil`, which means +// no concrete TOML type could be found. +func tomlTypeOfGo(rv reflect.Value) tomlType { + if isNil(rv) || !rv.IsValid() { + return nil + } + switch rv.Kind() { + case reflect.Bool: + return tomlBool + case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, + reflect.Int64, + reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, + reflect.Uint64: + return tomlInteger + case reflect.Float32, reflect.Float64: + return tomlFloat + case reflect.Array, reflect.Slice: + if typeEqual(tomlHash, tomlArrayType(rv)) { + return tomlArrayHash + } else { + return tomlArray + } + case reflect.Ptr, reflect.Interface: + return tomlTypeOfGo(rv.Elem()) + case reflect.String: + return tomlString + case reflect.Map: + return tomlHash + case reflect.Struct: + switch rv.Interface().(type) { + case time.Time: + return tomlDatetime + case TextMarshaler: + return tomlString + default: + return tomlHash + } + default: + panic("unexpected reflect.Kind: " + rv.Kind().String()) + } +} + +// tomlArrayType returns the element type of a TOML array. The type returned +// may be nil if it cannot be determined (e.g., a nil slice or a zero length +// slize). This function may also panic if it finds a type that cannot be +// expressed in TOML (such as nil elements, heterogeneous arrays or directly +// nested arrays of tables). +func tomlArrayType(rv reflect.Value) tomlType { + if isNil(rv) || !rv.IsValid() || rv.Len() == 0 { + return nil + } + firstType := tomlTypeOfGo(rv.Index(0)) + if firstType == nil { + encPanic(errArrayNilElement) + } + + rvlen := rv.Len() + for i := 1; i < rvlen; i++ { + elem := rv.Index(i) + switch elemType := tomlTypeOfGo(elem); { + case elemType == nil: + encPanic(errArrayNilElement) + case !typeEqual(firstType, elemType): + encPanic(errArrayMixedElementTypes) + } + } + // If we have a nested array, then we must make sure that the nested + // array contains ONLY primitives. + // This checks arbitrarily nested arrays. + if typeEqual(firstType, tomlArray) || typeEqual(firstType, tomlArrayHash) { + nest := tomlArrayType(eindirect(rv.Index(0))) + if typeEqual(nest, tomlHash) || typeEqual(nest, tomlArrayHash) { + encPanic(errArrayNoTable) + } + } + return firstType +} + +func (enc *Encoder) newline() { + if enc.hasWritten { + enc.wf("\n") + } +} + +func (enc *Encoder) keyEqElement(key Key, val reflect.Value) { + if len(key) == 0 { + encPanic(errNoKey) + } + panicIfInvalidKey(key) + enc.wf("%s%s = ", enc.indentStr(key), key.maybeQuoted(len(key)-1)) + enc.eElement(val) + enc.newline() +} + +func (enc *Encoder) wf(format string, v ...interface{}) { + if _, err := fmt.Fprintf(enc.w, format, v...); err != nil { + encPanic(err) + } + enc.hasWritten = true +} + +func (enc *Encoder) indentStr(key Key) string { + return strings.Repeat(enc.Indent, len(key)-1) +} + +func encPanic(err error) { + panic(tomlEncodeError{err}) +} + +func eindirect(v reflect.Value) reflect.Value { + switch v.Kind() { + case reflect.Ptr, reflect.Interface: + return eindirect(v.Elem()) + default: + return v + } +} + +func isNil(rv reflect.Value) bool { + switch rv.Kind() { + case reflect.Interface, reflect.Map, reflect.Ptr, reflect.Slice: + return rv.IsNil() + default: + return false + } +} + +func panicIfInvalidKey(key Key) { + for _, k := range key { + if len(k) == 0 { + encPanic(e("Key '%s' is not a valid table name. Key names "+ + "cannot be empty.", key.maybeQuotedAll())) + } + } +} + +func isValidKeyName(s string) bool { + return len(s) != 0 +} diff --git a/vendor/src/github.com/BurntSushi/toml/encoding_types.go b/vendor/src/github.com/BurntSushi/toml/encoding_types.go new file mode 100644 index 0000000000..d36e1dd600 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/encoding_types.go @@ -0,0 +1,19 @@ +// +build go1.2 + +package toml + +// In order to support Go 1.1, we define our own TextMarshaler and +// TextUnmarshaler types. For Go 1.2+, we just alias them with the +// standard library interfaces. + +import ( + "encoding" +) + +// TextMarshaler is a synonym for encoding.TextMarshaler. It is defined here +// so that Go 1.1 can be supported. +type TextMarshaler encoding.TextMarshaler + +// TextUnmarshaler is a synonym for encoding.TextUnmarshaler. It is defined +// here so that Go 1.1 can be supported. +type TextUnmarshaler encoding.TextUnmarshaler diff --git a/vendor/src/github.com/BurntSushi/toml/encoding_types_1.1.go b/vendor/src/github.com/BurntSushi/toml/encoding_types_1.1.go new file mode 100644 index 0000000000..e8d503d046 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/encoding_types_1.1.go @@ -0,0 +1,18 @@ +// +build !go1.2 + +package toml + +// These interfaces were introduced in Go 1.2, so we add them manually when +// compiling for Go 1.1. + +// TextMarshaler is a synonym for encoding.TextMarshaler. It is defined here +// so that Go 1.1 can be supported. +type TextMarshaler interface { + MarshalText() (text []byte, err error) +} + +// TextUnmarshaler is a synonym for encoding.TextUnmarshaler. It is defined +// here so that Go 1.1 can be supported. +type TextUnmarshaler interface { + UnmarshalText(text []byte) error +} diff --git a/vendor/src/github.com/BurntSushi/toml/lex.go b/vendor/src/github.com/BurntSushi/toml/lex.go new file mode 100644 index 0000000000..219122857e --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/lex.go @@ -0,0 +1,874 @@ +package toml + +import ( + "fmt" + "strings" + "unicode/utf8" +) + +type itemType int + +const ( + itemError itemType = iota + itemNIL // used in the parser to indicate no type + itemEOF + itemText + itemString + itemRawString + itemMultilineString + itemRawMultilineString + itemBool + itemInteger + itemFloat + itemDatetime + itemArray // the start of an array + itemArrayEnd + itemTableStart + itemTableEnd + itemArrayTableStart + itemArrayTableEnd + itemKeyStart + itemCommentStart +) + +const ( + eof = 0 + tableStart = '[' + tableEnd = ']' + arrayTableStart = '[' + arrayTableEnd = ']' + tableSep = '.' + keySep = '=' + arrayStart = '[' + arrayEnd = ']' + arrayValTerm = ',' + commentStart = '#' + stringStart = '"' + stringEnd = '"' + rawStringStart = '\'' + rawStringEnd = '\'' +) + +type stateFn func(lx *lexer) stateFn + +type lexer struct { + input string + start int + pos int + width int + line int + state stateFn + items chan item + + // A stack of state functions used to maintain context. + // The idea is to reuse parts of the state machine in various places. + // For example, values can appear at the top level or within arbitrarily + // nested arrays. The last state on the stack is used after a value has + // been lexed. Similarly for comments. + stack []stateFn +} + +type item struct { + typ itemType + val string + line int +} + +func (lx *lexer) nextItem() item { + for { + select { + case item := <-lx.items: + return item + default: + lx.state = lx.state(lx) + } + } +} + +func lex(input string) *lexer { + lx := &lexer{ + input: input + "\n", + state: lexTop, + line: 1, + items: make(chan item, 10), + stack: make([]stateFn, 0, 10), + } + return lx +} + +func (lx *lexer) push(state stateFn) { + lx.stack = append(lx.stack, state) +} + +func (lx *lexer) pop() stateFn { + if len(lx.stack) == 0 { + return lx.errorf("BUG in lexer: no states to pop.") + } + last := lx.stack[len(lx.stack)-1] + lx.stack = lx.stack[0 : len(lx.stack)-1] + return last +} + +func (lx *lexer) current() string { + return lx.input[lx.start:lx.pos] +} + +func (lx *lexer) emit(typ itemType) { + lx.items <- item{typ, lx.current(), lx.line} + lx.start = lx.pos +} + +func (lx *lexer) emitTrim(typ itemType) { + lx.items <- item{typ, strings.TrimSpace(lx.current()), lx.line} + lx.start = lx.pos +} + +func (lx *lexer) next() (r rune) { + if lx.pos >= len(lx.input) { + lx.width = 0 + return eof + } + + if lx.input[lx.pos] == '\n' { + lx.line++ + } + r, lx.width = utf8.DecodeRuneInString(lx.input[lx.pos:]) + lx.pos += lx.width + return r +} + +// ignore skips over the pending input before this point. +func (lx *lexer) ignore() { + lx.start = lx.pos +} + +// backup steps back one rune. Can be called only once per call of next. +func (lx *lexer) backup() { + lx.pos -= lx.width + if lx.pos < len(lx.input) && lx.input[lx.pos] == '\n' { + lx.line-- + } +} + +// accept consumes the next rune if it's equal to `valid`. +func (lx *lexer) accept(valid rune) bool { + if lx.next() == valid { + return true + } + lx.backup() + return false +} + +// peek returns but does not consume the next rune in the input. +func (lx *lexer) peek() rune { + r := lx.next() + lx.backup() + return r +} + +// errorf stops all lexing by emitting an error and returning `nil`. +// Note that any value that is a character is escaped if it's a special +// character (new lines, tabs, etc.). +func (lx *lexer) errorf(format string, values ...interface{}) stateFn { + lx.items <- item{ + itemError, + fmt.Sprintf(format, values...), + lx.line, + } + return nil +} + +// lexTop consumes elements at the top level of TOML data. +func lexTop(lx *lexer) stateFn { + r := lx.next() + if isWhitespace(r) || isNL(r) { + return lexSkip(lx, lexTop) + } + + switch r { + case commentStart: + lx.push(lexTop) + return lexCommentStart + case tableStart: + return lexTableStart + case eof: + if lx.pos > lx.start { + return lx.errorf("Unexpected EOF.") + } + lx.emit(itemEOF) + return nil + } + + // At this point, the only valid item can be a key, so we back up + // and let the key lexer do the rest. + lx.backup() + lx.push(lexTopEnd) + return lexKeyStart +} + +// lexTopEnd is entered whenever a top-level item has been consumed. (A value +// or a table.) It must see only whitespace, and will turn back to lexTop +// upon a new line. If it sees EOF, it will quit the lexer successfully. +func lexTopEnd(lx *lexer) stateFn { + r := lx.next() + switch { + case r == commentStart: + // a comment will read to a new line for us. + lx.push(lexTop) + return lexCommentStart + case isWhitespace(r): + return lexTopEnd + case isNL(r): + lx.ignore() + return lexTop + case r == eof: + lx.ignore() + return lexTop + } + return lx.errorf("Expected a top-level item to end with a new line, "+ + "comment or EOF, but got %q instead.", r) +} + +// lexTable lexes the beginning of a table. Namely, it makes sure that +// it starts with a character other than '.' and ']'. +// It assumes that '[' has already been consumed. +// It also handles the case that this is an item in an array of tables. +// e.g., '[[name]]'. +func lexTableStart(lx *lexer) stateFn { + if lx.peek() == arrayTableStart { + lx.next() + lx.emit(itemArrayTableStart) + lx.push(lexArrayTableEnd) + } else { + lx.emit(itemTableStart) + lx.push(lexTableEnd) + } + return lexTableNameStart +} + +func lexTableEnd(lx *lexer) stateFn { + lx.emit(itemTableEnd) + return lexTopEnd +} + +func lexArrayTableEnd(lx *lexer) stateFn { + if r := lx.next(); r != arrayTableEnd { + return lx.errorf("Expected end of table array name delimiter %q, "+ + "but got %q instead.", arrayTableEnd, r) + } + lx.emit(itemArrayTableEnd) + return lexTopEnd +} + +func lexTableNameStart(lx *lexer) stateFn { + switch r := lx.peek(); { + case r == tableEnd || r == eof: + return lx.errorf("Unexpected end of table name. (Table names cannot " + + "be empty.)") + case r == tableSep: + return lx.errorf("Unexpected table separator. (Table names cannot " + + "be empty.)") + case r == stringStart || r == rawStringStart: + lx.ignore() + lx.push(lexTableNameEnd) + return lexValue // reuse string lexing + case isWhitespace(r): + return lexTableNameStart + default: + return lexBareTableName + } +} + +// lexTableName lexes the name of a table. It assumes that at least one +// valid character for the table has already been read. +func lexBareTableName(lx *lexer) stateFn { + switch r := lx.next(); { + case isBareKeyChar(r): + return lexBareTableName + case r == tableSep || r == tableEnd: + lx.backup() + lx.emitTrim(itemText) + return lexTableNameEnd + default: + return lx.errorf("Bare keys cannot contain %q.", r) + } +} + +// lexTableNameEnd reads the end of a piece of a table name, optionally +// consuming whitespace. +func lexTableNameEnd(lx *lexer) stateFn { + switch r := lx.next(); { + case isWhitespace(r): + return lexTableNameEnd + case r == tableSep: + lx.ignore() + return lexTableNameStart + case r == tableEnd: + return lx.pop() + default: + return lx.errorf("Expected '.' or ']' to end table name, but got %q "+ + "instead.", r) + } +} + +// lexKeyStart consumes a key name up until the first non-whitespace character. +// lexKeyStart will ignore whitespace. +func lexKeyStart(lx *lexer) stateFn { + r := lx.peek() + switch { + case r == keySep: + return lx.errorf("Unexpected key separator %q.", keySep) + case isWhitespace(r) || isNL(r): + lx.next() + return lexSkip(lx, lexKeyStart) + case r == stringStart || r == rawStringStart: + lx.ignore() + lx.emit(itemKeyStart) + lx.push(lexKeyEnd) + return lexValue // reuse string lexing + default: + lx.ignore() + lx.emit(itemKeyStart) + return lexBareKey + } +} + +// lexBareKey consumes the text of a bare key. Assumes that the first character +// (which is not whitespace) has not yet been consumed. +func lexBareKey(lx *lexer) stateFn { + switch r := lx.next(); { + case isBareKeyChar(r): + return lexBareKey + case isWhitespace(r): + lx.emitTrim(itemText) + return lexKeyEnd + case r == keySep: + lx.backup() + lx.emitTrim(itemText) + return lexKeyEnd + default: + return lx.errorf("Bare keys cannot contain %q.", r) + } +} + +// lexKeyEnd consumes the end of a key and trims whitespace (up to the key +// separator). +func lexKeyEnd(lx *lexer) stateFn { + switch r := lx.next(); { + case r == keySep: + return lexSkip(lx, lexValue) + case isWhitespace(r): + return lexSkip(lx, lexKeyEnd) + default: + return lx.errorf("Expected key separator %q, but got %q instead.", + keySep, r) + } +} + +// lexValue starts the consumption of a value anywhere a value is expected. +// lexValue will ignore whitespace. +// After a value is lexed, the last state on the next is popped and returned. +func lexValue(lx *lexer) stateFn { + // We allow whitespace to precede a value, but NOT new lines. + // In array syntax, the array states are responsible for ignoring new + // lines. + r := lx.next() + if isWhitespace(r) { + return lexSkip(lx, lexValue) + } + + switch { + case r == arrayStart: + lx.ignore() + lx.emit(itemArray) + return lexArrayValue + case r == stringStart: + if lx.accept(stringStart) { + if lx.accept(stringStart) { + lx.ignore() // Ignore """ + return lexMultilineString + } + lx.backup() + } + lx.ignore() // ignore the '"' + return lexString + case r == rawStringStart: + if lx.accept(rawStringStart) { + if lx.accept(rawStringStart) { + lx.ignore() // Ignore """ + return lexMultilineRawString + } + lx.backup() + } + lx.ignore() // ignore the "'" + return lexRawString + case r == 't': + return lexTrue + case r == 'f': + return lexFalse + case r == '-': + return lexNumberStart + case isDigit(r): + lx.backup() // avoid an extra state and use the same as above + return lexNumberOrDateStart + case r == '.': // special error case, be kind to users + return lx.errorf("Floats must start with a digit, not '.'.") + } + return lx.errorf("Expected value but found %q instead.", r) +} + +// lexArrayValue consumes one value in an array. It assumes that '[' or ',' +// have already been consumed. All whitespace and new lines are ignored. +func lexArrayValue(lx *lexer) stateFn { + r := lx.next() + switch { + case isWhitespace(r) || isNL(r): + return lexSkip(lx, lexArrayValue) + case r == commentStart: + lx.push(lexArrayValue) + return lexCommentStart + case r == arrayValTerm: + return lx.errorf("Unexpected array value terminator %q.", + arrayValTerm) + case r == arrayEnd: + return lexArrayEnd + } + + lx.backup() + lx.push(lexArrayValueEnd) + return lexValue +} + +// lexArrayValueEnd consumes the cruft between values of an array. Namely, +// it ignores whitespace and expects either a ',' or a ']'. +func lexArrayValueEnd(lx *lexer) stateFn { + r := lx.next() + switch { + case isWhitespace(r) || isNL(r): + return lexSkip(lx, lexArrayValueEnd) + case r == commentStart: + lx.push(lexArrayValueEnd) + return lexCommentStart + case r == arrayValTerm: + lx.ignore() + return lexArrayValue // move on to the next value + case r == arrayEnd: + return lexArrayEnd + } + return lx.errorf("Expected an array value terminator %q or an array "+ + "terminator %q, but got %q instead.", arrayValTerm, arrayEnd, r) +} + +// lexArrayEnd finishes the lexing of an array. It assumes that a ']' has +// just been consumed. +func lexArrayEnd(lx *lexer) stateFn { + lx.ignore() + lx.emit(itemArrayEnd) + return lx.pop() +} + +// lexString consumes the inner contents of a string. It assumes that the +// beginning '"' has already been consumed and ignored. +func lexString(lx *lexer) stateFn { + r := lx.next() + switch { + case isNL(r): + return lx.errorf("Strings cannot contain new lines.") + case r == '\\': + lx.push(lexString) + return lexStringEscape + case r == stringEnd: + lx.backup() + lx.emit(itemString) + lx.next() + lx.ignore() + return lx.pop() + } + return lexString +} + +// lexMultilineString consumes the inner contents of a string. It assumes that +// the beginning '"""' has already been consumed and ignored. +func lexMultilineString(lx *lexer) stateFn { + r := lx.next() + switch { + case r == '\\': + return lexMultilineStringEscape + case r == stringEnd: + if lx.accept(stringEnd) { + if lx.accept(stringEnd) { + lx.backup() + lx.backup() + lx.backup() + lx.emit(itemMultilineString) + lx.next() + lx.next() + lx.next() + lx.ignore() + return lx.pop() + } + lx.backup() + } + } + return lexMultilineString +} + +// lexRawString consumes a raw string. Nothing can be escaped in such a string. +// It assumes that the beginning "'" has already been consumed and ignored. +func lexRawString(lx *lexer) stateFn { + r := lx.next() + switch { + case isNL(r): + return lx.errorf("Strings cannot contain new lines.") + case r == rawStringEnd: + lx.backup() + lx.emit(itemRawString) + lx.next() + lx.ignore() + return lx.pop() + } + return lexRawString +} + +// lexMultilineRawString consumes a raw string. Nothing can be escaped in such +// a string. It assumes that the beginning "'" has already been consumed and +// ignored. +func lexMultilineRawString(lx *lexer) stateFn { + r := lx.next() + switch { + case r == rawStringEnd: + if lx.accept(rawStringEnd) { + if lx.accept(rawStringEnd) { + lx.backup() + lx.backup() + lx.backup() + lx.emit(itemRawMultilineString) + lx.next() + lx.next() + lx.next() + lx.ignore() + return lx.pop() + } + lx.backup() + } + } + return lexMultilineRawString +} + +// lexMultilineStringEscape consumes an escaped character. It assumes that the +// preceding '\\' has already been consumed. +func lexMultilineStringEscape(lx *lexer) stateFn { + // Handle the special case first: + if isNL(lx.next()) { + lx.next() + return lexMultilineString + } else { + lx.backup() + lx.push(lexMultilineString) + return lexStringEscape(lx) + } +} + +func lexStringEscape(lx *lexer) stateFn { + r := lx.next() + switch r { + case 'b': + fallthrough + case 't': + fallthrough + case 'n': + fallthrough + case 'f': + fallthrough + case 'r': + fallthrough + case '"': + fallthrough + case '\\': + return lx.pop() + case 'u': + return lexShortUnicodeEscape + case 'U': + return lexLongUnicodeEscape + } + return lx.errorf("Invalid escape character %q. Only the following "+ + "escape characters are allowed: "+ + "\\b, \\t, \\n, \\f, \\r, \\\", \\/, \\\\, "+ + "\\uXXXX and \\UXXXXXXXX.", r) +} + +func lexShortUnicodeEscape(lx *lexer) stateFn { + var r rune + for i := 0; i < 4; i++ { + r = lx.next() + if !isHexadecimal(r) { + return lx.errorf("Expected four hexadecimal digits after '\\u', "+ + "but got '%s' instead.", lx.current()) + } + } + return lx.pop() +} + +func lexLongUnicodeEscape(lx *lexer) stateFn { + var r rune + for i := 0; i < 8; i++ { + r = lx.next() + if !isHexadecimal(r) { + return lx.errorf("Expected eight hexadecimal digits after '\\U', "+ + "but got '%s' instead.", lx.current()) + } + } + return lx.pop() +} + +// lexNumberOrDateStart consumes either a (positive) integer, float or +// datetime. It assumes that NO negative sign has been consumed. +func lexNumberOrDateStart(lx *lexer) stateFn { + r := lx.next() + if !isDigit(r) { + if r == '.' { + return lx.errorf("Floats must start with a digit, not '.'.") + } else { + return lx.errorf("Expected a digit but got %q.", r) + } + } + return lexNumberOrDate +} + +// lexNumberOrDate consumes either a (positive) integer, float or datetime. +func lexNumberOrDate(lx *lexer) stateFn { + r := lx.next() + switch { + case r == '-': + if lx.pos-lx.start != 5 { + return lx.errorf("All ISO8601 dates must be in full Zulu form.") + } + return lexDateAfterYear + case isDigit(r): + return lexNumberOrDate + case r == '.': + return lexFloatStart + } + + lx.backup() + lx.emit(itemInteger) + return lx.pop() +} + +// lexDateAfterYear consumes a full Zulu Datetime in ISO8601 format. +// It assumes that "YYYY-" has already been consumed. +func lexDateAfterYear(lx *lexer) stateFn { + formats := []rune{ + // digits are '0'. + // everything else is direct equality. + '0', '0', '-', '0', '0', + 'T', + '0', '0', ':', '0', '0', ':', '0', '0', + 'Z', + } + for _, f := range formats { + r := lx.next() + if f == '0' { + if !isDigit(r) { + return lx.errorf("Expected digit in ISO8601 datetime, "+ + "but found %q instead.", r) + } + } else if f != r { + return lx.errorf("Expected %q in ISO8601 datetime, "+ + "but found %q instead.", f, r) + } + } + lx.emit(itemDatetime) + return lx.pop() +} + +// lexNumberStart consumes either an integer or a float. It assumes that +// a negative sign has already been read, but that *no* digits have been +// consumed. lexNumberStart will move to the appropriate integer or float +// states. +func lexNumberStart(lx *lexer) stateFn { + // we MUST see a digit. Even floats have to start with a digit. + r := lx.next() + if !isDigit(r) { + if r == '.' { + return lx.errorf("Floats must start with a digit, not '.'.") + } else { + return lx.errorf("Expected a digit but got %q.", r) + } + } + return lexNumber +} + +// lexNumber consumes an integer or a float after seeing the first digit. +func lexNumber(lx *lexer) stateFn { + r := lx.next() + switch { + case isDigit(r): + return lexNumber + case r == '.': + return lexFloatStart + } + + lx.backup() + lx.emit(itemInteger) + return lx.pop() +} + +// lexFloatStart starts the consumption of digits of a float after a '.'. +// Namely, at least one digit is required. +func lexFloatStart(lx *lexer) stateFn { + r := lx.next() + if !isDigit(r) { + return lx.errorf("Floats must have a digit after the '.', but got "+ + "%q instead.", r) + } + return lexFloat +} + +// lexFloat consumes the digits of a float after a '.'. +// Assumes that one digit has been consumed after a '.' already. +func lexFloat(lx *lexer) stateFn { + r := lx.next() + if isDigit(r) { + return lexFloat + } + + lx.backup() + lx.emit(itemFloat) + return lx.pop() +} + +// lexConst consumes the s[1:] in s. It assumes that s[0] has already been +// consumed. +func lexConst(lx *lexer, s string) stateFn { + for i := range s[1:] { + if r := lx.next(); r != rune(s[i+1]) { + return lx.errorf("Expected %q, but found %q instead.", s[:i+1], + s[:i]+string(r)) + } + } + return nil +} + +// lexTrue consumes the "rue" in "true". It assumes that 't' has already +// been consumed. +func lexTrue(lx *lexer) stateFn { + if fn := lexConst(lx, "true"); fn != nil { + return fn + } + lx.emit(itemBool) + return lx.pop() +} + +// lexFalse consumes the "alse" in "false". It assumes that 'f' has already +// been consumed. +func lexFalse(lx *lexer) stateFn { + if fn := lexConst(lx, "false"); fn != nil { + return fn + } + lx.emit(itemBool) + return lx.pop() +} + +// lexCommentStart begins the lexing of a comment. It will emit +// itemCommentStart and consume no characters, passing control to lexComment. +func lexCommentStart(lx *lexer) stateFn { + lx.ignore() + lx.emit(itemCommentStart) + return lexComment +} + +// lexComment lexes an entire comment. It assumes that '#' has been consumed. +// It will consume *up to* the first new line character, and pass control +// back to the last state on the stack. +func lexComment(lx *lexer) stateFn { + r := lx.peek() + if isNL(r) || r == eof { + lx.emit(itemText) + return lx.pop() + } + lx.next() + return lexComment +} + +// lexSkip ignores all slurped input and moves on to the next state. +func lexSkip(lx *lexer, nextState stateFn) stateFn { + return func(lx *lexer) stateFn { + lx.ignore() + return nextState + } +} + +// isWhitespace returns true if `r` is a whitespace character according +// to the spec. +func isWhitespace(r rune) bool { + return r == '\t' || r == ' ' +} + +func isNL(r rune) bool { + return r == '\n' || r == '\r' +} + +func isDigit(r rune) bool { + return r >= '0' && r <= '9' +} + +func isHexadecimal(r rune) bool { + return (r >= '0' && r <= '9') || + (r >= 'a' && r <= 'f') || + (r >= 'A' && r <= 'F') +} + +func isBareKeyChar(r rune) bool { + return (r >= 'A' && r <= 'Z') || + (r >= 'a' && r <= 'z') || + (r >= '0' && r <= '9') || + r == '_' || + r == '-' +} + +func (itype itemType) String() string { + switch itype { + case itemError: + return "Error" + case itemNIL: + return "NIL" + case itemEOF: + return "EOF" + case itemText: + return "Text" + case itemString: + return "String" + case itemRawString: + return "String" + case itemMultilineString: + return "String" + case itemRawMultilineString: + return "String" + case itemBool: + return "Bool" + case itemInteger: + return "Integer" + case itemFloat: + return "Float" + case itemDatetime: + return "DateTime" + case itemTableStart: + return "TableStart" + case itemTableEnd: + return "TableEnd" + case itemKeyStart: + return "KeyStart" + case itemArray: + return "Array" + case itemArrayEnd: + return "ArrayEnd" + case itemCommentStart: + return "CommentStart" + } + panic(fmt.Sprintf("BUG: Unknown type '%d'.", int(itype))) +} + +func (item item) String() string { + return fmt.Sprintf("(%s, %s)", item.typ.String(), item.val) +} diff --git a/vendor/src/github.com/BurntSushi/toml/parse.go b/vendor/src/github.com/BurntSushi/toml/parse.go new file mode 100644 index 0000000000..c6069be1f1 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/parse.go @@ -0,0 +1,498 @@ +package toml + +import ( + "fmt" + "log" + "strconv" + "strings" + "time" + "unicode" + "unicode/utf8" +) + +type parser struct { + mapping map[string]interface{} + types map[string]tomlType + lx *lexer + + // A list of keys in the order that they appear in the TOML data. + ordered []Key + + // the full key for the current hash in scope + context Key + + // the base key name for everything except hashes + currentKey string + + // rough approximation of line number + approxLine int + + // A map of 'key.group.names' to whether they were created implicitly. + implicits map[string]bool +} + +type parseError string + +func (pe parseError) Error() string { + return string(pe) +} + +func parse(data string) (p *parser, err error) { + defer func() { + if r := recover(); r != nil { + var ok bool + if err, ok = r.(parseError); ok { + return + } + panic(r) + } + }() + + p = &parser{ + mapping: make(map[string]interface{}), + types: make(map[string]tomlType), + lx: lex(data), + ordered: make([]Key, 0), + implicits: make(map[string]bool), + } + for { + item := p.next() + if item.typ == itemEOF { + break + } + p.topLevel(item) + } + + return p, nil +} + +func (p *parser) panicf(format string, v ...interface{}) { + msg := fmt.Sprintf("Near line %d (last key parsed '%s'): %s", + p.approxLine, p.current(), fmt.Sprintf(format, v...)) + panic(parseError(msg)) +} + +func (p *parser) next() item { + it := p.lx.nextItem() + if it.typ == itemError { + p.panicf("%s", it.val) + } + return it +} + +func (p *parser) bug(format string, v ...interface{}) { + log.Fatalf("BUG: %s\n\n", fmt.Sprintf(format, v...)) +} + +func (p *parser) expect(typ itemType) item { + it := p.next() + p.assertEqual(typ, it.typ) + return it +} + +func (p *parser) assertEqual(expected, got itemType) { + if expected != got { + p.bug("Expected '%s' but got '%s'.", expected, got) + } +} + +func (p *parser) topLevel(item item) { + switch item.typ { + case itemCommentStart: + p.approxLine = item.line + p.expect(itemText) + case itemTableStart: + kg := p.next() + p.approxLine = kg.line + + var key Key + for ; kg.typ != itemTableEnd && kg.typ != itemEOF; kg = p.next() { + key = append(key, p.keyString(kg)) + } + p.assertEqual(itemTableEnd, kg.typ) + + p.establishContext(key, false) + p.setType("", tomlHash) + p.ordered = append(p.ordered, key) + case itemArrayTableStart: + kg := p.next() + p.approxLine = kg.line + + var key Key + for ; kg.typ != itemArrayTableEnd && kg.typ != itemEOF; kg = p.next() { + key = append(key, p.keyString(kg)) + } + p.assertEqual(itemArrayTableEnd, kg.typ) + + p.establishContext(key, true) + p.setType("", tomlArrayHash) + p.ordered = append(p.ordered, key) + case itemKeyStart: + kname := p.next() + p.approxLine = kname.line + p.currentKey = p.keyString(kname) + + val, typ := p.value(p.next()) + p.setValue(p.currentKey, val) + p.setType(p.currentKey, typ) + p.ordered = append(p.ordered, p.context.add(p.currentKey)) + p.currentKey = "" + default: + p.bug("Unexpected type at top level: %s", item.typ) + } +} + +// Gets a string for a key (or part of a key in a table name). +func (p *parser) keyString(it item) string { + switch it.typ { + case itemText: + return it.val + case itemString, itemMultilineString, + itemRawString, itemRawMultilineString: + s, _ := p.value(it) + return s.(string) + default: + p.bug("Unexpected key type: %s", it.typ) + panic("unreachable") + } +} + +// value translates an expected value from the lexer into a Go value wrapped +// as an empty interface. +func (p *parser) value(it item) (interface{}, tomlType) { + switch it.typ { + case itemString: + return p.replaceEscapes(it.val), p.typeOfPrimitive(it) + case itemMultilineString: + trimmed := stripFirstNewline(stripEscapedWhitespace(it.val)) + return p.replaceEscapes(trimmed), p.typeOfPrimitive(it) + case itemRawString: + return it.val, p.typeOfPrimitive(it) + case itemRawMultilineString: + return stripFirstNewline(it.val), p.typeOfPrimitive(it) + case itemBool: + switch it.val { + case "true": + return true, p.typeOfPrimitive(it) + case "false": + return false, p.typeOfPrimitive(it) + } + p.bug("Expected boolean value, but got '%s'.", it.val) + case itemInteger: + num, err := strconv.ParseInt(it.val, 10, 64) + if err != nil { + // See comment below for floats describing why we make a + // distinction between a bug and a user error. + if e, ok := err.(*strconv.NumError); ok && + e.Err == strconv.ErrRange { + + p.panicf("Integer '%s' is out of the range of 64-bit "+ + "signed integers.", it.val) + } else { + p.bug("Expected integer value, but got '%s'.", it.val) + } + } + return num, p.typeOfPrimitive(it) + case itemFloat: + num, err := strconv.ParseFloat(it.val, 64) + if err != nil { + // Distinguish float values. Normally, it'd be a bug if the lexer + // provides an invalid float, but it's possible that the float is + // out of range of valid values (which the lexer cannot determine). + // So mark the former as a bug but the latter as a legitimate user + // error. + // + // This is also true for integers. + if e, ok := err.(*strconv.NumError); ok && + e.Err == strconv.ErrRange { + + p.panicf("Float '%s' is out of the range of 64-bit "+ + "IEEE-754 floating-point numbers.", it.val) + } else { + p.bug("Expected float value, but got '%s'.", it.val) + } + } + return num, p.typeOfPrimitive(it) + case itemDatetime: + t, err := time.Parse("2006-01-02T15:04:05Z", it.val) + if err != nil { + p.bug("Expected Zulu formatted DateTime, but got '%s'.", it.val) + } + return t, p.typeOfPrimitive(it) + case itemArray: + array := make([]interface{}, 0) + types := make([]tomlType, 0) + + for it = p.next(); it.typ != itemArrayEnd; it = p.next() { + if it.typ == itemCommentStart { + p.expect(itemText) + continue + } + + val, typ := p.value(it) + array = append(array, val) + types = append(types, typ) + } + return array, p.typeOfArray(types) + } + p.bug("Unexpected value type: %s", it.typ) + panic("unreachable") +} + +// establishContext sets the current context of the parser, +// where the context is either a hash or an array of hashes. Which one is +// set depends on the value of the `array` parameter. +// +// Establishing the context also makes sure that the key isn't a duplicate, and +// will create implicit hashes automatically. +func (p *parser) establishContext(key Key, array bool) { + var ok bool + + // Always start at the top level and drill down for our context. + hashContext := p.mapping + keyContext := make(Key, 0) + + // We only need implicit hashes for key[0:-1] + for _, k := range key[0 : len(key)-1] { + _, ok = hashContext[k] + keyContext = append(keyContext, k) + + // No key? Make an implicit hash and move on. + if !ok { + p.addImplicit(keyContext) + hashContext[k] = make(map[string]interface{}) + } + + // If the hash context is actually an array of tables, then set + // the hash context to the last element in that array. + // + // Otherwise, it better be a table, since this MUST be a key group (by + // virtue of it not being the last element in a key). + switch t := hashContext[k].(type) { + case []map[string]interface{}: + hashContext = t[len(t)-1] + case map[string]interface{}: + hashContext = t + default: + p.panicf("Key '%s' was already created as a hash.", keyContext) + } + } + + p.context = keyContext + if array { + // If this is the first element for this array, then allocate a new + // list of tables for it. + k := key[len(key)-1] + if _, ok := hashContext[k]; !ok { + hashContext[k] = make([]map[string]interface{}, 0, 5) + } + + // Add a new table. But make sure the key hasn't already been used + // for something else. + if hash, ok := hashContext[k].([]map[string]interface{}); ok { + hashContext[k] = append(hash, make(map[string]interface{})) + } else { + p.panicf("Key '%s' was already created and cannot be used as "+ + "an array.", keyContext) + } + } else { + p.setValue(key[len(key)-1], make(map[string]interface{})) + } + p.context = append(p.context, key[len(key)-1]) +} + +// setValue sets the given key to the given value in the current context. +// It will make sure that the key hasn't already been defined, account for +// implicit key groups. +func (p *parser) setValue(key string, value interface{}) { + var tmpHash interface{} + var ok bool + + hash := p.mapping + keyContext := make(Key, 0) + for _, k := range p.context { + keyContext = append(keyContext, k) + if tmpHash, ok = hash[k]; !ok { + p.bug("Context for key '%s' has not been established.", keyContext) + } + switch t := tmpHash.(type) { + case []map[string]interface{}: + // The context is a table of hashes. Pick the most recent table + // defined as the current hash. + hash = t[len(t)-1] + case map[string]interface{}: + hash = t + default: + p.bug("Expected hash to have type 'map[string]interface{}', but "+ + "it has '%T' instead.", tmpHash) + } + } + keyContext = append(keyContext, key) + + if _, ok := hash[key]; ok { + // Typically, if the given key has already been set, then we have + // to raise an error since duplicate keys are disallowed. However, + // it's possible that a key was previously defined implicitly. In this + // case, it is allowed to be redefined concretely. (See the + // `tests/valid/implicit-and-explicit-after.toml` test in `toml-test`.) + // + // But we have to make sure to stop marking it as an implicit. (So that + // another redefinition provokes an error.) + // + // Note that since it has already been defined (as a hash), we don't + // want to overwrite it. So our business is done. + if p.isImplicit(keyContext) { + p.removeImplicit(keyContext) + return + } + + // Otherwise, we have a concrete key trying to override a previous + // key, which is *always* wrong. + p.panicf("Key '%s' has already been defined.", keyContext) + } + hash[key] = value +} + +// setType sets the type of a particular value at a given key. +// It should be called immediately AFTER setValue. +// +// Note that if `key` is empty, then the type given will be applied to the +// current context (which is either a table or an array of tables). +func (p *parser) setType(key string, typ tomlType) { + keyContext := make(Key, 0, len(p.context)+1) + for _, k := range p.context { + keyContext = append(keyContext, k) + } + if len(key) > 0 { // allow type setting for hashes + keyContext = append(keyContext, key) + } + p.types[keyContext.String()] = typ +} + +// addImplicit sets the given Key as having been created implicitly. +func (p *parser) addImplicit(key Key) { + p.implicits[key.String()] = true +} + +// removeImplicit stops tagging the given key as having been implicitly +// created. +func (p *parser) removeImplicit(key Key) { + p.implicits[key.String()] = false +} + +// isImplicit returns true if the key group pointed to by the key was created +// implicitly. +func (p *parser) isImplicit(key Key) bool { + return p.implicits[key.String()] +} + +// current returns the full key name of the current context. +func (p *parser) current() string { + if len(p.currentKey) == 0 { + return p.context.String() + } + if len(p.context) == 0 { + return p.currentKey + } + return fmt.Sprintf("%s.%s", p.context, p.currentKey) +} + +func stripFirstNewline(s string) string { + if len(s) == 0 || s[0] != '\n' { + return s + } + return s[1:len(s)] +} + +func stripEscapedWhitespace(s string) string { + esc := strings.Split(s, "\\\n") + if len(esc) > 1 { + for i := 1; i < len(esc); i++ { + esc[i] = strings.TrimLeftFunc(esc[i], unicode.IsSpace) + } + } + return strings.Join(esc, "") +} + +func (p *parser) replaceEscapes(str string) string { + var replaced []rune + s := []byte(str) + r := 0 + for r < len(s) { + if s[r] != '\\' { + c, size := utf8.DecodeRune(s[r:]) + r += size + replaced = append(replaced, c) + continue + } + r += 1 + if r >= len(s) { + p.bug("Escape sequence at end of string.") + return "" + } + switch s[r] { + default: + p.bug("Expected valid escape code after \\, but got %q.", s[r]) + return "" + case 'b': + replaced = append(replaced, rune(0x0008)) + r += 1 + case 't': + replaced = append(replaced, rune(0x0009)) + r += 1 + case 'n': + replaced = append(replaced, rune(0x000A)) + r += 1 + case 'f': + replaced = append(replaced, rune(0x000C)) + r += 1 + case 'r': + replaced = append(replaced, rune(0x000D)) + r += 1 + case '"': + replaced = append(replaced, rune(0x0022)) + r += 1 + case '\\': + replaced = append(replaced, rune(0x005C)) + r += 1 + case 'u': + // At this point, we know we have a Unicode escape of the form + // `uXXXX` at [r, r+5). (Because the lexer guarantees this + // for us.) + escaped := p.asciiEscapeToUnicode(s[r+1 : r+5]) + replaced = append(replaced, escaped) + r += 5 + case 'U': + // At this point, we know we have a Unicode escape of the form + // `uXXXX` at [r, r+9). (Because the lexer guarantees this + // for us.) + escaped := p.asciiEscapeToUnicode(s[r+1 : r+9]) + replaced = append(replaced, escaped) + r += 9 + } + } + return string(replaced) +} + +func (p *parser) asciiEscapeToUnicode(bs []byte) rune { + s := string(bs) + hex, err := strconv.ParseUint(strings.ToLower(s), 16, 32) + if err != nil { + p.bug("Could not parse '%s' as a hexadecimal number, but the "+ + "lexer claims it's OK: %s", s, err) + } + + // BUG(burntsushi) + // I honestly don't understand how this works. I can't seem + // to find a way to make this fail. I figured this would fail on invalid + // UTF-8 characters like U+DCFF, but it doesn't. + if !utf8.ValidString(string(rune(hex))) { + p.panicf("Escaped character '\\u%s' is not valid UTF-8.", s) + } + return rune(hex) +} + +func isStringType(ty itemType) bool { + return ty == itemString || ty == itemMultilineString || + ty == itemRawString || ty == itemRawMultilineString +} diff --git a/vendor/src/github.com/BurntSushi/toml/session.vim b/vendor/src/github.com/BurntSushi/toml/session.vim new file mode 100644 index 0000000000..562164be06 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/session.vim @@ -0,0 +1 @@ +au BufWritePost *.go silent!make tags > /dev/null 2>&1 diff --git a/vendor/src/github.com/BurntSushi/toml/type_check.go b/vendor/src/github.com/BurntSushi/toml/type_check.go new file mode 100644 index 0000000000..c73f8afc1a --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/type_check.go @@ -0,0 +1,91 @@ +package toml + +// tomlType represents any Go type that corresponds to a TOML type. +// While the first draft of the TOML spec has a simplistic type system that +// probably doesn't need this level of sophistication, we seem to be militating +// toward adding real composite types. +type tomlType interface { + typeString() string +} + +// typeEqual accepts any two types and returns true if they are equal. +func typeEqual(t1, t2 tomlType) bool { + if t1 == nil || t2 == nil { + return false + } + return t1.typeString() == t2.typeString() +} + +func typeIsHash(t tomlType) bool { + return typeEqual(t, tomlHash) || typeEqual(t, tomlArrayHash) +} + +type tomlBaseType string + +func (btype tomlBaseType) typeString() string { + return string(btype) +} + +func (btype tomlBaseType) String() string { + return btype.typeString() +} + +var ( + tomlInteger tomlBaseType = "Integer" + tomlFloat tomlBaseType = "Float" + tomlDatetime tomlBaseType = "Datetime" + tomlString tomlBaseType = "String" + tomlBool tomlBaseType = "Bool" + tomlArray tomlBaseType = "Array" + tomlHash tomlBaseType = "Hash" + tomlArrayHash tomlBaseType = "ArrayHash" +) + +// typeOfPrimitive returns a tomlType of any primitive value in TOML. +// Primitive values are: Integer, Float, Datetime, String and Bool. +// +// Passing a lexer item other than the following will cause a BUG message +// to occur: itemString, itemBool, itemInteger, itemFloat, itemDatetime. +func (p *parser) typeOfPrimitive(lexItem item) tomlType { + switch lexItem.typ { + case itemInteger: + return tomlInteger + case itemFloat: + return tomlFloat + case itemDatetime: + return tomlDatetime + case itemString: + return tomlString + case itemMultilineString: + return tomlString + case itemRawString: + return tomlString + case itemRawMultilineString: + return tomlString + case itemBool: + return tomlBool + } + p.bug("Cannot infer primitive type of lex item '%s'.", lexItem) + panic("unreachable") +} + +// typeOfArray returns a tomlType for an array given a list of types of its +// values. +// +// In the current spec, if an array is homogeneous, then its type is always +// "Array". If the array is not homogeneous, an error is generated. +func (p *parser) typeOfArray(types []tomlType) tomlType { + // Empty arrays are cool. + if len(types) == 0 { + return tomlArray + } + + theType := types[0] + for _, t := range types[1:] { + if !typeEqual(theType, t) { + p.panicf("Array contains values of type '%s' and '%s', but "+ + "arrays must be homogeneous.", theType, t) + } + } + return tomlArray +} diff --git a/vendor/src/github.com/BurntSushi/toml/type_fields.go b/vendor/src/github.com/BurntSushi/toml/type_fields.go new file mode 100644 index 0000000000..7592f87a45 --- /dev/null +++ b/vendor/src/github.com/BurntSushi/toml/type_fields.go @@ -0,0 +1,241 @@ +package toml + +// Struct field handling is adapted from code in encoding/json: +// +// Copyright 2010 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the Go distribution. + +import ( + "reflect" + "sort" + "sync" +) + +// A field represents a single field found in a struct. +type field struct { + name string // the name of the field (`toml` tag included) + tag bool // whether field has a `toml` tag + index []int // represents the depth of an anonymous field + typ reflect.Type // the type of the field +} + +// byName sorts field by name, breaking ties with depth, +// then breaking ties with "name came from toml tag", then +// breaking ties with index sequence. +type byName []field + +func (x byName) Len() int { return len(x) } + +func (x byName) Swap(i, j int) { x[i], x[j] = x[j], x[i] } + +func (x byName) Less(i, j int) bool { + if x[i].name != x[j].name { + return x[i].name < x[j].name + } + if len(x[i].index) != len(x[j].index) { + return len(x[i].index) < len(x[j].index) + } + if x[i].tag != x[j].tag { + return x[i].tag + } + return byIndex(x).Less(i, j) +} + +// byIndex sorts field by index sequence. +type byIndex []field + +func (x byIndex) Len() int { return len(x) } + +func (x byIndex) Swap(i, j int) { x[i], x[j] = x[j], x[i] } + +func (x byIndex) Less(i, j int) bool { + for k, xik := range x[i].index { + if k >= len(x[j].index) { + return false + } + if xik != x[j].index[k] { + return xik < x[j].index[k] + } + } + return len(x[i].index) < len(x[j].index) +} + +// typeFields returns a list of fields that TOML should recognize for the given +// type. The algorithm is breadth-first search over the set of structs to +// include - the top struct and then any reachable anonymous structs. +func typeFields(t reflect.Type) []field { + // Anonymous fields to explore at the current level and the next. + current := []field{} + next := []field{{typ: t}} + + // Count of queued names for current level and the next. + count := map[reflect.Type]int{} + nextCount := map[reflect.Type]int{} + + // Types already visited at an earlier level. + visited := map[reflect.Type]bool{} + + // Fields found. + var fields []field + + for len(next) > 0 { + current, next = next, current[:0] + count, nextCount = nextCount, map[reflect.Type]int{} + + for _, f := range current { + if visited[f.typ] { + continue + } + visited[f.typ] = true + + // Scan f.typ for fields to include. + for i := 0; i < f.typ.NumField(); i++ { + sf := f.typ.Field(i) + if sf.PkgPath != "" { // unexported + continue + } + name := sf.Tag.Get("toml") + if name == "-" { + continue + } + index := make([]int, len(f.index)+1) + copy(index, f.index) + index[len(f.index)] = i + + ft := sf.Type + if ft.Name() == "" && ft.Kind() == reflect.Ptr { + // Follow pointer. + ft = ft.Elem() + } + + // Record found field and index sequence. + if name != "" || !sf.Anonymous || ft.Kind() != reflect.Struct { + tagged := name != "" + if name == "" { + name = sf.Name + } + fields = append(fields, field{name, tagged, index, ft}) + if count[f.typ] > 1 { + // If there were multiple instances, add a second, + // so that the annihilation code will see a duplicate. + // It only cares about the distinction between 1 or 2, + // so don't bother generating any more copies. + fields = append(fields, fields[len(fields)-1]) + } + continue + } + + // Record new anonymous struct to explore in next round. + nextCount[ft]++ + if nextCount[ft] == 1 { + f := field{name: ft.Name(), index: index, typ: ft} + next = append(next, f) + } + } + } + } + + sort.Sort(byName(fields)) + + // Delete all fields that are hidden by the Go rules for embedded fields, + // except that fields with TOML tags are promoted. + + // The fields are sorted in primary order of name, secondary order + // of field index length. Loop over names; for each name, delete + // hidden fields by choosing the one dominant field that survives. + out := fields[:0] + for advance, i := 0, 0; i < len(fields); i += advance { + // One iteration per name. + // Find the sequence of fields with the name of this first field. + fi := fields[i] + name := fi.name + for advance = 1; i+advance < len(fields); advance++ { + fj := fields[i+advance] + if fj.name != name { + break + } + } + if advance == 1 { // Only one field with this name + out = append(out, fi) + continue + } + dominant, ok := dominantField(fields[i : i+advance]) + if ok { + out = append(out, dominant) + } + } + + fields = out + sort.Sort(byIndex(fields)) + + return fields +} + +// dominantField looks through the fields, all of which are known to +// have the same name, to find the single field that dominates the +// others using Go's embedding rules, modified by the presence of +// TOML tags. If there are multiple top-level fields, the boolean +// will be false: This condition is an error in Go and we skip all +// the fields. +func dominantField(fields []field) (field, bool) { + // The fields are sorted in increasing index-length order. The winner + // must therefore be one with the shortest index length. Drop all + // longer entries, which is easy: just truncate the slice. + length := len(fields[0].index) + tagged := -1 // Index of first tagged field. + for i, f := range fields { + if len(f.index) > length { + fields = fields[:i] + break + } + if f.tag { + if tagged >= 0 { + // Multiple tagged fields at the same level: conflict. + // Return no field. + return field{}, false + } + tagged = i + } + } + if tagged >= 0 { + return fields[tagged], true + } + // All remaining fields have the same length. If there's more than one, + // we have a conflict (two fields named "X" at the same level) and we + // return no field. + if len(fields) > 1 { + return field{}, false + } + return fields[0], true +} + +var fieldCache struct { + sync.RWMutex + m map[reflect.Type][]field +} + +// cachedTypeFields is like typeFields but uses a cache to avoid repeated work. +func cachedTypeFields(t reflect.Type) []field { + fieldCache.RLock() + f := fieldCache.m[t] + fieldCache.RUnlock() + if f != nil { + return f + } + + // Compute fields without lock. + // Might duplicate effort but won't hold other computations back. + f = typeFields(t) + if f == nil { + f = []field{} + } + + fieldCache.Lock() + if fieldCache.m == nil { + fieldCache.m = map[reflect.Type][]field{} + } + fieldCache.m[t] = f + fieldCache.Unlock() + return f +} diff --git a/vendor/src/github.com/Graylog2/go-gelf/LICENSE b/vendor/src/github.com/Graylog2/go-gelf/LICENSE new file mode 100644 index 0000000000..bc756ae365 --- /dev/null +++ b/vendor/src/github.com/Graylog2/go-gelf/LICENSE @@ -0,0 +1,21 @@ +Copyright 2012 SocialCode + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/vendor/src/github.com/Graylog2/go-gelf/gelf/reader.go b/vendor/src/github.com/Graylog2/go-gelf/gelf/reader.go new file mode 100644 index 0000000000..305b865db7 --- /dev/null +++ b/vendor/src/github.com/Graylog2/go-gelf/gelf/reader.go @@ -0,0 +1,142 @@ +// Copyright 2012 SocialCode. All rights reserved. +// Use of this source code is governed by the MIT +// license that can be found in the LICENSE file. + +package gelf + +import ( + "bytes" + "compress/gzip" + "compress/zlib" + "encoding/json" + "fmt" + "io" + "net" + "strings" + "sync" +) + +type Reader struct { + mu sync.Mutex + conn net.Conn +} + +func NewReader(addr string) (*Reader, error) { + var err error + udpAddr, err := net.ResolveUDPAddr("udp", addr) + if err != nil { + return nil, fmt.Errorf("ResolveUDPAddr('%s'): %s", addr, err) + } + + conn, err := net.ListenUDP("udp", udpAddr) + if err != nil { + return nil, fmt.Errorf("ListenUDP: %s", err) + } + + r := new(Reader) + r.conn = conn + return r, nil +} + +func (r *Reader) Addr() string { + return r.conn.LocalAddr().String() +} + +// FIXME: this will discard data if p isn't big enough to hold the +// full message. +func (r *Reader) Read(p []byte) (int, error) { + msg, err := r.ReadMessage() + if err != nil { + return -1, err + } + + var data string + + if msg.Full == "" { + data = msg.Short + } else { + data = msg.Full + } + + return strings.NewReader(data).Read(p) +} + +func (r *Reader) ReadMessage() (*Message, error) { + cBuf := make([]byte, ChunkSize) + var ( + err error + n, length int + buf bytes.Buffer + cid, ocid []byte + seq, total uint8 + cHead []byte + cReader io.Reader + chunks [][]byte + ) + + for got := 0; got < 128 && (total == 0 || got < int(total)); got++ { + if n, err = r.conn.Read(cBuf); err != nil { + return nil, fmt.Errorf("Read: %s", err) + } + cHead, cBuf = cBuf[:2], cBuf[:n] + + if bytes.Equal(cHead, magicChunked) { + //fmt.Printf("chunked %v\n", cBuf[:14]) + cid, seq, total = cBuf[2:2+8], cBuf[2+8], cBuf[2+8+1] + if ocid != nil && !bytes.Equal(cid, ocid) { + return nil, fmt.Errorf("out-of-band message %v (awaited %v)", cid, ocid) + } else if ocid == nil { + ocid = cid + chunks = make([][]byte, total) + } + n = len(cBuf) - chunkedHeaderLen + //fmt.Printf("setting chunks[%d]: %d\n", seq, n) + chunks[seq] = append(make([]byte, 0, n), cBuf[chunkedHeaderLen:]...) + length += n + } else { //not chunked + if total > 0 { + return nil, fmt.Errorf("out-of-band message (not chunked)") + } + break + } + } + //fmt.Printf("\nchunks: %v\n", chunks) + + if length > 0 { + if cap(cBuf) < length { + cBuf = append(cBuf, make([]byte, 0, length-cap(cBuf))...) + } + cBuf = cBuf[:0] + for i := range chunks { + //fmt.Printf("appending %d %v\n", i, chunks[i]) + cBuf = append(cBuf, chunks[i]...) + } + cHead = cBuf[:2] + } + + // the data we get from the wire is compressed + if bytes.Equal(cHead, magicGzip) { + cReader, err = gzip.NewReader(bytes.NewReader(cBuf)) + } else if cHead[0] == magicZlib[0] && + (int(cHead[0])*256+int(cHead[1]))%31 == 0 { + // zlib is slightly more complicated, but correct + cReader, err = zlib.NewReader(bytes.NewReader(cBuf)) + } else { + return nil, fmt.Errorf("unknown magic: %x %v", cHead, cHead) + } + + if err != nil { + return nil, fmt.Errorf("NewReader: %s", err) + } + + if _, err = io.Copy(&buf, cReader); err != nil { + return nil, fmt.Errorf("io.Copy: %s", err) + } + + msg := new(Message) + if err := json.Unmarshal(buf.Bytes(), &msg); err != nil { + return nil, fmt.Errorf("json.Unmarshal: %s", err) + } + + return msg, nil +} diff --git a/vendor/src/github.com/Graylog2/go-gelf/gelf/writer.go b/vendor/src/github.com/Graylog2/go-gelf/gelf/writer.go new file mode 100644 index 0000000000..6a5a0238e1 --- /dev/null +++ b/vendor/src/github.com/Graylog2/go-gelf/gelf/writer.go @@ -0,0 +1,373 @@ +// Copyright 2012 SocialCode. All rights reserved. +// Use of this source code is governed by the MIT +// license that can be found in the LICENSE file. + +package gelf + +import ( + "bytes" + "compress/flate" + "compress/gzip" + "compress/zlib" + "crypto/rand" + "encoding/json" + "fmt" + "io" + "net" + "os" + "path" + "runtime" + "strings" + "sync" + "time" +) + +// Writer implements io.Writer and is used to send both discrete +// messages to a graylog2 server, or data from a stream-oriented +// interface (like the functions in log). +type Writer struct { + mu sync.Mutex + conn net.Conn + hostname string + Facility string // defaults to current process name + CompressionLevel int // one of the consts from compress/flate + CompressionType CompressType +} + +// What compression type the writer should use when sending messages +// to the graylog2 server +type CompressType int + +const ( + CompressGzip CompressType = iota + CompressZlib +) + +// Message represents the contents of the GELF message. It is gzipped +// before sending. +type Message struct { + Version string `json:"version"` + Host string `json:"host"` + Short string `json:"short_message"` + Full string `json:"full_message"` + TimeUnix float64 `json:"timestamp"` + Level int32 `json:"level"` + Facility string `json:"facility"` + Extra map[string]interface{} `json:"-"` +} + +type innerMessage Message //against circular (Un)MarshalJSON + +// Used to control GELF chunking. Should be less than (MTU - len(UDP +// header)). +// +// TODO: generate dynamically using Path MTU Discovery? +const ( + ChunkSize = 1420 + chunkedHeaderLen = 12 + chunkedDataLen = ChunkSize - chunkedHeaderLen +) + +var ( + magicChunked = []byte{0x1e, 0x0f} + magicZlib = []byte{0x78} + magicGzip = []byte{0x1f, 0x8b} +) + +// Syslog severity levels +const ( + LOG_EMERG = int32(0) + LOG_ALERT = int32(1) + LOG_CRIT = int32(2) + LOG_ERR = int32(3) + LOG_WARNING = int32(4) + LOG_NOTICE = int32(5) + LOG_INFO = int32(6) + LOG_DEBUG = int32(7) +) + +// numChunks returns the number of GELF chunks necessary to transmit +// the given compressed buffer. +func numChunks(b []byte) int { + lenB := len(b) + if lenB <= ChunkSize { + return 1 + } + return len(b)/chunkedDataLen + 1 +} + +// New returns a new GELF Writer. This writer can be used to send the +// output of the standard Go log functions to a central GELF server by +// passing it to log.SetOutput() +func NewWriter(addr string) (*Writer, error) { + var err error + w := new(Writer) + w.CompressionLevel = flate.BestSpeed + + if w.conn, err = net.Dial("udp", addr); err != nil { + return nil, err + } + if w.hostname, err = os.Hostname(); err != nil { + return nil, err + } + + w.Facility = path.Base(os.Args[0]) + + return w, nil +} + +// writes the gzip compressed byte array to the connection as a series +// of GELF chunked messages. The header format is documented at +// https://github.com/Graylog2/graylog2-docs/wiki/GELF as: +// +// 2-byte magic (0x1e 0x0f), 8 byte id, 1 byte sequence id, 1 byte +// total, chunk-data +func (w *Writer) writeChunked(zBytes []byte) (err error) { + b := make([]byte, 0, ChunkSize) + buf := bytes.NewBuffer(b) + nChunksI := numChunks(zBytes) + if nChunksI > 255 { + return fmt.Errorf("msg too large, would need %d chunks", nChunksI) + } + nChunks := uint8(nChunksI) + // use urandom to get a unique message id + msgId := make([]byte, 8) + n, err := io.ReadFull(rand.Reader, msgId) + if err != nil || n != 8 { + return fmt.Errorf("rand.Reader: %d/%s", n, err) + } + + bytesLeft := len(zBytes) + for i := uint8(0); i < nChunks; i++ { + buf.Reset() + // manually write header. Don't care about + // host/network byte order, because the spec only + // deals in individual bytes. + buf.Write(magicChunked) //magic + buf.Write(msgId) + buf.WriteByte(i) + buf.WriteByte(nChunks) + // slice out our chunk from zBytes + chunkLen := chunkedDataLen + if chunkLen > bytesLeft { + chunkLen = bytesLeft + } + off := int(i) * chunkedDataLen + chunk := zBytes[off : off+chunkLen] + buf.Write(chunk) + + // write this chunk, and make sure the write was good + n, err := w.conn.Write(buf.Bytes()) + if err != nil { + return fmt.Errorf("Write (chunk %d/%d): %s", i, + nChunks, err) + } + if n != len(buf.Bytes()) { + return fmt.Errorf("Write len: (chunk %d/%d) (%d/%d)", + i, nChunks, n, len(buf.Bytes())) + } + + bytesLeft -= chunkLen + } + + if bytesLeft != 0 { + return fmt.Errorf("error: %d bytes left after sending", bytesLeft) + } + return nil +} + +// WriteMessage sends the specified message to the GELF server +// specified in the call to New(). It assumes all the fields are +// filled out appropriately. In general, clients will want to use +// Write, rather than WriteMessage. +func (w *Writer) WriteMessage(m *Message) (err error) { + mBytes, err := json.Marshal(m) + if err != nil { + return + } + + var zBuf bytes.Buffer + var zw io.WriteCloser + switch w.CompressionType { + case CompressGzip: + zw, err = gzip.NewWriterLevel(&zBuf, w.CompressionLevel) + case CompressZlib: + zw, err = zlib.NewWriterLevel(&zBuf, w.CompressionLevel) + default: + panic(fmt.Sprintf("unknown compression type %d", + w.CompressionType)) + } + if err != nil { + return + } + if _, err = zw.Write(mBytes); err != nil { + return + } + zw.Close() + + zBytes := zBuf.Bytes() + if numChunks(zBytes) > 1 { + return w.writeChunked(zBytes) + } + + n, err := w.conn.Write(zBytes) + if err != nil { + return + } + if n != len(zBytes) { + return fmt.Errorf("bad write (%d/%d)", n, len(zBytes)) + } + + return nil +} + +// Close connection and interrupt blocked Read or Write operations +func (w *Writer) Close() (error) { + return w.conn.Close() +} + +/* +func (w *Writer) Alert(m string) (err error) +func (w *Writer) Close() error +func (w *Writer) Crit(m string) (err error) +func (w *Writer) Debug(m string) (err error) +func (w *Writer) Emerg(m string) (err error) +func (w *Writer) Err(m string) (err error) +func (w *Writer) Info(m string) (err error) +func (w *Writer) Notice(m string) (err error) +func (w *Writer) Warning(m string) (err error) +*/ + +// getCaller returns the filename and the line info of a function +// further down in the call stack. Passing 0 in as callDepth would +// return info on the function calling getCallerIgnoringLog, 1 the +// parent function, and so on. Any suffixes passed to getCaller are +// path fragments like "/pkg/log/log.go", and functions in the call +// stack from that file are ignored. +func getCaller(callDepth int, suffixesToIgnore ...string) (file string, line int) { + // bump by 1 to ignore the getCaller (this) stackframe + callDepth++ +outer: + for { + var ok bool + _, file, line, ok = runtime.Caller(callDepth) + if !ok { + file = "???" + line = 0 + break + } + + for _, s := range suffixesToIgnore { + if strings.HasSuffix(file, s) { + callDepth++ + continue outer + } + } + break + } + return +} + +func getCallerIgnoringLogMulti(callDepth int) (string, int) { + // the +1 is to ignore this (getCallerIgnoringLogMulti) frame + return getCaller(callDepth+1, "/pkg/log/log.go", "/pkg/io/multi.go") +} + +// Write encodes the given string in a GELF message and sends it to +// the server specified in New(). +func (w *Writer) Write(p []byte) (n int, err error) { + + // 1 for the function that called us. + file, line := getCallerIgnoringLogMulti(1) + + // remove trailing and leading whitespace + p = bytes.TrimSpace(p) + + // If there are newlines in the message, use the first line + // for the short message and set the full message to the + // original input. If the input has no newlines, stick the + // whole thing in Short. + short := p + full := []byte("") + if i := bytes.IndexRune(p, '\n'); i > 0 { + short = p[:i] + full = p + } + + m := Message{ + Version: "1.1", + Host: w.hostname, + Short: string(short), + Full: string(full), + TimeUnix: float64(time.Now().Unix()), + Level: 6, // info + Facility: w.Facility, + Extra: map[string]interface{}{ + "_file": file, + "_line": line, + }, + } + + if err = w.WriteMessage(&m); err != nil { + return 0, err + } + + return len(p), nil +} + +func (m *Message) MarshalJSON() ([]byte, error) { + var err error + var b, eb []byte + + extra := m.Extra + b, err = json.Marshal((*innerMessage)(m)) + m.Extra = extra + if err != nil { + return nil, err + } + + if len(extra) == 0 { + return b, nil + } + + if eb, err = json.Marshal(extra); err != nil { + return nil, err + } + + // merge serialized message + serialized extra map + b[len(b)-1] = ',' + return append(b, eb[1:len(eb)]...), nil +} + +func (m *Message) UnmarshalJSON(data []byte) error { + i := make(map[string]interface{}, 16) + if err := json.Unmarshal(data, &i); err != nil { + return err + } + for k, v := range i { + if k[0] == '_' { + if m.Extra == nil { + m.Extra = make(map[string]interface{}, 1) + } + m.Extra[k] = v + continue + } + switch k { + case "version": + m.Version = v.(string) + case "host": + m.Host = v.(string) + case "short_message": + m.Short = v.(string) + case "full_message": + m.Full = v.(string) + case "timestamp": + m.TimeUnix = v.(float64) + case "level": + m.Level = int32(v.(float64)) + case "facility": + m.Facility = v.(string) + } + } + return nil +} diff --git a/vendor/src/github.com/Sirupsen/logrus/.gitignore b/vendor/src/github.com/Sirupsen/logrus/.gitignore new file mode 100644 index 0000000000..66be63a005 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/.gitignore @@ -0,0 +1 @@ +logrus diff --git a/vendor/src/github.com/Sirupsen/logrus/.travis.yml b/vendor/src/github.com/Sirupsen/logrus/.travis.yml new file mode 100644 index 0000000000..2d8c086617 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/.travis.yml @@ -0,0 +1,8 @@ +language: go +go: + - 1.2 + - 1.3 + - 1.4 + - tip +install: + - go get -t ./... diff --git a/vendor/src/github.com/Sirupsen/logrus/CHANGELOG.md b/vendor/src/github.com/Sirupsen/logrus/CHANGELOG.md new file mode 100644 index 0000000000..49c5506a3e --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/CHANGELOG.md @@ -0,0 +1,21 @@ +# 0.8.2 + +logrus: fix more Fatal family functions + +# 0.8.1 + +logrus: fix not exiting on `Fatalf` and `Fatalln` + +# 0.8.0 + +logrus: defaults to stderr instead of stdout +hooks/sentry: add special field for `*http.Request` +formatter/text: ignore Windows for colors + +# 0.7.3 + +formatter/\*: allow configuration of timestamp layout + +# 0.7.2 + +formatter/text: Add configuration option for time format (#158) diff --git a/vendor/src/github.com/Sirupsen/logrus/LICENSE b/vendor/src/github.com/Sirupsen/logrus/LICENSE new file mode 100644 index 0000000000..f090cb42f3 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2014 Simon Eskildsen + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/vendor/src/github.com/Sirupsen/logrus/README.md b/vendor/src/github.com/Sirupsen/logrus/README.md new file mode 100644 index 0000000000..3578deaec0 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/README.md @@ -0,0 +1,350 @@ +# Logrus :walrus: [![Build Status](https://travis-ci.org/Sirupsen/logrus.svg?branch=master)](https://travis-ci.org/Sirupsen/logrus) [![godoc reference](https://godoc.org/github.com/Sirupsen/logrus?status.png)][godoc] + +Logrus is a structured logger for Go (golang), completely API compatible with +the standard library logger. [Godoc][godoc]. **Please note the Logrus API is not +yet stable (pre 1.0). Logrus itself is completely stable and has been used in +many large deployments. The core API is unlikely to change much but please +version control your Logrus to make sure you aren't fetching latest `master` on +every build.** + +Nicely color-coded in development (when a TTY is attached, otherwise just +plain text): + +![Colored](http://i.imgur.com/PY7qMwd.png) + +With `log.Formatter = new(logrus.JSONFormatter)`, for easy parsing by logstash +or Splunk: + +```json +{"animal":"walrus","level":"info","msg":"A group of walrus emerges from the +ocean","size":10,"time":"2014-03-10 19:57:38.562264131 -0400 EDT"} + +{"level":"warning","msg":"The group's number increased tremendously!", +"number":122,"omg":true,"time":"2014-03-10 19:57:38.562471297 -0400 EDT"} + +{"animal":"walrus","level":"info","msg":"A giant walrus appears!", +"size":10,"time":"2014-03-10 19:57:38.562500591 -0400 EDT"} + +{"animal":"walrus","level":"info","msg":"Tremendously sized cow enters the ocean.", +"size":9,"time":"2014-03-10 19:57:38.562527896 -0400 EDT"} + +{"level":"fatal","msg":"The ice breaks!","number":100,"omg":true, +"time":"2014-03-10 19:57:38.562543128 -0400 EDT"} +``` + +With the default `log.Formatter = new(&log.TextFormatter{})` when a TTY is not +attached, the output is compatible with the +[logfmt](http://godoc.org/github.com/kr/logfmt) format: + +```text +time="2015-03-26T01:27:38-04:00" level=debug msg="Started observing beach" animal=walrus number=8 +time="2015-03-26T01:27:38-04:00" level=info msg="A group of walrus emerges from the ocean" animal=walrus size=10 +time="2015-03-26T01:27:38-04:00" level=warning msg="The group's number increased tremendously!" number=122 omg=true +time="2015-03-26T01:27:38-04:00" level=debug msg="Temperature changes" temperature=-4 +time="2015-03-26T01:27:38-04:00" level=panic msg="It's over 9000!" animal=orca size=9009 +time="2015-03-26T01:27:38-04:00" level=fatal msg="The ice breaks!" err=&{0x2082280c0 map[animal:orca size:9009] 2015-03-26 01:27:38.441574009 -0400 EDT panic It's over 9000!} number=100 omg=true +exit status 1 +``` + +#### Example + +The simplest way to use Logrus is simply the package-level exported logger: + +```go +package main + +import ( + log "github.com/Sirupsen/logrus" +) + +func main() { + log.WithFields(log.Fields{ + "animal": "walrus", + }).Info("A walrus appears") +} +``` + +Note that it's completely api-compatible with the stdlib logger, so you can +replace your `log` imports everywhere with `log "github.com/Sirupsen/logrus"` +and you'll now have the flexibility of Logrus. You can customize it all you +want: + +```go +package main + +import ( + "os" + log "github.com/Sirupsen/logrus" + "github.com/Sirupsen/logrus/hooks/airbrake" +) + +func init() { + // Log as JSON instead of the default ASCII formatter. + log.SetFormatter(&log.JSONFormatter{}) + + // Use the Airbrake hook to report errors that have Error severity or above to + // an exception tracker. You can create custom hooks, see the Hooks section. + log.AddHook(airbrake.NewHook("https://example.com", "xyz", "development")) + + // Output to stderr instead of stdout, could also be a file. + log.SetOutput(os.Stderr) + + // Only log the warning severity or above. + log.SetLevel(log.WarnLevel) +} + +func main() { + log.WithFields(log.Fields{ + "animal": "walrus", + "size": 10, + }).Info("A group of walrus emerges from the ocean") + + log.WithFields(log.Fields{ + "omg": true, + "number": 122, + }).Warn("The group's number increased tremendously!") + + log.WithFields(log.Fields{ + "omg": true, + "number": 100, + }).Fatal("The ice breaks!") + + // A common pattern is to re-use fields between logging statements by re-using + // the logrus.Entry returned from WithFields() + contextLogger := log.WithFields(log.Fields{ + "common": "this is a common field", + "other": "I also should be logged always", + }) + + contextLogger.Info("I'll be logged with common and other field") + contextLogger.Info("Me too") +} +``` + +For more advanced usage such as logging to multiple locations from the same +application, you can also create an instance of the `logrus` Logger: + +```go +package main + +import ( + "github.com/Sirupsen/logrus" +) + +// Create a new instance of the logger. You can have any number of instances. +var log = logrus.New() + +func main() { + // The API for setting attributes is a little different than the package level + // exported logger. See Godoc. + log.Out = os.Stderr + + log.WithFields(logrus.Fields{ + "animal": "walrus", + "size": 10, + }).Info("A group of walrus emerges from the ocean") +} +``` + +#### Fields + +Logrus encourages careful, structured logging though logging fields instead of +long, unparseable error messages. For example, instead of: `log.Fatalf("Failed +to send event %s to topic %s with key %d")`, you should log the much more +discoverable: + +```go +log.WithFields(log.Fields{ + "event": event, + "topic": topic, + "key": key, +}).Fatal("Failed to send event") +``` + +We've found this API forces you to think about logging in a way that produces +much more useful logging messages. We've been in countless situations where just +a single added field to a log statement that was already there would've saved us +hours. The `WithFields` call is optional. + +In general, with Logrus using any of the `printf`-family functions should be +seen as a hint you should add a field, however, you can still use the +`printf`-family functions with Logrus. + +#### Hooks + +You can add hooks for logging levels. For example to send errors to an exception +tracking service on `Error`, `Fatal` and `Panic`, info to StatsD or log to +multiple places simultaneously, e.g. syslog. + +Logrus comes with [built-in hooks](hooks/). Add those, or your custom hook, in +`init`: + +```go +import ( + log "github.com/Sirupsen/logrus" + "github.com/Sirupsen/logrus/hooks/airbrake" + "github.com/Sirupsen/logrus/hooks/syslog" + "log/syslog" +) + +func init() { + log.AddHook(airbrake.NewHook("https://example.com", "xyz", "development")) + + hook, err := logrus_syslog.NewSyslogHook("udp", "localhost:514", syslog.LOG_INFO, "") + if err != nil { + log.Error("Unable to connect to local syslog daemon") + } else { + log.AddHook(hook) + } +} +``` + + +| Hook | Description | +| ----- | ----------- | +| [Airbrake](https://github.com/Sirupsen/logrus/blob/master/hooks/airbrake/airbrake.go) | Send errors to an exception tracking service compatible with the Airbrake API. Uses [`airbrake-go`](https://github.com/tobi/airbrake-go) behind the scenes. | +| [Papertrail](https://github.com/Sirupsen/logrus/blob/master/hooks/papertrail/papertrail.go) | Send errors to the Papertrail hosted logging service via UDP. | +| [Syslog](https://github.com/Sirupsen/logrus/blob/master/hooks/syslog/syslog.go) | Send errors to remote syslog server. Uses standard library `log/syslog` behind the scenes. | +| [BugSnag](https://github.com/Sirupsen/logrus/blob/master/hooks/bugsnag/bugsnag.go) | Send errors to the Bugsnag exception tracking service. | +| [Hiprus](https://github.com/nubo/hiprus) | Send errors to a channel in hipchat. | +| [Logrusly](https://github.com/sebest/logrusly) | Send logs to [Loggly](https://www.loggly.com/) | +| [Slackrus](https://github.com/johntdyer/slackrus) | Hook for Slack chat. | +| [Journalhook](https://github.com/wercker/journalhook) | Hook for logging to `systemd-journald` | +| [Graylog](https://github.com/gemnasium/logrus-hooks/tree/master/graylog) | Hook for logging to [Graylog](http://graylog2.org/) | +| [Raygun](https://github.com/squirkle/logrus-raygun-hook) | Hook for logging to [Raygun.io](http://raygun.io/) | + +#### Level logging + +Logrus has six logging levels: Debug, Info, Warning, Error, Fatal and Panic. + +```go +log.Debug("Useful debugging information.") +log.Info("Something noteworthy happened!") +log.Warn("You should probably take a look at this.") +log.Error("Something failed but I'm not quitting.") +// Calls os.Exit(1) after logging +log.Fatal("Bye.") +// Calls panic() after logging +log.Panic("I'm bailing.") +``` + +You can set the logging level on a `Logger`, then it will only log entries with +that severity or anything above it: + +```go +// Will log anything that is info or above (warn, error, fatal, panic). Default. +log.SetLevel(log.InfoLevel) +``` + +It may be useful to set `log.Level = logrus.DebugLevel` in a debug or verbose +environment if your application has that. + +#### Entries + +Besides the fields added with `WithField` or `WithFields` some fields are +automatically added to all logging events: + +1. `time`. The timestamp when the entry was created. +2. `msg`. The logging message passed to `{Info,Warn,Error,Fatal,Panic}` after + the `AddFields` call. E.g. `Failed to send event.` +3. `level`. The logging level. E.g. `info`. + +#### Environments + +Logrus has no notion of environment. + +If you wish for hooks and formatters to only be used in specific environments, +you should handle that yourself. For example, if your application has a global +variable `Environment`, which is a string representation of the environment you +could do: + +```go +import ( + log "github.com/Sirupsen/logrus" +) + +init() { + // do something here to set environment depending on an environment variable + // or command-line flag + if Environment == "production" { + log.SetFormatter(logrus.JSONFormatter) + } else { + // The TextFormatter is default, you don't actually have to do this. + log.SetFormatter(&log.TextFormatter{}) + } +} +``` + +This configuration is how `logrus` was intended to be used, but JSON in +production is mostly only useful if you do log aggregation with tools like +Splunk or Logstash. + +#### Formatters + +The built-in logging formatters are: + +* `logrus.TextFormatter`. Logs the event in colors if stdout is a tty, otherwise + without colors. + * *Note:* to force colored output when there is no TTY, set the `ForceColors` + field to `true`. To force no colored output even if there is a TTY set the + `DisableColors` field to `true` +* `logrus.JSONFormatter`. Logs fields as JSON. +* `logrus_logstash.LogstashFormatter`. Logs fields as Logstash Events (http://logstash.net). + + ```go + logrus.SetFormatter(&logrus_logstash.LogstashFormatter{Type: “application_name"}) + ``` + +Third party logging formatters: + +* [`zalgo`](https://github.com/aybabtme/logzalgo): invoking the P͉̫o̳̼̊w̖͈̰͎e̬͔̭͂r͚̼̹̲ ̫͓͉̳͈ō̠͕͖̚f̝͍̠ ͕̲̞͖͑Z̖̫̤̫ͪa͉̬͈̗l͖͎g̳̥o̰̥̅!̣͔̲̻͊̄ ̙̘̦̹̦. + +You can define your formatter by implementing the `Formatter` interface, +requiring a `Format` method. `Format` takes an `*Entry`. `entry.Data` is a +`Fields` type (`map[string]interface{}`) with all your fields as well as the +default ones (see Entries section above): + +```go +type MyJSONFormatter struct { +} + +log.SetFormatter(new(MyJSONFormatter)) + +func (f *JSONFormatter) Format(entry *Entry) ([]byte, error) { + // Note this doesn't include Time, Level and Message which are available on + // the Entry. Consult `godoc` on information about those fields or read the + // source of the official loggers. + serialized, err := json.Marshal(entry.Data) + if err != nil { + return nil, fmt.Errorf("Failed to marshal fields to JSON, %v", err) + } + return append(serialized, '\n'), nil +} +``` + +#### Logger as an `io.Writer` + +Logrus can be transormed into an `io.Writer`. That writer is the end of an `io.Pipe` and it is your responsibility to close it. + +```go +w := logger.Writer() +defer w.Close() + +srv := http.Server{ + // create a stdlib log.Logger that writes to + // logrus.Logger. + ErrorLog: log.New(w, "", 0), +} +``` + +Each line written to that writer will be printed the usual way, using formatters +and hooks. The level for those entries is `info`. + +#### Rotation + +Log rotation is not provided with Logrus. Log rotation should be done by an +external program (like `logrotate(8)`) that can compress and delete old log +entries. It should not be a feature of the application-level logger. + + +[godoc]: https://godoc.org/github.com/Sirupsen/logrus diff --git a/vendor/src/github.com/Sirupsen/logrus/entry.go b/vendor/src/github.com/Sirupsen/logrus/entry.go new file mode 100644 index 0000000000..699ea035cc --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/entry.go @@ -0,0 +1,254 @@ +package logrus + +import ( + "bytes" + "fmt" + "io" + "os" + "time" +) + +// An entry is the final or intermediate Logrus logging entry. It contains all +// the fields passed with WithField{,s}. It's finally logged when Debug, Info, +// Warn, Error, Fatal or Panic is called on it. These objects can be reused and +// passed around as much as you wish to avoid field duplication. +type Entry struct { + Logger *Logger + + // Contains all the fields set by the user. + Data Fields + + // Time at which the log entry was created + Time time.Time + + // Level the log entry was logged at: Debug, Info, Warn, Error, Fatal or Panic + Level Level + + // Message passed to Debug, Info, Warn, Error, Fatal or Panic + Message string +} + +func NewEntry(logger *Logger) *Entry { + return &Entry{ + Logger: logger, + // Default is three fields, give a little extra room + Data: make(Fields, 5), + } +} + +// Returns a reader for the entry, which is a proxy to the formatter. +func (entry *Entry) Reader() (*bytes.Buffer, error) { + serialized, err := entry.Logger.Formatter.Format(entry) + return bytes.NewBuffer(serialized), err +} + +// Returns the string representation from the reader and ultimately the +// formatter. +func (entry *Entry) String() (string, error) { + reader, err := entry.Reader() + if err != nil { + return "", err + } + + return reader.String(), err +} + +// Add a single field to the Entry. +func (entry *Entry) WithField(key string, value interface{}) *Entry { + return entry.WithFields(Fields{key: value}) +} + +// Add a map of fields to the Entry. +func (entry *Entry) WithFields(fields Fields) *Entry { + data := Fields{} + for k, v := range entry.Data { + data[k] = v + } + for k, v := range fields { + data[k] = v + } + return &Entry{Logger: entry.Logger, Data: data} +} + +func (entry *Entry) log(level Level, msg string) { + entry.Time = time.Now() + entry.Level = level + entry.Message = msg + + if err := entry.Logger.Hooks.Fire(level, entry); err != nil { + entry.Logger.mu.Lock() + fmt.Fprintf(os.Stderr, "Failed to fire hook: %v\n", err) + entry.Logger.mu.Unlock() + } + + reader, err := entry.Reader() + if err != nil { + entry.Logger.mu.Lock() + fmt.Fprintf(os.Stderr, "Failed to obtain reader, %v\n", err) + entry.Logger.mu.Unlock() + } + + entry.Logger.mu.Lock() + defer entry.Logger.mu.Unlock() + + _, err = io.Copy(entry.Logger.Out, reader) + if err != nil { + fmt.Fprintf(os.Stderr, "Failed to write to log, %v\n", err) + } + + // To avoid Entry#log() returning a value that only would make sense for + // panic() to use in Entry#Panic(), we avoid the allocation by checking + // directly here. + if level <= PanicLevel { + panic(entry) + } +} + +func (entry *Entry) Debug(args ...interface{}) { + if entry.Logger.Level >= DebugLevel { + entry.log(DebugLevel, fmt.Sprint(args...)) + } +} + +func (entry *Entry) Print(args ...interface{}) { + entry.Info(args...) +} + +func (entry *Entry) Info(args ...interface{}) { + if entry.Logger.Level >= InfoLevel { + entry.log(InfoLevel, fmt.Sprint(args...)) + } +} + +func (entry *Entry) Warn(args ...interface{}) { + if entry.Logger.Level >= WarnLevel { + entry.log(WarnLevel, fmt.Sprint(args...)) + } +} + +func (entry *Entry) Warning(args ...interface{}) { + entry.Warn(args...) +} + +func (entry *Entry) Error(args ...interface{}) { + if entry.Logger.Level >= ErrorLevel { + entry.log(ErrorLevel, fmt.Sprint(args...)) + } +} + +func (entry *Entry) Fatal(args ...interface{}) { + if entry.Logger.Level >= FatalLevel { + entry.log(FatalLevel, fmt.Sprint(args...)) + } + os.Exit(1) +} + +func (entry *Entry) Panic(args ...interface{}) { + if entry.Logger.Level >= PanicLevel { + entry.log(PanicLevel, fmt.Sprint(args...)) + } + panic(fmt.Sprint(args...)) +} + +// Entry Printf family functions + +func (entry *Entry) Debugf(format string, args ...interface{}) { + if entry.Logger.Level >= DebugLevel { + entry.Debug(fmt.Sprintf(format, args...)) + } +} + +func (entry *Entry) Infof(format string, args ...interface{}) { + if entry.Logger.Level >= InfoLevel { + entry.Info(fmt.Sprintf(format, args...)) + } +} + +func (entry *Entry) Printf(format string, args ...interface{}) { + entry.Infof(format, args...) +} + +func (entry *Entry) Warnf(format string, args ...interface{}) { + if entry.Logger.Level >= WarnLevel { + entry.Warn(fmt.Sprintf(format, args...)) + } +} + +func (entry *Entry) Warningf(format string, args ...interface{}) { + entry.Warnf(format, args...) +} + +func (entry *Entry) Errorf(format string, args ...interface{}) { + if entry.Logger.Level >= ErrorLevel { + entry.Error(fmt.Sprintf(format, args...)) + } +} + +func (entry *Entry) Fatalf(format string, args ...interface{}) { + if entry.Logger.Level >= FatalLevel { + entry.Fatal(fmt.Sprintf(format, args...)) + } + os.Exit(1) +} + +func (entry *Entry) Panicf(format string, args ...interface{}) { + if entry.Logger.Level >= PanicLevel { + entry.Panic(fmt.Sprintf(format, args...)) + } +} + +// Entry Println family functions + +func (entry *Entry) Debugln(args ...interface{}) { + if entry.Logger.Level >= DebugLevel { + entry.Debug(entry.sprintlnn(args...)) + } +} + +func (entry *Entry) Infoln(args ...interface{}) { + if entry.Logger.Level >= InfoLevel { + entry.Info(entry.sprintlnn(args...)) + } +} + +func (entry *Entry) Println(args ...interface{}) { + entry.Infoln(args...) +} + +func (entry *Entry) Warnln(args ...interface{}) { + if entry.Logger.Level >= WarnLevel { + entry.Warn(entry.sprintlnn(args...)) + } +} + +func (entry *Entry) Warningln(args ...interface{}) { + entry.Warnln(args...) +} + +func (entry *Entry) Errorln(args ...interface{}) { + if entry.Logger.Level >= ErrorLevel { + entry.Error(entry.sprintlnn(args...)) + } +} + +func (entry *Entry) Fatalln(args ...interface{}) { + if entry.Logger.Level >= FatalLevel { + entry.Fatal(entry.sprintlnn(args...)) + } + os.Exit(1) +} + +func (entry *Entry) Panicln(args ...interface{}) { + if entry.Logger.Level >= PanicLevel { + entry.Panic(entry.sprintlnn(args...)) + } +} + +// Sprintlnn => Sprint no newline. This is to get the behavior of how +// fmt.Sprintln where spaces are always added between operands, regardless of +// their type. Instead of vendoring the Sprintln implementation to spare a +// string allocation, we do the simplest thing. +func (entry *Entry) sprintlnn(args ...interface{}) string { + msg := fmt.Sprintln(args...) + return msg[:len(msg)-1] +} diff --git a/vendor/src/github.com/Sirupsen/logrus/exported.go b/vendor/src/github.com/Sirupsen/logrus/exported.go new file mode 100644 index 0000000000..a67e1b802d --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/exported.go @@ -0,0 +1,188 @@ +package logrus + +import ( + "io" +) + +var ( + // std is the name of the standard logger in stdlib `log` + std = New() +) + +func StandardLogger() *Logger { + return std +} + +// SetOutput sets the standard logger output. +func SetOutput(out io.Writer) { + std.mu.Lock() + defer std.mu.Unlock() + std.Out = out +} + +// SetFormatter sets the standard logger formatter. +func SetFormatter(formatter Formatter) { + std.mu.Lock() + defer std.mu.Unlock() + std.Formatter = formatter +} + +// SetLevel sets the standard logger level. +func SetLevel(level Level) { + std.mu.Lock() + defer std.mu.Unlock() + std.Level = level +} + +// GetLevel returns the standard logger level. +func GetLevel() Level { + std.mu.Lock() + defer std.mu.Unlock() + return std.Level +} + +// AddHook adds a hook to the standard logger hooks. +func AddHook(hook Hook) { + std.mu.Lock() + defer std.mu.Unlock() + std.Hooks.Add(hook) +} + +// WithField creates an entry from the standard logger and adds a field to +// it. If you want multiple fields, use `WithFields`. +// +// Note that it doesn't log until you call Debug, Print, Info, Warn, Fatal +// or Panic on the Entry it returns. +func WithField(key string, value interface{}) *Entry { + return std.WithField(key, value) +} + +// WithFields creates an entry from the standard logger and adds multiple +// fields to it. This is simply a helper for `WithField`, invoking it +// once for each field. +// +// Note that it doesn't log until you call Debug, Print, Info, Warn, Fatal +// or Panic on the Entry it returns. +func WithFields(fields Fields) *Entry { + return std.WithFields(fields) +} + +// Debug logs a message at level Debug on the standard logger. +func Debug(args ...interface{}) { + std.Debug(args...) +} + +// Print logs a message at level Info on the standard logger. +func Print(args ...interface{}) { + std.Print(args...) +} + +// Info logs a message at level Info on the standard logger. +func Info(args ...interface{}) { + std.Info(args...) +} + +// Warn logs a message at level Warn on the standard logger. +func Warn(args ...interface{}) { + std.Warn(args...) +} + +// Warning logs a message at level Warn on the standard logger. +func Warning(args ...interface{}) { + std.Warning(args...) +} + +// Error logs a message at level Error on the standard logger. +func Error(args ...interface{}) { + std.Error(args...) +} + +// Panic logs a message at level Panic on the standard logger. +func Panic(args ...interface{}) { + std.Panic(args...) +} + +// Fatal logs a message at level Fatal on the standard logger. +func Fatal(args ...interface{}) { + std.Fatal(args...) +} + +// Debugf logs a message at level Debug on the standard logger. +func Debugf(format string, args ...interface{}) { + std.Debugf(format, args...) +} + +// Printf logs a message at level Info on the standard logger. +func Printf(format string, args ...interface{}) { + std.Printf(format, args...) +} + +// Infof logs a message at level Info on the standard logger. +func Infof(format string, args ...interface{}) { + std.Infof(format, args...) +} + +// Warnf logs a message at level Warn on the standard logger. +func Warnf(format string, args ...interface{}) { + std.Warnf(format, args...) +} + +// Warningf logs a message at level Warn on the standard logger. +func Warningf(format string, args ...interface{}) { + std.Warningf(format, args...) +} + +// Errorf logs a message at level Error on the standard logger. +func Errorf(format string, args ...interface{}) { + std.Errorf(format, args...) +} + +// Panicf logs a message at level Panic on the standard logger. +func Panicf(format string, args ...interface{}) { + std.Panicf(format, args...) +} + +// Fatalf logs a message at level Fatal on the standard logger. +func Fatalf(format string, args ...interface{}) { + std.Fatalf(format, args...) +} + +// Debugln logs a message at level Debug on the standard logger. +func Debugln(args ...interface{}) { + std.Debugln(args...) +} + +// Println logs a message at level Info on the standard logger. +func Println(args ...interface{}) { + std.Println(args...) +} + +// Infoln logs a message at level Info on the standard logger. +func Infoln(args ...interface{}) { + std.Infoln(args...) +} + +// Warnln logs a message at level Warn on the standard logger. +func Warnln(args ...interface{}) { + std.Warnln(args...) +} + +// Warningln logs a message at level Warn on the standard logger. +func Warningln(args ...interface{}) { + std.Warningln(args...) +} + +// Errorln logs a message at level Error on the standard logger. +func Errorln(args ...interface{}) { + std.Errorln(args...) +} + +// Panicln logs a message at level Panic on the standard logger. +func Panicln(args ...interface{}) { + std.Panicln(args...) +} + +// Fatalln logs a message at level Fatal on the standard logger. +func Fatalln(args ...interface{}) { + std.Fatalln(args...) +} diff --git a/vendor/src/github.com/Sirupsen/logrus/formatter.go b/vendor/src/github.com/Sirupsen/logrus/formatter.go new file mode 100644 index 0000000000..104d689f18 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/formatter.go @@ -0,0 +1,48 @@ +package logrus + +import "time" + +const DefaultTimestampFormat = time.RFC3339 + +// The Formatter interface is used to implement a custom Formatter. It takes an +// `Entry`. It exposes all the fields, including the default ones: +// +// * `entry.Data["msg"]`. The message passed from Info, Warn, Error .. +// * `entry.Data["time"]`. The timestamp. +// * `entry.Data["level"]. The level the entry was logged at. +// +// Any additional fields added with `WithField` or `WithFields` are also in +// `entry.Data`. Format is expected to return an array of bytes which are then +// logged to `logger.Out`. +type Formatter interface { + Format(*Entry) ([]byte, error) +} + +// This is to not silently overwrite `time`, `msg` and `level` fields when +// dumping it. If this code wasn't there doing: +// +// logrus.WithField("level", 1).Info("hello") +// +// Would just silently drop the user provided level. Instead with this code +// it'll logged as: +// +// {"level": "info", "fields.level": 1, "msg": "hello", "time": "..."} +// +// It's not exported because it's still using Data in an opinionated way. It's to +// avoid code duplication between the two default formatters. +func prefixFieldClashes(data Fields) { + _, ok := data["time"] + if ok { + data["fields.time"] = data["time"] + } + + _, ok = data["msg"] + if ok { + data["fields.msg"] = data["msg"] + } + + _, ok = data["level"] + if ok { + data["fields.level"] = data["level"] + } +} diff --git a/vendor/src/github.com/Sirupsen/logrus/hooks.go b/vendor/src/github.com/Sirupsen/logrus/hooks.go new file mode 100644 index 0000000000..0da2b3653f --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/hooks.go @@ -0,0 +1,34 @@ +package logrus + +// A hook to be fired when logging on the logging levels returned from +// `Levels()` on your implementation of the interface. Note that this is not +// fired in a goroutine or a channel with workers, you should handle such +// functionality yourself if your call is non-blocking and you don't wish for +// the logging calls for levels returned from `Levels()` to block. +type Hook interface { + Levels() []Level + Fire(*Entry) error +} + +// Internal type for storing the hooks on a logger instance. +type levelHooks map[Level][]Hook + +// Add a hook to an instance of logger. This is called with +// `log.Hooks.Add(new(MyHook))` where `MyHook` implements the `Hook` interface. +func (hooks levelHooks) Add(hook Hook) { + for _, level := range hook.Levels() { + hooks[level] = append(hooks[level], hook) + } +} + +// Fire all the hooks for the passed level. Used by `entry.log` to fire +// appropriate hooks for a log entry. +func (hooks levelHooks) Fire(level Level, entry *Entry) error { + for _, hook := range hooks[level] { + if err := hook.Fire(entry); err != nil { + return err + } + } + + return nil +} diff --git a/vendor/src/github.com/Sirupsen/logrus/json_formatter.go b/vendor/src/github.com/Sirupsen/logrus/json_formatter.go new file mode 100644 index 0000000000..2ad6dc5cf4 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/json_formatter.go @@ -0,0 +1,41 @@ +package logrus + +import ( + "encoding/json" + "fmt" +) + +type JSONFormatter struct { + // TimestampFormat sets the format used for marshaling timestamps. + TimestampFormat string +} + +func (f *JSONFormatter) Format(entry *Entry) ([]byte, error) { + data := make(Fields, len(entry.Data)+3) + for k, v := range entry.Data { + switch v := v.(type) { + case error: + // Otherwise errors are ignored by `encoding/json` + // https://github.com/Sirupsen/logrus/issues/137 + data[k] = v.Error() + default: + data[k] = v + } + } + prefixFieldClashes(data) + + timestampFormat := f.TimestampFormat + if timestampFormat == "" { + timestampFormat = DefaultTimestampFormat + } + + data["time"] = entry.Time.Format(timestampFormat) + data["msg"] = entry.Message + data["level"] = entry.Level.String() + + serialized, err := json.Marshal(data) + if err != nil { + return nil, fmt.Errorf("Failed to marshal fields to JSON, %v", err) + } + return append(serialized, '\n'), nil +} diff --git a/vendor/src/github.com/Sirupsen/logrus/logger.go b/vendor/src/github.com/Sirupsen/logrus/logger.go new file mode 100644 index 0000000000..292b0b2c07 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/logger.go @@ -0,0 +1,206 @@ +package logrus + +import ( + "io" + "os" + "sync" +) + +type Logger struct { + // The logs are `io.Copy`'d to this in a mutex. It's common to set this to a + // file, or leave it default which is `os.Stdout`. You can also set this to + // something more adventorous, such as logging to Kafka. + Out io.Writer + // Hooks for the logger instance. These allow firing events based on logging + // levels and log entries. For example, to send errors to an error tracking + // service, log to StatsD or dump the core on fatal errors. + Hooks levelHooks + // All log entries pass through the formatter before logged to Out. The + // included formatters are `TextFormatter` and `JSONFormatter` for which + // TextFormatter is the default. In development (when a TTY is attached) it + // logs with colors, but to a file it wouldn't. You can easily implement your + // own that implements the `Formatter` interface, see the `README` or included + // formatters for examples. + Formatter Formatter + // The logging level the logger should log at. This is typically (and defaults + // to) `logrus.Info`, which allows Info(), Warn(), Error() and Fatal() to be + // logged. `logrus.Debug` is useful in + Level Level + // Used to sync writing to the log. + mu sync.Mutex +} + +// Creates a new logger. Configuration should be set by changing `Formatter`, +// `Out` and `Hooks` directly on the default logger instance. You can also just +// instantiate your own: +// +// var log = &Logger{ +// Out: os.Stderr, +// Formatter: new(JSONFormatter), +// Hooks: make(levelHooks), +// Level: logrus.DebugLevel, +// } +// +// It's recommended to make this a global instance called `log`. +func New() *Logger { + return &Logger{ + Out: os.Stderr, + Formatter: new(TextFormatter), + Hooks: make(levelHooks), + Level: InfoLevel, + } +} + +// Adds a field to the log entry, note that you it doesn't log until you call +// Debug, Print, Info, Warn, Fatal or Panic. It only creates a log entry. +// Ff you want multiple fields, use `WithFields`. +func (logger *Logger) WithField(key string, value interface{}) *Entry { + return NewEntry(logger).WithField(key, value) +} + +// Adds a struct of fields to the log entry. All it does is call `WithField` for +// each `Field`. +func (logger *Logger) WithFields(fields Fields) *Entry { + return NewEntry(logger).WithFields(fields) +} + +func (logger *Logger) Debugf(format string, args ...interface{}) { + if logger.Level >= DebugLevel { + NewEntry(logger).Debugf(format, args...) + } +} + +func (logger *Logger) Infof(format string, args ...interface{}) { + if logger.Level >= InfoLevel { + NewEntry(logger).Infof(format, args...) + } +} + +func (logger *Logger) Printf(format string, args ...interface{}) { + NewEntry(logger).Printf(format, args...) +} + +func (logger *Logger) Warnf(format string, args ...interface{}) { + if logger.Level >= WarnLevel { + NewEntry(logger).Warnf(format, args...) + } +} + +func (logger *Logger) Warningf(format string, args ...interface{}) { + if logger.Level >= WarnLevel { + NewEntry(logger).Warnf(format, args...) + } +} + +func (logger *Logger) Errorf(format string, args ...interface{}) { + if logger.Level >= ErrorLevel { + NewEntry(logger).Errorf(format, args...) + } +} + +func (logger *Logger) Fatalf(format string, args ...interface{}) { + if logger.Level >= FatalLevel { + NewEntry(logger).Fatalf(format, args...) + } + os.Exit(1) +} + +func (logger *Logger) Panicf(format string, args ...interface{}) { + if logger.Level >= PanicLevel { + NewEntry(logger).Panicf(format, args...) + } +} + +func (logger *Logger) Debug(args ...interface{}) { + if logger.Level >= DebugLevel { + NewEntry(logger).Debug(args...) + } +} + +func (logger *Logger) Info(args ...interface{}) { + if logger.Level >= InfoLevel { + NewEntry(logger).Info(args...) + } +} + +func (logger *Logger) Print(args ...interface{}) { + NewEntry(logger).Info(args...) +} + +func (logger *Logger) Warn(args ...interface{}) { + if logger.Level >= WarnLevel { + NewEntry(logger).Warn(args...) + } +} + +func (logger *Logger) Warning(args ...interface{}) { + if logger.Level >= WarnLevel { + NewEntry(logger).Warn(args...) + } +} + +func (logger *Logger) Error(args ...interface{}) { + if logger.Level >= ErrorLevel { + NewEntry(logger).Error(args...) + } +} + +func (logger *Logger) Fatal(args ...interface{}) { + if logger.Level >= FatalLevel { + NewEntry(logger).Fatal(args...) + } + os.Exit(1) +} + +func (logger *Logger) Panic(args ...interface{}) { + if logger.Level >= PanicLevel { + NewEntry(logger).Panic(args...) + } +} + +func (logger *Logger) Debugln(args ...interface{}) { + if logger.Level >= DebugLevel { + NewEntry(logger).Debugln(args...) + } +} + +func (logger *Logger) Infoln(args ...interface{}) { + if logger.Level >= InfoLevel { + NewEntry(logger).Infoln(args...) + } +} + +func (logger *Logger) Println(args ...interface{}) { + NewEntry(logger).Println(args...) +} + +func (logger *Logger) Warnln(args ...interface{}) { + if logger.Level >= WarnLevel { + NewEntry(logger).Warnln(args...) + } +} + +func (logger *Logger) Warningln(args ...interface{}) { + if logger.Level >= WarnLevel { + NewEntry(logger).Warnln(args...) + } +} + +func (logger *Logger) Errorln(args ...interface{}) { + if logger.Level >= ErrorLevel { + NewEntry(logger).Errorln(args...) + } +} + +func (logger *Logger) Fatalln(args ...interface{}) { + if logger.Level >= FatalLevel { + NewEntry(logger).Fatalln(args...) + } + os.Exit(1) +} + +func (logger *Logger) Panicln(args ...interface{}) { + if logger.Level >= PanicLevel { + NewEntry(logger).Panicln(args...) + } +} diff --git a/vendor/src/github.com/Sirupsen/logrus/logrus.go b/vendor/src/github.com/Sirupsen/logrus/logrus.go new file mode 100644 index 0000000000..43ee12e90e --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/logrus.go @@ -0,0 +1,94 @@ +package logrus + +import ( + "fmt" + "log" +) + +// Fields type, used to pass to `WithFields`. +type Fields map[string]interface{} + +// Level type +type Level uint8 + +// Convert the Level to a string. E.g. PanicLevel becomes "panic". +func (level Level) String() string { + switch level { + case DebugLevel: + return "debug" + case InfoLevel: + return "info" + case WarnLevel: + return "warning" + case ErrorLevel: + return "error" + case FatalLevel: + return "fatal" + case PanicLevel: + return "panic" + } + + return "unknown" +} + +// ParseLevel takes a string level and returns the Logrus log level constant. +func ParseLevel(lvl string) (Level, error) { + switch lvl { + case "panic": + return PanicLevel, nil + case "fatal": + return FatalLevel, nil + case "error": + return ErrorLevel, nil + case "warn", "warning": + return WarnLevel, nil + case "info": + return InfoLevel, nil + case "debug": + return DebugLevel, nil + } + + var l Level + return l, fmt.Errorf("not a valid logrus Level: %q", lvl) +} + +// These are the different logging levels. You can set the logging level to log +// on your instance of logger, obtained with `logrus.New()`. +const ( + // PanicLevel level, highest level of severity. Logs and then calls panic with the + // message passed to Debug, Info, ... + PanicLevel Level = iota + // FatalLevel level. Logs and then calls `os.Exit(1)`. It will exit even if the + // logging level is set to Panic. + FatalLevel + // ErrorLevel level. Logs. Used for errors that should definitely be noted. + // Commonly used for hooks to send errors to an error tracking service. + ErrorLevel + // WarnLevel level. Non-critical entries that deserve eyes. + WarnLevel + // InfoLevel level. General operational entries about what's going on inside the + // application. + InfoLevel + // DebugLevel level. Usually only enabled when debugging. Very verbose logging. + DebugLevel +) + +// Won't compile if StdLogger can't be realized by a log.Logger +var _ StdLogger = &log.Logger{} + +// StdLogger is what your logrus-enabled library should take, that way +// it'll accept a stdlib logger and a logrus logger. There's no standard +// interface, this is the closest we get, unfortunately. +type StdLogger interface { + Print(...interface{}) + Printf(string, ...interface{}) + Println(...interface{}) + + Fatal(...interface{}) + Fatalf(string, ...interface{}) + Fatalln(...interface{}) + + Panic(...interface{}) + Panicf(string, ...interface{}) + Panicln(...interface{}) +} diff --git a/vendor/src/github.com/Sirupsen/logrus/terminal_darwin.go b/vendor/src/github.com/Sirupsen/logrus/terminal_darwin.go new file mode 100644 index 0000000000..8fe02a4aec --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/terminal_darwin.go @@ -0,0 +1,12 @@ +// Based on ssh/terminal: +// Copyright 2013 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package logrus + +import "syscall" + +const ioctlReadTermios = syscall.TIOCGETA + +type Termios syscall.Termios diff --git a/vendor/src/github.com/Sirupsen/logrus/terminal_freebsd.go b/vendor/src/github.com/Sirupsen/logrus/terminal_freebsd.go new file mode 100644 index 0000000000..0428ee5d52 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/terminal_freebsd.go @@ -0,0 +1,20 @@ +/* + Go 1.2 doesn't include Termios for FreeBSD. This should be added in 1.3 and this could be merged with terminal_darwin. +*/ +package logrus + +import ( + "syscall" +) + +const ioctlReadTermios = syscall.TIOCGETA + +type Termios struct { + Iflag uint32 + Oflag uint32 + Cflag uint32 + Lflag uint32 + Cc [20]uint8 + Ispeed uint32 + Ospeed uint32 +} diff --git a/vendor/src/github.com/Sirupsen/logrus/terminal_linux.go b/vendor/src/github.com/Sirupsen/logrus/terminal_linux.go new file mode 100644 index 0000000000..a2c0b40db6 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/terminal_linux.go @@ -0,0 +1,12 @@ +// Based on ssh/terminal: +// Copyright 2013 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package logrus + +import "syscall" + +const ioctlReadTermios = syscall.TCGETS + +type Termios syscall.Termios diff --git a/vendor/src/github.com/Sirupsen/logrus/terminal_notwindows.go b/vendor/src/github.com/Sirupsen/logrus/terminal_notwindows.go new file mode 100644 index 0000000000..b8bebc13ee --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/terminal_notwindows.go @@ -0,0 +1,21 @@ +// Based on ssh/terminal: +// Copyright 2011 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// +build linux darwin freebsd openbsd + +package logrus + +import ( + "syscall" + "unsafe" +) + +// IsTerminal returns true if the given file descriptor is a terminal. +func IsTerminal() bool { + fd := syscall.Stdout + var termios Termios + _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlReadTermios, uintptr(unsafe.Pointer(&termios)), 0, 0, 0) + return err == 0 +} diff --git a/vendor/src/github.com/Sirupsen/logrus/terminal_openbsd.go b/vendor/src/github.com/Sirupsen/logrus/terminal_openbsd.go new file mode 100644 index 0000000000..af609a53d6 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/terminal_openbsd.go @@ -0,0 +1,7 @@ +package logrus + +import "syscall" + +const ioctlReadTermios = syscall.TIOCGETA + +type Termios syscall.Termios diff --git a/vendor/src/github.com/Sirupsen/logrus/terminal_windows.go b/vendor/src/github.com/Sirupsen/logrus/terminal_windows.go new file mode 100644 index 0000000000..2e09f6f7e3 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/terminal_windows.go @@ -0,0 +1,27 @@ +// Based on ssh/terminal: +// Copyright 2011 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// +build windows + +package logrus + +import ( + "syscall" + "unsafe" +) + +var kernel32 = syscall.NewLazyDLL("kernel32.dll") + +var ( + procGetConsoleMode = kernel32.NewProc("GetConsoleMode") +) + +// IsTerminal returns true if the given file descriptor is a terminal. +func IsTerminal() bool { + fd := syscall.Stdout + var st uint32 + r, _, e := syscall.Syscall(procGetConsoleMode.Addr(), 2, uintptr(fd), uintptr(unsafe.Pointer(&st)), 0) + return r != 0 && e == 0 +} diff --git a/vendor/src/github.com/Sirupsen/logrus/text_formatter.go b/vendor/src/github.com/Sirupsen/logrus/text_formatter.go new file mode 100644 index 0000000000..4ed90e1e52 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/text_formatter.go @@ -0,0 +1,151 @@ +package logrus + +import ( + "bytes" + "fmt" + "runtime" + "sort" + "strings" + "time" +) + +const ( + nocolor = 0 + red = 31 + green = 32 + yellow = 33 + blue = 34 + gray = 37 +) + +var ( + baseTimestamp time.Time + isTerminal bool +) + +func init() { + baseTimestamp = time.Now() + isTerminal = IsTerminal() +} + +func miniTS() int { + return int(time.Since(baseTimestamp) / time.Second) +} + +type TextFormatter struct { + // Set to true to bypass checking for a TTY before outputting colors. + ForceColors bool + + // Force disabling colors. + DisableColors bool + + // Disable timestamp logging. useful when output is redirected to logging + // system that already adds timestamps. + DisableTimestamp bool + + // Enable logging the full timestamp when a TTY is attached instead of just + // the time passed since beginning of execution. + FullTimestamp bool + + // TimestampFormat to use for display when a full timestamp is printed + TimestampFormat string + + // The fields are sorted by default for a consistent output. For applications + // that log extremely frequently and don't use the JSON formatter this may not + // be desired. + DisableSorting bool +} + +func (f *TextFormatter) Format(entry *Entry) ([]byte, error) { + var keys []string = make([]string, 0, len(entry.Data)) + for k := range entry.Data { + keys = append(keys, k) + } + + if !f.DisableSorting { + sort.Strings(keys) + } + + b := &bytes.Buffer{} + + prefixFieldClashes(entry.Data) + + isColorTerminal := isTerminal && (runtime.GOOS != "windows") + isColored := (f.ForceColors || isColorTerminal) && !f.DisableColors + + if f.TimestampFormat == "" { + f.TimestampFormat = DefaultTimestampFormat + } + if isColored { + f.printColored(b, entry, keys) + } else { + if !f.DisableTimestamp { + f.appendKeyValue(b, "time", entry.Time.Format(f.TimestampFormat)) + } + f.appendKeyValue(b, "level", entry.Level.String()) + f.appendKeyValue(b, "msg", entry.Message) + for _, key := range keys { + f.appendKeyValue(b, key, entry.Data[key]) + } + } + + b.WriteByte('\n') + return b.Bytes(), nil +} + +func (f *TextFormatter) printColored(b *bytes.Buffer, entry *Entry, keys []string) { + var levelColor int + switch entry.Level { + case DebugLevel: + levelColor = gray + case WarnLevel: + levelColor = yellow + case ErrorLevel, FatalLevel, PanicLevel: + levelColor = red + default: + levelColor = blue + } + + levelText := strings.ToUpper(entry.Level.String())[0:4] + + if !f.FullTimestamp { + fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m[%04d] %-44s ", levelColor, levelText, miniTS(), entry.Message) + } else { + fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m[%s] %-44s ", levelColor, levelText, entry.Time.Format(f.TimestampFormat), entry.Message) + } + for _, k := range keys { + v := entry.Data[k] + fmt.Fprintf(b, " \x1b[%dm%s\x1b[0m=%v", levelColor, k, v) + } +} + +func needsQuoting(text string) bool { + for _, ch := range text { + if !((ch >= 'a' && ch <= 'z') || + (ch >= 'A' && ch <= 'Z') || + (ch >= '0' && ch <= '9') || + ch == '-' || ch == '.') { + return false + } + } + return true +} + +func (f *TextFormatter) appendKeyValue(b *bytes.Buffer, key, value interface{}) { + switch value.(type) { + case string: + if needsQuoting(value.(string)) { + fmt.Fprintf(b, "%v=%s ", key, value) + } else { + fmt.Fprintf(b, "%v=%q ", key, value) + } + case error: + if needsQuoting(value.(error).Error()) { + fmt.Fprintf(b, "%v=%s ", key, value) + } else { + fmt.Fprintf(b, "%v=%q ", key, value) + } + default: + fmt.Fprintf(b, "%v=%v ", key, value) + } +} diff --git a/vendor/src/github.com/Sirupsen/logrus/writer.go b/vendor/src/github.com/Sirupsen/logrus/writer.go new file mode 100644 index 0000000000..1e30b1c753 --- /dev/null +++ b/vendor/src/github.com/Sirupsen/logrus/writer.go @@ -0,0 +1,31 @@ +package logrus + +import ( + "bufio" + "io" + "runtime" +) + +func (logger *Logger) Writer() *io.PipeWriter { + reader, writer := io.Pipe() + + go logger.writerScanner(reader) + runtime.SetFinalizer(writer, writerFinalizer) + + return writer +} + +func (logger *Logger) writerScanner(reader *io.PipeReader) { + scanner := bufio.NewScanner(reader) + for scanner.Scan() { + logger.Print(scanner.Text()) + } + if err := scanner.Err(); err != nil { + logger.Errorf("Error while reading from Writer: %s", err) + } + reader.Close() +} + +func writerFinalizer(writer *io.PipeWriter) { + writer.Close() +} diff --git a/vendor/src/github.com/agl/ed25519/LICENSE b/vendor/src/github.com/agl/ed25519/LICENSE new file mode 100644 index 0000000000..7448756763 --- /dev/null +++ b/vendor/src/github.com/agl/ed25519/LICENSE @@ -0,0 +1,27 @@ +Copyright (c) 2012 The Go Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/agl/ed25519/ed25519.go b/vendor/src/github.com/agl/ed25519/ed25519.go new file mode 100644 index 0000000000..700938ddda --- /dev/null +++ b/vendor/src/github.com/agl/ed25519/ed25519.go @@ -0,0 +1,125 @@ +// Copyright 2013 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Package ed25519 implements the Ed25519 signature algorithm. See +// http://ed25519.cr.yp.to/. +package ed25519 + +// This code is a port of the public domain, "ref10" implementation of ed25519 +// from SUPERCOP. + +import ( + "crypto/sha512" + "crypto/subtle" + "io" + + "github.com/agl/ed25519/edwards25519" +) + +const ( + PublicKeySize = 32 + PrivateKeySize = 64 + SignatureSize = 64 +) + +// GenerateKey generates a public/private key pair using randomness from rand. +func GenerateKey(rand io.Reader) (publicKey *[PublicKeySize]byte, privateKey *[PrivateKeySize]byte, err error) { + privateKey = new([64]byte) + publicKey = new([32]byte) + _, err = io.ReadFull(rand, privateKey[:32]) + if err != nil { + return nil, nil, err + } + + h := sha512.New() + h.Write(privateKey[:32]) + digest := h.Sum(nil) + + digest[0] &= 248 + digest[31] &= 127 + digest[31] |= 64 + + var A edwards25519.ExtendedGroupElement + var hBytes [32]byte + copy(hBytes[:], digest) + edwards25519.GeScalarMultBase(&A, &hBytes) + A.ToBytes(publicKey) + + copy(privateKey[32:], publicKey[:]) + return +} + +// Sign signs the message with privateKey and returns a signature. +func Sign(privateKey *[PrivateKeySize]byte, message []byte) *[SignatureSize]byte { + h := sha512.New() + h.Write(privateKey[:32]) + + var digest1, messageDigest, hramDigest [64]byte + var expandedSecretKey [32]byte + h.Sum(digest1[:0]) + copy(expandedSecretKey[:], digest1[:]) + expandedSecretKey[0] &= 248 + expandedSecretKey[31] &= 63 + expandedSecretKey[31] |= 64 + + h.Reset() + h.Write(digest1[32:]) + h.Write(message) + h.Sum(messageDigest[:0]) + + var messageDigestReduced [32]byte + edwards25519.ScReduce(&messageDigestReduced, &messageDigest) + var R edwards25519.ExtendedGroupElement + edwards25519.GeScalarMultBase(&R, &messageDigestReduced) + + var encodedR [32]byte + R.ToBytes(&encodedR) + + h.Reset() + h.Write(encodedR[:]) + h.Write(privateKey[32:]) + h.Write(message) + h.Sum(hramDigest[:0]) + var hramDigestReduced [32]byte + edwards25519.ScReduce(&hramDigestReduced, &hramDigest) + + var s [32]byte + edwards25519.ScMulAdd(&s, &hramDigestReduced, &expandedSecretKey, &messageDigestReduced) + + signature := new([64]byte) + copy(signature[:], encodedR[:]) + copy(signature[32:], s[:]) + return signature +} + +// Verify returns true iff sig is a valid signature of message by publicKey. +func Verify(publicKey *[PublicKeySize]byte, message []byte, sig *[SignatureSize]byte) bool { + if sig[63]&224 != 0 { + return false + } + + var A edwards25519.ExtendedGroupElement + if !A.FromBytes(publicKey) { + return false + } + + h := sha512.New() + h.Write(sig[:32]) + h.Write(publicKey[:]) + h.Write(message) + var digest [64]byte + h.Sum(digest[:0]) + + var hReduced [32]byte + edwards25519.ScReduce(&hReduced, &digest) + + var R edwards25519.ProjectiveGroupElement + var b [32]byte + copy(b[:], sig[32:]) + edwards25519.GeDoubleScalarMultVartime(&R, &hReduced, &A, &b) + + var checkR [32]byte + R.ToBytes(&checkR) + return subtle.ConstantTimeCompare(sig[:32], checkR[:]) == 1 +} diff --git a/vendor/src/github.com/agl/ed25519/edwards25519/const.go b/vendor/src/github.com/agl/ed25519/edwards25519/const.go new file mode 100644 index 0000000000..ea5b77a710 --- /dev/null +++ b/vendor/src/github.com/agl/ed25519/edwards25519/const.go @@ -0,0 +1,1411 @@ +// Copyright 2013 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package edwards25519 + +var d = FieldElement{ + -10913610, 13857413, -15372611, 6949391, 114729, -8787816, -6275908, -3247719, -18696448, -12055116, +} + +var d2 = FieldElement{ + -21827239, -5839606, -30745221, 13898782, 229458, 15978800, -12551817, -6495438, 29715968, 9444199, +} + +var SqrtM1 = FieldElement{ + -32595792, -7943725, 9377950, 3500415, 12389472, -272473, -25146209, -2005654, 326686, 11406482, +} + +var A = FieldElement{ + 486662, 0, 0, 0, 0, 0, 0, 0, 0, 0, +} + +var bi = [8]PreComputedGroupElement{ + { + FieldElement{25967493, -14356035, 29566456, 3660896, -12694345, 4014787, 27544626, -11754271, -6079156, 2047605}, + FieldElement{-12545711, 934262, -2722910, 3049990, -727428, 9406986, 12720692, 5043384, 19500929, -15469378}, + FieldElement{-8738181, 4489570, 9688441, -14785194, 10184609, -12363380, 29287919, 11864899, -24514362, -4438546}, + }, + { + FieldElement{15636291, -9688557, 24204773, -7912398, 616977, -16685262, 27787600, -14772189, 28944400, -1550024}, + FieldElement{16568933, 4717097, -11556148, -1102322, 15682896, -11807043, 16354577, -11775962, 7689662, 11199574}, + FieldElement{30464156, -5976125, -11779434, -15670865, 23220365, 15915852, 7512774, 10017326, -17749093, -9920357}, + }, + { + FieldElement{10861363, 11473154, 27284546, 1981175, -30064349, 12577861, 32867885, 14515107, -15438304, 10819380}, + FieldElement{4708026, 6336745, 20377586, 9066809, -11272109, 6594696, -25653668, 12483688, -12668491, 5581306}, + FieldElement{19563160, 16186464, -29386857, 4097519, 10237984, -4348115, 28542350, 13850243, -23678021, -15815942}, + }, + { + FieldElement{5153746, 9909285, 1723747, -2777874, 30523605, 5516873, 19480852, 5230134, -23952439, -15175766}, + FieldElement{-30269007, -3463509, 7665486, 10083793, 28475525, 1649722, 20654025, 16520125, 30598449, 7715701}, + FieldElement{28881845, 14381568, 9657904, 3680757, -20181635, 7843316, -31400660, 1370708, 29794553, -1409300}, + }, + { + FieldElement{-22518993, -6692182, 14201702, -8745502, -23510406, 8844726, 18474211, -1361450, -13062696, 13821877}, + FieldElement{-6455177, -7839871, 3374702, -4740862, -27098617, -10571707, 31655028, -7212327, 18853322, -14220951}, + FieldElement{4566830, -12963868, -28974889, -12240689, -7602672, -2830569, -8514358, -10431137, 2207753, -3209784}, + }, + { + FieldElement{-25154831, -4185821, 29681144, 7868801, -6854661, -9423865, -12437364, -663000, -31111463, -16132436}, + FieldElement{25576264, -2703214, 7349804, -11814844, 16472782, 9300885, 3844789, 15725684, 171356, 6466918}, + FieldElement{23103977, 13316479, 9739013, -16149481, 817875, -15038942, 8965339, -14088058, -30714912, 16193877}, + }, + { + FieldElement{-33521811, 3180713, -2394130, 14003687, -16903474, -16270840, 17238398, 4729455, -18074513, 9256800}, + FieldElement{-25182317, -4174131, 32336398, 5036987, -21236817, 11360617, 22616405, 9761698, -19827198, 630305}, + FieldElement{-13720693, 2639453, -24237460, -7406481, 9494427, -5774029, -6554551, -15960994, -2449256, -14291300}, + }, + { + FieldElement{-3151181, -5046075, 9282714, 6866145, -31907062, -863023, -18940575, 15033784, 25105118, -7894876}, + FieldElement{-24326370, 15950226, -31801215, -14592823, -11662737, -5090925, 1573892, -2625887, 2198790, -15804619}, + FieldElement{-3099351, 10324967, -2241613, 7453183, -5446979, -2735503, -13812022, -16236442, -32461234, -12290683}, + }, +} + +var base = [32][8]PreComputedGroupElement{ + { + { + FieldElement{25967493, -14356035, 29566456, 3660896, -12694345, 4014787, 27544626, -11754271, -6079156, 2047605}, + FieldElement{-12545711, 934262, -2722910, 3049990, -727428, 9406986, 12720692, 5043384, 19500929, -15469378}, + FieldElement{-8738181, 4489570, 9688441, -14785194, 10184609, -12363380, 29287919, 11864899, -24514362, -4438546}, + }, + { + FieldElement{-12815894, -12976347, -21581243, 11784320, -25355658, -2750717, -11717903, -3814571, -358445, -10211303}, + FieldElement{-21703237, 6903825, 27185491, 6451973, -29577724, -9554005, -15616551, 11189268, -26829678, -5319081}, + FieldElement{26966642, 11152617, 32442495, 15396054, 14353839, -12752335, -3128826, -9541118, -15472047, -4166697}, + }, + { + FieldElement{15636291, -9688557, 24204773, -7912398, 616977, -16685262, 27787600, -14772189, 28944400, -1550024}, + FieldElement{16568933, 4717097, -11556148, -1102322, 15682896, -11807043, 16354577, -11775962, 7689662, 11199574}, + FieldElement{30464156, -5976125, -11779434, -15670865, 23220365, 15915852, 7512774, 10017326, -17749093, -9920357}, + }, + { + FieldElement{-17036878, 13921892, 10945806, -6033431, 27105052, -16084379, -28926210, 15006023, 3284568, -6276540}, + FieldElement{23599295, -8306047, -11193664, -7687416, 13236774, 10506355, 7464579, 9656445, 13059162, 10374397}, + FieldElement{7798556, 16710257, 3033922, 2874086, 28997861, 2835604, 32406664, -3839045, -641708, -101325}, + }, + { + FieldElement{10861363, 11473154, 27284546, 1981175, -30064349, 12577861, 32867885, 14515107, -15438304, 10819380}, + FieldElement{4708026, 6336745, 20377586, 9066809, -11272109, 6594696, -25653668, 12483688, -12668491, 5581306}, + FieldElement{19563160, 16186464, -29386857, 4097519, 10237984, -4348115, 28542350, 13850243, -23678021, -15815942}, + }, + { + FieldElement{-15371964, -12862754, 32573250, 4720197, -26436522, 5875511, -19188627, -15224819, -9818940, -12085777}, + FieldElement{-8549212, 109983, 15149363, 2178705, 22900618, 4543417, 3044240, -15689887, 1762328, 14866737}, + FieldElement{-18199695, -15951423, -10473290, 1707278, -17185920, 3916101, -28236412, 3959421, 27914454, 4383652}, + }, + { + FieldElement{5153746, 9909285, 1723747, -2777874, 30523605, 5516873, 19480852, 5230134, -23952439, -15175766}, + FieldElement{-30269007, -3463509, 7665486, 10083793, 28475525, 1649722, 20654025, 16520125, 30598449, 7715701}, + FieldElement{28881845, 14381568, 9657904, 3680757, -20181635, 7843316, -31400660, 1370708, 29794553, -1409300}, + }, + { + FieldElement{14499471, -2729599, -33191113, -4254652, 28494862, 14271267, 30290735, 10876454, -33154098, 2381726}, + FieldElement{-7195431, -2655363, -14730155, 462251, -27724326, 3941372, -6236617, 3696005, -32300832, 15351955}, + FieldElement{27431194, 8222322, 16448760, -3907995, -18707002, 11938355, -32961401, -2970515, 29551813, 10109425}, + }, + }, + { + { + FieldElement{-13657040, -13155431, -31283750, 11777098, 21447386, 6519384, -2378284, -1627556, 10092783, -4764171}, + FieldElement{27939166, 14210322, 4677035, 16277044, -22964462, -12398139, -32508754, 12005538, -17810127, 12803510}, + FieldElement{17228999, -15661624, -1233527, 300140, -1224870, -11714777, 30364213, -9038194, 18016357, 4397660}, + }, + { + FieldElement{-10958843, -7690207, 4776341, -14954238, 27850028, -15602212, -26619106, 14544525, -17477504, 982639}, + FieldElement{29253598, 15796703, -2863982, -9908884, 10057023, 3163536, 7332899, -4120128, -21047696, 9934963}, + FieldElement{5793303, 16271923, -24131614, -10116404, 29188560, 1206517, -14747930, 4559895, -30123922, -10897950}, + }, + { + FieldElement{-27643952, -11493006, 16282657, -11036493, 28414021, -15012264, 24191034, 4541697, -13338309, 5500568}, + FieldElement{12650548, -1497113, 9052871, 11355358, -17680037, -8400164, -17430592, 12264343, 10874051, 13524335}, + FieldElement{25556948, -3045990, 714651, 2510400, 23394682, -10415330, 33119038, 5080568, -22528059, 5376628}, + }, + { + FieldElement{-26088264, -4011052, -17013699, -3537628, -6726793, 1920897, -22321305, -9447443, 4535768, 1569007}, + FieldElement{-2255422, 14606630, -21692440, -8039818, 28430649, 8775819, -30494562, 3044290, 31848280, 12543772}, + FieldElement{-22028579, 2943893, -31857513, 6777306, 13784462, -4292203, -27377195, -2062731, 7718482, 14474653}, + }, + { + FieldElement{2385315, 2454213, -22631320, 46603, -4437935, -15680415, 656965, -7236665, 24316168, -5253567}, + FieldElement{13741529, 10911568, -33233417, -8603737, -20177830, -1033297, 33040651, -13424532, -20729456, 8321686}, + FieldElement{21060490, -2212744, 15712757, -4336099, 1639040, 10656336, 23845965, -11874838, -9984458, 608372}, + }, + { + FieldElement{-13672732, -15087586, -10889693, -7557059, -6036909, 11305547, 1123968, -6780577, 27229399, 23887}, + FieldElement{-23244140, -294205, -11744728, 14712571, -29465699, -2029617, 12797024, -6440308, -1633405, 16678954}, + FieldElement{-29500620, 4770662, -16054387, 14001338, 7830047, 9564805, -1508144, -4795045, -17169265, 4904953}, + }, + { + FieldElement{24059557, 14617003, 19037157, -15039908, 19766093, -14906429, 5169211, 16191880, 2128236, -4326833}, + FieldElement{-16981152, 4124966, -8540610, -10653797, 30336522, -14105247, -29806336, 916033, -6882542, -2986532}, + FieldElement{-22630907, 12419372, -7134229, -7473371, -16478904, 16739175, 285431, 2763829, 15736322, 4143876}, + }, + { + FieldElement{2379352, 11839345, -4110402, -5988665, 11274298, 794957, 212801, -14594663, 23527084, -16458268}, + FieldElement{33431127, -11130478, -17838966, -15626900, 8909499, 8376530, -32625340, 4087881, -15188911, -14416214}, + FieldElement{1767683, 7197987, -13205226, -2022635, -13091350, 448826, 5799055, 4357868, -4774191, -16323038}, + }, + }, + { + { + FieldElement{6721966, 13833823, -23523388, -1551314, 26354293, -11863321, 23365147, -3949732, 7390890, 2759800}, + FieldElement{4409041, 2052381, 23373853, 10530217, 7676779, -12885954, 21302353, -4264057, 1244380, -12919645}, + FieldElement{-4421239, 7169619, 4982368, -2957590, 30256825, -2777540, 14086413, 9208236, 15886429, 16489664}, + }, + { + FieldElement{1996075, 10375649, 14346367, 13311202, -6874135, -16438411, -13693198, 398369, -30606455, -712933}, + FieldElement{-25307465, 9795880, -2777414, 14878809, -33531835, 14780363, 13348553, 12076947, -30836462, 5113182}, + FieldElement{-17770784, 11797796, 31950843, 13929123, -25888302, 12288344, -30341101, -7336386, 13847711, 5387222}, + }, + { + FieldElement{-18582163, -3416217, 17824843, -2340966, 22744343, -10442611, 8763061, 3617786, -19600662, 10370991}, + FieldElement{20246567, -14369378, 22358229, -543712, 18507283, -10413996, 14554437, -8746092, 32232924, 16763880}, + FieldElement{9648505, 10094563, 26416693, 14745928, -30374318, -6472621, 11094161, 15689506, 3140038, -16510092}, + }, + { + FieldElement{-16160072, 5472695, 31895588, 4744994, 8823515, 10365685, -27224800, 9448613, -28774454, 366295}, + FieldElement{19153450, 11523972, -11096490, -6503142, -24647631, 5420647, 28344573, 8041113, 719605, 11671788}, + FieldElement{8678025, 2694440, -6808014, 2517372, 4964326, 11152271, -15432916, -15266516, 27000813, -10195553}, + }, + { + FieldElement{-15157904, 7134312, 8639287, -2814877, -7235688, 10421742, 564065, 5336097, 6750977, -14521026}, + FieldElement{11836410, -3979488, 26297894, 16080799, 23455045, 15735944, 1695823, -8819122, 8169720, 16220347}, + FieldElement{-18115838, 8653647, 17578566, -6092619, -8025777, -16012763, -11144307, -2627664, -5990708, -14166033}, + }, + { + FieldElement{-23308498, -10968312, 15213228, -10081214, -30853605, -11050004, 27884329, 2847284, 2655861, 1738395}, + FieldElement{-27537433, -14253021, -25336301, -8002780, -9370762, 8129821, 21651608, -3239336, -19087449, -11005278}, + FieldElement{1533110, 3437855, 23735889, 459276, 29970501, 11335377, 26030092, 5821408, 10478196, 8544890}, + }, + { + FieldElement{32173121, -16129311, 24896207, 3921497, 22579056, -3410854, 19270449, 12217473, 17789017, -3395995}, + FieldElement{-30552961, -2228401, -15578829, -10147201, 13243889, 517024, 15479401, -3853233, 30460520, 1052596}, + FieldElement{-11614875, 13323618, 32618793, 8175907, -15230173, 12596687, 27491595, -4612359, 3179268, -9478891}, + }, + { + FieldElement{31947069, -14366651, -4640583, -15339921, -15125977, -6039709, -14756777, -16411740, 19072640, -9511060}, + FieldElement{11685058, 11822410, 3158003, -13952594, 33402194, -4165066, 5977896, -5215017, 473099, 5040608}, + FieldElement{-20290863, 8198642, -27410132, 11602123, 1290375, -2799760, 28326862, 1721092, -19558642, -3131606}, + }, + }, + { + { + FieldElement{7881532, 10687937, 7578723, 7738378, -18951012, -2553952, 21820786, 8076149, -27868496, 11538389}, + FieldElement{-19935666, 3899861, 18283497, -6801568, -15728660, -11249211, 8754525, 7446702, -5676054, 5797016}, + FieldElement{-11295600, -3793569, -15782110, -7964573, 12708869, -8456199, 2014099, -9050574, -2369172, -5877341}, + }, + { + FieldElement{-22472376, -11568741, -27682020, 1146375, 18956691, 16640559, 1192730, -3714199, 15123619, 10811505}, + FieldElement{14352098, -3419715, -18942044, 10822655, 32750596, 4699007, -70363, 15776356, -28886779, -11974553}, + FieldElement{-28241164, -8072475, -4978962, -5315317, 29416931, 1847569, -20654173, -16484855, 4714547, -9600655}, + }, + { + FieldElement{15200332, 8368572, 19679101, 15970074, -31872674, 1959451, 24611599, -4543832, -11745876, 12340220}, + FieldElement{12876937, -10480056, 33134381, 6590940, -6307776, 14872440, 9613953, 8241152, 15370987, 9608631}, + FieldElement{-4143277, -12014408, 8446281, -391603, 4407738, 13629032, -7724868, 15866074, -28210621, -8814099}, + }, + { + FieldElement{26660628, -15677655, 8393734, 358047, -7401291, 992988, -23904233, 858697, 20571223, 8420556}, + FieldElement{14620715, 13067227, -15447274, 8264467, 14106269, 15080814, 33531827, 12516406, -21574435, -12476749}, + FieldElement{236881, 10476226, 57258, -14677024, 6472998, 2466984, 17258519, 7256740, 8791136, 15069930}, + }, + { + FieldElement{1276410, -9371918, 22949635, -16322807, -23493039, -5702186, 14711875, 4874229, -30663140, -2331391}, + FieldElement{5855666, 4990204, -13711848, 7294284, -7804282, 1924647, -1423175, -7912378, -33069337, 9234253}, + FieldElement{20590503, -9018988, 31529744, -7352666, -2706834, 10650548, 31559055, -11609587, 18979186, 13396066}, + }, + { + FieldElement{24474287, 4968103, 22267082, 4407354, 24063882, -8325180, -18816887, 13594782, 33514650, 7021958}, + FieldElement{-11566906, -6565505, -21365085, 15928892, -26158305, 4315421, -25948728, -3916677, -21480480, 12868082}, + FieldElement{-28635013, 13504661, 19988037, -2132761, 21078225, 6443208, -21446107, 2244500, -12455797, -8089383}, + }, + { + FieldElement{-30595528, 13793479, -5852820, 319136, -25723172, -6263899, 33086546, 8957937, -15233648, 5540521}, + FieldElement{-11630176, -11503902, -8119500, -7643073, 2620056, 1022908, -23710744, -1568984, -16128528, -14962807}, + FieldElement{23152971, 775386, 27395463, 14006635, -9701118, 4649512, 1689819, 892185, -11513277, -15205948}, + }, + { + FieldElement{9770129, 9586738, 26496094, 4324120, 1556511, -3550024, 27453819, 4763127, -19179614, 5867134}, + FieldElement{-32765025, 1927590, 31726409, -4753295, 23962434, -16019500, 27846559, 5931263, -29749703, -16108455}, + FieldElement{27461885, -2977536, 22380810, 1815854, -23033753, -3031938, 7283490, -15148073, -19526700, 7734629}, + }, + }, + { + { + FieldElement{-8010264, -9590817, -11120403, 6196038, 29344158, -13430885, 7585295, -3176626, 18549497, 15302069}, + FieldElement{-32658337, -6171222, -7672793, -11051681, 6258878, 13504381, 10458790, -6418461, -8872242, 8424746}, + FieldElement{24687205, 8613276, -30667046, -3233545, 1863892, -1830544, 19206234, 7134917, -11284482, -828919}, + }, + { + FieldElement{11334899, -9218022, 8025293, 12707519, 17523892, -10476071, 10243738, -14685461, -5066034, 16498837}, + FieldElement{8911542, 6887158, -9584260, -6958590, 11145641, -9543680, 17303925, -14124238, 6536641, 10543906}, + FieldElement{-28946384, 15479763, -17466835, 568876, -1497683, 11223454, -2669190, -16625574, -27235709, 8876771}, + }, + { + FieldElement{-25742899, -12566864, -15649966, -846607, -33026686, -796288, -33481822, 15824474, -604426, -9039817}, + FieldElement{10330056, 70051, 7957388, -9002667, 9764902, 15609756, 27698697, -4890037, 1657394, 3084098}, + FieldElement{10477963, -7470260, 12119566, -13250805, 29016247, -5365589, 31280319, 14396151, -30233575, 15272409}, + }, + { + FieldElement{-12288309, 3169463, 28813183, 16658753, 25116432, -5630466, -25173957, -12636138, -25014757, 1950504}, + FieldElement{-26180358, 9489187, 11053416, -14746161, -31053720, 5825630, -8384306, -8767532, 15341279, 8373727}, + FieldElement{28685821, 7759505, -14378516, -12002860, -31971820, 4079242, 298136, -10232602, -2878207, 15190420}, + }, + { + FieldElement{-32932876, 13806336, -14337485, -15794431, -24004620, 10940928, 8669718, 2742393, -26033313, -6875003}, + FieldElement{-1580388, -11729417, -25979658, -11445023, -17411874, -10912854, 9291594, -16247779, -12154742, 6048605}, + FieldElement{-30305315, 14843444, 1539301, 11864366, 20201677, 1900163, 13934231, 5128323, 11213262, 9168384}, + }, + { + FieldElement{-26280513, 11007847, 19408960, -940758, -18592965, -4328580, -5088060, -11105150, 20470157, -16398701}, + FieldElement{-23136053, 9282192, 14855179, -15390078, -7362815, -14408560, -22783952, 14461608, 14042978, 5230683}, + FieldElement{29969567, -2741594, -16711867, -8552442, 9175486, -2468974, 21556951, 3506042, -5933891, -12449708}, + }, + { + FieldElement{-3144746, 8744661, 19704003, 4581278, -20430686, 6830683, -21284170, 8971513, -28539189, 15326563}, + FieldElement{-19464629, 10110288, -17262528, -3503892, -23500387, 1355669, -15523050, 15300988, -20514118, 9168260}, + FieldElement{-5353335, 4488613, -23803248, 16314347, 7780487, -15638939, -28948358, 9601605, 33087103, -9011387}, + }, + { + FieldElement{-19443170, -15512900, -20797467, -12445323, -29824447, 10229461, -27444329, -15000531, -5996870, 15664672}, + FieldElement{23294591, -16632613, -22650781, -8470978, 27844204, 11461195, 13099750, -2460356, 18151676, 13417686}, + FieldElement{-24722913, -4176517, -31150679, 5988919, -26858785, 6685065, 1661597, -12551441, 15271676, -15452665}, + }, + }, + { + { + FieldElement{11433042, -13228665, 8239631, -5279517, -1985436, -725718, -18698764, 2167544, -6921301, -13440182}, + FieldElement{-31436171, 15575146, 30436815, 12192228, -22463353, 9395379, -9917708, -8638997, 12215110, 12028277}, + FieldElement{14098400, 6555944, 23007258, 5757252, -15427832, -12950502, 30123440, 4617780, -16900089, -655628}, + }, + { + FieldElement{-4026201, -15240835, 11893168, 13718664, -14809462, 1847385, -15819999, 10154009, 23973261, -12684474}, + FieldElement{-26531820, -3695990, -1908898, 2534301, -31870557, -16550355, 18341390, -11419951, 32013174, -10103539}, + FieldElement{-25479301, 10876443, -11771086, -14625140, -12369567, 1838104, 21911214, 6354752, 4425632, -837822}, + }, + { + FieldElement{-10433389, -14612966, 22229858, -3091047, -13191166, 776729, -17415375, -12020462, 4725005, 14044970}, + FieldElement{19268650, -7304421, 1555349, 8692754, -21474059, -9910664, 6347390, -1411784, -19522291, -16109756}, + FieldElement{-24864089, 12986008, -10898878, -5558584, -11312371, -148526, 19541418, 8180106, 9282262, 10282508}, + }, + { + FieldElement{-26205082, 4428547, -8661196, -13194263, 4098402, -14165257, 15522535, 8372215, 5542595, -10702683}, + FieldElement{-10562541, 14895633, 26814552, -16673850, -17480754, -2489360, -2781891, 6993761, -18093885, 10114655}, + FieldElement{-20107055, -929418, 31422704, 10427861, -7110749, 6150669, -29091755, -11529146, 25953725, -106158}, + }, + { + FieldElement{-4234397, -8039292, -9119125, 3046000, 2101609, -12607294, 19390020, 6094296, -3315279, 12831125}, + FieldElement{-15998678, 7578152, 5310217, 14408357, -33548620, -224739, 31575954, 6326196, 7381791, -2421839}, + FieldElement{-20902779, 3296811, 24736065, -16328389, 18374254, 7318640, 6295303, 8082724, -15362489, 12339664}, + }, + { + FieldElement{27724736, 2291157, 6088201, -14184798, 1792727, 5857634, 13848414, 15768922, 25091167, 14856294}, + FieldElement{-18866652, 8331043, 24373479, 8541013, -701998, -9269457, 12927300, -12695493, -22182473, -9012899}, + FieldElement{-11423429, -5421590, 11632845, 3405020, 30536730, -11674039, -27260765, 13866390, 30146206, 9142070}, + }, + { + FieldElement{3924129, -15307516, -13817122, -10054960, 12291820, -668366, -27702774, 9326384, -8237858, 4171294}, + FieldElement{-15921940, 16037937, 6713787, 16606682, -21612135, 2790944, 26396185, 3731949, 345228, -5462949}, + FieldElement{-21327538, 13448259, 25284571, 1143661, 20614966, -8849387, 2031539, -12391231, -16253183, -13582083}, + }, + { + FieldElement{31016211, -16722429, 26371392, -14451233, -5027349, 14854137, 17477601, 3842657, 28012650, -16405420}, + FieldElement{-5075835, 9368966, -8562079, -4600902, -15249953, 6970560, -9189873, 16292057, -8867157, 3507940}, + FieldElement{29439664, 3537914, 23333589, 6997794, -17555561, -11018068, -15209202, -15051267, -9164929, 6580396}, + }, + }, + { + { + FieldElement{-12185861, -7679788, 16438269, 10826160, -8696817, -6235611, 17860444, -9273846, -2095802, 9304567}, + FieldElement{20714564, -4336911, 29088195, 7406487, 11426967, -5095705, 14792667, -14608617, 5289421, -477127}, + FieldElement{-16665533, -10650790, -6160345, -13305760, 9192020, -1802462, 17271490, 12349094, 26939669, -3752294}, + }, + { + FieldElement{-12889898, 9373458, 31595848, 16374215, 21471720, 13221525, -27283495, -12348559, -3698806, 117887}, + FieldElement{22263325, -6560050, 3984570, -11174646, -15114008, -566785, 28311253, 5358056, -23319780, 541964}, + FieldElement{16259219, 3261970, 2309254, -15534474, -16885711, -4581916, 24134070, -16705829, -13337066, -13552195}, + }, + { + FieldElement{9378160, -13140186, -22845982, -12745264, 28198281, -7244098, -2399684, -717351, 690426, 14876244}, + FieldElement{24977353, -314384, -8223969, -13465086, 28432343, -1176353, -13068804, -12297348, -22380984, 6618999}, + FieldElement{-1538174, 11685646, 12944378, 13682314, -24389511, -14413193, 8044829, -13817328, 32239829, -5652762}, + }, + { + FieldElement{-18603066, 4762990, -926250, 8885304, -28412480, -3187315, 9781647, -10350059, 32779359, 5095274}, + FieldElement{-33008130, -5214506, -32264887, -3685216, 9460461, -9327423, -24601656, 14506724, 21639561, -2630236}, + FieldElement{-16400943, -13112215, 25239338, 15531969, 3987758, -4499318, -1289502, -6863535, 17874574, 558605}, + }, + { + FieldElement{-13600129, 10240081, 9171883, 16131053, -20869254, 9599700, 33499487, 5080151, 2085892, 5119761}, + FieldElement{-22205145, -2519528, -16381601, 414691, -25019550, 2170430, 30634760, -8363614, -31999993, -5759884}, + FieldElement{-6845704, 15791202, 8550074, -1312654, 29928809, -12092256, 27534430, -7192145, -22351378, 12961482}, + }, + { + FieldElement{-24492060, -9570771, 10368194, 11582341, -23397293, -2245287, 16533930, 8206996, -30194652, -5159638}, + FieldElement{-11121496, -3382234, 2307366, 6362031, -135455, 8868177, -16835630, 7031275, 7589640, 8945490}, + FieldElement{-32152748, 8917967, 6661220, -11677616, -1192060, -15793393, 7251489, -11182180, 24099109, -14456170}, + }, + { + FieldElement{5019558, -7907470, 4244127, -14714356, -26933272, 6453165, -19118182, -13289025, -6231896, -10280736}, + FieldElement{10853594, 10721687, 26480089, 5861829, -22995819, 1972175, -1866647, -10557898, -3363451, -6441124}, + FieldElement{-17002408, 5906790, 221599, -6563147, 7828208, -13248918, 24362661, -2008168, -13866408, 7421392}, + }, + { + FieldElement{8139927, -6546497, 32257646, -5890546, 30375719, 1886181, -21175108, 15441252, 28826358, -4123029}, + FieldElement{6267086, 9695052, 7709135, -16603597, -32869068, -1886135, 14795160, -7840124, 13746021, -1742048}, + FieldElement{28584902, 7787108, -6732942, -15050729, 22846041, -7571236, -3181936, -363524, 4771362, -8419958}, + }, + }, + { + { + FieldElement{24949256, 6376279, -27466481, -8174608, -18646154, -9930606, 33543569, -12141695, 3569627, 11342593}, + FieldElement{26514989, 4740088, 27912651, 3697550, 19331575, -11472339, 6809886, 4608608, 7325975, -14801071}, + FieldElement{-11618399, -14554430, -24321212, 7655128, -1369274, 5214312, -27400540, 10258390, -17646694, -8186692}, + }, + { + FieldElement{11431204, 15823007, 26570245, 14329124, 18029990, 4796082, -31446179, 15580664, 9280358, -3973687}, + FieldElement{-160783, -10326257, -22855316, -4304997, -20861367, -13621002, -32810901, -11181622, -15545091, 4387441}, + FieldElement{-20799378, 12194512, 3937617, -5805892, -27154820, 9340370, -24513992, 8548137, 20617071, -7482001}, + }, + { + FieldElement{-938825, -3930586, -8714311, 16124718, 24603125, -6225393, -13775352, -11875822, 24345683, 10325460}, + FieldElement{-19855277, -1568885, -22202708, 8714034, 14007766, 6928528, 16318175, -1010689, 4766743, 3552007}, + FieldElement{-21751364, -16730916, 1351763, -803421, -4009670, 3950935, 3217514, 14481909, 10988822, -3994762}, + }, + { + FieldElement{15564307, -14311570, 3101243, 5684148, 30446780, -8051356, 12677127, -6505343, -8295852, 13296005}, + FieldElement{-9442290, 6624296, -30298964, -11913677, -4670981, -2057379, 31521204, 9614054, -30000824, 12074674}, + FieldElement{4771191, -135239, 14290749, -13089852, 27992298, 14998318, -1413936, -1556716, 29832613, -16391035}, + }, + { + FieldElement{7064884, -7541174, -19161962, -5067537, -18891269, -2912736, 25825242, 5293297, -27122660, 13101590}, + FieldElement{-2298563, 2439670, -7466610, 1719965, -27267541, -16328445, 32512469, -5317593, -30356070, -4190957}, + FieldElement{-30006540, 10162316, -33180176, 3981723, -16482138, -13070044, 14413974, 9515896, 19568978, 9628812}, + }, + { + FieldElement{33053803, 199357, 15894591, 1583059, 27380243, -4580435, -17838894, -6106839, -6291786, 3437740}, + FieldElement{-18978877, 3884493, 19469877, 12726490, 15913552, 13614290, -22961733, 70104, 7463304, 4176122}, + FieldElement{-27124001, 10659917, 11482427, -16070381, 12771467, -6635117, -32719404, -5322751, 24216882, 5944158}, + }, + { + FieldElement{8894125, 7450974, -2664149, -9765752, -28080517, -12389115, 19345746, 14680796, 11632993, 5847885}, + FieldElement{26942781, -2315317, 9129564, -4906607, 26024105, 11769399, -11518837, 6367194, -9727230, 4782140}, + FieldElement{19916461, -4828410, -22910704, -11414391, 25606324, -5972441, 33253853, 8220911, 6358847, -1873857}, + }, + { + FieldElement{801428, -2081702, 16569428, 11065167, 29875704, 96627, 7908388, -4480480, -13538503, 1387155}, + FieldElement{19646058, 5720633, -11416706, 12814209, 11607948, 12749789, 14147075, 15156355, -21866831, 11835260}, + FieldElement{19299512, 1155910, 28703737, 14890794, 2925026, 7269399, 26121523, 15467869, -26560550, 5052483}, + }, + }, + { + { + FieldElement{-3017432, 10058206, 1980837, 3964243, 22160966, 12322533, -6431123, -12618185, 12228557, -7003677}, + FieldElement{32944382, 14922211, -22844894, 5188528, 21913450, -8719943, 4001465, 13238564, -6114803, 8653815}, + FieldElement{22865569, -4652735, 27603668, -12545395, 14348958, 8234005, 24808405, 5719875, 28483275, 2841751}, + }, + { + FieldElement{-16420968, -1113305, -327719, -12107856, 21886282, -15552774, -1887966, -315658, 19932058, -12739203}, + FieldElement{-11656086, 10087521, -8864888, -5536143, -19278573, -3055912, 3999228, 13239134, -4777469, -13910208}, + FieldElement{1382174, -11694719, 17266790, 9194690, -13324356, 9720081, 20403944, 11284705, -14013818, 3093230}, + }, + { + FieldElement{16650921, -11037932, -1064178, 1570629, -8329746, 7352753, -302424, 16271225, -24049421, -6691850}, + FieldElement{-21911077, -5927941, -4611316, -5560156, -31744103, -10785293, 24123614, 15193618, -21652117, -16739389}, + FieldElement{-9935934, -4289447, -25279823, 4372842, 2087473, 10399484, 31870908, 14690798, 17361620, 11864968}, + }, + { + FieldElement{-11307610, 6210372, 13206574, 5806320, -29017692, -13967200, -12331205, -7486601, -25578460, -16240689}, + FieldElement{14668462, -12270235, 26039039, 15305210, 25515617, 4542480, 10453892, 6577524, 9145645, -6443880}, + FieldElement{5974874, 3053895, -9433049, -10385191, -31865124, 3225009, -7972642, 3936128, -5652273, -3050304}, + }, + { + FieldElement{30625386, -4729400, -25555961, -12792866, -20484575, 7695099, 17097188, -16303496, -27999779, 1803632}, + FieldElement{-3553091, 9865099, -5228566, 4272701, -5673832, -16689700, 14911344, 12196514, -21405489, 7047412}, + FieldElement{20093277, 9920966, -11138194, -5343857, 13161587, 12044805, -32856851, 4124601, -32343828, -10257566}, + }, + { + FieldElement{-20788824, 14084654, -13531713, 7842147, 19119038, -13822605, 4752377, -8714640, -21679658, 2288038}, + FieldElement{-26819236, -3283715, 29965059, 3039786, -14473765, 2540457, 29457502, 14625692, -24819617, 12570232}, + FieldElement{-1063558, -11551823, 16920318, 12494842, 1278292, -5869109, -21159943, -3498680, -11974704, 4724943}, + }, + { + FieldElement{17960970, -11775534, -4140968, -9702530, -8876562, -1410617, -12907383, -8659932, -29576300, 1903856}, + FieldElement{23134274, -14279132, -10681997, -1611936, 20684485, 15770816, -12989750, 3190296, 26955097, 14109738}, + FieldElement{15308788, 5320727, -30113809, -14318877, 22902008, 7767164, 29425325, -11277562, 31960942, 11934971}, + }, + { + FieldElement{-27395711, 8435796, 4109644, 12222639, -24627868, 14818669, 20638173, 4875028, 10491392, 1379718}, + FieldElement{-13159415, 9197841, 3875503, -8936108, -1383712, -5879801, 33518459, 16176658, 21432314, 12180697}, + FieldElement{-11787308, 11500838, 13787581, -13832590, -22430679, 10140205, 1465425, 12689540, -10301319, -13872883}, + }, + }, + { + { + FieldElement{5414091, -15386041, -21007664, 9643570, 12834970, 1186149, -2622916, -1342231, 26128231, 6032912}, + FieldElement{-26337395, -13766162, 32496025, -13653919, 17847801, -12669156, 3604025, 8316894, -25875034, -10437358}, + FieldElement{3296484, 6223048, 24680646, -12246460, -23052020, 5903205, -8862297, -4639164, 12376617, 3188849}, + }, + { + FieldElement{29190488, -14659046, 27549113, -1183516, 3520066, -10697301, 32049515, -7309113, -16109234, -9852307}, + FieldElement{-14744486, -9309156, 735818, -598978, -20407687, -5057904, 25246078, -15795669, 18640741, -960977}, + FieldElement{-6928835, -16430795, 10361374, 5642961, 4910474, 12345252, -31638386, -494430, 10530747, 1053335}, + }, + { + FieldElement{-29265967, -14186805, -13538216, -12117373, -19457059, -10655384, -31462369, -2948985, 24018831, 15026644}, + FieldElement{-22592535, -3145277, -2289276, 5953843, -13440189, 9425631, 25310643, 13003497, -2314791, -15145616}, + FieldElement{-27419985, -603321, -8043984, -1669117, -26092265, 13987819, -27297622, 187899, -23166419, -2531735}, + }, + { + FieldElement{-21744398, -13810475, 1844840, 5021428, -10434399, -15911473, 9716667, 16266922, -5070217, 726099}, + FieldElement{29370922, -6053998, 7334071, -15342259, 9385287, 2247707, -13661962, -4839461, 30007388, -15823341}, + FieldElement{-936379, 16086691, 23751945, -543318, -1167538, -5189036, 9137109, 730663, 9835848, 4555336}, + }, + { + FieldElement{-23376435, 1410446, -22253753, -12899614, 30867635, 15826977, 17693930, 544696, -11985298, 12422646}, + FieldElement{31117226, -12215734, -13502838, 6561947, -9876867, -12757670, -5118685, -4096706, 29120153, 13924425}, + FieldElement{-17400879, -14233209, 19675799, -2734756, -11006962, -5858820, -9383939, -11317700, 7240931, -237388}, + }, + { + FieldElement{-31361739, -11346780, -15007447, -5856218, -22453340, -12152771, 1222336, 4389483, 3293637, -15551743}, + FieldElement{-16684801, -14444245, 11038544, 11054958, -13801175, -3338533, -24319580, 7733547, 12796905, -6335822}, + FieldElement{-8759414, -10817836, -25418864, 10783769, -30615557, -9746811, -28253339, 3647836, 3222231, -11160462}, + }, + { + FieldElement{18606113, 1693100, -25448386, -15170272, 4112353, 10045021, 23603893, -2048234, -7550776, 2484985}, + FieldElement{9255317, -3131197, -12156162, -1004256, 13098013, -9214866, 16377220, -2102812, -19802075, -3034702}, + FieldElement{-22729289, 7496160, -5742199, 11329249, 19991973, -3347502, -31718148, 9936966, -30097688, -10618797}, + }, + { + FieldElement{21878590, -5001297, 4338336, 13643897, -3036865, 13160960, 19708896, 5415497, -7360503, -4109293}, + FieldElement{27736861, 10103576, 12500508, 8502413, -3413016, -9633558, 10436918, -1550276, -23659143, -8132100}, + FieldElement{19492550, -12104365, -29681976, -852630, -3208171, 12403437, 30066266, 8367329, 13243957, 8709688}, + }, + }, + { + { + FieldElement{12015105, 2801261, 28198131, 10151021, 24818120, -4743133, -11194191, -5645734, 5150968, 7274186}, + FieldElement{2831366, -12492146, 1478975, 6122054, 23825128, -12733586, 31097299, 6083058, 31021603, -9793610}, + FieldElement{-2529932, -2229646, 445613, 10720828, -13849527, -11505937, -23507731, 16354465, 15067285, -14147707}, + }, + { + FieldElement{7840942, 14037873, -33364863, 15934016, -728213, -3642706, 21403988, 1057586, -19379462, -12403220}, + FieldElement{915865, -16469274, 15608285, -8789130, -24357026, 6060030, -17371319, 8410997, -7220461, 16527025}, + FieldElement{32922597, -556987, 20336074, -16184568, 10903705, -5384487, 16957574, 52992, 23834301, 6588044}, + }, + { + FieldElement{32752030, 11232950, 3381995, -8714866, 22652988, -10744103, 17159699, 16689107, -20314580, -1305992}, + FieldElement{-4689649, 9166776, -25710296, -10847306, 11576752, 12733943, 7924251, -2752281, 1976123, -7249027}, + FieldElement{21251222, 16309901, -2983015, -6783122, 30810597, 12967303, 156041, -3371252, 12331345, -8237197}, + }, + { + FieldElement{8651614, -4477032, -16085636, -4996994, 13002507, 2950805, 29054427, -5106970, 10008136, -4667901}, + FieldElement{31486080, 15114593, -14261250, 12951354, 14369431, -7387845, 16347321, -13662089, 8684155, -10532952}, + FieldElement{19443825, 11385320, 24468943, -9659068, -23919258, 2187569, -26263207, -6086921, 31316348, 14219878}, + }, + { + FieldElement{-28594490, 1193785, 32245219, 11392485, 31092169, 15722801, 27146014, 6992409, 29126555, 9207390}, + FieldElement{32382935, 1110093, 18477781, 11028262, -27411763, -7548111, -4980517, 10843782, -7957600, -14435730}, + FieldElement{2814918, 7836403, 27519878, -7868156, -20894015, -11553689, -21494559, 8550130, 28346258, 1994730}, + }, + { + FieldElement{-19578299, 8085545, -14000519, -3948622, 2785838, -16231307, -19516951, 7174894, 22628102, 8115180}, + FieldElement{-30405132, 955511, -11133838, -15078069, -32447087, -13278079, -25651578, 3317160, -9943017, 930272}, + FieldElement{-15303681, -6833769, 28856490, 1357446, 23421993, 1057177, 24091212, -1388970, -22765376, -10650715}, + }, + { + FieldElement{-22751231, -5303997, -12907607, -12768866, -15811511, -7797053, -14839018, -16554220, -1867018, 8398970}, + FieldElement{-31969310, 2106403, -4736360, 1362501, 12813763, 16200670, 22981545, -6291273, 18009408, -15772772}, + FieldElement{-17220923, -9545221, -27784654, 14166835, 29815394, 7444469, 29551787, -3727419, 19288549, 1325865}, + }, + { + FieldElement{15100157, -15835752, -23923978, -1005098, -26450192, 15509408, 12376730, -3479146, 33166107, -8042750}, + FieldElement{20909231, 13023121, -9209752, 16251778, -5778415, -8094914, 12412151, 10018715, 2213263, -13878373}, + FieldElement{32529814, -11074689, 30361439, -16689753, -9135940, 1513226, 22922121, 6382134, -5766928, 8371348}, + }, + }, + { + { + FieldElement{9923462, 11271500, 12616794, 3544722, -29998368, -1721626, 12891687, -8193132, -26442943, 10486144}, + FieldElement{-22597207, -7012665, 8587003, -8257861, 4084309, -12970062, 361726, 2610596, -23921530, -11455195}, + FieldElement{5408411, -1136691, -4969122, 10561668, 24145918, 14240566, 31319731, -4235541, 19985175, -3436086}, + }, + { + FieldElement{-13994457, 16616821, 14549246, 3341099, 32155958, 13648976, -17577068, 8849297, 65030, 8370684}, + FieldElement{-8320926, -12049626, 31204563, 5839400, -20627288, -1057277, -19442942, 6922164, 12743482, -9800518}, + FieldElement{-2361371, 12678785, 28815050, 4759974, -23893047, 4884717, 23783145, 11038569, 18800704, 255233}, + }, + { + FieldElement{-5269658, -1773886, 13957886, 7990715, 23132995, 728773, 13393847, 9066957, 19258688, -14753793}, + FieldElement{-2936654, -10827535, -10432089, 14516793, -3640786, 4372541, -31934921, 2209390, -1524053, 2055794}, + FieldElement{580882, 16705327, 5468415, -2683018, -30926419, -14696000, -7203346, -8994389, -30021019, 7394435}, + }, + { + FieldElement{23838809, 1822728, -15738443, 15242727, 8318092, -3733104, -21672180, -3492205, -4821741, 14799921}, + FieldElement{13345610, 9759151, 3371034, -16137791, 16353039, 8577942, 31129804, 13496856, -9056018, 7402518}, + FieldElement{2286874, -4435931, -20042458, -2008336, -13696227, 5038122, 11006906, -15760352, 8205061, 1607563}, + }, + { + FieldElement{14414086, -8002132, 3331830, -3208217, 22249151, -5594188, 18364661, -2906958, 30019587, -9029278}, + FieldElement{-27688051, 1585953, -10775053, 931069, -29120221, -11002319, -14410829, 12029093, 9944378, 8024}, + FieldElement{4368715, -3709630, 29874200, -15022983, -20230386, -11410704, -16114594, -999085, -8142388, 5640030}, + }, + { + FieldElement{10299610, 13746483, 11661824, 16234854, 7630238, 5998374, 9809887, -16694564, 15219798, -14327783}, + FieldElement{27425505, -5719081, 3055006, 10660664, 23458024, 595578, -15398605, -1173195, -18342183, 9742717}, + FieldElement{6744077, 2427284, 26042789, 2720740, -847906, 1118974, 32324614, 7406442, 12420155, 1994844}, + }, + { + FieldElement{14012521, -5024720, -18384453, -9578469, -26485342, -3936439, -13033478, -10909803, 24319929, -6446333}, + FieldElement{16412690, -4507367, 10772641, 15929391, -17068788, -4658621, 10555945, -10484049, -30102368, -4739048}, + FieldElement{22397382, -7767684, -9293161, -12792868, 17166287, -9755136, -27333065, 6199366, 21880021, -12250760}, + }, + { + FieldElement{-4283307, 5368523, -31117018, 8163389, -30323063, 3209128, 16557151, 8890729, 8840445, 4957760}, + FieldElement{-15447727, 709327, -6919446, -10870178, -29777922, 6522332, -21720181, 12130072, -14796503, 5005757}, + FieldElement{-2114751, -14308128, 23019042, 15765735, -25269683, 6002752, 10183197, -13239326, -16395286, -2176112}, + }, + }, + { + { + FieldElement{-19025756, 1632005, 13466291, -7995100, -23640451, 16573537, -32013908, -3057104, 22208662, 2000468}, + FieldElement{3065073, -1412761, -25598674, -361432, -17683065, -5703415, -8164212, 11248527, -3691214, -7414184}, + FieldElement{10379208, -6045554, 8877319, 1473647, -29291284, -12507580, 16690915, 2553332, -3132688, 16400289}, + }, + { + FieldElement{15716668, 1254266, -18472690, 7446274, -8448918, 6344164, -22097271, -7285580, 26894937, 9132066}, + FieldElement{24158887, 12938817, 11085297, -8177598, -28063478, -4457083, -30576463, 64452, -6817084, -2692882}, + FieldElement{13488534, 7794716, 22236231, 5989356, 25426474, -12578208, 2350710, -3418511, -4688006, 2364226}, + }, + { + FieldElement{16335052, 9132434, 25640582, 6678888, 1725628, 8517937, -11807024, -11697457, 15445875, -7798101}, + FieldElement{29004207, -7867081, 28661402, -640412, -12794003, -7943086, 31863255, -4135540, -278050, -15759279}, + FieldElement{-6122061, -14866665, -28614905, 14569919, -10857999, -3591829, 10343412, -6976290, -29828287, -10815811}, + }, + { + FieldElement{27081650, 3463984, 14099042, -4517604, 1616303, -6205604, 29542636, 15372179, 17293797, 960709}, + FieldElement{20263915, 11434237, -5765435, 11236810, 13505955, -10857102, -16111345, 6493122, -19384511, 7639714}, + FieldElement{-2830798, -14839232, 25403038, -8215196, -8317012, -16173699, 18006287, -16043750, 29994677, -15808121}, + }, + { + FieldElement{9769828, 5202651, -24157398, -13631392, -28051003, -11561624, -24613141, -13860782, -31184575, 709464}, + FieldElement{12286395, 13076066, -21775189, -1176622, -25003198, 4057652, -32018128, -8890874, 16102007, 13205847}, + FieldElement{13733362, 5599946, 10557076, 3195751, -5557991, 8536970, -25540170, 8525972, 10151379, 10394400}, + }, + { + FieldElement{4024660, -16137551, 22436262, 12276534, -9099015, -2686099, 19698229, 11743039, -33302334, 8934414}, + FieldElement{-15879800, -4525240, -8580747, -2934061, 14634845, -698278, -9449077, 3137094, -11536886, 11721158}, + FieldElement{17555939, -5013938, 8268606, 2331751, -22738815, 9761013, 9319229, 8835153, -9205489, -1280045}, + }, + { + FieldElement{-461409, -7830014, 20614118, 16688288, -7514766, -4807119, 22300304, 505429, 6108462, -6183415}, + FieldElement{-5070281, 12367917, -30663534, 3234473, 32617080, -8422642, 29880583, -13483331, -26898490, -7867459}, + FieldElement{-31975283, 5726539, 26934134, 10237677, -3173717, -605053, 24199304, 3795095, 7592688, -14992079}, + }, + { + FieldElement{21594432, -14964228, 17466408, -4077222, 32537084, 2739898, 6407723, 12018833, -28256052, 4298412}, + FieldElement{-20650503, -11961496, -27236275, 570498, 3767144, -1717540, 13891942, -1569194, 13717174, 10805743}, + FieldElement{-14676630, -15644296, 15287174, 11927123, 24177847, -8175568, -796431, 14860609, -26938930, -5863836}, + }, + }, + { + { + FieldElement{12962541, 5311799, -10060768, 11658280, 18855286, -7954201, 13286263, -12808704, -4381056, 9882022}, + FieldElement{18512079, 11319350, -20123124, 15090309, 18818594, 5271736, -22727904, 3666879, -23967430, -3299429}, + FieldElement{-6789020, -3146043, 16192429, 13241070, 15898607, -14206114, -10084880, -6661110, -2403099, 5276065}, + }, + { + FieldElement{30169808, -5317648, 26306206, -11750859, 27814964, 7069267, 7152851, 3684982, 1449224, 13082861}, + FieldElement{10342826, 3098505, 2119311, 193222, 25702612, 12233820, 23697382, 15056736, -21016438, -8202000}, + FieldElement{-33150110, 3261608, 22745853, 7948688, 19370557, -15177665, -26171976, 6482814, -10300080, -11060101}, + }, + { + FieldElement{32869458, -5408545, 25609743, 15678670, -10687769, -15471071, 26112421, 2521008, -22664288, 6904815}, + FieldElement{29506923, 4457497, 3377935, -9796444, -30510046, 12935080, 1561737, 3841096, -29003639, -6657642}, + FieldElement{10340844, -6630377, -18656632, -2278430, 12621151, -13339055, 30878497, -11824370, -25584551, 5181966}, + }, + { + FieldElement{25940115, -12658025, 17324188, -10307374, -8671468, 15029094, 24396252, -16450922, -2322852, -12388574}, + FieldElement{-21765684, 9916823, -1300409, 4079498, -1028346, 11909559, 1782390, 12641087, 20603771, -6561742}, + FieldElement{-18882287, -11673380, 24849422, 11501709, 13161720, -4768874, 1925523, 11914390, 4662781, 7820689}, + }, + { + FieldElement{12241050, -425982, 8132691, 9393934, 32846760, -1599620, 29749456, 12172924, 16136752, 15264020}, + FieldElement{-10349955, -14680563, -8211979, 2330220, -17662549, -14545780, 10658213, 6671822, 19012087, 3772772}, + FieldElement{3753511, -3421066, 10617074, 2028709, 14841030, -6721664, 28718732, -15762884, 20527771, 12988982}, + }, + { + FieldElement{-14822485, -5797269, -3707987, 12689773, -898983, -10914866, -24183046, -10564943, 3299665, -12424953}, + FieldElement{-16777703, -15253301, -9642417, 4978983, 3308785, 8755439, 6943197, 6461331, -25583147, 8991218}, + FieldElement{-17226263, 1816362, -1673288, -6086439, 31783888, -8175991, -32948145, 7417950, -30242287, 1507265}, + }, + { + FieldElement{29692663, 6829891, -10498800, 4334896, 20945975, -11906496, -28887608, 8209391, 14606362, -10647073}, + FieldElement{-3481570, 8707081, 32188102, 5672294, 22096700, 1711240, -33020695, 9761487, 4170404, -2085325}, + FieldElement{-11587470, 14855945, -4127778, -1531857, -26649089, 15084046, 22186522, 16002000, -14276837, -8400798}, + }, + { + FieldElement{-4811456, 13761029, -31703877, -2483919, -3312471, 7869047, -7113572, -9620092, 13240845, 10965870}, + FieldElement{-7742563, -8256762, -14768334, -13656260, -23232383, 12387166, 4498947, 14147411, 29514390, 4302863}, + FieldElement{-13413405, -12407859, 20757302, -13801832, 14785143, 8976368, -5061276, -2144373, 17846988, -13971927}, + }, + }, + { + { + FieldElement{-2244452, -754728, -4597030, -1066309, -6247172, 1455299, -21647728, -9214789, -5222701, 12650267}, + FieldElement{-9906797, -16070310, 21134160, 12198166, -27064575, 708126, 387813, 13770293, -19134326, 10958663}, + FieldElement{22470984, 12369526, 23446014, -5441109, -21520802, -9698723, -11772496, -11574455, -25083830, 4271862}, + }, + { + FieldElement{-25169565, -10053642, -19909332, 15361595, -5984358, 2159192, 75375, -4278529, -32526221, 8469673}, + FieldElement{15854970, 4148314, -8893890, 7259002, 11666551, 13824734, -30531198, 2697372, 24154791, -9460943}, + FieldElement{15446137, -15806644, 29759747, 14019369, 30811221, -9610191, -31582008, 12840104, 24913809, 9815020}, + }, + { + FieldElement{-4709286, -5614269, -31841498, -12288893, -14443537, 10799414, -9103676, 13438769, 18735128, 9466238}, + FieldElement{11933045, 9281483, 5081055, -5183824, -2628162, -4905629, -7727821, -10896103, -22728655, 16199064}, + FieldElement{14576810, 379472, -26786533, -8317236, -29426508, -10812974, -102766, 1876699, 30801119, 2164795}, + }, + { + FieldElement{15995086, 3199873, 13672555, 13712240, -19378835, -4647646, -13081610, -15496269, -13492807, 1268052}, + FieldElement{-10290614, -3659039, -3286592, 10948818, 23037027, 3794475, -3470338, -12600221, -17055369, 3565904}, + FieldElement{29210088, -9419337, -5919792, -4952785, 10834811, -13327726, -16512102, -10820713, -27162222, -14030531}, + }, + { + FieldElement{-13161890, 15508588, 16663704, -8156150, -28349942, 9019123, -29183421, -3769423, 2244111, -14001979}, + FieldElement{-5152875, -3800936, -9306475, -6071583, 16243069, 14684434, -25673088, -16180800, 13491506, 4641841}, + FieldElement{10813417, 643330, -19188515, -728916, 30292062, -16600078, 27548447, -7721242, 14476989, -12767431}, + }, + { + FieldElement{10292079, 9984945, 6481436, 8279905, -7251514, 7032743, 27282937, -1644259, -27912810, 12651324}, + FieldElement{-31185513, -813383, 22271204, 11835308, 10201545, 15351028, 17099662, 3988035, 21721536, -3148940}, + FieldElement{10202177, -6545839, -31373232, -9574638, -32150642, -8119683, -12906320, 3852694, 13216206, 14842320}, + }, + { + FieldElement{-15815640, -10601066, -6538952, -7258995, -6984659, -6581778, -31500847, 13765824, -27434397, 9900184}, + FieldElement{14465505, -13833331, -32133984, -14738873, -27443187, 12990492, 33046193, 15796406, -7051866, -8040114}, + FieldElement{30924417, -8279620, 6359016, -12816335, 16508377, 9071735, -25488601, 15413635, 9524356, -7018878}, + }, + { + FieldElement{12274201, -13175547, 32627641, -1785326, 6736625, 13267305, 5237659, -5109483, 15663516, 4035784}, + FieldElement{-2951309, 8903985, 17349946, 601635, -16432815, -4612556, -13732739, -15889334, -22258478, 4659091}, + FieldElement{-16916263, -4952973, -30393711, -15158821, 20774812, 15897498, 5736189, 15026997, -2178256, -13455585}, + }, + }, + { + { + FieldElement{-8858980, -2219056, 28571666, -10155518, -474467, -10105698, -3801496, 278095, 23440562, -290208}, + FieldElement{10226241, -5928702, 15139956, 120818, -14867693, 5218603, 32937275, 11551483, -16571960, -7442864}, + FieldElement{17932739, -12437276, -24039557, 10749060, 11316803, 7535897, 22503767, 5561594, -3646624, 3898661}, + }, + { + FieldElement{7749907, -969567, -16339731, -16464, -25018111, 15122143, -1573531, 7152530, 21831162, 1245233}, + FieldElement{26958459, -14658026, 4314586, 8346991, -5677764, 11960072, -32589295, -620035, -30402091, -16716212}, + FieldElement{-12165896, 9166947, 33491384, 13673479, 29787085, 13096535, 6280834, 14587357, -22338025, 13987525}, + }, + { + FieldElement{-24349909, 7778775, 21116000, 15572597, -4833266, -5357778, -4300898, -5124639, -7469781, -2858068}, + FieldElement{9681908, -6737123, -31951644, 13591838, -6883821, 386950, 31622781, 6439245, -14581012, 4091397}, + FieldElement{-8426427, 1470727, -28109679, -1596990, 3978627, -5123623, -19622683, 12092163, 29077877, -14741988}, + }, + { + FieldElement{5269168, -6859726, -13230211, -8020715, 25932563, 1763552, -5606110, -5505881, -20017847, 2357889}, + FieldElement{32264008, -15407652, -5387735, -1160093, -2091322, -3946900, 23104804, -12869908, 5727338, 189038}, + FieldElement{14609123, -8954470, -6000566, -16622781, -14577387, -7743898, -26745169, 10942115, -25888931, -14884697}, + }, + { + FieldElement{20513500, 5557931, -15604613, 7829531, 26413943, -2019404, -21378968, 7471781, 13913677, -5137875}, + FieldElement{-25574376, 11967826, 29233242, 12948236, -6754465, 4713227, -8940970, 14059180, 12878652, 8511905}, + FieldElement{-25656801, 3393631, -2955415, -7075526, -2250709, 9366908, -30223418, 6812974, 5568676, -3127656}, + }, + { + FieldElement{11630004, 12144454, 2116339, 13606037, 27378885, 15676917, -17408753, -13504373, -14395196, 8070818}, + FieldElement{27117696, -10007378, -31282771, -5570088, 1127282, 12772488, -29845906, 10483306, -11552749, -1028714}, + FieldElement{10637467, -5688064, 5674781, 1072708, -26343588, -6982302, -1683975, 9177853, -27493162, 15431203}, + }, + { + FieldElement{20525145, 10892566, -12742472, 12779443, -29493034, 16150075, -28240519, 14943142, -15056790, -7935931}, + FieldElement{-30024462, 5626926, -551567, -9981087, 753598, 11981191, 25244767, -3239766, -3356550, 9594024}, + FieldElement{-23752644, 2636870, -5163910, -10103818, 585134, 7877383, 11345683, -6492290, 13352335, -10977084}, + }, + { + FieldElement{-1931799, -5407458, 3304649, -12884869, 17015806, -4877091, -29783850, -7752482, -13215537, -319204}, + FieldElement{20239939, 6607058, 6203985, 3483793, -18386976, -779229, -20723742, 15077870, -22750759, 14523817}, + FieldElement{27406042, -6041657, 27423596, -4497394, 4996214, 10002360, -28842031, -4545494, -30172742, -4805667}, + }, + }, + { + { + FieldElement{11374242, 12660715, 17861383, -12540833, 10935568, 1099227, -13886076, -9091740, -27727044, 11358504}, + FieldElement{-12730809, 10311867, 1510375, 10778093, -2119455, -9145702, 32676003, 11149336, -26123651, 4985768}, + FieldElement{-19096303, 341147, -6197485, -239033, 15756973, -8796662, -983043, 13794114, -19414307, -15621255}, + }, + { + FieldElement{6490081, 11940286, 25495923, -7726360, 8668373, -8751316, 3367603, 6970005, -1691065, -9004790}, + FieldElement{1656497, 13457317, 15370807, 6364910, 13605745, 8362338, -19174622, -5475723, -16796596, -5031438}, + FieldElement{-22273315, -13524424, -64685, -4334223, -18605636, -10921968, -20571065, -7007978, -99853, -10237333}, + }, + { + FieldElement{17747465, 10039260, 19368299, -4050591, -20630635, -16041286, 31992683, -15857976, -29260363, -5511971}, + FieldElement{31932027, -4986141, -19612382, 16366580, 22023614, 88450, 11371999, -3744247, 4882242, -10626905}, + FieldElement{29796507, 37186, 19818052, 10115756, -11829032, 3352736, 18551198, 3272828, -5190932, -4162409}, + }, + { + FieldElement{12501286, 4044383, -8612957, -13392385, -32430052, 5136599, -19230378, -3529697, 330070, -3659409}, + FieldElement{6384877, 2899513, 17807477, 7663917, -2358888, 12363165, 25366522, -8573892, -271295, 12071499}, + FieldElement{-8365515, -4042521, 25133448, -4517355, -6211027, 2265927, -32769618, 1936675, -5159697, 3829363}, + }, + { + FieldElement{28425966, -5835433, -577090, -4697198, -14217555, 6870930, 7921550, -6567787, 26333140, 14267664}, + FieldElement{-11067219, 11871231, 27385719, -10559544, -4585914, -11189312, 10004786, -8709488, -21761224, 8930324}, + FieldElement{-21197785, -16396035, 25654216, -1725397, 12282012, 11008919, 1541940, 4757911, -26491501, -16408940}, + }, + { + FieldElement{13537262, -7759490, -20604840, 10961927, -5922820, -13218065, -13156584, 6217254, -15943699, 13814990}, + FieldElement{-17422573, 15157790, 18705543, 29619, 24409717, -260476, 27361681, 9257833, -1956526, -1776914}, + FieldElement{-25045300, -10191966, 15366585, 15166509, -13105086, 8423556, -29171540, 12361135, -18685978, 4578290}, + }, + { + FieldElement{24579768, 3711570, 1342322, -11180126, -27005135, 14124956, -22544529, 14074919, 21964432, 8235257}, + FieldElement{-6528613, -2411497, 9442966, -5925588, 12025640, -1487420, -2981514, -1669206, 13006806, 2355433}, + FieldElement{-16304899, -13605259, -6632427, -5142349, 16974359, -10911083, 27202044, 1719366, 1141648, -12796236}, + }, + { + FieldElement{-12863944, -13219986, -8318266, -11018091, -6810145, -4843894, 13475066, -3133972, 32674895, 13715045}, + FieldElement{11423335, -5468059, 32344216, 8962751, 24989809, 9241752, -13265253, 16086212, -28740881, -15642093}, + FieldElement{-1409668, 12530728, -6368726, 10847387, 19531186, -14132160, -11709148, 7791794, -27245943, 4383347}, + }, + }, + { + { + FieldElement{-28970898, 5271447, -1266009, -9736989, -12455236, 16732599, -4862407, -4906449, 27193557, 6245191}, + FieldElement{-15193956, 5362278, -1783893, 2695834, 4960227, 12840725, 23061898, 3260492, 22510453, 8577507}, + FieldElement{-12632451, 11257346, -32692994, 13548177, -721004, 10879011, 31168030, 13952092, -29571492, -3635906}, + }, + { + FieldElement{3877321, -9572739, 32416692, 5405324, -11004407, -13656635, 3759769, 11935320, 5611860, 8164018}, + FieldElement{-16275802, 14667797, 15906460, 12155291, -22111149, -9039718, 32003002, -8832289, 5773085, -8422109}, + FieldElement{-23788118, -8254300, 1950875, 8937633, 18686727, 16459170, -905725, 12376320, 31632953, 190926}, + }, + { + FieldElement{-24593607, -16138885, -8423991, 13378746, 14162407, 6901328, -8288749, 4508564, -25341555, -3627528}, + FieldElement{8884438, -5884009, 6023974, 10104341, -6881569, -4941533, 18722941, -14786005, -1672488, 827625}, + FieldElement{-32720583, -16289296, -32503547, 7101210, 13354605, 2659080, -1800575, -14108036, -24878478, 1541286}, + }, + { + FieldElement{2901347, -1117687, 3880376, -10059388, -17620940, -3612781, -21802117, -3567481, 20456845, -1885033}, + FieldElement{27019610, 12299467, -13658288, -1603234, -12861660, -4861471, -19540150, -5016058, 29439641, 15138866}, + FieldElement{21536104, -6626420, -32447818, -10690208, -22408077, 5175814, -5420040, -16361163, 7779328, 109896}, + }, + { + FieldElement{30279744, 14648750, -8044871, 6425558, 13639621, -743509, 28698390, 12180118, 23177719, -554075}, + FieldElement{26572847, 3405927, -31701700, 12890905, -19265668, 5335866, -6493768, 2378492, 4439158, -13279347}, + FieldElement{-22716706, 3489070, -9225266, -332753, 18875722, -1140095, 14819434, -12731527, -17717757, -5461437}, + }, + { + FieldElement{-5056483, 16566551, 15953661, 3767752, -10436499, 15627060, -820954, 2177225, 8550082, -15114165}, + FieldElement{-18473302, 16596775, -381660, 15663611, 22860960, 15585581, -27844109, -3582739, -23260460, -8428588}, + FieldElement{-32480551, 15707275, -8205912, -5652081, 29464558, 2713815, -22725137, 15860482, -21902570, 1494193}, + }, + { + FieldElement{-19562091, -14087393, -25583872, -9299552, 13127842, 759709, 21923482, 16529112, 8742704, 12967017}, + FieldElement{-28464899, 1553205, 32536856, -10473729, -24691605, -406174, -8914625, -2933896, -29903758, 15553883}, + FieldElement{21877909, 3230008, 9881174, 10539357, -4797115, 2841332, 11543572, 14513274, 19375923, -12647961}, + }, + { + FieldElement{8832269, -14495485, 13253511, 5137575, 5037871, 4078777, 24880818, -6222716, 2862653, 9455043}, + FieldElement{29306751, 5123106, 20245049, -14149889, 9592566, 8447059, -2077124, -2990080, 15511449, 4789663}, + FieldElement{-20679756, 7004547, 8824831, -9434977, -4045704, -3750736, -5754762, 108893, 23513200, 16652362}, + }, + }, + { + { + FieldElement{-33256173, 4144782, -4476029, -6579123, 10770039, -7155542, -6650416, -12936300, -18319198, 10212860}, + FieldElement{2756081, 8598110, 7383731, -6859892, 22312759, -1105012, 21179801, 2600940, -9988298, -12506466}, + FieldElement{-24645692, 13317462, -30449259, -15653928, 21365574, -10869657, 11344424, 864440, -2499677, -16710063}, + }, + { + FieldElement{-26432803, 6148329, -17184412, -14474154, 18782929, -275997, -22561534, 211300, 2719757, 4940997}, + FieldElement{-1323882, 3911313, -6948744, 14759765, -30027150, 7851207, 21690126, 8518463, 26699843, 5276295}, + FieldElement{-13149873, -6429067, 9396249, 365013, 24703301, -10488939, 1321586, 149635, -15452774, 7159369}, + }, + { + FieldElement{9987780, -3404759, 17507962, 9505530, 9731535, -2165514, 22356009, 8312176, 22477218, -8403385}, + FieldElement{18155857, -16504990, 19744716, 9006923, 15154154, -10538976, 24256460, -4864995, -22548173, 9334109}, + FieldElement{2986088, -4911893, 10776628, -3473844, 10620590, -7083203, -21413845, 14253545, -22587149, 536906}, + }, + { + FieldElement{4377756, 8115836, 24567078, 15495314, 11625074, 13064599, 7390551, 10589625, 10838060, -15420424}, + FieldElement{-19342404, 867880, 9277171, -3218459, -14431572, -1986443, 19295826, -15796950, 6378260, 699185}, + FieldElement{7895026, 4057113, -7081772, -13077756, -17886831, -323126, -716039, 15693155, -5045064, -13373962}, + }, + { + FieldElement{-7737563, -5869402, -14566319, -7406919, 11385654, 13201616, 31730678, -10962840, -3918636, -9669325}, + FieldElement{10188286, -15770834, -7336361, 13427543, 22223443, 14896287, 30743455, 7116568, -21786507, 5427593}, + FieldElement{696102, 13206899, 27047647, -10632082, 15285305, -9853179, 10798490, -4578720, 19236243, 12477404}, + }, + { + FieldElement{-11229439, 11243796, -17054270, -8040865, -788228, -8167967, -3897669, 11180504, -23169516, 7733644}, + FieldElement{17800790, -14036179, -27000429, -11766671, 23887827, 3149671, 23466177, -10538171, 10322027, 15313801}, + FieldElement{26246234, 11968874, 32263343, -5468728, 6830755, -13323031, -15794704, -101982, -24449242, 10890804}, + }, + { + FieldElement{-31365647, 10271363, -12660625, -6267268, 16690207, -13062544, -14982212, 16484931, 25180797, -5334884}, + FieldElement{-586574, 10376444, -32586414, -11286356, 19801893, 10997610, 2276632, 9482883, 316878, 13820577}, + FieldElement{-9882808, -4510367, -2115506, 16457136, -11100081, 11674996, 30756178, -7515054, 30696930, -3712849}, + }, + { + FieldElement{32988917, -9603412, 12499366, 7910787, -10617257, -11931514, -7342816, -9985397, -32349517, 7392473}, + FieldElement{-8855661, 15927861, 9866406, -3649411, -2396914, -16655781, -30409476, -9134995, 25112947, -2926644}, + FieldElement{-2504044, -436966, 25621774, -5678772, 15085042, -5479877, -24884878, -13526194, 5537438, -13914319}, + }, + }, + { + { + FieldElement{-11225584, 2320285, -9584280, 10149187, -33444663, 5808648, -14876251, -1729667, 31234590, 6090599}, + FieldElement{-9633316, 116426, 26083934, 2897444, -6364437, -2688086, 609721, 15878753, -6970405, -9034768}, + FieldElement{-27757857, 247744, -15194774, -9002551, 23288161, -10011936, -23869595, 6503646, 20650474, 1804084}, + }, + { + FieldElement{-27589786, 15456424, 8972517, 8469608, 15640622, 4439847, 3121995, -10329713, 27842616, -202328}, + FieldElement{-15306973, 2839644, 22530074, 10026331, 4602058, 5048462, 28248656, 5031932, -11375082, 12714369}, + FieldElement{20807691, -7270825, 29286141, 11421711, -27876523, -13868230, -21227475, 1035546, -19733229, 12796920}, + }, + { + FieldElement{12076899, -14301286, -8785001, -11848922, -25012791, 16400684, -17591495, -12899438, 3480665, -15182815}, + FieldElement{-32361549, 5457597, 28548107, 7833186, 7303070, -11953545, -24363064, -15921875, -33374054, 2771025}, + FieldElement{-21389266, 421932, 26597266, 6860826, 22486084, -6737172, -17137485, -4210226, -24552282, 15673397}, + }, + { + FieldElement{-20184622, 2338216, 19788685, -9620956, -4001265, -8740893, -20271184, 4733254, 3727144, -12934448}, + FieldElement{6120119, 814863, -11794402, -622716, 6812205, -15747771, 2019594, 7975683, 31123697, -10958981}, + FieldElement{30069250, -11435332, 30434654, 2958439, 18399564, -976289, 12296869, 9204260, -16432438, 9648165}, + }, + { + FieldElement{32705432, -1550977, 30705658, 7451065, -11805606, 9631813, 3305266, 5248604, -26008332, -11377501}, + FieldElement{17219865, 2375039, -31570947, -5575615, -19459679, 9219903, 294711, 15298639, 2662509, -16297073}, + FieldElement{-1172927, -7558695, -4366770, -4287744, -21346413, -8434326, 32087529, -1222777, 32247248, -14389861}, + }, + { + FieldElement{14312628, 1221556, 17395390, -8700143, -4945741, -8684635, -28197744, -9637817, -16027623, -13378845}, + FieldElement{-1428825, -9678990, -9235681, 6549687, -7383069, -468664, 23046502, 9803137, 17597934, 2346211}, + FieldElement{18510800, 15337574, 26171504, 981392, -22241552, 7827556, -23491134, -11323352, 3059833, -11782870}, + }, + { + FieldElement{10141598, 6082907, 17829293, -1947643, 9830092, 13613136, -25556636, -5544586, -33502212, 3592096}, + FieldElement{33114168, -15889352, -26525686, -13343397, 33076705, 8716171, 1151462, 1521897, -982665, -6837803}, + FieldElement{-32939165, -4255815, 23947181, -324178, -33072974, -12305637, -16637686, 3891704, 26353178, 693168}, + }, + { + FieldElement{30374239, 1595580, -16884039, 13186931, 4600344, 406904, 9585294, -400668, 31375464, 14369965}, + FieldElement{-14370654, -7772529, 1510301, 6434173, -18784789, -6262728, 32732230, -13108839, 17901441, 16011505}, + FieldElement{18171223, -11934626, -12500402, 15197122, -11038147, -15230035, -19172240, -16046376, 8764035, 12309598}, + }, + }, + { + { + FieldElement{5975908, -5243188, -19459362, -9681747, -11541277, 14015782, -23665757, 1228319, 17544096, -10593782}, + FieldElement{5811932, -1715293, 3442887, -2269310, -18367348, -8359541, -18044043, -15410127, -5565381, 12348900}, + FieldElement{-31399660, 11407555, 25755363, 6891399, -3256938, 14872274, -24849353, 8141295, -10632534, -585479}, + }, + { + FieldElement{-12675304, 694026, -5076145, 13300344, 14015258, -14451394, -9698672, -11329050, 30944593, 1130208}, + FieldElement{8247766, -6710942, -26562381, -7709309, -14401939, -14648910, 4652152, 2488540, 23550156, -271232}, + FieldElement{17294316, -3788438, 7026748, 15626851, 22990044, 113481, 2267737, -5908146, -408818, -137719}, + }, + { + FieldElement{16091085, -16253926, 18599252, 7340678, 2137637, -1221657, -3364161, 14550936, 3260525, -7166271}, + FieldElement{-4910104, -13332887, 18550887, 10864893, -16459325, -7291596, -23028869, -13204905, -12748722, 2701326}, + FieldElement{-8574695, 16099415, 4629974, -16340524, -20786213, -6005432, -10018363, 9276971, 11329923, 1862132}, + }, + { + FieldElement{14763076, -15903608, -30918270, 3689867, 3511892, 10313526, -21951088, 12219231, -9037963, -940300}, + FieldElement{8894987, -3446094, 6150753, 3013931, 301220, 15693451, -31981216, -2909717, -15438168, 11595570}, + FieldElement{15214962, 3537601, -26238722, -14058872, 4418657, -15230761, 13947276, 10730794, -13489462, -4363670}, + }, + { + FieldElement{-2538306, 7682793, 32759013, 263109, -29984731, -7955452, -22332124, -10188635, 977108, 699994}, + FieldElement{-12466472, 4195084, -9211532, 550904, -15565337, 12917920, 19118110, -439841, -30534533, -14337913}, + FieldElement{31788461, -14507657, 4799989, 7372237, 8808585, -14747943, 9408237, -10051775, 12493932, -5409317}, + }, + { + FieldElement{-25680606, 5260744, -19235809, -6284470, -3695942, 16566087, 27218280, 2607121, 29375955, 6024730}, + FieldElement{842132, -2794693, -4763381, -8722815, 26332018, -12405641, 11831880, 6985184, -9940361, 2854096}, + FieldElement{-4847262, -7969331, 2516242, -5847713, 9695691, -7221186, 16512645, 960770, 12121869, 16648078}, + }, + { + FieldElement{-15218652, 14667096, -13336229, 2013717, 30598287, -464137, -31504922, -7882064, 20237806, 2838411}, + FieldElement{-19288047, 4453152, 15298546, -16178388, 22115043, -15972604, 12544294, -13470457, 1068881, -12499905}, + FieldElement{-9558883, -16518835, 33238498, 13506958, 30505848, -1114596, -8486907, -2630053, 12521378, 4845654}, + }, + { + FieldElement{-28198521, 10744108, -2958380, 10199664, 7759311, -13088600, 3409348, -873400, -6482306, -12885870}, + FieldElement{-23561822, 6230156, -20382013, 10655314, -24040585, -11621172, 10477734, -1240216, -3113227, 13974498}, + FieldElement{12966261, 15550616, -32038948, -1615346, 21025980, -629444, 5642325, 7188737, 18895762, 12629579}, + }, + }, + { + { + FieldElement{14741879, -14946887, 22177208, -11721237, 1279741, 8058600, 11758140, 789443, 32195181, 3895677}, + FieldElement{10758205, 15755439, -4509950, 9243698, -4879422, 6879879, -2204575, -3566119, -8982069, 4429647}, + FieldElement{-2453894, 15725973, -20436342, -10410672, -5803908, -11040220, -7135870, -11642895, 18047436, -15281743}, + }, + { + FieldElement{-25173001, -11307165, 29759956, 11776784, -22262383, -15820455, 10993114, -12850837, -17620701, -9408468}, + FieldElement{21987233, 700364, -24505048, 14972008, -7774265, -5718395, 32155026, 2581431, -29958985, 8773375}, + FieldElement{-25568350, 454463, -13211935, 16126715, 25240068, 8594567, 20656846, 12017935, -7874389, -13920155}, + }, + { + FieldElement{6028182, 6263078, -31011806, -11301710, -818919, 2461772, -31841174, -5468042, -1721788, -2776725}, + FieldElement{-12278994, 16624277, 987579, -5922598, 32908203, 1248608, 7719845, -4166698, 28408820, 6816612}, + FieldElement{-10358094, -8237829, 19549651, -12169222, 22082623, 16147817, 20613181, 13982702, -10339570, 5067943}, + }, + { + FieldElement{-30505967, -3821767, 12074681, 13582412, -19877972, 2443951, -19719286, 12746132, 5331210, -10105944}, + FieldElement{30528811, 3601899, -1957090, 4619785, -27361822, -15436388, 24180793, -12570394, 27679908, -1648928}, + FieldElement{9402404, -13957065, 32834043, 10838634, -26580150, -13237195, 26653274, -8685565, 22611444, -12715406}, + }, + { + FieldElement{22190590, 1118029, 22736441, 15130463, -30460692, -5991321, 19189625, -4648942, 4854859, 6622139}, + FieldElement{-8310738, -2953450, -8262579, -3388049, -10401731, -271929, 13424426, -3567227, 26404409, 13001963}, + FieldElement{-31241838, -15415700, -2994250, 8939346, 11562230, -12840670, -26064365, -11621720, -15405155, 11020693}, + }, + { + FieldElement{1866042, -7949489, -7898649, -10301010, 12483315, 13477547, 3175636, -12424163, 28761762, 1406734}, + FieldElement{-448555, -1777666, 13018551, 3194501, -9580420, -11161737, 24760585, -4347088, 25577411, -13378680}, + FieldElement{-24290378, 4759345, -690653, -1852816, 2066747, 10693769, -29595790, 9884936, -9368926, 4745410}, + }, + { + FieldElement{-9141284, 6049714, -19531061, -4341411, -31260798, 9944276, -15462008, -11311852, 10931924, -11931931}, + FieldElement{-16561513, 14112680, -8012645, 4817318, -8040464, -11414606, -22853429, 10856641, -20470770, 13434654}, + FieldElement{22759489, -10073434, -16766264, -1871422, 13637442, -10168091, 1765144, -12654326, 28445307, -5364710}, + }, + { + FieldElement{29875063, 12493613, 2795536, -3786330, 1710620, 15181182, -10195717, -8788675, 9074234, 1167180}, + FieldElement{-26205683, 11014233, -9842651, -2635485, -26908120, 7532294, -18716888, -9535498, 3843903, 9367684}, + FieldElement{-10969595, -6403711, 9591134, 9582310, 11349256, 108879, 16235123, 8601684, -139197, 4242895}, + }, + }, + { + { + FieldElement{22092954, -13191123, -2042793, -11968512, 32186753, -11517388, -6574341, 2470660, -27417366, 16625501}, + FieldElement{-11057722, 3042016, 13770083, -9257922, 584236, -544855, -7770857, 2602725, -27351616, 14247413}, + FieldElement{6314175, -10264892, -32772502, 15957557, -10157730, 168750, -8618807, 14290061, 27108877, -1180880}, + }, + { + FieldElement{-8586597, -7170966, 13241782, 10960156, -32991015, -13794596, 33547976, -11058889, -27148451, 981874}, + FieldElement{22833440, 9293594, -32649448, -13618667, -9136966, 14756819, -22928859, -13970780, -10479804, -16197962}, + FieldElement{-7768587, 3326786, -28111797, 10783824, 19178761, 14905060, 22680049, 13906969, -15933690, 3797899}, + }, + { + FieldElement{21721356, -4212746, -12206123, 9310182, -3882239, -13653110, 23740224, -2709232, 20491983, -8042152}, + FieldElement{9209270, -15135055, -13256557, -6167798, -731016, 15289673, 25947805, 15286587, 30997318, -6703063}, + FieldElement{7392032, 16618386, 23946583, -8039892, -13265164, -1533858, -14197445, -2321576, 17649998, -250080}, + }, + { + FieldElement{-9301088, -14193827, 30609526, -3049543, -25175069, -1283752, -15241566, -9525724, -2233253, 7662146}, + FieldElement{-17558673, 1763594, -33114336, 15908610, -30040870, -12174295, 7335080, -8472199, -3174674, 3440183}, + FieldElement{-19889700, -5977008, -24111293, -9688870, 10799743, -16571957, 40450, -4431835, 4862400, 1133}, + }, + { + FieldElement{-32856209, -7873957, -5422389, 14860950, -16319031, 7956142, 7258061, 311861, -30594991, -7379421}, + FieldElement{-3773428, -1565936, 28985340, 7499440, 24445838, 9325937, 29727763, 16527196, 18278453, 15405622}, + FieldElement{-4381906, 8508652, -19898366, -3674424, -5984453, 15149970, -13313598, 843523, -21875062, 13626197}, + }, + { + FieldElement{2281448, -13487055, -10915418, -2609910, 1879358, 16164207, -10783882, 3953792, 13340839, 15928663}, + FieldElement{31727126, -7179855, -18437503, -8283652, 2875793, -16390330, -25269894, -7014826, -23452306, 5964753}, + FieldElement{4100420, -5959452, -17179337, 6017714, -18705837, 12227141, -26684835, 11344144, 2538215, -7570755}, + }, + { + FieldElement{-9433605, 6123113, 11159803, -2156608, 30016280, 14966241, -20474983, 1485421, -629256, -15958862}, + FieldElement{-26804558, 4260919, 11851389, 9658551, -32017107, 16367492, -20205425, -13191288, 11659922, -11115118}, + FieldElement{26180396, 10015009, -30844224, -8581293, 5418197, 9480663, 2231568, -10170080, 33100372, -1306171}, + }, + { + FieldElement{15121113, -5201871, -10389905, 15427821, -27509937, -15992507, 21670947, 4486675, -5931810, -14466380}, + FieldElement{16166486, -9483733, -11104130, 6023908, -31926798, -1364923, 2340060, -16254968, -10735770, -10039824}, + FieldElement{28042865, -3557089, -12126526, 12259706, -3717498, -6945899, 6766453, -8689599, 18036436, 5803270}, + }, + }, + { + { + FieldElement{-817581, 6763912, 11803561, 1585585, 10958447, -2671165, 23855391, 4598332, -6159431, -14117438}, + FieldElement{-31031306, -14256194, 17332029, -2383520, 31312682, -5967183, 696309, 50292, -20095739, 11763584}, + FieldElement{-594563, -2514283, -32234153, 12643980, 12650761, 14811489, 665117, -12613632, -19773211, -10713562}, + }, + { + FieldElement{30464590, -11262872, -4127476, -12734478, 19835327, -7105613, -24396175, 2075773, -17020157, 992471}, + FieldElement{18357185, -6994433, 7766382, 16342475, -29324918, 411174, 14578841, 8080033, -11574335, -10601610}, + FieldElement{19598397, 10334610, 12555054, 2555664, 18821899, -10339780, 21873263, 16014234, 26224780, 16452269}, + }, + { + FieldElement{-30223925, 5145196, 5944548, 16385966, 3976735, 2009897, -11377804, -7618186, -20533829, 3698650}, + FieldElement{14187449, 3448569, -10636236, -10810935, -22663880, -3433596, 7268410, -10890444, 27394301, 12015369}, + FieldElement{19695761, 16087646, 28032085, 12999827, 6817792, 11427614, 20244189, -1312777, -13259127, -3402461}, + }, + { + FieldElement{30860103, 12735208, -1888245, -4699734, -16974906, 2256940, -8166013, 12298312, -8550524, -10393462}, + FieldElement{-5719826, -11245325, -1910649, 15569035, 26642876, -7587760, -5789354, -15118654, -4976164, 12651793}, + FieldElement{-2848395, 9953421, 11531313, -5282879, 26895123, -12697089, -13118820, -16517902, 9768698, -2533218}, + }, + { + FieldElement{-24719459, 1894651, -287698, -4704085, 15348719, -8156530, 32767513, 12765450, 4940095, 10678226}, + FieldElement{18860224, 15980149, -18987240, -1562570, -26233012, -11071856, -7843882, 13944024, -24372348, 16582019}, + FieldElement{-15504260, 4970268, -29893044, 4175593, -20993212, -2199756, -11704054, 15444560, -11003761, 7989037}, + }, + { + FieldElement{31490452, 5568061, -2412803, 2182383, -32336847, 4531686, -32078269, 6200206, -19686113, -14800171}, + FieldElement{-17308668, -15879940, -31522777, -2831, -32887382, 16375549, 8680158, -16371713, 28550068, -6857132}, + FieldElement{-28126887, -5688091, 16837845, -1820458, -6850681, 12700016, -30039981, 4364038, 1155602, 5988841}, + }, + { + FieldElement{21890435, -13272907, -12624011, 12154349, -7831873, 15300496, 23148983, -4470481, 24618407, 8283181}, + FieldElement{-33136107, -10512751, 9975416, 6841041, -31559793, 16356536, 3070187, -7025928, 1466169, 10740210}, + FieldElement{-1509399, -15488185, -13503385, -10655916, 32799044, 909394, -13938903, -5779719, -32164649, -15327040}, + }, + { + FieldElement{3960823, -14267803, -28026090, -15918051, -19404858, 13146868, 15567327, 951507, -3260321, -573935}, + FieldElement{24740841, 5052253, -30094131, 8961361, 25877428, 6165135, -24368180, 14397372, -7380369, -6144105}, + FieldElement{-28888365, 3510803, -28103278, -1158478, -11238128, -10631454, -15441463, -14453128, -1625486, -6494814}, + }, + }, + { + { + FieldElement{793299, -9230478, 8836302, -6235707, -27360908, -2369593, 33152843, -4885251, -9906200, -621852}, + FieldElement{5666233, 525582, 20782575, -8038419, -24538499, 14657740, 16099374, 1468826, -6171428, -15186581}, + FieldElement{-4859255, -3779343, -2917758, -6748019, 7778750, 11688288, -30404353, -9871238, -1558923, -9863646}, + }, + { + FieldElement{10896332, -7719704, 824275, 472601, -19460308, 3009587, 25248958, 14783338, -30581476, -15757844}, + FieldElement{10566929, 12612572, -31944212, 11118703, -12633376, 12362879, 21752402, 8822496, 24003793, 14264025}, + FieldElement{27713862, -7355973, -11008240, 9227530, 27050101, 2504721, 23886875, -13117525, 13958495, -5732453}, + }, + { + FieldElement{-23481610, 4867226, -27247128, 3900521, 29838369, -8212291, -31889399, -10041781, 7340521, -15410068}, + FieldElement{4646514, -8011124, -22766023, -11532654, 23184553, 8566613, 31366726, -1381061, -15066784, -10375192}, + FieldElement{-17270517, 12723032, -16993061, 14878794, 21619651, -6197576, 27584817, 3093888, -8843694, 3849921}, + }, + { + FieldElement{-9064912, 2103172, 25561640, -15125738, -5239824, 9582958, 32477045, -9017955, 5002294, -15550259}, + FieldElement{-12057553, -11177906, 21115585, -13365155, 8808712, -12030708, 16489530, 13378448, -25845716, 12741426}, + FieldElement{-5946367, 10645103, -30911586, 15390284, -3286982, -7118677, 24306472, 15852464, 28834118, -7646072}, + }, + { + FieldElement{-17335748, -9107057, -24531279, 9434953, -8472084, -583362, -13090771, 455841, 20461858, 5491305}, + FieldElement{13669248, -16095482, -12481974, -10203039, -14569770, -11893198, -24995986, 11293807, -28588204, -9421832}, + FieldElement{28497928, 6272777, -33022994, 14470570, 8906179, -1225630, 18504674, -14165166, 29867745, -8795943}, + }, + { + FieldElement{-16207023, 13517196, -27799630, -13697798, 24009064, -6373891, -6367600, -13175392, 22853429, -4012011}, + FieldElement{24191378, 16712145, -13931797, 15217831, 14542237, 1646131, 18603514, -11037887, 12876623, -2112447}, + FieldElement{17902668, 4518229, -411702, -2829247, 26878217, 5258055, -12860753, 608397, 16031844, 3723494}, + }, + { + FieldElement{-28632773, 12763728, -20446446, 7577504, 33001348, -13017745, 17558842, -7872890, 23896954, -4314245}, + FieldElement{-20005381, -12011952, 31520464, 605201, 2543521, 5991821, -2945064, 7229064, -9919646, -8826859}, + FieldElement{28816045, 298879, -28165016, -15920938, 19000928, -1665890, -12680833, -2949325, -18051778, -2082915}, + }, + { + FieldElement{16000882, -344896, 3493092, -11447198, -29504595, -13159789, 12577740, 16041268, -19715240, 7847707}, + FieldElement{10151868, 10572098, 27312476, 7922682, 14825339, 4723128, -32855931, -6519018, -10020567, 3852848}, + FieldElement{-11430470, 15697596, -21121557, -4420647, 5386314, 15063598, 16514493, -15932110, 29330899, -15076224}, + }, + }, + { + { + FieldElement{-25499735, -4378794, -15222908, -6901211, 16615731, 2051784, 3303702, 15490, -27548796, 12314391}, + FieldElement{15683520, -6003043, 18109120, -9980648, 15337968, -5997823, -16717435, 15921866, 16103996, -3731215}, + FieldElement{-23169824, -10781249, 13588192, -1628807, -3798557, -1074929, -19273607, 5402699, -29815713, -9841101}, + }, + { + FieldElement{23190676, 2384583, -32714340, 3462154, -29903655, -1529132, -11266856, 8911517, -25205859, 2739713}, + FieldElement{21374101, -3554250, -33524649, 9874411, 15377179, 11831242, -33529904, 6134907, 4931255, 11987849}, + FieldElement{-7732, -2978858, -16223486, 7277597, 105524, -322051, -31480539, 13861388, -30076310, 10117930}, + }, + { + FieldElement{-29501170, -10744872, -26163768, 13051539, -25625564, 5089643, -6325503, 6704079, 12890019, 15728940}, + FieldElement{-21972360, -11771379, -951059, -4418840, 14704840, 2695116, 903376, -10428139, 12885167, 8311031}, + FieldElement{-17516482, 5352194, 10384213, -13811658, 7506451, 13453191, 26423267, 4384730, 1888765, -5435404}, + }, + { + FieldElement{-25817338, -3107312, -13494599, -3182506, 30896459, -13921729, -32251644, -12707869, -19464434, -3340243}, + FieldElement{-23607977, -2665774, -526091, 4651136, 5765089, 4618330, 6092245, 14845197, 17151279, -9854116}, + FieldElement{-24830458, -12733720, -15165978, 10367250, -29530908, -265356, 22825805, -7087279, -16866484, 16176525}, + }, + { + FieldElement{-23583256, 6564961, 20063689, 3798228, -4740178, 7359225, 2006182, -10363426, -28746253, -10197509}, + FieldElement{-10626600, -4486402, -13320562, -5125317, 3432136, -6393229, 23632037, -1940610, 32808310, 1099883}, + FieldElement{15030977, 5768825, -27451236, -2887299, -6427378, -15361371, -15277896, -6809350, 2051441, -15225865}, + }, + { + FieldElement{-3362323, -7239372, 7517890, 9824992, 23555850, 295369, 5148398, -14154188, -22686354, 16633660}, + FieldElement{4577086, -16752288, 13249841, -15304328, 19958763, -14537274, 18559670, -10759549, 8402478, -9864273}, + FieldElement{-28406330, -1051581, -26790155, -907698, -17212414, -11030789, 9453451, -14980072, 17983010, 9967138}, + }, + { + FieldElement{-25762494, 6524722, 26585488, 9969270, 24709298, 1220360, -1677990, 7806337, 17507396, 3651560}, + FieldElement{-10420457, -4118111, 14584639, 15971087, -15768321, 8861010, 26556809, -5574557, -18553322, -11357135}, + FieldElement{2839101, 14284142, 4029895, 3472686, 14402957, 12689363, -26642121, 8459447, -5605463, -7621941}, + }, + { + FieldElement{-4839289, -3535444, 9744961, 2871048, 25113978, 3187018, -25110813, -849066, 17258084, -7977739}, + FieldElement{18164541, -10595176, -17154882, -1542417, 19237078, -9745295, 23357533, -15217008, 26908270, 12150756}, + FieldElement{-30264870, -7647865, 5112249, -7036672, -1499807, -6974257, 43168, -5537701, -32302074, 16215819}, + }, + }, + { + { + FieldElement{-6898905, 9824394, -12304779, -4401089, -31397141, -6276835, 32574489, 12532905, -7503072, -8675347}, + FieldElement{-27343522, -16515468, -27151524, -10722951, 946346, 16291093, 254968, 7168080, 21676107, -1943028}, + FieldElement{21260961, -8424752, -16831886, -11920822, -23677961, 3968121, -3651949, -6215466, -3556191, -7913075}, + }, + { + FieldElement{16544754, 13250366, -16804428, 15546242, -4583003, 12757258, -2462308, -8680336, -18907032, -9662799}, + FieldElement{-2415239, -15577728, 18312303, 4964443, -15272530, -12653564, 26820651, 16690659, 25459437, -4564609}, + FieldElement{-25144690, 11425020, 28423002, -11020557, -6144921, -15826224, 9142795, -2391602, -6432418, -1644817}, + }, + { + FieldElement{-23104652, 6253476, 16964147, -3768872, -25113972, -12296437, -27457225, -16344658, 6335692, 7249989}, + FieldElement{-30333227, 13979675, 7503222, -12368314, -11956721, -4621693, -30272269, 2682242, 25993170, -12478523}, + FieldElement{4364628, 5930691, 32304656, -10044554, -8054781, 15091131, 22857016, -10598955, 31820368, 15075278}, + }, + { + FieldElement{31879134, -8918693, 17258761, 90626, -8041836, -4917709, 24162788, -9650886, -17970238, 12833045}, + FieldElement{19073683, 14851414, -24403169, -11860168, 7625278, 11091125, -19619190, 2074449, -9413939, 14905377}, + FieldElement{24483667, -11935567, -2518866, -11547418, -1553130, 15355506, -25282080, 9253129, 27628530, -7555480}, + }, + { + FieldElement{17597607, 8340603, 19355617, 552187, 26198470, -3176583, 4593324, -9157582, -14110875, 15297016}, + FieldElement{510886, 14337390, -31785257, 16638632, 6328095, 2713355, -20217417, -11864220, 8683221, 2921426}, + FieldElement{18606791, 11874196, 27155355, -5281482, -24031742, 6265446, -25178240, -1278924, 4674690, 13890525}, + }, + { + FieldElement{13609624, 13069022, -27372361, -13055908, 24360586, 9592974, 14977157, 9835105, 4389687, 288396}, + FieldElement{9922506, -519394, 13613107, 5883594, -18758345, -434263, -12304062, 8317628, 23388070, 16052080}, + FieldElement{12720016, 11937594, -31970060, -5028689, 26900120, 8561328, -20155687, -11632979, -14754271, -10812892}, + }, + { + FieldElement{15961858, 14150409, 26716931, -665832, -22794328, 13603569, 11829573, 7467844, -28822128, 929275}, + FieldElement{11038231, -11582396, -27310482, -7316562, -10498527, -16307831, -23479533, -9371869, -21393143, 2465074}, + FieldElement{20017163, -4323226, 27915242, 1529148, 12396362, 15675764, 13817261, -9658066, 2463391, -4622140}, + }, + { + FieldElement{-16358878, -12663911, -12065183, 4996454, -1256422, 1073572, 9583558, 12851107, 4003896, 12673717}, + FieldElement{-1731589, -15155870, -3262930, 16143082, 19294135, 13385325, 14741514, -9103726, 7903886, 2348101}, + FieldElement{24536016, -16515207, 12715592, -3862155, 1511293, 10047386, -3842346, -7129159, -28377538, 10048127}, + }, + }, + { + { + FieldElement{-12622226, -6204820, 30718825, 2591312, -10617028, 12192840, 18873298, -7297090, -32297756, 15221632}, + FieldElement{-26478122, -11103864, 11546244, -1852483, 9180880, 7656409, -21343950, 2095755, 29769758, 6593415}, + FieldElement{-31994208, -2907461, 4176912, 3264766, 12538965, -868111, 26312345, -6118678, 30958054, 8292160}, + }, + { + FieldElement{31429822, -13959116, 29173532, 15632448, 12174511, -2760094, 32808831, 3977186, 26143136, -3148876}, + FieldElement{22648901, 1402143, -22799984, 13746059, 7936347, 365344, -8668633, -1674433, -3758243, -2304625}, + FieldElement{-15491917, 8012313, -2514730, -12702462, -23965846, -10254029, -1612713, -1535569, -16664475, 8194478}, + }, + { + FieldElement{27338066, -7507420, -7414224, 10140405, -19026427, -6589889, 27277191, 8855376, 28572286, 3005164}, + FieldElement{26287124, 4821776, 25476601, -4145903, -3764513, -15788984, -18008582, 1182479, -26094821, -13079595}, + FieldElement{-7171154, 3178080, 23970071, 6201893, -17195577, -4489192, -21876275, -13982627, 32208683, -1198248}, + }, + { + FieldElement{-16657702, 2817643, -10286362, 14811298, 6024667, 13349505, -27315504, -10497842, -27672585, -11539858}, + FieldElement{15941029, -9405932, -21367050, 8062055, 31876073, -238629, -15278393, -1444429, 15397331, -4130193}, + FieldElement{8934485, -13485467, -23286397, -13423241, -32446090, 14047986, 31170398, -1441021, -27505566, 15087184}, + }, + { + FieldElement{-18357243, -2156491, 24524913, -16677868, 15520427, -6360776, -15502406, 11461896, 16788528, -5868942}, + FieldElement{-1947386, 16013773, 21750665, 3714552, -17401782, -16055433, -3770287, -10323320, 31322514, -11615635}, + FieldElement{21426655, -5650218, -13648287, -5347537, -28812189, -4920970, -18275391, -14621414, 13040862, -12112948}, + }, + { + FieldElement{11293895, 12478086, -27136401, 15083750, -29307421, 14748872, 14555558, -13417103, 1613711, 4896935}, + FieldElement{-25894883, 15323294, -8489791, -8057900, 25967126, -13425460, 2825960, -4897045, -23971776, -11267415}, + FieldElement{-15924766, -5229880, -17443532, 6410664, 3622847, 10243618, 20615400, 12405433, -23753030, -8436416}, + }, + { + FieldElement{-7091295, 12556208, -20191352, 9025187, -17072479, 4333801, 4378436, 2432030, 23097949, -566018}, + FieldElement{4565804, -16025654, 20084412, -7842817, 1724999, 189254, 24767264, 10103221, -18512313, 2424778}, + FieldElement{366633, -11976806, 8173090, -6890119, 30788634, 5745705, -7168678, 1344109, -3642553, 12412659}, + }, + { + FieldElement{-24001791, 7690286, 14929416, -168257, -32210835, -13412986, 24162697, -15326504, -3141501, 11179385}, + FieldElement{18289522, -14724954, 8056945, 16430056, -21729724, 7842514, -6001441, -1486897, -18684645, -11443503}, + FieldElement{476239, 6601091, -6152790, -9723375, 17503545, -4863900, 27672959, 13403813, 11052904, 5219329}, + }, + }, + { + { + FieldElement{20678546, -8375738, -32671898, 8849123, -5009758, 14574752, 31186971, -3973730, 9014762, -8579056}, + FieldElement{-13644050, -10350239, -15962508, 5075808, -1514661, -11534600, -33102500, 9160280, 8473550, -3256838}, + FieldElement{24900749, 14435722, 17209120, -15292541, -22592275, 9878983, -7689309, -16335821, -24568481, 11788948}, + }, + { + FieldElement{-3118155, -11395194, -13802089, 14797441, 9652448, -6845904, -20037437, 10410733, -24568470, -1458691}, + FieldElement{-15659161, 16736706, -22467150, 10215878, -9097177, 7563911, 11871841, -12505194, -18513325, 8464118}, + FieldElement{-23400612, 8348507, -14585951, -861714, -3950205, -6373419, 14325289, 8628612, 33313881, -8370517}, + }, + { + FieldElement{-20186973, -4967935, 22367356, 5271547, -1097117, -4788838, -24805667, -10236854, -8940735, -5818269}, + FieldElement{-6948785, -1795212, -32625683, -16021179, 32635414, -7374245, 15989197, -12838188, 28358192, -4253904}, + FieldElement{-23561781, -2799059, -32351682, -1661963, -9147719, 10429267, -16637684, 4072016, -5351664, 5596589}, + }, + { + FieldElement{-28236598, -3390048, 12312896, 6213178, 3117142, 16078565, 29266239, 2557221, 1768301, 15373193}, + FieldElement{-7243358, -3246960, -4593467, -7553353, -127927, -912245, -1090902, -4504991, -24660491, 3442910}, + FieldElement{-30210571, 5124043, 14181784, 8197961, 18964734, -11939093, 22597931, 7176455, -18585478, 13365930}, + }, + { + FieldElement{-7877390, -1499958, 8324673, 4690079, 6261860, 890446, 24538107, -8570186, -9689599, -3031667}, + FieldElement{25008904, -10771599, -4305031, -9638010, 16265036, 15721635, 683793, -11823784, 15723479, -15163481}, + FieldElement{-9660625, 12374379, -27006999, -7026148, -7724114, -12314514, 11879682, 5400171, 519526, -1235876}, + }, + { + FieldElement{22258397, -16332233, -7869817, 14613016, -22520255, -2950923, -20353881, 7315967, 16648397, 7605640}, + FieldElement{-8081308, -8464597, -8223311, 9719710, 19259459, -15348212, 23994942, -5281555, -9468848, 4763278}, + FieldElement{-21699244, 9220969, -15730624, 1084137, -25476107, -2852390, 31088447, -7764523, -11356529, 728112}, + }, + { + FieldElement{26047220, -11751471, -6900323, -16521798, 24092068, 9158119, -4273545, -12555558, -29365436, -5498272}, + FieldElement{17510331, -322857, 5854289, 8403524, 17133918, -3112612, -28111007, 12327945, 10750447, 10014012}, + FieldElement{-10312768, 3936952, 9156313, -8897683, 16498692, -994647, -27481051, -666732, 3424691, 7540221}, + }, + { + FieldElement{30322361, -6964110, 11361005, -4143317, 7433304, 4989748, -7071422, -16317219, -9244265, 15258046}, + FieldElement{13054562, -2779497, 19155474, 469045, -12482797, 4566042, 5631406, 2711395, 1062915, -5136345}, + FieldElement{-19240248, -11254599, -29509029, -7499965, -5835763, 13005411, -6066489, 12194497, 32960380, 1459310}, + }, + }, + { + { + FieldElement{19852034, 7027924, 23669353, 10020366, 8586503, -6657907, 394197, -6101885, 18638003, -11174937}, + FieldElement{31395534, 15098109, 26581030, 8030562, -16527914, -5007134, 9012486, -7584354, -6643087, -5442636}, + FieldElement{-9192165, -2347377, -1997099, 4529534, 25766844, 607986, -13222, 9677543, -32294889, -6456008}, + }, + { + FieldElement{-2444496, -149937, 29348902, 8186665, 1873760, 12489863, -30934579, -7839692, -7852844, -8138429}, + FieldElement{-15236356, -15433509, 7766470, 746860, 26346930, -10221762, -27333451, 10754588, -9431476, 5203576}, + FieldElement{31834314, 14135496, -770007, 5159118, 20917671, -16768096, -7467973, -7337524, 31809243, 7347066}, + }, + { + FieldElement{-9606723, -11874240, 20414459, 13033986, 13716524, -11691881, 19797970, -12211255, 15192876, -2087490}, + FieldElement{-12663563, -2181719, 1168162, -3804809, 26747877, -14138091, 10609330, 12694420, 33473243, -13382104}, + FieldElement{33184999, 11180355, 15832085, -11385430, -1633671, 225884, 15089336, -11023903, -6135662, 14480053}, + }, + { + FieldElement{31308717, -5619998, 31030840, -1897099, 15674547, -6582883, 5496208, 13685227, 27595050, 8737275}, + FieldElement{-20318852, -15150239, 10933843, -16178022, 8335352, -7546022, -31008351, -12610604, 26498114, 66511}, + FieldElement{22644454, -8761729, -16671776, 4884562, -3105614, -13559366, 30540766, -4286747, -13327787, -7515095}, + }, + { + FieldElement{-28017847, 9834845, 18617207, -2681312, -3401956, -13307506, 8205540, 13585437, -17127465, 15115439}, + FieldElement{23711543, -672915, 31206561, -8362711, 6164647, -9709987, -33535882, -1426096, 8236921, 16492939}, + FieldElement{-23910559, -13515526, -26299483, -4503841, 25005590, -7687270, 19574902, 10071562, 6708380, -6222424}, + }, + { + FieldElement{2101391, -4930054, 19702731, 2367575, -15427167, 1047675, 5301017, 9328700, 29955601, -11678310}, + FieldElement{3096359, 9271816, -21620864, -15521844, -14847996, -7592937, -25892142, -12635595, -9917575, 6216608}, + FieldElement{-32615849, 338663, -25195611, 2510422, -29213566, -13820213, 24822830, -6146567, -26767480, 7525079}, + }, + { + FieldElement{-23066649, -13985623, 16133487, -7896178, -3389565, 778788, -910336, -2782495, -19386633, 11994101}, + FieldElement{21691500, -13624626, -641331, -14367021, 3285881, -3483596, -25064666, 9718258, -7477437, 13381418}, + FieldElement{18445390, -4202236, 14979846, 11622458, -1727110, -3582980, 23111648, -6375247, 28535282, 15779576}, + }, + { + FieldElement{30098053, 3089662, -9234387, 16662135, -21306940, 11308411, -14068454, 12021730, 9955285, -16303356}, + FieldElement{9734894, -14576830, -7473633, -9138735, 2060392, 11313496, -18426029, 9924399, 20194861, 13380996}, + FieldElement{-26378102, -7965207, -22167821, 15789297, -18055342, -6168792, -1984914, 15707771, 26342023, 10146099}, + }, + }, + { + { + FieldElement{-26016874, -219943, 21339191, -41388, 19745256, -2878700, -29637280, 2227040, 21612326, -545728}, + FieldElement{-13077387, 1184228, 23562814, -5970442, -20351244, -6348714, 25764461, 12243797, -20856566, 11649658}, + FieldElement{-10031494, 11262626, 27384172, 2271902, 26947504, -15997771, 39944, 6114064, 33514190, 2333242}, + }, + { + FieldElement{-21433588, -12421821, 8119782, 7219913, -21830522, -9016134, -6679750, -12670638, 24350578, -13450001}, + FieldElement{-4116307, -11271533, -23886186, 4843615, -30088339, 690623, -31536088, -10406836, 8317860, 12352766}, + FieldElement{18200138, -14475911, -33087759, -2696619, -23702521, -9102511, -23552096, -2287550, 20712163, 6719373}, + }, + { + FieldElement{26656208, 6075253, -7858556, 1886072, -28344043, 4262326, 11117530, -3763210, 26224235, -3297458}, + FieldElement{-17168938, -14854097, -3395676, -16369877, -19954045, 14050420, 21728352, 9493610, 18620611, -16428628}, + FieldElement{-13323321, 13325349, 11432106, 5964811, 18609221, 6062965, -5269471, -9725556, -30701573, -16479657}, + }, + { + FieldElement{-23860538, -11233159, 26961357, 1640861, -32413112, -16737940, 12248509, -5240639, 13735342, 1934062}, + FieldElement{25089769, 6742589, 17081145, -13406266, 21909293, -16067981, -15136294, -3765346, -21277997, 5473616}, + FieldElement{31883677, -7961101, 1083432, -11572403, 22828471, 13290673, -7125085, 12469656, 29111212, -5451014}, + }, + { + FieldElement{24244947, -15050407, -26262976, 2791540, -14997599, 16666678, 24367466, 6388839, -10295587, 452383}, + FieldElement{-25640782, -3417841, 5217916, 16224624, 19987036, -4082269, -24236251, -5915248, 15766062, 8407814}, + FieldElement{-20406999, 13990231, 15495425, 16395525, 5377168, 15166495, -8917023, -4388953, -8067909, 2276718}, + }, + { + FieldElement{30157918, 12924066, -17712050, 9245753, 19895028, 3368142, -23827587, 5096219, 22740376, -7303417}, + FieldElement{2041139, -14256350, 7783687, 13876377, -25946985, -13352459, 24051124, 13742383, -15637599, 13295222}, + FieldElement{33338237, -8505733, 12532113, 7977527, 9106186, -1715251, -17720195, -4612972, -4451357, -14669444}, + }, + { + FieldElement{-20045281, 5454097, -14346548, 6447146, 28862071, 1883651, -2469266, -4141880, 7770569, 9620597}, + FieldElement{23208068, 7979712, 33071466, 8149229, 1758231, -10834995, 30945528, -1694323, -33502340, -14767970}, + FieldElement{1439958, -16270480, -1079989, -793782, 4625402, 10647766, -5043801, 1220118, 30494170, -11440799}, + }, + { + FieldElement{-5037580, -13028295, -2970559, -3061767, 15640974, -6701666, -26739026, 926050, -1684339, -13333647}, + FieldElement{13908495, -3549272, 30919928, -6273825, -21521863, 7989039, 9021034, 9078865, 3353509, 4033511}, + FieldElement{-29663431, -15113610, 32259991, -344482, 24295849, -12912123, 23161163, 8839127, 27485041, 7356032}, + }, + }, + { + { + FieldElement{9661027, 705443, 11980065, -5370154, -1628543, 14661173, -6346142, 2625015, 28431036, -16771834}, + FieldElement{-23839233, -8311415, -25945511, 7480958, -17681669, -8354183, -22545972, 14150565, 15970762, 4099461}, + FieldElement{29262576, 16756590, 26350592, -8793563, 8529671, -11208050, 13617293, -9937143, 11465739, 8317062}, + }, + { + FieldElement{-25493081, -6962928, 32500200, -9419051, -23038724, -2302222, 14898637, 3848455, 20969334, -5157516}, + FieldElement{-20384450, -14347713, -18336405, 13884722, -33039454, 2842114, -21610826, -3649888, 11177095, 14989547}, + FieldElement{-24496721, -11716016, 16959896, 2278463, 12066309, 10137771, 13515641, 2581286, -28487508, 9930240}, + }, + { + FieldElement{-17751622, -2097826, 16544300, -13009300, -15914807, -14949081, 18345767, -13403753, 16291481, -5314038}, + FieldElement{-33229194, 2553288, 32678213, 9875984, 8534129, 6889387, -9676774, 6957617, 4368891, 9788741}, + FieldElement{16660756, 7281060, -10830758, 12911820, 20108584, -8101676, -21722536, -8613148, 16250552, -11111103}, + }, + { + FieldElement{-19765507, 2390526, -16551031, 14161980, 1905286, 6414907, 4689584, 10604807, -30190403, 4782747}, + FieldElement{-1354539, 14736941, -7367442, -13292886, 7710542, -14155590, -9981571, 4383045, 22546403, 437323}, + FieldElement{31665577, -12180464, -16186830, 1491339, -18368625, 3294682, 27343084, 2786261, -30633590, -14097016}, + }, + { + FieldElement{-14467279, -683715, -33374107, 7448552, 19294360, 14334329, -19690631, 2355319, -19284671, -6114373}, + FieldElement{15121312, -15796162, 6377020, -6031361, -10798111, -12957845, 18952177, 15496498, -29380133, 11754228}, + FieldElement{-2637277, -13483075, 8488727, -14303896, 12728761, -1622493, 7141596, 11724556, 22761615, -10134141}, + }, + { + FieldElement{16918416, 11729663, -18083579, 3022987, -31015732, -13339659, -28741185, -12227393, 32851222, 11717399}, + FieldElement{11166634, 7338049, -6722523, 4531520, -29468672, -7302055, 31474879, 3483633, -1193175, -4030831}, + FieldElement{-185635, 9921305, 31456609, -13536438, -12013818, 13348923, 33142652, 6546660, -19985279, -3948376}, + }, + { + FieldElement{-32460596, 11266712, -11197107, -7899103, 31703694, 3855903, -8537131, -12833048, -30772034, -15486313}, + FieldElement{-18006477, 12709068, 3991746, -6479188, -21491523, -10550425, -31135347, -16049879, 10928917, 3011958}, + FieldElement{-6957757, -15594337, 31696059, 334240, 29576716, 14796075, -30831056, -12805180, 18008031, 10258577}, + }, + { + FieldElement{-22448644, 15655569, 7018479, -4410003, -30314266, -1201591, -1853465, 1367120, 25127874, 6671743}, + FieldElement{29701166, -14373934, -10878120, 9279288, -17568, 13127210, 21382910, 11042292, 25838796, 4642684}, + FieldElement{-20430234, 14955537, -24126347, 8124619, -5369288, -5990470, 30468147, -13900640, 18423289, 4177476}, + }, + }, +} diff --git a/vendor/src/github.com/agl/ed25519/edwards25519/edwards25519.go b/vendor/src/github.com/agl/ed25519/edwards25519/edwards25519.go new file mode 100644 index 0000000000..184b4a8596 --- /dev/null +++ b/vendor/src/github.com/agl/ed25519/edwards25519/edwards25519.go @@ -0,0 +1,2127 @@ +// Copyright 2013 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Package edwards25519 implements operations in GF(2**255-19) and on an +// Edwards curve that is isomorphic to curve25519. See +// http://ed25519.cr.yp.to/. +package edwards25519 + +// This code is a port of the public domain, "ref10" implementation of ed25519 +// from SUPERCOP. + +// FieldElement represents an element of the field GF(2^255 - 19). An element +// t, entries t[0]...t[9], represents the integer t[0]+2^26 t[1]+2^51 t[2]+2^77 +// t[3]+2^102 t[4]+...+2^230 t[9]. Bounds on each t[i] vary depending on +// context. +type FieldElement [10]int32 + +func FeZero(fe *FieldElement) { + for i := range fe { + fe[i] = 0 + } +} + +func FeOne(fe *FieldElement) { + FeZero(fe) + fe[0] = 1 +} + +func FeAdd(dst, a, b *FieldElement) { + for i := range dst { + dst[i] = a[i] + b[i] + } +} + +func FeSub(dst, a, b *FieldElement) { + for i := range dst { + dst[i] = a[i] - b[i] + } +} + +func FeCopy(dst, src *FieldElement) { + for i := range dst { + dst[i] = src[i] + } +} + +// Replace (f,g) with (g,g) if b == 1; +// replace (f,g) with (f,g) if b == 0. +// +// Preconditions: b in {0,1}. +func FeCMove(f, g *FieldElement, b int32) { + var x FieldElement + b = -b + for i := range x { + x[i] = b & (f[i] ^ g[i]) + } + + for i := range f { + f[i] ^= x[i] + } +} + +func load3(in []byte) int64 { + var r int64 + r = int64(in[0]) + r |= int64(in[1]) << 8 + r |= int64(in[2]) << 16 + return r +} + +func load4(in []byte) int64 { + var r int64 + r = int64(in[0]) + r |= int64(in[1]) << 8 + r |= int64(in[2]) << 16 + r |= int64(in[3]) << 24 + return r +} + +func FeFromBytes(dst *FieldElement, src *[32]byte) { + h0 := load4(src[:]) + h1 := load3(src[4:]) << 6 + h2 := load3(src[7:]) << 5 + h3 := load3(src[10:]) << 3 + h4 := load3(src[13:]) << 2 + h5 := load4(src[16:]) + h6 := load3(src[20:]) << 7 + h7 := load3(src[23:]) << 5 + h8 := load3(src[26:]) << 4 + h9 := (load3(src[29:]) & 8388607) << 2 + + var carry [10]int64 + carry[9] = (h9 + 1<<24) >> 25 + h0 += carry[9] * 19 + h9 -= carry[9] << 25 + carry[1] = (h1 + 1<<24) >> 25 + h2 += carry[1] + h1 -= carry[1] << 25 + carry[3] = (h3 + 1<<24) >> 25 + h4 += carry[3] + h3 -= carry[3] << 25 + carry[5] = (h5 + 1<<24) >> 25 + h6 += carry[5] + h5 -= carry[5] << 25 + carry[7] = (h7 + 1<<24) >> 25 + h8 += carry[7] + h7 -= carry[7] << 25 + + carry[0] = (h0 + 1<<25) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + carry[2] = (h2 + 1<<25) >> 26 + h3 += carry[2] + h2 -= carry[2] << 26 + carry[4] = (h4 + 1<<25) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + carry[6] = (h6 + 1<<25) >> 26 + h7 += carry[6] + h6 -= carry[6] << 26 + carry[8] = (h8 + 1<<25) >> 26 + h9 += carry[8] + h8 -= carry[8] << 26 + + dst[0] = int32(h0) + dst[1] = int32(h1) + dst[2] = int32(h2) + dst[3] = int32(h3) + dst[4] = int32(h4) + dst[5] = int32(h5) + dst[6] = int32(h6) + dst[7] = int32(h7) + dst[8] = int32(h8) + dst[9] = int32(h9) +} + +// FeToBytes marshals h to s. +// Preconditions: +// |h| bounded by 1.1*2^25,1.1*2^24,1.1*2^25,1.1*2^24,etc. +// +// Write p=2^255-19; q=floor(h/p). +// Basic claim: q = floor(2^(-255)(h + 19 2^(-25)h9 + 2^(-1))). +// +// Proof: +// Have |h|<=p so |q|<=1 so |19^2 2^(-255) q|<1/4. +// Also have |h-2^230 h9|<2^230 so |19 2^(-255)(h-2^230 h9)|<1/4. +// +// Write y=2^(-1)-19^2 2^(-255)q-19 2^(-255)(h-2^230 h9). +// Then 0> 25 + q = (h[0] + q) >> 26 + q = (h[1] + q) >> 25 + q = (h[2] + q) >> 26 + q = (h[3] + q) >> 25 + q = (h[4] + q) >> 26 + q = (h[5] + q) >> 25 + q = (h[6] + q) >> 26 + q = (h[7] + q) >> 25 + q = (h[8] + q) >> 26 + q = (h[9] + q) >> 25 + + // Goal: Output h-(2^255-19)q, which is between 0 and 2^255-20. + h[0] += 19 * q + // Goal: Output h-2^255 q, which is between 0 and 2^255-20. + + carry[0] = h[0] >> 26 + h[1] += carry[0] + h[0] -= carry[0] << 26 + carry[1] = h[1] >> 25 + h[2] += carry[1] + h[1] -= carry[1] << 25 + carry[2] = h[2] >> 26 + h[3] += carry[2] + h[2] -= carry[2] << 26 + carry[3] = h[3] >> 25 + h[4] += carry[3] + h[3] -= carry[3] << 25 + carry[4] = h[4] >> 26 + h[5] += carry[4] + h[4] -= carry[4] << 26 + carry[5] = h[5] >> 25 + h[6] += carry[5] + h[5] -= carry[5] << 25 + carry[6] = h[6] >> 26 + h[7] += carry[6] + h[6] -= carry[6] << 26 + carry[7] = h[7] >> 25 + h[8] += carry[7] + h[7] -= carry[7] << 25 + carry[8] = h[8] >> 26 + h[9] += carry[8] + h[8] -= carry[8] << 26 + carry[9] = h[9] >> 25 + h[9] -= carry[9] << 25 + // h10 = carry9 + + // Goal: Output h[0]+...+2^255 h10-2^255 q, which is between 0 and 2^255-20. + // Have h[0]+...+2^230 h[9] between 0 and 2^255-1; + // evidently 2^255 h10-2^255 q = 0. + // Goal: Output h[0]+...+2^230 h[9]. + + s[0] = byte(h[0] >> 0) + s[1] = byte(h[0] >> 8) + s[2] = byte(h[0] >> 16) + s[3] = byte((h[0] >> 24) | (h[1] << 2)) + s[4] = byte(h[1] >> 6) + s[5] = byte(h[1] >> 14) + s[6] = byte((h[1] >> 22) | (h[2] << 3)) + s[7] = byte(h[2] >> 5) + s[8] = byte(h[2] >> 13) + s[9] = byte((h[2] >> 21) | (h[3] << 5)) + s[10] = byte(h[3] >> 3) + s[11] = byte(h[3] >> 11) + s[12] = byte((h[3] >> 19) | (h[4] << 6)) + s[13] = byte(h[4] >> 2) + s[14] = byte(h[4] >> 10) + s[15] = byte(h[4] >> 18) + s[16] = byte(h[5] >> 0) + s[17] = byte(h[5] >> 8) + s[18] = byte(h[5] >> 16) + s[19] = byte((h[5] >> 24) | (h[6] << 1)) + s[20] = byte(h[6] >> 7) + s[21] = byte(h[6] >> 15) + s[22] = byte((h[6] >> 23) | (h[7] << 3)) + s[23] = byte(h[7] >> 5) + s[24] = byte(h[7] >> 13) + s[25] = byte((h[7] >> 21) | (h[8] << 4)) + s[26] = byte(h[8] >> 4) + s[27] = byte(h[8] >> 12) + s[28] = byte((h[8] >> 20) | (h[9] << 6)) + s[29] = byte(h[9] >> 2) + s[30] = byte(h[9] >> 10) + s[31] = byte(h[9] >> 18) +} + +func FeIsNegative(f *FieldElement) byte { + var s [32]byte + FeToBytes(&s, f) + return s[0] & 1 +} + +func FeIsNonZero(f *FieldElement) int32 { + var s [32]byte + FeToBytes(&s, f) + var x uint8 + for _, b := range s { + x |= b + } + x |= x >> 4 + x |= x >> 2 + x |= x >> 1 + return int32(x & 1) +} + +// FeNeg sets h = -f +// +// Preconditions: +// |f| bounded by 1.1*2^25,1.1*2^24,1.1*2^25,1.1*2^24,etc. +// +// Postconditions: +// |h| bounded by 1.1*2^25,1.1*2^24,1.1*2^25,1.1*2^24,etc. +func FeNeg(h, f *FieldElement) { + for i := range h { + h[i] = -f[i] + } +} + +// FeMul calculates h = f * g +// Can overlap h with f or g. +// +// Preconditions: +// |f| bounded by 1.1*2^26,1.1*2^25,1.1*2^26,1.1*2^25,etc. +// |g| bounded by 1.1*2^26,1.1*2^25,1.1*2^26,1.1*2^25,etc. +// +// Postconditions: +// |h| bounded by 1.1*2^25,1.1*2^24,1.1*2^25,1.1*2^24,etc. +// +// Notes on implementation strategy: +// +// Using schoolbook multiplication. +// Karatsuba would save a little in some cost models. +// +// Most multiplications by 2 and 19 are 32-bit precomputations; +// cheaper than 64-bit postcomputations. +// +// There is one remaining multiplication by 19 in the carry chain; +// one *19 precomputation can be merged into this, +// but the resulting data flow is considerably less clean. +// +// There are 12 carries below. +// 10 of them are 2-way parallelizable and vectorizable. +// Can get away with 11 carries, but then data flow is much deeper. +// +// With tighter constraints on inputs can squeeze carries into int32. +func FeMul(h, f, g *FieldElement) { + f0 := f[0] + f1 := f[1] + f2 := f[2] + f3 := f[3] + f4 := f[4] + f5 := f[5] + f6 := f[6] + f7 := f[7] + f8 := f[8] + f9 := f[9] + g0 := g[0] + g1 := g[1] + g2 := g[2] + g3 := g[3] + g4 := g[4] + g5 := g[5] + g6 := g[6] + g7 := g[7] + g8 := g[8] + g9 := g[9] + g1_19 := 19 * g1 /* 1.4*2^29 */ + g2_19 := 19 * g2 /* 1.4*2^30; still ok */ + g3_19 := 19 * g3 + g4_19 := 19 * g4 + g5_19 := 19 * g5 + g6_19 := 19 * g6 + g7_19 := 19 * g7 + g8_19 := 19 * g8 + g9_19 := 19 * g9 + f1_2 := 2 * f1 + f3_2 := 2 * f3 + f5_2 := 2 * f5 + f7_2 := 2 * f7 + f9_2 := 2 * f9 + f0g0 := int64(f0) * int64(g0) + f0g1 := int64(f0) * int64(g1) + f0g2 := int64(f0) * int64(g2) + f0g3 := int64(f0) * int64(g3) + f0g4 := int64(f0) * int64(g4) + f0g5 := int64(f0) * int64(g5) + f0g6 := int64(f0) * int64(g6) + f0g7 := int64(f0) * int64(g7) + f0g8 := int64(f0) * int64(g8) + f0g9 := int64(f0) * int64(g9) + f1g0 := int64(f1) * int64(g0) + f1g1_2 := int64(f1_2) * int64(g1) + f1g2 := int64(f1) * int64(g2) + f1g3_2 := int64(f1_2) * int64(g3) + f1g4 := int64(f1) * int64(g4) + f1g5_2 := int64(f1_2) * int64(g5) + f1g6 := int64(f1) * int64(g6) + f1g7_2 := int64(f1_2) * int64(g7) + f1g8 := int64(f1) * int64(g8) + f1g9_38 := int64(f1_2) * int64(g9_19) + f2g0 := int64(f2) * int64(g0) + f2g1 := int64(f2) * int64(g1) + f2g2 := int64(f2) * int64(g2) + f2g3 := int64(f2) * int64(g3) + f2g4 := int64(f2) * int64(g4) + f2g5 := int64(f2) * int64(g5) + f2g6 := int64(f2) * int64(g6) + f2g7 := int64(f2) * int64(g7) + f2g8_19 := int64(f2) * int64(g8_19) + f2g9_19 := int64(f2) * int64(g9_19) + f3g0 := int64(f3) * int64(g0) + f3g1_2 := int64(f3_2) * int64(g1) + f3g2 := int64(f3) * int64(g2) + f3g3_2 := int64(f3_2) * int64(g3) + f3g4 := int64(f3) * int64(g4) + f3g5_2 := int64(f3_2) * int64(g5) + f3g6 := int64(f3) * int64(g6) + f3g7_38 := int64(f3_2) * int64(g7_19) + f3g8_19 := int64(f3) * int64(g8_19) + f3g9_38 := int64(f3_2) * int64(g9_19) + f4g0 := int64(f4) * int64(g0) + f4g1 := int64(f4) * int64(g1) + f4g2 := int64(f4) * int64(g2) + f4g3 := int64(f4) * int64(g3) + f4g4 := int64(f4) * int64(g4) + f4g5 := int64(f4) * int64(g5) + f4g6_19 := int64(f4) * int64(g6_19) + f4g7_19 := int64(f4) * int64(g7_19) + f4g8_19 := int64(f4) * int64(g8_19) + f4g9_19 := int64(f4) * int64(g9_19) + f5g0 := int64(f5) * int64(g0) + f5g1_2 := int64(f5_2) * int64(g1) + f5g2 := int64(f5) * int64(g2) + f5g3_2 := int64(f5_2) * int64(g3) + f5g4 := int64(f5) * int64(g4) + f5g5_38 := int64(f5_2) * int64(g5_19) + f5g6_19 := int64(f5) * int64(g6_19) + f5g7_38 := int64(f5_2) * int64(g7_19) + f5g8_19 := int64(f5) * int64(g8_19) + f5g9_38 := int64(f5_2) * int64(g9_19) + f6g0 := int64(f6) * int64(g0) + f6g1 := int64(f6) * int64(g1) + f6g2 := int64(f6) * int64(g2) + f6g3 := int64(f6) * int64(g3) + f6g4_19 := int64(f6) * int64(g4_19) + f6g5_19 := int64(f6) * int64(g5_19) + f6g6_19 := int64(f6) * int64(g6_19) + f6g7_19 := int64(f6) * int64(g7_19) + f6g8_19 := int64(f6) * int64(g8_19) + f6g9_19 := int64(f6) * int64(g9_19) + f7g0 := int64(f7) * int64(g0) + f7g1_2 := int64(f7_2) * int64(g1) + f7g2 := int64(f7) * int64(g2) + f7g3_38 := int64(f7_2) * int64(g3_19) + f7g4_19 := int64(f7) * int64(g4_19) + f7g5_38 := int64(f7_2) * int64(g5_19) + f7g6_19 := int64(f7) * int64(g6_19) + f7g7_38 := int64(f7_2) * int64(g7_19) + f7g8_19 := int64(f7) * int64(g8_19) + f7g9_38 := int64(f7_2) * int64(g9_19) + f8g0 := int64(f8) * int64(g0) + f8g1 := int64(f8) * int64(g1) + f8g2_19 := int64(f8) * int64(g2_19) + f8g3_19 := int64(f8) * int64(g3_19) + f8g4_19 := int64(f8) * int64(g4_19) + f8g5_19 := int64(f8) * int64(g5_19) + f8g6_19 := int64(f8) * int64(g6_19) + f8g7_19 := int64(f8) * int64(g7_19) + f8g8_19 := int64(f8) * int64(g8_19) + f8g9_19 := int64(f8) * int64(g9_19) + f9g0 := int64(f9) * int64(g0) + f9g1_38 := int64(f9_2) * int64(g1_19) + f9g2_19 := int64(f9) * int64(g2_19) + f9g3_38 := int64(f9_2) * int64(g3_19) + f9g4_19 := int64(f9) * int64(g4_19) + f9g5_38 := int64(f9_2) * int64(g5_19) + f9g6_19 := int64(f9) * int64(g6_19) + f9g7_38 := int64(f9_2) * int64(g7_19) + f9g8_19 := int64(f9) * int64(g8_19) + f9g9_38 := int64(f9_2) * int64(g9_19) + h0 := f0g0 + f1g9_38 + f2g8_19 + f3g7_38 + f4g6_19 + f5g5_38 + f6g4_19 + f7g3_38 + f8g2_19 + f9g1_38 + h1 := f0g1 + f1g0 + f2g9_19 + f3g8_19 + f4g7_19 + f5g6_19 + f6g5_19 + f7g4_19 + f8g3_19 + f9g2_19 + h2 := f0g2 + f1g1_2 + f2g0 + f3g9_38 + f4g8_19 + f5g7_38 + f6g6_19 + f7g5_38 + f8g4_19 + f9g3_38 + h3 := f0g3 + f1g2 + f2g1 + f3g0 + f4g9_19 + f5g8_19 + f6g7_19 + f7g6_19 + f8g5_19 + f9g4_19 + h4 := f0g4 + f1g3_2 + f2g2 + f3g1_2 + f4g0 + f5g9_38 + f6g8_19 + f7g7_38 + f8g6_19 + f9g5_38 + h5 := f0g5 + f1g4 + f2g3 + f3g2 + f4g1 + f5g0 + f6g9_19 + f7g8_19 + f8g7_19 + f9g6_19 + h6 := f0g6 + f1g5_2 + f2g4 + f3g3_2 + f4g2 + f5g1_2 + f6g0 + f7g9_38 + f8g8_19 + f9g7_38 + h7 := f0g7 + f1g6 + f2g5 + f3g4 + f4g3 + f5g2 + f6g1 + f7g0 + f8g9_19 + f9g8_19 + h8 := f0g8 + f1g7_2 + f2g6 + f3g5_2 + f4g4 + f5g3_2 + f6g2 + f7g1_2 + f8g0 + f9g9_38 + h9 := f0g9 + f1g8 + f2g7 + f3g6 + f4g5 + f5g4 + f6g3 + f7g2 + f8g1 + f9g0 + var carry [10]int64 + + /* + |h0| <= (1.1*1.1*2^52*(1+19+19+19+19)+1.1*1.1*2^50*(38+38+38+38+38)) + i.e. |h0| <= 1.2*2^59; narrower ranges for h2, h4, h6, h8 + |h1| <= (1.1*1.1*2^51*(1+1+19+19+19+19+19+19+19+19)) + i.e. |h1| <= 1.5*2^58; narrower ranges for h3, h5, h7, h9 + */ + + carry[0] = (h0 + (1 << 25)) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + carry[4] = (h4 + (1 << 25)) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + /* |h0| <= 2^25 */ + /* |h4| <= 2^25 */ + /* |h1| <= 1.51*2^58 */ + /* |h5| <= 1.51*2^58 */ + + carry[1] = (h1 + (1 << 24)) >> 25 + h2 += carry[1] + h1 -= carry[1] << 25 + carry[5] = (h5 + (1 << 24)) >> 25 + h6 += carry[5] + h5 -= carry[5] << 25 + /* |h1| <= 2^24; from now on fits into int32 */ + /* |h5| <= 2^24; from now on fits into int32 */ + /* |h2| <= 1.21*2^59 */ + /* |h6| <= 1.21*2^59 */ + + carry[2] = (h2 + (1 << 25)) >> 26 + h3 += carry[2] + h2 -= carry[2] << 26 + carry[6] = (h6 + (1 << 25)) >> 26 + h7 += carry[6] + h6 -= carry[6] << 26 + /* |h2| <= 2^25; from now on fits into int32 unchanged */ + /* |h6| <= 2^25; from now on fits into int32 unchanged */ + /* |h3| <= 1.51*2^58 */ + /* |h7| <= 1.51*2^58 */ + + carry[3] = (h3 + (1 << 24)) >> 25 + h4 += carry[3] + h3 -= carry[3] << 25 + carry[7] = (h7 + (1 << 24)) >> 25 + h8 += carry[7] + h7 -= carry[7] << 25 + /* |h3| <= 2^24; from now on fits into int32 unchanged */ + /* |h7| <= 2^24; from now on fits into int32 unchanged */ + /* |h4| <= 1.52*2^33 */ + /* |h8| <= 1.52*2^33 */ + + carry[4] = (h4 + (1 << 25)) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + carry[8] = (h8 + (1 << 25)) >> 26 + h9 += carry[8] + h8 -= carry[8] << 26 + /* |h4| <= 2^25; from now on fits into int32 unchanged */ + /* |h8| <= 2^25; from now on fits into int32 unchanged */ + /* |h5| <= 1.01*2^24 */ + /* |h9| <= 1.51*2^58 */ + + carry[9] = (h9 + (1 << 24)) >> 25 + h0 += carry[9] * 19 + h9 -= carry[9] << 25 + /* |h9| <= 2^24; from now on fits into int32 unchanged */ + /* |h0| <= 1.8*2^37 */ + + carry[0] = (h0 + (1 << 25)) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + /* |h0| <= 2^25; from now on fits into int32 unchanged */ + /* |h1| <= 1.01*2^24 */ + + h[0] = int32(h0) + h[1] = int32(h1) + h[2] = int32(h2) + h[3] = int32(h3) + h[4] = int32(h4) + h[5] = int32(h5) + h[6] = int32(h6) + h[7] = int32(h7) + h[8] = int32(h8) + h[9] = int32(h9) +} + +// FeSquare calculates h = f*f. Can overlap h with f. +// +// Preconditions: +// |f| bounded by 1.1*2^26,1.1*2^25,1.1*2^26,1.1*2^25,etc. +// +// Postconditions: +// |h| bounded by 1.1*2^25,1.1*2^24,1.1*2^25,1.1*2^24,etc. +func FeSquare(h, f *FieldElement) { + f0 := f[0] + f1 := f[1] + f2 := f[2] + f3 := f[3] + f4 := f[4] + f5 := f[5] + f6 := f[6] + f7 := f[7] + f8 := f[8] + f9 := f[9] + f0_2 := 2 * f0 + f1_2 := 2 * f1 + f2_2 := 2 * f2 + f3_2 := 2 * f3 + f4_2 := 2 * f4 + f5_2 := 2 * f5 + f6_2 := 2 * f6 + f7_2 := 2 * f7 + f5_38 := 38 * f5 // 1.31*2^30 + f6_19 := 19 * f6 // 1.31*2^30 + f7_38 := 38 * f7 // 1.31*2^30 + f8_19 := 19 * f8 // 1.31*2^30 + f9_38 := 38 * f9 // 1.31*2^30 + f0f0 := int64(f0) * int64(f0) + f0f1_2 := int64(f0_2) * int64(f1) + f0f2_2 := int64(f0_2) * int64(f2) + f0f3_2 := int64(f0_2) * int64(f3) + f0f4_2 := int64(f0_2) * int64(f4) + f0f5_2 := int64(f0_2) * int64(f5) + f0f6_2 := int64(f0_2) * int64(f6) + f0f7_2 := int64(f0_2) * int64(f7) + f0f8_2 := int64(f0_2) * int64(f8) + f0f9_2 := int64(f0_2) * int64(f9) + f1f1_2 := int64(f1_2) * int64(f1) + f1f2_2 := int64(f1_2) * int64(f2) + f1f3_4 := int64(f1_2) * int64(f3_2) + f1f4_2 := int64(f1_2) * int64(f4) + f1f5_4 := int64(f1_2) * int64(f5_2) + f1f6_2 := int64(f1_2) * int64(f6) + f1f7_4 := int64(f1_2) * int64(f7_2) + f1f8_2 := int64(f1_2) * int64(f8) + f1f9_76 := int64(f1_2) * int64(f9_38) + f2f2 := int64(f2) * int64(f2) + f2f3_2 := int64(f2_2) * int64(f3) + f2f4_2 := int64(f2_2) * int64(f4) + f2f5_2 := int64(f2_2) * int64(f5) + f2f6_2 := int64(f2_2) * int64(f6) + f2f7_2 := int64(f2_2) * int64(f7) + f2f8_38 := int64(f2_2) * int64(f8_19) + f2f9_38 := int64(f2) * int64(f9_38) + f3f3_2 := int64(f3_2) * int64(f3) + f3f4_2 := int64(f3_2) * int64(f4) + f3f5_4 := int64(f3_2) * int64(f5_2) + f3f6_2 := int64(f3_2) * int64(f6) + f3f7_76 := int64(f3_2) * int64(f7_38) + f3f8_38 := int64(f3_2) * int64(f8_19) + f3f9_76 := int64(f3_2) * int64(f9_38) + f4f4 := int64(f4) * int64(f4) + f4f5_2 := int64(f4_2) * int64(f5) + f4f6_38 := int64(f4_2) * int64(f6_19) + f4f7_38 := int64(f4) * int64(f7_38) + f4f8_38 := int64(f4_2) * int64(f8_19) + f4f9_38 := int64(f4) * int64(f9_38) + f5f5_38 := int64(f5) * int64(f5_38) + f5f6_38 := int64(f5_2) * int64(f6_19) + f5f7_76 := int64(f5_2) * int64(f7_38) + f5f8_38 := int64(f5_2) * int64(f8_19) + f5f9_76 := int64(f5_2) * int64(f9_38) + f6f6_19 := int64(f6) * int64(f6_19) + f6f7_38 := int64(f6) * int64(f7_38) + f6f8_38 := int64(f6_2) * int64(f8_19) + f6f9_38 := int64(f6) * int64(f9_38) + f7f7_38 := int64(f7) * int64(f7_38) + f7f8_38 := int64(f7_2) * int64(f8_19) + f7f9_76 := int64(f7_2) * int64(f9_38) + f8f8_19 := int64(f8) * int64(f8_19) + f8f9_38 := int64(f8) * int64(f9_38) + f9f9_38 := int64(f9) * int64(f9_38) + h0 := f0f0 + f1f9_76 + f2f8_38 + f3f7_76 + f4f6_38 + f5f5_38 + h1 := f0f1_2 + f2f9_38 + f3f8_38 + f4f7_38 + f5f6_38 + h2 := f0f2_2 + f1f1_2 + f3f9_76 + f4f8_38 + f5f7_76 + f6f6_19 + h3 := f0f3_2 + f1f2_2 + f4f9_38 + f5f8_38 + f6f7_38 + h4 := f0f4_2 + f1f3_4 + f2f2 + f5f9_76 + f6f8_38 + f7f7_38 + h5 := f0f5_2 + f1f4_2 + f2f3_2 + f6f9_38 + f7f8_38 + h6 := f0f6_2 + f1f5_4 + f2f4_2 + f3f3_2 + f7f9_76 + f8f8_19 + h7 := f0f7_2 + f1f6_2 + f2f5_2 + f3f4_2 + f8f9_38 + h8 := f0f8_2 + f1f7_4 + f2f6_2 + f3f5_4 + f4f4 + f9f9_38 + h9 := f0f9_2 + f1f8_2 + f2f7_2 + f3f6_2 + f4f5_2 + var carry [10]int64 + + carry[0] = (h0 + (1 << 25)) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + carry[4] = (h4 + (1 << 25)) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + + carry[1] = (h1 + (1 << 24)) >> 25 + h2 += carry[1] + h1 -= carry[1] << 25 + carry[5] = (h5 + (1 << 24)) >> 25 + h6 += carry[5] + h5 -= carry[5] << 25 + + carry[2] = (h2 + (1 << 25)) >> 26 + h3 += carry[2] + h2 -= carry[2] << 26 + carry[6] = (h6 + (1 << 25)) >> 26 + h7 += carry[6] + h6 -= carry[6] << 26 + + carry[3] = (h3 + (1 << 24)) >> 25 + h4 += carry[3] + h3 -= carry[3] << 25 + carry[7] = (h7 + (1 << 24)) >> 25 + h8 += carry[7] + h7 -= carry[7] << 25 + + carry[4] = (h4 + (1 << 25)) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + carry[8] = (h8 + (1 << 25)) >> 26 + h9 += carry[8] + h8 -= carry[8] << 26 + + carry[9] = (h9 + (1 << 24)) >> 25 + h0 += carry[9] * 19 + h9 -= carry[9] << 25 + + carry[0] = (h0 + (1 << 25)) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + + h[0] = int32(h0) + h[1] = int32(h1) + h[2] = int32(h2) + h[3] = int32(h3) + h[4] = int32(h4) + h[5] = int32(h5) + h[6] = int32(h6) + h[7] = int32(h7) + h[8] = int32(h8) + h[9] = int32(h9) +} + +// FeSquare2 sets h = 2 * f * f +// +// Can overlap h with f. +// +// Preconditions: +// |f| bounded by 1.65*2^26,1.65*2^25,1.65*2^26,1.65*2^25,etc. +// +// Postconditions: +// |h| bounded by 1.01*2^25,1.01*2^24,1.01*2^25,1.01*2^24,etc. +// See fe_mul.c for discussion of implementation strategy. +func FeSquare2(h, f *FieldElement) { + f0 := f[0] + f1 := f[1] + f2 := f[2] + f3 := f[3] + f4 := f[4] + f5 := f[5] + f6 := f[6] + f7 := f[7] + f8 := f[8] + f9 := f[9] + f0_2 := 2 * f0 + f1_2 := 2 * f1 + f2_2 := 2 * f2 + f3_2 := 2 * f3 + f4_2 := 2 * f4 + f5_2 := 2 * f5 + f6_2 := 2 * f6 + f7_2 := 2 * f7 + f5_38 := 38 * f5 // 1.959375*2^30 + f6_19 := 19 * f6 // 1.959375*2^30 + f7_38 := 38 * f7 // 1.959375*2^30 + f8_19 := 19 * f8 // 1.959375*2^30 + f9_38 := 38 * f9 // 1.959375*2^30 + f0f0 := int64(f0) * int64(f0) + f0f1_2 := int64(f0_2) * int64(f1) + f0f2_2 := int64(f0_2) * int64(f2) + f0f3_2 := int64(f0_2) * int64(f3) + f0f4_2 := int64(f0_2) * int64(f4) + f0f5_2 := int64(f0_2) * int64(f5) + f0f6_2 := int64(f0_2) * int64(f6) + f0f7_2 := int64(f0_2) * int64(f7) + f0f8_2 := int64(f0_2) * int64(f8) + f0f9_2 := int64(f0_2) * int64(f9) + f1f1_2 := int64(f1_2) * int64(f1) + f1f2_2 := int64(f1_2) * int64(f2) + f1f3_4 := int64(f1_2) * int64(f3_2) + f1f4_2 := int64(f1_2) * int64(f4) + f1f5_4 := int64(f1_2) * int64(f5_2) + f1f6_2 := int64(f1_2) * int64(f6) + f1f7_4 := int64(f1_2) * int64(f7_2) + f1f8_2 := int64(f1_2) * int64(f8) + f1f9_76 := int64(f1_2) * int64(f9_38) + f2f2 := int64(f2) * int64(f2) + f2f3_2 := int64(f2_2) * int64(f3) + f2f4_2 := int64(f2_2) * int64(f4) + f2f5_2 := int64(f2_2) * int64(f5) + f2f6_2 := int64(f2_2) * int64(f6) + f2f7_2 := int64(f2_2) * int64(f7) + f2f8_38 := int64(f2_2) * int64(f8_19) + f2f9_38 := int64(f2) * int64(f9_38) + f3f3_2 := int64(f3_2) * int64(f3) + f3f4_2 := int64(f3_2) * int64(f4) + f3f5_4 := int64(f3_2) * int64(f5_2) + f3f6_2 := int64(f3_2) * int64(f6) + f3f7_76 := int64(f3_2) * int64(f7_38) + f3f8_38 := int64(f3_2) * int64(f8_19) + f3f9_76 := int64(f3_2) * int64(f9_38) + f4f4 := int64(f4) * int64(f4) + f4f5_2 := int64(f4_2) * int64(f5) + f4f6_38 := int64(f4_2) * int64(f6_19) + f4f7_38 := int64(f4) * int64(f7_38) + f4f8_38 := int64(f4_2) * int64(f8_19) + f4f9_38 := int64(f4) * int64(f9_38) + f5f5_38 := int64(f5) * int64(f5_38) + f5f6_38 := int64(f5_2) * int64(f6_19) + f5f7_76 := int64(f5_2) * int64(f7_38) + f5f8_38 := int64(f5_2) * int64(f8_19) + f5f9_76 := int64(f5_2) * int64(f9_38) + f6f6_19 := int64(f6) * int64(f6_19) + f6f7_38 := int64(f6) * int64(f7_38) + f6f8_38 := int64(f6_2) * int64(f8_19) + f6f9_38 := int64(f6) * int64(f9_38) + f7f7_38 := int64(f7) * int64(f7_38) + f7f8_38 := int64(f7_2) * int64(f8_19) + f7f9_76 := int64(f7_2) * int64(f9_38) + f8f8_19 := int64(f8) * int64(f8_19) + f8f9_38 := int64(f8) * int64(f9_38) + f9f9_38 := int64(f9) * int64(f9_38) + h0 := f0f0 + f1f9_76 + f2f8_38 + f3f7_76 + f4f6_38 + f5f5_38 + h1 := f0f1_2 + f2f9_38 + f3f8_38 + f4f7_38 + f5f6_38 + h2 := f0f2_2 + f1f1_2 + f3f9_76 + f4f8_38 + f5f7_76 + f6f6_19 + h3 := f0f3_2 + f1f2_2 + f4f9_38 + f5f8_38 + f6f7_38 + h4 := f0f4_2 + f1f3_4 + f2f2 + f5f9_76 + f6f8_38 + f7f7_38 + h5 := f0f5_2 + f1f4_2 + f2f3_2 + f6f9_38 + f7f8_38 + h6 := f0f6_2 + f1f5_4 + f2f4_2 + f3f3_2 + f7f9_76 + f8f8_19 + h7 := f0f7_2 + f1f6_2 + f2f5_2 + f3f4_2 + f8f9_38 + h8 := f0f8_2 + f1f7_4 + f2f6_2 + f3f5_4 + f4f4 + f9f9_38 + h9 := f0f9_2 + f1f8_2 + f2f7_2 + f3f6_2 + f4f5_2 + var carry [10]int64 + + h0 += h0 + h1 += h1 + h2 += h2 + h3 += h3 + h4 += h4 + h5 += h5 + h6 += h6 + h7 += h7 + h8 += h8 + h9 += h9 + + carry[0] = (h0 + (1 << 25)) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + carry[4] = (h4 + (1 << 25)) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + + carry[1] = (h1 + (1 << 24)) >> 25 + h2 += carry[1] + h1 -= carry[1] << 25 + carry[5] = (h5 + (1 << 24)) >> 25 + h6 += carry[5] + h5 -= carry[5] << 25 + + carry[2] = (h2 + (1 << 25)) >> 26 + h3 += carry[2] + h2 -= carry[2] << 26 + carry[6] = (h6 + (1 << 25)) >> 26 + h7 += carry[6] + h6 -= carry[6] << 26 + + carry[3] = (h3 + (1 << 24)) >> 25 + h4 += carry[3] + h3 -= carry[3] << 25 + carry[7] = (h7 + (1 << 24)) >> 25 + h8 += carry[7] + h7 -= carry[7] << 25 + + carry[4] = (h4 + (1 << 25)) >> 26 + h5 += carry[4] + h4 -= carry[4] << 26 + carry[8] = (h8 + (1 << 25)) >> 26 + h9 += carry[8] + h8 -= carry[8] << 26 + + carry[9] = (h9 + (1 << 24)) >> 25 + h0 += carry[9] * 19 + h9 -= carry[9] << 25 + + carry[0] = (h0 + (1 << 25)) >> 26 + h1 += carry[0] + h0 -= carry[0] << 26 + + h[0] = int32(h0) + h[1] = int32(h1) + h[2] = int32(h2) + h[3] = int32(h3) + h[4] = int32(h4) + h[5] = int32(h5) + h[6] = int32(h6) + h[7] = int32(h7) + h[8] = int32(h8) + h[9] = int32(h9) +} + +func FeInvert(out, z *FieldElement) { + var t0, t1, t2, t3 FieldElement + var i int + + FeSquare(&t0, z) // 2^1 + FeSquare(&t1, &t0) // 2^2 + for i = 1; i < 2; i++ { // 2^3 + FeSquare(&t1, &t1) + } + FeMul(&t1, z, &t1) // 2^3 + 2^0 + FeMul(&t0, &t0, &t1) // 2^3 + 2^1 + 2^0 + FeSquare(&t2, &t0) // 2^4 + 2^2 + 2^1 + FeMul(&t1, &t1, &t2) // 2^4 + 2^3 + 2^2 + 2^1 + 2^0 + FeSquare(&t2, &t1) // 5,4,3,2,1 + for i = 1; i < 5; i++ { // 9,8,7,6,5 + FeSquare(&t2, &t2) + } + FeMul(&t1, &t2, &t1) // 9,8,7,6,5,4,3,2,1,0 + FeSquare(&t2, &t1) // 10..1 + for i = 1; i < 10; i++ { // 19..10 + FeSquare(&t2, &t2) + } + FeMul(&t2, &t2, &t1) // 19..0 + FeSquare(&t3, &t2) // 20..1 + for i = 1; i < 20; i++ { // 39..20 + FeSquare(&t3, &t3) + } + FeMul(&t2, &t3, &t2) // 39..0 + FeSquare(&t2, &t2) // 40..1 + for i = 1; i < 10; i++ { // 49..10 + FeSquare(&t2, &t2) + } + FeMul(&t1, &t2, &t1) // 49..0 + FeSquare(&t2, &t1) // 50..1 + for i = 1; i < 50; i++ { // 99..50 + FeSquare(&t2, &t2) + } + FeMul(&t2, &t2, &t1) // 99..0 + FeSquare(&t3, &t2) // 100..1 + for i = 1; i < 100; i++ { // 199..100 + FeSquare(&t3, &t3) + } + FeMul(&t2, &t3, &t2) // 199..0 + FeSquare(&t2, &t2) // 200..1 + for i = 1; i < 50; i++ { // 249..50 + FeSquare(&t2, &t2) + } + FeMul(&t1, &t2, &t1) // 249..0 + FeSquare(&t1, &t1) // 250..1 + for i = 1; i < 5; i++ { // 254..5 + FeSquare(&t1, &t1) + } + FeMul(out, &t1, &t0) // 254..5,3,1,0 +} + +func fePow22523(out, z *FieldElement) { + var t0, t1, t2 FieldElement + var i int + + FeSquare(&t0, z) + for i = 1; i < 1; i++ { + FeSquare(&t0, &t0) + } + FeSquare(&t1, &t0) + for i = 1; i < 2; i++ { + FeSquare(&t1, &t1) + } + FeMul(&t1, z, &t1) + FeMul(&t0, &t0, &t1) + FeSquare(&t0, &t0) + for i = 1; i < 1; i++ { + FeSquare(&t0, &t0) + } + FeMul(&t0, &t1, &t0) + FeSquare(&t1, &t0) + for i = 1; i < 5; i++ { + FeSquare(&t1, &t1) + } + FeMul(&t0, &t1, &t0) + FeSquare(&t1, &t0) + for i = 1; i < 10; i++ { + FeSquare(&t1, &t1) + } + FeMul(&t1, &t1, &t0) + FeSquare(&t2, &t1) + for i = 1; i < 20; i++ { + FeSquare(&t2, &t2) + } + FeMul(&t1, &t2, &t1) + FeSquare(&t1, &t1) + for i = 1; i < 10; i++ { + FeSquare(&t1, &t1) + } + FeMul(&t0, &t1, &t0) + FeSquare(&t1, &t0) + for i = 1; i < 50; i++ { + FeSquare(&t1, &t1) + } + FeMul(&t1, &t1, &t0) + FeSquare(&t2, &t1) + for i = 1; i < 100; i++ { + FeSquare(&t2, &t2) + } + FeMul(&t1, &t2, &t1) + FeSquare(&t1, &t1) + for i = 1; i < 50; i++ { + FeSquare(&t1, &t1) + } + FeMul(&t0, &t1, &t0) + FeSquare(&t0, &t0) + for i = 1; i < 2; i++ { + FeSquare(&t0, &t0) + } + FeMul(out, &t0, z) +} + +// Group elements are members of the elliptic curve -x^2 + y^2 = 1 + d * x^2 * +// y^2 where d = -121665/121666. +// +// Several representations are used: +// ProjectiveGroupElement: (X:Y:Z) satisfying x=X/Z, y=Y/Z +// ExtendedGroupElement: (X:Y:Z:T) satisfying x=X/Z, y=Y/Z, XY=ZT +// CompletedGroupElement: ((X:Z),(Y:T)) satisfying x=X/Z, y=Y/T +// PreComputedGroupElement: (y+x,y-x,2dxy) + +type ProjectiveGroupElement struct { + X, Y, Z FieldElement +} + +type ExtendedGroupElement struct { + X, Y, Z, T FieldElement +} + +type CompletedGroupElement struct { + X, Y, Z, T FieldElement +} + +type PreComputedGroupElement struct { + yPlusX, yMinusX, xy2d FieldElement +} + +type CachedGroupElement struct { + yPlusX, yMinusX, Z, T2d FieldElement +} + +func (p *ProjectiveGroupElement) Zero() { + FeZero(&p.X) + FeOne(&p.Y) + FeOne(&p.Z) +} + +func (p *ProjectiveGroupElement) Double(r *CompletedGroupElement) { + var t0 FieldElement + + FeSquare(&r.X, &p.X) + FeSquare(&r.Z, &p.Y) + FeSquare2(&r.T, &p.Z) + FeAdd(&r.Y, &p.X, &p.Y) + FeSquare(&t0, &r.Y) + FeAdd(&r.Y, &r.Z, &r.X) + FeSub(&r.Z, &r.Z, &r.X) + FeSub(&r.X, &t0, &r.Y) + FeSub(&r.T, &r.T, &r.Z) +} + +func (p *ProjectiveGroupElement) ToBytes(s *[32]byte) { + var recip, x, y FieldElement + + FeInvert(&recip, &p.Z) + FeMul(&x, &p.X, &recip) + FeMul(&y, &p.Y, &recip) + FeToBytes(s, &y) + s[31] ^= FeIsNegative(&x) << 7 +} + +func (p *ExtendedGroupElement) Zero() { + FeZero(&p.X) + FeOne(&p.Y) + FeOne(&p.Z) + FeZero(&p.T) +} + +func (p *ExtendedGroupElement) Double(r *CompletedGroupElement) { + var q ProjectiveGroupElement + p.ToProjective(&q) + q.Double(r) +} + +func (p *ExtendedGroupElement) ToCached(r *CachedGroupElement) { + FeAdd(&r.yPlusX, &p.Y, &p.X) + FeSub(&r.yMinusX, &p.Y, &p.X) + FeCopy(&r.Z, &p.Z) + FeMul(&r.T2d, &p.T, &d2) +} + +func (p *ExtendedGroupElement) ToProjective(r *ProjectiveGroupElement) { + FeCopy(&r.X, &p.X) + FeCopy(&r.Y, &p.Y) + FeCopy(&r.Z, &p.Z) +} + +func (p *ExtendedGroupElement) ToBytes(s *[32]byte) { + var recip, x, y FieldElement + + FeInvert(&recip, &p.Z) + FeMul(&x, &p.X, &recip) + FeMul(&y, &p.Y, &recip) + FeToBytes(s, &y) + s[31] ^= FeIsNegative(&x) << 7 +} + +func (p *ExtendedGroupElement) FromBytes(s *[32]byte) bool { + var u, v, v3, vxx, check FieldElement + + FeFromBytes(&p.Y, s) + FeOne(&p.Z) + FeSquare(&u, &p.Y) + FeMul(&v, &u, &d) + FeSub(&u, &u, &p.Z) // y = y^2-1 + FeAdd(&v, &v, &p.Z) // v = dy^2+1 + + FeSquare(&v3, &v) + FeMul(&v3, &v3, &v) // v3 = v^3 + FeSquare(&p.X, &v3) + FeMul(&p.X, &p.X, &v) + FeMul(&p.X, &p.X, &u) // x = uv^7 + + fePow22523(&p.X, &p.X) // x = (uv^7)^((q-5)/8) + FeMul(&p.X, &p.X, &v3) + FeMul(&p.X, &p.X, &u) // x = uv^3(uv^7)^((q-5)/8) + + var tmpX, tmp2 [32]byte + + FeSquare(&vxx, &p.X) + FeMul(&vxx, &vxx, &v) + FeSub(&check, &vxx, &u) // vx^2-u + if FeIsNonZero(&check) == 1 { + FeAdd(&check, &vxx, &u) // vx^2+u + if FeIsNonZero(&check) == 1 { + return false + } + FeMul(&p.X, &p.X, &SqrtM1) + + FeToBytes(&tmpX, &p.X) + for i, v := range tmpX { + tmp2[31-i] = v + } + } + + if FeIsNegative(&p.X) == (s[31] >> 7) { + FeNeg(&p.X, &p.X) + } + + FeMul(&p.T, &p.X, &p.Y) + return true +} + +func (p *CompletedGroupElement) ToProjective(r *ProjectiveGroupElement) { + FeMul(&r.X, &p.X, &p.T) + FeMul(&r.Y, &p.Y, &p.Z) + FeMul(&r.Z, &p.Z, &p.T) +} + +func (p *CompletedGroupElement) ToExtended(r *ExtendedGroupElement) { + FeMul(&r.X, &p.X, &p.T) + FeMul(&r.Y, &p.Y, &p.Z) + FeMul(&r.Z, &p.Z, &p.T) + FeMul(&r.T, &p.X, &p.Y) +} + +func (p *PreComputedGroupElement) Zero() { + FeOne(&p.yPlusX) + FeOne(&p.yMinusX) + FeZero(&p.xy2d) +} + +func geAdd(r *CompletedGroupElement, p *ExtendedGroupElement, q *CachedGroupElement) { + var t0 FieldElement + + FeAdd(&r.X, &p.Y, &p.X) + FeSub(&r.Y, &p.Y, &p.X) + FeMul(&r.Z, &r.X, &q.yPlusX) + FeMul(&r.Y, &r.Y, &q.yMinusX) + FeMul(&r.T, &q.T2d, &p.T) + FeMul(&r.X, &p.Z, &q.Z) + FeAdd(&t0, &r.X, &r.X) + FeSub(&r.X, &r.Z, &r.Y) + FeAdd(&r.Y, &r.Z, &r.Y) + FeAdd(&r.Z, &t0, &r.T) + FeSub(&r.T, &t0, &r.T) +} + +func geSub(r *CompletedGroupElement, p *ExtendedGroupElement, q *CachedGroupElement) { + var t0 FieldElement + + FeAdd(&r.X, &p.Y, &p.X) + FeSub(&r.Y, &p.Y, &p.X) + FeMul(&r.Z, &r.X, &q.yMinusX) + FeMul(&r.Y, &r.Y, &q.yPlusX) + FeMul(&r.T, &q.T2d, &p.T) + FeMul(&r.X, &p.Z, &q.Z) + FeAdd(&t0, &r.X, &r.X) + FeSub(&r.X, &r.Z, &r.Y) + FeAdd(&r.Y, &r.Z, &r.Y) + FeSub(&r.Z, &t0, &r.T) + FeAdd(&r.T, &t0, &r.T) +} + +func geMixedAdd(r *CompletedGroupElement, p *ExtendedGroupElement, q *PreComputedGroupElement) { + var t0 FieldElement + + FeAdd(&r.X, &p.Y, &p.X) + FeSub(&r.Y, &p.Y, &p.X) + FeMul(&r.Z, &r.X, &q.yPlusX) + FeMul(&r.Y, &r.Y, &q.yMinusX) + FeMul(&r.T, &q.xy2d, &p.T) + FeAdd(&t0, &p.Z, &p.Z) + FeSub(&r.X, &r.Z, &r.Y) + FeAdd(&r.Y, &r.Z, &r.Y) + FeAdd(&r.Z, &t0, &r.T) + FeSub(&r.T, &t0, &r.T) +} + +func geMixedSub(r *CompletedGroupElement, p *ExtendedGroupElement, q *PreComputedGroupElement) { + var t0 FieldElement + + FeAdd(&r.X, &p.Y, &p.X) + FeSub(&r.Y, &p.Y, &p.X) + FeMul(&r.Z, &r.X, &q.yMinusX) + FeMul(&r.Y, &r.Y, &q.yPlusX) + FeMul(&r.T, &q.xy2d, &p.T) + FeAdd(&t0, &p.Z, &p.Z) + FeSub(&r.X, &r.Z, &r.Y) + FeAdd(&r.Y, &r.Z, &r.Y) + FeSub(&r.Z, &t0, &r.T) + FeAdd(&r.T, &t0, &r.T) +} + +func slide(r *[256]int8, a *[32]byte) { + for i := range r { + r[i] = int8(1 & (a[i>>3] >> uint(i&7))) + } + + for i := range r { + if r[i] != 0 { + for b := 1; b <= 6 && i+b < 256; b++ { + if r[i+b] != 0 { + if r[i]+(r[i+b]<= -15 { + r[i] -= r[i+b] << uint(b) + for k := i + b; k < 256; k++ { + if r[k] == 0 { + r[k] = 1 + break + } + r[k] = 0 + } + } else { + break + } + } + } + } + } +} + +// GeDoubleScalarMultVartime sets r = a*A + b*B +// where a = a[0]+256*a[1]+...+256^31 a[31]. +// and b = b[0]+256*b[1]+...+256^31 b[31]. +// B is the Ed25519 base point (x,4/5) with x positive. +func GeDoubleScalarMultVartime(r *ProjectiveGroupElement, a *[32]byte, A *ExtendedGroupElement, b *[32]byte) { + var aSlide, bSlide [256]int8 + var Ai [8]CachedGroupElement // A,3A,5A,7A,9A,11A,13A,15A + var t CompletedGroupElement + var u, A2 ExtendedGroupElement + var i int + + slide(&aSlide, a) + slide(&bSlide, b) + + A.ToCached(&Ai[0]) + A.Double(&t) + t.ToExtended(&A2) + + for i := 0; i < 7; i++ { + geAdd(&t, &A2, &Ai[i]) + t.ToExtended(&u) + u.ToCached(&Ai[i+1]) + } + + r.Zero() + + for i = 255; i >= 0; i-- { + if aSlide[i] != 0 || bSlide[i] != 0 { + break + } + } + + for ; i >= 0; i-- { + r.Double(&t) + + if aSlide[i] > 0 { + t.ToExtended(&u) + geAdd(&t, &u, &Ai[aSlide[i]/2]) + } else if aSlide[i] < 0 { + t.ToExtended(&u) + geSub(&t, &u, &Ai[(-aSlide[i])/2]) + } + + if bSlide[i] > 0 { + t.ToExtended(&u) + geMixedAdd(&t, &u, &bi[bSlide[i]/2]) + } else if bSlide[i] < 0 { + t.ToExtended(&u) + geMixedSub(&t, &u, &bi[(-bSlide[i])/2]) + } + + t.ToProjective(r) + } +} + +// equal returns 1 if b == c and 0 otherwise. +func equal(b, c int32) int32 { + x := uint32(b ^ c) + x-- + return int32(x >> 31) +} + +// negative returns 1 if b < 0 and 0 otherwise. +func negative(b int32) int32 { + return (b >> 31) & 1 +} + +func PreComputedGroupElementCMove(t, u *PreComputedGroupElement, b int32) { + FeCMove(&t.yPlusX, &u.yPlusX, b) + FeCMove(&t.yMinusX, &u.yMinusX, b) + FeCMove(&t.xy2d, &u.xy2d, b) +} + +func selectPoint(t *PreComputedGroupElement, pos int32, b int32) { + var minusT PreComputedGroupElement + bNegative := negative(b) + bAbs := b - (((-bNegative) & b) << 1) + + t.Zero() + for i := int32(0); i < 8; i++ { + PreComputedGroupElementCMove(t, &base[pos][i], equal(bAbs, i+1)) + } + FeCopy(&minusT.yPlusX, &t.yMinusX) + FeCopy(&minusT.yMinusX, &t.yPlusX) + FeNeg(&minusT.xy2d, &t.xy2d) + PreComputedGroupElementCMove(t, &minusT, bNegative) +} + +// GeScalarMultBase computes h = a*B, where +// a = a[0]+256*a[1]+...+256^31 a[31] +// B is the Ed25519 base point (x,4/5) with x positive. +// +// Preconditions: +// a[31] <= 127 +func GeScalarMultBase(h *ExtendedGroupElement, a *[32]byte) { + var e [64]int8 + + for i, v := range a { + e[2*i] = int8(v & 15) + e[2*i+1] = int8((v >> 4) & 15) + } + + // each e[i] is between 0 and 15 and e[63] is between 0 and 7. + + carry := int8(0) + for i := 0; i < 63; i++ { + e[i] += carry + carry = (e[i] + 8) >> 4 + e[i] -= carry << 4 + } + e[63] += carry + // each e[i] is between -8 and 8. + + h.Zero() + var t PreComputedGroupElement + var r CompletedGroupElement + for i := int32(1); i < 64; i += 2 { + selectPoint(&t, i/2, int32(e[i])) + geMixedAdd(&r, h, &t) + r.ToExtended(h) + } + + var s ProjectiveGroupElement + + h.Double(&r) + r.ToProjective(&s) + s.Double(&r) + r.ToProjective(&s) + s.Double(&r) + r.ToProjective(&s) + s.Double(&r) + r.ToExtended(h) + + for i := int32(0); i < 64; i += 2 { + selectPoint(&t, i/2, int32(e[i])) + geMixedAdd(&r, h, &t) + r.ToExtended(h) + } +} + +// The scalars are GF(2^252 + 27742317777372353535851937790883648493). + +// Input: +// a[0]+256*a[1]+...+256^31*a[31] = a +// b[0]+256*b[1]+...+256^31*b[31] = b +// c[0]+256*c[1]+...+256^31*c[31] = c +// +// Output: +// s[0]+256*s[1]+...+256^31*s[31] = (ab+c) mod l +// where l = 2^252 + 27742317777372353535851937790883648493. +func ScMulAdd(s, a, b, c *[32]byte) { + a0 := 2097151 & load3(a[:]) + a1 := 2097151 & (load4(a[2:]) >> 5) + a2 := 2097151 & (load3(a[5:]) >> 2) + a3 := 2097151 & (load4(a[7:]) >> 7) + a4 := 2097151 & (load4(a[10:]) >> 4) + a5 := 2097151 & (load3(a[13:]) >> 1) + a6 := 2097151 & (load4(a[15:]) >> 6) + a7 := 2097151 & (load3(a[18:]) >> 3) + a8 := 2097151 & load3(a[21:]) + a9 := 2097151 & (load4(a[23:]) >> 5) + a10 := 2097151 & (load3(a[26:]) >> 2) + a11 := (load4(a[28:]) >> 7) + b0 := 2097151 & load3(b[:]) + b1 := 2097151 & (load4(b[2:]) >> 5) + b2 := 2097151 & (load3(b[5:]) >> 2) + b3 := 2097151 & (load4(b[7:]) >> 7) + b4 := 2097151 & (load4(b[10:]) >> 4) + b5 := 2097151 & (load3(b[13:]) >> 1) + b6 := 2097151 & (load4(b[15:]) >> 6) + b7 := 2097151 & (load3(b[18:]) >> 3) + b8 := 2097151 & load3(b[21:]) + b9 := 2097151 & (load4(b[23:]) >> 5) + b10 := 2097151 & (load3(b[26:]) >> 2) + b11 := (load4(b[28:]) >> 7) + c0 := 2097151 & load3(c[:]) + c1 := 2097151 & (load4(c[2:]) >> 5) + c2 := 2097151 & (load3(c[5:]) >> 2) + c3 := 2097151 & (load4(c[7:]) >> 7) + c4 := 2097151 & (load4(c[10:]) >> 4) + c5 := 2097151 & (load3(c[13:]) >> 1) + c6 := 2097151 & (load4(c[15:]) >> 6) + c7 := 2097151 & (load3(c[18:]) >> 3) + c8 := 2097151 & load3(c[21:]) + c9 := 2097151 & (load4(c[23:]) >> 5) + c10 := 2097151 & (load3(c[26:]) >> 2) + c11 := (load4(c[28:]) >> 7) + var carry [23]int64 + + s0 := c0 + a0*b0 + s1 := c1 + a0*b1 + a1*b0 + s2 := c2 + a0*b2 + a1*b1 + a2*b0 + s3 := c3 + a0*b3 + a1*b2 + a2*b1 + a3*b0 + s4 := c4 + a0*b4 + a1*b3 + a2*b2 + a3*b1 + a4*b0 + s5 := c5 + a0*b5 + a1*b4 + a2*b3 + a3*b2 + a4*b1 + a5*b0 + s6 := c6 + a0*b6 + a1*b5 + a2*b4 + a3*b3 + a4*b2 + a5*b1 + a6*b0 + s7 := c7 + a0*b7 + a1*b6 + a2*b5 + a3*b4 + a4*b3 + a5*b2 + a6*b1 + a7*b0 + s8 := c8 + a0*b8 + a1*b7 + a2*b6 + a3*b5 + a4*b4 + a5*b3 + a6*b2 + a7*b1 + a8*b0 + s9 := c9 + a0*b9 + a1*b8 + a2*b7 + a3*b6 + a4*b5 + a5*b4 + a6*b3 + a7*b2 + a8*b1 + a9*b0 + s10 := c10 + a0*b10 + a1*b9 + a2*b8 + a3*b7 + a4*b6 + a5*b5 + a6*b4 + a7*b3 + a8*b2 + a9*b1 + a10*b0 + s11 := c11 + a0*b11 + a1*b10 + a2*b9 + a3*b8 + a4*b7 + a5*b6 + a6*b5 + a7*b4 + a8*b3 + a9*b2 + a10*b1 + a11*b0 + s12 := a1*b11 + a2*b10 + a3*b9 + a4*b8 + a5*b7 + a6*b6 + a7*b5 + a8*b4 + a9*b3 + a10*b2 + a11*b1 + s13 := a2*b11 + a3*b10 + a4*b9 + a5*b8 + a6*b7 + a7*b6 + a8*b5 + a9*b4 + a10*b3 + a11*b2 + s14 := a3*b11 + a4*b10 + a5*b9 + a6*b8 + a7*b7 + a8*b6 + a9*b5 + a10*b4 + a11*b3 + s15 := a4*b11 + a5*b10 + a6*b9 + a7*b8 + a8*b7 + a9*b6 + a10*b5 + a11*b4 + s16 := a5*b11 + a6*b10 + a7*b9 + a8*b8 + a9*b7 + a10*b6 + a11*b5 + s17 := a6*b11 + a7*b10 + a8*b9 + a9*b8 + a10*b7 + a11*b6 + s18 := a7*b11 + a8*b10 + a9*b9 + a10*b8 + a11*b7 + s19 := a8*b11 + a9*b10 + a10*b9 + a11*b8 + s20 := a9*b11 + a10*b10 + a11*b9 + s21 := a10*b11 + a11*b10 + s22 := a11 * b11 + s23 := int64(0) + + carry[0] = (s0 + (1 << 20)) >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[2] = (s2 + (1 << 20)) >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[4] = (s4 + (1 << 20)) >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[6] = (s6 + (1 << 20)) >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[8] = (s8 + (1 << 20)) >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[10] = (s10 + (1 << 20)) >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + carry[12] = (s12 + (1 << 20)) >> 21 + s13 += carry[12] + s12 -= carry[12] << 21 + carry[14] = (s14 + (1 << 20)) >> 21 + s15 += carry[14] + s14 -= carry[14] << 21 + carry[16] = (s16 + (1 << 20)) >> 21 + s17 += carry[16] + s16 -= carry[16] << 21 + carry[18] = (s18 + (1 << 20)) >> 21 + s19 += carry[18] + s18 -= carry[18] << 21 + carry[20] = (s20 + (1 << 20)) >> 21 + s21 += carry[20] + s20 -= carry[20] << 21 + carry[22] = (s22 + (1 << 20)) >> 21 + s23 += carry[22] + s22 -= carry[22] << 21 + + carry[1] = (s1 + (1 << 20)) >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[3] = (s3 + (1 << 20)) >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[5] = (s5 + (1 << 20)) >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[7] = (s7 + (1 << 20)) >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[9] = (s9 + (1 << 20)) >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[11] = (s11 + (1 << 20)) >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + carry[13] = (s13 + (1 << 20)) >> 21 + s14 += carry[13] + s13 -= carry[13] << 21 + carry[15] = (s15 + (1 << 20)) >> 21 + s16 += carry[15] + s15 -= carry[15] << 21 + carry[17] = (s17 + (1 << 20)) >> 21 + s18 += carry[17] + s17 -= carry[17] << 21 + carry[19] = (s19 + (1 << 20)) >> 21 + s20 += carry[19] + s19 -= carry[19] << 21 + carry[21] = (s21 + (1 << 20)) >> 21 + s22 += carry[21] + s21 -= carry[21] << 21 + + s11 += s23 * 666643 + s12 += s23 * 470296 + s13 += s23 * 654183 + s14 -= s23 * 997805 + s15 += s23 * 136657 + s16 -= s23 * 683901 + s23 = 0 + + s10 += s22 * 666643 + s11 += s22 * 470296 + s12 += s22 * 654183 + s13 -= s22 * 997805 + s14 += s22 * 136657 + s15 -= s22 * 683901 + s22 = 0 + + s9 += s21 * 666643 + s10 += s21 * 470296 + s11 += s21 * 654183 + s12 -= s21 * 997805 + s13 += s21 * 136657 + s14 -= s21 * 683901 + s21 = 0 + + s8 += s20 * 666643 + s9 += s20 * 470296 + s10 += s20 * 654183 + s11 -= s20 * 997805 + s12 += s20 * 136657 + s13 -= s20 * 683901 + s20 = 0 + + s7 += s19 * 666643 + s8 += s19 * 470296 + s9 += s19 * 654183 + s10 -= s19 * 997805 + s11 += s19 * 136657 + s12 -= s19 * 683901 + s19 = 0 + + s6 += s18 * 666643 + s7 += s18 * 470296 + s8 += s18 * 654183 + s9 -= s18 * 997805 + s10 += s18 * 136657 + s11 -= s18 * 683901 + s18 = 0 + + carry[6] = (s6 + (1 << 20)) >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[8] = (s8 + (1 << 20)) >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[10] = (s10 + (1 << 20)) >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + carry[12] = (s12 + (1 << 20)) >> 21 + s13 += carry[12] + s12 -= carry[12] << 21 + carry[14] = (s14 + (1 << 20)) >> 21 + s15 += carry[14] + s14 -= carry[14] << 21 + carry[16] = (s16 + (1 << 20)) >> 21 + s17 += carry[16] + s16 -= carry[16] << 21 + + carry[7] = (s7 + (1 << 20)) >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[9] = (s9 + (1 << 20)) >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[11] = (s11 + (1 << 20)) >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + carry[13] = (s13 + (1 << 20)) >> 21 + s14 += carry[13] + s13 -= carry[13] << 21 + carry[15] = (s15 + (1 << 20)) >> 21 + s16 += carry[15] + s15 -= carry[15] << 21 + + s5 += s17 * 666643 + s6 += s17 * 470296 + s7 += s17 * 654183 + s8 -= s17 * 997805 + s9 += s17 * 136657 + s10 -= s17 * 683901 + s17 = 0 + + s4 += s16 * 666643 + s5 += s16 * 470296 + s6 += s16 * 654183 + s7 -= s16 * 997805 + s8 += s16 * 136657 + s9 -= s16 * 683901 + s16 = 0 + + s3 += s15 * 666643 + s4 += s15 * 470296 + s5 += s15 * 654183 + s6 -= s15 * 997805 + s7 += s15 * 136657 + s8 -= s15 * 683901 + s15 = 0 + + s2 += s14 * 666643 + s3 += s14 * 470296 + s4 += s14 * 654183 + s5 -= s14 * 997805 + s6 += s14 * 136657 + s7 -= s14 * 683901 + s14 = 0 + + s1 += s13 * 666643 + s2 += s13 * 470296 + s3 += s13 * 654183 + s4 -= s13 * 997805 + s5 += s13 * 136657 + s6 -= s13 * 683901 + s13 = 0 + + s0 += s12 * 666643 + s1 += s12 * 470296 + s2 += s12 * 654183 + s3 -= s12 * 997805 + s4 += s12 * 136657 + s5 -= s12 * 683901 + s12 = 0 + + carry[0] = (s0 + (1 << 20)) >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[2] = (s2 + (1 << 20)) >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[4] = (s4 + (1 << 20)) >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[6] = (s6 + (1 << 20)) >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[8] = (s8 + (1 << 20)) >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[10] = (s10 + (1 << 20)) >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + + carry[1] = (s1 + (1 << 20)) >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[3] = (s3 + (1 << 20)) >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[5] = (s5 + (1 << 20)) >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[7] = (s7 + (1 << 20)) >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[9] = (s9 + (1 << 20)) >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[11] = (s11 + (1 << 20)) >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + + s0 += s12 * 666643 + s1 += s12 * 470296 + s2 += s12 * 654183 + s3 -= s12 * 997805 + s4 += s12 * 136657 + s5 -= s12 * 683901 + s12 = 0 + + carry[0] = s0 >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[1] = s1 >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[2] = s2 >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[3] = s3 >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[4] = s4 >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[5] = s5 >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[6] = s6 >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[7] = s7 >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[8] = s8 >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[9] = s9 >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[10] = s10 >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + carry[11] = s11 >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + + s0 += s12 * 666643 + s1 += s12 * 470296 + s2 += s12 * 654183 + s3 -= s12 * 997805 + s4 += s12 * 136657 + s5 -= s12 * 683901 + s12 = 0 + + carry[0] = s0 >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[1] = s1 >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[2] = s2 >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[3] = s3 >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[4] = s4 >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[5] = s5 >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[6] = s6 >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[7] = s7 >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[8] = s8 >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[9] = s9 >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[10] = s10 >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + + s[0] = byte(s0 >> 0) + s[1] = byte(s0 >> 8) + s[2] = byte((s0 >> 16) | (s1 << 5)) + s[3] = byte(s1 >> 3) + s[4] = byte(s1 >> 11) + s[5] = byte((s1 >> 19) | (s2 << 2)) + s[6] = byte(s2 >> 6) + s[7] = byte((s2 >> 14) | (s3 << 7)) + s[8] = byte(s3 >> 1) + s[9] = byte(s3 >> 9) + s[10] = byte((s3 >> 17) | (s4 << 4)) + s[11] = byte(s4 >> 4) + s[12] = byte(s4 >> 12) + s[13] = byte((s4 >> 20) | (s5 << 1)) + s[14] = byte(s5 >> 7) + s[15] = byte((s5 >> 15) | (s6 << 6)) + s[16] = byte(s6 >> 2) + s[17] = byte(s6 >> 10) + s[18] = byte((s6 >> 18) | (s7 << 3)) + s[19] = byte(s7 >> 5) + s[20] = byte(s7 >> 13) + s[21] = byte(s8 >> 0) + s[22] = byte(s8 >> 8) + s[23] = byte((s8 >> 16) | (s9 << 5)) + s[24] = byte(s9 >> 3) + s[25] = byte(s9 >> 11) + s[26] = byte((s9 >> 19) | (s10 << 2)) + s[27] = byte(s10 >> 6) + s[28] = byte((s10 >> 14) | (s11 << 7)) + s[29] = byte(s11 >> 1) + s[30] = byte(s11 >> 9) + s[31] = byte(s11 >> 17) +} + +// Input: +// s[0]+256*s[1]+...+256^63*s[63] = s +// +// Output: +// s[0]+256*s[1]+...+256^31*s[31] = s mod l +// where l = 2^252 + 27742317777372353535851937790883648493. +func ScReduce(out *[32]byte, s *[64]byte) { + s0 := 2097151 & load3(s[:]) + s1 := 2097151 & (load4(s[2:]) >> 5) + s2 := 2097151 & (load3(s[5:]) >> 2) + s3 := 2097151 & (load4(s[7:]) >> 7) + s4 := 2097151 & (load4(s[10:]) >> 4) + s5 := 2097151 & (load3(s[13:]) >> 1) + s6 := 2097151 & (load4(s[15:]) >> 6) + s7 := 2097151 & (load3(s[18:]) >> 3) + s8 := 2097151 & load3(s[21:]) + s9 := 2097151 & (load4(s[23:]) >> 5) + s10 := 2097151 & (load3(s[26:]) >> 2) + s11 := 2097151 & (load4(s[28:]) >> 7) + s12 := 2097151 & (load4(s[31:]) >> 4) + s13 := 2097151 & (load3(s[34:]) >> 1) + s14 := 2097151 & (load4(s[36:]) >> 6) + s15 := 2097151 & (load3(s[39:]) >> 3) + s16 := 2097151 & load3(s[42:]) + s17 := 2097151 & (load4(s[44:]) >> 5) + s18 := 2097151 & (load3(s[47:]) >> 2) + s19 := 2097151 & (load4(s[49:]) >> 7) + s20 := 2097151 & (load4(s[52:]) >> 4) + s21 := 2097151 & (load3(s[55:]) >> 1) + s22 := 2097151 & (load4(s[57:]) >> 6) + s23 := (load4(s[60:]) >> 3) + + s11 += s23 * 666643 + s12 += s23 * 470296 + s13 += s23 * 654183 + s14 -= s23 * 997805 + s15 += s23 * 136657 + s16 -= s23 * 683901 + s23 = 0 + + s10 += s22 * 666643 + s11 += s22 * 470296 + s12 += s22 * 654183 + s13 -= s22 * 997805 + s14 += s22 * 136657 + s15 -= s22 * 683901 + s22 = 0 + + s9 += s21 * 666643 + s10 += s21 * 470296 + s11 += s21 * 654183 + s12 -= s21 * 997805 + s13 += s21 * 136657 + s14 -= s21 * 683901 + s21 = 0 + + s8 += s20 * 666643 + s9 += s20 * 470296 + s10 += s20 * 654183 + s11 -= s20 * 997805 + s12 += s20 * 136657 + s13 -= s20 * 683901 + s20 = 0 + + s7 += s19 * 666643 + s8 += s19 * 470296 + s9 += s19 * 654183 + s10 -= s19 * 997805 + s11 += s19 * 136657 + s12 -= s19 * 683901 + s19 = 0 + + s6 += s18 * 666643 + s7 += s18 * 470296 + s8 += s18 * 654183 + s9 -= s18 * 997805 + s10 += s18 * 136657 + s11 -= s18 * 683901 + s18 = 0 + + var carry [17]int64 + + carry[6] = (s6 + (1 << 20)) >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[8] = (s8 + (1 << 20)) >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[10] = (s10 + (1 << 20)) >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + carry[12] = (s12 + (1 << 20)) >> 21 + s13 += carry[12] + s12 -= carry[12] << 21 + carry[14] = (s14 + (1 << 20)) >> 21 + s15 += carry[14] + s14 -= carry[14] << 21 + carry[16] = (s16 + (1 << 20)) >> 21 + s17 += carry[16] + s16 -= carry[16] << 21 + + carry[7] = (s7 + (1 << 20)) >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[9] = (s9 + (1 << 20)) >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[11] = (s11 + (1 << 20)) >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + carry[13] = (s13 + (1 << 20)) >> 21 + s14 += carry[13] + s13 -= carry[13] << 21 + carry[15] = (s15 + (1 << 20)) >> 21 + s16 += carry[15] + s15 -= carry[15] << 21 + + s5 += s17 * 666643 + s6 += s17 * 470296 + s7 += s17 * 654183 + s8 -= s17 * 997805 + s9 += s17 * 136657 + s10 -= s17 * 683901 + s17 = 0 + + s4 += s16 * 666643 + s5 += s16 * 470296 + s6 += s16 * 654183 + s7 -= s16 * 997805 + s8 += s16 * 136657 + s9 -= s16 * 683901 + s16 = 0 + + s3 += s15 * 666643 + s4 += s15 * 470296 + s5 += s15 * 654183 + s6 -= s15 * 997805 + s7 += s15 * 136657 + s8 -= s15 * 683901 + s15 = 0 + + s2 += s14 * 666643 + s3 += s14 * 470296 + s4 += s14 * 654183 + s5 -= s14 * 997805 + s6 += s14 * 136657 + s7 -= s14 * 683901 + s14 = 0 + + s1 += s13 * 666643 + s2 += s13 * 470296 + s3 += s13 * 654183 + s4 -= s13 * 997805 + s5 += s13 * 136657 + s6 -= s13 * 683901 + s13 = 0 + + s0 += s12 * 666643 + s1 += s12 * 470296 + s2 += s12 * 654183 + s3 -= s12 * 997805 + s4 += s12 * 136657 + s5 -= s12 * 683901 + s12 = 0 + + carry[0] = (s0 + (1 << 20)) >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[2] = (s2 + (1 << 20)) >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[4] = (s4 + (1 << 20)) >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[6] = (s6 + (1 << 20)) >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[8] = (s8 + (1 << 20)) >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[10] = (s10 + (1 << 20)) >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + + carry[1] = (s1 + (1 << 20)) >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[3] = (s3 + (1 << 20)) >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[5] = (s5 + (1 << 20)) >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[7] = (s7 + (1 << 20)) >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[9] = (s9 + (1 << 20)) >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[11] = (s11 + (1 << 20)) >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + + s0 += s12 * 666643 + s1 += s12 * 470296 + s2 += s12 * 654183 + s3 -= s12 * 997805 + s4 += s12 * 136657 + s5 -= s12 * 683901 + s12 = 0 + + carry[0] = s0 >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[1] = s1 >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[2] = s2 >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[3] = s3 >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[4] = s4 >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[5] = s5 >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[6] = s6 >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[7] = s7 >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[8] = s8 >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[9] = s9 >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[10] = s10 >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + carry[11] = s11 >> 21 + s12 += carry[11] + s11 -= carry[11] << 21 + + s0 += s12 * 666643 + s1 += s12 * 470296 + s2 += s12 * 654183 + s3 -= s12 * 997805 + s4 += s12 * 136657 + s5 -= s12 * 683901 + s12 = 0 + + carry[0] = s0 >> 21 + s1 += carry[0] + s0 -= carry[0] << 21 + carry[1] = s1 >> 21 + s2 += carry[1] + s1 -= carry[1] << 21 + carry[2] = s2 >> 21 + s3 += carry[2] + s2 -= carry[2] << 21 + carry[3] = s3 >> 21 + s4 += carry[3] + s3 -= carry[3] << 21 + carry[4] = s4 >> 21 + s5 += carry[4] + s4 -= carry[4] << 21 + carry[5] = s5 >> 21 + s6 += carry[5] + s5 -= carry[5] << 21 + carry[6] = s6 >> 21 + s7 += carry[6] + s6 -= carry[6] << 21 + carry[7] = s7 >> 21 + s8 += carry[7] + s7 -= carry[7] << 21 + carry[8] = s8 >> 21 + s9 += carry[8] + s8 -= carry[8] << 21 + carry[9] = s9 >> 21 + s10 += carry[9] + s9 -= carry[9] << 21 + carry[10] = s10 >> 21 + s11 += carry[10] + s10 -= carry[10] << 21 + + out[0] = byte(s0 >> 0) + out[1] = byte(s0 >> 8) + out[2] = byte((s0 >> 16) | (s1 << 5)) + out[3] = byte(s1 >> 3) + out[4] = byte(s1 >> 11) + out[5] = byte((s1 >> 19) | (s2 << 2)) + out[6] = byte(s2 >> 6) + out[7] = byte((s2 >> 14) | (s3 << 7)) + out[8] = byte(s3 >> 1) + out[9] = byte(s3 >> 9) + out[10] = byte((s3 >> 17) | (s4 << 4)) + out[11] = byte(s4 >> 4) + out[12] = byte(s4 >> 12) + out[13] = byte((s4 >> 20) | (s5 << 1)) + out[14] = byte(s5 >> 7) + out[15] = byte((s5 >> 15) | (s6 << 6)) + out[16] = byte(s6 >> 2) + out[17] = byte(s6 >> 10) + out[18] = byte((s6 >> 18) | (s7 << 3)) + out[19] = byte(s7 >> 5) + out[20] = byte(s7 >> 13) + out[21] = byte(s8 >> 0) + out[22] = byte(s8 >> 8) + out[23] = byte((s8 >> 16) | (s9 << 5)) + out[24] = byte(s9 >> 3) + out[25] = byte(s9 >> 11) + out[26] = byte((s9 >> 19) | (s10 << 2)) + out[27] = byte(s10 >> 6) + out[28] = byte((s10 >> 14) | (s11 << 7)) + out[29] = byte(s11 >> 1) + out[30] = byte(s11 >> 9) + out[31] = byte(s11 >> 17) +} diff --git a/vendor/src/github.com/armon/go-metrics/.gitignore b/vendor/src/github.com/armon/go-metrics/.gitignore new file mode 100755 index 0000000000..00268614f0 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/.gitignore @@ -0,0 +1,22 @@ +# Compiled Object files, Static and Dynamic libs (Shared Objects) +*.o +*.a +*.so + +# Folders +_obj +_test + +# Architecture specific extensions/prefixes +*.[568vq] +[568vq].out + +*.cgo1.go +*.cgo2.c +_cgo_defun.c +_cgo_gotypes.go +_cgo_export.* + +_testmain.go + +*.exe diff --git a/vendor/src/github.com/armon/go-metrics/LICENSE b/vendor/src/github.com/armon/go-metrics/LICENSE new file mode 100644 index 0000000000..106569e542 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/LICENSE @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2013 Armon Dadgar + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/vendor/src/github.com/armon/go-metrics/README.md b/vendor/src/github.com/armon/go-metrics/README.md new file mode 100644 index 0000000000..d9f46e85ba --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/README.md @@ -0,0 +1,68 @@ +go-metrics +========== + +This library provides a `metrics` package which can be used to instrument code, +expose application metrics, and profile runtime performance in a flexible manner. + +Sinks +===== + +The `metrics` package makes use of a `MetricSink` interface to support delivery +to any type of backend. Currently the following sinks are provided: + +* StatsiteSink : Sinks to a statsite instance (TCP) +* StatsdSink: Sinks to a statsd / statsite instance (UDP) +* InmemSink : Provides in-memory aggregation, can be used to export stats +* FanoutSink : Sinks to multiple sinks. Enables writing to multiple statsite instances for example. +* BlackholeSink : Sinks to nowhere + +In addition to the sinks, the `InmemSignal` can be used to catch a signal, +and dump a formatted output of recent metrics. For example, when a process gets +a SIGUSR1, it can dump to stderr recent performance metrics for debugging. + +Examples +======== + +Here is an example of using the package: + + func SlowMethod() { + // Profiling the runtime of a method + defer metrics.MeasureSince([]string{"SlowMethod"}, time.Now()) + } + + // Configure a statsite sink as the global metrics sink + sink, _ := metrics.NewStatsiteSink("statsite:8125") + metrics.NewGlobal(metrics.DefaultConfig("service-name"), sink) + + // Emit a Key/Value pair + metrics.EmitKey([]string{"questions", "meaning of life"}, 42) + + +Here is an example of setting up an signal handler: + + // Setup the inmem sink and signal handler + inm := NewInmemSink(10*time.Second, time.Minute) + sig := DefaultInmemSignal(inm) + metrics.NewGlobal(metrics.DefaultConfig("service-name"), inm) + + // Run some code + inm.SetGauge([]string{"foo"}, 42) + inm.EmitKey([]string{"bar"}, 30) + + inm.IncrCounter([]string{"baz"}, 42) + inm.IncrCounter([]string{"baz"}, 1) + inm.IncrCounter([]string{"baz"}, 80) + + inm.AddSample([]string{"method", "wow"}, 42) + inm.AddSample([]string{"method", "wow"}, 100) + inm.AddSample([]string{"method", "wow"}, 22) + + .... + +When a signal comes in, output like the following will be dumped to stderr: + + [2014-01-28 14:57:33.04 -0800 PST][G] 'foo': 42.000 + [2014-01-28 14:57:33.04 -0800 PST][P] 'bar': 30.000 + [2014-01-28 14:57:33.04 -0800 PST][C] 'baz': Count: 3 Min: 1.000 Mean: 41.000 Max: 80.000 Stddev: 39.509 + [2014-01-28 14:57:33.04 -0800 PST][S] 'method.wow': Count: 3 Min: 22.000 Mean: 54.667 Max: 100.000 Stddev: 40.513 + diff --git a/vendor/src/github.com/armon/go-metrics/const_unix.go b/vendor/src/github.com/armon/go-metrics/const_unix.go new file mode 100644 index 0000000000..31098dd57e --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/const_unix.go @@ -0,0 +1,12 @@ +// +build !windows + +package metrics + +import ( + "syscall" +) + +const ( + // DefaultSignal is used with DefaultInmemSignal + DefaultSignal = syscall.SIGUSR1 +) diff --git a/vendor/src/github.com/armon/go-metrics/const_windows.go b/vendor/src/github.com/armon/go-metrics/const_windows.go new file mode 100644 index 0000000000..38136af3e4 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/const_windows.go @@ -0,0 +1,13 @@ +// +build windows + +package metrics + +import ( + "syscall" +) + +const ( + // DefaultSignal is used with DefaultInmemSignal + // Windows has no SIGUSR1, use SIGBREAK + DefaultSignal = syscall.Signal(21) +) diff --git a/vendor/src/github.com/armon/go-metrics/inmem.go b/vendor/src/github.com/armon/go-metrics/inmem.go new file mode 100644 index 0000000000..0749229bfd --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/inmem.go @@ -0,0 +1,239 @@ +package metrics + +import ( + "fmt" + "math" + "strings" + "sync" + "time" +) + +// InmemSink provides a MetricSink that does in-memory aggregation +// without sending metrics over a network. It can be embedded within +// an application to provide profiling information. +type InmemSink struct { + // How long is each aggregation interval + interval time.Duration + + // Retain controls how many metrics interval we keep + retain time.Duration + + // maxIntervals is the maximum length of intervals. + // It is retain / interval. + maxIntervals int + + // intervals is a slice of the retained intervals + intervals []*IntervalMetrics + intervalLock sync.RWMutex +} + +// IntervalMetrics stores the aggregated metrics +// for a specific interval +type IntervalMetrics struct { + sync.RWMutex + + // The start time of the interval + Interval time.Time + + // Gauges maps the key to the last set value + Gauges map[string]float32 + + // Points maps the string to the list of emitted values + // from EmitKey + Points map[string][]float32 + + // Counters maps the string key to a sum of the counter + // values + Counters map[string]*AggregateSample + + // Samples maps the key to an AggregateSample, + // which has the rolled up view of a sample + Samples map[string]*AggregateSample +} + +// NewIntervalMetrics creates a new IntervalMetrics for a given interval +func NewIntervalMetrics(intv time.Time) *IntervalMetrics { + return &IntervalMetrics{ + Interval: intv, + Gauges: make(map[string]float32), + Points: make(map[string][]float32), + Counters: make(map[string]*AggregateSample), + Samples: make(map[string]*AggregateSample), + } +} + +// AggregateSample is used to hold aggregate metrics +// about a sample +type AggregateSample struct { + Count int // The count of emitted pairs + Sum float64 // The sum of values + SumSq float64 // The sum of squared values + Min float64 // Minimum value + Max float64 // Maximum value +} + +// Computes a Stddev of the values +func (a *AggregateSample) Stddev() float64 { + num := (float64(a.Count) * a.SumSq) - math.Pow(a.Sum, 2) + div := float64(a.Count * (a.Count - 1)) + if div == 0 { + return 0 + } + return math.Sqrt(num / div) +} + +// Computes a mean of the values +func (a *AggregateSample) Mean() float64 { + if a.Count == 0 { + return 0 + } + return a.Sum / float64(a.Count) +} + +// Ingest is used to update a sample +func (a *AggregateSample) Ingest(v float64) { + a.Count++ + a.Sum += v + a.SumSq += (v * v) + if v < a.Min || a.Count == 1 { + a.Min = v + } + if v > a.Max || a.Count == 1 { + a.Max = v + } +} + +func (a *AggregateSample) String() string { + if a.Count == 0 { + return "Count: 0" + } else if a.Stddev() == 0 { + return fmt.Sprintf("Count: %d Sum: %0.3f", a.Count, a.Sum) + } else { + return fmt.Sprintf("Count: %d Min: %0.3f Mean: %0.3f Max: %0.3f Stddev: %0.3f Sum: %0.3f", + a.Count, a.Min, a.Mean(), a.Max, a.Stddev(), a.Sum) + } +} + +// NewInmemSink is used to construct a new in-memory sink. +// Uses an aggregation interval and maximum retention period. +func NewInmemSink(interval, retain time.Duration) *InmemSink { + i := &InmemSink{ + interval: interval, + retain: retain, + maxIntervals: int(retain / interval), + } + i.intervals = make([]*IntervalMetrics, 0, i.maxIntervals) + return i +} + +func (i *InmemSink) SetGauge(key []string, val float32) { + k := i.flattenKey(key) + intv := i.getInterval() + + intv.Lock() + defer intv.Unlock() + intv.Gauges[k] = val +} + +func (i *InmemSink) EmitKey(key []string, val float32) { + k := i.flattenKey(key) + intv := i.getInterval() + + intv.Lock() + defer intv.Unlock() + vals := intv.Points[k] + intv.Points[k] = append(vals, val) +} + +func (i *InmemSink) IncrCounter(key []string, val float32) { + k := i.flattenKey(key) + intv := i.getInterval() + + intv.Lock() + defer intv.Unlock() + + agg := intv.Counters[k] + if agg == nil { + agg = &AggregateSample{} + intv.Counters[k] = agg + } + agg.Ingest(float64(val)) +} + +func (i *InmemSink) AddSample(key []string, val float32) { + k := i.flattenKey(key) + intv := i.getInterval() + + intv.Lock() + defer intv.Unlock() + + agg := intv.Samples[k] + if agg == nil { + agg = &AggregateSample{} + intv.Samples[k] = agg + } + agg.Ingest(float64(val)) +} + +// Data is used to retrieve all the aggregated metrics +// Intervals may be in use, and a read lock should be acquired +func (i *InmemSink) Data() []*IntervalMetrics { + // Get the current interval, forces creation + i.getInterval() + + i.intervalLock.RLock() + defer i.intervalLock.RUnlock() + + intervals := make([]*IntervalMetrics, len(i.intervals)) + copy(intervals, i.intervals) + return intervals +} + +func (i *InmemSink) getExistingInterval(intv time.Time) *IntervalMetrics { + i.intervalLock.RLock() + defer i.intervalLock.RUnlock() + + n := len(i.intervals) + if n > 0 && i.intervals[n-1].Interval == intv { + return i.intervals[n-1] + } + return nil +} + +func (i *InmemSink) createInterval(intv time.Time) *IntervalMetrics { + i.intervalLock.Lock() + defer i.intervalLock.Unlock() + + // Check for an existing interval + n := len(i.intervals) + if n > 0 && i.intervals[n-1].Interval == intv { + return i.intervals[n-1] + } + + // Add the current interval + current := NewIntervalMetrics(intv) + i.intervals = append(i.intervals, current) + n++ + + // Truncate the intervals if they are too long + if n >= i.maxIntervals { + copy(i.intervals[0:], i.intervals[n-i.maxIntervals:]) + i.intervals = i.intervals[:i.maxIntervals] + } + return current +} + +// getInterval returns the current interval to write to +func (i *InmemSink) getInterval() *IntervalMetrics { + intv := time.Now().Truncate(i.interval) + if m := i.getExistingInterval(intv); m != nil { + return m + } + return i.createInterval(intv) +} + +// Flattens the key for formatting, removes spaces +func (i *InmemSink) flattenKey(parts []string) string { + joined := strings.Join(parts, ".") + return strings.Replace(joined, " ", "_", -1) +} diff --git a/vendor/src/github.com/armon/go-metrics/inmem_signal.go b/vendor/src/github.com/armon/go-metrics/inmem_signal.go new file mode 100644 index 0000000000..95d08ee10f --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/inmem_signal.go @@ -0,0 +1,100 @@ +package metrics + +import ( + "bytes" + "fmt" + "io" + "os" + "os/signal" + "sync" + "syscall" +) + +// InmemSignal is used to listen for a given signal, and when received, +// to dump the current metrics from the InmemSink to an io.Writer +type InmemSignal struct { + signal syscall.Signal + inm *InmemSink + w io.Writer + sigCh chan os.Signal + + stop bool + stopCh chan struct{} + stopLock sync.Mutex +} + +// NewInmemSignal creates a new InmemSignal which listens for a given signal, +// and dumps the current metrics out to a writer +func NewInmemSignal(inmem *InmemSink, sig syscall.Signal, w io.Writer) *InmemSignal { + i := &InmemSignal{ + signal: sig, + inm: inmem, + w: w, + sigCh: make(chan os.Signal, 1), + stopCh: make(chan struct{}), + } + signal.Notify(i.sigCh, sig) + go i.run() + return i +} + +// DefaultInmemSignal returns a new InmemSignal that responds to SIGUSR1 +// and writes output to stderr. Windows uses SIGBREAK +func DefaultInmemSignal(inmem *InmemSink) *InmemSignal { + return NewInmemSignal(inmem, DefaultSignal, os.Stderr) +} + +// Stop is used to stop the InmemSignal from listening +func (i *InmemSignal) Stop() { + i.stopLock.Lock() + defer i.stopLock.Unlock() + + if i.stop { + return + } + i.stop = true + close(i.stopCh) + signal.Stop(i.sigCh) +} + +// run is a long running routine that handles signals +func (i *InmemSignal) run() { + for { + select { + case <-i.sigCh: + i.dumpStats() + case <-i.stopCh: + return + } + } +} + +// dumpStats is used to dump the data to output writer +func (i *InmemSignal) dumpStats() { + buf := bytes.NewBuffer(nil) + + data := i.inm.Data() + // Skip the last period which is still being aggregated + for i := 0; i < len(data)-1; i++ { + intv := data[i] + intv.RLock() + for name, val := range intv.Gauges { + fmt.Fprintf(buf, "[%v][G] '%s': %0.3f\n", intv.Interval, name, val) + } + for name, vals := range intv.Points { + for _, val := range vals { + fmt.Fprintf(buf, "[%v][P] '%s': %0.3f\n", intv.Interval, name, val) + } + } + for name, agg := range intv.Counters { + fmt.Fprintf(buf, "[%v][C] '%s': %s\n", intv.Interval, name, agg) + } + for name, agg := range intv.Samples { + fmt.Fprintf(buf, "[%v][S] '%s': %s\n", intv.Interval, name, agg) + } + intv.RUnlock() + } + + // Write out the bytes + i.w.Write(buf.Bytes()) +} diff --git a/vendor/src/github.com/armon/go-metrics/metrics.go b/vendor/src/github.com/armon/go-metrics/metrics.go new file mode 100755 index 0000000000..b818e4182c --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/metrics.go @@ -0,0 +1,115 @@ +package metrics + +import ( + "runtime" + "time" +) + +func (m *Metrics) SetGauge(key []string, val float32) { + if m.HostName != "" && m.EnableHostname { + key = insert(0, m.HostName, key) + } + if m.EnableTypePrefix { + key = insert(0, "gauge", key) + } + if m.ServiceName != "" { + key = insert(0, m.ServiceName, key) + } + m.sink.SetGauge(key, val) +} + +func (m *Metrics) EmitKey(key []string, val float32) { + if m.EnableTypePrefix { + key = insert(0, "kv", key) + } + if m.ServiceName != "" { + key = insert(0, m.ServiceName, key) + } + m.sink.EmitKey(key, val) +} + +func (m *Metrics) IncrCounter(key []string, val float32) { + if m.EnableTypePrefix { + key = insert(0, "counter", key) + } + if m.ServiceName != "" { + key = insert(0, m.ServiceName, key) + } + m.sink.IncrCounter(key, val) +} + +func (m *Metrics) AddSample(key []string, val float32) { + if m.EnableTypePrefix { + key = insert(0, "sample", key) + } + if m.ServiceName != "" { + key = insert(0, m.ServiceName, key) + } + m.sink.AddSample(key, val) +} + +func (m *Metrics) MeasureSince(key []string, start time.Time) { + if m.EnableTypePrefix { + key = insert(0, "timer", key) + } + if m.ServiceName != "" { + key = insert(0, m.ServiceName, key) + } + now := time.Now() + elapsed := now.Sub(start) + msec := float32(elapsed.Nanoseconds()) / float32(m.TimerGranularity) + m.sink.AddSample(key, msec) +} + +// Periodically collects runtime stats to publish +func (m *Metrics) collectStats() { + for { + time.Sleep(m.ProfileInterval) + m.emitRuntimeStats() + } +} + +// Emits various runtime statsitics +func (m *Metrics) emitRuntimeStats() { + // Export number of Goroutines + numRoutines := runtime.NumGoroutine() + m.SetGauge([]string{"runtime", "num_goroutines"}, float32(numRoutines)) + + // Export memory stats + var stats runtime.MemStats + runtime.ReadMemStats(&stats) + m.SetGauge([]string{"runtime", "alloc_bytes"}, float32(stats.Alloc)) + m.SetGauge([]string{"runtime", "sys_bytes"}, float32(stats.Sys)) + m.SetGauge([]string{"runtime", "malloc_count"}, float32(stats.Mallocs)) + m.SetGauge([]string{"runtime", "free_count"}, float32(stats.Frees)) + m.SetGauge([]string{"runtime", "heap_objects"}, float32(stats.HeapObjects)) + m.SetGauge([]string{"runtime", "total_gc_pause_ns"}, float32(stats.PauseTotalNs)) + m.SetGauge([]string{"runtime", "total_gc_runs"}, float32(stats.NumGC)) + + // Export info about the last few GC runs + num := stats.NumGC + + // Handle wrap around + if num < m.lastNumGC { + m.lastNumGC = 0 + } + + // Ensure we don't scan more than 256 + if num-m.lastNumGC >= 256 { + m.lastNumGC = num - 255 + } + + for i := m.lastNumGC; i < num; i++ { + pause := stats.PauseNs[i%256] + m.AddSample([]string{"runtime", "gc_pause_ns"}, float32(pause)) + } + m.lastNumGC = num +} + +// Inserts a string value at an index into the slice +func insert(i int, v string, s []string) []string { + s = append(s, "") + copy(s[i+1:], s[i:]) + s[i] = v + return s +} diff --git a/vendor/src/github.com/armon/go-metrics/sink.go b/vendor/src/github.com/armon/go-metrics/sink.go new file mode 100755 index 0000000000..0c240c2c47 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/sink.go @@ -0,0 +1,52 @@ +package metrics + +// The MetricSink interface is used to transmit metrics information +// to an external system +type MetricSink interface { + // A Gauge should retain the last value it is set to + SetGauge(key []string, val float32) + + // Should emit a Key/Value pair for each call + EmitKey(key []string, val float32) + + // Counters should accumulate values + IncrCounter(key []string, val float32) + + // Samples are for timing information, where quantiles are used + AddSample(key []string, val float32) +} + +// BlackholeSink is used to just blackhole messages +type BlackholeSink struct{} + +func (*BlackholeSink) SetGauge(key []string, val float32) {} +func (*BlackholeSink) EmitKey(key []string, val float32) {} +func (*BlackholeSink) IncrCounter(key []string, val float32) {} +func (*BlackholeSink) AddSample(key []string, val float32) {} + +// FanoutSink is used to sink to fanout values to multiple sinks +type FanoutSink []MetricSink + +func (fh FanoutSink) SetGauge(key []string, val float32) { + for _, s := range fh { + s.SetGauge(key, val) + } +} + +func (fh FanoutSink) EmitKey(key []string, val float32) { + for _, s := range fh { + s.EmitKey(key, val) + } +} + +func (fh FanoutSink) IncrCounter(key []string, val float32) { + for _, s := range fh { + s.IncrCounter(key, val) + } +} + +func (fh FanoutSink) AddSample(key []string, val float32) { + for _, s := range fh { + s.AddSample(key, val) + } +} diff --git a/vendor/src/github.com/armon/go-metrics/start.go b/vendor/src/github.com/armon/go-metrics/start.go new file mode 100755 index 0000000000..44113f1004 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/start.go @@ -0,0 +1,95 @@ +package metrics + +import ( + "os" + "time" +) + +// Config is used to configure metrics settings +type Config struct { + ServiceName string // Prefixed with keys to seperate services + HostName string // Hostname to use. If not provided and EnableHostname, it will be os.Hostname + EnableHostname bool // Enable prefixing gauge values with hostname + EnableRuntimeMetrics bool // Enables profiling of runtime metrics (GC, Goroutines, Memory) + EnableTypePrefix bool // Prefixes key with a type ("counter", "gauge", "timer") + TimerGranularity time.Duration // Granularity of timers. + ProfileInterval time.Duration // Interval to profile runtime metrics +} + +// Metrics represents an instance of a metrics sink that can +// be used to emit +type Metrics struct { + Config + lastNumGC uint32 + sink MetricSink +} + +// Shared global metrics instance +var globalMetrics *Metrics + +func init() { + // Initialize to a blackhole sink to avoid errors + globalMetrics = &Metrics{sink: &BlackholeSink{}} +} + +// DefaultConfig provides a sane default configuration +func DefaultConfig(serviceName string) *Config { + c := &Config{ + ServiceName: serviceName, // Use client provided service + HostName: "", + EnableHostname: true, // Enable hostname prefix + EnableRuntimeMetrics: true, // Enable runtime profiling + EnableTypePrefix: false, // Disable type prefix + TimerGranularity: time.Millisecond, // Timers are in milliseconds + ProfileInterval: time.Second, // Poll runtime every second + } + + // Try to get the hostname + name, _ := os.Hostname() + c.HostName = name + return c +} + +// New is used to create a new instance of Metrics +func New(conf *Config, sink MetricSink) (*Metrics, error) { + met := &Metrics{} + met.Config = *conf + met.sink = sink + + // Start the runtime collector + if conf.EnableRuntimeMetrics { + go met.collectStats() + } + return met, nil +} + +// NewGlobal is the same as New, but it assigns the metrics object to be +// used globally as well as returning it. +func NewGlobal(conf *Config, sink MetricSink) (*Metrics, error) { + metrics, err := New(conf, sink) + if err == nil { + globalMetrics = metrics + } + return metrics, err +} + +// Proxy all the methods to the globalMetrics instance +func SetGauge(key []string, val float32) { + globalMetrics.SetGauge(key, val) +} + +func EmitKey(key []string, val float32) { + globalMetrics.EmitKey(key, val) +} + +func IncrCounter(key []string, val float32) { + globalMetrics.IncrCounter(key, val) +} + +func AddSample(key []string, val float32) { + globalMetrics.AddSample(key, val) +} + +func MeasureSince(key []string, start time.Time) { + globalMetrics.MeasureSince(key, start) +} diff --git a/vendor/src/github.com/armon/go-metrics/statsd.go b/vendor/src/github.com/armon/go-metrics/statsd.go new file mode 100644 index 0000000000..65a5021a05 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/statsd.go @@ -0,0 +1,154 @@ +package metrics + +import ( + "bytes" + "fmt" + "log" + "net" + "strings" + "time" +) + +const ( + // statsdMaxLen is the maximum size of a packet + // to send to statsd + statsdMaxLen = 1400 +) + +// StatsdSink provides a MetricSink that can be used +// with a statsite or statsd metrics server. It uses +// only UDP packets, while StatsiteSink uses TCP. +type StatsdSink struct { + addr string + metricQueue chan string +} + +// NewStatsdSink is used to create a new StatsdSink +func NewStatsdSink(addr string) (*StatsdSink, error) { + s := &StatsdSink{ + addr: addr, + metricQueue: make(chan string, 4096), + } + go s.flushMetrics() + return s, nil +} + +// Close is used to stop flushing to statsd +func (s *StatsdSink) Shutdown() { + close(s.metricQueue) +} + +func (s *StatsdSink) SetGauge(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|g\n", flatKey, val)) +} + +func (s *StatsdSink) EmitKey(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|kv\n", flatKey, val)) +} + +func (s *StatsdSink) IncrCounter(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|c\n", flatKey, val)) +} + +func (s *StatsdSink) AddSample(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|ms\n", flatKey, val)) +} + +// Flattens the key for formatting, removes spaces +func (s *StatsdSink) flattenKey(parts []string) string { + joined := strings.Join(parts, ".") + return strings.Map(func(r rune) rune { + switch r { + case ':': + fallthrough + case ' ': + return '_' + default: + return r + } + }, joined) +} + +// Does a non-blocking push to the metrics queue +func (s *StatsdSink) pushMetric(m string) { + select { + case s.metricQueue <- m: + default: + } +} + +// Flushes metrics +func (s *StatsdSink) flushMetrics() { + var sock net.Conn + var err error + var wait <-chan time.Time + ticker := time.NewTicker(flushInterval) + defer ticker.Stop() + +CONNECT: + // Create a buffer + buf := bytes.NewBuffer(nil) + + // Attempt to connect + sock, err = net.Dial("udp", s.addr) + if err != nil { + log.Printf("[ERR] Error connecting to statsd! Err: %s", err) + goto WAIT + } + + for { + select { + case metric, ok := <-s.metricQueue: + // Get a metric from the queue + if !ok { + goto QUIT + } + + // Check if this would overflow the packet size + if len(metric)+buf.Len() > statsdMaxLen { + _, err := sock.Write(buf.Bytes()) + buf.Reset() + if err != nil { + log.Printf("[ERR] Error writing to statsd! Err: %s", err) + goto WAIT + } + } + + // Append to the buffer + buf.WriteString(metric) + + case <-ticker.C: + if buf.Len() == 0 { + continue + } + + _, err := sock.Write(buf.Bytes()) + buf.Reset() + if err != nil { + log.Printf("[ERR] Error flushing to statsd! Err: %s", err) + goto WAIT + } + } + } + +WAIT: + // Wait for a while + wait = time.After(time.Duration(5) * time.Second) + for { + select { + // Dequeue the messages to avoid backlog + case _, ok := <-s.metricQueue: + if !ok { + goto QUIT + } + case <-wait: + goto CONNECT + } + } +QUIT: + s.metricQueue = nil +} diff --git a/vendor/src/github.com/armon/go-metrics/statsite.go b/vendor/src/github.com/armon/go-metrics/statsite.go new file mode 100755 index 0000000000..68730139a7 --- /dev/null +++ b/vendor/src/github.com/armon/go-metrics/statsite.go @@ -0,0 +1,142 @@ +package metrics + +import ( + "bufio" + "fmt" + "log" + "net" + "strings" + "time" +) + +const ( + // We force flush the statsite metrics after this period of + // inactivity. Prevents stats from getting stuck in a buffer + // forever. + flushInterval = 100 * time.Millisecond +) + +// StatsiteSink provides a MetricSink that can be used with a +// statsite metrics server +type StatsiteSink struct { + addr string + metricQueue chan string +} + +// NewStatsiteSink is used to create a new StatsiteSink +func NewStatsiteSink(addr string) (*StatsiteSink, error) { + s := &StatsiteSink{ + addr: addr, + metricQueue: make(chan string, 4096), + } + go s.flushMetrics() + return s, nil +} + +// Close is used to stop flushing to statsite +func (s *StatsiteSink) Shutdown() { + close(s.metricQueue) +} + +func (s *StatsiteSink) SetGauge(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|g\n", flatKey, val)) +} + +func (s *StatsiteSink) EmitKey(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|kv\n", flatKey, val)) +} + +func (s *StatsiteSink) IncrCounter(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|c\n", flatKey, val)) +} + +func (s *StatsiteSink) AddSample(key []string, val float32) { + flatKey := s.flattenKey(key) + s.pushMetric(fmt.Sprintf("%s:%f|ms\n", flatKey, val)) +} + +// Flattens the key for formatting, removes spaces +func (s *StatsiteSink) flattenKey(parts []string) string { + joined := strings.Join(parts, ".") + return strings.Map(func(r rune) rune { + switch r { + case ':': + fallthrough + case ' ': + return '_' + default: + return r + } + }, joined) +} + +// Does a non-blocking push to the metrics queue +func (s *StatsiteSink) pushMetric(m string) { + select { + case s.metricQueue <- m: + default: + } +} + +// Flushes metrics +func (s *StatsiteSink) flushMetrics() { + var sock net.Conn + var err error + var wait <-chan time.Time + var buffered *bufio.Writer + ticker := time.NewTicker(flushInterval) + defer ticker.Stop() + +CONNECT: + // Attempt to connect + sock, err = net.Dial("tcp", s.addr) + if err != nil { + log.Printf("[ERR] Error connecting to statsite! Err: %s", err) + goto WAIT + } + + // Create a buffered writer + buffered = bufio.NewWriter(sock) + + for { + select { + case metric, ok := <-s.metricQueue: + // Get a metric from the queue + if !ok { + goto QUIT + } + + // Try to send to statsite + _, err := buffered.Write([]byte(metric)) + if err != nil { + log.Printf("[ERR] Error writing to statsite! Err: %s", err) + goto WAIT + } + case <-ticker.C: + if err := buffered.Flush(); err != nil { + log.Printf("[ERR] Error flushing to statsite! Err: %s", err) + goto WAIT + } + } + } + +WAIT: + // Wait for a while + wait = time.After(time.Duration(5) * time.Second) + for { + select { + // Dequeue the messages to avoid backlog + case _, ok := <-s.metricQueue: + if !ok { + goto QUIT + } + case <-wait: + goto CONNECT + } + } +QUIT: + s.metricQueue = nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/LICENSE.txt b/vendor/src/github.com/aws/aws-sdk-go/LICENSE.txt new file mode 100644 index 0000000000..d645695673 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/LICENSE.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/awserr/error.go b/vendor/src/github.com/aws/aws-sdk-go/aws/awserr/error.go new file mode 100644 index 0000000000..a52743bef1 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/awserr/error.go @@ -0,0 +1,105 @@ +// Package awserr represents API error interface accessors for the SDK. +package awserr + +// An Error wraps lower level errors with code, message and an original error. +// The underlying concrete error type may also satisfy other interfaces which +// can be to used to obtain more specific information about the error. +// +// Calling Error() or String() will always include the full information about +// an error based on its underlying type. +// +// Example: +// +// output, err := s3manage.Upload(svc, input, opts) +// if err != nil { +// if awsErr, ok := err.(awserr.Error); ok { +// // Get error details +// log.Println("Error:", err.Code(), err.Message()) +// +// // Prints out full error message, including original error if there was one. +// log.Println("Error:", err.Error()) +// +// // Get original error +// if origErr := err.Err(); origErr != nil { +// // operate on original error. +// } +// } else { +// fmt.Println(err.Error()) +// } +// } +// +type Error interface { + // Satisfy the generic error interface. + error + + // Returns the short phrase depicting the classification of the error. + Code() string + + // Returns the error details message. + Message() string + + // Returns the original error if one was set. Nil is returned if not set. + OrigErr() error +} + +// New returns an Error object described by the code, message, and origErr. +// +// If origErr satisfies the Error interface it will not be wrapped within a new +// Error object and will instead be returned. +func New(code, message string, origErr error) Error { + if e, ok := origErr.(Error); ok && e != nil { + return e + } + return newBaseError(code, message, origErr) +} + +// A RequestFailure is an interface to extract request failure information from +// an Error such as the request ID of the failed request returned by a service. +// RequestFailures may not always have a requestID value if the request failed +// prior to reaching the service such as a connection error. +// +// Example: +// +// output, err := s3manage.Upload(svc, input, opts) +// if err != nil { +// if reqerr, ok := err.(RequestFailure); ok { +// log.Printf("Request failed", reqerr.Code(), reqerr.Message(), reqerr.RequestID()) +// } else { +// log.Printf("Error:", err.Error() +// } +// } +// +// Combined with awserr.Error: +// +// output, err := s3manage.Upload(svc, input, opts) +// if err != nil { +// if awsErr, ok := err.(awserr.Error); ok { +// // Generic AWS Error with Code, Message, and original error (if any) +// fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) +// +// if reqErr, ok := err.(awserr.RequestFailure); ok { +// // A service error occurred +// fmt.Println(reqErr.StatusCode(), reqErr.RequestID()) +// } +// } else { +// fmt.Println(err.Error()) +// } +// } +// +type RequestFailure interface { + Error + + // The status code of the HTTP response. + StatusCode() int + + // The request ID returned by the service for a request failure. This will + // be empty if no request ID is available such as the request failed due + // to a connection error. + RequestID() string +} + +// NewRequestFailure returns a new request error wrapper for the given Error +// provided. +func NewRequestFailure(err Error, statusCode int, reqID string) RequestFailure { + return newRequestError(err, statusCode, reqID) +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/awserr/types.go b/vendor/src/github.com/aws/aws-sdk-go/aws/awserr/types.go new file mode 100644 index 0000000000..418fc4c14b --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/awserr/types.go @@ -0,0 +1,135 @@ +package awserr + +import "fmt" + +// SprintError returns a string of the formatted error code. +// +// Both extra and origErr are optional. If they are included their lines +// will be added, but if they are not included their lines will be ignored. +func SprintError(code, message, extra string, origErr error) string { + msg := fmt.Sprintf("%s: %s", code, message) + if extra != "" { + msg = fmt.Sprintf("%s\n\t%s", msg, extra) + } + if origErr != nil { + msg = fmt.Sprintf("%s\ncaused by: %s", msg, origErr.Error()) + } + return msg +} + +// A baseError wraps the code and message which defines an error. It also +// can be used to wrap an original error object. +// +// Should be used as the root for errors satisfying the awserr.Error. Also +// for any error which does not fit into a specific error wrapper type. +type baseError struct { + // Classification of error + code string + + // Detailed information about error + message string + + // Optional original error this error is based off of. Allows building + // chained errors. + origErr error +} + +// newBaseError returns an error object for the code, message, and err. +// +// code is a short no whitespace phrase depicting the classification of +// the error that is being created. +// +// message is the free flow string containing detailed information about the error. +// +// origErr is the error object which will be nested under the new error to be returned. +func newBaseError(code, message string, origErr error) *baseError { + return &baseError{ + code: code, + message: message, + origErr: origErr, + } +} + +// Error returns the string representation of the error. +// +// See ErrorWithExtra for formatting. +// +// Satisfies the error interface. +func (b baseError) Error() string { + return SprintError(b.code, b.message, "", b.origErr) +} + +// String returns the string representation of the error. +// Alias for Error to satisfy the stringer interface. +func (b baseError) String() string { + return b.Error() +} + +// Code returns the short phrase depicting the classification of the error. +func (b baseError) Code() string { + return b.code +} + +// Message returns the error details message. +func (b baseError) Message() string { + return b.message +} + +// OrigErr returns the original error if one was set. Nil is returned if no error +// was set. +func (b baseError) OrigErr() error { + return b.origErr +} + +// So that the Error interface type can be included as an anonymous field +// in the requestError struct and not conflict with the error.Error() method. +type awsError Error + +// A requestError wraps a request or service error. +// +// Composed of baseError for code, message, and original error. +type requestError struct { + awsError + statusCode int + requestID string +} + +// newRequestError returns a wrapped error with additional information for request +// status code, and service requestID. +// +// Should be used to wrap all request which involve service requests. Even if +// the request failed without a service response, but had an HTTP status code +// that may be meaningful. +// +// Also wraps original errors via the baseError. +func newRequestError(err Error, statusCode int, requestID string) *requestError { + return &requestError{ + awsError: err, + statusCode: statusCode, + requestID: requestID, + } +} + +// Error returns the string representation of the error. +// Satisfies the error interface. +func (r requestError) Error() string { + extra := fmt.Sprintf("status code: %d, request id: [%s]", + r.statusCode, r.requestID) + return SprintError(r.Code(), r.Message(), extra, r.OrigErr()) +} + +// String returns the string representation of the error. +// Alias for Error to satisfy the stringer interface. +func (r requestError) String() string { + return r.Error() +} + +// StatusCode returns the wrapped status code for the error +func (r requestError) StatusCode() int { + return r.statusCode +} + +// RequestID returns the wrapped requestID +func (r requestError) RequestID() string { + return r.requestID +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/copy.go b/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/copy.go new file mode 100644 index 0000000000..f91743c6e1 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/copy.go @@ -0,0 +1,103 @@ +package awsutil + +import ( + "io" + "reflect" +) + +// Copy deeply copies a src structure to dst. Useful for copying request and +// response structures. +// +// Can copy between structs of different type, but will only copy fields which +// are assignable, and exist in both structs. Fields which are not assignable, +// or do not exist in both structs are ignored. +func Copy(dst, src interface{}) { + dstval := reflect.ValueOf(dst) + if !dstval.IsValid() { + panic("Copy dst cannot be nil") + } + + rcopy(dstval, reflect.ValueOf(src), true) +} + +// CopyOf returns a copy of src while also allocating the memory for dst. +// src must be a pointer type or this operation will fail. +func CopyOf(src interface{}) (dst interface{}) { + dsti := reflect.New(reflect.TypeOf(src).Elem()) + dst = dsti.Interface() + rcopy(dsti, reflect.ValueOf(src), true) + return +} + +// rcopy performs a recursive copy of values from the source to destination. +// +// root is used to skip certain aspects of the copy which are not valid +// for the root node of a object. +func rcopy(dst, src reflect.Value, root bool) { + if !src.IsValid() { + return + } + + switch src.Kind() { + case reflect.Ptr: + if _, ok := src.Interface().(io.Reader); ok { + if dst.Kind() == reflect.Ptr && dst.Elem().CanSet() { + dst.Elem().Set(src) + } else if dst.CanSet() { + dst.Set(src) + } + } else { + e := src.Type().Elem() + if dst.CanSet() && !src.IsNil() { + dst.Set(reflect.New(e)) + } + if src.Elem().IsValid() { + // Keep the current root state since the depth hasn't changed + rcopy(dst.Elem(), src.Elem(), root) + } + } + case reflect.Struct: + if !root { + dst.Set(reflect.New(src.Type()).Elem()) + } + + t := dst.Type() + for i := 0; i < t.NumField(); i++ { + name := t.Field(i).Name + srcval := src.FieldByName(name) + if srcval.IsValid() { + rcopy(dst.FieldByName(name), srcval, false) + } + } + case reflect.Slice: + if src.IsNil() { + break + } + + s := reflect.MakeSlice(src.Type(), src.Len(), src.Cap()) + dst.Set(s) + for i := 0; i < src.Len(); i++ { + rcopy(dst.Index(i), src.Index(i), false) + } + case reflect.Map: + if src.IsNil() { + break + } + + s := reflect.MakeMap(src.Type()) + dst.Set(s) + for _, k := range src.MapKeys() { + v := src.MapIndex(k) + v2 := reflect.New(v.Type()).Elem() + rcopy(v2, v, false) + dst.SetMapIndex(k, v2) + } + default: + // Assign the value if possible. If its not assignable, the value would + // need to be converted and the impact of that may be unexpected, or is + // not compatible with the dst type. + if src.Type().AssignableTo(dst.Type()) { + dst.Set(src) + } + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/path_value.go b/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/path_value.go new file mode 100644 index 0000000000..905d82385e --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/path_value.go @@ -0,0 +1,187 @@ +package awsutil + +import ( + "reflect" + "regexp" + "strconv" + "strings" +) + +var indexRe = regexp.MustCompile(`(.+)\[(-?\d+)?\]$`) + +// rValuesAtPath returns a slice of values found in value v. The values +// in v are explored recursively so all nested values are collected. +func rValuesAtPath(v interface{}, path string, create bool, caseSensitive bool) []reflect.Value { + pathparts := strings.Split(path, "||") + if len(pathparts) > 1 { + for _, pathpart := range pathparts { + vals := rValuesAtPath(v, pathpart, create, caseSensitive) + if vals != nil && len(vals) > 0 { + return vals + } + } + return nil + } + + values := []reflect.Value{reflect.Indirect(reflect.ValueOf(v))} + components := strings.Split(path, ".") + for len(values) > 0 && len(components) > 0 { + var index *int64 + var indexStar bool + c := strings.TrimSpace(components[0]) + if c == "" { // no actual component, illegal syntax + return nil + } else if caseSensitive && c != "*" && strings.ToLower(c[0:1]) == c[0:1] { + // TODO normalize case for user + return nil // don't support unexported fields + } + + // parse this component + if m := indexRe.FindStringSubmatch(c); m != nil { + c = m[1] + if m[2] == "" { + index = nil + indexStar = true + } else { + i, _ := strconv.ParseInt(m[2], 10, 32) + index = &i + indexStar = false + } + } + + nextvals := []reflect.Value{} + for _, value := range values { + // pull component name out of struct member + if value.Kind() != reflect.Struct { + continue + } + + if c == "*" { // pull all members + for i := 0; i < value.NumField(); i++ { + if f := reflect.Indirect(value.Field(i)); f.IsValid() { + nextvals = append(nextvals, f) + } + } + continue + } + + value = value.FieldByNameFunc(func(name string) bool { + if c == name { + return true + } else if !caseSensitive && strings.ToLower(name) == strings.ToLower(c) { + return true + } + return false + }) + + if create && value.Kind() == reflect.Ptr && value.IsNil() { + value.Set(reflect.New(value.Type().Elem())) + value = value.Elem() + } else { + value = reflect.Indirect(value) + } + + if value.Kind() == reflect.Slice || value.Kind() == reflect.Map { + if !create && value.IsNil() { + value = reflect.ValueOf(nil) + } + } + + if value.IsValid() { + nextvals = append(nextvals, value) + } + } + values = nextvals + + if indexStar || index != nil { + nextvals = []reflect.Value{} + for _, value := range values { + value := reflect.Indirect(value) + if value.Kind() != reflect.Slice { + continue + } + + if indexStar { // grab all indices + for i := 0; i < value.Len(); i++ { + idx := reflect.Indirect(value.Index(i)) + if idx.IsValid() { + nextvals = append(nextvals, idx) + } + } + continue + } + + // pull out index + i := int(*index) + if i >= value.Len() { // check out of bounds + if create { + // TODO resize slice + } else { + continue + } + } else if i < 0 { // support negative indexing + i = value.Len() + i + } + value = reflect.Indirect(value.Index(i)) + + if value.Kind() == reflect.Slice || value.Kind() == reflect.Map { + if !create && value.IsNil() { + value = reflect.ValueOf(nil) + } + } + + if value.IsValid() { + nextvals = append(nextvals, value) + } + } + values = nextvals + } + + components = components[1:] + } + return values +} + +// ValuesAtPath returns a list of objects at the lexical path inside of a structure +func ValuesAtPath(i interface{}, path string) []interface{} { + if rvals := rValuesAtPath(i, path, false, true); rvals != nil { + vals := make([]interface{}, len(rvals)) + for i, rval := range rvals { + vals[i] = rval.Interface() + } + return vals + } + return nil +} + +// ValuesAtAnyPath returns a list of objects at the case-insensitive lexical +// path inside of a structure +func ValuesAtAnyPath(i interface{}, path string) []interface{} { + if rvals := rValuesAtPath(i, path, false, false); rvals != nil { + vals := make([]interface{}, len(rvals)) + for i, rval := range rvals { + vals[i] = rval.Interface() + } + return vals + } + return nil +} + +// SetValueAtPath sets an object at the lexical path inside of a structure +func SetValueAtPath(i interface{}, path string, v interface{}) { + if rvals := rValuesAtPath(i, path, true, true); rvals != nil { + for _, rval := range rvals { + rval.Set(reflect.ValueOf(v)) + } + } +} + +// SetValueAtAnyPath sets an object at the case insensitive lexical path inside +// of a structure +func SetValueAtAnyPath(i interface{}, path string, v interface{}) { + if rvals := rValuesAtPath(i, path, true, false); rvals != nil { + for _, rval := range rvals { + rval.Set(reflect.ValueOf(v)) + } + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/prettify.go b/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/prettify.go new file mode 100644 index 0000000000..0de3eaa0f6 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/awsutil/prettify.go @@ -0,0 +1,103 @@ +package awsutil + +import ( + "bytes" + "fmt" + "io" + "reflect" + "strings" +) + +// Prettify returns the string representation of a value. +func Prettify(i interface{}) string { + var buf bytes.Buffer + prettify(reflect.ValueOf(i), 0, &buf) + return buf.String() +} + +// prettify will recursively walk value v to build a textual +// representation of the value. +func prettify(v reflect.Value, indent int, buf *bytes.Buffer) { + for v.Kind() == reflect.Ptr { + v = v.Elem() + } + + switch v.Kind() { + case reflect.Struct: + strtype := v.Type().String() + if strtype == "time.Time" { + fmt.Fprintf(buf, "%s", v.Interface()) + break + } else if strings.HasPrefix(strtype, "io.") { + buf.WriteString("") + break + } + + buf.WriteString("{\n") + + names := []string{} + for i := 0; i < v.Type().NumField(); i++ { + name := v.Type().Field(i).Name + f := v.Field(i) + if name[0:1] == strings.ToLower(name[0:1]) { + continue // ignore unexported fields + } + if (f.Kind() == reflect.Ptr || f.Kind() == reflect.Slice || f.Kind() == reflect.Map) && f.IsNil() { + continue // ignore unset fields + } + names = append(names, name) + } + + for i, n := range names { + val := v.FieldByName(n) + buf.WriteString(strings.Repeat(" ", indent+2)) + buf.WriteString(n + ": ") + prettify(val, indent+2, buf) + + if i < len(names)-1 { + buf.WriteString(",\n") + } + } + + buf.WriteString("\n" + strings.Repeat(" ", indent) + "}") + case reflect.Slice: + nl, id, id2 := "", "", "" + if v.Len() > 3 { + nl, id, id2 = "\n", strings.Repeat(" ", indent), strings.Repeat(" ", indent+2) + } + buf.WriteString("[" + nl) + for i := 0; i < v.Len(); i++ { + buf.WriteString(id2) + prettify(v.Index(i), indent+2, buf) + + if i < v.Len()-1 { + buf.WriteString("," + nl) + } + } + + buf.WriteString(nl + id + "]") + case reflect.Map: + buf.WriteString("{\n") + + for i, k := range v.MapKeys() { + buf.WriteString(strings.Repeat(" ", indent+2)) + buf.WriteString(k.String() + ": ") + prettify(v.MapIndex(k), indent+2, buf) + + if i < v.Len()-1 { + buf.WriteString(",\n") + } + } + + buf.WriteString("\n" + strings.Repeat(" ", indent) + "}") + default: + format := "%v" + switch v.Interface().(type) { + case string: + format = "%q" + case io.ReadSeeker, io.Reader: + format = "buffer(%p)" + } + fmt.Fprintf(buf, format, v.Interface()) + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/config.go b/vendor/src/github.com/aws/aws-sdk-go/aws/config.go new file mode 100644 index 0000000000..c27bdd3c10 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/config.go @@ -0,0 +1,254 @@ +package aws + +import ( + "net/http" + "os" + "time" + + "github.com/aws/aws-sdk-go/aws/credentials" +) + +// DefaultChainCredentials is a Credentials which will find the first available +// credentials Value from the list of Providers. +// +// This should be used in the default case. Once the type of credentials are +// known switching to the specific Credentials will be more efficient. +var DefaultChainCredentials = credentials.NewChainCredentials( + []credentials.Provider{ + &credentials.EnvProvider{}, + &credentials.SharedCredentialsProvider{Filename: "", Profile: ""}, + &credentials.EC2RoleProvider{ExpiryWindow: 5 * time.Minute}, + }) + +// The default number of retries for a service. The value of -1 indicates that +// the service specific retry default will be used. +const DefaultRetries = -1 + +// DefaultConfig is the default all service configuration will be based off of. +// By default, all clients use this structure for initialization options unless +// a custom configuration object is passed in. +// +// You may modify this global structure to change all default configuration +// in the SDK. Note that configuration options are copied by value, so any +// modifications must happen before constructing a client. +var DefaultConfig = NewConfig(). + WithCredentials(DefaultChainCredentials). + WithRegion(os.Getenv("AWS_REGION")). + WithHTTPClient(http.DefaultClient). + WithMaxRetries(DefaultRetries). + WithLogger(NewDefaultLogger()). + WithLogLevel(LogOff) + +// A Config provides service configuration for service clients. By default, +// all clients will use the {DefaultConfig} structure. +type Config struct { + // The credentials object to use when signing requests. Defaults to + // {DefaultChainCredentials}. + Credentials *credentials.Credentials + + // An optional endpoint URL (hostname only or fully qualified URI) + // that overrides the default generated endpoint for a client. Set this + // to `""` to use the default generated endpoint. + // + // @note You must still provide a `Region` value when specifying an + // endpoint for a client. + Endpoint *string + + // The region to send requests to. This parameter is required and must + // be configured globally or on a per-client basis unless otherwise + // noted. A full list of regions is found in the "Regions and Endpoints" + // document. + // + // @see http://docs.aws.amazon.com/general/latest/gr/rande.html + // AWS Regions and Endpoints + Region *string + + // Set this to `true` to disable SSL when sending requests. Defaults + // to `false`. + DisableSSL *bool + + // The HTTP client to use when sending requests. Defaults to + // `http.DefaultClient`. + HTTPClient *http.Client + + // An integer value representing the logging level. The default log level + // is zero (LogOff), which represents no logging. To enable logging set + // to a LogLevel Value. + LogLevel *LogLevelType + + // The logger writer interface to write logging messages to. Defaults to + // standard out. + Logger Logger + + // The maximum number of times that a request will be retried for failures. + // Defaults to -1, which defers the max retry setting to the service specific + // configuration. + MaxRetries *int + + // Disables semantic parameter validation, which validates input for missing + // required fields and/or other semantic request input errors. + DisableParamValidation *bool + + // Disables the computation of request and response checksums, e.g., + // CRC32 checksums in Amazon DynamoDB. + DisableComputeChecksums *bool + + // Set this to `true` to force the request to use path-style addressing, + // i.e., `http://s3.amazonaws.com/BUCKET/KEY`. By default, the S3 client will + // use virtual hosted bucket addressing when possible + // (`http://BUCKET.s3.amazonaws.com/KEY`). + // + // @note This configuration option is specific to the Amazon S3 service. + // @see http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html + // Amazon S3: Virtual Hosting of Buckets + S3ForcePathStyle *bool +} + +// NewConfig returns a new Config pointer that can be chained with builder methods to +// set multiple configuration values inline without using pointers. +// +// svc := s3.New(aws.NewConfig().WithRegion("us-west-2").WithMaxRetries(10)) +// +func NewConfig() *Config { + return &Config{} +} + +// WithCredentials sets a config Credentials value returning a Config pointer +// for chaining. +func (c *Config) WithCredentials(creds *credentials.Credentials) *Config { + c.Credentials = creds + return c +} + +// WithEndpoint sets a config Endpoint value returning a Config pointer for +// chaining. +func (c *Config) WithEndpoint(endpoint string) *Config { + c.Endpoint = &endpoint + return c +} + +// WithRegion sets a config Region value returning a Config pointer for +// chaining. +func (c *Config) WithRegion(region string) *Config { + c.Region = ®ion + return c +} + +// WithDisableSSL sets a config DisableSSL value returning a Config pointer +// for chaining. +func (c *Config) WithDisableSSL(disable bool) *Config { + c.DisableSSL = &disable + return c +} + +// WithHTTPClient sets a config HTTPClient value returning a Config pointer +// for chaining. +func (c *Config) WithHTTPClient(client *http.Client) *Config { + c.HTTPClient = client + return c +} + +// WithMaxRetries sets a config MaxRetries value returning a Config pointer +// for chaining. +func (c *Config) WithMaxRetries(max int) *Config { + c.MaxRetries = &max + return c +} + +// WithDisableParamValidation sets a config DisableParamValidation value +// returning a Config pointer for chaining. +func (c *Config) WithDisableParamValidation(disable bool) *Config { + c.DisableParamValidation = &disable + return c +} + +// WithDisableComputeChecksums sets a config DisableComputeChecksums value +// returning a Config pointer for chaining. +func (c *Config) WithDisableComputeChecksums(disable bool) *Config { + c.DisableComputeChecksums = &disable + return c +} + +// WithLogLevel sets a config LogLevel value returning a Config pointer for +// chaining. +func (c *Config) WithLogLevel(level LogLevelType) *Config { + c.LogLevel = &level + return c +} + +// WithLogger sets a config Logger value returning a Config pointer for +// chaining. +func (c *Config) WithLogger(logger Logger) *Config { + c.Logger = logger + return c +} + +// WithS3ForcePathStyle sets a config S3ForcePathStyle value returning a Config +// pointer for chaining. +func (c *Config) WithS3ForcePathStyle(force bool) *Config { + c.S3ForcePathStyle = &force + return c +} + +// Merge returns a new Config with the other Config's attribute values merged into +// this Config. If the other Config's attribute is nil it will not be merged into +// the new Config to be returned. +func (c Config) Merge(other *Config) *Config { + if other == nil { + return &c + } + + dst := c + + if other.Credentials != nil { + dst.Credentials = other.Credentials + } + + if other.Endpoint != nil { + dst.Endpoint = other.Endpoint + } + + if other.Region != nil { + dst.Region = other.Region + } + + if other.DisableSSL != nil { + dst.DisableSSL = other.DisableSSL + } + + if other.HTTPClient != nil { + dst.HTTPClient = other.HTTPClient + } + + if other.LogLevel != nil { + dst.LogLevel = other.LogLevel + } + + if other.Logger != nil { + dst.Logger = other.Logger + } + + if other.MaxRetries != nil { + dst.MaxRetries = other.MaxRetries + } + + if other.DisableParamValidation != nil { + dst.DisableParamValidation = other.DisableParamValidation + } + + if other.DisableComputeChecksums != nil { + dst.DisableComputeChecksums = other.DisableComputeChecksums + } + + if other.S3ForcePathStyle != nil { + dst.S3ForcePathStyle = other.S3ForcePathStyle + } + + return &dst +} + +// Copy will return a shallow copy of the Config object. +func (c Config) Copy() *Config { + dst := c + return &dst +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/convutil.go b/vendor/src/github.com/aws/aws-sdk-go/aws/convutil.go new file mode 100644 index 0000000000..d6a7b08dff --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/convutil.go @@ -0,0 +1,357 @@ +package aws + +import "time" + +// String returns a pointer to of the string value passed in. +func String(v string) *string { + return &v +} + +// StringValue returns the value of the string pointer passed in or +// "" if the pointer is nil. +func StringValue(v *string) string { + if v != nil { + return *v + } + return "" +} + +// StringSlice converts a slice of string values into a slice of +// string pointers +func StringSlice(src []string) []*string { + dst := make([]*string, len(src)) + for i := 0; i < len(src); i++ { + dst[i] = &(src[i]) + } + return dst +} + +// StringValueSlice converts a slice of string pointers into a slice of +// string values +func StringValueSlice(src []*string) []string { + dst := make([]string, len(src)) + for i := 0; i < len(src); i++ { + if src[i] != nil { + dst[i] = *(src[i]) + } + } + return dst +} + +// StringMap converts a string map of string values into a string +// map of string pointers +func StringMap(src map[string]string) map[string]*string { + dst := make(map[string]*string) + for k, val := range src { + v := val + dst[k] = &v + } + return dst +} + +// StringValueMap converts a string map of string pointers into a string +// map of string values +func StringValueMap(src map[string]*string) map[string]string { + dst := make(map[string]string) + for k, val := range src { + if val != nil { + dst[k] = *val + } + } + return dst +} + +// Bool returns a pointer to of the bool value passed in. +func Bool(v bool) *bool { + return &v +} + +// BoolValue returns the value of the bool pointer passed in or +// false if the pointer is nil. +func BoolValue(v *bool) bool { + if v != nil { + return *v + } + return false +} + +// BoolSlice converts a slice of bool values into a slice of +// bool pointers +func BoolSlice(src []bool) []*bool { + dst := make([]*bool, len(src)) + for i := 0; i < len(src); i++ { + dst[i] = &(src[i]) + } + return dst +} + +// BoolValueSlice converts a slice of bool pointers into a slice of +// bool values +func BoolValueSlice(src []*bool) []bool { + dst := make([]bool, len(src)) + for i := 0; i < len(src); i++ { + if src[i] != nil { + dst[i] = *(src[i]) + } + } + return dst +} + +// BoolMap converts a string map of bool values into a string +// map of bool pointers +func BoolMap(src map[string]bool) map[string]*bool { + dst := make(map[string]*bool) + for k, val := range src { + v := val + dst[k] = &v + } + return dst +} + +// BoolValueMap converts a string map of bool pointers into a string +// map of bool values +func BoolValueMap(src map[string]*bool) map[string]bool { + dst := make(map[string]bool) + for k, val := range src { + if val != nil { + dst[k] = *val + } + } + return dst +} + +// Int returns a pointer to of the int value passed in. +func Int(v int) *int { + return &v +} + +// IntValue returns the value of the int pointer passed in or +// 0 if the pointer is nil. +func IntValue(v *int) int { + if v != nil { + return *v + } + return 0 +} + +// IntSlice converts a slice of int values into a slice of +// int pointers +func IntSlice(src []int) []*int { + dst := make([]*int, len(src)) + for i := 0; i < len(src); i++ { + dst[i] = &(src[i]) + } + return dst +} + +// IntValueSlice converts a slice of int pointers into a slice of +// int values +func IntValueSlice(src []*int) []int { + dst := make([]int, len(src)) + for i := 0; i < len(src); i++ { + if src[i] != nil { + dst[i] = *(src[i]) + } + } + return dst +} + +// IntMap converts a string map of int values into a string +// map of int pointers +func IntMap(src map[string]int) map[string]*int { + dst := make(map[string]*int) + for k, val := range src { + v := val + dst[k] = &v + } + return dst +} + +// IntValueMap converts a string map of int pointers into a string +// map of int values +func IntValueMap(src map[string]*int) map[string]int { + dst := make(map[string]int) + for k, val := range src { + if val != nil { + dst[k] = *val + } + } + return dst +} + +// Int64 returns a pointer to of the int64 value passed in. +func Int64(v int64) *int64 { + return &v +} + +// Int64Value returns the value of the int64 pointer passed in or +// 0 if the pointer is nil. +func Int64Value(v *int64) int64 { + if v != nil { + return *v + } + return 0 +} + +// Int64Slice converts a slice of int64 values into a slice of +// int64 pointers +func Int64Slice(src []int64) []*int64 { + dst := make([]*int64, len(src)) + for i := 0; i < len(src); i++ { + dst[i] = &(src[i]) + } + return dst +} + +// Int64ValueSlice converts a slice of int64 pointers into a slice of +// int64 values +func Int64ValueSlice(src []*int64) []int64 { + dst := make([]int64, len(src)) + for i := 0; i < len(src); i++ { + if src[i] != nil { + dst[i] = *(src[i]) + } + } + return dst +} + +// Int64Map converts a string map of int64 values into a string +// map of int64 pointers +func Int64Map(src map[string]int64) map[string]*int64 { + dst := make(map[string]*int64) + for k, val := range src { + v := val + dst[k] = &v + } + return dst +} + +// Int64ValueMap converts a string map of int64 pointers into a string +// map of int64 values +func Int64ValueMap(src map[string]*int64) map[string]int64 { + dst := make(map[string]int64) + for k, val := range src { + if val != nil { + dst[k] = *val + } + } + return dst +} + +// Float64 returns a pointer to of the float64 value passed in. +func Float64(v float64) *float64 { + return &v +} + +// Float64Value returns the value of the float64 pointer passed in or +// 0 if the pointer is nil. +func Float64Value(v *float64) float64 { + if v != nil { + return *v + } + return 0 +} + +// Float64Slice converts a slice of float64 values into a slice of +// float64 pointers +func Float64Slice(src []float64) []*float64 { + dst := make([]*float64, len(src)) + for i := 0; i < len(src); i++ { + dst[i] = &(src[i]) + } + return dst +} + +// Float64ValueSlice converts a slice of float64 pointers into a slice of +// float64 values +func Float64ValueSlice(src []*float64) []float64 { + dst := make([]float64, len(src)) + for i := 0; i < len(src); i++ { + if src[i] != nil { + dst[i] = *(src[i]) + } + } + return dst +} + +// Float64Map converts a string map of float64 values into a string +// map of float64 pointers +func Float64Map(src map[string]float64) map[string]*float64 { + dst := make(map[string]*float64) + for k, val := range src { + v := val + dst[k] = &v + } + return dst +} + +// Float64ValueMap converts a string map of float64 pointers into a string +// map of float64 values +func Float64ValueMap(src map[string]*float64) map[string]float64 { + dst := make(map[string]float64) + for k, val := range src { + if val != nil { + dst[k] = *val + } + } + return dst +} + +// Time returns a pointer to of the time.Time value passed in. +func Time(v time.Time) *time.Time { + return &v +} + +// TimeValue returns the value of the time.Time pointer passed in or +// time.Time{} if the pointer is nil. +func TimeValue(v *time.Time) time.Time { + if v != nil { + return *v + } + return time.Time{} +} + +// TimeSlice converts a slice of time.Time values into a slice of +// time.Time pointers +func TimeSlice(src []time.Time) []*time.Time { + dst := make([]*time.Time, len(src)) + for i := 0; i < len(src); i++ { + dst[i] = &(src[i]) + } + return dst +} + +// TimeValueSlice converts a slice of time.Time pointers into a slice of +// time.Time values +func TimeValueSlice(src []*time.Time) []time.Time { + dst := make([]time.Time, len(src)) + for i := 0; i < len(src); i++ { + if src[i] != nil { + dst[i] = *(src[i]) + } + } + return dst +} + +// TimeMap converts a string map of time.Time values into a string +// map of time.Time pointers +func TimeMap(src map[string]time.Time) map[string]*time.Time { + dst := make(map[string]*time.Time) + for k, val := range src { + v := val + dst[k] = &v + } + return dst +} + +// TimeValueMap converts a string map of time.Time pointers into a string +// map of time.Time values +func TimeValueMap(src map[string]*time.Time) map[string]time.Time { + dst := make(map[string]time.Time) + for k, val := range src { + if val != nil { + dst[k] = *val + } + } + return dst +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go new file mode 100644 index 0000000000..7f509ca83c --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go @@ -0,0 +1,85 @@ +package credentials + +import ( + "github.com/aws/aws-sdk-go/aws/awserr" +) + +var ( + // ErrNoValidProvidersFoundInChain Is returned when there are no valid + // providers in the ChainProvider. + // + // @readonly + ErrNoValidProvidersFoundInChain = awserr.New("NoCredentialProviders", "no valid providers in chain", nil) +) + +// A ChainProvider will search for a provider which returns credentials +// and cache that provider until Retrieve is called again. +// +// The ChainProvider provides a way of chaining multiple providers together +// which will pick the first available using priority order of the Providers +// in the list. +// +// If none of the Providers retrieve valid credentials Value, ChainProvider's +// Retrieve() will return the error ErrNoValidProvidersFoundInChain. +// +// If a Provider is found which returns valid credentials Value ChainProvider +// will cache that Provider for all calls to IsExpired(), until Retrieve is +// called again. +// +// Example of ChainProvider to be used with an EnvProvider and EC2RoleProvider. +// In this example EnvProvider will first check if any credentials are available +// vai the environment variables. If there are none ChainProvider will check +// the next Provider in the list, EC2RoleProvider in this case. If EC2RoleProvider +// does not return any credentials ChainProvider will return the error +// ErrNoValidProvidersFoundInChain +// +// creds := NewChainCredentials( +// []Provider{ +// &EnvProvider{}, +// &EC2RoleProvider{}, +// }) +// +// // Usage of ChainCredentials with aws.Config +// svc := ec2.New(&aws.Config{Credentials: creds}) +// +type ChainProvider struct { + Providers []Provider + curr Provider +} + +// NewChainCredentials returns a pointer to a new Credentials object +// wrapping a chain of providers. +func NewChainCredentials(providers []Provider) *Credentials { + return NewCredentials(&ChainProvider{ + Providers: append([]Provider{}, providers...), + }) +} + +// Retrieve returns the credentials value or error if no provider returned +// without error. +// +// If a provider is found it will be cached and any calls to IsExpired() +// will return the expired state of the cached provider. +func (c *ChainProvider) Retrieve() (Value, error) { + for _, p := range c.Providers { + if creds, err := p.Retrieve(); err == nil { + c.curr = p + return creds, nil + } + } + c.curr = nil + + // TODO better error reporting. maybe report error for each failed retrieve? + + return Value{}, ErrNoValidProvidersFoundInChain +} + +// IsExpired will returned the expired state of the currently cached provider +// if there is one. If there is no current provider, true will be returned. +func (c *ChainProvider) IsExpired() bool { + if c.curr != nil { + return c.curr.IsExpired() + } + + return true +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/credentials.go b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/credentials.go new file mode 100644 index 0000000000..2834a088aa --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/credentials.go @@ -0,0 +1,220 @@ +// Package credentials provides credential retrieval and management +// +// The Credentials is the primary method of getting access to and managing +// credentials Values. Using dependency injection retrieval of the credential +// values is handled by a object which satisfies the Provider interface. +// +// By default the Credentials.Get() will cache the successful result of a +// Provider's Retrieve() until Provider.IsExpired() returns true. At which +// point Credentials will call Provider's Retrieve() to get new credential Value. +// +// The Provider is responsible for determining when credentials Value have expired. +// It is also important to note that Credentials will always call Retrieve the +// first time Credentials.Get() is called. +// +// Example of using the environment variable credentials. +// +// creds := NewEnvCredentials() +// +// // Retrieve the credentials value +// credValue, err := creds.Get() +// if err != nil { +// // handle error +// } +// +// Example of forcing credentials to expire and be refreshed on the next Get(). +// This may be helpful to proactively expire credentials and refresh them sooner +// than they would naturally expire on their own. +// +// creds := NewCredentials(&EC2RoleProvider{}) +// creds.Expire() +// credsValue, err := creds.Get() +// // New credentials will be retrieved instead of from cache. +// +// +// Custom Provider +// +// Each Provider built into this package also provides a helper method to generate +// a Credentials pointer setup with the provider. To use a custom Provider just +// create a type which satisfies the Provider interface and pass it to the +// NewCredentials method. +// +// type MyProvider struct{} +// func (m *MyProvider) Retrieve() (Value, error) {...} +// func (m *MyProvider) IsExpired() bool {...} +// +// creds := NewCredentials(&MyProvider{}) +// credValue, err := creds.Get() +// +package credentials + +import ( + "sync" + "time" +) + +// Create an empty Credential object that can be used as dummy placeholder +// credentials for requests that do not need signed. +// +// This Credentials can be used to configure a service to not sign requests +// when making service API calls. For example, when accessing public +// s3 buckets. +// +// svc := s3.New(&aws.Config{Credentials: AnonymousCredentials}) +// // Access public S3 buckets. +// +// @readonly +var AnonymousCredentials = NewStaticCredentials("", "", "") + +// A Value is the AWS credentials value for individual credential fields. +type Value struct { + // AWS Access key ID + AccessKeyID string + + // AWS Secret Access Key + SecretAccessKey string + + // AWS Session Token + SessionToken string +} + +// A Provider is the interface for any component which will provide credentials +// Value. A provider is required to manage its own Expired state, and what to +// be expired means. +// +// The Provider should not need to implement its own mutexes, because +// that will be managed by Credentials. +type Provider interface { + // Refresh returns nil if it successfully retrieved the value. + // Error is returned if the value were not obtainable, or empty. + Retrieve() (Value, error) + + // IsExpired returns if the credentials are no longer valid, and need + // to be retrieved. + IsExpired() bool +} + +// A Expiry provides shared expiration logic to be used by credentials +// providers to implement expiry functionality. +// +// The best method to use this struct is as an anonymous field within the +// provider's struct. +// +// Example: +// type EC2RoleProvider struct { +// Expiry +// ... +// } +type Expiry struct { + // The date/time when to expire on + expiration time.Time + + // If set will be used by IsExpired to determine the current time. + // Defaults to time.Now if CurrentTime is not set. Available for testing + // to be able to mock out the current time. + CurrentTime func() time.Time +} + +// SetExpiration sets the expiration IsExpired will check when called. +// +// If window is greater than 0 the expiration time will be reduced by the +// window value. +// +// Using a window is helpful to trigger credentials to expire sooner than +// the expiration time given to ensure no requests are made with expired +// tokens. +func (e *Expiry) SetExpiration(expiration time.Time, window time.Duration) { + e.expiration = expiration + if window > 0 { + e.expiration = e.expiration.Add(-window) + } +} + +// IsExpired returns if the credentials are expired. +func (e *Expiry) IsExpired() bool { + if e.CurrentTime == nil { + e.CurrentTime = time.Now + } + return e.expiration.Before(e.CurrentTime()) +} + +// A Credentials provides synchronous safe retrieval of AWS credentials Value. +// Credentials will cache the credentials value until they expire. Once the value +// expires the next Get will attempt to retrieve valid credentials. +// +// Credentials is safe to use across multiple goroutines and will manage the +// synchronous state so the Providers do not need to implement their own +// synchronization. +// +// The first Credentials.Get() will always call Provider.Retrieve() to get the +// first instance of the credentials Value. All calls to Get() after that +// will return the cached credentials Value until IsExpired() returns true. +type Credentials struct { + creds Value + forceRefresh bool + m sync.Mutex + + provider Provider +} + +// NewCredentials returns a pointer to a new Credentials with the provider set. +func NewCredentials(provider Provider) *Credentials { + return &Credentials{ + provider: provider, + forceRefresh: true, + } +} + +// Get returns the credentials value, or error if the credentials Value failed +// to be retrieved. +// +// Will return the cached credentials Value if it has not expired. If the +// credentials Value has expired the Provider's Retrieve() will be called +// to refresh the credentials. +// +// If Credentials.Expire() was called the credentials Value will be force +// expired, and the next call to Get() will cause them to be refreshed. +func (c *Credentials) Get() (Value, error) { + c.m.Lock() + defer c.m.Unlock() + + if c.isExpired() { + creds, err := c.provider.Retrieve() + if err != nil { + return Value{}, err + } + c.creds = creds + c.forceRefresh = false + } + + return c.creds, nil +} + +// Expire expires the credentials and forces them to be retrieved on the +// next call to Get(). +// +// This will override the Provider's expired state, and force Credentials +// to call the Provider's Retrieve(). +func (c *Credentials) Expire() { + c.m.Lock() + defer c.m.Unlock() + + c.forceRefresh = true +} + +// IsExpired returns if the credentials are no longer valid, and need +// to be retrieved. +// +// If the Credentials were forced to be expired with Expire() this will +// reflect that override. +func (c *Credentials) IsExpired() bool { + c.m.Lock() + defer c.m.Unlock() + + return c.isExpired() +} + +// isExpired helper method wrapping the definition of expired credentials. +func (c *Credentials) isExpired() bool { + return c.forceRefresh || c.provider.IsExpired() +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/ec2_role_provider.go b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/ec2_role_provider.go new file mode 100644 index 0000000000..0eecbe3b12 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/ec2_role_provider.go @@ -0,0 +1,162 @@ +package credentials + +import ( + "bufio" + "encoding/json" + "fmt" + "net/http" + "time" + + "github.com/aws/aws-sdk-go/aws/awserr" +) + +const metadataCredentialsEndpoint = "http://169.254.169.254/latest/meta-data/iam/security-credentials/" + +// A EC2RoleProvider retrieves credentials from the EC2 service, and keeps track if +// those credentials are expired. +// +// Example how to configure the EC2RoleProvider with custom http Client, Endpoint +// or ExpiryWindow +// +// p := &credentials.EC2RoleProvider{ +// // Pass in a custom timeout to be used when requesting +// // IAM EC2 Role credentials. +// Client: &http.Client{ +// Timeout: 10 * time.Second, +// }, +// // Use default EC2 Role metadata endpoint, Alternate endpoints can be +// // specified setting Endpoint to something else. +// Endpoint: "", +// // Do not use early expiry of credentials. If a non zero value is +// // specified the credentials will be expired early +// ExpiryWindow: 0, +// } +type EC2RoleProvider struct { + Expiry + + // Endpoint must be fully quantified URL + Endpoint string + + // HTTP client to use when connecting to EC2 service + Client *http.Client + + // ExpiryWindow will allow the credentials to trigger refreshing prior to + // the credentials actually expiring. This is beneficial so race conditions + // with expiring credentials do not cause request to fail unexpectedly + // due to ExpiredTokenException exceptions. + // + // So a ExpiryWindow of 10s would cause calls to IsExpired() to return true + // 10 seconds before the credentials are actually expired. + // + // If ExpiryWindow is 0 or less it will be ignored. + ExpiryWindow time.Duration +} + +// NewEC2RoleCredentials returns a pointer to a new Credentials object +// wrapping the EC2RoleProvider. +// +// Takes a custom http.Client which can be configured for custom handling of +// things such as timeout. +// +// Endpoint is the URL that the EC2RoleProvider will connect to when retrieving +// role and credentials. +// +// Window is the expiry window that will be subtracted from the expiry returned +// by the role credential request. This is done so that the credentials will +// expire sooner than their actual lifespan. +func NewEC2RoleCredentials(client *http.Client, endpoint string, window time.Duration) *Credentials { + return NewCredentials(&EC2RoleProvider{ + Endpoint: endpoint, + Client: client, + ExpiryWindow: window, + }) +} + +// Retrieve retrieves credentials from the EC2 service. +// Error will be returned if the request fails, or unable to extract +// the desired credentials. +func (m *EC2RoleProvider) Retrieve() (Value, error) { + if m.Client == nil { + m.Client = http.DefaultClient + } + if m.Endpoint == "" { + m.Endpoint = metadataCredentialsEndpoint + } + + credsList, err := requestCredList(m.Client, m.Endpoint) + if err != nil { + return Value{}, err + } + + if len(credsList) == 0 { + return Value{}, awserr.New("EmptyEC2RoleList", "empty EC2 Role list", nil) + } + credsName := credsList[0] + + roleCreds, err := requestCred(m.Client, m.Endpoint, credsName) + if err != nil { + return Value{}, err + } + + m.SetExpiration(roleCreds.Expiration, m.ExpiryWindow) + + return Value{ + AccessKeyID: roleCreds.AccessKeyID, + SecretAccessKey: roleCreds.SecretAccessKey, + SessionToken: roleCreds.Token, + }, nil +} + +// A ec2RoleCredRespBody provides the shape for deserializing credential +// request responses. +type ec2RoleCredRespBody struct { + Expiration time.Time + AccessKeyID string + SecretAccessKey string + Token string +} + +// requestCredList requests a list of credentials from the EC2 service. +// If there are no credentials, or there is an error making or receiving the request +func requestCredList(client *http.Client, endpoint string) ([]string, error) { + resp, err := client.Get(endpoint) + if err != nil { + return nil, awserr.New("ListEC2Role", "failed to list EC2 Roles", err) + } + defer resp.Body.Close() + + credsList := []string{} + s := bufio.NewScanner(resp.Body) + for s.Scan() { + credsList = append(credsList, s.Text()) + } + + if err := s.Err(); err != nil { + return nil, awserr.New("ReadEC2Role", "failed to read list of EC2 Roles", err) + } + + return credsList, nil +} + +// requestCred requests the credentials for a specific credentials from the EC2 service. +// +// If the credentials cannot be found, or there is an error reading the response +// and error will be returned. +func requestCred(client *http.Client, endpoint, credsName string) (*ec2RoleCredRespBody, error) { + resp, err := client.Get(endpoint + credsName) + if err != nil { + return nil, awserr.New("GetEC2RoleCredentials", + fmt.Sprintf("failed to get %s EC2 Role credentials", credsName), + err) + } + defer resp.Body.Close() + + respCreds := &ec2RoleCredRespBody{} + if err := json.NewDecoder(resp.Body).Decode(respCreds); err != nil { + return nil, awserr.New("DecodeEC2RoleCredentials", + fmt.Sprintf("failed to decode %s EC2 Role credentials", credsName), + err) + } + + return respCreds, nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go new file mode 100644 index 0000000000..043e861d6f --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go @@ -0,0 +1,73 @@ +package credentials + +import ( + "os" + + "github.com/aws/aws-sdk-go/aws/awserr" +) + +var ( + // ErrAccessKeyIDNotFound is returned when the AWS Access Key ID can't be + // found in the process's environment. + // + // @readonly + ErrAccessKeyIDNotFound = awserr.New("EnvAccessKeyNotFound", "AWS_ACCESS_KEY_ID or AWS_ACCESS_KEY not found in environment", nil) + + // ErrSecretAccessKeyNotFound is returned when the AWS Secret Access Key + // can't be found in the process's environment. + // + // @readonly + ErrSecretAccessKeyNotFound = awserr.New("EnvSecretNotFound", "AWS_SECRET_ACCESS_KEY or AWS_SECRET_KEY not found in environment", nil) +) + +// A EnvProvider retrieves credentials from the environment variables of the +// running process. Environment credentials never expire. +// +// Environment variables used: +// +// * Access Key ID: AWS_ACCESS_KEY_ID or AWS_ACCESS_KEY +// * Secret Access Key: AWS_SECRET_ACCESS_KEY or AWS_SECRET_KEY +type EnvProvider struct { + retrieved bool +} + +// NewEnvCredentials returns a pointer to a new Credentials object +// wrapping the environment variable provider. +func NewEnvCredentials() *Credentials { + return NewCredentials(&EnvProvider{}) +} + +// Retrieve retrieves the keys from the environment. +func (e *EnvProvider) Retrieve() (Value, error) { + e.retrieved = false + + id := os.Getenv("AWS_ACCESS_KEY_ID") + if id == "" { + id = os.Getenv("AWS_ACCESS_KEY") + } + + secret := os.Getenv("AWS_SECRET_ACCESS_KEY") + if secret == "" { + secret = os.Getenv("AWS_SECRET_KEY") + } + + if id == "" { + return Value{}, ErrAccessKeyIDNotFound + } + + if secret == "" { + return Value{}, ErrSecretAccessKeyNotFound + } + + e.retrieved = true + return Value{ + AccessKeyID: id, + SecretAccessKey: secret, + SessionToken: os.Getenv("AWS_SESSION_TOKEN"), + }, nil +} + +// IsExpired returns if the credentials have been retrieved. +func (e *EnvProvider) IsExpired() bool { + return !e.retrieved +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/example.ini b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/example.ini new file mode 100644 index 0000000000..aa2dc506ad --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/example.ini @@ -0,0 +1,8 @@ +[default] +aws_access_key_id = accessKey +aws_secret_access_key = secret +aws_session_token = token + +[no_token] +aws_access_key_id = accessKey +aws_secret_access_key = secret diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/shared_credentials_provider.go b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/shared_credentials_provider.go new file mode 100644 index 0000000000..b457e63a33 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/shared_credentials_provider.go @@ -0,0 +1,135 @@ +package credentials + +import ( + "fmt" + "os" + "path/filepath" + + "github.com/vaughan0/go-ini" + + "github.com/aws/aws-sdk-go/aws/awserr" +) + +var ( + // ErrSharedCredentialsHomeNotFound is emitted when the user directory cannot be found. + // + // @readonly + ErrSharedCredentialsHomeNotFound = awserr.New("UserHomeNotFound", "user home directory not found.", nil) +) + +// A SharedCredentialsProvider retrieves credentials from the current user's home +// directory, and keeps track if those credentials are expired. +// +// Profile ini file example: $HOME/.aws/credentials +type SharedCredentialsProvider struct { + // Path to the shared credentials file. If empty will default to current user's + // home directory. + Filename string + + // AWS Profile to extract credentials from the shared credentials file. If empty + // will default to environment variable "AWS_PROFILE" or "default" if + // environment variable is also not set. + Profile string + + // retrieved states if the credentials have been successfully retrieved. + retrieved bool +} + +// NewSharedCredentials returns a pointer to a new Credentials object +// wrapping the Profile file provider. +func NewSharedCredentials(filename, profile string) *Credentials { + return NewCredentials(&SharedCredentialsProvider{ + Filename: filename, + Profile: profile, + }) +} + +// Retrieve reads and extracts the shared credentials from the current +// users home directory. +func (p *SharedCredentialsProvider) Retrieve() (Value, error) { + p.retrieved = false + + filename, err := p.filename() + if err != nil { + return Value{}, err + } + + creds, err := loadProfile(filename, p.profile()) + if err != nil { + return Value{}, err + } + + p.retrieved = true + return creds, nil +} + +// IsExpired returns if the shared credentials have expired. +func (p *SharedCredentialsProvider) IsExpired() bool { + return !p.retrieved +} + +// loadProfiles loads from the file pointed to by shared credentials filename for profile. +// The credentials retrieved from the profile will be returned or error. Error will be +// returned if it fails to read from the file, or the data is invalid. +func loadProfile(filename, profile string) (Value, error) { + config, err := ini.LoadFile(filename) + if err != nil { + return Value{}, awserr.New("SharedCredsLoad", "failed to load shared credentials file", err) + } + iniProfile := config.Section(profile) + + id, ok := iniProfile["aws_access_key_id"] + if !ok { + return Value{}, awserr.New("SharedCredsAccessKey", + fmt.Sprintf("shared credentials %s in %s did not contain aws_access_key_id", profile, filename), + nil) + } + + secret, ok := iniProfile["aws_secret_access_key"] + if !ok { + return Value{}, awserr.New("SharedCredsSecret", + fmt.Sprintf("shared credentials %s in %s did not contain aws_secret_access_key", profile, filename), + nil) + } + + token := iniProfile["aws_session_token"] + + return Value{ + AccessKeyID: id, + SecretAccessKey: secret, + SessionToken: token, + }, nil +} + +// filename returns the filename to use to read AWS shared credentials. +// +// Will return an error if the user's home directory path cannot be found. +func (p *SharedCredentialsProvider) filename() (string, error) { + if p.Filename == "" { + homeDir := os.Getenv("HOME") // *nix + if homeDir == "" { // Windows + homeDir = os.Getenv("USERPROFILE") + } + if homeDir == "" { + return "", ErrSharedCredentialsHomeNotFound + } + + p.Filename = filepath.Join(homeDir, ".aws", "credentials") + } + + return p.Filename, nil +} + +// profile returns the AWS shared credentials profile. If empty will read +// environment variable "AWS_PROFILE". If that is not set profile will +// return "default". +func (p *SharedCredentialsProvider) profile() string { + if p.Profile == "" { + p.Profile = os.Getenv("AWS_PROFILE") + } + if p.Profile == "" { + p.Profile = "default" + } + + return p.Profile +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/static_provider.go b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/static_provider.go new file mode 100644 index 0000000000..530a9ac2f3 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/credentials/static_provider.go @@ -0,0 +1,44 @@ +package credentials + +import ( + "github.com/aws/aws-sdk-go/aws/awserr" +) + +var ( + // ErrStaticCredentialsEmpty is emitted when static credentials are empty. + // + // @readonly + ErrStaticCredentialsEmpty = awserr.New("EmptyStaticCreds", "static credentials are empty", nil) +) + +// A StaticProvider is a set of credentials which are set pragmatically, +// and will never expire. +type StaticProvider struct { + Value +} + +// NewStaticCredentials returns a pointer to a new Credentials object +// wrapping a static credentials value provider. +func NewStaticCredentials(id, secret, token string) *Credentials { + return NewCredentials(&StaticProvider{Value: Value{ + AccessKeyID: id, + SecretAccessKey: secret, + SessionToken: token, + }}) +} + +// Retrieve returns the credentials or error if the credentials are invalid. +func (s *StaticProvider) Retrieve() (Value, error) { + if s.AccessKeyID == "" || s.SecretAccessKey == "" { + return Value{}, ErrStaticCredentialsEmpty + } + + return s.Value, nil +} + +// IsExpired returns if the credentials are expired. +// +// For StaticProvider, the credentials never expired. +func (s *StaticProvider) IsExpired() bool { + return false +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/handler_functions.go b/vendor/src/github.com/aws/aws-sdk-go/aws/handler_functions.go new file mode 100644 index 0000000000..45ae880735 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/handler_functions.go @@ -0,0 +1,157 @@ +package aws + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/url" + "regexp" + "strconv" + "time" + + "github.com/aws/aws-sdk-go/aws/awserr" +) + +var sleepDelay = func(delay time.Duration) { + time.Sleep(delay) +} + +// Interface for matching types which also have a Len method. +type lener interface { + Len() int +} + +// BuildContentLength builds the content length of a request based on the body, +// or will use the HTTPRequest.Header's "Content-Length" if defined. If unable +// to determine request body length and no "Content-Length" was specified it will panic. +func BuildContentLength(r *Request) { + if slength := r.HTTPRequest.Header.Get("Content-Length"); slength != "" { + length, _ := strconv.ParseInt(slength, 10, 64) + r.HTTPRequest.ContentLength = length + return + } + + var length int64 + switch body := r.Body.(type) { + case nil: + length = 0 + case lener: + length = int64(body.Len()) + case io.Seeker: + r.bodyStart, _ = body.Seek(0, 1) + end, _ := body.Seek(0, 2) + body.Seek(r.bodyStart, 0) // make sure to seek back to original location + length = end - r.bodyStart + default: + panic("Cannot get length of body, must provide `ContentLength`") + } + + r.HTTPRequest.ContentLength = length + r.HTTPRequest.Header.Set("Content-Length", fmt.Sprintf("%d", length)) +} + +// UserAgentHandler is a request handler for injecting User agent into requests. +func UserAgentHandler(r *Request) { + r.HTTPRequest.Header.Set("User-Agent", SDKName+"/"+SDKVersion) +} + +var reStatusCode = regexp.MustCompile(`^(\d+)`) + +// SendHandler is a request handler to send service request using HTTP client. +func SendHandler(r *Request) { + var err error + r.HTTPResponse, err = r.Service.Config.HTTPClient.Do(r.HTTPRequest) + if err != nil { + // Capture the case where url.Error is returned for error processing + // response. e.g. 301 without location header comes back as string + // error and r.HTTPResponse is nil. Other url redirect errors will + // comeback in a similar method. + if e, ok := err.(*url.Error); ok { + if s := reStatusCode.FindStringSubmatch(e.Error()); s != nil { + code, _ := strconv.ParseInt(s[1], 10, 64) + r.HTTPResponse = &http.Response{ + StatusCode: int(code), + Status: http.StatusText(int(code)), + Body: ioutil.NopCloser(bytes.NewReader([]byte{})), + } + return + } + } + if r.HTTPRequest == nil { + // Add a dummy request response object to ensure the HTTPResponse + // value is consistent. + r.HTTPResponse = &http.Response{ + StatusCode: int(0), + Status: http.StatusText(int(0)), + Body: ioutil.NopCloser(bytes.NewReader([]byte{})), + } + } + // Catch all other request errors. + r.Error = awserr.New("RequestError", "send request failed", err) + r.Retryable = Bool(true) // network errors are retryable + } +} + +// ValidateResponseHandler is a request handler to validate service response. +func ValidateResponseHandler(r *Request) { + if r.HTTPResponse.StatusCode == 0 || r.HTTPResponse.StatusCode >= 300 { + // this may be replaced by an UnmarshalError handler + r.Error = awserr.New("UnknownError", "unknown error", nil) + } +} + +// AfterRetryHandler performs final checks to determine if the request should +// be retried and how long to delay. +func AfterRetryHandler(r *Request) { + // If one of the other handlers already set the retry state + // we don't want to override it based on the service's state + if r.Retryable == nil { + r.Retryable = Bool(r.Service.ShouldRetry(r)) + } + + if r.WillRetry() { + r.RetryDelay = r.Service.RetryRules(r) + sleepDelay(r.RetryDelay) + + // when the expired token exception occurs the credentials + // need to be expired locally so that the next request to + // get credentials will trigger a credentials refresh. + if r.Error != nil { + if err, ok := r.Error.(awserr.Error); ok { + if isCodeExpiredCreds(err.Code()) { + r.Config.Credentials.Expire() + } + } + } + + r.RetryCount++ + r.Error = nil + } +} + +var ( + // ErrMissingRegion is an error that is returned if region configuration is + // not found. + // + // @readonly + ErrMissingRegion error = awserr.New("MissingRegion", "could not find region configuration", nil) + + // ErrMissingEndpoint is an error that is returned if an endpoint cannot be + // resolved for a service. + // + // @readonly + ErrMissingEndpoint error = awserr.New("MissingEndpoint", "'Endpoint' configuration is required for this service", nil) +) + +// ValidateEndpointHandler is a request handler to validate a request had the +// appropriate Region and Endpoint set. Will set r.Error if the endpoint or +// region is not valid. +func ValidateEndpointHandler(r *Request) { + if r.Service.SigningRegion == "" && StringValue(r.Service.Config.Region) == "" { + r.Error = ErrMissingRegion + } else if r.Service.Endpoint == "" { + r.Error = ErrMissingEndpoint + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/handlers.go b/vendor/src/github.com/aws/aws-sdk-go/aws/handlers.go new file mode 100644 index 0000000000..1968cb9f8b --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/handlers.go @@ -0,0 +1,85 @@ +package aws + +// A Handlers provides a collection of request handlers for various +// stages of handling requests. +type Handlers struct { + Validate HandlerList + Build HandlerList + Sign HandlerList + Send HandlerList + ValidateResponse HandlerList + Unmarshal HandlerList + UnmarshalMeta HandlerList + UnmarshalError HandlerList + Retry HandlerList + AfterRetry HandlerList +} + +// copy returns of this handler's lists. +func (h *Handlers) copy() Handlers { + return Handlers{ + Validate: h.Validate.copy(), + Build: h.Build.copy(), + Sign: h.Sign.copy(), + Send: h.Send.copy(), + ValidateResponse: h.ValidateResponse.copy(), + Unmarshal: h.Unmarshal.copy(), + UnmarshalError: h.UnmarshalError.copy(), + UnmarshalMeta: h.UnmarshalMeta.copy(), + Retry: h.Retry.copy(), + AfterRetry: h.AfterRetry.copy(), + } +} + +// Clear removes callback functions for all handlers +func (h *Handlers) Clear() { + h.Validate.Clear() + h.Build.Clear() + h.Send.Clear() + h.Sign.Clear() + h.Unmarshal.Clear() + h.UnmarshalMeta.Clear() + h.UnmarshalError.Clear() + h.ValidateResponse.Clear() + h.Retry.Clear() + h.AfterRetry.Clear() +} + +// A HandlerList manages zero or more handlers in a list. +type HandlerList struct { + list []func(*Request) +} + +// copy creates a copy of the handler list. +func (l *HandlerList) copy() HandlerList { + var n HandlerList + n.list = append([]func(*Request){}, l.list...) + return n +} + +// Clear clears the handler list. +func (l *HandlerList) Clear() { + l.list = []func(*Request){} +} + +// Len returns the number of handlers in the list. +func (l *HandlerList) Len() int { + return len(l.list) +} + +// PushBack pushes handlers f to the back of the handler list. +func (l *HandlerList) PushBack(f ...func(*Request)) { + l.list = append(l.list, f...) +} + +// PushFront pushes handlers f to the front of the handler list. +func (l *HandlerList) PushFront(f ...func(*Request)) { + l.list = append(f, l.list...) +} + +// Run executes all handlers in the list with a given request object. +func (l *HandlerList) Run(r *Request) { + for _, f := range l.list { + f(r) + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/logger.go b/vendor/src/github.com/aws/aws-sdk-go/aws/logger.go new file mode 100644 index 0000000000..935661c0b7 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/logger.go @@ -0,0 +1,89 @@ +package aws + +import ( + "log" + "os" +) + +// A LogLevelType defines the level logging should be performed at. Used to instruct +// the SDK which statements should be logged. +type LogLevelType uint + +// LogLevel returns the pointer to a LogLevel. Should be used to workaround +// not being able to take the address of a non-composite literal. +func LogLevel(l LogLevelType) *LogLevelType { + return &l +} + +// Value returns the LogLevel value or the default value LogOff if the LogLevel +// is nil. Safe to use on nil value LogLevelTypes. +func (l *LogLevelType) Value() LogLevelType { + if l != nil { + return *l + } + return LogOff +} + +// Matches returns true if the v LogLevel is enabled by this LogLevel. Should be +// used with logging sub levels. Is safe to use on nil value LogLevelTypes. If +// LogLevel is nill, will default to LogOff comparison. +func (l *LogLevelType) Matches(v LogLevelType) bool { + c := l.Value() + return c&v == v +} + +// AtLeast returns true if this LogLevel is at least high enough to satisfies v. +// Is safe to use on nil value LogLevelTypes. If LogLevel is nill, will default +// to LogOff comparison. +func (l *LogLevelType) AtLeast(v LogLevelType) bool { + c := l.Value() + return c >= v +} + +const ( + // LogOff states that no logging should be performed by the SDK. This is the + // default state of the SDK, and should be use to disable all logging. + LogOff LogLevelType = iota * 0x1000 + + // LogDebug state that debug output should be logged by the SDK. This should + // be used to inspect request made and responses received. + LogDebug +) + +// Debug Logging Sub Levels +const ( + // LogDebugWithSigning states that the SDK should log request signing and + // presigning events. This should be used to log the signing details of + // requests for debugging. Will also enable LogDebug. + LogDebugWithSigning LogLevelType = LogDebug | (1 << iota) + + // LogDebugWithHTTPBody states the SDK should log HTTP request and response + // HTTP bodys in addition to the headers and path. This should be used to + // see the body content of requests and responses made while using the SDK + // Will also enable LogDebug. + LogDebugWithHTTPBody +) + +// A Logger is a minimalistic interface for the SDK to log messages to. Should +// be used to provide custom logging writers for the SDK to use. +type Logger interface { + Log(...interface{}) +} + +// NewDefaultLogger returns a Logger which will write log messages to stdout, and +// use same formatting runes as the stdlib log.Logger +func NewDefaultLogger() Logger { + return &defaultLogger{ + logger: log.New(os.Stdout, "", log.LstdFlags), + } +} + +// A defaultLogger provides a minimalistic logger satisfying the Logger interface. +type defaultLogger struct { + logger *log.Logger +} + +// Log logs the parameters to the stdlib logger. See log.Println. +func (l defaultLogger) Log(args ...interface{}) { + l.logger.Println(args...) +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/param_validator.go b/vendor/src/github.com/aws/aws-sdk-go/aws/param_validator.go new file mode 100644 index 0000000000..b4e95cebd5 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/param_validator.go @@ -0,0 +1,89 @@ +package aws + +import ( + "fmt" + "reflect" + "strings" + + "github.com/aws/aws-sdk-go/aws/awserr" +) + +// ValidateParameters is a request handler to validate the input parameters. +// Validating parameters only has meaning if done prior to the request being sent. +func ValidateParameters(r *Request) { + if r.ParamsFilled() { + v := validator{errors: []string{}} + v.validateAny(reflect.ValueOf(r.Params), "") + + if count := len(v.errors); count > 0 { + format := "%d validation errors:\n- %s" + msg := fmt.Sprintf(format, count, strings.Join(v.errors, "\n- ")) + r.Error = awserr.New("InvalidParameter", msg, nil) + } + } +} + +// A validator validates values. Collects validations errors which occurs. +type validator struct { + errors []string +} + +// validateAny will validate any struct, slice or map type. All validations +// are also performed recursively for nested types. +func (v *validator) validateAny(value reflect.Value, path string) { + value = reflect.Indirect(value) + if !value.IsValid() { + return + } + + switch value.Kind() { + case reflect.Struct: + v.validateStruct(value, path) + case reflect.Slice: + for i := 0; i < value.Len(); i++ { + v.validateAny(value.Index(i), path+fmt.Sprintf("[%d]", i)) + } + case reflect.Map: + for _, n := range value.MapKeys() { + v.validateAny(value.MapIndex(n), path+fmt.Sprintf("[%q]", n.String())) + } + } +} + +// validateStruct will validate the struct value's fields. If the structure has +// nested types those types will be validated also. +func (v *validator) validateStruct(value reflect.Value, path string) { + prefix := "." + if path == "" { + prefix = "" + } + + for i := 0; i < value.Type().NumField(); i++ { + f := value.Type().Field(i) + if strings.ToLower(f.Name[0:1]) == f.Name[0:1] { + continue + } + fvalue := value.FieldByName(f.Name) + + notset := false + if f.Tag.Get("required") != "" { + switch fvalue.Kind() { + case reflect.Ptr, reflect.Slice, reflect.Map: + if fvalue.IsNil() { + notset = true + } + default: + if !fvalue.IsValid() { + notset = true + } + } + } + + if notset { + msg := "missing required parameter: " + path + prefix + f.Name + v.errors = append(v.errors, msg) + } else { + v.validateAny(fvalue, path+prefix+f.Name) + } + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/request.go b/vendor/src/github.com/aws/aws-sdk-go/aws/request.go new file mode 100644 index 0000000000..f3248fc467 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/request.go @@ -0,0 +1,312 @@ +package aws + +import ( + "bytes" + "io" + "io/ioutil" + "net/http" + "net/url" + "reflect" + "strings" + "time" + + "github.com/aws/aws-sdk-go/aws/awsutil" +) + +// A Request is the service request to be made. +type Request struct { + *Service + Handlers Handlers + Time time.Time + ExpireTime time.Duration + Operation *Operation + HTTPRequest *http.Request + HTTPResponse *http.Response + Body io.ReadSeeker + bodyStart int64 // offset from beginning of Body that the request body starts + Params interface{} + Error error + Data interface{} + RequestID string + RetryCount uint + Retryable *bool + RetryDelay time.Duration + + built bool +} + +// An Operation is the service API operation to be made. +type Operation struct { + Name string + HTTPMethod string + HTTPPath string + *Paginator +} + +// Paginator keeps track of pagination configuration for an API operation. +type Paginator struct { + InputTokens []string + OutputTokens []string + LimitToken string + TruncationToken string +} + +// NewRequest returns a new Request pointer for the service API +// operation and parameters. +// +// Params is any value of input parameters to be the request payload. +// Data is pointer value to an object which the request's response +// payload will be deserialized to. +func NewRequest(service *Service, operation *Operation, params interface{}, data interface{}) *Request { + method := operation.HTTPMethod + if method == "" { + method = "POST" + } + p := operation.HTTPPath + if p == "" { + p = "/" + } + + httpReq, _ := http.NewRequest(method, "", nil) + httpReq.URL, _ = url.Parse(service.Endpoint + p) + + r := &Request{ + Service: service, + Handlers: service.Handlers.copy(), + Time: time.Now(), + ExpireTime: 0, + Operation: operation, + HTTPRequest: httpReq, + Body: nil, + Params: params, + Error: nil, + Data: data, + } + r.SetBufferBody([]byte{}) + + return r +} + +// WillRetry returns if the request's can be retried. +func (r *Request) WillRetry() bool { + return r.Error != nil && BoolValue(r.Retryable) && r.RetryCount < r.Service.MaxRetries() +} + +// ParamsFilled returns if the request's parameters have been populated +// and the parameters are valid. False is returned if no parameters are +// provided or invalid. +func (r *Request) ParamsFilled() bool { + return r.Params != nil && reflect.ValueOf(r.Params).Elem().IsValid() +} + +// DataFilled returns true if the request's data for response deserialization +// target has been set and is a valid. False is returned if data is not +// set, or is invalid. +func (r *Request) DataFilled() bool { + return r.Data != nil && reflect.ValueOf(r.Data).Elem().IsValid() +} + +// SetBufferBody will set the request's body bytes that will be sent to +// the service API. +func (r *Request) SetBufferBody(buf []byte) { + r.SetReaderBody(bytes.NewReader(buf)) +} + +// SetStringBody sets the body of the request to be backed by a string. +func (r *Request) SetStringBody(s string) { + r.SetReaderBody(strings.NewReader(s)) +} + +// SetReaderBody will set the request's body reader. +func (r *Request) SetReaderBody(reader io.ReadSeeker) { + r.HTTPRequest.Body = ioutil.NopCloser(reader) + r.Body = reader +} + +// Presign returns the request's signed URL. Error will be returned +// if the signing fails. +func (r *Request) Presign(expireTime time.Duration) (string, error) { + r.ExpireTime = expireTime + r.Sign() + if r.Error != nil { + return "", r.Error + } + return r.HTTPRequest.URL.String(), nil +} + +// Build will build the request's object so it can be signed and sent +// to the service. Build will also validate all the request's parameters. +// Anny additional build Handlers set on this request will be run +// in the order they were set. +// +// The request will only be built once. Multiple calls to build will have +// no effect. +// +// If any Validate or Build errors occur the build will stop and the error +// which occurred will be returned. +func (r *Request) Build() error { + if !r.built { + r.Error = nil + r.Handlers.Validate.Run(r) + if r.Error != nil { + return r.Error + } + r.Handlers.Build.Run(r) + r.built = true + } + + return r.Error +} + +// Sign will sign the request retuning error if errors are encountered. +// +// Send will build the request prior to signing. All Sign Handlers will +// be executed in the order they were set. +func (r *Request) Sign() error { + r.Build() + if r.Error != nil { + return r.Error + } + + r.Handlers.Sign.Run(r) + return r.Error +} + +// Send will send the request returning error if errors are encountered. +// +// Send will sign the request prior to sending. All Send Handlers will +// be executed in the order they were set. +func (r *Request) Send() error { + for { + r.Sign() + if r.Error != nil { + return r.Error + } + + if BoolValue(r.Retryable) { + // Re-seek the body back to the original point in for a retry so that + // send will send the body's contents again in the upcoming request. + r.Body.Seek(r.bodyStart, 0) + } + r.Retryable = nil + + r.Handlers.Send.Run(r) + if r.Error != nil { + r.Handlers.Retry.Run(r) + r.Handlers.AfterRetry.Run(r) + if r.Error != nil { + return r.Error + } + continue + } + + r.Handlers.UnmarshalMeta.Run(r) + r.Handlers.ValidateResponse.Run(r) + if r.Error != nil { + r.Handlers.UnmarshalError.Run(r) + r.Handlers.Retry.Run(r) + r.Handlers.AfterRetry.Run(r) + if r.Error != nil { + return r.Error + } + continue + } + + r.Handlers.Unmarshal.Run(r) + if r.Error != nil { + r.Handlers.Retry.Run(r) + r.Handlers.AfterRetry.Run(r) + if r.Error != nil { + return r.Error + } + continue + } + + break + } + + return nil +} + +// HasNextPage returns true if this request has more pages of data available. +func (r *Request) HasNextPage() bool { + return r.nextPageTokens() != nil +} + +// nextPageTokens returns the tokens to use when asking for the next page of +// data. +func (r *Request) nextPageTokens() []interface{} { + if r.Operation.Paginator == nil { + return nil + } + + if r.Operation.TruncationToken != "" { + tr := awsutil.ValuesAtAnyPath(r.Data, r.Operation.TruncationToken) + if tr == nil || len(tr) == 0 { + return nil + } + switch v := tr[0].(type) { + case bool: + if v == false { + return nil + } + } + } + + found := false + tokens := make([]interface{}, len(r.Operation.OutputTokens)) + + for i, outtok := range r.Operation.OutputTokens { + v := awsutil.ValuesAtAnyPath(r.Data, outtok) + if v != nil && len(v) > 0 { + found = true + tokens[i] = v[0] + } + } + + if found { + return tokens + } + return nil +} + +// NextPage returns a new Request that can be executed to return the next +// page of result data. Call .Send() on this request to execute it. +func (r *Request) NextPage() *Request { + tokens := r.nextPageTokens() + if tokens == nil { + return nil + } + + data := reflect.New(reflect.TypeOf(r.Data).Elem()).Interface() + nr := NewRequest(r.Service, r.Operation, awsutil.CopyOf(r.Params), data) + for i, intok := range nr.Operation.InputTokens { + awsutil.SetValueAtAnyPath(nr.Params, intok, tokens[i]) + } + return nr +} + +// EachPage iterates over each page of a paginated request object. The fn +// parameter should be a function with the following sample signature: +// +// func(page *T, lastPage bool) bool { +// return true // return false to stop iterating +// } +// +// Where "T" is the structure type matching the output structure of the given +// operation. For example, a request object generated by +// DynamoDB.ListTablesRequest() would expect to see dynamodb.ListTablesOutput +// as the structure "T". The lastPage value represents whether the page is +// the last page of data or not. The return value of this function should +// return true to keep iterating or false to stop. +func (r *Request) EachPage(fn func(data interface{}, isLastPage bool) (shouldContinue bool)) error { + for page := r; page != nil; page = page.NextPage() { + page.Send() + shouldContinue := fn(page.Data, !page.HasNextPage()) + if page.Error != nil || !shouldContinue { + return page.Error + } + } + + return nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/service.go b/vendor/src/github.com/aws/aws-sdk-go/aws/service.go new file mode 100644 index 0000000000..672f7de1d6 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/service.go @@ -0,0 +1,194 @@ +package aws + +import ( + "fmt" + "math" + "math/rand" + "net/http" + "net/http/httputil" + "regexp" + "time" + + "github.com/aws/aws-sdk-go/aws/awserr" + "github.com/aws/aws-sdk-go/internal/endpoints" +) + +// A Service implements the base service request and response handling +// used by all services. +type Service struct { + Config *Config + Handlers Handlers + ServiceName string + APIVersion string + Endpoint string + SigningName string + SigningRegion string + JSONVersion string + TargetPrefix string + RetryRules func(*Request) time.Duration + ShouldRetry func(*Request) bool + DefaultMaxRetries uint +} + +var schemeRE = regexp.MustCompile("^([^:]+)://") + +// NewService will return a pointer to a new Server object initialized. +func NewService(config *Config) *Service { + svc := &Service{Config: config} + svc.Initialize() + return svc +} + +// Initialize initializes the service. +func (s *Service) Initialize() { + if s.Config == nil { + s.Config = &Config{} + } + if s.Config.HTTPClient == nil { + s.Config.HTTPClient = http.DefaultClient + } + + if s.RetryRules == nil { + s.RetryRules = retryRules + } + + if s.ShouldRetry == nil { + s.ShouldRetry = shouldRetry + } + + s.DefaultMaxRetries = 3 + s.Handlers.Validate.PushBack(ValidateEndpointHandler) + s.Handlers.Build.PushBack(UserAgentHandler) + s.Handlers.Sign.PushBack(BuildContentLength) + s.Handlers.Send.PushBack(SendHandler) + s.Handlers.AfterRetry.PushBack(AfterRetryHandler) + s.Handlers.ValidateResponse.PushBack(ValidateResponseHandler) + s.AddDebugHandlers() + s.buildEndpoint() + + if !BoolValue(s.Config.DisableParamValidation) { + s.Handlers.Validate.PushBack(ValidateParameters) + } +} + +// buildEndpoint builds the endpoint values the service will use to make requests with. +func (s *Service) buildEndpoint() { + if StringValue(s.Config.Endpoint) != "" { + s.Endpoint = *s.Config.Endpoint + } else { + s.Endpoint, s.SigningRegion = + endpoints.EndpointForRegion(s.ServiceName, StringValue(s.Config.Region)) + } + + if s.Endpoint != "" && !schemeRE.MatchString(s.Endpoint) { + scheme := "https" + if BoolValue(s.Config.DisableSSL) { + scheme = "http" + } + s.Endpoint = scheme + "://" + s.Endpoint + } +} + +// AddDebugHandlers injects debug logging handlers into the service to log request +// debug information. +func (s *Service) AddDebugHandlers() { + if !s.Config.LogLevel.AtLeast(LogDebug) { + return + } + + s.Handlers.Send.PushFront(logRequest) + s.Handlers.Send.PushBack(logResponse) +} + +const logReqMsg = `DEBUG: Request %s/%s Details: +---[ REQUEST POST-SIGN ]----------------------------- +%s +-----------------------------------------------------` + +func logRequest(r *Request) { + logBody := r.Config.LogLevel.Matches(LogDebugWithHTTPBody) + dumpedBody, _ := httputil.DumpRequestOut(r.HTTPRequest, logBody) + + r.Config.Logger.Log(fmt.Sprintf(logReqMsg, r.ServiceName, r.Operation.Name, string(dumpedBody))) +} + +const logRespMsg = `DEBUG: Response %s/%s Details: +---[ RESPONSE ]-------------------------------------- +%s +-----------------------------------------------------` + +func logResponse(r *Request) { + var msg = "no reponse data" + if r.HTTPResponse != nil { + logBody := r.Config.LogLevel.Matches(LogDebugWithHTTPBody) + dumpedBody, _ := httputil.DumpResponse(r.HTTPResponse, logBody) + msg = string(dumpedBody) + } else if r.Error != nil { + msg = r.Error.Error() + } + r.Config.Logger.Log(fmt.Sprintf(logRespMsg, r.ServiceName, r.Operation.Name, msg)) +} + +// MaxRetries returns the number of maximum returns the service will use to make +// an individual API request. +func (s *Service) MaxRetries() uint { + if IntValue(s.Config.MaxRetries) < 0 { + return s.DefaultMaxRetries + } + return uint(IntValue(s.Config.MaxRetries)) +} + +var seededRand = rand.New(rand.NewSource(time.Now().UnixNano())) + +// retryRules returns the delay duration before retrying this request again +func retryRules(r *Request) time.Duration { + + delay := int(math.Pow(2, float64(r.RetryCount))) * (seededRand.Intn(30) + 30) + return time.Duration(delay) * time.Millisecond +} + +// retryableCodes is a collection of service response codes which are retry-able +// without any further action. +var retryableCodes = map[string]struct{}{ + "RequestError": {}, + "ProvisionedThroughputExceededException": {}, + "Throttling": {}, + "ThrottlingException": {}, + "RequestLimitExceeded": {}, + "RequestThrottled": {}, +} + +// credsExpiredCodes is a collection of error codes which signify the credentials +// need to be refreshed. Expired tokens require refreshing of credentials, and +// resigning before the request can be retried. +var credsExpiredCodes = map[string]struct{}{ + "ExpiredToken": {}, + "ExpiredTokenException": {}, + "RequestExpired": {}, // EC2 Only +} + +func isCodeRetryable(code string) bool { + if _, ok := retryableCodes[code]; ok { + return true + } + + return isCodeExpiredCreds(code) +} + +func isCodeExpiredCreds(code string) bool { + _, ok := credsExpiredCodes[code] + return ok +} + +// shouldRetry returns if the request should be retried. +func shouldRetry(r *Request) bool { + if r.HTTPResponse.StatusCode >= 500 { + return true + } + if r.Error != nil { + if err, ok := r.Error.(awserr.Error); ok { + return isCodeRetryable(err.Code()) + } + } + return false +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/types.go b/vendor/src/github.com/aws/aws-sdk-go/aws/types.go new file mode 100644 index 0000000000..87905d7e06 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/types.go @@ -0,0 +1,55 @@ +package aws + +import ( + "io" +) + +// ReadSeekCloser wraps a io.Reader returning a ReaderSeakerCloser +func ReadSeekCloser(r io.Reader) ReaderSeekerCloser { + return ReaderSeekerCloser{r} +} + +// ReaderSeekerCloser represents a reader that can also delegate io.Seeker and +// io.Closer interfaces to the underlying object if they are available. +type ReaderSeekerCloser struct { + r io.Reader +} + +// Read reads from the reader up to size of p. The number of bytes read, and +// error if it occurred will be returned. +// +// If the reader is not an io.Reader zero bytes read, and nil error will be returned. +// +// Performs the same functionality as io.Reader Read +func (r ReaderSeekerCloser) Read(p []byte) (int, error) { + switch t := r.r.(type) { + case io.Reader: + return t.Read(p) + } + return 0, nil +} + +// Seek sets the offset for the next Read to offset, interpreted according to +// whence: 0 means relative to the origin of the file, 1 means relative to the +// current offset, and 2 means relative to the end. Seek returns the new offset +// and an error, if any. +// +// If the ReaderSeekerCloser is not an io.Seeker nothing will be done. +func (r ReaderSeekerCloser) Seek(offset int64, whence int) (int64, error) { + switch t := r.r.(type) { + case io.Seeker: + return t.Seek(offset, whence) + } + return int64(0), nil +} + +// Close closes the ReaderSeekerCloser. +// +// If the ReaderSeekerCloser is not an io.Closer nothing will be done. +func (r ReaderSeekerCloser) Close() error { + switch t := r.r.(type) { + case io.Closer: + return t.Close() + } + return nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/aws/version.go b/vendor/src/github.com/aws/aws-sdk-go/aws/version.go new file mode 100644 index 0000000000..51c3358efd --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/aws/version.go @@ -0,0 +1,8 @@ +// Package aws provides core functionality for making requests to AWS services. +package aws + +// SDKName is the name of this AWS SDK +const SDKName = "aws-sdk-go" + +// SDKVersion is the version of this SDK +const SDKVersion = "0.7.1" diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.go b/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.go new file mode 100644 index 0000000000..d040cccd57 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.go @@ -0,0 +1,31 @@ +// Package endpoints validates regional endpoints for services. +package endpoints + +//go:generate go run ../model/cli/gen-endpoints/main.go endpoints.json endpoints_map.go +//go:generate gofmt -s -w endpoints_map.go + +import "strings" + +// EndpointForRegion returns an endpoint and its signing region for a service and region. +// if the service and region pair are not found endpoint and signingRegion will be empty. +func EndpointForRegion(svcName, region string) (endpoint, signingRegion string) { + derivedKeys := []string{ + region + "/" + svcName, + region + "/*", + "*/" + svcName, + "*/*", + } + + for _, key := range derivedKeys { + if val, ok := endpointsMap.Endpoints[key]; ok { + ep := val.Endpoint + ep = strings.Replace(ep, "{region}", region, -1) + ep = strings.Replace(ep, "{service}", svcName, -1) + + endpoint = ep + signingRegion = val.SigningRegion + return + } + } + return +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.json b/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.json new file mode 100644 index 0000000000..4c588090a9 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints.json @@ -0,0 +1,77 @@ +{ + "version": 2, + "endpoints": { + "*/*": { + "endpoint": "{service}.{region}.amazonaws.com" + }, + "cn-north-1/*": { + "endpoint": "{service}.{region}.amazonaws.com.cn", + "signatureVersion": "v4" + }, + "us-gov-west-1/iam": { + "endpoint": "iam.us-gov.amazonaws.com" + }, + "us-gov-west-1/sts": { + "endpoint": "sts.us-gov-west-1.amazonaws.com" + }, + "us-gov-west-1/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "*/cloudfront": { + "endpoint": "cloudfront.amazonaws.com", + "signingRegion": "us-east-1" + }, + "*/cloudsearchdomain": { + "endpoint": "", + "signingRegion": "us-east-1" + }, + "*/iam": { + "endpoint": "iam.amazonaws.com", + "signingRegion": "us-east-1" + }, + "*/importexport": { + "endpoint": "importexport.amazonaws.com", + "signingRegion": "us-east-1" + }, + "*/route53": { + "endpoint": "route53.amazonaws.com", + "signingRegion": "us-east-1" + }, + "*/sts": { + "endpoint": "sts.amazonaws.com", + "signingRegion": "us-east-1" + }, + "us-east-1/sdb": { + "endpoint": "sdb.amazonaws.com", + "signingRegion": "us-east-1" + }, + "us-east-1/s3": { + "endpoint": "s3.amazonaws.com" + }, + "us-west-1/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "us-west-2/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "eu-west-1/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "ap-southeast-1/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "ap-southeast-2/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "ap-northeast-1/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "sa-east-1/s3": { + "endpoint": "s3-{region}.amazonaws.com" + }, + "eu-central-1/s3": { + "endpoint": "{service}.{region}.amazonaws.com", + "signatureVersion": "v4" + } + } +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints_map.go b/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints_map.go new file mode 100644 index 0000000000..894c1a6434 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/endpoints/endpoints_map.go @@ -0,0 +1,89 @@ +package endpoints + +// THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT. + +type endpointStruct struct { + Version int + Endpoints map[string]endpointEntry +} + +type endpointEntry struct { + Endpoint string + SigningRegion string +} + +var endpointsMap = endpointStruct{ + Version: 2, + Endpoints: map[string]endpointEntry{ + "*/*": { + Endpoint: "{service}.{region}.amazonaws.com", + }, + "*/cloudfront": { + Endpoint: "cloudfront.amazonaws.com", + SigningRegion: "us-east-1", + }, + "*/cloudsearchdomain": { + Endpoint: "", + SigningRegion: "us-east-1", + }, + "*/iam": { + Endpoint: "iam.amazonaws.com", + SigningRegion: "us-east-1", + }, + "*/importexport": { + Endpoint: "importexport.amazonaws.com", + SigningRegion: "us-east-1", + }, + "*/route53": { + Endpoint: "route53.amazonaws.com", + SigningRegion: "us-east-1", + }, + "*/sts": { + Endpoint: "sts.amazonaws.com", + SigningRegion: "us-east-1", + }, + "ap-northeast-1/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "ap-southeast-1/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "ap-southeast-2/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "cn-north-1/*": { + Endpoint: "{service}.{region}.amazonaws.com.cn", + }, + "eu-central-1/s3": { + Endpoint: "{service}.{region}.amazonaws.com", + }, + "eu-west-1/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "sa-east-1/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "us-east-1/s3": { + Endpoint: "s3.amazonaws.com", + }, + "us-east-1/sdb": { + Endpoint: "sdb.amazonaws.com", + SigningRegion: "us-east-1", + }, + "us-gov-west-1/iam": { + Endpoint: "iam.us-gov.amazonaws.com", + }, + "us-gov-west-1/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "us-gov-west-1/sts": { + Endpoint: "sts.us-gov-west-1.amazonaws.com", + }, + "us-west-1/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + "us-west-2/s3": { + Endpoint: "s3-{region}.amazonaws.com", + }, + }, +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/build.go b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/build.go new file mode 100644 index 0000000000..58b65fb8fb --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/build.go @@ -0,0 +1,199 @@ +// Package jsonutil provides JSON serialisation of AWS requests and responses. +package jsonutil + +import ( + "bytes" + "encoding/base64" + "fmt" + "reflect" + "sort" + "strconv" + "strings" + "time" +) + +// BuildJSON builds a JSON string for a given object v. +func BuildJSON(v interface{}) ([]byte, error) { + var buf bytes.Buffer + + err := buildAny(reflect.ValueOf(v), &buf, "") + return buf.Bytes(), err +} + +func buildAny(value reflect.Value, buf *bytes.Buffer, tag reflect.StructTag) error { + value = reflect.Indirect(value) + if !value.IsValid() { + return nil + } + + vtype := value.Type() + + t := tag.Get("type") + if t == "" { + switch vtype.Kind() { + case reflect.Struct: + // also it can't be a time object + if _, ok := value.Interface().(time.Time); !ok { + t = "structure" + } + case reflect.Slice: + // also it can't be a byte slice + if _, ok := value.Interface().([]byte); !ok { + t = "list" + } + case reflect.Map: + t = "map" + } + } + + switch t { + case "structure": + if field, ok := vtype.FieldByName("SDKShapeTraits"); ok { + tag = field.Tag + } + return buildStruct(value, buf, tag) + case "list": + return buildList(value, buf, tag) + case "map": + return buildMap(value, buf, tag) + default: + return buildScalar(value, buf, tag) + } +} + +func buildStruct(value reflect.Value, buf *bytes.Buffer, tag reflect.StructTag) error { + if !value.IsValid() { + return nil + } + + buf.WriteString("{") + + t, fields := value.Type(), []*reflect.StructField{} + for i := 0; i < t.NumField(); i++ { + field := t.Field(i) + member := value.FieldByName(field.Name) + if (member.Kind() == reflect.Ptr || member.Kind() == reflect.Slice || member.Kind() == reflect.Map) && member.IsNil() { + continue // ignore unset fields + } + if c := field.Name[0:1]; strings.ToLower(c) == c { + continue // ignore unexported fields + } + if field.Tag.Get("location") != "" { + continue // ignore non-body elements + } + + fields = append(fields, &field) + } + + for i, field := range fields { + member := value.FieldByName(field.Name) + + // figure out what this field is called + name := field.Name + if locName := field.Tag.Get("locationName"); locName != "" { + name = locName + } + + buf.WriteString(fmt.Sprintf("%q:", name)) + + err := buildAny(member, buf, field.Tag) + if err != nil { + return err + } + + if i < len(fields)-1 { + buf.WriteString(",") + } + } + + buf.WriteString("}") + + return nil +} + +func buildList(value reflect.Value, buf *bytes.Buffer, tag reflect.StructTag) error { + buf.WriteString("[") + + for i := 0; i < value.Len(); i++ { + buildAny(value.Index(i), buf, "") + + if i < value.Len()-1 { + buf.WriteString(",") + } + } + + buf.WriteString("]") + + return nil +} + +func buildMap(value reflect.Value, buf *bytes.Buffer, tag reflect.StructTag) error { + buf.WriteString("{") + + keys := make([]string, value.Len()) + for i, n := range value.MapKeys() { + keys[i] = n.String() + } + sort.Strings(keys) + + for i, k := range keys { + buf.WriteString(fmt.Sprintf("%q:", k)) + buildAny(value.MapIndex(reflect.ValueOf(k)), buf, "") + + if i < len(keys)-1 { + buf.WriteString(",") + } + } + + buf.WriteString("}") + + return nil +} + +func buildScalar(value reflect.Value, buf *bytes.Buffer, tag reflect.StructTag) error { + switch converted := value.Interface().(type) { + case string: + writeString(converted, buf) + case []byte: + if !value.IsNil() { + buf.WriteString(fmt.Sprintf("%q", base64.StdEncoding.EncodeToString(converted))) + } + case bool: + buf.WriteString(strconv.FormatBool(converted)) + case int64: + buf.WriteString(strconv.FormatInt(converted, 10)) + case float64: + buf.WriteString(strconv.FormatFloat(converted, 'f', -1, 64)) + case time.Time: + buf.WriteString(strconv.FormatInt(converted.UTC().Unix(), 10)) + default: + return fmt.Errorf("unsupported JSON value %v (%s)", value.Interface(), value.Type()) + } + return nil +} + +func writeString(s string, buf *bytes.Buffer) { + buf.WriteByte('"') + for _, r := range s { + if r == '"' { + buf.WriteString(`\"`) + } else if r == '\\' { + buf.WriteString(`\\`) + } else if r == '\b' { + buf.WriteString(`\b`) + } else if r == '\f' { + buf.WriteString(`\f`) + } else if r == '\r' { + buf.WriteString(`\r`) + } else if r == '\t' { + buf.WriteString(`\t`) + } else if r == '\n' { + buf.WriteString(`\n`) + } else if r < 32 { + fmt.Fprintf(buf, "\\u%0.4x", r) + } else { + buf.WriteRune(r) + } + } + buf.WriteByte('"') +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/unmarshal.go b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/unmarshal.go new file mode 100644 index 0000000000..730dcd0f80 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil/unmarshal.go @@ -0,0 +1,214 @@ +package jsonutil + +import ( + "encoding/base64" + "encoding/json" + "fmt" + "io" + "io/ioutil" + "reflect" + "strings" + "time" +) + +// UnmarshalJSON reads a stream and unmarshals the results in object v. +func UnmarshalJSON(v interface{}, stream io.Reader) error { + var out interface{} + + b, err := ioutil.ReadAll(stream) + if err != nil { + return err + } + + if len(b) == 0 { + return nil + } + + if err := json.Unmarshal(b, &out); err != nil { + return err + } + + return unmarshalAny(reflect.ValueOf(v), out, "") +} + +func unmarshalAny(value reflect.Value, data interface{}, tag reflect.StructTag) error { + vtype := value.Type() + if vtype.Kind() == reflect.Ptr { + vtype = vtype.Elem() // check kind of actual element type + } + + t := tag.Get("type") + if t == "" { + switch vtype.Kind() { + case reflect.Struct: + // also it can't be a time object + if _, ok := value.Interface().(*time.Time); !ok { + t = "structure" + } + case reflect.Slice: + // also it can't be a byte slice + if _, ok := value.Interface().([]byte); !ok { + t = "list" + } + case reflect.Map: + t = "map" + } + } + + switch t { + case "structure": + if field, ok := vtype.FieldByName("SDKShapeTraits"); ok { + tag = field.Tag + } + return unmarshalStruct(value, data, tag) + case "list": + return unmarshalList(value, data, tag) + case "map": + return unmarshalMap(value, data, tag) + default: + return unmarshalScalar(value, data, tag) + } +} + +func unmarshalStruct(value reflect.Value, data interface{}, tag reflect.StructTag) error { + if data == nil { + return nil + } + mapData, ok := data.(map[string]interface{}) + if !ok { + return fmt.Errorf("JSON value is not a structure (%#v)", data) + } + + t := value.Type() + if value.Kind() == reflect.Ptr { + if value.IsNil() { // create the structure if it's nil + s := reflect.New(value.Type().Elem()) + value.Set(s) + value = s + } + + value = value.Elem() + t = t.Elem() + } + + // unwrap any payloads + if payload := tag.Get("payload"); payload != "" { + field, _ := t.FieldByName(payload) + return unmarshalAny(value.FieldByName(payload), data, field.Tag) + } + + for i := 0; i < t.NumField(); i++ { + field := t.Field(i) + if c := field.Name[0:1]; strings.ToLower(c) == c { + continue // ignore unexported fields + } + + // figure out what this field is called + name := field.Name + if locName := field.Tag.Get("locationName"); locName != "" { + name = locName + } + + member := value.FieldByName(field.Name) + err := unmarshalAny(member, mapData[name], field.Tag) + if err != nil { + return err + } + } + return nil +} + +func unmarshalList(value reflect.Value, data interface{}, tag reflect.StructTag) error { + if data == nil { + return nil + } + listData, ok := data.([]interface{}) + if !ok { + return fmt.Errorf("JSON value is not a list (%#v)", data) + } + + if value.IsNil() { + l := len(listData) + value.Set(reflect.MakeSlice(value.Type(), l, l)) + } + + for i, c := range listData { + err := unmarshalAny(value.Index(i), c, "") + if err != nil { + return err + } + } + + return nil +} + +func unmarshalMap(value reflect.Value, data interface{}, tag reflect.StructTag) error { + if data == nil { + return nil + } + mapData, ok := data.(map[string]interface{}) + if !ok { + return fmt.Errorf("JSON value is not a map (%#v)", data) + } + + if value.IsNil() { + value.Set(reflect.MakeMap(value.Type())) + } + + for k, v := range mapData { + kvalue := reflect.ValueOf(k) + vvalue := reflect.New(value.Type().Elem()).Elem() + + unmarshalAny(vvalue, v, "") + value.SetMapIndex(kvalue, vvalue) + } + + return nil +} + +func unmarshalScalar(value reflect.Value, data interface{}, tag reflect.StructTag) error { + errf := func() error { + return fmt.Errorf("unsupported value: %v (%s)", value.Interface(), value.Type()) + } + + switch d := data.(type) { + case nil: + return nil // nothing to do here + case string: + switch value.Interface().(type) { + case *string: + value.Set(reflect.ValueOf(&d)) + case []byte: + b, err := base64.StdEncoding.DecodeString(d) + if err != nil { + return err + } + value.Set(reflect.ValueOf(b)) + default: + return errf() + } + case float64: + switch value.Interface().(type) { + case *int64: + di := int64(d) + value.Set(reflect.ValueOf(&di)) + case *float64: + value.Set(reflect.ValueOf(&d)) + case *time.Time: + t := time.Unix(int64(d), 0).UTC() + value.Set(reflect.ValueOf(&t)) + default: + return errf() + } + case bool: + switch value.Interface().(type) { + case *bool: + value.Set(reflect.ValueOf(&d)) + default: + return errf() + } + default: + return fmt.Errorf("unsupported JSON value (%v)", data) + } + return nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/jsonrpc/jsonrpc.go b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/jsonrpc/jsonrpc.go new file mode 100644 index 0000000000..daf1efd59b --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/jsonrpc/jsonrpc.go @@ -0,0 +1,98 @@ +// Package jsonrpc provides JSON RPC utilities for serialisation of AWS +// requests and responses. +package jsonrpc + +//go:generate go run ../../fixtures/protocol/generate.go ../../fixtures/protocol/input/json.json build_test.go +//go:generate go run ../../fixtures/protocol/generate.go ../../fixtures/protocol/output/json.json unmarshal_test.go + +import ( + "encoding/json" + "io/ioutil" + "strings" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awserr" + "github.com/aws/aws-sdk-go/internal/protocol/json/jsonutil" +) + +var emptyJSON = []byte("{}") + +// Build builds a JSON payload for a JSON RPC request. +func Build(req *aws.Request) { + var buf []byte + var err error + if req.ParamsFilled() { + buf, err = jsonutil.BuildJSON(req.Params) + if err != nil { + req.Error = awserr.New("SerializationError", "failed encoding JSON RPC request", err) + return + } + } else { + buf = emptyJSON + } + + if req.Service.TargetPrefix != "" || string(buf) != "{}" { + req.SetBufferBody(buf) + } + + if req.Service.TargetPrefix != "" { + target := req.Service.TargetPrefix + "." + req.Operation.Name + req.HTTPRequest.Header.Add("X-Amz-Target", target) + } + if req.Service.JSONVersion != "" { + jsonVersion := req.Service.JSONVersion + req.HTTPRequest.Header.Add("Content-Type", "application/x-amz-json-"+jsonVersion) + } +} + +// Unmarshal unmarshals a response for a JSON RPC service. +func Unmarshal(req *aws.Request) { + defer req.HTTPResponse.Body.Close() + if req.DataFilled() { + err := jsonutil.UnmarshalJSON(req.Data, req.HTTPResponse.Body) + if err != nil { + req.Error = awserr.New("SerializationError", "failed decoding JSON RPC response", err) + } + } + return +} + +// UnmarshalMeta unmarshals headers from a response for a JSON RPC service. +func UnmarshalMeta(req *aws.Request) { + req.RequestID = req.HTTPResponse.Header.Get("x-amzn-requestid") +} + +// UnmarshalError unmarshals an error response for a JSON RPC service. +func UnmarshalError(req *aws.Request) { + defer req.HTTPResponse.Body.Close() + bodyBytes, err := ioutil.ReadAll(req.HTTPResponse.Body) + if err != nil { + req.Error = awserr.New("SerializationError", "failed reading JSON RPC error response", err) + return + } + if len(bodyBytes) == 0 { + req.Error = awserr.NewRequestFailure( + awserr.New("SerializationError", req.HTTPResponse.Status, nil), + req.HTTPResponse.StatusCode, + "", + ) + return + } + var jsonErr jsonErrorResponse + if err := json.Unmarshal(bodyBytes, &jsonErr); err != nil { + req.Error = awserr.New("SerializationError", "failed decoding JSON RPC error response", err) + return + } + + codes := strings.SplitN(jsonErr.Code, "#", 2) + req.Error = awserr.NewRequestFailure( + awserr.New(codes[len(codes)-1], jsonErr.Message, nil), + req.HTTPResponse.StatusCode, + "", + ) +} + +type jsonErrorResponse struct { + Code string `json:"__type"` + Message string `json:"message"` +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/build.go b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/build.go new file mode 100644 index 0000000000..cd5eef2351 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/build.go @@ -0,0 +1,212 @@ +// Package rest provides RESTful serialisation of AWS requests and responses. +package rest + +import ( + "bytes" + "encoding/base64" + "fmt" + "io" + "net/url" + "path" + "reflect" + "strconv" + "strings" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awserr" +) + +// RFC822 returns an RFC822 formatted timestamp for AWS protocols +const RFC822 = "Mon, 2 Jan 2006 15:04:05 GMT" + +// Whether the byte value can be sent without escaping in AWS URLs +var noEscape [256]bool + +func init() { + for i := 0; i < len(noEscape); i++ { + // AWS expects every character except these to be escaped + noEscape[i] = (i >= 'A' && i <= 'Z') || + (i >= 'a' && i <= 'z') || + (i >= '0' && i <= '9') || + i == '-' || + i == '.' || + i == '_' || + i == '~' + } +} + +// Build builds the REST component of a service request. +func Build(r *aws.Request) { + if r.ParamsFilled() { + v := reflect.ValueOf(r.Params).Elem() + buildLocationElements(r, v) + buildBody(r, v) + } +} + +func buildLocationElements(r *aws.Request, v reflect.Value) { + query := r.HTTPRequest.URL.Query() + + for i := 0; i < v.NumField(); i++ { + m := v.Field(i) + if n := v.Type().Field(i).Name; n[0:1] == strings.ToLower(n[0:1]) { + continue + } + + if m.IsValid() { + field := v.Type().Field(i) + name := field.Tag.Get("locationName") + if name == "" { + name = field.Name + } + if m.Kind() == reflect.Ptr { + m = m.Elem() + } + if !m.IsValid() { + continue + } + + switch field.Tag.Get("location") { + case "headers": // header maps + buildHeaderMap(r, m, field.Tag.Get("locationName")) + case "header": + buildHeader(r, m, name) + case "uri": + buildURI(r, m, name) + case "querystring": + buildQueryString(r, m, name, query) + } + } + if r.Error != nil { + return + } + } + + r.HTTPRequest.URL.RawQuery = query.Encode() + updatePath(r.HTTPRequest.URL, r.HTTPRequest.URL.Path) +} + +func buildBody(r *aws.Request, v reflect.Value) { + if field, ok := v.Type().FieldByName("SDKShapeTraits"); ok { + if payloadName := field.Tag.Get("payload"); payloadName != "" { + pfield, _ := v.Type().FieldByName(payloadName) + if ptag := pfield.Tag.Get("type"); ptag != "" && ptag != "structure" { + payload := reflect.Indirect(v.FieldByName(payloadName)) + if payload.IsValid() && payload.Interface() != nil { + switch reader := payload.Interface().(type) { + case io.ReadSeeker: + r.SetReaderBody(reader) + case []byte: + r.SetBufferBody(reader) + case string: + r.SetStringBody(reader) + default: + r.Error = awserr.New("SerializationError", + "failed to encode REST request", + fmt.Errorf("unknown payload type %s", payload.Type())) + } + } + } + } + } +} + +func buildHeader(r *aws.Request, v reflect.Value, name string) { + str, err := convertType(v) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to encode REST request", err) + } else if str != nil { + r.HTTPRequest.Header.Add(name, *str) + } +} + +func buildHeaderMap(r *aws.Request, v reflect.Value, prefix string) { + for _, key := range v.MapKeys() { + str, err := convertType(v.MapIndex(key)) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to encode REST request", err) + } else if str != nil { + r.HTTPRequest.Header.Add(prefix+key.String(), *str) + } + } +} + +func buildURI(r *aws.Request, v reflect.Value, name string) { + value, err := convertType(v) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to encode REST request", err) + } else if value != nil { + uri := r.HTTPRequest.URL.Path + uri = strings.Replace(uri, "{"+name+"}", EscapePath(*value, true), -1) + uri = strings.Replace(uri, "{"+name+"+}", EscapePath(*value, false), -1) + r.HTTPRequest.URL.Path = uri + } +} + +func buildQueryString(r *aws.Request, v reflect.Value, name string, query url.Values) { + str, err := convertType(v) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to encode REST request", err) + } else if str != nil { + query.Set(name, *str) + } +} + +func updatePath(url *url.URL, urlPath string) { + scheme, query := url.Scheme, url.RawQuery + + // clean up path + urlPath = path.Clean(urlPath) + + // get formatted URL minus scheme so we can build this into Opaque + url.Scheme, url.Path, url.RawQuery = "", "", "" + s := url.String() + url.Scheme = scheme + url.RawQuery = query + + // build opaque URI + url.Opaque = s + urlPath +} + +// EscapePath escapes part of a URL path in Amazon style +func EscapePath(path string, encodeSep bool) string { + var buf bytes.Buffer + for i := 0; i < len(path); i++ { + c := path[i] + if noEscape[c] || (c == '/' && !encodeSep) { + buf.WriteByte(c) + } else { + buf.WriteByte('%') + buf.WriteString(strings.ToUpper(strconv.FormatUint(uint64(c), 16))) + } + } + return buf.String() +} + +func convertType(v reflect.Value) (*string, error) { + v = reflect.Indirect(v) + if !v.IsValid() { + return nil, nil + } + + var str string + switch value := v.Interface().(type) { + case string: + str = value + case []byte: + str = base64.StdEncoding.EncodeToString(value) + case bool: + str = strconv.FormatBool(value) + case int64: + str = strconv.FormatInt(value, 10) + case float64: + str = strconv.FormatFloat(value, 'f', -1, 64) + case time.Time: + str = value.UTC().Format(RFC822) + default: + err := fmt.Errorf("Unsupported value for param %v (%s)", v.Interface(), v.Type()) + return nil, err + } + return &str, nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/payload.go b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/payload.go new file mode 100644 index 0000000000..1f603bb719 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/payload.go @@ -0,0 +1,45 @@ +package rest + +import "reflect" + +// PayloadMember returns the payload field member of i if there is one, or nil. +func PayloadMember(i interface{}) interface{} { + if i == nil { + return nil + } + + v := reflect.ValueOf(i).Elem() + if !v.IsValid() { + return nil + } + if field, ok := v.Type().FieldByName("SDKShapeTraits"); ok { + if payloadName := field.Tag.Get("payload"); payloadName != "" { + field, _ := v.Type().FieldByName(payloadName) + if field.Tag.Get("type") != "structure" { + return nil + } + + payload := v.FieldByName(payloadName) + if payload.IsValid() || (payload.Kind() == reflect.Ptr && !payload.IsNil()) { + return payload.Interface() + } + } + } + return nil +} + +// PayloadType returns the type of a payload field member of i if there is one, or "". +func PayloadType(i interface{}) string { + v := reflect.Indirect(reflect.ValueOf(i)) + if !v.IsValid() { + return "" + } + if field, ok := v.Type().FieldByName("SDKShapeTraits"); ok { + if payloadName := field.Tag.Get("payload"); payloadName != "" { + if member, ok := v.Type().FieldByName(payloadName); ok { + return member.Tag.Get("type") + } + } + } + return "" +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/unmarshal.go b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/unmarshal.go new file mode 100644 index 0000000000..a4155f1669 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/protocol/rest/unmarshal.go @@ -0,0 +1,174 @@ +package rest + +import ( + "encoding/base64" + "fmt" + "io/ioutil" + "net/http" + "reflect" + "strconv" + "strings" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awserr" +) + +// Unmarshal unmarshals the REST component of a response in a REST service. +func Unmarshal(r *aws.Request) { + if r.DataFilled() { + v := reflect.Indirect(reflect.ValueOf(r.Data)) + unmarshalBody(r, v) + unmarshalLocationElements(r, v) + } +} + +func unmarshalBody(r *aws.Request, v reflect.Value) { + if field, ok := v.Type().FieldByName("SDKShapeTraits"); ok { + if payloadName := field.Tag.Get("payload"); payloadName != "" { + pfield, _ := v.Type().FieldByName(payloadName) + if ptag := pfield.Tag.Get("type"); ptag != "" && ptag != "structure" { + payload := v.FieldByName(payloadName) + if payload.IsValid() { + switch payload.Interface().(type) { + case []byte: + b, err := ioutil.ReadAll(r.HTTPResponse.Body) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to decode REST response", err) + } else { + payload.Set(reflect.ValueOf(b)) + } + case *string: + b, err := ioutil.ReadAll(r.HTTPResponse.Body) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to decode REST response", err) + } else { + str := string(b) + payload.Set(reflect.ValueOf(&str)) + } + default: + switch payload.Type().String() { + case "io.ReadSeeker": + payload.Set(reflect.ValueOf(aws.ReadSeekCloser(r.HTTPResponse.Body))) + case "aws.ReadSeekCloser", "io.ReadCloser": + payload.Set(reflect.ValueOf(r.HTTPResponse.Body)) + default: + r.Error = awserr.New("SerializationError", + "failed to decode REST response", + fmt.Errorf("unknown payload type %s", payload.Type())) + } + } + } + } + } + } +} + +func unmarshalLocationElements(r *aws.Request, v reflect.Value) { + for i := 0; i < v.NumField(); i++ { + m, field := v.Field(i), v.Type().Field(i) + if n := field.Name; n[0:1] == strings.ToLower(n[0:1]) { + continue + } + + if m.IsValid() { + name := field.Tag.Get("locationName") + if name == "" { + name = field.Name + } + + switch field.Tag.Get("location") { + case "statusCode": + unmarshalStatusCode(m, r.HTTPResponse.StatusCode) + case "header": + err := unmarshalHeader(m, r.HTTPResponse.Header.Get(name)) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to decode REST response", err) + break + } + case "headers": + prefix := field.Tag.Get("locationName") + err := unmarshalHeaderMap(m, r.HTTPResponse.Header, prefix) + if err != nil { + r.Error = awserr.New("SerializationError", "failed to decode REST response", err) + break + } + } + } + if r.Error != nil { + return + } + } +} + +func unmarshalStatusCode(v reflect.Value, statusCode int) { + if !v.IsValid() { + return + } + + switch v.Interface().(type) { + case *int64: + s := int64(statusCode) + v.Set(reflect.ValueOf(&s)) + } +} + +func unmarshalHeaderMap(r reflect.Value, headers http.Header, prefix string) error { + switch r.Interface().(type) { + case map[string]*string: // we only support string map value types + out := map[string]*string{} + for k, v := range headers { + k = http.CanonicalHeaderKey(k) + if strings.HasPrefix(strings.ToLower(k), strings.ToLower(prefix)) { + out[k[len(prefix):]] = &v[0] + } + } + r.Set(reflect.ValueOf(out)) + } + return nil +} + +func unmarshalHeader(v reflect.Value, header string) error { + if !v.IsValid() || (header == "" && v.Elem().Kind() != reflect.String) { + return nil + } + + switch v.Interface().(type) { + case *string: + v.Set(reflect.ValueOf(&header)) + case []byte: + b, err := base64.StdEncoding.DecodeString(header) + if err != nil { + return err + } + v.Set(reflect.ValueOf(&b)) + case *bool: + b, err := strconv.ParseBool(header) + if err != nil { + return err + } + v.Set(reflect.ValueOf(&b)) + case *int64: + i, err := strconv.ParseInt(header, 10, 64) + if err != nil { + return err + } + v.Set(reflect.ValueOf(&i)) + case *float64: + f, err := strconv.ParseFloat(header, 64) + if err != nil { + return err + } + v.Set(reflect.ValueOf(&f)) + case *time.Time: + t, err := time.Parse(RFC822, header) + if err != nil { + return err + } + v.Set(reflect.ValueOf(&t)) + default: + err := fmt.Errorf("Unsupported value for param %v (%s)", v.Interface(), v.Type()) + return err + } + return nil +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/internal/signer/v4/v4.go b/vendor/src/github.com/aws/aws-sdk-go/internal/signer/v4/v4.go new file mode 100644 index 0000000000..748c37f2e6 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/internal/signer/v4/v4.go @@ -0,0 +1,364 @@ +// Package v4 implements signing for AWS V4 signer +package v4 + +import ( + "crypto/hmac" + "crypto/sha256" + "encoding/hex" + "fmt" + "io" + "net/http" + "net/url" + "sort" + "strconv" + "strings" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/credentials" + "github.com/aws/aws-sdk-go/internal/protocol/rest" +) + +const ( + authHeaderPrefix = "AWS4-HMAC-SHA256" + timeFormat = "20060102T150405Z" + shortTimeFormat = "20060102" +) + +var ignoredHeaders = map[string]bool{ + "Authorization": true, + "Content-Type": true, + "Content-Length": true, + "User-Agent": true, +} + +type signer struct { + Request *http.Request + Time time.Time + ExpireTime time.Duration + ServiceName string + Region string + CredValues credentials.Value + Credentials *credentials.Credentials + Query url.Values + Body io.ReadSeeker + Debug aws.LogLevelType + Logger aws.Logger + + isPresign bool + formattedTime string + formattedShortTime string + + signedHeaders string + canonicalHeaders string + canonicalString string + credentialString string + stringToSign string + signature string + authorization string +} + +// Sign requests with signature version 4. +// +// Will sign the requests with the service config's Credentials object +// Signing is skipped if the credentials is the credentials.AnonymousCredentials +// object. +func Sign(req *aws.Request) { + // If the request does not need to be signed ignore the signing of the + // request if the AnonymousCredentials object is used. + if req.Service.Config.Credentials == credentials.AnonymousCredentials { + return + } + + region := req.Service.SigningRegion + if region == "" { + region = aws.StringValue(req.Service.Config.Region) + } + + name := req.Service.SigningName + if name == "" { + name = req.Service.ServiceName + } + + s := signer{ + Request: req.HTTPRequest, + Time: req.Time, + ExpireTime: req.ExpireTime, + Query: req.HTTPRequest.URL.Query(), + Body: req.Body, + ServiceName: name, + Region: region, + Credentials: req.Service.Config.Credentials, + Debug: req.Service.Config.LogLevel.Value(), + Logger: req.Service.Config.Logger, + } + + req.Error = s.sign() +} + +func (v4 *signer) sign() error { + if v4.ExpireTime != 0 { + v4.isPresign = true + } + + if v4.isRequestSigned() { + if !v4.Credentials.IsExpired() { + // If the request is already signed, and the credentials have not + // expired yet ignore the signing request. + return nil + } + + // The credentials have expired for this request. The current signing + // is invalid, and needs to be request because the request will fail. + if v4.isPresign { + v4.removePresign() + // Update the request's query string to ensure the values stays in + // sync in the case retrieving the new credentials fails. + v4.Request.URL.RawQuery = v4.Query.Encode() + } + } + + var err error + v4.CredValues, err = v4.Credentials.Get() + if err != nil { + return err + } + + if v4.isPresign { + v4.Query.Set("X-Amz-Algorithm", authHeaderPrefix) + if v4.CredValues.SessionToken != "" { + v4.Query.Set("X-Amz-Security-Token", v4.CredValues.SessionToken) + } else { + v4.Query.Del("X-Amz-Security-Token") + } + } else if v4.CredValues.SessionToken != "" { + v4.Request.Header.Set("X-Amz-Security-Token", v4.CredValues.SessionToken) + } + + v4.build() + + if v4.Debug.Matches(aws.LogDebugWithSigning) { + v4.logSigningInfo() + } + + return nil +} + +const logSignInfoMsg = `DEBUG: Request Signiture: +---[ CANONICAL STRING ]----------------------------- +%s +---[ STRING TO SIGN ]-------------------------------- +%s%s +-----------------------------------------------------` +const logSignedURLMsg = ` +---[ SIGNED URL ]------------------------------------ +%s` + +func (v4 *signer) logSigningInfo() { + signedURLMsg := "" + if v4.isPresign { + signedURLMsg = fmt.Sprintf(logSignedURLMsg, v4.Request.URL.String()) + } + msg := fmt.Sprintf(logSignInfoMsg, v4.canonicalString, v4.stringToSign, signedURLMsg) + v4.Logger.Log(msg) +} + +func (v4 *signer) build() { + v4.buildTime() // no depends + v4.buildCredentialString() // no depends + if v4.isPresign { + v4.buildQuery() // no depends + } + v4.buildCanonicalHeaders() // depends on cred string + v4.buildCanonicalString() // depends on canon headers / signed headers + v4.buildStringToSign() // depends on canon string + v4.buildSignature() // depends on string to sign + + if v4.isPresign { + v4.Request.URL.RawQuery += "&X-Amz-Signature=" + v4.signature + } else { + parts := []string{ + authHeaderPrefix + " Credential=" + v4.CredValues.AccessKeyID + "/" + v4.credentialString, + "SignedHeaders=" + v4.signedHeaders, + "Signature=" + v4.signature, + } + v4.Request.Header.Set("Authorization", strings.Join(parts, ", ")) + } +} + +func (v4 *signer) buildTime() { + v4.formattedTime = v4.Time.UTC().Format(timeFormat) + v4.formattedShortTime = v4.Time.UTC().Format(shortTimeFormat) + + if v4.isPresign { + duration := int64(v4.ExpireTime / time.Second) + v4.Query.Set("X-Amz-Date", v4.formattedTime) + v4.Query.Set("X-Amz-Expires", strconv.FormatInt(duration, 10)) + } else { + v4.Request.Header.Set("X-Amz-Date", v4.formattedTime) + } +} + +func (v4 *signer) buildCredentialString() { + v4.credentialString = strings.Join([]string{ + v4.formattedShortTime, + v4.Region, + v4.ServiceName, + "aws4_request", + }, "/") + + if v4.isPresign { + v4.Query.Set("X-Amz-Credential", v4.CredValues.AccessKeyID+"/"+v4.credentialString) + } +} + +func (v4 *signer) buildQuery() { + for k, h := range v4.Request.Header { + if strings.HasPrefix(http.CanonicalHeaderKey(k), "X-Amz-") { + continue // never hoist x-amz-* headers, they must be signed + } + if _, ok := ignoredHeaders[http.CanonicalHeaderKey(k)]; ok { + continue // never hoist ignored headers + } + + v4.Request.Header.Del(k) + v4.Query.Del(k) + for _, v := range h { + v4.Query.Add(k, v) + } + } +} + +func (v4 *signer) buildCanonicalHeaders() { + var headers []string + headers = append(headers, "host") + for k := range v4.Request.Header { + if _, ok := ignoredHeaders[http.CanonicalHeaderKey(k)]; ok { + continue // ignored header + } + headers = append(headers, strings.ToLower(k)) + } + sort.Strings(headers) + + v4.signedHeaders = strings.Join(headers, ";") + + if v4.isPresign { + v4.Query.Set("X-Amz-SignedHeaders", v4.signedHeaders) + } + + headerValues := make([]string, len(headers)) + for i, k := range headers { + if k == "host" { + headerValues[i] = "host:" + v4.Request.URL.Host + } else { + headerValues[i] = k + ":" + + strings.Join(v4.Request.Header[http.CanonicalHeaderKey(k)], ",") + } + } + + v4.canonicalHeaders = strings.Join(headerValues, "\n") +} + +func (v4 *signer) buildCanonicalString() { + v4.Request.URL.RawQuery = strings.Replace(v4.Query.Encode(), "+", "%20", -1) + uri := v4.Request.URL.Opaque + if uri != "" { + uri = "/" + strings.Join(strings.Split(uri, "/")[3:], "/") + } else { + uri = v4.Request.URL.Path + } + if uri == "" { + uri = "/" + } + + if v4.ServiceName != "s3" { + uri = rest.EscapePath(uri, false) + } + + v4.canonicalString = strings.Join([]string{ + v4.Request.Method, + uri, + v4.Request.URL.RawQuery, + v4.canonicalHeaders + "\n", + v4.signedHeaders, + v4.bodyDigest(), + }, "\n") +} + +func (v4 *signer) buildStringToSign() { + v4.stringToSign = strings.Join([]string{ + authHeaderPrefix, + v4.formattedTime, + v4.credentialString, + hex.EncodeToString(makeSha256([]byte(v4.canonicalString))), + }, "\n") +} + +func (v4 *signer) buildSignature() { + secret := v4.CredValues.SecretAccessKey + date := makeHmac([]byte("AWS4"+secret), []byte(v4.formattedShortTime)) + region := makeHmac(date, []byte(v4.Region)) + service := makeHmac(region, []byte(v4.ServiceName)) + credentials := makeHmac(service, []byte("aws4_request")) + signature := makeHmac(credentials, []byte(v4.stringToSign)) + v4.signature = hex.EncodeToString(signature) +} + +func (v4 *signer) bodyDigest() string { + hash := v4.Request.Header.Get("X-Amz-Content-Sha256") + if hash == "" { + if v4.isPresign && v4.ServiceName == "s3" { + hash = "UNSIGNED-PAYLOAD" + } else if v4.Body == nil { + hash = hex.EncodeToString(makeSha256([]byte{})) + } else { + hash = hex.EncodeToString(makeSha256Reader(v4.Body)) + } + v4.Request.Header.Add("X-Amz-Content-Sha256", hash) + } + return hash +} + +// isRequestSigned returns if the request is currently signed or presigned +func (v4 *signer) isRequestSigned() bool { + if v4.isPresign && v4.Query.Get("X-Amz-Signature") != "" { + return true + } + if v4.Request.Header.Get("Authorization") != "" { + return true + } + + return false +} + +// unsign removes signing flags for both signed and presigned requests. +func (v4 *signer) removePresign() { + v4.Query.Del("X-Amz-Algorithm") + v4.Query.Del("X-Amz-Signature") + v4.Query.Del("X-Amz-Security-Token") + v4.Query.Del("X-Amz-Date") + v4.Query.Del("X-Amz-Expires") + v4.Query.Del("X-Amz-Credential") + v4.Query.Del("X-Amz-SignedHeaders") +} + +func makeHmac(key []byte, data []byte) []byte { + hash := hmac.New(sha256.New, key) + hash.Write(data) + return hash.Sum(nil) +} + +func makeSha256(data []byte) []byte { + hash := sha256.New() + hash.Write(data) + return hash.Sum(nil) +} + +func makeSha256Reader(reader io.ReadSeeker) []byte { + hash := sha256.New() + start, _ := reader.Seek(0, 1) + defer reader.Seek(start, 0) + + io.Copy(hash, reader) + return hash.Sum(nil) +} diff --git a/vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go b/vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go new file mode 100644 index 0000000000..f81506c9e1 --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go @@ -0,0 +1,2293 @@ +// THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT. + +// Package cloudwatchlogs provides a client for Amazon CloudWatch Logs. +package cloudwatchlogs + +import ( + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awsutil" +) + +const opCreateLogGroup = "CreateLogGroup" + +// CreateLogGroupRequest generates a request for the CreateLogGroup operation. +func (c *CloudWatchLogs) CreateLogGroupRequest(input *CreateLogGroupInput) (req *aws.Request, output *CreateLogGroupOutput) { + op := &aws.Operation{ + Name: opCreateLogGroup, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateLogGroupInput{} + } + + req = c.newRequest(op, input, output) + output = &CreateLogGroupOutput{} + req.Data = output + return +} + +// Creates a new log group with the specified name. The name of the log group +// must be unique within a region for an AWS account. You can create up to 500 +// log groups per account. +// +// You must use the following guidelines when naming a log group: Log group +// names can be between 1 and 512 characters long. Allowed characters are a-z, +// A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period). +func (c *CloudWatchLogs) CreateLogGroup(input *CreateLogGroupInput) (*CreateLogGroupOutput, error) { + req, out := c.CreateLogGroupRequest(input) + err := req.Send() + return out, err +} + +const opCreateLogStream = "CreateLogStream" + +// CreateLogStreamRequest generates a request for the CreateLogStream operation. +func (c *CloudWatchLogs) CreateLogStreamRequest(input *CreateLogStreamInput) (req *aws.Request, output *CreateLogStreamOutput) { + op := &aws.Operation{ + Name: opCreateLogStream, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateLogStreamInput{} + } + + req = c.newRequest(op, input, output) + output = &CreateLogStreamOutput{} + req.Data = output + return +} + +// Creates a new log stream in the specified log group. The name of the log +// stream must be unique within the log group. There is no limit on the number +// of log streams that can exist in a log group. +// +// You must use the following guidelines when naming a log stream: Log stream +// names can be between 1 and 512 characters long. The ':' colon character is +// not allowed. +func (c *CloudWatchLogs) CreateLogStream(input *CreateLogStreamInput) (*CreateLogStreamOutput, error) { + req, out := c.CreateLogStreamRequest(input) + err := req.Send() + return out, err +} + +const opDeleteDestination = "DeleteDestination" + +// DeleteDestinationRequest generates a request for the DeleteDestination operation. +func (c *CloudWatchLogs) DeleteDestinationRequest(input *DeleteDestinationInput) (req *aws.Request, output *DeleteDestinationOutput) { + op := &aws.Operation{ + Name: opDeleteDestination, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteDestinationInput{} + } + + req = c.newRequest(op, input, output) + output = &DeleteDestinationOutput{} + req.Data = output + return +} + +// Deletes the destination with the specified name and eventually disables all +// the subscription filters that publish to it. This will not delete the physical +// resource encapsulated by the destination. +func (c *CloudWatchLogs) DeleteDestination(input *DeleteDestinationInput) (*DeleteDestinationOutput, error) { + req, out := c.DeleteDestinationRequest(input) + err := req.Send() + return out, err +} + +const opDeleteLogGroup = "DeleteLogGroup" + +// DeleteLogGroupRequest generates a request for the DeleteLogGroup operation. +func (c *CloudWatchLogs) DeleteLogGroupRequest(input *DeleteLogGroupInput) (req *aws.Request, output *DeleteLogGroupOutput) { + op := &aws.Operation{ + Name: opDeleteLogGroup, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteLogGroupInput{} + } + + req = c.newRequest(op, input, output) + output = &DeleteLogGroupOutput{} + req.Data = output + return +} + +// Deletes the log group with the specified name and permanently deletes all +// the archived log events associated with it. +func (c *CloudWatchLogs) DeleteLogGroup(input *DeleteLogGroupInput) (*DeleteLogGroupOutput, error) { + req, out := c.DeleteLogGroupRequest(input) + err := req.Send() + return out, err +} + +const opDeleteLogStream = "DeleteLogStream" + +// DeleteLogStreamRequest generates a request for the DeleteLogStream operation. +func (c *CloudWatchLogs) DeleteLogStreamRequest(input *DeleteLogStreamInput) (req *aws.Request, output *DeleteLogStreamOutput) { + op := &aws.Operation{ + Name: opDeleteLogStream, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteLogStreamInput{} + } + + req = c.newRequest(op, input, output) + output = &DeleteLogStreamOutput{} + req.Data = output + return +} + +// Deletes a log stream and permanently deletes all the archived log events +// associated with it. +func (c *CloudWatchLogs) DeleteLogStream(input *DeleteLogStreamInput) (*DeleteLogStreamOutput, error) { + req, out := c.DeleteLogStreamRequest(input) + err := req.Send() + return out, err +} + +const opDeleteMetricFilter = "DeleteMetricFilter" + +// DeleteMetricFilterRequest generates a request for the DeleteMetricFilter operation. +func (c *CloudWatchLogs) DeleteMetricFilterRequest(input *DeleteMetricFilterInput) (req *aws.Request, output *DeleteMetricFilterOutput) { + op := &aws.Operation{ + Name: opDeleteMetricFilter, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteMetricFilterInput{} + } + + req = c.newRequest(op, input, output) + output = &DeleteMetricFilterOutput{} + req.Data = output + return +} + +// Deletes a metric filter associated with the specified log group. +func (c *CloudWatchLogs) DeleteMetricFilter(input *DeleteMetricFilterInput) (*DeleteMetricFilterOutput, error) { + req, out := c.DeleteMetricFilterRequest(input) + err := req.Send() + return out, err +} + +const opDeleteRetentionPolicy = "DeleteRetentionPolicy" + +// DeleteRetentionPolicyRequest generates a request for the DeleteRetentionPolicy operation. +func (c *CloudWatchLogs) DeleteRetentionPolicyRequest(input *DeleteRetentionPolicyInput) (req *aws.Request, output *DeleteRetentionPolicyOutput) { + op := &aws.Operation{ + Name: opDeleteRetentionPolicy, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteRetentionPolicyInput{} + } + + req = c.newRequest(op, input, output) + output = &DeleteRetentionPolicyOutput{} + req.Data = output + return +} + +// Deletes the retention policy of the specified log group. Log events would +// not expire if they belong to log groups without a retention policy. +func (c *CloudWatchLogs) DeleteRetentionPolicy(input *DeleteRetentionPolicyInput) (*DeleteRetentionPolicyOutput, error) { + req, out := c.DeleteRetentionPolicyRequest(input) + err := req.Send() + return out, err +} + +const opDeleteSubscriptionFilter = "DeleteSubscriptionFilter" + +// DeleteSubscriptionFilterRequest generates a request for the DeleteSubscriptionFilter operation. +func (c *CloudWatchLogs) DeleteSubscriptionFilterRequest(input *DeleteSubscriptionFilterInput) (req *aws.Request, output *DeleteSubscriptionFilterOutput) { + op := &aws.Operation{ + Name: opDeleteSubscriptionFilter, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteSubscriptionFilterInput{} + } + + req = c.newRequest(op, input, output) + output = &DeleteSubscriptionFilterOutput{} + req.Data = output + return +} + +// Deletes a subscription filter associated with the specified log group. +func (c *CloudWatchLogs) DeleteSubscriptionFilter(input *DeleteSubscriptionFilterInput) (*DeleteSubscriptionFilterOutput, error) { + req, out := c.DeleteSubscriptionFilterRequest(input) + err := req.Send() + return out, err +} + +const opDescribeDestinations = "DescribeDestinations" + +// DescribeDestinationsRequest generates a request for the DescribeDestinations operation. +func (c *CloudWatchLogs) DescribeDestinationsRequest(input *DescribeDestinationsInput) (req *aws.Request, output *DescribeDestinationsOutput) { + op := &aws.Operation{ + Name: opDescribeDestinations, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeDestinationsInput{} + } + + req = c.newRequest(op, input, output) + output = &DescribeDestinationsOutput{} + req.Data = output + return +} + +// Returns all the destinations that are associated with the AWS account making +// the request. The list returned in the response is ASCII-sorted by destination +// name. +// +// By default, this operation returns up to 50 destinations. If there are +// more destinations to list, the response would contain a nextToken value in +// the response body. You can also limit the number of destinations returned +// in the response by specifying the limit parameter in the request. +func (c *CloudWatchLogs) DescribeDestinations(input *DescribeDestinationsInput) (*DescribeDestinationsOutput, error) { + req, out := c.DescribeDestinationsRequest(input) + err := req.Send() + return out, err +} + +const opDescribeLogGroups = "DescribeLogGroups" + +// DescribeLogGroupsRequest generates a request for the DescribeLogGroups operation. +func (c *CloudWatchLogs) DescribeLogGroupsRequest(input *DescribeLogGroupsInput) (req *aws.Request, output *DescribeLogGroupsOutput) { + op := &aws.Operation{ + Name: opDescribeLogGroups, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &aws.Paginator{ + InputTokens: []string{"nextToken"}, + OutputTokens: []string{"nextToken"}, + LimitToken: "limit", + TruncationToken: "", + }, + } + + if input == nil { + input = &DescribeLogGroupsInput{} + } + + req = c.newRequest(op, input, output) + output = &DescribeLogGroupsOutput{} + req.Data = output + return +} + +// Returns all the log groups that are associated with the AWS account making +// the request. The list returned in the response is ASCII-sorted by log group +// name. +// +// By default, this operation returns up to 50 log groups. If there are more +// log groups to list, the response would contain a nextToken value in the response +// body. You can also limit the number of log groups returned in the response +// by specifying the limit parameter in the request. +func (c *CloudWatchLogs) DescribeLogGroups(input *DescribeLogGroupsInput) (*DescribeLogGroupsOutput, error) { + req, out := c.DescribeLogGroupsRequest(input) + err := req.Send() + return out, err +} + +func (c *CloudWatchLogs) DescribeLogGroupsPages(input *DescribeLogGroupsInput, fn func(p *DescribeLogGroupsOutput, lastPage bool) (shouldContinue bool)) error { + page, _ := c.DescribeLogGroupsRequest(input) + return page.EachPage(func(p interface{}, lastPage bool) bool { + return fn(p.(*DescribeLogGroupsOutput), lastPage) + }) +} + +const opDescribeLogStreams = "DescribeLogStreams" + +// DescribeLogStreamsRequest generates a request for the DescribeLogStreams operation. +func (c *CloudWatchLogs) DescribeLogStreamsRequest(input *DescribeLogStreamsInput) (req *aws.Request, output *DescribeLogStreamsOutput) { + op := &aws.Operation{ + Name: opDescribeLogStreams, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &aws.Paginator{ + InputTokens: []string{"nextToken"}, + OutputTokens: []string{"nextToken"}, + LimitToken: "limit", + TruncationToken: "", + }, + } + + if input == nil { + input = &DescribeLogStreamsInput{} + } + + req = c.newRequest(op, input, output) + output = &DescribeLogStreamsOutput{} + req.Data = output + return +} + +// Returns all the log streams that are associated with the specified log group. +// The list returned in the response is ASCII-sorted by log stream name. +// +// By default, this operation returns up to 50 log streams. If there are more +// log streams to list, the response would contain a nextToken value in the +// response body. You can also limit the number of log streams returned in the +// response by specifying the limit parameter in the request. This operation +// has a limit of five transactions per second, after which transactions are +// throttled. +func (c *CloudWatchLogs) DescribeLogStreams(input *DescribeLogStreamsInput) (*DescribeLogStreamsOutput, error) { + req, out := c.DescribeLogStreamsRequest(input) + err := req.Send() + return out, err +} + +func (c *CloudWatchLogs) DescribeLogStreamsPages(input *DescribeLogStreamsInput, fn func(p *DescribeLogStreamsOutput, lastPage bool) (shouldContinue bool)) error { + page, _ := c.DescribeLogStreamsRequest(input) + return page.EachPage(func(p interface{}, lastPage bool) bool { + return fn(p.(*DescribeLogStreamsOutput), lastPage) + }) +} + +const opDescribeMetricFilters = "DescribeMetricFilters" + +// DescribeMetricFiltersRequest generates a request for the DescribeMetricFilters operation. +func (c *CloudWatchLogs) DescribeMetricFiltersRequest(input *DescribeMetricFiltersInput) (req *aws.Request, output *DescribeMetricFiltersOutput) { + op := &aws.Operation{ + Name: opDescribeMetricFilters, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &aws.Paginator{ + InputTokens: []string{"nextToken"}, + OutputTokens: []string{"nextToken"}, + LimitToken: "limit", + TruncationToken: "", + }, + } + + if input == nil { + input = &DescribeMetricFiltersInput{} + } + + req = c.newRequest(op, input, output) + output = &DescribeMetricFiltersOutput{} + req.Data = output + return +} + +// Returns all the metrics filters associated with the specified log group. +// The list returned in the response is ASCII-sorted by filter name. +// +// By default, this operation returns up to 50 metric filters. If there are +// more metric filters to list, the response would contain a nextToken value +// in the response body. You can also limit the number of metric filters returned +// in the response by specifying the limit parameter in the request. +func (c *CloudWatchLogs) DescribeMetricFilters(input *DescribeMetricFiltersInput) (*DescribeMetricFiltersOutput, error) { + req, out := c.DescribeMetricFiltersRequest(input) + err := req.Send() + return out, err +} + +func (c *CloudWatchLogs) DescribeMetricFiltersPages(input *DescribeMetricFiltersInput, fn func(p *DescribeMetricFiltersOutput, lastPage bool) (shouldContinue bool)) error { + page, _ := c.DescribeMetricFiltersRequest(input) + return page.EachPage(func(p interface{}, lastPage bool) bool { + return fn(p.(*DescribeMetricFiltersOutput), lastPage) + }) +} + +const opDescribeSubscriptionFilters = "DescribeSubscriptionFilters" + +// DescribeSubscriptionFiltersRequest generates a request for the DescribeSubscriptionFilters operation. +func (c *CloudWatchLogs) DescribeSubscriptionFiltersRequest(input *DescribeSubscriptionFiltersInput) (req *aws.Request, output *DescribeSubscriptionFiltersOutput) { + op := &aws.Operation{ + Name: opDescribeSubscriptionFilters, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeSubscriptionFiltersInput{} + } + + req = c.newRequest(op, input, output) + output = &DescribeSubscriptionFiltersOutput{} + req.Data = output + return +} + +// Returns all the subscription filters associated with the specified log group. +// The list returned in the response is ASCII-sorted by filter name. +// +// By default, this operation returns up to 50 subscription filters. If there +// are more subscription filters to list, the response would contain a nextToken +// value in the response body. You can also limit the number of subscription +// filters returned in the response by specifying the limit parameter in the +// request. +func (c *CloudWatchLogs) DescribeSubscriptionFilters(input *DescribeSubscriptionFiltersInput) (*DescribeSubscriptionFiltersOutput, error) { + req, out := c.DescribeSubscriptionFiltersRequest(input) + err := req.Send() + return out, err +} + +const opFilterLogEvents = "FilterLogEvents" + +// FilterLogEventsRequest generates a request for the FilterLogEvents operation. +func (c *CloudWatchLogs) FilterLogEventsRequest(input *FilterLogEventsInput) (req *aws.Request, output *FilterLogEventsOutput) { + op := &aws.Operation{ + Name: opFilterLogEvents, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &FilterLogEventsInput{} + } + + req = c.newRequest(op, input, output) + output = &FilterLogEventsOutput{} + req.Data = output + return +} + +// Retrieves log events, optionally filtered by a filter pattern from the specified +// log group. You can provide an optional time range to filter the results on +// the event timestamp. You can limit the streams searched to an explicit list +// of logStreamNames. +// +// By default, this operation returns as much matching log events as can fit +// in a response size of 1MB, up to 10,000 log events, or all the events found +// within a time-bounded scan window. If the response includes a nextToken, +// then there is more data to search, and the search can be resumed with a new +// request providing the nextToken. The response will contain a list of searchedLogStreams +// that contains information about which streams were searched in the request +// and whether they have been searched completely or require further pagination. +// The limit parameter in the request. can be used to specify the maximum number +// of events to return in a page. +func (c *CloudWatchLogs) FilterLogEvents(input *FilterLogEventsInput) (*FilterLogEventsOutput, error) { + req, out := c.FilterLogEventsRequest(input) + err := req.Send() + return out, err +} + +const opGetLogEvents = "GetLogEvents" + +// GetLogEventsRequest generates a request for the GetLogEvents operation. +func (c *CloudWatchLogs) GetLogEventsRequest(input *GetLogEventsInput) (req *aws.Request, output *GetLogEventsOutput) { + op := &aws.Operation{ + Name: opGetLogEvents, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &aws.Paginator{ + InputTokens: []string{"nextToken"}, + OutputTokens: []string{"nextForwardToken"}, + LimitToken: "limit", + TruncationToken: "", + }, + } + + if input == nil { + input = &GetLogEventsInput{} + } + + req = c.newRequest(op, input, output) + output = &GetLogEventsOutput{} + req.Data = output + return +} + +// Retrieves log events from the specified log stream. You can provide an optional +// time range to filter the results on the event timestamp. +// +// By default, this operation returns as much log events as can fit in a response +// size of 1MB, up to 10,000 log events. The response will always include a +// nextForwardToken and a nextBackwardToken in the response body. You can use +// any of these tokens in subsequent GetLogEvents requests to paginate through +// events in either forward or backward direction. You can also limit the number +// of log events returned in the response by specifying the limit parameter +// in the request. +func (c *CloudWatchLogs) GetLogEvents(input *GetLogEventsInput) (*GetLogEventsOutput, error) { + req, out := c.GetLogEventsRequest(input) + err := req.Send() + return out, err +} + +func (c *CloudWatchLogs) GetLogEventsPages(input *GetLogEventsInput, fn func(p *GetLogEventsOutput, lastPage bool) (shouldContinue bool)) error { + page, _ := c.GetLogEventsRequest(input) + return page.EachPage(func(p interface{}, lastPage bool) bool { + return fn(p.(*GetLogEventsOutput), lastPage) + }) +} + +const opPutDestination = "PutDestination" + +// PutDestinationRequest generates a request for the PutDestination operation. +func (c *CloudWatchLogs) PutDestinationRequest(input *PutDestinationInput) (req *aws.Request, output *PutDestinationOutput) { + op := &aws.Operation{ + Name: opPutDestination, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutDestinationInput{} + } + + req = c.newRequest(op, input, output) + output = &PutDestinationOutput{} + req.Data = output + return +} + +// Creates or updates a Destination. A destination encapsulates a physical resource +// (such as a Kinesis stream) and allows you to subscribe to a real-time stream +// of log events of a different account, ingested through PutLogEvents requests. +// Currently, the only supported physical resource is a Amazon Kinesis stream +// belonging to the same account as the destination. +// +// A destination controls what is written to its Amazon Kinesis stream through +// an access policy. By default, PutDestination does not set any access policy +// with the destination, which means a cross-account user will not be able to +// call PutSubscriptionFilter against this destination. To enable that, the +// destination owner must call PutDestinationPolicy after PutDestination. +func (c *CloudWatchLogs) PutDestination(input *PutDestinationInput) (*PutDestinationOutput, error) { + req, out := c.PutDestinationRequest(input) + err := req.Send() + return out, err +} + +const opPutDestinationPolicy = "PutDestinationPolicy" + +// PutDestinationPolicyRequest generates a request for the PutDestinationPolicy operation. +func (c *CloudWatchLogs) PutDestinationPolicyRequest(input *PutDestinationPolicyInput) (req *aws.Request, output *PutDestinationPolicyOutput) { + op := &aws.Operation{ + Name: opPutDestinationPolicy, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutDestinationPolicyInput{} + } + + req = c.newRequest(op, input, output) + output = &PutDestinationPolicyOutput{} + req.Data = output + return +} + +// Creates or updates an access policy associated with an existing Destination. +// An access policy is an IAM policy document (http://docs.aws.amazon.com/IAM/latest/UserGuide/policies_overview.html) +// that is used to authorize claims to register a subscription filter against +// a given destination. +func (c *CloudWatchLogs) PutDestinationPolicy(input *PutDestinationPolicyInput) (*PutDestinationPolicyOutput, error) { + req, out := c.PutDestinationPolicyRequest(input) + err := req.Send() + return out, err +} + +const opPutLogEvents = "PutLogEvents" + +// PutLogEventsRequest generates a request for the PutLogEvents operation. +func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *aws.Request, output *PutLogEventsOutput) { + op := &aws.Operation{ + Name: opPutLogEvents, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutLogEventsInput{} + } + + req = c.newRequest(op, input, output) + output = &PutLogEventsOutput{} + req.Data = output + return +} + +// Uploads a batch of log events to the specified log stream. +// +// Every PutLogEvents request must include the sequenceToken obtained from +// the response of the previous request. An upload in a newly created log stream +// does not require a sequenceToken. +// +// The batch of events must satisfy the following constraints: The maximum +// batch size is 1,048,576 bytes, and this size is calculated as the sum of +// all event messages in UTF-8, plus 26 bytes for each log event. None of the +// log events in the batch can be more than 2 hours in the future. None of the +// log events in the batch can be older than 14 days or the retention period +// of the log group. The log events in the batch must be in chronological ordered +// by their timestamp. The maximum number of log events in a batch is 10,000. +func (c *CloudWatchLogs) PutLogEvents(input *PutLogEventsInput) (*PutLogEventsOutput, error) { + req, out := c.PutLogEventsRequest(input) + err := req.Send() + return out, err +} + +const opPutMetricFilter = "PutMetricFilter" + +// PutMetricFilterRequest generates a request for the PutMetricFilter operation. +func (c *CloudWatchLogs) PutMetricFilterRequest(input *PutMetricFilterInput) (req *aws.Request, output *PutMetricFilterOutput) { + op := &aws.Operation{ + Name: opPutMetricFilter, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutMetricFilterInput{} + } + + req = c.newRequest(op, input, output) + output = &PutMetricFilterOutput{} + req.Data = output + return +} + +// Creates or updates a metric filter and associates it with the specified log +// group. Metric filters allow you to configure rules to extract metric data +// from log events ingested through PutLogEvents requests. +// +// The maximum number of metric filters that can be associated with a log +// group is 100. +func (c *CloudWatchLogs) PutMetricFilter(input *PutMetricFilterInput) (*PutMetricFilterOutput, error) { + req, out := c.PutMetricFilterRequest(input) + err := req.Send() + return out, err +} + +const opPutRetentionPolicy = "PutRetentionPolicy" + +// PutRetentionPolicyRequest generates a request for the PutRetentionPolicy operation. +func (c *CloudWatchLogs) PutRetentionPolicyRequest(input *PutRetentionPolicyInput) (req *aws.Request, output *PutRetentionPolicyOutput) { + op := &aws.Operation{ + Name: opPutRetentionPolicy, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutRetentionPolicyInput{} + } + + req = c.newRequest(op, input, output) + output = &PutRetentionPolicyOutput{} + req.Data = output + return +} + +// Sets the retention of the specified log group. A retention policy allows +// you to configure the number of days you want to retain log events in the +// specified log group. +func (c *CloudWatchLogs) PutRetentionPolicy(input *PutRetentionPolicyInput) (*PutRetentionPolicyOutput, error) { + req, out := c.PutRetentionPolicyRequest(input) + err := req.Send() + return out, err +} + +const opPutSubscriptionFilter = "PutSubscriptionFilter" + +// PutSubscriptionFilterRequest generates a request for the PutSubscriptionFilter operation. +func (c *CloudWatchLogs) PutSubscriptionFilterRequest(input *PutSubscriptionFilterInput) (req *aws.Request, output *PutSubscriptionFilterOutput) { + op := &aws.Operation{ + Name: opPutSubscriptionFilter, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutSubscriptionFilterInput{} + } + + req = c.newRequest(op, input, output) + output = &PutSubscriptionFilterOutput{} + req.Data = output + return +} + +// Creates or updates a subscription filter and associates it with the specified +// log group. Subscription filters allow you to subscribe to a real-time stream +// of log events ingested through PutLogEvents requests and have them delivered +// to a specific destination. Currently, the supported destinations are: A +// Amazon Kinesis stream belonging to the same account as the subscription filter, +// for same-account delivery. A logical destination (used via an ARN of Destination) +// belonging to a different account, for cross-account delivery. +// +// Currently there can only be one subscription filter associated with a log +// group. +func (c *CloudWatchLogs) PutSubscriptionFilter(input *PutSubscriptionFilterInput) (*PutSubscriptionFilterOutput, error) { + req, out := c.PutSubscriptionFilterRequest(input) + err := req.Send() + return out, err +} + +const opTestMetricFilter = "TestMetricFilter" + +// TestMetricFilterRequest generates a request for the TestMetricFilter operation. +func (c *CloudWatchLogs) TestMetricFilterRequest(input *TestMetricFilterInput) (req *aws.Request, output *TestMetricFilterOutput) { + op := &aws.Operation{ + Name: opTestMetricFilter, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &TestMetricFilterInput{} + } + + req = c.newRequest(op, input, output) + output = &TestMetricFilterOutput{} + req.Data = output + return +} + +// Tests the filter pattern of a metric filter against a sample of log event +// messages. You can use this operation to validate the correctness of a metric +// filter pattern. +func (c *CloudWatchLogs) TestMetricFilter(input *TestMetricFilterInput) (*TestMetricFilterOutput, error) { + req, out := c.TestMetricFilterRequest(input) + err := req.Send() + return out, err +} + +type CreateLogGroupInput struct { + // The name of the log group to create. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + metadataCreateLogGroupInput `json:"-" xml:"-"` +} + +type metadataCreateLogGroupInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s CreateLogGroupInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateLogGroupInput) GoString() string { + return s.String() +} + +type CreateLogGroupOutput struct { + metadataCreateLogGroupOutput `json:"-" xml:"-"` +} + +type metadataCreateLogGroupOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s CreateLogGroupOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateLogGroupOutput) GoString() string { + return s.String() +} + +type CreateLogStreamInput struct { + // The name of the log group under which the log stream is to be created. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // The name of the log stream to create. + LogStreamName *string `locationName:"logStreamName" type:"string" required:"true"` + + metadataCreateLogStreamInput `json:"-" xml:"-"` +} + +type metadataCreateLogStreamInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s CreateLogStreamInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateLogStreamInput) GoString() string { + return s.String() +} + +type CreateLogStreamOutput struct { + metadataCreateLogStreamOutput `json:"-" xml:"-"` +} + +type metadataCreateLogStreamOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s CreateLogStreamOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateLogStreamOutput) GoString() string { + return s.String() +} + +type DeleteDestinationInput struct { + // The name of destination to delete. + DestinationName *string `locationName:"destinationName" type:"string" required:"true"` + + metadataDeleteDestinationInput `json:"-" xml:"-"` +} + +type metadataDeleteDestinationInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteDestinationInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteDestinationInput) GoString() string { + return s.String() +} + +type DeleteDestinationOutput struct { + metadataDeleteDestinationOutput `json:"-" xml:"-"` +} + +type metadataDeleteDestinationOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteDestinationOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteDestinationOutput) GoString() string { + return s.String() +} + +type DeleteLogGroupInput struct { + // The name of the log group to delete. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + metadataDeleteLogGroupInput `json:"-" xml:"-"` +} + +type metadataDeleteLogGroupInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteLogGroupInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteLogGroupInput) GoString() string { + return s.String() +} + +type DeleteLogGroupOutput struct { + metadataDeleteLogGroupOutput `json:"-" xml:"-"` +} + +type metadataDeleteLogGroupOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteLogGroupOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteLogGroupOutput) GoString() string { + return s.String() +} + +type DeleteLogStreamInput struct { + // The name of the log group under which the log stream to delete belongs. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // The name of the log stream to delete. + LogStreamName *string `locationName:"logStreamName" type:"string" required:"true"` + + metadataDeleteLogStreamInput `json:"-" xml:"-"` +} + +type metadataDeleteLogStreamInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteLogStreamInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteLogStreamInput) GoString() string { + return s.String() +} + +type DeleteLogStreamOutput struct { + metadataDeleteLogStreamOutput `json:"-" xml:"-"` +} + +type metadataDeleteLogStreamOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteLogStreamOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteLogStreamOutput) GoString() string { + return s.String() +} + +type DeleteMetricFilterInput struct { + // The name of the metric filter to delete. + FilterName *string `locationName:"filterName" type:"string" required:"true"` + + // The name of the log group that is associated with the metric filter to delete. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + metadataDeleteMetricFilterInput `json:"-" xml:"-"` +} + +type metadataDeleteMetricFilterInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteMetricFilterInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteMetricFilterInput) GoString() string { + return s.String() +} + +type DeleteMetricFilterOutput struct { + metadataDeleteMetricFilterOutput `json:"-" xml:"-"` +} + +type metadataDeleteMetricFilterOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteMetricFilterOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteMetricFilterOutput) GoString() string { + return s.String() +} + +type DeleteRetentionPolicyInput struct { + // The name of the log group that is associated with the retention policy to + // delete. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + metadataDeleteRetentionPolicyInput `json:"-" xml:"-"` +} + +type metadataDeleteRetentionPolicyInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteRetentionPolicyInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteRetentionPolicyInput) GoString() string { + return s.String() +} + +type DeleteRetentionPolicyOutput struct { + metadataDeleteRetentionPolicyOutput `json:"-" xml:"-"` +} + +type metadataDeleteRetentionPolicyOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteRetentionPolicyOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteRetentionPolicyOutput) GoString() string { + return s.String() +} + +type DeleteSubscriptionFilterInput struct { + // The name of the subscription filter to delete. + FilterName *string `locationName:"filterName" type:"string" required:"true"` + + // The name of the log group that is associated with the subscription filter + // to delete. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + metadataDeleteSubscriptionFilterInput `json:"-" xml:"-"` +} + +type metadataDeleteSubscriptionFilterInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteSubscriptionFilterInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteSubscriptionFilterInput) GoString() string { + return s.String() +} + +type DeleteSubscriptionFilterOutput struct { + metadataDeleteSubscriptionFilterOutput `json:"-" xml:"-"` +} + +type metadataDeleteSubscriptionFilterOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DeleteSubscriptionFilterOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteSubscriptionFilterOutput) GoString() string { + return s.String() +} + +type DescribeDestinationsInput struct { + // Will only return destinations that match the provided destinationNamePrefix. + // If you don't specify a value, no prefix is applied. + DestinationNamePrefix *string `type:"string"` + + // The maximum number of results to return. + Limit *int64 `locationName:"limit" type:"integer"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeDestinationsInput `json:"-" xml:"-"` +} + +type metadataDescribeDestinationsInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeDestinationsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeDestinationsInput) GoString() string { + return s.String() +} + +type DescribeDestinationsOutput struct { + Destinations []*Destination `locationName:"destinations" type:"list"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeDestinationsOutput `json:"-" xml:"-"` +} + +type metadataDescribeDestinationsOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeDestinationsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeDestinationsOutput) GoString() string { + return s.String() +} + +type DescribeLogGroupsInput struct { + // The maximum number of items returned in the response. If you don't specify + // a value, the request would return up to 50 items. + Limit *int64 `locationName:"limit" type:"integer"` + + // Will only return log groups that match the provided logGroupNamePrefix. If + // you don't specify a value, no prefix filter is applied. + LogGroupNamePrefix *string `locationName:"logGroupNamePrefix" type:"string"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous DescribeLogGroups + // request. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeLogGroupsInput `json:"-" xml:"-"` +} + +type metadataDescribeLogGroupsInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeLogGroupsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeLogGroupsInput) GoString() string { + return s.String() +} + +type DescribeLogGroupsOutput struct { + // A list of log groups. + LogGroups []*LogGroup `locationName:"logGroups" type:"list"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeLogGroupsOutput `json:"-" xml:"-"` +} + +type metadataDescribeLogGroupsOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeLogGroupsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeLogGroupsOutput) GoString() string { + return s.String() +} + +type DescribeLogStreamsInput struct { + // If set to true, results are returned in descending order. If you don't specify + // a value or set it to false, results are returned in ascending order. + Descending *bool `locationName:"descending" type:"boolean"` + + // The maximum number of items returned in the response. If you don't specify + // a value, the request would return up to 50 items. + Limit *int64 `locationName:"limit" type:"integer"` + + // The log group name for which log streams are to be listed. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // Will only return log streams that match the provided logStreamNamePrefix. + // If you don't specify a value, no prefix filter is applied. + LogStreamNamePrefix *string `locationName:"logStreamNamePrefix" type:"string"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous DescribeLogStreams + // request. + NextToken *string `locationName:"nextToken" type:"string"` + + // Specifies what to order the returned log streams by. Valid arguments are + // 'LogStreamName' or 'LastEventTime'. If you don't specify a value, results + // are ordered by LogStreamName. If 'LastEventTime' is chosen, the request cannot + // also contain a logStreamNamePrefix. + OrderBy *string `locationName:"orderBy" type:"string" enum:"OrderBy"` + + metadataDescribeLogStreamsInput `json:"-" xml:"-"` +} + +type metadataDescribeLogStreamsInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeLogStreamsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeLogStreamsInput) GoString() string { + return s.String() +} + +type DescribeLogStreamsOutput struct { + // A list of log streams. + LogStreams []*LogStream `locationName:"logStreams" type:"list"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeLogStreamsOutput `json:"-" xml:"-"` +} + +type metadataDescribeLogStreamsOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeLogStreamsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeLogStreamsOutput) GoString() string { + return s.String() +} + +type DescribeMetricFiltersInput struct { + // Will only return metric filters that match the provided filterNamePrefix. + // If you don't specify a value, no prefix filter is applied. + FilterNamePrefix *string `locationName:"filterNamePrefix" type:"string"` + + // The maximum number of items returned in the response. If you don't specify + // a value, the request would return up to 50 items. + Limit *int64 `locationName:"limit" type:"integer"` + + // The log group name for which metric filters are to be listed. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous DescribeMetricFilters + // request. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeMetricFiltersInput `json:"-" xml:"-"` +} + +type metadataDescribeMetricFiltersInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeMetricFiltersInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeMetricFiltersInput) GoString() string { + return s.String() +} + +type DescribeMetricFiltersOutput struct { + MetricFilters []*MetricFilter `locationName:"metricFilters" type:"list"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeMetricFiltersOutput `json:"-" xml:"-"` +} + +type metadataDescribeMetricFiltersOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeMetricFiltersOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeMetricFiltersOutput) GoString() string { + return s.String() +} + +type DescribeSubscriptionFiltersInput struct { + // Will only return subscription filters that match the provided filterNamePrefix. + // If you don't specify a value, no prefix filter is applied. + FilterNamePrefix *string `locationName:"filterNamePrefix" type:"string"` + + // The maximum number of results to return. + Limit *int64 `locationName:"limit" type:"integer"` + + // The log group name for which subscription filters are to be listed. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + metadataDescribeSubscriptionFiltersInput `json:"-" xml:"-"` +} + +type metadataDescribeSubscriptionFiltersInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeSubscriptionFiltersInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeSubscriptionFiltersInput) GoString() string { + return s.String() +} + +type DescribeSubscriptionFiltersOutput struct { + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextToken *string `locationName:"nextToken" type:"string"` + + SubscriptionFilters []*SubscriptionFilter `locationName:"subscriptionFilters" type:"list"` + + metadataDescribeSubscriptionFiltersOutput `json:"-" xml:"-"` +} + +type metadataDescribeSubscriptionFiltersOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s DescribeSubscriptionFiltersOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeSubscriptionFiltersOutput) GoString() string { + return s.String() +} + +type Destination struct { + ARN *string `locationName:"arn" type:"string"` + + AccessPolicy *string `locationName:"accessPolicy" type:"string"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + CreationTime *int64 `locationName:"creationTime" type:"long"` + + DestinationName *string `locationName:"destinationName" type:"string"` + + RoleARN *string `locationName:"roleArn" type:"string"` + + TargetARN *string `locationName:"targetArn" type:"string"` + + metadataDestination `json:"-" xml:"-"` +} + +type metadataDestination struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s Destination) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s Destination) GoString() string { + return s.String() +} + +type FilterLogEventsInput struct { + // A unix timestamp indicating the end time of the range for the request. If + // provided, events with a timestamp later than this time will not be returned. + EndTime *int64 `locationName:"endTime" type:"long"` + + // A valid CloudWatch Logs filter pattern to use for filtering the response. + // If not provided, all the events are matched. + FilterPattern *string `locationName:"filterPattern" type:"string"` + + // If provided, the API will make a best effort to provide responses that contain + // events from multiple log streams within the log group interleaved in a single + // response. If not provided, all the matched log events in the first log stream + // will be searched first, then those in the next log stream, etc. + Interleaved *bool `locationName:"interleaved" type:"boolean"` + + // The maximum number of events to return in a page of results. Default is 10,000 + // events. + Limit *int64 `locationName:"limit" type:"integer"` + + // The name of the log group to query. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // Optional list of log stream names within the specified log group to search. + // Defaults to all the log streams in the log group. + LogStreamNames []*string `locationName:"logStreamNames" type:"list"` + + // A pagination token obtained from a FilterLogEvents response to continue paginating + // the FilterLogEvents results. + NextToken *string `locationName:"nextToken" type:"string"` + + // A unix timestamp indicating the start time of the range for the request. + // If provided, events with a timestamp prior to this time will not be returned. + StartTime *int64 `locationName:"startTime" type:"long"` + + metadataFilterLogEventsInput `json:"-" xml:"-"` +} + +type metadataFilterLogEventsInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s FilterLogEventsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s FilterLogEventsInput) GoString() string { + return s.String() +} + +type FilterLogEventsOutput struct { + // A list of FilteredLogEvent objects representing the matched events from the + // request. + Events []*FilteredLogEvent `locationName:"events" type:"list"` + + // A pagination token obtained from a FilterLogEvents response to continue paginating + // the FilterLogEvents results. + NextToken *string `locationName:"nextToken" type:"string"` + + // A list of SearchedLogStream objects indicating which log streams have been + // searched in this request and whether each has been searched completely or + // still has more to be paginated. + SearchedLogStreams []*SearchedLogStream `locationName:"searchedLogStreams" type:"list"` + + metadataFilterLogEventsOutput `json:"-" xml:"-"` +} + +type metadataFilterLogEventsOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s FilterLogEventsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s FilterLogEventsOutput) GoString() string { + return s.String() +} + +// Represents a matched event from a FilterLogEvents request. +type FilteredLogEvent struct { + // A unique identifier for this event. + EventID *string `locationName:"eventId" type:"string"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + IngestionTime *int64 `locationName:"ingestionTime" type:"long"` + + // The name of the log stream this event belongs to. + LogStreamName *string `locationName:"logStreamName" type:"string"` + + // The data contained in the log event. + Message *string `locationName:"message" type:"string"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + Timestamp *int64 `locationName:"timestamp" type:"long"` + + metadataFilteredLogEvent `json:"-" xml:"-"` +} + +type metadataFilteredLogEvent struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s FilteredLogEvent) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s FilteredLogEvent) GoString() string { + return s.String() +} + +type GetLogEventsInput struct { + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + EndTime *int64 `locationName:"endTime" type:"long"` + + // The maximum number of log events returned in the response. If you don't specify + // a value, the request would return as many log events as can fit in a response + // size of 1MB, up to 10,000 log events. + Limit *int64 `locationName:"limit" type:"integer"` + + // The name of the log group to query. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // The name of the log stream to query. + LogStreamName *string `locationName:"logStreamName" type:"string" required:"true"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the nextForwardToken or nextBackwardToken + // fields in the response of the previous GetLogEvents request. + NextToken *string `locationName:"nextToken" type:"string"` + + // If set to true, the earliest log events would be returned first. The default + // is false (the latest log events are returned first). + StartFromHead *bool `locationName:"startFromHead" type:"boolean"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + StartTime *int64 `locationName:"startTime" type:"long"` + + metadataGetLogEventsInput `json:"-" xml:"-"` +} + +type metadataGetLogEventsInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s GetLogEventsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetLogEventsInput) GoString() string { + return s.String() +} + +type GetLogEventsOutput struct { + Events []*OutputLogEvent `locationName:"events" type:"list"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextBackwardToken *string `locationName:"nextBackwardToken" type:"string"` + + // A string token used for pagination that points to the next page of results. + // It must be a value obtained from the response of the previous request. The + // token expires after 24 hours. + NextForwardToken *string `locationName:"nextForwardToken" type:"string"` + + metadataGetLogEventsOutput `json:"-" xml:"-"` +} + +type metadataGetLogEventsOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s GetLogEventsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetLogEventsOutput) GoString() string { + return s.String() +} + +// A log event is a record of some activity that was recorded by the application +// or resource being monitored. The log event record that Amazon CloudWatch +// Logs understands contains two properties: the timestamp of when the event +// occurred, and the raw event message. +type InputLogEvent struct { + Message *string `locationName:"message" type:"string" required:"true"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + Timestamp *int64 `locationName:"timestamp" type:"long" required:"true"` + + metadataInputLogEvent `json:"-" xml:"-"` +} + +type metadataInputLogEvent struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s InputLogEvent) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s InputLogEvent) GoString() string { + return s.String() +} + +type LogGroup struct { + ARN *string `locationName:"arn" type:"string"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + CreationTime *int64 `locationName:"creationTime" type:"long"` + + LogGroupName *string `locationName:"logGroupName" type:"string"` + + // The number of metric filters associated with the log group. + MetricFilterCount *int64 `locationName:"metricFilterCount" type:"integer"` + + // Specifies the number of days you want to retain log events in the specified + // log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, + // 365, 400, 545, 731, 1827, 3653. + RetentionInDays *int64 `locationName:"retentionInDays" type:"integer"` + + StoredBytes *int64 `locationName:"storedBytes" type:"long"` + + metadataLogGroup `json:"-" xml:"-"` +} + +type metadataLogGroup struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s LogGroup) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s LogGroup) GoString() string { + return s.String() +} + +// A log stream is sequence of log events from a single emitter of logs. +type LogStream struct { + ARN *string `locationName:"arn" type:"string"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + CreationTime *int64 `locationName:"creationTime" type:"long"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + FirstEventTimestamp *int64 `locationName:"firstEventTimestamp" type:"long"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + LastEventTimestamp *int64 `locationName:"lastEventTimestamp" type:"long"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + LastIngestionTime *int64 `locationName:"lastIngestionTime" type:"long"` + + LogStreamName *string `locationName:"logStreamName" type:"string"` + + StoredBytes *int64 `locationName:"storedBytes" type:"long"` + + // A string token used for making PutLogEvents requests. A sequenceToken can + // only be used once, and PutLogEvents requests must include the sequenceToken + // obtained from the response of the previous request. + UploadSequenceToken *string `locationName:"uploadSequenceToken" type:"string"` + + metadataLogStream `json:"-" xml:"-"` +} + +type metadataLogStream struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s LogStream) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s LogStream) GoString() string { + return s.String() +} + +// Metric filters can be used to express how Amazon CloudWatch Logs would extract +// metric observations from ingested log events and transform them to metric +// data in a CloudWatch metric. +type MetricFilter struct { + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + CreationTime *int64 `locationName:"creationTime" type:"long"` + + // A name for a metric or subscription filter. + FilterName *string `locationName:"filterName" type:"string"` + + // A symbolic description of how Amazon CloudWatch Logs should interpret the + // data in each log event. For example, a log event may contain timestamps, + // IP addresses, strings, and so on. You use the filter pattern to specify what + // to look for in the log event message. + FilterPattern *string `locationName:"filterPattern" type:"string"` + + MetricTransformations []*MetricTransformation `locationName:"metricTransformations" type:"list"` + + metadataMetricFilter `json:"-" xml:"-"` +} + +type metadataMetricFilter struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s MetricFilter) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s MetricFilter) GoString() string { + return s.String() +} + +type MetricFilterMatchRecord struct { + EventMessage *string `locationName:"eventMessage" type:"string"` + + EventNumber *int64 `locationName:"eventNumber" type:"long"` + + ExtractedValues map[string]*string `locationName:"extractedValues" type:"map"` + + metadataMetricFilterMatchRecord `json:"-" xml:"-"` +} + +type metadataMetricFilterMatchRecord struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s MetricFilterMatchRecord) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s MetricFilterMatchRecord) GoString() string { + return s.String() +} + +type MetricTransformation struct { + // The name of the CloudWatch metric to which the monitored log information + // should be published. For example, you may publish to a metric called ErrorCount. + MetricName *string `locationName:"metricName" type:"string" required:"true"` + + // The destination namespace of the new CloudWatch metric. + MetricNamespace *string `locationName:"metricNamespace" type:"string" required:"true"` + + // What to publish to the metric. For example, if you're counting the occurrences + // of a particular term like "Error", the value will be "1" for each occurrence. + // If you're counting the bytes transferred the published value will be the + // value in the log event. + MetricValue *string `locationName:"metricValue" type:"string" required:"true"` + + metadataMetricTransformation `json:"-" xml:"-"` +} + +type metadataMetricTransformation struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s MetricTransformation) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s MetricTransformation) GoString() string { + return s.String() +} + +type OutputLogEvent struct { + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + IngestionTime *int64 `locationName:"ingestionTime" type:"long"` + + Message *string `locationName:"message" type:"string"` + + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + Timestamp *int64 `locationName:"timestamp" type:"long"` + + metadataOutputLogEvent `json:"-" xml:"-"` +} + +type metadataOutputLogEvent struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s OutputLogEvent) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s OutputLogEvent) GoString() string { + return s.String() +} + +type PutDestinationInput struct { + // A name for the destination. + DestinationName *string `locationName:"destinationName" type:"string" required:"true"` + + // The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to + // do Amazon Kinesis PutRecord requests on the desitnation stream. + RoleARN *string `locationName:"roleArn" type:"string" required:"true"` + + // The ARN of an Amazon Kinesis stream to deliver matching log events to. + TargetARN *string `locationName:"targetArn" type:"string" required:"true"` + + metadataPutDestinationInput `json:"-" xml:"-"` +} + +type metadataPutDestinationInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutDestinationInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutDestinationInput) GoString() string { + return s.String() +} + +type PutDestinationOutput struct { + Destination *Destination `locationName:"destination" type:"structure"` + + metadataPutDestinationOutput `json:"-" xml:"-"` +} + +type metadataPutDestinationOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutDestinationOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutDestinationOutput) GoString() string { + return s.String() +} + +type PutDestinationPolicyInput struct { + // An IAM policy document that authorizes cross-account users to deliver their + // log events to associated destination. + AccessPolicy *string `locationName:"accessPolicy" type:"string" required:"true"` + + // A name for an existing destination. + DestinationName *string `locationName:"destinationName" type:"string" required:"true"` + + metadataPutDestinationPolicyInput `json:"-" xml:"-"` +} + +type metadataPutDestinationPolicyInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutDestinationPolicyInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutDestinationPolicyInput) GoString() string { + return s.String() +} + +type PutDestinationPolicyOutput struct { + metadataPutDestinationPolicyOutput `json:"-" xml:"-"` +} + +type metadataPutDestinationPolicyOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutDestinationPolicyOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutDestinationPolicyOutput) GoString() string { + return s.String() +} + +type PutLogEventsInput struct { + // A list of log events belonging to a log stream. + LogEvents []*InputLogEvent `locationName:"logEvents" type:"list" required:"true"` + + // The name of the log group to put log events to. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // The name of the log stream to put log events to. + LogStreamName *string `locationName:"logStreamName" type:"string" required:"true"` + + // A string token that must be obtained from the response of the previous PutLogEvents + // request. + SequenceToken *string `locationName:"sequenceToken" type:"string"` + + metadataPutLogEventsInput `json:"-" xml:"-"` +} + +type metadataPutLogEventsInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutLogEventsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutLogEventsInput) GoString() string { + return s.String() +} + +type PutLogEventsOutput struct { + // A string token used for making PutLogEvents requests. A sequenceToken can + // only be used once, and PutLogEvents requests must include the sequenceToken + // obtained from the response of the previous request. + NextSequenceToken *string `locationName:"nextSequenceToken" type:"string"` + + RejectedLogEventsInfo *RejectedLogEventsInfo `locationName:"rejectedLogEventsInfo" type:"structure"` + + metadataPutLogEventsOutput `json:"-" xml:"-"` +} + +type metadataPutLogEventsOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutLogEventsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutLogEventsOutput) GoString() string { + return s.String() +} + +type PutMetricFilterInput struct { + // A name for the metric filter. + FilterName *string `locationName:"filterName" type:"string" required:"true"` + + // A valid CloudWatch Logs filter pattern for extracting metric data out of + // ingested log events. + FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"` + + // The name of the log group to associate the metric filter with. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // A collection of information needed to define how metric data gets emitted. + MetricTransformations []*MetricTransformation `locationName:"metricTransformations" type:"list" required:"true"` + + metadataPutMetricFilterInput `json:"-" xml:"-"` +} + +type metadataPutMetricFilterInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutMetricFilterInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutMetricFilterInput) GoString() string { + return s.String() +} + +type PutMetricFilterOutput struct { + metadataPutMetricFilterOutput `json:"-" xml:"-"` +} + +type metadataPutMetricFilterOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutMetricFilterOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutMetricFilterOutput) GoString() string { + return s.String() +} + +type PutRetentionPolicyInput struct { + // The name of the log group to associate the retention policy with. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // Specifies the number of days you want to retain log events in the specified + // log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, + // 365, 400, 545, 731, 1827, 3653. + RetentionInDays *int64 `locationName:"retentionInDays" type:"integer" required:"true"` + + metadataPutRetentionPolicyInput `json:"-" xml:"-"` +} + +type metadataPutRetentionPolicyInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutRetentionPolicyInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutRetentionPolicyInput) GoString() string { + return s.String() +} + +type PutRetentionPolicyOutput struct { + metadataPutRetentionPolicyOutput `json:"-" xml:"-"` +} + +type metadataPutRetentionPolicyOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutRetentionPolicyOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutRetentionPolicyOutput) GoString() string { + return s.String() +} + +type PutSubscriptionFilterInput struct { + // The ARN of the destination to deliver matching log events to. Currently, + // the supported destinations are: A Amazon Kinesis stream belonging to the + // same account as the subscription filter, for same-account delivery. A logical + // destination (used via an ARN of Destination) belonging to a different account, + // for cross-account delivery. + DestinationARN *string `locationName:"destinationArn" type:"string" required:"true"` + + // A name for the subscription filter. + FilterName *string `locationName:"filterName" type:"string" required:"true"` + + // A valid CloudWatch Logs filter pattern for subscribing to a filtered stream + // of log events. + FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"` + + // The name of the log group to associate the subscription filter with. + LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` + + // The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to + // deliver ingested log events to the destination stream. You don't need to + // provide the ARN when you are working with a logical destination (used via + // an ARN of Destination) for cross-account delivery. + RoleARN *string `locationName:"roleArn" type:"string"` + + metadataPutSubscriptionFilterInput `json:"-" xml:"-"` +} + +type metadataPutSubscriptionFilterInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutSubscriptionFilterInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutSubscriptionFilterInput) GoString() string { + return s.String() +} + +type PutSubscriptionFilterOutput struct { + metadataPutSubscriptionFilterOutput `json:"-" xml:"-"` +} + +type metadataPutSubscriptionFilterOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s PutSubscriptionFilterOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutSubscriptionFilterOutput) GoString() string { + return s.String() +} + +type RejectedLogEventsInfo struct { + ExpiredLogEventEndIndex *int64 `locationName:"expiredLogEventEndIndex" type:"integer"` + + TooNewLogEventStartIndex *int64 `locationName:"tooNewLogEventStartIndex" type:"integer"` + + TooOldLogEventEndIndex *int64 `locationName:"tooOldLogEventEndIndex" type:"integer"` + + metadataRejectedLogEventsInfo `json:"-" xml:"-"` +} + +type metadataRejectedLogEventsInfo struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s RejectedLogEventsInfo) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s RejectedLogEventsInfo) GoString() string { + return s.String() +} + +// An object indicating the search status of a log stream in a FilterLogEvents +// request. +type SearchedLogStream struct { + // The name of the log stream. + LogStreamName *string `locationName:"logStreamName" type:"string"` + + // Indicates whether all the events in this log stream were searched or more + // data exists to search by paginating further. + SearchedCompletely *bool `locationName:"searchedCompletely" type:"boolean"` + + metadataSearchedLogStream `json:"-" xml:"-"` +} + +type metadataSearchedLogStream struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s SearchedLogStream) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s SearchedLogStream) GoString() string { + return s.String() +} + +type SubscriptionFilter struct { + // A point in time expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. + CreationTime *int64 `locationName:"creationTime" type:"long"` + + DestinationARN *string `locationName:"destinationArn" type:"string"` + + // A name for a metric or subscription filter. + FilterName *string `locationName:"filterName" type:"string"` + + // A symbolic description of how Amazon CloudWatch Logs should interpret the + // data in each log event. For example, a log event may contain timestamps, + // IP addresses, strings, and so on. You use the filter pattern to specify what + // to look for in the log event message. + FilterPattern *string `locationName:"filterPattern" type:"string"` + + LogGroupName *string `locationName:"logGroupName" type:"string"` + + RoleARN *string `locationName:"roleArn" type:"string"` + + metadataSubscriptionFilter `json:"-" xml:"-"` +} + +type metadataSubscriptionFilter struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s SubscriptionFilter) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s SubscriptionFilter) GoString() string { + return s.String() +} + +type TestMetricFilterInput struct { + // A symbolic description of how Amazon CloudWatch Logs should interpret the + // data in each log event. For example, a log event may contain timestamps, + // IP addresses, strings, and so on. You use the filter pattern to specify what + // to look for in the log event message. + FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"` + + // A list of log event messages to test. + LogEventMessages []*string `locationName:"logEventMessages" type:"list" required:"true"` + + metadataTestMetricFilterInput `json:"-" xml:"-"` +} + +type metadataTestMetricFilterInput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s TestMetricFilterInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s TestMetricFilterInput) GoString() string { + return s.String() +} + +type TestMetricFilterOutput struct { + Matches []*MetricFilterMatchRecord `locationName:"matches" type:"list"` + + metadataTestMetricFilterOutput `json:"-" xml:"-"` +} + +type metadataTestMetricFilterOutput struct { + SDKShapeTraits bool `type:"structure"` +} + +// String returns the string representation +func (s TestMetricFilterOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s TestMetricFilterOutput) GoString() string { + return s.String() +} + +const ( + // @enum OrderBy + OrderByLogStreamName = "LogStreamName" + // @enum OrderBy + OrderByLastEventTime = "LastEventTime" +) diff --git a/vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go b/vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go new file mode 100644 index 0000000000..ef86db0d1b --- /dev/null +++ b/vendor/src/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go @@ -0,0 +1,90 @@ +// THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT. + +package cloudwatchlogs + +import ( + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/internal/protocol/jsonrpc" + "github.com/aws/aws-sdk-go/internal/signer/v4" +) + +// This is the Amazon CloudWatch Logs API Reference. Amazon CloudWatch Logs +// enables you to monitor, store, and access your system, application, and custom +// log files. This guide provides detailed information about Amazon CloudWatch +// Logs actions, data types, parameters, and errors. For detailed information +// about Amazon CloudWatch Logs features and their associated API calls, go +// to the Amazon CloudWatch Developer Guide (http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide). +// +// Use the following links to get started using the Amazon CloudWatch Logs +// API Reference: +// +// Actions (http://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Operations.html): +// An alphabetical list of all Amazon CloudWatch Logs actions. Data Types (http://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Types.html): +// An alphabetical list of all Amazon CloudWatch Logs data types. Common Parameters +// (http://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/CommonParameters.html): +// Parameters that all Query actions can use. Common Errors (http://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/CommonErrors.html): +// Client and server errors that all actions can return. Regions and Endpoints +// (http://docs.aws.amazon.com/general/latest/gr/index.html?rande.html): Itemized +// regions and endpoints for all AWS products. In addition to using the Amazon +// CloudWatch Logs API, you can also use the following SDKs and third-party +// libraries to access Amazon CloudWatch Logs programmatically. +// +// AWS SDK for Java Documentation (http://aws.amazon.com/documentation/sdkforjava/) +// AWS SDK for .NET Documentation (http://aws.amazon.com/documentation/sdkfornet/) +// AWS SDK for PHP Documentation (http://aws.amazon.com/documentation/sdkforphp/) +// AWS SDK for Ruby Documentation (http://aws.amazon.com/documentation/sdkforruby/) +// Developers in the AWS developer community also provide their own libraries, +// which you can find at the following AWS developer centers: +// +// AWS Java Developer Center (http://aws.amazon.com/java/) AWS PHP Developer +// Center (http://aws.amazon.com/php/) AWS Python Developer Center (http://aws.amazon.com/python/) +// AWS Ruby Developer Center (http://aws.amazon.com/ruby/) AWS Windows and .NET +// Developer Center (http://aws.amazon.com/net/) +type CloudWatchLogs struct { + *aws.Service +} + +// Used for custom service initialization logic +var initService func(*aws.Service) + +// Used for custom request initialization logic +var initRequest func(*aws.Request) + +// New returns a new CloudWatchLogs client. +func New(config *aws.Config) *CloudWatchLogs { + service := &aws.Service{ + Config: aws.DefaultConfig.Merge(config), + ServiceName: "logs", + APIVersion: "2014-03-28", + JSONVersion: "1.1", + TargetPrefix: "Logs_20140328", + } + service.Initialize() + + // Handlers + service.Handlers.Sign.PushBack(v4.Sign) + service.Handlers.Build.PushBack(jsonrpc.Build) + service.Handlers.Unmarshal.PushBack(jsonrpc.Unmarshal) + service.Handlers.UnmarshalMeta.PushBack(jsonrpc.UnmarshalMeta) + service.Handlers.UnmarshalError.PushBack(jsonrpc.UnmarshalError) + + // Run custom service initialization if present + if initService != nil { + initService(service) + } + + return &CloudWatchLogs{service} +} + +// newRequest creates a new request for a CloudWatchLogs operation and runs any +// custom request initialization. +func (c *CloudWatchLogs) newRequest(op *aws.Operation, params, data interface{}) *aws.Request { + req := aws.NewRequest(c.Service, op, params, data) + + // Run custom request initialization if present + if initRequest != nil { + initRequest(req) + } + + return req +} diff --git a/vendor/src/github.com/boltdb/bolt/.gitignore b/vendor/src/github.com/boltdb/bolt/.gitignore new file mode 100644 index 0000000000..b2bb382bd9 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/.gitignore @@ -0,0 +1,3 @@ +*.prof +*.test +/bin/ diff --git a/vendor/src/github.com/boltdb/bolt/LICENSE b/vendor/src/github.com/boltdb/bolt/LICENSE new file mode 100644 index 0000000000..004e77fe5d --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/LICENSE @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2013 Ben Johnson + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/vendor/src/github.com/boltdb/bolt/Makefile b/vendor/src/github.com/boltdb/bolt/Makefile new file mode 100644 index 0000000000..cfbed514bb --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/Makefile @@ -0,0 +1,54 @@ +TEST=. +BENCH=. +COVERPROFILE=/tmp/c.out +BRANCH=`git rev-parse --abbrev-ref HEAD` +COMMIT=`git rev-parse --short HEAD` +GOLDFLAGS="-X main.branch $(BRANCH) -X main.commit $(COMMIT)" + +default: build + +bench: + go test -v -test.run=NOTHINCONTAINSTHIS -test.bench=$(BENCH) + +# http://cloc.sourceforge.net/ +cloc: + @cloc --not-match-f='Makefile|_test.go' . + +cover: fmt + go test -coverprofile=$(COVERPROFILE) -test.run=$(TEST) $(COVERFLAG) . + go tool cover -html=$(COVERPROFILE) + rm $(COVERPROFILE) + +cpuprofile: fmt + @go test -c + @./bolt.test -test.v -test.run=$(TEST) -test.cpuprofile cpu.prof + +# go get github.com/kisielk/errcheck +errcheck: + @echo "=== errcheck ===" + @errcheck github.com/boltdb/bolt + +fmt: + @go fmt ./... + +get: + @go get -d ./... + +build: get + @mkdir -p bin + @go build -ldflags=$(GOLDFLAGS) -a -o bin/bolt ./cmd/bolt + +test: fmt + @go get github.com/stretchr/testify/assert + @echo "=== TESTS ===" + @go test -v -cover -test.run=$(TEST) + @echo "" + @echo "" + @echo "=== CLI ===" + @go test -v -test.run=$(TEST) ./cmd/bolt + @echo "" + @echo "" + @echo "=== RACE DETECTOR ===" + @go test -v -race -test.run="TestSimulate_(100op|1000op)" + +.PHONY: bench cloc cover cpuprofile fmt memprofile test diff --git a/vendor/src/github.com/boltdb/bolt/README.md b/vendor/src/github.com/boltdb/bolt/README.md new file mode 100644 index 0000000000..727e9774f3 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/README.md @@ -0,0 +1,455 @@ +Bolt [![Build Status](https://drone.io/github.com/boltdb/bolt/status.png)](https://drone.io/github.com/boltdb/bolt/latest) [![Coverage Status](https://coveralls.io/repos/boltdb/bolt/badge.png?branch=master)](https://coveralls.io/r/boltdb/bolt?branch=master) [![GoDoc](https://godoc.org/github.com/boltdb/bolt?status.png)](https://godoc.org/github.com/boltdb/bolt) ![Version](http://img.shields.io/badge/version-1.0-green.png) +==== + +Bolt is a pure Go key/value store inspired by [Howard Chu's][hyc_symas] and +the [LMDB project][lmdb]. The goal of the project is to provide a simple, +fast, and reliable database for projects that don't require a full database +server such as Postgres or MySQL. + +Since Bolt is meant to be used as such a low-level piece of functionality, +simplicity is key. The API will be small and only focus on getting values +and setting values. That's it. + +[hyc_symas]: https://twitter.com/hyc_symas +[lmdb]: http://symas.com/mdb/ + + +## Project Status + +Bolt is stable and the API is fixed. Full unit test coverage and randomized +black box testing are used to ensure database consistency and thread safety. +Bolt is currently in high-load production environments serving databases as +large as 1TB. Many companies such as Shopify and Heroku use Bolt-backed +services every day. + + +## Getting Started + +### Installing + +To start using Bolt, install Go and run `go get`: + +```sh +$ go get github.com/boltdb/bolt/... +``` + +This will retrieve the library and install the `bolt` command line utility into +your `$GOBIN` path. + + +### Opening a database + +The top-level object in Bolt is a `DB`. It is represented as a single file on +your disk and represents a consistent snapshot of your data. + +To open your database, simply use the `bolt.Open()` function: + +```go +package main + +import ( + "log" + + "github.com/boltdb/bolt" +) + +func main() { + // Open the my.db data file in your current directory. + // It will be created if it doesn't exist. + db, err := bolt.Open("my.db", 0600, nil) + if err != nil { + log.Fatal(err) + } + defer db.Close() + + ... +} +``` + +Please note that Bolt obtains a file lock on the data file so multiple processes +cannot open the same database at the same time. Opening an already open Bolt +database will cause it to hang until the other process closes it. To prevent +an indefinite wait you can pass a timeout option to the `Open()` function: + +```go +db, err := bolt.Open("my.db", 0600, &bolt.Options{Timeout: 1 * time.Second}) +``` + + +### Transactions + +Bolt allows only one read-write transaction at a time but allows as many +read-only transactions as you want at a time. Each transaction has a consistent +view of the data as it existed when the transaction started. + +Individual transactions and all objects created from them (e.g. buckets, keys) +are not thread safe. To work with data in multiple goroutines you must start +a transaction for each one or use locking to ensure only one goroutine accesses +a transaction at a time. Creating transaction from the `DB` is thread safe. + + +#### Read-write transactions + +To start a read-write transaction, you can use the `DB.Update()` function: + +```go +err := db.Update(func(tx *bolt.Tx) error { + ... + return nil +}) +``` + +Inside the closure, you have a consistent view of the database. You commit the +transaction by returning `nil` at the end. You can also rollback the transaction +at any point by returning an error. All database operations are allowed inside +a read-write transaction. + +Always check the return error as it will report any disk failures that can cause +your transaction to not complete. If you return an error within your closure +it will be passed through. + + +#### Read-only transactions + +To start a read-only transaction, you can use the `DB.View()` function: + +```go +err := db.View(func(tx *bolt.Tx) error { + ... + return nil +}) +``` + +You also get a consistent view of the database within this closure, however, +no mutating operations are allowed within a read-only transaction. You can only +retrieve buckets, retrieve values, and copy the database within a read-only +transaction. + + +### Using buckets + +Buckets are collections of key/value pairs within the database. All keys in a +bucket must be unique. You can create a bucket using the `DB.CreateBucket()` +function: + +```go +db.Update(func(tx *bolt.Tx) error { + b, err := tx.CreateBucket([]byte("MyBucket")) + if err != nil { + return fmt.Errorf("create bucket: %s", err) + } + return nil +}) +``` + +You can also create a bucket only if it doesn't exist by using the +`Tx.CreateBucketIfNotExists()` function. It's a common pattern to call this +function for all your top-level buckets after you open your database so you can +guarantee that they exist for future transactions. + +To delete a bucket, simply call the `Tx.DeleteBucket()` function. + + +### Using key/value pairs + +To save a key/value pair to a bucket, use the `Bucket.Put()` function: + +```go +db.Update(func(tx *bolt.Tx) error { + b := tx.Bucket([]byte("MyBucket")) + err := b.Put([]byte("answer"), []byte("42")) + return err +}) +``` + +This will set the value of the `"answer"` key to `"42"` in the `MyBucket` +bucket. To retrieve this value, we can use the `Bucket.Get()` function: + +```go +db.View(func(tx *bolt.Tx) error { + b := tx.Bucket([]byte("MyBucket")) + v := b.Get([]byte("answer")) + fmt.Printf("The answer is: %s\n", v) + return nil +}) +``` + +The `Get()` function does not return an error because its operation is +guarenteed to work (unless there is some kind of system failure). If the key +exists then it will return its byte slice value. If it doesn't exist then it +will return `nil`. It's important to note that you can have a zero-length value +set to a key which is different than the key not existing. + +Use the `Bucket.Delete()` function to delete a key from the bucket. + + +### Iterating over keys + +Bolt stores its keys in byte-sorted order within a bucket. This makes sequential +iteration over these keys extremely fast. To iterate over keys we'll use a +`Cursor`: + +```go +db.View(func(tx *bolt.Tx) error { + b := tx.Bucket([]byte("MyBucket")) + c := b.Cursor() + + for k, v := c.First(); k != nil; k, v = c.Next() { + fmt.Printf("key=%s, value=%s\n", k, v) + } + + return nil +}) +``` + +The cursor allows you to move to a specific point in the list of keys and move +forward or backward through the keys one at a time. + +The following functions are available on the cursor: + +``` +First() Move to the first key. +Last() Move to the last key. +Seek() Move to a specific key. +Next() Move to the next key. +Prev() Move to the previous key. +``` + +When you have iterated to the end of the cursor then `Next()` will return `nil`. +You must seek to a position using `First()`, `Last()`, or `Seek()` before +calling `Next()` or `Prev()`. If you do not seek to a position then these +functions will return `nil`. + + +#### Prefix scans + +To iterate over a key prefix, you can combine `Seek()` and `bytes.HasPrefix()`: + +```go +db.View(func(tx *bolt.Tx) error { + c := tx.Bucket([]byte("MyBucket")).Cursor() + + prefix := []byte("1234") + for k, v := c.Seek(prefix); bytes.HasPrefix(k, prefix); k, v = c.Next() { + fmt.Printf("key=%s, value=%s\n", k, v) + } + + return nil +}) +``` + +#### Range scans + +Another common use case is scanning over a range such as a time range. If you +use a sortable time encoding such as RFC3339 then you can query a specific +date range like this: + +```go +db.View(func(tx *bolt.Tx) error { + // Assume our events bucket has RFC3339 encoded time keys. + c := tx.Bucket([]byte("Events")).Cursor() + + // Our time range spans the 90's decade. + min := []byte("1990-01-01T00:00:00Z") + max := []byte("2000-01-01T00:00:00Z") + + // Iterate over the 90's. + for k, v := c.Seek(min); k != nil && bytes.Compare(k, max) != -1; k, v = c.Next() { + fmt.Printf("%s: %s\n", k, v) + } + + return nil +}) +``` + + +#### ForEach() + +You can also use the function `ForEach()` if you know you'll be iterating over +all the keys in a bucket: + +```go +db.View(func(tx *bolt.Tx) error { + b := tx.Bucket([]byte("MyBucket")) + b.ForEach(func(k, v []byte) error { + fmt.Printf("key=%s, value=%s\n", k, v) + return nil + }) + return nil +}) +``` + + +### Nested buckets + +You can also store a bucket in a key to create nested buckets. The API is the +same as the bucket management API on the `DB` object: + +```go +func (*Bucket) CreateBucket(key []byte) (*Bucket, error) +func (*Bucket) CreateBucketIfNotExists(key []byte) (*Bucket, error) +func (*Bucket) DeleteBucket(key []byte) error +``` + + +### Database backups + +Bolt is a single file so it's easy to backup. You can use the `Tx.Copy()` +function to write a consistent view of the database to a writer. If you call +this from a read-only transaction, it will perform a hot backup and not block +your other database reads and writes. It will also use `O_DIRECT` when available +to prevent page cache trashing. + +One common use case is to backup over HTTP so you can use tools like `cURL` to +do database backups: + +```go +func BackupHandleFunc(w http.ResponseWriter, req *http.Request) { + err := db.View(func(tx bolt.Tx) error { + w.Header().Set("Content-Type", "application/octet-stream") + w.Header().Set("Content-Disposition", `attachment; filename="my.db"`) + w.Header().Set("Content-Length", strconv.Itoa(int(tx.Size()))) + return tx.Copy(w) + }) + if err != nil { + http.Error(w, err.Error(), http.StatusInternalServerError) + } +} +``` + +Then you can backup using this command: + +```sh +$ curl http://localhost/backup > my.db +``` + +Or you can open your browser to `http://localhost/backup` and it will download +automatically. + +If you want to backup to another file you can use the `Tx.CopyFile()` helper +function. + + +### Statistics + +The database keeps a running count of many of the internal operations it +performs so you can better understand what's going on. By grabbing a snapshot +of these stats at two points in time we can see what operations were performed +in that time range. + +For example, we could start a goroutine to log stats every 10 seconds: + +```go +go func() { + // Grab the initial stats. + prev := db.Stats() + + for { + // Wait for 10s. + time.Sleep(10 * time.Second) + + // Grab the current stats and diff them. + stats := db.Stats() + diff := stats.Sub(&prev) + + // Encode stats to JSON and print to STDERR. + json.NewEncoder(os.Stderr).Encode(diff) + + // Save stats for the next loop. + prev = stats + } +} +}() +``` + +It's also useful to pipe these stats to a service such as statsd for monitoring +or to provide an HTTP endpoint that will perform a fixed-length sample. + + +## Resources + +For more information on getting started with Bolt, check out the following articles: + +* [Intro to BoltDB: Painless Performant Persistence](http://npf.io/2014/07/intro-to-boltdb-painless-performant-persistence/) by [Nate Finch](https://github.com/natefinch). + + + +## Comparing Bolt to LMDB + +Bolt was originally a port of LMDB so it is architecturally similar. Both use +a B+tree, have ACID semanetics with fully serializable transactions, and support +lock-free MVCC using a single writer and multiple readers. + +The two projects have somewhat diverged. LMDB heavily focuses on raw performance +while Bolt has focused on simplicity and ease of use. For example, LMDB allows +several unsafe actions such as direct writes and append writes for the sake of +performance. Bolt opts to disallow actions which can leave the database in a +corrupted state. The only exception to this in Bolt is `DB.NoSync`. + + +## Caveats & Limitations + +It's important to pick the right tool for the job and Bolt is no exception. +Here are a few things to note when evaluating and using Bolt: + +* Bolt is good for read intensive workloads. Sequential write performance is + also fast but random writes can be slow. You can add a write-ahead log or + [transaction coalescer](https://github.com/boltdb/coalescer) in front of Bolt + to mitigate this issue. + +* Bolt uses a B+tree internally so there can be a lot of random page access. + SSDs provide a significant performance boost over spinning disks. + +* Try to avoid long running read transactions. Bolt uses copy-on-write so + old pages cannot be reclaimed while an old transaction is using them. + +* Byte slices returned from Bolt are only valid during a transaction. Once the + transaction has been committed or rolled back then the memory they point to + can be reused by a new page or can be unmapped from virtual memory and you'll + see an `unexpected fault address` panic when accessing it. + +* Be careful when using `Bucket.FillPercent`. Setting a high fill percent for + buckets that have random inserts will cause your database to have very poor + page utilization. + +* Use larger buckets in general. Smaller buckets causes poor page utilization + once they become larger than the page size (typically 4KB). + +* Bulk loading a lot of random writes into a new bucket can be slow as the + page will not split until the transaction is committed. Randomly inserting + more than 100,000 key/value pairs into a single new bucket in a single + transaction is not advised. + +* Bolt uses a memory-mapped file so the underlying operating system handles the + caching of the data. Typically, the OS will cache as much of the file as it + can in memory and will release memory as needed to other processes. This means + that Bolt can show very high memory usage when working with large databases. + However, this is expected and the OS will release memory as needed. Bolt can + handle databases much larger than the available physical RAM. + + +## Other Projects Using Bolt + +Below is a list of public, open source projects that use Bolt: + +* [Bazil](https://github.com/bazillion/bazil) - A file system that lets your data reside where it is most convenient for it to reside. +* [DVID](https://github.com/janelia-flyem/dvid) - Added Bolt as optional storage engine and testing it against Basho-tuned leveldb. +* [Skybox Analytics](https://github.com/skybox/skybox) - A standalone funnel analysis tool for web analytics. +* [Scuttlebutt](https://github.com/benbjohnson/scuttlebutt) - Uses Bolt to store and process all Twitter mentions of GitHub projects. +* [Wiki](https://github.com/peterhellberg/wiki) - A tiny wiki using Goji, BoltDB and Blackfriday. +* [ChainStore](https://github.com/nulayer/chainstore) - Simple key-value interface to a variety of storage engines organized as a chain of operations. +* [MetricBase](https://github.com/msiebuhr/MetricBase) - Single-binary version of Graphite. +* [Gitchain](https://github.com/gitchain/gitchain) - Decentralized, peer-to-peer Git repositories aka "Git meets Bitcoin". +* [event-shuttle](https://github.com/sclasen/event-shuttle) - A Unix system service to collect and reliably deliver messages to Kafka. +* [ipxed](https://github.com/kelseyhightower/ipxed) - Web interface and api for ipxed. +* [BoltStore](https://github.com/yosssi/boltstore) - Session store using Bolt. +* [photosite/session](http://godoc.org/bitbucket.org/kardianos/photosite/session) - Sessions for a photo viewing site. +* [LedisDB](https://github.com/siddontang/ledisdb) - A high performance NoSQL, using Bolt as optional storage. +* [ipLocator](https://github.com/AndreasBriese/ipLocator) - A fast ip-geo-location-server using bolt with bloom filters. +* [cayley](https://github.com/google/cayley) - Cayley is an open-source graph database using Bolt as optional backend. +* [bleve](http://www.blevesearch.com/) - A pure Go search engine similar to ElasticSearch that uses Bolt as the default storage backend. +* [tentacool](https://github.com/optiflows/tentacool) - REST api server to manage system stuff (IP, DNS, Gateway...) on a linux server. +* [SkyDB](https://github.com/skydb/sky) - Behavioral analytics database. + +If you are using Bolt in a project please send a pull request to add it to the list. + diff --git a/vendor/src/github.com/boltdb/bolt/bolt_386.go b/vendor/src/github.com/boltdb/bolt/bolt_386.go new file mode 100644 index 0000000000..856f40119f --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_386.go @@ -0,0 +1,4 @@ +package bolt + +// maxMapSize represents the largest mmap size supported by Bolt. +const maxMapSize = 0xFFFFFFF // 256MB diff --git a/vendor/src/github.com/boltdb/bolt/bolt_amd64.go b/vendor/src/github.com/boltdb/bolt/bolt_amd64.go new file mode 100644 index 0000000000..4262932ee2 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_amd64.go @@ -0,0 +1,4 @@ +package bolt + +// maxMapSize represents the largest mmap size supported by Bolt. +const maxMapSize = 0xFFFFFFFFFFFF // 256TB diff --git a/vendor/src/github.com/boltdb/bolt/bolt_arm.go b/vendor/src/github.com/boltdb/bolt/bolt_arm.go new file mode 100644 index 0000000000..856f40119f --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_arm.go @@ -0,0 +1,4 @@ +package bolt + +// maxMapSize represents the largest mmap size supported by Bolt. +const maxMapSize = 0xFFFFFFF // 256MB diff --git a/vendor/src/github.com/boltdb/bolt/bolt_linux.go b/vendor/src/github.com/boltdb/bolt/bolt_linux.go new file mode 100644 index 0000000000..e9d1c907b6 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_linux.go @@ -0,0 +1,12 @@ +package bolt + +import ( + "syscall" +) + +var odirect = syscall.O_DIRECT + +// fdatasync flushes written data to a file descriptor. +func fdatasync(db *DB) error { + return syscall.Fdatasync(int(db.file.Fd())) +} diff --git a/vendor/src/github.com/boltdb/bolt/bolt_openbsd.go b/vendor/src/github.com/boltdb/bolt/bolt_openbsd.go new file mode 100644 index 0000000000..7c1bef1a4f --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_openbsd.go @@ -0,0 +1,29 @@ +package bolt + +import ( + "syscall" + "unsafe" +) + +const ( + msAsync = 1 << iota // perform asynchronous writes + msSync // perform synchronous writes + msInvalidate // invalidate cached data +) + +var odirect int + +func msync(db *DB) error { + _, _, errno := syscall.Syscall(syscall.SYS_MSYNC, uintptr(unsafe.Pointer(db.data)), uintptr(db.datasz), msInvalidate) + if errno != 0 { + return errno + } + return nil +} + +func fdatasync(db *DB) error { + if db.data != nil { + return msync(db) + } + return db.file.Sync() +} diff --git a/vendor/src/github.com/boltdb/bolt/bolt_unix.go b/vendor/src/github.com/boltdb/bolt/bolt_unix.go new file mode 100644 index 0000000000..95647a7405 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_unix.go @@ -0,0 +1,69 @@ +// +build !windows,!plan9 + +package bolt + +import ( + "os" + "syscall" + "time" + "unsafe" +) + +// flock acquires an advisory lock on a file descriptor. +func flock(f *os.File, timeout time.Duration) error { + var t time.Time + for { + // If we're beyond our timeout then return an error. + // This can only occur after we've attempted a flock once. + if t.IsZero() { + t = time.Now() + } else if timeout > 0 && time.Since(t) > timeout { + return ErrTimeout + } + + // Otherwise attempt to obtain an exclusive lock. + err := syscall.Flock(int(f.Fd()), syscall.LOCK_EX|syscall.LOCK_NB) + if err == nil { + return nil + } else if err != syscall.EWOULDBLOCK { + return err + } + + // Wait for a bit and try again. + time.Sleep(50 * time.Millisecond) + } +} + +// funlock releases an advisory lock on a file descriptor. +func funlock(f *os.File) error { + return syscall.Flock(int(f.Fd()), syscall.LOCK_UN) +} + +// mmap memory maps a DB's data file. +func mmap(db *DB, sz int) error { + b, err := syscall.Mmap(int(db.file.Fd()), 0, sz, syscall.PROT_READ, syscall.MAP_SHARED) + if err != nil { + return err + } + + // Save the original byte slice and convert to a byte array pointer. + db.dataref = b + db.data = (*[maxMapSize]byte)(unsafe.Pointer(&b[0])) + db.datasz = sz + return nil +} + +// munmap unmaps a DB's data file from memory. +func munmap(db *DB) error { + // Ignore the unmap if we have no mapped data. + if db.dataref == nil { + return nil + } + + // Unmap using the original byte slice. + err := syscall.Munmap(db.dataref) + db.dataref = nil + db.data = nil + db.datasz = 0 + return err +} diff --git a/vendor/src/github.com/boltdb/bolt/bolt_windows.go b/vendor/src/github.com/boltdb/bolt/bolt_windows.go new file mode 100644 index 0000000000..c8539d40b5 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bolt_windows.go @@ -0,0 +1,74 @@ +package bolt + +import ( + "fmt" + "os" + "syscall" + "time" + "unsafe" +) + +var odirect int + +// fdatasync flushes written data to a file descriptor. +func fdatasync(db *DB) error { + return db.file.Sync() +} + +// flock acquires an advisory lock on a file descriptor. +func flock(f *os.File, _ time.Duration) error { + return nil +} + +// funlock releases an advisory lock on a file descriptor. +func funlock(f *os.File) error { + return nil +} + +// mmap memory maps a DB's data file. +// Based on: https://github.com/edsrzf/mmap-go +func mmap(db *DB, sz int) error { + // Truncate the database to the size of the mmap. + if err := db.file.Truncate(int64(sz)); err != nil { + return fmt.Errorf("truncate: %s", err) + } + + // Open a file mapping handle. + sizelo := uint32(sz >> 32) + sizehi := uint32(sz) & 0xffffffff + h, errno := syscall.CreateFileMapping(syscall.Handle(db.file.Fd()), nil, syscall.PAGE_READONLY, sizelo, sizehi, nil) + if h == 0 { + return os.NewSyscallError("CreateFileMapping", errno) + } + + // Create the memory map. + addr, errno := syscall.MapViewOfFile(h, syscall.FILE_MAP_READ, 0, 0, uintptr(sz)) + if addr == 0 { + return os.NewSyscallError("MapViewOfFile", errno) + } + + // Close mapping handle. + if err := syscall.CloseHandle(syscall.Handle(h)); err != nil { + return os.NewSyscallError("CloseHandle", err) + } + + // Convert to a byte array. + db.data = ((*[maxMapSize]byte)(unsafe.Pointer(addr))) + db.datasz = sz + + return nil +} + +// munmap unmaps a pointer from a file. +// Based on: https://github.com/edsrzf/mmap-go +func munmap(db *DB) error { + if db.data == nil { + return nil + } + + addr := (uintptr)(unsafe.Pointer(&db.data[0])) + if err := syscall.UnmapViewOfFile(addr); err != nil { + return os.NewSyscallError("UnmapViewOfFile", err) + } + return nil +} diff --git a/vendor/src/github.com/boltdb/bolt/boltsync_unix.go b/vendor/src/github.com/boltdb/bolt/boltsync_unix.go new file mode 100644 index 0000000000..8db89776fe --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/boltsync_unix.go @@ -0,0 +1,10 @@ +// +build !windows,!plan9,!linux,!openbsd + +package bolt + +var odirect int + +// fdatasync flushes written data to a file descriptor. +func fdatasync(db *DB) error { + return db.file.Sync() +} diff --git a/vendor/src/github.com/boltdb/bolt/bucket.go b/vendor/src/github.com/boltdb/bolt/bucket.go new file mode 100644 index 0000000000..2630800f40 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/bucket.go @@ -0,0 +1,728 @@ +package bolt + +import ( + "bytes" + "fmt" + "unsafe" +) + +const ( + // MaxKeySize is the maximum length of a key, in bytes. + MaxKeySize = 32768 + + // MaxValueSize is the maximum length of a value, in bytes. + MaxValueSize = 4294967295 +) + +const ( + maxUint = ^uint(0) + minUint = 0 + maxInt = int(^uint(0) >> 1) + minInt = -maxInt - 1 +) + +const bucketHeaderSize = int(unsafe.Sizeof(bucket{})) + +const ( + minFillPercent = 0.1 + maxFillPercent = 1.0 +) + +// DefaultFillPercent is the percentage that split pages are filled. +// This value can be changed by setting Bucket.FillPercent. +const DefaultFillPercent = 0.5 + +// Bucket represents a collection of key/value pairs inside the database. +type Bucket struct { + *bucket + tx *Tx // the associated transaction + buckets map[string]*Bucket // subbucket cache + page *page // inline page reference + rootNode *node // materialized node for the root page. + nodes map[pgid]*node // node cache + + // Sets the threshold for filling nodes when they split. By default, + // the bucket will fill to 50% but it can be useful to increase this + // amount if you know that your write workloads are mostly append-only. + // + // This is non-persisted across transactions so it must be set in every Tx. + FillPercent float64 +} + +// bucket represents the on-file representation of a bucket. +// This is stored as the "value" of a bucket key. If the bucket is small enough, +// then its root page can be stored inline in the "value", after the bucket +// header. In the case of inline buckets, the "root" will be 0. +type bucket struct { + root pgid // page id of the bucket's root-level page + sequence uint64 // monotonically incrementing, used by NextSequence() +} + +// newBucket returns a new bucket associated with a transaction. +func newBucket(tx *Tx) Bucket { + var b = Bucket{tx: tx, FillPercent: DefaultFillPercent} + if tx.writable { + b.buckets = make(map[string]*Bucket) + b.nodes = make(map[pgid]*node) + } + return b +} + +// Tx returns the tx of the bucket. +func (b *Bucket) Tx() *Tx { + return b.tx +} + +// Root returns the root of the bucket. +func (b *Bucket) Root() pgid { + return b.root +} + +// Writable returns whether the bucket is writable. +func (b *Bucket) Writable() bool { + return b.tx.writable +} + +// Cursor creates a cursor associated with the bucket. +// The cursor is only valid as long as the transaction is open. +// Do not use a cursor after the transaction is closed. +func (b *Bucket) Cursor() *Cursor { + // Update transaction statistics. + b.tx.stats.CursorCount++ + + // Allocate and return a cursor. + return &Cursor{ + bucket: b, + stack: make([]elemRef, 0), + } +} + +// Bucket retrieves a nested bucket by name. +// Returns nil if the bucket does not exist. +func (b *Bucket) Bucket(name []byte) *Bucket { + if b.buckets != nil { + if child := b.buckets[string(name)]; child != nil { + return child + } + } + + // Move cursor to key. + c := b.Cursor() + k, v, flags := c.seek(name) + + // Return nil if the key doesn't exist or it is not a bucket. + if !bytes.Equal(name, k) || (flags&bucketLeafFlag) == 0 { + return nil + } + + // Otherwise create a bucket and cache it. + var child = b.openBucket(v) + if b.buckets != nil { + b.buckets[string(name)] = child + } + + return child +} + +// Helper method that re-interprets a sub-bucket value +// from a parent into a Bucket +func (b *Bucket) openBucket(value []byte) *Bucket { + var child = newBucket(b.tx) + + // If this is a writable transaction then we need to copy the bucket entry. + // Read-only transactions can point directly at the mmap entry. + if b.tx.writable { + child.bucket = &bucket{} + *child.bucket = *(*bucket)(unsafe.Pointer(&value[0])) + } else { + child.bucket = (*bucket)(unsafe.Pointer(&value[0])) + } + + // Save a reference to the inline page if the bucket is inline. + if child.root == 0 { + child.page = (*page)(unsafe.Pointer(&value[bucketHeaderSize])) + } + + return &child +} + +// CreateBucket creates a new bucket at the given key and returns the new bucket. +// Returns an error if the key already exists, if the bucket name is blank, or if the bucket name is too long. +func (b *Bucket) CreateBucket(key []byte) (*Bucket, error) { + if b.tx.db == nil { + return nil, ErrTxClosed + } else if !b.tx.writable { + return nil, ErrTxNotWritable + } else if len(key) == 0 { + return nil, ErrBucketNameRequired + } + + // Move cursor to correct position. + c := b.Cursor() + k, _, flags := c.seek(key) + + // Return an error if there is an existing key. + if bytes.Equal(key, k) { + if (flags & bucketLeafFlag) != 0 { + return nil, ErrBucketExists + } else { + return nil, ErrIncompatibleValue + } + } + + // Create empty, inline bucket. + var bucket = Bucket{ + bucket: &bucket{}, + rootNode: &node{isLeaf: true}, + FillPercent: DefaultFillPercent, + } + var value = bucket.write() + + // Insert into node. + key = cloneBytes(key) + c.node().put(key, key, value, 0, bucketLeafFlag) + + // Since subbuckets are not allowed on inline buckets, we need to + // dereference the inline page, if it exists. This will cause the bucket + // to be treated as a regular, non-inline bucket for the rest of the tx. + b.page = nil + + return b.Bucket(key), nil +} + +// CreateBucketIfNotExists creates a new bucket if it doesn't already exist and returns a reference to it. +// Returns an error if the bucket name is blank, or if the bucket name is too long. +func (b *Bucket) CreateBucketIfNotExists(key []byte) (*Bucket, error) { + child, err := b.CreateBucket(key) + if err == ErrBucketExists { + return b.Bucket(key), nil + } else if err != nil { + return nil, err + } + return child, nil +} + +// DeleteBucket deletes a bucket at the given key. +// Returns an error if the bucket does not exists, or if the key represents a non-bucket value. +func (b *Bucket) DeleteBucket(key []byte) error { + if b.tx.db == nil { + return ErrTxClosed + } else if !b.Writable() { + return ErrTxNotWritable + } + + // Move cursor to correct position. + c := b.Cursor() + k, _, flags := c.seek(key) + + // Return an error if bucket doesn't exist or is not a bucket. + if !bytes.Equal(key, k) { + return ErrBucketNotFound + } else if (flags & bucketLeafFlag) == 0 { + return ErrIncompatibleValue + } + + // Recursively delete all child buckets. + child := b.Bucket(key) + err := child.ForEach(func(k, v []byte) error { + if v == nil { + if err := child.DeleteBucket(k); err != nil { + return fmt.Errorf("delete bucket: %s", err) + } + } + return nil + }) + if err != nil { + return err + } + + // Remove cached copy. + delete(b.buckets, string(key)) + + // Release all bucket pages to freelist. + child.nodes = nil + child.rootNode = nil + child.free() + + // Delete the node if we have a matching key. + c.node().del(key) + + return nil +} + +// Get retrieves the value for a key in the bucket. +// Returns a nil value if the key does not exist or if the key is a nested bucket. +func (b *Bucket) Get(key []byte) []byte { + k, v, flags := b.Cursor().seek(key) + + // Return nil if this is a bucket. + if (flags & bucketLeafFlag) != 0 { + return nil + } + + // If our target node isn't the same key as what's passed in then return nil. + if !bytes.Equal(key, k) { + return nil + } + return v +} + +// Put sets the value for a key in the bucket. +// If the key exist then its previous value will be overwritten. +// Returns an error if the bucket was created from a read-only transaction, if the key is blank, if the key is too large, or if the value is too large. +func (b *Bucket) Put(key []byte, value []byte) error { + if b.tx.db == nil { + return ErrTxClosed + } else if !b.Writable() { + return ErrTxNotWritable + } else if len(key) == 0 { + return ErrKeyRequired + } else if len(key) > MaxKeySize { + return ErrKeyTooLarge + } else if int64(len(value)) > MaxValueSize { + return ErrValueTooLarge + } + + // Move cursor to correct position. + c := b.Cursor() + k, _, flags := c.seek(key) + + // Return an error if there is an existing key with a bucket value. + if bytes.Equal(key, k) && (flags&bucketLeafFlag) != 0 { + return ErrIncompatibleValue + } + + // Insert into node. + key = cloneBytes(key) + c.node().put(key, key, value, 0, 0) + + return nil +} + +// Delete removes a key from the bucket. +// If the key does not exist then nothing is done and a nil error is returned. +// Returns an error if the bucket was created from a read-only transaction. +func (b *Bucket) Delete(key []byte) error { + if b.tx.db == nil { + return ErrTxClosed + } else if !b.Writable() { + return ErrTxNotWritable + } + + // Move cursor to correct position. + c := b.Cursor() + _, _, flags := c.seek(key) + + // Return an error if there is already existing bucket value. + if (flags & bucketLeafFlag) != 0 { + return ErrIncompatibleValue + } + + // Delete the node if we have a matching key. + c.node().del(key) + + return nil +} + +// NextSequence returns an autoincrementing integer for the bucket. +func (b *Bucket) NextSequence() (uint64, error) { + if b.tx.db == nil { + return 0, ErrTxClosed + } else if !b.Writable() { + return 0, ErrTxNotWritable + } + + // Increment and return the sequence. + b.bucket.sequence++ + return b.bucket.sequence, nil +} + +// ForEach executes a function for each key/value pair in a bucket. +// If the provided function returns an error then the iteration is stopped and +// the error is returned to the caller. +func (b *Bucket) ForEach(fn func(k, v []byte) error) error { + if b.tx.db == nil { + return ErrTxClosed + } + c := b.Cursor() + for k, v := c.First(); k != nil; k, v = c.Next() { + if err := fn(k, v); err != nil { + return err + } + } + return nil +} + +// Stat returns stats on a bucket. +func (b *Bucket) Stats() BucketStats { + var s, subStats BucketStats + pageSize := b.tx.db.pageSize + s.BucketN += 1 + if b.root == 0 { + s.InlineBucketN += 1 + } + b.forEachPage(func(p *page, depth int) { + if (p.flags & leafPageFlag) != 0 { + s.KeyN += int(p.count) + + // used totals the used bytes for the page + used := pageHeaderSize + + if p.count != 0 { + // If page has any elements, add all element headers. + used += leafPageElementSize * int(p.count-1) + + // Add all element key, value sizes. + // The computation takes advantage of the fact that the position + // of the last element's key/value equals to the total of the sizes + // of all previous elements' keys and values. + // It also includes the last element's header. + lastElement := p.leafPageElement(p.count - 1) + used += int(lastElement.pos + lastElement.ksize + lastElement.vsize) + } + + if b.root == 0 { + // For inlined bucket just update the inline stats + s.InlineBucketInuse += used + } else { + // For non-inlined bucket update all the leaf stats + s.LeafPageN++ + s.LeafInuse += used + s.LeafOverflowN += int(p.overflow) + + // Collect stats from sub-buckets. + // Do that by iterating over all element headers + // looking for the ones with the bucketLeafFlag. + for i := uint16(0); i < p.count; i++ { + e := p.leafPageElement(i) + if (e.flags & bucketLeafFlag) != 0 { + // For any bucket element, open the element value + // and recursively call Stats on the contained bucket. + subStats.Add(b.openBucket(e.value()).Stats()) + } + } + } + } else if (p.flags & branchPageFlag) != 0 { + s.BranchPageN++ + lastElement := p.branchPageElement(p.count - 1) + + // used totals the used bytes for the page + // Add header and all element headers. + used := pageHeaderSize + (branchPageElementSize * int(p.count-1)) + + // Add size of all keys and values. + // Again, use the fact that last element's position equals to + // the total of key, value sizes of all previous elements. + used += int(lastElement.pos + lastElement.ksize) + s.BranchInuse += used + s.BranchOverflowN += int(p.overflow) + } + + // Keep track of maximum page depth. + if depth+1 > s.Depth { + s.Depth = (depth + 1) + } + }) + + // Alloc stats can be computed from page counts and pageSize. + s.BranchAlloc = (s.BranchPageN + s.BranchOverflowN) * pageSize + s.LeafAlloc = (s.LeafPageN + s.LeafOverflowN) * pageSize + + // Add the max depth of sub-buckets to get total nested depth. + s.Depth += subStats.Depth + // Add the stats for all sub-buckets + s.Add(subStats) + return s +} + +// forEachPage iterates over every page in a bucket, including inline pages. +func (b *Bucket) forEachPage(fn func(*page, int)) { + // If we have an inline page then just use that. + if b.page != nil { + fn(b.page, 0) + return + } + + // Otherwise traverse the page hierarchy. + b.tx.forEachPage(b.root, 0, fn) +} + +// forEachPageNode iterates over every page (or node) in a bucket. +// This also includes inline pages. +func (b *Bucket) forEachPageNode(fn func(*page, *node, int)) { + // If we have an inline page or root node then just use that. + if b.page != nil { + fn(b.page, nil, 0) + return + } + b._forEachPageNode(b.root, 0, fn) +} + +func (b *Bucket) _forEachPageNode(pgid pgid, depth int, fn func(*page, *node, int)) { + var p, n = b.pageNode(pgid) + + // Execute function. + fn(p, n, depth) + + // Recursively loop over children. + if p != nil { + if (p.flags & branchPageFlag) != 0 { + for i := 0; i < int(p.count); i++ { + elem := p.branchPageElement(uint16(i)) + b._forEachPageNode(elem.pgid, depth+1, fn) + } + } + } else { + if !n.isLeaf { + for _, inode := range n.inodes { + b._forEachPageNode(inode.pgid, depth+1, fn) + } + } + } +} + +// spill writes all the nodes for this bucket to dirty pages. +func (b *Bucket) spill() error { + // Spill all child buckets first. + for name, child := range b.buckets { + // If the child bucket is small enough and it has no child buckets then + // write it inline into the parent bucket's page. Otherwise spill it + // like a normal bucket and make the parent value a pointer to the page. + var value []byte + if child.inlineable() { + child.free() + value = child.write() + } else { + if err := child.spill(); err != nil { + return err + } + + // Update the child bucket header in this bucket. + value = make([]byte, unsafe.Sizeof(bucket{})) + var bucket = (*bucket)(unsafe.Pointer(&value[0])) + *bucket = *child.bucket + } + + // Skip writing the bucket if there are no materialized nodes. + if child.rootNode == nil { + continue + } + + // Update parent node. + var c = b.Cursor() + k, _, flags := c.seek([]byte(name)) + _assert(bytes.Equal([]byte(name), k), "misplaced bucket header: %x -> %x", []byte(name), k) + _assert(flags&bucketLeafFlag != 0, "unexpected bucket header flag: %x", flags) + c.node().put([]byte(name), []byte(name), value, 0, bucketLeafFlag) + } + + // Ignore if there's not a materialized root node. + if b.rootNode == nil { + return nil + } + + // Spill nodes. + if err := b.rootNode.spill(); err != nil { + return err + } + b.rootNode = b.rootNode.root() + + // Update the root node for this bucket. + _assert(b.rootNode.pgid < b.tx.meta.pgid, "pgid (%d) above high water mark (%d)", b.rootNode.pgid, b.tx.meta.pgid) + b.root = b.rootNode.pgid + + return nil +} + +// inlineable returns true if a bucket is small enough to be written inline +// and if it contains no subbuckets. Otherwise returns false. +func (b *Bucket) inlineable() bool { + var n = b.rootNode + + // Bucket must only contain a single leaf node. + if n == nil || !n.isLeaf { + return false + } + + // Bucket is not inlineable if it contains subbuckets or if it goes beyond + // our threshold for inline bucket size. + var size = pageHeaderSize + for _, inode := range n.inodes { + size += leafPageElementSize + len(inode.key) + len(inode.value) + + if inode.flags&bucketLeafFlag != 0 { + return false + } else if size > b.maxInlineBucketSize() { + return false + } + } + + return true +} + +// Returns the maximum total size of a bucket to make it a candidate for inlining. +func (b *Bucket) maxInlineBucketSize() int { + return b.tx.db.pageSize / 4 +} + +// write allocates and writes a bucket to a byte slice. +func (b *Bucket) write() []byte { + // Allocate the appropriate size. + var n = b.rootNode + var value = make([]byte, bucketHeaderSize+n.size()) + + // Write a bucket header. + var bucket = (*bucket)(unsafe.Pointer(&value[0])) + *bucket = *b.bucket + + // Convert byte slice to a fake page and write the root node. + var p = (*page)(unsafe.Pointer(&value[bucketHeaderSize])) + n.write(p) + + return value +} + +// rebalance attempts to balance all nodes. +func (b *Bucket) rebalance() { + for _, n := range b.nodes { + n.rebalance() + } + for _, child := range b.buckets { + child.rebalance() + } +} + +// node creates a node from a page and associates it with a given parent. +func (b *Bucket) node(pgid pgid, parent *node) *node { + _assert(b.nodes != nil, "nodes map expected") + + // Retrieve node if it's already been created. + if n := b.nodes[pgid]; n != nil { + return n + } + + // Otherwise create a node and cache it. + n := &node{bucket: b, parent: parent} + if parent == nil { + b.rootNode = n + } else { + parent.children = append(parent.children, n) + } + + // Use the inline page if this is an inline bucket. + var p = b.page + if p == nil { + p = b.tx.page(pgid) + } + + // Read the page into the node and cache it. + n.read(p) + b.nodes[pgid] = n + + // Update statistics. + b.tx.stats.NodeCount++ + + return n +} + +// free recursively frees all pages in the bucket. +func (b *Bucket) free() { + if b.root == 0 { + return + } + + var tx = b.tx + b.forEachPageNode(func(p *page, n *node, _ int) { + if p != nil { + tx.db.freelist.free(tx.meta.txid, p) + } else { + n.free() + } + }) + b.root = 0 +} + +// dereference removes all references to the old mmap. +func (b *Bucket) dereference() { + if b.rootNode != nil { + b.rootNode.root().dereference() + } + + for _, child := range b.buckets { + child.dereference() + } +} + +// pageNode returns the in-memory node, if it exists. +// Otherwise returns the underlying page. +func (b *Bucket) pageNode(id pgid) (*page, *node) { + // Inline buckets have a fake page embedded in their value so treat them + // differently. We'll return the rootNode (if available) or the fake page. + if b.root == 0 { + _assert(id == 0, "inline bucket non-zero page access(2): %d != 0", id) + if b.rootNode != nil { + return nil, b.rootNode + } + return b.page, nil + } + + // Check the node cache for non-inline buckets. + if b.nodes != nil { + if n := b.nodes[id]; n != nil { + return nil, n + } + } + + // Finally lookup the page from the transaction if no node is materialized. + return b.tx.page(id), nil +} + +// BucketStats records statistics about resources used by a bucket. +type BucketStats struct { + // Page count statistics. + BranchPageN int // number of logical branch pages + BranchOverflowN int // number of physical branch overflow pages + LeafPageN int // number of logical leaf pages + LeafOverflowN int // number of physical leaf overflow pages + + // Tree statistics. + KeyN int // number of keys/value pairs + Depth int // number of levels in B+tree + + // Page size utilization. + BranchAlloc int // bytes allocated for physical branch pages + BranchInuse int // bytes actually used for branch data + LeafAlloc int // bytes allocated for physical leaf pages + LeafInuse int // bytes actually used for leaf data + + // Bucket statistics + BucketN int // total number of buckets including the top bucket + InlineBucketN int // total number on inlined buckets + InlineBucketInuse int // bytes used for inlined buckets (also accounted for in LeafInuse) +} + +func (s *BucketStats) Add(other BucketStats) { + s.BranchPageN += other.BranchPageN + s.BranchOverflowN += other.BranchOverflowN + s.LeafPageN += other.LeafPageN + s.LeafOverflowN += other.LeafOverflowN + s.KeyN += other.KeyN + if s.Depth < other.Depth { + s.Depth = other.Depth + } + s.BranchAlloc += other.BranchAlloc + s.BranchInuse += other.BranchInuse + s.LeafAlloc += other.LeafAlloc + s.LeafInuse += other.LeafInuse + + s.BucketN += other.BucketN + s.InlineBucketN += other.InlineBucketN + s.InlineBucketInuse += other.InlineBucketInuse +} + +// cloneBytes returns a copy of a given slice. +func cloneBytes(v []byte) []byte { + var clone = make([]byte, len(v)) + copy(clone, v) + return clone +} diff --git a/vendor/src/github.com/boltdb/bolt/cursor.go b/vendor/src/github.com/boltdb/bolt/cursor.go new file mode 100644 index 0000000000..3bfc2f1a75 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/cursor.go @@ -0,0 +1,376 @@ +package bolt + +import ( + "bytes" + "sort" +) + +// Cursor represents an iterator that can traverse over all key/value pairs in a bucket in sorted order. +// Cursors see nested buckets with value == nil. +// Cursors can be obtained from a transaction and are valid as long as the transaction is open. +// +// Changing data while traversing with a cursor may cause it to be invalidated +// and return unexpected keys and/or values. You must reposition your cursor +// after mutating data. +type Cursor struct { + bucket *Bucket + stack []elemRef +} + +// Bucket returns the bucket that this cursor was created from. +func (c *Cursor) Bucket() *Bucket { + return c.bucket +} + +// First moves the cursor to the first item in the bucket and returns its key and value. +// If the bucket is empty then a nil key and value are returned. +func (c *Cursor) First() (key []byte, value []byte) { + _assert(c.bucket.tx.db != nil, "tx closed") + c.stack = c.stack[:0] + p, n := c.bucket.pageNode(c.bucket.root) + c.stack = append(c.stack, elemRef{page: p, node: n, index: 0}) + c.first() + k, v, flags := c.keyValue() + if (flags & uint32(bucketLeafFlag)) != 0 { + return k, nil + } + return k, v + +} + +// Last moves the cursor to the last item in the bucket and returns its key and value. +// If the bucket is empty then a nil key and value are returned. +func (c *Cursor) Last() (key []byte, value []byte) { + _assert(c.bucket.tx.db != nil, "tx closed") + c.stack = c.stack[:0] + p, n := c.bucket.pageNode(c.bucket.root) + ref := elemRef{page: p, node: n} + ref.index = ref.count() - 1 + c.stack = append(c.stack, ref) + c.last() + k, v, flags := c.keyValue() + if (flags & uint32(bucketLeafFlag)) != 0 { + return k, nil + } + return k, v +} + +// Next moves the cursor to the next item in the bucket and returns its key and value. +// If the cursor is at the end of the bucket then a nil key and value are returned. +func (c *Cursor) Next() (key []byte, value []byte) { + _assert(c.bucket.tx.db != nil, "tx closed") + k, v, flags := c.next() + if (flags & uint32(bucketLeafFlag)) != 0 { + return k, nil + } + return k, v +} + +// Prev moves the cursor to the previous item in the bucket and returns its key and value. +// If the cursor is at the beginning of the bucket then a nil key and value are returned. +func (c *Cursor) Prev() (key []byte, value []byte) { + _assert(c.bucket.tx.db != nil, "tx closed") + + // Attempt to move back one element until we're successful. + // Move up the stack as we hit the beginning of each page in our stack. + for i := len(c.stack) - 1; i >= 0; i-- { + elem := &c.stack[i] + if elem.index > 0 { + elem.index-- + break + } + c.stack = c.stack[:i] + } + + // If we've hit the end then return nil. + if len(c.stack) == 0 { + return nil, nil + } + + // Move down the stack to find the last element of the last leaf under this branch. + c.last() + k, v, flags := c.keyValue() + if (flags & uint32(bucketLeafFlag)) != 0 { + return k, nil + } + return k, v +} + +// Seek moves the cursor to a given key and returns it. +// If the key does not exist then the next key is used. If no keys +// follow, a nil key is returned. +func (c *Cursor) Seek(seek []byte) (key []byte, value []byte) { + k, v, flags := c.seek(seek) + + // If we ended up after the last element of a page then move to the next one. + if ref := &c.stack[len(c.stack)-1]; ref.index >= ref.count() { + k, v, flags = c.next() + } + + if k == nil { + return nil, nil + } else if (flags & uint32(bucketLeafFlag)) != 0 { + return k, nil + } + return k, v +} + +// Delete removes the current key/value under the cursor from the bucket. +// Delete fails if current key/value is a bucket or if the transaction is not writable. +func (c *Cursor) Delete() error { + if c.bucket.tx.db == nil { + return ErrTxClosed + } else if !c.bucket.Writable() { + return ErrTxNotWritable + } + + key, _, flags := c.keyValue() + // Return an error if current value is a bucket. + if (flags & bucketLeafFlag) != 0 { + return ErrIncompatibleValue + } + c.node().del(key) + + return nil +} + +// seek moves the cursor to a given key and returns it. +// If the key does not exist then the next key is used. +func (c *Cursor) seek(seek []byte) (key []byte, value []byte, flags uint32) { + _assert(c.bucket.tx.db != nil, "tx closed") + + // Start from root page/node and traverse to correct page. + c.stack = c.stack[:0] + c.search(seek, c.bucket.root) + ref := &c.stack[len(c.stack)-1] + + // If the cursor is pointing to the end of page/node then return nil. + if ref.index >= ref.count() { + return nil, nil, 0 + } + + // If this is a bucket then return a nil value. + return c.keyValue() +} + +// first moves the cursor to the first leaf element under the last page in the stack. +func (c *Cursor) first() { + for { + // Exit when we hit a leaf page. + var ref = &c.stack[len(c.stack)-1] + if ref.isLeaf() { + break + } + + // Keep adding pages pointing to the first element to the stack. + var pgid pgid + if ref.node != nil { + pgid = ref.node.inodes[ref.index].pgid + } else { + pgid = ref.page.branchPageElement(uint16(ref.index)).pgid + } + p, n := c.bucket.pageNode(pgid) + c.stack = append(c.stack, elemRef{page: p, node: n, index: 0}) + } +} + +// last moves the cursor to the last leaf element under the last page in the stack. +func (c *Cursor) last() { + for { + // Exit when we hit a leaf page. + ref := &c.stack[len(c.stack)-1] + if ref.isLeaf() { + break + } + + // Keep adding pages pointing to the last element in the stack. + var pgid pgid + if ref.node != nil { + pgid = ref.node.inodes[ref.index].pgid + } else { + pgid = ref.page.branchPageElement(uint16(ref.index)).pgid + } + p, n := c.bucket.pageNode(pgid) + + var nextRef = elemRef{page: p, node: n} + nextRef.index = nextRef.count() - 1 + c.stack = append(c.stack, nextRef) + } +} + +// next moves to the next leaf element and returns the key and value. +// If the cursor is at the last leaf element then it stays there and returns nil. +func (c *Cursor) next() (key []byte, value []byte, flags uint32) { + // Attempt to move over one element until we're successful. + // Move up the stack as we hit the end of each page in our stack. + var i int + for i = len(c.stack) - 1; i >= 0; i-- { + elem := &c.stack[i] + if elem.index < elem.count()-1 { + elem.index++ + break + } + } + + // If we've hit the root page then stop and return. This will leave the + // cursor on the last element of the last page. + if i == -1 { + return nil, nil, 0 + } + + // Otherwise start from where we left off in the stack and find the + // first element of the first leaf page. + c.stack = c.stack[:i+1] + c.first() + return c.keyValue() +} + +// search recursively performs a binary search against a given page/node until it finds a given key. +func (c *Cursor) search(key []byte, pgid pgid) { + p, n := c.bucket.pageNode(pgid) + if p != nil { + _assert((p.flags&(branchPageFlag|leafPageFlag)) != 0, "invalid page type: %d: %x", p.id, p.flags) + } + e := elemRef{page: p, node: n} + c.stack = append(c.stack, e) + + // If we're on a leaf page/node then find the specific node. + if e.isLeaf() { + c.nsearch(key) + return + } + + if n != nil { + c.searchNode(key, n) + return + } + c.searchPage(key, p) +} + +func (c *Cursor) searchNode(key []byte, n *node) { + var exact bool + index := sort.Search(len(n.inodes), func(i int) bool { + // TODO(benbjohnson): Optimize this range search. It's a bit hacky right now. + // sort.Search() finds the lowest index where f() != -1 but we need the highest index. + ret := bytes.Compare(n.inodes[i].key, key) + if ret == 0 { + exact = true + } + return ret != -1 + }) + if !exact && index > 0 { + index-- + } + c.stack[len(c.stack)-1].index = index + + // Recursively search to the next page. + c.search(key, n.inodes[index].pgid) +} + +func (c *Cursor) searchPage(key []byte, p *page) { + // Binary search for the correct range. + inodes := p.branchPageElements() + + var exact bool + index := sort.Search(int(p.count), func(i int) bool { + // TODO(benbjohnson): Optimize this range search. It's a bit hacky right now. + // sort.Search() finds the lowest index where f() != -1 but we need the highest index. + ret := bytes.Compare(inodes[i].key(), key) + if ret == 0 { + exact = true + } + return ret != -1 + }) + if !exact && index > 0 { + index-- + } + c.stack[len(c.stack)-1].index = index + + // Recursively search to the next page. + c.search(key, inodes[index].pgid) +} + +// nsearch searches the leaf node on the top of the stack for a key. +func (c *Cursor) nsearch(key []byte) { + e := &c.stack[len(c.stack)-1] + p, n := e.page, e.node + + // If we have a node then search its inodes. + if n != nil { + index := sort.Search(len(n.inodes), func(i int) bool { + return bytes.Compare(n.inodes[i].key, key) != -1 + }) + e.index = index + return + } + + // If we have a page then search its leaf elements. + inodes := p.leafPageElements() + index := sort.Search(int(p.count), func(i int) bool { + return bytes.Compare(inodes[i].key(), key) != -1 + }) + e.index = index +} + +// keyValue returns the key and value of the current leaf element. +func (c *Cursor) keyValue() ([]byte, []byte, uint32) { + ref := &c.stack[len(c.stack)-1] + if ref.count() == 0 || ref.index >= ref.count() { + return nil, nil, 0 + } + + // Retrieve value from node. + if ref.node != nil { + inode := &ref.node.inodes[ref.index] + return inode.key, inode.value, inode.flags + } + + // Or retrieve value from page. + elem := ref.page.leafPageElement(uint16(ref.index)) + return elem.key(), elem.value(), elem.flags +} + +// node returns the node that the cursor is currently positioned on. +func (c *Cursor) node() *node { + _assert(len(c.stack) > 0, "accessing a node with a zero-length cursor stack") + + // If the top of the stack is a leaf node then just return it. + if ref := &c.stack[len(c.stack)-1]; ref.node != nil && ref.isLeaf() { + return ref.node + } + + // Start from root and traverse down the hierarchy. + var n = c.stack[0].node + if n == nil { + n = c.bucket.node(c.stack[0].page.id, nil) + } + for _, ref := range c.stack[:len(c.stack)-1] { + _assert(!n.isLeaf, "expected branch node") + n = n.childAt(int(ref.index)) + } + _assert(n.isLeaf, "expected leaf node") + return n +} + +// elemRef represents a reference to an element on a given page/node. +type elemRef struct { + page *page + node *node + index int +} + +// isLeaf returns whether the ref is pointing at a leaf page/node. +func (r *elemRef) isLeaf() bool { + if r.node != nil { + return r.node.isLeaf + } + return (r.page.flags & leafPageFlag) != 0 +} + +// count returns the number of inodes or page elements. +func (r *elemRef) count() int { + if r.node != nil { + return len(r.node.inodes) + } + return int(r.page.count) +} diff --git a/vendor/src/github.com/boltdb/bolt/db.go b/vendor/src/github.com/boltdb/bolt/db.go new file mode 100644 index 0000000000..6c457362c7 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/db.go @@ -0,0 +1,689 @@ +package bolt + +import ( + "fmt" + "hash/fnv" + "os" + "runtime" + "runtime/debug" + "strings" + "sync" + "time" + "unsafe" +) + +// The smallest size that the mmap can be. +const minMmapSize = 1 << 22 // 4MB + +// The largest step that can be taken when remapping the mmap. +const maxMmapStep = 1 << 30 // 1GB + +// The data file format version. +const version = 2 + +// Represents a marker value to indicate that a file is a Bolt DB. +const magic uint32 = 0xED0CDAED + +// IgnoreNoSync specifies whether the NoSync field of a DB is ignored when +// syncing changes to a file. This is required as some operating systems, +// such as OpenBSD, do not have a unified buffer cache (UBC) and writes +// must be synchronzied using the msync(2) syscall. +const IgnoreNoSync = runtime.GOOS == "openbsd" + +// DB represents a collection of buckets persisted to a file on disk. +// All data access is performed through transactions which can be obtained through the DB. +// All the functions on DB will return a ErrDatabaseNotOpen if accessed before Open() is called. +type DB struct { + // When enabled, the database will perform a Check() after every commit. + // A panic is issued if the database is in an inconsistent state. This + // flag has a large performance impact so it should only be used for + // debugging purposes. + StrictMode bool + + // Setting the NoSync flag will cause the database to skip fsync() + // calls after each commit. This can be useful when bulk loading data + // into a database and you can restart the bulk load in the event of + // a system failure or database corruption. Do not set this flag for + // normal use. + // + // If the package global IgnoreNoSync constant is true, this value is + // ignored. See the comment on that constant for more details. + // + // THIS IS UNSAFE. PLEASE USE WITH CAUTION. + NoSync bool + + path string + file *os.File + dataref []byte + data *[maxMapSize]byte + datasz int + meta0 *meta + meta1 *meta + pageSize int + opened bool + rwtx *Tx + txs []*Tx + freelist *freelist + stats Stats + + rwlock sync.Mutex // Allows only one writer at a time. + metalock sync.Mutex // Protects meta page access. + mmaplock sync.RWMutex // Protects mmap access during remapping. + statlock sync.RWMutex // Protects stats access. + + ops struct { + writeAt func(b []byte, off int64) (n int, err error) + } +} + +// Path returns the path to currently open database file. +func (db *DB) Path() string { + return db.path +} + +// GoString returns the Go string representation of the database. +func (db *DB) GoString() string { + return fmt.Sprintf("bolt.DB{path:%q}", db.path) +} + +// String returns the string representation of the database. +func (db *DB) String() string { + return fmt.Sprintf("DB<%q>", db.path) +} + +// Open creates and opens a database at the given path. +// If the file does not exist then it will be created automatically. +// Passing in nil options will cause Bolt to open the database with the default options. +func Open(path string, mode os.FileMode, options *Options) (*DB, error) { + var db = &DB{opened: true} + + // Set default options if no options are provided. + if options == nil { + options = DefaultOptions + } + + // Open data file and separate sync handler for metadata writes. + db.path = path + + var err error + if db.file, err = os.OpenFile(db.path, os.O_RDWR|os.O_CREATE, mode); err != nil { + _ = db.close() + return nil, err + } + + // Lock file so that other processes using Bolt cannot use the database + // at the same time. This would cause corruption since the two processes + // would write meta pages and free pages separately. + if err := flock(db.file, options.Timeout); err != nil { + _ = db.close() + return nil, err + } + + // Default values for test hooks + db.ops.writeAt = db.file.WriteAt + + // Initialize the database if it doesn't exist. + if info, err := db.file.Stat(); err != nil { + return nil, fmt.Errorf("stat error: %s", err) + } else if info.Size() == 0 { + // Initialize new files with meta pages. + if err := db.init(); err != nil { + return nil, err + } + } else { + // Read the first meta page to determine the page size. + var buf [0x1000]byte + if _, err := db.file.ReadAt(buf[:], 0); err == nil { + m := db.pageInBuffer(buf[:], 0).meta() + if err := m.validate(); err != nil { + return nil, fmt.Errorf("meta0 error: %s", err) + } + db.pageSize = int(m.pageSize) + } + } + + // Memory map the data file. + if err := db.mmap(0); err != nil { + _ = db.close() + return nil, err + } + + // Read in the freelist. + db.freelist = newFreelist() + db.freelist.read(db.page(db.meta().freelist)) + + // Mark the database as opened and return. + return db, nil +} + +// mmap opens the underlying memory-mapped file and initializes the meta references. +// minsz is the minimum size that the new mmap can be. +func (db *DB) mmap(minsz int) error { + db.mmaplock.Lock() + defer db.mmaplock.Unlock() + + // Dereference all mmap references before unmapping. + if db.rwtx != nil { + db.rwtx.root.dereference() + } + + // Unmap existing data before continuing. + if err := db.munmap(); err != nil { + return err + } + + info, err := db.file.Stat() + if err != nil { + return fmt.Errorf("mmap stat error: %s", err) + } else if int(info.Size()) < db.pageSize*2 { + return fmt.Errorf("file size too small") + } + + // Ensure the size is at least the minimum size. + var size = int(info.Size()) + if size < minsz { + size = minsz + } + size = db.mmapSize(size) + + // Memory-map the data file as a byte slice. + if err := mmap(db, size); err != nil { + return err + } + + // Save references to the meta pages. + db.meta0 = db.page(0).meta() + db.meta1 = db.page(1).meta() + + // Validate the meta pages. + if err := db.meta0.validate(); err != nil { + return fmt.Errorf("meta0 error: %s", err) + } + if err := db.meta1.validate(); err != nil { + return fmt.Errorf("meta1 error: %s", err) + } + + return nil +} + +// munmap unmaps the data file from memory. +func (db *DB) munmap() error { + if err := munmap(db); err != nil { + return fmt.Errorf("unmap error: " + err.Error()) + } + return nil +} + +// mmapSize determines the appropriate size for the mmap given the current size +// of the database. The minimum size is 4MB and doubles until it reaches 1GB. +func (db *DB) mmapSize(size int) int { + if size <= minMmapSize { + return minMmapSize + } else if size < maxMmapStep { + size *= 2 + } else { + size += maxMmapStep + } + + // Ensure that the mmap size is a multiple of the page size. + if (size % db.pageSize) != 0 { + size = ((size / db.pageSize) + 1) * db.pageSize + } + + return size +} + +// init creates a new database file and initializes its meta pages. +func (db *DB) init() error { + // Set the page size to the OS page size. + db.pageSize = os.Getpagesize() + + // Create two meta pages on a buffer. + buf := make([]byte, db.pageSize*4) + for i := 0; i < 2; i++ { + p := db.pageInBuffer(buf[:], pgid(i)) + p.id = pgid(i) + p.flags = metaPageFlag + + // Initialize the meta page. + m := p.meta() + m.magic = magic + m.version = version + m.pageSize = uint32(db.pageSize) + m.version = version + m.freelist = 2 + m.root = bucket{root: 3} + m.pgid = 4 + m.txid = txid(i) + } + + // Write an empty freelist at page 3. + p := db.pageInBuffer(buf[:], pgid(2)) + p.id = pgid(2) + p.flags = freelistPageFlag + p.count = 0 + + // Write an empty leaf page at page 4. + p = db.pageInBuffer(buf[:], pgid(3)) + p.id = pgid(3) + p.flags = leafPageFlag + p.count = 0 + + // Write the buffer to our data file. + if _, err := db.ops.writeAt(buf, 0); err != nil { + return err + } + if err := fdatasync(db); err != nil { + return err + } + + return nil +} + +// Close releases all database resources. +// All transactions must be closed before closing the database. +func (db *DB) Close() error { + db.metalock.Lock() + defer db.metalock.Unlock() + return db.close() +} + +func (db *DB) close() error { + db.opened = false + + db.freelist = nil + db.path = "" + + // Clear ops. + db.ops.writeAt = nil + + // Close the mmap. + if err := db.munmap(); err != nil { + return err + } + + // Close file handles. + if db.file != nil { + // Unlock the file. + _ = funlock(db.file) + + // Close the file descriptor. + if err := db.file.Close(); err != nil { + return fmt.Errorf("db file close: %s", err) + } + db.file = nil + } + + return nil +} + +// Begin starts a new transaction. +// Multiple read-only transactions can be used concurrently but only one +// write transaction can be used at a time. Starting multiple write transactions +// will cause the calls to block and be serialized until the current write +// transaction finishes. +// +// IMPORTANT: You must close read-only transactions after you are finished or +// else the database will not reclaim old pages. +func (db *DB) Begin(writable bool) (*Tx, error) { + if writable { + return db.beginRWTx() + } + return db.beginTx() +} + +func (db *DB) beginTx() (*Tx, error) { + // Lock the meta pages while we initialize the transaction. We obtain + // the meta lock before the mmap lock because that's the order that the + // write transaction will obtain them. + db.metalock.Lock() + + // Obtain a read-only lock on the mmap. When the mmap is remapped it will + // obtain a write lock so all transactions must finish before it can be + // remapped. + db.mmaplock.RLock() + + // Exit if the database is not open yet. + if !db.opened { + db.mmaplock.RUnlock() + db.metalock.Unlock() + return nil, ErrDatabaseNotOpen + } + + // Create a transaction associated with the database. + t := &Tx{} + t.init(db) + + // Keep track of transaction until it closes. + db.txs = append(db.txs, t) + n := len(db.txs) + + // Unlock the meta pages. + db.metalock.Unlock() + + // Update the transaction stats. + db.statlock.Lock() + db.stats.TxN++ + db.stats.OpenTxN = n + db.statlock.Unlock() + + return t, nil +} + +func (db *DB) beginRWTx() (*Tx, error) { + // Obtain writer lock. This is released by the transaction when it closes. + // This enforces only one writer transaction at a time. + db.rwlock.Lock() + + // Once we have the writer lock then we can lock the meta pages so that + // we can set up the transaction. + db.metalock.Lock() + defer db.metalock.Unlock() + + // Exit if the database is not open yet. + if !db.opened { + db.rwlock.Unlock() + return nil, ErrDatabaseNotOpen + } + + // Create a transaction associated with the database. + t := &Tx{writable: true} + t.init(db) + db.rwtx = t + + // Free any pages associated with closed read-only transactions. + var minid txid = 0xFFFFFFFFFFFFFFFF + for _, t := range db.txs { + if t.meta.txid < minid { + minid = t.meta.txid + } + } + if minid > 0 { + db.freelist.release(minid - 1) + } + + return t, nil +} + +// removeTx removes a transaction from the database. +func (db *DB) removeTx(tx *Tx) { + // Release the read lock on the mmap. + db.mmaplock.RUnlock() + + // Use the meta lock to restrict access to the DB object. + db.metalock.Lock() + + // Remove the transaction. + for i, t := range db.txs { + if t == tx { + db.txs = append(db.txs[:i], db.txs[i+1:]...) + break + } + } + n := len(db.txs) + + // Unlock the meta pages. + db.metalock.Unlock() + + // Merge statistics. + db.statlock.Lock() + db.stats.OpenTxN = n + db.stats.TxStats.add(&tx.stats) + db.statlock.Unlock() +} + +// Update executes a function within the context of a read-write managed transaction. +// If no error is returned from the function then the transaction is committed. +// If an error is returned then the entire transaction is rolled back. +// Any error that is returned from the function or returned from the commit is +// returned from the Update() method. +// +// Attempting to manually commit or rollback within the function will cause a panic. +func (db *DB) Update(fn func(*Tx) error) error { + t, err := db.Begin(true) + if err != nil { + return err + } + + // Make sure the transaction rolls back in the event of a panic. + defer func() { + if t.db != nil { + t.rollback() + } + }() + + // Mark as a managed tx so that the inner function cannot manually commit. + t.managed = true + + // If an error is returned from the function then rollback and return error. + err = fn(t) + t.managed = false + if err != nil { + _ = t.Rollback() + return err + } + + return t.Commit() +} + +// View executes a function within the context of a managed read-only transaction. +// Any error that is returned from the function is returned from the View() method. +// +// Attempting to manually rollback within the function will cause a panic. +func (db *DB) View(fn func(*Tx) error) error { + t, err := db.Begin(false) + if err != nil { + return err + } + + // Make sure the transaction rolls back in the event of a panic. + defer func() { + if t.db != nil { + t.rollback() + } + }() + + // Mark as a managed tx so that the inner function cannot manually rollback. + t.managed = true + + // If an error is returned from the function then pass it through. + err = fn(t) + t.managed = false + if err != nil { + _ = t.Rollback() + return err + } + + if err := t.Rollback(); err != nil { + return err + } + + return nil +} + +// Stats retrieves ongoing performance stats for the database. +// This is only updated when a transaction closes. +func (db *DB) Stats() Stats { + db.statlock.RLock() + defer db.statlock.RUnlock() + return db.stats +} + +// This is for internal access to the raw data bytes from the C cursor, use +// carefully, or not at all. +func (db *DB) Info() *Info { + return &Info{uintptr(unsafe.Pointer(&db.data[0])), db.pageSize} +} + +// page retrieves a page reference from the mmap based on the current page size. +func (db *DB) page(id pgid) *page { + pos := id * pgid(db.pageSize) + return (*page)(unsafe.Pointer(&db.data[pos])) +} + +// pageInBuffer retrieves a page reference from a given byte array based on the current page size. +func (db *DB) pageInBuffer(b []byte, id pgid) *page { + return (*page)(unsafe.Pointer(&b[id*pgid(db.pageSize)])) +} + +// meta retrieves the current meta page reference. +func (db *DB) meta() *meta { + if db.meta0.txid > db.meta1.txid { + return db.meta0 + } + return db.meta1 +} + +// allocate returns a contiguous block of memory starting at a given page. +func (db *DB) allocate(count int) (*page, error) { + // Allocate a temporary buffer for the page. + buf := make([]byte, count*db.pageSize) + p := (*page)(unsafe.Pointer(&buf[0])) + p.overflow = uint32(count - 1) + + // Use pages from the freelist if they are available. + if p.id = db.freelist.allocate(count); p.id != 0 { + return p, nil + } + + // Resize mmap() if we're at the end. + p.id = db.rwtx.meta.pgid + var minsz = int((p.id+pgid(count))+1) * db.pageSize + if minsz >= db.datasz { + if err := db.mmap(minsz); err != nil { + return nil, fmt.Errorf("mmap allocate error: %s", err) + } + } + + // Move the page id high water mark. + db.rwtx.meta.pgid += pgid(count) + + return p, nil +} + +// Options represents the options that can be set when opening a database. +type Options struct { + // Timeout is the amount of time to wait to obtain a file lock. + // When set to zero it will wait indefinitely. This option is only + // available on Darwin and Linux. + Timeout time.Duration +} + +// DefaultOptions represent the options used if nil options are passed into Open(). +// No timeout is used which will cause Bolt to wait indefinitely for a lock. +var DefaultOptions = &Options{ + Timeout: 0, +} + +// Stats represents statistics about the database. +type Stats struct { + // Freelist stats + FreePageN int // total number of free pages on the freelist + PendingPageN int // total number of pending pages on the freelist + FreeAlloc int // total bytes allocated in free pages + FreelistInuse int // total bytes used by the freelist + + // Transaction stats + TxN int // total number of started read transactions + OpenTxN int // number of currently open read transactions + + TxStats TxStats // global, ongoing stats. +} + +// Sub calculates and returns the difference between two sets of database stats. +// This is useful when obtaining stats at two different points and time and +// you need the performance counters that occurred within that time span. +func (s *Stats) Sub(other *Stats) Stats { + if other == nil { + return *s + } + var diff Stats + diff.FreePageN = s.FreePageN + diff.PendingPageN = s.PendingPageN + diff.FreeAlloc = s.FreeAlloc + diff.FreelistInuse = s.FreelistInuse + diff.TxN = other.TxN - s.TxN + diff.TxStats = s.TxStats.Sub(&other.TxStats) + return diff +} + +func (s *Stats) add(other *Stats) { + s.TxStats.add(&other.TxStats) +} + +type Info struct { + Data uintptr + PageSize int +} + +type meta struct { + magic uint32 + version uint32 + pageSize uint32 + flags uint32 + root bucket + freelist pgid + pgid pgid + txid txid + checksum uint64 +} + +// validate checks the marker bytes and version of the meta page to ensure it matches this binary. +func (m *meta) validate() error { + if m.checksum != 0 && m.checksum != m.sum64() { + return ErrChecksum + } else if m.magic != magic { + return ErrInvalid + } else if m.version != version { + return ErrVersionMismatch + } + return nil +} + +// copy copies one meta object to another. +func (m *meta) copy(dest *meta) { + *dest = *m +} + +// write writes the meta onto a page. +func (m *meta) write(p *page) { + + _assert(m.root.root < m.pgid, "root bucket pgid (%d) above high water mark (%d)", m.root.root, m.pgid) + _assert(m.freelist < m.pgid, "freelist pgid (%d) above high water mark (%d)", m.freelist, m.pgid) + + // Page id is either going to be 0 or 1 which we can determine by the transaction ID. + p.id = pgid(m.txid % 2) + p.flags |= metaPageFlag + + // Calculate the checksum. + m.checksum = m.sum64() + + m.copy(p.meta()) +} + +// generates the checksum for the meta. +func (m *meta) sum64() uint64 { + var h = fnv.New64a() + _, _ = h.Write((*[unsafe.Offsetof(meta{}.checksum)]byte)(unsafe.Pointer(m))[:]) + return h.Sum64() +} + +// _assert will panic with a given formatted message if the given condition is false. +func _assert(condition bool, msg string, v ...interface{}) { + if !condition { + panic(fmt.Sprintf("assertion failed: "+msg, v...)) + } +} + +func warn(v ...interface{}) { + fmt.Fprintln(os.Stderr, v...) +} + +func warnf(msg string, v ...interface{}) { + fmt.Fprintf(os.Stderr, msg+"\n", v...) +} + +func printstack() { + stack := strings.Join(strings.Split(string(debug.Stack()), "\n")[2:], "\n") + fmt.Fprintln(os.Stderr, stack) +} diff --git a/vendor/src/github.com/boltdb/bolt/doc.go b/vendor/src/github.com/boltdb/bolt/doc.go new file mode 100644 index 0000000000..cc937845db --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/doc.go @@ -0,0 +1,44 @@ +/* +Package bolt implements a low-level key/value store in pure Go. It supports +fully serializable transactions, ACID semantics, and lock-free MVCC with +multiple readers and a single writer. Bolt can be used for projects that +want a simple data store without the need to add large dependencies such as +Postgres or MySQL. + +Bolt is a single-level, zero-copy, B+tree data store. This means that Bolt is +optimized for fast read access and does not require recovery in the event of a +system crash. Transactions which have not finished committing will simply be +rolled back in the event of a crash. + +The design of Bolt is based on Howard Chu's LMDB database project. + +Bolt currently works on Windows, Mac OS X, and Linux. + + +Basics + +There are only a few types in Bolt: DB, Bucket, Tx, and Cursor. The DB is +a collection of buckets and is represented by a single file on disk. A bucket is +a collection of unique keys that are associated with values. + +Transactions provide either read-only or read-write access to the database. +Read-only transactions can retrieve key/value pairs and can use Cursors to +iterate over the dataset sequentially. Read-write transactions can create and +delete buckets and can insert and remove keys. Only one read-write transaction +is allowed at a time. + + +Caveats + +The database uses a read-only, memory-mapped data file to ensure that +applications cannot corrupt the database, however, this means that keys and +values returned from Bolt cannot be changed. Writing to a read-only byte slice +will cause Go to panic. + +Keys and values retrieved from the database are only valid for the life of +the transaction. When used outside the transaction, these byte slices can +point to different data or can point to invalid memory which will cause a panic. + + +*/ +package bolt diff --git a/vendor/src/github.com/boltdb/bolt/errors.go b/vendor/src/github.com/boltdb/bolt/errors.go new file mode 100644 index 0000000000..aa504f1384 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/errors.go @@ -0,0 +1,66 @@ +package bolt + +import "errors" + +// These errors can be returned when opening or calling methods on a DB. +var ( + // ErrDatabaseNotOpen is returned when a DB instance is accessed before it + // is opened or after it is closed. + ErrDatabaseNotOpen = errors.New("database not open") + + // ErrDatabaseOpen is returned when opening a database that is + // already open. + ErrDatabaseOpen = errors.New("database already open") + + // ErrInvalid is returned when a data file is not a Bolt-formatted database. + ErrInvalid = errors.New("invalid database") + + // ErrVersionMismatch is returned when the data file was created with a + // different version of Bolt. + ErrVersionMismatch = errors.New("version mismatch") + + // ErrChecksum is returned when either meta page checksum does not match. + ErrChecksum = errors.New("checksum error") + + // ErrTimeout is returned when a database cannot obtain an exclusive lock + // on the data file after the timeout passed to Open(). + ErrTimeout = errors.New("timeout") +) + +// These errors can occur when beginning or committing a Tx. +var ( + // ErrTxNotWritable is returned when performing a write operation on a + // read-only transaction. + ErrTxNotWritable = errors.New("tx not writable") + + // ErrTxClosed is returned when committing or rolling back a transaction + // that has already been committed or rolled back. + ErrTxClosed = errors.New("tx closed") +) + +// These errors can occur when putting or deleting a value or a bucket. +var ( + // ErrBucketNotFound is returned when trying to access a bucket that has + // not been created yet. + ErrBucketNotFound = errors.New("bucket not found") + + // ErrBucketExists is returned when creating a bucket that already exists. + ErrBucketExists = errors.New("bucket already exists") + + // ErrBucketNameRequired is returned when creating a bucket with a blank name. + ErrBucketNameRequired = errors.New("bucket name required") + + // ErrKeyRequired is returned when inserting a zero-length key. + ErrKeyRequired = errors.New("key required") + + // ErrKeyTooLarge is returned when inserting a key that is larger than MaxKeySize. + ErrKeyTooLarge = errors.New("key too large") + + // ErrValueTooLarge is returned when inserting a value that is larger than MaxValueSize. + ErrValueTooLarge = errors.New("value too large") + + // ErrIncompatibleValue is returned when trying create or delete a bucket + // on an existing non-bucket key or when trying to create or delete a + // non-bucket key on an existing bucket key. + ErrIncompatibleValue = errors.New("incompatible value") +) diff --git a/vendor/src/github.com/boltdb/bolt/freelist.go b/vendor/src/github.com/boltdb/bolt/freelist.go new file mode 100644 index 0000000000..150e3e617a --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/freelist.go @@ -0,0 +1,234 @@ +package bolt + +import ( + "sort" + "unsafe" +) + +// freelist represents a list of all pages that are available for allocation. +// It also tracks pages that have been freed but are still in use by open transactions. +type freelist struct { + ids []pgid // all free and available free page ids. + pending map[txid][]pgid // mapping of soon-to-be free page ids by tx. + cache map[pgid]bool // fast lookup of all free and pending page ids. +} + +// newFreelist returns an empty, initialized freelist. +func newFreelist() *freelist { + return &freelist{ + pending: make(map[txid][]pgid), + cache: make(map[pgid]bool), + } +} + +// size returns the size of the page after serialization. +func (f *freelist) size() int { + return pageHeaderSize + (int(unsafe.Sizeof(pgid(0))) * f.count()) +} + +// count returns count of pages on the freelist +func (f *freelist) count() int { + return f.free_count() + f.pending_count() +} + +// free_count returns count of free pages +func (f *freelist) free_count() int { + return len(f.ids) +} + +// pending_count returns count of pending pages +func (f *freelist) pending_count() int { + var count int + for _, list := range f.pending { + count += len(list) + } + return count +} + +// all returns a list of all free ids and all pending ids in one sorted list. +func (f *freelist) all() []pgid { + ids := make([]pgid, len(f.ids)) + copy(ids, f.ids) + + for _, list := range f.pending { + ids = append(ids, list...) + } + + sort.Sort(pgids(ids)) + return ids +} + +// allocate returns the starting page id of a contiguous list of pages of a given size. +// If a contiguous block cannot be found then 0 is returned. +func (f *freelist) allocate(n int) pgid { + if len(f.ids) == 0 { + return 0 + } + + var initial, previd pgid + for i, id := range f.ids { + _assert(id > 1, "invalid page allocation: %d", id) + + // Reset initial page if this is not contiguous. + if previd == 0 || id-previd != 1 { + initial = id + } + + // If we found a contiguous block then remove it and return it. + if (id-initial)+1 == pgid(n) { + // If we're allocating off the beginning then take the fast path + // and just adjust the existing slice. This will use extra memory + // temporarily but the append() in free() will realloc the slice + // as is necessary. + if (i + 1) == n { + f.ids = f.ids[i+1:] + } else { + copy(f.ids[i-n+1:], f.ids[i+1:]) + f.ids = f.ids[:len(f.ids)-n] + } + + // Remove from the free cache. + for i := pgid(0); i < pgid(n); i++ { + delete(f.cache, initial+i) + } + + return initial + } + + previd = id + } + return 0 +} + +// free releases a page and its overflow for a given transaction id. +// If the page is already free then a panic will occur. +func (f *freelist) free(txid txid, p *page) { + _assert(p.id > 1, "cannot free page 0 or 1: %d", p.id) + + // Free page and all its overflow pages. + var ids = f.pending[txid] + for id := p.id; id <= p.id+pgid(p.overflow); id++ { + // Verify that page is not already free. + _assert(!f.cache[id], "page %d already freed", id) + + // Add to the freelist and cache. + ids = append(ids, id) + f.cache[id] = true + } + f.pending[txid] = ids +} + +// release moves all page ids for a transaction id (or older) to the freelist. +func (f *freelist) release(txid txid) { + for tid, ids := range f.pending { + if tid <= txid { + // Move transaction's pending pages to the available freelist. + // Don't remove from the cache since the page is still free. + f.ids = append(f.ids, ids...) + delete(f.pending, tid) + } + } + sort.Sort(pgids(f.ids)) +} + +// rollback removes the pages from a given pending tx. +func (f *freelist) rollback(txid txid) { + // Remove page ids from cache. + for _, id := range f.pending[txid] { + delete(f.cache, id) + } + + // Remove pages from pending list. + delete(f.pending, txid) +} + +// freed returns whether a given page is in the free list. +func (f *freelist) freed(pgid pgid) bool { + return f.cache[pgid] +} + +// read initializes the freelist from a freelist page. +func (f *freelist) read(p *page) { + // If the page.count is at the max uint16 value (64k) then it's considered + // an overflow and the size of the freelist is stored as the first element. + idx, count := 0, int(p.count) + if count == 0xFFFF { + idx = 1 + count = int(((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[0]) + } + + // Copy the list of page ids from the freelist. + ids := ((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[idx:count] + f.ids = make([]pgid, len(ids)) + copy(f.ids, ids) + + // Make sure they're sorted. + sort.Sort(pgids(f.ids)) + + // Rebuild the page cache. + f.reindex() +} + +// write writes the page ids onto a freelist page. All free and pending ids are +// saved to disk since in the event of a program crash, all pending ids will +// become free. +func (f *freelist) write(p *page) error { + // Combine the old free pgids and pgids waiting on an open transaction. + ids := f.all() + + // Update the header flag. + p.flags |= freelistPageFlag + + // The page.count can only hold up to 64k elements so if we overflow that + // number then we handle it by putting the size in the first element. + if len(ids) < 0xFFFF { + p.count = uint16(len(ids)) + copy(((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[:], ids) + } else { + p.count = 0xFFFF + ((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[0] = pgid(len(ids)) + copy(((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[1:], ids) + } + + return nil +} + +// reload reads the freelist from a page and filters out pending items. +func (f *freelist) reload(p *page) { + f.read(p) + + // Build a cache of only pending pages. + pcache := make(map[pgid]bool) + for _, pendingIDs := range f.pending { + for _, pendingID := range pendingIDs { + pcache[pendingID] = true + } + } + + // Check each page in the freelist and build a new available freelist + // with any pages not in the pending lists. + var a []pgid + for _, id := range f.ids { + if !pcache[id] { + a = append(a, id) + } + } + f.ids = a + + // Once the available list is rebuilt then rebuild the free cache so that + // it includes the available and pending free pages. + f.reindex() +} + +// reindex rebuilds the free cache based on available and pending free lists. +func (f *freelist) reindex() { + f.cache = make(map[pgid]bool) + for _, id := range f.ids { + f.cache[id] = true + } + for _, pendingIDs := range f.pending { + for _, pendingID := range pendingIDs { + f.cache[pendingID] = true + } + } +} diff --git a/vendor/src/github.com/boltdb/bolt/node.go b/vendor/src/github.com/boltdb/bolt/node.go new file mode 100644 index 0000000000..c204c39f0a --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/node.go @@ -0,0 +1,616 @@ +package bolt + +import ( + "bytes" + "sort" + "unsafe" +) + +// node represents an in-memory, deserialized page. +type node struct { + bucket *Bucket + isLeaf bool + unbalanced bool + spilled bool + key []byte + pgid pgid + parent *node + children nodes + inodes inodes +} + +// root returns the top-level node this node is attached to. +func (n *node) root() *node { + if n.parent == nil { + return n + } + return n.parent.root() +} + +// minKeys returns the minimum number of inodes this node should have. +func (n *node) minKeys() int { + if n.isLeaf { + return 1 + } + return 2 +} + +// size returns the size of the node after serialization. +func (n *node) size() int { + sz, elsz := pageHeaderSize, n.pageElementSize() + for i := 0; i < len(n.inodes); i++ { + item := &n.inodes[i] + sz += elsz + len(item.key) + len(item.value) + } + return sz +} + +// sizeLessThan returns true if the node is less than a given size. +// This is an optimization to avoid calculating a large node when we only need +// to know if it fits inside a certain page size. +func (n *node) sizeLessThan(v int) bool { + sz, elsz := pageHeaderSize, n.pageElementSize() + for i := 0; i < len(n.inodes); i++ { + item := &n.inodes[i] + sz += elsz + len(item.key) + len(item.value) + if sz >= v { + return false + } + } + return true +} + +// pageElementSize returns the size of each page element based on the type of node. +func (n *node) pageElementSize() int { + if n.isLeaf { + return leafPageElementSize + } + return branchPageElementSize +} + +// childAt returns the child node at a given index. +func (n *node) childAt(index int) *node { + _assert(!n.isLeaf, "invalid childAt(%d) on a leaf node", index) + return n.bucket.node(n.inodes[index].pgid, n) +} + +// childIndex returns the index of a given child node. +func (n *node) childIndex(child *node) int { + index := sort.Search(len(n.inodes), func(i int) bool { return bytes.Compare(n.inodes[i].key, child.key) != -1 }) + return index +} + +// numChildren returns the number of children. +func (n *node) numChildren() int { + return len(n.inodes) +} + +// nextSibling returns the next node with the same parent. +func (n *node) nextSibling() *node { + if n.parent == nil { + return nil + } + index := n.parent.childIndex(n) + if index >= n.parent.numChildren()-1 { + return nil + } + return n.parent.childAt(index + 1) +} + +// prevSibling returns the previous node with the same parent. +func (n *node) prevSibling() *node { + if n.parent == nil { + return nil + } + index := n.parent.childIndex(n) + if index == 0 { + return nil + } + return n.parent.childAt(index - 1) +} + +// put inserts a key/value. +func (n *node) put(oldKey, newKey, value []byte, pgid pgid, flags uint32) { + _assert(pgid < n.bucket.tx.meta.pgid, "pgid (%d) above high water mark (%d)", pgid, n.bucket.tx.meta.pgid) + _assert(len(oldKey) > 0, "put: zero-length old key") + _assert(len(newKey) > 0, "put: zero-length new key") + + // Find insertion index. + index := sort.Search(len(n.inodes), func(i int) bool { return bytes.Compare(n.inodes[i].key, oldKey) != -1 }) + + // Add capacity and shift nodes if we don't have an exact match and need to insert. + exact := (len(n.inodes) > 0 && index < len(n.inodes) && bytes.Equal(n.inodes[index].key, oldKey)) + if !exact { + n.inodes = append(n.inodes, inode{}) + copy(n.inodes[index+1:], n.inodes[index:]) + } + + inode := &n.inodes[index] + inode.flags = flags + inode.key = newKey + inode.value = value + inode.pgid = pgid + _assert(len(inode.key) > 0, "put: zero-length inode key") +} + +// del removes a key from the node. +func (n *node) del(key []byte) { + // Find index of key. + index := sort.Search(len(n.inodes), func(i int) bool { return bytes.Compare(n.inodes[i].key, key) != -1 }) + + // Exit if the key isn't found. + if index >= len(n.inodes) || !bytes.Equal(n.inodes[index].key, key) { + return + } + + // Delete inode from the node. + n.inodes = append(n.inodes[:index], n.inodes[index+1:]...) + + // Mark the node as needing rebalancing. + n.unbalanced = true +} + +// read initializes the node from a page. +func (n *node) read(p *page) { + n.pgid = p.id + n.isLeaf = ((p.flags & leafPageFlag) != 0) + n.inodes = make(inodes, int(p.count)) + + for i := 0; i < int(p.count); i++ { + inode := &n.inodes[i] + if n.isLeaf { + elem := p.leafPageElement(uint16(i)) + inode.flags = elem.flags + inode.key = elem.key() + inode.value = elem.value() + } else { + elem := p.branchPageElement(uint16(i)) + inode.pgid = elem.pgid + inode.key = elem.key() + } + _assert(len(inode.key) > 0, "read: zero-length inode key") + } + + // Save first key so we can find the node in the parent when we spill. + if len(n.inodes) > 0 { + n.key = n.inodes[0].key + _assert(len(n.key) > 0, "read: zero-length node key") + } else { + n.key = nil + } +} + +// write writes the items onto one or more pages. +func (n *node) write(p *page) { + // Initialize page. + if n.isLeaf { + p.flags |= leafPageFlag + } else { + p.flags |= branchPageFlag + } + + _assert(len(n.inodes) < 0xFFFF, "inode overflow: %d (pgid=%d)", len(n.inodes), p.id) + p.count = uint16(len(n.inodes)) + + // Loop over each item and write it to the page. + b := (*[maxAllocSize]byte)(unsafe.Pointer(&p.ptr))[n.pageElementSize()*len(n.inodes):] + for i, item := range n.inodes { + _assert(len(item.key) > 0, "write: zero-length inode key") + + // Write the page element. + if n.isLeaf { + elem := p.leafPageElement(uint16(i)) + elem.pos = uint32(uintptr(unsafe.Pointer(&b[0])) - uintptr(unsafe.Pointer(elem))) + elem.flags = item.flags + elem.ksize = uint32(len(item.key)) + elem.vsize = uint32(len(item.value)) + } else { + elem := p.branchPageElement(uint16(i)) + elem.pos = uint32(uintptr(unsafe.Pointer(&b[0])) - uintptr(unsafe.Pointer(elem))) + elem.ksize = uint32(len(item.key)) + elem.pgid = item.pgid + _assert(elem.pgid != p.id, "write: circular dependency occurred") + } + + // Write data for the element to the end of the page. + copy(b[0:], item.key) + b = b[len(item.key):] + copy(b[0:], item.value) + b = b[len(item.value):] + } + + // DEBUG ONLY: n.dump() +} + +// split breaks up a node into multiple smaller nodes, if appropriate. +// This should only be called from the spill() function. +func (n *node) split(pageSize int) []*node { + var nodes []*node + + node := n + for { + // Split node into two. + a, b := node.splitTwo(pageSize) + nodes = append(nodes, a) + + // If we can't split then exit the loop. + if b == nil { + break + } + + // Set node to b so it gets split on the next iteration. + node = b + } + + return nodes +} + +// splitTwo breaks up a node into two smaller nodes, if appropriate. +// This should only be called from the split() function. +func (n *node) splitTwo(pageSize int) (*node, *node) { + // Ignore the split if the page doesn't have at least enough nodes for + // two pages or if the nodes can fit in a single page. + if len(n.inodes) <= (minKeysPerPage*2) || n.sizeLessThan(pageSize) { + return n, nil + } + + // Determine the threshold before starting a new node. + var fillPercent = n.bucket.FillPercent + if fillPercent < minFillPercent { + fillPercent = minFillPercent + } else if fillPercent > maxFillPercent { + fillPercent = maxFillPercent + } + threshold := int(float64(pageSize) * fillPercent) + + // Determine split position and sizes of the two pages. + splitIndex, _ := n.splitIndex(threshold) + + // Split node into two separate nodes. + // If there's no parent then we'll need to create one. + if n.parent == nil { + n.parent = &node{bucket: n.bucket, children: []*node{n}} + } + + // Create a new node and add it to the parent. + next := &node{bucket: n.bucket, isLeaf: n.isLeaf, parent: n.parent} + n.parent.children = append(n.parent.children, next) + + // Split inodes across two nodes. + next.inodes = n.inodes[splitIndex:] + n.inodes = n.inodes[:splitIndex] + + // Update the statistics. + n.bucket.tx.stats.Split++ + + return n, next +} + +// splitIndex finds the position where a page will fill a given threshold. +// It returns the index as well as the size of the first page. +// This is only be called from split(). +func (n *node) splitIndex(threshold int) (index, sz int) { + sz = pageHeaderSize + + // Loop until we only have the minimum number of keys required for the second page. + for i := 0; i < len(n.inodes)-minKeysPerPage; i++ { + index = i + inode := n.inodes[i] + elsize := n.pageElementSize() + len(inode.key) + len(inode.value) + + // If we have at least the minimum number of keys and adding another + // node would put us over the threshold then exit and return. + if i >= minKeysPerPage && sz+elsize > threshold { + break + } + + // Add the element size to the total size. + sz += elsize + } + + return +} + +// spill writes the nodes to dirty pages and splits nodes as it goes. +// Returns an error if dirty pages cannot be allocated. +func (n *node) spill() error { + var tx = n.bucket.tx + if n.spilled { + return nil + } + + // Spill child nodes first. Child nodes can materialize sibling nodes in + // the case of split-merge so we cannot use a range loop. We have to check + // the children size on every loop iteration. + sort.Sort(n.children) + for i := 0; i < len(n.children); i++ { + if err := n.children[i].spill(); err != nil { + return err + } + } + + // We no longer need the child list because it's only used for spill tracking. + n.children = nil + + // Split nodes into appropriate sizes. The first node will always be n. + var nodes = n.split(tx.db.pageSize) + for _, node := range nodes { + // Add node's page to the freelist if it's not new. + if node.pgid > 0 { + tx.db.freelist.free(tx.meta.txid, tx.page(node.pgid)) + node.pgid = 0 + } + + // Allocate contiguous space for the node. + p, err := tx.allocate((node.size() / tx.db.pageSize) + 1) + if err != nil { + return err + } + + // Write the node. + _assert(p.id < tx.meta.pgid, "pgid (%d) above high water mark (%d)", p.id, tx.meta.pgid) + node.pgid = p.id + node.write(p) + node.spilled = true + + // Insert into parent inodes. + if node.parent != nil { + var key = node.key + if key == nil { + key = node.inodes[0].key + } + + node.parent.put(key, node.inodes[0].key, nil, node.pgid, 0) + node.key = node.inodes[0].key + _assert(len(node.key) > 0, "spill: zero-length node key") + } + + // Update the statistics. + tx.stats.Spill++ + } + + // If the root node split and created a new root then we need to spill that + // as well. We'll clear out the children to make sure it doesn't try to respill. + if n.parent != nil && n.parent.pgid == 0 { + n.children = nil + return n.parent.spill() + } + + return nil +} + +// rebalance attempts to combine the node with sibling nodes if the node fill +// size is below a threshold or if there are not enough keys. +func (n *node) rebalance() { + if !n.unbalanced { + return + } + n.unbalanced = false + + // Update statistics. + n.bucket.tx.stats.Rebalance++ + + // Ignore if node is above threshold (25%) and has enough keys. + var threshold = n.bucket.tx.db.pageSize / 4 + if n.size() > threshold && len(n.inodes) > n.minKeys() { + return + } + + // Root node has special handling. + if n.parent == nil { + // If root node is a branch and only has one node then collapse it. + if !n.isLeaf && len(n.inodes) == 1 { + // Move root's child up. + child := n.bucket.node(n.inodes[0].pgid, n) + n.isLeaf = child.isLeaf + n.inodes = child.inodes[:] + n.children = child.children + + // Reparent all child nodes being moved. + for _, inode := range n.inodes { + if child, ok := n.bucket.nodes[inode.pgid]; ok { + child.parent = n + } + } + + // Remove old child. + child.parent = nil + delete(n.bucket.nodes, child.pgid) + child.free() + } + + return + } + + // If node has no keys then just remove it. + if n.numChildren() == 0 { + n.parent.del(n.key) + n.parent.removeChild(n) + delete(n.bucket.nodes, n.pgid) + n.free() + n.parent.rebalance() + return + } + + _assert(n.parent.numChildren() > 1, "parent must have at least 2 children") + + // Destination node is right sibling if idx == 0, otherwise left sibling. + var target *node + var useNextSibling = (n.parent.childIndex(n) == 0) + if useNextSibling { + target = n.nextSibling() + } else { + target = n.prevSibling() + } + + // If target node has extra nodes then just move one over. + if target.numChildren() > target.minKeys() { + if useNextSibling { + // Reparent and move node. + if child, ok := n.bucket.nodes[target.inodes[0].pgid]; ok { + child.parent.removeChild(child) + child.parent = n + child.parent.children = append(child.parent.children, child) + } + n.inodes = append(n.inodes, target.inodes[0]) + target.inodes = target.inodes[1:] + + // Update target key on parent. + target.parent.put(target.key, target.inodes[0].key, nil, target.pgid, 0) + target.key = target.inodes[0].key + _assert(len(target.key) > 0, "rebalance(1): zero-length node key") + } else { + // Reparent and move node. + if child, ok := n.bucket.nodes[target.inodes[len(target.inodes)-1].pgid]; ok { + child.parent.removeChild(child) + child.parent = n + child.parent.children = append(child.parent.children, child) + } + n.inodes = append(n.inodes, inode{}) + copy(n.inodes[1:], n.inodes) + n.inodes[0] = target.inodes[len(target.inodes)-1] + target.inodes = target.inodes[:len(target.inodes)-1] + } + + // Update parent key for node. + n.parent.put(n.key, n.inodes[0].key, nil, n.pgid, 0) + n.key = n.inodes[0].key + _assert(len(n.key) > 0, "rebalance(2): zero-length node key") + + return + } + + // If both this node and the target node are too small then merge them. + if useNextSibling { + // Reparent all child nodes being moved. + for _, inode := range target.inodes { + if child, ok := n.bucket.nodes[inode.pgid]; ok { + child.parent.removeChild(child) + child.parent = n + child.parent.children = append(child.parent.children, child) + } + } + + // Copy over inodes from target and remove target. + n.inodes = append(n.inodes, target.inodes...) + n.parent.del(target.key) + n.parent.removeChild(target) + delete(n.bucket.nodes, target.pgid) + target.free() + } else { + // Reparent all child nodes being moved. + for _, inode := range n.inodes { + if child, ok := n.bucket.nodes[inode.pgid]; ok { + child.parent.removeChild(child) + child.parent = target + child.parent.children = append(child.parent.children, child) + } + } + + // Copy over inodes to target and remove node. + target.inodes = append(target.inodes, n.inodes...) + n.parent.del(n.key) + n.parent.removeChild(n) + delete(n.bucket.nodes, n.pgid) + n.free() + } + + // Either this node or the target node was deleted from the parent so rebalance it. + n.parent.rebalance() +} + +// removes a node from the list of in-memory children. +// This does not affect the inodes. +func (n *node) removeChild(target *node) { + for i, child := range n.children { + if child == target { + n.children = append(n.children[:i], n.children[i+1:]...) + return + } + } +} + +// dereference causes the node to copy all its inode key/value references to heap memory. +// This is required when the mmap is reallocated so inodes are not pointing to stale data. +func (n *node) dereference() { + if n.key != nil { + key := make([]byte, len(n.key)) + copy(key, n.key) + n.key = key + _assert(n.pgid == 0 || len(n.key) > 0, "dereference: zero-length node key on existing node") + } + + for i := range n.inodes { + inode := &n.inodes[i] + + key := make([]byte, len(inode.key)) + copy(key, inode.key) + inode.key = key + _assert(len(inode.key) > 0, "dereference: zero-length inode key") + + value := make([]byte, len(inode.value)) + copy(value, inode.value) + inode.value = value + } + + // Recursively dereference children. + for _, child := range n.children { + child.dereference() + } + + // Update statistics. + n.bucket.tx.stats.NodeDeref++ +} + +// free adds the node's underlying page to the freelist. +func (n *node) free() { + if n.pgid != 0 { + n.bucket.tx.db.freelist.free(n.bucket.tx.meta.txid, n.bucket.tx.page(n.pgid)) + n.pgid = 0 + } +} + +// dump writes the contents of the node to STDERR for debugging purposes. +/* +func (n *node) dump() { + // Write node header. + var typ = "branch" + if n.isLeaf { + typ = "leaf" + } + warnf("[NODE %d {type=%s count=%d}]", n.pgid, typ, len(n.inodes)) + + // Write out abbreviated version of each item. + for _, item := range n.inodes { + if n.isLeaf { + if item.flags&bucketLeafFlag != 0 { + bucket := (*bucket)(unsafe.Pointer(&item.value[0])) + warnf("+L %08x -> (bucket root=%d)", trunc(item.key, 4), bucket.root) + } else { + warnf("+L %08x -> %08x", trunc(item.key, 4), trunc(item.value, 4)) + } + } else { + warnf("+B %08x -> pgid=%d", trunc(item.key, 4), item.pgid) + } + } + warn("") +} +*/ + +type nodes []*node + +func (s nodes) Len() int { return len(s) } +func (s nodes) Swap(i, j int) { s[i], s[j] = s[j], s[i] } +func (s nodes) Less(i, j int) bool { return bytes.Compare(s[i].inodes[0].key, s[j].inodes[0].key) == -1 } + +// inode represents an internal node inside of a node. +// It can be used to point to elements in a page or point +// to an element which hasn't been added to a page yet. +type inode struct { + flags uint32 + pgid pgid + key []byte + value []byte +} + +type inodes []inode diff --git a/vendor/src/github.com/boltdb/bolt/page.go b/vendor/src/github.com/boltdb/bolt/page.go new file mode 100644 index 0000000000..b3dc473ad3 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/page.go @@ -0,0 +1,135 @@ +package bolt + +import ( + "fmt" + "os" + "unsafe" +) + +const pageHeaderSize = int(unsafe.Offsetof(((*page)(nil)).ptr)) + +const maxAllocSize = 0xFFFFFFF +const minKeysPerPage = 2 + +const branchPageElementSize = int(unsafe.Sizeof(branchPageElement{})) +const leafPageElementSize = int(unsafe.Sizeof(leafPageElement{})) + +const ( + branchPageFlag = 0x01 + leafPageFlag = 0x02 + metaPageFlag = 0x04 + freelistPageFlag = 0x10 +) + +const ( + bucketLeafFlag = 0x01 +) + +type pgid uint64 + +type page struct { + id pgid + flags uint16 + count uint16 + overflow uint32 + ptr uintptr +} + +// typ returns a human readable page type string used for debugging. +func (p *page) typ() string { + if (p.flags & branchPageFlag) != 0 { + return "branch" + } else if (p.flags & leafPageFlag) != 0 { + return "leaf" + } else if (p.flags & metaPageFlag) != 0 { + return "meta" + } else if (p.flags & freelistPageFlag) != 0 { + return "freelist" + } + return fmt.Sprintf("unknown<%02x>", p.flags) +} + +// meta returns a pointer to the metadata section of the page. +func (p *page) meta() *meta { + return (*meta)(unsafe.Pointer(&p.ptr)) +} + +// leafPageElement retrieves the leaf node by index +func (p *page) leafPageElement(index uint16) *leafPageElement { + n := &((*[0x7FFFFFF]leafPageElement)(unsafe.Pointer(&p.ptr)))[index] + return n +} + +// leafPageElements retrieves a list of leaf nodes. +func (p *page) leafPageElements() []leafPageElement { + return ((*[0x7FFFFFF]leafPageElement)(unsafe.Pointer(&p.ptr)))[:] +} + +// branchPageElement retrieves the branch node by index +func (p *page) branchPageElement(index uint16) *branchPageElement { + return &((*[0x7FFFFFF]branchPageElement)(unsafe.Pointer(&p.ptr)))[index] +} + +// branchPageElements retrieves a list of branch nodes. +func (p *page) branchPageElements() []branchPageElement { + return ((*[0x7FFFFFF]branchPageElement)(unsafe.Pointer(&p.ptr)))[:] +} + +// dump writes n bytes of the page to STDERR as hex output. +func (p *page) hexdump(n int) { + buf := (*[maxAllocSize]byte)(unsafe.Pointer(p))[:n] + fmt.Fprintf(os.Stderr, "%x\n", buf) +} + +type pages []*page + +func (s pages) Len() int { return len(s) } +func (s pages) Swap(i, j int) { s[i], s[j] = s[j], s[i] } +func (s pages) Less(i, j int) bool { return s[i].id < s[j].id } + +// branchPageElement represents a node on a branch page. +type branchPageElement struct { + pos uint32 + ksize uint32 + pgid pgid +} + +// key returns a byte slice of the node key. +func (n *branchPageElement) key() []byte { + buf := (*[maxAllocSize]byte)(unsafe.Pointer(n)) + return buf[n.pos : n.pos+n.ksize] +} + +// leafPageElement represents a node on a leaf page. +type leafPageElement struct { + flags uint32 + pos uint32 + ksize uint32 + vsize uint32 +} + +// key returns a byte slice of the node key. +func (n *leafPageElement) key() []byte { + buf := (*[maxAllocSize]byte)(unsafe.Pointer(n)) + return buf[n.pos : n.pos+n.ksize] +} + +// value returns a byte slice of the node value. +func (n *leafPageElement) value() []byte { + buf := (*[maxAllocSize]byte)(unsafe.Pointer(n)) + return buf[n.pos+n.ksize : n.pos+n.ksize+n.vsize] +} + +// PageInfo represents human readable information about a page. +type PageInfo struct { + ID int + Type string + Count int + OverflowCount int +} + +type pgids []pgid + +func (s pgids) Len() int { return len(s) } +func (s pgids) Swap(i, j int) { s[i], s[j] = s[j], s[i] } +func (s pgids) Less(i, j int) bool { return s[i] < s[j] } diff --git a/vendor/src/github.com/boltdb/bolt/tx.go b/vendor/src/github.com/boltdb/bolt/tx.go new file mode 100644 index 0000000000..c041d738b6 --- /dev/null +++ b/vendor/src/github.com/boltdb/bolt/tx.go @@ -0,0 +1,580 @@ +package bolt + +import ( + "fmt" + "io" + "os" + "sort" + "time" + "unsafe" +) + +// txid represents the internal transaction identifier. +type txid uint64 + +// Tx represents a read-only or read/write transaction on the database. +// Read-only transactions can be used for retrieving values for keys and creating cursors. +// Read/write transactions can create and remove buckets and create and remove keys. +// +// IMPORTANT: You must commit or rollback transactions when you are done with +// them. Pages can not be reclaimed by the writer until no more transactions +// are using them. A long running read transaction can cause the database to +// quickly grow. +type Tx struct { + writable bool + managed bool + db *DB + meta *meta + root Bucket + pages map[pgid]*page + stats TxStats + commitHandlers []func() +} + +// init initializes the transaction. +func (tx *Tx) init(db *DB) { + tx.db = db + tx.pages = nil + + // Copy the meta page since it can be changed by the writer. + tx.meta = &meta{} + db.meta().copy(tx.meta) + + // Copy over the root bucket. + tx.root = newBucket(tx) + tx.root.bucket = &bucket{} + *tx.root.bucket = tx.meta.root + + // Increment the transaction id and add a page cache for writable transactions. + if tx.writable { + tx.pages = make(map[pgid]*page) + tx.meta.txid += txid(1) + } +} + +// ID returns the transaction id. +func (tx *Tx) ID() int { + return int(tx.meta.txid) +} + +// DB returns a reference to the database that created the transaction. +func (tx *Tx) DB() *DB { + return tx.db +} + +// Size returns current database size in bytes as seen by this transaction. +func (tx *Tx) Size() int64 { + return int64(tx.meta.pgid) * int64(tx.db.pageSize) +} + +// Writable returns whether the transaction can perform write operations. +func (tx *Tx) Writable() bool { + return tx.writable +} + +// Cursor creates a cursor associated with the root bucket. +// All items in the cursor will return a nil value because all root bucket keys point to buckets. +// The cursor is only valid as long as the transaction is open. +// Do not use a cursor after the transaction is closed. +func (tx *Tx) Cursor() *Cursor { + return tx.root.Cursor() +} + +// Stats retrieves a copy of the current transaction statistics. +func (tx *Tx) Stats() TxStats { + return tx.stats +} + +// Bucket retrieves a bucket by name. +// Returns nil if the bucket does not exist. +func (tx *Tx) Bucket(name []byte) *Bucket { + return tx.root.Bucket(name) +} + +// CreateBucket creates a new bucket. +// Returns an error if the bucket already exists, if the bucket name is blank, or if the bucket name is too long. +func (tx *Tx) CreateBucket(name []byte) (*Bucket, error) { + return tx.root.CreateBucket(name) +} + +// CreateBucketIfNotExists creates a new bucket if it doesn't already exist. +// Returns an error if the bucket name is blank, or if the bucket name is too long. +func (tx *Tx) CreateBucketIfNotExists(name []byte) (*Bucket, error) { + return tx.root.CreateBucketIfNotExists(name) +} + +// DeleteBucket deletes a bucket. +// Returns an error if the bucket cannot be found or if the key represents a non-bucket value. +func (tx *Tx) DeleteBucket(name []byte) error { + return tx.root.DeleteBucket(name) +} + +// ForEach executes a function for each bucket in the root. +// If the provided function returns an error then the iteration is stopped and +// the error is returned to the caller. +func (tx *Tx) ForEach(fn func(name []byte, b *Bucket) error) error { + return tx.root.ForEach(func(k, v []byte) error { + if err := fn(k, tx.root.Bucket(k)); err != nil { + return err + } + return nil + }) +} + +// OnCommit adds a handler function to be executed after the transaction successfully commits. +func (tx *Tx) OnCommit(fn func()) { + tx.commitHandlers = append(tx.commitHandlers, fn) +} + +// Commit writes all changes to disk and updates the meta page. +// Returns an error if a disk write error occurs. +func (tx *Tx) Commit() error { + _assert(!tx.managed, "managed tx commit not allowed") + if tx.db == nil { + return ErrTxClosed + } else if !tx.writable { + return ErrTxNotWritable + } + + // TODO(benbjohnson): Use vectorized I/O to write out dirty pages. + + // Rebalance nodes which have had deletions. + var startTime = time.Now() + tx.root.rebalance() + if tx.stats.Rebalance > 0 { + tx.stats.RebalanceTime += time.Since(startTime) + } + + // spill data onto dirty pages. + startTime = time.Now() + if err := tx.root.spill(); err != nil { + tx.rollback() + return err + } + tx.stats.SpillTime += time.Since(startTime) + + // Free the old root bucket. + tx.meta.root.root = tx.root.root + + // Free the freelist and allocate new pages for it. This will overestimate + // the size of the freelist but not underestimate the size (which would be bad). + tx.db.freelist.free(tx.meta.txid, tx.db.page(tx.meta.freelist)) + p, err := tx.allocate((tx.db.freelist.size() / tx.db.pageSize) + 1) + if err != nil { + tx.rollback() + return err + } + if err := tx.db.freelist.write(p); err != nil { + tx.rollback() + return err + } + tx.meta.freelist = p.id + + // Write dirty pages to disk. + startTime = time.Now() + if err := tx.write(); err != nil { + tx.rollback() + return err + } + + // If strict mode is enabled then perform a consistency check. + // Only the first consistency error is reported in the panic. + if tx.db.StrictMode { + if err, ok := <-tx.Check(); ok { + panic("check fail: " + err.Error()) + } + } + + // Write meta to disk. + if err := tx.writeMeta(); err != nil { + tx.rollback() + return err + } + tx.stats.WriteTime += time.Since(startTime) + + // Finalize the transaction. + tx.close() + + // Execute commit handlers now that the locks have been removed. + for _, fn := range tx.commitHandlers { + fn() + } + + return nil +} + +// Rollback closes the transaction and ignores all previous updates. +func (tx *Tx) Rollback() error { + _assert(!tx.managed, "managed tx rollback not allowed") + if tx.db == nil { + return ErrTxClosed + } + tx.rollback() + return nil +} + +func (tx *Tx) rollback() { + if tx.db == nil { + return + } + if tx.writable { + tx.db.freelist.rollback(tx.meta.txid) + tx.db.freelist.reload(tx.db.page(tx.db.meta().freelist)) + } + tx.close() +} + +func (tx *Tx) close() { + if tx.db == nil { + return + } + if tx.writable { + // Grab freelist stats. + var freelistFreeN = tx.db.freelist.free_count() + var freelistPendingN = tx.db.freelist.pending_count() + var freelistAlloc = tx.db.freelist.size() + + // Remove writer lock. + tx.db.rwlock.Unlock() + + // Merge statistics. + tx.db.statlock.Lock() + tx.db.stats.FreePageN = freelistFreeN + tx.db.stats.PendingPageN = freelistPendingN + tx.db.stats.FreeAlloc = (freelistFreeN + freelistPendingN) * tx.db.pageSize + tx.db.stats.FreelistInuse = freelistAlloc + tx.db.stats.TxStats.add(&tx.stats) + tx.db.statlock.Unlock() + } else { + tx.db.removeTx(tx) + } + tx.db = nil +} + +// Copy writes the entire database to a writer. +// A reader transaction is maintained during the copy so it is safe to continue +// using the database while a copy is in progress. +// Copy will write exactly tx.Size() bytes into the writer. +func (tx *Tx) Copy(w io.Writer) error { + var f *os.File + var err error + + // Attempt to open reader directly. + if f, err = os.OpenFile(tx.db.path, os.O_RDONLY|odirect, 0); err != nil { + // Fallback to a regular open if that doesn't work. + if f, err = os.OpenFile(tx.db.path, os.O_RDONLY, 0); err != nil { + return err + } + } + + // Copy the meta pages. + tx.db.metalock.Lock() + _, err = io.CopyN(w, f, int64(tx.db.pageSize*2)) + tx.db.metalock.Unlock() + if err != nil { + _ = f.Close() + return fmt.Errorf("meta copy: %s", err) + } + + // Copy data pages. + if _, err := io.CopyN(w, f, tx.Size()-int64(tx.db.pageSize*2)); err != nil { + _ = f.Close() + return err + } + + return f.Close() +} + +// CopyFile copies the entire database to file at the given path. +// A reader transaction is maintained during the copy so it is safe to continue +// using the database while a copy is in progress. +func (tx *Tx) CopyFile(path string, mode os.FileMode) error { + f, err := os.OpenFile(path, os.O_RDWR|os.O_CREATE|os.O_TRUNC, mode) + if err != nil { + return err + } + + err = tx.Copy(f) + if err != nil { + _ = f.Close() + return err + } + return f.Close() +} + +// Check performs several consistency checks on the database for this transaction. +// An error is returned if any inconsistency is found. +// +// It can be safely run concurrently on a writable transaction. However, this +// incurs a high cost for large databases and databases with a lot of subbuckets +// because of caching. This overhead can be removed if running on a read-only +// transaction, however, it is not safe to execute other writer transactions at +// the same time. +func (tx *Tx) Check() <-chan error { + ch := make(chan error) + go tx.check(ch) + return ch +} + +func (tx *Tx) check(ch chan error) { + // Check if any pages are double freed. + freed := make(map[pgid]bool) + for _, id := range tx.db.freelist.all() { + if freed[id] { + ch <- fmt.Errorf("page %d: already freed", id) + } + freed[id] = true + } + + // Track every reachable page. + reachable := make(map[pgid]*page) + reachable[0] = tx.page(0) // meta0 + reachable[1] = tx.page(1) // meta1 + for i := uint32(0); i <= tx.page(tx.meta.freelist).overflow; i++ { + reachable[tx.meta.freelist+pgid(i)] = tx.page(tx.meta.freelist) + } + + // Recursively check buckets. + tx.checkBucket(&tx.root, reachable, freed, ch) + + // Ensure all pages below high water mark are either reachable or freed. + for i := pgid(0); i < tx.meta.pgid; i++ { + _, isReachable := reachable[i] + if !isReachable && !freed[i] { + ch <- fmt.Errorf("page %d: unreachable unfreed", int(i)) + } + } + + // Close the channel to signal completion. + close(ch) +} + +func (tx *Tx) checkBucket(b *Bucket, reachable map[pgid]*page, freed map[pgid]bool, ch chan error) { + // Ignore inline buckets. + if b.root == 0 { + return + } + + // Check every page used by this bucket. + b.tx.forEachPage(b.root, 0, func(p *page, _ int) { + if p.id > tx.meta.pgid { + ch <- fmt.Errorf("page %d: out of bounds: %d", int(p.id), int(b.tx.meta.pgid)) + } + + // Ensure each page is only referenced once. + for i := pgid(0); i <= pgid(p.overflow); i++ { + var id = p.id + i + if _, ok := reachable[id]; ok { + ch <- fmt.Errorf("page %d: multiple references", int(id)) + } + reachable[id] = p + } + + // We should only encounter un-freed leaf and branch pages. + if freed[p.id] { + ch <- fmt.Errorf("page %d: reachable freed", int(p.id)) + } else if (p.flags&branchPageFlag) == 0 && (p.flags&leafPageFlag) == 0 { + ch <- fmt.Errorf("page %d: invalid type: %s", int(p.id), p.typ()) + } + }) + + // Check each bucket within this bucket. + _ = b.ForEach(func(k, v []byte) error { + if child := b.Bucket(k); child != nil { + tx.checkBucket(child, reachable, freed, ch) + } + return nil + }) +} + +// allocate returns a contiguous block of memory starting at a given page. +func (tx *Tx) allocate(count int) (*page, error) { + p, err := tx.db.allocate(count) + if err != nil { + return nil, err + } + + // Save to our page cache. + tx.pages[p.id] = p + + // Update statistics. + tx.stats.PageCount++ + tx.stats.PageAlloc += count * tx.db.pageSize + + return p, nil +} + +// write writes any dirty pages to disk. +func (tx *Tx) write() error { + // Sort pages by id. + pages := make(pages, 0, len(tx.pages)) + for _, p := range tx.pages { + pages = append(pages, p) + } + sort.Sort(pages) + + // Write pages to disk in order. + for _, p := range pages { + size := (int(p.overflow) + 1) * tx.db.pageSize + buf := (*[maxAllocSize]byte)(unsafe.Pointer(p))[:size] + offset := int64(p.id) * int64(tx.db.pageSize) + if _, err := tx.db.ops.writeAt(buf, offset); err != nil { + return err + } + + // Update statistics. + tx.stats.Write++ + } + if !tx.db.NoSync || IgnoreNoSync { + if err := fdatasync(tx.db); err != nil { + return err + } + } + + // Clear out page cache. + tx.pages = make(map[pgid]*page) + + return nil +} + +// writeMeta writes the meta to the disk. +func (tx *Tx) writeMeta() error { + // Create a temporary buffer for the meta page. + buf := make([]byte, tx.db.pageSize) + p := tx.db.pageInBuffer(buf, 0) + tx.meta.write(p) + + // Write the meta page to file. + if _, err := tx.db.ops.writeAt(buf, int64(p.id)*int64(tx.db.pageSize)); err != nil { + return err + } + if !tx.db.NoSync || IgnoreNoSync { + if err := fdatasync(tx.db); err != nil { + return err + } + } + + // Update statistics. + tx.stats.Write++ + + return nil +} + +// page returns a reference to the page with a given id. +// If page has been written to then a temporary bufferred page is returned. +func (tx *Tx) page(id pgid) *page { + // Check the dirty pages first. + if tx.pages != nil { + if p, ok := tx.pages[id]; ok { + return p + } + } + + // Otherwise return directly from the mmap. + return tx.db.page(id) +} + +// forEachPage iterates over every page within a given page and executes a function. +func (tx *Tx) forEachPage(pgid pgid, depth int, fn func(*page, int)) { + p := tx.page(pgid) + + // Execute function. + fn(p, depth) + + // Recursively loop over children. + if (p.flags & branchPageFlag) != 0 { + for i := 0; i < int(p.count); i++ { + elem := p.branchPageElement(uint16(i)) + tx.forEachPage(elem.pgid, depth+1, fn) + } + } +} + +// Page returns page information for a given page number. +// This is only safe for concurrent use when used by a writable transaction. +func (tx *Tx) Page(id int) (*PageInfo, error) { + if tx.db == nil { + return nil, ErrTxClosed + } else if pgid(id) >= tx.meta.pgid { + return nil, nil + } + + // Build the page info. + p := tx.db.page(pgid(id)) + info := &PageInfo{ + ID: id, + Count: int(p.count), + OverflowCount: int(p.overflow), + } + + // Determine the type (or if it's free). + if tx.db.freelist.freed(pgid(id)) { + info.Type = "free" + } else { + info.Type = p.typ() + } + + return info, nil +} + +// TxStats represents statistics about the actions performed by the transaction. +type TxStats struct { + // Page statistics. + PageCount int // number of page allocations + PageAlloc int // total bytes allocated + + // Cursor statistics. + CursorCount int // number of cursors created + + // Node statistics + NodeCount int // number of node allocations + NodeDeref int // number of node dereferences + + // Rebalance statistics. + Rebalance int // number of node rebalances + RebalanceTime time.Duration // total time spent rebalancing + + // Split/Spill statistics. + Split int // number of nodes split + Spill int // number of nodes spilled + SpillTime time.Duration // total time spent spilling + + // Write statistics. + Write int // number of writes performed + WriteTime time.Duration // total time spent writing to disk +} + +func (s *TxStats) add(other *TxStats) { + s.PageCount += other.PageCount + s.PageAlloc += other.PageAlloc + s.CursorCount += other.CursorCount + s.NodeCount += other.NodeCount + s.NodeDeref += other.NodeDeref + s.Rebalance += other.Rebalance + s.RebalanceTime += other.RebalanceTime + s.Split += other.Split + s.Spill += other.Spill + s.SpillTime += other.SpillTime + s.Write += other.Write + s.WriteTime += other.WriteTime +} + +// Sub calculates and returns the difference between two sets of transaction stats. +// This is useful when obtaining stats at two different points and time and +// you need the performance counters that occurred within that time span. +func (s *TxStats) Sub(other *TxStats) TxStats { + var diff TxStats + diff.PageCount = s.PageCount - other.PageCount + diff.PageAlloc = s.PageAlloc - other.PageAlloc + diff.CursorCount = s.CursorCount - other.CursorCount + diff.NodeCount = s.NodeCount - other.NodeCount + diff.NodeDeref = s.NodeDeref - other.NodeDeref + diff.Rebalance = s.Rebalance - other.Rebalance + diff.RebalanceTime = s.RebalanceTime - other.RebalanceTime + diff.Split = s.Split - other.Split + diff.Spill = s.Spill - other.Spill + diff.SpillTime = s.SpillTime - other.SpillTime + diff.Write = s.Write - other.Write + diff.WriteTime = s.WriteTime - other.WriteTime + return diff +} diff --git a/vendor/src/github.com/coreos/etcd/LICENSE b/vendor/src/github.com/coreos/etcd/LICENSE new file mode 100644 index 0000000000..d645695673 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/vendor/src/github.com/coreos/etcd/client/README.md b/vendor/src/github.com/coreos/etcd/client/README.md new file mode 100644 index 0000000000..672b8c13f0 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/README.md @@ -0,0 +1,94 @@ +# etcd/client + +etcd/client is the Go client library for etcd. + +[![GoDoc](https://godoc.org/github.com/coreos/etcd/client?status.png)](https://godoc.org/github.com/coreos/etcd/client) + +## Install + +```bash +go get github.com/coreos/etcd/client +``` + +## Usage + +```go +package main + +import ( + "log" + "time" + + "github.com/coreos/etcd/Godeps/_workspace/src/golang.org/x/net/context" + "github.com/coreos/etcd/client" +) + +func main() { + cfg := client.Config{ + Endpoints: []string{"http://127.0.0.1:2379"}, + Transport: client.DefaultTransport, + // set timeout per request to fail fast when the target endpoint is unavailable + HeaderTimeoutPerRequest: time.Second, + } + c, err := client.New(cfg) + if err != nil { + log.Fatal(err) + } + kapi := client.NewKeysAPI(c) + resp, err := kapi.Set(context.Background(), "foo", "bar", nil) + if err != nil { + log.Fatal(err) + } +} +``` + +## Error Handling + +etcd client might return three types of errors. + +- context error + +Each API call has its first parameter as `context`. A context can be canceled or have an attached deadline. If the context is canceled or reaches its deadline, the responding context error will be returned no matter what internal errors the API call has already encountered. + +- cluster error + +Each API call tries to send request to the cluster endpoints one by one until it successfully gets a response. If a requests to an endpoint fails, due to exceeding per request timeout or connection issues, the error will be added into a list of errors. If all possible endpoints fail, a cluster error that includes all encountered errors will be returned. + +- response error + +If the response gets from the cluster is invalid, a plain string error will be returned. For example, it might be a invalid JSON error. + +Here is the example code to handle client errors: + +```go +cfg := client.Config{Endpoints: []string{"http://etcd1:2379,http://etcd2:2379,http://etcd3:2379"}} +c, err := client.New(cfg) +if err != nil { + log.Fatal(err) +} + +kapi := client.NewKeysAPI(c) +resp, err := kapi.Set(ctx, "test", "bar", nil) +if err != nil { + if err == context.Canceled { + // ctx is canceled by another routine + } else if err == context.DeadlineExceeded { + // ctx is attached with a deadline and it exceeded + } else if cerr, ok := err.(*client.ClusterError); ok { + // process (cerr.Errors) + } else { + // bad cluster endpoints, which are not etcd servers + } +} +``` + + +## Caveat + +1. etcd/client prefers to use the same endpoint as long as the endpoint continues to work well. This saves socket resources, and improves efficiency for both client and server side. This preference doesn't remove consistency from the data consumed by the client because data replicated to each etcd member has already passed through the consensus process. + +2. etcd/client does round-robin rotation on other available endpoints if the preferred endpoint isn't functioning properly. For example, if the member that etcd/client connects to is hard killed, etcd/client will fail on the first attempt with the killed member, and succeed on the second attempt with another member. If it fails to talk to all available endpoints, it will return all errors happened. + +3. Default etcd/client cannot handle the case that the remote server is SIGSTOPed now. TCP keepalive mechanism doesn't help in this scenario because operating system may still send TCP keep-alive packets. Over time we'd like to improve this functionality, but solving this issue isn't high priority because a real-life case in which a server is stopped, but the connection is kept alive, hasn't been brought to our attention. + +4. etcd/client cannot detect whether the member in use is healthy when doing read requests. If the member is isolated from the cluster, etcd/client may retrieve outdated data. As a workaround, users could monitor experimental /health endpoint for member healthy information. We are improving it at [#3265](https://github.com/coreos/etcd/issues/3265). diff --git a/vendor/src/github.com/coreos/etcd/client/auth_role.go b/vendor/src/github.com/coreos/etcd/client/auth_role.go new file mode 100644 index 0000000000..8de58afcf1 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/auth_role.go @@ -0,0 +1,235 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import ( + "bytes" + "encoding/json" + "net/http" + "net/url" + + "golang.org/x/net/context" +) + +type Role struct { + Role string `json:"role"` + Permissions Permissions `json:"permissions"` + Grant *Permissions `json:"grant,omitempty"` + Revoke *Permissions `json:"revoke,omitempty"` +} + +type Permissions struct { + KV rwPermission `json:"kv"` +} + +type rwPermission struct { + Read []string `json:"read"` + Write []string `json:"write"` +} + +type PermissionType int + +const ( + ReadPermission PermissionType = iota + WritePermission + ReadWritePermission +) + +// NewAuthRoleAPI constructs a new AuthRoleAPI that uses HTTP to +// interact with etcd's role creation and modification features. +func NewAuthRoleAPI(c Client) AuthRoleAPI { + return &httpAuthRoleAPI{ + client: c, + } +} + +type AuthRoleAPI interface { + // Add a role. + AddRole(ctx context.Context, role string) error + + // Remove a role. + RemoveRole(ctx context.Context, role string) error + + // Get role details. + GetRole(ctx context.Context, role string) (*Role, error) + + // Grant a role some permission prefixes for the KV store. + GrantRoleKV(ctx context.Context, role string, prefixes []string, permType PermissionType) (*Role, error) + + // Revoke some some permission prefixes for a role on the KV store. + RevokeRoleKV(ctx context.Context, role string, prefixes []string, permType PermissionType) (*Role, error) + + // List roles. + ListRoles(ctx context.Context) ([]string, error) +} + +type httpAuthRoleAPI struct { + client httpClient +} + +type authRoleAPIAction struct { + verb string + name string + role *Role +} + +type authRoleAPIList struct{} + +func (list *authRoleAPIList) HTTPRequest(ep url.URL) *http.Request { + u := v2AuthURL(ep, "roles", "") + req, _ := http.NewRequest("GET", u.String(), nil) + req.Header.Set("Content-Type", "application/json") + return req +} + +func (l *authRoleAPIAction) HTTPRequest(ep url.URL) *http.Request { + u := v2AuthURL(ep, "roles", l.name) + if l.role == nil { + req, _ := http.NewRequest(l.verb, u.String(), nil) + return req + } + b, err := json.Marshal(l.role) + if err != nil { + panic(err) + } + body := bytes.NewReader(b) + req, _ := http.NewRequest(l.verb, u.String(), body) + req.Header.Set("Content-Type", "application/json") + return req +} + +func (r *httpAuthRoleAPI) ListRoles(ctx context.Context) ([]string, error) { + resp, body, err := r.client.Do(ctx, &authRoleAPIList{}) + if err != nil { + return nil, err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK); err != nil { + return nil, err + } + var userList struct { + Roles []string `json:"roles"` + } + err = json.Unmarshal(body, &userList) + if err != nil { + return nil, err + } + return userList.Roles, nil +} + +func (r *httpAuthRoleAPI) AddRole(ctx context.Context, rolename string) error { + role := &Role{ + Role: rolename, + } + return r.addRemoveRole(ctx, &authRoleAPIAction{ + verb: "PUT", + name: rolename, + role: role, + }) +} + +func (r *httpAuthRoleAPI) RemoveRole(ctx context.Context, rolename string) error { + return r.addRemoveRole(ctx, &authRoleAPIAction{ + verb: "DELETE", + name: rolename, + }) +} + +func (r *httpAuthRoleAPI) addRemoveRole(ctx context.Context, req *authRoleAPIAction) error { + resp, body, err := r.client.Do(ctx, req) + if err != nil { + return err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK, http.StatusCreated); err != nil { + var sec authError + err := json.Unmarshal(body, &sec) + if err != nil { + return err + } + return sec + } + return nil +} + +func (r *httpAuthRoleAPI) GetRole(ctx context.Context, rolename string) (*Role, error) { + return r.modRole(ctx, &authRoleAPIAction{ + verb: "GET", + name: rolename, + }) +} + +func buildRWPermission(prefixes []string, permType PermissionType) rwPermission { + var out rwPermission + switch permType { + case ReadPermission: + out.Read = prefixes + case WritePermission: + out.Write = prefixes + case ReadWritePermission: + out.Read = prefixes + out.Write = prefixes + } + return out +} + +func (r *httpAuthRoleAPI) GrantRoleKV(ctx context.Context, rolename string, prefixes []string, permType PermissionType) (*Role, error) { + rwp := buildRWPermission(prefixes, permType) + role := &Role{ + Role: rolename, + Grant: &Permissions{ + KV: rwp, + }, + } + return r.modRole(ctx, &authRoleAPIAction{ + verb: "PUT", + name: rolename, + role: role, + }) +} + +func (r *httpAuthRoleAPI) RevokeRoleKV(ctx context.Context, rolename string, prefixes []string, permType PermissionType) (*Role, error) { + rwp := buildRWPermission(prefixes, permType) + role := &Role{ + Role: rolename, + Revoke: &Permissions{ + KV: rwp, + }, + } + return r.modRole(ctx, &authRoleAPIAction{ + verb: "PUT", + name: rolename, + role: role, + }) +} + +func (r *httpAuthRoleAPI) modRole(ctx context.Context, req *authRoleAPIAction) (*Role, error) { + resp, body, err := r.client.Do(ctx, req) + if err != nil { + return nil, err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK); err != nil { + var sec authError + err := json.Unmarshal(body, &sec) + if err != nil { + return nil, err + } + return nil, sec + } + var role Role + err = json.Unmarshal(body, &role) + if err != nil { + return nil, err + } + return &role, nil +} diff --git a/vendor/src/github.com/coreos/etcd/client/auth_user.go b/vendor/src/github.com/coreos/etcd/client/auth_user.go new file mode 100644 index 0000000000..6e0e4c596c --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/auth_user.go @@ -0,0 +1,297 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import ( + "bytes" + "encoding/json" + "net/http" + "net/url" + "path" + + "golang.org/x/net/context" +) + +var ( + defaultV2AuthPrefix = "/v2/auth" +) + +type User struct { + User string `json:"user"` + Password string `json:"password,omitempty"` + Roles []string `json:"roles"` + Grant []string `json:"grant,omitempty"` + Revoke []string `json:"revoke,omitempty"` +} + +func v2AuthURL(ep url.URL, action string, name string) *url.URL { + if name != "" { + ep.Path = path.Join(ep.Path, defaultV2AuthPrefix, action, name) + return &ep + } + ep.Path = path.Join(ep.Path, defaultV2AuthPrefix, action) + return &ep +} + +// NewAuthAPI constructs a new AuthAPI that uses HTTP to +// interact with etcd's general auth features. +func NewAuthAPI(c Client) AuthAPI { + return &httpAuthAPI{ + client: c, + } +} + +type AuthAPI interface { + // Enable auth. + Enable(ctx context.Context) error + + // Disable auth. + Disable(ctx context.Context) error +} + +type httpAuthAPI struct { + client httpClient +} + +func (s *httpAuthAPI) Enable(ctx context.Context) error { + return s.enableDisable(ctx, &authAPIAction{"PUT"}) +} + +func (s *httpAuthAPI) Disable(ctx context.Context) error { + return s.enableDisable(ctx, &authAPIAction{"DELETE"}) +} + +func (s *httpAuthAPI) enableDisable(ctx context.Context, req httpAction) error { + resp, body, err := s.client.Do(ctx, req) + if err != nil { + return err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK, http.StatusCreated); err != nil { + var sec authError + err := json.Unmarshal(body, &sec) + if err != nil { + return err + } + return sec + } + return nil +} + +type authAPIAction struct { + verb string +} + +func (l *authAPIAction) HTTPRequest(ep url.URL) *http.Request { + u := v2AuthURL(ep, "enable", "") + req, _ := http.NewRequest(l.verb, u.String(), nil) + return req +} + +type authError struct { + Message string `json:"message"` + Code int `json:"-"` +} + +func (e authError) Error() string { + return e.Message +} + +// NewAuthUserAPI constructs a new AuthUserAPI that uses HTTP to +// interact with etcd's user creation and modification features. +func NewAuthUserAPI(c Client) AuthUserAPI { + return &httpAuthUserAPI{ + client: c, + } +} + +type AuthUserAPI interface { + // Add a user. + AddUser(ctx context.Context, username string, password string) error + + // Remove a user. + RemoveUser(ctx context.Context, username string) error + + // Get user details. + GetUser(ctx context.Context, username string) (*User, error) + + // Grant a user some permission roles. + GrantUser(ctx context.Context, username string, roles []string) (*User, error) + + // Revoke some permission roles from a user. + RevokeUser(ctx context.Context, username string, roles []string) (*User, error) + + // Change the user's password. + ChangePassword(ctx context.Context, username string, password string) (*User, error) + + // List users. + ListUsers(ctx context.Context) ([]string, error) +} + +type httpAuthUserAPI struct { + client httpClient +} + +type authUserAPIAction struct { + verb string + username string + user *User +} + +type authUserAPIList struct{} + +func (list *authUserAPIList) HTTPRequest(ep url.URL) *http.Request { + u := v2AuthURL(ep, "users", "") + req, _ := http.NewRequest("GET", u.String(), nil) + req.Header.Set("Content-Type", "application/json") + return req +} + +func (l *authUserAPIAction) HTTPRequest(ep url.URL) *http.Request { + u := v2AuthURL(ep, "users", l.username) + if l.user == nil { + req, _ := http.NewRequest(l.verb, u.String(), nil) + return req + } + b, err := json.Marshal(l.user) + if err != nil { + panic(err) + } + body := bytes.NewReader(b) + req, _ := http.NewRequest(l.verb, u.String(), body) + req.Header.Set("Content-Type", "application/json") + return req +} + +func (u *httpAuthUserAPI) ListUsers(ctx context.Context) ([]string, error) { + resp, body, err := u.client.Do(ctx, &authUserAPIList{}) + if err != nil { + return nil, err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK); err != nil { + var sec authError + err := json.Unmarshal(body, &sec) + if err != nil { + return nil, err + } + return nil, sec + } + var userList struct { + Users []string `json:"users"` + } + err = json.Unmarshal(body, &userList) + if err != nil { + return nil, err + } + return userList.Users, nil +} + +func (u *httpAuthUserAPI) AddUser(ctx context.Context, username string, password string) error { + user := &User{ + User: username, + Password: password, + } + return u.addRemoveUser(ctx, &authUserAPIAction{ + verb: "PUT", + username: username, + user: user, + }) +} + +func (u *httpAuthUserAPI) RemoveUser(ctx context.Context, username string) error { + return u.addRemoveUser(ctx, &authUserAPIAction{ + verb: "DELETE", + username: username, + }) +} + +func (u *httpAuthUserAPI) addRemoveUser(ctx context.Context, req *authUserAPIAction) error { + resp, body, err := u.client.Do(ctx, req) + if err != nil { + return err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK, http.StatusCreated); err != nil { + var sec authError + err := json.Unmarshal(body, &sec) + if err != nil { + return err + } + return sec + } + return nil +} + +func (u *httpAuthUserAPI) GetUser(ctx context.Context, username string) (*User, error) { + return u.modUser(ctx, &authUserAPIAction{ + verb: "GET", + username: username, + }) +} + +func (u *httpAuthUserAPI) GrantUser(ctx context.Context, username string, roles []string) (*User, error) { + user := &User{ + User: username, + Grant: roles, + } + return u.modUser(ctx, &authUserAPIAction{ + verb: "PUT", + username: username, + user: user, + }) +} + +func (u *httpAuthUserAPI) RevokeUser(ctx context.Context, username string, roles []string) (*User, error) { + user := &User{ + User: username, + Revoke: roles, + } + return u.modUser(ctx, &authUserAPIAction{ + verb: "PUT", + username: username, + user: user, + }) +} + +func (u *httpAuthUserAPI) ChangePassword(ctx context.Context, username string, password string) (*User, error) { + user := &User{ + User: username, + Password: password, + } + return u.modUser(ctx, &authUserAPIAction{ + verb: "PUT", + username: username, + user: user, + }) +} + +func (u *httpAuthUserAPI) modUser(ctx context.Context, req *authUserAPIAction) (*User, error) { + resp, body, err := u.client.Do(ctx, req) + if err != nil { + return nil, err + } + if err := assertStatusCode(resp.StatusCode, http.StatusOK); err != nil { + var sec authError + err := json.Unmarshal(body, &sec) + if err != nil { + return nil, err + } + return nil, sec + } + var user User + err = json.Unmarshal(body, &user) + if err != nil { + return nil, err + } + return &user, nil +} diff --git a/vendor/src/github.com/coreos/etcd/client/cancelreq.go b/vendor/src/github.com/coreos/etcd/client/cancelreq.go new file mode 100644 index 0000000000..fefdb40e42 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/cancelreq.go @@ -0,0 +1,20 @@ +// Copyright 2015 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// borrowed from golang/net/context/ctxhttp/cancelreq.go + +// +build go1.5 + +package client + +import "net/http" + +func requestCanceler(tr CancelableTransport, req *http.Request) func() { + ch := make(chan struct{}) + req.Cancel = ch + + return func() { + close(ch) + } +} diff --git a/vendor/src/github.com/coreos/etcd/client/cancelreq_go14.go b/vendor/src/github.com/coreos/etcd/client/cancelreq_go14.go new file mode 100644 index 0000000000..2bed38a418 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/cancelreq_go14.go @@ -0,0 +1,17 @@ +// Copyright 2015 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// borrowed from golang/net/context/ctxhttp/cancelreq_go14.go + +// +build !go1.5 + +package client + +import "net/http" + +func requestCanceler(tr CancelableTransport, req *http.Request) func() { + return func() { + tr.CancelRequest(req) + } +} diff --git a/vendor/src/github.com/coreos/etcd/client/client.go b/vendor/src/github.com/coreos/etcd/client/client.go new file mode 100644 index 0000000000..34adb82b02 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/client.go @@ -0,0 +1,514 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import ( + "errors" + "fmt" + "io/ioutil" + "math/rand" + "net" + "net/http" + "net/url" + "reflect" + "sort" + "sync" + "time" + + "golang.org/x/net/context" +) + +var ( + ErrNoEndpoints = errors.New("client: no endpoints available") + ErrTooManyRedirects = errors.New("client: too many redirects") + ErrClusterUnavailable = errors.New("client: etcd cluster is unavailable or misconfigured") + errTooManyRedirectChecks = errors.New("client: too many redirect checks") +) + +var DefaultRequestTimeout = 5 * time.Second + +var DefaultTransport CancelableTransport = &http.Transport{ + Proxy: http.ProxyFromEnvironment, + Dial: (&net.Dialer{ + Timeout: 30 * time.Second, + KeepAlive: 30 * time.Second, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, +} + +type Config struct { + // Endpoints defines a set of URLs (schemes, hosts and ports only) + // that can be used to communicate with a logical etcd cluster. For + // example, a three-node cluster could be provided like so: + // + // Endpoints: []string{ + // "http://node1.example.com:2379", + // "http://node2.example.com:2379", + // "http://node3.example.com:2379", + // } + // + // If multiple endpoints are provided, the Client will attempt to + // use them all in the event that one or more of them are unusable. + // + // If Client.Sync is ever called, the Client may cache an alternate + // set of endpoints to continue operation. + Endpoints []string + + // Transport is used by the Client to drive HTTP requests. If not + // provided, DefaultTransport will be used. + Transport CancelableTransport + + // CheckRedirect specifies the policy for handling HTTP redirects. + // If CheckRedirect is not nil, the Client calls it before + // following an HTTP redirect. The sole argument is the number of + // requests that have alrady been made. If CheckRedirect returns + // an error, Client.Do will not make any further requests and return + // the error back it to the caller. + // + // If CheckRedirect is nil, the Client uses its default policy, + // which is to stop after 10 consecutive requests. + CheckRedirect CheckRedirectFunc + + // Username specifies the user credential to add as an authorization header + Username string + + // Password is the password for the specified user to add as an authorization header + // to the request. + Password string + + // HeaderTimeoutPerRequest specifies the time limit to wait for response + // header in a single request made by the Client. The timeout includes + // connection time, any redirects, and header wait time. + // + // For non-watch GET request, server returns the response body immediately. + // For PUT/POST/DELETE request, server will attempt to commit request + // before responding, which is expected to take `100ms + 2 * RTT`. + // For watch request, server returns the header immediately to notify Client + // watch start. But if server is behind some kind of proxy, the response + // header may be cached at proxy, and Client cannot rely on this behavior. + // + // One API call may send multiple requests to different etcd servers until it + // succeeds. Use context of the API to specify the overall timeout. + // + // A HeaderTimeoutPerRequest of zero means no timeout. + HeaderTimeoutPerRequest time.Duration +} + +func (cfg *Config) transport() CancelableTransport { + if cfg.Transport == nil { + return DefaultTransport + } + return cfg.Transport +} + +func (cfg *Config) checkRedirect() CheckRedirectFunc { + if cfg.CheckRedirect == nil { + return DefaultCheckRedirect + } + return cfg.CheckRedirect +} + +// CancelableTransport mimics net/http.Transport, but requires that +// the object also support request cancellation. +type CancelableTransport interface { + http.RoundTripper + CancelRequest(req *http.Request) +} + +type CheckRedirectFunc func(via int) error + +// DefaultCheckRedirect follows up to 10 redirects, but no more. +var DefaultCheckRedirect CheckRedirectFunc = func(via int) error { + if via > 10 { + return ErrTooManyRedirects + } + return nil +} + +type Client interface { + // Sync updates the internal cache of the etcd cluster's membership. + Sync(context.Context) error + + // AutoSync periodically calls Sync() every given interval. + // The recommended sync interval is 10 seconds to 1 minute, which does + // not bring too much overhead to server and makes client catch up the + // cluster change in time. + // + // The example to use it: + // + // for { + // err := client.AutoSync(ctx, 10*time.Second) + // if err == context.DeadlineExceeded || err == context.Canceled { + // break + // } + // log.Print(err) + // } + AutoSync(context.Context, time.Duration) error + + // Endpoints returns a copy of the current set of API endpoints used + // by Client to resolve HTTP requests. If Sync has ever been called, + // this may differ from the initial Endpoints provided in the Config. + Endpoints() []string + + httpClient +} + +func New(cfg Config) (Client, error) { + c := &httpClusterClient{ + clientFactory: newHTTPClientFactory(cfg.transport(), cfg.checkRedirect(), cfg.HeaderTimeoutPerRequest), + rand: rand.New(rand.NewSource(int64(time.Now().Nanosecond()))), + } + if cfg.Username != "" { + c.credentials = &credentials{ + username: cfg.Username, + password: cfg.Password, + } + } + if err := c.reset(cfg.Endpoints); err != nil { + return nil, err + } + return c, nil +} + +type httpClient interface { + Do(context.Context, httpAction) (*http.Response, []byte, error) +} + +func newHTTPClientFactory(tr CancelableTransport, cr CheckRedirectFunc, headerTimeout time.Duration) httpClientFactory { + return func(ep url.URL) httpClient { + return &redirectFollowingHTTPClient{ + checkRedirect: cr, + client: &simpleHTTPClient{ + transport: tr, + endpoint: ep, + headerTimeout: headerTimeout, + }, + } + } +} + +type credentials struct { + username string + password string +} + +type httpClientFactory func(url.URL) httpClient + +type httpAction interface { + HTTPRequest(url.URL) *http.Request +} + +type httpClusterClient struct { + clientFactory httpClientFactory + endpoints []url.URL + pinned int + credentials *credentials + sync.RWMutex + rand *rand.Rand +} + +func (c *httpClusterClient) reset(eps []string) error { + if len(eps) == 0 { + return ErrNoEndpoints + } + + neps := make([]url.URL, len(eps)) + for i, ep := range eps { + u, err := url.Parse(ep) + if err != nil { + return err + } + neps[i] = *u + } + + c.endpoints = shuffleEndpoints(c.rand, neps) + // TODO: pin old endpoint if possible, and rebalance when new endpoint appears + c.pinned = 0 + + return nil +} + +func (c *httpClusterClient) Do(ctx context.Context, act httpAction) (*http.Response, []byte, error) { + action := act + c.RLock() + leps := len(c.endpoints) + eps := make([]url.URL, leps) + n := copy(eps, c.endpoints) + pinned := c.pinned + + if c.credentials != nil { + action = &authedAction{ + act: act, + credentials: *c.credentials, + } + } + c.RUnlock() + + if leps == 0 { + return nil, nil, ErrNoEndpoints + } + + if leps != n { + return nil, nil, errors.New("unable to pick endpoint: copy failed") + } + + var resp *http.Response + var body []byte + var err error + cerr := &ClusterError{} + + for i := pinned; i < leps+pinned; i++ { + k := i % leps + hc := c.clientFactory(eps[k]) + resp, body, err = hc.Do(ctx, action) + if err != nil { + cerr.Errors = append(cerr.Errors, err) + // mask previous errors with context error, which is controlled by user + if err == context.Canceled || err == context.DeadlineExceeded { + return nil, nil, err + } + continue + } + if resp.StatusCode/100 == 5 { + switch resp.StatusCode { + case http.StatusInternalServerError, http.StatusServiceUnavailable: + // TODO: make sure this is a no leader response + cerr.Errors = append(cerr.Errors, fmt.Errorf("client: etcd member %s has no leader", eps[k].String())) + default: + cerr.Errors = append(cerr.Errors, fmt.Errorf("client: etcd member %s returns server error [%s]", eps[k].String(), http.StatusText(resp.StatusCode))) + } + continue + } + if k != pinned { + c.Lock() + c.pinned = k + c.Unlock() + } + return resp, body, nil + } + + return nil, nil, cerr +} + +func (c *httpClusterClient) Endpoints() []string { + c.RLock() + defer c.RUnlock() + + eps := make([]string, len(c.endpoints)) + for i, ep := range c.endpoints { + eps[i] = ep.String() + } + + return eps +} + +func (c *httpClusterClient) Sync(ctx context.Context) error { + mAPI := NewMembersAPI(c) + ms, err := mAPI.List(ctx) + if err != nil { + return err + } + + c.Lock() + defer c.Unlock() + + eps := make([]string, 0) + for _, m := range ms { + eps = append(eps, m.ClientURLs...) + } + sort.Sort(sort.StringSlice(eps)) + + ceps := make([]string, len(c.endpoints)) + for i, cep := range c.endpoints { + ceps[i] = cep.String() + } + sort.Sort(sort.StringSlice(ceps)) + // fast path if no change happens + // this helps client to pin the endpoint when no cluster change + if reflect.DeepEqual(eps, ceps) { + return nil + } + + return c.reset(eps) +} + +func (c *httpClusterClient) AutoSync(ctx context.Context, interval time.Duration) error { + ticker := time.NewTicker(interval) + defer ticker.Stop() + for { + err := c.Sync(ctx) + if err != nil { + return err + } + select { + case <-ctx.Done(): + return ctx.Err() + case <-ticker.C: + } + } +} + +type roundTripResponse struct { + resp *http.Response + err error +} + +type simpleHTTPClient struct { + transport CancelableTransport + endpoint url.URL + headerTimeout time.Duration +} + +func (c *simpleHTTPClient) Do(ctx context.Context, act httpAction) (*http.Response, []byte, error) { + req := act.HTTPRequest(c.endpoint) + + if err := printcURL(req); err != nil { + return nil, nil, err + } + + hctx, hcancel := context.WithCancel(ctx) + if c.headerTimeout > 0 { + hctx, hcancel = context.WithTimeout(ctx, c.headerTimeout) + } + defer hcancel() + + reqcancel := requestCanceler(c.transport, req) + + rtchan := make(chan roundTripResponse, 1) + go func() { + resp, err := c.transport.RoundTrip(req) + rtchan <- roundTripResponse{resp: resp, err: err} + close(rtchan) + }() + + var resp *http.Response + var err error + + select { + case rtresp := <-rtchan: + resp, err = rtresp.resp, rtresp.err + case <-hctx.Done(): + // cancel and wait for request to actually exit before continuing + reqcancel() + rtresp := <-rtchan + resp = rtresp.resp + switch { + case ctx.Err() != nil: + err = ctx.Err() + case hctx.Err() != nil: + err = fmt.Errorf("client: endpoint %s exceeded header timeout", c.endpoint.String()) + default: + panic("failed to get error from context") + } + } + + // always check for resp nil-ness to deal with possible + // race conditions between channels above + defer func() { + if resp != nil { + resp.Body.Close() + } + }() + + if err != nil { + return nil, nil, err + } + + var body []byte + done := make(chan struct{}) + go func() { + body, err = ioutil.ReadAll(resp.Body) + done <- struct{}{} + }() + + select { + case <-ctx.Done(): + resp.Body.Close() + <-done + return nil, nil, ctx.Err() + case <-done: + } + + return resp, body, err +} + +type authedAction struct { + act httpAction + credentials credentials +} + +func (a *authedAction) HTTPRequest(url url.URL) *http.Request { + r := a.act.HTTPRequest(url) + r.SetBasicAuth(a.credentials.username, a.credentials.password) + return r +} + +type redirectFollowingHTTPClient struct { + client httpClient + checkRedirect CheckRedirectFunc +} + +func (r *redirectFollowingHTTPClient) Do(ctx context.Context, act httpAction) (*http.Response, []byte, error) { + next := act + for i := 0; i < 100; i++ { + if i > 0 { + if err := r.checkRedirect(i); err != nil { + return nil, nil, err + } + } + resp, body, err := r.client.Do(ctx, next) + if err != nil { + return nil, nil, err + } + if resp.StatusCode/100 == 3 { + hdr := resp.Header.Get("Location") + if hdr == "" { + return nil, nil, fmt.Errorf("Location header not set") + } + loc, err := url.Parse(hdr) + if err != nil { + return nil, nil, fmt.Errorf("Location header not valid URL: %s", hdr) + } + next = &redirectedHTTPAction{ + action: act, + location: *loc, + } + continue + } + return resp, body, nil + } + + return nil, nil, errTooManyRedirectChecks +} + +type redirectedHTTPAction struct { + action httpAction + location url.URL +} + +func (r *redirectedHTTPAction) HTTPRequest(ep url.URL) *http.Request { + orig := r.action.HTTPRequest(ep) + orig.URL = &r.location + return orig +} + +func shuffleEndpoints(r *rand.Rand, eps []url.URL) []url.URL { + p := r.Perm(len(eps)) + neps := make([]url.URL, len(eps)) + for i, k := range p { + neps[i] = eps[k] + } + return neps +} diff --git a/vendor/src/github.com/coreos/etcd/client/cluster_error.go b/vendor/src/github.com/coreos/etcd/client/cluster_error.go new file mode 100644 index 0000000000..957ed46245 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/cluster_error.go @@ -0,0 +1,33 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import "fmt" + +type ClusterError struct { + Errors []error +} + +func (ce *ClusterError) Error() string { + return ErrClusterUnavailable.Error() +} + +func (ce *ClusterError) Detail() string { + s := "" + for i, e := range ce.Errors { + s += fmt.Sprintf("error #%d: %s\n", i, e) + } + return s +} diff --git a/vendor/src/github.com/coreos/etcd/client/curl.go b/vendor/src/github.com/coreos/etcd/client/curl.go new file mode 100644 index 0000000000..5a5a69a941 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/curl.go @@ -0,0 +1,70 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import ( + "bytes" + "fmt" + "io/ioutil" + "net/http" + "os" +) + +var ( + cURLDebug = false +) + +func EnablecURLDebug() { + cURLDebug = true +} + +func DisablecURLDebug() { + cURLDebug = false +} + +// printcURL prints the cURL equivalent request to stderr. +// It returns an error if the body of the request cannot +// be read. +// The caller MUST cancel the request if there is an error. +func printcURL(req *http.Request) error { + if !cURLDebug { + return nil + } + var ( + command string + b []byte + err error + ) + + if req.URL != nil { + command = fmt.Sprintf("curl -X %s %s", req.Method, req.URL.String()) + } + + if req.Body != nil { + b, err = ioutil.ReadAll(req.Body) + if err != nil { + return err + } + command += fmt.Sprintf(" -d %q", string(b)) + } + + fmt.Fprintf(os.Stderr, "cURL Command: %s\n", command) + + // reset body + body := bytes.NewBuffer(b) + req.Body = ioutil.NopCloser(body) + + return nil +} diff --git a/vendor/src/github.com/coreos/etcd/client/discover.go b/vendor/src/github.com/coreos/etcd/client/discover.go new file mode 100644 index 0000000000..269491c8dc --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/discover.go @@ -0,0 +1,21 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +// Discoverer is an interface that wraps the Discover method. +type Discoverer interface { + // Dicover looks up the etcd servers for the domain. + Discover(domain string) ([]string, error) +} diff --git a/vendor/src/github.com/coreos/etcd/client/doc.go b/vendor/src/github.com/coreos/etcd/client/doc.go new file mode 100644 index 0000000000..70111caceb --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/doc.go @@ -0,0 +1,71 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/* +Package client provides bindings for the etcd APIs. + +Create a Config and exchange it for a Client: + + import ( + "net/http" + + "github.com/coreos/etcd/client" + "golang.org/x/net/context" + ) + + cfg := client.Config{ + Endpoints: []string{"http://127.0.0.1:2379"}, + Transport: DefaultTransport, + } + + c, err := client.New(cfg) + if err != nil { + // handle error + } + +Create a KeysAPI using the Client, then use it to interact with etcd: + + kAPI := client.NewKeysAPI(c) + + // create a new key /foo with the value "bar" + _, err = kAPI.Create(context.Background(), "/foo", "bar") + if err != nil { + // handle error + } + + // delete the newly created key only if the value is still "bar" + _, err = kAPI.Delete(context.Background(), "/foo", &DeleteOptions{PrevValue: "bar"}) + if err != nil { + // handle error + } + +Use a custom context to set timeouts on your operations: + + import "time" + + ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) + defer cancel() + + // set a new key, ignoring it's previous state + _, err := kAPI.Set(ctx, "/ping", "pong", nil) + if err != nil { + if err == context.DeadlineExceeded { + // request took longer than 5s + } else { + // handle error + } + } + +*/ +package client diff --git a/vendor/src/github.com/coreos/etcd/client/keys.generated.go b/vendor/src/github.com/coreos/etcd/client/keys.generated.go new file mode 100644 index 0000000000..a897261f48 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/keys.generated.go @@ -0,0 +1,891 @@ +// ************************************************************ +// DO NOT EDIT. +// THIS FILE IS AUTO-GENERATED BY codecgen. +// ************************************************************ + +package client + +import ( + "errors" + "fmt" + codec1978 "github.com/ugorji/go/codec" + "reflect" + "runtime" + "time" +) + +const ( + codecSelferC_UTF85311 = 1 + codecSelferC_RAW5311 = 0 + codecSelverValueTypeArray5311 = 10 + codecSelverValueTypeMap5311 = 9 +) + +var ( + codecSelferBitsize5311 = uint8(reflect.TypeOf(uint(0)).Bits()) + codecSelferOnlyMapOrArrayEncodeToStructErr5311 = errors.New(`only encoded map or array can be decoded into a struct`) +) + +type codecSelfer5311 struct{} + +func init() { + if codec1978.GenVersion != 2 { + _, file, _, _ := runtime.Caller(0) + err := fmt.Errorf("codecgen version mismatch: current: %v, need %v. Re-generate file: %v", + 2, codec1978.GenVersion, file) + panic(err) + } + if false { // reference the types, but skip this branch at build/run time + var v0 time.Time + _ = v0 + } +} + +func (x *Response) CodecEncodeSelf(e *codec1978.Encoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperEncoder(e) + _, _, _ = h, z, r + if x == nil { + r.EncodeNil() + } else { + yysep1 := !z.EncBinary() + yy2arr1 := z.EncBasicHandle().StructToArray + var yyfirst1 bool + var yyq1 [3]bool + _, _, _, _ = yysep1, yyfirst1, yyq1, yy2arr1 + const yyr1 bool = false + if yyr1 || yy2arr1 { + r.EncodeArrayStart(3) + } else { + var yynn1 int = 3 + for _, b := range yyq1 { + if b { + yynn1++ + } + } + r.EncodeMapStart(yynn1) + } + if yyr1 || yy2arr1 { + r.EncodeString(codecSelferC_UTF85311, string(x.Action)) + } else { + yyfirst1 = true + r.EncodeString(codecSelferC_UTF85311, string("action")) + if yysep1 { + r.EncodeMapKVSeparator() + } + r.EncodeString(codecSelferC_UTF85311, string(x.Action)) + } + if yyr1 || yy2arr1 { + if yysep1 { + r.EncodeArrayEntrySeparator() + } + if x.Node == nil { + r.EncodeNil() + } else { + x.Node.CodecEncodeSelf(e) + } + } else { + if yyfirst1 { + r.EncodeMapEntrySeparator() + } else { + yyfirst1 = true + } + r.EncodeString(codecSelferC_UTF85311, string("node")) + if yysep1 { + r.EncodeMapKVSeparator() + } + if x.Node == nil { + r.EncodeNil() + } else { + x.Node.CodecEncodeSelf(e) + } + } + if yyr1 || yy2arr1 { + if yysep1 { + r.EncodeArrayEntrySeparator() + } + if x.PrevNode == nil { + r.EncodeNil() + } else { + x.PrevNode.CodecEncodeSelf(e) + } + } else { + if yyfirst1 { + r.EncodeMapEntrySeparator() + } else { + yyfirst1 = true + } + r.EncodeString(codecSelferC_UTF85311, string("prevNode")) + if yysep1 { + r.EncodeMapKVSeparator() + } + if x.PrevNode == nil { + r.EncodeNil() + } else { + x.PrevNode.CodecEncodeSelf(e) + } + } + if yysep1 { + if yyr1 || yy2arr1 { + r.EncodeArrayEnd() + } else { + r.EncodeMapEnd() + } + } + } +} + +func (x *Response) CodecDecodeSelf(d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + if r.IsContainerType(codecSelverValueTypeMap5311) { + yyl5 := r.ReadMapStart() + if yyl5 == 0 { + r.ReadMapEnd() + } else { + x.codecDecodeSelfFromMap(yyl5, d) + } + } else if r.IsContainerType(codecSelverValueTypeArray5311) { + yyl5 := r.ReadArrayStart() + if yyl5 == 0 { + r.ReadArrayEnd() + } else { + x.codecDecodeSelfFromArray(yyl5, d) + } + } else { + panic(codecSelferOnlyMapOrArrayEncodeToStructErr5311) + } +} + +func (x *Response) codecDecodeSelfFromMap(l int, d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + var yys6Slc = z.DecScratchBuffer() // default slice to decode into + _ = yys6Slc + var yyhl6 bool = l >= 0 + for yyj6 := 0; ; yyj6++ { + if yyhl6 { + if yyj6 >= l { + break + } + } else { + if r.CheckBreak() { + break + } + if yyj6 > 0 { + r.ReadMapEntrySeparator() + } + } + yys6Slc = r.DecodeBytes(yys6Slc, true, true) + yys6 := string(yys6Slc) + if !yyhl6 { + r.ReadMapKVSeparator() + } + switch yys6 { + case "action": + if r.TryDecodeAsNil() { + x.Action = "" + } else { + x.Action = string(r.DecodeString()) + } + case "node": + if r.TryDecodeAsNil() { + if x.Node != nil { + x.Node = nil + } + } else { + if x.Node == nil { + x.Node = new(Node) + } + x.Node.CodecDecodeSelf(d) + } + case "prevNode": + if r.TryDecodeAsNil() { + if x.PrevNode != nil { + x.PrevNode = nil + } + } else { + if x.PrevNode == nil { + x.PrevNode = new(Node) + } + x.PrevNode.CodecDecodeSelf(d) + } + default: + z.DecStructFieldNotFound(-1, yys6) + } // end switch yys6 + } // end for yyj6 + if !yyhl6 { + r.ReadMapEnd() + } +} + +func (x *Response) codecDecodeSelfFromArray(l int, d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + var yyj10 int + var yyb10 bool + var yyhl10 bool = l >= 0 + yyj10++ + if yyhl10 { + yyb10 = yyj10 > l + } else { + yyb10 = r.CheckBreak() + } + if yyb10 { + r.ReadArrayEnd() + return + } + if r.TryDecodeAsNil() { + x.Action = "" + } else { + x.Action = string(r.DecodeString()) + } + yyj10++ + if yyhl10 { + yyb10 = yyj10 > l + } else { + yyb10 = r.CheckBreak() + } + if yyb10 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + if x.Node != nil { + x.Node = nil + } + } else { + if x.Node == nil { + x.Node = new(Node) + } + x.Node.CodecDecodeSelf(d) + } + yyj10++ + if yyhl10 { + yyb10 = yyj10 > l + } else { + yyb10 = r.CheckBreak() + } + if yyb10 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + if x.PrevNode != nil { + x.PrevNode = nil + } + } else { + if x.PrevNode == nil { + x.PrevNode = new(Node) + } + x.PrevNode.CodecDecodeSelf(d) + } + for { + yyj10++ + if yyhl10 { + yyb10 = yyj10 > l + } else { + yyb10 = r.CheckBreak() + } + if yyb10 { + break + } + if yyj10 > 1 { + r.ReadArrayEntrySeparator() + } + z.DecStructFieldNotFound(yyj10-1, "") + } + r.ReadArrayEnd() +} + +func (x *Node) CodecEncodeSelf(e *codec1978.Encoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperEncoder(e) + _, _, _ = h, z, r + if x == nil { + r.EncodeNil() + } else { + yysep14 := !z.EncBinary() + yy2arr14 := z.EncBasicHandle().StructToArray + var yyfirst14 bool + var yyq14 [8]bool + _, _, _, _ = yysep14, yyfirst14, yyq14, yy2arr14 + const yyr14 bool = false + yyq14[1] = x.Dir != false + yyq14[6] = x.Expiration != nil + yyq14[7] = x.TTL != 0 + if yyr14 || yy2arr14 { + r.EncodeArrayStart(8) + } else { + var yynn14 int = 5 + for _, b := range yyq14 { + if b { + yynn14++ + } + } + r.EncodeMapStart(yynn14) + } + if yyr14 || yy2arr14 { + r.EncodeString(codecSelferC_UTF85311, string(x.Key)) + } else { + yyfirst14 = true + r.EncodeString(codecSelferC_UTF85311, string("key")) + if yysep14 { + r.EncodeMapKVSeparator() + } + r.EncodeString(codecSelferC_UTF85311, string(x.Key)) + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + if yyq14[1] { + r.EncodeBool(bool(x.Dir)) + } else { + r.EncodeBool(false) + } + } else { + if yyq14[1] { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("dir")) + if yysep14 { + r.EncodeMapKVSeparator() + } + r.EncodeBool(bool(x.Dir)) + } + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + r.EncodeString(codecSelferC_UTF85311, string(x.Value)) + } else { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("value")) + if yysep14 { + r.EncodeMapKVSeparator() + } + r.EncodeString(codecSelferC_UTF85311, string(x.Value)) + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + if x.Nodes == nil { + r.EncodeNil() + } else { + h.encSlicePtrtoNode(([]*Node)(x.Nodes), e) + } + } else { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("nodes")) + if yysep14 { + r.EncodeMapKVSeparator() + } + if x.Nodes == nil { + r.EncodeNil() + } else { + h.encSlicePtrtoNode(([]*Node)(x.Nodes), e) + } + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + r.EncodeUint(uint64(x.CreatedIndex)) + } else { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("createdIndex")) + if yysep14 { + r.EncodeMapKVSeparator() + } + r.EncodeUint(uint64(x.CreatedIndex)) + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + r.EncodeUint(uint64(x.ModifiedIndex)) + } else { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("modifiedIndex")) + if yysep14 { + r.EncodeMapKVSeparator() + } + r.EncodeUint(uint64(x.ModifiedIndex)) + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + if yyq14[6] { + if x.Expiration == nil { + r.EncodeNil() + } else { + z.EncFallback(x.Expiration) + } + } else { + r.EncodeNil() + } + } else { + if yyq14[6] { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("expiration")) + if yysep14 { + r.EncodeMapKVSeparator() + } + if x.Expiration == nil { + r.EncodeNil() + } else { + z.EncFallback(x.Expiration) + } + } + } + if yyr14 || yy2arr14 { + if yysep14 { + r.EncodeArrayEntrySeparator() + } + if yyq14[7] { + r.EncodeInt(int64(x.TTL)) + } else { + r.EncodeInt(0) + } + } else { + if yyq14[7] { + if yyfirst14 { + r.EncodeMapEntrySeparator() + } else { + yyfirst14 = true + } + r.EncodeString(codecSelferC_UTF85311, string("ttl")) + if yysep14 { + r.EncodeMapKVSeparator() + } + r.EncodeInt(int64(x.TTL)) + } + } + if yysep14 { + if yyr14 || yy2arr14 { + r.EncodeArrayEnd() + } else { + r.EncodeMapEnd() + } + } + } +} + +func (x *Node) CodecDecodeSelf(d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + if r.IsContainerType(codecSelverValueTypeMap5311) { + yyl23 := r.ReadMapStart() + if yyl23 == 0 { + r.ReadMapEnd() + } else { + x.codecDecodeSelfFromMap(yyl23, d) + } + } else if r.IsContainerType(codecSelverValueTypeArray5311) { + yyl23 := r.ReadArrayStart() + if yyl23 == 0 { + r.ReadArrayEnd() + } else { + x.codecDecodeSelfFromArray(yyl23, d) + } + } else { + panic(codecSelferOnlyMapOrArrayEncodeToStructErr5311) + } +} + +func (x *Node) codecDecodeSelfFromMap(l int, d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + var yys24Slc = z.DecScratchBuffer() // default slice to decode into + _ = yys24Slc + var yyhl24 bool = l >= 0 + for yyj24 := 0; ; yyj24++ { + if yyhl24 { + if yyj24 >= l { + break + } + } else { + if r.CheckBreak() { + break + } + if yyj24 > 0 { + r.ReadMapEntrySeparator() + } + } + yys24Slc = r.DecodeBytes(yys24Slc, true, true) + yys24 := string(yys24Slc) + if !yyhl24 { + r.ReadMapKVSeparator() + } + switch yys24 { + case "key": + if r.TryDecodeAsNil() { + x.Key = "" + } else { + x.Key = string(r.DecodeString()) + } + case "dir": + if r.TryDecodeAsNil() { + x.Dir = false + } else { + x.Dir = bool(r.DecodeBool()) + } + case "value": + if r.TryDecodeAsNil() { + x.Value = "" + } else { + x.Value = string(r.DecodeString()) + } + case "nodes": + if r.TryDecodeAsNil() { + x.Nodes = nil + } else { + yyv28 := &x.Nodes + h.decSlicePtrtoNode((*[]*Node)(yyv28), d) + } + case "createdIndex": + if r.TryDecodeAsNil() { + x.CreatedIndex = 0 + } else { + x.CreatedIndex = uint64(r.DecodeUint(64)) + } + case "modifiedIndex": + if r.TryDecodeAsNil() { + x.ModifiedIndex = 0 + } else { + x.ModifiedIndex = uint64(r.DecodeUint(64)) + } + case "expiration": + if r.TryDecodeAsNil() { + if x.Expiration != nil { + x.Expiration = nil + } + } else { + if x.Expiration == nil { + x.Expiration = new(time.Time) + } + z.DecFallback(x.Expiration, false) + } + case "ttl": + if r.TryDecodeAsNil() { + x.TTL = 0 + } else { + x.TTL = int64(r.DecodeInt(64)) + } + default: + z.DecStructFieldNotFound(-1, yys24) + } // end switch yys24 + } // end for yyj24 + if !yyhl24 { + r.ReadMapEnd() + } +} + +func (x *Node) codecDecodeSelfFromArray(l int, d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + var yyj33 int + var yyb33 bool + var yyhl33 bool = l >= 0 + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + if r.TryDecodeAsNil() { + x.Key = "" + } else { + x.Key = string(r.DecodeString()) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + x.Dir = false + } else { + x.Dir = bool(r.DecodeBool()) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + x.Value = "" + } else { + x.Value = string(r.DecodeString()) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + x.Nodes = nil + } else { + yyv37 := &x.Nodes + h.decSlicePtrtoNode((*[]*Node)(yyv37), d) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + x.CreatedIndex = 0 + } else { + x.CreatedIndex = uint64(r.DecodeUint(64)) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + x.ModifiedIndex = 0 + } else { + x.ModifiedIndex = uint64(r.DecodeUint(64)) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + if x.Expiration != nil { + x.Expiration = nil + } + } else { + if x.Expiration == nil { + x.Expiration = new(time.Time) + } + z.DecFallback(x.Expiration, false) + } + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + r.ReadArrayEnd() + return + } + r.ReadArrayEntrySeparator() + if r.TryDecodeAsNil() { + x.TTL = 0 + } else { + x.TTL = int64(r.DecodeInt(64)) + } + for { + yyj33++ + if yyhl33 { + yyb33 = yyj33 > l + } else { + yyb33 = r.CheckBreak() + } + if yyb33 { + break + } + if yyj33 > 1 { + r.ReadArrayEntrySeparator() + } + z.DecStructFieldNotFound(yyj33-1, "") + } + r.ReadArrayEnd() +} + +func (x codecSelfer5311) encSlicePtrtoNode(v []*Node, e *codec1978.Encoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperEncoder(e) + _, _, _ = h, z, r + r.EncodeArrayStart(len(v)) + yys42 := !z.EncBinary() + if yys42 { + for yyi42, yyv42 := range v { + if yyi42 > 0 { + r.EncodeArrayEntrySeparator() + } + if yyv42 == nil { + r.EncodeNil() + } else { + yyv42.CodecEncodeSelf(e) + } + } + r.EncodeArrayEnd() + } else { + for _, yyv42 := range v { + if yyv42 == nil { + r.EncodeNil() + } else { + yyv42.CodecEncodeSelf(e) + } + } + } +} + +func (x codecSelfer5311) decSlicePtrtoNode(v *[]*Node, d *codec1978.Decoder) { + var h codecSelfer5311 + z, r := codec1978.GenHelperDecoder(d) + _, _, _ = h, z, r + + yyv43 := *v + yyh43, yyl43 := z.DecSliceHelperStart() + + var yyc43 bool + _ = yyc43 + + if yyv43 == nil { + if yyl43 <= 0 { + yyv43 = make([]*Node, 0) + } else { + yyv43 = make([]*Node, yyl43) + } + yyc43 = true + } + + if yyl43 == 0 { + if len(yyv43) != 0 { + yyv43 = yyv43[:0] + yyc43 = true + } + } else if yyl43 > 0 { + + yyn43 := yyl43 + if yyl43 > cap(yyv43) { + yyv43 = make([]*Node, yyl43, yyl43) + yyc43 = true + + } else if yyl43 != len(yyv43) { + yyv43 = yyv43[:yyl43] + yyc43 = true + } + yyj43 := 0 + for ; yyj43 < yyn43; yyj43++ { + if r.TryDecodeAsNil() { + if yyv43[yyj43] != nil { + *yyv43[yyj43] = Node{} + } + } else { + if yyv43[yyj43] == nil { + yyv43[yyj43] = new(Node) + } + yyw44 := yyv43[yyj43] + yyw44.CodecDecodeSelf(d) + } + + } + + } else { + for yyj43 := 0; !r.CheckBreak(); yyj43++ { + if yyj43 >= len(yyv43) { + yyv43 = append(yyv43, nil) // var yyz43 *Node + yyc43 = true + } + if yyj43 > 0 { + yyh43.Sep(yyj43) + } + + if yyj43 < len(yyv43) { + if r.TryDecodeAsNil() { + if yyv43[yyj43] != nil { + *yyv43[yyj43] = Node{} + } + } else { + if yyv43[yyj43] == nil { + yyv43[yyj43] = new(Node) + } + yyw45 := yyv43[yyj43] + yyw45.CodecDecodeSelf(d) + } + + } else { + z.DecSwallow() + } + + } + yyh43.End() + } + if yyc43 { + *v = yyv43 + } + +} diff --git a/vendor/src/github.com/coreos/etcd/client/keys.go b/vendor/src/github.com/coreos/etcd/client/keys.go new file mode 100644 index 0000000000..bbf00a5c92 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/keys.go @@ -0,0 +1,644 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +//go:generate codecgen -r "Node|Response" -o keys.generated.go keys.go + +import ( + "encoding/json" + "errors" + "fmt" + "net/http" + "net/url" + "strconv" + "strings" + "time" + + "github.com/ugorji/go/codec" + "golang.org/x/net/context" + "github.com/coreos/etcd/pkg/pathutil" +) + +const ( + ErrorCodeKeyNotFound = 100 + ErrorCodeTestFailed = 101 + ErrorCodeNotFile = 102 + ErrorCodeNotDir = 104 + ErrorCodeNodeExist = 105 + ErrorCodeRootROnly = 107 + ErrorCodeDirNotEmpty = 108 + ErrorCodeUnauthorized = 110 + + ErrorCodePrevValueRequired = 201 + ErrorCodeTTLNaN = 202 + ErrorCodeIndexNaN = 203 + ErrorCodeInvalidField = 209 + ErrorCodeInvalidForm = 210 + + ErrorCodeRaftInternal = 300 + ErrorCodeLeaderElect = 301 + + ErrorCodeWatcherCleared = 400 + ErrorCodeEventIndexCleared = 401 +) + +type Error struct { + Code int `json:"errorCode"` + Message string `json:"message"` + Cause string `json:"cause"` + Index uint64 `json:"index"` +} + +func (e Error) Error() string { + return fmt.Sprintf("%v: %v (%v) [%v]", e.Code, e.Message, e.Cause, e.Index) +} + +var ( + ErrInvalidJSON = errors.New("client: response is invalid json. The endpoint is probably not valid etcd cluster endpoint.") + ErrEmptyBody = errors.New("client: response body is empty") +) + +// PrevExistType is used to define an existence condition when setting +// or deleting Nodes. +type PrevExistType string + +const ( + PrevIgnore = PrevExistType("") + PrevExist = PrevExistType("true") + PrevNoExist = PrevExistType("false") +) + +var ( + defaultV2KeysPrefix = "/v2/keys" +) + +// NewKeysAPI builds a KeysAPI that interacts with etcd's key-value +// API over HTTP. +func NewKeysAPI(c Client) KeysAPI { + return NewKeysAPIWithPrefix(c, defaultV2KeysPrefix) +} + +// NewKeysAPIWithPrefix acts like NewKeysAPI, but allows the caller +// to provide a custom base URL path. This should only be used in +// very rare cases. +func NewKeysAPIWithPrefix(c Client, p string) KeysAPI { + return &httpKeysAPI{ + client: c, + prefix: p, + } +} + +type KeysAPI interface { + // Get retrieves a set of Nodes from etcd + Get(ctx context.Context, key string, opts *GetOptions) (*Response, error) + + // Set assigns a new value to a Node identified by a given key. The caller + // may define a set of conditions in the SetOptions. If SetOptions.Dir=true + // than value is ignored. + Set(ctx context.Context, key, value string, opts *SetOptions) (*Response, error) + + // Delete removes a Node identified by the given key, optionally destroying + // all of its children as well. The caller may define a set of required + // conditions in an DeleteOptions object. + Delete(ctx context.Context, key string, opts *DeleteOptions) (*Response, error) + + // Create is an alias for Set w/ PrevExist=false + Create(ctx context.Context, key, value string) (*Response, error) + + // CreateInOrder is used to atomically create in-order keys within the given directory. + CreateInOrder(ctx context.Context, dir, value string, opts *CreateInOrderOptions) (*Response, error) + + // Update is an alias for Set w/ PrevExist=true + Update(ctx context.Context, key, value string) (*Response, error) + + // Watcher builds a new Watcher targeted at a specific Node identified + // by the given key. The Watcher may be configured at creation time + // through a WatcherOptions object. The returned Watcher is designed + // to emit events that happen to a Node, and optionally to its children. + Watcher(key string, opts *WatcherOptions) Watcher +} + +type WatcherOptions struct { + // AfterIndex defines the index after-which the Watcher should + // start emitting events. For example, if a value of 5 is + // provided, the first event will have an index >= 6. + // + // Setting AfterIndex to 0 (default) means that the Watcher + // should start watching for events starting at the current + // index, whatever that may be. + AfterIndex uint64 + + // Recursive specifies whether or not the Watcher should emit + // events that occur in children of the given keyspace. If set + // to false (default), events will be limited to those that + // occur for the exact key. + Recursive bool +} + +type CreateInOrderOptions struct { + // TTL defines a period of time after-which the Node should + // expire and no longer exist. Values <= 0 are ignored. Given + // that the zero-value is ignored, TTL cannot be used to set + // a TTL of 0. + TTL time.Duration +} + +type SetOptions struct { + // PrevValue specifies what the current value of the Node must + // be in order for the Set operation to succeed. + // + // Leaving this field empty means that the caller wishes to + // ignore the current value of the Node. This cannot be used + // to compare the Node's current value to an empty string. + // + // PrevValue is ignored if Dir=true + PrevValue string + + // PrevIndex indicates what the current ModifiedIndex of the + // Node must be in order for the Set operation to succeed. + // + // If PrevIndex is set to 0 (default), no comparison is made. + PrevIndex uint64 + + // PrevExist specifies whether the Node must currently exist + // (PrevExist) or not (PrevNoExist). If the caller does not + // care about existence, set PrevExist to PrevIgnore, or simply + // leave it unset. + PrevExist PrevExistType + + // TTL defines a period of time after-which the Node should + // expire and no longer exist. Values <= 0 are ignored. Given + // that the zero-value is ignored, TTL cannot be used to set + // a TTL of 0. + TTL time.Duration + + // Dir specifies whether or not this Node should be created as a directory. + Dir bool +} + +type GetOptions struct { + // Recursive defines whether or not all children of the Node + // should be returned. + Recursive bool + + // Sort instructs the server whether or not to sort the Nodes. + // If true, the Nodes are sorted alphabetically by key in + // ascending order (A to z). If false (default), the Nodes will + // not be sorted and the ordering used should not be considered + // predictable. + Sort bool + + // Quorum specifies whether it gets the latest committed value that + // has been applied in quorum of members, which ensures external + // consistency (or linearizability). + Quorum bool +} + +type DeleteOptions struct { + // PrevValue specifies what the current value of the Node must + // be in order for the Delete operation to succeed. + // + // Leaving this field empty means that the caller wishes to + // ignore the current value of the Node. This cannot be used + // to compare the Node's current value to an empty string. + PrevValue string + + // PrevIndex indicates what the current ModifiedIndex of the + // Node must be in order for the Delete operation to succeed. + // + // If PrevIndex is set to 0 (default), no comparison is made. + PrevIndex uint64 + + // Recursive defines whether or not all children of the Node + // should be deleted. If set to true, all children of the Node + // identified by the given key will be deleted. If left unset + // or explicitly set to false, only a single Node will be + // deleted. + Recursive bool + + // Dir specifies whether or not this Node should be removed as a directory. + Dir bool +} + +type Watcher interface { + // Next blocks until an etcd event occurs, then returns a Response + // represeting that event. The behavior of Next depends on the + // WatcherOptions used to construct the Watcher. Next is designed to + // be called repeatedly, each time blocking until a subsequent event + // is available. + // + // If the provided context is cancelled, Next will return a non-nil + // error. Any other failures encountered while waiting for the next + // event (connection issues, deserialization failures, etc) will + // also result in a non-nil error. + Next(context.Context) (*Response, error) +} + +type Response struct { + // Action is the name of the operation that occurred. Possible values + // include get, set, delete, update, create, compareAndSwap, + // compareAndDelete and expire. + Action string `json:"action"` + + // Node represents the state of the relevant etcd Node. + Node *Node `json:"node"` + + // PrevNode represents the previous state of the Node. PrevNode is non-nil + // only if the Node existed before the action occurred and the action + // caused a change to the Node. + PrevNode *Node `json:"prevNode"` + + // Index holds the cluster-level index at the time the Response was generated. + // This index is not tied to the Node(s) contained in this Response. + Index uint64 `json:"-"` +} + +type Node struct { + // Key represents the unique location of this Node (e.g. "/foo/bar"). + Key string `json:"key"` + + // Dir reports whether node describes a directory. + Dir bool `json:"dir,omitempty"` + + // Value is the current data stored on this Node. If this Node + // is a directory, Value will be empty. + Value string `json:"value"` + + // Nodes holds the children of this Node, only if this Node is a directory. + // This slice of will be arbitrarily deep (children, grandchildren, great- + // grandchildren, etc.) if a recursive Get or Watch request were made. + Nodes []*Node `json:"nodes"` + + // CreatedIndex is the etcd index at-which this Node was created. + CreatedIndex uint64 `json:"createdIndex"` + + // ModifiedIndex is the etcd index at-which this Node was last modified. + ModifiedIndex uint64 `json:"modifiedIndex"` + + // Expiration is the server side expiration time of the key. + Expiration *time.Time `json:"expiration,omitempty"` + + // TTL is the time to live of the key in second. + TTL int64 `json:"ttl,omitempty"` +} + +func (n *Node) String() string { + return fmt.Sprintf("{Key: %s, CreatedIndex: %d, ModifiedIndex: %d, TTL: %d}", n.Key, n.CreatedIndex, n.ModifiedIndex, n.TTL) +} + +// TTLDuration returns the Node's TTL as a time.Duration object +func (n *Node) TTLDuration() time.Duration { + return time.Duration(n.TTL) * time.Second +} + +type httpKeysAPI struct { + client httpClient + prefix string +} + +func (k *httpKeysAPI) Set(ctx context.Context, key, val string, opts *SetOptions) (*Response, error) { + act := &setAction{ + Prefix: k.prefix, + Key: key, + Value: val, + } + + if opts != nil { + act.PrevValue = opts.PrevValue + act.PrevIndex = opts.PrevIndex + act.PrevExist = opts.PrevExist + act.TTL = opts.TTL + act.Dir = opts.Dir + } + + resp, body, err := k.client.Do(ctx, act) + if err != nil { + return nil, err + } + + return unmarshalHTTPResponse(resp.StatusCode, resp.Header, body) +} + +func (k *httpKeysAPI) Create(ctx context.Context, key, val string) (*Response, error) { + return k.Set(ctx, key, val, &SetOptions{PrevExist: PrevNoExist}) +} + +func (k *httpKeysAPI) CreateInOrder(ctx context.Context, dir, val string, opts *CreateInOrderOptions) (*Response, error) { + act := &createInOrderAction{ + Prefix: k.prefix, + Dir: dir, + Value: val, + } + + if opts != nil { + act.TTL = opts.TTL + } + + resp, body, err := k.client.Do(ctx, act) + if err != nil { + return nil, err + } + + return unmarshalHTTPResponse(resp.StatusCode, resp.Header, body) +} + +func (k *httpKeysAPI) Update(ctx context.Context, key, val string) (*Response, error) { + return k.Set(ctx, key, val, &SetOptions{PrevExist: PrevExist}) +} + +func (k *httpKeysAPI) Delete(ctx context.Context, key string, opts *DeleteOptions) (*Response, error) { + act := &deleteAction{ + Prefix: k.prefix, + Key: key, + } + + if opts != nil { + act.PrevValue = opts.PrevValue + act.PrevIndex = opts.PrevIndex + act.Dir = opts.Dir + act.Recursive = opts.Recursive + } + + resp, body, err := k.client.Do(ctx, act) + if err != nil { + return nil, err + } + + return unmarshalHTTPResponse(resp.StatusCode, resp.Header, body) +} + +func (k *httpKeysAPI) Get(ctx context.Context, key string, opts *GetOptions) (*Response, error) { + act := &getAction{ + Prefix: k.prefix, + Key: key, + } + + if opts != nil { + act.Recursive = opts.Recursive + act.Sorted = opts.Sort + act.Quorum = opts.Quorum + } + + resp, body, err := k.client.Do(ctx, act) + if err != nil { + return nil, err + } + + return unmarshalHTTPResponse(resp.StatusCode, resp.Header, body) +} + +func (k *httpKeysAPI) Watcher(key string, opts *WatcherOptions) Watcher { + act := waitAction{ + Prefix: k.prefix, + Key: key, + } + + if opts != nil { + act.Recursive = opts.Recursive + if opts.AfterIndex > 0 { + act.WaitIndex = opts.AfterIndex + 1 + } + } + + return &httpWatcher{ + client: k.client, + nextWait: act, + } +} + +type httpWatcher struct { + client httpClient + nextWait waitAction +} + +func (hw *httpWatcher) Next(ctx context.Context) (*Response, error) { + for { + httpresp, body, err := hw.client.Do(ctx, &hw.nextWait) + if err != nil { + return nil, err + } + + resp, err := unmarshalHTTPResponse(httpresp.StatusCode, httpresp.Header, body) + if err != nil { + if err == ErrEmptyBody { + continue + } + return nil, err + } + + hw.nextWait.WaitIndex = resp.Node.ModifiedIndex + 1 + return resp, nil + } +} + +// v2KeysURL forms a URL representing the location of a key. +// The endpoint argument represents the base URL of an etcd +// server. The prefix is the path needed to route from the +// provided endpoint's path to the root of the keys API +// (typically "/v2/keys"). +func v2KeysURL(ep url.URL, prefix, key string) *url.URL { + // We concatenate all parts together manually. We cannot use + // path.Join because it does not reserve trailing slash. + // We call CanonicalURLPath to further cleanup the path. + if prefix != "" && prefix[0] != '/' { + prefix = "/" + prefix + } + if key != "" && key[0] != '/' { + key = "/" + key + } + ep.Path = pathutil.CanonicalURLPath(ep.Path + prefix + key) + return &ep +} + +type getAction struct { + Prefix string + Key string + Recursive bool + Sorted bool + Quorum bool +} + +func (g *getAction) HTTPRequest(ep url.URL) *http.Request { + u := v2KeysURL(ep, g.Prefix, g.Key) + + params := u.Query() + params.Set("recursive", strconv.FormatBool(g.Recursive)) + params.Set("sorted", strconv.FormatBool(g.Sorted)) + params.Set("quorum", strconv.FormatBool(g.Quorum)) + u.RawQuery = params.Encode() + + req, _ := http.NewRequest("GET", u.String(), nil) + return req +} + +type waitAction struct { + Prefix string + Key string + WaitIndex uint64 + Recursive bool +} + +func (w *waitAction) HTTPRequest(ep url.URL) *http.Request { + u := v2KeysURL(ep, w.Prefix, w.Key) + + params := u.Query() + params.Set("wait", "true") + params.Set("waitIndex", strconv.FormatUint(w.WaitIndex, 10)) + params.Set("recursive", strconv.FormatBool(w.Recursive)) + u.RawQuery = params.Encode() + + req, _ := http.NewRequest("GET", u.String(), nil) + return req +} + +type setAction struct { + Prefix string + Key string + Value string + PrevValue string + PrevIndex uint64 + PrevExist PrevExistType + TTL time.Duration + Dir bool +} + +func (a *setAction) HTTPRequest(ep url.URL) *http.Request { + u := v2KeysURL(ep, a.Prefix, a.Key) + + params := u.Query() + form := url.Values{} + + // we're either creating a directory or setting a key + if a.Dir { + params.Set("dir", strconv.FormatBool(a.Dir)) + } else { + // These options are only valid for setting a key + if a.PrevValue != "" { + params.Set("prevValue", a.PrevValue) + } + form.Add("value", a.Value) + } + + // Options which apply to both setting a key and creating a dir + if a.PrevIndex != 0 { + params.Set("prevIndex", strconv.FormatUint(a.PrevIndex, 10)) + } + if a.PrevExist != PrevIgnore { + params.Set("prevExist", string(a.PrevExist)) + } + if a.TTL > 0 { + form.Add("ttl", strconv.FormatUint(uint64(a.TTL.Seconds()), 10)) + } + + u.RawQuery = params.Encode() + body := strings.NewReader(form.Encode()) + + req, _ := http.NewRequest("PUT", u.String(), body) + req.Header.Set("Content-Type", "application/x-www-form-urlencoded") + + return req +} + +type deleteAction struct { + Prefix string + Key string + PrevValue string + PrevIndex uint64 + Dir bool + Recursive bool +} + +func (a *deleteAction) HTTPRequest(ep url.URL) *http.Request { + u := v2KeysURL(ep, a.Prefix, a.Key) + + params := u.Query() + if a.PrevValue != "" { + params.Set("prevValue", a.PrevValue) + } + if a.PrevIndex != 0 { + params.Set("prevIndex", strconv.FormatUint(a.PrevIndex, 10)) + } + if a.Dir { + params.Set("dir", "true") + } + if a.Recursive { + params.Set("recursive", "true") + } + u.RawQuery = params.Encode() + + req, _ := http.NewRequest("DELETE", u.String(), nil) + req.Header.Set("Content-Type", "application/x-www-form-urlencoded") + + return req +} + +type createInOrderAction struct { + Prefix string + Dir string + Value string + TTL time.Duration +} + +func (a *createInOrderAction) HTTPRequest(ep url.URL) *http.Request { + u := v2KeysURL(ep, a.Prefix, a.Dir) + + form := url.Values{} + form.Add("value", a.Value) + if a.TTL > 0 { + form.Add("ttl", strconv.FormatUint(uint64(a.TTL.Seconds()), 10)) + } + body := strings.NewReader(form.Encode()) + + req, _ := http.NewRequest("POST", u.String(), body) + req.Header.Set("Content-Type", "application/x-www-form-urlencoded") + return req +} + +func unmarshalHTTPResponse(code int, header http.Header, body []byte) (res *Response, err error) { + switch code { + case http.StatusOK, http.StatusCreated: + if len(body) == 0 { + return nil, ErrEmptyBody + } + res, err = unmarshalSuccessfulKeysResponse(header, body) + default: + err = unmarshalFailedKeysResponse(body) + } + + return +} + +func unmarshalSuccessfulKeysResponse(header http.Header, body []byte) (*Response, error) { + var res Response + err := codec.NewDecoderBytes(body, new(codec.JsonHandle)).Decode(&res) + if err != nil { + return nil, ErrInvalidJSON + } + if header.Get("X-Etcd-Index") != "" { + res.Index, err = strconv.ParseUint(header.Get("X-Etcd-Index"), 10, 64) + if err != nil { + return nil, err + } + } + return &res, nil +} + +func unmarshalFailedKeysResponse(body []byte) error { + var etcdErr Error + if err := json.Unmarshal(body, &etcdErr); err != nil { + return ErrInvalidJSON + } + return etcdErr +} diff --git a/vendor/src/github.com/coreos/etcd/client/members.go b/vendor/src/github.com/coreos/etcd/client/members.go new file mode 100644 index 0000000000..c1c78409ad --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/members.go @@ -0,0 +1,272 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import ( + "bytes" + "encoding/json" + "fmt" + "net/http" + "net/url" + "path" + + "golang.org/x/net/context" + + "github.com/coreos/etcd/pkg/types" +) + +var ( + defaultV2MembersPrefix = "/v2/members" +) + +type Member struct { + // ID is the unique identifier of this Member. + ID string `json:"id"` + + // Name is a human-readable, non-unique identifier of this Member. + Name string `json:"name"` + + // PeerURLs represents the HTTP(S) endpoints this Member uses to + // participate in etcd's consensus protocol. + PeerURLs []string `json:"peerURLs"` + + // ClientURLs represents the HTTP(S) endpoints on which this Member + // serves it's client-facing APIs. + ClientURLs []string `json:"clientURLs"` +} + +type memberCollection []Member + +func (c *memberCollection) UnmarshalJSON(data []byte) error { + d := struct { + Members []Member + }{} + + if err := json.Unmarshal(data, &d); err != nil { + return err + } + + if d.Members == nil { + *c = make([]Member, 0) + return nil + } + + *c = d.Members + return nil +} + +type memberCreateOrUpdateRequest struct { + PeerURLs types.URLs +} + +func (m *memberCreateOrUpdateRequest) MarshalJSON() ([]byte, error) { + s := struct { + PeerURLs []string `json:"peerURLs"` + }{ + PeerURLs: make([]string, len(m.PeerURLs)), + } + + for i, u := range m.PeerURLs { + s.PeerURLs[i] = u.String() + } + + return json.Marshal(&s) +} + +// NewMembersAPI constructs a new MembersAPI that uses HTTP to +// interact with etcd's membership API. +func NewMembersAPI(c Client) MembersAPI { + return &httpMembersAPI{ + client: c, + } +} + +type MembersAPI interface { + // List enumerates the current cluster membership. + List(ctx context.Context) ([]Member, error) + + // Add instructs etcd to accept a new Member into the cluster. + Add(ctx context.Context, peerURL string) (*Member, error) + + // Remove demotes an existing Member out of the cluster. + Remove(ctx context.Context, mID string) error + + // Update instructs etcd to update an existing Member in the cluster. + Update(ctx context.Context, mID string, peerURLs []string) error +} + +type httpMembersAPI struct { + client httpClient +} + +func (m *httpMembersAPI) List(ctx context.Context) ([]Member, error) { + req := &membersAPIActionList{} + resp, body, err := m.client.Do(ctx, req) + if err != nil { + return nil, err + } + + if err := assertStatusCode(resp.StatusCode, http.StatusOK); err != nil { + return nil, err + } + + var mCollection memberCollection + if err := json.Unmarshal(body, &mCollection); err != nil { + return nil, err + } + + return []Member(mCollection), nil +} + +func (m *httpMembersAPI) Add(ctx context.Context, peerURL string) (*Member, error) { + urls, err := types.NewURLs([]string{peerURL}) + if err != nil { + return nil, err + } + + req := &membersAPIActionAdd{peerURLs: urls} + resp, body, err := m.client.Do(ctx, req) + if err != nil { + return nil, err + } + + if err := assertStatusCode(resp.StatusCode, http.StatusCreated, http.StatusConflict); err != nil { + return nil, err + } + + if resp.StatusCode != http.StatusCreated { + var merr membersError + if err := json.Unmarshal(body, &merr); err != nil { + return nil, err + } + return nil, merr + } + + var memb Member + if err := json.Unmarshal(body, &memb); err != nil { + return nil, err + } + + return &memb, nil +} + +func (m *httpMembersAPI) Update(ctx context.Context, memberID string, peerURLs []string) error { + urls, err := types.NewURLs(peerURLs) + if err != nil { + return err + } + + req := &membersAPIActionUpdate{peerURLs: urls, memberID: memberID} + resp, body, err := m.client.Do(ctx, req) + if err != nil { + return err + } + + if err := assertStatusCode(resp.StatusCode, http.StatusNoContent, http.StatusNotFound, http.StatusConflict); err != nil { + return err + } + + if resp.StatusCode != http.StatusNoContent { + var merr membersError + if err := json.Unmarshal(body, &merr); err != nil { + return err + } + return merr + } + + return nil +} + +func (m *httpMembersAPI) Remove(ctx context.Context, memberID string) error { + req := &membersAPIActionRemove{memberID: memberID} + resp, _, err := m.client.Do(ctx, req) + if err != nil { + return err + } + + return assertStatusCode(resp.StatusCode, http.StatusNoContent, http.StatusGone) +} + +type membersAPIActionList struct{} + +func (l *membersAPIActionList) HTTPRequest(ep url.URL) *http.Request { + u := v2MembersURL(ep) + req, _ := http.NewRequest("GET", u.String(), nil) + return req +} + +type membersAPIActionRemove struct { + memberID string +} + +func (d *membersAPIActionRemove) HTTPRequest(ep url.URL) *http.Request { + u := v2MembersURL(ep) + u.Path = path.Join(u.Path, d.memberID) + req, _ := http.NewRequest("DELETE", u.String(), nil) + return req +} + +type membersAPIActionAdd struct { + peerURLs types.URLs +} + +func (a *membersAPIActionAdd) HTTPRequest(ep url.URL) *http.Request { + u := v2MembersURL(ep) + m := memberCreateOrUpdateRequest{PeerURLs: a.peerURLs} + b, _ := json.Marshal(&m) + req, _ := http.NewRequest("POST", u.String(), bytes.NewReader(b)) + req.Header.Set("Content-Type", "application/json") + return req +} + +type membersAPIActionUpdate struct { + memberID string + peerURLs types.URLs +} + +func (a *membersAPIActionUpdate) HTTPRequest(ep url.URL) *http.Request { + u := v2MembersURL(ep) + m := memberCreateOrUpdateRequest{PeerURLs: a.peerURLs} + u.Path = path.Join(u.Path, a.memberID) + b, _ := json.Marshal(&m) + req, _ := http.NewRequest("PUT", u.String(), bytes.NewReader(b)) + req.Header.Set("Content-Type", "application/json") + return req +} + +func assertStatusCode(got int, want ...int) (err error) { + for _, w := range want { + if w == got { + return nil + } + } + return fmt.Errorf("unexpected status code %d", got) +} + +// v2MembersURL add the necessary path to the provided endpoint +// to route requests to the default v2 members API. +func v2MembersURL(ep url.URL) *url.URL { + ep.Path = path.Join(ep.Path, defaultV2MembersPrefix) + return &ep +} + +type membersError struct { + Message string `json:"message"` + Code int `json:"-"` +} + +func (e membersError) Error() string { + return e.Message +} diff --git a/vendor/src/github.com/coreos/etcd/client/srv.go b/vendor/src/github.com/coreos/etcd/client/srv.go new file mode 100644 index 0000000000..f74c1220b4 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/client/srv.go @@ -0,0 +1,65 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package client + +import ( + "fmt" + "net" + "net/url" +) + +var ( + // indirection for testing + lookupSRV = net.LookupSRV +) + +type srvDiscover struct{} + +// NewSRVDiscover constructs a new Dicoverer that uses the stdlib to lookup SRV records. +func NewSRVDiscover() Discoverer { + return &srvDiscover{} +} + +// Discover looks up the etcd servers for the domain. +func (d *srvDiscover) Discover(domain string) ([]string, error) { + var urls []*url.URL + + updateURLs := func(service, scheme string) error { + _, addrs, err := lookupSRV(service, "tcp", domain) + if err != nil { + return err + } + for _, srv := range addrs { + urls = append(urls, &url.URL{ + Scheme: scheme, + Host: net.JoinHostPort(srv.Target, fmt.Sprintf("%d", srv.Port)), + }) + } + return nil + } + + errHTTPS := updateURLs("etcd-server-ssl", "https") + errHTTP := updateURLs("etcd-server", "http") + + if errHTTPS != nil && errHTTP != nil { + return nil, fmt.Errorf("dns lookup errors: %s and %s", errHTTPS, errHTTP) + } + + endpoints := make([]string, len(urls)) + for i := range urls { + endpoints[i] = urls[i].String() + } + return endpoints, nil +} diff --git a/vendor/src/github.com/coreos/etcd/pkg/pathutil/path.go b/vendor/src/github.com/coreos/etcd/pkg/pathutil/path.go new file mode 100644 index 0000000000..82fd1db397 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/pkg/pathutil/path.go @@ -0,0 +1,29 @@ +// Copyright 2009 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package pathutil + +import "path" + +// CanonicalURLPath returns the canonical url path for p, which follows the rules: +// 1. the path always starts with "/" +// 2. replace multiple slashes with a single slash +// 3. replace each '.' '..' path name element with equivalent one +// 4. keep the trailing slash +// The function is borrowed from stdlib http.cleanPath in server.go. +func CanonicalURLPath(p string) string { + if p == "" { + return "/" + } + if p[0] != '/' { + p = "/" + p + } + np := path.Clean(p) + // path.Clean removes trailing slash except for root, + // put the trailing slash back if necessary. + if p[len(p)-1] == '/' && np != "/" { + np += "/" + } + return np +} diff --git a/vendor/src/github.com/coreos/etcd/pkg/types/id.go b/vendor/src/github.com/coreos/etcd/pkg/types/id.go new file mode 100644 index 0000000000..88cb9e6349 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/pkg/types/id.go @@ -0,0 +1,41 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package types + +import ( + "strconv" +) + +// ID represents a generic identifier which is canonically +// stored as a uint64 but is typically represented as a +// base-16 string for input/output +type ID uint64 + +func (i ID) String() string { + return strconv.FormatUint(uint64(i), 16) +} + +// IDFromString attempts to create an ID from a base-16 string. +func IDFromString(s string) (ID, error) { + i, err := strconv.ParseUint(s, 16, 64) + return ID(i), err +} + +// IDSlice implements the sort interface +type IDSlice []ID + +func (p IDSlice) Len() int { return len(p) } +func (p IDSlice) Less(i, j int) bool { return uint64(p[i]) < uint64(p[j]) } +func (p IDSlice) Swap(i, j int) { p[i], p[j] = p[j], p[i] } diff --git a/vendor/src/github.com/coreos/etcd/pkg/types/set.go b/vendor/src/github.com/coreos/etcd/pkg/types/set.go new file mode 100644 index 0000000000..bb997174c7 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/pkg/types/set.go @@ -0,0 +1,178 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package types + +import ( + "reflect" + "sort" + "sync" +) + +type Set interface { + Add(string) + Remove(string) + Contains(string) bool + Equals(Set) bool + Length() int + Values() []string + Copy() Set + Sub(Set) Set +} + +func NewUnsafeSet(values ...string) *unsafeSet { + set := &unsafeSet{make(map[string]struct{})} + for _, v := range values { + set.Add(v) + } + return set +} + +func NewThreadsafeSet(values ...string) *tsafeSet { + us := NewUnsafeSet(values...) + return &tsafeSet{us, sync.RWMutex{}} +} + +type unsafeSet struct { + d map[string]struct{} +} + +// Add adds a new value to the set (no-op if the value is already present) +func (us *unsafeSet) Add(value string) { + us.d[value] = struct{}{} +} + +// Remove removes the given value from the set +func (us *unsafeSet) Remove(value string) { + delete(us.d, value) +} + +// Contains returns whether the set contains the given value +func (us *unsafeSet) Contains(value string) (exists bool) { + _, exists = us.d[value] + return +} + +// ContainsAll returns whether the set contains all given values +func (us *unsafeSet) ContainsAll(values []string) bool { + for _, s := range values { + if !us.Contains(s) { + return false + } + } + return true +} + +// Equals returns whether the contents of two sets are identical +func (us *unsafeSet) Equals(other Set) bool { + v1 := sort.StringSlice(us.Values()) + v2 := sort.StringSlice(other.Values()) + v1.Sort() + v2.Sort() + return reflect.DeepEqual(v1, v2) +} + +// Length returns the number of elements in the set +func (us *unsafeSet) Length() int { + return len(us.d) +} + +// Values returns the values of the Set in an unspecified order. +func (us *unsafeSet) Values() (values []string) { + values = make([]string, 0) + for val := range us.d { + values = append(values, val) + } + return +} + +// Copy creates a new Set containing the values of the first +func (us *unsafeSet) Copy() Set { + cp := NewUnsafeSet() + for val := range us.d { + cp.Add(val) + } + + return cp +} + +// Sub removes all elements in other from the set +func (us *unsafeSet) Sub(other Set) Set { + oValues := other.Values() + result := us.Copy().(*unsafeSet) + + for _, val := range oValues { + if _, ok := result.d[val]; !ok { + continue + } + delete(result.d, val) + } + + return result +} + +type tsafeSet struct { + us *unsafeSet + m sync.RWMutex +} + +func (ts *tsafeSet) Add(value string) { + ts.m.Lock() + defer ts.m.Unlock() + ts.us.Add(value) +} + +func (ts *tsafeSet) Remove(value string) { + ts.m.Lock() + defer ts.m.Unlock() + ts.us.Remove(value) +} + +func (ts *tsafeSet) Contains(value string) (exists bool) { + ts.m.RLock() + defer ts.m.RUnlock() + return ts.us.Contains(value) +} + +func (ts *tsafeSet) Equals(other Set) bool { + ts.m.RLock() + defer ts.m.RUnlock() + return ts.us.Equals(other) +} + +func (ts *tsafeSet) Length() int { + ts.m.RLock() + defer ts.m.RUnlock() + return ts.us.Length() +} + +func (ts *tsafeSet) Values() (values []string) { + ts.m.RLock() + defer ts.m.RUnlock() + return ts.us.Values() +} + +func (ts *tsafeSet) Copy() Set { + ts.m.RLock() + defer ts.m.RUnlock() + usResult := ts.us.Copy().(*unsafeSet) + return &tsafeSet{usResult, sync.RWMutex{}} +} + +func (ts *tsafeSet) Sub(other Set) Set { + ts.m.RLock() + defer ts.m.RUnlock() + usResult := ts.us.Sub(other).(*unsafeSet) + return &tsafeSet{usResult, sync.RWMutex{}} +} diff --git a/vendor/src/github.com/coreos/etcd/pkg/types/slice.go b/vendor/src/github.com/coreos/etcd/pkg/types/slice.go new file mode 100644 index 0000000000..0327950f70 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/pkg/types/slice.go @@ -0,0 +1,22 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package types + +// Uint64Slice implements sort interface +type Uint64Slice []uint64 + +func (p Uint64Slice) Len() int { return len(p) } +func (p Uint64Slice) Less(i, j int) bool { return p[i] < p[j] } +func (p Uint64Slice) Swap(i, j int) { p[i], p[j] = p[j], p[i] } diff --git a/vendor/src/github.com/coreos/etcd/pkg/types/urls.go b/vendor/src/github.com/coreos/etcd/pkg/types/urls.go new file mode 100644 index 0000000000..ce2483ffaa --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/pkg/types/urls.go @@ -0,0 +1,74 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package types + +import ( + "errors" + "fmt" + "net" + "net/url" + "sort" + "strings" +) + +type URLs []url.URL + +func NewURLs(strs []string) (URLs, error) { + all := make([]url.URL, len(strs)) + if len(all) == 0 { + return nil, errors.New("no valid URLs given") + } + for i, in := range strs { + in = strings.TrimSpace(in) + u, err := url.Parse(in) + if err != nil { + return nil, err + } + if u.Scheme != "http" && u.Scheme != "https" { + return nil, fmt.Errorf("URL scheme must be http or https: %s", in) + } + if _, _, err := net.SplitHostPort(u.Host); err != nil { + return nil, fmt.Errorf(`URL address does not have the form "host:port": %s`, in) + } + if u.Path != "" { + return nil, fmt.Errorf("URL must not contain a path: %s", in) + } + all[i] = *u + } + us := URLs(all) + us.Sort() + + return us, nil +} + +func (us URLs) String() string { + return strings.Join(us.StringSlice(), ",") +} + +func (us *URLs) Sort() { + sort.Sort(us) +} +func (us URLs) Len() int { return len(us) } +func (us URLs) Less(i, j int) bool { return us[i].String() < us[j].String() } +func (us URLs) Swap(i, j int) { us[i], us[j] = us[j], us[i] } + +func (us URLs) StringSlice() []string { + out := make([]string, len(us)) + for i := range us { + out[i] = us[i].String() + } + + return out +} diff --git a/vendor/src/github.com/coreos/etcd/pkg/types/urlsmap.go b/vendor/src/github.com/coreos/etcd/pkg/types/urlsmap.go new file mode 100644 index 0000000000..a2aa7fe660 --- /dev/null +++ b/vendor/src/github.com/coreos/etcd/pkg/types/urlsmap.go @@ -0,0 +1,75 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package types + +import ( + "fmt" + "net/url" + "sort" + "strings" +) + +type URLsMap map[string]URLs + +// NewURLsMap returns a URLsMap instantiated from the given string, +// which consists of discovery-formatted names-to-URLs, like: +// mach0=http://1.1.1.1:2380,mach0=http://2.2.2.2::2380,mach1=http://3.3.3.3:2380,mach2=http://4.4.4.4:2380 +func NewURLsMap(s string) (URLsMap, error) { + cl := URLsMap{} + v, err := url.ParseQuery(strings.Replace(s, ",", "&", -1)) + if err != nil { + return nil, err + } + for name, urls := range v { + if len(urls) == 0 || urls[0] == "" { + return nil, fmt.Errorf("empty URL given for %q", name) + } + us, err := NewURLs(urls) + if err != nil { + return nil, err + } + cl[name] = us + } + return cl, nil +} + +// String returns NameURLPairs into discovery-formatted name-to-URLs sorted by name. +func (c URLsMap) String() string { + pairs := make([]string, 0) + for name, urls := range c { + for _, url := range urls { + pairs = append(pairs, fmt.Sprintf("%s=%s", name, url.String())) + } + } + sort.Strings(pairs) + return strings.Join(pairs, ",") +} + +// URLs returns a list of all URLs. +// The returned list is sorted in ascending lexicographical order. +func (c URLsMap) URLs() []string { + urls := make([]string, 0) + for _, us := range c { + for _, u := range us { + urls = append(urls, u.String()) + } + } + sort.Strings(urls) + return urls +} + +func (c URLsMap) Len() int { + return len(c) +} diff --git a/vendor/src/github.com/coreos/go-systemd/LICENSE b/vendor/src/github.com/coreos/go-systemd/LICENSE new file mode 100644 index 0000000000..37ec93a14f --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/LICENSE @@ -0,0 +1,191 @@ +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, and +distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by the copyright +owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all other entities +that control, are controlled by, or are under common control with that entity. +For the purposes of this definition, "control" means (i) the power, direct or +indirect, to cause the direction or management of such entity, whether by +contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity exercising +permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, including +but not limited to software source code, documentation source, and configuration +files. + +"Object" form shall mean any form resulting from mechanical transformation or +translation of a Source form, including but not limited to compiled object code, +generated documentation, and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or Object form, made +available under the License, as indicated by a copyright notice that is included +in or attached to the work (an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object form, that +is based on (or derived from) the Work and for which the editorial revisions, +annotations, elaborations, or other modifications represent, as a whole, an +original work of authorship. For the purposes of this License, Derivative Works +shall not include works that remain separable from, or merely link (or bind by +name) to the interfaces of, the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including the original version +of the Work and any modifications or additions to that Work or Derivative Works +thereof, that is intentionally submitted to Licensor for inclusion in the Work +by the copyright owner or by an individual or Legal Entity authorized to submit +on behalf of the copyright owner. For the purposes of this definition, +"submitted" means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, and +issue tracking systems that are managed by, or on behalf of, the Licensor for +the purpose of discussing and improving the Work, but excluding communication +that is conspicuously marked or otherwise designated in writing by the copyright +owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity on behalf +of whom a Contribution has been received by Licensor and subsequently +incorporated within the Work. + +2. Grant of Copyright License. + +Subject to the terms and conditions of this License, each Contributor hereby +grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, +irrevocable copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the Work and such +Derivative Works in Source or Object form. + +3. Grant of Patent License. + +Subject to the terms and conditions of this License, each Contributor hereby +grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, +irrevocable (except as stated in this section) patent license to make, have +made, use, offer to sell, sell, import, and otherwise transfer the Work, where +such license applies only to those patent claims licensable by such Contributor +that are necessarily infringed by their Contribution(s) alone or by combination +of their Contribution(s) with the Work to which such Contribution(s) was +submitted. If You institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work or a +Contribution incorporated within the Work constitutes direct or contributory +patent infringement, then any patent licenses granted to You under this License +for that Work shall terminate as of the date such litigation is filed. + +4. Redistribution. + +You may reproduce and distribute copies of the Work or Derivative Works thereof +in any medium, with or without modifications, and in Source or Object form, +provided that You meet the following conditions: + +You must give any other recipients of the Work or Derivative Works a copy of +this License; and +You must cause any modified files to carry prominent notices stating that You +changed the files; and +You must retain, in the Source form of any Derivative Works that You distribute, +all copyright, patent, trademark, and attribution notices from the Source form +of the Work, excluding those notices that do not pertain to any part of the +Derivative Works; and +If the Work includes a "NOTICE" text file as part of its distribution, then any +Derivative Works that You distribute must include a readable copy of the +attribution notices contained within such NOTICE file, excluding those notices +that do not pertain to any part of the Derivative Works, in at least one of the +following places: within a NOTICE text file distributed as part of the +Derivative Works; within the Source form or documentation, if provided along +with the Derivative Works; or, within a display generated by the Derivative +Works, if and wherever such third-party notices normally appear. The contents of +the NOTICE file are for informational purposes only and do not modify the +License. You may add Your own attribution notices within Derivative Works that +You distribute, alongside or as an addendum to the NOTICE text from the Work, +provided that such additional attribution notices cannot be construed as +modifying the License. +You may add Your own copyright statement to Your modifications and may provide +additional or different license terms and conditions for use, reproduction, or +distribution of Your modifications, or for any such Derivative Works as a whole, +provided Your use, reproduction, and distribution of the Work otherwise complies +with the conditions stated in this License. + +5. Submission of Contributions. + +Unless You explicitly state otherwise, any Contribution intentionally submitted +for inclusion in the Work by You to the Licensor shall be under the terms and +conditions of this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify the terms of +any separate license agreement you may have executed with Licensor regarding +such Contributions. + +6. Trademarks. + +This License does not grant permission to use the trade names, trademarks, +service marks, or product names of the Licensor, except as required for +reasonable and customary use in describing the origin of the Work and +reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. + +Unless required by applicable law or agreed to in writing, Licensor provides the +Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, +including, without limitation, any warranties or conditions of TITLE, +NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are +solely responsible for determining the appropriateness of using or +redistributing the Work and assume any risks associated with Your exercise of +permissions under this License. + +8. Limitation of Liability. + +In no event and under no legal theory, whether in tort (including negligence), +contract, or otherwise, unless required by applicable law (such as deliberate +and grossly negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, incidental, +or consequential damages of any character arising as a result of this License or +out of the use or inability to use the Work (including but not limited to +damages for loss of goodwill, work stoppage, computer failure or malfunction, or +any and all other commercial damages or losses), even if such Contributor has +been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. + +While redistributing the Work or Derivative Works thereof, You may choose to +offer, and charge a fee for, acceptance of support, warranty, indemnity, or +other liability obligations and/or rights consistent with this License. However, +in accepting such obligations, You may act only on Your own behalf and on Your +sole responsibility, not on behalf of any other Contributor, and only if You +agree to indemnify, defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason of your +accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work + +To apply the Apache License to your work, attach the following boilerplate +notice, with the fields enclosed by brackets "[]" replaced with your own +identifying information. (Don't include the brackets!) The text should be +enclosed in the appropriate comment syntax for the file format. We also +recommend that a file or class name and description of purpose be included on +the same "printed page" as the copyright notice for easier identification within +third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/vendor/src/github.com/coreos/go-systemd/activation/files.go b/vendor/src/github.com/coreos/go-systemd/activation/files.go new file mode 100644 index 0000000000..c8e85fcd58 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/activation/files.go @@ -0,0 +1,52 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Package activation implements primitives for systemd socket activation. +package activation + +import ( + "os" + "strconv" + "syscall" +) + +// based on: https://gist.github.com/alberts/4640792 +const ( + listenFdsStart = 3 +) + +func Files(unsetEnv bool) []*os.File { + if unsetEnv { + defer os.Unsetenv("LISTEN_PID") + defer os.Unsetenv("LISTEN_FDS") + } + + pid, err := strconv.Atoi(os.Getenv("LISTEN_PID")) + if err != nil || pid != os.Getpid() { + return nil + } + + nfds, err := strconv.Atoi(os.Getenv("LISTEN_FDS")) + if err != nil || nfds == 0 { + return nil + } + + files := make([]*os.File, 0, nfds) + for fd := listenFdsStart; fd < listenFdsStart+nfds; fd++ { + syscall.CloseOnExec(fd) + files = append(files, os.NewFile(uintptr(fd), "LISTEN_FD_"+strconv.Itoa(fd))) + } + + return files +} diff --git a/vendor/src/github.com/coreos/go-systemd/activation/listeners.go b/vendor/src/github.com/coreos/go-systemd/activation/listeners.go new file mode 100644 index 0000000000..a30cb89395 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/activation/listeners.go @@ -0,0 +1,37 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package activation + +import ( + "net" +) + +// Listeners returns a slice containing a net.Listener for each matching socket type +// passed to this process. +// +// The order of the file descriptors is preserved in the returned slice. +// Nil values are used to fill any gaps. For example if systemd were to return file descriptors +// corresponding with "udp, tcp, tcp", then the slice would contain {nil, net.Listener, net.Listener} +func Listeners(unsetEnv bool) ([]net.Listener, error) { + files := Files(unsetEnv) + listeners := make([]net.Listener, len(files)) + + for i, f := range files { + if pc, err := net.FileListener(f); err == nil { + listeners[i] = pc + } + } + return listeners, nil +} diff --git a/vendor/src/github.com/coreos/go-systemd/activation/packetconns.go b/vendor/src/github.com/coreos/go-systemd/activation/packetconns.go new file mode 100644 index 0000000000..48b2ca029d --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/activation/packetconns.go @@ -0,0 +1,37 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package activation + +import ( + "net" +) + +// PacketConns returns a slice containing a net.PacketConn for each matching socket type +// passed to this process. +// +// The order of the file descriptors is preserved in the returned slice. +// Nil values are used to fill any gaps. For example if systemd were to return file descriptors +// corresponding with "udp, tcp, udp", then the slice would contain {net.PacketConn, nil, net.PacketConn} +func PacketConns(unsetEnv bool) ([]net.PacketConn, error) { + files := Files(unsetEnv) + conns := make([]net.PacketConn, len(files)) + + for i, f := range files { + if pc, err := net.FilePacketConn(f); err == nil { + conns[i] = pc + } + } + return conns, nil +} diff --git a/vendor/src/github.com/coreos/go-systemd/daemon/sdnotify.go b/vendor/src/github.com/coreos/go-systemd/daemon/sdnotify.go new file mode 100644 index 0000000000..b92b1911c1 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/daemon/sdnotify.go @@ -0,0 +1,31 @@ +// Code forked from Docker project +package daemon + +import ( + "errors" + "net" + "os" +) + +var SdNotifyNoSocket = errors.New("No socket") + +// SdNotify sends a message to the init daemon. It is common to ignore the error. +func SdNotify(state string) error { + socketAddr := &net.UnixAddr{ + Name: os.Getenv("NOTIFY_SOCKET"), + Net: "unixgram", + } + + if socketAddr.Name == "" { + return SdNotifyNoSocket + } + + conn, err := net.DialUnix(socketAddr.Net, nil, socketAddr) + if err != nil { + return err + } + defer conn.Close() + + _, err = conn.Write([]byte(state)) + return err +} diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/dbus.go b/vendor/src/github.com/coreos/go-systemd/dbus/dbus.go new file mode 100644 index 0000000000..625a32b8e6 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/dbus/dbus.go @@ -0,0 +1,163 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Integration with the systemd D-Bus API. See http://www.freedesktop.org/wiki/Software/systemd/dbus/ +package dbus + +import ( + "fmt" + "os" + "strconv" + "strings" + "sync" + + "github.com/godbus/dbus" +) + +const ( + alpha = `abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ` + num = `0123456789` + alphanum = alpha + num + signalBuffer = 100 +) + +// needsEscape checks whether a byte in a potential dbus ObjectPath needs to be escaped +func needsEscape(i int, b byte) bool { + // Escape everything that is not a-z-A-Z-0-9 + // Also escape 0-9 if it's the first character + return strings.IndexByte(alphanum, b) == -1 || + (i == 0 && strings.IndexByte(num, b) != -1) +} + +// PathBusEscape sanitizes a constituent string of a dbus ObjectPath using the +// rules that systemd uses for serializing special characters. +func PathBusEscape(path string) string { + // Special case the empty string + if len(path) == 0 { + return "_" + } + n := []byte{} + for i := 0; i < len(path); i++ { + c := path[i] + if needsEscape(i, c) { + e := fmt.Sprintf("_%x", c) + n = append(n, []byte(e)...) + } else { + n = append(n, c) + } + } + return string(n) +} + +// Conn is a connection to systemd's dbus endpoint. +type Conn struct { + // sysconn/sysobj are only used to call dbus methods + sysconn *dbus.Conn + sysobj *dbus.Object + + // sigconn/sigobj are only used to receive dbus signals + sigconn *dbus.Conn + sigobj *dbus.Object + + jobListener struct { + jobs map[dbus.ObjectPath]chan<- string + sync.Mutex + } + subscriber struct { + updateCh chan<- *SubStateUpdate + errCh chan<- error + sync.Mutex + ignore map[dbus.ObjectPath]int64 + cleanIgnore int64 + } +} + +// New establishes a connection to the system bus and authenticates. +// Callers should call Close() when done with the connection. +func New() (*Conn, error) { + return newConnection(dbus.SystemBusPrivate) +} + +// NewUserConnection establishes a connection to the session bus and +// authenticates. This can be used to connect to systemd user instances. +// Callers should call Close() when done with the connection. +func NewUserConnection() (*Conn, error) { + return newConnection(dbus.SessionBusPrivate) +} + +// Close closes an established connection +func (c *Conn) Close() { + c.sysconn.Close() + c.sigconn.Close() +} + +func newConnection(createBus func() (*dbus.Conn, error)) (*Conn, error) { + sysconn, err := dbusConnection(createBus) + if err != nil { + return nil, err + } + + sigconn, err := dbusConnection(createBus) + if err != nil { + sysconn.Close() + return nil, err + } + + c := &Conn{ + sysconn: sysconn, + sysobj: systemdObject(sysconn), + sigconn: sigconn, + sigobj: systemdObject(sigconn), + } + + c.subscriber.ignore = make(map[dbus.ObjectPath]int64) + c.jobListener.jobs = make(map[dbus.ObjectPath]chan<- string) + + // Setup the listeners on jobs so that we can get completions + c.sigconn.BusObject().Call("org.freedesktop.DBus.AddMatch", 0, + "type='signal', interface='org.freedesktop.systemd1.Manager', member='JobRemoved'") + + c.dispatch() + return c, nil +} + +func dbusConnection(createBus func() (*dbus.Conn, error)) (*dbus.Conn, error) { + conn, err := createBus() + if err != nil { + return nil, err + } + + // Only use EXTERNAL method, and hardcode the uid (not username) + // to avoid a username lookup (which requires a dynamically linked + // libc) + methods := []dbus.Auth{dbus.AuthExternal(strconv.Itoa(os.Getuid()))} + + err = conn.Auth(methods) + if err != nil { + conn.Close() + return nil, err + } + + err = conn.Hello() + if err != nil { + conn.Close() + return nil, err + } + + return conn, nil +} + +func systemdObject(conn *dbus.Conn) *dbus.Object { + return conn.Object("org.freedesktop.systemd1", dbus.ObjectPath("/org/freedesktop/systemd1")) +} diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/methods.go b/vendor/src/github.com/coreos/go-systemd/dbus/methods.go new file mode 100644 index 0000000000..ab614c7c63 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/dbus/methods.go @@ -0,0 +1,410 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package dbus + +import ( + "errors" + "path" + "strconv" + + "github.com/godbus/dbus" +) + +func (c *Conn) jobComplete(signal *dbus.Signal) { + var id uint32 + var job dbus.ObjectPath + var unit string + var result string + dbus.Store(signal.Body, &id, &job, &unit, &result) + c.jobListener.Lock() + out, ok := c.jobListener.jobs[job] + if ok { + out <- result + delete(c.jobListener.jobs, job) + } + c.jobListener.Unlock() +} + +func (c *Conn) startJob(ch chan<- string, job string, args ...interface{}) (int, error) { + if ch != nil { + c.jobListener.Lock() + defer c.jobListener.Unlock() + } + + var p dbus.ObjectPath + err := c.sysobj.Call(job, 0, args...).Store(&p) + if err != nil { + return 0, err + } + + if ch != nil { + c.jobListener.jobs[p] = ch + } + + // ignore error since 0 is fine if conversion fails + jobID, _ := strconv.Atoi(path.Base(string(p))) + + return jobID, nil +} + +// StartUnit enqueues a start job and depending jobs, if any (unless otherwise +// specified by the mode string). +// +// Takes the unit to activate, plus a mode string. The mode needs to be one of +// replace, fail, isolate, ignore-dependencies, ignore-requirements. If +// "replace" the call will start the unit and its dependencies, possibly +// replacing already queued jobs that conflict with this. If "fail" the call +// will start the unit and its dependencies, but will fail if this would change +// an already queued job. If "isolate" the call will start the unit in question +// and terminate all units that aren't dependencies of it. If +// "ignore-dependencies" it will start a unit but ignore all its dependencies. +// If "ignore-requirements" it will start a unit but only ignore the +// requirement dependencies. It is not recommended to make use of the latter +// two options. +// +// If the provided channel is non-nil, a result string will be sent to it upon +// job completion: one of done, canceled, timeout, failed, dependency, skipped. +// done indicates successful execution of a job. canceled indicates that a job +// has been canceled before it finished execution. timeout indicates that the +// job timeout was reached. failed indicates that the job failed. dependency +// indicates that a job this job has been depending on failed and the job hence +// has been removed too. skipped indicates that a job was skipped because it +// didn't apply to the units current state. +// +// If no error occurs, the ID of the underlying systemd job will be returned. There +// does exist the possibility for no error to be returned, but for the returned job +// ID to be 0. In this case, the actual underlying ID is not 0 and this datapoint +// should not be considered authoritative. +// +// If an error does occur, it will be returned to the user alongside a job ID of 0. +func (c *Conn) StartUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.StartUnit", name, mode) +} + +// StopUnit is similar to StartUnit but stops the specified unit rather +// than starting it. +func (c *Conn) StopUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.StopUnit", name, mode) +} + +// ReloadUnit reloads a unit. Reloading is done only if the unit is already running and fails otherwise. +func (c *Conn) ReloadUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.ReloadUnit", name, mode) +} + +// RestartUnit restarts a service. If a service is restarted that isn't +// running it will be started. +func (c *Conn) RestartUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.RestartUnit", name, mode) +} + +// TryRestartUnit is like RestartUnit, except that a service that isn't running +// is not affected by the restart. +func (c *Conn) TryRestartUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.TryRestartUnit", name, mode) +} + +// ReloadOrRestart attempts a reload if the unit supports it and use a restart +// otherwise. +func (c *Conn) ReloadOrRestartUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.ReloadOrRestartUnit", name, mode) +} + +// ReloadOrTryRestart attempts a reload if the unit supports it and use a "Try" +// flavored restart otherwise. +func (c *Conn) ReloadOrTryRestartUnit(name string, mode string, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.ReloadOrTryRestartUnit", name, mode) +} + +// StartTransientUnit() may be used to create and start a transient unit, which +// will be released as soon as it is not running or referenced anymore or the +// system is rebooted. name is the unit name including suffix, and must be +// unique. mode is the same as in StartUnit(), properties contains properties +// of the unit. +func (c *Conn) StartTransientUnit(name string, mode string, properties []Property, ch chan<- string) (int, error) { + return c.startJob(ch, "org.freedesktop.systemd1.Manager.StartTransientUnit", name, mode, properties, make([]PropertyCollection, 0)) +} + +// KillUnit takes the unit name and a UNIX signal number to send. All of the unit's +// processes are killed. +func (c *Conn) KillUnit(name string, signal int32) { + c.sysobj.Call("org.freedesktop.systemd1.Manager.KillUnit", 0, name, "all", signal).Store() +} + +// ResetFailedUnit resets the "failed" state of a specific unit. +func (c *Conn) ResetFailedUnit(name string) error { + return c.sysobj.Call("org.freedesktop.systemd1.Manager.ResetFailedUnit", 0, name).Store() +} + +// getProperties takes the unit name and returns all of its dbus object properties, for the given dbus interface +func (c *Conn) getProperties(unit string, dbusInterface string) (map[string]interface{}, error) { + var err error + var props map[string]dbus.Variant + + path := unitPath(unit) + if !path.IsValid() { + return nil, errors.New("invalid unit name: " + unit) + } + + obj := c.sysconn.Object("org.freedesktop.systemd1", path) + err = obj.Call("org.freedesktop.DBus.Properties.GetAll", 0, dbusInterface).Store(&props) + if err != nil { + return nil, err + } + + out := make(map[string]interface{}, len(props)) + for k, v := range props { + out[k] = v.Value() + } + + return out, nil +} + +// GetUnitProperties takes the unit name and returns all of its dbus object properties. +func (c *Conn) GetUnitProperties(unit string) (map[string]interface{}, error) { + return c.getProperties(unit, "org.freedesktop.systemd1.Unit") +} + +func (c *Conn) getProperty(unit string, dbusInterface string, propertyName string) (*Property, error) { + var err error + var prop dbus.Variant + + path := unitPath(unit) + if !path.IsValid() { + return nil, errors.New("invalid unit name: " + unit) + } + + obj := c.sysconn.Object("org.freedesktop.systemd1", path) + err = obj.Call("org.freedesktop.DBus.Properties.Get", 0, dbusInterface, propertyName).Store(&prop) + if err != nil { + return nil, err + } + + return &Property{Name: propertyName, Value: prop}, nil +} + +func (c *Conn) GetUnitProperty(unit string, propertyName string) (*Property, error) { + return c.getProperty(unit, "org.freedesktop.systemd1.Unit", propertyName) +} + +// GetUnitTypeProperties returns the extra properties for a unit, specific to the unit type. +// Valid values for unitType: Service, Socket, Target, Device, Mount, Automount, Snapshot, Timer, Swap, Path, Slice, Scope +// return "dbus.Error: Unknown interface" if the unitType is not the correct type of the unit +func (c *Conn) GetUnitTypeProperties(unit string, unitType string) (map[string]interface{}, error) { + return c.getProperties(unit, "org.freedesktop.systemd1."+unitType) +} + +// SetUnitProperties() may be used to modify certain unit properties at runtime. +// Not all properties may be changed at runtime, but many resource management +// settings (primarily those in systemd.cgroup(5)) may. The changes are applied +// instantly, and stored on disk for future boots, unless runtime is true, in which +// case the settings only apply until the next reboot. name is the name of the unit +// to modify. properties are the settings to set, encoded as an array of property +// name and value pairs. +func (c *Conn) SetUnitProperties(name string, runtime bool, properties ...Property) error { + return c.sysobj.Call("org.freedesktop.systemd1.Manager.SetUnitProperties", 0, name, runtime, properties).Store() +} + +func (c *Conn) GetUnitTypeProperty(unit string, unitType string, propertyName string) (*Property, error) { + return c.getProperty(unit, "org.freedesktop.systemd1."+unitType, propertyName) +} + +// ListUnits returns an array with all currently loaded units. Note that +// units may be known by multiple names at the same time, and hence there might +// be more unit names loaded than actual units behind them. +func (c *Conn) ListUnits() ([]UnitStatus, error) { + result := make([][]interface{}, 0) + err := c.sysobj.Call("org.freedesktop.systemd1.Manager.ListUnits", 0).Store(&result) + if err != nil { + return nil, err + } + + resultInterface := make([]interface{}, len(result)) + for i := range result { + resultInterface[i] = result[i] + } + + status := make([]UnitStatus, len(result)) + statusInterface := make([]interface{}, len(status)) + for i := range status { + statusInterface[i] = &status[i] + } + + err = dbus.Store(resultInterface, statusInterface...) + if err != nil { + return nil, err + } + + return status, nil +} + +type UnitStatus struct { + Name string // The primary unit name as string + Description string // The human readable description string + LoadState string // The load state (i.e. whether the unit file has been loaded successfully) + ActiveState string // The active state (i.e. whether the unit is currently started or not) + SubState string // The sub state (a more fine-grained version of the active state that is specific to the unit type, which the active state is not) + Followed string // A unit that is being followed in its state by this unit, if there is any, otherwise the empty string. + Path dbus.ObjectPath // The unit object path + JobId uint32 // If there is a job queued for the job unit the numeric job id, 0 otherwise + JobType string // The job type as string + JobPath dbus.ObjectPath // The job object path +} + +type LinkUnitFileChange EnableUnitFileChange + +// LinkUnitFiles() links unit files (that are located outside of the +// usual unit search paths) into the unit search path. +// +// It takes a list of absolute paths to unit files to link and two +// booleans. The first boolean controls whether the unit shall be +// enabled for runtime only (true, /run), or persistently (false, +// /etc). +// The second controls whether symlinks pointing to other units shall +// be replaced if necessary. +// +// This call returns a list of the changes made. The list consists of +// structures with three strings: the type of the change (one of symlink +// or unlink), the file name of the symlink and the destination of the +// symlink. +func (c *Conn) LinkUnitFiles(files []string, runtime bool, force bool) ([]LinkUnitFileChange, error) { + result := make([][]interface{}, 0) + err := c.sysobj.Call("org.freedesktop.systemd1.Manager.LinkUnitFiles", 0, files, runtime, force).Store(&result) + if err != nil { + return nil, err + } + + resultInterface := make([]interface{}, len(result)) + for i := range result { + resultInterface[i] = result[i] + } + + changes := make([]LinkUnitFileChange, len(result)) + changesInterface := make([]interface{}, len(changes)) + for i := range changes { + changesInterface[i] = &changes[i] + } + + err = dbus.Store(resultInterface, changesInterface...) + if err != nil { + return nil, err + } + + return changes, nil +} + +// EnableUnitFiles() may be used to enable one or more units in the system (by +// creating symlinks to them in /etc or /run). +// +// It takes a list of unit files to enable (either just file names or full +// absolute paths if the unit files are residing outside the usual unit +// search paths), and two booleans: the first controls whether the unit shall +// be enabled for runtime only (true, /run), or persistently (false, /etc). +// The second one controls whether symlinks pointing to other units shall +// be replaced if necessary. +// +// This call returns one boolean and an array with the changes made. The +// boolean signals whether the unit files contained any enablement +// information (i.e. an [Install]) section. The changes list consists of +// structures with three strings: the type of the change (one of symlink +// or unlink), the file name of the symlink and the destination of the +// symlink. +func (c *Conn) EnableUnitFiles(files []string, runtime bool, force bool) (bool, []EnableUnitFileChange, error) { + var carries_install_info bool + + result := make([][]interface{}, 0) + err := c.sysobj.Call("org.freedesktop.systemd1.Manager.EnableUnitFiles", 0, files, runtime, force).Store(&carries_install_info, &result) + if err != nil { + return false, nil, err + } + + resultInterface := make([]interface{}, len(result)) + for i := range result { + resultInterface[i] = result[i] + } + + changes := make([]EnableUnitFileChange, len(result)) + changesInterface := make([]interface{}, len(changes)) + for i := range changes { + changesInterface[i] = &changes[i] + } + + err = dbus.Store(resultInterface, changesInterface...) + if err != nil { + return false, nil, err + } + + return carries_install_info, changes, nil +} + +type EnableUnitFileChange struct { + Type string // Type of the change (one of symlink or unlink) + Filename string // File name of the symlink + Destination string // Destination of the symlink +} + +// DisableUnitFiles() may be used to disable one or more units in the system (by +// removing symlinks to them from /etc or /run). +// +// It takes a list of unit files to disable (either just file names or full +// absolute paths if the unit files are residing outside the usual unit +// search paths), and one boolean: whether the unit was enabled for runtime +// only (true, /run), or persistently (false, /etc). +// +// This call returns an array with the changes made. The changes list +// consists of structures with three strings: the type of the change (one of +// symlink or unlink), the file name of the symlink and the destination of the +// symlink. +func (c *Conn) DisableUnitFiles(files []string, runtime bool) ([]DisableUnitFileChange, error) { + result := make([][]interface{}, 0) + err := c.sysobj.Call("org.freedesktop.systemd1.Manager.DisableUnitFiles", 0, files, runtime).Store(&result) + if err != nil { + return nil, err + } + + resultInterface := make([]interface{}, len(result)) + for i := range result { + resultInterface[i] = result[i] + } + + changes := make([]DisableUnitFileChange, len(result)) + changesInterface := make([]interface{}, len(changes)) + for i := range changes { + changesInterface[i] = &changes[i] + } + + err = dbus.Store(resultInterface, changesInterface...) + if err != nil { + return nil, err + } + + return changes, nil +} + +type DisableUnitFileChange struct { + Type string // Type of the change (one of symlink or unlink) + Filename string // File name of the symlink + Destination string // Destination of the symlink +} + +// Reload instructs systemd to scan for and reload unit files. This is +// equivalent to a 'systemctl daemon-reload'. +func (c *Conn) Reload() error { + return c.sysobj.Call("org.freedesktop.systemd1.Manager.Reload", 0).Store() +} + +func unitPath(name string) dbus.ObjectPath { + return dbus.ObjectPath("/org/freedesktop/systemd1/unit/" + PathBusEscape(name)) +} diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/properties.go b/vendor/src/github.com/coreos/go-systemd/dbus/properties.go new file mode 100644 index 0000000000..7520011564 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/dbus/properties.go @@ -0,0 +1,218 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package dbus + +import ( + "github.com/godbus/dbus" +) + +// From the systemd docs: +// +// The properties array of StartTransientUnit() may take many of the settings +// that may also be configured in unit files. Not all parameters are currently +// accepted though, but we plan to cover more properties with future release. +// Currently you may set the Description, Slice and all dependency types of +// units, as well as RemainAfterExit, ExecStart for service units, +// TimeoutStopUSec and PIDs for scope units, and CPUAccounting, CPUShares, +// BlockIOAccounting, BlockIOWeight, BlockIOReadBandwidth, +// BlockIOWriteBandwidth, BlockIODeviceWeight, MemoryAccounting, MemoryLimit, +// DevicePolicy, DeviceAllow for services/scopes/slices. These fields map +// directly to their counterparts in unit files and as normal D-Bus object +// properties. The exception here is the PIDs field of scope units which is +// used for construction of the scope only and specifies the initial PIDs to +// add to the scope object. + +type Property struct { + Name string + Value dbus.Variant +} + +type PropertyCollection struct { + Name string + Properties []Property +} + +type execStart struct { + Path string // the binary path to execute + Args []string // an array with all arguments to pass to the executed command, starting with argument 0 + UncleanIsFailure bool // a boolean whether it should be considered a failure if the process exits uncleanly +} + +// PropExecStart sets the ExecStart service property. The first argument is a +// slice with the binary path to execute followed by the arguments to pass to +// the executed command. See +// http://www.freedesktop.org/software/systemd/man/systemd.service.html#ExecStart= +func PropExecStart(command []string, uncleanIsFailure bool) Property { + execStarts := []execStart{ + execStart{ + Path: command[0], + Args: command, + UncleanIsFailure: uncleanIsFailure, + }, + } + + return Property{ + Name: "ExecStart", + Value: dbus.MakeVariant(execStarts), + } +} + +// PropRemainAfterExit sets the RemainAfterExit service property. See +// http://www.freedesktop.org/software/systemd/man/systemd.service.html#RemainAfterExit= +func PropRemainAfterExit(b bool) Property { + return Property{ + Name: "RemainAfterExit", + Value: dbus.MakeVariant(b), + } +} + +// PropDescription sets the Description unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit#Description= +func PropDescription(desc string) Property { + return Property{ + Name: "Description", + Value: dbus.MakeVariant(desc), + } +} + +func propDependency(name string, units []string) Property { + return Property{ + Name: name, + Value: dbus.MakeVariant(units), + } +} + +// PropRequires sets the Requires unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Requires= +func PropRequires(units ...string) Property { + return propDependency("Requires", units) +} + +// PropRequiresOverridable sets the RequiresOverridable unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#RequiresOverridable= +func PropRequiresOverridable(units ...string) Property { + return propDependency("RequiresOverridable", units) +} + +// PropRequisite sets the Requisite unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Requisite= +func PropRequisite(units ...string) Property { + return propDependency("Requisite", units) +} + +// PropRequisiteOverridable sets the RequisiteOverridable unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#RequisiteOverridable= +func PropRequisiteOverridable(units ...string) Property { + return propDependency("RequisiteOverridable", units) +} + +// PropWants sets the Wants unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Wants= +func PropWants(units ...string) Property { + return propDependency("Wants", units) +} + +// PropBindsTo sets the BindsTo unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#BindsTo= +func PropBindsTo(units ...string) Property { + return propDependency("BindsTo", units) +} + +// PropRequiredBy sets the RequiredBy unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#RequiredBy= +func PropRequiredBy(units ...string) Property { + return propDependency("RequiredBy", units) +} + +// PropRequiredByOverridable sets the RequiredByOverridable unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#RequiredByOverridable= +func PropRequiredByOverridable(units ...string) Property { + return propDependency("RequiredByOverridable", units) +} + +// PropWantedBy sets the WantedBy unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#WantedBy= +func PropWantedBy(units ...string) Property { + return propDependency("WantedBy", units) +} + +// PropBoundBy sets the BoundBy unit property. See +// http://www.freedesktop.org/software/systemd/main/systemd.unit.html#BoundBy= +func PropBoundBy(units ...string) Property { + return propDependency("BoundBy", units) +} + +// PropConflicts sets the Conflicts unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Conflicts= +func PropConflicts(units ...string) Property { + return propDependency("Conflicts", units) +} + +// PropConflictedBy sets the ConflictedBy unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#ConflictedBy= +func PropConflictedBy(units ...string) Property { + return propDependency("ConflictedBy", units) +} + +// PropBefore sets the Before unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Before= +func PropBefore(units ...string) Property { + return propDependency("Before", units) +} + +// PropAfter sets the After unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#After= +func PropAfter(units ...string) Property { + return propDependency("After", units) +} + +// PropOnFailure sets the OnFailure unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#OnFailure= +func PropOnFailure(units ...string) Property { + return propDependency("OnFailure", units) +} + +// PropTriggers sets the Triggers unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#Triggers= +func PropTriggers(units ...string) Property { + return propDependency("Triggers", units) +} + +// PropTriggeredBy sets the TriggeredBy unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#TriggeredBy= +func PropTriggeredBy(units ...string) Property { + return propDependency("TriggeredBy", units) +} + +// PropPropagatesReloadTo sets the PropagatesReloadTo unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#PropagatesReloadTo= +func PropPropagatesReloadTo(units ...string) Property { + return propDependency("PropagatesReloadTo", units) +} + +// PropRequiresMountsFor sets the RequiresMountsFor unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.unit.html#RequiresMountsFor= +func PropRequiresMountsFor(units ...string) Property { + return propDependency("RequiresMountsFor", units) +} + +// PropSlice sets the Slice unit property. See +// http://www.freedesktop.org/software/systemd/man/systemd.resource-control.html#Slice= +func PropSlice(slice string) Property { + return Property{ + Name: "Slice", + Value: dbus.MakeVariant(slice), + } +} diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/set.go b/vendor/src/github.com/coreos/go-systemd/dbus/set.go new file mode 100644 index 0000000000..f92e6fbed1 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/dbus/set.go @@ -0,0 +1,47 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package dbus + +type set struct { + data map[string]bool +} + +func (s *set) Add(value string) { + s.data[value] = true +} + +func (s *set) Remove(value string) { + delete(s.data, value) +} + +func (s *set) Contains(value string) (exists bool) { + _, exists = s.data[value] + return +} + +func (s *set) Length() int { + return len(s.data) +} + +func (s *set) Values() (values []string) { + for val, _ := range s.data { + values = append(values, val) + } + return +} + +func newSet() *set { + return &set{make(map[string]bool)} +} diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/subscription.go b/vendor/src/github.com/coreos/go-systemd/dbus/subscription.go new file mode 100644 index 0000000000..996451445c --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/dbus/subscription.go @@ -0,0 +1,250 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package dbus + +import ( + "errors" + "time" + + "github.com/godbus/dbus" +) + +const ( + cleanIgnoreInterval = int64(10 * time.Second) + ignoreInterval = int64(30 * time.Millisecond) +) + +// Subscribe sets up this connection to subscribe to all systemd dbus events. +// This is required before calling SubscribeUnits. When the connection closes +// systemd will automatically stop sending signals so there is no need to +// explicitly call Unsubscribe(). +func (c *Conn) Subscribe() error { + c.sigconn.BusObject().Call("org.freedesktop.DBus.AddMatch", 0, + "type='signal',interface='org.freedesktop.systemd1.Manager',member='UnitNew'") + c.sigconn.BusObject().Call("org.freedesktop.DBus.AddMatch", 0, + "type='signal',interface='org.freedesktop.DBus.Properties',member='PropertiesChanged'") + + err := c.sigobj.Call("org.freedesktop.systemd1.Manager.Subscribe", 0).Store() + if err != nil { + return err + } + + return nil +} + +// Unsubscribe this connection from systemd dbus events. +func (c *Conn) Unsubscribe() error { + err := c.sigobj.Call("org.freedesktop.systemd1.Manager.Unsubscribe", 0).Store() + if err != nil { + return err + } + + return nil +} + +func (c *Conn) dispatch() { + ch := make(chan *dbus.Signal, signalBuffer) + + c.sigconn.Signal(ch) + + go func() { + for { + signal, ok := <-ch + if !ok { + return + } + + if signal.Name == "org.freedesktop.systemd1.Manager.JobRemoved" { + c.jobComplete(signal) + } + + if c.subscriber.updateCh == nil { + continue + } + + var unitPath dbus.ObjectPath + switch signal.Name { + case "org.freedesktop.systemd1.Manager.JobRemoved": + unitName := signal.Body[2].(string) + c.sysobj.Call("org.freedesktop.systemd1.Manager.GetUnit", 0, unitName).Store(&unitPath) + case "org.freedesktop.systemd1.Manager.UnitNew": + unitPath = signal.Body[1].(dbus.ObjectPath) + case "org.freedesktop.DBus.Properties.PropertiesChanged": + if signal.Body[0].(string) == "org.freedesktop.systemd1.Unit" { + unitPath = signal.Path + } + } + + if unitPath == dbus.ObjectPath("") { + continue + } + + c.sendSubStateUpdate(unitPath) + } + }() +} + +// Returns two unbuffered channels which will receive all changed units every +// interval. Deleted units are sent as nil. +func (c *Conn) SubscribeUnits(interval time.Duration) (<-chan map[string]*UnitStatus, <-chan error) { + return c.SubscribeUnitsCustom(interval, 0, func(u1, u2 *UnitStatus) bool { return *u1 != *u2 }, nil) +} + +// SubscribeUnitsCustom is like SubscribeUnits but lets you specify the buffer +// size of the channels, the comparison function for detecting changes and a filter +// function for cutting down on the noise that your channel receives. +func (c *Conn) SubscribeUnitsCustom(interval time.Duration, buffer int, isChanged func(*UnitStatus, *UnitStatus) bool, filterUnit func(string) bool) (<-chan map[string]*UnitStatus, <-chan error) { + old := make(map[string]*UnitStatus) + statusChan := make(chan map[string]*UnitStatus, buffer) + errChan := make(chan error, buffer) + + go func() { + for { + timerChan := time.After(interval) + + units, err := c.ListUnits() + if err == nil { + cur := make(map[string]*UnitStatus) + for i := range units { + if filterUnit != nil && filterUnit(units[i].Name) { + continue + } + cur[units[i].Name] = &units[i] + } + + // add all new or changed units + changed := make(map[string]*UnitStatus) + for n, u := range cur { + if oldU, ok := old[n]; !ok || isChanged(oldU, u) { + changed[n] = u + } + delete(old, n) + } + + // add all deleted units + for oldN := range old { + changed[oldN] = nil + } + + old = cur + + if len(changed) != 0 { + statusChan <- changed + } + } else { + errChan <- err + } + + <-timerChan + } + }() + + return statusChan, errChan +} + +type SubStateUpdate struct { + UnitName string + SubState string +} + +// SetSubStateSubscriber writes to updateCh when any unit's substate changes. +// Although this writes to updateCh on every state change, the reported state +// may be more recent than the change that generated it (due to an unavoidable +// race in the systemd dbus interface). That is, this method provides a good +// way to keep a current view of all units' states, but is not guaranteed to +// show every state transition they go through. Furthermore, state changes +// will only be written to the channel with non-blocking writes. If updateCh +// is full, it attempts to write an error to errCh; if errCh is full, the error +// passes silently. +func (c *Conn) SetSubStateSubscriber(updateCh chan<- *SubStateUpdate, errCh chan<- error) { + c.subscriber.Lock() + defer c.subscriber.Unlock() + c.subscriber.updateCh = updateCh + c.subscriber.errCh = errCh +} + +func (c *Conn) sendSubStateUpdate(path dbus.ObjectPath) { + c.subscriber.Lock() + defer c.subscriber.Unlock() + + if c.shouldIgnore(path) { + return + } + + info, err := c.GetUnitProperties(string(path)) + if err != nil { + select { + case c.subscriber.errCh <- err: + default: + } + } + + name := info["Id"].(string) + substate := info["SubState"].(string) + + update := &SubStateUpdate{name, substate} + select { + case c.subscriber.updateCh <- update: + default: + select { + case c.subscriber.errCh <- errors.New("update channel full!"): + default: + } + } + + c.updateIgnore(path, info) +} + +// The ignore functions work around a wart in the systemd dbus interface. +// Requesting the properties of an unloaded unit will cause systemd to send a +// pair of UnitNew/UnitRemoved signals. Because we need to get a unit's +// properties on UnitNew (as that's the only indication of a new unit coming up +// for the first time), we would enter an infinite loop if we did not attempt +// to detect and ignore these spurious signals. The signal themselves are +// indistinguishable from relevant ones, so we (somewhat hackishly) ignore an +// unloaded unit's signals for a short time after requesting its properties. +// This means that we will miss e.g. a transient unit being restarted +// *immediately* upon failure and also a transient unit being started +// immediately after requesting its status (with systemctl status, for example, +// because this causes a UnitNew signal to be sent which then causes us to fetch +// the properties). + +func (c *Conn) shouldIgnore(path dbus.ObjectPath) bool { + t, ok := c.subscriber.ignore[path] + return ok && t >= time.Now().UnixNano() +} + +func (c *Conn) updateIgnore(path dbus.ObjectPath, info map[string]interface{}) { + c.cleanIgnore() + + // unit is unloaded - it will trigger bad systemd dbus behavior + if info["LoadState"].(string) == "not-found" { + c.subscriber.ignore[path] = time.Now().UnixNano() + ignoreInterval + } +} + +// without this, ignore would grow unboundedly over time +func (c *Conn) cleanIgnore() { + now := time.Now().UnixNano() + if c.subscriber.cleanIgnore < now { + c.subscriber.cleanIgnore = now + cleanIgnoreInterval + + for p, t := range c.subscriber.ignore { + if t < now { + delete(c.subscriber.ignore, p) + } + } + } +} diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/subscription_set.go b/vendor/src/github.com/coreos/go-systemd/dbus/subscription_set.go new file mode 100644 index 0000000000..5b408d5847 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/dbus/subscription_set.go @@ -0,0 +1,57 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package dbus + +import ( + "time" +) + +// SubscriptionSet returns a subscription set which is like conn.Subscribe but +// can filter to only return events for a set of units. +type SubscriptionSet struct { + *set + conn *Conn +} + +func (s *SubscriptionSet) filter(unit string) bool { + return !s.Contains(unit) +} + +// Subscribe starts listening for dbus events for all of the units in the set. +// Returns channels identical to conn.SubscribeUnits. +func (s *SubscriptionSet) Subscribe() (<-chan map[string]*UnitStatus, <-chan error) { + // TODO: Make fully evented by using systemd 209 with properties changed values + return s.conn.SubscribeUnitsCustom(time.Second, 0, + mismatchUnitStatus, + func(unit string) bool { return s.filter(unit) }, + ) +} + +// NewSubscriptionSet returns a new subscription set. +func (conn *Conn) NewSubscriptionSet() *SubscriptionSet { + return &SubscriptionSet{newSet(), conn} +} + +// mismatchUnitStatus returns true if the provided UnitStatus objects +// are not equivalent. false is returned if the objects are equivalent. +// Only the Name, Description and state-related fields are used in +// the comparison. +func mismatchUnitStatus(u1, u2 *UnitStatus) bool { + return u1.Name != u2.Name || + u1.Description != u2.Description || + u1.LoadState != u2.LoadState || + u1.ActiveState != u2.ActiveState || + u1.SubState != u2.SubState +} diff --git a/vendor/src/github.com/coreos/go-systemd/journal/send.go b/vendor/src/github.com/coreos/go-systemd/journal/send.go new file mode 100644 index 0000000000..1620ae94a8 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/journal/send.go @@ -0,0 +1,166 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Package journal provides write bindings to the systemd journal +package journal + +import ( + "bytes" + "encoding/binary" + "errors" + "fmt" + "io" + "io/ioutil" + "net" + "os" + "strconv" + "strings" + "syscall" +) + +// Priority of a journal message +type Priority int + +const ( + PriEmerg Priority = iota + PriAlert + PriCrit + PriErr + PriWarning + PriNotice + PriInfo + PriDebug +) + +var conn net.Conn + +func init() { + var err error + conn, err = net.Dial("unixgram", "/run/systemd/journal/socket") + if err != nil { + conn = nil + } +} + +// Enabled returns true iff the systemd journal is available for logging +func Enabled() bool { + return conn != nil +} + +// Send a message to the systemd journal. vars is a map of journald fields to +// values. Fields must be composed of uppercase letters, numbers, and +// underscores, but must not start with an underscore. Within these +// restrictions, any arbitrary field name may be used. Some names have special +// significance: see the journalctl documentation +// (http://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html) +// for more details. vars may be nil. +func Send(message string, priority Priority, vars map[string]string) error { + if conn == nil { + return journalError("could not connect to journald socket") + } + + data := new(bytes.Buffer) + appendVariable(data, "PRIORITY", strconv.Itoa(int(priority))) + appendVariable(data, "MESSAGE", message) + for k, v := range vars { + appendVariable(data, k, v) + } + + _, err := io.Copy(conn, data) + if err != nil && isSocketSpaceError(err) { + file, err := tempFd() + if err != nil { + return journalError(err.Error()) + } + _, err = io.Copy(file, data) + if err != nil { + return journalError(err.Error()) + } + + rights := syscall.UnixRights(int(file.Fd())) + + /* this connection should always be a UnixConn, but better safe than sorry */ + unixConn, ok := conn.(*net.UnixConn) + if !ok { + return journalError("can't send file through non-Unix connection") + } + unixConn.WriteMsgUnix([]byte{}, rights, nil) + } else if err != nil { + return journalError(err.Error()) + } + return nil +} + +func appendVariable(w io.Writer, name, value string) { + if !validVarName(name) { + journalError("variable name contains invalid character, ignoring") + } + if strings.ContainsRune(value, '\n') { + /* When the value contains a newline, we write: + * - the variable name, followed by a newline + * - the size (in 64bit little endian format) + * - the data, followed by a newline + */ + fmt.Fprintln(w, name) + binary.Write(w, binary.LittleEndian, uint64(len(value))) + fmt.Fprintln(w, value) + } else { + /* just write the variable and value all on one line */ + fmt.Fprintf(w, "%s=%s\n", name, value) + } +} + +func validVarName(name string) bool { + /* The variable name must be in uppercase and consist only of characters, + * numbers and underscores, and may not begin with an underscore. (from the docs) + */ + + valid := name[0] != '_' + for _, c := range name { + valid = valid && ('A' <= c && c <= 'Z') || ('0' <= c && c <= '9') || c == '_' + } + return valid +} + +func isSocketSpaceError(err error) bool { + opErr, ok := err.(*net.OpError) + if !ok { + return false + } + + sysErr, ok := opErr.Err.(syscall.Errno) + if !ok { + return false + } + + return sysErr == syscall.EMSGSIZE || sysErr == syscall.ENOBUFS +} + +func tempFd() (*os.File, error) { + file, err := ioutil.TempFile("/dev/shm/", "journal.XXXXX") + if err != nil { + return nil, err + } + syscall.Unlink(file.Name()) + if err != nil { + return nil, err + } + return file, nil +} + +func journalError(s string) error { + s = "journal error: " + s + fmt.Fprintln(os.Stderr, s) + return errors.New(s) +} diff --git a/vendor/src/github.com/coreos/go-systemd/util/util.go b/vendor/src/github.com/coreos/go-systemd/util/util.go new file mode 100644 index 0000000000..33832a1ed4 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/util/util.go @@ -0,0 +1,33 @@ +// Copyright 2015 CoreOS, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Package util contains utility functions related to systemd that applications +// can use to check things like whether systemd is running. +package util + +import ( + "os" +) + +// IsRunningSystemd checks whether the host was booted with systemd as its init +// system. This functions similar to systemd's `sd_booted(3)`: internally, it +// checks whether /run/systemd/system/ exists and is a directory. +// http://www.freedesktop.org/software/systemd/man/sd_booted.html +func IsRunningSystemd() bool { + fi, err := os.Lstat("/run/systemd/system") + if err != nil { + return false + } + return fi.IsDir() +} diff --git a/vendor/src/github.com/deckarep/golang-set/.gitignore b/vendor/src/github.com/deckarep/golang-set/.gitignore new file mode 100644 index 0000000000..00268614f0 --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/.gitignore @@ -0,0 +1,22 @@ +# Compiled Object files, Static and Dynamic libs (Shared Objects) +*.o +*.a +*.so + +# Folders +_obj +_test + +# Architecture specific extensions/prefixes +*.[568vq] +[568vq].out + +*.cgo1.go +*.cgo2.c +_cgo_defun.c +_cgo_gotypes.go +_cgo_export.* + +_testmain.go + +*.exe diff --git a/vendor/src/github.com/deckarep/golang-set/.travis.yml b/vendor/src/github.com/deckarep/golang-set/.travis.yml new file mode 100644 index 0000000000..db1359c72e --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/.travis.yml @@ -0,0 +1,9 @@ +language: go + +go: + - 1.2 + +script: + - go test ./... + #- go test -race ./... + diff --git a/vendor/src/github.com/deckarep/golang-set/LICENSE b/vendor/src/github.com/deckarep/golang-set/LICENSE new file mode 100644 index 0000000000..b5768f89cf --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/LICENSE @@ -0,0 +1,22 @@ +Open Source Initiative OSI - The MIT License (MIT):Licensing + +The MIT License (MIT) +Copyright (c) 2013 Ralph Caraveo (deckarep@gmail.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/vendor/src/github.com/deckarep/golang-set/README.md b/vendor/src/github.com/deckarep/golang-set/README.md new file mode 100644 index 0000000000..744b1841cd --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/README.md @@ -0,0 +1,94 @@ +[![Build Status](https://travis-ci.org/deckarep/golang-set.png?branch=master)](https://travis-ci.org/deckarep/golang-set) +[![GoDoc](https://godoc.org/github.com/deckarep/golang-set?status.png)](http://godoc.org/github.com/deckarep/golang-set) + +## golang-set + + +The missing set collection for the Go language. Until Go has sets built-in...use this. + +Coming from Python one of the things I miss is the superbly wonderful set collection. This is my attempt to mimic the primary features of the set from Python. +You can of course argue that there is no need for a set in Go, otherwise the creators would have added one to the standard library. To those I say simply ignore this repository +and carry-on and to the rest that find this useful please contribute in helping me make it better by: + +* Helping to make more idiomatic improvements to the code. +* Helping to increase the performance of it. ~~(So far, no attempt has been made, but since it uses a map internally, I expect it to be mostly performant.)~~ +* Helping to make the unit-tests more robust and kick-ass. +* Helping to fill in the [documentation.](http://godoc.org/github.com/deckarep/golang-set) +* Simply offering feedback and suggestions. (Positive, constructive feedback is appreciated.) + +I have to give some credit for helping seed the idea with this post on [stackoverflow.](http://programmers.stackexchange.com/questions/177428/sets-data-structure-in-golang) + +*Update* - as of 3/9/2014, you can use a compile-time generic version of this package in the [gen](http://clipperhouse.github.io/gen/) framework. This framework allows you to use the golang-set in a completely generic and type-safe way by allowing you to generate a supporting .go file based on your custom types. + +## Features (as of 9/22/2014) + +* a CartesionProduct() method has been added with unit-tests: [Read more about the cartesion product](http://en.wikipedia.org/wiki/Cartesian_product) + +## Features (as of 9/15/2014) + +* a PowerSet() method has been added with unit-tests: [Read more about the Power set](http://en.wikipedia.org/wiki/Power_set) + +## Features (as of 4/22/2014) + +* One common interface to both implementations +* Two set implementations to choose from + * a thread-safe implementation designed for concurrent use + * a non-thread-safe implementation designed for performance +* 75 benchmarks for both implementations +* 35 unit tests for both implementations +* 14 concurrent tests for the thread-safe implementation + + + +Please see the unit test file for additional usage examples. The Python set documentation will also do a better job than I can of explaining how a set typically [works.](http://docs.python.org/2/library/sets.html) Please keep in mind +however that the Python set is a built-in type and supports additional features and syntax that make it awesome. + +## Examples but not exhaustive: + +```go +requiredClasses := mapset.NewSet() +requiredClasses.Add("Cooking") +requiredClasses.Add("English") +requiredClasses.Add("Math") +requiredClasses.Add("Biology") + +scienceSlice := []interface{}{"Biology", "Chemistry"} +scienceClasses := mapset.NewSetFromSlice(scienceSlice) + +electiveClasses := mapset.NewSet() +electiveClasses.Add("Welding") +electiveClasses.Add("Music") +electiveClasses.Add("Automotive") + +bonusClasses := mapset.NewSet() +bonusClasses.Add("Go Programming") +bonusClasses.Add("Python Programming") + +//Show me all the available classes I can take +allClasses := requiredClasses.Union(scienceClasses).Union(electiveClasses).Union(bonusClasses) +fmt.Println(allClasses) //Set{Cooking, English, Math, Chemistry, Welding, Biology, Music, Automotive, Go Programming, Python Programming} + + +//Is cooking considered a science class? +fmt.Println(scienceClasses.Contains("Cooking")) //false + +//Show me all classes that are not science classes, since I hate science. +fmt.Println(allClasses.Difference(scienceClasses)) //Set{Music, Automotive, Go Programming, Python Programming, Cooking, English, Math, Welding} + +//Which science classes are also required classes? +fmt.Println(scienceClasses.Intersect(requiredClasses)) //Set{Biology} + +//How many bonus classes do you offer? +fmt.Println(bonusClasses.Cardinality()) //2 + +//Do you have the following classes? Welding, Automotive and English? +fmt.Println(allClasses.IsSuperset(mapset.NewSetFromSlice([]interface{}{"Welding", "Automotive", "English"}))) //true +``` + +Thanks! + +-Ralph + +[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/deckarep/golang-set/trend.png)](https://bitdeli.com/free "Bitdeli Badge") + +[![Analytics](https://ga-beacon.appspot.com/UA-42584447-2/deckarep/golang-set)](https://github.com/igrigorik/ga-beacon) diff --git a/vendor/src/github.com/deckarep/golang-set/set.go b/vendor/src/github.com/deckarep/golang-set/set.go new file mode 100644 index 0000000000..eccba70e44 --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/set.go @@ -0,0 +1,168 @@ +/* +Open Source Initiative OSI - The MIT License (MIT):Licensing + +The MIT License (MIT) +Copyright (c) 2013 Ralph Caraveo (deckarep@gmail.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +// Package mapset implements a simple and generic set collection. +// Items stored within it are unordered and unique. It supports +// typical set operations: membership testing, intersection, union, +// difference, symmetric difference and cloning. +// +// Package mapset provides two implementations. The default +// implementation is safe for concurrent access. There is a non-threadsafe +// implementation which is slightly more performant. +package mapset + +type Set interface { + // Adds an element to the set. Returns whether + // the item was added. + Add(i interface{}) bool + + // Returns the number of elements in the set. + Cardinality() int + + // Removes all elements from the set, leaving + // the emtpy set. + Clear() + + // Returns a clone of the set using the same + // implementation, duplicating all keys. + Clone() Set + + // Returns whether the given items + // are all in the set. + Contains(i ...interface{}) bool + + // Returns the difference between this set + // and other. The returned set will contain + // all elements of this set that are not also + // elements of other. + // + // Note that the argument to Difference + // must be of the same type as the receiver + // of the method. Otherwise, Difference will + // panic. + Difference(other Set) Set + + // Determines if two sets are equal to each + // other. If they have the same cardinality + // and contain the same elements, they are + // considered equal. The order in which + // the elements were added is irrelevant. + // + // Note that the argument to Equal must be + // of the same type as the receiver of the + // method. Otherwise, Equal will panic. + Equal(other Set) bool + + // Returns a new set containing only the elements + // that exist only in both sets. + // + // Note that the argument to Intersect + // must be of the same type as the receiver + // of the method. Otherwise, Intersect will + // panic. + Intersect(other Set) Set + + // Determines if every element in the other set + // is in this set. + // + // Note that the argument to IsSubset + // must be of the same type as the receiver + // of the method. Otherwise, IsSubset will + // panic. + IsSubset(other Set) bool + + // Determines if every element in this set is in + // the other set. + // + // Note that the argument to IsSuperset + // must be of the same type as the receiver + // of the method. Otherwise, IsSuperset will + // panic. + IsSuperset(other Set) bool + + // Returns a channel of elements that you can + // range over. + Iter() <-chan interface{} + + // Remove a single element from the set. + Remove(i interface{}) + + // Provides a convenient string representation + // of the current state of the set. + String() string + + // Returns a new set with all elements which are + // in either this set or the other set but not in both. + // + // Note that the argument to SymmetricDifference + // must be of the same type as the receiver + // of the method. Otherwise, SymmetricDifference + // will panic. + SymmetricDifference(other Set) Set + + // Returns a new set with all elements in both sets. + // + // Note that the argument to Union must be of the + // same type as the receiver of the method. + // Otherwise, IsSuperset will panic. + Union(other Set) Set + + // Returns all subsets of a given set (Power Set). + PowerSet() Set + + // Returns the Cartesian Product of two sets. + CartesianProduct(other Set) Set + + // Returns the members of the set as a slice. + ToSlice() []interface{} +} + +// Creates and returns a reference to an empty set. +func NewSet() Set { + set := newThreadSafeSet() + return &set +} + +// Creates and returns a reference to a set from an existing slice +func NewSetFromSlice(s []interface{}) Set { + a := NewSet() + for _, item := range s { + a.Add(item) + } + return a +} + +func NewThreadUnsafeSet() Set { + set := newThreadUnsafeSet() + return &set +} + +func NewThreadUnsafeSetFromSlice(s []interface{}) Set { + a := NewThreadUnsafeSet() + for _, item := range s { + a.Add(item) + } + return a +} diff --git a/vendor/src/github.com/deckarep/golang-set/threadsafe.go b/vendor/src/github.com/deckarep/golang-set/threadsafe.go new file mode 100644 index 0000000000..9dca94af73 --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/threadsafe.go @@ -0,0 +1,204 @@ +/* +Open Source Initiative OSI - The MIT License (MIT):Licensing + +The MIT License (MIT) +Copyright (c) 2013 Ralph Caraveo (deckarep@gmail.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +package mapset + +import "sync" + +type threadSafeSet struct { + s threadUnsafeSet + sync.RWMutex +} + +func newThreadSafeSet() threadSafeSet { + return threadSafeSet{s: newThreadUnsafeSet()} +} + +func (set *threadSafeSet) Add(i interface{}) bool { + set.Lock() + ret := set.s.Add(i) + set.Unlock() + return ret +} + +func (set *threadSafeSet) Contains(i ...interface{}) bool { + set.RLock() + ret := set.s.Contains(i...) + set.RUnlock() + return ret +} + +func (set *threadSafeSet) IsSubset(other Set) bool { + o := other.(*threadSafeSet) + + set.RLock() + o.RLock() + + ret := set.s.IsSubset(&o.s) + set.RUnlock() + o.RUnlock() + return ret +} + +func (set *threadSafeSet) IsSuperset(other Set) bool { + return other.IsSubset(set) +} + +func (set *threadSafeSet) Union(other Set) Set { + o := other.(*threadSafeSet) + + set.RLock() + o.RLock() + + unsafeUnion := set.s.Union(&o.s).(*threadUnsafeSet) + ret := &threadSafeSet{s: *unsafeUnion} + set.RUnlock() + o.RUnlock() + return ret +} + +func (set *threadSafeSet) Intersect(other Set) Set { + o := other.(*threadSafeSet) + + set.RLock() + o.RLock() + + unsafeIntersection := set.s.Intersect(&o.s).(*threadUnsafeSet) + ret := &threadSafeSet{s: *unsafeIntersection} + set.RUnlock() + o.RUnlock() + return ret +} + +func (set *threadSafeSet) Difference(other Set) Set { + o := other.(*threadSafeSet) + + set.RLock() + o.RLock() + + unsafeDifference := set.s.Difference(&o.s).(*threadUnsafeSet) + ret := &threadSafeSet{s: *unsafeDifference} + set.RUnlock() + o.RUnlock() + return ret +} + +func (set *threadSafeSet) SymmetricDifference(other Set) Set { + o := other.(*threadSafeSet) + + unsafeDifference := set.s.SymmetricDifference(&o.s).(*threadUnsafeSet) + return &threadSafeSet{s: *unsafeDifference} +} + +func (set *threadSafeSet) Clear() { + set.Lock() + set.s = newThreadUnsafeSet() + set.Unlock() +} + +func (set *threadSafeSet) Remove(i interface{}) { + set.Lock() + delete(set.s, i) + set.Unlock() +} + +func (set *threadSafeSet) Cardinality() int { + set.RLock() + defer set.RUnlock() + return len(set.s) +} + +func (set *threadSafeSet) Iter() <-chan interface{} { + ch := make(chan interface{}) + go func() { + set.RLock() + + for elem := range set.s { + ch <- elem + } + close(ch) + set.RUnlock() + }() + + return ch +} + +func (set *threadSafeSet) Equal(other Set) bool { + o := other.(*threadSafeSet) + + set.RLock() + o.RLock() + + ret := set.s.Equal(&o.s) + set.RUnlock() + o.RUnlock() + return ret +} + +func (set *threadSafeSet) Clone() Set { + set.RLock() + + unsafeClone := set.s.Clone().(*threadUnsafeSet) + ret := &threadSafeSet{s: *unsafeClone} + set.RUnlock() + return ret +} + +func (set *threadSafeSet) String() string { + set.RLock() + ret := set.s.String() + set.RUnlock() + return ret +} + +func (set *threadSafeSet) PowerSet() Set { + set.RLock() + ret := set.s.PowerSet() + set.RUnlock() + return ret +} + +func (set *threadSafeSet) CartesianProduct(other Set) Set { + o := other.(*threadSafeSet) + + set.RLock() + o.RLock() + + unsafeCartProduct := set.s.CartesianProduct(&o.s).(*threadUnsafeSet) + ret := &threadSafeSet{s: *unsafeCartProduct} + set.RUnlock() + o.RUnlock() + return ret +} + +func (set *threadSafeSet) ToSlice() []interface{} { + set.RLock() + keys := make([]interface{}, 0, set.Cardinality()) + for elem := range set.s { + keys = append(keys, elem) + } + set.RUnlock() + return keys +} diff --git a/vendor/src/github.com/deckarep/golang-set/threadunsafe.go b/vendor/src/github.com/deckarep/golang-set/threadunsafe.go new file mode 100644 index 0000000000..124521e2ee --- /dev/null +++ b/vendor/src/github.com/deckarep/golang-set/threadunsafe.go @@ -0,0 +1,246 @@ +/* +Open Source Initiative OSI - The MIT License (MIT):Licensing + +The MIT License (MIT) +Copyright (c) 2013 Ralph Caraveo (deckarep@gmail.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +package mapset + +import ( + "fmt" + "reflect" + "strings" +) + +type threadUnsafeSet map[interface{}]struct{} + +type orderedPair struct { + first interface{} + second interface{} +} + +func newThreadUnsafeSet() threadUnsafeSet { + return make(threadUnsafeSet) +} + +func (pair *orderedPair) Equal(other orderedPair) bool { + if pair.first == other.first && + pair.second == other.second { + return true + } + + return false +} + +func (set *threadUnsafeSet) Add(i interface{}) bool { + _, found := (*set)[i] + (*set)[i] = struct{}{} + return !found //False if it existed already +} + +func (set *threadUnsafeSet) Contains(i ...interface{}) bool { + for _, val := range i { + if _, ok := (*set)[val]; !ok { + return false + } + } + return true +} + +func (set *threadUnsafeSet) IsSubset(other Set) bool { + _ = other.(*threadUnsafeSet) + for elem := range *set { + if !other.Contains(elem) { + return false + } + } + return true +} + +func (set *threadUnsafeSet) IsSuperset(other Set) bool { + return other.IsSubset(set) +} + +func (set *threadUnsafeSet) Union(other Set) Set { + o := other.(*threadUnsafeSet) + + unionedSet := newThreadUnsafeSet() + + for elem := range *set { + unionedSet.Add(elem) + } + for elem := range *o { + unionedSet.Add(elem) + } + return &unionedSet +} + +func (set *threadUnsafeSet) Intersect(other Set) Set { + o := other.(*threadUnsafeSet) + + intersection := newThreadUnsafeSet() + // loop over smaller set + if set.Cardinality() < other.Cardinality() { + for elem := range *set { + if other.Contains(elem) { + intersection.Add(elem) + } + } + } else { + for elem := range *o { + if set.Contains(elem) { + intersection.Add(elem) + } + } + } + return &intersection +} + +func (set *threadUnsafeSet) Difference(other Set) Set { + _ = other.(*threadUnsafeSet) + + difference := newThreadUnsafeSet() + for elem := range *set { + if !other.Contains(elem) { + difference.Add(elem) + } + } + return &difference +} + +func (set *threadUnsafeSet) SymmetricDifference(other Set) Set { + _ = other.(*threadUnsafeSet) + + aDiff := set.Difference(other) + bDiff := other.Difference(set) + return aDiff.Union(bDiff) +} + +func (set *threadUnsafeSet) Clear() { + *set = newThreadUnsafeSet() +} + +func (set *threadUnsafeSet) Remove(i interface{}) { + delete(*set, i) +} + +func (set *threadUnsafeSet) Cardinality() int { + return len(*set) +} + +func (set *threadUnsafeSet) Iter() <-chan interface{} { + ch := make(chan interface{}) + go func() { + for elem := range *set { + ch <- elem + } + close(ch) + }() + + return ch +} + +func (set *threadUnsafeSet) Equal(other Set) bool { + _ = other.(*threadUnsafeSet) + + if set.Cardinality() != other.Cardinality() { + return false + } + for elem := range *set { + if !other.Contains(elem) { + return false + } + } + return true +} + +func (set *threadUnsafeSet) Clone() Set { + clonedSet := newThreadUnsafeSet() + for elem := range *set { + clonedSet.Add(elem) + } + return &clonedSet +} + +func (set *threadUnsafeSet) String() string { + items := make([]string, 0, len(*set)) + + for elem := range *set { + items = append(items, fmt.Sprintf("%v", elem)) + } + return fmt.Sprintf("Set{%s}", strings.Join(items, ", ")) +} + +func (pair orderedPair) String() string { + return fmt.Sprintf("(%v, %v)", pair.first, pair.second) +} + +func (set *threadUnsafeSet) PowerSet() Set { + powSet := NewThreadUnsafeSet() + nullset := newThreadUnsafeSet() + powSet.Add(&nullset) + + for es := range *set { + u := newThreadUnsafeSet() + j := powSet.Iter() + for er := range j { + p := newThreadUnsafeSet() + if reflect.TypeOf(er).Name() == "" { + k := er.(*threadUnsafeSet) + for ek := range *(k) { + p.Add(ek) + } + } else { + p.Add(er) + } + p.Add(es) + u.Add(&p) + } + + powSet = powSet.Union(&u) + } + + return powSet +} + +func (set *threadUnsafeSet) CartesianProduct(other Set) Set { + o := other.(*threadUnsafeSet) + cartProduct := NewThreadUnsafeSet() + + for i := range *set { + for j := range *o { + elem := orderedPair{first: i, second: j} + cartProduct.Add(elem) + } + } + + return cartProduct +} + +func (set *threadUnsafeSet) ToSlice() []interface{} { + keys := make([]interface{}, 0, set.Cardinality()) + for elem := range *set { + keys = append(keys, elem) + } + + return keys +} diff --git a/vendor/src/github.com/docker/distribution/.drone.yml b/vendor/src/github.com/docker/distribution/.drone.yml new file mode 100644 index 0000000000..d943e19ff1 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/.drone.yml @@ -0,0 +1,38 @@ +image: dmp42/go:stable + +script: + # To be spoofed back into the test image + - go get github.com/modocache/gover + + - go get -t ./... + + # Go fmt + - test -z "$(gofmt -s -l -w . | tee /dev/stderr)" + # Go lint + - test -z "$(golint ./... | tee /dev/stderr)" + # Go vet + - go vet ./... + # Go test + - go test -v -race -cover ./... + # Helper to concatenate reports + - gover + # Send to coverall + - goveralls -service drone.io -coverprofile=gover.coverprofile -repotoken {{COVERALLS_TOKEN}} + + # Do we want these as well? + # - go get code.google.com/p/go.tools/cmd/goimports + # - test -z "$(goimports -l -w ./... | tee /dev/stderr)" + # http://labix.org/gocheck + +notify: + email: + recipients: + - distribution@docker.com + + slack: + team: docker + channel: "#dt" + username: mom + token: {{SLACK_TOKEN}} + on_success: true + on_failure: true diff --git a/vendor/src/github.com/docker/distribution/.gitignore b/vendor/src/github.com/docker/distribution/.gitignore new file mode 100644 index 0000000000..1c3ae0a773 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/.gitignore @@ -0,0 +1,37 @@ +# Compiled Object files, Static and Dynamic libs (Shared Objects) +*.o +*.a +*.so + +# Folders +_obj +_test + +# Architecture specific extensions/prefixes +*.[568vq] +[568vq].out + +*.cgo1.go +*.cgo2.c +_cgo_defun.c +_cgo_gotypes.go +_cgo_export.* + +_testmain.go + +*.exe +*.test +*.prof + +# never checkin from the bin file (for now) +bin/* + +# Test key files +*.pem + +# Cover profiles +*.out + +# Editor/IDE specific files. +*.sublime-project +*.sublime-workspace diff --git a/vendor/src/github.com/docker/distribution/.mailmap b/vendor/src/github.com/docker/distribution/.mailmap new file mode 100644 index 0000000000..bcfe66352d --- /dev/null +++ b/vendor/src/github.com/docker/distribution/.mailmap @@ -0,0 +1,6 @@ +Stephen J Day Stephen Day +Stephen J Day Stephen Day +Olivier Gambier Olivier Gambier +Brian Bland Brian Bland +Josh Hawn Josh Hawn +Richard Scothern Richard \ No newline at end of file diff --git a/vendor/src/github.com/docker/distribution/AUTHORS b/vendor/src/github.com/docker/distribution/AUTHORS new file mode 100644 index 0000000000..2b9e4c3e49 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/AUTHORS @@ -0,0 +1,61 @@ +Adam Enger +Adrian Mouat +Ahmet Alp Balkan +Alex Elman +Amy Lindburg +Andrey Kostov +Andy Goldstein +Anton Tiurin +Antonio Mercado +Arnaud Porterie +BadZen +Ben Firshman +bin liu +Brian Bland +burnettk +Daisuke Fujita +Dave Trombley +David Lawrence +David Xia +Derek McGowan +Diogo Mónica +Donald Huang +Doug Davis +Frederick F. Kautz IV +Henri Gomez +Hu Keping +Ian Babrou +Jeff Nickoloff +Jessie Frazelle +Jordan Liggitt +Josh Hawn +Julien Fernandez +Kelsey Hightower +Kenneth Lim +Mary Anthony +Matt Robenolt +Michael Prokop +moxiegirl +Nathan Sullivan +Nghia Tran +Oilbeater +Olivier Gambier +Philip Misiowiec +Richard Scothern +Richard Scothern +Sebastiaan van Stijn +Shawn Falkner-Horine +Shreyas Karnik +Simon Thulbourn +Spencer Rinehart +Stephen J Day +Thomas Sjögren +Tianon Gravi +Tibor Vass +Vincent Batts +Vincent Demeester +Vincent Giersch +W. Trevor King +xiekeyang +Yann ROBERT +yuzou diff --git a/vendor/src/github.com/docker/distribution/CONTRIBUTING.md b/vendor/src/github.com/docker/distribution/CONTRIBUTING.md new file mode 100644 index 0000000000..b91a1d0faa --- /dev/null +++ b/vendor/src/github.com/docker/distribution/CONTRIBUTING.md @@ -0,0 +1,139 @@ +# Contributing to the registry + +## Before reporting an issue... + +### If your problem is with... + + - automated builds + - your account on the [Docker Hub](https://hub.docker.com/) + - any other [Docker Hub](https://hub.docker.com/) issue + +Then please do not report your issue here - you should instead report it to [https://support.docker.com](https://support.docker.com) + +### If you... + + - need help setting up your registry + - can't figure out something + - are not sure what's going on or what your problem is + +Then please do not open an issue here yet - you should first try one of the following support forums: + + - irc: #docker-distribution on freenode + - mailing-list: or https://groups.google.com/a/dockerproject.org/forum/#!forum/distribution + +## Reporting an issue properly + +By following these simple rules you will get better and faster feedback on your issue. + + - search the bugtracker for an already reported issue + +### If you found an issue that describes your problem: + + - please read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments + - please refrain from adding "same thing here" or "+1" comments + - you don't need to comment on an issue to get notified of updates: just hit the "subscribe" button + - comment if you have some new, technical and relevant information to add to the case + +### If you have not found an existing issue that describes your problem: + + 1. create a new issue, with a succinct title that describes your issue: + - bad title: "It doesn't work with my docker" + - good title: "Private registry push fail: 400 error with E_INVALID_DIGEST" + 2. copy the output of: + - `docker version` + - `docker info` + - `docker exec registry -version` + 3. copy the command line you used to launch your Registry + 4. restart your docker daemon in debug mode (add `-D` to the daemon launch arguments) + 5. reproduce your problem and get your docker daemon logs showing the error + 6. if relevant, copy your registry logs that show the error + 7. provide any relevant detail about your specific Registry configuration (e.g., storage backend used) + 8. indicate if you are using an enterprise proxy, Nginx, or anything else between you and your Registry + +## Contributing a patch for a known bug, or a small correction + +You should follow the basic GitHub workflow: + + 1. fork + 2. commit a change + 3. make sure the tests pass + 4. PR + +Additionally, you must [sign your commits](https://github.com/docker/docker/blob/master/CONTRIBUTING.md#sign-your-work). It's very simple: + + - configure your name with git: `git config user.name "Real Name" && git config user.email mail@example.com` + - sign your commits using `-s`: `git commit -s -m "My commit"` + +Some simple rules to ensure quick merge: + + - clearly point to the issue(s) you want to fix in your PR comment (e.g., `closes #12345`) + - prefer multiple (smaller) PRs addressing individual issues over a big one trying to address multiple issues at once + - if you need to amend your PR following comments, please squash instead of adding more commits + +## Contributing new features + +You are heavily encouraged to first discuss what you want to do. You can do so on the irc channel, or by opening an issue that clearly describes the use case you want to fulfill, or the problem you are trying to solve. + +If this is a major new feature, you should then submit a proposal that describes your technical solution and reasoning. +If you did discuss it first, this will likely be greenlighted very fast. It's advisable to address all feedback on this proposal before starting actual work. + +Then you should submit your implementation, clearly linking to the issue (and possible proposal). + +Your PR will be reviewed by the community, then ultimately by the project maintainers, before being merged. + +It's mandatory to: + + - interact respectfully with other community members and maintainers - more generally, you are expected to abide by the [Docker community rules](https://github.com/docker/docker/blob/master/CONTRIBUTING.md#docker-community-guidelines) + - address maintainers' comments and modify your submission accordingly + - write tests for any new code + +Complying to these simple rules will greatly accelerate the review process, and will ensure you have a pleasant experience in contributing code to the Registry. + +Have a look at a great, succesful contribution: the [Ceph driver PR](https://github.com/docker/distribution/pull/443) + +## Coding Style + +Unless explicitly stated, we follow all coding guidelines from the Go +community. While some of these standards may seem arbitrary, they somehow seem +to result in a solid, consistent codebase. + +It is possible that the code base does not currently comply with these +guidelines. We are not looking for a massive PR that fixes this, since that +goes against the spirit of the guidelines. All new contributions should make a +best effort to clean up and make the code base better than they left it. +Obviously, apply your best judgement. Remember, the goal here is to make the +code base easier for humans to navigate and understand. Always keep that in +mind when nudging others to comply. + +The rules: + +1. All code should be formatted with `gofmt -s`. +2. All code should pass the default levels of + [`golint`](https://github.com/golang/lint). +3. All code should follow the guidelines covered in [Effective + Go](http://golang.org/doc/effective_go.html) and [Go Code Review + Comments](https://github.com/golang/go/wiki/CodeReviewComments). +4. Comment the code. Tell us the why, the history and the context. +5. Document _all_ declarations and methods, even private ones. Declare + expectations, caveats and anything else that may be important. If a type + gets exported, having the comments already there will ensure it's ready. +6. Variable name length should be proportional to its context and no longer. + `noCommaALongVariableNameLikeThisIsNotMoreClearWhenASimpleCommentWouldDo`. + In practice, short methods will have short variable names and globals will + have longer names. +7. No underscores in package names. If you need a compound name, step back, + and re-examine why you need a compound name. If you still think you need a + compound name, lose the underscore. +8. No utils or helpers packages. If a function is not general enough to + warrant its own package, it has not been written generally enough to be a + part of a util package. Just leave it unexported and well-documented. +9. All tests should run with `go test` and outside tooling should not be + required. No, we don't need another unit testing framework. Assertion + packages are acceptable if they provide _real_ incremental value. +10. Even though we call these "rules" above, they are actually just + guidelines. Since you've read all the rules, you now know that. + +If you are having trouble getting into the mood of idiomatic Go, we recommend +reading through [Effective Go](http://golang.org/doc/effective_go.html). The +[Go Blog](http://blog.golang.org/) is also a great resource. Drinking the +kool-aid is a lot easier than going thirsty. diff --git a/vendor/src/github.com/docker/distribution/Dockerfile b/vendor/src/github.com/docker/distribution/Dockerfile new file mode 100644 index 0000000000..5555606faa --- /dev/null +++ b/vendor/src/github.com/docker/distribution/Dockerfile @@ -0,0 +1,19 @@ +FROM golang:1.4 + +RUN apt-get update && \ + apt-get install -y librados-dev apache2-utils && \ + rm -rf /var/lib/apt/lists/* + +ENV DISTRIBUTION_DIR /go/src/github.com/docker/distribution +ENV GOPATH $DISTRIBUTION_DIR/Godeps/_workspace:$GOPATH +ENV DOCKER_BUILDTAGS include_rados + +WORKDIR $DISTRIBUTION_DIR +COPY . $DISTRIBUTION_DIR +COPY cmd/registry/config-dev.yml $DISTRIBUTION_DIR/cmd/registry/config.yml +RUN make PREFIX=/go clean binaries + +VOLUME ["/var/lib/registry"] +EXPOSE 5000 +ENTRYPOINT ["registry"] +CMD ["cmd/registry/config.yml"] diff --git a/vendor/src/github.com/docker/distribution/LICENSE b/vendor/src/github.com/docker/distribution/LICENSE new file mode 100644 index 0000000000..e06d208186 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/LICENSE @@ -0,0 +1,202 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + diff --git a/vendor/src/github.com/docker/distribution/MAINTAINERS b/vendor/src/github.com/docker/distribution/MAINTAINERS new file mode 100644 index 0000000000..0abd7d4c3e --- /dev/null +++ b/vendor/src/github.com/docker/distribution/MAINTAINERS @@ -0,0 +1,4 @@ +Solomon Hykes (@shykes) +Olivier Gambier (@dmp42) +Sam Alba (@samalba) +Stephen Day (@stevvooe) diff --git a/vendor/src/github.com/docker/distribution/Makefile b/vendor/src/github.com/docker/distribution/Makefile new file mode 100644 index 0000000000..f9e00bb716 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/Makefile @@ -0,0 +1,74 @@ +# Set an output prefix, which is the local directory if not specified +PREFIX?=$(shell pwd) + + +# Used to populate version variable in main package. +VERSION=$(shell git describe --match 'v[0-9]*' --dirty='.m' --always) + +# Allow turning off function inlining and variable registerization +ifeq (${DISABLE_OPTIMIZATION},true) + GO_GCFLAGS=-gcflags "-N -l" + VERSION:="$(VERSION)-noopt" +endif + +GO_LDFLAGS=-ldflags "-X `go list ./version`.Version $(VERSION)" + +.PHONY: clean all fmt vet lint build test binaries +.DEFAULT: default +all: AUTHORS clean fmt vet fmt lint build test binaries + +AUTHORS: .mailmap .git/HEAD + git log --format='%aN <%aE>' | sort -fu > $@ + +# This only needs to be generated by hand when cutting full releases. +version/version.go: + ./version/version.sh > $@ + +${PREFIX}/bin/registry: version/version.go $(shell find . -type f -name '*.go') + @echo "+ $@" + @go build -tags "${DOCKER_BUILDTAGS}" -o $@ ${GO_LDFLAGS} ${GO_GCFLAGS} ./cmd/registry + +${PREFIX}/bin/registry-api-descriptor-template: version/version.go $(shell find . -type f -name '*.go') + @echo "+ $@" + @go build -o $@ ${GO_LDFLAGS} ${GO_GCFLAGS} ./cmd/registry-api-descriptor-template + +${PREFIX}/bin/dist: version/version.go $(shell find . -type f -name '*.go') + @echo "+ $@" + @go build -o $@ ${GO_LDFLAGS} ${GO_GCFLAGS} ./cmd/dist + +docs/spec/api.md: docs/spec/api.md.tmpl ${PREFIX}/bin/registry-api-descriptor-template + ./bin/registry-api-descriptor-template $< > $@ + +vet: + @echo "+ $@" + @go vet ./... + +fmt: + @echo "+ $@" + @test -z "$$(gofmt -s -l . | grep -v Godeps/_workspace/src/ | tee /dev/stderr)" || \ + echo "+ please format Go code with 'gofmt -s'" + +lint: + @echo "+ $@" + @test -z "$$(golint ./... | grep -v Godeps/_workspace/src/ | tee /dev/stderr)" + +build: + @echo "+ $@" + @go build -tags "${DOCKER_BUILDTAGS}" -v ${GO_LDFLAGS} ./... + +test: + @echo "+ $@" + @go test -test.short -tags "${DOCKER_BUILDTAGS}" ./... + +test-full: + @echo "+ $@" + @go test ./... + +binaries: ${PREFIX}/bin/registry ${PREFIX}/bin/registry-api-descriptor-template ${PREFIX}/bin/dist + @echo "+ $@" + +clean: + @echo "+ $@" + @rm -rf "${PREFIX}/bin/registry" "${PREFIX}/bin/registry-api-descriptor-template" + + diff --git a/vendor/src/github.com/docker/distribution/README.md b/vendor/src/github.com/docker/distribution/README.md new file mode 100644 index 0000000000..ddc791affc --- /dev/null +++ b/vendor/src/github.com/docker/distribution/README.md @@ -0,0 +1,121 @@ +# Distribution + +The Docker toolset to pack, ship, store, and deliver content. + +This repository's main product is the Docker Registry 2.0 implementation +for storing and distributing Docker images. It supersedes the [docker/docker- +registry](https://github.com/docker/docker-registry) project with a new API +design, focused around security and performance. + + + +This repository contains the following components: + +|**Component** |Description | +|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **registry** | An implementation of the [Docker Registry HTTP API V2](docs/spec/api.md) for use with docker 1.6+. | +| **libraries** | A rich set of libraries for interacting with,distribution components. Please see [godoc](http://godoc.org/github.com/docker/distribution) for details. **Note**: These libraries are **unstable**. | +| **dist** | An _experimental_ tool to provide distribution, oriented functionality without the `docker` daemon. | +| **specifications** | _Distribution_ related specifications are available in [docs/spec](docs/spec) | +| **documentation** | Docker's full documentation set is available at [docs.docker.com](http://docs.docker.com). This repository [contains the subset](docs/index.md) related just to the registry. | + +### How does this integrate with Docker engine? + +This project should provide an implementation to a V2 API for use in the [Docker +core project](https://github.com/docker/docker). The API should be embeddable +and simplify the process of securely pulling and pushing content from `docker` +daemons. + +### What are the long term goals of the Distribution project? + +The _Distribution_ project has the further long term goal of providing a +secure tool chain for distributing content. The specifications, APIs and tools +should be as useful with Docker as they are without. + +Our goal is to design a professional grade and extensible content distribution +system that allow users to: + +* Enjoy an efficient, secured and reliable way to store, manage, package and + exchange content +* Hack/roll their own on top of healthy open-source components +* Implement their own home made solution through good specs, and solid + extensions mechanism. + +## More about Registry 2.0 + +The new registry implementation provides the following benefits: + +- faster push and pull +- new, more efficient implementation +- simplified deployment +- pluggable storage backend +- webhook notifications + +For information on upcoming functionality, please see [ROADMAP.md](ROADMAP.md). + +### Who needs to deploy a registry? + +By default, Docker users pull images from Docker's public registry instance. +[Installing Docker](http://docs.docker.com/installation) gives users this +ability. Users can also push images to a repository on Docker's public registry, +if they have a [Docker Hub](https://hub.docker.com/) account. + +For some users and even companies, this default behavior is sufficient. For +others, it is not. + +For example, users with their own software products may want to maintain a +registry for private, company images. Also, you may wish to deploy your own +image repository for images used to test or in continuous integration. For these +use cases and others, [deploying your own registry instance](docs/deploying.md) +may be the better choice. + +## Contribute + +Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute +issues, fixes, and patches to this project. If you are contributing code, see +the instructions for [building a development environment](docs/building.md). + +## Support + +If any issues are encountered while using the _Distribution_ project, several +avenues are available for support: + + + + + + + + + + + + + + + + + + +
+ IRC + + #docker-distribution on FreeNode +
+ Issue Tracker + + github.com/docker/distribution/issues +
+ Google Groups + + https://groups.google.com/a/dockerproject.org/forum/#!forum/distribution +
+ Mailing List + + docker@dockerproject.org +
+ + +## License + +This project is distributed under [Apache License, Version 2.0](LICENSE.md). diff --git a/vendor/src/github.com/docker/distribution/ROADMAP.md b/vendor/src/github.com/docker/distribution/ROADMAP.md new file mode 100644 index 0000000000..cbf53881ee --- /dev/null +++ b/vendor/src/github.com/docker/distribution/ROADMAP.md @@ -0,0 +1,273 @@ +# Roadmap + +The Distribution Project consists of several components, some of which are +still being defined. This document defines the high-level goals of the +project, identifies the current components, and defines the release- +relationship to the Docker Platform. + +* [Distribution Goals](#distribution-goals) +* [Distribution Components](#distribution-components) +* [Project Planning](#project-planning): release-relationship to the Docker Platform. + +This road map is a living document, providing an overview of the goals and +considerations made in respect of the future of the project. + +## Distribution Goals + +- Replace the existing [docker registry](github.com/docker/docker-registry) + implementation as the primary implementation. +- Replace the existing push and pull code in the docker engine with the + distribution package. +- Define a strong data model for distributing docker images +- Provide a flexible distribution tool kit for use in the docker platform +- Unlock new distribution models + +## Distribution Components + +Components of the Distribution Project are managed via github [milestones](https://github.com/docker/distribution/milestones). Upcoming +features and bugfixes for a component will be added to the relevant milestone. If a feature or +bugfix is not part of a milestone, it is currently unscheduled for +implementation. + +* [Registry](#registry) +* [Distribution Package](#distribution-package) + +*** + +### Registry + +The new Docker registry is the main portion of the distribution repository. +Registry 2.0 is the first release of the next-generation registry. This was +primarily focused on implementing the [new registry +API](https://github.com/docker/distribution/blob/master/docs/spec/api.md), +with a focus on security and performance. + +Following from the Distribution project goals above, we have a set of goals +for registry v2 that we would like to follow in the design. New features +should be compared against these goals. + +#### Data Storage and Distribution First + +The registry's first goal is to provide a reliable, consistent storage +location for Docker images. The registry should only provide the minimal +amount of indexing required to fetch image data and no more. + +This means we should be selective in new features and API additions, including +those that may require expensive, ever growing indexes. Requests should be +servable in "constant time". + +#### Content Addressability + +All data objects used in the registry API should be content addressable. +Content identifiers should be secure and verifiable. This provides a secure, +reliable base from which to build more advanced content distribution systems. + +#### Content Agnostic + +In the past, changes to the image format would require large changes in Docker +and the Registry. By decoupling the distribution and image format, we can +allow the formats to progress without having to coordinate between the two. +This means that we should be focused on decoupling Docker from the registry +just as much as decoupling the registry from Docker. Such an approach will +allow us to unlock new distribution models that haven't been possible before. + +We can take this further by saying that the new registry should be content +agnostic. The registry provides a model of names, tags, manifests and content +addresses and that model can be used to work with content. + +#### Simplicity + +The new registry should be closer to a microservice component than its +predecessor. This means it should have a narrower API and a low number of +service dependencies. It should be easy to deploy. + +This means that other solutions should be explored before changing the API or +adding extra dependencies. If functionality is required, can it be added as an +extension or companion service. + +#### Extensibility + +The registry should provide extension points to add functionality. By keeping +the scope narrow, but providing the ability to add functionality. + +Features like search, indexing, synchronization and registry explorers fall +into this category. No such feature should be added unless we've found it +impossible to do through an extension. + +#### Active Feature Discussions + +The following are feature discussions that are currently active. + +If you don't see your favorite, unimplemented feature, feel free to contact us +via IRC or the mailing list and we can talk about adding it. The goal here is +to make sure that new features go through a rigid design process before +landing in the registry. + +##### Mirroring and Pull-through Caching + +Mirroring and pull-through caching are related but slight different. We've +adopted the term _mirroring_ to be a proper mirror of a registry, meaning it +has all the content the upstream would have. Providing such mirrors in the +Docker ecosystem is dependent on a solid trust system, which is still in the +works. + +The more commonly helpful feature is _pull-through caching_, where data is +fetched from an upstream when not available in a local registry instance. + +Please see the following issues: + +- https://github.com/docker/distribution/issues/459 + +##### Peer to Peer transfer + +Discussion has started here: https://docs.google.com/document/d/1rYDpSpJiQWmCQy8Cuiaa3NH-Co33oK_SC9HeXYo87QA/edit + +##### Indexing, Search and Discovery + +The original registry provided some implementation of search for use with +private registries. Support has been elided from V2 since we'd like to both +decouple search functionality from the registry. The makes the registry +simpler to deploy, especially in use cases where search is not needed, and +let's us decouple the image format from the registry. + +There are explorations into using the catalog API and notification system to +build external indexes. The current line of thought is that we will define a +common search API to index and query docker images. Such a system could be run +as a companion to a registry or set of registries to power discovery. + +The main issue with search and discovery is that there are so many ways to +accomplish it. There are two aspects to this project. The first is deciding on +how it will be done, including an API definition that can work with changing +data formats. The second is the process of integrating with `docker search`. +We expect that someone attempts to address the problem with the existing tools +and propose it as a standard search API or uses it to inform a standardization +process. Once this has been explored, we integrate with the docker client. + +Please see the following for more detail: + +- https://github.com/docker/distribution/issues/206 + +##### Deletes + +> __NOTE:__ Deletes are a much asked for feature. Before requesting this +feature or participating in discussion, we ask that you read this section in +full and understand the problems behind deletes. + +While, at first glance, implementing deleting seems simple, there are a number +mitigating factors that make many solutions not ideal or even pathological in +the context of a registry. The following paragraph discuss the background and +approaches that could be applied to a arrive at a solution. + +The goal of deletes in any system is to remove unused or unneeded data. Only +data requested for deletion should be removed and no other data. Removing +unintended data is worse than _not_ removing data that was requested for +removal but ideally, both are supported. Generally, according to this rule, we +err on holding data longer than needed, ensuring that it is only removed when +we can be certain that it can be removed. With the current behavior, we opt to +hold onto the data forever, ensuring that data cannot be incorrectly removed. + +To understand the problems with implementing deletes, one must understand the +data model. All registry data is stored in a filesystem layout, implemented on +a "storage driver", effectively a _virtual file system_ (VFS). The storage +system must assume that this VFS layer will be eventually consistent and has +poor read- after-write consistency, since this is the lower common denominator +among the storage drivers. This is mitigated by writing values in reverse- +dependent order, but makes wider transactional operations unsafe. + +Layered on the VFS model is a content-addressable _directed, acyclic graph_ +(DAG) made up of blobs. Manifests reference layers. Tags reference manifests. +Since the same data can be referenced by multiple manifests, we only store +data once, even if it is in different repositories. Thus, we have a set of +blobs, referenced by tags and manifests. If we want to delete a blob we need +to be certain that it is no longer referenced by another manifest or tag. When +we delete a manifest, we also can try to delete the referenced blobs. Deciding +whether or not a blob has an active reference is the crux of the problem. + +Conceptually, deleting a manifest and its resources is quite simple. Just find +all the manifests, enumerate the referenced blobs and delete the blobs not in +that set. An astute observer will recognize this as a garbage collection +problem. As with garbage collection in programming languages, this is very +simple when one always has a consistent view. When one adds parallelism and an +inconsistent view of data, it becomes very challenging. + +A simple example can demonstrate this. Let's say we are deleting a manifest +_A_ in one process. We scan the manifest and decide that all the blobs are +ready for deletion. Concurrently, we have another process accepting a new +manifest _B_ referencing one or more blobs from the manifest _A_. Manifest _B_ +is accepted and all the blobs are considered present, so the operation +proceeds. The original process then deletes the referenced blobs, assuming +they were unreferenced. The manifest _B_, which we thought had all of its data +present, can no longer be served by the registry, since the dependent data has +been deleted. + +Deleting data from the registry safely requires some way to coordinate this +operation. The following approaches are being considered: + +- _Reference Counting_ - Maintain a count of references to each blob. This is + challenging for a number of reasons: 1. maintaining a consistent consensus + of reference counts across a set of Registries and 2. Building the initial + list of reference counts for an existing registry. These challenges can be + met with a consensus protocol like Paxos or Raft in the first case and a + necessary but simple scan in the second.. +- _Lock the World GC_ - Halt all writes to the data store. Walk the data store + and find all blob references. Delete all unreferenced blobs. This approach + is very simple but requires disabling writes for a period of time while the + service reads all data. This is slow and expensive but very accurate and + effective. +- _Generational GC_ - Do something similar to above but instead of blocking + writes, writes are sent to another storage backend while reads are broadcast + to the new and old backends. GC is then performed on the read-only portion. + Because writes land in the new backend, the data in the read-only section + can be safely deleted. The main drawbacks of this approach are complexity + and coordination. +- _Centralized Oracle_ - Using a centralized, transactional database, we can + know exactly which data is referenced at any given time. This avoids + coordination problem by managing this data in a single location. We trade + off metadata scalability for simplicity and performance. This is a very good + option for most registry deployments. This would create a bottleneck for + registry metadata. However, metadata is generally not the main bottleneck + when serving images. + +Please let us know if other solutions exist that we have yet to enumerate. +Note that for any approach, implementation is a massive consideration. For +example, a mark-sweep based solution may seem simple but the amount of work in +coordination offset the extra work it might take to build a _Centralized +Oracle_. We'll accept proposals for any solution but please coordinate with us +before dropping code. + +At this time, we have traded off simplicity and ease of deployment for disk +space. Simplicity and ease of deployment tend to reduce developer involvement, +which is currently the most expensive resource in software engineering. Taking +on any solution for deletes will greatly effect these factors, trading off +very cheap disk space for a complex deployment and operational story. + +Please see the following issues for more detail: + +- https://github.com/docker/distribution/issues/422 +- https://github.com/docker/distribution/issues/461 +- https://github.com/docker/distribution/issues/462 + +### Distribution Package + +At its core, the Distribution Project is a set of Go packages that make up +Distribution Components. At this time, most of these packages make up the +Registry implementation. + +The package itself is considered unstable. If you're using it, please take care to vendor the dependent version. + +For feature additions, please see the Registry section. In the future, we may break out a +separate Roadmap for distribution-specific features that apply to more than +just the registry. + +*** + +### Project Planning + +Distribution Components map to Docker Platform Releases via the use of labels. Project Pages are used to define the set of features that are included in each Docker Platform Release. + +| Platform Version | Label | Planning | +|-----------|------|-----| +| Docker 1.6 | [Docker/1.6](https://github.com/docker/distribution/labels/docker%2F1.6) | [Project Page](https://github.com/docker/distribution/wiki/docker-1.6-Project-Page) | +| Docker 1.7| [Docker/1.7](https://github.com/docker/distribution/labels/docker%2F1.7) | [Project Page](https://github.com/docker/distribution/wiki/docker-1.7-Project-Page) | +| Docker 1.8| [Docker/1.8](https://github.com/docker/distribution/labels/docker%2F1.8) | [Project Page](https://github.com/docker/distribution/wiki/docker-1.8-Project-Page) | + diff --git a/vendor/src/github.com/docker/distribution/blobs.go b/vendor/src/github.com/docker/distribution/blobs.go new file mode 100644 index 0000000000..ffec41e8a6 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/blobs.go @@ -0,0 +1,202 @@ +package distribution + +import ( + "errors" + "fmt" + "io" + "net/http" + "time" + + "github.com/docker/distribution/context" + "github.com/docker/distribution/digest" +) + +var ( + // ErrBlobExists returned when blob already exists + ErrBlobExists = errors.New("blob exists") + + // ErrBlobDigestUnsupported when blob digest is an unsupported version. + ErrBlobDigestUnsupported = errors.New("unsupported blob digest") + + // ErrBlobUnknown when blob is not found. + ErrBlobUnknown = errors.New("unknown blob") + + // ErrBlobUploadUnknown returned when upload is not found. + ErrBlobUploadUnknown = errors.New("blob upload unknown") + + // ErrBlobInvalidLength returned when the blob has an expected length on + // commit, meaning mismatched with the descriptor or an invalid value. + ErrBlobInvalidLength = errors.New("blob invalid length") + + // ErrUnsupported returned when an unsupported operation is attempted + ErrUnsupported = errors.New("unsupported operation") +) + +// ErrBlobInvalidDigest returned when digest check fails. +type ErrBlobInvalidDigest struct { + Digest digest.Digest + Reason error +} + +func (err ErrBlobInvalidDigest) Error() string { + return fmt.Sprintf("invalid digest for referenced layer: %v, %v", + err.Digest, err.Reason) +} + +// Descriptor describes targeted content. Used in conjunction with a blob +// store, a descriptor can be used to fetch, store and target any kind of +// blob. The struct also describes the wire protocol format. Fields should +// only be added but never changed. +type Descriptor struct { + // MediaType describe the type of the content. All text based formats are + // encoded as utf-8. + MediaType string `json:"mediaType,omitempty"` + + // Size in bytes of content. + Size int64 `json:"size,omitempty"` + + // Digest uniquely identifies the content. A byte stream can be verified + // against against this digest. + Digest digest.Digest `json:"digest,omitempty"` + + // NOTE: Before adding a field here, please ensure that all + // other options have been exhausted. Much of the type relationships + // depend on the simplicity of this type. +} + +// BlobStatter makes blob descriptors available by digest. The service may +// provide a descriptor of a different digest if the provided digest is not +// canonical. +type BlobStatter interface { + // Stat provides metadata about a blob identified by the digest. If the + // blob is unknown to the describer, ErrBlobUnknown will be returned. + Stat(ctx context.Context, dgst digest.Digest) (Descriptor, error) +} + +// BlobDeleter enables deleting blobs from storage. +type BlobDeleter interface { + Delete(ctx context.Context, dgst digest.Digest) error +} + +// BlobDescriptorService manages metadata about a blob by digest. Most +// implementations will not expose such an interface explicitly. Such mappings +// should be maintained by interacting with the BlobIngester. Hence, this is +// left off of BlobService and BlobStore. +type BlobDescriptorService interface { + BlobStatter + + // SetDescriptor assigns the descriptor to the digest. The provided digest and + // the digest in the descriptor must map to identical content but they may + // differ on their algorithm. The descriptor must have the canonical + // digest of the content and the digest algorithm must match the + // annotators canonical algorithm. + // + // Such a facility can be used to map blobs between digest domains, with + // the restriction that the algorithm of the descriptor must match the + // canonical algorithm (ie sha256) of the annotator. + SetDescriptor(ctx context.Context, dgst digest.Digest, desc Descriptor) error + + // Clear enables descriptors to be unlinked + Clear(ctx context.Context, dgst digest.Digest) error +} + +// ReadSeekCloser is the primary reader type for blob data, combining +// io.ReadSeeker with io.Closer. +type ReadSeekCloser interface { + io.ReadSeeker + io.Closer +} + +// BlobProvider describes operations for getting blob data. +type BlobProvider interface { + // Get returns the entire blob identified by digest along with the descriptor. + Get(ctx context.Context, dgst digest.Digest) ([]byte, error) + + // Open provides a ReadSeekCloser to the blob identified by the provided + // descriptor. If the blob is not known to the service, an error will be + // returned. + Open(ctx context.Context, dgst digest.Digest) (ReadSeekCloser, error) +} + +// BlobServer can serve blobs via http. +type BlobServer interface { + // ServeBlob attempts to serve the blob, identifed by dgst, via http. The + // service may decide to redirect the client elsewhere or serve the data + // directly. + // + // This handler only issues successful responses, such as 2xx or 3xx, + // meaning it serves data or issues a redirect. If the blob is not + // available, an error will be returned and the caller may still issue a + // response. + // + // The implementation may serve the same blob from a different digest + // domain. The appropriate headers will be set for the blob, unless they + // have already been set by the caller. + ServeBlob(ctx context.Context, w http.ResponseWriter, r *http.Request, dgst digest.Digest) error +} + +// BlobIngester ingests blob data. +type BlobIngester interface { + // Put inserts the content p into the blob service, returning a descriptor + // or an error. + Put(ctx context.Context, mediaType string, p []byte) (Descriptor, error) + + // Create allocates a new blob writer to add a blob to this service. The + // returned handle can be written to and later resumed using an opaque + // identifier. With this approach, one can Close and Resume a BlobWriter + // multiple times until the BlobWriter is committed or cancelled. + Create(ctx context.Context) (BlobWriter, error) + + // Resume attempts to resume a write to a blob, identified by an id. + Resume(ctx context.Context, id string) (BlobWriter, error) +} + +// BlobWriter provides a handle for inserting data into a blob store. +// Instances should be obtained from BlobWriteService.Writer and +// BlobWriteService.Resume. If supported by the store, a writer can be +// recovered with the id. +type BlobWriter interface { + io.WriteSeeker + io.ReaderFrom + io.Closer + + // ID returns the identifier for this writer. The ID can be used with the + // Blob service to later resume the write. + ID() string + + // StartedAt returns the time this blob write was started. + StartedAt() time.Time + + // Commit completes the blob writer process. The content is verified + // against the provided provisional descriptor, which may result in an + // error. Depending on the implementation, written data may be validated + // against the provisional descriptor fields. If MediaType is not present, + // the implementation may reject the commit or assign "application/octet- + // stream" to the blob. The returned descriptor may have a different + // digest depending on the blob store, referred to as the canonical + // descriptor. + Commit(ctx context.Context, provisional Descriptor) (canonical Descriptor, err error) + + // Cancel ends the blob write without storing any data and frees any + // associated resources. Any data written thus far will be lost. Cancel + // implementations should allow multiple calls even after a commit that + // result in a no-op. This allows use of Cancel in a defer statement, + // increasing the assurance that it is correctly called. + Cancel(ctx context.Context) error +} + +// BlobService combines the operations to access, read and write blobs. This +// can be used to describe remote blob services. +type BlobService interface { + BlobStatter + BlobProvider + BlobIngester +} + +// BlobStore represent the entire suite of blob related operations. Such an +// implementation can access, read, write, delete and serve blobs. +type BlobStore interface { + BlobService + BlobServer + BlobDeleter +} diff --git a/vendor/src/github.com/docker/distribution/circle.yml b/vendor/src/github.com/docker/distribution/circle.yml new file mode 100644 index 0000000000..e43ecb66d4 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/circle.yml @@ -0,0 +1,122 @@ +# Pony-up! +machine: + pre: + # Install gvm + - bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/1.0.22/binscripts/gvm-installer) + # Install ceph to test rados driver & create pool + - sudo -i ~/distribution/contrib/ceph/ci-setup.sh + - ceph osd pool create docker-distribution 1 + + post: + # Install many go versions + # - gvm install go1.3.3 -B --name=old + - gvm install go1.4.2 -B --name=stable + # - gvm install tip --name=bleed + + environment: + # Convenient shortcuts to "common" locations + CHECKOUT: /home/ubuntu/$CIRCLE_PROJECT_REPONAME + BASE_DIR: src/github.com/$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME + # Trick circle brainflat "no absolute path" behavior + BASE_OLD: ../../../$HOME/.gvm/pkgsets/old/global/$BASE_DIR + BASE_STABLE: ../../../$HOME/.gvm/pkgsets/stable/global/$BASE_DIR + # BASE_BLEED: ../../../$HOME/.gvm/pkgsets/bleed/global/$BASE_DIR + DOCKER_BUILDTAGS: "include_rados" + # Workaround Circle parsing dumb bugs and/or YAML wonkyness + CIRCLE_PAIN: "mode: set" + # Ceph config + RADOS_POOL: "docker-distribution" + + hosts: + # Not used yet + fancy: 127.0.0.1 + +dependencies: + pre: + # Copy the code to the gopath of all go versions + # - > + # gvm use old && + # mkdir -p "$(dirname $BASE_OLD)" && + # cp -R "$CHECKOUT" "$BASE_OLD" + + - > + gvm use stable && + mkdir -p "$(dirname $BASE_STABLE)" && + cp -R "$CHECKOUT" "$BASE_STABLE" + + # - > + # gvm use bleed && + # mkdir -p "$(dirname $BASE_BLEED)" && + # cp -R "$CHECKOUT" "$BASE_BLEED" + + override: + # Install dependencies for every copied clone/go version + # - gvm use old && go get github.com/tools/godep: + # pwd: $BASE_OLD + + - gvm use stable && go get github.com/tools/godep: + pwd: $BASE_STABLE + + # - gvm use bleed && go get github.com/tools/godep: + # pwd: $BASE_BLEED + + post: + # For the stable go version, additionally install linting tools + - > + gvm use stable && + go get github.com/axw/gocov/gocov github.com/golang/lint/golint + # Disabling goveralls for now + # go get github.com/axw/gocov/gocov github.com/mattn/goveralls github.com/golang/lint/golint + +test: + pre: + # Output the go versions we are going to test + # - gvm use old && go version + - gvm use stable && go version + # - gvm use bleed && go version + + # FMT + - gvm use stable && test -z "$(gofmt -s -l . | grep -v Godeps/_workspace/src/ | tee /dev/stderr)": + pwd: $BASE_STABLE + + # VET + - gvm use stable && go vet ./...: + pwd: $BASE_STABLE + + # LINT + - gvm use stable && test -z "$(golint ./... | grep -v Godeps/_workspace/src/ | tee /dev/stderr)": + pwd: $BASE_STABLE + + override: + # Test every version we have (but stable) + # - gvm use old; godep go test -test.v -test.short ./...: + # timeout: 600 + # pwd: $BASE_OLD + + # - gvm use bleed; go test -test.v -test.short ./...: + # timeout: 600 + # pwd: $BASE_BLEED + + # Test stable, and report + # Preset the goverall report file + - echo "$CIRCLE_PAIN" > ~/goverage.report + - gvm use stable; go list ./... | xargs -L 1 -I{} rm -f $GOPATH/src/{}/coverage.out: + pwd: $BASE_STABLE + - gvm use stable; go list -tags "$DOCKER_BUILDTAGS" ./... | xargs -L 1 -I{} godep go test -tags "$DOCKER_BUILDTAGS" -test.short -coverprofile=$GOPATH/src/{}/coverage.out {}: + timeout: 600 + pwd: $BASE_STABLE + + post: + # Aggregate and report to coveralls + - gvm use stable; go list ./... | xargs -L 1 -I{} cat "$GOPATH/src/{}/coverage.out" | grep -v "$CIRCLE_PAIN" >> ~/goverage.report: + pwd: $BASE_STABLE +# - gvm use stable; goveralls -service circleci -coverprofile=/home/ubuntu/goverage.report -repotoken $COVERALLS_TOKEN: +# pwd: $BASE_STABLE + + ## Notes + # Disabled coveralls reporting: build breaking sending coverage data to coveralls + # Disabled the -race detector due to massive memory usage. + # Do we want these as well? + # - go get code.google.com/p/go.tools/cmd/goimports + # - test -z "$(goimports -l -w ./... | tee /dev/stderr)" + # http://labix.org/gocheck diff --git a/vendor/src/github.com/docker/distribution/context/context.go b/vendor/src/github.com/docker/distribution/context/context.go new file mode 100644 index 0000000000..23cbf5b545 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/context/context.go @@ -0,0 +1,85 @@ +package context + +import ( + "sync" + + "github.com/docker/distribution/uuid" + "golang.org/x/net/context" +) + +// Context is a copy of Context from the golang.org/x/net/context package. +type Context interface { + context.Context +} + +// instanceContext is a context that provides only an instance id. It is +// provided as the main background context. +type instanceContext struct { + Context + id string // id of context, logged as "instance.id" + once sync.Once // once protect generation of the id +} + +func (ic *instanceContext) Value(key interface{}) interface{} { + if key == "instance.id" { + ic.once.Do(func() { + // We want to lazy initialize the UUID such that we don't + // call a random generator from the package initialization + // code. For various reasons random could not be available + // https://github.com/docker/distribution/issues/782 + ic.id = uuid.Generate().String() + }) + return ic.id + } + + return ic.Context.Value(key) +} + +var background = &instanceContext{ + Context: context.Background(), +} + +// Background returns a non-nil, empty Context. The background context +// provides a single key, "instance.id" that is globally unique to the +// process. +func Background() Context { + return background +} + +// WithValue returns a copy of parent in which the value associated with key is +// val. Use context Values only for request-scoped data that transits processes +// and APIs, not for passing optional parameters to functions. +func WithValue(parent Context, key, val interface{}) Context { + return context.WithValue(parent, key, val) +} + +// stringMapContext is a simple context implementation that checks a map for a +// key, falling back to a parent if not present. +type stringMapContext struct { + context.Context + m map[string]interface{} +} + +// WithValues returns a context that proxies lookups through a map. Only +// supports string keys. +func WithValues(ctx context.Context, m map[string]interface{}) context.Context { + mo := make(map[string]interface{}, len(m)) // make our own copy. + for k, v := range m { + mo[k] = v + } + + return stringMapContext{ + Context: ctx, + m: mo, + } +} + +func (smc stringMapContext) Value(key interface{}) interface{} { + if ks, ok := key.(string); ok { + if v, ok := smc.m[ks]; ok { + return v + } + } + + return smc.Context.Value(key) +} diff --git a/vendor/src/github.com/docker/distribution/context/doc.go b/vendor/src/github.com/docker/distribution/context/doc.go new file mode 100644 index 0000000000..a63989e54d --- /dev/null +++ b/vendor/src/github.com/docker/distribution/context/doc.go @@ -0,0 +1,76 @@ +// Package context provides several utilities for working with +// golang.org/x/net/context in http requests. Primarily, the focus is on +// logging relevent request information but this package is not limited to +// that purpose. +// +// Logging +// +// The most useful aspect of this package is GetLogger. This function takes +// any context.Context interface and returns the current logger from the +// context. Canonical usage looks like this: +// +// GetLogger(ctx).Infof("something interesting happened") +// +// GetLogger also takes optional key arguments. The keys will be looked up in +// the context and reported with the logger. The following example would +// return a logger that prints the version with each log message: +// +// ctx := context.Context(context.Background(), "version", version) +// GetLogger(ctx, "version").Infof("this log message has a version field") +// +// The above would print out a log message like this: +// +// INFO[0000] this log message has a version field version=v2.0.0-alpha.2.m +// +// When used with WithLogger, we gain the ability to decorate the context with +// loggers that have information from disparate parts of the call stack. +// Following from the version example, we can build a new context with the +// configured logger such that we always print the version field: +// +// ctx = WithLogger(ctx, GetLogger(ctx, "version")) +// +// Since the logger has been pushed to the context, we can now get the version +// field for free with our log messages. Future calls to GetLogger on the new +// context will have the version field: +// +// GetLogger(ctx).Infof("this log message has a version field") +// +// This becomes more powerful when we start stacking loggers. Let's say we +// have the version logger from above but also want a request id. Using the +// context above, in our request scoped function, we place another logger in +// the context: +// +// ctx = context.WithValue(ctx, "http.request.id", "unique id") // called when building request context +// ctx = WithLogger(ctx, GetLogger(ctx, "http.request.id")) +// +// When GetLogger is called on the new context, "http.request.id" will be +// included as a logger field, along with the original "version" field: +// +// INFO[0000] this log message has a version field http.request.id=unique id version=v2.0.0-alpha.2.m +// +// Note that this only affects the new context, the previous context, with the +// version field, can be used independently. Put another way, the new logger, +// added to the request context, is unique to that context and can have +// request scoped varaibles. +// +// HTTP Requests +// +// This package also contains several methods for working with http requests. +// The concepts are very similar to those described above. We simply place the +// request in the context using WithRequest. This makes the request variables +// available. GetRequestLogger can then be called to get request specific +// variables in a log line: +// +// ctx = WithRequest(ctx, req) +// GetRequestLogger(ctx).Infof("request variables") +// +// Like above, if we want to include the request data in all log messages in +// the context, we push the logger to a new context and use that one: +// +// ctx = WithLogger(ctx, GetRequestLogger(ctx)) +// +// The concept is fairly powerful and ensures that calls throughout the stack +// can be traced in log messages. Using the fields like "http.request.id", one +// can analyze call flow for a particular request with a simple grep of the +// logs. +package context diff --git a/vendor/src/github.com/docker/distribution/context/http.go b/vendor/src/github.com/docker/distribution/context/http.go new file mode 100644 index 0000000000..8413a14622 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/context/http.go @@ -0,0 +1,336 @@ +package context + +import ( + "errors" + "net" + "net/http" + "strings" + "sync" + "time" + + log "github.com/Sirupsen/logrus" + "github.com/docker/distribution/uuid" + "github.com/gorilla/mux" +) + +// Common errors used with this package. +var ( + ErrNoRequestContext = errors.New("no http request in context") + ErrNoResponseWriterContext = errors.New("no http response in context") +) + +func parseIP(ipStr string) net.IP { + ip := net.ParseIP(ipStr) + if ip == nil { + log.Warnf("invalid remote IP address: %q", ipStr) + } + return ip +} + +// RemoteAddr extracts the remote address of the request, taking into +// account proxy headers. +func RemoteAddr(r *http.Request) string { + if prior := r.Header.Get("X-Forwarded-For"); prior != "" { + proxies := strings.Split(prior, ",") + if len(proxies) > 0 { + remoteAddr := strings.Trim(proxies[0], " ") + if parseIP(remoteAddr) != nil { + return remoteAddr + } + } + } + // X-Real-Ip is less supported, but worth checking in the + // absence of X-Forwarded-For + if realIP := r.Header.Get("X-Real-Ip"); realIP != "" { + if parseIP(realIP) != nil { + return realIP + } + } + + return r.RemoteAddr +} + +// RemoteIP extracts the remote IP of the request, taking into +// account proxy headers. +func RemoteIP(r *http.Request) string { + addr := RemoteAddr(r) + + // Try parsing it as "IP:port" + if ip, _, err := net.SplitHostPort(addr); err == nil { + return ip + } + + return addr +} + +// WithRequest places the request on the context. The context of the request +// is assigned a unique id, available at "http.request.id". The request itself +// is available at "http.request". Other common attributes are available under +// the prefix "http.request.". If a request is already present on the context, +// this method will panic. +func WithRequest(ctx Context, r *http.Request) Context { + if ctx.Value("http.request") != nil { + // NOTE(stevvooe): This needs to be considered a programming error. It + // is unlikely that we'd want to have more than one request in + // context. + panic("only one request per context") + } + + return &httpRequestContext{ + Context: ctx, + startedAt: time.Now(), + id: uuid.Generate().String(), + r: r, + } +} + +// GetRequest returns the http request in the given context. Returns +// ErrNoRequestContext if the context does not have an http request associated +// with it. +func GetRequest(ctx Context) (*http.Request, error) { + if r, ok := ctx.Value("http.request").(*http.Request); r != nil && ok { + return r, nil + } + return nil, ErrNoRequestContext +} + +// GetRequestID attempts to resolve the current request id, if possible. An +// error is return if it is not available on the context. +func GetRequestID(ctx Context) string { + return GetStringValue(ctx, "http.request.id") +} + +// WithResponseWriter returns a new context and response writer that makes +// interesting response statistics available within the context. +func WithResponseWriter(ctx Context, w http.ResponseWriter) (Context, http.ResponseWriter) { + irw := &instrumentedResponseWriter{ + ResponseWriter: w, + Context: ctx, + } + + return irw, irw +} + +// GetResponseWriter returns the http.ResponseWriter from the provided +// context. If not present, ErrNoResponseWriterContext is returned. The +// returned instance provides instrumentation in the context. +func GetResponseWriter(ctx Context) (http.ResponseWriter, error) { + v := ctx.Value("http.response") + + rw, ok := v.(http.ResponseWriter) + if !ok || rw == nil { + return nil, ErrNoResponseWriterContext + } + + return rw, nil +} + +// getVarsFromRequest let's us change request vars implementation for testing +// and maybe future changes. +var getVarsFromRequest = mux.Vars + +// WithVars extracts gorilla/mux vars and makes them available on the returned +// context. Variables are available at keys with the prefix "vars.". For +// example, if looking for the variable "name", it can be accessed as +// "vars.name". Implementations that are accessing values need not know that +// the underlying context is implemented with gorilla/mux vars. +func WithVars(ctx Context, r *http.Request) Context { + return &muxVarsContext{ + Context: ctx, + vars: getVarsFromRequest(r), + } +} + +// GetRequestLogger returns a logger that contains fields from the request in +// the current context. If the request is not available in the context, no +// fields will display. Request loggers can safely be pushed onto the context. +func GetRequestLogger(ctx Context) Logger { + return GetLogger(ctx, + "http.request.id", + "http.request.method", + "http.request.host", + "http.request.uri", + "http.request.referer", + "http.request.useragent", + "http.request.remoteaddr", + "http.request.contenttype") +} + +// GetResponseLogger reads the current response stats and builds a logger. +// Because the values are read at call time, pushing a logger returned from +// this function on the context will lead to missing or invalid data. Only +// call this at the end of a request, after the response has been written. +func GetResponseLogger(ctx Context) Logger { + l := getLogrusLogger(ctx, + "http.response.written", + "http.response.status", + "http.response.contenttype") + + duration := Since(ctx, "http.request.startedat") + + if duration > 0 { + l = l.WithField("http.response.duration", duration.String()) + } + + return l +} + +// httpRequestContext makes information about a request available to context. +type httpRequestContext struct { + Context + + startedAt time.Time + id string + r *http.Request +} + +// Value returns a keyed element of the request for use in the context. To get +// the request itself, query "request". For other components, access them as +// "request.". For example, r.RequestURI +func (ctx *httpRequestContext) Value(key interface{}) interface{} { + if keyStr, ok := key.(string); ok { + if keyStr == "http.request" { + return ctx.r + } + + if !strings.HasPrefix(keyStr, "http.request.") { + goto fallback + } + + parts := strings.Split(keyStr, ".") + + if len(parts) != 3 { + goto fallback + } + + switch parts[2] { + case "uri": + return ctx.r.RequestURI + case "remoteaddr": + return RemoteAddr(ctx.r) + case "method": + return ctx.r.Method + case "host": + return ctx.r.Host + case "referer": + referer := ctx.r.Referer() + if referer != "" { + return referer + } + case "useragent": + return ctx.r.UserAgent() + case "id": + return ctx.id + case "startedat": + return ctx.startedAt + case "contenttype": + ct := ctx.r.Header.Get("Content-Type") + if ct != "" { + return ct + } + } + } + +fallback: + return ctx.Context.Value(key) +} + +type muxVarsContext struct { + Context + vars map[string]string +} + +func (ctx *muxVarsContext) Value(key interface{}) interface{} { + if keyStr, ok := key.(string); ok { + if keyStr == "vars" { + return ctx.vars + } + + if strings.HasPrefix(keyStr, "vars.") { + keyStr = strings.TrimPrefix(keyStr, "vars.") + } + + if v, ok := ctx.vars[keyStr]; ok { + return v + } + } + + return ctx.Context.Value(key) +} + +// instrumentedResponseWriter provides response writer information in a +// context. +type instrumentedResponseWriter struct { + http.ResponseWriter + Context + + mu sync.Mutex + status int + written int64 +} + +func (irw *instrumentedResponseWriter) Write(p []byte) (n int, err error) { + n, err = irw.ResponseWriter.Write(p) + + irw.mu.Lock() + irw.written += int64(n) + + // Guess the likely status if not set. + if irw.status == 0 { + irw.status = http.StatusOK + } + + irw.mu.Unlock() + + return +} + +func (irw *instrumentedResponseWriter) WriteHeader(status int) { + irw.ResponseWriter.WriteHeader(status) + + irw.mu.Lock() + irw.status = status + irw.mu.Unlock() +} + +func (irw *instrumentedResponseWriter) Flush() { + if flusher, ok := irw.ResponseWriter.(http.Flusher); ok { + flusher.Flush() + } +} + +func (irw *instrumentedResponseWriter) Value(key interface{}) interface{} { + if keyStr, ok := key.(string); ok { + if keyStr == "http.response" { + return irw + } + + if !strings.HasPrefix(keyStr, "http.response.") { + goto fallback + } + + parts := strings.Split(keyStr, ".") + + if len(parts) != 3 { + goto fallback + } + + irw.mu.Lock() + defer irw.mu.Unlock() + + switch parts[2] { + case "written": + return irw.written + case "status": + return irw.status + case "contenttype": + contentType := irw.Header().Get("Content-Type") + if contentType != "" { + return contentType + } + } + } + +fallback: + return irw.Context.Value(key) +} diff --git a/vendor/src/github.com/docker/distribution/context/logger.go b/vendor/src/github.com/docker/distribution/context/logger.go new file mode 100644 index 0000000000..78e4212a0b --- /dev/null +++ b/vendor/src/github.com/docker/distribution/context/logger.go @@ -0,0 +1,101 @@ +package context + +import ( + "fmt" + + "github.com/Sirupsen/logrus" +) + +// Logger provides a leveled-logging interface. +type Logger interface { + // standard logger methods + Print(args ...interface{}) + Printf(format string, args ...interface{}) + Println(args ...interface{}) + + Fatal(args ...interface{}) + Fatalf(format string, args ...interface{}) + Fatalln(args ...interface{}) + + Panic(args ...interface{}) + Panicf(format string, args ...interface{}) + Panicln(args ...interface{}) + + // Leveled methods, from logrus + Debug(args ...interface{}) + Debugf(format string, args ...interface{}) + Debugln(args ...interface{}) + + Error(args ...interface{}) + Errorf(format string, args ...interface{}) + Errorln(args ...interface{}) + + Info(args ...interface{}) + Infof(format string, args ...interface{}) + Infoln(args ...interface{}) + + Warn(args ...interface{}) + Warnf(format string, args ...interface{}) + Warnln(args ...interface{}) +} + +// WithLogger creates a new context with provided logger. +func WithLogger(ctx Context, logger Logger) Context { + return WithValue(ctx, "logger", logger) +} + +// GetLoggerWithField returns a logger instance with the specified field key +// and value without affecting the context. Extra specified keys will be +// resolved from the context. +func GetLoggerWithField(ctx Context, key, value interface{}, keys ...interface{}) Logger { + return getLogrusLogger(ctx, keys...).WithField(fmt.Sprint(key), value) +} + +// GetLoggerWithFields returns a logger instance with the specified fields +// without affecting the context. Extra specified keys will be resolved from +// the context. +func GetLoggerWithFields(ctx Context, fields map[string]interface{}, keys ...interface{}) Logger { + return getLogrusLogger(ctx, keys...).WithFields(logrus.Fields(fields)) +} + +// GetLogger returns the logger from the current context, if present. If one +// or more keys are provided, they will be resolved on the context and +// included in the logger. While context.Value takes an interface, any key +// argument passed to GetLogger will be passed to fmt.Sprint when expanded as +// a logging key field. If context keys are integer constants, for example, +// its recommended that a String method is implemented. +func GetLogger(ctx Context, keys ...interface{}) Logger { + return getLogrusLogger(ctx, keys...) +} + +// GetLogrusLogger returns the logrus logger for the context. If one more keys +// are provided, they will be resolved on the context and included in the +// logger. Only use this function if specific logrus functionality is +// required. +func getLogrusLogger(ctx Context, keys ...interface{}) *logrus.Entry { + var logger *logrus.Entry + + // Get a logger, if it is present. + loggerInterface := ctx.Value("logger") + if loggerInterface != nil { + if lgr, ok := loggerInterface.(*logrus.Entry); ok { + logger = lgr + } + } + + if logger == nil { + // If no logger is found, just return the standard logger. + logger = logrus.NewEntry(logrus.StandardLogger()) + } + + fields := logrus.Fields{} + + for _, key := range keys { + v := ctx.Value(key) + if v != nil { + fields[fmt.Sprint(key)] = v + } + } + + return logger.WithFields(fields) +} diff --git a/vendor/src/github.com/docker/distribution/context/trace.go b/vendor/src/github.com/docker/distribution/context/trace.go new file mode 100644 index 0000000000..af4f1351e9 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/context/trace.go @@ -0,0 +1,104 @@ +package context + +import ( + "runtime" + "time" + + "github.com/docker/distribution/uuid" +) + +// WithTrace allocates a traced timing span in a new context. This allows a +// caller to track the time between calling WithTrace and the returned done +// function. When the done function is called, a log message is emitted with a +// "trace.duration" field, corresponding to the elapased time and a +// "trace.func" field, corresponding to the function that called WithTrace. +// +// The logging keys "trace.id" and "trace.parent.id" are provided to implement +// dapper-like tracing. This function should be complemented with a WithSpan +// method that could be used for tracing distributed RPC calls. +// +// The main benefit of this function is to post-process log messages or +// intercept them in a hook to provide timing data. Trace ids and parent ids +// can also be linked to provide call tracing, if so required. +// +// Here is an example of the usage: +// +// func timedOperation(ctx Context) { +// ctx, done := WithTrace(ctx) +// defer done("this will be the log message") +// // ... function body ... +// } +// +// If the function ran for roughly 1s, such a usage would emit a log message +// as follows: +// +// INFO[0001] this will be the log message trace.duration=1.004575763s trace.func=github.com/docker/distribution/context.traceOperation trace.id= ... +// +// Notice that the function name is automatically resolved, along with the +// package and a trace id is emitted that can be linked with parent ids. +func WithTrace(ctx Context) (Context, func(format string, a ...interface{})) { + if ctx == nil { + ctx = Background() + } + + pc, file, line, _ := runtime.Caller(1) + f := runtime.FuncForPC(pc) + ctx = &traced{ + Context: ctx, + id: uuid.Generate().String(), + start: time.Now(), + parent: GetStringValue(ctx, "trace.id"), + fnname: f.Name(), + file: file, + line: line, + } + + return ctx, func(format string, a ...interface{}) { + GetLogger(ctx, + "trace.duration", + "trace.id", + "trace.parent.id", + "trace.func", + "trace.file", + "trace.line"). + Debugf(format, a...) + } +} + +// traced represents a context that is traced for function call timing. It +// also provides fast lookup for the various attributes that are available on +// the trace. +type traced struct { + Context + id string + parent string + start time.Time + fnname string + file string + line int +} + +func (ts *traced) Value(key interface{}) interface{} { + switch key { + case "trace.start": + return ts.start + case "trace.duration": + return time.Since(ts.start) + case "trace.id": + return ts.id + case "trace.parent.id": + if ts.parent == "" { + return nil // must return nil to signal no parent. + } + + return ts.parent + case "trace.func": + return ts.fnname + case "trace.file": + return ts.file + case "trace.line": + return ts.line + } + + return ts.Context.Value(key) +} diff --git a/vendor/src/github.com/docker/distribution/context/util.go b/vendor/src/github.com/docker/distribution/context/util.go new file mode 100644 index 0000000000..c0aff00d28 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/context/util.go @@ -0,0 +1,32 @@ +package context + +import ( + "time" +) + +// Since looks up key, which should be a time.Time, and returns the duration +// since that time. If the key is not found, the value returned will be zero. +// This is helpful when inferring metrics related to context execution times. +func Since(ctx Context, key interface{}) time.Duration { + startedAtI := ctx.Value(key) + if startedAtI != nil { + if startedAt, ok := startedAtI.(time.Time); ok { + return time.Since(startedAt) + } + } + + return 0 +} + +// GetStringValue returns a string value from the context. The empty string +// will be returned if not found. +func GetStringValue(ctx Context, key string) (value string) { + stringi := ctx.Value(key) + if stringi != nil { + if valuev, ok := stringi.(string); ok { + value = valuev + } + } + + return value +} diff --git a/vendor/src/github.com/docker/distribution/digest/digest.go b/vendor/src/github.com/docker/distribution/digest/digest.go new file mode 100644 index 0000000000..689916859a --- /dev/null +++ b/vendor/src/github.com/docker/distribution/digest/digest.go @@ -0,0 +1,168 @@ +package digest + +import ( + "bytes" + "fmt" + "hash" + "io" + "io/ioutil" + "regexp" + "strings" + + "github.com/docker/docker/pkg/tarsum" +) + +const ( + // DigestTarSumV1EmptyTar is the digest for the empty tar file. + DigestTarSumV1EmptyTar = "tarsum.v1+sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" + + // DigestSha256EmptyTar is the canonical sha256 digest of empty data + DigestSha256EmptyTar = "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" +) + +// Digest allows simple protection of hex formatted digest strings, prefixed +// by their algorithm. Strings of type Digest have some guarantee of being in +// the correct format and it provides quick access to the components of a +// digest string. +// +// The following is an example of the contents of Digest types: +// +// sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc +// +// More important for this code base, this type is compatible with tarsum +// digests. For example, the following would be a valid Digest: +// +// tarsum+sha256:e58fcf7418d4390dec8e8fb69d88c06ec07039d651fedd3aa72af9972e7d046b +// +// This allows to abstract the digest behind this type and work only in those +// terms. +type Digest string + +// NewDigest returns a Digest from alg and a hash.Hash object. +func NewDigest(alg Algorithm, h hash.Hash) Digest { + return Digest(fmt.Sprintf("%s:%x", alg, h.Sum(nil))) +} + +// NewDigestFromHex returns a Digest from alg and a the hex encoded digest. +func NewDigestFromHex(alg, hex string) Digest { + return Digest(fmt.Sprintf("%s:%s", alg, hex)) +} + +// DigestRegexp matches valid digest types. +var DigestRegexp = regexp.MustCompile(`[a-zA-Z0-9-_+.]+:[a-fA-F0-9]+`) + +// DigestRegexpAnchored matches valid digest types, anchored to the start and end of the match. +var DigestRegexpAnchored = regexp.MustCompile(`^` + DigestRegexp.String() + `$`) + +var ( + // ErrDigestInvalidFormat returned when digest format invalid. + ErrDigestInvalidFormat = fmt.Errorf("invalid checksum digest format") + + // ErrDigestUnsupported returned when the digest algorithm is unsupported. + ErrDigestUnsupported = fmt.Errorf("unsupported digest algorithm") +) + +// ParseDigest parses s and returns the validated digest object. An error will +// be returned if the format is invalid. +func ParseDigest(s string) (Digest, error) { + d := Digest(s) + + return d, d.Validate() +} + +// FromReader returns the most valid digest for the underlying content. +func FromReader(rd io.Reader) (Digest, error) { + digester := Canonical.New() + + if _, err := io.Copy(digester.Hash(), rd); err != nil { + return "", err + } + + return digester.Digest(), nil +} + +// FromTarArchive produces a tarsum digest from reader rd. +func FromTarArchive(rd io.Reader) (Digest, error) { + ts, err := tarsum.NewTarSum(rd, true, tarsum.Version1) + if err != nil { + return "", err + } + + if _, err := io.Copy(ioutil.Discard, ts); err != nil { + return "", err + } + + d, err := ParseDigest(ts.Sum(nil)) + if err != nil { + return "", err + } + + return d, nil +} + +// FromBytes digests the input and returns a Digest. +func FromBytes(p []byte) (Digest, error) { + return FromReader(bytes.NewReader(p)) +} + +// Validate checks that the contents of d is a valid digest, returning an +// error if not. +func (d Digest) Validate() error { + s := string(d) + // Common case will be tarsum + _, err := ParseTarSum(s) + if err == nil { + return nil + } + + // Continue on for general parser + + if !DigestRegexpAnchored.MatchString(s) { + return ErrDigestInvalidFormat + } + + i := strings.Index(s, ":") + if i < 0 { + return ErrDigestInvalidFormat + } + + // case: "sha256:" with no hex. + if i+1 == len(s) { + return ErrDigestInvalidFormat + } + + switch Algorithm(s[:i]) { + case SHA256, SHA384, SHA512: + break + default: + return ErrDigestUnsupported + } + + return nil +} + +// Algorithm returns the algorithm portion of the digest. This will panic if +// the underlying digest is not in a valid format. +func (d Digest) Algorithm() Algorithm { + return Algorithm(d[:d.sepIndex()]) +} + +// Hex returns the hex digest portion of the digest. This will panic if the +// underlying digest is not in a valid format. +func (d Digest) Hex() string { + return string(d[d.sepIndex()+1:]) +} + +func (d Digest) String() string { + return string(d) +} + +func (d Digest) sepIndex() int { + i := strings.Index(string(d), ":") + + if i < 0 { + panic("could not find ':' in digest: " + d) + } + + return i +} diff --git a/vendor/src/github.com/docker/distribution/digest/digester.go b/vendor/src/github.com/docker/distribution/digest/digester.go new file mode 100644 index 0000000000..556dd93aec --- /dev/null +++ b/vendor/src/github.com/docker/distribution/digest/digester.go @@ -0,0 +1,95 @@ +package digest + +import ( + "crypto" + "hash" +) + +// Algorithm identifies and implementation of a digester by an identifier. +// Note the that this defines both the hash algorithm used and the string +// encoding. +type Algorithm string + +// supported digest types +const ( + SHA256 Algorithm = "sha256" // sha256 with hex encoding + SHA384 Algorithm = "sha384" // sha384 with hex encoding + SHA512 Algorithm = "sha512" // sha512 with hex encoding + TarsumV1SHA256 Algorithm = "tarsum+v1+sha256" // supported tarsum version, verification only + + // Canonical is the primary digest algorithm used with the distribution + // project. Other digests may be used but this one is the primary storage + // digest. + Canonical = SHA256 +) + +var ( + // TODO(stevvooe): Follow the pattern of the standard crypto package for + // registration of digests. Effectively, we are a registerable set and + // common symbol access. + + // algorithms maps values to hash.Hash implementations. Other algorithms + // may be available but they cannot be calculated by the digest package. + algorithms = map[Algorithm]crypto.Hash{ + SHA256: crypto.SHA256, + SHA384: crypto.SHA384, + SHA512: crypto.SHA512, + } +) + +// Available returns true if the digest type is available for use. If this +// returns false, New and Hash will return nil. +func (a Algorithm) Available() bool { + h, ok := algorithms[a] + if !ok { + return false + } + + // check availability of the hash, as well + return h.Available() +} + +// New returns a new digester for the specified algorithm. If the algorithm +// does not have a digester implementation, nil will be returned. This can be +// checked by calling Available before calling New. +func (a Algorithm) New() Digester { + return &digester{ + alg: a, + hash: a.Hash(), + } +} + +// Hash returns a new hash as used by the algorithm. If not available, nil is +// returned. Make sure to check Available before calling. +func (a Algorithm) Hash() hash.Hash { + if !a.Available() { + return nil + } + + return algorithms[a].New() +} + +// TODO(stevvooe): Allow resolution of verifiers using the digest type and +// this registration system. + +// Digester calculates the digest of written data. Writes should go directly +// to the return value of Hash, while calling Digest will return the current +// value of the digest. +type Digester interface { + Hash() hash.Hash // provides direct access to underlying hash instance. + Digest() Digest +} + +// digester provides a simple digester definition that embeds a hasher. +type digester struct { + alg Algorithm + hash hash.Hash +} + +func (d *digester) Hash() hash.Hash { + return d.hash +} + +func (d *digester) Digest() Digest { + return NewDigest(d.alg, d.hash) +} diff --git a/vendor/src/github.com/docker/distribution/digest/doc.go b/vendor/src/github.com/docker/distribution/digest/doc.go new file mode 100644 index 0000000000..278c50e011 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/digest/doc.go @@ -0,0 +1,52 @@ +// Package digest provides a generalized type to opaquely represent message +// digests and their operations within the registry. The Digest type is +// designed to serve as a flexible identifier in a content-addressable system. +// More importantly, it provides tools and wrappers to work with tarsums and +// hash.Hash-based digests with little effort. +// +// Basics +// +// The format of a digest is simply a string with two parts, dubbed the +// "algorithm" and the "digest", separated by a colon: +// +// : +// +// An example of a sha256 digest representation follows: +// +// sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc +// +// In this case, the string "sha256" is the algorithm and the hex bytes are +// the "digest". A tarsum example will be more illustrative of the use case +// involved in the registry: +// +// tarsum+sha256:e58fcf7418d4390dec8e8fb69d88c06ec07039d651fedd3aa72af9972e7d046b +// +// For this, we consider the algorithm to be "tarsum+sha256". Prudent +// applications will favor the ParseDigest function to verify the format over +// using simple type casts. However, a normal string can be cast as a digest +// with a simple type conversion: +// +// Digest("tarsum+sha256:e58fcf7418d4390dec8e8fb69d88c06ec07039d651fedd3aa72af9972e7d046b") +// +// Because the Digest type is simply a string, once a valid Digest is +// obtained, comparisons are cheap, quick and simple to express with the +// standard equality operator. +// +// Verification +// +// The main benefit of using the Digest type is simple verification against a +// given digest. The Verifier interface, modeled after the stdlib hash.Hash +// interface, provides a common write sink for digest verification. After +// writing is complete, calling the Verifier.Verified method will indicate +// whether or not the stream of bytes matches the target digest. +// +// Missing Features +// +// In addition to the above, we intend to add the following features to this +// package: +// +// 1. A Digester type that supports write sink digest calculation. +// +// 2. Suspend and resume of ongoing digest calculations to support efficient digest verification in the registry. +// +package digest diff --git a/vendor/src/github.com/docker/distribution/digest/set.go b/vendor/src/github.com/docker/distribution/digest/set.go new file mode 100644 index 0000000000..271d35dbf6 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/digest/set.go @@ -0,0 +1,195 @@ +package digest + +import ( + "errors" + "sort" + "strings" +) + +var ( + // ErrDigestNotFound is used when a matching digest + // could not be found in a set. + ErrDigestNotFound = errors.New("digest not found") + + // ErrDigestAmbiguous is used when multiple digests + // are found in a set. None of the matching digests + // should be considered valid matches. + ErrDigestAmbiguous = errors.New("ambiguous digest string") +) + +// Set is used to hold a unique set of digests which +// may be easily referenced by easily referenced by a string +// representation of the digest as well as short representation. +// The uniqueness of the short representation is based on other +// digests in the set. If digests are ommited from this set, +// collisions in a larger set may not be detected, therefore it +// is important to always do short representation lookups on +// the complete set of digests. To mitigate collisions, an +// appropriately long short code should be used. +type Set struct { + entries digestEntries +} + +// NewSet creates an empty set of digests +// which may have digests added. +func NewSet() *Set { + return &Set{ + entries: digestEntries{}, + } +} + +// checkShortMatch checks whether two digests match as either whole +// values or short values. This function does not test equality, +// rather whether the second value could match against the first +// value. +func checkShortMatch(alg Algorithm, hex, shortAlg, shortHex string) bool { + if len(hex) == len(shortHex) { + if hex != shortHex { + return false + } + if len(shortAlg) > 0 && string(alg) != shortAlg { + return false + } + } else if !strings.HasPrefix(hex, shortHex) { + return false + } else if len(shortAlg) > 0 && string(alg) != shortAlg { + return false + } + return true +} + +// Lookup looks for a digest matching the given string representation. +// If no digests could be found ErrDigestNotFound will be returned +// with an empty digest value. If multiple matches are found +// ErrDigestAmbiguous will be returned with an empty digest value. +func (dst *Set) Lookup(d string) (Digest, error) { + if len(dst.entries) == 0 { + return "", ErrDigestNotFound + } + var ( + searchFunc func(int) bool + alg Algorithm + hex string + ) + dgst, err := ParseDigest(d) + if err == ErrDigestInvalidFormat { + hex = d + searchFunc = func(i int) bool { + return dst.entries[i].val >= d + } + } else { + hex = dgst.Hex() + alg = dgst.Algorithm() + searchFunc = func(i int) bool { + if dst.entries[i].val == hex { + return dst.entries[i].alg >= alg + } + return dst.entries[i].val >= hex + } + } + idx := sort.Search(len(dst.entries), searchFunc) + if idx == len(dst.entries) || !checkShortMatch(dst.entries[idx].alg, dst.entries[idx].val, string(alg), hex) { + return "", ErrDigestNotFound + } + if dst.entries[idx].alg == alg && dst.entries[idx].val == hex { + return dst.entries[idx].digest, nil + } + if idx+1 < len(dst.entries) && checkShortMatch(dst.entries[idx+1].alg, dst.entries[idx+1].val, string(alg), hex) { + return "", ErrDigestAmbiguous + } + + return dst.entries[idx].digest, nil +} + +// Add adds the given digests to the set. An error will be returned +// if the given digest is invalid. If the digest already exists in the +// table, this operation will be a no-op. +func (dst *Set) Add(d Digest) error { + if err := d.Validate(); err != nil { + return err + } + entry := &digestEntry{alg: d.Algorithm(), val: d.Hex(), digest: d} + searchFunc := func(i int) bool { + if dst.entries[i].val == entry.val { + return dst.entries[i].alg >= entry.alg + } + return dst.entries[i].val >= entry.val + } + idx := sort.Search(len(dst.entries), searchFunc) + if idx == len(dst.entries) { + dst.entries = append(dst.entries, entry) + return nil + } else if dst.entries[idx].digest == d { + return nil + } + + entries := append(dst.entries, nil) + copy(entries[idx+1:], entries[idx:len(entries)-1]) + entries[idx] = entry + dst.entries = entries + return nil +} + +// ShortCodeTable returns a map of Digest to unique short codes. The +// length represents the minimum value, the maximum length may be the +// entire value of digest if uniqueness cannot be achieved without the +// full value. This function will attempt to make short codes as short +// as possible to be unique. +func ShortCodeTable(dst *Set, length int) map[Digest]string { + m := make(map[Digest]string, len(dst.entries)) + l := length + resetIdx := 0 + for i := 0; i < len(dst.entries); i++ { + var short string + extended := true + for extended { + extended = false + if len(dst.entries[i].val) <= l { + short = dst.entries[i].digest.String() + } else { + short = dst.entries[i].val[:l] + for j := i + 1; j < len(dst.entries); j++ { + if checkShortMatch(dst.entries[j].alg, dst.entries[j].val, "", short) { + if j > resetIdx { + resetIdx = j + } + extended = true + } else { + break + } + } + if extended { + l++ + } + } + } + m[dst.entries[i].digest] = short + if i >= resetIdx { + l = length + } + } + return m +} + +type digestEntry struct { + alg Algorithm + val string + digest Digest +} + +type digestEntries []*digestEntry + +func (d digestEntries) Len() int { + return len(d) +} + +func (d digestEntries) Less(i, j int) bool { + if d[i].val != d[j].val { + return d[i].val < d[j].val + } + return d[i].alg < d[j].alg +} + +func (d digestEntries) Swap(i, j int) { + d[i], d[j] = d[j], d[i] +} diff --git a/vendor/src/github.com/docker/distribution/digest/tarsum.go b/vendor/src/github.com/docker/distribution/digest/tarsum.go new file mode 100644 index 0000000000..702d7dc3f9 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/digest/tarsum.go @@ -0,0 +1,70 @@ +package digest + +import ( + "fmt" + + "regexp" +) + +// TarSumRegexp defines a regular expression to match tarsum identifiers. +var TarsumRegexp = regexp.MustCompile("tarsum(?:.[a-z0-9]+)?\\+[a-zA-Z0-9]+:[A-Fa-f0-9]+") + +// TarsumRegexpCapturing defines a regular expression to match tarsum identifiers with +// capture groups corresponding to each component. +var TarsumRegexpCapturing = regexp.MustCompile("(tarsum)(.([a-z0-9]+))?\\+([a-zA-Z0-9]+):([A-Fa-f0-9]+)") + +// TarSumInfo contains information about a parsed tarsum. +type TarSumInfo struct { + // Version contains the version of the tarsum. + Version string + + // Algorithm contains the algorithm for the final digest + Algorithm string + + // Digest contains the hex-encoded digest. + Digest string +} + +// InvalidTarSumError provides informations about a TarSum that cannot be parsed +// by ParseTarSum. +type InvalidTarSumError string + +func (e InvalidTarSumError) Error() string { + return fmt.Sprintf("invalid tarsum: %q", string(e)) +} + +// ParseTarSum parses a tarsum string into its components of interest. For +// example, this method may receive the tarsum in the following format: +// +// tarsum.v1+sha256:220a60ecd4a3c32c282622a625a54db9ba0ff55b5ba9c29c7064a2bc358b6a3e +// +// The function will return the following: +// +// TarSumInfo{ +// Version: "v1", +// Algorithm: "sha256", +// Digest: "220a60ecd4a3c32c282622a625a54db9ba0ff55b5ba9c29c7064a2bc358b6a3e", +// } +// +func ParseTarSum(tarSum string) (tsi TarSumInfo, err error) { + components := TarsumRegexpCapturing.FindStringSubmatch(tarSum) + + if len(components) != 1+TarsumRegexpCapturing.NumSubexp() { + return TarSumInfo{}, InvalidTarSumError(tarSum) + } + + return TarSumInfo{ + Version: components[3], + Algorithm: components[4], + Digest: components[5], + }, nil +} + +// String returns the valid, string representation of the tarsum info. +func (tsi TarSumInfo) String() string { + if tsi.Version == "" { + return fmt.Sprintf("tarsum+%s:%s", tsi.Algorithm, tsi.Digest) + } + + return fmt.Sprintf("tarsum.%s+%s:%s", tsi.Version, tsi.Algorithm, tsi.Digest) +} diff --git a/vendor/src/github.com/docker/distribution/digest/verifiers.go b/vendor/src/github.com/docker/distribution/digest/verifiers.go new file mode 100644 index 0000000000..f8c75b53de --- /dev/null +++ b/vendor/src/github.com/docker/distribution/digest/verifiers.go @@ -0,0 +1,122 @@ +package digest + +import ( + "hash" + "io" + "io/ioutil" + + "github.com/docker/docker/pkg/tarsum" +) + +// Verifier presents a general verification interface to be used with message +// digests and other byte stream verifications. Users instantiate a Verifier +// from one of the various methods, write the data under test to it then check +// the result with the Verified method. +type Verifier interface { + io.Writer + + // Verified will return true if the content written to Verifier matches + // the digest. + Verified() bool +} + +// NewDigestVerifier returns a verifier that compares the written bytes +// against a passed in digest. +func NewDigestVerifier(d Digest) (Verifier, error) { + if err := d.Validate(); err != nil { + return nil, err + } + + alg := d.Algorithm() + switch alg { + case "sha256", "sha384", "sha512": + return hashVerifier{ + hash: alg.Hash(), + digest: d, + }, nil + default: + // Assume we have a tarsum. + version, err := tarsum.GetVersionFromTarsum(string(d)) + if err != nil { + return nil, err + } + + pr, pw := io.Pipe() + + // TODO(stevvooe): We may actually want to ban the earlier versions of + // tarsum. That decision may not be the place of the verifier. + + ts, err := tarsum.NewTarSum(pr, true, version) + if err != nil { + return nil, err + } + + // TODO(sday): Ick! A goroutine per digest verification? We'll have to + // get the tarsum library to export an io.Writer variant. + go func() { + if _, err := io.Copy(ioutil.Discard, ts); err != nil { + pr.CloseWithError(err) + } else { + pr.Close() + } + }() + + return &tarsumVerifier{ + digest: d, + ts: ts, + pr: pr, + pw: pw, + }, nil + } +} + +// NewLengthVerifier returns a verifier that returns true when the number of +// read bytes equals the expected parameter. +func NewLengthVerifier(expected int64) Verifier { + return &lengthVerifier{ + expected: expected, + } +} + +type lengthVerifier struct { + expected int64 // expected bytes read + len int64 // bytes read +} + +func (lv *lengthVerifier) Write(p []byte) (n int, err error) { + n = len(p) + lv.len += int64(n) + return n, err +} + +func (lv *lengthVerifier) Verified() bool { + return lv.expected == lv.len +} + +type hashVerifier struct { + digest Digest + hash hash.Hash +} + +func (hv hashVerifier) Write(p []byte) (n int, err error) { + return hv.hash.Write(p) +} + +func (hv hashVerifier) Verified() bool { + return hv.digest == NewDigest(hv.digest.Algorithm(), hv.hash) +} + +type tarsumVerifier struct { + digest Digest + ts tarsum.TarSum + pr *io.PipeReader + pw *io.PipeWriter +} + +func (tv *tarsumVerifier) Write(p []byte) (n int, err error) { + return tv.pw.Write(p) +} + +func (tv *tarsumVerifier) Verified() bool { + return tv.digest == Digest(tv.ts.Sum(nil)) +} diff --git a/vendor/src/github.com/docker/distribution/doc.go b/vendor/src/github.com/docker/distribution/doc.go new file mode 100644 index 0000000000..bdd8cb708e --- /dev/null +++ b/vendor/src/github.com/docker/distribution/doc.go @@ -0,0 +1,7 @@ +// Package distribution will define the interfaces for the components of +// docker distribution. The goal is to allow users to reliably package, ship +// and store content related to docker images. +// +// This is currently a work in progress. More details are available in the +// README.md. +package distribution diff --git a/vendor/src/github.com/docker/distribution/errors.go b/vendor/src/github.com/docker/distribution/errors.go new file mode 100644 index 0000000000..53def4b8ca --- /dev/null +++ b/vendor/src/github.com/docker/distribution/errors.go @@ -0,0 +1,82 @@ +package distribution + +import ( + "fmt" + "strings" + + "github.com/docker/distribution/digest" +) + +// ErrRepositoryUnknown is returned if the named repository is not known by +// the registry. +type ErrRepositoryUnknown struct { + Name string +} + +func (err ErrRepositoryUnknown) Error() string { + return fmt.Sprintf("unknown repository name=%s", err.Name) +} + +// ErrRepositoryNameInvalid should be used to denote an invalid repository +// name. Reason may set, indicating the cause of invalidity. +type ErrRepositoryNameInvalid struct { + Name string + Reason error +} + +func (err ErrRepositoryNameInvalid) Error() string { + return fmt.Sprintf("repository name %q invalid: %v", err.Name, err.Reason) +} + +// ErrManifestUnknown is returned if the manifest is not known by the +// registry. +type ErrManifestUnknown struct { + Name string + Tag string +} + +func (err ErrManifestUnknown) Error() string { + return fmt.Sprintf("unknown manifest name=%s tag=%s", err.Name, err.Tag) +} + +// ErrManifestUnknownRevision is returned when a manifest cannot be found by +// revision within a repository. +type ErrManifestUnknownRevision struct { + Name string + Revision digest.Digest +} + +func (err ErrManifestUnknownRevision) Error() string { + return fmt.Sprintf("unknown manifest name=%s revision=%s", err.Name, err.Revision) +} + +// ErrManifestUnverified is returned when the registry is unable to verify +// the manifest. +type ErrManifestUnverified struct{} + +func (ErrManifestUnverified) Error() string { + return fmt.Sprintf("unverified manifest") +} + +// ErrManifestVerification provides a type to collect errors encountered +// during manifest verification. Currently, it accepts errors of all types, +// but it may be narrowed to those involving manifest verification. +type ErrManifestVerification []error + +func (errs ErrManifestVerification) Error() string { + var parts []string + for _, err := range errs { + parts = append(parts, err.Error()) + } + + return fmt.Sprintf("errors verifying manifest: %v", strings.Join(parts, ",")) +} + +// ErrManifestBlobUnknown returned when a referenced blob cannot be found. +type ErrManifestBlobUnknown struct { + Digest digest.Digest +} + +func (err ErrManifestBlobUnknown) Error() string { + return fmt.Sprintf("unknown blob %v on manifest", err.Digest) +} diff --git a/vendor/src/github.com/docker/distribution/manifest/manifest.go b/vendor/src/github.com/docker/distribution/manifest/manifest.go new file mode 100644 index 0000000000..48467d48e2 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/manifest/manifest.go @@ -0,0 +1,124 @@ +package manifest + +import ( + "encoding/json" + + "github.com/docker/distribution/digest" + "github.com/docker/libtrust" +) + +// TODO(stevvooe): When we rev the manifest format, the contents of this +// package should be moved to manifest/v1. + +const ( + // ManifestMediaType specifies the mediaType for the current version. Note + // that for schema version 1, the the media is optionally + // "application/json". + ManifestMediaType = "application/vnd.docker.distribution.manifest.v1+json" +) + +// Versioned provides a struct with just the manifest schemaVersion. Incoming +// content with unknown schema version can be decoded against this struct to +// check the version. +type Versioned struct { + // SchemaVersion is the image manifest schema that this image follows + SchemaVersion int `json:"schemaVersion"` +} + +// Manifest provides the base accessible fields for working with V2 image +// format in the registry. +type Manifest struct { + Versioned + + // Name is the name of the image's repository + Name string `json:"name"` + + // Tag is the tag of the image specified by this manifest + Tag string `json:"tag"` + + // Architecture is the host architecture on which this image is intended to + // run + Architecture string `json:"architecture"` + + // FSLayers is a list of filesystem layer blobSums contained in this image + FSLayers []FSLayer `json:"fsLayers"` + + // History is a list of unstructured historical data for v1 compatibility + History []History `json:"history"` +} + +// SignedManifest provides an envelope for a signed image manifest, including +// the format sensitive raw bytes. It contains fields to +type SignedManifest struct { + Manifest + + // Raw is the byte representation of the ImageManifest, used for signature + // verification. The value of Raw must be used directly during + // serialization, or the signature check will fail. The manifest byte + // representation cannot change or it will have to be re-signed. + Raw []byte `json:"-"` +} + +// UnmarshalJSON populates a new ImageManifest struct from JSON data. +func (sm *SignedManifest) UnmarshalJSON(b []byte) error { + var manifest Manifest + if err := json.Unmarshal(b, &manifest); err != nil { + return err + } + + sm.Manifest = manifest + sm.Raw = make([]byte, len(b), len(b)) + copy(sm.Raw, b) + + return nil +} + +// Payload returns the raw, signed content of the signed manifest. The +// contents can be used to calculate the content identifier. +func (sm *SignedManifest) Payload() ([]byte, error) { + jsig, err := libtrust.ParsePrettySignature(sm.Raw, "signatures") + if err != nil { + return nil, err + } + + // Resolve the payload in the manifest. + return jsig.Payload() +} + +// Signatures returns the signatures as provided by +// (*libtrust.JSONSignature).Signatures. The byte slices are opaque jws +// signatures. +func (sm *SignedManifest) Signatures() ([][]byte, error) { + jsig, err := libtrust.ParsePrettySignature(sm.Raw, "signatures") + if err != nil { + return nil, err + } + + // Resolve the payload in the manifest. + return jsig.Signatures() +} + +// MarshalJSON returns the contents of raw. If Raw is nil, marshals the inner +// contents. Applications requiring a marshaled signed manifest should simply +// use Raw directly, since the the content produced by json.Marshal will be +// compacted and will fail signature checks. +func (sm *SignedManifest) MarshalJSON() ([]byte, error) { + if len(sm.Raw) > 0 { + return sm.Raw, nil + } + + // If the raw data is not available, just dump the inner content. + return json.Marshal(&sm.Manifest) +} + +// FSLayer is a container struct for BlobSums defined in an image manifest +type FSLayer struct { + // BlobSum is the tarsum of the referenced filesystem image layer + BlobSum digest.Digest `json:"blobSum"` +} + +// History stores unstructured v1 compatibility information +type History struct { + // V1Compatibility is the raw v1 compatibility information + V1Compatibility string `json:"v1Compatibility"` +} diff --git a/vendor/src/github.com/docker/distribution/manifest/sign.go b/vendor/src/github.com/docker/distribution/manifest/sign.go new file mode 100644 index 0000000000..a4c37652ee --- /dev/null +++ b/vendor/src/github.com/docker/distribution/manifest/sign.go @@ -0,0 +1,66 @@ +package manifest + +import ( + "crypto/x509" + "encoding/json" + + "github.com/docker/libtrust" +) + +// Sign signs the manifest with the provided private key, returning a +// SignedManifest. This typically won't be used within the registry, except +// for testing. +func Sign(m *Manifest, pk libtrust.PrivateKey) (*SignedManifest, error) { + p, err := json.MarshalIndent(m, "", " ") + if err != nil { + return nil, err + } + + js, err := libtrust.NewJSONSignature(p) + if err != nil { + return nil, err + } + + if err := js.Sign(pk); err != nil { + return nil, err + } + + pretty, err := js.PrettySignature("signatures") + if err != nil { + return nil, err + } + + return &SignedManifest{ + Manifest: *m, + Raw: pretty, + }, nil +} + +// SignWithChain signs the manifest with the given private key and x509 chain. +// The public key of the first element in the chain must be the public key +// corresponding with the sign key. +func SignWithChain(m *Manifest, key libtrust.PrivateKey, chain []*x509.Certificate) (*SignedManifest, error) { + p, err := json.MarshalIndent(m, "", " ") + if err != nil { + return nil, err + } + + js, err := libtrust.NewJSONSignature(p) + if err != nil { + return nil, err + } + + if err := js.SignWithChain(key, chain); err != nil { + return nil, err + } + + pretty, err := js.PrettySignature("signatures") + if err != nil { + return nil, err + } + + return &SignedManifest{ + Manifest: *m, + Raw: pretty, + }, nil +} diff --git a/vendor/src/github.com/docker/distribution/manifest/verify.go b/vendor/src/github.com/docker/distribution/manifest/verify.go new file mode 100644 index 0000000000..3e051b2667 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/manifest/verify.go @@ -0,0 +1,32 @@ +package manifest + +import ( + "crypto/x509" + + "github.com/Sirupsen/logrus" + "github.com/docker/libtrust" +) + +// Verify verifies the signature of the signed manifest returning the public +// keys used during signing. +func Verify(sm *SignedManifest) ([]libtrust.PublicKey, error) { + js, err := libtrust.ParsePrettySignature(sm.Raw, "signatures") + if err != nil { + logrus.WithField("err", err).Debugf("(*SignedManifest).Verify") + return nil, err + } + + return js.Verify() +} + +// VerifyChains verifies the signature of the signed manifest against the +// certificate pool returning the list of verified chains. Signatures without +// an x509 chain are not checked. +func VerifyChains(sm *SignedManifest, ca *x509.CertPool) ([][]*x509.Certificate, error) { + js, err := libtrust.ParsePrettySignature(sm.Raw, "signatures") + if err != nil { + return nil, err + } + + return js.VerifyChains(ca) +} diff --git a/vendor/src/github.com/docker/distribution/registry.go b/vendor/src/github.com/docker/distribution/registry.go new file mode 100644 index 0000000000..1a3de01d0d --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry.go @@ -0,0 +1,120 @@ +package distribution + +import ( + "github.com/docker/distribution/context" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" +) + +// Scope defines the set of items that match a namespace. +type Scope interface { + // Contains returns true if the name belongs to the namespace. + Contains(name string) bool +} + +type fullScope struct{} + +func (f fullScope) Contains(string) bool { + return true +} + +// GlobalScope represents the full namespace scope which contains +// all other scopes. +var GlobalScope = Scope(fullScope{}) + +// Namespace represents a collection of repositories, addressable by name. +// Generally, a namespace is backed by a set of one or more services, +// providing facilities such as registry access, trust, and indexing. +type Namespace interface { + // Scope describes the names that can be used with this Namespace. The + // global namespace will have a scope that matches all names. The scope + // effectively provides an identity for the namespace. + Scope() Scope + + // Repository should return a reference to the named repository. The + // registry may or may not have the repository but should always return a + // reference. + Repository(ctx context.Context, name string) (Repository, error) + + // Repositories fills 'repos' with a lexigraphically sorted catalog of repositories + // up to the size of 'repos' and returns the value 'n' for the number of entries + // which were filled. 'last' contains an offset in the catalog, and 'err' will be + // set to io.EOF if there are no more entries to obtain. + Repositories(ctx context.Context, repos []string, last string) (n int, err error) +} + +// ManifestServiceOption is a function argument for Manifest Service methods +type ManifestServiceOption func(ManifestService) error + +// Repository is a named collection of manifests and layers. +type Repository interface { + // Name returns the name of the repository. + Name() string + + // Manifests returns a reference to this repository's manifest service. + // with the supplied options applied. + Manifests(ctx context.Context, options ...ManifestServiceOption) (ManifestService, error) + + // Blobs returns a reference to this repository's blob service. + Blobs(ctx context.Context) BlobStore + + // TODO(stevvooe): The above BlobStore return can probably be relaxed to + // be a BlobService for use with clients. This will allow such + // implementations to avoid implementing ServeBlob. + + // Signatures returns a reference to this repository's signatures service. + Signatures() SignatureService +} + +// TODO(stevvooe): Must add close methods to all these. May want to change the +// way instances are created to better reflect internal dependency +// relationships. + +// ManifestService provides operations on image manifests. +type ManifestService interface { + // Exists returns true if the manifest exists. + Exists(dgst digest.Digest) (bool, error) + + // Get retrieves the identified by the digest, if it exists. + Get(dgst digest.Digest) (*manifest.SignedManifest, error) + + // Delete removes the manifest, if it exists. + Delete(dgst digest.Digest) error + + // Put creates or updates the manifest. + Put(manifest *manifest.SignedManifest) error + + // TODO(stevvooe): The methods after this message should be moved to a + // discrete TagService, per active proposals. + + // Tags lists the tags under the named repository. + Tags() ([]string, error) + + // ExistsByTag returns true if the manifest exists. + ExistsByTag(tag string) (bool, error) + + // GetByTag retrieves the named manifest, if it exists. + GetByTag(tag string, options ...ManifestServiceOption) (*manifest.SignedManifest, error) + + // TODO(stevvooe): There are several changes that need to be done to this + // interface: + // + // 1. Allow explicit tagging with Tag(digest digest.Digest, tag string) + // 2. Support reading tags with a re-entrant reader to avoid large + // allocations in the registry. + // 3. Long-term: Provide All() method that lets one scroll through all of + // the manifest entries. + // 4. Long-term: break out concept of signing from manifests. This is + // really a part of the distribution sprint. + // 5. Long-term: Manifest should be an interface. This code shouldn't + // really be concerned with the storage format. +} + +// SignatureService provides operations on signatures. +type SignatureService interface { + // Get retrieves all of the signature blobs for the specified digest. + Get(dgst digest.Digest) ([][]byte, error) + + // Put stores the signature for the provided digest. + Put(dgst digest.Digest, signatures ...[]byte) error +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/errcode/errors.go b/vendor/src/github.com/docker/distribution/registry/api/errcode/errors.go new file mode 100644 index 0000000000..fdaddbcf8e --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/errcode/errors.go @@ -0,0 +1,259 @@ +package errcode + +import ( + "encoding/json" + "fmt" + "strings" +) + +// ErrorCoder is the base interface for ErrorCode and Error allowing +// users of each to just call ErrorCode to get the real ID of each +type ErrorCoder interface { + ErrorCode() ErrorCode +} + +// ErrorCode represents the error type. The errors are serialized via strings +// and the integer format may change and should *never* be exported. +type ErrorCode int + +var _ error = ErrorCode(0) + +// ErrorCode just returns itself +func (ec ErrorCode) ErrorCode() ErrorCode { + return ec +} + +// Error returns the ID/Value +func (ec ErrorCode) Error() string { + return ec.Descriptor().Value +} + +// Descriptor returns the descriptor for the error code. +func (ec ErrorCode) Descriptor() ErrorDescriptor { + d, ok := errorCodeToDescriptors[ec] + + if !ok { + return ErrorCodeUnknown.Descriptor() + } + + return d +} + +// String returns the canonical identifier for this error code. +func (ec ErrorCode) String() string { + return ec.Descriptor().Value +} + +// Message returned the human-readable error message for this error code. +func (ec ErrorCode) Message() string { + return ec.Descriptor().Message +} + +// MarshalText encodes the receiver into UTF-8-encoded text and returns the +// result. +func (ec ErrorCode) MarshalText() (text []byte, err error) { + return []byte(ec.String()), nil +} + +// UnmarshalText decodes the form generated by MarshalText. +func (ec *ErrorCode) UnmarshalText(text []byte) error { + desc, ok := idToDescriptors[string(text)] + + if !ok { + desc = ErrorCodeUnknown.Descriptor() + } + + *ec = desc.Code + + return nil +} + +// WithDetail creates a new Error struct based on the passed-in info and +// set the Detail property appropriately +func (ec ErrorCode) WithDetail(detail interface{}) Error { + return Error{ + Code: ec, + Message: ec.Message(), + }.WithDetail(detail) +} + +// WithArgs creates a new Error struct and sets the Args slice +func (ec ErrorCode) WithArgs(args ...interface{}) Error { + return Error{ + Code: ec, + Message: ec.Message(), + }.WithArgs(args...) +} + +// Error provides a wrapper around ErrorCode with extra Details provided. +type Error struct { + Code ErrorCode `json:"code"` + Message string `json:"message"` + Detail interface{} `json:"detail,omitempty"` + + // TODO(duglin): See if we need an "args" property so we can do the + // variable substitution right before showing the message to the user +} + +var _ error = Error{} + +// ErrorCode returns the ID/Value of this Error +func (e Error) ErrorCode() ErrorCode { + return e.Code +} + +// Error returns a human readable representation of the error. +func (e Error) Error() string { + return fmt.Sprintf("%s: %s", + strings.ToLower(strings.Replace(e.Code.String(), "_", " ", -1)), + e.Message) +} + +// WithDetail will return a new Error, based on the current one, but with +// some Detail info added +func (e Error) WithDetail(detail interface{}) Error { + return Error{ + Code: e.Code, + Message: e.Message, + Detail: detail, + } +} + +// WithArgs uses the passed-in list of interface{} as the substitution +// variables in the Error's Message string, but returns a new Error +func (e Error) WithArgs(args ...interface{}) Error { + return Error{ + Code: e.Code, + Message: fmt.Sprintf(e.Code.Message(), args...), + Detail: e.Detail, + } +} + +// ErrorDescriptor provides relevant information about a given error code. +type ErrorDescriptor struct { + // Code is the error code that this descriptor describes. + Code ErrorCode + + // Value provides a unique, string key, often captilized with + // underscores, to identify the error code. This value is used as the + // keyed value when serializing api errors. + Value string + + // Message is a short, human readable decription of the error condition + // included in API responses. + Message string + + // Description provides a complete account of the errors purpose, suitable + // for use in documentation. + Description string + + // HTTPStatusCode provides the http status code that is associated with + // this error condition. + HTTPStatusCode int +} + +// ParseErrorCode returns the value by the string error code. +// `ErrorCodeUnknown` will be returned if the error is not known. +func ParseErrorCode(value string) ErrorCode { + ed, ok := idToDescriptors[value] + if ok { + return ed.Code + } + + return ErrorCodeUnknown +} + +// Errors provides the envelope for multiple errors and a few sugar methods +// for use within the application. +type Errors []error + +var _ error = Errors{} + +func (errs Errors) Error() string { + switch len(errs) { + case 0: + return "" + case 1: + return errs[0].Error() + default: + msg := "errors:\n" + for _, err := range errs { + msg += err.Error() + "\n" + } + return msg + } +} + +// Len returns the current number of errors. +func (errs Errors) Len() int { + return len(errs) +} + +// MarshalJSON converts slice of error, ErrorCode or Error into a +// slice of Error - then serializes +func (errs Errors) MarshalJSON() ([]byte, error) { + var tmpErrs struct { + Errors []Error `json:"errors,omitempty"` + } + + for _, daErr := range errs { + var err Error + + switch daErr.(type) { + case ErrorCode: + err = daErr.(ErrorCode).WithDetail(nil) + case Error: + err = daErr.(Error) + default: + err = ErrorCodeUnknown.WithDetail(daErr) + + } + + // If the Error struct was setup and they forgot to set the + // Message field (meaning its "") then grab it from the ErrCode + msg := err.Message + if msg == "" { + msg = err.Code.Message() + } + + tmpErrs.Errors = append(tmpErrs.Errors, Error{ + Code: err.Code, + Message: msg, + Detail: err.Detail, + }) + } + + return json.Marshal(tmpErrs) +} + +// UnmarshalJSON deserializes []Error and then converts it into slice of +// Error or ErrorCode +func (errs *Errors) UnmarshalJSON(data []byte) error { + var tmpErrs struct { + Errors []Error + } + + if err := json.Unmarshal(data, &tmpErrs); err != nil { + return err + } + + var newErrs Errors + for _, daErr := range tmpErrs.Errors { + // If Message is empty or exactly matches the Code's message string + // then just use the Code, no need for a full Error struct + if daErr.Detail == nil && (daErr.Message == "" || daErr.Message == daErr.Code.Message()) { + // Error's w/o details get converted to ErrorCode + newErrs = append(newErrs, daErr.Code) + } else { + // Error's w/ details are untouched + newErrs = append(newErrs, Error{ + Code: daErr.Code, + Message: daErr.Message, + Detail: daErr.Detail, + }) + } + } + + *errs = newErrs + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/errcode/handler.go b/vendor/src/github.com/docker/distribution/registry/api/errcode/handler.go new file mode 100644 index 0000000000..49a64a86eb --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/errcode/handler.go @@ -0,0 +1,44 @@ +package errcode + +import ( + "encoding/json" + "net/http" +) + +// ServeJSON attempts to serve the errcode in a JSON envelope. It marshals err +// and sets the content-type header to 'application/json'. It will handle +// ErrorCoder and Errors, and if necessary will create an envelope. +func ServeJSON(w http.ResponseWriter, err error) error { + w.Header().Set("Content-Type", "application/json; charset=utf-8") + var sc int + + switch errs := err.(type) { + case Errors: + if len(errs) < 1 { + break + } + + if err, ok := errs[0].(ErrorCoder); ok { + sc = err.ErrorCode().Descriptor().HTTPStatusCode + } + case ErrorCoder: + sc = errs.ErrorCode().Descriptor().HTTPStatusCode + err = Errors{err} // create an envelope. + default: + // We just have an unhandled error type, so just place in an envelope + // and move along. + err = Errors{err} + } + + if sc == 0 { + sc = http.StatusInternalServerError + } + + w.WriteHeader(sc) + + if err := json.NewEncoder(w).Encode(err); err != nil { + return err + } + + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/errcode/register.go b/vendor/src/github.com/docker/distribution/registry/api/errcode/register.go new file mode 100644 index 0000000000..42f911b31f --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/errcode/register.go @@ -0,0 +1,86 @@ +package errcode + +import ( + "fmt" + "net/http" + "sort" + "sync" +) + +var ( + errorCodeToDescriptors = map[ErrorCode]ErrorDescriptor{} + idToDescriptors = map[string]ErrorDescriptor{} + groupToDescriptors = map[string][]ErrorDescriptor{} +) + +// ErrorCodeUnknown is a generic error that can be used as a last +// resort if there is no situation-specific error message that can be used +var ErrorCodeUnknown = Register("errcode", ErrorDescriptor{ + Value: "UNKNOWN", + Message: "unknown error", + Description: `Generic error returned when the error does not have an + API classification.`, + HTTPStatusCode: http.StatusInternalServerError, +}) + +var nextCode = 1000 +var registerLock sync.Mutex + +// Register will make the passed-in error known to the environment and +// return a new ErrorCode +func Register(group string, descriptor ErrorDescriptor) ErrorCode { + registerLock.Lock() + defer registerLock.Unlock() + + descriptor.Code = ErrorCode(nextCode) + + if _, ok := idToDescriptors[descriptor.Value]; ok { + panic(fmt.Sprintf("ErrorValue %q is already registered", descriptor.Value)) + } + if _, ok := errorCodeToDescriptors[descriptor.Code]; ok { + panic(fmt.Sprintf("ErrorCode %v is already registered", descriptor.Code)) + } + + groupToDescriptors[group] = append(groupToDescriptors[group], descriptor) + errorCodeToDescriptors[descriptor.Code] = descriptor + idToDescriptors[descriptor.Value] = descriptor + + nextCode++ + return descriptor.Code +} + +type byValue []ErrorDescriptor + +func (a byValue) Len() int { return len(a) } +func (a byValue) Swap(i, j int) { a[i], a[j] = a[j], a[i] } +func (a byValue) Less(i, j int) bool { return a[i].Value < a[j].Value } + +// GetGroupNames returns the list of Error group names that are registered +func GetGroupNames() []string { + keys := []string{} + + for k := range groupToDescriptors { + keys = append(keys, k) + } + sort.Strings(keys) + return keys +} + +// GetErrorCodeGroup returns the named group of error descriptors +func GetErrorCodeGroup(name string) []ErrorDescriptor { + desc := groupToDescriptors[name] + sort.Sort(byValue(desc)) + return desc +} + +// GetErrorAllDescriptors returns a slice of all ErrorDescriptors that are +// registered, irrespective of what group they're in +func GetErrorAllDescriptors() []ErrorDescriptor { + result := []ErrorDescriptor{} + + for _, group := range GetGroupNames() { + result = append(result, GetErrorCodeGroup(group)...) + } + sort.Sort(byValue(result)) + return result +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/v2/descriptors.go b/vendor/src/github.com/docker/distribution/registry/api/v2/descriptors.go new file mode 100644 index 0000000000..74bdb9f2e2 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/v2/descriptors.go @@ -0,0 +1,1487 @@ +package v2 + +import ( + "net/http" + "regexp" + + "github.com/docker/distribution/digest" + "github.com/docker/distribution/registry/api/errcode" +) + +var ( + nameParameterDescriptor = ParameterDescriptor{ + Name: "name", + Type: "string", + Format: RepositoryNameRegexp.String(), + Required: true, + Description: `Name of the target repository.`, + } + + referenceParameterDescriptor = ParameterDescriptor{ + Name: "reference", + Type: "string", + Format: TagNameRegexp.String(), + Required: true, + Description: `Tag or digest of the target manifest.`, + } + + uuidParameterDescriptor = ParameterDescriptor{ + Name: "uuid", + Type: "opaque", + Required: true, + Description: "A uuid identifying the upload. This field can accept characters that match `[a-zA-Z0-9-_.=]+`.", + } + + digestPathParameter = ParameterDescriptor{ + Name: "digest", + Type: "path", + Required: true, + Format: digest.DigestRegexp.String(), + Description: `Digest of desired blob.`, + } + + hostHeader = ParameterDescriptor{ + Name: "Host", + Type: "string", + Description: "Standard HTTP Host Header. Should be set to the registry host.", + Format: "", + Examples: []string{"registry-1.docker.io"}, + } + + authHeader = ParameterDescriptor{ + Name: "Authorization", + Type: "string", + Description: "An RFC7235 compliant authorization header.", + Format: " ", + Examples: []string{"Bearer dGhpcyBpcyBhIGZha2UgYmVhcmVyIHRva2VuIQ=="}, + } + + authChallengeHeader = ParameterDescriptor{ + Name: "WWW-Authenticate", + Type: "string", + Description: "An RFC7235 compliant authentication challenge header.", + Format: ` realm="", ..."`, + Examples: []string{ + `Bearer realm="https://auth.docker.com/", service="registry.docker.com", scopes="repository:library/ubuntu:pull"`, + }, + } + + contentLengthZeroHeader = ParameterDescriptor{ + Name: "Content-Length", + Description: "The `Content-Length` header must be zero and the body must be empty.", + Type: "integer", + Format: "0", + } + + dockerUploadUUIDHeader = ParameterDescriptor{ + Name: "Docker-Upload-UUID", + Description: "Identifies the docker upload uuid for the current request.", + Type: "uuid", + Format: "", + } + + digestHeader = ParameterDescriptor{ + Name: "Docker-Content-Digest", + Description: "Digest of the targeted content for the request.", + Type: "digest", + Format: "", + } + + linkHeader = ParameterDescriptor{ + Name: "Link", + Type: "link", + Description: "RFC5988 compliant rel='next' with URL to next result set, if available", + Format: `<?n=&last=>; rel="next"`, + } + + paginationParameters = []ParameterDescriptor{ + { + Name: "n", + Type: "integer", + Description: "Limit the number of entries in each response. It not present, all entries will be returned.", + Format: "", + Required: false, + }, + { + Name: "last", + Type: "string", + Description: "Result set will include values lexically after last.", + Format: "", + Required: false, + }, + } + + unauthorizedResponse = ResponseDescriptor{ + Description: "The client does not have access to the repository.", + StatusCode: http.StatusUnauthorized, + Headers: []ParameterDescriptor{ + authChallengeHeader, + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON error response body.", + Format: "", + }, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: unauthorizedErrorsBody, + }, + } + + unauthorizedResponsePush = ResponseDescriptor{ + Description: "The client does not have access to push to the repository.", + StatusCode: http.StatusUnauthorized, + Headers: []ParameterDescriptor{ + authChallengeHeader, + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON error response body.", + Format: "", + }, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: unauthorizedErrorsBody, + }, + } +) + +const ( + manifestBody = `{ + "name": , + "tag": , + "fsLayers": [ + { + "blobSum": "" + }, + ... + ] + ], + "history": , + "signature": +}` + + errorsBody = `{ + "errors:" [ + { + "code": , + "message": "", + "detail": ... + }, + ... + ] +}` + + unauthorizedErrorsBody = `{ + "errors:" [ + { + "code": "UNAUTHORIZED", + "message": "access to the requested resource is not authorized", + "detail": ... + }, + ... + ] +}` +) + +// APIDescriptor exports descriptions of the layout of the v2 registry API. +var APIDescriptor = struct { + // RouteDescriptors provides a list of the routes available in the API. + RouteDescriptors []RouteDescriptor +}{ + RouteDescriptors: routeDescriptors, +} + +// RouteDescriptor describes a route specified by name. +type RouteDescriptor struct { + // Name is the name of the route, as specified in RouteNameXXX exports. + // These names a should be considered a unique reference for a route. If + // the route is registered with gorilla, this is the name that will be + // used. + Name string + + // Path is a gorilla/mux-compatible regexp that can be used to match the + // route. For any incoming method and path, only one route descriptor + // should match. + Path string + + // Entity should be a short, human-readalbe description of the object + // targeted by the endpoint. + Entity string + + // Description should provide an accurate overview of the functionality + // provided by the route. + Description string + + // Methods should describe the various HTTP methods that may be used on + // this route, including request and response formats. + Methods []MethodDescriptor +} + +// MethodDescriptor provides a description of the requests that may be +// conducted with the target method. +type MethodDescriptor struct { + + // Method is an HTTP method, such as GET, PUT or POST. + Method string + + // Description should provide an overview of the functionality provided by + // the covered method, suitable for use in documentation. Use of markdown + // here is encouraged. + Description string + + // Requests is a slice of request descriptors enumerating how this + // endpoint may be used. + Requests []RequestDescriptor +} + +// RequestDescriptor covers a particular set of headers and parameters that +// can be carried out with the parent method. Its most helpful to have one +// RequestDescriptor per API use case. +type RequestDescriptor struct { + // Name provides a short identifier for the request, usable as a title or + // to provide quick context for the particalar request. + Name string + + // Description should cover the requests purpose, covering any details for + // this particular use case. + Description string + + // Headers describes headers that must be used with the HTTP request. + Headers []ParameterDescriptor + + // PathParameters enumerate the parameterized path components for the + // given request, as defined in the route's regular expression. + PathParameters []ParameterDescriptor + + // QueryParameters provides a list of query parameters for the given + // request. + QueryParameters []ParameterDescriptor + + // Body describes the format of the request body. + Body BodyDescriptor + + // Successes enumerates the possible responses that are considered to be + // the result of a successful request. + Successes []ResponseDescriptor + + // Failures covers the possible failures from this particular request. + Failures []ResponseDescriptor +} + +// ResponseDescriptor describes the components of an API response. +type ResponseDescriptor struct { + // Name provides a short identifier for the response, usable as a title or + // to provide quick context for the particalar response. + Name string + + // Description should provide a brief overview of the role of the + // response. + Description string + + // StatusCode specifies the status recieved by this particular response. + StatusCode int + + // Headers covers any headers that may be returned from the response. + Headers []ParameterDescriptor + + // Fields describes any fields that may be present in the response. + Fields []ParameterDescriptor + + // ErrorCodes enumerates the error codes that may be returned along with + // the response. + ErrorCodes []errcode.ErrorCode + + // Body describes the body of the response, if any. + Body BodyDescriptor +} + +// BodyDescriptor describes a request body and its expected content type. For +// the most part, it should be example json or some placeholder for body +// data in documentation. +type BodyDescriptor struct { + ContentType string + Format string +} + +// ParameterDescriptor describes the format of a request parameter, which may +// be a header, path parameter or query parameter. +type ParameterDescriptor struct { + // Name is the name of the parameter, either of the path component or + // query parameter. + Name string + + // Type specifies the type of the parameter, such as string, integer, etc. + Type string + + // Description provides a human-readable description of the parameter. + Description string + + // Required means the field is required when set. + Required bool + + // Format is a specifying the string format accepted by this parameter. + Format string + + // Regexp is a compiled regular expression that can be used to validate + // the contents of the parameter. + Regexp *regexp.Regexp + + // Examples provides multiple examples for the values that might be valid + // for this parameter. + Examples []string +} + +var routeDescriptors = []RouteDescriptor{ + { + Name: RouteNameBase, + Path: "/v2/", + Entity: "Base", + Description: `Base V2 API route. Typically, this can be used for lightweight version checks and to validate registry authorization.`, + Methods: []MethodDescriptor{ + { + Method: "GET", + Description: "Check that the endpoint implements Docker Registry API V2.", + Requests: []RequestDescriptor{ + { + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + Successes: []ResponseDescriptor{ + { + Description: "The API implements V2 protocol and is accessible.", + StatusCode: http.StatusOK, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "The client is not authorized to access the registry.", + StatusCode: http.StatusUnauthorized, + Headers: []ParameterDescriptor{ + authChallengeHeader, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + }, + { + Description: "The registry does not implement the V2 API.", + StatusCode: http.StatusNotFound, + }, + }, + }, + }, + }, + }, + }, + { + Name: RouteNameTags, + Path: "/v2/{name:" + RepositoryNameRegexp.String() + "}/tags/list", + Entity: "Tags", + Description: "Retrieve information about tags.", + Methods: []MethodDescriptor{ + { + Method: "GET", + Description: "Fetch the tags under the repository identified by `name`.", + Requests: []RequestDescriptor{ + { + Name: "Tags", + Description: "Return all tags for the repository", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + }, + Successes: []ResponseDescriptor{ + { + StatusCode: http.StatusOK, + Description: "A list of tags for the named repository.", + Headers: []ParameterDescriptor{ + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON response body.", + Format: "", + }, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: `{ + "name": , + "tags": [ + , + ... + ] +}`, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + StatusCode: http.StatusNotFound, + Description: "The repository is not known to the registry.", + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameUnknown, + }, + }, + { + StatusCode: http.StatusUnauthorized, + Description: "The client does not have access to the repository.", + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + }, + }, + }, + { + Name: "Tags Paginated", + Description: "Return a portion of the tags for the specified repository.", + PathParameters: []ParameterDescriptor{nameParameterDescriptor}, + QueryParameters: paginationParameters, + Successes: []ResponseDescriptor{ + { + StatusCode: http.StatusOK, + Description: "A list of tags for the named repository.", + Headers: []ParameterDescriptor{ + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON response body.", + Format: "", + }, + linkHeader, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: `{ + "name": , + "tags": [ + , + ... + ], +}`, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + StatusCode: http.StatusNotFound, + Description: "The repository is not known to the registry.", + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameUnknown, + }, + }, + { + StatusCode: http.StatusUnauthorized, + Description: "The client does not have access to the repository.", + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + }, + }, + }, + }, + }, + }, + }, + { + Name: RouteNameManifest, + Path: "/v2/{name:" + RepositoryNameRegexp.String() + "}/manifests/{reference:" + TagNameRegexp.String() + "|" + digest.DigestRegexp.String() + "}", + Entity: "Manifest", + Description: "Create, update and retrieve manifests.", + Methods: []MethodDescriptor{ + { + Method: "GET", + Description: "Fetch the manifest identified by `name` and `reference` where `reference` can be a tag or digest.", + Requests: []RequestDescriptor{ + { + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + referenceParameterDescriptor, + }, + Successes: []ResponseDescriptor{ + { + Description: "The manifest idenfied by `name` and `reference`. The contents can be used to identify and resolve resources required to run the specified image.", + StatusCode: http.StatusOK, + Headers: []ParameterDescriptor{ + digestHeader, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: manifestBody, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "The name or reference was invalid.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameInvalid, + ErrorCodeTagInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + { + StatusCode: http.StatusUnauthorized, + Description: "The client does not have access to the repository.", + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + }, + { + Description: "The named manifest is not known to the registry.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameUnknown, + ErrorCodeManifestUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + }, + }, + { + Method: "PUT", + Description: "Put the manifest identified by `name` and `reference` where `reference` can be a tag or digest.", + Requests: []RequestDescriptor{ + { + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + referenceParameterDescriptor, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: manifestBody, + }, + Successes: []ResponseDescriptor{ + { + Description: "The manifest has been accepted by the registry and is stored under the specified `name` and `tag`.", + StatusCode: http.StatusCreated, + Headers: []ParameterDescriptor{ + { + Name: "Location", + Type: "url", + Description: "The canonical location url of the uploaded manifest.", + Format: "", + }, + contentLengthZeroHeader, + digestHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Name: "Invalid Manifest", + Description: "The received manifest was invalid in some way, as described by the error codes. The client should resolve the issue and retry the request.", + StatusCode: http.StatusBadRequest, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameInvalid, + ErrorCodeTagInvalid, + ErrorCodeManifestInvalid, + ErrorCodeManifestUnverified, + ErrorCodeBlobUnknown, + }, + }, + { + StatusCode: http.StatusUnauthorized, + Description: "The client does not have permission to push to the repository.", + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + }, + { + Name: "Missing Layer(s)", + Description: "One or more layers may be missing during a manifest upload. If so, the missing layers will be enumerated in the error response.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeBlobUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: `{ + "errors:" [{ + "code": "BLOB_UNKNOWN", + "message": "blob unknown to registry", + "detail": { + "digest": "" + } + }, + ... + ] +}`, + }, + }, + { + StatusCode: http.StatusUnauthorized, + Headers: []ParameterDescriptor{ + authChallengeHeader, + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON error response body.", + Format: "", + }, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + }, + }, + { + Method: "DELETE", + Description: "Delete the manifest identified by `name` and `reference`. Note that a manifest can _only_ be deleted by `digest`.", + Requests: []RequestDescriptor{ + { + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + referenceParameterDescriptor, + }, + Successes: []ResponseDescriptor{ + { + StatusCode: http.StatusAccepted, + }, + }, + Failures: []ResponseDescriptor{ + { + Name: "Invalid Name or Reference", + Description: "The specified `name` or `reference` were invalid and the delete was unable to proceed.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameInvalid, + ErrorCodeTagInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + { + StatusCode: http.StatusUnauthorized, + Headers: []ParameterDescriptor{ + authChallengeHeader, + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON error response body.", + Format: "", + }, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeUnauthorized, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + { + Name: "Unknown Manifest", + Description: "The specified `name` or `reference` are unknown to the registry and the delete was unable to proceed. Clients can assume the manifest was already deleted if this response is returned.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameUnknown, + ErrorCodeManifestUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + }, + }, + }, + }, + + { + Name: RouteNameBlob, + Path: "/v2/{name:" + RepositoryNameRegexp.String() + "}/blobs/{digest:" + digest.DigestRegexp.String() + "}", + Entity: "Blob", + Description: "Fetch the blob identified by `name` and `digest`. Used to fetch layers by digest.", + Methods: []MethodDescriptor{ + + { + Method: "GET", + Description: "Retrieve the blob from the registry identified by `digest`. A `HEAD` request can also be issued to this endpoint to obtain resource information without receiving all data.", + Requests: []RequestDescriptor{ + { + Name: "Fetch Blob", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + digestPathParameter, + }, + Successes: []ResponseDescriptor{ + { + Description: "The blob identified by `digest` is available. The blob content will be present in the body of the request.", + StatusCode: http.StatusOK, + Headers: []ParameterDescriptor{ + { + Name: "Content-Length", + Type: "integer", + Description: "The length of the requested blob content.", + Format: "", + }, + digestHeader, + }, + Body: BodyDescriptor{ + ContentType: "application/octet-stream", + Format: "", + }, + }, + { + Description: "The blob identified by `digest` is available at the provided location.", + StatusCode: http.StatusTemporaryRedirect, + Headers: []ParameterDescriptor{ + { + Name: "Location", + Type: "url", + Description: "The location where the layer should be accessible.", + Format: "", + }, + digestHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "There was a problem with the request that needs to be addressed by the client, such as an invalid `name` or `tag`.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameInvalid, + ErrorCodeDigestInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponse, + { + Description: "The blob, identified by `name` and `digest`, is unknown to the registry.", + StatusCode: http.StatusNotFound, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameUnknown, + ErrorCodeBlobUnknown, + }, + }, + }, + }, + { + Name: "Fetch Blob Part", + Description: "This endpoint may also support RFC7233 compliant range requests. Support can be detected by issuing a HEAD request. If the header `Accept-Range: bytes` is returned, range requests can be used to fetch partial content.", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + { + Name: "Range", + Type: "string", + Description: "HTTP Range header specifying blob chunk.", + Format: "bytes=-", + }, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + digestPathParameter, + }, + Successes: []ResponseDescriptor{ + { + Description: "The blob identified by `digest` is available. The specified chunk of blob content will be present in the body of the request.", + StatusCode: http.StatusPartialContent, + Headers: []ParameterDescriptor{ + { + Name: "Content-Length", + Type: "integer", + Description: "The length of the requested blob chunk.", + Format: "", + }, + { + Name: "Content-Range", + Type: "byte range", + Description: "Content range of blob chunk.", + Format: "bytes -/", + }, + }, + Body: BodyDescriptor{ + ContentType: "application/octet-stream", + Format: "", + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "There was a problem with the request that needs to be addressed by the client, such as an invalid `name` or `tag`.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameInvalid, + ErrorCodeDigestInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponse, + { + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameUnknown, + ErrorCodeBlobUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + { + Description: "The range specification cannot be satisfied for the requested content. This can happen when the range is not formatted correctly or if the range is outside of the valid size of the content.", + StatusCode: http.StatusRequestedRangeNotSatisfiable, + }, + }, + }, + }, + }, + // TODO(stevvooe): We may want to add a PUT request here to + // kickoff an upload of a blob, integrated with the blob upload + // API. + }, + }, + + { + Name: RouteNameBlobUpload, + Path: "/v2/{name:" + RepositoryNameRegexp.String() + "}/blobs/uploads/", + Entity: "Intiate Blob Upload", + Description: "Initiate a blob upload. This endpoint can be used to create resumable uploads or monolithic uploads.", + Methods: []MethodDescriptor{ + { + Method: "POST", + Description: "Initiate a resumable blob upload. If successful, an upload location will be provided to complete the upload. Optionally, if the `digest` parameter is present, the request body will be used to complete the upload in a single request.", + Requests: []RequestDescriptor{ + { + Name: "Initiate Monolithic Blob Upload", + Description: "Upload a blob identified by the `digest` parameter in single request. This upload will not be resumable unless a recoverable error is returned.", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + { + Name: "Content-Length", + Type: "integer", + Format: "", + }, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + }, + QueryParameters: []ParameterDescriptor{ + { + Name: "digest", + Type: "query", + Format: "", + Regexp: digest.DigestRegexp, + Description: `Digest of uploaded blob. If present, the upload will be completed, in a single request, with contents of the request body as the resulting blob.`, + }, + }, + Body: BodyDescriptor{ + ContentType: "application/octect-stream", + Format: "", + }, + Successes: []ResponseDescriptor{ + { + Description: "The blob has been created in the registry and is available at the provided location.", + StatusCode: http.StatusCreated, + Headers: []ParameterDescriptor{ + { + Name: "Location", + Type: "url", + Format: "", + }, + contentLengthZeroHeader, + dockerUploadUUIDHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Name: "Invalid Name or Digest", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeDigestInvalid, + ErrorCodeNameInvalid, + }, + }, + unauthorizedResponsePush, + }, + }, + { + Name: "Initiate Resumable Blob Upload", + Description: "Initiate a resumable blob upload with an empty request body.", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + contentLengthZeroHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + }, + Successes: []ResponseDescriptor{ + { + Description: "The upload has been created. The `Location` header must be used to complete the upload. The response should be identical to a `GET` request on the contents of the returned `Location` header.", + StatusCode: http.StatusAccepted, + Headers: []ParameterDescriptor{ + contentLengthZeroHeader, + { + Name: "Location", + Type: "url", + Format: "/v2//blobs/uploads/", + Description: "The location of the created upload. Clients should use the contents verbatim to complete the upload, adding parameters where required.", + }, + { + Name: "Range", + Format: "0-0", + Description: "Range header indicating the progress of the upload. When starting an upload, it will return an empty range, since no content has been received.", + }, + dockerUploadUUIDHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Name: "Invalid Name or Digest", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeDigestInvalid, + ErrorCodeNameInvalid, + }, + }, + unauthorizedResponsePush, + }, + }, + }, + }, + }, + }, + + { + Name: RouteNameBlobUploadChunk, + Path: "/v2/{name:" + RepositoryNameRegexp.String() + "}/blobs/uploads/{uuid:[a-zA-Z0-9-_.=]+}", + Entity: "Blob Upload", + Description: "Interact with blob uploads. Clients should never assemble URLs for this endpoint and should only take it through the `Location` header on related API requests. The `Location` header and its parameters should be preserved by clients, using the latest value returned via upload related API calls.", + Methods: []MethodDescriptor{ + { + Method: "GET", + Description: "Retrieve status of upload identified by `uuid`. The primary purpose of this endpoint is to resolve the current status of a resumable upload.", + Requests: []RequestDescriptor{ + { + Description: "Retrieve the progress of the current upload, as reported by the `Range` header.", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + uuidParameterDescriptor, + }, + Successes: []ResponseDescriptor{ + { + Name: "Upload Progress", + Description: "The upload is known and in progress. The last received offset is available in the `Range` header.", + StatusCode: http.StatusNoContent, + Headers: []ParameterDescriptor{ + { + Name: "Range", + Type: "header", + Format: "0-", + Description: "Range indicating the current progress of the upload.", + }, + contentLengthZeroHeader, + dockerUploadUUIDHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "There was an error processing the upload and it must be restarted.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeDigestInvalid, + ErrorCodeNameInvalid, + ErrorCodeBlobUploadInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponse, + { + Description: "The upload is unknown to the registry. The upload must be restarted.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeBlobUploadUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + }, + }, + { + Method: "PATCH", + Description: "Upload a chunk of data for the specified upload.", + Requests: []RequestDescriptor{ + { + Name: "Stream upload", + Description: "Upload a stream of data to upload without completing the upload.", + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + uuidParameterDescriptor, + }, + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + }, + Body: BodyDescriptor{ + ContentType: "application/octet-stream", + Format: "", + }, + Successes: []ResponseDescriptor{ + { + Name: "Data Accepted", + Description: "The stream of data has been accepted and the current progress is available in the range header. The updated upload location is available in the `Location` header.", + StatusCode: http.StatusNoContent, + Headers: []ParameterDescriptor{ + { + Name: "Location", + Type: "url", + Format: "/v2//blobs/uploads/", + Description: "The location of the upload. Clients should assume this changes after each request. Clients should use the contents verbatim to complete the upload, adding parameters where required.", + }, + { + Name: "Range", + Type: "header", + Format: "0-", + Description: "Range indicating the current progress of the upload.", + }, + contentLengthZeroHeader, + dockerUploadUUIDHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "There was an error processing the upload and it must be restarted.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeDigestInvalid, + ErrorCodeNameInvalid, + ErrorCodeBlobUploadInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponsePush, + { + Description: "The upload is unknown to the registry. The upload must be restarted.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeBlobUploadUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + { + Name: "Chunked upload", + Description: "Upload a chunk of data to specified upload without completing the upload. The data will be uploaded to the specified Content Range.", + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + uuidParameterDescriptor, + }, + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + { + Name: "Content-Range", + Type: "header", + Format: "-", + Required: true, + Description: "Range of bytes identifying the desired block of content represented by the body. Start must the end offset retrieved via status check plus one. Note that this is a non-standard use of the `Content-Range` header.", + }, + { + Name: "Content-Length", + Type: "integer", + Format: "", + Description: "Length of the chunk being uploaded, corresponding the length of the request body.", + }, + }, + Body: BodyDescriptor{ + ContentType: "application/octet-stream", + Format: "", + }, + Successes: []ResponseDescriptor{ + { + Name: "Chunk Accepted", + Description: "The chunk of data has been accepted and the current progress is available in the range header. The updated upload location is available in the `Location` header.", + StatusCode: http.StatusNoContent, + Headers: []ParameterDescriptor{ + { + Name: "Location", + Type: "url", + Format: "/v2//blobs/uploads/", + Description: "The location of the upload. Clients should assume this changes after each request. Clients should use the contents verbatim to complete the upload, adding parameters where required.", + }, + { + Name: "Range", + Type: "header", + Format: "0-", + Description: "Range indicating the current progress of the upload.", + }, + contentLengthZeroHeader, + dockerUploadUUIDHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "There was an error processing the upload and it must be restarted.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeDigestInvalid, + ErrorCodeNameInvalid, + ErrorCodeBlobUploadInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponsePush, + { + Description: "The upload is unknown to the registry. The upload must be restarted.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeBlobUploadUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + { + Description: "The `Content-Range` specification cannot be accepted, either because it does not overlap with the current progress or it is invalid.", + StatusCode: http.StatusRequestedRangeNotSatisfiable, + }, + }, + }, + }, + }, + { + Method: "PUT", + Description: "Complete the upload specified by `uuid`, optionally appending the body as the final chunk.", + Requests: []RequestDescriptor{ + { + Description: "Complete the upload, providing all the data in the body, if necessary. A request without a body will just complete the upload with previously uploaded content.", + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + { + Name: "Content-Length", + Type: "integer", + Format: "", + Description: "Length of the data being uploaded, corresponding to the length of the request body. May be zero if no data is provided.", + }, + }, + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + uuidParameterDescriptor, + }, + QueryParameters: []ParameterDescriptor{ + { + Name: "digest", + Type: "string", + Format: "", + Regexp: digest.DigestRegexp, + Required: true, + Description: `Digest of uploaded blob.`, + }, + }, + Body: BodyDescriptor{ + ContentType: "application/octet-stream", + Format: "", + }, + Successes: []ResponseDescriptor{ + { + Name: "Upload Complete", + Description: "The upload has been completed and accepted by the registry. The canonical location will be available in the `Location` header.", + StatusCode: http.StatusNoContent, + Headers: []ParameterDescriptor{ + { + Name: "Location", + Type: "url", + Format: "", + Description: "The canonical location of the blob for retrieval", + }, + { + Name: "Content-Range", + Type: "header", + Format: "-", + Description: "Range of bytes identifying the desired block of content represented by the body. Start must match the end of offset retrieved via status check. Note that this is a non-standard use of the `Content-Range` header.", + }, + contentLengthZeroHeader, + digestHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "There was an error processing the upload and it must be restarted.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeDigestInvalid, + ErrorCodeNameInvalid, + ErrorCodeBlobUploadInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponsePush, + { + Description: "The upload is unknown to the registry. The upload must be restarted.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeBlobUploadUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + }, + }, + { + Method: "DELETE", + Description: "Cancel outstanding upload processes, releasing associated resources. If this is not called, the unfinished uploads will eventually timeout.", + Requests: []RequestDescriptor{ + { + Description: "Cancel the upload specified by `uuid`.", + PathParameters: []ParameterDescriptor{ + nameParameterDescriptor, + uuidParameterDescriptor, + }, + Headers: []ParameterDescriptor{ + hostHeader, + authHeader, + contentLengthZeroHeader, + }, + Successes: []ResponseDescriptor{ + { + Name: "Upload Deleted", + Description: "The upload has been successfully deleted.", + StatusCode: http.StatusNoContent, + Headers: []ParameterDescriptor{ + contentLengthZeroHeader, + }, + }, + }, + Failures: []ResponseDescriptor{ + { + Description: "An error was encountered processing the delete. The client may ignore this error.", + StatusCode: http.StatusBadRequest, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeNameInvalid, + ErrorCodeBlobUploadInvalid, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + unauthorizedResponse, + { + Description: "The upload is unknown to the registry. The client may ignore this error and assume the upload has been deleted.", + StatusCode: http.StatusNotFound, + ErrorCodes: []errcode.ErrorCode{ + ErrorCodeBlobUploadUnknown, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: errorsBody, + }, + }, + }, + }, + }, + }, + }, + }, + { + Name: RouteNameCatalog, + Path: "/v2/_catalog", + Entity: "Catalog", + Description: "List a set of available repositories in the local registry cluster. Does not provide any indication of what may be available upstream. Applications can only determine if a repository is available but not if it is not available.", + Methods: []MethodDescriptor{ + { + Method: "GET", + Description: "Retrieve a sorted, json list of repositories available in the registry.", + Requests: []RequestDescriptor{ + { + Name: "Catalog Fetch Complete", + Description: "Request an unabridged list of repositories available.", + Successes: []ResponseDescriptor{ + { + Description: "Returns the unabridged list of repositories as a json response.", + StatusCode: http.StatusOK, + Headers: []ParameterDescriptor{ + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON response body.", + Format: "", + }, + }, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: `{ + "repositories": [ + , + ... + ] +}`, + }, + }, + }, + }, + { + Name: "Catalog Fetch Paginated", + Description: "Return the specified portion of repositories.", + QueryParameters: paginationParameters, + Successes: []ResponseDescriptor{ + { + StatusCode: http.StatusOK, + Body: BodyDescriptor{ + ContentType: "application/json; charset=utf-8", + Format: `{ + "repositories": [ + , + ... + ] + "next": "?last=&n=" +}`, + }, + Headers: []ParameterDescriptor{ + { + Name: "Content-Length", + Type: "integer", + Description: "Length of the JSON response body.", + Format: "", + }, + linkHeader, + }, + }, + }, + }, + }, + }, + }, + }, +} + +var routeDescriptorsMap map[string]RouteDescriptor + +func init() { + routeDescriptorsMap = make(map[string]RouteDescriptor, len(routeDescriptors)) + + for _, descriptor := range routeDescriptors { + routeDescriptorsMap[descriptor.Name] = descriptor + } +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/v2/doc.go b/vendor/src/github.com/docker/distribution/registry/api/v2/doc.go new file mode 100644 index 0000000000..cde0119594 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/v2/doc.go @@ -0,0 +1,9 @@ +// Package v2 describes routes, urls and the error codes used in the Docker +// Registry JSON HTTP API V2. In addition to declarations, descriptors are +// provided for routes and error codes that can be used for implementation and +// automatically generating documentation. +// +// Definitions here are considered to be locked down for the V2 registry api. +// Any changes must be considered carefully and should not proceed without a +// change proposal in docker core. +package v2 diff --git a/vendor/src/github.com/docker/distribution/registry/api/v2/errors.go b/vendor/src/github.com/docker/distribution/registry/api/v2/errors.go new file mode 100644 index 0000000000..87e27f2e46 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/v2/errors.go @@ -0,0 +1,154 @@ +package v2 + +import ( + "net/http" + + "github.com/docker/distribution/registry/api/errcode" +) + +const errGroup = "registry.api.v2" + +var ( + // ErrorCodeUnsupported is returned when an operation is not supported. + ErrorCodeUnsupported = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "UNSUPPORTED", + Message: "The operation is unsupported.", + Description: `The operation was unsupported due to a missing + implementation or invalid set of parameters.`, + }) + + // ErrorCodeUnauthorized is returned if a request is not authorized. + ErrorCodeUnauthorized = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "UNAUTHORIZED", + Message: "access to the requested resource is not authorized", + Description: `The access controller denied access for the operation on + a resource. Often this will be accompanied by a 401 Unauthorized + response status.`, + HTTPStatusCode: http.StatusUnauthorized, + }) + + // ErrorCodeDigestInvalid is returned when uploading a blob if the + // provided digest does not match the blob contents. + ErrorCodeDigestInvalid = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "DIGEST_INVALID", + Message: "provided digest did not match uploaded content", + Description: `When a blob is uploaded, the registry will check that + the content matches the digest provided by the client. The error may + include a detail structure with the key "digest", including the + invalid digest string. This error may also be returned when a manifest + includes an invalid layer digest.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeSizeInvalid is returned when uploading a blob if the provided + ErrorCodeSizeInvalid = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "SIZE_INVALID", + Message: "provided length did not match content length", + Description: `When a layer is uploaded, the provided size will be + checked against the uploaded content. If they do not match, this error + will be returned.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeNameInvalid is returned when the name in the manifest does not + // match the provided name. + ErrorCodeNameInvalid = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "NAME_INVALID", + Message: "invalid repository name", + Description: `Invalid repository name encountered either during + manifest validation or any API operation.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeTagInvalid is returned when the tag in the manifest does not + // match the provided tag. + ErrorCodeTagInvalid = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "TAG_INVALID", + Message: "manifest tag did not match URI", + Description: `During a manifest upload, if the tag in the manifest + does not match the uri tag, this error will be returned.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeNameUnknown when the repository name is not known. + ErrorCodeNameUnknown = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "NAME_UNKNOWN", + Message: "repository name not known to registry", + Description: `This is returned if the name used during an operation is + unknown to the registry.`, + HTTPStatusCode: http.StatusNotFound, + }) + + // ErrorCodeManifestUnknown returned when image manifest is unknown. + ErrorCodeManifestUnknown = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "MANIFEST_UNKNOWN", + Message: "manifest unknown", + Description: `This error is returned when the manifest, identified by + name and tag is unknown to the repository.`, + HTTPStatusCode: http.StatusNotFound, + }) + + // ErrorCodeManifestInvalid returned when an image manifest is invalid, + // typically during a PUT operation. This error encompasses all errors + // encountered during manifest validation that aren't signature errors. + ErrorCodeManifestInvalid = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "MANIFEST_INVALID", + Message: "manifest invalid", + Description: `During upload, manifests undergo several checks ensuring + validity. If those checks fail, this error may be returned, unless a + more specific error is included. The detail will contain information + the failed validation.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeManifestUnverified is returned when the manifest fails + // signature verfication. + ErrorCodeManifestUnverified = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "MANIFEST_UNVERIFIED", + Message: "manifest failed signature verification", + Description: `During manifest upload, if the manifest fails signature + verification, this error will be returned.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeManifestBlobUnknown is returned when a manifest blob is + // unknown to the registry. + ErrorCodeManifestBlobUnknown = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "MANIFEST_BLOB_UNKNOWN", + Message: "blob unknown to registry", + Description: `This error may be returned when a manifest blob is + unknown to the registry.`, + HTTPStatusCode: http.StatusBadRequest, + }) + + // ErrorCodeBlobUnknown is returned when a blob is unknown to the + // registry. This can happen when the manifest references a nonexistent + // layer or the result is not found by a blob fetch. + ErrorCodeBlobUnknown = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "BLOB_UNKNOWN", + Message: "blob unknown to registry", + Description: `This error may be returned when a blob is unknown to the + registry in a specified repository. This can be returned with a + standard get or if a manifest references an unknown layer during + upload.`, + HTTPStatusCode: http.StatusNotFound, + }) + + // ErrorCodeBlobUploadUnknown is returned when an upload is unknown. + ErrorCodeBlobUploadUnknown = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "BLOB_UPLOAD_UNKNOWN", + Message: "blob upload unknown to registry", + Description: `If a blob upload has been cancelled or was never + started, this error code may be returned.`, + HTTPStatusCode: http.StatusNotFound, + }) + + // ErrorCodeBlobUploadInvalid is returned when an upload is invalid. + ErrorCodeBlobUploadInvalid = errcode.Register(errGroup, errcode.ErrorDescriptor{ + Value: "BLOB_UPLOAD_INVALID", + Message: "blob upload invalid", + Description: `The blob upload encountered an error and can no + longer proceed.`, + HTTPStatusCode: http.StatusNotFound, + }) +) diff --git a/vendor/src/github.com/docker/distribution/registry/api/v2/names.go b/vendor/src/github.com/docker/distribution/registry/api/v2/names.go new file mode 100644 index 0000000000..5f340793c8 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/v2/names.go @@ -0,0 +1,96 @@ +package v2 + +import ( + "fmt" + "regexp" + "strings" +) + +// TODO(stevvooe): Move these definitions to the future "reference" package. +// While they are used with v2 definitions, their relevance expands beyond. + +const ( + // RepositoryNameTotalLengthMax is the maximum total number of characters in + // a repository name + RepositoryNameTotalLengthMax = 255 +) + +// domainLabelRegexp represents the following RFC-2396 BNF construct: +// domainlabel = alphanum | alphanum *( alphanum | "-" ) alphanum +var domainLabelRegexp = regexp.MustCompile(`[a-z0-9](?:-*[a-z0-9])*`) + +// RepositoryNameComponentRegexp restricts registry path component names to +// the allow valid hostnames according to: https://www.ietf.org/rfc/rfc2396.txt +// with the following differences: +// 1) It DOES NOT allow for fully-qualified domain names, which include a +// trailing '.', e.g. "google.com." +// 2) It DOES NOT restrict 'top-level' domain labels to start with just alpha +// characters. +// 3) It DOES allow for underscores to appear in the same situations as dots. +// +// RFC-2396 uses the BNF construct: +// hostname = *( domainlabel "." ) toplabel [ "." ] +var RepositoryNameComponentRegexp = regexp.MustCompile( + domainLabelRegexp.String() + `(?:[._]` + domainLabelRegexp.String() + `)*`) + +// RepositoryNameComponentAnchoredRegexp is the version of +// RepositoryNameComponentRegexp which must completely match the content +var RepositoryNameComponentAnchoredRegexp = regexp.MustCompile(`^` + RepositoryNameComponentRegexp.String() + `$`) + +// RepositoryNameRegexp builds on RepositoryNameComponentRegexp to allow +// multiple path components, separated by a forward slash. +var RepositoryNameRegexp = regexp.MustCompile(`(?:` + RepositoryNameComponentRegexp.String() + `/)*` + RepositoryNameComponentRegexp.String()) + +// TagNameRegexp matches valid tag names. From docker/docker:graph/tags.go. +var TagNameRegexp = regexp.MustCompile(`[\w][\w.-]{0,127}`) + +// TagNameAnchoredRegexp matches valid tag names, anchored at the start and +// end of the matched string. +var TagNameAnchoredRegexp = regexp.MustCompile("^" + TagNameRegexp.String() + "$") + +var ( + // ErrRepositoryNameEmpty is returned for empty, invalid repository names. + ErrRepositoryNameEmpty = fmt.Errorf("repository name must have at least one component") + + // ErrRepositoryNameLong is returned when a repository name is longer than + // RepositoryNameTotalLengthMax + ErrRepositoryNameLong = fmt.Errorf("repository name must not be more than %v characters", RepositoryNameTotalLengthMax) + + // ErrRepositoryNameComponentInvalid is returned when a repository name does + // not match RepositoryNameComponentRegexp + ErrRepositoryNameComponentInvalid = fmt.Errorf("repository name component must match %q", RepositoryNameComponentRegexp.String()) +) + +// ValidateRepositoryName ensures the repository name is valid for use in the +// registry. This function accepts a superset of what might be accepted by +// docker core or docker hub. If the name does not pass validation, an error, +// describing the conditions, is returned. +// +// Effectively, the name should comply with the following grammar: +// +// alpha-numeric := /[a-z0-9]+/ +// separator := /[._-]/ +// component := alpha-numeric [separator alpha-numeric]* +// namespace := component ['/' component]* +// +// The result of the production, known as the "namespace", should be limited +// to 255 characters. +func ValidateRepositoryName(name string) error { + if name == "" { + return ErrRepositoryNameEmpty + } + + if len(name) > RepositoryNameTotalLengthMax { + return ErrRepositoryNameLong + } + + components := strings.Split(name, "/") + + for _, component := range components { + if !RepositoryNameComponentAnchoredRegexp.MatchString(component) { + return ErrRepositoryNameComponentInvalid + } + } + + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/v2/routes.go b/vendor/src/github.com/docker/distribution/registry/api/v2/routes.go new file mode 100644 index 0000000000..5b80d5be76 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/v2/routes.go @@ -0,0 +1,49 @@ +package v2 + +import "github.com/gorilla/mux" + +// The following are definitions of the name under which all V2 routes are +// registered. These symbols can be used to look up a route based on the name. +const ( + RouteNameBase = "base" + RouteNameManifest = "manifest" + RouteNameTags = "tags" + RouteNameBlob = "blob" + RouteNameBlobUpload = "blob-upload" + RouteNameBlobUploadChunk = "blob-upload-chunk" + RouteNameCatalog = "catalog" +) + +var allEndpoints = []string{ + RouteNameManifest, + RouteNameCatalog, + RouteNameTags, + RouteNameBlob, + RouteNameBlobUpload, + RouteNameBlobUploadChunk, +} + +// Router builds a gorilla router with named routes for the various API +// methods. This can be used directly by both server implementations and +// clients. +func Router() *mux.Router { + return RouterWithPrefix("") +} + +// RouterWithPrefix builds a gorilla router with a configured prefix +// on all routes. +func RouterWithPrefix(prefix string) *mux.Router { + rootRouter := mux.NewRouter() + router := rootRouter + if prefix != "" { + router = router.PathPrefix(prefix).Subrouter() + } + + router.StrictSlash(true) + + for _, descriptor := range routeDescriptors { + router.Path(descriptor.Path).Name(descriptor.Name) + } + + return rootRouter +} diff --git a/vendor/src/github.com/docker/distribution/registry/api/v2/urls.go b/vendor/src/github.com/docker/distribution/registry/api/v2/urls.go new file mode 100644 index 0000000000..4297439400 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/api/v2/urls.go @@ -0,0 +1,234 @@ +package v2 + +import ( + "net/http" + "net/url" + "strings" + + "github.com/docker/distribution/digest" + "github.com/gorilla/mux" +) + +// URLBuilder creates registry API urls from a single base endpoint. It can be +// used to create urls for use in a registry client or server. +// +// All urls will be created from the given base, including the api version. +// For example, if a root of "/foo/" is provided, urls generated will be fall +// under "/foo/v2/...". Most application will only provide a schema, host and +// port, such as "https://localhost:5000/". +type URLBuilder struct { + root *url.URL // url root (ie http://localhost/) + router *mux.Router +} + +// NewURLBuilder creates a URLBuilder with provided root url object. +func NewURLBuilder(root *url.URL) *URLBuilder { + return &URLBuilder{ + root: root, + router: Router(), + } +} + +// NewURLBuilderFromString workes identically to NewURLBuilder except it takes +// a string argument for the root, returning an error if it is not a valid +// url. +func NewURLBuilderFromString(root string) (*URLBuilder, error) { + u, err := url.Parse(root) + if err != nil { + return nil, err + } + + return NewURLBuilder(u), nil +} + +// NewURLBuilderFromRequest uses information from an *http.Request to +// construct the root url. +func NewURLBuilderFromRequest(r *http.Request) *URLBuilder { + var scheme string + + forwardedProto := r.Header.Get("X-Forwarded-Proto") + + switch { + case len(forwardedProto) > 0: + scheme = forwardedProto + case r.TLS != nil: + scheme = "https" + case len(r.URL.Scheme) > 0: + scheme = r.URL.Scheme + default: + scheme = "http" + } + + host := r.Host + forwardedHost := r.Header.Get("X-Forwarded-Host") + if len(forwardedHost) > 0 { + // According to the Apache mod_proxy docs, X-Forwarded-Host can be a + // comma-separated list of hosts, to which each proxy appends the + // requested host. We want to grab the first from this comma-separated + // list. + hosts := strings.SplitN(forwardedHost, ",", 2) + host = strings.TrimSpace(hosts[0]) + } + + basePath := routeDescriptorsMap[RouteNameBase].Path + + requestPath := r.URL.Path + index := strings.Index(requestPath, basePath) + + u := &url.URL{ + Scheme: scheme, + Host: host, + } + + if index > 0 { + // N.B. index+1 is important because we want to include the trailing / + u.Path = requestPath[0 : index+1] + } + + return NewURLBuilder(u) +} + +// BuildBaseURL constructs a base url for the API, typically just "/v2/". +func (ub *URLBuilder) BuildBaseURL() (string, error) { + route := ub.cloneRoute(RouteNameBase) + + baseURL, err := route.URL() + if err != nil { + return "", err + } + + return baseURL.String(), nil +} + +// BuildCatalogURL constructs a url get a catalog of repositories +func (ub *URLBuilder) BuildCatalogURL(values ...url.Values) (string, error) { + route := ub.cloneRoute(RouteNameCatalog) + + catalogURL, err := route.URL() + if err != nil { + return "", err + } + + return appendValuesURL(catalogURL, values...).String(), nil +} + +// BuildTagsURL constructs a url to list the tags in the named repository. +func (ub *URLBuilder) BuildTagsURL(name string) (string, error) { + route := ub.cloneRoute(RouteNameTags) + + tagsURL, err := route.URL("name", name) + if err != nil { + return "", err + } + + return tagsURL.String(), nil +} + +// BuildManifestURL constructs a url for the manifest identified by name and +// reference. The argument reference may be either a tag or digest. +func (ub *URLBuilder) BuildManifestURL(name, reference string) (string, error) { + route := ub.cloneRoute(RouteNameManifest) + + manifestURL, err := route.URL("name", name, "reference", reference) + if err != nil { + return "", err + } + + return manifestURL.String(), nil +} + +// BuildBlobURL constructs the url for the blob identified by name and dgst. +func (ub *URLBuilder) BuildBlobURL(name string, dgst digest.Digest) (string, error) { + route := ub.cloneRoute(RouteNameBlob) + + layerURL, err := route.URL("name", name, "digest", dgst.String()) + if err != nil { + return "", err + } + + return layerURL.String(), nil +} + +// BuildBlobUploadURL constructs a url to begin a blob upload in the +// repository identified by name. +func (ub *URLBuilder) BuildBlobUploadURL(name string, values ...url.Values) (string, error) { + route := ub.cloneRoute(RouteNameBlobUpload) + + uploadURL, err := route.URL("name", name) + if err != nil { + return "", err + } + + return appendValuesURL(uploadURL, values...).String(), nil +} + +// BuildBlobUploadChunkURL constructs a url for the upload identified by uuid, +// including any url values. This should generally not be used by clients, as +// this url is provided by server implementations during the blob upload +// process. +func (ub *URLBuilder) BuildBlobUploadChunkURL(name, uuid string, values ...url.Values) (string, error) { + route := ub.cloneRoute(RouteNameBlobUploadChunk) + + uploadURL, err := route.URL("name", name, "uuid", uuid) + if err != nil { + return "", err + } + + return appendValuesURL(uploadURL, values...).String(), nil +} + +// clondedRoute returns a clone of the named route from the router. Routes +// must be cloned to avoid modifying them during url generation. +func (ub *URLBuilder) cloneRoute(name string) clonedRoute { + route := new(mux.Route) + root := new(url.URL) + + *route = *ub.router.GetRoute(name) // clone the route + *root = *ub.root + + return clonedRoute{Route: route, root: root} +} + +type clonedRoute struct { + *mux.Route + root *url.URL +} + +func (cr clonedRoute) URL(pairs ...string) (*url.URL, error) { + routeURL, err := cr.Route.URL(pairs...) + if err != nil { + return nil, err + } + + if routeURL.Scheme == "" && routeURL.User == nil && routeURL.Host == "" { + routeURL.Path = routeURL.Path[1:] + } + + return cr.root.ResolveReference(routeURL), nil +} + +// appendValuesURL appends the parameters to the url. +func appendValuesURL(u *url.URL, values ...url.Values) *url.URL { + merged := u.Query() + + for _, v := range values { + for k, vv := range v { + merged[k] = append(merged[k], vv...) + } + } + + u.RawQuery = merged.Encode() + return u +} + +// appendValues appends the parameters to the url. Panics if the string is not +// a url. +func appendValues(u string, values ...url.Values) string { + up, err := url.Parse(u) + + if err != nil { + panic(err) // should never happen + } + + return appendValuesURL(up, values...).String() +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/auth/api_version.go b/vendor/src/github.com/docker/distribution/registry/client/auth/api_version.go new file mode 100644 index 0000000000..7d8f1d9576 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/auth/api_version.go @@ -0,0 +1,58 @@ +package auth + +import ( + "net/http" + "strings" +) + +// APIVersion represents a version of an API including its +// type and version number. +type APIVersion struct { + // Type refers to the name of a specific API specification + // such as "registry" + Type string + + // Version is the version of the API specification implemented, + // This may omit the revision number and only include + // the major and minor version, such as "2.0" + Version string +} + +// String returns the string formatted API Version +func (v APIVersion) String() string { + return v.Type + "/" + v.Version +} + +// APIVersions gets the API versions out of an HTTP response using the provided +// version header as the key for the HTTP header. +func APIVersions(resp *http.Response, versionHeader string) []APIVersion { + versions := []APIVersion{} + if versionHeader != "" { + for _, supportedVersions := range resp.Header[http.CanonicalHeaderKey(versionHeader)] { + for _, version := range strings.Fields(supportedVersions) { + versions = append(versions, ParseAPIVersion(version)) + } + } + } + return versions +} + +// ParseAPIVersion parses an API version string into an APIVersion +// Format (Expected, not enforced): +// API version string = '/' +// API type = [a-z][a-z0-9]* +// API version = [0-9]+(\.[0-9]+)? +// TODO(dmcgowan): Enforce format, add error condition, remove unknown type +func ParseAPIVersion(versionStr string) APIVersion { + idx := strings.IndexRune(versionStr, '/') + if idx == -1 { + return APIVersion{ + Type: "unknown", + Version: versionStr, + } + } + return APIVersion{ + Type: strings.ToLower(versionStr[:idx]), + Version: versionStr[idx+1:], + } +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/auth/authchallenge.go b/vendor/src/github.com/docker/distribution/registry/client/auth/authchallenge.go new file mode 100644 index 0000000000..a6ad45d854 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/auth/authchallenge.go @@ -0,0 +1,219 @@ +package auth + +import ( + "fmt" + "net/http" + "net/url" + "strings" +) + +// Challenge carries information from a WWW-Authenticate response header. +// See RFC 2617. +type Challenge struct { + // Scheme is the auth-scheme according to RFC 2617 + Scheme string + + // Parameters are the auth-params according to RFC 2617 + Parameters map[string]string +} + +// ChallengeManager manages the challenges for endpoints. +// The challenges are pulled out of HTTP responses. Only +// responses which expect challenges should be added to +// the manager, since a non-unauthorized request will be +// viewed as not requiring challenges. +type ChallengeManager interface { + // GetChallenges returns the challenges for the given + // endpoint URL. + GetChallenges(endpoint string) ([]Challenge, error) + + // AddResponse adds the response to the challenge + // manager. The challenges will be parsed out of + // the WWW-Authenicate headers and added to the + // URL which was produced the response. If the + // response was authorized, any challenges for the + // endpoint will be cleared. + AddResponse(resp *http.Response) error +} + +// NewSimpleChallengeManager returns an instance of +// ChallengeManger which only maps endpoints to challenges +// based on the responses which have been added the +// manager. The simple manager will make no attempt to +// perform requests on the endpoints or cache the responses +// to a backend. +func NewSimpleChallengeManager() ChallengeManager { + return simpleChallengeManager{} +} + +type simpleChallengeManager map[string][]Challenge + +func (m simpleChallengeManager) GetChallenges(endpoint string) ([]Challenge, error) { + challenges := m[endpoint] + return challenges, nil +} + +func (m simpleChallengeManager) AddResponse(resp *http.Response) error { + challenges := ResponseChallenges(resp) + if resp.Request == nil { + return fmt.Errorf("missing request reference") + } + urlCopy := url.URL{ + Path: resp.Request.URL.Path, + Host: resp.Request.URL.Host, + Scheme: resp.Request.URL.Scheme, + } + m[urlCopy.String()] = challenges + + return nil +} + +// Octet types from RFC 2616. +type octetType byte + +var octetTypes [256]octetType + +const ( + isToken octetType = 1 << iota + isSpace +) + +func init() { + // OCTET = + // CHAR = + // CTL = + // CR = + // LF = + // SP = + // HT = + // <"> = + // CRLF = CR LF + // LWS = [CRLF] 1*( SP | HT ) + // TEXT = + // separators = "(" | ")" | "<" | ">" | "@" | "," | ";" | ":" | "\" | <"> + // | "/" | "[" | "]" | "?" | "=" | "{" | "}" | SP | HT + // token = 1* + // qdtext = > + + for c := 0; c < 256; c++ { + var t octetType + isCtl := c <= 31 || c == 127 + isChar := 0 <= c && c <= 127 + isSeparator := strings.IndexRune(" \t\"(),/:;<=>?@[]\\{}", rune(c)) >= 0 + if strings.IndexRune(" \t\r\n", rune(c)) >= 0 { + t |= isSpace + } + if isChar && !isCtl && !isSeparator { + t |= isToken + } + octetTypes[c] = t + } +} + +// ResponseChallenges returns a list of authorization challenges +// for the given http Response. Challenges are only checked if +// the response status code was a 401. +func ResponseChallenges(resp *http.Response) []Challenge { + if resp.StatusCode == http.StatusUnauthorized { + // Parse the WWW-Authenticate Header and store the challenges + // on this endpoint object. + return parseAuthHeader(resp.Header) + } + + return nil +} + +func parseAuthHeader(header http.Header) []Challenge { + challenges := []Challenge{} + for _, h := range header[http.CanonicalHeaderKey("WWW-Authenticate")] { + v, p := parseValueAndParams(h) + if v != "" { + challenges = append(challenges, Challenge{Scheme: v, Parameters: p}) + } + } + return challenges +} + +func parseValueAndParams(header string) (value string, params map[string]string) { + params = make(map[string]string) + value, s := expectToken(header) + if value == "" { + return + } + value = strings.ToLower(value) + s = "," + skipSpace(s) + for strings.HasPrefix(s, ",") { + var pkey string + pkey, s = expectToken(skipSpace(s[1:])) + if pkey == "" { + return + } + if !strings.HasPrefix(s, "=") { + return + } + var pvalue string + pvalue, s = expectTokenOrQuoted(s[1:]) + if pvalue == "" { + return + } + pkey = strings.ToLower(pkey) + params[pkey] = pvalue + s = skipSpace(s) + } + return +} + +func skipSpace(s string) (rest string) { + i := 0 + for ; i < len(s); i++ { + if octetTypes[s[i]]&isSpace == 0 { + break + } + } + return s[i:] +} + +func expectToken(s string) (token, rest string) { + i := 0 + for ; i < len(s); i++ { + if octetTypes[s[i]]&isToken == 0 { + break + } + } + return s[:i], s[i:] +} + +func expectTokenOrQuoted(s string) (value string, rest string) { + if !strings.HasPrefix(s, "\"") { + return expectToken(s) + } + s = s[1:] + for i := 0; i < len(s); i++ { + switch s[i] { + case '"': + return s[:i], s[i+1:] + case '\\': + p := make([]byte, len(s)-1) + j := copy(p, s[:i]) + escape := true + for i = i + 1; i < len(s); i++ { + b := s[i] + switch { + case escape: + escape = false + p[j] = b + j++ + case b == '\\': + escape = true + case b == '"': + return string(p[:j]), s[i+1:] + default: + p[j] = b + j++ + } + } + return "", "" + } + } + return "", "" +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/auth/session.go b/vendor/src/github.com/docker/distribution/registry/client/auth/session.go new file mode 100644 index 0000000000..27a2aa7191 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/auth/session.go @@ -0,0 +1,256 @@ +package auth + +import ( + "encoding/json" + "errors" + "fmt" + "net/http" + "net/url" + "strings" + "sync" + "time" + + "github.com/docker/distribution/registry/client" + "github.com/docker/distribution/registry/client/transport" +) + +// AuthenticationHandler is an interface for authorizing a request from +// params from a "WWW-Authenicate" header for a single scheme. +type AuthenticationHandler interface { + // Scheme returns the scheme as expected from the "WWW-Authenicate" header. + Scheme() string + + // AuthorizeRequest adds the authorization header to a request (if needed) + // using the parameters from "WWW-Authenticate" method. The parameters + // values depend on the scheme. + AuthorizeRequest(req *http.Request, params map[string]string) error +} + +// CredentialStore is an interface for getting credentials for +// a given URL +type CredentialStore interface { + // Basic returns basic auth for the given URL + Basic(*url.URL) (string, string) +} + +// NewAuthorizer creates an authorizer which can handle multiple authentication +// schemes. The handlers are tried in order, the higher priority authentication +// methods should be first. The challengeMap holds a list of challenges for +// a given root API endpoint (for example "https://registry-1.docker.io/v2/"). +func NewAuthorizer(manager ChallengeManager, handlers ...AuthenticationHandler) transport.RequestModifier { + return &endpointAuthorizer{ + challenges: manager, + handlers: handlers, + } +} + +type endpointAuthorizer struct { + challenges ChallengeManager + handlers []AuthenticationHandler + transport http.RoundTripper +} + +func (ea *endpointAuthorizer) ModifyRequest(req *http.Request) error { + v2Root := strings.Index(req.URL.Path, "/v2/") + if v2Root == -1 { + return nil + } + + ping := url.URL{ + Host: req.URL.Host, + Scheme: req.URL.Scheme, + Path: req.URL.Path[:v2Root+4], + } + + pingEndpoint := ping.String() + + challenges, err := ea.challenges.GetChallenges(pingEndpoint) + if err != nil { + return err + } + + if len(challenges) > 0 { + for _, handler := range ea.handlers { + for _, challenge := range challenges { + if challenge.Scheme != handler.Scheme() { + continue + } + if err := handler.AuthorizeRequest(req, challenge.Parameters); err != nil { + return err + } + } + } + } + + return nil +} + +type tokenHandler struct { + header http.Header + creds CredentialStore + scope tokenScope + transport http.RoundTripper + + tokenLock sync.Mutex + tokenCache string + tokenExpiration time.Time +} + +// tokenScope represents the scope at which a token will be requested. +// This represents a specific action on a registry resource. +type tokenScope struct { + Resource string + Scope string + Actions []string +} + +func (ts tokenScope) String() string { + return fmt.Sprintf("%s:%s:%s", ts.Resource, ts.Scope, strings.Join(ts.Actions, ",")) +} + +// NewTokenHandler creates a new AuthenicationHandler which supports +// fetching tokens from a remote token server. +func NewTokenHandler(transport http.RoundTripper, creds CredentialStore, scope string, actions ...string) AuthenticationHandler { + return &tokenHandler{ + transport: transport, + creds: creds, + scope: tokenScope{ + Resource: "repository", + Scope: scope, + Actions: actions, + }, + } +} + +func (th *tokenHandler) client() *http.Client { + return &http.Client{ + Transport: th.transport, + Timeout: 15 * time.Second, + } +} + +func (th *tokenHandler) Scheme() string { + return "bearer" +} + +func (th *tokenHandler) AuthorizeRequest(req *http.Request, params map[string]string) error { + if err := th.refreshToken(params); err != nil { + return err + } + + req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", th.tokenCache)) + + return nil +} + +func (th *tokenHandler) refreshToken(params map[string]string) error { + th.tokenLock.Lock() + defer th.tokenLock.Unlock() + now := time.Now() + if now.After(th.tokenExpiration) { + token, err := th.fetchToken(params) + if err != nil { + return err + } + th.tokenCache = token + th.tokenExpiration = now.Add(time.Minute) + } + + return nil +} + +type tokenResponse struct { + Token string `json:"token"` +} + +func (th *tokenHandler) fetchToken(params map[string]string) (token string, err error) { + //log.Debugf("Getting bearer token with %s for %s", challenge.Parameters, ta.auth.Username) + realm, ok := params["realm"] + if !ok { + return "", errors.New("no realm specified for token auth challenge") + } + + // TODO(dmcgowan): Handle empty scheme + + realmURL, err := url.Parse(realm) + if err != nil { + return "", fmt.Errorf("invalid token auth challenge realm: %s", err) + } + + req, err := http.NewRequest("GET", realmURL.String(), nil) + if err != nil { + return "", err + } + + reqParams := req.URL.Query() + service := params["service"] + scope := th.scope.String() + + if service != "" { + reqParams.Add("service", service) + } + + for _, scopeField := range strings.Fields(scope) { + reqParams.Add("scope", scopeField) + } + + if th.creds != nil { + username, password := th.creds.Basic(realmURL) + if username != "" && password != "" { + reqParams.Add("account", username) + req.SetBasicAuth(username, password) + } + } + + req.URL.RawQuery = reqParams.Encode() + + resp, err := th.client().Do(req) + if err != nil { + return "", err + } + defer resp.Body.Close() + + if !client.SuccessStatus(resp.StatusCode) { + return "", fmt.Errorf("token auth attempt for registry: %s request failed with status: %d %s", req.URL, resp.StatusCode, http.StatusText(resp.StatusCode)) + } + + decoder := json.NewDecoder(resp.Body) + + tr := new(tokenResponse) + if err = decoder.Decode(tr); err != nil { + return "", fmt.Errorf("unable to decode token response: %s", err) + } + + if tr.Token == "" { + return "", errors.New("authorization server did not include a token in the response") + } + + return tr.Token, nil +} + +type basicHandler struct { + creds CredentialStore +} + +// NewBasicHandler creaters a new authentiation handler which adds +// basic authentication credentials to a request. +func NewBasicHandler(creds CredentialStore) AuthenticationHandler { + return &basicHandler{ + creds: creds, + } +} + +func (*basicHandler) Scheme() string { + return "basic" +} + +func (bh *basicHandler) AuthorizeRequest(req *http.Request, params map[string]string) error { + if bh.creds != nil { + username, password := bh.creds.Basic(req.URL) + if username != "" && password != "" { + req.SetBasicAuth(username, password) + return nil + } + } + return errors.New("no basic auth credentials") +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/blob_writer.go b/vendor/src/github.com/docker/distribution/registry/client/blob_writer.go new file mode 100644 index 0000000000..5f6f01f7ff --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/blob_writer.go @@ -0,0 +1,172 @@ +package client + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "net/http" + "os" + "time" + + "github.com/docker/distribution" + "github.com/docker/distribution/context" +) + +type httpBlobUpload struct { + statter distribution.BlobStatter + client *http.Client + + uuid string + startedAt time.Time + + location string // always the last value of the location header. + offset int64 + closed bool +} + +func (hbu *httpBlobUpload) handleErrorResponse(resp *http.Response) error { + if resp.StatusCode == http.StatusNotFound { + return distribution.ErrBlobUploadUnknown + } + return handleErrorResponse(resp) +} + +func (hbu *httpBlobUpload) ReadFrom(r io.Reader) (n int64, err error) { + req, err := http.NewRequest("PATCH", hbu.location, ioutil.NopCloser(r)) + if err != nil { + return 0, err + } + defer req.Body.Close() + + resp, err := hbu.client.Do(req) + if err != nil { + return 0, err + } + + if !SuccessStatus(resp.StatusCode) { + return 0, hbu.handleErrorResponse(resp) + } + + hbu.uuid = resp.Header.Get("Docker-Upload-UUID") + hbu.location, err = sanitizeLocation(resp.Header.Get("Location"), hbu.location) + if err != nil { + return 0, err + } + rng := resp.Header.Get("Range") + var start, end int64 + if n, err := fmt.Sscanf(rng, "%d-%d", &start, &end); err != nil { + return 0, err + } else if n != 2 || end < start { + return 0, fmt.Errorf("bad range format: %s", rng) + } + + return (end - start + 1), nil + +} + +func (hbu *httpBlobUpload) Write(p []byte) (n int, err error) { + req, err := http.NewRequest("PATCH", hbu.location, bytes.NewReader(p)) + if err != nil { + return 0, err + } + req.Header.Set("Content-Range", fmt.Sprintf("%d-%d", hbu.offset, hbu.offset+int64(len(p)-1))) + req.Header.Set("Content-Length", fmt.Sprintf("%d", len(p))) + req.Header.Set("Content-Type", "application/octet-stream") + + resp, err := hbu.client.Do(req) + if err != nil { + return 0, err + } + + if !SuccessStatus(resp.StatusCode) { + return 0, hbu.handleErrorResponse(resp) + } + + hbu.uuid = resp.Header.Get("Docker-Upload-UUID") + hbu.location, err = sanitizeLocation(resp.Header.Get("Location"), hbu.location) + if err != nil { + return 0, err + } + rng := resp.Header.Get("Range") + var start, end int + if n, err := fmt.Sscanf(rng, "%d-%d", &start, &end); err != nil { + return 0, err + } else if n != 2 || end < start { + return 0, fmt.Errorf("bad range format: %s", rng) + } + + return (end - start + 1), nil + +} + +func (hbu *httpBlobUpload) Seek(offset int64, whence int) (int64, error) { + newOffset := hbu.offset + + switch whence { + case os.SEEK_CUR: + newOffset += int64(offset) + case os.SEEK_END: + newOffset += int64(offset) + case os.SEEK_SET: + newOffset = int64(offset) + } + + hbu.offset = newOffset + + return hbu.offset, nil +} + +func (hbu *httpBlobUpload) ID() string { + return hbu.uuid +} + +func (hbu *httpBlobUpload) StartedAt() time.Time { + return hbu.startedAt +} + +func (hbu *httpBlobUpload) Commit(ctx context.Context, desc distribution.Descriptor) (distribution.Descriptor, error) { + // TODO(dmcgowan): Check if already finished, if so just fetch + req, err := http.NewRequest("PUT", hbu.location, nil) + if err != nil { + return distribution.Descriptor{}, err + } + + values := req.URL.Query() + values.Set("digest", desc.Digest.String()) + req.URL.RawQuery = values.Encode() + + resp, err := hbu.client.Do(req) + if err != nil { + return distribution.Descriptor{}, err + } + defer resp.Body.Close() + + if !SuccessStatus(resp.StatusCode) { + return distribution.Descriptor{}, hbu.handleErrorResponse(resp) + } + + return hbu.statter.Stat(ctx, desc.Digest) +} + +func (hbu *httpBlobUpload) Cancel(ctx context.Context) error { + req, err := http.NewRequest("DELETE", hbu.location, nil) + if err != nil { + return err + } + resp, err := hbu.client.Do(req) + if err != nil { + return err + } + defer resp.Body.Close() + + if resp.StatusCode == http.StatusNotFound || SuccessStatus(resp.StatusCode) { + return nil + } + return hbu.handleErrorResponse(resp) +} + +func (hbu *httpBlobUpload) Close() error { + hbu.closed = true + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/errors.go b/vendor/src/github.com/docker/distribution/registry/client/errors.go new file mode 100644 index 0000000000..ebd1c36c4b --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/errors.go @@ -0,0 +1,69 @@ +package client + +import ( + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net/http" + + "github.com/docker/distribution/registry/api/errcode" + "github.com/docker/distribution/registry/api/v2" +) + +// UnexpectedHTTPStatusError is returned when an unexpected HTTP status is +// returned when making a registry api call. +type UnexpectedHTTPStatusError struct { + Status string +} + +func (e *UnexpectedHTTPStatusError) Error() string { + return fmt.Sprintf("Received unexpected HTTP status: %s", e.Status) +} + +// UnexpectedHTTPResponseError is returned when an expected HTTP status code +// is returned, but the content was unexpected and failed to be parsed. +type UnexpectedHTTPResponseError struct { + ParseErr error + Response []byte +} + +func (e *UnexpectedHTTPResponseError) Error() string { + return fmt.Sprintf("Error parsing HTTP response: %s: %q", e.ParseErr.Error(), string(e.Response)) +} + +func parseHTTPErrorResponse(r io.Reader) error { + var errors errcode.Errors + body, err := ioutil.ReadAll(r) + if err != nil { + return err + } + + if err := json.Unmarshal(body, &errors); err != nil { + return &UnexpectedHTTPResponseError{ + ParseErr: err, + Response: body, + } + } + return errors +} + +func handleErrorResponse(resp *http.Response) error { + if resp.StatusCode == 401 { + err := parseHTTPErrorResponse(resp.Body) + if uErr, ok := err.(*UnexpectedHTTPResponseError); ok { + return v2.ErrorCodeUnauthorized.WithDetail(uErr.Response) + } + return err + } + if resp.StatusCode >= 400 && resp.StatusCode < 500 { + return parseHTTPErrorResponse(resp.Body) + } + return &UnexpectedHTTPStatusError{Status: resp.Status} +} + +// SuccessStatus returns true if the argument is a successful HTTP response +// code (in the range 200 - 399 inclusive). +func SuccessStatus(status int) bool { + return status >= 200 && status <= 399 +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/repository.go b/vendor/src/github.com/docker/distribution/registry/client/repository.go new file mode 100644 index 0000000000..9170af86a1 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/repository.go @@ -0,0 +1,547 @@ +package client + +import ( + "bytes" + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net/http" + "net/url" + "strconv" + "time" + + "github.com/docker/distribution" + "github.com/docker/distribution/context" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" + "github.com/docker/distribution/registry/api/v2" + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/distribution/registry/storage/cache" + "github.com/docker/distribution/registry/storage/cache/memory" +) + +// Registry provides an interface for calling Repositories, which returns a catalog of repositories. +type Registry interface { + Repositories(ctx context.Context, repos []string, last string) (n int, err error) +} + +// NewRegistry creates a registry namespace which can be used to get a listing of repositories +func NewRegistry(ctx context.Context, baseURL string, transport http.RoundTripper) (Registry, error) { + ub, err := v2.NewURLBuilderFromString(baseURL) + if err != nil { + return nil, err + } + + client := &http.Client{ + Transport: transport, + Timeout: 1 * time.Minute, + } + + return ®istry{ + client: client, + ub: ub, + context: ctx, + }, nil +} + +type registry struct { + client *http.Client + ub *v2.URLBuilder + context context.Context +} + +// Repositories returns a lexigraphically sorted catalog given a base URL. The 'entries' slice will be filled up to the size +// of the slice, starting at the value provided in 'last'. The number of entries will be returned along with io.EOF if there +// are no more entries +func (r *registry) Repositories(ctx context.Context, entries []string, last string) (int, error) { + var numFilled int + var returnErr error + + values := buildCatalogValues(len(entries), last) + u, err := r.ub.BuildCatalogURL(values) + if err != nil { + return 0, err + } + + resp, err := r.client.Get(u) + if err != nil { + return 0, err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + var ctlg struct { + Repositories []string `json:"repositories"` + } + decoder := json.NewDecoder(resp.Body) + + if err := decoder.Decode(&ctlg); err != nil { + return 0, err + } + + for cnt := range ctlg.Repositories { + entries[cnt] = ctlg.Repositories[cnt] + } + numFilled = len(ctlg.Repositories) + + link := resp.Header.Get("Link") + if link == "" { + returnErr = io.EOF + } + } else { + return 0, handleErrorResponse(resp) + } + + return numFilled, returnErr +} + +// NewRepository creates a new Repository for the given repository name and base URL +func NewRepository(ctx context.Context, name, baseURL string, transport http.RoundTripper) (distribution.Repository, error) { + if err := v2.ValidateRepositoryName(name); err != nil { + return nil, err + } + + ub, err := v2.NewURLBuilderFromString(baseURL) + if err != nil { + return nil, err + } + + client := &http.Client{ + Transport: transport, + // TODO(dmcgowan): create cookie jar + } + + return &repository{ + client: client, + ub: ub, + name: name, + context: ctx, + }, nil +} + +type repository struct { + client *http.Client + ub *v2.URLBuilder + context context.Context + name string +} + +func (r *repository) Name() string { + return r.name +} + +func (r *repository) Blobs(ctx context.Context) distribution.BlobStore { + statter := &blobStatter{ + name: r.Name(), + ub: r.ub, + client: r.client, + } + return &blobs{ + name: r.Name(), + ub: r.ub, + client: r.client, + statter: cache.NewCachedBlobStatter(memory.NewInMemoryBlobDescriptorCacheProvider(), statter), + } +} + +func (r *repository) Manifests(ctx context.Context, options ...distribution.ManifestServiceOption) (distribution.ManifestService, error) { + // todo(richardscothern): options should be sent over the wire + return &manifests{ + name: r.Name(), + ub: r.ub, + client: r.client, + etags: make(map[string]string), + }, nil +} + +func (r *repository) Signatures() distribution.SignatureService { + ms, _ := r.Manifests(r.context) + return &signatures{ + manifests: ms, + } +} + +type signatures struct { + manifests distribution.ManifestService +} + +func (s *signatures) Get(dgst digest.Digest) ([][]byte, error) { + m, err := s.manifests.Get(dgst) + if err != nil { + return nil, err + } + return m.Signatures() +} + +func (s *signatures) Put(dgst digest.Digest, signatures ...[]byte) error { + panic("not implemented") +} + +type manifests struct { + name string + ub *v2.URLBuilder + client *http.Client + etags map[string]string +} + +func (ms *manifests) Tags() ([]string, error) { + u, err := ms.ub.BuildTagsURL(ms.name) + if err != nil { + return nil, err + } + + resp, err := ms.client.Get(u) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + b, err := ioutil.ReadAll(resp.Body) + if err != nil { + return nil, err + } + + tagsResponse := struct { + Tags []string `json:"tags"` + }{} + if err := json.Unmarshal(b, &tagsResponse); err != nil { + return nil, err + } + + return tagsResponse.Tags, nil + } else if resp.StatusCode == http.StatusNotFound { + return nil, nil + } + return nil, handleErrorResponse(resp) +} + +func (ms *manifests) Exists(dgst digest.Digest) (bool, error) { + // Call by Tag endpoint since the API uses the same + // URL endpoint for tags and digests. + return ms.ExistsByTag(dgst.String()) +} + +func (ms *manifests) ExistsByTag(tag string) (bool, error) { + u, err := ms.ub.BuildManifestURL(ms.name, tag) + if err != nil { + return false, err + } + + resp, err := ms.client.Head(u) + if err != nil { + return false, err + } + + if SuccessStatus(resp.StatusCode) { + return true, nil + } else if resp.StatusCode == http.StatusNotFound { + return false, nil + } + return false, handleErrorResponse(resp) +} + +func (ms *manifests) Get(dgst digest.Digest) (*manifest.SignedManifest, error) { + // Call by Tag endpoint since the API uses the same + // URL endpoint for tags and digests. + return ms.GetByTag(dgst.String()) +} + +// AddEtagToTag allows a client to supply an eTag to GetByTag which will be +// used for a conditional HTTP request. If the eTag matches, a nil manifest +// and nil error will be returned. etag is automatically quoted when added to +// this map. +func AddEtagToTag(tag, etag string) distribution.ManifestServiceOption { + return func(ms distribution.ManifestService) error { + if ms, ok := ms.(*manifests); ok { + ms.etags[tag] = fmt.Sprintf(`"%s"`, etag) + return nil + } + return fmt.Errorf("etag options is a client-only option") + } +} + +func (ms *manifests) GetByTag(tag string, options ...distribution.ManifestServiceOption) (*manifest.SignedManifest, error) { + for _, option := range options { + err := option(ms) + if err != nil { + return nil, err + } + } + + u, err := ms.ub.BuildManifestURL(ms.name, tag) + if err != nil { + return nil, err + } + req, err := http.NewRequest("GET", u, nil) + if err != nil { + return nil, err + } + + if _, ok := ms.etags[tag]; ok { + req.Header.Set("eTag", ms.etags[tag]) + } + resp, err := ms.client.Do(req) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + if resp.StatusCode == http.StatusNotModified { + return nil, nil + } else if SuccessStatus(resp.StatusCode) { + var sm manifest.SignedManifest + decoder := json.NewDecoder(resp.Body) + + if err := decoder.Decode(&sm); err != nil { + return nil, err + } + return &sm, nil + } + return nil, handleErrorResponse(resp) +} + +func (ms *manifests) Put(m *manifest.SignedManifest) error { + manifestURL, err := ms.ub.BuildManifestURL(ms.name, m.Tag) + if err != nil { + return err + } + + // todo(richardscothern): do something with options here when they become applicable + + putRequest, err := http.NewRequest("PUT", manifestURL, bytes.NewReader(m.Raw)) + if err != nil { + return err + } + + resp, err := ms.client.Do(putRequest) + if err != nil { + return err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + // TODO(dmcgowan): make use of digest header + return nil + } + return handleErrorResponse(resp) +} + +func (ms *manifests) Delete(dgst digest.Digest) error { + u, err := ms.ub.BuildManifestURL(ms.name, dgst.String()) + if err != nil { + return err + } + req, err := http.NewRequest("DELETE", u, nil) + if err != nil { + return err + } + + resp, err := ms.client.Do(req) + if err != nil { + return err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + return nil + } + return handleErrorResponse(resp) +} + +type blobs struct { + name string + ub *v2.URLBuilder + client *http.Client + + statter distribution.BlobDescriptorService + distribution.BlobDeleter +} + +func sanitizeLocation(location, base string) (string, error) { + baseURL, err := url.Parse(base) + if err != nil { + return "", err + } + + locationURL, err := url.Parse(location) + if err != nil { + return "", err + } + + return baseURL.ResolveReference(locationURL).String(), nil +} + +func (bs *blobs) Stat(ctx context.Context, dgst digest.Digest) (distribution.Descriptor, error) { + return bs.statter.Stat(ctx, dgst) + +} + +func (bs *blobs) Get(ctx context.Context, dgst digest.Digest) ([]byte, error) { + desc, err := bs.Stat(ctx, dgst) + if err != nil { + return nil, err + } + reader, err := bs.Open(ctx, desc.Digest) + if err != nil { + return nil, err + } + defer reader.Close() + + return ioutil.ReadAll(reader) +} + +func (bs *blobs) Open(ctx context.Context, dgst digest.Digest) (distribution.ReadSeekCloser, error) { + stat, err := bs.statter.Stat(ctx, dgst) + if err != nil { + return nil, err + } + + blobURL, err := bs.ub.BuildBlobURL(bs.name, stat.Digest) + if err != nil { + return nil, err + } + + return transport.NewHTTPReadSeeker(bs.client, blobURL, stat.Size), nil +} + +func (bs *blobs) ServeBlob(ctx context.Context, w http.ResponseWriter, r *http.Request, dgst digest.Digest) error { + panic("not implemented") +} + +func (bs *blobs) Put(ctx context.Context, mediaType string, p []byte) (distribution.Descriptor, error) { + writer, err := bs.Create(ctx) + if err != nil { + return distribution.Descriptor{}, err + } + dgstr := digest.Canonical.New() + n, err := io.Copy(writer, io.TeeReader(bytes.NewReader(p), dgstr.Hash())) + if err != nil { + return distribution.Descriptor{}, err + } + if n < int64(len(p)) { + return distribution.Descriptor{}, fmt.Errorf("short copy: wrote %d of %d", n, len(p)) + } + + desc := distribution.Descriptor{ + MediaType: mediaType, + Size: int64(len(p)), + Digest: dgstr.Digest(), + } + + return writer.Commit(ctx, desc) +} + +func (bs *blobs) Create(ctx context.Context) (distribution.BlobWriter, error) { + u, err := bs.ub.BuildBlobUploadURL(bs.name) + + resp, err := bs.client.Post(u, "", nil) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + // TODO(dmcgowan): Check for invalid UUID + uuid := resp.Header.Get("Docker-Upload-UUID") + location, err := sanitizeLocation(resp.Header.Get("Location"), u) + if err != nil { + return nil, err + } + + return &httpBlobUpload{ + statter: bs.statter, + client: bs.client, + uuid: uuid, + startedAt: time.Now(), + location: location, + }, nil + } + return nil, handleErrorResponse(resp) +} + +func (bs *blobs) Resume(ctx context.Context, id string) (distribution.BlobWriter, error) { + panic("not implemented") +} + +func (bs *blobs) Delete(ctx context.Context, dgst digest.Digest) error { + return bs.statter.Clear(ctx, dgst) +} + +type blobStatter struct { + name string + ub *v2.URLBuilder + client *http.Client +} + +func (bs *blobStatter) Stat(ctx context.Context, dgst digest.Digest) (distribution.Descriptor, error) { + u, err := bs.ub.BuildBlobURL(bs.name, dgst) + if err != nil { + return distribution.Descriptor{}, err + } + + resp, err := bs.client.Head(u) + if err != nil { + return distribution.Descriptor{}, err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + lengthHeader := resp.Header.Get("Content-Length") + length, err := strconv.ParseInt(lengthHeader, 10, 64) + if err != nil { + return distribution.Descriptor{}, fmt.Errorf("error parsing content-length: %v", err) + } + + return distribution.Descriptor{ + MediaType: resp.Header.Get("Content-Type"), + Size: length, + Digest: dgst, + }, nil + } else if resp.StatusCode == http.StatusNotFound { + return distribution.Descriptor{}, distribution.ErrBlobUnknown + } + return distribution.Descriptor{}, handleErrorResponse(resp) +} + +func buildCatalogValues(maxEntries int, last string) url.Values { + values := url.Values{} + + if maxEntries > 0 { + values.Add("n", strconv.Itoa(maxEntries)) + } + + if last != "" { + values.Add("last", last) + } + + return values +} + +func (bs *blobStatter) Clear(ctx context.Context, dgst digest.Digest) error { + blobURL, err := bs.ub.BuildBlobURL(bs.name, dgst) + if err != nil { + return err + } + + req, err := http.NewRequest("DELETE", blobURL, nil) + if err != nil { + return err + } + + resp, err := bs.client.Do(req) + if err != nil { + return err + } + defer resp.Body.Close() + + if SuccessStatus(resp.StatusCode) { + return nil + } + return handleErrorResponse(resp) +} + +func (bs *blobStatter) SetDescriptor(ctx context.Context, dgst digest.Digest, desc distribution.Descriptor) error { + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/transport/http_reader.go b/vendor/src/github.com/docker/distribution/registry/client/transport/http_reader.go new file mode 100644 index 0000000000..b2e74ddb85 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/transport/http_reader.go @@ -0,0 +1,173 @@ +package transport + +import ( + "bufio" + "bytes" + "errors" + "fmt" + "io" + "io/ioutil" + "net/http" + "os" +) + +// ReadSeekCloser combines io.ReadSeeker with io.Closer. +type ReadSeekCloser interface { + io.ReadSeeker + io.Closer +} + +// NewHTTPReadSeeker handles reading from an HTTP endpoint using a GET +// request. When seeking and starting a read from a non-zero offset +// the a "Range" header will be added which sets the offset. +// TODO(dmcgowan): Move this into a separate utility package +func NewHTTPReadSeeker(client *http.Client, url string, size int64) ReadSeekCloser { + return &httpReadSeeker{ + client: client, + url: url, + size: size, + } +} + +type httpReadSeeker struct { + client *http.Client + url string + + size int64 + + rc io.ReadCloser // remote read closer + brd *bufio.Reader // internal buffered io + offset int64 + err error +} + +func (hrs *httpReadSeeker) Read(p []byte) (n int, err error) { + if hrs.err != nil { + return 0, hrs.err + } + + rd, err := hrs.reader() + if err != nil { + return 0, err + } + + n, err = rd.Read(p) + hrs.offset += int64(n) + + // Simulate io.EOF error if we reach filesize. + if err == nil && hrs.offset >= hrs.size { + err = io.EOF + } + + return n, err +} + +func (hrs *httpReadSeeker) Seek(offset int64, whence int) (int64, error) { + if hrs.err != nil { + return 0, hrs.err + } + + var err error + newOffset := hrs.offset + + switch whence { + case os.SEEK_CUR: + newOffset += int64(offset) + case os.SEEK_END: + newOffset = hrs.size + int64(offset) + case os.SEEK_SET: + newOffset = int64(offset) + } + + if newOffset < 0 { + err = errors.New("cannot seek to negative position") + } else { + if hrs.offset != newOffset { + hrs.reset() + } + + // No problems, set the offset. + hrs.offset = newOffset + } + + return hrs.offset, err +} + +func (hrs *httpReadSeeker) Close() error { + if hrs.err != nil { + return hrs.err + } + + // close and release reader chain + if hrs.rc != nil { + hrs.rc.Close() + } + + hrs.rc = nil + hrs.brd = nil + + hrs.err = errors.New("httpLayer: closed") + + return nil +} + +func (hrs *httpReadSeeker) reset() { + if hrs.err != nil { + return + } + if hrs.rc != nil { + hrs.rc.Close() + hrs.rc = nil + } +} + +func (hrs *httpReadSeeker) reader() (io.Reader, error) { + if hrs.err != nil { + return nil, hrs.err + } + + if hrs.rc != nil { + return hrs.brd, nil + } + + // If the offset is great than or equal to size, return a empty, noop reader. + if hrs.offset >= hrs.size { + return ioutil.NopCloser(bytes.NewReader([]byte{})), nil + } + + req, err := http.NewRequest("GET", hrs.url, nil) + if err != nil { + return nil, err + } + + if hrs.offset > 0 { + // TODO(stevvooe): Get this working correctly. + + // If we are at different offset, issue a range request from there. + req.Header.Add("Range", "1-") + // TODO: get context in here + // context.GetLogger(hrs.context).Infof("Range: %s", req.Header.Get("Range")) + } + + resp, err := hrs.client.Do(req) + if err != nil { + return nil, err + } + + // Normally would use client.SuccessStatus, but that would be a cyclic + // import + if resp.StatusCode >= 200 && resp.StatusCode <= 399 { + hrs.rc = resp.Body + } else { + defer resp.Body.Close() + return nil, fmt.Errorf("unexpected status resolving reader: %v", resp.Status) + } + + if hrs.brd == nil { + hrs.brd = bufio.NewReader(hrs.rc) + } else { + hrs.brd.Reset(hrs.rc) + } + + return hrs.brd, nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/client/transport/transport.go b/vendor/src/github.com/docker/distribution/registry/client/transport/transport.go new file mode 100644 index 0000000000..30e45fab0f --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/client/transport/transport.go @@ -0,0 +1,147 @@ +package transport + +import ( + "io" + "net/http" + "sync" +) + +// RequestModifier represents an object which will do an inplace +// modification of an HTTP request. +type RequestModifier interface { + ModifyRequest(*http.Request) error +} + +type headerModifier http.Header + +// NewHeaderRequestModifier returns a new RequestModifier which will +// add the given headers to a request. +func NewHeaderRequestModifier(header http.Header) RequestModifier { + return headerModifier(header) +} + +func (h headerModifier) ModifyRequest(req *http.Request) error { + for k, s := range http.Header(h) { + req.Header[k] = append(req.Header[k], s...) + } + + return nil +} + +// NewTransport creates a new transport which will apply modifiers to +// the request on a RoundTrip call. +func NewTransport(base http.RoundTripper, modifiers ...RequestModifier) http.RoundTripper { + return &transport{ + Modifiers: modifiers, + Base: base, + } +} + +// transport is an http.RoundTripper that makes HTTP requests after +// copying and modifying the request +type transport struct { + Modifiers []RequestModifier + Base http.RoundTripper + + mu sync.Mutex // guards modReq + modReq map[*http.Request]*http.Request // original -> modified +} + +// RoundTrip authorizes and authenticates the request with an +// access token. If no token exists or token is expired, +// tries to refresh/fetch a new token. +func (t *transport) RoundTrip(req *http.Request) (*http.Response, error) { + req2 := cloneRequest(req) + for _, modifier := range t.Modifiers { + if err := modifier.ModifyRequest(req2); err != nil { + return nil, err + } + } + + t.setModReq(req, req2) + res, err := t.base().RoundTrip(req2) + if err != nil { + t.setModReq(req, nil) + return nil, err + } + res.Body = &onEOFReader{ + rc: res.Body, + fn: func() { t.setModReq(req, nil) }, + } + return res, nil +} + +// CancelRequest cancels an in-flight request by closing its connection. +func (t *transport) CancelRequest(req *http.Request) { + type canceler interface { + CancelRequest(*http.Request) + } + if cr, ok := t.base().(canceler); ok { + t.mu.Lock() + modReq := t.modReq[req] + delete(t.modReq, req) + t.mu.Unlock() + cr.CancelRequest(modReq) + } +} + +func (t *transport) base() http.RoundTripper { + if t.Base != nil { + return t.Base + } + return http.DefaultTransport +} + +func (t *transport) setModReq(orig, mod *http.Request) { + t.mu.Lock() + defer t.mu.Unlock() + if t.modReq == nil { + t.modReq = make(map[*http.Request]*http.Request) + } + if mod == nil { + delete(t.modReq, orig) + } else { + t.modReq[orig] = mod + } +} + +// cloneRequest returns a clone of the provided *http.Request. +// The clone is a shallow copy of the struct and its Header map. +func cloneRequest(r *http.Request) *http.Request { + // shallow copy of the struct + r2 := new(http.Request) + *r2 = *r + // deep copy of the Header + r2.Header = make(http.Header, len(r.Header)) + for k, s := range r.Header { + r2.Header[k] = append([]string(nil), s...) + } + + return r2 +} + +type onEOFReader struct { + rc io.ReadCloser + fn func() +} + +func (r *onEOFReader) Read(p []byte) (n int, err error) { + n, err = r.rc.Read(p) + if err == io.EOF { + r.runFunc() + } + return +} + +func (r *onEOFReader) Close() error { + err := r.rc.Close() + r.runFunc() + return err +} + +func (r *onEOFReader) runFunc() { + if fn := r.fn; fn != nil { + fn() + r.fn = nil + } +} diff --git a/vendor/src/github.com/docker/distribution/registry/storage/cache/cache.go b/vendor/src/github.com/docker/distribution/registry/storage/cache/cache.go new file mode 100644 index 0000000000..10a3909197 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/storage/cache/cache.go @@ -0,0 +1,35 @@ +// Package cache provides facilities to speed up access to the storage +// backend. +package cache + +import ( + "fmt" + + "github.com/docker/distribution" +) + +// BlobDescriptorCacheProvider provides repository scoped +// BlobDescriptorService cache instances and a global descriptor cache. +type BlobDescriptorCacheProvider interface { + distribution.BlobDescriptorService + + RepositoryScoped(repo string) (distribution.BlobDescriptorService, error) +} + +// ValidateDescriptor provides a helper function to ensure that caches have +// common criteria for admitting descriptors. +func ValidateDescriptor(desc distribution.Descriptor) error { + if err := desc.Digest.Validate(); err != nil { + return err + } + + if desc.Size < 0 { + return fmt.Errorf("cache: invalid length in descriptor: %v < 0", desc.Size) + } + + if desc.MediaType == "" { + return fmt.Errorf("cache: empty mediatype on descriptor: %v", desc) + } + + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/storage/cache/cachedblobdescriptorstore.go b/vendor/src/github.com/docker/distribution/registry/storage/cache/cachedblobdescriptorstore.go new file mode 100644 index 0000000000..94ca8a90c7 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/storage/cache/cachedblobdescriptorstore.go @@ -0,0 +1,101 @@ +package cache + +import ( + "github.com/docker/distribution/context" + "github.com/docker/distribution/digest" + + "github.com/docker/distribution" +) + +// Metrics is used to hold metric counters +// related to the number of times a cache was +// hit or missed. +type Metrics struct { + Requests uint64 + Hits uint64 + Misses uint64 +} + +// MetricsTracker represents a metric tracker +// which simply counts the number of hits and misses. +type MetricsTracker interface { + Hit() + Miss() + Metrics() Metrics +} + +type cachedBlobStatter struct { + cache distribution.BlobDescriptorService + backend distribution.BlobDescriptorService + tracker MetricsTracker +} + +// NewCachedBlobStatter creates a new statter which prefers a cache and +// falls back to a backend. +func NewCachedBlobStatter(cache distribution.BlobDescriptorService, backend distribution.BlobDescriptorService) distribution.BlobDescriptorService { + return &cachedBlobStatter{ + cache: cache, + backend: backend, + } +} + +// NewCachedBlobStatterWithMetrics creates a new statter which prefers a cache and +// falls back to a backend. Hits and misses will send to the tracker. +func NewCachedBlobStatterWithMetrics(cache distribution.BlobDescriptorService, backend distribution.BlobDescriptorService, tracker MetricsTracker) distribution.BlobStatter { + return &cachedBlobStatter{ + cache: cache, + backend: backend, + tracker: tracker, + } +} + +func (cbds *cachedBlobStatter) Stat(ctx context.Context, dgst digest.Digest) (distribution.Descriptor, error) { + desc, err := cbds.cache.Stat(ctx, dgst) + if err != nil { + if err != distribution.ErrBlobUnknown { + context.GetLogger(ctx).Errorf("error retrieving descriptor from cache: %v", err) + } + + goto fallback + } + + if cbds.tracker != nil { + cbds.tracker.Hit() + } + return desc, nil +fallback: + if cbds.tracker != nil { + cbds.tracker.Miss() + } + desc, err = cbds.backend.Stat(ctx, dgst) + if err != nil { + return desc, err + } + + if err := cbds.cache.SetDescriptor(ctx, dgst, desc); err != nil { + context.GetLogger(ctx).Errorf("error adding descriptor %v to cache: %v", desc.Digest, err) + } + + return desc, err + +} + +func (cbds *cachedBlobStatter) Clear(ctx context.Context, dgst digest.Digest) error { + err := cbds.cache.Clear(ctx, dgst) + if err != nil { + return err + } + + err = cbds.backend.Clear(ctx, dgst) + if err != nil { + return err + } + return nil +} + +func (cbds *cachedBlobStatter) SetDescriptor(ctx context.Context, dgst digest.Digest, desc distribution.Descriptor) error { + if err := cbds.cache.SetDescriptor(ctx, dgst, desc); err != nil { + context.GetLogger(ctx).Errorf("error adding descriptor %v to cache: %v", desc.Digest, err) + } + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/storage/cache/memory/memory.go b/vendor/src/github.com/docker/distribution/registry/storage/cache/memory/memory.go new file mode 100644 index 0000000000..120a6572d4 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/storage/cache/memory/memory.go @@ -0,0 +1,170 @@ +package memory + +import ( + "sync" + + "github.com/docker/distribution" + "github.com/docker/distribution/context" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/registry/api/v2" + "github.com/docker/distribution/registry/storage/cache" +) + +type inMemoryBlobDescriptorCacheProvider struct { + global *mapBlobDescriptorCache + repositories map[string]*mapBlobDescriptorCache + mu sync.RWMutex +} + +// NewInMemoryBlobDescriptorCacheProvider returns a new mapped-based cache for +// storing blob descriptor data. +func NewInMemoryBlobDescriptorCacheProvider() cache.BlobDescriptorCacheProvider { + return &inMemoryBlobDescriptorCacheProvider{ + global: newMapBlobDescriptorCache(), + repositories: make(map[string]*mapBlobDescriptorCache), + } +} + +func (imbdcp *inMemoryBlobDescriptorCacheProvider) RepositoryScoped(repo string) (distribution.BlobDescriptorService, error) { + if err := v2.ValidateRepositoryName(repo); err != nil { + return nil, err + } + + imbdcp.mu.RLock() + defer imbdcp.mu.RUnlock() + + return &repositoryScopedInMemoryBlobDescriptorCache{ + repo: repo, + parent: imbdcp, + repository: imbdcp.repositories[repo], + }, nil +} + +func (imbdcp *inMemoryBlobDescriptorCacheProvider) Stat(ctx context.Context, dgst digest.Digest) (distribution.Descriptor, error) { + return imbdcp.global.Stat(ctx, dgst) +} + +func (imbdcp *inMemoryBlobDescriptorCacheProvider) Clear(ctx context.Context, dgst digest.Digest) error { + return imbdcp.global.Clear(ctx, dgst) +} + +func (imbdcp *inMemoryBlobDescriptorCacheProvider) SetDescriptor(ctx context.Context, dgst digest.Digest, desc distribution.Descriptor) error { + _, err := imbdcp.Stat(ctx, dgst) + if err == distribution.ErrBlobUnknown { + + if dgst.Algorithm() != desc.Digest.Algorithm() && dgst != desc.Digest { + // if the digests differ, set the other canonical mapping + if err := imbdcp.global.SetDescriptor(ctx, desc.Digest, desc); err != nil { + return err + } + } + + // unknown, just set it + return imbdcp.global.SetDescriptor(ctx, dgst, desc) + } + + // we already know it, do nothing + return err +} + +// repositoryScopedInMemoryBlobDescriptorCache provides the request scoped +// repository cache. Instances are not thread-safe but the delegated +// operations are. +type repositoryScopedInMemoryBlobDescriptorCache struct { + repo string + parent *inMemoryBlobDescriptorCacheProvider // allows lazy allocation of repo's map + repository *mapBlobDescriptorCache +} + +func (rsimbdcp *repositoryScopedInMemoryBlobDescriptorCache) Stat(ctx context.Context, dgst digest.Digest) (distribution.Descriptor, error) { + if rsimbdcp.repository == nil { + return distribution.Descriptor{}, distribution.ErrBlobUnknown + } + + return rsimbdcp.repository.Stat(ctx, dgst) +} + +func (rsimbdcp *repositoryScopedInMemoryBlobDescriptorCache) Clear(ctx context.Context, dgst digest.Digest) error { + if rsimbdcp.repository == nil { + return distribution.ErrBlobUnknown + } + + return rsimbdcp.repository.Clear(ctx, dgst) +} + +func (rsimbdcp *repositoryScopedInMemoryBlobDescriptorCache) SetDescriptor(ctx context.Context, dgst digest.Digest, desc distribution.Descriptor) error { + if rsimbdcp.repository == nil { + // allocate map since we are setting it now. + rsimbdcp.parent.mu.Lock() + var ok bool + // have to read back value since we may have allocated elsewhere. + rsimbdcp.repository, ok = rsimbdcp.parent.repositories[rsimbdcp.repo] + if !ok { + rsimbdcp.repository = newMapBlobDescriptorCache() + rsimbdcp.parent.repositories[rsimbdcp.repo] = rsimbdcp.repository + } + + rsimbdcp.parent.mu.Unlock() + } + + if err := rsimbdcp.repository.SetDescriptor(ctx, dgst, desc); err != nil { + return err + } + + return rsimbdcp.parent.SetDescriptor(ctx, dgst, desc) +} + +// mapBlobDescriptorCache provides a simple map-based implementation of the +// descriptor cache. +type mapBlobDescriptorCache struct { + descriptors map[digest.Digest]distribution.Descriptor + mu sync.RWMutex +} + +var _ distribution.BlobDescriptorService = &mapBlobDescriptorCache{} + +func newMapBlobDescriptorCache() *mapBlobDescriptorCache { + return &mapBlobDescriptorCache{ + descriptors: make(map[digest.Digest]distribution.Descriptor), + } +} + +func (mbdc *mapBlobDescriptorCache) Stat(ctx context.Context, dgst digest.Digest) (distribution.Descriptor, error) { + if err := dgst.Validate(); err != nil { + return distribution.Descriptor{}, err + } + + mbdc.mu.RLock() + defer mbdc.mu.RUnlock() + + desc, ok := mbdc.descriptors[dgst] + if !ok { + return distribution.Descriptor{}, distribution.ErrBlobUnknown + } + + return desc, nil +} + +func (mbdc *mapBlobDescriptorCache) Clear(ctx context.Context, dgst digest.Digest) error { + mbdc.mu.Lock() + defer mbdc.mu.Unlock() + + delete(mbdc.descriptors, dgst) + return nil +} + +func (mbdc *mapBlobDescriptorCache) SetDescriptor(ctx context.Context, dgst digest.Digest, desc distribution.Descriptor) error { + if err := dgst.Validate(); err != nil { + return err + } + + if err := cache.ValidateDescriptor(desc); err != nil { + return err + } + + mbdc.mu.Lock() + defer mbdc.mu.Unlock() + + mbdc.descriptors[dgst] = desc + return nil +} diff --git a/vendor/src/github.com/docker/distribution/registry/storage/cache/suite.go b/vendor/src/github.com/docker/distribution/registry/storage/cache/suite.go new file mode 100644 index 0000000000..b5a2f64317 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/registry/storage/cache/suite.go @@ -0,0 +1,178 @@ +package cache + +import ( + "testing" + + "github.com/docker/distribution" + "github.com/docker/distribution/context" + "github.com/docker/distribution/digest" +) + +// CheckBlobDescriptorCache takes a cache implementation through a common set +// of operations. If adding new tests, please add them here so new +// implementations get the benefit. This should be used for unit tests. +func CheckBlobDescriptorCache(t *testing.T, provider BlobDescriptorCacheProvider) { + ctx := context.Background() + + checkBlobDescriptorCacheEmptyRepository(t, ctx, provider) + checkBlobDescriptorCacheSetAndRead(t, ctx, provider) +} + +func checkBlobDescriptorCacheEmptyRepository(t *testing.T, ctx context.Context, provider BlobDescriptorCacheProvider) { + if _, err := provider.Stat(ctx, "sha384:abc"); err != distribution.ErrBlobUnknown { + t.Fatalf("expected unknown blob error with empty store: %v", err) + } + + cache, err := provider.RepositoryScoped("") + if err == nil { + t.Fatalf("expected an error when asking for invalid repo") + } + + cache, err = provider.RepositoryScoped("foo/bar") + if err != nil { + t.Fatalf("unexpected error getting repository: %v", err) + } + + if err := cache.SetDescriptor(ctx, "", distribution.Descriptor{ + Digest: "sha384:abc", + Size: 10, + MediaType: "application/octet-stream"}); err != digest.ErrDigestInvalidFormat { + t.Fatalf("expected error with invalid digest: %v", err) + } + + if err := cache.SetDescriptor(ctx, "sha384:abc", distribution.Descriptor{ + Digest: "", + Size: 10, + MediaType: "application/octet-stream"}); err == nil { + t.Fatalf("expected error setting value on invalid descriptor") + } + + if _, err := cache.Stat(ctx, ""); err != digest.ErrDigestInvalidFormat { + t.Fatalf("expected error checking for cache item with empty digest: %v", err) + } + + if _, err := cache.Stat(ctx, "sha384:abc"); err != distribution.ErrBlobUnknown { + t.Fatalf("expected unknown blob error with empty repo: %v", err) + } +} + +func checkBlobDescriptorCacheSetAndRead(t *testing.T, ctx context.Context, provider BlobDescriptorCacheProvider) { + localDigest := digest.Digest("sha384:abc") + expected := distribution.Descriptor{ + Digest: "sha256:abc", + Size: 10, + MediaType: "application/octet-stream"} + + cache, err := provider.RepositoryScoped("foo/bar") + if err != nil { + t.Fatalf("unexpected error getting scoped cache: %v", err) + } + + if err := cache.SetDescriptor(ctx, localDigest, expected); err != nil { + t.Fatalf("error setting descriptor: %v", err) + } + + desc, err := cache.Stat(ctx, localDigest) + if err != nil { + t.Fatalf("unexpected error statting fake2:abc: %v", err) + } + + if expected != desc { + t.Fatalf("unexpected descriptor: %#v != %#v", expected, desc) + } + + // also check that we set the canonical key ("fake:abc") + desc, err = cache.Stat(ctx, localDigest) + if err != nil { + t.Fatalf("descriptor not returned for canonical key: %v", err) + } + + if expected != desc { + t.Fatalf("unexpected descriptor: %#v != %#v", expected, desc) + } + + // ensure that global gets extra descriptor mapping + desc, err = provider.Stat(ctx, localDigest) + if err != nil { + t.Fatalf("expected blob unknown in global cache: %v, %v", err, desc) + } + + if desc != expected { + t.Fatalf("unexpected descriptor: %#v != %#v", expected, desc) + } + + // get at it through canonical descriptor + desc, err = provider.Stat(ctx, expected.Digest) + if err != nil { + t.Fatalf("unexpected error checking glboal descriptor: %v", err) + } + + if desc != expected { + t.Fatalf("unexpected descriptor: %#v != %#v", expected, desc) + } + + // now, we set the repo local mediatype to something else and ensure it + // doesn't get changed in the provider cache. + expected.MediaType = "application/json" + + if err := cache.SetDescriptor(ctx, localDigest, expected); err != nil { + t.Fatalf("unexpected error setting descriptor: %v", err) + } + + desc, err = cache.Stat(ctx, localDigest) + if err != nil { + t.Fatalf("unexpected error getting descriptor: %v", err) + } + + if desc != expected { + t.Fatalf("unexpected descriptor: %#v != %#v", desc, expected) + } + + desc, err = provider.Stat(ctx, localDigest) + if err != nil { + t.Fatalf("unexpected error getting global descriptor: %v", err) + } + + expected.MediaType = "application/octet-stream" // expect original mediatype in global + + if desc != expected { + t.Fatalf("unexpected descriptor: %#v != %#v", desc, expected) + } +} + +func checkBlobDescriptorClear(t *testing.T, ctx context.Context, provider BlobDescriptorCacheProvider) { + localDigest := digest.Digest("sha384:abc") + expected := distribution.Descriptor{ + Digest: "sha256:abc", + Size: 10, + MediaType: "application/octet-stream"} + + cache, err := provider.RepositoryScoped("foo/bar") + if err != nil { + t.Fatalf("unexpected error getting scoped cache: %v", err) + } + + if err := cache.SetDescriptor(ctx, localDigest, expected); err != nil { + t.Fatalf("error setting descriptor: %v", err) + } + + desc, err := cache.Stat(ctx, localDigest) + if err != nil { + t.Fatalf("unexpected error statting fake2:abc: %v", err) + } + + if expected != desc { + t.Fatalf("unexpected descriptor: %#v != %#v", expected, desc) + } + + err = cache.Clear(ctx, localDigest) + if err != nil { + t.Fatalf("unexpected error deleting descriptor") + } + + nonExistantDigest := digest.Digest("sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") + err = cache.Clear(ctx, nonExistantDigest) + if err == nil { + t.Fatalf("expected error deleting unknown descriptor") + } +} diff --git a/vendor/src/github.com/docker/distribution/uuid/uuid.go b/vendor/src/github.com/docker/distribution/uuid/uuid.go new file mode 100644 index 0000000000..d433ccaf51 --- /dev/null +++ b/vendor/src/github.com/docker/distribution/uuid/uuid.go @@ -0,0 +1,126 @@ +// Package uuid provides simple UUID generation. Only version 4 style UUIDs +// can be generated. +// +// Please see http://tools.ietf.org/html/rfc4122 for details on UUIDs. +package uuid + +import ( + "crypto/rand" + "fmt" + "io" + "os" + "syscall" + "time" +) + +const ( + // Bits is the number of bits in a UUID + Bits = 128 + + // Size is the number of bytes in a UUID + Size = Bits / 8 + + format = "%08x-%04x-%04x-%04x-%012x" +) + +var ( + // ErrUUIDInvalid indicates a parsed string is not a valid uuid. + ErrUUIDInvalid = fmt.Errorf("invalid uuid") + + // Loggerf can be used to override the default logging destination. Such + // log messages in this library should be logged at warning or higher. + Loggerf = func(format string, args ...interface{}) {} +) + +// UUID represents a UUID value. UUIDs can be compared and set to other values +// and accessed by byte. +type UUID [Size]byte + +// Generate creates a new, version 4 uuid. +func Generate() (u UUID) { + const ( + // ensures we backoff for less than 450ms total. Use the following to + // select new value, in units of 10ms: + // n*(n+1)/2 = d -> n^2 + n - 2d -> n = (sqrt(8d + 1) - 1)/2 + maxretries = 9 + backoff = time.Millisecond * 10 + ) + + var ( + totalBackoff time.Duration + count int + retries int + ) + + for { + // This should never block but the read may fail. Because of this, + // we just try to read the random number generator until we get + // something. This is a very rare condition but may happen. + b := time.Duration(retries) * backoff + time.Sleep(b) + totalBackoff += b + + n, err := io.ReadFull(rand.Reader, u[count:]) + if err != nil { + if retryOnError(err) && retries < maxretries { + count += n + retries++ + Loggerf("error generating version 4 uuid, retrying: %v", err) + continue + } + + // Any other errors represent a system problem. What did someone + // do to /dev/urandom? + panic(fmt.Errorf("error reading random number generator, retried for %v: %v", totalBackoff.String(), err)) + } + + break + } + + u[6] = (u[6] & 0x0f) | 0x40 // set version byte + u[8] = (u[8] & 0x3f) | 0x80 // set high order byte 0b10{8,9,a,b} + + return u +} + +// Parse attempts to extract a uuid from the string or returns an error. +func Parse(s string) (u UUID, err error) { + if len(s) != 36 { + return UUID{}, ErrUUIDInvalid + } + + // create stack addresses for each section of the uuid. + p := make([][]byte, 5) + + if _, err := fmt.Sscanf(s, format, &p[0], &p[1], &p[2], &p[3], &p[4]); err != nil { + return u, err + } + + copy(u[0:4], p[0]) + copy(u[4:6], p[1]) + copy(u[6:8], p[2]) + copy(u[8:10], p[3]) + copy(u[10:16], p[4]) + + return +} + +func (u UUID) String() string { + return fmt.Sprintf(format, u[:4], u[4:6], u[6:8], u[8:10], u[10:]) +} + +// retryOnError tries to detect whether or not retrying would be fruitful. +func retryOnError(err error) bool { + switch err := err.(type) { + case *os.PathError: + return retryOnError(err.Err) // unpack the target error + case syscall.Errno: + if err == syscall.EPERM { + // EPERM represents an entropy pool exhaustion, a condition under + // which we backoff and retry. + return true + } + } + + return false +} diff --git a/vendor/src/github.com/docker/libcontainer/cgroups/fs/freezer_test.go b/vendor/src/github.com/docker/libcontainer/cgroups/fs/freezer_test.go new file mode 100644 index 0000000000..9ff1886d26 --- /dev/null +++ b/vendor/src/github.com/docker/libcontainer/cgroups/fs/freezer_test.go @@ -0,0 +1,45 @@ +package fs + +import ( + "testing" + + "github.com/docker/libcontainer/configs" +) + +func TestFreezerSetState(t *testing.T) { + helper := NewCgroupTestUtil("freezer", t) + defer helper.cleanup() + + helper.writeFileContents(map[string]string{ + "freezer.state": string(configs.Frozen), + }) + + helper.CgroupData.c.Freezer = configs.Thawed + freezer := &FreezerGroup{} + if err := freezer.Set(helper.CgroupPath, helper.CgroupData.c); err != nil { + t.Fatal(err) + } + + value, err := getCgroupParamString(helper.CgroupPath, "freezer.state") + if err != nil { + t.Fatalf("Failed to parse freezer.state - %s", err) + } + if value != string(configs.Thawed) { + t.Fatal("Got the wrong value, set freezer.state failed.") + } +} + +func TestFreezerSetInvalidState(t *testing.T) { + helper := NewCgroupTestUtil("freezer", t) + defer helper.cleanup() + + const ( + invalidArg configs.FreezerState = "Invalid" + ) + + helper.CgroupData.c.Freezer = invalidArg + freezer := &FreezerGroup{} + if err := freezer.Set(helper.CgroupPath, helper.CgroupData.c); err == nil { + t.Fatal("Failed to return invalid argument error") + } +} diff --git a/vendor/src/github.com/docker/libcontainer/nsinit/README.md b/vendor/src/github.com/docker/libcontainer/nsinit/README.md new file mode 100644 index 0000000000..f2e66a866d --- /dev/null +++ b/vendor/src/github.com/docker/libcontainer/nsinit/README.md @@ -0,0 +1,67 @@ +## nsinit + +`nsinit` is a cli application which demonstrates the use of libcontainer. +It is able to spawn new containers or join existing containers. + +### How to build? + +First add the `libcontainer/vendor` into your GOPATH. It's because libcontainer +vendors all its dependencies, so it can be built predictably. + +``` +export GOPATH=$GOPATH:/your/path/to/libcontainer/vendor +``` + +Then get into the nsinit folder and get the imported file. Use `make` command +to make the nsinit binary. + +``` +cd libcontainer/nsinit +go get +make +``` + +We have finished compiling the nsinit package, but a root filesystem must be +provided for use along with a container configuration file. + +Choose a proper place to run your container. For example we use `/busybox`. + +``` +mkdir /busybox +curl -sSL 'https://github.com/jpetazzo/docker-busybox/raw/buildroot-2014.11/rootfs.tar' | tar -xC /busybox +``` + +Then you may need to write a configuration file named `container.json` in the +`/busybox` folder. Environment, networking, and different capabilities for +the container are specified in this file. The configuration is used for each +process executed inside the container. + +See the `sample_configs` folder for examples of what the container configuration +should look like. + +``` +cp libcontainer/sample_configs/minimal.json /busybox/container.json +cd /busybox +``` + +You can customize `container.json` per your needs. After that, nsinit is +ready to work. + +To execute `/bin/bash` in the current directory as a container just run the +following **as root**: + +```bash +nsinit exec --tty --config container.json /bin/bash +``` + +If you wish to spawn another process inside the container while your current +bash session is running, run the same command again to get another bash shell +(or change the command). If the original process (PID 1) dies, all other +processes spawned inside the container will be killed and the namespace will +be removed. + +You can identify if a process is running in a container by looking to see if +`state.json` is in the root of the directory. + +You may also specify an alternate root directory from where the `container.json` +file is read and where the `state.json` file will be saved. diff --git a/vendor/src/github.com/docker/libcontainer/rootfs_linux_test.go b/vendor/src/github.com/docker/libcontainer/rootfs_linux_test.go new file mode 100644 index 0000000000..a3bb07708b --- /dev/null +++ b/vendor/src/github.com/docker/libcontainer/rootfs_linux_test.go @@ -0,0 +1,37 @@ +// +build linux + +package libcontainer + +import "testing" + +func TestCheckMountDestOnProc(t *testing.T) { + dest := "/rootfs/proc/" + err := checkMountDestination("/rootfs", dest) + if err == nil { + t.Fatal("destination inside proc should return an error") + } +} + +func TestCheckMountDestInSys(t *testing.T) { + dest := "/rootfs//sys/fs/cgroup" + err := checkMountDestination("/rootfs", dest) + if err != nil { + t.Fatal("destination inside /sys should not return an error") + } +} + +func TestCheckMountDestFalsePositive(t *testing.T) { + dest := "/rootfs/sysfiles/fs/cgroup" + err := checkMountDestination("/rootfs", dest) + if err != nil { + t.Fatal(err) + } +} + +func TestCheckMountRoot(t *testing.T) { + dest := "/rootfs" + err := checkMountDestination("/rootfs", dest) + if err == nil { + t.Fatal(err) + } +} diff --git a/vendor/src/github.com/docker/libkv/.travis.yml b/vendor/src/github.com/docker/libkv/.travis.yml new file mode 100644 index 0000000000..a9ef7c82bf --- /dev/null +++ b/vendor/src/github.com/docker/libkv/.travis.yml @@ -0,0 +1,34 @@ +language: go + +go: + - 1.3 +# - 1.4 +# see https://github.com/moovweb/gvm/pull/116 for why Go 1.4 is currently disabled + +# let us have speedy Docker-based Travis workers +sudo: false + +before_install: + # Symlink below is needed for Travis CI to work correctly on personal forks of libkv + - ln -s $HOME/gopath/src/github.com/${TRAVIS_REPO_SLUG///libkv/} $HOME/gopath/src/github.com/docker + - go get golang.org/x/tools/cmd/vet + - go get golang.org/x/tools/cmd/cover + - go get github.com/mattn/goveralls + - go get github.com/golang/lint/golint + - go get github.com/GeertJohan/fgt + +before_script: + - script/travis_consul.sh 0.5.2 + - script/travis_etcd.sh 2.2.0 + - script/travis_zk.sh 3.4.6 + +script: + - ./consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul -config-file=./config.json 1>/dev/null & + - ./etcd/etcd --listen-client-urls 'http://0.0.0.0:4001' --advertise-client-urls 'http://127.0.0.1:4001' >/dev/null 2>&1 & + - ./zk/bin/zkServer.sh start ./zk/conf/zoo.cfg 1> /dev/null + - script/validate-gofmt + - go vet ./... + - fgt golint ./... + - go test -v -race ./... + - script/coverage + - goveralls -service=travis-ci -coverprofile=goverage.report diff --git a/vendor/src/github.com/docker/libkv/LICENSE.code b/vendor/src/github.com/docker/libkv/LICENSE.code new file mode 100644 index 0000000000..9e4bd4dbee --- /dev/null +++ b/vendor/src/github.com/docker/libkv/LICENSE.code @@ -0,0 +1,191 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + Copyright 2014-2015 Docker, Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/vendor/src/github.com/docker/libkv/LICENSE.docs b/vendor/src/github.com/docker/libkv/LICENSE.docs new file mode 100644 index 0000000000..e26cd4fc8e --- /dev/null +++ b/vendor/src/github.com/docker/libkv/LICENSE.docs @@ -0,0 +1,425 @@ +Attribution-ShareAlike 4.0 International + +======================================================================= + +Creative Commons Corporation ("Creative Commons") is not a law firm and +does not provide legal services or legal advice. Distribution of +Creative Commons public licenses does not create a lawyer-client or +other relationship. Creative Commons makes its licenses and related +information available on an "as-is" basis. Creative Commons gives no +warranties regarding its licenses, any material licensed under their +terms and conditions, or any related information. Creative Commons +disclaims all liability for damages resulting from their use to the +fullest extent possible. + +Using Creative Commons Public Licenses + +Creative Commons public licenses provide a standard set of terms and +conditions that creators and other rights holders may use to share +original works of authorship and other material subject to copyright +and certain other rights specified in the public license below. The +following considerations are for informational purposes only, are not +exhaustive, and do not form part of our licenses. + + Considerations for licensors: Our public licenses are + intended for use by those authorized to give the public + permission to use material in ways otherwise restricted by + copyright and certain other rights. Our licenses are + irrevocable. Licensors should read and understand the terms + and conditions of the license they choose before applying it. + Licensors should also secure all rights necessary before + applying our licenses so that the public can reuse the + material as expected. Licensors should clearly mark any + material not subject to the license. This includes other CC- + licensed material, or material used under an exception or + limitation to copyright. More considerations for licensors: + wiki.creativecommons.org/Considerations_for_licensors + + Considerations for the public: By using one of our public + licenses, a licensor grants the public permission to use the + licensed material under specified terms and conditions. If + the licensor's permission is not necessary for any reason--for + example, because of any applicable exception or limitation to + copyright--then that use is not regulated by the license. Our + licenses grant only permissions under copyright and certain + other rights that a licensor has authority to grant. Use of + the licensed material may still be restricted for other + reasons, including because others have copyright or other + rights in the material. A licensor may make special requests, + such as asking that all changes be marked or described. + Although not required by our licenses, you are encouraged to + respect those requests where reasonable. More_considerations + for the public: + wiki.creativecommons.org/Considerations_for_licensees + +======================================================================= + +Creative Commons Attribution-ShareAlike 4.0 International Public +License + +By exercising the Licensed Rights (defined below), You accept and agree +to be bound by the terms and conditions of this Creative Commons +Attribution-ShareAlike 4.0 International Public License ("Public +License"). To the extent this Public License may be interpreted as a +contract, You are granted the Licensed Rights in consideration of Your +acceptance of these terms and conditions, and the Licensor grants You +such rights in consideration of benefits the Licensor receives from +making the Licensed Material available under these terms and +conditions. + + +Section 1 -- Definitions. + + a. Adapted Material means material subject to Copyright and Similar + Rights that is derived from or based upon the Licensed Material + and in which the Licensed Material is translated, altered, + arranged, transformed, or otherwise modified in a manner requiring + permission under the Copyright and Similar Rights held by the + Licensor. For purposes of this Public License, where the Licensed + Material is a musical work, performance, or sound recording, + Adapted Material is always produced where the Licensed Material is + synched in timed relation with a moving image. + + b. Adapter's License means the license You apply to Your Copyright + and Similar Rights in Your contributions to Adapted Material in + accordance with the terms and conditions of this Public License. + + c. BY-SA Compatible License means a license listed at + creativecommons.org/compatiblelicenses, approved by Creative + Commons as essentially the equivalent of this Public License. + + d. Copyright and Similar Rights means copyright and/or similar rights + closely related to copyright including, without limitation, + performance, broadcast, sound recording, and Sui Generis Database + Rights, without regard to how the rights are labeled or + categorized. For purposes of this Public License, the rights + specified in Section 2(b)(1)-(2) are not Copyright and Similar + Rights. + + e. Effective Technological Measures means those measures that, in the + absence of proper authority, may not be circumvented under laws + fulfilling obligations under Article 11 of the WIPO Copyright + Treaty adopted on December 20, 1996, and/or similar international + agreements. + + f. Exceptions and Limitations means fair use, fair dealing, and/or + any other exception or limitation to Copyright and Similar Rights + that applies to Your use of the Licensed Material. + + g. License Elements means the license attributes listed in the name + of a Creative Commons Public License. The License Elements of this + Public License are Attribution and ShareAlike. + + h. Licensed Material means the artistic or literary work, database, + or other material to which the Licensor applied this Public + License. + + i. Licensed Rights means the rights granted to You subject to the + terms and conditions of this Public License, which are limited to + all Copyright and Similar Rights that apply to Your use of the + Licensed Material and that the Licensor has authority to license. + + j. Licensor means the individual(s) or entity(ies) granting rights + under this Public License. + + k. Share means to provide material to the public by any means or + process that requires permission under the Licensed Rights, such + as reproduction, public display, public performance, distribution, + dissemination, communication, or importation, and to make material + available to the public including in ways that members of the + public may access the material from a place and at a time + individually chosen by them. + + l. Sui Generis Database Rights means rights other than copyright + resulting from Directive 96/9/EC of the European Parliament and of + the Council of 11 March 1996 on the legal protection of databases, + as amended and/or succeeded, as well as other essentially + equivalent rights anywhere in the world. + + m. You means the individual or entity exercising the Licensed Rights + under this Public License. Your has a corresponding meaning. + + +Section 2 -- Scope. + + a. License grant. + + 1. Subject to the terms and conditions of this Public License, + the Licensor hereby grants You a worldwide, royalty-free, + non-sublicensable, non-exclusive, irrevocable license to + exercise the Licensed Rights in the Licensed Material to: + + a. reproduce and Share the Licensed Material, in whole or + in part; and + + b. produce, reproduce, and Share Adapted Material. + + 2. Exceptions and Limitations. For the avoidance of doubt, where + Exceptions and Limitations apply to Your use, this Public + License does not apply, and You do not need to comply with + its terms and conditions. + + 3. Term. The term of this Public License is specified in Section + 6(a). + + 4. Media and formats; technical modifications allowed. The + Licensor authorizes You to exercise the Licensed Rights in + all media and formats whether now known or hereafter created, + and to make technical modifications necessary to do so. The + Licensor waives and/or agrees not to assert any right or + authority to forbid You from making technical modifications + necessary to exercise the Licensed Rights, including + technical modifications necessary to circumvent Effective + Technological Measures. For purposes of this Public License, + simply making modifications authorized by this Section 2(a) + (4) never produces Adapted Material. + + 5. Downstream recipients. + + a. Offer from the Licensor -- Licensed Material. Every + recipient of the Licensed Material automatically + receives an offer from the Licensor to exercise the + Licensed Rights under the terms and conditions of this + Public License. + + b. Additional offer from the Licensor -- Adapted Material. + Every recipient of Adapted Material from You + automatically receives an offer from the Licensor to + exercise the Licensed Rights in the Adapted Material + under the conditions of the Adapter's License You apply. + + c. No downstream restrictions. You may not offer or impose + any additional or different terms or conditions on, or + apply any Effective Technological Measures to, the + Licensed Material if doing so restricts exercise of the + Licensed Rights by any recipient of the Licensed + Material. + + 6. No endorsement. Nothing in this Public License constitutes or + may be construed as permission to assert or imply that You + are, or that Your use of the Licensed Material is, connected + with, or sponsored, endorsed, or granted official status by, + the Licensor or others designated to receive attribution as + provided in Section 3(a)(1)(A)(i). + + b. Other rights. + + 1. Moral rights, such as the right of integrity, are not + licensed under this Public License, nor are publicity, + privacy, and/or other similar personality rights; however, to + the extent possible, the Licensor waives and/or agrees not to + assert any such rights held by the Licensor to the limited + extent necessary to allow You to exercise the Licensed + Rights, but not otherwise. + + 2. Patent and trademark rights are not licensed under this + Public License. + + 3. To the extent possible, the Licensor waives any right to + collect royalties from You for the exercise of the Licensed + Rights, whether directly or through a collecting society + under any voluntary or waivable statutory or compulsory + licensing scheme. In all other cases the Licensor expressly + reserves any right to collect such royalties. + + +Section 3 -- License Conditions. + +Your exercise of the Licensed Rights is expressly made subject to the +following conditions. + + a. Attribution. + + 1. If You Share the Licensed Material (including in modified + form), You must: + + a. retain the following if it is supplied by the Licensor + with the Licensed Material: + + i. identification of the creator(s) of the Licensed + Material and any others designated to receive + attribution, in any reasonable manner requested by + the Licensor (including by pseudonym if + designated); + + ii. a copyright notice; + + iii. a notice that refers to this Public License; + + iv. a notice that refers to the disclaimer of + warranties; + + v. a URI or hyperlink to the Licensed Material to the + extent reasonably practicable; + + b. indicate if You modified the Licensed Material and + retain an indication of any previous modifications; and + + c. indicate the Licensed Material is licensed under this + Public License, and include the text of, or the URI or + hyperlink to, this Public License. + + 2. You may satisfy the conditions in Section 3(a)(1) in any + reasonable manner based on the medium, means, and context in + which You Share the Licensed Material. For example, it may be + reasonable to satisfy the conditions by providing a URI or + hyperlink to a resource that includes the required + information. + + 3. If requested by the Licensor, You must remove any of the + information required by Section 3(a)(1)(A) to the extent + reasonably practicable. + + b. ShareAlike. + + In addition to the conditions in Section 3(a), if You Share + Adapted Material You produce, the following conditions also apply. + + 1. The Adapter's License You apply must be a Creative Commons + license with the same License Elements, this version or + later, or a BY-SA Compatible License. + + 2. You must include the text of, or the URI or hyperlink to, the + Adapter's License You apply. You may satisfy this condition + in any reasonable manner based on the medium, means, and + context in which You Share Adapted Material. + + 3. You may not offer or impose any additional or different terms + or conditions on, or apply any Effective Technological + Measures to, Adapted Material that restrict exercise of the + rights granted under the Adapter's License You apply. + + +Section 4 -- Sui Generis Database Rights. + +Where the Licensed Rights include Sui Generis Database Rights that +apply to Your use of the Licensed Material: + + a. for the avoidance of doubt, Section 2(a)(1) grants You the right + to extract, reuse, reproduce, and Share all or a substantial + portion of the contents of the database; + + b. if You include all or a substantial portion of the database + contents in a database in which You have Sui Generis Database + Rights, then the database in which You have Sui Generis Database + Rights (but not its individual contents) is Adapted Material, + + including for purposes of Section 3(b); and + c. You must comply with the conditions in Section 3(a) if You Share + all or a substantial portion of the contents of the database. + +For the avoidance of doubt, this Section 4 supplements and does not +replace Your obligations under this Public License where the Licensed +Rights include other Copyright and Similar Rights. + + +Section 5 -- Disclaimer of Warranties and Limitation of Liability. + + a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE + EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS + AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF + ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, + IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, + WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR + PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, + ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT + KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT + ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. + + b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE + TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, + NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, + INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, + COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR + USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN + ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR + DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR + IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. + + c. The disclaimer of warranties and limitation of liability provided + above shall be interpreted in a manner that, to the extent + possible, most closely approximates an absolute disclaimer and + waiver of all liability. + + +Section 6 -- Term and Termination. + + a. This Public License applies for the term of the Copyright and + Similar Rights licensed here. However, if You fail to comply with + this Public License, then Your rights under this Public License + terminate automatically. + + b. Where Your right to use the Licensed Material has terminated under + Section 6(a), it reinstates: + + 1. automatically as of the date the violation is cured, provided + it is cured within 30 days of Your discovery of the + violation; or + + 2. upon express reinstatement by the Licensor. + + For the avoidance of doubt, this Section 6(b) does not affect any + right the Licensor may have to seek remedies for Your violations + of this Public License. + + c. For the avoidance of doubt, the Licensor may also offer the + Licensed Material under separate terms or conditions or stop + distributing the Licensed Material at any time; however, doing so + will not terminate this Public License. + + d. Sections 1, 5, 6, 7, and 8 survive termination of this Public + License. + + +Section 7 -- Other Terms and Conditions. + + a. The Licensor shall not be bound by any additional or different + terms or conditions communicated by You unless expressly agreed. + + b. Any arrangements, understandings, or agreements regarding the + Licensed Material not stated herein are separate from and + independent of the terms and conditions of this Public License. + + +Section 8 -- Interpretation. + + a. For the avoidance of doubt, this Public License does not, and + shall not be interpreted to, reduce, limit, restrict, or impose + conditions on any use of the Licensed Material that could lawfully + be made without permission under this Public License. + + b. To the extent possible, if any provision of this Public License is + deemed unenforceable, it shall be automatically reformed to the + minimum extent necessary to make it enforceable. If the provision + cannot be reformed, it shall be severed from this Public License + without affecting the enforceability of the remaining terms and + conditions. + + c. No term or condition of this Public License will be waived and no + failure to comply consented to unless expressly agreed to by the + Licensor. + + d. Nothing in this Public License constitutes or may be interpreted + as a limitation upon, or waiver of, any privileges and immunities + that apply to the Licensor or You, including from the legal + processes of any jurisdiction or authority. + + +======================================================================= + +Creative Commons is not a party to its public licenses. +Notwithstanding, Creative Commons may elect to apply one of its public +licenses to material it publishes and in those instances will be +considered the "Licensor." Except for the limited purpose of indicating +that material is shared under a Creative Commons public license or as +otherwise permitted by the Creative Commons policies published at +creativecommons.org/policies, Creative Commons does not authorize the +use of the trademark "Creative Commons" or any other trademark or logo +of Creative Commons without its prior written consent including, +without limitation, in connection with any unauthorized modifications +to any of its public licenses or any other arrangements, +understandings, or agreements concerning use of licensed material. For +the avoidance of doubt, this paragraph does not form part of the public +licenses. + +Creative Commons may be contacted at creativecommons.org. diff --git a/vendor/src/github.com/docker/libkv/README.md b/vendor/src/github.com/docker/libkv/README.md new file mode 100644 index 0000000000..02cf3fd0ea --- /dev/null +++ b/vendor/src/github.com/docker/libkv/README.md @@ -0,0 +1,106 @@ +# libkv + +[![GoDoc](https://godoc.org/github.com/docker/libkv?status.png)](https://godoc.org/github.com/docker/libkv) +[![Build Status](https://travis-ci.org/docker/libkv.svg?branch=master)](https://travis-ci.org/docker/libkv) +[![Coverage Status](https://coveralls.io/repos/docker/libkv/badge.svg)](https://coveralls.io/r/docker/libkv) + +`libkv` provides a `Go` native library to store metadata. + +The goal of `libkv` is to abstract common store operations for multiple distributed and/or local Key/Value store backends. + +For example, you can use it to store your metadata or for service discovery to register machines and endpoints inside your cluster. + +You can also easily implement a generic *Leader Election* on top of it (see the [swarm/leadership](https://github.com/docker/swarm/tree/master/leadership) package). + +As of now, `libkv` offers support for `Consul`, `Etcd`, `Zookeeper` (**Distributed** store) and `BoltDB` (**Local** store). + +## Usage + +`libkv` is meant to be used as an abstraction layer over existing distributed Key/Value stores. It is especially useful if you plan to support `consul`, `etcd` and `zookeeper` using the same codebase. + +It is ideal if you plan for something written in Go that should support: + +- A simple metadata storage, distributed or local +- A lightweight discovery service for your nodes +- A distributed lock mechanism + +You can find examples of usage for `libkv` under in `docs/examples.go`. Optionally you can also take a look at the `docker/swarm` or `docker/libnetwork` repositories which are using `docker/libkv` for all the use cases listed above. + +## Supported versions + +`libkv` supports: +- Consul versions >= `0.5.1` because it uses Sessions with `Delete` behavior for the use of `TTLs` (mimics zookeeper's Ephemeral node support), If you don't plan to use `TTLs`: you can use Consul version `0.4.0+`. +- Etcd versions >= `2.0` because it uses the new `coreos/etcd/client`, this might change in the future as the support for `APIv3` comes along and adds mor capabilities. +- Zookeeper versions >= `3.4.5`. Although this might work with previous version but this remains untested as of now. +- Boltdb, which shouldn't be subject to any version dependencies. + +## Interface + +A **storage backend** in `libkv` should implement (fully or partially) this interface: + +```go +type Store interface { + Put(key string, value []byte, options *WriteOptions) error + Get(key string) (*KVPair, error) + Delete(key string) error + Exists(key string) (bool, error) + Watch(key string, stopCh <-chan struct{}) (<-chan *KVPair, error) + WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*KVPair, error) + NewLock(key string, options *LockOptions) (Locker, error) + List(directory string) ([]*KVPair, error) + DeleteTree(directory string) error + AtomicPut(key string, value []byte, previous *KVPair, options *WriteOptions) (bool, *KVPair, error) + AtomicDelete(key string, previous *KVPair) (bool, error) + Close() +} +``` + +## Compatibility matrix + +Backend drivers in `libkv` are generally divided between **local drivers** and **distributed drivers**. Distributed backends offer enhanced capabilities like `Watches` and/or distributed `Locks`. + +Local drivers are usually used in complement to the distributed drivers to store informations that only needs to be available locally. + +| Calls | Consul | Etcd | Zookeeper | BoltDB | +|-----------------------|:----------:|:------:|:-----------:|:--------:| +| Put | X | X | X | X | +| Get | X | X | X | X | +| Delete | X | X | X | X | +| Exists | X | X | X | X | +| Watch | X | X | X | | +| WatchTree | X | X | X | | +| NewLock (Lock/Unlock) | X | X | X | | +| List | X | X | X | X | +| DeleteTree | X | X | X | X | +| AtomicPut | X | X | X | X | +| Close | X | X | X | X | + +## Limitations + +Distributed Key/Value stores often have different concepts for managing and formatting keys and their associated values. Even though `libkv` tries to abstract those stores aiming for some consistency, in some cases it can't be applied easily. + +Please refer to the `docs/compatibility.md` to see what are the special cases for cross-backend compatibility. + +Other than those special cases, you should expect the same experience for basic operations like `Get`/`Put`, etc. + +Calls like `WatchTree` may return different events (or number of events) depending on the backend (for now, `Etcd` and `Consul` will likely return more events than `Zookeeper` that you should triage properly). Although you should be able to use it successfully to watch on events in an interchangeable way (see the **swarm/leadership** or **swarm/discovery** packages in **docker/swarm**). + +## TLS + +Only `Consul` and `etcd` have support for TLS and you should build and provide your own `config.TLS` object to feed the client. Support is planned for `zookeeper`. + +##Roadmap + +- Make the API nicer to use (using `options`) +- Provide more options (`consistency` for example) +- Improve performance (remove extras `Get`/`List` operations) +- Better key formatting +- New backends? + +##Contributing + +Want to hack on libkv? [Docker's contributions guidelines](https://github.com/docker/docker/blob/master/CONTRIBUTING.md) apply. + +##Copyright and license + +Copyright © 2014-2015 Docker, Inc. All rights reserved, except as follows. Code is released under the Apache 2.0 license. The README.md file, and files in the "docs" folder are licensed under the Creative Commons Attribution 4.0 International License under the terms and conditions set forth in the file "LICENSE.docs". You may obtain a duplicate copy of the same license, titled CC-BY-SA-4.0, at http://creativecommons.org/licenses/by/4.0/. diff --git a/vendor/src/github.com/docker/libkv/libkv.go b/vendor/src/github.com/docker/libkv/libkv.go new file mode 100644 index 0000000000..2192cd14e8 --- /dev/null +++ b/vendor/src/github.com/docker/libkv/libkv.go @@ -0,0 +1,40 @@ +package libkv + +import ( + "fmt" + "sort" + "strings" + + "github.com/docker/libkv/store" +) + +// Initialize creates a new Store object, initializing the client +type Initialize func(addrs []string, options *store.Config) (store.Store, error) + +var ( + // Backend initializers + initializers = make(map[store.Backend]Initialize) + + supportedBackend = func() string { + keys := make([]string, 0, len(initializers)) + for k := range initializers { + keys = append(keys, string(k)) + } + sort.Strings(keys) + return strings.Join(keys, ", ") + }() +) + +// NewStore creates a an instance of store +func NewStore(backend store.Backend, addrs []string, options *store.Config) (store.Store, error) { + if init, exists := initializers[backend]; exists { + return init(addrs, options) + } + + return nil, fmt.Errorf("%s %s", store.ErrBackendNotSupported.Error(), supportedBackend) +} + +// AddStore adds a new store backend to libkv +func AddStore(store store.Backend, init Initialize) { + initializers[store] = init +} diff --git a/vendor/src/github.com/docker/libkv/store/boltdb/boltdb.go b/vendor/src/github.com/docker/libkv/store/boltdb/boltdb.go new file mode 100644 index 0000000000..94d01b4b09 --- /dev/null +++ b/vendor/src/github.com/docker/libkv/store/boltdb/boltdb.go @@ -0,0 +1,471 @@ +package boltdb + +import ( + "bytes" + "encoding/binary" + "errors" + "os" + "path/filepath" + "sync" + "sync/atomic" + "time" + + "github.com/boltdb/bolt" + "github.com/docker/libkv" + "github.com/docker/libkv/store" +) + +var ( + // ErrMultipleEndpointsUnsupported is thrown when multiple endpoints specified for + // BoltDB. Endpoint has to be a local file path + ErrMultipleEndpointsUnsupported = errors.New("boltdb supports one endpoint and should be a file path") + // ErrBoltBucketNotFound is thrown when specified BoltBD bucket doesn't exist in the DB + ErrBoltBucketNotFound = errors.New("boltdb bucket doesn't exist") + // ErrBoltBucketOptionMissing is thrown when boltBcuket config option is missing + ErrBoltBucketOptionMissing = errors.New("boltBucket config option missing") +) + +const ( + filePerm os.FileMode = 0644 +) + +//BoltDB type implements the Store interface +type BoltDB struct { + client *bolt.DB + boltBucket []byte + dbIndex uint64 + path string + timeout time.Duration + // By default libkv opens and closes the bolt DB connection for every + // get/put operation. This allows multiple apps to use a Bolt DB at the + // same time. + // PersistConnection flag provides an option to override ths behavior. + // ie: open the connection in New and use it till Close is called. + PersistConnection bool + sync.Mutex +} + +const ( + libkvmetadatalen = 8 + transientTimeout = time.Duration(10) * time.Second +) + +// Register registers boltdb to libkv +func Register() { + libkv.AddStore(store.BOLTDB, New) +} + +// New opens a new BoltDB connection to the specified path and bucket +func New(endpoints []string, options *store.Config) (store.Store, error) { + var ( + db *bolt.DB + err error + boltOptions *bolt.Options + ) + + if len(endpoints) > 1 { + return nil, ErrMultipleEndpointsUnsupported + } + + if (options == nil) || (len(options.Bucket) == 0) { + return nil, ErrBoltBucketOptionMissing + } + + dir, _ := filepath.Split(endpoints[0]) + if err = os.MkdirAll(dir, 0750); err != nil { + return nil, err + } + + if options.PersistConnection { + boltOptions = &bolt.Options{Timeout: options.ConnectionTimeout} + db, err = bolt.Open(endpoints[0], filePerm, boltOptions) + if err != nil { + return nil, err + } + } + + b := &BoltDB{ + client: db, + path: endpoints[0], + boltBucket: []byte(options.Bucket), + timeout: transientTimeout, + PersistConnection: options.PersistConnection, + } + + return b, nil +} + +func (b *BoltDB) reset() { + b.path = "" + b.boltBucket = []byte{} +} + +func (b *BoltDB) getDBhandle() (*bolt.DB, error) { + var ( + db *bolt.DB + err error + ) + if !b.PersistConnection { + boltOptions := &bolt.Options{Timeout: b.timeout} + if db, err = bolt.Open(b.path, filePerm, boltOptions); err != nil { + return nil, err + } + b.client = db + } + + return b.client, nil +} + +func (b *BoltDB) releaseDBhandle() { + if !b.PersistConnection { + b.client.Close() + } +} + +// Get the value at "key". BoltDB doesn't provide an inbuilt last modified index with every kv pair. Its implemented by +// by a atomic counter maintained by the libkv and appened to the value passed by the client. +func (b *BoltDB) Get(key string) (*store.KVPair, error) { + var ( + val []byte + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + if db, err = b.getDBhandle(); err != nil { + return nil, err + } + defer b.releaseDBhandle() + + err = db.View(func(tx *bolt.Tx) error { + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + return ErrBoltBucketNotFound + } + + v := bucket.Get([]byte(key)) + val = make([]byte, len(v)) + copy(val, v) + + return nil + }) + + if len(val) == 0 { + return nil, store.ErrKeyNotFound + } + if err != nil { + return nil, err + } + + dbIndex := binary.LittleEndian.Uint64(val[:libkvmetadatalen]) + val = val[libkvmetadatalen:] + + return &store.KVPair{Key: key, Value: val, LastIndex: (dbIndex)}, nil +} + +//Put the key, value pair. index number metadata is prepended to the value +func (b *BoltDB) Put(key string, value []byte, opts *store.WriteOptions) error { + var ( + dbIndex uint64 + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + dbval := make([]byte, libkvmetadatalen) + + if db, err = b.getDBhandle(); err != nil { + return err + } + defer b.releaseDBhandle() + + err = db.Update(func(tx *bolt.Tx) error { + bucket, err := tx.CreateBucketIfNotExists(b.boltBucket) + if err != nil { + return err + } + + dbIndex = atomic.AddUint64(&b.dbIndex, 1) + binary.LittleEndian.PutUint64(dbval, dbIndex) + dbval = append(dbval, value...) + + err = bucket.Put([]byte(key), dbval) + if err != nil { + return err + } + return nil + }) + return err +} + +//Delete the value for the given key. +func (b *BoltDB) Delete(key string) error { + var ( + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + if db, err = b.getDBhandle(); err != nil { + return err + } + defer b.releaseDBhandle() + + err = db.Update(func(tx *bolt.Tx) error { + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + return ErrBoltBucketNotFound + } + err := bucket.Delete([]byte(key)) + return err + }) + return err +} + +// Exists checks if the key exists inside the store +func (b *BoltDB) Exists(key string) (bool, error) { + var ( + val []byte + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + if db, err = b.getDBhandle(); err != nil { + return false, err + } + defer b.releaseDBhandle() + + err = db.View(func(tx *bolt.Tx) error { + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + return ErrBoltBucketNotFound + } + + val = bucket.Get([]byte(key)) + + return nil + }) + + if len(val) == 0 { + return false, err + } + return true, err +} + +// List returns the range of keys starting with the passed in prefix +func (b *BoltDB) List(keyPrefix string) ([]*store.KVPair, error) { + var ( + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + kv := []*store.KVPair{} + + if db, err = b.getDBhandle(); err != nil { + return nil, err + } + defer b.releaseDBhandle() + + err = db.View(func(tx *bolt.Tx) error { + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + return ErrBoltBucketNotFound + } + + cursor := bucket.Cursor() + prefix := []byte(keyPrefix) + + for key, v := cursor.Seek(prefix); bytes.HasPrefix(key, prefix); key, v = cursor.Next() { + + dbIndex := binary.LittleEndian.Uint64(v[:libkvmetadatalen]) + v = v[libkvmetadatalen:] + val := make([]byte, len(v)) + copy(val, v) + + kv = append(kv, &store.KVPair{ + Key: string(key), + Value: val, + LastIndex: dbIndex, + }) + } + return nil + }) + if len(kv) == 0 { + return nil, store.ErrKeyNotFound + } + return kv, err +} + +// AtomicDelete deletes a value at "key" if the key +// has not been modified in the meantime, throws an +// error if this is the case +func (b *BoltDB) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + var ( + val []byte + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + if previous == nil { + return false, store.ErrPreviousNotSpecified + } + if db, err = b.getDBhandle(); err != nil { + return false, err + } + defer b.releaseDBhandle() + + err = db.Update(func(tx *bolt.Tx) error { + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + return ErrBoltBucketNotFound + } + + val = bucket.Get([]byte(key)) + if val == nil { + return store.ErrKeyNotFound + } + dbIndex := binary.LittleEndian.Uint64(val[:libkvmetadatalen]) + if dbIndex != previous.LastIndex { + return store.ErrKeyModified + } + err := bucket.Delete([]byte(key)) + return err + }) + if err != nil { + return false, err + } + return true, err +} + +// AtomicPut puts a value at "key" if the key has not been +// modified since the last Put, throws an error if this is the case +func (b *BoltDB) AtomicPut(key string, value []byte, previous *store.KVPair, options *store.WriteOptions) (bool, *store.KVPair, error) { + var ( + val []byte + dbIndex uint64 + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + dbval := make([]byte, libkvmetadatalen) + + if db, err = b.getDBhandle(); err != nil { + return false, nil, err + } + defer b.releaseDBhandle() + + err = db.Update(func(tx *bolt.Tx) error { + var err error + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + if previous != nil { + return ErrBoltBucketNotFound + } + bucket, err = tx.CreateBucket(b.boltBucket) + if err != nil { + return err + } + } + // AtomicPut is equivalent to Put if previous is nil and the Ky + // doesn't exist in the DB. + val = bucket.Get([]byte(key)) + if previous == nil && len(val) != 0 { + return store.ErrKeyModified + } + if previous != nil { + if len(val) == 0 { + return store.ErrKeyNotFound + } + dbIndex = binary.LittleEndian.Uint64(val[:libkvmetadatalen]) + if dbIndex != previous.LastIndex { + return store.ErrKeyModified + } + } + dbIndex = atomic.AddUint64(&b.dbIndex, 1) + binary.LittleEndian.PutUint64(dbval, b.dbIndex) + dbval = append(dbval, value...) + return (bucket.Put([]byte(key), dbval)) + }) + if err != nil { + return false, nil, err + } + + updated := &store.KVPair{ + Key: key, + Value: value, + LastIndex: dbIndex, + } + + return true, updated, nil +} + +// Close the db connection to the BoltDB +func (b *BoltDB) Close() { + b.Lock() + defer b.Unlock() + + if !b.PersistConnection { + b.reset() + } else { + b.client.Close() + } + return +} + +// DeleteTree deletes a range of keys with a given prefix +func (b *BoltDB) DeleteTree(keyPrefix string) error { + var ( + db *bolt.DB + err error + ) + b.Lock() + defer b.Unlock() + + if db, err = b.getDBhandle(); err != nil { + return err + } + defer b.releaseDBhandle() + + err = db.Update(func(tx *bolt.Tx) error { + bucket := tx.Bucket(b.boltBucket) + if bucket == nil { + return ErrBoltBucketNotFound + } + + cursor := bucket.Cursor() + prefix := []byte(keyPrefix) + + for key, _ := cursor.Seek(prefix); bytes.HasPrefix(key, prefix); key, _ = cursor.Next() { + _ = bucket.Delete([]byte(key)) + } + return nil + }) + + return err +} + +// NewLock has to implemented at the library level since its not supported by BoltDB +func (b *BoltDB) NewLock(key string, options *store.LockOptions) (store.Locker, error) { + return nil, store.ErrCallNotSupported +} + +// Watch has to implemented at the library level since its not supported by BoltDB +func (b *BoltDB) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + return nil, store.ErrCallNotSupported +} + +// WatchTree has to implemented at the library level since its not supported by BoltDB +func (b *BoltDB) WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + return nil, store.ErrCallNotSupported +} diff --git a/vendor/src/github.com/docker/libkv/store/consul/consul.go b/vendor/src/github.com/docker/libkv/store/consul/consul.go new file mode 100644 index 0000000000..c7693ca441 --- /dev/null +++ b/vendor/src/github.com/docker/libkv/store/consul/consul.go @@ -0,0 +1,489 @@ +package consul + +import ( + "crypto/tls" + "errors" + "net/http" + "strings" + "sync" + "time" + + "github.com/docker/libkv" + "github.com/docker/libkv/store" + api "github.com/hashicorp/consul/api" +) + +const ( + // DefaultWatchWaitTime is how long we block for at a + // time to check if the watched key has changed. This + // affects the minimum time it takes to cancel a watch. + DefaultWatchWaitTime = 15 * time.Second + + // RenewSessionRetryMax is the number of time we should try + // to renew the session before giving up and throwing an error + RenewSessionRetryMax = 5 +) + +var ( + // ErrMultipleEndpointsUnsupported is thrown when there are + // multiple endpoints specified for Consul + ErrMultipleEndpointsUnsupported = errors.New("consul does not support multiple endpoints") + + // ErrSessionRenew is thrown when the session can't be + // renewed because the Consul version does not support sessions + ErrSessionRenew = errors.New("cannot set or renew session for ttl, unable to operate on sessions") +) + +// Consul is the receiver type for the +// Store interface +type Consul struct { + sync.Mutex + config *api.Config + client *api.Client +} + +type consulLock struct { + lock *api.Lock + renewCh chan struct{} +} + +// Register registers consul to libkv +func Register() { + libkv.AddStore(store.CONSUL, New) +} + +// New creates a new Consul client given a list +// of endpoints and optional tls config +func New(endpoints []string, options *store.Config) (store.Store, error) { + if len(endpoints) > 1 { + return nil, ErrMultipleEndpointsUnsupported + } + + s := &Consul{} + + // Create Consul client + config := api.DefaultConfig() + s.config = config + config.HttpClient = http.DefaultClient + config.Address = endpoints[0] + config.Scheme = "http" + + // Set options + if options != nil { + if options.TLS != nil { + s.setTLS(options.TLS) + } + if options.ConnectionTimeout != 0 { + s.setTimeout(options.ConnectionTimeout) + } + } + + // Creates a new client + client, err := api.NewClient(config) + if err != nil { + return nil, err + } + s.client = client + + return s, nil +} + +// SetTLS sets Consul TLS options +func (s *Consul) setTLS(tls *tls.Config) { + s.config.HttpClient.Transport = &http.Transport{ + TLSClientConfig: tls, + } + s.config.Scheme = "https" +} + +// SetTimeout sets the timeout for connecting to Consul +func (s *Consul) setTimeout(time time.Duration) { + s.config.WaitTime = time +} + +// Normalize the key for usage in Consul +func (s *Consul) normalize(key string) string { + key = store.Normalize(key) + return strings.TrimPrefix(key, "/") +} + +func (s *Consul) renewSession(pair *api.KVPair, ttl time.Duration) error { + // Check if there is any previous session with an active TTL + session, err := s.getActiveSession(pair.Key) + if err != nil { + return err + } + + if session == "" { + entry := &api.SessionEntry{ + Behavior: api.SessionBehaviorDelete, // Delete the key when the session expires + TTL: (ttl / 2).String(), // Consul multiplies the TTL by 2x + LockDelay: 1 * time.Millisecond, // Virtually disable lock delay + } + + // Create the key session + session, _, err = s.client.Session().Create(entry, nil) + if err != nil { + return err + } + + lockOpts := &api.LockOptions{ + Key: pair.Key, + Session: session, + } + + // Lock and ignore if lock is held + // It's just a placeholder for the + // ephemeral behavior + lock, _ := s.client.LockOpts(lockOpts) + if lock != nil { + lock.Lock(nil) + } + } + + _, _, err = s.client.Session().Renew(session, nil) + return err +} + +// getActiveSession checks if the key already has +// a session attached +func (s *Consul) getActiveSession(key string) (string, error) { + pair, _, err := s.client.KV().Get(key, nil) + if err != nil { + return "", err + } + if pair != nil && pair.Session != "" { + return pair.Session, nil + } + return "", nil +} + +// Get the value at "key", returns the last modified index +// to use in conjunction to CAS calls +func (s *Consul) Get(key string) (*store.KVPair, error) { + options := &api.QueryOptions{ + AllowStale: false, + RequireConsistent: true, + } + + pair, meta, err := s.client.KV().Get(s.normalize(key), options) + if err != nil { + return nil, err + } + + // If pair is nil then the key does not exist + if pair == nil { + return nil, store.ErrKeyNotFound + } + + return &store.KVPair{Key: pair.Key, Value: pair.Value, LastIndex: meta.LastIndex}, nil +} + +// Put a value at "key" +func (s *Consul) Put(key string, value []byte, opts *store.WriteOptions) error { + key = s.normalize(key) + + p := &api.KVPair{ + Key: key, + Value: value, + } + + if opts != nil && opts.TTL > 0 { + // Create or renew a session holding a TTL. Operations on sessions + // are not deterministic: creating or renewing a session can fail + for retry := 1; retry <= RenewSessionRetryMax; retry++ { + err := s.renewSession(p, opts.TTL) + if err == nil { + break + } + if retry == RenewSessionRetryMax { + return ErrSessionRenew + } + } + } + + _, err := s.client.KV().Put(p, nil) + return err +} + +// Delete a value at "key" +func (s *Consul) Delete(key string) error { + if _, err := s.Get(key); err != nil { + return err + } + _, err := s.client.KV().Delete(s.normalize(key), nil) + return err +} + +// Exists checks that the key exists inside the store +func (s *Consul) Exists(key string) (bool, error) { + _, err := s.Get(key) + if err != nil { + if err == store.ErrKeyNotFound { + return false, nil + } + return false, err + } + return true, nil +} + +// List child nodes of a given directory +func (s *Consul) List(directory string) ([]*store.KVPair, error) { + pairs, _, err := s.client.KV().List(s.normalize(directory), nil) + if err != nil { + return nil, err + } + if len(pairs) == 0 { + return nil, store.ErrKeyNotFound + } + + kv := []*store.KVPair{} + + for _, pair := range pairs { + if pair.Key == directory { + continue + } + kv = append(kv, &store.KVPair{ + Key: pair.Key, + Value: pair.Value, + LastIndex: pair.ModifyIndex, + }) + } + + return kv, nil +} + +// DeleteTree deletes a range of keys under a given directory +func (s *Consul) DeleteTree(directory string) error { + if _, err := s.List(directory); err != nil { + return err + } + _, err := s.client.KV().DeleteTree(s.normalize(directory), nil) + return err +} + +// Watch for changes on a "key" +// It returns a channel that will receive changes or pass +// on errors. Upon creation, the current value will first +// be sent to the channel. Providing a non-nil stopCh can +// be used to stop watching. +func (s *Consul) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + kv := s.client.KV() + watchCh := make(chan *store.KVPair) + + go func() { + defer close(watchCh) + + // Use a wait time in order to check if we should quit + // from time to time. + opts := &api.QueryOptions{WaitTime: DefaultWatchWaitTime} + + for { + // Check if we should quit + select { + case <-stopCh: + return + default: + } + + // Get the key + pair, meta, err := kv.Get(key, opts) + if err != nil { + return + } + + // If LastIndex didn't change then it means `Get` returned + // because of the WaitTime and the key didn't changed. + if opts.WaitIndex == meta.LastIndex { + continue + } + opts.WaitIndex = meta.LastIndex + + // Return the value to the channel + // FIXME: What happens when a key is deleted? + if pair != nil { + watchCh <- &store.KVPair{ + Key: pair.Key, + Value: pair.Value, + LastIndex: pair.ModifyIndex, + } + } + } + }() + + return watchCh, nil +} + +// WatchTree watches for changes on a "directory" +// It returns a channel that will receive changes or pass +// on errors. Upon creating a watch, the current childs values +// will be sent to the channel .Providing a non-nil stopCh can +// be used to stop watching. +func (s *Consul) WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + kv := s.client.KV() + watchCh := make(chan []*store.KVPair) + + go func() { + defer close(watchCh) + + // Use a wait time in order to check if we should quit + // from time to time. + opts := &api.QueryOptions{WaitTime: DefaultWatchWaitTime} + for { + // Check if we should quit + select { + case <-stopCh: + return + default: + } + + // Get all the childrens + pairs, meta, err := kv.List(directory, opts) + if err != nil { + return + } + + // If LastIndex didn't change then it means `Get` returned + // because of the WaitTime and the child keys didn't change. + if opts.WaitIndex == meta.LastIndex { + continue + } + opts.WaitIndex = meta.LastIndex + + // Return children KV pairs to the channel + kvpairs := []*store.KVPair{} + for _, pair := range pairs { + if pair.Key == directory { + continue + } + kvpairs = append(kvpairs, &store.KVPair{ + Key: pair.Key, + Value: pair.Value, + LastIndex: pair.ModifyIndex, + }) + } + watchCh <- kvpairs + } + }() + + return watchCh, nil +} + +// NewLock returns a handle to a lock struct which can +// be used to provide mutual exclusion on a key +func (s *Consul) NewLock(key string, options *store.LockOptions) (store.Locker, error) { + lockOpts := &api.LockOptions{ + Key: s.normalize(key), + } + + lock := &consulLock{} + + if options != nil { + // Set optional TTL on Lock + if options.TTL != 0 { + entry := &api.SessionEntry{ + Behavior: api.SessionBehaviorRelease, // Release the lock when the session expires + TTL: (options.TTL / 2).String(), // Consul multiplies the TTL by 2x + LockDelay: 1 * time.Millisecond, // Virtually disable lock delay + } + + // Create the key session + session, _, err := s.client.Session().Create(entry, nil) + if err != nil { + return nil, err + } + + // Place the session on lock + lockOpts.Session = session + + // Renew the session ttl lock periodically + go s.client.Session().RenewPeriodic(entry.TTL, session, nil, options.RenewLock) + lock.renewCh = options.RenewLock + } + + // Set optional value on Lock + if options.Value != nil { + lockOpts.Value = options.Value + } + } + + l, err := s.client.LockOpts(lockOpts) + if err != nil { + return nil, err + } + + lock.lock = l + return lock, nil +} + +// Lock attempts to acquire the lock and blocks while +// doing so. It returns a channel that is closed if our +// lock is lost or if an error occurs +func (l *consulLock) Lock(stopChan chan struct{}) (<-chan struct{}, error) { + return l.lock.Lock(stopChan) +} + +// Unlock the "key". Calling unlock while +// not holding the lock will throw an error +func (l *consulLock) Unlock() error { + if l.renewCh != nil { + close(l.renewCh) + } + return l.lock.Unlock() +} + +// AtomicPut put a value at "key" if the key has not been +// modified in the meantime, throws an error if this is the case +func (s *Consul) AtomicPut(key string, value []byte, previous *store.KVPair, options *store.WriteOptions) (bool, *store.KVPair, error) { + + p := &api.KVPair{Key: s.normalize(key), Value: value} + + if previous == nil { + // Consul interprets ModifyIndex = 0 as new key. + p.ModifyIndex = 0 + } else { + p.ModifyIndex = previous.LastIndex + } + + if work, _, err := s.client.KV().CAS(p, nil); err != nil { + return false, nil, err + } else if !work { + return false, nil, store.ErrKeyModified + } + + pair, err := s.Get(key) + if err != nil { + return false, nil, err + } + + return true, pair, nil +} + +// AtomicDelete deletes a value at "key" if the key has not +// been modified in the meantime, throws an error if this is the case +func (s *Consul) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + if previous == nil { + return false, store.ErrPreviousNotSpecified + } + + p := &api.KVPair{Key: s.normalize(key), ModifyIndex: previous.LastIndex} + + // Extra Get operation to check on the key + _, err := s.Get(key) + if err != nil && err == store.ErrKeyNotFound { + return false, err + } + + if work, _, err := s.client.KV().DeleteCAS(p, nil); err != nil { + return false, err + } else if !work { + return false, store.ErrKeyModified + } + + return true, nil +} + +// Close closes the client connection +func (s *Consul) Close() { + return +} diff --git a/vendor/src/github.com/docker/libkv/store/etcd/etcd.go b/vendor/src/github.com/docker/libkv/store/etcd/etcd.go new file mode 100644 index 0000000000..312bb0b65a --- /dev/null +++ b/vendor/src/github.com/docker/libkv/store/etcd/etcd.go @@ -0,0 +1,593 @@ +package etcd + +import ( + "crypto/tls" + "errors" + "log" + "net" + "net/http" + "strings" + "time" + + "golang.org/x/net/context" + + etcd "github.com/coreos/etcd/client" + "github.com/docker/libkv" + "github.com/docker/libkv/store" +) + +var ( + // ErrAbortTryLock is thrown when a user stops trying to seek the lock + // by sending a signal to the stop chan, this is used to verify if the + // operation succeeded + ErrAbortTryLock = errors.New("lock operation aborted") +) + +// Etcd is the receiver type for the +// Store interface +type Etcd struct { + client etcd.KeysAPI +} + +type etcdLock struct { + client etcd.KeysAPI + stopLock chan struct{} + stopRenew chan struct{} + key string + value string + last *etcd.Response + ttl time.Duration +} + +const ( + periodicSync = 5 * time.Minute + defaultLockTTL = 20 * time.Second + defaultUpdateTime = 5 * time.Second +) + +// Register registers etcd to libkv +func Register() { + libkv.AddStore(store.ETCD, New) +} + +// New creates a new Etcd client given a list +// of endpoints and an optional tls config +func New(addrs []string, options *store.Config) (store.Store, error) { + s := &Etcd{} + + var ( + entries []string + err error + ) + + entries = store.CreateEndpoints(addrs, "http") + cfg := &etcd.Config{ + Endpoints: entries, + Transport: etcd.DefaultTransport, + HeaderTimeoutPerRequest: 3 * time.Second, + } + + // Set options + if options != nil { + if options.TLS != nil { + setTLS(cfg, options.TLS, addrs) + } + if options.ConnectionTimeout != 0 { + setTimeout(cfg, options.ConnectionTimeout) + } + } + + c, err := etcd.New(*cfg) + if err != nil { + log.Fatal(err) + } + + s.client = etcd.NewKeysAPI(c) + + // Periodic Cluster Sync + go func() { + for { + if err := c.AutoSync(context.Background(), periodicSync); err != nil { + return + } + } + }() + + return s, nil +} + +// SetTLS sets the tls configuration given a tls.Config scheme +func setTLS(cfg *etcd.Config, tls *tls.Config, addrs []string) { + entries := store.CreateEndpoints(addrs, "https") + cfg.Endpoints = entries + + // Set transport + t := http.Transport{ + Dial: (&net.Dialer{ + Timeout: 30 * time.Second, + KeepAlive: 30 * time.Second, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, + TLSClientConfig: tls, + } + + cfg.Transport = &t +} + +// setTimeout sets the timeout used for connecting to the store +func setTimeout(cfg *etcd.Config, time time.Duration) { + cfg.HeaderTimeoutPerRequest = time +} + +// Normalize the key for usage in Etcd +func (s *Etcd) normalize(key string) string { + key = store.Normalize(key) + return strings.TrimPrefix(key, "/") +} + +// keyNotFound checks on the error returned by the KeysAPI +// to verify if the key exists in the store or not +func keyNotFound(err error) bool { + if err != nil { + if etcdError, ok := err.(etcd.Error); ok { + if etcdError.Code == etcd.ErrorCodeKeyNotFound || + etcdError.Code == etcd.ErrorCodeNotFile || + etcdError.Code == etcd.ErrorCodeNotDir { + return true + } + } + } + return false +} + +// Get the value at "key", returns the last modified +// index to use in conjunction to Atomic calls +func (s *Etcd) Get(key string) (pair *store.KVPair, err error) { + getOpts := &etcd.GetOptions{ + Quorum: true, + } + + result, err := s.client.Get(context.Background(), s.normalize(key), getOpts) + if err != nil { + if keyNotFound(err) { + return nil, store.ErrKeyNotFound + } + return nil, err + } + + pair = &store.KVPair{ + Key: key, + Value: []byte(result.Node.Value), + LastIndex: result.Node.ModifiedIndex, + } + + return pair, nil +} + +// Put a value at "key" +func (s *Etcd) Put(key string, value []byte, opts *store.WriteOptions) error { + setOpts := &etcd.SetOptions{} + + // Set options + if opts != nil { + setOpts.Dir = opts.IsDir + setOpts.TTL = opts.TTL + } + + _, err := s.client.Set(context.Background(), s.normalize(key), string(value), setOpts) + return err +} + +// Delete a value at "key" +func (s *Etcd) Delete(key string) error { + opts := &etcd.DeleteOptions{ + Recursive: false, + } + + _, err := s.client.Delete(context.Background(), s.normalize(key), opts) + if keyNotFound(err) { + return store.ErrKeyNotFound + } + return err +} + +// Exists checks if the key exists inside the store +func (s *Etcd) Exists(key string) (bool, error) { + _, err := s.Get(key) + if err != nil { + if err == store.ErrKeyNotFound { + return false, nil + } + return false, err + } + return true, nil +} + +// Watch for changes on a "key" +// It returns a channel that will receive changes or pass +// on errors. Upon creation, the current value will first +// be sent to the channel. Providing a non-nil stopCh can +// be used to stop watching. +func (s *Etcd) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + opts := &etcd.WatcherOptions{Recursive: false} + watcher := s.client.Watcher(s.normalize(key), opts) + + // watchCh is sending back events to the caller + watchCh := make(chan *store.KVPair) + + go func() { + defer close(watchCh) + + // Get the current value + pair, err := s.Get(key) + if err != nil { + return + } + + // Push the current value through the channel. + watchCh <- pair + + for { + // Check if the watch was stopped by the caller + select { + case <-stopCh: + return + default: + } + + result, err := watcher.Next(context.Background()) + + if err != nil { + return + } + + watchCh <- &store.KVPair{ + Key: key, + Value: []byte(result.Node.Value), + LastIndex: result.Node.ModifiedIndex, + } + } + }() + + return watchCh, nil +} + +// WatchTree watches for changes on a "directory" +// It returns a channel that will receive changes or pass +// on errors. Upon creating a watch, the current childs values +// will be sent to the channel. Providing a non-nil stopCh can +// be used to stop watching. +func (s *Etcd) WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + watchOpts := &etcd.WatcherOptions{Recursive: true} + watcher := s.client.Watcher(s.normalize(directory), watchOpts) + + // watchCh is sending back events to the caller + watchCh := make(chan []*store.KVPair) + + go func() { + defer close(watchCh) + + // Get child values + list, err := s.List(directory) + if err != nil { + return + } + + // Push the current value through the channel. + watchCh <- list + + for { + // Check if the watch was stopped by the caller + select { + case <-stopCh: + return + default: + } + + _, err := watcher.Next(context.Background()) + + if err != nil { + return + } + + list, err = s.List(directory) + if err != nil { + return + } + + watchCh <- list + } + }() + + return watchCh, nil +} + +// AtomicPut puts a value at "key" if the key has not been +// modified in the meantime, throws an error if this is the case +func (s *Etcd) AtomicPut(key string, value []byte, previous *store.KVPair, opts *store.WriteOptions) (bool, *store.KVPair, error) { + var ( + meta *etcd.Response + err error + ) + + setOpts := &etcd.SetOptions{} + + if previous != nil { + setOpts.PrevExist = etcd.PrevExist + setOpts.PrevIndex = previous.LastIndex + if previous.Value != nil { + setOpts.PrevValue = string(previous.Value) + } + } else { + setOpts.PrevExist = etcd.PrevNoExist + } + + if opts != nil { + if opts.TTL > 0 { + setOpts.TTL = opts.TTL + } + } + + meta, err = s.client.Set(context.Background(), s.normalize(key), string(value), setOpts) + if err != nil { + if etcdError, ok := err.(etcd.Error); ok { + // Compare failed + if etcdError.Code == etcd.ErrorCodeTestFailed { + return false, nil, store.ErrKeyModified + } + } + return false, nil, err + } + + updated := &store.KVPair{ + Key: key, + Value: value, + LastIndex: meta.Node.ModifiedIndex, + } + + return true, updated, nil +} + +// AtomicDelete deletes a value at "key" if the key +// has not been modified in the meantime, throws an +// error if this is the case +func (s *Etcd) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + if previous == nil { + return false, store.ErrPreviousNotSpecified + } + + delOpts := &etcd.DeleteOptions{} + + if previous != nil { + delOpts.PrevIndex = previous.LastIndex + if previous.Value != nil { + delOpts.PrevValue = string(previous.Value) + } + } + + _, err := s.client.Delete(context.Background(), s.normalize(key), delOpts) + if err != nil { + if etcdError, ok := err.(etcd.Error); ok { + // Key Not Found + if etcdError.Code == etcd.ErrorCodeKeyNotFound { + return false, store.ErrKeyNotFound + } + // Compare failed + if etcdError.Code == etcd.ErrorCodeTestFailed { + return false, store.ErrKeyModified + } + } + return false, err + } + + return true, nil +} + +// List child nodes of a given directory +func (s *Etcd) List(directory string) ([]*store.KVPair, error) { + getOpts := &etcd.GetOptions{ + Quorum: true, + Recursive: true, + Sort: true, + } + + resp, err := s.client.Get(context.Background(), s.normalize(directory), getOpts) + if err != nil { + if keyNotFound(err) { + return nil, store.ErrKeyNotFound + } + return nil, err + } + + kv := []*store.KVPair{} + for _, n := range resp.Node.Nodes { + kv = append(kv, &store.KVPair{ + Key: n.Key, + Value: []byte(n.Value), + LastIndex: n.ModifiedIndex, + }) + } + return kv, nil +} + +// DeleteTree deletes a range of keys under a given directory +func (s *Etcd) DeleteTree(directory string) error { + delOpts := &etcd.DeleteOptions{ + Recursive: true, + } + + _, err := s.client.Delete(context.Background(), s.normalize(directory), delOpts) + if keyNotFound(err) { + return store.ErrKeyNotFound + } + return err +} + +// NewLock returns a handle to a lock struct which can +// be used to provide mutual exclusion on a key +func (s *Etcd) NewLock(key string, options *store.LockOptions) (lock store.Locker, err error) { + var value string + ttl := defaultLockTTL + renewCh := make(chan struct{}) + + // Apply options on Lock + if options != nil { + if options.Value != nil { + value = string(options.Value) + } + if options.TTL != 0 { + ttl = options.TTL + } + if options.RenewLock != nil { + renewCh = options.RenewLock + } + } + + // Create lock object + lock = &etcdLock{ + client: s.client, + stopRenew: renewCh, + key: s.normalize(key), + value: value, + ttl: ttl, + } + + return lock, nil +} + +// Lock attempts to acquire the lock and blocks while +// doing so. It returns a channel that is closed if our +// lock is lost or if an error occurs +func (l *etcdLock) Lock(stopChan chan struct{}) (<-chan struct{}, error) { + + // Lock holder channel + lockHeld := make(chan struct{}) + stopLocking := l.stopRenew + + setOpts := &etcd.SetOptions{ + TTL: l.ttl, + } + + for { + setOpts.PrevExist = etcd.PrevNoExist + resp, err := l.client.Set(context.Background(), l.key, l.value, setOpts) + if err != nil { + if etcdError, ok := err.(etcd.Error); ok { + if etcdError.Code != etcd.ErrorCodeNodeExist { + return nil, err + } + setOpts.PrevIndex = ^uint64(0) + } + } else { + setOpts.PrevIndex = resp.Node.ModifiedIndex + } + + setOpts.PrevExist = etcd.PrevExist + l.last, err = l.client.Set(context.Background(), l.key, l.value, setOpts) + + if err == nil { + // Leader section + l.stopLock = stopLocking + go l.holdLock(l.key, lockHeld, stopLocking) + break + } else { + // If this is a legitimate error, return + if etcdError, ok := err.(etcd.Error); ok { + if etcdError.Code != etcd.ErrorCodeTestFailed { + return nil, err + } + } + + // Seeker section + errorCh := make(chan error) + chWStop := make(chan bool) + free := make(chan bool) + + go l.waitLock(l.key, errorCh, chWStop, free) + + // Wait for the key to be available or for + // a signal to stop trying to lock the key + select { + case _ = <-free: + break + case err := <-errorCh: + return nil, err + case _ = <-stopChan: + return nil, ErrAbortTryLock + } + + // Delete or Expire event occured + // Retry + } + } + + return lockHeld, nil +} + +// Hold the lock as long as we can +// Updates the key ttl periodically until we receive +// an explicit stop signal from the Unlock method +func (l *etcdLock) holdLock(key string, lockHeld chan struct{}, stopLocking <-chan struct{}) { + defer close(lockHeld) + + update := time.NewTicker(l.ttl / 3) + defer update.Stop() + + var err error + setOpts := &etcd.SetOptions{TTL: l.ttl} + + for { + select { + case <-update.C: + setOpts.PrevIndex = l.last.Node.ModifiedIndex + l.last, err = l.client.Set(context.Background(), key, l.value, setOpts) + if err != nil { + return + } + + case <-stopLocking: + return + } + } +} + +// WaitLock simply waits for the key to be available for creation +func (l *etcdLock) waitLock(key string, errorCh chan error, stopWatchCh chan bool, free chan<- bool) { + opts := &etcd.WatcherOptions{Recursive: false} + watcher := l.client.Watcher(key, opts) + + for { + event, err := watcher.Next(context.Background()) + if err != nil { + errorCh <- err + return + } + if event.Action == "delete" || event.Action == "expire" { + free <- true + return + } + } +} + +// Unlock the "key". Calling unlock while +// not holding the lock will throw an error +func (l *etcdLock) Unlock() error { + if l.stopLock != nil { + l.stopLock <- struct{}{} + } + if l.last != nil { + delOpts := &etcd.DeleteOptions{ + PrevIndex: l.last.Node.ModifiedIndex, + } + _, err := l.client.Delete(context.Background(), l.key, delOpts) + if err != nil { + return err + } + } + return nil +} + +// Close closes the client connection +func (s *Etcd) Close() { + return +} diff --git a/vendor/src/github.com/docker/libkv/store/helpers.go b/vendor/src/github.com/docker/libkv/store/helpers.go new file mode 100644 index 0000000000..0fb74c9ae1 --- /dev/null +++ b/vendor/src/github.com/docker/libkv/store/helpers.go @@ -0,0 +1,47 @@ +package store + +import ( + "strings" +) + +// CreateEndpoints creates a list of endpoints given the right scheme +func CreateEndpoints(addrs []string, scheme string) (entries []string) { + for _, addr := range addrs { + entries = append(entries, scheme+"://"+addr) + } + return entries +} + +// Normalize the key for each store to the form: +// +// /path/to/key +// +func Normalize(key string) string { + return "/" + join(SplitKey(key)) +} + +// GetDirectory gets the full directory part of +// the key to the form: +// +// /path/to/ +// +func GetDirectory(key string) string { + parts := SplitKey(key) + parts = parts[:len(parts)-1] + return "/" + join(parts) +} + +// SplitKey splits the key to extract path informations +func SplitKey(key string) (path []string) { + if strings.Contains(key, "/") { + path = strings.Split(key, "/") + } else { + path = []string{key} + } + return path +} + +// join the path parts with '/' +func join(parts []string) string { + return strings.Join(parts, "/") +} diff --git a/vendor/src/github.com/docker/libkv/store/store.go b/vendor/src/github.com/docker/libkv/store/store.go new file mode 100644 index 0000000000..0df01b6c83 --- /dev/null +++ b/vendor/src/github.com/docker/libkv/store/store.go @@ -0,0 +1,128 @@ +package store + +import ( + "crypto/tls" + "errors" + "time" +) + +// Backend represents a KV Store Backend +type Backend string + +const ( + // CONSUL backend + CONSUL Backend = "consul" + // ETCD backend + ETCD Backend = "etcd" + // ZK backend + ZK Backend = "zk" + // BOLTDB backend + BOLTDB Backend = "boltdb" +) + +var ( + // ErrBackendNotSupported is thrown when the backend k/v store is not supported by libkv + ErrBackendNotSupported = errors.New("Backend storage not supported yet, please choose one of") + // ErrCallNotSupported is thrown when a method is not implemented/supported by the current backend + ErrCallNotSupported = errors.New("The current call is not supported with this backend") + // ErrNotReachable is thrown when the API cannot be reached for issuing common store operations + ErrNotReachable = errors.New("Api not reachable") + // ErrCannotLock is thrown when there is an error acquiring a lock on a key + ErrCannotLock = errors.New("Error acquiring the lock") + // ErrKeyModified is thrown during an atomic operation if the index does not match the one in the store + ErrKeyModified = errors.New("Unable to complete atomic operation, key modified") + // ErrKeyNotFound is thrown when the key is not found in the store during a Get operation + ErrKeyNotFound = errors.New("Key not found in store") + // ErrPreviousNotSpecified is thrown when the previous value is not specified for an atomic operation + ErrPreviousNotSpecified = errors.New("Previous K/V pair should be provided for the Atomic operation") +) + +// Config contains the options for a storage client +type Config struct { + ClientTLS *ClientTLSConfig + TLS *tls.Config + ConnectionTimeout time.Duration + Bucket string + PersistConnection bool +} + +// ClientTLSConfig contains data for a Client TLS configuration in the form +// the etcd client wants it. Eventually we'll adapt it for ZK and Consul. +type ClientTLSConfig struct { + CertFile string + KeyFile string + CACertFile string +} + +// Store represents the backend K/V storage +// Each store should support every call listed +// here. Or it couldn't be implemented as a K/V +// backend for libkv +type Store interface { + // Put a value at the specified key + Put(key string, value []byte, options *WriteOptions) error + + // Get a value given its key + Get(key string) (*KVPair, error) + + // Delete the value at the specified key + Delete(key string) error + + // Verify if a Key exists in the store + Exists(key string) (bool, error) + + // Watch for changes on a key + Watch(key string, stopCh <-chan struct{}) (<-chan *KVPair, error) + + // WatchTree watches for changes on child nodes under + // a given directory + WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*KVPair, error) + + // NewLock creates a lock for a given key. + // The returned Locker is not held and must be acquired + // with `.Lock`. The Value is optional. + NewLock(key string, options *LockOptions) (Locker, error) + + // List the content of a given prefix + List(directory string) ([]*KVPair, error) + + // DeleteTree deletes a range of keys under a given directory + DeleteTree(directory string) error + + // Atomic CAS operation on a single value. + // Pass previous = nil to create a new key. + AtomicPut(key string, value []byte, previous *KVPair, options *WriteOptions) (bool, *KVPair, error) + + // Atomic delete of a single value + AtomicDelete(key string, previous *KVPair) (bool, error) + + // Close the store connection + Close() +} + +// KVPair represents {Key, Value, Lastindex} tuple +type KVPair struct { + Key string + Value []byte + LastIndex uint64 +} + +// WriteOptions contains optional request parameters +type WriteOptions struct { + IsDir bool + TTL time.Duration +} + +// LockOptions contains optional request parameters +type LockOptions struct { + Value []byte // Optional, value to associate with the lock + TTL time.Duration // Optional, expiration ttl associated with the lock + RenewLock chan struct{} // Optional, chan used to control and stop the session ttl renewal for the lock +} + +// Locker provides locking mechanism on top of the store. +// Similar to `sync.Lock` except it may return errors. +type Locker interface { + Lock(stopChan chan struct{}) (<-chan struct{}, error) + Unlock() error +} diff --git a/vendor/src/github.com/docker/libkv/store/zookeeper/zookeeper.go b/vendor/src/github.com/docker/libkv/store/zookeeper/zookeeper.go new file mode 100644 index 0000000000..502b1c6e85 --- /dev/null +++ b/vendor/src/github.com/docker/libkv/store/zookeeper/zookeeper.go @@ -0,0 +1,417 @@ +package zookeeper + +import ( + "strings" + "time" + + "github.com/docker/libkv" + "github.com/docker/libkv/store" + zk "github.com/samuel/go-zookeeper/zk" +) + +const ( + // SOH control character + SOH = "\x01" + + defaultTimeout = 10 * time.Second +) + +// Zookeeper is the receiver type for +// the Store interface +type Zookeeper struct { + timeout time.Duration + client *zk.Conn +} + +type zookeeperLock struct { + client *zk.Conn + lock *zk.Lock + key string + value []byte +} + +// Register registers zookeeper to libkv +func Register() { + libkv.AddStore(store.ZK, New) +} + +// New creates a new Zookeeper client given a +// list of endpoints and an optional tls config +func New(endpoints []string, options *store.Config) (store.Store, error) { + s := &Zookeeper{} + s.timeout = defaultTimeout + + // Set options + if options != nil { + if options.ConnectionTimeout != 0 { + s.setTimeout(options.ConnectionTimeout) + } + } + + // Connect to Zookeeper + conn, _, err := zk.Connect(endpoints, s.timeout) + if err != nil { + return nil, err + } + s.client = conn + + return s, nil +} + +// setTimeout sets the timeout for connecting to Zookeeper +func (s *Zookeeper) setTimeout(time time.Duration) { + s.timeout = time +} + +// Get the value at "key", returns the last modified index +// to use in conjunction to Atomic calls +func (s *Zookeeper) Get(key string) (pair *store.KVPair, err error) { + resp, meta, err := s.client.Get(s.normalize(key)) + + if err != nil { + if err == zk.ErrNoNode { + return nil, store.ErrKeyNotFound + } + return nil, err + } + + // FIXME handle very rare cases where Get returns the + // SOH control character instead of the actual value + if string(resp) == SOH { + return s.Get(store.Normalize(key)) + } + + pair = &store.KVPair{ + Key: key, + Value: resp, + LastIndex: uint64(meta.Version), + } + + return pair, nil +} + +// createFullPath creates the entire path for a directory +// that does not exist +func (s *Zookeeper) createFullPath(path []string, ephemeral bool) error { + for i := 1; i <= len(path); i++ { + newpath := "/" + strings.Join(path[:i], "/") + if i == len(path) && ephemeral { + _, err := s.client.Create(newpath, []byte{}, zk.FlagEphemeral, zk.WorldACL(zk.PermAll)) + return err + } + _, err := s.client.Create(newpath, []byte{}, 0, zk.WorldACL(zk.PermAll)) + if err != nil { + // Skip if node already exists + if err != zk.ErrNodeExists { + return err + } + } + } + return nil +} + +// Put a value at "key" +func (s *Zookeeper) Put(key string, value []byte, opts *store.WriteOptions) error { + fkey := s.normalize(key) + + exists, err := s.Exists(key) + if err != nil { + return err + } + + if !exists { + if opts != nil && opts.TTL > 0 { + s.createFullPath(store.SplitKey(strings.TrimSuffix(key, "/")), true) + } else { + s.createFullPath(store.SplitKey(strings.TrimSuffix(key, "/")), false) + } + } + + _, err = s.client.Set(fkey, value, -1) + return err +} + +// Delete a value at "key" +func (s *Zookeeper) Delete(key string) error { + err := s.client.Delete(s.normalize(key), -1) + if err == zk.ErrNoNode { + return store.ErrKeyNotFound + } + return err +} + +// Exists checks if the key exists inside the store +func (s *Zookeeper) Exists(key string) (bool, error) { + exists, _, err := s.client.Exists(s.normalize(key)) + if err != nil { + return false, err + } + return exists, nil +} + +// Watch for changes on a "key" +// It returns a channel that will receive changes or pass +// on errors. Upon creation, the current value will first +// be sent to the channel. Providing a non-nil stopCh can +// be used to stop watching. +func (s *Zookeeper) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + // Get the key first + pair, err := s.Get(key) + if err != nil { + return nil, err + } + + // Catch zk notifications and fire changes into the channel. + watchCh := make(chan *store.KVPair) + go func() { + defer close(watchCh) + + // Get returns the current value to the channel prior + // to listening to any event that may occur on that key + watchCh <- pair + for { + _, _, eventCh, err := s.client.GetW(s.normalize(key)) + if err != nil { + return + } + select { + case e := <-eventCh: + if e.Type == zk.EventNodeDataChanged { + if entry, err := s.Get(key); err == nil { + watchCh <- entry + } + } + case <-stopCh: + // There is no way to stop GetW so just quit + return + } + } + }() + + return watchCh, nil +} + +// WatchTree watches for changes on a "directory" +// It returns a channel that will receive changes or pass +// on errors. Upon creating a watch, the current childs values +// will be sent to the channel .Providing a non-nil stopCh can +// be used to stop watching. +func (s *Zookeeper) WatchTree(directory string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + // List the childrens first + entries, err := s.List(directory) + if err != nil { + return nil, err + } + + // Catch zk notifications and fire changes into the channel. + watchCh := make(chan []*store.KVPair) + go func() { + defer close(watchCh) + + // List returns the children values to the channel + // prior to listening to any events that may occur + // on those keys + watchCh <- entries + + for { + _, _, eventCh, err := s.client.ChildrenW(s.normalize(directory)) + if err != nil { + return + } + select { + case e := <-eventCh: + if e.Type == zk.EventNodeChildrenChanged { + if kv, err := s.List(directory); err == nil { + watchCh <- kv + } + } + case <-stopCh: + // There is no way to stop GetW so just quit + return + } + } + }() + + return watchCh, nil +} + +// List child nodes of a given directory +func (s *Zookeeper) List(directory string) ([]*store.KVPair, error) { + keys, stat, err := s.client.Children(s.normalize(directory)) + if err != nil { + if err == zk.ErrNoNode { + return nil, store.ErrKeyNotFound + } + return nil, err + } + + kv := []*store.KVPair{} + + // FIXME Costly Get request for each child key.. + for _, key := range keys { + pair, err := s.Get(strings.TrimSuffix(directory, "/") + s.normalize(key)) + if err != nil { + // If node is not found: List is out of date, retry + if err == zk.ErrNoNode { + return s.List(directory) + } + return nil, err + } + + kv = append(kv, &store.KVPair{ + Key: key, + Value: []byte(pair.Value), + LastIndex: uint64(stat.Version), + }) + } + + return kv, nil +} + +// DeleteTree deletes a range of keys under a given directory +func (s *Zookeeper) DeleteTree(directory string) error { + pairs, err := s.List(directory) + if err != nil { + return err + } + + var reqs []interface{} + + for _, pair := range pairs { + reqs = append(reqs, &zk.DeleteRequest{ + Path: s.normalize(directory + "/" + pair.Key), + Version: -1, + }) + } + + _, err = s.client.Multi(reqs...) + return err +} + +// AtomicPut put a value at "key" if the key has not been +// modified in the meantime, throws an error if this is the case +func (s *Zookeeper) AtomicPut(key string, value []byte, previous *store.KVPair, _ *store.WriteOptions) (bool, *store.KVPair, error) { + + var lastIndex uint64 + if previous != nil { + meta, err := s.client.Set(s.normalize(key), value, int32(previous.LastIndex)) + if err != nil { + // Compare Failed + if err == zk.ErrBadVersion { + return false, nil, store.ErrKeyModified + } + return false, nil, err + } + lastIndex = uint64(meta.Version) + } else { + // Interpret previous == nil as create operation. + _, err := s.client.Create(s.normalize(key), value, 0, zk.WorldACL(zk.PermAll)) + if err != nil { + // Zookeeper will complain if the directory doesn't exist. + if err == zk.ErrNoNode { + // Create the directory + parts := store.SplitKey(strings.TrimSuffix(key, "/")) + parts = parts[:len(parts)-1] + if err = s.createFullPath(parts, false); err != nil { + // Failed to create the directory. + return false, nil, err + } + if _, err := s.client.Create(s.normalize(key), value, 0, zk.WorldACL(zk.PermAll)); err != nil { + return false, nil, err + } + + } else { + // Unhandled error + return false, nil, err + } + } + lastIndex = 0 // Newly created nodes have version 0. + } + + pair := &store.KVPair{ + Key: key, + Value: value, + LastIndex: lastIndex, + } + + return true, pair, nil +} + +// AtomicDelete deletes a value at "key" if the key +// has not been modified in the meantime, throws an +// error if this is the case +func (s *Zookeeper) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + if previous == nil { + return false, store.ErrPreviousNotSpecified + } + + err := s.client.Delete(s.normalize(key), int32(previous.LastIndex)) + if err != nil { + // Key not found + if err == zk.ErrNoNode { + return false, store.ErrKeyNotFound + } + // Compare failed + if err == zk.ErrBadVersion { + return false, store.ErrKeyModified + } + // General store error + return false, err + } + return true, nil +} + +// NewLock returns a handle to a lock struct which can +// be used to provide mutual exclusion on a key +func (s *Zookeeper) NewLock(key string, options *store.LockOptions) (lock store.Locker, err error) { + value := []byte("") + + // Apply options + if options != nil { + if options.Value != nil { + value = options.Value + } + } + + lock = &zookeeperLock{ + client: s.client, + key: s.normalize(key), + value: value, + lock: zk.NewLock(s.client, s.normalize(key), zk.WorldACL(zk.PermAll)), + } + + return lock, err +} + +// Lock attempts to acquire the lock and blocks while +// doing so. It returns a channel that is closed if our +// lock is lost or if an error occurs +func (l *zookeeperLock) Lock(stopChan chan struct{}) (<-chan struct{}, error) { + err := l.lock.Lock() + + if err == nil { + // We hold the lock, we can set our value + // FIXME: The value is left behind + // (problematic for leader election) + _, err = l.client.Set(l.key, l.value, -1) + } + + return make(chan struct{}), err +} + +// Unlock the "key". Calling unlock while +// not holding the lock will throw an error +func (l *zookeeperLock) Unlock() error { + return l.lock.Unlock() +} + +// Close closes the client connection +func (s *Zookeeper) Close() { + s.client.Close() +} + +// Normalize the key for usage in Zookeeper +func (s *Zookeeper) normalize(key string) string { + key = store.Normalize(key) + return strings.TrimSuffix(key, "/") +} diff --git a/vendor/src/github.com/docker/libnetwork/.gitignore b/vendor/src/github.com/docker/libnetwork/.gitignore new file mode 100644 index 0000000000..0e0d489204 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/.gitignore @@ -0,0 +1,36 @@ +# Compiled Object files, Static and Dynamic libs (Shared Objects) +*.o +*.a +*.so + +# Folders +integration-tmp/ +_obj +_test + +# Architecture specific extensions/prefixes +*.[568vq] +[568vq].out + +*.cgo1.go +*.cgo2.c +_cgo_defun.c +_cgo_gotypes.go +_cgo_export.* + +_testmain.go + +*.exe +*.test +*.prof +cmd/dnet/dnet + +# Coverage +*.tmp +*.coverprofile + +# IDE files and folders +.project +.settings/ + +libnetwork-build.created diff --git a/vendor/src/github.com/docker/libnetwork/LICENSE b/vendor/src/github.com/docker/libnetwork/LICENSE new file mode 100644 index 0000000000..e06d208186 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/LICENSE @@ -0,0 +1,202 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + diff --git a/vendor/src/github.com/docker/libnetwork/MAINTAINERS b/vendor/src/github.com/docker/libnetwork/MAINTAINERS new file mode 100644 index 0000000000..69f1e9b880 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/MAINTAINERS @@ -0,0 +1,5 @@ +Alessandro Boch (@aboch) +Alexandr Morozov (@LK4D4) +Arnaud Porterie (@icecrime) +Jana Radhakrishnan (@mrjana) +Madhu Venugopal (@mavenugo) diff --git a/vendor/src/github.com/docker/libnetwork/Makefile b/vendor/src/github.com/docker/libnetwork/Makefile new file mode 100644 index 0000000000..b1eabf5223 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/Makefile @@ -0,0 +1,97 @@ +.PHONY: all all-local build build-local check check-code check-format run-tests check-local integration-tests install-deps coveralls circle-ci start-services clean +SHELL=/bin/bash +build_image=libnetworkbuild +dockerargs = --privileged -v $(shell pwd):/go/src/github.com/docker/libnetwork -w /go/src/github.com/docker/libnetwork +container_env = -e "INSIDECONTAINER=-incontainer=true" +docker = docker run --rm -it ${dockerargs} ${container_env} ${build_image} +ciargs = -e "COVERALLS_TOKEN=$$COVERALLS_TOKEN" -e "INSIDECONTAINER=-incontainer=true" +cidocker = docker run ${ciargs} ${dockerargs} golang:1.4 + +all: ${build_image}.created build check integration-tests clean + +integration-tests: ./cmd/dnet/dnet + @./test/integration/dnet/run-integration-tests.sh + +./cmd/dnet/dnet: + make build + +clean: + @if [ -e ./cmd/dnet/dnet ]; then \ + echo "Removing dnet binary"; \ + rm -rf ./cmd/dnet/dnet; \ + fi + +all-local: check-local build-local + +${build_image}.created: + docker run --name=libnetworkbuild -v $(shell pwd):/go/src/github.com/docker/libnetwork -w /go/src/github.com/docker/libnetwork golang:1.4 make install-deps + docker commit libnetworkbuild ${build_image} + docker rm libnetworkbuild + touch ${build_image}.created + +build: ${build_image}.created + @echo "Building code... " + @${docker} ./wrapmake.sh build-local + @echo "Done building code" + +build-local: + @$(shell which godep) go build ./... + @$(shell which godep) go build -o ./cmd/dnet/dnet ./cmd/dnet + +check: ${build_image}.created + @${docker} ./wrapmake.sh check-local + +check-code: + @echo "Checking code... " + test -z "$$(golint ./... | tee /dev/stderr)" + go vet ./... + @echo "Done checking code" + +check-format: + @echo "Checking format... " + test -z "$$(goimports -l . | grep -v Godeps/_workspace/src/ | tee /dev/stderr)" + @echo "Done checking format" + +run-tests: + @echo "Running tests... " + @echo "mode: count" > coverage.coverprofile + @for dir in $$(find . -maxdepth 10 -not -path './.git*' -not -path '*/_*' -type d); do \ + if ls $$dir/*.go &> /dev/null; then \ + pushd . &> /dev/null ; \ + cd $$dir ; \ + $(shell which godep) go test ${INSIDECONTAINER} -test.parallel 3 -test.v -covermode=count -coverprofile=./profile.tmp ; \ + ret=$$? ;\ + if [ $$ret -ne 0 ]; then exit $$ret; fi ;\ + popd &> /dev/null; \ + if [ -f $$dir/profile.tmp ]; then \ + cat $$dir/profile.tmp | tail -n +2 >> coverage.coverprofile ; \ + rm $$dir/profile.tmp ; \ + fi ; \ + fi ; \ + done + @echo "Done running tests" + +check-local: check-format check-code start-services run-tests + +install-deps: + apt-get update && apt-get -y install iptables zookeeperd + git clone https://github.com/golang/tools /go/src/golang.org/x/tools + go install golang.org/x/tools/cmd/vet + go install golang.org/x/tools/cmd/goimports + go install golang.org/x/tools/cmd/cover + go get github.com/tools/godep + go get github.com/golang/lint/golint + go get github.com/mattn/goveralls + +coveralls: + -@goveralls -service circleci -coverprofile=coverage.coverprofile -repotoken $$COVERALLS_TOKEN + +# CircleCI's Docker fails when cleaning up using the --rm flag +# The following target is a workaround for this + +circle-ci: + @${cidocker} make install-deps build-local check-local coveralls + make integration-tests + +start-services: + service zookeeper start diff --git a/vendor/src/github.com/docker/libnetwork/README.md b/vendor/src/github.com/docker/libnetwork/README.md new file mode 100644 index 0000000000..aa3fcbce4c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/README.md @@ -0,0 +1,83 @@ +# libnetwork - networking for containers + +[![Circle CI](https://circleci.com/gh/docker/libnetwork/tree/master.svg?style=svg)](https://circleci.com/gh/docker/libnetwork/tree/master) [![Coverage Status](https://coveralls.io/repos/docker/libnetwork/badge.svg)](https://coveralls.io/r/docker/libnetwork) [![GoDoc](https://godoc.org/github.com/docker/libnetwork?status.svg)](https://godoc.org/github.com/docker/libnetwork) + +Libnetwork provides a native Go implementation for connecting containers + +The goal of libnetwork is to deliver a robust Container Network Model that provides a consistent programming interface and the required network abstractions for applications. + +**NOTE**: libnetwork project is under heavy development and is not ready for general use. + +#### Design +Please refer to the [design](docs/design.md) for more information. + +#### Using libnetwork + +There are many networking solutions available to suit a broad range of use-cases. libnetwork uses a driver / plugin model to support all of these solutions while abstracting the complexity of the driver implementations by exposing a simple and consistent Network Model to users. + + +```go + // Select and configure the network driver + networkType := "bridge" + + // Create a new controller instance + driverOptions := options.Generic{} + genericOption := make(map[string]interface{}) + genericOption[netlabel.GenericData] = driverOptions + controller, err := libnetwork.New(config.OptionDriverConfig(networkType, genericOption)) + if err != nil { + return + } + + // Create a network for containers to join. + // NewNetwork accepts Variadic optional arguments that libnetwork and Drivers can use. + network, err := controller.NewNetwork(networkType, "network1") + if err != nil { + return + } + + // For each new container: allocate IP and interfaces. The returned network + // settings will be used for container infos (inspect and such), as well as + // iptables rules for port publishing. This info is contained or accessible + // from the returned endpoint. + ep, err := network.CreateEndpoint("Endpoint1") + if err != nil { + return + } + + // Create the sandbox for the container. + // NewSandbox accepts Variadic optional arguments which libnetwork can use. + sbx, err := controller.NewSandbox("container1", + libnetwork.OptionHostname("test"), + libnetwork.OptionDomainname("docker.io")) + + // A sandbox can join the endpoint via the join api. + err = ep.Join(sbx) + if err != nil { + return + } + + // libnetwork client can check the endpoint's operational data via the Info() API + epInfo, err := ep.DriverInfo() + mapData, ok := epInfo[netlabel.PortMap] + if ok { + portMapping, ok := mapData.([]types.PortBinding) + if ok { + fmt.Printf("Current port mapping for endpoint %s: %v", ep.Name(), portMapping) + } + } +``` +#### Current Status +Please watch this space for updates on the progress. + +Currently libnetwork is nothing more than an attempt to modularize the Docker platform's networking subsystem by moving it into libnetwork as a library. + +## Future +Please refer to [roadmap](ROADMAP.md) for more information. + +## Contributing + +Want to hack on libnetwork? [Docker's contributions guidelines](https://github.com/docker/docker/blob/master/CONTRIBUTING.md) apply. + +## Copyright and license +Code and documentation copyright 2015 Docker, inc. Code released under the Apache 2.0 license. Docs released under Creative commons. diff --git a/vendor/src/github.com/docker/libnetwork/ROADMAP.md b/vendor/src/github.com/docker/libnetwork/ROADMAP.md new file mode 100644 index 0000000000..9cb3174ec5 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ROADMAP.md @@ -0,0 +1,20 @@ +# Roadmap + +This document defines the high-level goals of the libnetwork project. See [Project Planning](#project-planning) for information on Releases. + +## Long-term Goal + +libnetwork project will follow Docker and Linux philosophy of delivering small, highly modular and composable tools that works well independently. +libnetwork aims to satisfy that composable need for Networking in Containers. + +## Short-term Goals + +- Modularize the networking logic in Docker Engine and libcontainer in to a single, reusable library +- Replace the networking subsystem of Docker Engine, with libnetwork +- Define a flexible model that allows local and remote drivers to provide networking to containers +- Provide a stand-alone tool "dnet" for managing and testing libnetwork + +Project Planning +================ + +[Project Pages](https://github.com/docker/libnetwork/wiki) define the goals for each Milestone and identify the release-relationship to the Docker Platform. diff --git a/vendor/src/github.com/docker/libnetwork/bitseq/sequence.go b/vendor/src/github.com/docker/libnetwork/bitseq/sequence.go new file mode 100644 index 0000000000..422cb9fe42 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/bitseq/sequence.go @@ -0,0 +1,620 @@ +// Package bitseq provides a structure and utilities for representing long bitmask +// as sequence of run-lenght encoded blocks. It operates direclty on the encoded +// representation, it does not decode/encode. +package bitseq + +import ( + "encoding/binary" + "encoding/json" + "fmt" + "sync" + + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/types" +) + +// block sequence constants +// If needed we can think of making these configurable +const ( + blockLen = uint32(32) + blockBytes = uint64(blockLen / 8) + blockMAX = uint32(1<%s", s.block, s.count, nextBlock) +} + +// GetAvailableBit returns the position of the first unset bit in the bitmask represented by this sequence +func (s *sequence) getAvailableBit(from uint64) (uint64, uint64, error) { + if s.block == blockMAX || s.count == 0 { + return invalidPos, invalidPos, errNoBitAvailable + } + bits := from + bitSel := blockFirstBit >> from + for bitSel > 0 && s.block&bitSel != 0 { + bitSel >>= 1 + bits++ + } + return bits / 8, bits % 8, nil +} + +// GetCopy returns a copy of the linked list rooted at this node +func (s *sequence) getCopy() *sequence { + n := &sequence{block: s.block, count: s.count} + pn := n + ps := s.next + for ps != nil { + pn.next = &sequence{block: ps.block, count: ps.count} + pn = pn.next + ps = ps.next + } + return n +} + +// Equal checks if this sequence is equal to the passed one +func (s *sequence) equal(o *sequence) bool { + this := s + other := o + for this != nil { + if other == nil { + return false + } + if this.block != other.block || this.count != other.count { + return false + } + this = this.next + other = other.next + } + // Check if other is longer than this + if other != nil { + return false + } + return true +} + +// ToByteArray converts the sequence into a byte array +func (s *sequence) toByteArray() ([]byte, error) { + var bb []byte + + p := s + for p != nil { + b := make([]byte, 12) + binary.BigEndian.PutUint32(b[0:], p.block) + binary.BigEndian.PutUint64(b[4:], p.count) + bb = append(bb, b...) + p = p.next + } + + return bb, nil +} + +// fromByteArray construct the sequence from the byte array +func (s *sequence) fromByteArray(data []byte) error { + l := len(data) + if l%12 != 0 { + return fmt.Errorf("cannot deserialize byte sequence of lenght %d (%v)", l, data) + } + + p := s + i := 0 + for { + p.block = binary.BigEndian.Uint32(data[i : i+4]) + p.count = binary.BigEndian.Uint64(data[i+4 : i+12]) + i += 12 + if i == l { + break + } + p.next = &sequence{} + p = p.next + } + + return nil +} + +func (h *Handle) getCopy() *Handle { + return &Handle{ + bits: h.bits, + unselected: h.unselected, + head: h.head.getCopy(), + app: h.app, + id: h.id, + dbIndex: h.dbIndex, + dbExists: h.dbExists, + store: h.store, + } +} + +// SetAnyInRange atomically sets the first unset bit in the specified range in the sequence and returns the corresponding ordinal +func (h *Handle) SetAnyInRange(start, end uint64) (uint64, error) { + if end-start <= 0 || end >= h.bits { + return invalidPos, fmt.Errorf("invalid bit range [%d, %d]", start, end) + } + if h.Unselected() == 0 { + return invalidPos, errNoBitAvailable + } + return h.set(0, start, end, true, false) +} + +// SetAny atomically sets the first unset bit in the sequence and returns the corresponding ordinal +func (h *Handle) SetAny() (uint64, error) { + if h.Unselected() == 0 { + return invalidPos, errNoBitAvailable + } + return h.set(0, 0, h.bits-1, true, false) +} + +// Set atomically sets the corresponding bit in the sequence +func (h *Handle) Set(ordinal uint64) error { + if err := h.validateOrdinal(ordinal); err != nil { + return err + } + _, err := h.set(ordinal, 0, 0, false, false) + return err +} + +// Unset atomically unsets the corresponding bit in the sequence +func (h *Handle) Unset(ordinal uint64) error { + if err := h.validateOrdinal(ordinal); err != nil { + return err + } + _, err := h.set(ordinal, 0, 0, false, true) + return err +} + +// IsSet atomically checks if the ordinal bit is set. In case ordinal +// is outside of the bit sequence limits, false is returned. +func (h *Handle) IsSet(ordinal uint64) bool { + if err := h.validateOrdinal(ordinal); err != nil { + return false + } + h.Lock() + _, _, err := checkIfAvailable(h.head, ordinal) + h.Unlock() + return err != nil +} + +// set/reset the bit +func (h *Handle) set(ordinal, start, end uint64, any bool, release bool) (uint64, error) { + var ( + bitPos uint64 + bytePos uint64 + ret uint64 + err error + ) + + for { + var store datastore.DataStore + h.Lock() + store = h.store + h.Unlock() + if store != nil { + if err := store.GetObject(datastore.Key(h.Key()...), h); err != nil && err != datastore.ErrKeyNotFound { + return ret, err + } + } + + h.Lock() + // Get position if available + if release { + bytePos, bitPos = ordinalToPos(ordinal) + } else { + if any { + bytePos, bitPos, err = getFirstAvailable(h.head, start) + ret = posToOrdinal(bytePos, bitPos) + if end < ret { + err = errNoBitAvailable + } + } else { + bytePos, bitPos, err = checkIfAvailable(h.head, ordinal) + ret = ordinal + } + } + if err != nil { + h.Unlock() + return ret, err + } + + // Create a private copy of h and work on it + nh := h.getCopy() + h.Unlock() + + nh.head = pushReservation(bytePos, bitPos, nh.head, release) + if release { + nh.unselected++ + } else { + nh.unselected-- + } + + // Attempt to write private copy to store + if err := nh.writeToStore(); err != nil { + if _, ok := err.(types.RetryError); !ok { + return ret, fmt.Errorf("internal failure while setting the bit: %v", err) + } + // Retry + continue + } + + // Previous atomic push was succesfull. Save private copy to local copy + h.Lock() + defer h.Unlock() + h.unselected = nh.unselected + h.head = nh.head + h.dbExists = nh.dbExists + h.dbIndex = nh.dbIndex + return ret, nil + } +} + +// checks is needed because to cover the case where the number of bits is not a multiple of blockLen +func (h *Handle) validateOrdinal(ordinal uint64) error { + if ordinal >= h.bits { + return fmt.Errorf("bit does not belong to the sequence") + } + return nil +} + +// Destroy removes from the datastore the data belonging to this handle +func (h *Handle) Destroy() error { + for { + if err := h.deleteFromStore(); err != nil { + if _, ok := err.(types.RetryError); !ok { + return fmt.Errorf("internal failure while destroying the sequence: %v", err) + } + // Fetch latest + if err := h.store.GetObject(datastore.Key(h.Key()...), h); err != nil { + if err == datastore.ErrKeyNotFound { // already removed + return nil + } + return fmt.Errorf("failed to fetch from store when destroying the sequence: %v", err) + } + continue + } + return nil + } +} + +// ToByteArray converts this handle's data into a byte array +func (h *Handle) ToByteArray() ([]byte, error) { + + h.Lock() + defer h.Unlock() + ba := make([]byte, 16) + binary.BigEndian.PutUint64(ba[0:], h.bits) + binary.BigEndian.PutUint64(ba[8:], h.unselected) + bm, err := h.head.toByteArray() + if err != nil { + return nil, fmt.Errorf("failed to serialize head: %s", err.Error()) + } + ba = append(ba, bm...) + + return ba, nil +} + +// FromByteArray reads his handle's data from a byte array +func (h *Handle) FromByteArray(ba []byte) error { + if ba == nil { + return fmt.Errorf("nil byte array") + } + + nh := &sequence{} + err := nh.fromByteArray(ba[16:]) + if err != nil { + return fmt.Errorf("failed to deserialize head: %s", err.Error()) + } + + h.Lock() + h.head = nh + h.bits = binary.BigEndian.Uint64(ba[0:8]) + h.unselected = binary.BigEndian.Uint64(ba[8:16]) + h.Unlock() + + return nil +} + +// Bits returns the length of the bit sequence +func (h *Handle) Bits() uint64 { + return h.bits +} + +// Unselected returns the number of bits which are not selected +func (h *Handle) Unselected() uint64 { + h.Lock() + defer h.Unlock() + return h.unselected +} + +func (h *Handle) String() string { + h.Lock() + defer h.Unlock() + return fmt.Sprintf("App: %s, ID: %s, DBIndex: 0x%x, bits: %d, unselected: %d, sequence: %s", + h.app, h.id, h.dbIndex, h.bits, h.unselected, h.head.toString()) +} + +// MarshalJSON encodes Handle into json message +func (h *Handle) MarshalJSON() ([]byte, error) { + m := map[string]interface{}{ + "id": h.id, + } + + b, err := h.ToByteArray() + if err != nil { + return nil, err + } + m["sequence"] = b + return json.Marshal(m) +} + +// UnmarshalJSON decodes json message into Handle +func (h *Handle) UnmarshalJSON(data []byte) error { + var ( + m map[string]interface{} + b []byte + err error + ) + if err = json.Unmarshal(data, &m); err != nil { + return err + } + h.id = m["id"].(string) + bi, _ := json.Marshal(m["sequence"]) + if err := json.Unmarshal(bi, &b); err != nil { + return err + } + return h.FromByteArray(b) +} + +// getFirstAvailable looks for the first unset bit in passed mask starting from start +func getFirstAvailable(head *sequence, start uint64) (uint64, uint64, error) { + // Find sequence which contains the start bit + byteStart, bitStart := ordinalToPos(start) + current, _, _, inBlockBytePos := findSequence(head, byteStart) + + // Derive the this sequence offsets + byteOffset := byteStart - inBlockBytePos + bitOffset := inBlockBytePos*8 + bitStart + + for current != nil { + if current.block != blockMAX { + bytePos, bitPos, err := current.getAvailableBit(bitOffset) + return byteOffset + bytePos, bitPos, err + } + // Moving to next block: Reset bit offset. + bitOffset = 0 + byteOffset += current.count * blockBytes + current = current.next + } + return invalidPos, invalidPos, errNoBitAvailable +} + +// checkIfAvailable checks if the bit correspondent to the specified ordinal is unset +// If the ordinal is beyond the sequence limits, a negative response is returned +func checkIfAvailable(head *sequence, ordinal uint64) (uint64, uint64, error) { + bytePos, bitPos := ordinalToPos(ordinal) + + // Find the sequence containing this byte + current, _, _, inBlockBytePos := findSequence(head, bytePos) + if current != nil { + // Check whether the bit corresponding to the ordinal address is unset + bitSel := blockFirstBit >> (inBlockBytePos*8 + bitPos) + if current.block&bitSel == 0 { + return bytePos, bitPos, nil + } + } + + return invalidPos, invalidPos, fmt.Errorf("requested bit is not available") +} + +// Given the byte position and the sequences list head, return the pointer to the +// sequence containing the byte (current), the pointer to the previous sequence, +// the number of blocks preceding the block containing the byte inside the current sequence. +// If bytePos is outside of the list, function will return (nil, nil, 0, invalidPos) +func findSequence(head *sequence, bytePos uint64) (*sequence, *sequence, uint64, uint64) { + // Find the sequence containing this byte + previous := head + current := head + n := bytePos + for current.next != nil && n >= (current.count*blockBytes) { // Nil check for less than 32 addresses masks + n -= (current.count * blockBytes) + previous = current + current = current.next + } + + // If byte is outside of the list, let caller know + if n >= (current.count * blockBytes) { + return nil, nil, 0, invalidPos + } + + // Find the byte position inside the block and the number of blocks + // preceding the block containing the byte inside this sequence + precBlocks := n / blockBytes + inBlockBytePos := bytePos % blockBytes + + return current, previous, precBlocks, inBlockBytePos +} + +// PushReservation pushes the bit reservation inside the bitmask. +// Given byte and bit positions, identify the sequence (current) which holds the block containing the affected bit. +// Create a new block with the modified bit according to the operation (allocate/release). +// Create a new sequence containing the new block and insert it in the proper position. +// Remove current sequence if empty. +// Check if new sequence can be merged with neighbour (previous/next) sequences. +// +// +// Identify "current" sequence containing block: +// [prev seq] [current seq] [next seq] +// +// Based on block position, resulting list of sequences can be any of three forms: +// +// block position Resulting list of sequences +// A) block is first in current: [prev seq] [new] [modified current seq] [next seq] +// B) block is last in current: [prev seq] [modified current seq] [new] [next seq] +// C) block is in the middle of current: [prev seq] [curr pre] [new] [curr post] [next seq] +func pushReservation(bytePos, bitPos uint64, head *sequence, release bool) *sequence { + // Store list's head + newHead := head + + // Find the sequence containing this byte + current, previous, precBlocks, inBlockBytePos := findSequence(head, bytePos) + if current == nil { + return newHead + } + + // Construct updated block + bitSel := blockFirstBit >> (inBlockBytePos*8 + bitPos) + newBlock := current.block + if release { + newBlock &^= bitSel + } else { + newBlock |= bitSel + } + + // Quit if it was a redundant request + if current.block == newBlock { + return newHead + } + + // Current sequence inevitably looses one block, upadate count + current.count-- + + // Create new sequence + newSequence := &sequence{block: newBlock, count: 1} + + // Insert the new sequence in the list based on block position + if precBlocks == 0 { // First in sequence (A) + newSequence.next = current + if current == head { + newHead = newSequence + previous = newHead + } else { + previous.next = newSequence + } + removeCurrentIfEmpty(&newHead, newSequence, current) + mergeSequences(previous) + } else if precBlocks == current.count { // Last in sequence (B) + newSequence.next = current.next + current.next = newSequence + mergeSequences(current) + } else { // In between the sequence (C) + currPre := &sequence{block: current.block, count: precBlocks, next: newSequence} + currPost := current + currPost.count -= precBlocks + newSequence.next = currPost + if currPost == head { + newHead = currPre + } else { + previous.next = currPre + } + // No merging or empty current possible here + } + + return newHead +} + +// Removes the current sequence from the list if empty, adjusting the head pointer if needed +func removeCurrentIfEmpty(head **sequence, previous, current *sequence) { + if current.count == 0 { + if current == *head { + *head = current.next + } else { + previous.next = current.next + current = current.next + } + } +} + +// Given a pointer to a sequence, it checks if it can be merged with any following sequences +// It stops when no more merging is possible. +// TODO: Optimization: only attempt merge from start to end sequence, no need to scan till the end of the list +func mergeSequences(seq *sequence) { + if seq != nil { + // Merge all what possible from seq + for seq.next != nil && seq.block == seq.next.block { + seq.count += seq.next.count + seq.next = seq.next.next + } + // Move to next + mergeSequences(seq.next) + } +} + +func getNumBlocks(numBits uint64) uint64 { + numBlocks := numBits / uint64(blockLen) + if numBits%uint64(blockLen) != 0 { + numBlocks++ + } + return numBlocks +} + +func ordinalToPos(ordinal uint64) (uint64, uint64) { + return ordinal / 8, ordinal % 8 +} + +func posToOrdinal(bytePos, bitPos uint64) uint64 { + return bytePos*8 + bitPos +} diff --git a/vendor/src/github.com/docker/libnetwork/bitseq/store.go b/vendor/src/github.com/docker/libnetwork/bitseq/store.go new file mode 100644 index 0000000000..df50331227 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/bitseq/store.go @@ -0,0 +1,136 @@ +package bitseq + +import ( + "encoding/json" + "fmt" + + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/types" +) + +// Key provides the Key to be used in KV Store +func (h *Handle) Key() []string { + h.Lock() + defer h.Unlock() + return []string{h.app, h.id} +} + +// KeyPrefix returns the immediate parent key that can be used for tree walk +func (h *Handle) KeyPrefix() []string { + h.Lock() + defer h.Unlock() + return []string{h.app} +} + +// Value marshals the data to be stored in the KV store +func (h *Handle) Value() []byte { + b, err := json.Marshal(h) + if err != nil { + return nil + } + return b +} + +// SetValue unmarshals the data from the KV store +func (h *Handle) SetValue(value []byte) error { + return json.Unmarshal(value, h) +} + +// Index returns the latest DB Index as seen by this object +func (h *Handle) Index() uint64 { + h.Lock() + defer h.Unlock() + return h.dbIndex +} + +// SetIndex method allows the datastore to store the latest DB Index into this object +func (h *Handle) SetIndex(index uint64) { + h.Lock() + h.dbIndex = index + h.dbExists = true + h.Unlock() +} + +// Exists method is true if this object has been stored in the DB. +func (h *Handle) Exists() bool { + h.Lock() + defer h.Unlock() + return h.dbExists +} + +// New method returns a handle based on the receiver handle +func (h *Handle) New() datastore.KVObject { + h.Lock() + defer h.Unlock() + + return &Handle{ + app: h.app, + store: h.store, + } +} + +// CopyTo deep copies the handle into the passed destination object +func (h *Handle) CopyTo(o datastore.KVObject) error { + h.Lock() + defer h.Unlock() + + dstH := o.(*Handle) + dstH.bits = h.bits + dstH.unselected = h.unselected + dstH.head = h.head.getCopy() + dstH.app = h.app + dstH.id = h.id + dstH.dbIndex = h.dbIndex + dstH.dbExists = h.dbExists + dstH.store = h.store + + return nil +} + +// Skip provides a way for a KV Object to avoid persisting it in the KV Store +func (h *Handle) Skip() bool { + return false +} + +// DataScope method returns the storage scope of the datastore +func (h *Handle) DataScope() string { + h.Lock() + defer h.Unlock() + + return h.store.Scope() +} + +func (h *Handle) fromDsValue(value []byte) error { + var ba []byte + if err := json.Unmarshal(value, &ba); err != nil { + return fmt.Errorf("failed to decode json: %s", err.Error()) + } + if err := h.FromByteArray(ba); err != nil { + return fmt.Errorf("failed to decode handle: %s", err.Error()) + } + return nil +} + +func (h *Handle) writeToStore() error { + h.Lock() + store := h.store + h.Unlock() + if store == nil { + return nil + } + err := store.PutObjectAtomic(h) + if err == datastore.ErrKeyModified { + return types.RetryErrorf("failed to perform atomic write (%v). Retry might fix the error", err) + } + return err +} + +func (h *Handle) deleteFromStore() error { + h.Lock() + store := h.store + h.Unlock() + if store == nil { + return nil + } + return store.DeleteObjectAtomic(h) +} diff --git a/vendor/src/github.com/docker/libnetwork/circle.yml b/vendor/src/github.com/docker/libnetwork/circle.yml new file mode 100644 index 0000000000..d02f6a92ed --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/circle.yml @@ -0,0 +1,12 @@ +machine: + services: + - docker + +dependencies: + override: + - echo "Nothing to install" + +test: + override: + - make circle-ci + diff --git a/vendor/src/github.com/docker/libnetwork/config/config.go b/vendor/src/github.com/docker/libnetwork/config/config.go new file mode 100644 index 0000000000..80d2fc3af7 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/config/config.go @@ -0,0 +1,227 @@ +package config + +import ( + "strings" + + "github.com/BurntSushi/toml" + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/discovery" + "github.com/docker/docker/pkg/tlsconfig" + "github.com/docker/libkv/store" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/netlabel" +) + +// Config encapsulates configurations of various Libnetwork components +type Config struct { + Daemon DaemonCfg + Cluster ClusterCfg + Scopes map[string]*datastore.ScopeCfg +} + +// DaemonCfg represents libnetwork core configuration +type DaemonCfg struct { + Debug bool + DataDir string + DefaultNetwork string + DefaultDriver string + Labels []string + DriverCfg map[string]interface{} +} + +// ClusterCfg represents cluster configuration +type ClusterCfg struct { + Watcher discovery.Watcher + Address string + Discovery string + Heartbeat uint64 +} + +// LoadDefaultScopes loads default scope configs for scopes which +// doesn't have explicit user specified configs. +func (c *Config) LoadDefaultScopes(dataDir string) { + for k, v := range datastore.DefaultScopes(dataDir) { + if _, ok := c.Scopes[k]; !ok { + c.Scopes[k] = v + } + } +} + +// ParseConfig parses the libnetwork configuration file +func ParseConfig(tomlCfgFile string) (*Config, error) { + cfg := &Config{ + Scopes: map[string]*datastore.ScopeCfg{}, + } + + if _, err := toml.DecodeFile(tomlCfgFile, cfg); err != nil { + return nil, err + } + + cfg.LoadDefaultScopes(cfg.Daemon.DataDir) + return cfg, nil +} + +// Option is a option setter function type used to pass varios configurations +// to the controller +type Option func(c *Config) + +// OptionDefaultNetwork function returns an option setter for a default network +func OptionDefaultNetwork(dn string) Option { + return func(c *Config) { + log.Debugf("Option DefaultNetwork: %s", dn) + c.Daemon.DefaultNetwork = strings.TrimSpace(dn) + } +} + +// OptionDefaultDriver function returns an option setter for default driver +func OptionDefaultDriver(dd string) Option { + return func(c *Config) { + log.Debugf("Option DefaultDriver: %s", dd) + c.Daemon.DefaultDriver = strings.TrimSpace(dd) + } +} + +// OptionDriverConfig returns an option setter for driver configuration. +func OptionDriverConfig(networkType string, config map[string]interface{}) Option { + return func(c *Config) { + c.Daemon.DriverCfg[networkType] = config + } +} + +// OptionLabels function returns an option setter for labels +func OptionLabels(labels []string) Option { + return func(c *Config) { + for _, label := range labels { + if strings.HasPrefix(label, netlabel.Prefix) { + c.Daemon.Labels = append(c.Daemon.Labels, label) + } + } + } +} + +// OptionKVProvider function returns an option setter for kvstore provider +func OptionKVProvider(provider string) Option { + return func(c *Config) { + log.Debugf("Option OptionKVProvider: %s", provider) + if _, ok := c.Scopes[datastore.GlobalScope]; !ok { + c.Scopes[datastore.GlobalScope] = &datastore.ScopeCfg{} + } + c.Scopes[datastore.GlobalScope].Client.Provider = strings.TrimSpace(provider) + } +} + +// OptionKVProviderURL function returns an option setter for kvstore url +func OptionKVProviderURL(url string) Option { + return func(c *Config) { + log.Debugf("Option OptionKVProviderURL: %s", url) + if _, ok := c.Scopes[datastore.GlobalScope]; !ok { + c.Scopes[datastore.GlobalScope] = &datastore.ScopeCfg{} + } + c.Scopes[datastore.GlobalScope].Client.Address = strings.TrimSpace(url) + } +} + +// OptionKVOpts function returns an option setter for kvstore options +func OptionKVOpts(opts map[string]string) Option { + return func(c *Config) { + if opts["kv.cacertfile"] != "" && opts["kv.certfile"] != "" && opts["kv.keyfile"] != "" { + log.Info("Option Initializing KV with TLS") + tlsConfig, err := tlsconfig.Client(tlsconfig.Options{ + CAFile: opts["kv.cacertfile"], + CertFile: opts["kv.certfile"], + KeyFile: opts["kv.keyfile"], + }) + if err != nil { + log.Errorf("Unable to set up TLS: %s", err) + return + } + if _, ok := c.Scopes[datastore.GlobalScope]; !ok { + c.Scopes[datastore.GlobalScope] = &datastore.ScopeCfg{} + } + if c.Scopes[datastore.GlobalScope].Client.Config == nil { + c.Scopes[datastore.GlobalScope].Client.Config = &store.Config{TLS: tlsConfig} + } else { + c.Scopes[datastore.GlobalScope].Client.Config.TLS = tlsConfig + } + // Workaround libkv/etcd bug for https + c.Scopes[datastore.GlobalScope].Client.Config.ClientTLS = &store.ClientTLSConfig{ + CACertFile: opts["kv.cacertfile"], + CertFile: opts["kv.certfile"], + KeyFile: opts["kv.keyfile"], + } + } else { + log.Info("Option Initializing KV without TLS") + } + } +} + +// OptionDiscoveryWatcher function returns an option setter for discovery watcher +func OptionDiscoveryWatcher(watcher discovery.Watcher) Option { + return func(c *Config) { + c.Cluster.Watcher = watcher + } +} + +// OptionDiscoveryAddress function returns an option setter for self discovery address +func OptionDiscoveryAddress(address string) Option { + return func(c *Config) { + c.Cluster.Address = address + } +} + +// OptionDataDir function returns an option setter for data folder +func OptionDataDir(dataDir string) Option { + return func(c *Config) { + c.Daemon.DataDir = dataDir + } +} + +// ProcessOptions processes options and stores it in config +func (c *Config) ProcessOptions(options ...Option) { + for _, opt := range options { + if opt != nil { + opt(c) + } + } +} + +// IsValidName validates configuration objects supported by libnetwork +func IsValidName(name string) bool { + if strings.TrimSpace(name) == "" { + return false + } + return true +} + +// OptionLocalKVProvider function returns an option setter for kvstore provider +func OptionLocalKVProvider(provider string) Option { + return func(c *Config) { + log.Debugf("Option OptionLocalKVProvider: %s", provider) + if _, ok := c.Scopes[datastore.LocalScope]; !ok { + c.Scopes[datastore.LocalScope] = &datastore.ScopeCfg{} + } + c.Scopes[datastore.LocalScope].Client.Provider = strings.TrimSpace(provider) + } +} + +// OptionLocalKVProviderURL function returns an option setter for kvstore url +func OptionLocalKVProviderURL(url string) Option { + return func(c *Config) { + log.Debugf("Option OptionLocalKVProviderURL: %s", url) + if _, ok := c.Scopes[datastore.LocalScope]; !ok { + c.Scopes[datastore.LocalScope] = &datastore.ScopeCfg{} + } + c.Scopes[datastore.LocalScope].Client.Address = strings.TrimSpace(url) + } +} + +// OptionLocalKVProviderConfig function returns an option setter for kvstore config +func OptionLocalKVProviderConfig(config *store.Config) Option { + return func(c *Config) { + log.Debugf("Option OptionLocalKVProviderConfig: %v", config) + if _, ok := c.Scopes[datastore.LocalScope]; !ok { + c.Scopes[datastore.LocalScope] = &datastore.ScopeCfg{} + } + c.Scopes[datastore.LocalScope].Client.Config = config + } +} diff --git a/vendor/src/github.com/docker/libnetwork/config/libnetwork.toml b/vendor/src/github.com/docker/libnetwork/config/libnetwork.toml new file mode 100644 index 0000000000..93a2ff4756 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/config/libnetwork.toml @@ -0,0 +1,12 @@ +title = "LibNetwork Configuration file" + +[daemon] + debug = false +[cluster] + discovery = "token://swarm-discovery-token" + Address = "Cluster-wide reachable Host IP" +[datastore] + embedded = false +[datastore.client] + provider = "consul" + Address = "localhost:8500" diff --git a/vendor/src/github.com/docker/libnetwork/controller.go b/vendor/src/github.com/docker/libnetwork/controller.go new file mode 100644 index 0000000000..e1d8277fac --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/controller.go @@ -0,0 +1,698 @@ +/* +Package libnetwork provides the basic functionality and extension points to +create network namespaces and allocate interfaces for containers to use. + + networkType := "bridge" + + // Create a new controller instance + driverOptions := options.Generic{} + genericOption := make(map[string]interface{}) + genericOption[netlabel.GenericData] = driverOptions + controller, err := libnetwork.New(config.OptionDriverConfig(networkType, genericOption)) + if err != nil { + return + } + + // Create a network for containers to join. + // NewNetwork accepts Variadic optional arguments that libnetwork and Drivers can make use of + network, err := controller.NewNetwork(networkType, "network1") + if err != nil { + return + } + + // For each new container: allocate IP and interfaces. The returned network + // settings will be used for container infos (inspect and such), as well as + // iptables rules for port publishing. This info is contained or accessible + // from the returned endpoint. + ep, err := network.CreateEndpoint("Endpoint1") + if err != nil { + return + } + + // Create the sandbox for the container. + // NewSandbox accepts Variadic optional arguments which libnetwork can use. + sbx, err := controller.NewSandbox("container1", + libnetwork.OptionHostname("test"), + libnetwork.OptionDomainname("docker.io")) + + // A sandbox can join the endpoint via the join api. + err = ep.Join(sbx) + if err != nil { + return + } +*/ +package libnetwork + +import ( + "container/heap" + "fmt" + "net" + "strings" + "sync" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/discovery" + "github.com/docker/docker/pkg/plugins" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/libnetwork/config" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/hostdiscovery" + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/osl" + "github.com/docker/libnetwork/types" +) + +// NetworkController provides the interface for controller instance which manages +// networks. +type NetworkController interface { + // ID provides an unique identity for the controller + ID() string + + // Config method returns the bootup configuration for the controller + Config() config.Config + + // Create a new network. The options parameter carries network specific options. + NewNetwork(networkType, name string, options ...NetworkOption) (Network, error) + + // Networks returns the list of Network(s) managed by this controller. + Networks() []Network + + // WalkNetworks uses the provided function to walk the Network(s) managed by this controller. + WalkNetworks(walker NetworkWalker) + + // NetworkByName returns the Network which has the passed name. If not found, the error ErrNoSuchNetwork is returned. + NetworkByName(name string) (Network, error) + + // NetworkByID returns the Network which has the passed id. If not found, the error ErrNoSuchNetwork is returned. + NetworkByID(id string) (Network, error) + + // NewSandbox cretes a new network sandbox for the passed container id + NewSandbox(containerID string, options ...SandboxOption) (Sandbox, error) + + // Sandboxes returns the list of Sandbox(s) managed by this controller. + Sandboxes() []Sandbox + + // WlakSandboxes uses the provided function to walk the Sandbox(s) managed by this controller. + WalkSandboxes(walker SandboxWalker) + + // SandboxByID returns the Sandbox which has the passed id. If not found, a types.NotFoundError is returned. + SandboxByID(id string) (Sandbox, error) + + // SandboxDestroy destroys a sandbox given a container ID + SandboxDestroy(id string) error + + // Stop network controller + Stop() +} + +// NetworkWalker is a client provided function which will be used to walk the Networks. +// When the function returns true, the walk will stop. +type NetworkWalker func(nw Network) bool + +// SandboxWalker is a client provided function which will be used to walk the Sandboxes. +// When the function returns true, the walk will stop. +type SandboxWalker func(sb Sandbox) bool + +type driverData struct { + driver driverapi.Driver + capability driverapi.Capability +} + +type ipamData struct { + driver ipamapi.Ipam + // default address spaces are provided by ipam driver at registration time + defaultLocalAddressSpace, defaultGlobalAddressSpace string +} + +type driverTable map[string]*driverData + +type ipamTable map[string]*ipamData +type sandboxTable map[string]*sandbox + +type controller struct { + id string + drivers driverTable + ipamDrivers ipamTable + sandboxes sandboxTable + cfg *config.Config + stores []datastore.DataStore + discovery hostdiscovery.HostDiscovery + extKeyListener net.Listener + watchCh chan *endpoint + unWatchCh chan *endpoint + svcDb map[string]svcMap + nmap map[string]*netWatch + defOsSbox osl.Sandbox + sboxOnce sync.Once + sync.Mutex +} + +// New creates a new instance of network controller. +func New(cfgOptions ...config.Option) (NetworkController, error) { + var cfg *config.Config + cfg = &config.Config{ + Daemon: config.DaemonCfg{ + DriverCfg: make(map[string]interface{}), + }, + Scopes: make(map[string]*datastore.ScopeCfg), + } + + if len(cfgOptions) > 0 { + cfg.ProcessOptions(cfgOptions...) + } + cfg.LoadDefaultScopes(cfg.Daemon.DataDir) + + c := &controller{ + id: stringid.GenerateRandomID(), + cfg: cfg, + sandboxes: sandboxTable{}, + drivers: driverTable{}, + ipamDrivers: ipamTable{}, + svcDb: make(map[string]svcMap), + } + + if err := c.initStores(); err != nil { + return nil, err + } + + if cfg != nil && cfg.Cluster.Watcher != nil { + if err := c.initDiscovery(cfg.Cluster.Watcher); err != nil { + // Failing to initalize discovery is a bad situation to be in. + // But it cannot fail creating the Controller + log.Errorf("Failed to Initialize Discovery : %v", err) + } + } + + if err := initDrivers(c); err != nil { + return nil, err + } + + if err := initIpams(c, c.getStore(datastore.LocalScope), + c.getStore(datastore.GlobalScope)); err != nil { + return nil, err + } + + c.sandboxCleanup() + c.cleanupLocalEndpoints() + + if err := c.startExternalKeyListener(); err != nil { + return nil, err + } + + return c, nil +} + +func (c *controller) ID() string { + return c.id +} + +func (c *controller) validateHostDiscoveryConfig() bool { + if c.cfg == nil || c.cfg.Cluster.Discovery == "" || c.cfg.Cluster.Address == "" { + return false + } + return true +} + +func (c *controller) initDiscovery(watcher discovery.Watcher) error { + if c.cfg == nil { + return fmt.Errorf("discovery initialization requires a valid configuration") + } + + c.discovery = hostdiscovery.NewHostDiscovery(watcher) + return c.discovery.Watch(c.activeCallback, c.hostJoinCallback, c.hostLeaveCallback) +} + +func (c *controller) activeCallback() { + ds := c.getStore(datastore.GlobalScope) + if ds != nil && !ds.Active() { + ds.RestartWatch() + } +} + +func (c *controller) hostJoinCallback(nodes []net.IP) { + c.processNodeDiscovery(nodes, true) +} + +func (c *controller) hostLeaveCallback(nodes []net.IP) { + c.processNodeDiscovery(nodes, false) +} + +func (c *controller) processNodeDiscovery(nodes []net.IP, add bool) { + c.Lock() + drivers := []*driverData{} + for _, d := range c.drivers { + drivers = append(drivers, d) + } + c.Unlock() + + for _, d := range drivers { + c.pushNodeDiscovery(d, nodes, add) + } +} + +func (c *controller) pushNodeDiscovery(d *driverData, nodes []net.IP, add bool) { + var self net.IP + if c.cfg != nil { + addr := strings.Split(c.cfg.Cluster.Address, ":") + self = net.ParseIP(addr[0]) + } + if d == nil || d.capability.DataScope != datastore.GlobalScope || nodes == nil { + return + } + for _, node := range nodes { + nodeData := driverapi.NodeDiscoveryData{Address: node.String(), Self: node.Equal(self)} + var err error + if add { + err = d.driver.DiscoverNew(driverapi.NodeDiscovery, nodeData) + } else { + err = d.driver.DiscoverDelete(driverapi.NodeDiscovery, nodeData) + } + if err != nil { + log.Debugf("discovery notification error : %v", err) + } + } +} + +func (c *controller) Config() config.Config { + c.Lock() + defer c.Unlock() + if c.cfg == nil { + return config.Config{} + } + return *c.cfg +} + +func (c *controller) RegisterDriver(networkType string, driver driverapi.Driver, capability driverapi.Capability) error { + if !config.IsValidName(networkType) { + return ErrInvalidName(networkType) + } + + c.Lock() + if _, ok := c.drivers[networkType]; ok { + c.Unlock() + return driverapi.ErrActiveRegistration(networkType) + } + dData := &driverData{driver, capability} + c.drivers[networkType] = dData + hd := c.discovery + c.Unlock() + + if hd != nil { + c.pushNodeDiscovery(dData, hd.Fetch(), true) + } + + return nil +} + +func (c *controller) RegisterIpamDriver(name string, driver ipamapi.Ipam) error { + if !config.IsValidName(name) { + return ErrInvalidName(name) + } + + c.Lock() + _, ok := c.ipamDrivers[name] + c.Unlock() + if ok { + return driverapi.ErrActiveRegistration(name) + } + locAS, glbAS, err := driver.GetDefaultAddressSpaces() + if err != nil { + return fmt.Errorf("ipam driver %s failed to return default address spaces: %v", name, err) + } + c.Lock() + c.ipamDrivers[name] = &ipamData{driver: driver, defaultLocalAddressSpace: locAS, defaultGlobalAddressSpace: glbAS} + c.Unlock() + + log.Debugf("Registering ipam provider: %s", name) + + return nil +} + +// NewNetwork creates a new network of the specified network type. The options +// are network specific and modeled in a generic way. +func (c *controller) NewNetwork(networkType, name string, options ...NetworkOption) (Network, error) { + if !config.IsValidName(name) { + return nil, ErrInvalidName(name) + } + + // Construct the network object + network := &network{ + name: name, + networkType: networkType, + generic: map[string]interface{}{netlabel.GenericData: make(map[string]string)}, + ipamType: ipamapi.DefaultIPAM, + id: stringid.GenerateRandomID(), + ctrlr: c, + persist: true, + drvOnce: &sync.Once{}, + } + + network.processOptions(options...) + + // Make sure we have a driver available for this network type + // before we allocate anything. + if _, err := network.driver(); err != nil { + return nil, err + } + + err := network.ipamAllocate() + if err != nil { + return nil, err + } + defer func() { + if err != nil { + network.ipamRelease() + } + }() + + if err = c.addNetwork(network); err != nil { + return nil, err + } + defer func() { + if err != nil { + if e := network.deleteNetwork(); e != nil { + log.Warnf("couldn't roll back driver network on network %s creation failure: %v", network.name, err) + } + } + }() + + if err = c.updateToStore(network); err != nil { + return nil, err + } + defer func() { + if err != nil { + if e := c.deleteFromStore(network); e != nil { + log.Warnf("couldnt rollback from store, network %s on failure (%v): %v", network.name, err, e) + } + } + }() + + network.epCnt = &endpointCnt{n: network} + if err = c.updateToStore(network.epCnt); err != nil { + return nil, err + } + + return network, nil +} + +func (c *controller) addNetwork(n *network) error { + d, err := n.driver() + if err != nil { + return err + } + + // Create the network + if err := d.CreateNetwork(n.id, n.generic, n.getIPData(4), n.getIPData(6)); err != nil { + return err + } + + return nil +} + +func (c *controller) Networks() []Network { + var list []Network + + networks, err := c.getNetworksFromStore() + if err != nil { + log.Error(err) + } + + for _, n := range networks { + list = append(list, n) + } + + return list +} + +func (c *controller) WalkNetworks(walker NetworkWalker) { + for _, n := range c.Networks() { + if walker(n) { + return + } + } +} + +func (c *controller) NetworkByName(name string) (Network, error) { + if name == "" { + return nil, ErrInvalidName(name) + } + var n Network + + s := func(current Network) bool { + if current.Name() == name { + n = current + return true + } + return false + } + + c.WalkNetworks(s) + + if n == nil { + return nil, ErrNoSuchNetwork(name) + } + + return n, nil +} + +func (c *controller) NetworkByID(id string) (Network, error) { + if id == "" { + return nil, ErrInvalidID(id) + } + + n, err := c.getNetworkFromStore(id) + if err != nil { + return nil, ErrNoSuchNetwork(id) + } + + return n, nil +} + +// NewSandbox creates a new sandbox for the passed container id +func (c *controller) NewSandbox(containerID string, options ...SandboxOption) (Sandbox, error) { + var err error + + if containerID == "" { + return nil, types.BadRequestErrorf("invalid container ID") + } + + var sb *sandbox + c.Lock() + for _, s := range c.sandboxes { + if s.containerID == containerID { + // If not a stub, then we already have a complete sandbox. + if !s.isStub { + c.Unlock() + return nil, types.BadRequestErrorf("container %s is already present: %v", containerID, s) + } + + // We already have a stub sandbox from the + // store. Make use of it so that we don't lose + // the endpoints from store but reset the + // isStub flag. + sb = s + sb.isStub = false + break + } + } + c.Unlock() + + // Create sandbox and process options first. Key generation depends on an option + if sb == nil { + sb = &sandbox{ + id: stringid.GenerateRandomID(), + containerID: containerID, + endpoints: epHeap{}, + epPriority: map[string]int{}, + config: containerConfig{}, + controller: c, + } + } + + heap.Init(&sb.endpoints) + + sb.processOptions(options...) + + if err = sb.setupResolutionFiles(); err != nil { + return nil, err + } + + if sb.config.useDefaultSandBox { + c.sboxOnce.Do(func() { + c.defOsSbox, err = osl.NewSandbox(sb.Key(), false) + }) + + if err != nil { + c.sboxOnce = sync.Once{} + return nil, fmt.Errorf("failed to create default sandbox: %v", err) + } + + sb.osSbox = c.defOsSbox + } + + if sb.osSbox == nil && !sb.config.useExternalKey { + if sb.osSbox, err = osl.NewSandbox(sb.Key(), !sb.config.useDefaultSandBox); err != nil { + return nil, fmt.Errorf("failed to create new osl sandbox: %v", err) + } + } + + c.Lock() + c.sandboxes[sb.id] = sb + c.Unlock() + defer func() { + if err != nil { + c.Lock() + delete(c.sandboxes, sb.id) + c.Unlock() + } + }() + + err = sb.storeUpdate() + if err != nil { + return nil, fmt.Errorf("updating the store state of sandbox failed: %v", err) + } + + return sb, nil +} + +func (c *controller) Sandboxes() []Sandbox { + c.Lock() + defer c.Unlock() + + list := make([]Sandbox, 0, len(c.sandboxes)) + for _, s := range c.sandboxes { + // Hide stub sandboxes from libnetwork users + if s.isStub { + continue + } + + list = append(list, s) + } + + return list +} + +func (c *controller) WalkSandboxes(walker SandboxWalker) { + for _, sb := range c.Sandboxes() { + if walker(sb) { + return + } + } +} + +func (c *controller) SandboxByID(id string) (Sandbox, error) { + if id == "" { + return nil, ErrInvalidID(id) + } + c.Lock() + s, ok := c.sandboxes[id] + c.Unlock() + if !ok { + return nil, types.NotFoundErrorf("sandbox %s not found", id) + } + return s, nil +} + +// SandboxDestroy destroys a sandbox given a container ID +func (c *controller) SandboxDestroy(id string) error { + var sb *sandbox + c.Lock() + for _, s := range c.sandboxes { + if s.containerID == id { + sb = s + break + } + } + c.Unlock() + + // It is not an error if sandbox is not available + if sb == nil { + return nil + } + + return sb.Delete() +} + +// SandboxContainerWalker returns a Sandbox Walker function which looks for an existing Sandbox with the passed containerID +func SandboxContainerWalker(out *Sandbox, containerID string) SandboxWalker { + return func(sb Sandbox) bool { + if sb.ContainerID() == containerID { + *out = sb + return true + } + return false + } +} + +// SandboxKeyWalker returns a Sandbox Walker function which looks for an existing Sandbox with the passed key +func SandboxKeyWalker(out *Sandbox, key string) SandboxWalker { + return func(sb Sandbox) bool { + if sb.Key() == key { + *out = sb + return true + } + return false + } +} + +func (c *controller) loadDriver(networkType string) (*driverData, error) { + // Plugins pkg performs lazy loading of plugins that acts as remote drivers. + // As per the design, this Get call will result in remote driver discovery if there is a corresponding plugin available. + _, err := plugins.Get(networkType, driverapi.NetworkPluginEndpointType) + if err != nil { + if err == plugins.ErrNotFound { + return nil, types.NotFoundErrorf(err.Error()) + } + return nil, err + } + c.Lock() + defer c.Unlock() + dd, ok := c.drivers[networkType] + if !ok { + return nil, ErrInvalidNetworkDriver(networkType) + } + return dd, nil +} + +func (c *controller) loadIpamDriver(name string) (*ipamData, error) { + if _, err := plugins.Get(name, ipamapi.PluginEndpointType); err != nil { + if err == plugins.ErrNotFound { + return nil, types.NotFoundErrorf(err.Error()) + } + return nil, err + } + c.Lock() + id, ok := c.ipamDrivers[name] + c.Unlock() + if !ok { + return nil, ErrInvalidNetworkDriver(name) + } + return id, nil +} + +func (c *controller) getIPAM(name string) (id *ipamData, err error) { + var ok bool + c.Lock() + id, ok = c.ipamDrivers[name] + c.Unlock() + if !ok { + id, err = c.loadIpamDriver(name) + } + return id, err +} + +func (c *controller) getIpamDriver(name string) (ipamapi.Ipam, error) { + id, err := c.getIPAM(name) + if err != nil { + return nil, err + } + return id.driver, nil +} + +func (c *controller) Stop() { + c.closeStores() + c.stopExternalKeyListener() + osl.GC() +} diff --git a/vendor/src/github.com/docker/libnetwork/datastore/cache.go b/vendor/src/github.com/docker/libnetwork/datastore/cache.go new file mode 100644 index 0000000000..08c8ac4839 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/datastore/cache.go @@ -0,0 +1,153 @@ +package datastore + +import ( + "fmt" + "sync" + + "github.com/docker/libkv/store" + "github.com/docker/libkv/store/boltdb" +) + +type kvMap map[string]KVObject + +type cache struct { + sync.Mutex + kmm map[string]kvMap + ds *datastore +} + +func newCache(ds *datastore) *cache { + return &cache{kmm: make(map[string]kvMap), ds: ds} +} + +func (c *cache) kmap(kvObject KVObject) (kvMap, error) { + var err error + + c.Lock() + keyPrefix := Key(kvObject.KeyPrefix()...) + kmap, ok := c.kmm[keyPrefix] + c.Unlock() + + if ok { + return kmap, nil + } + + kmap = kvMap{} + + // Bail out right away if the kvObject does not implement KVConstructor + ctor, ok := kvObject.(KVConstructor) + if !ok { + return nil, fmt.Errorf("error while populating kmap, object does not implement KVConstructor interface") + } + + kvList, err := c.ds.store.List(keyPrefix) + if err != nil { + // In case of BoltDB it may return ErrBoltBucketNotFound when no writes + // have ever happened on the db bucket. So check for both err codes + if err == store.ErrKeyNotFound || err == boltdb.ErrBoltBucketNotFound { + // If the store doesn't have anything then there is nothing to + // populate in the cache. Just bail out. + goto out + } + + return nil, fmt.Errorf("error while populating kmap: %v", err) + } + + for _, kvPair := range kvList { + // Ignore empty kvPair values + if len(kvPair.Value) == 0 { + continue + } + + dstO := ctor.New() + err = dstO.SetValue(kvPair.Value) + if err != nil { + return nil, err + } + + // Make sure the object has a correct view of the DB index in + // case we need to modify it and update the DB. + dstO.SetIndex(kvPair.LastIndex) + + kmap[Key(dstO.Key()...)] = dstO + } + +out: + // There may multiple go routines racing to fill the + // cache. The one which places the kmap in c.kmm first + // wins. The others should just use what the first populated. + c.Lock() + kmapNew, ok := c.kmm[keyPrefix] + if ok { + c.Unlock() + return kmapNew, nil + } + + c.kmm[keyPrefix] = kmap + c.Unlock() + + return kmap, nil +} + +func (c *cache) add(kvObject KVObject) error { + kmap, err := c.kmap(kvObject) + if err != nil { + return err + } + + c.Lock() + kmap[Key(kvObject.Key()...)] = kvObject + c.Unlock() + return nil +} + +func (c *cache) del(kvObject KVObject) error { + kmap, err := c.kmap(kvObject) + if err != nil { + return err + } + + c.Lock() + delete(kmap, Key(kvObject.Key()...)) + c.Unlock() + return nil +} + +func (c *cache) get(key string, kvObject KVObject) error { + kmap, err := c.kmap(kvObject) + if err != nil { + return err + } + + c.Lock() + defer c.Unlock() + + o, ok := kmap[Key(kvObject.Key()...)] + if !ok { + return ErrKeyNotFound + } + + ctor, ok := o.(KVConstructor) + if !ok { + return fmt.Errorf("kvobject does not implement KVConstructor interface. could not get object") + } + + return ctor.CopyTo(kvObject) +} + +func (c *cache) list(kvObject KVObject) ([]KVObject, error) { + kmap, err := c.kmap(kvObject) + if err != nil { + return nil, err + } + + c.Lock() + defer c.Unlock() + + var kvol []KVObject + for _, v := range kmap { + kvol = append(kvol, v) + } + + return kvol, nil +} diff --git a/vendor/src/github.com/docker/libnetwork/datastore/datastore.go b/vendor/src/github.com/docker/libnetwork/datastore/datastore.go new file mode 100644 index 0000000000..0ba7b6ef2c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/datastore/datastore.go @@ -0,0 +1,572 @@ +package datastore + +import ( + "fmt" + "log" + "reflect" + "strings" + "sync" + + "github.com/docker/libkv" + "github.com/docker/libkv/store" + "github.com/docker/libkv/store/boltdb" + "github.com/docker/libkv/store/consul" + "github.com/docker/libkv/store/etcd" + "github.com/docker/libkv/store/zookeeper" + "github.com/docker/libnetwork/types" +) + +//DataStore exported +type DataStore interface { + // GetObject gets data from datastore and unmarshals to the specified object + GetObject(key string, o KVObject) error + // PutObject adds a new Record based on an object into the datastore + PutObject(kvObject KVObject) error + // PutObjectAtomic provides an atomic add and update operation for a Record + PutObjectAtomic(kvObject KVObject) error + // DeleteObject deletes a record + DeleteObject(kvObject KVObject) error + // DeleteObjectAtomic performs an atomic delete operation + DeleteObjectAtomic(kvObject KVObject) error + // DeleteTree deletes a record + DeleteTree(kvObject KVObject) error + // Watchable returns whether the store is watchable are not + Watchable() bool + // Watch for changes on a KVObject + Watch(kvObject KVObject, stopCh <-chan struct{}) (<-chan KVObject, error) + // RestartWatch retriggers stopped Watches + RestartWatch() + // Active returns if the store is active + Active() bool + // List returns of a list of KVObjects belonging to the parent + // key. The caller must pass a KVObject of the same type as + // the objects that need to be listed + List(string, KVObject) ([]KVObject, error) + // Scope returns the scope of the store + Scope() string + // KVStore returns access to the KV Store + KVStore() store.Store + // Close closes the data store + Close() +} + +// ErrKeyModified is raised for an atomic update when the update is working on a stale state +var ( + ErrKeyModified = store.ErrKeyModified + ErrKeyNotFound = store.ErrKeyNotFound +) + +type datastore struct { + scope string + store store.Store + cache *cache + watchCh chan struct{} + active bool + sync.Mutex +} + +// KVObject is Key/Value interface used by objects to be part of the DataStore +type KVObject interface { + // Key method lets an object to provide the Key to be used in KV Store + Key() []string + // KeyPrefix method lets an object to return immediate parent key that can be used for tree walk + KeyPrefix() []string + // Value method lets an object to marshal its content to be stored in the KV store + Value() []byte + // SetValue is used by the datastore to set the object's value when loaded from the data store. + SetValue([]byte) error + // Index method returns the latest DB Index as seen by the object + Index() uint64 + // SetIndex method allows the datastore to store the latest DB Index into the object + SetIndex(uint64) + // True if the object exists in the datastore, false if it hasn't been stored yet. + // When SetIndex() is called, the object has been stored. + Exists() bool + // DataScope indicates the storage scope of the KV object + DataScope() string + // Skip provides a way for a KV Object to avoid persisting it in the KV Store + Skip() bool +} + +// KVConstructor interface defines methods which can construct a KVObject from another. +type KVConstructor interface { + // New returns a new object which is created based on the + // source object + New() KVObject + // CopyTo deep copies the contents of the implementing object + // to the passed destination object + CopyTo(KVObject) error +} + +// ScopeCfg represents Datastore configuration. +type ScopeCfg struct { + Client ScopeClientCfg +} + +// ScopeClientCfg represents Datastore Client-only mode configuration +type ScopeClientCfg struct { + Provider string + Address string + Config *store.Config +} + +const ( + // LocalScope indicates to store the KV object in local datastore such as boltdb + LocalScope = "local" + // GlobalScope indicates to store the KV object in global datastore such as consul/etcd/zookeeper + GlobalScope = "global" + defaultPrefix = "/var/lib/docker/network/files" +) + +const ( + // NetworkKeyPrefix is the prefix for network key in the kv store + NetworkKeyPrefix = "network" + // EndpointKeyPrefix is the prefix for endpoint key in the kv store + EndpointKeyPrefix = "endpoint" +) + +var ( + defaultScopes = makeDefaultScopes() +) + +func makeDefaultScopes() map[string]*ScopeCfg { + def := make(map[string]*ScopeCfg) + def[LocalScope] = &ScopeCfg{ + Client: ScopeClientCfg{ + Provider: string(store.BOLTDB), + Address: defaultPrefix + "/local-kv.db", + Config: &store.Config{ + Bucket: "libnetwork", + }, + }, + } + + return def +} + +var defaultRootChain = []string{"docker", "network", "v1.0"} +var rootChain = defaultRootChain + +func init() { + consul.Register() + zookeeper.Register() + etcd.Register() + boltdb.Register() +} + +// DefaultScopes returns a map of default scopes and it's config for clients to use. +func DefaultScopes(dataDir string) map[string]*ScopeCfg { + if dataDir != "" { + defaultScopes[LocalScope].Client.Address = dataDir + "/network/files/local-kv.db" + return defaultScopes + } + + defaultScopes[LocalScope].Client.Address = defaultPrefix + "/local-kv.db" + return defaultScopes +} + +// IsValid checks if the scope config has valid configuration. +func (cfg *ScopeCfg) IsValid() bool { + if cfg == nil || + strings.TrimSpace(cfg.Client.Provider) == "" || + strings.TrimSpace(cfg.Client.Address) == "" { + return false + } + + return true +} + +//Key provides convenient method to create a Key +func Key(key ...string) string { + keychain := append(rootChain, key...) + str := strings.Join(keychain, "/") + return str + "/" +} + +//ParseKey provides convenient method to unpack the key to complement the Key function +func ParseKey(key string) ([]string, error) { + chain := strings.Split(strings.Trim(key, "/"), "/") + + // The key must atleast be equal to the rootChain in order to be considered as valid + if len(chain) <= len(rootChain) || !reflect.DeepEqual(chain[0:len(rootChain)], rootChain) { + return nil, types.BadRequestErrorf("invalid Key : %s", key) + } + return chain[len(rootChain):], nil +} + +// newClient used to connect to KV Store +func newClient(scope string, kv string, addr string, config *store.Config, cached bool) (DataStore, error) { + + if cached && scope != LocalScope { + return nil, fmt.Errorf("caching supported only for scope %s", LocalScope) + } + + if config == nil { + config = &store.Config{} + } + + var addrs []string + + if kv == string(store.BOLTDB) { + // Parse file path + addrs = strings.Split(addr, ",") + } else { + // Parse URI + parts := strings.SplitN(addr, "/", 2) + addrs = strings.Split(parts[0], ",") + + // Add the custom prefix to the root chain + if len(parts) == 2 { + rootChain = append([]string{parts[1]}, defaultRootChain...) + } + } + + store, err := libkv.NewStore(store.Backend(kv), addrs, config) + if err != nil { + return nil, err + } + + ds := &datastore{scope: scope, store: store, active: true, watchCh: make(chan struct{})} + if cached { + ds.cache = newCache(ds) + } + + return ds, nil +} + +// NewDataStore creates a new instance of LibKV data store +func NewDataStore(scope string, cfg *ScopeCfg) (DataStore, error) { + if cfg == nil || cfg.Client.Provider == "" || cfg.Client.Address == "" { + c, ok := defaultScopes[scope] + if !ok || c.Client.Provider == "" || c.Client.Address == "" { + return nil, fmt.Errorf("unexpected scope %s without configuration passed", scope) + } + + cfg = c + } + + var cached bool + if scope == LocalScope { + cached = true + } + + return newClient(scope, cfg.Client.Provider, cfg.Client.Address, cfg.Client.Config, cached) +} + +func (ds *datastore) Close() { + ds.store.Close() +} + +func (ds *datastore) Scope() string { + return ds.scope +} + +func (ds *datastore) Active() bool { + return ds.active +} + +func (ds *datastore) Watchable() bool { + return ds.scope != LocalScope +} + +func (ds *datastore) Watch(kvObject KVObject, stopCh <-chan struct{}) (<-chan KVObject, error) { + sCh := make(chan struct{}) + + ctor, ok := kvObject.(KVConstructor) + if !ok { + return nil, fmt.Errorf("error watching object type %T, object does not implement KVConstructor interface", kvObject) + } + + kvpCh, err := ds.store.Watch(Key(kvObject.Key()...), sCh) + if err != nil { + return nil, err + } + + kvoCh := make(chan KVObject) + + go func() { + retry_watch: + var err error + + // Make sure to get a new instance of watch channel + ds.Lock() + watchCh := ds.watchCh + ds.Unlock() + + loop: + for { + select { + case <-stopCh: + close(sCh) + return + case kvPair := <-kvpCh: + // If the backend KV store gets reset libkv's go routine + // for the watch can exit resulting in a nil value in + // channel. + if kvPair == nil { + ds.Lock() + ds.active = false + ds.Unlock() + break loop + } + + dstO := ctor.New() + + if err = dstO.SetValue(kvPair.Value); err != nil { + log.Printf("Could not unmarshal kvpair value = %s", string(kvPair.Value)) + break + } + + dstO.SetIndex(kvPair.LastIndex) + kvoCh <- dstO + } + } + + // Wait on watch channel for a re-trigger when datastore becomes active + <-watchCh + + kvpCh, err = ds.store.Watch(Key(kvObject.Key()...), sCh) + if err != nil { + log.Printf("Could not watch the key %s in store: %v", Key(kvObject.Key()...), err) + } + + goto retry_watch + }() + + return kvoCh, nil +} + +func (ds *datastore) RestartWatch() { + ds.Lock() + defer ds.Unlock() + + ds.active = true + watchCh := ds.watchCh + ds.watchCh = make(chan struct{}) + close(watchCh) +} + +func (ds *datastore) KVStore() store.Store { + return ds.store +} + +// PutObjectAtomic adds a new Record based on an object into the datastore +func (ds *datastore) PutObjectAtomic(kvObject KVObject) error { + var ( + previous *store.KVPair + pair *store.KVPair + err error + ) + ds.Lock() + defer ds.Unlock() + + if kvObject == nil { + return types.BadRequestErrorf("invalid KV Object : nil") + } + + kvObjValue := kvObject.Value() + + if kvObjValue == nil { + return types.BadRequestErrorf("invalid KV Object with a nil Value for key %s", Key(kvObject.Key()...)) + } + + if kvObject.Skip() { + goto add_cache + } + + if kvObject.Exists() { + previous = &store.KVPair{Key: Key(kvObject.Key()...), LastIndex: kvObject.Index()} + } else { + previous = nil + } + + _, pair, err = ds.store.AtomicPut(Key(kvObject.Key()...), kvObjValue, previous, nil) + if err != nil { + return err + } + + kvObject.SetIndex(pair.LastIndex) + +add_cache: + if ds.cache != nil { + return ds.cache.add(kvObject) + } + + return nil +} + +// PutObject adds a new Record based on an object into the datastore +func (ds *datastore) PutObject(kvObject KVObject) error { + ds.Lock() + defer ds.Unlock() + + if kvObject == nil { + return types.BadRequestErrorf("invalid KV Object : nil") + } + + if kvObject.Skip() { + goto add_cache + } + + if err := ds.putObjectWithKey(kvObject, kvObject.Key()...); err != nil { + return err + } + +add_cache: + if ds.cache != nil { + return ds.cache.add(kvObject) + } + + return nil +} + +func (ds *datastore) putObjectWithKey(kvObject KVObject, key ...string) error { + kvObjValue := kvObject.Value() + + if kvObjValue == nil { + return types.BadRequestErrorf("invalid KV Object with a nil Value for key %s", Key(kvObject.Key()...)) + } + return ds.store.Put(Key(key...), kvObjValue, nil) +} + +// GetObject returns a record matching the key +func (ds *datastore) GetObject(key string, o KVObject) error { + ds.Lock() + defer ds.Unlock() + + if ds.cache != nil { + return ds.cache.get(key, o) + } + + kvPair, err := ds.store.Get(key) + if err != nil { + return err + } + + if err := o.SetValue(kvPair.Value); err != nil { + return err + } + + // Make sure the object has a correct view of the DB index in + // case we need to modify it and update the DB. + o.SetIndex(kvPair.LastIndex) + return nil +} + +func (ds *datastore) ensureParent(parent string) error { + exists, err := ds.store.Exists(parent) + if err != nil { + return err + } + if exists { + return nil + } + return ds.store.Put(parent, []byte{}, &store.WriteOptions{IsDir: true}) +} + +func (ds *datastore) List(key string, kvObject KVObject) ([]KVObject, error) { + ds.Lock() + defer ds.Unlock() + + if ds.cache != nil { + return ds.cache.list(kvObject) + } + + // Bail out right away if the kvObject does not implement KVConstructor + ctor, ok := kvObject.(KVConstructor) + if !ok { + return nil, fmt.Errorf("error listing objects, object does not implement KVConstructor interface") + } + + // Make sure the parent key exists + if err := ds.ensureParent(key); err != nil { + return nil, err + } + + kvList, err := ds.store.List(key) + if err != nil { + return nil, err + } + + var kvol []KVObject + for _, kvPair := range kvList { + if len(kvPair.Value) == 0 { + continue + } + + dstO := ctor.New() + if err := dstO.SetValue(kvPair.Value); err != nil { + return nil, err + } + + // Make sure the object has a correct view of the DB index in + // case we need to modify it and update the DB. + dstO.SetIndex(kvPair.LastIndex) + + kvol = append(kvol, dstO) + } + + return kvol, nil +} + +// DeleteObject unconditionally deletes a record from the store +func (ds *datastore) DeleteObject(kvObject KVObject) error { + ds.Lock() + defer ds.Unlock() + + // cleaup the cache first + if ds.cache != nil { + ds.cache.del(kvObject) + } + + if kvObject.Skip() { + return nil + } + + return ds.store.Delete(Key(kvObject.Key()...)) +} + +// DeleteObjectAtomic performs atomic delete on a record +func (ds *datastore) DeleteObjectAtomic(kvObject KVObject) error { + ds.Lock() + defer ds.Unlock() + + if kvObject == nil { + return types.BadRequestErrorf("invalid KV Object : nil") + } + + previous := &store.KVPair{Key: Key(kvObject.Key()...), LastIndex: kvObject.Index()} + + if kvObject.Skip() { + goto del_cache + } + + if _, err := ds.store.AtomicDelete(Key(kvObject.Key()...), previous); err != nil { + return err + } + +del_cache: + // cleanup the cache only if AtomicDelete went through successfully + if ds.cache != nil { + return ds.cache.del(kvObject) + } + + return nil +} + +// DeleteTree unconditionally deletes a record from the store +func (ds *datastore) DeleteTree(kvObject KVObject) error { + ds.Lock() + defer ds.Unlock() + + // cleaup the cache first + if ds.cache != nil { + ds.cache.del(kvObject) + } + + if kvObject.Skip() { + return nil + } + + return ds.store.DeleteTree(Key(kvObject.KeyPrefix()...)) +} diff --git a/vendor/src/github.com/docker/libnetwork/datastore/mock_store.go b/vendor/src/github.com/docker/libnetwork/datastore/mock_store.go new file mode 100644 index 0000000000..0817339b6a --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/datastore/mock_store.go @@ -0,0 +1,129 @@ +package datastore + +import ( + "errors" + + "github.com/docker/libkv/store" + "github.com/docker/libnetwork/types" +) + +var ( + // ErrNotImplmented exported + ErrNotImplmented = errors.New("Functionality not implemented") +) + +// MockData exported +type MockData struct { + Data []byte + Index uint64 +} + +// MockStore exported +type MockStore struct { + db map[string]*MockData +} + +// NewMockStore creates a Map backed Datastore that is useful for mocking +func NewMockStore() *MockStore { + db := make(map[string]*MockData) + return &MockStore{db} +} + +// Get the value at "key", returns the last modified index +// to use in conjunction to CAS calls +func (s *MockStore) Get(key string) (*store.KVPair, error) { + mData := s.db[key] + if mData == nil { + return nil, nil + } + return &store.KVPair{Value: mData.Data, LastIndex: mData.Index}, nil + +} + +// Put a value at "key" +func (s *MockStore) Put(key string, value []byte, options *store.WriteOptions) error { + mData := s.db[key] + if mData == nil { + mData = &MockData{value, 0} + } + mData.Index = mData.Index + 1 + s.db[key] = mData + return nil +} + +// Delete a value at "key" +func (s *MockStore) Delete(key string) error { + delete(s.db, key) + return nil +} + +// Exists checks that the key exists inside the store +func (s *MockStore) Exists(key string) (bool, error) { + _, ok := s.db[key] + return ok, nil +} + +// List gets a range of values at "directory" +func (s *MockStore) List(prefix string) ([]*store.KVPair, error) { + return nil, ErrNotImplmented +} + +// DeleteTree deletes a range of values at "directory" +func (s *MockStore) DeleteTree(prefix string) error { + delete(s.db, prefix) + return nil +} + +// Watch a single key for modifications +func (s *MockStore) Watch(key string, stopCh <-chan struct{}) (<-chan *store.KVPair, error) { + return nil, ErrNotImplmented +} + +// WatchTree triggers a watch on a range of values at "directory" +func (s *MockStore) WatchTree(prefix string, stopCh <-chan struct{}) (<-chan []*store.KVPair, error) { + return nil, ErrNotImplmented +} + +// NewLock exposed +func (s *MockStore) NewLock(key string, options *store.LockOptions) (store.Locker, error) { + return nil, ErrNotImplmented +} + +// AtomicPut put a value at "key" if the key has not been +// modified in the meantime, throws an error if this is the case +func (s *MockStore) AtomicPut(key string, newValue []byte, previous *store.KVPair, options *store.WriteOptions) (bool, *store.KVPair, error) { + mData := s.db[key] + + if previous == nil { + if mData != nil { + return false, nil, types.BadRequestErrorf("atomic put failed because key exists") + } // Else OK. + } else { + if mData == nil { + return false, nil, types.BadRequestErrorf("atomic put failed because key exists") + } + if mData != nil && mData.Index != previous.LastIndex { + return false, nil, types.BadRequestErrorf("atomic put failed due to mismatched Index") + } // Else OK. + } + err := s.Put(key, newValue, nil) + if err != nil { + return false, nil, err + } + return true, &store.KVPair{Key: key, Value: newValue, LastIndex: s.db[key].Index}, nil +} + +// AtomicDelete deletes a value at "key" if the key has not +// been modified in the meantime, throws an error if this is the case +func (s *MockStore) AtomicDelete(key string, previous *store.KVPair) (bool, error) { + mData := s.db[key] + if mData != nil && mData.Index != previous.LastIndex { + return false, types.BadRequestErrorf("atomic delete failed due to mismatched Index") + } + return true, s.Delete(key) +} + +// Close closes the client connection +func (s *MockStore) Close() { + return +} diff --git a/vendor/src/github.com/docker/libnetwork/default_gateway.go b/vendor/src/github.com/docker/libnetwork/default_gateway.go new file mode 100644 index 0000000000..5d58b06175 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/default_gateway.go @@ -0,0 +1,141 @@ +package libnetwork + +import ( + "fmt" + + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/types" +) + +const ( + libnGWNetwork = "docker_gwbridge" + gwEPlen = 12 +) + +/* + libnetwork creates a bridge network "docker_gw_bridge" for provding + default gateway for the containers if none of the container's endpoints + have GW set by the driver. ICC is set to false for the GW_bridge network. + + If a driver can't provide external connectivity it can choose to not set + the GW IP for the endpoint. + + endpoint on the GW_bridge network is managed dynamically by libnetwork. + ie: + - its created when an endpoint without GW joins the container + - its deleted when an endpoint with GW joins the container +*/ + +func (sb *sandbox) setupDefaultGW(srcEp *endpoint) error { + var createOptions []EndpointOption + c := srcEp.getNetwork().getController() + + // check if the conitainer already has a GW endpoint + if ep := sb.getEndpointInGWNetwork(); ep != nil { + return nil + } + + n, err := c.NetworkByName(libnGWNetwork) + if err != nil { + if _, ok := err.(types.NotFoundError); !ok { + return err + } + n, err = c.createGWNetwork() + if err != nil { + return err + } + } + + if opt, ok := srcEp.generic[netlabel.PortMap]; ok { + if pb, ok := opt.([]types.PortBinding); ok { + createOptions = append(createOptions, CreateOptionPortMapping(pb)) + } + } + + if opt, ok := srcEp.generic[netlabel.ExposedPorts]; ok { + if exp, ok := opt.([]types.TransportPort); ok { + createOptions = append(createOptions, CreateOptionExposedPorts(exp)) + } + } + + createOptions = append(createOptions, CreateOptionAnonymous()) + + eplen := gwEPlen + if len(sb.containerID) < gwEPlen { + eplen = len(sb.containerID) + } + + newEp, err := n.CreateEndpoint("gateway_"+sb.containerID[0:eplen], createOptions...) + if err != nil { + return fmt.Errorf("container %s: endpoint create on GW Network failed: %v", sb.containerID, err) + } + epLocal := newEp.(*endpoint) + + if err := epLocal.sbJoin(sb); err != nil { + return fmt.Errorf("container %s: endpoint join on GW Network failed: %v", sb.containerID, err) + } + return nil +} + +func (sb *sandbox) clearDefaultGW() error { + var ep *endpoint + + if ep = sb.getEndpointInGWNetwork(); ep == nil { + return nil + } + + if err := ep.sbLeave(sb); err != nil { + return fmt.Errorf("container %s: endpoint leaving GW Network failed: %v", sb.containerID, err) + } + if err := ep.Delete(); err != nil { + return fmt.Errorf("container %s: deleting endpoint on GW Network failed: %v", sb.containerID, err) + } + return nil +} + +func (sb *sandbox) needDefaultGW() bool { + var needGW bool + + for _, ep := range sb.getConnectedEndpoints() { + if ep.endpointInGWNetwork() { + continue + } + if ep.getNetwork().Type() == "null" || ep.getNetwork().Type() == "host" { + continue + } + // TODO v6 needs to be handled. + if len(ep.Gateway()) > 0 { + return false + } + needGW = true + } + return needGW +} + +func (sb *sandbox) getEndpointInGWNetwork() *endpoint { + for _, ep := range sb.getConnectedEndpoints() { + if ep.getNetwork().name == libnGWNetwork { + return ep + } + } + return nil +} + +func (ep *endpoint) endpointInGWNetwork() bool { + if ep.getNetwork().name == libnGWNetwork { + return true + } + return false +} + +func (sb *sandbox) getEPwithoutGateway() *endpoint { + for _, ep := range sb.getConnectedEndpoints() { + if ep.getNetwork().Type() == "null" || ep.getNetwork().Type() == "host" { + continue + } + if len(ep.Gateway()) == 0 { + return ep + } + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/default_gateway_freebsd.go b/vendor/src/github.com/docker/libnetwork/default_gateway_freebsd.go new file mode 100644 index 0000000000..a82687391a --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/default_gateway_freebsd.go @@ -0,0 +1,7 @@ +package libnetwork + +import "github.com/docker/libnetwork/types" + +func (c *controller) createGWNetwork() (Network, error) { + return nil, types.NotImplementedErrorf("default gateway functionality is not implemented in freebsd") +} diff --git a/vendor/src/github.com/docker/libnetwork/default_gateway_linux.go b/vendor/src/github.com/docker/libnetwork/default_gateway_linux.go new file mode 100644 index 0000000000..c7f812778f --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/default_gateway_linux.go @@ -0,0 +1,29 @@ +package libnetwork + +import ( + "fmt" + "strconv" + + "github.com/docker/libnetwork/drivers/bridge" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/options" +) + +func (c *controller) createGWNetwork() (Network, error) { + netOption := map[string]string{ + bridge.BridgeName: libnGWNetwork, + bridge.EnableICC: strconv.FormatBool(false), + bridge.EnableIPMasquerade: strconv.FormatBool(true), + } + + n, err := c.NewNetwork("bridge", libnGWNetwork, + NetworkOptionGeneric(options.Generic{ + netlabel.GenericData: netOption, + netlabel.EnableIPv6: false, + })) + + if err != nil { + return nil, fmt.Errorf("error creating external connectivity network: %v", err) + } + return n, err +} diff --git a/vendor/src/github.com/docker/libnetwork/default_gateway_windows.go b/vendor/src/github.com/docker/libnetwork/default_gateway_windows.go new file mode 100644 index 0000000000..48eee2ba1d --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/default_gateway_windows.go @@ -0,0 +1,7 @@ +package libnetwork + +import "github.com/docker/libnetwork/types" + +func (c *controller) createGWNetwork() (Network, error) { + return nil, types.NotImplementedErrorf("default gateway functionality is not implemented in windows") +} diff --git a/vendor/src/github.com/docker/libnetwork/driverapi/driverapi.go b/vendor/src/github.com/docker/libnetwork/driverapi/driverapi.go new file mode 100644 index 0000000000..bd311d0035 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/driverapi/driverapi.go @@ -0,0 +1,129 @@ +package driverapi + +import "net" + +// NetworkPluginEndpointType represents the Endpoint Type used by Plugin system +const NetworkPluginEndpointType = "NetworkDriver" + +// Driver is an interface that every plugin driver needs to implement. +type Driver interface { + // CreateNetwork invokes the driver method to create a network passing + // the network id and network specific config. The config mechanism will + // eventually be replaced with labels which are yet to be introduced. + CreateNetwork(nid string, options map[string]interface{}, ipV4Data, ipV6Data []IPAMData) error + + // DeleteNetwork invokes the driver method to delete network passing + // the network id. + DeleteNetwork(nid string) error + + // CreateEndpoint invokes the driver method to create an endpoint + // passing the network id, endpoint id endpoint information and driver + // specific config. The endpoint information can be either consumed by + // the driver or populated by the driver. The config mechanism will + // eventually be replaced with labels which are yet to be introduced. + CreateEndpoint(nid, eid string, ifInfo InterfaceInfo, options map[string]interface{}) error + + // DeleteEndpoint invokes the driver method to delete an endpoint + // passing the network id and endpoint id. + DeleteEndpoint(nid, eid string) error + + // EndpointOperInfo retrieves from the driver the operational data related to the specified endpoint + EndpointOperInfo(nid, eid string) (map[string]interface{}, error) + + // Join method is invoked when a Sandbox is attached to an endpoint. + Join(nid, eid string, sboxKey string, jinfo JoinInfo, options map[string]interface{}) error + + // Leave method is invoked when a Sandbox detaches from an endpoint. + Leave(nid, eid string) error + + // DiscoverNew is a notification for a new discovery event, Example:a new node joining a cluster + DiscoverNew(dType DiscoveryType, data interface{}) error + + // DiscoverDelete is a notification for a discovery delete event, Example:a node leaving a cluster + DiscoverDelete(dType DiscoveryType, data interface{}) error + + // Type returns the the type of this driver, the network type this driver manages + Type() string +} + +// InterfaceInfo provides a go interface for drivers to retrive +// network information to interface resources. +type InterfaceInfo interface { + // SetMacAddress allows the driver to set the mac address to the endpoint interface + // during the call to CreateEndpoint, if the mac address is not already set. + SetMacAddress(mac net.HardwareAddr) error + + // SetIPAddress allows the driver to set the ip address to the endpoint interface + // during the call to CreateEndpoint, if the address is not already set. + // The API is to be used to assign both the IPv4 and IPv6 address types. + SetIPAddress(ip *net.IPNet) error + + // MacAddress returns the MAC address. + MacAddress() net.HardwareAddr + + // Address returns the IPv4 address. + Address() *net.IPNet + + // AddressIPv6 returns the IPv6 address. + AddressIPv6() *net.IPNet +} + +// InterfaceNameInfo provides a go interface for the drivers to assign names +// to interfaces. +type InterfaceNameInfo interface { + // SetNames method assigns the srcName and dstPrefix for the interface. + SetNames(srcName, dstPrefix string) error +} + +// JoinInfo represents a set of resources that the driver has the ability to provide during +// join time. +type JoinInfo interface { + // InterfaceName returns a InterfaceNameInfo go interface to facilitate + // setting the names for the interface. + InterfaceName() InterfaceNameInfo + + // SetGateway sets the default IPv4 gateway when a container joins the endpoint. + SetGateway(net.IP) error + + // SetGatewayIPv6 sets the default IPv6 gateway when a container joins the endpoint. + SetGatewayIPv6(net.IP) error + + // AddStaticRoute adds a routes to the sandbox. + // It may be used in addtion to or instead of a default gateway (as above). + AddStaticRoute(destination *net.IPNet, routeType int, nextHop net.IP) error +} + +// DriverCallback provides a Callback interface for Drivers into LibNetwork +type DriverCallback interface { + // RegisterDriver provides a way for Remote drivers to dynamically register new NetworkType and associate with a driver instance + RegisterDriver(name string, driver Driver, capability Capability) error +} + +// Capability represents the high level capabilities of the drivers which libnetwork can make use of +type Capability struct { + DataScope string +} + +// DiscoveryType represents the type of discovery element the DiscoverNew function is invoked on +type DiscoveryType int + +const ( + // NodeDiscovery represents Node join/leave events provided by discovery + NodeDiscovery = iota + 1 +) + +// NodeDiscoveryData represents the structure backing the node discovery data json string +type NodeDiscoveryData struct { + Address string + Self bool +} + +// IPAMData represents the per-network ip related +// operational information libnetwork will send +// to the network driver during CreateNetwork() +type IPAMData struct { + AddressSpace string + Pool *net.IPNet + Gateway *net.IPNet + AuxAddresses map[string]*net.IPNet +} diff --git a/vendor/src/github.com/docker/libnetwork/driverapi/errors.go b/vendor/src/github.com/docker/libnetwork/driverapi/errors.go new file mode 100644 index 0000000000..041ef41506 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/driverapi/errors.go @@ -0,0 +1,56 @@ +package driverapi + +import ( + "fmt" +) + +// ErrNoNetwork is returned if no network with the specified id exists +type ErrNoNetwork string + +func (enn ErrNoNetwork) Error() string { + return fmt.Sprintf("No network (%s) exists", string(enn)) +} + +// NotFound denotes the type of this error +func (enn ErrNoNetwork) NotFound() {} + +// ErrEndpointExists is returned if more than one endpoint is added to the network +type ErrEndpointExists string + +func (ee ErrEndpointExists) Error() string { + return fmt.Sprintf("Endpoint (%s) already exists (Only one endpoint allowed)", string(ee)) +} + +// Forbidden denotes the type of this error +func (ee ErrEndpointExists) Forbidden() {} + +// ErrNotImplemented is returned when a Driver has not implemented an API yet +type ErrNotImplemented struct{} + +func (eni *ErrNotImplemented) Error() string { + return "The API is not implemented yet" +} + +// NotImplemented denotes the type of this error +func (eni *ErrNotImplemented) NotImplemented() {} + +// ErrNoEndpoint is returned if no endpoint with the specified id exists +type ErrNoEndpoint string + +func (ene ErrNoEndpoint) Error() string { + return fmt.Sprintf("No endpoint (%s) exists", string(ene)) +} + +// NotFound denotes the type of this error +func (ene ErrNoEndpoint) NotFound() {} + +// ErrActiveRegistration represents an error when a driver is registered to a networkType that is previously registered +type ErrActiveRegistration string + +// Error interface for ErrActiveRegistration +func (ar ErrActiveRegistration) Error() string { + return fmt.Sprintf("Driver already registered for type %q", string(ar)) +} + +// Forbidden denotes the type of this error +func (ar ErrActiveRegistration) Forbidden() {} diff --git a/vendor/src/github.com/docker/libnetwork/driverapi/ipamdata.go b/vendor/src/github.com/docker/libnetwork/driverapi/ipamdata.go new file mode 100644 index 0000000000..9a2375bf8a --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/driverapi/ipamdata.go @@ -0,0 +1,103 @@ +package driverapi + +import ( + "encoding/json" + "fmt" + "net" + + "github.com/docker/libnetwork/types" +) + +// MarshalJSON encodes IPAMData into json message +func (i *IPAMData) MarshalJSON() ([]byte, error) { + m := map[string]interface{}{} + m["AddressSpace"] = i.AddressSpace + if i.Pool != nil { + m["Pool"] = i.Pool.String() + } + if i.Gateway != nil { + m["Gateway"] = i.Gateway.String() + } + if i.AuxAddresses != nil { + am := make(map[string]string, len(i.AuxAddresses)) + for k, v := range i.AuxAddresses { + am[k] = v.String() + } + m["AuxAddresses"] = am + } + return json.Marshal(m) +} + +// UnmarshalJSON decodes a json message into IPAMData +func (i *IPAMData) UnmarshalJSON(data []byte) error { + var ( + m map[string]interface{} + err error + ) + if err := json.Unmarshal(data, &m); err != nil { + return err + } + i.AddressSpace = m["AddressSpace"].(string) + if v, ok := m["Pool"]; ok { + if i.Pool, err = types.ParseCIDR(v.(string)); err != nil { + return err + } + } + if v, ok := m["Gateway"]; ok { + if i.Gateway, err = types.ParseCIDR(v.(string)); err != nil { + return err + } + } + if v, ok := m["AuxAddresses"]; ok { + b, _ := json.Marshal(v) + var am map[string]string + if err = json.Unmarshal(b, &am); err != nil { + return err + } + i.AuxAddresses = make(map[string]*net.IPNet, len(am)) + for k, v := range am { + if i.AuxAddresses[k], err = types.ParseCIDR(v); err != nil { + return err + } + } + } + return nil +} + +// Validate checks wheter the IPAMData structure contains congruent data +func (i *IPAMData) Validate() error { + var isV6 bool + if i.Pool == nil { + return types.BadRequestErrorf("invalid pool") + } + if i.Gateway == nil { + return types.BadRequestErrorf("invalid gateway address") + } + isV6 = i.IsV6() + if isV6 && i.Gateway.IP.To4() != nil || !isV6 && i.Gateway.IP.To4() == nil { + return types.BadRequestErrorf("incongruent ip versions for pool and gateway") + } + for k, sip := range i.AuxAddresses { + if isV6 && sip.IP.To4() != nil || !isV6 && sip.IP.To4() == nil { + return types.BadRequestErrorf("incongruent ip versions for pool and secondary ip address %s", k) + } + } + if !i.Pool.Contains(i.Gateway.IP) { + return types.BadRequestErrorf("invalid gateway address (%s) does not belong to the pool (%s)", i.Gateway, i.Pool) + } + for k, sip := range i.AuxAddresses { + if !i.Pool.Contains(sip.IP) { + return types.BadRequestErrorf("invalid secondary address %s (%s) does not belong to the pool (%s)", k, i.Gateway, i.Pool) + } + } + return nil +} + +// IsV6 returns wheter this is an IPv6 IPAMData structure +func (i *IPAMData) IsV6() bool { + return nil == i.Pool.IP.To4() +} + +func (i *IPAMData) String() string { + return fmt.Sprintf("AddressSpace: %s\nPool: %v\nGateway: %v\nAddresses: %v", i.AddressSpace, i.Pool, i.Gateway, i.AuxAddresses) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers.go b/vendor/src/github.com/docker/libnetwork/drivers.go new file mode 100644 index 0000000000..1b11f37324 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers.go @@ -0,0 +1,78 @@ +package libnetwork + +import ( + "strings" + + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/ipamapi" + builtinIpam "github.com/docker/libnetwork/ipams/builtin" + remoteIpam "github.com/docker/libnetwork/ipams/remote" + "github.com/docker/libnetwork/netlabel" +) + +type initializer struct { + fn func(driverapi.DriverCallback, map[string]interface{}) error + ntype string +} + +func initDrivers(c *controller) error { + for _, i := range getInitializers() { + if err := i.fn(c, makeDriverConfig(c, i.ntype)); err != nil { + return err + } + } + + return nil +} + +func makeDriverConfig(c *controller, ntype string) map[string]interface{} { + if c.cfg == nil { + return nil + } + + config := make(map[string]interface{}) + + for _, label := range c.cfg.Daemon.Labels { + if !strings.HasPrefix(netlabel.Key(label), netlabel.DriverPrefix+"."+ntype) { + continue + } + + config[netlabel.Key(label)] = netlabel.Value(label) + } + + drvCfg, ok := c.cfg.Daemon.DriverCfg[ntype] + if ok { + for k, v := range drvCfg.(map[string]interface{}) { + config[k] = v + } + } + + // We don't send datastore configs to external plugins + if ntype == "remote" { + return config + } + + for k, v := range c.cfg.Scopes { + if !v.IsValid() { + continue + } + + config[netlabel.MakeKVProvider(k)] = v.Client.Provider + config[netlabel.MakeKVProviderURL(k)] = v.Client.Address + config[netlabel.MakeKVProviderConfig(k)] = v.Client.Config + } + + return config +} + +func initIpams(ic ipamapi.Callback, lDs, gDs interface{}) error { + for _, fn := range [](func(ipamapi.Callback, interface{}, interface{}) error){ + builtinIpam.Init, + remoteIpam.Init, + } { + if err := fn(ic, lDs, gDs); err != nil { + return err + } + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge.go new file mode 100644 index 0000000000..8cc26f951f --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge.go @@ -0,0 +1,1346 @@ +package bridge + +import ( + "errors" + "fmt" + "io/ioutil" + "net" + "os" + "os/exec" + "path/filepath" + "strconv" + "strings" + "sync" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/iptables" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/netutils" + "github.com/docker/libnetwork/options" + "github.com/docker/libnetwork/osl" + "github.com/docker/libnetwork/portmapper" + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" +) + +const ( + networkType = "bridge" + vethPrefix = "veth" + vethLen = 7 + containerVethPrefix = "eth" + maxAllocatePortAttempts = 10 +) + +const ( + // DefaultGatewayV4AuxKey represents the default-gateway configured by the user + DefaultGatewayV4AuxKey = "DefaultGatewayIPv4" + // DefaultGatewayV6AuxKey represents the ipv6 default-gateway configured by the user + DefaultGatewayV6AuxKey = "DefaultGatewayIPv6" +) + +// configuration info for the "bridge" driver. +type configuration struct { + EnableIPForwarding bool + EnableIPTables bool + EnableUserlandProxy bool +} + +// networkConfiguration for network specific configuration +type networkConfiguration struct { + ID string + BridgeName string + EnableIPv6 bool + EnableIPMasquerade bool + EnableICC bool + Mtu int + DefaultBindingIP net.IP + DefaultBridge bool + // Internal fields set after ipam data parsing + AddressIPv4 *net.IPNet + AddressIPv6 *net.IPNet + DefaultGatewayIPv4 net.IP + DefaultGatewayIPv6 net.IP + dbIndex uint64 + dbExists bool +} + +// endpointConfiguration represents the user specified configuration for the sandbox endpoint +type endpointConfiguration struct { + MacAddress net.HardwareAddr + PortBindings []types.PortBinding + ExposedPorts []types.TransportPort +} + +// containerConfiguration represents the user specified configuration for a container +type containerConfiguration struct { + ParentEndpoints []string + ChildEndpoints []string +} + +type bridgeEndpoint struct { + id string + srcName string + addr *net.IPNet + addrv6 *net.IPNet + macAddress net.HardwareAddr + config *endpointConfiguration // User specified parameters + containerConfig *containerConfiguration + portMapping []types.PortBinding // Operation port bindings +} + +type bridgeNetwork struct { + id string + bridge *bridgeInterface // The bridge's L3 interface + config *networkConfiguration + endpoints map[string]*bridgeEndpoint // key: endpoint id + portMapper *portmapper.PortMapper + driver *driver // The network's driver + sync.Mutex +} + +type driver struct { + config *configuration + network *bridgeNetwork + natChain *iptables.ChainInfo + filterChain *iptables.ChainInfo + networks map[string]*bridgeNetwork + store datastore.DataStore + sync.Mutex +} + +// New constructs a new bridge driver +func newDriver() *driver { + return &driver{networks: map[string]*bridgeNetwork{}, config: &configuration{}} +} + +// Init registers a new instance of bridge driver +func Init(dc driverapi.DriverCallback, config map[string]interface{}) error { + if _, err := os.Stat("/proc/sys/net/bridge"); err != nil { + if out, err := exec.Command("modprobe", "-va", "bridge", "br_netfilter").CombinedOutput(); err != nil { + logrus.Warnf("Running modprobe bridge br_netfilter failed with message: %s, error: %v", out, err) + } + } + if out, err := exec.Command("modprobe", "-va", "nf_nat").CombinedOutput(); err != nil { + logrus.Warnf("Running modprobe nf_nat failed with message: `%s`, error: %v", strings.TrimSpace(string(out)), err) + } + if err := iptables.FirewalldInit(); err != nil { + logrus.Debugf("Fail to initialize firewalld: %v, using raw iptables instead", err) + } + if err := iptables.RemoveExistingChain(DockerChain, iptables.Nat); err != nil { + logrus.Warnf("Failed to remove existing iptables entries in %s : %v", DockerChain, err) + } + + d := newDriver() + if err := d.configure(config); err != nil { + return err + } + + c := driverapi.Capability{ + DataScope: datastore.LocalScope, + } + return dc.RegisterDriver(networkType, d, c) +} + +// Validate performs a static validation on the network configuration parameters. +// Whatever can be assessed a priori before attempting any programming. +func (c *networkConfiguration) Validate() error { + if c.Mtu < 0 { + return ErrInvalidMtu(c.Mtu) + } + + // If bridge v4 subnet is specified + if c.AddressIPv4 != nil { + // If default gw is specified, it must be part of bridge subnet + if c.DefaultGatewayIPv4 != nil { + if !c.AddressIPv4.Contains(c.DefaultGatewayIPv4) { + return &ErrInvalidGateway{} + } + } + } + + // If default v6 gw is specified, AddressIPv6 must be specified and gw must belong to AddressIPv6 subnet + if c.EnableIPv6 && c.DefaultGatewayIPv6 != nil { + if c.AddressIPv6 == nil || !c.AddressIPv6.Contains(c.DefaultGatewayIPv6) { + return &ErrInvalidGateway{} + } + } + return nil +} + +// Conflicts check if two NetworkConfiguration objects overlap +func (c *networkConfiguration) Conflicts(o *networkConfiguration) error { + if o == nil { + return fmt.Errorf("same configuration") + } + + // Also empty, becasue only one network with empty name is allowed + if c.BridgeName == o.BridgeName { + return fmt.Errorf("networks have same bridge name") + } + + // They must be in different subnets + if (c.AddressIPv4 != nil && o.AddressIPv4 != nil) && + (c.AddressIPv4.Contains(o.AddressIPv4.IP) || o.AddressIPv4.Contains(c.AddressIPv4.IP)) { + return fmt.Errorf("networks have overlapping IPv4") + } + + // They must be in different v6 subnets + if (c.AddressIPv6 != nil && o.AddressIPv6 != nil) && + (c.AddressIPv6.Contains(o.AddressIPv6.IP) || o.AddressIPv6.Contains(c.AddressIPv6.IP)) { + return fmt.Errorf("networks have overlapping IPv6") + } + + return nil +} + +func (c *networkConfiguration) fromLabels(labels map[string]string) error { + var err error + for label, value := range labels { + switch label { + case BridgeName: + c.BridgeName = value + case netlabel.DriverMTU: + if c.Mtu, err = strconv.Atoi(value); err != nil { + return parseErr(label, value, err.Error()) + } + case netlabel.EnableIPv6: + if c.EnableIPv6, err = strconv.ParseBool(value); err != nil { + return parseErr(label, value, err.Error()) + } + case EnableIPMasquerade: + if c.EnableIPMasquerade, err = strconv.ParseBool(value); err != nil { + return parseErr(label, value, err.Error()) + } + case EnableICC: + if c.EnableICC, err = strconv.ParseBool(value); err != nil { + return parseErr(label, value, err.Error()) + } + case DefaultBridge: + if c.DefaultBridge, err = strconv.ParseBool(value); err != nil { + return parseErr(label, value, err.Error()) + } + case DefaultBindingIP: + if c.DefaultBindingIP = net.ParseIP(value); c.DefaultBindingIP == nil { + return parseErr(label, value, "nil ip") + } + } + } + + return nil +} + +func parseErr(label, value, errString string) error { + return types.BadRequestErrorf("failed to parse %s value: %v (%s)", label, value, errString) +} + +func (n *bridgeNetwork) getDriverChains() (*iptables.ChainInfo, *iptables.ChainInfo, error) { + n.Lock() + defer n.Unlock() + + if n.driver == nil { + return nil, nil, types.BadRequestErrorf("no driver found") + } + + return n.driver.natChain, n.driver.filterChain, nil +} + +func (n *bridgeNetwork) getNetworkBridgeName() string { + n.Lock() + config := n.config + n.Unlock() + + return config.BridgeName +} + +func (n *bridgeNetwork) getEndpoint(eid string) (*bridgeEndpoint, error) { + n.Lock() + defer n.Unlock() + + if eid == "" { + return nil, InvalidEndpointIDError(eid) + } + + if ep, ok := n.endpoints[eid]; ok { + return ep, nil + } + + return nil, nil +} + +// Install/Removes the iptables rules needed to isolate this network +// from each of the other networks +func (n *bridgeNetwork) isolateNetwork(others []*bridgeNetwork, enable bool) error { + n.Lock() + thisV4 := n.bridge.bridgeIPv4 + thisV6 := getV6Network(n.config, n.bridge) + n.Unlock() + + // Install the rules to isolate this networks against each of the other networks + for _, o := range others { + o.Lock() + otherV4 := o.bridge.bridgeIPv4 + otherV6 := getV6Network(o.config, o.bridge) + o.Unlock() + + if !types.CompareIPNet(thisV4, otherV4) { + // It's ok to pass a.b.c.d/x, iptables will ignore the host subnet bits + if err := setINC(thisV4.String(), otherV4.String(), enable); err != nil { + return err + } + } + + if thisV6 != nil && otherV6 != nil && !types.CompareIPNet(thisV6, otherV6) { + if err := setINC(thisV6.String(), otherV6.String(), enable); err != nil { + return err + } + } + } + + return nil +} + +// Checks whether this network's configuration for the network with this id conflicts with any of the passed networks +func (c *networkConfiguration) conflictsWithNetworks(id string, others []*bridgeNetwork) error { + for _, nw := range others { + + nw.Lock() + nwID := nw.id + nwConfig := nw.config + nwBridge := nw.bridge + nw.Unlock() + + if nwID == id { + continue + } + // Verify the name (which may have been set by newInterface()) does not conflict with + // existing bridge interfaces. Ironically the system chosen name gets stored in the config... + // Basically we are checking if the two original configs were both empty. + if nwConfig.BridgeName == c.BridgeName { + return types.ForbiddenErrorf("conflicts with network %s (%s) by bridge name", nwID, nwConfig.BridgeName) + } + // If this network config specifies the AddressIPv4, we need + // to make sure it does not conflict with any previously allocated + // bridges. This could not be completely caught by the config conflict + // check, because networks which config does not specify the AddressIPv4 + // get their address and subnet selected by the driver (see electBridgeIPv4()) + if c.AddressIPv4 != nil { + if nwBridge.bridgeIPv4.Contains(c.AddressIPv4.IP) || + c.AddressIPv4.Contains(nwBridge.bridgeIPv4.IP) { + return types.ForbiddenErrorf("conflicts with network %s (%s) by ip network", nwID, nwConfig.BridgeName) + } + } + } + + return nil +} + +func (d *driver) configure(option map[string]interface{}) error { + var ( + config *configuration + err error + natChain, filterChain *iptables.ChainInfo + ) + + genericData, ok := option[netlabel.GenericData] + if !ok || genericData == nil { + return nil + } + + switch opt := genericData.(type) { + case options.Generic: + opaqueConfig, err := options.GenerateFromModel(opt, &configuration{}) + if err != nil { + return err + } + config = opaqueConfig.(*configuration) + case *configuration: + config = opt + default: + return &ErrInvalidDriverConfig{} + } + + if config.EnableIPForwarding { + err = setupIPForwarding() + if err != nil { + return err + } + } + + if config.EnableIPTables { + natChain, filterChain, err = setupIPChains(config) + if err != nil { + return err + } + } + + d.Lock() + d.natChain = natChain + d.filterChain = filterChain + d.config = config + d.Unlock() + + err = d.initStore(option) + if err != nil { + return err + } + + return nil +} + +func (d *driver) getNetwork(id string) (*bridgeNetwork, error) { + d.Lock() + defer d.Unlock() + + if id == "" { + return nil, types.BadRequestErrorf("invalid network id: %s", id) + } + + if nw, ok := d.networks[id]; ok { + return nw, nil + } + + return nil, types.NotFoundErrorf("network not found: %s", id) +} + +func parseNetworkGenericOptions(data interface{}) (*networkConfiguration, error) { + var ( + err error + config *networkConfiguration + ) + + switch opt := data.(type) { + case *networkConfiguration: + config = opt + case map[string]string: + config = &networkConfiguration{ + EnableICC: true, + EnableIPMasquerade: true, + } + err = config.fromLabels(opt) + case options.Generic: + var opaqueConfig interface{} + if opaqueConfig, err = options.GenerateFromModel(opt, config); err == nil { + config = opaqueConfig.(*networkConfiguration) + } + default: + err = types.BadRequestErrorf("do not recognize network configuration format: %T", opt) + } + + return config, err +} + +func (c *networkConfiguration) processIPAM(id string, ipamV4Data, ipamV6Data []driverapi.IPAMData) error { + if len(ipamV4Data) > 1 || len(ipamV6Data) > 1 { + return types.ForbiddenErrorf("bridge driver doesnt support multiple subnets") + } + + if len(ipamV4Data) == 0 { + return types.BadRequestErrorf("bridge network %s requires ipv4 configuration", id) + } + + if ipamV4Data[0].Gateway != nil { + c.AddressIPv4 = types.GetIPNetCopy(ipamV4Data[0].Gateway) + } + + if gw, ok := ipamV4Data[0].AuxAddresses[DefaultGatewayV4AuxKey]; ok { + c.DefaultGatewayIPv4 = gw.IP + } + + if len(ipamV6Data) > 0 { + c.AddressIPv6 = ipamV6Data[0].Pool + + if ipamV6Data[0].Gateway != nil { + c.AddressIPv6 = types.GetIPNetCopy(ipamV6Data[0].Gateway) + } + + if gw, ok := ipamV6Data[0].AuxAddresses[DefaultGatewayV6AuxKey]; ok { + c.DefaultGatewayIPv6 = gw.IP + } + } + + return nil +} + +func parseNetworkOptions(id string, option options.Generic) (*networkConfiguration, error) { + var ( + err error + config = &networkConfiguration{} + ) + + // Parse generic label first, config will be re-assigned + if genData, ok := option[netlabel.GenericData]; ok && genData != nil { + if config, err = parseNetworkGenericOptions(genData); err != nil { + return nil, err + } + } + + // Process well-known labels next + if val, ok := option[netlabel.EnableIPv6]; ok { + config.EnableIPv6 = val.(bool) + } + + // Finally validate the configuration + if err = config.Validate(); err != nil { + return nil, err + } + + if config.BridgeName == "" && config.DefaultBridge == false { + config.BridgeName = "br-" + id[:12] + } + + config.ID = id + return config, nil +} + +// Returns the non link-local IPv6 subnet for the containers attached to this bridge if found, nil otherwise +func getV6Network(config *networkConfiguration, i *bridgeInterface) *net.IPNet { + if config.AddressIPv6 != nil { + return config.AddressIPv6 + } + if i.bridgeIPv6 != nil && i.bridgeIPv6.IP != nil && !i.bridgeIPv6.IP.IsLinkLocalUnicast() { + return i.bridgeIPv6 + } + + return nil +} + +// Return a slice of networks over which caller can iterate safely +func (d *driver) getNetworks() []*bridgeNetwork { + d.Lock() + defer d.Unlock() + + ls := make([]*bridgeNetwork, 0, len(d.networks)) + for _, nw := range d.networks { + ls = append(ls, nw) + } + return ls +} + +// Create a new network using bridge plugin +func (d *driver) CreateNetwork(id string, option map[string]interface{}, ipV4Data, ipV6Data []driverapi.IPAMData) error { + // Sanity checks + d.Lock() + if _, ok := d.networks[id]; ok { + d.Unlock() + return types.ForbiddenErrorf("network %s exists", id) + } + d.Unlock() + + // Parse and validate the config. It should not conflict with existing networks' config + config, err := parseNetworkOptions(id, option) + if err != nil { + return err + } + + err = config.processIPAM(id, ipV4Data, ipV6Data) + if err != nil { + return err + } + + if err = d.createNetwork(config); err != nil { + return err + } + + return d.storeUpdate(config) +} + +func (d *driver) createNetwork(config *networkConfiguration) error { + var err error + + defer osl.InitOSContext()() + + networkList := d.getNetworks() + for _, nw := range networkList { + nw.Lock() + nwConfig := nw.config + nw.Unlock() + if err := nwConfig.Conflicts(config); err != nil { + return types.ForbiddenErrorf("cannot create network %s (%s): conflicts with network %s (%s): %s", + nwConfig.BridgeName, config.ID, nw.id, nw.config.BridgeName, err.Error()) + } + } + + // Create and set network handler in driver + network := &bridgeNetwork{ + id: config.ID, + endpoints: make(map[string]*bridgeEndpoint), + config: config, + portMapper: portmapper.New(), + driver: d, + } + + d.Lock() + d.networks[config.ID] = network + d.Unlock() + + // On failure make sure to reset driver network handler to nil + defer func() { + if err != nil { + d.Lock() + delete(d.networks, config.ID) + d.Unlock() + } + }() + + // Create or retrieve the bridge L3 interface + bridgeIface := newInterface(config) + network.bridge = bridgeIface + + // Verify the network configuration does not conflict with previously installed + // networks. This step is needed now because driver might have now set the bridge + // name on this config struct. And because we need to check for possible address + // conflicts, so we need to check against operationa lnetworks. + if err = config.conflictsWithNetworks(config.ID, networkList); err != nil { + return err + } + + setupNetworkIsolationRules := func(config *networkConfiguration, i *bridgeInterface) error { + if err := network.isolateNetwork(networkList, true); err != nil { + if err := network.isolateNetwork(networkList, false); err != nil { + logrus.Warnf("Failed on removing the inter-network iptables rules on cleanup: %v", err) + } + return err + } + return nil + } + + // Prepare the bridge setup configuration + bridgeSetup := newBridgeSetup(config, bridgeIface) + + // If the bridge interface doesn't exist, we need to start the setup steps + // by creating a new device and assigning it an IPv4 address. + bridgeAlreadyExists := bridgeIface.exists() + if !bridgeAlreadyExists { + bridgeSetup.queueStep(setupDevice) + } + + // Even if a bridge exists try to setup IPv4. + bridgeSetup.queueStep(setupBridgeIPv4) + + enableIPv6Forwarding := d.config.EnableIPForwarding && config.AddressIPv6 != nil + + // Conditionally queue setup steps depending on configuration values. + for _, step := range []struct { + Condition bool + Fn setupStep + }{ + // Enable IPv6 on the bridge if required. We do this even for a + // previously existing bridge, as it may be here from a previous + // installation where IPv6 wasn't supported yet and needs to be + // assigned an IPv6 link-local address. + {config.EnableIPv6, setupBridgeIPv6}, + + // We ensure that the bridge has the expectedIPv4 and IPv6 addresses in + // the case of a previously existing device. + {bridgeAlreadyExists, setupVerifyAndReconcile}, + + // Enable IPv6 Forwarding + {enableIPv6Forwarding, setupIPv6Forwarding}, + + // Setup Loopback Adresses Routing + {!d.config.EnableUserlandProxy, setupLoopbackAdressesRouting}, + + // Setup IPTables. + {d.config.EnableIPTables, network.setupIPTables}, + + //We want to track firewalld configuration so that + //if it is started/reloaded, the rules can be applied correctly + {d.config.EnableIPTables, network.setupFirewalld}, + + // Setup DefaultGatewayIPv4 + {config.DefaultGatewayIPv4 != nil, setupGatewayIPv4}, + + // Setup DefaultGatewayIPv6 + {config.DefaultGatewayIPv6 != nil, setupGatewayIPv6}, + + // Add inter-network communication rules. + {d.config.EnableIPTables, setupNetworkIsolationRules}, + + //Configure bridge networking filtering if ICC is off and IP tables are enabled + {!config.EnableICC && d.config.EnableIPTables, setupBridgeNetFiltering}, + } { + if step.Condition { + bridgeSetup.queueStep(step.Fn) + } + } + + // Apply the prepared list of steps, and abort at the first error. + bridgeSetup.queueStep(setupDeviceUp) + if err = bridgeSetup.apply(); err != nil { + return err + } + + return nil +} + +func (d *driver) DeleteNetwork(nid string) error { + var err error + + defer osl.InitOSContext()() + + // Get network handler and remove it from driver + d.Lock() + n, ok := d.networks[nid] + d.Unlock() + + if !ok { + return types.InternalMaskableErrorf("network %s does not exist", nid) + } + + n.Lock() + config := n.config + n.Unlock() + + d.Lock() + delete(d.networks, nid) + d.Unlock() + + // On failure set network handler back in driver, but + // only if is not already taken over by some other thread + defer func() { + if err != nil { + d.Lock() + if _, ok := d.networks[nid]; !ok { + d.networks[nid] = n + } + d.Unlock() + } + }() + + // Sanity check + if n == nil { + err = driverapi.ErrNoNetwork(nid) + return err + } + + // Cannot remove network if endpoints are still present + if len(n.endpoints) != 0 { + err = ActiveEndpointsError(n.id) + return err + } + + // In case of failures after this point, restore the network isolation rules + nwList := d.getNetworks() + defer func() { + if err != nil { + if err := n.isolateNetwork(nwList, true); err != nil { + logrus.Warnf("Failed on restoring the inter-network iptables rules on cleanup: %v", err) + } + } + }() + + // Remove inter-network communication rules. + err = n.isolateNetwork(nwList, false) + if err != nil { + return err + } + + // We only delete the bridge when it's not the default bridge. This is keep the backward compatible behavior. + if !config.DefaultBridge { + if err := netlink.LinkDel(n.bridge.Link); err != nil { + logrus.Warnf("Failed to remove bridge interface %s on network %s delete: %v", config.BridgeName, nid, err) + } + } + + return d.storeDelete(config) +} + +func addToBridge(ifaceName, bridgeName string) error { + link, err := netlink.LinkByName(ifaceName) + if err != nil { + return fmt.Errorf("could not find interface %s: %v", ifaceName, err) + } + if err = netlink.LinkSetMaster(link, + &netlink.Bridge{LinkAttrs: netlink.LinkAttrs{Name: bridgeName}}); err != nil { + logrus.Debugf("Failed to add %s to bridge via netlink.Trying ioctl: %v", ifaceName, err) + iface, err := net.InterfaceByName(ifaceName) + if err != nil { + return fmt.Errorf("could not find network interface %s: %v", ifaceName, err) + } + + master, err := net.InterfaceByName(bridgeName) + if err != nil { + return fmt.Errorf("could not find bridge %s: %v", bridgeName, err) + } + + return ioctlAddToBridge(iface, master) + } + return nil +} + +func setHairpinMode(link netlink.Link, enable bool) error { + err := netlink.LinkSetHairpin(link, enable) + if err != nil && err != syscall.EINVAL { + // If error is not EINVAL something else went wrong, bail out right away + return fmt.Errorf("unable to set hairpin mode on %s via netlink: %v", + link.Attrs().Name, err) + } + + // Hairpin mode successfully set up + if err == nil { + return nil + } + + // The netlink method failed with EINVAL which is probably because of an older + // kernel. Try one more time via the sysfs method. + path := filepath.Join("/sys/class/net", link.Attrs().Name, "brport/hairpin_mode") + + var val []byte + if enable { + val = []byte{'1', '\n'} + } else { + val = []byte{'0', '\n'} + } + + if err := ioutil.WriteFile(path, val, 0644); err != nil { + return fmt.Errorf("unable to set hairpin mode on %s via sysfs: %v", link.Attrs().Name, err) + } + + return nil +} + +func (d *driver) CreateEndpoint(nid, eid string, ifInfo driverapi.InterfaceInfo, epOptions map[string]interface{}) error { + defer osl.InitOSContext()() + + if ifInfo == nil { + return errors.New("invalid interface info passed") + } + + // Get the network handler and make sure it exists + d.Lock() + n, ok := d.networks[nid] + dconfig := d.config + d.Unlock() + + if !ok { + return types.NotFoundErrorf("network %s does not exist", nid) + } + if n == nil { + return driverapi.ErrNoNetwork(nid) + } + + // Sanity check + n.Lock() + if n.id != nid { + n.Unlock() + return InvalidNetworkIDError(nid) + } + n.Unlock() + + // Check if endpoint id is good and retrieve correspondent endpoint + ep, err := n.getEndpoint(eid) + if err != nil { + return err + } + + // Endpoint with that id exists either on desired or other sandbox + if ep != nil { + return driverapi.ErrEndpointExists(eid) + } + + // Try to convert the options to endpoint configuration + epConfig, err := parseEndpointOptions(epOptions) + if err != nil { + return err + } + + // Create and add the endpoint + n.Lock() + endpoint := &bridgeEndpoint{id: eid, config: epConfig} + n.endpoints[eid] = endpoint + n.Unlock() + + // On failure make sure to remove the endpoint + defer func() { + if err != nil { + n.Lock() + delete(n.endpoints, eid) + n.Unlock() + } + }() + + // Generate a name for what will be the host side pipe interface + hostIfName, err := netutils.GenerateIfaceName(vethPrefix, vethLen) + if err != nil { + return err + } + + // Generate a name for what will be the sandbox side pipe interface + containerIfName, err := netutils.GenerateIfaceName(vethPrefix, vethLen) + if err != nil { + return err + } + + // Generate and add the interface pipe host <-> sandbox + veth := &netlink.Veth{ + LinkAttrs: netlink.LinkAttrs{Name: hostIfName, TxQLen: 0}, + PeerName: containerIfName} + if err = netlink.LinkAdd(veth); err != nil { + return types.InternalErrorf("failed to add the host (%s) <=> sandbox (%s) pair interfaces: %v", hostIfName, containerIfName, err) + } + + // Get the host side pipe interface handler + host, err := netlink.LinkByName(hostIfName) + if err != nil { + return types.InternalErrorf("failed to find host side interface %s: %v", hostIfName, err) + } + defer func() { + if err != nil { + netlink.LinkDel(host) + } + }() + + // Get the sandbox side pipe interface handler + sbox, err := netlink.LinkByName(containerIfName) + if err != nil { + return types.InternalErrorf("failed to find sandbox side interface %s: %v", containerIfName, err) + } + defer func() { + if err != nil { + netlink.LinkDel(sbox) + } + }() + + n.Lock() + config := n.config + n.Unlock() + + // Add bridge inherited attributes to pipe interfaces + if config.Mtu != 0 { + err = netlink.LinkSetMTU(host, config.Mtu) + if err != nil { + return types.InternalErrorf("failed to set MTU on host interface %s: %v", hostIfName, err) + } + err = netlink.LinkSetMTU(sbox, config.Mtu) + if err != nil { + return types.InternalErrorf("failed to set MTU on sandbox interface %s: %v", containerIfName, err) + } + } + + // Attach host side pipe interface into the bridge + if err = addToBridge(hostIfName, config.BridgeName); err != nil { + return fmt.Errorf("adding interface %s to bridge %s failed: %v", hostIfName, config.BridgeName, err) + } + + if !dconfig.EnableUserlandProxy { + err = setHairpinMode(host, true) + if err != nil { + return err + } + } + + // Create the sandbox side pipe interface + endpoint.srcName = containerIfName + endpoint.macAddress = ifInfo.MacAddress() + endpoint.addr = ifInfo.Address() + endpoint.addrv6 = ifInfo.AddressIPv6() + + // Down the interface before configuring mac address. + if err = netlink.LinkSetDown(sbox); err != nil { + return fmt.Errorf("could not set link down for container interface %s: %v", containerIfName, err) + } + + // Set the sbox's MAC. If specified, use the one configured by user, otherwise generate one based on IP. + if endpoint.macAddress == nil { + endpoint.macAddress = electMacAddress(epConfig, endpoint.addr.IP) + if err := ifInfo.SetMacAddress(endpoint.macAddress); err != nil { + return err + } + } + err = netlink.LinkSetHardwareAddr(sbox, endpoint.macAddress) + if err != nil { + return fmt.Errorf("could not set mac address for container interface %s: %v", containerIfName, err) + } + + // Up the host interface after finishing all netlink configuration + if err = netlink.LinkSetUp(host); err != nil { + return fmt.Errorf("could not set link up for host interface %s: %v", hostIfName, err) + } + + if endpoint.addrv6 == nil && config.EnableIPv6 { + var ip6 net.IP + network := n.bridge.bridgeIPv6 + if config.AddressIPv6 != nil { + network = config.AddressIPv6 + } + + ones, _ := network.Mask.Size() + if ones > 80 { + err = types.ForbiddenErrorf("Cannot self generate an IPv6 address on network %v: At least 48 host bits are needed.", network) + return err + } + + ip6 = make(net.IP, len(network.IP)) + copy(ip6, network.IP) + for i, h := range endpoint.macAddress { + ip6[i+10] = h + } + + endpoint.addrv6 = &net.IPNet{IP: ip6, Mask: network.Mask} + if err := ifInfo.SetIPAddress(endpoint.addrv6); err != nil { + return err + } + } + + // Program any required port mapping and store them in the endpoint + endpoint.portMapping, err = n.allocatePorts(epConfig, endpoint, config.DefaultBindingIP, d.config.EnableUserlandProxy) + if err != nil { + return err + } + + return nil +} + +func (d *driver) DeleteEndpoint(nid, eid string) error { + var err error + + defer osl.InitOSContext()() + + // Get the network handler and make sure it exists + d.Lock() + n, ok := d.networks[nid] + d.Unlock() + + if !ok { + return types.InternalMaskableErrorf("network %s does not exist", nid) + } + if n == nil { + return driverapi.ErrNoNetwork(nid) + } + + // Sanity Check + n.Lock() + if n.id != nid { + n.Unlock() + return InvalidNetworkIDError(nid) + } + n.Unlock() + + // Check endpoint id and if an endpoint is actually there + ep, err := n.getEndpoint(eid) + if err != nil { + return err + } + if ep == nil { + return EndpointNotFoundError(eid) + } + + // Remove it + n.Lock() + delete(n.endpoints, eid) + n.Unlock() + + // On failure make sure to set back ep in n.endpoints, but only + // if it hasn't been taken over already by some other thread. + defer func() { + if err != nil { + n.Lock() + if _, ok := n.endpoints[eid]; !ok { + n.endpoints[eid] = ep + } + n.Unlock() + } + }() + + // Remove port mappings. Do not stop endpoint delete on unmap failure + n.releasePorts(ep) + + // Try removal of link. Discard error: it is a best effort. + // Also make sure defer does not see this error either. + if link, err := netlink.LinkByName(ep.srcName); err == nil { + netlink.LinkDel(link) + } + + return nil +} + +func (d *driver) EndpointOperInfo(nid, eid string) (map[string]interface{}, error) { + // Get the network handler and make sure it exists + d.Lock() + n, ok := d.networks[nid] + d.Unlock() + if !ok { + return nil, types.NotFoundErrorf("network %s does not exist", nid) + } + if n == nil { + return nil, driverapi.ErrNoNetwork(nid) + } + + // Sanity check + n.Lock() + if n.id != nid { + n.Unlock() + return nil, InvalidNetworkIDError(nid) + } + n.Unlock() + + // Check if endpoint id is good and retrieve correspondent endpoint + ep, err := n.getEndpoint(eid) + if err != nil { + return nil, err + } + if ep == nil { + return nil, driverapi.ErrNoEndpoint(eid) + } + + m := make(map[string]interface{}) + + if ep.config.ExposedPorts != nil { + // Return a copy of the config data + epc := make([]types.TransportPort, 0, len(ep.config.ExposedPorts)) + for _, tp := range ep.config.ExposedPorts { + epc = append(epc, tp.GetCopy()) + } + m[netlabel.ExposedPorts] = epc + } + + if ep.portMapping != nil { + // Return a copy of the operational data + pmc := make([]types.PortBinding, 0, len(ep.portMapping)) + for _, pm := range ep.portMapping { + pmc = append(pmc, pm.GetCopy()) + } + m[netlabel.PortMap] = pmc + } + + if len(ep.macAddress) != 0 { + m[netlabel.MacAddress] = ep.macAddress + } + + return m, nil +} + +// Join method is invoked when a Sandbox is attached to an endpoint. +func (d *driver) Join(nid, eid string, sboxKey string, jinfo driverapi.JoinInfo, options map[string]interface{}) error { + defer osl.InitOSContext()() + + network, err := d.getNetwork(nid) + if err != nil { + return err + } + + endpoint, err := network.getEndpoint(eid) + if err != nil { + return err + } + + if endpoint == nil { + return EndpointNotFoundError(eid) + } + + iNames := jinfo.InterfaceName() + err = iNames.SetNames(endpoint.srcName, containerVethPrefix) + if err != nil { + return err + } + + err = jinfo.SetGateway(network.bridge.gatewayIPv4) + if err != nil { + return err + } + + err = jinfo.SetGatewayIPv6(network.bridge.gatewayIPv6) + if err != nil { + return err + } + + if !network.config.EnableICC { + return d.link(network, endpoint, options, true) + } + + return nil +} + +// Leave method is invoked when a Sandbox detaches from an endpoint. +func (d *driver) Leave(nid, eid string) error { + defer osl.InitOSContext()() + + network, err := d.getNetwork(nid) + if err != nil { + return types.InternalMaskableErrorf("%s", err) + } + + endpoint, err := network.getEndpoint(eid) + if err != nil { + return err + } + + if endpoint == nil { + return EndpointNotFoundError(eid) + } + + if !network.config.EnableICC { + return d.link(network, endpoint, nil, false) + } + + return nil +} + +func (d *driver) link(network *bridgeNetwork, endpoint *bridgeEndpoint, options map[string]interface{}, enable bool) error { + var ( + cc *containerConfiguration + err error + ) + + if enable { + cc, err = parseContainerOptions(options) + if err != nil { + return err + } + } else { + cc = endpoint.containerConfig + } + + if cc == nil { + return nil + } + + if endpoint.config != nil && endpoint.config.ExposedPorts != nil { + for _, p := range cc.ParentEndpoints { + var parentEndpoint *bridgeEndpoint + parentEndpoint, err = network.getEndpoint(p) + if err != nil { + return err + } + if parentEndpoint == nil { + err = InvalidEndpointIDError(p) + return err + } + + l := newLink(parentEndpoint.addr.IP.String(), + endpoint.addr.IP.String(), + endpoint.config.ExposedPorts, network.config.BridgeName) + if enable { + err = l.Enable() + if err != nil { + return err + } + defer func() { + if err != nil { + l.Disable() + } + }() + } else { + l.Disable() + } + } + } + + for _, c := range cc.ChildEndpoints { + var childEndpoint *bridgeEndpoint + childEndpoint, err = network.getEndpoint(c) + if err != nil { + return err + } + if childEndpoint == nil { + err = InvalidEndpointIDError(c) + return err + } + if childEndpoint.config == nil || childEndpoint.config.ExposedPorts == nil { + continue + } + + l := newLink(endpoint.addr.IP.String(), + childEndpoint.addr.IP.String(), + childEndpoint.config.ExposedPorts, network.config.BridgeName) + if enable { + err = l.Enable() + if err != nil { + return err + } + defer func() { + if err != nil { + l.Disable() + } + }() + } else { + l.Disable() + } + } + + if enable { + endpoint.containerConfig = cc + } + + return nil +} + +func (d *driver) Type() string { + return networkType +} + +// DiscoverNew is a notification for a new discovery event, such as a new node joining a cluster +func (d *driver) DiscoverNew(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} + +// DiscoverDelete is a notification for a discovery delete event, such as a node leaving a cluster +func (d *driver) DiscoverDelete(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} + +func parseEndpointOptions(epOptions map[string]interface{}) (*endpointConfiguration, error) { + if epOptions == nil { + return nil, nil + } + + ec := &endpointConfiguration{} + + if opt, ok := epOptions[netlabel.MacAddress]; ok { + if mac, ok := opt.(net.HardwareAddr); ok { + ec.MacAddress = mac + } else { + return nil, &ErrInvalidEndpointConfig{} + } + } + + if opt, ok := epOptions[netlabel.PortMap]; ok { + if bs, ok := opt.([]types.PortBinding); ok { + ec.PortBindings = bs + } else { + return nil, &ErrInvalidEndpointConfig{} + } + } + + if opt, ok := epOptions[netlabel.ExposedPorts]; ok { + if ports, ok := opt.([]types.TransportPort); ok { + ec.ExposedPorts = ports + } else { + return nil, &ErrInvalidEndpointConfig{} + } + } + + return ec, nil +} + +func parseContainerOptions(cOptions map[string]interface{}) (*containerConfiguration, error) { + if cOptions == nil { + return nil, nil + } + genericData := cOptions[netlabel.GenericData] + if genericData == nil { + return nil, nil + } + switch opt := genericData.(type) { + case options.Generic: + opaqueConfig, err := options.GenerateFromModel(opt, &containerConfiguration{}) + if err != nil { + return nil, err + } + return opaqueConfig.(*containerConfiguration), nil + case *containerConfiguration: + return opt, nil + default: + return nil, nil + } +} + +func electMacAddress(epConfig *endpointConfiguration, ip net.IP) net.HardwareAddr { + if epConfig != nil && epConfig.MacAddress != nil { + return epConfig.MacAddress + } + return netutils.GenerateMACFromIP(ip) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge_store.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge_store.go new file mode 100644 index 0000000000..96c31d87e8 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/bridge_store.go @@ -0,0 +1,211 @@ +package bridge + +import ( + "encoding/json" + "fmt" + "net" + + "github.com/Sirupsen/logrus" + "github.com/docker/libkv/store" + "github.com/docker/libkv/store/boltdb" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/types" +) + +const bridgePrefix = "bridge" + +func (d *driver) initStore(option map[string]interface{}) error { + var err error + + provider, provOk := option[netlabel.LocalKVProvider] + provURL, urlOk := option[netlabel.LocalKVProviderURL] + + if provOk && urlOk { + cfg := &datastore.ScopeCfg{ + Client: datastore.ScopeClientCfg{ + Provider: provider.(string), + Address: provURL.(string), + }, + } + + provConfig, confOk := option[netlabel.LocalKVProviderConfig] + if confOk { + cfg.Client.Config = provConfig.(*store.Config) + } + + d.store, err = datastore.NewDataStore(datastore.LocalScope, cfg) + if err != nil { + return fmt.Errorf("bridge driver failed to initialize data store: %v", err) + } + + return d.populateNetworks() + } + + return nil +} + +func (d *driver) populateNetworks() error { + kvol, err := d.store.List(datastore.Key(bridgePrefix), &networkConfiguration{}) + if err != nil && err != datastore.ErrKeyNotFound && err != boltdb.ErrBoltBucketNotFound { + return fmt.Errorf("failed to get bridge network configurations from store: %v", err) + } + + // It's normal for network configuration state to be empty. Just return. + if err == datastore.ErrKeyNotFound { + return nil + } + + for _, kvo := range kvol { + ncfg := kvo.(*networkConfiguration) + if err = d.createNetwork(ncfg); err != nil { + logrus.Warnf("could not create bridge network for id %s bridge name %s while booting up from persistent state", ncfg.ID, ncfg.BridgeName) + } + } + + return nil +} + +func (d *driver) storeUpdate(kvObject datastore.KVObject) error { + if d.store == nil { + logrus.Warnf("bridge store not initialized. kv object %s is not added to the store", datastore.Key(kvObject.Key()...)) + return nil + } + + if err := d.store.PutObjectAtomic(kvObject); err != nil { + return fmt.Errorf("failed to update bridge store for object type %T: %v", kvObject, err) + } + + return nil +} + +func (d *driver) storeDelete(kvObject datastore.KVObject) error { + if d.store == nil { + logrus.Debugf("bridge store not initialized. kv object %s is not deleted from store", datastore.Key(kvObject.Key()...)) + return nil + } + +retry: + if err := d.store.DeleteObjectAtomic(kvObject); err != nil { + if err == datastore.ErrKeyModified { + if err := d.store.GetObject(datastore.Key(kvObject.Key()...), kvObject); err != nil { + return fmt.Errorf("could not update the kvobject to latest when trying to delete: %v", err) + } + goto retry + } + return err + } + + return nil +} + +func (ncfg *networkConfiguration) MarshalJSON() ([]byte, error) { + nMap := make(map[string]interface{}) + nMap["ID"] = ncfg.ID + nMap["BridgeName"] = ncfg.BridgeName + nMap["EnableIPv6"] = ncfg.EnableIPv6 + nMap["EnableIPMasquerade"] = ncfg.EnableIPMasquerade + nMap["EnableICC"] = ncfg.EnableICC + nMap["Mtu"] = ncfg.Mtu + nMap["DefaultBridge"] = ncfg.DefaultBridge + nMap["DefaultBindingIP"] = ncfg.DefaultBindingIP.String() + nMap["DefaultGatewayIPv4"] = ncfg.DefaultGatewayIPv4.String() + nMap["DefaultGatewayIPv6"] = ncfg.DefaultGatewayIPv6.String() + + if ncfg.AddressIPv4 != nil { + nMap["AddressIPv4"] = ncfg.AddressIPv4.String() + } + + if ncfg.AddressIPv6 != nil { + nMap["AddressIPv6"] = ncfg.AddressIPv6.String() + } + + return json.Marshal(nMap) +} + +func (ncfg *networkConfiguration) UnmarshalJSON(b []byte) error { + var ( + err error + nMap map[string]interface{} + ) + + if err = json.Unmarshal(b, &nMap); err != nil { + return err + } + + if v, ok := nMap["AddressIPv4"]; ok { + if ncfg.AddressIPv4, err = types.ParseCIDR(v.(string)); err != nil { + return types.InternalErrorf("failed to decode bridge network address IPv4 after json unmarshal: %s", v.(string)) + } + } + + if v, ok := nMap["AddressIPv6"]; ok { + if ncfg.AddressIPv6, err = types.ParseCIDR(v.(string)); err != nil { + return types.InternalErrorf("failed to decode bridge network address IPv6 after json unmarshal: %s", v.(string)) + } + } + + ncfg.DefaultBridge = nMap["DefaultBridge"].(bool) + ncfg.DefaultBindingIP = net.ParseIP(nMap["DefaultBindingIP"].(string)) + ncfg.DefaultGatewayIPv4 = net.ParseIP(nMap["DefaultGatewayIPv4"].(string)) + ncfg.DefaultGatewayIPv6 = net.ParseIP(nMap["DefaultGatewayIPv6"].(string)) + ncfg.ID = nMap["ID"].(string) + ncfg.BridgeName = nMap["BridgeName"].(string) + ncfg.EnableIPv6 = nMap["EnableIPv6"].(bool) + ncfg.EnableIPMasquerade = nMap["EnableIPMasquerade"].(bool) + ncfg.EnableICC = nMap["EnableICC"].(bool) + ncfg.Mtu = int(nMap["Mtu"].(float64)) + + return nil +} + +func (ncfg *networkConfiguration) Key() []string { + return []string{bridgePrefix, ncfg.ID} +} + +func (ncfg *networkConfiguration) KeyPrefix() []string { + return []string{bridgePrefix} +} + +func (ncfg *networkConfiguration) Value() []byte { + b, err := json.Marshal(ncfg) + if err != nil { + return nil + } + return b +} + +func (ncfg *networkConfiguration) SetValue(value []byte) error { + return json.Unmarshal(value, ncfg) +} + +func (ncfg *networkConfiguration) Index() uint64 { + return ncfg.dbIndex +} + +func (ncfg *networkConfiguration) SetIndex(index uint64) { + ncfg.dbIndex = index + ncfg.dbExists = true +} + +func (ncfg *networkConfiguration) Exists() bool { + return ncfg.dbExists +} + +func (ncfg *networkConfiguration) Skip() bool { + return ncfg.DefaultBridge +} + +func (ncfg *networkConfiguration) New() datastore.KVObject { + return &networkConfiguration{} +} + +func (ncfg *networkConfiguration) CopyTo(o datastore.KVObject) error { + dstNcfg := o.(*networkConfiguration) + *dstNcfg = *ncfg + return nil +} + +func (ncfg *networkConfiguration) DataScope() string { + return datastore.LocalScope +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/errors.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/errors.go new file mode 100644 index 0000000000..0e0d67aa69 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/errors.go @@ -0,0 +1,341 @@ +package bridge + +import ( + "fmt" + "net" +) + +// ErrConfigExists error is returned when driver already has a config applied. +type ErrConfigExists struct{} + +func (ece *ErrConfigExists) Error() string { + return "configuration already exists, bridge configuration can be applied only once" +} + +// Forbidden denotes the type of this error +func (ece *ErrConfigExists) Forbidden() {} + +// ErrInvalidDriverConfig error is returned when Bridge Driver is passed an invalid config +type ErrInvalidDriverConfig struct{} + +func (eidc *ErrInvalidDriverConfig) Error() string { + return "Invalid configuration passed to Bridge Driver" +} + +// BadRequest denotes the type of this error +func (eidc *ErrInvalidDriverConfig) BadRequest() {} + +// ErrInvalidNetworkConfig error is returned when a network is created on a driver without valid config. +type ErrInvalidNetworkConfig struct{} + +func (einc *ErrInvalidNetworkConfig) Error() string { + return "trying to create a network on a driver without valid config" +} + +// Forbidden denotes the type of this error +func (einc *ErrInvalidNetworkConfig) Forbidden() {} + +// ErrInvalidContainerConfig error is returned when a endpoint create is attempted with an invalid configuration. +type ErrInvalidContainerConfig struct{} + +func (eicc *ErrInvalidContainerConfig) Error() string { + return "Error in joining a container due to invalid configuration" +} + +// BadRequest denotes the type of this error +func (eicc *ErrInvalidContainerConfig) BadRequest() {} + +// ErrInvalidEndpointConfig error is returned when a endpoint create is attempted with an invalid endpoint configuration. +type ErrInvalidEndpointConfig struct{} + +func (eiec *ErrInvalidEndpointConfig) Error() string { + return "trying to create an endpoint with an invalid endpoint configuration" +} + +// BadRequest denotes the type of this error +func (eiec *ErrInvalidEndpointConfig) BadRequest() {} + +// ErrNetworkExists error is returned when a network already exists and another network is created. +type ErrNetworkExists struct{} + +func (ene *ErrNetworkExists) Error() string { + return "network already exists, bridge can only have one network" +} + +// Forbidden denotes the type of this error +func (ene *ErrNetworkExists) Forbidden() {} + +// ErrIfaceName error is returned when a new name could not be generated. +type ErrIfaceName struct{} + +func (ein *ErrIfaceName) Error() string { + return "failed to find name for new interface" +} + +// InternalError denotes the type of this error +func (ein *ErrIfaceName) InternalError() {} + +// ErrNoIPAddr error is returned when bridge has no IPv4 address configured. +type ErrNoIPAddr struct{} + +func (enip *ErrNoIPAddr) Error() string { + return "bridge has no IPv4 address configured" +} + +// InternalError denotes the type of this error +func (enip *ErrNoIPAddr) InternalError() {} + +// ErrInvalidGateway is returned when the user provided default gateway (v4/v6) is not not valid. +type ErrInvalidGateway struct{} + +func (eig *ErrInvalidGateway) Error() string { + return "default gateway ip must be part of the network" +} + +// BadRequest denotes the type of this error +func (eig *ErrInvalidGateway) BadRequest() {} + +// ErrInvalidContainerSubnet is returned when the container subnet (FixedCIDR) is not valid. +type ErrInvalidContainerSubnet struct{} + +func (eis *ErrInvalidContainerSubnet) Error() string { + return "container subnet must be a subset of bridge network" +} + +// BadRequest denotes the type of this error +func (eis *ErrInvalidContainerSubnet) BadRequest() {} + +// ErrInvalidMtu is returned when the user provided MTU is not valid. +type ErrInvalidMtu int + +func (eim ErrInvalidMtu) Error() string { + return fmt.Sprintf("invalid MTU number: %d", int(eim)) +} + +// BadRequest denotes the type of this error +func (eim ErrInvalidMtu) BadRequest() {} + +// ErrInvalidPort is returned when the container or host port specified in the port binding is not valid. +type ErrInvalidPort string + +func (ip ErrInvalidPort) Error() string { + return fmt.Sprintf("invalid transport port: %s", string(ip)) +} + +// BadRequest denotes the type of this error +func (ip ErrInvalidPort) BadRequest() {} + +// ErrUnsupportedAddressType is returned when the specified address type is not supported. +type ErrUnsupportedAddressType string + +func (uat ErrUnsupportedAddressType) Error() string { + return fmt.Sprintf("unsupported address type: %s", string(uat)) +} + +// BadRequest denotes the type of this error +func (uat ErrUnsupportedAddressType) BadRequest() {} + +// ErrInvalidAddressBinding is returned when the host address specified in the port binding is not valid. +type ErrInvalidAddressBinding string + +func (iab ErrInvalidAddressBinding) Error() string { + return fmt.Sprintf("invalid host address in port binding: %s", string(iab)) +} + +// BadRequest denotes the type of this error +func (iab ErrInvalidAddressBinding) BadRequest() {} + +// ActiveEndpointsError is returned when there are +// still active endpoints in the network being deleted. +type ActiveEndpointsError string + +func (aee ActiveEndpointsError) Error() string { + return fmt.Sprintf("network %s has active endpoint", string(aee)) +} + +// Forbidden denotes the type of this error +func (aee ActiveEndpointsError) Forbidden() {} + +// InvalidNetworkIDError is returned when the passed +// network id for an existing network is not a known id. +type InvalidNetworkIDError string + +func (inie InvalidNetworkIDError) Error() string { + return fmt.Sprintf("invalid network id %s", string(inie)) +} + +// NotFound denotes the type of this error +func (inie InvalidNetworkIDError) NotFound() {} + +// InvalidEndpointIDError is returned when the passed +// endpoint id is not valid. +type InvalidEndpointIDError string + +func (ieie InvalidEndpointIDError) Error() string { + return fmt.Sprintf("invalid endpoint id: %s", string(ieie)) +} + +// BadRequest denotes the type of this error +func (ieie InvalidEndpointIDError) BadRequest() {} + +// InvalidSandboxIDError is returned when the passed +// sandbox id is not valid. +type InvalidSandboxIDError string + +func (isie InvalidSandboxIDError) Error() string { + return fmt.Sprintf("invalid sanbox id: %s", string(isie)) +} + +// BadRequest denotes the type of this error +func (isie InvalidSandboxIDError) BadRequest() {} + +// EndpointNotFoundError is returned when the no endpoint +// with the passed endpoint id is found. +type EndpointNotFoundError string + +func (enfe EndpointNotFoundError) Error() string { + return fmt.Sprintf("endpoint not found: %s", string(enfe)) +} + +// NotFound denotes the type of this error +func (enfe EndpointNotFoundError) NotFound() {} + +// NonDefaultBridgeExistError is returned when a non-default +// bridge config is passed but it does not already exist. +type NonDefaultBridgeExistError string + +func (ndbee NonDefaultBridgeExistError) Error() string { + return fmt.Sprintf("bridge device with non default name %s must be created manually", string(ndbee)) +} + +// Forbidden denotes the type of this error +func (ndbee NonDefaultBridgeExistError) Forbidden() {} + +// NonDefaultBridgeNeedsIPError is returned when a non-default +// bridge config is passed but it has no ip configured +type NonDefaultBridgeNeedsIPError string + +func (ndbee NonDefaultBridgeNeedsIPError) Error() string { + return fmt.Sprintf("bridge device with non default name %s must have a valid IP address", string(ndbee)) +} + +// Forbidden denotes the type of this error +func (ndbee NonDefaultBridgeNeedsIPError) Forbidden() {} + +// FixedCIDRv4Error is returned when fixed-cidrv4 configuration +// failed. +type FixedCIDRv4Error struct { + Net *net.IPNet + Subnet *net.IPNet + Err error +} + +func (fcv4 *FixedCIDRv4Error) Error() string { + return fmt.Sprintf("setup FixedCIDRv4 failed for subnet %s in %s: %v", fcv4.Subnet, fcv4.Net, fcv4.Err) +} + +// InternalError denotes the type of this error +func (fcv4 *FixedCIDRv4Error) InternalError() {} + +// FixedCIDRv6Error is returned when fixed-cidrv6 configuration +// failed. +type FixedCIDRv6Error struct { + Net *net.IPNet + Err error +} + +func (fcv6 *FixedCIDRv6Error) Error() string { + return fmt.Sprintf("setup FixedCIDRv6 failed for subnet %s in %s: %v", fcv6.Net, fcv6.Net, fcv6.Err) +} + +// InternalError denotes the type of this error +func (fcv6 *FixedCIDRv6Error) InternalError() {} + +// IPTableCfgError is returned when an unexpected ip tables configuration is entered +type IPTableCfgError string + +func (name IPTableCfgError) Error() string { + return fmt.Sprintf("unexpected request to set IP tables for interface: %s", string(name)) +} + +// BadRequest denotes the type of this error +func (name IPTableCfgError) BadRequest() {} + +// InvalidIPTablesCfgError is returned when an invalid ip tables configuration is entered +type InvalidIPTablesCfgError string + +func (action InvalidIPTablesCfgError) Error() string { + return fmt.Sprintf("Invalid IPTables action '%s'", string(action)) +} + +// BadRequest denotes the type of this error +func (action InvalidIPTablesCfgError) BadRequest() {} + +// IPv4AddrRangeError is returned when a valid IP address range couldn't be found. +type IPv4AddrRangeError string + +func (name IPv4AddrRangeError) Error() string { + return fmt.Sprintf("can't find an address range for interface %q", string(name)) +} + +// BadRequest denotes the type of this error +func (name IPv4AddrRangeError) BadRequest() {} + +// IPv4AddrAddError is returned when IPv4 address could not be added to the bridge. +type IPv4AddrAddError struct { + IP *net.IPNet + Err error +} + +func (ipv4 *IPv4AddrAddError) Error() string { + return fmt.Sprintf("failed to add IPv4 address %s to bridge: %v", ipv4.IP, ipv4.Err) +} + +// InternalError denotes the type of this error +func (ipv4 *IPv4AddrAddError) InternalError() {} + +// IPv6AddrAddError is returned when IPv6 address could not be added to the bridge. +type IPv6AddrAddError struct { + IP *net.IPNet + Err error +} + +func (ipv6 *IPv6AddrAddError) Error() string { + return fmt.Sprintf("failed to add IPv6 address %s to bridge: %v", ipv6.IP, ipv6.Err) +} + +// InternalError denotes the type of this error +func (ipv6 *IPv6AddrAddError) InternalError() {} + +// IPv4AddrNoMatchError is returned when the bridge's IPv4 address does not match configured. +type IPv4AddrNoMatchError struct { + IP net.IP + CfgIP net.IP +} + +func (ipv4 *IPv4AddrNoMatchError) Error() string { + return fmt.Sprintf("bridge IPv4 (%s) does not match requested configuration %s", ipv4.IP, ipv4.CfgIP) +} + +// BadRequest denotes the type of this error +func (ipv4 *IPv4AddrNoMatchError) BadRequest() {} + +// IPv6AddrNoMatchError is returned when the bridge's IPv6 address does not match configured. +type IPv6AddrNoMatchError net.IPNet + +func (ipv6 *IPv6AddrNoMatchError) Error() string { + return fmt.Sprintf("bridge IPv6 addresses do not match the expected bridge configuration %s", (*net.IPNet)(ipv6).String()) +} + +// BadRequest denotes the type of this error +func (ipv6 *IPv6AddrNoMatchError) BadRequest() {} + +// InvalidLinkIPAddrError is returned when a link is configured to a container with an invalid ip address +type InvalidLinkIPAddrError string + +func (address InvalidLinkIPAddrError) Error() string { + return fmt.Sprintf("Cannot link to a container with Invalid IP Address '%s'", string(address)) +} + +// BadRequest denotes the type of this error +func (address InvalidLinkIPAddrError) BadRequest() {} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/interface.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/interface.go new file mode 100644 index 0000000000..b05f2ea804 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/interface.go @@ -0,0 +1,63 @@ +package bridge + +import ( + "net" + + "github.com/vishvananda/netlink" +) + +const ( + // DefaultBridgeName is the default name for the bridge interface managed + // by the driver when unspecified by the caller. + DefaultBridgeName = "docker0" +) + +// Interface models the bridge network device. +type bridgeInterface struct { + Link netlink.Link + bridgeIPv4 *net.IPNet + bridgeIPv6 *net.IPNet + gatewayIPv4 net.IP + gatewayIPv6 net.IP +} + +// newInterface creates a new bridge interface structure. It attempts to find +// an already existing device identified by the configuration BridgeName field, +// or the default bridge name when unspecified), but doesn't attempt to create +// one when missing +func newInterface(config *networkConfiguration) *bridgeInterface { + i := &bridgeInterface{} + + // Initialize the bridge name to the default if unspecified. + if config.BridgeName == "" { + config.BridgeName = DefaultBridgeName + } + + // Attempt to find an existing bridge named with the specified name. + i.Link, _ = netlink.LinkByName(config.BridgeName) + return i +} + +// exists indicates if the existing bridge interface exists on the system. +func (i *bridgeInterface) exists() bool { + return i.Link != nil +} + +// addresses returns a single IPv4 address and all IPv6 addresses for the +// bridge interface. +func (i *bridgeInterface) addresses() (netlink.Addr, []netlink.Addr, error) { + v4addr, err := netlink.AddrList(i.Link, netlink.FAMILY_V4) + if err != nil { + return netlink.Addr{}, nil, err + } + + v6addr, err := netlink.AddrList(i.Link, netlink.FAMILY_V6) + if err != nil { + return netlink.Addr{}, nil, err + } + + if len(v4addr) == 0 { + return netlink.Addr{}, v6addr, nil + } + return v4addr[0], v6addr, nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/labels.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/labels.go new file mode 100644 index 0000000000..7447bd3f93 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/labels.go @@ -0,0 +1,18 @@ +package bridge + +const ( + // BridgeName label for bridge driver + BridgeName = "com.docker.network.bridge.name" + + // EnableIPMasquerade label for bridge driver + EnableIPMasquerade = "com.docker.network.bridge.enable_ip_masquerade" + + // EnableICC label + EnableICC = "com.docker.network.bridge.enable_icc" + + // DefaultBindingIP label + DefaultBindingIP = "com.docker.network.bridge.host_binding_ipv4" + + // DefaultBridge label + DefaultBridge = "com.docker.network.bridge.default_bridge" +) diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/link.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/link.go new file mode 100644 index 0000000000..25877737ba --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/link.go @@ -0,0 +1,85 @@ +package bridge + +import ( + "fmt" + "net" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/iptables" + "github.com/docker/libnetwork/types" +) + +type link struct { + parentIP string + childIP string + ports []types.TransportPort + bridge string +} + +func (l *link) String() string { + return fmt.Sprintf("%s <-> %s [%v] on %s", l.parentIP, l.childIP, l.ports, l.bridge) +} + +func newLink(parentIP, childIP string, ports []types.TransportPort, bridge string) *link { + return &link{ + childIP: childIP, + parentIP: parentIP, + ports: ports, + bridge: bridge, + } + +} + +func (l *link) Enable() error { + // -A == iptables append flag + linkFunction := func() error { + return linkContainers("-A", l.parentIP, l.childIP, l.ports, l.bridge, false) + } + + iptables.OnReloaded(func() { linkFunction() }) + return linkFunction() +} + +func (l *link) Disable() { + // -D == iptables delete flag + err := linkContainers("-D", l.parentIP, l.childIP, l.ports, l.bridge, true) + if err != nil { + log.Errorf("Error removing IPTables rules for a link %s due to %s", l.String(), err.Error()) + } + // Return proper error once we move to use a proper iptables package + // that returns typed errors +} + +func linkContainers(action, parentIP, childIP string, ports []types.TransportPort, bridge string, + ignoreErrors bool) error { + var nfAction iptables.Action + + switch action { + case "-A": + nfAction = iptables.Append + case "-I": + nfAction = iptables.Insert + case "-D": + nfAction = iptables.Delete + default: + return InvalidIPTablesCfgError(action) + } + + ip1 := net.ParseIP(parentIP) + if ip1 == nil { + return InvalidLinkIPAddrError(parentIP) + } + ip2 := net.ParseIP(childIP) + if ip2 == nil { + return InvalidLinkIPAddrError(childIP) + } + + chain := iptables.ChainInfo{Name: DockerChain} + for _, port := range ports { + err := chain.Link(nfAction, ip1, ip2, int(port.Port), port.Proto.String(), bridge) + if !ignoreErrors && err != nil { + return err + } + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux.go new file mode 100644 index 0000000000..6b49efa166 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux.go @@ -0,0 +1,131 @@ +package bridge + +import ( + "fmt" + "math/rand" + "net" + "syscall" + "time" + "unsafe" + + "github.com/docker/libnetwork/netutils" +) + +const ( + ifNameSize = 16 + ioctlBrAdd = 0x89a0 + ioctlBrAddIf = 0x89a2 +) + +type ifreqIndex struct { + IfrnName [ifNameSize]byte + IfruIndex int32 +} + +type ifreqHwaddr struct { + IfrnName [ifNameSize]byte + IfruHwaddr syscall.RawSockaddr +} + +var rnd = rand.New(rand.NewSource(time.Now().UnixNano())) + +// THIS CODE DOES NOT COMMUNICATE WITH KERNEL VIA RTNETLINK INTERFACE +// IT IS HERE FOR BACKWARDS COMPATIBILITY WITH OLDER LINUX KERNELS +// WHICH SHIP WITH OLDER NOT ENTIRELY FUNCTIONAL VERSION OF NETLINK +func getIfSocket() (fd int, err error) { + for _, socket := range []int{ + syscall.AF_INET, + syscall.AF_PACKET, + syscall.AF_INET6, + } { + if fd, err = syscall.Socket(socket, syscall.SOCK_DGRAM, 0); err == nil { + break + } + } + if err == nil { + return fd, nil + } + return -1, err +} + +func ifIoctBridge(iface, master *net.Interface, op uintptr) error { + if len(master.Name) >= ifNameSize { + return fmt.Errorf("Interface name %s too long", master.Name) + } + + s, err := getIfSocket() + if err != nil { + return err + } + defer syscall.Close(s) + + ifr := ifreqIndex{} + copy(ifr.IfrnName[:len(ifr.IfrnName)-1], master.Name) + ifr.IfruIndex = int32(iface.Index) + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, uintptr(s), op, uintptr(unsafe.Pointer(&ifr))); err != 0 { + return err + } + + return nil +} + +// Add a slave to a bridge device. This is more backward-compatible than +// netlink.NetworkSetMaster and works on RHEL 6. +func ioctlAddToBridge(iface, master *net.Interface) error { + return ifIoctBridge(iface, master, ioctlBrAddIf) +} + +func ioctlSetMacAddress(name, addr string) error { + if len(name) >= ifNameSize { + return fmt.Errorf("Interface name %s too long", name) + } + + hw, err := net.ParseMAC(addr) + if err != nil { + return err + } + + s, err := getIfSocket() + if err != nil { + return err + } + defer syscall.Close(s) + + ifr := ifreqHwaddr{} + ifr.IfruHwaddr.Family = syscall.ARPHRD_ETHER + copy(ifr.IfrnName[:len(ifr.IfrnName)-1], name) + + for i := 0; i < 6; i++ { + ifr.IfruHwaddr.Data[i] = ifrDataByte(hw[i]) + } + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, uintptr(s), syscall.SIOCSIFHWADDR, uintptr(unsafe.Pointer(&ifr))); err != 0 { + return err + } + return nil +} + +func ioctlCreateBridge(name string, setMacAddr bool) error { + if len(name) >= ifNameSize { + return fmt.Errorf("Interface name %s too long", name) + } + + s, err := getIfSocket() + if err != nil { + return err + } + defer syscall.Close(s) + + nameBytePtr, err := syscall.BytePtrFromString(name) + if err != nil { + return err + } + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, uintptr(s), ioctlBrAdd, uintptr(unsafe.Pointer(nameBytePtr))); err != 0 { + return err + } + if setMacAddr { + return ioctlSetMacAddress(name, netutils.GenerateRandomMAC().String()) + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_armppc64.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_armppc64.go new file mode 100644 index 0000000000..739d9c6ba3 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_armppc64.go @@ -0,0 +1,7 @@ +// +build arm ppc64 ppc64le + +package bridge + +func ifrDataByte(b byte) uint8 { + return uint8(b) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_notarm.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_notarm.go new file mode 100644 index 0000000000..df526952f7 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_linux_notarm.go @@ -0,0 +1,7 @@ +// +build !arm,!ppc64,!ppc64le + +package bridge + +func ifrDataByte(b byte) int8 { + return int8(b) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_unsupported.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_unsupported.go new file mode 100644 index 0000000000..7e2d57b660 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/netlink_deprecated_unsupported.go @@ -0,0 +1,18 @@ +// +build !linux + +package bridge + +import ( + "errors" + "net" +) + +// Add a slave to a bridge device. This is more backward-compatible than +// netlink.NetworkSetMaster and works on RHEL 6. +func ioctlAddToBridge(iface, master *net.Interface) error { + return errors.New("not implemented") +} + +func ioctlCreateBridge(name string, setMacAddr bool) error { + return errors.New("not implemented") +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/port_mapping.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/port_mapping.go new file mode 100644 index 0000000000..4dab8a0c89 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/port_mapping.go @@ -0,0 +1,128 @@ +package bridge + +import ( + "bytes" + "errors" + "fmt" + "net" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/types" +) + +var ( + defaultBindingIP = net.IPv4(0, 0, 0, 0) +) + +func (n *bridgeNetwork) allocatePorts(epConfig *endpointConfiguration, ep *bridgeEndpoint, reqDefBindIP net.IP, ulPxyEnabled bool) ([]types.PortBinding, error) { + if epConfig == nil || epConfig.PortBindings == nil { + return nil, nil + } + + defHostIP := defaultBindingIP + if reqDefBindIP != nil { + defHostIP = reqDefBindIP + } + + return n.allocatePortsInternal(epConfig.PortBindings, ep.addr.IP, defHostIP, ulPxyEnabled) +} + +func (n *bridgeNetwork) allocatePortsInternal(bindings []types.PortBinding, containerIP, defHostIP net.IP, ulPxyEnabled bool) ([]types.PortBinding, error) { + bs := make([]types.PortBinding, 0, len(bindings)) + for _, c := range bindings { + b := c.GetCopy() + if err := n.allocatePort(&b, containerIP, defHostIP, ulPxyEnabled); err != nil { + // On allocation failure, release previously allocated ports. On cleanup error, just log a warning message + if cuErr := n.releasePortsInternal(bs); cuErr != nil { + logrus.Warnf("Upon allocation failure for %v, failed to clear previously allocated port bindings: %v", b, cuErr) + } + return nil, err + } + bs = append(bs, b) + } + return bs, nil +} + +func (n *bridgeNetwork) allocatePort(bnd *types.PortBinding, containerIP, defHostIP net.IP, ulPxyEnabled bool) error { + var ( + host net.Addr + err error + ) + + // Store the container interface address in the operational binding + bnd.IP = containerIP + + // Adjust the host address in the operational binding + if len(bnd.HostIP) == 0 { + bnd.HostIP = defHostIP + } + + // Adjust HostPortEnd if this is not a range. + if bnd.HostPortEnd == 0 { + bnd.HostPortEnd = bnd.HostPort + } + + // Construct the container side transport address + container, err := bnd.ContainerAddr() + if err != nil { + return err + } + + // Try up to maxAllocatePortAttempts times to get a port that's not already allocated. + for i := 0; i < maxAllocatePortAttempts; i++ { + if host, err = n.portMapper.MapRange(container, bnd.HostIP, int(bnd.HostPort), int(bnd.HostPortEnd), ulPxyEnabled); err == nil { + break + } + // There is no point in immediately retrying to map an explicitly chosen port. + if bnd.HostPort != 0 { + logrus.Warnf("Failed to allocate and map port %d-%d: %s", bnd.HostPort, bnd.HostPortEnd, err) + break + } + logrus.Warnf("Failed to allocate and map port: %s, retry: %d", err, i+1) + } + if err != nil { + return err + } + + // Save the host port (regardless it was or not specified in the binding) + switch netAddr := host.(type) { + case *net.TCPAddr: + bnd.HostPort = uint16(host.(*net.TCPAddr).Port) + return nil + case *net.UDPAddr: + bnd.HostPort = uint16(host.(*net.UDPAddr).Port) + return nil + default: + // For completeness + return ErrUnsupportedAddressType(fmt.Sprintf("%T", netAddr)) + } +} + +func (n *bridgeNetwork) releasePorts(ep *bridgeEndpoint) error { + return n.releasePortsInternal(ep.portMapping) +} + +func (n *bridgeNetwork) releasePortsInternal(bindings []types.PortBinding) error { + var errorBuf bytes.Buffer + + // Attempt to release all port bindings, do not stop on failure + for _, m := range bindings { + if err := n.releasePort(m); err != nil { + errorBuf.WriteString(fmt.Sprintf("\ncould not release %v because of %v", m, err)) + } + } + + if errorBuf.Len() != 0 { + return errors.New(errorBuf.String()) + } + return nil +} + +func (n *bridgeNetwork) releasePort(bnd types.PortBinding) error { + // Construct the host side transport address + host, err := bnd.HostAddr() + if err != nil { + return err + } + return n.portMapper.Unmap(host) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/resolvconf.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/resolvconf.go new file mode 100644 index 0000000000..8861184220 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/resolvconf.go @@ -0,0 +1,67 @@ +package bridge + +import ( + "bytes" + "io/ioutil" + "regexp" +) + +const ( + ipv4NumBlock = `(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)` + ipv4Address = `(` + ipv4NumBlock + `\.){3}` + ipv4NumBlock + + // This is not an IPv6 address verifier as it will accept a super-set of IPv6, and also + // will *not match* IPv4-Embedded IPv6 Addresses (RFC6052), but that and other variants + // -- e.g. other link-local types -- either won't work in containers or are unnecessary. + // For readability and sufficiency for Docker purposes this seemed more reasonable than a + // 1000+ character regexp with exact and complete IPv6 validation + ipv6Address = `([0-9A-Fa-f]{0,4}:){2,7}([0-9A-Fa-f]{0,4})` +) + +var nsRegexp = regexp.MustCompile(`^\s*nameserver\s*((` + ipv4Address + `)|(` + ipv6Address + `))\s*$`) + +func readResolvConf() ([]byte, error) { + resolv, err := ioutil.ReadFile("/etc/resolv.conf") + if err != nil { + return nil, err + } + return resolv, nil +} + +// getLines parses input into lines and strips away comments. +func getLines(input []byte, commentMarker []byte) [][]byte { + lines := bytes.Split(input, []byte("\n")) + var output [][]byte + for _, currentLine := range lines { + var commentIndex = bytes.Index(currentLine, commentMarker) + if commentIndex == -1 { + output = append(output, currentLine) + } else { + output = append(output, currentLine[:commentIndex]) + } + } + return output +} + +// GetNameserversAsCIDR returns nameservers (if any) listed in +// /etc/resolv.conf as CIDR blocks (e.g., "1.2.3.4/32") +// This function's output is intended for net.ParseCIDR +func getNameserversAsCIDR(resolvConf []byte) []string { + nameservers := []string{} + for _, nameserver := range getNameservers(resolvConf) { + nameservers = append(nameservers, nameserver+"/32") + } + return nameservers +} + +// GetNameservers returns nameservers (if any) listed in /etc/resolv.conf +func getNameservers(resolvConf []byte) []string { + nameservers := []string{} + for _, line := range getLines(resolvConf, []byte("#")) { + var ns = nsRegexp.FindSubmatch(line) + if len(ns) > 0 { + nameservers = append(nameservers, string(ns[1])) + } + } + return nameservers +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup.go new file mode 100644 index 0000000000..eeb3611b78 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup.go @@ -0,0 +1,26 @@ +package bridge + +type setupStep func(*networkConfiguration, *bridgeInterface) error + +type bridgeSetup struct { + config *networkConfiguration + bridge *bridgeInterface + steps []setupStep +} + +func newBridgeSetup(c *networkConfiguration, i *bridgeInterface) *bridgeSetup { + return &bridgeSetup{config: c, bridge: i} +} + +func (b *bridgeSetup) apply() error { + for _, fn := range b.steps { + if err := fn(b.config, b.bridge); err != nil { + return err + } + } + return nil +} + +func (b *bridgeSetup) queueStep(step setupStep) { + b.steps = append(b.steps, step) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_bridgenetfiltering.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_bridgenetfiltering.go new file mode 100644 index 0000000000..f7a536adb0 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_bridgenetfiltering.go @@ -0,0 +1,162 @@ +package bridge + +import ( + "fmt" + "io/ioutil" + "os" + "syscall" + + "github.com/Sirupsen/logrus" +) + +// Enumeration type saying which versions of IP protocol to process. +type ipVersion int + +const ( + ipvnone ipVersion = iota + ipv4 + ipv6 + ipvboth +) + +//Gets the IP version in use ( [ipv4], [ipv6] or [ipv4 and ipv6] ) +func getIPVersion(config *networkConfiguration) ipVersion { + ipVersion := ipv4 + if config.AddressIPv6 != nil || config.EnableIPv6 { + ipVersion |= ipv6 + } + return ipVersion +} + +func setupBridgeNetFiltering(config *networkConfiguration, i *bridgeInterface) error { + err := checkBridgeNetFiltering(config, i) + if err != nil { + if ptherr, ok := err.(*os.PathError); ok { + if errno, ok := ptherr.Err.(syscall.Errno); ok && errno == syscall.ENOENT { + if isRunningInContainer() { + logrus.Warnf("running inside docker container, ignoring missing kernel params: %v", err) + err = nil + } else { + err = fmt.Errorf("please ensure that br_netfilter kernel module is loaded") + } + } + } + if err != nil { + return fmt.Errorf("cannot restrict inter-container communication: %v", err) + } + } + return nil +} + +//Enable bridge net filtering if ip forwarding is enabled. See github issue #11404 +func checkBridgeNetFiltering(config *networkConfiguration, i *bridgeInterface) error { + ipVer := getIPVersion(config) + iface := config.BridgeName + doEnable := func(ipVer ipVersion) error { + var ipVerName string + if ipVer == ipv4 { + ipVerName = "IPv4" + } else { + ipVerName = "IPv6" + } + enabled, err := isPacketForwardingEnabled(ipVer, iface) + if err != nil { + logrus.Warnf("failed to check %s forwarding: %v", ipVerName, err) + } else if enabled { + enabled, err := getKernelBoolParam(getBridgeNFKernelParam(ipVer)) + if err != nil || enabled { + return err + } + return setKernelBoolParam(getBridgeNFKernelParam(ipVer), true) + } + return nil + } + + switch ipVer { + case ipv4, ipv6: + return doEnable(ipVer) + case ipvboth: + v4err := doEnable(ipv4) + v6err := doEnable(ipv6) + if v4err == nil { + return v6err + } + return v4err + default: + return nil + } +} + +// Get kernel param path saying whether IPv${ipVer} traffic is being forwarded +// on particular interface. Interface may be specified for IPv6 only. If +// `iface` is empty, `default` will be assumed, which represents default value +// for new interfaces. +func getForwardingKernelParam(ipVer ipVersion, iface string) string { + switch ipVer { + case ipv4: + return "/proc/sys/net/ipv4/ip_forward" + case ipv6: + if iface == "" { + iface = "default" + } + return fmt.Sprintf("/proc/sys/net/ipv6/conf/%s/forwarding", iface) + default: + return "" + } +} + +// Get kernel param path saying whether bridged IPv${ipVer} traffic shall be +// passed to ip${ipVer}tables' chains. +func getBridgeNFKernelParam(ipVer ipVersion) string { + switch ipVer { + case ipv4: + return "/proc/sys/net/bridge/bridge-nf-call-iptables" + case ipv6: + return "/proc/sys/net/bridge/bridge-nf-call-ip6tables" + default: + return "" + } +} + +//Gets the value of the kernel parameters located at the given path +func getKernelBoolParam(path string) (bool, error) { + enabled := false + line, err := ioutil.ReadFile(path) + if err != nil { + return false, err + } + if len(line) > 0 { + enabled = line[0] == '1' + } + return enabled, err +} + +//Sets the value of the kernel parameter located at the given path +func setKernelBoolParam(path string, on bool) error { + value := byte('0') + if on { + value = byte('1') + } + return ioutil.WriteFile(path, []byte{value, '\n'}, 0644) +} + +//Checks to see if packet forwarding is enabled +func isPacketForwardingEnabled(ipVer ipVersion, iface string) (bool, error) { + switch ipVer { + case ipv4, ipv6: + return getKernelBoolParam(getForwardingKernelParam(ipVer, iface)) + case ipvboth: + enabled, err := getKernelBoolParam(getForwardingKernelParam(ipv4, "")) + if err != nil || !enabled { + return enabled, err + } + return getKernelBoolParam(getForwardingKernelParam(ipv6, iface)) + default: + return true, nil + } +} + +func isRunningInContainer() bool { + _, err := os.Stat("/.dockerinit") + return !os.IsNotExist(err) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_device.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_device.go new file mode 100644 index 0000000000..ddd9e452d0 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_device.go @@ -0,0 +1,66 @@ +package bridge + +import ( + "fmt" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/parsers/kernel" + "github.com/docker/libnetwork/netutils" + "github.com/vishvananda/netlink" +) + +// SetupDevice create a new bridge interface/ +func setupDevice(config *networkConfiguration, i *bridgeInterface) error { + var setMac bool + + // We only attempt to create the bridge when the requested device name is + // the default one. + if config.BridgeName != DefaultBridgeName && config.DefaultBridge { + return NonDefaultBridgeExistError(config.BridgeName) + } + + // Set the bridgeInterface netlink.Bridge. + i.Link = &netlink.Bridge{ + LinkAttrs: netlink.LinkAttrs{ + Name: config.BridgeName, + }, + } + + // Only set the bridge's MAC address if the kernel version is > 3.3, as it + // was not supported before that. + kv, err := kernel.GetKernelVersion() + if err != nil { + logrus.Errorf("Failed to check kernel versions: %v. Will not assign a MAC address to the bridge interface", err) + } else { + setMac = kv.Kernel > 3 || (kv.Kernel == 3 && kv.Major >= 3) + } + + if err = netlink.LinkAdd(i.Link); err != nil { + logrus.Debugf("Failed to create bridge %s via netlink. Trying ioctl", config.BridgeName) + return ioctlCreateBridge(config.BridgeName, setMac) + } + + if setMac { + hwAddr := netutils.GenerateRandomMAC() + if err = netlink.LinkSetHardwareAddr(i.Link, hwAddr); err != nil { + return fmt.Errorf("failed to set bridge mac-address %s : %s", hwAddr, err.Error()) + } + logrus.Debugf("Setting bridge mac address to %s", hwAddr) + } + return err +} + +// SetupDeviceUp ups the given bridge interface. +func setupDeviceUp(config *networkConfiguration, i *bridgeInterface) error { + err := netlink.LinkSetUp(i.Link) + if err != nil { + return err + } + + // Attempt to update the bridge interface to refresh the flags status, + // ignoring any failure to do so. + if lnk, err := netlink.LinkByName(config.BridgeName); err == nil { + i.Link = lnk + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_firewalld.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_firewalld.go new file mode 100644 index 0000000000..fc45a7e983 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_firewalld.go @@ -0,0 +1,20 @@ +package bridge + +import "github.com/docker/libnetwork/iptables" + +func (n *bridgeNetwork) setupFirewalld(config *networkConfiguration, i *bridgeInterface) error { + d := n.driver + d.Lock() + driverConfig := d.config + d.Unlock() + + // Sanity check. + if driverConfig.EnableIPTables == false { + return IPTableCfgError(config.BridgeName) + } + + iptables.OnReloaded(func() { n.setupIPTables(config, i) }) + iptables.OnReloaded(n.portMapper.ReMapAll) + + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_forwarding.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_forwarding.go new file mode 100644 index 0000000000..53f9c88d4d --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_forwarding.go @@ -0,0 +1,29 @@ +package bridge + +import ( + "fmt" + "io/ioutil" +) + +const ( + ipv4ForwardConf = "/proc/sys/net/ipv4/ip_forward" + ipv4ForwardConfPerm = 0644 +) + +func setupIPForwarding() error { + // Get current IPv4 forward setup + ipv4ForwardData, err := ioutil.ReadFile(ipv4ForwardConf) + if err != nil { + return fmt.Errorf("Cannot read IP forwarding setup: %v", err) + } + + // Enable IPv4 forwarding only if it is not already enabled + if ipv4ForwardData[0] != '1' { + // Enable IPv4 forwarding + if err := ioutil.WriteFile(ipv4ForwardConf, []byte{'1', '\n'}, ipv4ForwardConfPerm); err != nil { + return fmt.Errorf("Setup IP forwarding failed: %v", err) + } + } + + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_tables.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_tables.go new file mode 100644 index 0000000000..f597f67b7f --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ip_tables.go @@ -0,0 +1,253 @@ +package bridge + +import ( + "fmt" + "net" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/iptables" + "github.com/docker/libnetwork/netutils" +) + +// DockerChain: DOCKER iptable chain name +const ( + DockerChain = "DOCKER" +) + +func setupIPChains(config *configuration) (*iptables.ChainInfo, *iptables.ChainInfo, error) { + // Sanity check. + if config.EnableIPTables == false { + return nil, nil, fmt.Errorf("Cannot create new chains, EnableIPTable is disabled") + } + + hairpinMode := !config.EnableUserlandProxy + + natChain, err := iptables.NewChain(DockerChain, iptables.Nat, hairpinMode) + if err != nil { + return nil, nil, fmt.Errorf("Failed to create NAT chain: %s", err.Error()) + } + defer func() { + if err != nil { + if err := iptables.RemoveExistingChain(DockerChain, iptables.Nat); err != nil { + logrus.Warnf("Failed on removing iptables NAT chain on cleanup: %v", err) + } + } + }() + + filterChain, err := iptables.NewChain(DockerChain, iptables.Filter, hairpinMode) + if err != nil { + return nil, nil, fmt.Errorf("Failed to create FILTER chain: %s", err.Error()) + } + + return natChain, filterChain, nil +} + +func (n *bridgeNetwork) setupIPTables(config *networkConfiguration, i *bridgeInterface) error { + d := n.driver + d.Lock() + driverConfig := d.config + d.Unlock() + + // Sanity check. + if driverConfig.EnableIPTables == false { + return fmt.Errorf("Cannot program chains, EnableIPTable is disabled") + } + + // Pickup this configuraton option from driver + hairpinMode := !driverConfig.EnableUserlandProxy + + addrv4, _, err := netutils.GetIfaceAddr(config.BridgeName) + if err != nil { + return fmt.Errorf("Failed to setup IP tables, cannot acquire Interface address: %s", err.Error()) + } + ipnet := addrv4.(*net.IPNet) + maskedAddrv4 := &net.IPNet{ + IP: ipnet.IP.Mask(ipnet.Mask), + Mask: ipnet.Mask, + } + if err = setupIPTablesInternal(config.BridgeName, maskedAddrv4, config.EnableICC, config.EnableIPMasquerade, hairpinMode, true); err != nil { + return fmt.Errorf("Failed to Setup IP tables: %s", err.Error()) + } + + natChain, filterChain, err := n.getDriverChains() + if err != nil { + return fmt.Errorf("Failed to setup IP tables, cannot acquire chain info %s", err.Error()) + } + + err = iptables.ProgramChain(natChain, config.BridgeName, hairpinMode) + if err != nil { + return fmt.Errorf("Failed to program NAT chain: %s", err.Error()) + } + + err = iptables.ProgramChain(filterChain, config.BridgeName, hairpinMode) + if err != nil { + return fmt.Errorf("Failed to program FILTER chain: %s", err.Error()) + } + + n.portMapper.SetIptablesChain(filterChain, n.getNetworkBridgeName()) + + return nil +} + +type iptRule struct { + table iptables.Table + chain string + preArgs []string + args []string +} + +func setupIPTablesInternal(bridgeIface string, addr net.Addr, icc, ipmasq, hairpin, enable bool) error { + + var ( + address = addr.String() + natRule = iptRule{table: iptables.Nat, chain: "POSTROUTING", preArgs: []string{"-t", "nat"}, args: []string{"-s", address, "!", "-o", bridgeIface, "-j", "MASQUERADE"}} + hpNatRule = iptRule{table: iptables.Nat, chain: "POSTROUTING", preArgs: []string{"-t", "nat"}, args: []string{"-m", "addrtype", "--src-type", "LOCAL", "-o", bridgeIface, "-j", "MASQUERADE"}} + outRule = iptRule{table: iptables.Filter, chain: "FORWARD", args: []string{"-i", bridgeIface, "!", "-o", bridgeIface, "-j", "ACCEPT"}} + inRule = iptRule{table: iptables.Filter, chain: "FORWARD", args: []string{"-o", bridgeIface, "-m", "conntrack", "--ctstate", "RELATED,ESTABLISHED", "-j", "ACCEPT"}} + ) + + // Set NAT. + if ipmasq { + if err := programChainRule(natRule, "NAT", enable); err != nil { + return err + } + } + + // In hairpin mode, masquerade traffic from localhost + if hairpin { + if err := programChainRule(hpNatRule, "MASQ LOCAL HOST", enable); err != nil { + return err + } + } + + // Set Inter Container Communication. + if err := setIcc(bridgeIface, icc, enable); err != nil { + return err + } + + // Set Accept on all non-intercontainer outgoing packets. + if err := programChainRule(outRule, "ACCEPT NON_ICC OUTGOING", enable); err != nil { + return err + } + + // Set Accept on incoming packets for existing connections. + if err := programChainRule(inRule, "ACCEPT INCOMING", enable); err != nil { + return err + } + + return nil +} + +func programChainRule(rule iptRule, ruleDescr string, insert bool) error { + var ( + prefix []string + operation string + condition bool + doesExist = iptables.Exists(rule.table, rule.chain, rule.args...) + ) + + if insert { + condition = !doesExist + prefix = []string{"-I", rule.chain} + operation = "enable" + } else { + condition = doesExist + prefix = []string{"-D", rule.chain} + operation = "disable" + } + if rule.preArgs != nil { + prefix = append(rule.preArgs, prefix...) + } + + if condition { + if output, err := iptables.Raw(append(prefix, rule.args...)...); err != nil { + return fmt.Errorf("Unable to %s %s rule: %s", operation, ruleDescr, err.Error()) + } else if len(output) != 0 { + return &iptables.ChainError{Chain: rule.chain, Output: output} + } + } + + return nil +} + +func setIcc(bridgeIface string, iccEnable, insert bool) error { + var ( + table = iptables.Filter + chain = "FORWARD" + args = []string{"-i", bridgeIface, "-o", bridgeIface, "-j"} + acceptArgs = append(args, "ACCEPT") + dropArgs = append(args, "DROP") + ) + + if insert { + if !iccEnable { + iptables.Raw(append([]string{"-D", chain}, acceptArgs...)...) + + if !iptables.Exists(table, chain, dropArgs...) { + if output, err := iptables.Raw(append([]string{"-A", chain}, dropArgs...)...); err != nil { + return fmt.Errorf("Unable to prevent intercontainer communication: %s", err.Error()) + } else if len(output) != 0 { + return fmt.Errorf("Error disabling intercontainer communication: %s", output) + } + } + } else { + iptables.Raw(append([]string{"-D", chain}, dropArgs...)...) + + if !iptables.Exists(table, chain, acceptArgs...) { + if output, err := iptables.Raw(append([]string{"-I", chain}, acceptArgs...)...); err != nil { + return fmt.Errorf("Unable to allow intercontainer communication: %s", err.Error()) + } else if len(output) != 0 { + return fmt.Errorf("Error enabling intercontainer communication: %s", output) + } + } + } + } else { + // Remove any ICC rule. + if !iccEnable { + if iptables.Exists(table, chain, dropArgs...) { + iptables.Raw(append([]string{"-D", chain}, dropArgs...)...) + } + } else { + if iptables.Exists(table, chain, acceptArgs...) { + iptables.Raw(append([]string{"-D", chain}, acceptArgs...)...) + } + } + } + + return nil +} + +// Control Inter Network Communication. Install/remove only if it is not/is present. +func setINC(network1, network2 string, enable bool) error { + var ( + table = iptables.Filter + chain = "FORWARD" + args = [2][]string{{"-s", network1, "-d", network2, "-j", "DROP"}, {"-s", network2, "-d", network1, "-j", "DROP"}} + ) + + if enable { + for i := 0; i < 2; i++ { + if iptables.Exists(table, chain, args[i]...) { + continue + } + if output, err := iptables.Raw(append([]string{"-I", chain}, args[i]...)...); err != nil { + return fmt.Errorf("unable to add inter-network communication rule: %s", err.Error()) + } else if len(output) != 0 { + return fmt.Errorf("error adding inter-network communication rule: %s", string(output)) + } + } + } else { + for i := 0; i < 2; i++ { + if !iptables.Exists(table, chain, args[i]...) { + continue + } + if output, err := iptables.Raw(append([]string{"-D", chain}, args[i]...)...); err != nil { + return fmt.Errorf("unable to remove inter-network communication rule: %s", err.Error()) + } else if len(output) != 0 { + return fmt.Errorf("error removing inter-network communication rule: %s", string(output)) + } + } + } + + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv4.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv4.go new file mode 100644 index 0000000000..db913909c1 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv4.go @@ -0,0 +1,62 @@ +package bridge + +import ( + "fmt" + "io/ioutil" + "path/filepath" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" +) + +func setupBridgeIPv4(config *networkConfiguration, i *bridgeInterface) error { + addrv4, _, err := i.addresses() + if err != nil { + return fmt.Errorf("failed to retrieve bridge interface addresses: %v", err) + } + + if !types.CompareIPNet(addrv4.IPNet, config.AddressIPv4) { + if addrv4.IPNet != nil { + if err := netlink.AddrDel(i.Link, &addrv4); err != nil { + return fmt.Errorf("failed to remove current ip address from bridge: %v", err) + } + } + log.Debugf("Assigning address to bridge interface %s: %s", config.BridgeName, config.AddressIPv4) + if err := netlink.AddrAdd(i.Link, &netlink.Addr{IPNet: config.AddressIPv4}); err != nil { + return &IPv4AddrAddError{IP: config.AddressIPv4, Err: err} + } + } + + // Store bridge network and default gateway + i.bridgeIPv4 = config.AddressIPv4 + i.gatewayIPv4 = config.AddressIPv4.IP + + return nil +} + +func setupGatewayIPv4(config *networkConfiguration, i *bridgeInterface) error { + if !i.bridgeIPv4.Contains(config.DefaultGatewayIPv4) { + return &ErrInvalidGateway{} + } + + // Store requested default gateway + i.gatewayIPv4 = config.DefaultGatewayIPv4 + + return nil +} + +func setupLoopbackAdressesRouting(config *networkConfiguration, i *bridgeInterface) error { + sysPath := filepath.Join("/proc/sys/net/ipv4/conf", config.BridgeName, "route_localnet") + ipv4LoRoutingData, err := ioutil.ReadFile(sysPath) + if err != nil { + return fmt.Errorf("Cannot read IPv4 local routing setup: %v", err) + } + // Enable loopback adresses routing only if it isn't already enabled + if ipv4LoRoutingData[0] != '1' { + if err := ioutil.WriteFile(sysPath, []byte{'1', '\n'}, 0644); err != nil { + return fmt.Errorf("Unable to enable local routing for hairpin mode: %v", err) + } + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv6.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv6.go new file mode 100644 index 0000000000..5ce53dd879 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_ipv6.go @@ -0,0 +1,119 @@ +package bridge + +import ( + "fmt" + "io/ioutil" + "net" + "os" + + "github.com/Sirupsen/logrus" + "github.com/vishvananda/netlink" +) + +var bridgeIPv6 *net.IPNet + +const ( + bridgeIPv6Str = "fe80::1/64" + ipv6ForwardConfPerm = 0644 + ipv6ForwardConfDefault = "/proc/sys/net/ipv6/conf/default/forwarding" + ipv6ForwardConfAll = "/proc/sys/net/ipv6/conf/all/forwarding" +) + +func init() { + // We allow ourselves to panic in this special case because we indicate a + // failure to parse a compile-time define constant. + if ip, netw, err := net.ParseCIDR(bridgeIPv6Str); err == nil { + bridgeIPv6 = &net.IPNet{IP: ip, Mask: netw.Mask} + } else { + panic(fmt.Sprintf("Cannot parse default bridge IPv6 address %q: %v", bridgeIPv6Str, err)) + } +} + +func setupBridgeIPv6(config *networkConfiguration, i *bridgeInterface) error { + procFile := "/proc/sys/net/ipv6/conf/" + config.BridgeName + "/disable_ipv6" + ipv6BridgeData, err := ioutil.ReadFile(procFile) + if err != nil { + return fmt.Errorf("Cannot read IPv6 setup for bridge %v: %v", config.BridgeName, err) + } + // Enable IPv6 on the bridge only if it isn't already enabled + if ipv6BridgeData[0] != '0' { + if err := ioutil.WriteFile(procFile, []byte{'0', '\n'}, ipv6ForwardConfPerm); err != nil { + return fmt.Errorf("Unable to enable IPv6 addresses on bridge: %v", err) + } + } + + _, addrsv6, err := i.addresses() + if err != nil { + return err + } + + // Add the default link local ipv6 address if it doesn't exist + if !findIPv6Address(netlink.Addr{IPNet: bridgeIPv6}, addrsv6) { + if err := netlink.AddrAdd(i.Link, &netlink.Addr{IPNet: bridgeIPv6}); err != nil { + return &IPv6AddrAddError{IP: bridgeIPv6, Err: err} + } + } + + // Store bridge network and default gateway + i.bridgeIPv6 = bridgeIPv6 + i.gatewayIPv6 = i.bridgeIPv6.IP + + if config.AddressIPv6 == nil { + return nil + } + + // Setting route to global IPv6 subnet + logrus.Debugf("Adding route to IPv6 network %s via device %s", config.AddressIPv6.String(), config.BridgeName) + err = netlink.RouteAdd(&netlink.Route{ + Scope: netlink.SCOPE_UNIVERSE, + LinkIndex: i.Link.Attrs().Index, + Dst: config.AddressIPv6, + }) + if err != nil && !os.IsExist(err) { + logrus.Errorf("Could not add route to IPv6 network %s via device %s", config.AddressIPv6.String(), config.BridgeName) + } + + return nil +} + +func setupGatewayIPv6(config *networkConfiguration, i *bridgeInterface) error { + if config.AddressIPv6 == nil { + return &ErrInvalidContainerSubnet{} + } + if !config.AddressIPv6.Contains(config.DefaultGatewayIPv6) { + return &ErrInvalidGateway{} + } + + // Store requested default gateway + i.gatewayIPv6 = config.DefaultGatewayIPv6 + + return nil +} + +func setupIPv6Forwarding(config *networkConfiguration, i *bridgeInterface) error { + // Get current IPv6 default forwarding setup + ipv6ForwardDataDefault, err := ioutil.ReadFile(ipv6ForwardConfDefault) + if err != nil { + return fmt.Errorf("Cannot read IPv6 default forwarding setup: %v", err) + } + // Enable IPv6 default forwarding only if it is not already enabled + if ipv6ForwardDataDefault[0] != '1' { + if err := ioutil.WriteFile(ipv6ForwardConfDefault, []byte{'1', '\n'}, ipv6ForwardConfPerm); err != nil { + logrus.Warnf("Unable to enable IPv6 default forwarding: %v", err) + } + } + + // Get current IPv6 all forwarding setup + ipv6ForwardDataAll, err := ioutil.ReadFile(ipv6ForwardConfAll) + if err != nil { + return fmt.Errorf("Cannot read IPv6 all forwarding setup: %v", err) + } + // Enable IPv6 all forwarding only if it is not already enabled + if ipv6ForwardDataAll[0] != '1' { + if err := ioutil.WriteFile(ipv6ForwardConfAll, []byte{'1', '\n'}, ipv6ForwardConfPerm); err != nil { + logrus.Warnf("Unable to enable IPv6 all forwarding: %v", err) + } + } + + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_verify.go b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_verify.go new file mode 100644 index 0000000000..6d4d66982c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/bridge/setup_verify.go @@ -0,0 +1,46 @@ +package bridge + +import ( + "github.com/vishvananda/netlink" +) + +func setupVerifyAndReconcile(config *networkConfiguration, i *bridgeInterface) error { + // Fetch a single IPv4 and a slice of IPv6 addresses from the bridge. + addrv4, addrsv6, err := i.addresses() + if err != nil { + return err + } + + // Verify that the bridge does have an IPv4 address. + if addrv4.IPNet == nil { + return &ErrNoIPAddr{} + } + + // Verify that the bridge IPv4 address matches the requested configuration. + if config.AddressIPv4 != nil && !addrv4.IP.Equal(config.AddressIPv4.IP) { + return &IPv4AddrNoMatchError{IP: addrv4.IP, CfgIP: config.AddressIPv4.IP} + } + + // Verify that one of the bridge IPv6 addresses matches the requested + // configuration. + if config.EnableIPv6 && !findIPv6Address(netlink.Addr{IPNet: bridgeIPv6}, addrsv6) { + return (*IPv6AddrNoMatchError)(bridgeIPv6) + } + + // By this time we have either configured a new bridge with an IP address + // or made sure an existing bridge's IP matches the configuration + // Now is the time to cache these states in the bridgeInterface. + i.bridgeIPv4 = addrv4.IPNet + i.bridgeIPv6 = bridgeIPv6 + + return nil +} + +func findIPv6Address(addr netlink.Addr, addresses []netlink.Addr) bool { + for _, addrv6 := range addresses { + if addrv6.String() == addr.String() { + return true + } + } + return false +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/host/host.go b/vendor/src/github.com/docker/libnetwork/drivers/host/host.go new file mode 100644 index 0000000000..340cb2e6f0 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/host/host.go @@ -0,0 +1,77 @@ +package host + +import ( + "sync" + + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/types" +) + +const networkType = "host" + +type driver struct { + network string + sync.Mutex +} + +// Init registers a new instance of host driver +func Init(dc driverapi.DriverCallback, config map[string]interface{}) error { + c := driverapi.Capability{ + DataScope: datastore.LocalScope, + } + return dc.RegisterDriver(networkType, &driver{}, c) +} + +func (d *driver) CreateNetwork(id string, option map[string]interface{}, ipV4Data, ipV6Data []driverapi.IPAMData) error { + d.Lock() + defer d.Unlock() + + if d.network != "" { + return types.ForbiddenErrorf("only one instance of \"%s\" network is allowed", networkType) + } + + d.network = id + + return nil +} + +func (d *driver) DeleteNetwork(nid string) error { + return types.ForbiddenErrorf("network of type \"%s\" cannot be deleted", networkType) +} + +func (d *driver) CreateEndpoint(nid, eid string, ifInfo driverapi.InterfaceInfo, epOptions map[string]interface{}) error { + return nil +} + +func (d *driver) DeleteEndpoint(nid, eid string) error { + return nil +} + +func (d *driver) EndpointOperInfo(nid, eid string) (map[string]interface{}, error) { + return make(map[string]interface{}, 0), nil +} + +// Join method is invoked when a Sandbox is attached to an endpoint. +func (d *driver) Join(nid, eid string, sboxKey string, jinfo driverapi.JoinInfo, options map[string]interface{}) error { + return nil +} + +// Leave method is invoked when a Sandbox detaches from an endpoint. +func (d *driver) Leave(nid, eid string) error { + return nil +} + +func (d *driver) Type() string { + return networkType +} + +// DiscoverNew is a notification for a new discovery event, such as a new node joining a cluster +func (d *driver) DiscoverNew(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} + +// DiscoverDelete is a notification for a discovery delete event, such as a node leaving a cluster +func (d *driver) DiscoverDelete(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/null/null.go b/vendor/src/github.com/docker/libnetwork/drivers/null/null.go new file mode 100644 index 0000000000..5fbdd12956 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/null/null.go @@ -0,0 +1,77 @@ +package null + +import ( + "sync" + + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/types" +) + +const networkType = "null" + +type driver struct { + network string + sync.Mutex +} + +// Init registers a new instance of null driver +func Init(dc driverapi.DriverCallback, config map[string]interface{}) error { + c := driverapi.Capability{ + DataScope: datastore.LocalScope, + } + return dc.RegisterDriver(networkType, &driver{}, c) +} + +func (d *driver) CreateNetwork(id string, option map[string]interface{}, ipV4Data, ipV6Data []driverapi.IPAMData) error { + d.Lock() + defer d.Unlock() + + if d.network != "" { + return types.ForbiddenErrorf("only one instance of \"%s\" network is allowed", networkType) + } + + d.network = id + + return nil +} + +func (d *driver) DeleteNetwork(nid string) error { + return types.ForbiddenErrorf("network of type \"%s\" cannot be deleted", networkType) +} + +func (d *driver) CreateEndpoint(nid, eid string, ifInfo driverapi.InterfaceInfo, epOptions map[string]interface{}) error { + return nil +} + +func (d *driver) DeleteEndpoint(nid, eid string) error { + return nil +} + +func (d *driver) EndpointOperInfo(nid, eid string) (map[string]interface{}, error) { + return make(map[string]interface{}, 0), nil +} + +// Join method is invoked when a Sandbox is attached to an endpoint. +func (d *driver) Join(nid, eid string, sboxKey string, jinfo driverapi.JoinInfo, options map[string]interface{}) error { + return nil +} + +// Leave method is invoked when a Sandbox detaches from an endpoint. +func (d *driver) Leave(nid, eid string) error { + return nil +} + +func (d *driver) Type() string { + return networkType +} + +// DiscoverNew is a notification for a new discovery event, such as a new node joining a cluster +func (d *driver) DiscoverNew(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} + +// DiscoverDelete is a notification for a discovery delete event, such as a node leaving a cluster +func (d *driver) DiscoverDelete(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/filter.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/filter.go new file mode 100644 index 0000000000..0607548140 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/filter.go @@ -0,0 +1,131 @@ +package overlay + +import ( + "fmt" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/iptables" +) + +const globalChain = "DOCKER-OVERLAY" + +var filterOnce sync.Once + +func rawIPTables(args ...string) error { + if output, err := iptables.Raw(args...); err != nil { + return fmt.Errorf("unable to add overlay filter: %v", err) + } else if len(output) != 0 { + return fmt.Errorf("unable to add overlay filter: %s", string(output)) + } + + return nil +} + +func chainExists(cname string) bool { + if _, err := iptables.Raw("-L", cname); err != nil { + return false + } + + return true +} + +func setupGlobalChain() { + if err := rawIPTables("-N", globalChain); err != nil { + logrus.Debugf("could not create global overlay chain: %v", err) + } + + if err := rawIPTables("-A", globalChain, "-j", "RETURN"); err != nil { + logrus.Debugf("could not install default return chain in the overlay global chain: %v", err) + } +} + +func setNetworkChain(cname string, remove bool) error { + // Initialize the onetime global overlay chain + filterOnce.Do(setupGlobalChain) + + exists := chainExists(cname) + + opt := "-N" + // In case of remove, make sure to flush the rules in the chain + if remove && exists { + if err := rawIPTables("-F", cname); err != nil { + return fmt.Errorf("failed to flush overlay network chain %s rules: %v", cname, err) + } + opt = "-X" + } + + if (!remove && !exists) || (remove && exists) { + if err := rawIPTables(opt, cname); err != nil { + return fmt.Errorf("failed network chain operation %q for chain %s: %v", opt, cname, err) + } + } + + if !remove { + if !iptables.Exists(iptables.Filter, cname, "-j", "DROP") { + if err := rawIPTables("-A", cname, "-j", "DROP"); err != nil { + return fmt.Errorf("failed adding default drop rule to overlay network chain %s: %v", cname, err) + } + } + } + + return nil +} + +func addNetworkChain(cname string) error { + return setNetworkChain(cname, false) +} + +func removeNetworkChain(cname string) error { + return setNetworkChain(cname, true) +} + +func setFilters(cname, brName string, remove bool) error { + opt := "-I" + if remove { + opt = "-D" + } + + // Everytime we set filters for a new subnet make sure to move the global overlay hook to the top of the both the OUTPUT and forward chains + if !remove { + for _, chain := range []string{"OUTPUT", "FORWARD"} { + exists := iptables.Exists(iptables.Filter, chain, "-j", globalChain) + if exists { + if err := rawIPTables("-D", chain, "-j", globalChain); err != nil { + return fmt.Errorf("failed to delete overlay hook in chain %s while moving the hook: %v", chain, err) + } + } + + if err := rawIPTables("-I", chain, "-j", globalChain); err != nil { + return fmt.Errorf("failed to insert overlay hook in chain %s: %v", chain, err) + } + } + } + + // Insert/Delete the rule to jump to per-bridge chain + exists := iptables.Exists(iptables.Filter, globalChain, "-o", brName, "-j", cname) + if (!remove && !exists) || (remove && exists) { + if err := rawIPTables(opt, globalChain, "-o", brName, "-j", cname); err != nil { + return fmt.Errorf("failed to add per-bridge filter rule for bridge %s, network chain %s: %v", brName, cname, err) + } + } + + exists = iptables.Exists(iptables.Filter, cname, "-i", brName, "-j", "ACCEPT") + if (!remove && exists) || (remove && !exists) { + return nil + } + + if err := rawIPTables(opt, cname, "-i", brName, "-j", "ACCEPT"); err != nil { + return fmt.Errorf("failed to add overlay filter rile for network chain %s, bridge %s: %v", cname, brName, err) + } + + return nil +} + +func addFilters(cname, brName string) error { + return setFilters(cname, brName, false) +} + +func removeFilters(cname, brName string) error { + return setFilters(cname, brName, true) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/joinleave.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/joinleave.go new file mode 100644 index 0000000000..997a3e77b7 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/joinleave.go @@ -0,0 +1,138 @@ +package overlay + +import ( + "fmt" + "net" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" +) + +// Join method is invoked when a Sandbox is attached to an endpoint. +func (d *driver) Join(nid, eid string, sboxKey string, jinfo driverapi.JoinInfo, options map[string]interface{}) error { + if err := validateID(nid, eid); err != nil { + return err + } + + n := d.network(nid) + if n == nil { + return fmt.Errorf("could not find network with id %s", nid) + } + + ep := n.endpoint(eid) + if ep == nil { + return fmt.Errorf("could not find endpoint with id %s", eid) + } + + s := n.getSubnetforIP(ep.addr) + if s == nil { + return fmt.Errorf("could not find subnet for endpoint %s", eid) + } + + if err := n.obtainVxlanID(s); err != nil { + return fmt.Errorf("couldn't get vxlan id for %q: %v", s.subnetIP.String(), err) + } + + if err := n.joinSandbox(); err != nil { + return fmt.Errorf("network sandbox join failed: %v", err) + } + + if err := n.joinSubnetSandbox(s); err != nil { + return fmt.Errorf("subnet sandbox join failed for %q: %v", s.subnetIP.String(), err) + } + + // joinSubnetSandbox gets called when an endpoint comes up on a new subnet in the + // overlay network. Hence the Endpoint count should be updated outside joinSubnetSandbox + n.incEndpointCount() + + sbox := n.sandbox() + + name1, name2, err := createVethPair() + if err != nil { + return err + } + + // Set the container interface and its peer MTU to 1450 to allow + // for 50 bytes vxlan encap (inner eth header(14) + outer IP(20) + + // outer UDP(8) + vxlan header(8)) + veth, err := netlink.LinkByName(name1) + if err != nil { + return fmt.Errorf("cound not find link by name %s: %v", name1, err) + } + err = netlink.LinkSetMTU(veth, vxlanVethMTU) + if err != nil { + return err + } + + if err := sbox.AddInterface(name1, "veth", + sbox.InterfaceOptions().Master(s.brName)); err != nil { + return fmt.Errorf("could not add veth pair inside the network sandbox: %v", err) + } + + veth, err = netlink.LinkByName(name2) + if err != nil { + return fmt.Errorf("could not find link by name %s: %v", name2, err) + } + err = netlink.LinkSetMTU(veth, vxlanVethMTU) + if err != nil { + return err + } + + if err := netlink.LinkSetHardwareAddr(veth, ep.mac); err != nil { + return fmt.Errorf("could not set mac address (%v) to the container interface: %v", ep.mac, err) + } + + for _, sub := range n.subnets { + if sub == s { + continue + } + if err := jinfo.AddStaticRoute(sub.subnetIP, types.NEXTHOP, s.gwIP.IP); err != nil { + log.Errorf("Adding subnet %s static route in network %q failed\n", s.subnetIP, n.id) + } + } + + if iNames := jinfo.InterfaceName(); iNames != nil { + err = iNames.SetNames(name2, "eth") + if err != nil { + return err + } + } + + d.peerDbAdd(nid, eid, ep.addr.IP, ep.addr.Mask, ep.mac, + net.ParseIP(d.bindAddress), true) + d.pushLocalEndpointEvent("join", nid, eid) + + return nil +} + +// Leave method is invoked when a Sandbox detaches from an endpoint. +func (d *driver) Leave(nid, eid string) error { + if err := validateID(nid, eid); err != nil { + return err + } + + n := d.network(nid) + if n == nil { + return fmt.Errorf("could not find network with id %s", nid) + } + + ep := n.endpoint(eid) + + if ep == nil { + return types.InternalMaskableErrorf("could not find endpoint with id %s", eid) + } + + if d.notifyCh != nil { + d.notifyCh <- ovNotify{ + action: "leave", + nid: nid, + eid: eid, + } + } + + n.leaveSandbox() + + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_endpoint.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_endpoint.go new file mode 100644 index 0000000000..7a861a97a3 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_endpoint.go @@ -0,0 +1,104 @@ +package overlay + +import ( + "fmt" + "net" + + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/netutils" +) + +type endpointTable map[string]*endpoint + +type endpoint struct { + id string + mac net.HardwareAddr + addr *net.IPNet +} + +func (n *network) endpoint(eid string) *endpoint { + n.Lock() + defer n.Unlock() + + return n.endpoints[eid] +} + +func (n *network) addEndpoint(ep *endpoint) { + n.Lock() + n.endpoints[ep.id] = ep + n.Unlock() +} + +func (n *network) deleteEndpoint(eid string) { + n.Lock() + delete(n.endpoints, eid) + n.Unlock() +} + +func (d *driver) CreateEndpoint(nid, eid string, ifInfo driverapi.InterfaceInfo, + epOptions map[string]interface{}) error { + var err error + + if err = validateID(nid, eid); err != nil { + return err + } + + // Since we perform lazy configuration make sure we try + // configuring the driver when we enter CreateEndpoint since + // CreateNetwork may not be called in every node. + if err := d.configure(); err != nil { + return err + } + + n := d.network(nid) + if n == nil { + return fmt.Errorf("network id %q not found", nid) + } + + ep := &endpoint{ + id: eid, + addr: ifInfo.Address(), + mac: ifInfo.MacAddress(), + } + if ep.addr == nil { + return fmt.Errorf("create endpoint was not passed interface IP address") + } + + if s := n.getSubnetforIP(ep.addr); s == nil { + return fmt.Errorf("no matching subnet for IP %q in network %q\n", ep.addr, nid) + } + + if ep.mac == nil { + ep.mac = netutils.GenerateMACFromIP(ep.addr.IP) + if err := ifInfo.SetMacAddress(ep.mac); err != nil { + return err + } + } + + n.addEndpoint(ep) + + return nil +} + +func (d *driver) DeleteEndpoint(nid, eid string) error { + if err := validateID(nid, eid); err != nil { + return err + } + + n := d.network(nid) + if n == nil { + return fmt.Errorf("network id %q not found", nid) + } + + ep := n.endpoint(eid) + if ep == nil { + return fmt.Errorf("endpoint id %q not found", eid) + } + + n.deleteEndpoint(eid) + return nil +} + +func (d *driver) EndpointOperInfo(nid, eid string) (map[string]interface{}, error) { + return make(map[string]interface{}, 0), nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_network.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_network.go new file mode 100644 index 0000000000..0a891c0e5e --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_network.go @@ -0,0 +1,633 @@ +package overlay + +import ( + "encoding/json" + "fmt" + "net" + "os" + "sync" + "syscall" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/netutils" + "github.com/docker/libnetwork/osl" + "github.com/docker/libnetwork/resolvconf" + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" + "github.com/vishvananda/netlink/nl" +) + +var ( + hostMode bool + hostModeOnce sync.Once +) + +type networkTable map[string]*network + +type subnet struct { + once *sync.Once + vxlanName string + brName string + vni uint32 + initErr error + subnetIP *net.IPNet + gwIP *net.IPNet +} + +type subnetJSON struct { + SubnetIP string + GwIP string + Vni uint32 +} + +type network struct { + id string + dbIndex uint64 + dbExists bool + sbox osl.Sandbox + endpoints endpointTable + driver *driver + joinCnt int + once *sync.Once + initEpoch int + initErr error + subnets []*subnet + sync.Mutex +} + +func (d *driver) CreateNetwork(id string, option map[string]interface{}, ipV4Data, ipV6Data []driverapi.IPAMData) error { + if id == "" { + return fmt.Errorf("invalid network id") + } + + // Since we perform lazy configuration make sure we try + // configuring the driver when we enter CreateNetwork + if err := d.configure(); err != nil { + return err + } + + n := &network{ + id: id, + driver: d, + endpoints: endpointTable{}, + once: &sync.Once{}, + subnets: []*subnet{}, + } + + for _, ipd := range ipV4Data { + s := &subnet{ + subnetIP: ipd.Pool, + gwIP: ipd.Gateway, + once: &sync.Once{}, + } + n.subnets = append(n.subnets, s) + } + + if err := n.writeToStore(); err != nil { + return fmt.Errorf("failed to update data store for network %v: %v", n.id, err) + } + + d.addNetwork(n) + + return nil +} + +func (d *driver) DeleteNetwork(nid string) error { + if nid == "" { + return fmt.Errorf("invalid network id") + } + + n := d.network(nid) + if n == nil { + return fmt.Errorf("could not find network with id %s", nid) + } + + d.deleteNetwork(nid) + + return n.releaseVxlanID() +} + +func (n *network) incEndpointCount() { + n.Lock() + defer n.Unlock() + n.joinCnt++ +} + +func (n *network) joinSandbox() error { + // If there is a race between two go routines here only one will win + // the other will wait. + n.once.Do(func() { + // save the error status of initSandbox in n.initErr so that + // all the racing go routines are able to know the status. + n.initErr = n.initSandbox() + }) + + return n.initErr +} + +func (n *network) joinSubnetSandbox(s *subnet) error { + s.once.Do(func() { + s.initErr = n.initSubnetSandbox(s) + }) + return s.initErr +} + +func (n *network) leaveSandbox() { + n.Lock() + n.joinCnt-- + if n.joinCnt != 0 { + n.Unlock() + return + } + + // We are about to destroy sandbox since the container is leaving the network + // Reinitialize the once variable so that we will be able to trigger one time + // sandbox initialization(again) when another container joins subsequently. + n.once = &sync.Once{} + for _, s := range n.subnets { + s.once = &sync.Once{} + } + n.Unlock() + + n.destroySandbox() +} + +func (n *network) destroySandbox() { + sbox := n.sandbox() + if sbox != nil { + for _, iface := range sbox.Info().Interfaces() { + iface.Remove() + } + + for _, s := range n.subnets { + if hostMode { + if err := removeFilters(n.id[:12], s.brName); err != nil { + logrus.Warnf("Could not remove overlay filters: %v", err) + } + } + + if s.vxlanName != "" { + err := deleteInterface(s.vxlanName) + if err != nil { + logrus.Warnf("could not cleanup sandbox properly: %v", err) + } + } + } + + if hostMode { + if err := removeNetworkChain(n.id[:12]); err != nil { + logrus.Warnf("could not remove network chain: %v", err) + } + } + + sbox.Destroy() + n.setSandbox(nil) + } +} + +func setHostMode() { + if os.Getenv("_OVERLAY_HOST_MODE") != "" { + hostMode = true + return + } + + err := createVxlan("testvxlan", 1) + if err != nil { + logrus.Errorf("Failed to create testvxlan interface: %v", err) + return + } + + defer deleteInterface("testvxlan") + + path := "/proc/self/ns/net" + f, err := os.OpenFile(path, os.O_RDONLY, 0) + if err != nil { + logrus.Errorf("Failed to open path %s for network namespace for setting host mode: %v", path, err) + return + } + defer f.Close() + + nsFD := f.Fd() + + iface, err := netlink.LinkByName("testvxlan") + if err != nil { + logrus.Errorf("Failed to get link testvxlan: %v", err) + return + } + + // If we are not able to move the vxlan interface to a namespace + // then fallback to host mode + if err := netlink.LinkSetNsFd(iface, int(nsFD)); err != nil { + hostMode = true + } +} + +func (n *network) generateVxlanName(s *subnet) string { + return "vx-" + fmt.Sprintf("%06x", n.vxlanID(s)) + "-" + n.id[:5] +} + +func (n *network) generateBridgeName(s *subnet) string { + return "ov-" + fmt.Sprintf("%06x", n.vxlanID(s)) + "-" + n.id[:5] +} + +func isOverlap(nw *net.IPNet) bool { + var nameservers []string + + if rc, err := resolvconf.Get(); err == nil { + nameservers = resolvconf.GetNameserversAsCIDR(rc.Content) + } + + if err := netutils.CheckNameserverOverlaps(nameservers, nw); err != nil { + return true + } + + if err := netutils.CheckRouteOverlaps(nw); err != nil { + return true + } + + return false +} + +func (n *network) initSubnetSandbox(s *subnet) error { + brName := n.generateBridgeName(s) + vxlanName := n.generateVxlanName(s) + + if hostMode { + // Try to delete stale bridge interface if it exists + deleteInterface(brName) + // Try to delete the vxlan interface by vni if already present + deleteVxlanByVNI(n.vxlanID(s)) + + if isOverlap(s.subnetIP) { + return fmt.Errorf("overlay subnet %s has conflicts in the host while running in host mode", s.subnetIP.String()) + } + } + + // create a bridge and vxlan device for this subnet and move it to the sandbox + sbox := n.sandbox() + + if err := sbox.AddInterface(brName, "br", + sbox.InterfaceOptions().Address(s.gwIP), + sbox.InterfaceOptions().Bridge(true)); err != nil { + return fmt.Errorf("bridge creation in sandbox failed for subnet %q: %v", s.subnetIP.String(), err) + } + + err := createVxlan(vxlanName, n.vxlanID(s)) + if err != nil { + return err + } + + if err := sbox.AddInterface(vxlanName, "vxlan", + sbox.InterfaceOptions().Master(brName)); err != nil { + return fmt.Errorf("vxlan interface creation failed for subnet %q: %v", s.subnetIP.String(), err) + } + + if hostMode { + if err := addFilters(n.id[:12], brName); err != nil { + return err + } + } + + n.Lock() + s.vxlanName = vxlanName + s.brName = brName + n.Unlock() + + return nil +} + +func (n *network) initSandbox() error { + n.Lock() + n.initEpoch++ + n.Unlock() + + hostModeOnce.Do(setHostMode) + + if hostMode { + if err := addNetworkChain(n.id[:12]); err != nil { + return err + } + } + + sbox, err := osl.NewSandbox( + osl.GenerateKey(fmt.Sprintf("%d-", n.initEpoch)+n.id), !hostMode) + if err != nil { + return fmt.Errorf("could not create network sandbox: %v", err) + } + + n.setSandbox(sbox) + + n.driver.peerDbUpdateSandbox(n.id) + + var nlSock *nl.NetlinkSocket + sbox.InvokeFunc(func() { + nlSock, err = nl.Subscribe(syscall.NETLINK_ROUTE, syscall.RTNLGRP_NEIGH) + if err != nil { + err = fmt.Errorf("failed to subscribe to neighbor group netlink messages") + } + }) + + go n.watchMiss(nlSock) + return nil +} + +func (n *network) watchMiss(nlSock *nl.NetlinkSocket) { + for { + msgs, err := nlSock.Receive() + if err != nil { + logrus.Errorf("Failed to receive from netlink: %v ", err) + continue + } + + for _, msg := range msgs { + if msg.Header.Type != syscall.RTM_GETNEIGH && msg.Header.Type != syscall.RTM_NEWNEIGH { + continue + } + + neigh, err := netlink.NeighDeserialize(msg.Data) + if err != nil { + logrus.Errorf("Failed to deserialize netlink ndmsg: %v", err) + continue + } + + if neigh.IP.To16() != nil { + continue + } + + if neigh.State&(netlink.NUD_STALE|netlink.NUD_INCOMPLETE) == 0 { + continue + } + + mac, IPmask, vtep, err := n.driver.resolvePeer(n.id, neigh.IP) + if err != nil { + logrus.Errorf("could not resolve peer %q: %v", neigh.IP, err) + continue + } + + if err := n.driver.peerAdd(n.id, "dummy", neigh.IP, IPmask, mac, vtep, true); err != nil { + logrus.Errorf("could not add neighbor entry for missed peer %q: %v", neigh.IP, err) + } + } + } +} + +func (d *driver) addNetwork(n *network) { + d.Lock() + d.networks[n.id] = n + d.Unlock() +} + +func (d *driver) deleteNetwork(nid string) { + d.Lock() + delete(d.networks, nid) + d.Unlock() +} + +func (d *driver) network(nid string) *network { + d.Lock() + networks := d.networks + d.Unlock() + + n, ok := networks[nid] + if !ok { + n = d.getNetworkFromStore(nid) + if n != nil { + n.driver = d + n.endpoints = endpointTable{} + n.once = &sync.Once{} + networks[nid] = n + } + } + + return n +} + +func (d *driver) getNetworkFromStore(nid string) *network { + if d.store == nil { + return nil + } + + n := &network{id: nid} + if err := d.store.GetObject(datastore.Key(n.Key()...), n); err != nil { + return nil + } + + return n +} + +func (n *network) sandbox() osl.Sandbox { + n.Lock() + defer n.Unlock() + + return n.sbox +} + +func (n *network) setSandbox(sbox osl.Sandbox) { + n.Lock() + n.sbox = sbox + n.Unlock() +} + +func (n *network) vxlanID(s *subnet) uint32 { + n.Lock() + defer n.Unlock() + + return s.vni +} + +func (n *network) setVxlanID(s *subnet, vni uint32) { + n.Lock() + s.vni = vni + n.Unlock() +} + +func (n *network) Key() []string { + return []string{"overlay", "network", n.id} +} + +func (n *network) KeyPrefix() []string { + return []string{"overlay", "network"} +} + +func (n *network) Value() []byte { + netJSON := []*subnetJSON{} + + for _, s := range n.subnets { + sj := &subnetJSON{ + SubnetIP: s.subnetIP.String(), + GwIP: s.gwIP.String(), + Vni: s.vni, + } + netJSON = append(netJSON, sj) + } + + b, err := json.Marshal(netJSON) + + if err != nil { + return []byte{} + } + return b +} + +func (n *network) Index() uint64 { + return n.dbIndex +} + +func (n *network) SetIndex(index uint64) { + n.dbIndex = index + n.dbExists = true +} + +func (n *network) Exists() bool { + return n.dbExists +} + +func (n *network) Skip() bool { + return false +} + +func (n *network) SetValue(value []byte) error { + var newNet bool + netJSON := []*subnetJSON{} + + err := json.Unmarshal(value, &netJSON) + if err != nil { + return err + } + + if len(n.subnets) == 0 { + newNet = true + } + + for _, sj := range netJSON { + subnetIPstr := sj.SubnetIP + gwIPstr := sj.GwIP + vni := sj.Vni + + subnetIP, _ := types.ParseCIDR(subnetIPstr) + gwIP, _ := types.ParseCIDR(gwIPstr) + + if newNet { + s := &subnet{ + subnetIP: subnetIP, + gwIP: gwIP, + vni: vni, + once: &sync.Once{}, + } + n.subnets = append(n.subnets, s) + } else { + sNet := n.getMatchingSubnet(subnetIP) + if sNet != nil { + sNet.vni = vni + } + } + } + return nil +} + +func (n *network) DataScope() string { + return datastore.GlobalScope +} + +func (n *network) writeToStore() error { + return n.driver.store.PutObjectAtomic(n) +} + +func (n *network) releaseVxlanID() error { + if n.driver.store == nil { + return fmt.Errorf("no datastore configured. cannot release vxlan id") + } + + if len(n.subnets) == 0 { + return nil + } + + if err := n.driver.store.DeleteObjectAtomic(n); err != nil { + if err == datastore.ErrKeyModified || err == datastore.ErrKeyNotFound { + // In both the above cases we can safely assume that the key has been removed by some other + // instance and so simply get out of here + return nil + } + + return fmt.Errorf("failed to delete network to vxlan id map: %v", err) + } + + for _, s := range n.subnets { + n.driver.vxlanIdm.Release(uint64(n.vxlanID(s))) + n.setVxlanID(s, 0) + } + return nil +} + +func (n *network) obtainVxlanID(s *subnet) error { + //return if the subnet already has a vxlan id assigned + if s.vni != 0 { + return nil + } + + if n.driver.store == nil { + return fmt.Errorf("no datastore configured. cannot obtain vxlan id") + } + + for { + if err := n.driver.store.GetObject(datastore.Key(n.Key()...), n); err != nil { + return fmt.Errorf("getting network %q from datastore failed %v", n.id, err) + } + + if s.vni == 0 { + vxlanID, err := n.driver.vxlanIdm.GetID() + if err != nil { + return fmt.Errorf("failed to allocate vxlan id: %v", err) + } + + n.setVxlanID(s, uint32(vxlanID)) + if err := n.writeToStore(); err != nil { + n.driver.vxlanIdm.Release(uint64(n.vxlanID(s))) + n.setVxlanID(s, 0) + if err == datastore.ErrKeyModified { + continue + } + return fmt.Errorf("network %q failed to update data store: %v", n.id, err) + } + return nil + } + return nil + } +} + +// getSubnetforIP returns the subnet to which the given IP belongs +func (n *network) getSubnetforIP(ip *net.IPNet) *subnet { + for _, s := range n.subnets { + // first check if the mask lengths are the same + i, _ := s.subnetIP.Mask.Size() + j, _ := ip.Mask.Size() + if i != j { + continue + } + if s.subnetIP.Contains(ip.IP) { + return s + } + } + return nil +} + +// getMatchingSubnet return the network's subnet that matches the input +func (n *network) getMatchingSubnet(ip *net.IPNet) *subnet { + if ip == nil { + return nil + } + for _, s := range n.subnets { + // first check if the mask lengths are the same + i, _ := s.subnetIP.Mask.Size() + j, _ := ip.Mask.Size() + if i != j { + continue + } + if s.subnetIP.IP.Equal(ip.IP) { + return s + } + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_serf.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_serf.go new file mode 100644 index 0000000000..e3f373c0d0 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_serf.go @@ -0,0 +1,234 @@ +package overlay + +import ( + "fmt" + "net" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/hashicorp/serf/serf" +) + +type ovNotify struct { + action string + eid string + nid string +} + +type logWriter struct{} + +func (l *logWriter) Write(p []byte) (int, error) { + str := string(p) + + switch { + case strings.Contains(str, "[WARN]"): + logrus.Warn(str) + case strings.Contains(str, "[DEBUG]"): + logrus.Debug(str) + case strings.Contains(str, "[INFO]"): + logrus.Info(str) + case strings.Contains(str, "[ERR]"): + logrus.Error(str) + } + + return len(p), nil +} + +func (d *driver) serfInit() error { + var err error + + config := serf.DefaultConfig() + config.Init() + config.MemberlistConfig.BindAddr = d.bindAddress + + d.eventCh = make(chan serf.Event, 4) + config.EventCh = d.eventCh + config.UserCoalescePeriod = 1 * time.Second + config.UserQuiescentPeriod = 50 * time.Millisecond + + config.LogOutput = &logWriter{} + config.MemberlistConfig.LogOutput = config.LogOutput + + s, err := serf.Create(config) + if err != nil { + return fmt.Errorf("failed to create cluster node: %v", err) + } + defer func() { + if err != nil { + s.Shutdown() + } + }() + + d.serfInstance = s + + d.notifyCh = make(chan ovNotify) + d.exitCh = make(chan chan struct{}) + + go d.startSerfLoop(d.eventCh, d.notifyCh, d.exitCh) + return nil +} + +func (d *driver) serfJoin(neighIP string) error { + if neighIP == "" { + return fmt.Errorf("no neighbor to join") + } + if _, err := d.serfInstance.Join([]string{neighIP}, false); err != nil { + return fmt.Errorf("Failed to join the cluster at neigh IP %s: %v", + neighIP, err) + } + return nil +} + +func (d *driver) notifyEvent(event ovNotify) { + n := d.network(event.nid) + ep := n.endpoint(event.eid) + + ePayload := fmt.Sprintf("%s %s %s %s", event.action, ep.addr.IP.String(), + net.IP(ep.addr.Mask).String(), ep.mac.String()) + eName := fmt.Sprintf("jl %s %s %s", d.serfInstance.LocalMember().Addr.String(), + event.nid, event.eid) + + if err := d.serfInstance.UserEvent(eName, []byte(ePayload), true); err != nil { + logrus.Errorf("Sending user event failed: %v\n", err) + } +} + +func (d *driver) processEvent(u serf.UserEvent) { + logrus.Debugf("Received user event name:%s, payload:%s\n", u.Name, + string(u.Payload)) + + var dummy, action, vtepStr, nid, eid, ipStr, maskStr, macStr string + if _, err := fmt.Sscan(u.Name, &dummy, &vtepStr, &nid, &eid); err != nil { + fmt.Printf("Failed to scan name string: %v\n", err) + } + + if _, err := fmt.Sscan(string(u.Payload), &action, + &ipStr, &maskStr, &macStr); err != nil { + fmt.Printf("Failed to scan value string: %v\n", err) + } + + logrus.Debugf("Parsed data = %s/%s/%s/%s/%s/%s\n", nid, eid, vtepStr, ipStr, maskStr, macStr) + + mac, err := net.ParseMAC(macStr) + if err != nil { + logrus.Errorf("Failed to parse mac: %v\n", err) + } + + if d.serfInstance.LocalMember().Addr.String() == vtepStr { + return + } + + switch action { + case "join": + if err := d.peerAdd(nid, eid, net.ParseIP(ipStr), net.IPMask(net.ParseIP(maskStr).To4()), mac, + net.ParseIP(vtepStr), true); err != nil { + logrus.Errorf("Peer add failed in the driver: %v\n", err) + } + case "leave": + if err := d.peerDelete(nid, eid, net.ParseIP(ipStr), net.IPMask(net.ParseIP(maskStr).To4()), mac, + net.ParseIP(vtepStr), true); err != nil { + logrus.Errorf("Peer delete failed in the driver: %v\n", err) + } + } +} + +func (d *driver) processQuery(q *serf.Query) { + logrus.Debugf("Received query name:%s, payload:%s\n", q.Name, + string(q.Payload)) + + var nid, ipStr string + if _, err := fmt.Sscan(string(q.Payload), &nid, &ipStr); err != nil { + fmt.Printf("Failed to scan query payload string: %v\n", err) + } + + peerMac, peerIPMask, vtep, err := d.peerDbSearch(nid, net.ParseIP(ipStr)) + if err != nil { + return + } + + q.Respond([]byte(fmt.Sprintf("%s %s %s", peerMac.String(), net.IP(peerIPMask).String(), vtep.String()))) +} + +func (d *driver) resolvePeer(nid string, peerIP net.IP) (net.HardwareAddr, net.IPMask, net.IP, error) { + if d.serfInstance == nil { + return nil, nil, nil, fmt.Errorf("could not resolve peer: serf instance not initialized") + } + + qPayload := fmt.Sprintf("%s %s", string(nid), peerIP.String()) + resp, err := d.serfInstance.Query("peerlookup", []byte(qPayload), nil) + if err != nil { + return nil, nil, nil, fmt.Errorf("resolving peer by querying the cluster failed: %v", err) + } + + respCh := resp.ResponseCh() + select { + case r := <-respCh: + var macStr, maskStr, vtepStr string + if _, err := fmt.Sscan(string(r.Payload), &macStr, &maskStr, &vtepStr); err != nil { + return nil, nil, nil, fmt.Errorf("bad response %q for the resolve query: %v", string(r.Payload), err) + } + + mac, err := net.ParseMAC(macStr) + if err != nil { + return nil, nil, nil, fmt.Errorf("failed to parse mac: %v", err) + } + + return mac, net.IPMask(net.ParseIP(maskStr).To4()), net.ParseIP(vtepStr), nil + + case <-time.After(time.Second): + return nil, nil, nil, fmt.Errorf("timed out resolving peer by querying the cluster") + } +} + +func (d *driver) startSerfLoop(eventCh chan serf.Event, notifyCh chan ovNotify, + exitCh chan chan struct{}) { + + for { + select { + case notify, ok := <-notifyCh: + if !ok { + break + } + + d.notifyEvent(notify) + case ch, ok := <-exitCh: + if !ok { + break + } + + if err := d.serfInstance.Leave(); err != nil { + logrus.Errorf("failed leaving the cluster: %v\n", err) + } + + d.serfInstance.Shutdown() + close(ch) + return + case e, ok := <-eventCh: + if !ok { + break + } + + if e.EventType() == serf.EventQuery { + d.processQuery(e.(*serf.Query)) + break + } + + u, ok := e.(serf.UserEvent) + if !ok { + break + } + d.processEvent(u) + } + } +} + +func (d *driver) isSerfAlive() bool { + d.Lock() + serfInstance := d.serfInstance + d.Unlock() + if serfInstance == nil || serfInstance.State() != serf.SerfAlive { + return false + } + return true +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_utils.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_utils.go new file mode 100644 index 0000000000..42c44b9675 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/ov_utils.go @@ -0,0 +1,105 @@ +package overlay + +import ( + "fmt" + + "github.com/docker/libnetwork/netutils" + "github.com/docker/libnetwork/osl" + "github.com/vishvananda/netlink" + "github.com/vishvananda/netlink/nl" +) + +func validateID(nid, eid string) error { + if nid == "" { + return fmt.Errorf("invalid network id") + } + + if eid == "" { + return fmt.Errorf("invalid endpoint id") + } + + return nil +} + +func createVethPair() (string, string, error) { + defer osl.InitOSContext()() + + // Generate a name for what will be the host side pipe interface + name1, err := netutils.GenerateIfaceName(vethPrefix, vethLen) + if err != nil { + return "", "", fmt.Errorf("error generating veth name1: %v", err) + } + + // Generate a name for what will be the sandbox side pipe interface + name2, err := netutils.GenerateIfaceName(vethPrefix, vethLen) + if err != nil { + return "", "", fmt.Errorf("error generating veth name2: %v", err) + } + + // Generate and add the interface pipe host <-> sandbox + veth := &netlink.Veth{ + LinkAttrs: netlink.LinkAttrs{Name: name1, TxQLen: 0}, + PeerName: name2} + if err := netlink.LinkAdd(veth); err != nil { + return "", "", fmt.Errorf("error creating veth pair: %v", err) + } + + return name1, name2, nil +} + +func createVxlan(name string, vni uint32) error { + defer osl.InitOSContext()() + + vxlan := &netlink.Vxlan{ + LinkAttrs: netlink.LinkAttrs{Name: name}, + VxlanId: int(vni), + Learning: true, + Port: int(nl.Swap16(vxlanPort)), //network endian order + Proxy: true, + L3miss: true, + L2miss: true, + } + + if err := netlink.LinkAdd(vxlan); err != nil { + return fmt.Errorf("error creating vxlan interface: %v", err) + } + + return nil +} + +func deleteInterface(name string) error { + defer osl.InitOSContext()() + + link, err := netlink.LinkByName(name) + if err != nil { + return fmt.Errorf("failed to find interface with name %s: %v", name, err) + } + + if err := netlink.LinkDel(link); err != nil { + return fmt.Errorf("error deleting interface with name %s: %v", name, err) + } + + return nil +} + +func deleteVxlanByVNI(vni uint32) error { + defer osl.InitOSContext()() + + links, err := netlink.LinkList() + if err != nil { + return fmt.Errorf("failed to list interfaces while deleting vxlan interface by vni: %v", err) + } + + for _, l := range links { + if l.Type() == "vxlan" && l.(*netlink.Vxlan).VxlanId == int(vni) { + err = netlink.LinkDel(l) + if err != nil { + return fmt.Errorf("error deleting vxlan interface with id %d: %v", vni, err) + } + + return nil + } + } + + return fmt.Errorf("could not find a vxlan interface to delete with id %d", vni) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/overlay.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/overlay.go new file mode 100644 index 0000000000..982310d7a2 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/overlay.go @@ -0,0 +1,209 @@ +package overlay + +import ( + "fmt" + "net" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/libkv/store" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/idm" + "github.com/docker/libnetwork/netlabel" + "github.com/hashicorp/serf/serf" +) + +const ( + networkType = "overlay" + vethPrefix = "veth" + vethLen = 7 + vxlanIDStart = 256 + vxlanIDEnd = 1000 + vxlanPort = 4789 + vxlanVethMTU = 1450 +) + +type driver struct { + eventCh chan serf.Event + notifyCh chan ovNotify + exitCh chan chan struct{} + bindAddress string + neighIP string + config map[string]interface{} + peerDb peerNetworkMap + serfInstance *serf.Serf + networks networkTable + store datastore.DataStore + ipAllocator *idm.Idm + vxlanIdm *idm.Idm + once sync.Once + joinOnce sync.Once + sync.Mutex +} + +// Init registers a new instance of overlay driver +func Init(dc driverapi.DriverCallback, config map[string]interface{}) error { + c := driverapi.Capability{ + DataScope: datastore.GlobalScope, + } + + d := &driver{ + networks: networkTable{}, + peerDb: peerNetworkMap{ + mp: map[string]peerMap{}, + }, + config: config, + } + + return dc.RegisterDriver(networkType, d, c) +} + +// Fini cleans up the driver resources +func Fini(drv driverapi.Driver) { + d := drv.(*driver) + + if d.exitCh != nil { + waitCh := make(chan struct{}) + + d.exitCh <- waitCh + + <-waitCh + } +} + +func (d *driver) configure() error { + var err error + + if len(d.config) == 0 { + return nil + } + + d.once.Do(func() { + provider, provOk := d.config[netlabel.GlobalKVProvider] + provURL, urlOk := d.config[netlabel.GlobalKVProviderURL] + + if provOk && urlOk { + cfg := &datastore.ScopeCfg{ + Client: datastore.ScopeClientCfg{ + Provider: provider.(string), + Address: provURL.(string), + }, + } + provConfig, confOk := d.config[netlabel.GlobalKVProviderConfig] + if confOk { + cfg.Client.Config = provConfig.(*store.Config) + } + d.store, err = datastore.NewDataStore(datastore.GlobalScope, cfg) + if err != nil { + err = fmt.Errorf("failed to initialize data store: %v", err) + return + } + } + + d.vxlanIdm, err = idm.New(d.store, "vxlan-id", vxlanIDStart, vxlanIDEnd) + if err != nil { + err = fmt.Errorf("failed to initialize vxlan id manager: %v", err) + return + } + + d.ipAllocator, err = idm.New(d.store, "ipam-id", 1, 0xFFFF-2) + if err != nil { + err = fmt.Errorf("failed to initalize ipam id manager: %v", err) + return + } + }) + + return err +} + +func (d *driver) Type() string { + return networkType +} + +func validateSelf(node string) error { + advIP := net.ParseIP(node) + if advIP == nil { + return fmt.Errorf("invalid self address (%s)", node) + } + + addrs, err := net.InterfaceAddrs() + if err != nil { + return fmt.Errorf("Unable to get interface addresses %v", err) + } + for _, addr := range addrs { + ip, _, err := net.ParseCIDR(addr.String()) + if err == nil && ip.Equal(advIP) { + return nil + } + } + return fmt.Errorf("Multi-Host overlay networking requires cluster-advertise(%s) to be configured with a local ip-address that is reachable within the cluster", advIP.String()) +} + +func (d *driver) nodeJoin(node string, self bool) { + if self && !d.isSerfAlive() { + if err := validateSelf(node); err != nil { + logrus.Errorf("%s", err.Error()) + } + d.Lock() + d.bindAddress = node + d.Unlock() + err := d.serfInit() + if err != nil { + logrus.Errorf("initializing serf instance failed: %v", err) + return + } + } + + d.Lock() + if !self { + d.neighIP = node + } + neighIP := d.neighIP + d.Unlock() + + if d.serfInstance != nil && neighIP != "" { + var err error + d.joinOnce.Do(func() { + err = d.serfJoin(neighIP) + if err == nil { + d.pushLocalDb() + } + }) + if err != nil { + logrus.Errorf("joining serf neighbor %s failed: %v", node, err) + d.Lock() + d.joinOnce = sync.Once{} + d.Unlock() + return + } + } +} + +func (d *driver) pushLocalEndpointEvent(action, nid, eid string) { + if !d.isSerfAlive() { + return + } + d.notifyCh <- ovNotify{ + action: "join", + nid: nid, + eid: eid, + } +} + +// DiscoverNew is a notification for a new discovery event, such as a new node joining a cluster +func (d *driver) DiscoverNew(dType driverapi.DiscoveryType, data interface{}) error { + if dType == driverapi.NodeDiscovery { + nodeData, ok := data.(driverapi.NodeDiscoveryData) + if !ok || nodeData.Address == "" { + return fmt.Errorf("invalid discovery data") + } + d.nodeJoin(nodeData.Address, nodeData.Self) + } + return nil +} + +// DiscoverDelete is a notification for a discovery delete event, such as a node leaving a cluster +func (d *driver) DiscoverDelete(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/overlay/peerdb.go b/vendor/src/github.com/docker/libnetwork/drivers/overlay/peerdb.go new file mode 100644 index 0000000000..22a677d8ba --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/overlay/peerdb.go @@ -0,0 +1,329 @@ +package overlay + +import ( + "fmt" + "net" + "sync" + "syscall" +) + +type peerKey struct { + peerIP net.IP + peerMac net.HardwareAddr +} + +type peerEntry struct { + eid string + vtep net.IP + peerIPMask net.IPMask + inSandbox bool + isLocal bool +} + +type peerMap struct { + mp map[string]peerEntry + sync.Mutex +} + +type peerNetworkMap struct { + mp map[string]peerMap + sync.Mutex +} + +func (pKey peerKey) String() string { + return fmt.Sprintf("%s %s", pKey.peerIP, pKey.peerMac) +} + +func (pKey *peerKey) Scan(state fmt.ScanState, verb rune) error { + ipB, err := state.Token(true, nil) + if err != nil { + return err + } + + pKey.peerIP = net.ParseIP(string(ipB)) + + macB, err := state.Token(true, nil) + if err != nil { + return err + } + + pKey.peerMac, err = net.ParseMAC(string(macB)) + if err != nil { + return err + } + + return nil +} + +var peerDbWg sync.WaitGroup + +func (d *driver) peerDbWalk(f func(string, *peerKey, *peerEntry) bool) error { + d.peerDb.Lock() + nids := []string{} + for nid := range d.peerDb.mp { + nids = append(nids, nid) + } + d.peerDb.Unlock() + + for _, nid := range nids { + d.peerDbNetworkWalk(nid, func(pKey *peerKey, pEntry *peerEntry) bool { + return f(nid, pKey, pEntry) + }) + } + return nil +} + +func (d *driver) peerDbNetworkWalk(nid string, f func(*peerKey, *peerEntry) bool) error { + d.peerDb.Lock() + pMap, ok := d.peerDb.mp[nid] + if !ok { + d.peerDb.Unlock() + return nil + } + d.peerDb.Unlock() + + pMap.Lock() + for pKeyStr, pEntry := range pMap.mp { + var pKey peerKey + if _, err := fmt.Sscan(pKeyStr, &pKey); err != nil { + fmt.Printf("peer key scan failed: %v", err) + } + + if f(&pKey, &pEntry) { + pMap.Unlock() + return nil + } + } + pMap.Unlock() + + return nil +} + +func (d *driver) peerDbSearch(nid string, peerIP net.IP) (net.HardwareAddr, net.IPMask, net.IP, error) { + var ( + peerMac net.HardwareAddr + vtep net.IP + peerIPMask net.IPMask + found bool + ) + + err := d.peerDbNetworkWalk(nid, func(pKey *peerKey, pEntry *peerEntry) bool { + if pKey.peerIP.Equal(peerIP) { + peerMac = pKey.peerMac + peerIPMask = pEntry.peerIPMask + vtep = pEntry.vtep + found = true + return found + } + + return found + }) + + if err != nil { + return nil, nil, nil, fmt.Errorf("peerdb search for peer ip %q failed: %v", peerIP, err) + } + + if !found { + return nil, nil, nil, fmt.Errorf("peer ip %q not found in peerdb", peerIP) + } + + return peerMac, peerIPMask, vtep, nil +} + +func (d *driver) peerDbAdd(nid, eid string, peerIP net.IP, peerIPMask net.IPMask, + peerMac net.HardwareAddr, vtep net.IP, isLocal bool) { + + peerDbWg.Wait() + + d.peerDb.Lock() + pMap, ok := d.peerDb.mp[nid] + if !ok { + d.peerDb.mp[nid] = peerMap{ + mp: make(map[string]peerEntry), + } + + pMap = d.peerDb.mp[nid] + } + d.peerDb.Unlock() + + pKey := peerKey{ + peerIP: peerIP, + peerMac: peerMac, + } + + pEntry := peerEntry{ + eid: eid, + vtep: vtep, + peerIPMask: peerIPMask, + isLocal: isLocal, + } + + pMap.Lock() + pMap.mp[pKey.String()] = pEntry + pMap.Unlock() +} + +func (d *driver) peerDbDelete(nid, eid string, peerIP net.IP, peerIPMask net.IPMask, + peerMac net.HardwareAddr, vtep net.IP) { + peerDbWg.Wait() + + d.peerDb.Lock() + pMap, ok := d.peerDb.mp[nid] + if !ok { + d.peerDb.Unlock() + return + } + d.peerDb.Unlock() + + pKey := peerKey{ + peerIP: peerIP, + peerMac: peerMac, + } + + pMap.Lock() + delete(pMap.mp, pKey.String()) + pMap.Unlock() +} + +func (d *driver) peerDbUpdateSandbox(nid string) { + d.peerDb.Lock() + pMap, ok := d.peerDb.mp[nid] + if !ok { + d.peerDb.Unlock() + return + } + d.peerDb.Unlock() + + peerDbWg.Add(1) + + var peerOps []func() + pMap.Lock() + for pKeyStr, pEntry := range pMap.mp { + var pKey peerKey + if _, err := fmt.Sscan(pKeyStr, &pKey); err != nil { + fmt.Printf("peer key scan failed: %v", err) + } + + if pEntry.isLocal { + continue + } + + // Go captures variables by reference. The pEntry could be + // pointing to the same memory location for every iteration. Make + // a copy of pEntry before capturing it in the following closure. + entry := pEntry + op := func() { + if err := d.peerAdd(nid, entry.eid, pKey.peerIP, entry.peerIPMask, + pKey.peerMac, entry.vtep, + false); err != nil { + fmt.Printf("peerdbupdate in sandbox failed for ip %s and mac %s: %v", + pKey.peerIP, pKey.peerMac, err) + } + } + + peerOps = append(peerOps, op) + } + pMap.Unlock() + + for _, op := range peerOps { + op() + } + + peerDbWg.Done() +} + +func (d *driver) peerAdd(nid, eid string, peerIP net.IP, peerIPMask net.IPMask, + peerMac net.HardwareAddr, vtep net.IP, updateDb bool) error { + + if err := validateID(nid, eid); err != nil { + return err + } + + if updateDb { + d.peerDbAdd(nid, eid, peerIP, peerIPMask, peerMac, vtep, false) + } + + n := d.network(nid) + if n == nil { + return nil + } + + sbox := n.sandbox() + if sbox == nil { + return nil + } + + IP := &net.IPNet{ + IP: peerIP, + Mask: peerIPMask, + } + + s := n.getSubnetforIP(IP) + if s == nil { + return fmt.Errorf("couldn't find the subnet %q in network %q\n", IP.String(), n.id) + } + + if err := n.obtainVxlanID(s); err != nil { + return fmt.Errorf("couldn't get vxlan id for %q: %v", s.subnetIP.String(), err) + } + + if err := n.joinSubnetSandbox(s); err != nil { + return fmt.Errorf("subnet sandbox join failed for %q: %v", s.subnetIP.String(), err) + } + + // Add neighbor entry for the peer IP + if err := sbox.AddNeighbor(peerIP, peerMac, sbox.NeighborOptions().LinkName(s.vxlanName)); err != nil { + return fmt.Errorf("could not add neigbor entry into the sandbox: %v", err) + } + + // Add fdb entry to the bridge for the peer mac + if err := sbox.AddNeighbor(vtep, peerMac, sbox.NeighborOptions().LinkName(s.vxlanName), + sbox.NeighborOptions().Family(syscall.AF_BRIDGE)); err != nil { + return fmt.Errorf("could not add fdb entry into the sandbox: %v", err) + } + + return nil +} + +func (d *driver) peerDelete(nid, eid string, peerIP net.IP, peerIPMask net.IPMask, + peerMac net.HardwareAddr, vtep net.IP, updateDb bool) error { + + if err := validateID(nid, eid); err != nil { + return err + } + + if updateDb { + d.peerDbDelete(nid, eid, peerIP, peerIPMask, peerMac, vtep) + } + + n := d.network(nid) + if n == nil { + return nil + } + + sbox := n.sandbox() + if sbox == nil { + return nil + } + + // Delete fdb entry to the bridge for the peer mac + if err := sbox.DeleteNeighbor(vtep, peerMac); err != nil { + return fmt.Errorf("could not delete fdb entry into the sandbox: %v", err) + } + + // Delete neighbor entry for the peer IP + if err := sbox.DeleteNeighbor(peerIP, peerMac); err != nil { + return fmt.Errorf("could not delete neigbor entry into the sandbox: %v", err) + } + + return nil +} + +func (d *driver) pushLocalDb() { + d.peerDbWalk(func(nid string, pKey *peerKey, pEntry *peerEntry) bool { + if pEntry.isLocal { + d.pushLocalEndpointEvent("join", nid, pEntry.eid) + } + return false + }) +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/remote/api/api.go b/vendor/src/github.com/docker/libnetwork/drivers/remote/api/api.go new file mode 100644 index 0000000000..1d7742e21a --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/remote/api/api.go @@ -0,0 +1,163 @@ +/* +Package api represents all requests and responses suitable for conversation +with a remote driver. +*/ +package api + +import ( + "net" + + "github.com/docker/libnetwork/driverapi" +) + +// Response is the basic response structure used in all responses. +type Response struct { + Err string +} + +// GetError returns the error from the response, if any. +func (r *Response) GetError() string { + return r.Err +} + +// GetCapabilityResponse is the response of GetCapability request +type GetCapabilityResponse struct { + Response + Scope string +} + +// CreateNetworkRequest requests a new network. +type CreateNetworkRequest struct { + // A network ID that remote plugins are expected to store for future + // reference. + NetworkID string + + // A free form map->object interface for communication of options. + Options map[string]interface{} + + // IPAMData contains the address pool information for this network + IPv4Data, IPv6Data []driverapi.IPAMData +} + +// CreateNetworkResponse is the response to the CreateNetworkRequest. +type CreateNetworkResponse struct { + Response +} + +// DeleteNetworkRequest is the request to delete an existing network. +type DeleteNetworkRequest struct { + // The ID of the network to delete. + NetworkID string +} + +// DeleteNetworkResponse is the response to a request for deleting a network. +type DeleteNetworkResponse struct { + Response +} + +// CreateEndpointRequest is the request to create an endpoint within a network. +type CreateEndpointRequest struct { + // Provided at create time, this will be the network id referenced. + NetworkID string + // The ID of the endpoint for later reference. + EndpointID string + Interface *EndpointInterface + Options map[string]interface{} +} + +// EndpointInterface represents an interface endpoint. +type EndpointInterface struct { + Address string + AddressIPv6 string + MacAddress string +} + +// CreateEndpointResponse is the response to the CreateEndpoint action. +type CreateEndpointResponse struct { + Response + Interface *EndpointInterface +} + +// Interface is the representation of a linux interface. +type Interface struct { + Address *net.IPNet + AddressIPv6 *net.IPNet + MacAddress net.HardwareAddr +} + +// DeleteEndpointRequest describes the API for deleting an endpoint. +type DeleteEndpointRequest struct { + NetworkID string + EndpointID string +} + +// DeleteEndpointResponse is the response to the DeleteEndpoint action. +type DeleteEndpointResponse struct { + Response +} + +// EndpointInfoRequest retrieves information about the endpoint from the network driver. +type EndpointInfoRequest struct { + NetworkID string + EndpointID string +} + +// EndpointInfoResponse is the response to an EndpointInfoRequest. +type EndpointInfoResponse struct { + Response + Value map[string]interface{} +} + +// JoinRequest describes the API for joining an endpoint to a sandbox. +type JoinRequest struct { + NetworkID string + EndpointID string + SandboxKey string + Options map[string]interface{} +} + +// InterfaceName is the struct represetation of a pair of devices with source +// and destination, for the purposes of putting an endpoint into a container. +type InterfaceName struct { + SrcName string + DstName string + DstPrefix string +} + +// StaticRoute is the plain JSON representation of a static route. +type StaticRoute struct { + Destination string + RouteType int + NextHop string +} + +// JoinResponse is the response to a JoinRequest. +type JoinResponse struct { + Response + InterfaceName *InterfaceName + Gateway string + GatewayIPv6 string + StaticRoutes []StaticRoute +} + +// LeaveRequest describes the API for detaching an endpoint from a sandbox. +type LeaveRequest struct { + NetworkID string + EndpointID string +} + +// LeaveResponse is the answer to LeaveRequest. +type LeaveResponse struct { + Response +} + +// DiscoveryNotification represents a discovery notification +type DiscoveryNotification struct { + DiscoveryType driverapi.DiscoveryType + DiscoveryData interface{} +} + +// DiscoveryResponse is used by libnetwork to log any plugin error processing the discovery notifications +type DiscoveryResponse struct { + Response +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/remote/driver.go b/vendor/src/github.com/docker/libnetwork/drivers/remote/driver.go new file mode 100644 index 0000000000..a10698e317 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/remote/driver.go @@ -0,0 +1,324 @@ +package remote + +import ( + "fmt" + "net" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/plugins" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/drivers/remote/api" + "github.com/docker/libnetwork/types" +) + +type driver struct { + endpoint *plugins.Client + networkType string +} + +type maybeError interface { + GetError() string +} + +func newDriver(name string, client *plugins.Client) driverapi.Driver { + return &driver{networkType: name, endpoint: client} +} + +// Init makes sure a remote driver is registered when a network driver +// plugin is activated. +func Init(dc driverapi.DriverCallback, config map[string]interface{}) error { + plugins.Handle(driverapi.NetworkPluginEndpointType, func(name string, client *plugins.Client) { + // negotiate driver capability with client + d := newDriver(name, client) + c, err := d.(*driver).getCapabilities() + if err != nil { + log.Errorf("error getting capability for %s due to %v", name, err) + return + } + if err = dc.RegisterDriver(name, d, *c); err != nil { + log.Errorf("error registering driver for %s due to %v", name, err) + } + }) + return nil +} + +// Get capability from client +func (d *driver) getCapabilities() (*driverapi.Capability, error) { + var capResp api.GetCapabilityResponse + if err := d.call("GetCapabilities", nil, &capResp); err != nil { + return nil, err + } + + c := &driverapi.Capability{} + switch capResp.Scope { + case "global": + c.DataScope = datastore.GlobalScope + case "local": + c.DataScope = datastore.LocalScope + default: + return nil, fmt.Errorf("invalid capability: expecting 'local' or 'global', got %s", capResp.Scope) + } + + return c, nil +} + +// Config is not implemented for remote drivers, since it is assumed +// to be supplied to the remote process out-of-band (e.g., as command +// line arguments). +func (d *driver) Config(option map[string]interface{}) error { + return &driverapi.ErrNotImplemented{} +} + +func (d *driver) call(methodName string, arg interface{}, retVal maybeError) error { + method := driverapi.NetworkPluginEndpointType + "." + methodName + err := d.endpoint.Call(method, arg, retVal) + if err != nil { + return err + } + if e := retVal.GetError(); e != "" { + return fmt.Errorf("remote: %s", e) + } + return nil +} + +func (d *driver) CreateNetwork(id string, options map[string]interface{}, ipV4Data, ipV6Data []driverapi.IPAMData) error { + create := &api.CreateNetworkRequest{ + NetworkID: id, + Options: options, + IPv4Data: ipV4Data, + IPv6Data: ipV6Data, + } + return d.call("CreateNetwork", create, &api.CreateNetworkResponse{}) +} + +func (d *driver) DeleteNetwork(nid string) error { + delete := &api.DeleteNetworkRequest{NetworkID: nid} + return d.call("DeleteNetwork", delete, &api.DeleteNetworkResponse{}) +} + +func (d *driver) CreateEndpoint(nid, eid string, ifInfo driverapi.InterfaceInfo, epOptions map[string]interface{}) error { + if ifInfo == nil { + return fmt.Errorf("must not be called with nil InterfaceInfo") + } + + reqIface := &api.EndpointInterface{} + if ifInfo.Address() != nil { + reqIface.Address = ifInfo.Address().String() + } + if ifInfo.AddressIPv6() != nil { + reqIface.AddressIPv6 = ifInfo.AddressIPv6().String() + } + if ifInfo.MacAddress() != nil { + reqIface.MacAddress = ifInfo.MacAddress().String() + } + + create := &api.CreateEndpointRequest{ + NetworkID: nid, + EndpointID: eid, + Interface: reqIface, + Options: epOptions, + } + var res api.CreateEndpointResponse + if err := d.call("CreateEndpoint", create, &res); err != nil { + return err + } + + inIface, err := parseInterface(res) + if err != nil { + return err + } + if inIface == nil { + // Remote driver did not set any field + return nil + } + + if inIface.MacAddress != nil { + if err := ifInfo.SetMacAddress(inIface.MacAddress); err != nil { + return errorWithRollback(fmt.Sprintf("driver modified interface MAC address: %v", err), d.DeleteEndpoint(nid, eid)) + } + } + if inIface.Address != nil { + if err := ifInfo.SetIPAddress(inIface.Address); err != nil { + return errorWithRollback(fmt.Sprintf("driver modified interface address: %v", err), d.DeleteEndpoint(nid, eid)) + } + } + if inIface.AddressIPv6 != nil { + if err := ifInfo.SetIPAddress(inIface.AddressIPv6); err != nil { + return errorWithRollback(fmt.Sprintf("driver modified interface address: %v", err), d.DeleteEndpoint(nid, eid)) + } + } + + return nil +} + +func errorWithRollback(msg string, err error) error { + rollback := "rolled back" + if err != nil { + rollback = "failed to roll back: " + err.Error() + } + return fmt.Errorf("%s; %s", msg, rollback) +} + +func (d *driver) DeleteEndpoint(nid, eid string) error { + delete := &api.DeleteEndpointRequest{ + NetworkID: nid, + EndpointID: eid, + } + return d.call("DeleteEndpoint", delete, &api.DeleteEndpointResponse{}) +} + +func (d *driver) EndpointOperInfo(nid, eid string) (map[string]interface{}, error) { + info := &api.EndpointInfoRequest{ + NetworkID: nid, + EndpointID: eid, + } + var res api.EndpointInfoResponse + if err := d.call("EndpointOperInfo", info, &res); err != nil { + return nil, err + } + return res.Value, nil +} + +// Join method is invoked when a Sandbox is attached to an endpoint. +func (d *driver) Join(nid, eid string, sboxKey string, jinfo driverapi.JoinInfo, options map[string]interface{}) error { + join := &api.JoinRequest{ + NetworkID: nid, + EndpointID: eid, + SandboxKey: sboxKey, + Options: options, + } + var ( + res api.JoinResponse + err error + ) + if err = d.call("Join", join, &res); err != nil { + return err + } + + ifaceName := res.InterfaceName + if iface := jinfo.InterfaceName(); iface != nil && ifaceName != nil { + if err := iface.SetNames(ifaceName.SrcName, ifaceName.DstPrefix); err != nil { + return errorWithRollback(fmt.Sprintf("failed to set interface name: %s", err), d.Leave(nid, eid)) + } + } + + var addr net.IP + if res.Gateway != "" { + if addr = net.ParseIP(res.Gateway); addr == nil { + return fmt.Errorf(`unable to parse Gateway "%s"`, res.Gateway) + } + if jinfo.SetGateway(addr) != nil { + return errorWithRollback(fmt.Sprintf("failed to set gateway: %v", addr), d.Leave(nid, eid)) + } + } + if res.GatewayIPv6 != "" { + if addr = net.ParseIP(res.GatewayIPv6); addr == nil { + return fmt.Errorf(`unable to parse GatewayIPv6 "%s"`, res.GatewayIPv6) + } + if jinfo.SetGatewayIPv6(addr) != nil { + return errorWithRollback(fmt.Sprintf("failed to set gateway IPv6: %v", addr), d.Leave(nid, eid)) + } + } + if len(res.StaticRoutes) > 0 { + routes, err := parseStaticRoutes(res) + if err != nil { + return err + } + for _, route := range routes { + if jinfo.AddStaticRoute(route.Destination, route.RouteType, route.NextHop) != nil { + return errorWithRollback(fmt.Sprintf("failed to set static route: %v", route), d.Leave(nid, eid)) + } + } + } + return nil +} + +// Leave method is invoked when a Sandbox detaches from an endpoint. +func (d *driver) Leave(nid, eid string) error { + leave := &api.LeaveRequest{ + NetworkID: nid, + EndpointID: eid, + } + return d.call("Leave", leave, &api.LeaveResponse{}) +} + +func (d *driver) Type() string { + return d.networkType +} + +// DiscoverNew is a notification for a new discovery event, such as a new node joining a cluster +func (d *driver) DiscoverNew(dType driverapi.DiscoveryType, data interface{}) error { + if dType != driverapi.NodeDiscovery { + return fmt.Errorf("Unknown discovery type : %v", dType) + } + notif := &api.DiscoveryNotification{ + DiscoveryType: dType, + DiscoveryData: data, + } + return d.call("DiscoverNew", notif, &api.DiscoveryResponse{}) +} + +// DiscoverDelete is a notification for a discovery delete event, such as a node leaving a cluster +func (d *driver) DiscoverDelete(dType driverapi.DiscoveryType, data interface{}) error { + if dType != driverapi.NodeDiscovery { + return fmt.Errorf("Unknown discovery type : %v", dType) + } + notif := &api.DiscoveryNotification{ + DiscoveryType: dType, + DiscoveryData: data, + } + return d.call("DiscoverDelete", notif, &api.DiscoveryResponse{}) +} + +func parseStaticRoutes(r api.JoinResponse) ([]*types.StaticRoute, error) { + var routes = make([]*types.StaticRoute, len(r.StaticRoutes)) + for i, inRoute := range r.StaticRoutes { + var err error + outRoute := &types.StaticRoute{RouteType: inRoute.RouteType} + + if inRoute.Destination != "" { + if outRoute.Destination, err = types.ParseCIDR(inRoute.Destination); err != nil { + return nil, err + } + } + + if inRoute.NextHop != "" { + outRoute.NextHop = net.ParseIP(inRoute.NextHop) + if outRoute.NextHop == nil { + return nil, fmt.Errorf("failed to parse nexthop IP %s", inRoute.NextHop) + } + } + + routes[i] = outRoute + } + return routes, nil +} + +// parseInterfaces validates all the parameters of an Interface and returns them. +func parseInterface(r api.CreateEndpointResponse) (*api.Interface, error) { + var outIf *api.Interface + + inIf := r.Interface + if inIf != nil { + var err error + outIf = &api.Interface{} + if inIf.Address != "" { + if outIf.Address, err = types.ParseCIDR(inIf.Address); err != nil { + return nil, err + } + } + if inIf.AddressIPv6 != "" { + if outIf.AddressIPv6, err = types.ParseCIDR(inIf.AddressIPv6); err != nil { + return nil, err + } + } + if inIf.MacAddress != "" { + if outIf.MacAddress, err = net.ParseMAC(inIf.MacAddress); err != nil { + return nil, err + } + } + } + + return outIf, nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers/windows/windows.go b/vendor/src/github.com/docker/libnetwork/drivers/windows/windows.go new file mode 100644 index 0000000000..5464a5f070 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers/windows/windows.go @@ -0,0 +1,64 @@ +package windows + +import ( + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" +) + +const networkType = "windows" + +// TODO Windows. This is a placeholder for now + +type driver struct{} + +// Init registers a new instance of null driver +func Init(dc driverapi.DriverCallback, config map[string]interface{}) error { + c := driverapi.Capability{ + DataScope: datastore.LocalScope, + } + return dc.RegisterDriver(networkType, &driver{}, c) +} + +func (d *driver) CreateNetwork(id string, option map[string]interface{}, ipV4Data, ipV6Data []driverapi.IPAMData) error { + return nil +} + +func (d *driver) DeleteNetwork(nid string) error { + return nil +} + +func (d *driver) CreateEndpoint(nid, eid string, ifInfo driverapi.InterfaceInfo, epOptions map[string]interface{}) error { + return nil +} + +func (d *driver) DeleteEndpoint(nid, eid string) error { + return nil +} + +func (d *driver) EndpointOperInfo(nid, eid string) (map[string]interface{}, error) { + return make(map[string]interface{}, 0), nil +} + +// Join method is invoked when a Sandbox is attached to an endpoint. +func (d *driver) Join(nid, eid string, sboxKey string, jinfo driverapi.JoinInfo, options map[string]interface{}) error { + return nil +} + +// Leave method is invoked when a Sandbox detaches from an endpoint. +func (d *driver) Leave(nid, eid string) error { + return nil +} + +func (d *driver) Type() string { + return networkType +} + +// DiscoverNew is a notification for a new discovery event, such as a new node joining a cluster +func (d *driver) DiscoverNew(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} + +// DiscoverDelete is a notification for a discovery delete event, such as a node leaving a cluster +func (d *driver) DiscoverDelete(dType driverapi.DiscoveryType, data interface{}) error { + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers_freebsd.go b/vendor/src/github.com/docker/libnetwork/drivers_freebsd.go new file mode 100644 index 0000000000..416bba04d8 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers_freebsd.go @@ -0,0 +1,13 @@ +package libnetwork + +import ( + "github.com/docker/libnetwork/drivers/null" + "github.com/docker/libnetwork/drivers/remote" +) + +func getInitializers() []initializer { + return []initializer{ + {null.Init, "null"}, + {remote.Init, "remote"}, + } +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers_linux.go b/vendor/src/github.com/docker/libnetwork/drivers_linux.go new file mode 100644 index 0000000000..4d31b986c2 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers_linux.go @@ -0,0 +1,19 @@ +package libnetwork + +import ( + "github.com/docker/libnetwork/drivers/bridge" + "github.com/docker/libnetwork/drivers/host" + "github.com/docker/libnetwork/drivers/null" + "github.com/docker/libnetwork/drivers/overlay" + "github.com/docker/libnetwork/drivers/remote" +) + +func getInitializers() []initializer { + return []initializer{ + {bridge.Init, "bridge"}, + {host.Init, "host"}, + {null.Init, "null"}, + {remote.Init, "remote"}, + {overlay.Init, "overlay"}, + } +} diff --git a/vendor/src/github.com/docker/libnetwork/drivers_windows.go b/vendor/src/github.com/docker/libnetwork/drivers_windows.go new file mode 100644 index 0000000000..314ff8d58d --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/drivers_windows.go @@ -0,0 +1,9 @@ +package libnetwork + +import "github.com/docker/libnetwork/drivers/windows" + +func getInitializers() []initializer { + return []initializer{ + {windows.Init, "windows"}, + } +} diff --git a/vendor/src/github.com/docker/libnetwork/endpoint.go b/vendor/src/github.com/docker/libnetwork/endpoint.go new file mode 100644 index 0000000000..3c3c2ef29f --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/endpoint.go @@ -0,0 +1,860 @@ +package libnetwork + +import ( + "container/heap" + "encoding/json" + "fmt" + "net" + "strings" + "sync" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/options" + "github.com/docker/libnetwork/types" +) + +// Endpoint represents a logical connection between a network and a sandbox. +type Endpoint interface { + // A system generated id for this endpoint. + ID() string + + // Name returns the name of this endpoint. + Name() string + + // Network returns the name of the network to which this endpoint is attached. + Network() string + + // Join joins the sandbox to the endpoint and populates into the sandbox + // the network resources allocated for the endpoint. + Join(sandbox Sandbox, options ...EndpointOption) error + + // Leave detaches the network resources populated in the sandbox. + Leave(sandbox Sandbox, options ...EndpointOption) error + + // Return certain operational data belonging to this endpoint + Info() EndpointInfo + + // DriverInfo returns a collection of driver operational data related to this endpoint retrieved from the driver + DriverInfo() (map[string]interface{}, error) + + // Delete and detaches this endpoint from the network. + Delete() error +} + +// EndpointOption is a option setter function type used to pass varios options to Network +// and Endpoint interfaces methods. The various setter functions of type EndpointOption are +// provided by libnetwork, they look like Option[...](...) +type EndpointOption func(ep *endpoint) + +type endpoint struct { + name string + id string + network *network + iface *endpointInterface + joinInfo *endpointJoinInfo + sandboxID string + exposedPorts []types.TransportPort + anonymous bool + generic map[string]interface{} + joinLeaveDone chan struct{} + dbIndex uint64 + dbExists bool + sync.Mutex +} + +func (ep *endpoint) MarshalJSON() ([]byte, error) { + ep.Lock() + defer ep.Unlock() + + epMap := make(map[string]interface{}) + epMap["name"] = ep.name + epMap["id"] = ep.id + epMap["ep_iface"] = ep.iface + epMap["exposed_ports"] = ep.exposedPorts + if ep.generic != nil { + epMap["generic"] = ep.generic + } + epMap["sandbox"] = ep.sandboxID + epMap["anonymous"] = ep.anonymous + return json.Marshal(epMap) +} + +func (ep *endpoint) UnmarshalJSON(b []byte) (err error) { + ep.Lock() + defer ep.Unlock() + + var epMap map[string]interface{} + if err := json.Unmarshal(b, &epMap); err != nil { + return err + } + ep.name = epMap["name"].(string) + ep.id = epMap["id"].(string) + + ib, _ := json.Marshal(epMap["ep_iface"]) + json.Unmarshal(ib, &ep.iface) + + tb, _ := json.Marshal(epMap["exposed_ports"]) + var tPorts []types.TransportPort + json.Unmarshal(tb, &tPorts) + ep.exposedPorts = tPorts + + cb, _ := json.Marshal(epMap["sandbox"]) + json.Unmarshal(cb, &ep.sandboxID) + + if v, ok := epMap["generic"]; ok { + ep.generic = v.(map[string]interface{}) + + if opt, ok := ep.generic[netlabel.PortMap]; ok { + pblist := []types.PortBinding{} + + for i := 0; i < len(opt.([]interface{})); i++ { + pb := types.PortBinding{} + tmp := opt.([]interface{})[i].(map[string]interface{}) + + bytes, err := json.Marshal(tmp) + if err != nil { + log.Error(err) + break + } + err = json.Unmarshal(bytes, &pb) + if err != nil { + log.Error(err) + break + } + pblist = append(pblist, pb) + } + ep.generic[netlabel.PortMap] = pblist + } + + if opt, ok := ep.generic[netlabel.ExposedPorts]; ok { + tplist := []types.TransportPort{} + + for i := 0; i < len(opt.([]interface{})); i++ { + tp := types.TransportPort{} + tmp := opt.([]interface{})[i].(map[string]interface{}) + + bytes, err := json.Marshal(tmp) + if err != nil { + log.Error(err) + break + } + err = json.Unmarshal(bytes, &tp) + if err != nil { + log.Error(err) + break + } + tplist = append(tplist, tp) + } + ep.generic[netlabel.ExposedPorts] = tplist + + } + } + + if v, ok := epMap["anonymous"]; ok { + ep.anonymous = v.(bool) + } + return nil +} + +func (ep *endpoint) New() datastore.KVObject { + return &endpoint{network: ep.getNetwork()} +} + +func (ep *endpoint) CopyTo(o datastore.KVObject) error { + ep.Lock() + defer ep.Unlock() + + dstEp := o.(*endpoint) + dstEp.name = ep.name + dstEp.id = ep.id + dstEp.sandboxID = ep.sandboxID + dstEp.dbIndex = ep.dbIndex + dstEp.dbExists = ep.dbExists + dstEp.anonymous = ep.anonymous + + if ep.iface != nil { + dstEp.iface = &endpointInterface{} + ep.iface.CopyTo(dstEp.iface) + } + + dstEp.exposedPorts = make([]types.TransportPort, len(ep.exposedPorts)) + copy(dstEp.exposedPorts, ep.exposedPorts) + + dstEp.generic = options.Generic{} + for k, v := range ep.generic { + dstEp.generic[k] = v + } + + return nil +} + +func (ep *endpoint) ID() string { + ep.Lock() + defer ep.Unlock() + + return ep.id +} + +func (ep *endpoint) Name() string { + ep.Lock() + defer ep.Unlock() + + return ep.name +} + +func (ep *endpoint) Network() string { + if ep.network == nil { + return "" + } + + return ep.network.name +} + +func (ep *endpoint) isAnonymous() bool { + ep.Lock() + defer ep.Unlock() + return ep.anonymous +} + +// endpoint Key structure : endpoint/network-id/endpoint-id +func (ep *endpoint) Key() []string { + if ep.network == nil { + return nil + } + + return []string{datastore.EndpointKeyPrefix, ep.network.id, ep.id} +} + +func (ep *endpoint) KeyPrefix() []string { + if ep.network == nil { + return nil + } + + return []string{datastore.EndpointKeyPrefix, ep.network.id} +} + +func (ep *endpoint) networkIDFromKey(key string) (string, error) { + // endpoint Key structure : docker/libnetwork/endpoint/${network-id}/${endpoint-id} + // it's an invalid key if the key doesn't have all the 5 key elements above + keyElements := strings.Split(key, "/") + if !strings.HasPrefix(key, datastore.Key(datastore.EndpointKeyPrefix)) || len(keyElements) < 5 { + return "", fmt.Errorf("invalid endpoint key : %v", key) + } + // network-id is placed at index=3. pls refer to endpoint.Key() method + return strings.Split(key, "/")[3], nil +} + +func (ep *endpoint) Value() []byte { + b, err := json.Marshal(ep) + if err != nil { + return nil + } + return b +} + +func (ep *endpoint) SetValue(value []byte) error { + return json.Unmarshal(value, ep) +} + +func (ep *endpoint) Index() uint64 { + ep.Lock() + defer ep.Unlock() + return ep.dbIndex +} + +func (ep *endpoint) SetIndex(index uint64) { + ep.Lock() + defer ep.Unlock() + ep.dbIndex = index + ep.dbExists = true +} + +func (ep *endpoint) Exists() bool { + ep.Lock() + defer ep.Unlock() + return ep.dbExists +} + +func (ep *endpoint) Skip() bool { + return ep.getNetwork().Skip() +} + +func (ep *endpoint) processOptions(options ...EndpointOption) { + ep.Lock() + defer ep.Unlock() + + for _, opt := range options { + if opt != nil { + opt(ep) + } + } +} + +func (ep *endpoint) getNetwork() *network { + ep.Lock() + defer ep.Unlock() + + return ep.network +} + +func (ep *endpoint) getNetworkFromStore() (*network, error) { + if ep.network == nil { + return nil, fmt.Errorf("invalid network object in endpoint %s", ep.Name()) + } + + return ep.network.ctrlr.getNetworkFromStore(ep.network.id) +} + +func (ep *endpoint) Join(sbox Sandbox, options ...EndpointOption) error { + if sbox == nil { + return types.BadRequestErrorf("endpoint cannot be joined by nil container") + } + + sb, ok := sbox.(*sandbox) + if !ok { + return types.BadRequestErrorf("not a valid Sandbox interface") + } + + sb.joinLeaveStart() + defer sb.joinLeaveEnd() + + return ep.sbJoin(sbox, options...) +} + +func (ep *endpoint) sbJoin(sbox Sandbox, options ...EndpointOption) error { + var err error + sb, ok := sbox.(*sandbox) + if !ok { + return types.BadRequestErrorf("not a valid Sandbox interface") + } + + network, err := ep.getNetworkFromStore() + if err != nil { + return fmt.Errorf("failed to get network from store during join: %v", err) + } + + ep, err = network.getEndpointFromStore(ep.ID()) + if err != nil { + return fmt.Errorf("failed to get endpoint from store during join: %v", err) + } + + ep.Lock() + if ep.sandboxID != "" { + ep.Unlock() + return types.ForbiddenErrorf("another container is attached to the same network endpoint") + } + ep.Unlock() + + ep.Lock() + ep.network = network + ep.sandboxID = sbox.ID() + ep.joinInfo = &endpointJoinInfo{} + epid := ep.id + ep.Unlock() + defer func() { + if err != nil { + ep.Lock() + ep.sandboxID = "" + ep.Unlock() + } + }() + + network.Lock() + nid := network.id + network.Unlock() + + ep.processOptions(options...) + + driver, err := network.driver() + if err != nil { + return fmt.Errorf("failed to join endpoint: %v", err) + } + + err = driver.Join(nid, epid, sbox.Key(), ep, sbox.Labels()) + if err != nil { + return err + } + defer func() { + if err != nil { + // Do not alter global err variable, it's needed by the previous defer + if err := driver.Leave(nid, epid); err != nil { + log.Warnf("driver leave failed while rolling back join: %v", err) + } + } + }() + + // Watch for service records + network.getController().watchSvcRecord(ep) + + address := "" + if ip := ep.getFirstInterfaceAddress(); ip != nil { + address = ip.String() + } + if err = sb.updateHostsFile(address, network.getSvcRecords(ep)); err != nil { + return err + } + + if err = sb.updateDNS(network.enableIPv6); err != nil { + return err + } + + if err = network.getController().updateToStore(ep); err != nil { + return err + } + + sb.Lock() + heap.Push(&sb.endpoints, ep) + sb.Unlock() + defer func() { + if err != nil { + for i, e := range sb.getConnectedEndpoints() { + if e == ep { + sb.Lock() + heap.Remove(&sb.endpoints, i) + sb.Unlock() + return + } + } + } + }() + + if err = sb.populateNetworkResources(ep); err != nil { + return err + } + + if sb.needDefaultGW() { + return sb.setupDefaultGW(ep) + } + return sb.clearDefaultGW() +} + +func (ep *endpoint) rename(name string) error { + var err error + n := ep.getNetwork() + if n == nil { + return fmt.Errorf("network not connected for ep %q", ep.name) + } + + n.getController().Lock() + netWatch, ok := n.getController().nmap[n.ID()] + n.getController().Unlock() + + if !ok { + return fmt.Errorf("watch null for network %q", n.Name()) + } + + n.updateSvcRecord(ep, n.getController().getLocalEps(netWatch), false) + + oldName := ep.name + ep.name = name + + n.updateSvcRecord(ep, n.getController().getLocalEps(netWatch), true) + defer func() { + if err != nil { + n.updateSvcRecord(ep, n.getController().getLocalEps(netWatch), false) + ep.name = oldName + n.updateSvcRecord(ep, n.getController().getLocalEps(netWatch), true) + } + }() + + // Update the store with the updated name + if err = n.getController().updateToStore(ep); err != nil { + return err + } + // After the name change do a dummy endpoint count update to + // trigger the service record update in the peer nodes + + // Ignore the error because updateStore fail for EpCnt is a + // benign error. Besides there is no meaningful recovery that + // we can do. When the cluster recovers subsequent EpCnt update + // will force the peers to get the correct EP name. + n.getEpCnt().updateStore() + + return err +} + +func (ep *endpoint) hasInterface(iName string) bool { + ep.Lock() + defer ep.Unlock() + + return ep.iface != nil && ep.iface.srcName == iName +} + +func (ep *endpoint) Leave(sbox Sandbox, options ...EndpointOption) error { + if sbox == nil || sbox.ID() == "" || sbox.Key() == "" { + return types.BadRequestErrorf("invalid Sandbox passed to enpoint leave: %v", sbox) + } + + sb, ok := sbox.(*sandbox) + if !ok { + return types.BadRequestErrorf("not a valid Sandbox interface") + } + + sb.joinLeaveStart() + defer sb.joinLeaveEnd() + + return ep.sbLeave(sbox, options...) +} + +func (ep *endpoint) sbLeave(sbox Sandbox, options ...EndpointOption) error { + sb, ok := sbox.(*sandbox) + if !ok { + return types.BadRequestErrorf("not a valid Sandbox interface") + } + + n, err := ep.getNetworkFromStore() + if err != nil { + return fmt.Errorf("failed to get network from store during leave: %v", err) + } + + ep, err = n.getEndpointFromStore(ep.ID()) + if err != nil { + return fmt.Errorf("failed to get endpoint from store during leave: %v", err) + } + + ep.Lock() + sid := ep.sandboxID + ep.Unlock() + + if sid == "" { + return types.ForbiddenErrorf("cannot leave endpoint with no attached sandbox") + } + if sid != sbox.ID() { + return types.ForbiddenErrorf("unexpected sandbox ID in leave request. Expected %s. Got %s", ep.sandboxID, sbox.ID()) + } + + ep.processOptions(options...) + + d, err := n.driver() + if err != nil { + return fmt.Errorf("failed to leave endpoint: %v", err) + } + + ep.Lock() + ep.sandboxID = "" + ep.network = n + ep.Unlock() + + if err := d.Leave(n.id, ep.id); err != nil { + if _, ok := err.(types.MaskableError); !ok { + log.Warnf("driver error disconnecting container %s : %v", ep.name, err) + } + } + + if err := sb.clearNetworkResources(ep); err != nil { + log.Warnf("Could not cleanup network resources on container %s disconnect: %v", ep.name, err) + } + + // Update the store about the sandbox detach only after we + // have completed sb.clearNetworkresources above to avoid + // spurious logs when cleaning up the sandbox when the daemon + // ungracefully exits and restarts before completing sandbox + // detach but after store has been updated. + if err := n.getController().updateToStore(ep); err != nil { + return err + } + + sb.deleteHostsEntries(n.getSvcRecords(ep)) + + if !sb.inDelete && sb.needDefaultGW() { + ep := sb.getEPwithoutGateway() + if ep == nil { + return fmt.Errorf("endpoint without GW expected, but not found") + } + return sb.setupDefaultGW(ep) + } + return sb.clearDefaultGW() +} + +func (ep *endpoint) Delete() error { + var err error + n, err := ep.getNetworkFromStore() + if err != nil { + return fmt.Errorf("failed to get network during Delete: %v", err) + } + + ep, err = n.getEndpointFromStore(ep.ID()) + if err != nil { + return fmt.Errorf("failed to get endpoint from store during Delete: %v", err) + } + + ep.Lock() + epid := ep.id + name := ep.name + sb, _ := n.getController().SandboxByID(ep.sandboxID) + if sb != nil { + ep.Unlock() + return &ActiveContainerError{name: name, id: epid} + } + ep.Unlock() + + if err = n.getController().deleteFromStore(ep); err != nil { + return err + } + defer func() { + if err != nil { + ep.dbExists = false + if e := n.getController().updateToStore(ep); e != nil { + log.Warnf("failed to recreate endpoint in store %s : %v", name, e) + } + } + }() + + if err = n.getEpCnt().DecEndpointCnt(); err != nil { + return err + } + defer func() { + if err != nil { + if e := n.getEpCnt().IncEndpointCnt(); e != nil { + log.Warnf("failed to update network %s : %v", n.name, e) + } + } + }() + + // unwatch for service records + n.getController().unWatchSvcRecord(ep) + + if err = ep.deleteEndpoint(); err != nil { + return err + } + + ep.releaseAddress() + + return nil +} + +func (ep *endpoint) deleteEndpoint() error { + ep.Lock() + n := ep.network + name := ep.name + epid := ep.id + ep.Unlock() + + driver, err := n.driver() + if err != nil { + return fmt.Errorf("failed to delete endpoint: %v", err) + } + + if err := driver.DeleteEndpoint(n.id, epid); err != nil { + if _, ok := err.(types.ForbiddenError); ok { + return err + } + + if _, ok := err.(types.MaskableError); !ok { + log.Warnf("driver error deleting endpoint %s : %v", name, err) + } + } + + return nil +} + +func (ep *endpoint) getSandbox() (*sandbox, bool) { + ep.Lock() + c := ep.network.getController() + sid := ep.sandboxID + ep.Unlock() + + c.Lock() + ps, ok := c.sandboxes[sid] + c.Unlock() + + return ps, ok +} + +func (ep *endpoint) getFirstInterfaceAddress() net.IP { + ep.Lock() + defer ep.Unlock() + + if ep.iface.addr != nil { + return ep.iface.addr.IP + } + + return nil +} + +// EndpointOptionGeneric function returns an option setter for a Generic option defined +// in a Dictionary of Key-Value pair +func EndpointOptionGeneric(generic map[string]interface{}) EndpointOption { + return func(ep *endpoint) { + for k, v := range generic { + ep.generic[k] = v + } + } +} + +// CreateOptionExposedPorts function returns an option setter for the container exposed +// ports option to be passed to network.CreateEndpoint() method. +func CreateOptionExposedPorts(exposedPorts []types.TransportPort) EndpointOption { + return func(ep *endpoint) { + // Defensive copy + eps := make([]types.TransportPort, len(exposedPorts)) + copy(eps, exposedPorts) + // Store endpoint label and in generic because driver needs it + ep.exposedPorts = eps + ep.generic[netlabel.ExposedPorts] = eps + } +} + +// CreateOptionPortMapping function returns an option setter for the mapping +// ports option to be passed to network.CreateEndpoint() method. +func CreateOptionPortMapping(portBindings []types.PortBinding) EndpointOption { + return func(ep *endpoint) { + // Store a copy of the bindings as generic data to pass to the driver + pbs := make([]types.PortBinding, len(portBindings)) + copy(pbs, portBindings) + ep.generic[netlabel.PortMap] = pbs + } +} + +// CreateOptionAnonymous function returns an option setter for setting +// this endpoint as anonymous +func CreateOptionAnonymous() EndpointOption { + return func(ep *endpoint) { + ep.anonymous = true + } +} + +// JoinOptionPriority function returns an option setter for priority option to +// be passed to the endpoint.Join() method. +func JoinOptionPriority(ep Endpoint, prio int) EndpointOption { + return func(ep *endpoint) { + // ep lock already acquired + c := ep.network.getController() + c.Lock() + sb, ok := c.sandboxes[ep.sandboxID] + c.Unlock() + if !ok { + log.Errorf("Could not set endpoint priority value during Join to endpoint %s: No sandbox id present in endpoint", ep.id) + return + } + sb.epPriority[ep.id] = prio + } +} + +func (ep *endpoint) DataScope() string { + return ep.getNetwork().DataScope() +} + +func (ep *endpoint) assignAddress(assignIPv4, assignIPv6 bool) error { + var ( + ipam ipamapi.Ipam + err error + ) + + n := ep.getNetwork() + if n.Type() == "host" || n.Type() == "null" { + return nil + } + + log.Debugf("Assigning addresses for endpoint %s's interface on network %s", ep.Name(), n.Name()) + + ipam, err = n.getController().getIpamDriver(n.ipamType) + if err != nil { + return err + } + + if assignIPv4 { + if err = ep.assignAddressVersion(4, ipam); err != nil { + return err + } + } + + if assignIPv6 { + err = ep.assignAddressVersion(6, ipam) + } + + return err +} + +func (ep *endpoint) assignAddressVersion(ipVer int, ipam ipamapi.Ipam) error { + var ( + poolID *string + address **net.IPNet + ) + + n := ep.getNetwork() + switch ipVer { + case 4: + poolID = &ep.iface.v4PoolID + address = &ep.iface.addr + case 6: + poolID = &ep.iface.v6PoolID + address = &ep.iface.addrv6 + default: + return types.InternalErrorf("incorrect ip version number passed: %d", ipVer) + } + + ipInfo := n.getIPInfo(ipVer) + + // ipv6 address is not mandatory + if len(ipInfo) == 0 && ipVer == 6 { + return nil + } + + for _, d := range ipInfo { + var prefIP net.IP + if *address != nil { + prefIP = (*address).IP + } + addr, _, err := ipam.RequestAddress(d.PoolID, prefIP, nil) + if err == nil { + ep.Lock() + *address = addr + *poolID = d.PoolID + ep.Unlock() + return nil + } + if err != ipamapi.ErrNoAvailableIPs { + return err + } + } + return fmt.Errorf("no available IPv%d addresses on this network's address pools: %s (%s)", ipVer, n.Name(), n.ID()) +} + +func (ep *endpoint) releaseAddress() { + n := ep.getNetwork() + if n.Type() == "host" || n.Type() == "null" { + return + } + + log.Debugf("Releasing addresses for endpoint %s's interface on network %s", ep.Name(), n.Name()) + + ipam, err := n.getController().getIpamDriver(n.ipamType) + if err != nil { + log.Warnf("Failed to retrieve ipam driver to release interface address on delete of endpoint %s (%s): %v", ep.Name(), ep.ID(), err) + return + } + if err := ipam.ReleaseAddress(ep.iface.v4PoolID, ep.iface.addr.IP); err != nil { + log.Warnf("Failed to release ip address %s on delete of endpoint %s (%s): %v", ep.iface.addr.IP, ep.Name(), ep.ID(), err) + } + if ep.iface.addrv6 != nil && ep.iface.addrv6.IP.IsGlobalUnicast() { + if err := ipam.ReleaseAddress(ep.iface.v6PoolID, ep.iface.addrv6.IP); err != nil { + log.Warnf("Failed to release ip address %s on delete of endpoint %s (%s): %v", ep.iface.addrv6.IP, ep.Name(), ep.ID(), err) + } + } +} + +func (c *controller) cleanupLocalEndpoints() { + nl, err := c.getNetworksForScope(datastore.LocalScope) + if err != nil { + log.Warnf("Could not get list of networks during endpoint cleanup: %v", err) + return + } + + for _, n := range nl { + epl, err := n.getEndpointsFromStore() + if err != nil { + log.Warnf("Could not get list of endpoints in network %s during endpoint cleanup: %v", n.name, err) + continue + } + + for _, ep := range epl { + if err := ep.Delete(); err != nil { + log.Warnf("Could not delete local endpoint %s during endpoint cleanup: %v", ep.name, err) + } + } + } +} diff --git a/vendor/src/github.com/docker/libnetwork/endpoint_cnt.go b/vendor/src/github.com/docker/libnetwork/endpoint_cnt.go new file mode 100644 index 0000000000..507de393b8 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/endpoint_cnt.go @@ -0,0 +1,162 @@ +package libnetwork + +import ( + "encoding/json" + "fmt" + "sync" + + "github.com/docker/libnetwork/datastore" +) + +type endpointCnt struct { + n *network + Count uint64 + dbIndex uint64 + dbExists bool + sync.Mutex +} + +const epCntKeyPrefix = "endpoint_count" + +func (ec *endpointCnt) Key() []string { + ec.Lock() + defer ec.Unlock() + + return []string{epCntKeyPrefix, ec.n.id} +} + +func (ec *endpointCnt) KeyPrefix() []string { + ec.Lock() + defer ec.Unlock() + + return []string{epCntKeyPrefix, ec.n.id} +} + +func (ec *endpointCnt) Value() []byte { + ec.Lock() + defer ec.Unlock() + + b, err := json.Marshal(ec) + if err != nil { + return nil + } + return b +} + +func (ec *endpointCnt) SetValue(value []byte) error { + ec.Lock() + defer ec.Unlock() + + return json.Unmarshal(value, &ec) +} + +func (ec *endpointCnt) Index() uint64 { + ec.Lock() + defer ec.Unlock() + return ec.dbIndex +} + +func (ec *endpointCnt) SetIndex(index uint64) { + ec.Lock() + ec.dbIndex = index + ec.dbExists = true + ec.Unlock() +} + +func (ec *endpointCnt) Exists() bool { + ec.Lock() + defer ec.Unlock() + return ec.dbExists +} + +func (ec *endpointCnt) Skip() bool { + ec.Lock() + defer ec.Unlock() + return !ec.n.persist +} + +func (ec *endpointCnt) New() datastore.KVObject { + ec.Lock() + defer ec.Unlock() + + return &endpointCnt{ + n: ec.n, + } +} + +func (ec *endpointCnt) CopyTo(o datastore.KVObject) error { + ec.Lock() + defer ec.Unlock() + + dstEc := o.(*endpointCnt) + dstEc.n = ec.n + dstEc.Count = ec.Count + dstEc.dbExists = ec.dbExists + dstEc.dbIndex = ec.dbIndex + + return nil +} + +func (ec *endpointCnt) DataScope() string { + return ec.n.DataScope() +} + +func (ec *endpointCnt) EndpointCnt() uint64 { + ec.Lock() + defer ec.Unlock() + + return ec.Count +} + +func (ec *endpointCnt) updateStore() error { + store := ec.n.getController().getStore(ec.DataScope()) + if store == nil { + return fmt.Errorf("store not found for scope %s on endpoint count update", ec.DataScope()) + } + for { + if err := ec.n.getController().updateToStore(ec); err == nil || err != datastore.ErrKeyModified { + return err + } + if err := store.GetObject(datastore.Key(ec.Key()...), ec); err != nil { + return fmt.Errorf("could not update the kvobject to latest on endpoint count update: %v", err) + } + } +} + +func (ec *endpointCnt) atomicIncDecEpCnt(inc bool) error { +retry: + ec.Lock() + if inc { + ec.Count++ + } else { + ec.Count-- + } + ec.Unlock() + + store := ec.n.getController().getStore(ec.DataScope()) + if store == nil { + return fmt.Errorf("store not found for scope %s", ec.DataScope()) + } + + if err := ec.n.getController().updateToStore(ec); err != nil { + if err == datastore.ErrKeyModified { + if err := store.GetObject(datastore.Key(ec.Key()...), ec); err != nil { + return fmt.Errorf("could not update the kvobject to latest when trying to atomic add endpoint count: %v", err) + } + + goto retry + } + + return err + } + + return nil +} + +func (ec *endpointCnt) IncEndpointCnt() error { + return ec.atomicIncDecEpCnt(true) +} + +func (ec *endpointCnt) DecEndpointCnt() error { + return ec.atomicIncDecEpCnt(false) +} diff --git a/vendor/src/github.com/docker/libnetwork/endpoint_info.go b/vendor/src/github.com/docker/libnetwork/endpoint_info.go new file mode 100644 index 0000000000..1028308557 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/endpoint_info.go @@ -0,0 +1,342 @@ +package libnetwork + +import ( + "encoding/json" + "fmt" + "net" + + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/types" +) + +// EndpointInfo provides an interface to retrieve network resources bound to the endpoint. +type EndpointInfo interface { + // Iface returns InterfaceInfo, go interface that can be used + // to get more information on the interface which was assigned to + // the endpoint by the driver. This can be used after the + // endpoint has been created. + Iface() InterfaceInfo + + // Gateway returns the IPv4 gateway assigned by the driver. + // This will only return a valid value if a container has joined the endpoint. + Gateway() net.IP + + // GatewayIPv6 returns the IPv6 gateway assigned by the driver. + // This will only return a valid value if a container has joined the endpoint. + GatewayIPv6() net.IP + + // Sandbox returns the attached sandbox if there, nil otherwise. + Sandbox() Sandbox +} + +// InterfaceInfo provides an interface to retrieve interface addresses bound to the endpoint. +type InterfaceInfo interface { + // MacAddress returns the MAC address assigned to the endpoint. + MacAddress() net.HardwareAddr + + // Address returns the IPv4 address assigned to the endpoint. + Address() *net.IPNet + + // AddressIPv6 returns the IPv6 address assigned to the endpoint. + AddressIPv6() *net.IPNet +} + +type endpointInterface struct { + mac net.HardwareAddr + addr *net.IPNet + addrv6 *net.IPNet + srcName string + dstPrefix string + routes []*net.IPNet + v4PoolID string + v6PoolID string +} + +func (epi *endpointInterface) MarshalJSON() ([]byte, error) { + epMap := make(map[string]interface{}) + if epi.mac != nil { + epMap["mac"] = epi.mac.String() + } + if epi.addr != nil { + epMap["addr"] = epi.addr.String() + } + if epi.addrv6 != nil { + epMap["addrv6"] = epi.addrv6.String() + } + epMap["srcName"] = epi.srcName + epMap["dstPrefix"] = epi.dstPrefix + var routes []string + for _, route := range epi.routes { + routes = append(routes, route.String()) + } + epMap["routes"] = routes + epMap["v4PoolID"] = epi.v4PoolID + epMap["v6PoolID"] = epi.v6PoolID + return json.Marshal(epMap) +} + +func (epi *endpointInterface) UnmarshalJSON(b []byte) error { + var ( + err error + epMap map[string]interface{} + ) + if err = json.Unmarshal(b, &epMap); err != nil { + return err + } + if v, ok := epMap["mac"]; ok { + if epi.mac, err = net.ParseMAC(v.(string)); err != nil { + return types.InternalErrorf("failed to decode endpoint interface mac address after json unmarshal: %s", v.(string)) + } + } + if v, ok := epMap["addr"]; ok { + if epi.addr, err = types.ParseCIDR(v.(string)); err != nil { + return types.InternalErrorf("failed to decode endpoint interface ipv4 address after json unmarshal: %v", err) + } + } + if v, ok := epMap["addrv6"]; ok { + if epi.addrv6, err = types.ParseCIDR(v.(string)); err != nil { + return types.InternalErrorf("failed to decode endpoint interface ipv6 address after json unmarshal: %v", err) + } + } + + epi.srcName = epMap["srcName"].(string) + epi.dstPrefix = epMap["dstPrefix"].(string) + + rb, _ := json.Marshal(epMap["routes"]) + var routes []string + json.Unmarshal(rb, &routes) + epi.routes = make([]*net.IPNet, 0) + for _, route := range routes { + ip, ipr, err := net.ParseCIDR(route) + if err == nil { + ipr.IP = ip + epi.routes = append(epi.routes, ipr) + } + } + epi.v4PoolID = epMap["v4PoolID"].(string) + epi.v6PoolID = epMap["v6PoolID"].(string) + + return nil +} + +func (epi *endpointInterface) CopyTo(dstEpi *endpointInterface) error { + dstEpi.mac = types.GetMacCopy(epi.mac) + dstEpi.addr = types.GetIPNetCopy(epi.addr) + dstEpi.addrv6 = types.GetIPNetCopy(epi.addrv6) + dstEpi.srcName = epi.srcName + dstEpi.dstPrefix = epi.dstPrefix + dstEpi.v4PoolID = epi.v4PoolID + dstEpi.v6PoolID = epi.v6PoolID + + for _, route := range epi.routes { + dstEpi.routes = append(dstEpi.routes, types.GetIPNetCopy(route)) + } + + return nil +} + +type endpointJoinInfo struct { + gw net.IP + gw6 net.IP + StaticRoutes []*types.StaticRoute +} + +func (ep *endpoint) Info() EndpointInfo { + n, err := ep.getNetworkFromStore() + if err != nil { + return nil + } + + ep, err = n.getEndpointFromStore(ep.ID()) + if err != nil { + return nil + } + + sb, ok := ep.getSandbox() + if !ok { + // endpoint hasn't joined any sandbox. + // Just return the endpoint + return ep + } + + if epi := sb.getEndpoint(ep.ID()); epi != nil { + return epi + } + + return nil +} + +func (ep *endpoint) DriverInfo() (map[string]interface{}, error) { + ep, err := ep.retrieveFromStore() + if err != nil { + return nil, err + } + + if sb, ok := ep.getSandbox(); ok { + if gwep := sb.getEndpointInGWNetwork(); gwep != nil && gwep.ID() != ep.ID() { + return gwep.DriverInfo() + } + } + + n, err := ep.getNetworkFromStore() + if err != nil { + return nil, fmt.Errorf("could not find network in store for driver info: %v", err) + } + + driver, err := n.driver() + if err != nil { + return nil, fmt.Errorf("failed to get driver info: %v", err) + } + + return driver.EndpointOperInfo(n.ID(), ep.ID()) +} + +func (ep *endpoint) Iface() InterfaceInfo { + ep.Lock() + defer ep.Unlock() + + if ep.iface != nil { + return ep.iface + } + + return nil +} + +func (ep *endpoint) Interface() driverapi.InterfaceInfo { + ep.Lock() + defer ep.Unlock() + + if ep.iface != nil { + return ep.iface + } + + return nil +} + +func (epi *endpointInterface) SetMacAddress(mac net.HardwareAddr) error { + if epi.mac != nil { + return types.ForbiddenErrorf("endpoint interface MAC address present (%s). Cannot be modified with %s.", epi.mac, mac) + } + if mac == nil { + return types.BadRequestErrorf("tried to set nil MAC address to endpoint interface") + } + epi.mac = types.GetMacCopy(mac) + return nil +} + +func (epi *endpointInterface) SetIPAddress(address *net.IPNet) error { + if address.IP == nil { + return types.BadRequestErrorf("tried to set nil IP address to endpoint interface") + } + if address.IP.To4() == nil { + return setAddress(&epi.addrv6, address) + } + return setAddress(&epi.addr, address) +} + +func setAddress(ifaceAddr **net.IPNet, address *net.IPNet) error { + if *ifaceAddr != nil { + return types.ForbiddenErrorf("endpoint interface IP present (%s). Cannot be modified with (%s).", *ifaceAddr, address) + } + *ifaceAddr = types.GetIPNetCopy(address) + return nil +} + +func (epi *endpointInterface) MacAddress() net.HardwareAddr { + return types.GetMacCopy(epi.mac) +} + +func (epi *endpointInterface) Address() *net.IPNet { + return types.GetIPNetCopy(epi.addr) +} + +func (epi *endpointInterface) AddressIPv6() *net.IPNet { + return types.GetIPNetCopy(epi.addrv6) +} + +func (epi *endpointInterface) SetNames(srcName string, dstPrefix string) error { + epi.srcName = srcName + epi.dstPrefix = dstPrefix + return nil +} + +func (ep *endpoint) InterfaceName() driverapi.InterfaceNameInfo { + ep.Lock() + defer ep.Unlock() + + if ep.iface != nil { + return ep.iface + } + + return nil +} + +func (ep *endpoint) AddStaticRoute(destination *net.IPNet, routeType int, nextHop net.IP) error { + ep.Lock() + defer ep.Unlock() + + r := types.StaticRoute{Destination: destination, RouteType: routeType, NextHop: nextHop} + + if routeType == types.NEXTHOP { + // If the route specifies a next-hop, then it's loosely routed (i.e. not bound to a particular interface). + ep.joinInfo.StaticRoutes = append(ep.joinInfo.StaticRoutes, &r) + } else { + // If the route doesn't specify a next-hop, it must be a connected route, bound to an interface. + ep.iface.routes = append(ep.iface.routes, r.Destination) + } + return nil +} + +func (ep *endpoint) Sandbox() Sandbox { + cnt, ok := ep.getSandbox() + if !ok { + return nil + } + return cnt +} + +func (ep *endpoint) Gateway() net.IP { + ep.Lock() + defer ep.Unlock() + + if ep.joinInfo == nil { + return net.IP{} + } + + return types.GetIPCopy(ep.joinInfo.gw) +} + +func (ep *endpoint) GatewayIPv6() net.IP { + ep.Lock() + defer ep.Unlock() + + if ep.joinInfo == nil { + return net.IP{} + } + + return types.GetIPCopy(ep.joinInfo.gw6) +} + +func (ep *endpoint) SetGateway(gw net.IP) error { + ep.Lock() + defer ep.Unlock() + + ep.joinInfo.gw = types.GetIPCopy(gw) + return nil +} + +func (ep *endpoint) SetGatewayIPv6(gw6 net.IP) error { + ep.Lock() + defer ep.Unlock() + + ep.joinInfo.gw6 = types.GetIPCopy(gw6) + return nil +} + +func (ep *endpoint) retrieveFromStore() (*endpoint, error) { + n, err := ep.getNetworkFromStore() + if err != nil { + return nil, fmt.Errorf("could not find network in store to get latest endpoint %s: %v", ep.Name(), err) + } + return n.getEndpointFromStore(ep.ID()) +} diff --git a/vendor/src/github.com/docker/libnetwork/error.go b/vendor/src/github.com/docker/libnetwork/error.go new file mode 100644 index 0000000000..4158c9956c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/error.go @@ -0,0 +1,175 @@ +package libnetwork + +import ( + "fmt" +) + +// ErrNoSuchNetwork is returned when a network query finds no result +type ErrNoSuchNetwork string + +func (nsn ErrNoSuchNetwork) Error() string { + return fmt.Sprintf("network %s not found", string(nsn)) +} + +// NotFound denotes the type of this error +func (nsn ErrNoSuchNetwork) NotFound() {} + +// ErrNoSuchEndpoint is returned when a endpoint query finds no result +type ErrNoSuchEndpoint string + +func (nse ErrNoSuchEndpoint) Error() string { + return fmt.Sprintf("endpoint %s not found", string(nse)) +} + +// NotFound denotes the type of this error +func (nse ErrNoSuchEndpoint) NotFound() {} + +// ErrInvalidNetworkDriver is returned if an invalid driver +// name is passed. +type ErrInvalidNetworkDriver string + +func (ind ErrInvalidNetworkDriver) Error() string { + return fmt.Sprintf("invalid driver bound to network: %s", string(ind)) +} + +// BadRequest denotes the type of this error +func (ind ErrInvalidNetworkDriver) BadRequest() {} + +// ErrInvalidJoin is returned if a join is attempted on an endpoint +// which already has a container joined. +type ErrInvalidJoin struct{} + +func (ij ErrInvalidJoin) Error() string { + return "a container has already joined the endpoint" +} + +// BadRequest denotes the type of this error +func (ij ErrInvalidJoin) BadRequest() {} + +// ErrNoContainer is returned when the endpoint has no container +// attached to it. +type ErrNoContainer struct{} + +func (nc ErrNoContainer) Error() string { + return "no container is attached to the endpoint" +} + +// Maskable denotes the type of this error +func (nc ErrNoContainer) Maskable() {} + +// ErrInvalidID is returned when a query-by-id method is being invoked +// with an empty id parameter +type ErrInvalidID string + +func (ii ErrInvalidID) Error() string { + return fmt.Sprintf("invalid id: %s", string(ii)) +} + +// BadRequest denotes the type of this error +func (ii ErrInvalidID) BadRequest() {} + +// ErrInvalidName is returned when a query-by-name or resource create method is +// invoked with an empty name parameter +type ErrInvalidName string + +func (in ErrInvalidName) Error() string { + return fmt.Sprintf("invalid name: %s", string(in)) +} + +// BadRequest denotes the type of this error +func (in ErrInvalidName) BadRequest() {} + +// ErrInvalidConfigFile type is returned when an invalid LibNetwork config file is detected +type ErrInvalidConfigFile string + +func (cf ErrInvalidConfigFile) Error() string { + return fmt.Sprintf("Invalid Config file %q", string(cf)) +} + +// NetworkTypeError type is returned when the network type string is not +// known to libnetwork. +type NetworkTypeError string + +func (nt NetworkTypeError) Error() string { + return fmt.Sprintf("unknown driver %q", string(nt)) +} + +// NotFound denotes the type of this error +func (nt NetworkTypeError) NotFound() {} + +// NetworkNameError is returned when a network with the same name already exists. +type NetworkNameError string + +func (nnr NetworkNameError) Error() string { + return fmt.Sprintf("network with name %s already exists", string(nnr)) +} + +// Forbidden denotes the type of this error +func (nnr NetworkNameError) Forbidden() {} + +// UnknownNetworkError is returned when libnetwork could not find in it's database +// a network with the same name and id. +type UnknownNetworkError struct { + name string + id string +} + +func (une *UnknownNetworkError) Error() string { + return fmt.Sprintf("unknown network %s id %s", une.name, une.id) +} + +// NotFound denotes the type of this error +func (une *UnknownNetworkError) NotFound() {} + +// ActiveEndpointsError is returned when a network is deleted which has active +// endpoints in it. +type ActiveEndpointsError struct { + name string + id string +} + +func (aee *ActiveEndpointsError) Error() string { + return fmt.Sprintf("network %s has active endpoints", aee.name) +} + +// Forbidden denotes the type of this error +func (aee *ActiveEndpointsError) Forbidden() {} + +// UnknownEndpointError is returned when libnetwork could not find in it's database +// an endpoint with the same name and id. +type UnknownEndpointError struct { + name string + id string +} + +func (uee *UnknownEndpointError) Error() string { + return fmt.Sprintf("unknown endpoint %s id %s", uee.name, uee.id) +} + +// NotFound denotes the type of this error +func (uee *UnknownEndpointError) NotFound() {} + +// ActiveContainerError is returned when an endpoint is deleted which has active +// containers attached to it. +type ActiveContainerError struct { + name string + id string +} + +func (ace *ActiveContainerError) Error() string { + return fmt.Sprintf("endpoint with name %s id %s has active containers", ace.name, ace.id) +} + +// Forbidden denotes the type of this error +func (ace *ActiveContainerError) Forbidden() {} + +// InvalidContainerIDError is returned when an invalid container id is passed +// in Join/Leave +type InvalidContainerIDError string + +func (id InvalidContainerIDError) Error() string { + return fmt.Sprintf("invalid container id %s", string(id)) +} + +// BadRequest denotes the type of this error +func (id InvalidContainerIDError) BadRequest() {} diff --git a/vendor/src/github.com/docker/libnetwork/etchosts/etchosts.go b/vendor/src/github.com/docker/libnetwork/etchosts/etchosts.go new file mode 100644 index 0000000000..92597b71b4 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/etchosts/etchosts.go @@ -0,0 +1,169 @@ +package etchosts + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "os" + "regexp" + "sync" +) + +// Record Structure for a single host record +type Record struct { + Hosts string + IP string +} + +// WriteTo writes record to file and returns bytes written or error +func (r Record) WriteTo(w io.Writer) (int64, error) { + n, err := fmt.Fprintf(w, "%s\t%s\n", r.IP, r.Hosts) + return int64(n), err +} + +var ( + // Default hosts config records slice + defaultContent = []Record{ + {Hosts: "localhost", IP: "127.0.0.1"}, + {Hosts: "localhost ip6-localhost ip6-loopback", IP: "::1"}, + {Hosts: "ip6-localnet", IP: "fe00::0"}, + {Hosts: "ip6-mcastprefix", IP: "ff00::0"}, + {Hosts: "ip6-allnodes", IP: "ff02::1"}, + {Hosts: "ip6-allrouters", IP: "ff02::2"}, + } + + // A cache of path level locks for synchronizing /etc/hosts + // updates on a file level + pathMap = make(map[string]*sync.Mutex) + + // A package level mutex to synchronize the cache itself + pathMutex sync.Mutex +) + +func pathLock(path string) func() { + pathMutex.Lock() + defer pathMutex.Unlock() + + pl, ok := pathMap[path] + if !ok { + pl = &sync.Mutex{} + pathMap[path] = pl + } + + pl.Lock() + return func() { + pl.Unlock() + } +} + +// Drop drops the path string from the path cache +func Drop(path string) { + pathMutex.Lock() + defer pathMutex.Unlock() + + delete(pathMap, path) +} + +// Build function +// path is path to host file string required +// IP, hostname, and domainname set main record leave empty for no master record +// extraContent is an array of extra host records. +func Build(path, IP, hostname, domainname string, extraContent []Record) error { + defer pathLock(path)() + + content := bytes.NewBuffer(nil) + if IP != "" { + //set main record + var mainRec Record + mainRec.IP = IP + if domainname != "" { + mainRec.Hosts = fmt.Sprintf("%s.%s %s", hostname, domainname, hostname) + } else { + mainRec.Hosts = hostname + } + if _, err := mainRec.WriteTo(content); err != nil { + return err + } + } + // Write defaultContent slice to buffer + for _, r := range defaultContent { + if _, err := r.WriteTo(content); err != nil { + return err + } + } + // Write extra content from function arguments + for _, r := range extraContent { + if _, err := r.WriteTo(content); err != nil { + return err + } + } + + return ioutil.WriteFile(path, content.Bytes(), 0644) +} + +// Add adds an arbitrary number of Records to an already existing /etc/hosts file +func Add(path string, recs []Record) error { + defer pathLock(path)() + + if len(recs) == 0 { + return nil + } + + f, err := os.Open(path) + if err != nil { + return err + } + + content := bytes.NewBuffer(nil) + + _, err = content.ReadFrom(f) + if err != nil { + return err + } + + for _, r := range recs { + if _, err := r.WriteTo(content); err != nil { + return err + } + } + + return ioutil.WriteFile(path, content.Bytes(), 0644) +} + +// Delete deletes an arbitrary number of Records already existing in /etc/hosts file +func Delete(path string, recs []Record) error { + defer pathLock(path)() + + if len(recs) == 0 { + return nil + } + + old, err := ioutil.ReadFile(path) + if err != nil { + return err + } + + regexpStr := fmt.Sprintf("\\S*\\t%s\\n", regexp.QuoteMeta(recs[0].Hosts)) + for _, r := range recs[1:] { + regexpStr = regexpStr + "|" + fmt.Sprintf("\\S*\\t%s\\n", regexp.QuoteMeta(r.Hosts)) + } + + var re = regexp.MustCompile(regexpStr) + return ioutil.WriteFile(path, re.ReplaceAll(old, []byte("")), 0644) +} + +// Update all IP addresses where hostname matches. +// path is path to host file +// IP is new IP address +// hostname is hostname to search for to replace IP +func Update(path, IP, hostname string) error { + defer pathLock(path)() + + old, err := ioutil.ReadFile(path) + if err != nil { + return err + } + var re = regexp.MustCompile(fmt.Sprintf("(\\S*)(\\t%s)", regexp.QuoteMeta(hostname))) + return ioutil.WriteFile(path, re.ReplaceAll(old, []byte(IP+"$2")), 0644) +} diff --git a/vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery.go b/vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery.go new file mode 100644 index 0000000000..3fe2a64a17 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery.go @@ -0,0 +1,121 @@ +package hostdiscovery + +import ( + "net" + "sync" + + log "github.com/Sirupsen/logrus" + + mapset "github.com/deckarep/golang-set" + "github.com/docker/docker/pkg/discovery" + // Including KV + _ "github.com/docker/docker/pkg/discovery/kv" + "github.com/docker/libkv/store/consul" + "github.com/docker/libkv/store/etcd" + "github.com/docker/libkv/store/zookeeper" + "github.com/docker/libnetwork/types" +) + +type hostDiscovery struct { + watcher discovery.Watcher + nodes mapset.Set + stopChan chan struct{} + sync.Mutex +} + +func init() { + consul.Register() + etcd.Register() + zookeeper.Register() +} + +// NewHostDiscovery function creates a host discovery object +func NewHostDiscovery(watcher discovery.Watcher) HostDiscovery { + return &hostDiscovery{watcher: watcher, nodes: mapset.NewSet(), stopChan: make(chan struct{})} +} + +func (h *hostDiscovery) Watch(activeCallback ActiveCallback, joinCallback JoinCallback, leaveCallback LeaveCallback) error { + h.Lock() + d := h.watcher + h.Unlock() + if d == nil { + return types.BadRequestErrorf("invalid discovery watcher") + } + discoveryCh, errCh := d.Watch(h.stopChan) + go h.monitorDiscovery(discoveryCh, errCh, activeCallback, joinCallback, leaveCallback) + return nil +} + +func (h *hostDiscovery) monitorDiscovery(ch <-chan discovery.Entries, errCh <-chan error, + activeCallback ActiveCallback, joinCallback JoinCallback, leaveCallback LeaveCallback) { + for { + select { + case entries := <-ch: + h.processCallback(entries, activeCallback, joinCallback, leaveCallback) + case err := <-errCh: + if err != nil { + log.Errorf("discovery error: %v", err) + } + case <-h.stopChan: + return + } + } +} + +func (h *hostDiscovery) StopDiscovery() error { + h.Lock() + stopChan := h.stopChan + h.watcher = nil + h.Unlock() + + close(stopChan) + return nil +} + +func (h *hostDiscovery) processCallback(entries discovery.Entries, + activeCallback ActiveCallback, joinCallback JoinCallback, leaveCallback LeaveCallback) { + updated := hosts(entries) + h.Lock() + existing := h.nodes + added, removed := diff(existing, updated) + h.nodes = updated + h.Unlock() + + activeCallback() + if len(added) > 0 { + joinCallback(added) + } + if len(removed) > 0 { + leaveCallback(removed) + } +} + +func diff(existing mapset.Set, updated mapset.Set) (added []net.IP, removed []net.IP) { + addSlice := updated.Difference(existing).ToSlice() + removeSlice := existing.Difference(updated).ToSlice() + for _, ip := range addSlice { + added = append(added, net.ParseIP(ip.(string))) + } + for _, ip := range removeSlice { + removed = append(removed, net.ParseIP(ip.(string))) + } + return +} + +func (h *hostDiscovery) Fetch() []net.IP { + h.Lock() + defer h.Unlock() + ips := []net.IP{} + for _, ipstr := range h.nodes.ToSlice() { + ips = append(ips, net.ParseIP(ipstr.(string))) + } + return ips +} + +func hosts(entries discovery.Entries) mapset.Set { + hosts := mapset.NewSet() + for _, entry := range entries { + hosts.Add(entry.Host) + } + return hosts +} diff --git a/vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery_api.go b/vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery_api.go new file mode 100644 index 0000000000..b9c17250ce --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/hostdiscovery/hostdiscovery_api.go @@ -0,0 +1,22 @@ +package hostdiscovery + +import "net" + +// JoinCallback provides a callback event for new node joining the cluster +type JoinCallback func(entries []net.IP) + +// ActiveCallback provides a callback event for active discovery event +type ActiveCallback func() + +// LeaveCallback provides a callback event for node leaving the cluster +type LeaveCallback func(entries []net.IP) + +// HostDiscovery primary interface +type HostDiscovery interface { + //Watch Node join and leave cluster events + Watch(activeCallback ActiveCallback, joinCallback JoinCallback, leaveCallback LeaveCallback) error + // StopDiscovery stops the discovery perocess + StopDiscovery() error + // Fetch returns a list of host IPs that are currently discovered + Fetch() []net.IP +} diff --git a/vendor/src/github.com/docker/libnetwork/hostdiscovery/libnetwork.toml b/vendor/src/github.com/docker/libnetwork/hostdiscovery/libnetwork.toml new file mode 100644 index 0000000000..7839d1e3a8 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/hostdiscovery/libnetwork.toml @@ -0,0 +1,6 @@ +title = "LibNetwork Configuration file" + +[cluster] + discovery = "consul://localhost:8500" + Address = "6.5.5.5" + Heartbeat = 3 diff --git a/vendor/src/github.com/docker/libnetwork/idm/idm.go b/vendor/src/github.com/docker/libnetwork/idm/idm.go new file mode 100644 index 0000000000..37ae79e558 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/idm/idm.go @@ -0,0 +1,60 @@ +// Package idm manages reservation/release of numerical ids from a configured set of contiguous ids +package idm + +import ( + "fmt" + + "github.com/docker/libnetwork/bitseq" + "github.com/docker/libnetwork/datastore" +) + +// Idm manages the reservation/release of numerical ids from a contiguos set +type Idm struct { + start uint64 + end uint64 + handle *bitseq.Handle +} + +// New returns an instance of id manager for a set of [start-end] numerical ids +func New(ds datastore.DataStore, id string, start, end uint64) (*Idm, error) { + if id == "" { + return nil, fmt.Errorf("Invalid id") + } + if end <= start { + return nil, fmt.Errorf("Invalid set range: [%d, %d]", start, end) + } + + h, err := bitseq.NewHandle("idm", ds, id, 1+end-start) + if err != nil { + return nil, fmt.Errorf("failed to initialize bit sequence handler: %s", err.Error()) + } + + return &Idm{start: start, end: end, handle: h}, nil +} + +// GetID returns the first available id in the set +func (i *Idm) GetID() (uint64, error) { + if i.handle == nil { + return 0, fmt.Errorf("ID set is not initialized") + } + ordinal, err := i.handle.SetAny() + return i.start + ordinal, err +} + +// GetSpecificID tries to reserve the specified id +func (i *Idm) GetSpecificID(id uint64) error { + if i.handle == nil { + return fmt.Errorf("ID set is not initialized") + } + + if id < i.start || id > i.end { + return fmt.Errorf("Requested id does not belong to the set") + } + + return i.handle.Set(id - i.start) +} + +// Release releases the specified id +func (i *Idm) Release(id uint64) { + i.handle.Unset(id - i.start) +} diff --git a/vendor/src/github.com/docker/libnetwork/ipam/allocator.go b/vendor/src/github.com/docker/libnetwork/ipam/allocator.go new file mode 100644 index 0000000000..7481fa2f69 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipam/allocator.go @@ -0,0 +1,502 @@ +package ipam + +import ( + "fmt" + "net" + "sync" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/bitseq" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/ipamutils" + "github.com/docker/libnetwork/types" +) + +const ( + localAddressSpace = "LocalDefault" + globalAddressSpace = "GlobalDefault" + // The biggest configurable host subnets + minNetSize = 8 + minNetSizeV6 = 64 + // datastore keyes for ipam objects + dsConfigKey = "ipam/" + ipamapi.DefaultIPAM + "/config" + dsDataKey = "ipam/" + ipamapi.DefaultIPAM + "/data" +) + +// Allocator provides per address space ipv4/ipv6 book keeping +type Allocator struct { + // Predefined pools for default address spaces + predefined map[string][]*net.IPNet + addrSpaces map[string]*addrSpace + // stores []datastore.Datastore + // Allocated addresses in each address space's subnet + addresses map[SubnetKey]*bitseq.Handle + sync.Mutex +} + +// NewAllocator returns an instance of libnetwork ipam +func NewAllocator(lcDs, glDs datastore.DataStore) (*Allocator, error) { + a := &Allocator{} + + // Load predefined subnet pools + a.predefined = map[string][]*net.IPNet{ + localAddressSpace: ipamutils.PredefinedBroadNetworks, + globalAddressSpace: ipamutils.PredefinedGranularNetworks, + } + + // Initialize bitseq map + a.addresses = make(map[SubnetKey]*bitseq.Handle) + + // Initialize address spaces + a.addrSpaces = make(map[string]*addrSpace) + for _, aspc := range []struct { + as string + ds datastore.DataStore + }{ + {localAddressSpace, lcDs}, + {globalAddressSpace, glDs}, + } { + if aspc.ds == nil { + continue + } + + a.addrSpaces[aspc.as] = &addrSpace{ + subnets: map[SubnetKey]*PoolData{}, + id: dsConfigKey + "/" + aspc.as, + scope: aspc.ds.Scope(), + ds: aspc.ds, + alloc: a, + } + } + + return a, nil +} + +func (a *Allocator) refresh(as string) error { + aSpace, err := a.getAddressSpaceFromStore(as) + if err != nil { + return fmt.Errorf("error getting pools config from store during init: %v", + err) + } + + if aSpace == nil { + return nil + } + + a.Lock() + a.addrSpaces[as] = aSpace + a.Unlock() + + return nil +} + +func (a *Allocator) updateBitMasks(aSpace *addrSpace) error { + var inserterList []func() error + + aSpace.Lock() + for k, v := range aSpace.subnets { + if v.Range == nil { + kk := k + vv := v + inserterList = append(inserterList, func() error { return a.insertBitMask(kk, vv.Pool) }) + } + } + aSpace.Unlock() + + // Add the bitmasks (data could come from datastore) + if inserterList != nil { + for _, f := range inserterList { + if err := f(); err != nil { + return err + } + } + } + + return nil +} + +// GetDefaultAddressSpaces returns the local and global default address spaces +func (a *Allocator) GetDefaultAddressSpaces() (string, string, error) { + return localAddressSpace, globalAddressSpace, nil +} + +// RequestPool returns an address pool along with its unique id. +func (a *Allocator) RequestPool(addressSpace, pool, subPool string, options map[string]string, v6 bool) (string, *net.IPNet, map[string]string, error) { + log.Debugf("RequestPool(%s, %s, %s, %v, %t)", addressSpace, pool, subPool, options, v6) + k, nw, ipr, err := a.parsePoolRequest(addressSpace, pool, subPool, v6) + if err != nil { + return "", nil, nil, types.InternalErrorf("failed to parse pool request for address space %q pool %q subpool %q: %v", addressSpace, pool, subPool, err) + } + +retry: + if err := a.refresh(addressSpace); err != nil { + return "", nil, nil, err + } + + aSpace, err := a.getAddrSpace(addressSpace) + if err != nil { + return "", nil, nil, err + } + + insert, err := aSpace.updatePoolDBOnAdd(*k, nw, ipr) + if err != nil { + return "", nil, nil, err + } + + if err := a.writeToStore(aSpace); err != nil { + if _, ok := err.(types.RetryError); !ok { + return "", nil, nil, types.InternalErrorf("pool configuration failed because of %s", err.Error()) + } + + goto retry + } + + return k.String(), nw, nil, insert() +} + +// ReleasePool releases the address pool identified by the passed id +func (a *Allocator) ReleasePool(poolID string) error { + log.Debugf("ReleasePool(%s)", poolID) + k := SubnetKey{} + if err := k.FromString(poolID); err != nil { + return types.BadRequestErrorf("invalid pool id: %s", poolID) + } + +retry: + if err := a.refresh(k.AddressSpace); err != nil { + return err + } + + aSpace, err := a.getAddrSpace(k.AddressSpace) + if err != nil { + return err + } + + remove, err := aSpace.updatePoolDBOnRemoval(k) + if err != nil { + return err + } + + if err = a.writeToStore(aSpace); err != nil { + if _, ok := err.(types.RetryError); !ok { + return types.InternalErrorf("pool (%s) removal failed because of %v", poolID, err) + } + goto retry + } + + return remove() +} + +// Given the address space, returns the local or global PoolConfig based on the +// address space is local or global. AddressSpace locality is being registered with IPAM out of band. +func (a *Allocator) getAddrSpace(as string) (*addrSpace, error) { + a.Lock() + defer a.Unlock() + aSpace, ok := a.addrSpaces[as] + if !ok { + return nil, types.BadRequestErrorf("cannot find address space %s (most likely the backing datastore is not configured)", as) + } + return aSpace, nil +} + +func (a *Allocator) parsePoolRequest(addressSpace, pool, subPool string, v6 bool) (*SubnetKey, *net.IPNet, *AddressRange, error) { + var ( + nw *net.IPNet + ipr *AddressRange + err error + ) + + if addressSpace == "" { + return nil, nil, nil, ipamapi.ErrInvalidAddressSpace + } + + if pool == "" && subPool != "" { + return nil, nil, nil, ipamapi.ErrInvalidSubPool + } + + if pool != "" { + if _, nw, err = net.ParseCIDR(pool); err != nil { + return nil, nil, nil, ipamapi.ErrInvalidPool + } + if subPool != "" { + if ipr, err = getAddressRange(subPool, nw); err != nil { + return nil, nil, nil, err + } + } + } else { + if nw, err = a.getPredefinedPool(addressSpace, v6); err != nil { + return nil, nil, nil, err + } + + } + + return &SubnetKey{AddressSpace: addressSpace, Subnet: nw.String(), ChildSubnet: subPool}, nw, ipr, nil +} + +func (a *Allocator) insertBitMask(key SubnetKey, pool *net.IPNet) error { + //log.Debugf("Inserting bitmask (%s, %s)", key.String(), pool.String()) + + store := a.getStore(key.AddressSpace) + if store == nil { + return fmt.Errorf("could not find store for address space %s while inserting bit mask", key.AddressSpace) + } + + ipVer := getAddressVersion(pool.IP) + ones, bits := pool.Mask.Size() + numAddresses := uint64(1 << uint(bits-ones)) + + // Allow /64 subnet + if ipVer == v6 && numAddresses == 0 { + numAddresses-- + } + + // Generate the new address masks. AddressMask content may come from datastore + h, err := bitseq.NewHandle(dsDataKey, store, key.String(), numAddresses) + if err != nil { + return err + } + + // Do not let network identifier address be reserved + // Do the same for IPv6 so that bridge ip starts with XXXX...::1 + h.Set(0) + + // Do not let broadcast address be reserved + if ipVer == v4 { + h.Set(numAddresses - 1) + } + + a.Lock() + a.addresses[key] = h + a.Unlock() + return nil +} + +func (a *Allocator) retrieveBitmask(k SubnetKey, n *net.IPNet) (*bitseq.Handle, error) { + a.Lock() + bm, ok := a.addresses[k] + a.Unlock() + if !ok { + log.Debugf("Retrieving bitmask (%s, %s)", k.String(), n.String()) + if err := a.insertBitMask(k, n); err != nil { + return nil, fmt.Errorf("could not find bitmask in datastore for %s", k.String()) + } + a.Lock() + bm = a.addresses[k] + a.Unlock() + } + return bm, nil +} + +func (a *Allocator) getPredefineds(as string) []*net.IPNet { + a.Lock() + defer a.Unlock() + l := make([]*net.IPNet, 0, len(a.predefined[as])) + for _, pool := range a.predefined[as] { + l = append(l, pool) + } + return l +} + +func (a *Allocator) getPredefinedPool(as string, ipV6 bool) (*net.IPNet, error) { + var v ipVersion + v = v4 + if ipV6 { + v = v6 + } + + if as != localAddressSpace && as != globalAddressSpace { + return nil, fmt.Errorf("no default pool available for non-default address spaces") + } + + aSpace, err := a.getAddrSpace(as) + if err != nil { + return nil, err + } + + for _, nw := range a.getPredefineds(as) { + if v != getAddressVersion(nw.IP) { + continue + } + aSpace.Lock() + _, ok := aSpace.subnets[SubnetKey{AddressSpace: as, Subnet: nw.String()}] + aSpace.Unlock() + if ok { + continue + } + + if !aSpace.contains(as, nw) { + if as == localAddressSpace { + // Check if nw overlap with system routes, name servers + if _, err := ipamutils.FindAvailableNetwork([]*net.IPNet{nw}); err == nil { + return nw, nil + } + continue + } + return nw, nil + } + } + + return nil, types.NotFoundErrorf("could not find an available predefined network") +} + +// RequestAddress returns an address from the specified pool ID +func (a *Allocator) RequestAddress(poolID string, prefAddress net.IP, opts map[string]string) (*net.IPNet, map[string]string, error) { + log.Debugf("RequestAddress(%s, %v, %v)", poolID, prefAddress, opts) + k := SubnetKey{} + if err := k.FromString(poolID); err != nil { + return nil, nil, types.BadRequestErrorf("invalid pool id: %s", poolID) + } + + if err := a.refresh(k.AddressSpace); err != nil { + return nil, nil, err + } + + aSpace, err := a.getAddrSpace(k.AddressSpace) + if err != nil { + return nil, nil, err + } + + aSpace.Lock() + p, ok := aSpace.subnets[k] + if !ok { + aSpace.Unlock() + return nil, nil, types.NotFoundErrorf("cannot find address pool for poolID:%s", poolID) + } + + if prefAddress != nil && !p.Pool.Contains(prefAddress) { + aSpace.Unlock() + return nil, nil, ipamapi.ErrIPOutOfRange + } + + c := p + for c.Range != nil { + k = c.ParentKey + c, ok = aSpace.subnets[k] + } + aSpace.Unlock() + + bm, err := a.retrieveBitmask(k, c.Pool) + if err != nil { + return nil, nil, fmt.Errorf("could not find bitmask in datastore for %s on address %v request from pool %s: %v", + k.String(), prefAddress, poolID, err) + } + ip, err := a.getAddress(p.Pool, bm, prefAddress, p.Range) + if err != nil { + return nil, nil, err + } + + return &net.IPNet{IP: ip, Mask: p.Pool.Mask}, nil, nil +} + +// ReleaseAddress releases the address from the specified pool ID +func (a *Allocator) ReleaseAddress(poolID string, address net.IP) error { + log.Debugf("ReleaseAddress(%s, %v)", poolID, address) + k := SubnetKey{} + if err := k.FromString(poolID); err != nil { + return types.BadRequestErrorf("invalid pool id: %s", poolID) + } + + if err := a.refresh(k.AddressSpace); err != nil { + return err + } + + aSpace, err := a.getAddrSpace(k.AddressSpace) + if err != nil { + return err + } + + aSpace.Lock() + p, ok := aSpace.subnets[k] + if !ok { + aSpace.Unlock() + return ipamapi.ErrBadPool + } + + if address == nil { + aSpace.Unlock() + return ipamapi.ErrInvalidRequest + } + + if !p.Pool.Contains(address) { + aSpace.Unlock() + return ipamapi.ErrIPOutOfRange + } + + c := p + for c.Range != nil { + k = c.ParentKey + c = aSpace.subnets[k] + } + aSpace.Unlock() + + mask := p.Pool.Mask + + h, err := types.GetHostPartIP(address, mask) + if err != nil { + return fmt.Errorf("failed to release address %s: %v", address.String(), err) + } + + bm, err := a.retrieveBitmask(k, c.Pool) + if err != nil { + return fmt.Errorf("could not find bitmask in datastore for %s on address %v release from pool %s: %v", + k.String(), address, poolID, err) + } + + return bm.Unset(ipToUint64(h)) +} + +func (a *Allocator) getAddress(nw *net.IPNet, bitmask *bitseq.Handle, prefAddress net.IP, ipr *AddressRange) (net.IP, error) { + var ( + ordinal uint64 + err error + base *net.IPNet + ) + + base = types.GetIPNetCopy(nw) + + if bitmask.Unselected() <= 0 { + return nil, ipamapi.ErrNoAvailableIPs + } + if ipr == nil && prefAddress == nil { + ordinal, err = bitmask.SetAny() + } else if prefAddress != nil { + hostPart, e := types.GetHostPartIP(prefAddress, base.Mask) + if e != nil { + return nil, fmt.Errorf("failed to allocate preferred address %s: %v", prefAddress.String(), e) + } + ordinal = ipToUint64(types.GetMinimalIP(hostPart)) + err = bitmask.Set(ordinal) + } else { + ordinal, err = bitmask.SetAnyInRange(ipr.Start, ipr.End) + } + if err != nil { + return nil, ipamapi.ErrNoAvailableIPs + } + + // Convert IP ordinal for this subnet into IP address + return generateAddress(ordinal, base), nil +} + +// DumpDatabase dumps the internal info +func (a *Allocator) DumpDatabase() string { + a.Lock() + defer a.Unlock() + + var s string + for as, aSpace := range a.addrSpaces { + s = fmt.Sprintf("\n\n%s Config", as) + aSpace.Lock() + for k, config := range aSpace.subnets { + s = fmt.Sprintf("%s%s", s, fmt.Sprintf("\n%v: %v", k, config)) + } + aSpace.Unlock() + } + + s = fmt.Sprintf("%s\n\nBitmasks", s) + for k, bm := range a.addresses { + s = fmt.Sprintf("%s%s", s, fmt.Sprintf("\n\t%s: %s\n\t%d", k, bm, bm.Unselected())) + } + + return s +} diff --git a/vendor/src/github.com/docker/libnetwork/ipam/store.go b/vendor/src/github.com/docker/libnetwork/ipam/store.go new file mode 100644 index 0000000000..29cd753b60 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipam/store.go @@ -0,0 +1,131 @@ +package ipam + +import ( + "encoding/json" + "fmt" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/types" +) + +// Key provides the Key to be used in KV Store +func (aSpace *addrSpace) Key() []string { + aSpace.Lock() + defer aSpace.Unlock() + return []string{aSpace.id} +} + +// KeyPrefix returns the immediate parent key that can be used for tree walk +func (aSpace *addrSpace) KeyPrefix() []string { + aSpace.Lock() + defer aSpace.Unlock() + return []string{dsConfigKey} +} + +// Value marshals the data to be stored in the KV store +func (aSpace *addrSpace) Value() []byte { + b, err := json.Marshal(aSpace) + if err != nil { + log.Warnf("Failed to marshal ipam configured pools: %v", err) + return nil + } + return b +} + +// SetValue unmarshalls the data from the KV store. +func (aSpace *addrSpace) SetValue(value []byte) error { + rc := &addrSpace{subnets: make(map[SubnetKey]*PoolData)} + if err := json.Unmarshal(value, rc); err != nil { + return err + } + aSpace.subnets = rc.subnets + return nil +} + +// Index returns the latest DB Index as seen by this object +func (aSpace *addrSpace) Index() uint64 { + aSpace.Lock() + defer aSpace.Unlock() + return aSpace.dbIndex +} + +// SetIndex method allows the datastore to store the latest DB Index into this object +func (aSpace *addrSpace) SetIndex(index uint64) { + aSpace.Lock() + aSpace.dbIndex = index + aSpace.dbExists = true + aSpace.Unlock() +} + +// Exists method is true if this object has been stored in the DB. +func (aSpace *addrSpace) Exists() bool { + aSpace.Lock() + defer aSpace.Unlock() + return aSpace.dbExists +} + +// Skip provides a way for a KV Object to avoid persisting it in the KV Store +func (aSpace *addrSpace) Skip() bool { + return false +} + +func (a *Allocator) getStore(as string) datastore.DataStore { + a.Lock() + defer a.Unlock() + + if aSpace, ok := a.addrSpaces[as]; ok { + return aSpace.ds + } + + return nil +} + +func (a *Allocator) getAddressSpaceFromStore(as string) (*addrSpace, error) { + store := a.getStore(as) + if store == nil { + return nil, fmt.Errorf("store for address space %s not found", as) + } + + pc := &addrSpace{id: dsConfigKey + "/" + as, ds: store, alloc: a} + if err := store.GetObject(datastore.Key(pc.Key()...), pc); err != nil { + if err == datastore.ErrKeyNotFound { + return nil, nil + } + + return nil, fmt.Errorf("could not get pools config from store: %v", err) + } + + return pc, nil +} + +func (a *Allocator) writeToStore(aSpace *addrSpace) error { + store := aSpace.store() + if store == nil { + return fmt.Errorf("invalid store while trying to write %s address space", aSpace.DataScope()) + } + + err := store.PutObjectAtomic(aSpace) + if err == datastore.ErrKeyModified { + return types.RetryErrorf("failed to perform atomic write (%v). retry might fix the error", err) + } + + return err +} + +func (a *Allocator) deleteFromStore(aSpace *addrSpace) error { + store := aSpace.store() + if store == nil { + return fmt.Errorf("invalid store while trying to delete %s address space", aSpace.DataScope()) + } + + return store.DeleteObjectAtomic(aSpace) +} + +// DataScope method returns the storage scope of the datastore +func (aSpace *addrSpace) DataScope() string { + aSpace.Lock() + defer aSpace.Unlock() + + return aSpace.scope +} diff --git a/vendor/src/github.com/docker/libnetwork/ipam/structures.go b/vendor/src/github.com/docker/libnetwork/ipam/structures.go new file mode 100644 index 0000000000..9ac171887c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipam/structures.go @@ -0,0 +1,359 @@ +package ipam + +import ( + "encoding/json" + "fmt" + "net" + "strings" + "sync" + + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/types" +) + +// SubnetKey is the pointer to the configured pools in each address space +type SubnetKey struct { + AddressSpace string + Subnet string + ChildSubnet string +} + +// PoolData contains the configured pool data +type PoolData struct { + ParentKey SubnetKey + Pool *net.IPNet + Range *AddressRange `json:",omitempty"` + RefCount int +} + +// addrSpace contains the pool configurations for the address space +type addrSpace struct { + subnets map[SubnetKey]*PoolData + dbIndex uint64 + dbExists bool + id string + scope string + ds datastore.DataStore + alloc *Allocator + sync.Mutex +} + +// AddressRange specifies first and last ip ordinal which +// identify a range in a a pool of addresses +type AddressRange struct { + Sub *net.IPNet + Start, End uint64 +} + +// String returns the string form of the AddressRange object +func (r *AddressRange) String() string { + return fmt.Sprintf("Sub: %s, range [%d, %d]", r.Sub, r.Start, r.End) +} + +// MarshalJSON returns the JSON encoding of the Range object +func (r *AddressRange) MarshalJSON() ([]byte, error) { + m := map[string]interface{}{ + "Sub": r.Sub.String(), + "Start": r.Start, + "End": r.End, + } + return json.Marshal(m) +} + +// UnmarshalJSON decodes data into the Range object +func (r *AddressRange) UnmarshalJSON(data []byte) error { + m := map[string]interface{}{} + err := json.Unmarshal(data, &m) + if err != nil { + return err + } + if r.Sub, err = types.ParseCIDR(m["Sub"].(string)); err != nil { + return err + } + r.Start = uint64(m["Start"].(float64)) + r.End = uint64(m["End"].(float64)) + return nil +} + +// String returns the string form of the SubnetKey object +func (s *SubnetKey) String() string { + k := fmt.Sprintf("%s/%s", s.AddressSpace, s.Subnet) + if s.ChildSubnet != "" { + k = fmt.Sprintf("%s/%s", k, s.ChildSubnet) + } + return k +} + +// FromString populate the SubnetKey object reading it from string +func (s *SubnetKey) FromString(str string) error { + if str == "" || !strings.Contains(str, "/") { + return fmt.Errorf("invalid string form for subnetkey: %s", str) + } + + p := strings.Split(str, "/") + if len(p) != 3 && len(p) != 5 { + return fmt.Errorf("invalid string form for subnetkey: %s", str) + } + s.AddressSpace = p[0] + s.Subnet = fmt.Sprintf("%s/%s", p[1], p[2]) + if len(p) == 5 { + s.ChildSubnet = fmt.Sprintf("%s/%s", p[3], p[4]) + } + + return nil +} + +// String returns the string form of the PoolData object +func (p *PoolData) String() string { + return fmt.Sprintf("ParentKey: %s, Pool: %s, Range: %s, RefCount: %d", + p.ParentKey.String(), p.Pool.String(), p.Range, p.RefCount) +} + +// MarshalJSON returns the JSON encoding of the PoolData object +func (p *PoolData) MarshalJSON() ([]byte, error) { + m := map[string]interface{}{ + "ParentKey": p.ParentKey, + "RefCount": p.RefCount, + } + if p.Pool != nil { + m["Pool"] = p.Pool.String() + } + if p.Range != nil { + m["Range"] = p.Range + } + return json.Marshal(m) +} + +// UnmarshalJSON decodes data into the PoolData object +func (p *PoolData) UnmarshalJSON(data []byte) error { + var ( + err error + t struct { + ParentKey SubnetKey + Pool string + Range *AddressRange `json:",omitempty"` + RefCount int + } + ) + + if err = json.Unmarshal(data, &t); err != nil { + return err + } + + p.ParentKey = t.ParentKey + p.Range = t.Range + p.RefCount = t.RefCount + if t.Pool != "" { + if p.Pool, err = types.ParseCIDR(t.Pool); err != nil { + return err + } + } + + return nil +} + +// MarshalJSON returns the JSON encoding of the addrSpace object +func (aSpace *addrSpace) MarshalJSON() ([]byte, error) { + aSpace.Lock() + defer aSpace.Unlock() + + m := map[string]interface{}{ + "Scope": string(aSpace.scope), + } + + if aSpace.subnets != nil { + s := map[string]*PoolData{} + for k, v := range aSpace.subnets { + s[k.String()] = v + } + m["Subnets"] = s + } + + return json.Marshal(m) +} + +// UnmarshalJSON decodes data into the addrSpace object +func (aSpace *addrSpace) UnmarshalJSON(data []byte) error { + aSpace.Lock() + defer aSpace.Unlock() + + m := map[string]interface{}{} + err := json.Unmarshal(data, &m) + if err != nil { + return err + } + + aSpace.scope = datastore.LocalScope + s := m["Scope"].(string) + if s == string(datastore.GlobalScope) { + aSpace.scope = datastore.GlobalScope + } + + if v, ok := m["Subnets"]; ok { + sb, _ := json.Marshal(v) + var s map[string]*PoolData + err := json.Unmarshal(sb, &s) + if err != nil { + return err + } + for ks, v := range s { + k := SubnetKey{} + k.FromString(ks) + aSpace.subnets[k] = v + } + } + + return nil +} + +// CopyTo deep copies the pool data to the destination pooldata +func (p *PoolData) CopyTo(dstP *PoolData) error { + dstP.ParentKey = p.ParentKey + dstP.Pool = types.GetIPNetCopy(p.Pool) + + if p.Range != nil { + dstP.Range = &AddressRange{} + dstP.Range.Sub = types.GetIPNetCopy(p.Range.Sub) + dstP.Range.Start = p.Range.Start + dstP.Range.End = p.Range.End + } + + dstP.RefCount = p.RefCount + return nil +} + +func (aSpace *addrSpace) CopyTo(o datastore.KVObject) error { + aSpace.Lock() + defer aSpace.Unlock() + + dstAspace := o.(*addrSpace) + + dstAspace.id = aSpace.id + dstAspace.ds = aSpace.ds + dstAspace.alloc = aSpace.alloc + dstAspace.scope = aSpace.scope + dstAspace.dbIndex = aSpace.dbIndex + dstAspace.dbExists = aSpace.dbExists + + dstAspace.subnets = make(map[SubnetKey]*PoolData) + for k, v := range aSpace.subnets { + dstAspace.subnets[k] = &PoolData{} + v.CopyTo(dstAspace.subnets[k]) + } + + return nil +} + +func (aSpace *addrSpace) New() datastore.KVObject { + aSpace.Lock() + defer aSpace.Unlock() + + return &addrSpace{ + id: aSpace.id, + ds: aSpace.ds, + alloc: aSpace.alloc, + scope: aSpace.scope, + } +} + +func (aSpace *addrSpace) updatePoolDBOnAdd(k SubnetKey, nw *net.IPNet, ipr *AddressRange) (func() error, error) { + aSpace.Lock() + defer aSpace.Unlock() + + // Check if already allocated + if p, ok := aSpace.subnets[k]; ok { + aSpace.incRefCount(p, 1) + return func() error { return nil }, nil + } + + // If master pool, check for overlap + if ipr == nil { + if aSpace.contains(k.AddressSpace, nw) { + return nil, ipamapi.ErrPoolOverlap + } + // This is a new master pool, add it along with corresponding bitmask + aSpace.subnets[k] = &PoolData{Pool: nw, RefCount: 1} + return func() error { return aSpace.alloc.insertBitMask(k, nw) }, nil + } + + // This is a new non-master pool + p := &PoolData{ + ParentKey: SubnetKey{AddressSpace: k.AddressSpace, Subnet: k.Subnet}, + Pool: nw, + Range: ipr, + RefCount: 1, + } + aSpace.subnets[k] = p + + // Look for parent pool + pp, ok := aSpace.subnets[p.ParentKey] + if ok { + aSpace.incRefCount(pp, 1) + return func() error { return nil }, nil + } + + // Parent pool does not exist, add it along with corresponding bitmask + aSpace.subnets[p.ParentKey] = &PoolData{Pool: nw, RefCount: 1} + return func() error { return aSpace.alloc.insertBitMask(p.ParentKey, nw) }, nil +} + +func (aSpace *addrSpace) updatePoolDBOnRemoval(k SubnetKey) (func() error, error) { + aSpace.Lock() + defer aSpace.Unlock() + + p, ok := aSpace.subnets[k] + if !ok { + return nil, ipamapi.ErrBadPool + } + + aSpace.incRefCount(p, -1) + + c := p + for ok { + if c.RefCount == 0 { + delete(aSpace.subnets, k) + if c.Range == nil { + return func() error { + bm, err := aSpace.alloc.retrieveBitmask(k, c.Pool) + if err != nil { + return fmt.Errorf("could not find bitmask in datastore for pool %s removal: %v", k.String(), err) + } + return bm.Destroy() + }, nil + } + } + k = c.ParentKey + c, ok = aSpace.subnets[k] + } + + return func() error { return nil }, nil +} + +func (aSpace *addrSpace) incRefCount(p *PoolData, delta int) { + c := p + ok := true + for ok { + c.RefCount += delta + c, ok = aSpace.subnets[c.ParentKey] + } +} + +// Checks whether the passed subnet is a superset or subset of any of the subset in this config db +func (aSpace *addrSpace) contains(space string, nw *net.IPNet) bool { + for k, v := range aSpace.subnets { + if space == k.AddressSpace && k.ChildSubnet == "" { + if nw.Contains(v.Pool.IP) || v.Pool.Contains(nw.IP) { + return true + } + } + } + return false +} + +func (aSpace *addrSpace) store() datastore.DataStore { + aSpace.Lock() + defer aSpace.Unlock() + + return aSpace.ds +} diff --git a/vendor/src/github.com/docker/libnetwork/ipam/utils.go b/vendor/src/github.com/docker/libnetwork/ipam/utils.go new file mode 100644 index 0000000000..d524b47830 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipam/utils.go @@ -0,0 +1,81 @@ +package ipam + +import ( + "fmt" + "net" + + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/types" +) + +type ipVersion int + +const ( + v4 = 4 + v6 = 6 +) + +func getAddressRange(pool string, masterNw *net.IPNet) (*AddressRange, error) { + ip, nw, err := net.ParseCIDR(pool) + if err != nil { + return nil, ipamapi.ErrInvalidSubPool + } + lIP, e := types.GetHostPartIP(nw.IP, masterNw.Mask) + if e != nil { + return nil, fmt.Errorf("failed to compute range's lowest ip address: %v", e) + } + bIP, e := types.GetBroadcastIP(nw.IP, nw.Mask) + if e != nil { + return nil, fmt.Errorf("failed to compute range's broadcast ip address: %v", e) + } + hIP, e := types.GetHostPartIP(bIP, masterNw.Mask) + if e != nil { + return nil, fmt.Errorf("failed to compute range's highest ip address: %v", e) + } + nw.IP = ip + return &AddressRange{nw, ipToUint64(types.GetMinimalIP(lIP)), ipToUint64(types.GetMinimalIP(hIP))}, nil +} + +// It generates the ip address in the passed subnet specified by +// the passed host address ordinal +func generateAddress(ordinal uint64, network *net.IPNet) net.IP { + var address [16]byte + + // Get network portion of IP + if getAddressVersion(network.IP) == v4 { + copy(address[:], network.IP.To4()) + } else { + copy(address[:], network.IP) + } + + end := len(network.Mask) + addIntToIP(address[:end], ordinal) + + return net.IP(address[:end]) +} + +func getAddressVersion(ip net.IP) ipVersion { + if ip.To4() == nil { + return v6 + } + return v4 +} + +// Adds the ordinal IP to the current array +// 192.168.0.0 + 53 => 192.168.53 +func addIntToIP(array []byte, ordinal uint64) { + for i := len(array) - 1; i >= 0; i-- { + array[i] |= (byte)(ordinal & 0xff) + ordinal >>= 8 + } +} + +// Convert an ordinal to the respective IP address +func ipToUint64(ip []byte) (value uint64) { + cip := types.GetMinimalIP(ip) + for i := 0; i < len(cip); i++ { + j := len(cip) - 1 - i + value += uint64(cip[i]) << uint(j*8) + } + return value +} diff --git a/vendor/src/github.com/docker/libnetwork/ipamapi/contract.go b/vendor/src/github.com/docker/libnetwork/ipamapi/contract.go new file mode 100644 index 0000000000..2b11b303a4 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipamapi/contract.go @@ -0,0 +1,72 @@ +// Package ipamapi specifies the contract the IPAM service (built-in or remote) needs to satisfy. +package ipamapi + +import ( + "errors" + "net" +) + +/******************** + * IPAM plugin types + ********************/ + +const ( + // DefaultIPAM is the name of the built-in default ipam driver + DefaultIPAM = "default" + // PluginEndpointType represents the Endpoint Type used by Plugin system + PluginEndpointType = "IpamDriver" +) + +// Callback provides a Callback interface for registering an IPAM instance into LibNetwork +type Callback interface { + // RegisterDriver provides a way for Remote drivers to dynamically register new NetworkType and associate with a ipam instance + RegisterIpamDriver(name string, driver Ipam) error +} + +/************** + * IPAM Errors + **************/ + +// Weel-known errors returned by IPAM +var ( + ErrInvalidIpamService = errors.New("Invalid IPAM Service") + ErrInvalidIpamConfigService = errors.New("Invalid IPAM Config Service") + ErrIpamNotAvailable = errors.New("IPAM Service not available") + ErrIpamInternalError = errors.New("IPAM Internal Error") + ErrInvalidAddressSpace = errors.New("Invalid Address Space") + ErrInvalidPool = errors.New("Invalid Address Pool") + ErrInvalidSubPool = errors.New("Invalid Address SubPool") + ErrInvalidRequest = errors.New("Invalid Request") + ErrPoolNotFound = errors.New("Address Pool not found") + ErrOverlapPool = errors.New("Address pool overlaps with existing pool on this address space") + ErrNoAvailablePool = errors.New("No available pool") + ErrNoAvailableIPs = errors.New("No available addresses on this pool") + ErrIPAlreadyAllocated = errors.New("Address already in use") + ErrIPOutOfRange = errors.New("Requested address is out of range") + ErrPoolOverlap = errors.New("Pool overlaps with other one on this address space") + ErrBadPool = errors.New("Address space does not contain specified address pool") +) + +/******************************* + * IPAM Service Interface + *******************************/ + +// Ipam represents the interface the IPAM service plugins must implement +// in order to allow injection/modification of IPAM database. +type Ipam interface { + // GetDefaultAddressSpaces returns the default local and global address spaces for this ipam + GetDefaultAddressSpaces() (string, string, error) + // RequestPool returns an address pool along with its unique id. Address space is a mandatory field + // which denotes a set of non-overlapping pools. pool describes the pool of addresses in CIDR notation. + // subpool indicates a smaller range of addresses from the pool, for now it is specified in CIDR notation. + // Both pool and subpool are non mandatory fields. When they are not specified, Ipam driver may choose to + // return a self chosen pool for this request. In such case the v6 flag needs to be set appropriately so + // that the driver would return the expected ip version pool. + RequestPool(addressSpace, pool, subPool string, options map[string]string, v6 bool) (string, *net.IPNet, map[string]string, error) + // ReleasePool releases the address pool identified by the passed id + ReleasePool(poolID string) error + // Request address from the specified pool ID. Input options or preferred IP can be passed. + RequestAddress(string, net.IP, map[string]string) (*net.IPNet, map[string]string, error) + // Release the address from the specified pool ID + ReleaseAddress(string, net.IP) error +} diff --git a/vendor/src/github.com/docker/libnetwork/ipams/builtin/builtin.go b/vendor/src/github.com/docker/libnetwork/ipams/builtin/builtin.go new file mode 100644 index 0000000000..707e001f73 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipams/builtin/builtin.go @@ -0,0 +1,35 @@ +package builtin + +import ( + "fmt" + + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/ipam" + "github.com/docker/libnetwork/ipamapi" +) + +// Init registers the built-in ipam service with libnetwork +func Init(ic ipamapi.Callback, l, g interface{}) error { + var ( + ok bool + localDs, globalDs datastore.DataStore + ) + + if l != nil { + if localDs, ok = l.(datastore.DataStore); !ok { + return fmt.Errorf("incorrect local datastore passed to built-in ipam init") + } + } + + if g != nil { + if globalDs, ok = g.(datastore.DataStore); !ok { + return fmt.Errorf("incorrect global datastore passed to built-in ipam init") + } + } + a, err := ipam.NewAllocator(localDs, globalDs) + if err != nil { + return err + } + + return ic.RegisterIpamDriver(ipamapi.DefaultIPAM, a) +} diff --git a/vendor/src/github.com/docker/libnetwork/ipams/remote/api/api.go b/vendor/src/github.com/docker/libnetwork/ipams/remote/api/api.go new file mode 100644 index 0000000000..b8d21fdc6b --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipams/remote/api/api.go @@ -0,0 +1,77 @@ +// Package api defines the data structure to be used in the request/response +// messages between libnetwork and the remote ipam plugin +package api + +// Response is the basic response structure used in all responses +type Response struct { + Error string +} + +// IsSuccess returns wheter the plugin response is successful +func (r *Response) IsSuccess() bool { + return r.Error == "" +} + +// GetError returns the error from the response, if any. +func (r *Response) GetError() string { + return r.Error +} + +// GetAddressSpacesResponse is the response to the ``get default address spaces`` request message +type GetAddressSpacesResponse struct { + Response + LocalDefaultAddressSpace string + GlobalDefaultAddressSpace string +} + +// RequestPoolRequest represents the expected data in a ``request address pool`` request message +type RequestPoolRequest struct { + AddressSpace string + Pool string + SubPool string + Options map[string]string + V6 bool +} + +// RequestPoolResponse represents the response message to a ``request address pool`` request +type RequestPoolResponse struct { + Response + PoolID string + Pool string // CIDR format + Data map[string]string +} + +// ReleasePoolRequest represents the expected data in a ``release address pool`` request message +type ReleasePoolRequest struct { + PoolID string +} + +// ReleasePoolResponse represents the response message to a ``release address pool`` request +type ReleasePoolResponse struct { + Response +} + +// RequestAddressRequest represents the expected data in a ``request address`` request message +type RequestAddressRequest struct { + PoolID string + Address string + Options map[string]string +} + +// RequestAddressResponse represents the expected data in the response message to a ``request address`` request +type RequestAddressResponse struct { + Response + Address string // in CIDR format + Data map[string]string +} + +// ReleaseAddressRequest represents the expected data in a ``release address`` request message +type ReleaseAddressRequest struct { + PoolID string + Address string +} + +// ReleaseAddressResponse represents the response message to a ``release address`` request +type ReleaseAddressResponse struct { + Response +} diff --git a/vendor/src/github.com/docker/libnetwork/ipams/remote/remote.go b/vendor/src/github.com/docker/libnetwork/ipams/remote/remote.go new file mode 100644 index 0000000000..3aefd430ab --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipams/remote/remote.go @@ -0,0 +1,109 @@ +package remote + +import ( + "fmt" + "net" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/plugins" + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/ipams/remote/api" + "github.com/docker/libnetwork/types" +) + +type allocator struct { + endpoint *plugins.Client + name string +} + +// PluginResponse is the interface for the plugin request responses +type PluginResponse interface { + IsSuccess() bool + GetError() string +} + +func newAllocator(name string, client *plugins.Client) ipamapi.Ipam { + a := &allocator{name: name, endpoint: client} + return a +} + +// Init registers a remote ipam when its plugin is activated +func Init(cb ipamapi.Callback, l, g interface{}) error { + plugins.Handle(ipamapi.PluginEndpointType, func(name string, client *plugins.Client) { + if err := cb.RegisterIpamDriver(name, newAllocator(name, client)); err != nil { + log.Errorf("error registering remote ipam %s due to %v", name, err) + } + }) + return nil +} + +func (a *allocator) call(methodName string, arg interface{}, retVal PluginResponse) error { + method := ipamapi.PluginEndpointType + "." + methodName + err := a.endpoint.Call(method, arg, retVal) + if err != nil { + return err + } + if !retVal.IsSuccess() { + return fmt.Errorf("remote: %s", retVal.GetError()) + } + return nil +} + +// GetDefaultAddressSpaces returns the local and global default address spaces +func (a *allocator) GetDefaultAddressSpaces() (string, string, error) { + res := &api.GetAddressSpacesResponse{} + if err := a.call("GetDefaultAddressSpaces", nil, res); err != nil { + return "", "", err + } + return res.LocalDefaultAddressSpace, res.GlobalDefaultAddressSpace, nil +} + +// RequestPool requests an address pool in the specified address space +func (a *allocator) RequestPool(addressSpace, pool, subPool string, options map[string]string, v6 bool) (string, *net.IPNet, map[string]string, error) { + req := &api.RequestPoolRequest{AddressSpace: addressSpace, Pool: pool, SubPool: subPool, Options: options, V6: v6} + res := &api.RequestPoolResponse{} + if err := a.call("RequestPool", req, res); err != nil { + return "", nil, nil, err + } + retPool, err := types.ParseCIDR(res.Pool) + return res.PoolID, retPool, res.Data, err +} + +// ReleasePool removes an address pool from the specified address space +func (a *allocator) ReleasePool(poolID string) error { + req := &api.ReleasePoolRequest{PoolID: poolID} + res := &api.ReleasePoolResponse{} + return a.call("ReleasePool", req, res) +} + +// RequestAddress requests an address from the address pool +func (a *allocator) RequestAddress(poolID string, address net.IP, options map[string]string) (*net.IPNet, map[string]string, error) { + var ( + prefAddress string + retAddress *net.IPNet + err error + ) + if address != nil { + prefAddress = address.String() + } + req := &api.RequestAddressRequest{PoolID: poolID, Address: prefAddress, Options: options} + res := &api.RequestAddressResponse{} + if err := a.call("RequestAddress", req, res); err != nil { + return nil, nil, err + } + if res.Address != "" { + retAddress, err = types.ParseCIDR(res.Address) + } + return retAddress, res.Data, err +} + +// ReleaseAddress releases the address from the specified address pool +func (a *allocator) ReleaseAddress(poolID string, address net.IP) error { + var relAddress string + if address != nil { + relAddress = address.String() + } + req := &api.ReleaseAddressRequest{PoolID: poolID, Address: relAddress} + res := &api.ReleaseAddressResponse{} + return a.call("ReleaseAddress", req, res) +} diff --git a/vendor/src/github.com/docker/libnetwork/ipamutils/utils.go b/vendor/src/github.com/docker/libnetwork/ipamutils/utils.go new file mode 100644 index 0000000000..283e003b5c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipamutils/utils.go @@ -0,0 +1,42 @@ +// Package ipamutils provides utililty functions for ipam management +package ipamutils + +import "net" + +var ( + // PredefinedBroadNetworks contains a list of 31 IPv4 private networks with host size 16 and 12 + // (172.17-31.x.x/16, 192.168.x.x/20) which do not overlap with the networks in `PredefinedGranularNetworks` + PredefinedBroadNetworks []*net.IPNet + // PredefinedGranularNetworks contains a list of 64K IPv4 private networks with host size 8 + // (10.x.x.x/24) which do not overlap with the networks in `PredefinedBroadNetworks` + PredefinedGranularNetworks []*net.IPNet +) + +func init() { + PredefinedBroadNetworks = initBroadPredefinedNetworks() + PredefinedGranularNetworks = initGranularPredefinedNetworks() +} + +func initBroadPredefinedNetworks() []*net.IPNet { + pl := make([]*net.IPNet, 0, 31) + mask := []byte{255, 255, 0, 0} + for i := 17; i < 32; i++ { + pl = append(pl, &net.IPNet{IP: []byte{172, byte(i), 0, 0}, Mask: mask}) + } + mask20 := []byte{255, 255, 240, 0} + for i := 0; i < 16; i++ { + pl = append(pl, &net.IPNet{IP: []byte{192, 168, byte(i << 4), 0}, Mask: mask20}) + } + return pl +} + +func initGranularPredefinedNetworks() []*net.IPNet { + pl := make([]*net.IPNet, 0, 256*256) + mask := []byte{255, 255, 255, 0} + for i := 0; i < 256; i++ { + for j := 0; j < 256; j++ { + pl = append(pl, &net.IPNet{IP: []byte{10, byte(i), byte(j), 0}, Mask: mask}) + } + } + return pl +} diff --git a/vendor/src/github.com/docker/libnetwork/ipamutils/utils_linux.go b/vendor/src/github.com/docker/libnetwork/ipamutils/utils_linux.go new file mode 100644 index 0000000000..9706cf39cd --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipamutils/utils_linux.go @@ -0,0 +1,74 @@ +// Package ipamutils provides utililty functions for ipam management +package ipamutils + +import ( + "fmt" + "net" + + "github.com/docker/libnetwork/netutils" + "github.com/docker/libnetwork/osl" + "github.com/docker/libnetwork/resolvconf" + "github.com/vishvananda/netlink" +) + +// ElectInterfaceAddresses looks for an interface on the OS with the specified name +// and returns its IPv4 and IPv6 addresses in CIDR form. If the interface does not exist, +// it chooses from a predifined list the first IPv4 address which does not conflict +// with other interfaces on the system. +func ElectInterfaceAddresses(name string) (*net.IPNet, []*net.IPNet, error) { + var ( + v4Net *net.IPNet + v6Nets []*net.IPNet + err error + ) + + defer osl.InitOSContext()() + + link, _ := netlink.LinkByName(name) + if link != nil { + v4addr, err := netlink.AddrList(link, netlink.FAMILY_V4) + if err != nil { + return nil, nil, err + } + v6addr, err := netlink.AddrList(link, netlink.FAMILY_V6) + if err != nil { + return nil, nil, err + } + if len(v4addr) > 0 { + v4Net = v4addr[0].IPNet + } + for _, nlAddr := range v6addr { + v6Nets = append(v6Nets, nlAddr.IPNet) + } + } + + if link == nil || v4Net == nil { + // Choose from predifined broad networks + v4Net, err = FindAvailableNetwork(PredefinedBroadNetworks) + if err != nil { + return nil, nil, err + } + } + + return v4Net, v6Nets, nil +} + +// FindAvailableNetwork returns a network from the passed list which does not +// overlap with existing interfaces in the system +func FindAvailableNetwork(list []*net.IPNet) (*net.IPNet, error) { + // We don't check for an error here, because we don't really care if we + // can't read /etc/resolv.conf. So instead we skip the append if resolvConf + // is nil. It either doesn't exist, or we can't read it for some reason. + var nameservers []string + if rc, err := resolvconf.Get(); err == nil { + nameservers = resolvconf.GetNameserversAsCIDR(rc.Content) + } + for _, nw := range list { + if err := netutils.CheckNameserverOverlaps(nameservers, nw); err == nil { + if err := netutils.CheckRouteOverlaps(nw); err == nil { + return nw, nil + } + } + } + return nil, fmt.Errorf("no available network") +} diff --git a/vendor/src/github.com/docker/libnetwork/ipamutils/utils_windows.go b/vendor/src/github.com/docker/libnetwork/ipamutils/utils_windows.go new file mode 100644 index 0000000000..4878ca2b86 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ipamutils/utils_windows.go @@ -0,0 +1,22 @@ +// Package ipamutils provides utililty functions for ipam management +package ipamutils + +import ( + "net" + + "github.com/docker/libnetwork/types" +) + +// ElectInterfaceAddresses looks for an interface on the OS with the specified name +// and returns its IPv4 and IPv6 addresses in CIDR form. If the interface does not exist, +// it chooses from a predifined list the first IPv4 address which does not conflict +// with other interfaces on the system. +func ElectInterfaceAddresses(name string) (*net.IPNet, []*net.IPNet, error) { + return nil, nil, types.NotImplementedErrorf("not supported on windows") +} + +// FindAvailableNetwork returns a network from the passed list which does not +// overlap with existing interfaces in the system +func FindAvailableNetwork(list []*net.IPNet) (*net.IPNet, error) { + return nil, types.NotImplementedErrorf("not supported on windows") +} diff --git a/vendor/src/github.com/docker/libnetwork/iptables/firewalld.go b/vendor/src/github.com/docker/libnetwork/iptables/firewalld.go new file mode 100644 index 0000000000..1227647b74 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/iptables/firewalld.go @@ -0,0 +1,164 @@ +package iptables + +import ( + "fmt" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/godbus/dbus" +) + +// IPV defines the table string +type IPV string + +const ( + // Iptables point ipv4 table + Iptables IPV = "ipv4" + // IP6Tables point to ipv6 table + IP6Tables IPV = "ipv6" + // Ebtables point to bridge table + Ebtables IPV = "eb" +) +const ( + dbusInterface = "org.fedoraproject.FirewallD1" + dbusPath = "/org/fedoraproject/FirewallD1" +) + +// Conn is a connection to firewalld dbus endpoint. +type Conn struct { + sysconn *dbus.Conn + sysobj *dbus.Object + signal chan *dbus.Signal +} + +var ( + connection *Conn + firewalldRunning bool // is Firewalld service running + onReloaded []*func() // callbacks when Firewalld has been reloaded +) + +// FirewalldInit initializes firewalld management code. +func FirewalldInit() error { + var err error + + if connection, err = newConnection(); err != nil { + return fmt.Errorf("Failed to connect to D-Bus system bus: %v", err) + } + if connection != nil { + go signalHandler() + } + + firewalldRunning = checkRunning() + return nil +} + +// New() establishes a connection to the system bus. +func newConnection() (*Conn, error) { + c := new(Conn) + if err := c.initConnection(); err != nil { + return nil, err + } + + return c, nil +} + +// Innitialize D-Bus connection. +func (c *Conn) initConnection() error { + var err error + + c.sysconn, err = dbus.SystemBus() + if err != nil { + return err + } + + // This never fails, even if the service is not running atm. + c.sysobj = c.sysconn.Object(dbusInterface, dbus.ObjectPath(dbusPath)) + + rule := fmt.Sprintf("type='signal',path='%s',interface='%s',sender='%s',member='Reloaded'", + dbusPath, dbusInterface, dbusInterface) + c.sysconn.BusObject().Call("org.freedesktop.DBus.AddMatch", 0, rule) + + rule = fmt.Sprintf("type='signal',interface='org.freedesktop.DBus',member='NameOwnerChanged',path='/org/freedesktop/DBus',sender='org.freedesktop.DBus',arg0='%s'", + dbusInterface) + c.sysconn.BusObject().Call("org.freedesktop.DBus.AddMatch", 0, rule) + + c.signal = make(chan *dbus.Signal, 10) + c.sysconn.Signal(c.signal) + + return nil +} + +func signalHandler() { + for signal := range connection.signal { + if strings.Contains(signal.Name, "NameOwnerChanged") { + firewalldRunning = checkRunning() + dbusConnectionChanged(signal.Body) + } else if strings.Contains(signal.Name, "Reloaded") { + reloaded() + } + } +} + +func dbusConnectionChanged(args []interface{}) { + name := args[0].(string) + oldOwner := args[1].(string) + newOwner := args[2].(string) + + if name != dbusInterface { + return + } + + if len(newOwner) > 0 { + connectionEstablished() + } else if len(oldOwner) > 0 { + connectionLost() + } +} + +func connectionEstablished() { + reloaded() +} + +func connectionLost() { + // Doesn't do anything for now. Libvirt also doesn't react to this. +} + +// call all callbacks +func reloaded() { + for _, pf := range onReloaded { + (*pf)() + } +} + +// OnReloaded add callback +func OnReloaded(callback func()) { + for _, pf := range onReloaded { + if pf == &callback { + return + } + } + onReloaded = append(onReloaded, &callback) +} + +// Call some remote method to see whether the service is actually running. +func checkRunning() bool { + var zone string + var err error + + if connection != nil { + err = connection.sysobj.Call(dbusInterface+".getDefaultZone", 0).Store(&zone) + logrus.Infof("Firewalld running: %t", err == nil) + return err == nil + } + return false +} + +// Passthrough method simply passes args through to iptables/ip6tables +func Passthrough(ipv IPV, args ...string) ([]byte, error) { + var output string + logrus.Debugf("Firewalld passthrough: %s, %s", ipv, args) + if err := connection.sysobj.Call(dbusInterface+".direct.passthrough", 0, ipv, args).Store(&output); err != nil { + return nil, err + } + return []byte(output), nil +} diff --git a/vendor/src/github.com/docker/libnetwork/iptables/iptables.go b/vendor/src/github.com/docker/libnetwork/iptables/iptables.go new file mode 100644 index 0000000000..4e24c3ac52 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/iptables/iptables.go @@ -0,0 +1,337 @@ +package iptables + +import ( + "errors" + "fmt" + "net" + "os/exec" + "strconv" + "strings" + "sync" + + "github.com/Sirupsen/logrus" +) + +// Action signifies the iptable action. +type Action string + +// Table refers to Nat, Filter or Mangle. +type Table string + +const ( + // Append appends the rule at the end of the chain. + Append Action = "-A" + // Delete deletes the rule from the chain. + Delete Action = "-D" + // Insert inserts the rule at the top of the chain. + Insert Action = "-I" + // Nat table is used for nat translation rules. + Nat Table = "nat" + // Filter table is used for filter rules. + Filter Table = "filter" + // Mangle table is used for mangling the packet. + Mangle Table = "mangle" +) + +var ( + iptablesPath string + supportsXlock = false + // used to lock iptables commands if xtables lock is not supported + bestEffortLock sync.Mutex + // ErrIptablesNotFound is returned when the rule is not found. + ErrIptablesNotFound = errors.New("Iptables not found") +) + +// ChainInfo defines the iptables chain. +type ChainInfo struct { + Name string + Table Table + HairpinMode bool +} + +// ChainError is returned to represent errors during ip table operation. +type ChainError struct { + Chain string + Output []byte +} + +func (e ChainError) Error() string { + return fmt.Sprintf("Error iptables %s: %s", e.Chain, string(e.Output)) +} + +func initCheck() error { + + if iptablesPath == "" { + path, err := exec.LookPath("iptables") + if err != nil { + return ErrIptablesNotFound + } + iptablesPath = path + supportsXlock = exec.Command(iptablesPath, "--wait", "-L", "-n").Run() == nil + } + return nil +} + +// NewChain adds a new chain to ip table. +func NewChain(name string, table Table, hairpinMode bool) (*ChainInfo, error) { + c := &ChainInfo{ + Name: name, + Table: table, + HairpinMode: hairpinMode, + } + if string(c.Table) == "" { + c.Table = Filter + } + + // Add chain if it doesn't exist + if _, err := Raw("-t", string(c.Table), "-n", "-L", c.Name); err != nil { + if output, err := Raw("-t", string(c.Table), "-N", c.Name); err != nil { + return nil, err + } else if len(output) != 0 { + return nil, fmt.Errorf("Could not create %s/%s chain: %s", c.Table, c.Name, output) + } + } + return c, nil +} + +// ProgramChain is used to add rules to a chain +func ProgramChain(c *ChainInfo, bridgeName string, hairpinMode bool) error { + if c.Name == "" { + return fmt.Errorf("Could not program chain, missing chain name.") + } + + switch c.Table { + case Nat: + preroute := []string{ + "-m", "addrtype", + "--dst-type", "LOCAL", + "-j", c.Name} + if !Exists(Nat, "PREROUTING", preroute...) { + if err := c.Prerouting(Append, preroute...); err != nil { + return fmt.Errorf("Failed to inject docker in PREROUTING chain: %s", err) + } + } + output := []string{ + "-m", "addrtype", + "--dst-type", "LOCAL", + "-j", c.Name} + if !hairpinMode { + output = append(output, "!", "--dst", "127.0.0.0/8") + } + if !Exists(Nat, "OUTPUT", output...) { + if err := c.Output(Append, output...); err != nil { + return fmt.Errorf("Failed to inject docker in OUTPUT chain: %s", err) + } + } + case Filter: + if bridgeName == "" { + return fmt.Errorf("Could not program chain %s/%s, missing bridge name.", + c.Table, c.Name) + } + link := []string{ + "-o", bridgeName, + "-j", c.Name} + if !Exists(Filter, "FORWARD", link...) { + insert := append([]string{string(Insert), "FORWARD"}, link...) + if output, err := Raw(insert...); err != nil { + return err + } else if len(output) != 0 { + return fmt.Errorf("Could not create linking rule to %s/%s: %s", c.Table, c.Name, output) + } + } + } + return nil +} + +// RemoveExistingChain removes existing chain from the table. +func RemoveExistingChain(name string, table Table) error { + c := &ChainInfo{ + Name: name, + Table: table, + } + if string(c.Table) == "" { + c.Table = Filter + } + return c.Remove() +} + +// Forward adds forwarding rule to 'filter' table and corresponding nat rule to 'nat' table. +func (c *ChainInfo) Forward(action Action, ip net.IP, port int, proto, destAddr string, destPort int, bridgeName string) error { + daddr := ip.String() + if ip.IsUnspecified() { + // iptables interprets "0.0.0.0" as "0.0.0.0/32", whereas we + // want "0.0.0.0/0". "0/0" is correctly interpreted as "any + // value" by both iptables and ip6tables. + daddr = "0/0" + } + args := []string{"-t", string(Nat), string(action), c.Name, + "-p", proto, + "-d", daddr, + "--dport", strconv.Itoa(port), + "-j", "DNAT", + "--to-destination", net.JoinHostPort(destAddr, strconv.Itoa(destPort))} + if !c.HairpinMode { + args = append(args, "!", "-i", bridgeName) + } + if output, err := Raw(args...); err != nil { + return err + } else if len(output) != 0 { + return ChainError{Chain: "FORWARD", Output: output} + } + + if output, err := Raw("-t", string(Filter), string(action), c.Name, + "!", "-i", bridgeName, + "-o", bridgeName, + "-p", proto, + "-d", destAddr, + "--dport", strconv.Itoa(destPort), + "-j", "ACCEPT"); err != nil { + return err + } else if len(output) != 0 { + return ChainError{Chain: "FORWARD", Output: output} + } + + if output, err := Raw("-t", string(Nat), string(action), "POSTROUTING", + "-p", proto, + "-s", destAddr, + "-d", destAddr, + "--dport", strconv.Itoa(destPort), + "-j", "MASQUERADE"); err != nil { + return err + } else if len(output) != 0 { + return ChainError{Chain: "FORWARD", Output: output} + } + + return nil +} + +// Link adds reciprocal ACCEPT rule for two supplied IP addresses. +// Traffic is allowed from ip1 to ip2 and vice-versa +func (c *ChainInfo) Link(action Action, ip1, ip2 net.IP, port int, proto string, bridgeName string) error { + if output, err := Raw("-t", string(Filter), string(action), c.Name, + "-i", bridgeName, "-o", bridgeName, + "-p", proto, + "-s", ip1.String(), + "-d", ip2.String(), + "--dport", strconv.Itoa(port), + "-j", "ACCEPT"); err != nil { + return err + } else if len(output) != 0 { + return fmt.Errorf("Error iptables forward: %s", output) + } + if output, err := Raw("-t", string(Filter), string(action), c.Name, + "-i", bridgeName, "-o", bridgeName, + "-p", proto, + "-s", ip2.String(), + "-d", ip1.String(), + "--sport", strconv.Itoa(port), + "-j", "ACCEPT"); err != nil { + return err + } else if len(output) != 0 { + return fmt.Errorf("Error iptables forward: %s", output) + } + return nil +} + +// Prerouting adds linking rule to nat/PREROUTING chain. +func (c *ChainInfo) Prerouting(action Action, args ...string) error { + a := []string{"-t", string(Nat), string(action), "PREROUTING"} + if len(args) > 0 { + a = append(a, args...) + } + if output, err := Raw(a...); err != nil { + return err + } else if len(output) != 0 { + return ChainError{Chain: "PREROUTING", Output: output} + } + return nil +} + +// Output adds linking rule to an OUTPUT chain. +func (c *ChainInfo) Output(action Action, args ...string) error { + a := []string{"-t", string(c.Table), string(action), "OUTPUT"} + if len(args) > 0 { + a = append(a, args...) + } + if output, err := Raw(a...); err != nil { + return err + } else if len(output) != 0 { + return ChainError{Chain: "OUTPUT", Output: output} + } + return nil +} + +// Remove removes the chain. +func (c *ChainInfo) Remove() error { + // Ignore errors - This could mean the chains were never set up + if c.Table == Nat { + c.Prerouting(Delete, "-m", "addrtype", "--dst-type", "LOCAL", "-j", c.Name) + c.Output(Delete, "-m", "addrtype", "--dst-type", "LOCAL", "!", "--dst", "127.0.0.0/8", "-j", c.Name) + c.Output(Delete, "-m", "addrtype", "--dst-type", "LOCAL", "-j", c.Name) // Created in versions <= 0.1.6 + + c.Prerouting(Delete) + c.Output(Delete) + } + Raw("-t", string(c.Table), "-F", c.Name) + Raw("-t", string(c.Table), "-X", c.Name) + return nil +} + +// Exists checks if a rule exists +func Exists(table Table, chain string, rule ...string) bool { + if string(table) == "" { + table = Filter + } + + // iptables -C, --check option was added in v.1.4.11 + // http://ftp.netfilter.org/pub/iptables/changes-iptables-1.4.11.txt + + // try -C + // if exit status is 0 then return true, the rule exists + if _, err := Raw(append([]string{ + "-t", string(table), "-C", chain}, rule...)...); err == nil { + return true + } + + // parse "iptables -S" for the rule (this checks rules in a specific chain + // in a specific table) + ruleString := strings.Join(rule, " ") + existingRules, _ := exec.Command(iptablesPath, "-t", string(table), "-S", chain).Output() + + return strings.Contains(string(existingRules), ruleString) +} + +// Raw calls 'iptables' system command, passing supplied arguments. +func Raw(args ...string) ([]byte, error) { + if firewalldRunning { + output, err := Passthrough(Iptables, args...) + if err == nil || !strings.Contains(err.Error(), "was not provided by any .service files") { + return output, err + } + + } + + if err := initCheck(); err != nil { + return nil, err + } + if supportsXlock { + args = append([]string{"--wait"}, args...) + } else { + bestEffortLock.Lock() + defer bestEffortLock.Unlock() + } + + logrus.Debugf("%s, %v", iptablesPath, args) + + output, err := exec.Command(iptablesPath, args...).CombinedOutput() + if err != nil { + return nil, fmt.Errorf("iptables failed: iptables %v: %s (%s)", strings.Join(args, " "), output, err) + } + + // ignore iptables' message about xtables lock + if strings.Contains(string(output), "waiting for it to exit") { + output = []byte("") + } + + return output, err +} diff --git a/vendor/src/github.com/docker/libnetwork/netlabel/labels.go b/vendor/src/github.com/docker/libnetwork/netlabel/labels.go new file mode 100644 index 0000000000..cb0c2f5402 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/netlabel/labels.go @@ -0,0 +1,106 @@ +package netlabel + +import ( + "strings" +) + +const ( + // Prefix constant marks the reserved label space for libnetwork + Prefix = "com.docker.network" + + // DriverPrefix constant marks the reserved label space for libnetwork drivers + DriverPrefix = Prefix + ".driver" + + // DriverPrivatePrefix constant marks the reserved label space + // for internal libnetwork drivers + DriverPrivatePrefix = DriverPrefix + ".private" + + // GenericData constant that helps to identify an option as a Generic constant + GenericData = Prefix + ".generic" + + // PortMap constant represents Port Mapping + PortMap = Prefix + ".portmap" + + // MacAddress constant represents Mac Address config of a Container + MacAddress = Prefix + ".endpoint.macaddress" + + // ExposedPorts constant represents the container's Exposed Ports + ExposedPorts = Prefix + ".endpoint.exposedports" + + //EnableIPv6 constant represents enabling IPV6 at network level + EnableIPv6 = Prefix + ".enable_ipv6" + + // DriverMTU constant represents the MTU size for the network driver + DriverMTU = DriverPrefix + ".mtu" + + // OverlayBindInterface constant represents overlay driver bind interface + OverlayBindInterface = DriverPrefix + ".overlay.bind_interface" + + // OverlayNeighborIP constant represents overlay driver neighbor IP + OverlayNeighborIP = DriverPrefix + ".overlay.neighbor_ip" + + // Gateway represents the gateway for the network + Gateway = Prefix + ".gateway" +) + +var ( + // GlobalKVProvider constant represents the KV provider backend + GlobalKVProvider = MakeKVProvider("global") + + // GlobalKVProviderURL constant represents the KV provider URL + GlobalKVProviderURL = MakeKVProviderURL("global") + + // GlobalKVProviderConfig constant represents the KV provider Config + GlobalKVProviderConfig = MakeKVProviderConfig("global") + + // LocalKVProvider constant represents the KV provider backend + LocalKVProvider = MakeKVProvider("local") + + // LocalKVProviderURL constant represents the KV provider URL + LocalKVProviderURL = MakeKVProviderURL("local") + + // LocalKVProviderConfig constant represents the KV provider Config + LocalKVProviderConfig = MakeKVProviderConfig("local") +) + +// MakeKVProvider returns the kvprovider label for the scope +func MakeKVProvider(scope string) string { + return DriverPrivatePrefix + scope + "kv_provider" +} + +// MakeKVProviderURL returns the kvprovider url label for the scope +func MakeKVProviderURL(scope string) string { + return DriverPrivatePrefix + scope + "kv_provider_url" +} + +// MakeKVProviderConfig returns the kvprovider config label for the scope +func MakeKVProviderConfig(scope string) string { + return DriverPrivatePrefix + scope + "kv_provider_config" +} + +// Key extracts the key portion of the label +func Key(label string) (key string) { + if kv := strings.SplitN(label, "=", 2); len(kv) > 0 { + key = kv[0] + } + return +} + +// Value extracts the value portion of the label +func Value(label string) (value string) { + if kv := strings.SplitN(label, "=", 2); len(kv) > 1 { + value = kv[1] + } + return +} + +// KeyValue decomposes the label in the (key,value) pair +func KeyValue(label string) (key string, value string) { + if kv := strings.SplitN(label, "=", 2); len(kv) > 0 { + key = kv[0] + if len(kv) > 1 { + value = kv[1] + } + } + return +} diff --git a/vendor/src/github.com/docker/libnetwork/netutils/utils.go b/vendor/src/github.com/docker/libnetwork/netutils/utils.go new file mode 100644 index 0000000000..a1ead3618c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/netutils/utils.go @@ -0,0 +1,172 @@ +// Network utility functions. + +package netutils + +import ( + "crypto/rand" + "encoding/hex" + "errors" + "fmt" + "io" + "net" + "strings" + + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" +) + +var ( + // ErrNetworkOverlapsWithNameservers preformatted error + ErrNetworkOverlapsWithNameservers = errors.New("requested network overlaps with nameserver") + // ErrNetworkOverlaps preformatted error + ErrNetworkOverlaps = errors.New("requested network overlaps with existing network") + // ErrNoDefaultRoute preformatted error + ErrNoDefaultRoute = errors.New("no default route") + + networkGetRoutesFct = netlink.RouteList +) + +// CheckNameserverOverlaps checks whether the passed network overlaps with any of the nameservers +func CheckNameserverOverlaps(nameservers []string, toCheck *net.IPNet) error { + if len(nameservers) > 0 { + for _, ns := range nameservers { + _, nsNetwork, err := net.ParseCIDR(ns) + if err != nil { + return err + } + if NetworkOverlaps(toCheck, nsNetwork) { + return ErrNetworkOverlapsWithNameservers + } + } + } + return nil +} + +// CheckRouteOverlaps checks whether the passed network overlaps with any existing routes +func CheckRouteOverlaps(toCheck *net.IPNet) error { + networks, err := networkGetRoutesFct(nil, netlink.FAMILY_V4) + if err != nil { + return err + } + + for _, network := range networks { + if network.Dst != nil && NetworkOverlaps(toCheck, network.Dst) { + return ErrNetworkOverlaps + } + } + return nil +} + +// NetworkOverlaps detects overlap between one IPNet and another +func NetworkOverlaps(netX *net.IPNet, netY *net.IPNet) bool { + return netX.Contains(netY.IP) || netY.Contains(netX.IP) +} + +// NetworkRange calculates the first and last IP addresses in an IPNet +func NetworkRange(network *net.IPNet) (net.IP, net.IP) { + if network == nil { + return nil, nil + } + + firstIP := network.IP.Mask(network.Mask) + lastIP := types.GetIPCopy(firstIP) + for i := 0; i < len(firstIP); i++ { + lastIP[i] = firstIP[i] | ^network.Mask[i] + } + + if network.IP.To4() != nil { + firstIP = firstIP.To4() + lastIP = lastIP.To4() + } + + return firstIP, lastIP +} + +// GetIfaceAddr returns the first IPv4 address and slice of IPv6 addresses for the specified network interface +func GetIfaceAddr(name string) (net.Addr, []net.Addr, error) { + iface, err := net.InterfaceByName(name) + if err != nil { + return nil, nil, err + } + addrs, err := iface.Addrs() + if err != nil { + return nil, nil, err + } + var addrs4 []net.Addr + var addrs6 []net.Addr + for _, addr := range addrs { + ip := (addr.(*net.IPNet)).IP + if ip4 := ip.To4(); ip4 != nil { + addrs4 = append(addrs4, addr) + } else if ip6 := ip.To16(); len(ip6) == net.IPv6len { + addrs6 = append(addrs6, addr) + } + } + switch { + case len(addrs4) == 0: + return nil, nil, fmt.Errorf("Interface %v has no IPv4 addresses", name) + case len(addrs4) > 1: + fmt.Printf("Interface %v has more than 1 IPv4 address. Defaulting to using %v\n", + name, (addrs4[0].(*net.IPNet)).IP) + } + return addrs4[0], addrs6, nil +} + +func genMAC(ip net.IP) net.HardwareAddr { + hw := make(net.HardwareAddr, 6) + // The first byte of the MAC address has to comply with these rules: + // 1. Unicast: Set the least-significant bit to 0. + // 2. Address is locally administered: Set the second-least-significant bit (U/L) to 1. + hw[0] = 0x02 + // The first 24 bits of the MAC represent the Organizationally Unique Identifier (OUI). + // Since this address is locally administered, we can do whatever we want as long as + // it doesn't conflict with other addresses. + hw[1] = 0x42 + // Fill the remaining 4 bytes based on the input + if ip == nil { + rand.Read(hw[2:]) + } else { + copy(hw[2:], ip.To4()) + } + return hw +} + +// GenerateRandomMAC returns a new 6-byte(48-bit) hardware address (MAC) +func GenerateRandomMAC() net.HardwareAddr { + return genMAC(nil) +} + +// GenerateMACFromIP returns a locally administered MAC address where the 4 least +// significant bytes are derived from the IPv4 address. +func GenerateMACFromIP(ip net.IP) net.HardwareAddr { + return genMAC(ip) +} + +// GenerateRandomName returns a new name joined with a prefix. This size +// specified is used to truncate the randomly generated value +func GenerateRandomName(prefix string, size int) (string, error) { + id := make([]byte, 32) + if _, err := io.ReadFull(rand.Reader, id); err != nil { + return "", err + } + return prefix + hex.EncodeToString(id)[:size], nil +} + +// GenerateIfaceName returns an interface name using the passed in +// prefix and the length of random bytes. The api ensures that the +// there are is no interface which exists with that name. +func GenerateIfaceName(prefix string, len int) (string, error) { + for i := 0; i < 3; i++ { + name, err := GenerateRandomName(prefix, len) + if err != nil { + continue + } + if _, err := netlink.LinkByName(name); err != nil { + if strings.Contains(err.Error(), "not found") { + return name, nil + } + return "", err + } + } + return "", types.InternalErrorf("could not generate interface name") +} diff --git a/vendor/src/github.com/docker/libnetwork/network.go b/vendor/src/github.com/docker/libnetwork/network.go new file mode 100644 index 0000000000..552d5f0d19 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/network.go @@ -0,0 +1,1147 @@ +package libnetwork + +import ( + "encoding/json" + "fmt" + "net" + "strconv" + "strings" + "sync" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/libnetwork/config" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/driverapi" + "github.com/docker/libnetwork/etchosts" + "github.com/docker/libnetwork/ipamapi" + "github.com/docker/libnetwork/netlabel" + "github.com/docker/libnetwork/options" + "github.com/docker/libnetwork/types" +) + +// A Network represents a logical connectivity zone that containers may +// join using the Link method. A Network is managed by a specific driver. +type Network interface { + // A user chosen name for this network. + Name() string + + // A system generated id for this network. + ID() string + + // The type of network, which corresponds to its managing driver. + Type() string + + // Create a new endpoint to this network symbolically identified by the + // specified unique name. The options parameter carry driver specific options. + CreateEndpoint(name string, options ...EndpointOption) (Endpoint, error) + + // Delete the network. + Delete() error + + // Endpoints returns the list of Endpoint(s) in this network. + Endpoints() []Endpoint + + // WalkEndpoints uses the provided function to walk the Endpoints + WalkEndpoints(walker EndpointWalker) + + // EndpointByName returns the Endpoint which has the passed name. If not found, the error ErrNoSuchEndpoint is returned. + EndpointByName(name string) (Endpoint, error) + + // EndpointByID returns the Endpoint which has the passed id. If not found, the error ErrNoSuchEndpoint is returned. + EndpointByID(id string) (Endpoint, error) + + // Return certain operational data belonging to this network + Info() NetworkInfo +} + +// NetworkInfo returns some configuration and operational information about the network +type NetworkInfo interface { + IpamConfig() (string, []*IpamConf, []*IpamConf) + DriverOptions() map[string]string + Scope() string +} + +// EndpointWalker is a client provided function which will be used to walk the Endpoints. +// When the function returns true, the walk will stop. +type EndpointWalker func(ep Endpoint) bool + +type svcMap map[string]net.IP + +// IpamConf contains all the ipam related configurations for a network +type IpamConf struct { + // The master address pool for containers and network interfaces + PreferredPool string + // A subset of the master pool. If specified, + // this becomes the container pool + SubPool string + // Input options for IPAM Driver (optional) + Options map[string]string + // Preferred Network Gateway address (optional) + Gateway string + // Auxiliary addresses for network driver. Must be within the master pool. + // libnetwork will reserve them if they fall into the container pool + AuxAddresses map[string]string +} + +// Validate checks whether the configuration is valid +func (c *IpamConf) Validate() error { + if c.Gateway != "" && nil == net.ParseIP(c.Gateway) { + return types.BadRequestErrorf("invalid gateway address %s in Ipam configuration", c.Gateway) + } + return nil +} + +// IpamInfo contains all the ipam related operational info for a network +type IpamInfo struct { + PoolID string + Meta map[string]string + driverapi.IPAMData +} + +// MarshalJSON encodes IpamInfo into json message +func (i *IpamInfo) MarshalJSON() ([]byte, error) { + m := map[string]interface{}{ + "PoolID": i.PoolID, + } + v, err := json.Marshal(&i.IPAMData) + if err != nil { + return nil, err + } + m["IPAMData"] = string(v) + + if i.Meta != nil { + m["Meta"] = i.Meta + } + return json.Marshal(m) +} + +// UnmarshalJSON decodes json message into PoolData +func (i *IpamInfo) UnmarshalJSON(data []byte) error { + var ( + m map[string]interface{} + err error + ) + if err = json.Unmarshal(data, &m); err != nil { + return err + } + i.PoolID = m["PoolID"].(string) + if v, ok := m["Meta"]; ok { + b, _ := json.Marshal(v) + if err = json.Unmarshal(b, &i.Meta); err != nil { + return err + } + } + if v, ok := m["IPAMData"]; ok { + if err = json.Unmarshal([]byte(v.(string)), &i.IPAMData); err != nil { + return err + } + } + return nil +} + +type network struct { + ctrlr *controller + name string + networkType string + id string + ipamType string + addrSpace string + ipamV4Config []*IpamConf + ipamV6Config []*IpamConf + ipamV4Info []*IpamInfo + ipamV6Info []*IpamInfo + enableIPv6 bool + postIPv6 bool + epCnt *endpointCnt + generic options.Generic + dbIndex uint64 + svcRecords svcMap + dbExists bool + persist bool + stopWatchCh chan struct{} + drvOnce *sync.Once + sync.Mutex +} + +func (n *network) Name() string { + n.Lock() + defer n.Unlock() + + return n.name +} + +func (n *network) ID() string { + n.Lock() + defer n.Unlock() + + return n.id +} + +func (n *network) Type() string { + n.Lock() + defer n.Unlock() + + return n.networkType +} + +func (n *network) Key() []string { + n.Lock() + defer n.Unlock() + return []string{datastore.NetworkKeyPrefix, n.id} +} + +func (n *network) KeyPrefix() []string { + return []string{datastore.NetworkKeyPrefix} +} + +func (n *network) Value() []byte { + n.Lock() + defer n.Unlock() + b, err := json.Marshal(n) + if err != nil { + return nil + } + return b +} + +func (n *network) SetValue(value []byte) error { + return json.Unmarshal(value, n) +} + +func (n *network) Index() uint64 { + n.Lock() + defer n.Unlock() + return n.dbIndex +} + +func (n *network) SetIndex(index uint64) { + n.Lock() + n.dbIndex = index + n.dbExists = true + n.Unlock() +} + +func (n *network) Exists() bool { + n.Lock() + defer n.Unlock() + return n.dbExists +} + +func (n *network) Skip() bool { + n.Lock() + defer n.Unlock() + return !n.persist +} + +func (n *network) New() datastore.KVObject { + n.Lock() + defer n.Unlock() + + return &network{ + ctrlr: n.ctrlr, + drvOnce: &sync.Once{}, + } +} + +// CopyTo deep copies to the destination IpamConfig +func (c *IpamConf) CopyTo(dstC *IpamConf) error { + dstC.PreferredPool = c.PreferredPool + dstC.SubPool = c.SubPool + dstC.Gateway = c.Gateway + if c.Options != nil { + dstC.Options = make(map[string]string, len(c.Options)) + for k, v := range c.Options { + dstC.Options[k] = v + } + } + if c.AuxAddresses != nil { + dstC.AuxAddresses = make(map[string]string, len(c.AuxAddresses)) + for k, v := range c.AuxAddresses { + dstC.AuxAddresses[k] = v + } + } + return nil +} + +// CopyTo deep copies to the destination IpamInfo +func (i *IpamInfo) CopyTo(dstI *IpamInfo) error { + dstI.PoolID = i.PoolID + if i.Meta != nil { + dstI.Meta = make(map[string]string) + for k, v := range i.Meta { + dstI.Meta[k] = v + } + } + + dstI.AddressSpace = i.AddressSpace + dstI.Pool = types.GetIPNetCopy(i.Pool) + dstI.Gateway = types.GetIPNetCopy(i.Gateway) + + if i.AuxAddresses != nil { + dstI.AuxAddresses = make(map[string]*net.IPNet) + for k, v := range i.AuxAddresses { + dstI.AuxAddresses[k] = types.GetIPNetCopy(v) + } + } + + return nil +} + +func (n *network) CopyTo(o datastore.KVObject) error { + n.Lock() + defer n.Unlock() + + dstN := o.(*network) + dstN.name = n.name + dstN.id = n.id + dstN.networkType = n.networkType + dstN.ipamType = n.ipamType + dstN.enableIPv6 = n.enableIPv6 + dstN.persist = n.persist + dstN.postIPv6 = n.postIPv6 + dstN.dbIndex = n.dbIndex + dstN.dbExists = n.dbExists + dstN.drvOnce = n.drvOnce + + for _, v4conf := range n.ipamV4Config { + dstV4Conf := &IpamConf{} + v4conf.CopyTo(dstV4Conf) + dstN.ipamV4Config = append(dstN.ipamV4Config, dstV4Conf) + } + + for _, v4info := range n.ipamV4Info { + dstV4Info := &IpamInfo{} + v4info.CopyTo(dstV4Info) + dstN.ipamV4Info = append(dstN.ipamV4Info, dstV4Info) + } + + for _, v6conf := range n.ipamV6Config { + dstV6Conf := &IpamConf{} + v6conf.CopyTo(dstV6Conf) + dstN.ipamV6Config = append(dstN.ipamV6Config, dstV6Conf) + } + + for _, v6info := range n.ipamV6Info { + dstV6Info := &IpamInfo{} + v6info.CopyTo(dstV6Info) + dstN.ipamV6Info = append(dstN.ipamV6Info, dstV6Info) + } + + dstN.generic = options.Generic{} + for k, v := range n.generic { + dstN.generic[k] = v + } + + return nil +} + +func (n *network) DataScope() string { + return n.driverScope() +} + +func (n *network) getEpCnt() *endpointCnt { + n.Lock() + defer n.Unlock() + + return n.epCnt +} + +// TODO : Can be made much more generic with the help of reflection (but has some golang limitations) +func (n *network) MarshalJSON() ([]byte, error) { + netMap := make(map[string]interface{}) + netMap["name"] = n.name + netMap["id"] = n.id + netMap["networkType"] = n.networkType + netMap["ipamType"] = n.ipamType + netMap["addrSpace"] = n.addrSpace + netMap["enableIPv6"] = n.enableIPv6 + if n.generic != nil { + netMap["generic"] = n.generic + } + netMap["persist"] = n.persist + netMap["postIPv6"] = n.postIPv6 + if len(n.ipamV4Config) > 0 { + ics, err := json.Marshal(n.ipamV4Config) + if err != nil { + return nil, err + } + netMap["ipamV4Config"] = string(ics) + } + if len(n.ipamV4Info) > 0 { + iis, err := json.Marshal(n.ipamV4Info) + if err != nil { + return nil, err + } + netMap["ipamV4Info"] = string(iis) + } + if len(n.ipamV6Config) > 0 { + ics, err := json.Marshal(n.ipamV6Config) + if err != nil { + return nil, err + } + netMap["ipamV6Config"] = string(ics) + } + if len(n.ipamV6Info) > 0 { + iis, err := json.Marshal(n.ipamV6Info) + if err != nil { + return nil, err + } + netMap["ipamV6Info"] = string(iis) + } + return json.Marshal(netMap) +} + +// TODO : Can be made much more generic with the help of reflection (but has some golang limitations) +func (n *network) UnmarshalJSON(b []byte) (err error) { + var netMap map[string]interface{} + if err := json.Unmarshal(b, &netMap); err != nil { + return err + } + n.name = netMap["name"].(string) + n.id = netMap["id"].(string) + n.networkType = netMap["networkType"].(string) + n.enableIPv6 = netMap["enableIPv6"].(bool) + + if v, ok := netMap["generic"]; ok { + n.generic = v.(map[string]interface{}) + // Restore opts in their map[string]string form + if v, ok := n.generic[netlabel.GenericData]; ok { + var lmap map[string]string + ba, err := json.Marshal(v) + if err != nil { + return err + } + if err := json.Unmarshal(ba, &lmap); err != nil { + return err + } + n.generic[netlabel.GenericData] = lmap + } + } + if v, ok := netMap["persist"]; ok { + n.persist = v.(bool) + } + if v, ok := netMap["postIPv6"]; ok { + n.postIPv6 = v.(bool) + } + if v, ok := netMap["ipamType"]; ok { + n.ipamType = v.(string) + } else { + n.ipamType = ipamapi.DefaultIPAM + } + if v, ok := netMap["addrSpace"]; ok { + n.addrSpace = v.(string) + } + if v, ok := netMap["ipamV4Config"]; ok { + if err := json.Unmarshal([]byte(v.(string)), &n.ipamV4Config); err != nil { + return err + } + } + if v, ok := netMap["ipamV4Info"]; ok { + if err := json.Unmarshal([]byte(v.(string)), &n.ipamV4Info); err != nil { + return err + } + } + if v, ok := netMap["ipamV6Config"]; ok { + if err := json.Unmarshal([]byte(v.(string)), &n.ipamV6Config); err != nil { + return err + } + } + if v, ok := netMap["ipamV6Info"]; ok { + if err := json.Unmarshal([]byte(v.(string)), &n.ipamV6Info); err != nil { + return err + } + } + return nil +} + +// NetworkOption is a option setter function type used to pass varios options to +// NewNetwork method. The various setter functions of type NetworkOption are +// provided by libnetwork, they look like NetworkOptionXXXX(...) +type NetworkOption func(n *network) + +// NetworkOptionGeneric function returns an option setter for a Generic option defined +// in a Dictionary of Key-Value pair +func NetworkOptionGeneric(generic map[string]interface{}) NetworkOption { + return func(n *network) { + n.generic = generic + if _, ok := generic[netlabel.EnableIPv6]; ok { + n.enableIPv6 = generic[netlabel.EnableIPv6].(bool) + } + } +} + +// NetworkOptionPersist returns an option setter to set persistence policy for a network +func NetworkOptionPersist(persist bool) NetworkOption { + return func(n *network) { + n.persist = persist + } +} + +// NetworkOptionIpam function returns an option setter for the ipam configuration for this network +func NetworkOptionIpam(ipamDriver string, addrSpace string, ipV4 []*IpamConf, ipV6 []*IpamConf) NetworkOption { + return func(n *network) { + if ipamDriver != "" { + n.ipamType = ipamDriver + } + n.addrSpace = addrSpace + n.ipamV4Config = ipV4 + n.ipamV6Config = ipV6 + } +} + +// NetworkOptionDriverOpts function returns an option setter for any parameter described by a map +func NetworkOptionDriverOpts(opts map[string]string) NetworkOption { + return func(n *network) { + if n.generic == nil { + n.generic = make(map[string]interface{}) + } + if opts == nil { + opts = make(map[string]string) + } + // Store the options + n.generic[netlabel.GenericData] = opts + // Decode and store the endpoint options of libnetwork interest + if val, ok := opts[netlabel.EnableIPv6]; ok { + var err error + if n.enableIPv6, err = strconv.ParseBool(val); err != nil { + log.Warnf("Failed to parse %s' value: %s (%s)", netlabel.EnableIPv6, val, err.Error()) + } + } + } +} + +// NetworkOptionDeferIPv6Alloc instructs the network to defer the IPV6 address allocation until after the endpoint has been created +// It is being provided to support the specific docker daemon flags where user can deterministically assign an IPv6 address +// to a container as combination of fixed-cidr-v6 + mac-address +// TODO: Remove this option setter once we support endpoint ipam options +func NetworkOptionDeferIPv6Alloc(enable bool) NetworkOption { + return func(n *network) { + n.postIPv6 = enable + } +} + +func (n *network) processOptions(options ...NetworkOption) { + for _, opt := range options { + if opt != nil { + opt(n) + } + } +} + +func (n *network) driverScope() string { + c := n.getController() + + c.Lock() + // Check if a driver for the specified network type is available + dd, ok := c.drivers[n.networkType] + c.Unlock() + + if !ok { + var err error + dd, err = c.loadDriver(n.networkType) + if err != nil { + // If driver could not be resolved simply return an empty string + return "" + } + } + + return dd.capability.DataScope +} + +func (n *network) driver() (driverapi.Driver, error) { + c := n.getController() + + c.Lock() + // Check if a driver for the specified network type is available + dd, ok := c.drivers[n.networkType] + c.Unlock() + + if !ok { + var err error + dd, err = c.loadDriver(n.networkType) + if err != nil { + return nil, err + } + } + + return dd.driver, nil +} + +func (n *network) Delete() error { + n.Lock() + c := n.ctrlr + name := n.name + id := n.id + n.Unlock() + + n, err := c.getNetworkFromStore(id) + if err != nil { + return &UnknownNetworkError{name: name, id: id} + } + + numEps := n.getEpCnt().EndpointCnt() + if numEps != 0 { + return &ActiveEndpointsError{name: n.name, id: n.id} + } + + if err = n.deleteNetwork(); err != nil { + return err + } + defer func() { + if err != nil { + if e := c.addNetwork(n); e != nil { + log.Warnf("failed to rollback deleteNetwork for network %s: %v", + n.Name(), err) + } + } + }() + + // deleteFromStore performs an atomic delete operation and the + // network.epCnt will help prevent any possible + // race between endpoint join and network delete + if err = n.getController().deleteFromStore(n.getEpCnt()); err != nil { + return fmt.Errorf("error deleting network endpoint count from store: %v", err) + } + + n.ipamRelease() + + if err = n.getController().deleteFromStore(n); err != nil { + return fmt.Errorf("error deleting network from store: %v", err) + } + + return nil +} + +func (n *network) deleteNetwork() error { + d, err := n.driver() + if err != nil { + return fmt.Errorf("failed deleting network: %v", err) + } + + if err := d.DeleteNetwork(n.ID()); err != nil { + // Forbidden Errors should be honored + if _, ok := err.(types.ForbiddenError); ok { + return err + } + + if _, ok := err.(types.MaskableError); !ok { + log.Warnf("driver error deleting network %s : %v", n.name, err) + } + } + + return nil +} + +func (n *network) addEndpoint(ep *endpoint) error { + d, err := n.driver() + if err != nil { + return fmt.Errorf("failed to add endpoint: %v", err) + } + + err = d.CreateEndpoint(n.id, ep.id, ep.Interface(), ep.generic) + if err != nil { + return types.InternalErrorf("failed to create endpoint %s on network %s: %v", + ep.Name(), n.Name(), err) + } + + return nil +} + +func (n *network) CreateEndpoint(name string, options ...EndpointOption) (Endpoint, error) { + var err error + if !config.IsValidName(name) { + return nil, ErrInvalidName(name) + } + + if _, err = n.EndpointByName(name); err == nil { + return nil, types.ForbiddenErrorf("service endpoint with name %s already exists", name) + } + + ep := &endpoint{name: name, generic: make(map[string]interface{}), iface: &endpointInterface{}} + ep.id = stringid.GenerateRandomID() + + // Initialize ep.network with a possibly stale copy of n. We need this to get network from + // store. But once we get it from store we will have the most uptodate copy possible. + ep.network = n + ep.network, err = ep.getNetworkFromStore() + if err != nil { + return nil, fmt.Errorf("failed to get network during CreateEndpoint: %v", err) + } + n = ep.network + + ep.processOptions(options...) + + if opt, ok := ep.generic[netlabel.MacAddress]; ok { + if mac, ok := opt.(net.HardwareAddr); ok { + ep.iface.mac = mac + } + } + + if err = ep.assignAddress(true, !n.postIPv6); err != nil { + return nil, err + } + defer func() { + if err != nil { + ep.releaseAddress() + } + }() + + if err = n.addEndpoint(ep); err != nil { + return nil, err + } + defer func() { + if err != nil { + if e := ep.deleteEndpoint(); e != nil { + log.Warnf("cleaning up endpoint failed %s : %v", name, e) + } + } + }() + + if err = ep.assignAddress(false, n.postIPv6); err != nil { + return nil, err + } + + if err = n.getController().updateToStore(ep); err != nil { + return nil, err + } + defer func() { + if err != nil { + if e := n.getController().deleteFromStore(ep); e != nil { + log.Warnf("error rolling back endpoint %s from store: %v", name, e) + } + } + }() + + // Watch for service records + n.getController().watchSvcRecord(ep) + defer func() { + if err != nil { + n.getController().unWatchSvcRecord(ep) + } + }() + + // Increment endpoint count to indicate completion of endpoint addition + if err = n.getEpCnt().IncEndpointCnt(); err != nil { + return nil, err + } + + return ep, nil +} + +func (n *network) Endpoints() []Endpoint { + var list []Endpoint + + endpoints, err := n.getEndpointsFromStore() + if err != nil { + log.Error(err) + } + + for _, ep := range endpoints { + list = append(list, ep) + } + + return list +} + +func (n *network) WalkEndpoints(walker EndpointWalker) { + for _, e := range n.Endpoints() { + if walker(e) { + return + } + } +} + +func (n *network) EndpointByName(name string) (Endpoint, error) { + if name == "" { + return nil, ErrInvalidName(name) + } + var e Endpoint + + s := func(current Endpoint) bool { + if current.Name() == name { + e = current + return true + } + return false + } + + n.WalkEndpoints(s) + + if e == nil { + return nil, ErrNoSuchEndpoint(name) + } + + return e, nil +} + +func (n *network) EndpointByID(id string) (Endpoint, error) { + if id == "" { + return nil, ErrInvalidID(id) + } + + ep, err := n.getEndpointFromStore(id) + if err != nil { + return nil, ErrNoSuchEndpoint(id) + } + + return ep, nil +} + +func (n *network) updateSvcRecord(ep *endpoint, localEps []*endpoint, isAdd bool) { + if ep.isAnonymous() { + return + } + + c := n.getController() + sr, ok := c.svcDb[n.ID()] + if !ok { + c.svcDb[n.ID()] = svcMap{} + sr = c.svcDb[n.ID()] + } + + n.Lock() + var recs []etchosts.Record + if iface := ep.Iface(); iface.Address() != nil { + if isAdd { + // If we already have this endpoint in service db just return + if _, ok := sr[ep.Name()]; ok { + n.Unlock() + return + } + + sr[ep.Name()] = iface.Address().IP + sr[ep.Name()+"."+n.name] = iface.Address().IP + } else { + delete(sr, ep.Name()) + delete(sr, ep.Name()+"."+n.name) + } + + recs = append(recs, etchosts.Record{ + Hosts: ep.Name(), + IP: iface.Address().IP.String(), + }) + + recs = append(recs, etchosts.Record{ + Hosts: ep.Name() + "." + n.name, + IP: iface.Address().IP.String(), + }) + } + n.Unlock() + + // If there are no records to add or delete then simply return here + if len(recs) == 0 { + return + } + + var sbList []*sandbox + for _, lEp := range localEps { + if ep.ID() == lEp.ID() { + continue + } + + if sb, hasSandbox := lEp.getSandbox(); hasSandbox { + sbList = append(sbList, sb) + } + } + + for _, sb := range sbList { + if isAdd { + sb.addHostsEntries(recs) + } else { + sb.deleteHostsEntries(recs) + } + } +} + +func (n *network) getSvcRecords(ep *endpoint) []etchosts.Record { + n.Lock() + defer n.Unlock() + + var recs []etchosts.Record + sr, _ := n.ctrlr.svcDb[n.id] + + for h, ip := range sr { + if ep != nil && strings.Split(h, ".")[0] == ep.Name() { + continue + } + + recs = append(recs, etchosts.Record{ + Hosts: h, + IP: ip.String(), + }) + } + + return recs +} + +func (n *network) getController() *controller { + n.Lock() + defer n.Unlock() + return n.ctrlr +} + +func (n *network) ipamAllocate() error { + // For now also exclude bridge from using new ipam + if n.Type() == "host" || n.Type() == "null" { + return nil + } + + ipam, err := n.getController().getIpamDriver(n.ipamType) + if err != nil { + return err + } + + if n.addrSpace == "" { + if n.addrSpace, err = n.deriveAddressSpace(); err != nil { + return err + } + } + + err = n.ipamAllocateVersion(4, ipam) + if err != nil { + return err + } + + defer func() { + if err != nil { + n.ipamReleaseVersion(4, ipam) + } + }() + + return n.ipamAllocateVersion(6, ipam) +} + +func (n *network) ipamAllocateVersion(ipVer int, ipam ipamapi.Ipam) error { + var ( + cfgList *[]*IpamConf + infoList *[]*IpamInfo + err error + ) + + switch ipVer { + case 4: + cfgList = &n.ipamV4Config + infoList = &n.ipamV4Info + case 6: + cfgList = &n.ipamV6Config + infoList = &n.ipamV6Info + default: + return types.InternalErrorf("incorrect ip version passed to ipam allocate: %d", ipVer) + } + + if len(*cfgList) == 0 { + if ipVer == 6 { + return nil + } + *cfgList = []*IpamConf{&IpamConf{}} + } + + *infoList = make([]*IpamInfo, len(*cfgList)) + + log.Debugf("Allocating IPv%d pools for network %s (%s)", ipVer, n.Name(), n.ID()) + + for i, cfg := range *cfgList { + if err = cfg.Validate(); err != nil { + return err + } + d := &IpamInfo{} + (*infoList)[i] = d + + d.PoolID, d.Pool, d.Meta, err = ipam.RequestPool(n.addrSpace, cfg.PreferredPool, cfg.SubPool, cfg.Options, ipVer == 6) + if err != nil { + return err + } + + defer func() { + if err != nil { + if err := ipam.ReleasePool(d.PoolID); err != nil { + log.Warnf("Failed to release address pool %s after failure to create network %s (%s)", d.PoolID, n.Name(), n.ID()) + } + } + }() + + if gws, ok := d.Meta[netlabel.Gateway]; ok { + if d.Gateway, err = types.ParseCIDR(gws); err != nil { + return types.BadRequestErrorf("failed to parse gateway address (%v) returned by ipam driver: %v", gws, err) + } + } + + // If user requested a specific gateway, libnetwork will allocate it + // irrespective of whether ipam driver returned a gateway already. + // If none of the above is true, libnetwork will allocate one. + if cfg.Gateway != "" || d.Gateway == nil { + if d.Gateway, _, err = ipam.RequestAddress(d.PoolID, net.ParseIP(cfg.Gateway), nil); err != nil { + return types.InternalErrorf("failed to allocate gateway (%v): %v", cfg.Gateway, err) + } + } + + // Auxiliary addresses must be part of the master address pool + // If they fall into the container addressable pool, libnetwork will reserve them + if cfg.AuxAddresses != nil { + var ip net.IP + d.IPAMData.AuxAddresses = make(map[string]*net.IPNet, len(cfg.AuxAddresses)) + for k, v := range cfg.AuxAddresses { + if ip = net.ParseIP(v); ip == nil { + return types.BadRequestErrorf("non parsable secondary ip address (%s:%s) passed for network %s", k, v, n.Name()) + } + if !d.Pool.Contains(ip) { + return types.ForbiddenErrorf("auxilairy address: (%s:%s) must belong to the master pool: %s", k, v, d.Pool) + } + // Attempt reservation in the container addressable pool, silent the error if address does not belong to that pool + if d.IPAMData.AuxAddresses[k], _, err = ipam.RequestAddress(d.PoolID, ip, nil); err != nil && err != ipamapi.ErrIPOutOfRange { + return types.InternalErrorf("failed to allocate secondary ip address (%s:%s): %v", k, v, err) + } + } + } + } + + return nil +} + +func (n *network) ipamRelease() { + // For now exclude host and null + if n.Type() == "host" || n.Type() == "null" { + return + } + ipam, err := n.getController().getIpamDriver(n.ipamType) + if err != nil { + log.Warnf("Failed to retrieve ipam driver to release address pool(s) on delete of network %s (%s): %v", n.Name(), n.ID(), err) + return + } + n.ipamReleaseVersion(4, ipam) + n.ipamReleaseVersion(6, ipam) +} + +func (n *network) ipamReleaseVersion(ipVer int, ipam ipamapi.Ipam) { + var infoList []*IpamInfo + + switch ipVer { + case 4: + infoList = n.ipamV4Info + case 6: + infoList = n.ipamV6Info + default: + log.Warnf("incorrect ip version passed to ipam release: %d", ipVer) + return + } + + if infoList == nil { + return + } + + log.Debugf("releasing IPv%d pools from network %s (%s)", ipVer, n.Name(), n.ID()) + + for _, d := range infoList { + if d.Gateway != nil { + if err := ipam.ReleaseAddress(d.PoolID, d.Gateway.IP); err != nil { + log.Warnf("Failed to release gateway ip address %s on delete of network %s (%s): %v", d.Gateway.IP, n.Name(), n.ID(), err) + } + } + if d.IPAMData.AuxAddresses != nil { + for k, nw := range d.IPAMData.AuxAddresses { + if d.Pool.Contains(nw.IP) { + if err := ipam.ReleaseAddress(d.PoolID, nw.IP); err != nil && err != ipamapi.ErrIPOutOfRange { + log.Warnf("Failed to release secondary ip address %s (%v) on delete of network %s (%s): %v", k, nw.IP, n.Name(), n.ID(), err) + } + } + } + } + if err := ipam.ReleasePool(d.PoolID); err != nil { + log.Warnf("Failed to release address pool %s on delete of network %s (%s): %v", d.PoolID, n.Name(), n.ID(), err) + } + } +} + +func (n *network) getIPInfo(ipVer int) []*IpamInfo { + var info []*IpamInfo + switch ipVer { + case 4: + info = n.ipamV4Info + case 6: + info = n.ipamV6Info + default: + return nil + } + l := make([]*IpamInfo, 0, len(info)) + n.Lock() + for _, d := range info { + l = append(l, d) + } + n.Unlock() + return l +} + +func (n *network) getIPData(ipVer int) []driverapi.IPAMData { + var info []*IpamInfo + switch ipVer { + case 4: + info = n.ipamV4Info + case 6: + info = n.ipamV6Info + default: + return nil + } + l := make([]driverapi.IPAMData, 0, len(info)) + n.Lock() + for _, d := range info { + l = append(l, d.IPAMData) + } + n.Unlock() + return l +} + +func (n *network) deriveAddressSpace() (string, error) { + c := n.getController() + c.Lock() + ipd, ok := c.ipamDrivers[n.ipamType] + c.Unlock() + if !ok { + return "", types.NotFoundErrorf("could not find ipam driver %s to get default address space", n.ipamType) + } + if n.DataScope() == datastore.GlobalScope { + return ipd.defaultGlobalAddressSpace, nil + } + return ipd.defaultLocalAddressSpace, nil +} + +func (n *network) Info() NetworkInfo { + return n +} + +func (n *network) DriverOptions() map[string]string { + n.Lock() + defer n.Unlock() + if n.generic != nil { + if m, ok := n.generic[netlabel.GenericData]; ok { + return m.(map[string]string) + } + } + return map[string]string{} +} + +func (n *network) Scope() string { + return n.driverScope() +} + +func (n *network) IpamConfig() (string, []*IpamConf, []*IpamConf) { + n.Lock() + defer n.Unlock() + + v4L := make([]*IpamConf, len(n.ipamV4Config)) + v6L := make([]*IpamConf, len(n.ipamV6Config)) + + for i, c := range n.ipamV4Config { + cc := &IpamConf{} + c.CopyTo(cc) + v4L[i] = cc + } + + for i, c := range n.ipamV6Config { + cc := &IpamConf{} + c.CopyTo(cc) + v6L[i] = cc + } + + return n.ipamType, v4L, v6L +} diff --git a/vendor/src/github.com/docker/libnetwork/ns/init_linux.go b/vendor/src/github.com/docker/libnetwork/ns/init_linux.go new file mode 100644 index 0000000000..7595a5da17 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/ns/init_linux.go @@ -0,0 +1,43 @@ +package ns + +import ( + "fmt" + "os" + "syscall" + + log "github.com/Sirupsen/logrus" + "github.com/vishvananda/netns" +) + +var initNs netns.NsHandle + +// Init initializes a new network namespace +func Init() { + var err error + initNs, err = netns.Get() + if err != nil { + log.Errorf("could not get initial namespace: %v", err) + } +} + +// SetNamespace sets the initial namespace handler +func SetNamespace() error { + if err := netns.Set(initNs); err != nil { + linkInfo, linkErr := getLink() + if linkErr != nil { + linkInfo = linkErr.Error() + } + + return fmt.Errorf("failed to set to initial namespace, %v, initns fd %d: %v", linkInfo, initNs, err) + } + return nil +} + +// ParseHandlerInt transforms the namespace handler into a integer +func ParseHandlerInt() int { + return int(initNs) +} + +func getLink() (string, error) { + return os.Readlink(fmt.Sprintf("/proc/%d/task/%d/ns/net", os.Getpid(), syscall.Gettid())) +} diff --git a/vendor/src/github.com/docker/libnetwork/options/options.go b/vendor/src/github.com/docker/libnetwork/options/options.go new file mode 100644 index 0000000000..8512ce83f3 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/options/options.go @@ -0,0 +1,88 @@ +// Package options provides a way to pass unstructured sets of options to a +// component expecting a strongly-typed configuration structure. +package options + +import ( + "fmt" + "reflect" +) + +// NoSuchFieldError is the error returned when the generic parameters hold a +// value for a field absent from the destination structure. +type NoSuchFieldError struct { + Field string + Type string +} + +func (e NoSuchFieldError) Error() string { + return fmt.Sprintf("no field %q in type %q", e.Field, e.Type) +} + +// CannotSetFieldError is the error returned when the generic parameters hold a +// value for a field that cannot be set in the destination structure. +type CannotSetFieldError struct { + Field string + Type string +} + +func (e CannotSetFieldError) Error() string { + return fmt.Sprintf("cannot set field %q of type %q", e.Field, e.Type) +} + +// TypeMismatchError is the error returned when the type of the generic value +// for a field mismatches the type of the destination structure. +type TypeMismatchError struct { + Field string + ExpectType string + ActualType string +} + +func (e TypeMismatchError) Error() string { + return fmt.Sprintf("type mismatch, field %s require type %v, actual type %v", e.Field, e.ExpectType, e.ActualType) +} + +// Generic is an basic type to store arbitrary settings. +type Generic map[string]interface{} + +// NewGeneric returns a new Generic instance. +func NewGeneric() Generic { + return make(Generic) +} + +// GenerateFromModel takes the generic options, and tries to build a new +// instance of the model's type by matching keys from the generic options to +// fields in the model. +// +// The return value is of the same type than the model (including a potential +// pointer qualifier). +func GenerateFromModel(options Generic, model interface{}) (interface{}, error) { + modType := reflect.TypeOf(model) + + // If the model is of pointer type, we need to dereference for New. + resType := reflect.TypeOf(model) + if modType.Kind() == reflect.Ptr { + resType = resType.Elem() + } + + // Populate the result structure with the generic layout content. + res := reflect.New(resType) + for name, value := range options { + field := res.Elem().FieldByName(name) + if !field.IsValid() { + return nil, NoSuchFieldError{name, resType.String()} + } + if !field.CanSet() { + return nil, CannotSetFieldError{name, resType.String()} + } + if reflect.TypeOf(value) != field.Type() { + return nil, TypeMismatchError{name, field.Type().String(), reflect.TypeOf(value).String()} + } + field.Set(reflect.ValueOf(value)) + } + + // If the model is not of pointer type, return content of the result. + if modType.Kind() == reflect.Ptr { + return res.Interface(), nil + } + return res.Elem().Interface(), nil +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/interface_freebsd.go b/vendor/src/github.com/docker/libnetwork/osl/interface_freebsd.go new file mode 100644 index 0000000000..9c0141fd9b --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/interface_freebsd.go @@ -0,0 +1,4 @@ +package osl + +// IfaceOption is a function option type to set interface options +type IfaceOption func() diff --git a/vendor/src/github.com/docker/libnetwork/osl/interface_linux.go b/vendor/src/github.com/docker/libnetwork/osl/interface_linux.go new file mode 100644 index 0000000000..720bf09764 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/interface_linux.go @@ -0,0 +1,385 @@ +package osl + +import ( + "fmt" + "net" + "os/exec" + "regexp" + "sync" + + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" +) + +// IfaceOption is a function option type to set interface options +type IfaceOption func(i *nwIface) + +type nwIface struct { + srcName string + dstName string + master string + dstMaster string + address *net.IPNet + addressIPv6 *net.IPNet + routes []*net.IPNet + bridge bool + ns *networkNamespace + sync.Mutex +} + +func (i *nwIface) SrcName() string { + i.Lock() + defer i.Unlock() + + return i.srcName +} + +func (i *nwIface) DstName() string { + i.Lock() + defer i.Unlock() + + return i.dstName +} + +func (i *nwIface) DstMaster() string { + i.Lock() + defer i.Unlock() + + return i.dstMaster +} + +func (i *nwIface) Bridge() bool { + i.Lock() + defer i.Unlock() + + return i.bridge +} + +func (i *nwIface) Master() string { + i.Lock() + defer i.Unlock() + + return i.master +} + +func (i *nwIface) Address() *net.IPNet { + i.Lock() + defer i.Unlock() + + return types.GetIPNetCopy(i.address) +} + +func (i *nwIface) AddressIPv6() *net.IPNet { + i.Lock() + defer i.Unlock() + + return types.GetIPNetCopy(i.addressIPv6) +} + +func (i *nwIface) Routes() []*net.IPNet { + i.Lock() + defer i.Unlock() + + routes := make([]*net.IPNet, len(i.routes)) + for index, route := range i.routes { + r := types.GetIPNetCopy(route) + routes[index] = r + } + + return routes +} + +func (n *networkNamespace) Interfaces() []Interface { + n.Lock() + defer n.Unlock() + + ifaces := make([]Interface, len(n.iFaces)) + + for i, iface := range n.iFaces { + ifaces[i] = iface + } + + return ifaces +} + +func (i *nwIface) Remove() error { + i.Lock() + n := i.ns + i.Unlock() + + n.Lock() + path := n.path + isDefault := n.isDefault + n.Unlock() + + return nsInvoke(path, func(nsFD int) error { return nil }, func(callerFD int) error { + // Find the network inteerface identified by the DstName attribute. + iface, err := netlink.LinkByName(i.DstName()) + if err != nil { + return err + } + + // Down the interface before configuring + if err := netlink.LinkSetDown(iface); err != nil { + return err + } + + err = netlink.LinkSetName(iface, i.SrcName()) + if err != nil { + fmt.Println("LinkSetName failed: ", err) + return err + } + + // if it is a bridge just delete it. + if i.Bridge() { + if err := netlink.LinkDel(iface); err != nil { + return fmt.Errorf("failed deleting bridge %q: %v", i.SrcName(), err) + } + } else if !isDefault { + // Move the network interface to caller namespace. + if err := netlink.LinkSetNsFd(iface, callerFD); err != nil { + fmt.Println("LinkSetNsPid failed: ", err) + return err + } + } + + n.Lock() + for index, intf := range n.iFaces { + if intf == i { + n.iFaces = append(n.iFaces[:index], n.iFaces[index+1:]...) + break + } + } + n.Unlock() + + return nil + }) +} + +// Returns the sandbox's side veth interface statistics +func (i *nwIface) Statistics() (*types.InterfaceStatistics, error) { + i.Lock() + n := i.ns + i.Unlock() + + n.Lock() + path := n.path + n.Unlock() + + s := &types.InterfaceStatistics{} + + err := nsInvoke(path, func(nsFD int) error { return nil }, func(callerFD int) error { + // For some reason ioutil.ReadFile(netStatsFile) reads the file in + // the default netns when this code is invoked from docker. + // Executing "cat " works as expected. + data, err := exec.Command("cat", netStatsFile).Output() + if err != nil { + return fmt.Errorf("failure opening %s: %v", netStatsFile, err) + } + return scanInterfaceStats(string(data), i.DstName(), s) + }) + + if err != nil { + err = fmt.Errorf("failed to retrieve the statistics for %s in netns %s: %v", i.DstName(), path, err) + } + + return s, err +} + +func (n *networkNamespace) findDst(srcName string, isBridge bool) string { + n.Lock() + defer n.Unlock() + + for _, i := range n.iFaces { + // The master should match the srcname of the interface and the + // master interface should be of type bridge, if searching for a bridge type + if i.SrcName() == srcName && (!isBridge || i.Bridge()) { + return i.DstName() + } + } + + return "" +} + +func (n *networkNamespace) AddInterface(srcName, dstPrefix string, options ...IfaceOption) error { + i := &nwIface{srcName: srcName, dstName: dstPrefix, ns: n} + i.processInterfaceOptions(options...) + + if i.master != "" { + i.dstMaster = n.findDst(i.master, true) + if i.dstMaster == "" { + return fmt.Errorf("could not find an appropriate master %q for %q", + i.master, i.srcName) + } + } + + n.Lock() + if n.isDefault { + i.dstName = i.srcName + } else { + i.dstName = fmt.Sprintf("%s%d", i.dstName, n.nextIfIndex) + n.nextIfIndex++ + } + + path := n.path + isDefault := n.isDefault + n.Unlock() + + return nsInvoke(path, func(nsFD int) error { + // If it is a bridge interface we have to create the bridge inside + // the namespace so don't try to lookup the interface using srcName + if i.bridge { + return nil + } + + // Find the network interface identified by the SrcName attribute. + iface, err := netlink.LinkByName(i.srcName) + if err != nil { + return fmt.Errorf("failed to get link by name %q: %v", i.srcName, err) + } + + // Move the network interface to the destination + // namespace only if the namespace is not a default + // type + if !isDefault { + if err := netlink.LinkSetNsFd(iface, nsFD); err != nil { + return fmt.Errorf("failed to set namespace on link %q: %v", i.srcName, err) + } + } + + return nil + }, func(callerFD int) error { + if i.bridge { + link := &netlink.Bridge{ + LinkAttrs: netlink.LinkAttrs{ + Name: i.srcName, + }, + } + + if err := netlink.LinkAdd(link); err != nil { + return fmt.Errorf("failed to create bridge %q: %v", i.srcName, err) + } + } + + // Find the network interface identified by the SrcName attribute. + iface, err := netlink.LinkByName(i.srcName) + if err != nil { + return fmt.Errorf("failed to get link by name %q: %v", i.srcName, err) + } + + // Down the interface before configuring + if err := netlink.LinkSetDown(iface); err != nil { + return fmt.Errorf("failed to set link down: %v", err) + } + + // Configure the interface now this is moved in the proper namespace. + if err := configureInterface(iface, i); err != nil { + return err + } + + // Up the interface. + if err := netlink.LinkSetUp(iface); err != nil { + return fmt.Errorf("failed to set link up: %v", err) + } + + // Set the routes on the interface. This can only be done when the interface is up. + if err := setInterfaceRoutes(iface, i); err != nil { + return fmt.Errorf("error setting interface %q routes to %q: %v", iface.Attrs().Name, i.Routes(), err) + } + + n.Lock() + n.iFaces = append(n.iFaces, i) + n.Unlock() + + return nil + }) +} + +func configureInterface(iface netlink.Link, i *nwIface) error { + ifaceName := iface.Attrs().Name + ifaceConfigurators := []struct { + Fn func(netlink.Link, *nwIface) error + ErrMessage string + }{ + {setInterfaceName, fmt.Sprintf("error renaming interface %q to %q", ifaceName, i.DstName())}, + {setInterfaceIP, fmt.Sprintf("error setting interface %q IP to %q", ifaceName, i.Address())}, + {setInterfaceIPv6, fmt.Sprintf("error setting interface %q IPv6 to %q", ifaceName, i.AddressIPv6())}, + {setInterfaceMaster, fmt.Sprintf("error setting interface %q master to %q", ifaceName, i.DstMaster())}, + } + + for _, config := range ifaceConfigurators { + if err := config.Fn(iface, i); err != nil { + return fmt.Errorf("%s: %v", config.ErrMessage, err) + } + } + return nil +} + +func setInterfaceMaster(iface netlink.Link, i *nwIface) error { + if i.DstMaster() == "" { + return nil + } + + return netlink.LinkSetMaster(iface, &netlink.Bridge{ + LinkAttrs: netlink.LinkAttrs{Name: i.DstMaster()}}) +} + +func setInterfaceIP(iface netlink.Link, i *nwIface) error { + if i.Address() == nil { + return nil + } + + ipAddr := &netlink.Addr{IPNet: i.Address(), Label: ""} + return netlink.AddrAdd(iface, ipAddr) +} + +func setInterfaceIPv6(iface netlink.Link, i *nwIface) error { + if i.AddressIPv6() == nil { + return nil + } + ipAddr := &netlink.Addr{IPNet: i.AddressIPv6(), Label: ""} + return netlink.AddrAdd(iface, ipAddr) +} + +func setInterfaceName(iface netlink.Link, i *nwIface) error { + return netlink.LinkSetName(iface, i.DstName()) +} + +func setInterfaceRoutes(iface netlink.Link, i *nwIface) error { + for _, route := range i.Routes() { + err := netlink.RouteAdd(&netlink.Route{ + Scope: netlink.SCOPE_LINK, + LinkIndex: iface.Attrs().Index, + Dst: route, + }) + if err != nil { + return err + } + } + return nil +} + +// In older kernels (like the one in Centos 6.6 distro) sysctl does not have netns support. Therefore +// we cannot gather the statistics from /sys/class/net//statistics/ files. Per-netns stats +// are naturally found in /proc/net/dev in kernels which support netns (ifconfig relies on that). +const ( + netStatsFile = "/proc/net/dev" + base = "[ ]*%s:([ ]+[0-9]+){16}" +) + +func scanInterfaceStats(data, ifName string, i *types.InterfaceStatistics) error { + var ( + bktStr string + bkt uint64 + ) + + regex := fmt.Sprintf(base, ifName) + re := regexp.MustCompile(regex) + line := re.FindString(data) + + _, err := fmt.Sscanf(line, "%s %d %d %d %d %d %d %d %d %d %d %d %d %d %d %d %d", + &bktStr, &i.RxBytes, &i.RxPackets, &i.RxErrors, &i.RxDropped, &bkt, &bkt, &bkt, + &bkt, &i.TxBytes, &i.TxPackets, &i.TxErrors, &i.TxDropped, &bkt, &bkt, &bkt, &bkt) + + return err +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/interface_windows.go b/vendor/src/github.com/docker/libnetwork/osl/interface_windows.go new file mode 100644 index 0000000000..9c0141fd9b --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/interface_windows.go @@ -0,0 +1,4 @@ +package osl + +// IfaceOption is a function option type to set interface options +type IfaceOption func() diff --git a/vendor/src/github.com/docker/libnetwork/osl/namespace_linux.go b/vendor/src/github.com/docker/libnetwork/osl/namespace_linux.go new file mode 100644 index 0000000000..07b725c290 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/namespace_linux.go @@ -0,0 +1,323 @@ +package osl + +import ( + "fmt" + "net" + "os" + "os/exec" + "runtime" + "sync" + "syscall" + "time" + + log "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/reexec" + "github.com/docker/libnetwork/ns" + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" + "github.com/vishvananda/netns" +) + +const prefix = "/var/run/docker/netns" + +var ( + once sync.Once + garbagePathMap = make(map[string]bool) + gpmLock sync.Mutex + gpmWg sync.WaitGroup + gpmCleanupPeriod = 60 * time.Second + gpmChan = make(chan chan struct{}) + nsOnce sync.Once +) + +// The networkNamespace type is the linux implementation of the Sandbox +// interface. It represents a linux network namespace, and moves an interface +// into it when called on method AddInterface or sets the gateway etc. +type networkNamespace struct { + path string + iFaces []*nwIface + gw net.IP + gwv6 net.IP + staticRoutes []*types.StaticRoute + neighbors []*neigh + nextIfIndex int + isDefault bool + sync.Mutex +} + +func init() { + reexec.Register("netns-create", reexecCreateNamespace) +} + +func createBasePath() { + err := os.MkdirAll(prefix, 0755) + if err != nil { + panic("Could not create net namespace path directory") + } + + // Start the garbage collection go routine + go removeUnusedPaths() +} + +func removeUnusedPaths() { + gpmLock.Lock() + period := gpmCleanupPeriod + gpmLock.Unlock() + + ticker := time.NewTicker(period) + for { + var ( + gc chan struct{} + gcOk bool + ) + + select { + case <-ticker.C: + case gc, gcOk = <-gpmChan: + } + + gpmLock.Lock() + pathList := make([]string, 0, len(garbagePathMap)) + for path := range garbagePathMap { + pathList = append(pathList, path) + } + garbagePathMap = make(map[string]bool) + gpmWg.Add(1) + gpmLock.Unlock() + + for _, path := range pathList { + os.Remove(path) + } + + gpmWg.Done() + if gcOk { + close(gc) + } + } +} + +func addToGarbagePaths(path string) { + gpmLock.Lock() + garbagePathMap[path] = true + gpmLock.Unlock() +} + +func removeFromGarbagePaths(path string) { + gpmLock.Lock() + delete(garbagePathMap, path) + gpmLock.Unlock() +} + +// GC triggers garbage collection of namespace path right away +// and waits for it. +func GC() { + gpmLock.Lock() + if len(garbagePathMap) == 0 { + // No need for GC if map is empty + gpmLock.Unlock() + return + } + gpmLock.Unlock() + + // if content exists in the garbage paths + // we can trigger GC to run, providing a + // channel to be notified on completion + waitGC := make(chan struct{}) + gpmChan <- waitGC + // wait for GC completion + <-waitGC +} + +// GenerateKey generates a sandbox key based on the passed +// container id. +func GenerateKey(containerID string) string { + maxLen := 12 + if len(containerID) < maxLen { + maxLen = len(containerID) + } + + return prefix + "/" + containerID[:maxLen] +} + +// NewSandbox provides a new sandbox instance created in an os specific way +// provided a key which uniquely identifies the sandbox +func NewSandbox(key string, osCreate bool) (Sandbox, error) { + err := createNetworkNamespace(key, osCreate) + if err != nil { + return nil, err + } + + return &networkNamespace{path: key, isDefault: !osCreate}, nil +} + +func (n *networkNamespace) InterfaceOptions() IfaceOptionSetter { + return n +} + +func (n *networkNamespace) NeighborOptions() NeighborOptionSetter { + return n +} + +func mountNetworkNamespace(basePath string, lnPath string) error { + if err := syscall.Mount(basePath, lnPath, "bind", syscall.MS_BIND, ""); err != nil { + return err + } + + if err := loopbackUp(); err != nil { + return err + } + return nil +} + +// GetSandboxForExternalKey returns sandbox object for the supplied path +func GetSandboxForExternalKey(basePath string, key string) (Sandbox, error) { + var err error + if err = createNamespaceFile(key); err != nil { + return nil, err + } + n := &networkNamespace{path: basePath} + n.InvokeFunc(func() { + err = mountNetworkNamespace(basePath, key) + }) + if err != nil { + return nil, err + } + return &networkNamespace{path: key}, nil +} + +func reexecCreateNamespace() { + if len(os.Args) < 2 { + log.Fatal("no namespace path provided") + } + if err := mountNetworkNamespace("/proc/self/ns/net", os.Args[1]); err != nil { + log.Fatal(err) + } +} + +func createNetworkNamespace(path string, osCreate bool) error { + if err := createNamespaceFile(path); err != nil { + return err + } + + cmd := &exec.Cmd{ + Path: reexec.Self(), + Args: append([]string{"netns-create"}, path), + Stdout: os.Stdout, + Stderr: os.Stderr, + } + if osCreate { + cmd.SysProcAttr = &syscall.SysProcAttr{} + cmd.SysProcAttr.Cloneflags = syscall.CLONE_NEWNET + } + if err := cmd.Run(); err != nil { + return fmt.Errorf("namespace creation reexec command failed: %v", err) + } + + return nil +} + +func unmountNamespaceFile(path string) { + if _, err := os.Stat(path); err == nil { + syscall.Unmount(path, syscall.MNT_DETACH) + } +} + +func createNamespaceFile(path string) (err error) { + var f *os.File + + once.Do(createBasePath) + // Remove it from garbage collection list if present + removeFromGarbagePaths(path) + + // If the path is there unmount it first + unmountNamespaceFile(path) + + // wait for garbage collection to complete if it is in progress + // before trying to create the file. + gpmWg.Wait() + + if f, err = os.Create(path); err == nil { + f.Close() + } + + return err +} + +func loopbackUp() error { + iface, err := netlink.LinkByName("lo") + if err != nil { + return err + } + return netlink.LinkSetUp(iface) +} + +func (n *networkNamespace) InvokeFunc(f func()) error { + return nsInvoke(n.nsPath(), func(nsFD int) error { return nil }, func(callerFD int) error { + f() + return nil + }) +} + +// InitOSContext initializes OS context while configuring network resources +func InitOSContext() func() { + runtime.LockOSThread() + nsOnce.Do(ns.Init) + if err := ns.SetNamespace(); err != nil { + log.Error(err) + } + + return runtime.UnlockOSThread +} + +func nsInvoke(path string, prefunc func(nsFD int) error, postfunc func(callerFD int) error) error { + defer InitOSContext()() + + f, err := os.OpenFile(path, os.O_RDONLY, 0) + if err != nil { + return fmt.Errorf("failed get network namespace %q: %v", path, err) + } + defer f.Close() + + nsFD := f.Fd() + + // Invoked before the namespace switch happens but after the namespace file + // handle is obtained. + if err := prefunc(int(nsFD)); err != nil { + return fmt.Errorf("failed in prefunc: %v", err) + } + + if err = netns.Set(netns.NsHandle(nsFD)); err != nil { + return err + } + defer ns.SetNamespace() + + // Invoked after the namespace switch. + return postfunc(ns.ParseHandlerInt()) +} + +func (n *networkNamespace) nsPath() string { + n.Lock() + defer n.Unlock() + + return n.path +} + +func (n *networkNamespace) Info() Info { + return n +} + +func (n *networkNamespace) Key() string { + return n.path +} + +func (n *networkNamespace) Destroy() error { + // Assuming no running process is executing in this network namespace, + // unmounting is sufficient to destroy it. + if err := syscall.Unmount(n.path, syscall.MNT_DETACH); err != nil { + return err + } + + // Stash it into the garbage collection list + addToGarbagePaths(n.path) + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/namespace_unsupported.go b/vendor/src/github.com/docker/libnetwork/osl/namespace_unsupported.go new file mode 100644 index 0000000000..dbd8d9d35d --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/namespace_unsupported.go @@ -0,0 +1,12 @@ +// +build !linux,!windows,!freebsd + +package osl + +// GC triggers garbage collection of namespace path right away +// and waits for it. +func GC() { +} + +func GetSandboxForExternalKey(path string, key string) (Sandbox, error) { + return nil, nil +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/namespace_windows.go b/vendor/src/github.com/docker/libnetwork/osl/namespace_windows.go new file mode 100644 index 0000000000..912d4a2e9f --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/namespace_windows.go @@ -0,0 +1,39 @@ +package osl + +import "testing" + +// GenerateKey generates a sandbox key based on the passed +// container id. +func GenerateKey(containerID string) string { + maxLen := 12 + if len(containerID) < maxLen { + maxLen = len(containerID) + } + + return containerID[:maxLen] +} + +// NewSandbox provides a new sandbox instance created in an os specific way +// provided a key which uniquely identifies the sandbox +func NewSandbox(key string, osCreate bool) (Sandbox, error) { + return nil, nil +} + +func GetSandboxForExternalKey(path string, key string) (Sandbox, error) { + return nil, nil +} + +// GC triggers garbage collection of namespace path right away +// and waits for it. +func GC() { +} + +// InitOSContext initializes OS context while configuring network resources +func InitOSContext() func() { + return func() {} +} + +// SetupTestOSContext sets up a separate test OS context in which tests will be executed. +func SetupTestOSContext(t *testing.T) func() { + return func() {} +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/neigh_freebsd.go b/vendor/src/github.com/docker/libnetwork/osl/neigh_freebsd.go new file mode 100644 index 0000000000..280f006396 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/neigh_freebsd.go @@ -0,0 +1,4 @@ +package osl + +// NeighOption is a function option type to set neighbor options +type NeighOption func() diff --git a/vendor/src/github.com/docker/libnetwork/osl/neigh_linux.go b/vendor/src/github.com/docker/libnetwork/osl/neigh_linux.go new file mode 100644 index 0000000000..a221e712da --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/neigh_linux.go @@ -0,0 +1,138 @@ +package osl + +import ( + "bytes" + "fmt" + "net" + + "github.com/vishvananda/netlink" +) + +// NeighOption is a function option type to set interface options +type NeighOption func(nh *neigh) + +type neigh struct { + dstIP net.IP + dstMac net.HardwareAddr + linkName string + linkDst string + family int +} + +func (n *networkNamespace) findNeighbor(dstIP net.IP, dstMac net.HardwareAddr) *neigh { + n.Lock() + defer n.Unlock() + + for _, nh := range n.neighbors { + if nh.dstIP.Equal(dstIP) && bytes.Equal(nh.dstMac, dstMac) { + return nh + } + } + + return nil +} + +func (n *networkNamespace) DeleteNeighbor(dstIP net.IP, dstMac net.HardwareAddr) error { + nh := n.findNeighbor(dstIP, dstMac) + if nh == nil { + return fmt.Errorf("could not find the neighbor entry to delete") + } + + return nsInvoke(n.nsPath(), func(nsFD int) error { return nil }, func(callerFD int) error { + var iface netlink.Link + + if nh.linkDst != "" { + var err error + iface, err = netlink.LinkByName(nh.linkDst) + if err != nil { + return fmt.Errorf("could not find interface with destination name %s: %v", + nh.linkDst, err) + } + } + + nlnh := &netlink.Neigh{ + IP: dstIP, + State: netlink.NUD_PERMANENT, + Family: nh.family, + } + + if nlnh.Family > 0 { + nlnh.HardwareAddr = dstMac + nlnh.Flags = netlink.NTF_SELF + } + + if nh.linkDst != "" { + nlnh.LinkIndex = iface.Attrs().Index + } + + if err := netlink.NeighDel(nlnh); err != nil { + return fmt.Errorf("could not delete neighbor entry: %v", err) + } + + for i, nh := range n.neighbors { + if nh.dstIP.Equal(dstIP) && bytes.Equal(nh.dstMac, dstMac) { + n.neighbors = append(n.neighbors[:i], n.neighbors[i+1:]...) + } + } + + return nil + }) +} + +func (n *networkNamespace) AddNeighbor(dstIP net.IP, dstMac net.HardwareAddr, options ...NeighOption) error { + nh := n.findNeighbor(dstIP, dstMac) + if nh != nil { + // If it exists silently return + return nil + } + + nh = &neigh{ + dstIP: dstIP, + dstMac: dstMac, + } + + nh.processNeighOptions(options...) + + if nh.linkName != "" { + nh.linkDst = n.findDst(nh.linkName, false) + if nh.linkDst == "" { + return fmt.Errorf("could not find the interface with name %s", nh.linkName) + } + } + + return nsInvoke(n.nsPath(), func(nsFD int) error { return nil }, func(callerFD int) error { + var iface netlink.Link + + if nh.linkDst != "" { + var err error + iface, err = netlink.LinkByName(nh.linkDst) + if err != nil { + return fmt.Errorf("could not find interface with destination name %s: %v", + nh.linkDst, err) + } + } + + nlnh := &netlink.Neigh{ + IP: dstIP, + HardwareAddr: dstMac, + State: netlink.NUD_PERMANENT, + Family: nh.family, + } + + if nlnh.Family > 0 { + nlnh.Flags = netlink.NTF_SELF + } + + if nh.linkDst != "" { + nlnh.LinkIndex = iface.Attrs().Index + } + + if err := netlink.NeighSet(nlnh); err != nil { + return fmt.Errorf("could not add neighbor entry: %v", err) + } + + n.neighbors = append(n.neighbors, nh) + + return nil + }) +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/neigh_windows.go b/vendor/src/github.com/docker/libnetwork/osl/neigh_windows.go new file mode 100644 index 0000000000..280f006396 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/neigh_windows.go @@ -0,0 +1,4 @@ +package osl + +// NeighOption is a function option type to set neighbor options +type NeighOption func() diff --git a/vendor/src/github.com/docker/libnetwork/osl/options_linux.go b/vendor/src/github.com/docker/libnetwork/osl/options_linux.go new file mode 100644 index 0000000000..5295eb85c5 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/options_linux.go @@ -0,0 +1,61 @@ +package osl + +import "net" + +func (nh *neigh) processNeighOptions(options ...NeighOption) { + for _, opt := range options { + if opt != nil { + opt(nh) + } + } +} + +func (n *networkNamespace) LinkName(name string) NeighOption { + return func(nh *neigh) { + nh.linkName = name + } +} + +func (n *networkNamespace) Family(family int) NeighOption { + return func(nh *neigh) { + nh.family = family + } +} + +func (i *nwIface) processInterfaceOptions(options ...IfaceOption) { + for _, opt := range options { + if opt != nil { + opt(i) + } + } +} + +func (n *networkNamespace) Bridge(isBridge bool) IfaceOption { + return func(i *nwIface) { + i.bridge = isBridge + } +} + +func (n *networkNamespace) Master(name string) IfaceOption { + return func(i *nwIface) { + i.master = name + } +} + +func (n *networkNamespace) Address(addr *net.IPNet) IfaceOption { + return func(i *nwIface) { + i.address = addr + } +} + +func (n *networkNamespace) AddressIPv6(addr *net.IPNet) IfaceOption { + return func(i *nwIface) { + i.addressIPv6 = addr + } +} + +func (n *networkNamespace) Routes(routes []*net.IPNet) IfaceOption { + return func(i *nwIface) { + i.routes = routes + } +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/route_linux.go b/vendor/src/github.com/docker/libnetwork/osl/route_linux.go new file mode 100644 index 0000000000..3ebaaec77c --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/route_linux.go @@ -0,0 +1,197 @@ +package osl + +import ( + "fmt" + "net" + + "github.com/docker/libnetwork/types" + "github.com/vishvananda/netlink" +) + +func (n *networkNamespace) Gateway() net.IP { + n.Lock() + defer n.Unlock() + + return n.gw +} + +func (n *networkNamespace) GatewayIPv6() net.IP { + n.Lock() + defer n.Unlock() + + return n.gwv6 +} + +func (n *networkNamespace) StaticRoutes() []*types.StaticRoute { + n.Lock() + defer n.Unlock() + + routes := make([]*types.StaticRoute, len(n.staticRoutes)) + for i, route := range n.staticRoutes { + r := route.GetCopy() + routes[i] = r + } + + return routes +} + +func (n *networkNamespace) setGateway(gw net.IP) { + n.Lock() + n.gw = gw + n.Unlock() +} + +func (n *networkNamespace) setGatewayIPv6(gwv6 net.IP) { + n.Lock() + n.gwv6 = gwv6 + n.Unlock() +} + +func (n *networkNamespace) SetGateway(gw net.IP) error { + // Silently return if the gateway is empty + if len(gw) == 0 { + return nil + } + + err := programGateway(n.nsPath(), gw, true) + if err == nil { + n.setGateway(gw) + } + + return err +} + +func (n *networkNamespace) UnsetGateway() error { + gw := n.Gateway() + + // Silently return if the gateway is empty + if len(gw) == 0 { + return nil + } + + err := programGateway(n.nsPath(), gw, false) + if err == nil { + n.setGateway(net.IP{}) + } + + return err +} + +func programGateway(path string, gw net.IP, isAdd bool) error { + return nsInvoke(path, func(nsFD int) error { return nil }, func(callerFD int) error { + gwRoutes, err := netlink.RouteGet(gw) + if err != nil { + return fmt.Errorf("route for the gateway %s could not be found: %v", gw, err) + } + + if isAdd { + return netlink.RouteAdd(&netlink.Route{ + Scope: netlink.SCOPE_UNIVERSE, + LinkIndex: gwRoutes[0].LinkIndex, + Gw: gw, + }) + } + + return netlink.RouteDel(&netlink.Route{ + Scope: netlink.SCOPE_UNIVERSE, + LinkIndex: gwRoutes[0].LinkIndex, + Gw: gw, + }) + }) +} + +// Program a route in to the namespace routing table. +func programRoute(path string, dest *net.IPNet, nh net.IP) error { + return nsInvoke(path, func(nsFD int) error { return nil }, func(callerFD int) error { + gwRoutes, err := netlink.RouteGet(nh) + if err != nil { + return fmt.Errorf("route for the next hop %s could not be found: %v", nh, err) + } + + return netlink.RouteAdd(&netlink.Route{ + Scope: netlink.SCOPE_UNIVERSE, + LinkIndex: gwRoutes[0].LinkIndex, + Gw: nh, + Dst: dest, + }) + }) +} + +// Delete a route from the namespace routing table. +func removeRoute(path string, dest *net.IPNet, nh net.IP) error { + return nsInvoke(path, func(nsFD int) error { return nil }, func(callerFD int) error { + gwRoutes, err := netlink.RouteGet(nh) + if err != nil { + return fmt.Errorf("route for the next hop could not be found: %v", err) + } + + return netlink.RouteDel(&netlink.Route{ + Scope: netlink.SCOPE_UNIVERSE, + LinkIndex: gwRoutes[0].LinkIndex, + Gw: nh, + Dst: dest, + }) + }) +} + +func (n *networkNamespace) SetGatewayIPv6(gwv6 net.IP) error { + // Silently return if the gateway is empty + if len(gwv6) == 0 { + return nil + } + + err := programGateway(n.nsPath(), gwv6, true) + if err == nil { + n.SetGatewayIPv6(gwv6) + } + + return err +} + +func (n *networkNamespace) UnsetGatewayIPv6() error { + gwv6 := n.GatewayIPv6() + + // Silently return if the gateway is empty + if len(gwv6) == 0 { + return nil + } + + err := programGateway(n.nsPath(), gwv6, false) + if err == nil { + n.Lock() + n.gwv6 = net.IP{} + n.Unlock() + } + + return err +} + +func (n *networkNamespace) AddStaticRoute(r *types.StaticRoute) error { + err := programRoute(n.nsPath(), r.Destination, r.NextHop) + if err == nil { + n.Lock() + n.staticRoutes = append(n.staticRoutes, r) + n.Unlock() + } + return err +} + +func (n *networkNamespace) RemoveStaticRoute(r *types.StaticRoute) error { + + err := removeRoute(n.nsPath(), r.Destination, r.NextHop) + if err == nil { + n.Lock() + lastIndex := len(n.staticRoutes) - 1 + for i, v := range n.staticRoutes { + if v == r { + // Overwrite the route we're removing with the last element + n.staticRoutes[i] = n.staticRoutes[lastIndex] + // Shorten the slice to trim the extra element + n.staticRoutes = n.staticRoutes[:lastIndex] + break + } + } + n.Unlock() + } + return err +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/sandbox.go b/vendor/src/github.com/docker/libnetwork/osl/sandbox.go new file mode 100644 index 0000000000..3a824ae6ad --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/sandbox.go @@ -0,0 +1,153 @@ +// Package osl describes structures and interfaces which abstract os entities +package osl + +import ( + "net" + + "github.com/docker/libnetwork/types" +) + +// Sandbox represents a network sandbox, identified by a specific key. It +// holds a list of Interfaces, routes etc, and more can be added dynamically. +type Sandbox interface { + // The path where the network namespace is mounted. + Key() string + + // Add an existing Interface to this sandbox. The operation will rename + // from the Interface SrcName to DstName as it moves, and reconfigure the + // interface according to the specified settings. The caller is expected + // to only provide a prefix for DstName. The AddInterface api will auto-generate + // an appropriate suffix for the DstName to disambiguate. + AddInterface(SrcName string, DstPrefix string, options ...IfaceOption) error + + // Set default IPv4 gateway for the sandbox + SetGateway(gw net.IP) error + + // Set default IPv6 gateway for the sandbox + SetGatewayIPv6(gw net.IP) error + + // Unset the previously set default IPv4 gateway in the sandbox + UnsetGateway() error + + // Unset the previously set default IPv6 gateway in the sandbox + UnsetGatewayIPv6() error + + // Add a static route to the sandbox. + AddStaticRoute(*types.StaticRoute) error + + // Remove a static route from the sandbox. + RemoveStaticRoute(*types.StaticRoute) error + + // AddNeighbor adds a neighbor entry into the sandbox. + AddNeighbor(dstIP net.IP, dstMac net.HardwareAddr, option ...NeighOption) error + + // DeleteNeighbor deletes neighbor entry from the sandbox. + DeleteNeighbor(dstIP net.IP, dstMac net.HardwareAddr) error + + // Returns an interface with methods to set neighbor options. + NeighborOptions() NeighborOptionSetter + + // Returns an interface with methods to set interface options. + InterfaceOptions() IfaceOptionSetter + + //Invoke + InvokeFunc(func()) error + + // Returns an interface with methods to get sandbox state. + Info() Info + + // Destroy the sandbox + Destroy() error +} + +// NeighborOptionSetter interfaces defines the option setter methods for interface options +type NeighborOptionSetter interface { + // LinkName returns an option setter to set the srcName of the link that should + // be used in the neighbor entry + LinkName(string) NeighOption + + // Family returns an option setter to set the address family for the neighbor + // entry. eg. AF_BRIDGE + Family(int) NeighOption +} + +// IfaceOptionSetter interface defines the option setter methods for interface options. +type IfaceOptionSetter interface { + // Bridge returns an option setter to set if the interface is a bridge. + Bridge(bool) IfaceOption + + // Address returns an option setter to set IPv4 address. + Address(*net.IPNet) IfaceOption + + // Address returns an option setter to set IPv6 address. + AddressIPv6(*net.IPNet) IfaceOption + + // Master returns an option setter to set the master interface if any for this + // interface. The master interface name should refer to the srcname of a + // previously added interface of type bridge. + Master(string) IfaceOption + + // Address returns an option setter to set interface routes. + Routes([]*net.IPNet) IfaceOption +} + +// Info represents all possible information that +// the driver wants to place in the sandbox which includes +// interfaces, routes and gateway +type Info interface { + // The collection of Interface previously added with the AddInterface + // method. Note that this doesn't incude network interfaces added in any + // other way (such as the default loopback interface which are automatically + // created on creation of a sandbox). + Interfaces() []Interface + + // IPv4 gateway for the sandbox. + Gateway() net.IP + + // IPv6 gateway for the sandbox. + GatewayIPv6() net.IP + + // Additional static routes for the sandbox. (Note that directly + // connected routes are stored on the particular interface they refer to.) + StaticRoutes() []*types.StaticRoute + + // TODO: Add ip tables etc. +} + +// Interface represents the settings and identity of a network device. It is +// used as a return type for Network.Link, and it is common practice for the +// caller to use this information when moving interface SrcName from host +// namespace to DstName in a different net namespace with the appropriate +// network settings. +type Interface interface { + // The name of the interface in the origin network namespace. + SrcName() string + + // The name that will be assigned to the interface once moves inside a + // network namespace. When the caller passes in a DstName, it is only + // expected to pass a prefix. The name will modified with an appropriately + // auto-generated suffix. + DstName() string + + // IPv4 address for the interface. + Address() *net.IPNet + + // IPv6 address for the interface. + AddressIPv6() *net.IPNet + + // IP routes for the interface. + Routes() []*net.IPNet + + // Bridge returns true if the interface is a bridge + Bridge() bool + + // Master returns the srcname of the master interface for this interface. + Master() string + + // Remove an interface from the sandbox by renaming to original name + // and moving it out of the sandbox. + Remove() error + + // Statistics returns the statistics for this interface + Statistics() (*types.InterfaceStatistics, error) +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/sandbox_freebsd.go b/vendor/src/github.com/docker/libnetwork/osl/sandbox_freebsd.go new file mode 100644 index 0000000000..36bd6c8002 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/sandbox_freebsd.go @@ -0,0 +1,35 @@ +package osl + +import "testing" + +// GenerateKey generates a sandbox key based on the passed +// container id. +func GenerateKey(containerID string) string { + maxLen := 12 + if len(containerID) < maxLen { + maxLen = len(containerID) + } + + return containerID[:maxLen] +} + +// NewSandbox provides a new sandbox instance created in an os specific way +// provided a key which uniquely identifies the sandbox +func NewSandbox(key string, osCreate bool) (Sandbox, error) { + return nil, nil +} + +// GC triggers garbage collection of namespace path right away +// and waits for it. +func GC() { +} + +// InitOSContext initializes OS context while configuring network resources +func InitOSContext() func() { + return func() {} +} + +// SetupTestOSContext sets up a separate test OS context in which tests will be executed. +func SetupTestOSContext(t *testing.T) func() { + return func() {} +} diff --git a/vendor/src/github.com/docker/libnetwork/osl/sandbox_unsupported.go b/vendor/src/github.com/docker/libnetwork/osl/sandbox_unsupported.go new file mode 100644 index 0000000000..3bc6c38500 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/osl/sandbox_unsupported.go @@ -0,0 +1,22 @@ +// +build !linux,!windows,!freebsd + +package osl + +import "errors" + +var ( + // ErrNotImplemented is for platforms which don't implement sandbox + ErrNotImplemented = errors.New("not implemented") +) + +// NewSandbox provides a new sandbox instance created in an os specific way +// provided a key which uniquely identifies the sandbox +func NewSandbox(key string, osCreate bool) (Sandbox, error) { + return nil, ErrNotImplemented +} + +// GenerateKey generates a sandbox key based on the passed +// container id. +func GenerateKey(containerID string) string { + return "" +} diff --git a/vendor/src/github.com/docker/libnetwork/portallocator/portallocator.go b/vendor/src/github.com/docker/libnetwork/portallocator/portallocator.go new file mode 100644 index 0000000000..240e94fc82 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/portallocator/portallocator.go @@ -0,0 +1,270 @@ +package portallocator + +import ( + "bufio" + "errors" + "fmt" + "net" + "os" + "sync" +) + +const ( + // DefaultPortRangeStart indicates the first port in port range + DefaultPortRangeStart = 49153 + // DefaultPortRangeEnd indicates the last port in port range + DefaultPortRangeEnd = 65535 +) + +type ipMapping map[string]protoMap + +var ( + // ErrAllPortsAllocated is returned when no more ports are available + ErrAllPortsAllocated = errors.New("all ports are allocated") + // ErrUnknownProtocol is returned when an unknown protocol was specified + ErrUnknownProtocol = errors.New("unknown protocol") + defaultIP = net.ParseIP("0.0.0.0") + once sync.Once + instance *PortAllocator + createInstance = func() { instance = newInstance() } +) + +// ErrPortAlreadyAllocated is the returned error information when a requested port is already being used +type ErrPortAlreadyAllocated struct { + ip string + port int +} + +func newErrPortAlreadyAllocated(ip string, port int) ErrPortAlreadyAllocated { + return ErrPortAlreadyAllocated{ + ip: ip, + port: port, + } +} + +// IP returns the address to which the used port is associated +func (e ErrPortAlreadyAllocated) IP() string { + return e.ip +} + +// Port returns the value of the already used port +func (e ErrPortAlreadyAllocated) Port() int { + return e.port +} + +// IPPort returns the address and the port in the form ip:port +func (e ErrPortAlreadyAllocated) IPPort() string { + return fmt.Sprintf("%s:%d", e.ip, e.port) +} + +// Error is the implementation of error.Error interface +func (e ErrPortAlreadyAllocated) Error() string { + return fmt.Sprintf("Bind for %s:%d failed: port is already allocated", e.ip, e.port) +} + +type ( + // PortAllocator manages the transport ports database + PortAllocator struct { + mutex sync.Mutex + ipMap ipMapping + Begin int + End int + } + portRange struct { + begin int + end int + last int + } + portMap struct { + p map[int]struct{} + defaultRange string + portRanges map[string]*portRange + } + protoMap map[string]*portMap +) + +// Get returns the default instance of PortAllocator +func Get() *PortAllocator { + // Port Allocator is a singleton + // Note: Long term solution will be each PortAllocator will have access to + // the OS so that it can have up to date view of the OS port allocation. + // When this happens singleton behavior will be removed. Clients do not + // need to worry about this, they will not see a change in behavior. + once.Do(createInstance) + return instance +} + +func newInstance() *PortAllocator { + start, end, err := getDynamicPortRange() + if err != nil { + start, end = DefaultPortRangeStart, DefaultPortRangeEnd + } + return &PortAllocator{ + ipMap: ipMapping{}, + Begin: start, + End: end, + } +} + +func getDynamicPortRange() (start int, end int, err error) { + const portRangeKernelParam = "/proc/sys/net/ipv4/ip_local_port_range" + portRangeFallback := fmt.Sprintf("using fallback port range %d-%d", DefaultPortRangeStart, DefaultPortRangeEnd) + file, err := os.Open(portRangeKernelParam) + if err != nil { + return 0, 0, fmt.Errorf("port allocator - %s due to error: %v", portRangeFallback, err) + } + + defer file.Close() + + n, err := fmt.Fscanf(bufio.NewReader(file), "%d\t%d", &start, &end) + if n != 2 || err != nil { + if err == nil { + err = fmt.Errorf("unexpected count of parsed numbers (%d)", n) + } + return 0, 0, fmt.Errorf("port allocator - failed to parse system ephemeral port range from %s - %s: %v", portRangeKernelParam, portRangeFallback, err) + } + return start, end, nil +} + +// RequestPort requests new port from global ports pool for specified ip and proto. +// If port is 0 it returns first free port. Otherwise it checks port availability +// in proto's pool and returns that port or error if port is already busy. +func (p *PortAllocator) RequestPort(ip net.IP, proto string, port int) (int, error) { + return p.RequestPortInRange(ip, proto, port, port) +} + +// RequestPortInRange requests new port from global ports pool for specified ip and proto. +// If portStart and portEnd are 0 it returns the first free port in the default ephemeral range. +// If portStart != portEnd it returns the first free port in the requested range. +// Otherwise (portStart == portEnd) it checks port availability in the requested proto's port-pool +// and returns that port or error if port is already busy. +func (p *PortAllocator) RequestPortInRange(ip net.IP, proto string, portStart, portEnd int) (int, error) { + p.mutex.Lock() + defer p.mutex.Unlock() + + if proto != "tcp" && proto != "udp" { + return 0, ErrUnknownProtocol + } + + if ip == nil { + ip = defaultIP + } + ipstr := ip.String() + protomap, ok := p.ipMap[ipstr] + if !ok { + protomap = protoMap{ + "tcp": p.newPortMap(), + "udp": p.newPortMap(), + } + + p.ipMap[ipstr] = protomap + } + mapping := protomap[proto] + if portStart > 0 && portStart == portEnd { + if _, ok := mapping.p[portStart]; !ok { + mapping.p[portStart] = struct{}{} + return portStart, nil + } + return 0, newErrPortAlreadyAllocated(ipstr, portStart) + } + + port, err := mapping.findPort(portStart, portEnd) + if err != nil { + return 0, err + } + return port, nil +} + +// ReleasePort releases port from global ports pool for specified ip and proto. +func (p *PortAllocator) ReleasePort(ip net.IP, proto string, port int) error { + p.mutex.Lock() + defer p.mutex.Unlock() + + if ip == nil { + ip = defaultIP + } + protomap, ok := p.ipMap[ip.String()] + if !ok { + return nil + } + delete(protomap[proto].p, port) + return nil +} + +func (p *PortAllocator) newPortMap() *portMap { + defaultKey := getRangeKey(p.Begin, p.End) + pm := &portMap{ + p: map[int]struct{}{}, + defaultRange: defaultKey, + portRanges: map[string]*portRange{ + defaultKey: newPortRange(p.Begin, p.End), + }, + } + return pm +} + +// ReleaseAll releases all ports for all ips. +func (p *PortAllocator) ReleaseAll() error { + p.mutex.Lock() + p.ipMap = ipMapping{} + p.mutex.Unlock() + return nil +} + +func getRangeKey(portStart, portEnd int) string { + return fmt.Sprintf("%d-%d", portStart, portEnd) +} + +func newPortRange(portStart, portEnd int) *portRange { + return &portRange{ + begin: portStart, + end: portEnd, + last: portEnd, + } +} + +func (pm *portMap) getPortRange(portStart, portEnd int) (*portRange, error) { + var key string + if portStart == 0 && portEnd == 0 { + key = pm.defaultRange + } else { + key = getRangeKey(portStart, portEnd) + if portStart == portEnd || + portStart == 0 || portEnd == 0 || + portEnd < portStart { + return nil, fmt.Errorf("invalid port range: %s", key) + } + } + + // Return existing port range, if already known. + if pr, exists := pm.portRanges[key]; exists { + return pr, nil + } + + // Otherwise create a new port range. + pr := newPortRange(portStart, portEnd) + pm.portRanges[key] = pr + return pr, nil +} + +func (pm *portMap) findPort(portStart, portEnd int) (int, error) { + pr, err := pm.getPortRange(portStart, portEnd) + if err != nil { + return 0, err + } + port := pr.last + + for i := 0; i <= pr.end-pr.begin; i++ { + port++ + if port > pr.end { + port = pr.begin + } + + if _, ok := pm.p[port]; !ok { + pm.p[port] = struct{}{} + pr.last = port + return port, nil + } + } + return 0, ErrAllPortsAllocated +} diff --git a/vendor/src/github.com/docker/libnetwork/portmapper/mapper.go b/vendor/src/github.com/docker/libnetwork/portmapper/mapper.go new file mode 100644 index 0000000000..d125fa8d4b --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/portmapper/mapper.go @@ -0,0 +1,228 @@ +package portmapper + +import ( + "errors" + "fmt" + "net" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/iptables" + "github.com/docker/libnetwork/portallocator" +) + +type mapping struct { + proto string + userlandProxy userlandProxy + host net.Addr + container net.Addr +} + +var newProxy = newProxyCommand + +var ( + // ErrUnknownBackendAddressType refers to an unknown container or unsupported address type + ErrUnknownBackendAddressType = errors.New("unknown container address type not supported") + // ErrPortMappedForIP refers to a port already mapped to an ip address + ErrPortMappedForIP = errors.New("port is already mapped to ip") + // ErrPortNotMapped refers to an unmapped port + ErrPortNotMapped = errors.New("port is not mapped") +) + +// PortMapper manages the network address translation +type PortMapper struct { + chain *iptables.ChainInfo + bridgeName string + + // udp:ip:port + currentMappings map[string]*mapping + lock sync.Mutex + + Allocator *portallocator.PortAllocator +} + +// New returns a new instance of PortMapper +func New() *PortMapper { + return NewWithPortAllocator(portallocator.Get()) +} + +// NewWithPortAllocator returns a new instance of PortMapper which will use the specified PortAllocator +func NewWithPortAllocator(allocator *portallocator.PortAllocator) *PortMapper { + return &PortMapper{ + currentMappings: make(map[string]*mapping), + Allocator: allocator, + } +} + +// SetIptablesChain sets the specified chain into portmapper +func (pm *PortMapper) SetIptablesChain(c *iptables.ChainInfo, bridgeName string) { + pm.chain = c + pm.bridgeName = bridgeName +} + +// Map maps the specified container transport address to the host's network address and transport port +func (pm *PortMapper) Map(container net.Addr, hostIP net.IP, hostPort int, useProxy bool) (host net.Addr, err error) { + return pm.MapRange(container, hostIP, hostPort, hostPort, useProxy) +} + +// MapRange maps the specified container transport address to the host's network address and transport port range +func (pm *PortMapper) MapRange(container net.Addr, hostIP net.IP, hostPortStart, hostPortEnd int, useProxy bool) (host net.Addr, err error) { + pm.lock.Lock() + defer pm.lock.Unlock() + + var ( + m *mapping + proto string + allocatedHostPort int + ) + + switch container.(type) { + case *net.TCPAddr: + proto = "tcp" + if allocatedHostPort, err = pm.Allocator.RequestPortInRange(hostIP, proto, hostPortStart, hostPortEnd); err != nil { + return nil, err + } + + m = &mapping{ + proto: proto, + host: &net.TCPAddr{IP: hostIP, Port: allocatedHostPort}, + container: container, + } + + if useProxy { + m.userlandProxy = newProxy(proto, hostIP, allocatedHostPort, container.(*net.TCPAddr).IP, container.(*net.TCPAddr).Port) + } else { + m.userlandProxy = newDummyProxy(proto, hostIP, allocatedHostPort) + } + case *net.UDPAddr: + proto = "udp" + if allocatedHostPort, err = pm.Allocator.RequestPortInRange(hostIP, proto, hostPortStart, hostPortEnd); err != nil { + return nil, err + } + + m = &mapping{ + proto: proto, + host: &net.UDPAddr{IP: hostIP, Port: allocatedHostPort}, + container: container, + } + + if useProxy { + m.userlandProxy = newProxy(proto, hostIP, allocatedHostPort, container.(*net.UDPAddr).IP, container.(*net.UDPAddr).Port) + } else { + m.userlandProxy = newDummyProxy(proto, hostIP, allocatedHostPort) + } + default: + return nil, ErrUnknownBackendAddressType + } + + // release the allocated port on any further error during return. + defer func() { + if err != nil { + pm.Allocator.ReleasePort(hostIP, proto, allocatedHostPort) + } + }() + + key := getKey(m.host) + if _, exists := pm.currentMappings[key]; exists { + return nil, ErrPortMappedForIP + } + + containerIP, containerPort := getIPAndPort(m.container) + if err := pm.forward(iptables.Append, m.proto, hostIP, allocatedHostPort, containerIP.String(), containerPort); err != nil { + return nil, err + } + + cleanup := func() error { + // need to undo the iptables rules before we return + m.userlandProxy.Stop() + pm.forward(iptables.Delete, m.proto, hostIP, allocatedHostPort, containerIP.String(), containerPort) + if err := pm.Allocator.ReleasePort(hostIP, m.proto, allocatedHostPort); err != nil { + return err + } + + return nil + } + + if err := m.userlandProxy.Start(); err != nil { + if err := cleanup(); err != nil { + return nil, fmt.Errorf("Error during port allocation cleanup: %v", err) + } + return nil, err + } + + pm.currentMappings[key] = m + return m.host, nil +} + +// Unmap removes stored mapping for the specified host transport address +func (pm *PortMapper) Unmap(host net.Addr) error { + pm.lock.Lock() + defer pm.lock.Unlock() + + key := getKey(host) + data, exists := pm.currentMappings[key] + if !exists { + return ErrPortNotMapped + } + + if data.userlandProxy != nil { + data.userlandProxy.Stop() + } + + delete(pm.currentMappings, key) + + containerIP, containerPort := getIPAndPort(data.container) + hostIP, hostPort := getIPAndPort(data.host) + if err := pm.forward(iptables.Delete, data.proto, hostIP, hostPort, containerIP.String(), containerPort); err != nil { + logrus.Errorf("Error on iptables delete: %s", err) + } + + switch a := host.(type) { + case *net.TCPAddr: + return pm.Allocator.ReleasePort(a.IP, "tcp", a.Port) + case *net.UDPAddr: + return pm.Allocator.ReleasePort(a.IP, "udp", a.Port) + } + return nil +} + +//ReMapAll will re-apply all port mappings +func (pm *PortMapper) ReMapAll() { + pm.lock.Lock() + defer pm.lock.Unlock() + logrus.Debugln("Re-applying all port mappings.") + for _, data := range pm.currentMappings { + containerIP, containerPort := getIPAndPort(data.container) + hostIP, hostPort := getIPAndPort(data.host) + if err := pm.forward(iptables.Append, data.proto, hostIP, hostPort, containerIP.String(), containerPort); err != nil { + logrus.Errorf("Error on iptables add: %s", err) + } + } +} + +func getKey(a net.Addr) string { + switch t := a.(type) { + case *net.TCPAddr: + return fmt.Sprintf("%s:%d/%s", t.IP.String(), t.Port, "tcp") + case *net.UDPAddr: + return fmt.Sprintf("%s:%d/%s", t.IP.String(), t.Port, "udp") + } + return "" +} + +func getIPAndPort(a net.Addr) (net.IP, int) { + switch t := a.(type) { + case *net.TCPAddr: + return t.IP, t.Port + case *net.UDPAddr: + return t.IP, t.Port + } + return nil, 0 +} + +func (pm *PortMapper) forward(action iptables.Action, proto string, sourceIP net.IP, sourcePort int, containerIP string, containerPort int) error { + if pm.chain == nil { + return nil + } + return pm.chain.Forward(action, sourceIP, sourcePort, proto, containerIP, containerPort, pm.bridgeName) +} diff --git a/vendor/src/github.com/docker/libnetwork/portmapper/mock_proxy.go b/vendor/src/github.com/docker/libnetwork/portmapper/mock_proxy.go new file mode 100644 index 0000000000..29b1605889 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/portmapper/mock_proxy.go @@ -0,0 +1,18 @@ +package portmapper + +import "net" + +func newMockProxyCommand(proto string, hostIP net.IP, hostPort int, containerIP net.IP, containerPort int) userlandProxy { + return &mockProxyCommand{} +} + +type mockProxyCommand struct { +} + +func (p *mockProxyCommand) Start() error { + return nil +} + +func (p *mockProxyCommand) Stop() error { + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/portmapper/proxy.go b/vendor/src/github.com/docker/libnetwork/portmapper/proxy.go new file mode 100644 index 0000000000..530703b259 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/portmapper/proxy.go @@ -0,0 +1,209 @@ +package portmapper + +import ( + "flag" + "fmt" + "io" + "io/ioutil" + "log" + "net" + "os" + "os/exec" + "os/signal" + "strconv" + "syscall" + "time" + + "github.com/docker/docker/pkg/proxy" + "github.com/docker/docker/pkg/reexec" +) + +const userlandProxyCommandName = "docker-proxy" + +func init() { + reexec.Register(userlandProxyCommandName, execProxy) +} + +type userlandProxy interface { + Start() error + Stop() error +} + +// proxyCommand wraps an exec.Cmd to run the userland TCP and UDP +// proxies as separate processes. +type proxyCommand struct { + cmd *exec.Cmd +} + +// execProxy is the reexec function that is registered to start the userland proxies +func execProxy() { + f := os.NewFile(3, "signal-parent") + host, container := parseHostContainerAddrs() + + p, err := proxy.NewProxy(host, container) + if err != nil { + fmt.Fprintf(f, "1\n%s", err) + f.Close() + os.Exit(1) + } + go handleStopSignals(p) + fmt.Fprint(f, "0\n") + f.Close() + + // Run will block until the proxy stops + p.Run() +} + +// parseHostContainerAddrs parses the flags passed on reexec to create the TCP or UDP +// net.Addrs to map the host and container ports +func parseHostContainerAddrs() (host net.Addr, container net.Addr) { + var ( + proto = flag.String("proto", "tcp", "proxy protocol") + hostIP = flag.String("host-ip", "", "host ip") + hostPort = flag.Int("host-port", -1, "host port") + containerIP = flag.String("container-ip", "", "container ip") + containerPort = flag.Int("container-port", -1, "container port") + ) + + flag.Parse() + + switch *proto { + case "tcp": + host = &net.TCPAddr{IP: net.ParseIP(*hostIP), Port: *hostPort} + container = &net.TCPAddr{IP: net.ParseIP(*containerIP), Port: *containerPort} + case "udp": + host = &net.UDPAddr{IP: net.ParseIP(*hostIP), Port: *hostPort} + container = &net.UDPAddr{IP: net.ParseIP(*containerIP), Port: *containerPort} + default: + log.Fatalf("unsupported protocol %s", *proto) + } + + return host, container +} + +func handleStopSignals(p proxy.Proxy) { + s := make(chan os.Signal, 10) + signal.Notify(s, os.Interrupt, syscall.SIGTERM, syscall.SIGSTOP) + + for _ = range s { + p.Close() + + os.Exit(0) + } +} + +func newProxyCommand(proto string, hostIP net.IP, hostPort int, containerIP net.IP, containerPort int) userlandProxy { + args := []string{ + userlandProxyCommandName, + "-proto", proto, + "-host-ip", hostIP.String(), + "-host-port", strconv.Itoa(hostPort), + "-container-ip", containerIP.String(), + "-container-port", strconv.Itoa(containerPort), + } + + return &proxyCommand{ + cmd: &exec.Cmd{ + Path: reexec.Self(), + Args: args, + SysProcAttr: &syscall.SysProcAttr{ + Pdeathsig: syscall.SIGTERM, // send a sigterm to the proxy if the daemon process dies + }, + }, + } +} + +func (p *proxyCommand) Start() error { + r, w, err := os.Pipe() + if err != nil { + return fmt.Errorf("proxy unable to open os.Pipe %s", err) + } + defer r.Close() + p.cmd.ExtraFiles = []*os.File{w} + if err := p.cmd.Start(); err != nil { + return err + } + w.Close() + + errchan := make(chan error, 1) + go func() { + buf := make([]byte, 2) + r.Read(buf) + + if string(buf) != "0\n" { + errStr, err := ioutil.ReadAll(r) + if err != nil { + errchan <- fmt.Errorf("Error reading exit status from userland proxy: %v", err) + return + } + + errchan <- fmt.Errorf("Error starting userland proxy: %s", errStr) + return + } + errchan <- nil + }() + + select { + case err := <-errchan: + return err + case <-time.After(16 * time.Second): + return fmt.Errorf("Timed out proxy starting the userland proxy") + } +} + +func (p *proxyCommand) Stop() error { + if p.cmd.Process != nil { + if err := p.cmd.Process.Signal(os.Interrupt); err != nil { + return err + } + return p.cmd.Wait() + } + return nil +} + +// dummyProxy just listen on some port, it is needed to prevent accidental +// port allocations on bound port, because without userland proxy we using +// iptables rules and not net.Listen +type dummyProxy struct { + listener io.Closer + addr net.Addr +} + +func newDummyProxy(proto string, hostIP net.IP, hostPort int) userlandProxy { + switch proto { + case "tcp": + addr := &net.TCPAddr{IP: hostIP, Port: hostPort} + return &dummyProxy{addr: addr} + case "udp": + addr := &net.UDPAddr{IP: hostIP, Port: hostPort} + return &dummyProxy{addr: addr} + } + return nil +} + +func (p *dummyProxy) Start() error { + switch addr := p.addr.(type) { + case *net.TCPAddr: + l, err := net.ListenTCP("tcp", addr) + if err != nil { + return err + } + p.listener = l + case *net.UDPAddr: + l, err := net.ListenUDP("udp", addr) + if err != nil { + return err + } + p.listener = l + default: + return fmt.Errorf("Unknown addr type: %T", p.addr) + } + return nil +} + +func (p *dummyProxy) Stop() error { + if p.listener != nil { + return p.listener.Close() + } + return nil +} diff --git a/vendor/src/github.com/docker/libnetwork/resolvconf/README.md b/vendor/src/github.com/docker/libnetwork/resolvconf/README.md new file mode 100644 index 0000000000..cdda554ba5 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/resolvconf/README.md @@ -0,0 +1 @@ +Package resolvconf provides utility code to query and update DNS configuration in /etc/resolv.conf diff --git a/vendor/src/github.com/docker/libnetwork/resolvconf/dns/resolvconf.go b/vendor/src/github.com/docker/libnetwork/resolvconf/dns/resolvconf.go new file mode 100644 index 0000000000..f981b1fc85 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/resolvconf/dns/resolvconf.go @@ -0,0 +1,17 @@ +package dns + +import ( + "regexp" +) + +// IPLocalhost is a regex patter for localhost IP address range. +const IPLocalhost = `((127\.([0-9]{1,3}\.){2}[0-9]{1,3})|(::1))` + +var localhostIPRegexp = regexp.MustCompile(IPLocalhost) + +// IsLocalhost returns true if ip matches the localhost IP regular expression. +// Used for determining if nameserver settings are being passed which are +// localhost addresses +func IsLocalhost(ip string) bool { + return localhostIPRegexp.MatchString(ip) +} diff --git a/vendor/src/github.com/docker/libnetwork/resolvconf/resolvconf.go b/vendor/src/github.com/docker/libnetwork/resolvconf/resolvconf.go new file mode 100644 index 0000000000..d5169ada35 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/resolvconf/resolvconf.go @@ -0,0 +1,237 @@ +// Package resolvconf provides utility code to query and update DNS configuration in /etc/resolv.conf +package resolvconf + +import ( + "bytes" + "io/ioutil" + "regexp" + "strings" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/libnetwork/resolvconf/dns" +) + +var ( + // Note: the default IPv4 & IPv6 resolvers are set to Google's Public DNS + defaultIPv4Dns = []string{"nameserver 8.8.8.8", "nameserver 8.8.4.4"} + defaultIPv6Dns = []string{"nameserver 2001:4860:4860::8888", "nameserver 2001:4860:4860::8844"} + ipv4NumBlock = `(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)` + ipv4Address = `(` + ipv4NumBlock + `\.){3}` + ipv4NumBlock + // This is not an IPv6 address verifier as it will accept a super-set of IPv6, and also + // will *not match* IPv4-Embedded IPv6 Addresses (RFC6052), but that and other variants + // -- e.g. other link-local types -- either won't work in containers or are unnecessary. + // For readability and sufficiency for Docker purposes this seemed more reasonable than a + // 1000+ character regexp with exact and complete IPv6 validation + ipv6Address = `([0-9A-Fa-f]{0,4}:){2,7}([0-9A-Fa-f]{0,4})` + + localhostNSRegexp = regexp.MustCompile(`(?m)^nameserver\s+` + dns.IPLocalhost + `\s*\n*`) + nsIPv6Regexp = regexp.MustCompile(`(?m)^nameserver\s+` + ipv6Address + `\s*\n*`) + nsRegexp = regexp.MustCompile(`^\s*nameserver\s*((` + ipv4Address + `)|(` + ipv6Address + `))\s*$`) + searchRegexp = regexp.MustCompile(`^\s*search\s*(([^\s]+\s*)*)$`) + optionsRegexp = regexp.MustCompile(`^\s*options\s*(([^\s]+\s*)*)$`) +) + +var lastModified struct { + sync.Mutex + sha256 string + contents []byte +} + +// File contains the resolv.conf content and its hash +type File struct { + Content []byte + Hash string +} + +// Get returns the contents of /etc/resolv.conf and its hash +func Get() (*File, error) { + resolv, err := ioutil.ReadFile("/etc/resolv.conf") + if err != nil { + return nil, err + } + hash, err := ioutils.HashData(bytes.NewReader(resolv)) + if err != nil { + return nil, err + } + return &File{Content: resolv, Hash: hash}, nil +} + +// GetSpecific returns the contents of the user specified resolv.conf file and its hash +func GetSpecific(path string) (*File, error) { + resolv, err := ioutil.ReadFile(path) + if err != nil { + return nil, err + } + hash, err := ioutils.HashData(bytes.NewReader(resolv)) + if err != nil { + return nil, err + } + return &File{Content: resolv, Hash: hash}, nil +} + +// GetIfChanged retrieves the host /etc/resolv.conf file, checks against the last hash +// and, if modified since last check, returns the bytes and new hash. +// This feature is used by the resolv.conf updater for containers +func GetIfChanged() (*File, error) { + lastModified.Lock() + defer lastModified.Unlock() + + resolv, err := ioutil.ReadFile("/etc/resolv.conf") + if err != nil { + return nil, err + } + newHash, err := ioutils.HashData(bytes.NewReader(resolv)) + if err != nil { + return nil, err + } + if lastModified.sha256 != newHash { + lastModified.sha256 = newHash + lastModified.contents = resolv + return &File{Content: resolv, Hash: newHash}, nil + } + // nothing changed, so return no data + return nil, nil +} + +// GetLastModified retrieves the last used contents and hash of the host resolv.conf. +// Used by containers updating on restart +func GetLastModified() *File { + lastModified.Lock() + defer lastModified.Unlock() + + return &File{Content: lastModified.contents, Hash: lastModified.sha256} +} + +// FilterResolvDNS cleans up the config in resolvConf. It has two main jobs: +// 1. It looks for localhost (127.*|::1) entries in the provided +// resolv.conf, removing local nameserver entries, and, if the resulting +// cleaned config has no defined nameservers left, adds default DNS entries +// 2. Given the caller provides the enable/disable state of IPv6, the filter +// code will remove all IPv6 nameservers if it is not enabled for containers +// +func FilterResolvDNS(resolvConf []byte, ipv6Enabled bool) (*File, error) { + cleanedResolvConf := localhostNSRegexp.ReplaceAll(resolvConf, []byte{}) + // if IPv6 is not enabled, also clean out any IPv6 address nameserver + if !ipv6Enabled { + cleanedResolvConf = nsIPv6Regexp.ReplaceAll(cleanedResolvConf, []byte{}) + } + // if the resulting resolvConf has no more nameservers defined, add appropriate + // default DNS servers for IPv4 and (optionally) IPv6 + if len(GetNameservers(cleanedResolvConf)) == 0 { + logrus.Infof("No non-localhost DNS nameservers are left in resolv.conf. Using default external servers : %v", defaultIPv4Dns) + dns := defaultIPv4Dns + if ipv6Enabled { + logrus.Infof("IPv6 enabled; Adding default IPv6 external servers : %v", defaultIPv6Dns) + dns = append(dns, defaultIPv6Dns...) + } + cleanedResolvConf = append(cleanedResolvConf, []byte("\n"+strings.Join(dns, "\n"))...) + } + hash, err := ioutils.HashData(bytes.NewReader(cleanedResolvConf)) + if err != nil { + return nil, err + } + return &File{Content: cleanedResolvConf, Hash: hash}, nil +} + +// getLines parses input into lines and strips away comments. +func getLines(input []byte, commentMarker []byte) [][]byte { + lines := bytes.Split(input, []byte("\n")) + var output [][]byte + for _, currentLine := range lines { + var commentIndex = bytes.Index(currentLine, commentMarker) + if commentIndex == -1 { + output = append(output, currentLine) + } else { + output = append(output, currentLine[:commentIndex]) + } + } + return output +} + +// GetNameservers returns nameservers (if any) listed in /etc/resolv.conf +func GetNameservers(resolvConf []byte) []string { + nameservers := []string{} + for _, line := range getLines(resolvConf, []byte("#")) { + var ns = nsRegexp.FindSubmatch(line) + if len(ns) > 0 { + nameservers = append(nameservers, string(ns[1])) + } + } + return nameservers +} + +// GetNameserversAsCIDR returns nameservers (if any) listed in +// /etc/resolv.conf as CIDR blocks (e.g., "1.2.3.4/32") +// This function's output is intended for net.ParseCIDR +func GetNameserversAsCIDR(resolvConf []byte) []string { + nameservers := []string{} + for _, nameserver := range GetNameservers(resolvConf) { + nameservers = append(nameservers, nameserver+"/32") + } + return nameservers +} + +// GetSearchDomains returns search domains (if any) listed in /etc/resolv.conf +// If more than one search line is encountered, only the contents of the last +// one is returned. +func GetSearchDomains(resolvConf []byte) []string { + domains := []string{} + for _, line := range getLines(resolvConf, []byte("#")) { + match := searchRegexp.FindSubmatch(line) + if match == nil { + continue + } + domains = strings.Fields(string(match[1])) + } + return domains +} + +// GetOptions returns options (if any) listed in /etc/resolv.conf +// If more than one options line is encountered, only the contents of the last +// one is returned. +func GetOptions(resolvConf []byte) []string { + options := []string{} + for _, line := range getLines(resolvConf, []byte("#")) { + match := optionsRegexp.FindSubmatch(line) + if match == nil { + continue + } + options = strings.Fields(string(match[1])) + } + return options +} + +// Build writes a configuration file to path containing a "nameserver" entry +// for every element in dns, a "search" entry for every element in +// dnsSearch, and an "options" entry for every element in dnsOptions. +func Build(path string, dns, dnsSearch, dnsOptions []string) (*File, error) { + content := bytes.NewBuffer(nil) + if len(dnsSearch) > 0 { + if searchString := strings.Join(dnsSearch, " "); strings.Trim(searchString, " ") != "." { + if _, err := content.WriteString("search " + searchString + "\n"); err != nil { + return nil, err + } + } + } + for _, dns := range dns { + if _, err := content.WriteString("nameserver " + dns + "\n"); err != nil { + return nil, err + } + } + if len(dnsOptions) > 0 { + if optsString := strings.Join(dnsOptions, " "); strings.Trim(optsString, " ") != "" { + if _, err := content.WriteString("options " + optsString + "\n"); err != nil { + return nil, err + } + } + } + + hash, err := ioutils.HashData(bytes.NewReader(content.Bytes())) + if err != nil { + return nil, err + } + + return &File{Content: content.Bytes(), Hash: hash}, ioutil.WriteFile(path, content.Bytes(), 0644) +} diff --git a/vendor/src/github.com/docker/libnetwork/sandbox.go b/vendor/src/github.com/docker/libnetwork/sandbox.go new file mode 100644 index 0000000000..d24c43a460 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/sandbox.go @@ -0,0 +1,1019 @@ +package libnetwork + +import ( + "container/heap" + "encoding/json" + "fmt" + "io/ioutil" + "os" + "path" + "path/filepath" + "sync" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/etchosts" + "github.com/docker/libnetwork/osl" + "github.com/docker/libnetwork/resolvconf" + "github.com/docker/libnetwork/types" +) + +// Sandbox provides the control over the network container entity. It is a one to one mapping with the container. +type Sandbox interface { + // ID returns the ID of the sandbox + ID() string + // Key returns the sandbox's key + Key() string + // ContainerID returns the container id associated to this sandbox + ContainerID() string + // Labels returns the sandbox's labels + Labels() map[string]interface{} + // Statistics retrieves the interfaces' statistics for the sandbox + Statistics() (map[string]*types.InterfaceStatistics, error) + // Refresh leaves all the endpoints, resets and re-apply the options, + // re-joins all the endpoints without destroying the osl sandbox + Refresh(options ...SandboxOption) error + // SetKey updates the Sandbox Key + SetKey(key string) error + // Rename changes the name of all attached Endpoints + Rename(name string) error + // Delete destroys this container after detaching it from all connected endpoints. + Delete() error +} + +// SandboxOption is a option setter function type used to pass varios options to +// NewNetContainer method. The various setter functions of type SandboxOption are +// provided by libnetwork, they look like ContainerOptionXXXX(...) +type SandboxOption func(sb *sandbox) + +func (sb *sandbox) processOptions(options ...SandboxOption) { + for _, opt := range options { + if opt != nil { + opt(sb) + } + } +} + +type epHeap []*endpoint + +type sandbox struct { + id string + containerID string + config containerConfig + osSbox osl.Sandbox + controller *controller + refCnt int + endpoints epHeap + epPriority map[string]int + joinLeaveDone chan struct{} + dbIndex uint64 + dbExists bool + isStub bool + inDelete bool + sync.Mutex +} + +// These are the container configs used to customize container /etc/hosts file. +type hostsPathConfig struct { + hostName string + domainName string + hostsPath string + originHostsPath string + extraHosts []extraHost + parentUpdates []parentUpdate +} + +type parentUpdate struct { + cid string + name string + ip string +} + +type extraHost struct { + name string + IP string +} + +// These are the container configs used to customize container /etc/resolv.conf file. +type resolvConfPathConfig struct { + resolvConfPath string + originResolvConfPath string + resolvConfHashFile string + dnsList []string + dnsSearchList []string + dnsOptionsList []string +} + +type containerConfig struct { + hostsPathConfig + resolvConfPathConfig + generic map[string]interface{} + useDefaultSandBox bool + useExternalKey bool + prio int // higher the value, more the priority +} + +func (sb *sandbox) ID() string { + return sb.id +} + +func (sb *sandbox) ContainerID() string { + return sb.containerID +} + +func (sb *sandbox) Key() string { + if sb.config.useDefaultSandBox { + return osl.GenerateKey("default") + } + return osl.GenerateKey(sb.id) +} + +func (sb *sandbox) Labels() map[string]interface{} { + return sb.config.generic +} + +func (sb *sandbox) Statistics() (map[string]*types.InterfaceStatistics, error) { + m := make(map[string]*types.InterfaceStatistics) + + if sb.osSbox == nil { + return m, nil + } + + var err error + for _, i := range sb.osSbox.Info().Interfaces() { + if m[i.DstName()], err = i.Statistics(); err != nil { + return m, err + } + } + + return m, nil +} + +func (sb *sandbox) Delete() error { + sb.Lock() + if sb.inDelete { + sb.Unlock() + return types.ForbiddenErrorf("another sandbox delete in progress") + } + // Set the inDelete flag. This will ensure that we don't + // update the store until we have completed all the endpoint + // leaves and deletes. And when endpoint leaves and deletes + // are completed then we can finally delete the sandbox object + // altogether from the data store. If the daemon exits + // ungracefully in the middle of a sandbox delete this way we + // will have all the references to the endpoints in the + // sandbox so that we can clean them up when we restart + sb.inDelete = true + sb.Unlock() + + c := sb.controller + + // Detach from all endpoints + retain := false + for _, ep := range sb.getConnectedEndpoints() { + // endpoint in the Gateway network will be cleaned up + // when when sandbox no longer needs external connectivity + if ep.endpointInGWNetwork() { + continue + } + + // Retain the sanbdox if we can't obtain the network from store. + if _, err := c.getNetworkFromStore(ep.getNetwork().ID()); err != nil { + retain = true + log.Warnf("Failed getting network for ep %s during sandbox %s delete: %v", ep.ID(), sb.ID(), err) + continue + } + + if err := ep.Leave(sb); err != nil { + log.Warnf("Failed detaching sandbox %s from endpoint %s: %v\n", sb.ID(), ep.ID(), err) + } + + if err := ep.Delete(); err != nil { + log.Warnf("Failed deleting endpoint %s: %v\n", ep.ID(), err) + } + } + + if retain { + sb.Lock() + sb.inDelete = false + sb.Unlock() + return fmt.Errorf("could not cleanup all the endpoints in container %s / sandbox %s", sb.containerID, sb.id) + } + // Container is going away. Path cache in etchosts is most + // likely not required any more. Drop it. + etchosts.Drop(sb.config.hostsPath) + + if sb.osSbox != nil && !sb.config.useDefaultSandBox { + sb.osSbox.Destroy() + } + + if err := sb.storeDelete(); err != nil { + log.Warnf("Failed to delete sandbox %s from store: %v", sb.ID(), err) + } + + c.Lock() + delete(c.sandboxes, sb.ID()) + c.Unlock() + + return nil +} + +func (sb *sandbox) Rename(name string) error { + var err error + + for _, ep := range sb.getConnectedEndpoints() { + if ep.endpointInGWNetwork() { + continue + } + + oldName := ep.Name() + lEp := ep + if err = ep.rename(name); err != nil { + break + } + + defer func() { + if err != nil { + lEp.rename(oldName) + } + }() + } + + return err +} + +func (sb *sandbox) Refresh(options ...SandboxOption) error { + // Store connected endpoints + epList := sb.getConnectedEndpoints() + + // Detach from all endpoints + for _, ep := range epList { + if err := ep.Leave(sb); err != nil { + log.Warnf("Failed detaching sandbox %s from endpoint %s: %v\n", sb.ID(), ep.ID(), err) + } + } + + // Re-apply options + sb.config = containerConfig{} + sb.processOptions(options...) + + // Setup discovery files + if err := sb.setupResolutionFiles(); err != nil { + return err + } + + // Re -connect to all endpoints + for _, ep := range epList { + if err := ep.Join(sb); err != nil { + log.Warnf("Failed attach sandbox %s to endpoint %s: %v\n", sb.ID(), ep.ID(), err) + } + } + + return nil +} + +func (sb *sandbox) MarshalJSON() ([]byte, error) { + sb.Lock() + defer sb.Unlock() + + // We are just interested in the container ID. This can be expanded to include all of containerInfo if there is a need + return json.Marshal(sb.id) +} + +func (sb *sandbox) UnmarshalJSON(b []byte) (err error) { + sb.Lock() + defer sb.Unlock() + + var id string + if err := json.Unmarshal(b, &id); err != nil { + return err + } + sb.id = id + return nil +} + +func (sb *sandbox) setupResolutionFiles() error { + if err := sb.buildHostsFile(); err != nil { + return err + } + + if err := sb.updateParentHosts(); err != nil { + return err + } + + if err := sb.setupDNS(); err != nil { + return err + } + + return nil +} + +func (sb *sandbox) getConnectedEndpoints() []*endpoint { + sb.Lock() + defer sb.Unlock() + + eps := make([]*endpoint, len(sb.endpoints)) + for i, ep := range sb.endpoints { + eps[i] = ep + } + + return eps +} + +func (sb *sandbox) getEndpoint(id string) *endpoint { + sb.Lock() + defer sb.Unlock() + + for _, ep := range sb.endpoints { + if ep.id == id { + return ep + } + } + + return nil +} + +func (sb *sandbox) updateGateway(ep *endpoint) error { + sb.Lock() + osSbox := sb.osSbox + sb.Unlock() + if osSbox == nil { + return nil + } + osSbox.UnsetGateway() + osSbox.UnsetGatewayIPv6() + + if ep == nil { + return nil + } + + ep.Lock() + joinInfo := ep.joinInfo + ep.Unlock() + + if err := osSbox.SetGateway(joinInfo.gw); err != nil { + return fmt.Errorf("failed to set gateway while updating gateway: %v", err) + } + + if err := osSbox.SetGatewayIPv6(joinInfo.gw6); err != nil { + return fmt.Errorf("failed to set IPv6 gateway while updating gateway: %v", err) + } + + return nil +} + +func (sb *sandbox) SetKey(basePath string) error { + var err error + if basePath == "" { + return types.BadRequestErrorf("invalid sandbox key") + } + + sb.Lock() + osSbox := sb.osSbox + sb.Unlock() + + if osSbox != nil { + // If we already have an OS sandbox, release the network resources from that + // and destroy the OS snab. We are moving into a new home further down. Note that none + // of the network resources gets destroyed during the move. + sb.releaseOSSbox() + } + + osSbox, err = osl.GetSandboxForExternalKey(basePath, sb.Key()) + if err != nil { + return err + } + + sb.Lock() + sb.osSbox = osSbox + sb.Unlock() + defer func() { + if err != nil { + sb.Lock() + sb.osSbox = nil + sb.Unlock() + } + }() + + for _, ep := range sb.getConnectedEndpoints() { + if err = sb.populateNetworkResources(ep); err != nil { + return err + } + } + return nil +} + +func releaseOSSboxResources(osSbox osl.Sandbox, ep *endpoint) { + for _, i := range osSbox.Info().Interfaces() { + // Only remove the interfaces owned by this endpoint from the sandbox. + if ep.hasInterface(i.SrcName()) { + if err := i.Remove(); err != nil { + log.Debugf("Remove interface failed: %v", err) + } + } + } + + ep.Lock() + joinInfo := ep.joinInfo + ep.Unlock() + + if joinInfo == nil { + return + } + + // Remove non-interface routes. + for _, r := range joinInfo.StaticRoutes { + if err := osSbox.RemoveStaticRoute(r); err != nil { + log.Debugf("Remove route failed: %v", err) + } + } +} + +func (sb *sandbox) releaseOSSbox() { + sb.Lock() + osSbox := sb.osSbox + sb.osSbox = nil + sb.Unlock() + + if osSbox == nil { + return + } + + for _, ep := range sb.getConnectedEndpoints() { + releaseOSSboxResources(osSbox, ep) + } + + osSbox.Destroy() +} + +func (sb *sandbox) populateNetworkResources(ep *endpoint) error { + sb.Lock() + if sb.osSbox == nil { + sb.Unlock() + return nil + } + inDelete := sb.inDelete + sb.Unlock() + + ep.Lock() + joinInfo := ep.joinInfo + i := ep.iface + ep.Unlock() + + if i != nil && i.srcName != "" { + var ifaceOptions []osl.IfaceOption + + ifaceOptions = append(ifaceOptions, sb.osSbox.InterfaceOptions().Address(i.addr), sb.osSbox.InterfaceOptions().Routes(i.routes)) + if i.addrv6 != nil && i.addrv6.IP.To16() != nil { + ifaceOptions = append(ifaceOptions, sb.osSbox.InterfaceOptions().AddressIPv6(i.addrv6)) + } + + if err := sb.osSbox.AddInterface(i.srcName, i.dstPrefix, ifaceOptions...); err != nil { + return fmt.Errorf("failed to add interface %s to sandbox: %v", i.srcName, err) + } + } + + if joinInfo != nil { + // Set up non-interface routes. + for _, r := range joinInfo.StaticRoutes { + if err := sb.osSbox.AddStaticRoute(r); err != nil { + return fmt.Errorf("failed to add static route %s: %v", r.Destination.String(), err) + } + } + } + + for _, gwep := range sb.getConnectedEndpoints() { + if len(gwep.Gateway()) > 0 { + if gwep != ep { + break + } + if err := sb.updateGateway(gwep); err != nil { + return err + } + } + } + + // Only update the store if we did not come here as part of + // sandbox delete. If we came here as part of delete then do + // not bother updating the store. The sandbox object will be + // deleted anyway + if !inDelete { + return sb.storeUpdate() + } + + return nil +} + +func (sb *sandbox) clearNetworkResources(origEp *endpoint) error { + ep := sb.getEndpoint(origEp.id) + if ep == nil { + return fmt.Errorf("could not find the sandbox endpoint data for endpoint %s", + ep.name) + } + + sb.Lock() + osSbox := sb.osSbox + inDelete := sb.inDelete + sb.Unlock() + if osSbox != nil { + releaseOSSboxResources(osSbox, ep) + } + + sb.Lock() + if len(sb.endpoints) == 0 { + // sb.endpoints should never be empty and this is unexpected error condition + // We log an error message to note this down for debugging purposes. + log.Errorf("No endpoints in sandbox while trying to remove endpoint %s", ep.Name()) + sb.Unlock() + return nil + } + + var ( + gwepBefore, gwepAfter *endpoint + index = -1 + ) + for i, e := range sb.endpoints { + if e == ep { + index = i + } + if len(e.Gateway()) > 0 && gwepBefore == nil { + gwepBefore = e + } + if index != -1 && gwepBefore != nil { + break + } + } + heap.Remove(&sb.endpoints, index) + for _, e := range sb.endpoints { + if len(e.Gateway()) > 0 { + gwepAfter = e + break + } + } + delete(sb.epPriority, ep.ID()) + sb.Unlock() + + if gwepAfter != nil && gwepBefore != gwepAfter { + sb.updateGateway(gwepAfter) + } + + // Only update the store if we did not come here as part of + // sandbox delete. If we came here as part of delete then do + // not bother updating the store. The sandbox object will be + // deleted anyway + if !inDelete { + return sb.storeUpdate() + } + + return nil +} + +const ( + defaultPrefix = "/var/lib/docker/network/files" + dirPerm = 0755 + filePerm = 0644 +) + +func (sb *sandbox) buildHostsFile() error { + if sb.config.hostsPath == "" { + sb.config.hostsPath = defaultPrefix + "/" + sb.id + "/hosts" + } + + dir, _ := filepath.Split(sb.config.hostsPath) + if err := createBasePath(dir); err != nil { + return err + } + + // This is for the host mode networking + if sb.config.originHostsPath != "" { + if err := copyFile(sb.config.originHostsPath, sb.config.hostsPath); err != nil && !os.IsNotExist(err) { + return types.InternalErrorf("could not copy source hosts file %s to %s: %v", sb.config.originHostsPath, sb.config.hostsPath, err) + } + return nil + } + + extraContent := make([]etchosts.Record, 0, len(sb.config.extraHosts)) + for _, extraHost := range sb.config.extraHosts { + extraContent = append(extraContent, etchosts.Record{Hosts: extraHost.name, IP: extraHost.IP}) + } + + return etchosts.Build(sb.config.hostsPath, "", sb.config.hostName, sb.config.domainName, extraContent) +} + +func (sb *sandbox) updateHostsFile(ifaceIP string, svcRecords []etchosts.Record) error { + var mhost string + + if sb.config.originHostsPath != "" { + return nil + } + + if sb.config.domainName != "" { + mhost = fmt.Sprintf("%s.%s %s", sb.config.hostName, sb.config.domainName, + sb.config.hostName) + } else { + mhost = sb.config.hostName + } + + extraContent := make([]etchosts.Record, 0, len(svcRecords)+1) + extraContent = append(extraContent, etchosts.Record{Hosts: mhost, IP: ifaceIP}) + for _, svc := range svcRecords { + extraContent = append(extraContent, svc) + } + + sb.addHostsEntries(extraContent) + return nil +} + +func (sb *sandbox) addHostsEntries(recs []etchosts.Record) { + if err := etchosts.Add(sb.config.hostsPath, recs); err != nil { + log.Warnf("Failed adding service host entries to the running container: %v", err) + } +} + +func (sb *sandbox) deleteHostsEntries(recs []etchosts.Record) { + if err := etchosts.Delete(sb.config.hostsPath, recs); err != nil { + log.Warnf("Failed deleting service host entries to the running container: %v", err) + } +} + +func (sb *sandbox) updateParentHosts() error { + var pSb Sandbox + + for _, update := range sb.config.parentUpdates { + sb.controller.WalkSandboxes(SandboxContainerWalker(&pSb, update.cid)) + if pSb == nil { + continue + } + if err := etchosts.Update(pSb.(*sandbox).config.hostsPath, update.ip, update.name); err != nil { + return err + } + } + + return nil +} + +func (sb *sandbox) setupDNS() error { + var newRC *resolvconf.File + + if sb.config.resolvConfPath == "" { + sb.config.resolvConfPath = defaultPrefix + "/" + sb.id + "/resolv.conf" + } + + sb.config.resolvConfHashFile = sb.config.resolvConfPath + ".hash" + + dir, _ := filepath.Split(sb.config.resolvConfPath) + if err := createBasePath(dir); err != nil { + return err + } + + // This is for the host mode networking + if sb.config.originResolvConfPath != "" { + if err := copyFile(sb.config.originResolvConfPath, sb.config.resolvConfPath); err != nil { + return fmt.Errorf("could not copy source resolv.conf file %s to %s: %v", sb.config.originResolvConfPath, sb.config.resolvConfPath, err) + } + return nil + } + + currRC, err := resolvconf.Get() + if err != nil { + return err + } + + if len(sb.config.dnsList) > 0 || len(sb.config.dnsSearchList) > 0 || len(sb.config.dnsOptionsList) > 0 { + var ( + err error + dnsList = resolvconf.GetNameservers(currRC.Content) + dnsSearchList = resolvconf.GetSearchDomains(currRC.Content) + dnsOptionsList = resolvconf.GetOptions(currRC.Content) + ) + if len(sb.config.dnsList) > 0 { + dnsList = sb.config.dnsList + } + if len(sb.config.dnsSearchList) > 0 { + dnsSearchList = sb.config.dnsSearchList + } + if len(sb.config.dnsOptionsList) > 0 { + dnsOptionsList = sb.config.dnsOptionsList + } + newRC, err = resolvconf.Build(sb.config.resolvConfPath, dnsList, dnsSearchList, dnsOptionsList) + if err != nil { + return err + } + } else { + // Replace any localhost/127.* (at this point we have no info about ipv6, pass it as true) + if newRC, err = resolvconf.FilterResolvDNS(currRC.Content, true); err != nil { + return err + } + // No contention on container resolv.conf file at sandbox creation + if err := ioutil.WriteFile(sb.config.resolvConfPath, newRC.Content, filePerm); err != nil { + return types.InternalErrorf("failed to write unhaltered resolv.conf file content when setting up dns for sandbox %s: %v", sb.ID(), err) + } + } + + // Write hash + if err := ioutil.WriteFile(sb.config.resolvConfHashFile, []byte(newRC.Hash), filePerm); err != nil { + return types.InternalErrorf("failed to write resolv.conf hash file when setting up dns for sandbox %s: %v", sb.ID(), err) + } + + return nil +} + +func (sb *sandbox) updateDNS(ipv6Enabled bool) error { + var ( + currHash string + hashFile = sb.config.resolvConfHashFile + ) + + if len(sb.config.dnsList) > 0 || len(sb.config.dnsSearchList) > 0 || len(sb.config.dnsOptionsList) > 0 { + return nil + } + + currRC, err := resolvconf.GetSpecific(sb.config.resolvConfPath) + if err != nil { + if !os.IsNotExist(err) { + return err + } + } else { + h, err := ioutil.ReadFile(hashFile) + if err != nil { + if !os.IsNotExist(err) { + return err + } + } else { + currHash = string(h) + } + } + + if currHash != "" && currHash != currRC.Hash { + // Seems the user has changed the container resolv.conf since the last time + // we checked so return without doing anything. + log.Infof("Skipping update of resolv.conf file with ipv6Enabled: %t because file was touched by user", ipv6Enabled) + return nil + } + + // replace any localhost/127.* and remove IPv6 nameservers if IPv6 disabled. + newRC, err := resolvconf.FilterResolvDNS(currRC.Content, ipv6Enabled) + if err != nil { + return err + } + + // for atomic updates to these files, use temporary files with os.Rename: + dir := path.Dir(sb.config.resolvConfPath) + tmpHashFile, err := ioutil.TempFile(dir, "hash") + if err != nil { + return err + } + tmpResolvFile, err := ioutil.TempFile(dir, "resolv") + if err != nil { + return err + } + + // Change the perms to filePerm (0644) since ioutil.TempFile creates it by default as 0600 + if err := os.Chmod(tmpResolvFile.Name(), filePerm); err != nil { + return err + } + + // write the updates to the temp files + if err = ioutil.WriteFile(tmpHashFile.Name(), []byte(newRC.Hash), filePerm); err != nil { + return err + } + if err = ioutil.WriteFile(tmpResolvFile.Name(), newRC.Content, filePerm); err != nil { + return err + } + + // rename the temp files for atomic replace + if err = os.Rename(tmpHashFile.Name(), hashFile); err != nil { + return err + } + return os.Rename(tmpResolvFile.Name(), sb.config.resolvConfPath) +} + +// joinLeaveStart waits to ensure there are no joins or leaves in progress and +// marks this join/leave in progress without race +func (sb *sandbox) joinLeaveStart() { + sb.Lock() + defer sb.Unlock() + + for sb.joinLeaveDone != nil { + joinLeaveDone := sb.joinLeaveDone + sb.Unlock() + + select { + case <-joinLeaveDone: + } + + sb.Lock() + } + + sb.joinLeaveDone = make(chan struct{}) +} + +// joinLeaveEnd marks the end of this join/leave operation and +// signals the same without race to other join and leave waiters +func (sb *sandbox) joinLeaveEnd() { + sb.Lock() + defer sb.Unlock() + + if sb.joinLeaveDone != nil { + close(sb.joinLeaveDone) + sb.joinLeaveDone = nil + } +} + +// OptionHostname function returns an option setter for hostname option to +// be passed to NewSandbox method. +func OptionHostname(name string) SandboxOption { + return func(sb *sandbox) { + sb.config.hostName = name + } +} + +// OptionDomainname function returns an option setter for domainname option to +// be passed to NewSandbox method. +func OptionDomainname(name string) SandboxOption { + return func(sb *sandbox) { + sb.config.domainName = name + } +} + +// OptionHostsPath function returns an option setter for hostspath option to +// be passed to NewSandbox method. +func OptionHostsPath(path string) SandboxOption { + return func(sb *sandbox) { + sb.config.hostsPath = path + } +} + +// OptionOriginHostsPath function returns an option setter for origin hosts file path +// tbeo passed to NewSandbox method. +func OptionOriginHostsPath(path string) SandboxOption { + return func(sb *sandbox) { + sb.config.originHostsPath = path + } +} + +// OptionExtraHost function returns an option setter for extra /etc/hosts options +// which is a name and IP as strings. +func OptionExtraHost(name string, IP string) SandboxOption { + return func(sb *sandbox) { + sb.config.extraHosts = append(sb.config.extraHosts, extraHost{name: name, IP: IP}) + } +} + +// OptionParentUpdate function returns an option setter for parent container +// which needs to update the IP address for the linked container. +func OptionParentUpdate(cid string, name, ip string) SandboxOption { + return func(sb *sandbox) { + sb.config.parentUpdates = append(sb.config.parentUpdates, parentUpdate{cid: cid, name: name, ip: ip}) + } +} + +// OptionResolvConfPath function returns an option setter for resolvconfpath option to +// be passed to net container methods. +func OptionResolvConfPath(path string) SandboxOption { + return func(sb *sandbox) { + sb.config.resolvConfPath = path + } +} + +// OptionOriginResolvConfPath function returns an option setter to set the path to the +// origin resolv.conf file to be passed to net container methods. +func OptionOriginResolvConfPath(path string) SandboxOption { + return func(sb *sandbox) { + sb.config.originResolvConfPath = path + } +} + +// OptionDNS function returns an option setter for dns entry option to +// be passed to container Create method. +func OptionDNS(dns string) SandboxOption { + return func(sb *sandbox) { + sb.config.dnsList = append(sb.config.dnsList, dns) + } +} + +// OptionDNSSearch function returns an option setter for dns search entry option to +// be passed to container Create method. +func OptionDNSSearch(search string) SandboxOption { + return func(sb *sandbox) { + sb.config.dnsSearchList = append(sb.config.dnsSearchList, search) + } +} + +// OptionDNSOptions function returns an option setter for dns options entry option to +// be passed to container Create method. +func OptionDNSOptions(options string) SandboxOption { + return func(sb *sandbox) { + sb.config.dnsOptionsList = append(sb.config.dnsOptionsList, options) + } +} + +// OptionUseDefaultSandbox function returns an option setter for using default sandbox to +// be passed to container Create method. +func OptionUseDefaultSandbox() SandboxOption { + return func(sb *sandbox) { + sb.config.useDefaultSandBox = true + } +} + +// OptionUseExternalKey function returns an option setter for using provided namespace +// instead of creating one. +func OptionUseExternalKey() SandboxOption { + return func(sb *sandbox) { + sb.config.useExternalKey = true + } +} + +// OptionGeneric function returns an option setter for Generic configuration +// that is not managed by libNetwork but can be used by the Drivers during the call to +// net container creation method. Container Labels are a good example. +func OptionGeneric(generic map[string]interface{}) SandboxOption { + return func(sb *sandbox) { + sb.config.generic = generic + } +} + +func (eh epHeap) Len() int { return len(eh) } + +func (eh epHeap) Less(i, j int) bool { + var ( + cip, cjp int + ok bool + ) + + ci, _ := eh[i].getSandbox() + cj, _ := eh[j].getSandbox() + + epi := eh[i] + epj := eh[j] + + if epi.endpointInGWNetwork() { + return false + } + + if epj.endpointInGWNetwork() { + return true + } + + if ci != nil { + cip, ok = ci.epPriority[eh[i].ID()] + if !ok { + cip = 0 + } + } + + if cj != nil { + cjp, ok = cj.epPriority[eh[j].ID()] + if !ok { + cjp = 0 + } + } + + if cip == cjp { + return eh[i].network.Name() < eh[j].network.Name() + } + + return cip > cjp +} + +func (eh epHeap) Swap(i, j int) { eh[i], eh[j] = eh[j], eh[i] } + +func (eh *epHeap) Push(x interface{}) { + *eh = append(*eh, x.(*endpoint)) +} + +func (eh *epHeap) Pop() interface{} { + old := *eh + n := len(old) + x := old[n-1] + *eh = old[0 : n-1] + return x +} + +func createBasePath(dir string) error { + return os.MkdirAll(dir, dirPerm) +} + +func createFile(path string) error { + var f *os.File + + dir, _ := filepath.Split(path) + err := createBasePath(dir) + if err != nil { + return err + } + + f, err = os.Create(path) + if err == nil { + f.Close() + } + + return err +} + +func copyFile(src, dst string) error { + sBytes, err := ioutil.ReadFile(src) + if err != nil { + return err + } + return ioutil.WriteFile(dst, sBytes, filePerm) +} diff --git a/vendor/src/github.com/docker/libnetwork/sandbox_externalkey.go b/vendor/src/github.com/docker/libnetwork/sandbox_externalkey.go new file mode 100644 index 0000000000..0b2385b3bf --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/sandbox_externalkey.go @@ -0,0 +1,185 @@ +package libnetwork + +import ( + "encoding/json" + "fmt" + "io" + "io/ioutil" + "net" + "os" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/pkg/reexec" + "github.com/docker/libnetwork/types" + "github.com/opencontainers/runc/libcontainer" + "github.com/opencontainers/runc/libcontainer/configs" +) + +type setKeyData struct { + ContainerID string + Key string +} + +func init() { + reexec.Register("libnetwork-setkey", processSetKeyReexec) +} + +const udsBase = "/var/lib/docker/network/files/" +const success = "success" + +// processSetKeyReexec is a private function that must be called only on an reexec path +// It expects 3 args { [0] = "libnetwork-setkey", [1] = , [2] = } +// It also expects libcontainer.State as a json string in +// Refer to https://github.com/opencontainers/runc/pull/160/ for more information +func processSetKeyReexec() { + var err error + + // Return a failure to the calling process via ExitCode + defer func() { + if err != nil { + logrus.Fatalf("%v", err) + } + }() + + // expecting 3 args {[0]="libnetwork-setkey", [1]=, [2]= } + if len(os.Args) < 3 { + err = fmt.Errorf("Re-exec expects 3 args, received : %d", len(os.Args)) + return + } + containerID := os.Args[1] + + // We expect libcontainer.State as a json string in + stateBuf, err := ioutil.ReadAll(os.Stdin) + if err != nil { + return + } + var state libcontainer.State + if err = json.Unmarshal(stateBuf, &state); err != nil { + return + } + + controllerID := os.Args[2] + key := state.NamespacePaths[configs.NamespaceType("NEWNET")] + + err = SetExternalKey(controllerID, containerID, key) + return +} + +// SetExternalKey provides a convenient way to set an External key to a sandbox +func SetExternalKey(controllerID string, containerID string, key string) error { + keyData := setKeyData{ + ContainerID: containerID, + Key: key} + + c, err := net.Dial("unix", udsBase+controllerID+".sock") + if err != nil { + return err + } + defer c.Close() + + if err = sendKey(c, keyData); err != nil { + return fmt.Errorf("sendKey failed with : %v", err) + } + return processReturn(c) +} + +func sendKey(c net.Conn, data setKeyData) error { + var err error + defer func() { + if err != nil { + c.Close() + } + }() + + var b []byte + if b, err = json.Marshal(data); err != nil { + return err + } + + _, err = c.Write(b) + return err +} + +func processReturn(r io.Reader) error { + buf := make([]byte, 1024) + n, err := r.Read(buf[:]) + if err != nil { + return fmt.Errorf("failed to read buf in processReturn : %v", err) + } + if string(buf[0:n]) != success { + return fmt.Errorf(string(buf[0:n])) + } + return nil +} + +func (c *controller) startExternalKeyListener() error { + if err := os.MkdirAll(udsBase, 0600); err != nil { + return err + } + uds := udsBase + c.id + ".sock" + l, err := net.Listen("unix", uds) + if err != nil { + return err + } + if err := os.Chmod(uds, 0600); err != nil { + l.Close() + return err + } + c.Lock() + c.extKeyListener = l + c.Unlock() + + go c.acceptClientConnections(uds, l) + return nil +} + +func (c *controller) acceptClientConnections(sock string, l net.Listener) { + for { + conn, err := l.Accept() + if err != nil { + if _, err1 := os.Stat(sock); os.IsNotExist(err1) { + logrus.Debugf("Unix socket %s doesnt exist. cannot accept client connections", sock) + return + } + logrus.Errorf("Error accepting connection %v", err) + continue + } + go func() { + err := c.processExternalKey(conn) + ret := success + if err != nil { + ret = err.Error() + } + + _, err = conn.Write([]byte(ret)) + if err != nil { + logrus.Errorf("Error returning to the client %v", err) + } + }() + } +} + +func (c *controller) processExternalKey(conn net.Conn) error { + buf := make([]byte, 1280) + nr, err := conn.Read(buf) + if err != nil { + return err + } + var s setKeyData + if err = json.Unmarshal(buf[0:nr], &s); err != nil { + return err + } + + var sandbox Sandbox + search := SandboxContainerWalker(&sandbox, s.ContainerID) + c.WalkSandboxes(search) + if sandbox == nil { + return types.BadRequestErrorf("no sandbox present for %s", s.ContainerID) + } + + return sandbox.SetKey(s.Key) +} + +func (c *controller) stopExternalKeyListener() { + c.extKeyListener.Close() +} diff --git a/vendor/src/github.com/docker/libnetwork/sandbox_store.go b/vendor/src/github.com/docker/libnetwork/sandbox_store.go new file mode 100644 index 0000000000..61eda408e4 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/sandbox_store.go @@ -0,0 +1,233 @@ +package libnetwork + +import ( + "container/heap" + "encoding/json" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/datastore" + "github.com/docker/libnetwork/osl" +) + +const ( + sandboxPrefix = "sandbox" +) + +type epState struct { + Eid string + Nid string +} + +type sbState struct { + ID string + Cid string + c *controller + dbIndex uint64 + dbExists bool + Eps []epState +} + +func (sbs *sbState) Key() []string { + return []string{sandboxPrefix, sbs.ID} +} + +func (sbs *sbState) KeyPrefix() []string { + return []string{sandboxPrefix} +} + +func (sbs *sbState) Value() []byte { + b, err := json.Marshal(sbs) + if err != nil { + return nil + } + return b +} + +func (sbs *sbState) SetValue(value []byte) error { + return json.Unmarshal(value, sbs) +} + +func (sbs *sbState) Index() uint64 { + sbi, err := sbs.c.SandboxByID(sbs.ID) + if err != nil { + return sbs.dbIndex + } + + sb := sbi.(*sandbox) + maxIndex := sb.dbIndex + if sbs.dbIndex > maxIndex { + maxIndex = sbs.dbIndex + } + + return maxIndex +} + +func (sbs *sbState) SetIndex(index uint64) { + sbs.dbIndex = index + sbs.dbExists = true + + sbi, err := sbs.c.SandboxByID(sbs.ID) + if err != nil { + return + } + + sb := sbi.(*sandbox) + sb.dbIndex = index + sb.dbExists = true +} + +func (sbs *sbState) Exists() bool { + if sbs.dbExists { + return sbs.dbExists + } + + sbi, err := sbs.c.SandboxByID(sbs.ID) + if err != nil { + return false + } + + sb := sbi.(*sandbox) + return sb.dbExists +} + +func (sbs *sbState) Skip() bool { + return false +} + +func (sbs *sbState) New() datastore.KVObject { + return &sbState{c: sbs.c} +} + +func (sbs *sbState) CopyTo(o datastore.KVObject) error { + dstSbs := o.(*sbState) + dstSbs.c = sbs.c + dstSbs.ID = sbs.ID + dstSbs.Cid = sbs.Cid + dstSbs.dbIndex = sbs.dbIndex + dstSbs.dbExists = sbs.dbExists + + for _, eps := range sbs.Eps { + dstSbs.Eps = append(dstSbs.Eps, eps) + } + + return nil +} + +func (sbs *sbState) DataScope() string { + return datastore.LocalScope +} + +func (sb *sandbox) storeUpdate() error { + sbs := &sbState{ + c: sb.controller, + ID: sb.id, + Cid: sb.containerID, + } + +retry: + sbs.Eps = nil + for _, ep := range sb.getConnectedEndpoints() { + // If the endpoint is not persisted then do not add it to + // the sandbox checkpoint + if ep.Skip() { + continue + } + + eps := epState{ + Nid: ep.getNetwork().ID(), + Eid: ep.ID(), + } + + sbs.Eps = append(sbs.Eps, eps) + } + + err := sb.controller.updateToStore(sbs) + if err == datastore.ErrKeyModified { + // When we get ErrKeyModified it is sufficient to just + // go back and retry. No need to get the object from + // the store because we always regenerate the store + // state from in memory sandbox state + goto retry + } + + return err +} + +func (sb *sandbox) storeDelete() error { + sbs := &sbState{ + c: sb.controller, + ID: sb.id, + Cid: sb.containerID, + dbIndex: sb.dbIndex, + dbExists: sb.dbExists, + } + + return sb.controller.deleteFromStore(sbs) +} + +func (c *controller) sandboxCleanup() { + store := c.getStore(datastore.LocalScope) + if store == nil { + logrus.Errorf("Could not find local scope store while trying to cleanup sandboxes") + return + } + + kvol, err := store.List(datastore.Key(sandboxPrefix), &sbState{c: c}) + if err != nil && err != datastore.ErrKeyNotFound { + logrus.Errorf("failed to get sandboxes for scope %s: %v", store.Scope(), err) + return + } + + // It's normal for no sandboxes to be found. Just bail out. + if err == datastore.ErrKeyNotFound { + return + } + + for _, kvo := range kvol { + sbs := kvo.(*sbState) + + sb := &sandbox{ + id: sbs.ID, + controller: sbs.c, + containerID: sbs.Cid, + endpoints: epHeap{}, + epPriority: map[string]int{}, + dbIndex: sbs.dbIndex, + isStub: true, + dbExists: true, + } + + sb.osSbox, err = osl.NewSandbox(sb.Key(), true) + if err != nil { + logrus.Errorf("failed to create new osl sandbox while trying to build sandbox for cleanup: %v", err) + continue + } + + c.Lock() + c.sandboxes[sb.id] = sb + c.Unlock() + + for _, eps := range sbs.Eps { + n, err := c.getNetworkFromStore(eps.Nid) + var ep *endpoint + if err != nil { + logrus.Errorf("getNetworkFromStore for nid %s failed while trying to build sandbox for cleanup: %v", eps.Nid, err) + n = &network{id: eps.Nid, ctrlr: c, drvOnce: &sync.Once{}} + ep = &endpoint{id: eps.Eid, network: n, sandboxID: sbs.ID} + } else { + ep, err = n.getEndpointFromStore(eps.Eid) + if err != nil { + logrus.Errorf("getEndpointFromStore for eid %s failed while trying to build sandbox for cleanup: %v", eps.Eid, err) + ep = &endpoint{id: eps.Eid, network: n, sandboxID: sbs.ID} + } + } + + heap.Push(&sb.endpoints, ep) + } + + if err := sb.Delete(); err != nil { + logrus.Errorf("failed to delete sandbox %s while trying to cleanup: %v", sb.id, err) + } + } +} diff --git a/vendor/src/github.com/docker/libnetwork/store.go b/vendor/src/github.com/docker/libnetwork/store.go new file mode 100644 index 0000000000..a7682e5af6 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/store.go @@ -0,0 +1,413 @@ +package libnetwork + +import ( + "fmt" + + log "github.com/Sirupsen/logrus" + "github.com/docker/libnetwork/datastore" +) + +func (c *controller) initStores() error { + c.Lock() + if c.cfg == nil { + c.Unlock() + return nil + } + scopeConfigs := c.cfg.Scopes + c.Unlock() + + for scope, scfg := range scopeConfigs { + store, err := datastore.NewDataStore(scope, scfg) + if err != nil { + return err + } + c.Lock() + c.stores = append(c.stores, store) + c.Unlock() + } + + c.startWatch() + return nil +} + +func (c *controller) closeStores() { + for _, store := range c.getStores() { + store.Close() + } +} + +func (c *controller) getStore(scope string) datastore.DataStore { + c.Lock() + defer c.Unlock() + + for _, store := range c.stores { + if store.Scope() == scope { + return store + } + } + + return nil +} + +func (c *controller) getStores() []datastore.DataStore { + c.Lock() + defer c.Unlock() + + return c.stores +} + +func (c *controller) getNetworkFromStore(nid string) (*network, error) { + for _, store := range c.getStores() { + n := &network{id: nid, ctrlr: c} + err := store.GetObject(datastore.Key(n.Key()...), n) + // Continue searching in the next store if the key is not found in this store + if err != nil { + if err != datastore.ErrKeyNotFound { + log.Debugf("could not find network %s: %v", nid, err) + } + continue + } + + ec := &endpointCnt{n: n} + err = store.GetObject(datastore.Key(ec.Key()...), ec) + if err != nil { + return nil, fmt.Errorf("could not find endpoint count for network %s: %v", n.Name(), err) + } + + n.epCnt = ec + return n, nil + } + + return nil, fmt.Errorf("network %s not found", nid) +} + +func (c *controller) getNetworksForScope(scope string) ([]*network, error) { + var nl []*network + + store := c.getStore(scope) + if store == nil { + return nil, nil + } + + kvol, err := store.List(datastore.Key(datastore.NetworkKeyPrefix), + &network{ctrlr: c}) + if err != nil && err != datastore.ErrKeyNotFound { + return nil, fmt.Errorf("failed to get networks for scope %s: %v", + scope, err) + } + + for _, kvo := range kvol { + n := kvo.(*network) + n.ctrlr = c + + ec := &endpointCnt{n: n} + err = store.GetObject(datastore.Key(ec.Key()...), ec) + if err != nil { + return nil, fmt.Errorf("could not find endpoint count key %s for network %s while listing: %v", datastore.Key(ec.Key()...), n.Name(), err) + } + + n.epCnt = ec + nl = append(nl, n) + } + + return nl, nil +} + +func (c *controller) getNetworksFromStore() ([]*network, error) { + var nl []*network + + for _, store := range c.getStores() { + kvol, err := store.List(datastore.Key(datastore.NetworkKeyPrefix), + &network{ctrlr: c}) + // Continue searching in the next store if no keys found in this store + if err != nil { + if err != datastore.ErrKeyNotFound { + log.Debugf("failed to get networks for scope %s: %v", store.Scope(), err) + } + continue + } + + for _, kvo := range kvol { + n := kvo.(*network) + n.ctrlr = c + + ec := &endpointCnt{n: n} + err = store.GetObject(datastore.Key(ec.Key()...), ec) + if err != nil { + return nil, fmt.Errorf("could not find endpoint count key %s for network %s while listing: %v", datastore.Key(ec.Key()...), n.Name(), err) + } + + n.epCnt = ec + nl = append(nl, n) + } + } + + return nl, nil +} + +func (n *network) getEndpointFromStore(eid string) (*endpoint, error) { + store := n.ctrlr.getStore(n.Scope()) + if store == nil { + return nil, fmt.Errorf("could not find endpoint %s: datastore not found for scope %s", eid, n.Scope()) + } + + ep := &endpoint{id: eid, network: n} + err := store.GetObject(datastore.Key(ep.Key()...), ep) + if err != nil { + return nil, fmt.Errorf("could not find endpoint %s: %v", eid, err) + } + return ep, nil +} + +func (n *network) getEndpointsFromStore() ([]*endpoint, error) { + var epl []*endpoint + + tmp := endpoint{network: n} + for _, store := range n.getController().getStores() { + kvol, err := store.List(datastore.Key(tmp.KeyPrefix()...), &endpoint{network: n}) + // Continue searching in the next store if no keys found in this store + if err != nil { + if err != datastore.ErrKeyNotFound { + log.Debugf("failed to get endpoints for network %s scope %s: %v", + n.Name(), store.Scope(), err) + } + continue + } + + for _, kvo := range kvol { + ep := kvo.(*endpoint) + epl = append(epl, ep) + } + } + + return epl, nil +} + +func (c *controller) updateToStore(kvObject datastore.KVObject) error { + cs := c.getStore(kvObject.DataScope()) + if cs == nil { + log.Warnf("datastore for scope %s not initialized. kv object %s is not added to the store", kvObject.DataScope(), datastore.Key(kvObject.Key()...)) + return nil + } + + if err := cs.PutObjectAtomic(kvObject); err != nil { + if err == datastore.ErrKeyModified { + return err + } + return fmt.Errorf("failed to update store for object type %T: %v", kvObject, err) + } + + return nil +} + +func (c *controller) deleteFromStore(kvObject datastore.KVObject) error { + cs := c.getStore(kvObject.DataScope()) + if cs == nil { + log.Debugf("datastore for scope %s not initialized. kv object %s is not deleted from datastore", kvObject.DataScope(), datastore.Key(kvObject.Key()...)) + return nil + } + +retry: + if err := cs.DeleteObjectAtomic(kvObject); err != nil { + if err == datastore.ErrKeyModified { + if err := cs.GetObject(datastore.Key(kvObject.Key()...), kvObject); err != nil { + return fmt.Errorf("could not update the kvobject to latest when trying to delete: %v", err) + } + goto retry + } + return err + } + + return nil +} + +type netWatch struct { + localEps map[string]*endpoint + remoteEps map[string]*endpoint + stopCh chan struct{} +} + +func (c *controller) getLocalEps(nw *netWatch) []*endpoint { + c.Lock() + defer c.Unlock() + + var epl []*endpoint + for _, ep := range nw.localEps { + epl = append(epl, ep) + } + + return epl +} + +func (c *controller) watchSvcRecord(ep *endpoint) { + c.watchCh <- ep +} + +func (c *controller) unWatchSvcRecord(ep *endpoint) { + c.unWatchCh <- ep +} + +func (c *controller) networkWatchLoop(nw *netWatch, ep *endpoint, ecCh <-chan datastore.KVObject) { + for { + select { + case <-nw.stopCh: + return + case o := <-ecCh: + ec := o.(*endpointCnt) + + epl, err := ec.n.getEndpointsFromStore() + if err != nil { + break + } + + c.Lock() + var addEp []*endpoint + + delEpMap := make(map[string]*endpoint) + renameEpMap := make(map[string]bool) + for k, v := range nw.remoteEps { + delEpMap[k] = v + } + + for _, lEp := range epl { + if _, ok := nw.localEps[lEp.ID()]; ok { + continue + } + + if ep, ok := nw.remoteEps[lEp.ID()]; ok { + // On a container rename EP ID will remain + // the same but the name will change. service + // records should reflect the change. + // Keep old EP entry in the delEpMap and add + // EP from the store (which has the new name) + // into the new list + if lEp.name == ep.name { + delete(delEpMap, lEp.ID()) + continue + } + renameEpMap[lEp.ID()] = true + } + nw.remoteEps[lEp.ID()] = lEp + addEp = append(addEp, lEp) + } + + // EPs whose name are to be deleted from the svc records + // should also be removed from nw's remote EP list, except + // the ones that are getting renamed. + for _, lEp := range delEpMap { + if !renameEpMap[lEp.ID()] { + delete(nw.remoteEps, lEp.ID()) + } + } + c.Unlock() + + for _, lEp := range delEpMap { + ep.getNetwork().updateSvcRecord(lEp, c.getLocalEps(nw), false) + + } + for _, lEp := range addEp { + ep.getNetwork().updateSvcRecord(lEp, c.getLocalEps(nw), true) + } + } + } +} + +func (c *controller) processEndpointCreate(nmap map[string]*netWatch, ep *endpoint) { + c.Lock() + nw, ok := nmap[ep.getNetwork().ID()] + c.Unlock() + + if ok { + // Update the svc db for the local endpoint join right away + ep.getNetwork().updateSvcRecord(ep, c.getLocalEps(nw), true) + + c.Lock() + nw.localEps[ep.ID()] = ep + + // If we had learned that from the kv store remove it + // from remote ep list now that we know that this is + // indeed a local endpoint + delete(nw.remoteEps, ep.ID()) + c.Unlock() + return + } + + nw = &netWatch{ + localEps: make(map[string]*endpoint), + remoteEps: make(map[string]*endpoint), + } + + // Update the svc db for the local endpoint join right away + // Do this before adding this ep to localEps so that we don't + // try to update this ep's container's svc records + ep.getNetwork().updateSvcRecord(ep, c.getLocalEps(nw), true) + + c.Lock() + nw.localEps[ep.ID()] = ep + nmap[ep.getNetwork().ID()] = nw + nw.stopCh = make(chan struct{}) + c.Unlock() + + store := c.getStore(ep.getNetwork().DataScope()) + if store == nil { + return + } + + if !store.Watchable() { + return + } + + ch, err := store.Watch(ep.getNetwork().getEpCnt(), nw.stopCh) + if err != nil { + log.Warnf("Error creating watch for network: %v", err) + return + } + + go c.networkWatchLoop(nw, ep, ch) +} + +func (c *controller) processEndpointDelete(nmap map[string]*netWatch, ep *endpoint) { + c.Lock() + nw, ok := nmap[ep.getNetwork().ID()] + + if ok { + delete(nw.localEps, ep.ID()) + c.Unlock() + + // Update the svc db about local endpoint leave right away + // Do this after we remove this ep from localEps so that we + // don't try to remove this svc record from this ep's container. + ep.getNetwork().updateSvcRecord(ep, c.getLocalEps(nw), false) + + c.Lock() + if len(nw.localEps) == 0 { + close(nw.stopCh) + + // This is the last container going away for the network. Destroy + // this network's svc db entry + delete(c.svcDb, ep.getNetwork().ID()) + + delete(nmap, ep.getNetwork().ID()) + } + } + c.Unlock() +} + +func (c *controller) watchLoop() { + for { + select { + case ep := <-c.watchCh: + c.processEndpointCreate(c.nmap, ep) + case ep := <-c.unWatchCh: + c.processEndpointDelete(c.nmap, ep) + } + } +} + +func (c *controller) startWatch() { + c.watchCh = make(chan *endpoint) + c.unWatchCh = make(chan *endpoint) + c.nmap = make(map[string]*netWatch) + + go c.watchLoop() +} diff --git a/vendor/src/github.com/docker/libnetwork/types/types.go b/vendor/src/github.com/docker/libnetwork/types/types.go new file mode 100644 index 0000000000..7ada9643c0 --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/types/types.go @@ -0,0 +1,609 @@ +// Package types contains types that are common across libnetwork project +package types + +import ( + "bytes" + "fmt" + "net" + "strconv" + "strings" +) + +// UUID represents a globally unique ID of various resources like network and endpoint +type UUID string + +// TransportPort represent a local Layer 4 endpoint +type TransportPort struct { + Proto Protocol + Port uint16 +} + +// Equal checks if this instance of Transportport is equal to the passed one +func (t *TransportPort) Equal(o *TransportPort) bool { + if t == o { + return true + } + + if o == nil { + return false + } + + if t.Proto != o.Proto || t.Port != o.Port { + return false + } + + return true +} + +// GetCopy returns a copy of this TransportPort structure instance +func (t *TransportPort) GetCopy() TransportPort { + return TransportPort{Proto: t.Proto, Port: t.Port} +} + +// String returns the TransportPort structure in string form +func (t *TransportPort) String() string { + return fmt.Sprintf("%s/%d", t.Proto.String(), t.Port) +} + +// FromString reads the TransportPort structure from string +func (t *TransportPort) FromString(s string) error { + ps := strings.Split(s, "/") + if len(ps) == 2 { + t.Proto = ParseProtocol(ps[0]) + if p, err := strconv.ParseUint(ps[1], 10, 16); err == nil { + t.Port = uint16(p) + return nil + } + } + return BadRequestErrorf("invalid format for transport port: %s", s) +} + +// PortBinding represent a port binding between the container and the host +type PortBinding struct { + Proto Protocol + IP net.IP + Port uint16 + HostIP net.IP + HostPort uint16 + HostPortEnd uint16 +} + +// HostAddr returns the host side transport address +func (p PortBinding) HostAddr() (net.Addr, error) { + switch p.Proto { + case UDP: + return &net.UDPAddr{IP: p.HostIP, Port: int(p.HostPort)}, nil + case TCP: + return &net.TCPAddr{IP: p.HostIP, Port: int(p.HostPort)}, nil + default: + return nil, ErrInvalidProtocolBinding(p.Proto.String()) + } +} + +// ContainerAddr returns the container side transport address +func (p PortBinding) ContainerAddr() (net.Addr, error) { + switch p.Proto { + case UDP: + return &net.UDPAddr{IP: p.IP, Port: int(p.Port)}, nil + case TCP: + return &net.TCPAddr{IP: p.IP, Port: int(p.Port)}, nil + default: + return nil, ErrInvalidProtocolBinding(p.Proto.String()) + } +} + +// GetCopy returns a copy of this PortBinding structure instance +func (p *PortBinding) GetCopy() PortBinding { + return PortBinding{ + Proto: p.Proto, + IP: GetIPCopy(p.IP), + Port: p.Port, + HostIP: GetIPCopy(p.HostIP), + HostPort: p.HostPort, + HostPortEnd: p.HostPortEnd, + } +} + +// String return the PortBinding structure in string form +func (p *PortBinding) String() string { + ret := fmt.Sprintf("%s/", p.Proto) + if p.IP != nil { + ret = fmt.Sprintf("%s%s", ret, p.IP.String()) + } + ret = fmt.Sprintf("%s:%d/", ret, p.Port) + if p.HostIP != nil { + ret = fmt.Sprintf("%s%s", ret, p.HostIP.String()) + } + ret = fmt.Sprintf("%s:%d", ret, p.HostPort) + return ret +} + +// FromString reads the TransportPort structure from string +func (p *PortBinding) FromString(s string) error { + ps := strings.Split(s, "/") + if len(ps) != 3 { + return BadRequestErrorf("invalid format for port binding: %s", s) + } + + p.Proto = ParseProtocol(ps[0]) + + var err error + if p.IP, p.Port, err = parseIPPort(ps[1]); err != nil { + return BadRequestErrorf("failed to parse Container IP/Port in port binding: %s", err.Error()) + } + + if p.HostIP, p.HostPort, err = parseIPPort(ps[2]); err != nil { + return BadRequestErrorf("failed to parse Host IP/Port in port binding: %s", err.Error()) + } + + return nil +} + +func parseIPPort(s string) (net.IP, uint16, error) { + pp := strings.Split(s, ":") + if len(pp) != 2 { + return nil, 0, BadRequestErrorf("invalid format: %s", s) + } + + var ip net.IP + if pp[0] != "" { + if ip = net.ParseIP(pp[0]); ip == nil { + return nil, 0, BadRequestErrorf("invalid ip: %s", pp[0]) + } + } + + port, err := strconv.ParseUint(pp[1], 10, 16) + if err != nil { + return nil, 0, BadRequestErrorf("invalid port: %s", pp[1]) + } + + return ip, uint16(port), nil +} + +// Equal checks if this instance of PortBinding is equal to the passed one +func (p *PortBinding) Equal(o *PortBinding) bool { + if p == o { + return true + } + + if o == nil { + return false + } + + if p.Proto != o.Proto || p.Port != o.Port || + p.HostPort != o.HostPort || p.HostPortEnd != o.HostPortEnd { + return false + } + + if p.IP != nil { + if !p.IP.Equal(o.IP) { + return false + } + } else { + if o.IP != nil { + return false + } + } + + if p.HostIP != nil { + if !p.HostIP.Equal(o.HostIP) { + return false + } + } else { + if o.HostIP != nil { + return false + } + } + + return true +} + +// ErrInvalidProtocolBinding is returned when the port binding protocol is not valid. +type ErrInvalidProtocolBinding string + +func (ipb ErrInvalidProtocolBinding) Error() string { + return fmt.Sprintf("invalid transport protocol: %s", string(ipb)) +} + +const ( + // ICMP is for the ICMP ip protocol + ICMP = 1 + // TCP is for the TCP ip protocol + TCP = 6 + // UDP is for the UDP ip protocol + UDP = 17 +) + +// Protocol represents a IP protocol number +type Protocol uint8 + +func (p Protocol) String() string { + switch p { + case ICMP: + return "icmp" + case TCP: + return "tcp" + case UDP: + return "udp" + default: + return fmt.Sprintf("%d", p) + } +} + +// ParseProtocol returns the respective Protocol type for the passed string +func ParseProtocol(s string) Protocol { + switch strings.ToLower(s) { + case "icmp": + return ICMP + case "udp": + return UDP + case "tcp": + return TCP + default: + return 0 + } +} + +// GetMacCopy returns a copy of the passed MAC address +func GetMacCopy(from net.HardwareAddr) net.HardwareAddr { + if from == nil { + return nil + } + to := make(net.HardwareAddr, len(from)) + copy(to, from) + return to +} + +// GetIPCopy returns a copy of the passed IP address +func GetIPCopy(from net.IP) net.IP { + if from == nil { + return nil + } + to := make(net.IP, len(from)) + copy(to, from) + return to +} + +// GetIPNetCopy returns a copy of the passed IP Network +func GetIPNetCopy(from *net.IPNet) *net.IPNet { + if from == nil { + return nil + } + bm := make(net.IPMask, len(from.Mask)) + copy(bm, from.Mask) + return &net.IPNet{IP: GetIPCopy(from.IP), Mask: bm} +} + +// GetIPNetCanonical returns the canonical form for the passed network +func GetIPNetCanonical(nw *net.IPNet) *net.IPNet { + if nw == nil { + return nil + } + c := GetIPNetCopy(nw) + c.IP = c.IP.Mask(nw.Mask) + return c +} + +// CompareIPNet returns equal if the two IP Networks are equal +func CompareIPNet(a, b *net.IPNet) bool { + if a == b { + return true + } + if a == nil || b == nil { + return false + } + return a.IP.Equal(b.IP) && bytes.Equal(a.Mask, b.Mask) +} + +// GetMinimalIP returns the address in its shortest form +func GetMinimalIP(ip net.IP) net.IP { + if ip != nil && ip.To4() != nil { + return ip.To4() + } + return ip +} + +// GetMinimalIPNet returns a copy of the passed IP Network with congruent ip and mask notation +func GetMinimalIPNet(nw *net.IPNet) *net.IPNet { + if nw == nil { + return nil + } + if len(nw.IP) == 16 && nw.IP.To4() != nil { + m := nw.Mask + if len(m) == 16 { + m = m[12:16] + } + return &net.IPNet{IP: nw.IP.To4(), Mask: m} + } + return nw +} + +var v4inV6MaskPrefix = []byte{0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff} + +// compareIPMask checks if the passed ip and mask are semantically compatible. +// It returns the byte indexes for the address and mask so that caller can +// do bitwise operations without modifying address representation. +func compareIPMask(ip net.IP, mask net.IPMask) (is int, ms int, err error) { + // Find the effective starting of address and mask + if len(ip) == net.IPv6len && ip.To4() != nil { + is = 12 + } + if len(ip[is:]) == net.IPv4len && len(mask) == net.IPv6len && bytes.Equal(mask[:12], v4inV6MaskPrefix) { + ms = 12 + } + // Check if address and mask are semantically compatible + if len(ip[is:]) != len(mask[ms:]) { + err = fmt.Errorf("ip and mask are not compatible: (%#v, %#v)", ip, mask) + } + return +} + +// GetHostPartIP returns the host portion of the ip address identified by the mask. +// IP address representation is not modified. If address and mask are not compatible +// an error is returned. +func GetHostPartIP(ip net.IP, mask net.IPMask) (net.IP, error) { + // Find the effective starting of address and mask + is, ms, err := compareIPMask(ip, mask) + if err != nil { + return nil, fmt.Errorf("cannot compute host portion ip address because %s", err) + } + + // Compute host portion + out := GetIPCopy(ip) + for i := 0; i < len(mask[ms:]); i++ { + out[is+i] &= ^mask[ms+i] + } + + return out, nil +} + +// GetBroadcastIP returns the broadcast ip address for the passed network (ip and mask). +// IP address representation is not modified. If address and mask are not compatible +// an error is returned. +func GetBroadcastIP(ip net.IP, mask net.IPMask) (net.IP, error) { + // Find the effective starting of address and mask + is, ms, err := compareIPMask(ip, mask) + if err != nil { + return nil, fmt.Errorf("cannot compute broadcast ip address because %s", err) + } + + // Compute broadcast address + out := GetIPCopy(ip) + for i := 0; i < len(mask[ms:]); i++ { + out[is+i] |= ^mask[ms+i] + } + + return out, nil +} + +// ParseCIDR returns the *net.IPNet represented by the passed CIDR notation +func ParseCIDR(cidr string) (n *net.IPNet, e error) { + var i net.IP + if i, n, e = net.ParseCIDR(cidr); e == nil { + n.IP = i + } + return +} + +const ( + // NEXTHOP indicates a StaticRoute with an IP next hop. + NEXTHOP = iota + + // CONNECTED indicates a StaticRoute with a interface for directly connected peers. + CONNECTED +) + +// StaticRoute is a statically-provisioned IP route. +type StaticRoute struct { + Destination *net.IPNet + + RouteType int // NEXT_HOP or CONNECTED + + // NextHop will be resolved by the kernel (i.e. as a loose hop). + NextHop net.IP +} + +// GetCopy returns a copy of this StaticRoute structure +func (r *StaticRoute) GetCopy() *StaticRoute { + d := GetIPNetCopy(r.Destination) + nh := GetIPCopy(r.NextHop) + return &StaticRoute{Destination: d, + RouteType: r.RouteType, + NextHop: nh, + } +} + +// InterfaceStatistics represents the interface's statistics +type InterfaceStatistics struct { + RxBytes uint64 + RxPackets uint64 + RxErrors uint64 + RxDropped uint64 + TxBytes uint64 + TxPackets uint64 + TxErrors uint64 + TxDropped uint64 +} + +func (is *InterfaceStatistics) String() string { + return fmt.Sprintf("\nRxBytes: %d, RxPackets: %d, RxErrors: %d, RxDropped: %d, TxBytes: %d, TxPackets: %d, TxErrors: %d, TxDropped: %d", + is.RxBytes, is.RxPackets, is.RxErrors, is.RxDropped, is.TxBytes, is.TxPackets, is.TxErrors, is.TxDropped) +} + +/****************************** + * Well-known Error Interfaces + ******************************/ + +// MaskableError is an interface for errors which can be ignored by caller +type MaskableError interface { + // Maskable makes implementer into MaskableError type + Maskable() +} + +// RetryError is an interface for errors which might get resolved through retry +type RetryError interface { + // Retry makes implementer into RetryError type + Retry() +} + +// BadRequestError is an interface for errors originated by a bad request +type BadRequestError interface { + // BadRequest makes implementer into BadRequestError type + BadRequest() +} + +// NotFoundError is an interface for errors raised because a needed resource is not available +type NotFoundError interface { + // NotFound makes implementer into NotFoundError type + NotFound() +} + +// ForbiddenError is an interface for errors which denote an valid request that cannot be honored +type ForbiddenError interface { + // Forbidden makes implementer into ForbiddenError type + Forbidden() +} + +// NoServiceError is an interface for errors returned when the required service is not available +type NoServiceError interface { + // NoService makes implementer into NoServiceError type + NoService() +} + +// TimeoutError is an interface for errors raised because of timeout +type TimeoutError interface { + // Timeout makes implementer into TimeoutError type + Timeout() +} + +// NotImplementedError is an interface for errors raised because of requested functionality is not yet implemented +type NotImplementedError interface { + // NotImplemented makes implementer into NotImplementedError type + NotImplemented() +} + +// InternalError is an interface for errors raised because of an internal error +type InternalError interface { + // Internal makes implementer into InternalError type + Internal() +} + +/****************************** + * Well-known Error Formatters + ******************************/ + +// BadRequestErrorf creates an instance of BadRequestError +func BadRequestErrorf(format string, params ...interface{}) error { + return badRequest(fmt.Sprintf(format, params...)) +} + +// NotFoundErrorf creates an instance of NotFoundError +func NotFoundErrorf(format string, params ...interface{}) error { + return notFound(fmt.Sprintf(format, params...)) +} + +// ForbiddenErrorf creates an instance of ForbiddenError +func ForbiddenErrorf(format string, params ...interface{}) error { + return forbidden(fmt.Sprintf(format, params...)) +} + +// NoServiceErrorf creates an instance of NoServiceError +func NoServiceErrorf(format string, params ...interface{}) error { + return noService(fmt.Sprintf(format, params...)) +} + +// NotImplementedErrorf creates an instance of NotImplementedError +func NotImplementedErrorf(format string, params ...interface{}) error { + return notImpl(fmt.Sprintf(format, params...)) +} + +// TimeoutErrorf creates an instance of TimeoutError +func TimeoutErrorf(format string, params ...interface{}) error { + return timeout(fmt.Sprintf(format, params...)) +} + +// InternalErrorf creates an instance of InternalError +func InternalErrorf(format string, params ...interface{}) error { + return internal(fmt.Sprintf(format, params...)) +} + +// InternalMaskableErrorf creates an instance of InternalError and MaskableError +func InternalMaskableErrorf(format string, params ...interface{}) error { + return maskInternal(fmt.Sprintf(format, params...)) +} + +// RetryErrorf creates an instance of RetryError +func RetryErrorf(format string, params ...interface{}) error { + return retry(fmt.Sprintf(format, params...)) +} + +/*********************** + * Internal Error Types + ***********************/ +type badRequest string + +func (br badRequest) Error() string { + return string(br) +} +func (br badRequest) BadRequest() {} + +type maskBadRequest string + +type notFound string + +func (nf notFound) Error() string { + return string(nf) +} +func (nf notFound) NotFound() {} + +type forbidden string + +func (frb forbidden) Error() string { + return string(frb) +} +func (frb forbidden) Forbidden() {} + +type noService string + +func (ns noService) Error() string { + return string(ns) +} +func (ns noService) NoService() {} + +type maskNoService string + +type timeout string + +func (to timeout) Error() string { + return string(to) +} +func (to timeout) Timeout() {} + +type notImpl string + +func (ni notImpl) Error() string { + return string(ni) +} +func (ni notImpl) NotImplemented() {} + +type internal string + +func (nt internal) Error() string { + return string(nt) +} +func (nt internal) Internal() {} + +type maskInternal string + +func (mnt maskInternal) Error() string { + return string(mnt) +} +func (mnt maskInternal) Internal() {} +func (mnt maskInternal) Maskable() {} + +type retry string + +func (r retry) Error() string { + return string(r) +} +func (r retry) Retry() {} diff --git a/vendor/src/github.com/docker/libnetwork/wrapmake.sh b/vendor/src/github.com/docker/libnetwork/wrapmake.sh new file mode 100755 index 0000000000..d1a51a845f --- /dev/null +++ b/vendor/src/github.com/docker/libnetwork/wrapmake.sh @@ -0,0 +1,11 @@ +#!/usr/bin/env bash + +set -e + +function raise() +{ + kill -$1 0 +} + +trap "raise SIGINT" SIGINT +make $1 diff --git a/vendor/src/github.com/docker/libtrust/CONTRIBUTING.md b/vendor/src/github.com/docker/libtrust/CONTRIBUTING.md new file mode 100644 index 0000000000..05be0f8ab3 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/CONTRIBUTING.md @@ -0,0 +1,13 @@ +# Contributing to libtrust + +Want to hack on libtrust? Awesome! Here are instructions to get you +started. + +libtrust is a part of the [Docker](https://www.docker.com) project, and follows +the same rules and principles. If you're already familiar with the way +Docker does things, you'll feel right at home. + +Otherwise, go read +[Docker's contributions guidelines](https://github.com/docker/docker/blob/master/CONTRIBUTING.md). + +Happy hacking! diff --git a/vendor/src/github.com/docker/libtrust/LICENSE b/vendor/src/github.com/docker/libtrust/LICENSE new file mode 100644 index 0000000000..27448585ad --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/LICENSE @@ -0,0 +1,191 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + Copyright 2014 Docker, Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/vendor/src/github.com/docker/libtrust/MAINTAINERS b/vendor/src/github.com/docker/libtrust/MAINTAINERS new file mode 100644 index 0000000000..9768175feb --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/MAINTAINERS @@ -0,0 +1,3 @@ +Solomon Hykes +Josh Hawn (github: jlhawn) +Derek McGowan (github: dmcgowan) diff --git a/vendor/src/github.com/docker/libtrust/README.md b/vendor/src/github.com/docker/libtrust/README.md new file mode 100644 index 0000000000..8e7db38186 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/README.md @@ -0,0 +1,18 @@ +# libtrust + +Libtrust is library for managing authentication and authorization using public key cryptography. + +Authentication is handled using the identity attached to the public key. +Libtrust provides multiple methods to prove possession of the private key associated with an identity. + - TLS x509 certificates + - Signature verification + - Key Challenge + +Authorization and access control is managed through a distributed trust graph. +Trust servers are used as the authorities of the trust graph and allow caching portions of the graph for faster access. + +## Copyright and license + +Code and documentation copyright 2014 Docker, inc. Code released under the Apache 2.0 license. +Docs released under Creative commons. + diff --git a/vendor/src/github.com/docker/libtrust/certificates.go b/vendor/src/github.com/docker/libtrust/certificates.go new file mode 100644 index 0000000000..3dcca33cb1 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/certificates.go @@ -0,0 +1,175 @@ +package libtrust + +import ( + "crypto/rand" + "crypto/x509" + "crypto/x509/pkix" + "encoding/pem" + "fmt" + "io/ioutil" + "math/big" + "net" + "time" +) + +type certTemplateInfo struct { + commonName string + domains []string + ipAddresses []net.IP + isCA bool + clientAuth bool + serverAuth bool +} + +func generateCertTemplate(info *certTemplateInfo) *x509.Certificate { + // Generate a certificate template which is valid from the past week to + // 10 years from now. The usage of the certificate depends on the + // specified fields in the given certTempInfo object. + var ( + keyUsage x509.KeyUsage + extKeyUsage []x509.ExtKeyUsage + ) + + if info.isCA { + keyUsage = x509.KeyUsageCertSign + } + + if info.clientAuth { + extKeyUsage = append(extKeyUsage, x509.ExtKeyUsageClientAuth) + } + + if info.serverAuth { + extKeyUsage = append(extKeyUsage, x509.ExtKeyUsageServerAuth) + } + + return &x509.Certificate{ + SerialNumber: big.NewInt(0), + Subject: pkix.Name{ + CommonName: info.commonName, + }, + NotBefore: time.Now().Add(-time.Hour * 24 * 7), + NotAfter: time.Now().Add(time.Hour * 24 * 365 * 10), + DNSNames: info.domains, + IPAddresses: info.ipAddresses, + IsCA: info.isCA, + KeyUsage: keyUsage, + ExtKeyUsage: extKeyUsage, + BasicConstraintsValid: info.isCA, + } +} + +func generateCert(pub PublicKey, priv PrivateKey, subInfo, issInfo *certTemplateInfo) (cert *x509.Certificate, err error) { + pubCertTemplate := generateCertTemplate(subInfo) + privCertTemplate := generateCertTemplate(issInfo) + + certDER, err := x509.CreateCertificate( + rand.Reader, pubCertTemplate, privCertTemplate, + pub.CryptoPublicKey(), priv.CryptoPrivateKey(), + ) + if err != nil { + return nil, fmt.Errorf("failed to create certificate: %s", err) + } + + cert, err = x509.ParseCertificate(certDER) + if err != nil { + return nil, fmt.Errorf("failed to parse certificate: %s", err) + } + + return +} + +// GenerateSelfSignedServerCert creates a self-signed certificate for the +// given key which is to be used for TLS servers with the given domains and +// IP addresses. +func GenerateSelfSignedServerCert(key PrivateKey, domains []string, ipAddresses []net.IP) (*x509.Certificate, error) { + info := &certTemplateInfo{ + commonName: key.KeyID(), + domains: domains, + ipAddresses: ipAddresses, + serverAuth: true, + } + + return generateCert(key.PublicKey(), key, info, info) +} + +// GenerateSelfSignedClientCert creates a self-signed certificate for the +// given key which is to be used for TLS clients. +func GenerateSelfSignedClientCert(key PrivateKey) (*x509.Certificate, error) { + info := &certTemplateInfo{ + commonName: key.KeyID(), + clientAuth: true, + } + + return generateCert(key.PublicKey(), key, info, info) +} + +// GenerateCACert creates a certificate which can be used as a trusted +// certificate authority. +func GenerateCACert(signer PrivateKey, trustedKey PublicKey) (*x509.Certificate, error) { + subjectInfo := &certTemplateInfo{ + commonName: trustedKey.KeyID(), + isCA: true, + } + issuerInfo := &certTemplateInfo{ + commonName: signer.KeyID(), + } + + return generateCert(trustedKey, signer, subjectInfo, issuerInfo) +} + +// GenerateCACertPool creates a certificate authority pool to be used for a +// TLS configuration. Any self-signed certificates issued by the specified +// trusted keys will be verified during a TLS handshake +func GenerateCACertPool(signer PrivateKey, trustedKeys []PublicKey) (*x509.CertPool, error) { + certPool := x509.NewCertPool() + + for _, trustedKey := range trustedKeys { + cert, err := GenerateCACert(signer, trustedKey) + if err != nil { + return nil, fmt.Errorf("failed to generate CA certificate: %s", err) + } + + certPool.AddCert(cert) + } + + return certPool, nil +} + +// LoadCertificateBundle loads certificates from the given file. The file should be pem encoded +// containing one or more certificates. The expected pem type is "CERTIFICATE". +func LoadCertificateBundle(filename string) ([]*x509.Certificate, error) { + b, err := ioutil.ReadFile(filename) + if err != nil { + return nil, err + } + certificates := []*x509.Certificate{} + var block *pem.Block + block, b = pem.Decode(b) + for ; block != nil; block, b = pem.Decode(b) { + if block.Type == "CERTIFICATE" { + cert, err := x509.ParseCertificate(block.Bytes) + if err != nil { + return nil, err + } + certificates = append(certificates, cert) + } else { + return nil, fmt.Errorf("invalid pem block type: %s", block.Type) + } + } + + return certificates, nil +} + +// LoadCertificatePool loads a CA pool from the given file. The file should be pem encoded +// containing one or more certificates. The expected pem type is "CERTIFICATE". +func LoadCertificatePool(filename string) (*x509.CertPool, error) { + certs, err := LoadCertificateBundle(filename) + if err != nil { + return nil, err + } + pool := x509.NewCertPool() + for _, cert := range certs { + pool.AddCert(cert) + } + return pool, nil +} diff --git a/vendor/src/github.com/docker/libtrust/doc.go b/vendor/src/github.com/docker/libtrust/doc.go new file mode 100644 index 0000000000..ec5d2159c1 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/doc.go @@ -0,0 +1,9 @@ +/* +Package libtrust provides an interface for managing authentication and +authorization using public key cryptography. Authentication is handled +using the identity attached to the public key and verified through TLS +x509 certificates, a key challenge, or signature. Authorization and +access control is managed through a trust graph distributed between +both remote trust servers and locally cached and managed data. +*/ +package libtrust diff --git a/vendor/src/github.com/docker/libtrust/ec_key.go b/vendor/src/github.com/docker/libtrust/ec_key.go new file mode 100644 index 0000000000..00bbe4b3ca --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/ec_key.go @@ -0,0 +1,428 @@ +package libtrust + +import ( + "crypto" + "crypto/ecdsa" + "crypto/elliptic" + "crypto/rand" + "crypto/x509" + "encoding/json" + "encoding/pem" + "errors" + "fmt" + "io" + "math/big" +) + +/* + * EC DSA PUBLIC KEY + */ + +// ecPublicKey implements a libtrust.PublicKey using elliptic curve digital +// signature algorithms. +type ecPublicKey struct { + *ecdsa.PublicKey + curveName string + signatureAlgorithm *signatureAlgorithm + extended map[string]interface{} +} + +func fromECPublicKey(cryptoPublicKey *ecdsa.PublicKey) (*ecPublicKey, error) { + curve := cryptoPublicKey.Curve + + switch { + case curve == elliptic.P256(): + return &ecPublicKey{cryptoPublicKey, "P-256", es256, map[string]interface{}{}}, nil + case curve == elliptic.P384(): + return &ecPublicKey{cryptoPublicKey, "P-384", es384, map[string]interface{}{}}, nil + case curve == elliptic.P521(): + return &ecPublicKey{cryptoPublicKey, "P-521", es512, map[string]interface{}{}}, nil + default: + return nil, errors.New("unsupported elliptic curve") + } +} + +// KeyType returns the key type for elliptic curve keys, i.e., "EC". +func (k *ecPublicKey) KeyType() string { + return "EC" +} + +// CurveName returns the elliptic curve identifier. +// Possible values are "P-256", "P-384", and "P-521". +func (k *ecPublicKey) CurveName() string { + return k.curveName +} + +// KeyID returns a distinct identifier which is unique to this Public Key. +func (k *ecPublicKey) KeyID() string { + return keyIDFromCryptoKey(k) +} + +func (k *ecPublicKey) String() string { + return fmt.Sprintf("EC Public Key <%s>", k.KeyID()) +} + +// Verify verifyies the signature of the data in the io.Reader using this +// PublicKey. The alg parameter should identify the digital signature +// algorithm which was used to produce the signature and should be supported +// by this public key. Returns a nil error if the signature is valid. +func (k *ecPublicKey) Verify(data io.Reader, alg string, signature []byte) error { + // For EC keys there is only one supported signature algorithm depending + // on the curve parameters. + if k.signatureAlgorithm.HeaderParam() != alg { + return fmt.Errorf("unable to verify signature: EC Public Key with curve %q does not support signature algorithm %q", k.curveName, alg) + } + + // signature is the concatenation of (r, s), base64Url encoded. + sigLength := len(signature) + expectedOctetLength := 2 * ((k.Params().BitSize + 7) >> 3) + if sigLength != expectedOctetLength { + return fmt.Errorf("signature length is %d octets long, should be %d", sigLength, expectedOctetLength) + } + + rBytes, sBytes := signature[:sigLength/2], signature[sigLength/2:] + r := new(big.Int).SetBytes(rBytes) + s := new(big.Int).SetBytes(sBytes) + + hasher := k.signatureAlgorithm.HashID().New() + _, err := io.Copy(hasher, data) + if err != nil { + return fmt.Errorf("error reading data to sign: %s", err) + } + hash := hasher.Sum(nil) + + if !ecdsa.Verify(k.PublicKey, hash, r, s) { + return errors.New("invalid signature") + } + + return nil +} + +// CryptoPublicKey returns the internal object which can be used as a +// crypto.PublicKey for use with other standard library operations. The type +// is either *rsa.PublicKey or *ecdsa.PublicKey +func (k *ecPublicKey) CryptoPublicKey() crypto.PublicKey { + return k.PublicKey +} + +func (k *ecPublicKey) toMap() map[string]interface{} { + jwk := make(map[string]interface{}) + for k, v := range k.extended { + jwk[k] = v + } + jwk["kty"] = k.KeyType() + jwk["kid"] = k.KeyID() + jwk["crv"] = k.CurveName() + + xBytes := k.X.Bytes() + yBytes := k.Y.Bytes() + octetLength := (k.Params().BitSize + 7) >> 3 + // MUST include leading zeros in the output so that x, y are each + // *octetLength* bytes long. + xBuf := make([]byte, octetLength-len(xBytes), octetLength) + yBuf := make([]byte, octetLength-len(yBytes), octetLength) + xBuf = append(xBuf, xBytes...) + yBuf = append(yBuf, yBytes...) + + jwk["x"] = joseBase64UrlEncode(xBuf) + jwk["y"] = joseBase64UrlEncode(yBuf) + + return jwk +} + +// MarshalJSON serializes this Public Key using the JWK JSON serialization format for +// elliptic curve keys. +func (k *ecPublicKey) MarshalJSON() (data []byte, err error) { + return json.Marshal(k.toMap()) +} + +// PEMBlock serializes this Public Key to DER-encoded PKIX format. +func (k *ecPublicKey) PEMBlock() (*pem.Block, error) { + derBytes, err := x509.MarshalPKIXPublicKey(k.PublicKey) + if err != nil { + return nil, fmt.Errorf("unable to serialize EC PublicKey to DER-encoded PKIX format: %s", err) + } + k.extended["kid"] = k.KeyID() // For display purposes. + return createPemBlock("PUBLIC KEY", derBytes, k.extended) +} + +func (k *ecPublicKey) AddExtendedField(field string, value interface{}) { + k.extended[field] = value +} + +func (k *ecPublicKey) GetExtendedField(field string) interface{} { + v, ok := k.extended[field] + if !ok { + return nil + } + return v +} + +func ecPublicKeyFromMap(jwk map[string]interface{}) (*ecPublicKey, error) { + // JWK key type (kty) has already been determined to be "EC". + // Need to extract 'crv', 'x', 'y', and 'kid' and check for + // consistency. + + // Get the curve identifier value. + crv, err := stringFromMap(jwk, "crv") + if err != nil { + return nil, fmt.Errorf("JWK EC Public Key curve identifier: %s", err) + } + + var ( + curve elliptic.Curve + sigAlg *signatureAlgorithm + ) + + switch { + case crv == "P-256": + curve = elliptic.P256() + sigAlg = es256 + case crv == "P-384": + curve = elliptic.P384() + sigAlg = es384 + case crv == "P-521": + curve = elliptic.P521() + sigAlg = es512 + default: + return nil, fmt.Errorf("JWK EC Public Key curve identifier not supported: %q\n", crv) + } + + // Get the X and Y coordinates for the public key point. + xB64Url, err := stringFromMap(jwk, "x") + if err != nil { + return nil, fmt.Errorf("JWK EC Public Key x-coordinate: %s", err) + } + x, err := parseECCoordinate(xB64Url, curve) + if err != nil { + return nil, fmt.Errorf("JWK EC Public Key x-coordinate: %s", err) + } + + yB64Url, err := stringFromMap(jwk, "y") + if err != nil { + return nil, fmt.Errorf("JWK EC Public Key y-coordinate: %s", err) + } + y, err := parseECCoordinate(yB64Url, curve) + if err != nil { + return nil, fmt.Errorf("JWK EC Public Key y-coordinate: %s", err) + } + + key := &ecPublicKey{ + PublicKey: &ecdsa.PublicKey{Curve: curve, X: x, Y: y}, + curveName: crv, signatureAlgorithm: sigAlg, + } + + // Key ID is optional too, but if it exists, it should match the key. + _, ok := jwk["kid"] + if ok { + kid, err := stringFromMap(jwk, "kid") + if err != nil { + return nil, fmt.Errorf("JWK EC Public Key ID: %s", err) + } + if kid != key.KeyID() { + return nil, fmt.Errorf("JWK EC Public Key ID does not match: %s", kid) + } + } + + key.extended = jwk + + return key, nil +} + +/* + * EC DSA PRIVATE KEY + */ + +// ecPrivateKey implements a JWK Private Key using elliptic curve digital signature +// algorithms. +type ecPrivateKey struct { + ecPublicKey + *ecdsa.PrivateKey +} + +func fromECPrivateKey(cryptoPrivateKey *ecdsa.PrivateKey) (*ecPrivateKey, error) { + publicKey, err := fromECPublicKey(&cryptoPrivateKey.PublicKey) + if err != nil { + return nil, err + } + + return &ecPrivateKey{*publicKey, cryptoPrivateKey}, nil +} + +// PublicKey returns the Public Key data associated with this Private Key. +func (k *ecPrivateKey) PublicKey() PublicKey { + return &k.ecPublicKey +} + +func (k *ecPrivateKey) String() string { + return fmt.Sprintf("EC Private Key <%s>", k.KeyID()) +} + +// Sign signs the data read from the io.Reader using a signature algorithm supported +// by the elliptic curve private key. If the specified hashing algorithm is +// supported by this key, that hash function is used to generate the signature +// otherwise the the default hashing algorithm for this key is used. Returns +// the signature and the name of the JWK signature algorithm used, e.g., +// "ES256", "ES384", "ES512". +func (k *ecPrivateKey) Sign(data io.Reader, hashID crypto.Hash) (signature []byte, alg string, err error) { + // Generate a signature of the data using the internal alg. + // The given hashId is only a suggestion, and since EC keys only support + // on signature/hash algorithm given the curve name, we disregard it for + // the elliptic curve JWK signature implementation. + hasher := k.signatureAlgorithm.HashID().New() + _, err = io.Copy(hasher, data) + if err != nil { + return nil, "", fmt.Errorf("error reading data to sign: %s", err) + } + hash := hasher.Sum(nil) + + r, s, err := ecdsa.Sign(rand.Reader, k.PrivateKey, hash) + if err != nil { + return nil, "", fmt.Errorf("error producing signature: %s", err) + } + rBytes, sBytes := r.Bytes(), s.Bytes() + octetLength := (k.ecPublicKey.Params().BitSize + 7) >> 3 + // MUST include leading zeros in the output + rBuf := make([]byte, octetLength-len(rBytes), octetLength) + sBuf := make([]byte, octetLength-len(sBytes), octetLength) + + rBuf = append(rBuf, rBytes...) + sBuf = append(sBuf, sBytes...) + + signature = append(rBuf, sBuf...) + alg = k.signatureAlgorithm.HeaderParam() + + return +} + +// CryptoPrivateKey returns the internal object which can be used as a +// crypto.PublicKey for use with other standard library operations. The type +// is either *rsa.PublicKey or *ecdsa.PublicKey +func (k *ecPrivateKey) CryptoPrivateKey() crypto.PrivateKey { + return k.PrivateKey +} + +func (k *ecPrivateKey) toMap() map[string]interface{} { + jwk := k.ecPublicKey.toMap() + + dBytes := k.D.Bytes() + // The length of this octet string MUST be ceiling(log-base-2(n)/8) + // octets (where n is the order of the curve). This is because the private + // key d must be in the interval [1, n-1] so the bitlength of d should be + // no larger than the bitlength of n-1. The easiest way to find the octet + // length is to take bitlength(n-1), add 7 to force a carry, and shift this + // bit sequence right by 3, which is essentially dividing by 8 and adding + // 1 if there is any remainder. Thus, the private key value d should be + // output to (bitlength(n-1)+7)>>3 octets. + n := k.ecPublicKey.Params().N + octetLength := (new(big.Int).Sub(n, big.NewInt(1)).BitLen() + 7) >> 3 + // Create a buffer with the necessary zero-padding. + dBuf := make([]byte, octetLength-len(dBytes), octetLength) + dBuf = append(dBuf, dBytes...) + + jwk["d"] = joseBase64UrlEncode(dBuf) + + return jwk +} + +// MarshalJSON serializes this Private Key using the JWK JSON serialization format for +// elliptic curve keys. +func (k *ecPrivateKey) MarshalJSON() (data []byte, err error) { + return json.Marshal(k.toMap()) +} + +// PEMBlock serializes this Private Key to DER-encoded PKIX format. +func (k *ecPrivateKey) PEMBlock() (*pem.Block, error) { + derBytes, err := x509.MarshalECPrivateKey(k.PrivateKey) + if err != nil { + return nil, fmt.Errorf("unable to serialize EC PrivateKey to DER-encoded PKIX format: %s", err) + } + k.extended["keyID"] = k.KeyID() // For display purposes. + return createPemBlock("EC PRIVATE KEY", derBytes, k.extended) +} + +func ecPrivateKeyFromMap(jwk map[string]interface{}) (*ecPrivateKey, error) { + dB64Url, err := stringFromMap(jwk, "d") + if err != nil { + return nil, fmt.Errorf("JWK EC Private Key: %s", err) + } + + // JWK key type (kty) has already been determined to be "EC". + // Need to extract the public key information, then extract the private + // key value 'd'. + publicKey, err := ecPublicKeyFromMap(jwk) + if err != nil { + return nil, err + } + + d, err := parseECPrivateParam(dB64Url, publicKey.Curve) + if err != nil { + return nil, fmt.Errorf("JWK EC Private Key d-param: %s", err) + } + + key := &ecPrivateKey{ + ecPublicKey: *publicKey, + PrivateKey: &ecdsa.PrivateKey{ + PublicKey: *publicKey.PublicKey, + D: d, + }, + } + + return key, nil +} + +/* + * Key Generation Functions. + */ + +func generateECPrivateKey(curve elliptic.Curve) (k *ecPrivateKey, err error) { + k = new(ecPrivateKey) + k.PrivateKey, err = ecdsa.GenerateKey(curve, rand.Reader) + if err != nil { + return nil, err + } + + k.ecPublicKey.PublicKey = &k.PrivateKey.PublicKey + k.extended = make(map[string]interface{}) + + return +} + +// GenerateECP256PrivateKey generates a key pair using elliptic curve P-256. +func GenerateECP256PrivateKey() (PrivateKey, error) { + k, err := generateECPrivateKey(elliptic.P256()) + if err != nil { + return nil, fmt.Errorf("error generating EC P-256 key: %s", err) + } + + k.curveName = "P-256" + k.signatureAlgorithm = es256 + + return k, nil +} + +// GenerateECP384PrivateKey generates a key pair using elliptic curve P-384. +func GenerateECP384PrivateKey() (PrivateKey, error) { + k, err := generateECPrivateKey(elliptic.P384()) + if err != nil { + return nil, fmt.Errorf("error generating EC P-384 key: %s", err) + } + + k.curveName = "P-384" + k.signatureAlgorithm = es384 + + return k, nil +} + +// GenerateECP521PrivateKey generates aß key pair using elliptic curve P-521. +func GenerateECP521PrivateKey() (PrivateKey, error) { + k, err := generateECPrivateKey(elliptic.P521()) + if err != nil { + return nil, fmt.Errorf("error generating EC P-521 key: %s", err) + } + + k.curveName = "P-521" + k.signatureAlgorithm = es512 + + return k, nil +} diff --git a/vendor/src/github.com/docker/libtrust/filter.go b/vendor/src/github.com/docker/libtrust/filter.go new file mode 100644 index 0000000000..5b2b4fca6f --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/filter.go @@ -0,0 +1,50 @@ +package libtrust + +import ( + "path/filepath" +) + +// FilterByHosts filters the list of PublicKeys to only those which contain a +// 'hosts' pattern which matches the given host. If *includeEmpty* is true, +// then keys which do not specify any hosts are also returned. +func FilterByHosts(keys []PublicKey, host string, includeEmpty bool) ([]PublicKey, error) { + filtered := make([]PublicKey, 0, len(keys)) + + for _, pubKey := range keys { + var hosts []string + switch v := pubKey.GetExtendedField("hosts").(type) { + case []string: + hosts = v + case []interface{}: + for _, value := range v { + h, ok := value.(string) + if !ok { + continue + } + hosts = append(hosts, h) + } + } + + if len(hosts) == 0 { + if includeEmpty { + filtered = append(filtered, pubKey) + } + continue + } + + // Check if any hosts match pattern + for _, hostPattern := range hosts { + match, err := filepath.Match(hostPattern, host) + if err != nil { + return nil, err + } + + if match { + filtered = append(filtered, pubKey) + continue + } + } + } + + return filtered, nil +} diff --git a/vendor/src/github.com/docker/libtrust/hash.go b/vendor/src/github.com/docker/libtrust/hash.go new file mode 100644 index 0000000000..a2df787dd9 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/hash.go @@ -0,0 +1,56 @@ +package libtrust + +import ( + "crypto" + _ "crypto/sha256" // Registrer SHA224 and SHA256 + _ "crypto/sha512" // Registrer SHA384 and SHA512 + "fmt" +) + +type signatureAlgorithm struct { + algHeaderParam string + hashID crypto.Hash +} + +func (h *signatureAlgorithm) HeaderParam() string { + return h.algHeaderParam +} + +func (h *signatureAlgorithm) HashID() crypto.Hash { + return h.hashID +} + +var ( + rs256 = &signatureAlgorithm{"RS256", crypto.SHA256} + rs384 = &signatureAlgorithm{"RS384", crypto.SHA384} + rs512 = &signatureAlgorithm{"RS512", crypto.SHA512} + es256 = &signatureAlgorithm{"ES256", crypto.SHA256} + es384 = &signatureAlgorithm{"ES384", crypto.SHA384} + es512 = &signatureAlgorithm{"ES512", crypto.SHA512} +) + +func rsaSignatureAlgorithmByName(alg string) (*signatureAlgorithm, error) { + switch { + case alg == "RS256": + return rs256, nil + case alg == "RS384": + return rs384, nil + case alg == "RS512": + return rs512, nil + default: + return nil, fmt.Errorf("RSA Digital Signature Algorithm %q not supported", alg) + } +} + +func rsaPKCS1v15SignatureAlgorithmForHashID(hashID crypto.Hash) *signatureAlgorithm { + switch { + case hashID == crypto.SHA512: + return rs512 + case hashID == crypto.SHA384: + return rs384 + case hashID == crypto.SHA256: + fallthrough + default: + return rs256 + } +} diff --git a/vendor/src/github.com/docker/libtrust/jsonsign.go b/vendor/src/github.com/docker/libtrust/jsonsign.go new file mode 100644 index 0000000000..cb2ca9a769 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/jsonsign.go @@ -0,0 +1,657 @@ +package libtrust + +import ( + "bytes" + "crypto" + "crypto/x509" + "encoding/base64" + "encoding/json" + "errors" + "fmt" + "sort" + "time" + "unicode" +) + +var ( + // ErrInvalidSignContent is used when the content to be signed is invalid. + ErrInvalidSignContent = errors.New("invalid sign content") + + // ErrInvalidJSONContent is used when invalid json is encountered. + ErrInvalidJSONContent = errors.New("invalid json content") + + // ErrMissingSignatureKey is used when the specified signature key + // does not exist in the JSON content. + ErrMissingSignatureKey = errors.New("missing signature key") +) + +type jsHeader struct { + JWK PublicKey `json:"jwk,omitempty"` + Algorithm string `json:"alg"` + Chain []string `json:"x5c,omitempty"` +} + +type jsSignature struct { + Header jsHeader `json:"header"` + Signature string `json:"signature"` + Protected string `json:"protected,omitempty"` +} + +type jsSignaturesSorted []jsSignature + +func (jsbkid jsSignaturesSorted) Swap(i, j int) { jsbkid[i], jsbkid[j] = jsbkid[j], jsbkid[i] } +func (jsbkid jsSignaturesSorted) Len() int { return len(jsbkid) } + +func (jsbkid jsSignaturesSorted) Less(i, j int) bool { + ki, kj := jsbkid[i].Header.JWK.KeyID(), jsbkid[j].Header.JWK.KeyID() + si, sj := jsbkid[i].Signature, jsbkid[j].Signature + + if ki == kj { + return si < sj + } + + return ki < kj +} + +type signKey struct { + PrivateKey + Chain []*x509.Certificate +} + +// JSONSignature represents a signature of a json object. +type JSONSignature struct { + payload string + signatures []jsSignature + indent string + formatLength int + formatTail []byte +} + +func newJSONSignature() *JSONSignature { + return &JSONSignature{ + signatures: make([]jsSignature, 0, 1), + } +} + +// Payload returns the encoded payload of the signature. This +// payload should not be signed directly +func (js *JSONSignature) Payload() ([]byte, error) { + return joseBase64UrlDecode(js.payload) +} + +func (js *JSONSignature) protectedHeader() (string, error) { + protected := map[string]interface{}{ + "formatLength": js.formatLength, + "formatTail": joseBase64UrlEncode(js.formatTail), + "time": time.Now().UTC().Format(time.RFC3339), + } + protectedBytes, err := json.Marshal(protected) + if err != nil { + return "", err + } + + return joseBase64UrlEncode(protectedBytes), nil +} + +func (js *JSONSignature) signBytes(protectedHeader string) ([]byte, error) { + buf := make([]byte, len(js.payload)+len(protectedHeader)+1) + copy(buf, protectedHeader) + buf[len(protectedHeader)] = '.' + copy(buf[len(protectedHeader)+1:], js.payload) + return buf, nil +} + +// Sign adds a signature using the given private key. +func (js *JSONSignature) Sign(key PrivateKey) error { + protected, err := js.protectedHeader() + if err != nil { + return err + } + signBytes, err := js.signBytes(protected) + if err != nil { + return err + } + sigBytes, algorithm, err := key.Sign(bytes.NewReader(signBytes), crypto.SHA256) + if err != nil { + return err + } + + js.signatures = append(js.signatures, jsSignature{ + Header: jsHeader{ + JWK: key.PublicKey(), + Algorithm: algorithm, + }, + Signature: joseBase64UrlEncode(sigBytes), + Protected: protected, + }) + + return nil +} + +// SignWithChain adds a signature using the given private key +// and setting the x509 chain. The public key of the first element +// in the chain must be the public key corresponding with the sign key. +func (js *JSONSignature) SignWithChain(key PrivateKey, chain []*x509.Certificate) error { + // Ensure key.Chain[0] is public key for key + //key.Chain.PublicKey + //key.PublicKey().CryptoPublicKey() + + // Verify chain + protected, err := js.protectedHeader() + if err != nil { + return err + } + signBytes, err := js.signBytes(protected) + if err != nil { + return err + } + sigBytes, algorithm, err := key.Sign(bytes.NewReader(signBytes), crypto.SHA256) + if err != nil { + return err + } + + header := jsHeader{ + Chain: make([]string, len(chain)), + Algorithm: algorithm, + } + + for i, cert := range chain { + header.Chain[i] = base64.StdEncoding.EncodeToString(cert.Raw) + } + + js.signatures = append(js.signatures, jsSignature{ + Header: header, + Signature: joseBase64UrlEncode(sigBytes), + Protected: protected, + }) + + return nil +} + +// Verify verifies all the signatures and returns the list of +// public keys used to sign. Any x509 chains are not checked. +func (js *JSONSignature) Verify() ([]PublicKey, error) { + keys := make([]PublicKey, len(js.signatures)) + for i, signature := range js.signatures { + signBytes, err := js.signBytes(signature.Protected) + if err != nil { + return nil, err + } + var publicKey PublicKey + if len(signature.Header.Chain) > 0 { + certBytes, err := base64.StdEncoding.DecodeString(signature.Header.Chain[0]) + if err != nil { + return nil, err + } + cert, err := x509.ParseCertificate(certBytes) + if err != nil { + return nil, err + } + publicKey, err = FromCryptoPublicKey(cert.PublicKey) + if err != nil { + return nil, err + } + } else if signature.Header.JWK != nil { + publicKey = signature.Header.JWK + } else { + return nil, errors.New("missing public key") + } + + sigBytes, err := joseBase64UrlDecode(signature.Signature) + if err != nil { + return nil, err + } + + err = publicKey.Verify(bytes.NewReader(signBytes), signature.Header.Algorithm, sigBytes) + if err != nil { + return nil, err + } + + keys[i] = publicKey + } + return keys, nil +} + +// VerifyChains verifies all the signatures and the chains associated +// with each signature and returns the list of verified chains. +// Signatures without an x509 chain are not checked. +func (js *JSONSignature) VerifyChains(ca *x509.CertPool) ([][]*x509.Certificate, error) { + chains := make([][]*x509.Certificate, 0, len(js.signatures)) + for _, signature := range js.signatures { + signBytes, err := js.signBytes(signature.Protected) + if err != nil { + return nil, err + } + var publicKey PublicKey + if len(signature.Header.Chain) > 0 { + certBytes, err := base64.StdEncoding.DecodeString(signature.Header.Chain[0]) + if err != nil { + return nil, err + } + cert, err := x509.ParseCertificate(certBytes) + if err != nil { + return nil, err + } + publicKey, err = FromCryptoPublicKey(cert.PublicKey) + if err != nil { + return nil, err + } + intermediates := x509.NewCertPool() + if len(signature.Header.Chain) > 1 { + intermediateChain := signature.Header.Chain[1:] + for i := range intermediateChain { + certBytes, err := base64.StdEncoding.DecodeString(intermediateChain[i]) + if err != nil { + return nil, err + } + intermediate, err := x509.ParseCertificate(certBytes) + if err != nil { + return nil, err + } + intermediates.AddCert(intermediate) + } + } + + verifyOptions := x509.VerifyOptions{ + Intermediates: intermediates, + Roots: ca, + } + + verifiedChains, err := cert.Verify(verifyOptions) + if err != nil { + return nil, err + } + chains = append(chains, verifiedChains...) + + sigBytes, err := joseBase64UrlDecode(signature.Signature) + if err != nil { + return nil, err + } + + err = publicKey.Verify(bytes.NewReader(signBytes), signature.Header.Algorithm, sigBytes) + if err != nil { + return nil, err + } + } + + } + return chains, nil +} + +// JWS returns JSON serialized JWS according to +// http://tools.ietf.org/html/draft-ietf-jose-json-web-signature-31#section-7.2 +func (js *JSONSignature) JWS() ([]byte, error) { + if len(js.signatures) == 0 { + return nil, errors.New("missing signature") + } + + sort.Sort(jsSignaturesSorted(js.signatures)) + + jsonMap := map[string]interface{}{ + "payload": js.payload, + "signatures": js.signatures, + } + + return json.MarshalIndent(jsonMap, "", " ") +} + +func notSpace(r rune) bool { + return !unicode.IsSpace(r) +} + +func detectJSONIndent(jsonContent []byte) (indent string) { + if len(jsonContent) > 2 && jsonContent[0] == '{' && jsonContent[1] == '\n' { + quoteIndex := bytes.IndexRune(jsonContent[1:], '"') + if quoteIndex > 0 { + indent = string(jsonContent[2 : quoteIndex+1]) + } + } + return +} + +type jsParsedHeader struct { + JWK json.RawMessage `json:"jwk"` + Algorithm string `json:"alg"` + Chain []string `json:"x5c"` +} + +type jsParsedSignature struct { + Header jsParsedHeader `json:"header"` + Signature string `json:"signature"` + Protected string `json:"protected"` +} + +// ParseJWS parses a JWS serialized JSON object into a Json Signature. +func ParseJWS(content []byte) (*JSONSignature, error) { + type jsParsed struct { + Payload string `json:"payload"` + Signatures []jsParsedSignature `json:"signatures"` + } + parsed := &jsParsed{} + err := json.Unmarshal(content, parsed) + if err != nil { + return nil, err + } + if len(parsed.Signatures) == 0 { + return nil, errors.New("missing signatures") + } + payload, err := joseBase64UrlDecode(parsed.Payload) + if err != nil { + return nil, err + } + + js, err := NewJSONSignature(payload) + if err != nil { + return nil, err + } + js.signatures = make([]jsSignature, len(parsed.Signatures)) + for i, signature := range parsed.Signatures { + header := jsHeader{ + Algorithm: signature.Header.Algorithm, + } + if signature.Header.Chain != nil { + header.Chain = signature.Header.Chain + } + if signature.Header.JWK != nil { + publicKey, err := UnmarshalPublicKeyJWK([]byte(signature.Header.JWK)) + if err != nil { + return nil, err + } + header.JWK = publicKey + } + js.signatures[i] = jsSignature{ + Header: header, + Signature: signature.Signature, + Protected: signature.Protected, + } + } + + return js, nil +} + +// NewJSONSignature returns a new unsigned JWS from a json byte array. +// JSONSignature will need to be signed before serializing or storing. +// Optionally, one or more signatures can be provided as byte buffers, +// containing serialized JWS signatures, to assemble a fully signed JWS +// package. It is the callers responsibility to ensure uniqueness of the +// provided signatures. +func NewJSONSignature(content []byte, signatures ...[]byte) (*JSONSignature, error) { + var dataMap map[string]interface{} + err := json.Unmarshal(content, &dataMap) + if err != nil { + return nil, err + } + + js := newJSONSignature() + js.indent = detectJSONIndent(content) + + js.payload = joseBase64UrlEncode(content) + + // Find trailing } and whitespace, put in protected header + closeIndex := bytes.LastIndexFunc(content, notSpace) + if content[closeIndex] != '}' { + return nil, ErrInvalidJSONContent + } + lastRuneIndex := bytes.LastIndexFunc(content[:closeIndex], notSpace) + if content[lastRuneIndex] == ',' { + return nil, ErrInvalidJSONContent + } + js.formatLength = lastRuneIndex + 1 + js.formatTail = content[js.formatLength:] + + if len(signatures) > 0 { + for _, signature := range signatures { + var parsedJSig jsParsedSignature + + if err := json.Unmarshal(signature, &parsedJSig); err != nil { + return nil, err + } + + // TODO(stevvooe): A lot of the code below is repeated in + // ParseJWS. It will require more refactoring to fix that. + jsig := jsSignature{ + Header: jsHeader{ + Algorithm: parsedJSig.Header.Algorithm, + }, + Signature: parsedJSig.Signature, + Protected: parsedJSig.Protected, + } + + if parsedJSig.Header.Chain != nil { + jsig.Header.Chain = parsedJSig.Header.Chain + } + + if parsedJSig.Header.JWK != nil { + publicKey, err := UnmarshalPublicKeyJWK([]byte(parsedJSig.Header.JWK)) + if err != nil { + return nil, err + } + jsig.Header.JWK = publicKey + } + + js.signatures = append(js.signatures, jsig) + } + } + + return js, nil +} + +// NewJSONSignatureFromMap returns a new unsigned JSONSignature from a map or +// struct. JWS will need to be signed before serializing or storing. +func NewJSONSignatureFromMap(content interface{}) (*JSONSignature, error) { + switch content.(type) { + case map[string]interface{}: + case struct{}: + default: + return nil, errors.New("invalid data type") + } + + js := newJSONSignature() + js.indent = " " + + payload, err := json.MarshalIndent(content, "", js.indent) + if err != nil { + return nil, err + } + js.payload = joseBase64UrlEncode(payload) + + // Remove '\n}' from formatted section, put in protected header + js.formatLength = len(payload) - 2 + js.formatTail = payload[js.formatLength:] + + return js, nil +} + +func readIntFromMap(key string, m map[string]interface{}) (int, bool) { + value, ok := m[key] + if !ok { + return 0, false + } + switch v := value.(type) { + case int: + return v, true + case float64: + return int(v), true + default: + return 0, false + } +} + +func readStringFromMap(key string, m map[string]interface{}) (v string, ok bool) { + value, ok := m[key] + if !ok { + return "", false + } + v, ok = value.(string) + return +} + +// ParsePrettySignature parses a formatted signature into a +// JSON signature. If the signatures are missing the format information +// an error is thrown. The formatted signature must be created by +// the same method as format signature. +func ParsePrettySignature(content []byte, signatureKey string) (*JSONSignature, error) { + var contentMap map[string]json.RawMessage + err := json.Unmarshal(content, &contentMap) + if err != nil { + return nil, fmt.Errorf("error unmarshalling content: %s", err) + } + sigMessage, ok := contentMap[signatureKey] + if !ok { + return nil, ErrMissingSignatureKey + } + + var signatureBlocks []jsParsedSignature + err = json.Unmarshal([]byte(sigMessage), &signatureBlocks) + if err != nil { + return nil, fmt.Errorf("error unmarshalling signatures: %s", err) + } + + js := newJSONSignature() + js.signatures = make([]jsSignature, len(signatureBlocks)) + + for i, signatureBlock := range signatureBlocks { + protectedBytes, err := joseBase64UrlDecode(signatureBlock.Protected) + if err != nil { + return nil, fmt.Errorf("base64 decode error: %s", err) + } + var protectedHeader map[string]interface{} + err = json.Unmarshal(protectedBytes, &protectedHeader) + if err != nil { + return nil, fmt.Errorf("error unmarshalling protected header: %s", err) + } + + formatLength, ok := readIntFromMap("formatLength", protectedHeader) + if !ok { + return nil, errors.New("missing formatted length") + } + encodedTail, ok := readStringFromMap("formatTail", protectedHeader) + if !ok { + return nil, errors.New("missing formatted tail") + } + formatTail, err := joseBase64UrlDecode(encodedTail) + if err != nil { + return nil, fmt.Errorf("base64 decode error on tail: %s", err) + } + if js.formatLength == 0 { + js.formatLength = formatLength + } else if js.formatLength != formatLength { + return nil, errors.New("conflicting format length") + } + if len(js.formatTail) == 0 { + js.formatTail = formatTail + } else if bytes.Compare(js.formatTail, formatTail) != 0 { + return nil, errors.New("conflicting format tail") + } + + header := jsHeader{ + Algorithm: signatureBlock.Header.Algorithm, + Chain: signatureBlock.Header.Chain, + } + if signatureBlock.Header.JWK != nil { + publicKey, err := UnmarshalPublicKeyJWK([]byte(signatureBlock.Header.JWK)) + if err != nil { + return nil, fmt.Errorf("error unmarshalling public key: %s", err) + } + header.JWK = publicKey + } + js.signatures[i] = jsSignature{ + Header: header, + Signature: signatureBlock.Signature, + Protected: signatureBlock.Protected, + } + } + if js.formatLength > len(content) { + return nil, errors.New("invalid format length") + } + formatted := make([]byte, js.formatLength+len(js.formatTail)) + copy(formatted, content[:js.formatLength]) + copy(formatted[js.formatLength:], js.formatTail) + js.indent = detectJSONIndent(formatted) + js.payload = joseBase64UrlEncode(formatted) + + return js, nil +} + +// PrettySignature formats a json signature into an easy to read +// single json serialized object. +func (js *JSONSignature) PrettySignature(signatureKey string) ([]byte, error) { + if len(js.signatures) == 0 { + return nil, errors.New("no signatures") + } + payload, err := joseBase64UrlDecode(js.payload) + if err != nil { + return nil, err + } + payload = payload[:js.formatLength] + + sort.Sort(jsSignaturesSorted(js.signatures)) + + var marshalled []byte + var marshallErr error + if js.indent != "" { + marshalled, marshallErr = json.MarshalIndent(js.signatures, js.indent, js.indent) + } else { + marshalled, marshallErr = json.Marshal(js.signatures) + } + if marshallErr != nil { + return nil, marshallErr + } + + buf := bytes.NewBuffer(make([]byte, 0, len(payload)+len(marshalled)+34)) + buf.Write(payload) + buf.WriteByte(',') + if js.indent != "" { + buf.WriteByte('\n') + buf.WriteString(js.indent) + buf.WriteByte('"') + buf.WriteString(signatureKey) + buf.WriteString("\": ") + buf.Write(marshalled) + buf.WriteByte('\n') + } else { + buf.WriteByte('"') + buf.WriteString(signatureKey) + buf.WriteString("\":") + buf.Write(marshalled) + } + buf.WriteByte('}') + + return buf.Bytes(), nil +} + +// Signatures provides the signatures on this JWS as opaque blobs, sorted by +// keyID. These blobs can be stored and reassembled with payloads. Internally, +// they are simply marshaled json web signatures but implementations should +// not rely on this. +func (js *JSONSignature) Signatures() ([][]byte, error) { + sort.Sort(jsSignaturesSorted(js.signatures)) + + var sb [][]byte + for _, jsig := range js.signatures { + p, err := json.Marshal(jsig) + if err != nil { + return nil, err + } + + sb = append(sb, p) + } + + return sb, nil +} + +// Merge combines the signatures from one or more other signatures into the +// method receiver. If the payloads differ for any argument, an error will be +// returned and the receiver will not be modified. +func (js *JSONSignature) Merge(others ...*JSONSignature) error { + merged := js.signatures + for _, other := range others { + if js.payload != other.payload { + return fmt.Errorf("payloads differ from merge target") + } + merged = append(merged, other.signatures...) + } + + js.signatures = merged + return nil +} diff --git a/vendor/src/github.com/docker/libtrust/key.go b/vendor/src/github.com/docker/libtrust/key.go new file mode 100644 index 0000000000..73642db2a8 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/key.go @@ -0,0 +1,253 @@ +package libtrust + +import ( + "crypto" + "crypto/ecdsa" + "crypto/rsa" + "crypto/x509" + "encoding/json" + "encoding/pem" + "errors" + "fmt" + "io" +) + +// PublicKey is a generic interface for a Public Key. +type PublicKey interface { + // KeyType returns the key type for this key. For elliptic curve keys, + // this value should be "EC". For RSA keys, this value should be "RSA". + KeyType() string + // KeyID returns a distinct identifier which is unique to this Public Key. + // The format generated by this library is a base32 encoding of a 240 bit + // hash of the public key data divided into 12 groups like so: + // ABCD:EFGH:IJKL:MNOP:QRST:UVWX:YZ23:4567:ABCD:EFGH:IJKL:MNOP + KeyID() string + // Verify verifyies the signature of the data in the io.Reader using this + // Public Key. The alg parameter should identify the digital signature + // algorithm which was used to produce the signature and should be + // supported by this public key. Returns a nil error if the signature + // is valid. + Verify(data io.Reader, alg string, signature []byte) error + // CryptoPublicKey returns the internal object which can be used as a + // crypto.PublicKey for use with other standard library operations. The type + // is either *rsa.PublicKey or *ecdsa.PublicKey + CryptoPublicKey() crypto.PublicKey + // These public keys can be serialized to the standard JSON encoding for + // JSON Web Keys. See section 6 of the IETF draft RFC for JOSE JSON Web + // Algorithms. + MarshalJSON() ([]byte, error) + // These keys can also be serialized to the standard PEM encoding. + PEMBlock() (*pem.Block, error) + // The string representation of a key is its key type and ID. + String() string + AddExtendedField(string, interface{}) + GetExtendedField(string) interface{} +} + +// PrivateKey is a generic interface for a Private Key. +type PrivateKey interface { + // A PrivateKey contains all fields and methods of a PublicKey of the + // same type. The MarshalJSON method also outputs the private key as a + // JSON Web Key, and the PEMBlock method outputs the private key as a + // PEM block. + PublicKey + // PublicKey returns the PublicKey associated with this PrivateKey. + PublicKey() PublicKey + // Sign signs the data read from the io.Reader using a signature algorithm + // supported by the private key. If the specified hashing algorithm is + // supported by this key, that hash function is used to generate the + // signature otherwise the the default hashing algorithm for this key is + // used. Returns the signature and identifier of the algorithm used. + Sign(data io.Reader, hashID crypto.Hash) (signature []byte, alg string, err error) + // CryptoPrivateKey returns the internal object which can be used as a + // crypto.PublicKey for use with other standard library operations. The + // type is either *rsa.PublicKey or *ecdsa.PublicKey + CryptoPrivateKey() crypto.PrivateKey +} + +// FromCryptoPublicKey returns a libtrust PublicKey representation of the given +// *ecdsa.PublicKey or *rsa.PublicKey. Returns a non-nil error when the given +// key is of an unsupported type. +func FromCryptoPublicKey(cryptoPublicKey crypto.PublicKey) (PublicKey, error) { + switch cryptoPublicKey := cryptoPublicKey.(type) { + case *ecdsa.PublicKey: + return fromECPublicKey(cryptoPublicKey) + case *rsa.PublicKey: + return fromRSAPublicKey(cryptoPublicKey), nil + default: + return nil, fmt.Errorf("public key type %T is not supported", cryptoPublicKey) + } +} + +// FromCryptoPrivateKey returns a libtrust PrivateKey representation of the given +// *ecdsa.PrivateKey or *rsa.PrivateKey. Returns a non-nil error when the given +// key is of an unsupported type. +func FromCryptoPrivateKey(cryptoPrivateKey crypto.PrivateKey) (PrivateKey, error) { + switch cryptoPrivateKey := cryptoPrivateKey.(type) { + case *ecdsa.PrivateKey: + return fromECPrivateKey(cryptoPrivateKey) + case *rsa.PrivateKey: + return fromRSAPrivateKey(cryptoPrivateKey), nil + default: + return nil, fmt.Errorf("private key type %T is not supported", cryptoPrivateKey) + } +} + +// UnmarshalPublicKeyPEM parses the PEM encoded data and returns a libtrust +// PublicKey or an error if there is a problem with the encoding. +func UnmarshalPublicKeyPEM(data []byte) (PublicKey, error) { + pemBlock, _ := pem.Decode(data) + if pemBlock == nil { + return nil, errors.New("unable to find PEM encoded data") + } else if pemBlock.Type != "PUBLIC KEY" { + return nil, fmt.Errorf("unable to get PublicKey from PEM type: %s", pemBlock.Type) + } + + return pubKeyFromPEMBlock(pemBlock) +} + +// UnmarshalPublicKeyPEMBundle parses the PEM encoded data as a bundle of +// PEM blocks appended one after the other and returns a slice of PublicKey +// objects that it finds. +func UnmarshalPublicKeyPEMBundle(data []byte) ([]PublicKey, error) { + pubKeys := []PublicKey{} + + for { + var pemBlock *pem.Block + pemBlock, data = pem.Decode(data) + if pemBlock == nil { + break + } else if pemBlock.Type != "PUBLIC KEY" { + return nil, fmt.Errorf("unable to get PublicKey from PEM type: %s", pemBlock.Type) + } + + pubKey, err := pubKeyFromPEMBlock(pemBlock) + if err != nil { + return nil, err + } + + pubKeys = append(pubKeys, pubKey) + } + + return pubKeys, nil +} + +// UnmarshalPrivateKeyPEM parses the PEM encoded data and returns a libtrust +// PrivateKey or an error if there is a problem with the encoding. +func UnmarshalPrivateKeyPEM(data []byte) (PrivateKey, error) { + pemBlock, _ := pem.Decode(data) + if pemBlock == nil { + return nil, errors.New("unable to find PEM encoded data") + } + + var key PrivateKey + + switch { + case pemBlock.Type == "RSA PRIVATE KEY": + rsaPrivateKey, err := x509.ParsePKCS1PrivateKey(pemBlock.Bytes) + if err != nil { + return nil, fmt.Errorf("unable to decode RSA Private Key PEM data: %s", err) + } + key = fromRSAPrivateKey(rsaPrivateKey) + case pemBlock.Type == "EC PRIVATE KEY": + ecPrivateKey, err := x509.ParseECPrivateKey(pemBlock.Bytes) + if err != nil { + return nil, fmt.Errorf("unable to decode EC Private Key PEM data: %s", err) + } + key, err = fromECPrivateKey(ecPrivateKey) + if err != nil { + return nil, err + } + default: + return nil, fmt.Errorf("unable to get PrivateKey from PEM type: %s", pemBlock.Type) + } + + addPEMHeadersToKey(pemBlock, key.PublicKey()) + + return key, nil +} + +// UnmarshalPublicKeyJWK unmarshals the given JSON Web Key into a generic +// Public Key to be used with libtrust. +func UnmarshalPublicKeyJWK(data []byte) (PublicKey, error) { + jwk := make(map[string]interface{}) + + err := json.Unmarshal(data, &jwk) + if err != nil { + return nil, fmt.Errorf( + "decoding JWK Public Key JSON data: %s\n", err, + ) + } + + // Get the Key Type value. + kty, err := stringFromMap(jwk, "kty") + if err != nil { + return nil, fmt.Errorf("JWK Public Key type: %s", err) + } + + switch { + case kty == "EC": + // Call out to unmarshal EC public key. + return ecPublicKeyFromMap(jwk) + case kty == "RSA": + // Call out to unmarshal RSA public key. + return rsaPublicKeyFromMap(jwk) + default: + return nil, fmt.Errorf( + "JWK Public Key type not supported: %q\n", kty, + ) + } +} + +// UnmarshalPublicKeyJWKSet parses the JSON encoded data as a JSON Web Key Set +// and returns a slice of Public Key objects. +func UnmarshalPublicKeyJWKSet(data []byte) ([]PublicKey, error) { + rawKeys, err := loadJSONKeySetRaw(data) + if err != nil { + return nil, err + } + + pubKeys := make([]PublicKey, 0, len(rawKeys)) + + for _, rawKey := range rawKeys { + pubKey, err := UnmarshalPublicKeyJWK(rawKey) + if err != nil { + return nil, err + } + pubKeys = append(pubKeys, pubKey) + } + + return pubKeys, nil +} + +// UnmarshalPrivateKeyJWK unmarshals the given JSON Web Key into a generic +// Private Key to be used with libtrust. +func UnmarshalPrivateKeyJWK(data []byte) (PrivateKey, error) { + jwk := make(map[string]interface{}) + + err := json.Unmarshal(data, &jwk) + if err != nil { + return nil, fmt.Errorf( + "decoding JWK Private Key JSON data: %s\n", err, + ) + } + + // Get the Key Type value. + kty, err := stringFromMap(jwk, "kty") + if err != nil { + return nil, fmt.Errorf("JWK Private Key type: %s", err) + } + + switch { + case kty == "EC": + // Call out to unmarshal EC private key. + return ecPrivateKeyFromMap(jwk) + case kty == "RSA": + // Call out to unmarshal RSA private key. + return rsaPrivateKeyFromMap(jwk) + default: + return nil, fmt.Errorf( + "JWK Private Key type not supported: %q\n", kty, + ) + } +} diff --git a/vendor/src/github.com/docker/libtrust/key_files.go b/vendor/src/github.com/docker/libtrust/key_files.go new file mode 100644 index 0000000000..c526de5455 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/key_files.go @@ -0,0 +1,255 @@ +package libtrust + +import ( + "encoding/json" + "encoding/pem" + "errors" + "fmt" + "io/ioutil" + "os" + "strings" +) + +var ( + // ErrKeyFileDoesNotExist indicates that the private key file does not exist. + ErrKeyFileDoesNotExist = errors.New("key file does not exist") +) + +func readKeyFileBytes(filename string) ([]byte, error) { + data, err := ioutil.ReadFile(filename) + if err != nil { + if os.IsNotExist(err) { + err = ErrKeyFileDoesNotExist + } else { + err = fmt.Errorf("unable to read key file %s: %s", filename, err) + } + + return nil, err + } + + return data, nil +} + +/* + Loading and Saving of Public and Private Keys in either PEM or JWK format. +*/ + +// LoadKeyFile opens the given filename and attempts to read a Private Key +// encoded in either PEM or JWK format (if .json or .jwk file extension). +func LoadKeyFile(filename string) (PrivateKey, error) { + contents, err := readKeyFileBytes(filename) + if err != nil { + return nil, err + } + + var key PrivateKey + + if strings.HasSuffix(filename, ".json") || strings.HasSuffix(filename, ".jwk") { + key, err = UnmarshalPrivateKeyJWK(contents) + if err != nil { + return nil, fmt.Errorf("unable to decode private key JWK: %s", err) + } + } else { + key, err = UnmarshalPrivateKeyPEM(contents) + if err != nil { + return nil, fmt.Errorf("unable to decode private key PEM: %s", err) + } + } + + return key, nil +} + +// LoadPublicKeyFile opens the given filename and attempts to read a Public Key +// encoded in either PEM or JWK format (if .json or .jwk file extension). +func LoadPublicKeyFile(filename string) (PublicKey, error) { + contents, err := readKeyFileBytes(filename) + if err != nil { + return nil, err + } + + var key PublicKey + + if strings.HasSuffix(filename, ".json") || strings.HasSuffix(filename, ".jwk") { + key, err = UnmarshalPublicKeyJWK(contents) + if err != nil { + return nil, fmt.Errorf("unable to decode public key JWK: %s", err) + } + } else { + key, err = UnmarshalPublicKeyPEM(contents) + if err != nil { + return nil, fmt.Errorf("unable to decode public key PEM: %s", err) + } + } + + return key, nil +} + +// SaveKey saves the given key to a file using the provided filename. +// This process will overwrite any existing file at the provided location. +func SaveKey(filename string, key PrivateKey) error { + var encodedKey []byte + var err error + + if strings.HasSuffix(filename, ".json") || strings.HasSuffix(filename, ".jwk") { + // Encode in JSON Web Key format. + encodedKey, err = json.MarshalIndent(key, "", " ") + if err != nil { + return fmt.Errorf("unable to encode private key JWK: %s", err) + } + } else { + // Encode in PEM format. + pemBlock, err := key.PEMBlock() + if err != nil { + return fmt.Errorf("unable to encode private key PEM: %s", err) + } + encodedKey = pem.EncodeToMemory(pemBlock) + } + + err = ioutil.WriteFile(filename, encodedKey, os.FileMode(0600)) + if err != nil { + return fmt.Errorf("unable to write private key file %s: %s", filename, err) + } + + return nil +} + +// SavePublicKey saves the given public key to the file. +func SavePublicKey(filename string, key PublicKey) error { + var encodedKey []byte + var err error + + if strings.HasSuffix(filename, ".json") || strings.HasSuffix(filename, ".jwk") { + // Encode in JSON Web Key format. + encodedKey, err = json.MarshalIndent(key, "", " ") + if err != nil { + return fmt.Errorf("unable to encode public key JWK: %s", err) + } + } else { + // Encode in PEM format. + pemBlock, err := key.PEMBlock() + if err != nil { + return fmt.Errorf("unable to encode public key PEM: %s", err) + } + encodedKey = pem.EncodeToMemory(pemBlock) + } + + err = ioutil.WriteFile(filename, encodedKey, os.FileMode(0644)) + if err != nil { + return fmt.Errorf("unable to write public key file %s: %s", filename, err) + } + + return nil +} + +// Public Key Set files + +type jwkSet struct { + Keys []json.RawMessage `json:"keys"` +} + +// LoadKeySetFile loads a key set +func LoadKeySetFile(filename string) ([]PublicKey, error) { + if strings.HasSuffix(filename, ".json") || strings.HasSuffix(filename, ".jwk") { + return loadJSONKeySetFile(filename) + } + + // Must be a PEM format file + return loadPEMKeySetFile(filename) +} + +func loadJSONKeySetRaw(data []byte) ([]json.RawMessage, error) { + if len(data) == 0 { + // This is okay, just return an empty slice. + return []json.RawMessage{}, nil + } + + keySet := jwkSet{} + + err := json.Unmarshal(data, &keySet) + if err != nil { + return nil, fmt.Errorf("unable to decode JSON Web Key Set: %s", err) + } + + return keySet.Keys, nil +} + +func loadJSONKeySetFile(filename string) ([]PublicKey, error) { + contents, err := readKeyFileBytes(filename) + if err != nil && err != ErrKeyFileDoesNotExist { + return nil, err + } + + return UnmarshalPublicKeyJWKSet(contents) +} + +func loadPEMKeySetFile(filename string) ([]PublicKey, error) { + data, err := readKeyFileBytes(filename) + if err != nil && err != ErrKeyFileDoesNotExist { + return nil, err + } + + return UnmarshalPublicKeyPEMBundle(data) +} + +// AddKeySetFile adds a key to a key set +func AddKeySetFile(filename string, key PublicKey) error { + if strings.HasSuffix(filename, ".json") || strings.HasSuffix(filename, ".jwk") { + return addKeySetJSONFile(filename, key) + } + + // Must be a PEM format file + return addKeySetPEMFile(filename, key) +} + +func addKeySetJSONFile(filename string, key PublicKey) error { + encodedKey, err := json.Marshal(key) + if err != nil { + return fmt.Errorf("unable to encode trusted client key: %s", err) + } + + contents, err := readKeyFileBytes(filename) + if err != nil && err != ErrKeyFileDoesNotExist { + return err + } + + rawEntries, err := loadJSONKeySetRaw(contents) + if err != nil { + return err + } + + rawEntries = append(rawEntries, json.RawMessage(encodedKey)) + entriesWrapper := jwkSet{Keys: rawEntries} + + encodedEntries, err := json.MarshalIndent(entriesWrapper, "", " ") + if err != nil { + return fmt.Errorf("unable to encode trusted client keys: %s", err) + } + + err = ioutil.WriteFile(filename, encodedEntries, os.FileMode(0644)) + if err != nil { + return fmt.Errorf("unable to write trusted client keys file %s: %s", filename, err) + } + + return nil +} + +func addKeySetPEMFile(filename string, key PublicKey) error { + // Encode to PEM, open file for appending, write PEM. + file, err := os.OpenFile(filename, os.O_CREATE|os.O_APPEND|os.O_RDWR, os.FileMode(0644)) + if err != nil { + return fmt.Errorf("unable to open trusted client keys file %s: %s", filename, err) + } + defer file.Close() + + pemBlock, err := key.PEMBlock() + if err != nil { + return fmt.Errorf("unable to encoded trusted key: %s", err) + } + + _, err = file.Write(pem.EncodeToMemory(pemBlock)) + if err != nil { + return fmt.Errorf("unable to write trusted keys file: %s", err) + } + + return nil +} diff --git a/vendor/src/github.com/docker/libtrust/key_manager.go b/vendor/src/github.com/docker/libtrust/key_manager.go new file mode 100644 index 0000000000..9a98ae3574 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/key_manager.go @@ -0,0 +1,175 @@ +package libtrust + +import ( + "crypto/tls" + "crypto/x509" + "fmt" + "io/ioutil" + "net" + "os" + "path" + "sync" +) + +// ClientKeyManager manages client keys on the filesystem +type ClientKeyManager struct { + key PrivateKey + clientFile string + clientDir string + + clientLock sync.RWMutex + clients []PublicKey + + configLock sync.Mutex + configs []*tls.Config +} + +// NewClientKeyManager loads a new manager from a set of key files +// and managed by the given private key. +func NewClientKeyManager(trustKey PrivateKey, clientFile, clientDir string) (*ClientKeyManager, error) { + m := &ClientKeyManager{ + key: trustKey, + clientFile: clientFile, + clientDir: clientDir, + } + if err := m.loadKeys(); err != nil { + return nil, err + } + // TODO Start watching file and directory + + return m, nil +} + +func (c *ClientKeyManager) loadKeys() (err error) { + // Load authorized keys file + var clients []PublicKey + if c.clientFile != "" { + clients, err = LoadKeySetFile(c.clientFile) + if err != nil { + return fmt.Errorf("unable to load authorized keys: %s", err) + } + } + + // Add clients from authorized keys directory + files, err := ioutil.ReadDir(c.clientDir) + if err != nil && !os.IsNotExist(err) { + return fmt.Errorf("unable to open authorized keys directory: %s", err) + } + for _, f := range files { + if !f.IsDir() { + publicKey, err := LoadPublicKeyFile(path.Join(c.clientDir, f.Name())) + if err != nil { + return fmt.Errorf("unable to load authorized key file: %s", err) + } + clients = append(clients, publicKey) + } + } + + c.clientLock.Lock() + c.clients = clients + c.clientLock.Unlock() + + return nil +} + +// RegisterTLSConfig registers a tls configuration to manager +// such that any changes to the keys may be reflected in +// the tls client CA pool +func (c *ClientKeyManager) RegisterTLSConfig(tlsConfig *tls.Config) error { + c.clientLock.RLock() + certPool, err := GenerateCACertPool(c.key, c.clients) + if err != nil { + return fmt.Errorf("CA pool generation error: %s", err) + } + c.clientLock.RUnlock() + + tlsConfig.ClientCAs = certPool + + c.configLock.Lock() + c.configs = append(c.configs, tlsConfig) + c.configLock.Unlock() + + return nil +} + +// NewIdentityAuthTLSConfig creates a tls.Config for the server to use for +// libtrust identity authentication for the domain specified +func NewIdentityAuthTLSConfig(trustKey PrivateKey, clients *ClientKeyManager, addr string, domain string) (*tls.Config, error) { + tlsConfig := newTLSConfig() + + tlsConfig.ClientAuth = tls.RequireAndVerifyClientCert + if err := clients.RegisterTLSConfig(tlsConfig); err != nil { + return nil, err + } + + // Generate cert + ips, domains, err := parseAddr(addr) + if err != nil { + return nil, err + } + // add domain that it expects clients to use + domains = append(domains, domain) + x509Cert, err := GenerateSelfSignedServerCert(trustKey, domains, ips) + if err != nil { + return nil, fmt.Errorf("certificate generation error: %s", err) + } + tlsConfig.Certificates = []tls.Certificate{{ + Certificate: [][]byte{x509Cert.Raw}, + PrivateKey: trustKey.CryptoPrivateKey(), + Leaf: x509Cert, + }} + + return tlsConfig, nil +} + +// NewCertAuthTLSConfig creates a tls.Config for the server to use for +// certificate authentication +func NewCertAuthTLSConfig(caPath, certPath, keyPath string) (*tls.Config, error) { + tlsConfig := newTLSConfig() + + cert, err := tls.LoadX509KeyPair(certPath, keyPath) + if err != nil { + return nil, fmt.Errorf("Couldn't load X509 key pair (%s, %s): %s. Key encrypted?", certPath, keyPath, err) + } + tlsConfig.Certificates = []tls.Certificate{cert} + + // Verify client certificates against a CA? + if caPath != "" { + certPool := x509.NewCertPool() + file, err := ioutil.ReadFile(caPath) + if err != nil { + return nil, fmt.Errorf("Couldn't read CA certificate: %s", err) + } + certPool.AppendCertsFromPEM(file) + + tlsConfig.ClientAuth = tls.RequireAndVerifyClientCert + tlsConfig.ClientCAs = certPool + } + + return tlsConfig, nil +} + +func newTLSConfig() *tls.Config { + return &tls.Config{ + NextProtos: []string{"http/1.1"}, + // Avoid fallback on insecure SSL protocols + MinVersion: tls.VersionTLS10, + } +} + +// parseAddr parses an address into an array of IPs and domains +func parseAddr(addr string) ([]net.IP, []string, error) { + host, _, err := net.SplitHostPort(addr) + if err != nil { + return nil, nil, err + } + var domains []string + var ips []net.IP + ip := net.ParseIP(host) + if ip != nil { + ips = []net.IP{ip} + } else { + domains = []string{host} + } + return ips, domains, nil +} diff --git a/vendor/src/github.com/docker/libtrust/rsa_key.go b/vendor/src/github.com/docker/libtrust/rsa_key.go new file mode 100644 index 0000000000..dac4cacf20 --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/rsa_key.go @@ -0,0 +1,427 @@ +package libtrust + +import ( + "crypto" + "crypto/rand" + "crypto/rsa" + "crypto/x509" + "encoding/json" + "encoding/pem" + "errors" + "fmt" + "io" + "math/big" +) + +/* + * RSA DSA PUBLIC KEY + */ + +// rsaPublicKey implements a JWK Public Key using RSA digital signature algorithms. +type rsaPublicKey struct { + *rsa.PublicKey + extended map[string]interface{} +} + +func fromRSAPublicKey(cryptoPublicKey *rsa.PublicKey) *rsaPublicKey { + return &rsaPublicKey{cryptoPublicKey, map[string]interface{}{}} +} + +// KeyType returns the JWK key type for RSA keys, i.e., "RSA". +func (k *rsaPublicKey) KeyType() string { + return "RSA" +} + +// KeyID returns a distinct identifier which is unique to this Public Key. +func (k *rsaPublicKey) KeyID() string { + return keyIDFromCryptoKey(k) +} + +func (k *rsaPublicKey) String() string { + return fmt.Sprintf("RSA Public Key <%s>", k.KeyID()) +} + +// Verify verifyies the signature of the data in the io.Reader using this Public Key. +// The alg parameter should be the name of the JWA digital signature algorithm +// which was used to produce the signature and should be supported by this +// public key. Returns a nil error if the signature is valid. +func (k *rsaPublicKey) Verify(data io.Reader, alg string, signature []byte) error { + // Verify the signature of the given date, return non-nil error if valid. + sigAlg, err := rsaSignatureAlgorithmByName(alg) + if err != nil { + return fmt.Errorf("unable to verify Signature: %s", err) + } + + hasher := sigAlg.HashID().New() + _, err = io.Copy(hasher, data) + if err != nil { + return fmt.Errorf("error reading data to sign: %s", err) + } + hash := hasher.Sum(nil) + + err = rsa.VerifyPKCS1v15(k.PublicKey, sigAlg.HashID(), hash, signature) + if err != nil { + return fmt.Errorf("invalid %s signature: %s", sigAlg.HeaderParam(), err) + } + + return nil +} + +// CryptoPublicKey returns the internal object which can be used as a +// crypto.PublicKey for use with other standard library operations. The type +// is either *rsa.PublicKey or *ecdsa.PublicKey +func (k *rsaPublicKey) CryptoPublicKey() crypto.PublicKey { + return k.PublicKey +} + +func (k *rsaPublicKey) toMap() map[string]interface{} { + jwk := make(map[string]interface{}) + for k, v := range k.extended { + jwk[k] = v + } + jwk["kty"] = k.KeyType() + jwk["kid"] = k.KeyID() + jwk["n"] = joseBase64UrlEncode(k.N.Bytes()) + jwk["e"] = joseBase64UrlEncode(serializeRSAPublicExponentParam(k.E)) + + return jwk +} + +// MarshalJSON serializes this Public Key using the JWK JSON serialization format for +// RSA keys. +func (k *rsaPublicKey) MarshalJSON() (data []byte, err error) { + return json.Marshal(k.toMap()) +} + +// PEMBlock serializes this Public Key to DER-encoded PKIX format. +func (k *rsaPublicKey) PEMBlock() (*pem.Block, error) { + derBytes, err := x509.MarshalPKIXPublicKey(k.PublicKey) + if err != nil { + return nil, fmt.Errorf("unable to serialize RSA PublicKey to DER-encoded PKIX format: %s", err) + } + k.extended["kid"] = k.KeyID() // For display purposes. + return createPemBlock("PUBLIC KEY", derBytes, k.extended) +} + +func (k *rsaPublicKey) AddExtendedField(field string, value interface{}) { + k.extended[field] = value +} + +func (k *rsaPublicKey) GetExtendedField(field string) interface{} { + v, ok := k.extended[field] + if !ok { + return nil + } + return v +} + +func rsaPublicKeyFromMap(jwk map[string]interface{}) (*rsaPublicKey, error) { + // JWK key type (kty) has already been determined to be "RSA". + // Need to extract 'n', 'e', and 'kid' and check for + // consistency. + + // Get the modulus parameter N. + nB64Url, err := stringFromMap(jwk, "n") + if err != nil { + return nil, fmt.Errorf("JWK RSA Public Key modulus: %s", err) + } + + n, err := parseRSAModulusParam(nB64Url) + if err != nil { + return nil, fmt.Errorf("JWK RSA Public Key modulus: %s", err) + } + + // Get the public exponent E. + eB64Url, err := stringFromMap(jwk, "e") + if err != nil { + return nil, fmt.Errorf("JWK RSA Public Key exponent: %s", err) + } + + e, err := parseRSAPublicExponentParam(eB64Url) + if err != nil { + return nil, fmt.Errorf("JWK RSA Public Key exponent: %s", err) + } + + key := &rsaPublicKey{ + PublicKey: &rsa.PublicKey{N: n, E: e}, + } + + // Key ID is optional, but if it exists, it should match the key. + _, ok := jwk["kid"] + if ok { + kid, err := stringFromMap(jwk, "kid") + if err != nil { + return nil, fmt.Errorf("JWK RSA Public Key ID: %s", err) + } + if kid != key.KeyID() { + return nil, fmt.Errorf("JWK RSA Public Key ID does not match: %s", kid) + } + } + + if _, ok := jwk["d"]; ok { + return nil, fmt.Errorf("JWK RSA Public Key cannot contain private exponent") + } + + key.extended = jwk + + return key, nil +} + +/* + * RSA DSA PRIVATE KEY + */ + +// rsaPrivateKey implements a JWK Private Key using RSA digital signature algorithms. +type rsaPrivateKey struct { + rsaPublicKey + *rsa.PrivateKey +} + +func fromRSAPrivateKey(cryptoPrivateKey *rsa.PrivateKey) *rsaPrivateKey { + return &rsaPrivateKey{ + *fromRSAPublicKey(&cryptoPrivateKey.PublicKey), + cryptoPrivateKey, + } +} + +// PublicKey returns the Public Key data associated with this Private Key. +func (k *rsaPrivateKey) PublicKey() PublicKey { + return &k.rsaPublicKey +} + +func (k *rsaPrivateKey) String() string { + return fmt.Sprintf("RSA Private Key <%s>", k.KeyID()) +} + +// Sign signs the data read from the io.Reader using a signature algorithm supported +// by the RSA private key. If the specified hashing algorithm is supported by +// this key, that hash function is used to generate the signature otherwise the +// the default hashing algorithm for this key is used. Returns the signature +// and the name of the JWK signature algorithm used, e.g., "RS256", "RS384", +// "RS512". +func (k *rsaPrivateKey) Sign(data io.Reader, hashID crypto.Hash) (signature []byte, alg string, err error) { + // Generate a signature of the data using the internal alg. + sigAlg := rsaPKCS1v15SignatureAlgorithmForHashID(hashID) + hasher := sigAlg.HashID().New() + + _, err = io.Copy(hasher, data) + if err != nil { + return nil, "", fmt.Errorf("error reading data to sign: %s", err) + } + hash := hasher.Sum(nil) + + signature, err = rsa.SignPKCS1v15(rand.Reader, k.PrivateKey, sigAlg.HashID(), hash) + if err != nil { + return nil, "", fmt.Errorf("error producing signature: %s", err) + } + + alg = sigAlg.HeaderParam() + + return +} + +// CryptoPrivateKey returns the internal object which can be used as a +// crypto.PublicKey for use with other standard library operations. The type +// is either *rsa.PublicKey or *ecdsa.PublicKey +func (k *rsaPrivateKey) CryptoPrivateKey() crypto.PrivateKey { + return k.PrivateKey +} + +func (k *rsaPrivateKey) toMap() map[string]interface{} { + k.Precompute() // Make sure the precomputed values are stored. + jwk := k.rsaPublicKey.toMap() + + jwk["d"] = joseBase64UrlEncode(k.D.Bytes()) + jwk["p"] = joseBase64UrlEncode(k.Primes[0].Bytes()) + jwk["q"] = joseBase64UrlEncode(k.Primes[1].Bytes()) + jwk["dp"] = joseBase64UrlEncode(k.Precomputed.Dp.Bytes()) + jwk["dq"] = joseBase64UrlEncode(k.Precomputed.Dq.Bytes()) + jwk["qi"] = joseBase64UrlEncode(k.Precomputed.Qinv.Bytes()) + + otherPrimes := k.Primes[2:] + + if len(otherPrimes) > 0 { + otherPrimesInfo := make([]interface{}, len(otherPrimes)) + for i, r := range otherPrimes { + otherPrimeInfo := make(map[string]string, 3) + otherPrimeInfo["r"] = joseBase64UrlEncode(r.Bytes()) + crtVal := k.Precomputed.CRTValues[i] + otherPrimeInfo["d"] = joseBase64UrlEncode(crtVal.Exp.Bytes()) + otherPrimeInfo["t"] = joseBase64UrlEncode(crtVal.Coeff.Bytes()) + otherPrimesInfo[i] = otherPrimeInfo + } + jwk["oth"] = otherPrimesInfo + } + + return jwk +} + +// MarshalJSON serializes this Private Key using the JWK JSON serialization format for +// RSA keys. +func (k *rsaPrivateKey) MarshalJSON() (data []byte, err error) { + return json.Marshal(k.toMap()) +} + +// PEMBlock serializes this Private Key to DER-encoded PKIX format. +func (k *rsaPrivateKey) PEMBlock() (*pem.Block, error) { + derBytes := x509.MarshalPKCS1PrivateKey(k.PrivateKey) + k.extended["keyID"] = k.KeyID() // For display purposes. + return createPemBlock("RSA PRIVATE KEY", derBytes, k.extended) +} + +func rsaPrivateKeyFromMap(jwk map[string]interface{}) (*rsaPrivateKey, error) { + // The JWA spec for RSA Private Keys (draft rfc section 5.3.2) states that + // only the private key exponent 'd' is REQUIRED, the others are just for + // signature/decryption optimizations and SHOULD be included when the JWK + // is produced. We MAY choose to accept a JWK which only includes 'd', but + // we're going to go ahead and not choose to accept it without the extra + // fields. Only the 'oth' field will be optional (for multi-prime keys). + privateExponent, err := parseRSAPrivateKeyParamFromMap(jwk, "d") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key exponent: %s", err) + } + firstPrimeFactor, err := parseRSAPrivateKeyParamFromMap(jwk, "p") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key prime factor: %s", err) + } + secondPrimeFactor, err := parseRSAPrivateKeyParamFromMap(jwk, "q") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key prime factor: %s", err) + } + firstFactorCRT, err := parseRSAPrivateKeyParamFromMap(jwk, "dp") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key CRT exponent: %s", err) + } + secondFactorCRT, err := parseRSAPrivateKeyParamFromMap(jwk, "dq") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key CRT exponent: %s", err) + } + crtCoeff, err := parseRSAPrivateKeyParamFromMap(jwk, "qi") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key CRT coefficient: %s", err) + } + + var oth interface{} + if _, ok := jwk["oth"]; ok { + oth = jwk["oth"] + delete(jwk, "oth") + } + + // JWK key type (kty) has already been determined to be "RSA". + // Need to extract the public key information, then extract the private + // key values. + publicKey, err := rsaPublicKeyFromMap(jwk) + if err != nil { + return nil, err + } + + privateKey := &rsa.PrivateKey{ + PublicKey: *publicKey.PublicKey, + D: privateExponent, + Primes: []*big.Int{firstPrimeFactor, secondPrimeFactor}, + Precomputed: rsa.PrecomputedValues{ + Dp: firstFactorCRT, + Dq: secondFactorCRT, + Qinv: crtCoeff, + }, + } + + if oth != nil { + // Should be an array of more JSON objects. + otherPrimesInfo, ok := oth.([]interface{}) + if !ok { + return nil, errors.New("JWK RSA Private Key: Invalid other primes info: must be an array") + } + numOtherPrimeFactors := len(otherPrimesInfo) + if numOtherPrimeFactors == 0 { + return nil, errors.New("JWK RSA Privake Key: Invalid other primes info: must be absent or non-empty") + } + otherPrimeFactors := make([]*big.Int, numOtherPrimeFactors) + productOfPrimes := new(big.Int).Mul(firstPrimeFactor, secondPrimeFactor) + crtValues := make([]rsa.CRTValue, numOtherPrimeFactors) + + for i, val := range otherPrimesInfo { + otherPrimeinfo, ok := val.(map[string]interface{}) + if !ok { + return nil, errors.New("JWK RSA Private Key: Invalid other prime info: must be a JSON object") + } + + otherPrimeFactor, err := parseRSAPrivateKeyParamFromMap(otherPrimeinfo, "r") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key prime factor: %s", err) + } + otherFactorCRT, err := parseRSAPrivateKeyParamFromMap(otherPrimeinfo, "d") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key CRT exponent: %s", err) + } + otherCrtCoeff, err := parseRSAPrivateKeyParamFromMap(otherPrimeinfo, "t") + if err != nil { + return nil, fmt.Errorf("JWK RSA Private Key CRT coefficient: %s", err) + } + + crtValue := crtValues[i] + crtValue.Exp = otherFactorCRT + crtValue.Coeff = otherCrtCoeff + crtValue.R = productOfPrimes + otherPrimeFactors[i] = otherPrimeFactor + productOfPrimes = new(big.Int).Mul(productOfPrimes, otherPrimeFactor) + } + + privateKey.Primes = append(privateKey.Primes, otherPrimeFactors...) + privateKey.Precomputed.CRTValues = crtValues + } + + key := &rsaPrivateKey{ + rsaPublicKey: *publicKey, + PrivateKey: privateKey, + } + + return key, nil +} + +/* + * Key Generation Functions. + */ + +func generateRSAPrivateKey(bits int) (k *rsaPrivateKey, err error) { + k = new(rsaPrivateKey) + k.PrivateKey, err = rsa.GenerateKey(rand.Reader, bits) + if err != nil { + return nil, err + } + + k.rsaPublicKey.PublicKey = &k.PrivateKey.PublicKey + k.extended = make(map[string]interface{}) + + return +} + +// GenerateRSA2048PrivateKey generates a key pair using 2048-bit RSA. +func GenerateRSA2048PrivateKey() (PrivateKey, error) { + k, err := generateRSAPrivateKey(2048) + if err != nil { + return nil, fmt.Errorf("error generating RSA 2048-bit key: %s", err) + } + + return k, nil +} + +// GenerateRSA3072PrivateKey generates a key pair using 3072-bit RSA. +func GenerateRSA3072PrivateKey() (PrivateKey, error) { + k, err := generateRSAPrivateKey(3072) + if err != nil { + return nil, fmt.Errorf("error generating RSA 3072-bit key: %s", err) + } + + return k, nil +} + +// GenerateRSA4096PrivateKey generates a key pair using 4096-bit RSA. +func GenerateRSA4096PrivateKey() (PrivateKey, error) { + k, err := generateRSAPrivateKey(4096) + if err != nil { + return nil, fmt.Errorf("error generating RSA 4096-bit key: %s", err) + } + + return k, nil +} diff --git a/vendor/src/github.com/docker/libtrust/util.go b/vendor/src/github.com/docker/libtrust/util.go new file mode 100644 index 0000000000..d88176cc3d --- /dev/null +++ b/vendor/src/github.com/docker/libtrust/util.go @@ -0,0 +1,363 @@ +package libtrust + +import ( + "bytes" + "crypto" + "crypto/elliptic" + "crypto/tls" + "crypto/x509" + "encoding/base32" + "encoding/base64" + "encoding/binary" + "encoding/pem" + "errors" + "fmt" + "math/big" + "net/url" + "os" + "path/filepath" + "strings" + "time" +) + +// LoadOrCreateTrustKey will load a PrivateKey from the specified path +func LoadOrCreateTrustKey(trustKeyPath string) (PrivateKey, error) { + if err := os.MkdirAll(filepath.Dir(trustKeyPath), 0700); err != nil { + return nil, err + } + + trustKey, err := LoadKeyFile(trustKeyPath) + if err == ErrKeyFileDoesNotExist { + trustKey, err = GenerateECP256PrivateKey() + if err != nil { + return nil, fmt.Errorf("error generating key: %s", err) + } + + if err := SaveKey(trustKeyPath, trustKey); err != nil { + return nil, fmt.Errorf("error saving key file: %s", err) + } + + dir, file := filepath.Split(trustKeyPath) + if err := SavePublicKey(filepath.Join(dir, "public-"+file), trustKey.PublicKey()); err != nil { + return nil, fmt.Errorf("error saving public key file: %s", err) + } + } else if err != nil { + return nil, fmt.Errorf("error loading key file: %s", err) + } + return trustKey, nil +} + +// NewIdentityAuthTLSClientConfig returns a tls.Config configured to use identity +// based authentication from the specified dockerUrl, the rootConfigPath and +// the server name to which it is connecting. +// If trustUnknownHosts is true it will automatically add the host to the +// known-hosts.json in rootConfigPath. +func NewIdentityAuthTLSClientConfig(dockerUrl string, trustUnknownHosts bool, rootConfigPath string, serverName string) (*tls.Config, error) { + tlsConfig := newTLSConfig() + + trustKeyPath := filepath.Join(rootConfigPath, "key.json") + knownHostsPath := filepath.Join(rootConfigPath, "known-hosts.json") + + u, err := url.Parse(dockerUrl) + if err != nil { + return nil, fmt.Errorf("unable to parse machine url") + } + + if u.Scheme == "unix" { + return nil, nil + } + + addr := u.Host + proto := "tcp" + + trustKey, err := LoadOrCreateTrustKey(trustKeyPath) + if err != nil { + return nil, fmt.Errorf("unable to load trust key: %s", err) + } + + knownHosts, err := LoadKeySetFile(knownHostsPath) + if err != nil { + return nil, fmt.Errorf("could not load trusted hosts file: %s", err) + } + + allowedHosts, err := FilterByHosts(knownHosts, addr, false) + if err != nil { + return nil, fmt.Errorf("error filtering hosts: %s", err) + } + + certPool, err := GenerateCACertPool(trustKey, allowedHosts) + if err != nil { + return nil, fmt.Errorf("Could not create CA pool: %s", err) + } + + tlsConfig.ServerName = serverName + tlsConfig.RootCAs = certPool + + x509Cert, err := GenerateSelfSignedClientCert(trustKey) + if err != nil { + return nil, fmt.Errorf("certificate generation error: %s", err) + } + + tlsConfig.Certificates = []tls.Certificate{{ + Certificate: [][]byte{x509Cert.Raw}, + PrivateKey: trustKey.CryptoPrivateKey(), + Leaf: x509Cert, + }} + + tlsConfig.InsecureSkipVerify = true + + testConn, err := tls.Dial(proto, addr, tlsConfig) + if err != nil { + return nil, fmt.Errorf("tls Handshake error: %s", err) + } + + opts := x509.VerifyOptions{ + Roots: tlsConfig.RootCAs, + CurrentTime: time.Now(), + DNSName: tlsConfig.ServerName, + Intermediates: x509.NewCertPool(), + } + + certs := testConn.ConnectionState().PeerCertificates + for i, cert := range certs { + if i == 0 { + continue + } + opts.Intermediates.AddCert(cert) + } + + if _, err := certs[0].Verify(opts); err != nil { + if _, ok := err.(x509.UnknownAuthorityError); ok { + if trustUnknownHosts { + pubKey, err := FromCryptoPublicKey(certs[0].PublicKey) + if err != nil { + return nil, fmt.Errorf("error extracting public key from cert: %s", err) + } + + pubKey.AddExtendedField("hosts", []string{addr}) + + if err := AddKeySetFile(knownHostsPath, pubKey); err != nil { + return nil, fmt.Errorf("error adding machine to known hosts: %s", err) + } + } else { + return nil, fmt.Errorf("unable to connect. unknown host: %s", addr) + } + } + } + + testConn.Close() + tlsConfig.InsecureSkipVerify = false + + return tlsConfig, nil +} + +// joseBase64UrlEncode encodes the given data using the standard base64 url +// encoding format but with all trailing '=' characters ommitted in accordance +// with the jose specification. +// http://tools.ietf.org/html/draft-ietf-jose-json-web-signature-31#section-2 +func joseBase64UrlEncode(b []byte) string { + return strings.TrimRight(base64.URLEncoding.EncodeToString(b), "=") +} + +// joseBase64UrlDecode decodes the given string using the standard base64 url +// decoder but first adds the appropriate number of trailing '=' characters in +// accordance with the jose specification. +// http://tools.ietf.org/html/draft-ietf-jose-json-web-signature-31#section-2 +func joseBase64UrlDecode(s string) ([]byte, error) { + s = strings.Replace(s, "\n", "", -1) + s = strings.Replace(s, " ", "", -1) + switch len(s) % 4 { + case 0: + case 2: + s += "==" + case 3: + s += "=" + default: + return nil, errors.New("illegal base64url string") + } + return base64.URLEncoding.DecodeString(s) +} + +func keyIDEncode(b []byte) string { + s := strings.TrimRight(base32.StdEncoding.EncodeToString(b), "=") + var buf bytes.Buffer + var i int + for i = 0; i < len(s)/4-1; i++ { + start := i * 4 + end := start + 4 + buf.WriteString(s[start:end] + ":") + } + buf.WriteString(s[i*4:]) + return buf.String() +} + +func keyIDFromCryptoKey(pubKey PublicKey) string { + // Generate and return a 'libtrust' fingerprint of the public key. + // For an RSA key this should be: + // SHA256(DER encoded ASN1) + // Then truncated to 240 bits and encoded into 12 base32 groups like so: + // ABCD:EFGH:IJKL:MNOP:QRST:UVWX:YZ23:4567:ABCD:EFGH:IJKL:MNOP + derBytes, err := x509.MarshalPKIXPublicKey(pubKey.CryptoPublicKey()) + if err != nil { + return "" + } + hasher := crypto.SHA256.New() + hasher.Write(derBytes) + return keyIDEncode(hasher.Sum(nil)[:30]) +} + +func stringFromMap(m map[string]interface{}, key string) (string, error) { + val, ok := m[key] + if !ok { + return "", fmt.Errorf("%q value not specified", key) + } + + str, ok := val.(string) + if !ok { + return "", fmt.Errorf("%q value must be a string", key) + } + delete(m, key) + + return str, nil +} + +func parseECCoordinate(cB64Url string, curve elliptic.Curve) (*big.Int, error) { + curveByteLen := (curve.Params().BitSize + 7) >> 3 + + cBytes, err := joseBase64UrlDecode(cB64Url) + if err != nil { + return nil, fmt.Errorf("invalid base64 URL encoding: %s", err) + } + cByteLength := len(cBytes) + if cByteLength != curveByteLen { + return nil, fmt.Errorf("invalid number of octets: got %d, should be %d", cByteLength, curveByteLen) + } + return new(big.Int).SetBytes(cBytes), nil +} + +func parseECPrivateParam(dB64Url string, curve elliptic.Curve) (*big.Int, error) { + dBytes, err := joseBase64UrlDecode(dB64Url) + if err != nil { + return nil, fmt.Errorf("invalid base64 URL encoding: %s", err) + } + + // The length of this octet string MUST be ceiling(log-base-2(n)/8) + // octets (where n is the order of the curve). This is because the private + // key d must be in the interval [1, n-1] so the bitlength of d should be + // no larger than the bitlength of n-1. The easiest way to find the octet + // length is to take bitlength(n-1), add 7 to force a carry, and shift this + // bit sequence right by 3, which is essentially dividing by 8 and adding + // 1 if there is any remainder. Thus, the private key value d should be + // output to (bitlength(n-1)+7)>>3 octets. + n := curve.Params().N + octetLength := (new(big.Int).Sub(n, big.NewInt(1)).BitLen() + 7) >> 3 + dByteLength := len(dBytes) + + if dByteLength != octetLength { + return nil, fmt.Errorf("invalid number of octets: got %d, should be %d", dByteLength, octetLength) + } + + return new(big.Int).SetBytes(dBytes), nil +} + +func parseRSAModulusParam(nB64Url string) (*big.Int, error) { + nBytes, err := joseBase64UrlDecode(nB64Url) + if err != nil { + return nil, fmt.Errorf("invalid base64 URL encoding: %s", err) + } + + return new(big.Int).SetBytes(nBytes), nil +} + +func serializeRSAPublicExponentParam(e int) []byte { + // We MUST use the minimum number of octets to represent E. + // E is supposed to be 65537 for performance and security reasons + // and is what golang's rsa package generates, but it might be + // different if imported from some other generator. + buf := make([]byte, 4) + binary.BigEndian.PutUint32(buf, uint32(e)) + var i int + for i = 0; i < 8; i++ { + if buf[i] != 0 { + break + } + } + return buf[i:] +} + +func parseRSAPublicExponentParam(eB64Url string) (int, error) { + eBytes, err := joseBase64UrlDecode(eB64Url) + if err != nil { + return 0, fmt.Errorf("invalid base64 URL encoding: %s", err) + } + // Only the minimum number of bytes were used to represent E, but + // binary.BigEndian.Uint32 expects at least 4 bytes, so we need + // to add zero padding if necassary. + byteLen := len(eBytes) + buf := make([]byte, 4-byteLen, 4) + eBytes = append(buf, eBytes...) + + return int(binary.BigEndian.Uint32(eBytes)), nil +} + +func parseRSAPrivateKeyParamFromMap(m map[string]interface{}, key string) (*big.Int, error) { + b64Url, err := stringFromMap(m, key) + if err != nil { + return nil, err + } + + paramBytes, err := joseBase64UrlDecode(b64Url) + if err != nil { + return nil, fmt.Errorf("invaled base64 URL encoding: %s", err) + } + + return new(big.Int).SetBytes(paramBytes), nil +} + +func createPemBlock(name string, derBytes []byte, headers map[string]interface{}) (*pem.Block, error) { + pemBlock := &pem.Block{Type: name, Bytes: derBytes, Headers: map[string]string{}} + for k, v := range headers { + switch val := v.(type) { + case string: + pemBlock.Headers[k] = val + case []string: + if k == "hosts" { + pemBlock.Headers[k] = strings.Join(val, ",") + } else { + // Return error, non-encodable type + } + default: + // Return error, non-encodable type + } + } + + return pemBlock, nil +} + +func pubKeyFromPEMBlock(pemBlock *pem.Block) (PublicKey, error) { + cryptoPublicKey, err := x509.ParsePKIXPublicKey(pemBlock.Bytes) + if err != nil { + return nil, fmt.Errorf("unable to decode Public Key PEM data: %s", err) + } + + pubKey, err := FromCryptoPublicKey(cryptoPublicKey) + if err != nil { + return nil, err + } + + addPEMHeadersToKey(pemBlock, pubKey) + + return pubKey, nil +} + +func addPEMHeadersToKey(pemBlock *pem.Block, pubKey PublicKey) { + for key, value := range pemBlock.Headers { + var safeVal interface{} + if key == "hosts" { + safeVal = strings.Split(value, ",") + } else { + safeVal = value + } + pubKey.AddExtendedField(key, safeVal) + } +} diff --git a/vendor/src/github.com/docker/notary/LICENSE b/vendor/src/github.com/docker/notary/LICENSE new file mode 100644 index 0000000000..6daf85e9de --- /dev/null +++ b/vendor/src/github.com/docker/notary/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2015 Docker, Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/vendor/src/github.com/docker/notary/client/changelist/change.go b/vendor/src/github.com/docker/notary/client/changelist/change.go new file mode 100644 index 0000000000..dfdaed5c36 --- /dev/null +++ b/vendor/src/github.com/docker/notary/client/changelist/change.go @@ -0,0 +1,79 @@ +package changelist + +import ( + "github.com/endophage/gotuf/data" +) + +// Scopes for TufChanges are simply the TUF roles. +// Unfortunately because of targets delegations, we can only +// cover the base roles. +const ( + ScopeRoot = "root" + ScopeTargets = "targets" + ScopeSnapshot = "snapshot" + ScopeTimestamp = "timestamp" +) + +// Types for TufChanges are namespaced by the Role they +// are relevant for. The Root and Targets roles are the +// only ones for which user action can cause a change, as +// all changes in Snapshot and Timestamp are programatically +// generated base on Root and Targets changes. +const ( + TypeRootRole = "role" + TypeTargetsTarget = "target" + TypeTargetsDelegation = "delegation" +) + +// TufChange represents a change to a TUF repo +type TufChange struct { + // Abbreviated because Go doesn't permit a field and method of the same name + Actn string `json:"action"` + Role string `json:"role"` + ChangeType string `json:"type"` + ChangePath string `json:"path"` + Data []byte `json:"data"` +} + +// TufRootData represents a modification of the keys associated +// with a role that appears in the root.json +type TufRootData struct { + Keys []data.TUFKey `json:"keys"` + RoleName string `json:"role"` +} + +// NewTufChange initializes a tufChange object +func NewTufChange(action string, role, changeType, changePath string, content []byte) *TufChange { + return &TufChange{ + Actn: action, + Role: role, + ChangeType: changeType, + ChangePath: changePath, + Data: content, + } +} + +// Action return c.Actn +func (c TufChange) Action() string { + return c.Actn +} + +// Scope returns c.Role +func (c TufChange) Scope() string { + return c.Role +} + +// Type returns c.ChangeType +func (c TufChange) Type() string { + return c.ChangeType +} + +// Path return c.ChangePath +func (c TufChange) Path() string { + return c.ChangePath +} + +// Content returns c.Data +func (c TufChange) Content() []byte { + return c.Data +} diff --git a/vendor/src/github.com/docker/notary/client/changelist/changelist.go b/vendor/src/github.com/docker/notary/client/changelist/changelist.go new file mode 100644 index 0000000000..a91b16cb38 --- /dev/null +++ b/vendor/src/github.com/docker/notary/client/changelist/changelist.go @@ -0,0 +1,59 @@ +package changelist + +// memChangeList implements a simple in memory change list. +type memChangelist struct { + changes []Change +} + +// NewMemChangelist instantiates a new in-memory changelist +func NewMemChangelist() Changelist { + return &memChangelist{} +} + +// List returns a list of Changes +func (cl memChangelist) List() []Change { + return cl.changes +} + +// Add adds a change to the in-memory change list +func (cl *memChangelist) Add(c Change) error { + cl.changes = append(cl.changes, c) + return nil +} + +// Clear empties the changelist file. +func (cl *memChangelist) Clear(archive string) error { + // appending to a nil list initializes it. + cl.changes = nil + return nil +} + +// Close is a no-op in this in-memory change-list +func (cl *memChangelist) Close() error { + return nil +} + +func (cl *memChangelist) NewIterator() (ChangeIterator, error) { + return &MemChangeListIterator{index: 0, collection: cl.changes}, nil +} + +// MemChangeListIterator is a concrete instance of ChangeIterator +type MemChangeListIterator struct { + index int + collection []Change // Same type as memChangeList.changes +} + +// Next returns the next Change +func (m *MemChangeListIterator) Next() (item Change, err error) { + if m.index >= len(m.collection) { + return nil, IteratorBoundsError(m.index) + } + item = m.collection[m.index] + m.index++ + return item, err +} + +// HasNext indicates whether the iterator is exhausted +func (m *MemChangeListIterator) HasNext() bool { + return m.index < len(m.collection) +} diff --git a/vendor/src/github.com/docker/notary/client/changelist/file_changelist.go b/vendor/src/github.com/docker/notary/client/changelist/file_changelist.go new file mode 100644 index 0000000000..5ab237d82e --- /dev/null +++ b/vendor/src/github.com/docker/notary/client/changelist/file_changelist.go @@ -0,0 +1,176 @@ +package changelist + +import ( + "encoding/json" + "fmt" + "io/ioutil" + "os" + "path" + "sort" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/uuid" +) + +// FileChangelist stores all the changes as files +type FileChangelist struct { + dir string +} + +// NewFileChangelist is a convenience method for returning FileChangeLists +func NewFileChangelist(dir string) (*FileChangelist, error) { + logrus.Debug("Making dir path: ", dir) + err := os.MkdirAll(dir, 0700) + if err != nil { + return nil, err + } + return &FileChangelist{dir: dir}, nil +} + +// getFileNames reads directory, filtering out child directories +func getFileNames(dirName string) ([]os.FileInfo, error) { + var dirListing, fileInfos []os.FileInfo + dir, err := os.Open(dirName) + if err != nil { + return fileInfos, err + } + defer dir.Close() + dirListing, err = dir.Readdir(0) + if err != nil { + return fileInfos, err + } + for _, f := range dirListing { + if f.IsDir() { + continue + } + fileInfos = append(fileInfos, f) + } + return fileInfos, nil +} + +// Read a JSON formatted file from disk; convert to TufChange struct +func unmarshalFile(dirname string, f os.FileInfo) (*TufChange, error) { + c := &TufChange{} + raw, err := ioutil.ReadFile(path.Join(dirname, f.Name())) + if err != nil { + return c, err + } + err = json.Unmarshal(raw, c) + if err != nil { + return c, err + } + return c, nil +} + +// List returns a list of sorted changes +func (cl FileChangelist) List() []Change { + var changes []Change + fileInfos, err := getFileNames(cl.dir) + if err != nil { + return changes + } + sort.Sort(fileChanges(fileInfos)) + for _, f := range fileInfos { + c, err := unmarshalFile(cl.dir, f) + if err != nil { + logrus.Warn(err.Error()) + continue + } + changes = append(changes, c) + } + return changes +} + +// Add adds a change to the file change list +func (cl FileChangelist) Add(c Change) error { + cJSON, err := json.Marshal(c) + if err != nil { + return err + } + filename := fmt.Sprintf("%020d_%s.change", time.Now().UnixNano(), uuid.Generate()) + return ioutil.WriteFile(path.Join(cl.dir, filename), cJSON, 0644) +} + +// Clear clears the change list +func (cl FileChangelist) Clear(archive string) error { + dir, err := os.Open(cl.dir) + if err != nil { + return err + } + defer dir.Close() + files, err := dir.Readdir(0) + if err != nil { + return err + } + for _, f := range files { + os.Remove(path.Join(cl.dir, f.Name())) + } + return nil +} + +// Close is a no-op +func (cl FileChangelist) Close() error { + // Nothing to do here + return nil +} + +// NewIterator creates an iterator from FileChangelist +func (cl FileChangelist) NewIterator() (ChangeIterator, error) { + fileInfos, err := getFileNames(cl.dir) + if err != nil { + return &FileChangeListIterator{}, err + } + sort.Sort(fileChanges(fileInfos)) + return &FileChangeListIterator{dirname: cl.dir, collection: fileInfos}, nil +} + +// IteratorBoundsError is an Error type used by Next() +type IteratorBoundsError int + +// Error implements the Error interface +func (e IteratorBoundsError) Error() string { + return fmt.Sprintf("Iterator index (%d) out of bounds", e) +} + +// FileChangeListIterator is a concrete instance of ChangeIterator +type FileChangeListIterator struct { + index int + dirname string + collection []os.FileInfo +} + +// Next returns the next Change in the FileChangeList +func (m *FileChangeListIterator) Next() (item Change, err error) { + if m.index >= len(m.collection) { + return nil, IteratorBoundsError(m.index) + } + f := m.collection[m.index] + m.index++ + item, err = unmarshalFile(m.dirname, f) + return +} + +// HasNext indicates whether iterator is exhausted +func (m *FileChangeListIterator) HasNext() bool { + return m.index < len(m.collection) +} + +type fileChanges []os.FileInfo + +// Len returns the length of a file change list +func (cs fileChanges) Len() int { + return len(cs) +} + +// Less compares the names of two different file changes +func (cs fileChanges) Less(i, j int) bool { + return cs[i].Name() < cs[j].Name() +} + +// Swap swaps the position of two file changes +func (cs fileChanges) Swap(i, j int) { + tmp := cs[i] + cs[i] = cs[j] + cs[j] = tmp +} diff --git a/vendor/src/github.com/docker/notary/client/changelist/interface.go b/vendor/src/github.com/docker/notary/client/changelist/interface.go new file mode 100644 index 0000000000..4369623c88 --- /dev/null +++ b/vendor/src/github.com/docker/notary/client/changelist/interface.go @@ -0,0 +1,70 @@ +package changelist + +// Changelist is the interface for all TUF change lists +type Changelist interface { + // List returns the ordered list of changes + // currently stored + List() []Change + + // Add change appends the provided change to + // the list of changes + Add(Change) error + + // Clear empties the current change list. + // Archive may be provided as a directory path + // to save a copy of the changelist in that location + Clear(archive string) error + + // Close syncronizes any pending writes to the underlying + // storage and closes the file/connection + Close() error + + // NewIterator returns an iterator for walking through the list + // of changes currently stored + NewIterator() (ChangeIterator, error) +} + +const ( + // ActionCreate represents a Create action + ActionCreate = "create" + // ActionUpdate represents an Update action + ActionUpdate = "update" + // ActionDelete represents a Delete action + ActionDelete = "delete" +) + +// Change is the interface for a TUF Change +type Change interface { + // "create","update", or "delete" + Action() string + + // Where the change should be made. + // For TUF this will be the role + Scope() string + + // The content type being affected. + // For TUF this will be "target", or "delegation". + // If the type is "delegation", the Scope will be + // used to determine if a root role is being updated + // or a target delegation. + Type() string + + // Path indicates the entry within a role to be affected by the + // change. For targets, this is simply the target's path, + // for delegations it's the delegated role name. + Path() string + + // Serialized content that the interpreter of a changelist + // can use to apply the change. + // For TUF this will be the serialized JSON that needs + // to be inserted or merged. In the case of a "delete" + // action, it will be nil. + Content() []byte +} + +// ChangeIterator is the interface for iterating across collections of +// TUF Change items +type ChangeIterator interface { + Next() (Change, error) + HasNext() bool +} diff --git a/vendor/src/github.com/docker/notary/client/client.go b/vendor/src/github.com/docker/notary/client/client.go new file mode 100644 index 0000000000..ca57a89f1a --- /dev/null +++ b/vendor/src/github.com/docker/notary/client/client.go @@ -0,0 +1,659 @@ +package client + +import ( + "bytes" + "encoding/json" + "errors" + "fmt" + "io/ioutil" + "net/http" + "os" + "path/filepath" + + "github.com/Sirupsen/logrus" + "github.com/docker/notary/client/changelist" + "github.com/docker/notary/cryptoservice" + "github.com/docker/notary/keystoremanager" + "github.com/docker/notary/pkg/passphrase" + "github.com/docker/notary/trustmanager" + "github.com/endophage/gotuf" + tufclient "github.com/endophage/gotuf/client" + "github.com/endophage/gotuf/data" + tuferrors "github.com/endophage/gotuf/errors" + "github.com/endophage/gotuf/keys" + "github.com/endophage/gotuf/signed" + "github.com/endophage/gotuf/store" +) + +const maxSize = 5 << 20 + +func init() { + data.SetDefaultExpiryTimes( + map[string]int{ + "root": 3650, + "targets": 1095, + "snapshot": 1095, + }, + ) +} + +// ErrRepoNotInitialized is returned when trying to can publish on an uninitialized +// notary repository +type ErrRepoNotInitialized struct{} + +// ErrRepoNotInitialized is returned when trying to can publish on an uninitialized +// notary repository +func (err *ErrRepoNotInitialized) Error() string { + return "Repository has not been initialized" +} + +// ErrExpired is returned when the metadata for a role has expired +type ErrExpired struct { + signed.ErrExpired +} + +const ( + tufDir = "tuf" +) + +// ErrRepositoryNotExist gets returned when trying to make an action over a repository +/// that doesn't exist. +var ErrRepositoryNotExist = errors.New("repository does not exist") + +// NotaryRepository stores all the information needed to operate on a notary +// repository. +type NotaryRepository struct { + baseDir string + gun string + baseURL string + tufRepoPath string + fileStore store.MetadataStore + cryptoService signed.CryptoService + tufRepo *tuf.TufRepo + roundTrip http.RoundTripper + KeyStoreManager *keystoremanager.KeyStoreManager +} + +// Target represents a simplified version of the data TUF operates on, so external +// applications don't have to depend on tuf data types. +type Target struct { + Name string + Hashes data.Hashes + Length int64 +} + +// NewTarget is a helper method that returns a Target +func NewTarget(targetName string, targetPath string) (*Target, error) { + b, err := ioutil.ReadFile(targetPath) + if err != nil { + return nil, err + } + + meta, err := data.NewFileMeta(bytes.NewBuffer(b)) + if err != nil { + return nil, err + } + + return &Target{Name: targetName, Hashes: meta.Hashes, Length: meta.Length}, nil +} + +// NewNotaryRepository is a helper method that returns a new notary repository. +// It takes the base directory under where all the trust files will be stored +// (usually ~/.docker/trust/). +func NewNotaryRepository(baseDir, gun, baseURL string, rt http.RoundTripper, + passphraseRetriever passphrase.Retriever) (*NotaryRepository, error) { + + keyStoreManager, err := keystoremanager.NewKeyStoreManager(baseDir, passphraseRetriever) + if err != nil { + return nil, err + } + + cryptoService := cryptoservice.NewCryptoService(gun, keyStoreManager.NonRootKeyStore()) + + nRepo := &NotaryRepository{ + gun: gun, + baseDir: baseDir, + baseURL: baseURL, + tufRepoPath: filepath.Join(baseDir, tufDir, filepath.FromSlash(gun)), + cryptoService: cryptoService, + roundTrip: rt, + KeyStoreManager: keyStoreManager, + } + + fileStore, err := store.NewFilesystemStore( + nRepo.tufRepoPath, + "metadata", + "json", + "", + ) + if err != nil { + return nil, err + } + nRepo.fileStore = fileStore + + return nRepo, nil +} + +// Initialize creates a new repository by using rootKey as the root Key for the +// TUF repository. +func (r *NotaryRepository) Initialize(uCryptoService *cryptoservice.UnlockedCryptoService) error { + rootCert, err := uCryptoService.GenerateCertificate(r.gun) + if err != nil { + return err + } + r.KeyStoreManager.AddTrustedCert(rootCert) + + // The root key gets stored in the TUF metadata X509 encoded, linking + // the tuf root.json to our X509 PKI. + // If the key is RSA, we store it as type RSAx509, if it is ECDSA we store it + // as ECDSAx509 to allow the gotuf verifiers to correctly decode the + // key on verification of signatures. + var algorithmType data.KeyAlgorithm + algorithm := uCryptoService.PrivKey.Algorithm() + switch algorithm { + case data.RSAKey: + algorithmType = data.RSAx509Key + case data.ECDSAKey: + algorithmType = data.ECDSAx509Key + default: + return fmt.Errorf("invalid format for root key: %s", algorithm) + } + + // Generate a x509Key using the rootCert as the public key + rootKey := data.NewPublicKey(algorithmType, trustmanager.CertToPEM(rootCert)) + + // Creates a symlink between the certificate ID and the real public key it + // is associated with. This is used to be able to retrieve the root private key + // associated with a particular certificate + logrus.Debugf("Linking %s to %s.", rootKey.ID(), uCryptoService.ID()) + err = r.KeyStoreManager.RootKeyStore().Link(uCryptoService.ID()+"_root", rootKey.ID()+"_root") + if err != nil { + return err + } + + // All the timestamp keys are generated by the remote server. + remote, err := getRemoteStore(r.baseURL, r.gun, r.roundTrip) + if err != nil { + return err + } + rawTSKey, err := remote.GetKey("timestamp") + if err != nil { + return err + } + + parsedKey := &data.TUFKey{} + err = json.Unmarshal(rawTSKey, parsedKey) + if err != nil { + return err + } + + // Turn the JSON timestamp key from the remote server into a TUFKey + timestampKey := data.NewPublicKey(parsedKey.Algorithm(), parsedKey.Public()) + logrus.Debugf("got remote %s timestamp key with keyID: %s", parsedKey.Algorithm(), timestampKey.ID()) + + // This is currently hardcoding the targets and snapshots keys to ECDSA + // Targets and snapshot keys are always generated locally. + targetsKey, err := r.cryptoService.Create("targets", data.ECDSAKey) + if err != nil { + return err + } + snapshotKey, err := r.cryptoService.Create("snapshot", data.ECDSAKey) + if err != nil { + return err + } + + kdb := keys.NewDB() + + kdb.AddKey(rootKey) + kdb.AddKey(targetsKey) + kdb.AddKey(snapshotKey) + kdb.AddKey(timestampKey) + + err = initRoles(kdb, rootKey, targetsKey, snapshotKey, timestampKey) + if err != nil { + return err + } + + r.tufRepo = tuf.NewTufRepo(kdb, r.cryptoService) + + err = r.tufRepo.InitRoot(false) + if err != nil { + logrus.Debug("Error on InitRoot: ", err.Error()) + switch err.(type) { + case tuferrors.ErrInsufficientSignatures, trustmanager.ErrPasswordInvalid: + default: + return err + } + } + err = r.tufRepo.InitTargets() + if err != nil { + logrus.Debug("Error on InitTargets: ", err.Error()) + return err + } + err = r.tufRepo.InitSnapshot() + if err != nil { + logrus.Debug("Error on InitSnapshot: ", err.Error()) + return err + } + + return r.saveMetadata(uCryptoService.CryptoService) +} + +// AddTarget adds a new target to the repository, forcing a timestamps check from TUF +func (r *NotaryRepository) AddTarget(target *Target) error { + cl, err := changelist.NewFileChangelist(filepath.Join(r.tufRepoPath, "changelist")) + if err != nil { + return err + } + defer cl.Close() + logrus.Debugf("Adding target \"%s\" with sha256 \"%x\" and size %d bytes.\n", target.Name, target.Hashes["sha256"], target.Length) + + meta := data.FileMeta{Length: target.Length, Hashes: target.Hashes} + metaJSON, err := json.Marshal(meta) + if err != nil { + return err + } + + c := changelist.NewTufChange(changelist.ActionCreate, changelist.ScopeTargets, "target", target.Name, metaJSON) + err = cl.Add(c) + if err != nil { + return err + } + return nil +} + +// RemoveTarget creates a new changelist entry to remove a target from the repository +// when the changelist gets applied at publish time +func (r *NotaryRepository) RemoveTarget(targetName string) error { + cl, err := changelist.NewFileChangelist(filepath.Join(r.tufRepoPath, "changelist")) + if err != nil { + return err + } + logrus.Debugf("Removing target \"%s\"", targetName) + c := changelist.NewTufChange(changelist.ActionDelete, changelist.ScopeTargets, "target", targetName, nil) + err = cl.Add(c) + if err != nil { + return err + } + return nil +} + +// ListTargets lists all targets for the current repository +func (r *NotaryRepository) ListTargets() ([]*Target, error) { + c, err := r.bootstrapClient() + if err != nil { + return nil, err + } + + err = c.Update() + if err != nil { + if err, ok := err.(signed.ErrExpired); ok { + return nil, ErrExpired{err} + } + return nil, err + } + + var targetList []*Target + for name, meta := range r.tufRepo.Targets["targets"].Signed.Targets { + target := &Target{Name: name, Hashes: meta.Hashes, Length: meta.Length} + targetList = append(targetList, target) + } + + return targetList, nil +} + +// GetTargetByName returns a target given a name +func (r *NotaryRepository) GetTargetByName(name string) (*Target, error) { + c, err := r.bootstrapClient() + if err != nil { + return nil, err + } + + err = c.Update() + if err != nil { + if err, ok := err.(signed.ErrExpired); ok { + return nil, ErrExpired{err} + } + return nil, err + } + + meta, err := c.TargetMeta(name) + if meta == nil { + return nil, fmt.Errorf("No trust data for %s", name) + } else if err != nil { + return nil, err + } + + return &Target{Name: name, Hashes: meta.Hashes, Length: meta.Length}, nil +} + +// GetChangelist returns the list of the repository's unpublished changes +func (r *NotaryRepository) GetChangelist() (changelist.Changelist, error) { + changelistDir := filepath.Join(r.tufRepoPath, "changelist") + cl, err := changelist.NewFileChangelist(changelistDir) + if err != nil { + logrus.Debug("Error initializing changelist") + return nil, err + } + return cl, nil +} + +// Publish pushes the local changes in signed material to the remote notary-server +// Conceptually it performs an operation similar to a `git rebase` +func (r *NotaryRepository) Publish() error { + var updateRoot bool + var root *data.Signed + // attempt to initialize the repo from the remote store + c, err := r.bootstrapClient() + if err != nil { + if _, ok := err.(store.ErrMetaNotFound); ok { + // if the remote store return a 404 (translated into ErrMetaNotFound), + // the repo hasn't been initialized yet. Attempt to load it from disk. + err := r.bootstrapRepo() + if err != nil { + // Repo hasn't been initialized, It must be initialized before + // it can be published. Return an error and let caller determine + // what it wants to do. + logrus.Debug(err.Error()) + logrus.Debug("Repository not initialized during Publish") + return &ErrRepoNotInitialized{} + } + // We had local data but the server doesn't know about the repo yet, + // ensure we will push the initial root file + root, err = r.tufRepo.Root.ToSigned() + if err != nil { + return err + } + updateRoot = true + } else { + // The remote store returned an error other than 404. We're + // unable to determine if the repo has been initialized or not. + logrus.Error("Could not publish Repository: ", err.Error()) + return err + } + } else { + // If we were successfully able to bootstrap the client (which only pulls + // root.json), update it the rest of the tuf metadata in preparation for + // applying the changelist. + err = c.Update() + if err != nil { + if err, ok := err.(signed.ErrExpired); ok { + return ErrExpired{err} + } + return err + } + } + cl, err := r.GetChangelist() + if err != nil { + return err + } + // apply the changelist to the repo + err = applyChangelist(r.tufRepo, cl) + if err != nil { + logrus.Debug("Error applying changelist") + return err + } + + // check if our root file is nearing expiry. Resign if it is. + if nearExpiry(r.tufRepo.Root) || r.tufRepo.Root.Dirty { + if err != nil { + return err + } + rootKeyID := r.tufRepo.Root.Signed.Roles["root"].KeyIDs[0] + rootCryptoService, err := r.KeyStoreManager.GetRootCryptoService(rootKeyID) + if err != nil { + return err + } + root, err = r.tufRepo.SignRoot(data.DefaultExpires("root"), rootCryptoService.CryptoService) + if err != nil { + return err + } + updateRoot = true + } + // we will always resign targets and snapshots + targets, err := r.tufRepo.SignTargets("targets", data.DefaultExpires("targets"), nil) + if err != nil { + return err + } + snapshot, err := r.tufRepo.SignSnapshot(data.DefaultExpires("snapshot"), nil) + if err != nil { + return err + } + + remote, err := getRemoteStore(r.baseURL, r.gun, r.roundTrip) + if err != nil { + return err + } + + // ensure we can marshal all the json before sending anything to remote + targetsJSON, err := json.Marshal(targets) + if err != nil { + return err + } + snapshotJSON, err := json.Marshal(snapshot) + if err != nil { + return err + } + update := make(map[string][]byte) + // if we need to update the root, marshal it and push the update to remote + if updateRoot { + rootJSON, err := json.Marshal(root) + if err != nil { + return err + } + update["root"] = rootJSON + } + update["targets"] = targetsJSON + update["snapshot"] = snapshotJSON + err = remote.SetMultiMeta(update) + if err != nil { + return err + } + err = cl.Clear("") + if err != nil { + // This is not a critical problem when only a single host is pushing + // but will cause weird behaviour if changelist cleanup is failing + // and there are multiple hosts writing to the repo. + logrus.Warn("Unable to clear changelist. You may want to manually delete the folder ", filepath.Join(r.tufRepoPath, "changelist")) + } + return nil +} + +func (r *NotaryRepository) bootstrapRepo() error { + kdb := keys.NewDB() + tufRepo := tuf.NewTufRepo(kdb, r.cryptoService) + + logrus.Debugf("Loading trusted collection.") + rootJSON, err := r.fileStore.GetMeta("root", 0) + if err != nil { + return err + } + root := &data.SignedRoot{} + err = json.Unmarshal(rootJSON, root) + if err != nil { + return err + } + err = tufRepo.SetRoot(root) + if err != nil { + return err + } + targetsJSON, err := r.fileStore.GetMeta("targets", 0) + if err != nil { + return err + } + targets := &data.SignedTargets{} + err = json.Unmarshal(targetsJSON, targets) + if err != nil { + return err + } + tufRepo.SetTargets("targets", targets) + snapshotJSON, err := r.fileStore.GetMeta("snapshot", 0) + if err != nil { + return err + } + snapshot := &data.SignedSnapshot{} + err = json.Unmarshal(snapshotJSON, snapshot) + if err != nil { + return err + } + tufRepo.SetSnapshot(snapshot) + + r.tufRepo = tufRepo + + return nil +} + +func (r *NotaryRepository) saveMetadata(rootCryptoService signed.CryptoService) error { + logrus.Debugf("Saving changes to Trusted Collection.") + signedRoot, err := r.tufRepo.SignRoot(data.DefaultExpires("root"), rootCryptoService) + if err != nil { + return err + } + rootJSON, err := json.Marshal(signedRoot) + if err != nil { + return err + } + + targetsToSave := make(map[string][]byte) + for t := range r.tufRepo.Targets { + signedTargets, err := r.tufRepo.SignTargets(t, data.DefaultExpires("targets"), nil) + if err != nil { + return err + } + targetsJSON, err := json.Marshal(signedTargets) + if err != nil { + return err + } + targetsToSave[t] = targetsJSON + } + + signedSnapshot, err := r.tufRepo.SignSnapshot(data.DefaultExpires("snapshot"), nil) + if err != nil { + return err + } + snapshotJSON, err := json.Marshal(signedSnapshot) + if err != nil { + return err + } + + err = r.fileStore.SetMeta("root", rootJSON) + if err != nil { + return err + } + + for role, blob := range targetsToSave { + parentDir := filepath.Dir(role) + os.MkdirAll(parentDir, 0755) + r.fileStore.SetMeta(role, blob) + } + + return r.fileStore.SetMeta("snapshot", snapshotJSON) +} + +func (r *NotaryRepository) bootstrapClient() (*tufclient.Client, error) { + var rootJSON []byte + remote, err := getRemoteStore(r.baseURL, r.gun, r.roundTrip) + if err == nil { + // if remote store successfully set up, try and get root from remote + rootJSON, err = remote.GetMeta("root", maxSize) + } + + // if remote store couldn't be setup, or we failed to get a root from it + // load the root from cache (offline operation) + if err != nil { + if err, ok := err.(store.ErrMetaNotFound); ok { + // if the error was MetaNotFound then we successfully contacted + // the store and it doesn't know about the repo. + return nil, err + } + rootJSON, err = r.fileStore.GetMeta("root", maxSize) + if err != nil { + // if cache didn't return a root, we cannot proceed + return nil, store.ErrMetaNotFound{} + } + } + // can't just unmarshal into SignedRoot because validate root + // needs the root.Signed field to still be []byte for signature + // validation + root := &data.Signed{} + err = json.Unmarshal(rootJSON, root) + if err != nil { + return nil, err + } + + err = r.KeyStoreManager.ValidateRoot(root, r.gun) + if err != nil { + return nil, err + } + + kdb := keys.NewDB() + r.tufRepo = tuf.NewTufRepo(kdb, r.cryptoService) + + signedRoot, err := data.RootFromSigned(root) + if err != nil { + return nil, err + } + err = r.tufRepo.SetRoot(signedRoot) + if err != nil { + return nil, err + } + + return tufclient.NewClient( + r.tufRepo, + remote, + kdb, + r.fileStore, + ), nil +} + +// RotateKeys removes all existing keys associated with role and adds +// the keys specified by keyIDs to the role. These changes are staged +// in a changelist until publish is called. +func (r *NotaryRepository) RotateKeys() error { + for _, role := range []string{"targets", "snapshot"} { + key, err := r.cryptoService.Create(role, data.ECDSAKey) + if err != nil { + return err + } + err = r.rootFileKeyChange(role, changelist.ActionCreate, key) + if err != nil { + return err + } + } + return nil +} + +func (r *NotaryRepository) rootFileKeyChange(role, action string, key data.PublicKey) error { + cl, err := changelist.NewFileChangelist(filepath.Join(r.tufRepoPath, "changelist")) + if err != nil { + return err + } + defer cl.Close() + + k, ok := key.(*data.TUFKey) + if !ok { + return errors.New("Invalid key type found during rotation.") + } + + meta := changelist.TufRootData{ + RoleName: role, + Keys: []data.TUFKey{*k}, + } + metaJSON, err := json.Marshal(meta) + if err != nil { + return err + } + + c := changelist.NewTufChange( + action, + changelist.ScopeRoot, + changelist.TypeRootRole, + role, + metaJSON, + ) + err = cl.Add(c) + if err != nil { + return err + } + return nil +} diff --git a/vendor/src/github.com/docker/notary/client/helpers.go b/vendor/src/github.com/docker/notary/client/helpers.go new file mode 100644 index 0000000000..50be86c6ce --- /dev/null +++ b/vendor/src/github.com/docker/notary/client/helpers.go @@ -0,0 +1,150 @@ +package client + +import ( + "encoding/json" + "net/http" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/notary/client/changelist" + tuf "github.com/endophage/gotuf" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/keys" + "github.com/endophage/gotuf/store" +) + +// Use this to initialize remote HTTPStores from the config settings +func getRemoteStore(baseURL, gun string, rt http.RoundTripper) (store.RemoteStore, error) { + return store.NewHTTPStore( + baseURL+"/v2/"+gun+"/_trust/tuf/", + "", + "json", + "", + "key", + rt, + ) +} + +func applyChangelist(repo *tuf.TufRepo, cl changelist.Changelist) error { + it, err := cl.NewIterator() + if err != nil { + return err + } + index := 0 + for it.HasNext() { + c, err := it.Next() + if err != nil { + return err + } + switch c.Scope() { + case changelist.ScopeTargets: + err = applyTargetsChange(repo, c) + case changelist.ScopeRoot: + err = applyRootChange(repo, c) + default: + logrus.Debug("scope not supported: ", c.Scope()) + } + index++ + if err != nil { + return err + } + } + logrus.Debugf("applied %d change(s)", index) + return nil +} + +func applyTargetsChange(repo *tuf.TufRepo, c changelist.Change) error { + var err error + switch c.Action() { + case changelist.ActionCreate: + logrus.Debug("changelist add: ", c.Path()) + meta := &data.FileMeta{} + err = json.Unmarshal(c.Content(), meta) + if err != nil { + return err + } + files := data.Files{c.Path(): *meta} + _, err = repo.AddTargets(c.Scope(), files) + case changelist.ActionDelete: + logrus.Debug("changelist remove: ", c.Path()) + err = repo.RemoveTargets(c.Scope(), c.Path()) + default: + logrus.Debug("action not yet supported: ", c.Action()) + } + if err != nil { + return err + } + return nil +} + +func applyRootChange(repo *tuf.TufRepo, c changelist.Change) error { + var err error + switch c.Type() { + case changelist.TypeRootRole: + err = applyRootRoleChange(repo, c) + default: + logrus.Debug("type of root change not yet supported: ", c.Type()) + } + return err // might be nil +} + +func applyRootRoleChange(repo *tuf.TufRepo, c changelist.Change) error { + switch c.Action() { + case changelist.ActionCreate: + // replaces all keys for a role + d := &changelist.TufRootData{} + err := json.Unmarshal(c.Content(), d) + if err != nil { + return err + } + k := []data.PublicKey{} + for _, key := range d.Keys { + k = append(k, data.NewPublicKey(key.Algorithm(), key.Public())) + } + err = repo.ReplaceBaseKeys(d.RoleName, k...) + if err != nil { + return err + } + default: + logrus.Debug("action not yet supported for root: ", c.Action()) + } + return nil +} + +func nearExpiry(r *data.SignedRoot) bool { + plus6mo := time.Now().AddDate(0, 6, 0) + return r.Signed.Expires.Before(plus6mo) +} + +func initRoles(kdb *keys.KeyDB, rootKey, targetsKey, snapshotKey, timestampKey data.PublicKey) error { + rootRole, err := data.NewRole("root", 1, []string{rootKey.ID()}, nil, nil) + if err != nil { + return err + } + targetsRole, err := data.NewRole("targets", 1, []string{targetsKey.ID()}, nil, nil) + if err != nil { + return err + } + snapshotRole, err := data.NewRole("snapshot", 1, []string{snapshotKey.ID()}, nil, nil) + if err != nil { + return err + } + timestampRole, err := data.NewRole("timestamp", 1, []string{timestampKey.ID()}, nil, nil) + if err != nil { + return err + } + + if err := kdb.AddRole(rootRole); err != nil { + return err + } + if err := kdb.AddRole(targetsRole); err != nil { + return err + } + if err := kdb.AddRole(snapshotRole); err != nil { + return err + } + if err := kdb.AddRole(timestampRole); err != nil { + return err + } + return nil +} diff --git a/vendor/src/github.com/docker/notary/cryptoservice/crypto_service.go b/vendor/src/github.com/docker/notary/cryptoservice/crypto_service.go new file mode 100644 index 0000000000..a30a3fcc05 --- /dev/null +++ b/vendor/src/github.com/docker/notary/cryptoservice/crypto_service.go @@ -0,0 +1,199 @@ +package cryptoservice + +import ( + "crypto" + "crypto/ecdsa" + "crypto/rand" + "crypto/rsa" + "crypto/sha256" + "crypto/x509" + "fmt" + "path/filepath" + + "github.com/Sirupsen/logrus" + "github.com/agl/ed25519" + "github.com/docker/notary/trustmanager" + "github.com/endophage/gotuf/data" +) + +const ( + rsaKeySize = 2048 // Used for snapshots and targets keys +) + +// CryptoService implements Sign and Create, holding a specific GUN and keystore to +// operate on +type CryptoService struct { + gun string + keyStore trustmanager.KeyStore +} + +// NewCryptoService returns an instance of CryptoService +func NewCryptoService(gun string, keyStore trustmanager.KeyStore) *CryptoService { + return &CryptoService{gun: gun, keyStore: keyStore} +} + +// Create is used to generate keys for targets, snapshots and timestamps +func (ccs *CryptoService) Create(role string, algorithm data.KeyAlgorithm) (data.PublicKey, error) { + var privKey data.PrivateKey + var err error + + switch algorithm { + case data.RSAKey: + privKey, err = trustmanager.GenerateRSAKey(rand.Reader, rsaKeySize) + if err != nil { + return nil, fmt.Errorf("failed to generate RSA key: %v", err) + } + case data.ECDSAKey: + privKey, err = trustmanager.GenerateECDSAKey(rand.Reader) + if err != nil { + return nil, fmt.Errorf("failed to generate EC key: %v", err) + } + case data.ED25519Key: + privKey, err = trustmanager.GenerateED25519Key(rand.Reader) + if err != nil { + return nil, fmt.Errorf("failed to generate ED25519 key: %v", err) + } + default: + return nil, fmt.Errorf("private key type not supported for key generation: %s", algorithm) + } + logrus.Debugf("generated new %s key for role: %s and keyID: %s", algorithm, role, privKey.ID()) + + // Store the private key into our keystore with the name being: /GUN/ID.key with an alias of role + err = ccs.keyStore.AddKey(filepath.Join(ccs.gun, privKey.ID()), role, privKey) + if err != nil { + return nil, fmt.Errorf("failed to add key to filestore: %v", err) + } + return data.PublicKeyFromPrivate(privKey), nil +} + +// GetKey returns a key by ID +func (ccs *CryptoService) GetKey(keyID string) data.PublicKey { + key, _, err := ccs.keyStore.GetKey(keyID) + if err != nil { + return nil + } + return data.PublicKeyFromPrivate(key) +} + +// RemoveKey deletes a key by ID +func (ccs *CryptoService) RemoveKey(keyID string) error { + return ccs.keyStore.RemoveKey(keyID) +} + +// Sign returns the signatures for the payload with a set of keyIDs. It ignores +// errors to sign and expects the called to validate if the number of returned +// signatures is adequate. +func (ccs *CryptoService) Sign(keyIDs []string, payload []byte) ([]data.Signature, error) { + signatures := make([]data.Signature, 0, len(keyIDs)) + for _, keyid := range keyIDs { + // ccs.gun will be empty if this is the root key + keyName := filepath.Join(ccs.gun, keyid) + + var privKey data.PrivateKey + var err error + + privKey, _, err = ccs.keyStore.GetKey(keyName) + if err != nil { + logrus.Debugf("error attempting to retrieve key ID: %s, %v", keyid, err) + return nil, err + } + + algorithm := privKey.Algorithm() + var sigAlgorithm data.SigAlgorithm + var sig []byte + + switch algorithm { + case data.RSAKey: + sig, err = rsaSign(privKey, payload) + sigAlgorithm = data.RSAPSSSignature + case data.ECDSAKey: + sig, err = ecdsaSign(privKey, payload) + sigAlgorithm = data.ECDSASignature + case data.ED25519Key: + // ED25519 does not operate on a SHA256 hash + sig, err = ed25519Sign(privKey, payload) + sigAlgorithm = data.EDDSASignature + } + if err != nil { + logrus.Debugf("ignoring error attempting to %s sign with keyID: %s, %v", algorithm, keyid, err) + return nil, err + } + + logrus.Debugf("appending %s signature with Key ID: %s", algorithm, keyid) + + // Append signatures to result array + signatures = append(signatures, data.Signature{ + KeyID: keyid, + Method: sigAlgorithm, + Signature: sig[:], + }) + } + + return signatures, nil +} + +func rsaSign(privKey data.PrivateKey, message []byte) ([]byte, error) { + if privKey.Algorithm() != data.RSAKey { + return nil, fmt.Errorf("private key type not supported: %s", privKey.Algorithm()) + } + + hashed := sha256.Sum256(message) + + // Create an rsa.PrivateKey out of the private key bytes + rsaPrivKey, err := x509.ParsePKCS1PrivateKey(privKey.Private()) + if err != nil { + return nil, err + } + + // Use the RSA key to RSASSA-PSS sign the data + sig, err := rsa.SignPSS(rand.Reader, rsaPrivKey, crypto.SHA256, hashed[:], &rsa.PSSOptions{SaltLength: rsa.PSSSaltLengthEqualsHash}) + if err != nil { + return nil, err + } + + return sig, nil +} + +func ecdsaSign(privKey data.PrivateKey, message []byte) ([]byte, error) { + if privKey.Algorithm() != data.ECDSAKey { + return nil, fmt.Errorf("private key type not supported: %s", privKey.Algorithm()) + } + + hashed := sha256.Sum256(message) + + // Create an ecdsa.PrivateKey out of the private key bytes + ecdsaPrivKey, err := x509.ParseECPrivateKey(privKey.Private()) + if err != nil { + return nil, err + } + + // Use the ECDSA key to sign the data + r, s, err := ecdsa.Sign(rand.Reader, ecdsaPrivKey, hashed[:]) + if err != nil { + return nil, err + } + + rBytes, sBytes := r.Bytes(), s.Bytes() + octetLength := (ecdsaPrivKey.Params().BitSize + 7) >> 3 + + // MUST include leading zeros in the output + rBuf := make([]byte, octetLength-len(rBytes), octetLength) + sBuf := make([]byte, octetLength-len(sBytes), octetLength) + + rBuf = append(rBuf, rBytes...) + sBuf = append(sBuf, sBytes...) + + return append(rBuf, sBuf...), nil +} + +func ed25519Sign(privKey data.PrivateKey, message []byte) ([]byte, error) { + if privKey.Algorithm() != data.ED25519Key { + return nil, fmt.Errorf("private key type not supported: %s", privKey.Algorithm()) + } + + priv := [ed25519.PrivateKeySize]byte{} + copy(priv[:], privKey.Private()[ed25519.PublicKeySize:]) + sig := ed25519.Sign(&priv, message) + + return sig[:], nil +} diff --git a/vendor/src/github.com/docker/notary/cryptoservice/unlocked_crypto_service.go b/vendor/src/github.com/docker/notary/cryptoservice/unlocked_crypto_service.go new file mode 100644 index 0000000000..8da5d444f0 --- /dev/null +++ b/vendor/src/github.com/docker/notary/cryptoservice/unlocked_crypto_service.go @@ -0,0 +1,83 @@ +package cryptoservice + +import ( + "crypto" + "crypto/ecdsa" + "crypto/rand" + "crypto/rsa" + "crypto/x509" + "fmt" + + "github.com/docker/notary/trustmanager" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/signed" +) + +// UnlockedCryptoService encapsulates a private key and a cryptoservice that +// uses that private key, providing convinience methods for generation of +// certificates. +type UnlockedCryptoService struct { + PrivKey data.PrivateKey + CryptoService signed.CryptoService +} + +// NewUnlockedCryptoService creates an UnlockedCryptoService instance +func NewUnlockedCryptoService(privKey data.PrivateKey, cryptoService signed.CryptoService) *UnlockedCryptoService { + return &UnlockedCryptoService{ + PrivKey: privKey, + CryptoService: cryptoService, + } +} + +// ID gets a consistent ID based on the PrivateKey bytes and algorithm type +func (ucs *UnlockedCryptoService) ID() string { + return ucs.PublicKey().ID() +} + +// PublicKey Returns the public key associated with the private key +func (ucs *UnlockedCryptoService) PublicKey() data.PublicKey { + return data.PublicKeyFromPrivate(ucs.PrivKey) +} + +// GenerateCertificate generates an X509 Certificate from a template, given a GUN +func (ucs *UnlockedCryptoService) GenerateCertificate(gun string) (*x509.Certificate, error) { + algorithm := ucs.PrivKey.Algorithm() + var publicKey crypto.PublicKey + var privateKey crypto.PrivateKey + var err error + switch algorithm { + case data.RSAKey: + var rsaPrivateKey *rsa.PrivateKey + rsaPrivateKey, err = x509.ParsePKCS1PrivateKey(ucs.PrivKey.Private()) + privateKey = rsaPrivateKey + publicKey = rsaPrivateKey.Public() + case data.ECDSAKey: + var ecdsaPrivateKey *ecdsa.PrivateKey + ecdsaPrivateKey, err = x509.ParseECPrivateKey(ucs.PrivKey.Private()) + privateKey = ecdsaPrivateKey + publicKey = ecdsaPrivateKey.Public() + default: + return nil, fmt.Errorf("only RSA or ECDSA keys are currently supported. Found: %s", algorithm) + } + if err != nil { + return nil, fmt.Errorf("failed to parse root key: %s (%v)", gun, err) + } + + template, err := trustmanager.NewCertificate(gun) + if err != nil { + return nil, fmt.Errorf("failed to create the certificate template for: %s (%v)", gun, err) + } + + derBytes, err := x509.CreateCertificate(rand.Reader, template, template, publicKey, privateKey) + if err != nil { + return nil, fmt.Errorf("failed to create the certificate for: %s (%v)", gun, err) + } + + // Encode the new certificate into PEM + cert, err := x509.ParseCertificate(derBytes) + if err != nil { + return nil, fmt.Errorf("failed to parse the certificate for key: %s (%v)", gun, err) + } + + return cert, nil +} diff --git a/vendor/src/github.com/docker/notary/keystoremanager/import_export.go b/vendor/src/github.com/docker/notary/keystoremanager/import_export.go new file mode 100644 index 0000000000..7b0cee94f5 --- /dev/null +++ b/vendor/src/github.com/docker/notary/keystoremanager/import_export.go @@ -0,0 +1,402 @@ +package keystoremanager + +import ( + "archive/zip" + "crypto/x509" + "encoding/pem" + "errors" + "io" + "io/ioutil" + "os" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/notary/pkg/passphrase" + "github.com/docker/notary/trustmanager" +) + +const ( + zipSymlinkAttr = 0xA1ED0000 + zipMadeByUNIX = 3 << 8 +) + +var ( + // ErrNoValidPrivateKey is returned if a key being imported doesn't + // look like a private key + ErrNoValidPrivateKey = errors.New("no valid private key found") + + // ErrRootKeyNotEncrypted is returned if a root key being imported is + // unencrypted + ErrRootKeyNotEncrypted = errors.New("only encrypted root keys may be imported") + + // ErrNoKeysFoundForGUN is returned if no keys are found for the + // specified GUN during export + ErrNoKeysFoundForGUN = errors.New("no keys found for specified GUN") +) + +// ExportRootKey exports the specified root key to an io.Writer in PEM format. +// The key's existing encryption is preserved. +func (km *KeyStoreManager) ExportRootKey(dest io.Writer, keyID string) error { + pemBytes, err := km.rootKeyStore.Get(keyID + "_root") + if err != nil { + return err + } + + _, err = dest.Write(pemBytes) + return err +} + +// ExportRootKeyReencrypt exports the specified root key to an io.Writer in +// PEM format. The key is reencrypted with a new passphrase. +func (km *KeyStoreManager) ExportRootKeyReencrypt(dest io.Writer, keyID string, newPassphraseRetriever passphrase.Retriever) error { + privateKey, alias, err := km.rootKeyStore.GetKey(keyID) + if err != nil { + return err + } + + // Create temporary keystore to use as a staging area + tempBaseDir, err := ioutil.TempDir("", "notary-key-export-") + defer os.RemoveAll(tempBaseDir) + + privRootKeysSubdir := filepath.Join(privDir, rootKeysSubdir) + tempRootKeysPath := filepath.Join(tempBaseDir, privRootKeysSubdir) + tempRootKeyStore, err := trustmanager.NewKeyFileStore(tempRootKeysPath, newPassphraseRetriever) + if err != nil { + return err + } + + err = tempRootKeyStore.AddKey(keyID, alias, privateKey) + if err != nil { + return err + } + + pemBytes, err := tempRootKeyStore.Get(keyID + "_" + alias) + if err != nil { + return err + } + + _, err = dest.Write(pemBytes) + return err +} + +// checkRootKeyIsEncrypted makes sure the root key is encrypted. We have +// internal assumptions that depend on this. +func checkRootKeyIsEncrypted(pemBytes []byte) error { + block, _ := pem.Decode(pemBytes) + if block == nil { + return ErrNoValidPrivateKey + } + + if !x509.IsEncryptedPEMBlock(block) { + return ErrRootKeyNotEncrypted + } + + return nil +} + +// ImportRootKey imports a root in PEM format key from an io.Reader +// The key's existing encryption is preserved. The keyID parameter is +// necessary because otherwise we'd need the passphrase to decrypt the key +// in order to compute the ID. +func (km *KeyStoreManager) ImportRootKey(source io.Reader, keyID string) error { + pemBytes, err := ioutil.ReadAll(source) + if err != nil { + return err + } + + if err = checkRootKeyIsEncrypted(pemBytes); err != nil { + return err + } + + if err = km.rootKeyStore.Add(keyID+"_root", pemBytes); err != nil { + return err + } + + return err +} + +func moveKeys(oldKeyStore, newKeyStore *trustmanager.KeyFileStore) error { + // List all files but no symlinks + for f := range oldKeyStore.ListKeys() { + privateKey, alias, err := oldKeyStore.GetKey(f) + if err != nil { + return err + } + + err = newKeyStore.AddKey(f, alias, privateKey) + + if err != nil { + return err + } + } + + // Recreate symlinks + for _, relKeyPath := range oldKeyStore.ListFiles(true) { + fullKeyPath := filepath.Join(oldKeyStore.BaseDir(), relKeyPath) + + fi, err := os.Lstat(fullKeyPath) + if err != nil { + return err + } + + if (fi.Mode() & os.ModeSymlink) != 0 { + target, err := os.Readlink(fullKeyPath) + if err != nil { + return err + } + os.Symlink(target, filepath.Join(newKeyStore.BaseDir(), relKeyPath)) + } + } + + return nil +} + +func addKeysToArchive(zipWriter *zip.Writer, newKeyStore *trustmanager.KeyFileStore, subDir string) error { + for _, relKeyPath := range newKeyStore.ListFiles(true) { + fullKeyPath := filepath.Join(newKeyStore.BaseDir(), relKeyPath) + + fi, err := os.Lstat(fullKeyPath) + if err != nil { + return err + } + + infoHeader, err := zip.FileInfoHeader(fi) + if err != nil { + return err + } + + infoHeader.Name = filepath.Join(subDir, relKeyPath) + + // Is this a symlink? If so, encode properly in the zip file. + if (fi.Mode() & os.ModeSymlink) != 0 { + infoHeader.CreatorVersion = zipMadeByUNIX + infoHeader.ExternalAttrs = zipSymlinkAttr + + zipFileEntryWriter, err := zipWriter.CreateHeader(infoHeader) + if err != nil { + return err + } + + target, err := os.Readlink(fullKeyPath) + if err != nil { + return err + } + + // Write relative path + if _, err = zipFileEntryWriter.Write([]byte(target)); err != nil { + return err + } + } else { + zipFileEntryWriter, err := zipWriter.CreateHeader(infoHeader) + if err != nil { + return err + } + + fileContents, err := ioutil.ReadFile(fullKeyPath) + if err != nil { + return err + } + + if _, err = zipFileEntryWriter.Write(fileContents); err != nil { + return err + } + } + } + + return nil +} + +// ExportAllKeys exports all keys to an io.Writer in zip format. +// newPassphraseRetriever will be used to obtain passphrases to use to encrypt the existing keys. +func (km *KeyStoreManager) ExportAllKeys(dest io.Writer, newPassphraseRetriever passphrase.Retriever) error { + tempBaseDir, err := ioutil.TempDir("", "notary-key-export-") + defer os.RemoveAll(tempBaseDir) + + privNonRootKeysSubdir := filepath.Join(privDir, nonRootKeysSubdir) + privRootKeysSubdir := filepath.Join(privDir, rootKeysSubdir) + + // Create temporary keystores to use as a staging area + tempNonRootKeysPath := filepath.Join(tempBaseDir, privNonRootKeysSubdir) + tempNonRootKeyStore, err := trustmanager.NewKeyFileStore(tempNonRootKeysPath, newPassphraseRetriever) + if err != nil { + return err + } + + tempRootKeysPath := filepath.Join(tempBaseDir, privRootKeysSubdir) + tempRootKeyStore, err := trustmanager.NewKeyFileStore(tempRootKeysPath, newPassphraseRetriever) + if err != nil { + return err + } + + if err := moveKeys(km.rootKeyStore, tempRootKeyStore); err != nil { + return err + } + if err := moveKeys(km.nonRootKeyStore, tempNonRootKeyStore); err != nil { + return err + } + + zipWriter := zip.NewWriter(dest) + + if err := addKeysToArchive(zipWriter, tempRootKeyStore, privRootKeysSubdir); err != nil { + return err + } + if err := addKeysToArchive(zipWriter, tempNonRootKeyStore, privNonRootKeysSubdir); err != nil { + return err + } + + zipWriter.Close() + + return nil +} + +// IsZipSymlink returns true if the file described by the zip file header is a +// symlink. +func IsZipSymlink(f *zip.File) bool { + return f.CreatorVersion&0xFF00 == zipMadeByUNIX && f.ExternalAttrs == zipSymlinkAttr +} + +// ImportKeysZip imports keys from a zip file provided as an zip.Reader. The +// keys in the root_keys directory are left encrypted, but the other keys are +// decrypted with the specified passphrase. +func (km *KeyStoreManager) ImportKeysZip(zipReader zip.Reader) error { + // Temporarily store the keys in maps, so we can bail early if there's + // an error (for example, wrong passphrase), without leaving the key + // store in an inconsistent state + newRootKeys := make(map[string][]byte) + newNonRootKeys := make(map[string][]byte) + + // Note that using / as a separator is okay here - the zip package + // guarantees that the separator will be / + rootKeysPrefix := privDir + "/" + rootKeysSubdir + "/" + nonRootKeysPrefix := privDir + "/" + nonRootKeysSubdir + "/" + + // Iterate through the files in the archive. Don't add the keys + for _, f := range zipReader.File { + fNameTrimmed := strings.TrimSuffix(f.Name, filepath.Ext(f.Name)) + + rc, err := f.Open() + if err != nil { + return err + } + + fileBytes, err := ioutil.ReadAll(rc) + if err != nil { + return nil + } + + // Is this in the root_keys directory? + // Note that using / as a separator is okay here - the zip + // package guarantees that the separator will be / + if strings.HasPrefix(fNameTrimmed, rootKeysPrefix) { + if IsZipSymlink(f) { + newName := filepath.Join(km.rootKeyStore.BaseDir(), strings.TrimPrefix(f.Name, rootKeysPrefix)) + err = os.Symlink(string(fileBytes), newName) + if err != nil { + return err + } + } else { + if err = checkRootKeyIsEncrypted(fileBytes); err != nil { + rc.Close() + return err + } + // Root keys are preserved without decrypting + keyName := strings.TrimPrefix(fNameTrimmed, rootKeysPrefix) + newRootKeys[keyName] = fileBytes + } + } else if strings.HasPrefix(fNameTrimmed, nonRootKeysPrefix) { + if IsZipSymlink(f) { + newName := filepath.Join(km.nonRootKeyStore.BaseDir(), strings.TrimPrefix(f.Name, nonRootKeysPrefix)) + err = os.Symlink(string(fileBytes), newName) + if err != nil { + return err + } + } else { + // Nonroot keys are preserved without decrypting + keyName := strings.TrimPrefix(fNameTrimmed, nonRootKeysPrefix) + newNonRootKeys[keyName] = fileBytes + } + } else { + // This path inside the zip archive doesn't look like a + // root key, non-root key, or alias. To avoid adding a file + // to the filestore that we won't be able to use, skip + // this file in the import. + logrus.Warnf("skipping import of key with a path that doesn't begin with %s or %s: %s", rootKeysPrefix, nonRootKeysPrefix, f.Name) + rc.Close() + continue + } + + rc.Close() + } + + for keyName, pemBytes := range newRootKeys { + if err := km.rootKeyStore.Add(keyName, pemBytes); err != nil { + return err + } + } + + for keyName, pemBytes := range newNonRootKeys { + if err := km.nonRootKeyStore.Add(keyName, pemBytes); err != nil { + return err + } + } + + return nil +} + +func moveKeysByGUN(oldKeyStore, newKeyStore *trustmanager.KeyFileStore, gun string) error { + // List all files but no symlinks + for relKeyPath := range oldKeyStore.ListKeys() { + // Skip keys that aren't associated with this GUN + if !strings.HasPrefix(relKeyPath, filepath.FromSlash(gun)) { + continue + } + + privKey, alias, err := oldKeyStore.GetKey(relKeyPath) + if err != nil { + return err + } + + err = newKeyStore.AddKey(relKeyPath, alias, privKey) + if err != nil { + return err + } + } + + return nil +} + +// ExportKeysByGUN exports all keys associated with a specified GUN to an +// io.Writer in zip format. passphraseRetriever is used to select new passphrases to use to +// encrypt the keys. +func (km *KeyStoreManager) ExportKeysByGUN(dest io.Writer, gun string, passphraseRetriever passphrase.Retriever) error { + tempBaseDir, err := ioutil.TempDir("", "notary-key-export-") + defer os.RemoveAll(tempBaseDir) + + privNonRootKeysSubdir := filepath.Join(privDir, nonRootKeysSubdir) + + // Create temporary keystore to use as a staging area + tempNonRootKeysPath := filepath.Join(tempBaseDir, privNonRootKeysSubdir) + tempNonRootKeyStore, err := trustmanager.NewKeyFileStore(tempNonRootKeysPath, passphraseRetriever) + if err != nil { + return err + } + + if err := moveKeysByGUN(km.nonRootKeyStore, tempNonRootKeyStore, gun); err != nil { + return err + } + + zipWriter := zip.NewWriter(dest) + + if len(tempNonRootKeyStore.ListKeys()) == 0 { + return ErrNoKeysFoundForGUN + } + + if err := addKeysToArchive(zipWriter, tempNonRootKeyStore, privNonRootKeysSubdir); err != nil { + return err + } + + zipWriter.Close() + + return nil +} diff --git a/vendor/src/github.com/docker/notary/keystoremanager/keystoremanager.go b/vendor/src/github.com/docker/notary/keystoremanager/keystoremanager.go new file mode 100644 index 0000000000..bf39d7faa5 --- /dev/null +++ b/vendor/src/github.com/docker/notary/keystoremanager/keystoremanager.go @@ -0,0 +1,426 @@ +package keystoremanager + +import ( + "crypto/rand" + "crypto/x509" + "errors" + "fmt" + "path/filepath" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/notary/cryptoservice" + "github.com/docker/notary/pkg/passphrase" + "github.com/docker/notary/trustmanager" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/signed" +) + +// KeyStoreManager is an abstraction around the root and non-root key stores, +// and related CA stores +type KeyStoreManager struct { + rootKeyStore *trustmanager.KeyFileStore + nonRootKeyStore *trustmanager.KeyFileStore + + trustedCAStore trustmanager.X509Store + trustedCertificateStore trustmanager.X509Store +} + +const ( + trustDir = "trusted_certificates" + privDir = "private" + rootKeysSubdir = "root_keys" + nonRootKeysSubdir = "tuf_keys" + rsaRootKeySize = 4096 // Used for new root keys +) + +// ErrValidationFail is returned when there is no valid trusted certificates +// being served inside of the roots.json +type ErrValidationFail struct { + Reason string +} + +// ErrValidationFail is returned when there is no valid trusted certificates +// being served inside of the roots.json +func (err ErrValidationFail) Error() string { + return fmt.Sprintf("could not validate the path to a trusted root: %s", err.Reason) +} + +// ErrRootRotationFail is returned when we fail to do a full root key rotation +// by either failing to add the new root certificate, or delete the old ones +type ErrRootRotationFail struct { + Reason string +} + +// ErrRootRotationFail is returned when we fail to do a full root key rotation +// by either failing to add the new root certificate, or delete the old ones +func (err ErrRootRotationFail) Error() string { + return fmt.Sprintf("could not rotate trust to a new trusted root: %s", err.Reason) +} + +// NewKeyStoreManager returns an initialized KeyStoreManager, or an error +// if it fails to create the KeyFileStores or load certificates +func NewKeyStoreManager(baseDir string, passphraseRetriever passphrase.Retriever) (*KeyStoreManager, error) { + nonRootKeysPath := filepath.Join(baseDir, privDir, nonRootKeysSubdir) + nonRootKeyStore, err := trustmanager.NewKeyFileStore(nonRootKeysPath, passphraseRetriever) + if err != nil { + return nil, err + } + + // Load the keystore that will hold all of our encrypted Root Private Keys + rootKeysPath := filepath.Join(baseDir, privDir, rootKeysSubdir) + rootKeyStore, err := trustmanager.NewKeyFileStore(rootKeysPath, passphraseRetriever) + if err != nil { + return nil, err + } + + trustPath := filepath.Join(baseDir, trustDir) + + // Load all CAs that aren't expired and don't use SHA1 + trustedCAStore, err := trustmanager.NewX509FilteredFileStore(trustPath, func(cert *x509.Certificate) bool { + return cert.IsCA && cert.BasicConstraintsValid && cert.SubjectKeyId != nil && + time.Now().Before(cert.NotAfter) && + cert.SignatureAlgorithm != x509.SHA1WithRSA && + cert.SignatureAlgorithm != x509.DSAWithSHA1 && + cert.SignatureAlgorithm != x509.ECDSAWithSHA1 + }) + if err != nil { + return nil, err + } + + // Load all individual (non-CA) certificates that aren't expired and don't use SHA1 + trustedCertificateStore, err := trustmanager.NewX509FilteredFileStore(trustPath, func(cert *x509.Certificate) bool { + return !cert.IsCA && + time.Now().Before(cert.NotAfter) && + cert.SignatureAlgorithm != x509.SHA1WithRSA && + cert.SignatureAlgorithm != x509.DSAWithSHA1 && + cert.SignatureAlgorithm != x509.ECDSAWithSHA1 + }) + if err != nil { + return nil, err + } + + return &KeyStoreManager{ + rootKeyStore: rootKeyStore, + nonRootKeyStore: nonRootKeyStore, + trustedCAStore: trustedCAStore, + trustedCertificateStore: trustedCertificateStore, + }, nil +} + +// RootKeyStore returns the root key store being managed by this +// KeyStoreManager +func (km *KeyStoreManager) RootKeyStore() *trustmanager.KeyFileStore { + return km.rootKeyStore +} + +// NonRootKeyStore returns the non-root key store being managed by this +// KeyStoreManager +func (km *KeyStoreManager) NonRootKeyStore() *trustmanager.KeyFileStore { + return km.nonRootKeyStore +} + +// TrustedCertificateStore returns the trusted certificate store being managed +// by this KeyStoreManager +func (km *KeyStoreManager) TrustedCertificateStore() trustmanager.X509Store { + return km.trustedCertificateStore +} + +// TrustedCAStore returns the CA store being managed by this KeyStoreManager +func (km *KeyStoreManager) TrustedCAStore() trustmanager.X509Store { + return km.trustedCAStore +} + +// AddTrustedCert adds a cert to the trusted certificate store (not the CA +// store) +func (km *KeyStoreManager) AddTrustedCert(cert *x509.Certificate) { + km.trustedCertificateStore.AddCert(cert) +} + +// AddTrustedCACert adds a cert to the trusted CA certificate store +func (km *KeyStoreManager) AddTrustedCACert(cert *x509.Certificate) { + km.trustedCAStore.AddCert(cert) +} + +// GenRootKey generates a new root key +func (km *KeyStoreManager) GenRootKey(algorithm string) (string, error) { + var err error + var privKey data.PrivateKey + + // We don't want external API callers to rely on internal TUF data types, so + // the API here should continue to receive a string algorithm, and ensure + // that it is downcased + switch data.KeyAlgorithm(strings.ToLower(algorithm)) { + case data.RSAKey: + privKey, err = trustmanager.GenerateRSAKey(rand.Reader, rsaRootKeySize) + case data.ECDSAKey: + privKey, err = trustmanager.GenerateECDSAKey(rand.Reader) + default: + return "", fmt.Errorf("only RSA or ECDSA keys are currently supported. Found: %s", algorithm) + + } + if err != nil { + return "", fmt.Errorf("failed to generate private key: %v", err) + } + + // Changing the root + km.rootKeyStore.AddKey(privKey.ID(), "root", privKey) + + return privKey.ID(), nil +} + +// GetRootCryptoService retrieves a root key and a cryptoservice to use with it +// TODO(mccauley): remove this as its no longer needed once we have key caching in the keystores +func (km *KeyStoreManager) GetRootCryptoService(rootKeyID string) (*cryptoservice.UnlockedCryptoService, error) { + privKey, _, err := km.rootKeyStore.GetKey(rootKeyID) + if err != nil { + return nil, fmt.Errorf("could not get decrypted root key with keyID: %s, %v", rootKeyID, err) + } + + cryptoService := cryptoservice.NewCryptoService("", km.rootKeyStore) + + return cryptoservice.NewUnlockedCryptoService(privKey, cryptoService), nil +} + +/* +ValidateRoot receives a new root, validates its correctness and attempts to +do root key rotation if needed. + +First we list the current trusted certificates we have for a particular GUN. If +that list is non-empty means that we've already seen this repository before, and +have a list of trusted certificates for it. In this case, we use this list of +certificates to attempt to validate this root file. + +If the previous validation suceeds, or in the case where we found no trusted +certificates for this particular GUN, we check the integrity of the root by +making sure that it is validated by itself. This means that we will attempt to +validate the root data with the certificates that are included in the root keys +themselves. + +If this last steps succeeds, we attempt to do root rotation, by ensuring that +we only trust the certificates that are present in the new root. + +This mechanism of operation is essentially Trust On First Use (TOFU): if we +have never seen a certificate for a particular CN, we trust it. If later we see +a different certificate for that certificate, we return an ErrValidationFailed error. + +Note that since we only allow trust data to be downloaded over an HTTPS channel +we are using the current public PKI to validate the first download of the certificate +adding an extra layer of security over the normal (SSH style) trust model. +We shall call this: TOFUS. +*/ +func (km *KeyStoreManager) ValidateRoot(root *data.Signed, gun string) error { + logrus.Debugf("entered ValidateRoot with dns: %s", gun) + signedRoot, err := data.RootFromSigned(root) + if err != nil { + return err + } + + // Retrieve all the leaf certificates in root for which the CN matches the GUN + allValidCerts, err := validRootLeafCerts(signedRoot, gun) + if err != nil { + logrus.Debugf("error retrieving valid leaf certificates for: %s, %v", gun, err) + return &ErrValidationFail{Reason: "unable to retrieve valid leaf certificates"} + } + + // Retrieve all the trusted certificates that match this gun + certsForCN, err := km.trustedCertificateStore.GetCertificatesByCN(gun) + if err != nil { + // If the error that we get back is different than ErrNoCertificatesFound + // we couldn't check if there are any certificates with this CN already + // trusted. Let's take the conservative approach and return a failed validation + if _, ok := err.(*trustmanager.ErrNoCertificatesFound); !ok { + logrus.Debugf("error retrieving trusted certificates for: %s, %v", gun, err) + return &ErrValidationFail{Reason: "unable to retrieve trusted certificates"} + } + } + + // If we have certificates that match this specific GUN, let's make sure to + // use them first to validate that this new root is valid. + if len(certsForCN) != 0 { + logrus.Debugf("found %d valid root certificates for %s", len(certsForCN), gun) + err = signed.VerifyRoot(root, 0, trustmanager.CertsToKeys(certsForCN)) + if err != nil { + logrus.Debugf("failed to verify TUF data for: %s, %v", gun, err) + return &ErrValidationFail{Reason: "failed to validate data with current trusted certificates"} + } + } else { + logrus.Debugf("found no currently valid root certificates for %s", gun) + } + + // Validate the integrity of the new root (does it have valid signatures) + err = signed.VerifyRoot(root, 0, trustmanager.CertsToKeys(allValidCerts)) + if err != nil { + logrus.Debugf("failed to verify TUF data for: %s, %v", gun, err) + return &ErrValidationFail{Reason: "failed to validate integrity of roots"} + } + + // Getting here means A) we had trusted certificates and both the + // old and new validated this root; or B) we had no trusted certificates but + // the new set of certificates has integrity (self-signed) + logrus.Debugf("entering root certificate rotation for: %s", gun) + + // Do root certificate rotation: we trust only the certs present in the new root + // First we add all the new certificates (even if they already exist) + for _, cert := range allValidCerts { + err := km.trustedCertificateStore.AddCert(cert) + if err != nil { + // If the error is already exists we don't fail the rotation + if _, ok := err.(*trustmanager.ErrCertExists); ok { + logrus.Debugf("ignoring certificate addition to: %s", gun) + continue + } + logrus.Debugf("error adding new trusted certificate for: %s, %v", gun, err) + } + } + + // Now we delete old certificates that aren't present in the new root + for certID, cert := range certsToRemove(certsForCN, allValidCerts) { + logrus.Debugf("removing certificate with certID: %s", certID) + err = km.trustedCertificateStore.RemoveCert(cert) + if err != nil { + logrus.Debugf("failed to remove trusted certificate with keyID: %s, %v", certID, err) + return &ErrRootRotationFail{Reason: "failed to rotate root keys"} + } + } + + logrus.Debugf("Root validation succeeded for %s", gun) + return nil +} + +// validRootLeafCerts returns a list of non-exipired, non-sha1 certificates whoose +// Common-Names match the provided GUN +func validRootLeafCerts(root *data.SignedRoot, gun string) ([]*x509.Certificate, error) { + // Get a list of all of the leaf certificates present in root + allLeafCerts, _ := parseAllCerts(root) + var validLeafCerts []*x509.Certificate + + // Go through every leaf certificate and check that the CN matches the gun + for _, cert := range allLeafCerts { + // Validate that this leaf certificate has a CN that matches the exact gun + if cert.Subject.CommonName != gun { + logrus.Debugf("error leaf certificate CN: %s doesn't match the given GUN: %s", cert.Subject.CommonName) + continue + } + // Make sure the certificate is not expired + if time.Now().After(cert.NotAfter) { + logrus.Debugf("error leaf certificate is expired") + continue + } + + // We don't allow root certificates that use SHA1 + if cert.SignatureAlgorithm == x509.SHA1WithRSA || + cert.SignatureAlgorithm == x509.DSAWithSHA1 || + cert.SignatureAlgorithm == x509.ECDSAWithSHA1 { + + logrus.Debugf("error certificate uses deprecated hashing algorithm (SHA1)") + continue + } + + validLeafCerts = append(validLeafCerts, cert) + } + + if len(validLeafCerts) < 1 { + logrus.Debugf("didn't find any valid leaf certificates for %s", gun) + return nil, errors.New("no valid leaf certificates found in any of the root keys") + } + + logrus.Debugf("found %d valid leaf certificates for %s", len(validLeafCerts), gun) + return validLeafCerts, nil +} + +// parseAllCerts returns two maps, one with all of the leafCertificates and one +// with all the intermediate certificates found in signedRoot +func parseAllCerts(signedRoot *data.SignedRoot) (map[string]*x509.Certificate, map[string][]*x509.Certificate) { + leafCerts := make(map[string]*x509.Certificate) + intCerts := make(map[string][]*x509.Certificate) + + // Before we loop through all root keys available, make sure any exist + rootRoles, ok := signedRoot.Signed.Roles["root"] + if !ok { + logrus.Debugf("tried to parse certificates from invalid root signed data") + return nil, nil + } + + logrus.Debugf("found the following root keys: %v", rootRoles.KeyIDs) + // Iterate over every keyID for the root role inside of roots.json + for _, keyID := range rootRoles.KeyIDs { + // check that the key exists in the signed root keys map + key, ok := signedRoot.Signed.Keys[keyID] + if !ok { + logrus.Debugf("error while getting data for keyID: %s", keyID) + continue + } + + // Decode all the x509 certificates that were bundled with this + // Specific root key + decodedCerts, err := trustmanager.LoadCertBundleFromPEM(key.Public()) + if err != nil { + logrus.Debugf("error while parsing root certificate with keyID: %s, %v", keyID, err) + continue + } + + // Get all non-CA certificates in the decoded certificates + leafCertList := trustmanager.GetLeafCerts(decodedCerts) + + // If we got no leaf certificates or we got more than one, fail + if len(leafCertList) != 1 { + logrus.Debugf("invalid chain due to leaf certificate missing or too many leaf certificates for keyID: %s", keyID) + continue + } + + // Get the ID of the leaf certificate + leafCert := leafCertList[0] + leafID, err := trustmanager.FingerprintCert(leafCert) + if err != nil { + logrus.Debugf("error while fingerprinting root certificate with keyID: %s, %v", keyID, err) + continue + } + + // Store the leaf cert in the map + leafCerts[leafID] = leafCert + + // Get all the remainder certificates marked as a CA to be used as intermediates + intermediateCerts := trustmanager.GetIntermediateCerts(decodedCerts) + intCerts[leafID] = intermediateCerts + } + + return leafCerts, intCerts +} + +// certsToRemove returns all the certifificates from oldCerts that aren't present +// in newCerts +func certsToRemove(oldCerts, newCerts []*x509.Certificate) map[string]*x509.Certificate { + certsToRemove := make(map[string]*x509.Certificate) + + // If no newCerts were provided + if len(newCerts) == 0 { + return certsToRemove + } + + // Populate a map with all the IDs from newCert + var newCertMap = make(map[string]struct{}) + for _, cert := range newCerts { + certID, err := trustmanager.FingerprintCert(cert) + if err != nil { + logrus.Debugf("error while fingerprinting root certificate with keyID: %s, %v", certID, err) + continue + } + newCertMap[certID] = struct{}{} + } + + // Iterate over all the old certificates and check to see if we should remove them + for _, cert := range oldCerts { + certID, err := trustmanager.FingerprintCert(cert) + if err != nil { + logrus.Debugf("error while fingerprinting root certificate with certID: %s, %v", certID, err) + continue + } + if _, ok := newCertMap[certID]; !ok { + certsToRemove[certID] = cert + } + } + + return certsToRemove +} diff --git a/vendor/src/github.com/docker/notary/notarymysql/LICENSE b/vendor/src/github.com/docker/notary/notarymysql/LICENSE new file mode 100644 index 0000000000..c8476ac066 --- /dev/null +++ b/vendor/src/github.com/docker/notary/notarymysql/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2014 Sameer Naik + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/vendor/src/github.com/docker/notary/pkg/passphrase/passphrase.go b/vendor/src/github.com/docker/notary/pkg/passphrase/passphrase.go new file mode 100644 index 0000000000..9359e0efc0 --- /dev/null +++ b/vendor/src/github.com/docker/notary/pkg/passphrase/passphrase.go @@ -0,0 +1,181 @@ +// Package passphrase is a utility function for managing passphrase +// for TUF and Notary keys. +package passphrase + +import ( + "bufio" + "errors" + "fmt" + "io" + "os" + "strings" + + "path/filepath" + + "github.com/docker/docker/pkg/term" +) + +// Retriever is a callback function that should retrieve a passphrase +// for a given named key. If it should be treated as new passphrase (e.g. with +// confirmation), createNew will be true. Attempts is passed in so that implementers +// decide how many chances to give to a human, for example. +type Retriever func(keyName, alias string, createNew bool, attempts int) (passphrase string, giveup bool, err error) + +const ( + idBytesToDisplay = 7 + tufRootAlias = "root" + tufTargetsAlias = "targets" + tufSnapshotAlias = "snapshot" + tufRootKeyGenerationWarning = `You are about to create a new root signing key passphrase. This passphrase +will be used to protect the most sensitive key in your signing system. Please +choose a long, complex passphrase and be careful to keep the password and the +key file itself secure and backed up. It is highly recommended that you use a +password manager to generate the passphrase and keep it safe. There will be no +way to recover this key. You can find the key in your config directory.` +) + +var ( + // ErrTooShort is returned if the passphrase entered for a new key is + // below the minimum length + ErrTooShort = errors.New("Passphrase too short") + + // ErrDontMatch is returned if the two entered passphrases don't match. + // new key is below the minimum length + ErrDontMatch = errors.New("The entered passphrases do not match") + + // ErrTooManyAttempts is returned if the maximum number of passphrase + // entry attempts is reached. + ErrTooManyAttempts = errors.New("Too many attempts") +) + +// PromptRetriever returns a new Retriever which will provide a prompt on stdin +// and stdout to retrieve a passphrase. The passphrase will be cached such that +// subsequent prompts will produce the same passphrase. +func PromptRetriever() Retriever { + return PromptRetrieverWithInOut(os.Stdin, os.Stdout, nil) +} + +// PromptRetrieverWithInOut returns a new Retriever which will provide a +// prompt using the given in and out readers. The passphrase will be cached +// such that subsequent prompts will produce the same passphrase. +// aliasMap can be used to specify display names for TUF key aliases. If aliasMap +// is nil, a sensible default will be used. +func PromptRetrieverWithInOut(in io.Reader, out io.Writer, aliasMap map[string]string) Retriever { + userEnteredTargetsSnapshotsPass := false + targetsSnapshotsPass := "" + userEnteredRootsPass := false + rootsPass := "" + + return func(keyName string, alias string, createNew bool, numAttempts int) (string, bool, error) { + if alias == tufRootAlias && createNew && numAttempts == 0 { + fmt.Fprintln(out, tufRootKeyGenerationWarning) + } + if numAttempts > 0 { + if !createNew { + fmt.Fprintln(out, "Passphrase incorrect. Please retry.") + } + } + + // Figure out if we should display a different string for this alias + displayAlias := alias + if aliasMap != nil { + if val, ok := aliasMap[alias]; ok { + displayAlias = val + } + + } + + // First, check if we have a password cached for this alias. + if numAttempts == 0 { + if userEnteredTargetsSnapshotsPass && (alias == tufSnapshotAlias || alias == tufTargetsAlias) { + return targetsSnapshotsPass, false, nil + } + if userEnteredRootsPass && (alias == "root") { + return rootsPass, false, nil + } + } + + if numAttempts > 3 && !createNew { + return "", true, ErrTooManyAttempts + } + + state, err := term.SaveState(0) + if err != nil { + return "", false, err + } + term.DisableEcho(0, state) + defer term.RestoreTerminal(0, state) + + stdin := bufio.NewReader(in) + + indexOfLastSeparator := strings.LastIndex(keyName, string(filepath.Separator)) + if indexOfLastSeparator == -1 { + indexOfLastSeparator = 0 + } + + if len(keyName) > indexOfLastSeparator+idBytesToDisplay { + if indexOfLastSeparator > 0 { + keyNamePrefix := keyName[:indexOfLastSeparator] + keyNameID := keyName[indexOfLastSeparator+1 : indexOfLastSeparator+idBytesToDisplay+1] + keyName = keyNamePrefix + " (" + keyNameID + ")" + } else { + keyName = keyName[indexOfLastSeparator : indexOfLastSeparator+idBytesToDisplay] + } + } + + if createNew { + fmt.Fprintf(out, "Enter passphrase for new %s key with id %s: ", displayAlias, keyName) + } else { + fmt.Fprintf(out, "Enter key passphrase for %s key with id %s: ", displayAlias, keyName) + } + + passphrase, err := stdin.ReadBytes('\n') + fmt.Fprintln(out) + if err != nil { + return "", false, err + } + + retPass := strings.TrimSpace(string(passphrase)) + + if !createNew { + if alias == tufSnapshotAlias || alias == tufTargetsAlias { + userEnteredTargetsSnapshotsPass = true + targetsSnapshotsPass = retPass + } + if alias == tufRootAlias { + userEnteredRootsPass = true + rootsPass = retPass + } + return retPass, false, nil + } + + if len(retPass) < 8 { + fmt.Fprintln(out, "Passphrase is too short. Please use a password manager to generate and store a good random passphrase.") + return "", false, ErrTooShort + } + + fmt.Fprintf(out, "Repeat passphrase for new %s key with id %s: ", displayAlias, keyName) + confirmation, err := stdin.ReadBytes('\n') + fmt.Fprintln(out) + if err != nil { + return "", false, err + } + confirmationStr := strings.TrimSpace(string(confirmation)) + + if retPass != confirmationStr { + fmt.Fprintln(out, "Passphrases do not match. Please retry.") + return "", false, ErrDontMatch + } + + if alias == tufSnapshotAlias || alias == tufTargetsAlias { + userEnteredTargetsSnapshotsPass = true + targetsSnapshotsPass = retPass + } + if alias == tufRootAlias { + userEnteredRootsPass = true + rootsPass = retPass + } + + return retPass, false, nil + } +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/filestore.go b/vendor/src/github.com/docker/notary/trustmanager/filestore.go new file mode 100644 index 0000000000..5aa3e7aef8 --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/filestore.go @@ -0,0 +1,293 @@ +package trustmanager + +import ( + "errors" + "fmt" + "io/ioutil" + "os" + "path/filepath" + "strings" + "sync" +) + +const ( + visible os.FileMode = 0755 + private os.FileMode = 0700 +) + +var ( + // ErrPathOutsideStore indicates that the returned path would be + // outside the store + ErrPathOutsideStore = errors.New("path outside file store") +) + +// LimitedFileStore implements the bare bones primitives (no symlinks or +// hierarchy) +type LimitedFileStore interface { + Add(fileName string, data []byte) error + Remove(fileName string) error + Get(fileName string) ([]byte, error) + ListFiles(symlinks bool) []string +} + +// FileStore is the interface for full-featured FileStores +type FileStore interface { + LimitedFileStore + + RemoveDir(directoryName string) error + GetPath(fileName string) (string, error) + ListDir(directoryName string, symlinks bool) []string + Link(src, dst string) error + BaseDir() string +} + +// SimpleFileStore implements FileStore +type SimpleFileStore struct { + baseDir string + fileExt string + perms os.FileMode +} + +// NewSimpleFileStore creates a directory with 755 permissions +func NewSimpleFileStore(baseDir string, fileExt string) (*SimpleFileStore, error) { + baseDir = filepath.Clean(baseDir) + + if err := CreateDirectory(baseDir); err != nil { + return nil, err + } + + return &SimpleFileStore{ + baseDir: baseDir, + fileExt: fileExt, + perms: visible, + }, nil +} + +// NewPrivateSimpleFileStore creates a directory with 700 permissions +func NewPrivateSimpleFileStore(baseDir string, fileExt string) (*SimpleFileStore, error) { + if err := CreatePrivateDirectory(baseDir); err != nil { + return nil, err + } + + return &SimpleFileStore{ + baseDir: baseDir, + fileExt: fileExt, + perms: private, + }, nil +} + +// Add writes data to a file with a given name +func (f *SimpleFileStore) Add(name string, data []byte) error { + filePath, err := f.GetPath(name) + if err != nil { + return err + } + createDirectory(filepath.Dir(filePath), f.perms) + return ioutil.WriteFile(filePath, data, f.perms) +} + +// Remove removes a file identified by name +func (f *SimpleFileStore) Remove(name string) error { + // Attempt to remove + filePath, err := f.GetPath(name) + if err != nil { + return err + } + return os.Remove(filePath) +} + +// RemoveDir removes the directory identified by name +func (f *SimpleFileStore) RemoveDir(name string) error { + dirPath := filepath.Join(f.baseDir, name) + + // Check to see if directory exists + fi, err := os.Stat(dirPath) + if err != nil { + return err + } + + // Check to see if it is a directory + if !fi.IsDir() { + return fmt.Errorf("directory not found: %s", name) + } + + return os.RemoveAll(dirPath) +} + +// Get returns the data given a file name +func (f *SimpleFileStore) Get(name string) ([]byte, error) { + filePath, err := f.GetPath(name) + if err != nil { + return nil, err + } + data, err := ioutil.ReadFile(filePath) + if err != nil { + return nil, err + } + + return data, nil +} + +// GetPath returns the full final path of a file with a given name +func (f *SimpleFileStore) GetPath(name string) (string, error) { + fileName := f.genFileName(name) + fullPath := filepath.Clean(filepath.Join(f.baseDir, fileName)) + + if !strings.HasPrefix(fullPath, f.baseDir) { + return "", ErrPathOutsideStore + } + return fullPath, nil +} + +// ListFiles lists all the files inside of a store +func (f *SimpleFileStore) ListFiles(symlinks bool) []string { + return f.list(f.baseDir, symlinks) +} + +// ListDir lists all the files inside of a directory identified by a name +func (f *SimpleFileStore) ListDir(name string, symlinks bool) []string { + fullPath := filepath.Join(f.baseDir, name) + return f.list(fullPath, symlinks) +} + +// list lists all the files in a directory given a full path. Ignores symlinks. +func (f *SimpleFileStore) list(path string, symlinks bool) []string { + files := make([]string, 0, 0) + filepath.Walk(path, func(fp string, fi os.FileInfo, err error) error { + // If there are errors, ignore this particular file + if err != nil { + return nil + } + // Ignore if it is a directory + if fi.IsDir() { + return nil + } + + // If this is a symlink, and symlinks is true, ignore it + if !symlinks && fi.Mode()&os.ModeSymlink == os.ModeSymlink { + return nil + } + + // Only allow matches that end with our certificate extension (e.g. *.crt) + matched, _ := filepath.Match("*"+f.fileExt, fi.Name()) + + if matched { + // Find the relative path for this file relative to the base path. + fp, err = filepath.Rel(path, fp) + if err != nil { + return err + } + files = append(files, fp) + } + return nil + }) + return files +} + +// genFileName returns the name using the right extension +func (f *SimpleFileStore) genFileName(name string) string { + return fmt.Sprintf("%s.%s", name, f.fileExt) +} + +// Link creates a symlink between the ID of the certificate used by a repository +// and the ID of the root key that is being used. +// We use full path for the source and local for the destination to use relative +// path for the symlink +func (f *SimpleFileStore) Link(oldname, newname string) error { + newnamePath, err := f.GetPath(newname) + if err != nil { + return err + } + + return os.Symlink(f.genFileName(oldname), newnamePath) +} + +// BaseDir returns the base directory of the filestore +func (f *SimpleFileStore) BaseDir() string { + return f.baseDir +} + +// CreateDirectory uses createDirectory to create a chmod 755 Directory +func CreateDirectory(dir string) error { + return createDirectory(dir, visible) +} + +// CreatePrivateDirectory uses createDirectory to create a chmod 700 Directory +func CreatePrivateDirectory(dir string) error { + return createDirectory(dir, private) +} + +// createDirectory receives a string of the path to a directory. +// It does not support passing files, so the caller has to remove +// the filename by doing filepath.Dir(full_path_to_file) +func createDirectory(dir string, perms os.FileMode) error { + // This prevents someone passing /path/to/dir and 'dir' not being created + // If two '//' exist, MkdirAll deals it with correctly + dir = dir + "/" + return os.MkdirAll(dir, perms) +} + +// MemoryFileStore is an implementation of LimitedFileStore that keeps +// the contents in memory. +type MemoryFileStore struct { + sync.Mutex + + files map[string][]byte +} + +// NewMemoryFileStore creates a MemoryFileStore +func NewMemoryFileStore() *MemoryFileStore { + return &MemoryFileStore{ + files: make(map[string][]byte), + } +} + +// ErrMemFileNotFound is returned for a nonexistent "file" in the memory file +// store +var ErrMemFileNotFound = errors.New("key not found in memory file store") + +// Add writes data to a file with a given name +func (f *MemoryFileStore) Add(name string, data []byte) error { + f.Lock() + defer f.Unlock() + + f.files[name] = data + return nil +} + +// Remove removes a file identified by name +func (f *MemoryFileStore) Remove(name string) error { + f.Lock() + defer f.Unlock() + + if _, present := f.files[name]; !present { + return ErrMemFileNotFound + } + delete(f.files, name) + + return nil +} + +// Get returns the data given a file name +func (f *MemoryFileStore) Get(name string) ([]byte, error) { + f.Lock() + defer f.Unlock() + + fileData, present := f.files[name] + if !present { + return nil, ErrMemFileNotFound + } + + return fileData, nil +} + +// ListFiles lists all the files inside of a store +func (f *MemoryFileStore) ListFiles(symlinks bool) []string { + var list []string + + for name := range f.files { + list = append(list, name) + } + + return list +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/keyfilestore.go b/vendor/src/github.com/docker/notary/trustmanager/keyfilestore.go new file mode 100644 index 0000000000..fc68463dbd --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/keyfilestore.go @@ -0,0 +1,235 @@ +package trustmanager + +import ( + "path/filepath" + "strings" + "sync" + + "github.com/docker/notary/pkg/passphrase" + "github.com/endophage/gotuf/data" +) + +// KeyFileStore persists and manages private keys on disk +type KeyFileStore struct { + sync.Mutex + SimpleFileStore + passphrase.Retriever + cachedKeys map[string]*cachedKey +} + +// KeyMemoryStore manages private keys in memory +type KeyMemoryStore struct { + sync.Mutex + MemoryFileStore + passphrase.Retriever + cachedKeys map[string]*cachedKey +} + +// NewKeyFileStore returns a new KeyFileStore creating a private directory to +// hold the keys. +func NewKeyFileStore(baseDir string, passphraseRetriever passphrase.Retriever) (*KeyFileStore, error) { + fileStore, err := NewPrivateSimpleFileStore(baseDir, keyExtension) + if err != nil { + return nil, err + } + cachedKeys := make(map[string]*cachedKey) + + return &KeyFileStore{SimpleFileStore: *fileStore, + Retriever: passphraseRetriever, + cachedKeys: cachedKeys}, nil +} + +// AddKey stores the contents of a PEM-encoded private key as a PEM block +func (s *KeyFileStore) AddKey(name, alias string, privKey data.PrivateKey) error { + s.Lock() + defer s.Unlock() + return addKey(s, s.Retriever, s.cachedKeys, name, alias, privKey) +} + +// GetKey returns the PrivateKey given a KeyID +func (s *KeyFileStore) GetKey(name string) (data.PrivateKey, string, error) { + s.Lock() + defer s.Unlock() + return getKey(s, s.Retriever, s.cachedKeys, name) +} + +// ListKeys returns a list of unique PublicKeys present on the KeyFileStore. +// There might be symlinks associating Certificate IDs to Public Keys, so this +// method only returns the IDs that aren't symlinks +func (s *KeyFileStore) ListKeys() map[string]string { + return listKeys(s) +} + +// RemoveKey removes the key from the keyfilestore +func (s *KeyFileStore) RemoveKey(name string) error { + s.Lock() + defer s.Unlock() + return removeKey(s, s.cachedKeys, name) +} + +// NewKeyMemoryStore returns a new KeyMemoryStore which holds keys in memory +func NewKeyMemoryStore(passphraseRetriever passphrase.Retriever) *KeyMemoryStore { + memStore := NewMemoryFileStore() + cachedKeys := make(map[string]*cachedKey) + + return &KeyMemoryStore{MemoryFileStore: *memStore, + Retriever: passphraseRetriever, + cachedKeys: cachedKeys} +} + +// AddKey stores the contents of a PEM-encoded private key as a PEM block +func (s *KeyMemoryStore) AddKey(name, alias string, privKey data.PrivateKey) error { + s.Lock() + defer s.Unlock() + return addKey(s, s.Retriever, s.cachedKeys, name, alias, privKey) +} + +// GetKey returns the PrivateKey given a KeyID +func (s *KeyMemoryStore) GetKey(name string) (data.PrivateKey, string, error) { + s.Lock() + defer s.Unlock() + return getKey(s, s.Retriever, s.cachedKeys, name) +} + +// ListKeys returns a list of unique PublicKeys present on the KeyFileStore. +// There might be symlinks associating Certificate IDs to Public Keys, so this +// method only returns the IDs that aren't symlinks +func (s *KeyMemoryStore) ListKeys() map[string]string { + return listKeys(s) +} + +// RemoveKey removes the key from the keystore +func (s *KeyMemoryStore) RemoveKey(name string) error { + s.Lock() + defer s.Unlock() + return removeKey(s, s.cachedKeys, name) +} + +func addKey(s LimitedFileStore, passphraseRetriever passphrase.Retriever, cachedKeys map[string]*cachedKey, name, alias string, privKey data.PrivateKey) error { + pemPrivKey, err := KeyToPEM(privKey) + if err != nil { + return err + } + + attempts := 0 + chosenPassphrase := "" + giveup := false + for { + chosenPassphrase, giveup, err = passphraseRetriever(name, alias, true, attempts) + if err != nil { + attempts++ + continue + } + if giveup { + return ErrAttemptsExceeded{} + } + if attempts > 10 { + return ErrAttemptsExceeded{} + } + break + } + + if chosenPassphrase != "" { + pemPrivKey, err = EncryptPrivateKey(privKey, chosenPassphrase) + if err != nil { + return err + } + } + + cachedKeys[name] = &cachedKey{alias: alias, key: privKey} + return s.Add(name+"_"+alias, pemPrivKey) +} + +func getKeyAlias(s LimitedFileStore, keyID string) (string, error) { + files := s.ListFiles(true) + name := strings.TrimSpace(strings.TrimSuffix(filepath.Base(keyID), filepath.Ext(keyID))) + + for _, file := range files { + filename := filepath.Base(file) + + if strings.HasPrefix(filename, name) { + aliasPlusDotKey := strings.TrimPrefix(filename, name+"_") + retVal := strings.TrimSuffix(aliasPlusDotKey, "."+keyExtension) + return retVal, nil + } + } + + return "", &ErrKeyNotFound{KeyID: keyID} +} + +// GetKey returns the PrivateKey given a KeyID +func getKey(s LimitedFileStore, passphraseRetriever passphrase.Retriever, cachedKeys map[string]*cachedKey, name string) (data.PrivateKey, string, error) { + cachedKeyEntry, ok := cachedKeys[name] + if ok { + return cachedKeyEntry.key, cachedKeyEntry.alias, nil + } + keyAlias, err := getKeyAlias(s, name) + if err != nil { + return nil, "", err + } + + keyBytes, err := s.Get(name + "_" + keyAlias) + if err != nil { + return nil, "", err + } + + var retErr error + // See if the key is encrypted. If its encrypted we'll fail to parse the private key + privKey, err := ParsePEMPrivateKey(keyBytes, "") + if err != nil { + // We need to decrypt the key, lets get a passphrase + for attempts := 0; ; attempts++ { + passphrase, giveup, err := passphraseRetriever(name, string(keyAlias), false, attempts) + // Check if the passphrase retriever got an error or if it is telling us to give up + if giveup || err != nil { + return nil, "", ErrPasswordInvalid{} + } + if attempts > 10 { + return nil, "", ErrAttemptsExceeded{} + } + + // Try to convert PEM encoded bytes back to a PrivateKey using the passphrase + privKey, err = ParsePEMPrivateKey(keyBytes, passphrase) + if err != nil { + retErr = ErrPasswordInvalid{} + } else { + // We managed to parse the PrivateKey. We've succeeded! + retErr = nil + break + } + } + } + if retErr != nil { + return nil, "", retErr + } + cachedKeys[name] = &cachedKey{alias: keyAlias, key: privKey} + return privKey, keyAlias, nil +} + +// ListKeys returns a map of unique PublicKeys present on the KeyFileStore and +// their corresponding aliases. +// There might be symlinks associating Certificate IDs to Public Keys, so this +// method only returns the IDs that aren't symlinks +func listKeys(s LimitedFileStore) map[string]string { + keyIDMap := make(map[string]string) + + for _, f := range s.ListFiles(false) { + keyIDFull := strings.TrimSpace(strings.TrimSuffix(f, filepath.Ext(f))) + keyID := keyIDFull[:strings.LastIndex(keyIDFull, "_")] + keyAlias := keyIDFull[strings.LastIndex(keyIDFull, "_")+1:] + keyIDMap[keyID] = keyAlias + } + return keyIDMap +} + +// RemoveKey removes the key from the keyfilestore +func removeKey(s LimitedFileStore, cachedKeys map[string]*cachedKey, name string) error { + keyAlias, err := getKeyAlias(s, name) + if err != nil { + return err + } + + delete(cachedKeys, name) + + return s.Remove(name + "_" + keyAlias) +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/keystore.go b/vendor/src/github.com/docker/notary/trustmanager/keystore.go new file mode 100644 index 0000000000..ba5fb1a1a4 --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/keystore.go @@ -0,0 +1,52 @@ +package trustmanager + +import ( + "fmt" + + "github.com/endophage/gotuf/data" +) + +// ErrAttemptsExceeded is returned when too many attempts have been made to decrypt a key +type ErrAttemptsExceeded struct{} + +// ErrAttemptsExceeded is returned when too many attempts have been made to decrypt a key +func (err ErrAttemptsExceeded) Error() string { + return "maximum number of passphrase attempts exceeded" +} + +// ErrPasswordInvalid is returned when signing fails. It could also mean the signing +// key file was corrupted, but we have no way to distinguish. +type ErrPasswordInvalid struct{} + +// ErrPasswordInvalid is returned when signing fails. It could also mean the signing +// key file was corrupted, but we have no way to distinguish. +func (err ErrPasswordInvalid) Error() string { + return "password invalid, operation has failed." +} + +// ErrKeyNotFound is returned when the keystore fails to retrieve a specific key. +type ErrKeyNotFound struct { + KeyID string +} + +// ErrKeyNotFound is returned when the keystore fails to retrieve a specific key. +func (err ErrKeyNotFound) Error() string { + return fmt.Sprintf("signing key not found: %s", err.KeyID) +} + +const ( + keyExtension = "key" +) + +// KeyStore is a generic interface for private key storage +type KeyStore interface { + AddKey(name, alias string, privKey data.PrivateKey) error + GetKey(name string) (data.PrivateKey, string, error) + ListKeys() map[string]string + RemoveKey(name string) error +} + +type cachedKey struct { + alias string + key data.PrivateKey +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/x509filestore.go b/vendor/src/github.com/docker/notary/trustmanager/x509filestore.go new file mode 100644 index 0000000000..1df6233191 --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/x509filestore.go @@ -0,0 +1,270 @@ +package trustmanager + +import ( + "crypto/x509" + "errors" + "os" + "path" + + "github.com/Sirupsen/logrus" +) + +// X509FileStore implements X509Store that persists on disk +type X509FileStore struct { + validate Validator + fileMap map[CertID]string + fingerprintMap map[CertID]*x509.Certificate + nameMap map[string][]CertID + fileStore FileStore +} + +// NewX509FileStore returns a new X509FileStore. +func NewX509FileStore(directory string) (*X509FileStore, error) { + validate := ValidatorFunc(func(cert *x509.Certificate) bool { return true }) + return newX509FileStore(directory, validate) +} + +// NewX509FilteredFileStore returns a new X509FileStore that validates certificates +// that are added. +func NewX509FilteredFileStore(directory string, validate func(*x509.Certificate) bool) (*X509FileStore, error) { + return newX509FileStore(directory, validate) +} + +func newX509FileStore(directory string, validate func(*x509.Certificate) bool) (*X509FileStore, error) { + fileStore, err := NewSimpleFileStore(directory, certExtension) + if err != nil { + return nil, err + } + + s := &X509FileStore{ + validate: ValidatorFunc(validate), + fileMap: make(map[CertID]string), + fingerprintMap: make(map[CertID]*x509.Certificate), + nameMap: make(map[string][]CertID), + fileStore: fileStore, + } + + err = loadCertsFromDir(s) + if err != nil { + return nil, err + } + + return s, nil +} + +// AddCert creates a filename for a given cert and adds a certificate with that name +func (s *X509FileStore) AddCert(cert *x509.Certificate) error { + if cert == nil { + return errors.New("adding nil Certificate to X509Store") + } + + // Check if this certificate meets our validation criteria + if !s.validate.Validate(cert) { + return &ErrCertValidation{} + } + // Attempt to write the certificate to the file + if err := s.addNamedCert(cert); err != nil { + return err + } + + return nil +} + +// addNamedCert allows adding a certificate while controlling the filename it gets +// stored under. If the file does not exist on disk, saves it. +func (s *X509FileStore) addNamedCert(cert *x509.Certificate) error { + fileName, certID, err := fileName(cert) + if err != nil { + return err + } + + logrus.Debug("Adding cert with certID: ", certID) + // Validate if we already added this certificate before + if _, ok := s.fingerprintMap[certID]; ok { + return &ErrCertExists{} + } + + // Convert certificate to PEM + certBytes := CertToPEM(cert) + + // Save the file to disk if not already there. + filePath, err := s.fileStore.GetPath(fileName) + if err != nil { + return err + } + if _, err := os.Stat(filePath); os.IsNotExist(err) { + if err := s.fileStore.Add(fileName, certBytes); err != nil { + return err + } + } else if err != nil { + return err + } + + // We wrote the certificate succcessfully, add it to our in-memory storage + s.fingerprintMap[certID] = cert + s.fileMap[certID] = fileName + + name := string(cert.Subject.CommonName) + s.nameMap[name] = append(s.nameMap[name], certID) + + return nil +} + +// RemoveCert removes a certificate from a X509FileStore. +func (s *X509FileStore) RemoveCert(cert *x509.Certificate) error { + if cert == nil { + return errors.New("removing nil Certificate from X509Store") + } + + certID, err := fingerprintCert(cert) + if err != nil { + return err + } + delete(s.fingerprintMap, certID) + filename := s.fileMap[certID] + delete(s.fileMap, certID) + + name := string(cert.Subject.CommonName) + + // Filter the fingerprint out of this name entry + fpList := s.nameMap[name] + newfpList := fpList[:0] + for _, x := range fpList { + if x != certID { + newfpList = append(newfpList, x) + } + } + + s.nameMap[name] = newfpList + + if err := s.fileStore.Remove(filename); err != nil { + return err + } + + return nil +} + +// RemoveAll removes all the certificates from the store +func (s *X509FileStore) RemoveAll() error { + for _, filename := range s.fileMap { + if err := s.fileStore.Remove(filename); err != nil { + return err + } + } + s.fileMap = make(map[CertID]string) + s.fingerprintMap = make(map[CertID]*x509.Certificate) + s.nameMap = make(map[string][]CertID) + + return nil +} + +// AddCertFromPEM adds the first certificate that it finds in the byte[], returning +// an error if no Certificates are found +func (s X509FileStore) AddCertFromPEM(pemBytes []byte) error { + cert, err := LoadCertFromPEM(pemBytes) + if err != nil { + return err + } + return s.AddCert(cert) +} + +// AddCertFromFile tries to adds a X509 certificate to the store given a filename +func (s *X509FileStore) AddCertFromFile(filename string) error { + cert, err := LoadCertFromFile(filename) + if err != nil { + return err + } + + return s.AddCert(cert) +} + +// GetCertificates returns an array with all of the current X509 Certificates. +func (s *X509FileStore) GetCertificates() []*x509.Certificate { + certs := make([]*x509.Certificate, len(s.fingerprintMap)) + i := 0 + for _, v := range s.fingerprintMap { + certs[i] = v + i++ + } + return certs +} + +// GetCertificatePool returns an x509 CertPool loaded with all the certificates +// in the store. +func (s *X509FileStore) GetCertificatePool() *x509.CertPool { + pool := x509.NewCertPool() + + for _, v := range s.fingerprintMap { + pool.AddCert(v) + } + return pool +} + +// GetCertificateByCertID returns the certificate that matches a certain certID +func (s *X509FileStore) GetCertificateByCertID(certID string) (*x509.Certificate, error) { + return s.getCertificateByCertID(CertID(certID)) +} + +// getCertificateByCertID returns the certificate that matches a certain certID +func (s *X509FileStore) getCertificateByCertID(certID CertID) (*x509.Certificate, error) { + // If it does not look like a hex encoded sha256 hash, error + if len(certID) != 64 { + return nil, errors.New("invalid Subject Key Identifier") + } + + // Check to see if this subject key identifier exists + if cert, ok := s.fingerprintMap[CertID(certID)]; ok { + return cert, nil + + } + return nil, &ErrNoCertificatesFound{query: string(certID)} +} + +// GetCertificatesByCN returns all the certificates that match a specific +// CommonName +func (s *X509FileStore) GetCertificatesByCN(cn string) ([]*x509.Certificate, error) { + var certs []*x509.Certificate + if ids, ok := s.nameMap[cn]; ok { + for _, v := range ids { + cert, err := s.getCertificateByCertID(v) + if err != nil { + // This error should never happen. This would mean that we have + // an inconsistent X509FileStore + return nil, &ErrBadCertificateStore{} + } + certs = append(certs, cert) + } + } + if len(certs) == 0 { + return nil, &ErrNoCertificatesFound{query: cn} + } + + return certs, nil +} + +// GetVerifyOptions returns VerifyOptions with the certificates within the KeyStore +// as part of the roots list. This never allows the use of system roots, returning +// an error if there are no root CAs. +func (s *X509FileStore) GetVerifyOptions(dnsName string) (x509.VerifyOptions, error) { + // If we have no Certificates loaded return error (we don't want to rever to using + // system CAs). + if len(s.fingerprintMap) == 0 { + return x509.VerifyOptions{}, errors.New("no root CAs available") + } + + opts := x509.VerifyOptions{ + DNSName: dnsName, + Roots: s.GetCertificatePool(), + } + + return opts, nil +} + +func fileName(cert *x509.Certificate) (string, CertID, error) { + certID, err := fingerprintCert(cert) + if err != nil { + return "", "", err + } + + return path.Join(cert.Subject.CommonName, string(certID)), certID, nil +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/x509memstore.go b/vendor/src/github.com/docker/notary/trustmanager/x509memstore.go new file mode 100644 index 0000000000..55666c0976 --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/x509memstore.go @@ -0,0 +1,203 @@ +package trustmanager + +import ( + "crypto/x509" + "errors" + + "github.com/Sirupsen/logrus" +) + +// X509MemStore implements X509Store as an in-memory object with no persistence +type X509MemStore struct { + validate Validator + fingerprintMap map[CertID]*x509.Certificate + nameMap map[string][]CertID +} + +// NewX509MemStore returns a new X509MemStore. +func NewX509MemStore() *X509MemStore { + validate := ValidatorFunc(func(cert *x509.Certificate) bool { return true }) + + return &X509MemStore{ + validate: validate, + fingerprintMap: make(map[CertID]*x509.Certificate), + nameMap: make(map[string][]CertID), + } +} + +// NewX509FilteredMemStore returns a new X509Memstore that validates certificates +// that are added. +func NewX509FilteredMemStore(validate func(*x509.Certificate) bool) *X509MemStore { + s := &X509MemStore{ + + validate: ValidatorFunc(validate), + fingerprintMap: make(map[CertID]*x509.Certificate), + nameMap: make(map[string][]CertID), + } + + return s +} + +// AddCert adds a certificate to the store +func (s *X509MemStore) AddCert(cert *x509.Certificate) error { + if cert == nil { + return errors.New("adding nil Certificate to X509Store") + } + + if !s.validate.Validate(cert) { + return &ErrCertValidation{} + } + + certID, err := fingerprintCert(cert) + if err != nil { + return err + } + + logrus.Debug("Adding cert with certID: ", certID) + + // In this store we overwrite the certificate if it already exists + s.fingerprintMap[certID] = cert + name := string(cert.RawSubject) + s.nameMap[name] = append(s.nameMap[name], certID) + + return nil +} + +// RemoveCert removes a certificate from a X509MemStore. +func (s *X509MemStore) RemoveCert(cert *x509.Certificate) error { + if cert == nil { + return errors.New("removing nil Certificate to X509Store") + } + + certID, err := fingerprintCert(cert) + if err != nil { + return err + } + delete(s.fingerprintMap, certID) + name := string(cert.RawSubject) + + // Filter the fingerprint out of this name entry + fpList := s.nameMap[name] + newfpList := fpList[:0] + for _, x := range fpList { + if x != certID { + newfpList = append(newfpList, x) + } + } + + s.nameMap[name] = newfpList + return nil +} + +// RemoveAll removes all the certificates from the store +func (s *X509MemStore) RemoveAll() error { + + for _, cert := range s.fingerprintMap { + if err := s.RemoveCert(cert); err != nil { + return err + } + } + + return nil +} + +// AddCertFromPEM adds a certificate to the store from a PEM blob +func (s *X509MemStore) AddCertFromPEM(pemBytes []byte) error { + cert, err := LoadCertFromPEM(pemBytes) + if err != nil { + return err + } + return s.AddCert(cert) +} + +// AddCertFromFile tries to adds a X509 certificate to the store given a filename +func (s *X509MemStore) AddCertFromFile(originFilname string) error { + cert, err := LoadCertFromFile(originFilname) + if err != nil { + return err + } + + return s.AddCert(cert) +} + +// GetCertificates returns an array with all of the current X509 Certificates. +func (s *X509MemStore) GetCertificates() []*x509.Certificate { + certs := make([]*x509.Certificate, len(s.fingerprintMap)) + i := 0 + for _, v := range s.fingerprintMap { + certs[i] = v + i++ + } + return certs +} + +// GetCertificatePool returns an x509 CertPool loaded with all the certificates +// in the store. +func (s *X509MemStore) GetCertificatePool() *x509.CertPool { + pool := x509.NewCertPool() + + for _, v := range s.fingerprintMap { + pool.AddCert(v) + } + return pool +} + +// GetCertificateByCertID returns the certificate that matches a certain certID +func (s *X509MemStore) GetCertificateByCertID(certID string) (*x509.Certificate, error) { + return s.getCertificateByCertID(CertID(certID)) +} + +// getCertificateByCertID returns the certificate that matches a certain certID or error +func (s *X509MemStore) getCertificateByCertID(certID CertID) (*x509.Certificate, error) { + // If it does not look like a hex encoded sha256 hash, error + if len(certID) != 64 { + return nil, errors.New("invalid Subject Key Identifier") + } + + // Check to see if this subject key identifier exists + if cert, ok := s.fingerprintMap[CertID(certID)]; ok { + return cert, nil + + } + return nil, &ErrNoCertificatesFound{query: string(certID)} +} + +// GetCertificatesByCN returns all the certificates that match a specific +// CommonName +func (s *X509MemStore) GetCertificatesByCN(cn string) ([]*x509.Certificate, error) { + var certs []*x509.Certificate + if ids, ok := s.nameMap[cn]; ok { + for _, v := range ids { + cert, err := s.getCertificateByCertID(v) + if err != nil { + // This error should never happen. This would mean that we have + // an inconsistent X509MemStore + return nil, err + } + certs = append(certs, cert) + } + } + if len(certs) == 0 { + return nil, &ErrNoCertificatesFound{query: cn} + } + + return certs, nil +} + +// GetVerifyOptions returns VerifyOptions with the certificates within the KeyStore +// as part of the roots list. This never allows the use of system roots, returning +// an error if there are no root CAs. +func (s *X509MemStore) GetVerifyOptions(dnsName string) (x509.VerifyOptions, error) { + // If we have no Certificates loaded return error (we don't want to rever to using + // system CAs). + if len(s.fingerprintMap) == 0 { + return x509.VerifyOptions{}, errors.New("no root CAs available") + } + + opts := x509.VerifyOptions{ + DNSName: dnsName, + Roots: s.GetCertificatePool(), + } + + return opts, nil +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/x509store.go b/vendor/src/github.com/docker/notary/trustmanager/x509store.go new file mode 100644 index 0000000000..3736ff632c --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/x509store.go @@ -0,0 +1,144 @@ +package trustmanager + +import ( + "crypto/x509" + "errors" + "fmt" +) + +const certExtension string = "crt" + +// ErrNoCertificatesFound is returned when no certificates are found for a +// GetCertificatesBy* +type ErrNoCertificatesFound struct { + query string +} + +// ErrNoCertificatesFound is returned when no certificates are found for a +// GetCertificatesBy* +func (err ErrNoCertificatesFound) Error() string { + return fmt.Sprintf("error, no certificates found in the keystore match: %s", err.query) +} + +// ErrCertValidation is returned when a certificate doesn't pass the store specific +// validations +type ErrCertValidation struct { +} + +// ErrCertValidation is returned when a certificate doesn't pass the store specific +// validations +func (err ErrCertValidation) Error() string { + return fmt.Sprintf("store-specific certificate validations failed") +} + +// ErrCertExists is returned when a Certificate already exists in the key store +type ErrCertExists struct { +} + +// ErrCertExists is returned when a Certificate already exists in the key store +func (err ErrCertExists) Error() string { + return fmt.Sprintf("certificate already in the store") +} + +// ErrBadCertificateStore is returned when there is an internal inconsistency +// in our x509 store +type ErrBadCertificateStore struct { +} + +// ErrBadCertificateStore is returned when there is an internal inconsistency +// in our x509 store +func (err ErrBadCertificateStore) Error() string { + return fmt.Sprintf("inconsistent certificate store") +} + +// X509Store is the interface for all X509Stores +type X509Store interface { + AddCert(cert *x509.Certificate) error + AddCertFromPEM(pemCerts []byte) error + AddCertFromFile(filename string) error + RemoveCert(cert *x509.Certificate) error + RemoveAll() error + GetCertificateByCertID(certID string) (*x509.Certificate, error) + GetCertificatesByCN(cn string) ([]*x509.Certificate, error) + GetCertificates() []*x509.Certificate + GetCertificatePool() *x509.CertPool + GetVerifyOptions(dnsName string) (x509.VerifyOptions, error) +} + +// CertID represent the ID used to identify certificates +type CertID string + +// Validator is a convenience type to create validating function that filters +// certificates that get added to the store +type Validator interface { + Validate(cert *x509.Certificate) bool +} + +// ValidatorFunc is a convenience type to create functions that implement +// the Validator interface +type ValidatorFunc func(cert *x509.Certificate) bool + +// Validate implements the Validator interface to allow for any func() bool method +// to be passed as a Validator +func (vf ValidatorFunc) Validate(cert *x509.Certificate) bool { + return vf(cert) +} + +// Verify operates on an X509Store and validates the existence of a chain of trust +// between a leafCertificate and a CA present inside of the X509 Store. +// It requires at least two certificates in certList, a leaf Certificate and an +// intermediate CA certificate. +func Verify(s X509Store, dnsName string, certList []*x509.Certificate) error { + // If we have no Certificates loaded return error (we don't want to revert to using + // system CAs). + if len(s.GetCertificates()) == 0 { + return errors.New("no root CAs available") + } + + // At a minimum we should be provided a leaf cert and an intermediate. + if len(certList) < 2 { + return errors.New("certificate and at least one intermediate needed") + } + + // Get the VerifyOptions from the keystore for a base dnsName + opts, err := s.GetVerifyOptions(dnsName) + if err != nil { + return err + } + + // Create a Certificate Pool for our intermediate certificates + intPool := x509.NewCertPool() + var leafCert *x509.Certificate + + // Iterate through all the certificates + for _, c := range certList { + // If the cert is a CA, we add it to the intermediates pool. If not, we call + // it the leaf cert + if c.IsCA { + intPool.AddCert(c) + continue + } + // Certificate is not a CA, it must be our leaf certificate. + // If we already found one, bail with error + if leafCert != nil { + return errors.New("more than one leaf certificate found") + } + leafCert = c + } + + // We exited the loop with no leaf certificates + if leafCert == nil { + return errors.New("no leaf certificates found") + } + + // We have one leaf certificate and at least one intermediate. Lets add this + // Cert Pool as the Intermediates list on our VerifyOptions + opts.Intermediates = intPool + + // Finally, let's call Verify on our leafCert with our fully configured options + chains, err := leafCert.Verify(opts) + if len(chains) == 0 || err != nil { + return fmt.Errorf("certificate verification failed: %v", err) + } + return nil +} diff --git a/vendor/src/github.com/docker/notary/trustmanager/x509utils.go b/vendor/src/github.com/docker/notary/trustmanager/x509utils.go new file mode 100644 index 0000000000..2661c7677c --- /dev/null +++ b/vendor/src/github.com/docker/notary/trustmanager/x509utils.go @@ -0,0 +1,497 @@ +package trustmanager + +import ( + "crypto/ecdsa" + "crypto/elliptic" + "crypto/rand" + "crypto/rsa" + "crypto/x509" + "crypto/x509/pkix" + "encoding/pem" + "errors" + "fmt" + "io" + "io/ioutil" + "math/big" + "net/http" + "net/url" + "path/filepath" + "time" + + "github.com/Sirupsen/logrus" + "github.com/agl/ed25519" + "github.com/endophage/gotuf/data" +) + +// GetCertFromURL tries to get a X509 certificate given a HTTPS URL +func GetCertFromURL(urlStr string) (*x509.Certificate, error) { + url, err := url.Parse(urlStr) + if err != nil { + return nil, err + } + + // Check if we are adding via HTTPS + if url.Scheme != "https" { + return nil, errors.New("only HTTPS URLs allowed") + } + + // Download the certificate and write to directory + resp, err := http.Get(url.String()) + if err != nil { + return nil, err + } + + // Copy the content to certBytes + defer resp.Body.Close() + certBytes, err := ioutil.ReadAll(resp.Body) + if err != nil { + return nil, err + } + + // Try to extract the first valid PEM certificate from the bytes + cert, err := LoadCertFromPEM(certBytes) + if err != nil { + return nil, err + } + + return cert, nil +} + +// CertToPEM is an utility function returns a PEM encoded x509 Certificate +func CertToPEM(cert *x509.Certificate) []byte { + pemCert := pem.EncodeToMemory(&pem.Block{Type: "CERTIFICATE", Bytes: cert.Raw}) + + return pemCert +} + +// LoadCertFromPEM returns the first certificate found in a bunch of bytes or error +// if nothing is found. Taken from https://golang.org/src/crypto/x509/cert_pool.go#L85. +func LoadCertFromPEM(pemBytes []byte) (*x509.Certificate, error) { + for len(pemBytes) > 0 { + var block *pem.Block + block, pemBytes = pem.Decode(pemBytes) + if block == nil { + return nil, errors.New("no certificates found in PEM data") + } + if block.Type != "CERTIFICATE" || len(block.Headers) != 0 { + continue + } + + cert, err := x509.ParseCertificate(block.Bytes) + if err != nil { + continue + } + + return cert, nil + } + + return nil, errors.New("no certificates found in PEM data") +} + +// FingerprintCert returns a TUF compliant fingerprint for a X509 Certificate +func FingerprintCert(cert *x509.Certificate) (string, error) { + certID, err := fingerprintCert(cert) + if err != nil { + return "", err + } + + return string(certID), nil +} + +func fingerprintCert(cert *x509.Certificate) (CertID, error) { + block := pem.Block{Type: "CERTIFICATE", Bytes: cert.Raw} + pemdata := pem.EncodeToMemory(&block) + + var keyType data.KeyAlgorithm + switch cert.PublicKeyAlgorithm { + case x509.RSA: + keyType = data.RSAx509Key + case x509.ECDSA: + keyType = data.ECDSAx509Key + default: + return "", fmt.Errorf("got Unknown key type while fingerprinting certificate") + } + + // Create new TUF Key so we can compute the TUF-compliant CertID + tufKey := data.NewPublicKey(keyType, pemdata) + + return CertID(tufKey.ID()), nil +} + +// loadCertsFromDir receives a store AddCertFromFile for each certificate found +func loadCertsFromDir(s *X509FileStore) error { + certFiles := s.fileStore.ListFiles(true) + for _, f := range certFiles { + // ListFiles returns relative paths + fullPath := filepath.Join(s.fileStore.BaseDir(), f) + err := s.AddCertFromFile(fullPath) + if err != nil { + if _, ok := err.(*ErrCertValidation); ok { + logrus.Debugf("ignoring certificate, did not pass validation: %s", f) + continue + } + if _, ok := err.(*ErrCertExists); ok { + logrus.Debugf("ignoring certificate, already exists in the store: %s", f) + continue + } + + return err + } + } + return nil +} + +// LoadCertFromFile loads the first certificate from the file provided. The +// data is expected to be PEM Encoded and contain one of more certificates +// with PEM type "CERTIFICATE" +func LoadCertFromFile(filename string) (*x509.Certificate, error) { + certs, err := LoadCertBundleFromFile(filename) + if err != nil { + return nil, err + } + return certs[0], nil +} + +// LoadCertBundleFromFile loads certificates from the []byte provided. The +// data is expected to be PEM Encoded and contain one of more certificates +// with PEM type "CERTIFICATE" +func LoadCertBundleFromFile(filename string) ([]*x509.Certificate, error) { + b, err := ioutil.ReadFile(filename) + if err != nil { + return nil, err + } + + return LoadCertBundleFromPEM(b) +} + +// LoadCertBundleFromPEM loads certificates from the []byte provided. The +// data is expected to be PEM Encoded and contain one of more certificates +// with PEM type "CERTIFICATE" +func LoadCertBundleFromPEM(pemBytes []byte) ([]*x509.Certificate, error) { + certificates := []*x509.Certificate{} + var block *pem.Block + block, pemBytes = pem.Decode(pemBytes) + for ; block != nil; block, pemBytes = pem.Decode(pemBytes) { + if block.Type == "CERTIFICATE" { + cert, err := x509.ParseCertificate(block.Bytes) + if err != nil { + return nil, err + } + certificates = append(certificates, cert) + } else { + return nil, fmt.Errorf("invalid pem block type: %s", block.Type) + } + } + + if len(certificates) == 0 { + return nil, fmt.Errorf("no valid certificates found") + } + + return certificates, nil +} + +// GetLeafCerts parses a list of x509 Certificates and returns all of them +// that aren't CA +func GetLeafCerts(certs []*x509.Certificate) []*x509.Certificate { + var leafCerts []*x509.Certificate + for _, cert := range certs { + if cert.IsCA { + continue + } + leafCerts = append(leafCerts, cert) + } + return leafCerts +} + +// GetIntermediateCerts parses a list of x509 Certificates and returns all of the +// ones marked as a CA, to be used as intermediates +func GetIntermediateCerts(certs []*x509.Certificate) (intCerts []*x509.Certificate) { + for _, cert := range certs { + if cert.IsCA { + intCerts = append(intCerts, cert) + } + } + return intCerts +} + +// ParsePEMPrivateKey returns a data.PrivateKey from a PEM encoded private key. It +// only supports RSA (PKCS#1) and attempts to decrypt using the passphrase, if encrypted. +func ParsePEMPrivateKey(pemBytes []byte, passphrase string) (data.PrivateKey, error) { + block, _ := pem.Decode(pemBytes) + if block == nil { + return nil, errors.New("no valid private key found") + } + + switch block.Type { + case "RSA PRIVATE KEY": + var privKeyBytes []byte + var err error + + if x509.IsEncryptedPEMBlock(block) { + privKeyBytes, err = x509.DecryptPEMBlock(block, []byte(passphrase)) + if err != nil { + return nil, errors.New("could not decrypt private key") + } + } else { + privKeyBytes = block.Bytes + } + + rsaPrivKey, err := x509.ParsePKCS1PrivateKey(privKeyBytes) + if err != nil { + return nil, fmt.Errorf("could not parse DER encoded key: %v", err) + } + + tufRSAPrivateKey, err := RSAToPrivateKey(rsaPrivKey) + if err != nil { + return nil, fmt.Errorf("could not convert rsa.PrivateKey to data.PrivateKey: %v", err) + } + + return tufRSAPrivateKey, nil + case "EC PRIVATE KEY": + var privKeyBytes []byte + var err error + + if x509.IsEncryptedPEMBlock(block) { + privKeyBytes, err = x509.DecryptPEMBlock(block, []byte(passphrase)) + if err != nil { + return nil, errors.New("could not decrypt private key") + } + } else { + privKeyBytes = block.Bytes + } + + ecdsaPrivKey, err := x509.ParseECPrivateKey(privKeyBytes) + if err != nil { + return nil, fmt.Errorf("could not parse DER encoded private key: %v", err) + } + + tufECDSAPrivateKey, err := ECDSAToPrivateKey(ecdsaPrivKey) + if err != nil { + return nil, fmt.Errorf("could not convert ecdsa.PrivateKey to data.PrivateKey: %v", err) + } + + return tufECDSAPrivateKey, nil + case "ED25519 PRIVATE KEY": + // We serialize ED25519 keys by concatenating the private key + // to the public key and encoding with PEM. See the + // ED25519ToPrivateKey function. + var privKeyBytes []byte + var err error + + if x509.IsEncryptedPEMBlock(block) { + privKeyBytes, err = x509.DecryptPEMBlock(block, []byte(passphrase)) + if err != nil { + return nil, errors.New("could not decrypt private key") + } + } else { + privKeyBytes = block.Bytes + } + + tufECDSAPrivateKey, err := ED25519ToPrivateKey(privKeyBytes) + if err != nil { + return nil, fmt.Errorf("could not convert ecdsa.PrivateKey to data.PrivateKey: %v", err) + } + + return tufECDSAPrivateKey, nil + + default: + return nil, fmt.Errorf("unsupported key type %q", block.Type) + } +} + +// GenerateRSAKey generates an RSA private key and returns a TUF PrivateKey +func GenerateRSAKey(random io.Reader, bits int) (data.PrivateKey, error) { + rsaPrivKey, err := rsa.GenerateKey(random, bits) + if err != nil { + return nil, fmt.Errorf("could not generate private key: %v", err) + } + + tufPrivKey, err := RSAToPrivateKey(rsaPrivKey) + if err != nil { + return nil, err + } + + logrus.Debugf("generated RSA key with keyID: %s", tufPrivKey.ID()) + + return tufPrivKey, nil +} + +// RSAToPrivateKey converts an rsa.Private key to a TUF data.PrivateKey type +func RSAToPrivateKey(rsaPrivKey *rsa.PrivateKey) (data.PrivateKey, error) { + // Get a DER-encoded representation of the PublicKey + rsaPubBytes, err := x509.MarshalPKIXPublicKey(&rsaPrivKey.PublicKey) + if err != nil { + return nil, fmt.Errorf("failed to marshal public key: %v", err) + } + + // Get a DER-encoded representation of the PrivateKey + rsaPrivBytes := x509.MarshalPKCS1PrivateKey(rsaPrivKey) + + return data.NewPrivateKey(data.RSAKey, rsaPubBytes, rsaPrivBytes), nil +} + +// GenerateECDSAKey generates an ECDSA Private key and returns a TUF PrivateKey +func GenerateECDSAKey(random io.Reader) (data.PrivateKey, error) { + ecdsaPrivKey, err := ecdsa.GenerateKey(elliptic.P256(), random) + if err != nil { + return nil, err + } + + tufPrivKey, err := ECDSAToPrivateKey(ecdsaPrivKey) + if err != nil { + return nil, err + } + + logrus.Debugf("generated ECDSA key with keyID: %s", tufPrivKey.ID()) + + return tufPrivKey, nil +} + +// GenerateED25519Key generates an ED25519 private key and returns a TUF +// PrivateKey. The serialization format we use is just the public key bytes +// followed by the private key bytes +func GenerateED25519Key(random io.Reader) (data.PrivateKey, error) { + pub, priv, err := ed25519.GenerateKey(random) + if err != nil { + return nil, err + } + + var serialized [ed25519.PublicKeySize + ed25519.PrivateKeySize]byte + copy(serialized[:], pub[:]) + copy(serialized[ed25519.PublicKeySize:], priv[:]) + + tufPrivKey, err := ED25519ToPrivateKey(serialized[:]) + if err != nil { + return nil, err + } + + logrus.Debugf("generated ED25519 key with keyID: %s", tufPrivKey.ID()) + + return tufPrivKey, nil +} + +// ECDSAToPrivateKey converts an rsa.Private key to a TUF data.PrivateKey type +func ECDSAToPrivateKey(ecdsaPrivKey *ecdsa.PrivateKey) (data.PrivateKey, error) { + // Get a DER-encoded representation of the PublicKey + ecdsaPubBytes, err := x509.MarshalPKIXPublicKey(&ecdsaPrivKey.PublicKey) + if err != nil { + return nil, fmt.Errorf("failed to marshal public key: %v", err) + } + + // Get a DER-encoded representation of the PrivateKey + ecdsaPrivKeyBytes, err := x509.MarshalECPrivateKey(ecdsaPrivKey) + if err != nil { + return nil, fmt.Errorf("failed to marshal private key: %v", err) + } + + return data.NewPrivateKey(data.ECDSAKey, ecdsaPubBytes, ecdsaPrivKeyBytes), nil +} + +// ED25519ToPrivateKey converts a serialized ED25519 key to a TUF +// data.PrivateKey type +func ED25519ToPrivateKey(privKeyBytes []byte) (data.PrivateKey, error) { + if len(privKeyBytes) != ed25519.PublicKeySize+ed25519.PrivateKeySize { + return nil, errors.New("malformed ed25519 private key") + } + + return data.NewPrivateKey(data.ED25519Key, privKeyBytes[:ed25519.PublicKeySize], privKeyBytes), nil +} + +func blockType(algorithm data.KeyAlgorithm) (string, error) { + switch algorithm { + case data.RSAKey: + return "RSA PRIVATE KEY", nil + case data.ECDSAKey: + return "EC PRIVATE KEY", nil + case data.ED25519Key: + return "ED25519 PRIVATE KEY", nil + default: + return "", fmt.Errorf("algorithm %s not supported", algorithm) + } +} + +// KeyToPEM returns a PEM encoded key from a Private Key +func KeyToPEM(privKey data.PrivateKey) ([]byte, error) { + blockType, err := blockType(privKey.Algorithm()) + if err != nil { + return nil, err + } + + return pem.EncodeToMemory(&pem.Block{Type: blockType, Bytes: privKey.Private()}), nil +} + +// EncryptPrivateKey returns an encrypted PEM key given a Privatekey +// and a passphrase +func EncryptPrivateKey(key data.PrivateKey, passphrase string) ([]byte, error) { + blockType, err := blockType(key.Algorithm()) + if err != nil { + return nil, err + } + + password := []byte(passphrase) + cipherType := x509.PEMCipherAES256 + + encryptedPEMBlock, err := x509.EncryptPEMBlock(rand.Reader, + blockType, + key.Private(), + password, + cipherType) + if err != nil { + return nil, err + } + + return pem.EncodeToMemory(encryptedPEMBlock), nil +} + +// CertsToKeys transforms each of the input certificates into it's corresponding +// PublicKey +func CertsToKeys(certs []*x509.Certificate) map[string]data.PublicKey { + keys := make(map[string]data.PublicKey) + for _, cert := range certs { + block := pem.Block{Type: "CERTIFICATE", Bytes: cert.Raw} + pemdata := pem.EncodeToMemory(&block) + + var keyType data.KeyAlgorithm + switch cert.PublicKeyAlgorithm { + case x509.RSA: + keyType = data.RSAx509Key + case x509.ECDSA: + keyType = data.ECDSAx509Key + default: + logrus.Debugf("unknown certificate type found, ignoring") + } + + // Create new the appropriate PublicKey + newKey := data.NewPublicKey(keyType, pemdata) + keys[newKey.ID()] = newKey + } + + return keys +} + +// NewCertificate returns an X509 Certificate following a template, given a GUN. +func NewCertificate(gun string) (*x509.Certificate, error) { + notBefore := time.Now() + // Certificates will expire in 10 years + notAfter := notBefore.Add(time.Hour * 24 * 365 * 10) + + serialNumberLimit := new(big.Int).Lsh(big.NewInt(1), 128) + + serialNumber, err := rand.Int(rand.Reader, serialNumberLimit) + if err != nil { + return nil, fmt.Errorf("failed to generate new certificate: %v", err) + } + + return &x509.Certificate{ + SerialNumber: serialNumber, + Subject: pkix.Name{ + CommonName: gun, + }, + NotBefore: notBefore, + NotAfter: notAfter, + + KeyUsage: x509.KeyUsageKeyEncipherment | x509.KeyUsageDigitalSignature, + ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageCodeSigning}, + BasicConstraintsValid: true, + }, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/.gitignore b/vendor/src/github.com/endophage/gotuf/.gitignore new file mode 100644 index 0000000000..2928b6ae98 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/.gitignore @@ -0,0 +1,3 @@ +/db/ +*.bkp +*.swp diff --git a/vendor/src/github.com/endophage/gotuf/.travis.yml b/vendor/src/github.com/endophage/gotuf/.travis.yml new file mode 100644 index 0000000000..b0822a6c99 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/.travis.yml @@ -0,0 +1,30 @@ +language: go +go: + - 1.4 + - tip + +sudo: false + +before_install: + - go get golang.org/x/tools/cmd/cover + +script: + - go test -race -cover ./... + +notifications: + irc: + channels: + - "chat.freenode.net#flynn" + use_notice: true + skip_join: true + on_success: change + on_failure: always + template: + - "%{repository}/%{branch} - %{commit}: %{message} %{build_url}" + email: + on_success: never + on_failure: always + +matrix: + allow_failures: + - go: tip diff --git a/vendor/src/github.com/endophage/gotuf/CONTRIBUTORS b/vendor/src/github.com/endophage/gotuf/CONTRIBUTORS new file mode 100644 index 0000000000..5f484889cb --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/CONTRIBUTORS @@ -0,0 +1,3 @@ +Aaron Lehmann (github: aaronlehmann) +Lewis Marshall (github: lmars) +Jonathan Rudenberg (github: titanous) diff --git a/vendor/src/github.com/endophage/gotuf/LICENSE b/vendor/src/github.com/endophage/gotuf/LICENSE new file mode 100644 index 0000000000..d92ae9ee14 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/LICENSE @@ -0,0 +1,30 @@ +Copyright (c) 2015, Docker Inc. +Copyright (c) 2014-2015 Prime Directive, Inc. + +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Prime Directive, Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/endophage/gotuf/MAINTAINERS b/vendor/src/github.com/endophage/gotuf/MAINTAINERS new file mode 100644 index 0000000000..d7dda3f4fc --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/MAINTAINERS @@ -0,0 +1 @@ +David Lawrence (github: endophage) diff --git a/vendor/src/github.com/endophage/gotuf/Makefile b/vendor/src/github.com/endophage/gotuf/Makefile new file mode 100644 index 0000000000..02c6d4d1b3 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/Makefile @@ -0,0 +1,34 @@ +# Set an output prefix, which is the local directory if not specified +PREFIX?=$(shell pwd) + +vet: + @echo "+ $@" + @go vet ./... + +fmt: + @echo "+ $@" + @test -z "$$(gofmt -s -l . | grep -v Godeps/_workspace/src/ | tee /dev/stderr)" || \ + echo "+ please format Go code with 'gofmt -s'" + +lint: + @echo "+ $@" + @test -z "$$(golint ./... | grep -v Godeps/_workspace/src/ | tee /dev/stderr)" + +build: + @echo "+ $@" + @go build -v ${GO_LDFLAGS} ./... + +test: + @echo "+ $@" + @go test -test.short ./... + +test-full: + @echo "+ $@" + @go test ./... + +binaries: ${PREFIX}/bin/registry ${PREFIX}/bin/registry-api-descriptor-template ${PREFIX}/bin/dist + @echo "+ $@" + +clean: + @echo "+ $@" + @rm -rf "${PREFIX}/bin/registry" "${PREFIX}/bin/registry-api-descriptor-template" diff --git a/vendor/src/github.com/endophage/gotuf/README.md b/vendor/src/github.com/endophage/gotuf/README.md new file mode 100644 index 0000000000..ac8d6d1132 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/README.md @@ -0,0 +1,36 @@ +# GOTUF + +This is still a work in progress but will shortly be a fully compliant +Go implementation of [The Update Framework (TUF)](http://theupdateframework.com/). + +## Where's the CLI + +This repository provides a library only. The [Notary project](https://github.com/docker/notary) +from Docker should be considered the official CLI to be used with this implementation of TUF. + +## TODOs: + +- [X] Add Targets to existing repo +- [X] Sign metadata files +- [X] Refactor TufRepo to take care of signing ~~and verification~~ +- [ ] Ensure consistent capitalization in naming (TUF\_\_\_ vs Tuf\_\_\_) +- [X] Make caching of metadata files smarter - PR #5 +- [ ] ~~Add configuration for CLI commands. Order of configuration priority from most to least: flags, config file, defaults~~ Notary should be the official CLI +- [X] Reasses organization of data types. Possibly consolidate a few things into the data package but break up package into a few more distinct files +- [ ] Comprehensive test cases +- [ ] Delete files no longer in use +- [ ] Fix up errors. Some have to be instantiated, others don't, the inconsistency is annoying. +- [X] Bump version numbers in meta files (could probably be done better) + +## Credits + +This implementation was originally forked from [flynn/go-tuf](https://github.com/flynn/go-tuf), +however in attempting to add delegations I found I was making such +significant changes that I could not maintain backwards compatibility +without the code becoming overly convoluted. + +Some features such as pluggable verifiers have alreayd been merged upstream to flynn/go-tuf +and we are in discussion with [titanous](https://github.com/titanous) about working to merge the 2 implementations. + +This implementation retains the same 3 Clause BSD license present on +the original flynn implementation. diff --git a/vendor/src/github.com/endophage/gotuf/client/client.go b/vendor/src/github.com/endophage/gotuf/client/client.go new file mode 100644 index 0000000000..c0fcf7a830 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/client/client.go @@ -0,0 +1,553 @@ +package client + +import ( + "bytes" + "crypto/sha256" + "encoding/hex" + "encoding/json" + "fmt" + "io" + "path" + "path/filepath" + "strings" + + "github.com/Sirupsen/logrus" + tuf "github.com/endophage/gotuf" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/keys" + "github.com/endophage/gotuf/signed" + "github.com/endophage/gotuf/store" + "github.com/endophage/gotuf/utils" +) + +const maxSize int64 = 5 << 20 + +type Client struct { + local *tuf.TufRepo + remote store.RemoteStore + keysDB *keys.KeyDB + cache store.MetadataStore +} + +func NewClient(local *tuf.TufRepo, remote store.RemoteStore, keysDB *keys.KeyDB, cache store.MetadataStore) *Client { + return &Client{ + local: local, + remote: remote, + keysDB: keysDB, + cache: cache, + } +} + +func (c *Client) Update() error { + // 1. Get timestamp + // a. If timestamp error (verification, expired, etc...) download new root and return to 1. + // 2. Check if local snapshot is up to date + // a. If out of date, get updated snapshot + // i. If snapshot error, download new root and return to 1. + // 3. Check if root correct against snapshot + // a. If incorrect, download new root and return to 1. + // 4. Iteratively download and search targets and delegations to find target meta + logrus.Debug("updating TUF client") + err := c.update() + if err != nil { + logrus.Debug("Error occurred. Root will be downloaded and another update attempted") + if err := c.downloadRoot(); err != nil { + logrus.Errorf("client Update (Root):", err) + return err + } + // If we error again, we now have the latest root and just want to fail + // out as there's no expectation the problem can be resolved automatically + logrus.Debug("retrying TUF client update") + return c.update() + } + return nil +} + +func (c *Client) update() error { + err := c.downloadTimestamp() + if err != nil { + logrus.Errorf("Client Update (Timestamp): %s", err.Error()) + return err + } + err = c.downloadSnapshot() + if err != nil { + logrus.Errorf("Client Update (Snapshot): %s", err.Error()) + return err + } + err = c.checkRoot() + if err != nil { + // In this instance the root has not expired base on time, but is + // expired based on the snapshot dictating a new root has been produced. + logrus.Debug(err) + return tuf.ErrLocalRootExpired{} + } + // will always need top level targets at a minimum + err = c.downloadTargets("targets") + if err != nil { + logrus.Errorf("Client Update (Targets): %s", err.Error()) + return err + } + return nil +} + +// checkRoot determines if the hash, and size are still those reported +// in the snapshot file. It will also check the expiry, however, if the +// hash and size in snapshot are unchanged but the root file has expired, +// there is little expectation that the situation can be remedied. +func (c Client) checkRoot() error { + role := data.RoleName("root") + size := c.local.Snapshot.Signed.Meta[role].Length + hashSha256 := c.local.Snapshot.Signed.Meta[role].Hashes["sha256"] + + raw, err := c.cache.GetMeta("root", size) + if err != nil { + return err + } + + hash := sha256.Sum256(raw) + if !bytes.Equal(hash[:], hashSha256) { + return fmt.Errorf("Cached root sha256 did not match snapshot root sha256") + } + + if int64(len(raw)) != size { + return fmt.Errorf("Cached root size did not match snapshot size") + } + + root := &data.SignedRoot{} + err = json.Unmarshal(raw, root) + if err != nil { + return ErrCorruptedCache{file: "root.json"} + } + + if signed.IsExpired(root.Signed.Expires) { + return tuf.ErrLocalRootExpired{} + } + return nil +} + +// downloadRoot is responsible for downloading the root.json +func (c *Client) downloadRoot() error { + role := data.RoleName("root") + size := maxSize + var expectedSha256 []byte = nil + if c.local.Snapshot != nil { + size = c.local.Snapshot.Signed.Meta[role].Length + expectedSha256 = c.local.Snapshot.Signed.Meta[role].Hashes["sha256"] + } + + // if we're bootstrapping we may not have a cached root, an + // error will result in the "previous root version" being + // interpreted as 0. + var download bool + var err error + var cachedRoot []byte = nil + old := &data.Signed{} + version := 0 + + if expectedSha256 != nil { + // can only trust cache if we have an expected sha256 to trust + cachedRoot, err = c.cache.GetMeta(role, size) + } + + if cachedRoot == nil || err != nil { + logrus.Debug("didn't find a cached root, must download") + download = true + } else { + hash := sha256.Sum256(cachedRoot) + if !bytes.Equal(hash[:], expectedSha256) { + logrus.Debug("cached root's hash didn't match expected, must download") + download = true + } + err := json.Unmarshal(cachedRoot, old) + if err == nil { + root, err := data.RootFromSigned(old) + if err == nil { + version = root.Signed.Version + } else { + logrus.Debug("couldn't parse Signed part of cached root, must download") + download = true + } + } else { + logrus.Debug("couldn't parse cached root, must download") + download = true + } + } + var s *data.Signed + var raw []byte + if download { + raw, s, err = c.downloadSigned(role, size, expectedSha256) + if err != nil { + return err + } + } else { + logrus.Debug("using cached root") + s = old + } + if err := c.verifyRoot(role, s, version); err != nil { + return err + } + if download { + logrus.Debug("caching downloaded root") + // Now that we have accepted new root, write it to cache + if err = c.cache.SetMeta(role, raw); err != nil { + logrus.Errorf("Failed to write root to local cache: %s", err.Error()) + } + } + return nil +} + +func (c Client) verifyRoot(role string, s *data.Signed, minVersion int) error { + // this will confirm that the root has been signed by the old root role + // as c.keysDB contains the root keys we bootstrapped with. + // Still need to determine if there has been a root key update and + // confirm signature with new root key + logrus.Debug("verifying root with existing keys") + err := signed.Verify(s, role, minVersion, c.keysDB) + if err != nil { + logrus.Debug("root did not verify with existing keys") + return err + } + + // This will cause keyDB to get updated, overwriting any keyIDs associated + // with the roles in root.json + logrus.Debug("updating known root roles and keys") + root, err := data.RootFromSigned(s) + if err != nil { + logrus.Error(err.Error()) + return err + } + err = c.local.SetRoot(root) + if err != nil { + logrus.Error(err.Error()) + return err + } + // verify again now that the old keys have been replaced with the new keys. + // TODO(endophage): be more intelligent and only re-verify if we detect + // there has been a change in root keys + logrus.Debug("verifying root with updated keys") + err = signed.Verify(s, role, minVersion, c.keysDB) + if err != nil { + logrus.Debug("root did not verify with new keys") + return err + } + logrus.Debug("successfully verified root") + return nil +} + +// downloadTimestamp is responsible for downloading the timestamp.json +// Timestamps are special in that we ALWAYS attempt to download and only +// use cache if the download fails (and the cache is still valid). +func (c *Client) downloadTimestamp() error { + logrus.Debug("downloadTimestamp") + role := data.RoleName("timestamp") + + // We may not have a cached timestamp if this is the first time + // we're interacting with the repo. This will result in the + // version being 0 + var download bool + old := &data.Signed{} + version := 0 + cachedTS, err := c.cache.GetMeta(role, maxSize) + if err == nil { + err := json.Unmarshal(cachedTS, old) + if err == nil { + ts, err := data.TimestampFromSigned(old) + if err == nil { + version = ts.Signed.Version + } + } else { + old = nil + } + } + // unlike root, targets and snapshot, always try and download timestamps + // from remote, only using the cache one if we couldn't reach remote. + raw, s, err := c.downloadSigned(role, maxSize, nil) + if err != nil || len(raw) == 0 { + if err, ok := err.(store.ErrMetaNotFound); ok { + return err + } + if old == nil { + if err == nil { + // couldn't retrieve data from server and don't have valid + // data in cache. + return store.ErrMetaNotFound{} + } + return err + } + logrus.Debug("using cached timestamp") + s = old + } else { + download = true + } + err = signed.Verify(s, role, version, c.keysDB) + if err != nil { + return err + } + logrus.Debug("successfully verified timestamp") + if download { + c.cache.SetMeta(role, raw) + } + ts, err := data.TimestampFromSigned(s) + if err != nil { + return err + } + c.local.SetTimestamp(ts) + return nil +} + +// downloadSnapshot is responsible for downloading the snapshot.json +func (c *Client) downloadSnapshot() error { + logrus.Debug("downloadSnapshot") + role := data.RoleName("snapshot") + if c.local.Timestamp == nil { + return ErrMissingMeta{role: "snapshot"} + } + size := c.local.Timestamp.Signed.Meta[role].Length + expectedSha256, ok := c.local.Timestamp.Signed.Meta[role].Hashes["sha256"] + if !ok { + return ErrMissingMeta{role: "snapshot"} + } + + var download bool + old := &data.Signed{} + version := 0 + raw, err := c.cache.GetMeta(role, size) + if raw == nil || err != nil { + logrus.Debug("no snapshot in cache, must download") + download = true + } else { + // file may have been tampered with on disk. Always check the hash! + genHash := sha256.Sum256(raw) + if !bytes.Equal(genHash[:], expectedSha256) { + logrus.Debug("hash of snapshot in cache did not match expected hash, must download") + download = true + } + err := json.Unmarshal(raw, old) + if err == nil { + snap, err := data.TimestampFromSigned(old) + if err == nil { + version = snap.Signed.Version + } else { + logrus.Debug("Could not parse Signed part of snapshot, must download") + download = true + } + } else { + logrus.Debug("Could not parse snapshot, must download") + download = true + } + } + var s *data.Signed + if download { + raw, s, err = c.downloadSigned(role, size, expectedSha256) + if err != nil { + return err + } + } else { + logrus.Debug("using cached snapshot") + s = old + } + + err = signed.Verify(s, role, version, c.keysDB) + if err != nil { + return err + } + logrus.Debug("successfully verified snapshot") + snap, err := data.SnapshotFromSigned(s) + if err != nil { + return err + } + c.local.SetSnapshot(snap) + if download { + err = c.cache.SetMeta(role, raw) + if err != nil { + logrus.Errorf("Failed to write snapshot to local cache: %s", err.Error()) + } + } + return nil +} + +// downloadTargets is responsible for downloading any targets file +// including delegates roles. +func (c *Client) downloadTargets(role string) error { + role = data.RoleName(role) // this will really only do something for base targets role + if c.local.Snapshot == nil { + return ErrMissingMeta{role: role} + } + snap := c.local.Snapshot.Signed + root := c.local.Root.Signed + r := c.keysDB.GetRole(role) + if r == nil { + return fmt.Errorf("Invalid role: %s", role) + } + keyIDs := r.KeyIDs + s, err := c.GetTargetsFile(role, keyIDs, snap.Meta, root.ConsistentSnapshot, r.Threshold) + if err != nil { + logrus.Error("Error getting targets file:", err) + return err + } + t, err := data.TargetsFromSigned(s) + if err != nil { + return err + } + err = c.local.SetTargets(role, t) + if err != nil { + return err + } + + return nil +} + +func (c *Client) downloadSigned(role string, size int64, expectedSha256 []byte) ([]byte, *data.Signed, error) { + raw, err := c.remote.GetMeta(role, size) + if err != nil { + return nil, nil, err + } + genHash := sha256.Sum256(raw) + if expectedSha256 != nil && !bytes.Equal(genHash[:], expectedSha256) { + return nil, nil, ErrChecksumMismatch{role: role} + } + s := &data.Signed{} + err = json.Unmarshal(raw, s) + if err != nil { + return nil, nil, err + } + return raw, s, nil +} + +func (c Client) GetTargetsFile(role string, keyIDs []string, snapshotMeta data.Files, consistent bool, threshold int) (*data.Signed, error) { + // require role exists in snapshots + roleMeta, ok := snapshotMeta[role] + if !ok { + return nil, ErrMissingMeta{role: role} + } + expectedSha256, ok := snapshotMeta[role].Hashes["sha256"] + if !ok { + return nil, ErrMissingMeta{role: role} + } + + // try to get meta file from content addressed cache + var download bool + old := &data.Signed{} + version := 0 + raw, err := c.cache.GetMeta(role, roleMeta.Length) + if err != nil || raw == nil { + logrus.Debugf("Couldn't not find cached %s, must download", role) + download = true + } else { + // file may have been tampered with on disk. Always check the hash! + genHash := sha256.Sum256(raw) + if !bytes.Equal(genHash[:], expectedSha256) { + download = true + } + err := json.Unmarshal(raw, old) + if err == nil { + targ, err := data.TargetsFromSigned(old) + if err == nil { + version = targ.Signed.Version + } else { + download = true + } + } else { + download = true + } + } + + size := snapshotMeta[role].Length + var s *data.Signed + if download { + rolePath, err := c.RoleTargetsPath(role, hex.EncodeToString(expectedSha256), consistent) + if err != nil { + return nil, err + } + raw, s, err = c.downloadSigned(rolePath, size, expectedSha256) + if err != nil { + return nil, err + } + } else { + logrus.Debug("using cached ", role) + s = old + } + + err = signed.Verify(s, role, version, c.keysDB) + if err != nil { + return nil, err + } + logrus.Debugf("successfully verified %s", role) + if download { + // if we error when setting meta, we should continue. + err = c.cache.SetMeta(role, raw) + if err != nil { + logrus.Errorf("Failed to write snapshot to local cache: %s", err.Error()) + } + } + return s, nil +} + +// RoleTargetsPath generates the appropriate filename for the targets file, +// based on whether the repo is marked as consistent. +func (c Client) RoleTargetsPath(role string, hashSha256 string, consistent bool) (string, error) { + if consistent { + dir := filepath.Dir(role) + if strings.Contains(role, "/") { + lastSlashIdx := strings.LastIndex(role, "/") + role = role[lastSlashIdx+1:] + } + role = path.Join( + dir, + fmt.Sprintf("%s.%s.json", hashSha256, role), + ) + } + return role, nil +} + +// TargetMeta ensures the repo is up to date, downloading the minimum +// necessary metadata files +func (c Client) TargetMeta(path string) (*data.FileMeta, error) { + c.Update() + var meta *data.FileMeta + + pathDigest := sha256.Sum256([]byte(path)) + pathHex := hex.EncodeToString(pathDigest[:]) + + // FIFO list of targets delegations to inspect for target + roles := []string{data.ValidRoles["targets"]} + var role string + for len(roles) > 0 { + // have to do these lines here because of order of execution in for statement + role = roles[0] + roles = roles[1:] + + // Download the target role file if necessary + err := c.downloadTargets(role) + if err != nil { + // as long as we find a valid target somewhere we're happy. + // continue and search other delegated roles if any + continue + } + + meta = c.local.TargetMeta(role, path) + if meta != nil { + // we found the target! + return meta, nil + } + delegations := c.local.TargetDelegations(role, path, pathHex) + for _, d := range delegations { + roles = append(roles, d.Name) + } + } + return meta, nil +} + +func (c Client) DownloadTarget(dst io.Writer, path string, meta *data.FileMeta) error { + reader, err := c.remote.GetTarget(path) + if err != nil { + return err + } + defer reader.Close() + r := io.TeeReader( + io.LimitReader(reader, meta.Length), + dst, + ) + err = utils.ValidateTarget(r, meta) + return err +} diff --git a/vendor/src/github.com/endophage/gotuf/client/errors.go b/vendor/src/github.com/endophage/gotuf/client/errors.go new file mode 100644 index 0000000000..8c8ae527ca --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/client/errors.go @@ -0,0 +1,130 @@ +package client + +import ( + "errors" + "fmt" +) + +var ( + ErrNoRootKeys = errors.New("tuf: no root keys found in local meta store") + ErrInsufficientKeys = errors.New("tuf: insufficient keys to meet threshold") +) + +type ErrChecksumMismatch struct { + role string +} + +func (e ErrChecksumMismatch) Error() string { + return fmt.Sprintf("tuf: checksum for %s did not match", e.role) +} + +type ErrMissingMeta struct { + role string +} + +func (e ErrMissingMeta) Error() string { + return fmt.Sprintf("tuf: sha256 checksum required for %s", e.role) +} + +type ErrMissingRemoteMetadata struct { + Name string +} + +func (e ErrMissingRemoteMetadata) Error() string { + return fmt.Sprintf("tuf: missing remote metadata %s", e.Name) +} + +type ErrDownloadFailed struct { + File string + Err error +} + +func (e ErrDownloadFailed) Error() string { + return fmt.Sprintf("tuf: failed to download %s: %s", e.File, e.Err) +} + +type ErrDecodeFailed struct { + File string + Err error +} + +func (e ErrDecodeFailed) Error() string { + return fmt.Sprintf("tuf: failed to decode %s: %s", e.File, e.Err) +} + +func isDecodeFailedWithErr(err, expected error) bool { + e, ok := err.(ErrDecodeFailed) + if !ok { + return false + } + return e.Err == expected +} + +type ErrNotFound struct { + File string +} + +func (e ErrNotFound) Error() string { + return fmt.Sprintf("tuf: file not found: %s", e.File) +} + +func IsNotFound(err error) bool { + _, ok := err.(ErrNotFound) + return ok +} + +type ErrWrongSize struct { + File string + Actual int64 + Expected int64 +} + +func (e ErrWrongSize) Error() string { + return fmt.Sprintf("tuf: unexpected file size: %s (expected %d bytes, got %d bytes)", e.File, e.Expected, e.Actual) +} + +type ErrLatestSnapshot struct { + Version int +} + +func (e ErrLatestSnapshot) Error() string { + return fmt.Sprintf("tuf: the local snapshot version (%d) is the latest", e.Version) +} + +func IsLatestSnapshot(err error) bool { + _, ok := err.(ErrLatestSnapshot) + return ok +} + +type ErrUnknownTarget struct { + Name string +} + +func (e ErrUnknownTarget) Error() string { + return fmt.Sprintf("tuf: unknown target file: %s", e.Name) +} + +type ErrMetaTooLarge struct { + Name string + Size int64 +} + +func (e ErrMetaTooLarge) Error() string { + return fmt.Sprintf("tuf: %s size %d bytes greater than maximum", e.Name, e.Size) +} + +type ErrInvalidURL struct { + URL string +} + +func (e ErrInvalidURL) Error() string { + return fmt.Sprintf("tuf: invalid repository URL %s", e.URL) +} + +type ErrCorruptedCache struct { + file string +} + +func (e ErrCorruptedCache) Error() string { + return fmt.Sprintf("cache is corrupted: %s", e.file) +} diff --git a/vendor/src/github.com/endophage/gotuf/data/keys.go b/vendor/src/github.com/endophage/gotuf/data/keys.go new file mode 100644 index 0000000000..eccccc420d --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/keys.go @@ -0,0 +1,96 @@ +package data + +import ( + "crypto/sha256" + "encoding/hex" + + "github.com/Sirupsen/logrus" + "github.com/jfrazelle/go/canonical/json" +) + +type Key interface { + ID() string + Algorithm() KeyAlgorithm + Public() []byte +} + +type PublicKey interface { + Key +} + +type PrivateKey interface { + Key + + Private() []byte +} + +type KeyPair struct { + Public []byte `json:"public"` + Private []byte `json:"private"` +} + +// TUFKey is the structure used for both public and private keys in TUF. +// Normally it would make sense to use a different structures for public and +// private keys, but that would change the key ID algorithm (since the canonical +// JSON would be different). This structure should normally be accessed through +// the PublicKey or PrivateKey interfaces. +type TUFKey struct { + id string `json:"-"` + Type KeyAlgorithm `json:"keytype"` + Value KeyPair `json:"keyval"` +} + +func NewPrivateKey(algorithm KeyAlgorithm, public, private []byte) *TUFKey { + return &TUFKey{ + Type: algorithm, + Value: KeyPair{ + Public: public, + Private: private, + }, + } +} + +func (k TUFKey) Algorithm() KeyAlgorithm { + return k.Type +} + +func (k *TUFKey) ID() string { + if k.id == "" { + pubK := NewPublicKey(k.Algorithm(), k.Public()) + data, err := json.MarshalCanonical(&pubK) + if err != nil { + logrus.Error("Error generating key ID:", err) + } + digest := sha256.Sum256(data) + k.id = hex.EncodeToString(digest[:]) + } + return k.id +} + +func (k TUFKey) Public() []byte { + return k.Value.Public +} + +func (k TUFKey) Private() []byte { + return k.Value.Private +} + +func NewPublicKey(algorithm KeyAlgorithm, public []byte) PublicKey { + return &TUFKey{ + Type: algorithm, + Value: KeyPair{ + Public: public, + Private: nil, + }, + } +} + +func PublicKeyFromPrivate(pk PrivateKey) PublicKey { + return &TUFKey{ + Type: pk.Algorithm(), + Value: KeyPair{ + Public: pk.Public(), + Private: nil, + }, + } +} diff --git a/vendor/src/github.com/endophage/gotuf/data/roles.go b/vendor/src/github.com/endophage/gotuf/data/roles.go new file mode 100644 index 0000000000..1034393e1d --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/roles.go @@ -0,0 +1,150 @@ +package data + +import ( + "fmt" + "strings" + + "github.com/endophage/gotuf/errors" +) + +// Canonical base role names +const ( + CanonicalRootRole = "root" + CanonicalTargetsRole = "targets" + CanonicalSnapshotRole = "snapshot" + CanonicalTimestampRole = "timestamp" +) + +var ValidRoles = map[string]string{ + CanonicalRootRole: CanonicalRootRole, + CanonicalTargetsRole: CanonicalTargetsRole, + CanonicalSnapshotRole: CanonicalSnapshotRole, + CanonicalTimestampRole: CanonicalTimestampRole, +} + +func SetValidRoles(rs map[string]string) { + // iterate ValidRoles + for k := range ValidRoles { + if v, ok := rs[k]; ok { + ValidRoles[k] = v + } + } +} + +func RoleName(role string) string { + if r, ok := ValidRoles[role]; ok { + return r + } + return role +} + +func CanonicalRole(role string) string { + name := strings.ToLower(role) + if _, ok := ValidRoles[name]; ok { + // The canonical version is always lower case + // se ensure we return name, not role + return name + } + targetsBase := fmt.Sprintf("%s/", ValidRoles[CanonicalTargetsRole]) + if strings.HasPrefix(name, targetsBase) { + role = strings.TrimPrefix(role, targetsBase) + role = fmt.Sprintf("%s/%s", CanonicalTargetsRole, role) + return role + } + for r, v := range ValidRoles { + if role == v { + return r + } + } + return "" +} + +// ValidRole only determines the name is semantically +// correct. For target delegated roles, it does NOT check +// the the appropriate parent roles exist. +func ValidRole(name string) bool { + name = strings.ToLower(name) + if v, ok := ValidRoles[name]; ok { + return name == v + } + targetsBase := fmt.Sprintf("%s/", ValidRoles[CanonicalTargetsRole]) + if strings.HasPrefix(name, targetsBase) { + return true + } + for _, v := range ValidRoles { + if name == v { + return true + } + } + return false +} + +type RootRole struct { + KeyIDs []string `json:"keyids"` + Threshold int `json:"threshold"` +} +type Role struct { + RootRole + Name string `json:"name"` + Paths []string `json:"paths,omitempty"` + PathHashPrefixes []string `json:"path_hash_prefixes,omitempty"` + Email string `json:"email,omitempty"` +} + +func NewRole(name string, threshold int, keyIDs, paths, pathHashPrefixes []string) (*Role, error) { + if len(paths) > 0 && len(pathHashPrefixes) > 0 { + return nil, errors.ErrInvalidRole{} + } + if threshold < 1 { + return nil, errors.ErrInvalidRole{} + } + if !ValidRole(name) { + return nil, errors.ErrInvalidRole{} + } + return &Role{ + RootRole: RootRole{ + KeyIDs: keyIDs, + Threshold: threshold, + }, + Name: name, + Paths: paths, + PathHashPrefixes: pathHashPrefixes, + }, nil + +} + +func (r Role) IsValid() bool { + return !(len(r.Paths) > 0 && len(r.PathHashPrefixes) > 0) +} + +func (r Role) ValidKey(id string) bool { + for _, key := range r.KeyIDs { + if key == id { + return true + } + } + return false +} + +func (r Role) CheckPaths(path string) bool { + for _, p := range r.Paths { + if strings.HasPrefix(path, p) { + return true + } + } + return false +} + +func (r Role) CheckPrefixes(hash string) bool { + for _, p := range r.PathHashPrefixes { + if strings.HasPrefix(hash, p) { + return true + } + } + return false +} + +func (r Role) IsDelegation() bool { + targetsBase := fmt.Sprintf("%s/", ValidRoles[CanonicalTargetsRole]) + return strings.HasPrefix(r.Name, targetsBase) +} diff --git a/vendor/src/github.com/endophage/gotuf/data/root.go b/vendor/src/github.com/endophage/gotuf/data/root.go new file mode 100644 index 0000000000..5730e9bf0c --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/root.go @@ -0,0 +1,89 @@ +package data + +import ( + "time" + + "github.com/jfrazelle/go/canonical/json" +) + +type SignedRoot struct { + Signatures []Signature + Signed Root + Dirty bool +} + +type Root struct { + Type string `json:"_type"` + Version int `json:"version"` + Expires time.Time `json:"expires"` + // These keys are public keys. We use TUFKey instead of PublicKey to + // support direct JSON unmarshaling. + Keys map[string]*TUFKey `json:"keys"` + Roles map[string]*RootRole `json:"roles"` + ConsistentSnapshot bool `json:"consistent_snapshot"` +} + +func NewRoot(keys map[string]PublicKey, roles map[string]*RootRole, consistent bool) (*SignedRoot, error) { + signedRoot := &SignedRoot{ + Signatures: make([]Signature, 0), + Signed: Root{ + Type: TUFTypes["root"], + Version: 0, + Expires: DefaultExpires("root"), + Keys: make(map[string]*TUFKey), + Roles: roles, + ConsistentSnapshot: consistent, + }, + Dirty: true, + } + + // Convert PublicKeys to TUFKey structures + // The Signed.Keys map needs to have *TUFKey values, since this + // structure gets directly unmarshalled from JSON, and it's not + // possible to unmarshal into an interface type. But this function + // takes a map with PublicKey values to avoid exposing this ugliness. + // The loop below converts to the TUFKey type. + for k, v := range keys { + signedRoot.Signed.Keys[k] = &TUFKey{ + Type: v.Algorithm(), + Value: KeyPair{ + Public: v.Public(), + Private: nil, + }, + } + } + + return signedRoot, nil +} + +func (r SignedRoot) ToSigned() (*Signed, error) { + s, err := json.MarshalCanonical(r.Signed) + if err != nil { + return nil, err + } + signed := json.RawMessage{} + err = signed.UnmarshalJSON(s) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(r.Signatures)) + copy(sigs, r.Signatures) + return &Signed{ + Signatures: sigs, + Signed: signed, + }, nil +} + +func RootFromSigned(s *Signed) (*SignedRoot, error) { + r := Root{} + err := json.Unmarshal(s.Signed, &r) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(s.Signatures)) + copy(sigs, s.Signatures) + return &SignedRoot{ + Signatures: sigs, + Signed: r, + }, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/data/snapshot.go b/vendor/src/github.com/endophage/gotuf/data/snapshot.go new file mode 100644 index 0000000000..5b61e46f49 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/snapshot.go @@ -0,0 +1,97 @@ +package data + +import ( + "bytes" + "time" + + "github.com/Sirupsen/logrus" + "github.com/jfrazelle/go/canonical/json" +) + +type SignedSnapshot struct { + Signatures []Signature + Signed Snapshot + Dirty bool +} + +type Snapshot struct { + Type string `json:"_type"` + Version int `json:"version"` + Expires time.Time `json:"expires"` + Meta Files `json:"meta"` +} + +func NewSnapshot(root *Signed, targets *Signed) (*SignedSnapshot, error) { + logrus.Debug("generating new snapshot...") + targetsJSON, err := json.Marshal(targets) + if err != nil { + logrus.Debug("Error Marshalling Targets") + return nil, err + } + rootJSON, err := json.Marshal(root) + if err != nil { + logrus.Debug("Error Marshalling Root") + return nil, err + } + rootMeta, err := NewFileMeta(bytes.NewReader(rootJSON), "sha256") + if err != nil { + return nil, err + } + targetsMeta, err := NewFileMeta(bytes.NewReader(targetsJSON), "sha256") + if err != nil { + return nil, err + } + return &SignedSnapshot{ + Signatures: make([]Signature, 0), + Signed: Snapshot{ + Type: TUFTypes["snapshot"], + Version: 0, + Expires: DefaultExpires("snapshot"), + Meta: Files{ + ValidRoles["root"]: rootMeta, + ValidRoles["targets"]: targetsMeta, + }, + }, + }, nil +} + +func (sp *SignedSnapshot) hashForRole(role string) []byte { + return sp.Signed.Meta[role].Hashes["sha256"] +} + +func (sp SignedSnapshot) ToSigned() (*Signed, error) { + s, err := json.MarshalCanonical(sp.Signed) + if err != nil { + return nil, err + } + signed := json.RawMessage{} + err = signed.UnmarshalJSON(s) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(sp.Signatures)) + copy(sigs, sp.Signatures) + return &Signed{ + Signatures: sigs, + Signed: signed, + }, nil +} + +func (sp *SignedSnapshot) AddMeta(role string, meta FileMeta) { + sp.Signed.Meta[role] = meta + sp.Dirty = true +} + +func SnapshotFromSigned(s *Signed) (*SignedSnapshot, error) { + sp := Snapshot{} + err := json.Unmarshal(s.Signed, &sp) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(s.Signatures)) + copy(sigs, s.Signatures) + return &SignedSnapshot{ + Signatures: sigs, + Signed: sp, + }, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/data/targets.go b/vendor/src/github.com/endophage/gotuf/data/targets.go new file mode 100644 index 0000000000..a51f60d208 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/targets.go @@ -0,0 +1,116 @@ +package data + +import ( + "crypto/sha256" + "encoding/hex" + + "github.com/jfrazelle/go/canonical/json" +) + +type SignedTargets struct { + Signatures []Signature + Signed Targets + Dirty bool +} + +type Targets struct { + SignedCommon + Targets Files `json:"targets"` + Delegations Delegations `json:"delegations,omitempty"` +} + +func NewTargets() *SignedTargets { + return &SignedTargets{ + Signatures: make([]Signature, 0), + Signed: Targets{ + SignedCommon: SignedCommon{ + Type: TUFTypes["targets"], + Version: 0, + Expires: DefaultExpires("targets"), + }, + Targets: make(Files), + Delegations: *NewDelegations(), + }, + Dirty: true, + } +} + +// GetMeta attempts to find the targets entry for the path. It +// will return nil in the case of the target not being found. +func (t SignedTargets) GetMeta(path string) *FileMeta { + for p, meta := range t.Signed.Targets { + if p == path { + return &meta + } + } + return nil +} + +// GetDelegations filters the roles and associated keys that may be +// the signers for the given target path. If no appropriate roles +// can be found, it will simply return nil for the return values. +// The returned slice of Role will have order maintained relative +// to the role slice on Delegations per TUF spec proposal on using +// order to determine priority. +func (t SignedTargets) GetDelegations(path string) []*Role { + roles := make([]*Role, 0) + pathHashBytes := sha256.Sum256([]byte(path)) + pathHash := hex.EncodeToString(pathHashBytes[:]) + for _, r := range t.Signed.Delegations.Roles { + if !r.IsValid() { + // Role has both Paths and PathHashPrefixes. + continue + } + if r.CheckPaths(path) { + roles = append(roles, r) + continue + } + if r.CheckPrefixes(pathHash) { + roles = append(roles, r) + continue + } + //keysDB.AddRole(r) + } + return roles +} + +func (t *SignedTargets) AddTarget(path string, meta FileMeta) { + t.Signed.Targets[path] = meta + t.Dirty = true +} + +func (t *SignedTargets) AddDelegation(role *Role, keys []*PublicKey) error { + return nil +} + +func (t SignedTargets) ToSigned() (*Signed, error) { + s, err := json.MarshalCanonical(t.Signed) + if err != nil { + return nil, err + } + signed := json.RawMessage{} + err = signed.UnmarshalJSON(s) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(t.Signatures)) + copy(sigs, t.Signatures) + return &Signed{ + Signatures: sigs, + Signed: signed, + }, nil +} + +func TargetsFromSigned(s *Signed) (*SignedTargets, error) { + t := Targets{} + err := json.Unmarshal(s.Signed, &t) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(s.Signatures)) + copy(sigs, s.Signatures) + return &SignedTargets{ + Signatures: sigs, + Signed: t, + }, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/data/timestamp.go b/vendor/src/github.com/endophage/gotuf/data/timestamp.go new file mode 100644 index 0000000000..e8a0de7cd2 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/timestamp.go @@ -0,0 +1,75 @@ +package data + +import ( + "bytes" + "time" + + "github.com/jfrazelle/go/canonical/json" +) + +type SignedTimestamp struct { + Signatures []Signature + Signed Timestamp + Dirty bool +} + +type Timestamp struct { + Type string `json:"_type"` + Version int `json:"version"` + Expires time.Time `json:"expires"` + Meta Files `json:"meta"` +} + +func NewTimestamp(snapshot *Signed) (*SignedTimestamp, error) { + snapshotJSON, err := json.Marshal(snapshot) + if err != nil { + return nil, err + } + snapshotMeta, err := NewFileMeta(bytes.NewReader(snapshotJSON), "sha256") + if err != nil { + return nil, err + } + return &SignedTimestamp{ + Signatures: make([]Signature, 0), + Signed: Timestamp{ + Type: TUFTypes["timestamp"], + Version: 0, + Expires: DefaultExpires("timestamp"), + Meta: Files{ + ValidRoles["snapshot"]: snapshotMeta, + }, + }, + }, nil +} + +func (ts SignedTimestamp) ToSigned() (*Signed, error) { + s, err := json.MarshalCanonical(ts.Signed) + if err != nil { + return nil, err + } + signed := json.RawMessage{} + err = signed.UnmarshalJSON(s) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(ts.Signatures)) + copy(sigs, ts.Signatures) + return &Signed{ + Signatures: sigs, + Signed: signed, + }, nil +} + +func TimestampFromSigned(s *Signed) (*SignedTimestamp, error) { + ts := Timestamp{} + err := json.Unmarshal(s.Signed, &ts) + if err != nil { + return nil, err + } + sigs := make([]Signature, len(s.Signatures)) + copy(sigs, s.Signatures) + return &SignedTimestamp{ + Signatures: sigs, + Signed: ts, + }, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/data/types.go b/vendor/src/github.com/endophage/gotuf/data/types.go new file mode 100644 index 0000000000..7cc84874d5 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/data/types.go @@ -0,0 +1,194 @@ +package data + +import ( + "crypto/sha256" + "crypto/sha512" + "fmt" + "hash" + "io" + "io/ioutil" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/jfrazelle/go/canonical/json" +) + +type KeyAlgorithm string + +func (k KeyAlgorithm) String() string { + return string(k) +} + +type SigAlgorithm string + +func (k SigAlgorithm) String() string { + return string(k) +} + +const ( + defaultHashAlgorithm = "sha256" + + EDDSASignature SigAlgorithm = "eddsa" + RSAPSSSignature SigAlgorithm = "rsapss" + RSAPKCS1v15Signature SigAlgorithm = "rsapkcs1v15" + ECDSASignature SigAlgorithm = "ecdsa" + PyCryptoSignature SigAlgorithm = "pycrypto-pkcs#1 pss" + + ED25519Key KeyAlgorithm = "ed25519" + RSAKey KeyAlgorithm = "rsa" + RSAx509Key KeyAlgorithm = "rsa-x509" + ECDSAKey KeyAlgorithm = "ecdsa" + ECDSAx509Key KeyAlgorithm = "ecdsa-x509" +) + +var TUFTypes = map[string]string{ + CanonicalRootRole: "Root", + CanonicalTargetsRole: "Targets", + CanonicalSnapshotRole: "Snapshot", + CanonicalTimestampRole: "Timestamp", +} + +// SetTUFTypes allows one to override some or all of the default +// type names in TUF. +func SetTUFTypes(ts map[string]string) { + for k, v := range ts { + TUFTypes[k] = v + } +} + +func ValidTUFType(typ, role string) bool { + if ValidRole(role) { + // All targets delegation roles must have + // the valid type is for targets. + role = CanonicalRole(role) + if role == "" { + // role is unknown and does not map to + // a type + return false + } + if strings.HasPrefix(role, CanonicalTargetsRole+"/") { + role = CanonicalTargetsRole + } + } + // most people will just use the defaults so have this optimal check + // first. Do comparison just in case there is some unknown vulnerability + // if a key and value in the map differ. + if v, ok := TUFTypes[role]; ok { + return typ == v + } + return false +} + +type Signed struct { + Signed json.RawMessage `json:"signed"` + Signatures []Signature `json:"signatures"` +} + +type SignedCommon struct { + Type string `json:"_type"` + Expires time.Time `json:"expires"` + Version int `json:"version"` +} + +type SignedMeta struct { + Signed SignedCommon `json:"signed"` + Signatures []Signature `json:"signatures"` +} + +type Signature struct { + KeyID string `json:"keyid"` + Method SigAlgorithm `json:"method"` + Signature []byte `json:"sig"` +} + +type Files map[string]FileMeta + +type Hashes map[string][]byte + +type FileMeta struct { + Length int64 `json:"length"` + Hashes Hashes `json:"hashes"` + Custom json.RawMessage `json:"custom,omitempty"` +} + +func NewFileMeta(r io.Reader, hashAlgorithms ...string) (FileMeta, error) { + if len(hashAlgorithms) == 0 { + hashAlgorithms = []string{defaultHashAlgorithm} + } + hashes := make(map[string]hash.Hash, len(hashAlgorithms)) + for _, hashAlgorithm := range hashAlgorithms { + var h hash.Hash + switch hashAlgorithm { + case "sha256": + h = sha256.New() + case "sha512": + h = sha512.New() + default: + return FileMeta{}, fmt.Errorf("Unknown Hash Algorithm: %s", hashAlgorithm) + } + hashes[hashAlgorithm] = h + r = io.TeeReader(r, h) + } + n, err := io.Copy(ioutil.Discard, r) + if err != nil { + return FileMeta{}, err + } + m := FileMeta{Length: n, Hashes: make(Hashes, len(hashes))} + for hashAlgorithm, h := range hashes { + m.Hashes[hashAlgorithm] = h.Sum(nil) + } + return m, nil +} + +type Delegations struct { + Keys map[string]PublicKey `json:"keys"` + Roles []*Role `json:"roles"` +} + +func NewDelegations() *Delegations { + return &Delegations{ + Keys: make(map[string]PublicKey), + Roles: make([]*Role, 0), + } +} + +// defines number of days in which something should expire +var defaultExpiryTimes = map[string]int{ + CanonicalRootRole: 365, + CanonicalTargetsRole: 90, + CanonicalSnapshotRole: 7, + CanonicalTimestampRole: 1, +} + +// SetDefaultExpiryTimes allows one to change the default expiries. +func SetDefaultExpiryTimes(times map[string]int) { + for key, value := range times { + if _, ok := defaultExpiryTimes[key]; !ok { + logrus.Errorf("Attempted to set default expiry for an unknown role: %s", key) + continue + } + defaultExpiryTimes[key] = value + } +} + +func DefaultExpires(role string) time.Time { + var t time.Time + if t, ok := defaultExpiryTimes[role]; ok { + return time.Now().AddDate(0, 0, t) + } + return t.UTC().Round(time.Second) +} + +type unmarshalledSignature Signature + +func (s *Signature) UnmarshalJSON(data []byte) error { + uSignature := unmarshalledSignature{} + err := json.Unmarshal(data, &uSignature) + if err != nil { + return err + } + uSignature.Method = SigAlgorithm(strings.ToLower(string(uSignature.Method))) + *s = Signature(uSignature) + return nil +} diff --git a/vendor/src/github.com/endophage/gotuf/errors/errors.go b/vendor/src/github.com/endophage/gotuf/errors/errors.go new file mode 100644 index 0000000000..b5bb40a7a8 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/errors/errors.go @@ -0,0 +1,85 @@ +package errors + +import ( + "errors" + "fmt" + "time" +) + +var ErrInitNotAllowed = errors.New("tuf: repository already initialized") + +type ErrMissingMetadata struct { + Name string +} + +func (e ErrMissingMetadata) Error() string { + return fmt.Sprintf("tuf: missing metadata %s", e.Name) +} + +type ErrFileNotFound struct { + Path string +} + +func (e ErrFileNotFound) Error() string { + return fmt.Sprintf("tuf: file not found %s", e.Path) +} + +type ErrInsufficientKeys struct { + Name string +} + +func (e ErrInsufficientKeys) Error() string { + return fmt.Sprintf("tuf: insufficient keys to sign %s", e.Name) +} + +type ErrInsufficientSignatures struct { + Name string + Err error +} + +func (e ErrInsufficientSignatures) Error() string { + return fmt.Sprintf("tuf: insufficient signatures for %s: %s", e.Name, e.Err) +} + +type ErrInvalidRole struct { + Role string +} + +func (e ErrInvalidRole) Error() string { + return fmt.Sprintf("tuf: invalid role %s", e.Role) +} + +type ErrInvalidExpires struct { + Expires time.Time +} + +func (e ErrInvalidExpires) Error() string { + return fmt.Sprintf("tuf: invalid expires: %s", e.Expires) +} + +type ErrKeyNotFound struct { + Role string + KeyID string +} + +func (e ErrKeyNotFound) Error() string { + return fmt.Sprintf(`tuf: no key with id "%s" exists for the %s role`, e.KeyID, e.Role) +} + +type ErrNotEnoughKeys struct { + Role string + Keys int + Threshold int +} + +func (e ErrNotEnoughKeys) Error() string { + return fmt.Sprintf("tuf: %s role has insufficient keys for threshold (has %d keys, threshold is %d)", e.Role, e.Keys, e.Threshold) +} + +type ErrPassphraseRequired struct { + Role string +} + +func (e ErrPassphraseRequired) Error() string { + return fmt.Sprintf("tuf: a passphrase is required to access the encrypted %s keys file", e.Role) +} diff --git a/vendor/src/github.com/endophage/gotuf/keys/db.go b/vendor/src/github.com/endophage/gotuf/keys/db.go new file mode 100644 index 0000000000..9ac5c96e84 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/keys/db.go @@ -0,0 +1,60 @@ +package keys + +import ( + "errors" + + "github.com/endophage/gotuf/data" +) + +var ( + ErrWrongType = errors.New("tuf: invalid key type") + ErrExists = errors.New("tuf: key already in db") + ErrWrongID = errors.New("tuf: key id mismatch") + ErrInvalidKey = errors.New("tuf: invalid key") + ErrInvalidRole = errors.New("tuf: invalid role") + ErrInvalidKeyID = errors.New("tuf: invalid key id") + ErrInvalidThreshold = errors.New("tuf: invalid role threshold") +) + +type KeyDB struct { + roles map[string]*data.Role + keys map[string]data.PublicKey +} + +func NewDB() *KeyDB { + return &KeyDB{ + roles: make(map[string]*data.Role), + keys: make(map[string]data.PublicKey), + } +} + +func (db *KeyDB) AddKey(k data.PublicKey) { + db.keys[k.ID()] = k +} + +func (db *KeyDB) AddRole(r *data.Role) error { + if !data.ValidRole(r.Name) { + return ErrInvalidRole + } + if r.Threshold < 1 { + return ErrInvalidThreshold + } + + // validate all key ids are in the keys maps + for _, id := range r.KeyIDs { + if _, ok := db.keys[id]; !ok { + return ErrInvalidKeyID + } + } + + db.roles[r.Name] = r + return nil +} + +func (db *KeyDB) GetKey(id string) data.PublicKey { + return db.keys[id] +} + +func (db *KeyDB) GetRole(name string) *data.Role { + return db.roles[name] +} diff --git a/vendor/src/github.com/endophage/gotuf/signed/ed25519.go b/vendor/src/github.com/endophage/gotuf/signed/ed25519.go new file mode 100644 index 0000000000..ca85748686 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/signed/ed25519.go @@ -0,0 +1,75 @@ +package signed + +import ( + "crypto/rand" + "errors" + + "github.com/agl/ed25519" + "github.com/endophage/gotuf/data" +) + +// Ed25519 implements a simple in memory cryptosystem for ED25519 keys +type Ed25519 struct { + keys map[string]data.PrivateKey +} + +func NewEd25519() *Ed25519 { + return &Ed25519{ + make(map[string]data.PrivateKey), + } +} + +// addKey allows you to add a private key +func (e *Ed25519) addKey(k data.PrivateKey) { + e.keys[k.ID()] = k +} + +func (e *Ed25519) RemoveKey(keyID string) error { + delete(e.keys, keyID) + return nil +} + +func (e *Ed25519) Sign(keyIDs []string, toSign []byte) ([]data.Signature, error) { + signatures := make([]data.Signature, 0, len(keyIDs)) + for _, kID := range keyIDs { + priv := [ed25519.PrivateKeySize]byte{} + copy(priv[:], e.keys[kID].Private()) + sig := ed25519.Sign(&priv, toSign) + signatures = append(signatures, data.Signature{ + KeyID: kID, + Method: data.EDDSASignature, + Signature: sig[:], + }) + } + return signatures, nil + +} + +func (e *Ed25519) Create(role string, algorithm data.KeyAlgorithm) (data.PublicKey, error) { + if algorithm != data.ED25519Key { + return nil, errors.New("only ED25519 supported by this cryptoservice") + } + + pub, priv, err := ed25519.GenerateKey(rand.Reader) + if err != nil { + return nil, err + } + public := data.NewPublicKey(data.ED25519Key, pub[:]) + private := data.NewPrivateKey(data.ED25519Key, pub[:], priv[:]) + e.addKey(private) + return public, nil +} + +func (e *Ed25519) PublicKeys(keyIDs ...string) (map[string]data.PublicKey, error) { + k := make(map[string]data.PublicKey) + for _, kID := range keyIDs { + if key, ok := e.keys[kID]; ok { + k[kID] = data.PublicKeyFromPrivate(key) + } + } + return k, nil +} + +func (e *Ed25519) GetKey(keyID string) data.PublicKey { + return data.PublicKeyFromPrivate(e.keys[keyID]) +} diff --git a/vendor/src/github.com/endophage/gotuf/signed/errors.go b/vendor/src/github.com/endophage/gotuf/signed/errors.go new file mode 100644 index 0000000000..09ecc9a719 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/signed/errors.go @@ -0,0 +1,43 @@ +package signed + +import ( + "fmt" +) + +type ErrExpired struct { + Role string + Expired string +} + +func (e ErrExpired) Error() string { + return fmt.Sprintf("%s expired at %v", e.Role, e.Expired) +} + +type ErrLowVersion struct { + Actual int + Current int +} + +func (e ErrLowVersion) Error() string { + return fmt.Sprintf("version %d is lower than current version %d", e.Actual, e.Current) +} + +type ErrRoleThreshold struct{} + +func (e ErrRoleThreshold) Error() string { + return "valid signatures did not meet threshold" +} + +type ErrInvalidKeyType struct{} + +func (e ErrInvalidKeyType) Error() string { + return "key type is not valid for signature" +} + +type ErrInvalidKeyLength struct { + msg string +} + +func (e ErrInvalidKeyLength) Error() string { + return fmt.Sprintf("key length is not supported: %s", e.msg) +} diff --git a/vendor/src/github.com/endophage/gotuf/signed/interface.go b/vendor/src/github.com/endophage/gotuf/signed/interface.go new file mode 100644 index 0000000000..7a46bdee26 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/signed/interface.go @@ -0,0 +1,44 @@ +package signed + +import ( + "github.com/endophage/gotuf/data" +) + +// SigningService defines the necessary functions to determine +// if a user is able to sign with a key, and to perform signing. +type SigningService interface { + // Sign takes a slice of keyIDs and a piece of data to sign + // and returns a slice of signatures and an error + Sign(keyIDs []string, data []byte) ([]data.Signature, error) +} + +// KeyService provides management of keys locally. It will never +// accept or provide private keys. Communication between the KeyService +// and a SigningService happen behind the Create function. +type KeyService interface { + // Create issues a new key pair and is responsible for loading + // the private key into the appropriate signing service. + // The role isn't currently used for anything, but it's here to support + // future features + Create(role string, algorithm data.KeyAlgorithm) (data.PublicKey, error) + + // GetKey retrieves the public key if present, otherwise it returns nil + GetKey(keyID string) data.PublicKey + + // RemoveKey deletes the specified key + RemoveKey(keyID string) error +} + +// CryptoService defines a unified Signing and Key Service as this +// will be most useful for most applications. +type CryptoService interface { + SigningService + KeyService +} + +// Verifier defines an interface for verfying signatures. An implementer +// of this interface should verify signatures for one and only one +// signing scheme. +type Verifier interface { + Verify(key data.PublicKey, sig []byte, msg []byte) error +} diff --git a/vendor/src/github.com/endophage/gotuf/signed/sign.go b/vendor/src/github.com/endophage/gotuf/signed/sign.go new file mode 100644 index 0000000000..8bab441009 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/signed/sign.go @@ -0,0 +1,43 @@ +package signed + +import ( + "fmt" + "github.com/Sirupsen/logrus" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/errors" + "strings" +) + +// Sign takes a data.Signed and a key, calculated and adds the signature +// to the data.Signed +func Sign(service CryptoService, s *data.Signed, keys ...data.PublicKey) error { + logrus.Debugf("sign called with %d keys", len(keys)) + signatures := make([]data.Signature, 0, len(s.Signatures)+1) + keyIDMemb := make(map[string]struct{}) + keyIDs := make([]string, 0, len(keys)) + + for _, key := range keys { + keyIDMemb[key.ID()] = struct{}{} + keyIDs = append(keyIDs, key.ID()) + } + logrus.Debugf("Generated list of signing IDs: %s", strings.Join(keyIDs, ", ")) + for _, sig := range s.Signatures { + if _, ok := keyIDMemb[sig.KeyID]; ok { + continue + } + signatures = append(signatures, sig) + } + newSigs, err := service.Sign(keyIDs, s.Signed) + if err != nil { + return err + } + if len(newSigs) < 1 { + return errors.ErrInsufficientSignatures{ + Name: fmt.Sprint("Cryptoservice failed to produce any signatures for keys with IDs: %s", strings.Join(keyIDs, ", ")), + Err: nil, + } + } + logrus.Debugf("appending %d new signatures", len(newSigs)) + s.Signatures = append(signatures, newSigs...) + return nil +} diff --git a/vendor/src/github.com/endophage/gotuf/signed/verifiers.go b/vendor/src/github.com/endophage/gotuf/signed/verifiers.go new file mode 100644 index 0000000000..e11eb4ad64 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/signed/verifiers.go @@ -0,0 +1,280 @@ +package signed + +import ( + "crypto" + "crypto/ecdsa" + "crypto/rsa" + "crypto/sha256" + "crypto/x509" + "encoding/pem" + "fmt" + "math/big" + "reflect" + + "github.com/Sirupsen/logrus" + "github.com/agl/ed25519" + "github.com/endophage/gotuf/data" +) + +const ( + minRSAKeySizeBit = 2048 // 2048 bits = 256 bytes + minRSAKeySizeByte = minRSAKeySizeBit / 8 +) + +// Verifiers serves as a map of all verifiers available on the system and +// can be injected into a verificationService. For testing and configuration +// purposes, it will not be used by default. +var Verifiers = map[data.SigAlgorithm]Verifier{ + data.RSAPSSSignature: RSAPSSVerifier{}, + data.RSAPKCS1v15Signature: RSAPKCS1v15Verifier{}, + data.PyCryptoSignature: RSAPyCryptoVerifier{}, + data.ECDSASignature: ECDSAVerifier{}, + data.EDDSASignature: Ed25519Verifier{}, +} + +// RegisterVerifier provides a convenience function for init() functions +// to register additional verifiers or replace existing ones. +func RegisterVerifier(algorithm data.SigAlgorithm, v Verifier) { + curr, ok := Verifiers[algorithm] + if ok { + typOld := reflect.TypeOf(curr) + typNew := reflect.TypeOf(v) + logrus.Debugf( + "replacing already loaded verifier %s:%s with %s:%s", + typOld.PkgPath(), typOld.Name(), + typNew.PkgPath(), typNew.Name(), + ) + } else { + logrus.Debug("adding verifier for: ", algorithm) + } + Verifiers[algorithm] = v +} + +type Ed25519Verifier struct{} + +func (v Ed25519Verifier) Verify(key data.PublicKey, sig []byte, msg []byte) error { + if key.Algorithm() != data.ED25519Key { + return ErrInvalidKeyType{} + } + var sigBytes [ed25519.SignatureSize]byte + if len(sig) != ed25519.SignatureSize { + logrus.Infof("signature length is incorrect, must be %d, was %d.", ed25519.SignatureSize, len(sig)) + return ErrInvalid + } + copy(sigBytes[:], sig) + + var keyBytes [ed25519.PublicKeySize]byte + pub := key.Public() + if len(pub) != ed25519.PublicKeySize { + logrus.Errorf("public key is incorrect size, must be %d, was %d.", ed25519.PublicKeySize, len(pub)) + return ErrInvalidKeyLength{msg: fmt.Sprintf("ed25519 public key must be %d bytes.", ed25519.PublicKeySize)} + } + n := copy(keyBytes[:], key.Public()) + if n < ed25519.PublicKeySize { + logrus.Errorf("failed to copy the key, must have %d bytes, copied %d bytes.", ed25519.PublicKeySize, n) + return ErrInvalid + } + + if !ed25519.Verify(&keyBytes, msg, &sigBytes) { + logrus.Infof("failed ed25519 verification") + return ErrInvalid + } + return nil +} + +func verifyPSS(key interface{}, digest, sig []byte) error { + rsaPub, ok := key.(*rsa.PublicKey) + if !ok { + logrus.Infof("value was not an RSA public key") + return ErrInvalid + } + + if rsaPub.N.BitLen() < minRSAKeySizeBit { + logrus.Infof("RSA keys less than 2048 bits are not acceptable, provided key has length %d.", rsaPub.N.BitLen()) + return ErrInvalidKeyLength{msg: fmt.Sprintf("RSA key must be at least %d bits.", minRSAKeySizeBit)} + } + + if len(sig) < minRSAKeySizeByte { + logrus.Infof("RSA keys less than 2048 bits are not acceptable, provided signature has length %d.", len(sig)) + return ErrInvalid + } + + opts := rsa.PSSOptions{SaltLength: sha256.Size, Hash: crypto.SHA256} + if err := rsa.VerifyPSS(rsaPub, crypto.SHA256, digest[:], sig, &opts); err != nil { + logrus.Infof("failed RSAPSS verification: %s", err) + return ErrInvalid + } + return nil +} + +func getRSAPubKey(key data.PublicKey) (crypto.PublicKey, error) { + algorithm := key.Algorithm() + var pubKey crypto.PublicKey + + switch algorithm { + case data.RSAx509Key: + pemCert, _ := pem.Decode([]byte(key.Public())) + if pemCert == nil { + logrus.Infof("failed to decode PEM-encoded x509 certificate") + return nil, ErrInvalid + } + cert, err := x509.ParseCertificate(pemCert.Bytes) + if err != nil { + logrus.Infof("failed to parse x509 certificate: %s\n", err) + return nil, ErrInvalid + } + pubKey = cert.PublicKey + case data.RSAKey: + var err error + pubKey, err = x509.ParsePKIXPublicKey(key.Public()) + if err != nil { + logrus.Infof("failed to parse public key: %s\n", err) + return nil, ErrInvalid + } + default: + // only accept RSA keys + logrus.Infof("invalid key type for RSAPSS verifier: %s", algorithm) + return nil, ErrInvalidKeyType{} + } + + return pubKey, nil +} + +// RSAPSSVerifier checks RSASSA-PSS signatures +type RSAPSSVerifier struct{} + +// Verify does the actual check. +func (v RSAPSSVerifier) Verify(key data.PublicKey, sig []byte, msg []byte) error { + // will return err if keytype is not a recognized RSA type + pubKey, err := getRSAPubKey(key) + if err != nil { + return err + } + + digest := sha256.Sum256(msg) + + return verifyPSS(pubKey, digest[:], sig) +} + +// RSAPKCS1v15SVerifier checks RSA PKCS1v15 signatures +type RSAPKCS1v15Verifier struct{} + +func (v RSAPKCS1v15Verifier) Verify(key data.PublicKey, sig []byte, msg []byte) error { + // will return err if keytype is not a recognized RSA type + pubKey, err := getRSAPubKey(key) + if err != nil { + return err + } + digest := sha256.Sum256(msg) + + rsaPub, ok := pubKey.(*rsa.PublicKey) + if !ok { + logrus.Infof("value was not an RSA public key") + return ErrInvalid + } + + if rsaPub.N.BitLen() < minRSAKeySizeBit { + logrus.Infof("RSA keys less than 2048 bits are not acceptable, provided key has length %d.", rsaPub.N.BitLen()) + return ErrInvalidKeyLength{msg: fmt.Sprintf("RSA key must be at least %d bits.", minRSAKeySizeBit)} + } + + if len(sig) < minRSAKeySizeByte { + logrus.Infof("RSA keys less than 2048 bits are not acceptable, provided signature has length %d.", len(sig)) + return ErrInvalid + } + + if err = rsa.VerifyPKCS1v15(rsaPub, crypto.SHA256, digest[:], sig); err != nil { + logrus.Errorf("Failed verification: %s", err.Error()) + return ErrInvalid + } + return nil +} + +// RSAPSSVerifier checks RSASSA-PSS signatures +type RSAPyCryptoVerifier struct{} + +// Verify does the actual check. +// N.B. We have not been able to make this work in a way that is compatible +// with PyCrypto. +func (v RSAPyCryptoVerifier) Verify(key data.PublicKey, sig []byte, msg []byte) error { + digest := sha256.Sum256(msg) + if key.Algorithm() != data.RSAKey { + return ErrInvalidKeyType{} + } + + k, _ := pem.Decode([]byte(key.Public())) + if k == nil { + logrus.Infof("failed to decode PEM-encoded x509 certificate") + return ErrInvalid + } + + pub, err := x509.ParsePKIXPublicKey(k.Bytes) + if err != nil { + logrus.Infof("failed to parse public key: %s\n", err) + return ErrInvalid + } + + return verifyPSS(pub, digest[:], sig) +} + +// ECDSAVerifier checks ECDSA signatures, decoding the keyType appropriately +type ECDSAVerifier struct{} + +// Verify does the actual check. +func (v ECDSAVerifier) Verify(key data.PublicKey, sig []byte, msg []byte) error { + algorithm := key.Algorithm() + var pubKey crypto.PublicKey + + switch algorithm { + case data.ECDSAx509Key: + pemCert, _ := pem.Decode([]byte(key.Public())) + if pemCert == nil { + logrus.Infof("failed to decode PEM-encoded x509 certificate for keyID: %s", key.ID()) + logrus.Debugf("certificate bytes: %s", string(key.Public())) + return ErrInvalid + } + cert, err := x509.ParseCertificate(pemCert.Bytes) + if err != nil { + logrus.Infof("failed to parse x509 certificate: %s\n", err) + return ErrInvalid + } + pubKey = cert.PublicKey + case data.ECDSAKey: + var err error + pubKey, err = x509.ParsePKIXPublicKey(key.Public()) + if err != nil { + logrus.Infof("Failed to parse private key for keyID: %s, %s\n", key.ID(), err) + return ErrInvalid + } + default: + // only accept ECDSA keys. + logrus.Infof("invalid key type for ECDSA verifier: %s", algorithm) + return ErrInvalidKeyType{} + } + + ecdsaPubKey, ok := pubKey.(*ecdsa.PublicKey) + if !ok { + logrus.Infof("value isn't an ECDSA public key") + return ErrInvalid + } + + sigLength := len(sig) + expectedOctetLength := 2 * ((ecdsaPubKey.Params().BitSize + 7) >> 3) + if sigLength != expectedOctetLength { + logrus.Infof("signature had an unexpected length") + return ErrInvalid + } + + rBytes, sBytes := sig[:sigLength/2], sig[sigLength/2:] + r := new(big.Int).SetBytes(rBytes) + s := new(big.Int).SetBytes(sBytes) + + digest := sha256.Sum256(msg) + + if !ecdsa.Verify(ecdsaPubKey, digest[:], r, s) { + logrus.Infof("failed ECDSA signature validation") + return ErrInvalid + } + + return nil +} diff --git a/vendor/src/github.com/endophage/gotuf/signed/verify.go b/vendor/src/github.com/endophage/gotuf/signed/verify.go new file mode 100644 index 0000000000..b1ef6a3aea --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/signed/verify.go @@ -0,0 +1,172 @@ +package signed + +import ( + "errors" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/keys" + "github.com/jfrazelle/go/canonical/json" +) + +var ( + ErrMissingKey = errors.New("tuf: missing key") + ErrNoSignatures = errors.New("tuf: data has no signatures") + ErrInvalid = errors.New("tuf: signature verification failed") + ErrWrongMethod = errors.New("tuf: invalid signature type") + ErrUnknownRole = errors.New("tuf: unknown role") + ErrWrongType = errors.New("tuf: meta file has wrong type") +) + +// VerifyRoot checks if a given root file is valid against a known set of keys. +// Threshold is always assumed to be 1 +func VerifyRoot(s *data.Signed, minVersion int, keys map[string]data.PublicKey) error { + if len(s.Signatures) == 0 { + return ErrNoSignatures + } + + var decoded map[string]interface{} + if err := json.Unmarshal(s.Signed, &decoded); err != nil { + return err + } + msg, err := json.MarshalCanonical(decoded) + if err != nil { + return err + } + + for _, sig := range s.Signatures { + // method lookup is consistent due to Unmarshal JSON doing lower case for us. + method := sig.Method + verifier, ok := Verifiers[method] + if !ok { + logrus.Debugf("continuing b/c signing method is not supported for verify root: %s\n", sig.Method) + continue + } + + key, ok := keys[sig.KeyID] + if !ok { + logrus.Debugf("continuing b/c signing key isn't present in keys: %s\n", sig.KeyID) + continue + } + + if err := verifier.Verify(key, sig.Signature, msg); err != nil { + logrus.Debugf("continuing b/c signature was invalid\n") + continue + } + // threshold of 1 so return on first success + return verifyMeta(s, "root", minVersion) + } + return ErrRoleThreshold{} +} + +func Verify(s *data.Signed, role string, minVersion int, db *keys.KeyDB) error { + if err := VerifySignatures(s, role, db); err != nil { + return err + } + return verifyMeta(s, role, minVersion) +} + +func verifyMeta(s *data.Signed, role string, minVersion int) error { + sm := &data.SignedCommon{} + if err := json.Unmarshal(s.Signed, sm); err != nil { + return err + } + if !data.ValidTUFType(sm.Type, role) { + return ErrWrongType + } + if IsExpired(sm.Expires) { + logrus.Errorf("Metadata for %s expired", role) + return ErrExpired{Role: role, Expired: sm.Expires.Format("Mon Jan 2 15:04:05 MST 2006")} + } + if sm.Version < minVersion { + return ErrLowVersion{sm.Version, minVersion} + } + + return nil +} + +var IsExpired = func(t time.Time) bool { + return t.Before(time.Now()) +} + +func VerifySignatures(s *data.Signed, role string, db *keys.KeyDB) error { + if len(s.Signatures) == 0 { + return ErrNoSignatures + } + + roleData := db.GetRole(role) + if roleData == nil { + return ErrUnknownRole + } + + if roleData.Threshold < 1 { + return ErrRoleThreshold{} + } + logrus.Debugf("%s role has key IDs: %s", role, strings.Join(roleData.KeyIDs, ",")) + + var decoded map[string]interface{} + if err := json.Unmarshal(s.Signed, &decoded); err != nil { + return err + } + msg, err := json.MarshalCanonical(decoded) + if err != nil { + return err + } + + valid := make(map[string]struct{}) + for _, sig := range s.Signatures { + logrus.Debug("verifying signature for key ID: ", sig.KeyID) + if !roleData.ValidKey(sig.KeyID) { + logrus.Debugf("continuing b/c keyid was invalid: %s for roledata %s\n", sig.KeyID, roleData) + continue + } + key := db.GetKey(sig.KeyID) + if key == nil { + logrus.Debugf("continuing b/c keyid lookup was nil: %s\n", sig.KeyID) + continue + } + // method lookup is consistent due to Unmarshal JSON doing lower case for us. + method := sig.Method + verifier, ok := Verifiers[method] + if !ok { + logrus.Debugf("continuing b/c signing method is not supported: %s\n", sig.Method) + continue + } + + if err := verifier.Verify(key, sig.Signature, msg); err != nil { + logrus.Debugf("continuing b/c signature was invalid\n") + continue + } + valid[sig.KeyID] = struct{}{} + + } + if len(valid) < roleData.Threshold { + return ErrRoleThreshold{} + } + + return nil +} + +func Unmarshal(b []byte, v interface{}, role string, minVersion int, db *keys.KeyDB) error { + s := &data.Signed{} + if err := json.Unmarshal(b, s); err != nil { + return err + } + if err := Verify(s, role, minVersion, db); err != nil { + return err + } + return json.Unmarshal(s.Signed, v) +} + +func UnmarshalTrusted(b []byte, v interface{}, role string, db *keys.KeyDB) error { + s := &data.Signed{} + if err := json.Unmarshal(b, s); err != nil { + return err + } + if err := VerifySignatures(s, role, db); err != nil { + return err + } + return json.Unmarshal(s.Signed, v) +} diff --git a/vendor/src/github.com/endophage/gotuf/store/dbstore.go b/vendor/src/github.com/endophage/gotuf/store/dbstore.go new file mode 100644 index 0000000000..8d65d0db21 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/store/dbstore.go @@ -0,0 +1,252 @@ +package store + +import ( + "database/sql" + "encoding/hex" + "fmt" + "io/ioutil" + "os" + "path" + + logrus "github.com/Sirupsen/logrus" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/utils" + "github.com/jfrazelle/go/canonical/json" +) + +const ( + tufLoc string = "/tmp/tuf" + metadataSubDir string = "metadata" +) + +// implements LocalStore +type dbStore struct { + db sql.DB + imageName string +} + +// DBStore takes a database connection and the QDN of the image +func DBStore(db *sql.DB, imageName string) *dbStore { + store := dbStore{ + db: *db, + imageName: imageName, + } + + return &store +} + +// GetMeta loads existing TUF metadata files +func (dbs *dbStore) GetMeta(name string) ([]byte, error) { + data, err := dbs.readFile(name) + if err != nil { + return nil, err + } + return data, err +} + +// SetMeta writes individual TUF metadata files +func (dbs *dbStore) SetMeta(name string, meta []byte) error { + return dbs.writeFile(name, meta) +} + +// WalkStagedTargets walks all targets in scope +func (dbs *dbStore) WalkStagedTargets(paths []string, targetsFn targetsWalkFunc) error { + if len(paths) == 0 { + files := dbs.loadTargets("") + for path, meta := range files { + if err := targetsFn(path, meta); err != nil { + return err + } + } + return nil + } + + for _, path := range paths { + files := dbs.loadTargets(path) + meta, ok := files[path] + if !ok { + return fmt.Errorf("File Not Found") + } + if err := targetsFn(path, meta); err != nil { + return err + } + } + return nil +} + +// Commit writes a set of consistent (possibly) TUF metadata files +func (dbs *dbStore) Commit(metafiles map[string][]byte, consistent bool, hashes map[string]data.Hashes) error { + // TODO (endophage): write meta files to cache + return nil + +} + +// GetKeys returns private keys +func (dbs *dbStore) GetKeys(role string) ([]data.PrivateKey, error) { + keys := []data.PrivateKey{} + var r *sql.Rows + var err error + sql := "SELECT `key` FROM `keys` WHERE `role` = ? AND `namespace` = ?;" + tx, err := dbs.db.Begin() + defer tx.Rollback() + r, err = tx.Query(sql, role, dbs.imageName) + if err != nil { + return nil, err + } + defer r.Close() + for r.Next() { + var jsonStr string + key := new(data.TUFKey) + r.Scan(&jsonStr) + err := json.Unmarshal([]byte(jsonStr), key) + if err != nil { + return nil, err + } + keys = append(keys, key) + } + return keys, nil +} + +// SaveKey saves a new private key +func (dbs *dbStore) SaveKey(role string, key data.PrivateKey) error { + jsonBytes, err := json.Marshal(key) + if err != nil { + return fmt.Errorf("Could not JSON Marshal Key") + } + tx, err := dbs.db.Begin() + if err != nil { + logrus.Error(err) + return err + } + _, err = tx.Exec("INSERT INTO `keys` (`namespace`, `role`, `key`) VALUES (?,?,?);", dbs.imageName, role, string(jsonBytes)) + tx.Commit() + return err +} + +// Clean removes staged targets +func (dbs *dbStore) Clean() error { + // TODO (endophage): purge stale items from db? May just/also need a remove method + return nil +} + +// AddBlob adds an object to the store +func (dbs *dbStore) AddBlob(path string, meta data.FileMeta) { + path = utils.NormalizeTarget(path) + jsonbytes := []byte{} + if meta.Custom != nil { + jsonbytes, _ = meta.Custom.MarshalJSON() + } + + tx, err := dbs.db.Begin() + if err != nil { + logrus.Error(err) + return + } + _, err = tx.Exec("INSERT OR REPLACE INTO `filemeta` VALUES (?,?,?,?);", dbs.imageName, path, meta.Length, jsonbytes) + if err != nil { + logrus.Error(err) + } + tx.Commit() + dbs.addBlobHashes(path, meta.Hashes) +} + +func (dbs *dbStore) addBlobHashes(path string, hashes data.Hashes) { + tx, err := dbs.db.Begin() + if err != nil { + logrus.Error(err) + } + for alg, hash := range hashes { + _, err := tx.Exec("INSERT OR REPLACE INTO `filehashes` VALUES (?,?,?,?);", dbs.imageName, path, alg, hex.EncodeToString(hash)) + if err != nil { + logrus.Error(err) + } + } + tx.Commit() +} + +// RemoveBlob removes an object from the store +func (dbs *dbStore) RemoveBlob(path string) error { + tx, err := dbs.db.Begin() + if err != nil { + logrus.Error(err) + return err + } + _, err = tx.Exec("DELETE FROM `filemeta` WHERE `path`=? AND `namespace`=?", path, dbs.imageName) + if err == nil { + tx.Commit() + } else { + tx.Rollback() + } + return err +} + +func (dbs *dbStore) loadTargets(path string) map[string]data.FileMeta { + var err error + var r *sql.Rows + tx, err := dbs.db.Begin() + defer tx.Rollback() + files := make(map[string]data.FileMeta) + sql := "SELECT `filemeta`.`path`, `size`, `alg`, `hash`, `custom` FROM `filemeta` JOIN `filehashes` ON `filemeta`.`path` = `filehashes`.`path` AND `filemeta`.`namespace` = `filehashes`.`namespace` WHERE `filemeta`.`namespace`=?" + if path != "" { + sql = fmt.Sprintf("%s %s", sql, "AND `filemeta`.`path`=?") + r, err = tx.Query(sql, dbs.imageName, path) + } else { + r, err = tx.Query(sql, dbs.imageName) + } + if err != nil { + return files + } + defer r.Close() + for r.Next() { + var absPath, alg, hash string + var size int64 + var custom []byte + r.Scan(&absPath, &size, &alg, &hash, &custom) + hashBytes, err := hex.DecodeString(hash) + if err != nil { + // We're going to skip items with unparseable hashes as they + // won't be valid in the targets + logrus.Debug("Hash was not stored in hex as expected") + continue + } + if file, ok := files[absPath]; ok { + file.Hashes[alg] = hashBytes + } else { + file = data.FileMeta{ + Length: size, + Hashes: data.Hashes{ + alg: hashBytes, + }, + } + if custom != nil { + file.Custom = json.RawMessage(custom) + } + files[absPath] = file + } + } + return files +} + +func (dbs *dbStore) writeFile(name string, content []byte) error { + jsonName := fmt.Sprintf("%s.json", name) + fullPath := path.Join(tufLoc, metadataSubDir, dbs.imageName, jsonName) + dirPath := path.Dir(fullPath) + err := os.MkdirAll(dirPath, 0744) + if err != nil { + logrus.Error("error creating directory path to TUF cache") + return err + } + + err = ioutil.WriteFile(fullPath, content, 0744) + if err != nil { + logrus.Error("Error writing file") + } + return err +} + +func (dbs *dbStore) readFile(name string) ([]byte, error) { + jsonName := fmt.Sprintf("%s.json", name) + fullPath := path.Join(tufLoc, metadataSubDir, dbs.imageName, jsonName) + content, err := ioutil.ReadFile(fullPath) + return content, err +} diff --git a/vendor/src/github.com/endophage/gotuf/store/errors.go b/vendor/src/github.com/endophage/gotuf/store/errors.go new file mode 100644 index 0000000000..0bc8272f96 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/store/errors.go @@ -0,0 +1,7 @@ +package store + +type ErrMetaNotFound struct{} + +func (err ErrMetaNotFound) Error() string { + return "no trust data available" +} diff --git a/vendor/src/github.com/endophage/gotuf/store/filestore.go b/vendor/src/github.com/endophage/gotuf/store/filestore.go new file mode 100644 index 0000000000..2ebd9b5bf6 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/store/filestore.go @@ -0,0 +1,67 @@ +package store + +import ( + "fmt" + "io/ioutil" + "os" + "path" + "path/filepath" +) + +func NewFilesystemStore(baseDir, metaSubDir, metaExtension, targetsSubDir string) (*filesystemStore, error) { + metaDir := path.Join(baseDir, metaSubDir) + targetsDir := path.Join(baseDir, targetsSubDir) + + // Make sure we can create the necessary dirs and they are writable + err := os.MkdirAll(metaDir, 0700) + if err != nil { + return nil, err + } + err = os.MkdirAll(targetsDir, 0700) + if err != nil { + return nil, err + } + + return &filesystemStore{ + baseDir: baseDir, + metaDir: metaDir, + metaExtension: metaExtension, + targetsDir: targetsDir, + }, nil +} + +type filesystemStore struct { + baseDir string + metaDir string + metaExtension string + targetsDir string +} + +func (f *filesystemStore) GetMeta(name string, size int64) ([]byte, error) { + fileName := fmt.Sprintf("%s.%s", name, f.metaExtension) + path := filepath.Join(f.metaDir, fileName) + meta, err := ioutil.ReadFile(path) + if err != nil { + return nil, err + } + return meta, nil +} + +func (f *filesystemStore) SetMultiMeta(metas map[string][]byte) error { + for role, blob := range metas { + err := f.SetMeta(role, blob) + if err != nil { + return err + } + } + return nil +} + +func (f *filesystemStore) SetMeta(name string, meta []byte) error { + fileName := fmt.Sprintf("%s.%s", name, f.metaExtension) + path := filepath.Join(f.metaDir, fileName) + if err := ioutil.WriteFile(path, meta, 0600); err != nil { + return err + } + return nil +} diff --git a/vendor/src/github.com/endophage/gotuf/store/httpstore.go b/vendor/src/github.com/endophage/gotuf/store/httpstore.go new file mode 100644 index 0000000000..6b69683a8e --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/store/httpstore.go @@ -0,0 +1,243 @@ +package store + +import ( + "bytes" + "errors" + "fmt" + "io" + "io/ioutil" + "mime/multipart" + "net/http" + "net/url" + "path" + + "github.com/Sirupsen/logrus" +) + +type ErrServerUnavailable struct { + code int +} + +func (err ErrServerUnavailable) Error() string { + return fmt.Sprintf("Unable to reach trust server at this time: %d.", err.code) +} + +type ErrShortRead struct{} + +func (err ErrShortRead) Error() string { + return "Trust server returned incompelete response." +} + +type ErrMaliciousServer struct{} + +func (err ErrMaliciousServer) Error() string { + return "Trust server returned a bad response." +} + +// HTTPStore manages pulling and pushing metadata from and to a remote +// service over HTTP. It assumes the URL structure of the remote service +// maps identically to the structure of the TUF repo: +// //(root|targets|snapshot|timestamp).json +// //foo.sh +// +// If consistent snapshots are disabled, it is advised that caching is not +// enabled. Simple set a cachePath (and ensure it's writeable) to enable +// caching. +type HTTPStore struct { + baseURL url.URL + metaPrefix string + metaExtension string + targetsPrefix string + keyExtension string + roundTrip http.RoundTripper +} + +func NewHTTPStore(baseURL, metaPrefix, metaExtension, targetsPrefix, keyExtension string, roundTrip http.RoundTripper) (*HTTPStore, error) { + base, err := url.Parse(baseURL) + if err != nil { + return nil, err + } + if !base.IsAbs() { + return nil, errors.New("HTTPStore requires an absolute baseURL") + } + return &HTTPStore{ + baseURL: *base, + metaPrefix: metaPrefix, + metaExtension: metaExtension, + targetsPrefix: targetsPrefix, + keyExtension: keyExtension, + roundTrip: roundTrip, + }, nil +} + +// GetMeta downloads the named meta file with the given size. A short body +// is acceptable because in the case of timestamp.json, the size is a cap, +// not an exact length. +func (s HTTPStore) GetMeta(name string, size int64) ([]byte, error) { + url, err := s.buildMetaURL(name) + if err != nil { + return nil, err + } + req, err := http.NewRequest("GET", url.String(), nil) + if err != nil { + return nil, err + } + resp, err := s.roundTrip.RoundTrip(req) + if err != nil { + return nil, err + } + defer resp.Body.Close() + if resp.StatusCode == http.StatusNotFound { + return nil, ErrMetaNotFound{} + } else if resp.StatusCode != http.StatusOK { + logrus.Debugf("received HTTP status %d when requesting %s.", resp.StatusCode, name) + return nil, ErrServerUnavailable{code: resp.StatusCode} + } + if resp.ContentLength > size { + return nil, ErrMaliciousServer{} + } + logrus.Debugf("%d when retrieving metadata for %s", resp.StatusCode, name) + b := io.LimitReader(resp.Body, size) + body, err := ioutil.ReadAll(b) + if err != nil { + return nil, err + } + return body, nil +} + +func (s HTTPStore) SetMeta(name string, blob []byte) error { + url, err := s.buildMetaURL("") + if err != nil { + return err + } + req, err := http.NewRequest("POST", url.String(), bytes.NewReader(blob)) + if err != nil { + return err + } + resp, err := s.roundTrip.RoundTrip(req) + if err != nil { + return err + } + defer resp.Body.Close() + if resp.StatusCode == http.StatusNotFound { + return ErrMetaNotFound{} + } else if resp.StatusCode != http.StatusOK { + return ErrServerUnavailable{code: resp.StatusCode} + } + return nil +} + +func (s HTTPStore) SetMultiMeta(metas map[string][]byte) error { + url, err := s.buildMetaURL("") + if err != nil { + return err + } + body := &bytes.Buffer{} + writer := multipart.NewWriter(body) + for role, blob := range metas { + part, err := writer.CreateFormFile("files", role) + _, err = io.Copy(part, bytes.NewBuffer(blob)) + if err != nil { + return err + } + } + err = writer.Close() + if err != nil { + return err + } + req, err := http.NewRequest("POST", url.String(), body) + req.Header.Set("Content-Type", writer.FormDataContentType()) + if err != nil { + return err + } + resp, err := s.roundTrip.RoundTrip(req) + if err != nil { + return err + } + defer resp.Body.Close() + if resp.StatusCode == http.StatusNotFound { + return ErrMetaNotFound{} + } else if resp.StatusCode != http.StatusOK { + return ErrServerUnavailable{code: resp.StatusCode} + } + return nil +} + +func (s HTTPStore) buildMetaURL(name string) (*url.URL, error) { + var filename string + if name != "" { + filename = fmt.Sprintf("%s.%s", name, s.metaExtension) + } + uri := path.Join(s.metaPrefix, filename) + return s.buildURL(uri) +} + +func (s HTTPStore) buildTargetsURL(name string) (*url.URL, error) { + uri := path.Join(s.targetsPrefix, name) + return s.buildURL(uri) +} + +func (s HTTPStore) buildKeyURL(name string) (*url.URL, error) { + filename := fmt.Sprintf("%s.%s", name, s.keyExtension) + uri := path.Join(s.metaPrefix, filename) + return s.buildURL(uri) +} + +func (s HTTPStore) buildURL(uri string) (*url.URL, error) { + sub, err := url.Parse(uri) + if err != nil { + return nil, err + } + return s.baseURL.ResolveReference(sub), nil +} + +// GetTarget returns a reader for the desired target or an error. +// N.B. The caller is responsible for closing the reader. +func (s HTTPStore) GetTarget(path string) (io.ReadCloser, error) { + url, err := s.buildTargetsURL(path) + if err != nil { + return nil, err + } + logrus.Debug("Attempting to download target: ", url.String()) + req, err := http.NewRequest("GET", url.String(), nil) + if err != nil { + return nil, err + } + resp, err := s.roundTrip.RoundTrip(req) + if err != nil { + return nil, err + } + defer resp.Body.Close() + if resp.StatusCode == http.StatusNotFound { + return nil, ErrMetaNotFound{} + } else if resp.StatusCode != http.StatusOK { + return nil, ErrServerUnavailable{code: resp.StatusCode} + } + return resp.Body, nil +} + +func (s HTTPStore) GetKey(role string) ([]byte, error) { + url, err := s.buildKeyURL(role) + if err != nil { + return nil, err + } + req, err := http.NewRequest("GET", url.String(), nil) + if err != nil { + return nil, err + } + resp, err := s.roundTrip.RoundTrip(req) + if err != nil { + return nil, err + } + defer resp.Body.Close() + if resp.StatusCode == http.StatusNotFound { + return nil, ErrMetaNotFound{} + } else if resp.StatusCode != http.StatusOK { + return nil, ErrServerUnavailable{code: resp.StatusCode} + } + body, err := ioutil.ReadAll(resp.Body) + if err != nil { + return nil, err + } + return body, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/store/interfaces.go b/vendor/src/github.com/endophage/gotuf/store/interfaces.go new file mode 100644 index 0000000000..093f3851b3 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/store/interfaces.go @@ -0,0 +1,35 @@ +package store + +import ( + "io" + + "github.com/endophage/gotuf/data" +) + +type targetsWalkFunc func(path string, meta data.FileMeta) error + +type MetadataStore interface { + GetMeta(name string, size int64) ([]byte, error) + SetMeta(name string, blob []byte) error + SetMultiMeta(map[string][]byte) error +} + +type PublicKeyStore interface { + GetKey(role string) ([]byte, error) +} + +// [endophage] I'm of the opinion this should go away. +type TargetStore interface { + WalkStagedTargets(paths []string, targetsFn targetsWalkFunc) error +} + +type LocalStore interface { + MetadataStore + TargetStore +} + +type RemoteStore interface { + MetadataStore + PublicKeyStore + GetTarget(path string) (io.ReadCloser, error) +} diff --git a/vendor/src/github.com/endophage/gotuf/store/memorystore.go b/vendor/src/github.com/endophage/gotuf/store/memorystore.go new file mode 100644 index 0000000000..3baa576a56 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/store/memorystore.go @@ -0,0 +1,97 @@ +package store + +import ( + "bytes" + "fmt" + "io" + + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/errors" + "github.com/endophage/gotuf/utils" +) + +func NewMemoryStore(meta map[string][]byte, files map[string][]byte) *memoryStore { + if meta == nil { + meta = make(map[string][]byte) + } + if files == nil { + files = make(map[string][]byte) + } + return &memoryStore{ + meta: meta, + files: files, + keys: make(map[string][]data.PrivateKey), + } +} + +type memoryStore struct { + meta map[string][]byte + files map[string][]byte + keys map[string][]data.PrivateKey +} + +func (m *memoryStore) GetMeta(name string, size int64) ([]byte, error) { + d, ok := m.meta[name] + if ok { + if int64(len(d)) < size { + return d, nil + } + return d[:size], nil + } else { + return nil, ErrMetaNotFound{} + } +} + +func (m *memoryStore) SetMeta(name string, meta []byte) error { + m.meta[name] = meta + return nil +} + +func (m *memoryStore) SetMultiMeta(metas map[string][]byte) error { + for role, blob := range metas { + m.SetMeta(role, blob) + } + return nil +} + +func (m *memoryStore) GetTarget(path string) (io.ReadCloser, error) { + return &utils.NoopCloser{Reader: bytes.NewReader(m.files[path])}, nil +} + +func (m *memoryStore) WalkStagedTargets(paths []string, targetsFn targetsWalkFunc) error { + if len(paths) == 0 { + for path, dat := range m.files { + meta, err := data.NewFileMeta(bytes.NewReader(dat), "sha256") + if err != nil { + return err + } + if err = targetsFn(path, meta); err != nil { + return err + } + } + return nil + } + + for _, path := range paths { + dat, ok := m.files[path] + if !ok { + return errors.ErrFileNotFound{path} + } + meta, err := data.NewFileMeta(bytes.NewReader(dat), "sha256") + if err != nil { + return err + } + if err = targetsFn(path, meta); err != nil { + return err + } + } + return nil +} + +func (m *memoryStore) Commit(map[string][]byte, bool, map[string]data.Hashes) error { + return nil +} + +func (m *memoryStore) GetKey(role string) ([]byte, error) { + return nil, fmt.Errorf("GetKey is not implemented for the memoryStore") +} diff --git a/vendor/src/github.com/endophage/gotuf/tuf.go b/vendor/src/github.com/endophage/gotuf/tuf.go new file mode 100644 index 0000000000..39af54018b --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/tuf.go @@ -0,0 +1,580 @@ +// tuf defines the core TUF logic around manipulating a repo. +package tuf + +import ( + "bytes" + "crypto/sha256" + "encoding/hex" + "encoding/json" + "fmt" + "path/filepath" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/endophage/gotuf/data" + "github.com/endophage/gotuf/errors" + "github.com/endophage/gotuf/keys" + "github.com/endophage/gotuf/signed" + "github.com/endophage/gotuf/utils" +) + +type ErrSigVerifyFail struct{} + +func (e ErrSigVerifyFail) Error() string { + return "Error: Signature verification failed" +} + +type ErrMetaExpired struct{} + +func (e ErrMetaExpired) Error() string { + return "Error: Metadata has expired" +} + +type ErrLocalRootExpired struct{} + +func (e ErrLocalRootExpired) Error() string { + return "Error: Local Root Has Expired" +} + +type ErrNotLoaded struct { + role string +} + +func (err ErrNotLoaded) Error() string { + return fmt.Sprintf("%s role has not been loaded", err.role) +} + +// TufRepo is an in memory representation of the TUF Repo. +// It operates at the data.Signed level, accepting and producing +// data.Signed objects. Users of a TufRepo are responsible for +// fetching raw JSON and using the Set* functions to populate +// the TufRepo instance. +type TufRepo struct { + Root *data.SignedRoot + Targets map[string]*data.SignedTargets + Snapshot *data.SignedSnapshot + Timestamp *data.SignedTimestamp + keysDB *keys.KeyDB + cryptoService signed.CryptoService +} + +// NewTufRepo initializes a TufRepo instance with a keysDB and a signer. +// If the TufRepo will only be used for reading, the signer should be nil. +func NewTufRepo(keysDB *keys.KeyDB, cryptoService signed.CryptoService) *TufRepo { + repo := &TufRepo{ + Targets: make(map[string]*data.SignedTargets), + keysDB: keysDB, + cryptoService: cryptoService, + } + return repo +} + +// AddBaseKeys is used to add keys to the role in root.json +func (tr *TufRepo) AddBaseKeys(role string, keys ...data.PublicKey) error { + if tr.Root == nil { + return ErrNotLoaded{role: "root"} + } + ids := []string{} + for _, k := range keys { + // Store only the public portion + pubKey := data.NewPrivateKey(k.Algorithm(), k.Public(), nil) + tr.Root.Signed.Keys[pubKey.ID()] = pubKey + tr.keysDB.AddKey(k) + tr.Root.Signed.Roles[role].KeyIDs = append(tr.Root.Signed.Roles[role].KeyIDs, pubKey.ID()) + ids = append(ids, pubKey.ID()) + } + r, err := data.NewRole( + role, + tr.Root.Signed.Roles[role].Threshold, + ids, + nil, + nil, + ) + if err != nil { + return err + } + tr.keysDB.AddRole(r) + tr.Root.Dirty = true + return nil + +} + +// ReplaceBaseKeys is used to replace all keys for the given role with the new keys +func (tr *TufRepo) ReplaceBaseKeys(role string, keys ...data.PublicKey) error { + r := tr.keysDB.GetRole(role) + err := tr.RemoveBaseKeys(role, r.KeyIDs...) + if err != nil { + return err + } + return tr.AddBaseKeys(role, keys...) +} + +// RemoveBaseKeys is used to remove keys from the roles in root.json +func (tr *TufRepo) RemoveBaseKeys(role string, keyIDs ...string) error { + if tr.Root == nil { + return ErrNotLoaded{role: "root"} + } + keep := make([]string, 0) + toDelete := make(map[string]struct{}) + // remove keys from specified role + for _, k := range keyIDs { + toDelete[k] = struct{}{} + for _, rk := range tr.Root.Signed.Roles[role].KeyIDs { + if k != rk { + keep = append(keep, rk) + } + } + } + tr.Root.Signed.Roles[role].KeyIDs = keep + + // determine which keys are no longer in use by any roles + for roleName, r := range tr.Root.Signed.Roles { + if roleName == role { + continue + } + for _, rk := range r.KeyIDs { + if _, ok := toDelete[rk]; ok { + delete(toDelete, rk) + } + } + } + + // remove keys no longer in use by any roles + for k := range toDelete { + delete(tr.Root.Signed.Keys, k) + } + tr.Root.Dirty = true + return nil +} + +// UpdateDelegations updates the appropriate delegations, either adding +// a new delegation or updating an existing one. If keys are +// provided, the IDs will be added to the role (if they do not exist +// there already), and the keys will be added to the targets file. +// The "before" argument specifies another role which this new role +// will be added in front of (i.e. higher priority) in the delegation list. +// An empty before string indicates to add the role to the end of the +// delegation list. +// A new, empty, targets file will be created for the new role. +func (tr *TufRepo) UpdateDelegations(role *data.Role, keys []data.Key, before string) error { + if !role.IsDelegation() || !role.IsValid() { + return errors.ErrInvalidRole{} + } + parent := filepath.Dir(role.Name) + p, ok := tr.Targets[parent] + if !ok { + return errors.ErrInvalidRole{} + } + for _, k := range keys { + key := data.NewPublicKey(k.Algorithm(), k.Public()) + if !utils.StrSliceContains(role.KeyIDs, key.ID()) { + role.KeyIDs = append(role.KeyIDs, key.ID()) + } + p.Signed.Delegations.Keys[key.ID()] = key + tr.keysDB.AddKey(key) + } + + i := -1 + var r *data.Role + for i, r = range p.Signed.Delegations.Roles { + if r.Name == role.Name { + break + } + } + if i >= 0 { + p.Signed.Delegations.Roles[i] = role + } else { + p.Signed.Delegations.Roles = append(p.Signed.Delegations.Roles, role) + } + p.Dirty = true + + roleTargets := data.NewTargets() // NewTargets always marked Dirty + tr.Targets[role.Name] = roleTargets + + tr.keysDB.AddRole(role) + + return nil +} + +// InitRepo creates the base files for a repo. It inspects data.ValidRoles and +// data.ValidTypes to determine what the role names and filename should be. It +// also relies on the keysDB having already been populated with the keys and +// roles. +func (tr *TufRepo) InitRepo(consistent bool) error { + if err := tr.InitRoot(consistent); err != nil { + return err + } + if err := tr.InitTargets(); err != nil { + return err + } + if err := tr.InitSnapshot(); err != nil { + return err + } + return tr.InitTimestamp() +} + +func (tr *TufRepo) InitRoot(consistent bool) error { + rootRoles := make(map[string]*data.RootRole) + rootKeys := make(map[string]data.PublicKey) + for _, r := range data.ValidRoles { + role := tr.keysDB.GetRole(r) + if role == nil { + return errors.ErrInvalidRole{} + } + rootRoles[r] = &role.RootRole + for _, kid := range role.KeyIDs { + // don't need to check if GetKey returns nil, Key presence was + // checked by KeyDB when role was added. + key := tr.keysDB.GetKey(kid) + // Create new key object to doubly ensure private key is excluded + k := data.NewPublicKey(key.Algorithm(), key.Public()) + rootKeys[kid] = k + } + } + root, err := data.NewRoot(rootKeys, rootRoles, consistent) + if err != nil { + return err + } + tr.Root = root + return nil +} + +func (tr *TufRepo) InitTargets() error { + targets := data.NewTargets() + tr.Targets[data.ValidRoles["targets"]] = targets + return nil +} + +func (tr *TufRepo) InitSnapshot() error { + root, err := tr.Root.ToSigned() + if err != nil { + return err + } + targets, err := tr.Targets[data.ValidRoles["targets"]].ToSigned() + if err != nil { + return err + } + snapshot, err := data.NewSnapshot(root, targets) + if err != nil { + return err + } + tr.Snapshot = snapshot + return nil +} + +func (tr *TufRepo) InitTimestamp() error { + snap, err := tr.Snapshot.ToSigned() + if err != nil { + return err + } + timestamp, err := data.NewTimestamp(snap) + if err != nil { + return err + } + + tr.Timestamp = timestamp + return nil +} + +// SetRoot parses the Signed object into a SignedRoot object, sets +// the keys and roles in the KeyDB, and sets the TufRepo.Root field +// to the SignedRoot object. +func (tr *TufRepo) SetRoot(s *data.SignedRoot) error { + for _, key := range s.Signed.Keys { + logrus.Debug("Adding key ", key.ID()) + tr.keysDB.AddKey(key) + } + for roleName, role := range s.Signed.Roles { + logrus.Debugf("Adding role %s with keys %s", roleName, strings.Join(role.KeyIDs, ",")) + baseRole, err := data.NewRole( + roleName, + role.Threshold, + role.KeyIDs, + nil, + nil, + ) + if err != nil { + return err + } + err = tr.keysDB.AddRole(baseRole) + if err != nil { + return err + } + } + tr.Root = s + return nil +} + +// SetTimestamp parses the Signed object into a SignedTimestamp object +// and sets the TufRepo.Timestamp field. +func (tr *TufRepo) SetTimestamp(s *data.SignedTimestamp) error { + tr.Timestamp = s + return nil +} + +// SetSnapshot parses the Signed object into a SignedSnapshots object +// and sets the TufRepo.Snapshot field. +func (tr *TufRepo) SetSnapshot(s *data.SignedSnapshot) error { + tr.Snapshot = s + return nil +} + +// SetTargets parses the Signed object into a SignedTargets object, +// reads the delegated roles and keys into the KeyDB, and sets the +// SignedTargets object agaist the role in the TufRepo.Targets map. +func (tr *TufRepo) SetTargets(role string, s *data.SignedTargets) error { + for _, k := range s.Signed.Delegations.Keys { + tr.keysDB.AddKey(k) + } + for _, r := range s.Signed.Delegations.Roles { + tr.keysDB.AddRole(r) + } + tr.Targets[role] = s + return nil +} + +// TargetMeta returns the FileMeta entry for the given path in the +// targets file associated with the given role. This may be nil if +// the target isn't found in the targets file. +func (tr TufRepo) TargetMeta(role, path string) *data.FileMeta { + if t, ok := tr.Targets[role]; ok { + if m, ok := t.Signed.Targets[path]; ok { + return &m + } + } + return nil +} + +// TargetDelegations returns a slice of Roles that are valid publishers +// for the target path provided. +func (tr TufRepo) TargetDelegations(role, path, pathHex string) []*data.Role { + if pathHex == "" { + pathDigest := sha256.Sum256([]byte(path)) + pathHex = hex.EncodeToString(pathDigest[:]) + } + roles := make([]*data.Role, 0) + if t, ok := tr.Targets[role]; ok { + for _, r := range t.Signed.Delegations.Roles { + if r.CheckPrefixes(pathHex) || r.CheckPaths(path) { + roles = append(roles, r) + } + } + } + return roles +} + +// FindTarget attempts to find the target represented by the given +// path by starting at the top targets file and traversing +// appropriate delegations until the first entry is found or it +// runs out of locations to search. +// N.B. Multiple entries may exist in different delegated roles +// for the same target. Only the first one encountered is returned. +func (tr TufRepo) FindTarget(path string) *data.FileMeta { + pathDigest := sha256.Sum256([]byte(path)) + pathHex := hex.EncodeToString(pathDigest[:]) + + var walkTargets func(role string) *data.FileMeta + walkTargets = func(role string) *data.FileMeta { + if m := tr.TargetMeta(role, path); m != nil { + return m + } + // Depth first search of delegations based on order + // as presented in current targets file for role: + for _, r := range tr.TargetDelegations(role, path, pathHex) { + if m := walkTargets(r.Name); m != nil { + return m + } + } + return nil + } + + return walkTargets("targets") +} + +// AddTargets will attempt to add the given targets specifically to +// the directed role. If the user does not have the signing keys for the role +// the function will return an error and the full slice of targets. +func (tr *TufRepo) AddTargets(role string, targets data.Files) (data.Files, error) { + t, ok := tr.Targets[role] + if !ok { + return targets, errors.ErrInvalidRole{role} + } + invalid := make(data.Files) + for path, target := range targets { + pathDigest := sha256.Sum256([]byte(path)) + pathHex := hex.EncodeToString(pathDigest[:]) + r := tr.keysDB.GetRole(role) + if role == data.ValidRoles["targets"] || (r.CheckPaths(path) || r.CheckPrefixes(pathHex)) { + t.Signed.Targets[path] = target + } else { + invalid[path] = target + } + } + t.Dirty = true + if len(invalid) > 0 { + return invalid, fmt.Errorf("Could not add all targets") + } + return nil, nil +} + +func (tr *TufRepo) RemoveTargets(role string, targets ...string) error { + t, ok := tr.Targets[role] + if !ok { + return errors.ErrInvalidRole{role} + } + + for _, path := range targets { + delete(t.Signed.Targets, path) + } + t.Dirty = true + return nil +} + +func (tr *TufRepo) UpdateSnapshot(role string, s *data.Signed) error { + jsonData, err := json.Marshal(s) + if err != nil { + return err + } + meta, err := data.NewFileMeta(bytes.NewReader(jsonData), "sha256") + if err != nil { + return err + } + tr.Snapshot.Signed.Meta[role] = meta + tr.Snapshot.Dirty = true + return nil +} + +func (tr *TufRepo) UpdateTimestamp(s *data.Signed) error { + jsonData, err := json.Marshal(s) + if err != nil { + return err + } + meta, err := data.NewFileMeta(bytes.NewReader(jsonData), "sha256") + if err != nil { + return err + } + tr.Timestamp.Signed.Meta["snapshot"] = meta + tr.Timestamp.Dirty = true + return nil +} + +func (tr *TufRepo) SignRoot(expires time.Time, cryptoService signed.CryptoService) (*data.Signed, error) { + logrus.Debug("signing root...") + tr.Root.Signed.Expires = expires + tr.Root.Signed.Version++ + root := tr.keysDB.GetRole(data.ValidRoles["root"]) + signed, err := tr.Root.ToSigned() + if err != nil { + return nil, err + } + signed, err = tr.sign(signed, *root, cryptoService) + if err != nil { + return nil, err + } + tr.Root.Signatures = signed.Signatures + return signed, nil +} + +func (tr *TufRepo) SignTargets(role string, expires time.Time, cryptoService signed.CryptoService) (*data.Signed, error) { + logrus.Debugf("sign targets called for role %s", role) + tr.Targets[role].Signed.Expires = expires + tr.Targets[role].Signed.Version++ + signed, err := tr.Targets[role].ToSigned() + if err != nil { + logrus.Debug("errored getting targets data.Signed object") + return nil, err + } + targets := tr.keysDB.GetRole(role) + signed, err = tr.sign(signed, *targets, cryptoService) + if err != nil { + logrus.Debug("errored signing ", role) + return nil, err + } + tr.Targets[role].Signatures = signed.Signatures + return signed, nil +} + +func (tr *TufRepo) SignSnapshot(expires time.Time, cryptoService signed.CryptoService) (*data.Signed, error) { + logrus.Debug("signing snapshot...") + signedRoot, err := tr.Root.ToSigned() + if err != nil { + return nil, err + } + err = tr.UpdateSnapshot("root", signedRoot) + if err != nil { + return nil, err + } + tr.Root.Dirty = false // root dirty until changes captures in snapshot + for role, targets := range tr.Targets { + signedTargets, err := targets.ToSigned() + if err != nil { + return nil, err + } + err = tr.UpdateSnapshot(role, signedTargets) + if err != nil { + return nil, err + } + } + tr.Snapshot.Signed.Expires = expires + tr.Snapshot.Signed.Version++ + signed, err := tr.Snapshot.ToSigned() + if err != nil { + return nil, err + } + snapshot := tr.keysDB.GetRole(data.ValidRoles["snapshot"]) + signed, err = tr.sign(signed, *snapshot, cryptoService) + if err != nil { + return nil, err + } + tr.Snapshot.Signatures = signed.Signatures + return signed, nil +} + +func (tr *TufRepo) SignTimestamp(expires time.Time, cryptoService signed.CryptoService) (*data.Signed, error) { + logrus.Debug("SignTimestamp") + signedSnapshot, err := tr.Snapshot.ToSigned() + if err != nil { + return nil, err + } + err = tr.UpdateTimestamp(signedSnapshot) + if err != nil { + return nil, err + } + tr.Timestamp.Signed.Expires = expires + tr.Timestamp.Signed.Version++ + signed, err := tr.Timestamp.ToSigned() + if err != nil { + return nil, err + } + timestamp := tr.keysDB.GetRole(data.ValidRoles["timestamp"]) + signed, err = tr.sign(signed, *timestamp, cryptoService) + if err != nil { + return nil, err + } + tr.Timestamp.Signatures = signed.Signatures + tr.Snapshot.Dirty = false // snapshot is dirty until changes have been captured in timestamp + return signed, nil +} + +func (tr TufRepo) sign(signedData *data.Signed, role data.Role, cryptoService signed.CryptoService) (*data.Signed, error) { + ks := make([]data.PublicKey, 0, len(role.KeyIDs)) + for _, kid := range role.KeyIDs { + k := tr.keysDB.GetKey(kid) + if k == nil { + continue + } + ks = append(ks, k) + } + if len(ks) < 1 { + return nil, keys.ErrInvalidKey + } + if cryptoService == nil { + cryptoService = tr.cryptoService + } + err := signed.Sign(cryptoService, signedData, ks...) + if err != nil { + return nil, err + } + return signedData, nil +} diff --git a/vendor/src/github.com/endophage/gotuf/utils/util.go b/vendor/src/github.com/endophage/gotuf/utils/util.go new file mode 100644 index 0000000000..5184f799a4 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/utils/util.go @@ -0,0 +1,82 @@ +package utils + +import ( + "crypto/hmac" + "encoding/hex" + "errors" + "fmt" + gopath "path" + "path/filepath" + + "github.com/endophage/gotuf/data" +) + +var ErrWrongLength = errors.New("wrong length") + +type ErrWrongHash struct { + Type string + Expected []byte + Actual []byte +} + +func (e ErrWrongHash) Error() string { + return fmt.Sprintf("wrong %s hash, expected %#x got %#x", e.Type, e.Expected, e.Actual) +} + +type ErrNoCommonHash struct { + Expected data.Hashes + Actual data.Hashes +} + +func (e ErrNoCommonHash) Error() string { + types := func(a data.Hashes) []string { + t := make([]string, 0, len(a)) + for typ := range a { + t = append(t, typ) + } + return t + } + return fmt.Sprintf("no common hash function, expected one of %s, got %s", types(e.Expected), types(e.Actual)) +} + +type ErrUnknownHashAlgorithm struct { + Name string +} + +func (e ErrUnknownHashAlgorithm) Error() string { + return fmt.Sprintf("unknown hash algorithm: %s", e.Name) +} + +type PassphraseFunc func(role string, confirm bool) ([]byte, error) + +func FileMetaEqual(actual data.FileMeta, expected data.FileMeta) error { + if actual.Length != expected.Length { + return ErrWrongLength + } + hashChecked := false + for typ, hash := range expected.Hashes { + if h, ok := actual.Hashes[typ]; ok { + hashChecked = true + if !hmac.Equal(h, hash) { + return ErrWrongHash{typ, hash, h} + } + } + } + if !hashChecked { + return ErrNoCommonHash{expected.Hashes, actual.Hashes} + } + return nil +} + +func NormalizeTarget(path string) string { + return gopath.Join("/", path) +} + +func HashedPaths(path string, hashes data.Hashes) []string { + paths := make([]string, 0, len(hashes)) + for _, hash := range hashes { + hashedPath := filepath.Join(filepath.Dir(path), hex.EncodeToString(hash)+"."+filepath.Base(path)) + paths = append(paths, hashedPath) + } + return paths +} diff --git a/vendor/src/github.com/endophage/gotuf/utils/utils.go b/vendor/src/github.com/endophage/gotuf/utils/utils.go new file mode 100644 index 0000000000..ca164a1aa4 --- /dev/null +++ b/vendor/src/github.com/endophage/gotuf/utils/utils.go @@ -0,0 +1,93 @@ +package utils + +import ( + "bytes" + "crypto/sha256" + "crypto/sha512" + "crypto/tls" + "fmt" + "io" + "net/http" + "net/url" + "os" + "strings" + + "github.com/endophage/gotuf/data" +) + +func Download(url url.URL) (*http.Response, error) { + tr := &http.Transport{ + TLSClientConfig: &tls.Config{InsecureSkipVerify: true}, + } + client := &http.Client{Transport: tr} + return client.Get(url.String()) +} + +func Upload(url string, body io.Reader) (*http.Response, error) { + tr := &http.Transport{ + TLSClientConfig: &tls.Config{InsecureSkipVerify: true}, + } + client := &http.Client{Transport: tr} + return client.Post(url, "application/json", body) +} + +func ValidateTarget(r io.Reader, m *data.FileMeta) error { + h := sha256.New() + length, err := io.Copy(h, r) + if err != nil { + return err + } + if length != m.Length { + return fmt.Errorf("Size of downloaded target did not match targets entry.\nExpected: %s\nReceived: %s\n", m.Length, length) + } + hashDigest := h.Sum(nil) + if bytes.Compare(m.Hashes["sha256"], hashDigest[:]) != 0 { + return fmt.Errorf("Hash of downloaded target did not match targets entry.\nExpected: %x\nReceived: %x\n", m.Hashes["sha256"], hashDigest) + } + return nil +} + +func StrSliceContains(ss []string, s string) bool { + for _, v := range ss { + if v == s { + return true + } + } + return false +} + +func StrSliceContainsI(ss []string, s string) bool { + s = strings.ToLower(s) + for _, v := range ss { + v = strings.ToLower(v) + if v == s { + return true + } + } + return false +} + +func FileExists(path string) bool { + _, err := os.Stat(path) + return os.IsNotExist(err) +} + +type NoopCloser struct { + io.Reader +} + +func (nc *NoopCloser) Close() error { + return nil +} + +func DoHash(alg string, d []byte) []byte { + switch alg { + case "sha256": + digest := sha256.Sum256(d) + return digest[:] + case "sha512": + digest := sha512.Sum512(d) + return digest[:] + } + return nil +} diff --git a/vendor/src/github.com/fluent/fluent-logger-golang/LICENSE b/vendor/src/github.com/fluent/fluent-logger-golang/LICENSE new file mode 100644 index 0000000000..1aa91de6cc --- /dev/null +++ b/vendor/src/github.com/fluent/fluent-logger-golang/LICENSE @@ -0,0 +1,13 @@ +Copyright (c) 2013 Tatsuo Kaniwa + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. \ No newline at end of file diff --git a/vendor/src/github.com/fluent/fluent-logger-golang/fluent/fluent.go b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/fluent.go new file mode 100644 index 0000000000..ce65cae639 --- /dev/null +++ b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/fluent.go @@ -0,0 +1,246 @@ +package fluent + +import ( + "errors" + "fmt" + "io" + "math" + "net" + "reflect" + "strconv" + "sync" + "time" +) + +const ( + defaultHost = "127.0.0.1" + defaultPort = 24224 + defaultTimeout = 3 * time.Second + defaultBufferLimit = 8 * 1024 * 1024 + defaultRetryWait = 500 + defaultMaxRetry = 13 + defaultReconnectWaitIncreRate = 1.5 +) + +type Config struct { + FluentPort int + FluentHost string + Timeout time.Duration + BufferLimit int + RetryWait int + MaxRetry int + TagPrefix string +} + +type Fluent struct { + Config + conn io.WriteCloser + pending []byte + reconnecting bool + mu sync.Mutex +} + +// New creates a new Logger. +func New(config Config) (f *Fluent, err error) { + if config.FluentHost == "" { + config.FluentHost = defaultHost + } + if config.FluentPort == 0 { + config.FluentPort = defaultPort + } + if config.Timeout == 0 { + config.Timeout = defaultTimeout + } + if config.BufferLimit == 0 { + config.BufferLimit = defaultBufferLimit + } + if config.RetryWait == 0 { + config.RetryWait = defaultRetryWait + } + if config.MaxRetry == 0 { + config.MaxRetry = defaultMaxRetry + } + f = &Fluent{Config: config, reconnecting: false} + err = f.connect() + return +} + +// Post writes the output for a logging event. +// +// Examples: +// +// // send string +// f.Post("tag_name", "data") +// +// // send map[string] +// mapStringData := map[string]string{ +// "foo": "bar", +// } +// f.Post("tag_name", mapStringData) +// +// // send message with specified time +// mapStringData := map[string]string{ +// "foo": "bar", +// } +// tm := time.Now() +// f.PostWithTime("tag_name", tm, mapStringData) +// +// // send struct +// structData := struct { +// Name string `msg:"name"` +// } { +// "john smith", +// } +// f.Post("tag_name", structData) +// +func (f *Fluent) Post(tag string, message interface{}) error { + timeNow := time.Now() + return f.PostWithTime(tag, timeNow, message) +} + +func (f *Fluent) PostWithTime(tag string, tm time.Time, message interface{}) error { + if len(f.TagPrefix) > 0 { + tag = f.TagPrefix + "." + tag + } + + msg := reflect.ValueOf(message) + msgtype := msg.Type() + + if msgtype.Kind() == reflect.Struct { + // message should be tagged by "codec" or "msg" + kv := make(map[string]interface{}) + fields := msgtype.NumField() + for i := 0; i < fields; i++ { + field := msgtype.Field(i) + name := field.Name + if n1 := field.Tag.Get("msg"); n1 != "" { + name = n1 + } else if n2 := field.Tag.Get("codec"); n2 != "" { + name = n2 + } + kv[name] = msg.FieldByIndex(field.Index).Interface() + } + return f.EncodeAndPostData(tag, tm, kv) + } + + if msgtype.Kind() != reflect.Map { + return errors.New("messge must be a map") + } else if msgtype.Key().Kind() != reflect.String { + return errors.New("map keys must be strings") + } + + kv := make(map[string]interface{}) + for _, k := range msg.MapKeys() { + kv[k.String()] = msg.MapIndex(k).Interface() + } + + return f.EncodeAndPostData(tag, tm, kv) +} + +func (f *Fluent) EncodeAndPostData(tag string, tm time.Time, message interface{}) error { + if data, dumperr := f.EncodeData(tag, tm, message); dumperr != nil { + return fmt.Errorf("fluent#EncodeAndPostData: can't convert '%s' to msgpack:%s", message, dumperr) + // fmt.Println("fluent#Post: can't convert to msgpack:", message, dumperr) + } else { + f.PostRawData(data) + return nil + } +} + +func (f *Fluent) PostRawData(data []byte) { + f.mu.Lock() + f.pending = append(f.pending, data...) + f.mu.Unlock() + if err := f.send(); err != nil { + f.close() + if len(f.pending) > f.Config.BufferLimit { + f.flushBuffer() + } + } else { + f.flushBuffer() + } +} + +func (f *Fluent) EncodeData(tag string, tm time.Time, message interface{}) (data []byte, err error) { + timeUnix := tm.Unix() + msg := &Message{Tag: tag, Time: timeUnix, Record: message} + data, err = msg.MarshalMsg(nil) + return +} + +// Close closes the connection. +func (f *Fluent) Close() (err error) { + if len(f.pending) > 0 { + _ = f.send() + } + err = f.close() + return +} + +// close closes the connection. +func (f *Fluent) close() (err error) { + if f.conn != nil { + f.mu.Lock() + defer f.mu.Unlock() + } else { + return + } + if f.conn != nil { + f.conn.Close() + f.conn = nil + } + return +} + +// connect establishes a new connection using the specified transport. +func (f *Fluent) connect() (err error) { + f.conn, err = net.DialTimeout("tcp", f.Config.FluentHost+":"+strconv.Itoa(f.Config.FluentPort), f.Config.Timeout) + return +} + +func e(x, y float64) int { + return int(math.Pow(x, y)) +} + +func (f *Fluent) reconnect() { + go func() { + for i := 0; ; i++ { + err := f.connect() + if err == nil { + f.mu.Lock() + f.reconnecting = false + f.mu.Unlock() + break + } else { + if i == f.Config.MaxRetry { + panic("fluent#reconnect: failed to reconnect!") + } + waitTime := f.Config.RetryWait * e(defaultReconnectWaitIncreRate, float64(i-1)) + time.Sleep(time.Duration(waitTime) * time.Millisecond) + } + } + }() +} + +func (f *Fluent) flushBuffer() { + f.mu.Lock() + defer f.mu.Unlock() + f.pending = f.pending[0:0] +} + +func (f *Fluent) send() (err error) { + if f.conn == nil { + if f.reconnecting == false { + f.mu.Lock() + f.reconnecting = true + f.mu.Unlock() + f.reconnect() + } + err = errors.New("fluent#send: can't send logs, client is reconnecting") + } else { + f.mu.Lock() + _, err = f.conn.Write(f.pending) + f.mu.Unlock() + } + return +} diff --git a/vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto.go b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto.go new file mode 100644 index 0000000000..268d614dfd --- /dev/null +++ b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto.go @@ -0,0 +1,24 @@ +//go:generate msgp + +package fluent + +//msgp:tuple Entry +type Entry struct { + Time int64 `msg:"time"` + Record interface{} `msg:"record"` +} + +//msgp:tuple Forward +type Forward struct { + Tag string `msg:"tag"` + Entries []Entry `msg:"entries"` + Option interface{} `msg:"option"` +} + +//msgp:tuple Message +type Message struct { + Tag string `msg:"tag"` + Time int64 `msg:"time"` + Record interface{} `msg:"record"` + Option interface{} `msg:"option"` +} diff --git a/vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto_gen.go b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto_gen.go new file mode 100644 index 0000000000..afb9d6d31f --- /dev/null +++ b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/proto_gen.go @@ -0,0 +1,372 @@ +package fluent + +// NOTE: THIS FILE WAS PRODUCED BY THE +// MSGP CODE GENERATION TOOL (github.com/tinylib/msgp) +// DO NOT EDIT + +import ( + "github.com/tinylib/msgp/msgp" +) + +// DecodeMsg implements msgp.Decodable +func (z *Entry) DecodeMsg(dc *msgp.Reader) (err error) { + var ssz uint32 + ssz, err = dc.ReadArrayHeader() + if err != nil { + return + } + if ssz != 2 { + err = msgp.ArrayError{Wanted: 2, Got: ssz} + return + } + z.Time, err = dc.ReadInt64() + if err != nil { + return + } + z.Record, err = dc.ReadIntf() + if err != nil { + return + } + return +} + +// EncodeMsg implements msgp.Encodable +func (z Entry) EncodeMsg(en *msgp.Writer) (err error) { + err = en.WriteArrayHeader(2) + if err != nil { + return + } + err = en.WriteInt64(z.Time) + if err != nil { + return + } + err = en.WriteIntf(z.Record) + if err != nil { + return + } + return +} + +// MarshalMsg implements msgp.Marshaler +func (z Entry) MarshalMsg(b []byte) (o []byte, err error) { + o = msgp.Require(b, z.Msgsize()) + o = msgp.AppendArrayHeader(o, 2) + o = msgp.AppendInt64(o, z.Time) + o, err = msgp.AppendIntf(o, z.Record) + if err != nil { + return + } + return +} + +// UnmarshalMsg implements msgp.Unmarshaler +func (z *Entry) UnmarshalMsg(bts []byte) (o []byte, err error) { + { + var ssz uint32 + ssz, bts, err = msgp.ReadArrayHeaderBytes(bts) + if err != nil { + return + } + if ssz != 2 { + err = msgp.ArrayError{Wanted: 2, Got: ssz} + return + } + } + z.Time, bts, err = msgp.ReadInt64Bytes(bts) + if err != nil { + return + } + z.Record, bts, err = msgp.ReadIntfBytes(bts) + if err != nil { + return + } + o = bts + return +} + +func (z Entry) Msgsize() (s int) { + s = msgp.ArrayHeaderSize + msgp.Int64Size + msgp.GuessSize(z.Record) + return +} + +// DecodeMsg implements msgp.Decodable +func (z *Forward) DecodeMsg(dc *msgp.Reader) (err error) { + var ssz uint32 + ssz, err = dc.ReadArrayHeader() + if err != nil { + return + } + if ssz != 3 { + err = msgp.ArrayError{Wanted: 3, Got: ssz} + return + } + z.Tag, err = dc.ReadString() + if err != nil { + return + } + var xsz uint32 + xsz, err = dc.ReadArrayHeader() + if err != nil { + return + } + if cap(z.Entries) >= int(xsz) { + z.Entries = z.Entries[:xsz] + } else { + z.Entries = make([]Entry, xsz) + } + for xvk := range z.Entries { + var ssz uint32 + ssz, err = dc.ReadArrayHeader() + if err != nil { + return + } + if ssz != 2 { + err = msgp.ArrayError{Wanted: 2, Got: ssz} + return + } + z.Entries[xvk].Time, err = dc.ReadInt64() + if err != nil { + return + } + z.Entries[xvk].Record, err = dc.ReadIntf() + if err != nil { + return + } + } + z.Option, err = dc.ReadIntf() + if err != nil { + return + } + return +} + +// EncodeMsg implements msgp.Encodable +func (z *Forward) EncodeMsg(en *msgp.Writer) (err error) { + err = en.WriteArrayHeader(3) + if err != nil { + return + } + err = en.WriteString(z.Tag) + if err != nil { + return + } + err = en.WriteArrayHeader(uint32(len(z.Entries))) + if err != nil { + return + } + for xvk := range z.Entries { + err = en.WriteArrayHeader(2) + if err != nil { + return + } + err = en.WriteInt64(z.Entries[xvk].Time) + if err != nil { + return + } + err = en.WriteIntf(z.Entries[xvk].Record) + if err != nil { + return + } + } + err = en.WriteIntf(z.Option) + if err != nil { + return + } + return +} + +// MarshalMsg implements msgp.Marshaler +func (z *Forward) MarshalMsg(b []byte) (o []byte, err error) { + o = msgp.Require(b, z.Msgsize()) + o = msgp.AppendArrayHeader(o, 3) + o = msgp.AppendString(o, z.Tag) + o = msgp.AppendArrayHeader(o, uint32(len(z.Entries))) + for xvk := range z.Entries { + o = msgp.AppendArrayHeader(o, 2) + o = msgp.AppendInt64(o, z.Entries[xvk].Time) + o, err = msgp.AppendIntf(o, z.Entries[xvk].Record) + if err != nil { + return + } + } + o, err = msgp.AppendIntf(o, z.Option) + if err != nil { + return + } + return +} + +// UnmarshalMsg implements msgp.Unmarshaler +func (z *Forward) UnmarshalMsg(bts []byte) (o []byte, err error) { + { + var ssz uint32 + ssz, bts, err = msgp.ReadArrayHeaderBytes(bts) + if err != nil { + return + } + if ssz != 3 { + err = msgp.ArrayError{Wanted: 3, Got: ssz} + return + } + } + z.Tag, bts, err = msgp.ReadStringBytes(bts) + if err != nil { + return + } + var xsz uint32 + xsz, bts, err = msgp.ReadArrayHeaderBytes(bts) + if err != nil { + return + } + if cap(z.Entries) >= int(xsz) { + z.Entries = z.Entries[:xsz] + } else { + z.Entries = make([]Entry, xsz) + } + for xvk := range z.Entries { + { + var ssz uint32 + ssz, bts, err = msgp.ReadArrayHeaderBytes(bts) + if err != nil { + return + } + if ssz != 2 { + err = msgp.ArrayError{Wanted: 2, Got: ssz} + return + } + } + z.Entries[xvk].Time, bts, err = msgp.ReadInt64Bytes(bts) + if err != nil { + return + } + z.Entries[xvk].Record, bts, err = msgp.ReadIntfBytes(bts) + if err != nil { + return + } + } + z.Option, bts, err = msgp.ReadIntfBytes(bts) + if err != nil { + return + } + o = bts + return +} + +func (z *Forward) Msgsize() (s int) { + s = msgp.ArrayHeaderSize + msgp.StringPrefixSize + len(z.Tag) + msgp.ArrayHeaderSize + for xvk := range z.Entries { + s += msgp.ArrayHeaderSize + msgp.Int64Size + msgp.GuessSize(z.Entries[xvk].Record) + } + s += msgp.GuessSize(z.Option) + return +} + +// DecodeMsg implements msgp.Decodable +func (z *Message) DecodeMsg(dc *msgp.Reader) (err error) { + var ssz uint32 + ssz, err = dc.ReadArrayHeader() + if err != nil { + return + } + if ssz != 4 { + err = msgp.ArrayError{Wanted: 4, Got: ssz} + return + } + z.Tag, err = dc.ReadString() + if err != nil { + return + } + z.Time, err = dc.ReadInt64() + if err != nil { + return + } + z.Record, err = dc.ReadIntf() + if err != nil { + return + } + z.Option, err = dc.ReadIntf() + if err != nil { + return + } + return +} + +// EncodeMsg implements msgp.Encodable +func (z *Message) EncodeMsg(en *msgp.Writer) (err error) { + err = en.WriteArrayHeader(4) + if err != nil { + return + } + err = en.WriteString(z.Tag) + if err != nil { + return + } + err = en.WriteInt64(z.Time) + if err != nil { + return + } + err = en.WriteIntf(z.Record) + if err != nil { + return + } + err = en.WriteIntf(z.Option) + if err != nil { + return + } + return +} + +// MarshalMsg implements msgp.Marshaler +func (z *Message) MarshalMsg(b []byte) (o []byte, err error) { + o = msgp.Require(b, z.Msgsize()) + o = msgp.AppendArrayHeader(o, 4) + o = msgp.AppendString(o, z.Tag) + o = msgp.AppendInt64(o, z.Time) + o, err = msgp.AppendIntf(o, z.Record) + if err != nil { + return + } + o, err = msgp.AppendIntf(o, z.Option) + if err != nil { + return + } + return +} + +// UnmarshalMsg implements msgp.Unmarshaler +func (z *Message) UnmarshalMsg(bts []byte) (o []byte, err error) { + { + var ssz uint32 + ssz, bts, err = msgp.ReadArrayHeaderBytes(bts) + if err != nil { + return + } + if ssz != 4 { + err = msgp.ArrayError{Wanted: 4, Got: ssz} + return + } + } + z.Tag, bts, err = msgp.ReadStringBytes(bts) + if err != nil { + return + } + z.Time, bts, err = msgp.ReadInt64Bytes(bts) + if err != nil { + return + } + z.Record, bts, err = msgp.ReadIntfBytes(bts) + if err != nil { + return + } + z.Option, bts, err = msgp.ReadIntfBytes(bts) + if err != nil { + return + } + o = bts + return +} + +func (z *Message) Msgsize() (s int) { + s = msgp.ArrayHeaderSize + msgp.StringPrefixSize + len(z.Tag) + msgp.Int64Size + msgp.GuessSize(z.Record) + msgp.GuessSize(z.Option) + return +} diff --git a/vendor/src/github.com/fluent/fluent-logger-golang/fluent/version.go b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/version.go new file mode 100644 index 0000000000..135e1e51af --- /dev/null +++ b/vendor/src/github.com/fluent/fluent-logger-golang/fluent/version.go @@ -0,0 +1,3 @@ +package fluent + +const Version = "1.0.0" diff --git a/vendor/src/github.com/go-check/check/.gitignore b/vendor/src/github.com/go-check/check/.gitignore new file mode 100644 index 0000000000..191a5360b7 --- /dev/null +++ b/vendor/src/github.com/go-check/check/.gitignore @@ -0,0 +1,4 @@ +_* +*.swp +*.[568] +[568].out diff --git a/vendor/src/github.com/go-check/check/LICENSE b/vendor/src/github.com/go-check/check/LICENSE new file mode 100644 index 0000000000..545cf2d331 --- /dev/null +++ b/vendor/src/github.com/go-check/check/LICENSE @@ -0,0 +1,25 @@ +Gocheck - A rich testing framework for Go + +Copyright (c) 2010-2013 Gustavo Niemeyer + +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/go-check/check/README.md b/vendor/src/github.com/go-check/check/README.md new file mode 100644 index 0000000000..0ca9e57260 --- /dev/null +++ b/vendor/src/github.com/go-check/check/README.md @@ -0,0 +1,20 @@ +Instructions +============ + +Install the package with: + + go get gopkg.in/check.v1 + +Import it with: + + import "gopkg.in/check.v1" + +and use _check_ as the package name inside the code. + +For more details, visit the project page: + +* http://labix.org/gocheck + +and the API documentation: + +* https://gopkg.in/check.v1 diff --git a/vendor/src/github.com/go-check/check/TODO b/vendor/src/github.com/go-check/check/TODO new file mode 100644 index 0000000000..33498270ea --- /dev/null +++ b/vendor/src/github.com/go-check/check/TODO @@ -0,0 +1,2 @@ +- Assert(slice, Contains, item) +- Parallel test support diff --git a/vendor/src/github.com/go-check/check/benchmark.go b/vendor/src/github.com/go-check/check/benchmark.go new file mode 100644 index 0000000000..48cb8c8114 --- /dev/null +++ b/vendor/src/github.com/go-check/check/benchmark.go @@ -0,0 +1,163 @@ +// Copyright 2009 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package check + +import ( + "fmt" + "runtime" + "time" +) + +var memStats runtime.MemStats + +// testingB is a type passed to Benchmark functions to manage benchmark +// timing and to specify the number of iterations to run. +type timer struct { + start time.Time // Time test or benchmark started + duration time.Duration + N int + bytes int64 + timerOn bool + benchTime time.Duration + // The initial states of memStats.Mallocs and memStats.TotalAlloc. + startAllocs uint64 + startBytes uint64 + // The net total of this test after being run. + netAllocs uint64 + netBytes uint64 +} + +// StartTimer starts timing a test. This function is called automatically +// before a benchmark starts, but it can also used to resume timing after +// a call to StopTimer. +func (c *C) StartTimer() { + if !c.timerOn { + c.start = time.Now() + c.timerOn = true + + runtime.ReadMemStats(&memStats) + c.startAllocs = memStats.Mallocs + c.startBytes = memStats.TotalAlloc + } +} + +// StopTimer stops timing a test. This can be used to pause the timer +// while performing complex initialization that you don't +// want to measure. +func (c *C) StopTimer() { + if c.timerOn { + c.duration += time.Now().Sub(c.start) + c.timerOn = false + runtime.ReadMemStats(&memStats) + c.netAllocs += memStats.Mallocs - c.startAllocs + c.netBytes += memStats.TotalAlloc - c.startBytes + } +} + +// ResetTimer sets the elapsed benchmark time to zero. +// It does not affect whether the timer is running. +func (c *C) ResetTimer() { + if c.timerOn { + c.start = time.Now() + runtime.ReadMemStats(&memStats) + c.startAllocs = memStats.Mallocs + c.startBytes = memStats.TotalAlloc + } + c.duration = 0 + c.netAllocs = 0 + c.netBytes = 0 +} + +// SetBytes informs the number of bytes that the benchmark processes +// on each iteration. If this is called in a benchmark it will also +// report MB/s. +func (c *C) SetBytes(n int64) { + c.bytes = n +} + +func (c *C) nsPerOp() int64 { + if c.N <= 0 { + return 0 + } + return c.duration.Nanoseconds() / int64(c.N) +} + +func (c *C) mbPerSec() float64 { + if c.bytes <= 0 || c.duration <= 0 || c.N <= 0 { + return 0 + } + return (float64(c.bytes) * float64(c.N) / 1e6) / c.duration.Seconds() +} + +func (c *C) timerString() string { + if c.N <= 0 { + return fmt.Sprintf("%3.3fs", float64(c.duration.Nanoseconds())/1e9) + } + mbs := c.mbPerSec() + mb := "" + if mbs != 0 { + mb = fmt.Sprintf("\t%7.2f MB/s", mbs) + } + nsop := c.nsPerOp() + ns := fmt.Sprintf("%10d ns/op", nsop) + if c.N > 0 && nsop < 100 { + // The format specifiers here make sure that + // the ones digits line up for all three possible formats. + if nsop < 10 { + ns = fmt.Sprintf("%13.2f ns/op", float64(c.duration.Nanoseconds())/float64(c.N)) + } else { + ns = fmt.Sprintf("%12.1f ns/op", float64(c.duration.Nanoseconds())/float64(c.N)) + } + } + memStats := "" + if c.benchMem { + allocedBytes := fmt.Sprintf("%8d B/op", int64(c.netBytes)/int64(c.N)) + allocs := fmt.Sprintf("%8d allocs/op", int64(c.netAllocs)/int64(c.N)) + memStats = fmt.Sprintf("\t%s\t%s", allocedBytes, allocs) + } + return fmt.Sprintf("%8d\t%s%s%s", c.N, ns, mb, memStats) +} + +func min(x, y int) int { + if x > y { + return y + } + return x +} + +func max(x, y int) int { + if x < y { + return y + } + return x +} + +// roundDown10 rounds a number down to the nearest power of 10. +func roundDown10(n int) int { + var tens = 0 + // tens = floor(log_10(n)) + for n > 10 { + n = n / 10 + tens++ + } + // result = 10^tens + result := 1 + for i := 0; i < tens; i++ { + result *= 10 + } + return result +} + +// roundUp rounds x up to a number of the form [1eX, 2eX, 5eX]. +func roundUp(n int) int { + base := roundDown10(n) + if n < (2 * base) { + return 2 * base + } + if n < (5 * base) { + return 5 * base + } + return 10 * base +} diff --git a/vendor/src/github.com/go-check/check/check.go b/vendor/src/github.com/go-check/check/check.go new file mode 100644 index 0000000000..ca8c0f92de --- /dev/null +++ b/vendor/src/github.com/go-check/check/check.go @@ -0,0 +1,945 @@ +// Package check is a rich testing extension for Go's testing package. +// +// For details about the project, see: +// +// http://labix.org/gocheck +// +package check + +import ( + "bytes" + "errors" + "fmt" + "io" + "math/rand" + "os" + "path" + "path/filepath" + "reflect" + "regexp" + "runtime" + "strconv" + "strings" + "sync" + "time" +) + +// ----------------------------------------------------------------------- +// Internal type which deals with suite method calling. + +const ( + fixtureKd = iota + testKd +) + +type funcKind int + +const ( + succeededSt = iota + failedSt + skippedSt + panickedSt + fixturePanickedSt + missedSt +) + +type funcStatus int + +// A method value can't reach its own Method structure. +type methodType struct { + reflect.Value + Info reflect.Method +} + +func newMethod(receiver reflect.Value, i int) *methodType { + return &methodType{receiver.Method(i), receiver.Type().Method(i)} +} + +func (method *methodType) PC() uintptr { + return method.Info.Func.Pointer() +} + +func (method *methodType) suiteName() string { + t := method.Info.Type.In(0) + if t.Kind() == reflect.Ptr { + t = t.Elem() + } + return t.Name() +} + +func (method *methodType) String() string { + return method.suiteName() + "." + method.Info.Name +} + +func (method *methodType) matches(re *regexp.Regexp) bool { + return (re.MatchString(method.Info.Name) || + re.MatchString(method.suiteName()) || + re.MatchString(method.String())) +} + +type C struct { + method *methodType + kind funcKind + testName string + status funcStatus + logb *logger + logw io.Writer + done chan *C + reason string + mustFail bool + tempDir *tempDir + benchMem bool + startTime time.Time + timer +} + +func (c *C) stopNow() { + runtime.Goexit() +} + +// logger is a concurrency safe byte.Buffer +type logger struct { + sync.Mutex + writer bytes.Buffer +} + +func (l *logger) Write(buf []byte) (int, error) { + l.Lock() + defer l.Unlock() + return l.writer.Write(buf) +} + +func (l *logger) WriteTo(w io.Writer) (int64, error) { + l.Lock() + defer l.Unlock() + return l.writer.WriteTo(w) +} + +func (l *logger) String() string { + l.Lock() + defer l.Unlock() + return l.writer.String() +} + +// ----------------------------------------------------------------------- +// Handling of temporary files and directories. + +type tempDir struct { + sync.Mutex + path string + counter int +} + +func (td *tempDir) newPath() string { + td.Lock() + defer td.Unlock() + if td.path == "" { + var err error + for i := 0; i != 100; i++ { + path := fmt.Sprintf("%s%ccheck-%d", os.TempDir(), os.PathSeparator, rand.Int()) + if err = os.Mkdir(path, 0700); err == nil { + td.path = path + break + } + } + if td.path == "" { + panic("Couldn't create temporary directory: " + err.Error()) + } + } + result := filepath.Join(td.path, strconv.Itoa(td.counter)) + td.counter += 1 + return result +} + +func (td *tempDir) removeAll() { + td.Lock() + defer td.Unlock() + if td.path != "" { + err := os.RemoveAll(td.path) + if err != nil { + fmt.Fprintf(os.Stderr, "WARNING: Error cleaning up temporaries: "+err.Error()) + } + } +} + +// Create a new temporary directory which is automatically removed after +// the suite finishes running. +func (c *C) MkDir() string { + path := c.tempDir.newPath() + if err := os.Mkdir(path, 0700); err != nil { + panic(fmt.Sprintf("Couldn't create temporary directory %s: %s", path, err.Error())) + } + return path +} + +// ----------------------------------------------------------------------- +// Low-level logging functions. + +func (c *C) log(args ...interface{}) { + c.writeLog([]byte(fmt.Sprint(args...) + "\n")) +} + +func (c *C) logf(format string, args ...interface{}) { + c.writeLog([]byte(fmt.Sprintf(format+"\n", args...))) +} + +func (c *C) logNewLine() { + c.writeLog([]byte{'\n'}) +} + +func (c *C) writeLog(buf []byte) { + c.logb.Write(buf) + if c.logw != nil { + c.logw.Write(buf) + } +} + +func hasStringOrError(x interface{}) (ok bool) { + _, ok = x.(fmt.Stringer) + if ok { + return + } + _, ok = x.(error) + return +} + +func (c *C) logValue(label string, value interface{}) { + if label == "" { + if hasStringOrError(value) { + c.logf("... %#v (%q)", value, value) + } else { + c.logf("... %#v", value) + } + } else if value == nil { + c.logf("... %s = nil", label) + } else { + if hasStringOrError(value) { + fv := fmt.Sprintf("%#v", value) + qv := fmt.Sprintf("%q", value) + if fv != qv { + c.logf("... %s %s = %s (%s)", label, reflect.TypeOf(value), fv, qv) + return + } + } + if s, ok := value.(string); ok && isMultiLine(s) { + c.logf(`... %s %s = "" +`, label, reflect.TypeOf(value)) + c.logMultiLine(s) + } else { + c.logf("... %s %s = %#v", label, reflect.TypeOf(value), value) + } + } +} + +func (c *C) logMultiLine(s string) { + b := make([]byte, 0, len(s)*2) + i := 0 + n := len(s) + for i < n { + j := i + 1 + for j < n && s[j-1] != '\n' { + j++ + } + b = append(b, "... "...) + b = strconv.AppendQuote(b, s[i:j]) + if j < n { + b = append(b, " +"...) + } + b = append(b, '\n') + i = j + } + c.writeLog(b) +} + +func isMultiLine(s string) bool { + for i := 0; i+1 < len(s); i++ { + if s[i] == '\n' { + return true + } + } + return false +} + +func (c *C) logString(issue string) { + c.log("... ", issue) +} + +func (c *C) logCaller(skip int) { + // This is a bit heavier than it ought to be. + skip += 1 // Our own frame. + pc, callerFile, callerLine, ok := runtime.Caller(skip) + if !ok { + return + } + var testFile string + var testLine int + testFunc := runtime.FuncForPC(c.method.PC()) + if runtime.FuncForPC(pc) != testFunc { + for { + skip += 1 + if pc, file, line, ok := runtime.Caller(skip); ok { + // Note that the test line may be different on + // distinct calls for the same test. Showing + // the "internal" line is helpful when debugging. + if runtime.FuncForPC(pc) == testFunc { + testFile, testLine = file, line + break + } + } else { + break + } + } + } + if testFile != "" && (testFile != callerFile || testLine != callerLine) { + c.logCode(testFile, testLine) + } + c.logCode(callerFile, callerLine) +} + +func (c *C) logCode(path string, line int) { + c.logf("%s:%d:", nicePath(path), line) + code, err := printLine(path, line) + if code == "" { + code = "..." // XXX Open the file and take the raw line. + if err != nil { + code += err.Error() + } + } + c.log(indent(code, " ")) +} + +var valueGo = filepath.Join("reflect", "value.go") +var asmGo = filepath.Join("runtime", "asm_") + +func (c *C) logPanic(skip int, value interface{}) { + skip++ // Our own frame. + initialSkip := skip + for ; ; skip++ { + if pc, file, line, ok := runtime.Caller(skip); ok { + if skip == initialSkip { + c.logf("... Panic: %s (PC=0x%X)\n", value, pc) + } + name := niceFuncName(pc) + path := nicePath(file) + if strings.Contains(path, "/gopkg.in/check.v") { + continue + } + if name == "Value.call" && strings.HasSuffix(path, valueGo) { + continue + } + if name == "call16" && strings.Contains(path, asmGo) { + continue + } + c.logf("%s:%d\n in %s", nicePath(file), line, name) + } else { + break + } + } +} + +func (c *C) logSoftPanic(issue string) { + c.log("... Panic: ", issue) +} + +func (c *C) logArgPanic(method *methodType, expectedType string) { + c.logf("... Panic: %s argument should be %s", + niceFuncName(method.PC()), expectedType) +} + +// ----------------------------------------------------------------------- +// Some simple formatting helpers. + +var initWD, initWDErr = os.Getwd() + +func init() { + if initWDErr == nil { + initWD = strings.Replace(initWD, "\\", "/", -1) + "/" + } +} + +func nicePath(path string) string { + if initWDErr == nil { + if strings.HasPrefix(path, initWD) { + return path[len(initWD):] + } + } + return path +} + +func niceFuncPath(pc uintptr) string { + function := runtime.FuncForPC(pc) + if function != nil { + filename, line := function.FileLine(pc) + return fmt.Sprintf("%s:%d", nicePath(filename), line) + } + return "" +} + +func niceFuncName(pc uintptr) string { + function := runtime.FuncForPC(pc) + if function != nil { + name := path.Base(function.Name()) + if i := strings.Index(name, "."); i > 0 { + name = name[i+1:] + } + if strings.HasPrefix(name, "(*") { + if i := strings.Index(name, ")"); i > 0 { + name = name[2:i] + name[i+1:] + } + } + if i := strings.LastIndex(name, ".*"); i != -1 { + name = name[:i] + "." + name[i+2:] + } + if i := strings.LastIndex(name, "·"); i != -1 { + name = name[:i] + "." + name[i+2:] + } + return name + } + return "" +} + +// ----------------------------------------------------------------------- +// Result tracker to aggregate call results. + +type Result struct { + Succeeded int + Failed int + Skipped int + Panicked int + FixturePanicked int + ExpectedFailures int + Missed int // Not even tried to run, related to a panic in the fixture. + RunError error // Houston, we've got a problem. + WorkDir string // If KeepWorkDir is true +} + +type resultTracker struct { + result Result + _lastWasProblem bool + _waiting int + _missed int + _expectChan chan *C + _doneChan chan *C + _stopChan chan bool +} + +func newResultTracker() *resultTracker { + return &resultTracker{_expectChan: make(chan *C), // Synchronous + _doneChan: make(chan *C, 32), // Asynchronous + _stopChan: make(chan bool)} // Synchronous +} + +func (tracker *resultTracker) start() { + go tracker._loopRoutine() +} + +func (tracker *resultTracker) waitAndStop() { + <-tracker._stopChan +} + +func (tracker *resultTracker) expectCall(c *C) { + tracker._expectChan <- c +} + +func (tracker *resultTracker) callDone(c *C) { + tracker._doneChan <- c +} + +func (tracker *resultTracker) _loopRoutine() { + for { + var c *C + if tracker._waiting > 0 { + // Calls still running. Can't stop. + select { + // XXX Reindent this (not now to make diff clear) + case c = <-tracker._expectChan: + tracker._waiting += 1 + case c = <-tracker._doneChan: + tracker._waiting -= 1 + switch c.status { + case succeededSt: + if c.kind == testKd { + if c.mustFail { + tracker.result.ExpectedFailures++ + } else { + tracker.result.Succeeded++ + } + } + case failedSt: + tracker.result.Failed++ + case panickedSt: + if c.kind == fixtureKd { + tracker.result.FixturePanicked++ + } else { + tracker.result.Panicked++ + } + case fixturePanickedSt: + // Track it as missed, since the panic + // was on the fixture, not on the test. + tracker.result.Missed++ + case missedSt: + tracker.result.Missed++ + case skippedSt: + if c.kind == testKd { + tracker.result.Skipped++ + } + } + } + } else { + // No calls. Can stop, but no done calls here. + select { + case tracker._stopChan <- true: + return + case c = <-tracker._expectChan: + tracker._waiting += 1 + case c = <-tracker._doneChan: + panic("Tracker got an unexpected done call.") + } + } + } +} + +// ----------------------------------------------------------------------- +// The underlying suite runner. + +type suiteRunner struct { + suite interface{} + setUpSuite, tearDownSuite *methodType + setUpTest, tearDownTest *methodType + tests []*methodType + tracker *resultTracker + tempDir *tempDir + keepDir bool + output *outputWriter + reportedProblemLast bool + benchTime time.Duration + benchMem bool +} + +type RunConf struct { + Output io.Writer + Stream bool + Verbose bool + Filter string + Benchmark bool + BenchmarkTime time.Duration // Defaults to 1 second + BenchmarkMem bool + KeepWorkDir bool +} + +// Create a new suiteRunner able to run all methods in the given suite. +func newSuiteRunner(suite interface{}, runConf *RunConf) *suiteRunner { + var conf RunConf + if runConf != nil { + conf = *runConf + } + if conf.Output == nil { + conf.Output = os.Stdout + } + if conf.Benchmark { + conf.Verbose = true + } + + suiteType := reflect.TypeOf(suite) + suiteNumMethods := suiteType.NumMethod() + suiteValue := reflect.ValueOf(suite) + + runner := &suiteRunner{ + suite: suite, + output: newOutputWriter(conf.Output, conf.Stream, conf.Verbose), + tracker: newResultTracker(), + benchTime: conf.BenchmarkTime, + benchMem: conf.BenchmarkMem, + tempDir: &tempDir{}, + keepDir: conf.KeepWorkDir, + tests: make([]*methodType, 0, suiteNumMethods), + } + if runner.benchTime == 0 { + runner.benchTime = 1 * time.Second + } + + var filterRegexp *regexp.Regexp + if conf.Filter != "" { + if regexp, err := regexp.Compile(conf.Filter); err != nil { + msg := "Bad filter expression: " + err.Error() + runner.tracker.result.RunError = errors.New(msg) + return runner + } else { + filterRegexp = regexp + } + } + + for i := 0; i != suiteNumMethods; i++ { + method := newMethod(suiteValue, i) + switch method.Info.Name { + case "SetUpSuite": + runner.setUpSuite = method + case "TearDownSuite": + runner.tearDownSuite = method + case "SetUpTest": + runner.setUpTest = method + case "TearDownTest": + runner.tearDownTest = method + default: + prefix := "Test" + if conf.Benchmark { + prefix = "Benchmark" + } + if !strings.HasPrefix(method.Info.Name, prefix) { + continue + } + if filterRegexp == nil || method.matches(filterRegexp) { + runner.tests = append(runner.tests, method) + } + } + } + return runner +} + +// Run all methods in the given suite. +func (runner *suiteRunner) run() *Result { + if runner.tracker.result.RunError == nil && len(runner.tests) > 0 { + runner.tracker.start() + if runner.checkFixtureArgs() { + c := runner.runFixture(runner.setUpSuite, "", nil) + if c == nil || c.status == succeededSt { + for i := 0; i != len(runner.tests); i++ { + c := runner.runTest(runner.tests[i]) + if c.status == fixturePanickedSt { + runner.skipTests(missedSt, runner.tests[i+1:]) + break + } + } + } else if c != nil && c.status == skippedSt { + runner.skipTests(skippedSt, runner.tests) + } else { + runner.skipTests(missedSt, runner.tests) + } + runner.runFixture(runner.tearDownSuite, "", nil) + } else { + runner.skipTests(missedSt, runner.tests) + } + runner.tracker.waitAndStop() + if runner.keepDir { + runner.tracker.result.WorkDir = runner.tempDir.path + } else { + runner.tempDir.removeAll() + } + } + return &runner.tracker.result +} + +// Create a call object with the given suite method, and fork a +// goroutine with the provided dispatcher for running it. +func (runner *suiteRunner) forkCall(method *methodType, kind funcKind, testName string, logb *logger, dispatcher func(c *C)) *C { + var logw io.Writer + if runner.output.Stream { + logw = runner.output + } + if logb == nil { + logb = new(logger) + } + c := &C{ + method: method, + kind: kind, + testName: testName, + logb: logb, + logw: logw, + tempDir: runner.tempDir, + done: make(chan *C, 1), + timer: timer{benchTime: runner.benchTime}, + startTime: time.Now(), + benchMem: runner.benchMem, + } + runner.tracker.expectCall(c) + go (func() { + runner.reportCallStarted(c) + defer runner.callDone(c) + dispatcher(c) + })() + return c +} + +// Same as forkCall(), but wait for call to finish before returning. +func (runner *suiteRunner) runFunc(method *methodType, kind funcKind, testName string, logb *logger, dispatcher func(c *C)) *C { + c := runner.forkCall(method, kind, testName, logb, dispatcher) + <-c.done + return c +} + +// Handle a finished call. If there were any panics, update the call status +// accordingly. Then, mark the call as done and report to the tracker. +func (runner *suiteRunner) callDone(c *C) { + value := recover() + if value != nil { + switch v := value.(type) { + case *fixturePanic: + if v.status == skippedSt { + c.status = skippedSt + } else { + c.logSoftPanic("Fixture has panicked (see related PANIC)") + c.status = fixturePanickedSt + } + default: + c.logPanic(1, value) + c.status = panickedSt + } + } + if c.mustFail { + switch c.status { + case failedSt: + c.status = succeededSt + case succeededSt: + c.status = failedSt + c.logString("Error: Test succeeded, but was expected to fail") + c.logString("Reason: " + c.reason) + } + } + + runner.reportCallDone(c) + c.done <- c +} + +// Runs a fixture call synchronously. The fixture will still be run in a +// goroutine like all suite methods, but this method will not return +// while the fixture goroutine is not done, because the fixture must be +// run in a desired order. +func (runner *suiteRunner) runFixture(method *methodType, testName string, logb *logger) *C { + if method != nil { + c := runner.runFunc(method, fixtureKd, testName, logb, func(c *C) { + c.ResetTimer() + c.StartTimer() + defer c.StopTimer() + c.method.Call([]reflect.Value{reflect.ValueOf(c)}) + }) + return c + } + return nil +} + +// Run the fixture method with runFixture(), but panic with a fixturePanic{} +// in case the fixture method panics. This makes it easier to track the +// fixture panic together with other call panics within forkTest(). +func (runner *suiteRunner) runFixtureWithPanic(method *methodType, testName string, logb *logger, skipped *bool) *C { + if skipped != nil && *skipped { + return nil + } + c := runner.runFixture(method, testName, logb) + if c != nil && c.status != succeededSt { + if skipped != nil { + *skipped = c.status == skippedSt + } + panic(&fixturePanic{c.status, method}) + } + return c +} + +type fixturePanic struct { + status funcStatus + method *methodType +} + +// Run the suite test method, together with the test-specific fixture, +// asynchronously. +func (runner *suiteRunner) forkTest(method *methodType) *C { + testName := method.String() + return runner.forkCall(method, testKd, testName, nil, func(c *C) { + var skipped bool + defer runner.runFixtureWithPanic(runner.tearDownTest, testName, nil, &skipped) + defer c.StopTimer() + benchN := 1 + for { + runner.runFixtureWithPanic(runner.setUpTest, testName, c.logb, &skipped) + mt := c.method.Type() + if mt.NumIn() != 1 || mt.In(0) != reflect.TypeOf(c) { + // Rather than a plain panic, provide a more helpful message when + // the argument type is incorrect. + c.status = panickedSt + c.logArgPanic(c.method, "*check.C") + return + } + if strings.HasPrefix(c.method.Info.Name, "Test") { + c.ResetTimer() + c.StartTimer() + c.method.Call([]reflect.Value{reflect.ValueOf(c)}) + return + } + if !strings.HasPrefix(c.method.Info.Name, "Benchmark") { + panic("unexpected method prefix: " + c.method.Info.Name) + } + + runtime.GC() + c.N = benchN + c.ResetTimer() + c.StartTimer() + c.method.Call([]reflect.Value{reflect.ValueOf(c)}) + c.StopTimer() + if c.status != succeededSt || c.duration >= c.benchTime || benchN >= 1e9 { + return + } + perOpN := int(1e9) + if c.nsPerOp() != 0 { + perOpN = int(c.benchTime.Nanoseconds() / c.nsPerOp()) + } + + // Logic taken from the stock testing package: + // - Run more iterations than we think we'll need for a second (1.5x). + // - Don't grow too fast in case we had timing errors previously. + // - Be sure to run at least one more than last time. + benchN = max(min(perOpN+perOpN/2, 100*benchN), benchN+1) + benchN = roundUp(benchN) + + skipped = true // Don't run the deferred one if this panics. + runner.runFixtureWithPanic(runner.tearDownTest, testName, nil, nil) + skipped = false + } + }) +} + +// Same as forkTest(), but wait for the test to finish before returning. +func (runner *suiteRunner) runTest(method *methodType) *C { + c := runner.forkTest(method) + <-c.done + return c +} + +// Helper to mark tests as skipped or missed. A bit heavy for what +// it does, but it enables homogeneous handling of tracking, including +// nice verbose output. +func (runner *suiteRunner) skipTests(status funcStatus, methods []*methodType) { + for _, method := range methods { + runner.runFunc(method, testKd, "", nil, func(c *C) { + c.status = status + }) + } +} + +// Verify if the fixture arguments are *check.C. In case of errors, +// log the error as a panic in the fixture method call, and return false. +func (runner *suiteRunner) checkFixtureArgs() bool { + succeeded := true + argType := reflect.TypeOf(&C{}) + for _, method := range []*methodType{runner.setUpSuite, runner.tearDownSuite, runner.setUpTest, runner.tearDownTest} { + if method != nil { + mt := method.Type() + if mt.NumIn() != 1 || mt.In(0) != argType { + succeeded = false + runner.runFunc(method, fixtureKd, "", nil, func(c *C) { + c.logArgPanic(method, "*check.C") + c.status = panickedSt + }) + } + } + } + return succeeded +} + +func (runner *suiteRunner) reportCallStarted(c *C) { + runner.output.WriteCallStarted("START", c) +} + +func (runner *suiteRunner) reportCallDone(c *C) { + runner.tracker.callDone(c) + switch c.status { + case succeededSt: + if c.mustFail { + runner.output.WriteCallSuccess("FAIL EXPECTED", c) + } else { + runner.output.WriteCallSuccess("PASS", c) + } + case skippedSt: + runner.output.WriteCallSuccess("SKIP", c) + case failedSt: + runner.output.WriteCallProblem("FAIL", c) + case panickedSt: + runner.output.WriteCallProblem("PANIC", c) + case fixturePanickedSt: + // That's a testKd call reporting that its fixture + // has panicked. The fixture call which caused the + // panic itself was tracked above. We'll report to + // aid debugging. + runner.output.WriteCallProblem("PANIC", c) + case missedSt: + runner.output.WriteCallSuccess("MISS", c) + } +} + +// ----------------------------------------------------------------------- +// Output writer manages atomic output writing according to settings. + +type outputWriter struct { + m sync.Mutex + writer io.Writer + wroteCallProblemLast bool + Stream bool + Verbose bool +} + +func newOutputWriter(writer io.Writer, stream, verbose bool) *outputWriter { + return &outputWriter{writer: writer, Stream: stream, Verbose: verbose} +} + +func (ow *outputWriter) Write(content []byte) (n int, err error) { + ow.m.Lock() + n, err = ow.writer.Write(content) + ow.m.Unlock() + return +} + +func (ow *outputWriter) WriteCallStarted(label string, c *C) { + if ow.Stream { + header := renderCallHeader(label, c, "", "\n") + ow.m.Lock() + ow.writer.Write([]byte(header)) + ow.m.Unlock() + } +} + +func (ow *outputWriter) WriteCallProblem(label string, c *C) { + var prefix string + if !ow.Stream { + prefix = "\n-----------------------------------" + + "-----------------------------------\n" + } + header := renderCallHeader(label, c, prefix, "\n\n") + ow.m.Lock() + ow.wroteCallProblemLast = true + ow.writer.Write([]byte(header)) + if !ow.Stream { + c.logb.WriteTo(ow.writer) + } + ow.m.Unlock() +} + +func (ow *outputWriter) WriteCallSuccess(label string, c *C) { + if ow.Stream || (ow.Verbose && c.kind == testKd) { + // TODO Use a buffer here. + var suffix string + if c.reason != "" { + suffix = " (" + c.reason + ")" + } + if c.status == succeededSt { + suffix += "\t" + c.timerString() + } + suffix += "\n" + if ow.Stream { + suffix += "\n" + } + header := renderCallHeader(label, c, "", suffix) + ow.m.Lock() + // Resist temptation of using line as prefix above due to race. + if !ow.Stream && ow.wroteCallProblemLast { + header = "\n-----------------------------------" + + "-----------------------------------\n" + + header + } + ow.wroteCallProblemLast = false + ow.writer.Write([]byte(header)) + ow.m.Unlock() + } +} + +func renderCallHeader(label string, c *C, prefix, suffix string) string { + pc := c.method.PC() + return fmt.Sprintf("%s%s: %s: %s%s", prefix, label, niceFuncPath(pc), + niceFuncName(pc), suffix) +} diff --git a/vendor/src/github.com/go-check/check/checkers.go b/vendor/src/github.com/go-check/check/checkers.go new file mode 100644 index 0000000000..bac338729c --- /dev/null +++ b/vendor/src/github.com/go-check/check/checkers.go @@ -0,0 +1,458 @@ +package check + +import ( + "fmt" + "reflect" + "regexp" +) + +// ----------------------------------------------------------------------- +// CommentInterface and Commentf helper, to attach extra information to checks. + +type comment struct { + format string + args []interface{} +} + +// Commentf returns an infomational value to use with Assert or Check calls. +// If the checker test fails, the provided arguments will be passed to +// fmt.Sprintf, and will be presented next to the logged failure. +// +// For example: +// +// c.Assert(v, Equals, 42, Commentf("Iteration #%d failed.", i)) +// +// Note that if the comment is constant, a better option is to +// simply use a normal comment right above or next to the line, as +// it will also get printed with any errors: +// +// c.Assert(l, Equals, 8192) // Ensure buffer size is correct (bug #123) +// +func Commentf(format string, args ...interface{}) CommentInterface { + return &comment{format, args} +} + +// CommentInterface must be implemented by types that attach extra +// information to failed checks. See the Commentf function for details. +type CommentInterface interface { + CheckCommentString() string +} + +func (c *comment) CheckCommentString() string { + return fmt.Sprintf(c.format, c.args...) +} + +// ----------------------------------------------------------------------- +// The Checker interface. + +// The Checker interface must be provided by checkers used with +// the Assert and Check verification methods. +type Checker interface { + Info() *CheckerInfo + Check(params []interface{}, names []string) (result bool, error string) +} + +// See the Checker interface. +type CheckerInfo struct { + Name string + Params []string +} + +func (info *CheckerInfo) Info() *CheckerInfo { + return info +} + +// ----------------------------------------------------------------------- +// Not checker logic inverter. + +// The Not checker inverts the logic of the provided checker. The +// resulting checker will succeed where the original one failed, and +// vice-versa. +// +// For example: +// +// c.Assert(a, Not(Equals), b) +// +func Not(checker Checker) Checker { + return ¬Checker{checker} +} + +type notChecker struct { + sub Checker +} + +func (checker *notChecker) Info() *CheckerInfo { + info := *checker.sub.Info() + info.Name = "Not(" + info.Name + ")" + return &info +} + +func (checker *notChecker) Check(params []interface{}, names []string) (result bool, error string) { + result, error = checker.sub.Check(params, names) + result = !result + return +} + +// ----------------------------------------------------------------------- +// IsNil checker. + +type isNilChecker struct { + *CheckerInfo +} + +// The IsNil checker tests whether the obtained value is nil. +// +// For example: +// +// c.Assert(err, IsNil) +// +var IsNil Checker = &isNilChecker{ + &CheckerInfo{Name: "IsNil", Params: []string{"value"}}, +} + +func (checker *isNilChecker) Check(params []interface{}, names []string) (result bool, error string) { + return isNil(params[0]), "" +} + +func isNil(obtained interface{}) (result bool) { + if obtained == nil { + result = true + } else { + switch v := reflect.ValueOf(obtained); v.Kind() { + case reflect.Chan, reflect.Func, reflect.Interface, reflect.Map, reflect.Ptr, reflect.Slice: + return v.IsNil() + } + } + return +} + +// ----------------------------------------------------------------------- +// NotNil checker. Alias for Not(IsNil), since it's so common. + +type notNilChecker struct { + *CheckerInfo +} + +// The NotNil checker verifies that the obtained value is not nil. +// +// For example: +// +// c.Assert(iface, NotNil) +// +// This is an alias for Not(IsNil), made available since it's a +// fairly common check. +// +var NotNil Checker = ¬NilChecker{ + &CheckerInfo{Name: "NotNil", Params: []string{"value"}}, +} + +func (checker *notNilChecker) Check(params []interface{}, names []string) (result bool, error string) { + return !isNil(params[0]), "" +} + +// ----------------------------------------------------------------------- +// Equals checker. + +type equalsChecker struct { + *CheckerInfo +} + +// The Equals checker verifies that the obtained value is equal to +// the expected value, according to usual Go semantics for ==. +// +// For example: +// +// c.Assert(value, Equals, 42) +// +var Equals Checker = &equalsChecker{ + &CheckerInfo{Name: "Equals", Params: []string{"obtained", "expected"}}, +} + +func (checker *equalsChecker) Check(params []interface{}, names []string) (result bool, error string) { + defer func() { + if v := recover(); v != nil { + result = false + error = fmt.Sprint(v) + } + }() + return params[0] == params[1], "" +} + +// ----------------------------------------------------------------------- +// DeepEquals checker. + +type deepEqualsChecker struct { + *CheckerInfo +} + +// The DeepEquals checker verifies that the obtained value is deep-equal to +// the expected value. The check will work correctly even when facing +// slices, interfaces, and values of different types (which always fail +// the test). +// +// For example: +// +// c.Assert(value, DeepEquals, 42) +// c.Assert(array, DeepEquals, []string{"hi", "there"}) +// +var DeepEquals Checker = &deepEqualsChecker{ + &CheckerInfo{Name: "DeepEquals", Params: []string{"obtained", "expected"}}, +} + +func (checker *deepEqualsChecker) Check(params []interface{}, names []string) (result bool, error string) { + return reflect.DeepEqual(params[0], params[1]), "" +} + +// ----------------------------------------------------------------------- +// HasLen checker. + +type hasLenChecker struct { + *CheckerInfo +} + +// The HasLen checker verifies that the obtained value has the +// provided length. In many cases this is superior to using Equals +// in conjuction with the len function because in case the check +// fails the value itself will be printed, instead of its length, +// providing more details for figuring the problem. +// +// For example: +// +// c.Assert(list, HasLen, 5) +// +var HasLen Checker = &hasLenChecker{ + &CheckerInfo{Name: "HasLen", Params: []string{"obtained", "n"}}, +} + +func (checker *hasLenChecker) Check(params []interface{}, names []string) (result bool, error string) { + n, ok := params[1].(int) + if !ok { + return false, "n must be an int" + } + value := reflect.ValueOf(params[0]) + switch value.Kind() { + case reflect.Map, reflect.Array, reflect.Slice, reflect.Chan, reflect.String: + default: + return false, "obtained value type has no length" + } + return value.Len() == n, "" +} + +// ----------------------------------------------------------------------- +// ErrorMatches checker. + +type errorMatchesChecker struct { + *CheckerInfo +} + +// The ErrorMatches checker verifies that the error value +// is non nil and matches the regular expression provided. +// +// For example: +// +// c.Assert(err, ErrorMatches, "perm.*denied") +// +var ErrorMatches Checker = errorMatchesChecker{ + &CheckerInfo{Name: "ErrorMatches", Params: []string{"value", "regex"}}, +} + +func (checker errorMatchesChecker) Check(params []interface{}, names []string) (result bool, errStr string) { + if params[0] == nil { + return false, "Error value is nil" + } + err, ok := params[0].(error) + if !ok { + return false, "Value is not an error" + } + params[0] = err.Error() + names[0] = "error" + return matches(params[0], params[1]) +} + +// ----------------------------------------------------------------------- +// Matches checker. + +type matchesChecker struct { + *CheckerInfo +} + +// The Matches checker verifies that the string provided as the obtained +// value (or the string resulting from obtained.String()) matches the +// regular expression provided. +// +// For example: +// +// c.Assert(err, Matches, "perm.*denied") +// +var Matches Checker = &matchesChecker{ + &CheckerInfo{Name: "Matches", Params: []string{"value", "regex"}}, +} + +func (checker *matchesChecker) Check(params []interface{}, names []string) (result bool, error string) { + return matches(params[0], params[1]) +} + +func matches(value, regex interface{}) (result bool, error string) { + reStr, ok := regex.(string) + if !ok { + return false, "Regex must be a string" + } + valueStr, valueIsStr := value.(string) + if !valueIsStr { + if valueWithStr, valueHasStr := value.(fmt.Stringer); valueHasStr { + valueStr, valueIsStr = valueWithStr.String(), true + } + } + if valueIsStr { + matches, err := regexp.MatchString("^"+reStr+"$", valueStr) + if err != nil { + return false, "Can't compile regex: " + err.Error() + } + return matches, "" + } + return false, "Obtained value is not a string and has no .String()" +} + +// ----------------------------------------------------------------------- +// Panics checker. + +type panicsChecker struct { + *CheckerInfo +} + +// The Panics checker verifies that calling the provided zero-argument +// function will cause a panic which is deep-equal to the provided value. +// +// For example: +// +// c.Assert(func() { f(1, 2) }, Panics, &SomeErrorType{"BOOM"}). +// +// +var Panics Checker = &panicsChecker{ + &CheckerInfo{Name: "Panics", Params: []string{"function", "expected"}}, +} + +func (checker *panicsChecker) Check(params []interface{}, names []string) (result bool, error string) { + f := reflect.ValueOf(params[0]) + if f.Kind() != reflect.Func || f.Type().NumIn() != 0 { + return false, "Function must take zero arguments" + } + defer func() { + // If the function has not panicked, then don't do the check. + if error != "" { + return + } + params[0] = recover() + names[0] = "panic" + result = reflect.DeepEqual(params[0], params[1]) + }() + f.Call(nil) + return false, "Function has not panicked" +} + +type panicMatchesChecker struct { + *CheckerInfo +} + +// The PanicMatches checker verifies that calling the provided zero-argument +// function will cause a panic with an error value matching +// the regular expression provided. +// +// For example: +// +// c.Assert(func() { f(1, 2) }, PanicMatches, `open.*: no such file or directory`). +// +// +var PanicMatches Checker = &panicMatchesChecker{ + &CheckerInfo{Name: "PanicMatches", Params: []string{"function", "expected"}}, +} + +func (checker *panicMatchesChecker) Check(params []interface{}, names []string) (result bool, errmsg string) { + f := reflect.ValueOf(params[0]) + if f.Kind() != reflect.Func || f.Type().NumIn() != 0 { + return false, "Function must take zero arguments" + } + defer func() { + // If the function has not panicked, then don't do the check. + if errmsg != "" { + return + } + obtained := recover() + names[0] = "panic" + if e, ok := obtained.(error); ok { + params[0] = e.Error() + } else if _, ok := obtained.(string); ok { + params[0] = obtained + } else { + errmsg = "Panic value is not a string or an error" + return + } + result, errmsg = matches(params[0], params[1]) + }() + f.Call(nil) + return false, "Function has not panicked" +} + +// ----------------------------------------------------------------------- +// FitsTypeOf checker. + +type fitsTypeChecker struct { + *CheckerInfo +} + +// The FitsTypeOf checker verifies that the obtained value is +// assignable to a variable with the same type as the provided +// sample value. +// +// For example: +// +// c.Assert(value, FitsTypeOf, int64(0)) +// c.Assert(value, FitsTypeOf, os.Error(nil)) +// +var FitsTypeOf Checker = &fitsTypeChecker{ + &CheckerInfo{Name: "FitsTypeOf", Params: []string{"obtained", "sample"}}, +} + +func (checker *fitsTypeChecker) Check(params []interface{}, names []string) (result bool, error string) { + obtained := reflect.ValueOf(params[0]) + sample := reflect.ValueOf(params[1]) + if !obtained.IsValid() { + return false, "" + } + if !sample.IsValid() { + return false, "Invalid sample value" + } + return obtained.Type().AssignableTo(sample.Type()), "" +} + +// ----------------------------------------------------------------------- +// Implements checker. + +type implementsChecker struct { + *CheckerInfo +} + +// The Implements checker verifies that the obtained value +// implements the interface specified via a pointer to an interface +// variable. +// +// For example: +// +// var e os.Error +// c.Assert(err, Implements, &e) +// +var Implements Checker = &implementsChecker{ + &CheckerInfo{Name: "Implements", Params: []string{"obtained", "ifaceptr"}}, +} + +func (checker *implementsChecker) Check(params []interface{}, names []string) (result bool, error string) { + obtained := reflect.ValueOf(params[0]) + ifaceptr := reflect.ValueOf(params[1]) + if !obtained.IsValid() { + return false, "" + } + if !ifaceptr.IsValid() || ifaceptr.Kind() != reflect.Ptr || ifaceptr.Elem().Kind() != reflect.Interface { + return false, "ifaceptr should be a pointer to an interface variable" + } + return obtained.Type().Implements(ifaceptr.Elem().Type()), "" +} diff --git a/vendor/src/github.com/go-check/check/helpers.go b/vendor/src/github.com/go-check/check/helpers.go new file mode 100644 index 0000000000..4b6c26da45 --- /dev/null +++ b/vendor/src/github.com/go-check/check/helpers.go @@ -0,0 +1,231 @@ +package check + +import ( + "fmt" + "strings" + "time" +) + +// TestName returns the current test name in the form "SuiteName.TestName" +func (c *C) TestName() string { + return c.testName +} + +// ----------------------------------------------------------------------- +// Basic succeeding/failing logic. + +// Failed returns whether the currently running test has already failed. +func (c *C) Failed() bool { + return c.status == failedSt +} + +// Fail marks the currently running test as failed. +// +// Something ought to have been previously logged so the developer can tell +// what went wrong. The higher level helper functions will fail the test +// and do the logging properly. +func (c *C) Fail() { + c.status = failedSt +} + +// FailNow marks the currently running test as failed and stops running it. +// Something ought to have been previously logged so the developer can tell +// what went wrong. The higher level helper functions will fail the test +// and do the logging properly. +func (c *C) FailNow() { + c.Fail() + c.stopNow() +} + +// Succeed marks the currently running test as succeeded, undoing any +// previous failures. +func (c *C) Succeed() { + c.status = succeededSt +} + +// SucceedNow marks the currently running test as succeeded, undoing any +// previous failures, and stops running the test. +func (c *C) SucceedNow() { + c.Succeed() + c.stopNow() +} + +// ExpectFailure informs that the running test is knowingly broken for +// the provided reason. If the test does not fail, an error will be reported +// to raise attention to this fact. This method is useful to temporarily +// disable tests which cover well known problems until a better time to +// fix the problem is found, without forgetting about the fact that a +// failure still exists. +func (c *C) ExpectFailure(reason string) { + if reason == "" { + panic("Missing reason why the test is expected to fail") + } + c.mustFail = true + c.reason = reason +} + +// Skip skips the running test for the provided reason. If run from within +// SetUpTest, the individual test being set up will be skipped, and if run +// from within SetUpSuite, the whole suite is skipped. +func (c *C) Skip(reason string) { + if reason == "" { + panic("Missing reason why the test is being skipped") + } + c.reason = reason + c.status = skippedSt + c.stopNow() +} + +// ----------------------------------------------------------------------- +// Basic logging. + +// GetTestLog returns the current test error output. +func (c *C) GetTestLog() string { + return c.logb.String() +} + +// Log logs some information into the test error output. +// The provided arguments are assembled together into a string with fmt.Sprint. +func (c *C) Log(args ...interface{}) { + c.log(args...) +} + +// Log logs some information into the test error output. +// The provided arguments are assembled together into a string with fmt.Sprintf. +func (c *C) Logf(format string, args ...interface{}) { + c.logf(format, args...) +} + +// Output enables *C to be used as a logger in functions that require only +// the minimum interface of *log.Logger. +func (c *C) Output(calldepth int, s string) error { + d := time.Now().Sub(c.startTime) + msec := d / time.Millisecond + sec := d / time.Second + min := d / time.Minute + + c.Logf("[LOG] %d:%02d.%03d %s", min, sec%60, msec%1000, s) + return nil +} + +// Error logs an error into the test error output and marks the test as failed. +// The provided arguments are assembled together into a string with fmt.Sprint. +func (c *C) Error(args ...interface{}) { + c.logCaller(1) + c.logString(fmt.Sprint("Error: ", fmt.Sprint(args...))) + c.logNewLine() + c.Fail() +} + +// Errorf logs an error into the test error output and marks the test as failed. +// The provided arguments are assembled together into a string with fmt.Sprintf. +func (c *C) Errorf(format string, args ...interface{}) { + c.logCaller(1) + c.logString(fmt.Sprintf("Error: "+format, args...)) + c.logNewLine() + c.Fail() +} + +// Fatal logs an error into the test error output, marks the test as failed, and +// stops the test execution. The provided arguments are assembled together into +// a string with fmt.Sprint. +func (c *C) Fatal(args ...interface{}) { + c.logCaller(1) + c.logString(fmt.Sprint("Error: ", fmt.Sprint(args...))) + c.logNewLine() + c.FailNow() +} + +// Fatlaf logs an error into the test error output, marks the test as failed, and +// stops the test execution. The provided arguments are assembled together into +// a string with fmt.Sprintf. +func (c *C) Fatalf(format string, args ...interface{}) { + c.logCaller(1) + c.logString(fmt.Sprint("Error: ", fmt.Sprintf(format, args...))) + c.logNewLine() + c.FailNow() +} + +// ----------------------------------------------------------------------- +// Generic checks and assertions based on checkers. + +// Check verifies if the first value matches the expected value according +// to the provided checker. If they do not match, an error is logged, the +// test is marked as failed, and the test execution continues. +// +// Some checkers may not need the expected argument (e.g. IsNil). +// +// Extra arguments provided to the function are logged next to the reported +// problem when the matching fails. +func (c *C) Check(obtained interface{}, checker Checker, args ...interface{}) bool { + return c.internalCheck("Check", obtained, checker, args...) +} + +// Assert ensures that the first value matches the expected value according +// to the provided checker. If they do not match, an error is logged, the +// test is marked as failed, and the test execution stops. +// +// Some checkers may not need the expected argument (e.g. IsNil). +// +// Extra arguments provided to the function are logged next to the reported +// problem when the matching fails. +func (c *C) Assert(obtained interface{}, checker Checker, args ...interface{}) { + if !c.internalCheck("Assert", obtained, checker, args...) { + c.stopNow() + } +} + +func (c *C) internalCheck(funcName string, obtained interface{}, checker Checker, args ...interface{}) bool { + if checker == nil { + c.logCaller(2) + c.logString(fmt.Sprintf("%s(obtained, nil!?, ...):", funcName)) + c.logString("Oops.. you've provided a nil checker!") + c.logNewLine() + c.Fail() + return false + } + + // If the last argument is a bug info, extract it out. + var comment CommentInterface + if len(args) > 0 { + if c, ok := args[len(args)-1].(CommentInterface); ok { + comment = c + args = args[:len(args)-1] + } + } + + params := append([]interface{}{obtained}, args...) + info := checker.Info() + + if len(params) != len(info.Params) { + names := append([]string{info.Params[0], info.Name}, info.Params[1:]...) + c.logCaller(2) + c.logString(fmt.Sprintf("%s(%s):", funcName, strings.Join(names, ", "))) + c.logString(fmt.Sprintf("Wrong number of parameters for %s: want %d, got %d", info.Name, len(names), len(params)+1)) + c.logNewLine() + c.Fail() + return false + } + + // Copy since it may be mutated by Check. + names := append([]string{}, info.Params...) + + // Do the actual check. + result, error := checker.Check(params, names) + if !result || error != "" { + c.logCaller(2) + for i := 0; i != len(params); i++ { + c.logValue(names[i], params[i]) + } + if comment != nil { + c.logString(comment.CheckCommentString()) + } + if error != "" { + c.logString(error) + } + c.logNewLine() + c.Fail() + return false + } + return true +} diff --git a/vendor/src/github.com/go-check/check/printer.go b/vendor/src/github.com/go-check/check/printer.go new file mode 100644 index 0000000000..e0f7557b5c --- /dev/null +++ b/vendor/src/github.com/go-check/check/printer.go @@ -0,0 +1,168 @@ +package check + +import ( + "bytes" + "go/ast" + "go/parser" + "go/printer" + "go/token" + "os" +) + +func indent(s, with string) (r string) { + eol := true + for i := 0; i != len(s); i++ { + c := s[i] + switch { + case eol && c == '\n' || c == '\r': + case c == '\n' || c == '\r': + eol = true + case eol: + eol = false + s = s[:i] + with + s[i:] + i += len(with) + } + } + return s +} + +func printLine(filename string, line int) (string, error) { + fset := token.NewFileSet() + file, err := os.Open(filename) + if err != nil { + return "", err + } + fnode, err := parser.ParseFile(fset, filename, file, parser.ParseComments) + if err != nil { + return "", err + } + config := &printer.Config{Mode: printer.UseSpaces, Tabwidth: 4} + lp := &linePrinter{fset: fset, fnode: fnode, line: line, config: config} + ast.Walk(lp, fnode) + result := lp.output.Bytes() + // Comments leave \n at the end. + n := len(result) + for n > 0 && result[n-1] == '\n' { + n-- + } + return string(result[:n]), nil +} + +type linePrinter struct { + config *printer.Config + fset *token.FileSet + fnode *ast.File + line int + output bytes.Buffer + stmt ast.Stmt +} + +func (lp *linePrinter) emit() bool { + if lp.stmt != nil { + lp.trim(lp.stmt) + lp.printWithComments(lp.stmt) + lp.stmt = nil + return true + } + return false +} + +func (lp *linePrinter) printWithComments(n ast.Node) { + nfirst := lp.fset.Position(n.Pos()).Line + nlast := lp.fset.Position(n.End()).Line + for _, g := range lp.fnode.Comments { + cfirst := lp.fset.Position(g.Pos()).Line + clast := lp.fset.Position(g.End()).Line + if clast == nfirst-1 && lp.fset.Position(n.Pos()).Column == lp.fset.Position(g.Pos()).Column { + for _, c := range g.List { + lp.output.WriteString(c.Text) + lp.output.WriteByte('\n') + } + } + if cfirst >= nfirst && cfirst <= nlast && n.End() <= g.List[0].Slash { + // The printer will not include the comment if it starts past + // the node itself. Trick it into printing by overlapping the + // slash with the end of the statement. + g.List[0].Slash = n.End() - 1 + } + } + node := &printer.CommentedNode{n, lp.fnode.Comments} + lp.config.Fprint(&lp.output, lp.fset, node) +} + +func (lp *linePrinter) Visit(n ast.Node) (w ast.Visitor) { + if n == nil { + if lp.output.Len() == 0 { + lp.emit() + } + return nil + } + first := lp.fset.Position(n.Pos()).Line + last := lp.fset.Position(n.End()).Line + if first <= lp.line && last >= lp.line { + // Print the innermost statement containing the line. + if stmt, ok := n.(ast.Stmt); ok { + if _, ok := n.(*ast.BlockStmt); !ok { + lp.stmt = stmt + } + } + if first == lp.line && lp.emit() { + return nil + } + return lp + } + return nil +} + +func (lp *linePrinter) trim(n ast.Node) bool { + stmt, ok := n.(ast.Stmt) + if !ok { + return true + } + line := lp.fset.Position(n.Pos()).Line + if line != lp.line { + return false + } + switch stmt := stmt.(type) { + case *ast.IfStmt: + stmt.Body = lp.trimBlock(stmt.Body) + case *ast.SwitchStmt: + stmt.Body = lp.trimBlock(stmt.Body) + case *ast.TypeSwitchStmt: + stmt.Body = lp.trimBlock(stmt.Body) + case *ast.CaseClause: + stmt.Body = lp.trimList(stmt.Body) + case *ast.CommClause: + stmt.Body = lp.trimList(stmt.Body) + case *ast.BlockStmt: + stmt.List = lp.trimList(stmt.List) + } + return true +} + +func (lp *linePrinter) trimBlock(stmt *ast.BlockStmt) *ast.BlockStmt { + if !lp.trim(stmt) { + return lp.emptyBlock(stmt) + } + stmt.Rbrace = stmt.Lbrace + return stmt +} + +func (lp *linePrinter) trimList(stmts []ast.Stmt) []ast.Stmt { + for i := 0; i != len(stmts); i++ { + if !lp.trim(stmts[i]) { + stmts[i] = lp.emptyStmt(stmts[i]) + break + } + } + return stmts +} + +func (lp *linePrinter) emptyStmt(n ast.Node) *ast.ExprStmt { + return &ast.ExprStmt{&ast.Ellipsis{n.Pos(), nil}} +} + +func (lp *linePrinter) emptyBlock(n ast.Node) *ast.BlockStmt { + p := n.Pos() + return &ast.BlockStmt{p, []ast.Stmt{lp.emptyStmt(n)}, p} +} diff --git a/vendor/src/github.com/go-check/check/run.go b/vendor/src/github.com/go-check/check/run.go new file mode 100644 index 0000000000..da8fd79872 --- /dev/null +++ b/vendor/src/github.com/go-check/check/run.go @@ -0,0 +1,175 @@ +package check + +import ( + "bufio" + "flag" + "fmt" + "os" + "testing" + "time" +) + +// ----------------------------------------------------------------------- +// Test suite registry. + +var allSuites []interface{} + +// Suite registers the given value as a test suite to be run. Any methods +// starting with the Test prefix in the given value will be considered as +// a test method. +func Suite(suite interface{}) interface{} { + allSuites = append(allSuites, suite) + return suite +} + +// ----------------------------------------------------------------------- +// Public running interface. + +var ( + oldFilterFlag = flag.String("gocheck.f", "", "Regular expression selecting which tests and/or suites to run") + oldVerboseFlag = flag.Bool("gocheck.v", false, "Verbose mode") + oldStreamFlag = flag.Bool("gocheck.vv", false, "Super verbose mode (disables output caching)") + oldBenchFlag = flag.Bool("gocheck.b", false, "Run benchmarks") + oldBenchTime = flag.Duration("gocheck.btime", 1*time.Second, "approximate run time for each benchmark") + oldListFlag = flag.Bool("gocheck.list", false, "List the names of all tests that will be run") + oldWorkFlag = flag.Bool("gocheck.work", false, "Display and do not remove the test working directory") + + newFilterFlag = flag.String("check.f", "", "Regular expression selecting which tests and/or suites to run") + newVerboseFlag = flag.Bool("check.v", false, "Verbose mode") + newStreamFlag = flag.Bool("check.vv", false, "Super verbose mode (disables output caching)") + newBenchFlag = flag.Bool("check.b", false, "Run benchmarks") + newBenchTime = flag.Duration("check.btime", 1*time.Second, "approximate run time for each benchmark") + newBenchMem = flag.Bool("check.bmem", false, "Report memory benchmarks") + newListFlag = flag.Bool("check.list", false, "List the names of all tests that will be run") + newWorkFlag = flag.Bool("check.work", false, "Display and do not remove the test working directory") +) + +// TestingT runs all test suites registered with the Suite function, +// printing results to stdout, and reporting any failures back to +// the "testing" package. +func TestingT(testingT *testing.T) { + benchTime := *newBenchTime + if benchTime == 1*time.Second { + benchTime = *oldBenchTime + } + conf := &RunConf{ + Filter: *oldFilterFlag + *newFilterFlag, + Verbose: *oldVerboseFlag || *newVerboseFlag, + Stream: *oldStreamFlag || *newStreamFlag, + Benchmark: *oldBenchFlag || *newBenchFlag, + BenchmarkTime: benchTime, + BenchmarkMem: *newBenchMem, + KeepWorkDir: *oldWorkFlag || *newWorkFlag, + } + if *oldListFlag || *newListFlag { + w := bufio.NewWriter(os.Stdout) + for _, name := range ListAll(conf) { + fmt.Fprintln(w, name) + } + w.Flush() + return + } + result := RunAll(conf) + println(result.String()) + if !result.Passed() { + testingT.Fail() + } +} + +// RunAll runs all test suites registered with the Suite function, using the +// provided run configuration. +func RunAll(runConf *RunConf) *Result { + result := Result{} + for _, suite := range allSuites { + result.Add(Run(suite, runConf)) + } + return &result +} + +// Run runs the provided test suite using the provided run configuration. +func Run(suite interface{}, runConf *RunConf) *Result { + runner := newSuiteRunner(suite, runConf) + return runner.run() +} + +// ListAll returns the names of all the test functions registered with the +// Suite function that will be run with the provided run configuration. +func ListAll(runConf *RunConf) []string { + var names []string + for _, suite := range allSuites { + names = append(names, List(suite, runConf)...) + } + return names +} + +// List returns the names of the test functions in the given +// suite that will be run with the provided run configuration. +func List(suite interface{}, runConf *RunConf) []string { + var names []string + runner := newSuiteRunner(suite, runConf) + for _, t := range runner.tests { + names = append(names, t.String()) + } + return names +} + +// ----------------------------------------------------------------------- +// Result methods. + +func (r *Result) Add(other *Result) { + r.Succeeded += other.Succeeded + r.Skipped += other.Skipped + r.Failed += other.Failed + r.Panicked += other.Panicked + r.FixturePanicked += other.FixturePanicked + r.ExpectedFailures += other.ExpectedFailures + r.Missed += other.Missed + if r.WorkDir != "" && other.WorkDir != "" { + r.WorkDir += ":" + other.WorkDir + } else if other.WorkDir != "" { + r.WorkDir = other.WorkDir + } +} + +func (r *Result) Passed() bool { + return (r.Failed == 0 && r.Panicked == 0 && + r.FixturePanicked == 0 && r.Missed == 0 && + r.RunError == nil) +} + +func (r *Result) String() string { + if r.RunError != nil { + return "ERROR: " + r.RunError.Error() + } + + var value string + if r.Failed == 0 && r.Panicked == 0 && r.FixturePanicked == 0 && + r.Missed == 0 { + value = "OK: " + } else { + value = "OOPS: " + } + value += fmt.Sprintf("%d passed", r.Succeeded) + if r.Skipped != 0 { + value += fmt.Sprintf(", %d skipped", r.Skipped) + } + if r.ExpectedFailures != 0 { + value += fmt.Sprintf(", %d expected failures", r.ExpectedFailures) + } + if r.Failed != 0 { + value += fmt.Sprintf(", %d FAILED", r.Failed) + } + if r.Panicked != 0 { + value += fmt.Sprintf(", %d PANICKED", r.Panicked) + } + if r.FixturePanicked != 0 { + value += fmt.Sprintf(", %d FIXTURE-PANICKED", r.FixturePanicked) + } + if r.Missed != 0 { + value += fmt.Sprintf(", %d MISSED", r.Missed) + } + if r.WorkDir != "" { + value += "\nWORK=" + r.WorkDir + } + return value +} diff --git a/vendor/src/github.com/godbus/dbus/CONTRIBUTING.md b/vendor/src/github.com/godbus/dbus/CONTRIBUTING.md new file mode 100644 index 0000000000..c88f9b2bdd --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/CONTRIBUTING.md @@ -0,0 +1,50 @@ +# How to Contribute + +## Getting Started + +- Fork the repository on GitHub +- Read the [README](README.markdown) for build and test instructions +- Play with the project, submit bugs, submit patches! + +## Contribution Flow + +This is a rough outline of what a contributor's workflow looks like: + +- Create a topic branch from where you want to base your work (usually master). +- Make commits of logical units. +- Make sure your commit messages are in the proper format (see below). +- Push your changes to a topic branch in your fork of the repository. +- Make sure the tests pass, and add any new tests as appropriate. +- Submit a pull request to the original repository. + +Thanks for your contributions! + +### Format of the Commit Message + +We follow a rough convention for commit messages that is designed to answer two +questions: what changed and why. The subject line should feature the what and +the body of the commit should describe the why. + +``` +scripts: add the test-cluster command + +this uses tmux to setup a test cluster that you can easily kill and +start for debugging. + +Fixes #38 +``` + +The format can be described more formally as follows: + +``` +: + + + +
+``` + +The first line is the subject and should be no longer than 70 characters, the +second line is always blank, and other lines should be wrapped at 80 characters. +This allows the message to be easier to read on GitHub as well as in various +git tools. diff --git a/vendor/src/github.com/godbus/dbus/LICENSE b/vendor/src/github.com/godbus/dbus/LICENSE new file mode 100644 index 0000000000..06b252bcbc --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/LICENSE @@ -0,0 +1,25 @@ +Copyright (c) 2013, Georg Reinke () +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +1. Redistributions of source code must retain the above copyright notice, +this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED +TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/godbus/dbus/MAINTAINERS b/vendor/src/github.com/godbus/dbus/MAINTAINERS new file mode 100644 index 0000000000..e8968ece7f --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/MAINTAINERS @@ -0,0 +1,2 @@ +Brandon Philips (@philips) +Brian Waldon (@bcwaldon) diff --git a/vendor/src/github.com/godbus/dbus/README.markdown b/vendor/src/github.com/godbus/dbus/README.markdown new file mode 100644 index 0000000000..3ab2116651 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/README.markdown @@ -0,0 +1,38 @@ +dbus +---- + +dbus is a simple library that implements native Go client bindings for the +D-Bus message bus system. + +### Features + +* Complete native implementation of the D-Bus message protocol +* Go-like API (channels for signals / asynchronous method calls, Goroutine-safe connections) +* Subpackages that help with the introspection / property interfaces + +### Installation + +This packages requires Go 1.1. If you installed it and set up your GOPATH, just run: + +``` +go get github.com/godbus/dbus +``` + +If you want to use the subpackages, you can install them the same way. + +### Usage + +The complete package documentation and some simple examples are available at +[godoc.org](http://godoc.org/github.com/godbus/dbus). Also, the +[_examples](https://github.com/godbus/dbus/tree/master/_examples) directory +gives a short overview over the basic usage. + +Please note that the API is considered unstable for now and may change without +further notice. + +### License + +go.dbus is available under the Simplified BSD License; see LICENSE for the full +text. + +Nearly all of the credit for this library goes to github.com/guelfey/go.dbus. diff --git a/vendor/src/github.com/godbus/dbus/auth.go b/vendor/src/github.com/godbus/dbus/auth.go new file mode 100644 index 0000000000..98017b693e --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/auth.go @@ -0,0 +1,253 @@ +package dbus + +import ( + "bufio" + "bytes" + "errors" + "io" + "os" + "strconv" +) + +// AuthStatus represents the Status of an authentication mechanism. +type AuthStatus byte + +const ( + // AuthOk signals that authentication is finished; the next command + // from the server should be an OK. + AuthOk AuthStatus = iota + + // AuthContinue signals that additional data is needed; the next command + // from the server should be a DATA. + AuthContinue + + // AuthError signals an error; the server sent invalid data or some + // other unexpected thing happened and the current authentication + // process should be aborted. + AuthError +) + +type authState byte + +const ( + waitingForData authState = iota + waitingForOk + waitingForReject +) + +// Auth defines the behaviour of an authentication mechanism. +type Auth interface { + // Return the name of the mechnism, the argument to the first AUTH command + // and the next status. + FirstData() (name, resp []byte, status AuthStatus) + + // Process the given DATA command, and return the argument to the DATA + // command and the next status. If len(resp) == 0, no DATA command is sent. + HandleData(data []byte) (resp []byte, status AuthStatus) +} + +// Auth authenticates the connection, trying the given list of authentication +// mechanisms (in that order). If nil is passed, the EXTERNAL and +// DBUS_COOKIE_SHA1 mechanisms are tried for the current user. For private +// connections, this method must be called before sending any messages to the +// bus. Auth must not be called on shared connections. +func (conn *Conn) Auth(methods []Auth) error { + if methods == nil { + uid := strconv.Itoa(os.Getuid()) + methods = []Auth{AuthExternal(uid), AuthCookieSha1(uid, getHomeDir())} + } + in := bufio.NewReader(conn.transport) + err := conn.transport.SendNullByte() + if err != nil { + return err + } + err = authWriteLine(conn.transport, []byte("AUTH")) + if err != nil { + return err + } + s, err := authReadLine(in) + if err != nil { + return err + } + if len(s) < 2 || !bytes.Equal(s[0], []byte("REJECTED")) { + return errors.New("dbus: authentication protocol error") + } + s = s[1:] + for _, v := range s { + for _, m := range methods { + if name, data, status := m.FirstData(); bytes.Equal(v, name) { + var ok bool + err = authWriteLine(conn.transport, []byte("AUTH"), []byte(v), data) + if err != nil { + return err + } + switch status { + case AuthOk: + err, ok = conn.tryAuth(m, waitingForOk, in) + case AuthContinue: + err, ok = conn.tryAuth(m, waitingForData, in) + default: + panic("dbus: invalid authentication status") + } + if err != nil { + return err + } + if ok { + if conn.transport.SupportsUnixFDs() { + err = authWriteLine(conn, []byte("NEGOTIATE_UNIX_FD")) + if err != nil { + return err + } + line, err := authReadLine(in) + if err != nil { + return err + } + switch { + case bytes.Equal(line[0], []byte("AGREE_UNIX_FD")): + conn.EnableUnixFDs() + conn.unixFD = true + case bytes.Equal(line[0], []byte("ERROR")): + default: + return errors.New("dbus: authentication protocol error") + } + } + err = authWriteLine(conn.transport, []byte("BEGIN")) + if err != nil { + return err + } + go conn.inWorker() + go conn.outWorker() + return nil + } + } + } + } + return errors.New("dbus: authentication failed") +} + +// tryAuth tries to authenticate with m as the mechanism, using state as the +// initial authState and in for reading input. It returns (nil, true) on +// success, (nil, false) on a REJECTED and (someErr, false) if some other +// error occured. +func (conn *Conn) tryAuth(m Auth, state authState, in *bufio.Reader) (error, bool) { + for { + s, err := authReadLine(in) + if err != nil { + return err, false + } + switch { + case state == waitingForData && string(s[0]) == "DATA": + if len(s) != 2 { + err = authWriteLine(conn.transport, []byte("ERROR")) + if err != nil { + return err, false + } + continue + } + data, status := m.HandleData(s[1]) + switch status { + case AuthOk, AuthContinue: + if len(data) != 0 { + err = authWriteLine(conn.transport, []byte("DATA"), data) + if err != nil { + return err, false + } + } + if status == AuthOk { + state = waitingForOk + } + case AuthError: + err = authWriteLine(conn.transport, []byte("ERROR")) + if err != nil { + return err, false + } + } + case state == waitingForData && string(s[0]) == "REJECTED": + return nil, false + case state == waitingForData && string(s[0]) == "ERROR": + err = authWriteLine(conn.transport, []byte("CANCEL")) + if err != nil { + return err, false + } + state = waitingForReject + case state == waitingForData && string(s[0]) == "OK": + if len(s) != 2 { + err = authWriteLine(conn.transport, []byte("CANCEL")) + if err != nil { + return err, false + } + state = waitingForReject + } + conn.uuid = string(s[1]) + return nil, true + case state == waitingForData: + err = authWriteLine(conn.transport, []byte("ERROR")) + if err != nil { + return err, false + } + case state == waitingForOk && string(s[0]) == "OK": + if len(s) != 2 { + err = authWriteLine(conn.transport, []byte("CANCEL")) + if err != nil { + return err, false + } + state = waitingForReject + } + conn.uuid = string(s[1]) + return nil, true + case state == waitingForOk && string(s[0]) == "REJECTED": + return nil, false + case state == waitingForOk && (string(s[0]) == "DATA" || + string(s[0]) == "ERROR"): + + err = authWriteLine(conn.transport, []byte("CANCEL")) + if err != nil { + return err, false + } + state = waitingForReject + case state == waitingForOk: + err = authWriteLine(conn.transport, []byte("ERROR")) + if err != nil { + return err, false + } + case state == waitingForReject && string(s[0]) == "REJECTED": + return nil, false + case state == waitingForReject: + return errors.New("dbus: authentication protocol error"), false + default: + panic("dbus: invalid auth state") + } + } +} + +// authReadLine reads a line and separates it into its fields. +func authReadLine(in *bufio.Reader) ([][]byte, error) { + data, err := in.ReadBytes('\n') + if err != nil { + return nil, err + } + data = bytes.TrimSuffix(data, []byte("\r\n")) + return bytes.Split(data, []byte{' '}), nil +} + +// authWriteLine writes the given line in the authentication protocol format +// (elements of data separated by a " " and terminated by "\r\n"). +func authWriteLine(out io.Writer, data ...[]byte) error { + buf := make([]byte, 0) + for i, v := range data { + buf = append(buf, v...) + if i != len(data)-1 { + buf = append(buf, ' ') + } + } + buf = append(buf, '\r') + buf = append(buf, '\n') + n, err := out.Write(buf) + if err != nil { + return err + } + if n != len(buf) { + return io.ErrUnexpectedEOF + } + return nil +} diff --git a/vendor/src/github.com/godbus/dbus/auth_external.go b/vendor/src/github.com/godbus/dbus/auth_external.go new file mode 100644 index 0000000000..7e376d3ef6 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/auth_external.go @@ -0,0 +1,26 @@ +package dbus + +import ( + "encoding/hex" +) + +// AuthExternal returns an Auth that authenticates as the given user with the +// EXTERNAL mechanism. +func AuthExternal(user string) Auth { + return authExternal{user} +} + +// AuthExternal implements the EXTERNAL authentication mechanism. +type authExternal struct { + user string +} + +func (a authExternal) FirstData() ([]byte, []byte, AuthStatus) { + b := make([]byte, 2*len(a.user)) + hex.Encode(b, []byte(a.user)) + return []byte("EXTERNAL"), b, AuthOk +} + +func (a authExternal) HandleData(b []byte) ([]byte, AuthStatus) { + return nil, AuthError +} diff --git a/vendor/src/github.com/godbus/dbus/auth_sha1.go b/vendor/src/github.com/godbus/dbus/auth_sha1.go new file mode 100644 index 0000000000..df15b46119 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/auth_sha1.go @@ -0,0 +1,102 @@ +package dbus + +import ( + "bufio" + "bytes" + "crypto/rand" + "crypto/sha1" + "encoding/hex" + "os" +) + +// AuthCookieSha1 returns an Auth that authenticates as the given user with the +// DBUS_COOKIE_SHA1 mechanism. The home parameter should specify the home +// directory of the user. +func AuthCookieSha1(user, home string) Auth { + return authCookieSha1{user, home} +} + +type authCookieSha1 struct { + user, home string +} + +func (a authCookieSha1) FirstData() ([]byte, []byte, AuthStatus) { + b := make([]byte, 2*len(a.user)) + hex.Encode(b, []byte(a.user)) + return []byte("DBUS_COOKIE_SHA1"), b, AuthContinue +} + +func (a authCookieSha1) HandleData(data []byte) ([]byte, AuthStatus) { + challenge := make([]byte, len(data)/2) + _, err := hex.Decode(challenge, data) + if err != nil { + return nil, AuthError + } + b := bytes.Split(challenge, []byte{' '}) + if len(b) != 3 { + return nil, AuthError + } + context := b[0] + id := b[1] + svchallenge := b[2] + cookie := a.getCookie(context, id) + if cookie == nil { + return nil, AuthError + } + clchallenge := a.generateChallenge() + if clchallenge == nil { + return nil, AuthError + } + hash := sha1.New() + hash.Write(bytes.Join([][]byte{svchallenge, clchallenge, cookie}, []byte{':'})) + hexhash := make([]byte, 2*hash.Size()) + hex.Encode(hexhash, hash.Sum(nil)) + data = append(clchallenge, ' ') + data = append(data, hexhash...) + resp := make([]byte, 2*len(data)) + hex.Encode(resp, data) + return resp, AuthOk +} + +// getCookie searches for the cookie identified by id in context and returns +// the cookie content or nil. (Since HandleData can't return a specific error, +// but only whether an error occured, this function also doesn't bother to +// return an error.) +func (a authCookieSha1) getCookie(context, id []byte) []byte { + file, err := os.Open(a.home + "/.dbus-keyrings/" + string(context)) + if err != nil { + return nil + } + defer file.Close() + rd := bufio.NewReader(file) + for { + line, err := rd.ReadBytes('\n') + if err != nil { + return nil + } + line = line[:len(line)-1] + b := bytes.Split(line, []byte{' '}) + if len(b) != 3 { + return nil + } + if bytes.Equal(b[0], id) { + return b[2] + } + } +} + +// generateChallenge returns a random, hex-encoded challenge, or nil on error +// (see above). +func (a authCookieSha1) generateChallenge() []byte { + b := make([]byte, 16) + n, err := rand.Read(b) + if err != nil { + return nil + } + if n != 16 { + return nil + } + enc := make([]byte, 32) + hex.Encode(enc, b) + return enc +} diff --git a/vendor/src/github.com/godbus/dbus/call.go b/vendor/src/github.com/godbus/dbus/call.go new file mode 100644 index 0000000000..1d2fbc7efd --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/call.go @@ -0,0 +1,147 @@ +package dbus + +import ( + "errors" + "strings" +) + +// Call represents a pending or completed method call. +type Call struct { + Destination string + Path ObjectPath + Method string + Args []interface{} + + // Strobes when the call is complete. + Done chan *Call + + // After completion, the error status. If this is non-nil, it may be an + // error message from the peer (with Error as its type) or some other error. + Err error + + // Holds the response once the call is done. + Body []interface{} +} + +var errSignature = errors.New("dbus: mismatched signature") + +// Store stores the body of the reply into the provided pointers. It returns +// an error if the signatures of the body and retvalues don't match, or if +// the error status is not nil. +func (c *Call) Store(retvalues ...interface{}) error { + if c.Err != nil { + return c.Err + } + + return Store(c.Body, retvalues...) +} + +// Object represents a remote object on which methods can be invoked. +type Object struct { + conn *Conn + dest string + path ObjectPath +} + +// Call calls a method with (*Object).Go and waits for its reply. +func (o *Object) Call(method string, flags Flags, args ...interface{}) *Call { + return <-o.Go(method, flags, make(chan *Call, 1), args...).Done +} + +// GetProperty calls org.freedesktop.DBus.Properties.GetProperty on the given +// object. The property name must be given in interface.member notation. +func (o *Object) GetProperty(p string) (Variant, error) { + idx := strings.LastIndex(p, ".") + if idx == -1 || idx+1 == len(p) { + return Variant{}, errors.New("dbus: invalid property " + p) + } + + iface := p[:idx] + prop := p[idx+1:] + + result := Variant{} + err := o.Call("org.freedesktop.DBus.Properties.Get", 0, iface, prop).Store(&result) + + if err != nil { + return Variant{}, err + } + + return result, nil +} + +// Go calls a method with the given arguments asynchronously. It returns a +// Call structure representing this method call. The passed channel will +// return the same value once the call is done. If ch is nil, a new channel +// will be allocated. Otherwise, ch has to be buffered or Go will panic. +// +// If the flags include FlagNoReplyExpected, ch is ignored and a Call structure +// is returned of which only the Err member is valid. +// +// If the method parameter contains a dot ('.'), the part before the last dot +// specifies the interface on which the method is called. +func (o *Object) Go(method string, flags Flags, ch chan *Call, args ...interface{}) *Call { + iface := "" + i := strings.LastIndex(method, ".") + if i != -1 { + iface = method[:i] + } + method = method[i+1:] + msg := new(Message) + msg.Type = TypeMethodCall + msg.serial = o.conn.getSerial() + msg.Flags = flags & (FlagNoAutoStart | FlagNoReplyExpected) + msg.Headers = make(map[HeaderField]Variant) + msg.Headers[FieldPath] = MakeVariant(o.path) + msg.Headers[FieldDestination] = MakeVariant(o.dest) + msg.Headers[FieldMember] = MakeVariant(method) + if iface != "" { + msg.Headers[FieldInterface] = MakeVariant(iface) + } + msg.Body = args + if len(args) > 0 { + msg.Headers[FieldSignature] = MakeVariant(SignatureOf(args...)) + } + if msg.Flags&FlagNoReplyExpected == 0 { + if ch == nil { + ch = make(chan *Call, 10) + } else if cap(ch) == 0 { + panic("dbus: unbuffered channel passed to (*Object).Go") + } + call := &Call{ + Destination: o.dest, + Path: o.path, + Method: method, + Args: args, + Done: ch, + } + o.conn.callsLck.Lock() + o.conn.calls[msg.serial] = call + o.conn.callsLck.Unlock() + o.conn.outLck.RLock() + if o.conn.closed { + call.Err = ErrClosed + call.Done <- call + } else { + o.conn.out <- msg + } + o.conn.outLck.RUnlock() + return call + } + o.conn.outLck.RLock() + defer o.conn.outLck.RUnlock() + if o.conn.closed { + return &Call{Err: ErrClosed} + } + o.conn.out <- msg + return &Call{Err: nil} +} + +// Destination returns the destination that calls on o are sent to. +func (o *Object) Destination() string { + return o.dest +} + +// Path returns the path that calls on o are sent to. +func (o *Object) Path() ObjectPath { + return o.path +} diff --git a/vendor/src/github.com/godbus/dbus/conn.go b/vendor/src/github.com/godbus/dbus/conn.go new file mode 100644 index 0000000000..18027a096a --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/conn.go @@ -0,0 +1,609 @@ +package dbus + +import ( + "errors" + "io" + "os" + "reflect" + "strings" + "sync" +) + +const defaultSystemBusAddress = "unix:path=/var/run/dbus/system_bus_socket" + +var ( + systemBus *Conn + systemBusLck sync.Mutex + sessionBus *Conn + sessionBusLck sync.Mutex +) + +// ErrClosed is the error returned by calls on a closed connection. +var ErrClosed = errors.New("dbus: connection closed by user") + +// Conn represents a connection to a message bus (usually, the system or +// session bus). +// +// Connections are either shared or private. Shared connections +// are shared between calls to the functions that return them. As a result, +// the methods Close, Auth and Hello must not be called on them. +// +// Multiple goroutines may invoke methods on a connection simultaneously. +type Conn struct { + transport + + busObj *Object + unixFD bool + uuid string + + names []string + namesLck sync.RWMutex + + serialLck sync.Mutex + nextSerial uint32 + serialUsed map[uint32]bool + + calls map[uint32]*Call + callsLck sync.RWMutex + + handlers map[ObjectPath]map[string]interface{} + handlersLck sync.RWMutex + + out chan *Message + closed bool + outLck sync.RWMutex + + signals []chan<- *Signal + signalsLck sync.Mutex + + eavesdropped chan<- *Message + eavesdroppedLck sync.Mutex +} + +// SessionBus returns a shared connection to the session bus, connecting to it +// if not already done. +func SessionBus() (conn *Conn, err error) { + sessionBusLck.Lock() + defer sessionBusLck.Unlock() + if sessionBus != nil { + return sessionBus, nil + } + defer func() { + if conn != nil { + sessionBus = conn + } + }() + conn, err = SessionBusPrivate() + if err != nil { + return + } + if err = conn.Auth(nil); err != nil { + conn.Close() + conn = nil + return + } + if err = conn.Hello(); err != nil { + conn.Close() + conn = nil + } + return +} + +// SessionBusPrivate returns a new private connection to the session bus. +func SessionBusPrivate() (*Conn, error) { + address := os.Getenv("DBUS_SESSION_BUS_ADDRESS") + if address != "" && address != "autolaunch:" { + return Dial(address) + } + + return sessionBusPlatform() +} + +// SystemBus returns a shared connection to the system bus, connecting to it if +// not already done. +func SystemBus() (conn *Conn, err error) { + systemBusLck.Lock() + defer systemBusLck.Unlock() + if systemBus != nil { + return systemBus, nil + } + defer func() { + if conn != nil { + systemBus = conn + } + }() + conn, err = SystemBusPrivate() + if err != nil { + return + } + if err = conn.Auth(nil); err != nil { + conn.Close() + conn = nil + return + } + if err = conn.Hello(); err != nil { + conn.Close() + conn = nil + } + return +} + +// SystemBusPrivate returns a new private connection to the system bus. +func SystemBusPrivate() (*Conn, error) { + address := os.Getenv("DBUS_SYSTEM_BUS_ADDRESS") + if address != "" { + return Dial(address) + } + return Dial(defaultSystemBusAddress) +} + +// Dial establishes a new private connection to the message bus specified by address. +func Dial(address string) (*Conn, error) { + tr, err := getTransport(address) + if err != nil { + return nil, err + } + return newConn(tr) +} + +// NewConn creates a new private *Conn from an already established connection. +func NewConn(conn io.ReadWriteCloser) (*Conn, error) { + return newConn(genericTransport{conn}) +} + +// newConn creates a new *Conn from a transport. +func newConn(tr transport) (*Conn, error) { + conn := new(Conn) + conn.transport = tr + conn.calls = make(map[uint32]*Call) + conn.out = make(chan *Message, 10) + conn.handlers = make(map[ObjectPath]map[string]interface{}) + conn.nextSerial = 1 + conn.serialUsed = map[uint32]bool{0: true} + conn.busObj = conn.Object("org.freedesktop.DBus", "/org/freedesktop/DBus") + return conn, nil +} + +// BusObject returns the object owned by the bus daemon which handles +// administrative requests. +func (conn *Conn) BusObject() *Object { + return conn.busObj +} + +// Close closes the connection. Any blocked operations will return with errors +// and the channels passed to Eavesdrop and Signal are closed. This method must +// not be called on shared connections. +func (conn *Conn) Close() error { + conn.outLck.Lock() + if conn.closed { + // inWorker calls Close on read error, the read error may + // be caused by another caller calling Close to shutdown the + // dbus connection, a double-close scenario we prevent here. + conn.outLck.Unlock() + return nil + } + close(conn.out) + conn.closed = true + conn.outLck.Unlock() + conn.signalsLck.Lock() + for _, ch := range conn.signals { + close(ch) + } + conn.signalsLck.Unlock() + conn.eavesdroppedLck.Lock() + if conn.eavesdropped != nil { + close(conn.eavesdropped) + } + conn.eavesdroppedLck.Unlock() + return conn.transport.Close() +} + +// Eavesdrop causes conn to send all incoming messages to the given channel +// without further processing. Method replies, errors and signals will not be +// sent to the appropiate channels and method calls will not be handled. If nil +// is passed, the normal behaviour is restored. +// +// The caller has to make sure that ch is sufficiently buffered; +// if a message arrives when a write to ch is not possible, the message is +// discarded. +func (conn *Conn) Eavesdrop(ch chan<- *Message) { + conn.eavesdroppedLck.Lock() + conn.eavesdropped = ch + conn.eavesdroppedLck.Unlock() +} + +// getSerial returns an unused serial. +func (conn *Conn) getSerial() uint32 { + conn.serialLck.Lock() + defer conn.serialLck.Unlock() + n := conn.nextSerial + for conn.serialUsed[n] { + n++ + } + conn.serialUsed[n] = true + conn.nextSerial = n + 1 + return n +} + +// Hello sends the initial org.freedesktop.DBus.Hello call. This method must be +// called after authentication, but before sending any other messages to the +// bus. Hello must not be called for shared connections. +func (conn *Conn) Hello() error { + var s string + err := conn.busObj.Call("org.freedesktop.DBus.Hello", 0).Store(&s) + if err != nil { + return err + } + conn.namesLck.Lock() + conn.names = make([]string, 1) + conn.names[0] = s + conn.namesLck.Unlock() + return nil +} + +// inWorker runs in an own goroutine, reading incoming messages from the +// transport and dispatching them appropiately. +func (conn *Conn) inWorker() { + for { + msg, err := conn.ReadMessage() + if err == nil { + conn.eavesdroppedLck.Lock() + if conn.eavesdropped != nil { + select { + case conn.eavesdropped <- msg: + default: + } + conn.eavesdroppedLck.Unlock() + continue + } + conn.eavesdroppedLck.Unlock() + dest, _ := msg.Headers[FieldDestination].value.(string) + found := false + if dest == "" { + found = true + } else { + conn.namesLck.RLock() + if len(conn.names) == 0 { + found = true + } + for _, v := range conn.names { + if dest == v { + found = true + break + } + } + conn.namesLck.RUnlock() + } + if !found { + // Eavesdropped a message, but no channel for it is registered. + // Ignore it. + continue + } + switch msg.Type { + case TypeMethodReply, TypeError: + serial := msg.Headers[FieldReplySerial].value.(uint32) + conn.callsLck.Lock() + if c, ok := conn.calls[serial]; ok { + if msg.Type == TypeError { + name, _ := msg.Headers[FieldErrorName].value.(string) + c.Err = Error{name, msg.Body} + } else { + c.Body = msg.Body + } + c.Done <- c + conn.serialLck.Lock() + delete(conn.serialUsed, serial) + conn.serialLck.Unlock() + delete(conn.calls, serial) + } + conn.callsLck.Unlock() + case TypeSignal: + iface := msg.Headers[FieldInterface].value.(string) + member := msg.Headers[FieldMember].value.(string) + // as per http://dbus.freedesktop.org/doc/dbus-specification.html , + // sender is optional for signals. + sender, _ := msg.Headers[FieldSender].value.(string) + if iface == "org.freedesktop.DBus" && member == "NameLost" && + sender == "org.freedesktop.DBus" { + + name, _ := msg.Body[0].(string) + conn.namesLck.Lock() + for i, v := range conn.names { + if v == name { + copy(conn.names[i:], conn.names[i+1:]) + conn.names = conn.names[:len(conn.names)-1] + } + } + conn.namesLck.Unlock() + } + signal := &Signal{ + Sender: sender, + Path: msg.Headers[FieldPath].value.(ObjectPath), + Name: iface + "." + member, + Body: msg.Body, + } + conn.signalsLck.Lock() + for _, ch := range conn.signals { + ch <- signal + } + conn.signalsLck.Unlock() + case TypeMethodCall: + go conn.handleCall(msg) + } + } else if _, ok := err.(InvalidMessageError); !ok { + // Some read error occured (usually EOF); we can't really do + // anything but to shut down all stuff and returns errors to all + // pending replies. + conn.Close() + conn.callsLck.RLock() + for _, v := range conn.calls { + v.Err = err + v.Done <- v + } + conn.callsLck.RUnlock() + return + } + // invalid messages are ignored + } +} + +// Names returns the list of all names that are currently owned by this +// connection. The slice is always at least one element long, the first element +// being the unique name of the connection. +func (conn *Conn) Names() []string { + conn.namesLck.RLock() + // copy the slice so it can't be modified + s := make([]string, len(conn.names)) + copy(s, conn.names) + conn.namesLck.RUnlock() + return s +} + +// Object returns the object identified by the given destination name and path. +func (conn *Conn) Object(dest string, path ObjectPath) *Object { + return &Object{conn, dest, path} +} + +// outWorker runs in an own goroutine, encoding and sending messages that are +// sent to conn.out. +func (conn *Conn) outWorker() { + for msg := range conn.out { + err := conn.SendMessage(msg) + conn.callsLck.RLock() + if err != nil { + if c := conn.calls[msg.serial]; c != nil { + c.Err = err + c.Done <- c + } + conn.serialLck.Lock() + delete(conn.serialUsed, msg.serial) + conn.serialLck.Unlock() + } else if msg.Type != TypeMethodCall { + conn.serialLck.Lock() + delete(conn.serialUsed, msg.serial) + conn.serialLck.Unlock() + } + conn.callsLck.RUnlock() + } +} + +// Send sends the given message to the message bus. You usually don't need to +// use this; use the higher-level equivalents (Call / Go, Emit and Export) +// instead. If msg is a method call and NoReplyExpected is not set, a non-nil +// call is returned and the same value is sent to ch (which must be buffered) +// once the call is complete. Otherwise, ch is ignored and a Call structure is +// returned of which only the Err member is valid. +func (conn *Conn) Send(msg *Message, ch chan *Call) *Call { + var call *Call + + msg.serial = conn.getSerial() + if msg.Type == TypeMethodCall && msg.Flags&FlagNoReplyExpected == 0 { + if ch == nil { + ch = make(chan *Call, 5) + } else if cap(ch) == 0 { + panic("dbus: unbuffered channel passed to (*Conn).Send") + } + call = new(Call) + call.Destination, _ = msg.Headers[FieldDestination].value.(string) + call.Path, _ = msg.Headers[FieldPath].value.(ObjectPath) + iface, _ := msg.Headers[FieldInterface].value.(string) + member, _ := msg.Headers[FieldMember].value.(string) + call.Method = iface + "." + member + call.Args = msg.Body + call.Done = ch + conn.callsLck.Lock() + conn.calls[msg.serial] = call + conn.callsLck.Unlock() + conn.outLck.RLock() + if conn.closed { + call.Err = ErrClosed + call.Done <- call + } else { + conn.out <- msg + } + conn.outLck.RUnlock() + } else { + conn.outLck.RLock() + if conn.closed { + call = &Call{Err: ErrClosed} + } else { + conn.out <- msg + call = &Call{Err: nil} + } + conn.outLck.RUnlock() + } + return call +} + +// sendError creates an error message corresponding to the parameters and sends +// it to conn.out. +func (conn *Conn) sendError(e Error, dest string, serial uint32) { + msg := new(Message) + msg.Type = TypeError + msg.serial = conn.getSerial() + msg.Headers = make(map[HeaderField]Variant) + if dest != "" { + msg.Headers[FieldDestination] = MakeVariant(dest) + } + msg.Headers[FieldErrorName] = MakeVariant(e.Name) + msg.Headers[FieldReplySerial] = MakeVariant(serial) + msg.Body = e.Body + if len(e.Body) > 0 { + msg.Headers[FieldSignature] = MakeVariant(SignatureOf(e.Body...)) + } + conn.outLck.RLock() + if !conn.closed { + conn.out <- msg + } + conn.outLck.RUnlock() +} + +// sendReply creates a method reply message corresponding to the parameters and +// sends it to conn.out. +func (conn *Conn) sendReply(dest string, serial uint32, values ...interface{}) { + msg := new(Message) + msg.Type = TypeMethodReply + msg.serial = conn.getSerial() + msg.Headers = make(map[HeaderField]Variant) + if dest != "" { + msg.Headers[FieldDestination] = MakeVariant(dest) + } + msg.Headers[FieldReplySerial] = MakeVariant(serial) + msg.Body = values + if len(values) > 0 { + msg.Headers[FieldSignature] = MakeVariant(SignatureOf(values...)) + } + conn.outLck.RLock() + if !conn.closed { + conn.out <- msg + } + conn.outLck.RUnlock() +} + +// Signal registers the given channel to be passed all received signal messages. +// The caller has to make sure that ch is sufficiently buffered; if a message +// arrives when a write to c is not possible, it is discarded. +// +// Multiple of these channels can be registered at the same time. Passing a +// channel that already is registered will remove it from the list of the +// registered channels. +// +// These channels are "overwritten" by Eavesdrop; i.e., if there currently is a +// channel for eavesdropped messages, this channel receives all signals, and +// none of the channels passed to Signal will receive any signals. +func (conn *Conn) Signal(ch chan<- *Signal) { + conn.signalsLck.Lock() + conn.signals = append(conn.signals, ch) + conn.signalsLck.Unlock() +} + +// SupportsUnixFDs returns whether the underlying transport supports passing of +// unix file descriptors. If this is false, method calls containing unix file +// descriptors will return an error and emitted signals containing them will +// not be sent. +func (conn *Conn) SupportsUnixFDs() bool { + return conn.unixFD +} + +// Error represents a D-Bus message of type Error. +type Error struct { + Name string + Body []interface{} +} + +func NewError(name string, body []interface{}) *Error { + return &Error{name, body} +} + +func (e Error) Error() string { + if len(e.Body) >= 1 { + s, ok := e.Body[0].(string) + if ok { + return s + } + } + return e.Name +} + +// Signal represents a D-Bus message of type Signal. The name member is given in +// "interface.member" notation, e.g. org.freedesktop.D-Bus.NameLost. +type Signal struct { + Sender string + Path ObjectPath + Name string + Body []interface{} +} + +// transport is a D-Bus transport. +type transport interface { + // Read and Write raw data (for example, for the authentication protocol). + io.ReadWriteCloser + + // Send the initial null byte used for the EXTERNAL mechanism. + SendNullByte() error + + // Returns whether this transport supports passing Unix FDs. + SupportsUnixFDs() bool + + // Signal the transport that Unix FD passing is enabled for this connection. + EnableUnixFDs() + + // Read / send a message, handling things like Unix FDs. + ReadMessage() (*Message, error) + SendMessage(*Message) error +} + +var ( + transports map[string]func(string) (transport, error) = make(map[string]func(string) (transport, error)) +) + +func getTransport(address string) (transport, error) { + var err error + var t transport + + addresses := strings.Split(address, ";") + for _, v := range addresses { + i := strings.IndexRune(v, ':') + if i == -1 { + err = errors.New("dbus: invalid bus address (no transport)") + continue + } + f := transports[v[:i]] + if f == nil { + err = errors.New("dbus: invalid bus address (invalid or unsupported transport)") + } + t, err = f(v[i+1:]) + if err == nil { + return t, nil + } + } + return nil, err +} + +// dereferenceAll returns a slice that, assuming that vs is a slice of pointers +// of arbitrary types, containes the values that are obtained from dereferencing +// all elements in vs. +func dereferenceAll(vs []interface{}) []interface{} { + for i := range vs { + v := reflect.ValueOf(vs[i]) + v = v.Elem() + vs[i] = v.Interface() + } + return vs +} + +// getKey gets a key from a the list of keys. Returns "" on error / not found... +func getKey(s, key string) string { + i := strings.Index(s, key) + if i == -1 { + return "" + } + if i+len(key)+1 >= len(s) || s[i+len(key)] != '=' { + return "" + } + j := strings.Index(s, ",") + if j == -1 { + j = len(s) + } + return s[i+len(key)+1 : j] +} diff --git a/vendor/src/github.com/godbus/dbus/conn_darwin.go b/vendor/src/github.com/godbus/dbus/conn_darwin.go new file mode 100644 index 0000000000..b67bb1b81d --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/conn_darwin.go @@ -0,0 +1,21 @@ +package dbus + +import ( + "errors" + "os/exec" +) + +func sessionBusPlatform() (*Conn, error) { + cmd := exec.Command("launchctl", "getenv", "DBUS_LAUNCHD_SESSION_BUS_SOCKET") + b, err := cmd.CombinedOutput() + + if err != nil { + return nil, err + } + + if len(b) == 0 { + return nil, errors.New("dbus: couldn't determine address of session bus") + } + + return Dial("unix:path=" + string(b[:len(b)-1])) +} diff --git a/vendor/src/github.com/godbus/dbus/conn_other.go b/vendor/src/github.com/godbus/dbus/conn_other.go new file mode 100644 index 0000000000..f74b8758d4 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/conn_other.go @@ -0,0 +1,27 @@ +// +build !darwin + +package dbus + +import ( + "bytes" + "errors" + "os/exec" +) + +func sessionBusPlatform() (*Conn, error) { + cmd := exec.Command("dbus-launch") + b, err := cmd.CombinedOutput() + + if err != nil { + return nil, err + } + + i := bytes.IndexByte(b, '=') + j := bytes.IndexByte(b, '\n') + + if i == -1 || j == -1 { + return nil, errors.New("dbus: couldn't determine address of session bus") + } + + return Dial(string(b[i+1 : j])) +} diff --git a/vendor/src/github.com/godbus/dbus/dbus.go b/vendor/src/github.com/godbus/dbus/dbus.go new file mode 100644 index 0000000000..2ce68735cd --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/dbus.go @@ -0,0 +1,258 @@ +package dbus + +import ( + "errors" + "reflect" + "strings" +) + +var ( + byteType = reflect.TypeOf(byte(0)) + boolType = reflect.TypeOf(false) + uint8Type = reflect.TypeOf(uint8(0)) + int16Type = reflect.TypeOf(int16(0)) + uint16Type = reflect.TypeOf(uint16(0)) + int32Type = reflect.TypeOf(int32(0)) + uint32Type = reflect.TypeOf(uint32(0)) + int64Type = reflect.TypeOf(int64(0)) + uint64Type = reflect.TypeOf(uint64(0)) + float64Type = reflect.TypeOf(float64(0)) + stringType = reflect.TypeOf("") + signatureType = reflect.TypeOf(Signature{""}) + objectPathType = reflect.TypeOf(ObjectPath("")) + variantType = reflect.TypeOf(Variant{Signature{""}, nil}) + interfacesType = reflect.TypeOf([]interface{}{}) + unixFDType = reflect.TypeOf(UnixFD(0)) + unixFDIndexType = reflect.TypeOf(UnixFDIndex(0)) +) + +// An InvalidTypeError signals that a value which cannot be represented in the +// D-Bus wire format was passed to a function. +type InvalidTypeError struct { + Type reflect.Type +} + +func (e InvalidTypeError) Error() string { + return "dbus: invalid type " + e.Type.String() +} + +// Store copies the values contained in src to dest, which must be a slice of +// pointers. It converts slices of interfaces from src to corresponding structs +// in dest. An error is returned if the lengths of src and dest or the types of +// their elements don't match. +func Store(src []interface{}, dest ...interface{}) error { + if len(src) != len(dest) { + return errors.New("dbus.Store: length mismatch") + } + + for i := range src { + if err := store(src[i], dest[i]); err != nil { + return err + } + } + return nil +} + +func store(src, dest interface{}) error { + if reflect.TypeOf(dest).Elem() == reflect.TypeOf(src) { + reflect.ValueOf(dest).Elem().Set(reflect.ValueOf(src)) + return nil + } else if hasStruct(dest) { + rv := reflect.ValueOf(dest).Elem() + switch rv.Kind() { + case reflect.Struct: + vs, ok := src.([]interface{}) + if !ok { + return errors.New("dbus.Store: type mismatch") + } + t := rv.Type() + ndest := make([]interface{}, 0, rv.NumField()) + for i := 0; i < rv.NumField(); i++ { + field := t.Field(i) + if field.PkgPath == "" && field.Tag.Get("dbus") != "-" { + ndest = append(ndest, rv.Field(i).Addr().Interface()) + } + } + if len(vs) != len(ndest) { + return errors.New("dbus.Store: type mismatch") + } + err := Store(vs, ndest...) + if err != nil { + return errors.New("dbus.Store: type mismatch") + } + case reflect.Slice: + sv := reflect.ValueOf(src) + if sv.Kind() != reflect.Slice { + return errors.New("dbus.Store: type mismatch") + } + rv.Set(reflect.MakeSlice(rv.Type(), sv.Len(), sv.Len())) + for i := 0; i < sv.Len(); i++ { + if err := store(sv.Index(i).Interface(), rv.Index(i).Addr().Interface()); err != nil { + return err + } + } + case reflect.Map: + sv := reflect.ValueOf(src) + if sv.Kind() != reflect.Map { + return errors.New("dbus.Store: type mismatch") + } + keys := sv.MapKeys() + rv.Set(reflect.MakeMap(sv.Type())) + for _, key := range keys { + v := reflect.New(sv.Type().Elem()) + if err := store(v, sv.MapIndex(key).Interface()); err != nil { + return err + } + rv.SetMapIndex(key, v.Elem()) + } + default: + return errors.New("dbus.Store: type mismatch") + } + return nil + } else { + return errors.New("dbus.Store: type mismatch") + } +} + +func hasStruct(v interface{}) bool { + t := reflect.TypeOf(v) + for { + switch t.Kind() { + case reflect.Struct: + return true + case reflect.Slice, reflect.Ptr, reflect.Map: + t = t.Elem() + default: + return false + } + } +} + +// An ObjectPath is an object path as defined by the D-Bus spec. +type ObjectPath string + +// IsValid returns whether the object path is valid. +func (o ObjectPath) IsValid() bool { + s := string(o) + if len(s) == 0 { + return false + } + if s[0] != '/' { + return false + } + if s[len(s)-1] == '/' && len(s) != 1 { + return false + } + // probably not used, but technically possible + if s == "/" { + return true + } + split := strings.Split(s[1:], "/") + for _, v := range split { + if len(v) == 0 { + return false + } + for _, c := range v { + if !isMemberChar(c) { + return false + } + } + } + return true +} + +// A UnixFD is a Unix file descriptor sent over the wire. See the package-level +// documentation for more information about Unix file descriptor passsing. +type UnixFD int32 + +// A UnixFDIndex is the representation of a Unix file descriptor in a message. +type UnixFDIndex uint32 + +// alignment returns the alignment of values of type t. +func alignment(t reflect.Type) int { + switch t { + case variantType: + return 1 + case objectPathType: + return 4 + case signatureType: + return 1 + case interfacesType: // sometimes used for structs + return 8 + } + switch t.Kind() { + case reflect.Uint8: + return 1 + case reflect.Uint16, reflect.Int16: + return 2 + case reflect.Uint32, reflect.Int32, reflect.String, reflect.Array, reflect.Slice, reflect.Map: + return 4 + case reflect.Uint64, reflect.Int64, reflect.Float64, reflect.Struct: + return 8 + case reflect.Ptr: + return alignment(t.Elem()) + } + return 1 +} + +// isKeyType returns whether t is a valid type for a D-Bus dict. +func isKeyType(t reflect.Type) bool { + switch t.Kind() { + case reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, + reflect.Int16, reflect.Int32, reflect.Int64, reflect.Float64, + reflect.String: + + return true + } + return false +} + +// isValidInterface returns whether s is a valid name for an interface. +func isValidInterface(s string) bool { + if len(s) == 0 || len(s) > 255 || s[0] == '.' { + return false + } + elem := strings.Split(s, ".") + if len(elem) < 2 { + return false + } + for _, v := range elem { + if len(v) == 0 { + return false + } + if v[0] >= '0' && v[0] <= '9' { + return false + } + for _, c := range v { + if !isMemberChar(c) { + return false + } + } + } + return true +} + +// isValidMember returns whether s is a valid name for a member. +func isValidMember(s string) bool { + if len(s) == 0 || len(s) > 255 { + return false + } + i := strings.Index(s, ".") + if i != -1 { + return false + } + if s[0] >= '0' && s[0] <= '9' { + return false + } + for _, c := range s { + if !isMemberChar(c) { + return false + } + } + return true +} + +func isMemberChar(c rune) bool { + return (c >= '0' && c <= '9') || (c >= 'A' && c <= 'Z') || + (c >= 'a' && c <= 'z') || c == '_' +} diff --git a/vendor/src/github.com/godbus/dbus/decoder.go b/vendor/src/github.com/godbus/dbus/decoder.go new file mode 100644 index 0000000000..ef50dcab98 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/decoder.go @@ -0,0 +1,228 @@ +package dbus + +import ( + "encoding/binary" + "io" + "reflect" +) + +type decoder struct { + in io.Reader + order binary.ByteOrder + pos int +} + +// newDecoder returns a new decoder that reads values from in. The input is +// expected to be in the given byte order. +func newDecoder(in io.Reader, order binary.ByteOrder) *decoder { + dec := new(decoder) + dec.in = in + dec.order = order + return dec +} + +// align aligns the input to the given boundary and panics on error. +func (dec *decoder) align(n int) { + if dec.pos%n != 0 { + newpos := (dec.pos + n - 1) & ^(n - 1) + empty := make([]byte, newpos-dec.pos) + if _, err := io.ReadFull(dec.in, empty); err != nil { + panic(err) + } + dec.pos = newpos + } +} + +// Calls binary.Read(dec.in, dec.order, v) and panics on read errors. +func (dec *decoder) binread(v interface{}) { + if err := binary.Read(dec.in, dec.order, v); err != nil { + panic(err) + } +} + +func (dec *decoder) Decode(sig Signature) (vs []interface{}, err error) { + defer func() { + var ok bool + v := recover() + if err, ok = v.(error); ok { + if err == io.EOF || err == io.ErrUnexpectedEOF { + err = FormatError("unexpected EOF") + } + } + }() + vs = make([]interface{}, 0) + s := sig.str + for s != "" { + err, rem := validSingle(s, 0) + if err != nil { + return nil, err + } + v := dec.decode(s[:len(s)-len(rem)], 0) + vs = append(vs, v) + s = rem + } + return vs, nil +} + +func (dec *decoder) decode(s string, depth int) interface{} { + dec.align(alignment(typeFor(s))) + switch s[0] { + case 'y': + var b [1]byte + if _, err := dec.in.Read(b[:]); err != nil { + panic(err) + } + dec.pos++ + return b[0] + case 'b': + i := dec.decode("u", depth).(uint32) + switch { + case i == 0: + return false + case i == 1: + return true + default: + panic(FormatError("invalid value for boolean")) + } + case 'n': + var i int16 + dec.binread(&i) + dec.pos += 2 + return i + case 'i': + var i int32 + dec.binread(&i) + dec.pos += 4 + return i + case 'x': + var i int64 + dec.binread(&i) + dec.pos += 8 + return i + case 'q': + var i uint16 + dec.binread(&i) + dec.pos += 2 + return i + case 'u': + var i uint32 + dec.binread(&i) + dec.pos += 4 + return i + case 't': + var i uint64 + dec.binread(&i) + dec.pos += 8 + return i + case 'd': + var f float64 + dec.binread(&f) + dec.pos += 8 + return f + case 's': + length := dec.decode("u", depth).(uint32) + b := make([]byte, int(length)+1) + if _, err := io.ReadFull(dec.in, b); err != nil { + panic(err) + } + dec.pos += int(length) + 1 + return string(b[:len(b)-1]) + case 'o': + return ObjectPath(dec.decode("s", depth).(string)) + case 'g': + length := dec.decode("y", depth).(byte) + b := make([]byte, int(length)+1) + if _, err := io.ReadFull(dec.in, b); err != nil { + panic(err) + } + dec.pos += int(length) + 1 + sig, err := ParseSignature(string(b[:len(b)-1])) + if err != nil { + panic(err) + } + return sig + case 'v': + if depth >= 64 { + panic(FormatError("input exceeds container depth limit")) + } + var variant Variant + sig := dec.decode("g", depth).(Signature) + if len(sig.str) == 0 { + panic(FormatError("variant signature is empty")) + } + err, rem := validSingle(sig.str, 0) + if err != nil { + panic(err) + } + if rem != "" { + panic(FormatError("variant signature has multiple types")) + } + variant.sig = sig + variant.value = dec.decode(sig.str, depth+1) + return variant + case 'h': + return UnixFDIndex(dec.decode("u", depth).(uint32)) + case 'a': + if len(s) > 1 && s[1] == '{' { + ksig := s[2:3] + vsig := s[3 : len(s)-1] + v := reflect.MakeMap(reflect.MapOf(typeFor(ksig), typeFor(vsig))) + if depth >= 63 { + panic(FormatError("input exceeds container depth limit")) + } + length := dec.decode("u", depth).(uint32) + // Even for empty maps, the correct padding must be included + dec.align(8) + spos := dec.pos + for dec.pos < spos+int(length) { + dec.align(8) + if !isKeyType(v.Type().Key()) { + panic(InvalidTypeError{v.Type()}) + } + kv := dec.decode(ksig, depth+2) + vv := dec.decode(vsig, depth+2) + v.SetMapIndex(reflect.ValueOf(kv), reflect.ValueOf(vv)) + } + return v.Interface() + } + if depth >= 64 { + panic(FormatError("input exceeds container depth limit")) + } + length := dec.decode("u", depth).(uint32) + v := reflect.MakeSlice(reflect.SliceOf(typeFor(s[1:])), 0, int(length)) + // Even for empty arrays, the correct padding must be included + dec.align(alignment(typeFor(s[1:]))) + spos := dec.pos + for dec.pos < spos+int(length) { + ev := dec.decode(s[1:], depth+1) + v = reflect.Append(v, reflect.ValueOf(ev)) + } + return v.Interface() + case '(': + if depth >= 64 { + panic(FormatError("input exceeds container depth limit")) + } + dec.align(8) + v := make([]interface{}, 0) + s = s[1 : len(s)-1] + for s != "" { + err, rem := validSingle(s, 0) + if err != nil { + panic(err) + } + ev := dec.decode(s[:len(s)-len(rem)], depth+1) + v = append(v, ev) + s = rem + } + return v + default: + panic(SignatureError{Sig: s}) + } +} + +// A FormatError is an error in the wire format. +type FormatError string + +func (e FormatError) Error() string { + return "dbus: wire format error: " + string(e) +} diff --git a/vendor/src/github.com/godbus/dbus/doc.go b/vendor/src/github.com/godbus/dbus/doc.go new file mode 100644 index 0000000000..deff554a38 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/doc.go @@ -0,0 +1,63 @@ +/* +Package dbus implements bindings to the D-Bus message bus system. + +To use the message bus API, you first need to connect to a bus (usually the +session or system bus). The acquired connection then can be used to call methods +on remote objects and emit or receive signals. Using the Export method, you can +arrange D-Bus methods calls to be directly translated to method calls on a Go +value. + +Conversion Rules + +For outgoing messages, Go types are automatically converted to the +corresponding D-Bus types. The following types are directly encoded as their +respective D-Bus equivalents: + + Go type | D-Bus type + ------------+----------- + byte | BYTE + bool | BOOLEAN + int16 | INT16 + uint16 | UINT16 + int32 | INT32 + uint32 | UINT32 + int64 | INT64 + uint64 | UINT64 + float64 | DOUBLE + string | STRING + ObjectPath | OBJECT_PATH + Signature | SIGNATURE + Variant | VARIANT + UnixFDIndex | UNIX_FD + +Slices and arrays encode as ARRAYs of their element type. + +Maps encode as DICTs, provided that their key type can be used as a key for +a DICT. + +Structs other than Variant and Signature encode as a STRUCT containing their +exported fields. Fields whose tags contain `dbus:"-"` and unexported fields will +be skipped. + +Pointers encode as the value they're pointed to. + +Trying to encode any other type or a slice, map or struct containing an +unsupported type will result in an InvalidTypeError. + +For incoming messages, the inverse of these rules are used, with the exception +of STRUCTs. Incoming STRUCTS are represented as a slice of empty interfaces +containing the struct fields in the correct order. The Store function can be +used to convert such values to Go structs. + +Unix FD passing + +Handling Unix file descriptors deserves special mention. To use them, you should +first check that they are supported on a connection by calling SupportsUnixFDs. +If it returns true, all method of Connection will translate messages containing +UnixFD's to messages that are accompanied by the given file descriptors with the +UnixFD values being substituted by the correct indices. Similarily, the indices +of incoming messages are automatically resolved. It shouldn't be necessary to use +UnixFDIndex. + +*/ +package dbus diff --git a/vendor/src/github.com/godbus/dbus/encoder.go b/vendor/src/github.com/godbus/dbus/encoder.go new file mode 100644 index 0000000000..f9d2f05716 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/encoder.go @@ -0,0 +1,179 @@ +package dbus + +import ( + "bytes" + "encoding/binary" + "io" + "reflect" +) + +// An encoder encodes values to the D-Bus wire format. +type encoder struct { + out io.Writer + order binary.ByteOrder + pos int +} + +// NewEncoder returns a new encoder that writes to out in the given byte order. +func newEncoder(out io.Writer, order binary.ByteOrder) *encoder { + enc := new(encoder) + enc.out = out + enc.order = order + return enc +} + +// Aligns the next output to be on a multiple of n. Panics on write errors. +func (enc *encoder) align(n int) { + if enc.pos%n != 0 { + newpos := (enc.pos + n - 1) & ^(n - 1) + empty := make([]byte, newpos-enc.pos) + if _, err := enc.out.Write(empty); err != nil { + panic(err) + } + enc.pos = newpos + } +} + +// Calls binary.Write(enc.out, enc.order, v) and panics on write errors. +func (enc *encoder) binwrite(v interface{}) { + if err := binary.Write(enc.out, enc.order, v); err != nil { + panic(err) + } +} + +// Encode encodes the given values to the underyling reader. All written values +// are aligned properly as required by the D-Bus spec. +func (enc *encoder) Encode(vs ...interface{}) (err error) { + defer func() { + err, _ = recover().(error) + }() + for _, v := range vs { + enc.encode(reflect.ValueOf(v), 0) + } + return nil +} + +// encode encodes the given value to the writer and panics on error. depth holds +// the depth of the container nesting. +func (enc *encoder) encode(v reflect.Value, depth int) { + enc.align(alignment(v.Type())) + switch v.Kind() { + case reflect.Uint8: + var b [1]byte + b[0] = byte(v.Uint()) + if _, err := enc.out.Write(b[:]); err != nil { + panic(err) + } + enc.pos++ + case reflect.Bool: + if v.Bool() { + enc.encode(reflect.ValueOf(uint32(1)), depth) + } else { + enc.encode(reflect.ValueOf(uint32(0)), depth) + } + case reflect.Int16: + enc.binwrite(int16(v.Int())) + enc.pos += 2 + case reflect.Uint16: + enc.binwrite(uint16(v.Uint())) + enc.pos += 2 + case reflect.Int32: + enc.binwrite(int32(v.Int())) + enc.pos += 4 + case reflect.Uint32: + enc.binwrite(uint32(v.Uint())) + enc.pos += 4 + case reflect.Int64: + enc.binwrite(v.Int()) + enc.pos += 8 + case reflect.Uint64: + enc.binwrite(v.Uint()) + enc.pos += 8 + case reflect.Float64: + enc.binwrite(v.Float()) + enc.pos += 8 + case reflect.String: + enc.encode(reflect.ValueOf(uint32(len(v.String()))), depth) + b := make([]byte, v.Len()+1) + copy(b, v.String()) + b[len(b)-1] = 0 + n, err := enc.out.Write(b) + if err != nil { + panic(err) + } + enc.pos += n + case reflect.Ptr: + enc.encode(v.Elem(), depth) + case reflect.Slice, reflect.Array: + if depth >= 64 { + panic(FormatError("input exceeds container depth limit")) + } + var buf bytes.Buffer + bufenc := newEncoder(&buf, enc.order) + + for i := 0; i < v.Len(); i++ { + bufenc.encode(v.Index(i), depth+1) + } + enc.encode(reflect.ValueOf(uint32(buf.Len())), depth) + length := buf.Len() + enc.align(alignment(v.Type().Elem())) + if _, err := buf.WriteTo(enc.out); err != nil { + panic(err) + } + enc.pos += length + case reflect.Struct: + if depth >= 64 && v.Type() != signatureType { + panic(FormatError("input exceeds container depth limit")) + } + switch t := v.Type(); t { + case signatureType: + str := v.Field(0) + enc.encode(reflect.ValueOf(byte(str.Len())), depth+1) + b := make([]byte, str.Len()+1) + copy(b, str.String()) + b[len(b)-1] = 0 + n, err := enc.out.Write(b) + if err != nil { + panic(err) + } + enc.pos += n + case variantType: + variant := v.Interface().(Variant) + enc.encode(reflect.ValueOf(variant.sig), depth+1) + enc.encode(reflect.ValueOf(variant.value), depth+1) + default: + for i := 0; i < v.Type().NumField(); i++ { + field := t.Field(i) + if field.PkgPath == "" && field.Tag.Get("dbus") != "-" { + enc.encode(v.Field(i), depth+1) + } + } + } + case reflect.Map: + // Maps are arrays of structures, so they actually increase the depth by + // 2. + if depth >= 63 { + panic(FormatError("input exceeds container depth limit")) + } + if !isKeyType(v.Type().Key()) { + panic(InvalidTypeError{v.Type()}) + } + keys := v.MapKeys() + var buf bytes.Buffer + bufenc := newEncoder(&buf, enc.order) + for _, k := range keys { + bufenc.align(8) + bufenc.encode(k, depth+2) + bufenc.encode(v.MapIndex(k), depth+2) + } + enc.encode(reflect.ValueOf(uint32(buf.Len())), depth) + length := buf.Len() + enc.align(8) + if _, err := buf.WriteTo(enc.out); err != nil { + panic(err) + } + enc.pos += length + default: + panic(InvalidTypeError{v.Type()}) + } +} diff --git a/vendor/src/github.com/godbus/dbus/export.go b/vendor/src/github.com/godbus/dbus/export.go new file mode 100644 index 0000000000..1dd1591528 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/export.go @@ -0,0 +1,302 @@ +package dbus + +import ( + "errors" + "reflect" + "strings" + "unicode" +) + +var ( + errmsgInvalidArg = Error{ + "org.freedesktop.DBus.Error.InvalidArgs", + []interface{}{"Invalid type / number of args"}, + } + errmsgNoObject = Error{ + "org.freedesktop.DBus.Error.NoSuchObject", + []interface{}{"No such object"}, + } + errmsgUnknownMethod = Error{ + "org.freedesktop.DBus.Error.UnknownMethod", + []interface{}{"Unknown / invalid method"}, + } +) + +// Sender is a type which can be used in exported methods to receive the message +// sender. +type Sender string + +func exportedMethod(v interface{}, name string) reflect.Value { + if v == nil { + return reflect.Value{} + } + m := reflect.ValueOf(v).MethodByName(name) + if !m.IsValid() { + return reflect.Value{} + } + t := m.Type() + if t.NumOut() == 0 || + t.Out(t.NumOut()-1) != reflect.TypeOf(&errmsgInvalidArg) { + + return reflect.Value{} + } + return m +} + +// handleCall handles the given method call (i.e. looks if it's one of the +// pre-implemented ones and searches for a corresponding handler if not). +func (conn *Conn) handleCall(msg *Message) { + name := msg.Headers[FieldMember].value.(string) + path := msg.Headers[FieldPath].value.(ObjectPath) + ifaceName, hasIface := msg.Headers[FieldInterface].value.(string) + sender, hasSender := msg.Headers[FieldSender].value.(string) + serial := msg.serial + if ifaceName == "org.freedesktop.DBus.Peer" { + switch name { + case "Ping": + conn.sendReply(sender, serial) + case "GetMachineId": + conn.sendReply(sender, serial, conn.uuid) + default: + conn.sendError(errmsgUnknownMethod, sender, serial) + } + return + } + if len(name) == 0 || unicode.IsLower([]rune(name)[0]) { + conn.sendError(errmsgUnknownMethod, sender, serial) + } + var m reflect.Value + if hasIface { + conn.handlersLck.RLock() + obj, ok := conn.handlers[path] + if !ok { + conn.sendError(errmsgNoObject, sender, serial) + conn.handlersLck.RUnlock() + return + } + iface := obj[ifaceName] + conn.handlersLck.RUnlock() + m = exportedMethod(iface, name) + } else { + conn.handlersLck.RLock() + if _, ok := conn.handlers[path]; !ok { + conn.sendError(errmsgNoObject, sender, serial) + conn.handlersLck.RUnlock() + return + } + for _, v := range conn.handlers[path] { + m = exportedMethod(v, name) + if m.IsValid() { + break + } + } + conn.handlersLck.RUnlock() + } + if !m.IsValid() { + conn.sendError(errmsgUnknownMethod, sender, serial) + return + } + t := m.Type() + vs := msg.Body + pointers := make([]interface{}, t.NumIn()) + decode := make([]interface{}, 0, len(vs)) + for i := 0; i < t.NumIn(); i++ { + tp := t.In(i) + val := reflect.New(tp) + pointers[i] = val.Interface() + if tp == reflect.TypeOf((*Sender)(nil)).Elem() { + val.Elem().SetString(sender) + } else { + decode = append(decode, pointers[i]) + } + } + if len(decode) != len(vs) { + conn.sendError(errmsgInvalidArg, sender, serial) + return + } + if err := Store(vs, decode...); err != nil { + conn.sendError(errmsgInvalidArg, sender, serial) + return + } + params := make([]reflect.Value, len(pointers)) + for i := 0; i < len(pointers); i++ { + params[i] = reflect.ValueOf(pointers[i]).Elem() + } + ret := m.Call(params) + if em := ret[t.NumOut()-1].Interface().(*Error); em != nil { + conn.sendError(*em, sender, serial) + return + } + if msg.Flags&FlagNoReplyExpected == 0 { + reply := new(Message) + reply.Type = TypeMethodReply + reply.serial = conn.getSerial() + reply.Headers = make(map[HeaderField]Variant) + if hasSender { + reply.Headers[FieldDestination] = msg.Headers[FieldSender] + } + reply.Headers[FieldReplySerial] = MakeVariant(msg.serial) + reply.Body = make([]interface{}, len(ret)-1) + for i := 0; i < len(ret)-1; i++ { + reply.Body[i] = ret[i].Interface() + } + if len(ret) != 1 { + reply.Headers[FieldSignature] = MakeVariant(SignatureOf(reply.Body...)) + } + conn.outLck.RLock() + if !conn.closed { + conn.out <- reply + } + conn.outLck.RUnlock() + } +} + +// Emit emits the given signal on the message bus. The name parameter must be +// formatted as "interface.member", e.g., "org.freedesktop.DBus.NameLost". +func (conn *Conn) Emit(path ObjectPath, name string, values ...interface{}) error { + if !path.IsValid() { + return errors.New("dbus: invalid object path") + } + i := strings.LastIndex(name, ".") + if i == -1 { + return errors.New("dbus: invalid method name") + } + iface := name[:i] + member := name[i+1:] + if !isValidMember(member) { + return errors.New("dbus: invalid method name") + } + if !isValidInterface(iface) { + return errors.New("dbus: invalid interface name") + } + msg := new(Message) + msg.Type = TypeSignal + msg.serial = conn.getSerial() + msg.Headers = make(map[HeaderField]Variant) + msg.Headers[FieldInterface] = MakeVariant(iface) + msg.Headers[FieldMember] = MakeVariant(member) + msg.Headers[FieldPath] = MakeVariant(path) + msg.Body = values + if len(values) > 0 { + msg.Headers[FieldSignature] = MakeVariant(SignatureOf(values...)) + } + conn.outLck.RLock() + defer conn.outLck.RUnlock() + if conn.closed { + return ErrClosed + } + conn.out <- msg + return nil +} + +// Export registers the given value to be exported as an object on the +// message bus. +// +// If a method call on the given path and interface is received, an exported +// method with the same name is called with v as the receiver if the +// parameters match and the last return value is of type *Error. If this +// *Error is not nil, it is sent back to the caller as an error. +// Otherwise, a method reply is sent with the other return values as its body. +// +// Any parameters with the special type Sender are set to the sender of the +// dbus message when the method is called. Parameters of this type do not +// contribute to the dbus signature of the method (i.e. the method is exposed +// as if the parameters of type Sender were not there). +// +// Every method call is executed in a new goroutine, so the method may be called +// in multiple goroutines at once. +// +// Method calls on the interface org.freedesktop.DBus.Peer will be automatically +// handled for every object. +// +// Passing nil as the first parameter will cause conn to cease handling calls on +// the given combination of path and interface. +// +// Export returns an error if path is not a valid path name. +func (conn *Conn) Export(v interface{}, path ObjectPath, iface string) error { + if !path.IsValid() { + return errors.New("dbus: invalid path name") + } + conn.handlersLck.Lock() + if v == nil { + if _, ok := conn.handlers[path]; ok { + delete(conn.handlers[path], iface) + if len(conn.handlers[path]) == 0 { + delete(conn.handlers, path) + } + } + return nil + } + if _, ok := conn.handlers[path]; !ok { + conn.handlers[path] = make(map[string]interface{}) + } + conn.handlers[path][iface] = v + conn.handlersLck.Unlock() + return nil +} + +// ReleaseName calls org.freedesktop.DBus.ReleaseName. You should use only this +// method to release a name (see below). +func (conn *Conn) ReleaseName(name string) (ReleaseNameReply, error) { + var r uint32 + err := conn.busObj.Call("org.freedesktop.DBus.ReleaseName", 0, name).Store(&r) + if err != nil { + return 0, err + } + if r == uint32(ReleaseNameReplyReleased) { + conn.namesLck.Lock() + for i, v := range conn.names { + if v == name { + copy(conn.names[i:], conn.names[i+1:]) + conn.names = conn.names[:len(conn.names)-1] + } + } + conn.namesLck.Unlock() + } + return ReleaseNameReply(r), nil +} + +// RequestName calls org.freedesktop.DBus.RequestName. You should use only this +// method to request a name because package dbus needs to keep track of all +// names that the connection has. +func (conn *Conn) RequestName(name string, flags RequestNameFlags) (RequestNameReply, error) { + var r uint32 + err := conn.busObj.Call("org.freedesktop.DBus.RequestName", 0, name, flags).Store(&r) + if err != nil { + return 0, err + } + if r == uint32(RequestNameReplyPrimaryOwner) { + conn.namesLck.Lock() + conn.names = append(conn.names, name) + conn.namesLck.Unlock() + } + return RequestNameReply(r), nil +} + +// ReleaseNameReply is the reply to a ReleaseName call. +type ReleaseNameReply uint32 + +const ( + ReleaseNameReplyReleased ReleaseNameReply = 1 + iota + ReleaseNameReplyNonExistent + ReleaseNameReplyNotOwner +) + +// RequestNameFlags represents the possible flags for a RequestName call. +type RequestNameFlags uint32 + +const ( + NameFlagAllowReplacement RequestNameFlags = 1 << iota + NameFlagReplaceExisting + NameFlagDoNotQueue +) + +// RequestNameReply is the reply to a RequestName call. +type RequestNameReply uint32 + +const ( + RequestNameReplyPrimaryOwner RequestNameReply = 1 + iota + RequestNameReplyInQueue + RequestNameReplyExists + RequestNameReplyAlreadyOwner +) diff --git a/vendor/src/github.com/godbus/dbus/homedir.go b/vendor/src/github.com/godbus/dbus/homedir.go new file mode 100644 index 0000000000..0b745f9313 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/homedir.go @@ -0,0 +1,28 @@ +package dbus + +import ( + "os" + "sync" +) + +var ( + homeDir string + homeDirLock sync.Mutex +) + +func getHomeDir() string { + homeDirLock.Lock() + defer homeDirLock.Unlock() + + if homeDir != "" { + return homeDir + } + + homeDir = os.Getenv("HOME") + if homeDir != "" { + return homeDir + } + + homeDir = lookupHomeDir() + return homeDir +} diff --git a/vendor/src/github.com/godbus/dbus/homedir_dynamic.go b/vendor/src/github.com/godbus/dbus/homedir_dynamic.go new file mode 100644 index 0000000000..2732081e73 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/homedir_dynamic.go @@ -0,0 +1,15 @@ +// +build !static_build + +package dbus + +import ( + "os/user" +) + +func lookupHomeDir() string { + u, err := user.Current() + if err != nil { + return "/" + } + return u.HomeDir +} diff --git a/vendor/src/github.com/godbus/dbus/homedir_static.go b/vendor/src/github.com/godbus/dbus/homedir_static.go new file mode 100644 index 0000000000..b9d9cb5525 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/homedir_static.go @@ -0,0 +1,45 @@ +// +build static_build + +package dbus + +import ( + "bufio" + "os" + "strconv" + "strings" +) + +func lookupHomeDir() string { + myUid := os.Getuid() + + f, err := os.Open("/etc/passwd") + if err != nil { + return "/" + } + defer f.Close() + + s := bufio.NewScanner(f) + + for s.Scan() { + if err := s.Err(); err != nil { + break + } + + line := strings.TrimSpace(s.Text()) + if line == "" { + continue + } + + parts := strings.Split(line, ":") + + if len(parts) >= 6 { + uid, err := strconv.Atoi(parts[2]) + if err == nil && uid == myUid { + return parts[5] + } + } + } + + // Default to / if we can't get a better value + return "/" +} diff --git a/vendor/src/github.com/godbus/dbus/message.go b/vendor/src/github.com/godbus/dbus/message.go new file mode 100644 index 0000000000..075d6e38ba --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/message.go @@ -0,0 +1,346 @@ +package dbus + +import ( + "bytes" + "encoding/binary" + "errors" + "io" + "reflect" + "strconv" +) + +const protoVersion byte = 1 + +// Flags represents the possible flags of a D-Bus message. +type Flags byte + +const ( + // FlagNoReplyExpected signals that the message is not expected to generate + // a reply. If this flag is set on outgoing messages, any possible reply + // will be discarded. + FlagNoReplyExpected Flags = 1 << iota + // FlagNoAutoStart signals that the message bus should not automatically + // start an application when handling this message. + FlagNoAutoStart +) + +// Type represents the possible types of a D-Bus message. +type Type byte + +const ( + TypeMethodCall Type = 1 + iota + TypeMethodReply + TypeError + TypeSignal + typeMax +) + +func (t Type) String() string { + switch t { + case TypeMethodCall: + return "method call" + case TypeMethodReply: + return "reply" + case TypeError: + return "error" + case TypeSignal: + return "signal" + } + return "invalid" +} + +// HeaderField represents the possible byte codes for the headers +// of a D-Bus message. +type HeaderField byte + +const ( + FieldPath HeaderField = 1 + iota + FieldInterface + FieldMember + FieldErrorName + FieldReplySerial + FieldDestination + FieldSender + FieldSignature + FieldUnixFDs + fieldMax +) + +// An InvalidMessageError describes the reason why a D-Bus message is regarded as +// invalid. +type InvalidMessageError string + +func (e InvalidMessageError) Error() string { + return "dbus: invalid message: " + string(e) +} + +// fieldType are the types of the various header fields. +var fieldTypes = [fieldMax]reflect.Type{ + FieldPath: objectPathType, + FieldInterface: stringType, + FieldMember: stringType, + FieldErrorName: stringType, + FieldReplySerial: uint32Type, + FieldDestination: stringType, + FieldSender: stringType, + FieldSignature: signatureType, + FieldUnixFDs: uint32Type, +} + +// requiredFields lists the header fields that are required by the different +// message types. +var requiredFields = [typeMax][]HeaderField{ + TypeMethodCall: {FieldPath, FieldMember}, + TypeMethodReply: {FieldReplySerial}, + TypeError: {FieldErrorName, FieldReplySerial}, + TypeSignal: {FieldPath, FieldInterface, FieldMember}, +} + +// Message represents a single D-Bus message. +type Message struct { + Type + Flags + Headers map[HeaderField]Variant + Body []interface{} + + serial uint32 +} + +type header struct { + Field byte + Variant +} + +// DecodeMessage tries to decode a single message in the D-Bus wire format +// from the given reader. The byte order is figured out from the first byte. +// The possibly returned error can be an error of the underlying reader, an +// InvalidMessageError or a FormatError. +func DecodeMessage(rd io.Reader) (msg *Message, err error) { + var order binary.ByteOrder + var hlength, length uint32 + var typ, flags, proto byte + var headers []header + + b := make([]byte, 1) + _, err = rd.Read(b) + if err != nil { + return + } + switch b[0] { + case 'l': + order = binary.LittleEndian + case 'B': + order = binary.BigEndian + default: + return nil, InvalidMessageError("invalid byte order") + } + + dec := newDecoder(rd, order) + dec.pos = 1 + + msg = new(Message) + vs, err := dec.Decode(Signature{"yyyuu"}) + if err != nil { + return nil, err + } + if err = Store(vs, &typ, &flags, &proto, &length, &msg.serial); err != nil { + return nil, err + } + msg.Type = Type(typ) + msg.Flags = Flags(flags) + + // get the header length separately because we need it later + b = make([]byte, 4) + _, err = io.ReadFull(rd, b) + if err != nil { + return nil, err + } + binary.Read(bytes.NewBuffer(b), order, &hlength) + if hlength+length+16 > 1<<27 { + return nil, InvalidMessageError("message is too long") + } + dec = newDecoder(io.MultiReader(bytes.NewBuffer(b), rd), order) + dec.pos = 12 + vs, err = dec.Decode(Signature{"a(yv)"}) + if err != nil { + return nil, err + } + if err = Store(vs, &headers); err != nil { + return nil, err + } + + msg.Headers = make(map[HeaderField]Variant) + for _, v := range headers { + msg.Headers[HeaderField(v.Field)] = v.Variant + } + + dec.align(8) + body := make([]byte, int(length)) + if length != 0 { + _, err := io.ReadFull(rd, body) + if err != nil { + return nil, err + } + } + + if err = msg.IsValid(); err != nil { + return nil, err + } + sig, _ := msg.Headers[FieldSignature].value.(Signature) + if sig.str != "" { + buf := bytes.NewBuffer(body) + dec = newDecoder(buf, order) + vs, err := dec.Decode(sig) + if err != nil { + return nil, err + } + msg.Body = vs + } + + return +} + +// EncodeTo encodes and sends a message to the given writer. The byte order must +// be either binary.LittleEndian or binary.BigEndian. If the message is not +// valid or an error occurs when writing, an error is returned. +func (msg *Message) EncodeTo(out io.Writer, order binary.ByteOrder) error { + if err := msg.IsValid(); err != nil { + return err + } + var vs [7]interface{} + switch order { + case binary.LittleEndian: + vs[0] = byte('l') + case binary.BigEndian: + vs[0] = byte('B') + default: + return errors.New("dbus: invalid byte order") + } + body := new(bytes.Buffer) + enc := newEncoder(body, order) + if len(msg.Body) != 0 { + enc.Encode(msg.Body...) + } + vs[1] = msg.Type + vs[2] = msg.Flags + vs[3] = protoVersion + vs[4] = uint32(len(body.Bytes())) + vs[5] = msg.serial + headers := make([]header, 0, len(msg.Headers)) + for k, v := range msg.Headers { + headers = append(headers, header{byte(k), v}) + } + vs[6] = headers + var buf bytes.Buffer + enc = newEncoder(&buf, order) + enc.Encode(vs[:]...) + enc.align(8) + body.WriteTo(&buf) + if buf.Len() > 1<<27 { + return InvalidMessageError("message is too long") + } + if _, err := buf.WriteTo(out); err != nil { + return err + } + return nil +} + +// IsValid checks whether msg is a valid message and returns an +// InvalidMessageError if it is not. +func (msg *Message) IsValid() error { + if msg.Flags & ^(FlagNoAutoStart|FlagNoReplyExpected) != 0 { + return InvalidMessageError("invalid flags") + } + if msg.Type == 0 || msg.Type >= typeMax { + return InvalidMessageError("invalid message type") + } + for k, v := range msg.Headers { + if k == 0 || k >= fieldMax { + return InvalidMessageError("invalid header") + } + if reflect.TypeOf(v.value) != fieldTypes[k] { + return InvalidMessageError("invalid type of header field") + } + } + for _, v := range requiredFields[msg.Type] { + if _, ok := msg.Headers[v]; !ok { + return InvalidMessageError("missing required header") + } + } + if path, ok := msg.Headers[FieldPath]; ok { + if !path.value.(ObjectPath).IsValid() { + return InvalidMessageError("invalid path name") + } + } + if iface, ok := msg.Headers[FieldInterface]; ok { + if !isValidInterface(iface.value.(string)) { + return InvalidMessageError("invalid interface name") + } + } + if member, ok := msg.Headers[FieldMember]; ok { + if !isValidMember(member.value.(string)) { + return InvalidMessageError("invalid member name") + } + } + if errname, ok := msg.Headers[FieldErrorName]; ok { + if !isValidInterface(errname.value.(string)) { + return InvalidMessageError("invalid error name") + } + } + if len(msg.Body) != 0 { + if _, ok := msg.Headers[FieldSignature]; !ok { + return InvalidMessageError("missing signature") + } + } + return nil +} + +// Serial returns the message's serial number. The returned value is only valid +// for messages received by eavesdropping. +func (msg *Message) Serial() uint32 { + return msg.serial +} + +// String returns a string representation of a message similar to the format of +// dbus-monitor. +func (msg *Message) String() string { + if err := msg.IsValid(); err != nil { + return "" + } + s := msg.Type.String() + if v, ok := msg.Headers[FieldSender]; ok { + s += " from " + v.value.(string) + } + if v, ok := msg.Headers[FieldDestination]; ok { + s += " to " + v.value.(string) + } + s += " serial " + strconv.FormatUint(uint64(msg.serial), 10) + if v, ok := msg.Headers[FieldReplySerial]; ok { + s += " reply_serial " + strconv.FormatUint(uint64(v.value.(uint32)), 10) + } + if v, ok := msg.Headers[FieldUnixFDs]; ok { + s += " unixfds " + strconv.FormatUint(uint64(v.value.(uint32)), 10) + } + if v, ok := msg.Headers[FieldPath]; ok { + s += " path " + string(v.value.(ObjectPath)) + } + if v, ok := msg.Headers[FieldInterface]; ok { + s += " interface " + v.value.(string) + } + if v, ok := msg.Headers[FieldErrorName]; ok { + s += " error " + v.value.(string) + } + if v, ok := msg.Headers[FieldMember]; ok { + s += " member " + v.value.(string) + } + if len(msg.Body) != 0 { + s += "\n" + } + for i, v := range msg.Body { + s += " " + MakeVariant(v).String() + if i != len(msg.Body)-1 { + s += "\n" + } + } + return s +} diff --git a/vendor/src/github.com/godbus/dbus/sig.go b/vendor/src/github.com/godbus/dbus/sig.go new file mode 100644 index 0000000000..f45b53ce1b --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/sig.go @@ -0,0 +1,257 @@ +package dbus + +import ( + "fmt" + "reflect" + "strings" +) + +var sigToType = map[byte]reflect.Type{ + 'y': byteType, + 'b': boolType, + 'n': int16Type, + 'q': uint16Type, + 'i': int32Type, + 'u': uint32Type, + 'x': int64Type, + 't': uint64Type, + 'd': float64Type, + 's': stringType, + 'g': signatureType, + 'o': objectPathType, + 'v': variantType, + 'h': unixFDIndexType, +} + +// Signature represents a correct type signature as specified by the D-Bus +// specification. The zero value represents the empty signature, "". +type Signature struct { + str string +} + +// SignatureOf returns the concatenation of all the signatures of the given +// values. It panics if one of them is not representable in D-Bus. +func SignatureOf(vs ...interface{}) Signature { + var s string + for _, v := range vs { + s += getSignature(reflect.TypeOf(v)) + } + return Signature{s} +} + +// SignatureOfType returns the signature of the given type. It panics if the +// type is not representable in D-Bus. +func SignatureOfType(t reflect.Type) Signature { + return Signature{getSignature(t)} +} + +// getSignature returns the signature of the given type and panics on unknown types. +func getSignature(t reflect.Type) string { + // handle simple types first + switch t.Kind() { + case reflect.Uint8: + return "y" + case reflect.Bool: + return "b" + case reflect.Int16: + return "n" + case reflect.Uint16: + return "q" + case reflect.Int32: + if t == unixFDType { + return "h" + } + return "i" + case reflect.Uint32: + if t == unixFDIndexType { + return "h" + } + return "u" + case reflect.Int64: + return "x" + case reflect.Uint64: + return "t" + case reflect.Float64: + return "d" + case reflect.Ptr: + return getSignature(t.Elem()) + case reflect.String: + if t == objectPathType { + return "o" + } + return "s" + case reflect.Struct: + if t == variantType { + return "v" + } else if t == signatureType { + return "g" + } + var s string + for i := 0; i < t.NumField(); i++ { + field := t.Field(i) + if field.PkgPath == "" && field.Tag.Get("dbus") != "-" { + s += getSignature(t.Field(i).Type) + } + } + return "(" + s + ")" + case reflect.Array, reflect.Slice: + return "a" + getSignature(t.Elem()) + case reflect.Map: + if !isKeyType(t.Key()) { + panic(InvalidTypeError{t}) + } + return "a{" + getSignature(t.Key()) + getSignature(t.Elem()) + "}" + } + panic(InvalidTypeError{t}) +} + +// ParseSignature returns the signature represented by this string, or a +// SignatureError if the string is not a valid signature. +func ParseSignature(s string) (sig Signature, err error) { + if len(s) == 0 { + return + } + if len(s) > 255 { + return Signature{""}, SignatureError{s, "too long"} + } + sig.str = s + for err == nil && len(s) != 0 { + err, s = validSingle(s, 0) + } + if err != nil { + sig = Signature{""} + } + + return +} + +// ParseSignatureMust behaves like ParseSignature, except that it panics if s +// is not valid. +func ParseSignatureMust(s string) Signature { + sig, err := ParseSignature(s) + if err != nil { + panic(err) + } + return sig +} + +// Empty retruns whether the signature is the empty signature. +func (s Signature) Empty() bool { + return s.str == "" +} + +// Single returns whether the signature represents a single, complete type. +func (s Signature) Single() bool { + err, r := validSingle(s.str, 0) + return err != nil && r == "" +} + +// String returns the signature's string representation. +func (s Signature) String() string { + return s.str +} + +// A SignatureError indicates that a signature passed to a function or received +// on a connection is not a valid signature. +type SignatureError struct { + Sig string + Reason string +} + +func (e SignatureError) Error() string { + return fmt.Sprintf("dbus: invalid signature: %q (%s)", e.Sig, e.Reason) +} + +// Try to read a single type from this string. If it was successfull, err is nil +// and rem is the remaining unparsed part. Otherwise, err is a non-nil +// SignatureError and rem is "". depth is the current recursion depth which may +// not be greater than 64 and should be given as 0 on the first call. +func validSingle(s string, depth int) (err error, rem string) { + if s == "" { + return SignatureError{Sig: s, Reason: "empty signature"}, "" + } + if depth > 64 { + return SignatureError{Sig: s, Reason: "container nesting too deep"}, "" + } + switch s[0] { + case 'y', 'b', 'n', 'q', 'i', 'u', 'x', 't', 'd', 's', 'g', 'o', 'v', 'h': + return nil, s[1:] + case 'a': + if len(s) > 1 && s[1] == '{' { + i := findMatching(s[1:], '{', '}') + if i == -1 { + return SignatureError{Sig: s, Reason: "unmatched '{'"}, "" + } + i++ + rem = s[i+1:] + s = s[2:i] + if err, _ = validSingle(s[:1], depth+1); err != nil { + return err, "" + } + err, nr := validSingle(s[1:], depth+1) + if err != nil { + return err, "" + } + if nr != "" { + return SignatureError{Sig: s, Reason: "too many types in dict"}, "" + } + return nil, rem + } + return validSingle(s[1:], depth+1) + case '(': + i := findMatching(s, '(', ')') + if i == -1 { + return SignatureError{Sig: s, Reason: "unmatched ')'"}, "" + } + rem = s[i+1:] + s = s[1:i] + for err == nil && s != "" { + err, s = validSingle(s, depth+1) + } + if err != nil { + rem = "" + } + return + } + return SignatureError{Sig: s, Reason: "invalid type character"}, "" +} + +func findMatching(s string, left, right rune) int { + n := 0 + for i, v := range s { + if v == left { + n++ + } else if v == right { + n-- + } + if n == 0 { + return i + } + } + return -1 +} + +// typeFor returns the type of the given signature. It ignores any left over +// characters and panics if s doesn't start with a valid type signature. +func typeFor(s string) (t reflect.Type) { + err, _ := validSingle(s, 0) + if err != nil { + panic(err) + } + + if t, ok := sigToType[s[0]]; ok { + return t + } + switch s[0] { + case 'a': + if s[1] == '{' { + i := strings.LastIndex(s, "}") + t = reflect.MapOf(sigToType[s[2]], typeFor(s[3:i])) + } else { + t = reflect.SliceOf(typeFor(s[1:])) + } + case '(': + t = interfacesType + } + return +} diff --git a/vendor/src/github.com/godbus/dbus/transport_darwin.go b/vendor/src/github.com/godbus/dbus/transport_darwin.go new file mode 100644 index 0000000000..1bba0d6bf7 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/transport_darwin.go @@ -0,0 +1,6 @@ +package dbus + +func (t *unixTransport) SendNullByte() error { + _, err := t.Write([]byte{0}) + return err +} diff --git a/vendor/src/github.com/godbus/dbus/transport_generic.go b/vendor/src/github.com/godbus/dbus/transport_generic.go new file mode 100644 index 0000000000..46f8f49d69 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/transport_generic.go @@ -0,0 +1,35 @@ +package dbus + +import ( + "encoding/binary" + "errors" + "io" +) + +type genericTransport struct { + io.ReadWriteCloser +} + +func (t genericTransport) SendNullByte() error { + _, err := t.Write([]byte{0}) + return err +} + +func (t genericTransport) SupportsUnixFDs() bool { + return false +} + +func (t genericTransport) EnableUnixFDs() {} + +func (t genericTransport) ReadMessage() (*Message, error) { + return DecodeMessage(t) +} + +func (t genericTransport) SendMessage(msg *Message) error { + for _, v := range msg.Body { + if _, ok := v.(UnixFD); ok { + return errors.New("dbus: unix fd passing not enabled") + } + } + return msg.EncodeTo(t, binary.LittleEndian) +} diff --git a/vendor/src/github.com/godbus/dbus/transport_unix.go b/vendor/src/github.com/godbus/dbus/transport_unix.go new file mode 100644 index 0000000000..3fafeabb15 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/transport_unix.go @@ -0,0 +1,196 @@ +//+build !windows + +package dbus + +import ( + "bytes" + "encoding/binary" + "errors" + "io" + "net" + "syscall" +) + +type oobReader struct { + conn *net.UnixConn + oob []byte + buf [4096]byte +} + +func (o *oobReader) Read(b []byte) (n int, err error) { + n, oobn, flags, _, err := o.conn.ReadMsgUnix(b, o.buf[:]) + if err != nil { + return n, err + } + if flags&syscall.MSG_CTRUNC != 0 { + return n, errors.New("dbus: control data truncated (too many fds received)") + } + o.oob = append(o.oob, o.buf[:oobn]...) + return n, nil +} + +type unixTransport struct { + *net.UnixConn + hasUnixFDs bool +} + +func newUnixTransport(keys string) (transport, error) { + var err error + + t := new(unixTransport) + abstract := getKey(keys, "abstract") + path := getKey(keys, "path") + switch { + case abstract == "" && path == "": + return nil, errors.New("dbus: invalid address (neither path nor abstract set)") + case abstract != "" && path == "": + t.UnixConn, err = net.DialUnix("unix", nil, &net.UnixAddr{Name: "@" + abstract, Net: "unix"}) + if err != nil { + return nil, err + } + return t, nil + case abstract == "" && path != "": + t.UnixConn, err = net.DialUnix("unix", nil, &net.UnixAddr{Name: path, Net: "unix"}) + if err != nil { + return nil, err + } + return t, nil + default: + return nil, errors.New("dbus: invalid address (both path and abstract set)") + } +} + +func init() { + transports["unix"] = newUnixTransport +} + +func (t *unixTransport) EnableUnixFDs() { + t.hasUnixFDs = true +} + +func (t *unixTransport) ReadMessage() (*Message, error) { + var ( + blen, hlen uint32 + csheader [16]byte + headers []header + order binary.ByteOrder + unixfds uint32 + ) + // To be sure that all bytes of out-of-band data are read, we use a special + // reader that uses ReadUnix on the underlying connection instead of Read + // and gathers the out-of-band data in a buffer. + rd := &oobReader{conn: t.UnixConn} + // read the first 16 bytes (the part of the header that has a constant size), + // from which we can figure out the length of the rest of the message + if _, err := io.ReadFull(rd, csheader[:]); err != nil { + return nil, err + } + switch csheader[0] { + case 'l': + order = binary.LittleEndian + case 'B': + order = binary.BigEndian + default: + return nil, InvalidMessageError("invalid byte order") + } + // csheader[4:8] -> length of message body, csheader[12:16] -> length of + // header fields (without alignment) + binary.Read(bytes.NewBuffer(csheader[4:8]), order, &blen) + binary.Read(bytes.NewBuffer(csheader[12:]), order, &hlen) + if hlen%8 != 0 { + hlen += 8 - (hlen % 8) + } + + // decode headers and look for unix fds + headerdata := make([]byte, hlen+4) + copy(headerdata, csheader[12:]) + if _, err := io.ReadFull(t, headerdata[4:]); err != nil { + return nil, err + } + dec := newDecoder(bytes.NewBuffer(headerdata), order) + dec.pos = 12 + vs, err := dec.Decode(Signature{"a(yv)"}) + if err != nil { + return nil, err + } + Store(vs, &headers) + for _, v := range headers { + if v.Field == byte(FieldUnixFDs) { + unixfds, _ = v.Variant.value.(uint32) + } + } + all := make([]byte, 16+hlen+blen) + copy(all, csheader[:]) + copy(all[16:], headerdata[4:]) + if _, err := io.ReadFull(rd, all[16+hlen:]); err != nil { + return nil, err + } + if unixfds != 0 { + if !t.hasUnixFDs { + return nil, errors.New("dbus: got unix fds on unsupported transport") + } + // read the fds from the OOB data + scms, err := syscall.ParseSocketControlMessage(rd.oob) + if err != nil { + return nil, err + } + if len(scms) != 1 { + return nil, errors.New("dbus: received more than one socket control message") + } + fds, err := syscall.ParseUnixRights(&scms[0]) + if err != nil { + return nil, err + } + msg, err := DecodeMessage(bytes.NewBuffer(all)) + if err != nil { + return nil, err + } + // substitute the values in the message body (which are indices for the + // array receiver via OOB) with the actual values + for i, v := range msg.Body { + if j, ok := v.(UnixFDIndex); ok { + if uint32(j) >= unixfds { + return nil, InvalidMessageError("invalid index for unix fd") + } + msg.Body[i] = UnixFD(fds[j]) + } + } + return msg, nil + } + return DecodeMessage(bytes.NewBuffer(all)) +} + +func (t *unixTransport) SendMessage(msg *Message) error { + fds := make([]int, 0) + for i, v := range msg.Body { + if fd, ok := v.(UnixFD); ok { + msg.Body[i] = UnixFDIndex(len(fds)) + fds = append(fds, int(fd)) + } + } + if len(fds) != 0 { + if !t.hasUnixFDs { + return errors.New("dbus: unix fd passing not enabled") + } + msg.Headers[FieldUnixFDs] = MakeVariant(uint32(len(fds))) + oob := syscall.UnixRights(fds...) + buf := new(bytes.Buffer) + msg.EncodeTo(buf, binary.LittleEndian) + n, oobn, err := t.UnixConn.WriteMsgUnix(buf.Bytes(), oob, nil) + if err != nil { + return err + } + if n != buf.Len() || oobn != len(oob) { + return io.ErrShortWrite + } + } else { + if err := msg.EncodeTo(t, binary.LittleEndian); err != nil { + return nil + } + } + return nil +} + +func (t *unixTransport) SupportsUnixFDs() bool { + return true +} diff --git a/vendor/src/github.com/godbus/dbus/transport_unixcred_dragonfly.go b/vendor/src/github.com/godbus/dbus/transport_unixcred_dragonfly.go new file mode 100644 index 0000000000..a8cd39395f --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/transport_unixcred_dragonfly.go @@ -0,0 +1,95 @@ +// The UnixCredentials system call is currently only implemented on Linux +// http://golang.org/src/pkg/syscall/sockcmsg_linux.go +// https://golang.org/s/go1.4-syscall +// http://code.google.com/p/go/source/browse/unix/sockcmsg_linux.go?repo=sys + +// Local implementation of the UnixCredentials system call for DragonFly BSD + +package dbus + +/* +#include +*/ +import "C" + +import ( + "io" + "os" + "syscall" + "unsafe" +) + +// http://golang.org/src/pkg/syscall/ztypes_linux_amd64.go +// http://golang.org/src/pkg/syscall/ztypes_dragonfly_amd64.go +type Ucred struct { + Pid int32 + Uid uint32 + Gid uint32 +} + +// http://golang.org/src/pkg/syscall/types_linux.go +// http://golang.org/src/pkg/syscall/types_dragonfly.go +// https://github.com/DragonFlyBSD/DragonFlyBSD/blob/master/sys/sys/ucred.h +const ( + SizeofUcred = C.sizeof_struct_ucred +) + +// http://golang.org/src/pkg/syscall/sockcmsg_unix.go +func cmsgAlignOf(salen int) int { + // From http://golang.org/src/pkg/syscall/sockcmsg_unix.go + //salign := sizeofPtr + // NOTE: It seems like 64-bit Darwin and DragonFly BSD kernels + // still require 32-bit aligned access to network subsystem. + //if darwin64Bit || dragonfly64Bit { + // salign = 4 + //} + salign := 4 + return (salen + salign - 1) & ^(salign - 1) +} + +// http://golang.org/src/pkg/syscall/sockcmsg_unix.go +func cmsgData(h *syscall.Cmsghdr) unsafe.Pointer { + return unsafe.Pointer(uintptr(unsafe.Pointer(h)) + uintptr(cmsgAlignOf(syscall.SizeofCmsghdr))) +} + +// http://golang.org/src/pkg/syscall/sockcmsg_linux.go +// UnixCredentials encodes credentials into a socket control message +// for sending to another process. This can be used for +// authentication. +func UnixCredentials(ucred *Ucred) []byte { + b := make([]byte, syscall.CmsgSpace(SizeofUcred)) + h := (*syscall.Cmsghdr)(unsafe.Pointer(&b[0])) + h.Level = syscall.SOL_SOCKET + h.Type = syscall.SCM_CREDS + h.SetLen(syscall.CmsgLen(SizeofUcred)) + *((*Ucred)(cmsgData(h))) = *ucred + return b +} + +// http://golang.org/src/pkg/syscall/sockcmsg_linux.go +// ParseUnixCredentials decodes a socket control message that contains +// credentials in a Ucred structure. To receive such a message, the +// SO_PASSCRED option must be enabled on the socket. +func ParseUnixCredentials(m *syscall.SocketControlMessage) (*Ucred, error) { + if m.Header.Level != syscall.SOL_SOCKET { + return nil, syscall.EINVAL + } + if m.Header.Type != syscall.SCM_CREDS { + return nil, syscall.EINVAL + } + ucred := *(*Ucred)(unsafe.Pointer(&m.Data[0])) + return &ucred, nil +} + +func (t *unixTransport) SendNullByte() error { + ucred := &Ucred{Pid: int32(os.Getpid()), Uid: uint32(os.Getuid()), Gid: uint32(os.Getgid())} + b := UnixCredentials(ucred) + _, oobn, err := t.UnixConn.WriteMsgUnix([]byte{0}, b, nil) + if err != nil { + return err + } + if oobn != len(b) { + return io.ErrShortWrite + } + return nil +} diff --git a/vendor/src/github.com/godbus/dbus/transport_unixcred_linux.go b/vendor/src/github.com/godbus/dbus/transport_unixcred_linux.go new file mode 100644 index 0000000000..d9dfdf6982 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/transport_unixcred_linux.go @@ -0,0 +1,25 @@ +// The UnixCredentials system call is currently only implemented on Linux +// http://golang.org/src/pkg/syscall/sockcmsg_linux.go +// https://golang.org/s/go1.4-syscall +// http://code.google.com/p/go/source/browse/unix/sockcmsg_linux.go?repo=sys + +package dbus + +import ( + "io" + "os" + "syscall" +) + +func (t *unixTransport) SendNullByte() error { + ucred := &syscall.Ucred{Pid: int32(os.Getpid()), Uid: uint32(os.Getuid()), Gid: uint32(os.Getgid())} + b := syscall.UnixCredentials(ucred) + _, oobn, err := t.UnixConn.WriteMsgUnix([]byte{0}, b, nil) + if err != nil { + return err + } + if oobn != len(b) { + return io.ErrShortWrite + } + return nil +} diff --git a/vendor/src/github.com/godbus/dbus/variant.go b/vendor/src/github.com/godbus/dbus/variant.go new file mode 100644 index 0000000000..b7b13ae90d --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/variant.go @@ -0,0 +1,139 @@ +package dbus + +import ( + "bytes" + "fmt" + "reflect" + "sort" + "strconv" +) + +// Variant represents the D-Bus variant type. +type Variant struct { + sig Signature + value interface{} +} + +// MakeVariant converts the given value to a Variant. It panics if v cannot be +// represented as a D-Bus type. +func MakeVariant(v interface{}) Variant { + return Variant{SignatureOf(v), v} +} + +// ParseVariant parses the given string as a variant as described at +// https://developer.gnome.org/glib/unstable/gvariant-text.html. If sig is not +// empty, it is taken to be the expected signature for the variant. +func ParseVariant(s string, sig Signature) (Variant, error) { + tokens := varLex(s) + p := &varParser{tokens: tokens} + n, err := varMakeNode(p) + if err != nil { + return Variant{}, err + } + if sig.str == "" { + sig, err = varInfer(n) + if err != nil { + return Variant{}, err + } + } + v, err := n.Value(sig) + if err != nil { + return Variant{}, err + } + return MakeVariant(v), nil +} + +// format returns a formatted version of v and whether this string can be parsed +// unambigously. +func (v Variant) format() (string, bool) { + switch v.sig.str[0] { + case 'b', 'i': + return fmt.Sprint(v.value), true + case 'n', 'q', 'u', 'x', 't', 'd', 'h': + return fmt.Sprint(v.value), false + case 's': + return strconv.Quote(v.value.(string)), true + case 'o': + return strconv.Quote(string(v.value.(ObjectPath))), false + case 'g': + return strconv.Quote(v.value.(Signature).str), false + case 'v': + s, unamb := v.value.(Variant).format() + if !unamb { + return "<@" + v.value.(Variant).sig.str + " " + s + ">", true + } + return "<" + s + ">", true + case 'y': + return fmt.Sprintf("%#x", v.value.(byte)), false + } + rv := reflect.ValueOf(v.value) + switch rv.Kind() { + case reflect.Slice: + if rv.Len() == 0 { + return "[]", false + } + unamb := true + buf := bytes.NewBuffer([]byte("[")) + for i := 0; i < rv.Len(); i++ { + // TODO: slooow + s, b := MakeVariant(rv.Index(i).Interface()).format() + unamb = unamb && b + buf.WriteString(s) + if i != rv.Len()-1 { + buf.WriteString(", ") + } + } + buf.WriteByte(']') + return buf.String(), unamb + case reflect.Map: + if rv.Len() == 0 { + return "{}", false + } + unamb := true + var buf bytes.Buffer + kvs := make([]string, rv.Len()) + for i, k := range rv.MapKeys() { + s, b := MakeVariant(k.Interface()).format() + unamb = unamb && b + buf.Reset() + buf.WriteString(s) + buf.WriteString(": ") + s, b = MakeVariant(rv.MapIndex(k).Interface()).format() + unamb = unamb && b + buf.WriteString(s) + kvs[i] = buf.String() + } + buf.Reset() + buf.WriteByte('{') + sort.Strings(kvs) + for i, kv := range kvs { + if i > 0 { + buf.WriteString(", ") + } + buf.WriteString(kv) + } + buf.WriteByte('}') + return buf.String(), unamb + } + return `"INVALID"`, true +} + +// Signature returns the D-Bus signature of the underlying value of v. +func (v Variant) Signature() Signature { + return v.sig +} + +// String returns the string representation of the underlying value of v as +// described at https://developer.gnome.org/glib/unstable/gvariant-text.html. +func (v Variant) String() string { + s, unamb := v.format() + if !unamb { + return "@" + v.sig.str + " " + s + } + return s +} + +// Value returns the underlying value of v. +func (v Variant) Value() interface{} { + return v.value +} diff --git a/vendor/src/github.com/godbus/dbus/variant_lexer.go b/vendor/src/github.com/godbus/dbus/variant_lexer.go new file mode 100644 index 0000000000..332007d6f1 --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/variant_lexer.go @@ -0,0 +1,284 @@ +package dbus + +import ( + "fmt" + "strings" + "unicode" + "unicode/utf8" +) + +// Heavily inspired by the lexer from text/template. + +type varToken struct { + typ varTokenType + val string +} + +type varTokenType byte + +const ( + tokEOF varTokenType = iota + tokError + tokNumber + tokString + tokBool + tokArrayStart + tokArrayEnd + tokDictStart + tokDictEnd + tokVariantStart + tokVariantEnd + tokComma + tokColon + tokType + tokByteString +) + +type varLexer struct { + input string + start int + pos int + width int + tokens []varToken +} + +type lexState func(*varLexer) lexState + +func varLex(s string) []varToken { + l := &varLexer{input: s} + l.run() + return l.tokens +} + +func (l *varLexer) accept(valid string) bool { + if strings.IndexRune(valid, l.next()) >= 0 { + return true + } + l.backup() + return false +} + +func (l *varLexer) backup() { + l.pos -= l.width +} + +func (l *varLexer) emit(t varTokenType) { + l.tokens = append(l.tokens, varToken{t, l.input[l.start:l.pos]}) + l.start = l.pos +} + +func (l *varLexer) errorf(format string, v ...interface{}) lexState { + l.tokens = append(l.tokens, varToken{ + tokError, + fmt.Sprintf(format, v...), + }) + return nil +} + +func (l *varLexer) ignore() { + l.start = l.pos +} + +func (l *varLexer) next() rune { + var r rune + + if l.pos >= len(l.input) { + l.width = 0 + return -1 + } + r, l.width = utf8.DecodeRuneInString(l.input[l.pos:]) + l.pos += l.width + return r +} + +func (l *varLexer) run() { + for state := varLexNormal; state != nil; { + state = state(l) + } +} + +func (l *varLexer) peek() rune { + r := l.next() + l.backup() + return r +} + +func varLexNormal(l *varLexer) lexState { + for { + r := l.next() + switch { + case r == -1: + l.emit(tokEOF) + return nil + case r == '[': + l.emit(tokArrayStart) + case r == ']': + l.emit(tokArrayEnd) + case r == '{': + l.emit(tokDictStart) + case r == '}': + l.emit(tokDictEnd) + case r == '<': + l.emit(tokVariantStart) + case r == '>': + l.emit(tokVariantEnd) + case r == ':': + l.emit(tokColon) + case r == ',': + l.emit(tokComma) + case r == '\'' || r == '"': + l.backup() + return varLexString + case r == '@': + l.backup() + return varLexType + case unicode.IsSpace(r): + l.ignore() + case unicode.IsNumber(r) || r == '+' || r == '-': + l.backup() + return varLexNumber + case r == 'b': + pos := l.start + if n := l.peek(); n == '"' || n == '\'' { + return varLexByteString + } + // not a byte string; try to parse it as a type or bool below + l.pos = pos + 1 + l.width = 1 + fallthrough + default: + // either a bool or a type. Try bools first. + l.backup() + if l.pos+4 <= len(l.input) { + if l.input[l.pos:l.pos+4] == "true" { + l.pos += 4 + l.emit(tokBool) + continue + } + } + if l.pos+5 <= len(l.input) { + if l.input[l.pos:l.pos+5] == "false" { + l.pos += 5 + l.emit(tokBool) + continue + } + } + // must be a type. + return varLexType + } + } +} + +var varTypeMap = map[string]string{ + "boolean": "b", + "byte": "y", + "int16": "n", + "uint16": "q", + "int32": "i", + "uint32": "u", + "int64": "x", + "uint64": "t", + "double": "f", + "string": "s", + "objectpath": "o", + "signature": "g", +} + +func varLexByteString(l *varLexer) lexState { + q := l.next() +Loop: + for { + switch l.next() { + case '\\': + if r := l.next(); r != -1 { + break + } + fallthrough + case -1: + return l.errorf("unterminated bytestring") + case q: + break Loop + } + } + l.emit(tokByteString) + return varLexNormal +} + +func varLexNumber(l *varLexer) lexState { + l.accept("+-") + digits := "0123456789" + if l.accept("0") { + if l.accept("x") { + digits = "0123456789abcdefABCDEF" + } else { + digits = "01234567" + } + } + for strings.IndexRune(digits, l.next()) >= 0 { + } + l.backup() + if l.accept(".") { + for strings.IndexRune(digits, l.next()) >= 0 { + } + l.backup() + } + if l.accept("eE") { + l.accept("+-") + for strings.IndexRune("0123456789", l.next()) >= 0 { + } + l.backup() + } + if r := l.peek(); unicode.IsLetter(r) { + l.next() + return l.errorf("bad number syntax: %q", l.input[l.start:l.pos]) + } + l.emit(tokNumber) + return varLexNormal +} + +func varLexString(l *varLexer) lexState { + q := l.next() +Loop: + for { + switch l.next() { + case '\\': + if r := l.next(); r != -1 { + break + } + fallthrough + case -1: + return l.errorf("unterminated string") + case q: + break Loop + } + } + l.emit(tokString) + return varLexNormal +} + +func varLexType(l *varLexer) lexState { + at := l.accept("@") + for { + r := l.next() + if r == -1 { + break + } + if unicode.IsSpace(r) { + l.backup() + break + } + } + if at { + if _, err := ParseSignature(l.input[l.start+1 : l.pos]); err != nil { + return l.errorf("%s", err) + } + } else { + if _, ok := varTypeMap[l.input[l.start:l.pos]]; ok { + l.emit(tokType) + return varLexNormal + } + return l.errorf("unrecognized type %q", l.input[l.start:l.pos]) + } + l.emit(tokType) + return varLexNormal +} diff --git a/vendor/src/github.com/godbus/dbus/variant_parser.go b/vendor/src/github.com/godbus/dbus/variant_parser.go new file mode 100644 index 0000000000..d20f5da6dd --- /dev/null +++ b/vendor/src/github.com/godbus/dbus/variant_parser.go @@ -0,0 +1,817 @@ +package dbus + +import ( + "bytes" + "errors" + "fmt" + "io" + "reflect" + "strconv" + "strings" + "unicode/utf8" +) + +type varParser struct { + tokens []varToken + i int +} + +func (p *varParser) backup() { + p.i-- +} + +func (p *varParser) next() varToken { + if p.i < len(p.tokens) { + t := p.tokens[p.i] + p.i++ + return t + } + return varToken{typ: tokEOF} +} + +type varNode interface { + Infer() (Signature, error) + String() string + Sigs() sigSet + Value(Signature) (interface{}, error) +} + +func varMakeNode(p *varParser) (varNode, error) { + var sig Signature + + for { + t := p.next() + switch t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + case tokNumber: + return varMakeNumNode(t, sig) + case tokString: + return varMakeStringNode(t, sig) + case tokBool: + if sig.str != "" && sig.str != "b" { + return nil, varTypeError{t.val, sig} + } + b, err := strconv.ParseBool(t.val) + if err != nil { + return nil, err + } + return boolNode(b), nil + case tokArrayStart: + return varMakeArrayNode(p, sig) + case tokVariantStart: + return varMakeVariantNode(p, sig) + case tokDictStart: + return varMakeDictNode(p, sig) + case tokType: + if sig.str != "" { + return nil, errors.New("unexpected type annotation") + } + if t.val[0] == '@' { + sig.str = t.val[1:] + } else { + sig.str = varTypeMap[t.val] + } + case tokByteString: + if sig.str != "" && sig.str != "ay" { + return nil, varTypeError{t.val, sig} + } + b, err := varParseByteString(t.val) + if err != nil { + return nil, err + } + return byteStringNode(b), nil + default: + return nil, fmt.Errorf("unexpected %q", t.val) + } + } +} + +type varTypeError struct { + val string + sig Signature +} + +func (e varTypeError) Error() string { + return fmt.Sprintf("dbus: can't parse %q as type %q", e.val, e.sig.str) +} + +type sigSet map[Signature]bool + +func (s sigSet) Empty() bool { + return len(s) == 0 +} + +func (s sigSet) Intersect(s2 sigSet) sigSet { + r := make(sigSet) + for k := range s { + if s2[k] { + r[k] = true + } + } + return r +} + +func (s sigSet) Single() (Signature, bool) { + if len(s) == 1 { + for k := range s { + return k, true + } + } + return Signature{}, false +} + +func (s sigSet) ToArray() sigSet { + r := make(sigSet, len(s)) + for k := range s { + r[Signature{"a" + k.str}] = true + } + return r +} + +type numNode struct { + sig Signature + str string + val interface{} +} + +var numSigSet = sigSet{ + Signature{"y"}: true, + Signature{"n"}: true, + Signature{"q"}: true, + Signature{"i"}: true, + Signature{"u"}: true, + Signature{"x"}: true, + Signature{"t"}: true, + Signature{"d"}: true, +} + +func (n numNode) Infer() (Signature, error) { + if strings.ContainsAny(n.str, ".e") { + return Signature{"d"}, nil + } + return Signature{"i"}, nil +} + +func (n numNode) String() string { + return n.str +} + +func (n numNode) Sigs() sigSet { + if n.sig.str != "" { + return sigSet{n.sig: true} + } + if strings.ContainsAny(n.str, ".e") { + return sigSet{Signature{"d"}: true} + } + return numSigSet +} + +func (n numNode) Value(sig Signature) (interface{}, error) { + if n.sig.str != "" && n.sig != sig { + return nil, varTypeError{n.str, sig} + } + if n.val != nil { + return n.val, nil + } + return varNumAs(n.str, sig) +} + +func varMakeNumNode(tok varToken, sig Signature) (varNode, error) { + if sig.str == "" { + return numNode{str: tok.val}, nil + } + num, err := varNumAs(tok.val, sig) + if err != nil { + return nil, err + } + return numNode{sig: sig, val: num}, nil +} + +func varNumAs(s string, sig Signature) (interface{}, error) { + isUnsigned := false + size := 32 + switch sig.str { + case "n": + size = 16 + case "i": + case "x": + size = 64 + case "y": + size = 8 + isUnsigned = true + case "q": + size = 16 + isUnsigned = true + case "u": + isUnsigned = true + case "t": + size = 64 + isUnsigned = true + case "d": + d, err := strconv.ParseFloat(s, 64) + if err != nil { + return nil, err + } + return d, nil + default: + return nil, varTypeError{s, sig} + } + base := 10 + if strings.HasPrefix(s, "0x") { + base = 16 + s = s[2:] + } + if strings.HasPrefix(s, "0") && len(s) != 1 { + base = 8 + s = s[1:] + } + if isUnsigned { + i, err := strconv.ParseUint(s, base, size) + if err != nil { + return nil, err + } + var v interface{} = i + switch sig.str { + case "y": + v = byte(i) + case "q": + v = uint16(i) + case "u": + v = uint32(i) + } + return v, nil + } + i, err := strconv.ParseInt(s, base, size) + if err != nil { + return nil, err + } + var v interface{} = i + switch sig.str { + case "n": + v = int16(i) + case "i": + v = int32(i) + } + return v, nil +} + +type stringNode struct { + sig Signature + str string // parsed + val interface{} // has correct type +} + +var stringSigSet = sigSet{ + Signature{"s"}: true, + Signature{"g"}: true, + Signature{"o"}: true, +} + +func (n stringNode) Infer() (Signature, error) { + return Signature{"s"}, nil +} + +func (n stringNode) String() string { + return n.str +} + +func (n stringNode) Sigs() sigSet { + if n.sig.str != "" { + return sigSet{n.sig: true} + } + return stringSigSet +} + +func (n stringNode) Value(sig Signature) (interface{}, error) { + if n.sig.str != "" && n.sig != sig { + return nil, varTypeError{n.str, sig} + } + if n.val != nil { + return n.val, nil + } + switch { + case sig.str == "g": + return Signature{n.str}, nil + case sig.str == "o": + return ObjectPath(n.str), nil + case sig.str == "s": + return n.str, nil + default: + return nil, varTypeError{n.str, sig} + } +} + +func varMakeStringNode(tok varToken, sig Signature) (varNode, error) { + if sig.str != "" && sig.str != "s" && sig.str != "g" && sig.str != "o" { + return nil, fmt.Errorf("invalid type %q for string", sig.str) + } + s, err := varParseString(tok.val) + if err != nil { + return nil, err + } + n := stringNode{str: s} + if sig.str == "" { + return stringNode{str: s}, nil + } + n.sig = sig + switch sig.str { + case "o": + n.val = ObjectPath(s) + case "g": + n.val = Signature{s} + case "s": + n.val = s + } + return n, nil +} + +func varParseString(s string) (string, error) { + // quotes are guaranteed to be there + s = s[1 : len(s)-1] + buf := new(bytes.Buffer) + for len(s) != 0 { + r, size := utf8.DecodeRuneInString(s) + if r == utf8.RuneError && size == 1 { + return "", errors.New("invalid UTF-8") + } + s = s[size:] + if r != '\\' { + buf.WriteRune(r) + continue + } + r, size = utf8.DecodeRuneInString(s) + if r == utf8.RuneError && size == 1 { + return "", errors.New("invalid UTF-8") + } + s = s[size:] + switch r { + case 'a': + buf.WriteRune(0x7) + case 'b': + buf.WriteRune(0x8) + case 'f': + buf.WriteRune(0xc) + case 'n': + buf.WriteRune('\n') + case 'r': + buf.WriteRune('\r') + case 't': + buf.WriteRune('\t') + case '\n': + case 'u': + if len(s) < 4 { + return "", errors.New("short unicode escape") + } + r, err := strconv.ParseUint(s[:4], 16, 32) + if err != nil { + return "", err + } + buf.WriteRune(rune(r)) + s = s[4:] + case 'U': + if len(s) < 8 { + return "", errors.New("short unicode escape") + } + r, err := strconv.ParseUint(s[:8], 16, 32) + if err != nil { + return "", err + } + buf.WriteRune(rune(r)) + s = s[8:] + default: + buf.WriteRune(r) + } + } + return buf.String(), nil +} + +var boolSigSet = sigSet{Signature{"b"}: true} + +type boolNode bool + +func (boolNode) Infer() (Signature, error) { + return Signature{"b"}, nil +} + +func (b boolNode) String() string { + if b { + return "true" + } + return "false" +} + +func (boolNode) Sigs() sigSet { + return boolSigSet +} + +func (b boolNode) Value(sig Signature) (interface{}, error) { + if sig.str != "b" { + return nil, varTypeError{b.String(), sig} + } + return bool(b), nil +} + +type arrayNode struct { + set sigSet + children []varNode + val interface{} +} + +func (n arrayNode) Infer() (Signature, error) { + for _, v := range n.children { + csig, err := varInfer(v) + if err != nil { + continue + } + return Signature{"a" + csig.str}, nil + } + return Signature{}, fmt.Errorf("can't infer type for %q", n.String()) +} + +func (n arrayNode) String() string { + s := "[" + for i, v := range n.children { + s += v.String() + if i != len(n.children)-1 { + s += ", " + } + } + return s + "]" +} + +func (n arrayNode) Sigs() sigSet { + return n.set +} + +func (n arrayNode) Value(sig Signature) (interface{}, error) { + if n.set.Empty() { + // no type information whatsoever, so this must be an empty slice + return reflect.MakeSlice(typeFor(sig.str), 0, 0).Interface(), nil + } + if !n.set[sig] { + return nil, varTypeError{n.String(), sig} + } + s := reflect.MakeSlice(typeFor(sig.str), len(n.children), len(n.children)) + for i, v := range n.children { + rv, err := v.Value(Signature{sig.str[1:]}) + if err != nil { + return nil, err + } + s.Index(i).Set(reflect.ValueOf(rv)) + } + return s.Interface(), nil +} + +func varMakeArrayNode(p *varParser, sig Signature) (varNode, error) { + var n arrayNode + if sig.str != "" { + n.set = sigSet{sig: true} + } + if t := p.next(); t.typ == tokArrayEnd { + return n, nil + } else { + p.backup() + } +Loop: + for { + t := p.next() + switch t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + } + p.backup() + cn, err := varMakeNode(p) + if err != nil { + return nil, err + } + if cset := cn.Sigs(); !cset.Empty() { + if n.set.Empty() { + n.set = cset.ToArray() + } else { + nset := cset.ToArray().Intersect(n.set) + if nset.Empty() { + return nil, fmt.Errorf("can't parse %q with given type information", cn.String()) + } + n.set = nset + } + } + n.children = append(n.children, cn) + switch t := p.next(); t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + case tokArrayEnd: + break Loop + case tokComma: + continue + default: + return nil, fmt.Errorf("unexpected %q", t.val) + } + } + return n, nil +} + +type variantNode struct { + n varNode +} + +var variantSet = sigSet{ + Signature{"v"}: true, +} + +func (variantNode) Infer() (Signature, error) { + return Signature{"v"}, nil +} + +func (n variantNode) String() string { + return "<" + n.n.String() + ">" +} + +func (variantNode) Sigs() sigSet { + return variantSet +} + +func (n variantNode) Value(sig Signature) (interface{}, error) { + if sig.str != "v" { + return nil, varTypeError{n.String(), sig} + } + sig, err := varInfer(n.n) + if err != nil { + return nil, err + } + v, err := n.n.Value(sig) + if err != nil { + return nil, err + } + return MakeVariant(v), nil +} + +func varMakeVariantNode(p *varParser, sig Signature) (varNode, error) { + n, err := varMakeNode(p) + if err != nil { + return nil, err + } + if t := p.next(); t.typ != tokVariantEnd { + return nil, fmt.Errorf("unexpected %q", t.val) + } + vn := variantNode{n} + if sig.str != "" && sig.str != "v" { + return nil, varTypeError{vn.String(), sig} + } + return variantNode{n}, nil +} + +type dictEntry struct { + key, val varNode +} + +type dictNode struct { + kset, vset sigSet + children []dictEntry + val interface{} +} + +func (n dictNode) Infer() (Signature, error) { + for _, v := range n.children { + ksig, err := varInfer(v.key) + if err != nil { + continue + } + vsig, err := varInfer(v.val) + if err != nil { + continue + } + return Signature{"a{" + ksig.str + vsig.str + "}"}, nil + } + return Signature{}, fmt.Errorf("can't infer type for %q", n.String()) +} + +func (n dictNode) String() string { + s := "{" + for i, v := range n.children { + s += v.key.String() + ": " + v.val.String() + if i != len(n.children)-1 { + s += ", " + } + } + return s + "}" +} + +func (n dictNode) Sigs() sigSet { + r := sigSet{} + for k := range n.kset { + for v := range n.vset { + sig := "a{" + k.str + v.str + "}" + r[Signature{sig}] = true + } + } + return r +} + +func (n dictNode) Value(sig Signature) (interface{}, error) { + set := n.Sigs() + if set.Empty() { + // no type information -> empty dict + return reflect.MakeMap(typeFor(sig.str)).Interface(), nil + } + if !set[sig] { + return nil, varTypeError{n.String(), sig} + } + m := reflect.MakeMap(typeFor(sig.str)) + ksig := Signature{sig.str[2:3]} + vsig := Signature{sig.str[3 : len(sig.str)-1]} + for _, v := range n.children { + kv, err := v.key.Value(ksig) + if err != nil { + return nil, err + } + vv, err := v.val.Value(vsig) + if err != nil { + return nil, err + } + m.SetMapIndex(reflect.ValueOf(kv), reflect.ValueOf(vv)) + } + return m.Interface(), nil +} + +func varMakeDictNode(p *varParser, sig Signature) (varNode, error) { + var n dictNode + + if sig.str != "" { + if len(sig.str) < 5 { + return nil, fmt.Errorf("invalid signature %q for dict type", sig) + } + ksig := Signature{string(sig.str[2])} + vsig := Signature{sig.str[3 : len(sig.str)-1]} + n.kset = sigSet{ksig: true} + n.vset = sigSet{vsig: true} + } + if t := p.next(); t.typ == tokDictEnd { + return n, nil + } else { + p.backup() + } +Loop: + for { + t := p.next() + switch t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + } + p.backup() + kn, err := varMakeNode(p) + if err != nil { + return nil, err + } + if kset := kn.Sigs(); !kset.Empty() { + if n.kset.Empty() { + n.kset = kset + } else { + n.kset = kset.Intersect(n.kset) + if n.kset.Empty() { + return nil, fmt.Errorf("can't parse %q with given type information", kn.String()) + } + } + } + t = p.next() + switch t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + case tokColon: + default: + return nil, fmt.Errorf("unexpected %q", t.val) + } + t = p.next() + switch t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + } + p.backup() + vn, err := varMakeNode(p) + if err != nil { + return nil, err + } + if vset := vn.Sigs(); !vset.Empty() { + if n.vset.Empty() { + n.vset = vset + } else { + n.vset = n.vset.Intersect(vset) + if n.vset.Empty() { + return nil, fmt.Errorf("can't parse %q with given type information", vn.String()) + } + } + } + n.children = append(n.children, dictEntry{kn, vn}) + t = p.next() + switch t.typ { + case tokEOF: + return nil, io.ErrUnexpectedEOF + case tokError: + return nil, errors.New(t.val) + case tokDictEnd: + break Loop + case tokComma: + continue + default: + return nil, fmt.Errorf("unexpected %q", t.val) + } + } + return n, nil +} + +type byteStringNode []byte + +var byteStringSet = sigSet{ + Signature{"ay"}: true, +} + +func (byteStringNode) Infer() (Signature, error) { + return Signature{"ay"}, nil +} + +func (b byteStringNode) String() string { + return string(b) +} + +func (b byteStringNode) Sigs() sigSet { + return byteStringSet +} + +func (b byteStringNode) Value(sig Signature) (interface{}, error) { + if sig.str != "ay" { + return nil, varTypeError{b.String(), sig} + } + return []byte(b), nil +} + +func varParseByteString(s string) ([]byte, error) { + // quotes and b at start are guaranteed to be there + b := make([]byte, 0, 1) + s = s[2 : len(s)-1] + for len(s) != 0 { + c := s[0] + s = s[1:] + if c != '\\' { + b = append(b, c) + continue + } + c = s[0] + s = s[1:] + switch c { + case 'a': + b = append(b, 0x7) + case 'b': + b = append(b, 0x8) + case 'f': + b = append(b, 0xc) + case 'n': + b = append(b, '\n') + case 'r': + b = append(b, '\r') + case 't': + b = append(b, '\t') + case 'x': + if len(s) < 2 { + return nil, errors.New("short escape") + } + n, err := strconv.ParseUint(s[:2], 16, 8) + if err != nil { + return nil, err + } + b = append(b, byte(n)) + s = s[2:] + case '0': + if len(s) < 3 { + return nil, errors.New("short escape") + } + n, err := strconv.ParseUint(s[:3], 8, 8) + if err != nil { + return nil, err + } + b = append(b, byte(n)) + s = s[3:] + default: + b = append(b, c) + } + } + return append(b, 0), nil +} + +func varInfer(n varNode) (Signature, error) { + if sig, ok := n.Sigs().Single(); ok { + return sig, nil + } + return n.Infer() +} diff --git a/vendor/src/github.com/golang/protobuf/LICENSE b/vendor/src/github.com/golang/protobuf/LICENSE new file mode 100644 index 0000000000..1b1b1921ef --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/LICENSE @@ -0,0 +1,31 @@ +Go support for Protocol Buffers - Google's data interchange format + +Copyright 2010 The Go Authors. All rights reserved. +https://github.com/golang/protobuf + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + diff --git a/vendor/src/github.com/golang/protobuf/proto/Makefile b/vendor/src/github.com/golang/protobuf/proto/Makefile new file mode 100644 index 0000000000..f1f06564a1 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/Makefile @@ -0,0 +1,43 @@ +# Go support for Protocol Buffers - Google's data interchange format +# +# Copyright 2010 The Go Authors. All rights reserved. +# https://github.com/golang/protobuf +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are +# met: +# +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# * Redistributions in binary form must reproduce the above +# copyright notice, this list of conditions and the following disclaimer +# in the documentation and/or other materials provided with the +# distribution. +# * Neither the name of Google Inc. nor the names of its +# contributors may be used to endorse or promote products derived from +# this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +install: + go install + +test: install generate-test-pbs + go test + + +generate-test-pbs: + make install + make -C testdata + protoc --go_out=Mtestdata/test.proto=github.com/golang/protobuf/proto/testdata:. proto3_proto/proto3.proto + make diff --git a/vendor/src/github.com/golang/protobuf/proto/clone.go b/vendor/src/github.com/golang/protobuf/proto/clone.go new file mode 100644 index 0000000000..6c6a7d95f2 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/clone.go @@ -0,0 +1,197 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2011 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// Protocol buffer deep copy and merge. +// TODO: MessageSet and RawMessage. + +package proto + +import ( + "log" + "reflect" + "strings" +) + +// Clone returns a deep copy of a protocol buffer. +func Clone(pb Message) Message { + in := reflect.ValueOf(pb) + if in.IsNil() { + return pb + } + + out := reflect.New(in.Type().Elem()) + // out is empty so a merge is a deep copy. + mergeStruct(out.Elem(), in.Elem()) + return out.Interface().(Message) +} + +// Merge merges src into dst. +// Required and optional fields that are set in src will be set to that value in dst. +// Elements of repeated fields will be appended. +// Merge panics if src and dst are not the same type, or if dst is nil. +func Merge(dst, src Message) { + in := reflect.ValueOf(src) + out := reflect.ValueOf(dst) + if out.IsNil() { + panic("proto: nil destination") + } + if in.Type() != out.Type() { + // Explicit test prior to mergeStruct so that mistyped nils will fail + panic("proto: type mismatch") + } + if in.IsNil() { + // Merging nil into non-nil is a quiet no-op + return + } + mergeStruct(out.Elem(), in.Elem()) +} + +func mergeStruct(out, in reflect.Value) { + for i := 0; i < in.NumField(); i++ { + f := in.Type().Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + mergeAny(out.Field(i), in.Field(i)) + } + + if emIn, ok := in.Addr().Interface().(extendableProto); ok { + emOut := out.Addr().Interface().(extendableProto) + mergeExtension(emOut.ExtensionMap(), emIn.ExtensionMap()) + } + + uf := in.FieldByName("XXX_unrecognized") + if !uf.IsValid() { + return + } + uin := uf.Bytes() + if len(uin) > 0 { + out.FieldByName("XXX_unrecognized").SetBytes(append([]byte(nil), uin...)) + } +} + +func mergeAny(out, in reflect.Value) { + if in.Type() == protoMessageType { + if !in.IsNil() { + if out.IsNil() { + out.Set(reflect.ValueOf(Clone(in.Interface().(Message)))) + } else { + Merge(out.Interface().(Message), in.Interface().(Message)) + } + } + return + } + switch in.Kind() { + case reflect.Bool, reflect.Float32, reflect.Float64, reflect.Int32, reflect.Int64, + reflect.String, reflect.Uint32, reflect.Uint64: + out.Set(in) + case reflect.Map: + if in.Len() == 0 { + return + } + if out.IsNil() { + out.Set(reflect.MakeMap(in.Type())) + } + // For maps with value types of *T or []byte we need to deep copy each value. + elemKind := in.Type().Elem().Kind() + for _, key := range in.MapKeys() { + var val reflect.Value + switch elemKind { + case reflect.Ptr: + val = reflect.New(in.Type().Elem().Elem()) + mergeAny(val, in.MapIndex(key)) + case reflect.Slice: + val = in.MapIndex(key) + val = reflect.ValueOf(append([]byte{}, val.Bytes()...)) + default: + val = in.MapIndex(key) + } + out.SetMapIndex(key, val) + } + case reflect.Ptr: + if in.IsNil() { + return + } + if out.IsNil() { + out.Set(reflect.New(in.Elem().Type())) + } + mergeAny(out.Elem(), in.Elem()) + case reflect.Slice: + if in.IsNil() { + return + } + if in.Type().Elem().Kind() == reflect.Uint8 { + // []byte is a scalar bytes field, not a repeated field. + // Make a deep copy. + // Append to []byte{} instead of []byte(nil) so that we never end up + // with a nil result. + out.SetBytes(append([]byte{}, in.Bytes()...)) + return + } + n := in.Len() + if out.IsNil() { + out.Set(reflect.MakeSlice(in.Type(), 0, n)) + } + switch in.Type().Elem().Kind() { + case reflect.Bool, reflect.Float32, reflect.Float64, reflect.Int32, reflect.Int64, + reflect.String, reflect.Uint32, reflect.Uint64: + out.Set(reflect.AppendSlice(out, in)) + default: + for i := 0; i < n; i++ { + x := reflect.Indirect(reflect.New(in.Type().Elem())) + mergeAny(x, in.Index(i)) + out.Set(reflect.Append(out, x)) + } + } + case reflect.Struct: + mergeStruct(out, in) + default: + // unknown type, so not a protocol buffer + log.Printf("proto: don't know how to copy %v", in) + } +} + +func mergeExtension(out, in map[int32]Extension) { + for extNum, eIn := range in { + eOut := Extension{desc: eIn.desc} + if eIn.value != nil { + v := reflect.New(reflect.TypeOf(eIn.value)).Elem() + mergeAny(v, reflect.ValueOf(eIn.value)) + eOut.value = v.Interface() + } + if eIn.enc != nil { + eOut.enc = make([]byte, len(eIn.enc)) + copy(eOut.enc, eIn.enc) + } + + out[extNum] = eOut + } +} diff --git a/vendor/src/github.com/golang/protobuf/proto/decode.go b/vendor/src/github.com/golang/protobuf/proto/decode.go new file mode 100644 index 0000000000..129792ed12 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/decode.go @@ -0,0 +1,821 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Routines for decoding protocol buffer data to construct in-memory representations. + */ + +import ( + "errors" + "fmt" + "io" + "os" + "reflect" +) + +// errOverflow is returned when an integer is too large to be represented. +var errOverflow = errors.New("proto: integer overflow") + +// The fundamental decoders that interpret bytes on the wire. +// Those that take integer types all return uint64 and are +// therefore of type valueDecoder. + +// DecodeVarint reads a varint-encoded integer from the slice. +// It returns the integer and the number of bytes consumed, or +// zero if there is not enough. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +func DecodeVarint(buf []byte) (x uint64, n int) { + // x, n already 0 + for shift := uint(0); shift < 64; shift += 7 { + if n >= len(buf) { + return 0, 0 + } + b := uint64(buf[n]) + n++ + x |= (b & 0x7F) << shift + if (b & 0x80) == 0 { + return x, n + } + } + + // The number is too large to represent in a 64-bit value. + return 0, 0 +} + +// DecodeVarint reads a varint-encoded integer from the Buffer. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +func (p *Buffer) DecodeVarint() (x uint64, err error) { + // x, err already 0 + + i := p.index + l := len(p.buf) + + for shift := uint(0); shift < 64; shift += 7 { + if i >= l { + err = io.ErrUnexpectedEOF + return + } + b := p.buf[i] + i++ + x |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + p.index = i + return + } + } + + // The number is too large to represent in a 64-bit value. + err = errOverflow + return +} + +// DecodeFixed64 reads a 64-bit integer from the Buffer. +// This is the format for the +// fixed64, sfixed64, and double protocol buffer types. +func (p *Buffer) DecodeFixed64() (x uint64, err error) { + // x, err already 0 + i := p.index + 8 + if i < 0 || i > len(p.buf) { + err = io.ErrUnexpectedEOF + return + } + p.index = i + + x = uint64(p.buf[i-8]) + x |= uint64(p.buf[i-7]) << 8 + x |= uint64(p.buf[i-6]) << 16 + x |= uint64(p.buf[i-5]) << 24 + x |= uint64(p.buf[i-4]) << 32 + x |= uint64(p.buf[i-3]) << 40 + x |= uint64(p.buf[i-2]) << 48 + x |= uint64(p.buf[i-1]) << 56 + return +} + +// DecodeFixed32 reads a 32-bit integer from the Buffer. +// This is the format for the +// fixed32, sfixed32, and float protocol buffer types. +func (p *Buffer) DecodeFixed32() (x uint64, err error) { + // x, err already 0 + i := p.index + 4 + if i < 0 || i > len(p.buf) { + err = io.ErrUnexpectedEOF + return + } + p.index = i + + x = uint64(p.buf[i-4]) + x |= uint64(p.buf[i-3]) << 8 + x |= uint64(p.buf[i-2]) << 16 + x |= uint64(p.buf[i-1]) << 24 + return +} + +// DecodeZigzag64 reads a zigzag-encoded 64-bit integer +// from the Buffer. +// This is the format used for the sint64 protocol buffer type. +func (p *Buffer) DecodeZigzag64() (x uint64, err error) { + x, err = p.DecodeVarint() + if err != nil { + return + } + x = (x >> 1) ^ uint64((int64(x&1)<<63)>>63) + return +} + +// DecodeZigzag32 reads a zigzag-encoded 32-bit integer +// from the Buffer. +// This is the format used for the sint32 protocol buffer type. +func (p *Buffer) DecodeZigzag32() (x uint64, err error) { + x, err = p.DecodeVarint() + if err != nil { + return + } + x = uint64((uint32(x) >> 1) ^ uint32((int32(x&1)<<31)>>31)) + return +} + +// These are not ValueDecoders: they produce an array of bytes or a string. +// bytes, embedded messages + +// DecodeRawBytes reads a count-delimited byte buffer from the Buffer. +// This is the format used for the bytes protocol buffer +// type and for embedded messages. +func (p *Buffer) DecodeRawBytes(alloc bool) (buf []byte, err error) { + n, err := p.DecodeVarint() + if err != nil { + return nil, err + } + + nb := int(n) + if nb < 0 { + return nil, fmt.Errorf("proto: bad byte length %d", nb) + } + end := p.index + nb + if end < p.index || end > len(p.buf) { + return nil, io.ErrUnexpectedEOF + } + + if !alloc { + // todo: check if can get more uses of alloc=false + buf = p.buf[p.index:end] + p.index += nb + return + } + + buf = make([]byte, nb) + copy(buf, p.buf[p.index:]) + p.index += nb + return +} + +// DecodeStringBytes reads an encoded string from the Buffer. +// This is the format used for the proto2 string type. +func (p *Buffer) DecodeStringBytes() (s string, err error) { + buf, err := p.DecodeRawBytes(false) + if err != nil { + return + } + return string(buf), nil +} + +// Skip the next item in the buffer. Its wire type is decoded and presented as an argument. +// If the protocol buffer has extensions, and the field matches, add it as an extension. +// Otherwise, if the XXX_unrecognized field exists, append the skipped data there. +func (o *Buffer) skipAndSave(t reflect.Type, tag, wire int, base structPointer, unrecField field) error { + oi := o.index + + err := o.skip(t, tag, wire) + if err != nil { + return err + } + + if !unrecField.IsValid() { + return nil + } + + ptr := structPointer_Bytes(base, unrecField) + + // Add the skipped field to struct field + obuf := o.buf + + o.buf = *ptr + o.EncodeVarint(uint64(tag<<3 | wire)) + *ptr = append(o.buf, obuf[oi:o.index]...) + + o.buf = obuf + + return nil +} + +// Skip the next item in the buffer. Its wire type is decoded and presented as an argument. +func (o *Buffer) skip(t reflect.Type, tag, wire int) error { + + var u uint64 + var err error + + switch wire { + case WireVarint: + _, err = o.DecodeVarint() + case WireFixed64: + _, err = o.DecodeFixed64() + case WireBytes: + _, err = o.DecodeRawBytes(false) + case WireFixed32: + _, err = o.DecodeFixed32() + case WireStartGroup: + for { + u, err = o.DecodeVarint() + if err != nil { + break + } + fwire := int(u & 0x7) + if fwire == WireEndGroup { + break + } + ftag := int(u >> 3) + err = o.skip(t, ftag, fwire) + if err != nil { + break + } + } + default: + err = fmt.Errorf("proto: can't skip unknown wire type %d for %s", wire, t) + } + return err +} + +// Unmarshaler is the interface representing objects that can +// unmarshal themselves. The method should reset the receiver before +// decoding starts. The argument points to data that may be +// overwritten, so implementations should not keep references to the +// buffer. +type Unmarshaler interface { + Unmarshal([]byte) error +} + +// Unmarshal parses the protocol buffer representation in buf and places the +// decoded result in pb. If the struct underlying pb does not match +// the data in buf, the results can be unpredictable. +// +// Unmarshal resets pb before starting to unmarshal, so any +// existing data in pb is always removed. Use UnmarshalMerge +// to preserve and append to existing data. +func Unmarshal(buf []byte, pb Message) error { + pb.Reset() + return UnmarshalMerge(buf, pb) +} + +// UnmarshalMerge parses the protocol buffer representation in buf and +// writes the decoded result to pb. If the struct underlying pb does not match +// the data in buf, the results can be unpredictable. +// +// UnmarshalMerge merges into existing data in pb. +// Most code should use Unmarshal instead. +func UnmarshalMerge(buf []byte, pb Message) error { + // If the object can unmarshal itself, let it. + if u, ok := pb.(Unmarshaler); ok { + return u.Unmarshal(buf) + } + return NewBuffer(buf).Unmarshal(pb) +} + +// Unmarshal parses the protocol buffer representation in the +// Buffer and places the decoded result in pb. If the struct +// underlying pb does not match the data in the buffer, the results can be +// unpredictable. +func (p *Buffer) Unmarshal(pb Message) error { + // If the object can unmarshal itself, let it. + if u, ok := pb.(Unmarshaler); ok { + err := u.Unmarshal(p.buf[p.index:]) + p.index = len(p.buf) + return err + } + + typ, base, err := getbase(pb) + if err != nil { + return err + } + + err = p.unmarshalType(typ.Elem(), GetProperties(typ.Elem()), false, base) + + if collectStats { + stats.Decode++ + } + + return err +} + +// unmarshalType does the work of unmarshaling a structure. +func (o *Buffer) unmarshalType(st reflect.Type, prop *StructProperties, is_group bool, base structPointer) error { + var state errorState + required, reqFields := prop.reqCount, uint64(0) + + var err error + for err == nil && o.index < len(o.buf) { + oi := o.index + var u uint64 + u, err = o.DecodeVarint() + if err != nil { + break + } + wire := int(u & 0x7) + if wire == WireEndGroup { + if is_group { + return nil // input is satisfied + } + return fmt.Errorf("proto: %s: wiretype end group for non-group", st) + } + tag := int(u >> 3) + if tag <= 0 { + return fmt.Errorf("proto: %s: illegal tag %d (wire type %d)", st, tag, wire) + } + fieldnum, ok := prop.decoderTags.get(tag) + if !ok { + // Maybe it's an extension? + if prop.extendable { + if e := structPointer_Interface(base, st).(extendableProto); isExtensionField(e, int32(tag)) { + if err = o.skip(st, tag, wire); err == nil { + ext := e.ExtensionMap()[int32(tag)] // may be missing + ext.enc = append(ext.enc, o.buf[oi:o.index]...) + e.ExtensionMap()[int32(tag)] = ext + } + continue + } + } + err = o.skipAndSave(st, tag, wire, base, prop.unrecField) + continue + } + p := prop.Prop[fieldnum] + + if p.dec == nil { + fmt.Fprintf(os.Stderr, "proto: no protobuf decoder for %s.%s\n", st, st.Field(fieldnum).Name) + continue + } + dec := p.dec + if wire != WireStartGroup && wire != p.WireType { + if wire == WireBytes && p.packedDec != nil { + // a packable field + dec = p.packedDec + } else { + err = fmt.Errorf("proto: bad wiretype for field %s.%s: got wiretype %d, want %d", st, st.Field(fieldnum).Name, wire, p.WireType) + continue + } + } + decErr := dec(o, p, base) + if decErr != nil && !state.shouldContinue(decErr, p) { + err = decErr + } + if err == nil && p.Required { + // Successfully decoded a required field. + if tag <= 64 { + // use bitmap for fields 1-64 to catch field reuse. + var mask uint64 = 1 << uint64(tag-1) + if reqFields&mask == 0 { + // new required field + reqFields |= mask + required-- + } + } else { + // This is imprecise. It can be fooled by a required field + // with a tag > 64 that is encoded twice; that's very rare. + // A fully correct implementation would require allocating + // a data structure, which we would like to avoid. + required-- + } + } + } + if err == nil { + if is_group { + return io.ErrUnexpectedEOF + } + if state.err != nil { + return state.err + } + if required > 0 { + // Not enough information to determine the exact field. If we use extra + // CPU, we could determine the field only if the missing required field + // has a tag <= 64 and we check reqFields. + return &RequiredNotSetError{"{Unknown}"} + } + } + return err +} + +// Individual type decoders +// For each, +// u is the decoded value, +// v is a pointer to the field (pointer) in the struct + +// Sizes of the pools to allocate inside the Buffer. +// The goal is modest amortization and allocation +// on at least 16-byte boundaries. +const ( + boolPoolSize = 16 + uint32PoolSize = 8 + uint64PoolSize = 4 +) + +// Decode a bool. +func (o *Buffer) dec_bool(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + if len(o.bools) == 0 { + o.bools = make([]bool, boolPoolSize) + } + o.bools[0] = u != 0 + *structPointer_Bool(base, p.field) = &o.bools[0] + o.bools = o.bools[1:] + return nil +} + +func (o *Buffer) dec_proto3_bool(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + *structPointer_BoolVal(base, p.field) = u != 0 + return nil +} + +// Decode an int32. +func (o *Buffer) dec_int32(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + word32_Set(structPointer_Word32(base, p.field), o, uint32(u)) + return nil +} + +func (o *Buffer) dec_proto3_int32(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + word32Val_Set(structPointer_Word32Val(base, p.field), uint32(u)) + return nil +} + +// Decode an int64. +func (o *Buffer) dec_int64(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + word64_Set(structPointer_Word64(base, p.field), o, u) + return nil +} + +func (o *Buffer) dec_proto3_int64(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + word64Val_Set(structPointer_Word64Val(base, p.field), o, u) + return nil +} + +// Decode a string. +func (o *Buffer) dec_string(p *Properties, base structPointer) error { + s, err := o.DecodeStringBytes() + if err != nil { + return err + } + *structPointer_String(base, p.field) = &s + return nil +} + +func (o *Buffer) dec_proto3_string(p *Properties, base structPointer) error { + s, err := o.DecodeStringBytes() + if err != nil { + return err + } + *structPointer_StringVal(base, p.field) = s + return nil +} + +// Decode a slice of bytes ([]byte). +func (o *Buffer) dec_slice_byte(p *Properties, base structPointer) error { + b, err := o.DecodeRawBytes(true) + if err != nil { + return err + } + *structPointer_Bytes(base, p.field) = b + return nil +} + +// Decode a slice of bools ([]bool). +func (o *Buffer) dec_slice_bool(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + v := structPointer_BoolSlice(base, p.field) + *v = append(*v, u != 0) + return nil +} + +// Decode a slice of bools ([]bool) in packed format. +func (o *Buffer) dec_slice_packed_bool(p *Properties, base structPointer) error { + v := structPointer_BoolSlice(base, p.field) + + nn, err := o.DecodeVarint() + if err != nil { + return err + } + nb := int(nn) // number of bytes of encoded bools + + y := *v + for i := 0; i < nb; i++ { + u, err := p.valDec(o) + if err != nil { + return err + } + y = append(y, u != 0) + } + + *v = y + return nil +} + +// Decode a slice of int32s ([]int32). +func (o *Buffer) dec_slice_int32(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + structPointer_Word32Slice(base, p.field).Append(uint32(u)) + return nil +} + +// Decode a slice of int32s ([]int32) in packed format. +func (o *Buffer) dec_slice_packed_int32(p *Properties, base structPointer) error { + v := structPointer_Word32Slice(base, p.field) + + nn, err := o.DecodeVarint() + if err != nil { + return err + } + nb := int(nn) // number of bytes of encoded int32s + + fin := o.index + nb + if fin < o.index { + return errOverflow + } + for o.index < fin { + u, err := p.valDec(o) + if err != nil { + return err + } + v.Append(uint32(u)) + } + return nil +} + +// Decode a slice of int64s ([]int64). +func (o *Buffer) dec_slice_int64(p *Properties, base structPointer) error { + u, err := p.valDec(o) + if err != nil { + return err + } + + structPointer_Word64Slice(base, p.field).Append(u) + return nil +} + +// Decode a slice of int64s ([]int64) in packed format. +func (o *Buffer) dec_slice_packed_int64(p *Properties, base structPointer) error { + v := structPointer_Word64Slice(base, p.field) + + nn, err := o.DecodeVarint() + if err != nil { + return err + } + nb := int(nn) // number of bytes of encoded int64s + + fin := o.index + nb + if fin < o.index { + return errOverflow + } + for o.index < fin { + u, err := p.valDec(o) + if err != nil { + return err + } + v.Append(u) + } + return nil +} + +// Decode a slice of strings ([]string). +func (o *Buffer) dec_slice_string(p *Properties, base structPointer) error { + s, err := o.DecodeStringBytes() + if err != nil { + return err + } + v := structPointer_StringSlice(base, p.field) + *v = append(*v, s) + return nil +} + +// Decode a slice of slice of bytes ([][]byte). +func (o *Buffer) dec_slice_slice_byte(p *Properties, base structPointer) error { + b, err := o.DecodeRawBytes(true) + if err != nil { + return err + } + v := structPointer_BytesSlice(base, p.field) + *v = append(*v, b) + return nil +} + +// Decode a map field. +func (o *Buffer) dec_new_map(p *Properties, base structPointer) error { + raw, err := o.DecodeRawBytes(false) + if err != nil { + return err + } + oi := o.index // index at the end of this map entry + o.index -= len(raw) // move buffer back to start of map entry + + mptr := structPointer_Map(base, p.field, p.mtype) // *map[K]V + if mptr.Elem().IsNil() { + mptr.Elem().Set(reflect.MakeMap(mptr.Type().Elem())) + } + v := mptr.Elem() // map[K]V + + // Prepare addressable doubly-indirect placeholders for the key and value types. + // See enc_new_map for why. + keyptr := reflect.New(reflect.PtrTo(p.mtype.Key())).Elem() // addressable *K + keybase := toStructPointer(keyptr.Addr()) // **K + + var valbase structPointer + var valptr reflect.Value + switch p.mtype.Elem().Kind() { + case reflect.Slice: + // []byte + var dummy []byte + valptr = reflect.ValueOf(&dummy) // *[]byte + valbase = toStructPointer(valptr) // *[]byte + case reflect.Ptr: + // message; valptr is **Msg; need to allocate the intermediate pointer + valptr = reflect.New(reflect.PtrTo(p.mtype.Elem())).Elem() // addressable *V + valptr.Set(reflect.New(valptr.Type().Elem())) + valbase = toStructPointer(valptr) + default: + // everything else + valptr = reflect.New(reflect.PtrTo(p.mtype.Elem())).Elem() // addressable *V + valbase = toStructPointer(valptr.Addr()) // **V + } + + // Decode. + // This parses a restricted wire format, namely the encoding of a message + // with two fields. See enc_new_map for the format. + for o.index < oi { + // tagcode for key and value properties are always a single byte + // because they have tags 1 and 2. + tagcode := o.buf[o.index] + o.index++ + switch tagcode { + case p.mkeyprop.tagcode[0]: + if err := p.mkeyprop.dec(o, p.mkeyprop, keybase); err != nil { + return err + } + case p.mvalprop.tagcode[0]: + if err := p.mvalprop.dec(o, p.mvalprop, valbase); err != nil { + return err + } + default: + // TODO: Should we silently skip this instead? + return fmt.Errorf("proto: bad map data tag %d", raw[0]) + } + } + + v.SetMapIndex(keyptr.Elem(), valptr.Elem()) + return nil +} + +// Decode a group. +func (o *Buffer) dec_struct_group(p *Properties, base structPointer) error { + bas := structPointer_GetStructPointer(base, p.field) + if structPointer_IsNil(bas) { + // allocate new nested message + bas = toStructPointer(reflect.New(p.stype)) + structPointer_SetStructPointer(base, p.field, bas) + } + return o.unmarshalType(p.stype, p.sprop, true, bas) +} + +// Decode an embedded message. +func (o *Buffer) dec_struct_message(p *Properties, base structPointer) (err error) { + raw, e := o.DecodeRawBytes(false) + if e != nil { + return e + } + + bas := structPointer_GetStructPointer(base, p.field) + if structPointer_IsNil(bas) { + // allocate new nested message + bas = toStructPointer(reflect.New(p.stype)) + structPointer_SetStructPointer(base, p.field, bas) + } + + // If the object can unmarshal itself, let it. + if p.isUnmarshaler { + iv := structPointer_Interface(bas, p.stype) + return iv.(Unmarshaler).Unmarshal(raw) + } + + obuf := o.buf + oi := o.index + o.buf = raw + o.index = 0 + + err = o.unmarshalType(p.stype, p.sprop, false, bas) + o.buf = obuf + o.index = oi + + return err +} + +// Decode a slice of embedded messages. +func (o *Buffer) dec_slice_struct_message(p *Properties, base structPointer) error { + return o.dec_slice_struct(p, false, base) +} + +// Decode a slice of embedded groups. +func (o *Buffer) dec_slice_struct_group(p *Properties, base structPointer) error { + return o.dec_slice_struct(p, true, base) +} + +// Decode a slice of structs ([]*struct). +func (o *Buffer) dec_slice_struct(p *Properties, is_group bool, base structPointer) error { + v := reflect.New(p.stype) + bas := toStructPointer(v) + structPointer_StructPointerSlice(base, p.field).Append(bas) + + if is_group { + err := o.unmarshalType(p.stype, p.sprop, is_group, bas) + return err + } + + raw, err := o.DecodeRawBytes(false) + if err != nil { + return err + } + + // If the object can unmarshal itself, let it. + if p.isUnmarshaler { + iv := v.Interface() + return iv.(Unmarshaler).Unmarshal(raw) + } + + obuf := o.buf + oi := o.index + o.buf = raw + o.index = 0 + + err = o.unmarshalType(p.stype, p.sprop, is_group, bas) + + o.buf = obuf + o.index = oi + + return err +} diff --git a/vendor/src/github.com/golang/protobuf/proto/encode.go b/vendor/src/github.com/golang/protobuf/proto/encode.go new file mode 100644 index 0000000000..d1abc3328d --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/encode.go @@ -0,0 +1,1288 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Routines for encoding data into the wire format for protocol buffers. + */ + +import ( + "errors" + "fmt" + "reflect" + "sort" +) + +// RequiredNotSetError is the error returned if Marshal is called with +// a protocol buffer struct whose required fields have not +// all been initialized. It is also the error returned if Unmarshal is +// called with an encoded protocol buffer that does not include all the +// required fields. +// +// When printed, RequiredNotSetError reports the first unset required field in a +// message. If the field cannot be precisely determined, it is reported as +// "{Unknown}". +type RequiredNotSetError struct { + field string +} + +func (e *RequiredNotSetError) Error() string { + return fmt.Sprintf("proto: required field %q not set", e.field) +} + +var ( + // errRepeatedHasNil is the error returned if Marshal is called with + // a struct with a repeated field containing a nil element. + errRepeatedHasNil = errors.New("proto: repeated field has nil element") + + // ErrNil is the error returned if Marshal is called with nil. + ErrNil = errors.New("proto: Marshal called with nil") +) + +// The fundamental encoders that put bytes on the wire. +// Those that take integer types all accept uint64 and are +// therefore of type valueEncoder. + +const maxVarintBytes = 10 // maximum length of a varint + +// EncodeVarint returns the varint encoding of x. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +// Not used by the package itself, but helpful to clients +// wishing to use the same encoding. +func EncodeVarint(x uint64) []byte { + var buf [maxVarintBytes]byte + var n int + for n = 0; x > 127; n++ { + buf[n] = 0x80 | uint8(x&0x7F) + x >>= 7 + } + buf[n] = uint8(x) + n++ + return buf[0:n] +} + +// EncodeVarint writes a varint-encoded integer to the Buffer. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +func (p *Buffer) EncodeVarint(x uint64) error { + for x >= 1<<7 { + p.buf = append(p.buf, uint8(x&0x7f|0x80)) + x >>= 7 + } + p.buf = append(p.buf, uint8(x)) + return nil +} + +func sizeVarint(x uint64) (n int) { + for { + n++ + x >>= 7 + if x == 0 { + break + } + } + return n +} + +// EncodeFixed64 writes a 64-bit integer to the Buffer. +// This is the format for the +// fixed64, sfixed64, and double protocol buffer types. +func (p *Buffer) EncodeFixed64(x uint64) error { + p.buf = append(p.buf, + uint8(x), + uint8(x>>8), + uint8(x>>16), + uint8(x>>24), + uint8(x>>32), + uint8(x>>40), + uint8(x>>48), + uint8(x>>56)) + return nil +} + +func sizeFixed64(x uint64) int { + return 8 +} + +// EncodeFixed32 writes a 32-bit integer to the Buffer. +// This is the format for the +// fixed32, sfixed32, and float protocol buffer types. +func (p *Buffer) EncodeFixed32(x uint64) error { + p.buf = append(p.buf, + uint8(x), + uint8(x>>8), + uint8(x>>16), + uint8(x>>24)) + return nil +} + +func sizeFixed32(x uint64) int { + return 4 +} + +// EncodeZigzag64 writes a zigzag-encoded 64-bit integer +// to the Buffer. +// This is the format used for the sint64 protocol buffer type. +func (p *Buffer) EncodeZigzag64(x uint64) error { + // use signed number to get arithmetic right shift. + return p.EncodeVarint(uint64((x << 1) ^ uint64((int64(x) >> 63)))) +} + +func sizeZigzag64(x uint64) int { + return sizeVarint(uint64((x << 1) ^ uint64((int64(x) >> 63)))) +} + +// EncodeZigzag32 writes a zigzag-encoded 32-bit integer +// to the Buffer. +// This is the format used for the sint32 protocol buffer type. +func (p *Buffer) EncodeZigzag32(x uint64) error { + // use signed number to get arithmetic right shift. + return p.EncodeVarint(uint64((uint32(x) << 1) ^ uint32((int32(x) >> 31)))) +} + +func sizeZigzag32(x uint64) int { + return sizeVarint(uint64((uint32(x) << 1) ^ uint32((int32(x) >> 31)))) +} + +// EncodeRawBytes writes a count-delimited byte buffer to the Buffer. +// This is the format used for the bytes protocol buffer +// type and for embedded messages. +func (p *Buffer) EncodeRawBytes(b []byte) error { + p.EncodeVarint(uint64(len(b))) + p.buf = append(p.buf, b...) + return nil +} + +func sizeRawBytes(b []byte) int { + return sizeVarint(uint64(len(b))) + + len(b) +} + +// EncodeStringBytes writes an encoded string to the Buffer. +// This is the format used for the proto2 string type. +func (p *Buffer) EncodeStringBytes(s string) error { + p.EncodeVarint(uint64(len(s))) + p.buf = append(p.buf, s...) + return nil +} + +func sizeStringBytes(s string) int { + return sizeVarint(uint64(len(s))) + + len(s) +} + +// Marshaler is the interface representing objects that can marshal themselves. +type Marshaler interface { + Marshal() ([]byte, error) +} + +// Marshal takes the protocol buffer +// and encodes it into the wire format, returning the data. +func Marshal(pb Message) ([]byte, error) { + // Can the object marshal itself? + if m, ok := pb.(Marshaler); ok { + return m.Marshal() + } + p := NewBuffer(nil) + err := p.Marshal(pb) + var state errorState + if err != nil && !state.shouldContinue(err, nil) { + return nil, err + } + if p.buf == nil && err == nil { + // Return a non-nil slice on success. + return []byte{}, nil + } + return p.buf, err +} + +// Marshal takes the protocol buffer +// and encodes it into the wire format, writing the result to the +// Buffer. +func (p *Buffer) Marshal(pb Message) error { + // Can the object marshal itself? + if m, ok := pb.(Marshaler); ok { + data, err := m.Marshal() + if err != nil { + return err + } + p.buf = append(p.buf, data...) + return nil + } + + t, base, err := getbase(pb) + if structPointer_IsNil(base) { + return ErrNil + } + if err == nil { + err = p.enc_struct(GetProperties(t.Elem()), base) + } + + if collectStats { + stats.Encode++ + } + + return err +} + +// Size returns the encoded size of a protocol buffer. +func Size(pb Message) (n int) { + // Can the object marshal itself? If so, Size is slow. + // TODO: add Size to Marshaler, or add a Sizer interface. + if m, ok := pb.(Marshaler); ok { + b, _ := m.Marshal() + return len(b) + } + + t, base, err := getbase(pb) + if structPointer_IsNil(base) { + return 0 + } + if err == nil { + n = size_struct(GetProperties(t.Elem()), base) + } + + if collectStats { + stats.Size++ + } + + return +} + +// Individual type encoders. + +// Encode a bool. +func (o *Buffer) enc_bool(p *Properties, base structPointer) error { + v := *structPointer_Bool(base, p.field) + if v == nil { + return ErrNil + } + x := 0 + if *v { + x = 1 + } + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, uint64(x)) + return nil +} + +func (o *Buffer) enc_proto3_bool(p *Properties, base structPointer) error { + v := *structPointer_BoolVal(base, p.field) + if !v { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, 1) + return nil +} + +func size_bool(p *Properties, base structPointer) int { + v := *structPointer_Bool(base, p.field) + if v == nil { + return 0 + } + return len(p.tagcode) + 1 // each bool takes exactly one byte +} + +func size_proto3_bool(p *Properties, base structPointer) int { + v := *structPointer_BoolVal(base, p.field) + if !v { + return 0 + } + return len(p.tagcode) + 1 // each bool takes exactly one byte +} + +// Encode an int32. +func (o *Buffer) enc_int32(p *Properties, base structPointer) error { + v := structPointer_Word32(base, p.field) + if word32_IsNil(v) { + return ErrNil + } + x := int32(word32_Get(v)) // permit sign extension to use full 64-bit range + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, uint64(x)) + return nil +} + +func (o *Buffer) enc_proto3_int32(p *Properties, base structPointer) error { + v := structPointer_Word32Val(base, p.field) + x := int32(word32Val_Get(v)) // permit sign extension to use full 64-bit range + if x == 0 { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, uint64(x)) + return nil +} + +func size_int32(p *Properties, base structPointer) (n int) { + v := structPointer_Word32(base, p.field) + if word32_IsNil(v) { + return 0 + } + x := int32(word32_Get(v)) // permit sign extension to use full 64-bit range + n += len(p.tagcode) + n += p.valSize(uint64(x)) + return +} + +func size_proto3_int32(p *Properties, base structPointer) (n int) { + v := structPointer_Word32Val(base, p.field) + x := int32(word32Val_Get(v)) // permit sign extension to use full 64-bit range + if x == 0 { + return 0 + } + n += len(p.tagcode) + n += p.valSize(uint64(x)) + return +} + +// Encode a uint32. +// Exactly the same as int32, except for no sign extension. +func (o *Buffer) enc_uint32(p *Properties, base structPointer) error { + v := structPointer_Word32(base, p.field) + if word32_IsNil(v) { + return ErrNil + } + x := word32_Get(v) + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, uint64(x)) + return nil +} + +func (o *Buffer) enc_proto3_uint32(p *Properties, base structPointer) error { + v := structPointer_Word32Val(base, p.field) + x := word32Val_Get(v) + if x == 0 { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, uint64(x)) + return nil +} + +func size_uint32(p *Properties, base structPointer) (n int) { + v := structPointer_Word32(base, p.field) + if word32_IsNil(v) { + return 0 + } + x := word32_Get(v) + n += len(p.tagcode) + n += p.valSize(uint64(x)) + return +} + +func size_proto3_uint32(p *Properties, base structPointer) (n int) { + v := structPointer_Word32Val(base, p.field) + x := word32Val_Get(v) + if x == 0 { + return 0 + } + n += len(p.tagcode) + n += p.valSize(uint64(x)) + return +} + +// Encode an int64. +func (o *Buffer) enc_int64(p *Properties, base structPointer) error { + v := structPointer_Word64(base, p.field) + if word64_IsNil(v) { + return ErrNil + } + x := word64_Get(v) + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, x) + return nil +} + +func (o *Buffer) enc_proto3_int64(p *Properties, base structPointer) error { + v := structPointer_Word64Val(base, p.field) + x := word64Val_Get(v) + if x == 0 { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, x) + return nil +} + +func size_int64(p *Properties, base structPointer) (n int) { + v := structPointer_Word64(base, p.field) + if word64_IsNil(v) { + return 0 + } + x := word64_Get(v) + n += len(p.tagcode) + n += p.valSize(x) + return +} + +func size_proto3_int64(p *Properties, base structPointer) (n int) { + v := structPointer_Word64Val(base, p.field) + x := word64Val_Get(v) + if x == 0 { + return 0 + } + n += len(p.tagcode) + n += p.valSize(x) + return +} + +// Encode a string. +func (o *Buffer) enc_string(p *Properties, base structPointer) error { + v := *structPointer_String(base, p.field) + if v == nil { + return ErrNil + } + x := *v + o.buf = append(o.buf, p.tagcode...) + o.EncodeStringBytes(x) + return nil +} + +func (o *Buffer) enc_proto3_string(p *Properties, base structPointer) error { + v := *structPointer_StringVal(base, p.field) + if v == "" { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + o.EncodeStringBytes(v) + return nil +} + +func size_string(p *Properties, base structPointer) (n int) { + v := *structPointer_String(base, p.field) + if v == nil { + return 0 + } + x := *v + n += len(p.tagcode) + n += sizeStringBytes(x) + return +} + +func size_proto3_string(p *Properties, base structPointer) (n int) { + v := *structPointer_StringVal(base, p.field) + if v == "" { + return 0 + } + n += len(p.tagcode) + n += sizeStringBytes(v) + return +} + +// All protocol buffer fields are nillable, but be careful. +func isNil(v reflect.Value) bool { + switch v.Kind() { + case reflect.Interface, reflect.Map, reflect.Ptr, reflect.Slice: + return v.IsNil() + } + return false +} + +// Encode a message struct. +func (o *Buffer) enc_struct_message(p *Properties, base structPointer) error { + var state errorState + structp := structPointer_GetStructPointer(base, p.field) + if structPointer_IsNil(structp) { + return ErrNil + } + + // Can the object marshal itself? + if p.isMarshaler { + m := structPointer_Interface(structp, p.stype).(Marshaler) + data, err := m.Marshal() + if err != nil && !state.shouldContinue(err, nil) { + return err + } + o.buf = append(o.buf, p.tagcode...) + o.EncodeRawBytes(data) + return nil + } + + o.buf = append(o.buf, p.tagcode...) + return o.enc_len_struct(p.sprop, structp, &state) +} + +func size_struct_message(p *Properties, base structPointer) int { + structp := structPointer_GetStructPointer(base, p.field) + if structPointer_IsNil(structp) { + return 0 + } + + // Can the object marshal itself? + if p.isMarshaler { + m := structPointer_Interface(structp, p.stype).(Marshaler) + data, _ := m.Marshal() + n0 := len(p.tagcode) + n1 := sizeRawBytes(data) + return n0 + n1 + } + + n0 := len(p.tagcode) + n1 := size_struct(p.sprop, structp) + n2 := sizeVarint(uint64(n1)) // size of encoded length + return n0 + n1 + n2 +} + +// Encode a group struct. +func (o *Buffer) enc_struct_group(p *Properties, base structPointer) error { + var state errorState + b := structPointer_GetStructPointer(base, p.field) + if structPointer_IsNil(b) { + return ErrNil + } + + o.EncodeVarint(uint64((p.Tag << 3) | WireStartGroup)) + err := o.enc_struct(p.sprop, b) + if err != nil && !state.shouldContinue(err, nil) { + return err + } + o.EncodeVarint(uint64((p.Tag << 3) | WireEndGroup)) + return state.err +} + +func size_struct_group(p *Properties, base structPointer) (n int) { + b := structPointer_GetStructPointer(base, p.field) + if structPointer_IsNil(b) { + return 0 + } + + n += sizeVarint(uint64((p.Tag << 3) | WireStartGroup)) + n += size_struct(p.sprop, b) + n += sizeVarint(uint64((p.Tag << 3) | WireEndGroup)) + return +} + +// Encode a slice of bools ([]bool). +func (o *Buffer) enc_slice_bool(p *Properties, base structPointer) error { + s := *structPointer_BoolSlice(base, p.field) + l := len(s) + if l == 0 { + return ErrNil + } + for _, x := range s { + o.buf = append(o.buf, p.tagcode...) + v := uint64(0) + if x { + v = 1 + } + p.valEnc(o, v) + } + return nil +} + +func size_slice_bool(p *Properties, base structPointer) int { + s := *structPointer_BoolSlice(base, p.field) + l := len(s) + if l == 0 { + return 0 + } + return l * (len(p.tagcode) + 1) // each bool takes exactly one byte +} + +// Encode a slice of bools ([]bool) in packed format. +func (o *Buffer) enc_slice_packed_bool(p *Properties, base structPointer) error { + s := *structPointer_BoolSlice(base, p.field) + l := len(s) + if l == 0 { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + o.EncodeVarint(uint64(l)) // each bool takes exactly one byte + for _, x := range s { + v := uint64(0) + if x { + v = 1 + } + p.valEnc(o, v) + } + return nil +} + +func size_slice_packed_bool(p *Properties, base structPointer) (n int) { + s := *structPointer_BoolSlice(base, p.field) + l := len(s) + if l == 0 { + return 0 + } + n += len(p.tagcode) + n += sizeVarint(uint64(l)) + n += l // each bool takes exactly one byte + return +} + +// Encode a slice of bytes ([]byte). +func (o *Buffer) enc_slice_byte(p *Properties, base structPointer) error { + s := *structPointer_Bytes(base, p.field) + if s == nil { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + o.EncodeRawBytes(s) + return nil +} + +func (o *Buffer) enc_proto3_slice_byte(p *Properties, base structPointer) error { + s := *structPointer_Bytes(base, p.field) + if len(s) == 0 { + return ErrNil + } + o.buf = append(o.buf, p.tagcode...) + o.EncodeRawBytes(s) + return nil +} + +func size_slice_byte(p *Properties, base structPointer) (n int) { + s := *structPointer_Bytes(base, p.field) + if s == nil { + return 0 + } + n += len(p.tagcode) + n += sizeRawBytes(s) + return +} + +func size_proto3_slice_byte(p *Properties, base structPointer) (n int) { + s := *structPointer_Bytes(base, p.field) + if len(s) == 0 { + return 0 + } + n += len(p.tagcode) + n += sizeRawBytes(s) + return +} + +// Encode a slice of int32s ([]int32). +func (o *Buffer) enc_slice_int32(p *Properties, base structPointer) error { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return ErrNil + } + for i := 0; i < l; i++ { + o.buf = append(o.buf, p.tagcode...) + x := int32(s.Index(i)) // permit sign extension to use full 64-bit range + p.valEnc(o, uint64(x)) + } + return nil +} + +func size_slice_int32(p *Properties, base structPointer) (n int) { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return 0 + } + for i := 0; i < l; i++ { + n += len(p.tagcode) + x := int32(s.Index(i)) // permit sign extension to use full 64-bit range + n += p.valSize(uint64(x)) + } + return +} + +// Encode a slice of int32s ([]int32) in packed format. +func (o *Buffer) enc_slice_packed_int32(p *Properties, base structPointer) error { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return ErrNil + } + // TODO: Reuse a Buffer. + buf := NewBuffer(nil) + for i := 0; i < l; i++ { + x := int32(s.Index(i)) // permit sign extension to use full 64-bit range + p.valEnc(buf, uint64(x)) + } + + o.buf = append(o.buf, p.tagcode...) + o.EncodeVarint(uint64(len(buf.buf))) + o.buf = append(o.buf, buf.buf...) + return nil +} + +func size_slice_packed_int32(p *Properties, base structPointer) (n int) { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return 0 + } + var bufSize int + for i := 0; i < l; i++ { + x := int32(s.Index(i)) // permit sign extension to use full 64-bit range + bufSize += p.valSize(uint64(x)) + } + + n += len(p.tagcode) + n += sizeVarint(uint64(bufSize)) + n += bufSize + return +} + +// Encode a slice of uint32s ([]uint32). +// Exactly the same as int32, except for no sign extension. +func (o *Buffer) enc_slice_uint32(p *Properties, base structPointer) error { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return ErrNil + } + for i := 0; i < l; i++ { + o.buf = append(o.buf, p.tagcode...) + x := s.Index(i) + p.valEnc(o, uint64(x)) + } + return nil +} + +func size_slice_uint32(p *Properties, base structPointer) (n int) { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return 0 + } + for i := 0; i < l; i++ { + n += len(p.tagcode) + x := s.Index(i) + n += p.valSize(uint64(x)) + } + return +} + +// Encode a slice of uint32s ([]uint32) in packed format. +// Exactly the same as int32, except for no sign extension. +func (o *Buffer) enc_slice_packed_uint32(p *Properties, base structPointer) error { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return ErrNil + } + // TODO: Reuse a Buffer. + buf := NewBuffer(nil) + for i := 0; i < l; i++ { + p.valEnc(buf, uint64(s.Index(i))) + } + + o.buf = append(o.buf, p.tagcode...) + o.EncodeVarint(uint64(len(buf.buf))) + o.buf = append(o.buf, buf.buf...) + return nil +} + +func size_slice_packed_uint32(p *Properties, base structPointer) (n int) { + s := structPointer_Word32Slice(base, p.field) + l := s.Len() + if l == 0 { + return 0 + } + var bufSize int + for i := 0; i < l; i++ { + bufSize += p.valSize(uint64(s.Index(i))) + } + + n += len(p.tagcode) + n += sizeVarint(uint64(bufSize)) + n += bufSize + return +} + +// Encode a slice of int64s ([]int64). +func (o *Buffer) enc_slice_int64(p *Properties, base structPointer) error { + s := structPointer_Word64Slice(base, p.field) + l := s.Len() + if l == 0 { + return ErrNil + } + for i := 0; i < l; i++ { + o.buf = append(o.buf, p.tagcode...) + p.valEnc(o, s.Index(i)) + } + return nil +} + +func size_slice_int64(p *Properties, base structPointer) (n int) { + s := structPointer_Word64Slice(base, p.field) + l := s.Len() + if l == 0 { + return 0 + } + for i := 0; i < l; i++ { + n += len(p.tagcode) + n += p.valSize(s.Index(i)) + } + return +} + +// Encode a slice of int64s ([]int64) in packed format. +func (o *Buffer) enc_slice_packed_int64(p *Properties, base structPointer) error { + s := structPointer_Word64Slice(base, p.field) + l := s.Len() + if l == 0 { + return ErrNil + } + // TODO: Reuse a Buffer. + buf := NewBuffer(nil) + for i := 0; i < l; i++ { + p.valEnc(buf, s.Index(i)) + } + + o.buf = append(o.buf, p.tagcode...) + o.EncodeVarint(uint64(len(buf.buf))) + o.buf = append(o.buf, buf.buf...) + return nil +} + +func size_slice_packed_int64(p *Properties, base structPointer) (n int) { + s := structPointer_Word64Slice(base, p.field) + l := s.Len() + if l == 0 { + return 0 + } + var bufSize int + for i := 0; i < l; i++ { + bufSize += p.valSize(s.Index(i)) + } + + n += len(p.tagcode) + n += sizeVarint(uint64(bufSize)) + n += bufSize + return +} + +// Encode a slice of slice of bytes ([][]byte). +func (o *Buffer) enc_slice_slice_byte(p *Properties, base structPointer) error { + ss := *structPointer_BytesSlice(base, p.field) + l := len(ss) + if l == 0 { + return ErrNil + } + for i := 0; i < l; i++ { + o.buf = append(o.buf, p.tagcode...) + o.EncodeRawBytes(ss[i]) + } + return nil +} + +func size_slice_slice_byte(p *Properties, base structPointer) (n int) { + ss := *structPointer_BytesSlice(base, p.field) + l := len(ss) + if l == 0 { + return 0 + } + n += l * len(p.tagcode) + for i := 0; i < l; i++ { + n += sizeRawBytes(ss[i]) + } + return +} + +// Encode a slice of strings ([]string). +func (o *Buffer) enc_slice_string(p *Properties, base structPointer) error { + ss := *structPointer_StringSlice(base, p.field) + l := len(ss) + for i := 0; i < l; i++ { + o.buf = append(o.buf, p.tagcode...) + o.EncodeStringBytes(ss[i]) + } + return nil +} + +func size_slice_string(p *Properties, base structPointer) (n int) { + ss := *structPointer_StringSlice(base, p.field) + l := len(ss) + n += l * len(p.tagcode) + for i := 0; i < l; i++ { + n += sizeStringBytes(ss[i]) + } + return +} + +// Encode a slice of message structs ([]*struct). +func (o *Buffer) enc_slice_struct_message(p *Properties, base structPointer) error { + var state errorState + s := structPointer_StructPointerSlice(base, p.field) + l := s.Len() + + for i := 0; i < l; i++ { + structp := s.Index(i) + if structPointer_IsNil(structp) { + return errRepeatedHasNil + } + + // Can the object marshal itself? + if p.isMarshaler { + m := structPointer_Interface(structp, p.stype).(Marshaler) + data, err := m.Marshal() + if err != nil && !state.shouldContinue(err, nil) { + return err + } + o.buf = append(o.buf, p.tagcode...) + o.EncodeRawBytes(data) + continue + } + + o.buf = append(o.buf, p.tagcode...) + err := o.enc_len_struct(p.sprop, structp, &state) + if err != nil && !state.shouldContinue(err, nil) { + if err == ErrNil { + return errRepeatedHasNil + } + return err + } + } + return state.err +} + +func size_slice_struct_message(p *Properties, base structPointer) (n int) { + s := structPointer_StructPointerSlice(base, p.field) + l := s.Len() + n += l * len(p.tagcode) + for i := 0; i < l; i++ { + structp := s.Index(i) + if structPointer_IsNil(structp) { + return // return the size up to this point + } + + // Can the object marshal itself? + if p.isMarshaler { + m := structPointer_Interface(structp, p.stype).(Marshaler) + data, _ := m.Marshal() + n += len(p.tagcode) + n += sizeRawBytes(data) + continue + } + + n0 := size_struct(p.sprop, structp) + n1 := sizeVarint(uint64(n0)) // size of encoded length + n += n0 + n1 + } + return +} + +// Encode a slice of group structs ([]*struct). +func (o *Buffer) enc_slice_struct_group(p *Properties, base structPointer) error { + var state errorState + s := structPointer_StructPointerSlice(base, p.field) + l := s.Len() + + for i := 0; i < l; i++ { + b := s.Index(i) + if structPointer_IsNil(b) { + return errRepeatedHasNil + } + + o.EncodeVarint(uint64((p.Tag << 3) | WireStartGroup)) + + err := o.enc_struct(p.sprop, b) + + if err != nil && !state.shouldContinue(err, nil) { + if err == ErrNil { + return errRepeatedHasNil + } + return err + } + + o.EncodeVarint(uint64((p.Tag << 3) | WireEndGroup)) + } + return state.err +} + +func size_slice_struct_group(p *Properties, base structPointer) (n int) { + s := structPointer_StructPointerSlice(base, p.field) + l := s.Len() + + n += l * sizeVarint(uint64((p.Tag<<3)|WireStartGroup)) + n += l * sizeVarint(uint64((p.Tag<<3)|WireEndGroup)) + for i := 0; i < l; i++ { + b := s.Index(i) + if structPointer_IsNil(b) { + return // return size up to this point + } + + n += size_struct(p.sprop, b) + } + return +} + +// Encode an extension map. +func (o *Buffer) enc_map(p *Properties, base structPointer) error { + v := *structPointer_ExtMap(base, p.field) + if err := encodeExtensionMap(v); err != nil { + return err + } + // Fast-path for common cases: zero or one extensions. + if len(v) <= 1 { + for _, e := range v { + o.buf = append(o.buf, e.enc...) + } + return nil + } + + // Sort keys to provide a deterministic encoding. + keys := make([]int, 0, len(v)) + for k := range v { + keys = append(keys, int(k)) + } + sort.Ints(keys) + + for _, k := range keys { + o.buf = append(o.buf, v[int32(k)].enc...) + } + return nil +} + +func size_map(p *Properties, base structPointer) int { + v := *structPointer_ExtMap(base, p.field) + return sizeExtensionMap(v) +} + +// Encode a map field. +func (o *Buffer) enc_new_map(p *Properties, base structPointer) error { + var state errorState // XXX: or do we need to plumb this through? + + /* + A map defined as + map map_field = N; + is encoded in the same way as + message MapFieldEntry { + key_type key = 1; + value_type value = 2; + } + repeated MapFieldEntry map_field = N; + */ + + v := structPointer_Map(base, p.field, p.mtype).Elem() // map[K]V + if v.Len() == 0 { + return nil + } + + keycopy, valcopy, keybase, valbase := mapEncodeScratch(p.mtype) + + enc := func() error { + if err := p.mkeyprop.enc(o, p.mkeyprop, keybase); err != nil { + return err + } + if err := p.mvalprop.enc(o, p.mvalprop, valbase); err != nil { + return err + } + return nil + } + + keys := v.MapKeys() + sort.Sort(mapKeys(keys)) + for _, key := range keys { + val := v.MapIndex(key) + + keycopy.Set(key) + valcopy.Set(val) + + o.buf = append(o.buf, p.tagcode...) + if err := o.enc_len_thing(enc, &state); err != nil { + return err + } + } + return nil +} + +func size_new_map(p *Properties, base structPointer) int { + v := structPointer_Map(base, p.field, p.mtype).Elem() // map[K]V + + keycopy, valcopy, keybase, valbase := mapEncodeScratch(p.mtype) + + n := 0 + for _, key := range v.MapKeys() { + val := v.MapIndex(key) + keycopy.Set(key) + valcopy.Set(val) + + // Tag codes for key and val are the responsibility of the sub-sizer. + keysize := p.mkeyprop.size(p.mkeyprop, keybase) + valsize := p.mvalprop.size(p.mvalprop, valbase) + entry := keysize + valsize + // Add on tag code and length of map entry itself. + n += len(p.tagcode) + sizeVarint(uint64(entry)) + entry + } + return n +} + +// mapEncodeScratch returns a new reflect.Value matching the map's value type, +// and a structPointer suitable for passing to an encoder or sizer. +func mapEncodeScratch(mapType reflect.Type) (keycopy, valcopy reflect.Value, keybase, valbase structPointer) { + // Prepare addressable doubly-indirect placeholders for the key and value types. + // This is needed because the element-type encoders expect **T, but the map iteration produces T. + + keycopy = reflect.New(mapType.Key()).Elem() // addressable K + keyptr := reflect.New(reflect.PtrTo(keycopy.Type())).Elem() // addressable *K + keyptr.Set(keycopy.Addr()) // + keybase = toStructPointer(keyptr.Addr()) // **K + + // Value types are more varied and require special handling. + switch mapType.Elem().Kind() { + case reflect.Slice: + // []byte + var dummy []byte + valcopy = reflect.ValueOf(&dummy).Elem() // addressable []byte + valbase = toStructPointer(valcopy.Addr()) + case reflect.Ptr: + // message; the generated field type is map[K]*Msg (so V is *Msg), + // so we only need one level of indirection. + valcopy = reflect.New(mapType.Elem()).Elem() // addressable V + valbase = toStructPointer(valcopy.Addr()) + default: + // everything else + valcopy = reflect.New(mapType.Elem()).Elem() // addressable V + valptr := reflect.New(reflect.PtrTo(valcopy.Type())).Elem() // addressable *V + valptr.Set(valcopy.Addr()) // + valbase = toStructPointer(valptr.Addr()) // **V + } + return +} + +// Encode a struct. +func (o *Buffer) enc_struct(prop *StructProperties, base structPointer) error { + var state errorState + // Encode fields in tag order so that decoders may use optimizations + // that depend on the ordering. + // https://developers.google.com/protocol-buffers/docs/encoding#order + for _, i := range prop.order { + p := prop.Prop[i] + if p.enc != nil { + err := p.enc(o, p, base) + if err != nil { + if err == ErrNil { + if p.Required && state.err == nil { + state.err = &RequiredNotSetError{p.Name} + } + } else if err == errRepeatedHasNil { + // Give more context to nil values in repeated fields. + return errors.New("repeated field " + p.OrigName + " has nil element") + } else if !state.shouldContinue(err, p) { + return err + } + } + } + } + + // Add unrecognized fields at the end. + if prop.unrecField.IsValid() { + v := *structPointer_Bytes(base, prop.unrecField) + if len(v) > 0 { + o.buf = append(o.buf, v...) + } + } + + return state.err +} + +func size_struct(prop *StructProperties, base structPointer) (n int) { + for _, i := range prop.order { + p := prop.Prop[i] + if p.size != nil { + n += p.size(p, base) + } + } + + // Add unrecognized fields at the end. + if prop.unrecField.IsValid() { + v := *structPointer_Bytes(base, prop.unrecField) + n += len(v) + } + + return +} + +var zeroes [20]byte // longer than any conceivable sizeVarint + +// Encode a struct, preceded by its encoded length (as a varint). +func (o *Buffer) enc_len_struct(prop *StructProperties, base structPointer, state *errorState) error { + return o.enc_len_thing(func() error { return o.enc_struct(prop, base) }, state) +} + +// Encode something, preceded by its encoded length (as a varint). +func (o *Buffer) enc_len_thing(enc func() error, state *errorState) error { + iLen := len(o.buf) + o.buf = append(o.buf, 0, 0, 0, 0) // reserve four bytes for length + iMsg := len(o.buf) + err := enc() + if err != nil && !state.shouldContinue(err, nil) { + return err + } + lMsg := len(o.buf) - iMsg + lLen := sizeVarint(uint64(lMsg)) + switch x := lLen - (iMsg - iLen); { + case x > 0: // actual length is x bytes larger than the space we reserved + // Move msg x bytes right. + o.buf = append(o.buf, zeroes[:x]...) + copy(o.buf[iMsg+x:], o.buf[iMsg:iMsg+lMsg]) + case x < 0: // actual length is x bytes smaller than the space we reserved + // Move msg x bytes left. + copy(o.buf[iMsg+x:], o.buf[iMsg:iMsg+lMsg]) + o.buf = o.buf[:len(o.buf)+x] // x is negative + } + // Encode the length in the reserved space. + o.buf = o.buf[:iLen] + o.EncodeVarint(uint64(lMsg)) + o.buf = o.buf[:len(o.buf)+lMsg] + return state.err +} + +// errorState maintains the first error that occurs and updates that error +// with additional context. +type errorState struct { + err error +} + +// shouldContinue reports whether encoding should continue upon encountering the +// given error. If the error is RequiredNotSetError, shouldContinue returns true +// and, if this is the first appearance of that error, remembers it for future +// reporting. +// +// If prop is not nil, it may update any error with additional context about the +// field with the error. +func (s *errorState) shouldContinue(err error, prop *Properties) bool { + // Ignore unset required fields. + reqNotSet, ok := err.(*RequiredNotSetError) + if !ok { + return false + } + if s.err == nil { + if prop != nil { + err = &RequiredNotSetError{prop.Name + "." + reqNotSet.field} + } + s.err = err + } + return true +} diff --git a/vendor/src/github.com/golang/protobuf/proto/equal.go b/vendor/src/github.com/golang/protobuf/proto/equal.go new file mode 100644 index 0000000000..d8673a3e97 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/equal.go @@ -0,0 +1,256 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2011 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// Protocol buffer comparison. +// TODO: MessageSet. + +package proto + +import ( + "bytes" + "log" + "reflect" + "strings" +) + +/* +Equal returns true iff protocol buffers a and b are equal. +The arguments must both be pointers to protocol buffer structs. + +Equality is defined in this way: + - Two messages are equal iff they are the same type, + corresponding fields are equal, unknown field sets + are equal, and extensions sets are equal. + - Two set scalar fields are equal iff their values are equal. + If the fields are of a floating-point type, remember that + NaN != x for all x, including NaN. + - Two repeated fields are equal iff their lengths are the same, + and their corresponding elements are equal (a "bytes" field, + although represented by []byte, is not a repeated field) + - Two unset fields are equal. + - Two unknown field sets are equal if their current + encoded state is equal. + - Two extension sets are equal iff they have corresponding + elements that are pairwise equal. + - Every other combination of things are not equal. + +The return value is undefined if a and b are not protocol buffers. +*/ +func Equal(a, b Message) bool { + if a == nil || b == nil { + return a == b + } + v1, v2 := reflect.ValueOf(a), reflect.ValueOf(b) + if v1.Type() != v2.Type() { + return false + } + if v1.Kind() == reflect.Ptr { + if v1.IsNil() { + return v2.IsNil() + } + if v2.IsNil() { + return false + } + v1, v2 = v1.Elem(), v2.Elem() + } + if v1.Kind() != reflect.Struct { + return false + } + return equalStruct(v1, v2) +} + +// v1 and v2 are known to have the same type. +func equalStruct(v1, v2 reflect.Value) bool { + for i := 0; i < v1.NumField(); i++ { + f := v1.Type().Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + f1, f2 := v1.Field(i), v2.Field(i) + if f.Type.Kind() == reflect.Ptr { + if n1, n2 := f1.IsNil(), f2.IsNil(); n1 && n2 { + // both unset + continue + } else if n1 != n2 { + // set/unset mismatch + return false + } + b1, ok := f1.Interface().(raw) + if ok { + b2 := f2.Interface().(raw) + // RawMessage + if !bytes.Equal(b1.Bytes(), b2.Bytes()) { + return false + } + continue + } + f1, f2 = f1.Elem(), f2.Elem() + } + if !equalAny(f1, f2) { + return false + } + } + + if em1 := v1.FieldByName("XXX_extensions"); em1.IsValid() { + em2 := v2.FieldByName("XXX_extensions") + if !equalExtensions(v1.Type(), em1.Interface().(map[int32]Extension), em2.Interface().(map[int32]Extension)) { + return false + } + } + + uf := v1.FieldByName("XXX_unrecognized") + if !uf.IsValid() { + return true + } + + u1 := uf.Bytes() + u2 := v2.FieldByName("XXX_unrecognized").Bytes() + if !bytes.Equal(u1, u2) { + return false + } + + return true +} + +// v1 and v2 are known to have the same type. +func equalAny(v1, v2 reflect.Value) bool { + if v1.Type() == protoMessageType { + m1, _ := v1.Interface().(Message) + m2, _ := v2.Interface().(Message) + return Equal(m1, m2) + } + switch v1.Kind() { + case reflect.Bool: + return v1.Bool() == v2.Bool() + case reflect.Float32, reflect.Float64: + return v1.Float() == v2.Float() + case reflect.Int32, reflect.Int64: + return v1.Int() == v2.Int() + case reflect.Map: + if v1.Len() != v2.Len() { + return false + } + for _, key := range v1.MapKeys() { + val2 := v2.MapIndex(key) + if !val2.IsValid() { + // This key was not found in the second map. + return false + } + if !equalAny(v1.MapIndex(key), val2) { + return false + } + } + return true + case reflect.Ptr: + return equalAny(v1.Elem(), v2.Elem()) + case reflect.Slice: + if v1.Type().Elem().Kind() == reflect.Uint8 { + // short circuit: []byte + if v1.IsNil() != v2.IsNil() { + return false + } + return bytes.Equal(v1.Interface().([]byte), v2.Interface().([]byte)) + } + + if v1.Len() != v2.Len() { + return false + } + for i := 0; i < v1.Len(); i++ { + if !equalAny(v1.Index(i), v2.Index(i)) { + return false + } + } + return true + case reflect.String: + return v1.Interface().(string) == v2.Interface().(string) + case reflect.Struct: + return equalStruct(v1, v2) + case reflect.Uint32, reflect.Uint64: + return v1.Uint() == v2.Uint() + } + + // unknown type, so not a protocol buffer + log.Printf("proto: don't know how to compare %v", v1) + return false +} + +// base is the struct type that the extensions are based on. +// em1 and em2 are extension maps. +func equalExtensions(base reflect.Type, em1, em2 map[int32]Extension) bool { + if len(em1) != len(em2) { + return false + } + + for extNum, e1 := range em1 { + e2, ok := em2[extNum] + if !ok { + return false + } + + m1, m2 := e1.value, e2.value + + if m1 != nil && m2 != nil { + // Both are unencoded. + if !equalAny(reflect.ValueOf(m1), reflect.ValueOf(m2)) { + return false + } + continue + } + + // At least one is encoded. To do a semantically correct comparison + // we need to unmarshal them first. + var desc *ExtensionDesc + if m := extensionMaps[base]; m != nil { + desc = m[extNum] + } + if desc == nil { + log.Printf("proto: don't know how to compare extension %d of %v", extNum, base) + continue + } + var err error + if m1 == nil { + m1, err = decodeExtension(e1.enc, desc) + } + if m2 == nil && err == nil { + m2, err = decodeExtension(e2.enc, desc) + } + if err != nil { + // The encoded form is invalid. + log.Printf("proto: badly encoded extension %d of %v: %v", extNum, base, err) + return false + } + if !equalAny(reflect.ValueOf(m1), reflect.ValueOf(m2)) { + return false + } + } + + return true +} diff --git a/vendor/src/github.com/golang/protobuf/proto/extensions.go b/vendor/src/github.com/golang/protobuf/proto/extensions.go new file mode 100644 index 0000000000..5f62dff247 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/extensions.go @@ -0,0 +1,362 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Types and routines for supporting protocol buffer extensions. + */ + +import ( + "errors" + "fmt" + "reflect" + "strconv" + "sync" +) + +// ErrMissingExtension is the error returned by GetExtension if the named extension is not in the message. +var ErrMissingExtension = errors.New("proto: missing extension") + +// ExtensionRange represents a range of message extensions for a protocol buffer. +// Used in code generated by the protocol compiler. +type ExtensionRange struct { + Start, End int32 // both inclusive +} + +// extendableProto is an interface implemented by any protocol buffer that may be extended. +type extendableProto interface { + Message + ExtensionRangeArray() []ExtensionRange + ExtensionMap() map[int32]Extension +} + +var extendableProtoType = reflect.TypeOf((*extendableProto)(nil)).Elem() + +// ExtensionDesc represents an extension specification. +// Used in generated code from the protocol compiler. +type ExtensionDesc struct { + ExtendedType Message // nil pointer to the type that is being extended + ExtensionType interface{} // nil pointer to the extension type + Field int32 // field number + Name string // fully-qualified name of extension, for text formatting + Tag string // protobuf tag style +} + +func (ed *ExtensionDesc) repeated() bool { + t := reflect.TypeOf(ed.ExtensionType) + return t.Kind() == reflect.Slice && t.Elem().Kind() != reflect.Uint8 +} + +// Extension represents an extension in a message. +type Extension struct { + // When an extension is stored in a message using SetExtension + // only desc and value are set. When the message is marshaled + // enc will be set to the encoded form of the message. + // + // When a message is unmarshaled and contains extensions, each + // extension will have only enc set. When such an extension is + // accessed using GetExtension (or GetExtensions) desc and value + // will be set. + desc *ExtensionDesc + value interface{} + enc []byte +} + +// SetRawExtension is for testing only. +func SetRawExtension(base extendableProto, id int32, b []byte) { + base.ExtensionMap()[id] = Extension{enc: b} +} + +// isExtensionField returns true iff the given field number is in an extension range. +func isExtensionField(pb extendableProto, field int32) bool { + for _, er := range pb.ExtensionRangeArray() { + if er.Start <= field && field <= er.End { + return true + } + } + return false +} + +// checkExtensionTypes checks that the given extension is valid for pb. +func checkExtensionTypes(pb extendableProto, extension *ExtensionDesc) error { + // Check the extended type. + if a, b := reflect.TypeOf(pb), reflect.TypeOf(extension.ExtendedType); a != b { + return errors.New("proto: bad extended type; " + b.String() + " does not extend " + a.String()) + } + // Check the range. + if !isExtensionField(pb, extension.Field) { + return errors.New("proto: bad extension number; not in declared ranges") + } + return nil +} + +// extPropKey is sufficient to uniquely identify an extension. +type extPropKey struct { + base reflect.Type + field int32 +} + +var extProp = struct { + sync.RWMutex + m map[extPropKey]*Properties +}{ + m: make(map[extPropKey]*Properties), +} + +func extensionProperties(ed *ExtensionDesc) *Properties { + key := extPropKey{base: reflect.TypeOf(ed.ExtendedType), field: ed.Field} + + extProp.RLock() + if prop, ok := extProp.m[key]; ok { + extProp.RUnlock() + return prop + } + extProp.RUnlock() + + extProp.Lock() + defer extProp.Unlock() + // Check again. + if prop, ok := extProp.m[key]; ok { + return prop + } + + prop := new(Properties) + prop.Init(reflect.TypeOf(ed.ExtensionType), "unknown_name", ed.Tag, nil) + extProp.m[key] = prop + return prop +} + +// encodeExtensionMap encodes any unmarshaled (unencoded) extensions in m. +func encodeExtensionMap(m map[int32]Extension) error { + for k, e := range m { + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + et := reflect.TypeOf(e.desc.ExtensionType) + props := extensionProperties(e.desc) + + p := NewBuffer(nil) + // If e.value has type T, the encoder expects a *struct{ X T }. + // Pass a *T with a zero field and hope it all works out. + x := reflect.New(et) + x.Elem().Set(reflect.ValueOf(e.value)) + if err := props.enc(p, props, toStructPointer(x)); err != nil { + return err + } + e.enc = p.buf + m[k] = e + } + return nil +} + +func sizeExtensionMap(m map[int32]Extension) (n int) { + for _, e := range m { + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + n += len(e.enc) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + et := reflect.TypeOf(e.desc.ExtensionType) + props := extensionProperties(e.desc) + + // If e.value has type T, the encoder expects a *struct{ X T }. + // Pass a *T with a zero field and hope it all works out. + x := reflect.New(et) + x.Elem().Set(reflect.ValueOf(e.value)) + n += props.size(props, toStructPointer(x)) + } + return +} + +// HasExtension returns whether the given extension is present in pb. +func HasExtension(pb extendableProto, extension *ExtensionDesc) bool { + // TODO: Check types, field numbers, etc.? + _, ok := pb.ExtensionMap()[extension.Field] + return ok +} + +// ClearExtension removes the given extension from pb. +func ClearExtension(pb extendableProto, extension *ExtensionDesc) { + // TODO: Check types, field numbers, etc.? + delete(pb.ExtensionMap(), extension.Field) +} + +// GetExtension parses and returns the given extension of pb. +// If the extension is not present it returns ErrMissingExtension. +func GetExtension(pb extendableProto, extension *ExtensionDesc) (interface{}, error) { + if err := checkExtensionTypes(pb, extension); err != nil { + return nil, err + } + + emap := pb.ExtensionMap() + e, ok := emap[extension.Field] + if !ok { + return nil, ErrMissingExtension + } + if e.value != nil { + // Already decoded. Check the descriptor, though. + if e.desc != extension { + // This shouldn't happen. If it does, it means that + // GetExtension was called twice with two different + // descriptors with the same field number. + return nil, errors.New("proto: descriptor conflict") + } + return e.value, nil + } + + v, err := decodeExtension(e.enc, extension) + if err != nil { + return nil, err + } + + // Remember the decoded version and drop the encoded version. + // That way it is safe to mutate what we return. + e.value = v + e.desc = extension + e.enc = nil + emap[extension.Field] = e + return e.value, nil +} + +// decodeExtension decodes an extension encoded in b. +func decodeExtension(b []byte, extension *ExtensionDesc) (interface{}, error) { + o := NewBuffer(b) + + t := reflect.TypeOf(extension.ExtensionType) + rep := extension.repeated() + + props := extensionProperties(extension) + + // t is a pointer to a struct, pointer to basic type or a slice. + // Allocate a "field" to store the pointer/slice itself; the + // pointer/slice will be stored here. We pass + // the address of this field to props.dec. + // This passes a zero field and a *t and lets props.dec + // interpret it as a *struct{ x t }. + value := reflect.New(t).Elem() + + for { + // Discard wire type and field number varint. It isn't needed. + if _, err := o.DecodeVarint(); err != nil { + return nil, err + } + + if err := props.dec(o, props, toStructPointer(value.Addr())); err != nil { + return nil, err + } + + if !rep || o.index >= len(o.buf) { + break + } + } + return value.Interface(), nil +} + +// GetExtensions returns a slice of the extensions present in pb that are also listed in es. +// The returned slice has the same length as es; missing extensions will appear as nil elements. +func GetExtensions(pb Message, es []*ExtensionDesc) (extensions []interface{}, err error) { + epb, ok := pb.(extendableProto) + if !ok { + err = errors.New("proto: not an extendable proto") + return + } + extensions = make([]interface{}, len(es)) + for i, e := range es { + extensions[i], err = GetExtension(epb, e) + if err == ErrMissingExtension { + err = nil + } + if err != nil { + return + } + } + return +} + +// SetExtension sets the specified extension of pb to the specified value. +func SetExtension(pb extendableProto, extension *ExtensionDesc, value interface{}) error { + if err := checkExtensionTypes(pb, extension); err != nil { + return err + } + typ := reflect.TypeOf(extension.ExtensionType) + if typ != reflect.TypeOf(value) { + return errors.New("proto: bad extension value type") + } + // nil extension values need to be caught early, because the + // encoder can't distinguish an ErrNil due to a nil extension + // from an ErrNil due to a missing field. Extensions are + // always optional, so the encoder would just swallow the error + // and drop all the extensions from the encoded message. + if reflect.ValueOf(value).IsNil() { + return fmt.Errorf("proto: SetExtension called with nil value of type %T", value) + } + + pb.ExtensionMap()[extension.Field] = Extension{desc: extension, value: value} + return nil +} + +// A global registry of extensions. +// The generated code will register the generated descriptors by calling RegisterExtension. + +var extensionMaps = make(map[reflect.Type]map[int32]*ExtensionDesc) + +// RegisterExtension is called from the generated code. +func RegisterExtension(desc *ExtensionDesc) { + st := reflect.TypeOf(desc.ExtendedType).Elem() + m := extensionMaps[st] + if m == nil { + m = make(map[int32]*ExtensionDesc) + extensionMaps[st] = m + } + if _, ok := m[desc.Field]; ok { + panic("proto: duplicate extension registered: " + st.String() + " " + strconv.Itoa(int(desc.Field))) + } + m[desc.Field] = desc +} + +// RegisteredExtensions returns a map of the registered extensions of a +// protocol buffer struct, indexed by the extension number. +// The argument pb should be a nil pointer to the struct type. +func RegisteredExtensions(pb Message) map[int32]*ExtensionDesc { + return extensionMaps[reflect.TypeOf(pb).Elem()] +} diff --git a/vendor/src/github.com/golang/protobuf/proto/lib.go b/vendor/src/github.com/golang/protobuf/proto/lib.go new file mode 100644 index 0000000000..fb139f6b74 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/lib.go @@ -0,0 +1,790 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +/* + Package proto converts data structures to and from the wire format of + protocol buffers. It works in concert with the Go source code generated + for .proto files by the protocol compiler. + + A summary of the properties of the protocol buffer interface + for a protocol buffer variable v: + + - Names are turned from camel_case to CamelCase for export. + - There are no methods on v to set fields; just treat + them as structure fields. + - There are getters that return a field's value if set, + and return the field's default value if unset. + The getters work even if the receiver is a nil message. + - The zero value for a struct is its correct initialization state. + All desired fields must be set before marshaling. + - A Reset() method will restore a protobuf struct to its zero state. + - Non-repeated fields are pointers to the values; nil means unset. + That is, optional or required field int32 f becomes F *int32. + - Repeated fields are slices. + - Helper functions are available to aid the setting of fields. + msg.Foo = proto.String("hello") // set field + - Constants are defined to hold the default values of all fields that + have them. They have the form Default_StructName_FieldName. + Because the getter methods handle defaulted values, + direct use of these constants should be rare. + - Enums are given type names and maps from names to values. + Enum values are prefixed by the enclosing message's name, or by the + enum's type name if it is a top-level enum. Enum types have a String + method, and a Enum method to assist in message construction. + - Nested messages, groups and enums have type names prefixed with the name of + the surrounding message type. + - Extensions are given descriptor names that start with E_, + followed by an underscore-delimited list of the nested messages + that contain it (if any) followed by the CamelCased name of the + extension field itself. HasExtension, ClearExtension, GetExtension + and SetExtension are functions for manipulating extensions. + - Marshal and Unmarshal are functions to encode and decode the wire format. + + The simplest way to describe this is to see an example. + Given file test.proto, containing + + package example; + + enum FOO { X = 17; } + + message Test { + required string label = 1; + optional int32 type = 2 [default=77]; + repeated int64 reps = 3; + optional group OptionalGroup = 4 { + required string RequiredField = 5; + } + } + + The resulting file, test.pb.go, is: + + package example + + import proto "github.com/golang/protobuf/proto" + import math "math" + + type FOO int32 + const ( + FOO_X FOO = 17 + ) + var FOO_name = map[int32]string{ + 17: "X", + } + var FOO_value = map[string]int32{ + "X": 17, + } + + func (x FOO) Enum() *FOO { + p := new(FOO) + *p = x + return p + } + func (x FOO) String() string { + return proto.EnumName(FOO_name, int32(x)) + } + func (x *FOO) UnmarshalJSON(data []byte) error { + value, err := proto.UnmarshalJSONEnum(FOO_value, data) + if err != nil { + return err + } + *x = FOO(value) + return nil + } + + type Test struct { + Label *string `protobuf:"bytes,1,req,name=label" json:"label,omitempty"` + Type *int32 `protobuf:"varint,2,opt,name=type,def=77" json:"type,omitempty"` + Reps []int64 `protobuf:"varint,3,rep,name=reps" json:"reps,omitempty"` + Optionalgroup *Test_OptionalGroup `protobuf:"group,4,opt,name=OptionalGroup" json:"optionalgroup,omitempty"` + XXX_unrecognized []byte `json:"-"` + } + func (m *Test) Reset() { *m = Test{} } + func (m *Test) String() string { return proto.CompactTextString(m) } + func (*Test) ProtoMessage() {} + const Default_Test_Type int32 = 77 + + func (m *Test) GetLabel() string { + if m != nil && m.Label != nil { + return *m.Label + } + return "" + } + + func (m *Test) GetType() int32 { + if m != nil && m.Type != nil { + return *m.Type + } + return Default_Test_Type + } + + func (m *Test) GetOptionalgroup() *Test_OptionalGroup { + if m != nil { + return m.Optionalgroup + } + return nil + } + + type Test_OptionalGroup struct { + RequiredField *string `protobuf:"bytes,5,req" json:"RequiredField,omitempty"` + } + func (m *Test_OptionalGroup) Reset() { *m = Test_OptionalGroup{} } + func (m *Test_OptionalGroup) String() string { return proto.CompactTextString(m) } + + func (m *Test_OptionalGroup) GetRequiredField() string { + if m != nil && m.RequiredField != nil { + return *m.RequiredField + } + return "" + } + + func init() { + proto.RegisterEnum("example.FOO", FOO_name, FOO_value) + } + + To create and play with a Test object: + + package main + + import ( + "log" + + "github.com/golang/protobuf/proto" + pb "./example.pb" + ) + + func main() { + test := &pb.Test{ + Label: proto.String("hello"), + Type: proto.Int32(17), + Optionalgroup: &pb.Test_OptionalGroup{ + RequiredField: proto.String("good bye"), + }, + } + data, err := proto.Marshal(test) + if err != nil { + log.Fatal("marshaling error: ", err) + } + newTest := &pb.Test{} + err = proto.Unmarshal(data, newTest) + if err != nil { + log.Fatal("unmarshaling error: ", err) + } + // Now test and newTest contain the same data. + if test.GetLabel() != newTest.GetLabel() { + log.Fatalf("data mismatch %q != %q", test.GetLabel(), newTest.GetLabel()) + } + // etc. + } +*/ +package proto + +import ( + "encoding/json" + "fmt" + "log" + "reflect" + "strconv" + "sync" +) + +// Message is implemented by generated protocol buffer messages. +type Message interface { + Reset() + String() string + ProtoMessage() +} + +// Stats records allocation details about the protocol buffer encoders +// and decoders. Useful for tuning the library itself. +type Stats struct { + Emalloc uint64 // mallocs in encode + Dmalloc uint64 // mallocs in decode + Encode uint64 // number of encodes + Decode uint64 // number of decodes + Chit uint64 // number of cache hits + Cmiss uint64 // number of cache misses + Size uint64 // number of sizes +} + +// Set to true to enable stats collection. +const collectStats = false + +var stats Stats + +// GetStats returns a copy of the global Stats structure. +func GetStats() Stats { return stats } + +// A Buffer is a buffer manager for marshaling and unmarshaling +// protocol buffers. It may be reused between invocations to +// reduce memory usage. It is not necessary to use a Buffer; +// the global functions Marshal and Unmarshal create a +// temporary Buffer and are fine for most applications. +type Buffer struct { + buf []byte // encode/decode byte stream + index int // write point + + // pools of basic types to amortize allocation. + bools []bool + uint32s []uint32 + uint64s []uint64 + + // extra pools, only used with pointer_reflect.go + int32s []int32 + int64s []int64 + float32s []float32 + float64s []float64 +} + +// NewBuffer allocates a new Buffer and initializes its internal data to +// the contents of the argument slice. +func NewBuffer(e []byte) *Buffer { + return &Buffer{buf: e} +} + +// Reset resets the Buffer, ready for marshaling a new protocol buffer. +func (p *Buffer) Reset() { + p.buf = p.buf[0:0] // for reading/writing + p.index = 0 // for reading +} + +// SetBuf replaces the internal buffer with the slice, +// ready for unmarshaling the contents of the slice. +func (p *Buffer) SetBuf(s []byte) { + p.buf = s + p.index = 0 +} + +// Bytes returns the contents of the Buffer. +func (p *Buffer) Bytes() []byte { return p.buf } + +/* + * Helper routines for simplifying the creation of optional fields of basic type. + */ + +// Bool is a helper routine that allocates a new bool value +// to store v and returns a pointer to it. +func Bool(v bool) *bool { + return &v +} + +// Int32 is a helper routine that allocates a new int32 value +// to store v and returns a pointer to it. +func Int32(v int32) *int32 { + return &v +} + +// Int is a helper routine that allocates a new int32 value +// to store v and returns a pointer to it, but unlike Int32 +// its argument value is an int. +func Int(v int) *int32 { + p := new(int32) + *p = int32(v) + return p +} + +// Int64 is a helper routine that allocates a new int64 value +// to store v and returns a pointer to it. +func Int64(v int64) *int64 { + return &v +} + +// Float32 is a helper routine that allocates a new float32 value +// to store v and returns a pointer to it. +func Float32(v float32) *float32 { + return &v +} + +// Float64 is a helper routine that allocates a new float64 value +// to store v and returns a pointer to it. +func Float64(v float64) *float64 { + return &v +} + +// Uint32 is a helper routine that allocates a new uint32 value +// to store v and returns a pointer to it. +func Uint32(v uint32) *uint32 { + return &v +} + +// Uint64 is a helper routine that allocates a new uint64 value +// to store v and returns a pointer to it. +func Uint64(v uint64) *uint64 { + return &v +} + +// String is a helper routine that allocates a new string value +// to store v and returns a pointer to it. +func String(v string) *string { + return &v +} + +// EnumName is a helper function to simplify printing protocol buffer enums +// by name. Given an enum map and a value, it returns a useful string. +func EnumName(m map[int32]string, v int32) string { + s, ok := m[v] + if ok { + return s + } + return strconv.Itoa(int(v)) +} + +// UnmarshalJSONEnum is a helper function to simplify recovering enum int values +// from their JSON-encoded representation. Given a map from the enum's symbolic +// names to its int values, and a byte buffer containing the JSON-encoded +// value, it returns an int32 that can be cast to the enum type by the caller. +// +// The function can deal with both JSON representations, numeric and symbolic. +func UnmarshalJSONEnum(m map[string]int32, data []byte, enumName string) (int32, error) { + if data[0] == '"' { + // New style: enums are strings. + var repr string + if err := json.Unmarshal(data, &repr); err != nil { + return -1, err + } + val, ok := m[repr] + if !ok { + return 0, fmt.Errorf("unrecognized enum %s value %q", enumName, repr) + } + return val, nil + } + // Old style: enums are ints. + var val int32 + if err := json.Unmarshal(data, &val); err != nil { + return 0, fmt.Errorf("cannot unmarshal %#q into enum %s", data, enumName) + } + return val, nil +} + +// DebugPrint dumps the encoded data in b in a debugging format with a header +// including the string s. Used in testing but made available for general debugging. +func (o *Buffer) DebugPrint(s string, b []byte) { + var u uint64 + + obuf := o.buf + index := o.index + o.buf = b + o.index = 0 + depth := 0 + + fmt.Printf("\n--- %s ---\n", s) + +out: + for { + for i := 0; i < depth; i++ { + fmt.Print(" ") + } + + index := o.index + if index == len(o.buf) { + break + } + + op, err := o.DecodeVarint() + if err != nil { + fmt.Printf("%3d: fetching op err %v\n", index, err) + break out + } + tag := op >> 3 + wire := op & 7 + + switch wire { + default: + fmt.Printf("%3d: t=%3d unknown wire=%d\n", + index, tag, wire) + break out + + case WireBytes: + var r []byte + + r, err = o.DecodeRawBytes(false) + if err != nil { + break out + } + fmt.Printf("%3d: t=%3d bytes [%d]", index, tag, len(r)) + if len(r) <= 6 { + for i := 0; i < len(r); i++ { + fmt.Printf(" %.2x", r[i]) + } + } else { + for i := 0; i < 3; i++ { + fmt.Printf(" %.2x", r[i]) + } + fmt.Printf(" ..") + for i := len(r) - 3; i < len(r); i++ { + fmt.Printf(" %.2x", r[i]) + } + } + fmt.Printf("\n") + + case WireFixed32: + u, err = o.DecodeFixed32() + if err != nil { + fmt.Printf("%3d: t=%3d fix32 err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d fix32 %d\n", index, tag, u) + + case WireFixed64: + u, err = o.DecodeFixed64() + if err != nil { + fmt.Printf("%3d: t=%3d fix64 err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d fix64 %d\n", index, tag, u) + break + + case WireVarint: + u, err = o.DecodeVarint() + if err != nil { + fmt.Printf("%3d: t=%3d varint err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d varint %d\n", index, tag, u) + + case WireStartGroup: + if err != nil { + fmt.Printf("%3d: t=%3d start err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d start\n", index, tag) + depth++ + + case WireEndGroup: + depth-- + if err != nil { + fmt.Printf("%3d: t=%3d end err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d end\n", index, tag) + } + } + + if depth != 0 { + fmt.Printf("%3d: start-end not balanced %d\n", o.index, depth) + } + fmt.Printf("\n") + + o.buf = obuf + o.index = index +} + +// SetDefaults sets unset protocol buffer fields to their default values. +// It only modifies fields that are both unset and have defined defaults. +// It recursively sets default values in any non-nil sub-messages. +func SetDefaults(pb Message) { + setDefaults(reflect.ValueOf(pb), true, false) +} + +// v is a pointer to a struct. +func setDefaults(v reflect.Value, recur, zeros bool) { + v = v.Elem() + + defaultMu.RLock() + dm, ok := defaults[v.Type()] + defaultMu.RUnlock() + if !ok { + dm = buildDefaultMessage(v.Type()) + defaultMu.Lock() + defaults[v.Type()] = dm + defaultMu.Unlock() + } + + for _, sf := range dm.scalars { + f := v.Field(sf.index) + if !f.IsNil() { + // field already set + continue + } + dv := sf.value + if dv == nil && !zeros { + // no explicit default, and don't want to set zeros + continue + } + fptr := f.Addr().Interface() // **T + // TODO: Consider batching the allocations we do here. + switch sf.kind { + case reflect.Bool: + b := new(bool) + if dv != nil { + *b = dv.(bool) + } + *(fptr.(**bool)) = b + case reflect.Float32: + f := new(float32) + if dv != nil { + *f = dv.(float32) + } + *(fptr.(**float32)) = f + case reflect.Float64: + f := new(float64) + if dv != nil { + *f = dv.(float64) + } + *(fptr.(**float64)) = f + case reflect.Int32: + // might be an enum + if ft := f.Type(); ft != int32PtrType { + // enum + f.Set(reflect.New(ft.Elem())) + if dv != nil { + f.Elem().SetInt(int64(dv.(int32))) + } + } else { + // int32 field + i := new(int32) + if dv != nil { + *i = dv.(int32) + } + *(fptr.(**int32)) = i + } + case reflect.Int64: + i := new(int64) + if dv != nil { + *i = dv.(int64) + } + *(fptr.(**int64)) = i + case reflect.String: + s := new(string) + if dv != nil { + *s = dv.(string) + } + *(fptr.(**string)) = s + case reflect.Uint8: + // exceptional case: []byte + var b []byte + if dv != nil { + db := dv.([]byte) + b = make([]byte, len(db)) + copy(b, db) + } else { + b = []byte{} + } + *(fptr.(*[]byte)) = b + case reflect.Uint32: + u := new(uint32) + if dv != nil { + *u = dv.(uint32) + } + *(fptr.(**uint32)) = u + case reflect.Uint64: + u := new(uint64) + if dv != nil { + *u = dv.(uint64) + } + *(fptr.(**uint64)) = u + default: + log.Printf("proto: can't set default for field %v (sf.kind=%v)", f, sf.kind) + } + } + + for _, ni := range dm.nested { + f := v.Field(ni) + // f is *T or []*T or map[T]*T + switch f.Kind() { + case reflect.Ptr: + if f.IsNil() { + continue + } + setDefaults(f, recur, zeros) + + case reflect.Slice: + for i := 0; i < f.Len(); i++ { + e := f.Index(i) + if e.IsNil() { + continue + } + setDefaults(e, recur, zeros) + } + + case reflect.Map: + for _, k := range f.MapKeys() { + e := f.MapIndex(k) + if e.IsNil() { + continue + } + setDefaults(e, recur, zeros) + } + } + } +} + +var ( + // defaults maps a protocol buffer struct type to a slice of the fields, + // with its scalar fields set to their proto-declared non-zero default values. + defaultMu sync.RWMutex + defaults = make(map[reflect.Type]defaultMessage) + + int32PtrType = reflect.TypeOf((*int32)(nil)) +) + +// defaultMessage represents information about the default values of a message. +type defaultMessage struct { + scalars []scalarField + nested []int // struct field index of nested messages +} + +type scalarField struct { + index int // struct field index + kind reflect.Kind // element type (the T in *T or []T) + value interface{} // the proto-declared default value, or nil +} + +// t is a struct type. +func buildDefaultMessage(t reflect.Type) (dm defaultMessage) { + sprop := GetProperties(t) + for _, prop := range sprop.Prop { + fi, ok := sprop.decoderTags.get(prop.Tag) + if !ok { + // XXX_unrecognized + continue + } + ft := t.Field(fi).Type + + var canHaveDefault, nestedMessage bool + switch ft.Kind() { + case reflect.Ptr: + if ft.Elem().Kind() == reflect.Struct { + nestedMessage = true + } else { + canHaveDefault = true // proto2 scalar field + } + + case reflect.Slice: + switch ft.Elem().Kind() { + case reflect.Ptr: + nestedMessage = true // repeated message + case reflect.Uint8: + canHaveDefault = true // bytes field + } + + case reflect.Map: + if ft.Elem().Kind() == reflect.Ptr { + nestedMessage = true // map with message values + } + } + + if !canHaveDefault { + if nestedMessage { + dm.nested = append(dm.nested, fi) + } + continue + } + + sf := scalarField{ + index: fi, + kind: ft.Elem().Kind(), + } + + // scalar fields without defaults + if !prop.HasDefault { + dm.scalars = append(dm.scalars, sf) + continue + } + + // a scalar field: either *T or []byte + switch ft.Elem().Kind() { + case reflect.Bool: + x, err := strconv.ParseBool(prop.Default) + if err != nil { + log.Printf("proto: bad default bool %q: %v", prop.Default, err) + continue + } + sf.value = x + case reflect.Float32: + x, err := strconv.ParseFloat(prop.Default, 32) + if err != nil { + log.Printf("proto: bad default float32 %q: %v", prop.Default, err) + continue + } + sf.value = float32(x) + case reflect.Float64: + x, err := strconv.ParseFloat(prop.Default, 64) + if err != nil { + log.Printf("proto: bad default float64 %q: %v", prop.Default, err) + continue + } + sf.value = x + case reflect.Int32: + x, err := strconv.ParseInt(prop.Default, 10, 32) + if err != nil { + log.Printf("proto: bad default int32 %q: %v", prop.Default, err) + continue + } + sf.value = int32(x) + case reflect.Int64: + x, err := strconv.ParseInt(prop.Default, 10, 64) + if err != nil { + log.Printf("proto: bad default int64 %q: %v", prop.Default, err) + continue + } + sf.value = x + case reflect.String: + sf.value = prop.Default + case reflect.Uint8: + // []byte (not *uint8) + sf.value = []byte(prop.Default) + case reflect.Uint32: + x, err := strconv.ParseUint(prop.Default, 10, 32) + if err != nil { + log.Printf("proto: bad default uint32 %q: %v", prop.Default, err) + continue + } + sf.value = uint32(x) + case reflect.Uint64: + x, err := strconv.ParseUint(prop.Default, 10, 64) + if err != nil { + log.Printf("proto: bad default uint64 %q: %v", prop.Default, err) + continue + } + sf.value = x + default: + log.Printf("proto: unhandled def kind %v", ft.Elem().Kind()) + continue + } + + dm.scalars = append(dm.scalars, sf) + } + + return dm +} + +// Map fields may have key types of non-float scalars, strings and enums. +// The easiest way to sort them in some deterministic order is to use fmt. +// If this turns out to be inefficient we can always consider other options, +// such as doing a Schwartzian transform. + +type mapKeys []reflect.Value + +func (s mapKeys) Len() int { return len(s) } +func (s mapKeys) Swap(i, j int) { s[i], s[j] = s[j], s[i] } +func (s mapKeys) Less(i, j int) bool { + return fmt.Sprint(s[i].Interface()) < fmt.Sprint(s[j].Interface()) +} diff --git a/vendor/src/github.com/golang/protobuf/proto/message_set.go b/vendor/src/github.com/golang/protobuf/proto/message_set.go new file mode 100644 index 0000000000..9d912bce19 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/message_set.go @@ -0,0 +1,287 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Support for message sets. + */ + +import ( + "bytes" + "encoding/json" + "errors" + "fmt" + "reflect" + "sort" +) + +// ErrNoMessageTypeId occurs when a protocol buffer does not have a message type ID. +// A message type ID is required for storing a protocol buffer in a message set. +var ErrNoMessageTypeId = errors.New("proto does not have a message type ID") + +// The first two types (_MessageSet_Item and MessageSet) +// model what the protocol compiler produces for the following protocol message: +// message MessageSet { +// repeated group Item = 1 { +// required int32 type_id = 2; +// required string message = 3; +// }; +// } +// That is the MessageSet wire format. We can't use a proto to generate these +// because that would introduce a circular dependency between it and this package. +// +// When a proto1 proto has a field that looks like: +// optional message info = 3; +// the protocol compiler produces a field in the generated struct that looks like: +// Info *_proto_.MessageSet `protobuf:"bytes,3,opt,name=info"` +// The package is automatically inserted so there is no need for that proto file to +// import this package. + +type _MessageSet_Item struct { + TypeId *int32 `protobuf:"varint,2,req,name=type_id"` + Message []byte `protobuf:"bytes,3,req,name=message"` +} + +type MessageSet struct { + Item []*_MessageSet_Item `protobuf:"group,1,rep"` + XXX_unrecognized []byte + // TODO: caching? +} + +// Make sure MessageSet is a Message. +var _ Message = (*MessageSet)(nil) + +// messageTypeIder is an interface satisfied by a protocol buffer type +// that may be stored in a MessageSet. +type messageTypeIder interface { + MessageTypeId() int32 +} + +func (ms *MessageSet) find(pb Message) *_MessageSet_Item { + mti, ok := pb.(messageTypeIder) + if !ok { + return nil + } + id := mti.MessageTypeId() + for _, item := range ms.Item { + if *item.TypeId == id { + return item + } + } + return nil +} + +func (ms *MessageSet) Has(pb Message) bool { + if ms.find(pb) != nil { + return true + } + return false +} + +func (ms *MessageSet) Unmarshal(pb Message) error { + if item := ms.find(pb); item != nil { + return Unmarshal(item.Message, pb) + } + if _, ok := pb.(messageTypeIder); !ok { + return ErrNoMessageTypeId + } + return nil // TODO: return error instead? +} + +func (ms *MessageSet) Marshal(pb Message) error { + msg, err := Marshal(pb) + if err != nil { + return err + } + if item := ms.find(pb); item != nil { + // reuse existing item + item.Message = msg + return nil + } + + mti, ok := pb.(messageTypeIder) + if !ok { + return ErrNoMessageTypeId + } + + mtid := mti.MessageTypeId() + ms.Item = append(ms.Item, &_MessageSet_Item{ + TypeId: &mtid, + Message: msg, + }) + return nil +} + +func (ms *MessageSet) Reset() { *ms = MessageSet{} } +func (ms *MessageSet) String() string { return CompactTextString(ms) } +func (*MessageSet) ProtoMessage() {} + +// Support for the message_set_wire_format message option. + +func skipVarint(buf []byte) []byte { + i := 0 + for ; buf[i]&0x80 != 0; i++ { + } + return buf[i+1:] +} + +// MarshalMessageSet encodes the extension map represented by m in the message set wire format. +// It is called by generated Marshal methods on protocol buffer messages with the message_set_wire_format option. +func MarshalMessageSet(m map[int32]Extension) ([]byte, error) { + if err := encodeExtensionMap(m); err != nil { + return nil, err + } + + // Sort extension IDs to provide a deterministic encoding. + // See also enc_map in encode.go. + ids := make([]int, 0, len(m)) + for id := range m { + ids = append(ids, int(id)) + } + sort.Ints(ids) + + ms := &MessageSet{Item: make([]*_MessageSet_Item, 0, len(m))} + for _, id := range ids { + e := m[int32(id)] + // Remove the wire type and field number varint, as well as the length varint. + msg := skipVarint(skipVarint(e.enc)) + + ms.Item = append(ms.Item, &_MessageSet_Item{ + TypeId: Int32(int32(id)), + Message: msg, + }) + } + return Marshal(ms) +} + +// UnmarshalMessageSet decodes the extension map encoded in buf in the message set wire format. +// It is called by generated Unmarshal methods on protocol buffer messages with the message_set_wire_format option. +func UnmarshalMessageSet(buf []byte, m map[int32]Extension) error { + ms := new(MessageSet) + if err := Unmarshal(buf, ms); err != nil { + return err + } + for _, item := range ms.Item { + id := *item.TypeId + msg := item.Message + + // Restore wire type and field number varint, plus length varint. + // Be careful to preserve duplicate items. + b := EncodeVarint(uint64(id)<<3 | WireBytes) + if ext, ok := m[id]; ok { + // Existing data; rip off the tag and length varint + // so we join the new data correctly. + // We can assume that ext.enc is set because we are unmarshaling. + o := ext.enc[len(b):] // skip wire type and field number + _, n := DecodeVarint(o) // calculate length of length varint + o = o[n:] // skip length varint + msg = append(o, msg...) // join old data and new data + } + b = append(b, EncodeVarint(uint64(len(msg)))...) + b = append(b, msg...) + + m[id] = Extension{enc: b} + } + return nil +} + +// MarshalMessageSetJSON encodes the extension map represented by m in JSON format. +// It is called by generated MarshalJSON methods on protocol buffer messages with the message_set_wire_format option. +func MarshalMessageSetJSON(m map[int32]Extension) ([]byte, error) { + var b bytes.Buffer + b.WriteByte('{') + + // Process the map in key order for deterministic output. + ids := make([]int32, 0, len(m)) + for id := range m { + ids = append(ids, id) + } + sort.Sort(int32Slice(ids)) // int32Slice defined in text.go + + for i, id := range ids { + ext := m[id] + if i > 0 { + b.WriteByte(',') + } + + msd, ok := messageSetMap[id] + if !ok { + // Unknown type; we can't render it, so skip it. + continue + } + fmt.Fprintf(&b, `"[%s]":`, msd.name) + + x := ext.value + if x == nil { + x = reflect.New(msd.t.Elem()).Interface() + if err := Unmarshal(ext.enc, x.(Message)); err != nil { + return nil, err + } + } + d, err := json.Marshal(x) + if err != nil { + return nil, err + } + b.Write(d) + } + b.WriteByte('}') + return b.Bytes(), nil +} + +// UnmarshalMessageSetJSON decodes the extension map encoded in buf in JSON format. +// It is called by generated UnmarshalJSON methods on protocol buffer messages with the message_set_wire_format option. +func UnmarshalMessageSetJSON(buf []byte, m map[int32]Extension) error { + // Common-case fast path. + if len(buf) == 0 || bytes.Equal(buf, []byte("{}")) { + return nil + } + + // This is fairly tricky, and it's not clear that it is needed. + return errors.New("TODO: UnmarshalMessageSetJSON not yet implemented") +} + +// A global registry of types that can be used in a MessageSet. + +var messageSetMap = make(map[int32]messageSetDesc) + +type messageSetDesc struct { + t reflect.Type // pointer to struct + name string +} + +// RegisterMessageSetType is called from the generated code. +func RegisterMessageSetType(m Message, fieldNum int32, name string) { + messageSetMap[fieldNum] = messageSetDesc{ + t: reflect.TypeOf(m), + name: name, + } +} diff --git a/vendor/src/github.com/golang/protobuf/proto/pointer_reflect.go b/vendor/src/github.com/golang/protobuf/proto/pointer_reflect.go new file mode 100644 index 0000000000..c68b12525c --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/pointer_reflect.go @@ -0,0 +1,479 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2012 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// +build appengine + +// This file contains an implementation of proto field accesses using package reflect. +// It is slower than the code in pointer_unsafe.go but it avoids package unsafe and can +// be used on App Engine. + +package proto + +import ( + "math" + "reflect" +) + +// A structPointer is a pointer to a struct. +type structPointer struct { + v reflect.Value +} + +// toStructPointer returns a structPointer equivalent to the given reflect value. +// The reflect value must itself be a pointer to a struct. +func toStructPointer(v reflect.Value) structPointer { + return structPointer{v} +} + +// IsNil reports whether p is nil. +func structPointer_IsNil(p structPointer) bool { + return p.v.IsNil() +} + +// Interface returns the struct pointer as an interface value. +func structPointer_Interface(p structPointer, _ reflect.Type) interface{} { + return p.v.Interface() +} + +// A field identifies a field in a struct, accessible from a structPointer. +// In this implementation, a field is identified by the sequence of field indices +// passed to reflect's FieldByIndex. +type field []int + +// toField returns a field equivalent to the given reflect field. +func toField(f *reflect.StructField) field { + return f.Index +} + +// invalidField is an invalid field identifier. +var invalidField = field(nil) + +// IsValid reports whether the field identifier is valid. +func (f field) IsValid() bool { return f != nil } + +// field returns the given field in the struct as a reflect value. +func structPointer_field(p structPointer, f field) reflect.Value { + // Special case: an extension map entry with a value of type T + // passes a *T to the struct-handling code with a zero field, + // expecting that it will be treated as equivalent to *struct{ X T }, + // which has the same memory layout. We have to handle that case + // specially, because reflect will panic if we call FieldByIndex on a + // non-struct. + if f == nil { + return p.v.Elem() + } + + return p.v.Elem().FieldByIndex(f) +} + +// ifield returns the given field in the struct as an interface value. +func structPointer_ifield(p structPointer, f field) interface{} { + return structPointer_field(p, f).Addr().Interface() +} + +// Bytes returns the address of a []byte field in the struct. +func structPointer_Bytes(p structPointer, f field) *[]byte { + return structPointer_ifield(p, f).(*[]byte) +} + +// BytesSlice returns the address of a [][]byte field in the struct. +func structPointer_BytesSlice(p structPointer, f field) *[][]byte { + return structPointer_ifield(p, f).(*[][]byte) +} + +// Bool returns the address of a *bool field in the struct. +func structPointer_Bool(p structPointer, f field) **bool { + return structPointer_ifield(p, f).(**bool) +} + +// BoolVal returns the address of a bool field in the struct. +func structPointer_BoolVal(p structPointer, f field) *bool { + return structPointer_ifield(p, f).(*bool) +} + +// BoolSlice returns the address of a []bool field in the struct. +func structPointer_BoolSlice(p structPointer, f field) *[]bool { + return structPointer_ifield(p, f).(*[]bool) +} + +// String returns the address of a *string field in the struct. +func structPointer_String(p structPointer, f field) **string { + return structPointer_ifield(p, f).(**string) +} + +// StringVal returns the address of a string field in the struct. +func structPointer_StringVal(p structPointer, f field) *string { + return structPointer_ifield(p, f).(*string) +} + +// StringSlice returns the address of a []string field in the struct. +func structPointer_StringSlice(p structPointer, f field) *[]string { + return structPointer_ifield(p, f).(*[]string) +} + +// ExtMap returns the address of an extension map field in the struct. +func structPointer_ExtMap(p structPointer, f field) *map[int32]Extension { + return structPointer_ifield(p, f).(*map[int32]Extension) +} + +// Map returns the reflect.Value for the address of a map field in the struct. +func structPointer_Map(p structPointer, f field, typ reflect.Type) reflect.Value { + return structPointer_field(p, f).Addr() +} + +// SetStructPointer writes a *struct field in the struct. +func structPointer_SetStructPointer(p structPointer, f field, q structPointer) { + structPointer_field(p, f).Set(q.v) +} + +// GetStructPointer reads a *struct field in the struct. +func structPointer_GetStructPointer(p structPointer, f field) structPointer { + return structPointer{structPointer_field(p, f)} +} + +// StructPointerSlice the address of a []*struct field in the struct. +func structPointer_StructPointerSlice(p structPointer, f field) structPointerSlice { + return structPointerSlice{structPointer_field(p, f)} +} + +// A structPointerSlice represents the address of a slice of pointers to structs +// (themselves messages or groups). That is, v.Type() is *[]*struct{...}. +type structPointerSlice struct { + v reflect.Value +} + +func (p structPointerSlice) Len() int { return p.v.Len() } +func (p structPointerSlice) Index(i int) structPointer { return structPointer{p.v.Index(i)} } +func (p structPointerSlice) Append(q structPointer) { + p.v.Set(reflect.Append(p.v, q.v)) +} + +var ( + int32Type = reflect.TypeOf(int32(0)) + uint32Type = reflect.TypeOf(uint32(0)) + float32Type = reflect.TypeOf(float32(0)) + int64Type = reflect.TypeOf(int64(0)) + uint64Type = reflect.TypeOf(uint64(0)) + float64Type = reflect.TypeOf(float64(0)) +) + +// A word32 represents a field of type *int32, *uint32, *float32, or *enum. +// That is, v.Type() is *int32, *uint32, *float32, or *enum and v is assignable. +type word32 struct { + v reflect.Value +} + +// IsNil reports whether p is nil. +func word32_IsNil(p word32) bool { + return p.v.IsNil() +} + +// Set sets p to point at a newly allocated word with bits set to x. +func word32_Set(p word32, o *Buffer, x uint32) { + t := p.v.Type().Elem() + switch t { + case int32Type: + if len(o.int32s) == 0 { + o.int32s = make([]int32, uint32PoolSize) + } + o.int32s[0] = int32(x) + p.v.Set(reflect.ValueOf(&o.int32s[0])) + o.int32s = o.int32s[1:] + return + case uint32Type: + if len(o.uint32s) == 0 { + o.uint32s = make([]uint32, uint32PoolSize) + } + o.uint32s[0] = x + p.v.Set(reflect.ValueOf(&o.uint32s[0])) + o.uint32s = o.uint32s[1:] + return + case float32Type: + if len(o.float32s) == 0 { + o.float32s = make([]float32, uint32PoolSize) + } + o.float32s[0] = math.Float32frombits(x) + p.v.Set(reflect.ValueOf(&o.float32s[0])) + o.float32s = o.float32s[1:] + return + } + + // must be enum + p.v.Set(reflect.New(t)) + p.v.Elem().SetInt(int64(int32(x))) +} + +// Get gets the bits pointed at by p, as a uint32. +func word32_Get(p word32) uint32 { + elem := p.v.Elem() + switch elem.Kind() { + case reflect.Int32: + return uint32(elem.Int()) + case reflect.Uint32: + return uint32(elem.Uint()) + case reflect.Float32: + return math.Float32bits(float32(elem.Float())) + } + panic("unreachable") +} + +// Word32 returns a reference to a *int32, *uint32, *float32, or *enum field in the struct. +func structPointer_Word32(p structPointer, f field) word32 { + return word32{structPointer_field(p, f)} +} + +// A word32Val represents a field of type int32, uint32, float32, or enum. +// That is, v.Type() is int32, uint32, float32, or enum and v is assignable. +type word32Val struct { + v reflect.Value +} + +// Set sets *p to x. +func word32Val_Set(p word32Val, x uint32) { + switch p.v.Type() { + case int32Type: + p.v.SetInt(int64(x)) + return + case uint32Type: + p.v.SetUint(uint64(x)) + return + case float32Type: + p.v.SetFloat(float64(math.Float32frombits(x))) + return + } + + // must be enum + p.v.SetInt(int64(int32(x))) +} + +// Get gets the bits pointed at by p, as a uint32. +func word32Val_Get(p word32Val) uint32 { + elem := p.v + switch elem.Kind() { + case reflect.Int32: + return uint32(elem.Int()) + case reflect.Uint32: + return uint32(elem.Uint()) + case reflect.Float32: + return math.Float32bits(float32(elem.Float())) + } + panic("unreachable") +} + +// Word32Val returns a reference to a int32, uint32, float32, or enum field in the struct. +func structPointer_Word32Val(p structPointer, f field) word32Val { + return word32Val{structPointer_field(p, f)} +} + +// A word32Slice is a slice of 32-bit values. +// That is, v.Type() is []int32, []uint32, []float32, or []enum. +type word32Slice struct { + v reflect.Value +} + +func (p word32Slice) Append(x uint32) { + n, m := p.v.Len(), p.v.Cap() + if n < m { + p.v.SetLen(n + 1) + } else { + t := p.v.Type().Elem() + p.v.Set(reflect.Append(p.v, reflect.Zero(t))) + } + elem := p.v.Index(n) + switch elem.Kind() { + case reflect.Int32: + elem.SetInt(int64(int32(x))) + case reflect.Uint32: + elem.SetUint(uint64(x)) + case reflect.Float32: + elem.SetFloat(float64(math.Float32frombits(x))) + } +} + +func (p word32Slice) Len() int { + return p.v.Len() +} + +func (p word32Slice) Index(i int) uint32 { + elem := p.v.Index(i) + switch elem.Kind() { + case reflect.Int32: + return uint32(elem.Int()) + case reflect.Uint32: + return uint32(elem.Uint()) + case reflect.Float32: + return math.Float32bits(float32(elem.Float())) + } + panic("unreachable") +} + +// Word32Slice returns a reference to a []int32, []uint32, []float32, or []enum field in the struct. +func structPointer_Word32Slice(p structPointer, f field) word32Slice { + return word32Slice{structPointer_field(p, f)} +} + +// word64 is like word32 but for 64-bit values. +type word64 struct { + v reflect.Value +} + +func word64_Set(p word64, o *Buffer, x uint64) { + t := p.v.Type().Elem() + switch t { + case int64Type: + if len(o.int64s) == 0 { + o.int64s = make([]int64, uint64PoolSize) + } + o.int64s[0] = int64(x) + p.v.Set(reflect.ValueOf(&o.int64s[0])) + o.int64s = o.int64s[1:] + return + case uint64Type: + if len(o.uint64s) == 0 { + o.uint64s = make([]uint64, uint64PoolSize) + } + o.uint64s[0] = x + p.v.Set(reflect.ValueOf(&o.uint64s[0])) + o.uint64s = o.uint64s[1:] + return + case float64Type: + if len(o.float64s) == 0 { + o.float64s = make([]float64, uint64PoolSize) + } + o.float64s[0] = math.Float64frombits(x) + p.v.Set(reflect.ValueOf(&o.float64s[0])) + o.float64s = o.float64s[1:] + return + } + panic("unreachable") +} + +func word64_IsNil(p word64) bool { + return p.v.IsNil() +} + +func word64_Get(p word64) uint64 { + elem := p.v.Elem() + switch elem.Kind() { + case reflect.Int64: + return uint64(elem.Int()) + case reflect.Uint64: + return elem.Uint() + case reflect.Float64: + return math.Float64bits(elem.Float()) + } + panic("unreachable") +} + +func structPointer_Word64(p structPointer, f field) word64 { + return word64{structPointer_field(p, f)} +} + +// word64Val is like word32Val but for 64-bit values. +type word64Val struct { + v reflect.Value +} + +func word64Val_Set(p word64Val, o *Buffer, x uint64) { + switch p.v.Type() { + case int64Type: + p.v.SetInt(int64(x)) + return + case uint64Type: + p.v.SetUint(x) + return + case float64Type: + p.v.SetFloat(math.Float64frombits(x)) + return + } + panic("unreachable") +} + +func word64Val_Get(p word64Val) uint64 { + elem := p.v + switch elem.Kind() { + case reflect.Int64: + return uint64(elem.Int()) + case reflect.Uint64: + return elem.Uint() + case reflect.Float64: + return math.Float64bits(elem.Float()) + } + panic("unreachable") +} + +func structPointer_Word64Val(p structPointer, f field) word64Val { + return word64Val{structPointer_field(p, f)} +} + +type word64Slice struct { + v reflect.Value +} + +func (p word64Slice) Append(x uint64) { + n, m := p.v.Len(), p.v.Cap() + if n < m { + p.v.SetLen(n + 1) + } else { + t := p.v.Type().Elem() + p.v.Set(reflect.Append(p.v, reflect.Zero(t))) + } + elem := p.v.Index(n) + switch elem.Kind() { + case reflect.Int64: + elem.SetInt(int64(int64(x))) + case reflect.Uint64: + elem.SetUint(uint64(x)) + case reflect.Float64: + elem.SetFloat(float64(math.Float64frombits(x))) + } +} + +func (p word64Slice) Len() int { + return p.v.Len() +} + +func (p word64Slice) Index(i int) uint64 { + elem := p.v.Index(i) + switch elem.Kind() { + case reflect.Int64: + return uint64(elem.Int()) + case reflect.Uint64: + return uint64(elem.Uint()) + case reflect.Float64: + return math.Float64bits(float64(elem.Float())) + } + panic("unreachable") +} + +func structPointer_Word64Slice(p structPointer, f field) word64Slice { + return word64Slice{structPointer_field(p, f)} +} diff --git a/vendor/src/github.com/golang/protobuf/proto/pointer_unsafe.go b/vendor/src/github.com/golang/protobuf/proto/pointer_unsafe.go new file mode 100644 index 0000000000..48bc0fa482 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/pointer_unsafe.go @@ -0,0 +1,266 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2012 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// +build !appengine + +// This file contains the implementation of the proto field accesses using package unsafe. + +package proto + +import ( + "reflect" + "unsafe" +) + +// NOTE: These type_Foo functions would more idiomatically be methods, +// but Go does not allow methods on pointer types, and we must preserve +// some pointer type for the garbage collector. We use these +// funcs with clunky names as our poor approximation to methods. +// +// An alternative would be +// type structPointer struct { p unsafe.Pointer } +// but that does not registerize as well. + +// A structPointer is a pointer to a struct. +type structPointer unsafe.Pointer + +// toStructPointer returns a structPointer equivalent to the given reflect value. +func toStructPointer(v reflect.Value) structPointer { + return structPointer(unsafe.Pointer(v.Pointer())) +} + +// IsNil reports whether p is nil. +func structPointer_IsNil(p structPointer) bool { + return p == nil +} + +// Interface returns the struct pointer, assumed to have element type t, +// as an interface value. +func structPointer_Interface(p structPointer, t reflect.Type) interface{} { + return reflect.NewAt(t, unsafe.Pointer(p)).Interface() +} + +// A field identifies a field in a struct, accessible from a structPointer. +// In this implementation, a field is identified by its byte offset from the start of the struct. +type field uintptr + +// toField returns a field equivalent to the given reflect field. +func toField(f *reflect.StructField) field { + return field(f.Offset) +} + +// invalidField is an invalid field identifier. +const invalidField = ^field(0) + +// IsValid reports whether the field identifier is valid. +func (f field) IsValid() bool { + return f != ^field(0) +} + +// Bytes returns the address of a []byte field in the struct. +func structPointer_Bytes(p structPointer, f field) *[]byte { + return (*[]byte)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// BytesSlice returns the address of a [][]byte field in the struct. +func structPointer_BytesSlice(p structPointer, f field) *[][]byte { + return (*[][]byte)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// Bool returns the address of a *bool field in the struct. +func structPointer_Bool(p structPointer, f field) **bool { + return (**bool)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// BoolVal returns the address of a bool field in the struct. +func structPointer_BoolVal(p structPointer, f field) *bool { + return (*bool)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// BoolSlice returns the address of a []bool field in the struct. +func structPointer_BoolSlice(p structPointer, f field) *[]bool { + return (*[]bool)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// String returns the address of a *string field in the struct. +func structPointer_String(p structPointer, f field) **string { + return (**string)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// StringVal returns the address of a string field in the struct. +func structPointer_StringVal(p structPointer, f field) *string { + return (*string)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// StringSlice returns the address of a []string field in the struct. +func structPointer_StringSlice(p structPointer, f field) *[]string { + return (*[]string)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// ExtMap returns the address of an extension map field in the struct. +func structPointer_ExtMap(p structPointer, f field) *map[int32]Extension { + return (*map[int32]Extension)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// Map returns the reflect.Value for the address of a map field in the struct. +func structPointer_Map(p structPointer, f field, typ reflect.Type) reflect.Value { + return reflect.NewAt(typ, unsafe.Pointer(uintptr(p)+uintptr(f))) +} + +// SetStructPointer writes a *struct field in the struct. +func structPointer_SetStructPointer(p structPointer, f field, q structPointer) { + *(*structPointer)(unsafe.Pointer(uintptr(p) + uintptr(f))) = q +} + +// GetStructPointer reads a *struct field in the struct. +func structPointer_GetStructPointer(p structPointer, f field) structPointer { + return *(*structPointer)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// StructPointerSlice the address of a []*struct field in the struct. +func structPointer_StructPointerSlice(p structPointer, f field) *structPointerSlice { + return (*structPointerSlice)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// A structPointerSlice represents a slice of pointers to structs (themselves submessages or groups). +type structPointerSlice []structPointer + +func (v *structPointerSlice) Len() int { return len(*v) } +func (v *structPointerSlice) Index(i int) structPointer { return (*v)[i] } +func (v *structPointerSlice) Append(p structPointer) { *v = append(*v, p) } + +// A word32 is the address of a "pointer to 32-bit value" field. +type word32 **uint32 + +// IsNil reports whether *v is nil. +func word32_IsNil(p word32) bool { + return *p == nil +} + +// Set sets *v to point at a newly allocated word set to x. +func word32_Set(p word32, o *Buffer, x uint32) { + if len(o.uint32s) == 0 { + o.uint32s = make([]uint32, uint32PoolSize) + } + o.uint32s[0] = x + *p = &o.uint32s[0] + o.uint32s = o.uint32s[1:] +} + +// Get gets the value pointed at by *v. +func word32_Get(p word32) uint32 { + return **p +} + +// Word32 returns the address of a *int32, *uint32, *float32, or *enum field in the struct. +func structPointer_Word32(p structPointer, f field) word32 { + return word32((**uint32)(unsafe.Pointer(uintptr(p) + uintptr(f)))) +} + +// A word32Val is the address of a 32-bit value field. +type word32Val *uint32 + +// Set sets *p to x. +func word32Val_Set(p word32Val, x uint32) { + *p = x +} + +// Get gets the value pointed at by p. +func word32Val_Get(p word32Val) uint32 { + return *p +} + +// Word32Val returns the address of a *int32, *uint32, *float32, or *enum field in the struct. +func structPointer_Word32Val(p structPointer, f field) word32Val { + return word32Val((*uint32)(unsafe.Pointer(uintptr(p) + uintptr(f)))) +} + +// A word32Slice is a slice of 32-bit values. +type word32Slice []uint32 + +func (v *word32Slice) Append(x uint32) { *v = append(*v, x) } +func (v *word32Slice) Len() int { return len(*v) } +func (v *word32Slice) Index(i int) uint32 { return (*v)[i] } + +// Word32Slice returns the address of a []int32, []uint32, []float32, or []enum field in the struct. +func structPointer_Word32Slice(p structPointer, f field) *word32Slice { + return (*word32Slice)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} + +// word64 is like word32 but for 64-bit values. +type word64 **uint64 + +func word64_Set(p word64, o *Buffer, x uint64) { + if len(o.uint64s) == 0 { + o.uint64s = make([]uint64, uint64PoolSize) + } + o.uint64s[0] = x + *p = &o.uint64s[0] + o.uint64s = o.uint64s[1:] +} + +func word64_IsNil(p word64) bool { + return *p == nil +} + +func word64_Get(p word64) uint64 { + return **p +} + +func structPointer_Word64(p structPointer, f field) word64 { + return word64((**uint64)(unsafe.Pointer(uintptr(p) + uintptr(f)))) +} + +// word64Val is like word32Val but for 64-bit values. +type word64Val *uint64 + +func word64Val_Set(p word64Val, o *Buffer, x uint64) { + *p = x +} + +func word64Val_Get(p word64Val) uint64 { + return *p +} + +func structPointer_Word64Val(p structPointer, f field) word64Val { + return word64Val((*uint64)(unsafe.Pointer(uintptr(p) + uintptr(f)))) +} + +// word64Slice is like word32Slice but for 64-bit values. +type word64Slice []uint64 + +func (v *word64Slice) Append(x uint64) { *v = append(*v, x) } +func (v *word64Slice) Len() int { return len(*v) } +func (v *word64Slice) Index(i int) uint64 { return (*v)[i] } + +func structPointer_Word64Slice(p structPointer, f field) *word64Slice { + return (*word64Slice)(unsafe.Pointer(uintptr(p) + uintptr(f))) +} diff --git a/vendor/src/github.com/golang/protobuf/proto/properties.go b/vendor/src/github.com/golang/protobuf/proto/properties.go new file mode 100644 index 0000000000..d74844ab2a --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/properties.go @@ -0,0 +1,742 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Routines for encoding data into the wire format for protocol buffers. + */ + +import ( + "fmt" + "os" + "reflect" + "sort" + "strconv" + "strings" + "sync" +) + +const debug bool = false + +// Constants that identify the encoding of a value on the wire. +const ( + WireVarint = 0 + WireFixed64 = 1 + WireBytes = 2 + WireStartGroup = 3 + WireEndGroup = 4 + WireFixed32 = 5 +) + +const startSize = 10 // initial slice/string sizes + +// Encoders are defined in encode.go +// An encoder outputs the full representation of a field, including its +// tag and encoder type. +type encoder func(p *Buffer, prop *Properties, base structPointer) error + +// A valueEncoder encodes a single integer in a particular encoding. +type valueEncoder func(o *Buffer, x uint64) error + +// Sizers are defined in encode.go +// A sizer returns the encoded size of a field, including its tag and encoder +// type. +type sizer func(prop *Properties, base structPointer) int + +// A valueSizer returns the encoded size of a single integer in a particular +// encoding. +type valueSizer func(x uint64) int + +// Decoders are defined in decode.go +// A decoder creates a value from its wire representation. +// Unrecognized subelements are saved in unrec. +type decoder func(p *Buffer, prop *Properties, base structPointer) error + +// A valueDecoder decodes a single integer in a particular encoding. +type valueDecoder func(o *Buffer) (x uint64, err error) + +// tagMap is an optimization over map[int]int for typical protocol buffer +// use-cases. Encoded protocol buffers are often in tag order with small tag +// numbers. +type tagMap struct { + fastTags []int + slowTags map[int]int +} + +// tagMapFastLimit is the upper bound on the tag number that will be stored in +// the tagMap slice rather than its map. +const tagMapFastLimit = 1024 + +func (p *tagMap) get(t int) (int, bool) { + if t > 0 && t < tagMapFastLimit { + if t >= len(p.fastTags) { + return 0, false + } + fi := p.fastTags[t] + return fi, fi >= 0 + } + fi, ok := p.slowTags[t] + return fi, ok +} + +func (p *tagMap) put(t int, fi int) { + if t > 0 && t < tagMapFastLimit { + for len(p.fastTags) < t+1 { + p.fastTags = append(p.fastTags, -1) + } + p.fastTags[t] = fi + return + } + if p.slowTags == nil { + p.slowTags = make(map[int]int) + } + p.slowTags[t] = fi +} + +// StructProperties represents properties for all the fields of a struct. +// decoderTags and decoderOrigNames should only be used by the decoder. +type StructProperties struct { + Prop []*Properties // properties for each field + reqCount int // required count + decoderTags tagMap // map from proto tag to struct field number + decoderOrigNames map[string]int // map from original name to struct field number + order []int // list of struct field numbers in tag order + unrecField field // field id of the XXX_unrecognized []byte field + extendable bool // is this an extendable proto +} + +// Implement the sorting interface so we can sort the fields in tag order, as recommended by the spec. +// See encode.go, (*Buffer).enc_struct. + +func (sp *StructProperties) Len() int { return len(sp.order) } +func (sp *StructProperties) Less(i, j int) bool { + return sp.Prop[sp.order[i]].Tag < sp.Prop[sp.order[j]].Tag +} +func (sp *StructProperties) Swap(i, j int) { sp.order[i], sp.order[j] = sp.order[j], sp.order[i] } + +// Properties represents the protocol-specific behavior of a single struct field. +type Properties struct { + Name string // name of the field, for error messages + OrigName string // original name before protocol compiler (always set) + Wire string + WireType int + Tag int + Required bool + Optional bool + Repeated bool + Packed bool // relevant for repeated primitives only + Enum string // set for enum types only + proto3 bool // whether this is known to be a proto3 field; set for []byte only + + Default string // default value + HasDefault bool // whether an explicit default was provided + def_uint64 uint64 + + enc encoder + valEnc valueEncoder // set for bool and numeric types only + field field + tagcode []byte // encoding of EncodeVarint((Tag<<3)|WireType) + tagbuf [8]byte + stype reflect.Type // set for struct types only + sprop *StructProperties // set for struct types only + isMarshaler bool + isUnmarshaler bool + + mtype reflect.Type // set for map types only + mkeyprop *Properties // set for map types only + mvalprop *Properties // set for map types only + + size sizer + valSize valueSizer // set for bool and numeric types only + + dec decoder + valDec valueDecoder // set for bool and numeric types only + + // If this is a packable field, this will be the decoder for the packed version of the field. + packedDec decoder +} + +// String formats the properties in the protobuf struct field tag style. +func (p *Properties) String() string { + s := p.Wire + s = "," + s += strconv.Itoa(p.Tag) + if p.Required { + s += ",req" + } + if p.Optional { + s += ",opt" + } + if p.Repeated { + s += ",rep" + } + if p.Packed { + s += ",packed" + } + if p.OrigName != p.Name { + s += ",name=" + p.OrigName + } + if p.proto3 { + s += ",proto3" + } + if len(p.Enum) > 0 { + s += ",enum=" + p.Enum + } + if p.HasDefault { + s += ",def=" + p.Default + } + return s +} + +// Parse populates p by parsing a string in the protobuf struct field tag style. +func (p *Properties) Parse(s string) { + // "bytes,49,opt,name=foo,def=hello!" + fields := strings.Split(s, ",") // breaks def=, but handled below. + if len(fields) < 2 { + fmt.Fprintf(os.Stderr, "proto: tag has too few fields: %q\n", s) + return + } + + p.Wire = fields[0] + switch p.Wire { + case "varint": + p.WireType = WireVarint + p.valEnc = (*Buffer).EncodeVarint + p.valDec = (*Buffer).DecodeVarint + p.valSize = sizeVarint + case "fixed32": + p.WireType = WireFixed32 + p.valEnc = (*Buffer).EncodeFixed32 + p.valDec = (*Buffer).DecodeFixed32 + p.valSize = sizeFixed32 + case "fixed64": + p.WireType = WireFixed64 + p.valEnc = (*Buffer).EncodeFixed64 + p.valDec = (*Buffer).DecodeFixed64 + p.valSize = sizeFixed64 + case "zigzag32": + p.WireType = WireVarint + p.valEnc = (*Buffer).EncodeZigzag32 + p.valDec = (*Buffer).DecodeZigzag32 + p.valSize = sizeZigzag32 + case "zigzag64": + p.WireType = WireVarint + p.valEnc = (*Buffer).EncodeZigzag64 + p.valDec = (*Buffer).DecodeZigzag64 + p.valSize = sizeZigzag64 + case "bytes", "group": + p.WireType = WireBytes + // no numeric converter for non-numeric types + default: + fmt.Fprintf(os.Stderr, "proto: tag has unknown wire type: %q\n", s) + return + } + + var err error + p.Tag, err = strconv.Atoi(fields[1]) + if err != nil { + return + } + + for i := 2; i < len(fields); i++ { + f := fields[i] + switch { + case f == "req": + p.Required = true + case f == "opt": + p.Optional = true + case f == "rep": + p.Repeated = true + case f == "packed": + p.Packed = true + case strings.HasPrefix(f, "name="): + p.OrigName = f[5:] + case strings.HasPrefix(f, "enum="): + p.Enum = f[5:] + case f == "proto3": + p.proto3 = true + case strings.HasPrefix(f, "def="): + p.HasDefault = true + p.Default = f[4:] // rest of string + if i+1 < len(fields) { + // Commas aren't escaped, and def is always last. + p.Default += "," + strings.Join(fields[i+1:], ",") + break + } + } + } +} + +func logNoSliceEnc(t1, t2 reflect.Type) { + fmt.Fprintf(os.Stderr, "proto: no slice oenc for %T = []%T\n", t1, t2) +} + +var protoMessageType = reflect.TypeOf((*Message)(nil)).Elem() + +// Initialize the fields for encoding and decoding. +func (p *Properties) setEncAndDec(typ reflect.Type, f *reflect.StructField, lockGetProp bool) { + p.enc = nil + p.dec = nil + p.size = nil + + switch t1 := typ; t1.Kind() { + default: + fmt.Fprintf(os.Stderr, "proto: no coders for %v\n", t1) + + // proto3 scalar types + + case reflect.Bool: + p.enc = (*Buffer).enc_proto3_bool + p.dec = (*Buffer).dec_proto3_bool + p.size = size_proto3_bool + case reflect.Int32: + p.enc = (*Buffer).enc_proto3_int32 + p.dec = (*Buffer).dec_proto3_int32 + p.size = size_proto3_int32 + case reflect.Uint32: + p.enc = (*Buffer).enc_proto3_uint32 + p.dec = (*Buffer).dec_proto3_int32 // can reuse + p.size = size_proto3_uint32 + case reflect.Int64, reflect.Uint64: + p.enc = (*Buffer).enc_proto3_int64 + p.dec = (*Buffer).dec_proto3_int64 + p.size = size_proto3_int64 + case reflect.Float32: + p.enc = (*Buffer).enc_proto3_uint32 // can just treat them as bits + p.dec = (*Buffer).dec_proto3_int32 + p.size = size_proto3_uint32 + case reflect.Float64: + p.enc = (*Buffer).enc_proto3_int64 // can just treat them as bits + p.dec = (*Buffer).dec_proto3_int64 + p.size = size_proto3_int64 + case reflect.String: + p.enc = (*Buffer).enc_proto3_string + p.dec = (*Buffer).dec_proto3_string + p.size = size_proto3_string + + case reflect.Ptr: + switch t2 := t1.Elem(); t2.Kind() { + default: + fmt.Fprintf(os.Stderr, "proto: no encoder function for %v -> %v\n", t1, t2) + break + case reflect.Bool: + p.enc = (*Buffer).enc_bool + p.dec = (*Buffer).dec_bool + p.size = size_bool + case reflect.Int32: + p.enc = (*Buffer).enc_int32 + p.dec = (*Buffer).dec_int32 + p.size = size_int32 + case reflect.Uint32: + p.enc = (*Buffer).enc_uint32 + p.dec = (*Buffer).dec_int32 // can reuse + p.size = size_uint32 + case reflect.Int64, reflect.Uint64: + p.enc = (*Buffer).enc_int64 + p.dec = (*Buffer).dec_int64 + p.size = size_int64 + case reflect.Float32: + p.enc = (*Buffer).enc_uint32 // can just treat them as bits + p.dec = (*Buffer).dec_int32 + p.size = size_uint32 + case reflect.Float64: + p.enc = (*Buffer).enc_int64 // can just treat them as bits + p.dec = (*Buffer).dec_int64 + p.size = size_int64 + case reflect.String: + p.enc = (*Buffer).enc_string + p.dec = (*Buffer).dec_string + p.size = size_string + case reflect.Struct: + p.stype = t1.Elem() + p.isMarshaler = isMarshaler(t1) + p.isUnmarshaler = isUnmarshaler(t1) + if p.Wire == "bytes" { + p.enc = (*Buffer).enc_struct_message + p.dec = (*Buffer).dec_struct_message + p.size = size_struct_message + } else { + p.enc = (*Buffer).enc_struct_group + p.dec = (*Buffer).dec_struct_group + p.size = size_struct_group + } + } + + case reflect.Slice: + switch t2 := t1.Elem(); t2.Kind() { + default: + logNoSliceEnc(t1, t2) + break + case reflect.Bool: + if p.Packed { + p.enc = (*Buffer).enc_slice_packed_bool + p.size = size_slice_packed_bool + } else { + p.enc = (*Buffer).enc_slice_bool + p.size = size_slice_bool + } + p.dec = (*Buffer).dec_slice_bool + p.packedDec = (*Buffer).dec_slice_packed_bool + case reflect.Int32: + if p.Packed { + p.enc = (*Buffer).enc_slice_packed_int32 + p.size = size_slice_packed_int32 + } else { + p.enc = (*Buffer).enc_slice_int32 + p.size = size_slice_int32 + } + p.dec = (*Buffer).dec_slice_int32 + p.packedDec = (*Buffer).dec_slice_packed_int32 + case reflect.Uint32: + if p.Packed { + p.enc = (*Buffer).enc_slice_packed_uint32 + p.size = size_slice_packed_uint32 + } else { + p.enc = (*Buffer).enc_slice_uint32 + p.size = size_slice_uint32 + } + p.dec = (*Buffer).dec_slice_int32 + p.packedDec = (*Buffer).dec_slice_packed_int32 + case reflect.Int64, reflect.Uint64: + if p.Packed { + p.enc = (*Buffer).enc_slice_packed_int64 + p.size = size_slice_packed_int64 + } else { + p.enc = (*Buffer).enc_slice_int64 + p.size = size_slice_int64 + } + p.dec = (*Buffer).dec_slice_int64 + p.packedDec = (*Buffer).dec_slice_packed_int64 + case reflect.Uint8: + p.enc = (*Buffer).enc_slice_byte + p.dec = (*Buffer).dec_slice_byte + p.size = size_slice_byte + // This is a []byte, which is either a bytes field, + // or the value of a map field. In the latter case, + // we always encode an empty []byte, so we should not + // use the proto3 enc/size funcs. + // f == nil iff this is the key/value of a map field. + if p.proto3 && f != nil { + p.enc = (*Buffer).enc_proto3_slice_byte + p.size = size_proto3_slice_byte + } + case reflect.Float32, reflect.Float64: + switch t2.Bits() { + case 32: + // can just treat them as bits + if p.Packed { + p.enc = (*Buffer).enc_slice_packed_uint32 + p.size = size_slice_packed_uint32 + } else { + p.enc = (*Buffer).enc_slice_uint32 + p.size = size_slice_uint32 + } + p.dec = (*Buffer).dec_slice_int32 + p.packedDec = (*Buffer).dec_slice_packed_int32 + case 64: + // can just treat them as bits + if p.Packed { + p.enc = (*Buffer).enc_slice_packed_int64 + p.size = size_slice_packed_int64 + } else { + p.enc = (*Buffer).enc_slice_int64 + p.size = size_slice_int64 + } + p.dec = (*Buffer).dec_slice_int64 + p.packedDec = (*Buffer).dec_slice_packed_int64 + default: + logNoSliceEnc(t1, t2) + break + } + case reflect.String: + p.enc = (*Buffer).enc_slice_string + p.dec = (*Buffer).dec_slice_string + p.size = size_slice_string + case reflect.Ptr: + switch t3 := t2.Elem(); t3.Kind() { + default: + fmt.Fprintf(os.Stderr, "proto: no ptr oenc for %T -> %T -> %T\n", t1, t2, t3) + break + case reflect.Struct: + p.stype = t2.Elem() + p.isMarshaler = isMarshaler(t2) + p.isUnmarshaler = isUnmarshaler(t2) + if p.Wire == "bytes" { + p.enc = (*Buffer).enc_slice_struct_message + p.dec = (*Buffer).dec_slice_struct_message + p.size = size_slice_struct_message + } else { + p.enc = (*Buffer).enc_slice_struct_group + p.dec = (*Buffer).dec_slice_struct_group + p.size = size_slice_struct_group + } + } + case reflect.Slice: + switch t2.Elem().Kind() { + default: + fmt.Fprintf(os.Stderr, "proto: no slice elem oenc for %T -> %T -> %T\n", t1, t2, t2.Elem()) + break + case reflect.Uint8: + p.enc = (*Buffer).enc_slice_slice_byte + p.dec = (*Buffer).dec_slice_slice_byte + p.size = size_slice_slice_byte + } + } + + case reflect.Map: + p.enc = (*Buffer).enc_new_map + p.dec = (*Buffer).dec_new_map + p.size = size_new_map + + p.mtype = t1 + p.mkeyprop = &Properties{} + p.mkeyprop.init(reflect.PtrTo(p.mtype.Key()), "Key", f.Tag.Get("protobuf_key"), nil, lockGetProp) + p.mvalprop = &Properties{} + vtype := p.mtype.Elem() + if vtype.Kind() != reflect.Ptr && vtype.Kind() != reflect.Slice { + // The value type is not a message (*T) or bytes ([]byte), + // so we need encoders for the pointer to this type. + vtype = reflect.PtrTo(vtype) + } + p.mvalprop.init(vtype, "Value", f.Tag.Get("protobuf_val"), nil, lockGetProp) + } + + // precalculate tag code + wire := p.WireType + if p.Packed { + wire = WireBytes + } + x := uint32(p.Tag)<<3 | uint32(wire) + i := 0 + for i = 0; x > 127; i++ { + p.tagbuf[i] = 0x80 | uint8(x&0x7F) + x >>= 7 + } + p.tagbuf[i] = uint8(x) + p.tagcode = p.tagbuf[0 : i+1] + + if p.stype != nil { + if lockGetProp { + p.sprop = GetProperties(p.stype) + } else { + p.sprop = getPropertiesLocked(p.stype) + } + } +} + +var ( + marshalerType = reflect.TypeOf((*Marshaler)(nil)).Elem() + unmarshalerType = reflect.TypeOf((*Unmarshaler)(nil)).Elem() +) + +// isMarshaler reports whether type t implements Marshaler. +func isMarshaler(t reflect.Type) bool { + // We're checking for (likely) pointer-receiver methods + // so if t is not a pointer, something is very wrong. + // The calls above only invoke isMarshaler on pointer types. + if t.Kind() != reflect.Ptr { + panic("proto: misuse of isMarshaler") + } + return t.Implements(marshalerType) +} + +// isUnmarshaler reports whether type t implements Unmarshaler. +func isUnmarshaler(t reflect.Type) bool { + // We're checking for (likely) pointer-receiver methods + // so if t is not a pointer, something is very wrong. + // The calls above only invoke isUnmarshaler on pointer types. + if t.Kind() != reflect.Ptr { + panic("proto: misuse of isUnmarshaler") + } + return t.Implements(unmarshalerType) +} + +// Init populates the properties from a protocol buffer struct tag. +func (p *Properties) Init(typ reflect.Type, name, tag string, f *reflect.StructField) { + p.init(typ, name, tag, f, true) +} + +func (p *Properties) init(typ reflect.Type, name, tag string, f *reflect.StructField, lockGetProp bool) { + // "bytes,49,opt,def=hello!" + p.Name = name + p.OrigName = name + if f != nil { + p.field = toField(f) + } + if tag == "" { + return + } + p.Parse(tag) + p.setEncAndDec(typ, f, lockGetProp) +} + +var ( + propertiesMu sync.RWMutex + propertiesMap = make(map[reflect.Type]*StructProperties) +) + +// GetProperties returns the list of properties for the type represented by t. +// t must represent a generated struct type of a protocol message. +func GetProperties(t reflect.Type) *StructProperties { + if t.Kind() != reflect.Struct { + panic("proto: type must have kind struct") + } + + // Most calls to GetProperties in a long-running program will be + // retrieving details for types we have seen before. + propertiesMu.RLock() + sprop, ok := propertiesMap[t] + propertiesMu.RUnlock() + if ok { + if collectStats { + stats.Chit++ + } + return sprop + } + + propertiesMu.Lock() + sprop = getPropertiesLocked(t) + propertiesMu.Unlock() + return sprop +} + +// getPropertiesLocked requires that propertiesMu is held. +func getPropertiesLocked(t reflect.Type) *StructProperties { + if prop, ok := propertiesMap[t]; ok { + if collectStats { + stats.Chit++ + } + return prop + } + if collectStats { + stats.Cmiss++ + } + + prop := new(StructProperties) + // in case of recursive protos, fill this in now. + propertiesMap[t] = prop + + // build properties + prop.extendable = reflect.PtrTo(t).Implements(extendableProtoType) + prop.unrecField = invalidField + prop.Prop = make([]*Properties, t.NumField()) + prop.order = make([]int, t.NumField()) + + for i := 0; i < t.NumField(); i++ { + f := t.Field(i) + p := new(Properties) + name := f.Name + p.init(f.Type, name, f.Tag.Get("protobuf"), &f, false) + + if f.Name == "XXX_extensions" { // special case + p.enc = (*Buffer).enc_map + p.dec = nil // not needed + p.size = size_map + } + if f.Name == "XXX_unrecognized" { // special case + prop.unrecField = toField(&f) + } + prop.Prop[i] = p + prop.order[i] = i + if debug { + print(i, " ", f.Name, " ", t.String(), " ") + if p.Tag > 0 { + print(p.String()) + } + print("\n") + } + if p.enc == nil && !strings.HasPrefix(f.Name, "XXX_") { + fmt.Fprintln(os.Stderr, "proto: no encoder for", f.Name, f.Type.String(), "[GetProperties]") + } + } + + // Re-order prop.order. + sort.Sort(prop) + + // build required counts + // build tags + reqCount := 0 + prop.decoderOrigNames = make(map[string]int) + for i, p := range prop.Prop { + if strings.HasPrefix(p.Name, "XXX_") { + // Internal fields should not appear in tags/origNames maps. + // They are handled specially when encoding and decoding. + continue + } + if p.Required { + reqCount++ + } + prop.decoderTags.put(p.Tag, i) + prop.decoderOrigNames[p.OrigName] = i + } + prop.reqCount = reqCount + + return prop +} + +// Return the Properties object for the x[0]'th field of the structure. +func propByIndex(t reflect.Type, x []int) *Properties { + if len(x) != 1 { + fmt.Fprintf(os.Stderr, "proto: field index dimension %d (not 1) for type %s\n", len(x), t) + return nil + } + prop := GetProperties(t) + return prop.Prop[x[0]] +} + +// Get the address and type of a pointer to a struct from an interface. +func getbase(pb Message) (t reflect.Type, b structPointer, err error) { + if pb == nil { + err = ErrNil + return + } + // get the reflect type of the pointer to the struct. + t = reflect.TypeOf(pb) + // get the address of the struct. + value := reflect.ValueOf(pb) + b = toStructPointer(value) + return +} + +// A global registry of enum types. +// The generated code will register the generated maps by calling RegisterEnum. + +var enumValueMaps = make(map[string]map[string]int32) + +// RegisterEnum is called from the generated code to install the enum descriptor +// maps into the global table to aid parsing text format protocol buffers. +func RegisterEnum(typeName string, unusedNameMap map[int32]string, valueMap map[string]int32) { + if _, ok := enumValueMaps[typeName]; ok { + panic("proto: duplicate enum registered: " + typeName) + } + enumValueMaps[typeName] = valueMap +} diff --git a/vendor/src/github.com/golang/protobuf/proto/text.go b/vendor/src/github.com/golang/protobuf/proto/text.go new file mode 100644 index 0000000000..720eac4705 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/text.go @@ -0,0 +1,789 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +// Functions for writing the text protocol buffer format. + +import ( + "bufio" + "bytes" + "encoding" + "fmt" + "io" + "log" + "math" + "os" + "reflect" + "sort" + "strings" +) + +var ( + newline = []byte("\n") + spaces = []byte(" ") + gtNewline = []byte(">\n") + endBraceNewline = []byte("}\n") + backslashN = []byte{'\\', 'n'} + backslashR = []byte{'\\', 'r'} + backslashT = []byte{'\\', 't'} + backslashDQ = []byte{'\\', '"'} + backslashBS = []byte{'\\', '\\'} + posInf = []byte("inf") + negInf = []byte("-inf") + nan = []byte("nan") +) + +type writer interface { + io.Writer + WriteByte(byte) error +} + +// textWriter is an io.Writer that tracks its indentation level. +type textWriter struct { + ind int + complete bool // if the current position is a complete line + compact bool // whether to write out as a one-liner + w writer +} + +func (w *textWriter) WriteString(s string) (n int, err error) { + if !strings.Contains(s, "\n") { + if !w.compact && w.complete { + w.writeIndent() + } + w.complete = false + return io.WriteString(w.w, s) + } + // WriteString is typically called without newlines, so this + // codepath and its copy are rare. We copy to avoid + // duplicating all of Write's logic here. + return w.Write([]byte(s)) +} + +func (w *textWriter) Write(p []byte) (n int, err error) { + newlines := bytes.Count(p, newline) + if newlines == 0 { + if !w.compact && w.complete { + w.writeIndent() + } + n, err = w.w.Write(p) + w.complete = false + return n, err + } + + frags := bytes.SplitN(p, newline, newlines+1) + if w.compact { + for i, frag := range frags { + if i > 0 { + if err := w.w.WriteByte(' '); err != nil { + return n, err + } + n++ + } + nn, err := w.w.Write(frag) + n += nn + if err != nil { + return n, err + } + } + return n, nil + } + + for i, frag := range frags { + if w.complete { + w.writeIndent() + } + nn, err := w.w.Write(frag) + n += nn + if err != nil { + return n, err + } + if i+1 < len(frags) { + if err := w.w.WriteByte('\n'); err != nil { + return n, err + } + n++ + } + } + w.complete = len(frags[len(frags)-1]) == 0 + return n, nil +} + +func (w *textWriter) WriteByte(c byte) error { + if w.compact && c == '\n' { + c = ' ' + } + if !w.compact && w.complete { + w.writeIndent() + } + err := w.w.WriteByte(c) + w.complete = c == '\n' + return err +} + +func (w *textWriter) indent() { w.ind++ } + +func (w *textWriter) unindent() { + if w.ind == 0 { + log.Printf("proto: textWriter unindented too far") + return + } + w.ind-- +} + +func writeName(w *textWriter, props *Properties) error { + if _, err := w.WriteString(props.OrigName); err != nil { + return err + } + if props.Wire != "group" { + return w.WriteByte(':') + } + return nil +} + +var ( + messageSetType = reflect.TypeOf((*MessageSet)(nil)).Elem() +) + +// raw is the interface satisfied by RawMessage. +type raw interface { + Bytes() []byte +} + +func writeStruct(w *textWriter, sv reflect.Value) error { + if sv.Type() == messageSetType { + return writeMessageSet(w, sv.Addr().Interface().(*MessageSet)) + } + + st := sv.Type() + sprops := GetProperties(st) + for i := 0; i < sv.NumField(); i++ { + fv := sv.Field(i) + props := sprops.Prop[i] + name := st.Field(i).Name + + if strings.HasPrefix(name, "XXX_") { + // There are two XXX_ fields: + // XXX_unrecognized []byte + // XXX_extensions map[int32]proto.Extension + // The first is handled here; + // the second is handled at the bottom of this function. + if name == "XXX_unrecognized" && !fv.IsNil() { + if err := writeUnknownStruct(w, fv.Interface().([]byte)); err != nil { + return err + } + } + continue + } + if fv.Kind() == reflect.Ptr && fv.IsNil() { + // Field not filled in. This could be an optional field or + // a required field that wasn't filled in. Either way, there + // isn't anything we can show for it. + continue + } + if fv.Kind() == reflect.Slice && fv.IsNil() { + // Repeated field that is empty, or a bytes field that is unused. + continue + } + + if props.Repeated && fv.Kind() == reflect.Slice { + // Repeated field. + for j := 0; j < fv.Len(); j++ { + if err := writeName(w, props); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + v := fv.Index(j) + if v.Kind() == reflect.Ptr && v.IsNil() { + // A nil message in a repeated field is not valid, + // but we can handle that more gracefully than panicking. + if _, err := w.Write([]byte("\n")); err != nil { + return err + } + continue + } + if err := writeAny(w, v, props); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + } + continue + } + if fv.Kind() == reflect.Map { + // Map fields are rendered as a repeated struct with key/value fields. + keys := fv.MapKeys() // TODO: should we sort these for deterministic output? + sort.Sort(mapKeys(keys)) + for _, key := range keys { + val := fv.MapIndex(key) + if err := writeName(w, props); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + // open struct + if err := w.WriteByte('<'); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte('\n'); err != nil { + return err + } + } + w.indent() + // key + if _, err := w.WriteString("key:"); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if err := writeAny(w, key, props.mkeyprop); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + // value + if _, err := w.WriteString("value:"); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if err := writeAny(w, val, props.mvalprop); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + // close struct + w.unindent() + if err := w.WriteByte('>'); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + } + continue + } + if props.proto3 && fv.Kind() == reflect.Slice && fv.Len() == 0 { + // empty bytes field + continue + } + if fv.Kind() != reflect.Ptr && fv.Kind() != reflect.Slice { + // proto3 non-repeated scalar field; skip if zero value + switch fv.Kind() { + case reflect.Bool: + if !fv.Bool() { + continue + } + case reflect.Int32, reflect.Int64: + if fv.Int() == 0 { + continue + } + case reflect.Uint32, reflect.Uint64: + if fv.Uint() == 0 { + continue + } + case reflect.Float32, reflect.Float64: + if fv.Float() == 0 { + continue + } + case reflect.String: + if fv.String() == "" { + continue + } + } + } + + if err := writeName(w, props); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if b, ok := fv.Interface().(raw); ok { + if err := writeRaw(w, b.Bytes()); err != nil { + return err + } + continue + } + + // Enums have a String method, so writeAny will work fine. + if err := writeAny(w, fv, props); err != nil { + return err + } + + if err := w.WriteByte('\n'); err != nil { + return err + } + } + + // Extensions (the XXX_extensions field). + pv := sv.Addr() + if pv.Type().Implements(extendableProtoType) { + if err := writeExtensions(w, pv); err != nil { + return err + } + } + + return nil +} + +// writeRaw writes an uninterpreted raw message. +func writeRaw(w *textWriter, b []byte) error { + if err := w.WriteByte('<'); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte('\n'); err != nil { + return err + } + } + w.indent() + if err := writeUnknownStruct(w, b); err != nil { + return err + } + w.unindent() + if err := w.WriteByte('>'); err != nil { + return err + } + return nil +} + +// writeAny writes an arbitrary field. +func writeAny(w *textWriter, v reflect.Value, props *Properties) error { + v = reflect.Indirect(v) + + // Floats have special cases. + if v.Kind() == reflect.Float32 || v.Kind() == reflect.Float64 { + x := v.Float() + var b []byte + switch { + case math.IsInf(x, 1): + b = posInf + case math.IsInf(x, -1): + b = negInf + case math.IsNaN(x): + b = nan + } + if b != nil { + _, err := w.Write(b) + return err + } + // Other values are handled below. + } + + // We don't attempt to serialise every possible value type; only those + // that can occur in protocol buffers. + switch v.Kind() { + case reflect.Slice: + // Should only be a []byte; repeated fields are handled in writeStruct. + if err := writeString(w, string(v.Interface().([]byte))); err != nil { + return err + } + case reflect.String: + if err := writeString(w, v.String()); err != nil { + return err + } + case reflect.Struct: + // Required/optional group/message. + var bra, ket byte = '<', '>' + if props != nil && props.Wire == "group" { + bra, ket = '{', '}' + } + if err := w.WriteByte(bra); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte('\n'); err != nil { + return err + } + } + w.indent() + if tm, ok := v.Interface().(encoding.TextMarshaler); ok { + text, err := tm.MarshalText() + if err != nil { + return err + } + if _, err = w.Write(text); err != nil { + return err + } + } else if err := writeStruct(w, v); err != nil { + return err + } + w.unindent() + if err := w.WriteByte(ket); err != nil { + return err + } + default: + _, err := fmt.Fprint(w, v.Interface()) + return err + } + return nil +} + +// equivalent to C's isprint. +func isprint(c byte) bool { + return c >= 0x20 && c < 0x7f +} + +// writeString writes a string in the protocol buffer text format. +// It is similar to strconv.Quote except we don't use Go escape sequences, +// we treat the string as a byte sequence, and we use octal escapes. +// These differences are to maintain interoperability with the other +// languages' implementations of the text format. +func writeString(w *textWriter, s string) error { + // use WriteByte here to get any needed indent + if err := w.WriteByte('"'); err != nil { + return err + } + // Loop over the bytes, not the runes. + for i := 0; i < len(s); i++ { + var err error + // Divergence from C++: we don't escape apostrophes. + // There's no need to escape them, and the C++ parser + // copes with a naked apostrophe. + switch c := s[i]; c { + case '\n': + _, err = w.w.Write(backslashN) + case '\r': + _, err = w.w.Write(backslashR) + case '\t': + _, err = w.w.Write(backslashT) + case '"': + _, err = w.w.Write(backslashDQ) + case '\\': + _, err = w.w.Write(backslashBS) + default: + if isprint(c) { + err = w.w.WriteByte(c) + } else { + _, err = fmt.Fprintf(w.w, "\\%03o", c) + } + } + if err != nil { + return err + } + } + return w.WriteByte('"') +} + +func writeMessageSet(w *textWriter, ms *MessageSet) error { + for _, item := range ms.Item { + id := *item.TypeId + if msd, ok := messageSetMap[id]; ok { + // Known message set type. + if _, err := fmt.Fprintf(w, "[%s]: <\n", msd.name); err != nil { + return err + } + w.indent() + + pb := reflect.New(msd.t.Elem()) + if err := Unmarshal(item.Message, pb.Interface().(Message)); err != nil { + if _, err := fmt.Fprintf(w, "/* bad message: %v */\n", err); err != nil { + return err + } + } else { + if err := writeStruct(w, pb.Elem()); err != nil { + return err + } + } + } else { + // Unknown type. + if _, err := fmt.Fprintf(w, "[%d]: <\n", id); err != nil { + return err + } + w.indent() + if err := writeUnknownStruct(w, item.Message); err != nil { + return err + } + } + w.unindent() + if _, err := w.Write(gtNewline); err != nil { + return err + } + } + return nil +} + +func writeUnknownStruct(w *textWriter, data []byte) (err error) { + if !w.compact { + if _, err := fmt.Fprintf(w, "/* %d unknown bytes */\n", len(data)); err != nil { + return err + } + } + b := NewBuffer(data) + for b.index < len(b.buf) { + x, err := b.DecodeVarint() + if err != nil { + _, err := fmt.Fprintf(w, "/* %v */\n", err) + return err + } + wire, tag := x&7, x>>3 + if wire == WireEndGroup { + w.unindent() + if _, err := w.Write(endBraceNewline); err != nil { + return err + } + continue + } + if _, err := fmt.Fprint(w, tag); err != nil { + return err + } + if wire != WireStartGroup { + if err := w.WriteByte(':'); err != nil { + return err + } + } + if !w.compact || wire == WireStartGroup { + if err := w.WriteByte(' '); err != nil { + return err + } + } + switch wire { + case WireBytes: + buf, e := b.DecodeRawBytes(false) + if e == nil { + _, err = fmt.Fprintf(w, "%q", buf) + } else { + _, err = fmt.Fprintf(w, "/* %v */", e) + } + case WireFixed32: + x, err = b.DecodeFixed32() + err = writeUnknownInt(w, x, err) + case WireFixed64: + x, err = b.DecodeFixed64() + err = writeUnknownInt(w, x, err) + case WireStartGroup: + err = w.WriteByte('{') + w.indent() + case WireVarint: + x, err = b.DecodeVarint() + err = writeUnknownInt(w, x, err) + default: + _, err = fmt.Fprintf(w, "/* unknown wire type %d */", wire) + } + if err != nil { + return err + } + if err = w.WriteByte('\n'); err != nil { + return err + } + } + return nil +} + +func writeUnknownInt(w *textWriter, x uint64, err error) error { + if err == nil { + _, err = fmt.Fprint(w, x) + } else { + _, err = fmt.Fprintf(w, "/* %v */", err) + } + return err +} + +type int32Slice []int32 + +func (s int32Slice) Len() int { return len(s) } +func (s int32Slice) Less(i, j int) bool { return s[i] < s[j] } +func (s int32Slice) Swap(i, j int) { s[i], s[j] = s[j], s[i] } + +// writeExtensions writes all the extensions in pv. +// pv is assumed to be a pointer to a protocol message struct that is extendable. +func writeExtensions(w *textWriter, pv reflect.Value) error { + emap := extensionMaps[pv.Type().Elem()] + ep := pv.Interface().(extendableProto) + + // Order the extensions by ID. + // This isn't strictly necessary, but it will give us + // canonical output, which will also make testing easier. + m := ep.ExtensionMap() + ids := make([]int32, 0, len(m)) + for id := range m { + ids = append(ids, id) + } + sort.Sort(int32Slice(ids)) + + for _, extNum := range ids { + ext := m[extNum] + var desc *ExtensionDesc + if emap != nil { + desc = emap[extNum] + } + if desc == nil { + // Unknown extension. + if err := writeUnknownStruct(w, ext.enc); err != nil { + return err + } + continue + } + + pb, err := GetExtension(ep, desc) + if err != nil { + if _, err := fmt.Fprintln(os.Stderr, "proto: failed getting extension: ", err); err != nil { + return err + } + continue + } + + // Repeated extensions will appear as a slice. + if !desc.repeated() { + if err := writeExtension(w, desc.Name, pb); err != nil { + return err + } + } else { + v := reflect.ValueOf(pb) + for i := 0; i < v.Len(); i++ { + if err := writeExtension(w, desc.Name, v.Index(i).Interface()); err != nil { + return err + } + } + } + } + return nil +} + +func writeExtension(w *textWriter, name string, pb interface{}) error { + if _, err := fmt.Fprintf(w, "[%s]:", name); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if err := writeAny(w, reflect.ValueOf(pb), nil); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + return nil +} + +func (w *textWriter) writeIndent() { + if !w.complete { + return + } + remain := w.ind * 2 + for remain > 0 { + n := remain + if n > len(spaces) { + n = len(spaces) + } + w.w.Write(spaces[:n]) + remain -= n + } + w.complete = false +} + +func marshalText(w io.Writer, pb Message, compact bool) error { + val := reflect.ValueOf(pb) + if pb == nil || val.IsNil() { + w.Write([]byte("")) + return nil + } + var bw *bufio.Writer + ww, ok := w.(writer) + if !ok { + bw = bufio.NewWriter(w) + ww = bw + } + aw := &textWriter{ + w: ww, + complete: true, + compact: compact, + } + + if tm, ok := pb.(encoding.TextMarshaler); ok { + text, err := tm.MarshalText() + if err != nil { + return err + } + if _, err = aw.Write(text); err != nil { + return err + } + if bw != nil { + return bw.Flush() + } + return nil + } + // Dereference the received pointer so we don't have outer < and >. + v := reflect.Indirect(val) + if err := writeStruct(aw, v); err != nil { + return err + } + if bw != nil { + return bw.Flush() + } + return nil +} + +// MarshalText writes a given protocol buffer in text format. +// The only errors returned are from w. +func MarshalText(w io.Writer, pb Message) error { + return marshalText(w, pb, false) +} + +// MarshalTextString is the same as MarshalText, but returns the string directly. +func MarshalTextString(pb Message) string { + var buf bytes.Buffer + marshalText(&buf, pb, false) + return buf.String() +} + +// CompactText writes a given protocol buffer in compact text format (one line). +func CompactText(w io.Writer, pb Message) error { return marshalText(w, pb, true) } + +// CompactTextString is the same as CompactText, but returns the string directly. +func CompactTextString(pb Message) string { + var buf bytes.Buffer + marshalText(&buf, pb, true) + return buf.String() +} diff --git a/vendor/src/github.com/golang/protobuf/proto/text_parser.go b/vendor/src/github.com/golang/protobuf/proto/text_parser.go new file mode 100644 index 0000000000..d1caeff5d9 --- /dev/null +++ b/vendor/src/github.com/golang/protobuf/proto/text_parser.go @@ -0,0 +1,757 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +// Functions for parsing the Text protocol buffer format. +// TODO: message sets. + +import ( + "encoding" + "errors" + "fmt" + "reflect" + "strconv" + "strings" + "unicode/utf8" +) + +type ParseError struct { + Message string + Line int // 1-based line number + Offset int // 0-based byte offset from start of input +} + +func (p *ParseError) Error() string { + if p.Line == 1 { + // show offset only for first line + return fmt.Sprintf("line 1.%d: %v", p.Offset, p.Message) + } + return fmt.Sprintf("line %d: %v", p.Line, p.Message) +} + +type token struct { + value string + err *ParseError + line int // line number + offset int // byte number from start of input, not start of line + unquoted string // the unquoted version of value, if it was a quoted string +} + +func (t *token) String() string { + if t.err == nil { + return fmt.Sprintf("%q (line=%d, offset=%d)", t.value, t.line, t.offset) + } + return fmt.Sprintf("parse error: %v", t.err) +} + +type textParser struct { + s string // remaining input + done bool // whether the parsing is finished (success or error) + backed bool // whether back() was called + offset, line int + cur token +} + +func newTextParser(s string) *textParser { + p := new(textParser) + p.s = s + p.line = 1 + p.cur.line = 1 + return p +} + +func (p *textParser) errorf(format string, a ...interface{}) *ParseError { + pe := &ParseError{fmt.Sprintf(format, a...), p.cur.line, p.cur.offset} + p.cur.err = pe + p.done = true + return pe +} + +// Numbers and identifiers are matched by [-+._A-Za-z0-9] +func isIdentOrNumberChar(c byte) bool { + switch { + case 'A' <= c && c <= 'Z', 'a' <= c && c <= 'z': + return true + case '0' <= c && c <= '9': + return true + } + switch c { + case '-', '+', '.', '_': + return true + } + return false +} + +func isWhitespace(c byte) bool { + switch c { + case ' ', '\t', '\n', '\r': + return true + } + return false +} + +func (p *textParser) skipWhitespace() { + i := 0 + for i < len(p.s) && (isWhitespace(p.s[i]) || p.s[i] == '#') { + if p.s[i] == '#' { + // comment; skip to end of line or input + for i < len(p.s) && p.s[i] != '\n' { + i++ + } + if i == len(p.s) { + break + } + } + if p.s[i] == '\n' { + p.line++ + } + i++ + } + p.offset += i + p.s = p.s[i:len(p.s)] + if len(p.s) == 0 { + p.done = true + } +} + +func (p *textParser) advance() { + // Skip whitespace + p.skipWhitespace() + if p.done { + return + } + + // Start of non-whitespace + p.cur.err = nil + p.cur.offset, p.cur.line = p.offset, p.line + p.cur.unquoted = "" + switch p.s[0] { + case '<', '>', '{', '}', ':', '[', ']', ';', ',': + // Single symbol + p.cur.value, p.s = p.s[0:1], p.s[1:len(p.s)] + case '"', '\'': + // Quoted string + i := 1 + for i < len(p.s) && p.s[i] != p.s[0] && p.s[i] != '\n' { + if p.s[i] == '\\' && i+1 < len(p.s) { + // skip escaped char + i++ + } + i++ + } + if i >= len(p.s) || p.s[i] != p.s[0] { + p.errorf("unmatched quote") + return + } + unq, err := unquoteC(p.s[1:i], rune(p.s[0])) + if err != nil { + p.errorf("invalid quoted string %v", p.s[0:i+1]) + return + } + p.cur.value, p.s = p.s[0:i+1], p.s[i+1:len(p.s)] + p.cur.unquoted = unq + default: + i := 0 + for i < len(p.s) && isIdentOrNumberChar(p.s[i]) { + i++ + } + if i == 0 { + p.errorf("unexpected byte %#x", p.s[0]) + return + } + p.cur.value, p.s = p.s[0:i], p.s[i:len(p.s)] + } + p.offset += len(p.cur.value) +} + +var ( + errBadUTF8 = errors.New("proto: bad UTF-8") + errBadHex = errors.New("proto: bad hexadecimal") +) + +func unquoteC(s string, quote rune) (string, error) { + // This is based on C++'s tokenizer.cc. + // Despite its name, this is *not* parsing C syntax. + // For instance, "\0" is an invalid quoted string. + + // Avoid allocation in trivial cases. + simple := true + for _, r := range s { + if r == '\\' || r == quote { + simple = false + break + } + } + if simple { + return s, nil + } + + buf := make([]byte, 0, 3*len(s)/2) + for len(s) > 0 { + r, n := utf8.DecodeRuneInString(s) + if r == utf8.RuneError && n == 1 { + return "", errBadUTF8 + } + s = s[n:] + if r != '\\' { + if r < utf8.RuneSelf { + buf = append(buf, byte(r)) + } else { + buf = append(buf, string(r)...) + } + continue + } + + ch, tail, err := unescape(s) + if err != nil { + return "", err + } + buf = append(buf, ch...) + s = tail + } + return string(buf), nil +} + +func unescape(s string) (ch string, tail string, err error) { + r, n := utf8.DecodeRuneInString(s) + if r == utf8.RuneError && n == 1 { + return "", "", errBadUTF8 + } + s = s[n:] + switch r { + case 'a': + return "\a", s, nil + case 'b': + return "\b", s, nil + case 'f': + return "\f", s, nil + case 'n': + return "\n", s, nil + case 'r': + return "\r", s, nil + case 't': + return "\t", s, nil + case 'v': + return "\v", s, nil + case '?': + return "?", s, nil // trigraph workaround + case '\'', '"', '\\': + return string(r), s, nil + case '0', '1', '2', '3', '4', '5', '6', '7', 'x', 'X': + if len(s) < 2 { + return "", "", fmt.Errorf(`\%c requires 2 following digits`, r) + } + base := 8 + ss := s[:2] + s = s[2:] + if r == 'x' || r == 'X' { + base = 16 + } else { + ss = string(r) + ss + } + i, err := strconv.ParseUint(ss, base, 8) + if err != nil { + return "", "", err + } + return string([]byte{byte(i)}), s, nil + case 'u', 'U': + n := 4 + if r == 'U' { + n = 8 + } + if len(s) < n { + return "", "", fmt.Errorf(`\%c requires %d digits`, r, n) + } + + bs := make([]byte, n/2) + for i := 0; i < n; i += 2 { + a, ok1 := unhex(s[i]) + b, ok2 := unhex(s[i+1]) + if !ok1 || !ok2 { + return "", "", errBadHex + } + bs[i/2] = a<<4 | b + } + s = s[n:] + return string(bs), s, nil + } + return "", "", fmt.Errorf(`unknown escape \%c`, r) +} + +// Adapted from src/pkg/strconv/quote.go. +func unhex(b byte) (v byte, ok bool) { + switch { + case '0' <= b && b <= '9': + return b - '0', true + case 'a' <= b && b <= 'f': + return b - 'a' + 10, true + case 'A' <= b && b <= 'F': + return b - 'A' + 10, true + } + return 0, false +} + +// Back off the parser by one token. Can only be done between calls to next(). +// It makes the next advance() a no-op. +func (p *textParser) back() { p.backed = true } + +// Advances the parser and returns the new current token. +func (p *textParser) next() *token { + if p.backed || p.done { + p.backed = false + return &p.cur + } + p.advance() + if p.done { + p.cur.value = "" + } else if len(p.cur.value) > 0 && p.cur.value[0] == '"' { + // Look for multiple quoted strings separated by whitespace, + // and concatenate them. + cat := p.cur + for { + p.skipWhitespace() + if p.done || p.s[0] != '"' { + break + } + p.advance() + if p.cur.err != nil { + return &p.cur + } + cat.value += " " + p.cur.value + cat.unquoted += p.cur.unquoted + } + p.done = false // parser may have seen EOF, but we want to return cat + p.cur = cat + } + return &p.cur +} + +func (p *textParser) consumeToken(s string) error { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value != s { + p.back() + return p.errorf("expected %q, found %q", s, tok.value) + } + return nil +} + +// Return a RequiredNotSetError indicating which required field was not set. +func (p *textParser) missingRequiredFieldError(sv reflect.Value) *RequiredNotSetError { + st := sv.Type() + sprops := GetProperties(st) + for i := 0; i < st.NumField(); i++ { + if !isNil(sv.Field(i)) { + continue + } + + props := sprops.Prop[i] + if props.Required { + return &RequiredNotSetError{fmt.Sprintf("%v.%v", st, props.OrigName)} + } + } + return &RequiredNotSetError{fmt.Sprintf("%v.", st)} // should not happen +} + +// Returns the index in the struct for the named field, as well as the parsed tag properties. +func structFieldByName(st reflect.Type, name string) (int, *Properties, bool) { + sprops := GetProperties(st) + i, ok := sprops.decoderOrigNames[name] + if ok { + return i, sprops.Prop[i], true + } + return -1, nil, false +} + +// Consume a ':' from the input stream (if the next token is a colon), +// returning an error if a colon is needed but not present. +func (p *textParser) checkForColon(props *Properties, typ reflect.Type) *ParseError { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value != ":" { + // Colon is optional when the field is a group or message. + needColon := true + switch props.Wire { + case "group": + needColon = false + case "bytes": + // A "bytes" field is either a message, a string, or a repeated field; + // those three become *T, *string and []T respectively, so we can check for + // this field being a pointer to a non-string. + if typ.Kind() == reflect.Ptr { + // *T or *string + if typ.Elem().Kind() == reflect.String { + break + } + } else if typ.Kind() == reflect.Slice { + // []T or []*T + if typ.Elem().Kind() != reflect.Ptr { + break + } + } else if typ.Kind() == reflect.String { + // The proto3 exception is for a string field, + // which requires a colon. + break + } + needColon = false + } + if needColon { + return p.errorf("expected ':', found %q", tok.value) + } + p.back() + } + return nil +} + +func (p *textParser) readStruct(sv reflect.Value, terminator string) error { + st := sv.Type() + reqCount := GetProperties(st).reqCount + var reqFieldErr error + fieldSet := make(map[string]bool) + // A struct is a sequence of "name: value", terminated by one of + // '>' or '}', or the end of the input. A name may also be + // "[extension]". + for { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value == terminator { + break + } + if tok.value == "[" { + // Looks like an extension. + // + // TODO: Check whether we need to handle + // namespace rooted names (e.g. ".something.Foo"). + tok = p.next() + if tok.err != nil { + return tok.err + } + var desc *ExtensionDesc + // This could be faster, but it's functional. + // TODO: Do something smarter than a linear scan. + for _, d := range RegisteredExtensions(reflect.New(st).Interface().(Message)) { + if d.Name == tok.value { + desc = d + break + } + } + if desc == nil { + return p.errorf("unrecognized extension %q", tok.value) + } + // Check the extension terminator. + tok = p.next() + if tok.err != nil { + return tok.err + } + if tok.value != "]" { + return p.errorf("unrecognized extension terminator %q", tok.value) + } + + props := &Properties{} + props.Parse(desc.Tag) + + typ := reflect.TypeOf(desc.ExtensionType) + if err := p.checkForColon(props, typ); err != nil { + return err + } + + rep := desc.repeated() + + // Read the extension structure, and set it in + // the value we're constructing. + var ext reflect.Value + if !rep { + ext = reflect.New(typ).Elem() + } else { + ext = reflect.New(typ.Elem()).Elem() + } + if err := p.readAny(ext, props); err != nil { + if _, ok := err.(*RequiredNotSetError); !ok { + return err + } + reqFieldErr = err + } + ep := sv.Addr().Interface().(extendableProto) + if !rep { + SetExtension(ep, desc, ext.Interface()) + } else { + old, err := GetExtension(ep, desc) + var sl reflect.Value + if err == nil { + sl = reflect.ValueOf(old) // existing slice + } else { + sl = reflect.MakeSlice(typ, 0, 1) + } + sl = reflect.Append(sl, ext) + SetExtension(ep, desc, sl.Interface()) + } + } else { + // This is a normal, non-extension field. + name := tok.value + fi, props, ok := structFieldByName(st, name) + if !ok { + return p.errorf("unknown field name %q in %v", name, st) + } + + dst := sv.Field(fi) + + if dst.Kind() == reflect.Map { + // Consume any colon. + if err := p.checkForColon(props, dst.Type()); err != nil { + return err + } + + // Construct the map if it doesn't already exist. + if dst.IsNil() { + dst.Set(reflect.MakeMap(dst.Type())) + } + key := reflect.New(dst.Type().Key()).Elem() + val := reflect.New(dst.Type().Elem()).Elem() + + // The map entry should be this sequence of tokens: + // < key : KEY value : VALUE > + // Technically the "key" and "value" could come in any order, + // but in practice they won't. + + tok := p.next() + var terminator string + switch tok.value { + case "<": + terminator = ">" + case "{": + terminator = "}" + default: + return p.errorf("expected '{' or '<', found %q", tok.value) + } + if err := p.consumeToken("key"); err != nil { + return err + } + if err := p.consumeToken(":"); err != nil { + return err + } + if err := p.readAny(key, props.mkeyprop); err != nil { + return err + } + if err := p.consumeToken("value"); err != nil { + return err + } + if err := p.checkForColon(props.mvalprop, dst.Type().Elem()); err != nil { + return err + } + if err := p.readAny(val, props.mvalprop); err != nil { + return err + } + if err := p.consumeToken(terminator); err != nil { + return err + } + + dst.SetMapIndex(key, val) + continue + } + + // Check that it's not already set if it's not a repeated field. + if !props.Repeated && fieldSet[name] { + return p.errorf("non-repeated field %q was repeated", name) + } + + if err := p.checkForColon(props, st.Field(fi).Type); err != nil { + return err + } + + // Parse into the field. + fieldSet[name] = true + if err := p.readAny(dst, props); err != nil { + if _, ok := err.(*RequiredNotSetError); !ok { + return err + } + reqFieldErr = err + } else if props.Required { + reqCount-- + } + } + + // For backward compatibility, permit a semicolon or comma after a field. + tok = p.next() + if tok.err != nil { + return tok.err + } + if tok.value != ";" && tok.value != "," { + p.back() + } + } + + if reqCount > 0 { + return p.missingRequiredFieldError(sv) + } + return reqFieldErr +} + +func (p *textParser) readAny(v reflect.Value, props *Properties) error { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value == "" { + return p.errorf("unexpected EOF") + } + + switch fv := v; fv.Kind() { + case reflect.Slice: + at := v.Type() + if at.Elem().Kind() == reflect.Uint8 { + // Special case for []byte + if tok.value[0] != '"' && tok.value[0] != '\'' { + // Deliberately written out here, as the error after + // this switch statement would write "invalid []byte: ...", + // which is not as user-friendly. + return p.errorf("invalid string: %v", tok.value) + } + bytes := []byte(tok.unquoted) + fv.Set(reflect.ValueOf(bytes)) + return nil + } + // Repeated field. May already exist. + flen := fv.Len() + if flen == fv.Cap() { + nav := reflect.MakeSlice(at, flen, 2*flen+1) + reflect.Copy(nav, fv) + fv.Set(nav) + } + fv.SetLen(flen + 1) + + // Read one. + p.back() + return p.readAny(fv.Index(flen), props) + case reflect.Bool: + // Either "true", "false", 1 or 0. + switch tok.value { + case "true", "1": + fv.SetBool(true) + return nil + case "false", "0": + fv.SetBool(false) + return nil + } + case reflect.Float32, reflect.Float64: + v := tok.value + // Ignore 'f' for compatibility with output generated by C++, but don't + // remove 'f' when the value is "-inf" or "inf". + if strings.HasSuffix(v, "f") && tok.value != "-inf" && tok.value != "inf" { + v = v[:len(v)-1] + } + if f, err := strconv.ParseFloat(v, fv.Type().Bits()); err == nil { + fv.SetFloat(f) + return nil + } + case reflect.Int32: + if x, err := strconv.ParseInt(tok.value, 0, 32); err == nil { + fv.SetInt(x) + return nil + } + + if len(props.Enum) == 0 { + break + } + m, ok := enumValueMaps[props.Enum] + if !ok { + break + } + x, ok := m[tok.value] + if !ok { + break + } + fv.SetInt(int64(x)) + return nil + case reflect.Int64: + if x, err := strconv.ParseInt(tok.value, 0, 64); err == nil { + fv.SetInt(x) + return nil + } + + case reflect.Ptr: + // A basic field (indirected through pointer), or a repeated message/group + p.back() + fv.Set(reflect.New(fv.Type().Elem())) + return p.readAny(fv.Elem(), props) + case reflect.String: + if tok.value[0] == '"' || tok.value[0] == '\'' { + fv.SetString(tok.unquoted) + return nil + } + case reflect.Struct: + var terminator string + switch tok.value { + case "{": + terminator = "}" + case "<": + terminator = ">" + default: + return p.errorf("expected '{' or '<', found %q", tok.value) + } + // TODO: Handle nested messages which implement encoding.TextUnmarshaler. + return p.readStruct(fv, terminator) + case reflect.Uint32: + if x, err := strconv.ParseUint(tok.value, 0, 32); err == nil { + fv.SetUint(uint64(x)) + return nil + } + case reflect.Uint64: + if x, err := strconv.ParseUint(tok.value, 0, 64); err == nil { + fv.SetUint(x) + return nil + } + } + return p.errorf("invalid %v: %v", v.Type(), tok.value) +} + +// UnmarshalText reads a protocol buffer in Text format. UnmarshalText resets pb +// before starting to unmarshal, so any existing data in pb is always removed. +// If a required field is not set and no other error occurs, +// UnmarshalText returns *RequiredNotSetError. +func UnmarshalText(s string, pb Message) error { + if um, ok := pb.(encoding.TextUnmarshaler); ok { + err := um.UnmarshalText([]byte(s)) + return err + } + pb.Reset() + v := reflect.ValueOf(pb) + if pe := newTextParser(s).readStruct(v.Elem(), ""); pe != nil { + return pe + } + return nil +} diff --git a/vendor/src/github.com/gorilla/context/.travis.yml b/vendor/src/github.com/gorilla/context/.travis.yml new file mode 100644 index 0000000000..d87d465768 --- /dev/null +++ b/vendor/src/github.com/gorilla/context/.travis.yml @@ -0,0 +1,7 @@ +language: go + +go: + - 1.0 + - 1.1 + - 1.2 + - tip diff --git a/vendor/src/github.com/gorilla/context/LICENSE b/vendor/src/github.com/gorilla/context/LICENSE new file mode 100644 index 0000000000..0e5fb87280 --- /dev/null +++ b/vendor/src/github.com/gorilla/context/LICENSE @@ -0,0 +1,27 @@ +Copyright (c) 2012 Rodrigo Moraes. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/gorilla/context/README.md b/vendor/src/github.com/gorilla/context/README.md new file mode 100644 index 0000000000..c60a31b053 --- /dev/null +++ b/vendor/src/github.com/gorilla/context/README.md @@ -0,0 +1,7 @@ +context +======= +[![Build Status](https://travis-ci.org/gorilla/context.png?branch=master)](https://travis-ci.org/gorilla/context) + +gorilla/context is a general purpose registry for global request variables. + +Read the full documentation here: http://www.gorillatoolkit.org/pkg/context diff --git a/vendor/src/github.com/gorilla/context/context.go b/vendor/src/github.com/gorilla/context/context.go new file mode 100644 index 0000000000..81cb128b19 --- /dev/null +++ b/vendor/src/github.com/gorilla/context/context.go @@ -0,0 +1,143 @@ +// Copyright 2012 The Gorilla Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package context + +import ( + "net/http" + "sync" + "time" +) + +var ( + mutex sync.RWMutex + data = make(map[*http.Request]map[interface{}]interface{}) + datat = make(map[*http.Request]int64) +) + +// Set stores a value for a given key in a given request. +func Set(r *http.Request, key, val interface{}) { + mutex.Lock() + if data[r] == nil { + data[r] = make(map[interface{}]interface{}) + datat[r] = time.Now().Unix() + } + data[r][key] = val + mutex.Unlock() +} + +// Get returns a value stored for a given key in a given request. +func Get(r *http.Request, key interface{}) interface{} { + mutex.RLock() + if ctx := data[r]; ctx != nil { + value := ctx[key] + mutex.RUnlock() + return value + } + mutex.RUnlock() + return nil +} + +// GetOk returns stored value and presence state like multi-value return of map access. +func GetOk(r *http.Request, key interface{}) (interface{}, bool) { + mutex.RLock() + if _, ok := data[r]; ok { + value, ok := data[r][key] + mutex.RUnlock() + return value, ok + } + mutex.RUnlock() + return nil, false +} + +// GetAll returns all stored values for the request as a map. Nil is returned for invalid requests. +func GetAll(r *http.Request) map[interface{}]interface{} { + mutex.RLock() + if context, ok := data[r]; ok { + result := make(map[interface{}]interface{}, len(context)) + for k, v := range context { + result[k] = v + } + mutex.RUnlock() + return result + } + mutex.RUnlock() + return nil +} + +// GetAllOk returns all stored values for the request as a map and a boolean value that indicates if +// the request was registered. +func GetAllOk(r *http.Request) (map[interface{}]interface{}, bool) { + mutex.RLock() + context, ok := data[r] + result := make(map[interface{}]interface{}, len(context)) + for k, v := range context { + result[k] = v + } + mutex.RUnlock() + return result, ok +} + +// Delete removes a value stored for a given key in a given request. +func Delete(r *http.Request, key interface{}) { + mutex.Lock() + if data[r] != nil { + delete(data[r], key) + } + mutex.Unlock() +} + +// Clear removes all values stored for a given request. +// +// This is usually called by a handler wrapper to clean up request +// variables at the end of a request lifetime. See ClearHandler(). +func Clear(r *http.Request) { + mutex.Lock() + clear(r) + mutex.Unlock() +} + +// clear is Clear without the lock. +func clear(r *http.Request) { + delete(data, r) + delete(datat, r) +} + +// Purge removes request data stored for longer than maxAge, in seconds. +// It returns the amount of requests removed. +// +// If maxAge <= 0, all request data is removed. +// +// This is only used for sanity check: in case context cleaning was not +// properly set some request data can be kept forever, consuming an increasing +// amount of memory. In case this is detected, Purge() must be called +// periodically until the problem is fixed. +func Purge(maxAge int) int { + mutex.Lock() + count := 0 + if maxAge <= 0 { + count = len(data) + data = make(map[*http.Request]map[interface{}]interface{}) + datat = make(map[*http.Request]int64) + } else { + min := time.Now().Unix() - int64(maxAge) + for r := range data { + if datat[r] < min { + clear(r) + count++ + } + } + } + mutex.Unlock() + return count +} + +// ClearHandler wraps an http.Handler and clears request values at the end +// of a request lifetime. +func ClearHandler(h http.Handler) http.Handler { + return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + defer Clear(r) + h.ServeHTTP(w, r) + }) +} diff --git a/vendor/src/github.com/gorilla/context/doc.go b/vendor/src/github.com/gorilla/context/doc.go new file mode 100644 index 0000000000..73c7400311 --- /dev/null +++ b/vendor/src/github.com/gorilla/context/doc.go @@ -0,0 +1,82 @@ +// Copyright 2012 The Gorilla Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +/* +Package context stores values shared during a request lifetime. + +For example, a router can set variables extracted from the URL and later +application handlers can access those values, or it can be used to store +sessions values to be saved at the end of a request. There are several +others common uses. + +The idea was posted by Brad Fitzpatrick to the go-nuts mailing list: + + http://groups.google.com/group/golang-nuts/msg/e2d679d303aa5d53 + +Here's the basic usage: first define the keys that you will need. The key +type is interface{} so a key can be of any type that supports equality. +Here we define a key using a custom int type to avoid name collisions: + + package foo + + import ( + "github.com/gorilla/context" + ) + + type key int + + const MyKey key = 0 + +Then set a variable. Variables are bound to an http.Request object, so you +need a request instance to set a value: + + context.Set(r, MyKey, "bar") + +The application can later access the variable using the same key you provided: + + func MyHandler(w http.ResponseWriter, r *http.Request) { + // val is "bar". + val := context.Get(r, foo.MyKey) + + // returns ("bar", true) + val, ok := context.GetOk(r, foo.MyKey) + // ... + } + +And that's all about the basic usage. We discuss some other ideas below. + +Any type can be stored in the context. To enforce a given type, make the key +private and wrap Get() and Set() to accept and return values of a specific +type: + + type key int + + const mykey key = 0 + + // GetMyKey returns a value for this package from the request values. + func GetMyKey(r *http.Request) SomeType { + if rv := context.Get(r, mykey); rv != nil { + return rv.(SomeType) + } + return nil + } + + // SetMyKey sets a value for this package in the request values. + func SetMyKey(r *http.Request, val SomeType) { + context.Set(r, mykey, val) + } + +Variables must be cleared at the end of a request, to remove all values +that were stored. This can be done in an http.Handler, after a request was +served. Just call Clear() passing the request: + + context.Clear(r) + +...or use ClearHandler(), which conveniently wraps an http.Handler to clear +variables at the end of a request lifetime. + +The Routers from the packages gorilla/mux and gorilla/pat call Clear() +so if you are using either of them you don't need to clear the context manually. +*/ +package context diff --git a/vendor/src/github.com/gorilla/mux/.travis.yml b/vendor/src/github.com/gorilla/mux/.travis.yml new file mode 100644 index 0000000000..d87d465768 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/.travis.yml @@ -0,0 +1,7 @@ +language: go + +go: + - 1.0 + - 1.1 + - 1.2 + - tip diff --git a/vendor/src/github.com/gorilla/mux/LICENSE b/vendor/src/github.com/gorilla/mux/LICENSE new file mode 100644 index 0000000000..0e5fb87280 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/LICENSE @@ -0,0 +1,27 @@ +Copyright (c) 2012 Rodrigo Moraes. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/gorilla/mux/README.md b/vendor/src/github.com/gorilla/mux/README.md new file mode 100644 index 0000000000..e60301b033 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/README.md @@ -0,0 +1,7 @@ +mux +=== +[![Build Status](https://travis-ci.org/gorilla/mux.png?branch=master)](https://travis-ci.org/gorilla/mux) + +gorilla/mux is a powerful URL router and dispatcher. + +Read the full documentation here: http://www.gorillatoolkit.org/pkg/mux diff --git a/vendor/src/github.com/gorilla/mux/doc.go b/vendor/src/github.com/gorilla/mux/doc.go new file mode 100644 index 0000000000..b2deed34c4 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/doc.go @@ -0,0 +1,199 @@ +// Copyright 2012 The Gorilla Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +/* +Package gorilla/mux implements a request router and dispatcher. + +The name mux stands for "HTTP request multiplexer". Like the standard +http.ServeMux, mux.Router matches incoming requests against a list of +registered routes and calls a handler for the route that matches the URL +or other conditions. The main features are: + + * Requests can be matched based on URL host, path, path prefix, schemes, + header and query values, HTTP methods or using custom matchers. + * URL hosts and paths can have variables with an optional regular + expression. + * Registered URLs can be built, or "reversed", which helps maintaining + references to resources. + * Routes can be used as subrouters: nested routes are only tested if the + parent route matches. This is useful to define groups of routes that + share common conditions like a host, a path prefix or other repeated + attributes. As a bonus, this optimizes request matching. + * It implements the http.Handler interface so it is compatible with the + standard http.ServeMux. + +Let's start registering a couple of URL paths and handlers: + + func main() { + r := mux.NewRouter() + r.HandleFunc("/", HomeHandler) + r.HandleFunc("/products", ProductsHandler) + r.HandleFunc("/articles", ArticlesHandler) + http.Handle("/", r) + } + +Here we register three routes mapping URL paths to handlers. This is +equivalent to how http.HandleFunc() works: if an incoming request URL matches +one of the paths, the corresponding handler is called passing +(http.ResponseWriter, *http.Request) as parameters. + +Paths can have variables. They are defined using the format {name} or +{name:pattern}. If a regular expression pattern is not defined, the matched +variable will be anything until the next slash. For example: + + r := mux.NewRouter() + r.HandleFunc("/products/{key}", ProductHandler) + r.HandleFunc("/articles/{category}/", ArticlesCategoryHandler) + r.HandleFunc("/articles/{category}/{id:[0-9]+}", ArticleHandler) + +The names are used to create a map of route variables which can be retrieved +calling mux.Vars(): + + vars := mux.Vars(request) + category := vars["category"] + +And this is all you need to know about the basic usage. More advanced options +are explained below. + +Routes can also be restricted to a domain or subdomain. Just define a host +pattern to be matched. They can also have variables: + + r := mux.NewRouter() + // Only matches if domain is "www.domain.com". + r.Host("www.domain.com") + // Matches a dynamic subdomain. + r.Host("{subdomain:[a-z]+}.domain.com") + +There are several other matchers that can be added. To match path prefixes: + + r.PathPrefix("/products/") + +...or HTTP methods: + + r.Methods("GET", "POST") + +...or URL schemes: + + r.Schemes("https") + +...or header values: + + r.Headers("X-Requested-With", "XMLHttpRequest") + +...or query values: + + r.Queries("key", "value") + +...or to use a custom matcher function: + + r.MatcherFunc(func(r *http.Request, rm *RouteMatch) bool { + return r.ProtoMajor == 0 + }) + +...and finally, it is possible to combine several matchers in a single route: + + r.HandleFunc("/products", ProductsHandler). + Host("www.domain.com"). + Methods("GET"). + Schemes("http") + +Setting the same matching conditions again and again can be boring, so we have +a way to group several routes that share the same requirements. +We call it "subrouting". + +For example, let's say we have several URLs that should only match when the +host is "www.domain.com". Create a route for that host and get a "subrouter" +from it: + + r := mux.NewRouter() + s := r.Host("www.domain.com").Subrouter() + +Then register routes in the subrouter: + + s.HandleFunc("/products/", ProductsHandler) + s.HandleFunc("/products/{key}", ProductHandler) + s.HandleFunc("/articles/{category}/{id:[0-9]+}"), ArticleHandler) + +The three URL paths we registered above will only be tested if the domain is +"www.domain.com", because the subrouter is tested first. This is not +only convenient, but also optimizes request matching. You can create +subrouters combining any attribute matchers accepted by a route. + +Subrouters can be used to create domain or path "namespaces": you define +subrouters in a central place and then parts of the app can register its +paths relatively to a given subrouter. + +There's one more thing about subroutes. When a subrouter has a path prefix, +the inner routes use it as base for their paths: + + r := mux.NewRouter() + s := r.PathPrefix("/products").Subrouter() + // "/products/" + s.HandleFunc("/", ProductsHandler) + // "/products/{key}/" + s.HandleFunc("/{key}/", ProductHandler) + // "/products/{key}/details" + s.HandleFunc("/{key}/details", ProductDetailsHandler) + +Now let's see how to build registered URLs. + +Routes can be named. All routes that define a name can have their URLs built, +or "reversed". We define a name calling Name() on a route. For example: + + r := mux.NewRouter() + r.HandleFunc("/articles/{category}/{id:[0-9]+}", ArticleHandler). + Name("article") + +To build a URL, get the route and call the URL() method, passing a sequence of +key/value pairs for the route variables. For the previous route, we would do: + + url, err := r.Get("article").URL("category", "technology", "id", "42") + +...and the result will be a url.URL with the following path: + + "/articles/technology/42" + +This also works for host variables: + + r := mux.NewRouter() + r.Host("{subdomain}.domain.com"). + Path("/articles/{category}/{id:[0-9]+}"). + HandlerFunc(ArticleHandler). + Name("article") + + // url.String() will be "http://news.domain.com/articles/technology/42" + url, err := r.Get("article").URL("subdomain", "news", + "category", "technology", + "id", "42") + +All variables defined in the route are required, and their values must +conform to the corresponding patterns. These requirements guarantee that a +generated URL will always match a registered route -- the only exception is +for explicitly defined "build-only" routes which never match. + +There's also a way to build only the URL host or path for a route: +use the methods URLHost() or URLPath() instead. For the previous route, +we would do: + + // "http://news.domain.com/" + host, err := r.Get("article").URLHost("subdomain", "news") + + // "/articles/technology/42" + path, err := r.Get("article").URLPath("category", "technology", "id", "42") + +And if you use subrouters, host and path defined separately can be built +as well: + + r := mux.NewRouter() + s := r.Host("{subdomain}.domain.com").Subrouter() + s.Path("/articles/{category}/{id:[0-9]+}"). + HandlerFunc(ArticleHandler). + Name("article") + + // "http://news.domain.com/articles/technology/42" + url, err := r.Get("article").URL("subdomain", "news", + "category", "technology", + "id", "42") +*/ +package mux diff --git a/vendor/src/github.com/gorilla/mux/mux.go b/vendor/src/github.com/gorilla/mux/mux.go new file mode 100644 index 0000000000..5b5f8e7db5 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/mux.go @@ -0,0 +1,353 @@ +// Copyright 2012 The Gorilla Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package mux + +import ( + "fmt" + "net/http" + "path" + + "github.com/gorilla/context" +) + +// NewRouter returns a new router instance. +func NewRouter() *Router { + return &Router{namedRoutes: make(map[string]*Route), KeepContext: false} +} + +// Router registers routes to be matched and dispatches a handler. +// +// It implements the http.Handler interface, so it can be registered to serve +// requests: +// +// var router = mux.NewRouter() +// +// func main() { +// http.Handle("/", router) +// } +// +// Or, for Google App Engine, register it in a init() function: +// +// func init() { +// http.Handle("/", router) +// } +// +// This will send all incoming requests to the router. +type Router struct { + // Configurable Handler to be used when no route matches. + NotFoundHandler http.Handler + // Parent route, if this is a subrouter. + parent parentRoute + // Routes to be matched, in order. + routes []*Route + // Routes by name for URL building. + namedRoutes map[string]*Route + // See Router.StrictSlash(). This defines the flag for new routes. + strictSlash bool + // If true, do not clear the request context after handling the request + KeepContext bool +} + +// Match matches registered routes against the request. +func (r *Router) Match(req *http.Request, match *RouteMatch) bool { + for _, route := range r.routes { + if route.Match(req, match) { + return true + } + } + return false +} + +// ServeHTTP dispatches the handler registered in the matched route. +// +// When there is a match, the route variables can be retrieved calling +// mux.Vars(request). +func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request) { + // Clean path to canonical form and redirect. + if p := cleanPath(req.URL.Path); p != req.URL.Path { + + // Added 3 lines (Philip Schlump) - It was droping the query string and #whatever from query. + // This matches with fix in go 1.2 r.c. 4 for same problem. Go Issue: + // http://code.google.com/p/go/issues/detail?id=5252 + url := *req.URL + url.Path = p + p = url.String() + + w.Header().Set("Location", p) + w.WriteHeader(http.StatusMovedPermanently) + return + } + var match RouteMatch + var handler http.Handler + if r.Match(req, &match) { + handler = match.Handler + setVars(req, match.Vars) + setCurrentRoute(req, match.Route) + } + if handler == nil { + handler = r.NotFoundHandler + if handler == nil { + handler = http.NotFoundHandler() + } + } + if !r.KeepContext { + defer context.Clear(req) + } + handler.ServeHTTP(w, req) +} + +// Get returns a route registered with the given name. +func (r *Router) Get(name string) *Route { + return r.getNamedRoutes()[name] +} + +// GetRoute returns a route registered with the given name. This method +// was renamed to Get() and remains here for backwards compatibility. +func (r *Router) GetRoute(name string) *Route { + return r.getNamedRoutes()[name] +} + +// StrictSlash defines the trailing slash behavior for new routes. The initial +// value is false. +// +// When true, if the route path is "/path/", accessing "/path" will redirect +// to the former and vice versa. In other words, your application will always +// see the path as specified in the route. +// +// When false, if the route path is "/path", accessing "/path/" will not match +// this route and vice versa. +// +// Special case: when a route sets a path prefix using the PathPrefix() method, +// strict slash is ignored for that route because the redirect behavior can't +// be determined from a prefix alone. However, any subrouters created from that +// route inherit the original StrictSlash setting. +func (r *Router) StrictSlash(value bool) *Router { + r.strictSlash = value + return r +} + +// ---------------------------------------------------------------------------- +// parentRoute +// ---------------------------------------------------------------------------- + +// getNamedRoutes returns the map where named routes are registered. +func (r *Router) getNamedRoutes() map[string]*Route { + if r.namedRoutes == nil { + if r.parent != nil { + r.namedRoutes = r.parent.getNamedRoutes() + } else { + r.namedRoutes = make(map[string]*Route) + } + } + return r.namedRoutes +} + +// getRegexpGroup returns regexp definitions from the parent route, if any. +func (r *Router) getRegexpGroup() *routeRegexpGroup { + if r.parent != nil { + return r.parent.getRegexpGroup() + } + return nil +} + +// ---------------------------------------------------------------------------- +// Route factories +// ---------------------------------------------------------------------------- + +// NewRoute registers an empty route. +func (r *Router) NewRoute() *Route { + route := &Route{parent: r, strictSlash: r.strictSlash} + r.routes = append(r.routes, route) + return route +} + +// Handle registers a new route with a matcher for the URL path. +// See Route.Path() and Route.Handler(). +func (r *Router) Handle(path string, handler http.Handler) *Route { + return r.NewRoute().Path(path).Handler(handler) +} + +// HandleFunc registers a new route with a matcher for the URL path. +// See Route.Path() and Route.HandlerFunc(). +func (r *Router) HandleFunc(path string, f func(http.ResponseWriter, + *http.Request)) *Route { + return r.NewRoute().Path(path).HandlerFunc(f) +} + +// Headers registers a new route with a matcher for request header values. +// See Route.Headers(). +func (r *Router) Headers(pairs ...string) *Route { + return r.NewRoute().Headers(pairs...) +} + +// Host registers a new route with a matcher for the URL host. +// See Route.Host(). +func (r *Router) Host(tpl string) *Route { + return r.NewRoute().Host(tpl) +} + +// MatcherFunc registers a new route with a custom matcher function. +// See Route.MatcherFunc(). +func (r *Router) MatcherFunc(f MatcherFunc) *Route { + return r.NewRoute().MatcherFunc(f) +} + +// Methods registers a new route with a matcher for HTTP methods. +// See Route.Methods(). +func (r *Router) Methods(methods ...string) *Route { + return r.NewRoute().Methods(methods...) +} + +// Path registers a new route with a matcher for the URL path. +// See Route.Path(). +func (r *Router) Path(tpl string) *Route { + return r.NewRoute().Path(tpl) +} + +// PathPrefix registers a new route with a matcher for the URL path prefix. +// See Route.PathPrefix(). +func (r *Router) PathPrefix(tpl string) *Route { + return r.NewRoute().PathPrefix(tpl) +} + +// Queries registers a new route with a matcher for URL query values. +// See Route.Queries(). +func (r *Router) Queries(pairs ...string) *Route { + return r.NewRoute().Queries(pairs...) +} + +// Schemes registers a new route with a matcher for URL schemes. +// See Route.Schemes(). +func (r *Router) Schemes(schemes ...string) *Route { + return r.NewRoute().Schemes(schemes...) +} + +// ---------------------------------------------------------------------------- +// Context +// ---------------------------------------------------------------------------- + +// RouteMatch stores information about a matched route. +type RouteMatch struct { + Route *Route + Handler http.Handler + Vars map[string]string +} + +type contextKey int + +const ( + varsKey contextKey = iota + routeKey +) + +// Vars returns the route variables for the current request, if any. +func Vars(r *http.Request) map[string]string { + if rv := context.Get(r, varsKey); rv != nil { + return rv.(map[string]string) + } + return nil +} + +// CurrentRoute returns the matched route for the current request, if any. +func CurrentRoute(r *http.Request) *Route { + if rv := context.Get(r, routeKey); rv != nil { + return rv.(*Route) + } + return nil +} + +func setVars(r *http.Request, val interface{}) { + context.Set(r, varsKey, val) +} + +func setCurrentRoute(r *http.Request, val interface{}) { + context.Set(r, routeKey, val) +} + +// ---------------------------------------------------------------------------- +// Helpers +// ---------------------------------------------------------------------------- + +// cleanPath returns the canonical path for p, eliminating . and .. elements. +// Borrowed from the net/http package. +func cleanPath(p string) string { + if p == "" { + return "/" + } + if p[0] != '/' { + p = "/" + p + } + np := path.Clean(p) + // path.Clean removes trailing slash except for root; + // put the trailing slash back if necessary. + if p[len(p)-1] == '/' && np != "/" { + np += "/" + } + return np +} + +// uniqueVars returns an error if two slices contain duplicated strings. +func uniqueVars(s1, s2 []string) error { + for _, v1 := range s1 { + for _, v2 := range s2 { + if v1 == v2 { + return fmt.Errorf("mux: duplicated route variable %q", v2) + } + } + } + return nil +} + +// mapFromPairs converts variadic string parameters to a string map. +func mapFromPairs(pairs ...string) (map[string]string, error) { + length := len(pairs) + if length%2 != 0 { + return nil, fmt.Errorf( + "mux: number of parameters must be multiple of 2, got %v", pairs) + } + m := make(map[string]string, length/2) + for i := 0; i < length; i += 2 { + m[pairs[i]] = pairs[i+1] + } + return m, nil +} + +// matchInArray returns true if the given string value is in the array. +func matchInArray(arr []string, value string) bool { + for _, v := range arr { + if v == value { + return true + } + } + return false +} + +// matchMap returns true if the given key/value pairs exist in a given map. +func matchMap(toCheck map[string]string, toMatch map[string][]string, + canonicalKey bool) bool { + for k, v := range toCheck { + // Check if key exists. + if canonicalKey { + k = http.CanonicalHeaderKey(k) + } + if values := toMatch[k]; values == nil { + return false + } else if v != "" { + // If value was defined as an empty string we only check that the + // key exists. Otherwise we also check for equality. + valueExists := false + for _, value := range values { + if v == value { + valueExists = true + break + } + } + if !valueExists { + return false + } + } + } + return true +} diff --git a/vendor/src/github.com/gorilla/mux/regexp.go b/vendor/src/github.com/gorilla/mux/regexp.go new file mode 100644 index 0000000000..a6305483d5 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/regexp.go @@ -0,0 +1,276 @@ +// Copyright 2012 The Gorilla Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package mux + +import ( + "bytes" + "fmt" + "net/http" + "net/url" + "regexp" + "strings" +) + +// newRouteRegexp parses a route template and returns a routeRegexp, +// used to match a host, a path or a query string. +// +// It will extract named variables, assemble a regexp to be matched, create +// a "reverse" template to build URLs and compile regexps to validate variable +// values used in URL building. +// +// Previously we accepted only Python-like identifiers for variable +// names ([a-zA-Z_][a-zA-Z0-9_]*), but currently the only restriction is that +// name and pattern can't be empty, and names can't contain a colon. +func newRouteRegexp(tpl string, matchHost, matchPrefix, matchQuery, strictSlash bool) (*routeRegexp, error) { + // Check if it is well-formed. + idxs, errBraces := braceIndices(tpl) + if errBraces != nil { + return nil, errBraces + } + // Backup the original. + template := tpl + // Now let's parse it. + defaultPattern := "[^/]+" + if matchQuery { + defaultPattern = "[^?&]+" + matchPrefix = true + } else if matchHost { + defaultPattern = "[^.]+" + matchPrefix = false + } + // Only match strict slash if not matching + if matchPrefix || matchHost || matchQuery { + strictSlash = false + } + // Set a flag for strictSlash. + endSlash := false + if strictSlash && strings.HasSuffix(tpl, "/") { + tpl = tpl[:len(tpl)-1] + endSlash = true + } + varsN := make([]string, len(idxs)/2) + varsR := make([]*regexp.Regexp, len(idxs)/2) + pattern := bytes.NewBufferString("") + if !matchQuery { + pattern.WriteByte('^') + } + reverse := bytes.NewBufferString("") + var end int + var err error + for i := 0; i < len(idxs); i += 2 { + // Set all values we are interested in. + raw := tpl[end:idxs[i]] + end = idxs[i+1] + parts := strings.SplitN(tpl[idxs[i]+1:end-1], ":", 2) + name := parts[0] + patt := defaultPattern + if len(parts) == 2 { + patt = parts[1] + } + // Name or pattern can't be empty. + if name == "" || patt == "" { + return nil, fmt.Errorf("mux: missing name or pattern in %q", + tpl[idxs[i]:end]) + } + // Build the regexp pattern. + fmt.Fprintf(pattern, "%s(%s)", regexp.QuoteMeta(raw), patt) + // Build the reverse template. + fmt.Fprintf(reverse, "%s%%s", raw) + // Append variable name and compiled pattern. + varsN[i/2] = name + varsR[i/2], err = regexp.Compile(fmt.Sprintf("^%s$", patt)) + if err != nil { + return nil, err + } + } + // Add the remaining. + raw := tpl[end:] + pattern.WriteString(regexp.QuoteMeta(raw)) + if strictSlash { + pattern.WriteString("[/]?") + } + if !matchPrefix { + pattern.WriteByte('$') + } + reverse.WriteString(raw) + if endSlash { + reverse.WriteByte('/') + } + // Compile full regexp. + reg, errCompile := regexp.Compile(pattern.String()) + if errCompile != nil { + return nil, errCompile + } + // Done! + return &routeRegexp{ + template: template, + matchHost: matchHost, + matchQuery: matchQuery, + strictSlash: strictSlash, + regexp: reg, + reverse: reverse.String(), + varsN: varsN, + varsR: varsR, + }, nil +} + +// routeRegexp stores a regexp to match a host or path and information to +// collect and validate route variables. +type routeRegexp struct { + // The unmodified template. + template string + // True for host match, false for path or query string match. + matchHost bool + // True for query string match, false for path and host match. + matchQuery bool + // The strictSlash value defined on the route, but disabled if PathPrefix was used. + strictSlash bool + // Expanded regexp. + regexp *regexp.Regexp + // Reverse template. + reverse string + // Variable names. + varsN []string + // Variable regexps (validators). + varsR []*regexp.Regexp +} + +// Match matches the regexp against the URL host or path. +func (r *routeRegexp) Match(req *http.Request, match *RouteMatch) bool { + if !r.matchHost { + if r.matchQuery { + return r.regexp.MatchString(req.URL.RawQuery) + } else { + return r.regexp.MatchString(req.URL.Path) + } + } + return r.regexp.MatchString(getHost(req)) +} + +// url builds a URL part using the given values. +func (r *routeRegexp) url(pairs ...string) (string, error) { + values, err := mapFromPairs(pairs...) + if err != nil { + return "", err + } + urlValues := make([]interface{}, len(r.varsN)) + for k, v := range r.varsN { + value, ok := values[v] + if !ok { + return "", fmt.Errorf("mux: missing route variable %q", v) + } + urlValues[k] = value + } + rv := fmt.Sprintf(r.reverse, urlValues...) + if !r.regexp.MatchString(rv) { + // The URL is checked against the full regexp, instead of checking + // individual variables. This is faster but to provide a good error + // message, we check individual regexps if the URL doesn't match. + for k, v := range r.varsN { + if !r.varsR[k].MatchString(values[v]) { + return "", fmt.Errorf( + "mux: variable %q doesn't match, expected %q", values[v], + r.varsR[k].String()) + } + } + } + return rv, nil +} + +// braceIndices returns the first level curly brace indices from a string. +// It returns an error in case of unbalanced braces. +func braceIndices(s string) ([]int, error) { + var level, idx int + idxs := make([]int, 0) + for i := 0; i < len(s); i++ { + switch s[i] { + case '{': + if level++; level == 1 { + idx = i + } + case '}': + if level--; level == 0 { + idxs = append(idxs, idx, i+1) + } else if level < 0 { + return nil, fmt.Errorf("mux: unbalanced braces in %q", s) + } + } + } + if level != 0 { + return nil, fmt.Errorf("mux: unbalanced braces in %q", s) + } + return idxs, nil +} + +// ---------------------------------------------------------------------------- +// routeRegexpGroup +// ---------------------------------------------------------------------------- + +// routeRegexpGroup groups the route matchers that carry variables. +type routeRegexpGroup struct { + host *routeRegexp + path *routeRegexp + queries []*routeRegexp +} + +// setMatch extracts the variables from the URL once a route matches. +func (v *routeRegexpGroup) setMatch(req *http.Request, m *RouteMatch, r *Route) { + // Store host variables. + if v.host != nil { + hostVars := v.host.regexp.FindStringSubmatch(getHost(req)) + if hostVars != nil { + for k, v := range v.host.varsN { + m.Vars[v] = hostVars[k+1] + } + } + } + // Store path variables. + if v.path != nil { + pathVars := v.path.regexp.FindStringSubmatch(req.URL.Path) + if pathVars != nil { + for k, v := range v.path.varsN { + m.Vars[v] = pathVars[k+1] + } + // Check if we should redirect. + if v.path.strictSlash { + p1 := strings.HasSuffix(req.URL.Path, "/") + p2 := strings.HasSuffix(v.path.template, "/") + if p1 != p2 { + u, _ := url.Parse(req.URL.String()) + if p1 { + u.Path = u.Path[:len(u.Path)-1] + } else { + u.Path += "/" + } + m.Handler = http.RedirectHandler(u.String(), 301) + } + } + } + } + // Store query string variables. + rawQuery := req.URL.RawQuery + for _, q := range v.queries { + queryVars := q.regexp.FindStringSubmatch(rawQuery) + if queryVars != nil { + for k, v := range q.varsN { + m.Vars[v] = queryVars[k+1] + } + } + } +} + +// getHost tries its best to return the request host. +func getHost(r *http.Request) string { + if r.URL.IsAbs() { + return r.URL.Host + } + host := r.Host + // Slice off any port information. + if i := strings.Index(host, ":"); i != -1 { + host = host[:i] + } + return host + +} diff --git a/vendor/src/github.com/gorilla/mux/route.go b/vendor/src/github.com/gorilla/mux/route.go new file mode 100644 index 0000000000..c310e66bc7 --- /dev/null +++ b/vendor/src/github.com/gorilla/mux/route.go @@ -0,0 +1,524 @@ +// Copyright 2012 The Gorilla Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package mux + +import ( + "errors" + "fmt" + "net/http" + "net/url" + "strings" +) + +// Route stores information to match a request and build URLs. +type Route struct { + // Parent where the route was registered (a Router). + parent parentRoute + // Request handler for the route. + handler http.Handler + // List of matchers. + matchers []matcher + // Manager for the variables from host and path. + regexp *routeRegexpGroup + // If true, when the path pattern is "/path/", accessing "/path" will + // redirect to the former and vice versa. + strictSlash bool + // If true, this route never matches: it is only used to build URLs. + buildOnly bool + // The name used to build URLs. + name string + // Error resulted from building a route. + err error +} + +// Match matches the route against the request. +func (r *Route) Match(req *http.Request, match *RouteMatch) bool { + if r.buildOnly || r.err != nil { + return false + } + // Match everything. + for _, m := range r.matchers { + if matched := m.Match(req, match); !matched { + return false + } + } + // Yay, we have a match. Let's collect some info about it. + if match.Route == nil { + match.Route = r + } + if match.Handler == nil { + match.Handler = r.handler + } + if match.Vars == nil { + match.Vars = make(map[string]string) + } + // Set variables. + if r.regexp != nil { + r.regexp.setMatch(req, match, r) + } + return true +} + +// ---------------------------------------------------------------------------- +// Route attributes +// ---------------------------------------------------------------------------- + +// GetError returns an error resulted from building the route, if any. +func (r *Route) GetError() error { + return r.err +} + +// BuildOnly sets the route to never match: it is only used to build URLs. +func (r *Route) BuildOnly() *Route { + r.buildOnly = true + return r +} + +// Handler -------------------------------------------------------------------- + +// Handler sets a handler for the route. +func (r *Route) Handler(handler http.Handler) *Route { + if r.err == nil { + r.handler = handler + } + return r +} + +// HandlerFunc sets a handler function for the route. +func (r *Route) HandlerFunc(f func(http.ResponseWriter, *http.Request)) *Route { + return r.Handler(http.HandlerFunc(f)) +} + +// GetHandler returns the handler for the route, if any. +func (r *Route) GetHandler() http.Handler { + return r.handler +} + +// Name ----------------------------------------------------------------------- + +// Name sets the name for the route, used to build URLs. +// If the name was registered already it will be overwritten. +func (r *Route) Name(name string) *Route { + if r.name != "" { + r.err = fmt.Errorf("mux: route already has name %q, can't set %q", + r.name, name) + } + if r.err == nil { + r.name = name + r.getNamedRoutes()[name] = r + } + return r +} + +// GetName returns the name for the route, if any. +func (r *Route) GetName() string { + return r.name +} + +// ---------------------------------------------------------------------------- +// Matchers +// ---------------------------------------------------------------------------- + +// matcher types try to match a request. +type matcher interface { + Match(*http.Request, *RouteMatch) bool +} + +// addMatcher adds a matcher to the route. +func (r *Route) addMatcher(m matcher) *Route { + if r.err == nil { + r.matchers = append(r.matchers, m) + } + return r +} + +// addRegexpMatcher adds a host or path matcher and builder to a route. +func (r *Route) addRegexpMatcher(tpl string, matchHost, matchPrefix, matchQuery bool) error { + if r.err != nil { + return r.err + } + r.regexp = r.getRegexpGroup() + if !matchHost && !matchQuery { + if len(tpl) == 0 || tpl[0] != '/' { + return fmt.Errorf("mux: path must start with a slash, got %q", tpl) + } + if r.regexp.path != nil { + tpl = strings.TrimRight(r.regexp.path.template, "/") + tpl + } + } + rr, err := newRouteRegexp(tpl, matchHost, matchPrefix, matchQuery, r.strictSlash) + if err != nil { + return err + } + for _, q := range r.regexp.queries { + if err = uniqueVars(rr.varsN, q.varsN); err != nil { + return err + } + } + if matchHost { + if r.regexp.path != nil { + if err = uniqueVars(rr.varsN, r.regexp.path.varsN); err != nil { + return err + } + } + r.regexp.host = rr + } else { + if r.regexp.host != nil { + if err = uniqueVars(rr.varsN, r.regexp.host.varsN); err != nil { + return err + } + } + if matchQuery { + r.regexp.queries = append(r.regexp.queries, rr) + } else { + r.regexp.path = rr + } + } + r.addMatcher(rr) + return nil +} + +// Headers -------------------------------------------------------------------- + +// headerMatcher matches the request against header values. +type headerMatcher map[string]string + +func (m headerMatcher) Match(r *http.Request, match *RouteMatch) bool { + return matchMap(m, r.Header, true) +} + +// Headers adds a matcher for request header values. +// It accepts a sequence of key/value pairs to be matched. For example: +// +// r := mux.NewRouter() +// r.Headers("Content-Type", "application/json", +// "X-Requested-With", "XMLHttpRequest") +// +// The above route will only match if both request header values match. +// +// It the value is an empty string, it will match any value if the key is set. +func (r *Route) Headers(pairs ...string) *Route { + if r.err == nil { + var headers map[string]string + headers, r.err = mapFromPairs(pairs...) + return r.addMatcher(headerMatcher(headers)) + } + return r +} + +// Host ----------------------------------------------------------------------- + +// Host adds a matcher for the URL host. +// It accepts a template with zero or more URL variables enclosed by {}. +// Variables can define an optional regexp pattern to me matched: +// +// - {name} matches anything until the next dot. +// +// - {name:pattern} matches the given regexp pattern. +// +// For example: +// +// r := mux.NewRouter() +// r.Host("www.domain.com") +// r.Host("{subdomain}.domain.com") +// r.Host("{subdomain:[a-z]+}.domain.com") +// +// Variable names must be unique in a given route. They can be retrieved +// calling mux.Vars(request). +func (r *Route) Host(tpl string) *Route { + r.err = r.addRegexpMatcher(tpl, true, false, false) + return r +} + +// MatcherFunc ---------------------------------------------------------------- + +// MatcherFunc is the function signature used by custom matchers. +type MatcherFunc func(*http.Request, *RouteMatch) bool + +func (m MatcherFunc) Match(r *http.Request, match *RouteMatch) bool { + return m(r, match) +} + +// MatcherFunc adds a custom function to be used as request matcher. +func (r *Route) MatcherFunc(f MatcherFunc) *Route { + return r.addMatcher(f) +} + +// Methods -------------------------------------------------------------------- + +// methodMatcher matches the request against HTTP methods. +type methodMatcher []string + +func (m methodMatcher) Match(r *http.Request, match *RouteMatch) bool { + return matchInArray(m, r.Method) +} + +// Methods adds a matcher for HTTP methods. +// It accepts a sequence of one or more methods to be matched, e.g.: +// "GET", "POST", "PUT". +func (r *Route) Methods(methods ...string) *Route { + for k, v := range methods { + methods[k] = strings.ToUpper(v) + } + return r.addMatcher(methodMatcher(methods)) +} + +// Path ----------------------------------------------------------------------- + +// Path adds a matcher for the URL path. +// It accepts a template with zero or more URL variables enclosed by {}. The +// template must start with a "/". +// Variables can define an optional regexp pattern to me matched: +// +// - {name} matches anything until the next slash. +// +// - {name:pattern} matches the given regexp pattern. +// +// For example: +// +// r := mux.NewRouter() +// r.Path("/products/").Handler(ProductsHandler) +// r.Path("/products/{key}").Handler(ProductsHandler) +// r.Path("/articles/{category}/{id:[0-9]+}"). +// Handler(ArticleHandler) +// +// Variable names must be unique in a given route. They can be retrieved +// calling mux.Vars(request). +func (r *Route) Path(tpl string) *Route { + r.err = r.addRegexpMatcher(tpl, false, false, false) + return r +} + +// PathPrefix ----------------------------------------------------------------- + +// PathPrefix adds a matcher for the URL path prefix. This matches if the given +// template is a prefix of the full URL path. See Route.Path() for details on +// the tpl argument. +// +// Note that it does not treat slashes specially ("/foobar/" will be matched by +// the prefix "/foo") so you may want to use a trailing slash here. +// +// Also note that the setting of Router.StrictSlash() has no effect on routes +// with a PathPrefix matcher. +func (r *Route) PathPrefix(tpl string) *Route { + r.err = r.addRegexpMatcher(tpl, false, true, false) + return r +} + +// Query ---------------------------------------------------------------------- + +// Queries adds a matcher for URL query values. +// It accepts a sequence of key/value pairs. Values may define variables. +// For example: +// +// r := mux.NewRouter() +// r.Queries("foo", "bar", "id", "{id:[0-9]+}") +// +// The above route will only match if the URL contains the defined queries +// values, e.g.: ?foo=bar&id=42. +// +// It the value is an empty string, it will match any value if the key is set. +// +// Variables can define an optional regexp pattern to me matched: +// +// - {name} matches anything until the next slash. +// +// - {name:pattern} matches the given regexp pattern. +func (r *Route) Queries(pairs ...string) *Route { + length := len(pairs) + if length%2 != 0 { + r.err = fmt.Errorf( + "mux: number of parameters must be multiple of 2, got %v", pairs) + return nil + } + for i := 0; i < length; i += 2 { + if r.err = r.addRegexpMatcher(pairs[i]+"="+pairs[i+1], false, true, true); r.err != nil { + return r + } + } + + return r +} + +// Schemes -------------------------------------------------------------------- + +// schemeMatcher matches the request against URL schemes. +type schemeMatcher []string + +func (m schemeMatcher) Match(r *http.Request, match *RouteMatch) bool { + return matchInArray(m, r.URL.Scheme) +} + +// Schemes adds a matcher for URL schemes. +// It accepts a sequence of schemes to be matched, e.g.: "http", "https". +func (r *Route) Schemes(schemes ...string) *Route { + for k, v := range schemes { + schemes[k] = strings.ToLower(v) + } + return r.addMatcher(schemeMatcher(schemes)) +} + +// Subrouter ------------------------------------------------------------------ + +// Subrouter creates a subrouter for the route. +// +// It will test the inner routes only if the parent route matched. For example: +// +// r := mux.NewRouter() +// s := r.Host("www.domain.com").Subrouter() +// s.HandleFunc("/products/", ProductsHandler) +// s.HandleFunc("/products/{key}", ProductHandler) +// s.HandleFunc("/articles/{category}/{id:[0-9]+}"), ArticleHandler) +// +// Here, the routes registered in the subrouter won't be tested if the host +// doesn't match. +func (r *Route) Subrouter() *Router { + router := &Router{parent: r, strictSlash: r.strictSlash} + r.addMatcher(router) + return router +} + +// ---------------------------------------------------------------------------- +// URL building +// ---------------------------------------------------------------------------- + +// URL builds a URL for the route. +// +// It accepts a sequence of key/value pairs for the route variables. For +// example, given this route: +// +// r := mux.NewRouter() +// r.HandleFunc("/articles/{category}/{id:[0-9]+}", ArticleHandler). +// Name("article") +// +// ...a URL for it can be built using: +// +// url, err := r.Get("article").URL("category", "technology", "id", "42") +// +// ...which will return an url.URL with the following path: +// +// "/articles/technology/42" +// +// This also works for host variables: +// +// r := mux.NewRouter() +// r.Host("{subdomain}.domain.com"). +// HandleFunc("/articles/{category}/{id:[0-9]+}", ArticleHandler). +// Name("article") +// +// // url.String() will be "http://news.domain.com/articles/technology/42" +// url, err := r.Get("article").URL("subdomain", "news", +// "category", "technology", +// "id", "42") +// +// All variables defined in the route are required, and their values must +// conform to the corresponding patterns. +func (r *Route) URL(pairs ...string) (*url.URL, error) { + if r.err != nil { + return nil, r.err + } + if r.regexp == nil { + return nil, errors.New("mux: route doesn't have a host or path") + } + var scheme, host, path string + var err error + if r.regexp.host != nil { + // Set a default scheme. + scheme = "http" + if host, err = r.regexp.host.url(pairs...); err != nil { + return nil, err + } + } + if r.regexp.path != nil { + if path, err = r.regexp.path.url(pairs...); err != nil { + return nil, err + } + } + return &url.URL{ + Scheme: scheme, + Host: host, + Path: path, + }, nil +} + +// URLHost builds the host part of the URL for a route. See Route.URL(). +// +// The route must have a host defined. +func (r *Route) URLHost(pairs ...string) (*url.URL, error) { + if r.err != nil { + return nil, r.err + } + if r.regexp == nil || r.regexp.host == nil { + return nil, errors.New("mux: route doesn't have a host") + } + host, err := r.regexp.host.url(pairs...) + if err != nil { + return nil, err + } + return &url.URL{ + Scheme: "http", + Host: host, + }, nil +} + +// URLPath builds the path part of the URL for a route. See Route.URL(). +// +// The route must have a path defined. +func (r *Route) URLPath(pairs ...string) (*url.URL, error) { + if r.err != nil { + return nil, r.err + } + if r.regexp == nil || r.regexp.path == nil { + return nil, errors.New("mux: route doesn't have a path") + } + path, err := r.regexp.path.url(pairs...) + if err != nil { + return nil, err + } + return &url.URL{ + Path: path, + }, nil +} + +// ---------------------------------------------------------------------------- +// parentRoute +// ---------------------------------------------------------------------------- + +// parentRoute allows routes to know about parent host and path definitions. +type parentRoute interface { + getNamedRoutes() map[string]*Route + getRegexpGroup() *routeRegexpGroup +} + +// getNamedRoutes returns the map where named routes are registered. +func (r *Route) getNamedRoutes() map[string]*Route { + if r.parent == nil { + // During tests router is not always set. + r.parent = NewRouter() + } + return r.parent.getNamedRoutes() +} + +// getRegexpGroup returns regexp definitions from this route. +func (r *Route) getRegexpGroup() *routeRegexpGroup { + if r.regexp == nil { + if r.parent == nil { + // During tests router is not always set. + r.parent = NewRouter() + } + regexp := r.parent.getRegexpGroup() + if regexp == nil { + r.regexp = new(routeRegexpGroup) + } else { + // Copy. + r.regexp = &routeRegexpGroup{ + host: regexp.host, + path: regexp.path, + queries: regexp.queries, + } + } + } + return r.regexp +} diff --git a/vendor/src/github.com/hashicorp/consul/LICENSE b/vendor/src/github.com/hashicorp/consul/LICENSE new file mode 100644 index 0000000000..c33dcc7c92 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/LICENSE @@ -0,0 +1,354 @@ +Mozilla Public License, version 2.0 + +1. Definitions + +1.1. “Contributor” + + means each individual or legal entity that creates, contributes to the + creation of, or owns Covered Software. + +1.2. “Contributor Version” + + means the combination of the Contributions of others (if any) used by a + Contributor and that particular Contributor’s Contribution. + +1.3. “Contribution” + + means Covered Software of a particular Contributor. + +1.4. “Covered Software” + + means Source Code Form to which the initial Contributor has attached the + notice in Exhibit A, the Executable Form of such Source Code Form, and + Modifications of such Source Code Form, in each case including portions + thereof. + +1.5. “Incompatible With Secondary Licenses” + means + + a. that the initial Contributor has attached the notice described in + Exhibit B to the Covered Software; or + + b. that the Covered Software was made available under the terms of version + 1.1 or earlier of the License, but not also under the terms of a + Secondary License. + +1.6. “Executable Form” + + means any form of the work other than Source Code Form. + +1.7. “Larger Work” + + means a work that combines Covered Software with other material, in a separate + file or files, that is not Covered Software. + +1.8. “License” + + means this document. + +1.9. “Licensable” + + means having the right to grant, to the maximum extent possible, whether at the + time of the initial grant or subsequently, any and all of the rights conveyed by + this License. + +1.10. “Modifications” + + means any of the following: + + a. any file in Source Code Form that results from an addition to, deletion + from, or modification of the contents of Covered Software; or + + b. any new file in Source Code Form that contains any Covered Software. + +1.11. “Patent Claims” of a Contributor + + means any patent claim(s), including without limitation, method, process, + and apparatus claims, in any patent Licensable by such Contributor that + would be infringed, but for the grant of the License, by the making, + using, selling, offering for sale, having made, import, or transfer of + either its Contributions or its Contributor Version. + +1.12. “Secondary License” + + means either the GNU General Public License, Version 2.0, the GNU Lesser + General Public License, Version 2.1, the GNU Affero General Public + License, Version 3.0, or any later versions of those licenses. + +1.13. “Source Code Form” + + means the form of the work preferred for making modifications. + +1.14. “You” (or “Your”) + + means an individual or a legal entity exercising rights under this + License. For legal entities, “You” includes any entity that controls, is + controlled by, or is under common control with You. For purposes of this + definition, “control” means (a) the power, direct or indirect, to cause + the direction or management of such entity, whether by contract or + otherwise, or (b) ownership of more than fifty percent (50%) of the + outstanding shares or beneficial ownership of such entity. + + +2. License Grants and Conditions + +2.1. Grants + + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + + a. under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or as + part of a Larger Work; and + + b. under Patent Claims of such Contributor to make, use, sell, offer for + sale, have made, import, and otherwise transfer either its Contributions + or its Contributor Version. + +2.2. Effective Date + + The licenses granted in Section 2.1 with respect to any Contribution become + effective for each Contribution on the date the Contributor first distributes + such Contribution. + +2.3. Limitations on Grant Scope + + The licenses granted in this Section 2 are the only rights granted under this + License. No additional rights or licenses will be implied from the distribution + or licensing of Covered Software under this License. Notwithstanding Section + 2.1(b) above, no patent license is granted by a Contributor: + + a. for any code that a Contributor has removed from Covered Software; or + + b. for infringements caused by: (i) Your and any other third party’s + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + + c. under Patent Claims infringed by Covered Software in the absence of its + Contributions. + + This License does not grant any rights in the trademarks, service marks, or + logos of any Contributor (except as may be necessary to comply with the + notice requirements in Section 3.4). + +2.4. Subsequent Licenses + + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this License + (see Section 10.2) or under the terms of a Secondary License (if permitted + under the terms of Section 3.3). + +2.5. Representation + + Each Contributor represents that the Contributor believes its Contributions + are its original creation(s) or it has sufficient rights to grant the + rights to its Contributions conveyed by this License. + +2.6. Fair Use + + This License is not intended to limit any rights You have under applicable + copyright doctrines of fair use, fair dealing, or other equivalents. + +2.7. Conditions + + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in + Section 2.1. + + +3. Responsibilities + +3.1. Distribution of Source Form + + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under the + terms of this License. You must inform recipients that the Source Code Form + of the Covered Software is governed by the terms of this License, and how + they can obtain a copy of this License. You may not attempt to alter or + restrict the recipients’ rights in the Source Code Form. + +3.2. Distribution of Executable Form + + If You distribute Covered Software in Executable Form then: + + a. such Covered Software must also be made available in Source Code Form, + as described in Section 3.1, and You must inform recipients of the + Executable Form how they can obtain a copy of such Source Code Form by + reasonable means in a timely manner, at a charge no more than the cost + of distribution to the recipient; and + + b. You may distribute such Executable Form under the terms of this License, + or sublicense it under different terms, provided that the license for + the Executable Form does not attempt to limit or alter the recipients’ + rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for the + Covered Software. If the Larger Work is a combination of Covered Software + with a work governed by one or more Secondary Licenses, and the Covered + Software is not Incompatible With Secondary Licenses, this License permits + You to additionally distribute such Covered Software under the terms of + such Secondary License(s), so that the recipient of the Larger Work may, at + their option, further distribute the Covered Software under the terms of + either this License or such Secondary License(s). + +3.4. Notices + + You may not remove or alter the substance of any license notices (including + copyright notices, patent notices, disclaimers of warranty, or limitations + of liability) contained within the Source Code Form of the Covered + Software, except that You may alter any license notices to the extent + required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on behalf + of any Contributor. You must make it absolutely clear that any such + warranty, support, indemnity, or liability obligation is offered by You + alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + +4. Inability to Comply Due to Statute or Regulation + + If it is impossible for You to comply with any of the terms of this License + with respect to some or all of the Covered Software due to statute, judicial + order, or regulation then You must: (a) comply with the terms of this License + to the maximum extent possible; and (b) describe the limitations and the code + they affect. Such description must be placed in a text file included with all + distributions of the Covered Software under this License. Except to the + extent prohibited by statute or regulation, such description must be + sufficiently detailed for a recipient of ordinary skill to be able to + understand it. + +5. Termination + +5.1. The rights granted under this License will terminate automatically if You + fail to comply with any of its terms. However, if You become compliant, + then the rights granted under this License from a particular Contributor + are reinstated (a) provisionally, unless and until such Contributor + explicitly and finally terminates Your grants, and (b) on an ongoing basis, + if such Contributor fails to notify You of the non-compliance by some + reasonable means prior to 60 days after You have come back into compliance. + Moreover, Your grants from a particular Contributor are reinstated on an + ongoing basis if such Contributor notifies You of the non-compliance by + some reasonable means, this is the first time You have received notice of + non-compliance with this License from such Contributor, and You become + compliant prior to 30 days after Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, counter-claims, + and cross-claims) alleging that a Contributor Version directly or + indirectly infringes any patent, then the rights granted to You by any and + all Contributors for the Covered Software under Section 2.1 of this License + shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user + license agreements (excluding distributors and resellers) which have been + validly granted by You or Your distributors under this License prior to + termination shall survive termination. + +6. Disclaimer of Warranty + + Covered Software is provided under this License on an “as is” basis, without + warranty of any kind, either expressed, implied, or statutory, including, + without limitation, warranties that the Covered Software is free of defects, + merchantable, fit for a particular purpose or non-infringing. The entire + risk as to the quality and performance of the Covered Software is with You. + Should any Covered Software prove defective in any respect, You (not any + Contributor) assume the cost of any necessary servicing, repair, or + correction. This disclaimer of warranty constitutes an essential part of this + License. No use of any Covered Software is authorized under this License + except under this disclaimer. + +7. Limitation of Liability + + Under no circumstances and under no legal theory, whether tort (including + negligence), contract, or otherwise, shall any Contributor, or anyone who + distributes Covered Software as permitted above, be liable to You for any + direct, indirect, special, incidental, or consequential damages of any + character including, without limitation, damages for lost profits, loss of + goodwill, work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses, even if such party shall have been + informed of the possibility of such damages. This limitation of liability + shall not apply to liability for death or personal injury resulting from such + party’s negligence to the extent applicable law prohibits such limitation. + Some jurisdictions do not allow the exclusion or limitation of incidental or + consequential damages, so this exclusion and limitation may not apply to You. + +8. Litigation + + Any litigation relating to this License may be brought only in the courts of + a jurisdiction where the defendant maintains its principal place of business + and such litigation shall be governed by laws of that jurisdiction, without + reference to its conflict-of-law provisions. Nothing in this Section shall + prevent a party’s ability to bring cross-claims or counter-claims. + +9. Miscellaneous + + This License represents the complete agreement concerning the subject matter + hereof. If any provision of this License is held to be unenforceable, such + provision shall be reformed only to the extent necessary to make it + enforceable. Any law or regulation which provides that the language of a + contract shall be construed against the drafter shall not be used to construe + this License against a Contributor. + + +10. Versions of the License + +10.1. New Versions + + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + +10.2. Effect of New Versions + + You may distribute the Covered Software under the terms of the version of + the License under which You originally received the Covered Software, or + under the terms of any subsequent version published by the license + steward. + +10.3. Modified Versions + + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a modified + version of this License if you rename the license and remove any + references to the name of the license steward (except to note that such + modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses + If You choose to distribute Source Code Form that is Incompatible With + Secondary Licenses under the terms of this version of the License, the + notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice + + This Source Code Form is subject to the + terms of the Mozilla Public License, v. + 2.0. If a copy of the MPL was not + distributed with this file, You can + obtain one at + http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular file, then +You may include the notice in a location (such as a LICENSE file in a relevant +directory) where a recipient would be likely to look for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - “Incompatible With Secondary Licenses” Notice + + This Source Code Form is “Incompatible + With Secondary Licenses”, as defined by + the Mozilla Public License, v. 2.0. + diff --git a/vendor/src/github.com/hashicorp/consul/api/README.md b/vendor/src/github.com/hashicorp/consul/api/README.md new file mode 100644 index 0000000000..bce2ebb516 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/README.md @@ -0,0 +1,39 @@ +Consul API client +================= + +This package provides the `api` package which attempts to +provide programmatic access to the full Consul API. + +Currently, all of the Consul APIs included in version 0.3 are supported. + +Documentation +============= + +The full documentation is available on [Godoc](http://godoc.org/github.com/hashicorp/consul/api) + +Usage +===== + +Below is an example of using the Consul client: + +```go +// Get a new client, with KV endpoints +client, _ := api.NewClient(api.DefaultConfig()) +kv := client.KV() + +// PUT a new KV pair +p := &api.KVPair{Key: "foo", Value: []byte("test")} +_, err := kv.Put(p, nil) +if err != nil { + panic(err) +} + +// Lookup the pair +pair, _, err := kv.Get("foo", nil) +if err != nil { + panic(err) +} +fmt.Printf("KV: %v", pair) + +``` + diff --git a/vendor/src/github.com/hashicorp/consul/api/acl.go b/vendor/src/github.com/hashicorp/consul/api/acl.go new file mode 100644 index 0000000000..c3fb0d53aa --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/acl.go @@ -0,0 +1,140 @@ +package api + +const ( + // ACLCLientType is the client type token + ACLClientType = "client" + + // ACLManagementType is the management type token + ACLManagementType = "management" +) + +// ACLEntry is used to represent an ACL entry +type ACLEntry struct { + CreateIndex uint64 + ModifyIndex uint64 + ID string + Name string + Type string + Rules string +} + +// ACL can be used to query the ACL endpoints +type ACL struct { + c *Client +} + +// ACL returns a handle to the ACL endpoints +func (c *Client) ACL() *ACL { + return &ACL{c} +} + +// Create is used to generate a new token with the given parameters +func (a *ACL) Create(acl *ACLEntry, q *WriteOptions) (string, *WriteMeta, error) { + r := a.c.newRequest("PUT", "/v1/acl/create") + r.setWriteOptions(q) + r.obj = acl + rtt, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return "", nil, err + } + defer resp.Body.Close() + + wm := &WriteMeta{RequestTime: rtt} + var out struct{ ID string } + if err := decodeBody(resp, &out); err != nil { + return "", nil, err + } + return out.ID, wm, nil +} + +// Update is used to update the rules of an existing token +func (a *ACL) Update(acl *ACLEntry, q *WriteOptions) (*WriteMeta, error) { + r := a.c.newRequest("PUT", "/v1/acl/update") + r.setWriteOptions(q) + r.obj = acl + rtt, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + wm := &WriteMeta{RequestTime: rtt} + return wm, nil +} + +// Destroy is used to destroy a given ACL token ID +func (a *ACL) Destroy(id string, q *WriteOptions) (*WriteMeta, error) { + r := a.c.newRequest("PUT", "/v1/acl/destroy/"+id) + r.setWriteOptions(q) + rtt, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, err + } + resp.Body.Close() + + wm := &WriteMeta{RequestTime: rtt} + return wm, nil +} + +// Clone is used to return a new token cloned from an existing one +func (a *ACL) Clone(id string, q *WriteOptions) (string, *WriteMeta, error) { + r := a.c.newRequest("PUT", "/v1/acl/clone/"+id) + r.setWriteOptions(q) + rtt, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return "", nil, err + } + defer resp.Body.Close() + + wm := &WriteMeta{RequestTime: rtt} + var out struct{ ID string } + if err := decodeBody(resp, &out); err != nil { + return "", nil, err + } + return out.ID, wm, nil +} + +// Info is used to query for information about an ACL token +func (a *ACL) Info(id string, q *QueryOptions) (*ACLEntry, *QueryMeta, error) { + r := a.c.newRequest("GET", "/v1/acl/info/"+id) + r.setQueryOptions(q) + rtt, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var entries []*ACLEntry + if err := decodeBody(resp, &entries); err != nil { + return nil, nil, err + } + if len(entries) > 0 { + return entries[0], qm, nil + } + return nil, qm, nil +} + +// List is used to get all the ACL tokens +func (a *ACL) List(q *QueryOptions) ([]*ACLEntry, *QueryMeta, error) { + r := a.c.newRequest("GET", "/v1/acl/list") + r.setQueryOptions(q) + rtt, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var entries []*ACLEntry + if err := decodeBody(resp, &entries); err != nil { + return nil, nil, err + } + return entries, qm, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/agent.go b/vendor/src/github.com/hashicorp/consul/api/agent.go new file mode 100644 index 0000000000..e56a18dcd2 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/agent.go @@ -0,0 +1,334 @@ +package api + +import ( + "fmt" +) + +// AgentCheck represents a check known to the agent +type AgentCheck struct { + Node string + CheckID string + Name string + Status string + Notes string + Output string + ServiceID string + ServiceName string +} + +// AgentService represents a service known to the agent +type AgentService struct { + ID string + Service string + Tags []string + Port int + Address string +} + +// AgentMember represents a cluster member known to the agent +type AgentMember struct { + Name string + Addr string + Port uint16 + Tags map[string]string + Status int + ProtocolMin uint8 + ProtocolMax uint8 + ProtocolCur uint8 + DelegateMin uint8 + DelegateMax uint8 + DelegateCur uint8 +} + +// AgentServiceRegistration is used to register a new service +type AgentServiceRegistration struct { + ID string `json:",omitempty"` + Name string `json:",omitempty"` + Tags []string `json:",omitempty"` + Port int `json:",omitempty"` + Address string `json:",omitempty"` + Check *AgentServiceCheck + Checks AgentServiceChecks +} + +// AgentCheckRegistration is used to register a new check +type AgentCheckRegistration struct { + ID string `json:",omitempty"` + Name string `json:",omitempty"` + Notes string `json:",omitempty"` + ServiceID string `json:",omitempty"` + AgentServiceCheck +} + +// AgentServiceCheck is used to create an associated +// check for a service +type AgentServiceCheck struct { + Script string `json:",omitempty"` + Interval string `json:",omitempty"` + Timeout string `json:",omitempty"` + TTL string `json:",omitempty"` + HTTP string `json:",omitempty"` + Status string `json:",omitempty"` +} +type AgentServiceChecks []*AgentServiceCheck + +// Agent can be used to query the Agent endpoints +type Agent struct { + c *Client + + // cache the node name + nodeName string +} + +// Agent returns a handle to the agent endpoints +func (c *Client) Agent() *Agent { + return &Agent{c: c} +} + +// Self is used to query the agent we are speaking to for +// information about itself +func (a *Agent) Self() (map[string]map[string]interface{}, error) { + r := a.c.newRequest("GET", "/v1/agent/self") + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + var out map[string]map[string]interface{} + if err := decodeBody(resp, &out); err != nil { + return nil, err + } + return out, nil +} + +// NodeName is used to get the node name of the agent +func (a *Agent) NodeName() (string, error) { + if a.nodeName != "" { + return a.nodeName, nil + } + info, err := a.Self() + if err != nil { + return "", err + } + name := info["Config"]["NodeName"].(string) + a.nodeName = name + return name, nil +} + +// Checks returns the locally registered checks +func (a *Agent) Checks() (map[string]*AgentCheck, error) { + r := a.c.newRequest("GET", "/v1/agent/checks") + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + var out map[string]*AgentCheck + if err := decodeBody(resp, &out); err != nil { + return nil, err + } + return out, nil +} + +// Services returns the locally registered services +func (a *Agent) Services() (map[string]*AgentService, error) { + r := a.c.newRequest("GET", "/v1/agent/services") + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + var out map[string]*AgentService + if err := decodeBody(resp, &out); err != nil { + return nil, err + } + return out, nil +} + +// Members returns the known gossip members. The WAN +// flag can be used to query a server for WAN members. +func (a *Agent) Members(wan bool) ([]*AgentMember, error) { + r := a.c.newRequest("GET", "/v1/agent/members") + if wan { + r.params.Set("wan", "1") + } + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + var out []*AgentMember + if err := decodeBody(resp, &out); err != nil { + return nil, err + } + return out, nil +} + +// ServiceRegister is used to register a new service with +// the local agent +func (a *Agent) ServiceRegister(service *AgentServiceRegistration) error { + r := a.c.newRequest("PUT", "/v1/agent/service/register") + r.obj = service + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// ServiceDeregister is used to deregister a service with +// the local agent +func (a *Agent) ServiceDeregister(serviceID string) error { + r := a.c.newRequest("PUT", "/v1/agent/service/deregister/"+serviceID) + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// PassTTL is used to set a TTL check to the passing state +func (a *Agent) PassTTL(checkID, note string) error { + return a.UpdateTTL(checkID, note, "pass") +} + +// WarnTTL is used to set a TTL check to the warning state +func (a *Agent) WarnTTL(checkID, note string) error { + return a.UpdateTTL(checkID, note, "warn") +} + +// FailTTL is used to set a TTL check to the failing state +func (a *Agent) FailTTL(checkID, note string) error { + return a.UpdateTTL(checkID, note, "fail") +} + +// UpdateTTL is used to update the TTL of a check +func (a *Agent) UpdateTTL(checkID, note, status string) error { + switch status { + case "pass": + case "warn": + case "fail": + default: + return fmt.Errorf("Invalid status: %s", status) + } + endpoint := fmt.Sprintf("/v1/agent/check/%s/%s", status, checkID) + r := a.c.newRequest("PUT", endpoint) + r.params.Set("note", note) + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// CheckRegister is used to register a new check with +// the local agent +func (a *Agent) CheckRegister(check *AgentCheckRegistration) error { + r := a.c.newRequest("PUT", "/v1/agent/check/register") + r.obj = check + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// CheckDeregister is used to deregister a check with +// the local agent +func (a *Agent) CheckDeregister(checkID string) error { + r := a.c.newRequest("PUT", "/v1/agent/check/deregister/"+checkID) + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// Join is used to instruct the agent to attempt a join to +// another cluster member +func (a *Agent) Join(addr string, wan bool) error { + r := a.c.newRequest("PUT", "/v1/agent/join/"+addr) + if wan { + r.params.Set("wan", "1") + } + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// ForceLeave is used to have the agent eject a failed node +func (a *Agent) ForceLeave(node string) error { + r := a.c.newRequest("PUT", "/v1/agent/force-leave/"+node) + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// EnableServiceMaintenance toggles service maintenance mode on +// for the given service ID. +func (a *Agent) EnableServiceMaintenance(serviceID, reason string) error { + r := a.c.newRequest("PUT", "/v1/agent/service/maintenance/"+serviceID) + r.params.Set("enable", "true") + r.params.Set("reason", reason) + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// DisableServiceMaintenance toggles service maintenance mode off +// for the given service ID. +func (a *Agent) DisableServiceMaintenance(serviceID string) error { + r := a.c.newRequest("PUT", "/v1/agent/service/maintenance/"+serviceID) + r.params.Set("enable", "false") + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// EnableNodeMaintenance toggles node maintenance mode on for the +// agent we are connected to. +func (a *Agent) EnableNodeMaintenance(reason string) error { + r := a.c.newRequest("PUT", "/v1/agent/maintenance") + r.params.Set("enable", "true") + r.params.Set("reason", reason) + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} + +// DisableNodeMaintenance toggles node maintenance mode off for the +// agent we are connected to. +func (a *Agent) DisableNodeMaintenance() error { + r := a.c.newRequest("PUT", "/v1/agent/maintenance") + r.params.Set("enable", "false") + _, resp, err := requireOK(a.c.doRequest(r)) + if err != nil { + return err + } + resp.Body.Close() + return nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/api.go b/vendor/src/github.com/hashicorp/consul/api/api.go new file mode 100644 index 0000000000..8fe2ead048 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/api.go @@ -0,0 +1,442 @@ +package api + +import ( + "bytes" + "crypto/tls" + "encoding/json" + "fmt" + "io" + "log" + "net" + "net/http" + "net/url" + "os" + "strconv" + "strings" + "time" +) + +// QueryOptions are used to parameterize a query +type QueryOptions struct { + // Providing a datacenter overwrites the DC provided + // by the Config + Datacenter string + + // AllowStale allows any Consul server (non-leader) to service + // a read. This allows for lower latency and higher throughput + AllowStale bool + + // RequireConsistent forces the read to be fully consistent. + // This is more expensive but prevents ever performing a stale + // read. + RequireConsistent bool + + // WaitIndex is used to enable a blocking query. Waits + // until the timeout or the next index is reached + WaitIndex uint64 + + // WaitTime is used to bound the duration of a wait. + // Defaults to that of the Config, but can be overriden. + WaitTime time.Duration + + // Token is used to provide a per-request ACL token + // which overrides the agent's default token. + Token string +} + +// WriteOptions are used to parameterize a write +type WriteOptions struct { + // Providing a datacenter overwrites the DC provided + // by the Config + Datacenter string + + // Token is used to provide a per-request ACL token + // which overrides the agent's default token. + Token string +} + +// QueryMeta is used to return meta data about a query +type QueryMeta struct { + // LastIndex. This can be used as a WaitIndex to perform + // a blocking query + LastIndex uint64 + + // Time of last contact from the leader for the + // server servicing the request + LastContact time.Duration + + // Is there a known leader + KnownLeader bool + + // How long did the request take + RequestTime time.Duration +} + +// WriteMeta is used to return meta data about a write +type WriteMeta struct { + // How long did the request take + RequestTime time.Duration +} + +// HttpBasicAuth is used to authenticate http client with HTTP Basic Authentication +type HttpBasicAuth struct { + // Username to use for HTTP Basic Authentication + Username string + + // Password to use for HTTP Basic Authentication + Password string +} + +// Config is used to configure the creation of a client +type Config struct { + // Address is the address of the Consul server + Address string + + // Scheme is the URI scheme for the Consul server + Scheme string + + // Datacenter to use. If not provided, the default agent datacenter is used. + Datacenter string + + // HttpClient is the client to use. Default will be + // used if not provided. + HttpClient *http.Client + + // HttpAuth is the auth info to use for http access. + HttpAuth *HttpBasicAuth + + // WaitTime limits how long a Watch will block. If not provided, + // the agent default values will be used. + WaitTime time.Duration + + // Token is used to provide a per-request ACL token + // which overrides the agent's default token. + Token string +} + +// DefaultConfig returns a default configuration for the client +func DefaultConfig() *Config { + config := &Config{ + Address: "127.0.0.1:8500", + Scheme: "http", + HttpClient: http.DefaultClient, + } + + if addr := os.Getenv("CONSUL_HTTP_ADDR"); addr != "" { + config.Address = addr + } + + if token := os.Getenv("CONSUL_HTTP_TOKEN"); token != "" { + config.Token = token + } + + if auth := os.Getenv("CONSUL_HTTP_AUTH"); auth != "" { + var username, password string + if strings.Contains(auth, ":") { + split := strings.SplitN(auth, ":", 2) + username = split[0] + password = split[1] + } else { + username = auth + } + + config.HttpAuth = &HttpBasicAuth{ + Username: username, + Password: password, + } + } + + if ssl := os.Getenv("CONSUL_HTTP_SSL"); ssl != "" { + enabled, err := strconv.ParseBool(ssl) + if err != nil { + log.Printf("[WARN] client: could not parse CONSUL_HTTP_SSL: %s", err) + } + + if enabled { + config.Scheme = "https" + } + } + + if verify := os.Getenv("CONSUL_HTTP_SSL_VERIFY"); verify != "" { + doVerify, err := strconv.ParseBool(verify) + if err != nil { + log.Printf("[WARN] client: could not parse CONSUL_HTTP_SSL_VERIFY: %s", err) + } + + if !doVerify { + config.HttpClient.Transport = &http.Transport{ + TLSClientConfig: &tls.Config{ + InsecureSkipVerify: true, + }, + } + } + } + + return config +} + +// Client provides a client to the Consul API +type Client struct { + config Config +} + +// NewClient returns a new client +func NewClient(config *Config) (*Client, error) { + // bootstrap the config + defConfig := DefaultConfig() + + if len(config.Address) == 0 { + config.Address = defConfig.Address + } + + if len(config.Scheme) == 0 { + config.Scheme = defConfig.Scheme + } + + if config.HttpClient == nil { + config.HttpClient = defConfig.HttpClient + } + + if parts := strings.SplitN(config.Address, "unix://", 2); len(parts) == 2 { + config.HttpClient = &http.Client{ + Transport: &http.Transport{ + Dial: func(_, _ string) (net.Conn, error) { + return net.Dial("unix", parts[1]) + }, + }, + } + config.Address = parts[1] + } + + client := &Client{ + config: *config, + } + return client, nil +} + +// request is used to help build up a request +type request struct { + config *Config + method string + url *url.URL + params url.Values + body io.Reader + obj interface{} +} + +// setQueryOptions is used to annotate the request with +// additional query options +func (r *request) setQueryOptions(q *QueryOptions) { + if q == nil { + return + } + if q.Datacenter != "" { + r.params.Set("dc", q.Datacenter) + } + if q.AllowStale { + r.params.Set("stale", "") + } + if q.RequireConsistent { + r.params.Set("consistent", "") + } + if q.WaitIndex != 0 { + r.params.Set("index", strconv.FormatUint(q.WaitIndex, 10)) + } + if q.WaitTime != 0 { + r.params.Set("wait", durToMsec(q.WaitTime)) + } + if q.Token != "" { + r.params.Set("token", q.Token) + } +} + +// durToMsec converts a duration to a millisecond specified string +func durToMsec(dur time.Duration) string { + return fmt.Sprintf("%dms", dur/time.Millisecond) +} + +// setWriteOptions is used to annotate the request with +// additional write options +func (r *request) setWriteOptions(q *WriteOptions) { + if q == nil { + return + } + if q.Datacenter != "" { + r.params.Set("dc", q.Datacenter) + } + if q.Token != "" { + r.params.Set("token", q.Token) + } +} + +// toHTTP converts the request to an HTTP request +func (r *request) toHTTP() (*http.Request, error) { + // Encode the query parameters + r.url.RawQuery = r.params.Encode() + + // Check if we should encode the body + if r.body == nil && r.obj != nil { + if b, err := encodeBody(r.obj); err != nil { + return nil, err + } else { + r.body = b + } + } + + // Create the HTTP request + req, err := http.NewRequest(r.method, r.url.RequestURI(), r.body) + if err != nil { + return nil, err + } + + req.URL.Host = r.url.Host + req.URL.Scheme = r.url.Scheme + req.Host = r.url.Host + + // Setup auth + if r.config.HttpAuth != nil { + req.SetBasicAuth(r.config.HttpAuth.Username, r.config.HttpAuth.Password) + } + + return req, nil +} + +// newRequest is used to create a new request +func (c *Client) newRequest(method, path string) *request { + r := &request{ + config: &c.config, + method: method, + url: &url.URL{ + Scheme: c.config.Scheme, + Host: c.config.Address, + Path: path, + }, + params: make(map[string][]string), + } + if c.config.Datacenter != "" { + r.params.Set("dc", c.config.Datacenter) + } + if c.config.WaitTime != 0 { + r.params.Set("wait", durToMsec(r.config.WaitTime)) + } + if c.config.Token != "" { + r.params.Set("token", r.config.Token) + } + return r +} + +// doRequest runs a request with our client +func (c *Client) doRequest(r *request) (time.Duration, *http.Response, error) { + req, err := r.toHTTP() + if err != nil { + return 0, nil, err + } + start := time.Now() + resp, err := c.config.HttpClient.Do(req) + diff := time.Now().Sub(start) + return diff, resp, err +} + +// Query is used to do a GET request against an endpoint +// and deserialize the response into an interface using +// standard Consul conventions. +func (c *Client) query(endpoint string, out interface{}, q *QueryOptions) (*QueryMeta, error) { + r := c.newRequest("GET", endpoint) + r.setQueryOptions(q) + rtt, resp, err := requireOK(c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + if err := decodeBody(resp, out); err != nil { + return nil, err + } + return qm, nil +} + +// write is used to do a PUT request against an endpoint +// and serialize/deserialized using the standard Consul conventions. +func (c *Client) write(endpoint string, in, out interface{}, q *WriteOptions) (*WriteMeta, error) { + r := c.newRequest("PUT", endpoint) + r.setWriteOptions(q) + r.obj = in + rtt, resp, err := requireOK(c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + wm := &WriteMeta{RequestTime: rtt} + if out != nil { + if err := decodeBody(resp, &out); err != nil { + return nil, err + } + } + return wm, nil +} + +// parseQueryMeta is used to help parse query meta-data +func parseQueryMeta(resp *http.Response, q *QueryMeta) error { + header := resp.Header + + // Parse the X-Consul-Index + index, err := strconv.ParseUint(header.Get("X-Consul-Index"), 10, 64) + if err != nil { + return fmt.Errorf("Failed to parse X-Consul-Index: %v", err) + } + q.LastIndex = index + + // Parse the X-Consul-LastContact + last, err := strconv.ParseUint(header.Get("X-Consul-LastContact"), 10, 64) + if err != nil { + return fmt.Errorf("Failed to parse X-Consul-LastContact: %v", err) + } + q.LastContact = time.Duration(last) * time.Millisecond + + // Parse the X-Consul-KnownLeader + switch header.Get("X-Consul-KnownLeader") { + case "true": + q.KnownLeader = true + default: + q.KnownLeader = false + } + return nil +} + +// decodeBody is used to JSON decode a body +func decodeBody(resp *http.Response, out interface{}) error { + dec := json.NewDecoder(resp.Body) + return dec.Decode(out) +} + +// encodeBody is used to encode a request body +func encodeBody(obj interface{}) (io.Reader, error) { + buf := bytes.NewBuffer(nil) + enc := json.NewEncoder(buf) + if err := enc.Encode(obj); err != nil { + return nil, err + } + return buf, nil +} + +// requireOK is used to wrap doRequest and check for a 200 +func requireOK(d time.Duration, resp *http.Response, e error) (time.Duration, *http.Response, error) { + if e != nil { + if resp != nil { + resp.Body.Close() + } + return d, nil, e + } + if resp.StatusCode != 200 { + var buf bytes.Buffer + io.Copy(&buf, resp.Body) + resp.Body.Close() + return d, nil, fmt.Errorf("Unexpected response code: %d (%s)", resp.StatusCode, buf.Bytes()) + } + return d, resp, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/catalog.go b/vendor/src/github.com/hashicorp/consul/api/catalog.go new file mode 100644 index 0000000000..cf64bd9091 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/catalog.go @@ -0,0 +1,182 @@ +package api + +type Node struct { + Node string + Address string +} + +type CatalogService struct { + Node string + Address string + ServiceID string + ServiceName string + ServiceAddress string + ServiceTags []string + ServicePort int +} + +type CatalogNode struct { + Node *Node + Services map[string]*AgentService +} + +type CatalogRegistration struct { + Node string + Address string + Datacenter string + Service *AgentService + Check *AgentCheck +} + +type CatalogDeregistration struct { + Node string + Address string + Datacenter string + ServiceID string + CheckID string +} + +// Catalog can be used to query the Catalog endpoints +type Catalog struct { + c *Client +} + +// Catalog returns a handle to the catalog endpoints +func (c *Client) Catalog() *Catalog { + return &Catalog{c} +} + +func (c *Catalog) Register(reg *CatalogRegistration, q *WriteOptions) (*WriteMeta, error) { + r := c.c.newRequest("PUT", "/v1/catalog/register") + r.setWriteOptions(q) + r.obj = reg + rtt, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, err + } + resp.Body.Close() + + wm := &WriteMeta{} + wm.RequestTime = rtt + + return wm, nil +} + +func (c *Catalog) Deregister(dereg *CatalogDeregistration, q *WriteOptions) (*WriteMeta, error) { + r := c.c.newRequest("PUT", "/v1/catalog/deregister") + r.setWriteOptions(q) + r.obj = dereg + rtt, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, err + } + resp.Body.Close() + + wm := &WriteMeta{} + wm.RequestTime = rtt + + return wm, nil +} + +// Datacenters is used to query for all the known datacenters +func (c *Catalog) Datacenters() ([]string, error) { + r := c.c.newRequest("GET", "/v1/catalog/datacenters") + _, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + var out []string + if err := decodeBody(resp, &out); err != nil { + return nil, err + } + return out, nil +} + +// Nodes is used to query all the known nodes +func (c *Catalog) Nodes(q *QueryOptions) ([]*Node, *QueryMeta, error) { + r := c.c.newRequest("GET", "/v1/catalog/nodes") + r.setQueryOptions(q) + rtt, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out []*Node + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} + +// Services is used to query for all known services +func (c *Catalog) Services(q *QueryOptions) (map[string][]string, *QueryMeta, error) { + r := c.c.newRequest("GET", "/v1/catalog/services") + r.setQueryOptions(q) + rtt, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out map[string][]string + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} + +// Service is used to query catalog entries for a given service +func (c *Catalog) Service(service, tag string, q *QueryOptions) ([]*CatalogService, *QueryMeta, error) { + r := c.c.newRequest("GET", "/v1/catalog/service/"+service) + r.setQueryOptions(q) + if tag != "" { + r.params.Set("tag", tag) + } + rtt, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out []*CatalogService + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} + +// Node is used to query for service information about a single node +func (c *Catalog) Node(node string, q *QueryOptions) (*CatalogNode, *QueryMeta, error) { + r := c.c.newRequest("GET", "/v1/catalog/node/"+node) + r.setQueryOptions(q) + rtt, resp, err := requireOK(c.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out *CatalogNode + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/event.go b/vendor/src/github.com/hashicorp/consul/api/event.go new file mode 100644 index 0000000000..85b5b069b0 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/event.go @@ -0,0 +1,104 @@ +package api + +import ( + "bytes" + "strconv" +) + +// Event can be used to query the Event endpoints +type Event struct { + c *Client +} + +// UserEvent represents an event that was fired by the user +type UserEvent struct { + ID string + Name string + Payload []byte + NodeFilter string + ServiceFilter string + TagFilter string + Version int + LTime uint64 +} + +// Event returns a handle to the event endpoints +func (c *Client) Event() *Event { + return &Event{c} +} + +// Fire is used to fire a new user event. Only the Name, Payload and Filters +// are respected. This returns the ID or an associated error. Cross DC requests +// are supported. +func (e *Event) Fire(params *UserEvent, q *WriteOptions) (string, *WriteMeta, error) { + r := e.c.newRequest("PUT", "/v1/event/fire/"+params.Name) + r.setWriteOptions(q) + if params.NodeFilter != "" { + r.params.Set("node", params.NodeFilter) + } + if params.ServiceFilter != "" { + r.params.Set("service", params.ServiceFilter) + } + if params.TagFilter != "" { + r.params.Set("tag", params.TagFilter) + } + if params.Payload != nil { + r.body = bytes.NewReader(params.Payload) + } + + rtt, resp, err := requireOK(e.c.doRequest(r)) + if err != nil { + return "", nil, err + } + defer resp.Body.Close() + + wm := &WriteMeta{RequestTime: rtt} + var out UserEvent + if err := decodeBody(resp, &out); err != nil { + return "", nil, err + } + return out.ID, wm, nil +} + +// List is used to get the most recent events an agent has received. +// This list can be optionally filtered by the name. This endpoint supports +// quasi-blocking queries. The index is not monotonic, nor does it provide provide +// LastContact or KnownLeader. +func (e *Event) List(name string, q *QueryOptions) ([]*UserEvent, *QueryMeta, error) { + r := e.c.newRequest("GET", "/v1/event/list") + r.setQueryOptions(q) + if name != "" { + r.params.Set("name", name) + } + rtt, resp, err := requireOK(e.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var entries []*UserEvent + if err := decodeBody(resp, &entries); err != nil { + return nil, nil, err + } + return entries, qm, nil +} + +// IDToIndex is a bit of a hack. This simulates the index generation to +// convert an event ID into a WaitIndex. +func (e *Event) IDToIndex(uuid string) uint64 { + lower := uuid[0:8] + uuid[9:13] + uuid[14:18] + upper := uuid[19:23] + uuid[24:36] + lowVal, err := strconv.ParseUint(lower, 16, 64) + if err != nil { + panic("Failed to convert " + lower) + } + highVal, err := strconv.ParseUint(upper, 16, 64) + if err != nil { + panic("Failed to convert " + upper) + } + return lowVal ^ highVal +} diff --git a/vendor/src/github.com/hashicorp/consul/api/health.go b/vendor/src/github.com/hashicorp/consul/api/health.go new file mode 100644 index 0000000000..02b161e28e --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/health.go @@ -0,0 +1,136 @@ +package api + +import ( + "fmt" +) + +// HealthCheck is used to represent a single check +type HealthCheck struct { + Node string + CheckID string + Name string + Status string + Notes string + Output string + ServiceID string + ServiceName string +} + +// ServiceEntry is used for the health service endpoint +type ServiceEntry struct { + Node *Node + Service *AgentService + Checks []*HealthCheck +} + +// Health can be used to query the Health endpoints +type Health struct { + c *Client +} + +// Health returns a handle to the health endpoints +func (c *Client) Health() *Health { + return &Health{c} +} + +// Node is used to query for checks belonging to a given node +func (h *Health) Node(node string, q *QueryOptions) ([]*HealthCheck, *QueryMeta, error) { + r := h.c.newRequest("GET", "/v1/health/node/"+node) + r.setQueryOptions(q) + rtt, resp, err := requireOK(h.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out []*HealthCheck + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} + +// Checks is used to return the checks associated with a service +func (h *Health) Checks(service string, q *QueryOptions) ([]*HealthCheck, *QueryMeta, error) { + r := h.c.newRequest("GET", "/v1/health/checks/"+service) + r.setQueryOptions(q) + rtt, resp, err := requireOK(h.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out []*HealthCheck + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} + +// Service is used to query health information along with service info +// for a given service. It can optionally do server-side filtering on a tag +// or nodes with passing health checks only. +func (h *Health) Service(service, tag string, passingOnly bool, q *QueryOptions) ([]*ServiceEntry, *QueryMeta, error) { + r := h.c.newRequest("GET", "/v1/health/service/"+service) + r.setQueryOptions(q) + if tag != "" { + r.params.Set("tag", tag) + } + if passingOnly { + r.params.Set("passing", "1") + } + rtt, resp, err := requireOK(h.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out []*ServiceEntry + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} + +// State is used to retreive all the checks in a given state. +// The wildcard "any" state can also be used for all checks. +func (h *Health) State(state string, q *QueryOptions) ([]*HealthCheck, *QueryMeta, error) { + switch state { + case "any": + case "warning": + case "critical": + case "passing": + case "unknown": + default: + return nil, nil, fmt.Errorf("Unsupported state: %v", state) + } + r := h.c.newRequest("GET", "/v1/health/state/"+state) + r.setQueryOptions(q) + rtt, resp, err := requireOK(h.c.doRequest(r)) + if err != nil { + return nil, nil, err + } + defer resp.Body.Close() + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + var out []*HealthCheck + if err := decodeBody(resp, &out); err != nil { + return nil, nil, err + } + return out, qm, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/kv.go b/vendor/src/github.com/hashicorp/consul/api/kv.go new file mode 100644 index 0000000000..ba74057fcc --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/kv.go @@ -0,0 +1,236 @@ +package api + +import ( + "bytes" + "fmt" + "io" + "net/http" + "strconv" + "strings" +) + +// KVPair is used to represent a single K/V entry +type KVPair struct { + Key string + CreateIndex uint64 + ModifyIndex uint64 + LockIndex uint64 + Flags uint64 + Value []byte + Session string +} + +// KVPairs is a list of KVPair objects +type KVPairs []*KVPair + +// KV is used to manipulate the K/V API +type KV struct { + c *Client +} + +// KV is used to return a handle to the K/V apis +func (c *Client) KV() *KV { + return &KV{c} +} + +// Get is used to lookup a single key +func (k *KV) Get(key string, q *QueryOptions) (*KVPair, *QueryMeta, error) { + resp, qm, err := k.getInternal(key, nil, q) + if err != nil { + return nil, nil, err + } + if resp == nil { + return nil, qm, nil + } + defer resp.Body.Close() + + var entries []*KVPair + if err := decodeBody(resp, &entries); err != nil { + return nil, nil, err + } + if len(entries) > 0 { + return entries[0], qm, nil + } + return nil, qm, nil +} + +// List is used to lookup all keys under a prefix +func (k *KV) List(prefix string, q *QueryOptions) (KVPairs, *QueryMeta, error) { + resp, qm, err := k.getInternal(prefix, map[string]string{"recurse": ""}, q) + if err != nil { + return nil, nil, err + } + if resp == nil { + return nil, qm, nil + } + defer resp.Body.Close() + + var entries []*KVPair + if err := decodeBody(resp, &entries); err != nil { + return nil, nil, err + } + return entries, qm, nil +} + +// Keys is used to list all the keys under a prefix. Optionally, +// a separator can be used to limit the responses. +func (k *KV) Keys(prefix, separator string, q *QueryOptions) ([]string, *QueryMeta, error) { + params := map[string]string{"keys": ""} + if separator != "" { + params["separator"] = separator + } + resp, qm, err := k.getInternal(prefix, params, q) + if err != nil { + return nil, nil, err + } + if resp == nil { + return nil, qm, nil + } + defer resp.Body.Close() + + var entries []string + if err := decodeBody(resp, &entries); err != nil { + return nil, nil, err + } + return entries, qm, nil +} + +func (k *KV) getInternal(key string, params map[string]string, q *QueryOptions) (*http.Response, *QueryMeta, error) { + r := k.c.newRequest("GET", "/v1/kv/"+key) + r.setQueryOptions(q) + for param, val := range params { + r.params.Set(param, val) + } + rtt, resp, err := k.c.doRequest(r) + if err != nil { + return nil, nil, err + } + + qm := &QueryMeta{} + parseQueryMeta(resp, qm) + qm.RequestTime = rtt + + if resp.StatusCode == 404 { + resp.Body.Close() + return nil, qm, nil + } else if resp.StatusCode != 200 { + resp.Body.Close() + return nil, nil, fmt.Errorf("Unexpected response code: %d", resp.StatusCode) + } + return resp, qm, nil +} + +// Put is used to write a new value. Only the +// Key, Flags and Value is respected. +func (k *KV) Put(p *KVPair, q *WriteOptions) (*WriteMeta, error) { + params := make(map[string]string, 1) + if p.Flags != 0 { + params["flags"] = strconv.FormatUint(p.Flags, 10) + } + _, wm, err := k.put(p.Key, params, p.Value, q) + return wm, err +} + +// CAS is used for a Check-And-Set operation. The Key, +// ModifyIndex, Flags and Value are respected. Returns true +// on success or false on failures. +func (k *KV) CAS(p *KVPair, q *WriteOptions) (bool, *WriteMeta, error) { + params := make(map[string]string, 2) + if p.Flags != 0 { + params["flags"] = strconv.FormatUint(p.Flags, 10) + } + params["cas"] = strconv.FormatUint(p.ModifyIndex, 10) + return k.put(p.Key, params, p.Value, q) +} + +// Acquire is used for a lock acquisiiton operation. The Key, +// Flags, Value and Session are respected. Returns true +// on success or false on failures. +func (k *KV) Acquire(p *KVPair, q *WriteOptions) (bool, *WriteMeta, error) { + params := make(map[string]string, 2) + if p.Flags != 0 { + params["flags"] = strconv.FormatUint(p.Flags, 10) + } + params["acquire"] = p.Session + return k.put(p.Key, params, p.Value, q) +} + +// Release is used for a lock release operation. The Key, +// Flags, Value and Session are respected. Returns true +// on success or false on failures. +func (k *KV) Release(p *KVPair, q *WriteOptions) (bool, *WriteMeta, error) { + params := make(map[string]string, 2) + if p.Flags != 0 { + params["flags"] = strconv.FormatUint(p.Flags, 10) + } + params["release"] = p.Session + return k.put(p.Key, params, p.Value, q) +} + +func (k *KV) put(key string, params map[string]string, body []byte, q *WriteOptions) (bool, *WriteMeta, error) { + r := k.c.newRequest("PUT", "/v1/kv/"+key) + r.setWriteOptions(q) + for param, val := range params { + r.params.Set(param, val) + } + r.body = bytes.NewReader(body) + rtt, resp, err := requireOK(k.c.doRequest(r)) + if err != nil { + return false, nil, err + } + defer resp.Body.Close() + + qm := &WriteMeta{} + qm.RequestTime = rtt + + var buf bytes.Buffer + if _, err := io.Copy(&buf, resp.Body); err != nil { + return false, nil, fmt.Errorf("Failed to read response: %v", err) + } + res := strings.Contains(string(buf.Bytes()), "true") + return res, qm, nil +} + +// Delete is used to delete a single key +func (k *KV) Delete(key string, w *WriteOptions) (*WriteMeta, error) { + _, qm, err := k.deleteInternal(key, nil, w) + return qm, err +} + +// DeleteCAS is used for a Delete Check-And-Set operation. The Key +// and ModifyIndex are respected. Returns true on success or false on failures. +func (k *KV) DeleteCAS(p *KVPair, q *WriteOptions) (bool, *WriteMeta, error) { + params := map[string]string{ + "cas": strconv.FormatUint(p.ModifyIndex, 10), + } + return k.deleteInternal(p.Key, params, q) +} + +// DeleteTree is used to delete all keys under a prefix +func (k *KV) DeleteTree(prefix string, w *WriteOptions) (*WriteMeta, error) { + _, qm, err := k.deleteInternal(prefix, map[string]string{"recurse": ""}, w) + return qm, err +} + +func (k *KV) deleteInternal(key string, params map[string]string, q *WriteOptions) (bool, *WriteMeta, error) { + r := k.c.newRequest("DELETE", "/v1/kv/"+key) + r.setWriteOptions(q) + for param, val := range params { + r.params.Set(param, val) + } + rtt, resp, err := requireOK(k.c.doRequest(r)) + if err != nil { + return false, nil, err + } + defer resp.Body.Close() + + qm := &WriteMeta{} + qm.RequestTime = rtt + + var buf bytes.Buffer + if _, err := io.Copy(&buf, resp.Body); err != nil { + return false, nil, fmt.Errorf("Failed to read response: %v", err) + } + res := strings.Contains(string(buf.Bytes()), "true") + return res, qm, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/lock.go b/vendor/src/github.com/hashicorp/consul/api/lock.go new file mode 100644 index 0000000000..4b694789c4 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/lock.go @@ -0,0 +1,326 @@ +package api + +import ( + "fmt" + "sync" + "time" +) + +const ( + // DefaultLockSessionName is the Session Name we assign if none is provided + DefaultLockSessionName = "Consul API Lock" + + // DefaultLockSessionTTL is the default session TTL if no Session is provided + // when creating a new Lock. This is used because we do not have another + // other check to depend upon. + DefaultLockSessionTTL = "15s" + + // DefaultLockWaitTime is how long we block for at a time to check if lock + // acquisition is possible. This affects the minimum time it takes to cancel + // a Lock acquisition. + DefaultLockWaitTime = 15 * time.Second + + // DefaultLockRetryTime is how long we wait after a failed lock acquisition + // before attempting to do the lock again. This is so that once a lock-delay + // is in affect, we do not hot loop retrying the acquisition. + DefaultLockRetryTime = 5 * time.Second + + // LockFlagValue is a magic flag we set to indicate a key + // is being used for a lock. It is used to detect a potential + // conflict with a semaphore. + LockFlagValue = 0x2ddccbc058a50c18 +) + +var ( + // ErrLockHeld is returned if we attempt to double lock + ErrLockHeld = fmt.Errorf("Lock already held") + + // ErrLockNotHeld is returned if we attempt to unlock a lock + // that we do not hold. + ErrLockNotHeld = fmt.Errorf("Lock not held") + + // ErrLockInUse is returned if we attempt to destroy a lock + // that is in use. + ErrLockInUse = fmt.Errorf("Lock in use") + + // ErrLockConflict is returned if the flags on a key + // used for a lock do not match expectation + ErrLockConflict = fmt.Errorf("Existing key does not match lock use") +) + +// Lock is used to implement client-side leader election. It is follows the +// algorithm as described here: https://consul.io/docs/guides/leader-election.html. +type Lock struct { + c *Client + opts *LockOptions + + isHeld bool + sessionRenew chan struct{} + lockSession string + l sync.Mutex +} + +// LockOptions is used to parameterize the Lock behavior. +type LockOptions struct { + Key string // Must be set and have write permissions + Value []byte // Optional, value to associate with the lock + Session string // Optional, created if not specified + SessionName string // Optional, defaults to DefaultLockSessionName + SessionTTL string // Optional, defaults to DefaultLockSessionTTL +} + +// LockKey returns a handle to a lock struct which can be used +// to acquire and release the mutex. The key used must have +// write permissions. +func (c *Client) LockKey(key string) (*Lock, error) { + opts := &LockOptions{ + Key: key, + } + return c.LockOpts(opts) +} + +// LockOpts returns a handle to a lock struct which can be used +// to acquire and release the mutex. The key used must have +// write permissions. +func (c *Client) LockOpts(opts *LockOptions) (*Lock, error) { + if opts.Key == "" { + return nil, fmt.Errorf("missing key") + } + if opts.SessionName == "" { + opts.SessionName = DefaultLockSessionName + } + if opts.SessionTTL == "" { + opts.SessionTTL = DefaultLockSessionTTL + } else { + if _, err := time.ParseDuration(opts.SessionTTL); err != nil { + return nil, fmt.Errorf("invalid SessionTTL: %v", err) + } + } + l := &Lock{ + c: c, + opts: opts, + } + return l, nil +} + +// Lock attempts to acquire the lock and blocks while doing so. +// Providing a non-nil stopCh can be used to abort the lock attempt. +// Returns a channel that is closed if our lock is lost or an error. +// This channel could be closed at any time due to session invalidation, +// communication errors, operator intervention, etc. It is NOT safe to +// assume that the lock is held until Unlock() unless the Session is specifically +// created without any associated health checks. By default Consul sessions +// prefer liveness over safety and an application must be able to handle +// the lock being lost. +func (l *Lock) Lock(stopCh <-chan struct{}) (<-chan struct{}, error) { + // Hold the lock as we try to acquire + l.l.Lock() + defer l.l.Unlock() + + // Check if we already hold the lock + if l.isHeld { + return nil, ErrLockHeld + } + + // Check if we need to create a session first + l.lockSession = l.opts.Session + if l.lockSession == "" { + if s, err := l.createSession(); err != nil { + return nil, fmt.Errorf("failed to create session: %v", err) + } else { + l.sessionRenew = make(chan struct{}) + l.lockSession = s + session := l.c.Session() + go session.RenewPeriodic(l.opts.SessionTTL, s, nil, l.sessionRenew) + + // If we fail to acquire the lock, cleanup the session + defer func() { + if !l.isHeld { + close(l.sessionRenew) + l.sessionRenew = nil + } + }() + } + } + + // Setup the query options + kv := l.c.KV() + qOpts := &QueryOptions{ + WaitTime: DefaultLockWaitTime, + } + +WAIT: + // Check if we should quit + select { + case <-stopCh: + return nil, nil + default: + } + + // Look for an existing lock, blocking until not taken + pair, meta, err := kv.Get(l.opts.Key, qOpts) + if err != nil { + return nil, fmt.Errorf("failed to read lock: %v", err) + } + if pair != nil && pair.Flags != LockFlagValue { + return nil, ErrLockConflict + } + locked := false + if pair != nil && pair.Session == l.lockSession { + goto HELD + } + if pair != nil && pair.Session != "" { + qOpts.WaitIndex = meta.LastIndex + goto WAIT + } + + // Try to acquire the lock + pair = l.lockEntry(l.lockSession) + locked, _, err = kv.Acquire(pair, nil) + if err != nil { + return nil, fmt.Errorf("failed to acquire lock: %v", err) + } + + // Handle the case of not getting the lock + if !locked { + select { + case <-time.After(DefaultLockRetryTime): + goto WAIT + case <-stopCh: + return nil, nil + } + } + +HELD: + // Watch to ensure we maintain leadership + leaderCh := make(chan struct{}) + go l.monitorLock(l.lockSession, leaderCh) + + // Set that we own the lock + l.isHeld = true + + // Locked! All done + return leaderCh, nil +} + +// Unlock released the lock. It is an error to call this +// if the lock is not currently held. +func (l *Lock) Unlock() error { + // Hold the lock as we try to release + l.l.Lock() + defer l.l.Unlock() + + // Ensure the lock is actually held + if !l.isHeld { + return ErrLockNotHeld + } + + // Set that we no longer own the lock + l.isHeld = false + + // Stop the session renew + if l.sessionRenew != nil { + defer func() { + close(l.sessionRenew) + l.sessionRenew = nil + }() + } + + // Get the lock entry, and clear the lock session + lockEnt := l.lockEntry(l.lockSession) + l.lockSession = "" + + // Release the lock explicitly + kv := l.c.KV() + _, _, err := kv.Release(lockEnt, nil) + if err != nil { + return fmt.Errorf("failed to release lock: %v", err) + } + return nil +} + +// Destroy is used to cleanup the lock entry. It is not necessary +// to invoke. It will fail if the lock is in use. +func (l *Lock) Destroy() error { + // Hold the lock as we try to release + l.l.Lock() + defer l.l.Unlock() + + // Check if we already hold the lock + if l.isHeld { + return ErrLockHeld + } + + // Look for an existing lock + kv := l.c.KV() + pair, _, err := kv.Get(l.opts.Key, nil) + if err != nil { + return fmt.Errorf("failed to read lock: %v", err) + } + + // Nothing to do if the lock does not exist + if pair == nil { + return nil + } + + // Check for possible flag conflict + if pair.Flags != LockFlagValue { + return ErrLockConflict + } + + // Check if it is in use + if pair.Session != "" { + return ErrLockInUse + } + + // Attempt the delete + didRemove, _, err := kv.DeleteCAS(pair, nil) + if err != nil { + return fmt.Errorf("failed to remove lock: %v", err) + } + if !didRemove { + return ErrLockInUse + } + return nil +} + +// createSession is used to create a new managed session +func (l *Lock) createSession() (string, error) { + session := l.c.Session() + se := &SessionEntry{ + Name: l.opts.SessionName, + TTL: l.opts.SessionTTL, + } + id, _, err := session.Create(se, nil) + if err != nil { + return "", err + } + return id, nil +} + +// lockEntry returns a formatted KVPair for the lock +func (l *Lock) lockEntry(session string) *KVPair { + return &KVPair{ + Key: l.opts.Key, + Value: l.opts.Value, + Session: session, + Flags: LockFlagValue, + } +} + +// monitorLock is a long running routine to monitor a lock ownership +// It closes the stopCh if we lose our leadership. +func (l *Lock) monitorLock(session string, stopCh chan struct{}) { + defer close(stopCh) + kv := l.c.KV() + opts := &QueryOptions{RequireConsistent: true} +WAIT: + pair, meta, err := kv.Get(l.opts.Key, opts) + if err != nil { + return + } + if pair != nil && pair.Session == session { + opts.WaitIndex = meta.LastIndex + goto WAIT + } +} diff --git a/vendor/src/github.com/hashicorp/consul/api/raw.go b/vendor/src/github.com/hashicorp/consul/api/raw.go new file mode 100644 index 0000000000..745a208c99 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/raw.go @@ -0,0 +1,24 @@ +package api + +// Raw can be used to do raw queries against custom endpoints +type Raw struct { + c *Client +} + +// Raw returns a handle to query endpoints +func (c *Client) Raw() *Raw { + return &Raw{c} +} + +// Query is used to do a GET request against an endpoint +// and deserialize the response into an interface using +// standard Consul conventions. +func (raw *Raw) Query(endpoint string, out interface{}, q *QueryOptions) (*QueryMeta, error) { + return raw.c.query(endpoint, out, q) +} + +// Write is used to do a PUT request against an endpoint +// and serialize/deserialized using the standard Consul conventions. +func (raw *Raw) Write(endpoint string, in, out interface{}, q *WriteOptions) (*WriteMeta, error) { + return raw.c.write(endpoint, in, out, q) +} diff --git a/vendor/src/github.com/hashicorp/consul/api/semaphore.go b/vendor/src/github.com/hashicorp/consul/api/semaphore.go new file mode 100644 index 0000000000..ff4c2058ce --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/semaphore.go @@ -0,0 +1,477 @@ +package api + +import ( + "encoding/json" + "fmt" + "path" + "sync" + "time" +) + +const ( + // DefaultSemaphoreSessionName is the Session Name we assign if none is provided + DefaultSemaphoreSessionName = "Consul API Semaphore" + + // DefaultSemaphoreSessionTTL is the default session TTL if no Session is provided + // when creating a new Semaphore. This is used because we do not have another + // other check to depend upon. + DefaultSemaphoreSessionTTL = "15s" + + // DefaultSemaphoreWaitTime is how long we block for at a time to check if semaphore + // acquisition is possible. This affects the minimum time it takes to cancel + // a Semaphore acquisition. + DefaultSemaphoreWaitTime = 15 * time.Second + + // DefaultSemaphoreKey is the key used within the prefix to + // use for coordination between all the contenders. + DefaultSemaphoreKey = ".lock" + + // SemaphoreFlagValue is a magic flag we set to indicate a key + // is being used for a semaphore. It is used to detect a potential + // conflict with a lock. + SemaphoreFlagValue = 0xe0f69a2baa414de0 +) + +var ( + // ErrSemaphoreHeld is returned if we attempt to double lock + ErrSemaphoreHeld = fmt.Errorf("Semaphore already held") + + // ErrSemaphoreNotHeld is returned if we attempt to unlock a semaphore + // that we do not hold. + ErrSemaphoreNotHeld = fmt.Errorf("Semaphore not held") + + // ErrSemaphoreInUse is returned if we attempt to destroy a semaphore + // that is in use. + ErrSemaphoreInUse = fmt.Errorf("Semaphore in use") + + // ErrSemaphoreConflict is returned if the flags on a key + // used for a semaphore do not match expectation + ErrSemaphoreConflict = fmt.Errorf("Existing key does not match semaphore use") +) + +// Semaphore is used to implement a distributed semaphore +// using the Consul KV primitives. +type Semaphore struct { + c *Client + opts *SemaphoreOptions + + isHeld bool + sessionRenew chan struct{} + lockSession string + l sync.Mutex +} + +// SemaphoreOptions is used to parameterize the Semaphore +type SemaphoreOptions struct { + Prefix string // Must be set and have write permissions + Limit int // Must be set, and be positive + Value []byte // Optional, value to associate with the contender entry + Session string // OPtional, created if not specified + SessionName string // Optional, defaults to DefaultLockSessionName + SessionTTL string // Optional, defaults to DefaultLockSessionTTL +} + +// semaphoreLock is written under the DefaultSemaphoreKey and +// is used to coordinate between all the contenders. +type semaphoreLock struct { + // Limit is the integer limit of holders. This is used to + // verify that all the holders agree on the value. + Limit int + + // Holders is a list of all the semaphore holders. + // It maps the session ID to true. It is used as a set effectively. + Holders map[string]bool +} + +// SemaphorePrefix is used to created a Semaphore which will operate +// at the given KV prefix and uses the given limit for the semaphore. +// The prefix must have write privileges, and the limit must be agreed +// upon by all contenders. +func (c *Client) SemaphorePrefix(prefix string, limit int) (*Semaphore, error) { + opts := &SemaphoreOptions{ + Prefix: prefix, + Limit: limit, + } + return c.SemaphoreOpts(opts) +} + +// SemaphoreOpts is used to create a Semaphore with the given options. +// The prefix must have write privileges, and the limit must be agreed +// upon by all contenders. If a Session is not provided, one will be created. +func (c *Client) SemaphoreOpts(opts *SemaphoreOptions) (*Semaphore, error) { + if opts.Prefix == "" { + return nil, fmt.Errorf("missing prefix") + } + if opts.Limit <= 0 { + return nil, fmt.Errorf("semaphore limit must be positive") + } + if opts.SessionName == "" { + opts.SessionName = DefaultSemaphoreSessionName + } + if opts.SessionTTL == "" { + opts.SessionTTL = DefaultSemaphoreSessionTTL + } else { + if _, err := time.ParseDuration(opts.SessionTTL); err != nil { + return nil, fmt.Errorf("invalid SessionTTL: %v", err) + } + } + s := &Semaphore{ + c: c, + opts: opts, + } + return s, nil +} + +// Acquire attempts to reserve a slot in the semaphore, blocking until +// success, interrupted via the stopCh or an error is encounted. +// Providing a non-nil stopCh can be used to abort the attempt. +// On success, a channel is returned that represents our slot. +// This channel could be closed at any time due to session invalidation, +// communication errors, operator intervention, etc. It is NOT safe to +// assume that the slot is held until Release() unless the Session is specifically +// created without any associated health checks. By default Consul sessions +// prefer liveness over safety and an application must be able to handle +// the session being lost. +func (s *Semaphore) Acquire(stopCh <-chan struct{}) (<-chan struct{}, error) { + // Hold the lock as we try to acquire + s.l.Lock() + defer s.l.Unlock() + + // Check if we already hold the semaphore + if s.isHeld { + return nil, ErrSemaphoreHeld + } + + // Check if we need to create a session first + s.lockSession = s.opts.Session + if s.lockSession == "" { + if sess, err := s.createSession(); err != nil { + return nil, fmt.Errorf("failed to create session: %v", err) + } else { + s.sessionRenew = make(chan struct{}) + s.lockSession = sess + session := s.c.Session() + go session.RenewPeriodic(s.opts.SessionTTL, sess, nil, s.sessionRenew) + + // If we fail to acquire the lock, cleanup the session + defer func() { + if !s.isHeld { + close(s.sessionRenew) + s.sessionRenew = nil + } + }() + } + } + + // Create the contender entry + kv := s.c.KV() + made, _, err := kv.Acquire(s.contenderEntry(s.lockSession), nil) + if err != nil || !made { + return nil, fmt.Errorf("failed to make contender entry: %v", err) + } + + // Setup the query options + qOpts := &QueryOptions{ + WaitTime: DefaultSemaphoreWaitTime, + } + +WAIT: + // Check if we should quit + select { + case <-stopCh: + return nil, nil + default: + } + + // Read the prefix + pairs, meta, err := kv.List(s.opts.Prefix, qOpts) + if err != nil { + return nil, fmt.Errorf("failed to read prefix: %v", err) + } + + // Decode the lock + lockPair := s.findLock(pairs) + if lockPair.Flags != SemaphoreFlagValue { + return nil, ErrSemaphoreConflict + } + lock, err := s.decodeLock(lockPair) + if err != nil { + return nil, err + } + + // Verify we agree with the limit + if lock.Limit != s.opts.Limit { + return nil, fmt.Errorf("semaphore limit conflict (lock: %d, local: %d)", + lock.Limit, s.opts.Limit) + } + + // Prune the dead holders + s.pruneDeadHolders(lock, pairs) + + // Check if the lock is held + if len(lock.Holders) >= lock.Limit { + qOpts.WaitIndex = meta.LastIndex + goto WAIT + } + + // Create a new lock with us as a holder + lock.Holders[s.lockSession] = true + newLock, err := s.encodeLock(lock, lockPair.ModifyIndex) + if err != nil { + return nil, err + } + + // Attempt the acquisition + didSet, _, err := kv.CAS(newLock, nil) + if err != nil { + return nil, fmt.Errorf("failed to update lock: %v", err) + } + if !didSet { + // Update failed, could have been a race with another contender, + // retry the operation + goto WAIT + } + + // Watch to ensure we maintain ownership of the slot + lockCh := make(chan struct{}) + go s.monitorLock(s.lockSession, lockCh) + + // Set that we own the lock + s.isHeld = true + + // Acquired! All done + return lockCh, nil +} + +// Release is used to voluntarily give up our semaphore slot. It is +// an error to call this if the semaphore has not been acquired. +func (s *Semaphore) Release() error { + // Hold the lock as we try to release + s.l.Lock() + defer s.l.Unlock() + + // Ensure the lock is actually held + if !s.isHeld { + return ErrSemaphoreNotHeld + } + + // Set that we no longer own the lock + s.isHeld = false + + // Stop the session renew + if s.sessionRenew != nil { + defer func() { + close(s.sessionRenew) + s.sessionRenew = nil + }() + } + + // Get and clear the lock session + lockSession := s.lockSession + s.lockSession = "" + + // Remove ourselves as a lock holder + kv := s.c.KV() + key := path.Join(s.opts.Prefix, DefaultSemaphoreKey) +READ: + pair, _, err := kv.Get(key, nil) + if err != nil { + return err + } + if pair == nil { + pair = &KVPair{} + } + lock, err := s.decodeLock(pair) + if err != nil { + return err + } + + // Create a new lock without us as a holder + if _, ok := lock.Holders[lockSession]; ok { + delete(lock.Holders, lockSession) + newLock, err := s.encodeLock(lock, pair.ModifyIndex) + if err != nil { + return err + } + + // Swap the locks + didSet, _, err := kv.CAS(newLock, nil) + if err != nil { + return fmt.Errorf("failed to update lock: %v", err) + } + if !didSet { + goto READ + } + } + + // Destroy the contender entry + contenderKey := path.Join(s.opts.Prefix, lockSession) + if _, err := kv.Delete(contenderKey, nil); err != nil { + return err + } + return nil +} + +// Destroy is used to cleanup the semaphore entry. It is not necessary +// to invoke. It will fail if the semaphore is in use. +func (s *Semaphore) Destroy() error { + // Hold the lock as we try to acquire + s.l.Lock() + defer s.l.Unlock() + + // Check if we already hold the semaphore + if s.isHeld { + return ErrSemaphoreHeld + } + + // List for the semaphore + kv := s.c.KV() + pairs, _, err := kv.List(s.opts.Prefix, nil) + if err != nil { + return fmt.Errorf("failed to read prefix: %v", err) + } + + // Find the lock pair, bail if it doesn't exist + lockPair := s.findLock(pairs) + if lockPair.ModifyIndex == 0 { + return nil + } + if lockPair.Flags != SemaphoreFlagValue { + return ErrSemaphoreConflict + } + + // Decode the lock + lock, err := s.decodeLock(lockPair) + if err != nil { + return err + } + + // Prune the dead holders + s.pruneDeadHolders(lock, pairs) + + // Check if there are any holders + if len(lock.Holders) > 0 { + return ErrSemaphoreInUse + } + + // Attempt the delete + didRemove, _, err := kv.DeleteCAS(lockPair, nil) + if err != nil { + return fmt.Errorf("failed to remove semaphore: %v", err) + } + if !didRemove { + return ErrSemaphoreInUse + } + return nil +} + +// createSession is used to create a new managed session +func (s *Semaphore) createSession() (string, error) { + session := s.c.Session() + se := &SessionEntry{ + Name: s.opts.SessionName, + TTL: s.opts.SessionTTL, + Behavior: SessionBehaviorDelete, + } + id, _, err := session.Create(se, nil) + if err != nil { + return "", err + } + return id, nil +} + +// contenderEntry returns a formatted KVPair for the contender +func (s *Semaphore) contenderEntry(session string) *KVPair { + return &KVPair{ + Key: path.Join(s.opts.Prefix, session), + Value: s.opts.Value, + Session: session, + Flags: SemaphoreFlagValue, + } +} + +// findLock is used to find the KV Pair which is used for coordination +func (s *Semaphore) findLock(pairs KVPairs) *KVPair { + key := path.Join(s.opts.Prefix, DefaultSemaphoreKey) + for _, pair := range pairs { + if pair.Key == key { + return pair + } + } + return &KVPair{Flags: SemaphoreFlagValue} +} + +// decodeLock is used to decode a semaphoreLock from an +// entry in Consul +func (s *Semaphore) decodeLock(pair *KVPair) (*semaphoreLock, error) { + // Handle if there is no lock + if pair == nil || pair.Value == nil { + return &semaphoreLock{ + Limit: s.opts.Limit, + Holders: make(map[string]bool), + }, nil + } + + l := &semaphoreLock{} + if err := json.Unmarshal(pair.Value, l); err != nil { + return nil, fmt.Errorf("lock decoding failed: %v", err) + } + return l, nil +} + +// encodeLock is used to encode a semaphoreLock into a KVPair +// that can be PUT +func (s *Semaphore) encodeLock(l *semaphoreLock, oldIndex uint64) (*KVPair, error) { + enc, err := json.Marshal(l) + if err != nil { + return nil, fmt.Errorf("lock encoding failed: %v", err) + } + pair := &KVPair{ + Key: path.Join(s.opts.Prefix, DefaultSemaphoreKey), + Value: enc, + Flags: SemaphoreFlagValue, + ModifyIndex: oldIndex, + } + return pair, nil +} + +// pruneDeadHolders is used to remove all the dead lock holders +func (s *Semaphore) pruneDeadHolders(lock *semaphoreLock, pairs KVPairs) { + // Gather all the live holders + alive := make(map[string]struct{}, len(pairs)) + for _, pair := range pairs { + if pair.Session != "" { + alive[pair.Session] = struct{}{} + } + } + + // Remove any holders that are dead + for holder := range lock.Holders { + if _, ok := alive[holder]; !ok { + delete(lock.Holders, holder) + } + } +} + +// monitorLock is a long running routine to monitor a semaphore ownership +// It closes the stopCh if we lose our slot. +func (s *Semaphore) monitorLock(session string, stopCh chan struct{}) { + defer close(stopCh) + kv := s.c.KV() + opts := &QueryOptions{RequireConsistent: true} +WAIT: + pairs, meta, err := kv.List(s.opts.Prefix, opts) + if err != nil { + return + } + lockPair := s.findLock(pairs) + lock, err := s.decodeLock(lockPair) + if err != nil { + return + } + s.pruneDeadHolders(lock, pairs) + if _, ok := lock.Holders[session]; ok { + opts.WaitIndex = meta.LastIndex + goto WAIT + } +} diff --git a/vendor/src/github.com/hashicorp/consul/api/session.go b/vendor/src/github.com/hashicorp/consul/api/session.go new file mode 100644 index 0000000000..a99da511d6 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/session.go @@ -0,0 +1,201 @@ +package api + +import ( + "fmt" + "time" +) + +const ( + // SessionBehaviorRelease is the default behavior and causes + // all associated locks to be released on session invalidation. + SessionBehaviorRelease = "release" + + // SessionBehaviorDelete is new in Consul 0.5 and changes the + // behavior to delete all associated locks on session invalidation. + // It can be used in a way similar to Ephemeral Nodes in ZooKeeper. + SessionBehaviorDelete = "delete" +) + +// SessionEntry represents a session in consul +type SessionEntry struct { + CreateIndex uint64 + ID string + Name string + Node string + Checks []string + LockDelay time.Duration + Behavior string + TTL string +} + +// Session can be used to query the Session endpoints +type Session struct { + c *Client +} + +// Session returns a handle to the session endpoints +func (c *Client) Session() *Session { + return &Session{c} +} + +// CreateNoChecks is like Create but is used specifically to create +// a session with no associated health checks. +func (s *Session) CreateNoChecks(se *SessionEntry, q *WriteOptions) (string, *WriteMeta, error) { + body := make(map[string]interface{}) + body["Checks"] = []string{} + if se != nil { + if se.Name != "" { + body["Name"] = se.Name + } + if se.Node != "" { + body["Node"] = se.Node + } + if se.LockDelay != 0 { + body["LockDelay"] = durToMsec(se.LockDelay) + } + if se.Behavior != "" { + body["Behavior"] = se.Behavior + } + if se.TTL != "" { + body["TTL"] = se.TTL + } + } + return s.create(body, q) + +} + +// Create makes a new session. Providing a session entry can +// customize the session. It can also be nil to use defaults. +func (s *Session) Create(se *SessionEntry, q *WriteOptions) (string, *WriteMeta, error) { + var obj interface{} + if se != nil { + body := make(map[string]interface{}) + obj = body + if se.Name != "" { + body["Name"] = se.Name + } + if se.Node != "" { + body["Node"] = se.Node + } + if se.LockDelay != 0 { + body["LockDelay"] = durToMsec(se.LockDelay) + } + if len(se.Checks) > 0 { + body["Checks"] = se.Checks + } + if se.Behavior != "" { + body["Behavior"] = se.Behavior + } + if se.TTL != "" { + body["TTL"] = se.TTL + } + } + return s.create(obj, q) +} + +func (s *Session) create(obj interface{}, q *WriteOptions) (string, *WriteMeta, error) { + var out struct{ ID string } + wm, err := s.c.write("/v1/session/create", obj, &out, q) + if err != nil { + return "", nil, err + } + return out.ID, wm, nil +} + +// Destroy invalides a given session +func (s *Session) Destroy(id string, q *WriteOptions) (*WriteMeta, error) { + wm, err := s.c.write("/v1/session/destroy/"+id, nil, nil, q) + if err != nil { + return nil, err + } + return wm, nil +} + +// Renew renews the TTL on a given session +func (s *Session) Renew(id string, q *WriteOptions) (*SessionEntry, *WriteMeta, error) { + var entries []*SessionEntry + wm, err := s.c.write("/v1/session/renew/"+id, nil, &entries, q) + if err != nil { + return nil, nil, err + } + if len(entries) > 0 { + return entries[0], wm, nil + } + return nil, wm, nil +} + +// RenewPeriodic is used to periodically invoke Session.Renew on a +// session until a doneCh is closed. This is meant to be used in a long running +// goroutine to ensure a session stays valid. +func (s *Session) RenewPeriodic(initialTTL string, id string, q *WriteOptions, doneCh chan struct{}) error { + ttl, err := time.ParseDuration(initialTTL) + if err != nil { + return err + } + + waitDur := ttl / 2 + lastRenewTime := time.Now() + var lastErr error + for { + if time.Since(lastRenewTime) > ttl { + return lastErr + } + select { + case <-time.After(waitDur): + entry, _, err := s.Renew(id, q) + if err != nil { + waitDur = time.Second + lastErr = err + continue + } + if entry == nil { + waitDur = time.Second + lastErr = fmt.Errorf("No SessionEntry returned") + continue + } + + // Handle the server updating the TTL + ttl, _ = time.ParseDuration(entry.TTL) + waitDur = ttl / 2 + lastRenewTime = time.Now() + + case <-doneCh: + // Attempt a session destroy + s.Destroy(id, q) + return nil + } + } +} + +// Info looks up a single session +func (s *Session) Info(id string, q *QueryOptions) (*SessionEntry, *QueryMeta, error) { + var entries []*SessionEntry + qm, err := s.c.query("/v1/session/info/"+id, &entries, q) + if err != nil { + return nil, nil, err + } + if len(entries) > 0 { + return entries[0], qm, nil + } + return nil, qm, nil +} + +// List gets sessions for a node +func (s *Session) Node(node string, q *QueryOptions) ([]*SessionEntry, *QueryMeta, error) { + var entries []*SessionEntry + qm, err := s.c.query("/v1/session/node/"+node, &entries, q) + if err != nil { + return nil, nil, err + } + return entries, qm, nil +} + +// List gets all active sessions +func (s *Session) List(q *QueryOptions) ([]*SessionEntry, *QueryMeta, error) { + var entries []*SessionEntry + qm, err := s.c.query("/v1/session/list", &entries, q) + if err != nil { + return nil, nil, err + } + return entries, qm, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/api/status.go b/vendor/src/github.com/hashicorp/consul/api/status.go new file mode 100644 index 0000000000..74ef61a678 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/api/status.go @@ -0,0 +1,43 @@ +package api + +// Status can be used to query the Status endpoints +type Status struct { + c *Client +} + +// Status returns a handle to the status endpoints +func (c *Client) Status() *Status { + return &Status{c} +} + +// Leader is used to query for a known leader +func (s *Status) Leader() (string, error) { + r := s.c.newRequest("GET", "/v1/status/leader") + _, resp, err := requireOK(s.c.doRequest(r)) + if err != nil { + return "", err + } + defer resp.Body.Close() + + var leader string + if err := decodeBody(resp, &leader); err != nil { + return "", err + } + return leader, nil +} + +// Peers is used to query for a known raft peers +func (s *Status) Peers() ([]string, error) { + r := s.c.newRequest("GET", "/v1/status/peers") + _, resp, err := requireOK(s.c.doRequest(r)) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + var peers []string + if err := decodeBody(resp, &peers); err != nil { + return nil, err + } + return peers, nil +} diff --git a/vendor/src/github.com/hashicorp/consul/website/LICENSE.md b/vendor/src/github.com/hashicorp/consul/website/LICENSE.md new file mode 100644 index 0000000000..ac2c064678 --- /dev/null +++ b/vendor/src/github.com/hashicorp/consul/website/LICENSE.md @@ -0,0 +1,10 @@ +# Proprietary License + +This license is temporary while a more official one is drafted. However, +this should make it clear: + +* The text contents of this website are MPL 2.0 licensed. + +* The design contents of this website are proprietary and may not be reproduced + or reused in any way other than to run the Consul website locally. The license + for the design is owned solely by HashiCorp, Inc. diff --git a/vendor/src/github.com/hashicorp/go-msgpack/LICENSE b/vendor/src/github.com/hashicorp/go-msgpack/LICENSE new file mode 100644 index 0000000000..ccae99f6a9 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/LICENSE @@ -0,0 +1,25 @@ +Copyright (c) 2012, 2013 Ugorji Nwoke. +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. +* Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. +* Neither the name of the author nor the names of its contributors may be used + to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/0doc.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/0doc.go new file mode 100644 index 0000000000..c14d810a73 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/0doc.go @@ -0,0 +1,143 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +/* +High Performance, Feature-Rich Idiomatic Go encoding library for msgpack and binc . + +Supported Serialization formats are: + + - msgpack: [https://github.com/msgpack/msgpack] + - binc: [http://github.com/ugorji/binc] + +To install: + + go get github.com/ugorji/go/codec + +The idiomatic Go support is as seen in other encoding packages in +the standard library (ie json, xml, gob, etc). + +Rich Feature Set includes: + + - Simple but extremely powerful and feature-rich API + - Very High Performance. + Our extensive benchmarks show us outperforming Gob, Json and Bson by 2-4X. + This was achieved by taking extreme care on: + - managing allocation + - function frame size (important due to Go's use of split stacks), + - reflection use (and by-passing reflection for common types) + - recursion implications + - zero-copy mode (encoding/decoding to byte slice without using temp buffers) + - Correct. + Care was taken to precisely handle corner cases like: + overflows, nil maps and slices, nil value in stream, etc. + - Efficient zero-copying into temporary byte buffers + when encoding into or decoding from a byte slice. + - Standard field renaming via tags + - Encoding from any value + (struct, slice, map, primitives, pointers, interface{}, etc) + - Decoding into pointer to any non-nil typed value + (struct, slice, map, int, float32, bool, string, reflect.Value, etc) + - Supports extension functions to handle the encode/decode of custom types + - Support Go 1.2 encoding.BinaryMarshaler/BinaryUnmarshaler + - Schema-less decoding + (decode into a pointer to a nil interface{} as opposed to a typed non-nil value). + Includes Options to configure what specific map or slice type to use + when decoding an encoded list or map into a nil interface{} + - Provides a RPC Server and Client Codec for net/rpc communication protocol. + - Msgpack Specific: + - Provides extension functions to handle spec-defined extensions (binary, timestamp) + - Options to resolve ambiguities in handling raw bytes (as string or []byte) + during schema-less decoding (decoding into a nil interface{}) + - RPC Server/Client Codec for msgpack-rpc protocol defined at: + https://github.com/msgpack-rpc/msgpack-rpc/blob/master/spec.md + - Fast Paths for some container types: + For some container types, we circumvent reflection and its associated overhead + and allocation costs, and encode/decode directly. These types are: + []interface{} + []int + []string + map[interface{}]interface{} + map[int]interface{} + map[string]interface{} + +Extension Support + +Users can register a function to handle the encoding or decoding of +their custom types. + +There are no restrictions on what the custom type can be. Some examples: + + type BisSet []int + type BitSet64 uint64 + type UUID string + type MyStructWithUnexportedFields struct { a int; b bool; c []int; } + type GifImage struct { ... } + +As an illustration, MyStructWithUnexportedFields would normally be +encoded as an empty map because it has no exported fields, while UUID +would be encoded as a string. However, with extension support, you can +encode any of these however you like. + +RPC + +RPC Client and Server Codecs are implemented, so the codecs can be used +with the standard net/rpc package. + +Usage + +Typical usage model: + + // create and configure Handle + var ( + bh codec.BincHandle + mh codec.MsgpackHandle + ) + + mh.MapType = reflect.TypeOf(map[string]interface{}(nil)) + + // configure extensions + // e.g. for msgpack, define functions and enable Time support for tag 1 + // mh.AddExt(reflect.TypeOf(time.Time{}), 1, myMsgpackTimeEncodeExtFn, myMsgpackTimeDecodeExtFn) + + // create and use decoder/encoder + var ( + r io.Reader + w io.Writer + b []byte + h = &bh // or mh to use msgpack + ) + + dec = codec.NewDecoder(r, h) + dec = codec.NewDecoderBytes(b, h) + err = dec.Decode(&v) + + enc = codec.NewEncoder(w, h) + enc = codec.NewEncoderBytes(&b, h) + err = enc.Encode(v) + + //RPC Server + go func() { + for { + conn, err := listener.Accept() + rpcCodec := codec.GoRpc.ServerCodec(conn, h) + //OR rpcCodec := codec.MsgpackSpecRpc.ServerCodec(conn, h) + rpc.ServeCodec(rpcCodec) + } + }() + + //RPC Communication (client side) + conn, err = net.Dial("tcp", "localhost:5555") + rpcCodec := codec.GoRpc.ClientCodec(conn, h) + //OR rpcCodec := codec.MsgpackSpecRpc.ClientCodec(conn, h) + client := rpc.NewClientWithCodec(rpcCodec) + +Representative Benchmark Results + +Run the benchmark suite using: + go test -bi -bench=. -benchmem + +To run full benchmark suite (including against vmsgpack and bson), +see notes in ext_dep_test.go + +*/ +package codec diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/README.md b/vendor/src/github.com/hashicorp/go-msgpack/codec/README.md new file mode 100644 index 0000000000..6c95d1bfd2 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/README.md @@ -0,0 +1,174 @@ +# Codec + +High Performance and Feature-Rich Idiomatic Go Library providing +encode/decode support for different serialization formats. + +Supported Serialization formats are: + + - msgpack: [https://github.com/msgpack/msgpack] + - binc: [http://github.com/ugorji/binc] + +To install: + + go get github.com/ugorji/go/codec + +Online documentation: [http://godoc.org/github.com/ugorji/go/codec] + +The idiomatic Go support is as seen in other encoding packages in +the standard library (ie json, xml, gob, etc). + +Rich Feature Set includes: + + - Simple but extremely powerful and feature-rich API + - Very High Performance. + Our extensive benchmarks show us outperforming Gob, Json and Bson by 2-4X. + This was achieved by taking extreme care on: + - managing allocation + - function frame size (important due to Go's use of split stacks), + - reflection use (and by-passing reflection for common types) + - recursion implications + - zero-copy mode (encoding/decoding to byte slice without using temp buffers) + - Correct. + Care was taken to precisely handle corner cases like: + overflows, nil maps and slices, nil value in stream, etc. + - Efficient zero-copying into temporary byte buffers + when encoding into or decoding from a byte slice. + - Standard field renaming via tags + - Encoding from any value + (struct, slice, map, primitives, pointers, interface{}, etc) + - Decoding into pointer to any non-nil typed value + (struct, slice, map, int, float32, bool, string, reflect.Value, etc) + - Supports extension functions to handle the encode/decode of custom types + - Support Go 1.2 encoding.BinaryMarshaler/BinaryUnmarshaler + - Schema-less decoding + (decode into a pointer to a nil interface{} as opposed to a typed non-nil value). + Includes Options to configure what specific map or slice type to use + when decoding an encoded list or map into a nil interface{} + - Provides a RPC Server and Client Codec for net/rpc communication protocol. + - Msgpack Specific: + - Provides extension functions to handle spec-defined extensions (binary, timestamp) + - Options to resolve ambiguities in handling raw bytes (as string or []byte) + during schema-less decoding (decoding into a nil interface{}) + - RPC Server/Client Codec for msgpack-rpc protocol defined at: + https://github.com/msgpack-rpc/msgpack-rpc/blob/master/spec.md + - Fast Paths for some container types: + For some container types, we circumvent reflection and its associated overhead + and allocation costs, and encode/decode directly. These types are: + []interface{} + []int + []string + map[interface{}]interface{} + map[int]interface{} + map[string]interface{} + +## Extension Support + +Users can register a function to handle the encoding or decoding of +their custom types. + +There are no restrictions on what the custom type can be. Some examples: + + type BisSet []int + type BitSet64 uint64 + type UUID string + type MyStructWithUnexportedFields struct { a int; b bool; c []int; } + type GifImage struct { ... } + +As an illustration, MyStructWithUnexportedFields would normally be +encoded as an empty map because it has no exported fields, while UUID +would be encoded as a string. However, with extension support, you can +encode any of these however you like. + +## RPC + +RPC Client and Server Codecs are implemented, so the codecs can be used +with the standard net/rpc package. + +## Usage + +Typical usage model: + + // create and configure Handle + var ( + bh codec.BincHandle + mh codec.MsgpackHandle + ) + + mh.MapType = reflect.TypeOf(map[string]interface{}(nil)) + + // configure extensions + // e.g. for msgpack, define functions and enable Time support for tag 1 + // mh.AddExt(reflect.TypeOf(time.Time{}), 1, myMsgpackTimeEncodeExtFn, myMsgpackTimeDecodeExtFn) + + // create and use decoder/encoder + var ( + r io.Reader + w io.Writer + b []byte + h = &bh // or mh to use msgpack + ) + + dec = codec.NewDecoder(r, h) + dec = codec.NewDecoderBytes(b, h) + err = dec.Decode(&v) + + enc = codec.NewEncoder(w, h) + enc = codec.NewEncoderBytes(&b, h) + err = enc.Encode(v) + + //RPC Server + go func() { + for { + conn, err := listener.Accept() + rpcCodec := codec.GoRpc.ServerCodec(conn, h) + //OR rpcCodec := codec.MsgpackSpecRpc.ServerCodec(conn, h) + rpc.ServeCodec(rpcCodec) + } + }() + + //RPC Communication (client side) + conn, err = net.Dial("tcp", "localhost:5555") + rpcCodec := codec.GoRpc.ClientCodec(conn, h) + //OR rpcCodec := codec.MsgpackSpecRpc.ClientCodec(conn, h) + client := rpc.NewClientWithCodec(rpcCodec) + +## Representative Benchmark Results + +A sample run of benchmark using "go test -bi -bench=. -benchmem": + + /proc/cpuinfo: Intel(R) Core(TM) i7-2630QM CPU @ 2.00GHz (HT) + + .............................................. + BENCHMARK INIT: 2013-10-16 11:02:50.345970786 -0400 EDT + To run full benchmark comparing encodings (MsgPack, Binc, JSON, GOB, etc), use: "go test -bench=." + Benchmark: + Struct recursive Depth: 1 + ApproxDeepSize Of benchmark Struct: 4694 bytes + Benchmark One-Pass Run: + v-msgpack: len: 1600 bytes + bson: len: 3025 bytes + msgpack: len: 1560 bytes + binc: len: 1187 bytes + gob: len: 1972 bytes + json: len: 2538 bytes + .............................................. + PASS + Benchmark__Msgpack____Encode 50000 54359 ns/op 14953 B/op 83 allocs/op + Benchmark__Msgpack____Decode 10000 106531 ns/op 14990 B/op 410 allocs/op + Benchmark__Binc_NoSym_Encode 50000 53956 ns/op 14966 B/op 83 allocs/op + Benchmark__Binc_NoSym_Decode 10000 103751 ns/op 14529 B/op 386 allocs/op + Benchmark__Binc_Sym___Encode 50000 65961 ns/op 17130 B/op 88 allocs/op + Benchmark__Binc_Sym___Decode 10000 106310 ns/op 15857 B/op 287 allocs/op + Benchmark__Gob________Encode 10000 135944 ns/op 21189 B/op 237 allocs/op + Benchmark__Gob________Decode 5000 405390 ns/op 83460 B/op 1841 allocs/op + Benchmark__Json_______Encode 20000 79412 ns/op 13874 B/op 102 allocs/op + Benchmark__Json_______Decode 10000 247979 ns/op 14202 B/op 493 allocs/op + Benchmark__Bson_______Encode 10000 121762 ns/op 27814 B/op 514 allocs/op + Benchmark__Bson_______Decode 10000 162126 ns/op 16514 B/op 789 allocs/op + Benchmark__VMsgpack___Encode 50000 69155 ns/op 12370 B/op 344 allocs/op + Benchmark__VMsgpack___Decode 10000 151609 ns/op 20307 B/op 571 allocs/op + ok ugorji.net/codec 30.827s + +To run full benchmark suite (including against vmsgpack and bson), +see notes in ext\_dep\_test.go + diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/binc.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/binc.go new file mode 100644 index 0000000000..2bb5e8fee8 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/binc.go @@ -0,0 +1,786 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +import ( + "math" + // "reflect" + // "sync/atomic" + "time" + //"fmt" +) + +const bincDoPrune = true // No longer needed. Needed before as C lib did not support pruning. + +//var _ = fmt.Printf + +// vd as low 4 bits (there are 16 slots) +const ( + bincVdSpecial byte = iota + bincVdPosInt + bincVdNegInt + bincVdFloat + + bincVdString + bincVdByteArray + bincVdArray + bincVdMap + + bincVdTimestamp + bincVdSmallInt + bincVdUnicodeOther + bincVdSymbol + + bincVdDecimal + _ // open slot + _ // open slot + bincVdCustomExt = 0x0f +) + +const ( + bincSpNil byte = iota + bincSpFalse + bincSpTrue + bincSpNan + bincSpPosInf + bincSpNegInf + bincSpZeroFloat + bincSpZero + bincSpNegOne +) + +const ( + bincFlBin16 byte = iota + bincFlBin32 + _ // bincFlBin32e + bincFlBin64 + _ // bincFlBin64e + // others not currently supported +) + +type bincEncDriver struct { + w encWriter + m map[string]uint16 // symbols + s uint32 // symbols sequencer + b [8]byte +} + +func (e *bincEncDriver) isBuiltinType(rt uintptr) bool { + return rt == timeTypId +} + +func (e *bincEncDriver) encodeBuiltin(rt uintptr, v interface{}) { + switch rt { + case timeTypId: + bs := encodeTime(v.(time.Time)) + e.w.writen1(bincVdTimestamp<<4 | uint8(len(bs))) + e.w.writeb(bs) + } +} + +func (e *bincEncDriver) encodeNil() { + e.w.writen1(bincVdSpecial<<4 | bincSpNil) +} + +func (e *bincEncDriver) encodeBool(b bool) { + if b { + e.w.writen1(bincVdSpecial<<4 | bincSpTrue) + } else { + e.w.writen1(bincVdSpecial<<4 | bincSpFalse) + } +} + +func (e *bincEncDriver) encodeFloat32(f float32) { + if f == 0 { + e.w.writen1(bincVdSpecial<<4 | bincSpZeroFloat) + return + } + e.w.writen1(bincVdFloat<<4 | bincFlBin32) + e.w.writeUint32(math.Float32bits(f)) +} + +func (e *bincEncDriver) encodeFloat64(f float64) { + if f == 0 { + e.w.writen1(bincVdSpecial<<4 | bincSpZeroFloat) + return + } + bigen.PutUint64(e.b[:], math.Float64bits(f)) + if bincDoPrune { + i := 7 + for ; i >= 0 && (e.b[i] == 0); i-- { + } + i++ + if i <= 6 { + e.w.writen1(bincVdFloat<<4 | 0x8 | bincFlBin64) + e.w.writen1(byte(i)) + e.w.writeb(e.b[:i]) + return + } + } + e.w.writen1(bincVdFloat<<4 | bincFlBin64) + e.w.writeb(e.b[:]) +} + +func (e *bincEncDriver) encIntegerPrune(bd byte, pos bool, v uint64, lim uint8) { + if lim == 4 { + bigen.PutUint32(e.b[:lim], uint32(v)) + } else { + bigen.PutUint64(e.b[:lim], v) + } + if bincDoPrune { + i := pruneSignExt(e.b[:lim], pos) + e.w.writen1(bd | lim - 1 - byte(i)) + e.w.writeb(e.b[i:lim]) + } else { + e.w.writen1(bd | lim - 1) + e.w.writeb(e.b[:lim]) + } +} + +func (e *bincEncDriver) encodeInt(v int64) { + const nbd byte = bincVdNegInt << 4 + switch { + case v >= 0: + e.encUint(bincVdPosInt<<4, true, uint64(v)) + case v == -1: + e.w.writen1(bincVdSpecial<<4 | bincSpNegOne) + default: + e.encUint(bincVdNegInt<<4, false, uint64(-v)) + } +} + +func (e *bincEncDriver) encodeUint(v uint64) { + e.encUint(bincVdPosInt<<4, true, v) +} + +func (e *bincEncDriver) encUint(bd byte, pos bool, v uint64) { + switch { + case v == 0: + e.w.writen1(bincVdSpecial<<4 | bincSpZero) + case pos && v >= 1 && v <= 16: + e.w.writen1(bincVdSmallInt<<4 | byte(v-1)) + case v <= math.MaxUint8: + e.w.writen2(bd|0x0, byte(v)) + case v <= math.MaxUint16: + e.w.writen1(bd | 0x01) + e.w.writeUint16(uint16(v)) + case v <= math.MaxUint32: + e.encIntegerPrune(bd, pos, v, 4) + default: + e.encIntegerPrune(bd, pos, v, 8) + } +} + +func (e *bincEncDriver) encodeExtPreamble(xtag byte, length int) { + e.encLen(bincVdCustomExt<<4, uint64(length)) + e.w.writen1(xtag) +} + +func (e *bincEncDriver) encodeArrayPreamble(length int) { + e.encLen(bincVdArray<<4, uint64(length)) +} + +func (e *bincEncDriver) encodeMapPreamble(length int) { + e.encLen(bincVdMap<<4, uint64(length)) +} + +func (e *bincEncDriver) encodeString(c charEncoding, v string) { + l := uint64(len(v)) + e.encBytesLen(c, l) + if l > 0 { + e.w.writestr(v) + } +} + +func (e *bincEncDriver) encodeSymbol(v string) { + // if WriteSymbolsNoRefs { + // e.encodeString(c_UTF8, v) + // return + // } + + //symbols only offer benefit when string length > 1. + //This is because strings with length 1 take only 2 bytes to store + //(bd with embedded length, and single byte for string val). + + l := len(v) + switch l { + case 0: + e.encBytesLen(c_UTF8, 0) + return + case 1: + e.encBytesLen(c_UTF8, 1) + e.w.writen1(v[0]) + return + } + if e.m == nil { + e.m = make(map[string]uint16, 16) + } + ui, ok := e.m[v] + if ok { + if ui <= math.MaxUint8 { + e.w.writen2(bincVdSymbol<<4, byte(ui)) + } else { + e.w.writen1(bincVdSymbol<<4 | 0x8) + e.w.writeUint16(ui) + } + } else { + e.s++ + ui = uint16(e.s) + //ui = uint16(atomic.AddUint32(&e.s, 1)) + e.m[v] = ui + var lenprec uint8 + switch { + case l <= math.MaxUint8: + // lenprec = 0 + case l <= math.MaxUint16: + lenprec = 1 + case int64(l) <= math.MaxUint32: + lenprec = 2 + default: + lenprec = 3 + } + if ui <= math.MaxUint8 { + e.w.writen2(bincVdSymbol<<4|0x0|0x4|lenprec, byte(ui)) + } else { + e.w.writen1(bincVdSymbol<<4 | 0x8 | 0x4 | lenprec) + e.w.writeUint16(ui) + } + switch lenprec { + case 0: + e.w.writen1(byte(l)) + case 1: + e.w.writeUint16(uint16(l)) + case 2: + e.w.writeUint32(uint32(l)) + default: + e.w.writeUint64(uint64(l)) + } + e.w.writestr(v) + } +} + +func (e *bincEncDriver) encodeStringBytes(c charEncoding, v []byte) { + l := uint64(len(v)) + e.encBytesLen(c, l) + if l > 0 { + e.w.writeb(v) + } +} + +func (e *bincEncDriver) encBytesLen(c charEncoding, length uint64) { + //TODO: support bincUnicodeOther (for now, just use string or bytearray) + if c == c_RAW { + e.encLen(bincVdByteArray<<4, length) + } else { + e.encLen(bincVdString<<4, length) + } +} + +func (e *bincEncDriver) encLen(bd byte, l uint64) { + if l < 12 { + e.w.writen1(bd | uint8(l+4)) + } else { + e.encLenNumber(bd, l) + } +} + +func (e *bincEncDriver) encLenNumber(bd byte, v uint64) { + switch { + case v <= math.MaxUint8: + e.w.writen2(bd, byte(v)) + case v <= math.MaxUint16: + e.w.writen1(bd | 0x01) + e.w.writeUint16(uint16(v)) + case v <= math.MaxUint32: + e.w.writen1(bd | 0x02) + e.w.writeUint32(uint32(v)) + default: + e.w.writen1(bd | 0x03) + e.w.writeUint64(uint64(v)) + } +} + +//------------------------------------ + +type bincDecDriver struct { + r decReader + bdRead bool + bdType valueType + bd byte + vd byte + vs byte + b [8]byte + m map[uint32]string // symbols (use uint32 as key, as map optimizes for it) +} + +func (d *bincDecDriver) initReadNext() { + if d.bdRead { + return + } + d.bd = d.r.readn1() + d.vd = d.bd >> 4 + d.vs = d.bd & 0x0f + d.bdRead = true + d.bdType = valueTypeUnset +} + +func (d *bincDecDriver) currentEncodedType() valueType { + if d.bdType == valueTypeUnset { + switch d.vd { + case bincVdSpecial: + switch d.vs { + case bincSpNil: + d.bdType = valueTypeNil + case bincSpFalse, bincSpTrue: + d.bdType = valueTypeBool + case bincSpNan, bincSpNegInf, bincSpPosInf, bincSpZeroFloat: + d.bdType = valueTypeFloat + case bincSpZero: + d.bdType = valueTypeUint + case bincSpNegOne: + d.bdType = valueTypeInt + default: + decErr("currentEncodedType: Unrecognized special value 0x%x", d.vs) + } + case bincVdSmallInt: + d.bdType = valueTypeUint + case bincVdPosInt: + d.bdType = valueTypeUint + case bincVdNegInt: + d.bdType = valueTypeInt + case bincVdFloat: + d.bdType = valueTypeFloat + case bincVdString: + d.bdType = valueTypeString + case bincVdSymbol: + d.bdType = valueTypeSymbol + case bincVdByteArray: + d.bdType = valueTypeBytes + case bincVdTimestamp: + d.bdType = valueTypeTimestamp + case bincVdCustomExt: + d.bdType = valueTypeExt + case bincVdArray: + d.bdType = valueTypeArray + case bincVdMap: + d.bdType = valueTypeMap + default: + decErr("currentEncodedType: Unrecognized d.vd: 0x%x", d.vd) + } + } + return d.bdType +} + +func (d *bincDecDriver) tryDecodeAsNil() bool { + if d.bd == bincVdSpecial<<4|bincSpNil { + d.bdRead = false + return true + } + return false +} + +func (d *bincDecDriver) isBuiltinType(rt uintptr) bool { + return rt == timeTypId +} + +func (d *bincDecDriver) decodeBuiltin(rt uintptr, v interface{}) { + switch rt { + case timeTypId: + if d.vd != bincVdTimestamp { + decErr("Invalid d.vd. Expecting 0x%x. Received: 0x%x", bincVdTimestamp, d.vd) + } + tt, err := decodeTime(d.r.readn(int(d.vs))) + if err != nil { + panic(err) + } + var vt *time.Time = v.(*time.Time) + *vt = tt + d.bdRead = false + } +} + +func (d *bincDecDriver) decFloatPre(vs, defaultLen byte) { + if vs&0x8 == 0 { + d.r.readb(d.b[0:defaultLen]) + } else { + l := d.r.readn1() + if l > 8 { + decErr("At most 8 bytes used to represent float. Received: %v bytes", l) + } + for i := l; i < 8; i++ { + d.b[i] = 0 + } + d.r.readb(d.b[0:l]) + } +} + +func (d *bincDecDriver) decFloat() (f float64) { + //if true { f = math.Float64frombits(d.r.readUint64()); break; } + switch vs := d.vs; vs & 0x7 { + case bincFlBin32: + d.decFloatPre(vs, 4) + f = float64(math.Float32frombits(bigen.Uint32(d.b[0:4]))) + case bincFlBin64: + d.decFloatPre(vs, 8) + f = math.Float64frombits(bigen.Uint64(d.b[0:8])) + default: + decErr("only float32 and float64 are supported. d.vd: 0x%x, d.vs: 0x%x", d.vd, d.vs) + } + return +} + +func (d *bincDecDriver) decUint() (v uint64) { + // need to inline the code (interface conversion and type assertion expensive) + switch d.vs { + case 0: + v = uint64(d.r.readn1()) + case 1: + d.r.readb(d.b[6:]) + v = uint64(bigen.Uint16(d.b[6:])) + case 2: + d.b[4] = 0 + d.r.readb(d.b[5:]) + v = uint64(bigen.Uint32(d.b[4:])) + case 3: + d.r.readb(d.b[4:]) + v = uint64(bigen.Uint32(d.b[4:])) + case 4, 5, 6: + lim := int(7 - d.vs) + d.r.readb(d.b[lim:]) + for i := 0; i < lim; i++ { + d.b[i] = 0 + } + v = uint64(bigen.Uint64(d.b[:])) + case 7: + d.r.readb(d.b[:]) + v = uint64(bigen.Uint64(d.b[:])) + default: + decErr("unsigned integers with greater than 64 bits of precision not supported") + } + return +} + +func (d *bincDecDriver) decIntAny() (ui uint64, i int64, neg bool) { + switch d.vd { + case bincVdPosInt: + ui = d.decUint() + i = int64(ui) + case bincVdNegInt: + ui = d.decUint() + i = -(int64(ui)) + neg = true + case bincVdSmallInt: + i = int64(d.vs) + 1 + ui = uint64(d.vs) + 1 + case bincVdSpecial: + switch d.vs { + case bincSpZero: + //i = 0 + case bincSpNegOne: + neg = true + ui = 1 + i = -1 + default: + decErr("numeric decode fails for special value: d.vs: 0x%x", d.vs) + } + default: + decErr("number can only be decoded from uint or int values. d.bd: 0x%x, d.vd: 0x%x", d.bd, d.vd) + } + return +} + +func (d *bincDecDriver) decodeInt(bitsize uint8) (i int64) { + _, i, _ = d.decIntAny() + checkOverflow(0, i, bitsize) + d.bdRead = false + return +} + +func (d *bincDecDriver) decodeUint(bitsize uint8) (ui uint64) { + ui, i, neg := d.decIntAny() + if neg { + decErr("Assigning negative signed value: %v, to unsigned type", i) + } + checkOverflow(ui, 0, bitsize) + d.bdRead = false + return +} + +func (d *bincDecDriver) decodeFloat(chkOverflow32 bool) (f float64) { + switch d.vd { + case bincVdSpecial: + d.bdRead = false + switch d.vs { + case bincSpNan: + return math.NaN() + case bincSpPosInf: + return math.Inf(1) + case bincSpZeroFloat, bincSpZero: + return + case bincSpNegInf: + return math.Inf(-1) + default: + decErr("Invalid d.vs decoding float where d.vd=bincVdSpecial: %v", d.vs) + } + case bincVdFloat: + f = d.decFloat() + default: + _, i, _ := d.decIntAny() + f = float64(i) + } + checkOverflowFloat32(f, chkOverflow32) + d.bdRead = false + return +} + +// bool can be decoded from bool only (single byte). +func (d *bincDecDriver) decodeBool() (b bool) { + switch d.bd { + case (bincVdSpecial | bincSpFalse): + // b = false + case (bincVdSpecial | bincSpTrue): + b = true + default: + decErr("Invalid single-byte value for bool: %s: %x", msgBadDesc, d.bd) + } + d.bdRead = false + return +} + +func (d *bincDecDriver) readMapLen() (length int) { + if d.vd != bincVdMap { + decErr("Invalid d.vd for map. Expecting 0x%x. Got: 0x%x", bincVdMap, d.vd) + } + length = d.decLen() + d.bdRead = false + return +} + +func (d *bincDecDriver) readArrayLen() (length int) { + if d.vd != bincVdArray { + decErr("Invalid d.vd for array. Expecting 0x%x. Got: 0x%x", bincVdArray, d.vd) + } + length = d.decLen() + d.bdRead = false + return +} + +func (d *bincDecDriver) decLen() int { + if d.vs <= 3 { + return int(d.decUint()) + } + return int(d.vs - 4) +} + +func (d *bincDecDriver) decodeString() (s string) { + switch d.vd { + case bincVdString, bincVdByteArray: + if length := d.decLen(); length > 0 { + s = string(d.r.readn(length)) + } + case bincVdSymbol: + //from vs: extract numSymbolBytes, containsStringVal, strLenPrecision, + //extract symbol + //if containsStringVal, read it and put in map + //else look in map for string value + var symbol uint32 + vs := d.vs + //fmt.Printf(">>>> d.vs: 0b%b, & 0x8: %v, & 0x4: %v\n", d.vs, vs & 0x8, vs & 0x4) + if vs&0x8 == 0 { + symbol = uint32(d.r.readn1()) + } else { + symbol = uint32(d.r.readUint16()) + } + if d.m == nil { + d.m = make(map[uint32]string, 16) + } + + if vs&0x4 == 0 { + s = d.m[symbol] + } else { + var slen int + switch vs & 0x3 { + case 0: + slen = int(d.r.readn1()) + case 1: + slen = int(d.r.readUint16()) + case 2: + slen = int(d.r.readUint32()) + case 3: + slen = int(d.r.readUint64()) + } + s = string(d.r.readn(slen)) + d.m[symbol] = s + } + default: + decErr("Invalid d.vd for string. Expecting string:0x%x, bytearray:0x%x or symbol: 0x%x. Got: 0x%x", + bincVdString, bincVdByteArray, bincVdSymbol, d.vd) + } + d.bdRead = false + return +} + +func (d *bincDecDriver) decodeBytes(bs []byte) (bsOut []byte, changed bool) { + var clen int + switch d.vd { + case bincVdString, bincVdByteArray: + clen = d.decLen() + default: + decErr("Invalid d.vd for bytes. Expecting string:0x%x or bytearray:0x%x. Got: 0x%x", + bincVdString, bincVdByteArray, d.vd) + } + if clen > 0 { + // if no contents in stream, don't update the passed byteslice + if len(bs) != clen { + if len(bs) > clen { + bs = bs[:clen] + } else { + bs = make([]byte, clen) + } + bsOut = bs + changed = true + } + d.r.readb(bs) + } + d.bdRead = false + return +} + +func (d *bincDecDriver) decodeExt(verifyTag bool, tag byte) (xtag byte, xbs []byte) { + switch d.vd { + case bincVdCustomExt: + l := d.decLen() + xtag = d.r.readn1() + if verifyTag && xtag != tag { + decErr("Wrong extension tag. Got %b. Expecting: %v", xtag, tag) + } + xbs = d.r.readn(l) + case bincVdByteArray: + xbs, _ = d.decodeBytes(nil) + default: + decErr("Invalid d.vd for extensions (Expecting extensions or byte array). Got: 0x%x", d.vd) + } + d.bdRead = false + return +} + +func (d *bincDecDriver) decodeNaked() (v interface{}, vt valueType, decodeFurther bool) { + d.initReadNext() + + switch d.vd { + case bincVdSpecial: + switch d.vs { + case bincSpNil: + vt = valueTypeNil + case bincSpFalse: + vt = valueTypeBool + v = false + case bincSpTrue: + vt = valueTypeBool + v = true + case bincSpNan: + vt = valueTypeFloat + v = math.NaN() + case bincSpPosInf: + vt = valueTypeFloat + v = math.Inf(1) + case bincSpNegInf: + vt = valueTypeFloat + v = math.Inf(-1) + case bincSpZeroFloat: + vt = valueTypeFloat + v = float64(0) + case bincSpZero: + vt = valueTypeUint + v = int64(0) // int8(0) + case bincSpNegOne: + vt = valueTypeInt + v = int64(-1) // int8(-1) + default: + decErr("decodeNaked: Unrecognized special value 0x%x", d.vs) + } + case bincVdSmallInt: + vt = valueTypeUint + v = uint64(int8(d.vs)) + 1 // int8(d.vs) + 1 + case bincVdPosInt: + vt = valueTypeUint + v = d.decUint() + case bincVdNegInt: + vt = valueTypeInt + v = -(int64(d.decUint())) + case bincVdFloat: + vt = valueTypeFloat + v = d.decFloat() + case bincVdSymbol: + vt = valueTypeSymbol + v = d.decodeString() + case bincVdString: + vt = valueTypeString + v = d.decodeString() + case bincVdByteArray: + vt = valueTypeBytes + v, _ = d.decodeBytes(nil) + case bincVdTimestamp: + vt = valueTypeTimestamp + tt, err := decodeTime(d.r.readn(int(d.vs))) + if err != nil { + panic(err) + } + v = tt + case bincVdCustomExt: + vt = valueTypeExt + l := d.decLen() + var re RawExt + re.Tag = d.r.readn1() + re.Data = d.r.readn(l) + v = &re + vt = valueTypeExt + case bincVdArray: + vt = valueTypeArray + decodeFurther = true + case bincVdMap: + vt = valueTypeMap + decodeFurther = true + default: + decErr("decodeNaked: Unrecognized d.vd: 0x%x", d.vd) + } + + if !decodeFurther { + d.bdRead = false + } + return +} + +//------------------------------------ + +//BincHandle is a Handle for the Binc Schema-Free Encoding Format +//defined at https://github.com/ugorji/binc . +// +//BincHandle currently supports all Binc features with the following EXCEPTIONS: +// - only integers up to 64 bits of precision are supported. +// big integers are unsupported. +// - Only IEEE 754 binary32 and binary64 floats are supported (ie Go float32 and float64 types). +// extended precision and decimal IEEE 754 floats are unsupported. +// - Only UTF-8 strings supported. +// Unicode_Other Binc types (UTF16, UTF32) are currently unsupported. +//Note that these EXCEPTIONS are temporary and full support is possible and may happen soon. +type BincHandle struct { + BasicHandle +} + +func (h *BincHandle) newEncDriver(w encWriter) encDriver { + return &bincEncDriver{w: w} +} + +func (h *BincHandle) newDecDriver(r decReader) decDriver { + return &bincDecDriver{r: r} +} + +func (_ *BincHandle) writeExt() bool { + return true +} + +func (h *BincHandle) getBasicHandle() *BasicHandle { + return &h.BasicHandle +} diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/decode.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/decode.go new file mode 100644 index 0000000000..87bef2b935 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/decode.go @@ -0,0 +1,1048 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +import ( + "io" + "reflect" + // "runtime/debug" +) + +// Some tagging information for error messages. +const ( + msgTagDec = "codec.decoder" + msgBadDesc = "Unrecognized descriptor byte" + msgDecCannotExpandArr = "cannot expand go array from %v to stream length: %v" +) + +// decReader abstracts the reading source, allowing implementations that can +// read from an io.Reader or directly off a byte slice with zero-copying. +type decReader interface { + readn(n int) []byte + readb([]byte) + readn1() uint8 + readUint16() uint16 + readUint32() uint32 + readUint64() uint64 +} + +type decDriver interface { + initReadNext() + tryDecodeAsNil() bool + currentEncodedType() valueType + isBuiltinType(rt uintptr) bool + decodeBuiltin(rt uintptr, v interface{}) + //decodeNaked: Numbers are decoded as int64, uint64, float64 only (no smaller sized number types). + decodeNaked() (v interface{}, vt valueType, decodeFurther bool) + decodeInt(bitsize uint8) (i int64) + decodeUint(bitsize uint8) (ui uint64) + decodeFloat(chkOverflow32 bool) (f float64) + decodeBool() (b bool) + // decodeString can also decode symbols + decodeString() (s string) + decodeBytes(bs []byte) (bsOut []byte, changed bool) + decodeExt(verifyTag bool, tag byte) (xtag byte, xbs []byte) + readMapLen() int + readArrayLen() int +} + +type DecodeOptions struct { + // An instance of MapType is used during schema-less decoding of a map in the stream. + // If nil, we use map[interface{}]interface{} + MapType reflect.Type + // An instance of SliceType is used during schema-less decoding of an array in the stream. + // If nil, we use []interface{} + SliceType reflect.Type + // ErrorIfNoField controls whether an error is returned when decoding a map + // from a codec stream into a struct, and no matching struct field is found. + ErrorIfNoField bool +} + +// ------------------------------------ + +// ioDecReader is a decReader that reads off an io.Reader +type ioDecReader struct { + r io.Reader + br io.ByteReader + x [8]byte //temp byte array re-used internally for efficiency +} + +func (z *ioDecReader) readn(n int) (bs []byte) { + if n <= 0 { + return + } + bs = make([]byte, n) + if _, err := io.ReadAtLeast(z.r, bs, n); err != nil { + panic(err) + } + return +} + +func (z *ioDecReader) readb(bs []byte) { + if _, err := io.ReadAtLeast(z.r, bs, len(bs)); err != nil { + panic(err) + } +} + +func (z *ioDecReader) readn1() uint8 { + if z.br != nil { + b, err := z.br.ReadByte() + if err != nil { + panic(err) + } + return b + } + z.readb(z.x[:1]) + return z.x[0] +} + +func (z *ioDecReader) readUint16() uint16 { + z.readb(z.x[:2]) + return bigen.Uint16(z.x[:2]) +} + +func (z *ioDecReader) readUint32() uint32 { + z.readb(z.x[:4]) + return bigen.Uint32(z.x[:4]) +} + +func (z *ioDecReader) readUint64() uint64 { + z.readb(z.x[:8]) + return bigen.Uint64(z.x[:8]) +} + +// ------------------------------------ + +// bytesDecReader is a decReader that reads off a byte slice with zero copying +type bytesDecReader struct { + b []byte // data + c int // cursor + a int // available +} + +func (z *bytesDecReader) consume(n int) (oldcursor int) { + if z.a == 0 { + panic(io.EOF) + } + if n > z.a { + decErr("Trying to read %v bytes. Only %v available", n, z.a) + } + // z.checkAvailable(n) + oldcursor = z.c + z.c = oldcursor + n + z.a = z.a - n + return +} + +func (z *bytesDecReader) readn(n int) (bs []byte) { + if n <= 0 { + return + } + c0 := z.consume(n) + bs = z.b[c0:z.c] + return +} + +func (z *bytesDecReader) readb(bs []byte) { + copy(bs, z.readn(len(bs))) +} + +func (z *bytesDecReader) readn1() uint8 { + c0 := z.consume(1) + return z.b[c0] +} + +// Use binaryEncoding helper for 4 and 8 bits, but inline it for 2 bits +// creating temp slice variable and copying it to helper function is expensive +// for just 2 bits. + +func (z *bytesDecReader) readUint16() uint16 { + c0 := z.consume(2) + return uint16(z.b[c0+1]) | uint16(z.b[c0])<<8 +} + +func (z *bytesDecReader) readUint32() uint32 { + c0 := z.consume(4) + return bigen.Uint32(z.b[c0:z.c]) +} + +func (z *bytesDecReader) readUint64() uint64 { + c0 := z.consume(8) + return bigen.Uint64(z.b[c0:z.c]) +} + +// ------------------------------------ + +// decFnInfo has methods for registering handling decoding of a specific type +// based on some characteristics (builtin, extension, reflect Kind, etc) +type decFnInfo struct { + ti *typeInfo + d *Decoder + dd decDriver + xfFn func(reflect.Value, []byte) error + xfTag byte + array bool +} + +func (f *decFnInfo) builtin(rv reflect.Value) { + f.dd.decodeBuiltin(f.ti.rtid, rv.Addr().Interface()) +} + +func (f *decFnInfo) rawExt(rv reflect.Value) { + xtag, xbs := f.dd.decodeExt(false, 0) + rv.Field(0).SetUint(uint64(xtag)) + rv.Field(1).SetBytes(xbs) +} + +func (f *decFnInfo) ext(rv reflect.Value) { + _, xbs := f.dd.decodeExt(true, f.xfTag) + if fnerr := f.xfFn(rv, xbs); fnerr != nil { + panic(fnerr) + } +} + +func (f *decFnInfo) binaryMarshal(rv reflect.Value) { + var bm binaryUnmarshaler + if f.ti.unmIndir == -1 { + bm = rv.Addr().Interface().(binaryUnmarshaler) + } else if f.ti.unmIndir == 0 { + bm = rv.Interface().(binaryUnmarshaler) + } else { + for j, k := int8(0), f.ti.unmIndir; j < k; j++ { + if rv.IsNil() { + rv.Set(reflect.New(rv.Type().Elem())) + } + rv = rv.Elem() + } + bm = rv.Interface().(binaryUnmarshaler) + } + xbs, _ := f.dd.decodeBytes(nil) + if fnerr := bm.UnmarshalBinary(xbs); fnerr != nil { + panic(fnerr) + } +} + +func (f *decFnInfo) kErr(rv reflect.Value) { + decErr("Unhandled value for kind: %v: %s", rv.Kind(), msgBadDesc) +} + +func (f *decFnInfo) kString(rv reflect.Value) { + rv.SetString(f.dd.decodeString()) +} + +func (f *decFnInfo) kBool(rv reflect.Value) { + rv.SetBool(f.dd.decodeBool()) +} + +func (f *decFnInfo) kInt(rv reflect.Value) { + rv.SetInt(f.dd.decodeInt(intBitsize)) +} + +func (f *decFnInfo) kInt64(rv reflect.Value) { + rv.SetInt(f.dd.decodeInt(64)) +} + +func (f *decFnInfo) kInt32(rv reflect.Value) { + rv.SetInt(f.dd.decodeInt(32)) +} + +func (f *decFnInfo) kInt8(rv reflect.Value) { + rv.SetInt(f.dd.decodeInt(8)) +} + +func (f *decFnInfo) kInt16(rv reflect.Value) { + rv.SetInt(f.dd.decodeInt(16)) +} + +func (f *decFnInfo) kFloat32(rv reflect.Value) { + rv.SetFloat(f.dd.decodeFloat(true)) +} + +func (f *decFnInfo) kFloat64(rv reflect.Value) { + rv.SetFloat(f.dd.decodeFloat(false)) +} + +func (f *decFnInfo) kUint8(rv reflect.Value) { + rv.SetUint(f.dd.decodeUint(8)) +} + +func (f *decFnInfo) kUint64(rv reflect.Value) { + rv.SetUint(f.dd.decodeUint(64)) +} + +func (f *decFnInfo) kUint(rv reflect.Value) { + rv.SetUint(f.dd.decodeUint(uintBitsize)) +} + +func (f *decFnInfo) kUint32(rv reflect.Value) { + rv.SetUint(f.dd.decodeUint(32)) +} + +func (f *decFnInfo) kUint16(rv reflect.Value) { + rv.SetUint(f.dd.decodeUint(16)) +} + +// func (f *decFnInfo) kPtr(rv reflect.Value) { +// debugf(">>>>>>> ??? decode kPtr called - shouldn't get called") +// if rv.IsNil() { +// rv.Set(reflect.New(rv.Type().Elem())) +// } +// f.d.decodeValue(rv.Elem()) +// } + +func (f *decFnInfo) kInterface(rv reflect.Value) { + // debugf("\t===> kInterface") + if !rv.IsNil() { + f.d.decodeValue(rv.Elem()) + return + } + // nil interface: + // use some hieristics to set the nil interface to an + // appropriate value based on the first byte read (byte descriptor bd) + v, vt, decodeFurther := f.dd.decodeNaked() + if vt == valueTypeNil { + return + } + // Cannot decode into nil interface with methods (e.g. error, io.Reader, etc) + // if non-nil value in stream. + if num := f.ti.rt.NumMethod(); num > 0 { + decErr("decodeValue: Cannot decode non-nil codec value into nil %v (%v methods)", + f.ti.rt, num) + } + var rvn reflect.Value + var useRvn bool + switch vt { + case valueTypeMap: + if f.d.h.MapType == nil { + var m2 map[interface{}]interface{} + v = &m2 + } else { + rvn = reflect.New(f.d.h.MapType).Elem() + useRvn = true + } + case valueTypeArray: + if f.d.h.SliceType == nil { + var m2 []interface{} + v = &m2 + } else { + rvn = reflect.New(f.d.h.SliceType).Elem() + useRvn = true + } + case valueTypeExt: + re := v.(*RawExt) + var bfn func(reflect.Value, []byte) error + rvn, bfn = f.d.h.getDecodeExtForTag(re.Tag) + if bfn == nil { + rvn = reflect.ValueOf(*re) + } else if fnerr := bfn(rvn, re.Data); fnerr != nil { + panic(fnerr) + } + rv.Set(rvn) + return + } + if decodeFurther { + if useRvn { + f.d.decodeValue(rvn) + } else if v != nil { + // this v is a pointer, so we need to dereference it when done + f.d.decode(v) + rvn = reflect.ValueOf(v).Elem() + useRvn = true + } + } + if useRvn { + rv.Set(rvn) + } else if v != nil { + rv.Set(reflect.ValueOf(v)) + } +} + +func (f *decFnInfo) kStruct(rv reflect.Value) { + fti := f.ti + if currEncodedType := f.dd.currentEncodedType(); currEncodedType == valueTypeMap { + containerLen := f.dd.readMapLen() + if containerLen == 0 { + return + } + tisfi := fti.sfi + for j := 0; j < containerLen; j++ { + // var rvkencname string + // ddecode(&rvkencname) + f.dd.initReadNext() + rvkencname := f.dd.decodeString() + // rvksi := ti.getForEncName(rvkencname) + if k := fti.indexForEncName(rvkencname); k > -1 { + sfik := tisfi[k] + if sfik.i != -1 { + f.d.decodeValue(rv.Field(int(sfik.i))) + } else { + f.d.decEmbeddedField(rv, sfik.is) + } + // f.d.decodeValue(ti.field(k, rv)) + } else { + if f.d.h.ErrorIfNoField { + decErr("No matching struct field found when decoding stream map with key: %v", + rvkencname) + } else { + var nilintf0 interface{} + f.d.decodeValue(reflect.ValueOf(&nilintf0).Elem()) + } + } + } + } else if currEncodedType == valueTypeArray { + containerLen := f.dd.readArrayLen() + if containerLen == 0 { + return + } + for j, si := range fti.sfip { + if j == containerLen { + break + } + if si.i != -1 { + f.d.decodeValue(rv.Field(int(si.i))) + } else { + f.d.decEmbeddedField(rv, si.is) + } + } + if containerLen > len(fti.sfip) { + // read remaining values and throw away + for j := len(fti.sfip); j < containerLen; j++ { + var nilintf0 interface{} + f.d.decodeValue(reflect.ValueOf(&nilintf0).Elem()) + } + } + } else { + decErr("Only encoded map or array can be decoded into a struct. (valueType: %x)", + currEncodedType) + } +} + +func (f *decFnInfo) kSlice(rv reflect.Value) { + // A slice can be set from a map or array in stream. + currEncodedType := f.dd.currentEncodedType() + + switch currEncodedType { + case valueTypeBytes, valueTypeString: + if f.ti.rtid == uint8SliceTypId || f.ti.rt.Elem().Kind() == reflect.Uint8 { + if bs2, changed2 := f.dd.decodeBytes(rv.Bytes()); changed2 { + rv.SetBytes(bs2) + } + return + } + } + + if shortCircuitReflectToFastPath && rv.CanAddr() { + switch f.ti.rtid { + case intfSliceTypId: + f.d.decSliceIntf(rv.Addr().Interface().(*[]interface{}), currEncodedType, f.array) + return + case uint64SliceTypId: + f.d.decSliceUint64(rv.Addr().Interface().(*[]uint64), currEncodedType, f.array) + return + case int64SliceTypId: + f.d.decSliceInt64(rv.Addr().Interface().(*[]int64), currEncodedType, f.array) + return + case strSliceTypId: + f.d.decSliceStr(rv.Addr().Interface().(*[]string), currEncodedType, f.array) + return + } + } + + containerLen, containerLenS := decContLens(f.dd, currEncodedType) + + // an array can never return a nil slice. so no need to check f.array here. + + if rv.IsNil() { + rv.Set(reflect.MakeSlice(f.ti.rt, containerLenS, containerLenS)) + } + + if containerLen == 0 { + return + } + + if rvcap, rvlen := rv.Len(), rv.Cap(); containerLenS > rvcap { + if f.array { // !rv.CanSet() + decErr(msgDecCannotExpandArr, rvcap, containerLenS) + } + rvn := reflect.MakeSlice(f.ti.rt, containerLenS, containerLenS) + if rvlen > 0 { + reflect.Copy(rvn, rv) + } + rv.Set(rvn) + } else if containerLenS > rvlen { + rv.SetLen(containerLenS) + } + + for j := 0; j < containerLenS; j++ { + f.d.decodeValue(rv.Index(j)) + } +} + +func (f *decFnInfo) kArray(rv reflect.Value) { + // f.d.decodeValue(rv.Slice(0, rv.Len())) + f.kSlice(rv.Slice(0, rv.Len())) +} + +func (f *decFnInfo) kMap(rv reflect.Value) { + if shortCircuitReflectToFastPath && rv.CanAddr() { + switch f.ti.rtid { + case mapStrIntfTypId: + f.d.decMapStrIntf(rv.Addr().Interface().(*map[string]interface{})) + return + case mapIntfIntfTypId: + f.d.decMapIntfIntf(rv.Addr().Interface().(*map[interface{}]interface{})) + return + case mapInt64IntfTypId: + f.d.decMapInt64Intf(rv.Addr().Interface().(*map[int64]interface{})) + return + case mapUint64IntfTypId: + f.d.decMapUint64Intf(rv.Addr().Interface().(*map[uint64]interface{})) + return + } + } + + containerLen := f.dd.readMapLen() + + if rv.IsNil() { + rv.Set(reflect.MakeMap(f.ti.rt)) + } + + if containerLen == 0 { + return + } + + ktype, vtype := f.ti.rt.Key(), f.ti.rt.Elem() + ktypeId := reflect.ValueOf(ktype).Pointer() + for j := 0; j < containerLen; j++ { + rvk := reflect.New(ktype).Elem() + f.d.decodeValue(rvk) + + // special case if a byte array. + // if ktype == intfTyp { + if ktypeId == intfTypId { + rvk = rvk.Elem() + if rvk.Type() == uint8SliceTyp { + rvk = reflect.ValueOf(string(rvk.Bytes())) + } + } + rvv := rv.MapIndex(rvk) + if !rvv.IsValid() { + rvv = reflect.New(vtype).Elem() + } + + f.d.decodeValue(rvv) + rv.SetMapIndex(rvk, rvv) + } +} + +// ---------------------------------------- + +type decFn struct { + i *decFnInfo + f func(*decFnInfo, reflect.Value) +} + +// A Decoder reads and decodes an object from an input stream in the codec format. +type Decoder struct { + r decReader + d decDriver + h *BasicHandle + f map[uintptr]decFn + x []uintptr + s []decFn +} + +// NewDecoder returns a Decoder for decoding a stream of bytes from an io.Reader. +// +// For efficiency, Users are encouraged to pass in a memory buffered writer +// (eg bufio.Reader, bytes.Buffer). +func NewDecoder(r io.Reader, h Handle) *Decoder { + z := ioDecReader{ + r: r, + } + z.br, _ = r.(io.ByteReader) + return &Decoder{r: &z, d: h.newDecDriver(&z), h: h.getBasicHandle()} +} + +// NewDecoderBytes returns a Decoder which efficiently decodes directly +// from a byte slice with zero copying. +func NewDecoderBytes(in []byte, h Handle) *Decoder { + z := bytesDecReader{ + b: in, + a: len(in), + } + return &Decoder{r: &z, d: h.newDecDriver(&z), h: h.getBasicHandle()} +} + +// Decode decodes the stream from reader and stores the result in the +// value pointed to by v. v cannot be a nil pointer. v can also be +// a reflect.Value of a pointer. +// +// Note that a pointer to a nil interface is not a nil pointer. +// If you do not know what type of stream it is, pass in a pointer to a nil interface. +// We will decode and store a value in that nil interface. +// +// Sample usages: +// // Decoding into a non-nil typed value +// var f float32 +// err = codec.NewDecoder(r, handle).Decode(&f) +// +// // Decoding into nil interface +// var v interface{} +// dec := codec.NewDecoder(r, handle) +// err = dec.Decode(&v) +// +// When decoding into a nil interface{}, we will decode into an appropriate value based +// on the contents of the stream: +// - Numbers are decoded as float64, int64 or uint64. +// - Other values are decoded appropriately depending on the type: +// bool, string, []byte, time.Time, etc +// - Extensions are decoded as RawExt (if no ext function registered for the tag) +// Configurations exist on the Handle to override defaults +// (e.g. for MapType, SliceType and how to decode raw bytes). +// +// When decoding into a non-nil interface{} value, the mode of encoding is based on the +// type of the value. When a value is seen: +// - If an extension is registered for it, call that extension function +// - If it implements BinaryUnmarshaler, call its UnmarshalBinary(data []byte) error +// - Else decode it based on its reflect.Kind +// +// There are some special rules when decoding into containers (slice/array/map/struct). +// Decode will typically use the stream contents to UPDATE the container. +// - A map can be decoded from a stream map, by updating matching keys. +// - A slice can be decoded from a stream array, +// by updating the first n elements, where n is length of the stream. +// - A slice can be decoded from a stream map, by decoding as if +// it contains a sequence of key-value pairs. +// - A struct can be decoded from a stream map, by updating matching fields. +// - A struct can be decoded from a stream array, +// by updating fields as they occur in the struct (by index). +// +// When decoding a stream map or array with length of 0 into a nil map or slice, +// we reset the destination map or slice to a zero-length value. +// +// However, when decoding a stream nil, we reset the destination container +// to its "zero" value (e.g. nil for slice/map, etc). +// +func (d *Decoder) Decode(v interface{}) (err error) { + defer panicToErr(&err) + d.decode(v) + return +} + +func (d *Decoder) decode(iv interface{}) { + d.d.initReadNext() + + switch v := iv.(type) { + case nil: + decErr("Cannot decode into nil.") + + case reflect.Value: + d.chkPtrValue(v) + d.decodeValue(v.Elem()) + + case *string: + *v = d.d.decodeString() + case *bool: + *v = d.d.decodeBool() + case *int: + *v = int(d.d.decodeInt(intBitsize)) + case *int8: + *v = int8(d.d.decodeInt(8)) + case *int16: + *v = int16(d.d.decodeInt(16)) + case *int32: + *v = int32(d.d.decodeInt(32)) + case *int64: + *v = d.d.decodeInt(64) + case *uint: + *v = uint(d.d.decodeUint(uintBitsize)) + case *uint8: + *v = uint8(d.d.decodeUint(8)) + case *uint16: + *v = uint16(d.d.decodeUint(16)) + case *uint32: + *v = uint32(d.d.decodeUint(32)) + case *uint64: + *v = d.d.decodeUint(64) + case *float32: + *v = float32(d.d.decodeFloat(true)) + case *float64: + *v = d.d.decodeFloat(false) + case *[]byte: + *v, _ = d.d.decodeBytes(*v) + + case *[]interface{}: + d.decSliceIntf(v, valueTypeInvalid, false) + case *[]uint64: + d.decSliceUint64(v, valueTypeInvalid, false) + case *[]int64: + d.decSliceInt64(v, valueTypeInvalid, false) + case *[]string: + d.decSliceStr(v, valueTypeInvalid, false) + case *map[string]interface{}: + d.decMapStrIntf(v) + case *map[interface{}]interface{}: + d.decMapIntfIntf(v) + case *map[uint64]interface{}: + d.decMapUint64Intf(v) + case *map[int64]interface{}: + d.decMapInt64Intf(v) + + case *interface{}: + d.decodeValue(reflect.ValueOf(iv).Elem()) + + default: + rv := reflect.ValueOf(iv) + d.chkPtrValue(rv) + d.decodeValue(rv.Elem()) + } +} + +func (d *Decoder) decodeValue(rv reflect.Value) { + d.d.initReadNext() + + if d.d.tryDecodeAsNil() { + // If value in stream is nil, set the dereferenced value to its "zero" value (if settable) + if rv.Kind() == reflect.Ptr { + if !rv.IsNil() { + rv.Set(reflect.Zero(rv.Type())) + } + return + } + // for rv.Kind() == reflect.Ptr { + // rv = rv.Elem() + // } + if rv.IsValid() { // rv.CanSet() // always settable, except it's invalid + rv.Set(reflect.Zero(rv.Type())) + } + return + } + + // If stream is not containing a nil value, then we can deref to the base + // non-pointer value, and decode into that. + for rv.Kind() == reflect.Ptr { + if rv.IsNil() { + rv.Set(reflect.New(rv.Type().Elem())) + } + rv = rv.Elem() + } + + rt := rv.Type() + rtid := reflect.ValueOf(rt).Pointer() + + // retrieve or register a focus'ed function for this type + // to eliminate need to do the retrieval multiple times + + // if d.f == nil && d.s == nil { debugf("---->Creating new dec f map for type: %v\n", rt) } + var fn decFn + var ok bool + if useMapForCodecCache { + fn, ok = d.f[rtid] + } else { + for i, v := range d.x { + if v == rtid { + fn, ok = d.s[i], true + break + } + } + } + if !ok { + // debugf("\tCreating new dec fn for type: %v\n", rt) + fi := decFnInfo{ti: getTypeInfo(rtid, rt), d: d, dd: d.d} + fn.i = &fi + // An extension can be registered for any type, regardless of the Kind + // (e.g. type BitSet int64, type MyStruct { / * unexported fields * / }, type X []int, etc. + // + // We can't check if it's an extension byte here first, because the user may have + // registered a pointer or non-pointer type, meaning we may have to recurse first + // before matching a mapped type, even though the extension byte is already detected. + // + // NOTE: if decoding into a nil interface{}, we return a non-nil + // value except even if the container registers a length of 0. + if rtid == rawExtTypId { + fn.f = (*decFnInfo).rawExt + } else if d.d.isBuiltinType(rtid) { + fn.f = (*decFnInfo).builtin + } else if xfTag, xfFn := d.h.getDecodeExt(rtid); xfFn != nil { + fi.xfTag, fi.xfFn = xfTag, xfFn + fn.f = (*decFnInfo).ext + } else if supportBinaryMarshal && fi.ti.unm { + fn.f = (*decFnInfo).binaryMarshal + } else { + switch rk := rt.Kind(); rk { + case reflect.String: + fn.f = (*decFnInfo).kString + case reflect.Bool: + fn.f = (*decFnInfo).kBool + case reflect.Int: + fn.f = (*decFnInfo).kInt + case reflect.Int64: + fn.f = (*decFnInfo).kInt64 + case reflect.Int32: + fn.f = (*decFnInfo).kInt32 + case reflect.Int8: + fn.f = (*decFnInfo).kInt8 + case reflect.Int16: + fn.f = (*decFnInfo).kInt16 + case reflect.Float32: + fn.f = (*decFnInfo).kFloat32 + case reflect.Float64: + fn.f = (*decFnInfo).kFloat64 + case reflect.Uint8: + fn.f = (*decFnInfo).kUint8 + case reflect.Uint64: + fn.f = (*decFnInfo).kUint64 + case reflect.Uint: + fn.f = (*decFnInfo).kUint + case reflect.Uint32: + fn.f = (*decFnInfo).kUint32 + case reflect.Uint16: + fn.f = (*decFnInfo).kUint16 + // case reflect.Ptr: + // fn.f = (*decFnInfo).kPtr + case reflect.Interface: + fn.f = (*decFnInfo).kInterface + case reflect.Struct: + fn.f = (*decFnInfo).kStruct + case reflect.Slice: + fn.f = (*decFnInfo).kSlice + case reflect.Array: + fi.array = true + fn.f = (*decFnInfo).kArray + case reflect.Map: + fn.f = (*decFnInfo).kMap + default: + fn.f = (*decFnInfo).kErr + } + } + if useMapForCodecCache { + if d.f == nil { + d.f = make(map[uintptr]decFn, 16) + } + d.f[rtid] = fn + } else { + d.s = append(d.s, fn) + d.x = append(d.x, rtid) + } + } + + fn.f(fn.i, rv) + + return +} + +func (d *Decoder) chkPtrValue(rv reflect.Value) { + // We can only decode into a non-nil pointer + if rv.Kind() == reflect.Ptr && !rv.IsNil() { + return + } + if !rv.IsValid() { + decErr("Cannot decode into a zero (ie invalid) reflect.Value") + } + if !rv.CanInterface() { + decErr("Cannot decode into a value without an interface: %v", rv) + } + rvi := rv.Interface() + decErr("Cannot decode into non-pointer or nil pointer. Got: %v, %T, %v", + rv.Kind(), rvi, rvi) +} + +func (d *Decoder) decEmbeddedField(rv reflect.Value, index []int) { + // d.decodeValue(rv.FieldByIndex(index)) + // nil pointers may be here; so reproduce FieldByIndex logic + enhancements + for _, j := range index { + if rv.Kind() == reflect.Ptr { + if rv.IsNil() { + rv.Set(reflect.New(rv.Type().Elem())) + } + // If a pointer, it must be a pointer to struct (based on typeInfo contract) + rv = rv.Elem() + } + rv = rv.Field(j) + } + d.decodeValue(rv) +} + +// -------------------------------------------------- + +// short circuit functions for common maps and slices + +func (d *Decoder) decSliceIntf(v *[]interface{}, currEncodedType valueType, doNotReset bool) { + _, containerLenS := decContLens(d.d, currEncodedType) + s := *v + if s == nil { + s = make([]interface{}, containerLenS, containerLenS) + } else if containerLenS > cap(s) { + if doNotReset { + decErr(msgDecCannotExpandArr, cap(s), containerLenS) + } + s = make([]interface{}, containerLenS, containerLenS) + copy(s, *v) + } else if containerLenS > len(s) { + s = s[:containerLenS] + } + for j := 0; j < containerLenS; j++ { + d.decode(&s[j]) + } + *v = s +} + +func (d *Decoder) decSliceInt64(v *[]int64, currEncodedType valueType, doNotReset bool) { + _, containerLenS := decContLens(d.d, currEncodedType) + s := *v + if s == nil { + s = make([]int64, containerLenS, containerLenS) + } else if containerLenS > cap(s) { + if doNotReset { + decErr(msgDecCannotExpandArr, cap(s), containerLenS) + } + s = make([]int64, containerLenS, containerLenS) + copy(s, *v) + } else if containerLenS > len(s) { + s = s[:containerLenS] + } + for j := 0; j < containerLenS; j++ { + // d.decode(&s[j]) + d.d.initReadNext() + s[j] = d.d.decodeInt(intBitsize) + } + *v = s +} + +func (d *Decoder) decSliceUint64(v *[]uint64, currEncodedType valueType, doNotReset bool) { + _, containerLenS := decContLens(d.d, currEncodedType) + s := *v + if s == nil { + s = make([]uint64, containerLenS, containerLenS) + } else if containerLenS > cap(s) { + if doNotReset { + decErr(msgDecCannotExpandArr, cap(s), containerLenS) + } + s = make([]uint64, containerLenS, containerLenS) + copy(s, *v) + } else if containerLenS > len(s) { + s = s[:containerLenS] + } + for j := 0; j < containerLenS; j++ { + // d.decode(&s[j]) + d.d.initReadNext() + s[j] = d.d.decodeUint(intBitsize) + } + *v = s +} + +func (d *Decoder) decSliceStr(v *[]string, currEncodedType valueType, doNotReset bool) { + _, containerLenS := decContLens(d.d, currEncodedType) + s := *v + if s == nil { + s = make([]string, containerLenS, containerLenS) + } else if containerLenS > cap(s) { + if doNotReset { + decErr(msgDecCannotExpandArr, cap(s), containerLenS) + } + s = make([]string, containerLenS, containerLenS) + copy(s, *v) + } else if containerLenS > len(s) { + s = s[:containerLenS] + } + for j := 0; j < containerLenS; j++ { + // d.decode(&s[j]) + d.d.initReadNext() + s[j] = d.d.decodeString() + } + *v = s +} + +func (d *Decoder) decMapIntfIntf(v *map[interface{}]interface{}) { + containerLen := d.d.readMapLen() + m := *v + if m == nil { + m = make(map[interface{}]interface{}, containerLen) + *v = m + } + for j := 0; j < containerLen; j++ { + var mk interface{} + d.decode(&mk) + // special case if a byte array. + if bv, bok := mk.([]byte); bok { + mk = string(bv) + } + mv := m[mk] + d.decode(&mv) + m[mk] = mv + } +} + +func (d *Decoder) decMapInt64Intf(v *map[int64]interface{}) { + containerLen := d.d.readMapLen() + m := *v + if m == nil { + m = make(map[int64]interface{}, containerLen) + *v = m + } + for j := 0; j < containerLen; j++ { + d.d.initReadNext() + mk := d.d.decodeInt(intBitsize) + mv := m[mk] + d.decode(&mv) + m[mk] = mv + } +} + +func (d *Decoder) decMapUint64Intf(v *map[uint64]interface{}) { + containerLen := d.d.readMapLen() + m := *v + if m == nil { + m = make(map[uint64]interface{}, containerLen) + *v = m + } + for j := 0; j < containerLen; j++ { + d.d.initReadNext() + mk := d.d.decodeUint(intBitsize) + mv := m[mk] + d.decode(&mv) + m[mk] = mv + } +} + +func (d *Decoder) decMapStrIntf(v *map[string]interface{}) { + containerLen := d.d.readMapLen() + m := *v + if m == nil { + m = make(map[string]interface{}, containerLen) + *v = m + } + for j := 0; j < containerLen; j++ { + d.d.initReadNext() + mk := d.d.decodeString() + mv := m[mk] + d.decode(&mv) + m[mk] = mv + } +} + +// ---------------------------------------- + +func decContLens(dd decDriver, currEncodedType valueType) (containerLen, containerLenS int) { + if currEncodedType == valueTypeInvalid { + currEncodedType = dd.currentEncodedType() + } + switch currEncodedType { + case valueTypeArray: + containerLen = dd.readArrayLen() + containerLenS = containerLen + case valueTypeMap: + containerLen = dd.readMapLen() + containerLenS = containerLen * 2 + default: + decErr("Only encoded map or array can be decoded into a slice. (valueType: %0x)", + currEncodedType) + } + return +} + +func decErr(format string, params ...interface{}) { + doPanic(msgTagDec, format, params...) +} diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/encode.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/encode.go new file mode 100644 index 0000000000..4914be0c74 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/encode.go @@ -0,0 +1,1001 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +import ( + "io" + "reflect" +) + +const ( + // Some tagging information for error messages. + msgTagEnc = "codec.encoder" + defEncByteBufSize = 1 << 6 // 4:16, 6:64, 8:256, 10:1024 + // maxTimeSecs32 = math.MaxInt32 / 60 / 24 / 366 +) + +// AsSymbolFlag defines what should be encoded as symbols. +type AsSymbolFlag uint8 + +const ( + // AsSymbolDefault is default. + // Currently, this means only encode struct field names as symbols. + // The default is subject to change. + AsSymbolDefault AsSymbolFlag = iota + + // AsSymbolAll means encode anything which could be a symbol as a symbol. + AsSymbolAll = 0xfe + + // AsSymbolNone means do not encode anything as a symbol. + AsSymbolNone = 1 << iota + + // AsSymbolMapStringKeys means encode keys in map[string]XXX as symbols. + AsSymbolMapStringKeysFlag + + // AsSymbolStructFieldName means encode struct field names as symbols. + AsSymbolStructFieldNameFlag +) + +// encWriter abstracting writing to a byte array or to an io.Writer. +type encWriter interface { + writeUint16(uint16) + writeUint32(uint32) + writeUint64(uint64) + writeb([]byte) + writestr(string) + writen1(byte) + writen2(byte, byte) + atEndOfEncode() +} + +// encDriver abstracts the actual codec (binc vs msgpack, etc) +type encDriver interface { + isBuiltinType(rt uintptr) bool + encodeBuiltin(rt uintptr, v interface{}) + encodeNil() + encodeInt(i int64) + encodeUint(i uint64) + encodeBool(b bool) + encodeFloat32(f float32) + encodeFloat64(f float64) + encodeExtPreamble(xtag byte, length int) + encodeArrayPreamble(length int) + encodeMapPreamble(length int) + encodeString(c charEncoding, v string) + encodeSymbol(v string) + encodeStringBytes(c charEncoding, v []byte) + //TODO + //encBignum(f *big.Int) + //encStringRunes(c charEncoding, v []rune) +} + +type ioEncWriterWriter interface { + WriteByte(c byte) error + WriteString(s string) (n int, err error) + Write(p []byte) (n int, err error) +} + +type ioEncStringWriter interface { + WriteString(s string) (n int, err error) +} + +type EncodeOptions struct { + // Encode a struct as an array, and not as a map. + StructToArray bool + + // AsSymbols defines what should be encoded as symbols. + // + // Encoding as symbols can reduce the encoded size significantly. + // + // However, during decoding, each string to be encoded as a symbol must + // be checked to see if it has been seen before. Consequently, encoding time + // will increase if using symbols, because string comparisons has a clear cost. + // + // Sample values: + // AsSymbolNone + // AsSymbolAll + // AsSymbolMapStringKeys + // AsSymbolMapStringKeysFlag | AsSymbolStructFieldNameFlag + AsSymbols AsSymbolFlag +} + +// --------------------------------------------- + +type simpleIoEncWriterWriter struct { + w io.Writer + bw io.ByteWriter + sw ioEncStringWriter +} + +func (o *simpleIoEncWriterWriter) WriteByte(c byte) (err error) { + if o.bw != nil { + return o.bw.WriteByte(c) + } + _, err = o.w.Write([]byte{c}) + return +} + +func (o *simpleIoEncWriterWriter) WriteString(s string) (n int, err error) { + if o.sw != nil { + return o.sw.WriteString(s) + } + return o.w.Write([]byte(s)) +} + +func (o *simpleIoEncWriterWriter) Write(p []byte) (n int, err error) { + return o.w.Write(p) +} + +// ---------------------------------------- + +// ioEncWriter implements encWriter and can write to an io.Writer implementation +type ioEncWriter struct { + w ioEncWriterWriter + x [8]byte // temp byte array re-used internally for efficiency +} + +func (z *ioEncWriter) writeUint16(v uint16) { + bigen.PutUint16(z.x[:2], v) + z.writeb(z.x[:2]) +} + +func (z *ioEncWriter) writeUint32(v uint32) { + bigen.PutUint32(z.x[:4], v) + z.writeb(z.x[:4]) +} + +func (z *ioEncWriter) writeUint64(v uint64) { + bigen.PutUint64(z.x[:8], v) + z.writeb(z.x[:8]) +} + +func (z *ioEncWriter) writeb(bs []byte) { + if len(bs) == 0 { + return + } + n, err := z.w.Write(bs) + if err != nil { + panic(err) + } + if n != len(bs) { + encErr("write: Incorrect num bytes written. Expecting: %v, Wrote: %v", len(bs), n) + } +} + +func (z *ioEncWriter) writestr(s string) { + n, err := z.w.WriteString(s) + if err != nil { + panic(err) + } + if n != len(s) { + encErr("write: Incorrect num bytes written. Expecting: %v, Wrote: %v", len(s), n) + } +} + +func (z *ioEncWriter) writen1(b byte) { + if err := z.w.WriteByte(b); err != nil { + panic(err) + } +} + +func (z *ioEncWriter) writen2(b1 byte, b2 byte) { + z.writen1(b1) + z.writen1(b2) +} + +func (z *ioEncWriter) atEndOfEncode() {} + +// ---------------------------------------- + +// bytesEncWriter implements encWriter and can write to an byte slice. +// It is used by Marshal function. +type bytesEncWriter struct { + b []byte + c int // cursor + out *[]byte // write out on atEndOfEncode +} + +func (z *bytesEncWriter) writeUint16(v uint16) { + c := z.grow(2) + z.b[c] = byte(v >> 8) + z.b[c+1] = byte(v) +} + +func (z *bytesEncWriter) writeUint32(v uint32) { + c := z.grow(4) + z.b[c] = byte(v >> 24) + z.b[c+1] = byte(v >> 16) + z.b[c+2] = byte(v >> 8) + z.b[c+3] = byte(v) +} + +func (z *bytesEncWriter) writeUint64(v uint64) { + c := z.grow(8) + z.b[c] = byte(v >> 56) + z.b[c+1] = byte(v >> 48) + z.b[c+2] = byte(v >> 40) + z.b[c+3] = byte(v >> 32) + z.b[c+4] = byte(v >> 24) + z.b[c+5] = byte(v >> 16) + z.b[c+6] = byte(v >> 8) + z.b[c+7] = byte(v) +} + +func (z *bytesEncWriter) writeb(s []byte) { + if len(s) == 0 { + return + } + c := z.grow(len(s)) + copy(z.b[c:], s) +} + +func (z *bytesEncWriter) writestr(s string) { + c := z.grow(len(s)) + copy(z.b[c:], s) +} + +func (z *bytesEncWriter) writen1(b1 byte) { + c := z.grow(1) + z.b[c] = b1 +} + +func (z *bytesEncWriter) writen2(b1 byte, b2 byte) { + c := z.grow(2) + z.b[c] = b1 + z.b[c+1] = b2 +} + +func (z *bytesEncWriter) atEndOfEncode() { + *(z.out) = z.b[:z.c] +} + +func (z *bytesEncWriter) grow(n int) (oldcursor int) { + oldcursor = z.c + z.c = oldcursor + n + if z.c > cap(z.b) { + // Tried using appendslice logic: (if cap < 1024, *2, else *1.25). + // However, it was too expensive, causing too many iterations of copy. + // Using bytes.Buffer model was much better (2*cap + n) + bs := make([]byte, 2*cap(z.b)+n) + copy(bs, z.b[:oldcursor]) + z.b = bs + } else if z.c > len(z.b) { + z.b = z.b[:cap(z.b)] + } + return +} + +// --------------------------------------------- + +type encFnInfo struct { + ti *typeInfo + e *Encoder + ee encDriver + xfFn func(reflect.Value) ([]byte, error) + xfTag byte +} + +func (f *encFnInfo) builtin(rv reflect.Value) { + f.ee.encodeBuiltin(f.ti.rtid, rv.Interface()) +} + +func (f *encFnInfo) rawExt(rv reflect.Value) { + f.e.encRawExt(rv.Interface().(RawExt)) +} + +func (f *encFnInfo) ext(rv reflect.Value) { + bs, fnerr := f.xfFn(rv) + if fnerr != nil { + panic(fnerr) + } + if bs == nil { + f.ee.encodeNil() + return + } + if f.e.hh.writeExt() { + f.ee.encodeExtPreamble(f.xfTag, len(bs)) + f.e.w.writeb(bs) + } else { + f.ee.encodeStringBytes(c_RAW, bs) + } + +} + +func (f *encFnInfo) binaryMarshal(rv reflect.Value) { + var bm binaryMarshaler + if f.ti.mIndir == 0 { + bm = rv.Interface().(binaryMarshaler) + } else if f.ti.mIndir == -1 { + bm = rv.Addr().Interface().(binaryMarshaler) + } else { + for j, k := int8(0), f.ti.mIndir; j < k; j++ { + if rv.IsNil() { + f.ee.encodeNil() + return + } + rv = rv.Elem() + } + bm = rv.Interface().(binaryMarshaler) + } + // debugf(">>>> binaryMarshaler: %T", rv.Interface()) + bs, fnerr := bm.MarshalBinary() + if fnerr != nil { + panic(fnerr) + } + if bs == nil { + f.ee.encodeNil() + } else { + f.ee.encodeStringBytes(c_RAW, bs) + } +} + +func (f *encFnInfo) kBool(rv reflect.Value) { + f.ee.encodeBool(rv.Bool()) +} + +func (f *encFnInfo) kString(rv reflect.Value) { + f.ee.encodeString(c_UTF8, rv.String()) +} + +func (f *encFnInfo) kFloat64(rv reflect.Value) { + f.ee.encodeFloat64(rv.Float()) +} + +func (f *encFnInfo) kFloat32(rv reflect.Value) { + f.ee.encodeFloat32(float32(rv.Float())) +} + +func (f *encFnInfo) kInt(rv reflect.Value) { + f.ee.encodeInt(rv.Int()) +} + +func (f *encFnInfo) kUint(rv reflect.Value) { + f.ee.encodeUint(rv.Uint()) +} + +func (f *encFnInfo) kInvalid(rv reflect.Value) { + f.ee.encodeNil() +} + +func (f *encFnInfo) kErr(rv reflect.Value) { + encErr("Unsupported kind: %s, for: %#v", rv.Kind(), rv) +} + +func (f *encFnInfo) kSlice(rv reflect.Value) { + if rv.IsNil() { + f.ee.encodeNil() + return + } + + if shortCircuitReflectToFastPath { + switch f.ti.rtid { + case intfSliceTypId: + f.e.encSliceIntf(rv.Interface().([]interface{})) + return + case strSliceTypId: + f.e.encSliceStr(rv.Interface().([]string)) + return + case uint64SliceTypId: + f.e.encSliceUint64(rv.Interface().([]uint64)) + return + case int64SliceTypId: + f.e.encSliceInt64(rv.Interface().([]int64)) + return + } + } + + // If in this method, then there was no extension function defined. + // So it's okay to treat as []byte. + if f.ti.rtid == uint8SliceTypId || f.ti.rt.Elem().Kind() == reflect.Uint8 { + f.ee.encodeStringBytes(c_RAW, rv.Bytes()) + return + } + + l := rv.Len() + if f.ti.mbs { + if l%2 == 1 { + encErr("mapBySlice: invalid length (must be divisible by 2): %v", l) + } + f.ee.encodeMapPreamble(l / 2) + } else { + f.ee.encodeArrayPreamble(l) + } + if l == 0 { + return + } + for j := 0; j < l; j++ { + // TODO: Consider perf implication of encoding odd index values as symbols if type is string + f.e.encodeValue(rv.Index(j)) + } +} + +func (f *encFnInfo) kArray(rv reflect.Value) { + // We cannot share kSlice method, because the array may be non-addressable. + // E.g. type struct S{B [2]byte}; Encode(S{}) will bomb on "panic: slice of unaddressable array". + // So we have to duplicate the functionality here. + // f.e.encodeValue(rv.Slice(0, rv.Len())) + // f.kSlice(rv.Slice(0, rv.Len())) + + l := rv.Len() + // Handle an array of bytes specially (in line with what is done for slices) + if f.ti.rt.Elem().Kind() == reflect.Uint8 { + if l == 0 { + f.ee.encodeStringBytes(c_RAW, nil) + return + } + var bs []byte + if rv.CanAddr() { + bs = rv.Slice(0, l).Bytes() + } else { + bs = make([]byte, l) + for i := 0; i < l; i++ { + bs[i] = byte(rv.Index(i).Uint()) + } + } + f.ee.encodeStringBytes(c_RAW, bs) + return + } + + if f.ti.mbs { + if l%2 == 1 { + encErr("mapBySlice: invalid length (must be divisible by 2): %v", l) + } + f.ee.encodeMapPreamble(l / 2) + } else { + f.ee.encodeArrayPreamble(l) + } + if l == 0 { + return + } + for j := 0; j < l; j++ { + // TODO: Consider perf implication of encoding odd index values as symbols if type is string + f.e.encodeValue(rv.Index(j)) + } +} + +func (f *encFnInfo) kStruct(rv reflect.Value) { + fti := f.ti + newlen := len(fti.sfi) + rvals := make([]reflect.Value, newlen) + var encnames []string + e := f.e + tisfi := fti.sfip + toMap := !(fti.toArray || e.h.StructToArray) + // if toMap, use the sorted array. If toArray, use unsorted array (to match sequence in struct) + if toMap { + tisfi = fti.sfi + encnames = make([]string, newlen) + } + newlen = 0 + for _, si := range tisfi { + if si.i != -1 { + rvals[newlen] = rv.Field(int(si.i)) + } else { + rvals[newlen] = rv.FieldByIndex(si.is) + } + if toMap { + if si.omitEmpty && isEmptyValue(rvals[newlen]) { + continue + } + encnames[newlen] = si.encName + } else { + if si.omitEmpty && isEmptyValue(rvals[newlen]) { + rvals[newlen] = reflect.Value{} //encode as nil + } + } + newlen++ + } + + // debugf(">>>> kStruct: newlen: %v", newlen) + if toMap { + ee := f.ee //don't dereference everytime + ee.encodeMapPreamble(newlen) + // asSymbols := e.h.AsSymbols&AsSymbolStructFieldNameFlag != 0 + asSymbols := e.h.AsSymbols == AsSymbolDefault || e.h.AsSymbols&AsSymbolStructFieldNameFlag != 0 + for j := 0; j < newlen; j++ { + if asSymbols { + ee.encodeSymbol(encnames[j]) + } else { + ee.encodeString(c_UTF8, encnames[j]) + } + e.encodeValue(rvals[j]) + } + } else { + f.ee.encodeArrayPreamble(newlen) + for j := 0; j < newlen; j++ { + e.encodeValue(rvals[j]) + } + } +} + +// func (f *encFnInfo) kPtr(rv reflect.Value) { +// debugf(">>>>>>> ??? encode kPtr called - shouldn't get called") +// if rv.IsNil() { +// f.ee.encodeNil() +// return +// } +// f.e.encodeValue(rv.Elem()) +// } + +func (f *encFnInfo) kInterface(rv reflect.Value) { + if rv.IsNil() { + f.ee.encodeNil() + return + } + f.e.encodeValue(rv.Elem()) +} + +func (f *encFnInfo) kMap(rv reflect.Value) { + if rv.IsNil() { + f.ee.encodeNil() + return + } + + if shortCircuitReflectToFastPath { + switch f.ti.rtid { + case mapIntfIntfTypId: + f.e.encMapIntfIntf(rv.Interface().(map[interface{}]interface{})) + return + case mapStrIntfTypId: + f.e.encMapStrIntf(rv.Interface().(map[string]interface{})) + return + case mapStrStrTypId: + f.e.encMapStrStr(rv.Interface().(map[string]string)) + return + case mapInt64IntfTypId: + f.e.encMapInt64Intf(rv.Interface().(map[int64]interface{})) + return + case mapUint64IntfTypId: + f.e.encMapUint64Intf(rv.Interface().(map[uint64]interface{})) + return + } + } + + l := rv.Len() + f.ee.encodeMapPreamble(l) + if l == 0 { + return + } + // keyTypeIsString := f.ti.rt.Key().Kind() == reflect.String + keyTypeIsString := f.ti.rt.Key() == stringTyp + var asSymbols bool + if keyTypeIsString { + asSymbols = f.e.h.AsSymbols&AsSymbolMapStringKeysFlag != 0 + } + mks := rv.MapKeys() + // for j, lmks := 0, len(mks); j < lmks; j++ { + for j := range mks { + if keyTypeIsString { + if asSymbols { + f.ee.encodeSymbol(mks[j].String()) + } else { + f.ee.encodeString(c_UTF8, mks[j].String()) + } + } else { + f.e.encodeValue(mks[j]) + } + f.e.encodeValue(rv.MapIndex(mks[j])) + } + +} + +// -------------------------------------------------- + +// encFn encapsulates the captured variables and the encode function. +// This way, we only do some calculations one times, and pass to the +// code block that should be called (encapsulated in a function) +// instead of executing the checks every time. +type encFn struct { + i *encFnInfo + f func(*encFnInfo, reflect.Value) +} + +// -------------------------------------------------- + +// An Encoder writes an object to an output stream in the codec format. +type Encoder struct { + w encWriter + e encDriver + h *BasicHandle + hh Handle + f map[uintptr]encFn + x []uintptr + s []encFn +} + +// NewEncoder returns an Encoder for encoding into an io.Writer. +// +// For efficiency, Users are encouraged to pass in a memory buffered writer +// (eg bufio.Writer, bytes.Buffer). +func NewEncoder(w io.Writer, h Handle) *Encoder { + ww, ok := w.(ioEncWriterWriter) + if !ok { + sww := simpleIoEncWriterWriter{w: w} + sww.bw, _ = w.(io.ByteWriter) + sww.sw, _ = w.(ioEncStringWriter) + ww = &sww + //ww = bufio.NewWriterSize(w, defEncByteBufSize) + } + z := ioEncWriter{ + w: ww, + } + return &Encoder{w: &z, hh: h, h: h.getBasicHandle(), e: h.newEncDriver(&z)} +} + +// NewEncoderBytes returns an encoder for encoding directly and efficiently +// into a byte slice, using zero-copying to temporary slices. +// +// It will potentially replace the output byte slice pointed to. +// After encoding, the out parameter contains the encoded contents. +func NewEncoderBytes(out *[]byte, h Handle) *Encoder { + in := *out + if in == nil { + in = make([]byte, defEncByteBufSize) + } + z := bytesEncWriter{ + b: in, + out: out, + } + return &Encoder{w: &z, hh: h, h: h.getBasicHandle(), e: h.newEncDriver(&z)} +} + +// Encode writes an object into a stream in the codec format. +// +// Encoding can be configured via the "codec" struct tag for the fields. +// +// The "codec" key in struct field's tag value is the key name, +// followed by an optional comma and options. +// +// To set an option on all fields (e.g. omitempty on all fields), you +// can create a field called _struct, and set flags on it. +// +// Struct values "usually" encode as maps. Each exported struct field is encoded unless: +// - the field's codec tag is "-", OR +// - the field is empty and its codec tag specifies the "omitempty" option. +// +// When encoding as a map, the first string in the tag (before the comma) +// is the map key string to use when encoding. +// +// However, struct values may encode as arrays. This happens when: +// - StructToArray Encode option is set, OR +// - the codec tag on the _struct field sets the "toarray" option +// +// Values with types that implement MapBySlice are encoded as stream maps. +// +// The empty values (for omitempty option) are false, 0, any nil pointer +// or interface value, and any array, slice, map, or string of length zero. +// +// Anonymous fields are encoded inline if no struct tag is present. +// Else they are encoded as regular fields. +// +// Examples: +// +// type MyStruct struct { +// _struct bool `codec:",omitempty"` //set omitempty for every field +// Field1 string `codec:"-"` //skip this field +// Field2 int `codec:"myName"` //Use key "myName" in encode stream +// Field3 int32 `codec:",omitempty"` //use key "Field3". Omit if empty. +// Field4 bool `codec:"f4,omitempty"` //use key "f4". Omit if empty. +// ... +// } +// +// type MyStruct struct { +// _struct bool `codec:",omitempty,toarray"` //set omitempty for every field +// //and encode struct as an array +// } +// +// The mode of encoding is based on the type of the value. When a value is seen: +// - If an extension is registered for it, call that extension function +// - If it implements BinaryMarshaler, call its MarshalBinary() (data []byte, err error) +// - Else encode it based on its reflect.Kind +// +// Note that struct field names and keys in map[string]XXX will be treated as symbols. +// Some formats support symbols (e.g. binc) and will properly encode the string +// only once in the stream, and use a tag to refer to it thereafter. +func (e *Encoder) Encode(v interface{}) (err error) { + defer panicToErr(&err) + e.encode(v) + e.w.atEndOfEncode() + return +} + +func (e *Encoder) encode(iv interface{}) { + switch v := iv.(type) { + case nil: + e.e.encodeNil() + + case reflect.Value: + e.encodeValue(v) + + case string: + e.e.encodeString(c_UTF8, v) + case bool: + e.e.encodeBool(v) + case int: + e.e.encodeInt(int64(v)) + case int8: + e.e.encodeInt(int64(v)) + case int16: + e.e.encodeInt(int64(v)) + case int32: + e.e.encodeInt(int64(v)) + case int64: + e.e.encodeInt(v) + case uint: + e.e.encodeUint(uint64(v)) + case uint8: + e.e.encodeUint(uint64(v)) + case uint16: + e.e.encodeUint(uint64(v)) + case uint32: + e.e.encodeUint(uint64(v)) + case uint64: + e.e.encodeUint(v) + case float32: + e.e.encodeFloat32(v) + case float64: + e.e.encodeFloat64(v) + + case []interface{}: + e.encSliceIntf(v) + case []string: + e.encSliceStr(v) + case []int64: + e.encSliceInt64(v) + case []uint64: + e.encSliceUint64(v) + case []uint8: + e.e.encodeStringBytes(c_RAW, v) + + case map[interface{}]interface{}: + e.encMapIntfIntf(v) + case map[string]interface{}: + e.encMapStrIntf(v) + case map[string]string: + e.encMapStrStr(v) + case map[int64]interface{}: + e.encMapInt64Intf(v) + case map[uint64]interface{}: + e.encMapUint64Intf(v) + + case *string: + e.e.encodeString(c_UTF8, *v) + case *bool: + e.e.encodeBool(*v) + case *int: + e.e.encodeInt(int64(*v)) + case *int8: + e.e.encodeInt(int64(*v)) + case *int16: + e.e.encodeInt(int64(*v)) + case *int32: + e.e.encodeInt(int64(*v)) + case *int64: + e.e.encodeInt(*v) + case *uint: + e.e.encodeUint(uint64(*v)) + case *uint8: + e.e.encodeUint(uint64(*v)) + case *uint16: + e.e.encodeUint(uint64(*v)) + case *uint32: + e.e.encodeUint(uint64(*v)) + case *uint64: + e.e.encodeUint(*v) + case *float32: + e.e.encodeFloat32(*v) + case *float64: + e.e.encodeFloat64(*v) + + case *[]interface{}: + e.encSliceIntf(*v) + case *[]string: + e.encSliceStr(*v) + case *[]int64: + e.encSliceInt64(*v) + case *[]uint64: + e.encSliceUint64(*v) + case *[]uint8: + e.e.encodeStringBytes(c_RAW, *v) + + case *map[interface{}]interface{}: + e.encMapIntfIntf(*v) + case *map[string]interface{}: + e.encMapStrIntf(*v) + case *map[string]string: + e.encMapStrStr(*v) + case *map[int64]interface{}: + e.encMapInt64Intf(*v) + case *map[uint64]interface{}: + e.encMapUint64Intf(*v) + + default: + e.encodeValue(reflect.ValueOf(iv)) + } +} + +func (e *Encoder) encodeValue(rv reflect.Value) { + for rv.Kind() == reflect.Ptr { + if rv.IsNil() { + e.e.encodeNil() + return + } + rv = rv.Elem() + } + + rt := rv.Type() + rtid := reflect.ValueOf(rt).Pointer() + + // if e.f == nil && e.s == nil { debugf("---->Creating new enc f map for type: %v\n", rt) } + var fn encFn + var ok bool + if useMapForCodecCache { + fn, ok = e.f[rtid] + } else { + for i, v := range e.x { + if v == rtid { + fn, ok = e.s[i], true + break + } + } + } + if !ok { + // debugf("\tCreating new enc fn for type: %v\n", rt) + fi := encFnInfo{ti: getTypeInfo(rtid, rt), e: e, ee: e.e} + fn.i = &fi + if rtid == rawExtTypId { + fn.f = (*encFnInfo).rawExt + } else if e.e.isBuiltinType(rtid) { + fn.f = (*encFnInfo).builtin + } else if xfTag, xfFn := e.h.getEncodeExt(rtid); xfFn != nil { + fi.xfTag, fi.xfFn = xfTag, xfFn + fn.f = (*encFnInfo).ext + } else if supportBinaryMarshal && fi.ti.m { + fn.f = (*encFnInfo).binaryMarshal + } else { + switch rk := rt.Kind(); rk { + case reflect.Bool: + fn.f = (*encFnInfo).kBool + case reflect.String: + fn.f = (*encFnInfo).kString + case reflect.Float64: + fn.f = (*encFnInfo).kFloat64 + case reflect.Float32: + fn.f = (*encFnInfo).kFloat32 + case reflect.Int, reflect.Int8, reflect.Int64, reflect.Int32, reflect.Int16: + fn.f = (*encFnInfo).kInt + case reflect.Uint8, reflect.Uint64, reflect.Uint, reflect.Uint32, reflect.Uint16: + fn.f = (*encFnInfo).kUint + case reflect.Invalid: + fn.f = (*encFnInfo).kInvalid + case reflect.Slice: + fn.f = (*encFnInfo).kSlice + case reflect.Array: + fn.f = (*encFnInfo).kArray + case reflect.Struct: + fn.f = (*encFnInfo).kStruct + // case reflect.Ptr: + // fn.f = (*encFnInfo).kPtr + case reflect.Interface: + fn.f = (*encFnInfo).kInterface + case reflect.Map: + fn.f = (*encFnInfo).kMap + default: + fn.f = (*encFnInfo).kErr + } + } + if useMapForCodecCache { + if e.f == nil { + e.f = make(map[uintptr]encFn, 16) + } + e.f[rtid] = fn + } else { + e.s = append(e.s, fn) + e.x = append(e.x, rtid) + } + } + + fn.f(fn.i, rv) + +} + +func (e *Encoder) encRawExt(re RawExt) { + if re.Data == nil { + e.e.encodeNil() + return + } + if e.hh.writeExt() { + e.e.encodeExtPreamble(re.Tag, len(re.Data)) + e.w.writeb(re.Data) + } else { + e.e.encodeStringBytes(c_RAW, re.Data) + } +} + +// --------------------------------------------- +// short circuit functions for common maps and slices + +func (e *Encoder) encSliceIntf(v []interface{}) { + e.e.encodeArrayPreamble(len(v)) + for _, v2 := range v { + e.encode(v2) + } +} + +func (e *Encoder) encSliceStr(v []string) { + e.e.encodeArrayPreamble(len(v)) + for _, v2 := range v { + e.e.encodeString(c_UTF8, v2) + } +} + +func (e *Encoder) encSliceInt64(v []int64) { + e.e.encodeArrayPreamble(len(v)) + for _, v2 := range v { + e.e.encodeInt(v2) + } +} + +func (e *Encoder) encSliceUint64(v []uint64) { + e.e.encodeArrayPreamble(len(v)) + for _, v2 := range v { + e.e.encodeUint(v2) + } +} + +func (e *Encoder) encMapStrStr(v map[string]string) { + e.e.encodeMapPreamble(len(v)) + asSymbols := e.h.AsSymbols&AsSymbolMapStringKeysFlag != 0 + for k2, v2 := range v { + if asSymbols { + e.e.encodeSymbol(k2) + } else { + e.e.encodeString(c_UTF8, k2) + } + e.e.encodeString(c_UTF8, v2) + } +} + +func (e *Encoder) encMapStrIntf(v map[string]interface{}) { + e.e.encodeMapPreamble(len(v)) + asSymbols := e.h.AsSymbols&AsSymbolMapStringKeysFlag != 0 + for k2, v2 := range v { + if asSymbols { + e.e.encodeSymbol(k2) + } else { + e.e.encodeString(c_UTF8, k2) + } + e.encode(v2) + } +} + +func (e *Encoder) encMapInt64Intf(v map[int64]interface{}) { + e.e.encodeMapPreamble(len(v)) + for k2, v2 := range v { + e.e.encodeInt(k2) + e.encode(v2) + } +} + +func (e *Encoder) encMapUint64Intf(v map[uint64]interface{}) { + e.e.encodeMapPreamble(len(v)) + for k2, v2 := range v { + e.e.encodeUint(uint64(k2)) + e.encode(v2) + } +} + +func (e *Encoder) encMapIntfIntf(v map[interface{}]interface{}) { + e.e.encodeMapPreamble(len(v)) + for k2, v2 := range v { + e.encode(k2) + e.encode(v2) + } +} + +// ---------------------------------------- + +func encErr(format string, params ...interface{}) { + doPanic(msgTagEnc, format, params...) +} diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/helper.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/helper.go new file mode 100644 index 0000000000..e6dc0563f0 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/helper.go @@ -0,0 +1,589 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +// Contains code shared by both encode and decode. + +import ( + "encoding/binary" + "fmt" + "math" + "reflect" + "sort" + "strings" + "sync" + "time" + "unicode" + "unicode/utf8" +) + +const ( + structTagName = "codec" + + // Support + // encoding.BinaryMarshaler: MarshalBinary() (data []byte, err error) + // encoding.BinaryUnmarshaler: UnmarshalBinary(data []byte) error + // This constant flag will enable or disable it. + supportBinaryMarshal = true + + // Each Encoder or Decoder uses a cache of functions based on conditionals, + // so that the conditionals are not run every time. + // + // Either a map or a slice is used to keep track of the functions. + // The map is more natural, but has a higher cost than a slice/array. + // This flag (useMapForCodecCache) controls which is used. + useMapForCodecCache = false + + // For some common container types, we can short-circuit an elaborate + // reflection dance and call encode/decode directly. + // The currently supported types are: + // - slices of strings, or id's (int64,uint64) or interfaces. + // - maps of str->str, str->intf, id(int64,uint64)->intf, intf->intf + shortCircuitReflectToFastPath = true + + // for debugging, set this to false, to catch panic traces. + // Note that this will always cause rpc tests to fail, since they need io.EOF sent via panic. + recoverPanicToErr = true +) + +type charEncoding uint8 + +const ( + c_RAW charEncoding = iota + c_UTF8 + c_UTF16LE + c_UTF16BE + c_UTF32LE + c_UTF32BE +) + +// valueType is the stream type +type valueType uint8 + +const ( + valueTypeUnset valueType = iota + valueTypeNil + valueTypeInt + valueTypeUint + valueTypeFloat + valueTypeBool + valueTypeString + valueTypeSymbol + valueTypeBytes + valueTypeMap + valueTypeArray + valueTypeTimestamp + valueTypeExt + + valueTypeInvalid = 0xff +) + +var ( + bigen = binary.BigEndian + structInfoFieldName = "_struct" + + cachedTypeInfo = make(map[uintptr]*typeInfo, 4) + cachedTypeInfoMutex sync.RWMutex + + intfSliceTyp = reflect.TypeOf([]interface{}(nil)) + intfTyp = intfSliceTyp.Elem() + + strSliceTyp = reflect.TypeOf([]string(nil)) + boolSliceTyp = reflect.TypeOf([]bool(nil)) + uintSliceTyp = reflect.TypeOf([]uint(nil)) + uint8SliceTyp = reflect.TypeOf([]uint8(nil)) + uint16SliceTyp = reflect.TypeOf([]uint16(nil)) + uint32SliceTyp = reflect.TypeOf([]uint32(nil)) + uint64SliceTyp = reflect.TypeOf([]uint64(nil)) + intSliceTyp = reflect.TypeOf([]int(nil)) + int8SliceTyp = reflect.TypeOf([]int8(nil)) + int16SliceTyp = reflect.TypeOf([]int16(nil)) + int32SliceTyp = reflect.TypeOf([]int32(nil)) + int64SliceTyp = reflect.TypeOf([]int64(nil)) + float32SliceTyp = reflect.TypeOf([]float32(nil)) + float64SliceTyp = reflect.TypeOf([]float64(nil)) + + mapIntfIntfTyp = reflect.TypeOf(map[interface{}]interface{}(nil)) + mapStrIntfTyp = reflect.TypeOf(map[string]interface{}(nil)) + mapStrStrTyp = reflect.TypeOf(map[string]string(nil)) + + mapIntIntfTyp = reflect.TypeOf(map[int]interface{}(nil)) + mapInt64IntfTyp = reflect.TypeOf(map[int64]interface{}(nil)) + mapUintIntfTyp = reflect.TypeOf(map[uint]interface{}(nil)) + mapUint64IntfTyp = reflect.TypeOf(map[uint64]interface{}(nil)) + + stringTyp = reflect.TypeOf("") + timeTyp = reflect.TypeOf(time.Time{}) + rawExtTyp = reflect.TypeOf(RawExt{}) + + mapBySliceTyp = reflect.TypeOf((*MapBySlice)(nil)).Elem() + binaryMarshalerTyp = reflect.TypeOf((*binaryMarshaler)(nil)).Elem() + binaryUnmarshalerTyp = reflect.TypeOf((*binaryUnmarshaler)(nil)).Elem() + + rawExtTypId = reflect.ValueOf(rawExtTyp).Pointer() + intfTypId = reflect.ValueOf(intfTyp).Pointer() + timeTypId = reflect.ValueOf(timeTyp).Pointer() + + intfSliceTypId = reflect.ValueOf(intfSliceTyp).Pointer() + strSliceTypId = reflect.ValueOf(strSliceTyp).Pointer() + + boolSliceTypId = reflect.ValueOf(boolSliceTyp).Pointer() + uintSliceTypId = reflect.ValueOf(uintSliceTyp).Pointer() + uint8SliceTypId = reflect.ValueOf(uint8SliceTyp).Pointer() + uint16SliceTypId = reflect.ValueOf(uint16SliceTyp).Pointer() + uint32SliceTypId = reflect.ValueOf(uint32SliceTyp).Pointer() + uint64SliceTypId = reflect.ValueOf(uint64SliceTyp).Pointer() + intSliceTypId = reflect.ValueOf(intSliceTyp).Pointer() + int8SliceTypId = reflect.ValueOf(int8SliceTyp).Pointer() + int16SliceTypId = reflect.ValueOf(int16SliceTyp).Pointer() + int32SliceTypId = reflect.ValueOf(int32SliceTyp).Pointer() + int64SliceTypId = reflect.ValueOf(int64SliceTyp).Pointer() + float32SliceTypId = reflect.ValueOf(float32SliceTyp).Pointer() + float64SliceTypId = reflect.ValueOf(float64SliceTyp).Pointer() + + mapStrStrTypId = reflect.ValueOf(mapStrStrTyp).Pointer() + mapIntfIntfTypId = reflect.ValueOf(mapIntfIntfTyp).Pointer() + mapStrIntfTypId = reflect.ValueOf(mapStrIntfTyp).Pointer() + mapIntIntfTypId = reflect.ValueOf(mapIntIntfTyp).Pointer() + mapInt64IntfTypId = reflect.ValueOf(mapInt64IntfTyp).Pointer() + mapUintIntfTypId = reflect.ValueOf(mapUintIntfTyp).Pointer() + mapUint64IntfTypId = reflect.ValueOf(mapUint64IntfTyp).Pointer() + // Id = reflect.ValueOf().Pointer() + // mapBySliceTypId = reflect.ValueOf(mapBySliceTyp).Pointer() + + binaryMarshalerTypId = reflect.ValueOf(binaryMarshalerTyp).Pointer() + binaryUnmarshalerTypId = reflect.ValueOf(binaryUnmarshalerTyp).Pointer() + + intBitsize uint8 = uint8(reflect.TypeOf(int(0)).Bits()) + uintBitsize uint8 = uint8(reflect.TypeOf(uint(0)).Bits()) + + bsAll0x00 = []byte{0, 0, 0, 0, 0, 0, 0, 0} + bsAll0xff = []byte{0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff} +) + +type binaryUnmarshaler interface { + UnmarshalBinary(data []byte) error +} + +type binaryMarshaler interface { + MarshalBinary() (data []byte, err error) +} + +// MapBySlice represents a slice which should be encoded as a map in the stream. +// The slice contains a sequence of key-value pairs. +type MapBySlice interface { + MapBySlice() +} + +// WARNING: DO NOT USE DIRECTLY. EXPORTED FOR GODOC BENEFIT. WILL BE REMOVED. +// +// BasicHandle encapsulates the common options and extension functions. +type BasicHandle struct { + extHandle + EncodeOptions + DecodeOptions +} + +// Handle is the interface for a specific encoding format. +// +// Typically, a Handle is pre-configured before first time use, +// and not modified while in use. Such a pre-configured Handle +// is safe for concurrent access. +type Handle interface { + writeExt() bool + getBasicHandle() *BasicHandle + newEncDriver(w encWriter) encDriver + newDecDriver(r decReader) decDriver +} + +// RawExt represents raw unprocessed extension data. +type RawExt struct { + Tag byte + Data []byte +} + +type extTypeTagFn struct { + rtid uintptr + rt reflect.Type + tag byte + encFn func(reflect.Value) ([]byte, error) + decFn func(reflect.Value, []byte) error +} + +type extHandle []*extTypeTagFn + +// AddExt registers an encode and decode function for a reflect.Type. +// Note that the type must be a named type, and specifically not +// a pointer or Interface. An error is returned if that is not honored. +// +// To Deregister an ext, call AddExt with 0 tag, nil encfn and nil decfn. +func (o *extHandle) AddExt( + rt reflect.Type, + tag byte, + encfn func(reflect.Value) ([]byte, error), + decfn func(reflect.Value, []byte) error, +) (err error) { + // o is a pointer, because we may need to initialize it + if rt.PkgPath() == "" || rt.Kind() == reflect.Interface { + err = fmt.Errorf("codec.Handle.AddExt: Takes named type, especially not a pointer or interface: %T", + reflect.Zero(rt).Interface()) + return + } + + // o cannot be nil, since it is always embedded in a Handle. + // if nil, let it panic. + // if o == nil { + // err = errors.New("codec.Handle.AddExt: extHandle cannot be a nil pointer.") + // return + // } + + rtid := reflect.ValueOf(rt).Pointer() + for _, v := range *o { + if v.rtid == rtid { + v.tag, v.encFn, v.decFn = tag, encfn, decfn + return + } + } + + *o = append(*o, &extTypeTagFn{rtid, rt, tag, encfn, decfn}) + return +} + +func (o extHandle) getExt(rtid uintptr) *extTypeTagFn { + for _, v := range o { + if v.rtid == rtid { + return v + } + } + return nil +} + +func (o extHandle) getExtForTag(tag byte) *extTypeTagFn { + for _, v := range o { + if v.tag == tag { + return v + } + } + return nil +} + +func (o extHandle) getDecodeExtForTag(tag byte) ( + rv reflect.Value, fn func(reflect.Value, []byte) error) { + if x := o.getExtForTag(tag); x != nil { + // ext is only registered for base + rv = reflect.New(x.rt).Elem() + fn = x.decFn + } + return +} + +func (o extHandle) getDecodeExt(rtid uintptr) (tag byte, fn func(reflect.Value, []byte) error) { + if x := o.getExt(rtid); x != nil { + tag = x.tag + fn = x.decFn + } + return +} + +func (o extHandle) getEncodeExt(rtid uintptr) (tag byte, fn func(reflect.Value) ([]byte, error)) { + if x := o.getExt(rtid); x != nil { + tag = x.tag + fn = x.encFn + } + return +} + +type structFieldInfo struct { + encName string // encode name + + // only one of 'i' or 'is' can be set. If 'i' is -1, then 'is' has been set. + + is []int // (recursive/embedded) field index in struct + i int16 // field index in struct + omitEmpty bool + toArray bool // if field is _struct, is the toArray set? + + // tag string // tag + // name string // field name + // encNameBs []byte // encoded name as byte stream + // ikind int // kind of the field as an int i.e. int(reflect.Kind) +} + +func parseStructFieldInfo(fname string, stag string) *structFieldInfo { + if fname == "" { + panic("parseStructFieldInfo: No Field Name") + } + si := structFieldInfo{ + // name: fname, + encName: fname, + // tag: stag, + } + + if stag != "" { + for i, s := range strings.Split(stag, ",") { + if i == 0 { + if s != "" { + si.encName = s + } + } else { + switch s { + case "omitempty": + si.omitEmpty = true + case "toarray": + si.toArray = true + } + } + } + } + // si.encNameBs = []byte(si.encName) + return &si +} + +type sfiSortedByEncName []*structFieldInfo + +func (p sfiSortedByEncName) Len() int { + return len(p) +} + +func (p sfiSortedByEncName) Less(i, j int) bool { + return p[i].encName < p[j].encName +} + +func (p sfiSortedByEncName) Swap(i, j int) { + p[i], p[j] = p[j], p[i] +} + +// typeInfo keeps information about each type referenced in the encode/decode sequence. +// +// During an encode/decode sequence, we work as below: +// - If base is a built in type, en/decode base value +// - If base is registered as an extension, en/decode base value +// - If type is binary(M/Unm)arshaler, call Binary(M/Unm)arshal method +// - Else decode appropriately based on the reflect.Kind +type typeInfo struct { + sfi []*structFieldInfo // sorted. Used when enc/dec struct to map. + sfip []*structFieldInfo // unsorted. Used when enc/dec struct to array. + + rt reflect.Type + rtid uintptr + + // baseId gives pointer to the base reflect.Type, after deferencing + // the pointers. E.g. base type of ***time.Time is time.Time. + base reflect.Type + baseId uintptr + baseIndir int8 // number of indirections to get to base + + mbs bool // base type (T or *T) is a MapBySlice + + m bool // base type (T or *T) is a binaryMarshaler + unm bool // base type (T or *T) is a binaryUnmarshaler + mIndir int8 // number of indirections to get to binaryMarshaler type + unmIndir int8 // number of indirections to get to binaryUnmarshaler type + toArray bool // whether this (struct) type should be encoded as an array +} + +func (ti *typeInfo) indexForEncName(name string) int { + //tisfi := ti.sfi + const binarySearchThreshold = 16 + if sfilen := len(ti.sfi); sfilen < binarySearchThreshold { + // linear search. faster than binary search in my testing up to 16-field structs. + for i, si := range ti.sfi { + if si.encName == name { + return i + } + } + } else { + // binary search. adapted from sort/search.go. + h, i, j := 0, 0, sfilen + for i < j { + h = i + (j-i)/2 + if ti.sfi[h].encName < name { + i = h + 1 + } else { + j = h + } + } + if i < sfilen && ti.sfi[i].encName == name { + return i + } + } + return -1 +} + +func getTypeInfo(rtid uintptr, rt reflect.Type) (pti *typeInfo) { + var ok bool + cachedTypeInfoMutex.RLock() + pti, ok = cachedTypeInfo[rtid] + cachedTypeInfoMutex.RUnlock() + if ok { + return + } + + cachedTypeInfoMutex.Lock() + defer cachedTypeInfoMutex.Unlock() + if pti, ok = cachedTypeInfo[rtid]; ok { + return + } + + ti := typeInfo{rt: rt, rtid: rtid} + pti = &ti + + var indir int8 + if ok, indir = implementsIntf(rt, binaryMarshalerTyp); ok { + ti.m, ti.mIndir = true, indir + } + if ok, indir = implementsIntf(rt, binaryUnmarshalerTyp); ok { + ti.unm, ti.unmIndir = true, indir + } + if ok, _ = implementsIntf(rt, mapBySliceTyp); ok { + ti.mbs = true + } + + pt := rt + var ptIndir int8 + // for ; pt.Kind() == reflect.Ptr; pt, ptIndir = pt.Elem(), ptIndir+1 { } + for pt.Kind() == reflect.Ptr { + pt = pt.Elem() + ptIndir++ + } + if ptIndir == 0 { + ti.base = rt + ti.baseId = rtid + } else { + ti.base = pt + ti.baseId = reflect.ValueOf(pt).Pointer() + ti.baseIndir = ptIndir + } + + if rt.Kind() == reflect.Struct { + var siInfo *structFieldInfo + if f, ok := rt.FieldByName(structInfoFieldName); ok { + siInfo = parseStructFieldInfo(structInfoFieldName, f.Tag.Get(structTagName)) + ti.toArray = siInfo.toArray + } + sfip := make([]*structFieldInfo, 0, rt.NumField()) + rgetTypeInfo(rt, nil, make(map[string]bool), &sfip, siInfo) + + // // try to put all si close together + // const tryToPutAllStructFieldInfoTogether = true + // if tryToPutAllStructFieldInfoTogether { + // sfip2 := make([]structFieldInfo, len(sfip)) + // for i, si := range sfip { + // sfip2[i] = *si + // } + // for i := range sfip { + // sfip[i] = &sfip2[i] + // } + // } + + ti.sfip = make([]*structFieldInfo, len(sfip)) + ti.sfi = make([]*structFieldInfo, len(sfip)) + copy(ti.sfip, sfip) + sort.Sort(sfiSortedByEncName(sfip)) + copy(ti.sfi, sfip) + } + // sfi = sfip + cachedTypeInfo[rtid] = pti + return +} + +func rgetTypeInfo(rt reflect.Type, indexstack []int, fnameToHastag map[string]bool, + sfi *[]*structFieldInfo, siInfo *structFieldInfo, +) { + // for rt.Kind() == reflect.Ptr { + // // indexstack = append(indexstack, 0) + // rt = rt.Elem() + // } + for j := 0; j < rt.NumField(); j++ { + f := rt.Field(j) + stag := f.Tag.Get(structTagName) + if stag == "-" { + continue + } + if r1, _ := utf8.DecodeRuneInString(f.Name); r1 == utf8.RuneError || !unicode.IsUpper(r1) { + continue + } + // if anonymous and there is no struct tag and its a struct (or pointer to struct), inline it. + if f.Anonymous && stag == "" { + ft := f.Type + for ft.Kind() == reflect.Ptr { + ft = ft.Elem() + } + if ft.Kind() == reflect.Struct { + indexstack2 := append(append(make([]int, 0, len(indexstack)+4), indexstack...), j) + rgetTypeInfo(ft, indexstack2, fnameToHastag, sfi, siInfo) + continue + } + } + // do not let fields with same name in embedded structs override field at higher level. + // this must be done after anonymous check, to allow anonymous field + // still include their child fields + if _, ok := fnameToHastag[f.Name]; ok { + continue + } + si := parseStructFieldInfo(f.Name, stag) + // si.ikind = int(f.Type.Kind()) + if len(indexstack) == 0 { + si.i = int16(j) + } else { + si.i = -1 + si.is = append(append(make([]int, 0, len(indexstack)+4), indexstack...), j) + } + + if siInfo != nil { + if siInfo.omitEmpty { + si.omitEmpty = true + } + } + *sfi = append(*sfi, si) + fnameToHastag[f.Name] = stag != "" + } +} + +func panicToErr(err *error) { + if recoverPanicToErr { + if x := recover(); x != nil { + //debug.PrintStack() + panicValToErr(x, err) + } + } +} + +func doPanic(tag string, format string, params ...interface{}) { + params2 := make([]interface{}, len(params)+1) + params2[0] = tag + copy(params2[1:], params) + panic(fmt.Errorf("%s: "+format, params2...)) +} + +func checkOverflowFloat32(f float64, doCheck bool) { + if !doCheck { + return + } + // check overflow (logic adapted from std pkg reflect/value.go OverflowFloat() + f2 := f + if f2 < 0 { + f2 = -f + } + if math.MaxFloat32 < f2 && f2 <= math.MaxFloat64 { + decErr("Overflow float32 value: %v", f2) + } +} + +func checkOverflow(ui uint64, i int64, bitsize uint8) { + // check overflow (logic adapted from std pkg reflect/value.go OverflowUint() + if bitsize == 0 { + return + } + if i != 0 { + if trunc := (i << (64 - bitsize)) >> (64 - bitsize); i != trunc { + decErr("Overflow int value: %v", i) + } + } + if ui != 0 { + if trunc := (ui << (64 - bitsize)) >> (64 - bitsize); ui != trunc { + decErr("Overflow uint value: %v", ui) + } + } +} diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/helper_internal.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/helper_internal.go new file mode 100644 index 0000000000..58417da958 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/helper_internal.go @@ -0,0 +1,127 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +// All non-std package dependencies live in this file, +// so porting to different environment is easy (just update functions). + +import ( + "errors" + "fmt" + "math" + "reflect" +) + +var ( + raisePanicAfterRecover = false + debugging = true +) + +func panicValToErr(panicVal interface{}, err *error) { + switch xerr := panicVal.(type) { + case error: + *err = xerr + case string: + *err = errors.New(xerr) + default: + *err = fmt.Errorf("%v", panicVal) + } + if raisePanicAfterRecover { + panic(panicVal) + } + return +} + +func isEmptyValueDeref(v reflect.Value, deref bool) bool { + switch v.Kind() { + case reflect.Array, reflect.Map, reflect.Slice, reflect.String: + return v.Len() == 0 + case reflect.Bool: + return !v.Bool() + case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: + return v.Int() == 0 + case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr: + return v.Uint() == 0 + case reflect.Float32, reflect.Float64: + return v.Float() == 0 + case reflect.Interface, reflect.Ptr: + if deref { + if v.IsNil() { + return true + } + return isEmptyValueDeref(v.Elem(), deref) + } else { + return v.IsNil() + } + case reflect.Struct: + // return true if all fields are empty. else return false. + + // we cannot use equality check, because some fields may be maps/slices/etc + // and consequently the structs are not comparable. + // return v.Interface() == reflect.Zero(v.Type()).Interface() + for i, n := 0, v.NumField(); i < n; i++ { + if !isEmptyValueDeref(v.Field(i), deref) { + return false + } + } + return true + } + return false +} + +func isEmptyValue(v reflect.Value) bool { + return isEmptyValueDeref(v, true) +} + +func debugf(format string, args ...interface{}) { + if debugging { + if len(format) == 0 || format[len(format)-1] != '\n' { + format = format + "\n" + } + fmt.Printf(format, args...) + } +} + +func pruneSignExt(v []byte, pos bool) (n int) { + if len(v) < 2 { + } else if pos && v[0] == 0 { + for ; v[n] == 0 && n+1 < len(v) && (v[n+1]&(1<<7) == 0); n++ { + } + } else if !pos && v[0] == 0xff { + for ; v[n] == 0xff && n+1 < len(v) && (v[n+1]&(1<<7) != 0); n++ { + } + } + return +} + +func implementsIntf(typ, iTyp reflect.Type) (success bool, indir int8) { + if typ == nil { + return + } + rt := typ + // The type might be a pointer and we need to keep + // dereferencing to the base type until we find an implementation. + for { + if rt.Implements(iTyp) { + return true, indir + } + if p := rt; p.Kind() == reflect.Ptr { + indir++ + if indir >= math.MaxInt8 { // insane number of indirections + return false, 0 + } + rt = p.Elem() + continue + } + break + } + // No luck yet, but if this is a base type (non-pointer), the pointer might satisfy. + if typ.Kind() != reflect.Ptr { + // Not a pointer, but does the pointer work? + if reflect.PtrTo(typ).Implements(iTyp) { + return true, -1 + } + } + return false, 0 +} diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack.go new file mode 100644 index 0000000000..da0500d192 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack.go @@ -0,0 +1,816 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +/* +MSGPACK + +Msgpack-c implementation powers the c, c++, python, ruby, etc libraries. +We need to maintain compatibility with it and how it encodes integer values +without caring about the type. + +For compatibility with behaviour of msgpack-c reference implementation: + - Go intX (>0) and uintX + IS ENCODED AS + msgpack +ve fixnum, unsigned + - Go intX (<0) + IS ENCODED AS + msgpack -ve fixnum, signed + +*/ +package codec + +import ( + "fmt" + "io" + "math" + "net/rpc" +) + +const ( + mpPosFixNumMin byte = 0x00 + mpPosFixNumMax = 0x7f + mpFixMapMin = 0x80 + mpFixMapMax = 0x8f + mpFixArrayMin = 0x90 + mpFixArrayMax = 0x9f + mpFixStrMin = 0xa0 + mpFixStrMax = 0xbf + mpNil = 0xc0 + _ = 0xc1 + mpFalse = 0xc2 + mpTrue = 0xc3 + mpFloat = 0xca + mpDouble = 0xcb + mpUint8 = 0xcc + mpUint16 = 0xcd + mpUint32 = 0xce + mpUint64 = 0xcf + mpInt8 = 0xd0 + mpInt16 = 0xd1 + mpInt32 = 0xd2 + mpInt64 = 0xd3 + + // extensions below + mpBin8 = 0xc4 + mpBin16 = 0xc5 + mpBin32 = 0xc6 + mpExt8 = 0xc7 + mpExt16 = 0xc8 + mpExt32 = 0xc9 + mpFixExt1 = 0xd4 + mpFixExt2 = 0xd5 + mpFixExt4 = 0xd6 + mpFixExt8 = 0xd7 + mpFixExt16 = 0xd8 + + mpStr8 = 0xd9 // new + mpStr16 = 0xda + mpStr32 = 0xdb + + mpArray16 = 0xdc + mpArray32 = 0xdd + + mpMap16 = 0xde + mpMap32 = 0xdf + + mpNegFixNumMin = 0xe0 + mpNegFixNumMax = 0xff +) + +// MsgpackSpecRpcMultiArgs is a special type which signifies to the MsgpackSpecRpcCodec +// that the backend RPC service takes multiple arguments, which have been arranged +// in sequence in the slice. +// +// The Codec then passes it AS-IS to the rpc service (without wrapping it in an +// array of 1 element). +type MsgpackSpecRpcMultiArgs []interface{} + +// A MsgpackContainer type specifies the different types of msgpackContainers. +type msgpackContainerType struct { + fixCutoff int + bFixMin, b8, b16, b32 byte + hasFixMin, has8, has8Always bool +} + +var ( + msgpackContainerStr = msgpackContainerType{32, mpFixStrMin, mpStr8, mpStr16, mpStr32, true, true, false} + msgpackContainerBin = msgpackContainerType{0, 0, mpBin8, mpBin16, mpBin32, false, true, true} + msgpackContainerList = msgpackContainerType{16, mpFixArrayMin, 0, mpArray16, mpArray32, true, false, false} + msgpackContainerMap = msgpackContainerType{16, mpFixMapMin, 0, mpMap16, mpMap32, true, false, false} +) + +//--------------------------------------------- + +type msgpackEncDriver struct { + w encWriter + h *MsgpackHandle +} + +func (e *msgpackEncDriver) isBuiltinType(rt uintptr) bool { + //no builtin types. All encodings are based on kinds. Types supported as extensions. + return false +} + +func (e *msgpackEncDriver) encodeBuiltin(rt uintptr, v interface{}) {} + +func (e *msgpackEncDriver) encodeNil() { + e.w.writen1(mpNil) +} + +func (e *msgpackEncDriver) encodeInt(i int64) { + + switch { + case i >= 0: + e.encodeUint(uint64(i)) + case i >= -32: + e.w.writen1(byte(i)) + case i >= math.MinInt8: + e.w.writen2(mpInt8, byte(i)) + case i >= math.MinInt16: + e.w.writen1(mpInt16) + e.w.writeUint16(uint16(i)) + case i >= math.MinInt32: + e.w.writen1(mpInt32) + e.w.writeUint32(uint32(i)) + default: + e.w.writen1(mpInt64) + e.w.writeUint64(uint64(i)) + } +} + +func (e *msgpackEncDriver) encodeUint(i uint64) { + switch { + case i <= math.MaxInt8: + e.w.writen1(byte(i)) + case i <= math.MaxUint8: + e.w.writen2(mpUint8, byte(i)) + case i <= math.MaxUint16: + e.w.writen1(mpUint16) + e.w.writeUint16(uint16(i)) + case i <= math.MaxUint32: + e.w.writen1(mpUint32) + e.w.writeUint32(uint32(i)) + default: + e.w.writen1(mpUint64) + e.w.writeUint64(uint64(i)) + } +} + +func (e *msgpackEncDriver) encodeBool(b bool) { + if b { + e.w.writen1(mpTrue) + } else { + e.w.writen1(mpFalse) + } +} + +func (e *msgpackEncDriver) encodeFloat32(f float32) { + e.w.writen1(mpFloat) + e.w.writeUint32(math.Float32bits(f)) +} + +func (e *msgpackEncDriver) encodeFloat64(f float64) { + e.w.writen1(mpDouble) + e.w.writeUint64(math.Float64bits(f)) +} + +func (e *msgpackEncDriver) encodeExtPreamble(xtag byte, l int) { + switch { + case l == 1: + e.w.writen2(mpFixExt1, xtag) + case l == 2: + e.w.writen2(mpFixExt2, xtag) + case l == 4: + e.w.writen2(mpFixExt4, xtag) + case l == 8: + e.w.writen2(mpFixExt8, xtag) + case l == 16: + e.w.writen2(mpFixExt16, xtag) + case l < 256: + e.w.writen2(mpExt8, byte(l)) + e.w.writen1(xtag) + case l < 65536: + e.w.writen1(mpExt16) + e.w.writeUint16(uint16(l)) + e.w.writen1(xtag) + default: + e.w.writen1(mpExt32) + e.w.writeUint32(uint32(l)) + e.w.writen1(xtag) + } +} + +func (e *msgpackEncDriver) encodeArrayPreamble(length int) { + e.writeContainerLen(msgpackContainerList, length) +} + +func (e *msgpackEncDriver) encodeMapPreamble(length int) { + e.writeContainerLen(msgpackContainerMap, length) +} + +func (e *msgpackEncDriver) encodeString(c charEncoding, s string) { + if c == c_RAW && e.h.WriteExt { + e.writeContainerLen(msgpackContainerBin, len(s)) + } else { + e.writeContainerLen(msgpackContainerStr, len(s)) + } + if len(s) > 0 { + e.w.writestr(s) + } +} + +func (e *msgpackEncDriver) encodeSymbol(v string) { + e.encodeString(c_UTF8, v) +} + +func (e *msgpackEncDriver) encodeStringBytes(c charEncoding, bs []byte) { + if c == c_RAW && e.h.WriteExt { + e.writeContainerLen(msgpackContainerBin, len(bs)) + } else { + e.writeContainerLen(msgpackContainerStr, len(bs)) + } + if len(bs) > 0 { + e.w.writeb(bs) + } +} + +func (e *msgpackEncDriver) writeContainerLen(ct msgpackContainerType, l int) { + switch { + case ct.hasFixMin && l < ct.fixCutoff: + e.w.writen1(ct.bFixMin | byte(l)) + case ct.has8 && l < 256 && (ct.has8Always || e.h.WriteExt): + e.w.writen2(ct.b8, uint8(l)) + case l < 65536: + e.w.writen1(ct.b16) + e.w.writeUint16(uint16(l)) + default: + e.w.writen1(ct.b32) + e.w.writeUint32(uint32(l)) + } +} + +//--------------------------------------------- + +type msgpackDecDriver struct { + r decReader + h *MsgpackHandle + bd byte + bdRead bool + bdType valueType +} + +func (d *msgpackDecDriver) isBuiltinType(rt uintptr) bool { + //no builtin types. All encodings are based on kinds. Types supported as extensions. + return false +} + +func (d *msgpackDecDriver) decodeBuiltin(rt uintptr, v interface{}) {} + +// Note: This returns either a primitive (int, bool, etc) for non-containers, +// or a containerType, or a specific type denoting nil or extension. +// It is called when a nil interface{} is passed, leaving it up to the DecDriver +// to introspect the stream and decide how best to decode. +// It deciphers the value by looking at the stream first. +func (d *msgpackDecDriver) decodeNaked() (v interface{}, vt valueType, decodeFurther bool) { + d.initReadNext() + bd := d.bd + + switch bd { + case mpNil: + vt = valueTypeNil + d.bdRead = false + case mpFalse: + vt = valueTypeBool + v = false + case mpTrue: + vt = valueTypeBool + v = true + + case mpFloat: + vt = valueTypeFloat + v = float64(math.Float32frombits(d.r.readUint32())) + case mpDouble: + vt = valueTypeFloat + v = math.Float64frombits(d.r.readUint64()) + + case mpUint8: + vt = valueTypeUint + v = uint64(d.r.readn1()) + case mpUint16: + vt = valueTypeUint + v = uint64(d.r.readUint16()) + case mpUint32: + vt = valueTypeUint + v = uint64(d.r.readUint32()) + case mpUint64: + vt = valueTypeUint + v = uint64(d.r.readUint64()) + + case mpInt8: + vt = valueTypeInt + v = int64(int8(d.r.readn1())) + case mpInt16: + vt = valueTypeInt + v = int64(int16(d.r.readUint16())) + case mpInt32: + vt = valueTypeInt + v = int64(int32(d.r.readUint32())) + case mpInt64: + vt = valueTypeInt + v = int64(int64(d.r.readUint64())) + + default: + switch { + case bd >= mpPosFixNumMin && bd <= mpPosFixNumMax: + // positive fixnum (always signed) + vt = valueTypeInt + v = int64(int8(bd)) + case bd >= mpNegFixNumMin && bd <= mpNegFixNumMax: + // negative fixnum + vt = valueTypeInt + v = int64(int8(bd)) + case bd == mpStr8, bd == mpStr16, bd == mpStr32, bd >= mpFixStrMin && bd <= mpFixStrMax: + if d.h.RawToString { + var rvm string + vt = valueTypeString + v = &rvm + } else { + var rvm = []byte{} + vt = valueTypeBytes + v = &rvm + } + decodeFurther = true + case bd == mpBin8, bd == mpBin16, bd == mpBin32: + var rvm = []byte{} + vt = valueTypeBytes + v = &rvm + decodeFurther = true + case bd == mpArray16, bd == mpArray32, bd >= mpFixArrayMin && bd <= mpFixArrayMax: + vt = valueTypeArray + decodeFurther = true + case bd == mpMap16, bd == mpMap32, bd >= mpFixMapMin && bd <= mpFixMapMax: + vt = valueTypeMap + decodeFurther = true + case bd >= mpFixExt1 && bd <= mpFixExt16, bd >= mpExt8 && bd <= mpExt32: + clen := d.readExtLen() + var re RawExt + re.Tag = d.r.readn1() + re.Data = d.r.readn(clen) + v = &re + vt = valueTypeExt + default: + decErr("Nil-Deciphered DecodeValue: %s: hex: %x, dec: %d", msgBadDesc, bd, bd) + } + } + if !decodeFurther { + d.bdRead = false + } + return +} + +// int can be decoded from msgpack type: intXXX or uintXXX +func (d *msgpackDecDriver) decodeInt(bitsize uint8) (i int64) { + switch d.bd { + case mpUint8: + i = int64(uint64(d.r.readn1())) + case mpUint16: + i = int64(uint64(d.r.readUint16())) + case mpUint32: + i = int64(uint64(d.r.readUint32())) + case mpUint64: + i = int64(d.r.readUint64()) + case mpInt8: + i = int64(int8(d.r.readn1())) + case mpInt16: + i = int64(int16(d.r.readUint16())) + case mpInt32: + i = int64(int32(d.r.readUint32())) + case mpInt64: + i = int64(d.r.readUint64()) + default: + switch { + case d.bd >= mpPosFixNumMin && d.bd <= mpPosFixNumMax: + i = int64(int8(d.bd)) + case d.bd >= mpNegFixNumMin && d.bd <= mpNegFixNumMax: + i = int64(int8(d.bd)) + default: + decErr("Unhandled single-byte unsigned integer value: %s: %x", msgBadDesc, d.bd) + } + } + // check overflow (logic adapted from std pkg reflect/value.go OverflowUint() + if bitsize > 0 { + if trunc := (i << (64 - bitsize)) >> (64 - bitsize); i != trunc { + decErr("Overflow int value: %v", i) + } + } + d.bdRead = false + return +} + +// uint can be decoded from msgpack type: intXXX or uintXXX +func (d *msgpackDecDriver) decodeUint(bitsize uint8) (ui uint64) { + switch d.bd { + case mpUint8: + ui = uint64(d.r.readn1()) + case mpUint16: + ui = uint64(d.r.readUint16()) + case mpUint32: + ui = uint64(d.r.readUint32()) + case mpUint64: + ui = d.r.readUint64() + case mpInt8: + if i := int64(int8(d.r.readn1())); i >= 0 { + ui = uint64(i) + } else { + decErr("Assigning negative signed value: %v, to unsigned type", i) + } + case mpInt16: + if i := int64(int16(d.r.readUint16())); i >= 0 { + ui = uint64(i) + } else { + decErr("Assigning negative signed value: %v, to unsigned type", i) + } + case mpInt32: + if i := int64(int32(d.r.readUint32())); i >= 0 { + ui = uint64(i) + } else { + decErr("Assigning negative signed value: %v, to unsigned type", i) + } + case mpInt64: + if i := int64(d.r.readUint64()); i >= 0 { + ui = uint64(i) + } else { + decErr("Assigning negative signed value: %v, to unsigned type", i) + } + default: + switch { + case d.bd >= mpPosFixNumMin && d.bd <= mpPosFixNumMax: + ui = uint64(d.bd) + case d.bd >= mpNegFixNumMin && d.bd <= mpNegFixNumMax: + decErr("Assigning negative signed value: %v, to unsigned type", int(d.bd)) + default: + decErr("Unhandled single-byte unsigned integer value: %s: %x", msgBadDesc, d.bd) + } + } + // check overflow (logic adapted from std pkg reflect/value.go OverflowUint() + if bitsize > 0 { + if trunc := (ui << (64 - bitsize)) >> (64 - bitsize); ui != trunc { + decErr("Overflow uint value: %v", ui) + } + } + d.bdRead = false + return +} + +// float can either be decoded from msgpack type: float, double or intX +func (d *msgpackDecDriver) decodeFloat(chkOverflow32 bool) (f float64) { + switch d.bd { + case mpFloat: + f = float64(math.Float32frombits(d.r.readUint32())) + case mpDouble: + f = math.Float64frombits(d.r.readUint64()) + default: + f = float64(d.decodeInt(0)) + } + checkOverflowFloat32(f, chkOverflow32) + d.bdRead = false + return +} + +// bool can be decoded from bool, fixnum 0 or 1. +func (d *msgpackDecDriver) decodeBool() (b bool) { + switch d.bd { + case mpFalse, 0: + // b = false + case mpTrue, 1: + b = true + default: + decErr("Invalid single-byte value for bool: %s: %x", msgBadDesc, d.bd) + } + d.bdRead = false + return +} + +func (d *msgpackDecDriver) decodeString() (s string) { + clen := d.readContainerLen(msgpackContainerStr) + if clen > 0 { + s = string(d.r.readn(clen)) + } + d.bdRead = false + return +} + +// Callers must check if changed=true (to decide whether to replace the one they have) +func (d *msgpackDecDriver) decodeBytes(bs []byte) (bsOut []byte, changed bool) { + // bytes can be decoded from msgpackContainerStr or msgpackContainerBin + var clen int + switch d.bd { + case mpBin8, mpBin16, mpBin32: + clen = d.readContainerLen(msgpackContainerBin) + default: + clen = d.readContainerLen(msgpackContainerStr) + } + // if clen < 0 { + // changed = true + // panic("length cannot be zero. this cannot be nil.") + // } + if clen > 0 { + // if no contents in stream, don't update the passed byteslice + if len(bs) != clen { + // Return changed=true if length of passed slice diff from length of bytes in stream + if len(bs) > clen { + bs = bs[:clen] + } else { + bs = make([]byte, clen) + } + bsOut = bs + changed = true + } + d.r.readb(bs) + } + d.bdRead = false + return +} + +// Every top-level decode funcs (i.e. decodeValue, decode) must call this first. +func (d *msgpackDecDriver) initReadNext() { + if d.bdRead { + return + } + d.bd = d.r.readn1() + d.bdRead = true + d.bdType = valueTypeUnset +} + +func (d *msgpackDecDriver) currentEncodedType() valueType { + if d.bdType == valueTypeUnset { + bd := d.bd + switch bd { + case mpNil: + d.bdType = valueTypeNil + case mpFalse, mpTrue: + d.bdType = valueTypeBool + case mpFloat, mpDouble: + d.bdType = valueTypeFloat + case mpUint8, mpUint16, mpUint32, mpUint64: + d.bdType = valueTypeUint + case mpInt8, mpInt16, mpInt32, mpInt64: + d.bdType = valueTypeInt + default: + switch { + case bd >= mpPosFixNumMin && bd <= mpPosFixNumMax: + d.bdType = valueTypeInt + case bd >= mpNegFixNumMin && bd <= mpNegFixNumMax: + d.bdType = valueTypeInt + case bd == mpStr8, bd == mpStr16, bd == mpStr32, bd >= mpFixStrMin && bd <= mpFixStrMax: + if d.h.RawToString { + d.bdType = valueTypeString + } else { + d.bdType = valueTypeBytes + } + case bd == mpBin8, bd == mpBin16, bd == mpBin32: + d.bdType = valueTypeBytes + case bd == mpArray16, bd == mpArray32, bd >= mpFixArrayMin && bd <= mpFixArrayMax: + d.bdType = valueTypeArray + case bd == mpMap16, bd == mpMap32, bd >= mpFixMapMin && bd <= mpFixMapMax: + d.bdType = valueTypeMap + case bd >= mpFixExt1 && bd <= mpFixExt16, bd >= mpExt8 && bd <= mpExt32: + d.bdType = valueTypeExt + default: + decErr("currentEncodedType: Undeciphered descriptor: %s: hex: %x, dec: %d", msgBadDesc, bd, bd) + } + } + } + return d.bdType +} + +func (d *msgpackDecDriver) tryDecodeAsNil() bool { + if d.bd == mpNil { + d.bdRead = false + return true + } + return false +} + +func (d *msgpackDecDriver) readContainerLen(ct msgpackContainerType) (clen int) { + bd := d.bd + switch { + case bd == mpNil: + clen = -1 // to represent nil + case bd == ct.b8: + clen = int(d.r.readn1()) + case bd == ct.b16: + clen = int(d.r.readUint16()) + case bd == ct.b32: + clen = int(d.r.readUint32()) + case (ct.bFixMin & bd) == ct.bFixMin: + clen = int(ct.bFixMin ^ bd) + default: + decErr("readContainerLen: %s: hex: %x, dec: %d", msgBadDesc, bd, bd) + } + d.bdRead = false + return +} + +func (d *msgpackDecDriver) readMapLen() int { + return d.readContainerLen(msgpackContainerMap) +} + +func (d *msgpackDecDriver) readArrayLen() int { + return d.readContainerLen(msgpackContainerList) +} + +func (d *msgpackDecDriver) readExtLen() (clen int) { + switch d.bd { + case mpNil: + clen = -1 // to represent nil + case mpFixExt1: + clen = 1 + case mpFixExt2: + clen = 2 + case mpFixExt4: + clen = 4 + case mpFixExt8: + clen = 8 + case mpFixExt16: + clen = 16 + case mpExt8: + clen = int(d.r.readn1()) + case mpExt16: + clen = int(d.r.readUint16()) + case mpExt32: + clen = int(d.r.readUint32()) + default: + decErr("decoding ext bytes: found unexpected byte: %x", d.bd) + } + return +} + +func (d *msgpackDecDriver) decodeExt(verifyTag bool, tag byte) (xtag byte, xbs []byte) { + xbd := d.bd + switch { + case xbd == mpBin8, xbd == mpBin16, xbd == mpBin32: + xbs, _ = d.decodeBytes(nil) + case xbd == mpStr8, xbd == mpStr16, xbd == mpStr32, + xbd >= mpFixStrMin && xbd <= mpFixStrMax: + xbs = []byte(d.decodeString()) + default: + clen := d.readExtLen() + xtag = d.r.readn1() + if verifyTag && xtag != tag { + decErr("Wrong extension tag. Got %b. Expecting: %v", xtag, tag) + } + xbs = d.r.readn(clen) + } + d.bdRead = false + return +} + +//-------------------------------------------------- + +//MsgpackHandle is a Handle for the Msgpack Schema-Free Encoding Format. +type MsgpackHandle struct { + BasicHandle + + // RawToString controls how raw bytes are decoded into a nil interface{}. + RawToString bool + // WriteExt flag supports encoding configured extensions with extension tags. + // It also controls whether other elements of the new spec are encoded (ie Str8). + // + // With WriteExt=false, configured extensions are serialized as raw bytes + // and Str8 is not encoded. + // + // A stream can still be decoded into a typed value, provided an appropriate value + // is provided, but the type cannot be inferred from the stream. If no appropriate + // type is provided (e.g. decoding into a nil interface{}), you get back + // a []byte or string based on the setting of RawToString. + WriteExt bool +} + +func (h *MsgpackHandle) newEncDriver(w encWriter) encDriver { + return &msgpackEncDriver{w: w, h: h} +} + +func (h *MsgpackHandle) newDecDriver(r decReader) decDriver { + return &msgpackDecDriver{r: r, h: h} +} + +func (h *MsgpackHandle) writeExt() bool { + return h.WriteExt +} + +func (h *MsgpackHandle) getBasicHandle() *BasicHandle { + return &h.BasicHandle +} + +//-------------------------------------------------- + +type msgpackSpecRpcCodec struct { + rpcCodec +} + +// /////////////// Spec RPC Codec /////////////////// +func (c *msgpackSpecRpcCodec) WriteRequest(r *rpc.Request, body interface{}) error { + // WriteRequest can write to both a Go service, and other services that do + // not abide by the 1 argument rule of a Go service. + // We discriminate based on if the body is a MsgpackSpecRpcMultiArgs + var bodyArr []interface{} + if m, ok := body.(MsgpackSpecRpcMultiArgs); ok { + bodyArr = ([]interface{})(m) + } else { + bodyArr = []interface{}{body} + } + r2 := []interface{}{0, uint32(r.Seq), r.ServiceMethod, bodyArr} + return c.write(r2, nil, false, true) +} + +func (c *msgpackSpecRpcCodec) WriteResponse(r *rpc.Response, body interface{}) error { + var moe interface{} + if r.Error != "" { + moe = r.Error + } + if moe != nil && body != nil { + body = nil + } + r2 := []interface{}{1, uint32(r.Seq), moe, body} + return c.write(r2, nil, false, true) +} + +func (c *msgpackSpecRpcCodec) ReadResponseHeader(r *rpc.Response) error { + return c.parseCustomHeader(1, &r.Seq, &r.Error) +} + +func (c *msgpackSpecRpcCodec) ReadRequestHeader(r *rpc.Request) error { + return c.parseCustomHeader(0, &r.Seq, &r.ServiceMethod) +} + +func (c *msgpackSpecRpcCodec) ReadRequestBody(body interface{}) error { + if body == nil { // read and discard + return c.read(nil) + } + bodyArr := []interface{}{body} + return c.read(&bodyArr) +} + +func (c *msgpackSpecRpcCodec) parseCustomHeader(expectTypeByte byte, msgid *uint64, methodOrError *string) (err error) { + + if c.cls { + return io.EOF + } + + // We read the response header by hand + // so that the body can be decoded on its own from the stream at a later time. + + const fia byte = 0x94 //four item array descriptor value + // Not sure why the panic of EOF is swallowed above. + // if bs1 := c.dec.r.readn1(); bs1 != fia { + // err = fmt.Errorf("Unexpected value for array descriptor: Expecting %v. Received %v", fia, bs1) + // return + // } + var b byte + b, err = c.br.ReadByte() + if err != nil { + return + } + if b != fia { + err = fmt.Errorf("Unexpected value for array descriptor: Expecting %v. Received %v", fia, b) + return + } + + if err = c.read(&b); err != nil { + return + } + if b != expectTypeByte { + err = fmt.Errorf("Unexpected byte descriptor in header. Expecting %v. Received %v", expectTypeByte, b) + return + } + if err = c.read(msgid); err != nil { + return + } + if err = c.read(methodOrError); err != nil { + return + } + return +} + +//-------------------------------------------------- + +// msgpackSpecRpc is the implementation of Rpc that uses custom communication protocol +// as defined in the msgpack spec at https://github.com/msgpack-rpc/msgpack-rpc/blob/master/spec.md +type msgpackSpecRpc struct{} + +// MsgpackSpecRpc implements Rpc using the communication protocol defined in +// the msgpack spec at https://github.com/msgpack-rpc/msgpack-rpc/blob/master/spec.md . +// Its methods (ServerCodec and ClientCodec) return values that implement RpcCodecBuffered. +var MsgpackSpecRpc msgpackSpecRpc + +func (x msgpackSpecRpc) ServerCodec(conn io.ReadWriteCloser, h Handle) rpc.ServerCodec { + return &msgpackSpecRpcCodec{newRPCCodec(conn, h)} +} + +func (x msgpackSpecRpc) ClientCodec(conn io.ReadWriteCloser, h Handle) rpc.ClientCodec { + return &msgpackSpecRpcCodec{newRPCCodec(conn, h)} +} + +var _ decDriver = (*msgpackDecDriver)(nil) +var _ encDriver = (*msgpackEncDriver)(nil) diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack_test.py b/vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack_test.py new file mode 100755 index 0000000000..e933838c56 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/msgpack_test.py @@ -0,0 +1,110 @@ +#!/usr/bin/env python + +# This will create golden files in a directory passed to it. +# A Test calls this internally to create the golden files +# So it can process them (so we don't have to checkin the files). + +import msgpack, msgpackrpc, sys, os, threading + +def get_test_data_list(): + # get list with all primitive types, and a combo type + l0 = [ + -8, + -1616, + -32323232, + -6464646464646464, + 192, + 1616, + 32323232, + 6464646464646464, + 192, + -3232.0, + -6464646464.0, + 3232.0, + 6464646464.0, + False, + True, + None, + "someday", + "", + "bytestring", + 1328176922000002000, + -2206187877999998000, + 0, + -6795364578871345152 + ] + l1 = [ + { "true": True, + "false": False }, + { "true": "True", + "false": False, + "uint16(1616)": 1616 }, + { "list": [1616, 32323232, True, -3232.0, {"TRUE":True, "FALSE":False}, [True, False] ], + "int32":32323232, "bool": True, + "LONG STRING": "123456789012345678901234567890123456789012345678901234567890", + "SHORT STRING": "1234567890" }, + { True: "true", 8: False, "false": 0 } + ] + + l = [] + l.extend(l0) + l.append(l0) + l.extend(l1) + return l + +def build_test_data(destdir): + l = get_test_data_list() + for i in range(len(l)): + packer = msgpack.Packer() + serialized = packer.pack(l[i]) + f = open(os.path.join(destdir, str(i) + '.golden'), 'wb') + f.write(serialized) + f.close() + +def doRpcServer(port, stopTimeSec): + class EchoHandler(object): + def Echo123(self, msg1, msg2, msg3): + return ("1:%s 2:%s 3:%s" % (msg1, msg2, msg3)) + def EchoStruct(self, msg): + return ("%s" % msg) + + addr = msgpackrpc.Address('localhost', port) + server = msgpackrpc.Server(EchoHandler()) + server.listen(addr) + # run thread to stop it after stopTimeSec seconds if > 0 + if stopTimeSec > 0: + def myStopRpcServer(): + server.stop() + t = threading.Timer(stopTimeSec, myStopRpcServer) + t.start() + server.start() + +def doRpcClientToPythonSvc(port): + address = msgpackrpc.Address('localhost', port) + client = msgpackrpc.Client(address, unpack_encoding='utf-8') + print client.call("Echo123", "A1", "B2", "C3") + print client.call("EchoStruct", {"A" :"Aa", "B":"Bb", "C":"Cc"}) + +def doRpcClientToGoSvc(port): + # print ">>>> port: ", port, " <<<<<" + address = msgpackrpc.Address('localhost', port) + client = msgpackrpc.Client(address, unpack_encoding='utf-8') + print client.call("TestRpcInt.Echo123", ["A1", "B2", "C3"]) + print client.call("TestRpcInt.EchoStruct", {"A" :"Aa", "B":"Bb", "C":"Cc"}) + +def doMain(args): + if len(args) == 2 and args[0] == "testdata": + build_test_data(args[1]) + elif len(args) == 3 and args[0] == "rpc-server": + doRpcServer(int(args[1]), int(args[2])) + elif len(args) == 2 and args[0] == "rpc-client-python-service": + doRpcClientToPythonSvc(int(args[1])) + elif len(args) == 2 and args[0] == "rpc-client-go-service": + doRpcClientToGoSvc(int(args[1])) + else: + print("Usage: msgpack_test.py " + + "[testdata|rpc-server|rpc-client-python-service|rpc-client-go-service] ...") + +if __name__ == "__main__": + doMain(sys.argv[1:]) + diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/rpc.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/rpc.go new file mode 100644 index 0000000000..d014dbdcc7 --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/rpc.go @@ -0,0 +1,152 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +import ( + "bufio" + "io" + "net/rpc" + "sync" +) + +// Rpc provides a rpc Server or Client Codec for rpc communication. +type Rpc interface { + ServerCodec(conn io.ReadWriteCloser, h Handle) rpc.ServerCodec + ClientCodec(conn io.ReadWriteCloser, h Handle) rpc.ClientCodec +} + +// RpcCodecBuffered allows access to the underlying bufio.Reader/Writer +// used by the rpc connection. It accomodates use-cases where the connection +// should be used by rpc and non-rpc functions, e.g. streaming a file after +// sending an rpc response. +type RpcCodecBuffered interface { + BufferedReader() *bufio.Reader + BufferedWriter() *bufio.Writer +} + +// ------------------------------------- + +// rpcCodec defines the struct members and common methods. +type rpcCodec struct { + rwc io.ReadWriteCloser + dec *Decoder + enc *Encoder + bw *bufio.Writer + br *bufio.Reader + mu sync.Mutex + cls bool +} + +func newRPCCodec(conn io.ReadWriteCloser, h Handle) rpcCodec { + bw := bufio.NewWriter(conn) + br := bufio.NewReader(conn) + return rpcCodec{ + rwc: conn, + bw: bw, + br: br, + enc: NewEncoder(bw, h), + dec: NewDecoder(br, h), + } +} + +func (c *rpcCodec) BufferedReader() *bufio.Reader { + return c.br +} + +func (c *rpcCodec) BufferedWriter() *bufio.Writer { + return c.bw +} + +func (c *rpcCodec) write(obj1, obj2 interface{}, writeObj2, doFlush bool) (err error) { + if c.cls { + return io.EOF + } + if err = c.enc.Encode(obj1); err != nil { + return + } + if writeObj2 { + if err = c.enc.Encode(obj2); err != nil { + return + } + } + if doFlush && c.bw != nil { + return c.bw.Flush() + } + return +} + +func (c *rpcCodec) read(obj interface{}) (err error) { + if c.cls { + return io.EOF + } + //If nil is passed in, we should still attempt to read content to nowhere. + if obj == nil { + var obj2 interface{} + return c.dec.Decode(&obj2) + } + return c.dec.Decode(obj) +} + +func (c *rpcCodec) Close() error { + if c.cls { + return io.EOF + } + c.cls = true + return c.rwc.Close() +} + +func (c *rpcCodec) ReadResponseBody(body interface{}) error { + return c.read(body) +} + +// ------------------------------------- + +type goRpcCodec struct { + rpcCodec +} + +func (c *goRpcCodec) WriteRequest(r *rpc.Request, body interface{}) error { + // Must protect for concurrent access as per API + c.mu.Lock() + defer c.mu.Unlock() + return c.write(r, body, true, true) +} + +func (c *goRpcCodec) WriteResponse(r *rpc.Response, body interface{}) error { + c.mu.Lock() + defer c.mu.Unlock() + return c.write(r, body, true, true) +} + +func (c *goRpcCodec) ReadResponseHeader(r *rpc.Response) error { + return c.read(r) +} + +func (c *goRpcCodec) ReadRequestHeader(r *rpc.Request) error { + return c.read(r) +} + +func (c *goRpcCodec) ReadRequestBody(body interface{}) error { + return c.read(body) +} + +// ------------------------------------- + +// goRpc is the implementation of Rpc that uses the communication protocol +// as defined in net/rpc package. +type goRpc struct{} + +// GoRpc implements Rpc using the communication protocol defined in net/rpc package. +// Its methods (ServerCodec and ClientCodec) return values that implement RpcCodecBuffered. +var GoRpc goRpc + +func (x goRpc) ServerCodec(conn io.ReadWriteCloser, h Handle) rpc.ServerCodec { + return &goRpcCodec{newRPCCodec(conn, h)} +} + +func (x goRpc) ClientCodec(conn io.ReadWriteCloser, h Handle) rpc.ClientCodec { + return &goRpcCodec{newRPCCodec(conn, h)} +} + +var _ RpcCodecBuffered = (*rpcCodec)(nil) // ensure *rpcCodec implements RpcCodecBuffered diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/simple.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/simple.go new file mode 100644 index 0000000000..9e4d148a2a --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/simple.go @@ -0,0 +1,461 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +import "math" + +const ( + _ uint8 = iota + simpleVdNil = 1 + simpleVdFalse = 2 + simpleVdTrue = 3 + simpleVdFloat32 = 4 + simpleVdFloat64 = 5 + + // each lasts for 4 (ie n, n+1, n+2, n+3) + simpleVdPosInt = 8 + simpleVdNegInt = 12 + + // containers: each lasts for 4 (ie n, n+1, n+2, ... n+7) + simpleVdString = 216 + simpleVdByteArray = 224 + simpleVdArray = 232 + simpleVdMap = 240 + simpleVdExt = 248 +) + +type simpleEncDriver struct { + h *SimpleHandle + w encWriter + //b [8]byte +} + +func (e *simpleEncDriver) isBuiltinType(rt uintptr) bool { + return false +} + +func (e *simpleEncDriver) encodeBuiltin(rt uintptr, v interface{}) { +} + +func (e *simpleEncDriver) encodeNil() { + e.w.writen1(simpleVdNil) +} + +func (e *simpleEncDriver) encodeBool(b bool) { + if b { + e.w.writen1(simpleVdTrue) + } else { + e.w.writen1(simpleVdFalse) + } +} + +func (e *simpleEncDriver) encodeFloat32(f float32) { + e.w.writen1(simpleVdFloat32) + e.w.writeUint32(math.Float32bits(f)) +} + +func (e *simpleEncDriver) encodeFloat64(f float64) { + e.w.writen1(simpleVdFloat64) + e.w.writeUint64(math.Float64bits(f)) +} + +func (e *simpleEncDriver) encodeInt(v int64) { + if v < 0 { + e.encUint(uint64(-v), simpleVdNegInt) + } else { + e.encUint(uint64(v), simpleVdPosInt) + } +} + +func (e *simpleEncDriver) encodeUint(v uint64) { + e.encUint(v, simpleVdPosInt) +} + +func (e *simpleEncDriver) encUint(v uint64, bd uint8) { + switch { + case v <= math.MaxUint8: + e.w.writen2(bd, uint8(v)) + case v <= math.MaxUint16: + e.w.writen1(bd + 1) + e.w.writeUint16(uint16(v)) + case v <= math.MaxUint32: + e.w.writen1(bd + 2) + e.w.writeUint32(uint32(v)) + case v <= math.MaxUint64: + e.w.writen1(bd + 3) + e.w.writeUint64(v) + } +} + +func (e *simpleEncDriver) encLen(bd byte, length int) { + switch { + case length == 0: + e.w.writen1(bd) + case length <= math.MaxUint8: + e.w.writen1(bd + 1) + e.w.writen1(uint8(length)) + case length <= math.MaxUint16: + e.w.writen1(bd + 2) + e.w.writeUint16(uint16(length)) + case int64(length) <= math.MaxUint32: + e.w.writen1(bd + 3) + e.w.writeUint32(uint32(length)) + default: + e.w.writen1(bd + 4) + e.w.writeUint64(uint64(length)) + } +} + +func (e *simpleEncDriver) encodeExtPreamble(xtag byte, length int) { + e.encLen(simpleVdExt, length) + e.w.writen1(xtag) +} + +func (e *simpleEncDriver) encodeArrayPreamble(length int) { + e.encLen(simpleVdArray, length) +} + +func (e *simpleEncDriver) encodeMapPreamble(length int) { + e.encLen(simpleVdMap, length) +} + +func (e *simpleEncDriver) encodeString(c charEncoding, v string) { + e.encLen(simpleVdString, len(v)) + e.w.writestr(v) +} + +func (e *simpleEncDriver) encodeSymbol(v string) { + e.encodeString(c_UTF8, v) +} + +func (e *simpleEncDriver) encodeStringBytes(c charEncoding, v []byte) { + e.encLen(simpleVdByteArray, len(v)) + e.w.writeb(v) +} + +//------------------------------------ + +type simpleDecDriver struct { + h *SimpleHandle + r decReader + bdRead bool + bdType valueType + bd byte + //b [8]byte +} + +func (d *simpleDecDriver) initReadNext() { + if d.bdRead { + return + } + d.bd = d.r.readn1() + d.bdRead = true + d.bdType = valueTypeUnset +} + +func (d *simpleDecDriver) currentEncodedType() valueType { + if d.bdType == valueTypeUnset { + switch d.bd { + case simpleVdNil: + d.bdType = valueTypeNil + case simpleVdTrue, simpleVdFalse: + d.bdType = valueTypeBool + case simpleVdPosInt, simpleVdPosInt + 1, simpleVdPosInt + 2, simpleVdPosInt + 3: + d.bdType = valueTypeUint + case simpleVdNegInt, simpleVdNegInt + 1, simpleVdNegInt + 2, simpleVdNegInt + 3: + d.bdType = valueTypeInt + case simpleVdFloat32, simpleVdFloat64: + d.bdType = valueTypeFloat + case simpleVdString, simpleVdString + 1, simpleVdString + 2, simpleVdString + 3, simpleVdString + 4: + d.bdType = valueTypeString + case simpleVdByteArray, simpleVdByteArray + 1, simpleVdByteArray + 2, simpleVdByteArray + 3, simpleVdByteArray + 4: + d.bdType = valueTypeBytes + case simpleVdExt, simpleVdExt + 1, simpleVdExt + 2, simpleVdExt + 3, simpleVdExt + 4: + d.bdType = valueTypeExt + case simpleVdArray, simpleVdArray + 1, simpleVdArray + 2, simpleVdArray + 3, simpleVdArray + 4: + d.bdType = valueTypeArray + case simpleVdMap, simpleVdMap + 1, simpleVdMap + 2, simpleVdMap + 3, simpleVdMap + 4: + d.bdType = valueTypeMap + default: + decErr("currentEncodedType: Unrecognized d.vd: 0x%x", d.bd) + } + } + return d.bdType +} + +func (d *simpleDecDriver) tryDecodeAsNil() bool { + if d.bd == simpleVdNil { + d.bdRead = false + return true + } + return false +} + +func (d *simpleDecDriver) isBuiltinType(rt uintptr) bool { + return false +} + +func (d *simpleDecDriver) decodeBuiltin(rt uintptr, v interface{}) { +} + +func (d *simpleDecDriver) decIntAny() (ui uint64, i int64, neg bool) { + switch d.bd { + case simpleVdPosInt: + ui = uint64(d.r.readn1()) + i = int64(ui) + case simpleVdPosInt + 1: + ui = uint64(d.r.readUint16()) + i = int64(ui) + case simpleVdPosInt + 2: + ui = uint64(d.r.readUint32()) + i = int64(ui) + case simpleVdPosInt + 3: + ui = uint64(d.r.readUint64()) + i = int64(ui) + case simpleVdNegInt: + ui = uint64(d.r.readn1()) + i = -(int64(ui)) + neg = true + case simpleVdNegInt + 1: + ui = uint64(d.r.readUint16()) + i = -(int64(ui)) + neg = true + case simpleVdNegInt + 2: + ui = uint64(d.r.readUint32()) + i = -(int64(ui)) + neg = true + case simpleVdNegInt + 3: + ui = uint64(d.r.readUint64()) + i = -(int64(ui)) + neg = true + default: + decErr("decIntAny: Integer only valid from pos/neg integer1..8. Invalid descriptor: %v", d.bd) + } + // don't do this check, because callers may only want the unsigned value. + // if ui > math.MaxInt64 { + // decErr("decIntAny: Integer out of range for signed int64: %v", ui) + // } + return +} + +func (d *simpleDecDriver) decodeInt(bitsize uint8) (i int64) { + _, i, _ = d.decIntAny() + checkOverflow(0, i, bitsize) + d.bdRead = false + return +} + +func (d *simpleDecDriver) decodeUint(bitsize uint8) (ui uint64) { + ui, i, neg := d.decIntAny() + if neg { + decErr("Assigning negative signed value: %v, to unsigned type", i) + } + checkOverflow(ui, 0, bitsize) + d.bdRead = false + return +} + +func (d *simpleDecDriver) decodeFloat(chkOverflow32 bool) (f float64) { + switch d.bd { + case simpleVdFloat32: + f = float64(math.Float32frombits(d.r.readUint32())) + case simpleVdFloat64: + f = math.Float64frombits(d.r.readUint64()) + default: + if d.bd >= simpleVdPosInt && d.bd <= simpleVdNegInt+3 { + _, i, _ := d.decIntAny() + f = float64(i) + } else { + decErr("Float only valid from float32/64: Invalid descriptor: %v", d.bd) + } + } + checkOverflowFloat32(f, chkOverflow32) + d.bdRead = false + return +} + +// bool can be decoded from bool only (single byte). +func (d *simpleDecDriver) decodeBool() (b bool) { + switch d.bd { + case simpleVdTrue: + b = true + case simpleVdFalse: + default: + decErr("Invalid single-byte value for bool: %s: %x", msgBadDesc, d.bd) + } + d.bdRead = false + return +} + +func (d *simpleDecDriver) readMapLen() (length int) { + d.bdRead = false + return d.decLen() +} + +func (d *simpleDecDriver) readArrayLen() (length int) { + d.bdRead = false + return d.decLen() +} + +func (d *simpleDecDriver) decLen() int { + switch d.bd % 8 { + case 0: + return 0 + case 1: + return int(d.r.readn1()) + case 2: + return int(d.r.readUint16()) + case 3: + ui := uint64(d.r.readUint32()) + checkOverflow(ui, 0, intBitsize) + return int(ui) + case 4: + ui := d.r.readUint64() + checkOverflow(ui, 0, intBitsize) + return int(ui) + } + decErr("decLen: Cannot read length: bd%8 must be in range 0..4. Got: %d", d.bd%8) + return -1 +} + +func (d *simpleDecDriver) decodeString() (s string) { + s = string(d.r.readn(d.decLen())) + d.bdRead = false + return +} + +func (d *simpleDecDriver) decodeBytes(bs []byte) (bsOut []byte, changed bool) { + if clen := d.decLen(); clen > 0 { + // if no contents in stream, don't update the passed byteslice + if len(bs) != clen { + if len(bs) > clen { + bs = bs[:clen] + } else { + bs = make([]byte, clen) + } + bsOut = bs + changed = true + } + d.r.readb(bs) + } + d.bdRead = false + return +} + +func (d *simpleDecDriver) decodeExt(verifyTag bool, tag byte) (xtag byte, xbs []byte) { + switch d.bd { + case simpleVdExt, simpleVdExt + 1, simpleVdExt + 2, simpleVdExt + 3, simpleVdExt + 4: + l := d.decLen() + xtag = d.r.readn1() + if verifyTag && xtag != tag { + decErr("Wrong extension tag. Got %b. Expecting: %v", xtag, tag) + } + xbs = d.r.readn(l) + case simpleVdByteArray, simpleVdByteArray + 1, simpleVdByteArray + 2, simpleVdByteArray + 3, simpleVdByteArray + 4: + xbs, _ = d.decodeBytes(nil) + default: + decErr("Invalid d.vd for extensions (Expecting extensions or byte array). Got: 0x%x", d.bd) + } + d.bdRead = false + return +} + +func (d *simpleDecDriver) decodeNaked() (v interface{}, vt valueType, decodeFurther bool) { + d.initReadNext() + + switch d.bd { + case simpleVdNil: + vt = valueTypeNil + case simpleVdFalse: + vt = valueTypeBool + v = false + case simpleVdTrue: + vt = valueTypeBool + v = true + case simpleVdPosInt, simpleVdPosInt + 1, simpleVdPosInt + 2, simpleVdPosInt + 3: + vt = valueTypeUint + ui, _, _ := d.decIntAny() + v = ui + case simpleVdNegInt, simpleVdNegInt + 1, simpleVdNegInt + 2, simpleVdNegInt + 3: + vt = valueTypeInt + _, i, _ := d.decIntAny() + v = i + case simpleVdFloat32: + vt = valueTypeFloat + v = d.decodeFloat(true) + case simpleVdFloat64: + vt = valueTypeFloat + v = d.decodeFloat(false) + case simpleVdString, simpleVdString + 1, simpleVdString + 2, simpleVdString + 3, simpleVdString + 4: + vt = valueTypeString + v = d.decodeString() + case simpleVdByteArray, simpleVdByteArray + 1, simpleVdByteArray + 2, simpleVdByteArray + 3, simpleVdByteArray + 4: + vt = valueTypeBytes + v, _ = d.decodeBytes(nil) + case simpleVdExt, simpleVdExt + 1, simpleVdExt + 2, simpleVdExt + 3, simpleVdExt + 4: + vt = valueTypeExt + l := d.decLen() + var re RawExt + re.Tag = d.r.readn1() + re.Data = d.r.readn(l) + v = &re + vt = valueTypeExt + case simpleVdArray, simpleVdArray + 1, simpleVdArray + 2, simpleVdArray + 3, simpleVdArray + 4: + vt = valueTypeArray + decodeFurther = true + case simpleVdMap, simpleVdMap + 1, simpleVdMap + 2, simpleVdMap + 3, simpleVdMap + 4: + vt = valueTypeMap + decodeFurther = true + default: + decErr("decodeNaked: Unrecognized d.vd: 0x%x", d.bd) + } + + if !decodeFurther { + d.bdRead = false + } + return +} + +//------------------------------------ + +// SimpleHandle is a Handle for a very simple encoding format. +// +// simple is a simplistic codec similar to binc, but not as compact. +// - Encoding of a value is always preceeded by the descriptor byte (bd) +// - True, false, nil are encoded fully in 1 byte (the descriptor) +// - Integers (intXXX, uintXXX) are encoded in 1, 2, 4 or 8 bytes (plus a descriptor byte). +// There are positive (uintXXX and intXXX >= 0) and negative (intXXX < 0) integers. +// - Floats are encoded in 4 or 8 bytes (plus a descriptor byte) +// - Lenght of containers (strings, bytes, array, map, extensions) +// are encoded in 0, 1, 2, 4 or 8 bytes. +// Zero-length containers have no length encoded. +// For others, the number of bytes is given by pow(2, bd%3) +// - maps are encoded as [bd] [length] [[key][value]]... +// - arrays are encoded as [bd] [length] [value]... +// - extensions are encoded as [bd] [length] [tag] [byte]... +// - strings/bytearrays are encoded as [bd] [length] [byte]... +// +// The full spec will be published soon. +type SimpleHandle struct { + BasicHandle +} + +func (h *SimpleHandle) newEncDriver(w encWriter) encDriver { + return &simpleEncDriver{w: w, h: h} +} + +func (h *SimpleHandle) newDecDriver(r decReader) decDriver { + return &simpleDecDriver{r: r, h: h} +} + +func (_ *SimpleHandle) writeExt() bool { + return true +} + +func (h *SimpleHandle) getBasicHandle() *BasicHandle { + return &h.BasicHandle +} + +var _ decDriver = (*simpleDecDriver)(nil) +var _ encDriver = (*simpleEncDriver)(nil) diff --git a/vendor/src/github.com/hashicorp/go-msgpack/codec/time.go b/vendor/src/github.com/hashicorp/go-msgpack/codec/time.go new file mode 100644 index 0000000000..c86d65328d --- /dev/null +++ b/vendor/src/github.com/hashicorp/go-msgpack/codec/time.go @@ -0,0 +1,193 @@ +// Copyright (c) 2012, 2013 Ugorji Nwoke. All rights reserved. +// Use of this source code is governed by a BSD-style license found in the LICENSE file. + +package codec + +import ( + "time" +) + +var ( + timeDigits = [...]byte{'0', '1', '2', '3', '4', '5', '6', '7', '8', '9'} +) + +// EncodeTime encodes a time.Time as a []byte, including +// information on the instant in time and UTC offset. +// +// Format Description +// +// A timestamp is composed of 3 components: +// +// - secs: signed integer representing seconds since unix epoch +// - nsces: unsigned integer representing fractional seconds as a +// nanosecond offset within secs, in the range 0 <= nsecs < 1e9 +// - tz: signed integer representing timezone offset in minutes east of UTC, +// and a dst (daylight savings time) flag +// +// When encoding a timestamp, the first byte is the descriptor, which +// defines which components are encoded and how many bytes are used to +// encode secs and nsecs components. *If secs/nsecs is 0 or tz is UTC, it +// is not encoded in the byte array explicitly*. +// +// Descriptor 8 bits are of the form `A B C DDD EE`: +// A: Is secs component encoded? 1 = true +// B: Is nsecs component encoded? 1 = true +// C: Is tz component encoded? 1 = true +// DDD: Number of extra bytes for secs (range 0-7). +// If A = 1, secs encoded in DDD+1 bytes. +// If A = 0, secs is not encoded, and is assumed to be 0. +// If A = 1, then we need at least 1 byte to encode secs. +// DDD says the number of extra bytes beyond that 1. +// E.g. if DDD=0, then secs is represented in 1 byte. +// if DDD=2, then secs is represented in 3 bytes. +// EE: Number of extra bytes for nsecs (range 0-3). +// If B = 1, nsecs encoded in EE+1 bytes (similar to secs/DDD above) +// +// Following the descriptor bytes, subsequent bytes are: +// +// secs component encoded in `DDD + 1` bytes (if A == 1) +// nsecs component encoded in `EE + 1` bytes (if B == 1) +// tz component encoded in 2 bytes (if C == 1) +// +// secs and nsecs components are integers encoded in a BigEndian +// 2-complement encoding format. +// +// tz component is encoded as 2 bytes (16 bits). Most significant bit 15 to +// Least significant bit 0 are described below: +// +// Timezone offset has a range of -12:00 to +14:00 (ie -720 to +840 minutes). +// Bit 15 = have\_dst: set to 1 if we set the dst flag. +// Bit 14 = dst\_on: set to 1 if dst is in effect at the time, or 0 if not. +// Bits 13..0 = timezone offset in minutes. It is a signed integer in Big Endian format. +// +func encodeTime(t time.Time) []byte { + //t := rv.Interface().(time.Time) + tsecs, tnsecs := t.Unix(), t.Nanosecond() + var ( + bd byte + btmp [8]byte + bs [16]byte + i int = 1 + ) + l := t.Location() + if l == time.UTC { + l = nil + } + if tsecs != 0 { + bd = bd | 0x80 + bigen.PutUint64(btmp[:], uint64(tsecs)) + f := pruneSignExt(btmp[:], tsecs >= 0) + bd = bd | (byte(7-f) << 2) + copy(bs[i:], btmp[f:]) + i = i + (8 - f) + } + if tnsecs != 0 { + bd = bd | 0x40 + bigen.PutUint32(btmp[:4], uint32(tnsecs)) + f := pruneSignExt(btmp[:4], true) + bd = bd | byte(3-f) + copy(bs[i:], btmp[f:4]) + i = i + (4 - f) + } + if l != nil { + bd = bd | 0x20 + // Note that Go Libs do not give access to dst flag. + _, zoneOffset := t.Zone() + //zoneName, zoneOffset := t.Zone() + zoneOffset /= 60 + z := uint16(zoneOffset) + bigen.PutUint16(btmp[:2], z) + // clear dst flags + bs[i] = btmp[0] & 0x3f + bs[i+1] = btmp[1] + i = i + 2 + } + bs[0] = bd + return bs[0:i] +} + +// DecodeTime decodes a []byte into a time.Time. +func decodeTime(bs []byte) (tt time.Time, err error) { + bd := bs[0] + var ( + tsec int64 + tnsec uint32 + tz uint16 + i byte = 1 + i2 byte + n byte + ) + if bd&(1<<7) != 0 { + var btmp [8]byte + n = ((bd >> 2) & 0x7) + 1 + i2 = i + n + copy(btmp[8-n:], bs[i:i2]) + //if first bit of bs[i] is set, then fill btmp[0..8-n] with 0xff (ie sign extend it) + if bs[i]&(1<<7) != 0 { + copy(btmp[0:8-n], bsAll0xff) + //for j,k := byte(0), 8-n; j < k; j++ { btmp[j] = 0xff } + } + i = i2 + tsec = int64(bigen.Uint64(btmp[:])) + } + if bd&(1<<6) != 0 { + var btmp [4]byte + n = (bd & 0x3) + 1 + i2 = i + n + copy(btmp[4-n:], bs[i:i2]) + i = i2 + tnsec = bigen.Uint32(btmp[:]) + } + if bd&(1<<5) == 0 { + tt = time.Unix(tsec, int64(tnsec)).UTC() + return + } + // In stdlib time.Parse, when a date is parsed without a zone name, it uses "" as zone name. + // However, we need name here, so it can be shown when time is printed. + // Zone name is in form: UTC-08:00. + // Note that Go Libs do not give access to dst flag, so we ignore dst bits + + i2 = i + 2 + tz = bigen.Uint16(bs[i:i2]) + i = i2 + // sign extend sign bit into top 2 MSB (which were dst bits): + if tz&(1<<13) == 0 { // positive + tz = tz & 0x3fff //clear 2 MSBs: dst bits + } else { // negative + tz = tz | 0xc000 //set 2 MSBs: dst bits + //tzname[3] = '-' (TODO: verify. this works here) + } + tzint := int16(tz) + if tzint == 0 { + tt = time.Unix(tsec, int64(tnsec)).UTC() + } else { + // For Go Time, do not use a descriptive timezone. + // It's unnecessary, and makes it harder to do a reflect.DeepEqual. + // The Offset already tells what the offset should be, if not on UTC and unknown zone name. + // var zoneName = timeLocUTCName(tzint) + tt = time.Unix(tsec, int64(tnsec)).In(time.FixedZone("", int(tzint)*60)) + } + return +} + +func timeLocUTCName(tzint int16) string { + if tzint == 0 { + return "UTC" + } + var tzname = []byte("UTC+00:00") + //tzname := fmt.Sprintf("UTC%s%02d:%02d", tzsign, tz/60, tz%60) //perf issue using Sprintf. inline below. + //tzhr, tzmin := tz/60, tz%60 //faster if u convert to int first + var tzhr, tzmin int16 + if tzint < 0 { + tzname[3] = '-' // (TODO: verify. this works here) + tzhr, tzmin = -tzint/60, (-tzint)%60 + } else { + tzhr, tzmin = tzint/60, tzint%60 + } + tzname[4] = timeDigits[tzhr/10] + tzname[5] = timeDigits[tzhr%10] + tzname[7] = timeDigits[tzmin/10] + tzname[8] = timeDigits[tzmin%10] + return string(tzname) + //return time.FixedZone(string(tzname), int(tzint)*60) +} diff --git a/vendor/src/github.com/hashicorp/memberlist/.gitignore b/vendor/src/github.com/hashicorp/memberlist/.gitignore new file mode 100644 index 0000000000..9158f171a5 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/.gitignore @@ -0,0 +1,25 @@ +# Compiled Object files, Static and Dynamic libs (Shared Objects) +*.o +*.a +*.so + +# Folders +_obj +_test + +# Architecture specific extensions/prefixes +*.[568vq] +[568vq].out + +*.cgo1.go +*.cgo2.c +_cgo_defun.c +_cgo_gotypes.go +_cgo_export.* + +_testmain.go + +*.exe +*.test +.vagrant/ + diff --git a/vendor/src/github.com/hashicorp/memberlist/LICENSE b/vendor/src/github.com/hashicorp/memberlist/LICENSE new file mode 100644 index 0000000000..c33dcc7c92 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/LICENSE @@ -0,0 +1,354 @@ +Mozilla Public License, version 2.0 + +1. Definitions + +1.1. “Contributor” + + means each individual or legal entity that creates, contributes to the + creation of, or owns Covered Software. + +1.2. “Contributor Version” + + means the combination of the Contributions of others (if any) used by a + Contributor and that particular Contributor’s Contribution. + +1.3. “Contribution” + + means Covered Software of a particular Contributor. + +1.4. “Covered Software” + + means Source Code Form to which the initial Contributor has attached the + notice in Exhibit A, the Executable Form of such Source Code Form, and + Modifications of such Source Code Form, in each case including portions + thereof. + +1.5. “Incompatible With Secondary Licenses” + means + + a. that the initial Contributor has attached the notice described in + Exhibit B to the Covered Software; or + + b. that the Covered Software was made available under the terms of version + 1.1 or earlier of the License, but not also under the terms of a + Secondary License. + +1.6. “Executable Form” + + means any form of the work other than Source Code Form. + +1.7. “Larger Work” + + means a work that combines Covered Software with other material, in a separate + file or files, that is not Covered Software. + +1.8. “License” + + means this document. + +1.9. “Licensable” + + means having the right to grant, to the maximum extent possible, whether at the + time of the initial grant or subsequently, any and all of the rights conveyed by + this License. + +1.10. “Modifications” + + means any of the following: + + a. any file in Source Code Form that results from an addition to, deletion + from, or modification of the contents of Covered Software; or + + b. any new file in Source Code Form that contains any Covered Software. + +1.11. “Patent Claims” of a Contributor + + means any patent claim(s), including without limitation, method, process, + and apparatus claims, in any patent Licensable by such Contributor that + would be infringed, but for the grant of the License, by the making, + using, selling, offering for sale, having made, import, or transfer of + either its Contributions or its Contributor Version. + +1.12. “Secondary License” + + means either the GNU General Public License, Version 2.0, the GNU Lesser + General Public License, Version 2.1, the GNU Affero General Public + License, Version 3.0, or any later versions of those licenses. + +1.13. “Source Code Form” + + means the form of the work preferred for making modifications. + +1.14. “You” (or “Your”) + + means an individual or a legal entity exercising rights under this + License. For legal entities, “You” includes any entity that controls, is + controlled by, or is under common control with You. For purposes of this + definition, “control” means (a) the power, direct or indirect, to cause + the direction or management of such entity, whether by contract or + otherwise, or (b) ownership of more than fifty percent (50%) of the + outstanding shares or beneficial ownership of such entity. + + +2. License Grants and Conditions + +2.1. Grants + + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + + a. under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or as + part of a Larger Work; and + + b. under Patent Claims of such Contributor to make, use, sell, offer for + sale, have made, import, and otherwise transfer either its Contributions + or its Contributor Version. + +2.2. Effective Date + + The licenses granted in Section 2.1 with respect to any Contribution become + effective for each Contribution on the date the Contributor first distributes + such Contribution. + +2.3. Limitations on Grant Scope + + The licenses granted in this Section 2 are the only rights granted under this + License. No additional rights or licenses will be implied from the distribution + or licensing of Covered Software under this License. Notwithstanding Section + 2.1(b) above, no patent license is granted by a Contributor: + + a. for any code that a Contributor has removed from Covered Software; or + + b. for infringements caused by: (i) Your and any other third party’s + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + + c. under Patent Claims infringed by Covered Software in the absence of its + Contributions. + + This License does not grant any rights in the trademarks, service marks, or + logos of any Contributor (except as may be necessary to comply with the + notice requirements in Section 3.4). + +2.4. Subsequent Licenses + + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this License + (see Section 10.2) or under the terms of a Secondary License (if permitted + under the terms of Section 3.3). + +2.5. Representation + + Each Contributor represents that the Contributor believes its Contributions + are its original creation(s) or it has sufficient rights to grant the + rights to its Contributions conveyed by this License. + +2.6. Fair Use + + This License is not intended to limit any rights You have under applicable + copyright doctrines of fair use, fair dealing, or other equivalents. + +2.7. Conditions + + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in + Section 2.1. + + +3. Responsibilities + +3.1. Distribution of Source Form + + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under the + terms of this License. You must inform recipients that the Source Code Form + of the Covered Software is governed by the terms of this License, and how + they can obtain a copy of this License. You may not attempt to alter or + restrict the recipients’ rights in the Source Code Form. + +3.2. Distribution of Executable Form + + If You distribute Covered Software in Executable Form then: + + a. such Covered Software must also be made available in Source Code Form, + as described in Section 3.1, and You must inform recipients of the + Executable Form how they can obtain a copy of such Source Code Form by + reasonable means in a timely manner, at a charge no more than the cost + of distribution to the recipient; and + + b. You may distribute such Executable Form under the terms of this License, + or sublicense it under different terms, provided that the license for + the Executable Form does not attempt to limit or alter the recipients’ + rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for the + Covered Software. If the Larger Work is a combination of Covered Software + with a work governed by one or more Secondary Licenses, and the Covered + Software is not Incompatible With Secondary Licenses, this License permits + You to additionally distribute such Covered Software under the terms of + such Secondary License(s), so that the recipient of the Larger Work may, at + their option, further distribute the Covered Software under the terms of + either this License or such Secondary License(s). + +3.4. Notices + + You may not remove or alter the substance of any license notices (including + copyright notices, patent notices, disclaimers of warranty, or limitations + of liability) contained within the Source Code Form of the Covered + Software, except that You may alter any license notices to the extent + required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on behalf + of any Contributor. You must make it absolutely clear that any such + warranty, support, indemnity, or liability obligation is offered by You + alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + +4. Inability to Comply Due to Statute or Regulation + + If it is impossible for You to comply with any of the terms of this License + with respect to some or all of the Covered Software due to statute, judicial + order, or regulation then You must: (a) comply with the terms of this License + to the maximum extent possible; and (b) describe the limitations and the code + they affect. Such description must be placed in a text file included with all + distributions of the Covered Software under this License. Except to the + extent prohibited by statute or regulation, such description must be + sufficiently detailed for a recipient of ordinary skill to be able to + understand it. + +5. Termination + +5.1. The rights granted under this License will terminate automatically if You + fail to comply with any of its terms. However, if You become compliant, + then the rights granted under this License from a particular Contributor + are reinstated (a) provisionally, unless and until such Contributor + explicitly and finally terminates Your grants, and (b) on an ongoing basis, + if such Contributor fails to notify You of the non-compliance by some + reasonable means prior to 60 days after You have come back into compliance. + Moreover, Your grants from a particular Contributor are reinstated on an + ongoing basis if such Contributor notifies You of the non-compliance by + some reasonable means, this is the first time You have received notice of + non-compliance with this License from such Contributor, and You become + compliant prior to 30 days after Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, counter-claims, + and cross-claims) alleging that a Contributor Version directly or + indirectly infringes any patent, then the rights granted to You by any and + all Contributors for the Covered Software under Section 2.1 of this License + shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user + license agreements (excluding distributors and resellers) which have been + validly granted by You or Your distributors under this License prior to + termination shall survive termination. + +6. Disclaimer of Warranty + + Covered Software is provided under this License on an “as is” basis, without + warranty of any kind, either expressed, implied, or statutory, including, + without limitation, warranties that the Covered Software is free of defects, + merchantable, fit for a particular purpose or non-infringing. The entire + risk as to the quality and performance of the Covered Software is with You. + Should any Covered Software prove defective in any respect, You (not any + Contributor) assume the cost of any necessary servicing, repair, or + correction. This disclaimer of warranty constitutes an essential part of this + License. No use of any Covered Software is authorized under this License + except under this disclaimer. + +7. Limitation of Liability + + Under no circumstances and under no legal theory, whether tort (including + negligence), contract, or otherwise, shall any Contributor, or anyone who + distributes Covered Software as permitted above, be liable to You for any + direct, indirect, special, incidental, or consequential damages of any + character including, without limitation, damages for lost profits, loss of + goodwill, work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses, even if such party shall have been + informed of the possibility of such damages. This limitation of liability + shall not apply to liability for death or personal injury resulting from such + party’s negligence to the extent applicable law prohibits such limitation. + Some jurisdictions do not allow the exclusion or limitation of incidental or + consequential damages, so this exclusion and limitation may not apply to You. + +8. Litigation + + Any litigation relating to this License may be brought only in the courts of + a jurisdiction where the defendant maintains its principal place of business + and such litigation shall be governed by laws of that jurisdiction, without + reference to its conflict-of-law provisions. Nothing in this Section shall + prevent a party’s ability to bring cross-claims or counter-claims. + +9. Miscellaneous + + This License represents the complete agreement concerning the subject matter + hereof. If any provision of this License is held to be unenforceable, such + provision shall be reformed only to the extent necessary to make it + enforceable. Any law or regulation which provides that the language of a + contract shall be construed against the drafter shall not be used to construe + this License against a Contributor. + + +10. Versions of the License + +10.1. New Versions + + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + +10.2. Effect of New Versions + + You may distribute the Covered Software under the terms of the version of + the License under which You originally received the Covered Software, or + under the terms of any subsequent version published by the license + steward. + +10.3. Modified Versions + + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a modified + version of this License if you rename the license and remove any + references to the name of the license steward (except to note that such + modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses + If You choose to distribute Source Code Form that is Incompatible With + Secondary Licenses under the terms of this version of the License, the + notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice + + This Source Code Form is subject to the + terms of the Mozilla Public License, v. + 2.0. If a copy of the MPL was not + distributed with this file, You can + obtain one at + http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular file, then +You may include the notice in a location (such as a LICENSE file in a relevant +directory) where a recipient would be likely to look for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - “Incompatible With Secondary Licenses” Notice + + This Source Code Form is “Incompatible + With Secondary Licenses”, as defined by + the Mozilla Public License, v. 2.0. + diff --git a/vendor/src/github.com/hashicorp/memberlist/Makefile b/vendor/src/github.com/hashicorp/memberlist/Makefile new file mode 100644 index 0000000000..56ef6c28c6 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/Makefile @@ -0,0 +1,14 @@ +test: subnet + go test ./... + +integ: subnet + INTEG_TESTS=yes go test ./... + +subnet: + ./test/setup_subnet.sh + +cov: + gocov test github.com/hashicorp/memberlist | gocov-html > /tmp/coverage.html + open /tmp/coverage.html + +.PNONY: test cov integ diff --git a/vendor/src/github.com/hashicorp/memberlist/README.md b/vendor/src/github.com/hashicorp/memberlist/README.md new file mode 100644 index 0000000000..d55befac6e --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/README.md @@ -0,0 +1,137 @@ +# memberlist + +memberlist is a [Go](http://www.golang.org) library that manages cluster +membership and member failure detection using a gossip based protocol. + +The use cases for such a library are far-reaching: all distributed systems +require membership, and memberlist is a re-usable solution to managing +cluster membership and node failure detection. + +memberlist is eventually consistent but converges quickly on average. +The speed at which it converges can be heavily tuned via various knobs +on the protocol. Node failures are detected and network partitions are partially +tolerated by attempting to communicate to potentially dead nodes through +multiple routes. + +## Building + +If you wish to build memberlist you'll need Go version 1.2+ installed. + +Please check your installation with: + +``` +go version +``` + +## Usage + +Memberlist is surprisingly simple to use. An example is shown below: + +```go +/* Create the initial memberlist from a safe configuration. + Please reference the godoc for other default config types. + http://godoc.org/github.com/hashicorp/memberlist#Config +*/ +list, err := memberlist.Create(memberlist.DefaultLocalConfig()) +if err != nil { + panic("Failed to create memberlist: " + err.Error()) +} + +// Join an existing cluster by specifying at least one known member. +n, err := list.Join([]string{"1.2.3.4"}) +if err != nil { + panic("Failed to join cluster: " + err.Error()) +} + +// Ask for members of the cluster +for _, member := range list.Members() { + fmt.Printf("Member: %s %s\n", member.Name, member.Addr) +} + +// Continue doing whatever you need, memberlist will maintain membership +// information in the background. Delegates can be used for receiving +// events when members join or leave. +``` + +The most difficult part of memberlist is configuring it since it has many +available knobs in order to tune state propagation delay and convergence times. +Memberlist provides a default configuration that offers a good starting point, +but errs on the side of caution, choosing values that are optimized for +higher convergence at the cost of higher bandwidth usage. + +For complete documentation, see the associated [Godoc](http://godoc.org/github.com/hashicorp/memberlist). + +## Protocol + +memberlist is based on ["SWIM: Scalable Weakly-consistent Infection-style Process Group Membership Protocol"](http://www.cs.cornell.edu/~asdas/research/dsn02-swim.pdf), +with a few minor adaptations, mostly to increase propogation speed and +convergence rate. + +A high level overview of the memberlist protocol (based on SWIM) is +described below, but for details please read the full +[SWIM paper](http://www.cs.cornell.edu/~asdas/research/dsn02-swim.pdf) +followed by the memberlist source. We welcome any questions related +to the protocol on our issue tracker. + +### Protocol Description + +memberlist begins by joining an existing cluster or starting a new +cluster. If starting a new cluster, additional nodes are expected to join +it. New nodes in an existing cluster must be given the address of at +least one existing member in order to join the cluster. The new member +does a full state sync with the existing member over TCP and begins gossiping its +existence to the cluster. + +Gossip is done over UDP to a with a configurable but fixed fanout and interval. +This ensures that network usage is constant with regards to number of nodes, as opposed to +exponential growth that can occur with traditional heartbeat mechanisms. +Complete state exchanges with a random node are done periodically over +TCP, but much less often than gossip messages. This increases the likelihood +that the membership list converges properly since the full state is exchanged +and merged. The interval between full state exchanges is configurable or can +be disabled entirely. + +Failure detection is done by periodic random probing using a configurable interval. +If the node fails to ack within a reasonable time (typically some multiple +of RTT), then an indirect probe is attempted. An indirect probe asks a +configurable number of random nodes to probe the same node, in case there +are network issues causing our own node to fail the probe. If both our +probe and the indirect probes fail within a reasonable time, then the +node is marked "suspicious" and this knowledge is gossiped to the cluster. +A suspicious node is still considered a member of cluster. If the suspect member +of the cluster does not disputes the suspicion within a configurable period of +time, the node is finally considered dead, and this state is then gossiped +to the cluster. + +This is a brief and incomplete description of the protocol. For a better idea, +please read the +[SWIM paper](http://www.cs.cornell.edu/~asdas/research/dsn02-swim.pdf) +in its entirety, along with the memberlist source code. + +### Changes from SWIM + +As mentioned earlier, the memberlist protocol is based on SWIM but includes +minor changes, mostly to increase propogation speed and convergence rates. + +The changes from SWIM are noted here: + +* memberlist does a full state sync over TCP periodically. SWIM only propagates + changes over gossip. While both eventually reach convergence, the full state + sync increases the likelihood that nodes are fully converged more quickly, + at the expense of more bandwidth usage. This feature can be totally disabled + if you wish. + +* memberlist has a dedicated gossip layer separate from the failure detection + protocol. SWIM only piggybacks gossip messages on top of probe/ack messages. + memberlist also piggybacks gossip messages on top of probe/ack messages, but + also will periodically send out dedicated gossip messages on their own. This + feature lets you have a higher gossip rate (for example once per 200ms) + and a slower failure detection rate (such as once per second), resulting + in overall faster convergence rates and data propogation speeds. This feature + can be totally disabed as well, if you wish. + +* memberlist stores around the state of dead nodes for a set amount of time, + so that when full syncs are requested, the requester also receives information + about dead nodes. Because SWIM doesn't do full syncs, SWIM deletes dead node + state immediately upon learning that the node is dead. This change again helps + the cluster converge more quickly. diff --git a/vendor/src/github.com/hashicorp/memberlist/broadcast.go b/vendor/src/github.com/hashicorp/memberlist/broadcast.go new file mode 100644 index 0000000000..f7e85a119c --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/broadcast.go @@ -0,0 +1,100 @@ +package memberlist + +/* +The broadcast mechanism works by maintaining a sorted list of messages to be +sent out. When a message is to be broadcast, the retransmit count +is set to zero and appended to the queue. The retransmit count serves +as the "priority", ensuring that newer messages get sent first. Once +a message hits the retransmit limit, it is removed from the queue. + +Additionally, older entries can be invalidated by new messages that +are contradictory. For example, if we send "{suspect M1 inc: 1}, +then a following {alive M1 inc: 2} will invalidate that message +*/ + +type memberlistBroadcast struct { + node string + msg []byte + notify chan struct{} +} + +func (b *memberlistBroadcast) Invalidates(other Broadcast) bool { + // Check if that broadcast is a memberlist type + mb, ok := other.(*memberlistBroadcast) + if !ok { + return false + } + + // Invalidates any message about the same node + return b.node == mb.node +} + +func (b *memberlistBroadcast) Message() []byte { + return b.msg +} + +func (b *memberlistBroadcast) Finished() { + select { + case b.notify <- struct{}{}: + default: + } +} + +// encodeAndBroadcast encodes a message and enqueues it for broadcast. Fails +// silently if there is an encoding error. +func (m *Memberlist) encodeAndBroadcast(node string, msgType messageType, msg interface{}) { + m.encodeBroadcastNotify(node, msgType, msg, nil) +} + +// encodeBroadcastNotify encodes a message and enqueues it for broadcast +// and notifies the given channel when transmission is finished. Fails +// silently if there is an encoding error. +func (m *Memberlist) encodeBroadcastNotify(node string, msgType messageType, msg interface{}, notify chan struct{}) { + buf, err := encode(msgType, msg) + if err != nil { + m.logger.Printf("[ERR] memberlist: Failed to encode message for broadcast: %s", err) + } else { + m.queueBroadcast(node, buf.Bytes(), notify) + } +} + +// queueBroadcast is used to start dissemination of a message. It will be +// sent up to a configured number of times. The message could potentially +// be invalidated by a future message about the same node +func (m *Memberlist) queueBroadcast(node string, msg []byte, notify chan struct{}) { + b := &memberlistBroadcast{node, msg, notify} + m.broadcasts.QueueBroadcast(b) +} + +// getBroadcasts is used to return a slice of broadcasts to send up to +// a maximum byte size, while imposing a per-broadcast overhead. This is used +// to fill a UDP packet with piggybacked data +func (m *Memberlist) getBroadcasts(overhead, limit int) [][]byte { + // Get memberlist messages first + toSend := m.broadcasts.GetBroadcasts(overhead, limit) + + // Check if the user has anything to broadcast + d := m.config.Delegate + if d != nil { + // Determine the bytes used already + bytesUsed := 0 + for _, msg := range toSend { + bytesUsed += len(msg) + overhead + } + + // Check space remaining for user messages + avail := limit - bytesUsed + if avail > overhead+userMsgOverhead { + userMsgs := d.GetBroadcasts(overhead+userMsgOverhead, avail) + + // Frame each user message + for _, msg := range userMsgs { + buf := make([]byte, 1, len(msg)+1) + buf[0] = byte(userMsg) + buf = append(buf, msg...) + toSend = append(toSend, buf) + } + } + } + return toSend +} diff --git a/vendor/src/github.com/hashicorp/memberlist/config.go b/vendor/src/github.com/hashicorp/memberlist/config.go new file mode 100644 index 0000000000..bd15047273 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/config.go @@ -0,0 +1,209 @@ +package memberlist + +import ( + "io" + "os" + "time" +) + +type Config struct { + // The name of this node. This must be unique in the cluster. + Name string + + // Configuration related to what address to bind to and ports to + // listen on. The port is used for both UDP and TCP gossip. + // It is assumed other nodes are running on this port, but they + // do not need to. + BindAddr string + BindPort int + + // Configuration related to what address to advertise to other + // cluster members. Used for nat traversal. + AdvertiseAddr string + AdvertisePort int + + // ProtocolVersion is the configured protocol version that we + // will _speak_. This must be between ProtocolVersionMin and + // ProtocolVersionMax. + ProtocolVersion uint8 + + // TCPTimeout is the timeout for establishing a TCP connection with + // a remote node for a full state sync. + TCPTimeout time.Duration + + // IndirectChecks is the number of nodes that will be asked to perform + // an indirect probe of a node in the case a direct probe fails. Memberlist + // waits for an ack from any single indirect node, so increasing this + // number will increase the likelihood that an indirect probe will succeed + // at the expense of bandwidth. + IndirectChecks int + + // RetransmitMult is the multiplier for the number of retransmissions + // that are attempted for messages broadcasted over gossip. The actual + // count of retransmissions is calculated using the formula: + // + // Retransmits = RetransmitMult * log(N+1) + // + // This allows the retransmits to scale properly with cluster size. The + // higher the multiplier, the more likely a failed broadcast is to converge + // at the expense of increased bandwidth. + RetransmitMult int + + // SuspicionMult is the multiplier for determining the time an + // inaccessible node is considered suspect before declaring it dead. + // The actual timeout is calculated using the formula: + // + // SuspicionTimeout = SuspicionMult * log(N+1) * ProbeInterval + // + // This allows the timeout to scale properly with expected propagation + // delay with a larger cluster size. The higher the multiplier, the longer + // an inaccessible node is considered part of the cluster before declaring + // it dead, giving that suspect node more time to refute if it is indeed + // still alive. + SuspicionMult int + + // PushPullInterval is the interval between complete state syncs. + // Complete state syncs are done with a single node over TCP and are + // quite expensive relative to standard gossiped messages. Setting this + // to zero will disable state push/pull syncs completely. + // + // Setting this interval lower (more frequent) will increase convergence + // speeds across larger clusters at the expense of increased bandwidth + // usage. + PushPullInterval time.Duration + + // ProbeInterval and ProbeTimeout are used to configure probing + // behavior for memberlist. + // + // ProbeInterval is the interval between random node probes. Setting + // this lower (more frequent) will cause the memberlist cluster to detect + // failed nodes more quickly at the expense of increased bandwidth usage. + // + // ProbeTimeout is the timeout to wait for an ack from a probed node + // before assuming it is unhealthy. This should be set to 99-percentile + // of RTT (round-trip time) on your network. + ProbeInterval time.Duration + ProbeTimeout time.Duration + + // GossipInterval and GossipNodes are used to configure the gossip + // behavior of memberlist. + // + // GossipInterval is the interval between sending messages that need + // to be gossiped that haven't been able to piggyback on probing messages. + // If this is set to zero, non-piggyback gossip is disabled. By lowering + // this value (more frequent) gossip messages are propagated across + // the cluster more quickly at the expense of increased bandwidth. + // + // GossipNodes is the number of random nodes to send gossip messages to + // per GossipInterval. Increasing this number causes the gossip messages + // to propagate across the cluster more quickly at the expense of + // increased bandwidth. + GossipInterval time.Duration + GossipNodes int + + // EnableCompression is used to control message compression. This can + // be used to reduce bandwidth usage at the cost of slightly more CPU + // utilization. This is only available starting at protocol version 1. + EnableCompression bool + + // SecretKey is used to initialize the primary encryption key in a keyring. + // The primary encryption key is the only key used to encrypt messages and + // the first key used while attempting to decrypt messages. Providing a + // value for this primary key will enable message-level encryption and + // verification, and automatically install the key onto the keyring. + SecretKey []byte + + // The keyring holds all of the encryption keys used internally. It is + // automatically initialized using the SecretKey and SecretKeys values. + Keyring *Keyring + + // Delegate and Events are delegates for receiving and providing + // data to memberlist via callback mechanisms. For Delegate, see + // the Delegate interface. For Events, see the EventDelegate interface. + // + // The DelegateProtocolMin/Max are used to guarantee protocol-compatibility + // for any custom messages that the delegate might do (broadcasts, + // local/remote state, etc.). If you don't set these, then the protocol + // versions will just be zero, and version compliance won't be done. + Delegate Delegate + DelegateProtocolVersion uint8 + DelegateProtocolMin uint8 + DelegateProtocolMax uint8 + Events EventDelegate + Conflict ConflictDelegate + Merge MergeDelegate + + // LogOutput is the writer where logs should be sent. If this is not + // set, logging will go to stderr by default. + LogOutput io.Writer +} + +// DefaultLANConfig returns a sane set of configurations for Memberlist. +// It uses the hostname as the node name, and otherwise sets very conservative +// values that are sane for most LAN environments. The default configuration +// errs on the side on the side of caution, choosing values that are optimized +// for higher convergence at the cost of higher bandwidth usage. Regardless, +// these values are a good starting point when getting started with memberlist. +func DefaultLANConfig() *Config { + hostname, _ := os.Hostname() + return &Config{ + Name: hostname, + BindAddr: "0.0.0.0", + BindPort: 7946, + AdvertiseAddr: "", + AdvertisePort: 7946, + ProtocolVersion: ProtocolVersionMax, + TCPTimeout: 10 * time.Second, // Timeout after 10 seconds + IndirectChecks: 3, // Use 3 nodes for the indirect ping + RetransmitMult: 4, // Retransmit a message 4 * log(N+1) nodes + SuspicionMult: 5, // Suspect a node for 5 * log(N+1) * Interval + PushPullInterval: 30 * time.Second, // Low frequency + ProbeTimeout: 500 * time.Millisecond, // Reasonable RTT time for LAN + ProbeInterval: 1 * time.Second, // Failure check every second + + GossipNodes: 3, // Gossip to 3 nodes + GossipInterval: 200 * time.Millisecond, // Gossip more rapidly + + EnableCompression: true, // Enable compression by default + + SecretKey: nil, + + Keyring: nil, + } +} + +// DefaultWANConfig works like DefaultConfig, however it returns a configuration +// that is optimized for most WAN environments. The default configuration is +// still very conservative and errs on the side of caution. +func DefaultWANConfig() *Config { + conf := DefaultLANConfig() + conf.TCPTimeout = 30 * time.Second + conf.SuspicionMult = 6 + conf.PushPullInterval = 60 * time.Second + conf.ProbeTimeout = 3 * time.Second + conf.ProbeInterval = 5 * time.Second + conf.GossipNodes = 4 // Gossip less frequently, but to an additional node + conf.GossipInterval = 500 * time.Millisecond + return conf +} + +// DefaultLocalConfig works like DefaultConfig, however it returns a configuration +// that is optimized for a local loopback environments. The default configuration is +// still very conservative and errs on the side of caution. +func DefaultLocalConfig() *Config { + conf := DefaultLANConfig() + conf.TCPTimeout = time.Second + conf.IndirectChecks = 1 + conf.RetransmitMult = 2 + conf.SuspicionMult = 3 + conf.PushPullInterval = 15 * time.Second + conf.ProbeTimeout = 200 * time.Millisecond + conf.ProbeInterval = time.Second + conf.GossipInterval = 100 * time.Millisecond + return conf +} + +// Returns whether or not encryption is enabled +func (c *Config) EncryptionEnabled() bool { + return c.Keyring != nil && len(c.Keyring.GetKeys()) > 0 +} diff --git a/vendor/src/github.com/hashicorp/memberlist/conflict_delegate.go b/vendor/src/github.com/hashicorp/memberlist/conflict_delegate.go new file mode 100644 index 0000000000..f52b136eba --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/conflict_delegate.go @@ -0,0 +1,10 @@ +package memberlist + +// ConflictDelegate is a used to inform a client that +// a node has attempted to join which would result in a +// name conflict. This happens if two clients are configured +// with the same name but different addresses. +type ConflictDelegate interface { + // NotifyConflict is invoked when a name conflict is detected + NotifyConflict(existing, other *Node) +} diff --git a/vendor/src/github.com/hashicorp/memberlist/delegate.go b/vendor/src/github.com/hashicorp/memberlist/delegate.go new file mode 100644 index 0000000000..b1204a41e8 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/delegate.go @@ -0,0 +1,36 @@ +package memberlist + +// Delegate is the interface that clients must implement if they want to hook +// into the gossip layer of Memberlist. All the methods must be thread-safe, +// as they can and generally will be called concurrently. +type Delegate interface { + // NodeMeta is used to retrieve meta-data about the current node + // when broadcasting an alive message. It's length is limited to + // the given byte size. This metadata is available in the Node structure. + NodeMeta(limit int) []byte + + // NotifyMsg is called when a user-data message is received. + // Care should be taken that this method does not block, since doing + // so would block the entire UDP packet receive loop. Additionally, the byte + // slice may be modified after the call returns, so it should be copied if needed. + NotifyMsg([]byte) + + // GetBroadcasts is called when user data messages can be broadcast. + // It can return a list of buffers to send. Each buffer should assume an + // overhead as provided with a limit on the total byte size allowed. + // The total byte size of the resulting data to send must not exceed + // the limit. + GetBroadcasts(overhead, limit int) [][]byte + + // LocalState is used for a TCP Push/Pull. This is sent to + // the remote side in addition to the membership information. Any + // data can be sent here. See MergeRemoteState as well. The `join` + // boolean indicates this is for a join instead of a push/pull. + LocalState(join bool) []byte + + // MergeRemoteState is invoked after a TCP Push/Pull. This is the + // state received from the remote side and is the result of the + // remote side's LocalState call. The 'join' + // boolean indicates this is for a join instead of a push/pull. + MergeRemoteState(buf []byte, join bool) +} diff --git a/vendor/src/github.com/hashicorp/memberlist/event_delegate.go b/vendor/src/github.com/hashicorp/memberlist/event_delegate.go new file mode 100644 index 0000000000..35e2a56fdd --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/event_delegate.go @@ -0,0 +1,61 @@ +package memberlist + +// EventDelegate is a simpler delegate that is used only to receive +// notifications about members joining and leaving. The methods in this +// delegate may be called by multiple goroutines, but never concurrently. +// This allows you to reason about ordering. +type EventDelegate interface { + // NotifyJoin is invoked when a node is detected to have joined. + // The Node argument must not be modified. + NotifyJoin(*Node) + + // NotifyLeave is invoked when a node is detected to have left. + // The Node argument must not be modified. + NotifyLeave(*Node) + + // NotifyUpdate is invoked when a node is detected to have + // updated, usually involving the meta data. The Node argument + // must not be modified. + NotifyUpdate(*Node) +} + +// ChannelEventDelegate is used to enable an application to receive +// events about joins and leaves over a channel instead of a direct +// function call. +// +// Care must be taken that events are processed in a timely manner from +// the channel, since this delegate will block until an event can be sent. +type ChannelEventDelegate struct { + Ch chan<- NodeEvent +} + +// NodeEventType are the types of events that can be sent from the +// ChannelEventDelegate. +type NodeEventType int + +const ( + NodeJoin NodeEventType = iota + NodeLeave + NodeUpdate +) + +// NodeEvent is a single event related to node activity in the memberlist. +// The Node member of this struct must not be directly modified. It is passed +// as a pointer to avoid unnecessary copies. If you wish to modify the node, +// make a copy first. +type NodeEvent struct { + Event NodeEventType + Node *Node +} + +func (c *ChannelEventDelegate) NotifyJoin(n *Node) { + c.Ch <- NodeEvent{NodeJoin, n} +} + +func (c *ChannelEventDelegate) NotifyLeave(n *Node) { + c.Ch <- NodeEvent{NodeLeave, n} +} + +func (c *ChannelEventDelegate) NotifyUpdate(n *Node) { + c.Ch <- NodeEvent{NodeUpdate, n} +} diff --git a/vendor/src/github.com/hashicorp/memberlist/keyring.go b/vendor/src/github.com/hashicorp/memberlist/keyring.go new file mode 100644 index 0000000000..ebcd2f2002 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/keyring.go @@ -0,0 +1,144 @@ +package memberlist + +import ( + "bytes" + "fmt" + "sync" +) + +type Keyring struct { + // Keys stores the key data used during encryption and decryption. It is + // ordered in such a way where the first key (index 0) is the primary key, + // which is used for encrypting messages, and is the first key tried during + // message decryption. + keys [][]byte + + // The keyring lock is used while performing IO operations on the keyring. + l sync.Mutex +} + +// Init allocates substructures +func (k *Keyring) init() { + k.keys = make([][]byte, 0) +} + +// NewKeyring constructs a new container for a set of encryption keys. The +// keyring contains all key data used internally by memberlist. +// +// While creating a new keyring, you must do one of: +// - Omit keys and primary key, effectively disabling encryption +// - Pass a set of keys plus the primary key +// - Pass only a primary key +// +// If only a primary key is passed, then it will be automatically added to the +// keyring. If creating a keyring with multiple keys, one key must be designated +// primary by passing it as the primaryKey. If the primaryKey does not exist in +// the list of secondary keys, it will be automatically added at position 0. +func NewKeyring(keys [][]byte, primaryKey []byte) (*Keyring, error) { + keyring := &Keyring{} + keyring.init() + + if len(keys) > 0 || len(primaryKey) > 0 { + if len(primaryKey) == 0 { + return nil, fmt.Errorf("Empty primary key not allowed") + } + if err := keyring.AddKey(primaryKey); err != nil { + return nil, err + } + for _, key := range keys { + if err := keyring.AddKey(key); err != nil { + return nil, err + } + } + } + + return keyring, nil +} + +// AddKey will install a new key on the ring. Adding a key to the ring will make +// it available for use in decryption. If the key already exists on the ring, +// this function will just return noop. +func (k *Keyring) AddKey(key []byte) error { + // Encorce 16-byte key size + if len(key) != 16 { + return fmt.Errorf("key size must be 16 bytes") + } + + // No-op if key is already installed + for _, installedKey := range k.keys { + if bytes.Equal(installedKey, key) { + return nil + } + } + + keys := append(k.keys, key) + primaryKey := k.GetPrimaryKey() + if primaryKey == nil { + primaryKey = key + } + k.installKeys(keys, primaryKey) + return nil +} + +// UseKey changes the key used to encrypt messages. This is the only key used to +// encrypt messages, so peers should know this key before this method is called. +func (k *Keyring) UseKey(key []byte) error { + for _, installedKey := range k.keys { + if bytes.Equal(key, installedKey) { + k.installKeys(k.keys, key) + return nil + } + } + return fmt.Errorf("Requested key is not in the keyring") +} + +// RemoveKey drops a key from the keyring. This will return an error if the key +// requested for removal is currently at position 0 (primary key). +func (k *Keyring) RemoveKey(key []byte) error { + if bytes.Equal(key, k.keys[0]) { + return fmt.Errorf("Removing the primary key is not allowed") + } + for i, installedKey := range k.keys { + if bytes.Equal(key, installedKey) { + keys := append(k.keys[:i], k.keys[i+1:]...) + k.installKeys(keys, k.keys[0]) + } + } + return nil +} + +// installKeys will take out a lock on the keyring, and replace the keys with a +// new set of keys. The key indicated by primaryKey will be installed as the new +// primary key. +func (k *Keyring) installKeys(keys [][]byte, primaryKey []byte) { + k.l.Lock() + defer k.l.Unlock() + + newKeys := [][]byte{primaryKey} + for _, key := range keys { + if !bytes.Equal(key, primaryKey) { + newKeys = append(newKeys, key) + } + } + k.keys = newKeys +} + +// GetKeys returns the current set of keys on the ring. +func (k *Keyring) GetKeys() [][]byte { + k.l.Lock() + defer k.l.Unlock() + + return k.keys +} + +// GetPrimaryKey returns the key on the ring at position 0. This is the key used +// for encrypting messages, and is the first key tried for decrypting messages. +func (k *Keyring) GetPrimaryKey() (key []byte) { + k.l.Lock() + defer k.l.Unlock() + + if len(k.keys) > 0 { + key = k.keys[0] + } + return +} diff --git a/vendor/src/github.com/hashicorp/memberlist/memberlist.go b/vendor/src/github.com/hashicorp/memberlist/memberlist.go new file mode 100644 index 0000000000..01807cfe43 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/memberlist.go @@ -0,0 +1,525 @@ +/* +memberlist is a library that manages cluster +membership and member failure detection using a gossip based protocol. + +The use cases for such a library are far-reaching: all distributed systems +require membership, and memberlist is a re-usable solution to managing +cluster membership and node failure detection. + +memberlist is eventually consistent but converges quickly on average. +The speed at which it converges can be heavily tuned via various knobs +on the protocol. Node failures are detected and network partitions are partially +tolerated by attempting to communicate to potentially dead nodes through +multiple routes. +*/ +package memberlist + +import ( + "fmt" + "log" + "net" + "os" + "strconv" + "sync" + "time" +) + +type Memberlist struct { + config *Config + shutdown bool + shutdownCh chan struct{} + leave bool + leaveBroadcast chan struct{} + + udpListener *net.UDPConn + tcpListener *net.TCPListener + handoff chan msgHandoff + + sequenceNum uint32 // Local sequence number + incarnation uint32 // Local incarnation number + + nodeLock sync.RWMutex + nodes []*nodeState // Known nodes + nodeMap map[string]*nodeState // Maps Addr.String() -> NodeState + + tickerLock sync.Mutex + tickers []*time.Ticker + stopTick chan struct{} + probeIndex int + + ackLock sync.Mutex + ackHandlers map[uint32]*ackHandler + + broadcasts *TransmitLimitedQueue + + startStopLock sync.Mutex + + logger *log.Logger +} + +// newMemberlist creates the network listeners. +// Does not schedule execution of background maintenence. +func newMemberlist(conf *Config) (*Memberlist, error) { + if conf.ProtocolVersion < ProtocolVersionMin { + return nil, fmt.Errorf("Protocol version '%d' too low. Must be in range: [%d, %d]", + conf.ProtocolVersion, ProtocolVersionMin, ProtocolVersionMax) + } else if conf.ProtocolVersion > ProtocolVersionMax { + return nil, fmt.Errorf("Protocol version '%d' too high. Must be in range: [%d, %d]", + conf.ProtocolVersion, ProtocolVersionMin, ProtocolVersionMax) + } + + if len(conf.SecretKey) > 0 { + if conf.Keyring == nil { + keyring, err := NewKeyring(nil, conf.SecretKey) + if err != nil { + return nil, err + } + conf.Keyring = keyring + } else { + if err := conf.Keyring.AddKey(conf.SecretKey); err != nil { + return nil, err + } + if err := conf.Keyring.UseKey(conf.SecretKey); err != nil { + return nil, err + } + } + } + + tcpAddr := &net.TCPAddr{IP: net.ParseIP(conf.BindAddr), Port: conf.BindPort} + tcpLn, err := net.ListenTCP("tcp", tcpAddr) + if err != nil { + return nil, fmt.Errorf("Failed to start TCP listener. Err: %s", err) + } + + udpAddr := &net.UDPAddr{IP: net.ParseIP(conf.BindAddr), Port: conf.BindPort} + udpLn, err := net.ListenUDP("udp", udpAddr) + if err != nil { + tcpLn.Close() + return nil, fmt.Errorf("Failed to start UDP listener. Err: %s", err) + } + + // Set the UDP receive window size + setUDPRecvBuf(udpLn) + + if conf.LogOutput == nil { + conf.LogOutput = os.Stderr + } + logger := log.New(conf.LogOutput, "", log.LstdFlags) + + m := &Memberlist{ + config: conf, + shutdownCh: make(chan struct{}), + leaveBroadcast: make(chan struct{}, 1), + udpListener: udpLn, + tcpListener: tcpLn, + handoff: make(chan msgHandoff, 1024), + nodeMap: make(map[string]*nodeState), + ackHandlers: make(map[uint32]*ackHandler), + broadcasts: &TransmitLimitedQueue{RetransmitMult: conf.RetransmitMult}, + logger: logger, + } + m.broadcasts.NumNodes = func() int { return len(m.nodes) } + go m.tcpListen() + go m.udpListen() + go m.udpHandler() + return m, nil +} + +// Create will create a new Memberlist using the given configuration. +// This will not connect to any other node (see Join) yet, but will start +// all the listeners to allow other nodes to join this memberlist. +// After creating a Memberlist, the configuration given should not be +// modified by the user anymore. +func Create(conf *Config) (*Memberlist, error) { + m, err := newMemberlist(conf) + if err != nil { + return nil, err + } + if err := m.setAlive(); err != nil { + m.Shutdown() + return nil, err + } + m.schedule() + return m, nil +} + +// Join is used to take an existing Memberlist and attempt to join a cluster +// by contacting all the given hosts and performing a state sync. Initially, +// the Memberlist only contains our own state, so doing this will cause +// remote nodes to become aware of the existence of this node, effectively +// joining the cluster. +// +// This returns the number of hosts successfully contacted and an error if +// none could be reached. If an error is returned, the node did not successfully +// join the cluster. +func (m *Memberlist) Join(existing []string) (int, error) { + // Attempt to join any of them + numSuccess := 0 + var retErr error + for _, exist := range existing { + addrs, port, err := m.resolveAddr(exist) + if err != nil { + m.logger.Printf("[WARN] memberlist: Failed to resolve %s: %v", exist, err) + retErr = err + continue + } + + for _, addr := range addrs { + if err := m.pushPullNode(addr, port, true); err != nil { + retErr = err + continue + } + numSuccess++ + } + + } + + if numSuccess > 0 { + retErr = nil + } + + return numSuccess, retErr +} + +// resolveAddr is used to resolve the address into an address, +// port, and error. If no port is given, use the default +func (m *Memberlist) resolveAddr(hostStr string) ([][]byte, uint16, error) { + ips := make([][]byte, 0) + port := uint16(0) + host, sport, err := net.SplitHostPort(hostStr) + if ae, ok := err.(*net.AddrError); ok && ae.Err == "missing port in address" { + // error, port missing - we can solve this + port = uint16(m.config.BindPort) + host = hostStr + } else if err != nil { + // error, but not missing port + return ips, port, err + } else if lport, err := strconv.ParseUint(sport, 10, 16); err != nil { + // error, when parsing port + return ips, port, err + } else { + // no error + port = uint16(lport) + } + + // Get the addresses that hostPort might resolve to + // ResolveTcpAddr requres ipv6 brackets to separate + // port numbers whereas ParseIP doesn't, but luckily + // SplitHostPort takes care of the brackets + if ip := net.ParseIP(host); ip == nil { + if pre, err := net.LookupIP(host); err == nil { + for _, ip := range pre { + ips = append(ips, ip) + } + } else { + return ips, port, err + } + } else { + ips = append(ips, ip) + } + + return ips, port, nil +} + +// setAlive is used to mark this node as being alive. This is the same +// as if we received an alive notification our own network channel for +// ourself. +func (m *Memberlist) setAlive() error { + + var advertiseAddr []byte + var advertisePort int + if m.config.AdvertiseAddr != "" { + // If AdvertiseAddr is not empty, then advertise + // the given address and port. + ip := net.ParseIP(m.config.AdvertiseAddr) + if ip == nil { + return fmt.Errorf("Failed to parse advertise address!") + } + + // Ensure IPv4 conversion if necessary + if ip4 := ip.To4(); ip4 != nil { + ip = ip4 + } + + advertiseAddr = ip + advertisePort = m.config.AdvertisePort + } else { + if m.config.BindAddr == "0.0.0.0" { + // Otherwise, if we're not bound to a specific IP, + //let's list the interfaces on this machine and use + // the first private IP we find. + addresses, err := net.InterfaceAddrs() + if err != nil { + return fmt.Errorf("Failed to get interface addresses! Err: %v", err) + } + + // Find private IPv4 address + for _, rawAddr := range addresses { + var ip net.IP + switch addr := rawAddr.(type) { + case *net.IPAddr: + ip = addr.IP + case *net.IPNet: + ip = addr.IP + default: + continue + } + + if ip.To4() == nil { + continue + } + if !isPrivateIP(ip.String()) { + continue + } + + advertiseAddr = ip + break + } + + // Failed to find private IP, error + if advertiseAddr == nil { + return fmt.Errorf("No private IP address found, and explicit IP not provided") + } + + } else { + // Use the IP that we're bound to. + addr := m.tcpListener.Addr().(*net.TCPAddr) + advertiseAddr = addr.IP + } + advertisePort = m.config.BindPort + } + + // Check if this is a public address without encryption + addrStr := net.IP(advertiseAddr).String() + if !isPrivateIP(addrStr) && !isLoopbackIP(addrStr) && !m.config.EncryptionEnabled() { + m.logger.Printf("[WARN] memberlist: Binding to public address without encryption!") + } + + // Get the node meta data + var meta []byte + if m.config.Delegate != nil { + meta = m.config.Delegate.NodeMeta(MetaMaxSize) + if len(meta) > MetaMaxSize { + panic("Node meta data provided is longer than the limit") + } + } + + a := alive{ + Incarnation: m.nextIncarnation(), + Node: m.config.Name, + Addr: advertiseAddr, + Port: uint16(advertisePort), + Meta: meta, + Vsn: []uint8{ + ProtocolVersionMin, ProtocolVersionMax, m.config.ProtocolVersion, + m.config.DelegateProtocolMin, m.config.DelegateProtocolMax, + m.config.DelegateProtocolVersion, + }, + } + m.aliveNode(&a, nil, true) + + return nil +} + +// LocalNode is used to return the local Node +func (m *Memberlist) LocalNode() *Node { + m.nodeLock.RLock() + defer m.nodeLock.RUnlock() + state := m.nodeMap[m.config.Name] + return &state.Node +} + +// UpdateNode is used to trigger re-advertising the local node. This is +// primarily used with a Delegate to support dynamic updates to the local +// meta data. This will block until the update message is successfully +// broadcasted to a member of the cluster, if any exist or until a specified +// timeout is reached. +func (m *Memberlist) UpdateNode(timeout time.Duration) error { + // Get the node meta data + var meta []byte + if m.config.Delegate != nil { + meta = m.config.Delegate.NodeMeta(MetaMaxSize) + if len(meta) > MetaMaxSize { + panic("Node meta data provided is longer than the limit") + } + } + + // Get the existing node + m.nodeLock.RLock() + state := m.nodeMap[m.config.Name] + m.nodeLock.RUnlock() + + // Format a new alive message + a := alive{ + Incarnation: m.nextIncarnation(), + Node: m.config.Name, + Addr: state.Addr, + Port: state.Port, + Meta: meta, + Vsn: []uint8{ + ProtocolVersionMin, ProtocolVersionMax, m.config.ProtocolVersion, + m.config.DelegateProtocolMin, m.config.DelegateProtocolMax, + m.config.DelegateProtocolVersion, + }, + } + notifyCh := make(chan struct{}) + m.aliveNode(&a, notifyCh, true) + + // Wait for the broadcast or a timeout + if m.anyAlive() { + var timeoutCh <-chan time.Time + if timeout > 0 { + timeoutCh = time.After(timeout) + } + select { + case <-notifyCh: + case <-timeoutCh: + return fmt.Errorf("timeout waiting for update broadcast") + } + } + return nil +} + +// SendTo is used to directly send a message to another node, without +// the use of the gossip mechanism. This will encode the message as a +// user-data message, which a delegate will receive through NotifyMsg +// The actual data is transmitted over UDP, which means this is a +// best-effort transmission mechanism, and the maximum size of the +// message is the size of a single UDP datagram, after compression +func (m *Memberlist) SendTo(to net.Addr, msg []byte) error { + // Encode as a user message + buf := make([]byte, 1, len(msg)+1) + buf[0] = byte(userMsg) + buf = append(buf, msg...) + + // Send the message + return m.rawSendMsg(to, buf) +} + +// Members returns a list of all known live nodes. The node structures +// returned must not be modified. If you wish to modify a Node, make a +// copy first. +func (m *Memberlist) Members() []*Node { + m.nodeLock.RLock() + defer m.nodeLock.RUnlock() + + nodes := make([]*Node, 0, len(m.nodes)) + for _, n := range m.nodes { + if n.State != stateDead { + nodes = append(nodes, &n.Node) + } + } + + return nodes +} + +// NumMembers returns the number of alive nodes currently known. Between +// the time of calling this and calling Members, the number of alive nodes +// may have changed, so this shouldn't be used to determine how many +// members will be returned by Members. +func (m *Memberlist) NumMembers() (alive int) { + m.nodeLock.RLock() + defer m.nodeLock.RUnlock() + + for _, n := range m.nodes { + if n.State != stateDead { + alive++ + } + } + + return +} + +// Leave will broadcast a leave message but will not shutdown the background +// listeners, meaning the node will continue participating in gossip and state +// updates. +// +// This will block until the leave message is successfully broadcasted to +// a member of the cluster, if any exist or until a specified timeout +// is reached. +// +// This method is safe to call multiple times, but must not be called +// after the cluster is already shut down. +func (m *Memberlist) Leave(timeout time.Duration) error { + m.startStopLock.Lock() + defer m.startStopLock.Unlock() + + if m.shutdown { + panic("leave after shutdown") + } + + if !m.leave { + m.leave = true + + state, ok := m.nodeMap[m.config.Name] + if !ok { + m.logger.Printf("[WARN] memberlist: Leave but we're not in the node map.") + return nil + } + + d := dead{ + Incarnation: state.Incarnation, + Node: state.Name, + } + m.deadNode(&d) + + // Block until the broadcast goes out + if m.anyAlive() { + var timeoutCh <-chan time.Time + if timeout > 0 { + timeoutCh = time.After(timeout) + } + select { + case <-m.leaveBroadcast: + case <-timeoutCh: + return fmt.Errorf("timeout waiting for leave broadcast") + } + } + } + + return nil +} + +// Check for any other alive node. +func (m *Memberlist) anyAlive() bool { + m.nodeLock.RLock() + defer m.nodeLock.RUnlock() + for _, n := range m.nodes { + if n.State != stateDead && n.Name != m.config.Name { + return true + } + } + return false +} + +// ProtocolVersion returns the protocol version currently in use by +// this memberlist. +func (m *Memberlist) ProtocolVersion() uint8 { + // NOTE: This method exists so that in the future we can control + // any locking if necessary, if we change the protocol version at + // runtime, etc. + return m.config.ProtocolVersion +} + +// Shutdown will stop any background maintanence of network activity +// for this memberlist, causing it to appear "dead". A leave message +// will not be broadcasted prior, so the cluster being left will have +// to detect this node's shutdown using probing. If you wish to more +// gracefully exit the cluster, call Leave prior to shutting down. +// +// This method is safe to call multiple times. +func (m *Memberlist) Shutdown() error { + m.startStopLock.Lock() + defer m.startStopLock.Unlock() + + if m.shutdown { + return nil + } + + m.shutdown = true + close(m.shutdownCh) + m.deschedule() + m.udpListener.Close() + m.tcpListener.Close() + return nil +} diff --git a/vendor/src/github.com/hashicorp/memberlist/merge_delegate.go b/vendor/src/github.com/hashicorp/memberlist/merge_delegate.go new file mode 100644 index 0000000000..dc27250021 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/merge_delegate.go @@ -0,0 +1,13 @@ +package memberlist + +// MergeDelegate is used to involve a client in +// a potential cluster merge operation. Namely, when +// a node does a TCP push/pull (as part of a join), +// the delegate is involved and allowed to cancel the join +// based on custom logic. The merge delegate is NOT invoked +// as part of the push-pull anti-entropy. +type MergeDelegate interface { + // NotifyMerge is invoked when a merge could take place. + // Provides a list of the nodes known by the peer. + NotifyMerge(peers []*Node) (cancel bool) +} diff --git a/vendor/src/github.com/hashicorp/memberlist/net.go b/vendor/src/github.com/hashicorp/memberlist/net.go new file mode 100644 index 0000000000..4e8319c6e8 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/net.go @@ -0,0 +1,852 @@ +package memberlist + +import ( + "bufio" + "bytes" + "encoding/binary" + "fmt" + "io" + "net" + "time" + + "github.com/armon/go-metrics" + "github.com/hashicorp/go-msgpack/codec" +) + +// This is the minimum and maximum protocol version that we can +// _understand_. We're allowed to speak at any version within this +// range. This range is inclusive. +const ( + ProtocolVersionMin uint8 = 1 + ProtocolVersionMax = 2 +) + +// messageType is an integer ID of a type of message that can be received +// on network channels from other members. +type messageType uint8 + +// The list of available message types. +const ( + pingMsg messageType = iota + indirectPingMsg + ackRespMsg + suspectMsg + aliveMsg + deadMsg + pushPullMsg + compoundMsg + userMsg // User mesg, not handled by us + compressMsg + encryptMsg +) + +// compressionType is used to specify the compression algorithm +type compressionType uint8 + +const ( + lzwAlgo compressionType = iota +) + +const ( + MetaMaxSize = 512 // Maximum size for node meta data + compoundHeaderOverhead = 2 // Assumed header overhead + compoundOverhead = 2 // Assumed overhead per entry in compoundHeader + udpBufSize = 65536 + udpRecvBuf = 2 * 1024 * 1024 + udpSendBuf = 1400 + userMsgOverhead = 1 + blockingWarning = 10 * time.Millisecond // Warn if a UDP packet takes this long to process + maxPushStateBytes = 10 * 1024 * 1024 +) + +// ping request sent directly to node +type ping struct { + SeqNo uint32 + + // Node is sent so the target can verify they are + // the intended recipient. This is to protect again an agent + // restart with a new name. + Node string +} + +// indirect ping sent to an indirect ndoe +type indirectPingReq struct { + SeqNo uint32 + Target []byte + Port uint16 + Node string +} + +// ack response is sent for a ping +type ackResp struct { + SeqNo uint32 +} + +// suspect is broadcast when we suspect a node is dead +type suspect struct { + Incarnation uint32 + Node string + From string // Include who is suspecting +} + +// alive is broadcast when we know a node is alive. +// Overloaded for nodes joining +type alive struct { + Incarnation uint32 + Node string + Addr []byte + Port uint16 + Meta []byte + + // The versions of the protocol/delegate that are being spoken, order: + // pmin, pmax, pcur, dmin, dmax, dcur + Vsn []uint8 +} + +// dead is broadcast when we confirm a node is dead +// Overloaded for nodes leaving +type dead struct { + Incarnation uint32 + Node string + From string // Include who is suspecting +} + +// pushPullHeader is used to inform the +// otherside how many states we are transfering +type pushPullHeader struct { + Nodes int + UserStateLen int // Encodes the byte lengh of user state + Join bool // Is this a join request or a anti-entropy run +} + +// pushNodeState is used for pushPullReq when we are +// transfering out node states +type pushNodeState struct { + Name string + Addr []byte + Port uint16 + Meta []byte + Incarnation uint32 + State nodeStateType + Vsn []uint8 // Protocol versions +} + +// compress is used to wrap an underlying payload +// using a specified compression algorithm +type compress struct { + Algo compressionType + Buf []byte +} + +// msgHandoff is used to transfer a message between goroutines +type msgHandoff struct { + msgType messageType + buf []byte + from net.Addr +} + +// encryptionVersion returns the encryption version to use +func (m *Memberlist) encryptionVersion() encryptionVersion { + switch m.ProtocolVersion() { + case 1: + return 0 + default: + return 1 + } +} + +// setUDPRecvBuf is used to resize the UDP receive window. The function +// attempts to set the read buffer to `udpRecvBuf` but backs off until +// the read buffer can be set. +func setUDPRecvBuf(c *net.UDPConn) { + size := udpRecvBuf + for { + if err := c.SetReadBuffer(size); err == nil { + break + } + size = size / 2 + } +} + +// tcpListen listens for and handles incoming connections +func (m *Memberlist) tcpListen() { + for { + conn, err := m.tcpListener.AcceptTCP() + if err != nil { + if m.shutdown { + break + } + m.logger.Printf("[ERR] memberlist: Error accepting TCP connection: %s", err) + continue + } + go m.handleConn(conn) + } +} + +// handleConn handles a single incoming TCP connection +func (m *Memberlist) handleConn(conn *net.TCPConn) { + m.logger.Printf("[DEBUG] memberlist: Responding to push/pull sync with: %s", conn.RemoteAddr()) + defer conn.Close() + metrics.IncrCounter([]string{"memberlist", "tcp", "accept"}, 1) + + join, remoteNodes, userState, err := m.readRemoteState(conn) + if err != nil { + m.logger.Printf("[ERR] memberlist: Failed to receive remote state: %s", err) + return + } + + if err := m.sendLocalState(conn, join); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to push local state: %s", err) + } + + if err := m.verifyProtocol(remoteNodes); err != nil { + m.logger.Printf("[ERR] memberlist: Push/pull verification failed: %s", err) + return + } + + // Invoke the merge delegate if any + if join && m.config.Merge != nil { + nodes := make([]*Node, len(remoteNodes)) + for idx, n := range remoteNodes { + nodes[idx] = &Node{ + Name: n.Name, + Addr: n.Addr, + Port: n.Port, + Meta: n.Meta, + PMin: n.Vsn[0], + PMax: n.Vsn[1], + PCur: n.Vsn[2], + DMin: n.Vsn[3], + DMax: n.Vsn[4], + DCur: n.Vsn[5], + } + } + if m.config.Merge.NotifyMerge(nodes) { + m.logger.Printf("[WARN] memberlist: Cluster merge canceled") + return + } + } + + // Merge the membership state + m.mergeState(remoteNodes) + + // Invoke the delegate for user state + if m.config.Delegate != nil { + m.config.Delegate.MergeRemoteState(userState, join) + } +} + +// udpListen listens for and handles incoming UDP packets +func (m *Memberlist) udpListen() { + var n int + var addr net.Addr + var err error + var lastPacket time.Time + for { + // Do a check for potentially blocking operations + if !lastPacket.IsZero() && time.Now().Sub(lastPacket) > blockingWarning { + diff := time.Now().Sub(lastPacket) + m.logger.Printf( + "[DEBUG] memberlist: Potential blocking operation. Last command took %v", + diff) + } + + // Create a new buffer + // TODO: Use Sync.Pool eventually + buf := make([]byte, udpBufSize) + + // Read a packet + n, addr, err = m.udpListener.ReadFrom(buf) + if err != nil { + if m.shutdown { + break + } + m.logger.Printf("[ERR] memberlist: Error reading UDP packet: %s", err) + continue + } + + // Check the length + if n < 1 { + m.logger.Printf("[ERR] memberlist: UDP packet too short (%d bytes). From: %s", + len(buf), addr) + continue + } + + // Capture the current time + lastPacket = time.Now() + + // Ingest this packet + metrics.IncrCounter([]string{"memberlist", "udp", "received"}, float32(n)) + m.ingestPacket(buf[:n], addr) + } +} + +func (m *Memberlist) ingestPacket(buf []byte, from net.Addr) { + // Check if encryption is enabled + if m.config.EncryptionEnabled() { + // Decrypt the payload + plain, err := decryptPayload(m.config.Keyring.GetKeys(), buf, nil) + if err != nil { + m.logger.Printf("[ERR] memberlist: Decrypt packet failed: %v", err) + return + } + + // Continue processing the plaintext buffer + buf = plain + } + + // Handle the command + m.handleCommand(buf, from) +} + +func (m *Memberlist) handleCommand(buf []byte, from net.Addr) { + // Decode the message type + msgType := messageType(buf[0]) + buf = buf[1:] + + // Switch on the msgType + switch msgType { + case compoundMsg: + m.handleCompound(buf, from) + case compressMsg: + m.handleCompressed(buf, from) + + case pingMsg: + m.handlePing(buf, from) + case indirectPingMsg: + m.handleIndirectPing(buf, from) + case ackRespMsg: + m.handleAck(buf, from) + + case suspectMsg: + fallthrough + case aliveMsg: + fallthrough + case deadMsg: + fallthrough + case userMsg: + select { + case m.handoff <- msgHandoff{msgType, buf, from}: + default: + m.logger.Printf("[WARN] memberlist: UDP handler queue full, dropping message (%d)", msgType) + } + + default: + m.logger.Printf("[ERR] memberlist: UDP msg type (%d) not supported. From: %s", msgType, from) + } +} + +// udpHandler processes messages received over UDP, but is decoupled +// from the listener to avoid blocking the listener which may cause +// ping/ack messages to be delayed. +func (m *Memberlist) udpHandler() { + for { + select { + case msg := <-m.handoff: + msgType := msg.msgType + buf := msg.buf + from := msg.from + + switch msgType { + case suspectMsg: + m.handleSuspect(buf, from) + case aliveMsg: + m.handleAlive(buf, from) + case deadMsg: + m.handleDead(buf, from) + case userMsg: + m.handleUser(buf, from) + default: + m.logger.Printf("[ERR] memberlist: UDP msg type (%d) not supported. From: %s (handler)", msgType, from) + } + + case <-m.shutdownCh: + return + } + } +} + +func (m *Memberlist) handleCompound(buf []byte, from net.Addr) { + // Decode the parts + trunc, parts, err := decodeCompoundMessage(buf) + if err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode compound request: %s", err) + return + } + + // Log any truncation + if trunc > 0 { + m.logger.Printf("[WARN] memberlist: Compound request had %d truncated messages", trunc) + } + + // Handle each message + for _, part := range parts { + m.handleCommand(part, from) + } +} + +func (m *Memberlist) handlePing(buf []byte, from net.Addr) { + var p ping + if err := decode(buf, &p); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode ping request: %s", err) + return + } + // If node is provided, verify that it is for us + if p.Node != "" && p.Node != m.config.Name { + m.logger.Printf("[WARN] memberlist: Got ping for unexpected node '%s'", p.Node) + return + } + ack := ackResp{p.SeqNo} + if err := m.encodeAndSendMsg(from, ackRespMsg, &ack); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to send ack: %s", err) + } +} + +func (m *Memberlist) handleIndirectPing(buf []byte, from net.Addr) { + var ind indirectPingReq + if err := decode(buf, &ind); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode indirect ping request: %s", err) + return + } + + // For proto versions < 2, there is no port provided. Mask old + // behavior by using the configured port + if m.ProtocolVersion() < 2 || ind.Port == 0 { + ind.Port = uint16(m.config.BindPort) + } + + // Send a ping to the correct host + localSeqNo := m.nextSeqNo() + ping := ping{SeqNo: localSeqNo, Node: ind.Node} + destAddr := &net.UDPAddr{IP: ind.Target, Port: int(ind.Port)} + + // Setup a response handler to relay the ack + respHandler := func() { + ack := ackResp{ind.SeqNo} + if err := m.encodeAndSendMsg(from, ackRespMsg, &ack); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to forward ack: %s", err) + } + } + m.setAckHandler(localSeqNo, respHandler, m.config.ProbeTimeout) + + // Send the ping + if err := m.encodeAndSendMsg(destAddr, pingMsg, &ping); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to send ping: %s", err) + } +} + +func (m *Memberlist) handleAck(buf []byte, from net.Addr) { + var ack ackResp + if err := decode(buf, &ack); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode ack response: %s", err) + return + } + m.invokeAckHandler(ack.SeqNo) +} + +func (m *Memberlist) handleSuspect(buf []byte, from net.Addr) { + var sus suspect + if err := decode(buf, &sus); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode suspect message: %s", err) + return + } + m.suspectNode(&sus) +} + +func (m *Memberlist) handleAlive(buf []byte, from net.Addr) { + var live alive + if err := decode(buf, &live); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode alive message: %s", err) + return + } + + // For proto versions < 2, there is no port provided. Mask old + // behavior by using the configured port + if m.ProtocolVersion() < 2 || live.Port == 0 { + live.Port = uint16(m.config.BindPort) + } + + m.aliveNode(&live, nil, false) +} + +func (m *Memberlist) handleDead(buf []byte, from net.Addr) { + var d dead + if err := decode(buf, &d); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decode dead message: %s", err) + return + } + m.deadNode(&d) +} + +// handleUser is used to notify channels of incoming user data +func (m *Memberlist) handleUser(buf []byte, from net.Addr) { + d := m.config.Delegate + if d != nil { + d.NotifyMsg(buf) + } +} + +// handleCompressed is used to unpack a compressed message +func (m *Memberlist) handleCompressed(buf []byte, from net.Addr) { + // Try to decode the payload + payload, err := decompressPayload(buf) + if err != nil { + m.logger.Printf("[ERR] memberlist: Failed to decompress payload: %v", err) + return + } + + // Recursively handle the payload + m.handleCommand(payload, from) +} + +// encodeAndSendMsg is used to combine the encoding and sending steps +func (m *Memberlist) encodeAndSendMsg(to net.Addr, msgType messageType, msg interface{}) error { + out, err := encode(msgType, msg) + if err != nil { + return err + } + if err := m.sendMsg(to, out.Bytes()); err != nil { + return err + } + return nil +} + +// sendMsg is used to send a UDP message to another host. It will opportunistically +// create a compoundMsg and piggy back other broadcasts +func (m *Memberlist) sendMsg(to net.Addr, msg []byte) error { + // Check if we can piggy back any messages + bytesAvail := udpSendBuf - len(msg) - compoundHeaderOverhead + if m.config.EncryptionEnabled() { + bytesAvail -= encryptOverhead(m.encryptionVersion()) + } + extra := m.getBroadcasts(compoundOverhead, bytesAvail) + + // Fast path if nothing to piggypack + if len(extra) == 0 { + return m.rawSendMsg(to, msg) + } + + // Join all the messages + msgs := make([][]byte, 0, 1+len(extra)) + msgs = append(msgs, msg) + msgs = append(msgs, extra...) + + // Create a compound message + compound := makeCompoundMessage(msgs) + + // Send the message + return m.rawSendMsg(to, compound.Bytes()) +} + +// rawSendMsg is used to send a UDP message to another host without modification +func (m *Memberlist) rawSendMsg(to net.Addr, msg []byte) error { + // Check if we have compression enabled + if m.config.EnableCompression { + buf, err := compressPayload(msg) + if err != nil { + m.logger.Printf("[WARN] memberlist: Failed to compress payload: %v", err) + } else { + // Only use compression if it reduced the size + if buf.Len() < len(msg) { + msg = buf.Bytes() + } + } + } + + // Check if we have encryption enabled + if m.config.EncryptionEnabled() { + // Encrypt the payload + var buf bytes.Buffer + primaryKey := m.config.Keyring.GetPrimaryKey() + err := encryptPayload(m.encryptionVersion(), primaryKey, msg, nil, &buf) + if err != nil { + m.logger.Printf("[ERR] memberlist: Encryption of message failed: %v", err) + return err + } + msg = buf.Bytes() + } + + metrics.IncrCounter([]string{"memberlist", "udp", "sent"}, float32(len(msg))) + _, err := m.udpListener.WriteTo(msg, to) + return err +} + +// sendState is used to initiate a push/pull over TCP with a remote node +func (m *Memberlist) sendAndReceiveState(addr []byte, port uint16, join bool) ([]pushNodeState, []byte, error) { + // Attempt to connect + dialer := net.Dialer{Timeout: m.config.TCPTimeout} + dest := net.TCPAddr{IP: addr, Port: int(port)} + conn, err := dialer.Dial("tcp", dest.String()) + if err != nil { + return nil, nil, err + } + defer conn.Close() + m.logger.Printf("[DEBUG] memberlist: Initiating push/pull sync with: %s", conn.RemoteAddr()) + metrics.IncrCounter([]string{"memberlist", "tcp", "connect"}, 1) + + // Send our state + if err := m.sendLocalState(conn, join); err != nil { + return nil, nil, err + } + + // Read remote state + _, remote, userState, err := m.readRemoteState(conn) + if err != nil { + err := fmt.Errorf("Reading remote state failed: %v", err) + return nil, nil, err + } + + // Return the remote state + return remote, userState, nil +} + +// sendLocalState is invoked to send our local state over a tcp connection +func (m *Memberlist) sendLocalState(conn net.Conn, join bool) error { + // Setup a deadline + conn.SetDeadline(time.Now().Add(m.config.TCPTimeout)) + + // Prepare the local node state + m.nodeLock.RLock() + localNodes := make([]pushNodeState, len(m.nodes)) + for idx, n := range m.nodes { + localNodes[idx].Name = n.Name + localNodes[idx].Addr = n.Addr + localNodes[idx].Port = n.Port + localNodes[idx].Incarnation = n.Incarnation + localNodes[idx].State = n.State + localNodes[idx].Meta = n.Meta + localNodes[idx].Vsn = []uint8{ + n.PMin, n.PMax, n.PCur, + n.DMin, n.DMax, n.DCur, + } + } + m.nodeLock.RUnlock() + + // Get the delegate state + var userData []byte + if m.config.Delegate != nil { + userData = m.config.Delegate.LocalState(join) + } + + // Create a bytes buffer writer + bufConn := bytes.NewBuffer(nil) + + // Send our node state + header := pushPullHeader{Nodes: len(localNodes), UserStateLen: len(userData), Join: join} + hd := codec.MsgpackHandle{} + enc := codec.NewEncoder(bufConn, &hd) + + // Begin state push + if _, err := bufConn.Write([]byte{byte(pushPullMsg)}); err != nil { + return err + } + + if err := enc.Encode(&header); err != nil { + return err + } + for i := 0; i < header.Nodes; i++ { + if err := enc.Encode(&localNodes[i]); err != nil { + return err + } + } + + // Write the user state as well + if userData != nil { + if _, err := bufConn.Write(userData); err != nil { + return err + } + } + + // Get the send buffer + sendBuf := bufConn.Bytes() + + // Check if compresion is enabled + if m.config.EnableCompression { + compBuf, err := compressPayload(bufConn.Bytes()) + if err != nil { + m.logger.Printf("[ERROR] memberlist: Failed to compress local state: %v", err) + } else { + sendBuf = compBuf.Bytes() + } + } + + // Check if encryption is enabled + if m.config.EncryptionEnabled() { + crypt, err := m.encryptLocalState(sendBuf) + if err != nil { + m.logger.Printf("[ERROR] memberlist: Failed to encrypt local state: %v", err) + return err + } + sendBuf = crypt + } + + // Write out the entire send buffer + metrics.IncrCounter([]string{"memberlist", "tcp", "sent"}, float32(len(sendBuf))) + if _, err := conn.Write(sendBuf); err != nil { + return err + } + return nil +} + +// encryptLocalState is used to help encrypt local state before sending +func (m *Memberlist) encryptLocalState(sendBuf []byte) ([]byte, error) { + var buf bytes.Buffer + + // Write the encryptMsg byte + buf.WriteByte(byte(encryptMsg)) + + // Write the size of the message + sizeBuf := make([]byte, 4) + encVsn := m.encryptionVersion() + encLen := encryptedLength(encVsn, len(sendBuf)) + binary.BigEndian.PutUint32(sizeBuf, uint32(encLen)) + buf.Write(sizeBuf) + + // Write the encrypted cipher text to the buffer + key := m.config.Keyring.GetPrimaryKey() + err := encryptPayload(encVsn, key, sendBuf, buf.Bytes()[:5], &buf) + if err != nil { + return nil, err + } + return buf.Bytes(), nil +} + +// decryptRemoteState is used to help decrypt the remote state +func (m *Memberlist) decryptRemoteState(bufConn io.Reader) ([]byte, error) { + // Read in enough to determine message length + cipherText := bytes.NewBuffer(nil) + cipherText.WriteByte(byte(encryptMsg)) + _, err := io.CopyN(cipherText, bufConn, 4) + if err != nil { + return nil, err + } + + // Ensure we aren't asked to download too much. This is to guard against + // an attack vector where a huge amount of state is sent + moreBytes := binary.BigEndian.Uint32(cipherText.Bytes()[1:5]) + if moreBytes > maxPushStateBytes { + return nil, fmt.Errorf("Remote node state is larger than limit (%d)", moreBytes) + } + + // Read in the rest of the payload + _, err = io.CopyN(cipherText, bufConn, int64(moreBytes)) + if err != nil { + return nil, err + } + + // Decrypt the cipherText + dataBytes := cipherText.Bytes()[:5] + cipherBytes := cipherText.Bytes()[5:] + + // Decrypt the payload + keys := m.config.Keyring.GetKeys() + return decryptPayload(keys, cipherBytes, dataBytes) +} + +// recvRemoteState is used to read the remote state from a connection +func (m *Memberlist) readRemoteState(conn net.Conn) (bool, []pushNodeState, []byte, error) { + // Setup a deadline + conn.SetDeadline(time.Now().Add(m.config.TCPTimeout)) + + // Created a buffered reader + var bufConn io.Reader = bufio.NewReader(conn) + + // Read the message type + buf := [1]byte{0} + if _, err := bufConn.Read(buf[:]); err != nil { + return false, nil, nil, err + } + msgType := messageType(buf[0]) + + // Check if the message is encrypted + if msgType == encryptMsg { + if !m.config.EncryptionEnabled() { + return false, nil, nil, + fmt.Errorf("Remote state is encrypted and encryption is not configured") + } + + plain, err := m.decryptRemoteState(bufConn) + if err != nil { + return false, nil, nil, err + } + + // Reset message type and bufConn + msgType = messageType(plain[0]) + bufConn = bytes.NewReader(plain[1:]) + } else if m.config.EncryptionEnabled() { + return false, nil, nil, + fmt.Errorf("Encryption is configured but remote state is not encrypted") + } + + // Get the msgPack decoders + hd := codec.MsgpackHandle{} + dec := codec.NewDecoder(bufConn, &hd) + + // Check if we have a compressed message + if msgType == compressMsg { + var c compress + if err := dec.Decode(&c); err != nil { + return false, nil, nil, err + } + decomp, err := decompressBuffer(&c) + if err != nil { + return false, nil, nil, err + } + + // Reset the message type + msgType = messageType(decomp[0]) + + // Create a new bufConn + bufConn = bytes.NewReader(decomp[1:]) + + // Create a new decoder + dec = codec.NewDecoder(bufConn, &hd) + } + + // Quit if not push/pull + if msgType != pushPullMsg { + err := fmt.Errorf("received invalid msgType (%d)", msgType) + return false, nil, nil, err + } + + // Read the push/pull header + var header pushPullHeader + if err := dec.Decode(&header); err != nil { + return false, nil, nil, err + } + + // Allocate space for the transfer + remoteNodes := make([]pushNodeState, header.Nodes) + + // Try to decode all the states + for i := 0; i < header.Nodes; i++ { + if err := dec.Decode(&remoteNodes[i]); err != nil { + return false, remoteNodes, nil, err + } + } + + // Read the remote user state into a buffer + var userBuf []byte + if header.UserStateLen > 0 { + userBuf = make([]byte, header.UserStateLen) + bytes, err := io.ReadAtLeast(bufConn, userBuf, header.UserStateLen) + if err == nil && bytes != header.UserStateLen { + err = fmt.Errorf( + "Failed to read full user state (%d / %d)", + bytes, header.UserStateLen) + } + if err != nil { + return false, remoteNodes, nil, err + } + } + + // For proto versions < 2, there is no port provided. Mask old + // behavior by using the configured port + for idx := range remoteNodes { + if m.ProtocolVersion() < 2 || remoteNodes[idx].Port == 0 { + remoteNodes[idx].Port = uint16(m.config.BindPort) + } + } + + return header.Join, remoteNodes, userBuf, nil +} diff --git a/vendor/src/github.com/hashicorp/memberlist/queue.go b/vendor/src/github.com/hashicorp/memberlist/queue.go new file mode 100644 index 0000000000..994b90ff10 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/queue.go @@ -0,0 +1,167 @@ +package memberlist + +import ( + "sort" + "sync" +) + +// TransmitLimitedQueue is used to queue messages to broadcast to +// the cluster (via gossip) but limits the number of transmits per +// message. It also prioritizes messages with lower transmit counts +// (hence newer messages). +type TransmitLimitedQueue struct { + // NumNodes returns the number of nodes in the cluster. This is + // used to determine the retransmit count, which is calculated + // based on the log of this. + NumNodes func() int + + // RetransmitMult is the multiplier used to determine the maximum + // number of retransmissions attempted. + RetransmitMult int + + sync.Mutex + bcQueue limitedBroadcasts +} + +type limitedBroadcast struct { + transmits int // Number of transmissions attempted. + b Broadcast +} +type limitedBroadcasts []*limitedBroadcast + +// Broadcast is something that can be broadcasted via gossip to +// the memberlist cluster. +type Broadcast interface { + // Invalidates checks if enqueuing the current broadcast + // invalidates a previous broadcast + Invalidates(b Broadcast) bool + + // Returns a byte form of the message + Message() []byte + + // Finished is invoked when the message will no longer + // be broadcast, either due to invalidation or to the + // transmit limit being reached + Finished() +} + +// QueueBroadcast is used to enqueue a broadcast +func (q *TransmitLimitedQueue) QueueBroadcast(b Broadcast) { + q.Lock() + defer q.Unlock() + + // Check if this message invalidates another + n := len(q.bcQueue) + for i := 0; i < n; i++ { + if b.Invalidates(q.bcQueue[i].b) { + q.bcQueue[i].b.Finished() + copy(q.bcQueue[i:], q.bcQueue[i+1:]) + q.bcQueue[n-1] = nil + q.bcQueue = q.bcQueue[:n-1] + n-- + } + } + + // Append to the queue + q.bcQueue = append(q.bcQueue, &limitedBroadcast{0, b}) +} + +// GetBroadcasts is used to get a number of broadcasts, up to a byte limit +// and applying a per-message overhead as provided. +func (q *TransmitLimitedQueue) GetBroadcasts(overhead, limit int) [][]byte { + q.Lock() + defer q.Unlock() + + // Fast path the default case + if len(q.bcQueue) == 0 { + return nil + } + + transmitLimit := retransmitLimit(q.RetransmitMult, q.NumNodes()) + bytesUsed := 0 + var toSend [][]byte + + for i := len(q.bcQueue) - 1; i >= 0; i-- { + // Check if this is within our limits + b := q.bcQueue[i] + msg := b.b.Message() + if bytesUsed+overhead+len(msg) > limit { + continue + } + + // Add to slice to send + bytesUsed += overhead + len(msg) + toSend = append(toSend, msg) + + // Check if we should stop transmission + b.transmits++ + if b.transmits >= transmitLimit { + b.b.Finished() + n := len(q.bcQueue) + q.bcQueue[i], q.bcQueue[n-1] = q.bcQueue[n-1], nil + q.bcQueue = q.bcQueue[:n-1] + } + } + + // If we are sending anything, we need to re-sort to deal + // with adjusted transmit counts + if len(toSend) > 0 { + q.bcQueue.Sort() + } + return toSend +} + +// NumQueued returns the number of queued messages +func (q *TransmitLimitedQueue) NumQueued() int { + q.Lock() + defer q.Unlock() + return len(q.bcQueue) +} + +// Reset clears all the queued messages +func (q *TransmitLimitedQueue) Reset() { + q.Lock() + defer q.Unlock() + for _, b := range q.bcQueue { + b.b.Finished() + } + q.bcQueue = nil +} + +// Prune will retain the maxRetain latest messages, and the rest +// will be discarded. This can be used to prevent unbounded queue sizes +func (q *TransmitLimitedQueue) Prune(maxRetain int) { + q.Lock() + defer q.Unlock() + + // Do nothing if queue size is less than the limit + n := len(q.bcQueue) + if n < maxRetain { + return + } + + // Invalidate the messages we will be removing + for i := 0; i < n-maxRetain; i++ { + q.bcQueue[i].b.Finished() + } + + // Move the messages, and retain only the last maxRetain + copy(q.bcQueue[0:], q.bcQueue[n-maxRetain:]) + q.bcQueue = q.bcQueue[:maxRetain] +} + +func (b limitedBroadcasts) Len() int { + return len(b) +} + +func (b limitedBroadcasts) Less(i, j int) bool { + return b[i].transmits < b[j].transmits +} + +func (b limitedBroadcasts) Swap(i, j int) { + b[i], b[j] = b[j], b[i] +} + +func (b limitedBroadcasts) Sort() { + sort.Sort(sort.Reverse(b)) +} diff --git a/vendor/src/github.com/hashicorp/memberlist/security.go b/vendor/src/github.com/hashicorp/memberlist/security.go new file mode 100644 index 0000000000..d90114eb0c --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/security.go @@ -0,0 +1,198 @@ +package memberlist + +import ( + "bytes" + "crypto/aes" + "crypto/cipher" + "crypto/rand" + "fmt" + "io" +) + +/* + +Encrypted messages are prefixed with an encryptionVersion byte +that is used for us to be able to properly encode/decode. We +currently support the following versions: + + 0 - AES-GCM 128, using PKCS7 padding + 1 - AES-GCM 128, no padding. Padding not needed, caused bloat. + +*/ +type encryptionVersion uint8 + +const ( + minEncryptionVersion encryptionVersion = 0 + maxEncryptionVersion encryptionVersion = 1 +) + +const ( + versionSize = 1 + nonceSize = 12 + tagSize = 16 + maxPadOverhead = 16 + blockSize = aes.BlockSize +) + +// pkcs7encode is used to pad a byte buffer to a specific block size using +// the PKCS7 algorithm. "Ignores" some bytes to compensate for IV +func pkcs7encode(buf *bytes.Buffer, ignore, blockSize int) { + n := buf.Len() - ignore + more := blockSize - (n % blockSize) + for i := 0; i < more; i++ { + buf.WriteByte(byte(more)) + } +} + +// pkcs7decode is used to decode a buffer that has been padded +func pkcs7decode(buf []byte, blockSize int) []byte { + if len(buf) == 0 { + panic("Cannot decode a PKCS7 buffer of zero length") + } + n := len(buf) + last := buf[n-1] + n -= int(last) + return buf[:n] +} + +// encryptOverhead returns the maximum possible overhead of encryption by version +func encryptOverhead(vsn encryptionVersion) int { + switch vsn { + case 0: + return 45 // Version: 1, IV: 12, Padding: 16, Tag: 16 + case 1: + return 29 // Version: 1, IV: 12, Tag: 16 + default: + panic("unsupported version") + } +} + +// encryptedLength is used to compute the buffer size needed +// for a message of given length +func encryptedLength(vsn encryptionVersion, inp int) int { + // If we are on version 1, there is no padding + if vsn >= 1 { + return versionSize + nonceSize + inp + tagSize + } + + // Determine the padding size + padding := blockSize - (inp % blockSize) + + // Sum the extra parts to get total size + return versionSize + nonceSize + inp + padding + tagSize +} + +// encryptPayload is used to encrypt a message with a given key. +// We make use of AES-128 in GCM mode. New byte buffer is the version, +// nonce, ciphertext and tag +func encryptPayload(vsn encryptionVersion, key []byte, msg []byte, data []byte, dst *bytes.Buffer) error { + // Get the AES block cipher + aesBlock, err := aes.NewCipher(key) + if err != nil { + return err + } + + // Get the GCM cipher mode + gcm, err := cipher.NewGCM(aesBlock) + if err != nil { + return err + } + + // Grow the buffer to make room for everything + offset := dst.Len() + dst.Grow(encryptedLength(vsn, len(msg))) + + // Write the encryption version + dst.WriteByte(byte(vsn)) + + // Add a random nonce + io.CopyN(dst, rand.Reader, nonceSize) + afterNonce := dst.Len() + + // Ensure we are correctly padded (only version 0) + if vsn == 0 { + io.Copy(dst, bytes.NewReader(msg)) + pkcs7encode(dst, offset+versionSize+nonceSize, aes.BlockSize) + } + + // Encrypt message using GCM + slice := dst.Bytes()[offset:] + nonce := slice[versionSize : versionSize+nonceSize] + + // Message source depends on the encryption version. + // Version 0 uses padding, version 1 does not + var src []byte + if vsn == 0 { + src = slice[versionSize+nonceSize:] + } else { + src = msg + } + out := gcm.Seal(nil, nonce, src, data) + + // Truncate the plaintext, and write the cipher text + dst.Truncate(afterNonce) + dst.Write(out) + return nil +} + +// decryptMessage performs the actual decryption of ciphertext. This is in its +// own function to allow it to be called on all keys easily. +func decryptMessage(key, msg []byte, data []byte) ([]byte, error) { + // Get the AES block cipher + aesBlock, err := aes.NewCipher(key) + if err != nil { + return nil, err + } + + // Get the GCM cipher mode + gcm, err := cipher.NewGCM(aesBlock) + if err != nil { + return nil, err + } + + // Decrypt the message + nonce := msg[versionSize : versionSize+nonceSize] + ciphertext := msg[versionSize+nonceSize:] + plain, err := gcm.Open(nil, nonce, ciphertext, data) + if err != nil { + return nil, err + } + + // Success! + return plain, nil +} + +// decryptPayload is used to decrypt a message with a given key, +// and verify it's contents. Any padding will be removed, and a +// slice to the plaintext is returned. Decryption is done IN PLACE! +func decryptPayload(keys [][]byte, msg []byte, data []byte) ([]byte, error) { + // Ensure we have at least one byte + if len(msg) == 0 { + return nil, fmt.Errorf("Cannot decrypt empty payload") + } + + // Verify the version + vsn := encryptionVersion(msg[0]) + if vsn > maxEncryptionVersion { + return nil, fmt.Errorf("Unsupported encryption version %d", msg[0]) + } + + // Ensure the length is sane + if len(msg) < encryptedLength(vsn, 0) { + return nil, fmt.Errorf("Payload is too small to decrypt: %d", len(msg)) + } + + for _, key := range keys { + plain, err := decryptMessage(key, msg, data) + if err == nil { + // Remove the PKCS7 padding for vsn 0 + if vsn == 0 { + return pkcs7decode(plain, aes.BlockSize), nil + } else { + return plain, nil + } + } + } + + return nil, fmt.Errorf("No installed keys could decrypt the message") +} diff --git a/vendor/src/github.com/hashicorp/memberlist/state.go b/vendor/src/github.com/hashicorp/memberlist/state.go new file mode 100644 index 0000000000..3fc1d02e19 --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/state.go @@ -0,0 +1,916 @@ +package memberlist + +import ( + "bytes" + "fmt" + "math" + "math/rand" + "net" + "sync/atomic" + "time" + + "github.com/armon/go-metrics" +) + +type nodeStateType int + +const ( + stateAlive nodeStateType = iota + stateSuspect + stateDead +) + +// Node represents a node in the cluster. +type Node struct { + Name string + Addr net.IP + Port uint16 + Meta []byte // Metadata from the delegate for this node. + PMin uint8 // Minimum protocol version this understands + PMax uint8 // Maximum protocol version this understands + PCur uint8 // Current version node is speaking + DMin uint8 // Min protocol version for the delegate to understand + DMax uint8 // Max protocol version for the delegate to understand + DCur uint8 // Current version delegate is speaking +} + +// NodeState is used to manage our state view of another node +type nodeState struct { + Node + Incarnation uint32 // Last known incarnation number + State nodeStateType // Current state + StateChange time.Time // Time last state change happened +} + +// ackHandler is used to register handlers for incoming acks +type ackHandler struct { + handler func() + timer *time.Timer +} + +// Schedule is used to ensure the Tick is performed periodically. This +// function is safe to call multiple times. If the memberlist is already +// scheduled, then it won't do anything. +func (m *Memberlist) schedule() { + m.tickerLock.Lock() + defer m.tickerLock.Unlock() + + // If we already have tickers, then don't do anything, since we're + // scheduled + if len(m.tickers) > 0 { + return + } + + // Create the stop tick channel, a blocking channel. We close this + // when we should stop the tickers. + stopCh := make(chan struct{}) + + // Create a new probeTicker + if m.config.ProbeInterval > 0 { + t := time.NewTicker(m.config.ProbeInterval) + go m.triggerFunc(m.config.ProbeInterval, t.C, stopCh, m.probe) + m.tickers = append(m.tickers, t) + } + + // Create a push pull ticker if needed + if m.config.PushPullInterval > 0 { + go m.pushPullTrigger(stopCh) + } + + // Create a gossip ticker if needed + if m.config.GossipInterval > 0 && m.config.GossipNodes > 0 { + t := time.NewTicker(m.config.GossipInterval) + go m.triggerFunc(m.config.GossipInterval, t.C, stopCh, m.gossip) + m.tickers = append(m.tickers, t) + } + + // If we made any tickers, then record the stopTick channel for + // later. + if len(m.tickers) > 0 { + m.stopTick = stopCh + } +} + +// triggerFunc is used to trigger a function call each time a +// message is received until a stop tick arrives. +func (m *Memberlist) triggerFunc(stagger time.Duration, C <-chan time.Time, stop <-chan struct{}, f func()) { + // Use a random stagger to avoid syncronizing + randStagger := time.Duration(uint64(rand.Int63()) % uint64(stagger)) + select { + case <-time.After(randStagger): + case <-stop: + return + } + for { + select { + case <-C: + f() + case <-stop: + return + } + } +} + +// pushPullTrigger is used to periodically trigger a push/pull until +// a stop tick arrives. We don't use triggerFunc since the push/pull +// timer is dynamically scaled based on cluster size to avoid network +// saturation +func (m *Memberlist) pushPullTrigger(stop <-chan struct{}) { + interval := m.config.PushPullInterval + + // Use a random stagger to avoid syncronizing + randStagger := time.Duration(uint64(rand.Int63()) % uint64(interval)) + select { + case <-time.After(randStagger): + case <-stop: + return + } + + // Tick using a dynamic timer + for { + m.nodeLock.RLock() + tickTime := pushPullScale(interval, len(m.nodes)) + m.nodeLock.RUnlock() + select { + case <-time.After(tickTime): + m.pushPull() + case <-stop: + return + } + } +} + +// Deschedule is used to stop the background maintenence. This is safe +// to call multiple times. +func (m *Memberlist) deschedule() { + m.tickerLock.Lock() + defer m.tickerLock.Unlock() + + // If we have no tickers, then we aren't scheduled. + if len(m.tickers) == 0 { + return + } + + // Close the stop channel so all the ticker listeners stop. + close(m.stopTick) + + // Explicitly stop all the tickers themselves so they don't take + // up any more resources, and get rid of the list. + for _, t := range m.tickers { + t.Stop() + } + m.tickers = nil +} + +// Tick is used to perform a single round of failure detection and gossip +func (m *Memberlist) probe() { + // Track the number of indexes we've considered probing + numCheck := 0 +START: + m.nodeLock.RLock() + + // Make sure we don't wrap around infinitely + if numCheck >= len(m.nodes) { + m.nodeLock.RUnlock() + return + } + + // Handle the wrap around case + if m.probeIndex >= len(m.nodes) { + m.nodeLock.RUnlock() + m.resetNodes() + m.probeIndex = 0 + numCheck++ + goto START + } + + // Determine if we should probe this node + skip := false + var node nodeState + + node = *m.nodes[m.probeIndex] + if node.Name == m.config.Name { + skip = true + } else if node.State == stateDead { + skip = true + } + + // Potentially skip + m.nodeLock.RUnlock() + m.probeIndex++ + if skip { + numCheck++ + goto START + } + + // Probe the specific node + m.probeNode(&node) +} + +// probeNode handles a single round of failure checking on a node +func (m *Memberlist) probeNode(node *nodeState) { + defer metrics.MeasureSince([]string{"memberlist", "probeNode"}, time.Now()) + + // Send a ping to the node + ping := ping{SeqNo: m.nextSeqNo(), Node: node.Name} + destAddr := &net.UDPAddr{IP: node.Addr, Port: int(node.Port)} + + // Setup an ack handler + ackCh := make(chan bool, m.config.IndirectChecks+1) + m.setAckChannel(ping.SeqNo, ackCh, m.config.ProbeInterval) + + // Send the ping message + if err := m.encodeAndSendMsg(destAddr, pingMsg, &ping); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to send ping: %s", err) + return + } + + // Wait for response or round-trip-time + select { + case v := <-ackCh: + if v == true { + return + } + + // As an edge case, if we get a timeout, we need to re-enqueue it + // here to break out of the select below + if v == false { + ackCh <- v + } + case <-time.After(m.config.ProbeTimeout): + } + + // Get some random live nodes + m.nodeLock.RLock() + excludes := []string{m.config.Name, node.Name} + kNodes := kRandomNodes(m.config.IndirectChecks, excludes, m.nodes) + m.nodeLock.RUnlock() + + // Attempt an indirect ping + ind := indirectPingReq{SeqNo: ping.SeqNo, Target: node.Addr, Port: node.Port, Node: node.Name} + for _, peer := range kNodes { + destAddr := &net.UDPAddr{IP: peer.Addr, Port: int(peer.Port)} + if err := m.encodeAndSendMsg(destAddr, indirectPingMsg, &ind); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to send indirect ping: %s", err) + } + } + + // Wait for the acks or timeout + select { + case v := <-ackCh: + if v == true { + return + } + } + + // No acks received from target, suspect + m.logger.Printf("[INFO] memberlist: Suspect %s has failed, no acks received", node.Name) + s := suspect{Incarnation: node.Incarnation, Node: node.Name, From: m.config.Name} + m.suspectNode(&s) +} + +// resetNodes is used when the tick wraps around. It will reap the +// dead nodes and shuffle the node list. +func (m *Memberlist) resetNodes() { + m.nodeLock.Lock() + defer m.nodeLock.Unlock() + + // Move the dead nodes + deadIdx := moveDeadNodes(m.nodes) + + // Deregister the dead nodes + for i := deadIdx; i < len(m.nodes); i++ { + delete(m.nodeMap, m.nodes[i].Name) + m.nodes[i] = nil + } + + // Trim the nodes to exclude the dead nodes + m.nodes = m.nodes[0:deadIdx] + + // Shuffle live nodes + shuffleNodes(m.nodes) +} + +// gossip is invoked every GossipInterval period to broadcast our gossip +// messages to a few random nodes. +func (m *Memberlist) gossip() { + defer metrics.MeasureSince([]string{"memberlist", "gossip"}, time.Now()) + + // Get some random live nodes + m.nodeLock.RLock() + excludes := []string{m.config.Name} + kNodes := kRandomNodes(m.config.GossipNodes, excludes, m.nodes) + m.nodeLock.RUnlock() + + // Compute the bytes available + bytesAvail := udpSendBuf - compoundHeaderOverhead + if m.config.EncryptionEnabled() { + bytesAvail -= encryptOverhead(m.encryptionVersion()) + } + + for _, node := range kNodes { + // Get any pending broadcasts + msgs := m.getBroadcasts(compoundOverhead, bytesAvail) + if len(msgs) == 0 { + return + } + + // Create a compound message + compound := makeCompoundMessage(msgs) + + // Send the compound message + destAddr := &net.UDPAddr{IP: node.Addr, Port: int(node.Port)} + if err := m.rawSendMsg(destAddr, compound.Bytes()); err != nil { + m.logger.Printf("[ERR] memberlist: Failed to send gossip to %s: %s", destAddr, err) + } + } +} + +// pushPull is invoked periodically to randomly perform a complete state +// exchange. Used to ensure a high level of convergence, but is also +// reasonably expensive as the entire state of this node is exchanged +// with the other node. +func (m *Memberlist) pushPull() { + // Get a random live node + m.nodeLock.RLock() + excludes := []string{m.config.Name} + nodes := kRandomNodes(1, excludes, m.nodes) + m.nodeLock.RUnlock() + + // If no nodes, bail + if len(nodes) == 0 { + return + } + node := nodes[0] + + // Attempt a push pull + if err := m.pushPullNode(node.Addr, node.Port, false); err != nil { + m.logger.Printf("[ERR] memberlist: Push/Pull with %s failed: %s", node.Name, err) + } +} + +// pushPullNode does a complete state exchange with a specific node. +func (m *Memberlist) pushPullNode(addr []byte, port uint16, join bool) error { + defer metrics.MeasureSince([]string{"memberlist", "pushPullNode"}, time.Now()) + + // Attempt to send and receive with the node + remote, userState, err := m.sendAndReceiveState(addr, port, join) + if err != nil { + return err + } + + if err := m.verifyProtocol(remote); err != nil { + return err + } + + // Invoke the merge delegate if any + if join && m.config.Merge != nil { + nodes := make([]*Node, len(remote)) + for idx, n := range remote { + nodes[idx] = &Node{ + Name: n.Name, + Addr: n.Addr, + Port: n.Port, + Meta: n.Meta, + PMin: n.Vsn[0], + PMax: n.Vsn[1], + PCur: n.Vsn[2], + DMin: n.Vsn[3], + DMax: n.Vsn[4], + DCur: n.Vsn[5], + } + } + if m.config.Merge.NotifyMerge(nodes) { + m.logger.Printf("[WARN] memberlist: Cluster merge canceled") + return fmt.Errorf("Merge canceled") + } + } + + // Merge the state + m.mergeState(remote) + + // Invoke the delegate + if m.config.Delegate != nil { + m.config.Delegate.MergeRemoteState(userState, join) + } + return nil +} + +// verifyProtocol verifies that all the remote nodes can speak with our +// nodes and vice versa on both the core protocol as well as the +// delegate protocol level. +// +// The verification works by finding the maximum minimum and +// minimum maximum understood protocol and delegate versions. In other words, +// it finds the common denominator of protocol and delegate version ranges +// for the entire cluster. +// +// After this, it goes through the entire cluster (local and remote) and +// verifies that everyone's speaking protocol versions satisfy this range. +// If this passes, it means that every node can understand each other. +func (m *Memberlist) verifyProtocol(remote []pushNodeState) error { + m.nodeLock.RLock() + defer m.nodeLock.RUnlock() + + // Maximum minimum understood and minimum maximum understood for both + // the protocol and delegate versions. We use this to verify everyone + // can be understood. + var maxpmin, minpmax uint8 + var maxdmin, mindmax uint8 + minpmax = math.MaxUint8 + mindmax = math.MaxUint8 + + for _, rn := range remote { + // If the node isn't alive, then skip it + if rn.State != stateAlive { + continue + } + + // Skip nodes that don't have versions set, it just means + // their version is zero. + if len(rn.Vsn) == 0 { + continue + } + + if rn.Vsn[0] > maxpmin { + maxpmin = rn.Vsn[0] + } + + if rn.Vsn[1] < minpmax { + minpmax = rn.Vsn[1] + } + + if rn.Vsn[3] > maxdmin { + maxdmin = rn.Vsn[3] + } + + if rn.Vsn[4] < mindmax { + mindmax = rn.Vsn[4] + } + } + + for _, n := range m.nodes { + // Ignore non-alive nodes + if n.State != stateAlive { + continue + } + + if n.PMin > maxpmin { + maxpmin = n.PMin + } + + if n.PMax < minpmax { + minpmax = n.PMax + } + + if n.DMin > maxdmin { + maxdmin = n.DMin + } + + if n.DMax < mindmax { + mindmax = n.DMax + } + } + + // Now that we definitively know the minimum and maximum understood + // version that satisfies the whole cluster, we verify that every + // node in the cluster satisifies this. + for _, n := range remote { + var nPCur, nDCur uint8 + if len(n.Vsn) > 0 { + nPCur = n.Vsn[2] + nDCur = n.Vsn[5] + } + + if nPCur < maxpmin || nPCur > minpmax { + return fmt.Errorf( + "Node '%s' protocol version (%d) is incompatible: [%d, %d]", + n.Name, nPCur, maxpmin, minpmax) + } + + if nDCur < maxdmin || nDCur > mindmax { + return fmt.Errorf( + "Node '%s' delegate protocol version (%d) is incompatible: [%d, %d]", + n.Name, nDCur, maxdmin, mindmax) + } + } + + for _, n := range m.nodes { + nPCur := n.PCur + nDCur := n.DCur + + if nPCur < maxpmin || nPCur > minpmax { + return fmt.Errorf( + "Node '%s' protocol version (%d) is incompatible: [%d, %d]", + n.Name, nPCur, maxpmin, minpmax) + } + + if nDCur < maxdmin || nDCur > mindmax { + return fmt.Errorf( + "Node '%s' delegate protocol version (%d) is incompatible: [%d, %d]", + n.Name, nDCur, maxdmin, mindmax) + } + } + + return nil +} + +// nextSeqNo returns a usable sequence number in a thread safe way +func (m *Memberlist) nextSeqNo() uint32 { + return atomic.AddUint32(&m.sequenceNum, 1) +} + +// nextIncarnation returns the next incarnation number in a thread safe way +func (m *Memberlist) nextIncarnation() uint32 { + return atomic.AddUint32(&m.incarnation, 1) +} + +// setAckChannel is used to attach a channel to receive a message when +// an ack with a given sequence number is received. The channel gets sent +// false on timeout +func (m *Memberlist) setAckChannel(seqNo uint32, ch chan bool, timeout time.Duration) { + // Create a handler function + handler := func() { + select { + case ch <- true: + default: + } + } + + // Add the handler + ah := &ackHandler{handler, nil} + m.ackLock.Lock() + m.ackHandlers[seqNo] = ah + m.ackLock.Unlock() + + // Setup a reaping routing + ah.timer = time.AfterFunc(timeout, func() { + m.ackLock.Lock() + delete(m.ackHandlers, seqNo) + m.ackLock.Unlock() + select { + case ch <- false: + default: + } + }) +} + +// setAckHandler is used to attach a handler to be invoked when an +// ack with a given sequence number is received. If a timeout is reached, +// the handler is deleted +func (m *Memberlist) setAckHandler(seqNo uint32, handler func(), timeout time.Duration) { + // Add the handler + ah := &ackHandler{handler, nil} + m.ackLock.Lock() + m.ackHandlers[seqNo] = ah + m.ackLock.Unlock() + + // Setup a reaping routing + ah.timer = time.AfterFunc(timeout, func() { + m.ackLock.Lock() + delete(m.ackHandlers, seqNo) + m.ackLock.Unlock() + }) +} + +// Invokes an Ack handler if any is associated, and reaps the handler immediately +func (m *Memberlist) invokeAckHandler(seqNo uint32) { + m.ackLock.Lock() + ah, ok := m.ackHandlers[seqNo] + delete(m.ackHandlers, seqNo) + m.ackLock.Unlock() + if !ok { + return + } + ah.timer.Stop() + ah.handler() +} + +// aliveNode is invoked by the network layer when we get a message about a +// live node. +func (m *Memberlist) aliveNode(a *alive, notify chan struct{}, bootstrap bool) { + m.nodeLock.Lock() + defer m.nodeLock.Unlock() + state, ok := m.nodeMap[a.Node] + + // It is possible that during a Leave(), there is already an aliveMsg + // in-queue to be processed but blocked by the locks above. If we let + // that aliveMsg process, it'll cause us to re-join the cluster. This + // ensures that we don't. + if m.leave && a.Node == m.config.Name { + return + } + + // Check if we've never seen this node before, and if not, then + // store this node in our node map. + if !ok { + state = &nodeState{ + Node: Node{ + Name: a.Node, + Addr: a.Addr, + Port: a.Port, + Meta: a.Meta, + }, + State: stateDead, + } + + // Add to map + m.nodeMap[a.Node] = state + + // Get a random offset. This is important to ensure + // the failure detection bound is low on average. If all + // nodes did an append, failure detection bound would be + // very high. + n := len(m.nodes) + offset := randomOffset(n) + + // Add at the end and swap with the node at the offset + m.nodes = append(m.nodes, state) + m.nodes[offset], m.nodes[n] = m.nodes[n], m.nodes[offset] + } + + // Check if this address is different than the existing node + if !bytes.Equal([]byte(state.Addr), a.Addr) || state.Port != a.Port { + m.logger.Printf("[ERR] memberlist: Conflicting address for %s. Mine: %v:%d Theirs: %v:%d", + state.Name, state.Addr, state.Port, net.IP(a.Addr), a.Port) + + // Inform the conflict delegate if provided + if m.config.Conflict != nil { + other := Node{ + Name: a.Node, + Addr: a.Addr, + Port: a.Port, + Meta: a.Meta, + } + m.config.Conflict.NotifyConflict(&state.Node, &other) + } + return + } + + // Bail if the incarnation number is older, and this is not about us + isLocalNode := state.Name == m.config.Name + if a.Incarnation <= state.Incarnation && !isLocalNode { + return + } + + // Bail if strictly less and this is about us + if a.Incarnation < state.Incarnation && isLocalNode { + return + } + + // Update metrics + metrics.IncrCounter([]string{"memberlist", "msg", "alive"}, 1) + + // Store the old state and meta data + oldState := state.State + oldMeta := state.Meta + + // If this is us we need to refute, otherwise re-broadcast + if !bootstrap && isLocalNode { + // Compute the version vector + versions := []uint8{ + state.PMin, state.PMax, state.PCur, + state.DMin, state.DMax, state.DCur, + } + + // If the Incarnation is the same, we need special handling, since it + // possible for the following situation to happen: + // 1) Start with configuration C, join cluster + // 2) Hard fail / Kill / Shutdown + // 3) Restart with configuration C', join cluster + // + // In this case, other nodes and the local node see the same incarnation, + // but the values may not be the same. For this reason, we always + // need to do an equality check for this Incarnation. In most cases, + // we just ignore, but we may need to refute. + // + if a.Incarnation == state.Incarnation && + bytes.Equal(a.Meta, state.Meta) && + bytes.Equal(a.Vsn, versions) { + return + } + + inc := m.nextIncarnation() + for a.Incarnation >= inc { + inc = m.nextIncarnation() + } + state.Incarnation = inc + + a := alive{ + Incarnation: inc, + Node: state.Name, + Addr: state.Addr, + Port: state.Port, + Meta: state.Meta, + Vsn: versions, + } + m.encodeBroadcastNotify(a.Node, aliveMsg, a, notify) + m.logger.Printf("[WARN] memberlist: Refuting an alive message") + } else { + m.encodeBroadcastNotify(a.Node, aliveMsg, a, notify) + + // Update protocol versions if it arrived + if len(a.Vsn) > 0 { + state.PMin = a.Vsn[0] + state.PMax = a.Vsn[1] + state.PCur = a.Vsn[2] + state.DMin = a.Vsn[3] + state.DMax = a.Vsn[4] + state.DCur = a.Vsn[5] + } + + // Update the state and incarnation number + state.Incarnation = a.Incarnation + state.Meta = a.Meta + if state.State != stateAlive { + state.State = stateAlive + state.StateChange = time.Now() + } + } + + // Notify the delegate of any relevant updates + if m.config.Events != nil { + if oldState == stateDead { + // if Dead -> Alive, notify of join + m.config.Events.NotifyJoin(&state.Node) + + } else if !bytes.Equal(oldMeta, state.Meta) { + // if Meta changed, trigger an update notification + m.config.Events.NotifyUpdate(&state.Node) + } + } +} + +// suspectNode is invoked by the network layer when we get a message +// about a suspect node +func (m *Memberlist) suspectNode(s *suspect) { + m.nodeLock.Lock() + defer m.nodeLock.Unlock() + state, ok := m.nodeMap[s.Node] + + // If we've never heard about this node before, ignore it + if !ok { + return + } + + // Ignore old incarnation numbers + if s.Incarnation < state.Incarnation { + return + } + + // Ignore non-alive nodes + if state.State != stateAlive { + return + } + + // If this is us we need to refute, otherwise re-broadcast + if state.Name == m.config.Name { + inc := m.nextIncarnation() + for s.Incarnation >= inc { + inc = m.nextIncarnation() + } + state.Incarnation = inc + + a := alive{ + Incarnation: inc, + Node: state.Name, + Addr: state.Addr, + Port: state.Port, + Meta: state.Meta, + Vsn: []uint8{ + state.PMin, state.PMax, state.PCur, + state.DMin, state.DMax, state.DCur, + }, + } + m.encodeAndBroadcast(s.Node, aliveMsg, a) + m.logger.Printf("[WARN] memberlist: Refuting a suspect message (from: %s)", s.From) + return // Do not mark ourself suspect + } else { + m.encodeAndBroadcast(s.Node, suspectMsg, s) + } + + // Update metrics + metrics.IncrCounter([]string{"memberlist", "msg", "suspect"}, 1) + + // Update the state + state.Incarnation = s.Incarnation + state.State = stateSuspect + changeTime := time.Now() + state.StateChange = changeTime + + // Setup a timeout for this + timeout := suspicionTimeout(m.config.SuspicionMult, len(m.nodes), m.config.ProbeInterval) + time.AfterFunc(timeout, func() { + m.nodeLock.Lock() + state, ok := m.nodeMap[s.Node] + timeout := ok && state.State == stateSuspect && state.StateChange == changeTime + m.nodeLock.Unlock() + + if timeout { + m.suspectTimeout(state) + } + }) +} + +// suspectTimeout is invoked when a suspect timeout has occurred +func (m *Memberlist) suspectTimeout(n *nodeState) { + // Construct a dead message + m.logger.Printf("[INFO] memberlist: Marking %s as failed, suspect timeout reached", n.Name) + d := dead{Incarnation: n.Incarnation, Node: n.Name, From: m.config.Name} + m.deadNode(&d) +} + +// deadNode is invoked by the network layer when we get a message +// about a dead node +func (m *Memberlist) deadNode(d *dead) { + m.nodeLock.Lock() + defer m.nodeLock.Unlock() + state, ok := m.nodeMap[d.Node] + + // If we've never heard about this node before, ignore it + if !ok { + return + } + + // Ignore old incarnation numbers + if d.Incarnation < state.Incarnation { + return + } + + // Ignore if node is already dead + if state.State == stateDead { + return + } + + // Check if this is us + if state.Name == m.config.Name { + // If we are not leaving we need to refute + if !m.leave { + inc := m.nextIncarnation() + for d.Incarnation >= inc { + inc = m.nextIncarnation() + } + state.Incarnation = inc + + a := alive{ + Incarnation: inc, + Node: state.Name, + Addr: state.Addr, + Port: state.Port, + Meta: state.Meta, + Vsn: []uint8{ + state.PMin, state.PMax, state.PCur, + state.DMin, state.DMax, state.DCur, + }, + } + m.encodeAndBroadcast(d.Node, aliveMsg, a) + m.logger.Printf("[WARN] memberlist: Refuting a dead message (from: %s)", d.From) + return // Do not mark ourself dead + } + + // If we are leaving, we broadcast and wait + m.encodeBroadcastNotify(d.Node, deadMsg, d, m.leaveBroadcast) + } else { + m.encodeAndBroadcast(d.Node, deadMsg, d) + } + + // Update metrics + metrics.IncrCounter([]string{"memberlist", "msg", "dead"}, 1) + + // Update the state + state.Incarnation = d.Incarnation + state.State = stateDead + state.StateChange = time.Now() + + // Notify of death + if m.config.Events != nil { + m.config.Events.NotifyLeave(&state.Node) + } +} + +// mergeState is invoked by the network layer when we get a Push/Pull +// state transfer +func (m *Memberlist) mergeState(remote []pushNodeState) { + for _, r := range remote { + switch r.State { + case stateAlive: + a := alive{ + Incarnation: r.Incarnation, + Node: r.Name, + Addr: r.Addr, + Port: r.Port, + Meta: r.Meta, + Vsn: r.Vsn, + } + m.aliveNode(&a, nil, false) + + case stateDead: + // If the remote node belives a node is dead, we prefer to + // suspect that node instead of declaring it dead instantly + fallthrough + case stateSuspect: + s := suspect{Incarnation: r.Incarnation, Node: r.Name, From: m.config.Name} + m.suspectNode(&s) + } + } +} diff --git a/vendor/src/github.com/hashicorp/memberlist/todo.md b/vendor/src/github.com/hashicorp/memberlist/todo.md new file mode 100644 index 0000000000..009c1d647a --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/todo.md @@ -0,0 +1,6 @@ +# TODO +* Dynamic RTT discovery + * Compute 99th percentile for ping/ack + * Better lower bound for ping/ack, faster failure detection +* Dynamic MTU discovery + * Prevent lost updates, increases efficiency diff --git a/vendor/src/github.com/hashicorp/memberlist/util.go b/vendor/src/github.com/hashicorp/memberlist/util.go new file mode 100644 index 0000000000..27f9f2a3ca --- /dev/null +++ b/vendor/src/github.com/hashicorp/memberlist/util.go @@ -0,0 +1,325 @@ +package memberlist + +import ( + "bytes" + "compress/lzw" + "encoding/binary" + "fmt" + "github.com/hashicorp/go-msgpack/codec" + "io" + "math" + "math/rand" + "net" + "time" +) + +// pushPullScale is the minimum number of nodes +// before we start scaling the push/pull timing. The scale +// effect is the log2(Nodes) - log2(pushPullScale). This means +// that the 33rd node will cause us to double the interval, +// while the 65th will triple it. +const pushPullScaleThreshold = 32 + +/* + * Contains an entry for each private block: + * 10.0.0.0/8 + * 172.16.0.0/12 + * 192.168/16 + */ +var privateBlocks []*net.IPNet + +var loopbackBlock *net.IPNet + +const ( + // Constant litWidth 2-8 + lzwLitWidth = 8 +) + +func init() { + // Seed the random number generator + rand.Seed(time.Now().UnixNano()) + + // Add each private block + privateBlocks = make([]*net.IPNet, 3) + _, block, err := net.ParseCIDR("10.0.0.0/8") + if err != nil { + panic(fmt.Sprintf("Bad cidr. Got %v", err)) + } + privateBlocks[0] = block + + _, block, err = net.ParseCIDR("172.16.0.0/12") + if err != nil { + panic(fmt.Sprintf("Bad cidr. Got %v", err)) + } + privateBlocks[1] = block + + _, block, err = net.ParseCIDR("192.168.0.0/16") + if err != nil { + panic(fmt.Sprintf("Bad cidr. Got %v", err)) + } + privateBlocks[2] = block + + _, block, err = net.ParseCIDR("127.0.0.0/8") + if err != nil { + panic(fmt.Sprintf("Bad cidr. Got %v", err)) + } + loopbackBlock = block +} + +// Decode reverses the encode operation on a byte slice input +func decode(buf []byte, out interface{}) error { + r := bytes.NewReader(buf) + hd := codec.MsgpackHandle{} + dec := codec.NewDecoder(r, &hd) + return dec.Decode(out) +} + +// Encode writes an encoded object to a new bytes buffer +func encode(msgType messageType, in interface{}) (*bytes.Buffer, error) { + buf := bytes.NewBuffer(nil) + buf.WriteByte(uint8(msgType)) + hd := codec.MsgpackHandle{} + enc := codec.NewEncoder(buf, &hd) + err := enc.Encode(in) + return buf, err +} + +// Returns a random offset between 0 and n +func randomOffset(n int) int { + if n == 0 { + return 0 + } + return int(rand.Uint32() % uint32(n)) +} + +// suspicionTimeout computes the timeout that should be used when +// a node is suspected +func suspicionTimeout(suspicionMult, n int, interval time.Duration) time.Duration { + nodeScale := math.Ceil(math.Log10(float64(n + 1))) + timeout := time.Duration(suspicionMult) * time.Duration(nodeScale) * interval + return timeout +} + +// retransmitLimit computes the limit of retransmissions +func retransmitLimit(retransmitMult, n int) int { + nodeScale := math.Ceil(math.Log10(float64(n + 1))) + limit := retransmitMult * int(nodeScale) + return limit +} + +// shuffleNodes randomly shuffles the input nodes +func shuffleNodes(nodes []*nodeState) { + for i := range nodes { + j := rand.Intn(i + 1) + nodes[i], nodes[j] = nodes[j], nodes[i] + } +} + +// pushPushScale is used to scale the time interval at which push/pull +// syncs take place. It is used to prevent network saturation as the +// cluster size grows +func pushPullScale(interval time.Duration, n int) time.Duration { + // Don't scale until we cross the threshold + if n <= pushPullScaleThreshold { + return interval + } + + multiplier := math.Ceil(math.Log2(float64(n))-math.Log2(pushPullScaleThreshold)) + 1.0 + return time.Duration(multiplier) * interval +} + +// moveDeadNodes moves all the nodes in the dead state +// to the end of the slice and returns the index of the first dead node. +func moveDeadNodes(nodes []*nodeState) int { + numDead := 0 + n := len(nodes) + for i := 0; i < n-numDead; i++ { + if nodes[i].State != stateDead { + continue + } + + // Move this node to the end + nodes[i], nodes[n-numDead-1] = nodes[n-numDead-1], nodes[i] + numDead++ + i-- + } + return n - numDead +} + +// kRandomNodes is used to select up to k random nodes, excluding a given +// node and any non-alive nodes. It is possible that less than k nodes are returned. +func kRandomNodes(k int, excludes []string, nodes []*nodeState) []*nodeState { + n := len(nodes) + kNodes := make([]*nodeState, 0, k) +OUTER: + // Probe up to 3*n times, with large n this is not necessary + // since k << n, but with small n we want search to be + // exhaustive + for i := 0; i < 3*n && len(kNodes) < k; i++ { + // Get random node + idx := randomOffset(n) + node := nodes[idx] + + // Exclude node if match + for _, exclude := range excludes { + if node.Name == exclude { + continue OUTER + } + } + + // Exclude if not alive + if node.State != stateAlive { + continue + } + + // Check if we have this node already + for j := 0; j < len(kNodes); j++ { + if node == kNodes[j] { + continue OUTER + } + } + + // Append the node + kNodes = append(kNodes, node) + } + return kNodes +} + +// makeCompoundMessage takes a list of messages and generates +// a single compound message containing all of them +func makeCompoundMessage(msgs [][]byte) *bytes.Buffer { + // Create a local buffer + buf := bytes.NewBuffer(nil) + + // Write out the type + buf.WriteByte(uint8(compoundMsg)) + + // Write out the number of message + buf.WriteByte(uint8(len(msgs))) + + // Add the message lengths + for _, m := range msgs { + binary.Write(buf, binary.BigEndian, uint16(len(m))) + } + + // Append the messages + for _, m := range msgs { + buf.Write(m) + } + + return buf +} + +// decodeCompoundMessage splits a compound message and returns +// the slices of individual messages. Also returns the number +// of truncated messages and any potential error +func decodeCompoundMessage(buf []byte) (trunc int, parts [][]byte, err error) { + if len(buf) < 1 { + err = fmt.Errorf("missing compound length byte") + return + } + numParts := uint8(buf[0]) + buf = buf[1:] + + // Check we have enough bytes + if len(buf) < int(numParts*2) { + err = fmt.Errorf("truncated len slice") + return + } + + // Decode the lengths + lengths := make([]uint16, numParts) + for i := 0; i < int(numParts); i++ { + lengths[i] = binary.BigEndian.Uint16(buf[i*2 : i*2+2]) + } + buf = buf[numParts*2:] + + // Split each message + for idx, msgLen := range lengths { + if len(buf) < int(msgLen) { + trunc = int(numParts) - idx + return + } + + // Extract the slice, seek past on the buffer + slice := buf[:msgLen] + buf = buf[msgLen:] + parts = append(parts, slice) + } + return +} + +// Returns if the given IP is in a private block +func isPrivateIP(ip_str string) bool { + ip := net.ParseIP(ip_str) + for _, priv := range privateBlocks { + if priv.Contains(ip) { + return true + } + } + return false +} + +// Returns if the given IP is in a loopback block +func isLoopbackIP(ip_str string) bool { + ip := net.ParseIP(ip_str) + return loopbackBlock.Contains(ip) +} + +// compressPayload takes an opaque input buffer, compresses it +// and wraps it in a compress{} message that is encoded. +func compressPayload(inp []byte) (*bytes.Buffer, error) { + var buf bytes.Buffer + compressor := lzw.NewWriter(&buf, lzw.LSB, lzwLitWidth) + + _, err := compressor.Write(inp) + if err != nil { + return nil, err + } + + // Ensure we flush everything out + if err := compressor.Close(); err != nil { + return nil, err + } + + // Create a compressed message + c := compress{ + Algo: lzwAlgo, + Buf: buf.Bytes(), + } + return encode(compressMsg, &c) +} + +// decompressPayload is used to unpack an encoded compress{} +// message and return its payload uncompressed +func decompressPayload(msg []byte) ([]byte, error) { + // Decode the message + var c compress + if err := decode(msg, &c); err != nil { + return nil, err + } + return decompressBuffer(&c) +} + +// decompressBuffer is used to decompress the buffer of +// a single compress message, handling multiple algorithms +func decompressBuffer(c *compress) ([]byte, error) { + // Verify the algorithm + if c.Algo != lzwAlgo { + return nil, fmt.Errorf("Cannot decompress unknown algorithm %d", c.Algo) + } + + // Create a uncompressor + uncomp := lzw.NewReader(bytes.NewReader(c.Buf), lzw.LSB, lzwLitWidth) + defer uncomp.Close() + + // Read all the data + var b bytes.Buffer + _, err := io.Copy(&b, uncomp) + if err != nil { + return nil, err + } + + // Return the uncompressed bytes + return b.Bytes(), nil +} diff --git a/vendor/src/github.com/hashicorp/serf/LICENSE b/vendor/src/github.com/hashicorp/serf/LICENSE new file mode 100644 index 0000000000..c33dcc7c92 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/LICENSE @@ -0,0 +1,354 @@ +Mozilla Public License, version 2.0 + +1. Definitions + +1.1. “Contributor” + + means each individual or legal entity that creates, contributes to the + creation of, or owns Covered Software. + +1.2. “Contributor Version” + + means the combination of the Contributions of others (if any) used by a + Contributor and that particular Contributor’s Contribution. + +1.3. “Contribution” + + means Covered Software of a particular Contributor. + +1.4. “Covered Software” + + means Source Code Form to which the initial Contributor has attached the + notice in Exhibit A, the Executable Form of such Source Code Form, and + Modifications of such Source Code Form, in each case including portions + thereof. + +1.5. “Incompatible With Secondary Licenses” + means + + a. that the initial Contributor has attached the notice described in + Exhibit B to the Covered Software; or + + b. that the Covered Software was made available under the terms of version + 1.1 or earlier of the License, but not also under the terms of a + Secondary License. + +1.6. “Executable Form” + + means any form of the work other than Source Code Form. + +1.7. “Larger Work” + + means a work that combines Covered Software with other material, in a separate + file or files, that is not Covered Software. + +1.8. “License” + + means this document. + +1.9. “Licensable” + + means having the right to grant, to the maximum extent possible, whether at the + time of the initial grant or subsequently, any and all of the rights conveyed by + this License. + +1.10. “Modifications” + + means any of the following: + + a. any file in Source Code Form that results from an addition to, deletion + from, or modification of the contents of Covered Software; or + + b. any new file in Source Code Form that contains any Covered Software. + +1.11. “Patent Claims” of a Contributor + + means any patent claim(s), including without limitation, method, process, + and apparatus claims, in any patent Licensable by such Contributor that + would be infringed, but for the grant of the License, by the making, + using, selling, offering for sale, having made, import, or transfer of + either its Contributions or its Contributor Version. + +1.12. “Secondary License” + + means either the GNU General Public License, Version 2.0, the GNU Lesser + General Public License, Version 2.1, the GNU Affero General Public + License, Version 3.0, or any later versions of those licenses. + +1.13. “Source Code Form” + + means the form of the work preferred for making modifications. + +1.14. “You” (or “Your”) + + means an individual or a legal entity exercising rights under this + License. For legal entities, “You” includes any entity that controls, is + controlled by, or is under common control with You. For purposes of this + definition, “control” means (a) the power, direct or indirect, to cause + the direction or management of such entity, whether by contract or + otherwise, or (b) ownership of more than fifty percent (50%) of the + outstanding shares or beneficial ownership of such entity. + + +2. License Grants and Conditions + +2.1. Grants + + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + + a. under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or as + part of a Larger Work; and + + b. under Patent Claims of such Contributor to make, use, sell, offer for + sale, have made, import, and otherwise transfer either its Contributions + or its Contributor Version. + +2.2. Effective Date + + The licenses granted in Section 2.1 with respect to any Contribution become + effective for each Contribution on the date the Contributor first distributes + such Contribution. + +2.3. Limitations on Grant Scope + + The licenses granted in this Section 2 are the only rights granted under this + License. No additional rights or licenses will be implied from the distribution + or licensing of Covered Software under this License. Notwithstanding Section + 2.1(b) above, no patent license is granted by a Contributor: + + a. for any code that a Contributor has removed from Covered Software; or + + b. for infringements caused by: (i) Your and any other third party’s + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + + c. under Patent Claims infringed by Covered Software in the absence of its + Contributions. + + This License does not grant any rights in the trademarks, service marks, or + logos of any Contributor (except as may be necessary to comply with the + notice requirements in Section 3.4). + +2.4. Subsequent Licenses + + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this License + (see Section 10.2) or under the terms of a Secondary License (if permitted + under the terms of Section 3.3). + +2.5. Representation + + Each Contributor represents that the Contributor believes its Contributions + are its original creation(s) or it has sufficient rights to grant the + rights to its Contributions conveyed by this License. + +2.6. Fair Use + + This License is not intended to limit any rights You have under applicable + copyright doctrines of fair use, fair dealing, or other equivalents. + +2.7. Conditions + + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in + Section 2.1. + + +3. Responsibilities + +3.1. Distribution of Source Form + + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under the + terms of this License. You must inform recipients that the Source Code Form + of the Covered Software is governed by the terms of this License, and how + they can obtain a copy of this License. You may not attempt to alter or + restrict the recipients’ rights in the Source Code Form. + +3.2. Distribution of Executable Form + + If You distribute Covered Software in Executable Form then: + + a. such Covered Software must also be made available in Source Code Form, + as described in Section 3.1, and You must inform recipients of the + Executable Form how they can obtain a copy of such Source Code Form by + reasonable means in a timely manner, at a charge no more than the cost + of distribution to the recipient; and + + b. You may distribute such Executable Form under the terms of this License, + or sublicense it under different terms, provided that the license for + the Executable Form does not attempt to limit or alter the recipients’ + rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for the + Covered Software. If the Larger Work is a combination of Covered Software + with a work governed by one or more Secondary Licenses, and the Covered + Software is not Incompatible With Secondary Licenses, this License permits + You to additionally distribute such Covered Software under the terms of + such Secondary License(s), so that the recipient of the Larger Work may, at + their option, further distribute the Covered Software under the terms of + either this License or such Secondary License(s). + +3.4. Notices + + You may not remove or alter the substance of any license notices (including + copyright notices, patent notices, disclaimers of warranty, or limitations + of liability) contained within the Source Code Form of the Covered + Software, except that You may alter any license notices to the extent + required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on behalf + of any Contributor. You must make it absolutely clear that any such + warranty, support, indemnity, or liability obligation is offered by You + alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + +4. Inability to Comply Due to Statute or Regulation + + If it is impossible for You to comply with any of the terms of this License + with respect to some or all of the Covered Software due to statute, judicial + order, or regulation then You must: (a) comply with the terms of this License + to the maximum extent possible; and (b) describe the limitations and the code + they affect. Such description must be placed in a text file included with all + distributions of the Covered Software under this License. Except to the + extent prohibited by statute or regulation, such description must be + sufficiently detailed for a recipient of ordinary skill to be able to + understand it. + +5. Termination + +5.1. The rights granted under this License will terminate automatically if You + fail to comply with any of its terms. However, if You become compliant, + then the rights granted under this License from a particular Contributor + are reinstated (a) provisionally, unless and until such Contributor + explicitly and finally terminates Your grants, and (b) on an ongoing basis, + if such Contributor fails to notify You of the non-compliance by some + reasonable means prior to 60 days after You have come back into compliance. + Moreover, Your grants from a particular Contributor are reinstated on an + ongoing basis if such Contributor notifies You of the non-compliance by + some reasonable means, this is the first time You have received notice of + non-compliance with this License from such Contributor, and You become + compliant prior to 30 days after Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, counter-claims, + and cross-claims) alleging that a Contributor Version directly or + indirectly infringes any patent, then the rights granted to You by any and + all Contributors for the Covered Software under Section 2.1 of this License + shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user + license agreements (excluding distributors and resellers) which have been + validly granted by You or Your distributors under this License prior to + termination shall survive termination. + +6. Disclaimer of Warranty + + Covered Software is provided under this License on an “as is” basis, without + warranty of any kind, either expressed, implied, or statutory, including, + without limitation, warranties that the Covered Software is free of defects, + merchantable, fit for a particular purpose or non-infringing. The entire + risk as to the quality and performance of the Covered Software is with You. + Should any Covered Software prove defective in any respect, You (not any + Contributor) assume the cost of any necessary servicing, repair, or + correction. This disclaimer of warranty constitutes an essential part of this + License. No use of any Covered Software is authorized under this License + except under this disclaimer. + +7. Limitation of Liability + + Under no circumstances and under no legal theory, whether tort (including + negligence), contract, or otherwise, shall any Contributor, or anyone who + distributes Covered Software as permitted above, be liable to You for any + direct, indirect, special, incidental, or consequential damages of any + character including, without limitation, damages for lost profits, loss of + goodwill, work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses, even if such party shall have been + informed of the possibility of such damages. This limitation of liability + shall not apply to liability for death or personal injury resulting from such + party’s negligence to the extent applicable law prohibits such limitation. + Some jurisdictions do not allow the exclusion or limitation of incidental or + consequential damages, so this exclusion and limitation may not apply to You. + +8. Litigation + + Any litigation relating to this License may be brought only in the courts of + a jurisdiction where the defendant maintains its principal place of business + and such litigation shall be governed by laws of that jurisdiction, without + reference to its conflict-of-law provisions. Nothing in this Section shall + prevent a party’s ability to bring cross-claims or counter-claims. + +9. Miscellaneous + + This License represents the complete agreement concerning the subject matter + hereof. If any provision of this License is held to be unenforceable, such + provision shall be reformed only to the extent necessary to make it + enforceable. Any law or regulation which provides that the language of a + contract shall be construed against the drafter shall not be used to construe + this License against a Contributor. + + +10. Versions of the License + +10.1. New Versions + + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + +10.2. Effect of New Versions + + You may distribute the Covered Software under the terms of the version of + the License under which You originally received the Covered Software, or + under the terms of any subsequent version published by the license + steward. + +10.3. Modified Versions + + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a modified + version of this License if you rename the license and remove any + references to the name of the license steward (except to note that such + modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses + If You choose to distribute Source Code Form that is Incompatible With + Secondary Licenses under the terms of this version of the License, the + notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice + + This Source Code Form is subject to the + terms of the Mozilla Public License, v. + 2.0. If a copy of the MPL was not + distributed with this file, You can + obtain one at + http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular file, then +You may include the notice in a location (such as a LICENSE file in a relevant +directory) where a recipient would be likely to look for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - “Incompatible With Secondary Licenses” Notice + + This Source Code Form is “Incompatible + With Secondary Licenses”, as defined by + the Mozilla Public License, v. 2.0. + diff --git a/vendor/src/github.com/hashicorp/serf/serf/broadcast.go b/vendor/src/github.com/hashicorp/serf/serf/broadcast.go new file mode 100644 index 0000000000..d20728f3f4 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/broadcast.go @@ -0,0 +1,27 @@ +package serf + +import ( + "github.com/hashicorp/memberlist" +) + +// broadcast is an implementation of memberlist.Broadcast and is used +// to manage broadcasts across the memberlist channel that are related +// only to Serf. +type broadcast struct { + msg []byte + notify chan<- struct{} +} + +func (b *broadcast) Invalidates(other memberlist.Broadcast) bool { + return false +} + +func (b *broadcast) Message() []byte { + return b.msg +} + +func (b *broadcast) Finished() { + if b.notify != nil { + close(b.notify) + } +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/coalesce.go b/vendor/src/github.com/hashicorp/serf/serf/coalesce.go new file mode 100644 index 0000000000..567943be14 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/coalesce.go @@ -0,0 +1,80 @@ +package serf + +import ( + "time" +) + +// coalescer is a simple interface that must be implemented to be +// used inside of a coalesceLoop +type coalescer interface { + // Can the coalescer handle this event, if not it is + // directly passed through to the destination channel + Handle(Event) bool + + // Invoked to coalesce the given event + Coalesce(Event) + + // Invoked to flush the coalesced events + Flush(outChan chan<- Event) +} + +// coalescedEventCh returns an event channel where the events are coalesced +// using the given coalescer. +func coalescedEventCh(outCh chan<- Event, shutdownCh <-chan struct{}, + cPeriod time.Duration, qPeriod time.Duration, c coalescer) chan<- Event { + inCh := make(chan Event, 1024) + go coalesceLoop(inCh, outCh, shutdownCh, cPeriod, qPeriod, c) + return inCh +} + +// coalesceLoop is a simple long-running routine that manages the high-level +// flow of coalescing based on quiescence and a maximum quantum period. +func coalesceLoop(inCh <-chan Event, outCh chan<- Event, shutdownCh <-chan struct{}, + coalescePeriod time.Duration, quiescentPeriod time.Duration, c coalescer) { + var quiescent <-chan time.Time + var quantum <-chan time.Time + shutdown := false + +INGEST: + // Reset the timers + quantum = nil + quiescent = nil + + for { + select { + case e := <-inCh: + // Ignore any non handled events + if !c.Handle(e) { + outCh <- e + continue + } + + // Start a new quantum if we need to + // and restart the quiescent timer + if quantum == nil { + quantum = time.After(coalescePeriod) + } + quiescent = time.After(quiescentPeriod) + + // Coalesce the event + c.Coalesce(e) + + case <-quantum: + goto FLUSH + case <-quiescent: + goto FLUSH + case <-shutdownCh: + shutdown = true + goto FLUSH + } + } + +FLUSH: + // Flush the coalesced events + c.Flush(outCh) + + // Restart ingestion if we are not done + if !shutdown { + goto INGEST + } +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/coalesce_member.go b/vendor/src/github.com/hashicorp/serf/serf/coalesce_member.go new file mode 100644 index 0000000000..82fdb8dacf --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/coalesce_member.go @@ -0,0 +1,68 @@ +package serf + +type coalesceEvent struct { + Type EventType + Member *Member +} + +type memberEventCoalescer struct { + lastEvents map[string]EventType + latestEvents map[string]coalesceEvent +} + +func (c *memberEventCoalescer) Handle(e Event) bool { + switch e.EventType() { + case EventMemberJoin: + return true + case EventMemberLeave: + return true + case EventMemberFailed: + return true + case EventMemberUpdate: + return true + case EventMemberReap: + return true + default: + return false + } +} + +func (c *memberEventCoalescer) Coalesce(raw Event) { + e := raw.(MemberEvent) + for _, m := range e.Members { + c.latestEvents[m.Name] = coalesceEvent{ + Type: e.Type, + Member: &m, + } + } +} + +func (c *memberEventCoalescer) Flush(outCh chan<- Event) { + // Coalesce the various events we got into a single set of events. + events := make(map[EventType]*MemberEvent) + for name, cevent := range c.latestEvents { + previous, ok := c.lastEvents[name] + + // If we sent the same event before, then ignore + // unless it is a MemberUpdate + if ok && previous == cevent.Type && cevent.Type != EventMemberUpdate { + continue + } + + // Update our last event + c.lastEvents[name] = cevent.Type + + // Add it to our event + newEvent, ok := events[cevent.Type] + if !ok { + newEvent = &MemberEvent{Type: cevent.Type} + events[cevent.Type] = newEvent + } + newEvent.Members = append(newEvent.Members, *cevent.Member) + } + + // Send out those events + for _, event := range events { + outCh <- *event + } +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/coalesce_user.go b/vendor/src/github.com/hashicorp/serf/serf/coalesce_user.go new file mode 100644 index 0000000000..1551b6c52c --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/coalesce_user.go @@ -0,0 +1,52 @@ +package serf + +type latestUserEvents struct { + LTime LamportTime + Events []Event +} + +type userEventCoalescer struct { + // Maps an event name into the latest versions + events map[string]*latestUserEvents +} + +func (c *userEventCoalescer) Handle(e Event) bool { + // Only handle EventUser messages + if e.EventType() != EventUser { + return false + } + + // Check if coalescing is enabled + user := e.(UserEvent) + return user.Coalesce +} + +func (c *userEventCoalescer) Coalesce(e Event) { + user := e.(UserEvent) + latest, ok := c.events[user.Name] + + // Create a new entry if there are none, or + // if this message has the newest LTime + if !ok || latest.LTime < user.LTime { + latest = &latestUserEvents{ + LTime: user.LTime, + Events: []Event{e}, + } + c.events[user.Name] = latest + return + } + + // If the the same age, save it + if latest.LTime == user.LTime { + latest.Events = append(latest.Events, e) + } +} + +func (c *userEventCoalescer) Flush(outChan chan<- Event) { + for _, latest := range c.events { + for _, e := range latest.Events { + outChan <- e + } + } + c.events = make(map[string]*latestUserEvents) +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/config.go b/vendor/src/github.com/hashicorp/serf/serf/config.go new file mode 100644 index 0000000000..e2a43f549f --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/config.go @@ -0,0 +1,234 @@ +package serf + +import ( + "io" + "os" + "time" + + "github.com/hashicorp/memberlist" +) + +// ProtocolVersionMap is the mapping of Serf delegate protocol versions +// to memberlist protocol versions. We mask the memberlist protocols using +// our own protocol version. +var ProtocolVersionMap map[uint8]uint8 + +func init() { + ProtocolVersionMap = map[uint8]uint8{ + 4: 2, + 3: 2, + 2: 2, + } +} + +// Config is the configuration for creating a Serf instance. +type Config struct { + // The name of this node. This must be unique in the cluster. If this + // is not set, Serf will set it to the hostname of the running machine. + NodeName string + + // The tags for this role, if any. This is used to provide arbitrary + // key/value metadata per-node. For example, a "role" tag may be used to + // differentiate "load-balancer" from a "web" role as parts of the same cluster. + // Tags are deprecating 'Role', and instead it acts as a special key in this + // map. + Tags map[string]string + + // EventCh is a channel that receives all the Serf events. The events + // are sent on this channel in proper ordering. Care must be taken that + // this channel doesn't block, either by processing the events quick + // enough or buffering the channel, otherwise it can block state updates + // within Serf itself. If no EventCh is specified, no events will be fired, + // but point-in-time snapshots of members can still be retrieved by + // calling Members on Serf. + EventCh chan<- Event + + // ProtocolVersion is the protocol version to speak. This must be between + // ProtocolVersionMin and ProtocolVersionMax. + ProtocolVersion uint8 + + // BroadcastTimeout is the amount of time to wait for a broadcast + // message to be sent to the cluster. Broadcast messages are used for + // things like leave messages and force remove messages. If this is not + // set, a timeout of 5 seconds will be set. + BroadcastTimeout time.Duration + + // The settings below relate to Serf's event coalescence feature. Serf + // is able to coalesce multiple events into single events in order to + // reduce the amount of noise that is sent along the EventCh. For example + // if five nodes quickly join, the EventCh will be sent one EventMemberJoin + // containing the five nodes rather than five individual EventMemberJoin + // events. Coalescence can mitigate potential flapping behavior. + // + // Coalescence is disabled by default and can be enabled by setting + // CoalescePeriod. + // + // CoalescePeriod specifies the time duration to coalesce events. + // For example, if this is set to 5 seconds, then all events received + // within 5 seconds that can be coalesced will be. + // + // QuiescentPeriod specifies the duration of time where if no events + // are received, coalescence immediately happens. For example, if + // CoalscePeriod is set to 10 seconds but QuiscentPeriod is set to 2 + // seconds, then the events will be coalesced and dispatched if no + // new events are received within 2 seconds of the last event. Otherwise, + // every event will always be delayed by at least 10 seconds. + CoalescePeriod time.Duration + QuiescentPeriod time.Duration + + // The settings below relate to Serf's user event coalescing feature. + // The settings operate like above but only affect user messages and + // not the Member* messages that Serf generates. + UserCoalescePeriod time.Duration + UserQuiescentPeriod time.Duration + + // The settings below relate to Serf keeping track of recently + // failed/left nodes and attempting reconnects. + // + // ReapInterval is the interval when the reaper runs. If this is not + // set (it is zero), it will be set to a reasonable default. + // + // ReconnectInterval is the interval when we attempt to reconnect + // to failed nodes. If this is not set (it is zero), it will be set + // to a reasonable default. + // + // ReconnectTimeout is the amount of time to attempt to reconnect to + // a failed node before giving up and considering it completely gone. + // + // TombstoneTimeout is the amount of time to keep around nodes + // that gracefully left as tombstones for syncing state with other + // Serf nodes. + ReapInterval time.Duration + ReconnectInterval time.Duration + ReconnectTimeout time.Duration + TombstoneTimeout time.Duration + + // QueueDepthWarning is used to generate warning message if the + // number of queued messages to broadcast exceeds this number. This + // is to provide the user feedback if events are being triggered + // faster than they can be disseminated + QueueDepthWarning int + + // MaxQueueDepth is used to start dropping messages if the number + // of queued messages to broadcast exceeds this number. This is to + // prevent an unbounded growth of memory utilization + MaxQueueDepth int + + // RecentIntentBuffer is used to set the size of recent join and leave intent + // messages that will be buffered. This is used to guard against + // the case where Serf broadcasts an intent that arrives before the + // Memberlist event. It is important that this not be too small to avoid + // continuous rebroadcasting of dead events. + RecentIntentBuffer int + + // EventBuffer is used to control how many events are buffered. + // This is used to prevent re-delivery of events to a client. The buffer + // must be large enough to handle all "recent" events, since Serf will + // not deliver messages that are older than the oldest entry in the buffer. + // Thus if a client is generating too many events, it's possible that the + // buffer gets overrun and messages are not delivered. + EventBuffer int + + // QueryBuffer is used to control how many queries are buffered. + // This is used to prevent re-delivery of queries to a client. The buffer + // must be large enough to handle all "recent" events, since Serf will not + // deliver queries older than the oldest entry in the buffer. + // Thus if a client is generating too many queries, it's possible that the + // buffer gets overrun and messages are not delivered. + QueryBuffer int + + // QueryTimeoutMult configures the default timeout multipler for a query to run if no + // specific value is provided. Queries are real-time by nature, where the + // reply is time sensitive. As a result, results are collected in an async + // fashion, however the query must have a bounded duration. We want the timeout + // to be long enough that all nodes have time to receive the message, run a handler, + // and generate a reply. Once the timeout is exceeded, any further replies are ignored. + // The default value is + // + // Timeout = GossipInterval * QueryTimeoutMult * log(N+1) + // + QueryTimeoutMult int + + // MemberlistConfig is the memberlist configuration that Serf will + // use to do the underlying membership management and gossip. Some + // fields in the MemberlistConfig will be overwritten by Serf no + // matter what: + // + // * Name - This will always be set to the same as the NodeName + // in this configuration. + // + // * Events - Serf uses a custom event delegate. + // + // * Delegate - Serf uses a custom delegate. + // + MemberlistConfig *memberlist.Config + + // LogOutput is the location to write logs to. If this is not set, + // logs will go to stderr. + LogOutput io.Writer + + // SnapshotPath if provided is used to snapshot live nodes as well + // as lamport clock values. When Serf is started with a snapshot, + // it will attempt to join all the previously known nodes until one + // succeeds and will also avoid replaying old user events. + SnapshotPath string + + // RejoinAfterLeave controls our interaction with the snapshot file. + // When set to false (default), a leave causes a Serf to not rejoin + // the cluster until an explicit join is received. If this is set to + // true, we ignore the leave, and rejoin the cluster on start. + RejoinAfterLeave bool + + // EnableNameConflictResolution controls if Serf will actively attempt + // to resolve a name conflict. Since each Serf member must have a unique + // name, a cluster can run into issues if multiple nodes claim the same + // name. Without automatic resolution, Serf merely logs some warnings, but + // otherwise does not take any action. Automatic resolution detects the + // conflict and issues a special query which asks the cluster for the + // Name -> IP:Port mapping. If there is a simple majority of votes, that + // node stays while the other node will leave the cluster and exit. + EnableNameConflictResolution bool + + // KeyringFile provides the location of a writable file where Serf can + // persist changes to the encryption keyring. + KeyringFile string + + // Merge can be optionally provided to intercept a cluster merge + // and conditionally abort the merge. + Merge MergeDelegate +} + +// Init allocates the subdata structures +func (c *Config) Init() { + if c.Tags == nil { + c.Tags = make(map[string]string) + } +} + +// DefaultConfig returns a Config struct that contains reasonable defaults +// for most of the configurations. +func DefaultConfig() *Config { + hostname, err := os.Hostname() + if err != nil { + panic(err) + } + + return &Config{ + NodeName: hostname, + BroadcastTimeout: 5 * time.Second, + EventBuffer: 512, + QueryBuffer: 512, + LogOutput: os.Stderr, + ProtocolVersion: ProtocolVersionMax, + ReapInterval: 15 * time.Second, + RecentIntentBuffer: 128, + ReconnectInterval: 30 * time.Second, + ReconnectTimeout: 24 * time.Hour, + QueueDepthWarning: 128, + MaxQueueDepth: 4096, + TombstoneTimeout: 24 * time.Hour, + MemberlistConfig: memberlist.DefaultLANConfig(), + QueryTimeoutMult: 16, + EnableNameConflictResolution: true, + } +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/conflict_delegate.go b/vendor/src/github.com/hashicorp/serf/serf/conflict_delegate.go new file mode 100644 index 0000000000..65a50156c0 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/conflict_delegate.go @@ -0,0 +1,13 @@ +package serf + +import ( + "github.com/hashicorp/memberlist" +) + +type conflictDelegate struct { + serf *Serf +} + +func (c *conflictDelegate) NotifyConflict(existing, other *memberlist.Node) { + c.serf.handleNodeConflict(existing, other) +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/delegate.go b/vendor/src/github.com/hashicorp/serf/serf/delegate.go new file mode 100644 index 0000000000..4ffedbd3d0 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/delegate.go @@ -0,0 +1,247 @@ +package serf + +import ( + "fmt" + "github.com/armon/go-metrics" +) + +// delegate is the memberlist.Delegate implementation that Serf uses. +type delegate struct { + serf *Serf +} + +func (d *delegate) NodeMeta(limit int) []byte { + roleBytes := d.serf.encodeTags(d.serf.config.Tags) + if len(roleBytes) > limit { + panic(fmt.Errorf("Node tags '%v' exceeds length limit of %d bytes", d.serf.config.Tags, limit)) + } + + return roleBytes +} + +func (d *delegate) NotifyMsg(buf []byte) { + // If we didn't actually receive any data, then ignore it. + if len(buf) == 0 { + return + } + metrics.AddSample([]string{"serf", "msgs", "received"}, float32(len(buf))) + + rebroadcast := false + rebroadcastQueue := d.serf.broadcasts + t := messageType(buf[0]) + switch t { + case messageLeaveType: + var leave messageLeave + if err := decodeMessage(buf[1:], &leave); err != nil { + d.serf.logger.Printf("[ERR] serf: Error decoding leave message: %s", err) + break + } + + d.serf.logger.Printf("[DEBUG] serf: messageLeaveType: %s", leave.Node) + rebroadcast = d.serf.handleNodeLeaveIntent(&leave) + + case messageJoinType: + var join messageJoin + if err := decodeMessage(buf[1:], &join); err != nil { + d.serf.logger.Printf("[ERR] serf: Error decoding join message: %s", err) + break + } + + d.serf.logger.Printf("[DEBUG] serf: messageJoinType: %s", join.Node) + rebroadcast = d.serf.handleNodeJoinIntent(&join) + + case messageUserEventType: + var event messageUserEvent + if err := decodeMessage(buf[1:], &event); err != nil { + d.serf.logger.Printf("[ERR] serf: Error decoding user event message: %s", err) + break + } + + d.serf.logger.Printf("[DEBUG] serf: messageUserEventType: %s", event.Name) + rebroadcast = d.serf.handleUserEvent(&event) + rebroadcastQueue = d.serf.eventBroadcasts + + case messageQueryType: + var query messageQuery + if err := decodeMessage(buf[1:], &query); err != nil { + d.serf.logger.Printf("[ERR] serf: Error decoding query message: %s", err) + break + } + + d.serf.logger.Printf("[DEBUG] serf: messageQueryType: %s", query.Name) + rebroadcast = d.serf.handleQuery(&query) + rebroadcastQueue = d.serf.queryBroadcasts + + case messageQueryResponseType: + var resp messageQueryResponse + if err := decodeMessage(buf[1:], &resp); err != nil { + d.serf.logger.Printf("[ERR] serf: Error decoding query response message: %s", err) + break + } + + d.serf.logger.Printf("[DEBUG] serf: messageQueryResponseType: %v", resp.From) + d.serf.handleQueryResponse(&resp) + + default: + d.serf.logger.Printf("[WARN] serf: Received message of unknown type: %d", t) + } + + if rebroadcast { + // Copy the buffer since it we cannot rely on the slice not changing + newBuf := make([]byte, len(buf)) + copy(newBuf, buf) + + rebroadcastQueue.QueueBroadcast(&broadcast{ + msg: newBuf, + notify: nil, + }) + } +} + +func (d *delegate) GetBroadcasts(overhead, limit int) [][]byte { + msgs := d.serf.broadcasts.GetBroadcasts(overhead, limit) + + // Determine the bytes used already + bytesUsed := 0 + for _, msg := range msgs { + lm := len(msg) + bytesUsed += lm + overhead + metrics.AddSample([]string{"serf", "msgs", "sent"}, float32(lm)) + } + + // Get any additional query broadcasts + queryMsgs := d.serf.queryBroadcasts.GetBroadcasts(overhead, limit-bytesUsed) + if queryMsgs != nil { + for _, m := range queryMsgs { + lm := len(m) + bytesUsed += lm + overhead + metrics.AddSample([]string{"serf", "msgs", "sent"}, float32(lm)) + } + msgs = append(msgs, queryMsgs...) + } + + // Get any additional event broadcasts + eventMsgs := d.serf.eventBroadcasts.GetBroadcasts(overhead, limit-bytesUsed) + if eventMsgs != nil { + for _, m := range eventMsgs { + lm := len(m) + bytesUsed += lm + overhead + metrics.AddSample([]string{"serf", "msgs", "sent"}, float32(lm)) + } + msgs = append(msgs, eventMsgs...) + } + + return msgs +} + +func (d *delegate) LocalState(join bool) []byte { + d.serf.memberLock.RLock() + defer d.serf.memberLock.RUnlock() + d.serf.eventLock.RLock() + defer d.serf.eventLock.RUnlock() + + // Create the message to send + pp := messagePushPull{ + LTime: d.serf.clock.Time(), + StatusLTimes: make(map[string]LamportTime, len(d.serf.members)), + LeftMembers: make([]string, 0, len(d.serf.leftMembers)), + EventLTime: d.serf.eventClock.Time(), + Events: d.serf.eventBuffer, + QueryLTime: d.serf.queryClock.Time(), + } + + // Add all the join LTimes + for name, member := range d.serf.members { + pp.StatusLTimes[name] = member.statusLTime + } + + // Add all the left nodes + for _, member := range d.serf.leftMembers { + pp.LeftMembers = append(pp.LeftMembers, member.Name) + } + + // Encode the push pull state + buf, err := encodeMessage(messagePushPullType, &pp) + if err != nil { + d.serf.logger.Printf("[ERR] serf: Failed to encode local state: %v", err) + return nil + } + return buf +} + +func (d *delegate) MergeRemoteState(buf []byte, isJoin bool) { + // Check the message type + if messageType(buf[0]) != messagePushPullType { + d.serf.logger.Printf("[ERR] serf: Remote state has bad type prefix: %v", buf[0]) + return + } + + // Attempt a decode + pp := messagePushPull{} + if err := decodeMessage(buf[1:], &pp); err != nil { + d.serf.logger.Printf("[ERR] serf: Failed to decode remote state: %v", err) + return + } + + // Witness the Lamport clocks first. + // We subtract 1 since no message with that clock has been sent yet + if pp.LTime > 0 { + d.serf.clock.Witness(pp.LTime - 1) + } + if pp.EventLTime > 0 { + d.serf.eventClock.Witness(pp.EventLTime - 1) + } + if pp.QueryLTime > 0 { + d.serf.queryClock.Witness(pp.QueryLTime - 1) + } + + // Process the left nodes first to avoid the LTimes from being increment + // in the wrong order + leftMap := make(map[string]struct{}, len(pp.LeftMembers)) + leave := messageLeave{} + for _, name := range pp.LeftMembers { + leftMap[name] = struct{}{} + leave.LTime = pp.StatusLTimes[name] + leave.Node = name + d.serf.handleNodeLeaveIntent(&leave) + } + + // Update any other LTimes + join := messageJoin{} + for name, statusLTime := range pp.StatusLTimes { + // Skip the left nodes + if _, ok := leftMap[name]; ok { + continue + } + + // Create an artificial join message + join.LTime = statusLTime + join.Node = name + d.serf.handleNodeJoinIntent(&join) + } + + // If we are doing a join, and eventJoinIgnore is set + // then we set the eventMinTime to the EventLTime. This + // prevents any of the incoming events from being processed + if isJoin && d.serf.eventJoinIgnore { + d.serf.eventLock.Lock() + if pp.EventLTime > d.serf.eventMinTime { + d.serf.eventMinTime = pp.EventLTime + } + d.serf.eventLock.Unlock() + } + + // Process all the events + userEvent := messageUserEvent{} + for _, events := range pp.Events { + if events == nil { + continue + } + userEvent.LTime = events.LTime + for _, e := range events.Events { + userEvent.Name = e.Name + userEvent.Payload = e.Payload + d.serf.handleUserEvent(&userEvent) + } + } +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/event.go b/vendor/src/github.com/hashicorp/serf/serf/event.go new file mode 100644 index 0000000000..5c6ff740e2 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/event.go @@ -0,0 +1,168 @@ +package serf + +import ( + "fmt" + "net" + "sync" + "time" +) + +// EventType are all the types of events that may occur and be sent +// along the Serf channel. +type EventType int + +const ( + EventMemberJoin EventType = iota + EventMemberLeave + EventMemberFailed + EventMemberUpdate + EventMemberReap + EventUser + EventQuery +) + +func (t EventType) String() string { + switch t { + case EventMemberJoin: + return "member-join" + case EventMemberLeave: + return "member-leave" + case EventMemberFailed: + return "member-failed" + case EventMemberUpdate: + return "member-update" + case EventMemberReap: + return "member-reap" + case EventUser: + return "user" + case EventQuery: + return "query" + default: + panic(fmt.Sprintf("unknown event type: %d", t)) + } +} + +// Event is a generic interface for exposing Serf events +// Clients will usually need to use a type switches to get +// to a more useful type +type Event interface { + EventType() EventType + String() string +} + +// MemberEvent is the struct used for member related events +// Because Serf coalesces events, an event may contain multiple members. +type MemberEvent struct { + Type EventType + Members []Member +} + +func (m MemberEvent) EventType() EventType { + return m.Type +} + +func (m MemberEvent) String() string { + switch m.Type { + case EventMemberJoin: + return "member-join" + case EventMemberLeave: + return "member-leave" + case EventMemberFailed: + return "member-failed" + case EventMemberUpdate: + return "member-update" + case EventMemberReap: + return "member-reap" + default: + panic(fmt.Sprintf("unknown event type: %d", m.Type)) + } +} + +// UserEvent is the struct used for events that are triggered +// by the user and are not related to members +type UserEvent struct { + LTime LamportTime + Name string + Payload []byte + Coalesce bool +} + +func (u UserEvent) EventType() EventType { + return EventUser +} + +func (u UserEvent) String() string { + return fmt.Sprintf("user-event: %s", u.Name) +} + +// Query is the struct used EventQuery type events +type Query struct { + LTime LamportTime + Name string + Payload []byte + + serf *Serf + id uint32 // ID is not exported, since it may change + addr []byte // Address to respond to + port uint16 // Port to respond to + deadline time.Time // Must respond by this deadline + respLock sync.Mutex +} + +func (q *Query) EventType() EventType { + return EventQuery +} + +func (q *Query) String() string { + return fmt.Sprintf("query: %s", q.Name) +} + +// Deadline returns the time by which a response must be sent +func (q *Query) Deadline() time.Time { + return q.deadline +} + +// Respond is used to send a response to the user query +func (q *Query) Respond(buf []byte) error { + q.respLock.Lock() + defer q.respLock.Unlock() + + // Check if we've already responded + if q.deadline.IsZero() { + return fmt.Errorf("Response already sent") + } + + // Ensure we aren't past our response deadline + if time.Now().After(q.deadline) { + return fmt.Errorf("Response is past the deadline") + } + + // Create response + resp := messageQueryResponse{ + LTime: q.LTime, + ID: q.id, + From: q.serf.config.NodeName, + Payload: buf, + } + + // Format the response + raw, err := encodeMessage(messageQueryResponseType, &resp) + if err != nil { + return fmt.Errorf("Failed to format response: %v", err) + } + + // Check the size limit + if len(raw) > QueryResponseSizeLimit { + return fmt.Errorf("response exceeds limit of %d bytes", QueryResponseSizeLimit) + } + + // Send the response + addr := net.UDPAddr{IP: q.addr, Port: int(q.port)} + if err := q.serf.memberlist.SendTo(&addr, raw); err != nil { + return err + } + + // Clera the deadline, response sent + q.deadline = time.Time{} + return nil +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/event_delegate.go b/vendor/src/github.com/hashicorp/serf/serf/event_delegate.go new file mode 100644 index 0000000000..e201322819 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/event_delegate.go @@ -0,0 +1,21 @@ +package serf + +import ( + "github.com/hashicorp/memberlist" +) + +type eventDelegate struct { + serf *Serf +} + +func (e *eventDelegate) NotifyJoin(n *memberlist.Node) { + e.serf.handleNodeJoin(n) +} + +func (e *eventDelegate) NotifyLeave(n *memberlist.Node) { + e.serf.handleNodeLeave(n) +} + +func (e *eventDelegate) NotifyUpdate(n *memberlist.Node) { + e.serf.handleNodeUpdate(n) +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/internal_query.go b/vendor/src/github.com/hashicorp/serf/serf/internal_query.go new file mode 100644 index 0000000000..128b2cf214 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/internal_query.go @@ -0,0 +1,312 @@ +package serf + +import ( + "encoding/base64" + "log" + "strings" +) + +const ( + // This is the prefix we use for queries that are internal to Serf. + // They are handled internally, and not forwarded to a client. + InternalQueryPrefix = "_serf_" + + // pingQuery is run to check for reachability + pingQuery = "ping" + + // conflictQuery is run to resolve a name conflict + conflictQuery = "conflict" + + // installKeyQuery is used to install a new key + installKeyQuery = "install-key" + + // useKeyQuery is used to change the primary encryption key + useKeyQuery = "use-key" + + // removeKeyQuery is used to remove a key from the keyring + removeKeyQuery = "remove-key" + + // listKeysQuery is used to list all known keys in the cluster + listKeysQuery = "list-keys" +) + +// internalQueryName is used to generate a query name for an internal query +func internalQueryName(name string) string { + return InternalQueryPrefix + name +} + +// serfQueries is used to listen for queries that start with +// _serf and respond to them as appropriate. +type serfQueries struct { + inCh chan Event + logger *log.Logger + outCh chan<- Event + serf *Serf + shutdownCh <-chan struct{} +} + +// nodeKeyResponse is used to store the result from an individual node while +// replying to key modification queries +type nodeKeyResponse struct { + // Result indicates true/false if there were errors or not + Result bool + + // Message contains error messages or other information + Message string + + // Keys is used in listing queries to relay a list of installed keys + Keys []string +} + +// newSerfQueries is used to create a new serfQueries. We return an event +// channel that is ingested and forwarded to an outCh. Any Queries that +// have the InternalQueryPrefix are handled instead of forwarded. +func newSerfQueries(serf *Serf, logger *log.Logger, outCh chan<- Event, shutdownCh <-chan struct{}) (chan<- Event, error) { + inCh := make(chan Event, 1024) + q := &serfQueries{ + inCh: inCh, + logger: logger, + outCh: outCh, + serf: serf, + shutdownCh: shutdownCh, + } + go q.stream() + return inCh, nil +} + +// stream is a long running routine to ingest the event stream +func (s *serfQueries) stream() { + for { + select { + case e := <-s.inCh: + // Check if this is a query we should process + if q, ok := e.(*Query); ok && strings.HasPrefix(q.Name, InternalQueryPrefix) { + go s.handleQuery(q) + + } else if s.outCh != nil { + s.outCh <- e + } + + case <-s.shutdownCh: + return + } + } +} + +// handleQuery is invoked when we get an internal query +func (s *serfQueries) handleQuery(q *Query) { + // Get the queryName after the initial prefix + queryName := q.Name[len(InternalQueryPrefix):] + switch queryName { + case pingQuery: + // Nothing to do, we will ack the query + case conflictQuery: + s.handleConflict(q) + case installKeyQuery: + s.handleInstallKey(q) + case useKeyQuery: + s.handleUseKey(q) + case removeKeyQuery: + s.handleRemoveKey(q) + case listKeysQuery: + s.handleListKeys(q) + default: + s.logger.Printf("[WARN] serf: Unhandled internal query '%s'", queryName) + } +} + +// handleConflict is invoked when we get a query that is attempting to +// disambiguate a name conflict. They payload is a node name, and the response +// should the address we believe that node is at, if any. +func (s *serfQueries) handleConflict(q *Query) { + // The target node name is the payload + node := string(q.Payload) + + // Do not respond to the query if it is about us + if node == s.serf.config.NodeName { + return + } + s.logger.Printf("[DEBUG] serf: Got conflict resolution query for '%s'", node) + + // Look for the member info + var out *Member + s.serf.memberLock.Lock() + if member, ok := s.serf.members[node]; ok { + out = &member.Member + } + s.serf.memberLock.Unlock() + + // Encode the response + buf, err := encodeMessage(messageConflictResponseType, out) + if err != nil { + s.logger.Printf("[ERR] serf: Failed to encode conflict query response: %v", err) + return + } + + // Send our answer + if err := q.Respond(buf); err != nil { + s.logger.Printf("[ERR] serf: Failed to respond to conflict query: %v", err) + } +} + +// sendKeyResponse handles responding to key-related queries. +func (s *serfQueries) sendKeyResponse(q *Query, resp *nodeKeyResponse) { + buf, err := encodeMessage(messageKeyResponseType, resp) + if err != nil { + s.logger.Printf("[ERR] serf: Failed to encode key response: %v", err) + return + } + + if err := q.Respond(buf); err != nil { + s.logger.Printf("[ERR] serf: Failed to respond to key query: %v", err) + return + } +} + +// handleInstallKey is invoked whenever a new encryption key is received from +// another member in the cluster, and handles the process of installing it onto +// the memberlist keyring. This type of query may fail if the provided key does +// not fit the constraints that memberlist enforces. If the query fails, the +// response will contain the error message so that it may be relayed. +func (s *serfQueries) handleInstallKey(q *Query) { + response := nodeKeyResponse{Result: false} + keyring := s.serf.config.MemberlistConfig.Keyring + req := keyRequest{} + + err := decodeMessage(q.Payload[1:], &req) + if err != nil { + s.logger.Printf("[ERR] serf: Failed to decode key request: %v", err) + goto SEND + } + + if !s.serf.EncryptionEnabled() { + response.Message = "No keyring to modify (encryption not enabled)" + s.logger.Printf("[ERR] serf: No keyring to modify (encryption not enabled)") + goto SEND + } + + s.logger.Printf("[INFO] serf: Received install-key query") + if err := keyring.AddKey(req.Key); err != nil { + response.Message = err.Error() + s.logger.Printf("[ERR] serf: Failed to install key: %s", err) + goto SEND + } + + if err := s.serf.writeKeyringFile(); err != nil { + response.Message = err.Error() + s.logger.Printf("[ERR] serf: Failed to write keyring file: %s", err) + goto SEND + } + + response.Result = true + +SEND: + s.sendKeyResponse(q, &response) +} + +// handleUseKey is invoked whenever a query is received to mark a different key +// in the internal keyring as the primary key. This type of query may fail due +// to operator error (requested key not in ring), and thus sends error messages +// back in the response. +func (s *serfQueries) handleUseKey(q *Query) { + response := nodeKeyResponse{Result: false} + keyring := s.serf.config.MemberlistConfig.Keyring + req := keyRequest{} + + err := decodeMessage(q.Payload[1:], &req) + if err != nil { + s.logger.Printf("[ERR] serf: Failed to decode key request: %v", err) + goto SEND + } + + if !s.serf.EncryptionEnabled() { + response.Message = "No keyring to modify (encryption not enabled)" + s.logger.Printf("[ERR] serf: No keyring to modify (encryption not enabled)") + goto SEND + } + + s.logger.Printf("[INFO] serf: Received use-key query") + if err := keyring.UseKey(req.Key); err != nil { + response.Message = err.Error() + s.logger.Printf("[ERR] serf: Failed to change primary key: %s", err) + goto SEND + } + + if err := s.serf.writeKeyringFile(); err != nil { + response.Message = err.Error() + s.logger.Printf("[ERR] serf: Failed to write keyring file: %s", err) + goto SEND + } + + response.Result = true + +SEND: + s.sendKeyResponse(q, &response) +} + +// handleRemoveKey is invoked when a query is received to remove a particular +// key from the keyring. This type of query can fail if the key requested for +// deletion is currently the primary key in the keyring, so therefore it will +// reply to the query with any relevant errors from the operation. +func (s *serfQueries) handleRemoveKey(q *Query) { + response := nodeKeyResponse{Result: false} + keyring := s.serf.config.MemberlistConfig.Keyring + req := keyRequest{} + + err := decodeMessage(q.Payload[1:], &req) + if err != nil { + s.logger.Printf("[ERR] serf: Failed to decode key request: %v", err) + goto SEND + } + + if !s.serf.EncryptionEnabled() { + response.Message = "No keyring to modify (encryption not enabled)" + s.logger.Printf("[ERR] serf: No keyring to modify (encryption not enabled)") + goto SEND + } + + s.logger.Printf("[INFO] serf: Received remove-key query") + if err := keyring.RemoveKey(req.Key); err != nil { + response.Message = err.Error() + s.logger.Printf("[ERR] serf: Failed to remove key: %s", err) + goto SEND + } + + if err := s.serf.writeKeyringFile(); err != nil { + response.Message = err.Error() + s.logger.Printf("[ERR] serf: Failed to write keyring file: %s", err) + goto SEND + } + + response.Result = true + +SEND: + s.sendKeyResponse(q, &response) +} + +// handleListKeys is invoked when a query is received to return a list of all +// installed keys the Serf instance knows of. For performance, the keys are +// encoded to base64 on each of the members to remove this burden from the +// node asking for the results. +func (s *serfQueries) handleListKeys(q *Query) { + response := nodeKeyResponse{Result: false} + keyring := s.serf.config.MemberlistConfig.Keyring + + if !s.serf.EncryptionEnabled() { + response.Message = "Keyring is empty (encryption not enabled)" + s.logger.Printf("[ERR] serf: Keyring is empty (encryption not enabled)") + goto SEND + } + + s.logger.Printf("[INFO] serf: Received list-keys query") + for _, keyBytes := range keyring.GetKeys() { + // Encode the keys before sending the response. This should help take + // some the burden of doing this off of the asking member. + key := base64.StdEncoding.EncodeToString(keyBytes) + response.Keys = append(response.Keys, key) + } + response.Result = true + +SEND: + s.sendKeyResponse(q, &response) +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/keymanager.go b/vendor/src/github.com/hashicorp/serf/serf/keymanager.go new file mode 100644 index 0000000000..72a319449d --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/keymanager.go @@ -0,0 +1,166 @@ +package serf + +import ( + "encoding/base64" + "fmt" + "sync" +) + +// KeyManager encapsulates all functionality within Serf for handling +// encryption keyring changes across a cluster. +type KeyManager struct { + serf *Serf + + // Lock to protect read and write operations + l sync.RWMutex +} + +// keyRequest is used to contain input parameters which get broadcasted to all +// nodes as part of a key query operation. +type keyRequest struct { + Key []byte +} + +// KeyResponse is used to relay a query for a list of all keys in use. +type KeyResponse struct { + Messages map[string]string // Map of node name to response message + NumNodes int // Total nodes memberlist knows of + NumResp int // Total responses received + NumErr int // Total errors from request + + // Keys is a mapping of the base64-encoded value of the key bytes to the + // number of nodes that have the key installed. + Keys map[string]int +} + +// streamKeyResp takes care of reading responses from a channel and composing +// them into a KeyResponse. It will update a KeyResponse *in place* and +// therefore has nothing to return. +func (k *KeyManager) streamKeyResp(resp *KeyResponse, ch <-chan NodeResponse) { + for r := range ch { + var nodeResponse nodeKeyResponse + + resp.NumResp++ + + // Decode the response + if len(r.Payload) < 1 || messageType(r.Payload[0]) != messageKeyResponseType { + resp.Messages[r.From] = fmt.Sprintf( + "Invalid key query response type: %v", r.Payload) + resp.NumErr++ + goto NEXT + } + if err := decodeMessage(r.Payload[1:], &nodeResponse); err != nil { + resp.Messages[r.From] = fmt.Sprintf( + "Failed to decode key query response: %v", r.Payload) + resp.NumErr++ + goto NEXT + } + + if !nodeResponse.Result { + resp.Messages[r.From] = nodeResponse.Message + resp.NumErr++ + } + + // Currently only used for key list queries, this adds keys to a counter + // and increments them for each node response which contains them. + for _, key := range nodeResponse.Keys { + if _, ok := resp.Keys[key]; !ok { + resp.Keys[key] = 1 + } else { + resp.Keys[key]++ + } + } + + NEXT: + // Return early if all nodes have responded. This allows us to avoid + // waiting for the full timeout when there is nothing left to do. + if resp.NumResp == resp.NumNodes { + return + } + } +} + +// handleKeyRequest performs query broadcasting to all members for any type of +// key operation and manages gathering responses and packing them up into a +// KeyResponse for uniform response handling. +func (k *KeyManager) handleKeyRequest(key, query string) (*KeyResponse, error) { + resp := &KeyResponse{ + Messages: make(map[string]string), + Keys: make(map[string]int), + } + qName := internalQueryName(query) + + // Decode the new key into raw bytes + rawKey, err := base64.StdEncoding.DecodeString(key) + if err != nil { + return resp, err + } + + // Encode the query request + req, err := encodeMessage(messageKeyRequestType, keyRequest{Key: rawKey}) + if err != nil { + return resp, err + } + + qParam := k.serf.DefaultQueryParams() + queryResp, err := k.serf.Query(qName, req, qParam) + if err != nil { + return resp, err + } + + // Handle the response stream and populate the KeyResponse + resp.NumNodes = k.serf.memberlist.NumMembers() + k.streamKeyResp(resp, queryResp.respCh) + + // Check the response for any reported failure conditions + if resp.NumErr != 0 { + return resp, fmt.Errorf("%d/%d nodes reported failure", resp.NumErr, resp.NumNodes) + } + if resp.NumResp != resp.NumNodes { + return resp, fmt.Errorf("%d/%d nodes reported success", resp.NumResp, resp.NumNodes) + } + + return resp, nil +} + +// InstallKey handles broadcasting a query to all members and gathering +// responses from each of them, returning a list of messages from each node +// and any applicable error conditions. +func (k *KeyManager) InstallKey(key string) (*KeyResponse, error) { + k.l.Lock() + defer k.l.Unlock() + + return k.handleKeyRequest(key, installKeyQuery) +} + +// UseKey handles broadcasting a primary key change to all members in the +// cluster, and gathering any response messages. If successful, there should +// be an empty KeyResponse returned. +func (k *KeyManager) UseKey(key string) (*KeyResponse, error) { + k.l.Lock() + defer k.l.Unlock() + + return k.handleKeyRequest(key, useKeyQuery) +} + +// RemoveKey handles broadcasting a key to the cluster for removal. Each member +// will receive this event, and if they have the key in their keyring, remove +// it. If any errors are encountered, RemoveKey will collect and relay them. +func (k *KeyManager) RemoveKey(key string) (*KeyResponse, error) { + k.l.Lock() + defer k.l.Unlock() + + return k.handleKeyRequest(key, removeKeyQuery) +} + +// ListKeys is used to collect installed keys from members in a Serf cluster +// and return an aggregated list of all installed keys. This is useful to +// operators to ensure that there are no lingering keys installed on any agents. +// Since having multiple keys installed can cause performance penalties in some +// cases, it's important to verify this information and remove unneeded keys. +func (k *KeyManager) ListKeys() (*KeyResponse, error) { + k.l.RLock() + defer k.l.RUnlock() + + return k.handleKeyRequest("", listKeysQuery) +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/lamport.go b/vendor/src/github.com/hashicorp/serf/serf/lamport.go new file mode 100644 index 0000000000..08f4aa7a62 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/lamport.go @@ -0,0 +1,45 @@ +package serf + +import ( + "sync/atomic" +) + +// LamportClock is a thread safe implementation of a lamport clock. It +// uses efficient atomic operations for all of its functions, falling back +// to a heavy lock only if there are enough CAS failures. +type LamportClock struct { + counter uint64 +} + +// LamportTime is the value of a LamportClock. +type LamportTime uint64 + +// Time is used to return the current value of the lamport clock +func (l *LamportClock) Time() LamportTime { + return LamportTime(atomic.LoadUint64(&l.counter)) +} + +// Increment is used to increment and return the value of the lamport clock +func (l *LamportClock) Increment() LamportTime { + return LamportTime(atomic.AddUint64(&l.counter, 1)) +} + +// Witness is called to update our local clock if necessary after +// witnessing a clock value received from another process +func (l *LamportClock) Witness(v LamportTime) { +WITNESS: + // If the other value is old, we do not need to do anything + cur := atomic.LoadUint64(&l.counter) + other := uint64(v) + if other < cur { + return + } + + // Ensure that our local clock is at least one ahead. + if !atomic.CompareAndSwapUint64(&l.counter, cur, other+1) { + // The CAS failed, so we just retry. Eventually our CAS should + // succeed or a future witness will pass us by and our witness + // will end. + goto WITNESS + } +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/merge_delegate.go b/vendor/src/github.com/hashicorp/serf/serf/merge_delegate.go new file mode 100644 index 0000000000..ece3e9767f --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/merge_delegate.go @@ -0,0 +1,35 @@ +package serf + +import ( + "net" + + "github.com/hashicorp/memberlist" +) + +type MergeDelegate interface { + NotifyMerge([]*Member) (cancel bool) +} + +type mergeDelegate struct { + serf *Serf +} + +func (m *mergeDelegate) NotifyMerge(nodes []*memberlist.Node) (cancel bool) { + members := make([]*Member, len(nodes)) + for idx, n := range nodes { + members[idx] = &Member{ + Name: n.Name, + Addr: net.IP(n.Addr), + Port: n.Port, + Tags: m.serf.decodeTags(n.Meta), + Status: StatusNone, + ProtocolMin: n.PMin, + ProtocolMax: n.PMax, + ProtocolCur: n.PCur, + DelegateMin: n.DMin, + DelegateMax: n.DMax, + DelegateCur: n.DCur, + } + } + return m.serf.config.Merge.NotifyMerge(members) +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/messages.go b/vendor/src/github.com/hashicorp/serf/serf/messages.go new file mode 100644 index 0000000000..c90c964509 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/messages.go @@ -0,0 +1,147 @@ +package serf + +import ( + "bytes" + "github.com/hashicorp/go-msgpack/codec" + "time" +) + +// messageType are the types of gossip messages Serf will send along +// memberlist. +type messageType uint8 + +const ( + messageLeaveType messageType = iota + messageJoinType + messagePushPullType + messageUserEventType + messageQueryType + messageQueryResponseType + messageConflictResponseType + messageKeyRequestType + messageKeyResponseType +) + +const ( + // Ack flag is used to force receiver to send an ack back + queryFlagAck uint32 = 1 << iota + + // NoBroadcast is used to prevent re-broadcast of a query. + // this can be used to selectively send queries to individual members + queryFlagNoBroadcast +) + +// filterType is used with a queryFilter to specify the type of +// filter we are sending +type filterType uint8 + +const ( + filterNodeType filterType = iota + filterTagType +) + +// messageJoin is the message broadcasted after we join to +// associated the node with a lamport clock +type messageJoin struct { + LTime LamportTime + Node string +} + +// messageLeave is the message broadcasted to signal the intentional to +// leave. +type messageLeave struct { + LTime LamportTime + Node string +} + +// messagePushPullType is used when doing a state exchange. This +// is a relatively large message, but is sent infrequently +type messagePushPull struct { + LTime LamportTime // Current node lamport time + StatusLTimes map[string]LamportTime // Maps the node to its status time + LeftMembers []string // List of left nodes + EventLTime LamportTime // Lamport time for event clock + Events []*userEvents // Recent events + QueryLTime LamportTime // Lamport time for query clock +} + +// messageUserEvent is used for user-generated events +type messageUserEvent struct { + LTime LamportTime + Name string + Payload []byte + CC bool // "Can Coalesce". Zero value is compatible with Serf 0.1 +} + +// messageQuery is used for query events +type messageQuery struct { + LTime LamportTime // Event lamport time + ID uint32 // Query ID, randomly generated + Addr []byte // Source address, used for a direct reply + Port uint16 // Source port, used for a direct reply + Filters [][]byte // Potential query filters + Flags uint32 // Used to provide various flags + Timeout time.Duration // Maximum time between delivery and response + Name string // Query name + Payload []byte // Query payload +} + +// Ack checks if the ack flag is set +func (m *messageQuery) Ack() bool { + return (m.Flags & queryFlagAck) != 0 +} + +// NoBroadcast checks if the no broadcast flag is set +func (m *messageQuery) NoBroadcast() bool { + return (m.Flags & queryFlagNoBroadcast) != 0 +} + +// filterNode is used with the filterNodeType, and is a list +// of node names +type filterNode []string + +// filterTag is used with the filterTagType and is a regular +// expression to apply to a tag +type filterTag struct { + Tag string + Expr string +} + +// messageQueryResponse is used to respond to a query +type messageQueryResponse struct { + LTime LamportTime // Event lamport time + ID uint32 // Query ID + From string // Node name + Flags uint32 // Used to provide various flags + Payload []byte // Optional response payload +} + +// Ack checks if the ack flag is set +func (m *messageQueryResponse) Ack() bool { + return (m.Flags & queryFlagAck) != 0 +} + +func decodeMessage(buf []byte, out interface{}) error { + var handle codec.MsgpackHandle + return codec.NewDecoder(bytes.NewReader(buf), &handle).Decode(out) +} + +func encodeMessage(t messageType, msg interface{}) ([]byte, error) { + buf := bytes.NewBuffer(nil) + buf.WriteByte(uint8(t)) + + handle := codec.MsgpackHandle{} + encoder := codec.NewEncoder(buf, &handle) + err := encoder.Encode(msg) + return buf.Bytes(), err +} + +func encodeFilter(f filterType, filt interface{}) ([]byte, error) { + buf := bytes.NewBuffer(nil) + buf.WriteByte(uint8(f)) + + handle := codec.MsgpackHandle{} + encoder := codec.NewEncoder(buf, &handle) + err := encoder.Encode(filt) + return buf.Bytes(), err +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/query.go b/vendor/src/github.com/hashicorp/serf/serf/query.go new file mode 100644 index 0000000000..f29a3b3c54 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/query.go @@ -0,0 +1,210 @@ +package serf + +import ( + "math" + "regexp" + "sync" + "time" +) + +// QueryParam is provided to Query() to configure the parameters of the +// query. If not provided, sane defaults will be used. +type QueryParam struct { + // If provided, we restrict the nodes that should respond to those + // with names in this list + FilterNodes []string + + // FilterTags maps a tag name to a regular expression that is applied + // to restrict the nodes that should respond + FilterTags map[string]string + + // If true, we are requesting an delivery acknowledgement from + // every node that meets the filter requirement. This means nodes + // the receive the message but do not pass the filters, will not + // send an ack. + RequestAck bool + + // The timeout limits how long the query is left open. If not provided, + // then a default timeout is used based on the configuration of Serf + Timeout time.Duration +} + +// DefaultQueryTimeout returns the default timeout value for a query +// Computed as GossipInterval * QueryTimeoutMult * log(N+1) +func (s *Serf) DefaultQueryTimeout() time.Duration { + n := s.memberlist.NumMembers() + timeout := s.config.MemberlistConfig.GossipInterval + timeout *= time.Duration(s.config.QueryTimeoutMult) + timeout *= time.Duration(math.Ceil(math.Log10(float64(n + 1)))) + return timeout +} + +// DefaultQueryParam is used to return the default query parameters +func (s *Serf) DefaultQueryParams() *QueryParam { + return &QueryParam{ + FilterNodes: nil, + FilterTags: nil, + RequestAck: false, + Timeout: s.DefaultQueryTimeout(), + } +} + +// encodeFilters is used to convert the filters into the wire format +func (q *QueryParam) encodeFilters() ([][]byte, error) { + var filters [][]byte + + // Add the node filter + if len(q.FilterNodes) > 0 { + if buf, err := encodeFilter(filterNodeType, q.FilterNodes); err != nil { + return nil, err + } else { + filters = append(filters, buf) + } + } + + // Add the tag filters + for tag, expr := range q.FilterTags { + filt := filterTag{tag, expr} + if buf, err := encodeFilter(filterTagType, &filt); err != nil { + return nil, err + } else { + filters = append(filters, buf) + } + } + + return filters, nil +} + +// QueryResponse is returned for each new Query. It is used to collect +// Ack's as well as responses and to provide those back to a client. +type QueryResponse struct { + // ackCh is used to send the name of a node for which we've received an ack + ackCh chan string + + // deadline is the query end time (start + query timeout) + deadline time.Time + + // Query ID + id uint32 + + // Stores the LTime of the query + lTime LamportTime + + // respCh is used to send a response from a node + respCh chan NodeResponse + + closed bool + closeLock sync.Mutex +} + +// newQueryResponse is used to construct a new query response +func newQueryResponse(n int, q *messageQuery) *QueryResponse { + resp := &QueryResponse{ + deadline: time.Now().Add(q.Timeout), + id: q.ID, + lTime: q.LTime, + respCh: make(chan NodeResponse, n), + } + if q.Ack() { + resp.ackCh = make(chan string, n) + } + return resp +} + +// Close is used to close the query, which will close the underlying +// channels and prevent further deliveries +func (r *QueryResponse) Close() { + r.closeLock.Lock() + defer r.closeLock.Unlock() + if r.closed { + return + } + r.closed = true + if r.ackCh != nil { + close(r.ackCh) + } + if r.respCh != nil { + close(r.respCh) + } +} + +// Deadline returns the ending deadline of the query +func (r *QueryResponse) Deadline() time.Time { + return r.deadline +} + +// Finished returns if the query is finished running +func (r *QueryResponse) Finished() bool { + return r.closed || time.Now().After(r.deadline) +} + +// AckCh returns a channel that can be used to listen for acks +// Channel will be closed when the query is finished. This is nil, +// if the query did not specify RequestAck. +func (r *QueryResponse) AckCh() <-chan string { + return r.ackCh +} + +// ResponseCh returns a channel that can be used to listen for responses. +// Channel will be closed when the query is finished. +func (r *QueryResponse) ResponseCh() <-chan NodeResponse { + return r.respCh +} + +// NodeResponse is used to represent a single response from a node +type NodeResponse struct { + From string + Payload []byte +} + +// shouldProcessQuery checks if a query should be proceeded given +// a set of filers. +func (s *Serf) shouldProcessQuery(filters [][]byte) bool { + for _, filter := range filters { + switch filterType(filter[0]) { + case filterNodeType: + // Decode the filter + var nodes filterNode + if err := decodeMessage(filter[1:], &nodes); err != nil { + s.logger.Printf("[WARN] serf: failed to decode filterNodeType: %v", err) + return false + } + + // Check if we are being targeted + found := false + for _, n := range nodes { + if n == s.config.NodeName { + found = true + break + } + } + if !found { + return false + } + + case filterTagType: + // Decode the filter + var filt filterTag + if err := decodeMessage(filter[1:], &filt); err != nil { + s.logger.Printf("[WARN] serf: failed to decode filterTagType: %v", err) + return false + } + + // Check if we match this regex + tags := s.config.Tags + matched, err := regexp.MatchString(filt.Expr, tags[filt.Tag]) + if err != nil { + s.logger.Printf("[WARN] serf: failed to compile filter regex (%s): %v", filt.Expr, err) + return false + } + if !matched { + return false + } + + default: + s.logger.Printf("[WARN] serf: query has unrecognized filter type: %d", filter[0]) + return false + } + } + return true +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/serf.go b/vendor/src/github.com/hashicorp/serf/serf/serf.go new file mode 100644 index 0000000000..a40ad06fbc --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/serf.go @@ -0,0 +1,1598 @@ +package serf + +import ( + "bytes" + "encoding/base64" + "encoding/json" + "errors" + "fmt" + "io/ioutil" + "log" + "math/rand" + "net" + "strconv" + "sync" + "time" + + "github.com/armon/go-metrics" + "github.com/hashicorp/go-msgpack/codec" + "github.com/hashicorp/memberlist" +) + +// These are the protocol versions that Serf can _understand_. These are +// Serf-level protocol versions that are passed down as the delegate +// version to memberlist below. +const ( + ProtocolVersionMin uint8 = 2 + ProtocolVersionMax = 4 +) + +const ( + // Used to detect if the meta data is tags + // or if it is a raw role + tagMagicByte uint8 = 255 +) + +var ( + // FeatureNotSupported is returned if a feature cannot be used + // due to an older protocol version being used. + FeatureNotSupported = fmt.Errorf("Feature not supported") +) + +func init() { + // Seed the random number generator + rand.Seed(time.Now().UnixNano()) +} + +// Serf is a single node that is part of a single cluster that gets +// events about joins/leaves/failures/etc. It is created with the Create +// method. +// +// All functions on the Serf structure are safe to call concurrently. +type Serf struct { + // The clocks for different purposes. These MUST be the first things + // in this struct due to Golang issue #599. + clock LamportClock + eventClock LamportClock + queryClock LamportClock + + broadcasts *memberlist.TransmitLimitedQueue + config *Config + failedMembers []*memberState + leftMembers []*memberState + memberlist *memberlist.Memberlist + memberLock sync.RWMutex + members map[string]*memberState + + // Circular buffers for recent intents, used + // in case we get the intent before the relevant event + recentLeave []nodeIntent + recentLeaveIndex int + recentJoin []nodeIntent + recentJoinIndex int + + eventBroadcasts *memberlist.TransmitLimitedQueue + eventBuffer []*userEvents + eventJoinIgnore bool + eventMinTime LamportTime + eventLock sync.RWMutex + + queryBroadcasts *memberlist.TransmitLimitedQueue + queryBuffer []*queries + queryMinTime LamportTime + queryResponse map[LamportTime]*QueryResponse + queryLock sync.RWMutex + + logger *log.Logger + joinLock sync.Mutex + stateLock sync.Mutex + state SerfState + shutdownCh chan struct{} + + snapshotter *Snapshotter + keyManager *KeyManager +} + +// SerfState is the state of the Serf instance. +type SerfState int + +const ( + SerfAlive SerfState = iota + SerfLeaving + SerfLeft + SerfShutdown +) + +func (s SerfState) String() string { + switch s { + case SerfAlive: + return "alive" + case SerfLeaving: + return "leaving" + case SerfLeft: + return "left" + case SerfShutdown: + return "shutdown" + default: + return "unknown" + } +} + +// Member is a single member of the Serf cluster. +type Member struct { + Name string + Addr net.IP + Port uint16 + Tags map[string]string + Status MemberStatus + + // The minimum, maximum, and current values of the protocol versions + // and delegate (Serf) protocol versions that each member can understand + // or is speaking. + ProtocolMin uint8 + ProtocolMax uint8 + ProtocolCur uint8 + DelegateMin uint8 + DelegateMax uint8 + DelegateCur uint8 +} + +// MemberStatus is the state that a member is in. +type MemberStatus int + +const ( + StatusNone MemberStatus = iota + StatusAlive + StatusLeaving + StatusLeft + StatusFailed +) + +func (s MemberStatus) String() string { + switch s { + case StatusNone: + return "none" + case StatusAlive: + return "alive" + case StatusLeaving: + return "leaving" + case StatusLeft: + return "left" + case StatusFailed: + return "failed" + default: + panic(fmt.Sprintf("unknown MemberStatus: %d", s)) + } +} + +// memberState is used to track members that are no longer active due to +// leaving, failing, partitioning, etc. It tracks the member along with +// when that member was marked as leaving. +type memberState struct { + Member + statusLTime LamportTime // lamport clock time of last received message + leaveTime time.Time // wall clock time of leave +} + +// nodeIntent is used to buffer intents for out-of-order deliveries +type nodeIntent struct { + LTime LamportTime + Node string +} + +// userEvent is used to buffer events to prevent re-delivery +type userEvent struct { + Name string + Payload []byte +} + +func (ue *userEvent) Equals(other *userEvent) bool { + if ue.Name != other.Name { + return false + } + if bytes.Compare(ue.Payload, other.Payload) != 0 { + return false + } + return true +} + +// userEvents stores all the user events at a specific time +type userEvents struct { + LTime LamportTime + Events []userEvent +} + +// queries stores all the query ids at a specific time +type queries struct { + LTime LamportTime + QueryIDs []uint32 +} + +const ( + UserEventSizeLimit = 512 // Maximum byte size for event name and payload + QuerySizeLimit = 1024 // Maximum byte size for query + QueryResponseSizeLimit = 1024 // Maximum bytes size for response + snapshotSizeLimit = 128 * 1024 // Maximum 128 KB snapshot +) + +// Create creates a new Serf instance, starting all the background tasks +// to maintain cluster membership information. +// +// After calling this function, the configuration should no longer be used +// or modified by the caller. +func Create(conf *Config) (*Serf, error) { + conf.Init() + if conf.ProtocolVersion < ProtocolVersionMin { + return nil, fmt.Errorf("Protocol version '%d' too low. Must be in range: [%d, %d]", + conf.ProtocolVersion, ProtocolVersionMin, ProtocolVersionMax) + } else if conf.ProtocolVersion > ProtocolVersionMax { + return nil, fmt.Errorf("Protocol version '%d' too high. Must be in range: [%d, %d]", + conf.ProtocolVersion, ProtocolVersionMin, ProtocolVersionMax) + } + + serf := &Serf{ + config: conf, + logger: log.New(conf.LogOutput, "", log.LstdFlags), + members: make(map[string]*memberState), + queryResponse: make(map[LamportTime]*QueryResponse), + shutdownCh: make(chan struct{}), + state: SerfAlive, + } + + // Check that the meta data length is okay + if len(serf.encodeTags(conf.Tags)) > memberlist.MetaMaxSize { + return nil, fmt.Errorf("Encoded length of tags exceeds limit of %d bytes", memberlist.MetaMaxSize) + } + + // Check if serf member event coalescing is enabled + if conf.CoalescePeriod > 0 && conf.QuiescentPeriod > 0 && conf.EventCh != nil { + c := &memberEventCoalescer{ + lastEvents: make(map[string]EventType), + latestEvents: make(map[string]coalesceEvent), + } + + conf.EventCh = coalescedEventCh(conf.EventCh, serf.shutdownCh, + conf.CoalescePeriod, conf.QuiescentPeriod, c) + } + + // Check if user event coalescing is enabled + if conf.UserCoalescePeriod > 0 && conf.UserQuiescentPeriod > 0 && conf.EventCh != nil { + c := &userEventCoalescer{ + events: make(map[string]*latestUserEvents), + } + + conf.EventCh = coalescedEventCh(conf.EventCh, serf.shutdownCh, + conf.UserCoalescePeriod, conf.UserQuiescentPeriod, c) + } + + // Listen for internal Serf queries. This is setup before the snapshotter, since + // we want to capture the query-time, but the internal listener does not passthrough + // the queries + outCh, err := newSerfQueries(serf, serf.logger, conf.EventCh, serf.shutdownCh) + if err != nil { + return nil, fmt.Errorf("Failed to setup serf query handler: %v", err) + } + conf.EventCh = outCh + + // Try access the snapshot + var oldClock, oldEventClock, oldQueryClock LamportTime + var prev []*PreviousNode + if conf.SnapshotPath != "" { + eventCh, snap, err := NewSnapshotter(conf.SnapshotPath, + snapshotSizeLimit, + conf.RejoinAfterLeave, + serf.logger, + &serf.clock, + conf.EventCh, + serf.shutdownCh) + if err != nil { + return nil, fmt.Errorf("Failed to setup snapshot: %v", err) + } + serf.snapshotter = snap + conf.EventCh = eventCh + prev = snap.AliveNodes() + oldClock = snap.LastClock() + oldEventClock = snap.LastEventClock() + oldQueryClock = snap.LastQueryClock() + serf.eventMinTime = oldEventClock + 1 + serf.queryMinTime = oldQueryClock + 1 + } + + // Setup the various broadcast queues, which we use to send our own + // custom broadcasts along the gossip channel. + serf.broadcasts = &memberlist.TransmitLimitedQueue{ + NumNodes: func() int { + return len(serf.members) + }, + RetransmitMult: conf.MemberlistConfig.RetransmitMult, + } + serf.eventBroadcasts = &memberlist.TransmitLimitedQueue{ + NumNodes: func() int { + return len(serf.members) + }, + RetransmitMult: conf.MemberlistConfig.RetransmitMult, + } + serf.queryBroadcasts = &memberlist.TransmitLimitedQueue{ + NumNodes: func() int { + return len(serf.members) + }, + RetransmitMult: conf.MemberlistConfig.RetransmitMult, + } + + // Create the buffer for recent intents + serf.recentJoin = make([]nodeIntent, conf.RecentIntentBuffer) + serf.recentLeave = make([]nodeIntent, conf.RecentIntentBuffer) + + // Create a buffer for events and queries + serf.eventBuffer = make([]*userEvents, conf.EventBuffer) + serf.queryBuffer = make([]*queries, conf.QueryBuffer) + + // Ensure our lamport clock is at least 1, so that the default + // join LTime of 0 does not cause issues + serf.clock.Increment() + serf.eventClock.Increment() + serf.queryClock.Increment() + + // Restore the clock from snap if we have one + serf.clock.Witness(oldClock) + serf.eventClock.Witness(oldEventClock) + serf.queryClock.Witness(oldQueryClock) + + // Modify the memberlist configuration with keys that we set + conf.MemberlistConfig.Events = &eventDelegate{serf: serf} + conf.MemberlistConfig.Conflict = &conflictDelegate{serf: serf} + conf.MemberlistConfig.Delegate = &delegate{serf: serf} + conf.MemberlistConfig.DelegateProtocolVersion = conf.ProtocolVersion + conf.MemberlistConfig.DelegateProtocolMin = ProtocolVersionMin + conf.MemberlistConfig.DelegateProtocolMax = ProtocolVersionMax + conf.MemberlistConfig.Name = conf.NodeName + conf.MemberlistConfig.ProtocolVersion = ProtocolVersionMap[conf.ProtocolVersion] + + // Setup a merge delegate if necessary + if conf.Merge != nil { + conf.MemberlistConfig.Merge = &mergeDelegate{serf: serf} + } + + // Create the underlying memberlist that will manage membership + // and failure detection for the Serf instance. + memberlist, err := memberlist.Create(conf.MemberlistConfig) + if err != nil { + return nil, err + } + + serf.memberlist = memberlist + + // Create a key manager for handling all encryption key changes + serf.keyManager = &KeyManager{serf: serf} + + // Start the background tasks. See the documentation above each method + // for more information on their role. + go serf.handleReap() + go serf.handleReconnect() + go serf.checkQueueDepth("Intent", serf.broadcasts) + go serf.checkQueueDepth("Event", serf.eventBroadcasts) + go serf.checkQueueDepth("Query", serf.queryBroadcasts) + + // Attempt to re-join the cluster if we have known nodes + if len(prev) != 0 { + go serf.handleRejoin(prev) + } + + return serf, nil +} + +// ProtocolVersion returns the current protocol version in use by Serf. +// This is the Serf protocol version, not the memberlist protocol version. +func (s *Serf) ProtocolVersion() uint8 { + return s.config.ProtocolVersion +} + +// EncryptionEnabled is a predicate that determines whether or not encryption +// is enabled, which can be possible in one of 2 cases: +// - Single encryption key passed at agent start (no persistence) +// - Keyring file provided at agent start +func (s *Serf) EncryptionEnabled() bool { + return s.config.MemberlistConfig.Keyring != nil +} + +// KeyManager returns the key manager for the current Serf instance. +func (s *Serf) KeyManager() *KeyManager { + return s.keyManager +} + +// UserEvent is used to broadcast a custom user event with a given +// name and payload. The events must be fairly small, and if the +// size limit is exceeded and error will be returned. If coalesce is enabled, +// nodes are allowed to coalesce this event. Coalescing is only available +// starting in v0.2 +func (s *Serf) UserEvent(name string, payload []byte, coalesce bool) error { + // Check the size limit + if len(name)+len(payload) > UserEventSizeLimit { + return fmt.Errorf("user event exceeds limit of %d bytes", UserEventSizeLimit) + } + + // Create a message + msg := messageUserEvent{ + LTime: s.eventClock.Time(), + Name: name, + Payload: payload, + CC: coalesce, + } + s.eventClock.Increment() + + // Process update locally + s.handleUserEvent(&msg) + + // Start broadcasting the event + raw, err := encodeMessage(messageUserEventType, &msg) + if err != nil { + return err + } + s.eventBroadcasts.QueueBroadcast(&broadcast{ + msg: raw, + }) + return nil +} + +// Query is used to broadcast a new query. The query must be fairly small, +// and an error will be returned if the size limit is exceeded. This is only +// available with protocol version 4 and newer. Query parameters are optional, +// and if not provided, a sane set of defaults will be used. +func (s *Serf) Query(name string, payload []byte, params *QueryParam) (*QueryResponse, error) { + // Check that the latest protocol is in use + if s.ProtocolVersion() < 4 { + return nil, FeatureNotSupported + } + + // Provide default parameters if none given + if params == nil { + params = s.DefaultQueryParams() + } else if params.Timeout == 0 { + params.Timeout = s.DefaultQueryTimeout() + } + + // Get the local node + local := s.memberlist.LocalNode() + + // Encode the filters + filters, err := params.encodeFilters() + if err != nil { + return nil, fmt.Errorf("Failed to format filters: %v", err) + } + + // Setup the flags + var flags uint32 + if params.RequestAck { + flags |= queryFlagAck + } + + // Create a message + q := messageQuery{ + LTime: s.queryClock.Time(), + ID: uint32(rand.Int31()), + Addr: local.Addr, + Port: local.Port, + Filters: filters, + Flags: flags, + Timeout: params.Timeout, + Name: name, + Payload: payload, + } + + // Encode the query + raw, err := encodeMessage(messageQueryType, &q) + if err != nil { + return nil, err + } + + // Check the size + if len(raw) > QuerySizeLimit { + return nil, fmt.Errorf("query exceeds limit of %d bytes", QuerySizeLimit) + } + + // Register QueryResponse to track acks and responses + resp := newQueryResponse(s.memberlist.NumMembers(), &q) + s.registerQueryResponse(params.Timeout, resp) + + // Process query locally + s.handleQuery(&q) + + // Start broadcasting the event + s.queryBroadcasts.QueueBroadcast(&broadcast{ + msg: raw, + }) + return resp, nil +} + +// registerQueryResponse is used to setup the listeners for the query, +// and to schedule closing the query after the timeout. +func (s *Serf) registerQueryResponse(timeout time.Duration, resp *QueryResponse) { + s.queryLock.Lock() + defer s.queryLock.Unlock() + + // Map the LTime to the QueryResponse. This is necessarily 1-to-1, + // since we increment the time for each new query. + s.queryResponse[resp.lTime] = resp + + // Setup a timer to close the response and deregister after the timeout + time.AfterFunc(timeout, func() { + s.queryLock.Lock() + delete(s.queryResponse, resp.lTime) + resp.Close() + s.queryLock.Unlock() + }) +} + +// SetTags is used to dynamically update the tags associated with +// the local node. This will propagate the change to the rest of +// the cluster. Blocks until a the message is broadcast out. +func (s *Serf) SetTags(tags map[string]string) error { + // Check that the meta data length is okay + if len(s.encodeTags(tags)) > memberlist.MetaMaxSize { + return fmt.Errorf("Encoded length of tags exceeds limit of %d bytes", + memberlist.MetaMaxSize) + } + + // Update the config + s.config.Tags = tags + + // Trigger a memberlist update + return s.memberlist.UpdateNode(s.config.BroadcastTimeout) +} + +// Join joins an existing Serf cluster. Returns the number of nodes +// successfully contacted. The returned error will be non-nil only in the +// case that no nodes could be contacted. If ignoreOld is true, then any +// user messages sent prior to the join will be ignored. +func (s *Serf) Join(existing []string, ignoreOld bool) (int, error) { + // Do a quick state check + if s.State() != SerfAlive { + return 0, fmt.Errorf("Serf can't Join after Leave or Shutdown") + } + + // Hold the joinLock, this is to make eventJoinIgnore safe + s.joinLock.Lock() + defer s.joinLock.Unlock() + + // Ignore any events from a potential join. This is safe since we hold + // the joinLock and nobody else can be doing a Join + if ignoreOld { + s.eventJoinIgnore = true + defer func() { + s.eventJoinIgnore = false + }() + } + + // Have memberlist attempt to join + num, err := s.memberlist.Join(existing) + + // If we joined any nodes, broadcast the join message + if num > 0 { + // Start broadcasting the update + if err := s.broadcastJoin(s.clock.Time()); err != nil { + return num, err + } + } + + return num, err +} + +// broadcastJoin broadcasts a new join intent with a +// given clock value. It is used on either join, or if +// we need to refute an older leave intent. Cannot be called +// with the memberLock held. +func (s *Serf) broadcastJoin(ltime LamportTime) error { + // Construct message to update our lamport clock + msg := messageJoin{ + LTime: ltime, + Node: s.config.NodeName, + } + s.clock.Witness(ltime) + + // Process update locally + s.handleNodeJoinIntent(&msg) + + // Start broadcasting the update + if err := s.broadcast(messageJoinType, &msg, nil); err != nil { + s.logger.Printf("[WARN] serf: Failed to broadcast join intent: %v", err) + return err + } + return nil +} + +// Leave gracefully exits the cluster. It is safe to call this multiple +// times. +func (s *Serf) Leave() error { + // Check the current state + s.stateLock.Lock() + if s.state == SerfLeft { + s.stateLock.Unlock() + return nil + } else if s.state == SerfLeaving { + s.stateLock.Unlock() + return fmt.Errorf("Leave already in progress") + } else if s.state == SerfShutdown { + s.stateLock.Unlock() + return fmt.Errorf("Leave called after Shutdown") + } + s.state = SerfLeaving + s.stateLock.Unlock() + + // If we have a snapshot, mark we are leaving + if s.snapshotter != nil { + s.snapshotter.Leave() + } + + // Construct the message for the graceful leave + msg := messageLeave{ + LTime: s.clock.Time(), + Node: s.config.NodeName, + } + s.clock.Increment() + + // Process the leave locally + s.handleNodeLeaveIntent(&msg) + + // Only broadcast the leave message if there is at least one + // other node alive. + if s.hasAliveMembers() { + notifyCh := make(chan struct{}) + if err := s.broadcast(messageLeaveType, &msg, notifyCh); err != nil { + return err + } + + select { + case <-notifyCh: + case <-time.After(s.config.BroadcastTimeout): + return errors.New("timeout while waiting for graceful leave") + } + } + + // Attempt the memberlist leave + err := s.memberlist.Leave(s.config.BroadcastTimeout) + if err != nil { + return err + } + + // Transition to Left only if we not already shutdown + s.stateLock.Lock() + if s.state != SerfShutdown { + s.state = SerfLeft + } + s.stateLock.Unlock() + return nil +} + +// hasAliveMembers is called to check for any alive members other than +// ourself. +func (s *Serf) hasAliveMembers() bool { + s.memberLock.RLock() + defer s.memberLock.RUnlock() + + hasAlive := false + for _, m := range s.members { + // Skip ourself, we want to know if OTHER members are alive + if m.Name == s.config.NodeName { + continue + } + + if m.Status == StatusAlive { + hasAlive = true + break + } + } + return hasAlive +} + +// LocalMember returns the Member information for the local node +func (s *Serf) LocalMember() Member { + s.memberLock.RLock() + defer s.memberLock.RUnlock() + return s.members[s.config.NodeName].Member +} + +// Members returns a point-in-time snapshot of the members of this cluster. +func (s *Serf) Members() []Member { + s.memberLock.RLock() + defer s.memberLock.RUnlock() + + members := make([]Member, 0, len(s.members)) + for _, m := range s.members { + members = append(members, m.Member) + } + + return members +} + +// RemoveFailedNode forcibly removes a failed node from the cluster +// immediately, instead of waiting for the reaper to eventually reclaim it. +// This also has the effect that Serf will no longer attempt to reconnect +// to this node. +func (s *Serf) RemoveFailedNode(node string) error { + // Construct the message to broadcast + msg := messageLeave{ + LTime: s.clock.Time(), + Node: node, + } + s.clock.Increment() + + // Process our own event + s.handleNodeLeaveIntent(&msg) + + // If we have no members, then we don't need to broadcast + if !s.hasAliveMembers() { + return nil + } + + // Broadcast the remove + notifyCh := make(chan struct{}) + if err := s.broadcast(messageLeaveType, &msg, notifyCh); err != nil { + return err + } + + // Wait for the broadcast + select { + case <-notifyCh: + case <-time.After(s.config.BroadcastTimeout): + return fmt.Errorf("timed out broadcasting node removal") + } + + return nil +} + +// Shutdown forcefully shuts down the Serf instance, stopping all network +// activity and background maintenance associated with the instance. +// +// This is not a graceful shutdown, and should be preceded by a call +// to Leave. Otherwise, other nodes in the cluster will detect this node's +// exit as a node failure. +// +// It is safe to call this method multiple times. +func (s *Serf) Shutdown() error { + s.stateLock.Lock() + defer s.stateLock.Unlock() + + if s.state == SerfShutdown { + return nil + } + + if s.state != SerfLeft { + s.logger.Printf("[WARN] serf: Shutdown without a Leave") + } + + s.state = SerfShutdown + close(s.shutdownCh) + + err := s.memberlist.Shutdown() + if err != nil { + return err + } + + // Wait for the snapshoter to finish if we have one + if s.snapshotter != nil { + s.snapshotter.Wait() + } + + return nil +} + +// ShutdownCh returns a channel that can be used to wait for +// Serf to shutdown. +func (s *Serf) ShutdownCh() <-chan struct{} { + return s.shutdownCh +} + +// Memberlist is used to get access to the underlying Memberlist instance +func (s *Serf) Memberlist() *memberlist.Memberlist { + return s.memberlist +} + +// State is the current state of this Serf instance. +func (s *Serf) State() SerfState { + s.stateLock.Lock() + defer s.stateLock.Unlock() + return s.state +} + +// broadcast takes a Serf message type, encodes it for the wire, and queues +// the broadcast. If a notify channel is given, this channel will be closed +// when the broadcast is sent. +func (s *Serf) broadcast(t messageType, msg interface{}, notify chan<- struct{}) error { + raw, err := encodeMessage(t, msg) + if err != nil { + return err + } + + s.broadcasts.QueueBroadcast(&broadcast{ + msg: raw, + notify: notify, + }) + return nil +} + +// handleNodeJoin is called when a node join event is received +// from memberlist. +func (s *Serf) handleNodeJoin(n *memberlist.Node) { + s.memberLock.Lock() + defer s.memberLock.Unlock() + + var oldStatus MemberStatus + member, ok := s.members[n.Name] + if !ok { + oldStatus = StatusNone + member = &memberState{ + Member: Member{ + Name: n.Name, + Addr: net.IP(n.Addr), + Port: n.Port, + Tags: s.decodeTags(n.Meta), + Status: StatusAlive, + }, + } + + // Check if we have a join intent and use the LTime + if join := recentIntent(s.recentJoin, n.Name); join != nil { + member.statusLTime = join.LTime + } + + // Check if we have a leave intent + if leave := recentIntent(s.recentLeave, n.Name); leave != nil { + if leave.LTime > member.statusLTime { + member.Status = StatusLeaving + member.statusLTime = leave.LTime + } + } + + s.members[n.Name] = member + } else { + oldStatus = member.Status + member.Status = StatusAlive + member.leaveTime = time.Time{} + member.Addr = net.IP(n.Addr) + member.Port = n.Port + member.Tags = s.decodeTags(n.Meta) + } + + // Update the protocol versions every time we get an event + member.ProtocolMin = n.PMin + member.ProtocolMax = n.PMax + member.ProtocolCur = n.PCur + member.DelegateMin = n.DMin + member.DelegateMax = n.DMax + member.DelegateCur = n.DCur + + // If node was previously in a failed state, then clean up some + // internal accounting. + // TODO(mitchellh): needs tests to verify not reaped + if oldStatus == StatusFailed || oldStatus == StatusLeft { + s.failedMembers = removeOldMember(s.failedMembers, member.Name) + s.leftMembers = removeOldMember(s.leftMembers, member.Name) + } + + // Update some metrics + metrics.IncrCounter([]string{"serf", "member", "join"}, 1) + + // Send an event along + s.logger.Printf("[INFO] serf: EventMemberJoin: %s %s", + member.Member.Name, member.Member.Addr) + if s.config.EventCh != nil { + s.config.EventCh <- MemberEvent{ + Type: EventMemberJoin, + Members: []Member{member.Member}, + } + } +} + +// handleNodeLeave is called when a node leave event is received +// from memberlist. +func (s *Serf) handleNodeLeave(n *memberlist.Node) { + s.memberLock.Lock() + defer s.memberLock.Unlock() + + member, ok := s.members[n.Name] + if !ok { + // We've never even heard of this node that is supposedly + // leaving. Just ignore it completely. + return + } + + switch member.Status { + case StatusLeaving: + member.Status = StatusLeft + member.leaveTime = time.Now() + s.leftMembers = append(s.leftMembers, member) + case StatusAlive: + member.Status = StatusFailed + member.leaveTime = time.Now() + s.failedMembers = append(s.failedMembers, member) + default: + // Unknown state that it was in? Just don't do anything + s.logger.Printf("[WARN] serf: Bad state when leave: %d", member.Status) + return + } + + // Send an event along + event := EventMemberLeave + eventStr := "EventMemberLeave" + if member.Status != StatusLeft { + event = EventMemberFailed + eventStr = "EventMemberFailed" + } + + // Update some metrics + metrics.IncrCounter([]string{"serf", "member", member.Status.String()}, 1) + + s.logger.Printf("[INFO] serf: %s: %s %s", + eventStr, member.Member.Name, member.Member.Addr) + if s.config.EventCh != nil { + s.config.EventCh <- MemberEvent{ + Type: event, + Members: []Member{member.Member}, + } + } +} + +// handleNodeUpdate is called when a node meta data update +// has taken place +func (s *Serf) handleNodeUpdate(n *memberlist.Node) { + s.memberLock.Lock() + defer s.memberLock.Unlock() + + member, ok := s.members[n.Name] + if !ok { + // We've never even heard of this node that is updating. + // Just ignore it completely. + return + } + + // Update the member attributes + member.Addr = net.IP(n.Addr) + member.Port = n.Port + member.Tags = s.decodeTags(n.Meta) + + // Update some metrics + metrics.IncrCounter([]string{"serf", "member", "update"}, 1) + + // Send an event along + s.logger.Printf("[INFO] serf: EventMemberUpdate: %s", member.Member.Name) + if s.config.EventCh != nil { + s.config.EventCh <- MemberEvent{ + Type: EventMemberUpdate, + Members: []Member{member.Member}, + } + } +} + +// handleNodeLeaveIntent is called when an intent to leave is received. +func (s *Serf) handleNodeLeaveIntent(leaveMsg *messageLeave) bool { + // Witness a potentially newer time + s.clock.Witness(leaveMsg.LTime) + + s.memberLock.Lock() + defer s.memberLock.Unlock() + + member, ok := s.members[leaveMsg.Node] + if !ok { + // If we've already seen this message don't rebroadcast + if recentIntent(s.recentLeave, leaveMsg.Node) != nil { + return false + } + + // We don't know this member so store it in a buffer for now + s.recentLeave[s.recentLeaveIndex] = nodeIntent{ + LTime: leaveMsg.LTime, + Node: leaveMsg.Node, + } + s.recentLeaveIndex = (s.recentLeaveIndex + 1) % len(s.recentLeave) + return true + } + + // If the message is old, then it is irrelevant and we can skip it + if leaveMsg.LTime <= member.statusLTime { + return false + } + + // Refute us leaving if we are in the alive state + // Must be done in another goroutine since we have the memberLock + if leaveMsg.Node == s.config.NodeName && s.state == SerfAlive { + s.logger.Printf("[DEBUG] serf: Refuting an older leave intent") + go s.broadcastJoin(s.clock.Time()) + return false + } + + // State transition depends on current state + switch member.Status { + case StatusAlive: + member.Status = StatusLeaving + member.statusLTime = leaveMsg.LTime + return true + case StatusFailed: + member.Status = StatusLeft + member.statusLTime = leaveMsg.LTime + + // Remove from the failed list and add to the left list. We add + // to the left list so that when we do a sync, other nodes will + // remove it from their failed list. + s.failedMembers = removeOldMember(s.failedMembers, member.Name) + s.leftMembers = append(s.leftMembers, member) + + return true + default: + return false + } +} + +// handleNodeJoinIntent is called when a node broadcasts a +// join message to set the lamport time of its join +func (s *Serf) handleNodeJoinIntent(joinMsg *messageJoin) bool { + // Witness a potentially newer time + s.clock.Witness(joinMsg.LTime) + + s.memberLock.Lock() + defer s.memberLock.Unlock() + + member, ok := s.members[joinMsg.Node] + if !ok { + // If we've already seen this message don't rebroadcast + if recentIntent(s.recentJoin, joinMsg.Node) != nil { + return false + } + + // We don't know this member so store it in a buffer for now + s.recentJoin[s.recentJoinIndex] = nodeIntent{LTime: joinMsg.LTime, Node: joinMsg.Node} + s.recentJoinIndex = (s.recentJoinIndex + 1) % len(s.recentJoin) + return true + } + + // Check if this time is newer than what we have + if joinMsg.LTime <= member.statusLTime { + return false + } + + // Update the LTime + member.statusLTime = joinMsg.LTime + + // If we are in the leaving state, we should go back to alive, + // since the leaving message must have been for an older time + if member.Status == StatusLeaving { + member.Status = StatusAlive + } + return true +} + +// handleUserEvent is called when a user event broadcast is +// received. Returns if the message should be rebroadcast. +func (s *Serf) handleUserEvent(eventMsg *messageUserEvent) bool { + // Witness a potentially newer time + s.eventClock.Witness(eventMsg.LTime) + + s.eventLock.Lock() + defer s.eventLock.Unlock() + + // Ignore if it is before our minimum event time + if eventMsg.LTime < s.eventMinTime { + return false + } + + // Check if this message is too old + curTime := s.eventClock.Time() + if curTime > LamportTime(len(s.eventBuffer)) && + eventMsg.LTime < curTime-LamportTime(len(s.eventBuffer)) { + s.logger.Printf( + "[WARN] serf: received old event %s from time %d (current: %d)", + eventMsg.Name, + eventMsg.LTime, + s.eventClock.Time()) + return false + } + + // Check if we've already seen this + idx := eventMsg.LTime % LamportTime(len(s.eventBuffer)) + seen := s.eventBuffer[idx] + userEvent := userEvent{Name: eventMsg.Name, Payload: eventMsg.Payload} + if seen != nil && seen.LTime == eventMsg.LTime { + for _, previous := range seen.Events { + if previous.Equals(&userEvent) { + return false + } + } + } else { + seen = &userEvents{LTime: eventMsg.LTime} + s.eventBuffer[idx] = seen + } + + // Add to recent events + seen.Events = append(seen.Events, userEvent) + + // Update some metrics + metrics.IncrCounter([]string{"serf", "events"}, 1) + metrics.IncrCounter([]string{"serf", "events", eventMsg.Name}, 1) + + if s.config.EventCh != nil { + s.config.EventCh <- UserEvent{ + LTime: eventMsg.LTime, + Name: eventMsg.Name, + Payload: eventMsg.Payload, + Coalesce: eventMsg.CC, + } + } + return true +} + +// handleQuery is called when a query broadcast is +// received. Returns if the message should be rebroadcast. +func (s *Serf) handleQuery(query *messageQuery) bool { + // Witness a potentially newer time + s.queryClock.Witness(query.LTime) + + s.queryLock.Lock() + defer s.queryLock.Unlock() + + // Ignore if it is before our minimum query time + if query.LTime < s.queryMinTime { + return false + } + + // Check if this message is too old + curTime := s.queryClock.Time() + if curTime > LamportTime(len(s.queryBuffer)) && + query.LTime < curTime-LamportTime(len(s.queryBuffer)) { + s.logger.Printf( + "[WARN] serf: received old query %s from time %d (current: %d)", + query.Name, + query.LTime, + s.queryClock.Time()) + return false + } + + // Check if we've already seen this + idx := query.LTime % LamportTime(len(s.queryBuffer)) + seen := s.queryBuffer[idx] + if seen != nil && seen.LTime == query.LTime { + for _, previous := range seen.QueryIDs { + if previous == query.ID { + // Seen this ID already + return false + } + } + } else { + seen = &queries{LTime: query.LTime} + s.queryBuffer[idx] = seen + } + + // Add to recent queries + seen.QueryIDs = append(seen.QueryIDs, query.ID) + + // Update some metrics + metrics.IncrCounter([]string{"serf", "queries"}, 1) + metrics.IncrCounter([]string{"serf", "queries", query.Name}, 1) + + // Check if we should rebroadcast, this may be disabled by a flag + rebroadcast := true + if query.NoBroadcast() { + rebroadcast = false + } + + // Filter the query + if !s.shouldProcessQuery(query.Filters) { + // Even if we don't process it further, we should rebroadcast, + // since it is the first time we've seen this. + return rebroadcast + } + + // Send ack if requested, without waiting for client to Respond() + if query.Ack() { + ack := messageQueryResponse{ + LTime: query.LTime, + ID: query.ID, + From: s.config.NodeName, + Flags: queryFlagAck, + } + raw, err := encodeMessage(messageQueryResponseType, &ack) + if err != nil { + s.logger.Printf("[ERR] serf: failed to format ack: %v", err) + } else { + addr := net.UDPAddr{IP: query.Addr, Port: int(query.Port)} + if err := s.memberlist.SendTo(&addr, raw); err != nil { + s.logger.Printf("[ERR] serf: failed to send ack: %v", err) + } + } + } + + if s.config.EventCh != nil { + s.config.EventCh <- &Query{ + LTime: query.LTime, + Name: query.Name, + Payload: query.Payload, + serf: s, + id: query.ID, + addr: query.Addr, + port: query.Port, + deadline: time.Now().Add(query.Timeout), + } + } + return rebroadcast +} + +// handleResponse is called when a query response is +// received. +func (s *Serf) handleQueryResponse(resp *messageQueryResponse) { + // Look for a corresponding QueryResponse + s.queryLock.RLock() + query, ok := s.queryResponse[resp.LTime] + s.queryLock.RUnlock() + if !ok { + s.logger.Printf("[WARN] serf: reply for non-running query (LTime: %d, ID: %d) From: %s", + resp.LTime, resp.ID, resp.From) + return + } + + // Verify the ID matches + if query.id != resp.ID { + s.logger.Printf("[WARN] serf: query reply ID mismatch (Local: %d, Response: %d)", + query.id, resp.ID) + return + } + + // Check if the query is closed + if query.Finished() { + return + } + + // Process each type of response + if resp.Ack() { + metrics.IncrCounter([]string{"serf", "query_acks"}, 1) + select { + case query.ackCh <- resp.From: + default: + s.logger.Printf("[WARN] serf: Failed to delivery query ack, dropping") + } + } else { + metrics.IncrCounter([]string{"serf", "query_responses"}, 1) + select { + case query.respCh <- NodeResponse{From: resp.From, Payload: resp.Payload}: + default: + s.logger.Printf("[WARN] serf: Failed to delivery query response, dropping") + } + } +} + +// handleNodeConflict is invoked when a join detects a conflict over a name. +// This means two different nodes (IP/Port) are claiming the same name. Memberlist +// will reject the "new" node mapping, but we can still be notified +func (s *Serf) handleNodeConflict(existing, other *memberlist.Node) { + // Log a basic warning if the node is not us... + if existing.Name != s.config.NodeName { + s.logger.Printf("[WARN] serf: Name conflict for '%s' both %s:%d and %s:%d are claiming", + existing.Name, existing.Addr, existing.Port, other.Addr, other.Port) + return + } + + // The current node is conflicting! This is an error + s.logger.Printf("[ERR] serf: Node name conflicts with another node at %s:%d. Names must be unique! (Resolution enabled: %v)", + other.Addr, other.Port, s.config.EnableNameConflictResolution) + + // If automatic resolution is enabled, kick off the resolution + if s.config.EnableNameConflictResolution { + go s.resolveNodeConflict() + } +} + +// resolveNodeConflict is used to determine which node should remain during +// a name conflict. This is done by running an internal query. +func (s *Serf) resolveNodeConflict() { + // Get the local node + local := s.memberlist.LocalNode() + + // Start a name resolution query + qName := internalQueryName(conflictQuery) + payload := []byte(s.config.NodeName) + resp, err := s.Query(qName, payload, nil) + if err != nil { + s.logger.Printf("[ERR] serf: Failed to start name resolution query: %v", err) + return + } + + // Counter to determine winner + var responses, matching int + + // Gather responses + respCh := resp.ResponseCh() + for r := range respCh { + // Decode the response + if len(r.Payload) < 1 || messageType(r.Payload[0]) != messageConflictResponseType { + s.logger.Printf("[ERR] serf: Invalid conflict query response type: %v", r.Payload) + continue + } + var member Member + if err := decodeMessage(r.Payload[1:], &member); err != nil { + s.logger.Printf("[ERR] serf: Failed to decode conflict query response: %v", err) + continue + } + + // Update the counters + responses++ + if bytes.Equal(member.Addr, local.Addr) && member.Port == local.Port { + matching++ + } + } + + // Query over, determine if we should live + majority := (responses / 2) + 1 + if matching >= majority { + s.logger.Printf("[INFO] serf: majority in name conflict resolution [%d / %d]", + matching, responses) + return + } + + // Since we lost the vote, we need to exit + s.logger.Printf("[WARN] serf: minority in name conflict resolution, quiting [%d / %d]", + matching, responses) + if err := s.Shutdown(); err != nil { + s.logger.Printf("[ERR] serf: Failed to shutdown: %v", err) + } +} + +// handleReap periodically reaps the list of failed and left members. +func (s *Serf) handleReap() { + for { + select { + case <-time.After(s.config.ReapInterval): + s.memberLock.Lock() + s.failedMembers = s.reap(s.failedMembers, s.config.ReconnectTimeout) + s.leftMembers = s.reap(s.leftMembers, s.config.TombstoneTimeout) + s.memberLock.Unlock() + case <-s.shutdownCh: + return + } + } +} + +// handleReconnect attempts to reconnect to recently failed nodes +// on configured intervals. +func (s *Serf) handleReconnect() { + for { + select { + case <-time.After(s.config.ReconnectInterval): + s.reconnect() + case <-s.shutdownCh: + return + } + } +} + +// reap is called with a list of old members and a timeout, and removes +// members that have exceeded the timeout. The members are removed from +// both the old list and the members itself. Locking is left to the caller. +func (s *Serf) reap(old []*memberState, timeout time.Duration) []*memberState { + now := time.Now() + n := len(old) + for i := 0; i < n; i++ { + m := old[i] + + // Skip if the timeout is not yet reached + if now.Sub(m.leaveTime) <= timeout { + continue + } + + // Delete from the list + old[i], old[n-1] = old[n-1], nil + old = old[:n-1] + n-- + i-- + + // Delete from members + delete(s.members, m.Name) + + // Send an event along + s.logger.Printf("[INFO] serf: EventMemberReap: %s", m.Name) + if s.config.EventCh != nil { + s.config.EventCh <- MemberEvent{ + Type: EventMemberReap, + Members: []Member{m.Member}, + } + } + } + + return old +} + +// reconnect attempts to reconnect to recently fail nodes. +func (s *Serf) reconnect() { + s.memberLock.RLock() + + // Nothing to do if there are no failed members + n := len(s.failedMembers) + if n == 0 { + s.memberLock.RUnlock() + return + } + + // Probability we should attempt to reconect is given + // by num failed / (num members - num failed - num left) + // This means that we probabilistically expect the cluster + // to attempt to connect to each failed member once per + // reconnect interval + numFailed := float32(len(s.failedMembers)) + numAlive := float32(len(s.members) - len(s.failedMembers) - len(s.leftMembers)) + if numAlive == 0 { + numAlive = 1 // guard against zero divide + } + prob := numFailed / numAlive + if rand.Float32() > prob { + s.memberLock.RUnlock() + s.logger.Printf("[DEBUG] serf: forgoing reconnect for random throttling") + return + } + + // Select a random member to try and join + idx := int(rand.Uint32() % uint32(n)) + mem := s.failedMembers[idx] + s.memberLock.RUnlock() + + // Format the addr + addr := net.UDPAddr{IP: mem.Addr, Port: int(mem.Port)} + s.logger.Printf("[INFO] serf: attempting reconnect to %v %s", mem.Name, addr.String()) + + // Attempt to join at the memberlist level + s.memberlist.Join([]string{addr.String()}) +} + +// checkQueueDepth periodically checks the size of a queue to see if +// it is too large +func (s *Serf) checkQueueDepth(name string, queue *memberlist.TransmitLimitedQueue) { + for { + select { + case <-time.After(time.Second): + numq := queue.NumQueued() + metrics.AddSample([]string{"serf", "queue", name}, float32(numq)) + if numq >= s.config.QueueDepthWarning { + s.logger.Printf("[WARN] serf: %s queue depth: %d", name, numq) + } + if numq > s.config.MaxQueueDepth { + s.logger.Printf("[WARN] serf: %s queue depth (%d) exceeds limit (%d), dropping messages!", + name, numq, s.config.MaxQueueDepth) + queue.Prune(s.config.MaxQueueDepth) + } + case <-s.shutdownCh: + return + } + } +} + +// removeOldMember is used to remove an old member from a list of old +// members. +func removeOldMember(old []*memberState, name string) []*memberState { + for i, m := range old { + if m.Name == name { + n := len(old) + old[i], old[n-1] = old[n-1], nil + return old[:n-1] + } + } + + return old +} + +// recentIntent checks the recent intent buffer for a matching +// entry for a given node, and either returns the message or nil +func recentIntent(recent []nodeIntent, node string) (intent *nodeIntent) { + for i := 0; i < len(recent); i++ { + // Break fast if we hit a zero entry + if recent[i].LTime == 0 { + break + } + + // Check for a node match + if recent[i].Node == node { + // Take the most recent entry + if intent == nil || recent[i].LTime > intent.LTime { + intent = &recent[i] + } + } + } + return +} + +// handleRejoin attempts to reconnect to previously known alive nodes +func (s *Serf) handleRejoin(previous []*PreviousNode) { + for _, prev := range previous { + // Do not attempt to join ourself + if prev.Name == s.config.NodeName { + continue + } + + s.logger.Printf("[INFO] serf: Attempting re-join to previously known node: %s", prev) + _, err := s.memberlist.Join([]string{prev.Addr}) + if err == nil { + s.logger.Printf("[INFO] serf: Re-joined to previously known node: %s", prev) + return + } + } + s.logger.Printf("[WARN] serf: Failed to re-join any previously known node") +} + +// encodeTags is used to encode a tag map +func (s *Serf) encodeTags(tags map[string]string) []byte { + // Support role-only backwards compatibility + if s.ProtocolVersion() < 3 { + role := tags["role"] + return []byte(role) + } + + // Use a magic byte prefix and msgpack encode the tags + var buf bytes.Buffer + buf.WriteByte(tagMagicByte) + enc := codec.NewEncoder(&buf, &codec.MsgpackHandle{}) + if err := enc.Encode(tags); err != nil { + panic(fmt.Sprintf("Failed to encode tags: %v", err)) + } + return buf.Bytes() +} + +// decodeTags is used to decode a tag map +func (s *Serf) decodeTags(buf []byte) map[string]string { + tags := make(map[string]string) + + // Backwards compatibility mode + if len(buf) == 0 || buf[0] != tagMagicByte { + tags["role"] = string(buf) + return tags + } + + // Decode the tags + r := bytes.NewReader(buf[1:]) + dec := codec.NewDecoder(r, &codec.MsgpackHandle{}) + if err := dec.Decode(&tags); err != nil { + s.logger.Printf("[ERR] serf: Failed to decode tags: %v", err) + } + return tags +} + +// Stats is used to provide operator debugging information +func (s *Serf) Stats() map[string]string { + toString := func(v uint64) string { + return strconv.FormatUint(v, 10) + } + stats := map[string]string{ + "members": toString(uint64(len(s.members))), + "failed": toString(uint64(len(s.failedMembers))), + "left": toString(uint64(len(s.leftMembers))), + "member_time": toString(uint64(s.clock.Time())), + "event_time": toString(uint64(s.eventClock.Time())), + "query_time": toString(uint64(s.queryClock.Time())), + "intent_queue": toString(uint64(s.broadcasts.NumQueued())), + "event_queue": toString(uint64(s.eventBroadcasts.NumQueued())), + "query_queue": toString(uint64(s.queryBroadcasts.NumQueued())), + "encrypted": fmt.Sprintf("%v", s.EncryptionEnabled()), + } + return stats +} + +// WriteKeyringFile will serialize the current keyring and save it to a file. +func (s *Serf) writeKeyringFile() error { + if len(s.config.KeyringFile) == 0 { + return nil + } + + keyring := s.config.MemberlistConfig.Keyring + keysRaw := keyring.GetKeys() + keysEncoded := make([]string, len(keysRaw)) + + for i, key := range keysRaw { + keysEncoded[i] = base64.StdEncoding.EncodeToString(key) + } + + encodedKeys, err := json.MarshalIndent(keysEncoded, "", " ") + if err != nil { + return fmt.Errorf("Failed to encode keys: %s", err) + } + + // Use 0600 for permissions because key data is sensitive + if err = ioutil.WriteFile(s.config.KeyringFile, encodedKeys, 0600); err != nil { + return fmt.Errorf("Failed to write keyring file: %s", err) + } + + // Success! + return nil +} diff --git a/vendor/src/github.com/hashicorp/serf/serf/snapshot.go b/vendor/src/github.com/hashicorp/serf/serf/snapshot.go new file mode 100644 index 0000000000..3a1eb92ce2 --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/serf/snapshot.go @@ -0,0 +1,500 @@ +package serf + +import ( + "bufio" + "fmt" + "log" + "math/rand" + "net" + "os" + "strconv" + "strings" + "time" + + "github.com/armon/go-metrics" +) + +/* +Serf supports using a "snapshot" file that contains various +transactional data that is used to help Serf recover quickly +and gracefully from a failure. We append member events, as well +as the latest clock values to the file during normal operation, +and periodically checkpoint and roll over the file. During a restore, +we can replay the various member events to recall a list of known +nodes to re-join, as well as restore our clock values to avoid replaying +old events. +*/ + +const flushInterval = 500 * time.Millisecond +const clockUpdateInterval = 500 * time.Millisecond +const tmpExt = ".compact" + +// Snapshotter is responsible for ingesting events and persisting +// them to disk, and providing a recovery mechanism at start time. +type Snapshotter struct { + aliveNodes map[string]string + clock *LamportClock + fh *os.File + buffered *bufio.Writer + inCh <-chan Event + lastFlush time.Time + lastClock LamportTime + lastEventClock LamportTime + lastQueryClock LamportTime + leaveCh chan struct{} + leaving bool + logger *log.Logger + maxSize int64 + path string + offset int64 + outCh chan<- Event + rejoinAfterLeave bool + shutdownCh <-chan struct{} + waitCh chan struct{} +} + +// PreviousNode is used to represent the previously known alive nodes +type PreviousNode struct { + Name string + Addr string +} + +func (p PreviousNode) String() string { + return fmt.Sprintf("%s: %s", p.Name, p.Addr) +} + +// NewSnapshotter creates a new Snapshotter that records events up to a +// max byte size before rotating the file. It can also be used to +// recover old state. Snapshotter works by reading an event channel it returns, +// passing through to an output channel, and persisting relevant events to disk. +// Setting rejoinAfterLeave makes leave not clear the state, and can be used +// if you intend to rejoin the same cluster after a leave. +func NewSnapshotter(path string, + maxSize int, + rejoinAfterLeave bool, + logger *log.Logger, + clock *LamportClock, + outCh chan<- Event, + shutdownCh <-chan struct{}) (chan<- Event, *Snapshotter, error) { + inCh := make(chan Event, 1024) + + // Try to open the file + fh, err := os.OpenFile(path, os.O_RDWR|os.O_APPEND|os.O_CREATE, 0755) + if err != nil { + return nil, nil, fmt.Errorf("failed to open snapshot: %v", err) + } + + // Determine the offset + info, err := fh.Stat() + if err != nil { + fh.Close() + return nil, nil, fmt.Errorf("failed to stat snapshot: %v", err) + } + offset := info.Size() + + // Create the snapshotter + snap := &Snapshotter{ + aliveNodes: make(map[string]string), + clock: clock, + fh: fh, + buffered: bufio.NewWriter(fh), + inCh: inCh, + lastClock: 0, + lastEventClock: 0, + lastQueryClock: 0, + leaveCh: make(chan struct{}), + logger: logger, + maxSize: int64(maxSize), + path: path, + offset: offset, + outCh: outCh, + rejoinAfterLeave: rejoinAfterLeave, + shutdownCh: shutdownCh, + waitCh: make(chan struct{}), + } + + // Recover the last known state + if err := snap.replay(); err != nil { + fh.Close() + return nil, nil, err + } + + // Start handling new commands + go snap.stream() + return inCh, snap, nil +} + +// LastClock returns the last known clock time +func (s *Snapshotter) LastClock() LamportTime { + return s.lastClock +} + +// LastEventClock returns the last known event clock time +func (s *Snapshotter) LastEventClock() LamportTime { + return s.lastEventClock +} + +// LastQueryClock returns the last known query clock time +func (s *Snapshotter) LastQueryClock() LamportTime { + return s.lastQueryClock +} + +// AliveNodes returns the last known alive nodes +func (s *Snapshotter) AliveNodes() []*PreviousNode { + // Copy the previously known + previous := make([]*PreviousNode, 0, len(s.aliveNodes)) + for name, addr := range s.aliveNodes { + previous = append(previous, &PreviousNode{name, addr}) + } + + // Randomize the order, prevents hot shards + for i := range previous { + j := rand.Intn(i + 1) + previous[i], previous[j] = previous[j], previous[i] + } + return previous +} + +// Wait is used to wait until the snapshotter finishes shut down +func (s *Snapshotter) Wait() { + <-s.waitCh +} + +// Leave is used to remove known nodes to prevent a restart from +// causing a join. Otherwise nodes will re-join after leaving! +func (s *Snapshotter) Leave() { + select { + case s.leaveCh <- struct{}{}: + case <-s.shutdownCh: + } +} + +// stream is a long running routine that is used to handle events +func (s *Snapshotter) stream() { + for { + select { + case <-s.leaveCh: + s.leaving = true + + // If we plan to re-join, keep our state + if !s.rejoinAfterLeave { + s.aliveNodes = make(map[string]string) + } + s.tryAppend("leave\n") + if err := s.buffered.Flush(); err != nil { + s.logger.Printf("[ERR] serf: failed to flush leave to snapshot: %v", err) + } + if err := s.fh.Sync(); err != nil { + s.logger.Printf("[ERR] serf: failed to sync leave to snapshot: %v", err) + } + + case e := <-s.inCh: + // Forward the event immediately + if s.outCh != nil { + s.outCh <- e + } + + // Stop recording events after a leave is issued + if s.leaving { + continue + } + switch typed := e.(type) { + case MemberEvent: + s.processMemberEvent(typed) + case UserEvent: + s.processUserEvent(typed) + case *Query: + s.processQuery(typed) + default: + s.logger.Printf("[ERR] serf: Unknown event to snapshot: %#v", e) + } + + case <-time.After(clockUpdateInterval): + s.updateClock() + + case <-s.shutdownCh: + if err := s.buffered.Flush(); err != nil { + s.logger.Printf("[ERR] serf: failed to flush snapshot: %v", err) + } + if err := s.fh.Sync(); err != nil { + s.logger.Printf("[ERR] serf: failed to sync snapshot: %v", err) + } + s.fh.Close() + close(s.waitCh) + return + } + } +} + +// processMemberEvent is used to handle a single member event +func (s *Snapshotter) processMemberEvent(e MemberEvent) { + switch e.Type { + case EventMemberJoin: + for _, mem := range e.Members { + addr := net.TCPAddr{IP: mem.Addr, Port: int(mem.Port)} + s.aliveNodes[mem.Name] = addr.String() + s.tryAppend(fmt.Sprintf("alive: %s %s\n", mem.Name, addr.String())) + } + + case EventMemberLeave: + fallthrough + case EventMemberFailed: + for _, mem := range e.Members { + delete(s.aliveNodes, mem.Name) + s.tryAppend(fmt.Sprintf("not-alive: %s\n", mem.Name)) + } + } + s.updateClock() +} + +// updateClock is called periodically to check if we should udpate our +// clock value. This is done after member events but should also be done +// periodically due to race conditions with join and leave intents +func (s *Snapshotter) updateClock() { + lastSeen := s.clock.Time() - 1 + if lastSeen > s.lastClock { + s.lastClock = lastSeen + s.tryAppend(fmt.Sprintf("clock: %d\n", s.lastClock)) + } +} + +// processUserEvent is used to handle a single user event +func (s *Snapshotter) processUserEvent(e UserEvent) { + // Ignore old clocks + if e.LTime <= s.lastEventClock { + return + } + s.lastEventClock = e.LTime + s.tryAppend(fmt.Sprintf("event-clock: %d\n", e.LTime)) +} + +// processQuery is used to handle a single query event +func (s *Snapshotter) processQuery(q *Query) { + // Ignore old clocks + if q.LTime <= s.lastQueryClock { + return + } + s.lastQueryClock = q.LTime + s.tryAppend(fmt.Sprintf("query-clock: %d\n", q.LTime)) +} + +// tryAppend will invoke append line but will not return an error +func (s *Snapshotter) tryAppend(l string) { + if err := s.appendLine(l); err != nil { + s.logger.Printf("[ERR] serf: Failed to update snapshot: %v", err) + } +} + +// appendLine is used to append a line to the existing log +func (s *Snapshotter) appendLine(l string) error { + defer metrics.MeasureSince([]string{"serf", "snapshot", "appendLine"}, time.Now()) + + n, err := s.buffered.WriteString(l) + if err != nil { + return err + } + + // Check if we should flush + now := time.Now() + if now.Sub(s.lastFlush) > flushInterval { + s.lastFlush = now + if err := s.buffered.Flush(); err != nil { + return err + } + } + + // Check if a compaction is necessary + s.offset += int64(n) + if s.offset > s.maxSize { + return s.compact() + } + return nil +} + +// Compact is used to compact the snapshot once it is too large +func (s *Snapshotter) compact() error { + defer metrics.MeasureSince([]string{"serf", "snapshot", "compact"}, time.Now()) + + // Try to open the file to new fiel + newPath := s.path + tmpExt + fh, err := os.OpenFile(newPath, os.O_RDWR|os.O_TRUNC|os.O_CREATE, 0755) + if err != nil { + return fmt.Errorf("failed to open new snapshot: %v", err) + } + + // Create a buffered writer + buf := bufio.NewWriter(fh) + + // Write out the live nodes + var offset int64 + for name, addr := range s.aliveNodes { + line := fmt.Sprintf("alive: %s %s\n", name, addr) + n, err := buf.WriteString(line) + if err != nil { + fh.Close() + return err + } + offset += int64(n) + } + + // Write out the clocks + line := fmt.Sprintf("clock: %d\n", s.lastClock) + n, err := buf.WriteString(line) + if err != nil { + fh.Close() + return err + } + offset += int64(n) + + line = fmt.Sprintf("event-clock: %d\n", s.lastEventClock) + n, err = buf.WriteString(line) + if err != nil { + fh.Close() + return err + } + offset += int64(n) + + line = fmt.Sprintf("query-clock: %d\n", s.lastQueryClock) + n, err = buf.WriteString(line) + if err != nil { + fh.Close() + return err + } + offset += int64(n) + + // Flush the new snapshot + err = buf.Flush() + fh.Close() + if err != nil { + return fmt.Errorf("failed to flush new snapshot: %v", err) + } + + // We now need to swap the old snapshot file with the new snapshot. + // Turns out, Windows won't let us rename the files if we have + // open handles to them or if the destination already exists. This + // means we are forced to close the existing handles, delete the + // old file, move the new one in place, and then re-open the file + // handles. + + // Flush the existing snapshot, ignoring errors since we will + // delete it momentarily. + s.buffered.Flush() + s.buffered = nil + + // Close the file handle to the old snapshot + s.fh.Close() + s.fh = nil + + // Delete the old file + if err := os.Remove(s.path); err != nil { + return fmt.Errorf("failed to remove old snapshot: %v", err) + } + + // Move the new file into place + if err := os.Rename(newPath, s.path); err != nil { + return fmt.Errorf("failed to install new snapshot: %v", err) + } + + // Open the new snapshot + fh, err = os.OpenFile(s.path, os.O_RDWR|os.O_APPEND|os.O_CREATE, 0755) + if err != nil { + return fmt.Errorf("failed to open snapshot: %v", err) + } + buf = bufio.NewWriter(fh) + + // Rotate our handles + s.fh = fh + s.buffered = buf + s.offset = offset + s.lastFlush = time.Now() + return nil +} + +// replay is used to seek to reset our internal state by replaying +// the snapshot file. It is used at initialization time to read old +// state +func (s *Snapshotter) replay() error { + // Seek to the beginning + if _, err := s.fh.Seek(0, os.SEEK_SET); err != nil { + return err + } + + // Read each line + reader := bufio.NewReader(s.fh) + for { + line, err := reader.ReadString('\n') + if err != nil { + break + } + + // Skip the newline + line = line[:len(line)-1] + + // Switch on the prefix + if strings.HasPrefix(line, "alive: ") { + info := strings.TrimPrefix(line, "alive: ") + addrIdx := strings.LastIndex(info, " ") + if addrIdx == -1 { + s.logger.Printf("[WARN] serf: Failed to parse address: %v", line) + continue + } + addr := info[addrIdx+1:] + name := info[:addrIdx] + s.aliveNodes[name] = addr + + } else if strings.HasPrefix(line, "not-alive: ") { + name := strings.TrimPrefix(line, "not-alive: ") + delete(s.aliveNodes, name) + + } else if strings.HasPrefix(line, "clock: ") { + timeStr := strings.TrimPrefix(line, "clock: ") + timeInt, err := strconv.ParseUint(timeStr, 10, 64) + if err != nil { + s.logger.Printf("[WARN] serf: Failed to convert clock time: %v", err) + continue + } + s.lastClock = LamportTime(timeInt) + + } else if strings.HasPrefix(line, "event-clock: ") { + timeStr := strings.TrimPrefix(line, "event-clock: ") + timeInt, err := strconv.ParseUint(timeStr, 10, 64) + if err != nil { + s.logger.Printf("[WARN] serf: Failed to convert event clock time: %v", err) + continue + } + s.lastEventClock = LamportTime(timeInt) + + } else if strings.HasPrefix(line, "query-clock: ") { + timeStr := strings.TrimPrefix(line, "query-clock: ") + timeInt, err := strconv.ParseUint(timeStr, 10, 64) + if err != nil { + s.logger.Printf("[WARN] serf: Failed to convert query clock time: %v", err) + continue + } + s.lastQueryClock = LamportTime(timeInt) + + } else if line == "leave" { + // Ignore a leave if we plan on re-joining + if s.rejoinAfterLeave { + s.logger.Printf("[INFO] serf: Ignoring previous leave in snapshot") + continue + } + s.aliveNodes = make(map[string]string) + s.lastClock = 0 + s.lastEventClock = 0 + s.lastQueryClock = 0 + + } else if strings.HasPrefix(line, "#") { + // Skip comment lines + + } else { + s.logger.Printf("[WARN] serf: Unrecognized snapshot line: %v", line) + } + } + + // Seek to the end + if _, err := s.fh.Seek(0, os.SEEK_END); err != nil { + return err + } + return nil +} diff --git a/vendor/src/github.com/hashicorp/serf/website/LICENSE.md b/vendor/src/github.com/hashicorp/serf/website/LICENSE.md new file mode 100644 index 0000000000..36c29d7f7b --- /dev/null +++ b/vendor/src/github.com/hashicorp/serf/website/LICENSE.md @@ -0,0 +1,10 @@ +# Proprietary License + +This license is temporary while a more official one is drafted. However, +this should make it clear: + +* The text contents of this website are MPL 2.0 licensed. + +* The design contents of this website are proprietary and may not be reproduced + or reused in any way other than to run the Serf website locally. The license + for the design is owned solely by HashiCorp, Inc. diff --git a/vendor/src/github.com/jfrazelle/go/.gitignore b/vendor/src/github.com/jfrazelle/go/.gitignore new file mode 100644 index 0000000000..c5f3b1550b --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/.gitignore @@ -0,0 +1,39 @@ +# Compiled Object files, Static and Dynamic libs (Shared Objects) +*.o +*.a +*.so + +# Folders +_obj +_test + +# Architecture specific extensions/prefixes +*.[568vq] +[568vq].out + +*.cgo1.go +*.cgo2.c +_cgo_defun.c +_cgo_gotypes.go +_cgo_export.* + +_testmain.go + +*.exe +*.test +*.prof + +[a-w][a-z] +[._]s[a-w][a-z] +*.un~ +Session.vim +.netrwhist +*~ + +*~ + +# KDE directory preferences +.directory + +# Linux trash folder which might appear on any partition or disk +.Trash-* diff --git a/vendor/src/github.com/jfrazelle/go/Makefile b/vendor/src/github.com/jfrazelle/go/Makefile new file mode 100644 index 0000000000..523ff26310 --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/Makefile @@ -0,0 +1,23 @@ +GO_VERSION=1.4.2 +GO_SRC=/tmp/go/src +PATCH_DIR=$(CURDIR)/patches + +.PHONY: clean download_go_src run_patch update + +define apply_patch +mkdir -p $(CURDIR)/$(2); +cp -r ${GO_SRC}/$(1)/* $(CURDIR)/$(2)/; +git apply $(PATCH_DIR)/*; +endef + +download_go_src: + curl -sSL https://golang.org/dl/go${GO_VERSION}.src.tar.gz | tar -v -C /tmp -xz + +run_patch: download_go_src + @rm -rf canonical/json + $(call apply_patch,encoding/json,canonical/json,json) + +update: run_patch clean + +clean: + rm -rf ${GO_SRC} diff --git a/vendor/src/github.com/jfrazelle/go/README.md b/vendor/src/github.com/jfrazelle/go/README.md new file mode 100644 index 0000000000..3e1f3c8baa --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/README.md @@ -0,0 +1,16 @@ +[![Circle CI](https://circleci.com/gh/jfrazelle/go.svg?style=svg)](https://circleci.com/gh/jfrazelle/go) + +This is a repository used for building go packages based off upstream with +small patches. + +It is only used so far for a canonical json pkg. + +I hope we do not need to use it for anything else in the future. + +**To update:** + +```console +$ make update +``` + +This will nuke the current package, clone upstream and apply the patch. diff --git a/vendor/src/github.com/jfrazelle/go/canonical/json/bench_test.go b/vendor/src/github.com/jfrazelle/go/canonical/json/bench_test.go new file mode 100644 index 0000000000..29dbc26d41 --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/canonical/json/bench_test.go @@ -0,0 +1,189 @@ +// Copyright 2011 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Large data benchmark. +// The JSON data is a summary of agl's changes in the +// go, webkit, and chromium open source projects. +// We benchmark converting between the JSON form +// and in-memory data structures. + +package json + +import ( + "bytes" + "compress/gzip" + "io/ioutil" + "os" + "testing" +) + +type codeResponse struct { + Tree *codeNode `json:"tree"` + Username string `json:"username"` +} + +type codeNode struct { + Name string `json:"name"` + Kids []*codeNode `json:"kids"` + CLWeight float64 `json:"cl_weight"` + Touches int `json:"touches"` + MinT int64 `json:"min_t"` + MaxT int64 `json:"max_t"` + MeanT int64 `json:"mean_t"` +} + +var codeJSON []byte +var codeStruct codeResponse + +func codeInit() { + f, err := os.Open("testdata/code.json.gz") + if err != nil { + panic(err) + } + defer f.Close() + gz, err := gzip.NewReader(f) + if err != nil { + panic(err) + } + data, err := ioutil.ReadAll(gz) + if err != nil { + panic(err) + } + + codeJSON = data + + if err := Unmarshal(codeJSON, &codeStruct); err != nil { + panic("unmarshal code.json: " + err.Error()) + } + + if data, err = Marshal(&codeStruct); err != nil { + panic("marshal code.json: " + err.Error()) + } + + if !bytes.Equal(data, codeJSON) { + println("different lengths", len(data), len(codeJSON)) + for i := 0; i < len(data) && i < len(codeJSON); i++ { + if data[i] != codeJSON[i] { + println("re-marshal: changed at byte", i) + println("orig: ", string(codeJSON[i-10:i+10])) + println("new: ", string(data[i-10:i+10])) + break + } + } + panic("re-marshal code.json: different result") + } +} + +func BenchmarkCodeEncoder(b *testing.B) { + if codeJSON == nil { + b.StopTimer() + codeInit() + b.StartTimer() + } + enc := NewEncoder(ioutil.Discard) + for i := 0; i < b.N; i++ { + if err := enc.Encode(&codeStruct); err != nil { + b.Fatal("Encode:", err) + } + } + b.SetBytes(int64(len(codeJSON))) +} + +func BenchmarkCodeMarshal(b *testing.B) { + if codeJSON == nil { + b.StopTimer() + codeInit() + b.StartTimer() + } + for i := 0; i < b.N; i++ { + if _, err := Marshal(&codeStruct); err != nil { + b.Fatal("Marshal:", err) + } + } + b.SetBytes(int64(len(codeJSON))) +} + +func BenchmarkCodeDecoder(b *testing.B) { + if codeJSON == nil { + b.StopTimer() + codeInit() + b.StartTimer() + } + var buf bytes.Buffer + dec := NewDecoder(&buf) + var r codeResponse + for i := 0; i < b.N; i++ { + buf.Write(codeJSON) + // hide EOF + buf.WriteByte('\n') + buf.WriteByte('\n') + buf.WriteByte('\n') + if err := dec.Decode(&r); err != nil { + b.Fatal("Decode:", err) + } + } + b.SetBytes(int64(len(codeJSON))) +} + +func BenchmarkCodeUnmarshal(b *testing.B) { + if codeJSON == nil { + b.StopTimer() + codeInit() + b.StartTimer() + } + for i := 0; i < b.N; i++ { + var r codeResponse + if err := Unmarshal(codeJSON, &r); err != nil { + b.Fatal("Unmmarshal:", err) + } + } + b.SetBytes(int64(len(codeJSON))) +} + +func BenchmarkCodeUnmarshalReuse(b *testing.B) { + if codeJSON == nil { + b.StopTimer() + codeInit() + b.StartTimer() + } + var r codeResponse + for i := 0; i < b.N; i++ { + if err := Unmarshal(codeJSON, &r); err != nil { + b.Fatal("Unmmarshal:", err) + } + } +} + +func BenchmarkUnmarshalString(b *testing.B) { + data := []byte(`"hello, world"`) + var s string + + for i := 0; i < b.N; i++ { + if err := Unmarshal(data, &s); err != nil { + b.Fatal("Unmarshal:", err) + } + } +} + +func BenchmarkUnmarshalFloat64(b *testing.B) { + var f float64 + data := []byte(`3.14`) + + for i := 0; i < b.N; i++ { + if err := Unmarshal(data, &f); err != nil { + b.Fatal("Unmarshal:", err) + } + } +} + +func BenchmarkUnmarshalInt64(b *testing.B) { + var x int64 + data := []byte(`3`) + + for i := 0; i < b.N; i++ { + if err := Unmarshal(data, &x); err != nil { + b.Fatal("Unmarshal:", err) + } + } +} diff --git a/vendor/src/github.com/jfrazelle/go/canonical/json/decode.go b/vendor/src/github.com/jfrazelle/go/canonical/json/decode.go new file mode 100644 index 0000000000..51b4ffea9d --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/canonical/json/decode.go @@ -0,0 +1,1085 @@ +// Copyright 2010 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Represents JSON data structure using native Go types: booleans, floats, +// strings, arrays, and maps. + +package json + +import ( + "bytes" + "encoding" + "encoding/base64" + "errors" + "fmt" + "reflect" + "runtime" + "strconv" + "unicode" + "unicode/utf16" + "unicode/utf8" +) + +// Unmarshal parses the JSON-encoded data and stores the result +// in the value pointed to by v. +// +// Unmarshal uses the inverse of the encodings that +// Marshal uses, allocating maps, slices, and pointers as necessary, +// with the following additional rules: +// +// To unmarshal JSON into a pointer, Unmarshal first handles the case of +// the JSON being the JSON literal null. In that case, Unmarshal sets +// the pointer to nil. Otherwise, Unmarshal unmarshals the JSON into +// the value pointed at by the pointer. If the pointer is nil, Unmarshal +// allocates a new value for it to point to. +// +// To unmarshal JSON into a struct, Unmarshal matches incoming object +// keys to the keys used by Marshal (either the struct field name or its tag), +// preferring an exact match but also accepting a case-insensitive match. +// +// To unmarshal JSON into an interface value, +// Unmarshal stores one of these in the interface value: +// +// bool, for JSON booleans +// float64, for JSON numbers +// string, for JSON strings +// []interface{}, for JSON arrays +// map[string]interface{}, for JSON objects +// nil for JSON null +// +// If a JSON value is not appropriate for a given target type, +// or if a JSON number overflows the target type, Unmarshal +// skips that field and completes the unmarshalling as best it can. +// If no more serious errors are encountered, Unmarshal returns +// an UnmarshalTypeError describing the earliest such error. +// +// The JSON null value unmarshals into an interface, map, pointer, or slice +// by setting that Go value to nil. Because null is often used in JSON to mean +// ``not present,'' unmarshaling a JSON null into any other Go type has no effect +// on the value and produces no error. +// +// When unmarshaling quoted strings, invalid UTF-8 or +// invalid UTF-16 surrogate pairs are not treated as an error. +// Instead, they are replaced by the Unicode replacement +// character U+FFFD. +// +func Unmarshal(data []byte, v interface{}) error { + // Check for well-formedness. + // Avoids filling out half a data structure + // before discovering a JSON syntax error. + var d decodeState + err := checkValid(data, &d.scan) + if err != nil { + return err + } + + d.init(data) + return d.unmarshal(v) +} + +// Unmarshaler is the interface implemented by objects +// that can unmarshal a JSON description of themselves. +// The input can be assumed to be a valid encoding of +// a JSON value. UnmarshalJSON must copy the JSON data +// if it wishes to retain the data after returning. +type Unmarshaler interface { + UnmarshalJSON([]byte) error +} + +// An UnmarshalTypeError describes a JSON value that was +// not appropriate for a value of a specific Go type. +type UnmarshalTypeError struct { + Value string // description of JSON value - "bool", "array", "number -5" + Type reflect.Type // type of Go value it could not be assigned to +} + +func (e *UnmarshalTypeError) Error() string { + return "json: cannot unmarshal " + e.Value + " into Go value of type " + e.Type.String() +} + +// An UnmarshalFieldError describes a JSON object key that +// led to an unexported (and therefore unwritable) struct field. +// (No longer used; kept for compatibility.) +type UnmarshalFieldError struct { + Key string + Type reflect.Type + Field reflect.StructField +} + +func (e *UnmarshalFieldError) Error() string { + return "json: cannot unmarshal object key " + strconv.Quote(e.Key) + " into unexported field " + e.Field.Name + " of type " + e.Type.String() +} + +// An InvalidUnmarshalError describes an invalid argument passed to Unmarshal. +// (The argument to Unmarshal must be a non-nil pointer.) +type InvalidUnmarshalError struct { + Type reflect.Type +} + +func (e *InvalidUnmarshalError) Error() string { + if e.Type == nil { + return "json: Unmarshal(nil)" + } + + if e.Type.Kind() != reflect.Ptr { + return "json: Unmarshal(non-pointer " + e.Type.String() + ")" + } + return "json: Unmarshal(nil " + e.Type.String() + ")" +} + +func (d *decodeState) unmarshal(v interface{}) (err error) { + defer func() { + if r := recover(); r != nil { + if _, ok := r.(runtime.Error); ok { + panic(r) + } + err = r.(error) + } + }() + + rv := reflect.ValueOf(v) + if rv.Kind() != reflect.Ptr || rv.IsNil() { + return &InvalidUnmarshalError{reflect.TypeOf(v)} + } + + d.scan.reset() + // We decode rv not rv.Elem because the Unmarshaler interface + // test must be applied at the top level of the value. + d.value(rv) + return d.savedError +} + +// A Number represents a JSON number literal. +type Number string + +// String returns the literal text of the number. +func (n Number) String() string { return string(n) } + +// Float64 returns the number as a float64. +func (n Number) Float64() (float64, error) { + return strconv.ParseFloat(string(n), 64) +} + +// Int64 returns the number as an int64. +func (n Number) Int64() (int64, error) { + return strconv.ParseInt(string(n), 10, 64) +} + +// decodeState represents the state while decoding a JSON value. +type decodeState struct { + data []byte + off int // read offset in data + scan scanner + nextscan scanner // for calls to nextValue + savedError error + useNumber bool + canonical bool +} + +// errPhase is used for errors that should not happen unless +// there is a bug in the JSON decoder or something is editing +// the data slice while the decoder executes. +var errPhase = errors.New("JSON decoder out of sync - data changing underfoot?") + +func (d *decodeState) init(data []byte) *decodeState { + d.data = data + d.off = 0 + d.savedError = nil + return d +} + +// error aborts the decoding by panicking with err. +func (d *decodeState) error(err error) { + panic(err) +} + +// saveError saves the first err it is called with, +// for reporting at the end of the unmarshal. +func (d *decodeState) saveError(err error) { + if d.savedError == nil { + d.savedError = err + } +} + +// next cuts off and returns the next full JSON value in d.data[d.off:]. +// The next value is known to be an object or array, not a literal. +func (d *decodeState) next() []byte { + c := d.data[d.off] + item, rest, err := nextValue(d.data[d.off:], &d.nextscan) + if err != nil { + d.error(err) + } + d.off = len(d.data) - len(rest) + + // Our scanner has seen the opening brace/bracket + // and thinks we're still in the middle of the object. + // invent a closing brace/bracket to get it out. + if c == '{' { + d.scan.step(&d.scan, '}') + } else { + d.scan.step(&d.scan, ']') + } + + return item +} + +// scanWhile processes bytes in d.data[d.off:] until it +// receives a scan code not equal to op. +// It updates d.off and returns the new scan code. +func (d *decodeState) scanWhile(op int) int { + var newOp int + for { + if d.off >= len(d.data) { + newOp = d.scan.eof() + d.off = len(d.data) + 1 // mark processed EOF with len+1 + } else { + c := int(d.data[d.off]) + d.off++ + newOp = d.scan.step(&d.scan, c) + } + if newOp != op { + break + } + } + return newOp +} + +// value decodes a JSON value from d.data[d.off:] into the value. +// it updates d.off to point past the decoded value. +func (d *decodeState) value(v reflect.Value) { + if !v.IsValid() { + _, rest, err := nextValue(d.data[d.off:], &d.nextscan) + if err != nil { + d.error(err) + } + d.off = len(d.data) - len(rest) + + // d.scan thinks we're still at the beginning of the item. + // Feed in an empty string - the shortest, simplest value - + // so that it knows we got to the end of the value. + if d.scan.redo { + // rewind. + d.scan.redo = false + d.scan.step = stateBeginValue + } + d.scan.step(&d.scan, '"') + d.scan.step(&d.scan, '"') + + n := len(d.scan.parseState) + if n > 0 && d.scan.parseState[n-1] == parseObjectKey { + // d.scan thinks we just read an object key; finish the object + d.scan.step(&d.scan, ':') + d.scan.step(&d.scan, '"') + d.scan.step(&d.scan, '"') + d.scan.step(&d.scan, '}') + } + + return + } + + switch op := d.scanWhile(scanSkipSpace); op { + default: + d.error(errPhase) + + case scanBeginArray: + d.array(v) + + case scanBeginObject: + d.object(v) + + case scanBeginLiteral: + d.literal(v) + } +} + +type unquotedValue struct{} + +// valueQuoted is like value but decodes a +// quoted string literal or literal null into an interface value. +// If it finds anything other than a quoted string literal or null, +// valueQuoted returns unquotedValue{}. +func (d *decodeState) valueQuoted() interface{} { + switch op := d.scanWhile(scanSkipSpace); op { + default: + d.error(errPhase) + + case scanBeginArray: + d.array(reflect.Value{}) + + case scanBeginObject: + d.object(reflect.Value{}) + + case scanBeginLiteral: + switch v := d.literalInterface().(type) { + case nil, string: + return v + } + } + return unquotedValue{} +} + +// indirect walks down v allocating pointers as needed, +// until it gets to a non-pointer. +// if it encounters an Unmarshaler, indirect stops and returns that. +// if decodingNull is true, indirect stops at the last pointer so it can be set to nil. +func (d *decodeState) indirect(v reflect.Value, decodingNull bool) (Unmarshaler, encoding.TextUnmarshaler, reflect.Value) { + // If v is a named type and is addressable, + // start with its address, so that if the type has pointer methods, + // we find them. + if v.Kind() != reflect.Ptr && v.Type().Name() != "" && v.CanAddr() { + v = v.Addr() + } + for { + // Load value from interface, but only if the result will be + // usefully addressable. + if v.Kind() == reflect.Interface && !v.IsNil() { + e := v.Elem() + if e.Kind() == reflect.Ptr && !e.IsNil() && (!decodingNull || e.Elem().Kind() == reflect.Ptr) { + v = e + continue + } + } + + if v.Kind() != reflect.Ptr { + break + } + + if v.Elem().Kind() != reflect.Ptr && decodingNull && v.CanSet() { + break + } + if v.IsNil() { + v.Set(reflect.New(v.Type().Elem())) + } + if v.Type().NumMethod() > 0 { + if u, ok := v.Interface().(Unmarshaler); ok { + return u, nil, reflect.Value{} + } + if u, ok := v.Interface().(encoding.TextUnmarshaler); ok { + return nil, u, reflect.Value{} + } + } + v = v.Elem() + } + return nil, nil, v +} + +// array consumes an array from d.data[d.off-1:], decoding into the value v. +// the first byte of the array ('[') has been read already. +func (d *decodeState) array(v reflect.Value) { + // Check for unmarshaler. + u, ut, pv := d.indirect(v, false) + if u != nil { + d.off-- + err := u.UnmarshalJSON(d.next()) + if err != nil { + d.error(err) + } + return + } + if ut != nil { + d.saveError(&UnmarshalTypeError{"array", v.Type()}) + d.off-- + d.next() + return + } + + v = pv + + // Check type of target. + switch v.Kind() { + case reflect.Interface: + if v.NumMethod() == 0 { + // Decoding into nil interface? Switch to non-reflect code. + v.Set(reflect.ValueOf(d.arrayInterface())) + return + } + // Otherwise it's invalid. + fallthrough + default: + d.saveError(&UnmarshalTypeError{"array", v.Type()}) + d.off-- + d.next() + return + case reflect.Array: + case reflect.Slice: + break + } + + i := 0 + for { + // Look ahead for ] - can only happen on first iteration. + op := d.scanWhile(scanSkipSpace) + if op == scanEndArray { + break + } + + // Back up so d.value can have the byte we just read. + d.off-- + d.scan.undo(op) + + // Get element of array, growing if necessary. + if v.Kind() == reflect.Slice { + // Grow slice if necessary + if i >= v.Cap() { + newcap := v.Cap() + v.Cap()/2 + if newcap < 4 { + newcap = 4 + } + newv := reflect.MakeSlice(v.Type(), v.Len(), newcap) + reflect.Copy(newv, v) + v.Set(newv) + } + if i >= v.Len() { + v.SetLen(i + 1) + } + } + + if i < v.Len() { + // Decode into element. + d.value(v.Index(i)) + } else { + // Ran out of fixed array: skip. + d.value(reflect.Value{}) + } + i++ + + // Next token must be , or ]. + op = d.scanWhile(scanSkipSpace) + if op == scanEndArray { + break + } + if op != scanArrayValue { + d.error(errPhase) + } + } + + if i < v.Len() { + if v.Kind() == reflect.Array { + // Array. Zero the rest. + z := reflect.Zero(v.Type().Elem()) + for ; i < v.Len(); i++ { + v.Index(i).Set(z) + } + } else { + v.SetLen(i) + } + } + if i == 0 && v.Kind() == reflect.Slice { + v.Set(reflect.MakeSlice(v.Type(), 0, 0)) + } +} + +var nullLiteral = []byte("null") + +// object consumes an object from d.data[d.off-1:], decoding into the value v. +// the first byte ('{') of the object has been read already. +func (d *decodeState) object(v reflect.Value) { + // Check for unmarshaler. + u, ut, pv := d.indirect(v, false) + if u != nil { + d.off-- + err := u.UnmarshalJSON(d.next()) + if err != nil { + d.error(err) + } + return + } + if ut != nil { + d.saveError(&UnmarshalTypeError{"object", v.Type()}) + d.off-- + d.next() // skip over { } in input + return + } + v = pv + + // Decoding into nil interface? Switch to non-reflect code. + if v.Kind() == reflect.Interface && v.NumMethod() == 0 { + v.Set(reflect.ValueOf(d.objectInterface())) + return + } + + // Check type of target: struct or map[string]T + switch v.Kind() { + case reflect.Map: + // map must have string kind + t := v.Type() + if t.Key().Kind() != reflect.String { + d.saveError(&UnmarshalTypeError{"object", v.Type()}) + d.off-- + d.next() // skip over { } in input + return + } + if v.IsNil() { + v.Set(reflect.MakeMap(t)) + } + case reflect.Struct: + + default: + d.saveError(&UnmarshalTypeError{"object", v.Type()}) + d.off-- + d.next() // skip over { } in input + return + } + + var mapElem reflect.Value + + for { + // Read opening " of string key or closing }. + op := d.scanWhile(scanSkipSpace) + if op == scanEndObject { + // closing } - can only happen on first iteration. + break + } + if op != scanBeginLiteral { + d.error(errPhase) + } + + // Read key. + start := d.off - 1 + op = d.scanWhile(scanContinue) + item := d.data[start : d.off-1] + key, ok := unquoteBytes(item) + if !ok { + d.error(errPhase) + } + + // Figure out field corresponding to key. + var subv reflect.Value + destring := false // whether the value is wrapped in a string to be decoded first + + if v.Kind() == reflect.Map { + elemType := v.Type().Elem() + if !mapElem.IsValid() { + mapElem = reflect.New(elemType).Elem() + } else { + mapElem.Set(reflect.Zero(elemType)) + } + subv = mapElem + } else { + var f *field + fields := cachedTypeFields(v.Type(), false) + for i := range fields { + ff := &fields[i] + if bytes.Equal(ff.nameBytes, key) { + f = ff + break + } + if f == nil && ff.equalFold(ff.nameBytes, key) { + f = ff + } + } + if f != nil { + subv = v + destring = f.quoted + for _, i := range f.index { + if subv.Kind() == reflect.Ptr { + if subv.IsNil() { + subv.Set(reflect.New(subv.Type().Elem())) + } + subv = subv.Elem() + } + subv = subv.Field(i) + } + } + } + + // Read : before value. + if op == scanSkipSpace { + op = d.scanWhile(scanSkipSpace) + } + if op != scanObjectKey { + d.error(errPhase) + } + + // Read value. + if destring { + switch qv := d.valueQuoted().(type) { + case nil: + d.literalStore(nullLiteral, subv, false) + case string: + d.literalStore([]byte(qv), subv, true) + default: + d.saveError(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal unquoted value into %v", item, v.Type())) + } + } else { + d.value(subv) + } + + // Write value back to map; + // if using struct, subv points into struct already. + if v.Kind() == reflect.Map { + kv := reflect.ValueOf(key).Convert(v.Type().Key()) + v.SetMapIndex(kv, subv) + } + + // Next token must be , or }. + op = d.scanWhile(scanSkipSpace) + if op == scanEndObject { + break + } + if op != scanObjectValue { + d.error(errPhase) + } + } +} + +// literal consumes a literal from d.data[d.off-1:], decoding into the value v. +// The first byte of the literal has been read already +// (that's how the caller knows it's a literal). +func (d *decodeState) literal(v reflect.Value) { + // All bytes inside literal return scanContinue op code. + start := d.off - 1 + op := d.scanWhile(scanContinue) + + // Scan read one byte too far; back up. + d.off-- + d.scan.undo(op) + + d.literalStore(d.data[start:d.off], v, false) +} + +// convertNumber converts the number literal s to a float64 or a Number +// depending on the setting of d.useNumber. +func (d *decodeState) convertNumber(s string) (interface{}, error) { + if d.useNumber { + return Number(s), nil + } + f, err := strconv.ParseFloat(s, 64) + if err != nil { + return nil, &UnmarshalTypeError{"number " + s, reflect.TypeOf(0.0)} + } + return f, nil +} + +var numberType = reflect.TypeOf(Number("")) + +// literalStore decodes a literal stored in item into v. +// +// fromQuoted indicates whether this literal came from unwrapping a +// string from the ",string" struct tag option. this is used only to +// produce more helpful error messages. +func (d *decodeState) literalStore(item []byte, v reflect.Value, fromQuoted bool) { + // Check for unmarshaler. + if len(item) == 0 { + //Empty string given + d.saveError(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + return + } + wantptr := item[0] == 'n' // null + u, ut, pv := d.indirect(v, wantptr) + if u != nil { + err := u.UnmarshalJSON(item) + if err != nil { + d.error(err) + } + return + } + if ut != nil { + if item[0] != '"' { + if fromQuoted { + d.saveError(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + } else { + d.saveError(&UnmarshalTypeError{"string", v.Type()}) + } + } + s, ok := unquoteBytes(item) + if !ok { + if fromQuoted { + d.error(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + } else { + d.error(errPhase) + } + } + err := ut.UnmarshalText(s) + if err != nil { + d.error(err) + } + return + } + + v = pv + + switch c := item[0]; c { + case 'n': // null + switch v.Kind() { + case reflect.Interface, reflect.Ptr, reflect.Map, reflect.Slice: + v.Set(reflect.Zero(v.Type())) + // otherwise, ignore null for primitives/string + } + case 't', 'f': // true, false + value := c == 't' + switch v.Kind() { + default: + if fromQuoted { + d.saveError(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + } else { + d.saveError(&UnmarshalTypeError{"bool", v.Type()}) + } + case reflect.Bool: + v.SetBool(value) + case reflect.Interface: + if v.NumMethod() == 0 { + v.Set(reflect.ValueOf(value)) + } else { + d.saveError(&UnmarshalTypeError{"bool", v.Type()}) + } + } + + case '"': // string + s, ok := unquoteBytes(item) + if !ok { + if fromQuoted { + d.error(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + } else { + d.error(errPhase) + } + } + switch v.Kind() { + default: + d.saveError(&UnmarshalTypeError{"string", v.Type()}) + case reflect.Slice: + if v.Type() != byteSliceType { + d.saveError(&UnmarshalTypeError{"string", v.Type()}) + break + } + b := make([]byte, base64.StdEncoding.DecodedLen(len(s))) + n, err := base64.StdEncoding.Decode(b, s) + if err != nil { + d.saveError(err) + break + } + v.Set(reflect.ValueOf(b[0:n])) + case reflect.String: + v.SetString(string(s)) + case reflect.Interface: + if v.NumMethod() == 0 { + v.Set(reflect.ValueOf(string(s))) + } else { + d.saveError(&UnmarshalTypeError{"string", v.Type()}) + } + } + + default: // number + if c != '-' && (c < '0' || c > '9') { + if fromQuoted { + d.error(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + } else { + d.error(errPhase) + } + } + s := string(item) + switch v.Kind() { + default: + if v.Kind() == reflect.String && v.Type() == numberType { + v.SetString(s) + break + } + if fromQuoted { + d.error(fmt.Errorf("json: invalid use of ,string struct tag, trying to unmarshal %q into %v", item, v.Type())) + } else { + d.error(&UnmarshalTypeError{"number", v.Type()}) + } + case reflect.Interface: + n, err := d.convertNumber(s) + if err != nil { + d.saveError(err) + break + } + if v.NumMethod() != 0 { + d.saveError(&UnmarshalTypeError{"number", v.Type()}) + break + } + v.Set(reflect.ValueOf(n)) + + case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: + n, err := strconv.ParseInt(s, 10, 64) + if err != nil || v.OverflowInt(n) { + d.saveError(&UnmarshalTypeError{"number " + s, v.Type()}) + break + } + v.SetInt(n) + + case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr: + n, err := strconv.ParseUint(s, 10, 64) + if err != nil || v.OverflowUint(n) { + d.saveError(&UnmarshalTypeError{"number " + s, v.Type()}) + break + } + v.SetUint(n) + + case reflect.Float32, reflect.Float64: + n, err := strconv.ParseFloat(s, v.Type().Bits()) + if err != nil || v.OverflowFloat(n) { + d.saveError(&UnmarshalTypeError{"number " + s, v.Type()}) + break + } + v.SetFloat(n) + } + } +} + +// The xxxInterface routines build up a value to be stored +// in an empty interface. They are not strictly necessary, +// but they avoid the weight of reflection in this common case. + +// valueInterface is like value but returns interface{} +func (d *decodeState) valueInterface() interface{} { + switch d.scanWhile(scanSkipSpace) { + default: + d.error(errPhase) + panic("unreachable") + case scanBeginArray: + return d.arrayInterface() + case scanBeginObject: + return d.objectInterface() + case scanBeginLiteral: + return d.literalInterface() + } +} + +// arrayInterface is like array but returns []interface{}. +func (d *decodeState) arrayInterface() []interface{} { + var v = make([]interface{}, 0) + for { + // Look ahead for ] - can only happen on first iteration. + op := d.scanWhile(scanSkipSpace) + if op == scanEndArray { + break + } + + // Back up so d.value can have the byte we just read. + d.off-- + d.scan.undo(op) + + v = append(v, d.valueInterface()) + + // Next token must be , or ]. + op = d.scanWhile(scanSkipSpace) + if op == scanEndArray { + break + } + if op != scanArrayValue { + d.error(errPhase) + } + } + return v +} + +// objectInterface is like object but returns map[string]interface{}. +func (d *decodeState) objectInterface() map[string]interface{} { + m := make(map[string]interface{}) + for { + // Read opening " of string key or closing }. + op := d.scanWhile(scanSkipSpace) + if op == scanEndObject { + // closing } - can only happen on first iteration. + break + } + if op != scanBeginLiteral { + d.error(errPhase) + } + + // Read string key. + start := d.off - 1 + op = d.scanWhile(scanContinue) + item := d.data[start : d.off-1] + key, ok := unquote(item) + if !ok { + d.error(errPhase) + } + + // Read : before value. + if op == scanSkipSpace { + op = d.scanWhile(scanSkipSpace) + } + if op != scanObjectKey { + d.error(errPhase) + } + + // Read value. + m[key] = d.valueInterface() + + // Next token must be , or }. + op = d.scanWhile(scanSkipSpace) + if op == scanEndObject { + break + } + if op != scanObjectValue { + d.error(errPhase) + } + } + return m +} + +// literalInterface is like literal but returns an interface value. +func (d *decodeState) literalInterface() interface{} { + // All bytes inside literal return scanContinue op code. + start := d.off - 1 + op := d.scanWhile(scanContinue) + + // Scan read one byte too far; back up. + d.off-- + d.scan.undo(op) + item := d.data[start:d.off] + + switch c := item[0]; c { + case 'n': // null + return nil + + case 't', 'f': // true, false + return c == 't' + + case '"': // string + s, ok := unquote(item) + if !ok { + d.error(errPhase) + } + return s + + default: // number + if c != '-' && (c < '0' || c > '9') { + d.error(errPhase) + } + n, err := d.convertNumber(string(item)) + if err != nil { + d.saveError(err) + } + return n + } +} + +// getu4 decodes \uXXXX from the beginning of s, returning the hex value, +// or it returns -1. +func getu4(s []byte) rune { + if len(s) < 6 || s[0] != '\\' || s[1] != 'u' { + return -1 + } + r, err := strconv.ParseUint(string(s[2:6]), 16, 64) + if err != nil { + return -1 + } + return rune(r) +} + +// unquote converts a quoted JSON string literal s into an actual string t. +// The rules are different than for Go, so cannot use strconv.Unquote. +func unquote(s []byte) (t string, ok bool) { + s, ok = unquoteBytes(s) + t = string(s) + return +} + +func unquoteBytes(s []byte) (t []byte, ok bool) { + if len(s) < 2 || s[0] != '"' || s[len(s)-1] != '"' { + return + } + s = s[1 : len(s)-1] + + // Check for unusual characters. If there are none, + // then no unquoting is needed, so return a slice of the + // original bytes. + r := 0 + for r < len(s) { + c := s[r] + if c == '\\' || c == '"' || c < ' ' { + break + } + if c < utf8.RuneSelf { + r++ + continue + } + rr, size := utf8.DecodeRune(s[r:]) + if rr == utf8.RuneError && size == 1 { + break + } + r += size + } + if r == len(s) { + return s, true + } + + b := make([]byte, len(s)+2*utf8.UTFMax) + w := copy(b, s[0:r]) + for r < len(s) { + // Out of room? Can only happen if s is full of + // malformed UTF-8 and we're replacing each + // byte with RuneError. + if w >= len(b)-2*utf8.UTFMax { + nb := make([]byte, (len(b)+utf8.UTFMax)*2) + copy(nb, b[0:w]) + b = nb + } + switch c := s[r]; { + case c == '\\': + r++ + if r >= len(s) { + return + } + switch s[r] { + default: + return + case '"', '\\', '/', '\'': + b[w] = s[r] + r++ + w++ + case 'b': + b[w] = '\b' + r++ + w++ + case 'f': + b[w] = '\f' + r++ + w++ + case 'n': + b[w] = '\n' + r++ + w++ + case 'r': + b[w] = '\r' + r++ + w++ + case 't': + b[w] = '\t' + r++ + w++ + case 'u': + r-- + rr := getu4(s[r:]) + if rr < 0 { + return + } + r += 6 + if utf16.IsSurrogate(rr) { + rr1 := getu4(s[r:]) + if dec := utf16.DecodeRune(rr, rr1); dec != unicode.ReplacementChar { + // A valid pair; consume. + r += 6 + w += utf8.EncodeRune(b[w:], dec) + break + } + // Invalid surrogate; fall back to replacement rune. + rr = unicode.ReplacementChar + } + w += utf8.EncodeRune(b[w:], rr) + } + + // Quote, control characters are invalid. + case c == '"', c < ' ': + return + + // ASCII + case c < utf8.RuneSelf: + b[w] = c + r++ + w++ + + // Coerce to well-formed UTF-8. + default: + rr, size := utf8.DecodeRune(s[r:]) + r += size + w += utf8.EncodeRune(b[w:], rr) + } + } + return b[0:w], true +} diff --git a/vendor/src/github.com/jfrazelle/go/canonical/json/decode_test.go b/vendor/src/github.com/jfrazelle/go/canonical/json/decode_test.go new file mode 100644 index 0000000000..7235969b9f --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/canonical/json/decode_test.go @@ -0,0 +1,1373 @@ +// Copyright 2010 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package json + +import ( + "bytes" + "encoding" + "fmt" + "image" + "reflect" + "strings" + "testing" + "time" +) + +type T struct { + X string + Y int + Z int `json:"-"` +} + +type U struct { + Alphabet string `json:"alpha"` +} + +type V struct { + F1 interface{} + F2 int32 + F3 Number +} + +// ifaceNumAsFloat64/ifaceNumAsNumber are used to test unmarshaling with and +// without UseNumber +var ifaceNumAsFloat64 = map[string]interface{}{ + "k1": float64(1), + "k2": "s", + "k3": []interface{}{float64(1), float64(2.0), float64(3e-3)}, + "k4": map[string]interface{}{"kk1": "s", "kk2": float64(2)}, +} + +var ifaceNumAsNumber = map[string]interface{}{ + "k1": Number("1"), + "k2": "s", + "k3": []interface{}{Number("1"), Number("2.0"), Number("3e-3")}, + "k4": map[string]interface{}{"kk1": "s", "kk2": Number("2")}, +} + +type tx struct { + x int +} + +// A type that can unmarshal itself. + +type unmarshaler struct { + T bool +} + +func (u *unmarshaler) UnmarshalJSON(b []byte) error { + *u = unmarshaler{true} // All we need to see that UnmarshalJSON is called. + return nil +} + +type ustruct struct { + M unmarshaler +} + +type unmarshalerText struct { + T bool +} + +// needed for re-marshaling tests +func (u *unmarshalerText) MarshalText() ([]byte, error) { + return []byte(""), nil +} + +func (u *unmarshalerText) UnmarshalText(b []byte) error { + *u = unmarshalerText{true} // All we need to see that UnmarshalText is called. + return nil +} + +var _ encoding.TextUnmarshaler = (*unmarshalerText)(nil) + +type ustructText struct { + M unmarshalerText +} + +var ( + um0, um1 unmarshaler // target2 of unmarshaling + ump = &um1 + umtrue = unmarshaler{true} + umslice = []unmarshaler{{true}} + umslicep = new([]unmarshaler) + umstruct = ustruct{unmarshaler{true}} + + um0T, um1T unmarshalerText // target2 of unmarshaling + umpT = &um1T + umtrueT = unmarshalerText{true} + umsliceT = []unmarshalerText{{true}} + umslicepT = new([]unmarshalerText) + umstructT = ustructText{unmarshalerText{true}} +) + +// Test data structures for anonymous fields. + +type Point struct { + Z int +} + +type Top struct { + Level0 int + Embed0 + *Embed0a + *Embed0b `json:"e,omitempty"` // treated as named + Embed0c `json:"-"` // ignored + Loop + Embed0p // has Point with X, Y, used + Embed0q // has Point with Z, used +} + +type Embed0 struct { + Level1a int // overridden by Embed0a's Level1a with json tag + Level1b int // used because Embed0a's Level1b is renamed + Level1c int // used because Embed0a's Level1c is ignored + Level1d int // annihilated by Embed0a's Level1d + Level1e int `json:"x"` // annihilated by Embed0a.Level1e +} + +type Embed0a struct { + Level1a int `json:"Level1a,omitempty"` + Level1b int `json:"LEVEL1B,omitempty"` + Level1c int `json:"-"` + Level1d int // annihilated by Embed0's Level1d + Level1f int `json:"x"` // annihilated by Embed0's Level1e +} + +type Embed0b Embed0 + +type Embed0c Embed0 + +type Embed0p struct { + image.Point +} + +type Embed0q struct { + Point +} + +type Loop struct { + Loop1 int `json:",omitempty"` + Loop2 int `json:",omitempty"` + *Loop +} + +// From reflect test: +// The X in S6 and S7 annihilate, but they also block the X in S8.S9. +type S5 struct { + S6 + S7 + S8 +} + +type S6 struct { + X int +} + +type S7 S6 + +type S8 struct { + S9 +} + +type S9 struct { + X int + Y int +} + +// From reflect test: +// The X in S11.S6 and S12.S6 annihilate, but they also block the X in S13.S8.S9. +type S10 struct { + S11 + S12 + S13 +} + +type S11 struct { + S6 +} + +type S12 struct { + S6 +} + +type S13 struct { + S8 +} + +type unmarshalTest struct { + in string + ptr interface{} + out interface{} + err error + useNumber bool +} + +type Ambig struct { + // Given "hello", the first match should win. + First int `json:"HELLO"` + Second int `json:"Hello"` +} + +type XYZ struct { + X interface{} + Y interface{} + Z interface{} +} + +var unmarshalTests = []unmarshalTest{ + // basic types + {in: `true`, ptr: new(bool), out: true}, + {in: `1`, ptr: new(int), out: 1}, + {in: `1.2`, ptr: new(float64), out: 1.2}, + {in: `-5`, ptr: new(int16), out: int16(-5)}, + {in: `2`, ptr: new(Number), out: Number("2"), useNumber: true}, + {in: `2`, ptr: new(Number), out: Number("2")}, + {in: `2`, ptr: new(interface{}), out: float64(2.0)}, + {in: `2`, ptr: new(interface{}), out: Number("2"), useNumber: true}, + {in: `"a\u1234"`, ptr: new(string), out: "a\u1234"}, + {in: `"http:\/\/"`, ptr: new(string), out: "http://"}, + {in: `"g-clef: \uD834\uDD1E"`, ptr: new(string), out: "g-clef: \U0001D11E"}, + {in: `"invalid: \uD834x\uDD1E"`, ptr: new(string), out: "invalid: \uFFFDx\uFFFD"}, + {in: "null", ptr: new(interface{}), out: nil}, + {in: `{"X": [1,2,3], "Y": 4}`, ptr: new(T), out: T{Y: 4}, err: &UnmarshalTypeError{"array", reflect.TypeOf("")}}, + {in: `{"x": 1}`, ptr: new(tx), out: tx{}}, + {in: `{"F1":1,"F2":2,"F3":3}`, ptr: new(V), out: V{F1: float64(1), F2: int32(2), F3: Number("3")}}, + {in: `{"F1":1,"F2":2,"F3":3}`, ptr: new(V), out: V{F1: Number("1"), F2: int32(2), F3: Number("3")}, useNumber: true}, + {in: `{"k1":1,"k2":"s","k3":[1,2.0,3e-3],"k4":{"kk1":"s","kk2":2}}`, ptr: new(interface{}), out: ifaceNumAsFloat64}, + {in: `{"k1":1,"k2":"s","k3":[1,2.0,3e-3],"k4":{"kk1":"s","kk2":2}}`, ptr: new(interface{}), out: ifaceNumAsNumber, useNumber: true}, + + // raw values with whitespace + {in: "\n true ", ptr: new(bool), out: true}, + {in: "\t 1 ", ptr: new(int), out: 1}, + {in: "\r 1.2 ", ptr: new(float64), out: 1.2}, + {in: "\t -5 \n", ptr: new(int16), out: int16(-5)}, + {in: "\t \"a\\u1234\" \n", ptr: new(string), out: "a\u1234"}, + + // Z has a "-" tag. + {in: `{"Y": 1, "Z": 2}`, ptr: new(T), out: T{Y: 1}}, + + {in: `{"alpha": "abc", "alphabet": "xyz"}`, ptr: new(U), out: U{Alphabet: "abc"}}, + {in: `{"alpha": "abc"}`, ptr: new(U), out: U{Alphabet: "abc"}}, + {in: `{"alphabet": "xyz"}`, ptr: new(U), out: U{}}, + + // syntax errors + {in: `{"X": "foo", "Y"}`, err: &SyntaxError{"invalid character '}' after object key", 17}}, + {in: `[1, 2, 3+]`, err: &SyntaxError{"invalid character '+' after array element", 9}}, + {in: `{"X":12x}`, err: &SyntaxError{"invalid character 'x' after object key:value pair", 8}, useNumber: true}, + + // raw value errors + {in: "\x01 42", err: &SyntaxError{"invalid character '\\x01' looking for beginning of value", 1}}, + {in: " 42 \x01", err: &SyntaxError{"invalid character '\\x01' after top-level value", 5}}, + {in: "\x01 true", err: &SyntaxError{"invalid character '\\x01' looking for beginning of value", 1}}, + {in: " false \x01", err: &SyntaxError{"invalid character '\\x01' after top-level value", 8}}, + {in: "\x01 1.2", err: &SyntaxError{"invalid character '\\x01' looking for beginning of value", 1}}, + {in: " 3.4 \x01", err: &SyntaxError{"invalid character '\\x01' after top-level value", 6}}, + {in: "\x01 \"string\"", err: &SyntaxError{"invalid character '\\x01' looking for beginning of value", 1}}, + {in: " \"string\" \x01", err: &SyntaxError{"invalid character '\\x01' after top-level value", 11}}, + + // array tests + {in: `[1, 2, 3]`, ptr: new([3]int), out: [3]int{1, 2, 3}}, + {in: `[1, 2, 3]`, ptr: new([1]int), out: [1]int{1}}, + {in: `[1, 2, 3]`, ptr: new([5]int), out: [5]int{1, 2, 3, 0, 0}}, + + // empty array to interface test + {in: `[]`, ptr: new([]interface{}), out: []interface{}{}}, + {in: `null`, ptr: new([]interface{}), out: []interface{}(nil)}, + {in: `{"T":[]}`, ptr: new(map[string]interface{}), out: map[string]interface{}{"T": []interface{}{}}}, + {in: `{"T":null}`, ptr: new(map[string]interface{}), out: map[string]interface{}{"T": interface{}(nil)}}, + + // composite tests + {in: allValueIndent, ptr: new(All), out: allValue}, + {in: allValueCompact, ptr: new(All), out: allValue}, + {in: allValueIndent, ptr: new(*All), out: &allValue}, + {in: allValueCompact, ptr: new(*All), out: &allValue}, + {in: pallValueIndent, ptr: new(All), out: pallValue}, + {in: pallValueCompact, ptr: new(All), out: pallValue}, + {in: pallValueIndent, ptr: new(*All), out: &pallValue}, + {in: pallValueCompact, ptr: new(*All), out: &pallValue}, + + // unmarshal interface test + {in: `{"T":false}`, ptr: &um0, out: umtrue}, // use "false" so test will fail if custom unmarshaler is not called + {in: `{"T":false}`, ptr: &ump, out: &umtrue}, + {in: `[{"T":false}]`, ptr: &umslice, out: umslice}, + {in: `[{"T":false}]`, ptr: &umslicep, out: &umslice}, + {in: `{"M":{"T":false}}`, ptr: &umstruct, out: umstruct}, + + // UnmarshalText interface test + {in: `"X"`, ptr: &um0T, out: umtrueT}, // use "false" so test will fail if custom unmarshaler is not called + {in: `"X"`, ptr: &umpT, out: &umtrueT}, + {in: `["X"]`, ptr: &umsliceT, out: umsliceT}, + {in: `["X"]`, ptr: &umslicepT, out: &umsliceT}, + {in: `{"M":"X"}`, ptr: &umstructT, out: umstructT}, + + { + in: `{ + "Level0": 1, + "Level1b": 2, + "Level1c": 3, + "x": 4, + "Level1a": 5, + "LEVEL1B": 6, + "e": { + "Level1a": 8, + "Level1b": 9, + "Level1c": 10, + "Level1d": 11, + "x": 12 + }, + "Loop1": 13, + "Loop2": 14, + "X": 15, + "Y": 16, + "Z": 17 + }`, + ptr: new(Top), + out: Top{ + Level0: 1, + Embed0: Embed0{ + Level1b: 2, + Level1c: 3, + }, + Embed0a: &Embed0a{ + Level1a: 5, + Level1b: 6, + }, + Embed0b: &Embed0b{ + Level1a: 8, + Level1b: 9, + Level1c: 10, + Level1d: 11, + Level1e: 12, + }, + Loop: Loop{ + Loop1: 13, + Loop2: 14, + }, + Embed0p: Embed0p{ + Point: image.Point{X: 15, Y: 16}, + }, + Embed0q: Embed0q{ + Point: Point{Z: 17}, + }, + }, + }, + { + in: `{"hello": 1}`, + ptr: new(Ambig), + out: Ambig{First: 1}, + }, + + { + in: `{"X": 1,"Y":2}`, + ptr: new(S5), + out: S5{S8: S8{S9: S9{Y: 2}}}, + }, + { + in: `{"X": 1,"Y":2}`, + ptr: new(S10), + out: S10{S13: S13{S8: S8{S9: S9{Y: 2}}}}, + }, + + // invalid UTF-8 is coerced to valid UTF-8. + { + in: "\"hello\xffworld\"", + ptr: new(string), + out: "hello\ufffdworld", + }, + { + in: "\"hello\xc2\xc2world\"", + ptr: new(string), + out: "hello\ufffd\ufffdworld", + }, + { + in: "\"hello\xc2\xffworld\"", + ptr: new(string), + out: "hello\ufffd\ufffdworld", + }, + { + in: "\"hello\\ud800world\"", + ptr: new(string), + out: "hello\ufffdworld", + }, + { + in: "\"hello\\ud800\\ud800world\"", + ptr: new(string), + out: "hello\ufffd\ufffdworld", + }, + { + in: "\"hello\\ud800\\ud800world\"", + ptr: new(string), + out: "hello\ufffd\ufffdworld", + }, + { + in: "\"hello\xed\xa0\x80\xed\xb0\x80world\"", + ptr: new(string), + out: "hello\ufffd\ufffd\ufffd\ufffd\ufffd\ufffdworld", + }, + + // issue 8305 + { + in: `{"2009-11-10T23:00:00Z": "hello world"}`, + ptr: &map[time.Time]string{}, + err: &UnmarshalTypeError{"object", reflect.TypeOf(map[time.Time]string{})}, + }, +} + +func TestMarshal(t *testing.T) { + b, err := Marshal(allValue) + if err != nil { + t.Fatalf("Marshal allValue: %v", err) + } + if string(b) != allValueCompact { + t.Errorf("Marshal allValueCompact") + diff(t, b, []byte(allValueCompact)) + return + } + + b, err = Marshal(pallValue) + if err != nil { + t.Fatalf("Marshal pallValue: %v", err) + } + if string(b) != pallValueCompact { + t.Errorf("Marshal pallValueCompact") + diff(t, b, []byte(pallValueCompact)) + return + } +} + +var badUTF8 = []struct { + in, out string +}{ + {"hello\xffworld", `"hello\ufffdworld"`}, + {"", `""`}, + {"\xff", `"\ufffd"`}, + {"\xff\xff", `"\ufffd\ufffd"`}, + {"a\xffb", `"a\ufffdb"`}, + {"\xe6\x97\xa5\xe6\x9c\xac\xff\xaa\x9e", `"日本\ufffd\ufffd\ufffd"`}, +} + +func TestMarshalBadUTF8(t *testing.T) { + for _, tt := range badUTF8 { + b, err := Marshal(tt.in) + if string(b) != tt.out || err != nil { + t.Errorf("Marshal(%q) = %#q, %v, want %#q, nil", tt.in, b, err, tt.out) + } + } +} + +func TestMarshalNumberZeroVal(t *testing.T) { + var n Number + out, err := Marshal(n) + if err != nil { + t.Fatal(err) + } + outStr := string(out) + if outStr != "0" { + t.Fatalf("Invalid zero val for Number: %q", outStr) + } +} + +func TestMarshalEmbeds(t *testing.T) { + top := &Top{ + Level0: 1, + Embed0: Embed0{ + Level1b: 2, + Level1c: 3, + }, + Embed0a: &Embed0a{ + Level1a: 5, + Level1b: 6, + }, + Embed0b: &Embed0b{ + Level1a: 8, + Level1b: 9, + Level1c: 10, + Level1d: 11, + Level1e: 12, + }, + Loop: Loop{ + Loop1: 13, + Loop2: 14, + }, + Embed0p: Embed0p{ + Point: image.Point{X: 15, Y: 16}, + }, + Embed0q: Embed0q{ + Point: Point{Z: 17}, + }, + } + b, err := Marshal(top) + if err != nil { + t.Fatal(err) + } + want := "{\"Level0\":1,\"Level1b\":2,\"Level1c\":3,\"Level1a\":5,\"LEVEL1B\":6,\"e\":{\"Level1a\":8,\"Level1b\":9,\"Level1c\":10,\"Level1d\":11,\"x\":12},\"Loop1\":13,\"Loop2\":14,\"X\":15,\"Y\":16,\"Z\":17}" + if string(b) != want { + t.Errorf("Wrong marshal result.\n got: %q\nwant: %q", b, want) + } +} + +func TestUnmarshal(t *testing.T) { + for i, tt := range unmarshalTests { + var scan scanner + in := []byte(tt.in) + if err := checkValid(in, &scan); err != nil { + if !reflect.DeepEqual(err, tt.err) { + t.Errorf("#%d: checkValid: %#v", i, err) + continue + } + } + if tt.ptr == nil { + continue + } + + // v = new(right-type) + v := reflect.New(reflect.TypeOf(tt.ptr).Elem()) + dec := NewDecoder(bytes.NewReader(in)) + if tt.useNumber { + dec.UseNumber() + } + if err := dec.Decode(v.Interface()); !reflect.DeepEqual(err, tt.err) { + t.Errorf("#%d: %v, want %v", i, err, tt.err) + continue + } else if err != nil { + continue + } + if !reflect.DeepEqual(v.Elem().Interface(), tt.out) { + t.Errorf("#%d: mismatch\nhave: %#+v\nwant: %#+v", i, v.Elem().Interface(), tt.out) + data, _ := Marshal(v.Elem().Interface()) + println(string(data)) + data, _ = Marshal(tt.out) + println(string(data)) + continue + } + + // Check round trip. + if tt.err == nil { + enc, err := Marshal(v.Interface()) + if err != nil { + t.Errorf("#%d: error re-marshaling: %v", i, err) + continue + } + vv := reflect.New(reflect.TypeOf(tt.ptr).Elem()) + dec = NewDecoder(bytes.NewReader(enc)) + if tt.useNumber { + dec.UseNumber() + } + if err := dec.Decode(vv.Interface()); err != nil { + t.Errorf("#%d: error re-unmarshaling %#q: %v", i, enc, err) + continue + } + if !reflect.DeepEqual(v.Elem().Interface(), vv.Elem().Interface()) { + t.Errorf("#%d: mismatch\nhave: %#+v\nwant: %#+v", i, v.Elem().Interface(), vv.Elem().Interface()) + t.Errorf(" In: %q", strings.Map(noSpace, string(in))) + t.Errorf("Marshal: %q", strings.Map(noSpace, string(enc))) + continue + } + } + } +} + +func TestUnmarshalMarshal(t *testing.T) { + initBig() + var v interface{} + if err := Unmarshal(jsonBig, &v); err != nil { + t.Fatalf("Unmarshal: %v", err) + } + b, err := Marshal(v) + if err != nil { + t.Fatalf("Marshal: %v", err) + } + if !bytes.Equal(jsonBig, b) { + t.Errorf("Marshal jsonBig") + diff(t, b, jsonBig) + return + } +} + +var numberTests = []struct { + in string + i int64 + intErr string + f float64 + floatErr string +}{ + {in: "-1.23e1", intErr: "strconv.ParseInt: parsing \"-1.23e1\": invalid syntax", f: -1.23e1}, + {in: "-12", i: -12, f: -12.0}, + {in: "1e1000", intErr: "strconv.ParseInt: parsing \"1e1000\": invalid syntax", floatErr: "strconv.ParseFloat: parsing \"1e1000\": value out of range"}, +} + +// Independent of Decode, basic coverage of the accessors in Number +func TestNumberAccessors(t *testing.T) { + for _, tt := range numberTests { + n := Number(tt.in) + if s := n.String(); s != tt.in { + t.Errorf("Number(%q).String() is %q", tt.in, s) + } + if i, err := n.Int64(); err == nil && tt.intErr == "" && i != tt.i { + t.Errorf("Number(%q).Int64() is %d", tt.in, i) + } else if (err == nil && tt.intErr != "") || (err != nil && err.Error() != tt.intErr) { + t.Errorf("Number(%q).Int64() wanted error %q but got: %v", tt.in, tt.intErr, err) + } + if f, err := n.Float64(); err == nil && tt.floatErr == "" && f != tt.f { + t.Errorf("Number(%q).Float64() is %g", tt.in, f) + } else if (err == nil && tt.floatErr != "") || (err != nil && err.Error() != tt.floatErr) { + t.Errorf("Number(%q).Float64() wanted error %q but got: %v", tt.in, tt.floatErr, err) + } + } +} + +func TestLargeByteSlice(t *testing.T) { + s0 := make([]byte, 2000) + for i := range s0 { + s0[i] = byte(i) + } + b, err := Marshal(s0) + if err != nil { + t.Fatalf("Marshal: %v", err) + } + var s1 []byte + if err := Unmarshal(b, &s1); err != nil { + t.Fatalf("Unmarshal: %v", err) + } + if !bytes.Equal(s0, s1) { + t.Errorf("Marshal large byte slice") + diff(t, s0, s1) + } +} + +type Xint struct { + X int +} + +func TestUnmarshalInterface(t *testing.T) { + var xint Xint + var i interface{} = &xint + if err := Unmarshal([]byte(`{"X":1}`), &i); err != nil { + t.Fatalf("Unmarshal: %v", err) + } + if xint.X != 1 { + t.Fatalf("Did not write to xint") + } +} + +func TestUnmarshalPtrPtr(t *testing.T) { + var xint Xint + pxint := &xint + if err := Unmarshal([]byte(`{"X":1}`), &pxint); err != nil { + t.Fatalf("Unmarshal: %v", err) + } + if xint.X != 1 { + t.Fatalf("Did not write to xint") + } +} + +func TestEscape(t *testing.T) { + const input = `"foobar"` + " [\u2028 \u2029]" + const expected = `"\"foobar\"\u003chtml\u003e [\u2028 \u2029]"` + b, err := Marshal(input) + if err != nil { + t.Fatalf("Marshal error: %v", err) + } + if s := string(b); s != expected { + t.Errorf("Encoding of [%s]:\n got [%s]\nwant [%s]", input, s, expected) + } +} + +// WrongString is a struct that's misusing the ,string modifier. +type WrongString struct { + Message string `json:"result,string"` +} + +type wrongStringTest struct { + in, err string +} + +var wrongStringTests = []wrongStringTest{ + {`{"result":"x"}`, `json: invalid use of ,string struct tag, trying to unmarshal "x" into string`}, + {`{"result":"foo"}`, `json: invalid use of ,string struct tag, trying to unmarshal "foo" into string`}, + {`{"result":"123"}`, `json: invalid use of ,string struct tag, trying to unmarshal "123" into string`}, +} + +// If people misuse the ,string modifier, the error message should be +// helpful, telling the user that they're doing it wrong. +func TestErrorMessageFromMisusedString(t *testing.T) { + for n, tt := range wrongStringTests { + r := strings.NewReader(tt.in) + var s WrongString + err := NewDecoder(r).Decode(&s) + got := fmt.Sprintf("%v", err) + if got != tt.err { + t.Errorf("%d. got err = %q, want %q", n, got, tt.err) + } + } +} + +func noSpace(c rune) rune { + if isSpace(c) { + return -1 + } + return c +} + +type All struct { + Bool bool + Int int + Int8 int8 + Int16 int16 + Int32 int32 + Int64 int64 + Uint uint + Uint8 uint8 + Uint16 uint16 + Uint32 uint32 + Uint64 uint64 + Uintptr uintptr + Float32 float32 + Float64 float64 + + Foo string `json:"bar"` + Foo2 string `json:"bar2,dummyopt"` + + IntStr int64 `json:",string"` + + PBool *bool + PInt *int + PInt8 *int8 + PInt16 *int16 + PInt32 *int32 + PInt64 *int64 + PUint *uint + PUint8 *uint8 + PUint16 *uint16 + PUint32 *uint32 + PUint64 *uint64 + PUintptr *uintptr + PFloat32 *float32 + PFloat64 *float64 + + String string + PString *string + + Map map[string]Small + MapP map[string]*Small + PMap *map[string]Small + PMapP *map[string]*Small + + EmptyMap map[string]Small + NilMap map[string]Small + + Slice []Small + SliceP []*Small + PSlice *[]Small + PSliceP *[]*Small + + EmptySlice []Small + NilSlice []Small + + StringSlice []string + ByteSlice []byte + + Small Small + PSmall *Small + PPSmall **Small + + Interface interface{} + PInterface *interface{} + + unexported int +} + +type Small struct { + Tag string +} + +var allValue = All{ + Bool: true, + Int: 2, + Int8: 3, + Int16: 4, + Int32: 5, + Int64: 6, + Uint: 7, + Uint8: 8, + Uint16: 9, + Uint32: 10, + Uint64: 11, + Uintptr: 12, + Float32: 14.1, + Float64: 15.1, + Foo: "foo", + Foo2: "foo2", + IntStr: 42, + String: "16", + Map: map[string]Small{ + "17": {Tag: "tag17"}, + "18": {Tag: "tag18"}, + }, + MapP: map[string]*Small{ + "19": {Tag: "tag19"}, + "20": nil, + }, + EmptyMap: map[string]Small{}, + Slice: []Small{{Tag: "tag20"}, {Tag: "tag21"}}, + SliceP: []*Small{{Tag: "tag22"}, nil, {Tag: "tag23"}}, + EmptySlice: []Small{}, + StringSlice: []string{"str24", "str25", "str26"}, + ByteSlice: []byte{27, 28, 29}, + Small: Small{Tag: "tag30"}, + PSmall: &Small{Tag: "tag31"}, + Interface: 5.2, +} + +var pallValue = All{ + PBool: &allValue.Bool, + PInt: &allValue.Int, + PInt8: &allValue.Int8, + PInt16: &allValue.Int16, + PInt32: &allValue.Int32, + PInt64: &allValue.Int64, + PUint: &allValue.Uint, + PUint8: &allValue.Uint8, + PUint16: &allValue.Uint16, + PUint32: &allValue.Uint32, + PUint64: &allValue.Uint64, + PUintptr: &allValue.Uintptr, + PFloat32: &allValue.Float32, + PFloat64: &allValue.Float64, + PString: &allValue.String, + PMap: &allValue.Map, + PMapP: &allValue.MapP, + PSlice: &allValue.Slice, + PSliceP: &allValue.SliceP, + PPSmall: &allValue.PSmall, + PInterface: &allValue.Interface, +} + +var allValueIndent = `{ + "Bool": true, + "Int": 2, + "Int8": 3, + "Int16": 4, + "Int32": 5, + "Int64": 6, + "Uint": 7, + "Uint8": 8, + "Uint16": 9, + "Uint32": 10, + "Uint64": 11, + "Uintptr": 12, + "Float32": 14.1, + "Float64": 15.1, + "bar": "foo", + "bar2": "foo2", + "IntStr": "42", + "PBool": null, + "PInt": null, + "PInt8": null, + "PInt16": null, + "PInt32": null, + "PInt64": null, + "PUint": null, + "PUint8": null, + "PUint16": null, + "PUint32": null, + "PUint64": null, + "PUintptr": null, + "PFloat32": null, + "PFloat64": null, + "String": "16", + "PString": null, + "Map": { + "17": { + "Tag": "tag17" + }, + "18": { + "Tag": "tag18" + } + }, + "MapP": { + "19": { + "Tag": "tag19" + }, + "20": null + }, + "PMap": null, + "PMapP": null, + "EmptyMap": {}, + "NilMap": null, + "Slice": [ + { + "Tag": "tag20" + }, + { + "Tag": "tag21" + } + ], + "SliceP": [ + { + "Tag": "tag22" + }, + null, + { + "Tag": "tag23" + } + ], + "PSlice": null, + "PSliceP": null, + "EmptySlice": [], + "NilSlice": null, + "StringSlice": [ + "str24", + "str25", + "str26" + ], + "ByteSlice": "Gxwd", + "Small": { + "Tag": "tag30" + }, + "PSmall": { + "Tag": "tag31" + }, + "PPSmall": null, + "Interface": 5.2, + "PInterface": null +}` + +var allValueCompact = strings.Map(noSpace, allValueIndent) + +var pallValueIndent = `{ + "Bool": false, + "Int": 0, + "Int8": 0, + "Int16": 0, + "Int32": 0, + "Int64": 0, + "Uint": 0, + "Uint8": 0, + "Uint16": 0, + "Uint32": 0, + "Uint64": 0, + "Uintptr": 0, + "Float32": 0, + "Float64": 0, + "bar": "", + "bar2": "", + "IntStr": "0", + "PBool": true, + "PInt": 2, + "PInt8": 3, + "PInt16": 4, + "PInt32": 5, + "PInt64": 6, + "PUint": 7, + "PUint8": 8, + "PUint16": 9, + "PUint32": 10, + "PUint64": 11, + "PUintptr": 12, + "PFloat32": 14.1, + "PFloat64": 15.1, + "String": "", + "PString": "16", + "Map": null, + "MapP": null, + "PMap": { + "17": { + "Tag": "tag17" + }, + "18": { + "Tag": "tag18" + } + }, + "PMapP": { + "19": { + "Tag": "tag19" + }, + "20": null + }, + "EmptyMap": null, + "NilMap": null, + "Slice": null, + "SliceP": null, + "PSlice": [ + { + "Tag": "tag20" + }, + { + "Tag": "tag21" + } + ], + "PSliceP": [ + { + "Tag": "tag22" + }, + null, + { + "Tag": "tag23" + } + ], + "EmptySlice": null, + "NilSlice": null, + "StringSlice": null, + "ByteSlice": null, + "Small": { + "Tag": "" + }, + "PSmall": null, + "PPSmall": { + "Tag": "tag31" + }, + "Interface": null, + "PInterface": 5.2 +}` + +var pallValueCompact = strings.Map(noSpace, pallValueIndent) + +func TestRefUnmarshal(t *testing.T) { + type S struct { + // Ref is defined in encode_test.go. + R0 Ref + R1 *Ref + R2 RefText + R3 *RefText + } + want := S{ + R0: 12, + R1: new(Ref), + R2: 13, + R3: new(RefText), + } + *want.R1 = 12 + *want.R3 = 13 + + var got S + if err := Unmarshal([]byte(`{"R0":"ref","R1":"ref","R2":"ref","R3":"ref"}`), &got); err != nil { + t.Fatalf("Unmarshal: %v", err) + } + if !reflect.DeepEqual(got, want) { + t.Errorf("got %+v, want %+v", got, want) + } +} + +// Test that the empty string doesn't panic decoding when ,string is specified +// Issue 3450 +func TestEmptyString(t *testing.T) { + type T2 struct { + Number1 int `json:",string"` + Number2 int `json:",string"` + } + data := `{"Number1":"1", "Number2":""}` + dec := NewDecoder(strings.NewReader(data)) + var t2 T2 + err := dec.Decode(&t2) + if err == nil { + t.Fatal("Decode: did not return error") + } + if t2.Number1 != 1 { + t.Fatal("Decode: did not set Number1") + } +} + +// Test that a null for ,string is not replaced with the previous quoted string (issue 7046). +// It should also not be an error (issue 2540, issue 8587). +func TestNullString(t *testing.T) { + type T struct { + A int `json:",string"` + B int `json:",string"` + C *int `json:",string"` + } + data := []byte(`{"A": "1", "B": null, "C": null}`) + var s T + s.B = 1 + s.C = new(int) + *s.C = 2 + err := Unmarshal(data, &s) + if err != nil { + t.Fatalf("Unmarshal: %v") + } + if s.B != 1 || s.C != nil { + t.Fatalf("after Unmarshal, s.B=%d, s.C=%p, want 1, nil", s.B, s.C) + } +} + +func intp(x int) *int { + p := new(int) + *p = x + return p +} + +func intpp(x *int) **int { + pp := new(*int) + *pp = x + return pp +} + +var interfaceSetTests = []struct { + pre interface{} + json string + post interface{} +}{ + {"foo", `"bar"`, "bar"}, + {"foo", `2`, 2.0}, + {"foo", `true`, true}, + {"foo", `null`, nil}, + + {nil, `null`, nil}, + {new(int), `null`, nil}, + {(*int)(nil), `null`, nil}, + {new(*int), `null`, new(*int)}, + {(**int)(nil), `null`, nil}, + {intp(1), `null`, nil}, + {intpp(nil), `null`, intpp(nil)}, + {intpp(intp(1)), `null`, intpp(nil)}, +} + +func TestInterfaceSet(t *testing.T) { + for _, tt := range interfaceSetTests { + b := struct{ X interface{} }{tt.pre} + blob := `{"X":` + tt.json + `}` + if err := Unmarshal([]byte(blob), &b); err != nil { + t.Errorf("Unmarshal %#q: %v", blob, err) + continue + } + if !reflect.DeepEqual(b.X, tt.post) { + t.Errorf("Unmarshal %#q into %#v: X=%#v, want %#v", blob, tt.pre, b.X, tt.post) + } + } +} + +// JSON null values should be ignored for primitives and string values instead of resulting in an error. +// Issue 2540 +func TestUnmarshalNulls(t *testing.T) { + jsonData := []byte(`{ + "Bool" : null, + "Int" : null, + "Int8" : null, + "Int16" : null, + "Int32" : null, + "Int64" : null, + "Uint" : null, + "Uint8" : null, + "Uint16" : null, + "Uint32" : null, + "Uint64" : null, + "Float32" : null, + "Float64" : null, + "String" : null}`) + + nulls := All{ + Bool: true, + Int: 2, + Int8: 3, + Int16: 4, + Int32: 5, + Int64: 6, + Uint: 7, + Uint8: 8, + Uint16: 9, + Uint32: 10, + Uint64: 11, + Float32: 12.1, + Float64: 13.1, + String: "14"} + + err := Unmarshal(jsonData, &nulls) + if err != nil { + t.Errorf("Unmarshal of null values failed: %v", err) + } + if !nulls.Bool || nulls.Int != 2 || nulls.Int8 != 3 || nulls.Int16 != 4 || nulls.Int32 != 5 || nulls.Int64 != 6 || + nulls.Uint != 7 || nulls.Uint8 != 8 || nulls.Uint16 != 9 || nulls.Uint32 != 10 || nulls.Uint64 != 11 || + nulls.Float32 != 12.1 || nulls.Float64 != 13.1 || nulls.String != "14" { + + t.Errorf("Unmarshal of null values affected primitives") + } +} + +func TestStringKind(t *testing.T) { + type stringKind string + + var m1, m2 map[stringKind]int + m1 = map[stringKind]int{ + "foo": 42, + } + + data, err := Marshal(m1) + if err != nil { + t.Errorf("Unexpected error marshalling: %v", err) + } + + err = Unmarshal(data, &m2) + if err != nil { + t.Errorf("Unexpected error unmarshalling: %v", err) + } + + if !reflect.DeepEqual(m1, m2) { + t.Error("Items should be equal after encoding and then decoding") + } + +} + +var decodeTypeErrorTests = []struct { + dest interface{} + src string +}{ + {new(string), `{"user": "name"}`}, // issue 4628. + {new(error), `{}`}, // issue 4222 + {new(error), `[]`}, + {new(error), `""`}, + {new(error), `123`}, + {new(error), `true`}, +} + +func TestUnmarshalTypeError(t *testing.T) { + for _, item := range decodeTypeErrorTests { + err := Unmarshal([]byte(item.src), item.dest) + if _, ok := err.(*UnmarshalTypeError); !ok { + t.Errorf("expected type error for Unmarshal(%q, type %T): got %T", + item.src, item.dest, err) + } + } +} + +var unmarshalSyntaxTests = []string{ + "tru", + "fals", + "nul", + "123e", + `"hello`, + `[1,2,3`, + `{"key":1`, + `{"key":1,`, +} + +func TestUnmarshalSyntax(t *testing.T) { + var x interface{} + for _, src := range unmarshalSyntaxTests { + err := Unmarshal([]byte(src), &x) + if _, ok := err.(*SyntaxError); !ok { + t.Errorf("expected syntax error for Unmarshal(%q): got %T", src, err) + } + } +} + +// Test handling of unexported fields that should be ignored. +// Issue 4660 +type unexportedFields struct { + Name string + m map[string]interface{} `json:"-"` + m2 map[string]interface{} `json:"abcd"` +} + +func TestUnmarshalUnexported(t *testing.T) { + input := `{"Name": "Bob", "m": {"x": 123}, "m2": {"y": 456}, "abcd": {"z": 789}}` + want := &unexportedFields{Name: "Bob"} + + out := &unexportedFields{} + err := Unmarshal([]byte(input), out) + if err != nil { + t.Errorf("got error %v, expected nil", err) + } + if !reflect.DeepEqual(out, want) { + t.Errorf("got %q, want %q", out, want) + } +} + +// Time3339 is a time.Time which encodes to and from JSON +// as an RFC 3339 time in UTC. +type Time3339 time.Time + +func (t *Time3339) UnmarshalJSON(b []byte) error { + if len(b) < 2 || b[0] != '"' || b[len(b)-1] != '"' { + return fmt.Errorf("types: failed to unmarshal non-string value %q as an RFC 3339 time", b) + } + tm, err := time.Parse(time.RFC3339, string(b[1:len(b)-1])) + if err != nil { + return err + } + *t = Time3339(tm) + return nil +} + +func TestUnmarshalJSONLiteralError(t *testing.T) { + var t3 Time3339 + err := Unmarshal([]byte(`"0000-00-00T00:00:00Z"`), &t3) + if err == nil { + t.Fatalf("expected error; got time %v", time.Time(t3)) + } + if !strings.Contains(err.Error(), "range") { + t.Errorf("got err = %v; want out of range error", err) + } +} + +// Test that extra object elements in an array do not result in a +// "data changing underfoot" error. +// Issue 3717 +func TestSkipArrayObjects(t *testing.T) { + json := `[{}]` + var dest [0]interface{} + + err := Unmarshal([]byte(json), &dest) + if err != nil { + t.Errorf("got error %q, want nil", err) + } +} + +// Test semantics of pre-filled struct fields and pre-filled map fields. +// Issue 4900. +func TestPrefilled(t *testing.T) { + ptrToMap := func(m map[string]interface{}) *map[string]interface{} { return &m } + + // Values here change, cannot reuse table across runs. + var prefillTests = []struct { + in string + ptr interface{} + out interface{} + }{ + { + in: `{"X": 1, "Y": 2}`, + ptr: &XYZ{X: float32(3), Y: int16(4), Z: 1.5}, + out: &XYZ{X: float64(1), Y: float64(2), Z: 1.5}, + }, + { + in: `{"X": 1, "Y": 2}`, + ptr: ptrToMap(map[string]interface{}{"X": float32(3), "Y": int16(4), "Z": 1.5}), + out: ptrToMap(map[string]interface{}{"X": float64(1), "Y": float64(2), "Z": 1.5}), + }, + } + + for _, tt := range prefillTests { + ptrstr := fmt.Sprintf("%v", tt.ptr) + err := Unmarshal([]byte(tt.in), tt.ptr) // tt.ptr edited here + if err != nil { + t.Errorf("Unmarshal: %v", err) + } + if !reflect.DeepEqual(tt.ptr, tt.out) { + t.Errorf("Unmarshal(%#q, %s): have %v, want %v", tt.in, ptrstr, tt.ptr, tt.out) + } + } +} + +var invalidUnmarshalTests = []struct { + v interface{} + want string +}{ + {nil, "json: Unmarshal(nil)"}, + {struct{}{}, "json: Unmarshal(non-pointer struct {})"}, + {(*int)(nil), "json: Unmarshal(nil *int)"}, +} + +func TestInvalidUnmarshal(t *testing.T) { + buf := []byte(`{"a":"1"}`) + for _, tt := range invalidUnmarshalTests { + err := Unmarshal(buf, tt.v) + if err == nil { + t.Errorf("Unmarshal expecting error, got nil") + continue + } + if got := err.Error(); got != tt.want { + t.Errorf("Unmarshal = %q; want %q", got, tt.want) + } + } +} diff --git a/vendor/src/github.com/jfrazelle/go/canonical/json/encode.go b/vendor/src/github.com/jfrazelle/go/canonical/json/encode.go new file mode 100644 index 0000000000..655f1a6661 --- /dev/null +++ b/vendor/src/github.com/jfrazelle/go/canonical/json/encode.go @@ -0,0 +1,1234 @@ +// Copyright 2010 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Package json implements encoding and decoding of JSON objects as defined in +// RFC 4627. The mapping between JSON objects and Go values is described +// in the documentation for the Marshal and Unmarshal functions. +// +// See "JSON and Go" for an introduction to this package: +// http://golang.org/doc/articles/json_and_go.html +package json + +import ( + "bytes" + "encoding" + "encoding/base64" + "math" + "reflect" + "runtime" + "sort" + "strconv" + "strings" + "sync" + "unicode" + "unicode/utf8" +) + +// Marshal returns the JSON encoding of v. +// +// Marshal traverses the value v recursively. +// If an encountered value implements the Marshaler interface +// and is not a nil pointer, Marshal calls its MarshalJSON method +// to produce JSON. The nil pointer exception is not strictly necessary +// but mimics a similar, necessary exception in the behavior of +// UnmarshalJSON. +// +// Otherwise, Marshal uses the following type-dependent default encodings: +// +// Boolean values encode as JSON booleans. +// +// Floating point, integer, and Number values encode as JSON numbers. +// +// String values encode as JSON strings coerced to valid UTF-8, +// replacing invalid bytes with the Unicode replacement rune. +// The angle brackets "<" and ">" are escaped to "\u003c" and "\u003e" +// to keep some browsers from misinterpreting JSON output as HTML. +// Ampersand "&" is also escaped to "\u0026" for the same reason. +// +// Array and slice values encode as JSON arrays, except that +// []byte encodes as a base64-encoded string, and a nil slice +// encodes as the null JSON object. +// +// Struct values encode as JSON objects. Each exported struct field +// becomes a member of the object unless +// - the field's tag is "-", or +// - the field is empty and its tag specifies the "omitempty" option. +// The empty values are false, 0, any +// nil pointer or interface value, and any array, slice, map, or string of +// length zero. The object's default key string is the struct field name +// but can be specified in the struct field's tag value. The "json" key in +// the struct field's tag value is the key name, followed by an optional comma +// and options. Examples: +// +// // Field is ignored by this package. +// Field int `json:"-"` +// +// // Field appears in JSON as key "myName". +// Field int `json:"myName"` +// +// // Field appears in JSON as key "myName" and +// // the field is omitted from the object if its value is empty, +// // as defined above. +// Field int `json:"myName,omitempty"` +// +// // Field appears in JSON as key "Field" (the default), but +// // the field is skipped if empty. +// // Note the leading comma. +// Field int `json:",omitempty"` +// +// The "string" option signals that a field is stored as JSON inside a +// JSON-encoded string. It applies only to fields of string, floating point, +// or integer types. This extra level of encoding is sometimes used when +// communicating with JavaScript programs: +// +// Int64String int64 `json:",string"` +// +// The key name will be used if it's a non-empty string consisting of +// only Unicode letters, digits, dollar signs, percent signs, hyphens, +// underscores and slashes. +// +// Anonymous struct fields are usually marshaled as if their inner exported fields +// were fields in the outer struct, subject to the usual Go visibility rules amended +// as described in the next paragraph. +// An anonymous struct field with a name given in its JSON tag is treated as +// having that name, rather than being anonymous. +// An anonymous struct field of interface type is treated the same as having +// that type as its name, rather than being anonymous. +// +// The Go visibility rules for struct fields are amended for JSON when +// deciding which field to marshal or unmarshal. If there are +// multiple fields at the same level, and that level is the least +// nested (and would therefore be the nesting level selected by the +// usual Go rules), the following extra rules apply: +// +// 1) Of those fields, if any are JSON-tagged, only tagged fields are considered, +// even if there are multiple untagged fields that would otherwise conflict. +// 2) If there is exactly one field (tagged or not according to the first rule), that is selected. +// 3) Otherwise there are multiple fields, and all are ignored; no error occurs. +// +// Handling of anonymous struct fields is new in Go 1.1. +// Prior to Go 1.1, anonymous struct fields were ignored. To force ignoring of +// an anonymous struct field in both current and earlier versions, give the field +// a JSON tag of "-". +// +// Map values encode as JSON objects. +// The map's key type must be string; the object keys are used directly +// as map keys. +// +// Pointer values encode as the value pointed to. +// A nil pointer encodes as the null JSON object. +// +// Interface values encode as the value contained in the interface. +// A nil interface value encodes as the null JSON object. +// +// Channel, complex, and function values cannot be encoded in JSON. +// Attempting to encode such a value causes Marshal to return +// an UnsupportedTypeError. +// +// JSON cannot represent cyclic data structures and Marshal does not +// handle them. Passing cyclic structures to Marshal will result in +// an infinite recursion. +// +func Marshal(v interface{}) ([]byte, error) { + return marshal(v, false) +} + +// MarshalIndent is like Marshal but applies Indent to format the output. +func MarshalIndent(v interface{}, prefix, indent string) ([]byte, error) { + b, err := Marshal(v) + if err != nil { + return nil, err + } + var buf bytes.Buffer + err = Indent(&buf, b, prefix, indent) + if err != nil { + return nil, err + } + return buf.Bytes(), nil +} + +// MarshalCanonical is like Marshal but encodes into Canonical JSON. +// Read more at: http://wiki.laptop.org/go/Canonical_JSON +func MarshalCanonical(v interface{}) ([]byte, error) { + return marshal(v, true) +} + +func marshal(v interface{}, canonical bool) ([]byte, error) { + e := &encodeState{canonical: canonical} + err := e.marshal(v) + if err != nil { + return nil, err + } + return e.Bytes(), nil +} + +// HTMLEscape appends to dst the JSON-encoded src with <, >, &, U+2028 and U+2029 +// characters inside string literals changed to \u003c, \u003e, \u0026, \u2028, \u2029 +// so that the JSON will be safe to embed inside HTML
F7Ei6C$5KBHAQ2_SN!+* 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 O?UJOdic_-F>Hh$hF~lJN literal 0 HcmV?d00001 diff --git a/docs/userguide/storagedriver/imagesandcontainers.md b/docs/userguide/storagedriver/imagesandcontainers.md new file mode 100644 index 0000000000..5bbb526a71 --- /dev/null +++ b/docs/userguide/storagedriver/imagesandcontainers.md @@ -0,0 +1,255 @@ + + + +# Understand images, containers, and storage drivers + +To use storage drivers effectively, you must understand how Docker builds and +stores images. Then, you need an understanding of how these images are used in containers. Finally, you'll need a short introduction to the technologies that enable both images and container operations. + +## Images and containers rely on layers + +Docker images are a series of read-only layers that are stacked +on top of each other to form a single unified view. The first image in the stack +is called a *base image* and all the other layers are stacked on top of this +layer. The diagram below shows the Ubuntu 15:04 image comprising 4 stacked image layers. + +![](images/image-layers.jpg) + +When you make a change inside a container by, for example, adding a new file to the Ubuntu 15.04 image, you add a new layer on top of the underlying image stack. This change creates a new image layer containing the newly added file. Each image layer has its own universal unique identifier (UUID) and each successive image layer builds on top of the image layer below it. + +Containers (in the storage context) are a combination of a Docker image with a +thin writable layer added to the top known as the *container layer*. The diagram below shows a container running the Ubuntu 15.04 image. + +![](images/container-layers.jpg) + +The major difference between a container and an image is this writable layer. All writes to the container that add new or modifying existing data are stored in this writable layer. When the container is deleted the writeable layer is also deleted. The image remains unchanged. + +Because each container has its own thin writable container layer and all data is stored this container layer, this means that multiple containers can share access to the same underlying image and yet have their own data state. The diagram below shows multiple containers sharing the same Ubuntu 15.04 image. + +![](images/sharing-layers.jpg) + +A storage driver is responsible for enabling and managing both the image layers and the writeable container layer. How a storage driver accomplishes these behaviors can vary. Two key technologies behind Docker image and container management are stackable image layers and copy-on-write (CoW). + + +## The copy-on-write strategy + +Sharing is a good way to optimize resources. People do this instinctively in +daily life. For example, twins Jane and Joseph taking an Algebra class at +different times from different teachers can share the same exercise book by +passing it between each other. Now, suppose Jane gets an assignment to complete +the homework on page 11 in the book. At that point, Jane copy page 11, complete the homework, and hand in her copy. The original exercise book is unchanged and only Jane has a copy of the changed page 11. + +Copy-on-write is a similar strategy of sharing and copying. In this strategy, +system processes that need the same data share the same instance of that data +rather than having their own copy. At some point, if one process needs to modify +or write to the data, only then does the operating system make a copy of the +data for that process to use. Only the process that needs to write has access to +the data copy. All the other processes continue to use the original data. + +Docker uses a copy-on-write technology with both images and containers. This CoW +strategy optimizes both image disk space usage and the performance of container +start times. The next sections look at how copy-on-write is leveraged with +images and containers thru sharing and copying. + +### Sharing promotes smaller images + +This section looks at image layers and copy-on-write technology. All image and container layers exist inside the Docker host's *local storage area* and are managed by the storage driver. It is a location on the host's +filesystem. + +The Docker client reports on image layers when instructed to pull and push +images with `docker pull` and `docker push`. The command below pulls the +`ubuntu:15.04` Docker image from Docker Hub. + + $ docker pull ubuntu:15.04 + 15.04: Pulling from library/ubuntu + 6e6a100fa147: Pull complete + 13c0c663a321: Pull complete + 2bd276ed39d5: Pull complete + 013f3d01d247: Pull complete + Digest: sha256:c7ecf33cef00ae34b131605c31486c91f5fd9a76315d075db2afd39d1ccdf3ed + Status: Downloaded newer image for ubuntu:15.04 + +From the output, you'll see that the command actually pulls 4 image layers. +Each of the above lines lists an image layer and its UUID. The combination of +these four layers makes up the `ubuntu:15.04` Docker image. + +The image layers are stored in the Docker host's local storage area. Typically, +the local storage area is in the host's `/var/lib/docker` directory. Depending +on which storage driver the local storage area may be in a different location. You can list the layers in the local storage area. The following example shows the storage as it appears under the AUFS storage driver: + + $ sudo ls /var/lib/docker/aufs/layers + 013f3d01d24738964bb7101fa83a926181d600ebecca7206dced59669e6e6778 2bd276ed39d5fcfd3d00ce0a190beeea508332f5aec3c6a125cc619a3fdbade6 + 13c0c663a321cd83a97f4ce1ecbaf17c2ba166527c3b06daaefe30695c5fcb8c 6e6a100fa147e6db53b684c8516e3e2588b160fd4898b6265545d5d4edb6796d + +If you `pull` another image that shares some of the same image layers as the `ubuntu:15.04` image, the Docker daemon recognize this, and only pull the layers it hasn't already stored. After the second pull, the two images will share any common image layers. + +You can illustrate this now for yourself. Starting the `ubuntu:15.04` image that +you just pulled, make a change to it, and build a new image based on the change. +One way to do this is using a Dockerfile and the `docker build` command. + +1. In an empty directory, create a simple `Dockerfile` that starts with the ubuntu:15.04 image. + + FROM ubuntu:15.04 + +2. Add a new file called "newfile" in the image's `/tmp` directory with the text "Hello world" in it. + + When you are done, the `Dockerfile` contains two lines: + + FROM ubuntu:15.04 + + RUN echo "Hello world" > /tmp/newfile + +3. Save and close the file. + +2. From a terminal in the same folder as your Dockerfile, run the following command: + + $ docker build -t changed-ubuntu . + Sending build context to Docker daemon 2.048 kB + Step 0 : FROM ubuntu:15.04 + ---> 013f3d01d247 + Step 1 : RUN echo "Hello world" > /tmp/newfile + ---> Running in 2023460815df + ---> 03b964f68d06 + Removing intermediate container 2023460815df + Successfully built 03b964f68d06 + + > **Note:** The period (.) at the end of the above command is important. It tells the `docker build` command to use the current working directory as its build context. + + The output above shows a new image with image ID `03b964f68d06`. + +3. Run the `docker images` command to verify the new image is in the Docker host's local storage area. + + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + changed-ubuntu latest 03b964f68d06 33 seconds ago 131.4 MB + ubuntu + +4. Run the `docker history` command to see which image layers were used to create the new `changed-ubuntu` image. + + $ docker history changed-ubuntu + IMAGE CREATED CREATED BY SIZE COMMENT + 03b964f68d06 About a minute ago /bin/sh -c echo "Hello world" > /tmp/newfile 12 B + 013f3d01d247 6 weeks ago /bin/sh -c #(nop) CMD ["/bin/bash"] 0 B + 2bd276ed39d5 6 weeks ago /bin/sh -c sed -i 's/^#\s*\(deb.*universe\)$/ 1.879 kB + 13c0c663a321 6 weeks ago /bin/sh -c echo '#!/bin/sh' > /usr/sbin/polic 701 B + 6e6a100fa147 6 weeks ago /bin/sh -c #(nop) ADD file:49710b44e2ae0edef4 131.4 MB + + The `docker history` output shows the new `03b964f68d06` image layer at the + top. You know that the `03b964f68d06` layer was added because it was created + by the `echo "Hello world" > /tmp/newfile` command in your `Dockerfile`. + The 4 image layers below it are the exact same image layers the make up the + ubuntu:15.04 image as their UUIDs match. + +5. List the contents of the local storage area to further confirm. + + $ sudo ls /var/lib/docker/aufs/layers + 013f3d01d24738964bb7101fa83a926181d600ebecca7206dced59669e6e6778 2bd276ed39d5fcfd3d00ce0a190beeea508332f5aec3c6a125cc619a3fdbade6 + 03b964f68d06a373933bd6d61d37610a34a355c168b08dfc604f57b20647e073 6e6a100fa147e6db53b684c8516e3e2588b160fd4898b6265545d5d4edb6796d + 13c0c663a321cd83a97f4ce1ecbaf17c2ba166527c3b06daaefe30695c5fcb8c + + Where before you had four layers stored, you now have 5. + +Notice the new `changed-ubuntu` image does not have its own copies of every layer. As can be seen in the diagram below, the new image is sharing it's four underlying layers with the `ubuntu:15.04` image. + +![](images/saving-space.jpg) + +The `docker history` command also shows the size of each image layer. The `03b964f68d06` is only consuming 13 Bytes of disk space. Because all of the layers below it already exist on the Docker host and are shared with the `ubuntu15:04` image, this means the entire `changed-ubuntu` image only consumes 13 Bytes of disk space. + +This sharing of image layers is what makes Docker images and containers so space +efficient. + +### Copying makes containers efficient + +You learned earlier that a container a Docker image with a thin writable, container layer added. The diagram below shows the layers of a container based on the `ubuntu:15.04` image: + +![](images/container-layers.jpg) + +All writes made to a container are stored in the thin writable container layer. The other layers are read-only (RO) image layers and can't be changed. This means that multiple containers can safely share a single underlying image. The diagram below shows multiple containers sharing a single copy of the `ubuntu:15.04` image. Each container has its own thin RW layer, but they all share a single instance of the ubuntu:15.04 image: + +![](images/sharing-layers.jpg) + +When a write operation occurs in a container, Docker uses the storage driver to perform a copy-on-write operation. The type of operation depends on the storage driver. For AUFS and OverlayFS storage drivers the copy-on-write operation is pretty much as follows: + +* Search through the layers for the file to update. The process starts at the top, newest layer and works down to the base layer one-at-a-time. +* Perform a "copy-up" operation on the first copy of the file that is found. A "copy up" copies the file up to the container's own thin writable layer. +* Modify the *copy of the file* in container's thin writable layer. + +BTFS, ZFS, and other drivers handle the copy-on-write differently. You can read more about the methods of these drivers later in their detailed descriptions. + +Containers that write a lot of data will consume more space than containers that do not. This is because most write operations consume new space in the containers thin writable top layer. If your container needs to write a lot of data, you can use a data volume. + +A copy-up operation can incur a noticeable performance overhead. This overhead is different depending on which storage driver is in use. However, large files, lots of layers, and deep directory trees can make the impact more noticeable. Fortunately, the operation only occurs the first time any particular file is modified. Subsequent modifications to the same file do not cause a copy-up operation and can operate directly on the file's existing copy already present in container layer. + +Let's see what happens if we spin up 5 containers based on our `changed-ubuntu` image we built earlier: + +1. From a terminal on your Docker host, run the following `docker run` command 5 times. + + $ docker run -dit changed-ubuntu bash + 75bab0d54f3cf193cfdc3a86483466363f442fba30859f7dcd1b816b6ede82d4 + $ docker run -dit changed-ubuntu bash + 9280e777d109e2eb4b13ab211553516124a3d4d4280a0edfc7abf75c59024d47 + $ docker run -dit changed-ubuntu bash + a651680bd6c2ef64902e154eeb8a064b85c9abf08ac46f922ad8dfc11bb5cd8a + $ docker run -dit changed-ubuntu bash + 8eb24b3b2d246f225b24f2fca39625aaad71689c392a7b552b78baf264647373 + $ docker run -dit changed-ubuntu bash + 0ad25d06bdf6fca0dedc38301b2aff7478b3e1ce3d1acd676573bba57cb1cfef + + This launches 5 containers based on the `changed-ubuntu` image. As the container is created, Docker adds a writable layer and assigns it a UUID. This is the value returned from the `docker run` command. + +2. Run the `docker ps` command to verify the 5 containers are running. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 0ad25d06bdf6 changed-ubuntu "bash" About a minute ago Up About a minute stoic_ptolemy + 8eb24b3b2d24 changed-ubuntu "bash" About a minute ago Up About a minute pensive_bartik + a651680bd6c2 changed-ubuntu "bash" 2 minutes ago Up 2 minutes hopeful_turing + 9280e777d109 changed-ubuntu "bash" 2 minutes ago Up 2 minutes backstabbing_mahavira + 75bab0d54f3c changed-ubuntu "bash" 2 minutes ago Up 2 minutes boring_pasteur + + The output above shows 5 running containers, all sharing the `changed-ubuntu` image. Each `CONTAINER ID` is derived from the UUID when creating each container. + +3. List the contents of the local storage area. + + $ sudo ls containers + 0ad25d06bdf6fca0dedc38301b2aff7478b3e1ce3d1acd676573bba57cb1cfef 9280e777d109e2eb4b13ab211553516124a3d4d4280a0edfc7abf75c59024d47 + 75bab0d54f3cf193cfdc3a86483466363f442fba30859f7dcd1b816b6ede82d4 a651680bd6c2ef64902e154eeb8a064b85c9abf08ac46f922ad8dfc11bb5cd8a + 8eb24b3b2d246f225b24f2fca39625aaad71689c392a7b552b78baf264647373 + +Docker's copy-on-write strategy not only reduces the amount of space consumed by containers, it also reduces the time required to start a container. At start time, Docker only has to create the thin writable layer for each container. The diagram below shows these 5 containers sharing a single read-only (RO) copy of the `changed-ubuntu` image. + +![](images/shared-uuid.jpg) + +If Docker had to make an entire copy of the underlying image stack each time it +started a new container, container start times and disk space used would be +significantly increased. + +## Data volumes and the storage driver + +When a container is deleted, any data written to the container that is not stored in a *data volume* is deleted along with the container. A data volume is directory or file that is mounted directly into a container. + +Data volumes are not controlled by the storage driver. Reads and writes to data +volumes bypass the storage driver and operate at native host speeds. You can mount any number of data volumes into a container. Multiple containers can also share one or more data volumes. + +The diagram below shows a single Docker host running two containers. Each container exists inside of its own address space within the Docker host's local storage area. There is also a single shared data volume located at `/data` on the Docker host. This is mounted directly into both containers. + +![](images/shared-volume.jpg) + +The data volume resides outside of the local storage area on the Docker host further reinforcing its independence from the storage driver's control. When a container is deleted, any data stored in shared data volumes persists on the Docker host. + +For detailed information about data volumes [Managing data in containers](https://docs.docker.com/userguide/dockervolumes/). + +## Related information + +* [Select a storage driver](selectadriver.md) +* [AUFS storage driver in practice](aufs-driver.md) +* [Btrfs storage driver in practice](btrfs-driver.md) +* [Device Mapper storage driver in practice](device-mapper-driver.md) diff --git a/docs/userguide/storagedriver/index.md b/docs/userguide/storagedriver/index.md new file mode 100644 index 0000000000..f37a6f9eec --- /dev/null +++ b/docs/userguide/storagedriver/index.md @@ -0,0 +1,38 @@ + + + +# Docker storage drivers + +Docker relies on driver technology to manage the storage and interactions associated with images and they containers that run them. This section contains the following pages: + +* [Understand images, containers, and storage drivers](imagesandcontainers.md) +* [Select a storage driver](selectadriver.md) +* [AUFS storage driver in practice](aufs-driver.md) +* [Btrfs storage driver in practice](btrfs-driver.md) +* [Device Mapper storage driver in practice](device-mapper-driver.md) +* [OverlayFS in practice](overlayfs-driver.md) +* [ZFS storage in practice](zfs-driver.md) + +If you are new to Docker containers make sure you read ["Understand images, containers, and storage drivers"](imagesandcontainers.md) first. It explains key concepts and technologies that can help you when working with storage drivers. + +### Acknowledgement + +The Docker storage driver material was created in large part by our guest author +Nigel Poulton with a bit of help from Docker's own Jérôme Petazzoni. In his +spare time Nigel creates [IT training +videos](http://www.pluralsight.com/author/nigel-poulton), co-hosts the weekly +[In Tech We Trust podcast](http://intechwetrustpodcast.com/), and lives it large +on [Twitter](https://twitter.com/nigelpoulton). + + +  diff --git a/docs/userguide/storagedriver/overlayfs-driver.md b/docs/userguide/storagedriver/overlayfs-driver.md new file mode 100644 index 0000000000..ee72e62bf2 --- /dev/null +++ b/docs/userguide/storagedriver/overlayfs-driver.md @@ -0,0 +1,190 @@ + + +# Docker and OverlayFS in practice + +OverlayFS is a modern *union filesystem* that is similar to AUFS. In comparison to AUFS, OverlayFS: + +* has a simpler design +* has been in the mainline Linux kernel since version 3.18 +* is potentially faster + +As a result, OverlayFS is rapidly gaining popularity in the Docker community and is seen by many as a natural successor to AUFS. As promising as OverlayFS is, it is still relatively young. Therefore caution should be taken before using it in production Docker environments. + +Docker's `overlay` storage driver leverages several OverlayFS features to build and manage the on-disk structures of images and containers. + +>**Note**: Since it was merged into the mainline kernel, the OverlayFS *kernel module* was renamed from "overlayfs" to "overlay". As a result you may see the two terms used interchangeably in some documentation. However, this document uses "OverlayFS" to refer to the overall filesystem, and `overlay` to refer to Docker's storage-driver. + + +## Image layering and sharing with OverlayFS + +OverlayFS takes two directories on a single Linux host, layers one on top of the other, and provides a single unified view. These directories are often referred to as *layers* and the technology used to layer them is is known as a *union mount*. The OverlayFS terminology is "lowerdir" for the bottom layer and "upperdir" for the top layer. The unified view is exposed through its own directory called "merged". + +The diagram below shows how a Docker image and a Docker container are layered. The image layer is the "lowerdir" and the container layer is the "upperdir". The unified view is exposed through a directory called "merged" which is effectively the containers mount point. The diagram shows how Docker constructs map to OverlayFS constructs. + +![](images/overlay_constructs.jpg) + +Notice how the image layer and container layer can contain the same files. When this happens, the files in the container layer ("upperdir") are dominant and obscure the existence of the same files in the image layer ("lowerdir"). The container mount ("merged") presents the unified view. + +OverlayFS only works with two layers. This means that multi-layered images cannot be implemented as multiple OverlayFS layers. Instead, each image layer is implemented as its own directory under `/var/lib/docker/overlay`. Hard links are then used as a space-efficient way to reference data shared with lower layers. The diagram below shows a four-layer image and how it is represented in the Docker host's filesystem. + +![](images/overlay_constructs2.jpg) + +To create a container, the `overlay` driver combines the directory representing the image's top layer plus a new directory for the container. The image's top layer is the "lowerdir" in the overlay and read-only. The new directory for the container is the "upperdir" and is writable. + +## Example: Image and container on-disk constructs + +The following `docker images -a` command shows a Docker host with a single image. As can be seen, the image consists of four layers. + + $ docker images -a + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + ubuntu latest 1d073211c498 7 days ago 187.9 MB + 5a4526e952f0 7 days ago 187.9 MB + 99fcaefe76ef 7 days ago 187.9 MB + c63fb41c2213 7 days ago 187.7 MB + +Below, the command's output illustrates that each of the four image layers has it's own directory under `/var/lib/docker/overlay/`. + + $ ls -l /var/lib/docker/overlay/ + total 24 + drwx------ 3 root root 4096 Oct 28 11:02 1d073211c498fd5022699b46a936b4e4bdacb04f637ad64d3475f558783f5c3e + drwx------ 3 root root 4096 Oct 28 11:02 5a4526e952f0aa24f3fcc1b6971f7744eb5465d572a48d47c492cb6bbf9cbcda + drwx------ 5 root root 4096 Oct 28 11:06 99fcaefe76ef1aa4077b90a413af57fd17d19dce4e50d7964a273aae67055235 + drwx------ 3 root root 4096 Oct 28 11:01 c63fb41c2213f511f12f294dd729b9903a64d88f098c20d2350905ac1fdbcbba + +Each directory is named after the image layer IDs in the previous `docker images -a` command. The image layer directories contain the files unique to that layer as well as hard links to the data that is shared with lower layers. This allows for efficient use of disk space. + +The following `docker ps` command shows the same Docker host running a single container. The container ID is "73de7176c223". + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 73de7176c223 ubuntu "bash" 2 days ago Up 2 days stupefied_nobel + +This container exists on-disk in the Docker host's filesystem under `/var/lib/docker/overlay/73de7176c223...`. If you inspect this directory using the `ls -l` command you find the following file and directories. + + $ ls -l /var/lib/docker/overlay/73de7176c223a6c82fd46c48c5f152f2c8a7e49ecb795a7197c3bb795c4d879e + total 16 + -rw-r--r-- 1 root root 64 Oct 28 11:06 lower-id + drwxr-xr-x 1 root root 4096 Oct 28 11:06 merged + drwxr-xr-x 4 root root 4096 Oct 28 11:06 upper + drwx------ 3 root root 4096 Oct 28 11:06 work + +These four filesystem objects are all artifacts of OverlayFS. The "lower-id" file contains the ID of the top layer of the image the container is based on. This is used by OverlayFS as the "lowerdir". + + $ cat /var/lib/docker/overlay/73de7176c223a6c82fd46c48c5f152f2c8a7e49ecb795a7197c3bb795c4d879e/lower-id + 1d073211c498fd5022699b46a936b4e4bdacb04f637ad64d3475f558783f5c3e + +The "upper" directory is the containers read-write layer. Any changes made to the container are written to this directory. + +The "merged" directory is effectively the containers mount point. This is where the unified view of the image ("lowerdir") and container ("upperdir") is exposed. Any changes written to the container are immediately reflected in this directory. + +The "work" directory is required for OverlayFS to function. It is used for things such as *copy_up* operations. + +You can verify all of these constructs from the output of the `mount` command. (Ellipses and line breaks are used in the output below to enhance readability.) + + $ mount | grep overlay + overlay on /var/lib/docker/overlay/73de7176c223.../merged + type overlay (rw,relatime,lowerdir=/var/lib/docker/overlay/1d073211c498.../root, + upperdir=/var/lib/docker/overlay/73de7176c223.../upper, + workdir=/var/lib/docker/overlay/73de7176c223.../work) + +The output reflects the overlay is mounted as read-write ("rw"). + +## Container reads and writes with overlay + +Consider three scenarios where a container opens a file for read access with overlay. + +- **The file does not exist in the container layer**. If a container opens a file for read access and the file does not already exist in the container ("upperdir") it is read from the image ("lowerdir"). This should incur very little performance overhead. + +- **The file only exists in the container layer**. If a container opens a file for read access and the file exists in the container ("upperdir") and not in the image ("lowerdir"), it is read directly from the container. + +- **The file exists in the container layer and the image layer**. If a container opens a file for read access and the file exists in the image layer and the container layer, the file's version in the container layer is read. This is because files in the container layer ("upperdir") obscure files with the same name in the image layer ("lowerdir"). + +Consider some scenarios where files in a container are modified. + +- **Writing to a file for the first time**. The first time a container writes to an existing file, that file does not exist in the container ("upperdir"). The `overlay` driver performs a *copy_up* operation to copy the file from the image ("lowerdir") to the container ("upperdir"). The container then writes the changes to the new copy of the file in the container layer. + + However, OverlayFS works at the file level not the block level. This means that all OverlayFS copy-up operations copy entire files, even if the file is very large and only a small part of it is being modified. This can have a noticeable impact on container write performance. However, two things are worth noting: + + * The copy_up operation only occurs the first time any given file is written to. Subsequent writes to the same file will operate against the copy of the file already copied up to the container. + + * OverlayFS only works with two layers. This means that performance should be better than AUFS which can suffer noticeable latencies when searching for files in images with many layers. + +- **Deleting files and directories**. When files are deleted within a container a *whiteout* file is created in the containers "upperdir". The version of the file in the image layer ("lowerdir") is not deleted. However, the whiteout file in the container obscures it. + + Deleting a directory in a container results in *opaque directory* being created in the "upperdir". This has the same effect as a whiteout file and effectively masks the existence of the directory in the image's "lowerdir". + +## Configure Docker with the overlay storage driver + +To configure Docker to use the overlay storage driver your Docker host must be running version 3.18 of the Linux kernel (preferably newer) with the overlay kernel module loaded. OverlayFS can operate on top of most supported Linux filesystems. However, ext4 is currently recommended for use in production environments. + +The following procedure shows you how to configure your Docker host to use OverlayFS. The procedure assumes that the Docker daemon is in a stopped state. + +> **Caution:** If you have already run the Docker daemon on your Docker host and have images you want to keep, `push` them Docker Hub or your private Docker Trusted Registry before attempting this procedure. + +1. If it is running, stop the Docker `daemon`. + +2. Verify your kernel version and that the overlay kernel module is loaded. + + $ uname -r + 3.19.0-21-generic + + $ lsmod | grep overlay + overlay + +3. Start the Docker daemon with the `overlay` storage driver. + + $ docker daemon --storage-driver=overlay & + [1] 29403 + root@ip-10-0-0-174:/home/ubuntu# INFO[0000] Listening for HTTP on unix (/var/run/docker.sock) + INFO[0000] Option DefaultDriver: bridge + INFO[0000] Option DefaultNetwork: bridge + + + Alternatively, you can force the Docker daemon to automatically start with + the `overlay` driver by editing the Docker config file and adding the + `--storage-driver=overlay` flag to the `DOCKER_OPTS` line. Once this option + is set you can start the daemon using normal startup scripts without having + to manually pass in the `--storage-driver` flag. + +4. Verify that the daemon is using the `overlay` storage driver + + $ docker info + Containers: 0 + Images: 0 + Storage Driver: overlay + Backing Filesystem: extfs + + + Notice that the *Backing filesystem* in the output above is showing as `extfs`. Multiple backing filesystems are supported but `extfs` (ext4) is recommended for production use cases. + +Your Docker host is now using the `overlay` storage driver. If you run the `mount` command, you'll find Docker has automatically created the `overlay` mount with the required "lowerdir", "upperdir", "merged" and "workdir" constructs. + +## OverlayFS and Docker Performance + +As a general rule, the `overlay` driver should be fast. Almost certainly faster than `aufs` and `devicemapper`. In certain circumstances it may also be faster than `btrfs`. That said, there are a few things to be aware of relative to the performance of Docker using the `overlay` storage driver. + +- **Page Caching**. OverlayFS supports page cache sharing. This means multiple containers accessing the same file can share a single page cache entry (or entries). This makes the `overlay` driver efficient with memory and a good option for PaaS and other high density use cases. + +- **copy_up**. As with AUFS, OverlayFS has to perform copy-up operations any time a container writes to a file for the first time. This can insert latency into the write operation — especially if the file being copied up is large. However, once the file has been copied up, all subsequent writes to that file occur without the need for further copy-up operations. + + The OverlayFS copy_up operation should be faster than the same operation with AUFS. This is because AUFS supports more layers than OverlayFS and it is possible to incur far larger latencies if searching through many AUFS layers. + +- **RPMs and Yum**. OverlayFS only implements a subset of the POSIX standards. This can result in certain OverlayFS operations breaking POSIX standards. One such operation is the *copy-up* operation. Therefore, using `yum` inside of a container on a Docker host using the `overlay` storage driver is unlikely to work without implementing workarounds. + +- **Inode limits**. Use of the `overlay` storage driver can cause excessive inode consumption. This is especially so as the number of images and containers on the Docker host grows. A Docker host with a large number of images and lots of started and stopped containers can quickly run out of inodes. + + Unfortunately you can only specify the number of inodes in a filesystem at the time of creation. For this reason, you may wish to consider putting `/var/lib/docker` on a separate device with its own filesystem or manually specifying the number of inodes when creating the filesystem. + +The following generic performance best practices also apply to OverlayFS. + +- **Solid State Devices (SSD)**. For best performance it is always a good idea to use fast storage media such as solid state devices (SSD). + +- **Use Data Volumes**. Data volumes provide the best and most predictable performance. This is because they bypass the storage driver and do not incur any of the potential overheads introduced by thin provisioning and copy-on-write. For this reason, you may want to place heavy write workloads on data volumes. diff --git a/docs/userguide/storagedriver/selectadriver.md b/docs/userguide/storagedriver/selectadriver.md new file mode 100644 index 0000000000..7a54ad759b --- /dev/null +++ b/docs/userguide/storagedriver/selectadriver.md @@ -0,0 +1,119 @@ + + +# Select a storage driver + +This page describes Docker's storage driver feature. It lists the storage +driver's that Docker supports and the basic commands associated with managing them. Finally, this page provides guidance on choosing a storage driver. + +The material on this page is intended for readers who already have an [understanding of the storage driver technology](imagesandcontainers.md). + +## A pluggable storage driver architecture + +The Docker has a pluggable storage driver architecture. This gives you the flexibility to "plug in" the storage driver is best for your environment and use-case. Each Docker storage driver is based on a Linux filesystem or volume manager. Further, each storage driver is free to implement the management of image layers and the container layer in it's own unique way. This means some storage drivers perform better than others in different circumstances. + +Once you decide which driver is best, you set this driver on the Docker daemon at start time. As a result, the Docker daemon can only run one storage driver, and all containers created by that daemon instance use the same storage driver. The table below shows the supported storage driver technologies and the driver names: + +|Technology |Storage driver name | +|--------------|---------------------| +|OverlayFS |`overlay` | +|AUFS |`aufs` | +|Btrfs |`btrfs` | +|Device Maper |`devicemapper` | +|VFS* |`vfs` | +|ZFS |`zfs` | + +To find out which storage driver is set on the daemon , you use the `docker info` command: + + $ docker info + Containers: 0 + Images: 0 + Storage Driver: overlay + Backing Filesystem: extfs + Execution Driver: native-0.2 + Logging Driver: json-file + Kernel Version: 3.19.0-15-generic + Operating System: Ubuntu 15.04 + ... output truncated ... + +The `info` subcommand reveals that the Docker daemon is using the `overlay` storage driver with a `Backing Filesystem` value of `extfs`. The `extfs` value means that the `overlay` storage driver is operating on top of an existing (ext) filesystem. The backing filesystem refers to the filesystem that was used to create the Docker host's local storage area under `/var/lib/docker`. + +Which storage driver you use, in part, depends on the backing filesystem you plan to use for your Docker host's local storage area. Some storage drivers can operate on top of different backing filesystems. However, other storage drivers require the backing filesystem to be the same as the storage driver. For example, the `btrfs` storage driver on a `btrfs` backing filesystem. The following table lists each storage driver and whether it must match the host's backing file system: + + |Storage driver |Must match backing filesystem | + |---------------|------------------------------| + |overlay |No | + |aufs |No | + |btrfs |Yes | + |devicemapper |No | + |vfs* |No | + |zfs |Yes | + + +You pass the `--storage-driver=` option to the `docker daemon` command line or by setting the option on the `DOCKER_OPTS` line in `/etc/defaults/docker` file. + +The following command shows how to start the Docker daemon with the `devicemapper` storage driver using the `docker daemon` command: + + $ docker daemon --storage-driver=devicemapper & + + $ docker info + Containers: 0 + Images: 0 + Storage Driver: devicemapper + Pool Name: docker-252:0-147544-pool + Pool Blocksize: 65.54 kB + Backing Filesystem: extfs + Data file: /dev/loop0 + Metadata file: /dev/loop1 + Data Space Used: 1.821 GB + Data Space Total: 107.4 GB + Data Space Available: 3.174 GB + Metadata Space Used: 1.479 MB + Metadata Space Total: 2.147 GB + Metadata Space Available: 2.146 GB + Udev Sync Supported: true + Deferred Removal Enabled: false + Data loop file: /var/lib/docker/devicemapper/devicemapper/data + Metadata loop file: /var/lib/docker/devicemapper/devicemapper/metadata + Library Version: 1.02.90 (2014-09-01) + Execution Driver: native-0.2 + Logging Driver: json-file + Kernel Version: 3.19.0-15-generic + Operating System: Ubuntu 15.04 + + +Your choice of storage driver can affect the performance of your containerized applications. So it's important to understand the different storage driver options available and select the right one for your application. Later, in this page you'll find some advice for choosing an appropriate driver. + +## Shared storage systems and the storage driver + +Many enterprises consume storage from shared storage systems such as SAN and NAS arrays. These often provide increased performance and availability, as well as advanced features such as thin provisioning, deduplication and compression. + +The Docker storage driver and data volumes can both operate on top of storage provided by shared storage systems. This allows Docker to leverage the increased performance and availability these systems provide. However, Docker does not integrate with these underlying systems. + +Remember that each Docker storage driver is based on a Linux filesystem or volume manager. Be sure to follow existing best practices for operating your storage driver (filesystem or volume manager) on top of your shared storage system. For example, if using the ZFS storage driver on top of *XYZ* shared storage system, be sure to follow best practices for operating ZFS filesystems on top of XYZ shared storage system. + +## Which storage driver should you choose? + +As you might expect, the answer to this question is "it depends". While there are some clear cases where one particular storage driver outperforms other for certain workloads, you should factor all of the following into your decision: + +Choose a storage driver that you and your team/organization are comfortable with. Consider how much experience you have with a particular storage driver. There is no substitute for experience and it is rarely a good idea to try something brand new in production. That's what labs and laptops are for! + +If your Docker infrastructure is under support contracts, choose an option that will get you good support. You probably don't want to go with a solution that your support partners have little or no experience with. + +Whichever driver you choose, make sure it has strong community support and momentum. This is important because storage driver development in the Docker project relies on the community as much as the Docker staff to thrive. + + +## Related information + +* [Understand images, containers, and storage drivers](imagesandcontainers.md) +* [AUFS storage driver in practice](aufs-driver.md) +* [Btrfs storage driver in practice](btrfs-driver.md) +* [Device Mapper storage driver in practice](device-mapper-driver.md) diff --git a/docs/userguide/storagedriver/zfs-driver.md b/docs/userguide/storagedriver/zfs-driver.md new file mode 100644 index 0000000000..75f0d3216b --- /dev/null +++ b/docs/userguide/storagedriver/zfs-driver.md @@ -0,0 +1,218 @@ + + +# Docker and ZFS in practice + +ZFS is a next generation filesystem that supports many advanced storage technologies such as volume management, snapshots, checksumming, compression and deduplication, replication and more. + +It was created by Sun Microsystems (now Oracle Corporation) and is open sourced under the CDDL license. Due to licensing incompatibilities between the CDDL and GPL, ZFS cannot be shipped as part of the mainline Linux kernel. However, the ZFS On Linux (ZoL) project provides an out-of-tree kernel module and userspace tools which can be installed separately. + +The ZFS on Linux (ZoL) port is healthy and maturing. However, at this point in time it is not recommended to use the `zfs` Docker storage driver for production use unless you have substantial experience with ZFS on Linux. + +> **Note:** There is also a FUSE implementation of ZFS on the Linux platform. This should work with Docker but is not recommended. The native ZFS driver (ZoL) is more tested, more performant, and is more widely used. The remainder of this document will relate to the native ZoL port. + + +## Image layering and sharing with ZFS + +The Docker `zfs` storage driver makes extensive use of three ZFS datasets: + +- filesystems +- snapshots +- clones + +ZFS filesystems are thinly provisioned and have space allocated to them from a ZFS pool (zpool) via allocate on demand operations. Snapshots and clones are space-efficient point-in-time copies of ZFS filesystems. Snapshots are read-only. Clones are read-write. Clones can only be created from snapshots. This simple relationship is shown in the diagram below. + +![](images/zfs_clones.jpg) + +The solid line in the diagram shows the process flow for creating a clone. Step 1 creates a snapshot of the filesystem, and step two creates the clone from the snapshot. The dashed line shows the relationship between the clone and the filesystem, via the snapshot. All three ZFS datasets draw space form the same underlying zpool. + +On Docker hosts using the `zfs` storage driver, the base layer of an image is a ZFS filesystem. Each child layer is a ZFS clone based on a ZFS snapshot of the layer below it. A container is a ZFS clone based on a ZFS Snapshot of the top layer of the image it's created from. All ZFS datasets draw their space from a common zpool. The diagram below shows how this is put together with a running container based on a two-layer image. + +![](images/zfs_zpool.jpg) + +The following process explains how images are layered and containers created. The process is based on the diagram above. + +1. The base layer of the image exists on the Docker host as a ZFS filesystem. + + This filesystem consumes space from the zpool used to create the Docker host's local storage area at `/var/lib/docker`. + +2. Additional image layers are clones of the dataset hosting the image layer directly below it. + + In the diagram, "Layer 1" is added by making a ZFS snapshot of the base layer and then creating a clone from that snapshot. The clone is writable and consumes space on-demand from the zpool. The snapshot is read-only, maintaining the base layer as an immutable object. + +3. When the container is launched, a read-write layer is added above the image. + + In the diagram above, the container's read-write layer is created by making a snapshot of the top layer of the image (Layer 1) and creating a clone from that snapshot. + + As changes are made to the container, space is allocated to it from the zpool via allocate-on-demand operations. By default, ZFS will allocate space in blocks of 128K. + +This process of creating child layers and containers from *read-only* snapshots allows images to be maintained as immutable objects. + +## Container reads and writes with ZFS + +Container reads with the `zfs` storage driver are very simple. A newly launched container is based on a ZFS clone. This clone initially shares all of its data with the dataset it was created from. This means that read operations with the `zfs` storage driver are fast – even if the data being read was copied into the container yet. This sharing of data blocks is shown in the diagram below. + +![](images/zpool_blocks.jpg) + +Writing new data to a container is accomplished via an allocate-on-demand operation. Every time a new area of the container needs writing to, a new block is allocated from the zpool. This means that containers consume additional space as new data is written to them. New space is allocated to the container (ZFS Clone) from the underlying zpool. + +Updating *existing data* in a container is accomplished by allocating new blocks to the containers clone and storing the changed data in those new blocks. The original are unchanged, allowing the underlying image dataset to remain immutable. This is the same as writing to a normal ZFS filesystem and is an implementation of copy-on-write semantics. + +## Configure Docker with the ZFS storage driver + +The `zfs` storage driver is only supported on a Docker host where `/var/lib/docker` is mounted as a ZFS filesystem. This section shows you how to install and configure native ZFS on Linux (ZoL) on an Ubuntu 14.04 system. + +### Prerequisites + +If you have already used the Docker daemon on your Docker host and have images you want to keep, `push` them Docker Hub or your private Docker Trusted Registry before attempting this procedure. + +Stop the Docker daemon. Then, ensure that you have a spare block device at `/dev/xvdb`. The device identifier may be be different in your environment and you should substitute your own values throughout the procedure. + +### Install Zfs on Ubuntu 14.04 LTS + +1. If it is running, stop the Docker `daemon`. + +1. Install `the software-properties-common` package. + + This is required for the `add-apt-repository` command. + + $ sudo apt-get install software-properties-common + Reading package lists... Done + Building dependency tree + + +2. Add the `zfs-native` package archive. + + $ sudo add-apt-repository ppa:zfs-native/stable + The native ZFS filesystem for Linux. Install the ubuntu-zfs package. + + gpg: key F6B0FC61: public key "Launchpad PPA for Native ZFS for Linux" imported + gpg: Total number processed: 1 + gpg: imported: 1 (RSA: 1) + OK + +3. Get the latest package lists for all registered repositories and package archives. + + $ sudo apt-get update + Ign http://us-west-2.ec2.archive.ubuntu.com trusty InRelease + Get:1 http://us-west-2.ec2.archive.ubuntu.com trusty-updates InRelease [64.4 kB] + + Fetched 10.3 MB in 4s (2,370 kB/s) + Reading package lists... Done + +4. Install the `ubuntu-zfs` package. + + $ sudo apt-get install -y ubuntu-zfs + Reading package lists... Done + Building dependency tree + + +5. Load the `zfs` module. + + $ sudo modprobe zfs + +6. Verify that it loaded correctly. + + $ lsmod | grep zfs + zfs 2768247 0 + zunicode 331170 1 zfs + zcommon 55411 1 zfs + znvpair 89086 2 zfs,zcommon + spl 96378 3 zfs,zcommon,znvpair + zavl 15236 1 zfs + +## Configure ZFS for Docker + +Once ZFS is installed and loaded, you're ready to configure ZFS for Docker. + + +1. Create a new `zpool`. + + $ sudo zpool create -f zpool-docker /dev/xvdb + + The command creates the `zpool` and gives it the name "zpool-docker". The name is arbitrary. + +2. Check that the `zpool` exists. + + $ sudo zfs list + NAME USED AVAIL REFER MOUNTPOINT + zpool-docker 55K 3.84G 19K /zpool-docker + +3. Create and mount a new ZFS filesystem to `/var/lib/docker`. + + $ sudo zfs create -o mountpoint=/var/lib/docker zpool-docker/docker + +4. Check that the previous step worked. + + $ sudo zfs list -t all + NAME USED AVAIL REFER MOUNTPOINT + zpool-docker 93.5K 3.84G 19K /zpool-docker + zpool-docker/docker 19K 3.84G 19K /var/lib/docker + + Now that you have a ZFS filesystem mounted to `/var/lib/docker`, the daemon should automatically load with the `zfs` storage driver. + +5. Start the Docker daemon. + + $ sudo service docker start + docker start/running, process 2315 + + The procedure for starting the Docker daemon may differ depending on the + Linux distribution you are using. It is possible to force the Docker daemon + to start with the `zfs` storage driver by passing the `--storage-driver=zfs` + flag to the `docker daemon` command, or to the `DOCKER_OPTS` line in the + Docker config file. + +6. Verify that the daemon is using the `zfs` storage driver. + + $ sudo docker info + Containers: 0 + Images: 0 + Storage Driver: zfs + Zpool: zpool-docker + Zpool Health: ONLINE + Parent Dataset: zpool-docker/docker + Space Used By Parent: 27648 + Space Available: 4128139776 + Parent Quota: no + Compression: off + Execution Driver: native-0.2 + [...] + + The output of the command above shows that the Docker daemon is using the + `zfs` storage driver and that the parent dataset is the `zpool-docker/docker` + filesystem created earlier. + +Your Docker host is now using ZFS to store to manage its images and containers. + +## ZFS and Docker performance + +There are several factors that influence the performance of Docker using the `zfs` storage driver. + +- **Memory**. Memory has a major impact on ZFS performance. This goes back to the fact that ZFS was originally designed for use on big Sun Solaris servers with large amounts of memory. Keep this in mind when sizing your Docker hosts. + +- **ZFS Features**. Using ZFS features, such as deduplication, can significantly increase the amount +of memory ZFS uses. For memory consumption and performance reasons it is +recommended to turn off ZFS deduplication. However, deduplication at other +layers in the stack (such as SAN or NAS arrays) can still be used as these do +not impact ZFS memory usage and performance. If using SAN, NAS or other hardware +RAID technologies you should continue to follow existing best practices for +using them with ZFS. + +* **ZFS Caching**. ZFS caches disk blocks in a memory structure called the adaptive replacement cache (ARC). The *Single Copy ARC* feature of ZFS allows a single cached copy of a block to be shared by multiple clones of a filesystem. This means that multiple running containers can share a single copy of cached block. This means that ZFS is a good option for PaaS and other high density use cases. + +- **Fragmentation**. Fragmentation is a natural byproduct of copy-on-write filesystems like ZFS. However, ZFS writes in 128K blocks and allocates *slabs* (multiple 128K blocks) to CoW operations in an attempt to reduce fragmentation. The ZFS intent log (ZIL) and the coalescing of writes (delayed writes) also help to reduce fragmentation. + +- **Use the native ZFS driver for Linux**. Although the Docker `zfs` storage driver supports the ZFS FUSE implementation, it is not recommended when high performance is required. The native ZFS on Linux driver tends to perform better than the FUSE implementation. + +The following generic performance best practices also apply to ZFS. + +- **Use of SSD**. For best performance it is always a good idea to use fast storage media such as solid state devices (SSD). However, if you only have a limited amount of SSD storage available it is recommended to place the ZIL on SSD. + +- **Use Data Volumes**. Data volumes provide the best and most predictable performance. This is because they bypass the storage driver and do not incur any of the potential overheads introduced by thin provisioning and copy-on-write. For this reason, you may want to place heavy write workloads on data volumes. diff --git a/docs/userguide/usingdocker.md b/docs/userguide/usingdocker.md new file mode 100644 index 0000000000..e0aa6d2e80 --- /dev/null +++ b/docs/userguide/usingdocker.md @@ -0,0 +1,306 @@ + + +# Run a simple application + +In the ["*Hello world in a container*"](dockerizing.md) you launched your +first containers using the `docker run` command. You ran an *interactive container* that ran in the foreground. You also ran a *detached container* that ran in the background. In the process you learned about several Docker commands: + +* `docker ps` - Lists containers. +* `docker logs` - Shows us the standard output of a container. +* `docker stop` - Stops running containers. + +## Learn about the Docker client + +If you didn't realize it yet, you've been using the Docker client each time you +typed `docker` in your Bash terminal. The client is a simple command line client +also known as a command-line interface (CLI). Each action you can take with +the client is a command and each command can take a series of flags and arguments. + + # Usage: [sudo] docker [subcommand] [flags] [arguments] .. + # Example: + $ docker run -i -t ubuntu /bin/bash + +You can see this in action by using the `docker version` command to return +version information on the currently installed Docker client and daemon. + + $ docker version + +This command will not only provide you the version of Docker client and +daemon you are using, but also the version of Go (the programming +language powering Docker). + + Client: + Version: 1.8.1 + API version: 1.20 + Go version: go1.4.2 + Git commit: d12ea79 + Built: Thu Aug 13 02:35:49 UTC 2015 + OS/Arch: linux/amd64 + + Server: + Version: 1.8.1 + API version: 1.20 + Go version: go1.4.2 + Git commit: d12ea79 + Built: Thu Aug 13 02:35:49 UTC 2015 + OS/Arch: linux/amd64 + +## Get Docker command help + +You can display the help for specific Docker commands. The help details the +options and their usage. To see a list of all the possible commands, use the +following: + + $ docker --help + +To see usage for a specific command, specify the command with the `--help` flag: + + $ docker attach --help + + Usage: docker attach [OPTIONS] CONTAINER + + Attach to a running container + + --help=false Print usage + --no-stdin=false Do not attach stdin + --sig-proxy=true Proxy all received signals to the process + +> **Note:** +> For further details and examples of each command, see the +> [command reference](../reference/commandline/cli.md) in this guide. + +## Running a web application in Docker + +So now you've learned a bit more about the `docker` client you can move onto +the important stuff: running more containers. So far none of the +containers you've run did anything particularly useful, so you can +change that by running an example web application in Docker. + +For our web application we're going to run a Python Flask application. +Start with a `docker run` command. + + $ docker run -d -P training/webapp python app.py + +Review what the command did. You've specified two flags: `-d` and +`-P`. You've already seen the `-d` flag which tells Docker to run the +container in the background. The `-P` flag is new and tells Docker to +map any required network ports inside our container to our host. This +lets us view our web application. + +You've specified an image: `training/webapp`. This image is a +pre-built image you've created that contains a simple Python Flask web +application. + +Lastly, you've specified a command for our container to run: `python app.py`. This launches our web application. + +> **Note:** +> You can see more detail on the `docker run` command in the [command +> reference](../reference/commandline/run.md) and the [Docker Run +> Reference](../reference/run.md). + +## Viewing our web application container + +Now you can see your running container using the `docker ps` command. + + $ docker ps -l + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + bc533791f3f5 training/webapp:latest python app.py 5 seconds ago Up 2 seconds 0.0.0.0:49155->5000/tcp nostalgic_morse + +You can see you've specified a new flag, `-l`, for the `docker ps` +command. This tells the `docker ps` command to return the details of the +*last* container started. + +> **Note:** +> By default, the `docker ps` command only shows information about running +> containers. If you want to see stopped containers too use the `-a` flag. + +We can see the same details we saw [when we first Dockerized a +container](dockerizing.md) with one important addition in the `PORTS` +column. + + PORTS + 0.0.0.0:49155->5000/tcp + +When we passed the `-P` flag to the `docker run` command Docker mapped any +ports exposed in our image to our host. + +> **Note:** +> We'll learn more about how to expose ports in Docker images when +> [we learn how to build images](dockerimages.md). + +In this case Docker has exposed port 5000 (the default Python Flask +port) on port 49155. + +Network port bindings are very configurable in Docker. In our last example the +`-P` flag is a shortcut for `-p 5000` that maps port 5000 inside the container +to a high port (from *ephemeral port range* which typically ranges from 32768 +to 61000) on the local Docker host. We can also bind Docker containers to +specific ports using the `-p` flag, for example: + + $ docker run -d -p 80:5000 training/webapp python app.py + +This would map port 5000 inside our container to port 80 on our local +host. You might be asking about now: why wouldn't we just want to always +use 1:1 port mappings in Docker containers rather than mapping to high +ports? Well 1:1 mappings have the constraint of only being able to map +one of each port on your local host. + +Suppose you want to test two Python applications: both bound to port 5000 inside +their own containers. Without Docker's port mapping you could only access one at +a time on the Docker host. + +So you can now browse to port 49155 in a web browser to +see the application. + +![Viewing the web application](webapp1.png). + +Our Python application is live! + +> **Note:** +> If you have been using a virtual machine on OS X, Windows or Linux, +> you'll need to get the IP of the virtual host instead of using localhost. +> You can do this by running the `docker-machine ip your_vm_name` from your command line or terminal application, for example: +> +> $ docker-machine ip my-docker-vm +> 192.168.99.100 +> +> In this case you'd browse to `http://192.168.99.100:49155` for the above example. + +## A network port shortcut + +Using the `docker ps` command to return the mapped port is a bit clumsy so +Docker has a useful shortcut we can use: `docker port`. To use `docker port` we +specify the ID or name of our container and then the port for which we need the +corresponding public-facing port. + + $ docker port nostalgic_morse 5000 + 0.0.0.0:49155 + +In this case you've looked up what port is mapped externally to port 5000 inside +the container. + +## Viewing the web application's logs + +You can also find out a bit more about what's happening with our application and +use another of the commands you've learned, `docker logs`. + + $ docker logs -f nostalgic_morse + * Running on http://0.0.0.0:5000/ + 10.0.2.2 - - [23/May/2014 20:16:31] "GET / HTTP/1.1" 200 - + 10.0.2.2 - - [23/May/2014 20:16:31] "GET /favicon.ico HTTP/1.1" 404 - + +This time though you've added a new flag, `-f`. This causes the `docker +logs` command to act like the `tail -f` command and watch the +container's standard out. We can see here the logs from Flask showing +the application running on port 5000 and the access log entries for it. + +## Looking at our web application container's processes + +In addition to the container's logs we can also examine the processes +running inside it using the `docker top` command. + + $ docker top nostalgic_morse + PID USER COMMAND + 854 root python app.py + +Here we can see our `python app.py` command is the only process running inside +the container. + +## Inspecting our web application container + +Lastly, we can take a low-level dive into our Docker container using the +`docker inspect` command. It returns a JSON document containing useful +configuration and status information for the specified container. + + $ docker inspect nostalgic_morse + +You can see a sample of that JSON output. + + [{ + "ID": "bc533791f3f500b280a9626688bc79e342e3ea0d528efe3a86a51ecb28ea20", + "Created": "2014-05-26T05:52:40.808952951Z", + "Path": "python", + "Args": [ + "app.py" + ], + "Config": { + "Hostname": "bc533791f3f5", + "Domainname": "", + "User": "", + . . . + +We can also narrow down the information we want to return by requesting a +specific element, for example to return the container's IP address we would: + + $ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' nostalgic_morse + 172.17.0.5 + +## Stopping our web application container + +Okay you've seen web application working. Now you can stop it using the +`docker stop` command and the name of our container: `nostalgic_morse`. + + $ docker stop nostalgic_morse + nostalgic_morse + +We can now use the `docker ps` command to check if the container has +been stopped. + + $ docker ps -l + +## Restarting our web application container + +Oops! Just after you stopped the container you get a call to say another +developer needs the container back. From here you have two choices: you +can create a new container or restart the old one. Look at +starting your previous container back up. + + $ docker start nostalgic_morse + nostalgic_morse + +Now quickly run `docker ps -l` again to see the running container is +back up or browse to the container's URL to see if the application +responds. + +> **Note:** +> Also available is the `docker restart` command that runs a stop and +> then start on the container. + +## Removing our web application container + +Your colleague has let you know that they've now finished with the container +and won't need it again. Now, you can remove it using the `docker rm` command. + + $ docker rm nostalgic_morse + Error: Impossible to remove a running container, please stop it first or use -f + 2014/05/24 08:12:56 Error: failed to remove one or more containers + +What happened? We can't actually remove a running container. This protects +you from accidentally removing a running container you might need. You can try +this again by stopping the container first. + + $ docker stop nostalgic_morse + nostalgic_morse + $ docker rm nostalgic_morse + nostalgic_morse + +And now our container is stopped and deleted. + +> **Note:** +> Always remember that removing a container is final! + +# Next steps + +Until now you've only used images that you've downloaded from Docker Hub. Next, +you can get introduced to building and sharing our own images. + +Go to [Working with Docker Images](dockerimages.md). diff --git a/docs/userguide/webapp1.png b/docs/userguide/webapp1.png new file mode 100644 index 0000000000000000000000000000000000000000..b92cc87d65d45c4cb5b255a089cdb54bbe9b23e4 GIT binary patch literal 13345 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: If your company is behind a filtering proxy, you may find that the + >`apt-key` + >command fails for the Docker repo during installation. To work around this, + >add the key directly using the following: + > + > $ curl -sSL https://experimental.docker.com/gpg | sudo apt-key add - + +3. Verify `docker` is installed correctly. + + $ sudo docker run hello-world + + This command downloads a test image and runs it in a container. + +### Get the Linux binary +To download the latest experimental `docker` binary for Linux, +use the following URLs: + + https://experimental.docker.com/builds/Linux/i386/docker-latest + + https://experimental.docker.com/builds/Linux/x86_64/docker-latest + +After downloading the appropriate binary, you can follow the instructions +[here](https://docs.docker.com/installation/binaries/#get-the-docker-binary) to run the `docker` daemon. + +> **Note** +> +> 1) You can get the MD5 and SHA256 hashes by appending .md5 and .sha256 to the URLs respectively +> +> 2) You can get the compressed binaries by appending .tgz to the URLs + +### Build an experimental binary +You can also build the experimental binary from the standard development environment by adding +`DOCKER_EXPERIMENTAL=1` to the environment where you run `make` to build Docker binaries. For example, +to build a Docker binary with the experimental features enabled: + + $ DOCKER_EXPERIMENTAL=1 make binary + +## Current experimental features + + * [External graphdriver plugins](plugins_graphdriver.md) + * [User namespaces](userns.md) + +## How to comment on an experimental feature + +Each feature's documentation includes a list of proposal pull requests or PRs associated with the feature. If you want to comment on or suggest a change to a feature, please add it to the existing feature PR. + +Issues or problems with a feature? Inquire for help on the `#docker` IRC channel or in on the [Docker Google group](https://groups.google.com/forum/#!forum/docker-user). diff --git a/experimental/plugins_graphdriver.md b/experimental/plugins_graphdriver.md new file mode 100644 index 0000000000..700fdde13b --- /dev/null +++ b/experimental/plugins_graphdriver.md @@ -0,0 +1,321 @@ +# Experimental: Docker graph driver plugins + +Docker graph driver plugins enable admins to use an external/out-of-process +graph driver for use with Docker engine. This is an alternative to using the +built-in storage drivers, such as aufs/overlay/devicemapper/btrfs. + +A graph driver plugin is used for image and container fs storage, as such +the plugin must be started and available for connections prior to Docker Engine +being started. + +# Write a graph driver plugin + +See the [plugin documentation](/docs/extend/plugins.md) for detailed information +on the underlying plugin protocol. + + +## Graph Driver plugin protocol + +If a plugin registers itself as a `GraphDriver` when activated, then it is +expected to provide the rootfs for containers as well as image layer storage. + +### /GraphDriver.Init + +**Request**: +``` +{ + "Home": "/graph/home/path", + "Opts": [] +} +``` + +Initialize the graph driver plugin with a home directory and array of options. +Plugins are not required to accept these options as the Docker Engine does not +require that the plugin use this path or options, they are only being passed +through from the user. + +**Response**: +``` +{ + "Err": null +} +``` + +Respond with a string error if an error occurred. + + +### /GraphDriver.Create + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187", + "Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142" +} +``` + +Create a new, empty, filesystem layer with the specified `ID` and `Parent`. +`Parent` may be an empty string, which would indicate that there is no parent +layer. + +**Response**: +``` +{ + "Err: null +} +``` + +Respond with a string error if an error occurred. + + +### /GraphDriver.Remove + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187" +} +``` + +Remove the filesystem layer with this given `ID`. + +**Response**: +``` +{ + "Err: null +} +``` + +Respond with a string error if an error occurred. + +### /GraphDriver.Get + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187" + "MountLabel": "" +} +``` + +Get the mountpoint for the layered filesystem referred to by the given `ID`. + +**Response**: +``` +{ + "Dir": "/var/mygraph/46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187", + "Err": "" +} +``` + +Respond with the absolute path to the mounted layered filesystem. +Respond with a string error if an error occurred. + +### /GraphDriver.Put + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187" +} +``` + +Release the system resources for the specified `ID`, such as unmounting the +filesystem layer. + +**Response**: +``` +{ + "Err: null +} +``` + +Respond with a string error if an error occurred. + +### /GraphDriver.Exists + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187" +} +``` + +Determine if a filesystem layer with the specified `ID` exists. + +**Response**: +``` +{ + "Exists": true +} +``` + +Respond with a boolean for whether or not the filesystem layer with the specified +`ID` exists. + +### /GraphDriver.Status + +**Request**: +``` +{} +``` + +Get low-level diagnostic information about the graph driver. + +**Response**: +``` +{ + "Status": [[]] +} +``` + +Respond with a 2-D array with key/value pairs for the underlying status +information. + + +### /GraphDriver.GetMetadata + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187" +} +``` + +Get low-level diagnostic information about the layered filesystem with the +with the specified `ID` + +**Response**: +``` +{ + "Metadata": {}, + "Err": null +} +``` + +Respond with a set of key/value pairs containing the low-level diagnostic +information about the layered filesystem. +Respond with a string error if an error occurred. + +### /GraphDriver.Cleanup + +**Request**: +``` +{} +``` + +Perform neccessary tasks to release resources help by the plugin, for example +unmounting all the layered file systems. + +**Response**: +``` +{ + "Err: null +} +``` + +Respond with a string error if an error occurred. + + +### /GraphDriver.Diff + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187", + "Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142" +} +``` + +Get an archive of the changes between the filesystem layers specified by the `ID` +and `Parent`. `Parent` may be an empty string, in which case there is no parent. + +**Response**: +``` +{{ TAR STREAM }} +``` + +### /GraphDriver.Changes + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187", + "Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142" +} +``` + +Get a list of changes between the filesystem layers specified by the `ID` and +`Parent`. `Parent` may be an empty string, in which case there is no parent. + +**Response**: +``` +{ + "Changes": [{}], + "Err": null +} +``` + +Responds with a list of changes. The structure of a change is: +``` + "Path": "/some/path", + "Kind": 0, +``` + +Where teh `Path` is the filesystem path within the layered filesystem that is +changed and `Kind` is an integer specifying the type of change that occurred: + +- 0 - Modified +- 1 - Added +- 2 - Deleted + +Respond with a string error if an error occurred. + +### /GraphDriver.ApplyDiff + +**Request**: +``` +{{ TAR STREAM }} +``` + +Extract the changeset from the given diff into the layer with the specified `ID` +and `Parent` + +**Query Parameters**: + +- id (required)- the `ID` of the new filesystem layer to extract the diff to +- parent (required)- the `Parent` of the given `ID` + +**Response**: +``` +{ + "Size": 512366, + "Err": null +} +``` + +Respond with the size of the new layer in bytes. +Respond with a string error if an error occurred. + +### /GraphDriver.DiffSize + +**Request**: +``` +{ + "ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187", + "Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142" +} +``` + +Calculate the changes between the specified `ID` + +**Response**: +``` +{ + "Size": 512366, + "Err": null +} +``` + +Respond with the size changes between the specified `ID` and `Parent` +Respond with a string error if an error occurred. diff --git a/experimental/userns.md b/experimental/userns.md new file mode 100644 index 0000000000..79e06ee4a9 --- /dev/null +++ b/experimental/userns.md @@ -0,0 +1,120 @@ +# Experimental: User namespace support + +Linux kernel [user namespace support](http://man7.org/linux/man-pages/man7/user_namespaces.7.html) provides additional security by enabling +a process--and therefore a container--to have a unique range of user and +group IDs which are outside the traditional user and group range utilized by +the host system. Potentially the most important security improvement is that, +by default, container processes running as the `root` user will have expected +administrative privilege (with some restrictions) inside the container but will +effectively be mapped to an unprivileged `uid` on the host. + +In this experimental phase, the Docker daemon creates a single daemon-wide mapping +for all containers running on the same engine instance. The mappings will +utilize the existing subordinate user and group ID feature available on all modern +Linux distributions. +The [`/etc/subuid`](http://man7.org/linux/man-pages/man5/subuid.5.html) and +[`/etc/subgid`](http://man7.org/linux/man-pages/man5/subgid.5.html) files will be +read for the user, and optional group, specified to the `--userns-remap` +parameter. If you do not wish to specify your own user and/or group, you can +provide `default` as the value to this flag, and a user will be created on your behalf +and provided subordinate uid and gid ranges. This default user will be named +`dockremap`, and entries will be created for it in `/etc/passwd` and +`/etc/group` using your distro's standard user and group creation tools. + +> **Note**: The single mapping per-daemon restriction exists for this experimental +> phase because Docker shares image layers from its local cache across all +> containers running on the engine instance. Since file ownership must be +> the same for all containers sharing the same layer content, the decision +> was made to map the file ownership on `docker pull` to the daemon's user and +> group mappings so that there is no delay for running containers once the +> content is downloaded--exactly the same performance characteristics as with +> user namespaces disabled. + +## Starting the daemon with user namespaces enabled +To enable this experimental user namespace support for a Docker daemon instance, +start the daemon with the aforementioned `--userns-remap` flag, which accepts +values in the following formats: + + - uid + - uid:gid + - username + - username:groupname + +If numeric IDs are provided, translation back to valid user or group names +will occur so that the subordinate uid and gid information can be read, given +these resources are name-based, not id-based. If the numeric ID information +provided does not exist as entries in `/etc/passwd` or `/etc/group`, dameon +startup will fail with an error message. + +*An example: starting with default Docker user management:* + +``` + $ docker daemon --userns-remap=default +``` +In this case, Docker will create--or find the existing--user and group +named `dockremap`. If the user is created, and the Linux distribution has +appropriate support, the `/etc/subuid` and `/etc/subgid` files will be populated +with a contiguous 65536 length range of subordinate user and group IDs, starting +at an offset based on prior entries in those files. For example, Ubuntu will +create the following range, based on an existing user already having the first +65536 range: + +``` + $ cat /etc/subuid + user1:100000:65536 + dockremap:165536:65536 +``` + +> **Note:** On a fresh Fedora install, we found that we had to `touch` the +> `/etc/subuid` and `/etc/subgid` files to have ranges assigned when users +> were created. Once these files existed, range assigment on user creation +> worked properly. + +If you have a preferred/self-managed user with subordinate ID mappings already +configured, you can provide that username or uid to the `--userns-remap` flag. +If you have a group that doesn't match the username, you may provide the `gid` +or group name as well; otherwise the username will be used as the group name +when querying the system for the subordinate group ID range. + +## Detailed information on `subuid`/`subgid` ranges + +Given there may be advanced use of the subordinate ID ranges by power users, we will +describe how the Docker daemon uses the range entries within these files under the +current experimental user namespace support. + +The simplest case exists where only one contiguous range is defined for the +provided user or group. In this case, Docker will use that entire contiguous +range for the mapping of host uids and gids to the container process. This +means that the first ID in the range will be the remapped root user, and the +IDs above that initial ID will map host ID 1 through the end of the range. + +From the example `/etc/subid` content shown above, that means the remapped root +user would be uid 165536. + +If the system administrator has set up multiple ranges for a single user or +group, the Docker daemon will read all the available ranges and use the +following algorithm to create the mapping ranges: + +1. The ranges will be sorted by *start ID* ascending +2. Maps will be created from each range with where the host ID will increment starting at 0 for the first range, 0+*range1* length for the second, and so on. This means that the lowest range start ID will be the remapped root, and all further ranges will map IDs from 1 through the uid or gid that equals the sum of all range lengths. +3. Ranges segments above five will be ignored as the kernel ignores any ID maps after five (in `/proc/self/{u,g}id_map`) + +## User namespace known restrictions + +The following standard Docker features are currently incompatible when +running a Docker daemon with experimental user namespaces enabled: + + - sharing namespaces with the host (--pid=host, --net=host, etc.) + - sharing namespaces with other containers (--net=container:*other*) + - A `--readonly` container filesystem (a Linux kernel restriction on remount with new flags of a currently mounted filesystem when inside a user namespace) + - external (volume/graph) drivers which are unaware/incapable of using daemon user mappings + - Using `--privileged` mode containers + - Using the lxc execdriver (only the `native` execdriver is enabled to use user namespaces) + - volume use without pre-arranging proper file ownership in mounted volumes + +Additionally, while the `root` user inside a user namespaced container +process has many of the privileges of the administrative root user, the +following operations will fail: + + - Use of `mknod` - permission is denied for device creation by the container root + - others will be listed here when fully tested diff --git a/graph/export.go b/graph/export.go new file mode 100644 index 0000000000..7f7e972053 --- /dev/null +++ b/graph/export.go @@ -0,0 +1,180 @@ +package graph + +import ( + "encoding/json" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/digest" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/registry" +) + +// ImageExport exports list of images to a output stream specified in the +// config. The exported images are archived into a tar when written to the +// output stream. All images with the given tag and all versions containing the +// same tag are exported. names is the set of tags to export, and outStream +// is the writer which the images are written to. +func (s *TagStore) ImageExport(names []string, outStream io.Writer) error { + // get image json + tempdir, err := ioutil.TempDir("", "docker-export-") + if err != nil { + return err + } + defer os.RemoveAll(tempdir) + + rootRepoMap := map[string]Repository{} + addKey := func(name string, tag string, id string) { + logrus.Debugf("add key [%s:%s]", name, tag) + if repo, ok := rootRepoMap[name]; !ok { + rootRepoMap[name] = Repository{tag: id} + } else { + repo[tag] = id + } + } + for _, name := range names { + name = registry.NormalizeLocalName(name) + logrus.Debugf("Serializing %s", name) + rootRepo := s.Repositories[name] + if rootRepo != nil { + // this is a base repo name, like 'busybox' + for tag, id := range rootRepo { + addKey(name, tag, id) + if err := s.exportImage(id, tempdir); err != nil { + return err + } + } + } else { + img, err := s.LookupImage(name) + if err != nil { + return err + } + + if img != nil { + // This is a named image like 'busybox:latest' + repoName, repoTag := parsers.ParseRepositoryTag(name) + + // Skip digests on save + if _, err := digest.ParseDigest(repoTag); err == nil { + repoTag = "" + } + + // check this length, because a lookup of a truncated has will not have a tag + // and will not need to be added to this map + if len(repoTag) > 0 { + addKey(repoName, repoTag, img.ID) + } + if err := s.exportImage(img.ID, tempdir); err != nil { + return err + } + + } else { + // this must be an ID that didn't get looked up just right? + if err := s.exportImage(name, tempdir); err != nil { + return err + } + } + } + logrus.Debugf("End Serializing %s", name) + } + // write repositories, if there is something to write + if len(rootRepoMap) > 0 { + f, err := os.OpenFile(filepath.Join(tempdir, "repositories"), os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0644) + if err != nil { + f.Close() + return err + } + if err := json.NewEncoder(f).Encode(rootRepoMap); err != nil { + return err + } + if err := f.Close(); err != nil { + return err + } + if err := os.Chtimes(filepath.Join(tempdir, "repositories"), time.Unix(0, 0), time.Unix(0, 0)); err != nil { + return err + } + } else { + logrus.Debugf("There were no repositories to write") + } + + fs, err := archive.Tar(tempdir, archive.Uncompressed) + if err != nil { + return err + } + defer fs.Close() + + if _, err := io.Copy(outStream, fs); err != nil { + return err + } + logrus.Debugf("End export image") + return nil +} + +func (s *TagStore) exportImage(name, tempdir string) error { + for n := name; n != ""; { + img, err := s.LookupImage(n) + if err != nil || img == nil { + return fmt.Errorf("No such image %s", n) + } + + // temporary directory + tmpImageDir := filepath.Join(tempdir, n) + if err := os.Mkdir(tmpImageDir, os.FileMode(0755)); err != nil { + if os.IsExist(err) { + return nil + } + return err + } + + var version = "1.0" + var versionBuf = []byte(version) + + if err := ioutil.WriteFile(filepath.Join(tmpImageDir, "VERSION"), versionBuf, os.FileMode(0644)); err != nil { + return err + } + + imageInspectRaw, err := json.Marshal(img) + if err != nil { + return err + } + + // serialize json + json, err := os.Create(filepath.Join(tmpImageDir, "json")) + if err != nil { + return err + } + + written, err := json.Write(imageInspectRaw) + if err != nil { + return err + } + if written != len(imageInspectRaw) { + logrus.Warnf("%d byes should have been written instead %d have been written", written, len(imageInspectRaw)) + } + + // serialize filesystem + fsTar, err := os.Create(filepath.Join(tmpImageDir, "layer.tar")) + if err != nil { + return err + } + if err := s.ImageTarLayer(n, fsTar); err != nil { + return err + } + + for _, fname := range []string{"", "VERSION", "json", "layer.tar"} { + if err := os.Chtimes(filepath.Join(tmpImageDir, fname), img.Created, img.Created); err != nil { + return err + } + } + + // try again with parent + n = img.Parent + } + return nil +} diff --git a/graph/fixtures/validate_manifest/bad_manifest b/graph/fixtures/validate_manifest/bad_manifest new file mode 100644 index 0000000000..a1f02a62a3 --- /dev/null +++ b/graph/fixtures/validate_manifest/bad_manifest @@ -0,0 +1,38 @@ +{ + "schemaVersion": 2, + "name": "library/hello-world", + "tag": "latest", + "architecture": "amd64", + "fsLayers": [ + { + "blobSum": "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4" + }, + { + "blobSum": "sha256:03f4658f8b782e12230c1783426bd3bacce651ce582a4ffb6fbbfa2079428ecb" + } + ], + "history": [ + { + "v1Compatibility": "{\"id\":\"af340544ed62de0680f441c71fa1a80cb084678fed42bae393e543faea3a572c\",\"parent\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.608577814Z\",\"container\":\"c2b715156f640c7ac7d98472ea24335aba5432a1323a3bb722697e6d37ef794f\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) CMD [\\\"/hello\\\"]\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/hello\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n" + }, + { + "v1Compatibility": "{\"id\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.241352727Z\",\"container\":\"9aeb0006ffa72a8287564caaea87625896853701459261d3b569e320c0c9d5dc\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) COPY file:4abd3bff60458ca3b079d7b131ce26b2719055a030dfa96ff827da2b7c7038a7 in /\"],\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":null,\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":960}\n" + } + ], + "signatures": [ + { + "header": { + "jwk": { + "crv": "P-256", + "kid": "OIH7:HQFS:44FK:45VB:3B53:OIAG:TPL4:ATF5:6PNE:MGHN:NHQX:2GE4", + "kty": "EC", + "x": "Cu_UyxwLgHzE9rvlYSmvVdqYCXY42E9eNhBb0xNv0SQ", + "y": "zUsjWJkeKQ5tv7S-hl1Tg71cd-CqnrtiiLxSi6N_yc8" + }, + "alg": "ES256" + }, + "signature": "Y6xaFz9Sy-OtcnKQS1Ilq3Dh8cu4h3nBTJCpOTF1XF7vKtcxxA_xMP8-SgDo869SJ3VsvgPL9-Xn-OoYG2rb1A", + "protected": "eyJmb3JtYXRMZW5ndGgiOjMxOTcsImZvcm1hdFRhaWwiOiJDbjAiLCJ0aW1lIjoiMjAxNS0wOS0xMVQwNDoxMzo0OFoifQ" + } + ] +} diff --git a/graph/fixtures/validate_manifest/extra_data_manifest b/graph/fixtures/validate_manifest/extra_data_manifest new file mode 100644 index 0000000000..beec19a801 --- /dev/null +++ b/graph/fixtures/validate_manifest/extra_data_manifest @@ -0,0 +1,46 @@ +{ + "schemaVersion": 1, + "name": "library/hello-world", + "tag": "latest", + "architecture": "amd64", + "fsLayers": [ + { + "blobSum": "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4" + }, + { + "blobSum": "sha256:03f4658f8b782e12230c1783426bd3bacce651ce582a4ffb6fbbfa2079428ecb" + } + ], + "history": [ + { + "v1Compatibility": "{\"id\":\"af340544ed62de0680f441c71fa1a80cb084678fed42bae393e543faea3a572c\",\"parent\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.608577814Z\",\"container\":\"c2b715156f640c7ac7d98472ea24335aba5432a1323a3bb722697e6d37ef794f\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) CMD [\\\"/hello\\\"]\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/hello\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n" + }, + { + "v1Compatibility": "{\"id\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.241352727Z\",\"container\":\"9aeb0006ffa72a8287564caaea87625896853701459261d3b569e320c0c9d5dc\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) COPY file:4abd3bff60458ca3b079d7b131ce26b2719055a030dfa96ff827da2b7c7038a7 in /\"],\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":null,\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":960}\n" + } + ], + "fsLayers": [ + { + "blobSum": "sha256:ffff95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4" + }, + { + "blobSum": "sha256:ffff658f8b782e12230c1783426bd3bacce651ce582a4ffb6fbbfa2079428ecb" + } + ], + "signatures": [ + { + "header": { + "jwk": { + "crv": "P-256", + "kid": "OIH7:HQFS:44FK:45VB:3B53:OIAG:TPL4:ATF5:6PNE:MGHN:NHQX:2GE4", + "kty": "EC", + "x": "Cu_UyxwLgHzE9rvlYSmvVdqYCXY42E9eNhBb0xNv0SQ", + "y": "zUsjWJkeKQ5tv7S-hl1Tg71cd-CqnrtiiLxSi6N_yc8" + }, + "alg": "ES256" + }, + "signature": "Y6xaFz9Sy-OtcnKQS1Ilq3Dh8cu4h3nBTJCpOTF1XF7vKtcxxA_xMP8-SgDo869SJ3VsvgPL9-Xn-OoYG2rb1A", + "protected": "eyJmb3JtYXRMZW5ndGgiOjMxOTcsImZvcm1hdFRhaWwiOiJDbjAiLCJ0aW1lIjoiMjAxNS0wOS0xMVQwNDoxMzo0OFoifQ" + } + ] +} diff --git a/graph/fixtures/validate_manifest/good_manifest b/graph/fixtures/validate_manifest/good_manifest new file mode 100644 index 0000000000..b107de3226 --- /dev/null +++ b/graph/fixtures/validate_manifest/good_manifest @@ -0,0 +1,38 @@ +{ + "schemaVersion": 1, + "name": "library/hello-world", + "tag": "latest", + "architecture": "amd64", + "fsLayers": [ + { + "blobSum": "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4" + }, + { + "blobSum": "sha256:03f4658f8b782e12230c1783426bd3bacce651ce582a4ffb6fbbfa2079428ecb" + } + ], + "history": [ + { + "v1Compatibility": "{\"id\":\"af340544ed62de0680f441c71fa1a80cb084678fed42bae393e543faea3a572c\",\"parent\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.608577814Z\",\"container\":\"c2b715156f640c7ac7d98472ea24335aba5432a1323a3bb722697e6d37ef794f\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) CMD [\\\"/hello\\\"]\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/hello\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n" + }, + { + "v1Compatibility": "{\"id\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.241352727Z\",\"container\":\"9aeb0006ffa72a8287564caaea87625896853701459261d3b569e320c0c9d5dc\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) COPY file:4abd3bff60458ca3b079d7b131ce26b2719055a030dfa96ff827da2b7c7038a7 in /\"],\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":null,\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":960}\n" + } + ], + "signatures": [ + { + "header": { + "jwk": { + "crv": "P-256", + "kid": "OIH7:HQFS:44FK:45VB:3B53:OIAG:TPL4:ATF5:6PNE:MGHN:NHQX:2GE4", + "kty": "EC", + "x": "Cu_UyxwLgHzE9rvlYSmvVdqYCXY42E9eNhBb0xNv0SQ", + "y": "zUsjWJkeKQ5tv7S-hl1Tg71cd-CqnrtiiLxSi6N_yc8" + }, + "alg": "ES256" + }, + "signature": "Y6xaFz9Sy-OtcnKQS1Ilq3Dh8cu4h3nBTJCpOTF1XF7vKtcxxA_xMP8-SgDo869SJ3VsvgPL9-Xn-OoYG2rb1A", + "protected": "eyJmb3JtYXRMZW5ndGgiOjMxOTcsImZvcm1hdFRhaWwiOiJDbjAiLCJ0aW1lIjoiMjAxNS0wOS0xMVQwNDoxMzo0OFoifQ" + } + ] +} \ No newline at end of file diff --git a/graph/fixtures/validate_manifest/no_signature_manifest b/graph/fixtures/validate_manifest/no_signature_manifest new file mode 100644 index 0000000000..7a79540af4 --- /dev/null +++ b/graph/fixtures/validate_manifest/no_signature_manifest @@ -0,0 +1,22 @@ +{ + "schemaVersion": 1, + "name": "library/hello-world", + "tag": "latest", + "architecture": "amd64", + "fsLayers": [ + { + "blobSum": "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4" + }, + { + "blobSum": "sha256:03f4658f8b782e12230c1783426bd3bacce651ce582a4ffb6fbbfa2079428ecb" + } + ], + "history": [ + { + "v1Compatibility": "{\"id\":\"af340544ed62de0680f441c71fa1a80cb084678fed42bae393e543faea3a572c\",\"parent\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.608577814Z\",\"container\":\"c2b715156f640c7ac7d98472ea24335aba5432a1323a3bb722697e6d37ef794f\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) CMD [\\\"/hello\\\"]\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/hello\"],\"Image\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n" + }, + { + "v1Compatibility": "{\"id\":\"535020c3e8add9d6bb06e5ac15a261e73d9b213d62fb2c14d752b8e189b2b912\",\"created\":\"2015-08-06T23:53:22.241352727Z\",\"container\":\"9aeb0006ffa72a8287564caaea87625896853701459261d3b569e320c0c9d5dc\",\"container_config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) COPY file:4abd3bff60458ca3b079d7b131ce26b2719055a030dfa96ff827da2b7c7038a7 in /\"],\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"docker_version\":\"1.7.1\",\"config\":{\"Hostname\":\"9aeb0006ffa7\",\"Domainname\":\"\",\"User\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":null,\"Cmd\":null,\"Image\":\"\",\"Volumes\":null,\"VolumeDriver\":\"\",\"WorkingDir\":\"\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":null,\"Labels\":null},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":960}\n" + } + ] +} diff --git a/graph/graph.go b/graph/graph.go new file mode 100644 index 0000000000..ba8dbccc95 --- /dev/null +++ b/graph/graph.go @@ -0,0 +1,953 @@ +package graph + +import ( + "compress/gzip" + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "runtime" + "strconv" + "strings" + "sync" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/digest" + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/idtools" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/pkg/truncindex" + "github.com/docker/docker/runconfig" + "github.com/vbatts/tar-split/tar/asm" + "github.com/vbatts/tar-split/tar/storage" +) + +// v1Descriptor is a non-content-addressable image descriptor +type v1Descriptor struct { + img *image.Image +} + +// ID returns the image ID specified in the image structure. +func (img v1Descriptor) ID() string { + return img.img.ID +} + +// Parent returns the parent ID specified in the image structure. +func (img v1Descriptor) Parent() string { + return img.img.Parent +} + +// MarshalConfig renders the image structure into JSON. +func (img v1Descriptor) MarshalConfig() ([]byte, error) { + return json.Marshal(img.img) +} + +// The type is used to protect pulling or building related image +// layers from deleteing when filtered by dangling=true +// The key of layers is the images ID which is pulling or building +// The value of layers is a slice which hold layer IDs referenced to +// pulling or building images +type retainedLayers struct { + layerHolders map[string]map[string]struct{} // map[layerID]map[sessionID] + sync.Mutex +} + +func (r *retainedLayers) Add(sessionID string, layerIDs []string) { + r.Lock() + defer r.Unlock() + for _, layerID := range layerIDs { + if r.layerHolders[layerID] == nil { + r.layerHolders[layerID] = map[string]struct{}{} + } + r.layerHolders[layerID][sessionID] = struct{}{} + } +} + +func (r *retainedLayers) Delete(sessionID string, layerIDs []string) { + r.Lock() + defer r.Unlock() + for _, layerID := range layerIDs { + holders, ok := r.layerHolders[layerID] + if !ok { + continue + } + delete(holders, sessionID) + if len(holders) == 0 { + delete(r.layerHolders, layerID) // Delete any empty reference set. + } + } +} + +func (r *retainedLayers) Exists(layerID string) bool { + r.Lock() + _, exists := r.layerHolders[layerID] + r.Unlock() + return exists +} + +// A Graph is a store for versioned filesystem images and the relationship between them. +type Graph struct { + root string + idIndex *truncindex.TruncIndex + driver graphdriver.Driver + imagesMutex sync.Mutex + imageMutex imageMutex // protect images in driver. + retained *retainedLayers + tarSplitDisabled bool + uidMaps []idtools.IDMap + gidMaps []idtools.IDMap + + // access to parentRefs must be protected with imageMutex locking the image id + // on the key of the map (e.g. imageMutex.Lock(img.ID), parentRefs[img.ID]...) + parentRefs map[string]int +} + +// file names for ./graph// +const ( + jsonFileName = "json" + layersizeFileName = "layersize" + digestFileName = "checksum" + tarDataFileName = "tar-data.json.gz" + v1CompatibilityFileName = "v1Compatibility" + parentFileName = "parent" +) + +var ( + // ErrDigestNotSet is used when request the digest for a layer + // but the layer has no digest value or content to compute the + // the digest. + ErrDigestNotSet = errors.New("digest is not set for layer") +) + +// NewGraph instantiates a new graph at the given root path in the filesystem. +// `root` will be created if it doesn't exist. +func NewGraph(root string, driver graphdriver.Driver, uidMaps, gidMaps []idtools.IDMap) (*Graph, error) { + abspath, err := filepath.Abs(root) + if err != nil { + return nil, err + } + + rootUID, rootGID, err := idtools.GetRootUIDGID(uidMaps, gidMaps) + if err != nil { + return nil, err + } + // Create the root directory if it doesn't exists + if err := idtools.MkdirAllAs(root, 0700, rootUID, rootGID); err != nil && !os.IsExist(err) { + return nil, err + } + + graph := &Graph{ + root: abspath, + idIndex: truncindex.NewTruncIndex([]string{}), + driver: driver, + retained: &retainedLayers{layerHolders: make(map[string]map[string]struct{})}, + uidMaps: uidMaps, + gidMaps: gidMaps, + parentRefs: make(map[string]int), + } + + // Windows does not currently support tarsplit functionality. + if runtime.GOOS == "windows" { + graph.tarSplitDisabled = true + } + + if err := graph.restore(); err != nil { + return nil, err + } + return graph, nil +} + +// IsHeld returns whether the given layerID is being used by an ongoing pull or build. +func (graph *Graph) IsHeld(layerID string) bool { + return graph.retained.Exists(layerID) +} + +func (graph *Graph) restore() error { + dir, err := ioutil.ReadDir(graph.root) + if err != nil { + return err + } + var ids = []string{} + for _, v := range dir { + id := v.Name() + if graph.driver.Exists(id) { + img, err := graph.loadImage(id) + if err != nil { + logrus.Warnf("ignoring image %s, it could not be restored: %v", id, err) + continue + } + graph.imageMutex.Lock(img.Parent) + graph.parentRefs[img.Parent]++ + graph.imageMutex.Unlock(img.Parent) + ids = append(ids, id) + } + } + + graph.idIndex = truncindex.NewTruncIndex(ids) + logrus.Debugf("Restored %d elements", len(ids)) + return nil +} + +// IsNotExist detects whether an image exists by parsing the incoming error +// message. +func (graph *Graph) IsNotExist(err error, id string) bool { + // FIXME: Implement error subclass instead of looking at the error text + // Note: This is the way golang implements os.IsNotExists on Plan9 + return err != nil && (strings.Contains(strings.ToLower(err.Error()), "does not exist") || strings.Contains(strings.ToLower(err.Error()), "no such")) && strings.Contains(err.Error(), id) +} + +// Exists returns true if an image is registered at the given id. +// If the image doesn't exist or if an error is encountered, false is returned. +func (graph *Graph) Exists(id string) bool { + if _, err := graph.Get(id); err != nil { + return false + } + return true +} + +// Get returns the image with the given id, or an error if the image doesn't exist. +func (graph *Graph) Get(name string) (*image.Image, error) { + id, err := graph.idIndex.Get(name) + if err != nil { + return nil, fmt.Errorf("could not find image: %v", err) + } + img, err := graph.loadImage(id) + if err != nil { + return nil, err + } + if img.ID != id { + return nil, fmt.Errorf("Image stored at '%s' has wrong id '%s'", id, img.ID) + } + + if img.Size < 0 { + size, err := graph.driver.DiffSize(img.ID, img.Parent) + if err != nil { + return nil, fmt.Errorf("unable to calculate size of image id %q: %s", img.ID, err) + } + + img.Size = size + if err := graph.saveSize(graph.imageRoot(id), img.Size); err != nil { + return nil, err + } + } + return img, nil +} + +// Create creates a new image and registers it in the graph. +func (graph *Graph) Create(layerData io.Reader, containerID, containerImage, comment, author string, containerConfig, config *runconfig.Config) (*image.Image, error) { + img := &image.Image{ + ID: stringid.GenerateRandomID(), + Comment: comment, + Created: time.Now().UTC(), + DockerVersion: dockerversion.VERSION, + Author: author, + Config: config, + Architecture: runtime.GOARCH, + OS: runtime.GOOS, + } + + if containerID != "" { + img.Parent = containerImage + img.Container = containerID + img.ContainerConfig = *containerConfig + } + + if err := graph.Register(v1Descriptor{img}, layerData); err != nil { + return nil, err + } + return img, nil +} + +// Register imports a pre-existing image into the graph. +// Returns nil if the image is already registered. +func (graph *Graph) Register(im image.Descriptor, layerData io.Reader) (err error) { + imgID := im.ID() + + if err := image.ValidateID(imgID); err != nil { + return err + } + + // this is needed cause pull_v2 attemptIDReuse could deadlock + graph.imagesMutex.Lock() + defer graph.imagesMutex.Unlock() + + // We need this entire operation to be atomic within the engine. Note that + // this doesn't mean Register is fully safe yet. + graph.imageMutex.Lock(imgID) + defer graph.imageMutex.Unlock(imgID) + + return graph.register(im, layerData) +} + +func (graph *Graph) register(im image.Descriptor, layerData io.Reader) (err error) { + imgID := im.ID() + + // Skip register if image is already registered + if graph.Exists(imgID) { + return nil + } + + // The returned `error` must be named in this function's signature so that + // `err` is not shadowed in this deferred cleanup. + defer func() { + // If any error occurs, remove the new dir from the driver. + // Don't check for errors since the dir might not have been created. + if err != nil { + graph.driver.Remove(imgID) + } + }() + + // Ensure that the image root does not exist on the filesystem + // when it is not registered in the graph. + // This is common when you switch from one graph driver to another + if err := os.RemoveAll(graph.imageRoot(imgID)); err != nil && !os.IsNotExist(err) { + return err + } + + // If the driver has this ID but the graph doesn't, remove it from the driver to start fresh. + // (the graph is the source of truth). + // Ignore errors, since we don't know if the driver correctly returns ErrNotExist. + // (FIXME: make that mandatory for drivers). + graph.driver.Remove(imgID) + + tmp, err := graph.mktemp() + if err != nil { + return err + } + defer os.RemoveAll(tmp) + + parent := im.Parent() + + parent := im.Parent() + + // Create root filesystem in the driver + if err := createRootFilesystemInDriver(graph, imgID, parent, layerData); err != nil { + return err + } + + // Apply the diff/layer + config, err := im.MarshalConfig() + if err != nil { + return err + } + if err := graph.storeImage(imgID, parent, config, layerData, tmp); err != nil { + return err + } + // Commit + if err := os.Rename(tmp, graph.imageRoot(imgID)); err != nil { + return err + } + + graph.idIndex.Add(imgID) + + graph.imageMutex.Lock(parent) + graph.parentRefs[parent]++ + graph.imageMutex.Unlock(parent) + + return nil +} + +func createRootFilesystemInDriver(graph *Graph, id, parent string, layerData io.Reader) error { + if err := graph.driver.Create(id, parent); err != nil { + return fmt.Errorf("Driver %s failed to create image rootfs %s: %s", graph.driver, id, err) + } + return nil +} + +// TarLayer returns a tar archive of the image's filesystem layer. +func (graph *Graph) TarLayer(img *image.Image) (arch archive.Archive, err error) { + return graph.driver.Diff(img.ID, img.Parent) +} + +// TempLayerArchive creates a temporary archive of the given image's filesystem layer. +// The archive is stored on disk and will be automatically deleted as soon as has been read. +// If output is not nil, a human-readable progress bar will be written to it. +func (graph *Graph) TempLayerArchive(id string, sf *streamformatter.StreamFormatter, output io.Writer) (*archive.TempArchive, error) { + image, err := graph.Get(id) + if err != nil { + return nil, err + } + tmp, err := graph.mktemp() + if err != nil { + return nil, err + } + defer os.RemoveAll(tmp) + a, err := graph.TarLayer(image) + if err != nil { + return nil, err + } + progressReader := progressreader.New(progressreader.Config{ + In: a, + Out: output, + Formatter: sf, + Size: 0, + NewLines: false, + ID: stringid.TruncateID(id), + Action: "Buffering to disk", + }) + defer progressReader.Close() + return archive.NewTempArchive(progressReader, tmp) +} + +// mktemp creates a temporary sub-directory inside the graph's filesystem. +func (graph *Graph) mktemp() (string, error) { + dir := filepath.Join(graph.root, "_tmp", stringid.GenerateNonCryptoID()) + rootUID, rootGID, err := idtools.GetRootUIDGID(graph.uidMaps, graph.gidMaps) + if err != nil { + return "", err + } + if err := idtools.MkdirAllAs(dir, 0700, rootUID, rootGID); err != nil { + return "", err + } + return dir, nil +} + +// Delete atomically removes an image from the graph. +func (graph *Graph) Delete(name string) error { + id, err := graph.idIndex.Get(name) + if err != nil { + return err + } + img, err := graph.Get(id) + if err != nil { + return err + } + graph.idIndex.Delete(id) + tmp, err := graph.mktemp() + if err != nil { + tmp = graph.imageRoot(id) + } else { + if err := os.Rename(graph.imageRoot(id), tmp); err != nil { + // On err make tmp point to old dir and cleanup unused tmp dir + os.RemoveAll(tmp) + tmp = graph.imageRoot(id) + } + } + // Remove rootfs data from the driver + graph.driver.Remove(id) + + graph.imageMutex.Lock(img.Parent) + graph.parentRefs[img.Parent]-- + if graph.parentRefs[img.Parent] == 0 { + delete(graph.parentRefs, img.Parent) + } + graph.imageMutex.Unlock(img.Parent) + + // Remove the trashed image directory + return os.RemoveAll(tmp) +} + +// Map returns a list of all images in the graph, addressable by ID. +func (graph *Graph) Map() map[string]*image.Image { + images := make(map[string]*image.Image) + graph.walkAll(func(image *image.Image) { + images[image.ID] = image + }) + return images +} + +// walkAll iterates over each image in the graph, and passes it to a handler. +// The walking order is undetermined. +func (graph *Graph) walkAll(handler func(*image.Image)) { + graph.idIndex.Iterate(func(id string) { + img, err := graph.Get(id) + if err != nil { + return + } + if handler != nil { + handler(img) + } + }) +} + +// ByParent returns a lookup table of images by their parent. +// If an image of key ID has 3 children images, then the value for key ID +// will be a list of 3 images. +// If an image has no children, it will not have an entry in the table. +func (graph *Graph) ByParent() map[string][]*image.Image { + byParent := make(map[string][]*image.Image) + graph.walkAll(func(img *image.Image) { + parent, err := graph.Get(img.Parent) + if err != nil { + return + } + if children, exists := byParent[parent.ID]; exists { + byParent[parent.ID] = append(children, img) + } else { + byParent[parent.ID] = []*image.Image{img} + } + }) + return byParent +} + +// HasChildren returns whether the given image has any child images. +func (graph *Graph) HasChildren(imgID string) bool { + graph.imageMutex.Lock(imgID) + count := graph.parentRefs[imgID] + graph.imageMutex.Unlock(imgID) + return count > 0 +} + +// Retain keeps the images and layers that are in the pulling chain so that +// they are not deleted. If not retained, they may be deleted by rmi. +func (graph *Graph) Retain(sessionID string, layerIDs ...string) { + graph.retained.Add(sessionID, layerIDs) +} + +// Release removes the referenced image ID from the provided set of layers. +func (graph *Graph) Release(sessionID string, layerIDs ...string) { + graph.retained.Delete(sessionID, layerIDs) +} + +// Heads returns all heads in the graph, keyed by id. +// A head is an image which is not the parent of another image in the graph. +func (graph *Graph) Heads() map[string]*image.Image { + heads := make(map[string]*image.Image) + graph.walkAll(func(image *image.Image) { + // if it has no children, then it's not a parent, so it's an head + if !graph.HasChildren(image.ID) { + heads[image.ID] = image + } + }) + return heads +} + +// TarLayer returns a tar archive of the image's filesystem layer. +func (graph *Graph) TarLayer(img *image.Image) (arch io.ReadCloser, err error) { + rdr, err := graph.assembleTarLayer(img) + if err != nil { + logrus.Debugf("[graph] TarLayer with traditional differ: %s", img.ID) + return graph.driver.Diff(img.ID, img.Parent) + } + return rdr, nil +} + +func (graph *Graph) imageRoot(id string) string { + return filepath.Join(graph.root, id) +} + +// loadImage fetches the image with the given id from the graph. +func (graph *Graph) loadImage(id string) (*image.Image, error) { + root := graph.imageRoot(id) + + // Open the JSON file to decode by streaming + jsonSource, err := os.Open(jsonPath(root)) + if err != nil { + return nil, err + } + defer jsonSource.Close() + + img := &image.Image{} + dec := json.NewDecoder(jsonSource) + + // Decode the JSON data + if err := dec.Decode(img); err != nil { + return nil, err + } + + if img.ID == "" { + img.ID = id + } + + if img.Parent == "" && img.ParentID != "" && img.ParentID.Validate() == nil { + img.Parent = img.ParentID.Hex() + } + + // compatibilityID for parent + parent, err := ioutil.ReadFile(filepath.Join(root, parentFileName)) + if err == nil && len(parent) > 0 { + img.Parent = string(parent) + } + + if err := image.ValidateID(img.ID); err != nil { + return nil, err + } + + if buf, err := ioutil.ReadFile(filepath.Join(root, layersizeFileName)); err != nil { + if !os.IsNotExist(err) { + return nil, err + } + // If the layersize file does not exist then set the size to a negative number + // because a layer size of 0 (zero) is valid + img.Size = -1 + } else { + // Using Atoi here instead would temporarily convert the size to a machine + // dependent integer type, which causes images larger than 2^31 bytes to + // display negative sizes on 32-bit machines: + size, err := strconv.ParseInt(string(buf), 10, 64) + if err != nil { + return nil, err + } + img.Size = int64(size) + } + + return img, nil +} + +// saveSize stores the `size` in the provided graph `img` directory `root`. +func (graph *Graph) saveSize(root string, size int64) error { + if err := ioutil.WriteFile(filepath.Join(root, layersizeFileName), []byte(strconv.FormatInt(size, 10)), 0600); err != nil { + return fmt.Errorf("Error storing image size in %s/%s: %s", root, layersizeFileName, err) + } + return nil +} + +// SetLayerDigest sets the digest for the image layer to the provided value. +func (graph *Graph) SetLayerDigest(id string, dgst digest.Digest) error { + graph.imageMutex.Lock(id) + defer graph.imageMutex.Unlock(id) + + return graph.setLayerDigest(id, dgst) +} +func (graph *Graph) setLayerDigest(id string, dgst digest.Digest) error { + root := graph.imageRoot(id) + if err := ioutil.WriteFile(filepath.Join(root, digestFileName), []byte(dgst.String()), 0600); err != nil { + return fmt.Errorf("Error storing digest in %s/%s: %s", root, digestFileName, err) + } + return nil +} + +// GetLayerDigest gets the digest for the provide image layer id. +func (graph *Graph) GetLayerDigest(id string) (digest.Digest, error) { + graph.imageMutex.Lock(id) + defer graph.imageMutex.Unlock(id) + + return graph.getLayerDigest(id) +} + +func (graph *Graph) getLayerDigest(id string) (digest.Digest, error) { + root := graph.imageRoot(id) + cs, err := ioutil.ReadFile(filepath.Join(root, digestFileName)) + if err != nil { + if os.IsNotExist(err) { + return "", ErrDigestNotSet + } + return "", err + } + return digest.ParseDigest(string(cs)) +} + +// SetV1CompatibilityConfig stores the v1Compatibility JSON data associated +// with the image in the manifest to the disk +func (graph *Graph) SetV1CompatibilityConfig(id string, data []byte) error { + graph.imageMutex.Lock(id) + defer graph.imageMutex.Unlock(id) + + return graph.setV1CompatibilityConfig(id, data) +} +func (graph *Graph) setV1CompatibilityConfig(id string, data []byte) error { + root := graph.imageRoot(id) + return ioutil.WriteFile(filepath.Join(root, v1CompatibilityFileName), data, 0600) +} + +// GetV1CompatibilityConfig reads the v1Compatibility JSON data for the image +// from the disk +func (graph *Graph) GetV1CompatibilityConfig(id string) ([]byte, error) { + graph.imageMutex.Lock(id) + defer graph.imageMutex.Unlock(id) + + return graph.getV1CompatibilityConfig(id) +} + +func (graph *Graph) getV1CompatibilityConfig(id string) ([]byte, error) { + root := graph.imageRoot(id) + return ioutil.ReadFile(filepath.Join(root, v1CompatibilityFileName)) +} + +// GenerateV1CompatibilityChain makes sure v1Compatibility JSON data exists +// for the image. If it doesn't it generates and stores it for the image and +// all of it's parents based on the image config JSON. +func (graph *Graph) GenerateV1CompatibilityChain(id string) ([]byte, error) { + graph.imageMutex.Lock(id) + defer graph.imageMutex.Unlock(id) + + if v1config, err := graph.getV1CompatibilityConfig(id); err == nil { + return v1config, nil + } + + // generate new, store it to disk + img, err := graph.Get(id) + if err != nil { + return nil, err + } + + digestPrefix := string(digest.Canonical) + ":" + img.ID = strings.TrimPrefix(img.ID, digestPrefix) + + if img.Parent != "" { + parentConfig, err := graph.GenerateV1CompatibilityChain(img.Parent) + if err != nil { + return nil, err + } + var parent struct{ ID string } + err = json.Unmarshal(parentConfig, &parent) + if err != nil { + return nil, err + } + img.Parent = parent.ID + } + + json, err := json.Marshal(img) + if err != nil { + return nil, err + } + if err := graph.setV1CompatibilityConfig(id, json); err != nil { + return nil, err + } + return json, nil +} + +// RawJSON returns the JSON representation for an image as a byte array. +func (graph *Graph) RawJSON(id string) ([]byte, error) { + root := graph.imageRoot(id) + + buf, err := ioutil.ReadFile(jsonPath(root)) + if err != nil { + return nil, fmt.Errorf("Failed to read json for image %s: %s", id, err) + } + + return buf, nil +} + +func jsonPath(root string) string { + return filepath.Join(root, jsonFileName) +} + +// storeImage stores file system layer data for the given image to the +// graph's storage driver. Image metadata is stored in a file +// at the specified root directory. +func (graph *Graph) storeImage(id, parent string, config []byte, layerData io.Reader, root string) (err error) { + var size int64 + // Store the layer. If layerData is not nil, unpack it into the new layer + if layerData != nil { + if size, err = graph.disassembleAndApplyTarLayer(id, parent, layerData, root); err != nil { + return err + } + } + + if err := graph.saveSize(root, size); err != nil { + return err + } + + if err := ioutil.WriteFile(jsonPath(root), config, 0600); err != nil { + return err + } + + // If image is pointing to a parent via CompatibilityID write the reference to disk + img, err := image.NewImgJSON(config) + if err != nil { + return err + } + + if img.ParentID.Validate() == nil && parent != img.ParentID.Hex() { + if err := ioutil.WriteFile(filepath.Join(root, parentFileName), []byte(parent), 0600); err != nil { + return err + } + } + return nil +} + +func (graph *Graph) disassembleAndApplyTarLayer(id, parent string, layerData io.Reader, root string) (size int64, err error) { + var ar io.Reader + + if graph.tarSplitDisabled { + ar = layerData + } else { + // this is saving the tar-split metadata + mf, err := os.OpenFile(filepath.Join(root, tarDataFileName), os.O_CREATE|os.O_WRONLY|os.O_TRUNC, os.FileMode(0600)) + if err != nil { + return 0, err + } + + mfz := gzip.NewWriter(mf) + metaPacker := storage.NewJSONPacker(mfz) + defer mf.Close() + defer mfz.Close() + + inflatedLayerData, err := archive.DecompressStream(layerData) + if err != nil { + return 0, err + } + + // we're passing nil here for the file putter, because the ApplyDiff will + // handle the extraction of the archive + rdr, err := asm.NewInputTarStream(inflatedLayerData, metaPacker, nil) + if err != nil { + return 0, err + } + + ar = archive.Reader(rdr) + } + + if size, err = graph.driver.ApplyDiff(id, parent, ar); err != nil { + return 0, err + } + + return +} + +func (graph *Graph) assembleTarLayer(img *image.Image) (io.ReadCloser, error) { + root := graph.imageRoot(img.ID) + mFileName := filepath.Join(root, tarDataFileName) + mf, err := os.Open(mFileName) + if err != nil { + if !os.IsNotExist(err) { + logrus.Errorf("failed to open %q: %s", mFileName, err) + } + return nil, err + } + pR, pW := io.Pipe() + // this will need to be in a goroutine, as we are returning the stream of a + // tar archive, but can not close the metadata reader early (when this + // function returns)... + go func() { + defer mf.Close() + // let's reassemble! + logrus.Debugf("[graph] TarLayer with reassembly: %s", img.ID) + mfz, err := gzip.NewReader(mf) + if err != nil { + pW.CloseWithError(fmt.Errorf("[graph] error with %s: %s", mFileName, err)) + return + } + defer mfz.Close() + + // get our relative path to the container + fsLayer, err := graph.driver.Get(img.ID, "") + if err != nil { + pW.CloseWithError(err) + return + } + defer graph.driver.Put(img.ID) + + metaUnpacker := storage.NewJSONUnpacker(mfz) + fileGetter := storage.NewPathFileGetter(fsLayer) + logrus.Debugf("[graph] %s is at %q", img.ID, fsLayer) + ots := asm.NewOutputTarStream(fileGetter, metaUnpacker) + defer ots.Close() + if _, err := io.Copy(pW, ots); err != nil { + pW.CloseWithError(err) + return + } + pW.Close() + }() + return pR, nil +} + +// loadImage fetches the image with the given id from the graph. +func (graph *Graph) loadImage(id string) (*image.Image, error) { + root := graph.ImageRoot(id) + + // Open the JSON file to decode by streaming + jsonSource, err := os.Open(jsonPath(root)) + if err != nil { + return nil, err + } + defer jsonSource.Close() + + img := &image.Image{} + dec := json.NewDecoder(jsonSource) + + // Decode the JSON data + if err := dec.Decode(img); err != nil { + return nil, err + } + + if img.ID == "" { + img.ID = id + } + + if img.Parent == "" && img.ParentID != "" && img.ParentID.Validate() == nil { + img.Parent = img.ParentID.Hex() + } + + // compatibilityID for parent + parent, err := ioutil.ReadFile(filepath.Join(root, parentFileName)) + if err == nil && len(parent) > 0 { + img.Parent = string(parent) + } + + if err := image.ValidateID(img.ID); err != nil { + return nil, err + } + + if buf, err := ioutil.ReadFile(filepath.Join(root, layersizeFileName)); err != nil { + if !os.IsNotExist(err) { + return nil, err + } + // If the layersize file does not exist then set the size to a negative number + // because a layer size of 0 (zero) is valid + img.Size = -1 + } else { + // Using Atoi here instead would temporarily convert the size to a machine + // dependent integer type, which causes images larger than 2^31 bytes to + // display negative sizes on 32-bit machines: + size, err := strconv.ParseInt(string(buf), 10, 64) + if err != nil { + return nil, err + } + img.Size = int64(size) + } + + return img, nil +} + +func jsonPath(root string) string { + return path.Join(root, "json") +} + +func (graph *Graph) setV1CompatibilityConfig(root string, data []byte) error { + return ioutil.WriteFile(filepath.Join(root, v1CompatibilityFileName), data, 0600) +} + +func (graph *Graph) getV1CompatibilityConfig(root string) ([]byte, error) { + return ioutil.ReadFile(filepath.Join(root, v1CompatibilityFileName)) +} + +// GenerateV1CompatibilityChain makes sure v1Compatibility JSON data exists +// for the image. If it doesn't it generates and stores it for the image and +// all of it's parents based on the image config JSON. +func (graph *Graph) GenerateV1CompatibilityChain(id string) ([]byte, error) { + if v1config, err := graph.getV1CompatibilityConfig(graph.ImageRoot(id)); err == nil { + return v1config, nil + } + + // generate new, store it to disk + img, err := graph.Get(id) + if err != nil { + return nil, err + } + + digestPrefix := "sha256:" + img.ID = strings.TrimPrefix(img.ID, digestPrefix) + + if img.Parent != "" { + parentConfig, err := graph.GenerateV1CompatibilityChain(img.Parent) + if err != nil { + return nil, err + } + var parent struct{ ID string } + err = json.Unmarshal(parentConfig, &parent) + if err != nil { + return nil, err + } + img.Parent = parent.ID + } + + json, err := json.Marshal(img) + if err != nil { + return nil, err + } + if err := graph.setV1CompatibilityConfig(graph.ImageRoot(id), json); err != nil { + return nil, err + } + return json, nil +} diff --git a/graph/graph_test.go b/graph/graph_test.go new file mode 100644 index 0000000000..79c2d099a0 --- /dev/null +++ b/graph/graph_test.go @@ -0,0 +1,308 @@ +package graph + +import ( + "errors" + "io" + "io/ioutil" + "os" + "path" + "testing" + "time" + + "github.com/docker/docker/autogen/dockerversion" + "github.com/docker/docker/daemon/graphdriver" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/stringid" +) + +func TestMount(t *testing.T) { + graph, driver := tempGraph(t) + defer os.RemoveAll(graph.root) + defer driver.Cleanup() + + archive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + image, err := graph.Create(archive, "", "", "Testing", "", nil, nil) + if err != nil { + t.Fatal(err) + } + tmp, err := ioutil.TempDir("", "docker-test-graph-mount-") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + rootfs := path.Join(tmp, "rootfs") + if err := os.MkdirAll(rootfs, 0700); err != nil { + t.Fatal(err) + } + rw := path.Join(tmp, "rw") + if err := os.MkdirAll(rw, 0700); err != nil { + t.Fatal(err) + } + + if _, err := driver.Get(image.ID, ""); err != nil { + t.Fatal(err) + } + +} + +func TestInit(t *testing.T) { + graph, _ := tempGraph(t) + defer nukeGraph(graph) + // Root should exist + if _, err := os.Stat(graph.root); err != nil { + t.Fatal(err) + } + // Map() should be empty + l := graph.Map() + if len(l) != 0 { + t.Fatalf("len(Map()) should return %d, not %d", 0, len(l)) + } +} + +// Test that Register can be interrupted cleanly without side effects +func TestInterruptedRegister(t *testing.T) { + graph, _ := tempGraph(t) + defer nukeGraph(graph) + badArchive, w := io.Pipe() // Use a pipe reader as a fake archive which never yields data + image := &image.Image{ + ID: stringid.GenerateNonCryptoID(), + Comment: "testing", + Created: time.Now(), + } + w.CloseWithError(errors.New("But I'm not a tarball!")) // (Nobody's perfect, darling) + graph.Register(v1Descriptor{image}, badArchive) + if _, err := graph.Get(image.ID); err == nil { + t.Fatal("Image should not exist after Register is interrupted") + } + // Registering the same image again should succeed if the first register was interrupted + goodArchive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + if err := graph.Register(v1Descriptor{image}, goodArchive); err != nil { + t.Fatal(err) + } +} + +// FIXME: Do more extensive tests (ex: create multiple, delete, recreate; +// create multiple, check the amount of images and paths, etc..) +func TestGraphCreate(t *testing.T) { + graph, _ := tempGraph(t) + defer nukeGraph(graph) + archive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + img, err := graph.Create(archive, "", "", "Testing", "", nil, nil) + if err != nil { + t.Fatal(err) + } + if err := image.ValidateID(img.ID); err != nil { + t.Fatal(err) + } + if img.Comment != "Testing" { + t.Fatalf("Wrong comment: should be '%s', not '%s'", "Testing", img.Comment) + } + if img.DockerVersion != dockerversion.VERSION { + t.Fatalf("Wrong docker_version: should be '%s', not '%s'", dockerversion.VERSION, img.DockerVersion) + } + images := graph.Map() + if l := len(images); l != 1 { + t.Fatalf("Wrong number of images. Should be %d, not %d", 1, l) + } + if images[img.ID] == nil { + t.Fatalf("Could not find image with id %s", img.ID) + } +} + +func TestRegister(t *testing.T) { + graph, _ := tempGraph(t) + defer nukeGraph(graph) + archive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + image := &image.Image{ + ID: stringid.GenerateNonCryptoID(), + Comment: "testing", + Created: time.Now(), + } + err = graph.Register(v1Descriptor{image}, archive) + if err != nil { + t.Fatal(err) + } + images := graph.Map() + if l := len(images); l != 1 { + t.Fatalf("Wrong number of images. Should be %d, not %d", 1, l) + } + if resultImg, err := graph.Get(image.ID); err != nil { + t.Fatal(err) + } else { + if resultImg.ID != image.ID { + t.Fatalf("Wrong image ID. Should be '%s', not '%s'", image.ID, resultImg.ID) + } + if resultImg.Comment != image.Comment { + t.Fatalf("Wrong image comment. Should be '%s', not '%s'", image.Comment, resultImg.Comment) + } + } +} + +// Test that an image can be deleted by its shorthand prefix +func TestDeletePrefix(t *testing.T) { + graph, _ := tempGraph(t) + defer nukeGraph(graph) + img := createTestImage(graph, t) + if err := graph.Delete(stringid.TruncateID(img.ID)); err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 0) +} + +func TestDelete(t *testing.T) { + graph, _ := tempGraph(t) + defer nukeGraph(graph) + archive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 0) + img, err := graph.Create(archive, "", "", "Bla bla", "", nil, nil) + if err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 1) + if err := graph.Delete(img.ID); err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 0) + + archive, err = fakeTar() + if err != nil { + t.Fatal(err) + } + // Test 2 create (same name) / 1 delete + img1, err := graph.Create(archive, "", "", "Testing", "", nil, nil) + if err != nil { + t.Fatal(err) + } + archive, err = fakeTar() + if err != nil { + t.Fatal(err) + } + if _, err = graph.Create(archive, "", "", "Testing", "", nil, nil); err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 2) + if err := graph.Delete(img1.ID); err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 1) + + // Test delete wrong name + if err := graph.Delete("Not_foo"); err == nil { + t.Fatalf("Deleting wrong ID should return an error") + } + assertNImages(graph, t, 1) + + archive, err = fakeTar() + if err != nil { + t.Fatal(err) + } + // Test delete twice (pull -> rm -> pull -> rm) + if err := graph.Register(v1Descriptor{img1}, archive); err != nil { + t.Fatal(err) + } + if err := graph.Delete(img1.ID); err != nil { + t.Fatal(err) + } + assertNImages(graph, t, 1) +} + +func TestByParent(t *testing.T) { + archive1, _ := fakeTar() + archive2, _ := fakeTar() + archive3, _ := fakeTar() + + graph, _ := tempGraph(t) + defer nukeGraph(graph) + parentImage := &image.Image{ + ID: stringid.GenerateNonCryptoID(), + Comment: "parent", + Created: time.Now(), + Parent: "", + } + childImage1 := &image.Image{ + ID: stringid.GenerateNonCryptoID(), + Comment: "child1", + Created: time.Now(), + Parent: parentImage.ID, + } + childImage2 := &image.Image{ + ID: stringid.GenerateNonCryptoID(), + Comment: "child2", + Created: time.Now(), + Parent: parentImage.ID, + } + + err := graph.Register(v1Descriptor{parentImage}, archive1) + if err != nil { + t.Fatal(err) + } + err = graph.Register(v1Descriptor{childImage1}, archive2) + if err != nil { + t.Fatal(err) + } + err = graph.Register(v1Descriptor{childImage2}, archive3) + if err != nil { + t.Fatal(err) + } + + byParent := graph.ByParent() + numChildren := len(byParent[parentImage.ID]) + if numChildren != 2 { + t.Fatalf("Expected 2 children, found %d", numChildren) + } +} + +func createTestImage(graph *Graph, t *testing.T) *image.Image { + archive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + img, err := graph.Create(archive, "", "", "Test image", "", nil, nil) + if err != nil { + t.Fatal(err) + } + return img +} + +func assertNImages(graph *Graph, t *testing.T, n int) { + images := graph.Map() + if actualN := len(images); actualN != n { + t.Fatalf("Expected %d images, found %d", n, actualN) + } +} + +func tempGraph(t *testing.T) (*Graph, graphdriver.Driver) { + tmp, err := ioutil.TempDir("", "docker-graph-") + if err != nil { + t.Fatal(err) + } + driver, err := graphdriver.New(tmp, nil, nil, nil) + if err != nil { + t.Fatal(err) + } + graph, err := NewGraph(tmp, driver, nil, nil) + if err != nil { + t.Fatal(err) + } + return graph, driver +} + +func nukeGraph(graph *Graph) { + graph.driver.Cleanup() + os.RemoveAll(graph.root) +} diff --git a/graph/history.go b/graph/history.go new file mode 100644 index 0000000000..e0f3627a35 --- /dev/null +++ b/graph/history.go @@ -0,0 +1,120 @@ +package graph + +import ( + "fmt" + "strings" + + "github.com/docker/docker/api/types" + "github.com/docker/docker/image" + "github.com/docker/docker/utils" +) + +// WalkHistory calls the handler function for each image in the +// provided images lineage starting from immediate parent. +func (graph *Graph) WalkHistory(img *image.Image, handler func(image.Image) error) (err error) { + currentImg := img + for currentImg != nil { + if handler != nil { + if err := handler(*currentImg); err != nil { + return err + } + } + currentImg, err = graph.GetParent(currentImg) + if err != nil { + return fmt.Errorf("Error while getting parent image: %v", err) + } + } + return nil +} + +// depth returns the number of parents for the current image +func (graph *Graph) depth(img *image.Image) (int, error) { + var ( + count = 0 + parent = img + err error + ) + + for parent != nil { + count++ + if parent, err = graph.GetParent(parent); err != nil { + return -1, err + } + } + return count, nil +} + +// Set the max depth to the aufs default that most +// kernels are compiled with +// For more information see: http://sourceforge.net/p/aufs/aufs3-standalone/ci/aufs3.12/tree/config.mk +const MaxImageDepth = 127 + +// CheckDepth returns an error if the depth of an image, as returned +// by ImageDepth, is too large to support creating a container from it +// on this daemon. +func (graph *Graph) CheckDepth(img *image.Image) error { + // We add 2 layers to the depth because the container's rw and + // init layer add to the restriction + depth, err := graph.depth(img) + if err != nil { + return err + } + if depth+2 >= MaxImageDepth { + return fmt.Errorf("Cannot create container with more than %d parents", MaxImageDepth) + } + return nil +} + +// History returns a slice of ImageHistory structures for the specified image +// name by walking the image lineage. +func (s *TagStore) History(name string) ([]*types.ImageHistory, error) { + foundImage, err := s.LookupImage(name) + if err != nil { + return nil, err + } + + lookupMap := make(map[string][]string) + for name, repository := range s.Repositories { + for tag, id := range repository { + // If the ID already has a reverse lookup, do not update it unless for "latest" + if _, exists := lookupMap[id]; !exists { + lookupMap[id] = []string{} + } + lookupMap[id] = append(lookupMap[id], utils.ImageReference(name, tag)) + } + } + + history := []*types.ImageHistory{} + + err = s.graph.WalkHistory(foundImage, func(img image.Image) error { + history = append(history, &types.ImageHistory{ + ID: img.ID, + Created: img.Created.Unix(), + CreatedBy: strings.Join(img.ContainerConfig.Cmd.Slice(), " "), + Tags: lookupMap[img.ID], + Size: img.Size, + Comment: img.Comment, + }) + return nil + }) + + return history, err +} + +// GetParent returns the parent image for the specified image. +func (graph *Graph) GetParent(img *image.Image) (*image.Image, error) { + if img.Parent == "" { + return nil, nil + } + return graph.Get(img.Parent) +} + +// GetParentsSize returns the combined size of all parent images. If there is +// no parent image or it's unavailable, it returns 0. +func (graph *Graph) GetParentsSize(img *image.Image) int64 { + parentImage, err := graph.GetParent(img) + if err != nil || parentImage == nil { + return 0 + } + return parentImage.Size + graph.GetParentsSize(parentImage) +} diff --git a/graph/import.go b/graph/import.go new file mode 100644 index 0000000000..1a09dec470 --- /dev/null +++ b/graph/import.go @@ -0,0 +1,79 @@ +package graph + +import ( + "io" + "net/http" + "net/url" + + "github.com/docker/docker/pkg/httputils" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" +) + +// Import imports an image, getting the archived layer data either from +// inConfig (if src is "-"), or from a URI specified in src. Progress output is +// written to outStream. Repository and tag names can optionally be given in +// the repo and tag arguments, respectively. +func (s *TagStore) Import(src string, repo string, tag string, msg string, inConfig io.ReadCloser, outStream io.Writer, containerConfig *runconfig.Config) error { + var ( + sf = streamformatter.NewJSONStreamFormatter() + archive io.ReadCloser + resp *http.Response + ) + + if src == "-" { + archive = inConfig + } else { + inConfig.Close() + u, err := url.Parse(src) + if err != nil { + return err + } + if u.Scheme == "" { + u.Scheme = "http" + u.Host = src + u.Path = "" + } + outStream.Write(sf.FormatStatus("", "Downloading from %s", u)) + resp, err = httputils.Download(u.String()) + if err != nil { + return err + } + progressReader := progressreader.New(progressreader.Config{ + In: resp.Body, + Out: outStream, + Formatter: sf, + Size: resp.ContentLength, + NewLines: true, + ID: "", + Action: "Importing", + }) + archive = progressReader + } + + defer archive.Close() + if len(msg) == 0 { + msg = "Imported from " + src + } + + img, err := s.graph.Create(archive, "", "", msg, "", nil, containerConfig) + if err != nil { + return err + } + // Optionally register the image at REPO/TAG + if repo != "" { + if err := s.Tag(repo, tag, img.ID, true); err != nil { + return err + } + } + outStream.Write(sf.FormatStatus("", img.ID)) + logID := img.ID + if tag != "" { + logID = utils.ImageReference(logID, tag) + } + + s.eventsService.Log("import", logID, "") + return nil +} diff --git a/graph/list.go b/graph/list.go new file mode 100644 index 0000000000..8110beed28 --- /dev/null +++ b/graph/list.go @@ -0,0 +1,185 @@ +package graph + +import ( + "fmt" + "path" + "sort" + "strings" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/parsers/filters" + "github.com/docker/docker/utils" +) + +var acceptedImageFilterTags = map[string]struct{}{ + "dangling": {}, + "label": {}, +} + +// byCreated is a temporary type used to sort a list of images by creation +// time. +type byCreated []*types.Image + +func (r byCreated) Len() int { return len(r) } +func (r byCreated) Swap(i, j int) { r[i], r[j] = r[j], r[i] } +func (r byCreated) Less(i, j int) bool { return r[i].Created < r[j].Created } + +// Images returns a filtered list of images. filterArgs is a JSON-encoded set +// of filter arguments which will be interpreted by pkg/parsers/filters. +// filter is a shell glob string applied to repository names. The argument +// named all controls whether all images in the graph are filtered, or just +// the heads. +func (s *TagStore) Images(filterArgs, filter string, all bool) ([]*types.Image, error) { + var ( + allImages map[string]*image.Image + err error + filtTagged = true + filtLabel = false + ) + + imageFilters, err := filters.FromParam(filterArgs) + if err != nil { + return nil, err + } + for name := range imageFilters { + if _, ok := acceptedImageFilterTags[name]; !ok { + return nil, fmt.Errorf("Invalid filter '%s'", name) + } + } + + if i, ok := imageFilters["dangling"]; ok { + for _, value := range i { + if v := strings.ToLower(value); v == "true" { + filtTagged = false + } else if v != "false" { + return nil, fmt.Errorf("Invalid filter 'dangling=%s'", v) + } + } + } + + _, filtLabel = imageFilters["label"] + + if all && filtTagged { + allImages = s.graph.Map() + } else { + allImages = s.graph.Heads() + } + + lookup := make(map[string]*types.Image) + s.Lock() + for repoName, repository := range s.Repositories { + filterTagName := "" + if filter != "" { + filterName := filter + // Test if the tag was in there, if yes, get the name + if strings.Contains(filterName, ":") { + filterWithTag := strings.Split(filter, ":") + filterName = filterWithTag[0] + filterTagName = filterWithTag[1] + } + if match, _ := path.Match(filterName, repoName); !match { + continue + } + if filterTagName != "" { + if _, ok := repository[filterTagName]; !ok { + continue + } + } + } + for ref, id := range repository { + imgRef := utils.ImageReference(repoName, ref) + if !strings.Contains(imgRef, filterTagName) { + continue + } + image, err := s.graph.Get(id) + if err != nil { + logrus.Warnf("couldn't load %s from %s: %s", id, imgRef, err) + continue + } + + if lImage, exists := lookup[id]; exists { + if filtTagged { + if utils.DigestReference(ref) { + lImage.RepoDigests = append(lImage.RepoDigests, imgRef) + } else { // Tag Ref. + lImage.RepoTags = append(lImage.RepoTags, imgRef) + } + } + } else { + // get the boolean list for if only the untagged images are requested + delete(allImages, id) + + if len(imageFilters["label"]) > 0 { + if image.Config == nil { + // Very old image that do not have image.Config (or even labels) + continue + } + // We are now sure image.Config is not nil + if !imageFilters.MatchKVList("label", image.Config.Labels) { + continue + } + } + if filtTagged { + newImage := newImage(image, s.graph.GetParentsSize(image)) + + if utils.DigestReference(ref) { + newImage.RepoTags = []string{} + newImage.RepoDigests = []string{imgRef} + } else { + newImage.RepoTags = []string{imgRef} + newImage.RepoDigests = []string{} + } + + lookup[id] = newImage + } + } + + } + } + s.Unlock() + + images := []*types.Image{} + for _, value := range lookup { + images = append(images, value) + } + + // Display images which aren't part of a repository/tag + if filter == "" || filtLabel { + for _, image := range allImages { + if len(imageFilters["label"]) > 0 { + if image.Config == nil { + // Very old image that do not have image.Config (or even labels) + continue + } + // We are now sure image.Config is not nil + if !imageFilters.MatchKVList("label", image.Config.Labels) { + continue + } + } + newImage := newImage(image, s.graph.GetParentsSize(image)) + newImage.RepoTags = []string{":"} + newImage.RepoDigests = []string{"@"} + + images = append(images, newImage) + } + } + + sort.Sort(sort.Reverse(byCreated(images))) + + return images, nil +} + +func newImage(image *image.Image, parentSize int64) *types.Image { + newImage := new(types.Image) + newImage.ParentID = image.Parent + newImage.ID = image.ID + newImage.Created = image.Created.Unix() + newImage.Size = image.Size + newImage.VirtualSize = parentSize + image.Size + if image.Config != nil { + newImage.Labels = image.Config.Labels + } + return newImage +} diff --git a/graph/load.go b/graph/load.go new file mode 100644 index 0000000000..e78a61478c --- /dev/null +++ b/graph/load.go @@ -0,0 +1,132 @@ +// +build linux windows + +package graph + +import ( + "encoding/json" + "io" + "io/ioutil" + "os" + "path/filepath" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/archive" + "github.com/docker/docker/pkg/chrootarchive" +) + +// Load uploads a set of images into the repository. This is the complementary of ImageExport. +// The input stream is an uncompressed tar ball containing images and metadata. +func (s *TagStore) Load(inTar io.ReadCloser, outStream io.Writer) error { + tmpImageDir, err := ioutil.TempDir("", "docker-import-") + if err != nil { + return err + } + defer os.RemoveAll(tmpImageDir) + + var ( + repoDir = filepath.Join(tmpImageDir, "repo") + ) + + if err := os.Mkdir(repoDir, os.ModeDir); err != nil { + return err + } + images := s.graph.Map() + excludes := make([]string, len(images)) + i := 0 + for k := range images { + excludes[i] = k + i++ + } + if err := chrootarchive.Untar(inTar, repoDir, &archive.TarOptions{ExcludePatterns: excludes}); err != nil { + return err + } + + dirs, err := ioutil.ReadDir(repoDir) + if err != nil { + return err + } + + for _, d := range dirs { + if d.IsDir() { + if err := s.recursiveLoad(d.Name(), tmpImageDir); err != nil { + return err + } + } + } + + reposJSONFile, err := os.Open(filepath.Join(tmpImageDir, "repo", "repositories")) + if err != nil { + if !os.IsNotExist(err) { + return err + } + return nil + } + defer reposJSONFile.Close() + + repositories := map[string]Repository{} + if err := json.NewDecoder(reposJSONFile).Decode(&repositories); err != nil { + return err + } + + for imageName, tagMap := range repositories { + for tag, address := range tagMap { + if err := s.setLoad(imageName, tag, address, true, outStream); err != nil { + return err + } + } + } + + return nil +} + +func (s *TagStore) recursiveLoad(address, tmpImageDir string) error { + if _, err := s.LookupImage(address); err != nil { + logrus.Debugf("Loading %s", address) + + imageJSON, err := ioutil.ReadFile(filepath.Join(tmpImageDir, "repo", address, "json")) + if err != nil { + logrus.Debugf("Error reading json: %v", err) + return err + } + + layer, err := os.Open(filepath.Join(tmpImageDir, "repo", address, "layer.tar")) + if err != nil { + logrus.Debugf("Error reading embedded tar: %v", err) + return err + } + img, err := image.NewImgJSON(imageJSON) + if err != nil { + logrus.Debugf("Error unmarshalling json: %v", err) + return err + } + if err := image.ValidateID(img.ID); err != nil { + logrus.Debugf("Error validating ID: %v", err) + return err + } + + // ensure no two downloads of the same layer happen at the same time + poolKey := "layer:" + img.ID + broadcaster, found := s.poolAdd("pull", poolKey) + if found { + logrus.Debugf("Image (id: %s) load is already running, waiting", img.ID) + return broadcaster.Wait() + } + + defer s.poolRemove("pull", poolKey) + + if img.Parent != "" { + if !s.graph.Exists(img.Parent) { + if err := s.recursiveLoad(img.Parent, tmpImageDir); err != nil { + return err + } + } + } + if err := s.graph.Register(v1Descriptor{img}, layer); err != nil { + return err + } + } + logrus.Debugf("Completed processing %s", address) + + return nil +} diff --git a/graph/load_unsupported.go b/graph/load_unsupported.go new file mode 100644 index 0000000000..7154931f29 --- /dev/null +++ b/graph/load_unsupported.go @@ -0,0 +1,14 @@ +// +build !linux,!windows + +package graph + +import ( + "fmt" + "io" +) + +// Load method is implemented here for non-linux and non-windows platforms and +// may return an error indicating that image load is not supported on other platforms. +func (s *TagStore) Load(inTar io.ReadCloser, outStream io.Writer) error { + return fmt.Errorf("Load is not supported on this platform") +} diff --git a/graph/mutex.go b/graph/mutex.go new file mode 100644 index 0000000000..a5f3991bba --- /dev/null +++ b/graph/mutex.go @@ -0,0 +1,45 @@ +package graph + +import "sync" + +// imageMutex provides a lock per image id to protect shared resources in the +// graph. This is only used with registration but should be used when +// manipulating the layer store. +type imageMutex struct { + mus map[string]*sync.Mutex // mutexes by image id. + mu sync.Mutex // protects lock map + + // NOTE(stevvooe): The map above will grow to the size of all images ever + // registered during a daemon run. To free these resources, we must + // deallocate after unlock. Doing this safely is non-trivial in the face + // of a very minor leak. +} + +// Lock the provided id. +func (im *imageMutex) Lock(id string) { + im.getImageLock(id).Lock() +} + +// Unlock the provided id. +func (im *imageMutex) Unlock(id string) { + im.getImageLock(id).Unlock() +} + +// getImageLock returns the mutex for the given id. This method will never +// return nil. +func (im *imageMutex) getImageLock(id string) *sync.Mutex { + im.mu.Lock() + defer im.mu.Unlock() + + if im.mus == nil { // lazy + im.mus = make(map[string]*sync.Mutex) + } + + mu, ok := im.mus[id] + if !ok { + mu = new(sync.Mutex) + im.mus[id] = mu + } + + return mu +} diff --git a/graph/pools_test.go b/graph/pools_test.go new file mode 100644 index 0000000000..6382c15596 --- /dev/null +++ b/graph/pools_test.go @@ -0,0 +1,44 @@ +package graph + +import ( + "testing" + + "github.com/docker/docker/pkg/broadcaster" + "github.com/docker/docker/pkg/reexec" +) + +func init() { + reexec.Init() +} + +func TestPools(t *testing.T) { + s := &TagStore{ + pullingPool: make(map[string]*broadcaster.Buffered), + pushingPool: make(map[string]*broadcaster.Buffered), + } + + if _, found := s.poolAdd("pull", "test1"); found { + t.Fatal("Expected pull test1 not to be in progress") + } + if _, found := s.poolAdd("pull", "test2"); found { + t.Fatal("Expected pull test2 not to be in progress") + } + if _, found := s.poolAdd("push", "test1"); !found { + t.Fatalf("Expected pull test1 to be in progress`") + } + if _, found := s.poolAdd("pull", "test1"); !found { + t.Fatalf("Expected pull test1 to be in progress`") + } + if err := s.poolRemove("pull", "test2"); err != nil { + t.Fatal(err) + } + if err := s.poolRemove("pull", "test2"); err != nil { + t.Fatal(err) + } + if err := s.poolRemove("pull", "test1"); err != nil { + t.Fatal(err) + } + if err := s.poolRemove("push", "test1"); err != nil { + t.Fatal(err) + } +} diff --git a/graph/pull.go b/graph/pull.go new file mode 100644 index 0000000000..b640348579 --- /dev/null +++ b/graph/pull.go @@ -0,0 +1,148 @@ +package graph + +import ( + "fmt" + "io" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" +) + +// ImagePullConfig stores pull configuration. +type ImagePullConfig struct { + // MetaHeaders stores HTTP headers with metadata about the image + // (DockerHeaders with prefix X-Meta- in the request). + MetaHeaders map[string][]string + // AuthConfig holds authentication credentials for authenticating with + // the registry. + AuthConfig *cliconfig.AuthConfig + // OutStream is the output writer for showing the status of the pull + // operation. + OutStream io.Writer +} + +// Puller is an interface that abstracts pulling for different API versions. +type Puller interface { + // Pull tries to pull the image referenced by `tag` + // Pull returns an error if any, as well as a boolean that determines whether to retry Pull on the next configured endpoint. + // + // TODO(tiborvass): have Pull() take a reference to repository + tag, so that the puller itself is repository-agnostic. + Pull(tag string) (fallback bool, err error) +} + +// NewPuller returns a Puller interface that will pull from either a v1 or v2 +// registry. The endpoint argument contains a Version field that determines +// whether a v1 or v2 puller will be created. The other parameters are passed +// through to the underlying puller implementation for use during the actual +// pull operation. +func NewPuller(s *TagStore, endpoint registry.APIEndpoint, repoInfo *registry.RepositoryInfo, imagePullConfig *ImagePullConfig, sf *streamformatter.StreamFormatter) (Puller, error) { + switch endpoint.Version { + case registry.APIVersion2: + return &v2Puller{ + TagStore: s, + endpoint: endpoint, + config: imagePullConfig, + sf: sf, + repoInfo: repoInfo, + }, nil + case registry.APIVersion1: + return &v1Puller{ + TagStore: s, + endpoint: endpoint, + config: imagePullConfig, + sf: sf, + repoInfo: repoInfo, + }, nil + } + return nil, fmt.Errorf("unknown version %d for registry %s", endpoint.Version, endpoint.URL) +} + +// Pull initiates a pull operation. image is the repository name to pull, and +// tag may be either empty, or indicate a specific tag to pull. +func (s *TagStore) Pull(image string, tag string, imagePullConfig *ImagePullConfig) error { + var sf = streamformatter.NewJSONStreamFormatter() + + // Resolve the Repository name from fqn to RepositoryInfo + repoInfo, err := s.registryService.ResolveRepository(image) + if err != nil { + return err + } + + // makes sure name is not empty or `scratch` + if err := validateRepoName(repoInfo.LocalName); err != nil { + return err + } + + endpoints, err := s.registryService.LookupPullEndpoints(repoInfo.CanonicalName) + if err != nil { + return err + } + + logName := repoInfo.LocalName + if tag != "" { + logName = utils.ImageReference(logName, tag) + } + + var ( + lastErr error + + // discardNoSupportErrors is used to track whether an endpoint encountered an error of type registry.ErrNoSupport + // By default it is false, which means that if a ErrNoSupport error is encountered, it will be saved in lastErr. + // As soon as another kind of error is encountered, discardNoSupportErrors is set to true, avoiding the saving of + // any subsequent ErrNoSupport errors in lastErr. + // It's needed for pull-by-digest on v1 endpoints: if there are only v1 endpoints configured, the error should be + // returned and displayed, but if there was a v2 endpoint which supports pull-by-digest, then the last relevant + // error is the ones from v2 endpoints not v1. + discardNoSupportErrors bool + ) + for _, endpoint := range endpoints { + logrus.Debugf("Trying to pull %s from %s %s", repoInfo.LocalName, endpoint.URL, endpoint.Version) + + puller, err := NewPuller(s, endpoint, repoInfo, imagePullConfig, sf) + if err != nil { + lastErr = err + continue + } + if fallback, err := puller.Pull(tag); err != nil { + if fallback { + if _, ok := err.(registry.ErrNoSupport); !ok { + // Because we found an error that's not ErrNoSupport, discard all subsequent ErrNoSupport errors. + discardNoSupportErrors = true + // save the current error + lastErr = err + } else if !discardNoSupportErrors { + // Save the ErrNoSupport error, because it's either the first error or all encountered errors + // were also ErrNoSupport errors. + lastErr = err + } + continue + } + logrus.Debugf("Not continuing with error: %v", err) + return err + + } + + s.eventsService.Log("pull", logName, "") + return nil + } + + if lastErr == nil { + lastErr = fmt.Errorf("no endpoints found for %s", image) + } + return lastErr +} + +// writeStatus writes a status message to out. If layersDownloaded is true, the +// status message indicates that a newer image was downloaded. Otherwise, it +// indicates that the image is up to date. requestedTag is the tag the message +// will refer to. +func writeStatus(requestedTag string, out io.Writer, sf *streamformatter.StreamFormatter, layersDownloaded bool) { + if layersDownloaded { + out.Write(sf.FormatStatus("", "Status: Downloaded newer image for %s", requestedTag)) + } else { + out.Write(sf.FormatStatus("", "Status: Image is up to date for %s", requestedTag)) + } +} diff --git a/graph/pull_v1.go b/graph/pull_v1.go new file mode 100644 index 0000000000..754b041db1 --- /dev/null +++ b/graph/pull_v1.go @@ -0,0 +1,350 @@ +package graph + +import ( + "errors" + "fmt" + "io" + "net" + "net/url" + "strings" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" +) + +type v1Puller struct { + *TagStore + endpoint registry.APIEndpoint + config *ImagePullConfig + sf *streamformatter.StreamFormatter + repoInfo *registry.RepositoryInfo + session *registry.Session +} + +func (p *v1Puller) Pull(tag string) (fallback bool, err error) { + if utils.DigestReference(tag) { + // Allowing fallback, because HTTPS v1 is before HTTP v2 + return true, registry.ErrNoSupport{errors.New("Cannot pull by digest with v1 registry")} + } + + tlsConfig, err := p.registryService.TLSConfig(p.repoInfo.Index.Name) + if err != nil { + return false, err + } + // Adds Docker-specific headers as well as user-specified headers (metaHeaders) + tr := transport.NewTransport( + // TODO(tiborvass): was ReceiveTimeout + registry.NewTransport(tlsConfig), + registry.DockerHeaders(p.config.MetaHeaders)..., + ) + client := registry.HTTPClient(tr) + v1Endpoint, err := p.endpoint.ToV1Endpoint(p.config.MetaHeaders) + if err != nil { + logrus.Debugf("Could not get v1 endpoint: %v", err) + return true, err + } + p.session, err = registry.NewSession(client, p.config.AuthConfig, v1Endpoint) + if err != nil { + // TODO(dmcgowan): Check if should fallback + logrus.Debugf("Fallback from error: %s", err) + return true, err + } + if err := p.pullRepository(tag); err != nil { + // TODO(dmcgowan): Check if should fallback + return false, err + } + out := p.config.OutStream + out.Write(p.sf.FormatStatus("", "%s: this image was pulled from a legacy registry. Important: This registry version will not be supported in future versions of docker.", p.repoInfo.CanonicalName)) + + return false, nil +} + +func (p *v1Puller) pullRepository(askedTag string) error { + out := p.config.OutStream + out.Write(p.sf.FormatStatus("", "Pulling repository %s", p.repoInfo.CanonicalName)) + + repoData, err := p.session.GetRepositoryData(p.repoInfo.RemoteName) + if err != nil { + if strings.Contains(err.Error(), "HTTP code: 404") { + return fmt.Errorf("Error: image %s not found", utils.ImageReference(p.repoInfo.RemoteName, askedTag)) + } + // Unexpected HTTP error + return err + } + + logrus.Debugf("Retrieving the tag list") + tagsList := make(map[string]string) + if askedTag == "" { + tagsList, err = p.session.GetRemoteTags(repoData.Endpoints, p.repoInfo.RemoteName) + } else { + var tagID string + tagID, err = p.session.GetRemoteTag(repoData.Endpoints, p.repoInfo.RemoteName, askedTag) + tagsList[askedTag] = tagID + } + if err != nil { + if err == registry.ErrRepoNotFound && askedTag != "" { + return fmt.Errorf("Tag %s not found in repository %s", askedTag, p.repoInfo.CanonicalName) + } + logrus.Errorf("unable to get remote tags: %s", err) + return err + } + + for tag, id := range tagsList { + repoData.ImgList[id] = ®istry.ImgData{ + ID: id, + Tag: tag, + Checksum: "", + } + } + + logrus.Debugf("Registering tags") + // If no tag has been specified, pull them all + if askedTag == "" { + for tag, id := range tagsList { + repoData.ImgList[id].Tag = tag + } + } else { + // Otherwise, check that the tag exists and use only that one + id, exists := tagsList[askedTag] + if !exists { + return fmt.Errorf("Tag %s not found in repository %s", askedTag, p.repoInfo.CanonicalName) + } + repoData.ImgList[id].Tag = askedTag + } + + errors := make(chan error) + + layersDownloaded := false + imgIDs := []string{} + sessionID := p.session.ID() + defer func() { + p.graph.Release(sessionID, imgIDs...) + }() + for _, imgData := range repoData.ImgList { + downloadImage := func(img *registry.ImgData) { + if askedTag != "" && img.Tag != askedTag { + errors <- nil + return + } + + if img.Tag == "" { + logrus.Debugf("Image (id: %s) present in this repository but untagged, skipping", img.ID) + errors <- nil + return + } + + if err := image.ValidateID(img.ID); err != nil { + errors <- err + return + } + + // ensure no two downloads of the same image happen at the same time + poolKey := "img:" + img.ID + broadcaster, found := p.poolAdd("pull", poolKey) + broadcaster.Add(out) + if found { + errors <- broadcaster.Wait() + return + } + defer p.poolRemove("pull", poolKey) + + // we need to retain it until tagging + p.graph.Retain(sessionID, img.ID) + imgIDs = append(imgIDs, img.ID) + + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), fmt.Sprintf("Pulling image (%s) from %s", img.Tag, p.repoInfo.CanonicalName), nil)) + success := false + var lastErr, err error + var isDownloaded bool + for _, ep := range p.repoInfo.Index.Mirrors { + ep += "v1/" + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), fmt.Sprintf("Pulling image (%s) from %s, mirror: %s", img.Tag, p.repoInfo.CanonicalName, ep), nil)) + if isDownloaded, err = p.pullImage(broadcaster, img.ID, ep); err != nil { + // Don't report errors when pulling from mirrors. + logrus.Debugf("Error pulling image (%s) from %s, mirror: %s, %s", img.Tag, p.repoInfo.CanonicalName, ep, err) + continue + } + layersDownloaded = layersDownloaded || isDownloaded + success = true + break + } + if !success { + for _, ep := range repoData.Endpoints { + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), fmt.Sprintf("Pulling image (%s) from %s, endpoint: %s", img.Tag, p.repoInfo.CanonicalName, ep), nil)) + if isDownloaded, err = p.pullImage(broadcaster, img.ID, ep); err != nil { + // It's not ideal that only the last error is returned, it would be better to concatenate the errors. + // As the error is also given to the output stream the user will see the error. + lastErr = err + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), fmt.Sprintf("Error pulling image (%s) from %s, endpoint: %s, %s", img.Tag, p.repoInfo.CanonicalName, ep, err), nil)) + continue + } + layersDownloaded = layersDownloaded || isDownloaded + success = true + break + } + } + if !success { + err := fmt.Errorf("Error pulling image (%s) from %s, %v", img.Tag, p.repoInfo.CanonicalName, lastErr) + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), err.Error(), nil)) + errors <- err + broadcaster.CloseWithError(err) + return + } + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), "Download complete", nil)) + + errors <- nil + } + + go downloadImage(imgData) + } + + var lastError error + for i := 0; i < len(repoData.ImgList); i++ { + if err := <-errors; err != nil { + lastError = err + } + } + if lastError != nil { + return lastError + } + + for tag, id := range tagsList { + if askedTag != "" && tag != askedTag { + continue + } + if err := p.Tag(p.repoInfo.LocalName, tag, id, true); err != nil { + return err + } + } + + requestedTag := p.repoInfo.LocalName + if len(askedTag) > 0 { + requestedTag = utils.ImageReference(p.repoInfo.LocalName, askedTag) + } + writeStatus(requestedTag, out, p.sf, layersDownloaded) + return nil +} + +func (p *v1Puller) pullImage(out io.Writer, imgID, endpoint string) (layersDownloaded bool, err error) { + var history []string + history, err = p.session.GetRemoteHistory(imgID, endpoint) + if err != nil { + return false, err + } + out.Write(p.sf.FormatProgress(stringid.TruncateID(imgID), "Pulling dependent layers", nil)) + // FIXME: Try to stream the images? + // FIXME: Launch the getRemoteImage() in goroutines + + sessionID := p.session.ID() + // As imgID has been retained in pullRepository, no need to retain again + p.graph.Retain(sessionID, history[1:]...) + defer p.graph.Release(sessionID, history[1:]...) + + layersDownloaded = false + for i := len(history) - 1; i >= 0; i-- { + id := history[i] + + // ensure no two downloads of the same layer happen at the same time + poolKey := "layer:" + id + broadcaster, found := p.poolAdd("pull", poolKey) + broadcaster.Add(out) + if found { + logrus.Debugf("Image (id: %s) pull is already running, skipping", id) + err = broadcaster.Wait() + if err != nil { + return layersDownloaded, err + } + continue + } + + // This must use a closure so it captures the value of err when + // the function returns, not when the 'defer' is evaluated. + defer func() { + p.poolRemoveWithError("pull", poolKey, err) + }() + + if !p.graph.Exists(id) { + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), "Pulling metadata", nil)) + var ( + imgJSON []byte + imgSize int64 + err error + img *image.Image + ) + retries := 5 + for j := 1; j <= retries; j++ { + imgJSON, imgSize, err = p.session.GetRemoteImageJSON(id, endpoint) + if err != nil && j == retries { + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), "Error pulling dependent layers", nil)) + return layersDownloaded, err + } else if err != nil { + time.Sleep(time.Duration(j) * 500 * time.Millisecond) + continue + } + img, err = image.NewImgJSON(imgJSON) + layersDownloaded = true + if err != nil && j == retries { + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), "Error pulling dependent layers", nil)) + return layersDownloaded, fmt.Errorf("Failed to parse json: %s", err) + } else if err != nil { + time.Sleep(time.Duration(j) * 500 * time.Millisecond) + continue + } else { + break + } + } + + for j := 1; j <= retries; j++ { + // Get the layer + status := "Pulling fs layer" + if j > 1 { + status = fmt.Sprintf("Pulling fs layer [retries: %d]", j) + } + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), status, nil)) + layer, err := p.session.GetRemoteImageLayer(img.ID, endpoint, imgSize) + if uerr, ok := err.(*url.Error); ok { + err = uerr.Err + } + if terr, ok := err.(net.Error); ok && terr.Timeout() && j < retries { + time.Sleep(time.Duration(j) * 500 * time.Millisecond) + continue + } else if err != nil { + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), "Error pulling dependent layers", nil)) + return layersDownloaded, err + } + layersDownloaded = true + defer layer.Close() + + err = p.graph.Register(v1Descriptor{img}, + progressreader.New(progressreader.Config{ + In: layer, + Out: broadcaster, + Formatter: p.sf, + Size: imgSize, + NewLines: false, + ID: stringid.TruncateID(id), + Action: "Downloading", + })) + if terr, ok := err.(net.Error); ok && terr.Timeout() && j < retries { + time.Sleep(time.Duration(j) * 500 * time.Millisecond) + continue + } else if err != nil { + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), "Error downloading dependent layers", nil)) + return layersDownloaded, err + } else { + break + } + } + } + broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(id), "Download complete", nil)) + broadcaster.Close() + } + return layersDownloaded, nil +} diff --git a/graph/pull_v2.go b/graph/pull_v2.go new file mode 100644 index 0000000000..346b7ee58b --- /dev/null +++ b/graph/pull_v2.go @@ -0,0 +1,698 @@ +package graph + +import ( + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/broadcaster" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" + "golang.org/x/net/context" +) + +type v2Puller struct { + *TagStore + endpoint registry.APIEndpoint + config *ImagePullConfig + sf *streamformatter.StreamFormatter + repoInfo *registry.RepositoryInfo + repo distribution.Repository + sessionID string +} + +func (p *v2Puller) Pull(tag string) (fallback bool, err error) { + // TODO(tiborvass): was ReceiveTimeout + p.repo, err = NewV2Repository(p.repoInfo, p.endpoint, p.config.MetaHeaders, p.config.AuthConfig, "pull") + if err != nil { + logrus.Warnf("Error getting v2 registry: %v", err) + return true, err + } + + p.sessionID = stringid.GenerateRandomID() + + if err := p.pullV2Repository(tag); err != nil { + if registry.ContinueOnError(err) { + logrus.Debugf("Error trying v2 registry: %v", err) + return true, err + } + return false, err + } + return false, nil +} + +func (p *v2Puller) pullV2Repository(tag string) (err error) { + var tags []string + taggedName := p.repoInfo.LocalName + if len(tag) > 0 { + tags = []string{tag} + taggedName = utils.ImageReference(p.repoInfo.LocalName, tag) + } else { + var err error + + manSvc, err := p.repo.Manifests(context.Background()) + if err != nil { + return err + } + + tags, err = manSvc.Tags() + if err != nil { + return err + } + + } + + poolKey := "v2:" + taggedName + broadcaster, found := p.poolAdd("pull", poolKey) + broadcaster.Add(p.config.OutStream) + if found { + // Another pull of the same repository is already taking place; just wait for it to finish + return broadcaster.Wait() + } + + // This must use a closure so it captures the value of err when the + // function returns, not when the 'defer' is evaluated. + defer func() { + p.poolRemoveWithError("pull", poolKey, err) + }() + + var layersDownloaded bool + for _, tag := range tags { + // pulledNew is true if either new layers were downloaded OR if existing images were newly tagged + // TODO(tiborvass): should we change the name of `layersDownload`? What about message in WriteStatus? + pulledNew, err := p.pullV2Tag(broadcaster, tag, taggedName) + if err != nil { + return err + } + layersDownloaded = layersDownloaded || pulledNew + } + + writeStatus(taggedName, broadcaster, p.sf, layersDownloaded) + + return nil +} + +// downloadInfo is used to pass information from download to extractor +type downloadInfo struct { + img contentAddressableDescriptor + imgIndex int + tmpFile *os.File + digest digest.Digest + layer distribution.ReadSeekCloser + size int64 + err chan error + poolKey string + broadcaster *broadcaster.Buffered +} + +// contentAddressableDescriptor is used to pass image data from a manifest to the +// graph. +type contentAddressableDescriptor struct { + id string + parent string + strongID digest.Digest + compatibilityID string + config []byte + v1Compatibility []byte +} + +func newContentAddressableImage(v1Compatibility []byte, blobSum digest.Digest, parent digest.Digest) (contentAddressableDescriptor, error) { + img := contentAddressableDescriptor{ + v1Compatibility: v1Compatibility, + } + + var err error + img.config, err = image.MakeImageConfig(v1Compatibility, blobSum, parent) + if err != nil { + return img, err + } + img.strongID, err = image.StrongID(img.config) + if err != nil { + return img, err + } + + unmarshalledConfig, err := image.NewImgJSON(v1Compatibility) + if err != nil { + return img, err + } + + img.compatibilityID = unmarshalledConfig.ID + img.id = img.strongID.Hex() + + return img, nil +} + +// ID returns the actual ID to be used for the downloaded image. This may be +// a computed ID. +func (img contentAddressableDescriptor) ID() string { + return img.id +} + +// Parent returns the parent ID to be used for the image. This may be a +// computed ID. +func (img contentAddressableDescriptor) Parent() string { + return img.parent +} + +// MarshalConfig renders the image structure into JSON. +func (img contentAddressableDescriptor) MarshalConfig() ([]byte, error) { + return img.config, nil +} + +type errVerification struct{} + +func (errVerification) Error() string { return "verification failed" } + +func (p *v2Puller) download(di *downloadInfo) { + logrus.Debugf("pulling blob %q to %s", di.digest, di.img.id) + + blobs := p.repo.Blobs(context.Background()) + + desc, err := blobs.Stat(context.Background(), di.digest) + if err != nil { + logrus.Debugf("Error statting layer: %v", err) + di.err <- err + return + } + di.size = desc.Size + + layerDownload, err := blobs.Open(context.Background(), di.digest) + if err != nil { + logrus.Debugf("Error fetching layer: %v", err) + di.err <- err + return + } + defer layerDownload.Close() + + verifier, err := digest.NewDigestVerifier(di.digest) + if err != nil { + di.err <- err + return + } + + reader := progressreader.New(progressreader.Config{ + In: ioutil.NopCloser(io.TeeReader(layerDownload, verifier)), + Out: di.broadcaster, + Formatter: p.sf, + Size: di.size, + NewLines: false, + ID: stringid.TruncateID(di.img.id), + Action: "Downloading", + }) + io.Copy(di.tmpFile, reader) + + di.broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(di.img.id), "Verifying Checksum", nil)) + + if !verifier.Verified() { + err = fmt.Errorf("filesystem layer verification failed for digest %s", di.digest) + logrus.Error(err) + di.err <- err + return + } + + di.broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(di.img.id), "Download complete", nil)) + + logrus.Debugf("Downloaded %s to tempfile %s", di.img.id, di.tmpFile.Name()) + di.layer = layerDownload + + di.err <- nil +} + +func (p *v2Puller) pullV2Tag(out io.Writer, tag, taggedName string) (tagUpdated bool, err error) { + logrus.Debugf("Pulling tag from V2 registry: %q", tag) + + manSvc, err := p.repo.Manifests(context.Background()) + if err != nil { + return false, err + } + + unverifiedManifest, err := manSvc.GetByTag(tag) + if err != nil { + return false, err + } + if unverifiedManifest == nil { + return false, fmt.Errorf("image manifest does not exist for tag %q", tag) + } + var verifiedManifest *manifest.Manifest + verifiedManifest, err = verifyManifest(unverifiedManifest, tag) + if err != nil { + return false, err + } + + // remove duplicate layers and check parent chain validity + err = fixManifestLayers(verifiedManifest) + if err != nil { + return false, err + } + + imgs, err := p.getImageInfos(verifiedManifest) + if err != nil { + return false, err + } + + out.Write(p.sf.FormatStatus(tag, "Pulling from %s", p.repo.Name())) + + var downloads []*downloadInfo + + var layerIDs []string + defer func() { + p.graph.Release(p.sessionID, layerIDs...) + + for _, d := range downloads { + p.poolRemoveWithError("pull", d.poolKey, err) + if d.tmpFile != nil { + d.tmpFile.Close() + if err := os.RemoveAll(d.tmpFile.Name()); err != nil { + logrus.Errorf("Failed to remove temp file: %s", d.tmpFile.Name()) + } + } + } + }() + + for i := len(verifiedManifest.FSLayers) - 1; i >= 0; i-- { + img := imgs[i] + + p.graph.Retain(p.sessionID, img.id) + layerIDs = append(layerIDs, img.id) + + p.graph.imageMutex.Lock(img.id) + + // Check if exists + if p.graph.Exists(img.id) { + if err := p.validateImageInGraph(img.id, imgs, i); err != nil { + p.graph.imageMutex.Unlock(img.id) + return false, fmt.Errorf("image validation failed: %v", err) + } + logrus.Debugf("Image already exists: %s", img.id) + p.graph.imageMutex.Unlock(img.id) + continue + } + p.graph.imageMutex.Unlock(img.id) + + out.Write(p.sf.FormatProgress(stringid.TruncateID(img.id), "Pulling fs layer", nil)) + + d := &downloadInfo{ + img: img, + imgIndex: i, + poolKey: "v2layer:" + img.id, + digest: verifiedManifest.FSLayers[i].BlobSum, + // TODO: seems like this chan buffer solved hanging problem in go1.5, + // this can indicate some deeper problem that somehow we never take + // error from channel in loop below + err: make(chan error, 1), + } + + tmpFile, err := ioutil.TempFile("", "GetImageBlob") + if err != nil { + return false, err + } + d.tmpFile = tmpFile + + downloads = append(downloads, d) + + broadcaster, found := p.poolAdd("pull", d.poolKey) + broadcaster.Add(out) + d.broadcaster = broadcaster + if found { + d.err <- nil + } else { + go p.download(d) + } + } + + for _, d := range downloads { + if err := <-d.err; err != nil { + return false, err + } + + if d.layer == nil { + // Wait for a different pull to download and extract + // this layer. + err = d.broadcaster.Wait() + if err != nil { + return false, err + } + continue + } + + d.tmpFile.Seek(0, 0) + err := func() error { + reader := progressreader.New(progressreader.Config{ + In: d.tmpFile, + Out: d.broadcaster, + Formatter: p.sf, + Size: d.size, + NewLines: false, + ID: stringid.TruncateID(d.img.id), + Action: "Extracting", + }) + + p.graph.imagesMutex.Lock() + defer p.graph.imagesMutex.Unlock() + + p.graph.imageMutex.Lock(d.img.id) + defer p.graph.imageMutex.Unlock(d.img.id) + + // Must recheck the data on disk if any exists. + // This protects against races where something + // else is written to the graph under this ID + // after attemptIDReuse. + if p.graph.Exists(d.img.id) { + if err := p.validateImageInGraph(d.img.id, imgs, d.imgIndex); err != nil { + return fmt.Errorf("image validation failed: %v", err) + } + } + + if err := p.graph.register(d.img, reader); err != nil { + return err + } + + if err := p.graph.setLayerDigest(d.img.id, d.digest); err != nil { + return err + } + + if err := p.graph.setV1CompatibilityConfig(d.img.id, d.img.v1Compatibility); err != nil { + return err + } + + return nil + }() + if err != nil { + return false, err + } + + d.broadcaster.Write(p.sf.FormatProgress(stringid.TruncateID(d.img.id), "Pull complete", nil)) + d.broadcaster.Close() + tagUpdated = true + } + + manifestDigest, _, err := digestFromManifest(unverifiedManifest, p.repoInfo.LocalName) + if err != nil { + return false, err + } + + // Check for new tag if no layers downloaded + if !tagUpdated { + repo, err := p.Get(p.repoInfo.LocalName) + if err != nil { + return false, err + } + if repo != nil { + if _, exists := repo[tag]; !exists { + tagUpdated = true + } + } else { + tagUpdated = true + } + } + + firstID := layerIDs[len(layerIDs)-1] + if utils.DigestReference(tag) { + // TODO(stevvooe): Ideally, we should always set the digest so we can + // use the digest whether we pull by it or not. Unfortunately, the tag + // store treats the digest as a separate tag, meaning there may be an + // untagged digest image that would seem to be dangling by a user. + if err = p.SetDigest(p.repoInfo.LocalName, tag, firstID); err != nil { + return false, err + } + } else { + // only set the repository/tag -> image ID mapping when pulling by tag (i.e. not by digest) + if err = p.Tag(p.repoInfo.LocalName, tag, firstID, true); err != nil { + return false, err + } + } + + if manifestDigest != "" { + out.Write(p.sf.FormatStatus("", "Digest: %s", manifestDigest)) + } + + return tagUpdated, nil +} + +func verifyManifest(signedManifest *manifest.SignedManifest, tag string) (m *manifest.Manifest, err error) { + // If pull by digest, then verify the manifest digest. NOTE: It is + // important to do this first, before any other content validation. If the + // digest cannot be verified, don't even bother with those other things. + if manifestDigest, err := digest.ParseDigest(tag); err == nil { + verifier, err := digest.NewDigestVerifier(manifestDigest) + if err != nil { + return nil, err + } + payload, err := signedManifest.Payload() + if err != nil { + // If this failed, the signatures section was corrupted + // or missing. Treat the entire manifest as the payload. + payload = signedManifest.Raw + } + if _, err := verifier.Write(payload); err != nil { + return nil, err + } + if !verifier.Verified() { + err := fmt.Errorf("image verification failed for digest %s", manifestDigest) + logrus.Error(err) + return nil, err + } + + var verifiedManifest manifest.Manifest + if err = json.Unmarshal(payload, &verifiedManifest); err != nil { + return nil, err + } + m = &verifiedManifest + } else { + m = &signedManifest.Manifest + } + + if m.SchemaVersion != 1 { + return nil, fmt.Errorf("unsupported schema version %d for tag %q", m.SchemaVersion, tag) + } + if len(m.FSLayers) != len(m.History) { + return nil, fmt.Errorf("length of history not equal to number of layers for tag %q", tag) + } + if len(m.FSLayers) == 0 { + return nil, fmt.Errorf("no FSLayers in manifest for tag %q", tag) + } + return m, nil +} + +// fixManifestLayers removes repeated layers from the manifest and checks the +// correctness of the parent chain. +func fixManifestLayers(m *manifest.Manifest) error { + images := make([]*image.Image, len(m.FSLayers)) + for i := range m.FSLayers { + img, err := image.NewImgJSON([]byte(m.History[i].V1Compatibility)) + if err != nil { + return err + } + images[i] = img + if err := image.ValidateID(img.ID); err != nil { + return err + } + } + + if images[len(images)-1].Parent != "" { + return errors.New("Invalid parent ID in the base layer of the image.") + } + + // check general duplicates to error instead of a deadlock + idmap := make(map[string]struct{}) + + var lastID string + for _, img := range images { + // skip IDs that appear after each other, we handle those later + if _, exists := idmap[img.ID]; img.ID != lastID && exists { + return fmt.Errorf("ID %+v appears multiple times in manifest", img.ID) + } + lastID = img.ID + idmap[lastID] = struct{}{} + } + + // backwards loop so that we keep the remaining indexes after removing items + for i := len(images) - 2; i >= 0; i-- { + if images[i].ID == images[i+1].ID { // repeated ID. remove and continue + m.FSLayers = append(m.FSLayers[:i], m.FSLayers[i+1:]...) + m.History = append(m.History[:i], m.History[i+1:]...) + } else if images[i].Parent != images[i+1].ID { + return fmt.Errorf("Invalid parent ID. Expected %v, got %v.", images[i+1].ID, images[i].Parent) + } + } + + return nil +} + +// getImageInfos returns an imageinfo struct for every image in the manifest. +// These objects contain both calculated strongIDs and compatibilityIDs found +// in v1Compatibility object. +func (p *v2Puller) getImageInfos(m *manifest.Manifest) ([]contentAddressableDescriptor, error) { + imgs := make([]contentAddressableDescriptor, len(m.FSLayers)) + + var parent digest.Digest + for i := len(imgs) - 1; i >= 0; i-- { + var err error + imgs[i], err = newContentAddressableImage([]byte(m.History[i].V1Compatibility), m.FSLayers[i].BlobSum, parent) + if err != nil { + return nil, err + } + parent = imgs[i].strongID + } + + p.attemptIDReuse(imgs) + + return imgs, nil +} + +// attemptIDReuse does a best attempt to match verified compatibilityIDs +// already in the graph with the computed strongIDs so we can keep using them. +// This process will never fail but may just return the strongIDs if none of +// the compatibilityIDs exists or can be verified. If the strongIDs themselves +// fail verification, we deterministically generate alternate IDs to use until +// we find one that's available or already exists with the correct data. +func (p *v2Puller) attemptIDReuse(imgs []contentAddressableDescriptor) { + // This function needs to be protected with a global lock, because it + // locks multiple IDs at once, and there's no good way to make sure + // the locking happens a deterministic order. + p.graph.imagesMutex.Lock() + defer p.graph.imagesMutex.Unlock() + + idMap := make(map[string]struct{}) + for _, img := range imgs { + idMap[img.id] = struct{}{} + idMap[img.compatibilityID] = struct{}{} + + if p.graph.Exists(img.compatibilityID) { + if _, err := p.graph.GenerateV1CompatibilityChain(img.compatibilityID); err != nil { + logrus.Debugf("Migration v1Compatibility generation error: %v", err) + return + } + } + } + for id := range idMap { + p.graph.imageMutex.Lock(id) + defer p.graph.imageMutex.Unlock(id) + } + + // continueReuse controls whether the function will try to find + // existing layers on disk under the old v1 IDs, to avoid repulling + // them. The hashes are checked to ensure these layers are okay to + // use. continueReuse starts out as true, but is set to false if + // the code encounters something that doesn't match the expected hash. + continueReuse := true + + for i := len(imgs) - 1; i >= 0; i-- { + if p.graph.Exists(imgs[i].id) { + // Found an image in the graph under the strongID. Validate the + // image before using it. + if err := p.validateImageInGraph(imgs[i].id, imgs, i); err != nil { + continueReuse = false + logrus.Debugf("not using existing strongID: %v", err) + + // The strong ID existed in the graph but didn't + // validate successfully. We can't use the strong ID + // because it didn't validate successfully. Treat the + // graph like a hash table with probing... compute + // SHA256(id) until we find an ID that either doesn't + // already exist in the graph, or has existing content + // that validates successfully. + for { + if err := p.tryNextID(imgs, i, idMap); err != nil { + logrus.Debug(err.Error()) + } else { + break + } + } + } + continue + } + + if continueReuse { + compatibilityID := imgs[i].compatibilityID + if err := p.validateImageInGraph(compatibilityID, imgs, i); err != nil { + logrus.Debugf("stopping ID reuse: %v", err) + continueReuse = false + } else { + // The compatibility ID exists in the graph and was + // validated. Use it. + imgs[i].id = compatibilityID + } + } + } + + // fix up the parents of the images + for i := 0; i < len(imgs); i++ { + if i == len(imgs)-1 { // Base layer + imgs[i].parent = "" + } else { + imgs[i].parent = imgs[i+1].id + } + } +} + +// validateImageInGraph checks that an image in the graph has the expected +// strongID. id is the entry in the graph to check, imgs is the slice of +// images being processed (for access to the parent), and i is the index +// into this slice which the graph entry should be checked against. +func (p *v2Puller) validateImageInGraph(id string, imgs []contentAddressableDescriptor, i int) error { + img, err := p.graph.Get(id) + if err != nil { + return fmt.Errorf("missing: %v", err) + } + layerID, err := p.graph.getLayerDigest(id) + if err != nil { + return fmt.Errorf("digest: %v", err) + } + var parentID digest.Digest + if i != len(imgs)-1 { + if img.Parent != imgs[i+1].id { // comparing that graph points to validated ID + return fmt.Errorf("parent: %v %v", img.Parent, imgs[i+1].id) + } + parentID = imgs[i+1].strongID + } else if img.Parent != "" { + return fmt.Errorf("unexpected parent: %v", img.Parent) + } + + v1Config, err := p.graph.getV1CompatibilityConfig(img.ID) + if err != nil { + return fmt.Errorf("v1Compatibility: %v %v", img.ID, err) + } + + json, err := image.MakeImageConfig(v1Config, layerID, parentID) + if err != nil { + return fmt.Errorf("make config: %v", err) + } + + if dgst, err := image.StrongID(json); err == nil && dgst == imgs[i].strongID { + logrus.Debugf("Validated %v as %v", dgst, id) + } else { + return fmt.Errorf("digest mismatch: %v %v, error: %v", dgst, imgs[i].strongID, err) + } + + // All clear + return nil +} + +func (p *v2Puller) tryNextID(imgs []contentAddressableDescriptor, i int, idMap map[string]struct{}) error { + nextID, _ := digest.FromBytes([]byte(imgs[i].id)) + imgs[i].id = nextID.Hex() + + if _, exists := idMap[imgs[i].id]; !exists { + p.graph.imageMutex.Lock(imgs[i].id) + defer p.graph.imageMutex.Unlock(imgs[i].id) + } + + if p.graph.Exists(imgs[i].id) { + if err := p.validateImageInGraph(imgs[i].id, imgs, i); err != nil { + return fmt.Errorf("not using existing strongID permutation %s: %v", imgs[i].id, err) + } + } + return nil +} diff --git a/graph/pull_v2_test.go b/graph/pull_v2_test.go new file mode 100644 index 0000000000..3cad93fe88 --- /dev/null +++ b/graph/pull_v2_test.go @@ -0,0 +1,194 @@ +package graph + +import ( + "encoding/json" + "io/ioutil" + "reflect" + "strings" + "testing" + + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" +) + +// TestFixManifestLayers checks that fixManifestLayers removes a duplicate +// layer, and that it makes no changes to the manifest when called a second +// time, after the duplicate is removed. +func TestFixManifestLayers(t *testing.T) { + duplicateLayerManifest := manifest.Manifest{ + FSLayers: []manifest.FSLayer{ + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:86e0e091d0da6bde2456dbb48306f3956bbeb2eae1b5b9a43045843f69fe4aaa")}, + }, + History: []manifest.History{ + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:07.568027497Z\",\"container\":\"fe9e5a5264a843c9292d17b736c92dd19bdb49986a8782d7389964ddaff887cc\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"cd /go/src/github.com/tonistiigi/dnsdock \\u0026\\u0026 go get -v github.com/tools/godep \\u0026\\u0026 godep restore \\u0026\\u0026 go install -ldflags \\\"-X main.version `git describe --tags HEAD``if [[ -n $(command git status --porcelain --untracked-files=no 2\\u003e/dev/null) ]]; then echo \\\"-dirty\\\"; fi`\\\" ./...\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/bash\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":118430532}\n"}, + }, + } + + duplicateLayerManifestExpectedOutput := manifest.Manifest{ + FSLayers: []manifest.FSLayer{ + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:86e0e091d0da6bde2456dbb48306f3956bbeb2eae1b5b9a43045843f69fe4aaa")}, + }, + History: []manifest.History{ + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:07.568027497Z\",\"container\":\"fe9e5a5264a843c9292d17b736c92dd19bdb49986a8782d7389964ddaff887cc\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"cd /go/src/github.com/tonistiigi/dnsdock \\u0026\\u0026 go get -v github.com/tools/godep \\u0026\\u0026 godep restore \\u0026\\u0026 go install -ldflags \\\"-X main.version `git describe --tags HEAD``if [[ -n $(command git status --porcelain --untracked-files=no 2\\u003e/dev/null) ]]; then echo \\\"-dirty\\\"; fi`\\\" ./...\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/bash\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":118430532}\n"}, + }, + } + + if err := fixManifestLayers(&duplicateLayerManifest); err != nil { + t.Fatalf("unexpected error from fixManifestLayers: %v", err) + } + + if !reflect.DeepEqual(duplicateLayerManifest, duplicateLayerManifestExpectedOutput) { + t.Fatal("incorrect output from fixManifestLayers on duplicate layer manifest") + } + + // Run fixManifestLayers again and confirm that it doesn't change the + // manifest (which no longer has duplicate layers). + if err := fixManifestLayers(&duplicateLayerManifest); err != nil { + t.Fatalf("unexpected error from fixManifestLayers: %v", err) + } + + if !reflect.DeepEqual(duplicateLayerManifest, duplicateLayerManifestExpectedOutput) { + t.Fatal("incorrect output from fixManifestLayers on duplicate layer manifest (second pass)") + } +} + +// TestFixManifestLayersBaseLayerParent makes sure that fixManifestLayers fails +// if the base layer configuration specifies a parent. +func TestFixManifestLayersBaseLayerParent(t *testing.T) { + duplicateLayerManifest := manifest.Manifest{ + FSLayers: []manifest.FSLayer{ + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:86e0e091d0da6bde2456dbb48306f3956bbeb2eae1b5b9a43045843f69fe4aaa")}, + }, + History: []manifest.History{ + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"parent\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"created\":\"2015-08-19T16:49:07.568027497Z\",\"container\":\"fe9e5a5264a843c9292d17b736c92dd19bdb49986a8782d7389964ddaff887cc\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"cd /go/src/github.com/tonistiigi/dnsdock \\u0026\\u0026 go get -v github.com/tools/godep \\u0026\\u0026 godep restore \\u0026\\u0026 go install -ldflags \\\"-X main.version `git describe --tags HEAD``if [[ -n $(command git status --porcelain --untracked-files=no 2\\u003e/dev/null) ]]; then echo \\\"-dirty\\\"; fi`\\\" ./...\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/bash\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":118430532}\n"}, + }, + } + + if err := fixManifestLayers(&duplicateLayerManifest); err == nil || !strings.Contains(err.Error(), "Invalid parent ID in the base layer of the image.") { + t.Fatalf("expected an invalid parent ID error from fixManifestLayers") + } +} + +// TestFixManifestLayersBadParent makes sure that fixManifestLayers fails +// if an image configuration specifies a parent that doesn't directly follow +// that (deduplicated) image in the image history. +func TestFixManifestLayersBadParent(t *testing.T) { + duplicateLayerManifest := manifest.Manifest{ + FSLayers: []manifest.FSLayer{ + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4")}, + {BlobSum: digest.Digest("sha256:86e0e091d0da6bde2456dbb48306f3956bbeb2eae1b5b9a43045843f69fe4aaa")}, + }, + History: []manifest.History{ + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ac3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"3b38edc92eb7c074812e217b41a6ade66888531009d6286a6f5f36a06f9841b9\",\"parent\":\"ac3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:11.368300679Z\",\"container\":\"d91be3479d5b1e84b0c00d18eea9dc777ca0ad166d51174b24283e2e6f104253\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"#(nop) ENTRYPOINT [\\\"/go/bin/dnsdock\\\"]\"],\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":null,\"Image\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":[\"/go/bin/dnsdock\"],\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":0}\n"}, + {V1Compatibility: "{\"id\":\"ec3025ca8cc9bcab039e193e20ec647c2da3c53a74020f2ba611601f9b2c6c02\",\"created\":\"2015-08-19T16:49:07.568027497Z\",\"container\":\"fe9e5a5264a843c9292d17b736c92dd19bdb49986a8782d7389964ddaff887cc\",\"container_config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/sh\",\"-c\",\"cd /go/src/github.com/tonistiigi/dnsdock \\u0026\\u0026 go get -v github.com/tools/godep \\u0026\\u0026 godep restore \\u0026\\u0026 go install -ldflags \\\"-X main.version `git describe --tags HEAD``if [[ -n $(command git status --porcelain --untracked-files=no 2\\u003e/dev/null) ]]; then echo \\\"-dirty\\\"; fi`\\\" ./...\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"docker_version\":\"1.6.2\",\"config\":{\"Hostname\":\"03797203757d\",\"Domainname\":\"\",\"User\":\"\",\"Memory\":0,\"MemorySwap\":0,\"CpuShares\":0,\"Cpuset\":\"\",\"AttachStdin\":false,\"AttachStdout\":false,\"AttachStderr\":false,\"PortSpecs\":null,\"ExposedPorts\":null,\"Tty\":false,\"OpenStdin\":false,\"StdinOnce\":false,\"Env\":[\"PATH=/go/bin:/usr/src/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\"GOLANG_VERSION=1.4.1\",\"GOPATH=/go\"],\"Cmd\":[\"/bin/bash\"],\"Image\":\"e3b0ff09e647595dafee15c54cd632c900df9e82b1d4d313b1e20639a1461779\",\"Volumes\":null,\"WorkingDir\":\"/go\",\"Entrypoint\":null,\"NetworkDisabled\":false,\"MacAddress\":\"\",\"OnBuild\":[],\"Labels\":{}},\"architecture\":\"amd64\",\"os\":\"linux\",\"Size\":118430532}\n"}, + }, + } + + if err := fixManifestLayers(&duplicateLayerManifest); err == nil || !strings.Contains(err.Error(), "Invalid parent ID.") { + t.Fatalf("expected an invalid parent ID error from fixManifestLayers") + } +} + +// TestValidateManifest verifies the validateManifest function +func TestValidateManifest(t *testing.T) { + expectedDigest := "sha256:02fee8c3220ba806531f606525eceb83f4feb654f62b207191b1c9209188dedd" + expectedFSLayer0 := digest.Digest("sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4") + + // Good manifest + + goodManifestBytes, err := ioutil.ReadFile("fixtures/validate_manifest/good_manifest") + if err != nil { + t.Fatal("error reading fixture:", err) + } + + var goodSignedManifest manifest.SignedManifest + err = json.Unmarshal(goodManifestBytes, &goodSignedManifest) + if err != nil { + t.Fatal("error unmarshaling manifest:", err) + } + + verifiedManifest, err := verifyManifest(&goodSignedManifest, expectedDigest) + if err != nil { + t.Fatal("validateManifest failed:", err) + } + + if verifiedManifest.FSLayers[0].BlobSum != expectedFSLayer0 { + t.Fatal("unexpected FSLayer in good manifest") + } + + // "Extra data" manifest + + extraDataManifestBytes, err := ioutil.ReadFile("fixtures/validate_manifest/extra_data_manifest") + if err != nil { + t.Fatal("error reading fixture:", err) + } + + var extraDataSignedManifest manifest.SignedManifest + err = json.Unmarshal(extraDataManifestBytes, &extraDataSignedManifest) + if err != nil { + t.Fatal("error unmarshaling manifest:", err) + } + + verifiedManifest, err = verifyManifest(&extraDataSignedManifest, expectedDigest) + if err != nil { + t.Fatal("validateManifest failed:", err) + } + + if verifiedManifest.FSLayers[0].BlobSum != expectedFSLayer0 { + t.Fatal("unexpected FSLayer in extra data manifest") + } + + // Bad manifest + + badManifestBytes, err := ioutil.ReadFile("fixtures/validate_manifest/bad_manifest") + if err != nil { + t.Fatal("error reading fixture:", err) + } + + var badSignedManifest manifest.SignedManifest + err = json.Unmarshal(badManifestBytes, &badSignedManifest) + if err != nil { + t.Fatal("error unmarshaling manifest:", err) + } + + verifiedManifest, err = verifyManifest(&badSignedManifest, expectedDigest) + if err == nil || !strings.HasPrefix(err.Error(), "image verification failed for digest") { + t.Fatal("expected validateManifest to fail with digest error") + } + + // Manifest with no signature + + expectedWholeFileDigest := "7ec3615a120efcdfc270e9c7ea4183330775a3e52a09e2efb194b9a7c18e5ff7" + + noSignatureManifestBytes, err := ioutil.ReadFile("fixtures/validate_manifest/no_signature_manifest") + if err != nil { + t.Fatal("error reading fixture:", err) + } + + var noSignatureSignedManifest manifest.SignedManifest + err = json.Unmarshal(noSignatureManifestBytes, &noSignatureSignedManifest) + if err != nil { + t.Fatal("error unmarshaling manifest:", err) + } + + verifiedManifest, err = verifyManifest(&noSignatureSignedManifest, expectedWholeFileDigest) + if err != nil { + t.Fatal("validateManifest failed:", err) + } + + if verifiedManifest.FSLayers[0].BlobSum != expectedFSLayer0 { + t.Fatal("unexpected FSLayer in no-signature manifest") + } +} diff --git a/graph/push.go b/graph/push.go new file mode 100644 index 0000000000..909fcc02f4 --- /dev/null +++ b/graph/push.go @@ -0,0 +1,150 @@ +package graph + +import ( + "fmt" + "io" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/digest" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/registry" +) + +// ImagePushConfig stores push configuration. +type ImagePushConfig struct { + // MetaHeaders store HTTP headers with metadata about the image + // (DockerHeaders with prefix X-Meta- in the request). + MetaHeaders map[string][]string + // AuthConfig holds authentication credentials for authenticating with + // the registry. + AuthConfig *cliconfig.AuthConfig + // Tag is the specific variant of the image to be pushed. + // If no tag is provided, all tags will be pushed. + Tag string + // OutStream is the output writer for showing the status of the push + // operation. + OutStream io.Writer +} + +// Pusher is an interface that abstracts pushing for different API versions. +type Pusher interface { + // Push tries to push the image configured at the creation of Pusher. + // Push returns an error if any, as well as a boolean that determines whether to retry Push on the next configured endpoint. + // + // TODO(tiborvass): have Push() take a reference to repository + tag, so that the pusher itself is repository-agnostic. + Push() (fallback bool, err error) +} + +// NewPusher creates a new Pusher interface that will push to either a v1 or v2 +// registry. The endpoint argument contains a Version field that determines +// whether a v1 or v2 pusher will be created. The other parameters are passed +// through to the underlying pusher implementation for use during the actual +// push operation. +func (s *TagStore) NewPusher(endpoint registry.APIEndpoint, localRepo Repository, repoInfo *registry.RepositoryInfo, imagePushConfig *ImagePushConfig, sf *streamformatter.StreamFormatter) (Pusher, error) { + switch endpoint.Version { + case registry.APIVersion2: + return &v2Pusher{ + TagStore: s, + endpoint: endpoint, + localRepo: localRepo, + repoInfo: repoInfo, + config: imagePushConfig, + sf: sf, + layersPushed: make(map[digest.Digest]bool), + }, nil + case registry.APIVersion1: + return &v1Pusher{ + TagStore: s, + endpoint: endpoint, + localRepo: localRepo, + repoInfo: repoInfo, + config: imagePushConfig, + sf: sf, + }, nil + } + return nil, fmt.Errorf("unknown version %d for registry %s", endpoint.Version, endpoint.URL) +} + +// Push initiates a push operation on the repository named localName. +func (s *TagStore) Push(localName string, imagePushConfig *ImagePushConfig) error { + // FIXME: Allow to interrupt current push when new push of same image is done. + + var sf = streamformatter.NewJSONStreamFormatter() + + // Resolve the Repository name from fqn to RepositoryInfo + repoInfo, err := s.registryService.ResolveRepository(localName) + if err != nil { + return err + } + + endpoints, err := s.registryService.LookupPushEndpoints(repoInfo.CanonicalName) + if err != nil { + return err + } + + reposLen := 1 + if imagePushConfig.Tag == "" { + reposLen = len(s.Repositories[repoInfo.LocalName]) + } + + imagePushConfig.OutStream.Write(sf.FormatStatus("", "The push refers to a repository [%s] (len: %d)", repoInfo.CanonicalName, reposLen)) + + // If it fails, try to get the repository + localRepo, exists := s.Repositories[repoInfo.LocalName] + if !exists { + return fmt.Errorf("Repository does not exist: %s", repoInfo.LocalName) + } + + var lastErr error + for _, endpoint := range endpoints { + logrus.Debugf("Trying to push %s to %s %s", repoInfo.CanonicalName, endpoint.URL, endpoint.Version) + + pusher, err := s.NewPusher(endpoint, localRepo, repoInfo, imagePushConfig, sf) + if err != nil { + lastErr = err + continue + } + if fallback, err := pusher.Push(); err != nil { + if fallback { + lastErr = err + continue + } + logrus.Debugf("Not continuing with error: %v", err) + return err + + } + + s.eventsService.Log("push", repoInfo.LocalName, "") + return nil + } + + if lastErr == nil { + lastErr = fmt.Errorf("no endpoints found for %s", repoInfo.CanonicalName) + } + return lastErr +} + +// getV1ID returns the compatibilityID for the ID in the graph. compatibilityID +// is read from from the v1Compatibility config file in the disk. +func (s *TagStore) getV1ID(id string) (string, error) { + jsonData, err := s.getV1Config(id) + if err != nil { + return "", err + } + img, err := image.NewImgJSON(jsonData) + if err != nil { + return "", err + } + return img.ID, nil +} + +// getV1Config returns v1Compatibility config for the image in the graph. If +// there is no v1Compatibility file on disk for the image +func (s *TagStore) getV1Config(id string) ([]byte, error) { + jsonData, err := s.graph.GenerateV1CompatibilityChain(id) + if err != nil { + return nil, err + } + return jsonData, nil +} diff --git a/graph/push_v1.go b/graph/push_v1.go new file mode 100644 index 0000000000..0f3e1593a5 --- /dev/null +++ b/graph/push_v1.go @@ -0,0 +1,354 @@ +package graph + +import ( + "fmt" + "io" + "os" + "sync" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/ioutils" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" +) + +type v1Pusher struct { + *TagStore + endpoint registry.APIEndpoint + localRepo Repository + repoInfo *registry.RepositoryInfo + config *ImagePushConfig + sf *streamformatter.StreamFormatter + session *registry.Session + + out io.Writer +} + +func (p *v1Pusher) Push() (fallback bool, err error) { + tlsConfig, err := p.registryService.TLSConfig(p.repoInfo.Index.Name) + if err != nil { + return false, err + } + // Adds Docker-specific headers as well as user-specified headers (metaHeaders) + tr := transport.NewTransport( + // TODO(tiborvass): was NoTimeout + registry.NewTransport(tlsConfig), + registry.DockerHeaders(p.config.MetaHeaders)..., + ) + client := registry.HTTPClient(tr) + v1Endpoint, err := p.endpoint.ToV1Endpoint(p.config.MetaHeaders) + if err != nil { + logrus.Debugf("Could not get v1 endpoint: %v", err) + return true, err + } + p.session, err = registry.NewSession(client, p.config.AuthConfig, v1Endpoint) + if err != nil { + // TODO(dmcgowan): Check if should fallback + return true, err + } + if err := p.pushRepository(p.config.Tag); err != nil { + // TODO(dmcgowan): Check if should fallback + return false, err + } + return false, nil +} + +// Retrieve the all the images to be uploaded in the correct order +func (p *v1Pusher) getImageList(requestedTag string) ([]string, map[string][]string, error) { + var ( + imageList []string + imagesSeen = make(map[string]bool) + tagsByImage = make(map[string][]string) + ) + + for tag, id := range p.localRepo { + if requestedTag != "" && requestedTag != tag { + // Include only the requested tag. + continue + } + + if utils.DigestReference(tag) { + // Ignore digest references. + continue + } + + var imageListForThisTag []string + + tagsByImage[id] = append(tagsByImage[id], tag) + + for img, err := p.graph.Get(id); img != nil; img, err = p.graph.GetParent(img) { + if err != nil { + return nil, nil, err + } + + if imagesSeen[img.ID] { + // This image is already on the list, we can ignore it and all its parents + break + } + + imagesSeen[img.ID] = true + imageListForThisTag = append(imageListForThisTag, img.ID) + } + + // reverse the image list for this tag (so the "most"-parent image is first) + for i, j := 0, len(imageListForThisTag)-1; i < j; i, j = i+1, j-1 { + imageListForThisTag[i], imageListForThisTag[j] = imageListForThisTag[j], imageListForThisTag[i] + } + + // append to main image list + imageList = append(imageList, imageListForThisTag...) + } + if len(imageList) == 0 { + return nil, nil, fmt.Errorf("No images found for the requested repository / tag") + } + logrus.Debugf("Image list: %v", imageList) + logrus.Debugf("Tags by image: %v", tagsByImage) + + return imageList, tagsByImage, nil +} + +// createImageIndex returns an index of an image's layer IDs and tags. +func (s *TagStore) createImageIndex(images []string, tags map[string][]string) []*registry.ImgData { + var imageIndex []*registry.ImgData + for _, id := range images { + if tags, hasTags := tags[id]; hasTags { + // If an image has tags you must add an entry in the image index + // for each tag + for _, tag := range tags { + imageIndex = append(imageIndex, ®istry.ImgData{ + ID: id, + Tag: tag, + }) + } + continue + } + // If the image does not have a tag it still needs to be sent to the + // registry with an empty tag so that it is associated with the repository + imageIndex = append(imageIndex, ®istry.ImgData{ + ID: id, + Tag: "", + }) + } + return imageIndex +} + +type imagePushData struct { + id string + compatibilityID string + endpoint string +} + +// lookupImageOnEndpoint checks the specified endpoint to see if an image exists +// and if it is absent then it sends the image id to the channel to be pushed. +func (p *v1Pusher) lookupImageOnEndpoint(wg *sync.WaitGroup, images chan imagePushData, imagesToPush chan string) { + defer wg.Done() + for image := range images { + if err := p.session.LookupRemoteImage(image.compatibilityID, image.endpoint); err != nil { + logrus.Errorf("Error in LookupRemoteImage: %s", err) + imagesToPush <- image.id + continue + } + p.out.Write(p.sf.FormatStatus("", "Image %s already pushed, skipping", stringid.TruncateID(image.id))) + } +} + +func (p *v1Pusher) pushImageToEndpoint(endpoint string, imageIDs []string, tags map[string][]string, repo *registry.RepositoryData) error { + workerCount := len(imageIDs) + // start a maximum of 5 workers to check if images exist on the specified endpoint. + if workerCount > 5 { + workerCount = 5 + } + var ( + wg = &sync.WaitGroup{} + imageData = make(chan imagePushData, workerCount*2) + imagesToPush = make(chan string, workerCount*2) + pushes = make(chan map[string]struct{}, 1) + ) + for i := 0; i < workerCount; i++ { + wg.Add(1) + go p.lookupImageOnEndpoint(wg, imageData, imagesToPush) + } + // start a go routine that consumes the images to push + go func() { + shouldPush := make(map[string]struct{}) + for id := range imagesToPush { + shouldPush[id] = struct{}{} + } + pushes <- shouldPush + }() + for _, id := range imageIDs { + compatibilityID, err := p.getV1ID(id) + if err != nil { + return err + } + imageData <- imagePushData{ + id: id, + compatibilityID: compatibilityID, + endpoint: endpoint, + } + } + // close the channel to notify the workers that there will be no more images to check. + close(imageData) + wg.Wait() + close(imagesToPush) + // wait for all the images that require pushes to be collected into a consumable map. + shouldPush := <-pushes + // finish by pushing any images and tags to the endpoint. The order that the images are pushed + // is very important that is why we are still iterating over the ordered list of imageIDs. + for _, id := range imageIDs { + if _, push := shouldPush[id]; push { + if _, err := p.pushImage(id, endpoint); err != nil { + // FIXME: Continue on error? + return err + } + } + for _, tag := range tags[id] { + p.out.Write(p.sf.FormatStatus("", "Pushing tag for rev [%s] on {%s}", stringid.TruncateID(id), endpoint+"repositories/"+p.repoInfo.RemoteName+"/tags/"+tag)) + compatibilityID, err := p.getV1ID(id) + if err != nil { + return err + } + if err := p.session.PushRegistryTag(p.repoInfo.RemoteName, compatibilityID, tag, endpoint); err != nil { + return err + } + } + } + return nil +} + +// pushRepository pushes layers that do not already exist on the registry. +func (p *v1Pusher) pushRepository(tag string) error { + logrus.Debugf("Local repo: %s", p.localRepo) + p.out = ioutils.NewWriteFlusher(p.config.OutStream) + imgList, tags, err := p.getImageList(tag) + if err != nil { + return err + } + p.out.Write(p.sf.FormatStatus("", "Sending image list")) + + imageIndex := p.createImageIndex(imgList, tags) + logrus.Debugf("Preparing to push %s with the following images and tags", p.localRepo) + for _, data := range imageIndex { + logrus.Debugf("Pushing ID: %s with Tag: %s", data.ID, data.Tag) + + // convert IDs to compatibilityIDs, imageIndex only used in registry calls + data.ID, err = p.getV1ID(data.ID) + if err != nil { + return err + } + } + + if _, found := p.poolAdd("push", p.repoInfo.LocalName); found { + return fmt.Errorf("push or pull %s is already in progress", p.repoInfo.LocalName) + } + defer p.poolRemove("push", p.repoInfo.LocalName) + + // Register all the images in a repository with the registry + // If an image is not in this list it will not be associated with the repository + repoData, err := p.session.PushImageJSONIndex(p.repoInfo.RemoteName, imageIndex, false, nil) + if err != nil { + return err + } + nTag := 1 + if tag == "" { + nTag = len(p.localRepo) + } + p.out.Write(p.sf.FormatStatus("", "Pushing repository %s (%d tags)", p.repoInfo.CanonicalName, nTag)) + // push the repository to each of the endpoints only if it does not exist. + for _, endpoint := range repoData.Endpoints { + if err := p.pushImageToEndpoint(endpoint, imgList, tags, repoData); err != nil { + return err + } + } + _, err = p.session.PushImageJSONIndex(p.repoInfo.RemoteName, imageIndex, true, repoData.Endpoints) + return err +} + +func (p *v1Pusher) pushImage(imgID, ep string) (checksum string, err error) { + jsonRaw, err := p.getV1Config(imgID) + if err != nil { + return "", fmt.Errorf("Cannot retrieve the path for {%s}: %s", imgID, err) + } + p.out.Write(p.sf.FormatProgress(stringid.TruncateID(imgID), "Pushing", nil)) + + compatibilityID, err := p.getV1ID(imgID) + if err != nil { + return "", err + } + + // General rule is to use ID for graph accesses and compatibilityID for + // calls to session.registry() + imgData := ®istry.ImgData{ + ID: compatibilityID, + } + + // Send the json + if err := p.session.PushImageJSONRegistry(imgData, jsonRaw, ep); err != nil { + if err == registry.ErrAlreadyExists { + p.out.Write(p.sf.FormatProgress(stringid.TruncateID(imgID), "Image already pushed, skipping", nil)) + return "", nil + } + return "", err + } + + layerData, err := p.graph.TempLayerArchive(imgID, p.sf, p.out) + if err != nil { + return "", fmt.Errorf("Failed to generate layer archive: %s", err) + } + defer os.RemoveAll(layerData.Name()) + + // Send the layer + logrus.Debugf("rendered layer for %s of [%d] size", imgID, layerData.Size) + + checksum, checksumPayload, err := p.session.PushImageLayerRegistry(imgData.ID, + progressreader.New(progressreader.Config{ + In: layerData, + Out: p.out, + Formatter: p.sf, + Size: layerData.Size, + NewLines: false, + ID: stringid.TruncateID(imgID), + Action: "Pushing", + }), ep, jsonRaw) + if err != nil { + return "", err + } + imgData.Checksum = checksum + imgData.ChecksumPayload = checksumPayload + // Send the checksum + if err := p.session.PushImageChecksumRegistry(imgData, ep); err != nil { + return "", err + } + + p.out.Write(p.sf.FormatProgress(stringid.TruncateID(imgID), "Image successfully pushed", nil)) + return imgData.Checksum, nil +} + +// getV1ID returns the compatibilityID for the ID in the graph. compatibilityID +// is read from from the v1Compatibility config file in the disk. +func (p *v1Pusher) getV1ID(id string) (string, error) { + jsonData, err := p.getV1Config(id) + if err != nil { + return "", err + } + img, err := image.NewImgJSON(jsonData) + if err != nil { + return "", err + } + return img.ID, nil +} + +// getV1Config returns v1Compatibility config for the image in the graph. If +// there is no v1Compatibility file on disk for the image +func (p *v1Pusher) getV1Config(id string) ([]byte, error) { + jsonData, err := p.graph.GenerateV1CompatibilityChain(id) + if err != nil { + return nil, err + } + return jsonData, nil +} diff --git a/graph/push_v2.go b/graph/push_v2.go new file mode 100644 index 0000000000..cf35247882 --- /dev/null +++ b/graph/push_v2.go @@ -0,0 +1,391 @@ +package graph + +import ( + "bufio" + "compress/gzip" + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/progressreader" + "github.com/docker/docker/pkg/streamformatter" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/registry" + "github.com/docker/docker/runconfig" + "github.com/docker/docker/utils" + "golang.org/x/net/context" +) + +const compressionBufSize = 32768 + +type v2Pusher struct { + *TagStore + endpoint registry.APIEndpoint + localRepo Repository + repoInfo *registry.RepositoryInfo + config *ImagePushConfig + sf *streamformatter.StreamFormatter + repo distribution.Repository + + // layersPushed is the set of layers known to exist on the remote side. + // This avoids redundant queries when pushing multiple tags that + // involve the same layers. + layersPushed map[digest.Digest]bool +} + +func (p *v2Pusher) Push() (fallback bool, err error) { + p.repo, err = NewV2Repository(p.repoInfo, p.endpoint, p.config.MetaHeaders, p.config.AuthConfig, "push", "pull") + if err != nil { + logrus.Debugf("Error getting v2 registry: %v", err) + return true, err + } + return false, p.pushV2Repository(p.config.Tag) +} + +func (p *v2Pusher) getImageTags(askedTag string) ([]string, error) { + logrus.Debugf("Checking %q against %#v", askedTag, p.localRepo) + if len(askedTag) > 0 { + if _, ok := p.localRepo[askedTag]; !ok || utils.DigestReference(askedTag) { + return nil, fmt.Errorf("Tag does not exist for %s", askedTag) + } + return []string{askedTag}, nil + } + var tags []string + for tag := range p.localRepo { + if !utils.DigestReference(tag) { + tags = append(tags, tag) + } + } + return tags, nil +} + +func (p *v2Pusher) pushV2Repository(tag string) error { + localName := p.repoInfo.LocalName + if _, found := p.poolAdd("push", localName); found { + return fmt.Errorf("push or pull %s is already in progress", localName) + } + defer p.poolRemove("push", localName) + + tags, err := p.getImageTags(tag) + if err != nil { + return fmt.Errorf("error getting tags for %s: %s", localName, err) + } + if len(tags) == 0 { + return fmt.Errorf("no tags to push for %s", localName) + } + + for _, tag := range tags { + if err := p.pushV2Tag(tag); err != nil { + return err + } + } + + return nil +} + +func (p *v2Pusher) pushV2Tag(tag string) error { + logrus.Debugf("Pushing repository: %s:%s", p.repo.Name(), tag) + + layerID, exists := p.localRepo[tag] + if !exists { + return fmt.Errorf("tag does not exist: %s", tag) + } + + layersSeen := make(map[string]bool) + + layer, err := p.graph.Get(layerID) + if err != nil { + return err + } + + m := &manifest.Manifest{ + Versioned: manifest.Versioned{ + SchemaVersion: 1, + }, + Name: p.repo.Name(), + Tag: tag, + Architecture: layer.Architecture, + FSLayers: []manifest.FSLayer{}, + History: []manifest.History{}, + } + + var metadata runconfig.Config + if layer != nil && layer.Config != nil { + metadata = *layer.Config + } + + out := p.config.OutStream + + for ; layer != nil; layer, err = p.graph.GetParent(layer) { + if err != nil { + return err + } + + // break early if layer has already been seen in this image, + // this prevents infinite loops on layers which loopback, this + // cannot be prevented since layer IDs are not merkle hashes + // TODO(dmcgowan): throw error if no valid use case is found + if layersSeen[layer.ID] { + break + } + + logrus.Debugf("Pushing layer: %s", layer.ID) + + if layer.Config != nil && metadata.Image != layer.ID { + if err := runconfig.Merge(&metadata, layer.Config); err != nil { + return err + } + } + + var exists bool + dgst, err := p.graph.GetLayerDigest(layer.ID) + switch err { + case nil: + if p.layersPushed[dgst] { + exists = true + // break out of switch, it is already known that + // the push is not needed and therefore doing a + // stat is unnecessary + break + } + _, err := p.repo.Blobs(context.Background()).Stat(context.Background(), dgst) + switch err { + case nil: + exists = true + out.Write(p.sf.FormatProgress(stringid.TruncateID(layer.ID), "Image already exists", nil)) + case distribution.ErrBlobUnknown: + // nop + default: + out.Write(p.sf.FormatProgress(stringid.TruncateID(layer.ID), "Image push failed", nil)) + return err + } + case ErrDigestNotSet: + // nop + case digest.ErrDigestInvalidFormat, digest.ErrDigestUnsupported: + return fmt.Errorf("error getting image checksum: %v", err) + } + + // if digest was empty or not saved, or if blob does not exist on the remote repository, + // then fetch it. + if !exists { + var pushDigest digest.Digest + if pushDigest, err = p.pushV2Image(p.repo.Blobs(context.Background()), layer); err != nil { + return err + } + if dgst == "" { + // Cache new checksum + if err := p.graph.SetLayerDigest(layer.ID, pushDigest); err != nil { + return err + } + } + dgst = pushDigest + } + + // read v1Compatibility config, generate new if needed + jsonData, err := p.graph.GenerateV1CompatibilityChain(layer.ID) + if err != nil { + return err + } + + m.FSLayers = append(m.FSLayers, manifest.FSLayer{BlobSum: dgst}) + m.History = append(m.History, manifest.History{V1Compatibility: string(jsonData)}) + + layersSeen[layer.ID] = true + p.layersPushed[dgst] = true + } + + // Fix parent chain if necessary + if err = fixHistory(m); err != nil { + return err + } + + logrus.Infof("Signed manifest for %s:%s using daemon's key: %s", p.repo.Name(), tag, p.trustKey.KeyID()) + signed, err := manifest.Sign(m, p.trustKey) + if err != nil { + return err + } + + manifestDigest, manifestSize, err := digestFromManifest(signed, p.repo.Name()) + if err != nil { + return err + } + if manifestDigest != "" { + out.Write(p.sf.FormatStatus("", "%s: digest: %s size: %d", tag, manifestDigest, manifestSize)) + } + + manSvc, err := p.repo.Manifests(context.Background()) + if err != nil { + return err + } + return manSvc.Put(signed) +} + +// fixHistory makes sure that the manifest has parent IDs that are consistent +// with its image IDs. Because local image IDs are generated from the +// configuration and filesystem contents, but IDs in the manifest are preserved +// from the original pull, it's possible to have inconsistencies where parent +// IDs don't match up with the other IDs in the manifest. This happens in the +// case where an engine pulls images where are identical except the IDs from the +// manifest - the local ID will be the same, and one of the v1Compatibility +// files gets discarded. +func fixHistory(m *manifest.Manifest) error { + var lastID string + + for i := len(m.History) - 1; i >= 0; i-- { + var historyEntry map[string]*json.RawMessage + if err := json.Unmarshal([]byte(m.History[i].V1Compatibility), &historyEntry); err != nil { + return err + } + + idJSON, present := historyEntry["id"] + if !present || idJSON == nil { + return errors.New("missing id key in v1compatibility file") + } + var id string + if err := json.Unmarshal(*idJSON, &id); err != nil { + return err + } + + parentJSON, present := historyEntry["parent"] + + if i == len(m.History)-1 { + // The base layer must not reference a parent layer, + // otherwise the manifest is incomplete. There is an + // exception for Windows to handle base layers. + if present && parentJSON != nil { + var parent string + if err := json.Unmarshal(*parentJSON, &parent); err != nil { + return err + } + if parent != "" { + logrus.Debugf("parent id mismatch detected; fixing. parent reference: %s", parent) + delete(historyEntry, "parent") + fixedHistory, err := json.Marshal(historyEntry) + if err != nil { + return err + } + m.History[i].V1Compatibility = string(fixedHistory) + } + } + } else { + // For all other layers, the parent ID should equal the + // ID of the next item in the history list. If it + // doesn't, fix it up (but preserve all other fields, + // possibly including fields that aren't known to this + // engine version). + if !present || parentJSON == nil { + return errors.New("missing parent key in v1compatibility file") + } + var parent string + if err := json.Unmarshal(*parentJSON, &parent); err != nil { + return err + } + if parent != lastID { + logrus.Debugf("parent id mismatch detected; fixing. parent reference: %s actual id: %s", parent, id) + historyEntry["parent"] = rawJSON(lastID) + fixedHistory, err := json.Marshal(historyEntry) + if err != nil { + return err + } + m.History[i].V1Compatibility = string(fixedHistory) + } + } + lastID = id + } + + return nil +} + +func rawJSON(value interface{}) *json.RawMessage { + jsonval, err := json.Marshal(value) + if err != nil { + return nil + } + return (*json.RawMessage)(&jsonval) +} + +func (p *v2Pusher) pushV2Image(bs distribution.BlobService, img *image.Image) (digest.Digest, error) { + out := p.config.OutStream + + out.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), "Preparing", nil)) + + image, err := p.graph.Get(img.ID) + if err != nil { + return "", err + } + arch, err := p.graph.TarLayer(image) + if err != nil { + return "", err + } + defer arch.Close() + + // Send the layer + layerUpload, err := bs.Create(context.Background()) + if err != nil { + return "", err + } + defer layerUpload.Close() + + reader := progressreader.New(progressreader.Config{ + In: ioutil.NopCloser(arch), // we'll take care of close here. + Out: out, + Formatter: p.sf, + + // TODO(stevvooe): This may cause a size reporting error. Try to get + // this from tar-split or elsewhere. The main issue here is that we + // don't want to buffer to disk *just* to calculate the size. + Size: img.Size, + + NewLines: false, + ID: stringid.TruncateID(img.ID), + Action: "Pushing", + }) + + digester := digest.Canonical.New() + // HACK: The MultiWriter doesn't write directly to layerUpload because + // we must make sure the ReadFrom is used, not Write. Using Write would + // send a PATCH request for every Write call. + pipeReader, pipeWriter := io.Pipe() + // Use a bufio.Writer to avoid excessive chunking in HTTP request. + bufWriter := bufio.NewWriterSize(io.MultiWriter(pipeWriter, digester.Hash()), compressionBufSize) + compressor := gzip.NewWriter(bufWriter) + + go func() { + _, err := io.Copy(compressor, reader) + if err == nil { + err = compressor.Close() + } + if err == nil { + err = bufWriter.Flush() + } + if err != nil { + pipeWriter.CloseWithError(err) + } else { + pipeWriter.Close() + } + }() + + out.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), "Pushing", nil)) + nn, err := layerUpload.ReadFrom(pipeReader) + pipeReader.Close() + if err != nil { + return "", err + } + + dgst := digester.Digest() + if _, err := layerUpload.Commit(context.Background(), distribution.Descriptor{Digest: dgst}); err != nil { + return "", err + } + + logrus.Debugf("uploaded layer %s (%s), %d bytes", img.ID, dgst, nn) + out.Write(p.sf.FormatProgress(stringid.TruncateID(img.ID), "Pushed", nil)) + + return dgst, nil +} diff --git a/graph/registry.go b/graph/registry.go new file mode 100644 index 0000000000..599a807c55 --- /dev/null +++ b/graph/registry.go @@ -0,0 +1,114 @@ +package graph + +import ( + "errors" + "net" + "net/http" + "net/url" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/distribution" + "github.com/docker/distribution/digest" + "github.com/docker/distribution/manifest" + "github.com/docker/distribution/registry/client" + "github.com/docker/distribution/registry/client/auth" + "github.com/docker/distribution/registry/client/transport" + "github.com/docker/docker/cliconfig" + "github.com/docker/docker/registry" + "golang.org/x/net/context" +) + +type dumbCredentialStore struct { + auth *cliconfig.AuthConfig +} + +func (dcs dumbCredentialStore) Basic(*url.URL) (string, string) { + return dcs.auth.Username, dcs.auth.Password +} + +// NewV2Repository returns a repository (v2 only). It creates a HTTP transport +// providing timeout settings and authentication support, and also verifies the +// remote API version. +func NewV2Repository(repoInfo *registry.RepositoryInfo, endpoint registry.APIEndpoint, metaHeaders http.Header, authConfig *cliconfig.AuthConfig, actions ...string) (distribution.Repository, error) { + ctx := context.Background() + + repoName := repoInfo.CanonicalName + // If endpoint does not support CanonicalName, use the RemoteName instead + if endpoint.TrimHostname { + repoName = repoInfo.RemoteName + } + + // TODO(dmcgowan): Call close idle connections when complete, use keep alive + base := &http.Transport{ + Proxy: http.ProxyFromEnvironment, + Dial: (&net.Dialer{ + Timeout: 30 * time.Second, + KeepAlive: 30 * time.Second, + DualStack: true, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, + TLSClientConfig: endpoint.TLSConfig, + // TODO(dmcgowan): Call close idle connections when complete and use keep alive + DisableKeepAlives: true, + } + + modifiers := registry.DockerHeaders(metaHeaders) + authTransport := transport.NewTransport(base, modifiers...) + pingClient := &http.Client{ + Transport: authTransport, + Timeout: 15 * time.Second, + } + endpointStr := endpoint.URL + "/v2/" + req, err := http.NewRequest("GET", endpointStr, nil) + if err != nil { + return nil, err + } + resp, err := pingClient.Do(req) + if err != nil { + return nil, err + } + defer resp.Body.Close() + + versions := auth.APIVersions(resp, endpoint.VersionHeader) + if endpoint.VersionHeader != "" && len(endpoint.Versions) > 0 { + var foundVersion bool + for _, version := range endpoint.Versions { + for _, pingVersion := range versions { + if version == pingVersion { + foundVersion = true + } + } + } + if !foundVersion { + return nil, errors.New("endpoint does not support v2 API") + } + } + + challengeManager := auth.NewSimpleChallengeManager() + if err := challengeManager.AddResponse(resp); err != nil { + return nil, err + } + + creds := dumbCredentialStore{auth: authConfig} + tokenHandler := auth.NewTokenHandler(authTransport, creds, repoName, actions...) + basicHandler := auth.NewBasicHandler(creds) + modifiers = append(modifiers, auth.NewAuthorizer(challengeManager, tokenHandler, basicHandler)) + tr := transport.NewTransport(base, modifiers...) + + return client.NewRepository(ctx, repoName, endpoint.URL, tr) +} + +func digestFromManifest(m *manifest.SignedManifest, localName string) (digest.Digest, int, error) { + payload, err := m.Payload() + if err != nil { + // If this failed, the signatures section was corrupted + // or missing. Treat the entire manifest as the payload. + payload = m.Raw + } + manifestDigest, err := digest.FromBytes(payload) + if err != nil { + logrus.Infof("Could not compute manifest digest for %s:%s : %v", localName, m.Tag, err) + } + return manifestDigest, len(payload), nil +} diff --git a/graph/service.go b/graph/service.go new file mode 100644 index 0000000000..3f83ea999c --- /dev/null +++ b/graph/service.go @@ -0,0 +1,89 @@ +package graph + +import ( + "fmt" + "io" + "runtime" + "time" + + "github.com/Sirupsen/logrus" + "github.com/docker/docker/api/types" + "github.com/docker/docker/utils" +) + +// Lookup looks up an image by name in a TagStore and returns it as an +// ImageInspect structure. +func (s *TagStore) Lookup(name string) (*types.ImageInspect, error) { + image, err := s.LookupImage(name) + if err != nil || image == nil { + return nil, fmt.Errorf("No such image: %s", name) + } + + var repoTags = make([]string, 0) + var repoDigests = make([]string, 0) + + s.Lock() + for repoName, repository := range s.Repositories { + for ref, id := range repository { + if id == image.ID { + imgRef := utils.ImageReference(repoName, ref) + if utils.DigestReference(ref) { + repoDigests = append(repoDigests, imgRef) + } else { + repoTags = append(repoTags, imgRef) + } + } + } + } + s.Unlock() + + imageInspect := &types.ImageInspect{ + ID: image.ID, + RepoTags: repoTags, + RepoDigests: repoDigests, + Parent: image.Parent, + Comment: image.Comment, + Created: image.Created.Format(time.RFC3339Nano), + Container: image.Container, + ContainerConfig: &image.ContainerConfig, + DockerVersion: image.DockerVersion, + Author: image.Author, + Config: image.Config, + Architecture: image.Architecture, + Os: image.OS, + Size: image.Size, + VirtualSize: s.graph.GetParentsSize(image) + image.Size, + } + + imageInspect.GraphDriver.Name = s.graph.driver.String() + + graphDriverData, err := s.graph.driver.GetMetadata(image.ID) + if err != nil { + return nil, err + } + imageInspect.GraphDriver.Data = graphDriverData + return imageInspect, nil +} + +// ImageTarLayer return the tarLayer of the image +func (s *TagStore) ImageTarLayer(name string, dest io.Writer) error { + if image, err := s.LookupImage(name); err == nil && image != nil { + // On Windows, the base layer cannot be exported + if runtime.GOOS != "windows" || image.Parent != "" { + + fs, err := s.graph.TarLayer(image) + if err != nil { + return err + } + defer fs.Close() + + written, err := io.Copy(dest, fs) + if err != nil { + return err + } + logrus.Debugf("rendered layer for %s of [%d] size", image.ID, written) + } + return nil + } + return fmt.Errorf("No such image: %s", name) +} diff --git a/graph/tags.go b/graph/tags.go new file mode 100644 index 0000000000..b212fd93ba --- /dev/null +++ b/graph/tags.go @@ -0,0 +1,498 @@ +package graph + +import ( + "encoding/json" + "errors" + "fmt" + "io" + "io/ioutil" + "os" + "path/filepath" + "sort" + "strings" + "sync" + + "github.com/docker/distribution/digest" + "github.com/docker/docker/daemon/events" + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/image" + "github.com/docker/docker/pkg/broadcaster" + "github.com/docker/docker/pkg/parsers" + "github.com/docker/docker/pkg/stringid" + "github.com/docker/docker/registry" + "github.com/docker/docker/utils" + "github.com/docker/libtrust" +) + +// ErrNameIsNotExist returned when there is no image with requested name. +var ErrNameIsNotExist = errors.New("image with specified name does not exist") + +// TagStore manages repositories. It encompasses the Graph used for versioned +// storage, as well as various services involved in pushing and pulling +// repositories. +type TagStore struct { + path string + graph *Graph + // Repositories is a map of repositories, indexed by name. + Repositories map[string]Repository + trustKey libtrust.PrivateKey + sync.Mutex + // FIXME: move push/pull-related fields + // to a helper type + pullingPool map[string]*broadcaster.Buffered + pushingPool map[string]*broadcaster.Buffered + registryService *registry.Service + eventsService *events.Events +} + +// Repository maps tags to image IDs. +type Repository map[string]string + +// Update updates repository mapping with content of repository 'u'. +func (r Repository) Update(u Repository) { + for k, v := range u { + r[k] = v + } +} + +// Contains returns true if the contents of Repository u are wholly contained +// in Repository r. +func (r Repository) Contains(u Repository) bool { + for k, v := range u { + // if u's key is not present in r OR u's key is present, but not the same value + if rv, ok := r[k]; !ok || (ok && rv != v) { + return false + } + } + return true +} + +// TagStoreConfig provides parameters for a new TagStore. +type TagStoreConfig struct { + // Graph is the versioned image store + Graph *Graph + // Key is the private key to use for signing manifests. + Key libtrust.PrivateKey + // Registry is the registry service to use for TLS configuration and + // endpoint lookup. + Registry *registry.Service + // Events is the events service to use for logging. + Events *events.Events +} + +// NewTagStore creates a new TagStore at specified path, using the parameters +// and services provided in cfg. +func NewTagStore(path string, cfg *TagStoreConfig) (*TagStore, error) { + abspath, err := filepath.Abs(path) + if err != nil { + return nil, err + } + + store := &TagStore{ + path: abspath, + graph: cfg.Graph, + trustKey: cfg.Key, + Repositories: make(map[string]Repository), + pullingPool: make(map[string]*broadcaster.Buffered), + pushingPool: make(map[string]*broadcaster.Buffered), + registryService: cfg.Registry, + eventsService: cfg.Events, + } + // Load the json file if it exists, otherwise create it. + if err := store.reload(); os.IsNotExist(err) { + if err := store.save(); err != nil { + return nil, err + } + } else if err != nil { + return nil, err + } + return store, nil +} + +func (store *TagStore) save() error { + // Store the json ball + jsonData, err := json.Marshal(store) + if err != nil { + return err + } + if err := ioutil.WriteFile(store.path, jsonData, 0600); err != nil { + return err + } + return nil +} + +func (store *TagStore) reload() error { + f, err := os.Open(store.path) + if err != nil { + return err + } + defer f.Close() + if err := json.NewDecoder(f).Decode(&store); err != nil { + return err + } + return nil +} + +// LookupImage returns pointer to an Image struct corresponding to the given +// name. The name can include an optional tag; otherwise the default tag will +// be used. +func (store *TagStore) LookupImage(name string) (*image.Image, error) { + // FIXME: standardize on returning nil when the image doesn't exist, and err for everything else + // (so we can pass all errors here) + repoName, ref := parsers.ParseRepositoryTag(name) + if ref == "" { + ref = tags.DefaultTag + } + var ( + err error + img *image.Image + ) + + img, err = store.GetImage(repoName, ref) + if err != nil { + return nil, err + } + + if img != nil { + return img, nil + } + + // name must be an image ID. + store.Lock() + defer store.Unlock() + if img, err = store.graph.Get(name); err != nil { + return nil, err + } + + return img, nil +} + +// GetID returns ID for image name. +func (store *TagStore) GetID(name string) (string, error) { + repoName, ref := parsers.ParseRepositoryTag(name) + if ref == "" { + ref = tags.DefaultTag + } + store.Lock() + defer store.Unlock() + repoName = registry.NormalizeLocalName(repoName) + repo, ok := store.Repositories[repoName] + if !ok { + return "", ErrNameIsNotExist + } + id, ok := repo[ref] + if !ok { + return "", ErrNameIsNotExist + } + return id, nil +} + +// ByID returns a reverse-lookup table of all the names which refer to each +// image - e.g. {"43b5f19b10584": {"base:latest", "base:v1"}} +func (store *TagStore) ByID() map[string][]string { + store.Lock() + defer store.Unlock() + byID := make(map[string][]string) + for repoName, repository := range store.Repositories { + for tag, id := range repository { + name := utils.ImageReference(repoName, tag) + if _, exists := byID[id]; !exists { + byID[id] = []string{name} + } else { + byID[id] = append(byID[id], name) + sort.Strings(byID[id]) + } + } + } + return byID +} + +// HasReferences returns whether or not the given image is referenced in one or +// more repositories. +func (store *TagStore) HasReferences(img *image.Image) bool { + return len(store.ByID()[img.ID]) > 0 +} + +// ImageName returns name of an image, given the image's ID. +func (store *TagStore) ImageName(id string) string { + if names, exists := store.ByID()[id]; exists && len(names) > 0 { + return names[0] + } + return stringid.TruncateID(id) +} + +// DeleteAll removes images identified by a specific ID from the store. +func (store *TagStore) DeleteAll(id string) error { + names, exists := store.ByID()[id] + if !exists || len(names) == 0 { + return nil + } + for _, name := range names { + if strings.Contains(name, ":") { + nameParts := strings.Split(name, ":") + if _, err := store.Delete(nameParts[0], nameParts[1]); err != nil { + return err + } + } else { + if _, err := store.Delete(name, ""); err != nil { + return err + } + } + } + return nil +} + +// Delete deletes a repository or a specific tag. If ref is empty, the entire +// repository named repoName will be deleted; otherwise only the tag named by +// ref will be deleted. +func (store *TagStore) Delete(repoName, ref string) (bool, error) { + store.Lock() + defer store.Unlock() + deleted := false + if err := store.reload(); err != nil { + return false, err + } + + repoName = registry.NormalizeLocalName(repoName) + + if ref == "" { + // Delete the whole repository. + delete(store.Repositories, repoName) + return true, store.save() + } + + repoRefs, exists := store.Repositories[repoName] + if !exists { + return false, fmt.Errorf("No such repository: %s", repoName) + } + + if _, exists := repoRefs[ref]; exists { + delete(repoRefs, ref) + if len(repoRefs) == 0 { + delete(store.Repositories, repoName) + } + deleted = true + } + + return deleted, store.save() +} + +// Tag creates a tag in the repository reponame, pointing to the image named +// imageName. If force is true, an existing tag with the same name may be +// overwritten. +func (store *TagStore) Tag(repoName, tag, imageName string, force bool) error { + return store.setLoad(repoName, tag, imageName, force, nil) +} + +// setLoad stores the image to the store. +// If the imageName is already in the repo then a '-f' flag should be used to replace existing image. +func (store *TagStore) setLoad(repoName, tag, imageName string, force bool, out io.Writer) error { + img, err := store.LookupImage(imageName) + store.Lock() + defer store.Unlock() + if err != nil { + return err + } + if tag == "" { + tag = tags.DefaultTag + } + if err := validateRepoName(repoName); err != nil { + return err + } + if err := tags.ValidateTagName(tag); err != nil { + return err + } + if err := store.reload(); err != nil { + return err + } + var repo Repository + repoName = registry.NormalizeLocalName(repoName) + if r, exists := store.Repositories[repoName]; exists { + repo = r + if old, exists := store.Repositories[repoName][tag]; exists { + + if !force { + return fmt.Errorf("Conflict: Tag %s:%s is already set to image %s, if you want to replace it, please use -f option", repoName, tag, old[:12]) + } + + if old != img.ID && out != nil { + + fmt.Fprintf(out, "The image %s:%s already exists, renaming the old one with ID %s to empty string\n", repoName, tag, old[:12]) + + } + } + } else { + repo = make(map[string]string) + store.Repositories[repoName] = repo + } + repo[tag] = img.ID + return store.save() +} + +// SetDigest creates a digest reference to an image ID. +func (store *TagStore) SetDigest(repoName, digest, imageName string) error { + img, err := store.LookupImage(imageName) + if err != nil { + return err + } + + if err := validateRepoName(repoName); err != nil { + return err + } + + if err := validateDigest(digest); err != nil { + return err + } + + store.Lock() + defer store.Unlock() + if err := store.reload(); err != nil { + return err + } + + repoName = registry.NormalizeLocalName(repoName) + repoRefs, exists := store.Repositories[repoName] + if !exists { + repoRefs = Repository{} + store.Repositories[repoName] = repoRefs + } else if oldID, exists := repoRefs[digest]; exists && oldID != img.ID { + return fmt.Errorf("Conflict: Digest %s is already set to image %s", digest, oldID) + } + + repoRefs[digest] = img.ID + return store.save() +} + +// Get returns the Repository tag/image map for a given repository. +func (store *TagStore) Get(repoName string) (Repository, error) { + store.Lock() + defer store.Unlock() + if err := store.reload(); err != nil { + return nil, err + } + repoName = registry.NormalizeLocalName(repoName) + if r, exists := store.Repositories[repoName]; exists { + return r, nil + } + return nil, nil +} + +// GetImage returns a pointer to an Image structure describing the image +// referred to by refOrID inside repository repoName. +func (store *TagStore) GetImage(repoName, refOrID string) (*image.Image, error) { + repo, err := store.Get(repoName) + + if err != nil { + return nil, err + } + if repo == nil { + return nil, nil + } + + store.Lock() + defer store.Unlock() + if imgID, exists := repo[refOrID]; exists { + return store.graph.Get(imgID) + } + + // If no matching tag is found, search through images for a matching image id + // iff it looks like a short ID or would look like a short ID + if stringid.IsShortID(stringid.TruncateID(refOrID)) { + for _, revision := range repo { + if strings.HasPrefix(revision, refOrID) { + return store.graph.Get(revision) + } + } + } + + return nil, nil +} + +// GetRepoRefs returns a map with image IDs as keys, and slices listing +// repo/tag references as the values. It covers all repositories. +func (store *TagStore) GetRepoRefs() map[string][]string { + store.Lock() + reporefs := make(map[string][]string) + + for name, repository := range store.Repositories { + for tag, id := range repository { + shortID := stringid.TruncateID(id) + reporefs[shortID] = append(reporefs[shortID], utils.ImageReference(name, tag)) + } + } + store.Unlock() + return reporefs +} + +// validateRepoName validates the name of a repository. +func validateRepoName(name string) error { + if name == "" { + return fmt.Errorf("Repository name can't be empty") + } + if name == "scratch" { + return fmt.Errorf("'scratch' is a reserved name") + } + return nil +} + +func validateDigest(dgst string) error { + if dgst == "" { + return errors.New("digest can't be empty") + } + if _, err := digest.ParseDigest(dgst); err != nil { + return err + } + return nil +} + +// poolAdd checks if a push or pull is already running, and returns +// (broadcaster, true) if a running operation is found. Otherwise, it creates a +// new one and returns (broadcaster, false). +func (store *TagStore) poolAdd(kind, key string) (*broadcaster.Buffered, bool) { + store.Lock() + defer store.Unlock() + + if p, exists := store.pullingPool[key]; exists { + return p, true + } + if p, exists := store.pushingPool[key]; exists { + return p, true + } + + broadcaster := broadcaster.NewBuffered() + + switch kind { + case "pull": + store.pullingPool[key] = broadcaster + case "push": + store.pushingPool[key] = broadcaster + default: + panic("Unknown pool type") + } + + return broadcaster, false +} + +func (store *TagStore) poolRemoveWithError(kind, key string, broadcasterResult error) error { + store.Lock() + defer store.Unlock() + switch kind { + case "pull": + if broadcaster, exists := store.pullingPool[key]; exists { + broadcaster.CloseWithError(broadcasterResult) + delete(store.pullingPool, key) + } + case "push": + if broadcaster, exists := store.pushingPool[key]; exists { + broadcaster.CloseWithError(broadcasterResult) + delete(store.pushingPool, key) + } + default: + return fmt.Errorf("Unknown pool type") + } + return nil +} + +func (store *TagStore) poolRemove(kind, key string) error { + return store.poolRemoveWithError(kind, key, nil) +} diff --git a/graph/tags/tags.go b/graph/tags/tags.go new file mode 100644 index 0000000000..c122675ab4 --- /dev/null +++ b/graph/tags/tags.go @@ -0,0 +1,33 @@ +package tags + +import ( + "fmt" + + "github.com/docker/distribution/registry/api/v2" +) + +// DefaultTag defines the default tag used when performing images related actions and no tag string is specified +const DefaultTag = "latest" + +// ErrTagInvalidFormat is returned if tag is invalid. +type ErrTagInvalidFormat struct { + name string +} + +func (e ErrTagInvalidFormat) Error() string { + return fmt.Sprintf("Illegal tag name (%s): only [A-Za-z0-9_.-] are allowed ('.' and '-' are NOT allowed in the initial), minimum 1, maximum 128 in length", e.name) +} + +// ValidateTagName validates the name of a tag. +// It returns an error if the given name is an emtpy string. +// If name does not match v2.TagNameAnchoredRegexp regexp, it returns ErrTagInvalidFormat +func ValidateTagName(name string) error { + if name == "" { + return fmt.Errorf("tag name can't be empty") + } + + if !v2.TagNameAnchoredRegexp.MatchString(name) { + return ErrTagInvalidFormat{name} + } + return nil +} diff --git a/graph/tags/tags_unit_test.go b/graph/tags/tags_unit_test.go new file mode 100644 index 0000000000..374e0f053c --- /dev/null +++ b/graph/tags/tags_unit_test.go @@ -0,0 +1,23 @@ +package tags + +import ( + "testing" +) + +func TestValidTagName(t *testing.T) { + validTags := []string{"9", "foo", "foo-test", "bar.baz.boo"} + for _, tag := range validTags { + if err := ValidateTagName(tag); err != nil { + t.Errorf("'%s' should've been a valid tag", tag) + } + } +} + +func TestInvalidTagName(t *testing.T) { + inValidTags := []string{"-9", ".foo", "-test", ".", "-"} + for _, tag := range inValidTags { + if err := ValidateTagName(tag); err == nil { + t.Errorf("'%s' should've been an invalid tag", tag) + } + } +} diff --git a/graph/tags_unit_test.go b/graph/tags_unit_test.go new file mode 100644 index 0000000000..9a7336be01 --- /dev/null +++ b/graph/tags_unit_test.go @@ -0,0 +1,205 @@ +package graph + +import ( + "archive/tar" + "bytes" + "io" + "os" + "path" + "testing" + + "github.com/docker/docker/daemon/events" + "github.com/docker/docker/daemon/graphdriver" + _ "github.com/docker/docker/daemon/graphdriver/vfs" // import the vfs driver so it is used in the tests + "github.com/docker/docker/graph/tags" + "github.com/docker/docker/image" + "github.com/docker/docker/utils" +) + +const ( + testOfficialImageName = "myapp" + testOfficialImageID = "1a2d3c4d4e5fa2d2a21acea242a5e2345d3aefc3e7dfa2a2a2a21a2a2ad2d234" + testOfficialImageIDShort = "1a2d3c4d4e5f" + testPrivateImageName = "127.0.0.1:8000/privateapp" + testPrivateImageID = "5bc255f8699e4ee89ac4469266c3d11515da88fdcbde45d7b069b636ff4efd81" + testPrivateImageIDShort = "5bc255f8699e" + testPrivateImageDigest = "sha256:bc8813ea7b3603864987522f02a76101c17ad122e1c46d790efc0fca78ca7bfb" + testPrivateImageTag = "sometag" +) + +func fakeTar() (io.Reader, error) { + uid := os.Getuid() + gid := os.Getgid() + + content := []byte("Hello world!\n") + buf := new(bytes.Buffer) + tw := tar.NewWriter(buf) + for _, name := range []string{"/etc/postgres/postgres.conf", "/etc/passwd", "/var/log/postgres/postgres.conf"} { + hdr := new(tar.Header) + + // Leaving these fields blank requires root privileges + hdr.Uid = uid + hdr.Gid = gid + + hdr.Size = int64(len(content)) + hdr.Name = name + if err := tw.WriteHeader(hdr); err != nil { + return nil, err + } + tw.Write([]byte(content)) + } + tw.Close() + return buf, nil +} + +func mkTestTagStore(root string, t *testing.T) *TagStore { + driver, err := graphdriver.New(root, nil, nil, nil) + if err != nil { + t.Fatal(err) + } + graph, err := NewGraph(root, driver, nil, nil) + if err != nil { + t.Fatal(err) + } + + tagCfg := &TagStoreConfig{ + Graph: graph, + Events: events.New(), + } + store, err := NewTagStore(path.Join(root, "tags"), tagCfg) + if err != nil { + t.Fatal(err) + } + officialArchive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + img := &image.Image{ID: testOfficialImageID} + if err := graph.Register(v1Descriptor{img}, officialArchive); err != nil { + t.Fatal(err) + } + if err := store.Tag(testOfficialImageName, "", testOfficialImageID, false); err != nil { + t.Fatal(err) + } + privateArchive, err := fakeTar() + if err != nil { + t.Fatal(err) + } + img = &image.Image{ID: testPrivateImageID} + if err := graph.Register(v1Descriptor{img}, privateArchive); err != nil { + t.Fatal(err) + } + if err := store.Tag(testPrivateImageName, "", testPrivateImageID, false); err != nil { + t.Fatal(err) + } + if err := store.SetDigest(testPrivateImageName, testPrivateImageDigest, testPrivateImageID); err != nil { + t.Fatal(err) + } + return store +} + +func TestLookupImage(t *testing.T) { + tmp, err := utils.TestDirectory("") + if err != nil { + t.Fatal(err) + } + defer os.RemoveAll(tmp) + store := mkTestTagStore(tmp, t) + defer store.graph.driver.Cleanup() + + officialLookups := []string{ + testOfficialImageID, + testOfficialImageIDShort, + testOfficialImageName + ":" + testOfficialImageID, + testOfficialImageName + ":" + testOfficialImageIDShort, + testOfficialImageName, + testOfficialImageName + ":" + tags.DefaultTag, + "docker.io/" + testOfficialImageName, + "docker.io/" + testOfficialImageName + ":" + tags.DefaultTag, + "index.docker.io/" + testOfficialImageName, + "index.docker.io/" + testOfficialImageName + ":" + tags.DefaultTag, + "library/" + testOfficialImageName, + "library/" + testOfficialImageName + ":" + tags.DefaultTag, + "docker.io/library/" + testOfficialImageName, + "docker.io/library/" + testOfficialImageName + ":" + tags.DefaultTag, + "index.docker.io/library/" + testOfficialImageName, + "index.docker.io/library/" + testOfficialImageName + ":" + tags.DefaultTag, + } + + privateLookups := []string{ + testPrivateImageID, + testPrivateImageIDShort, + testPrivateImageName + ":" + testPrivateImageID, + testPrivateImageName + ":" + testPrivateImageIDShort, + testPrivateImageName, + testPrivateImageName + ":" + tags.DefaultTag, + } + + invalidLookups := []string{ + testOfficialImageName + ":" + "fail", + "fail:fail", + } + + digestLookups := []string{ + testPrivateImageName + "@" + testPrivateImageDigest, + } + + for _, name := range officialLookups { + if img, err := store.LookupImage(name); err != nil { + t.Errorf("Error looking up %s: %s", name, err) + } else if img == nil { + t.Errorf("Expected 1 image, none found: %s", name) + } else if img.ID != testOfficialImageID { + t.Errorf("Expected ID '%s' found '%s'", testOfficialImageID, img.ID) + } + } + + for _, name := range privateLookups { + if img, err := store.LookupImage(name); err != nil { + t.Errorf("Error looking up %s: %s", name, err) + } else if img == nil { + t.Errorf("Expected 1 image, none found: %s", name) + } else if img.ID != testPrivateImageID { + t.Errorf("Expected ID '%s' found '%s'", testPrivateImageID, img.ID) + } + } + + for _, name := range invalidLookups { + if img, err := store.LookupImage(name); err == nil { + t.Errorf("Expected error, none found: %s", name) + } else if img != nil { + t.Errorf("Expected 0 image, 1 found: %s", name) + } + } + + for _, name := range digestLookups { + if img, err := store.LookupImage(name); err != nil { + t.Errorf("Error looking up %s: %s", name, err) + } else if img == nil { + t.Errorf("Expected 1 image, none found: %s", name) + } else if img.ID != testPrivateImageID { + t.Errorf("Expected ID '%s' found '%s'", testPrivateImageID, img.ID) + } + } +} + +func TestValidateDigest(t *testing.T) { + tests := []struct { + input string + expectError bool + }{ + {"", true}, + {"latest", true}, + {"sha256:b", false}, + {"tarsum+v1+sha256:bY852-_.+=", false}, + {"#$%#$^:$%^#$%", true}, + } + + for i, test := range tests { + err := validateDigest(test.input) + gotError := err != nil + if e, a := test.expectError, gotError; e != a { + t.Errorf("%d: with input %s, expected error=%t, got %t: %s", i, test.input, test.expectError, gotError, err) + } + } +} diff --git a/hack/.vendor-helpers.sh b/hack/.vendor-helpers.sh new file mode 100755 index 0000000000..4d78184da1 --- /dev/null +++ b/hack/.vendor-helpers.sh @@ -0,0 +1,140 @@ +#!/usr/bin/env bash + +PROJECT=github.com/docker/docker + +# Downloads dependencies into vendor/ directory +mkdir -p vendor + +rm -rf .gopath +mkdir -p .gopath/src/github.com/docker +ln -sf ../../../.. .gopath/src/${PROJECT} +export GOPATH="${PWD}/.gopath:${PWD}/vendor" + +clone() { + local vcs="$1" + local pkg="$2" + local rev="$3" + local url="$4" + + : ${url:=https://$pkg} + local target="vendor/src/$pkg" + + echo -n "$pkg @ $rev: " + + if [ -d "$target" ]; then + echo -n 'rm old, ' + rm -rf "$target" + fi + + echo -n 'clone, ' + case "$vcs" in + git) + git clone --quiet --no-checkout "$url" "$target" + ( cd "$target" && git checkout --quiet "$rev" && git reset --quiet --hard "$rev" ) + ;; + hg) + hg clone --quiet --updaterev "$rev" "$url" "$target" + ;; + esac + + echo -n 'rm VCS, ' + ( cd "$target" && rm -rf .{git,hg} ) + + echo -n 'rm vendor, ' + ( cd "$target" && rm -rf vendor Godeps/_workspace ) + + echo done +} + +# get an ENV from the Dockerfile with support for multiline values +_dockerfile_env() { + local e="$1" + awk ' + $1 == "ENV" && $2 == "'"$e"'" { + sub(/^ENV +([^ ]+) +/, ""); + inEnv = 1; + } + inEnv { + if (sub(/\\$/, "")) { + printf "%s", $0; + next; + } + print; + exit; + } + ' Dockerfile +} + +clean() { + local packages=( + "${PROJECT}/docker" # package main + "${PROJECT}/dockerinit" # package main + "${PROJECT}/integration-cli" # external tests + ) + local dockerPlatforms=( linux/amd64 $(_dockerfile_env DOCKER_CROSSPLATFORMS) ) + local dockerBuildTags="$(_dockerfile_env DOCKER_BUILDTAGS)" + local buildTagCombos=( + '' + 'experimental' + "$dockerBuildTags" + "daemon $dockerBuildTags" + "daemon cgo $dockerBuildTags" + "experimental $dockerBuildTags" + "experimental daemon $dockerBuildTags" + "experimental daemon cgo $dockerBuildTags" + ) + + echo + + echo -n 'collecting import graph, ' + local IFS=$'\n' + local imports=( $( + for platform in "${dockerPlatforms[@]}"; do + export GOOS="${platform%/*}"; + export GOARCH="${platform##*/}"; + for buildTags in "${buildTagCombos[@]}"; do + pkgs=( $(go list -e -tags "$buildTags" -f '{{join .Deps "\n"}}' "${packages[@]}" | grep -E "^${PROJECT}" | grep -vE "^${PROJECT}/vendor" | sort -u) ) + pkgs+=( ${packages[@]} ) + testImports=( $(go list -e -tags "$buildTags" -f '{{join .TestImports "\n"}}' "${pkgs[@]}" | sort -u) ) + printf '%s\n' "${testImports[@]}" + go list -e -tags "$buildTags" -f '{{join .Deps "\n"}}' "${packages[@]} ${testImports[@]}" + done + done | grep -vE "^${PROJECT}" | sort -u + ) ) + imports=( $(go list -e -f '{{if not .Standard}}{{.ImportPath}}{{end}}' "${imports[@]}") ) + unset IFS + + echo -n 'pruning unused packages, ' + findArgs=( + # This directory contains only .c and .h files which are necessary + -path vendor/src/github.com/mattn/go-sqlite3/code + # This directory is needed for compiling the unit tests + -o -path vendor/src/github.com/stretchr/objx + ) + for import in "${imports[@]}"; do + [ "${#findArgs[@]}" -eq 0 ] || findArgs+=( -or ) + findArgs+=( -path "vendor/src/$import" ) + done + local IFS=$'\n' + local prune=( $(find vendor -depth -type d -not '(' "${findArgs[@]}" ')') ) + unset IFS + for dir in "${prune[@]}"; do + find "$dir" -maxdepth 1 -not -type d -not -name 'LICENSE*' -not -name 'COPYING*' -exec rm -v -f '{}' + + rmdir "$dir" 2>/dev/null || true + done + + echo -n 'pruning unused files, ' + find vendor -type f -name '*_test.go' -exec rm -v '{}' + + + echo done +} + +# Fix up hard-coded imports that refer to Godeps paths so they'll work with our vendoring +fix_rewritten_imports () { + local pkg="$1" + local remove="${pkg}/Godeps/_workspace/src/" + local target="vendor/src/$pkg" + + echo "$pkg: fixing rewritten imports" + find "$target" -name \*.go -exec sed -i -e "s|\"${remove}|\"|g" {} \; +} diff --git a/hack/dind b/hack/dind new file mode 100755 index 0000000000..e4eb53580c --- /dev/null +++ b/hack/dind @@ -0,0 +1,118 @@ +#!/bin/bash +set -e + +# DinD: a wrapper script which allows docker to be run inside a docker container. +# Original version by Jerome Petazzoni +# See the blog post: https://blog.docker.com/2013/09/docker-can-now-run-within-docker/ +# +# This script should be executed inside a docker container in privilieged mode +# ('docker run --privileged', introduced in docker 0.6). + +# Usage: dind CMD [ARG...] + +# apparmor sucks and Docker needs to know that it's in a container (c) @tianon +export container=docker + +# as of docker 1.8, cgroups will be mounted in the container +if ! mountpoint -q /sys/fs/cgroup; then + + # First, make sure that cgroups are mounted correctly. + CGROUP=/cgroup + + mkdir -p "$CGROUP" + + if ! mountpoint -q "$CGROUP"; then + mount -n -t tmpfs -o uid=0,gid=0,mode=0755 cgroup $CGROUP || { + echo >&2 'Could not make a tmpfs mount. Did you use --privileged?' + exit 1 + } + fi + + # Mount the cgroup hierarchies exactly as they are in the parent system. + for HIER in $(cut -d: -f2 /proc/1/cgroup); do + + # The following sections address a bug which manifests itself + # by a cryptic "lxc-start: no ns_cgroup option specified" when + # trying to start containers within a container. + # The bug seems to appear when the cgroup hierarchies are not + # mounted on the exact same directories in the host, and in the + # container. + + SUBSYSTEMS="${HIER%name=*}" + + # If cgroup hierarchy is named(mounted with "-o name=foo") we + # need to mount it in $CGROUP/foo to create exect same + # directoryes as on host. Else we need to mount it as is e.g. + # "subsys1,subsys2" if it has two subsystems + + # Named, control-less cgroups are mounted with "-o name=foo" + # (and appear as such under /proc//cgroup) but are usually + # mounted on a directory named "foo" (without the "name=" prefix). + # Systemd and OpenRC (and possibly others) both create such a + # cgroup. So just mount them on directory $CGROUP/foo. + + OHIER=$HIER + HIER="${HIER#*name=}" + + mkdir -p "$CGROUP/$HIER" + + if ! mountpoint -q "$CGROUP/$HIER"; then + mount -n -t cgroup -o "$OHIER" cgroup "$CGROUP/$HIER" + fi + + # Likewise, on at least one system, it has been reported that + # systemd would mount the CPU and CPU accounting controllers + # (respectively "cpu" and "cpuacct") with "-o cpuacct,cpu" + # but on a directory called "cpu,cpuacct" (note the inversion + # in the order of the groups). This tries to work around it. + + if [ "$HIER" = 'cpuacct,cpu' ]; then + ln -s "$HIER" "$CGROUP/cpu,cpuacct" + fi + + # If hierarchy has multiple subsystems, in /proc//cgroup + # we will see ":subsys1,subsys2,subsys3,name=foo:" substring, + # we need to mount it to "$CGROUP/foo" and if there were no + # name to "$CGROUP/subsys1,subsys2,subsys3", so we must create + # symlinks for docker daemon to find these subsystems: + # ln -s $CGROUP/foo $CGROUP/subsys1 + # ln -s $CGROUP/subsys1,subsys2,subsys3 $CGROUP/subsys1 + + if [ "$SUBSYSTEMS" != "${SUBSYSTEMS//,/ }" ]; then + SUBSYSTEMS="${SUBSYSTEMS//,/ }" + for SUBSYS in $SUBSYSTEMS + do + ln -s "$CGROUP/$HIER" "$CGROUP/$SUBSYS" + done + fi + done +fi + +if [ -d /sys/kernel/security ] && ! mountpoint -q /sys/kernel/security; then + mount -t securityfs none /sys/kernel/security || { + echo >&2 'Could not mount /sys/kernel/security.' + echo >&2 'AppArmor detection and --privileged mode might break.' + } +fi + +# Note: as I write those lines, the LXC userland tools cannot setup +# a "sub-container" properly if the "devices" cgroup is not in its +# own hierarchy. Let's detect this and issue a warning. +if ! grep -q :devices: /proc/1/cgroup; then + echo >&2 'WARNING: the "devices" cgroup should be in its own hierarchy.' +fi +if ! grep -qw devices /proc/1/cgroup; then + echo >&2 'WARNING: it looks like the "devices" cgroup is not mounted.' +fi + +# Mount /tmp (conditionally) +if ! mountpoint -q /tmp; then + mount -t tmpfs none /tmp +fi + +if [ $# -gt 0 ]; then + exec "$@" +fi + +echo >&2 'ERROR: No command specified.' +echo >&2 'You probably want to run hack/make.sh, or maybe a shell?' diff --git a/hack/generate-authors.sh b/hack/generate-authors.sh new file mode 100755 index 0000000000..e78a97f962 --- /dev/null +++ b/hack/generate-authors.sh @@ -0,0 +1,15 @@ +#!/bin/bash +set -e + +cd "$(dirname "$(readlink -f "$BASH_SOURCE")")/.." + +# see also ".mailmap" for how email addresses and names are deduplicated + +{ + cat <<-'EOH' + # This file lists all individuals having contributed content to the repository. + # For how it is generated, see `hack/generate-authors.sh`. + EOH + echo + git log --format='%aN <%aE>' | LC_ALL=C.UTF-8 sort -uf +} > AUTHORS diff --git a/hack/install.sh b/hack/install.sh new file mode 100755 index 0000000000..efd32e13a5 --- /dev/null +++ b/hack/install.sh @@ -0,0 +1,435 @@ +#!/bin/sh +set -e +# +# This script is meant for quick & easy install via: +# 'curl -sSL https://get.docker.com/ | sh' +# or: +# 'wget -qO- https://get.docker.com/ | sh' +# +# For test builds (ie. release candidates): +# 'curl -sSL https://test.docker.com/ | sh' +# or: +# 'wget -qO- https://test.docker.com/ | sh' +# +# For experimental builds: +# 'curl -sSL https://experimental.docker.com/ | sh' +# or: +# 'wget -qO- https://experimental.docker.com/ | sh' +# +# Docker Maintainers: +# To update this script on https://get.docker.com, +# use hack/release.sh during a normal release, +# or the following one-liner for script hotfixes: +# s3cmd put --acl-public -P hack/install.sh s3://get.docker.com/index +# + +url='https://get.docker.com/' + +command_exists() { + command -v "$@" > /dev/null 2>&1 +} + +echo_docker_as_nonroot() { + if command_exists docker && [ -e /var/run/docker.sock ]; then + ( + set -x + $sh_c 'docker version' + ) || true + fi + your_user=your-user + [ "$user" != 'root' ] && your_user="$user" + # intentionally mixed spaces and tabs here -- tabs are stripped by "<<-EOF", spaces are kept in the output + cat <<-EOF + + If you would like to use Docker as a non-root user, you should now consider + adding your user to the "docker" group with something like: + + sudo usermod -aG docker $your_user + + Remember that you will have to log out and back in for this to take effect! + + EOF +} + +# Check if this is a forked Linux distro +check_forked() { + # Check for lsb_release command existence, it usually exists in forked distros + if command_exists lsb_release; then + # Check if the `-u` option is supported + set +e + lsb_release -a -u > /dev/null 2>&1 + lsb_release_exit_code=$? + set -e + + # Check if the command has exited successfully, it means we're in a forked distro + if [ "$lsb_release_exit_code" = "0" ]; then + # Print info about current distro + cat <<-EOF + You're using '$lsb_dist' version '$dist_version'. + EOF + + # Get the upstream release info + lsb_dist=$(lsb_release -a -u 2>&1 | tr '[:upper:]' '[:lower:]' | grep -E 'id' | cut -d ':' -f 2 | tr -d '[[:space:]]') + dist_version=$(lsb_release -a -u 2>&1 | tr '[:upper:]' '[:lower:]' | grep -E 'codename' | cut -d ':' -f 2 | tr -d '[[:space:]]') + + # Print info about upstream distro + cat <<-EOF + Upstream release is '$lsb_dist' version '$dist_version'. + EOF + fi + fi +} + +rpm_import_repository_key() { + local key=$1; shift + local tmpdir=$(mktemp -d) + chmod 600 "$tmpdir" + gpg --homedir "$tmpdir" --keyserver ha.pool.sks-keyservers.net --recv-keys "$key" + gpg --homedir "$tmpdir" --export --armor "$key" > "$tmpdir"/repo.key + rpm --import "$tmpdir"/repo.key + rm -rf "$tmpdir" +} + +do_install() { + case "$(uname -m)" in + *64) + ;; + *) + cat >&2 <<-'EOF' + Error: you are not using a 64bit platform. + Docker currently only supports 64bit platforms. + EOF + exit 1 + ;; + esac + + if command_exists docker; then + cat >&2 <<-'EOF' + Warning: the "docker" command appears to already exist on this system. + + If you already have Docker installed, this script can cause trouble, which is + why we're displaying this warning and provide the opportunity to cancel the + installation. + + If you installed the current Docker package using this script and are using it + again to update Docker, you can safely ignore this message. + + You may press Ctrl+C now to abort this script. + EOF + ( set -x; sleep 20 ) + fi + + user="$(id -un 2>/dev/null || true)" + + sh_c='sh -c' + if [ "$user" != 'root' ]; then + if command_exists sudo; then + sh_c='sudo -E sh -c' + elif command_exists su; then + sh_c='su -c' + else + cat >&2 <<-'EOF' + Error: this installer needs the ability to run commands as root. + We are unable to find either "sudo" or "su" available to make this happen. + EOF + exit 1 + fi + fi + + curl='' + if command_exists curl; then + curl='curl -sSL' + elif command_exists wget; then + curl='wget -qO-' + elif command_exists busybox && busybox --list-modules | grep -q wget; then + curl='busybox wget -qO-' + fi + + # check to see which repo they are trying to install from + repo='main' + if [ "https://test.docker.com/" = "$url" ]; then + repo='testing' + elif [ "https://experimental.docker.com/" = "$url" ]; then + repo='experimental' + fi + + # perform some very rudimentary platform detection + lsb_dist='' + dist_version='' + if command_exists lsb_release; then + lsb_dist="$(lsb_release -si)" + fi + if [ -z "$lsb_dist" ] && [ -r /etc/lsb-release ]; then + lsb_dist="$(. /etc/lsb-release && echo "$DISTRIB_ID")" + fi + if [ -z "$lsb_dist" ] && [ -r /etc/debian_version ]; then + lsb_dist='debian' + fi + if [ -z "$lsb_dist" ] && [ -r /etc/fedora-release ]; then + lsb_dist='fedora' + fi + if [ -z "$lsb_dist" ] && [ -r /etc/oracle-release ]; then + lsb_dist='oracleserver' + fi + if [ -z "$lsb_dist" ]; then + if [ -r /etc/centos-release ] || [ -r /etc/redhat-release ]; then + lsb_dist='centos' + fi + fi + if [ -z "$lsb_dist" ] && [ -r /etc/os-release ]; then + lsb_dist="$(. /etc/os-release && echo "$ID")" + fi + + lsb_dist="$(echo "$lsb_dist" | tr '[:upper:]' '[:lower:]')" + + case "$lsb_dist" in + + ubuntu) + if command_exists lsb_release; then + dist_version="$(lsb_release --codename | cut -f2)" + fi + if [ -z "$dist_version" ] && [ -r /etc/lsb-release ]; then + dist_version="$(. /etc/lsb-release && echo "$DISTRIB_CODENAME")" + fi + ;; + + debian) + dist_version="$(cat /etc/debian_version | sed 's/\/.*//' | sed 's/\..*//')" + case "$dist_version" in + 8) + dist_version="jessie" + ;; + 7) + dist_version="wheezy" + ;; + esac + ;; + + oracleserver) + # need to switch lsb_dist to match yum repo URL + lsb_dist="oraclelinux" + dist_version="$(rpm -q --whatprovides redhat-release --queryformat "%{VERSION}\n" | sed 's/\/.*//' | sed 's/\..*//' | sed 's/Server*//')" + ;; + + fedora|centos) + dist_version="$(rpm -q --whatprovides redhat-release --queryformat "%{VERSION}\n" | sed 's/\/.*//' | sed 's/\..*//' | sed 's/Server*//')" + ;; + + *) + if command_exists lsb_release; then + dist_version="$(lsb_release --codename | cut -f2)" + fi + if [ -z "$dist_version" ] && [ -r /etc/os-release ]; then + dist_version="$(. /etc/os-release && echo "$VERSION_ID")" + fi + ;; + + + esac + + # Check if this is a forked Linux distro + check_forked + + # Run setup for each distro accordingly + case "$lsb_dist" in + amzn) + ( + set -x + $sh_c 'sleep 3; yum -y -q install docker' + ) + echo_docker_as_nonroot + exit 0 + ;; + + 'opensuse project'|opensuse) + echo 'Going to perform the following operations:' + if [ "$repo" != 'main' ]; then + echo ' * add repository obs://Virtualization:containers' + fi + echo ' * install Docker' + $sh_c 'echo "Press CTRL-C to abort"; sleep 3' + + if [ "$repo" != 'main' ]; then + # install experimental packages from OBS://Virtualization:containers + ( + set -x + zypper -n ar -f obs://Virtualization:containers Virtualization:containers + rpm_import_repository_key 55A0B34D49501BB7CA474F5AA193FBB572174FC2 + ) + fi + ( + set -x + zypper -n install docker + ) + echo_docker_as_nonroot + exit 0 + ;; + 'suse linux'|sle[sd]) + echo 'Going to perform the following operations:' + if [ "$repo" != 'main' ]; then + echo ' * add repository obs://Virtualization:containers' + echo ' * install experimental Docker using packages NOT supported by SUSE' + else + echo ' * add the "Containers" module' + echo ' * install Docker using packages supported by SUSE' + fi + $sh_c 'echo "Press CTRL-C to abort"; sleep 3' + + if [ "$repo" != 'main' ]; then + # install experimental packages from OBS://Virtualization:containers + echo >&2 'Warning: installing experimental packages from OBS, these packages are NOT supported by SUSE' + ( + set -x + zypper -n ar -f obs://Virtualization:containers/SLE_12 Virtualization:containers + rpm_import_repository_key 55A0B34D49501BB7CA474F5AA193FBB572174FC2 + ) + else + # Add the containers module + # Note well-1: the SLE machine must already be registered against SUSE Customer Center + # Note well-2: the `-r ""` is required to workaround a known issue of SUSEConnect + ( + set -x + SUSEConnect -p sle-module-containers/12/x86_64 -r "" + ) + fi + ( + set -x + zypper -n install docker + ) + echo_docker_as_nonroot + exit 0 + ;; + + ubuntu|debian) + export DEBIAN_FRONTEND=noninteractive + + did_apt_get_update= + apt_get_update() { + if [ -z "$did_apt_get_update" ]; then + ( set -x; $sh_c 'sleep 3; apt-get update' ) + did_apt_get_update=1 + fi + } + + # aufs is preferred over devicemapper; try to ensure the driver is available. + if ! grep -q aufs /proc/filesystems && ! $sh_c 'modprobe aufs'; then + if uname -r | grep -q -- '-generic' && dpkg -l 'linux-image-*-generic' | grep -q '^ii' 2>/dev/null; then + kern_extras="linux-image-extra-$(uname -r) linux-image-extra-virtual" + + apt_get_update + ( set -x; $sh_c 'sleep 3; apt-get install -y -q '"$kern_extras" ) || true + + if ! grep -q aufs /proc/filesystems && ! $sh_c 'modprobe aufs'; then + echo >&2 'Warning: tried to install '"$kern_extras"' (for AUFS)' + echo >&2 ' but we still have no AUFS. Docker may not work. Proceeding anyways!' + ( set -x; sleep 10 ) + fi + else + echo >&2 'Warning: current kernel is not supported by the linux-image-extra-virtual' + echo >&2 ' package. We have no AUFS support. Consider installing the packages' + echo >&2 ' linux-image-virtual kernel and linux-image-extra-virtual for AUFS support.' + ( set -x; sleep 10 ) + fi + fi + + # install apparmor utils if they're missing and apparmor is enabled in the kernel + # otherwise Docker will fail to start + if [ "$(cat /sys/module/apparmor/parameters/enabled 2>/dev/null)" = 'Y' ]; then + if command -v apparmor_parser >/dev/null 2>&1; then + echo 'apparmor is enabled in the kernel and apparmor utils were already installed' + else + echo 'apparmor is enabled in the kernel, but apparmor_parser missing' + apt_get_update + ( set -x; $sh_c 'sleep 3; apt-get install -y -q apparmor' ) + fi + fi + + if [ ! -e /usr/lib/apt/methods/https ]; then + apt_get_update + ( set -x; $sh_c 'sleep 3; apt-get install -y -q apt-transport-https ca-certificates' ) + fi + if [ -z "$curl" ]; then + apt_get_update + ( set -x; $sh_c 'sleep 3; apt-get install -y -q curl ca-certificates' ) + curl='curl -sSL' + fi + ( + set -x + $sh_c "apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D" + $sh_c "mkdir -p /etc/apt/sources.list.d" + $sh_c "echo deb https://apt.dockerproject.org/repo ${lsb_dist}-${dist_version} ${repo} > /etc/apt/sources.list.d/docker.list" + $sh_c 'sleep 3; apt-get update; apt-get install -y -q docker-engine' + ) + echo_docker_as_nonroot + exit 0 + ;; + + fedora|centos|oraclelinux) + $sh_c "cat >/etc/yum.repos.d/docker-${repo}.repo" <<-EOF + [docker-${repo}-repo] + name=Docker ${repo} Repository + baseurl=https://yum.dockerproject.org/repo/${repo}/${lsb_dist}/${dist_version} + enabled=1 + gpgcheck=1 + gpgkey=https://yum.dockerproject.org/gpg + EOF + if [ "$lsb_dist" = "fedora" ] && [ "$dist_version" -ge "22" ]; then + ( + set -x + $sh_c 'sleep 3; dnf -y -q install docker-engine' + ) + else + ( + set -x + $sh_c 'sleep 3; yum -y -q install docker-engine' + ) + fi + echo_docker_as_nonroot + exit 0 + ;; + gentoo) + if [ "$url" = "https://test.docker.com/" ]; then + # intentionally mixed spaces and tabs here -- tabs are stripped by "<<-'EOF'", spaces are kept in the output + cat >&2 <<-'EOF' + + You appear to be trying to install the latest nightly build in Gentoo.' + The portage tree should contain the latest stable release of Docker, but' + if you want something more recent, you can always use the live ebuild' + provided in the "docker" overlay available via layman. For more' + instructions, please see the following URL:' + + https://github.com/tianon/docker-overlay#using-this-overlay' + + After adding the "docker" overlay, you should be able to:' + + emerge -av =app-emulation/docker-9999' + + EOF + exit 1 + fi + + ( + set -x + $sh_c 'sleep 3; emerge app-emulation/docker' + ) + exit 0 + ;; + esac + + # intentionally mixed spaces and tabs here -- tabs are stripped by "<<-'EOF'", spaces are kept in the output + cat >&2 <<-'EOF' + + Either your platform is not easily detectable, is not supported by this + installer script (yet - PRs welcome! [hack/install.sh]), or does not yet have + a package for Docker. Please visit the following URL for more detailed + installation instructions: + + https://docs.docker.com/en/latest/installation/ + + EOF + exit 1 +} + +# wrapped up in a function so that we have some protection against only getting +# half the file during "curl | sh" +do_install diff --git a/hack/make.sh b/hack/make.sh new file mode 100755 index 0000000000..75a3351199 --- /dev/null +++ b/hack/make.sh @@ -0,0 +1,321 @@ +#!/usr/bin/env bash +set -e + +# This script builds various binary artifacts from a checkout of the docker +# source code. +# +# Requirements: +# - The current directory should be a checkout of the docker source code +# (https://github.com/docker/docker). Whatever version is checked out +# will be built. +# - The VERSION file, at the root of the repository, should exist, and +# will be used as Docker binary version and package version. +# - The hash of the git commit will also be included in the Docker binary, +# with the suffix -dirty if the repository isn't clean. +# - The script is intented to be run inside the docker container specified +# in the Dockerfile at the root of the source. In other words: +# DO NOT CALL THIS SCRIPT DIRECTLY. +# - The right way to call this script is to invoke "make" from +# your checkout of the Docker repository. +# the Makefile will do a "docker build -t docker ." and then +# "docker run hack/make.sh" in the resulting image. +# + +set -o pipefail + +export DOCKER_PKG='github.com/docker/docker' +export SCRIPTDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" +export MAKEDIR="$SCRIPTDIR/make" + +# We're a nice, sexy, little shell script, and people might try to run us; +# but really, they shouldn't. We want to be in a container! +if [ "$PWD" != "/go/src/$DOCKER_PKG" ] || [ -z "$DOCKER_CROSSPLATFORMS" ]; then + { + echo "# WARNING! I don't seem to be running in the Docker container." + echo "# The result of this command might be an incorrect build, and will not be" + echo "# officially supported." + echo "#" + echo "# Try this instead: make all" + echo "#" + } >&2 +fi + +echo + +# List of bundles to create when no argument is passed +DEFAULT_BUNDLES=( + validate-dco + validate-gofmt + validate-lint + validate-pkg + validate-test + validate-toml + validate-vet + + binary + + test-unit + test-integration-cli + test-docker-py + + dynbinary + + cover + cross + tgz + ubuntu +) + +VERSION=$(< ./VERSION) +if command -v git &> /dev/null && git rev-parse &> /dev/null; then + GITCOMMIT=$(git rev-parse --short HEAD) + if [ -n "$(git status --porcelain --untracked-files=no)" ]; then + GITCOMMIT="$GITCOMMIT-dirty" + fi + BUILDTIME=$(date -u) +elif [ "$DOCKER_GITCOMMIT" ]; then + GITCOMMIT="$DOCKER_GITCOMMIT" +else + echo >&2 'error: .git directory missing and DOCKER_GITCOMMIT not specified' + echo >&2 ' Please either build with the .git directory accessible, or specify the' + echo >&2 ' exact (--short) commit hash you are building using DOCKER_GITCOMMIT for' + echo >&2 ' future accountability in diagnosing build issues. Thanks!' + exit 1 +fi + +if [ "$AUTO_GOPATH" ]; then + rm -rf .gopath + mkdir -p .gopath/src/"$(dirname "${DOCKER_PKG}")" + ln -sf ../../../.. .gopath/src/"${DOCKER_PKG}" + export GOPATH="${PWD}/.gopath:${PWD}/vendor" +fi + +if [ ! "$GOPATH" ]; then + echo >&2 'error: missing GOPATH; please see https://golang.org/doc/code.html#GOPATH' + echo >&2 ' alternatively, set AUTO_GOPATH=1' + exit 1 +fi + +if [ "$DOCKER_EXPERIMENTAL" ] || [ "$DOCKER_REMAP_ROOT" ]; then + echo >&2 '# WARNING! DOCKER_EXPERIMENTAL is set: building experimental features' + echo >&2 + DOCKER_BUILDTAGS+=" experimental" +fi + +if [ -z "$DOCKER_CLIENTONLY" ]; then + DOCKER_BUILDTAGS+=" daemon" + if pkg-config libsystemd-journal 2> /dev/null ; then + DOCKER_BUILDTAGS+=" journald" + fi +fi + +if [ "$DOCKER_EXECDRIVER" = 'lxc' ]; then + DOCKER_BUILDTAGS+=' test_no_exec' +fi + +# test whether "btrfs/version.h" exists and apply btrfs_noversion appropriately +if \ + command -v gcc &> /dev/null \ + && ! gcc -E - &> /dev/null <<<'#include ' \ +; then + DOCKER_BUILDTAGS+=' btrfs_noversion' +fi + +# test whether "libdevmapper.h" is new enough to support deferred remove +# functionality. +if \ + command -v gcc &> /dev/null \ + && ! ( echo -e '#include \nint main() { dm_task_deferred_remove(NULL); }'| gcc -ldevmapper -xc - &> /dev/null ) \ +; then + DOCKER_BUILDTAGS+=' libdm_no_deferred_remove' +fi + +# Use these flags when compiling the tests and final binary + +IAMSTATIC='true' +source "$SCRIPTDIR/make/.go-autogen" +if [ -z "$DOCKER_DEBUG" ]; then + LDFLAGS='-w' +fi + +LDFLAGS_STATIC='-linkmode external' +# Cgo -H windows is incompatible with -linkmode external. +if [ "$(go env GOOS)" == 'windows' ]; then + LDFLAGS_STATIC='' +fi +EXTLDFLAGS_STATIC='-static' +# ORIG_BUILDFLAGS is necessary for the cross target which cannot always build +# with options like -race. +ORIG_BUILDFLAGS=( -a -tags "netgo static_build sqlite_omit_load_extension $DOCKER_BUILDTAGS" -installsuffix netgo ) +# see https://github.com/golang/go/issues/9369#issuecomment-69864440 for why -installsuffix is necessary here +BUILDFLAGS=( $BUILDFLAGS "${ORIG_BUILDFLAGS[@]}" ) +# Test timeout. +: ${TIMEOUT:=60m} +TESTFLAGS+=" -test.timeout=${TIMEOUT}" + +LDFLAGS_STATIC_DOCKER=" + $LDFLAGS_STATIC + -extldflags \"$EXTLDFLAGS_STATIC\" +" + +if [ "$(uname -s)" = 'FreeBSD' ]; then + # Tell cgo the compiler is Clang, not GCC + # https://code.google.com/p/go/source/browse/src/cmd/cgo/gcc.go?spec=svne77e74371f2340ee08622ce602e9f7b15f29d8d3&r=e6794866ebeba2bf8818b9261b54e2eef1c9e588#752 + export CC=clang + + # "-extld clang" is a workaround for + # https://code.google.com/p/go/issues/detail?id=6845 + LDFLAGS="$LDFLAGS -extld clang" +fi + +# If sqlite3.h doesn't exist under /usr/include, +# check /usr/local/include also just in case +# (e.g. FreeBSD Ports installs it under the directory) +if [ ! -e /usr/include/sqlite3.h ] && [ -e /usr/local/include/sqlite3.h ]; then + export CGO_CFLAGS='-I/usr/local/include' + export CGO_LDFLAGS='-L/usr/local/lib' +fi + +HAVE_GO_TEST_COVER= +if \ + go help testflag | grep -- -cover > /dev/null \ + && go tool -n cover > /dev/null 2>&1 \ +; then + HAVE_GO_TEST_COVER=1 +fi + +# If $TESTFLAGS is set in the environment, it is passed as extra arguments to 'go test'. +# You can use this to select certain tests to run, eg. +# +# TESTFLAGS='-test.run ^TestBuild$' ./hack/make.sh test-unit +# +# For integration-cli test, we use [gocheck](https://labix.org/gocheck), if you want +# to run certain tests on your local host, you should run with command: +# +# TESTFLAGS='-check.f DockerSuite.TestBuild*' ./hack/make.sh binary test-integration-cli +# +go_test_dir() { + dir=$1 + coverpkg=$2 + testcover=() + if [ "$HAVE_GO_TEST_COVER" ]; then + # if our current go install has -cover, we want to use it :) + mkdir -p "$DEST/coverprofiles" + coverprofile="docker${dir#.}" + coverprofile="$ABS_DEST/coverprofiles/${coverprofile//\//-}" + testcover=( -cover -coverprofile "$coverprofile" $coverpkg ) + fi + ( + echo '+ go test' $TESTFLAGS "${DOCKER_PKG}${dir#.}" + cd "$dir" + export DEST="$ABS_DEST" # we're in a subshell, so this is safe -- our integration-cli tests need DEST, and "cd" screws it up + test_env go test ${testcover[@]} -ldflags "$LDFLAGS" "${BUILDFLAGS[@]}" $TESTFLAGS + ) +} +test_env() { + # use "env -i" to tightly control the environment variables that bleed into the tests + env -i \ + DEST="$DEST" \ + DOCKER_EXECDRIVER="$DOCKER_EXECDRIVER" \ + DOCKER_GRAPHDRIVER="$DOCKER_GRAPHDRIVER" \ + DOCKER_USERLANDPROXY="$DOCKER_USERLANDPROXY" \ + DOCKER_HOST="$DOCKER_HOST" \ + DOCKER_REMAP_ROOT="$DOCKER_REMAP_ROOT" \ + DOCKER_REMOTE_DAEMON="$DOCKER_REMOTE_DAEMON" \ + GOPATH="$GOPATH" \ + HOME="$ABS_DEST/fake-HOME" \ + PATH="$PATH" \ + TEMP="$TEMP" \ + TEST_DOCKERINIT_PATH="$TEST_DOCKERINIT_PATH" \ + "$@" +} + +# a helper to provide ".exe" when it's appropriate +binary_extension() { + if [ "$(go env GOOS)" = 'windows' ]; then + echo -n '.exe' + fi +} + +# This helper function walks the current directory looking for directories +# holding certain files ($1 parameter), and prints their paths on standard +# output, one per line. +find_dirs() { + find . -not \( \ + \( \ + -path './vendor/*' \ + -o -path './integration-cli/*' \ + -o -path './contrib/*' \ + -o -path './pkg/mflag/example/*' \ + -o -path './.git/*' \ + -o -path './bundles/*' \ + -o -path './docs/*' \ + -o -path './pkg/libcontainer/nsinit/*' \ + \) \ + -prune \ + \) -name "$1" -print0 | xargs -0n1 dirname | sort -u +} + +hash_files() { + while [ $# -gt 0 ]; do + f="$1" + shift + dir="$(dirname "$f")" + base="$(basename "$f")" + for hashAlgo in md5 sha256; do + if command -v "${hashAlgo}sum" &> /dev/null; then + ( + # subshell and cd so that we get output files like: + # $HASH docker-$VERSION + # instead of: + # $HASH /go/src/github.com/.../$VERSION/binary/docker-$VERSION + cd "$dir" + "${hashAlgo}sum" "$base" > "$base.$hashAlgo" + ) + fi + done + done +} + +bundle() { + local bundle="$1"; shift + echo "---> Making bundle: $(basename "$bundle") (in $DEST)" + source "$SCRIPTDIR/make/$bundle" "$@" +} + +main() { + # We want this to fail if the bundles already exist and cannot be removed. + # This is to avoid mixing bundles from different versions of the code. + mkdir -p bundles + if [ -e "bundles/$VERSION" ] && [ -z "$KEEPBUNDLE" ]; then + echo "bundles/$VERSION already exists. Removing." + rm -fr "bundles/$VERSION" && mkdir "bundles/$VERSION" || exit 1 + echo + fi + + if [ "$(go env GOHOSTOS)" != 'windows' ]; then + # Windows and symlinks don't get along well + + rm -f bundles/latest + ln -s "$VERSION" bundles/latest + fi + + if [ $# -lt 1 ]; then + bundles=(${DEFAULT_BUNDLES[@]}) + else + bundles=($@) + fi + for bundle in ${bundles[@]}; do + export DEST="bundles/$VERSION/$(basename "$bundle")" + # Cygdrive paths don't play well with go build -o. + if [[ "$(uname -s)" == CYGWIN* ]]; then + export DEST="$(cygpath -mw "$DEST")" + fi + mkdir -p "$DEST" + ABS_DEST="$(cd "$DEST" && pwd -P)" + bundle "$bundle" + echo + done +} + +main "$@" diff --git a/hack/make/.build-deb/compat b/hack/make/.build-deb/compat new file mode 100644 index 0000000000..ec635144f6 --- /dev/null +++ b/hack/make/.build-deb/compat @@ -0,0 +1 @@ +9 diff --git a/hack/make/.build-deb/control b/hack/make/.build-deb/control new file mode 100644 index 0000000000..a45f7ae1f8 --- /dev/null +++ b/hack/make/.build-deb/control @@ -0,0 +1,26 @@ +Source: docker-engine +Maintainer: Docker +Homepage: https://dockerproject.org +Vcs-Browser: https://github.com/docker/docker +Vcs-Git: git://github.com/docker/docker.git + +Package: docker-engine +Architecture: linux-any +Depends: iptables, ${misc:Depends}, ${perl:Depends}, ${shlibs:Depends} +Recommends: aufs-tools, + ca-certificates, + cgroupfs-mount | cgroup-lite, + git, + xz-utils, + ${apparmor:Recommends} +Conflicts: docker (<< 1.5~), docker.io, lxc-docker, lxc-docker-virtual-package, docker-engine-cs +Description: Docker: the open-source application container engine + Docker is an open source project to build, ship and run any application as a + lightweight container + . + Docker containers are both hardware-agnostic and platform-agnostic. This means + they can run anywhere, from your laptop to the largest EC2 compute instance and + everything in between - and they don't require you to use a particular + language, framework or packaging system. That makes them great building blocks + for deploying and scaling web apps, databases, and backend services without + depending on a particular stack or provider. diff --git a/hack/make/.build-deb/docker-engine.bash-completion b/hack/make/.build-deb/docker-engine.bash-completion new file mode 100644 index 0000000000..6ea1119308 --- /dev/null +++ b/hack/make/.build-deb/docker-engine.bash-completion @@ -0,0 +1 @@ +contrib/completion/bash/docker diff --git a/hack/make/.build-deb/docker-engine.docker.default b/hack/make/.build-deb/docker-engine.docker.default new file mode 120000 index 0000000000..4278533d65 --- /dev/null +++ b/hack/make/.build-deb/docker-engine.docker.default @@ -0,0 +1 @@ +../../../contrib/init/sysvinit-debian/docker.default \ No newline at end of file diff --git a/hack/make/.build-deb/docker-engine.docker.init b/hack/make/.build-deb/docker-engine.docker.init new file mode 120000 index 0000000000..8cb89d30dd --- /dev/null +++ b/hack/make/.build-deb/docker-engine.docker.init @@ -0,0 +1 @@ +../../../contrib/init/sysvinit-debian/docker \ No newline at end of file diff --git a/hack/make/.build-deb/docker-engine.docker.upstart b/hack/make/.build-deb/docker-engine.docker.upstart new file mode 120000 index 0000000000..7e1b64a3e6 --- /dev/null +++ b/hack/make/.build-deb/docker-engine.docker.upstart @@ -0,0 +1 @@ +../../../contrib/init/upstart/docker.conf \ No newline at end of file diff --git a/hack/make/.build-deb/docker-engine.install b/hack/make/.build-deb/docker-engine.install new file mode 100644 index 0000000000..a8857a96dc --- /dev/null +++ b/hack/make/.build-deb/docker-engine.install @@ -0,0 +1,11 @@ +#contrib/syntax/vim/doc/* /usr/share/vim/vimfiles/doc/ +#contrib/syntax/vim/ftdetect/* /usr/share/vim/vimfiles/ftdetect/ +#contrib/syntax/vim/syntax/* /usr/share/vim/vimfiles/syntax/ +contrib/*-integration usr/share/docker-engine/contrib/ +contrib/check-config.sh usr/share/docker-engine/contrib/ +contrib/completion/zsh/_docker usr/share/zsh/vendor-completions/ +contrib/init/systemd/docker.service lib/systemd/system/ +contrib/init/systemd/docker.socket lib/systemd/system/ +contrib/mk* usr/share/docker-engine/contrib/ +contrib/nuke-graph-directory.sh usr/share/docker-engine/contrib/ +contrib/syntax/nano/Dockerfile.nanorc usr/share/nano/ diff --git a/hack/make/.build-deb/docker-engine.manpages b/hack/make/.build-deb/docker-engine.manpages new file mode 100644 index 0000000000..1aa62186a6 --- /dev/null +++ b/hack/make/.build-deb/docker-engine.manpages @@ -0,0 +1 @@ +man/man*/* diff --git a/hack/make/.build-deb/docker-engine.postinst b/hack/make/.build-deb/docker-engine.postinst new file mode 100644 index 0000000000..eeef6ca801 --- /dev/null +++ b/hack/make/.build-deb/docker-engine.postinst @@ -0,0 +1,20 @@ +#!/bin/sh +set -e + +case "$1" in + configure) + if [ -z "$2" ]; then + if ! getent group docker > /dev/null; then + groupadd --system docker + fi + fi + ;; + abort-*) + # How'd we get here?? + exit 1 + ;; + *) + ;; +esac + +#DEBHELPER# diff --git a/hack/make/.build-deb/docker-engine.udev b/hack/make/.build-deb/docker-engine.udev new file mode 120000 index 0000000000..914a361959 --- /dev/null +++ b/hack/make/.build-deb/docker-engine.udev @@ -0,0 +1 @@ +../../../contrib/udev/80-docker.rules \ No newline at end of file diff --git a/hack/make/.build-deb/docs b/hack/make/.build-deb/docs new file mode 100644 index 0000000000..f7c5f7594f --- /dev/null +++ b/hack/make/.build-deb/docs @@ -0,0 +1,2 @@ +README.md +LICENSE-EVAL.txt diff --git a/hack/make/.build-deb/rules b/hack/make/.build-deb/rules new file mode 100755 index 0000000000..b4c8e2b4c7 --- /dev/null +++ b/hack/make/.build-deb/rules @@ -0,0 +1,36 @@ +#!/usr/bin/make -f + +VERSION = $(shell cat VERSION) + +override_dh_gencontrol: + # if we're on Ubuntu, we need to Recommends: apparmor + echo 'apparmor:Recommends=$(shell dpkg-vendor --is Ubuntu && echo apparmor)' >> debian/docker-engine.substvars + dh_gencontrol + +override_dh_auto_build: + ./hack/make.sh dynbinary + # ./man/md2man-all.sh runs outside the build container (if at all), since we don't have go-md2man here + +override_dh_auto_test: + ./bundles/$(VERSION)/dynbinary/docker -v + +override_dh_strip: + # the SHA1 of dockerinit is important: don't strip it + # also, Go has lots of problems with stripping, so just don't + +override_dh_auto_install: + mkdir -p debian/docker-engine/usr/bin + cp -aT "$$(readlink -f bundles/$(VERSION)/dynbinary/docker)" debian/docker-engine/usr/bin/docker + mkdir -p debian/docker-engine/usr/lib/docker + cp -aT "$$(readlink -f bundles/$(VERSION)/dynbinary/dockerinit)" debian/docker-engine/usr/lib/docker/dockerinit + +override_dh_installinit: + # use "docker" as our service name, not "docker-engine" + dh_installinit --name=docker + +override_dh_installudev: + # match our existing priority + dh_installudev --priority=z80 + +%: + dh $@ --with=bash-completion $(shell command -v dh_systemd_enable > /dev/null 2>&1 && echo --with=systemd) diff --git a/hack/make/.build-rpm/docker-engine-selinux.spec b/hack/make/.build-rpm/docker-engine-selinux.spec new file mode 100644 index 0000000000..5178473aa1 --- /dev/null +++ b/hack/make/.build-rpm/docker-engine-selinux.spec @@ -0,0 +1,102 @@ +# Some bits borrowed from the openstack-selinux package +Name: docker-engine-selinux +Version: %{_version} +Release: %{_release}%{?dist} +Summary: SELinux Policies for the open-source application container engine +BuildArch: noarch +Group: Tools/Docker + +License: GPLv2 +Source: %{name}.tar.gz + +URL: https://dockerproject.org +Vendor: Docker +Packager: Docker + +# Version of SELinux we were using +%if 0%{?fedora} == 20 +%global selinux_policyver 3.12.1-197 +%endif # fedora 20 +%if 0%{?fedora} == 21 +%global selinux_policyver 3.13.1-105 +%endif # fedora 21 +%if 0%{?fedora} >= 22 +%global selinux_policyver 3.13.1-128 +%endif # fedora 22 +%if 0%{?centos} >= 7 || 0%{?rhel} >= 7 || 0%{?oraclelinux} >= 7 +%global selinux_policyver 3.13.1-23 +%endif # centos,rhel,oraclelinux 7 + +%global selinuxtype targeted +%global moduletype services +%global modulenames docker + +Requires(post): selinux-policy-base >= %{selinux_policyver}, selinux-policy-targeted >= %{selinux_policyver}, policycoreutils, policycoreutils-python libselinux-utils +BuildRequires: selinux-policy selinux-policy-devel + +# conflicting packages +Conflicts: docker-selinux + +# Usage: _format var format +# Expand 'modulenames' into various formats as needed +# Format must contain '$x' somewhere to do anything useful +%global _format() export %1=""; for x in %{modulenames}; do %1+=%2; %1+=" "; done; + +# Relabel files +%global relabel_files() \ + /sbin/restorecon -R %{_bindir}/docker %{_localstatedir}/run/docker.sock %{_localstatedir}/run/docker.pid %{_sharedstatedir}/docker %{_sysconfdir}/docker %{_localstatedir}/log/docker %{_localstatedir}/log/lxc %{_localstatedir}/lock/lxc %{_usr}/lib/systemd/system/docker.service /root/.docker &> /dev/null || : \ + +%description +SELinux policy modules for use with Docker + +%prep +%if 0%{?centos} <= 6 +%setup -n %{name} +%else +%autosetup -n %{name} +%endif + +%build +make SHARE="%{_datadir}" TARGETS="%{modulenames}" + +%install + +# Install SELinux interfaces +%_format INTERFACES $x.if +install -d %{buildroot}%{_datadir}/selinux/devel/include/%{moduletype} +install -p -m 644 $INTERFACES %{buildroot}%{_datadir}/selinux/devel/include/%{moduletype} + +# Install policy modules +%_format MODULES $x.pp.bz2 +install -d %{buildroot}%{_datadir}/selinux/packages +install -m 0644 $MODULES %{buildroot}%{_datadir}/selinux/packages + +%post +# +# Install all modules in a single transaction +# +if [ $1 -eq 1 ]; then + %{_sbindir}/setsebool -P -N virt_use_nfs=1 virt_sandbox_use_all_caps=1 +fi +%_format MODULES %{_datadir}/selinux/packages/$x.pp.bz2 +%{_sbindir}/semodule -n -s %{selinuxtype} -i $MODULES +if %{_sbindir}/selinuxenabled ; then + %{_sbindir}/load_policy + %relabel_files +fi + +%postun +if [ $1 -eq 0 ]; then + %{_sbindir}/semodule -n -r %{modulenames} &> /dev/null || : + if %{_sbindir}/selinuxenabled ; then + %{_sbindir}/load_policy + %relabel_files + fi +fi + +%files +%defattr(-,root,root,0755) +%attr(0644,root,root) %{_datadir}/selinux/packages/*.pp.bz2 +%attr(0644,root,root) %{_datadir}/selinux/devel/include/%{moduletype}/*.if + +%changelog diff --git a/hack/make/.build-rpm/docker-engine.spec b/hack/make/.build-rpm/docker-engine.spec new file mode 100644 index 0000000000..274d46e994 --- /dev/null +++ b/hack/make/.build-rpm/docker-engine.spec @@ -0,0 +1,221 @@ +Name: docker-engine +Version: %{_version} +Release: %{_release}%{?dist} +Summary: The open-source application container engine +Group: Tools/Docker + +License: ASL 2.0 +Source: %{name}.tar.gz + +URL: https://dockerproject.org +Vendor: Docker +Packager: Docker + +# docker builds in a checksum of dockerinit into docker, +# # so stripping the binaries breaks docker +%global __os_install_post %{_rpmconfigdir}/brp-compress +%global debug_package %{nil} + +# is_systemd conditional +%if 0%{?fedora} >= 21 || 0%{?centos} >= 7 || 0%{?rhel} >= 7 || 0%{?suse_version} >= 1300 +%global is_systemd 1 +%endif + +# required packages for build +# most are already in the container (see contrib/builder/rpm/generate.sh) +# only require systemd on those systems +%if 0%{?is_systemd} +BuildRequires: pkgconfig(systemd) +Requires: systemd-units +%if !0%{?suse_version} +BuildRequires: pkgconfig(libsystemd-journal) +%endif +%else +Requires(post): chkconfig +Requires(preun): chkconfig +# This is for /sbin/service +Requires(preun): initscripts +%endif + +# required packages on install +Requires: /bin/sh +Requires: iptables +Requires: libcgroup +Requires: tar +Requires: xz +%if 0%{?fedora} >= 21 +# Resolves: rhbz#1165615 +Requires: device-mapper-libs >= 1.02.90-1 +%endif +%if 0%{?oraclelinux} == 6 +# Require Oracle Unbreakable Enterprise Kernel R3 and newer device-mapper +Requires: kernel-uek >= 3.8 +Requires: device-mapper >= 1.02.90-2 +%endif + +# docker-selinux conditional +%if 0%{?fedora} >= 20 || 0%{?centos} >= 7 || 0%{?rhel} >= 7 || 0%{?oraclelinux} >= 7 +%global with_selinux 1 +%endif + +# start if with_selinux +%if 0%{?with_selinux} +# Version of SELinux we were using +%if 0%{?fedora} == 20 +%global selinux_policyver 3.12.1-197 +%endif # fedora 20 +%if 0%{?fedora} == 21 +%global selinux_policyver 3.13.1-105 +%endif # fedora 21 +%if 0%{?fedora} >= 22 +%global selinux_policyver 3.13.1-128 +%endif # fedora 22 +%if 0%{?centos} >= 7 || 0%{?rhel} >= 7 || 0%{?oraclelinux} >= 7 +%global selinux_policyver 3.13.1-23 +%endif # centos,oraclelinux 7 +%endif # with_selinux + +# RE: rhbz#1195804 - ensure min NVR for selinux-policy +%if 0%{?with_selinux} +Requires: selinux-policy >= %{selinux_policyver} +Requires(pre): %{name}-selinux >= %{epoch}:%{version}-%{release} +%endif # with_selinux + +# conflicting packages +Conflicts: docker +Conflicts: docker-io +Conflicts: docker-engine-cs + +%description +Docker is an open source project to build, ship and run any application as a +lightweight container. + +Docker containers are both hardware-agnostic and platform-agnostic. This means +they can run anywhere, from your laptop to the largest EC2 compute instance and +everything in between - and they don't require you to use a particular +language, framework or packaging system. That makes them great building blocks +for deploying and scaling web apps, databases, and backend services without +depending on a particular stack or provider. + +%prep +%if 0%{?centos} <= 6 +%setup -n %{name} +%else +%autosetup -n %{name} +%endif + +%build +export DOCKER_GITCOMMIT=%{_gitcommit} +./hack/make.sh dynbinary +# ./man/md2man-all.sh runs outside the build container (if at all), since we don't have go-md2man here + +%check +./bundles/%{_origversion}/dynbinary/docker -v + +%install +# install binary +install -d $RPM_BUILD_ROOT/%{_bindir} +install -p -m 755 bundles/%{_origversion}/dynbinary/docker-%{_origversion} $RPM_BUILD_ROOT/%{_bindir}/docker + +# install dockerinit +install -d $RPM_BUILD_ROOT/%{_libexecdir}/docker +install -p -m 755 bundles/%{_origversion}/dynbinary/dockerinit-%{_origversion} $RPM_BUILD_ROOT/%{_libexecdir}/docker/dockerinit + +# install udev rules +install -d $RPM_BUILD_ROOT/%{_sysconfdir}/udev/rules.d +install -p -m 755 contrib/udev/80-docker.rules $RPM_BUILD_ROOT/%{_sysconfdir}/udev/rules.d/80-docker.rules + +# add init scripts +install -d $RPM_BUILD_ROOT/etc/sysconfig +install -d $RPM_BUILD_ROOT/%{_initddir} + + +%if 0%{?is_systemd} +install -d $RPM_BUILD_ROOT/%{_unitdir} +install -p -m 644 contrib/init/systemd/docker.service $RPM_BUILD_ROOT/%{_unitdir}/docker.service +install -p -m 644 contrib/init/systemd/docker.socket $RPM_BUILD_ROOT/%{_unitdir}/docker.socket +%else +install -p -m 644 contrib/init/sysvinit-redhat/docker.sysconfig $RPM_BUILD_ROOT/etc/sysconfig/docker +install -p -m 755 contrib/init/sysvinit-redhat/docker $RPM_BUILD_ROOT/%{_initddir}/docker +%endif +# add bash completions +install -d $RPM_BUILD_ROOT/usr/share/bash-completion/completions +install -d $RPM_BUILD_ROOT/usr/share/zsh/vendor-completions +install -d $RPM_BUILD_ROOT/usr/share/fish/completions +install -p -m 644 contrib/completion/bash/docker $RPM_BUILD_ROOT/usr/share/bash-completion/completions/docker +install -p -m 644 contrib/completion/zsh/_docker $RPM_BUILD_ROOT/usr/share/zsh/vendor-completions/_docker +install -p -m 644 contrib/completion/fish/docker.fish $RPM_BUILD_ROOT/usr/share/fish/completions/docker.fish + +# install manpages +install -d %{buildroot}%{_mandir}/man1 +install -p -m 644 man/man1/*.1 $RPM_BUILD_ROOT/%{_mandir}/man1 +install -d %{buildroot}%{_mandir}/man5 +install -p -m 644 man/man5/*.5 $RPM_BUILD_ROOT/%{_mandir}/man5 + +# add vimfiles +install -d $RPM_BUILD_ROOT/usr/share/vim/vimfiles/doc +install -d $RPM_BUILD_ROOT/usr/share/vim/vimfiles/ftdetect +install -d $RPM_BUILD_ROOT/usr/share/vim/vimfiles/syntax +install -p -m 644 contrib/syntax/vim/doc/dockerfile.txt $RPM_BUILD_ROOT/usr/share/vim/vimfiles/doc/dockerfile.txt +install -p -m 644 contrib/syntax/vim/ftdetect/dockerfile.vim $RPM_BUILD_ROOT/usr/share/vim/vimfiles/ftdetect/dockerfile.vim +install -p -m 644 contrib/syntax/vim/syntax/dockerfile.vim $RPM_BUILD_ROOT/usr/share/vim/vimfiles/syntax/dockerfile.vim + +# add nano +install -d $RPM_BUILD_ROOT/usr/share/nano +install -p -m 644 contrib/syntax/nano/Dockerfile.nanorc $RPM_BUILD_ROOT/usr/share/nano/Dockerfile.nanorc + +# list files owned by the package here +%files +%doc AUTHORS CHANGELOG.md CONTRIBUTING.md LICENSE MAINTAINERS NOTICE README.md LICENSE-EVAL.txt +/%{_bindir}/docker +/%{_libexecdir}/docker/dockerinit +/%{_sysconfdir}/udev/rules.d/80-docker.rules +%if 0%{?is_systemd} +/%{_unitdir}/docker.service +/%{_unitdir}/docker.socket +%else +%config(noreplace,missingok) /etc/sysconfig/docker +/%{_initddir}/docker +%endif +/usr/share/bash-completion/completions/docker +/usr/share/zsh/vendor-completions/_docker +/usr/share/fish/completions/docker.fish +%doc +/%{_mandir}/man1/* +/%{_mandir}/man5/* +/usr/share/vim/vimfiles/doc/dockerfile.txt +/usr/share/vim/vimfiles/ftdetect/dockerfile.vim +/usr/share/vim/vimfiles/syntax/dockerfile.vim +/usr/share/nano/Dockerfile.nanorc + +%post +%if 0%{?is_systemd} +%systemd_post docker +%else +# This adds the proper /etc/rc*.d links for the script +/sbin/chkconfig --add docker +%endif +if ! getent group docker > /dev/null; then + groupadd --system docker +fi + +%preun +%if 0%{?is_systemd} +%systemd_preun docker +%else +if [ $1 -eq 0 ] ; then + /sbin/service docker stop >/dev/null 2>&1 + /sbin/chkconfig --del docker +fi +%endif + +%postun +%if 0%{?is_systemd} +%systemd_postun_with_restart docker +%else +if [ "$1" -ge "1" ] ; then + /sbin/service docker condrestart >/dev/null 2>&1 || : +fi +%endif + +%changelog diff --git a/hack/make/.dockerinit b/hack/make/.dockerinit new file mode 100644 index 0000000000..4a62ee1add --- /dev/null +++ b/hack/make/.dockerinit @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +IAMSTATIC="true" +source "${MAKEDIR}/.go-autogen" + +# dockerinit still needs to be a static binary, even if docker is dynamic +go build \ + -o "$DEST/dockerinit-$VERSION" \ + "${BUILDFLAGS[@]}" \ + -ldflags " + $LDFLAGS + $LDFLAGS_STATIC + -extldflags \"$EXTLDFLAGS_STATIC\" + " \ + ./dockerinit + +echo "Created binary: $DEST/dockerinit-$VERSION" +ln -sf "dockerinit-$VERSION" "$DEST/dockerinit" + +sha1sum= +if command -v sha1sum &> /dev/null; then + sha1sum=sha1sum +elif command -v shasum &> /dev/null; then + # Mac OS X - why couldn't they just use the same command name and be happy? + sha1sum=shasum +else + echo >&2 'error: cannot find sha1sum command or equivalent' + exit 1 +fi + +# sha1 our new dockerinit to ensure separate docker and dockerinit always run in a perfect pair compiled for one another +export DOCKER_INITSHA1=$($sha1sum "$DEST/dockerinit-$VERSION" | cut -d' ' -f1) diff --git a/hack/make/.dockerinit-gccgo b/hack/make/.dockerinit-gccgo new file mode 100644 index 0000000000..3caa526216 --- /dev/null +++ b/hack/make/.dockerinit-gccgo @@ -0,0 +1,31 @@ +#!/bin/bash +set -e + +IAMSTATIC="true" +source "${MAKEDIR}/.go-autogen" + +# dockerinit still needs to be a static binary, even if docker is dynamic +go build --compiler=gccgo \ + -o "$DEST/dockerinit-$VERSION" \ + "${BUILDFLAGS[@]}" \ + --gccgoflags " + -g + -Wl,--no-export-dynamic + $EXTLDFLAGS_STATIC + -lnetgo + " \ + ./dockerinit + +echo "Created binary: $DEST/dockerinit-$VERSION" +ln -sf "dockerinit-$VERSION" "$DEST/dockerinit" + +sha1sum= +if command -v sha1sum &> /dev/null; then + sha1sum=sha1sum +else + echo >&2 'error: cannot find sha1sum command or equivalent' + exit 1 +fi + +# sha1 our new dockerinit to ensure separate docker and dockerinit always run in a perfect pair compiled for one another +export DOCKER_INITSHA1=$($sha1sum "$DEST/dockerinit-$VERSION" | cut -d' ' -f1) diff --git a/hack/make/.ensure-emptyfs b/hack/make/.ensure-emptyfs new file mode 100644 index 0000000000..e71a30ae81 --- /dev/null +++ b/hack/make/.ensure-emptyfs @@ -0,0 +1,23 @@ +#!/bin/bash +set -e + +if ! docker inspect emptyfs &> /dev/null; then + # let's build a "docker save" tarball for "emptyfs" + # see https://github.com/docker/docker/pull/5262 + # and also https://github.com/docker/docker/issues/4242 + dir="$DEST/emptyfs" + mkdir -p "$dir" + ( + cd "$dir" + echo '{"emptyfs":{"latest":"511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158"}}' > repositories + mkdir -p 511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158 + ( + cd 511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158 + echo '{"id":"511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158","comment":"Imported from -","created":"2013-06-13T14:03:50.821769-07:00","container_config":{"Hostname":"","Domainname":"","User":"","Memory":0,"MemorySwap":0,"CpuShares":0,"AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"PortSpecs":null,"ExposedPorts":null,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":null,"Cmd":null,"Image":"","Volumes":null,"WorkingDir":"","Entrypoint":null,"NetworkDisabled":false,"OnBuild":null},"docker_version":"0.4.0","architecture":"x86_64","Size":0}' > json + echo '1.0' > VERSION + tar -cf layer.tar --files-from /dev/null + ) + ) + ( set -x; tar -cC "$dir" . | docker load ) + rm -rf "$dir" +fi diff --git a/hack/make/.ensure-frozen-images b/hack/make/.ensure-frozen-images new file mode 100644 index 0000000000..deded80e76 --- /dev/null +++ b/hack/make/.ensure-frozen-images @@ -0,0 +1,38 @@ +#!/bin/bash +set -e + +# this list should match roughly what's in the Dockerfile (minus the explicit image IDs, of course) +images=( + busybox:latest + hello-world:frozen + jess/unshare:latest +) + +if ! docker inspect "${images[@]}" &> /dev/null; then + hardCodedDir='/docker-frozen-images' + if [ -d "$hardCodedDir" ]; then + ( set -x; tar -cC "$hardCodedDir" . | docker load ) + else + dir="$DEST/frozen-images" + # extract the exact "RUN download-frozen-image.sh" line from the Dockerfile itself for consistency + # NOTE: this will fail if either "curl" is not installed or if the Dockerfile is not available/readable + awk ' + $1 == "RUN" && $2 == "./contrib/download-frozen-image.sh" { + for (i = 2; i < NF; i++) + printf ( $i == "'"$hardCodedDir"'" ? "'"$dir"'" : $i ) " "; + print $NF; + if (/\\$/) { + inCont = 1; + next; + } + } + inCont { + print; + if (!/\\$/) { + inCont = 0; + } + } + ' Dockerfile | sh -x + ( set -x; tar -cC "$dir" . | docker load ) + fi +fi diff --git a/hack/make/.ensure-httpserver b/hack/make/.ensure-httpserver new file mode 100644 index 0000000000..38659edaba --- /dev/null +++ b/hack/make/.ensure-httpserver @@ -0,0 +1,15 @@ +#!/bin/bash +set -e + +# Build a Go static web server on top of busybox image +# and compile it for target daemon + +dir="$DEST/httpserver" +mkdir -p "$dir" +( + cd "$dir" + GOOS=linux GOARCH=amd64 go build -o httpserver github.com/docker/docker/contrib/httpserver + cp ../../../../contrib/httpserver/Dockerfile . + docker build -qt httpserver . > /dev/null +) +rm -rf "$dir" diff --git a/hack/make/.go-autogen b/hack/make/.go-autogen new file mode 100644 index 0000000000..52e2f571d8 --- /dev/null +++ b/hack/make/.go-autogen @@ -0,0 +1,54 @@ +#!/bin/bash + +rm -rf autogen + +mkdir -p autogen/dockerversion +cat > autogen/dockerversion/dockerversion.go < autogen/winresources/resources.go < /dev/null +fi diff --git a/hack/make/.go-compile-test-dir b/hack/make/.go-compile-test-dir new file mode 100755 index 0000000000..2cddaeeac7 --- /dev/null +++ b/hack/make/.go-compile-test-dir @@ -0,0 +1,39 @@ +#!/bin/bash +set -e + +# Compile phase run by parallel in test-unit. No support for coverpkg + +dir=$1 +in_file="$dir/$(basename "$dir").test" +out_file="$DEST/precompiled/$dir.test" +# we want to use binary_extension() here, but we can't because it's in main.sh and this file gets re-execed +if [ "$(go env GOOS)" = 'windows' ]; then + in_file+='.exe' + out_file+='.exe' +fi +testcover=() +if [ "$HAVE_GO_TEST_COVER" ]; then + # if our current go install has -cover, we want to use it :) + mkdir -p "$DEST/coverprofiles" + coverprofile="docker${dir#.}" + coverprofile="$DEST/coverprofiles/${coverprofile//\//-}" + testcover=( -cover -coverprofile "$coverprofile" ) # missing $coverpkg +fi +if [ "$BUILDFLAGS_FILE" ]; then + readarray -t BUILDFLAGS < "$BUILDFLAGS_FILE" +fi + +if [[ "$(go version)" =~ "gccgo" ]]; then + GCCGOFLAGS="-gccgoflags= -lpthread -ldl " +fi + +if ! ( + cd "$dir" + go test "${testcover[@]}" "$GCCGOFLAGS" -ldflags "$LDFLAGS" "${BUILDFLAGS[@]}" $TESTFLAGS -c +); then + exit 1 +fi + +mkdir -p "$(dirname "$out_file")" +mv "$in_file" "$out_file" +echo "Precompiled: ${DOCKER_PKG}${dir#.}" diff --git a/hack/make/.integration-daemon-setup b/hack/make/.integration-daemon-setup new file mode 100644 index 0000000000..ab9d45c32c --- /dev/null +++ b/hack/make/.integration-daemon-setup @@ -0,0 +1,5 @@ +#!/bin/bash + +bundle .ensure-emptyfs +bundle .ensure-frozen-images +bundle .ensure-httpserver diff --git a/hack/make/.integration-daemon-start b/hack/make/.integration-daemon-start new file mode 100644 index 0000000000..0882d510ee --- /dev/null +++ b/hack/make/.integration-daemon-start @@ -0,0 +1,80 @@ +#!/bin/bash + +# see test-integration-cli for example usage of this script + +export PATH="$ABS_DEST/../binary:$ABS_DEST/../dynbinary:$ABS_DEST/../gccgo:$ABS_DEST/../dyngccgo:$PATH" + +if ! command -v docker &> /dev/null; then + echo >&2 'error: binary or dynbinary must be run before .integration-daemon-start' + false +fi + +# intentionally open a couple bogus file descriptors to help test that they get scrubbed in containers +exec 41>&1 42>&2 + +export DOCKER_GRAPHDRIVER=${DOCKER_GRAPHDRIVER:-vfs} +export DOCKER_EXECDRIVER=${DOCKER_EXECDRIVER:-native} +export DOCKER_USERLANDPROXY=${DOCKER_USERLANDPROXY:-true} + +# example usage: DOCKER_STORAGE_OPTS="dm.basesize=20G,dm.loopdatasize=200G" +storage_params="" +if [ -n "$DOCKER_STORAGE_OPTS" ]; then + IFS=',' + for i in ${DOCKER_STORAGE_OPTS}; do + storage_params="--storage-opt $i $storage_params" + done + unset IFS +fi + +# example usage: DOCKER_STORAGE_OPTS="dm.basesize=20G,dm.loopdatasize=200G" +extra_params="" +if [ "$DOCKER_REMAP_ROOT" ]; then + extra_params="--userns-remap $DOCKER_REMAP_ROOT" +fi + +if [ -z "$DOCKER_TEST_HOST" ]; then + # Start apparmor if it is enabled + if [ -e "/sys/module/apparmor/parameters/enabled" ] && [ "$(cat /sys/module/apparmor/parameters/enabled)" == "Y" ]; then + # reset container variable so apparmor profile is applied to process + # see https://github.com/docker/libcontainer/blob/master/apparmor/apparmor.go#L16 + export container="" + ( + set -x + /etc/init.d/apparmor start + ) + fi + + export DOCKER_HOST="unix://$(cd "$DEST" && pwd)/docker.sock" # "pwd" tricks to make sure $DEST is an absolute path, not a relative one + ( set -x; exec \ + docker daemon --debug \ + --host "$DOCKER_HOST" \ + --storage-driver "$DOCKER_GRAPHDRIVER" \ + --exec-driver "$DOCKER_EXECDRIVER" \ + --pidfile "$DEST/docker.pid" \ + --userland-proxy="$DOCKER_USERLANDPROXY" \ + $storage_params \ + $extra_params \ + &> "$DEST/docker.log" + ) & + # make sure that if the script exits unexpectedly, we stop this daemon we just started + trap 'bundle .integration-daemon-stop' EXIT +else + export DOCKER_HOST="$DOCKER_TEST_HOST" +fi + +# give it a little time to come up so it's "ready" +tries=30 +while ! docker version &> /dev/null; do + (( tries-- )) + if [ $tries -le 0 ]; then + if [ -z "$DOCKER_HOST" ]; then + echo >&2 "error: daemon failed to start" + echo >&2 " check $DEST/docker.log for details" + else + echo >&2 "error: daemon at $DOCKER_HOST fails to 'docker version':" + docker version >&2 || true + fi + false + fi + sleep 2 +done diff --git a/hack/make/.integration-daemon-stop b/hack/make/.integration-daemon-stop new file mode 100644 index 0000000000..a72f1810bc --- /dev/null +++ b/hack/make/.integration-daemon-stop @@ -0,0 +1,21 @@ +#!/bin/bash + +trap - EXIT # reset EXIT trap applied in .integration-daemon-start + +for pidFile in $(find "$DEST" -name docker.pid); do + pid=$(set -x; cat "$pidFile") + ( set -x; kill "$pid" ) + if ! wait "$pid"; then + echo >&2 "warning: PID $pid from $pidFile had a nonzero exit code" + fi +done + +if [ -z "$DOCKER_TEST_HOST" ]; then + # Stop apparmor if it is enabled + if [ -e "/sys/module/apparmor/parameters/enabled" ] && [ "$(cat /sys/module/apparmor/parameters/enabled)" == "Y" ]; then + ( + set -x + /etc/init.d/apparmor stop + ) + fi +fi diff --git a/hack/make/.resources-windows/docker.exe.manifest b/hack/make/.resources-windows/docker.exe.manifest new file mode 100644 index 0000000000..674bc9422b --- /dev/null +++ b/hack/make/.resources-windows/docker.exe.manifest @@ -0,0 +1,18 @@ + + + Docker + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/hack/make/.resources-windows/docker.ico b/hack/make/.resources-windows/docker.ico new file mode 100644 index 0000000000000000000000000000000000000000..c6506ec8dbd8e295d98a084412e9d2c358a6ba39 GIT binary patch literal 370070 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

-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

{U$3Iv~D8^4{;l+zqdvpkHAO zb~)yJ=3?A$KF0X0b3$7EfcYM4jJqxq82vEP&pFsC5; z`N{BGfidlG!6)rmWsPU}yg*)Hd)_}|ta<>=fnw}B1^G`w-mbuWfbR=-FCNIBk01I7 zBGSe_A>smz@h`~^HuxH2o>tJuY|JH5o;3Hu*P6hs1#p=$&dmEAP|aRXrduh^M;ZT= z(*nhqxM)Lj63BlxbiNe%FG}&zo&&uv1Akvr+MqS{3i)z3s0GcNV9zO2ij(c#OdGQE zx=8mAb0L2n;6s%8aOD3g$FmmmIAbZD%pi4n*G&`iA4=?V(YmhR zUv*<1hU*x5p#972F}^#I(yT}{yx0=nn=!yYM< z0PLIB`8#?JWBiTgfjZcz|Gn~hkiR@u3fdm%2Jktv2R-+{7EXEqXdLs2>i2(5Pk(25 zXmsJBE|{`0jFdg}x9CI%Eq%Yd_y zi^eHvSi%IT8K-!p-VqNzqYLMhh-c!KiCE+LNcBH6HAu`kAA6US^xp;Fth6TjzG>kb z8)rJSMH^sktgfsAd^g{7?W>dXTK?SSvP%8@OPTh$=cCRi?C4XBZ{`aj ztHng{uqbSuq8+8>I=`)Q=+Ge|zDYSh@y;Tr_9{Vncz192)R?a>oeCa#G0v?S*1KWN zqKhceH#7d17RNXU?@}5;D{J3}^Cop|rZk$|ddK3HU;C|AvhejnRfv;;z}pxc5L4+pN|+M{xqdmi{6&+4G48^mS=E_+ zJqlAjOv{6v&C8SbnwKBmVO|#I()~)Nw^{Mgon}(lhBjvhy!@(pmmZ^g5ijz^*jr*j zoX*=hK{~5%AL%;(a-`nE%MmRX-a2Z!FfUZK>QY3Dmlzw_tTeLSx;$U4GZ+1Y@8xG_ zPwvUTDGu!x+Me)K{xdVE<-*J$gGE`v20vv4=+8K^M|ky&moDEou{gBrt_uOr?>PCZ z@Mb}Nrs+W4r)0qRRW|&7GUmVlv%S#dMr=2;Vn88wB6Dz`d%HIt`@$JCN0`#sr zLEj~S;!XMPEdI^h2te4?+VHw@{||kfaxDM= literal 0 HcmV?d00001 diff --git a/hack/make/.resources-windows/docker.png b/hack/make/.resources-windows/docker.png new file mode 100644 index 0000000000000000000000000000000000000000..88df0b66dfcf0b298de8cd296b793b9220c4a914 GIT binary patch literal 658195 zcmeI52VfLM-^S;9dgxUo6akTtgq{#WZz3H8tb`;KDWNHduM$KQ)K9@e6$LBOqzFor zPy}pLL3-~cKzhILKbJeW9LeSS?%qA4!|l#a{mo{dow~Dn_2}&HQ^kid=HInThdzwS zW^?PMCYOZm&Hknz@3CD5O<>HoEVnYY@QX@}`ScvozJ0G=!{aB$PZ%CQHmGa+_CaIE z#}6GbDvq(qCl~h}*01l43av8Ernc)gGvTvt@qNmB1@&q7K|;AXb?VpfF7@=x8cR=< z@4cgR$BxRX`?(x#+r|;dp=fdTNZKnCu9?MF3t&goSA+MH| z`BcqB&2LOL`G~IHd8)o_dRRVNtUp9 zex1H-iINTeD`vSW5tgtxbHN)j_WWlx%FC9_VL@f%W_Do1Te6i0o_)U~ z8yL#U4eho&oE;BlpqF@?FQg{8(u3nKPbb$~V~HeYI*$X74OuQdM06R8F3A~)3z?>Oywui$Z-0RtL7UT=Tbicghm7A=on*rwsm*B4Z7G_6VC z`4p;$C3DJCX;bnh?+;kLe}A)&HU_*Ld~>^6TXV>eOZit0tQgydu?rL5I+WiaWPO!{ zmgMrFMfnVXSz{s#;jVywfGY4z8%t(v-{QiDYGV>?u*clhQGZuU;Q+PinQE7i^?HsP`HgP&aacDs7- z{fq zYklNZalwqt8auiu%Y0Bf=#QD@de`hWr)ih4KJWJn>ffbWa;x$3@b_Nmw0Ta;eXP;j zx$kc69QN6?b-i2t>$jo(re)2mywmAx--EFe!xnyAVacL{ceJBuN_=5Jn-bl zQSJAJCSI?kX}o(>Xv00b+O2KT!28pfzt+}V>9=A}l{L?~XxyvY^LmHz|G6yScaGo!&d^*8Fr?x1Z~5E}gZz(vU`B?+xtI zpw_W6AD0a&^~TKhyPMZ8Gpl{0x|?RpyRQAV-{CTcI~^X=r`C-IKQ3z0rAn<&|2P>t za-Ampvj#y=?VE9V@#S5Y8(*$^xkmEyK8uI68TV~w-;4G7{Q1h$m9Lb#(&UOdZhoV- z{l8h*=ghLD{Yp3e__=ngmTv6xQ}6edm2L9s!tj5lSLoX9yH#I*ex%Cqio-KT{B(Wd z=F(?Af4s-Mg98r#b))n3dDj)Gll=VOEkAwl%whE^FRG-eG_3NZNG$LE@0Xul?%O}5|6lz+{_&;0 zZ?5jtzj5D7KYIT=cSZl@i+kPbTea`7A6qVaZ~3rg@%>tV`_`bmS?WQ%p4rv2{kOfB ztbO^?);&SKF_qU(Zct;S|B82Coz`@Bowfg*_}^>wx6IG0w&jCX%YR%N-oEkEjR&mn zlk(Zn)|yN6$7Oyov4{7ydOyrddF%bNAEk}?L6$`{i?;+`kv@}<_Di2Ds*oZk+!ir0rvVNSgoUZ!aZ$`Aqx|XJ6lTE&H)IL-P9Njn4idt+U@i^?JYB>QjFED@Fd^ zbXzEnOg%A2}VE^Y{T;FNc;#E%^+p=oQ52b(D)Z^10E51B7 zY}cCm8~@n&<1dxhTsf{jwR+>|jc-N|8&YxDFTbzemGtShPv6}9=Ktlj()ho3B49Im;pg$?BA$&nyKw&(Nv+@fJ$3GlkYNK4lsa&{@uiJr|9W!wh{b&u9qBx*;;>B< zrl-vOU{<%c|7tids^Oxld(Q0JcKPXvY2#kJFy(OC;zjEh?Yy(>)K5vxl13!GclxWp zn|$@;mxCHlIJj$H`}4i89BS?R)#srj&#io`XZxPhhHbc3DQ~p>m*@qt{#4j~&!RUyc4?*IRydXS_FKz`LzK8as1fl|y0knoc@&y8VQ69kM&j?QnL{ zu&|!tKLtPCw0_j`hOb1PY`(e4=GJ=}4juIO(SeHxb{*C2vG9iVS2r6o>bG;bcT(QF zxcH*)r8g?h583zP*w>ft-pQFM99A>rP_sibkGFrJ{^LE8yVUPK<&)cUwl;me_V10qYj9=LJ9U4Yz4aOYXU;5& z__D&n*MdejY8A09Z2Bj2W{+#Pyhis=Hx9cw?CQ|h{#qF~V_p95V?OvL7r3 zJ3aYI)%W86+`i!SXFvbAV)v%l149oFy>azy@R!dA%w0b3>b!t4{wGfU?0@drpYNol zcRUp`@1J_7woKpHe$zMGBY)i*_ro9i|7qE}-?#lz`(^iQmUQ^chUot?#~ezk`o`Au zCby5CdVXt0Ueq7Io$4>^-~H&&qj5Q1bJl0HUOj91jm)_@qhDOrWAwN?dliQjd74@Q z8~@w%@6l?9TlMSn@v*0Fbq?5D{kQzZcP9n=H}miRe_!mmSZi#D*Dv45@IIIExPQdS z*FJn>aSHBRxRX}b_R>Q2*gHL_E@r`RS`_H`+7=L$jsfia3chr7xt>xC1 z`(H@@bz<_mQ&-9k_;tX-pCVo!eRJZ?$ox-_^xV7Ui!BRRZ+c<;0}ANvpQ@-1>5An>%e! zv_JFS(bmuBpFV!~^wd`pCoM@ibh>kfddBnv`E$}f4s5Ubc)`biz3cz(tuI?dg@<2k zJwES7?how`#2%>gWySoj^Z#01u|mjOnMZH^xBt-mLrdo+&---y=>L6}cQf%;<)2RN z*}3QO-~O1~IP9g=XLIiCm~?tlwY%S(3+#FMe?e30X@_U6P3wE`hn!C&auIV@AeJ3>p$QY{ZyW zHSccOUNdM!Y^$0BnsyKEKDK?_@DW|6jF0O(rANP*DI;UTV{5jK@`;=rK@p6On;0E5 zdGx3;6Cx(Js;P@Nf{wX!NX;Ofmx&`=)ojZX3>w(IS5W)-@o_;-8#WD&32hV>)I7Xl zSktD>n>T6@)F?EpNl0i|NLb_Gu<(c`O(H@=gY>3mln)(6j*lH0(WgTveR6cxs^;*C z6URn`giM+=so|u?4dcfT3keGk4-W}#6w;_sF!>0c@cNjE(UXJ6OsG{5i6Nd2aT8+3 zj~F{~MEsZ_9&hxJ_*W;ks#%jK^uXxLHG1rWgvLzJvm=TjlcUFmgf$EeDJD?&?&gDy z9$jR}2@^ZMMmf=!tjGi>^m~15Tu7g|3GuIvkBRH}THKh4wTj9_Y|Mjr#=bg!l#Wkq zOi0|QxX~130%bm|$SjOCv_KvNFO-c3my0d^#1TUuR!*U?{7SLG;wFzMCK$g`5KMO~ z6x2{8-G347$Hzraj33`GK7LeG!Cm&S{Y1?tepdz6>mD65VhnFoJsBBd8t7q-Ka4M~ zL-fSBC<@y&IJ8-CXybliP3d-wXiCS;>A)zG0-q*vbf>#NHhN;TC9xFpYZ^~{?1-VS zTNKMfpM~S--aVr0mVQ}ie!KfElllvvZD zEt-T6iES1f8yhn;xJhX2kl^r`A+f>H;mu>CW1EFGj*X5sl%4`$ z(cPwd_VkS#SJ>5XVbloSGh}S^_z7|RPqS4`!{6qEht7j%3J;_E6OV|F;ZL8a7=8oC z#YTn{a($Ss2O;&rMm$=bmLVvJ-za$TX-pa(H^$uUUl5hfSMiZdh#xv}QuO$^w!`QS zvFvZNAl||OO%sR=;m_+)Bb-nb6QW>Vq0zHVrz+d{E=dra>Qu>_2A2#3*|9>oRKM zY!r&?afA+PUwUD@Kt!OQC-kC6w@TSp!|ERrK*HHiy}m;f<<3S8#-m|O)e6CmbK zfy+D}ldHgG0>u0&aGB?0auv8tfS5l8F7td$t^$_{5c8+NWuA}8Rp2rKV*V7k%=0n1 z3S1^Y%%1|6c|Imrfy)Gl`BUIB&&T8{aG3xxe+pdY`IuY3XxXkl0xe8n+K+K;4mw7%W zSAoj}i1}0CGSA24DsY(qF@FkN=J}Xh1uhdH=1+mkJRg&*z-0o&{3&pm=VNjexJ-bU zKQ)WX=izeDxG}T_bP_H0%;}f-4=of8is{m)J7ZIxpj}L+GnS>L-y4j*8p_zs!L-J7 zK4TT*KY980PR#rF?5-W!_M0qYTJj{*@_%7K00ck)1VF$_0&*+;!#fCo00@8p200hJ)YzPDbAOHd&00F^000JNY0w7=$0SJgq*boQ= zKmY_l00M%000ck)1VF$h0uT_Juptl#fB*=900ad000@8p2!Mc11Rx+bVM8Dg009sH z0SE~00T2KI5C8$22tYt=!iGQ~00JNY0uT_~10VnbAOHe35rBZ$gbjf}00ck)1Rx-| z2S5M>KmY`6A^-ug2^#`|00@8p2tYt^4}bs&fB*>CL;wO}6E*|_0T2KI5P*Q-9smIl z009uNi2ww|CTs`<0w4eaAOHcuJpckA00JOj69EW_P1q0!1V8`;KmY=QdjJGL00i8N zfGi<@s_RMw6>%MFqyz#W00M4B00QDx)rrD@00@A9>j*$VT*n$IfdB}AfLjrOfVfq4 zqA(x;0wCZz0uT__u|`TD00JQ3Rs_1jKc$krD`i00_7h0SJg& zRVNAq0w4eat|I^eaUE-<1Ogxc0&YbB0^(NHiNb&Y2!Md=2tYtw#~LYt00@A9TM>YO zxK(wcFdzT|AmBOz5D?d~MoJ(60wCa41Rx-8Rh=jd2!H?xxQ+k>#C5EZ5(t0*2)Gpi z2#8x%Ckg`sAOHfcBLD$$9c!cn0w4eaZbbkB;#Sp(!hiq>fPm`=KtNo_8YzJQ2!McF z5rBZWRdu2;AOHd&;5q^j5ZAFrO2rUJ&`vGp3YKtP-XARywb7vu^AKmY_pPXGcU`YJ*OK>!3mK%4|1 zAmXeSKtP-Xl-6WRCX-p?9ezPT^aQH!Od3L&3~+Hq zzq=4s=9Y`oL~H4(!v2uOs$Ta?f0F3xKrr3V3VF?1y7cmn9c zay(PS2m&Ag0vP%AOHd&U=sldh)viK2n0X?1V8`+f_nf2KmY_lz$O9^5Sy?e5D0((2!H?t1or?4 zfB*=9fK3D-AU0t`AP@in5C8!P2<`z8009sH0hKp+4DAOHdo5ZnVG00JNY z0yYtVfY^i$fj|HRKmY_FAh-uW00ck)1Z*Mz0kH`i0)YSsfB*v)C^@f`AkVRNt9&p7L3pY#Q0yWR+yAlI4FG7s+x{iL8d~Ewbrk{m7Ojn?d#_ zS#Ee7+*~1>OSTMIf3o+<-XrTpwjx<>!Y)LWIaqLre?dSv0@ghLi^?VcV}Sty5Ma!g zAaH9i{B6k~3I@0Gh6DYtcM*QL_!yf&I^h-u1l*1Q1jOyC)L{im&`xz&T%wO?CFQW3 zi*uRe;`ERl2sniR`mvmX6_J7f2!Me23E10@g^_ge*D-Pk0w4eaq9gzT5oNU?Qy>5W zARvAM5D@X#5poCuAOHfQB!H20QC5qSGqv(?BBjvU$*Gt|-<$PoxW?c}b7*_f@lS?x z7ya&_IkasGrM2?#c{(?pa#hHS6Hda21?KWP0W6|)EdjJZT+17&fdB}AfZGs23&d@z z(x!r3pioQ5@|A9r$Z|8S;D_-RLI~MSWcQH`BKtDg8)WB`!W+`uK>-rU8p87xd9%rKGn_16mA91ad9p3Yb|z~`lMdNb{tua1 zWHZSQCRo0$1?2cpW2tYur;|1R!00I&sK!fITAEolmqOvR_#{iXP zB#Fq}qOQZOWC9S7k{Q7V2!Mb@2~fAycomI%n9Dwi$OwptIYPx>gMbvz23J4;1SC#C zqfkt=qzF0@S$BDcC4S-OApr=;Ll!s!0T6H_0yOg~ipD++U-BxkWd3UP6dErXUZO{M zct8LG@&E-6KmY{XiGWfrpJGjU_`o_%^_@#od|O)+&XfH@Ks>qjQFah;V*+Z0!s-Qs ze5$XnQoV@=-wVy!a$`((6%7Jn7d`|A0T2))0cu6Gphbhm-zl~@n<}|nL+eKVvN(VT zdxU^^aOI=uAmFY96f$|7J!SJ&D63Xje`UEnad<*l2#6=tGRg=79!7vxn_JU;m7q0j zg=xykPo?fp&6!@N?l^x)04nm31&%-f1l)uGEdU9!wBu8>P>HQPJeZ<;*yJxb=PA_Y|Bz{>_fxOnl$Ft+^HV>)TMu#z zrDJZnsjc_(c)@9j|MsZ9Gl_>aq!~)*gX!E5-cNtdBPzrHA=8E2g6OvyKOs}w$WMU_ zW6zOWI-OK9IGFi0I)t2Qd9A$&V>jV%Sa~>+O5y4cAM|GZ8m=+WqX&C0I{wLU?xNov z7oy6vDU{aA!{_O|dLcLGpM(*MgU(OJGgGMk%Z(hROzyOoWB$avmzDW=QqO9aq)ynH z=YLUUMHg04RNw{zARt)+^iG`T%*^xGXxg!Hj5E`aO59FUX{iA4(0o2a<#u)5r*)qvSe||dp!^`< zW(2BkxORhPOI2`Yv9j~>QZ99?6yVG>ToE_Auv|eIX@CF-NQOYZR_pW@9u1`XO9qG& zGwSN5yAz9os6hY(K!7n4kSosSz$X;ZdJw}*J7*^++W1}F4=!2|F3H%+!+bjEaF?X@ zFp+yS<7f86Q<`#AFhw@V*v$pU%V-AF@dxRwJj|!H4t#L#nuGJiVu^85#9}O+moj#9 z!SQ@zas5F$D-XAz<1P=*U2|~IcvhTil5|Zf`AmD1Qi^hRYNR2}DUD;!PDjk~LqJ?x zJ6u4fx;9C6fzm4^Aap*MtgEN-9;7rM3J7CdKwQmY2c@}$tg+z&Qr+0W1;=YBjfVol z7#9#%vsg-L@_e|Rp%%yMLy;}{vpK1DY(;Mo(QJ6z|KW_U&tNgCzRobF7 zmY?)y%TGp<9YOYUvRlcXB%4X$lgVBn%j@NUk>&kk7s;lPzq@3Qko}2l0@=P~d6$OZ z2F(z`s{k1Q0T6IBft>vOQ!2TFFZ6Mm(K1H=7h#s4iHQ6w-_B?BO6NTFb zWP6bstiCSAl00w5q50U8JSpSGBBZhJFz zH!G8+=em5%+S+WNrT`194P=df2#7Vb;1>iyKr#fV8|y+wZZ4mxc~9M`Vw{{Bh8UfIxDWFBp#cc6}cf^2#A3M zen9{P+>XGV9@W-UE99ah3P$^+uxsgQe8)ydMCZ&n&Qs)Lotc0kZU~5h1b#sP1l*E9 zR(|dfM?CU*%Y(N-L~i)N%m8YA+;c@fAt0`xj5I(11Oy{Mt&nXrZt;gb8Mu>~A%#J6 zUc{j!9)H?XR%^mSK&+t!zaRhtk|aQ%5$r-!ZfzP+PR`C^_pX$MuXm(jDW>TCNF}U-cfZLOJEEF;`5D+2hBW(}>0YL~{f2K+}b!YujRN^->(phF+Zc&%S z;sRH_SJ3S|}J1o>3m`!r=&geHaZ#6MU3l$gYWb3zM* zQ-A>h5D+1O1g*nIhpFiyr>4jEq#y%iOjfASDb)1fD+Wbo_(#*{k^PX=qNauN+LAd)Z;5J^-MG6@18 zU=0Bhj*2R|d?^V>C%H^kly)%M?_IaxLo3V{yH}_@yUA`Pn@FO;zW^mUBeMoxG4&w1 zLJOARm4`zq?F0JsdDE0n81y2mA}T_%T4bKQDxQ?9MZol5BH*ff6|{D!W+`$>G5<8 z;rR<9?+@mNv*C;k{5U(Ft|3i2e87T-;bD0mcw9S(MH~8kV2H(eI;l?95WXn>hVZ;h z+@G4PH(6ePhAswE{`@-kXDEw-A33owVsVfk=*-H)W9j!}{h1-pw$!S#N?Hob(^|CP<01j#ag`&>8Cz=j-x6Q6ab9oF z(C;C#2gNd`Va@ZO^8JY6H#Lkf1o#8O*zku9x5mcsP%^mjhZ462!yk&KehlJc@MG?` zsPLxo@jn>jKN|jrWa`Ht5{9(6aGClsTr29=G&~mtZViTulxcjX{EAA`Ac}@~%>5P> z-ZV`vaK?uJ{h0bO|VlgZxW3)CHRr-WprUlw(5{^5C8#72$WrWDNG@k zk5bCyok%nuvqm%w@fUoPHq~13xJKcBHpGG7M+u+{>rp0f0Ra#YkN~wZno}#|1zPmi zhFTg=(4e^Sc$n2WGl)l)^_yHRrq&0aC;?Lp0SHJjVBib_AmCgABoq~CyqnLKicl~a zZ)MaW!6-xGVLC8vb4Co}VZ#oIeDIu)kHMHB;JE^_{A6X~(%cN2M=k}bH8p9bNBKuC zzySn6;86lHR+_d9QPZ5La%9WUGJrr5i?U<`6f(KDBZcD8#A&{{{=*(NhzE~uGqpa> z6%{Ys9un|e0b#5yVfgMLijt2s3MKPbna;E=IUIa|00_92fSuyOGyAb?b1co&9M)8n zVDZaJFwe*`2!KEd1RNk9$0&)-B_xB(M8J~;qyp{$5C8%9BH#e=;6P?m_Z1%lfhmE2 zCwF0)t{5%>6)uAS2#A@0jq5y2i*%bDzBP5kdC>$sSwJjWxmq+fxPkx(h>3u1dlFh< z&NoQ3)6ApR2j6oJ#sUJKEFi{vN?Cx4dqJz#LQwDq0xl!KH%8=pTk&5z4c~syP^PYl7`i9;m#;`c=x_l$eMm@!5K-}6{p#oH91VF%Y0;xIK zy5@)3KT6A^<34#4GUrW@qCOZS7(;p%@-M#qNS6PK)`&tt z_O4%bl?ZhwyNbZMsyV_x9cGoW@Ee#`#R<=a324q9WTn=9!erT=H=RFV}aHD5lOG=l2c5_1wkIklzdbyMAP{oUB4wm1m~1 z(rf;YrH6H9X-&E^t;*0yFXYXwPxt~4E*^#@=7HBvv08gpk$BKOlXRJ#iRjPLO7l-M z*lhUH^RqUGc2Gci&hb{p+hoU+HGQdnj@*7HD@r5yhtUaM4I*=tY;jFB-Um2|?Dr%j zyfy0>v;5>Nis&_KBdg{Y!05vu76;?qFus5P!o2@Yq^}ehJs{68%cS0~bf$Ri(aktiDhOxnCo^q+xua3K?Q^W@&WTivP~_Zz(s~n zwOc_j^DOXh-plfnQ^>;%^PV2PTFKj&`C9N{5apdK%=_?m=5_K9#vhi&8Quy>i5kfA z0?QZY#jV^G$+vYaFz=(gtRLf`2L=~h{zjhf6DUb8^7Q-6_n%GlLa~EhD6G4U^Syjo z=2NX$#*;1G`hH2HzZcz1D{Ap;Qt#@7qx6*%#nyK|eXQqpjZk)-1lEcc$(tk|f=u0| z=N@lm^d-xmL7~MK?BNC8trh8vo*2mr2tni@y za{3?Y=eNIKUrP^+%zEK0qhVW?Tc(O6=qQt}G4CUZI`NcI7mU3or*bWpRjV<}su{}i z{L9!IooK?}rGfG!nr+2}qso7~Sw;Q=W`)ouR|wLHNfN!7<#_oOSFY=Hfww-K(KTLN znv9-#{APWL>~ONxi}hIah27-bkDhrqioR@{t0V=4KyuOenyj@DjVbZ&tVFV0gnlNl z=jqpSv;1T?^8B;q0SbKb&k|OkR*23}pS|+dC8oY|lBqBLtNXQY4!?|LS8u>F>a}3m zK@BC_UBUbFxlpJtpCB$r8E=g_%j8t4%`)q@V41ZVF|Ec`Gr%n?4WEkab$UNdn%GAJ z;#Ry+SQh;QU%6$gvg~U0$<||BShT95UvM4-5a9v;W4@hwkEzZdVdc;4XQeM6Cl~H& zqoFUZ->+DM-K$!UCDU&jy=d?*FTEK`;<3nZ;>=%q*70W?f7bLN+m`HuOwh5l<}w9% zk)Cyl)&?xjzoZ0&U_MR-nMQVSaRsu&{S1XoB)f;~-(>$I(8a&%EkD_W{QO1MLc^QW z_gJa>H(15gJ2Xq^0zD*8(Ru~mMd^6M2Til9Jz4Nzp#J~7QWYGZhy!Be-E+!2mvutQ zCkUv>DsR($ZZaV5fTYYvL9Mv#s&!Zv2`}fCSGtmU|4zEfXH==_;ioxwm_*|wlR0L# zkmb3h2WM`%$5>AJ>MXZ>HL{Ph+_H~}_GN@m-Bw=yk7>^yW&y-YPHSPDVe;tjDY-%o zmKjj)TBYNAM#;4KhbW!1^o+1Wr3&Yio^MKWsZX{s*$A?&$krw6Xv1H=-=w@>v^Qc& z2nc~~Km{F5Hkz!fMgemvE#6(pciZXi8S2VY-nmLI8N`gHY74y9 zCzW!4mh2_H=`7t-VS!Zb45j4hUb8ySwRCw3a6J%?Xb=C8YzZ@?i z`xyzzVfwYnh*m&IG+T(z$;4k&I1}#1?-|{FLt{=_dePGI$s=<9lC3wy#d!KL=OO33_%FYI_=g9!B}!p6ltcQzd#MQDkmVDMteRCODghzUXh?;4T5ow1&hq)L@Ko9NKlTO zX33=j649d{UslfthFa@?c^@DQ2!H?xfPnZ3+@dV*Buk5sbfR)-&$^X%O(GC0`cr8pj^Ji*80}w@JU`UAOHep3D9ct{L~C##Dizd+h;Gt!)y)Nb=ww-=9x^T;&Z*NHrkv#n}o;egb)A(BuGG;MO{`Yv{Q)j2BNMmhmX%lHX`D#tCRJl z^gLTYcugynd?Ard2HjXTVM8FP6G+fbHD3fnzg4;bgC52?^Y#6k4G;gq*a^puCjb>u zD7V{+Rhx~$5L?+Hocj^r{Z@I&X-x39E0rpXX}mhRA7Sy82m+!|EU~p(bblx|45HYY z9>RfuSPAfHRt5c5)(TQ%2xIC#JUiw%;>`6p%?IVCO5CgwC+i$Y0EStYht_Y-WXv%2-4+aF>kpORXq|;c37-t^( z`0in&TH(79Hr#g@1F->GkwH}IUy5|M&@mrlAr_K?H>nZevki6AbHykg8ch;YtJ_MA zsk`JCU08;iRHb zy24DBqWHML4FY0-9M|k5y~$YhNiRcC-7o)RqisiFK)@XcXtQaC6(8#mW2=J$=IcFt z{bFgi#FOs8TdHM%fEd@DT5Z?9&wN^=DBskK%ZOtTFh_u|>)>1H@|_UHGQ+B<{QCMW zrL9Vq7Ig`3t|Nd!bYs?E{8f(KyL*#%fwOruT&7krxv!UTtR8pF;XPT}o7MK$Fn_gz zC1>Zc6ZbRONwP5FC7}Co2X94-SvWX8AKK??RI8@qB`KYp**l010Wq!XPj?<=8R_*+ zovk^S(-)^?9{9y6Idv=as$Pl>t5=>?^nP@8{)N_%*Q8)4GX_1h3rZpj}Q=N)Y9zj$t*j|-=3&FX^$)gwLBKJ3Sy1Q7KrA) zJ$u>4pEt1U*RJUhDwRq$>5VC@dQkNTNVi>0W)uIogqFwyBCb8)qM`fFtk}D&3|JJ3 zJQ_3)r*V(J3{Lp9pMbprfOiCUvM6V3+;o4OVx0PDO(87w`+V&(55(h}B}>_t zi@tau9z2RR?b;O*5AN2!N&xFxEs!6=xR8MEQ-SogC%!09^kW?cE^@h+`T4&9@h|`p z&o2a|sJc)nCe!yY?c3mrcMs4UdUrQ!T74f=r(gm9j_rwT*N&Z!6uE4%L&wm0<*Ij0bcldEF0SHJ@y!rQTy?uTv>XJ2X zy1_{|UmMc2ye|u+nO3|hykY&%MdIOITDkNgd4oB6l`-5>y$FI}P; z(07ZB>B9N*?7itT*oJlMb=_N^d_0@+0d{VlEahEf7&zKbz_9V5q{cdoi|yzC6@A!z zvau76#YI3VuIz{?H$$5zvAMf9u+&t$KTgBD4io`2z|5QDZf4483T~m~`^jcYcIo0p z#;w8JCjkkd*;%Ei^#bEq0=kwjpIs&87Z+dOpV=!dhd7oDVskVBw{L+YXs6oAOsN`d z_kak`f_{mwow*TZ@O!jUkQ-mWhjVx>$*8X{ZDC9%CC9$;CQH)t7(X;OTDO#3YJ(l7 z73Ax;m5pp=_uHFkv^aM>0k>BXyO8mwh_}yTyW-FX=C6dh=`W6mOhj>#647QmD*U!IjITSgb|RB}Oh5fw>#SN#DwJ$VMD|0zMzrbSJa-W~y#gphBTw9lLb4sAyfEd0OZ1PF61a_inmHVc@9< z0(^Q^dX|3YLkW(On-$Zw) zSxkxHEK&m45X;hvnUi>(Wo1^h)O$((_^yk5_eFOwK1w~{4Yv~xUUWWR7gMe*xCxx&1p?w6u0_ZC z`R=tWEwx9{7j1KOClTQ-k=VNB+4Hr^GL7QVdCO_k-SySU+wAL8w^=q?9wpx}d~lq% zIOq#cZntw7pV#i|_aTYLt0jYg4`&g8fH;e6QSr{-t6>=#Nh~MZvgt-e#ZiQt+*`wB zUg{#Qh`@=uN)$3hhFq!MDpx39q88X=IoTP1(xa`|Wq`gUBrPlYv)Ta~7C?(VcuRwS z5MTB}(`j9d^BPB;mn_xH3T3auHjrbmASirqGjs63Om|=ru&$P zAHCSSa@jg{CCO#-TxwlhlgpLcWD1>N+$*UxszrMpLy$K3RnL;tmQEjVw1WM!miNO>HVMURWfod?E? zs!WaMI#X-HNIb3=bs28bB!F31w$|H%ePJ}M_h))Ady%F2t6CM)<|}9(tDMg5ezKN0 zE~1;oN&ggdIdOHML}j@$nLJY_m*1n~n@lc0M8|6~UJfgIuUs3-?!EM2hup064f!&y zNC$0fD3l9>=r*h3Gpe!+^$NN$2LdGJ>l-MU1eHX zGPNR(()BYmE^);uj8hN2mmY}C&&f{6%ge2zmGdDI7^?_S>yLL+vRq|-0QpA8LE{$FSruPU_yz2qMrxz1K!DAA(Y&}-SPo$3T@2y-vOEb+A)e9tr9MMcLRX*8N!wEa&6&9uTzBk~)-UI8im zq!4*wkv-c9Y(IbXi5)jHMyX`7j+K0r)hl_cyvup3WZoneCG|;F^3|}&ioR_3jWpXc z;Lag+T~ss$m(Qk>@`pGaQAfVMTbN4Sg$Bz#R6QL5Q95y83`9D0^+-s?x{RQjtGGL2F}6Q)X%iASO@Uwvd}g zpK#HjZ<**s!=2Y{SX#;a6P~_)6R68-wxvPfPj~|Mwm={t4ywc7PMr(P%+vlxkLfVJ zO-DwaR!gg{^K)q%ql{c_9=Y-1(_Ff)n?FU{deH1yS-y-$(&^!@n@LNLBsrgL%d^C% zRe961pC3`HK~9UimEN?vPbFt^H3bONC}rjSePtT8>n1~u+k2jEzwW`U5S?i7mIhh= zp?6(PI_L(Hax@yR8_dhA4Ru)^mvS*YG4Bu%5!E`0h|i6Ty!{ou6?I*eE&d%2UoS7_ z3L&{k-=65S$-}y}4c$|Gl{i`&g>P%#s`d5zmiDuHvG4_)NriyD0)p>>IIyPMJy9c_ z#G}!rwA@n;jMi*ad3kv(IW3Ldp%0CxXJ%4+#(A&B6?`;oKn>Gb$7Zu9$%|TI%2$Tx z)2Ctc?xpI!Bnj~_sY;bPmH7vBf_Rv4@vu{LVL73~sU@O5m7H_ri2zj{Cq!>HO8%`4 zwMxajsB4S=I@+YuTX@vQlkW8$4@1`!AJgEi3@3`PqwB*sz69-5<5MRd^QMQ7?^gO$ zXLlMccgW{DotRrhT>=4n-#VcpB>=YdGAW7TU{coKp=C6ow#H#^IQ|h14Jirl<5DRd zH|uWG#UwWApKJDJPq^@0HE7C|ZrT)A4r+G5SU^CnPGR0Y18KlxqXoX5Sx)H+e=#Y9D;@q9$y z8gqkI7LJ* z98?`jWe)T4na+ksOm|R>h(?42ARr>Fl;W~9WYghZ9V>gUuIQ~4QCpyrvpHgg& z2LUBP00JV3YI>N-*iDD(gqGGEu3uWix8s$(IdLzOjoEdX(W*(^_Y7$fWWiUl%=Xuj zXYQYigT8x7cO&b?Lh?|gS^#gKGfb`K!f{ZlML@o-BLD%hj+ZEWPfa|m&SLTtovQi< zi6TRGW@7Exdu+}jfx5En%sYY;0gWb!c0e3S!m$iIJc|GXM8fqQv-$9%-qn0##X2rx z4chnrxz2vQh<)F!VJ5g=l`5Tt<8AtA$1K6~f(!^k00JTicE=?ev-wEJ@N(*nHT~6& zTd3i<>{%RBE{$1C{QVL;d^^M9Fz_f40hKC?gkuiPl6W0k=L%E@B1skkB9e-*CmSE_ zJ?eEmOM9eq72n!shYsvX#06oKv-8-f9T(Z<)NB`|h9s;epd{h&_FBjk%JEpwVKqIs z3;+RfqiTJ5)8WaTD|x?5AMKFLEG<*~H`8<2=$#kYtqiO;Gi4*#xk{bJyfmNDEVeh; z$W~Z(FIYv0FJTCX`0B*29L?HutV~uu+aFocySiNw2^jc7N;Vs}>ms|Cg=dw3)xZbG z@6sZ`59mW3?+Ka@BraM45D?K;jeQv#y7kDIh_afG9`{pOw?y2&WE~dzTyhqhu=^53 z#9>4&jEMJvdU>6uPXoS5!hu;;7Gm>MZx9eSuKBO_pHTmolDoNWMeo)ch4gy0AR;cj zIr(P+y}WkN0>Du;9ru_EQ$|t}CIA7EaOGK=^_lyQH_9z<8>A6%M6wHUS8Tvk8kR{xQG(`&_*M)xvs#YF`m$ ztHi9_&B|qy_grD8Xw^E50|@ZehQ@0jZL9nS8y24EfEW>lhZ2B*cwoi9z30DiK|acN zAM;guNu~H1x%q6y-`CilYj{bvsm}P=hQ{kMZK1q`wttyHp96#%+XNDUj0r$MjA?k# zF@3N~w*5xtq-x&sw`vEdy`@lezWvo#$8NLlPTbLLg(ZbN3!X=f<_-;rucj`lX*9NR zMezI}18zkC0^(NHX^&Y`PA&gG`i^dC+hTBSs9jf6*!%mhv$P!AZ5O660p8M3 ztM8I%Y@%(CXHXZ_zlA;E3*VFU92ri|n?=8~rju;^GLG|f> zU1i4|y%oG60V)0JL_>3px~G0-O64pX3_l~K>?5zzB_LG+NzhJ}E_6xcocg!|cHheU zxQ4ItxvDoK$&ocb0O=|UVntQu~_QC&z`lzrSrDxp%qA0CY zRYVlIbOk`+_1eS$SIa<*{3A^_hDt zPyeMU5oOQ%tjOj0G?;ON`lbFPyPWI_7SjYPVyq{L5Kbfj0dXQ+ca55h$*Gjwc9+s~ z{#VUg(X6(=+MD;qi@}_|pT%a=7pnffBeA{VRjN$tjyg|Mrhcc7|NcmOiEI%APvijv z%n^Wqn4^Ph77-vpDZBetR=iTC9az;{5%id^N+qz6v`~7RNSIg#c3v2kXXoeFc}HP(B|nb%?lC(0VffF zfH(;(qAg6||NcBt>&U(AI6sA~bvcc^R%LHRDVpJ>a>X}!lc*K)_3=Awl1ThP?tik_rdbY43lV{U2nj$yL|7@Fl%;Wr$Eu!7&FSZ( zkTvsD%IXBFWR**)rtnuOWHeyUln!XX+@vp6@ulp)6elFS)xZa@WwKoQ z%_1R4qu={%?W61<00JOj2LT9(9qI5JlQm;Ye9|S-E1Oy@g z0TBp1k_7<}00F5JfPhH729bXd009sXhyVmcAn-^Q1V8`;q)q?=BJ~!3mK51f)&?0wVPqME*el1VBI_ z0uT^^z#~}@009t?IspiX)N2s=2LTWO0f7iWKm-DhWI+G~KtSpQARtn&LF69DM7j00JNY0)h~LfCz#ei3(33K|59WOdtm!AbkQ*5$V?dd5|BF?0XxIq8}K){U& zKtSBMa#1u8009tiCIJYDGwC935C8!XaAN`x5I3$|6b%GG00f*#00QDnx`-PDKmY{X zm;eOCjVl*L0|5{K0cR3`fH;#b;syZ_00B2900D91%0!3m zz>Nt&K-{=;Q8W+$0T6H|0SJgQ=^}0r009tiV*(HmH?CY14Fo^{1e{3#0^&@%h#Lez z00i8a00hL1D;Grr0T2KIXA*#bIFl~o1_2NN0XHT90deEXMbSV21VF%<1Rx;Jq>H#g z00cn5jR`0T6Iw0uT^4u3Qui1V8`;oJjxz;!L`T z+j;^C+NstDLI@B50l^4BMFc~Sgh2oVKtS3AARyANKja<+KmY^;BLD#r3_TJC0T2KI zX%m2eNW1=!dk_Et5D<(21Vk|ONEie_00g8>00JWI`a|wP00cllFai(|!O$aN5C8!X zkTwAbh_veuxd#Cd00F@WKtKdTkAy)01VBLA1Rx;Nu0P}+1V8`;1S0?e5ez*N1_2NN z0cjI}fJnRkkb4jS0T2+300cxZ^hg*4KmY`!O#lKS?fOIRK>!3mKrjLj5W&zRVGsZT z5Rf(j2#B=n54i^c5C8$e2tYstLyv?(00cll+5{jV(yl+`9t1!D1Oy`h0TB#65(WVf z00C(efPhH5{*ZeR00D^-nB6gcvqZCAINMN>!aQ&W0w4eaAYdT@2#AHC;0**o00cmw zFaZciVIDXG0T2KI5U`K{1jIs6@CE`P00JOTm;eN%Fb|x800@8p2v|q}0%9R3cmn|t z009svOaKB>m 1.5.0~rc1 > 1.5.0~git20150128.112847.17e840a > 1.5.0~dev~git20150128.112847.17e840a + fi + + debSource="$(awk -F ': ' '$1 == "Source" { print $2; exit }' hack/make/.build-deb/control)" + debMaintainer="$(awk -F ': ' '$1 == "Maintainer" { print $2; exit }' hack/make/.build-deb/control)" + debDate="$(date --rfc-2822)" + + # if go-md2man is available, pre-generate the man pages + ./man/md2man-all.sh -q || true + # TODO decide if it's worth getting go-md2man in _each_ builder environment to avoid this + + # TODO add a configurable knob for _which_ debs to build so we don't have to modify the file or build all of them every time we need to test + for dir in contrib/builder/deb/*/; do + version="$(basename "$dir")" + suite="${version##*-}" + + image="dockercore/builder-deb:$version" + if ! docker inspect "$image" &> /dev/null; then + ( set -x && docker build -t "$image" "$dir" ) + fi + + mkdir -p "$DEST/$version" + cat > "$DEST/$version/Dockerfile.build" <<-EOF + FROM $image + WORKDIR /usr/src/docker + COPY . /usr/src/docker + EOF + if [ "$DOCKER_EXPERIMENTAL" ]; then + echo 'ENV DOCKER_EXPERIMENTAL 1' >> "$DEST/$version/Dockerfile.build" + fi + cat >> "$DEST/$version/Dockerfile.build" <<-EOF + RUN ln -sfv hack/make/.build-deb debian + RUN { echo '$debSource (${debVersion}-0~${suite}) $suite; urgency=low'; echo; echo ' * Version: $VERSION'; echo; echo " -- $debMaintainer $debDate"; } > debian/changelog && cat >&2 debian/changelog + RUN dpkg-buildpackage -uc -us + EOF + tempImage="docker-temp/build-deb:$version" + ( set -x && docker build -t "$tempImage" -f "$DEST/$version/Dockerfile.build" . ) + docker run --rm "$tempImage" bash -c 'cd .. && tar -c *_*' | tar -xvC "$DEST/$version" + docker rmi "$tempImage" + done + + bundle .integration-daemon-stop +) 2>&1 | tee -a "$DEST/test.log" diff --git a/hack/make/build-rpm b/hack/make/build-rpm new file mode 100644 index 0000000000..cb152226aa --- /dev/null +++ b/hack/make/build-rpm @@ -0,0 +1,93 @@ +#!/bin/bash +set -e + +# subshell so that we can export PATH and TZ without breaking other things +( + export TZ=UTC # make sure our "date" variables are UTC-based + + source "$(dirname "$BASH_SOURCE")/.integration-daemon-start" + + # TODO consider using frozen images for the dockercore/builder-rpm tags + + rpmName=docker-engine + rpmVersion="${VERSION%%-*}" + rpmRelease=1 + + # rpmRelease versioning is as follows + # Docker 1.7.0: version=1.7.0, release=1 + # Docker 1.7.0-rc1: version=1.7.0, release=0.1.rc1 + # Docker 1.7.0-dev nightly: version=1.7.0, release=0.0.YYYYMMDD.HHMMSS.gitHASH + + # if we have a "-rc*" suffix, set appropriate release + if [[ "$VERSION" == *-rc* ]]; then + rcVersion=${VERSION#*-rc} + rpmRelease="0.${rcVersion}.rc${rcVersion}" + fi + + DOCKER_GITCOMMIT=$(git rev-parse --short HEAD) + if [ -n "$(git status --porcelain --untracked-files=no)" ]; then + DOCKER_GITCOMMIT="$DOCKER_GITCOMMIT-dirty" + fi + + # if we have a "-dev" suffix or have change in Git, let's make this package version more complex so it works better + if [[ "$VERSION" == *-dev ]] || [ -n "$(git status --porcelain)" ]; then + gitUnix="$(git log -1 --pretty='%at')" + gitDate="$(date --date "@$gitUnix" +'%Y%m%d.%H%M%S')" + gitCommit="$(git log -1 --pretty='%h')" + gitVersion="${gitDate}.git${gitCommit}" + # gitVersion is now something like '20150128.112847.17e840a' + rpmRelease="0.0.$gitVersion" + fi + + rpmPackager="$(awk -F ': ' '$1 == "Packager" { print $2; exit }' hack/make/.build-rpm/${rpmName}.spec)" + rpmDate="$(date +'%a %b %d %Y')" + + # if go-md2man is available, pre-generate the man pages + ./man/md2man-all.sh -q || true + # TODO decide if it's worth getting go-md2man in _each_ builder environment to avoid this + + # TODO add a configurable knob for _which_ rpms to build so we don't have to modify the file or build all of them every time we need to test + for dir in contrib/builder/rpm/*/; do + version="$(basename "$dir")" + suite="${version##*-}" + + image="dockercore/builder-rpm:$version" + if ! docker inspect "$image" &> /dev/null; then + ( set -x && docker build -t "$image" "$dir" ) + fi + + mkdir -p "$DEST/$version" + cat > "$DEST/$version/Dockerfile.build" <<-EOF + FROM $image + COPY . /usr/src/${rpmName} + EOF + if [ "$DOCKER_EXPERIMENTAL" ]; then + echo 'ENV DOCKER_EXPERIMENTAL 1' >> "$DEST/$version/Dockerfile.build" + fi + cat >> "$DEST/$version/Dockerfile.build" <<-EOF + RUN mkdir -p /root/rpmbuild/SOURCES \ + && echo '%_topdir /root/rpmbuild' > /root/.rpmmacros + WORKDIR /root/rpmbuild + RUN ln -sfv /usr/src/${rpmName}/hack/make/.build-rpm SPECS + WORKDIR /root/rpmbuild/SPECS + RUN tar -cz -C /usr/src -f /root/rpmbuild/SOURCES/${rpmName}.tar.gz ${rpmName} + RUN { echo '* $rpmDate $rpmPackager $rpmVersion-$rpmRelease'; echo '* Version: $VERSION'; } >> ${rpmName}.spec && tail >&2 ${rpmName}.spec + RUN rpmbuild -ba --define '_release $rpmRelease' --define '_version $rpmVersion' --define '_origversion $VERSION' ${rpmName}.spec + EOF + # selinux policy referencing systemd things won't work on non-systemd versions + # of centos or rhel, which we don't support anyways + if [ "${suite%.*}" -gt 6 ] && [[ "$version" != opensuse* ]]; then + cat >> "$DEST/$version/Dockerfile.build" <<-EOF + RUN tar -cz -C /usr/src/${rpmName}/contrib -f /root/rpmbuild/SOURCES/${rpmName}-selinux.tar.gz ${rpmName}-selinux + RUN { echo '* $rpmDate $rpmPackager $rpmVersion-$rpmRelease'; echo '* Version: $VERSION'; } >> ${rpmName}-selinux.spec && tail >&2 ${rpmName}-selinux.spec + RUN rpmbuild -ba --define '_gitcommit $DOCKER_GITCOMMIT' --define '_release $rpmRelease' --define '_version $rpmVersion' --define '_origversion $VERSION' ${rpmName}-selinux.spec + EOF + fi + tempImage="docker-temp/build-rpm:$version" + ( set -x && docker build -t "$tempImage" -f $DEST/$version/Dockerfile.build . ) + docker run --rm "$tempImage" bash -c 'cd /root/rpmbuild && tar -c *RPMS' | tar -xvC "$DEST/$version" + docker rmi "$tempImage" + done + + source "$(dirname "$BASH_SOURCE")/.integration-daemon-stop" +) 2>&1 | tee -a $DEST/test.log diff --git a/hack/make/cover b/hack/make/cover new file mode 100644 index 0000000000..624943b8aa --- /dev/null +++ b/hack/make/cover @@ -0,0 +1,20 @@ +#!/bin/bash +set -e + +bundle_cover() { + coverprofiles=( "$DEST/../"*"/coverprofiles/"* ) + for p in "${coverprofiles[@]}"; do + echo + ( + set -x + go tool cover -func="$p" + ) + done +} + +if [ "$HAVE_GO_TEST_COVER" ]; then + bundle_cover 2>&1 | tee "$DEST/report.log" +else + echo >&2 'warning: the current version of go does not support -cover' + echo >&2 ' skipping test coverage report' +fi diff --git a/hack/make/cross b/hack/make/cross new file mode 100644 index 0000000000..ea8eee6cf2 --- /dev/null +++ b/hack/make/cross @@ -0,0 +1,34 @@ +#!/bin/bash +set -e + +# explicit list of os/arch combos that support being a daemon +declare -A daemonSupporting +daemonSupporting=( + [linux/amd64]=1 + [windows/amd64]=1 +) + +# if we have our linux/amd64 version compiled, let's symlink it in +if [ -x "$DEST/../binary/docker-$VERSION" ]; then + mkdir -p "$DEST/linux/amd64" + ( + cd "$DEST/linux/amd64" + ln -s ../../../binary/* ./ + ) + echo "Created symlinks:" "$DEST/linux/amd64/"* +fi + +for platform in $DOCKER_CROSSPLATFORMS; do + ( + export DEST="$DEST/$platform" # bundles/VERSION/cross/GOOS/GOARCH/docker-VERSION + mkdir -p "$DEST" + ABS_DEST="$(cd "$DEST" && pwd -P)" + export GOOS=${platform%/*} + export GOARCH=${platform##*/} + if [ -z "${daemonSupporting[$platform]}" ]; then + export LDFLAGS_STATIC_DOCKER="" # we just need a simple client for these platforms + export BUILDFLAGS=( "${ORIG_BUILDFLAGS[@]/ daemon/}" ) # remove the "daemon" build tag from platforms that aren't supported + fi + source "${MAKEDIR}/binary" + ) +done diff --git a/hack/make/dind-dynbinary b/hack/make/dind-dynbinary new file mode 100644 index 0000000000..7d5b2dd724 --- /dev/null +++ b/hack/make/dind-dynbinary @@ -0,0 +1,23 @@ +#!/bin/bash + +DEST=$1 +DOCKERBIN=$DEST/../binary/docker +BUILDDIR=$DEST/../dynbinary/ +RPM_PATH=$DEST/../rpm/ + +build_rpm() { + if [ ! -x $DOCKERBIN ]; then + echo "No docker binary was found to execute. This step requires 'binary' to be run first." + exit 1 + fi + + $DOCKERBIN -d 2>/dev/null & + $DOCKERBIN build -t centos-build -f Dockerfile.centos ./ + $DOCKERBIN run -it --rm --privileged -v /go:/go -v /usr/local:/usr/local -e "KEEPBUNDLE=true" centos-build hack/make.sh dynbinary + + # turn off the docker daemon + $DOCKERBIN rmi centos-build + cat /var/run/docker.pid | xargs kill +} + +build_rpm diff --git a/hack/make/dynbinary b/hack/make/dynbinary new file mode 100644 index 0000000000..e5fc0be262 --- /dev/null +++ b/hack/make/dynbinary @@ -0,0 +1,20 @@ +#!/bin/bash +set -e + +if [ -z "$DOCKER_CLIENTONLY" ]; then + source "${MAKEDIR}/.dockerinit" + + hash_files "$DEST/dockerinit-$VERSION" +else + # DOCKER_CLIENTONLY must be truthy, so we don't need to bother with dockerinit :) + export DOCKER_INITSHA1="" +fi +# DOCKER_INITSHA1 is exported so that other bundlescripts can easily access it later without recalculating it + +( + export IAMSTATIC="false" + export LDFLAGS_STATIC_DOCKER='' + export BUILDFLAGS=( "${BUILDFLAGS[@]/netgo /}" ) # disable netgo, since we don't need it for a dynamic binary + export BUILDFLAGS=( "${BUILDFLAGS[@]/static_build /}" ) # we're not building a "static" binary here + source "${MAKEDIR}/binary" +) diff --git a/hack/make/dyngccgo b/hack/make/dyngccgo new file mode 100644 index 0000000000..07476370b1 --- /dev/null +++ b/hack/make/dyngccgo @@ -0,0 +1,21 @@ +#!/bin/bash +set -e + +if [ -z "$DOCKER_CLIENTONLY" ]; then + source "${MAKEDIR}/.dockerinit-gccgo" + + hash_files "$DEST/dockerinit-$VERSION" +else + # DOCKER_CLIENTONLY must be truthy, so we don't need to bother with dockerinit :) + export DOCKER_INITSHA1="" +fi +# DOCKER_INITSHA1 is exported so that other bundlescripts can easily access it later without recalculating it + +( + export IAMSTATIC="false" + export EXTLDFLAGS_STATIC='' + export LDFLAGS_STATIC_DOCKER='' + export BUILDFLAGS=( "${BUILDFLAGS[@]/netgo /}" ) # disable netgo, since we don't need it for a dynamic binary + export BUILDFLAGS=( "${BUILDFLAGS[@]/static_build /}" ) # we're not building a "static" binary here + source "${MAKEDIR}/gccgo" +) diff --git a/hack/make/gccgo b/hack/make/gccgo new file mode 100644 index 0000000000..10b1152ab6 --- /dev/null +++ b/hack/make/gccgo @@ -0,0 +1,27 @@ +#!/bin/bash +set -e + +BINARY_NAME="docker-$VERSION" +BINARY_EXTENSION="$(binary_extension)" +BINARY_FULLNAME="$BINARY_NAME$BINARY_EXTENSION" + +source "${MAKEDIR}/.go-autogen" + +if [[ "${BUILDFLAGS[@]}" =~ 'netgo ' ]]; then + EXTLDFLAGS_STATIC+=' -lnetgo' +fi +go build -compiler=gccgo \ + -o "$DEST/$BINARY_FULLNAME" \ + "${BUILDFLAGS[@]}" \ + -gccgoflags " + -g + $EXTLDFLAGS_STATIC + -Wl,--no-export-dynamic + -ldl + " \ + ./docker + +echo "Created binary: $DEST/$BINARY_FULLNAME" +ln -sf "$BINARY_FULLNAME" "$DEST/docker$BINARY_EXTENSION" + +hash_files "$DEST/$BINARY_FULLNAME" diff --git a/hack/make/release-deb b/hack/make/release-deb new file mode 100755 index 0000000000..b16f321d09 --- /dev/null +++ b/hack/make/release-deb @@ -0,0 +1,151 @@ +#!/bin/bash +set -e + +# This script creates the apt repos for the .deb files generated by hack/make/build-deb +# +# The following can then be used as apt sources: +# deb http://apt.dockerproject.org/repo $distro-$release $version +# +# For example: +# deb http://apt.dockerproject.org/repo ubuntu-trusy main +# deb http://apt.dockerproject.org/repo ubuntu-vivid testing +# deb http://apt.dockerproject.org/repo debian-wheezy experimental +# deb http://apt.dockerproject.org/repo debian-jessie main +# +# ... and so on and so forth for the builds created by hack/make/build-deb + +: ${DOCKER_RELEASE_DIR:=$DEST} +: ${GPG_KEYID:=releasedocker} +APTDIR=$DOCKER_RELEASE_DIR/apt/repo + +# setup the apt repo (if it does not exist) +mkdir -p "$APTDIR/conf" "$APTDIR/db" + +# supported arches/sections +arches=( amd64 i386 ) + +# Preserve existing components but don't add any non-existing ones +for component in main testing experimental ; do + if ls "$APTDIR/dists/*/$component" >/dev/null 2>&1 ; then + components+=( $component ) + fi +done + +# set the component for the version being released +component="main" + +if [[ "$VERSION" == *-rc* ]]; then + component="testing" +fi + +if [ $DOCKER_EXPERIMENTAL ] || [[ "$VERSION" == *-dev ]] || [ -n "$(git status --porcelain)" ]; then + component="experimental" +fi + +# Make sure our component is in the list of components +if [[ ! "${components[*]}" =~ $component ]] ; then + components+=( $component ) +fi + +# create/update apt-ftparchive file +if [ ! -f "$APTDIR/conf/apt-ftparchive.conf" ]; then + cat <<-EOF > "$APTDIR/conf/apt-ftparchive.conf" + Dir { + ArchiveDir "${APTDIR}"; + CacheDir "${APTDIR}/db"; + }; + + Default { + Packages::Compress ". gzip bzip2"; + Sources::Compress ". gzip bzip2"; + Contents::Compress ". gzip bzip2"; + }; + + TreeDefault { + BinCacheDB "packages-\$(SECTION)-\$(ARCH).db"; + Directory "pool/\$(SECTION)"; + Packages "\$(DIST)/\$(SECTION)/binary-\$(ARCH)/Packages"; + SrcDirectory "pool/\$(SECTION)"; + Sources "\$(DIST)/\$(SECTION)/source/Sources"; + Contents "\$(DIST)/\$(SECTION)/Contents-\$(ARCH)"; + FileList "$APTDIR/\$(DIST)/\$(SECTION)/filelist"; + }; + EOF + + for suite in $(exec contrib/reprepro/suites.sh); do + cat <<-EOF + Tree "dists/${suite}" { + Sections "${components[*]}"; + Architectures "${arches[*]}"; + } + + EOF + done >> "$APTDIR/conf/apt-ftparchive.conf" +fi + +if [ ! -f "$APTDIR/conf/docker-engine-release.conf" ]; then + cat <<-EOF > "$APTDIR/conf/docker-engine-release.conf" + APT::FTPArchive::Release::Origin "Docker"; + APT::FTPArchive::Release::Components "${components[*]}"; + APT::FTPArchive::Release::Label "Docker APT Repository"; + APT::FTPArchive::Release::Architectures "${arches[*]}"; + EOF +fi + +for dir in contrib/builder/deb/*/; do + version="$(basename "$dir")" + codename="${version//debootstrap-}" + mkdir -p "$APTDIR/pool/$component/d/docker-engine/" + for arch in "${arches[@]}"; do + mkdir -p "$APTDIR/dists/$codename/$component/binary-$arch" + done +done + +# release the debs +for dir in contrib/builder/deb/*/; do + version="$(basename "$dir")" + codename="${version//debootstrap-}" + + DEBFILE=( "bundles/$VERSION/build-deb/$version/docker-engine"*.deb ) + + # if we have a $GPG_PASSPHRASE we may as well + # dpkg-sign before copying the deb into the pool + if [ ! -z "$GPG_PASSPHRASE" ]; then + dpkg-sig -g "--no-tty --passphrase '$GPG_PASSPHRASE'" \ + -k "$GPG_KEYID" --sign builder "${DEBFILE[@]}" + fi + + # add the deb for each component for the distro version into the pool + cp "${DEBFILE[@]}" "$APTDIR/pool/$component/d/docker-engine/" + + # update the filelist for this codename/component + find "$APTDIR/pool/$component" \ + -name *~${codename#*-}*.deb > "$APTDIR/dists/$codename/$component/filelist" +done + + +# run the apt-ftparchive commands so we can have pinning +apt-ftparchive generate "$APTDIR/conf/apt-ftparchive.conf" + +for dir in contrib/builder/deb/*/; do + version="$(basename "$dir")" + codename="${version//debootstrap-}" + + apt-ftparchive \ + -o "APT::FTPArchive::Release::Codename=$codename" \ + -o "APT::FTPArchive::Release::Suite=$codename" \ + -c "$APTDIR/conf/docker-engine-release.conf" \ + release \ + "$APTDIR/dists/$codename" > "$APTDIR/dists/$codename/Release" + + for arch in "${arches[@]}"; do + apt-ftparchive \ + -o "APT::FTPArchive::Release::Codename=$codename" \ + -o "APT::FTPArchive::Release::Suite=$codename" \ + -o "APT::FTPArchive::Release::Component=$component" \ + -o "APT::FTPArchive::Release::Architecture=$arch" \ + -c "$APTDIR/conf/docker-engine-release.conf" \ + release \ + "$APTDIR/dists/$codename/$component/binary-$arch" > "$APTDIR/dists/$codename/$component/binary-$arch/Release" + done +done diff --git a/hack/make/release-rpm b/hack/make/release-rpm new file mode 100755 index 0000000000..18b74f4dbd --- /dev/null +++ b/hack/make/release-rpm @@ -0,0 +1,75 @@ +#!/bin/bash +set -e + +# This script creates the yum repos for the .rpm files generated by hack/make/build-rpm +# +# The following can then be used as a yum repo: +# http://yum.dockerproject.org/repo/$release/$distro/$distro-version +# +# For example: +# http://yum.dockerproject.org/repo/main/fedora/22 +# http://yum.dockerproject.org/repo/testing/centos/6 +# http://yum.dockerproject.org/repo/experimental/fedora/21 +# http://yum.dockerproject.org/repo/main/centos/7 +# +# ... and so on and so forth for the builds created by hack/make/build-rpm + +: ${DOCKER_RELEASE_DIR:=$DEST} +YUMDIR=$DOCKER_RELEASE_DIR/yum/repo +: ${GPG_KEYID:=releasedocker} + +# manage the repos for each distribution separately +distros=( fedora centos opensuse oraclelinux ) + +# get the release +release="main" + +if [[ "$VERSION" == *-rc* ]]; then + release="testing" +fi + +if [ $DOCKER_EXPERIMENTAL ] || [[ "$VERSION" == *-dev ]] || [ -n "$(git status --porcelain)" ]; then + release="experimental" +fi + +for distro in "${distros[@]}"; do + # Setup the yum repo + REPO=$YUMDIR/$release/$distro + + for dir in contrib/builder/rpm/$distro-*/; do + version="$(basename "$dir")" + suite="${version##*-}" + + # if the directory does not exist, initialize the yum repo + if [[ ! -d $REPO/$suite/Packages ]]; then + mkdir -p "$REPO/$suite/Packages" + + createrepo --pretty "$REPO/$suite" + fi + + # path to rpms + RPMFILE=( "bundles/$VERSION/build-rpm/$version/RPMS/"*"/docker-engine"*.rpm "bundles/$VERSION/build-rpm/$version/SRPMS/docker-engine"*.rpm ) + + # if we have a $GPG_PASSPHRASE we may as well + # sign the rpms before adding to repo + if [ ! -z $GPG_PASSPHRASE ]; then + # export our key to rpm import + gpg --armor --export "$GPG_KEYID" > /tmp/gpg + rpm --import /tmp/gpg + + # sign the rpms + echo "yes" | setsid rpm \ + --define "_gpg_name $GPG_KEYID" \ + --define "_signature gpg" \ + --define "__gpg_check_password_cmd /bin/true" \ + --define "__gpg_sign_cmd %{__gpg} gpg --batch --no-armor --passphrase '$GPG_PASSPHRASE' --no-secmem-warning -u '%{_gpg_name}' --sign --detach-sign --output %{__signature_filename} %{__plaintext_filename}" \ + --resign "${RPMFILE[@]}" + fi + + # copy the rpms to the packages folder + cp "${RPMFILE[@]}" "$REPO/$suite/Packages" + + # update the repo + createrepo --pretty --update "$REPO/$suite" + done +done diff --git a/hack/make/rpm b/hack/make/rpm new file mode 100644 index 0000000000..4a3adc36e5 --- /dev/null +++ b/hack/make/rpm @@ -0,0 +1,202 @@ +#!/bin/bash + +DEST=$1 +PACKAGE_NAME=${PACKAGE_NAME:-docker-engine} + +# XXX - The package version in CentOS gets messed up and inserts a '~' +# (including the single quote) if we use the same package +# version scheme as the deb packages. This doesn't work with +# rpmbuild. +PKGVERSION="${VERSION}" +# if we have a "-dev" suffix or have change in Git, let's make this package version more complex so it works better +if [[ "$VERSION" == *-dev ]] || [ -n "$(git status --porcelain)" ]; then + GIT_UNIX="$(git log -1 --pretty='%at')" + GIT_DATE="$(date --date "@$GIT_UNIX" +'%Y%m%d.%H%M%S')" + GIT_COMMIT="$(git log -1 --pretty='%h')" + GIT_VERSION="git${GIT_DATE}.0.${GIT_COMMIT}" + # GIT_VERSION is now something like 'git20150128.112847.0.17e840a' + PKGVERSION="$PKGVERSION~$GIT_VERSION" +fi + +# $ dpkg --compare-versions 1.5.0 gt 1.5.0~rc1 && echo true || echo false +# true +# $ dpkg --compare-versions 1.5.0~rc1 gt 1.5.0~git20150128.112847.17e840a && echo true || echo false +# true +# $ dpkg --compare-versions 1.5.0~git20150128.112847.17e840a gt 1.5.0~dev~git20150128.112847.17e840a && echo true || echo false +# true + +# ie, 1.5.0 > 1.5.0~rc1 > 1.5.0~git20150128.112847.17e840a > 1.5.0~dev~git20150128.112847.17e840a + +PACKAGE_ARCHITECTURE=`uname -i` + +PACKAGE_URL="http://www.docker.com/" +PACKAGE_MAINTAINER="support@docker.com" +PACKAGE_DESCRIPTION="Linux container runtime +Docker complements LXC with a high-level API which operates at the process +level. It runs unix processes with strong guarantees of isolation and +repeatability across servers. +Docker is a great building block for automating distributed systems: +large-scale web deployments, database clusters, continuous deployment systems, +private PaaS, service-oriented architectures, etc." +PACKAGE_LICENSE="Apache-2.0" + +# bundle the RPM using FPM -- we may want to change this to rpmbuild at some point +bundle_rpm() { + DIR=$DEST/build + + # Include our udev rules + mkdir -p $DIR/etc/udev/rules.d + cp contrib/udev/80-docker.rules $DIR/etc/udev/rules.d/ + + mkdir -p $DIR/usr/lib/systemd/system + cp contrib/init/systemd/docker.{service,socket} $DIR/usr/lib/systemd/system + + cat > $DIR/usr/lib/systemd/system/docker.service <<'EOF' +[Unit] +Description=Docker Application Container Engine +Documentation=http://docs.docker.com +After=network.target docker.socket +Requires=docker.socket + +[Service] +Type=notify +EnvironmentFile=-/etc/sysconfig/docker +EnvironmentFile=-/etc/sysconfig/docker-storage +ExecStart=/usr/bin/docker -d $OPTIONS $DOCKER_STORAGE_OPTIONS +LimitNOFILE=1048576 +LimitNPROC=1048576 +MountFlags=private + +[Install] +WantedBy=multi-user.target +EOF + + mkdir -p $DIR/etc/sysconfig + cat > $DIR/etc/sysconfig/docker <<'EOF' +# /etc/sysconfig/docker + +# Modify these options if you want to change the way the docker daemon runs +OPTIONS=--selinux-enabled -H fd:// + +# Location used for temporary files, such as those created by +# docker load and build operations. Default is /var/lib/docker/tmp +# Can be overriden by setting the following environment variable. +# DOCKER_TMPDIR=/var/tmp +EOF + +cat > $DIR/etc/sysconfig/docker-storage <<'EOF' +# By default, Docker uses a loopback-mounted sparse file in +# /var/lib/docker. The loopback makes it slower, and there are some +# restrictive defaults, such as 100GB max storage. + +# If your installation did not set a custom storage for Docker, you +# may do it below. + +# Example: Use a custom pair of raw logical volumes (one for metadata, +# one for data). +# DOCKER_STORAGE_OPTIONS = --storage-opt dm.metadatadev=/dev/mylogvol/my-docker-metadata --storage-opt dm.datadev=/dev/mylogvol/my-docker-data + +DOCKER_STORAGE_OPTIONS= +EOF + + # Include contributed completions + mkdir -p $DIR/etc/bash_completion.d + cp contrib/completion/bash/docker $DIR/etc/bash_completion.d/ + mkdir -p $DIR/usr/share/zsh/vendor-completions + cp contrib/completion/zsh/_docker $DIR/usr/share/zsh/vendor-completions/ + mkdir -p $DIR/etc/fish/completions + cp contrib/completion/fish/docker.fish $DIR/etc/fish/completions/ + + mkdir -p $DIR/usr/share/doc/$PACKAGE_NAME-$VERSION + cp LICENSE-EVAL.txt $DIR/usr/share/doc/$PACKAGE_NAME-$VERSION/ + + # Include contributed man pages + docs/man/md2man-all.sh -q + manRoot="$DIR/usr/share/man" + mkdir -p "$manRoot" + for manDir in docs/man/man?; do + manBase="$(basename "$manDir")" # "man1" + for manFile in "$manDir"/*; do + manName="$(basename "$manFile")" # "docker-build.1" + mkdir -p "$manRoot/$manBase" + gzip -c "$manFile" > "$manRoot/$manBase/$manName.gz" + done + done + + # Copy the binary + # This will fail if the dynbinary bundle hasn't been built + mkdir -p $DIR/usr/bin + mkdir -p $DIR/usr/libexec/docker + cp $DEST/../dynbinary/docker-$VERSION $DIR/usr/bin/docker + cp $DEST/../dynbinary/dockerinit-$VERSION $DIR/usr/libexec/docker/dockerinit + + mkdir -p $DIR/var/lib/docker + + # Generate postinst/prerm/postrm scripts + cat > $DEST/postinst <<'EOF' +/usr/sbin/restorecon /var/lib/docker +chmod 700 /var/lib/docker +EOF + + cat > $DEST/preinst <<'EOF' +if ! getent group docker > /dev/null; then + groupadd --system docker +fi +EOF + + cat > $DEST/prerm <<'EOF' +EOF + + cat > $DEST/postrm <<'EOF' +## In case this system is running systemd, we make systemd reload the unit files +## to pick up changes. +#if [ -d /run/systemd/system ] ; then +# systemctl --system daemon-reload > /dev/null || true +#fi +EOF + + chmod +x $DEST/postinst $DEST/prerm $DEST/postrm $DEST/preinst + + ( + # switch directories so we create *.deb in the right folder + cd $DEST + + # create PACKAGE_NAME-VERSION package + fpm -s dir -C $DIR \ + --name $PACKAGE_NAME --version "$PKGVERSION" \ + --epoch 7 \ + --before-install $DEST/preinst \ + --after-install $DEST/postinst \ + --before-remove $DEST/prerm \ + --after-remove $DEST/postrm \ + --architecture "$PACKAGE_ARCHITECTURE" \ + --prefix / \ + --directories /var/lib/docker \ + --depends iptables \ + --depends xz \ + --depends "systemd >= 208-20" \ + --depends "device-mapper-libs >= 7:1.02.90-1" \ + --depends "device-mapper-event-libs >= 7:1.02.90-1" \ + --depends libselinux \ + --depends libsepol \ + --depends sqlite \ + --description "$PACKAGE_DESCRIPTION" \ + --maintainer "$PACKAGE_MAINTAINER" \ + --conflicts docker \ + --conflicts docker-io \ + --conflicts lxc-docker-virtual-package \ + --conflicts lxc-docker \ + --url "$PACKAGE_URL" \ + --license "$PACKAGE_LICENSE" \ + --config-files etc/sysconfig \ + --config-files etc/udev/rules.d/80-docker.rules \ + --rpm-compression gzip \ + -t rpm . + ) + + # clean up after ourselves so we have a clean output directory + rm $DEST/postinst $DEST/prerm $DEST/postrm $DEST/preinst + rm -r $DIR +} + +bundle_rpm diff --git a/hack/make/sign-repos b/hack/make/sign-repos new file mode 100755 index 0000000000..6b26947609 --- /dev/null +++ b/hack/make/sign-repos @@ -0,0 +1,55 @@ +#!/bin/bash + +# This script signs the deliverables from release-deb and release-rpm +# with a designated GPG key. + +: ${DOCKER_RELEASE_DIR:=$DEST} +: ${GPG_KEYID:=releasedocker} +APTDIR=$DOCKER_RELEASE_DIR/apt/repo +YUMDIR=$DOCKER_RELEASE_DIR/yum/repo + +if [ -z "$GPG_PASSPHRASE" ]; then + echo >&2 'you need to set GPG_PASSPHRASE in order to sign artifacts' + exit 1 +fi + +if [ ! -d $APTDIR ] && [ ! -d $YUMDIR ]; then + echo >&2 'release-rpm or release-deb must be run before sign-repos' + exit 1 +fi + +sign_packages(){ + # sign apt repo metadata + if [ -d $APTDIR ]; then + # create file with public key + gpg --armor --export "$GPG_KEYID" > "$DOCKER_RELEASE_DIR/apt/gpg" + + # sign the repo metadata + for F in $(find $APTDIR -name Release); do + if ! test -e "$F.gpg" || test "$F" -nt "$F.gpg" ; then + gpg -u "$GPG_KEYID" --passphrase "$GPG_PASSPHRASE" \ + --armor --sign --detach-sign \ + --batch --yes \ + --output "$F.gpg" "$F" + fi + done + fi + + # sign yum repo metadata + if [ -d $YUMDIR ]; then + # create file with public key + gpg --armor --export "$GPG_KEYID" > "$DOCKER_RELEASE_DIR/yum/gpg" + + # sign the repo metadata + for F in $(find $YUMDIR -name repomd.xml); do + if ! test -e "$F.asc" || test "$F" -nt "$F.asc" ; then + gpg -u "$GPG_KEYID" --passphrase "$GPG_PASSPHRASE" \ + --armor --sign --detach-sign \ + --batch --yes \ + --output "$F.asc" "$F" + fi + done + fi +} + +sign_packages diff --git a/hack/make/test-docker-py b/hack/make/test-docker-py new file mode 100644 index 0000000000..dece8315a3 --- /dev/null +++ b/hack/make/test-docker-py @@ -0,0 +1,18 @@ +#!/bin/bash +set -e + +# subshell so that we can export PATH without breaking other things +( + bundle .integration-daemon-start + + dockerPy='/docker-py' + [ -d "$dockerPy" ] || { + dockerPy="$DEST/docker-py" + git clone https://github.com/docker/docker-py.git "$dockerPy" + } + + # exporting PYTHONPATH to import "docker" from our local docker-py + test_env PYTHONPATH="$dockerPy" py.test "$dockerPy/tests/integration" + + bundle .integration-daemon-stop +) 2>&1 | tee -a "$DEST/test.log" diff --git a/hack/make/test-install-script b/hack/make/test-install-script new file mode 100755 index 0000000000..a5ea41693e --- /dev/null +++ b/hack/make/test-install-script @@ -0,0 +1,29 @@ +#!/bin/bash +# This script is used for testing install.sh and that it works for +# each of component of our apt and yum repos +set -e + +test_install_script(){ + # these are equivalent to main, testing, experimental components + # in the repos, but its the url that will do the conversion + components=( experimental test get ) + + for component in "${components[@]}"; do + # change url to specific component for testing + local test_url=https://${component}.docker.com + local script=$(mktemp /tmp/install-XXXXXXXXXX.sh) + sed "s,url='https://get.docker.com/',url='${test_url}/'," hack/install.sh > "${script}" + + chmod +x "${script}" + + # test for each Dockerfile in contrib/builder + for dir in contrib/builder/*/*/; do + local from="$(awk 'toupper($1) == "FROM" { print $2; exit }' "$dir/Dockerfile")" + + echo "running install.sh for ${component} with ${from}" + docker run --rm -i -v ${script}:/install.sh ${from} /install.sh + done + done +} + +test_install_script diff --git a/hack/make/test-integration-cli b/hack/make/test-integration-cli new file mode 100644 index 0000000000..3b4488e142 --- /dev/null +++ b/hack/make/test-integration-cli @@ -0,0 +1,18 @@ +#!/bin/bash +set -e + +bundle_test_integration_cli() { + TESTFLAGS="$TESTFLAGS -check.v" + go_test_dir ./integration-cli +} + +# subshell so that we can export PATH without breaking other things +( + bundle .integration-daemon-start + + bundle .integration-daemon-setup + + bundle_test_integration_cli + + bundle .integration-daemon-stop +) 2>&1 | tee -a "$DEST/test.log" diff --git a/hack/make/test-unit b/hack/make/test-unit new file mode 100644 index 0000000000..dae56de2ac --- /dev/null +++ b/hack/make/test-unit @@ -0,0 +1,86 @@ +#!/bin/bash +set -e + +: ${PARALLEL_JOBS:=$(nproc 2>/dev/null || echo 1)} # if nproc fails (usually because we don't have it), let's not parallelize by default + +RED=$'\033[31m' +GREEN=$'\033[32m' +TEXTRESET=$'\033[0m' # reset the foreground colour + +# Run Docker's test suite, including sub-packages, and store their output as a bundle +# If $TESTFLAGS is set in the environment, it is passed as extra arguments to 'go test'. +# You can use this to select certain tests to run, eg. +# +# TESTFLAGS='-test.run ^TestBuild$' ./hack/make.sh test-unit +# +bundle_test_unit() { + { + date + + # Run all the tests if no TESTDIRS were specified. + if [ -z "$TESTDIRS" ]; then + TESTDIRS=$(find_dirs '*_test.go') + fi + ( + export LDFLAGS + export TESTFLAGS + export HAVE_GO_TEST_COVER + + # some hack to export array variables + export BUILDFLAGS_FILE="$DEST/buildflags-file" + ( IFS=$'\n'; echo "${BUILDFLAGS[*]}" ) > "$BUILDFLAGS_FILE" + + if command -v parallel &> /dev/null; then + # accommodate parallel to be able to access variables + export SHELL="$BASH" + export HOME="$(mktemp -d)" + mkdir -p "$HOME/.parallel" + touch "$HOME/.parallel/ignored_vars" + + echo "$TESTDIRS" | parallel --jobs "$PARALLEL_JOBS" --env _ "${MAKEDIR}/.go-compile-test-dir" + rm -rf "$HOME" + else + # aww, no "parallel" available - fall back to boring + for test_dir in $TESTDIRS; do + "${MAKEDIR}/.go-compile-test-dir" "$test_dir" || true + # don't let one directory that fails to build tank _all_ our tests! + done + fi + rm -f "$BUILDFLAGS_FILE" + ) + echo "$TESTDIRS" | go_run_test_dir + } +} + +go_run_test_dir() { + TESTS_FAILED=() + while read dir; do + echo + echo '+ go test' $TESTFLAGS "${DOCKER_PKG}/${dir#./}" + precompiled="$ABS_DEST/precompiled/$dir.test$(binary_extension)" + if ! ( cd "$dir" && test_env "$precompiled" $TESTFLAGS ); then + TESTS_FAILED+=("$dir") + echo + echo "${RED}Tests failed: $dir${TEXTRESET}" + sleep 1 # give it a second, so observers watching can take note + fi + done + + echo + echo + echo + + # if some tests fail, we want the bundlescript to fail, but we want to + # try running ALL the tests first, hence TESTS_FAILED + if [ "${#TESTS_FAILED[@]}" -gt 0 ]; then + echo "${RED}Test failures in: ${TESTS_FAILED[@]}${TEXTRESET}" + echo + false + else + echo "${GREEN}Test success${TEXTRESET}" + echo + true + fi +} + +bundle_test_unit 2>&1 | tee -a "$DEST/test.log" diff --git a/hack/make/tgz b/hack/make/tgz new file mode 100644 index 0000000000..a512b832d2 --- /dev/null +++ b/hack/make/tgz @@ -0,0 +1,33 @@ +#!/bin/bash + +CROSS="$DEST/../cross" + +set -e + +if [ ! -d "$CROSS/linux/amd64" ]; then + echo >&2 'error: binary and cross must be run before tgz' + false +fi + +for d in "$CROSS/"*/*; do + GOARCH="$(basename "$d")" + GOOS="$(basename "$(dirname "$d")")" + BINARY_NAME="docker-$VERSION" + BINARY_EXTENSION="$(export GOOS && binary_extension)" + BINARY_FULLNAME="$BINARY_NAME$BINARY_EXTENSION" + mkdir -p "$DEST/$GOOS/$GOARCH" + TGZ="$DEST/$GOOS/$GOARCH/$BINARY_NAME.tgz" + + mkdir -p "$DEST/build" + + mkdir -p "$DEST/build/usr/local/bin" + cp -L "$d/$BINARY_FULLNAME" "$DEST/build/usr/local/bin/docker$BINARY_EXTENSION" + + tar --numeric-owner --owner 0 -C "$DEST/build" -czf "$TGZ" usr + + hash_files "$TGZ" + + rm -rf "$DEST/build" + + echo "Created tgz: $TGZ" +done diff --git a/hack/make/ubuntu b/hack/make/ubuntu new file mode 100644 index 0000000000..44d8b1815b --- /dev/null +++ b/hack/make/ubuntu @@ -0,0 +1,197 @@ +#!/bin/bash + +PKGVERSION="${VERSION//-/'~'}" +# if we have a "-dev" suffix or have change in Git, let's make this package version more complex so it works better +if [[ "$VERSION" == *-dev ]] || [ -n "$(git status --porcelain)" ]; then + GIT_UNIX="$(git log -1 --pretty='%at')" + GIT_DATE="$(date --date "@$GIT_UNIX" +'%Y%m%d.%H%M%S')" + GIT_COMMIT="$(git log -1 --pretty='%h')" + GIT_VERSION="git${GIT_DATE}.0.${GIT_COMMIT}" + # GIT_VERSION is now something like 'git20150128.112847.0.17e840a' + PKGVERSION="$PKGVERSION~$GIT_VERSION" +fi + +# $ dpkg --compare-versions 1.5.0 gt 1.5.0~rc1 && echo true || echo false +# true +# $ dpkg --compare-versions 1.5.0~rc1 gt 1.5.0~git20150128.112847.17e840a && echo true || echo false +# true +# $ dpkg --compare-versions 1.5.0~git20150128.112847.17e840a gt 1.5.0~dev~git20150128.112847.17e840a && echo true || echo false +# true + +# ie, 1.5.0 > 1.5.0~rc1 > 1.5.0~git20150128.112847.17e840a > 1.5.0~dev~git20150128.112847.17e840a + +PACKAGE_ARCHITECTURE="$(dpkg-architecture -qDEB_HOST_ARCH)" +PACKAGE_URL="https://www.docker.com/" +PACKAGE_MAINTAINER="support@docker.com" +PACKAGE_DESCRIPTION="Linux container runtime +Docker complements LXC with a high-level API which operates at the process +level. It runs unix processes with strong guarantees of isolation and +repeatability across servers. +Docker is a great building block for automating distributed systems: +large-scale web deployments, database clusters, continuous deployment systems, +private PaaS, service-oriented architectures, etc." +PACKAGE_LICENSE="Apache-2.0" + +# Build docker as an ubuntu package using FPM and REPREPRO (sue me). +# bundle_binary must be called first. +bundle_ubuntu() { + DIR="$ABS_DEST/build" + + # Include our udev rules + mkdir -p "$DIR/etc/udev/rules.d" + cp contrib/udev/80-docker.rules "$DIR/etc/udev/rules.d/" + + # Include our init scripts + mkdir -p "$DIR/etc/init" + cp contrib/init/upstart/docker.conf "$DIR/etc/init/" + mkdir -p "$DIR/etc/init.d" + cp contrib/init/sysvinit-debian/docker "$DIR/etc/init.d/" + mkdir -p "$DIR/etc/default" + cp contrib/init/sysvinit-debian/docker.default "$DIR/etc/default/docker" + mkdir -p "$DIR/lib/systemd/system" + cp contrib/init/systemd/docker.{service,socket} "$DIR/lib/systemd/system/" + + # Include contributed completions + mkdir -p "$DIR/etc/bash_completion.d" + cp contrib/completion/bash/docker "$DIR/etc/bash_completion.d/" + mkdir -p "$DIR/usr/share/zsh/vendor-completions" + cp contrib/completion/zsh/_docker "$DIR/usr/share/zsh/vendor-completions/" + mkdir -p "$DIR/etc/fish/completions" + cp contrib/completion/fish/docker.fish "$DIR/etc/fish/completions/" + + mkdir -p $DIR/usr/share/doc/$PACKAGE_NAME-$VERSION + cp LICENSE-EVAL.txt $DIR/usr/share/doc/$PACKAGE_NAME-$VERSION/ + + # Include contributed man pages + man/md2man-all.sh -q + manRoot="$DIR/usr/share/man" + mkdir -p "$manRoot" + for manDir in man/man?; do + manBase="$(basename "$manDir")" # "man1" + for manFile in "$manDir"/*; do + manName="$(basename "$manFile")" # "docker-build.1" + mkdir -p "$manRoot/$manBase" + gzip -c "$manFile" > "$manRoot/$manBase/$manName.gz" + done + done + + # Copy the binary + # This will fail if the binary bundle hasn't been built + mkdir -p "$DIR/usr/bin" + cp "$DEST/../binary/docker-$VERSION" "$DIR/usr/bin/docker" + + # Generate postinst/prerm/postrm scripts + cat > "$DEST/postinst" <<'EOF' +#!/bin/sh +set -e +set -u + +if [ "$1" = 'configure' ] && [ -z "$2" ]; then + if ! getent group docker > /dev/null; then + groupadd --system docker + fi +fi + +if ! { [ -x /sbin/initctl ] && /sbin/initctl version 2>/dev/null | grep -q upstart; }; then + # we only need to do this if upstart isn't in charge + update-rc.d docker defaults > /dev/null || true +fi +if [ -n "$2" ]; then + _dh_action=restart +else + _dh_action=start +fi +service docker $_dh_action 2>/dev/null || true + +#DEBHELPER# +EOF + cat > "$DEST/prerm" <<'EOF' +#!/bin/sh +set -e +set -u + +service docker stop 2>/dev/null || true + +#DEBHELPER# +EOF + cat > "$DEST/postrm" <<'EOF' +#!/bin/sh +set -e +set -u + +if [ "$1" = "purge" ] ; then + update-rc.d docker remove > /dev/null || true +fi + +# In case this system is running systemd, we make systemd reload the unit files +# to pick up changes. +if [ -d /run/systemd/system ] ; then + systemctl --system daemon-reload > /dev/null || true +fi + +#DEBHELPER# +EOF + # TODO swaths of these were borrowed from debhelper's auto-inserted stuff, because we're still using fpm - we need to use debhelper instead, and somehow reconcile Ubuntu that way + chmod +x "$DEST/postinst" "$DEST/prerm" "$DEST/postrm" + + ( + # switch directories so we create *.deb in the right folder + cd "$DEST" + + # create lxc-docker-VERSION package + fpm -s dir -C "$DIR" \ + --name "lxc-docker-$VERSION" --version "$PKGVERSION" \ + --after-install "$ABS_DEST/postinst" \ + --before-remove "$ABS_DEST/prerm" \ + --after-remove "$ABS_DEST/postrm" \ + --architecture "$PACKAGE_ARCHITECTURE" \ + --prefix / \ + --depends iptables \ + --deb-recommends aufs-tools \ + --deb-recommends ca-certificates \ + --deb-recommends git \ + --deb-recommends xz-utils \ + --deb-recommends 'cgroupfs-mount | cgroup-lite' \ + --deb-suggests apparmor \ + --description "$PACKAGE_DESCRIPTION" \ + --maintainer "$PACKAGE_MAINTAINER" \ + --conflicts docker \ + --conflicts docker.io \ + --conflicts docker-io \ + --conflicts lxc-docker-virtual-package \ + --conflicts $PACKAGE_NAME-virtual-package \ + --replaces lxc-docker \ + --replaces lxc-docker-virtual-package \ + --provides $PACKAGE_NAME \ + --provides $PACKAGE_NAME-virtual-package \ + --replaces $PACKAGE_NAME \ + --replaces $PACKAGE_NAME-virtual-package \ + --url "$PACKAGE_URL" \ + --license "$PACKAGE_LICENSE" \ + --config-files /etc/udev/rules.d/80-docker.rules \ + --config-files /etc/init/docker.conf \ + --config-files /etc/init.d/docker \ + --config-files /etc/default/docker \ + --deb-compression gz \ + -t deb . + # TODO replace "Suggests: cgroup-lite" with "Recommends: cgroupfs-mount | cgroup-lite" once cgroupfs-mount is available + + # create empty lxc-docker wrapper package + fpm -s empty \ + --name $PACKAGE_NAME --version "$PKGVERSION" \ + --architecture "$PACKAGE_ARCHITECTURE" \ + --depends $PACKAGE_NAME-$VERSION \ + --description "$PACKAGE_DESCRIPTION" \ + --maintainer "$PACKAGE_MAINTAINER" \ + --url "$PACKAGE_URL" \ + --license "$PACKAGE_LICENSE" \ + --deb-compression gz \ + -t deb + ) + + # clean up after ourselves so we have a clean output directory + rm "$DEST/postinst" "$DEST/prerm" "$DEST/postrm" + rm -r "$DIR" +} + +bundle_ubuntu diff --git a/hack/make/validate-dco b/hack/make/validate-dco new file mode 100644 index 0000000000..5ac98728f3 --- /dev/null +++ b/hack/make/validate-dco @@ -0,0 +1,54 @@ +#!/bin/bash + +source "${MAKEDIR}/.validate" + +adds=$(validate_diff --numstat | awk '{ s += $1 } END { print s }') +dels=$(validate_diff --numstat | awk '{ s += $2 } END { print s }') +#notDocs="$(validate_diff --numstat | awk '$3 !~ /^docs\// { print $3 }')" + +: ${adds:=0} +: ${dels:=0} + +# "Username may only contain alphanumeric characters or dashes and cannot begin with a dash" +githubUsernameRegex='[a-zA-Z0-9][a-zA-Z0-9-]+' + +# https://github.com/docker/docker/blob/master/CONTRIBUTING.md#sign-your-work +dcoPrefix='Signed-off-by:' +dcoRegex="^(Docker-DCO-1.1-)?$dcoPrefix ([^<]+) <([^<>@]+@[^<>]+)>( \\(github: ($githubUsernameRegex)\\))?$" + +check_dco() { + grep -qE "$dcoRegex" +} + +if [ $adds -eq 0 -a $dels -eq 0 ]; then + echo '0 adds, 0 deletions; nothing to validate! :)' +else + commits=( $(validate_log --format='format:%H%n') ) + badCommits=() + for commit in "${commits[@]}"; do + if [ -z "$(git log -1 --format='format:' --name-status "$commit")" ]; then + # no content (ie, Merge commit, etc) + continue + fi + if ! git log -1 --format='format:%B' "$commit" | check_dco; then + badCommits+=( "$commit" ) + fi + done + if [ ${#badCommits[@]} -eq 0 ]; then + echo "Congratulations! All commits are properly signed with the DCO!" + else + { + echo "These commits do not have a proper '$dcoPrefix' marker:" + for commit in "${badCommits[@]}"; do + echo " - $commit" + done + echo + echo 'Please amend each commit to include a properly formatted DCO marker.' + echo + echo 'Visit the following URL for information about the Docker DCO:' + echo ' https://github.com/docker/docker/blob/master/CONTRIBUTING.md#sign-your-work' + echo + } >&2 + false + fi +fi diff --git a/hack/make/validate-gofmt b/hack/make/validate-gofmt new file mode 100644 index 0000000000..7ad9e85576 --- /dev/null +++ b/hack/make/validate-gofmt @@ -0,0 +1,30 @@ +#!/bin/bash + +source "${MAKEDIR}/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- '*.go' | grep -v '^vendor/' || true) ) +unset IFS + +badFiles=() +for f in "${files[@]}"; do + # we use "git show" here to validate that what's committed is formatted + if [ "$(git show "$VALIDATE_HEAD:$f" | gofmt -s -l)" ]; then + badFiles+=( "$f" ) + fi +done + +if [ ${#badFiles[@]} -eq 0 ]; then + echo 'Congratulations! All Go source files are properly formatted.' +else + { + echo "These files are not properly gofmt'd:" + for f in "${badFiles[@]}"; do + echo " - $f" + done + echo + echo 'Please reformat the above files using "gofmt -s -w" and commit the result.' + echo + } >&2 + false +fi diff --git a/hack/make/validate-lint b/hack/make/validate-lint new file mode 100644 index 0000000000..df7f2b007e --- /dev/null +++ b/hack/make/validate-lint @@ -0,0 +1,30 @@ +#!/bin/bash + +source "${MAKEDIR}/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- '*.go' | grep -v '^vendor/' || true) ) +unset IFS + +errors=() +for f in "${files[@]}"; do + failedLint=$(golint "$f") + if [ "$failedLint" ]; then + errors+=( "$failedLint" ) + fi +done + +if [ ${#errors[@]} -eq 0 ]; then + echo 'Congratulations! All Go source files have been linted.' +else + { + echo "Errors from golint:" + for err in "${errors[@]}"; do + echo "$err" + done + echo + echo 'Please fix the above errors. You can test via "golint" and commit the result.' + echo + } >&2 + false +fi diff --git a/hack/make/validate-pkg b/hack/make/validate-pkg new file mode 100644 index 0000000000..d5843417e0 --- /dev/null +++ b/hack/make/validate-pkg @@ -0,0 +1,32 @@ +#!/bin/bash +set -e + +source "${MAKEDIR}/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- 'pkg/*.go' || true) ) +unset IFS + +badFiles=() +for f in "${files[@]}"; do + IFS=$'\n' + badImports=( $(go list -e -f '{{ join .Deps "\n" }}' "$f" | sort -u | grep -vE '^github.com/docker/docker/pkg/' | grep -E '^github.com/docker/docker' || true) ) + unset IFS + + for import in "${badImports[@]}"; do + badFiles+=( "$f imports $import" ) + done +done + +if [ ${#badFiles[@]} -eq 0 ]; then + echo 'Congratulations! "./pkg/..." is safely isolated from internal code.' +else + { + echo 'These files import internal code: (either directly or indirectly)' + for f in "${badFiles[@]}"; do + echo " - $f" + done + echo + } >&2 + false +fi diff --git a/hack/make/validate-test b/hack/make/validate-test new file mode 100644 index 0000000000..8dc86f11d7 --- /dev/null +++ b/hack/make/validate-test @@ -0,0 +1,35 @@ +#!/bin/bash + +# Make sure we're not using gos' Testing package any more in integration-cli + +source "${MAKEDIR}/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- 'integration-cli/*.go' || true) ) +unset IFS + +badFiles=() +for f in "${files[@]}"; do + # skip check_test.go since it *does* use the testing package + if [ "$f" = "integration-cli/check_test.go" ]; then + continue + fi + + # we use "git show" here to validate that what's committed doesn't contain golang built-in testing + if git show "$VALIDATE_HEAD:$f" | grep -q testing.T; then + badFiles+=( "$f" ) + fi +done + +if [ ${#badFiles[@]} -eq 0 ]; then + echo 'Congratulations! No testing.T found.' +else + { + echo "These files use the wrong testing infrastructure:" + for f in "${badFiles[@]}"; do + echo " - $f" + done + echo + } >&2 + false +fi diff --git a/hack/make/validate-toml b/hack/make/validate-toml new file mode 100644 index 0000000000..f6393c854d --- /dev/null +++ b/hack/make/validate-toml @@ -0,0 +1,30 @@ +#!/bin/bash + +source "${MAKEDIR}/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- 'MAINTAINERS' || true) ) +unset IFS + +badFiles=() +for f in "${files[@]}"; do + # we use "git show" here to validate that what's committed has valid toml syntax + if ! git show "$VALIDATE_HEAD:$f" | tomlv /proc/self/fd/0 ; then + badFiles+=( "$f" ) + fi +done + +if [ ${#badFiles[@]} -eq 0 ]; then + echo 'Congratulations! All toml source files changed here have valid syntax.' +else + { + echo "These files are not valid toml:" + for f in "${badFiles[@]}"; do + echo " - $f" + done + echo + echo 'Please reformat the above files as valid toml' + echo + } >&2 + false +fi diff --git a/hack/make/validate-vet b/hack/make/validate-vet new file mode 100644 index 0000000000..d543509a53 --- /dev/null +++ b/hack/make/validate-vet @@ -0,0 +1,31 @@ +#!/bin/bash + +source "${MAKEDIR}/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- '*.go' | grep -v '^vendor/' || true) ) +unset IFS + +errors=() +for f in "${files[@]}"; do + failedVet=$(go vet "$f") + if [ "$failedVet" ]; then + errors+=( "$failedVet" ) + fi +done + + +if [ ${#errors[@]} -eq 0 ]; then + echo 'Congratulations! All Go source files have been vetted.' +else + { + echo "Errors from go vet:" + for err in "${errors[@]}"; do + echo " - $err" + done + echo + echo 'Please fix the above errors. You can test via "go vet" and commit the result.' + echo + } >&2 + false +fi diff --git a/hack/release.sh b/hack/release.sh new file mode 100755 index 0000000000..c6fa637c73 --- /dev/null +++ b/hack/release.sh @@ -0,0 +1,418 @@ +#!/usr/bin/env bash +set -e + +# This script looks for bundles built by make.sh, and releases them on a +# public S3 bucket. +# +# Bundles should be available for the VERSION string passed as argument. +# +# The correct way to call this script is inside a container built by the +# official Dockerfile at the root of the Docker source code. The Dockerfile, +# make.sh and release.sh should all be from the same source code revision. + +set -o pipefail + +# Print a usage message and exit. +usage() { + cat >&2 <<'EOF' +To run, I need: +- to be in a container generated by the Dockerfile at the top of the Docker + repository; +- to be provided with the location of an S3 bucket and path, in + environment variables AWS_S3_BUCKET and AWS_S3_BUCKET_PATH (default: ''); +- to be provided with AWS credentials for this S3 bucket, in environment + variables AWS_ACCESS_KEY and AWS_SECRET_KEY; +- the passphrase to unlock the GPG key specified by the optional environment + variable GPG_KEYID (default: releasedocker) which will sign the deb + packages (passed as environment variable GPG_PASSPHRASE); +- a generous amount of good will and nice manners. +The canonical way to run me is to run the image produced by the Dockerfile: e.g.:" + +docker run -e AWS_S3_BUCKET=test.docker.com \ + -e AWS_ACCESS_KEY=... \ + -e AWS_SECRET_KEY=... \ + -e GPG_PASSPHRASE=... \ + -e GPG_KEYID=... \ + -i -t --privileged \ + docker ./hack/release.sh +EOF + exit 1 +} + +[ "$AWS_S3_BUCKET" ] || usage +[ "$AWS_ACCESS_KEY" ] || usage +[ "$AWS_SECRET_KEY" ] || usage +[ "$GPG_PASSPHRASE" ] || usage +: ${GPG_KEYID:=releasedocker} +[ -d /go/src/github.com/docker/docker ] || usage +cd /go/src/github.com/docker/docker +[ -x hack/make.sh ] || usage + +RELEASE_BUNDLES=( + binary + cross + tgz + ubuntu +) + +if [ "$1" != '--release-regardless-of-test-failure' ]; then + RELEASE_BUNDLES=( + test-unit + "${RELEASE_BUNDLES[@]}" + test-integration-cli + ) +fi + +VERSION=$(< VERSION) +BUCKET=$AWS_S3_BUCKET +BUCKET_PATH=$BUCKET +[[ -n "$AWS_S3_BUCKET_PATH" ]] && BUCKET_PATH+=/$AWS_S3_BUCKET_PATH + +if command -v git &> /dev/null && git rev-parse &> /dev/null; then + if [ -n "$(git status --porcelain --untracked-files=no)" ]; then + echo "You cannot run the release script on a repo with uncommitted changes" + usage + fi +fi + +# These are the 2 keys we've used to sign the deb's +# release (get.docker.com) +# GPG_KEY="36A1D7869245C8950F966E92D8576A8BA88D21E9" +# test (test.docker.com) +# GPG_KEY="740B314AE3941731B942C66ADF4FD13717AAD7D6" + +setup_s3() { + echo "Setting up S3" + # Try creating the bucket. Ignore errors (it might already exist). + s3cmd mb "s3://$BUCKET" 2>/dev/null || true + # Check access to the bucket. + # s3cmd has no useful exit status, so we cannot check that. + # Instead, we check if it outputs anything on standard output. + # (When there are problems, it uses standard error instead.) + s3cmd info "s3://$BUCKET" | grep -q . + # Make the bucket accessible through website endpoints. + s3cmd ws-create --ws-index index --ws-error error "s3://$BUCKET" +} + +# write_to_s3 uploads the contents of standard input to the specified S3 url. +write_to_s3() { + DEST=$1 + F=`mktemp` + cat > "$F" + s3cmd --acl-public --mime-type='text/plain' put "$F" "$DEST" + rm -f "$F" +} + +s3_url() { + case "$BUCKET" in + get.docker.com|test.docker.com|experimental.docker.com) + echo "https://$BUCKET_PATH" + ;; + *) + BASE_URL=$( s3cmd ws-info s3://$BUCKET | awk -v 'FS=: +' '/http:\/\/'$BUCKET'/ { gsub(/\/+$/, "", $2); print $2 }' ) + if [[ -n "$AWS_S3_BUCKET_PATH" ]] ; then + echo "$BASE_URL/$AWS_S3_BUCKET_PATH" + else + echo "$BASE_URL" + fi + ;; + esac +} + +build_all() { + echo "Building release" + if ! ./hack/make.sh "${RELEASE_BUNDLES[@]}"; then + echo >&2 + echo >&2 'The build or tests appear to have failed.' + echo >&2 + echo >&2 'You, as the release maintainer, now have a couple options:' + echo >&2 '- delay release and fix issues' + echo >&2 '- delay release and fix issues' + echo >&2 '- did we mention how important this is? issues need fixing :)' + echo >&2 + echo >&2 'As a final LAST RESORT, you (because only you, the release maintainer,' + echo >&2 ' really knows all the hairy problems at hand with the current release' + echo >&2 ' issues) may bypass this checking by running this script again with the' + echo >&2 ' single argument of "--release-regardless-of-test-failure", which will skip' + echo >&2 ' running the test suite, and will only build the binaries and packages. Please' + echo >&2 ' avoid using this if at all possible.' + echo >&2 + echo >&2 'Regardless, we cannot stress enough the scarcity with which this bypass' + echo >&2 ' should be used. If there are release issues, we should always err on the' + echo >&2 ' side of caution.' + echo >&2 + exit 1 + fi +} + +upload_release_build() { + src="$1" + dst="$2" + latest="$3" + + echo + echo "Uploading $src" + echo " to $dst" + echo + s3cmd --follow-symlinks --preserve --acl-public put "$src" "$dst" + if [ "$latest" ]; then + echo + echo "Copying to $latest" + echo + s3cmd --acl-public cp "$dst" "$latest" + fi + + # get hash files too (see hash_files() in hack/make.sh) + for hashAlgo in md5 sha256; do + if [ -e "$src.$hashAlgo" ]; then + echo + echo "Uploading $src.$hashAlgo" + echo " to $dst.$hashAlgo" + echo + s3cmd --follow-symlinks --preserve --acl-public --mime-type='text/plain' put "$src.$hashAlgo" "$dst.$hashAlgo" + if [ "$latest" ]; then + echo + echo "Copying to $latest.$hashAlgo" + echo + s3cmd --acl-public cp "$dst.$hashAlgo" "$latest.$hashAlgo" + fi + fi + done +} + +release_build() { + echo "Releasing binaries" + GOOS=$1 + GOARCH=$2 + + binDir=bundles/$VERSION/cross/$GOOS/$GOARCH + tgzDir=bundles/$VERSION/tgz/$GOOS/$GOARCH + binary=docker-$VERSION + tgz=docker-$VERSION.tgz + + latestBase= + if [ -z "$NOLATEST" ]; then + latestBase=docker-latest + fi + + # we need to map our GOOS and GOARCH to uname values + # see https://en.wikipedia.org/wiki/Uname + # ie, GOOS=linux -> "uname -s"=Linux + + s3Os=$GOOS + case "$s3Os" in + darwin) + s3Os=Darwin + ;; + freebsd) + s3Os=FreeBSD + ;; + linux) + s3Os=Linux + ;; + windows) + s3Os=Windows + binary+='.exe' + if [ "$latestBase" ]; then + latestBase+='.exe' + fi + ;; + *) + echo >&2 "error: can't convert $s3Os to an appropriate value for 'uname -s'" + exit 1 + ;; + esac + + s3Arch=$GOARCH + case "$s3Arch" in + amd64) + s3Arch=x86_64 + ;; + 386) + s3Arch=i386 + ;; + arm) + s3Arch=armel + # someday, we might potentially support mutliple GOARM values, in which case we might get armhf here too + ;; + *) + echo >&2 "error: can't convert $s3Arch to an appropriate value for 'uname -m'" + exit 1 + ;; + esac + + s3Dir="s3://$BUCKET_PATH/builds/$s3Os/$s3Arch" + latest= + latestTgz= + if [ "$latestBase" ]; then + latest="$s3Dir/$latestBase" + latestTgz="$s3Dir/$latestBase.tgz" + fi + + if [ ! -x "$binDir/$binary" ]; then + echo >&2 "error: can't find $binDir/$binary - was it compiled properly?" + exit 1 + fi + if [ ! -f "$tgzDir/$tgz" ]; then + echo >&2 "error: can't find $tgzDir/$tgz - was it packaged properly?" + exit 1 + fi + + upload_release_build "$binDir/$binary" "$s3Dir/$binary" "$latest" + upload_release_build "$tgzDir/$tgz" "$s3Dir/$tgz" "$latestTgz" +} + +# Upload the 'ubuntu' bundle to S3: +# 1. A full APT repository is published at $BUCKET/ubuntu/ +# 2. Instructions for using the APT repository are uploaded at $BUCKET/ubuntu/index +release_ubuntu() { + echo "Releasing ubuntu" + [ -e "bundles/$VERSION/ubuntu" ] || { + echo >&2 './hack/make.sh must be run before release_ubuntu' + exit 1 + } + + local debfiles=( "bundles/$VERSION/ubuntu/"*.deb ) + + # Sign our packages + dpkg-sig -g "--passphrase $GPG_PASSPHRASE" -k "$GPG_KEYID" --sign builder "${debfiles[@]}" + + # Setup the APT repo + APTDIR=bundles/$VERSION/ubuntu/apt + mkdir -p "$APTDIR/conf" "$APTDIR/db" + s3cmd sync "s3://$BUCKET/ubuntu/db/" "$APTDIR/db/" || true + cat > "$APTDIR/conf/distributions" < "bundles/$VERSION/ubuntu/gpg" + s3cmd --acl-public put "bundles/$VERSION/ubuntu/gpg" "s3://$BUCKET/gpg" + + local gpgFingerprint=36A1D7869245C8950F966E92D8576A8BA88D21E9 + local s3Headers= + if [[ $BUCKET == test* ]]; then + gpgFingerprint=740B314AE3941731B942C66ADF4FD13717AAD7D6 + elif [[ $BUCKET == experimental* ]]; then + gpgFingerprint=E33FF7BF5C91D50A6F91FFFD4CC38D40F9A96B49 + s3Headers='--add-header=Cache-Control:no-cache' + fi + + # Upload repo + s3cmd --acl-public $s3Headers sync "$APTDIR/" "s3://$BUCKET/ubuntu/" + cat <&2 './hack/make.sh must be run before release_binaries' + exit 1 + } + + for d in bundles/$VERSION/cross/*/*; do + GOARCH="$(basename "$d")" + GOOS="$(basename "$(dirname "$d")")" + release_build "$GOOS" "$GOARCH" + done + + # TODO create redirect from builds/*/i686 to builds/*/i386 + + cat </dev/null || { + gpg --gen-key --batch < +

+ Layer +
+
+ Images are composed of layers. Image layer is a general + term which may be used to refer to one or both of the following: + +
    +
  1. The metadata for the layer, described in the JSON format.
    2. +
  2. The filesystem changes described by a layer.
    3. +
+ + To refer to the former you may use the term Layer JSON or + Layer Metadata. To refer to the latter you may use the term + Image Filesystem Changeset or Image Diff. +
+
+ Image JSON +
+
+ Each layer has an associated JSON structure which describes some + basic information about the image such as date created, author, and the + ID of its parent image as well as execution/runtime configuration like + its entry point, default arguments, CPU/memory shares, networking, and + volumes. +
+
+ Image Filesystem Changeset +
+
+ Each layer has an archive of the files which have been added, changed, + or deleted relative to its parent layer. Using a layer-based or union + filesystem such as AUFS, or by computing the diff from filesystem + snapshots, the filesystem changeset can be used to present a series of + image layers as if they were one cohesive filesystem. +
+
+ Image ID +
+
+ Each layer is given an ID upon its creation. It is + represented as a hexadecimal encoding of 256 bits, e.g., + a9561eb1b190625c9adb5a9513e72c4dedafc1cb2d4c5236c9a6957ec7dfd5a9. + Image IDs should be sufficiently random so as to be globally unique. + 32 bytes read from /dev/urandom is sufficient for all + practical purposes. Alternatively, an image ID may be derived as a + cryptographic hash of image contents as the result is considered + indistinguishable from random. The choice is left up to implementors. +
+
+ Image Parent +
+
+ Most layer metadata structs contain a parent field which + refers to the Image from which another directly descends. An image + contains a separate JSON metadata file and set of changes relative to + the filesystem of its parent image. Image Ancestor and + Image Descendant are also common terms. +
+
+ Image Checksum +
+
+ Layer metadata structs contain a cryptographic hash of the contents of + the layer's filesystem changeset. Though the set of changes exists as a + simple Tar archive, two archives with identical filenames and content + will have different SHA digests if the last-access or last-modified + times of any entries differ. For this reason, image checksums are + generated using the TarSum algorithm which produces a cryptographic + hash of file contents and selected headers only. Details of this + algorithm are described in the separate TarSum specification. +
+
+ Tag +
+
+ A tag serves to map a descriptive, user-given name to any single image + ID. An image name suffix (the name component after :) is + often referred to as a tag as well, though it strictly refers to the + full name of an image. Acceptable values for a tag suffix are + implementation specific, but they SHOULD be limited to the set of + alphanumeric characters [a-zA-z0-9], punctuation + characters [._-], and MUST NOT contain a : + character. +
+
+ Repository +
+
+ A collection of tags grouped under a common prefix (the name component + before :). For example, in an image tagged with the name + my-app:3.1.4, my-app is the Repository + component of the name. Acceptable values for repository name are + implementation specific, but they SHOULD be limited to the set of + alphanumeric characters [a-zA-z0-9], and punctuation + characters [._-], however it MAY contain additional + / and : characters for organizational + purposes, with the last : character being interpreted + dividing the repository component of the name from the tag suffix + component. +
+

DlCtinjS; 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 literal 0 HcmV?d00001 diff --git a/docs/installation/images/mac-page-two.png b/docs/installation/images/mac-page-two.png new file mode 100644 index 0000000000000000000000000000000000000000..bd08ca15221c61d647e01505a59d78761bc3efd0 GIT binary patch literal 140504 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